docs: scaffold polisher-control foundation

This commit is contained in:
Nick Hermes
2026-05-26 16:23:04 +00:00
commit fa9c43fae8
52 changed files with 2224 additions and 0 deletions

View File

@@ -0,0 +1,48 @@
# Ecosystem Boundaries
## polisher-sim
Owns planning intelligence:
- metrology ingestion;
- mirror state and residuals;
- removal prediction;
- dwell/preset planning;
- calibration and uncertainty;
- campaign reports.
## polisher-post
Owns translation and validation:
- schema validation;
- machine capability checks;
- unit normalization;
- segmentation;
- packaging `controller-job.v1`;
- run-log normalization back into analysis format.
## polisher-control
Owns machine execution:
- state machine;
- manual mode;
- setpoint execution;
- force loop interface;
- telemetry;
- alarms/interlocks;
- pause/resume/abort;
- run/manual-session logs;
- operator workflow.
## Shared contracts
Own schemas and names that must not drift silently:
- `controller-job.v1`;
- `run-log.v1`;
- `manual-session-log.v1`;
- `machine-capabilities.v1`;
- telemetry channel names;
- event/alarm codes.
## Boundary rule
If you are about to add planning, optimization, calibration, or metrology interpretation to this repo, stop and ask Antoine. That likely belongs upstream.