docs: scaffold polisher-control foundation

shared/schemas/examples/run-log.example.json

@@ -0,0 +1,64 @@
+{
+  "schema_version": "run-log.v1",
+  "run_id": "run-2026-07-001",
+  "job_id": "job-2026-07-001",
+  "controller_job_id": "cjob-2026-07-001",
+  "controller_version": "polisher-control/0.1.0",
+  "machine_id": "fullum-alpha",
+  "started_at": "2026-07-17T14:00:00Z",
+  "ended_at": "2026-07-17T14:20:35Z",
+  "result_state": "completed",
+  "segments": [
+    {
+      "segment_id": "seg-01",
+      "source_pass_id": "pass-01",
+      "commanded_duration_s": 1200,
+      "actual_duration_s": 1203.5,
+      "result_state": "completed",
+      "commanded": {
+        "force_n": 45.0,
+        "table_rpm": 4.0,
+        "spindle_rpm": 40.0,
+        "cam_amplitude_deg": 31.3,
+        "cam_offset_deg": 0.0
+      },
+      "actual": {
+        "force_n_mean": 44.7,
+        "force_n_min": 41.2,
+        "force_n_max": 49.8,
+        "table_rpm_mean": 3.98,
+        "spindle_rpm_mean": 39.9
+      },
+      "pause_windows": [],
+      "anomaly_flags": [],
+      "notes": "Clean run. Minor force excursion at arm reversal points."
+    }
+  ],
+  "commanded_summary": {
+    "force_n": 45.0,
+    "table_rpm": 4.0,
+    "spindle_rpm": 40.0
+  },
+  "actual_summary": {
+    "force_n_mean": 44.7,
+    "force_n_min": 41.2,
+    "force_n_max": 49.8,
+    "table_rpm_mean": 3.98,
+    "spindle_rpm_mean": 39.9
+  },
+  "alarms": [],
+  "events": [
+    {
+      "timestamp": "2026-07-17T14:00:00Z",
+      "type": "run_started",
+      "detail": "Operator acknowledged start."
+    },
+    {
+      "timestamp": "2026-07-17T14:20:35Z",
+      "type": "run_completed",
+      "detail": "All segments completed normally."
+    }
+  ],
+  "telemetry_ref": "telemetry-run-2026-07-001.csv",
+  "operator_notes": "Smooth run. No intervention needed."
+}