diff --git a/README.md b/README.md
index bc6eb6d..44a484e 100644
--- a/README.md
+++ b/README.md
@@ -84,7 +84,7 @@ report](prompts/Step-07-Report.md) and [Step-07A corrective worker
report](prompts/Step-07A-Report.md) and [Step-07B lock-safety corrective
report](prompts/Step-07B-Report.md).
-### Implemented, pending manual review
+### Accepted recorded replay milestone
Step-08 adds `/telemetry-replay`: explicit saved-capture loading without a
profile catalogue, vehicle session or running model. One page-owned,
@@ -92,12 +92,24 @@ cancellable playback clock projects exact recorded observation prefixes into
the shared numeric/bar gauge editor. Navigation, partial-source acknowledgement,
recorded provenance and runtime speed are explicit; source archives are never
rewritten. See [replay usage and contracts](docs/telemetry-replay.md) and the
-[Step-08 worker report](prompts/Step-08-Report.md). Worker completion is not
-orchestrator acceptance.
+[Step-08 worker report](prompts/Step-08-Report.md). Step-08 was accepted on
+2026-10-30.
+
+### Implemented, pending manual review
+
+Step-09 adds `/calibration`: one bounded, process-memory synthetic authoring
+workspace derived explicitly from a saved immutable dynamics configuration.
+Warm-idle scalar and fixed-axis torque proposals have exact source/head
+preconditions, immutable linear revisions and structured canonical diffs.
+These are Baseline/Proposed authoring values, not ECU backups, Tested/Approved
+calibrations or applied model/device changes. See
+[calibration authoring contracts](docs/calibration-authoring.md) and the
+[Step-09 worker report](prompts/Step-09-Report.md). Step-09 remains pending
+manual orchestrator review.
### Planned
-Calibration values/editing/backups, AI and real hardware operations
+Verified simulated programming, verified backups/approval, AI and real hardware operations
require later approved assignments. Saved recordings are local file archives,
not crash-durable live streaming. Replay does not resimulate or interpolate.
Dynamics estimates are synthetic,
@@ -117,7 +129,8 @@ browser-hosted WASM shell, Blazor Server host or second application executable.
The application slices provide explicit target metadata resolution,
vehicle-profile metadata import/list/select/export, dynamics configuration
catalog/import/export, simulation-only diagnostic sessions, bounded session
-recording, archive inspection and offline recorded replay, and a shared display-unit preference with a
+recording, archive inspection, offline recorded replay, synthetic calibration
+authoring and a shared display-unit preference with a
native local-preference adapter. The Client
composes separate static and dynamics synthetic providers through
provider-neutral factory contracts and a session-lifetime in-memory profile/
@@ -231,6 +244,7 @@ acceptance remains the orchestrator's responsibility.
- [Live dashboard usage and contracts](docs/live-dashboard.md)
- [Telemetry archive schema v1 and recording](docs/telemetry-archive-v1.md)
- [Recorded telemetry replay](docs/telemetry-replay.md)
+- [Synthetic calibration authoring](docs/calibration-authoring.md)
- [Vehicle-profile schema v1 and usage](docs/vehicle-profile-schema-v1.md)
- [Build, tests and native smoke guide](docs/build-and-test.md)
- [ADR-0001: historical .NET foundation](docs/adr-0001-headless-foundation.md)
diff --git a/docs/README.md b/docs/README.md
index df419fa..bd48f43 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -12,7 +12,9 @@ failures. Step-07B moves session cleanup outside the lifetime-registration
gate and shares its completion/failure among competing disposers. Corrected
Step-07/07A/07B is accepted. Step-08 adds offline saved telemetry replay,
exact prefix navigation, one page-owned clock and the shared gauge editor.
-Step-08 worker status remains pending manual orchestrator review.
+Step-08 is accepted. Step-09 adds bounded synthetic scalar/table authoring with
+immutable source-bound proposals and exact diffs, without model/device changes.
+Step-09 worker status remains pending manual orchestrator review.
- [Architecture](architecture.md): actual nine-project graph, responsibilities,
route ownership and provider/reference boundaries.
@@ -33,6 +35,9 @@ Step-08 worker status remains pending manual orchestrator review.
- [Recorded telemetry replay](telemetry-replay.md): offline RecordedReplay
provenance, before-first/time/ordinal semantics, exact quality and last-Good
reduction, rates, cancellation/drain, partial acknowledgement and shared gauges.
+- [Synthetic calibration authoring](calibration-authoring.md): exact
+ configuration/module applicability, scalar/fixed-axis template, validate-before-
+ commit revisions, head preconditions, canonical diffs and pinned torque drafts.
- [ADR-0001: Headless .NET 10 foundation](adr-0001-headless-foundation.md):
historical foundation decisions; dual-shell/deferred-host decision superseded.
- [ADR-0002: Single native shell and feature slices](adr-0002-single-shell-vsa.md):
@@ -66,5 +71,6 @@ historical/worker reports for their own execution evidence:
[Step-07 worker report](../prompts/Step-07-Report.md) and
[Step-07A corrective worker report](../prompts/Step-07A-Report.md) and
[Step-07B lock-safety corrective worker report](../prompts/Step-07B-Report.md) and
-[Step-08 worker report](../prompts/Step-08-Report.md).
+[Step-08 worker report](../prompts/Step-08-Report.md) and
+[Step-09 worker report](../prompts/Step-09-Report.md).
Handoffs are manual; acceptance remains the orchestrator's responsibility.
diff --git a/docs/architecture.md b/docs/architecture.md
index 204c25f..1eecf3a 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -11,8 +11,9 @@ There is no web/server host, WASM host or backend process.
Steps 04/04A/04B, 05/05A/05B, 06/06A and corrected 07/07A/07B are accepted.
Step-08 adds archive-only recorded replay with exact prefix reduction and one
-page-owned cancellable clock. Step-08 worker status remains pending manual
-orchestrator review; its execution evidence is separate from acceptance.
+page-owned cancellable clock and is accepted. Step-09 adds source-bound,
+process-memory synthetic calibration authoring. Step-09 worker status remains
+pending manual orchestrator review; execution evidence is not acceptance.
```mermaid
flowchart TD
@@ -44,10 +45,10 @@ All nine projects are in [AutoForge.slnx](../src/AutoForge.slnx):
| Project | Target and responsibility | Project references |
|---|---|---|
-| [Core](../src/AutoForge.Core/AutoForge.Core.csproj) | `net10.0`; platform-neutral target/profile invariants and immutable dynamics configuration/status contracts | None |
+| [Core](../src/AutoForge.Core/AutoForge.Core.csproj) | `net10.0`; platform-neutral target/profile invariants, immutable dynamics contracts and bounded synthetic calibration definition/value/applicability validation | None |
| [Diagnostics](../src/AutoForge.Diagnostics/AutoForge.Diagnostics.csproj) | `net10.0`; provider/session/transport/control contracts, strict synthetic protocol v1/v2 client, typed results and bounded trace | Core |
| [Simulation](../src/AutoForge.Simulation/AutoForge.Simulation.csproj) | `net10.0`; validated static modules, fixed-step engine, isolated state, explicit provider factories and transports | Core, Diagnostics |
-| [Application](../src/AutoForge.Application/AutoForge.Application.csproj) | `net10.0`; target/profile/diagnostic-session, dynamics-configuration, display-unit, shared gauge projection, live-dashboard, telemetry-recording/archive and replay feature slices | Core, Diagnostics |
+| [Application](../src/AutoForge.Application/AutoForge.Application.csproj) | `net10.0`; target/profile/diagnostic-session, dynamics-configuration, display-unit, shared gauge projection, live-dashboard, telemetry-recording/archive, replay and calibration-authoring feature slices | Core, Diagnostics |
| [Components](../src/AutoForge.Components/AutoForge.Components.csproj) | `net10.0` RCL; generic `StatusNotice` and numeric/bar gauge with accessible state and safe rendering | None |
| [UI](../src/AutoForge.UI/AutoForge.UI.csproj) | `net10.0` RCL; all application routes, navigation, layout and presentation, including shared dashboard and recording/archive inspection controls | Application, Components, Diagnostics |
| [Client](../src/AutoForge.Client/AutoForge.Client.csproj) | `net10.0-windows10.0.26100.0`; only MAUI Blazor Hybrid application executable, native preference adapter and app-local archive root | Application, Simulation, UI |
@@ -89,6 +90,7 @@ assembly, not the native Client assembly.
| `/diagnostics` | `Features/Vehicles/Diagnostics/DiagnosticsPage.razor` | Explicit saved profile/revision/provider/kind selection, static-v1 session lifecycle, separate expected/probed/identified counts, retained partial probe services, identity-gated DTC/static signal operations, clear acknowledgement plus fresh-empty-readback verification, raw/decoded trace, shared live dashboard and session recording/archive inspection |
| `/simulation` | `Features/Vehicles/Simulation/SimulationPage.razor` | Explicit profile/config/provider selection, JSON import/export, stopped-by-default dynamics session, lifecycle/step/pacing/scenario controls, source/unit/quality/model-time/config/run-aware telemetry over diagnostic protocol v2, and the same dashboard and recording/archive controls |
| `/telemetry-replay` | `Features/Vehicles/Telemetry/Replay/TelemetryReplayPage.razor` | Strict saved capture selection/load, distinct RecordedReplay instance and immutable original metadata, exact time/ordinal prefix navigation, one cancellable clock, partial acknowledgement and shared recorded numeric/bar gauges |
+| `/calibration` | `Features/Vehicles/Calibration/CalibrationPage.razor` | Explicit configuration-derived synthetic baseline, immutable Proposed history, complete scalar/table validation, exact head/source tokens and diffs, pinned torque-unit drafts; no application or programming |
| Any unmatched route | `Features/Foundation/NotFoundPage.razor` via UI `Routes.razor` | Explicit not-found page and supported navigation |
The generic [StatusNotice](../src/AutoForge.Components/StatusNotice.razor)
@@ -214,6 +216,26 @@ and [simulation guide](simulation.md).
## Honest limitations and safety boundaries
+The calibration slice has only configuration/profile read dependencies. Core
+owns defensively copied applicability, definition and value contracts for the
+single synthetic engine template. Application's singleton
+`CalibrationAuthoringService` retains one workspace, at most 32 saved revisions
+including baseline. Explicit source resolution uses the configuration's actual
+EngineModuleIdentifier, not a role lookup. Every immutable version includes
+workspace/source identity and parent lineage. Complete validation and expected
+head/source checks precede commit; identical head content is a no-op, stale
+requests reject, and replacement requires confirmation plus the old expected
+workspace/head. There is no workspace registry or persistence.
+
+The routed editor owns copied, unit-pinned unsaved fields. Display preferences
+rerender presentation only; unedited values preserve source doubles and edited
+torque converts once before validation. History inspection never rebinds the
+editable head. Diff results compare exact canonical values within one workspace/
+applicability, in parameter/axis order. The authoring slice has no diagnostic,
+model-control, archive-save, approval or programming port, and cannot apply its
+values to a configuration or active source. See
+[calibration authoring](calibration-authoring.md) for template bounds and limits.
+
Implemented diagnostics and dynamics are synthetic, in-process and
Simulation-only. They prove encoded request/response handling and deterministic
model behavior, not vehicle compatibility, access, authenticity, real capture,
@@ -221,8 +243,9 @@ manufacturer accuracy or permission. Static v1 signals remain static. Protocol
v2 dynamic telemetry is computed from an explicitly configured simplified
model; it is not real sensor data or validated prediction. Virtual DTC clear
mutates only selected in-memory module/session state and has no physical write
-path. No real vehicle, physical adapter, programming,
-calibration values, backups, AI, live streaming, crash-durable capture or cloud
+path. Calibration authoring values are synthetic proposals only. No real vehicle,
+physical adapter, programming, verified backup/approval, applied calibration,
+AI, live streaming, crash-durable capture or cloud
service is implemented. Saved recordings are local source-sensitive files and
must be treated as potentially sensitive data. A `SUPPORTED` declaration,
`VERIFIED` provenance label, physical
diff --git a/docs/build-and-test.md b/docs/build-and-test.md
index 71296a3..9b24342 100644
--- a/docs/build-and-test.md
+++ b/docs/build-and-test.md
@@ -42,12 +42,53 @@ actual vehicle, database, backend, model or cloud account is required.
dotnet test .\src\tests\AutoForge.UnitTests\AutoForge.UnitTests.csproj --configuration Release
dotnet test .\src\tests\AutoForge.IntegrationTests\AutoForge.IntegrationTests.csproj --configuration Release
dotnet test .\src\tests\AutoForge.IntegrationTests\AutoForge.IntegrationTests.csproj --configuration Release --no-restore --filter "FullyQualifiedName~TelemetryReplayTests|FullyQualifiedName~LiveDashboardAcquisitionTests|FullyQualifiedName~DisplayUnitControlTests"
+dotnet test .\src\tests\AutoForge.IntegrationTests\AutoForge.IntegrationTests.csproj --configuration Release --no-restore --filter "FullyQualifiedName~CalibrationAuthoringTests"
```
+## Step-09 synthetic authoring verification
+
+Step-08 is accepted. Step-09 remains pending manual orchestrator review.
+The focused authoring command above passed **55 cases**, including real
+configuration/profile source resolution, exact 650->1250 rpm and
+360->350 N*m diffs/parents, changed-back/no-op/tiny changes, defensive copies,
+template/source rejection, controlled competing-head commits and the exact
+32/33 history boundary. Real rendered events verify parse/validation failures,
+history/diff selection, two stale editors, explicit replacement and pinned
+torque units with exact canonical preservation.
+
+The required sequential Release build completed all nine projects/native
+Client with zero warnings/errors, then the complete suite passed **179 unit +
+226 integration = 405 cases**, zero failed/skipped. All 350 accepted baseline
+cases remain present. A real live dynamics source, its saved recording and
+validated replay coexist during authoring with zero additional transport,
+model-control and archive Save calls, unchanged source export/fingerprint/
+trace/state/raw bytes and unchanged replay snapshot.
+
+Native smoke used the actual Release Windows Client and a task-owned WebView2
+profile/local DevTools endpoint. The existing simulation workflow explicitly
+created the warm source. Native authoring created its baseline, saved the
+1250-rpm scalar proposal and 350-N*m torque cell at 2000 rpm, then inspected
+exact baseline and preceding-version diffs. Invalid scalar/cell/source commands
+and unconfirmed replacement preserved the head/history. A Metric draft's
+unsaved 345 N*m remained 345 after an Imperial toggle; cancelling captured a
+new Imperial draft, and an untouched save across another toggle retained
+exact source 350 N*m and the same revision. Confirmed replacement explicitly
+discarded the old draft/history and returned to baseline.
+
+The original dynamics configuration export/fingerprint stayed identical with
+warm idle 650 rpm and 2000-rpm torque 360 N*m. An explicit subsequent real
+diagnostic read at model step 7 / 0.7 seconds returned 631.80416 rpm from the
+unchanged warm model, not the proposal. Old simulation/profile/replay routes
+and authoring re-entry worked. Restart confirmed no authoring workspace or
+configuration persisted; the final binary then repeated the baseline and
+two-proposal diff workflow. Native observations are not controlled concurrent/
+stale-head/capacity proof. Exact commands, final results, cleanup and limitations
+are in the [Step-09 worker report](../prompts/Step-09-Report.md).
+
## Step-08 recorded replay verification
-Corrected Step-07/07A/07B is accepted; the Step-08 worker remains pending
-orchestrator review. The final focused command above passed 49 cases. It covers
+Corrected Step-07/07A/07B and Step-08 are accepted. The recorded Step-08 focused
+command passed 49 cases. It covers
37 new replay cases plus accepted live-dashboard/unit-selector regressions.
The required sequential nine-project Release build passed with zero warnings
and errors, followed by 179 unit and 171 integration tests: **350 passed,
diff --git a/docs/calibration-authoring.md b/docs/calibration-authoring.md
new file mode 100644
index 0000000..e365bc7
--- /dev/null
+++ b/docs/calibration-authoring.md
@@ -0,0 +1,130 @@
+# Synthetic calibration authoring
+
+## Authoring only, not programming
+
+The `/calibration` route creates **Synthetic configuration-derived baseline**
+and **Proposed** revisions in process memory. It does not read an ECU, make a
+verified original backup, test or approve a proposal, write to a module, apply
+values to a model or change the source configuration. Restart loses all
+authoring history; leaving the route loses its unsaved editor draft. Saved
+authoring revisions survive route navigation only within the running app.
+Step-08 is accepted; Step-09 remains pending manual orchestrator review.
+Step-10 verified simulated programming is separate and unimplemented. Physical
+writes retain their later independent authorization/evidence gates.
+
+## Explicit source and bounded synthetic definition
+
+First create/import a dynamics configuration through the existing explicit
+simulation workflow. No configuration, profile or workspace is seeded by
+opening authoring. Select an exact saved configuration fingerprint and choose
+**Create synthetic authoring baseline**.
+
+The versioned `autoforge.synthetic.engine-authoring` revision 1 template
+supports `autoforge.synthetic.longitudinal` model version 1. Applicability
+includes exact configuration fingerprint, profile identifier/revision,
+the configuration's actual EngineModuleIdentifier, model identifier/version
+and definition identifier/revision. The actual module is resolved through the
+selected profile; it is never inferred from a role. Profile/module comparison
+is case-insensitive per existing policy; fingerprints, model/definition IDs,
+logical keys and units are exact. Supplied optional hardware/software/firmware/
+calibration metadata is retained as metadata, not filled or promoted into proof.
+
+| Logical value | Source units | Synthetic policy |
+|---|---|---|
+| `engine.warm-idle-target` | rpm | Finite scalar, inclusive `[Model.IdleSpeedRpm, Model.MaximumEngineSpeedRpm]` |
+| `engine.torque-curve` | rpm axis; N*m cells | 2..32 fixed source rows; finite strictly increasing axis in `[0, MaximumEngineSpeedRpm]`; editable finite cells in inclusive `[1,1000]` N*m |
+
+Only identity value scaling (1, offset 0) is supported. No raw binary layout,
+addresses/offsets, adjustable axis, insertion/deletion, sorting, interpolation,
+multidimensional maps or arbitrary firmware definition is provided. An otherwise
+valid configuration outside this template is rejected, not truncated, clipped
+or normalized. These are synthetic authoring constraints, not manufacturer-
+safe operating limits or physical compatibility evidence.
+
+For the warm example, baseline warm idle is 650 rpm with limits 650..5000 rpm.
+The source torque rows are exactly `(650,240)`, `(1000,300)`, `(2000,360)`,
+`(3200,350)`, `(4200,300)`, `(5000,180)` in rpm/N*m.
+
+## Immutable linear versions and exact preconditions
+
+The Application service retains **one** authoring workspace with at most
+**32 saved revisions including baseline**. Baseline is revision 1, read-only.
+Every valid changed save creates a unique Proposed revision with a monotonic
+revision number, exact parent/current-head ID and copied workspace/source
+identity. All definition, axis, value, history and diff collections are
+defensively copied/read-only.
+
+A save explicitly supplies the workspace ID, expected head ID, complete
+applicability and complete candidate. Required keys, shape/count, unchanged
+axis, source units, finite values and inclusive bounds are validated as a whole
+before any head/history/version mutation. Invalid or mismatched requests return
+typed visible errors with no partial save. Two requests based on the same head
+cannot both commit changed proposals: the second is stale, with no merge,
+branch or last-writer-wins fallback.
+
+Content equal to the current head returns that same revision without consuming
+capacity. Stale expected heads reject even if their proposed content is
+unchanged. At 32 revisions, changed revision 33 rejects; an identical current-
+head save remains a no-op. Changing back after a different proposal creates a
+new Proposed revision, not a restored device or approved rollback.
+
+Selecting a different configuration does not silently replace the workspace.
+Replacement requires the explicit **I confirm replacement discards the current
+in-memory history and unsaved draft** checkbox and replacement action, together
+with the prior expected workspace/head. Invalid/stale replacement preserves the
+old workspace/draft/history. A new workspace discards service-held old history;
+there is no hidden unbounded multi-workspace repository or persistence.
+
+## Editor, units and history
+
+The editor captures its expected source/head and copied input strings. Another
+editor's save rerenders a stale-head warning but does not silently rebase unsaved
+fields. **Cancel draft / reload latest head** is the explicit recovery action.
+Inspection of a saved revision does not change the editable head.
+
+Torque presentation uses the existing shared N*m/lbf*ft converter. rpm remains
+rpm. A draft pins its input unit selection until save/cancel; global preference
+changes affect read-only presentation, not the meaning of unsaved fields or
+saved canonical values. Inputs use round-trip numeric text; display precision
+is presentation only. Unedited fields retain their exact original canonical
+doubles, avoiding forward/inverse conversion drift. Edited torque converts
+once to N*m before complete candidate validation. Canonical source values,
+fixed axis and synthetic bounds remain visible.
+
+Example: typing a torque edit while Metric is active and switching globally
+to Imperial leaves that draft in N*m. Cancelling captures a new Imperial
+draft in lbf*ft. An untouched subsequent save preserves exact source values
+and does not create a proposal merely because displayed units changed.
+
+## Structured canonical diffs
+
+Select two explicit saved versions from the same workspace/applicability and
+choose **Compare explicit saved revisions**. Output includes only changed
+scalars/cells, deterministic ordinal logical-key then numeric axis order,
+logical ID, table axis coordinate/unit, original source unit, exact before/
+after doubles and signed delta. No rounded-display comparison or tolerance
+hides small changes. Comparisons against foreign/replaced version IDs reject.
+
+Warm idle 650 -> 1250 produces one scalar entry: before 650, after 1250,
+delta +600 rpm. Also changing the 2000-rpm torque cell 360 -> 350 produces
+exactly two entries versus baseline, with table delta -10 N*m. Comparing that
+third revision against its second-revision parent shows only the table change.
+A changed-back Proposed revision may have an empty baseline diff without
+changing its authoring-only status.
+
+## Verification and isolation
+
+`CalibrationAuthoringTests` constructs real profile/configuration-service
+sources and asserts baseline values, exact parents/diffs, malformed values/
+definitions/source tokens, immutable snapshots, deterministic competing-head
+commits and the exact history bound. Actual rendered editor events cover
+parse/validation failures, history/diff choice, stale editors, replacement and
+unit-pinned drafts. A real live dynamics source, saved recording and validated
+replay coexist while authoring adds zero transport/model/archive-Save calls,
+with unchanged configuration export/fingerprint, raw archive bytes, source
+trace/state and replay snapshot.
+
+Native smoke uses the actual Windows Client and explicitly created warm source;
+it is not controlled concurrent/head-capacity proof. Commands, counts, native
+observations, limitations and preservation review are in the
+[Step-09 worker report](../prompts/Step-09-Report.md).
diff --git a/docs/telemetry-replay.md b/docs/telemetry-replay.md
index f569956..ab6d4a4 100644
--- a/docs/telemetry-replay.md
+++ b/docs/telemetry-replay.md
@@ -135,4 +135,5 @@ Native evidence uses the real Windows Client, app storage and saved static-v1/
dynamic-v2 captures; it is not controlled timing, race or fault proof.
Commands, counts, native observations and limitations are recorded separately
in the [Step-08 worker report](../prompts/Step-08-Report.md).
-Step-07/07A/07B is accepted; Step-08 remains pending orchestrator review.
+Step-07/07A/07B and Step-08 are accepted. Synthetic calibration authoring is a
+separate feature and cannot change replay archives, cursor or playback ownership.
diff --git a/prompts/ROADMAP.md b/prompts/ROADMAP.md
index 3f7ed17..93183cb 100644
--- a/prompts/ROADMAP.md
+++ b/prompts/ROADMAP.md
@@ -3,17 +3,18 @@
## Status and authority
- Initialized: 2026-10-28.
-- Current phase: recorded telemetry replay accepted; bounded synthetic calibration authoring next.
-- Active assignment: [Step-09](Step-09.md), ready for manual worker execution.
-- Last accepted milestone: Step-08, accepted 2026-10-30.
+- Current phase: synthetic calibration authoring accepted; isolated simulated programming rehearsal next.
+- Active assignment: [Step-10](Step-10.md), ready for manual worker execution.
+- Last accepted milestone: Step-09, accepted 2026-10-30.
- Last accepted correction: Step-07B; all Step-07 findings closed.
- Outstanding corrections: none.
- Step-05 status: ACCEPTED after Step-05A/Step-05B, 2026-10-29.
- Step-06 status: ACCEPTED after Step-06A, 2026-10-30.
- Step-07 status: ACCEPTED after Step-07A/Step-07B, 2026-10-30.
- Step-08 status: ACCEPTED 2026-10-30; no Step-08A required.
-- Step-09 status: READY FOR WORKER; synthetic definitions/proposals/diffs only.
-- Step-10 status: verified simulated programming; BLOCKED / NOT ASSIGNED until authoring acceptance.
+- Step-09 status: ACCEPTED 2026-10-30; no Step-09A required.
+- Step-10 status: READY FOR WORKER; verified supported-image backup/approval/write/readback/restore in an isolated simulation target.
+- Step-11 status: local AI/runbooks; BLOCKED / NOT ASSIGNED until programming-rehearsal acceptance.
- Current state and handoff: [STATE.md](STATE.md).
- Authority: the master charter, repository/handoff amendment, and the owner's
2026-10-28 architectural realignment. The latest decision cancels the dual-shell
@@ -213,6 +214,27 @@ state machine, programming service or model integration. A configuration-derived
synthetic baseline is not an ECU read or verified backup. Those distinctions are
frozen in Step-09's UI/validation/evidence contract, not postponed by implication.
+### Step-10 bounded rehearsal contract
+
+Accepted Step-09 proposals now feed an explicitly opened, isolated simulated
+calibration target through a typed programming port. The target's mutable image
+is owned by Simulation, not an Application request echo or a configuration
+replacement. The supported surface remains the warm-idle scalar and fixed-axis
+torque table. Current readback verifies that surface only, not an entire ECU.
+
+Step-10 adds one guarded mutation lifecycle: independent image read/verified
+in-memory backup, exact source/proposal approval, compare-before-write, fresh
+readback, visible uncertain outcomes, explicit reconciliation and separately
+approved restore. PhysicalHardware and RecordedReplay targets reject.
+This is not a general transport/firmware programming implementation.
+
+The target/backup/results are process-memory rehearsal state. Closing/reopening
+creates a new target identity and cannot reuse the old approval/backup. Original
+immutable dynamics configurations, existing runs, diagnostics and recording/
+replay stay unchanged. Applying the programmed image to a new dynamics run and
+functional performance verification require a later explicit assignment.
+No crash-durable backup, real-device recovery or manufacturer safety claim is made.
+
## Architecture baseline
### Existing accepted foundation, preserved
@@ -403,8 +425,10 @@ accepted: actual bounded capture, source-faithful/strict archives, released
ownership, visible I/O failures and deadlock-free source close are supported.
Step-08 replay is accepted: exact prefixes/ties, one playback owner, offline
RecordedReplay context, source immutability and shared gauges/units are supported.
-Step-09 is the only active assignment for bounded synthetic calibration
-authoring; simulated programming is separated into Step-10.
+Step-09 authoring is accepted: exact source binding, immutable linear proposals,
+atomic validation/head checks, precise diffs and zero source side effects are
+supported. Step-10 is the only active assignment for isolated simulated
+programming rehearsal; there is no physical-write or live-model permission.
Dependencies indicate acceptance prerequisites, not permission for automatic
handoff. Later assignments refine these scopes using actual implementation
evidence; they must not silently discard required capabilities.
@@ -430,9 +454,9 @@ evidence; they must not silently discard required capabilities.
| 07A | Source-faithful archives, bounded lifetime and visible storage failures | 07 review R-01 through R-04 | ACCEPTED 2026-10-30 AFTER 07B | Archive/typed-validation/normal-release/panel fixes and source-close follow-up all closed |
| 07B | Deadlock-free source disposal during capture cleanup | Remaining 07A R-03 safe-close contract | ACCEPTED 2026-10-30 | Shared disposal task published under gate, cleanup outside; actual pre-fix close/reset deadlocks and controlled correction, reported 179 unit/134 integration passes and native baseline |
| 08 | Recorded telemetry replay | 07 and corrections accepted | ACCEPTED 2026-10-30 | Exact recorded prefix/tie/navigation, controlled rate/owner/fault cleanup, shared gauges/units and offline native replay; reported 179 unit/171 integration passes |
-| 09 | Synthetic calibration authoring and immutable proposals | 08 accepted | READY FOR WORKER | Explicit configuration/module applicability, validated scalar/fixed-axis table revisions, exact diffs and no source/model mutation; in-memory only |
-| 10 | Verified simulated programming and recovery | 09 accepted | BLOCKED / NOT ASSIGNED | Verified baseline/backup, exact approval binding, simulated write/readback/unrelated-value checks, audit and supported restore; no physical writes |
-| 11 | Local AI, knowledge, and validated runbooks | 10 | PLANNED | Replaceable local inference, applicable knowledge retrieval, structured logical runbook, independent validation/approval and simulation-only execution |
+| 09 | Synthetic calibration authoring and immutable proposals | 08 accepted | ACCEPTED 2026-10-30 | Real configuration/profile binding, immutable scalar/table proposals, exact diffs/stale-head/limits and no source mutation; reported 179 unit/226 integration passes |
+| 10 | Verified simulated programming and recovery | 09 accepted | READY FOR WORKER | Isolated real simulation image/typed port, supported-image volatile backup, exact approval/source revision, fresh readback/reconciliation/approved restore; no physical writes or live-model changes |
+| 11 | Local AI, knowledge, and validated runbooks | 10 accepted | BLOCKED / NOT ASSIGNED | Replaceable local inference, applicable knowledge retrieval, structured logical runbook, independent validation/approval and simulation-only execution |
| 12 | Comparative evaluation and complete synthetic demonstration | 11 | PLANNED | Complete demonstration below plus deterministic fault/regression matrix and independent verification of intended and unintended changes |
| 13 | Verified OBDX Pro GT read-only integration | 12 plus documented device research/access | PLANNED / HARDWARE GATE | Source-backed device support matrix, explicit physical target, real read-only identification/diagnostics/telemetry recording where supported; no write path |
| 14 | Advanced dashboards, analysis, and comparisons | 12; 13 for real captures | PLANNED | Persist configurable layouts/thresholds, linked charts, larger-capture analysis, raw-data inspection and multi-run/multi-vehicle comparisons with lineage/uncertainty |
@@ -870,27 +894,43 @@ history, not repeated redesign without evidence.
subsequent Step-10 simulated programming under the existing scope policy.
Only unassigned future envelopes/dependencies shifted; no completed history
or prior assignment/report was renumbered.
+- Reviewed Step-09's immutable Core contracts, source-bound authoring service,
+ complete candidate/head/capacity validation, exact structured diffs, pinned
+ editor/history/replacement and all new tests/docs. Worker reports 179 unit +
+ 226 integration passes (405 total, zero failed/skipped), clean full Release
+ build and native exact proposal/diff/source-isolation/restart checks.
+- Accepted Step-09 against C-01..C-12/AC-01..AC-05 without Step-09A. Real
+ concurrent/defensive-copy/source/no-write tests are distinct from native UI
+ observations; the orchestrator ran no application checks.
+- Prepared [Step-10](Step-10.md) for the bounded isolated-target programming
+ rehearsal, with explicit volatile backup/approval/readback/unknown/restore
+ semantics and no existing source/model/physical mutation. No renumbering
+ is needed in this handoff.
### Remaining
-- Worker execution of Step-09, then one consolidated review against its frozen
- authoring/applicability/version/diff/UI matrix and shared quality gate.
- Correct genuine unmet requirements as Step-09A before simulated programming.
-- Step-10 programming is blocked and not assigned. Calibration authoring is
- assigned work, not implemented functionality; replay and earlier work are accepted.
+- Worker execution of Step-10, then one consolidated review against its frozen
+ target/backup/approval/mutation/readback/recovery matrix and shared quality gate.
+ Correct genuine unmet requirements as Step-10A before local-AI work.
+- Step-11 AI is blocked and not assigned. Programming rehearsal is assigned
+ work, not implemented functionality; authoring/replay and earlier work are accepted.
- Profile/module metadata, synthetic virtual-module communication and deterministic
dynamics/v2 and corrected dashboard are accepted; later features remain planned.
Preserve the complete sequence/safety gates.
### Known blockers and uncertainties
+No blocking Step-09 deficiency was identified against its frozen contract.
+Its authoring-only baseline is not a verified target backup or permission to
+program anything. Step-10 must establish those separate rehearsal contracts.
+
No blocking Step-08 deficiency was identified against its frozen contract.
The worker disclosed an existing recording-panel initialization race when a
Save-followup refresh is still pending during host navigation. That unchanged
recording flow is outside Step-08; no replay check is claimed to cover/fix it.
Native preparation was restarted and final-binary replay passed without the
error overlay. Retain the issue for a separately scoped recording follow-up,
-not a retrospective replay criterion or automatic Step-09 cleanup.
+not a retrospective replay/authoring criterion or automatic Step-10 cleanup.
No blocking Step-07 deficiency remains. Its source-close follow-up below is
historical and closed by accepted Step-07B:
diff --git a/prompts/STATE.md b/prompts/STATE.md
index 952351a..574ee8d 100644
--- a/prompts/STATE.md
+++ b/prompts/STATE.md
@@ -5,13 +5,13 @@
| Field | Value |
|---|---|
| Updated | 2026-10-30 |
-| Phase | Recorded replay accepted; bounded synthetic calibration authoring next |
-| Active step | Step-09 - Synthetic calibration authoring and immutable proposals |
-| Assignment | [Step-09.md](Step-09.md) |
+| Phase | Synthetic authoring accepted; isolated simulated programming rehearsal next |
+| Active step | Step-10 - Verified simulated programming and recovery |
+| Assignment | [Step-10.md](Step-10.md) |
| Assignment status | READY FOR WORKER / AWAITING MANUAL HANDOFF |
-| Expected worker report | `prompts/Step-09-Report.md` - not yet created |
+| Expected worker report | `prompts/Step-10-Report.md` - not yet created |
| Last accepted correction | Step-07B - accepted 2026-10-30 |
-| Last accepted major milestone | Step-08 - accepted 2026-10-30 |
+| Last accepted major milestone | Step-09 - accepted 2026-10-30 |
| Outstanding corrections | None |
| Step-02 status | ACCEPTED after Step-02A |
| Step-03 status | ACCEPTED after Step-03A/Step-03B |
@@ -23,10 +23,11 @@
| Step-07 status | ACCEPTED after Step-07A/Step-07B |
| Step-07A review | All original corrective criteria closed with Step-07B |
| Step-08 status | ACCEPTED 2026-10-30; no correction required |
-| Step-09 status | READY FOR WORKER; synthetic definitions/proposals/diffs only |
-| Step-10 status | Verified simulated programming; BLOCKED until authoring acceptance |
-| Worker execution | Step-08 returned and accepted; Step-09 not invoked |
-| Immediate next action | User manually directs the worker to execute Step-09 and shared quality gate only |
+| Step-09 status | ACCEPTED 2026-10-30; no correction required |
+| Step-10 status | READY FOR WORKER; isolated simulation image and volatile verified-backup/approval/write/readback/restore |
+| Step-11 status | Local AI/runbooks; BLOCKED until Step-10 acceptance |
+| Worker execution | Step-09 returned and accepted; Step-10 not invoked |
+| Immediate next action | User manually directs the worker to execute Step-10 and shared quality gate only |
| Next orchestrator action | After manual return, inspect the assignment, report, implementation, tests, Git changes, documentation and recorded command evidence |
## Repository baseline at initialization
@@ -1071,6 +1072,55 @@ ECU read or verified backup. Proposal validation grants no Tested/Approved/
Applied status, simulation mutation or hardware authority. No calibration disk
format/storage or programming service is assigned in this slice.
+## Step-09 acceptance
+
+Decision: **ACCEPTED**, 2026-10-30. Frozen C-01..C-12 and AC-01..AC-05 are
+satisfied on reviewed source and worker evidence. No Step-09A is required.
+
+Reviewed [Step-09](Step-09.md), its [report](Step-09-Report.md), the complete
+Core applicability/definition/value contracts and Application baseline/head/
+validation/version/diff flow, routed copied/pinned editor, all three new test
+partials, docs/README, unchanged references and existing Release outputs.
+
+| Criterion | Decision | Evidence |
+|---|---|---|
+| AC-01 | ACCEPTED | Real exact configuration/profile/module selection, model/definition identity, full scalar/table/axis/unit/bounds validation, unsupported-template and cross-source atomic rejections |
+| AC-02 | ACCEPTED | Exact 650->1250/+600 and 360->350/-10 diffs, immutable parents/source/snapshots, no-op/changed-back/tiny-difference behavior, one-winner controlled stale-head commits and 32/33 capacity |
+| AC-03 | ACCEPTED | Actual editor/history/diff/replacement events, parse errors/stale-editor preservation, pinned torque input units and exact unedited canonical values; authoring-only status |
+| AC-04 | ACCEPTED ON WORKER EXECUTION EVIDENCE | Reported complete nine-project Release build zero warnings/errors; 179 unit + 226 integration passes (405 total, zero failed/skipped), real live/recording/replay zero-call preservation and native final-binary authoring |
+| AC-05 | ACCEPTED | Executable matrix, post-green boundary/identity/defensive-copy/diff self-review additions, accurate docs and protected/history/manual workflow preserved |
+
+The 55 added integration cases preserve all 350 prior cases. Native checks
+include exact scalar/table proposals and version-pair diffs, invalid/stale-source
+edits, pinned unit drafts, unchanged original configuration/live diagnostics,
+explicit replacement and an empty authoring state after process restart.
+They do not claim a tested/applied proposal, verified backup or ECU read.
+
+The orchestrator ran no application build/test/native/workload command.
+Case inventory, graph and existing outputs corroborate worker execution, not
+independent runtime verification. SDK patch 10.0.403 remains within the existing
+roll-forward policy; no dependency/system change was reported.
+
+## Step-10 rehearsal handoff
+
+[Step-10](Step-10.md) supplies one explicit, isolated simulation target whose
+mutable supported image is owned by Simulation through a typed Diagnostics port.
+It is initialized from the selected immutable configuration but thereafter read/
+written independently; neither the authoring service nor a request echo is readback.
+
+Only the supported warm-idle scalar and fixed-axis torque table are covered.
+Prepare a verified process-memory supported-image backup, approve an exact
+immutable proposal/source revision, compare again before dispatch, read back
+fresh target state and verify every changed/unchanged value. Unknown outcomes
+require explicit reconciliation; restoring the original backup requires a
+separate approval bound to that same target instance and current revision.
+
+Closing/reopening destroys/recreates the rehearsal target; old approvals/backups
+cannot act on a new instance. No physical/replay target, running-dynamics mutation,
+new wire/firmware format or crash-durable/device-backup claim is assigned.
+Connecting the programmed image to a fresh dynamics run and functional evaluation
+is later explicit work, not an implied Step-10 feature. Step-11 remains blocked.
+
## Prerequisites, limitations, and known issues
- Step-01A worker evidence establishes portable and native Windows compatibility
@@ -1097,24 +1147,24 @@ format/storage or programming service is assigned in this slice.
Step-04B. Step-05's original and follow-up findings are closed. Preserve the 190-/
202-/207-case reports and original numerical/native evidence distinctly.
- Profile metadata/UI, synthetic diagnostics, deterministic dynamics/v2 and the
- corrected dashboard/display units/recording archive/replay are accepted.
- Calibration authoring/programming, AI and physical hardware operations
+ corrected dashboard/display units/recording archive/replay/authoring are accepted.
+ Simulated programming, AI and physical hardware operations
remain unimplemented.
- No application build or test has been executed by the orchestrator.
## Review and progression gate
-On manual return, evaluate Step-09 and its frozen authoring contract/shared gate using the
+On manual return, evaluate Step-10 and its frozen programming-rehearsal contract/shared gate using the
assignment, worker report, actual code/tests, dependency graph, Git changes,
README/docs, and recorded build/test evidence. Do not accept solely on a success
claim; do not claim independent runtime verification.
-- Inspect exact source/definition applicability, immutable baseline/proposal
- history, atomic validation/head checks, precise scalar/table diffs and unchanged
- model/source behavior. Do not add deferred programming/storage/approval scope.
-- If accepted: accept Step-09, update roadmap/state, prepare a bounded Step-10 simulated-programming assignment
+- Inspect actual isolated target state, backup/approval/source binding, rejected/
+ uncertain mutation and fresh readback/restore, one operation owner and zero
+ existing-model/source effects. Do not add deferred physics/durable/physical scope.
+- If accepted: accept Step-10, update roadmap/state, prepare a bounded Step-11 local-AI/runbook assignment
and stop for manual handoff.
-- If deficient: issue narrowly scoped Step-09A only for a material unmet contract/
+- If deficient: issue narrowly scoped Step-10A only for a material unmet contract/
regression, then stop. Planned new features are not corrections.
- If blocked: retain the active step, document the prerequisite and required
worker evidence; do not advance or mark unexecuted checks as successful.
@@ -1189,12 +1239,14 @@ claim; do not claim independent runtime verification.
| 2026-10-30 | Step-08 returned and ACCEPTED | Frozen replay contract satisfied; reported 350-case/clean Release/offline native evidence, exact prefixes/time/owner/source/units and self-review inspected; no 08A |
| 2026-10-30 | Calibration envelope split prospectively | Step-09 authoring/versioning/diffs, Step-10 simulated programming; former unassigned 10-22 become 11-23; completed history preserved |
| 2026-10-30 | Step-09 prepared | Configuration-derived synthetic baseline, immutable scalar/table proposals and exact diffs; no model mutation, approval/backup/programming or physical writes |
+| 2026-10-30 | Step-09 returned and ACCEPTED | Frozen authoring contract satisfied; reported 405-case/clean Release/native evidence, exact source/head/versions/diffs/limits/no-write and self-review inspected; no 09A |
+| 2026-10-30 | Step-10 prepared | Isolated typed simulation target, verified volatile supported-image backup, approval/CAS/write/fresh readback/reconciliation/restore; no existing-model or physical writes, no renumbering |
## Manual handoff instruction
-Provide [Step-09.md](Step-09.md) and the shared
+Provide [Step-10.md](Step-10.md) and the shared
[worker gate](WORKER-QUALITY-GATE.md) to the separate worker and request execution
-of that assignment only. The worker must produce `prompts/Step-09-Report.md`
-and stop for review. Do not begin Step-10 simulated programming.
+of that assignment only. The worker must produce `prompts/Step-10-Report.md`
+and stop for review. Do not begin Step-11 local AI/runbooks.
Return manually to the orchestrator for review. Reports, including final chat
reports, must follow the single plain triple-backtick copy-window requirement.
diff --git a/prompts/Step-09-Report.md b/prompts/Step-09-Report.md
new file mode 100644
index 0000000..dff5e91
--- /dev/null
+++ b/prompts/Step-09-Report.md
@@ -0,0 +1,261 @@
+```
+# Step-09 - Synthetic calibration authoring and immutable proposals
+
+## Status
+
+COMPLETE. The bounded authoring implementation, all frozen contracts,
+post-green self-review, focused tests, nine-project Release build, complete
+regressions and required native authoring smoke passed.
+
+Step-09 remains pending manual orchestrator review; this report does not grant
+acceptance. Accepted Step-08 and the existing 350-case baseline are preserved.
+Step-10 programming was not started. No agents, automatic handoff, staging,
+commit or push occurred.
+
+## Functions, files and interfaces
+
+- [SyntheticEngineCalibration.cs](../src/AutoForge.Core/Calibration/SyntheticEngineCalibration.cs):
+ small immutable applicability, scalar/fixed-axis definition and value
+ contracts, typed CalibrationAuthoringException/CalibrationFailure, defensive
+ collection copying and complete supported-template/candidate validation.
+ Identity scaling is exactly 1/offset 0; no firmware encoding is supplied.
+- [CalibrationAuthoringService.cs](../src/AutoForge.Application/Features/Vehicles/Calibration/CalibrationAuthoringService.cs):
+ CreateBaseline, ReplaceBaseline, Save, Compare and immutable Snapshot.
+ The service reads only the existing IDynamicsConfigurationService and
+ IVehicleProfileService. Registration retains one singleton workspace with
+ at most 32 saved revisions. Each immutable version carries its own
+ workspace/source identity, revision, kind, exact parent and copied values.
+ Diffs carry explicit source/version identities and exact changed entries.
+ No live/model/archive-save/approval/programming port exists in this slice.
+- [CalibrationPage.razor](../src/AutoForge.UI/Features/Vehicles/Calibration/CalibrationPage.razor):
+ /calibration, exact configuration selection, explicit baseline/replacement,
+ copied expected-head draft, scalar/fixed-axis table editor, pinned torque
+ units, read-only version inspection, exact version-pair diffs and visible
+ parse/validation/stale-source/head errors.
+- [AddAutoForgeUi.cs](../src/AutoForge.UI/Features/Foundation/AddAutoForgeUi.cs),
+ [MainLayout.razor](../src/AutoForge.UI/Layout/MainLayout.razor) and
+ [Home.razor](../src/AutoForge.UI/Features/Foundation/Home.razor):
+ minimal service composition and shared navigation.
+
+New executable evidence is the CalibrationAuthoringTests partial class in:
+
+- [CalibrationAuthoringTests.cs](../src/tests/AutoForge.IntegrationTests/CalibrationAuthoringTests.cs)
+- [CalibrationAuthoringUiTests.cs](../src/tests/AutoForge.IntegrationTests/CalibrationAuthoringUiTests.cs)
+- [CalibrationAuthoringCoexistenceTests.cs](../src/tests/AutoForge.IntegrationTests/CalibrationAuthoringCoexistenceTests.cs)
+
+The initial C-01..C-12 source/value/head/limit/defensive-copy/rendered/isolation
+contracts were written before production implementation. Post-green review
+added exact row boundaries, full profile-revision replacement, case-sensitive
+source-token vectors, multi-cell/reverse diffs and malformed table metadata.
+
+## Frozen C-01..C-12 contract matrix
+
+All rows below are PASSED. Named methods were executed, not proposed.
+
+| ID | Named evidence and exact result |
+|---|---|
+| C-01 | ExplicitBaseline_UsesExactConfigurationAndActualModuleWithoutRoleFallback. The real profile/configuration services yield one explicit immutable baseline at 650 rpm and torque rows (650,240), (1000,300), (2000,360), (3200,350), (4200,300), (5000,180). Applicability binds exact config/profile revision/module/model/definition. Optional firmware remains null. A valid configuration explicitly referencing module.cabin.body resolves that real module and its metadata, not the engine role. There is no implicit workspace on route entry. |
+| C-02 | ScalarThenTableProposals_HaveExactLinearParentsAndStructuredDiffs; native workflow. Saving 650->1250 produces unique Proposed revision 2, parent=baseline/head revision 1, and exactly one scalar diff: before=650, after=1250, delta=600 rpm. Baseline and original Model.WarmIdleTargetRpm remain exactly 650. Every version retains workspace/source tokens. |
+| C-03 | ScalarThenTableProposals_HaveExactLinearParentsAndStructuredDiffs; MultiCellAndReverseDiffs_AreExactDeterministicAxisOrderedSnapshots; native baseline/preceding diff. Editing only the 2000-rpm cell 360->350 produces revision 3 with exact revision-2 parent, exactly two baseline diff entries (table delta -10 N*m; scalar +600 rpm), and exactly one preceding-revision diff. Unchanged cells and axes are omitted. Parameter order is ordinal logical ID, then numeric axis order. Reverse diffs swap exact before/after and signs. |
+| C-04 | InvalidScalar_RejectsBeforeHeadHistorySourceOrCapacityMutation (NaN, both infinities, 649.999, 5000.001); InvalidTorqueCell_RejectsTheEntireCandidateIncludingValidScalarEdit (NaN, both infinities, 0.999, 1000.001); WrongCandidateShapeUnitsKeysAndAxes_RejectWithoutNormalization (13 independent shape/key/unit/axis/count vectors); MalformedDefinitionAndUnloadedCommands_RejectTypedWithoutFabricatedWorkspace; InvalidTableDefinitionMetadata_IsRejectedWithoutAHealthyDefault; SourceTokenMismatch_RejectsWithoutCrossSourceFallback. All return typed visible failures before any snapshot/head/history/source mutation. No clipping, sorting, normalization, omitted-cell save or unknown-key fallback occurs. |
+| C-05 | NoOpBoundsChangedBackAndTinyDiff_AreExactNotRoundedOrClipped. The initial identical save returns the very same baseline revision and keeps count 1. Exact lower/upper values 650/5000 rpm and 1/1000 N*m are accepted. A changed-back save creates a new Proposed revision with exact previous parent and empty baseline diff. double.BitIncrement(650) remains an explicit nonzero exact diff, not rounded away. |
+| C-06 | StaleSequentialAndBarrierControlledConcurrentHeads_CommitAtMostOneProposal; TwoActualEditorsAndSourceReplacement_RejectStaleOrUnconfirmedLossWithoutMutation. Two actual Save calls released through a two-participant barrier with the same expected head yield exactly one changed proposal and one StaleHead rejection, count 2 and one exact parent chain. Sequential stale changed and unchanged requests also reject. Two real rendered editors preserve the loser draft/error without lost update or implicit rebase. |
+| C-07 | DefinitionCandidateHistoryAndDiff_DefensivelyCopyCallerCollections. Mutating source axis/cell arrays, scalar lists and table lists after candidate creation cannot alter baseline/proposal/definition values. Older version and diff values stay 650/1250/+600 after later saves. Definition axes, history and diff entries reject IList mutation. Each version's source/workspace/parent identity remains immutable. |
+| C-08 | IdentityComparisonsAndExplicitReplacement_PreservePriorHistoryOnAnyRejection; SourceTokenMismatch_RejectsWithoutCrossSourceFallback (configuration/profile revision/module/model/definition and exact-case variants); FullProfileRevisionChangeAndInvalidEmptyRequests_PreserveTheExactCurrentWorkspace; UnsupportedButValidDynamicsConfiguration_RejectsTemplateBeforeReplacement; real rendered replacement tests. Different or replaced source/head/version IDs cannot cross-save or compare. Invalid/unconfirmed/stale replacement preserves the prior exact snapshot. Confirmed replacement creates a fresh workspace with one baseline; old version IDs reject. Profile/module case variants follow accepted identity policy, while config/model/definition identifiers remain exact. A real profile revision-2 source stays separate from revision 1. |
+| C-09 | TorqueDraft_IsPinnedAndUneditedSavePreservesExactCanonicalDoublesAcrossToggles; RealEditor_SaveDiffHistoryAndInvalidInput_UseExactVersionsNotSharedDraftReferences; native draft checks. Unsaved torque strings remain pinned to captured units across global switches/rerenders. Edited torque is converted once and asserted against the exact independent N*m/lbf*ft factor result; unedited values retain canonical doubles without conversion drift. Eight repeated unit/no-op-save cycles keep the identical head and exact cells. Native Metric 345 N*m remained 345 after Imperial switch; untouched Imperial-to-Metric save retained exact 350 N*m and revision 3. |
+| C-10 | RealEditor_SaveDiffHistoryAndInvalidInput_UseExactVersionsNotSharedDraftReferences; TwoActualEditorsAndSourceReplacement_RejectStaleOrUnconfirmedLossWithoutMutation; native UI. Real DI/rendered events exercise exact source selection, baseline, parent/head saves, history-only inspection, explicit version-pair diff and typed parse/validation errors. Inspecting baseline does not change the editable revision-3 head. Status is Baseline/Proposed authoring only, never granted Tested/Approved/Applied/verified-backup authority. |
+| C-11 | HistoryLimit_IsExactly32IncludingBaselineAndNoOpStillSucceedsAtCapacity. Revisions 2..32 commit with unique IDs and exact monotonic parents. The identical full head is returned without consuming capacity; changed revision 33 rejects HistoryLimit with the same snapshot/revision/count 32. One workspace is retained; replacement resets the service-held history explicitly, not by eviction or hidden accumulation. |
+| C-12 | AuthoringWithActualLiveSourceRecordingAndReplay_AddsZeroTransportModelOrStoreSaveCalls. Real live dynamics, saved recording/strict file-store archive and validated replay coexist during baseline/proposals/diff/unit operations. Transport-call delta=0, model-control-call delta=0, archive-Save-call delta=0; no approval/programming boundary exists to invoke. Original profile/config export/fingerprint, live trace/status, recording serialization/raw file bytes and the exact replay snapshot remain unchanged. All 350 baseline tests pass. Final nine-project Release/native checks are below. |
+
+## Acceptance criteria
+
+| ID | Result | Evidence |
+|---|---|---|
+| AC-01 | PASSED | C-01/C-04/C-08 real exact configuration/profile/module selection, bounded supported definition, unknown/mismatched references and atomic template/value/source rejection. |
+| AC-02 | PASSED | C-02/C-03/C-05..C-07/C-11 exact immutable versions/parents/diffs, no-op and changed-back semantics, defensive copies, deterministic competing-head commits and 32/33 limit. |
+| AC-03 | PASSED | C-09/C-10 actual rendered commands/history/diff/source confirmation, pinned draft units and exact canonical equality; native editor labels remain authoring-only. |
+| AC-04 | PASSED | C-12 counted real-source/replay/recording coexistence; 405 final passes, all nine projects/native Release build with zero warnings/errors, and required native authoring checks. |
+| AC-05 | PASSED | Executable matrix, own post-green source-path review, directly related docs/README, preserved protected/history/dependency/manual workflow and this single fenced report. |
+
+## Commands and outcomes
+
+SDK: dotnet --version -> 10.0.403 under the unchanged global.json policy.
+The existing tests use xUnit v2/VSTest. No SDK/package/workload/tool
+installation, update, repair or restore occurred.
+
+The final commands ran sequentially after the review additions:
+
+| Exact command | Exit | Result |
+|---|---:|---|
+| dotnet test .\src\tests\AutoForge.IntegrationTests\AutoForge.IntegrationTests.csproj --configuration Release --no-restore --filter "FullyQualifiedName~CalibrationAuthoringTests" | 0 | 55 authoring cases passed, zero failed/skipped. |
+| dotnet build .\src\AutoForge.slnx --configuration Release --no-restore | 0 | All nine projects/native Client passed; 0 warnings, 0 errors. MAUI XAML source-generation output was informational. |
+| dotnet test .\src\AutoForge.slnx --configuration Release --no-build | 0 | 179 unit + 226 integration = 405 passed, zero failed/skipped. |
+| git --no-pager diff --check | 0 | No whitespace errors. Existing Git LF-to-CRLF notices for README/build guide were informational. |
+| git --no-pager diff --exit-code -- prompts global.json Directory.Build.props Directory.Packages.props NuGet.Config src\AutoForge.Simulation src\AutoForge.Diagnostics src\AutoForge.Application\Features\Vehicles\Telemetry | 0 | Existing orchestration/history/dependency and Simulation/Diagnostics/recording/replay implementations unchanged before adding this report. |
+
+Per-project Release build: AutoForge.Core, AutoForge.Diagnostics,
+AutoForge.Simulation, AutoForge.Application, AutoForge.Components,
+AutoForge.UI, AutoForge.Client, AutoForge.UnitTests and
+AutoForge.IntegrationTests all PASSED. Eight projects remain portable net10.0;
+Client remains net10.0-windows10.0.26100.0 / win-x64.
+
+The accepted 350 baseline cases remain 179 unit + 171 integration. This step
+adds 55 integration cases and deletes or weakens no baseline test.
+Important exact boundaries: 32 saved revisions including baseline; 2..32 fixed
+torque rows; finite inclusive model-derived scalar range; finite [1,1000] N*m
+cells; identity scaling 1/offset 0. No authoring disk persistence exists.
+Existing archive/gauge/replay limits and clock ownership are unchanged.
+
+Iteration evidence:
+
+- The initial focused command failed compilation because a concurrency test
+ used blocking Task.WaitAll/Result, rejected by xUnit1031 under warnings-as-
+ errors. It was corrected to async Task.WhenAll/WaitAsync; the barrier still
+ establishes simultaneous real commit attempts without sleeps/stress timing.
+- The first executable focused run passed 47 cases with zero failures.
+ Post-green additions expanded this to 50, then final 55 cases.
+- The reviewed full build/test run passed 400 cases; the final run passed 405.
+ There were no unresolved behavioral or build failures. Compilation failure
+ is not claimed as a pre-fix behavioral reproduction; authoring did not
+ exist before this assignment.
+
+## Native versus controlled evidence
+
+The real Release Windows Client was launched with a task-owned WebView2 profile
+and local DevTools port 9379. A temporary Node/built-in WebSocket helper
+operated the actual native WebView controls. There was no second web host,
+dependency or production debug feature.
+
+Native actions and actual results:
+
+1. Through the existing simulation route, explicitly imported the synthetic
+ profile, selected its exact revision and created the warm configuration.
+ No session was opened by authoring. Its original export and fingerprint
+ were retained for exact comparison:
+ sha256:v1:e8991ae139b54959ec53a4fe64b08dc9bfc03feb533496cf741f2c9f3a2342da.
+2. Selected that exact configuration on /calibration and created the
+ Synthetic configuration-derived baseline: 650 rpm plus the six original
+ torque rows. Saved 1250 rpm as Proposed revision 2 and the 2000-rpm
+ torque edit 350 N*m as Proposed revision 3.
+3. Native baseline diff contained exactly the scalar 650->1250, delta +600 rpm
+ and table cell 360->350, delta -10 N*m. Comparing revision 2 to 3 contained
+ only the table cell. Baseline history inspection left the editable head
+ at revision 3. First-run baseline/version IDs were:
+ 5306f3d1604d4708a204d78d53e5c745 (baseline),
+ bda2b90206dc42ff91ac6b35fe7d552b (revision 2),
+ 35600482db3f418ca6d8bc93c6b783f1 (revision 3).
+4. Native scalar 600 and torque 1001 saves were rejected visibly with the
+ same revision/count/head. An unselected/different source rejected with
+ the exact source-mismatch error; unconfirmed replacement rejected with
+ the explicit confirmation error and retained history.
+5. Typed unsaved 345 while the draft was Metric/N*m, then changed global
+ units to Imperial. The input stayed 345 and the draft explicitly stayed
+ Metric/N*m. Cancel loaded a new Imperial draft showing source 350 N*m as
+ 258.14675224704285 lbf*ft. Switching globally back to Metric and saving
+ untouched returned the identical revision-3 head and exact 350 N*m, with
+ no new history entry.
+6. Returned to /simulation, selected/exported the original configuration:
+ its entire export was exactly unchanged, warm idle remained 650 rpm and
+ 2000-rpm torque remained 360 N*m. An explicit subsequent dynamics session
+ stepped to 7 / 0.7 seconds and read actual diagnostic-frame engine speed
+ 631.80416 rpm / Good / SYNTHETIC_DYNAMIC, not the 1250 proposal. This is
+ an observed unchanged-source model result, not a claim that the proposal
+ was tested/applied or that the model was at exact idle.
+7. Closed that actual session. Reopened authoring with the same saved
+ revision-3 history. Confirmed explicit replacement discarded an unsaved
+ 1500-rpm draft/history and created a new baseline with 650 rpm and torque
+ 360 at 2000 rpm. Profile/simulation/replay routes and authoring re-entry
+ worked; replay remained explicitly Unloaded.
+8. After the final 405-pass build, restarted the actual Client. Authoring had
+ no workspace and no saved configuration, confirming process-memory
+ lifetime rather than hidden persistence. Explicitly recreated the warm
+ source and repeated baseline, 1250-rpm proposal, 350-N*m cell proposal
+ and exact two-entry diff on the final binary. Final head was revision 3,
+ ID 62431277f0624fc8ba25ef4a02fcb602 in workspace
+ fe2a12d0aa0b47c6bbadf63961fc74b7. No native error overlay appeared.
+
+Native observations verify the real configuration/Application/UI/editor and
+normal unit/history/diff/navigation workflow. Exact concurrent/stale-head,
+history-capacity, malformed-definition and source-isolation proofs are
+controlled real-service tests, not attributed to human-speed native timing.
+No real device, backup, approval, programming or physics application is claimed.
+
+Cleanup PASSED: both task-owned native Client sessions completed. Only their
+specific PIDs (38528 and 1512) were terminated. The task-only WebView profile
+and helper were removed, no task WebView processes remained and port 9379 had
+no listener. The actual app-local recording directory was inspected and
+remained empty; no native recording file was created/removed by authoring.
+Profiles/configurations/proposals used for native smoke were process-memory
+only. Existing/default WebView data and unrelated app files/preferences were
+not reset. Original Metric/Road preference values were restored and observed.
+
+## Own post-green source-path self-review
+
+Reviewed actual producers/consumers through exact configuration selection and
+profile/module validation -> supported immutable definition/baseline ->
+complete candidate -> expected workspace/source/head checks -> linear commit ->
+structured diff -> routed copied draft/units/history UI.
+
+Public entry points reviewed: CreateBaseline, ReplaceBaseline, Save, Compare,
+Snapshot, template construction/Validate, and route create/replace/save/cancel/
+inspect/compare plus render/unit/lifetime callbacks. Normal, invalid, boundary,
+same-content, changed-back, stale/concurrent, cross-source and replacement paths
+were walked against the frozen matrix.
+
+Validation precedes every history/head/version commitment. No-change requests
+still require the current source/head. Version creation/capacity mutation occurs
+only after complete validation. One lock serializes real commits without an
+await-held gate or external asynchronous owner. Definition/value collections
+are read-only and defensively copied. Units/rerenders do not save or rebind
+drafts. History inspection does not change editable head. No source mutation
+or live/store/model/approval dependency is introduced.
+
+Review improvements completed inside this step:
+
+- Made every standalone immutable revision explicitly carry its own copied
+ workspace/source identity, not only inherit context through its container.
+- Strengthened edited-unit assertions to exact independent factor results,
+ not a tolerance that could hide canonical conversion differences.
+- Added 2/32 row-boundary assertions, real profile revision-2 replacement,
+ exact-case source/model/definition rejection, malformed table metadata
+ and multi-cell/reverse exact diff ordering/sign assertions.
+- Improved diff parameter labeling without changing canonical results.
+
+Affected focused checks, all nine projects and complete regressions were rerun
+after review additions; the final binary was then checked natively again.
+No known unresolved defect in the assigned exit contract remains.
+
+## Documentation, scope and preservation
+
+Updated [README.md](../README.md),
+[documentation index](../docs/README.md),
+[architecture](../docs/architecture.md),
+[build/test guide](../docs/build-and-test.md) and the directly related status/
+isolation note in [replay contracts](../docs/telemetry-replay.md). Added
+[calibration authoring guide](../docs/calibration-authoring.md).
+They document exact applicability/template bounds, source/head/version/diff
+rules, one-workspace/32-revision lifetime, pinned versus canonical units,
+no backup/test/approval/apply claims, accepted Step-08 and Step-09 pending
+manual review. Step-10 programming stays separate/unimplemented.
+
+The worktree began clean on main at 866831f and HEAD is unchanged. Existing
+prompts/history/roadmap/state/assignment/shared quality gate were not edited;
+this is the only new prompts file. No protected instruction file was created
+or modified. The index is empty. No staging/commit/push, dependency/project/
+host/schema/protocol changes or agent/automatic orchestration occurred.
+
+All nine project references are unchanged. Core only gained the approved
+calibration contracts; Simulation/Diagnostics implementations/oracles,
+recording/replay behavior and source configurations remain unchanged.
+Source/tests stay under src and src/tests; technical documentation stays
+under docs. The separately disclosed recording refresh/navigation issue was
+not changed or worked into this authoring assignment.
+
+Remaining unassigned capabilities are programming/readback/restore/verified
+backup, Tested/Approved workflow, model application, calibration-file
+persistence/import/export, editable-axis/multidimensional maps, arbitrary
+firmware scaling/memory, AI and hardware operations. No future step is
+authorized by this report.
+
+STOP.
+```
diff --git a/prompts/Step-10.md b/prompts/Step-10.md
new file mode 100644
index 0000000..530d237
--- /dev/null
+++ b/prompts/Step-10.md
@@ -0,0 +1,313 @@
+# Step-10 - Verified simulated programming and recovery
+
+## STEP IDENTIFIER
+
+Step-10. Step-09 was accepted on 2026-10-30 with no corrective assignment.
+This is the sole active implementation assignment. Step-11 local AI is blocked.
+
+## STEP TITLE
+
+Rehearse approved logical calibration writes against an isolated simulation
+image, verifying backup, changed/unchanged readback and separately approved restore.
+
+## OBJECTIVE
+
+One user outcome: take a saved authoring proposal through an explicit simulated
+target/backup/approval/write/readback/restore workflow with truthful failure states.
+One primary new contract: a guarded target mutation bound to an exact image
+revision and immutable approval, not a change to the authoring configuration.
+
+Read [STATE.md](STATE.md), [ROADMAP.md](ROADMAP.md),
+[authoring contracts](../docs/calibration-authoring.md) and
+[WORKER-QUALITY-GATE.md](WORKER-QUALITY-GATE.md). Make the frozen matrix executable
+before coding, self-review after first green, write `prompts/Step-10-Report.md`,
+and STOP. Do not begin local AI or any physical operation.
+
+## ARCHITECTURAL CONTEXT
+
+Keep all nine projects, one Client and generic Components. Core holds reusable
+calibration values/definitions; Diagnostics exposes a narrow typed simulated
+programming target port; Simulation owns its real mutable target image.
+Application owns backup/approval/command/reconciliation/verification and UI owns
+interaction. Client composes the explicit simulation provider.
+
+Application/UI must not reference Simulation implementation, read its private
+state/oracle, or manufacture target readback from proposal/request/configuration.
+Use logical scalar/table operations, not a new wire protocol, binary offset or
+unrestricted command channel. No new project/package/host or generic programming/
+workflow framework. Source/tests stay under `src`, tests under `src/tests`.
+
+## CURRENT IMPLEMENTATION STATE
+
+Accepted authoring offers one immutable source-bound workspace, Baseline/Proposed
+revisions, exact scalar/table values/axes/diffs and guarded head commits.
+Worker baseline: 179 unit + 226 integration passes (405 total, zero failed/
+skipped), clean nine-project Release build and native authoring checks.
+The orchestrator did not run them. No programming target/service exists yet.
+
+Use the actual [authoring service](../src/AutoForge.Application/Features/Vehicles/Calibration/CalibrationAuthoringService.cs),
+[calibration contracts](../src/AutoForge.Core/Calibration/SyntheticEngineCalibration.cs)
+and [configuration service](../src/AutoForge.Application/Features/Vehicles/Simulation/DynamicsConfigurationService.cs).
+The supported image is exactly `engine.warm-idle-target` (rpm) and
+`engine.torque-curve` (fixed rpm axis, N*m cells), with existing template validation.
+
+The source warm baseline is 650 rpm; the saved proposal can be 1250 rpm and
+360->350 N*m at 2000 rpm. Those are synthetic values, not manufacturer data.
+A configuration-derived authoring baseline is not the target backup. Inspect
+Git/prior art and preserve accepted behavior, dirty work and historical reports.
+
+## REQUIRED IMPLEMENTATION
+
+### Frozen contract matrix
+
+| ID | Input/precondition | Required result |
+|---|---|---|
+| C-01 | Explicit current supported authoring workspace/config/module plus Simulation provider | Open one fresh isolated target instance at image revision 0, with complete supported source values. No implicit open/write; physical/replay/wrong-provider/source rejects before target creation or mutation. |
+| C-02 | Read target, create original backup and verify with a second independent read | Identity/revision/shape/axes/units/values match exactly; immutable verified volatile backup covers both keys/all cells. Wrong/incomplete/mismatched read rejects before approval; baseline is not used as a fake response. |
+| C-03 | Prepare/approve immutable current proposal 650->1250, then Apply | Display exact target-to-proposal diff; approval binds target/source/definition, actual before image/revision, proposal/head and action. Re-read/CAS before dispatch, one write, fresh readback; scalar=1250, every torque cell unchanged, authoring baseline/config remain 650. |
+| C-04 | Next saved proposal additionally changes 2000-rpm torque 360->350 | New approval binds fresh target revision; exactly that cell changes, axes and all other values stay intact; full readback equality is checked, not just acknowledgement or selected cell. |
+| C-05 | Missing/mismatched backup/confirmation/token/proposal/head/source/target revision, no-op proposal, invalid candidate or wrong target kind | Typed visible rejection before approval consumption/write/target mutation; current backup/image/approval/history remain intact except error notification. No auto-rebase, broad writes or inferred authority. |
+| C-06 | Head/workspace/target identity or image changes after approval but before dispatch | Rejected stale approval with zero writes; exact accepted source/proposal/before-image cannot silently follow current data. Reopen creates a new instance and invalidates old approvals/backups. |
+| C-07 | Same operation requested twice; competing operation; cancellation/close before or after dispatch | No second mutation or lost ownership. Exact repeated operation shares/returns its outcome; conflicts reject before mutation. Cancel-before-dispatch writes zero; once dispatch may have happened, outcome is not falsely labeled unchanged/success. |
+| C-08 | Negative acknowledgement, dropped acknowledgement/exception after actual commit, mismatched fresh readback or read failure | Full fresh readback determines verification. Never label Applied from acknowledgement alone. Unverified/uncertain mutation remains visible RecoveryRequired with reason/evidence; no blind resend or automatic restore. |
+| C-09 | Explicit reconcile after an uncertain outcome | Read-only exact current-image evidence identifies unchanged, candidate-matching or divergent/unavailable state; no write or stale cached proof. Only exact target/revision/content evidence may resolve verification; original uncertainty remains in the operation record. |
+| C-10 | Prepare and explicitly approve restore of original backup on same live rehearsal target | Bind fresh current revision/image and original verified backup; one guarded restore and full independent readback. Original 650/360 values and all other cells/axes restored, revision advances; no authoring/history/config rewrite. |
+| C-11 | Wrong-target backup, failed/unknown restore, pending dispose/late read or failed test | No restore permission, false Restored result or old-generation publication; errors persist, owner/target cleanup drains outside required gates and allows safe close. Barriers/resources released in finally. |
+| C-12 | Bounded audit/results, real UI/unit and coexistence paths, full verification | At most 32 dispatched mutation outcomes per target session; exact boundary rejects a new attempt before write. All 405 cases plus new coverage pass; real simulation port and native UI work; no existing diagnostics/model/archive/replay or physical side effects. |
+
+### A. Explicit isolated simulation target, not a dynamics application
+
+Introduce one explicit simulation-only provider with a unique identifier such as
+`autoforge.simulation.calibration-rehearsal`. Opening requires the exact selected
+configuration/profile revision and its actual EngineModuleIdentifier/definition.
+Reject PhysicalHardware, RecordedReplay and any unregistered/mismatched provider
+or descriptor; metadata/capability claims alone cannot authorize a write.
+
+The target owns an independently stored immutable-at-read mutable-at-commit
+supported image, seeded once from the selected configuration and validated
+template. Thereafter Read returns actual target state, and Write/Restore use
+compare-and-swap against the exact instance/image revision and full validated
+candidate. Revision starts 0 and increments once per successful changed commit.
+Validation/conflict/cancellation before commit leaves the image unchanged.
+
+Preserve unique instance identity across all reads. Each read defensively copies
+both supported keys, axis, units and cells. The typed port supplies explicit
+outcomes/errors, not a success-shaped fallback. Actual Simulation implementation
+is exercised in normal/failure tests; test-only fault forwarding may simulate
+lost replies/divergent readback below Application without mocking the workflow.
+
+This target is an isolated programming rehearsal, not a live dynamics session.
+Do not modify `DynamicsConfiguration`, its fingerprint/catalogue, an existing
+DynamicsEngine, signal source, diagnostics schema or profile calibration identity.
+No model telemetry may claim 1250 rpm merely because the rehearsal image stores
+that number. Wiring to a fresh run/functional performance proof is later work.
+
+Target/backup/results are process-memory only. Close destroys that target;
+reopen recreates source values under a new identity. No persist-after-close,
+crash recovery, firmware block transfer or real-device backup claim is assigned.
+
+### B. Independent supported-image backup and explicit approval
+
+Prepare the original target backup once before the first mutation. Read through
+the real target port, validate identity/applicability/revision/complete supported
+shape/values and compare against a second independent read of that same target.
+If either differs or is unavailable, do not publish VerifiedBackup/Ready status.
+Copy the actual observed image; never call an authoring baseline a verified read.
+
+The backup is explicitly "Verified in-memory backup of supported simulation
+image": one scalar plus the complete fixed-axis table, not an entire ECU.
+Keep its target instance/source/definition/image revision and immutable contents.
+It remains the original backup across multiple writes on that instance.
+
+Prepare a candidate only from an immutable saved **current Proposed head** of
+the accepted authoring workspace, with exact source applicability. Read current
+target state to form the actual before-image and precise target-to-candidate diff.
+Different head/workspace/source invalidates pending apply approval; do not replace
+it silently. An identical target/candidate is a visible no-op rejection, not a
+new Applied or verified mutation.
+
+Explicit user confirmation produces a single-use opaque approval bound to:
+action Apply or Restore, target provider/kind/instance/source/definition,
+verified original backup identity, expected current image revision/contents,
+exact candidate values and selected proposal/workspace/head (for Apply).
+Authoring revisions themselves remain Baseline/Proposed, not Approved/Applied.
+This local approval records a deliberate rehearsal action, not cryptographic
+authorization, manufacturer permission or a physical-write capability.
+
+Before dispatch, revalidate approval, source/head and a fresh target read against
+the approved before-image/revision. The target also atomically compares its actual
+revision at commit so a change after that read cannot slip through.
+Never consume approval or count a dispatched result before all preconditions
+pass. Once dispatch begins, prevent token reuse; if cancellation loses certainty,
+do not re-enable the same approval as though no write happened.
+
+### C. Fresh verification, uncertain outcomes and separately approved restore
+
+One operation owner serializes target preparation/mutation/reconciliation/close.
+Guard eligibility before state changes. Commands carry an opaque operation ID;
+repeating the exact active/completed request shares/returns that result rather
+than issuing another write. Reusing an ID with different inputs rejects.
+Conflicting actions while work/drain is pending reject visibly; no gate is held
+across an await needed by cleanup. Close cancels and drains with a shared
+completion/generation guard; no stale success may publish into a new target.
+
+After mutation dispatch, request an independent full Read. Compare target
+instance/source/definition/revision, both keys, units, axes and every changed/
+unchanged cell to the exact expected image. A positive acknowledgement or
+echoed candidate is not verification. Keep acknowledgement versus readback
+separate in the result; do not hide protocol/port/readback errors.
+
+If dispatch may have committed but fresh proof is missing/divergent, label
+RecoveryRequired/Unknown with precise actual evidence and block new Apply.
+Never retry a write or restore automatically. Explicit Reconcile is read-only:
+compare a fresh complete image to approved before/after plus expected revision.
+Classify unchanged/candidate-matching/divergent/unavailable honestly. Exact
+identity/revision/content proof may establish VerifiedAppliedAfterReconciliation;
+preserve the original lost-ack/verification failure in audit. Divergence never
+becomes success merely because one requested value matches.
+
+Restore is a separate prepared/confirmed operation using the immutable original
+backup of that same target instance/source/definition. Read fresh current state,
+bind its revision in a new restore approval and use the same atomic CAS/full
+readback rules. Restore must work after multiple successful writes; it restores
+the original supported values, not the author's latest proposal. Current revision
+advances; restored value equality does not pretend time/version went backwards.
+Wrong/closed/new instance or invalid backup rejects, and failed/uncertain restore
+retains RecoveryRequired rather than a healthy completion.
+
+Preserve a bounded immutable result/audit list in the owning rehearsal session:
+at most 32 **dispatched mutation outcomes** (Apply/Restore, successful or uncertain).
+At capacity reject a new dispatch before consuming approval/write; exact operation
+replays still return their existing result. Preparation/reconciliation update
+bounded current evidence, not a hidden unbounded history.
+Include operation/action, proposal/head and target/backup/revision identities,
+approval, full before/expected/actual evidence, acknowledgement, verification/
+recovery status/error and explicit timestamps. This audit is volatile/local,
+not a new disk format or an external security attestation.
+
+### D. Actual UI, provenance and existing source isolation
+
+Extend the existing calibration area or add a clearly named rehearsal route.
+Use real Application services and the Simulation target provider composed by
+Client. Explicitly open a target, read/prepare backup/proposal, inspect exact
+diff/source/preconditions, confirm Apply, inspect separate acknowledgement/
+readback, reconcile if required, prepare/confirm Restore and close.
+
+Show synthetic/isolated/process-memory scope prominently, current target instance/
+revision, original backup coverage, proposal/head, pending/uncertain/error status
+and bounded audit. Never call authoring source metadata a verified ECU identity.
+No implicit programming on proposal Save, page entry, unit switch or render.
+Unconfirmed/rejected actions leave real target and saved authoring data unchanged.
+
+Use existing display-unit conversion for human-facing torque; programming and
+audit compare canonical rpm/N*m with exact fixed axes. Unit changes cannot mutate
+candidate/approval/before-image or dispatch commands.
+Old live diagnostics/dynamics/recording/replay remain separate; merely opening
+the rehearsal cannot connect/reset/stop or rewrite them.
+A closed rehearsal's immutable backup/result can remain inspectable as inactive
+evidence, but cannot authorize a new target. Reset/new rehearsal is explicit.
+
+## FILES OR PROJECTS EXPECTED TO CHANGE
+
+Narrow Core evidence/target-value contracts if needed, typed Diagnostics target
+ports, Simulation-owned rehearsal state, Application guarded workflow/readback/
+audit, calibration UI/Client DI, focused tests and related README/docs.
+No existing dynamics model/wire/configuration/schema or authoring status rewrite.
+No new project/package/host or private oracle exposed to Application/UI.
+Under `prompts`, create only `Step-10-Report.md`.
+
+## INTERFACE AND DEPENDENCY REQUIREMENTS
+
+Preserve nine projects/references, one Client, pure Components, accepted exact
+source/template/unit/head/value validation, immutable configurations/archives,
+recording/replay and lifetime/clock semantics. No physical provider implementation,
+unrestricted hardware command, emissions/safety/security bypass or inferred
+write permission. Simulation-only actions grant no authority to physical targets.
+No broad catch/silent failure/false backup/ack-only verification/automatic restore.
+Do not fix the separately disclosed recording navigation/refresh issue here.
+No dependency/system/workload install/update/repair/rollback, staging/commit/push
+or destructive Git. Preserve protected/history/orchestration files and dirty work.
+
+## TESTING REQUIREMENTS
+
+Map C-01..C-12 to meaningful named tests before handoff:
+
+- Real configuration/profile/authoring plus actual Simulation target reads.
+ Verify two independent backup reads, complete defensive images, explicit
+ target/kind/source/definition validation and missing/corrupted reads.
+- Apply scalar 650->1250 with all torque cells unchanged; second proposal changes
+ only 2000-rpm torque 360->350; full changed/unrelated readback and separately
+ approved original Restore recover 650/360 plus every other value.
+- Independent invalid source/head/token/revision/shape/unit/value vectors;
+ stale mutation between precheck and target CAS; exact prior-state/write-count
+ assertions. Rejected calls and unit switches cannot consume an approval.
+- Faults injected below the real workflow: rejected before commit, commit then
+ lost ack/cancel, fresh read failure, wrong readback/target identity, divergent
+ unchanged cell and restore failure. Read-only reconciliation proof uses actual
+ target values/revision, not a mocked successful service.
+- Controlled pending-operation/drain/close/late-publication, same operation ID,
+ conflicting requests and bounded 32/33 result capacity. Barriers establish
+ interleavings; no sleeps/polling/stress timing as correctness proof. Release
+ resources in finally and await owned work.
+- Real rendered backup/approval/apply/reconcile/restore/invalid actions, safe
+ error/status/unit presentation and real diagnostics/dynamics/recording/replay
+ coexistence with zero unassigned source/model/store writes.
+
+Run focused cases, then sequentially:
+
+- `dotnet build .\src\AutoForge.slnx --configuration Release --no-restore`
+- `dotnet test .\src\AutoForge.slnx --configuration Release --no-build`
+
+Preserve 405 baseline cases (179 unit, 226 integration) plus meaningful new
+coverage. Map necessary UI-only assertion changes without deleting safety/
+error/source checks. Build all nine projects/native Client. Install/restore
+nothing absent a genuine chosen-command missing dependency.
+
+Native smoke on rebuilt Client: explicitly create source/proposals, open isolated
+target, prepare verified volatile backup, approve/apply scalar then table edit,
+inspect full readback/audit, explicitly approve/verify original Restore, close/
+reopen and confirm new-instance/no-old-approval behavior. Verify original
+configuration/live source remains unchanged and old routes/unit preferences work.
+Native normal success is not controlled port/uncertain/race fault proof.
+Clean only exact task-owned profiles/artifacts; never reset unrelated app data.
+
+## DOCUMENTATION REQUIREMENTS
+
+Update README/index/architecture/build guide and rehearsal usage/contracts:
+isolated Simulation typed target (not a new wire/real driver), supported-image
+volatile backup coverage, approval/source/CAS/single-use operation semantics,
+fresh readback/uncertain/reconcile/approved Restore, bounded audit and actual
+normal/control evidence. Step-09 is accepted; Step-10 remains pending manual
+review. No crash durability, model application, complete ECU backup, tested
+performance, manufacturer compatibility or physical programming is claimed.
+
+## ACCEPTANCE CRITERIA
+
+| ID | Criterion | Evidence |
+|---|---|---|
+| AC-01 | C-01/C-02 actual isolated simulation target, source-kind/applicability gates and independent supported-image backup | Real target/config/port tests with complete defensive reads and no fake source echo |
+| AC-02 | C-03..C-06 exact immutable approval/head/backup/revision and atomic validated mutation | Exact scalar/table/unrelated-value results, stale/CAS/negative vectors and zero-write rejected actions |
+| AC-03 | C-07..C-11 one operation owner, fresh verification/unknown/reconciliation and separately approved Restore | Controlled real-port/lifetime/idempotence/fault cases and full original-image readback |
+| AC-04 | C-12 bounded audit, real UI/native workflow/source isolation, 405 regressions and full Release build | Exact 32/33/no-call/state assertions, native/control distinction and worker commands/results |
+| AC-05 | Matrix/self-review/docs/README/history/protection/manual gate accurately describe implemented limits | Own post-green source-path review, named executed evidence and `prompts/Step-10-Report.md` |
+
+## OUT-OF-SCOPE WORK
+
+Physical programming/driver/protocol/firmware blocks, dynamics application or
+performance reruns, durable calibration/backup/audit format/storage, AI/runbooks,
+new template/unit family, arbitrary offsets/commands, new package/project/host
+and unrelated cleanup. No future assignment, agents, automatic handoff,
+orchestration/shared-gate edit, staging, commit or push.
+
+## REPORTING REQUIREMENTS
+
+Save `prompts/Step-10-Report.md` wholly inside exactly one plain triple-backtick
+fence, no language tag/outside text/nested fences. Include identifier/title/status,
+functions/files/interfaces, C-01..C-12/AC-01..AC-05 matrix with named executed
+evidence, exact backup/approval/write/readback/unknown/reconcile/restore/negative/
+owner/audit outcomes and source-isolation counts, commands/exits/warnings/
+per-project counts, native versus controlled coverage, docs/README, own
+post-green source-path self-review, limitations/deviations/blockers and
+preservation review. COMPLETE requires all assigned checks; otherwise report
+INCOMPLETE/BLOCKED with the precise unmet criterion.
+Save and STOP; do not begin Step-11.
diff --git a/src/AutoForge.Application/Features/Vehicles/Calibration/CalibrationAuthoringService.cs b/src/AutoForge.Application/Features/Vehicles/Calibration/CalibrationAuthoringService.cs
new file mode 100644
index 0000000..394cea7
--- /dev/null
+++ b/src/AutoForge.Application/Features/Vehicles/Calibration/CalibrationAuthoringService.cs
@@ -0,0 +1,229 @@
+using AutoForge.Application.Features.Vehicles.Profiles;
+using AutoForge.Application.Features.Vehicles.Simulation;
+using AutoForge.Core.Calibration;
+using AutoForge.Core.Simulation;
+using AutoForge.Core.Vehicles;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.DependencyInjection.Extensions;
+
+namespace AutoForge.Application.Features.Vehicles.Calibration;
+
+public enum CalibrationVersionKind
+{
+ Baseline,
+ Proposed
+}
+
+public sealed record CalibrationModuleMetadata(
+ string ModuleIdentifier, string? HardwareIdentifier, string? SoftwareIdentifier,
+ string? FirmwareIdentifier, string? CalibrationIdentifier);
+
+public sealed class CalibrationVersion
+{
+ internal CalibrationVersion(string workspaceIdentifier, CalibrationApplicability source,
+ int revision, string? parent, CalibrationVersionKind kind, CalibrationValues values)
+ {
+ Identifier = Guid.NewGuid().ToString("N");
+ WorkspaceIdentifier = workspaceIdentifier;
+ Source = source with { };
+ Revision = revision;
+ ParentIdentifier = parent;
+ Kind = kind;
+ Values = new(values.Scalars, values.Tables);
+ }
+ public string Identifier { get; }
+ public string WorkspaceIdentifier { get; }
+ public CalibrationApplicability Source { get; }
+ public int Revision { get; }
+ public string? ParentIdentifier { get; }
+ public CalibrationVersionKind Kind { get; }
+ public CalibrationValues Values { get; }
+ public string Label => Kind == CalibrationVersionKind.Baseline
+ ? "Synthetic configuration-derived baseline" : "Proposed synthetic authoring revision";
+}
+
+public sealed class CalibrationWorkspace
+{
+ internal CalibrationWorkspace(string identifier, SyntheticEngineCalibration definition,
+ CalibrationModuleMetadata module, IEnumerable
+ Process-memory proposals only. This is not an ECU read, verified backup, Tested/Approved calibration, + programming or model application. Restart loses saved authoring history; leaving this page loses its unsaved draft. +
+Explicitly create/import a warm dynamics configuration. No configuration or workspace is seeded here.
+ +@_error
+} +@if (_status is not null) +{ +@_status
+} + +@if (Authoring.Snapshot is { } workspace) +{ + var source = workspace.Definition.Applicability; ++ Workspace @workspace.Identifier; profile @source.ProfileIdentifier revision @source.ProfileRevision; + configuration @source.ConfigurationIdentifier; explicit module @source.ModuleIdentifier; + model @source.ModelIdentifier v@(source.ModelVersion); + definition @source.DefinitionIdentifier revision @source.DefinitionRevision. +
++ Supplied module metadata only: hardware @(workspace.Module.HardwareIdentifier ?? "unknown"); + software @(workspace.Module.SoftwareIdentifier ?? "unknown"); firmware @(workspace.Module.FirmwareIdentifier ?? "unknown"); + calibration reference @(workspace.Module.CalibrationIdentifier ?? "unknown"). Not verified identity or applicability proof. +
+History @workspace.History.Count / 32 including baseline. Current editable head revision @workspace.Head.Revision / @workspace.Head.Identifier.
++ Synthetic constraints, not manufacturer-safe limits: warm idle + @Exact(workspace.Definition.Scalar.Minimum)..@Exact(workspace.Definition.Scalar.Maximum) rpm; + torque 1..1000 N*m; 2..32 fixed rpm axis rows. Identity scaling: 1, offset 0; no binary encoding. +
++ Expected workspace @draft.Identifier; expected head revision @draft.Head.Revision / @draft.Head.Identifier. + Source @draft.Definition.Applicability.ConfigurationIdentifier. +
+ @if (draft.Identifier != workspace.Identifier || draft.Head.Identifier != workspace.Head.Identifier) + { +This draft's source/head is stale. Cancel/reload latest explicitly; saving never merges or overwrites a newer proposal.
+ } ++ Draft input pinned to @_draftUnits.UnitSystem / @_draftUnits.SpeedMode: + torque in @TorqueUnit; axis and idle in rpm. Global unit changes do not reinterpret unsaved fields. + Canonical source remains N*m/rpm; unchanged fields retain exact source doubles. +
+ + +| Axis (rpm, read-only) | Torque draft (@TorqueUnit) | Saved head source (N*m) |
|---|---|---|
| @Exact(draft.Definition.Table.Axis[cell]) rpm | ++ + + | +@Exact(draft.Head.Values.Tables[0].Cells[cell]) N*m | +
@inspection.Label; revision @inspection.Revision / @inspection.Identifier; parent @(inspection.ParentIdentifier ?? "none (baseline)"). Read-only.
+Saved source scalar: @Exact(inspection.Values.Scalars[0].Value) rpm.
+| Fixed axis | Canonical source | Display |
|---|---|---|
| @Exact(inspection.Values.Tables[0].Axis[index]) rpm | @Exact(value) N*m | @DisplayUnitConverter.Format(display, 3) @display.Unit |
Compared workspace @diff.WorkspaceIdentifier; source @diff.Source.ConfigurationIdentifier; @diff.FromIdentifier to @diff.ToIdentifier.
+ @if (diff.Entries.Count == 0) + { +No canonical changes between these explicitly selected versions. This does not restore or verify a device.
+ } + else + { +