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,37 @@
---
title: Polisher-Control Repository Foundation
status: draft
requested_by: Antoine Letarte
generated_by: Nick / Hermes
project: P11-Polisher-Fullum
repo: polisher-control
source_truth: false
created: 2026-05-26
privacy: technical-only
---
# Polisher-Control Repository Foundation
## Purpose
Give Cédric a clean starting point for the machine-side control implementation without mixing in upstream planning or private project context.
## What to build first
1. Host↔Teensy protocol and ACK/NACK behavior.
2. State machine and illegal-transition tests.
3. KWR75B-CAN receive path and F/T validity/stale-frame watchdog.
4. Manual mode with geometric gate.
5. Telemetry CSV and manual-session log.
6. Safety interlock behavior.
## Key instruction
Manual mode is not a throwaway mode. Manual telemetry is the calibration dataset for the entire future digital-twin loop. Keep channel names, timestamps, setpoint history, and force/angle data stable from the start.
## Acceptance checks
- [ ] Normand can run manual mode safely.
- [ ] Every session produces telemetry and a manual-session log.
- [ ] Every fault or rejected command is visible as an event/alarm.
- [ ] The controller never invents polishing strategy.

View File

@@ -0,0 +1,15 @@
# Nick-Generated Notes
This folder is for source-grounded technical notes Nick generates for Cédric.
Rules:
- technical-only;
- no invoices/rates/private context/secrets;
- mark generated notes `source_truth: false`;
- if a note changes architecture, safety, telemetry contracts, protocol semantics, or v1 scope, ask Antoine before treating it as accepted.
Suggested filename:
```text
YYYY-MM-DD-short-topic.md
```