docs(12.2-03): update state and roadmap progress after plan 12.2-03

.planning/ROADMAP.md

@@ -670,7 +670,7 @@ Plans:
   4. Deferred binding: on an unsaved parent, uploads and related-record changes bind to a session key, are committed in the parent's create transaction, and are discarded with the session. Orphaned deferred bindings and their files are purged.
   5. The new code has unit tests, delivered in the phase's last plan, and the docs checker passes.
 
-**Plans:** 2/5 plans executed
+**Plans:** 3/5 plans executed
 
 Plans:
 **Wave 1**
@@ -680,7 +680,7 @@ Plans:
 - [x] 12.2-02-PLAN.md — cabana fileupload (seven file routes, protected download) and datepicker fields, session key, commit of file bindings in the save transaction, OpenAPI
 
 **Wave 3** *(blocked on Wave 2 completion)*
-- [ ] 12.2-03-PLAN.md — cabana relation child CRUD (hasMany kind, manage/view/pivot forms, toolbar buttons), D-15 parent scoping, unsaved-parent deferral and relation commit, child file routes
+- [x] 12.2-03-PLAN.md — cabana relation child CRUD (hasMany kind, manage/view/pivot forms, toolbar buttons), D-15 parent scoping, unsaved-parent deferral and relation commit, child file routes
 
 **Wave 4** *(blocked on Wave 3 completion)*
 - [ ] 12.2-04-PLAN.md — Admin SPA: FileuploadField, DatepickerField (Reka), child and pivot modals, create-screen deferral, date/time cells, rebuilt dist

.planning/STATE.md

@@ -4,16 +4,16 @@ milestone: v1.0
 current_phase: "12.2"
 current_phase_name: "Admin form fields: date, file upload, relation editing with deferred binding (INSERTED)"
 status: executing
-stopped_at: Completed 12.2-02-PLAN.md
-last_updated: "2026-10-02T16:20:56.176Z"
+stopped_at: Completed 12.2-03-PLAN.md
+last_updated: "2026-10-02T17:09:43.302Z"
 last_activity: 2026-10-02
 last_activity_desc: Phase 12.2 execution started
-state_head: a4b3010e762114a6c98079701eae0a8eeaa7cf81
+state_head: 6cdfbd49d047d23f4112286120dd9bfd36164b8d
 progress:
   total_phases: 21
   completed_phases: 11
   total_plans: 106
-  completed_plans: 103
+  completed_plans: 104
 milestone_name: milestone
 ---
 
@@ -29,7 +29,7 @@ See: .planning/PROJECT.md (updated 2026-09-16)
 ## Current Position
 
 Phase: 12.2 (Admin form fields: date, file upload, relation editing with deferred binding (INSERTED)) — EXECUTING
-Plan: 3 of 5
+Plan: 4 of 5
 Status: Ready to execute
 Last activity: 2026-10-02 — Phase 12.2 execution started
 
@@ -158,6 +158,7 @@ Progress: [██████░░░░] 60%
 | Phase 12 P05 | 2h15m | 3 tasks | 85 files |
 | Phase 12.2 P01 | 20min | 3 tasks | 32 files |
 | Phase 12.2 P02 | 28min | 3 tasks | 29 files |
+| Phase 12.2 P03 | 45min | 3 tasks | 26 files |
 
 ## Accumulated Context
 
@@ -467,6 +468,10 @@ Recent decisions affecting current work:
 - [Phase 12.2]: 12.2-02: preview thumbnails use imageWidth x imageHeight (one given means square), else 240 x 240 in thumbOptions.mode or crop
 - [Phase 12.2]: 12.2-02: a fileupload field on a settings form fails boot; a settings datepicker gets the D-19 type check
 - [Phase 12.2]: 12.2-02: swagger2openapi folds formData into a multipart requestBody and maps {file} responses to binary
+- [Phase 12.2]: 12.2-03: relation forms compile into their own CompiledController (relationModelController) so child saves reuse the controller fill, validate, file and date pipelines
+- [Phase 12.2]: 12.2-03: at commit, a bind of a child the session created attaches directly; a bind of an existing record re-runs the full link eligibility, and an ineligible one is a 422 on the relation-manager field
+- [Phase 12.2]: 12.2-03: pivot values fill through the pivot form's writable fields only; unknown pivot keys are 422 on link and on PUT .../pivot/{child}
+- [Phase 12.2]: 12.2-03: child file routes use X-Child-Session-Key; a saved child needs update to write files (403), child 0 needs create (404 otherwise)
 
 ### Pending Todos
 
@@ -515,6 +520,6 @@ Items acknowledged and carried forward from previous milestone close:
 
 ## Session Continuity
 
-Last session: 2026-10-02T16:20:55.679Z
-Stopped at: Completed 12.2-02-PLAN.md
+Last session: 2026-10-02T17:09:42.798Z
+Stopped at: Completed 12.2-03-PLAN.md
 Resume file: None

.planning/state.json

@@ -94,5 +94,5 @@
     "label": "Advance to the next step",
     "reason": "Phase 12.2 of 21 · executing"
   },
-  "updated_at": "2026-10-02T16:20:50.566Z"
+  "updated_at": "2026-10-02T17:09:38.368Z"
 }