docs: scaffold polisher-control foundation

shared/schemas/examples/controller-job.example.json

@@ -0,0 +1,32 @@
+{
+  "schema_version": "controller-job.v1",
+  "controller_job_id": "cjob-2026-07-001",
+  "job_id": "job-2026-07-001",
+  "machine_id": "fullum-alpha",
+  "machine_capabilities_ref": "machine-capabilities-fullum-alpha-v1",
+  "controller_version": "polisher-control/0.1.0",
+  "translated_at": "2026-07-15T10:15:00Z",
+  "translated_by": "polisher-post/0.1.0",
+  "translation_notes": "All setpoints within machine limits. No clipping required.",
+  "segments": [
+    {
+      "segment_id": "seg-01",
+      "sequence_index": 1,
+      "source_pass_id": "pass-01",
+      "duration_s": 1200,
+      "commanded_force_n": 45.0,
+      "commanded_table_rpm": 4.0,
+      "commanded_spindle_rpm": 40.0,
+      "commanded_cam_amplitude_deg": 31.3,
+      "commanded_cam_offset_deg": 0.0,
+      "force_modulation": {
+        "harmonic": 2,
+        "amplitude_n": 5.0,
+        "phase_deg": 37.2
+      },
+      "dither_profile": "none",
+      "notes": "Direct translation — no segmentation needed for 1200s duration."
+    }
+  ],
+  "translation_losses": []
+}