@rig-c/review 2.11.0 → 2.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/docs/DESIGN.md +145 -74
  2. package/docs/PANELS.md +20 -12
  3. package/docs/PARTS_VIEW.md +31 -11
  4. package/docs/REVIEW_PACKAGE.md +215 -0
  5. package/docs/STABILITY.md +98 -2
  6. package/docs/WORKFLOWS.md +40 -12
  7. package/package.json +2 -1
  8. package/skills/rig-review/SKILL.md +29 -1
  9. package/src/build.ts +10 -2
  10. package/src/cli.ts +14 -12
  11. package/src/comment-crops.ts +6 -1
  12. package/src/compare-html.ts +22 -24
  13. package/src/compare-server.ts +1 -1
  14. package/src/compare-session.ts +41 -3
  15. package/src/create-pin-gate.ts +3 -0
  16. package/src/feedback-export.ts +67 -0
  17. package/src/front.ts +10 -16
  18. package/src/interview-routes.ts +1 -1
  19. package/src/job-act.ts +39 -21
  20. package/src/job-api.ts +291 -0
  21. package/src/job-cli.ts +20 -11
  22. package/src/job-contract.ts +91 -3
  23. package/src/job-front.ts +15 -7
  24. package/src/job-host.ts +15 -0
  25. package/src/job-hub.ts +4 -4
  26. package/src/job-image-set.ts +32 -9
  27. package/src/job-session.ts +19 -11
  28. package/src/job-source.ts +74 -30
  29. package/src/joined-project.ts +61 -4
  30. package/src/open-workspace.ts +12 -12
  31. package/src/open.ts +17 -9
  32. package/src/parts-comment.ts +31 -1
  33. package/src/parts-server.ts +19 -7
  34. package/src/parts-view.ts +103 -20
  35. package/src/server.ts +30 -21
  36. package/src/session.ts +58 -0
  37. package/src/stage-comment.ts +39 -0
  38. package/src/stage-parts.ts +18 -10
  39. package/web/animation-inspection.ts +1 -1
  40. package/web/bones-panel.ts +1 -3
  41. package/web/catalog-en.ts +76 -12
  42. package/web/catalog-ko.ts +76 -12
  43. package/web/cloth-panel.ts +1 -2
  44. package/web/compare.css +3 -9
  45. package/web/compare.html +3 -3
  46. package/web/compare.ts +69 -64
  47. package/web/cuts-panel.ts +1 -3
  48. package/web/density-strip-panel.ts +1 -2
  49. package/web/i18n.ts +13 -1
  50. package/web/idle-panel.ts +1 -2
  51. package/web/index.html +1 -5
  52. package/web/inspection-persistence.ts +2 -1
  53. package/web/inspector-blocks.ts +144 -39
  54. package/web/instance-access.ts +24 -5
  55. package/web/interview-panel.ts +224 -175
  56. package/web/job-hub.ts +50 -69
  57. package/web/job-rig-capture.ts +103 -10
  58. package/web/job-rig-screen.ts +317 -0
  59. package/web/job-session.ts +927 -1365
  60. package/web/main.ts +535 -129
  61. package/web/mesh-panel.ts +1 -2
  62. package/web/owner-workspace.ts +88 -109
  63. package/web/part-selection.ts +47 -6
  64. package/web/part-thumbnails.ts +20 -6
  65. package/web/parts-viewport-provider.ts +166 -9
  66. package/web/physics-panel.ts +1 -2
  67. package/web/readings-panel.ts +1 -2
  68. package/web/requirements-panel.ts +1 -3
  69. package/web/retained-frame-stage.ts +105 -0
  70. package/web/retarget-panel.ts +2 -3
  71. package/web/rig-fields-panel.ts +1 -2
  72. package/web/rig-host.ts +62 -0
  73. package/web/rig-viewport-provider.ts +63 -16
  74. package/web/stage-comments.ts +29 -26
  75. package/web/styles.css +127 -43
  76. package/web/view-controls.ts +201 -12
  77. package/web/viewport-controller.ts +97 -26
  78. package/web/viewport-pair.ts +2 -1
  79. package/web/workspace-preferences.ts +5 -4
  80. package/web/workspace-ui.ts +152 -19
  81. package/src/interview-server.ts +0 -54
  82. package/web/interview.css +0 -28
  83. package/web/interview.html +0 -17
  84. package/web/interview.ts +0 -40
  85. package/web/job-hub.css +0 -14
  86. package/web/job-hub.html +0 -5
  87. package/web/owner-workspace.css +0 -14
  88. package/web/owner-workspace.html +0 -5
  89. package/web/parts-flags.ts +0 -48
  90. package/web/parts-page.ts +0 -217
  91. package/web/parts.css +0 -116
  92. package/web/parts.html +0 -15
  93. package/web/parts.ts +0 -986
  94. package/web/stage-nav.ts +0 -136
package/docs/DESIGN.md CHANGED
@@ -4,7 +4,105 @@
4
4
 
5
5
  The delivery unit is an existing output folder or an optional curated review package handed from an agent to a person. This reusable app owns inspection, reference comparison, annotations and feedback export. Upstream compiler, splitter and runtime remain their respective tools. The existing producing agent needs no change to open its output here.
6
6
 
7
- The person uses one inspection workspace with **Setup** and **Animate** sections and a review dialog for feedback (the compare page keeps **View**, **Rig**, **Playback** and **Feedback** sections). Setup covers setup geometry, source art, pivot/joint placement, meshes, weights and draw order; Animate covers angle coverage, frame intervals, reference video/poses, contact/deformation, audio inspection and the inspection environment (wind, gravity and impulses through the published player's `environment`/`moved`; its state is feedback context, never a model or motion edit) and the physics tuning panel (#103: constraint values edited as config patch ops and applied through the producer, never written into the model by review), and the readings block (#108: the compiler's own `rigc render` readings of the drawn animation, run on the inspected build and on the latest scratch build, shown as timeline ticks and worst-frame lines), the Environment block's *Use for readings* (#112: the controls exported as a `rigc-environment/1` schedule that readings, Apply's check and *Check under this world* — the installed producer's `rig-parts check --environment` — read, so the bars and readings are taken under the wind the person watched; the schedule is feedback context and is never authored into the rig), and the requirements block (#113: the scene's declared requirements written as a `spine-parts-requirements/1` file and measured by the installed producer's `rig-parts check --requirements`, one worst-frame line each). Time/angle controls navigate inspection. Timeline edits are six typed keyed operations on a scratch copy of `motion.animations_from`, built by the installed producer; review never writes source motion. Implemented modeling instruments send bounded changes through the installed producer into scratch, including setup-space mesh deltas.
7
+ The person uses the existing inspection workspace. The header **Setup · Animate · Compare** is the sole mode switch; the resizable bottom panel shows the current mode's blocks plus **Comments (n)**, with the act bar at the right of that row (#741). Parts packages use this same screen (#745). Header Compare retains its existing A/B comparison with a reference, enabled when a second build is supplied; its View, Rig, Playback and Feedback sections remain unchanged. Card D is **PARKED**, not planned. Setup already offers Difference as the fourth view item for parts (#745) and rig (#752). Setup covers setup geometry, source art, pivot/joint placement, meshes, weights and draw order; Animate covers angle coverage, frame intervals, reference video/poses, contact/deformation, audio inspection and the inspection environment (wind, gravity and impulses through the published player's `environment`/`moved`; its state is feedback context, never a model or motion edit) and the physics tuning panel (#103: constraint values edited as config patch ops and applied through the producer, never written into the model by review), and the readings block (#108: the compiler's own `rigc render` readings of the drawn animation, run on the inspected build and on the latest scratch build, shown as timeline ticks and worst-frame lines), the Environment block's *Use for readings* (#112: the controls exported as a `rigc-environment/1` schedule that readings, Apply's check and *Check under this world* — the installed producer's `rig-parts check --environment` — read, so the bars and readings are taken under the wind the person watched; the schedule is feedback context and is never authored into the rig), and the requirements block (#113: the scene's declared requirements written as a `spine-parts-requirements/1` file and measured by the installed producer's `rig-parts check --requirements`, one worst-frame line each). Time/angle controls navigate inspection. Timeline edits are six typed keyed operations on a scratch copy of `motion.animations_from`, built by the installed producer; review never writes source motion. Implemented modeling instruments send bounded changes through the installed producer into scratch, including setup-space mesh deltas.
8
+
9
+ ## Core UI rules (owner, 2026-11-11)
10
+
11
+ These rules govern every Review view and all job kinds, including parts, interview,
12
+ plan, checkpoint, rig, direction, image review and signoff.
13
+
14
+ These are requirements, not a claim that every legacy host has migrated.
15
+ [Screen specification](https://github.com/rig-c/review/blob/main/docs/SCREENS.md) separates shipped behavior at main `22d824f`
16
+ from remaining B (#722), C (#715), F (#734) and #756 work. This documentation
17
+ change adds no screen, behavior or public contract.
18
+
19
+ - **R0** Every Review UI addition or change requires the owner's ruling twice.
20
+ The owner rules on the layout before implementation and on the working screen
21
+ before merge. Show both through the Review tool or a local page. Chat images
22
+ cannot serve this review. HQ acceptance alone is insufficient. This covers
23
+ screens, gates, input fields, toolbars, panels and owner checkpoints, including
24
+ Create-side changes that make Review render new owner content, gates or
25
+ checkpoints. Nonvisual bug fixes are exempt.
26
+ - **R1** Every review view separates its main toolbar and secondary toolbar into
27
+ distinct areas. Group primary inspection actions in the main area and auxiliary
28
+ controls in the secondary area.
29
+ - **R2** Comments are the only feedback-input feature. A submission can contain
30
+ any number of comments. Each comment can be general or pinned to an image
31
+ point, region, part, frame or checkpoint. Keep pointed image comments through
32
+ `stage-comments.ts` and `parts-comment-crops.ts` with their source-bound evidence.
33
+ Remove separate memo, note, per-part note, summary and `words` feedback input
34
+ surfaces. Survey answers are a separate input kind. Preserve interview
35
+ selections, inline Other text and per-question note inputs through the existing
36
+ interview answer contract. R2 applies to feedback inputs.
37
+ - **R3** Inspection uses the main view's Difference switch to cover all regions.
38
+ Remove separate sidebar key-region checkpoint and evidence panels. Retain the
39
+ supported checkpoint act flow through its existing contract.
40
+ - **R3a** Any main view in rig, comparison, parts, job, interview or package review
41
+ has a resizable bottom panel directly beneath it. Use one control set in this
42
+ order: **Zoom in → Zoom out → Fit → 1:1 → View switch**, with the same names and
43
+ behavior across views. Use the shared viewport implementation and extend it
44
+ for missing behavior. Keep main-view code shared across screens.
45
+ - **R4** All view areas share zoom, Fit, 1:1 and resize behavior through the existing
46
+ viewport modules. Extend the shared modules for a missing capability.
47
+ - **R5** `web/index.html` is the single web entry for every screen, including rig,
48
+ comparison, parts, interview, package, job, hub and owner workspaces. Compose
49
+ these screens from a shared workspace shell, main view (viewport and controls),
50
+ resizable bottom and side panels, main and secondary toolbars, view switcher,
51
+ inspector and comments components. Do not introduce a screen through a new
52
+ HTML page or per-screen server route. Preserve existing public job, hub,
53
+ language and capability URLs as redirects or routes into the single entry.
54
+ The owner rules on the shared shell layout before implementation.
55
+
56
+ The main-view consistency requirement is retained verbatim.
57
+
58
+ ```text
59
+ 메인 뷰를 넣을거면 기준을 항상 규일하게 가져가(지침) * 메인뷰 하단 패널 리사이즈 * 뷰전환 기능 통일, * 에인뷰 코드가 하나가 아니라 여러개 복붙인지 확인
60
+ ```
61
+
62
+ The single-entry architecture requirement is retained verbatim.
63
+
64
+ ```text
65
+ 뷰는 index.html 단일 진입점 하나고, 컴포넌트 조합으로 화면을 만들어내(ide like) 이거 안되면 진도 빼는거 의미없어, 이미 열린 헬 게이트를 더 활짝 여는 꼴이라고
66
+ ```
67
+
68
+ Act-field and downstream-consumer changes follow the existing HQ approval boundary
69
+ for public contracts. Preserve historical record parsing, source binding and
70
+ replay, with the original recorded text intact. Keep the frozen payload definitions
71
+ in their contract references until an approved change maps the comments feature to
72
+ those fields. [Live job contract](REVIEW_PACKAGE.md#live-job-contract),
73
+ [Public API stability](STABILITY.md).
74
+
75
+ The owner's wording is retained verbatim.
76
+
77
+ ```text
78
+ 위 지적 사항은 리뷰 UI 핵심 지침이야 모든 작업에 일관성 확보될 수 있게 기획을 업데이트 하거나 지침을 갈아 앞거나 해줘
79
+ 파츠 리뷰 툴바 * 툴바 메인 툴바 보조 툴바 영역 구분
80
+ 사용자 피드백 * 메모 기능은 모두 삭제, 모든 사용자 입력은 코멘트 하나로 통일
81
+ ```
82
+
83
+ The owner's UI ruling requirement is retained verbatim.
84
+
85
+ ```text
86
+ HQ는 리뷰 UI 추가/변경은 오빠 판정 무조건 받아
87
+ ```
88
+
89
+ The owner's comments clarification is retained verbatim.
90
+
91
+ ```text
92
+ 코멘트가 왜 하나야? 미친거야?
93
+ ```
94
+
95
+ The owner's survey and comment distinction is retained verbatim.
96
+
97
+ ```text
98
+ 설문과 코멘트는 다른 종류의 입력이야 / 설문은 여기 어떻게 할까요? 이고 / 코멘트는 유저가 여기 이상하니까 꼬쳐주세요! 라는 의미
99
+ ```
100
+
101
+ The earlier shared-view requirement is also retained verbatim.
102
+
103
+ ```text
104
+ 뷰영역 공용 UX(리사이즈 등)
105
+ ```
8
106
 
9
107
  ## Implemented foundation
10
108
 
@@ -12,7 +110,7 @@ The CLI opens `review.json` or an existing output directory. The directory adapt
12
110
 
13
111
  Inspection supports local references, checkpoint context, runtime playback when a real compatible model exists, available angle/audio facilities and explicit review state. The canonical `rig-pose-sequence/1` format documented by `@rig-c/pose` preserves frame times, person IDs, joint states/coordinates/confidence and optional camera metadata. The demo pose is an authored synthetic transport example, not extracted from footage.
14
112
 
15
- Manual feedback has an inclusive integer frame interval; a clockless single stage comment explicitly records seconds with frame/interval unavailable (see REVIEW_PACKAGE). Feedback has a target `{kind: bone|slot|rig, name}`, category `defect|quality`, and one-line summary. Optional context records the checkpoint, time, reference/person and camera/axis state. The person can export data and issue-ready Markdown; this app neither posts issues automatically nor writes proposed motion keys. Notes must be useful to the producing agent without interpreting a free-form key-edit JSON blob.
113
+ Each review submission collects feedback through the comments feature under R2 and can contain any number of general or pointed comments. Source-bound inspection context records an inclusive integer frame interval, or explicit seconds when a frame/interval is unavailable, the target `{kind: bone|slot|rig, name}`, category `defect|quality`, checkpoint, time, reference/person and camera/axis state. The person can export data and issue-ready Markdown; this app neither posts issues automatically nor writes proposed motion keys. Comments must be useful to the producing agent without interpreting a free-form key-edit JSON blob. Existing serialized feedback and comment fields follow the compatibility boundary above.
16
114
 
17
115
  Identity, revision and content hash bind every decision. A submission also records separate exact rig/motion hashes and paths, packageRevision, viewerVersion and installed runtimeVersion; absent source stays null. The producing agent can retrieve the saved JSON with the read-only feedback CLI after the UI closes. Opening never means reviewed. The person explicitly approves, requests changes or returns to pending, independently of checkpoint outcomes. Changed inputs do not inherit prior approval. Feedback writes remain outside source, are bounded and atomic, and require the app's exact Origin.
18
116
 
@@ -22,11 +120,11 @@ Animate's Retarget block edits what a pose retarget is made from — the `rig-po
22
120
 
23
121
  ## Modeling touch-up direction
24
122
 
25
- The chest-region editor and Edit Mesh exist for detail that cannot be said in words. Issue #99 states the loop: **point → rebuild → watch → repeat → submit**. Review builds no mesh itself; **Apply · Rebuild runs the installed producer as a child process** on the user's own designation, into a scratch build beside the inspected one, and the viewer reloads that build in place. A feedback row captures the applied state being watched when that row is created (`context.applied`); submitting the review sends those existing rows. Apply followed directly by Submit does not automatically add the latest applied state to feedback. A unified described/made handoff remains separate work (#369 / create#91), not an automatic transfer promised by this workspace. Edit Mesh sends a typed setup-space delta through `rig-parts remesh --delta` and the shared compile/check runner, loading the scratch revision in place; producer refusals remain named.
123
+ The chest-region editor and Edit Mesh exist for detail that cannot be said in words. Issue #99 states the loop: **point → rebuild → watch → repeat → submit**. Review builds no mesh itself; **Apply · Rebuild runs the installed producer as a child process** on the user's own designation, into a scratch build beside the inspected one, and the viewer reloads that build in place. Captured applied evidence (`context.applied`) remains bound to the state that was being watched when it was collected. Submission preserves that captured state. Apply followed directly by Submit does not automatically add the latest applied state to feedback. A unified described/made handoff remains separate work (#369 / create#91), not an automatic transfer promised by this workspace. Edit Mesh sends a typed setup-space delta through `rig-parts remesh --delta` and the shared compile/check runner, loading the scratch revision in place; producer refusals remain named.
26
124
 
27
125
  Every Apply needs a binding to what the inspected rig was built from (issue #101): the **producer handoff**, declared (`open --config`, or the review.json `producer` block) or found at fixed places (`config.json`, `rig/config.json`, and last `../config.json` beside an opened `out/`, which the bar names as outside the folder). Its files are hashed into the reviewed identity beside the package, and once per session a **baseline** rebuilds the whole rig from them and says whether it reproduces the inspected one. An op that rebuilds the whole rig runs only on a reproduced baseline (`EDIT_BASELINE_MISMATCH` names the first differing path); `remesh` checks its own part (`REMESH_BASELINE_MISMATCH`). A patch that touches only what `rig-parts retune` splices — constraints, the idle's tracks and duration, the blink's numbers — runs retune instead (parts 1.44.0+, #136), which holds every other byte of the inspected rig itself, so a build whose repair is a mesh the config does not reproduce can still take a physics or idle edit — but not one whose repair redrew an image, which retune holds too, nor one whose rig.json is not the writer's text (#148; the baseline line says which); bones, stops, regions, turn and the blink's groups and still keep the whole-rig path and its guard.
28
126
 
29
- Edits reach the producer as data (issue #102): config-based edit cards state their edit as one **config patch** (`rig-review-config-patch/1`: the config hash it was made against, JSON Pointer ops, the producer and the op), and one generic runner applies it to a scratch copy of the handoff config, runs the op (`rig` for the whole rig, `remesh` for one part's entry), compiles and runs `check` on the result. Mesh deltas, retarget requests and keyed motion operations retain their own typed artifacts and runner paths; they are not flattened into config patches. A stale config patch is refused (`EDIT_PATCH_STALE`) rather than rebased. The page's client exposes `applyPatch(patch)` with #99's stream, in-place reload and Reset; the physics tuning panel (#103) is the first editing UI that produces them. For a feedback row created while that patch build is drawn, `context.applied` captures the patch, its hash, the producer's line, check's summary and the rig.json diff. Submit preserves that row's captured state rather than replacing it with the latest Apply.
127
+ Edits reach the producer as data (issue #102): config-based edit cards state their edit as one **config patch** (`rig-review-config-patch/1`: the config hash it was made against, JSON Pointer ops, the producer and the op), and one generic runner applies it to a scratch copy of the handoff config, runs the op (`rig` for the whole rig, `remesh` for one part's entry), compiles and runs `check` on the result. Mesh deltas, retarget requests and keyed motion operations retain their own typed artifacts and runner paths; they are not flattened into config patches. A stale config patch is refused (`EDIT_PATCH_STALE`) rather than rebased. The page's client exposes `applyPatch(patch)` with #99's stream, in-place reload and Reset; the physics tuning panel (#103) is the first editing UI that produces them. For evidence captured while that patch build is drawn, `context.applied` retains the patch, its hash, the producer's line, check's summary and the rig.json diff. Submit preserves the captured state rather than replacing it with the latest Apply.
30
128
 
31
129
  Physics tuning (#103) edits only what the handoff config declares: a constraint row is resolved by `name` (and kind) against the config, never by index alone, and every op records both the index (its pointer) and the name, which the server checks (`EDIT_PATCH_NAME_MISMATCH`). Rows the rig stage adds (the `turn` twins) have no config field and are shown not editable with the reason. An Apply reloads under the world it was pressed in so before and after are seen under one wind, gust and jolt state; review judges no value (a mass of 0 is rigc's `A23` to refuse). A build whose check FAILed may be loaded and looked at, but a review written on it is not submitted (`EDIT_SUBMIT_UNCHECKED`). Published Play 1.14.0 supplies the six-field live preview (#206): strength, damping, inertia, wind, gravity and mix use its public set/read/clear methods; mass and component toggles still require Apply. Slider input updates the pending override; the label distinguishes it from the last evaluated effective values. The next evaluation uses the patch; a paused page explicitly re-poses the held time without seeking. Clear removes overrides while preserving pending ops and integrated history, and authored values resume at the next evaluation; it does not undo the old trajectory. Apply and model replacement clear the preview. It is labelled "preview — Apply decides" and is never recorded as applied state. Play replays the current standing patch, not historical edits: backward seek recomputes with today's patch, and a newly opened track's first authored pose precedes its pending patch. The readout's BEFORE for the inspected build is that build's own check: once the baseline reproduces, `rig-parts check` runs on the baseline output (byte-identical to the inspected rig) in the background, and its summary is stored beside the baseline record.
32
130
 
@@ -44,7 +142,7 @@ Any future modeling edit needs provenance, undo/redo, explicit units and an expo
44
142
 
45
143
  ## Acceptance progression
46
144
 
47
- 1. Delivery and feedback: one command opens unchanged output; declared assets load; explicit frame/target/category feedback saves and exports; changed source invalidates approval.
145
+ 1. Delivery and feedback: one command opens unchanged output; declared assets load; comments with source-bound inspection context save and export; changed source invalidates approval.
48
146
  2. Runtime inspection: a real gated artifact plays and seeks through the public runtime, survives reference and Inspector section changes and names missing dependencies. Source-only fixtures cannot close this item.
49
147
  3. Modeling touch-up: a bounded real geometry edit round-trips into authoritative source, reruns its gate and presents measured before/after evidence with undo/conflict controls.
50
148
 
@@ -56,9 +154,9 @@ Any future modeling edit needs provenance, undo/redo, explicit units and an expo
56
154
 
57
155
  The single review page is one inspection workspace: a left column, the stage, the Inspector under the stage and one status footer. There is no right panel.
58
156
 
59
- - **Left column.** A fixed header row (Parts title and slot search on one line; the search's name, *Find slot*, is its `aria-label`) and one scrolling body. Nothing sits above the header and it never scrolls. The body holds, in order, the checkpoints/reference strip (current checkpoint title, checkpoints and the reference select, folded into a compact strip that opens when the package supplies checkpoints or references), the part list and browser Settings; it is the column's only scroll container. Settings opens and closes from its own header (`#settings-toggle`, `aria-expanded`, controlling `#settings-body`); it starts collapsed and the state is a browser preference.
60
- - **Header.** The **Setup** / **Animate** mode switch sits next to the package title and is the Inspector's only section control: its buttons carry `data-inspector` and `aria-pressed`, and every section change (click, `showInspector` from a part selection or a tool, a restored bookmark) goes through them. On the right, **Write review** (primary) opens the review dialog. The top bar has no feedback export buttons; `rig-review feedback --format json|issue` is the export path.
61
- - **View bar.** The persistent image / mesh edges / bone points layer toggles (keys `I`, `M`, `B`), camera sync and zoom, then the **View** menu (a `<details>` holding Side by side, Reference and Rig, labelled with the effective choice) at the right end, wrapping when the stage is narrow so every control stays in reach. The toggles stay native checkboxes, so their checked state is the pressed state, the draft input and the `layers` control value. A disabled toggle names the footer's layer reason as its tooltip. Turning images off leaves the mesh/bone overlay alone. Appearance lives only in Settings (its Theme select shows the inspection's current appearance and drives it), the per-inspection Repeat idle toggle lives in the Animate transport row, and there is no Copy view link button: the persisted `#review=` fragment stays in the address bar and the numeric region stays behind **View region**.
157
+ - **Left column.** A fixed header row (Parts title and slot search on one line; the search's name, *Find slot*, is its `aria-label`) and one scrolling body. Nothing sits above the header and it never scrolls. The body holds the reference select, the part list and browser Settings; it is the column's only scroll container. Region coverage and Difference inspection stay in the main view under R3. Settings opens and closes from its own header (`#settings-toggle`, `aria-expanded`, controlling `#settings-body`); it starts collapsed and the state is a browser preference.
158
+ - **Header.** **Setup · Animate · Compare** sits next to the package title and is the only mode switch (#741). Setup and Animate keep their existing `rig` / `playback` mode IDs. Compare is enabled with a second build and retains A/B with a reference; card D is parked. There is no second mode selector in the bottom panel. The pending ask is shown beside the act bar. **Historical:** numbered step chips and `stage-nav.ts` were removed; they must not be restored.
159
+ - **View bars.** The main row holds Comment, camera sync and the shared controls in order: **Zoom in → Zoom out → Fit → 1:1 → View switch**, then zoom value. The separate secondary row holds layers and subject tools. `inspectionViewSwitch` in `view-controls.ts` defines **Side by side · Reference · Rig**, followed by **Difference** in Setup (#745 parts, #752 rig). Difference is disabled by name without a usable original reference; parts also require the declared rig-space painting operand, and rigs require a painting aligned to the native rig canvas. Outside Setup, rig Difference names `RIG_DIFFERENCE_SETUP_ONLY`. Compare retains its existing Side by side / Reference / Build A / Build B menu and legacy controls. Parts Overlay and Part opacity live in the secondary toolbar, not a grouped view menu. Appearance stays in Settings; numeric view state stays behind **View region**.
62
160
  - **Panel headers and scrolling.** The left column's header is a fixed row outside its scrolling body. The Inspector heading, the Settings title and each drawer's header (title and close) carry `.sticky-header` and are their panel's first child, so the body scrolls beneath them. Every scrolling region shares one thin scrollbar rule on `*` whose colours are the `--rv-scrollbar-*` tokens. Resize separators are drawn 4px with a 16px transparent hit area (22px on coarse pointers) and use `--rv-separator` / `--rv-separator-hover`, never a scrollbar colour.
63
161
  - **Chest-region editor.** In Setup only, the view bar's **Chest regions** toggle (`#chest-edit`, `aria-pressed`) opens `#chest-editor-bar` under the view bar: R / L groups (X, Y, R, Band), Mirror R → L, Download JSON, **Apply · Rebuild** and **Reset**. Apply sends the rows to the installed producer (`rig-parts remesh` on that part, then `rigc build`) through `POST /api/rebuild` (`src/rebuild.ts`, `src/producer.ts`) and loads the compiled scratch build in place; the producer's lines stream into `#chest-editor-status` and `#chest-editor-log`, a refusal shows its first named line verbatim, and Reset returns to the inspected build (README, *Chest regions*). The circles, their centre / core / band handles and labels are drawn on `#rig-overlay` through the crop → world mapping; handle drags (move, r, band) are clamped live with the example rebuild script's non-overlap rule (`CHEST_REGIONS_CLAMPED`) and never move the camera, while other drags and Space-drags pan. The values are the Setup **Chest regions · detail** block's fields, so its draft, export and binding apply unchanged; the block keeps names, bones, semi-axes, clip and the contour. Review builds no mesh: the rebuild is the producer's, into scratch under the state directory, never into the package. A **Circles** / **Landmarks** switch (`#bust-mode`, a hidden input the draft keeps) selects what Apply sends: Landmarks (#105) places the right apex, left apex and cleavage with draggable markers (`#lm-*`), alpha and clearance sliders and optional bone names, draws the producer's derived `bust_r` / `bust_l` live (`src/chest-landmarks.ts`, a transcription of parts' `deriveBustRegions`) and sends `{part, bust, configHash}`; review pre-checks only `CONFIG_BUST_CLEARANCE` and leaves bones and names to the producer.
64
162
  - **Mesh panel.** In Setup, after Chest regions · detail: `#mesh-panel` for the selected mesh part — mode-specific sliders with number fields (`#mesh-params`), regions (`#mesh-regions`; **Add circle**, **Draw polygon** and **Drag on stage** with `aria-pressed`), segments (`#mesh-segments`, bones from the loaded model, ribs stations per chain), the pending diff (`#mesh-diff`), the pre-check (`#mesh-precheck`), **Apply** / **Reset** / **Folds reading**, the status (`#mesh-status`), the counts (`#mesh-counts`) and the `TEXTURE_STRETCH` readout (`#mesh-readout`). Region colours are theme tokens (`--rv-mesh-region`, `--rv-mesh-region-fill`, `--rv-mesh-handle`).
@@ -67,8 +165,8 @@ The single review page is one inspection workspace: a left column, the stage, th
67
165
  - **Rig fields.** In Setup, after Bones: `#rig-fields` (#110). The producer config's small fields as patch ops at their own pointers (`src/rig-fields.ts`, `web/rig-fields-panel.ts`): a rigid part's bone (`/regions/<part>`, a select), a lash's blink still row (`/motion/blink/still/<part>`, a dashed line across the part dragged in whole rig px), a stop's inward / outward bounds (`/stops/<i>`, two filled arcs at the pivot around a dashed rest aim, their ends dragged in whole degrees), an inherit mode per bone (`/bones/<i>/inherit`, a chain's `link_inherit`) and `turn`'s pivot and per-part depth (`/turn/pivot`, `/turn/depths/<part>`, sliders). Stage handles live in `#rig-fields-stage` over the rig viewport (tokens `--rv-field-still`, `-inward`, `-inward-line`, `-outward`, `-outward-line`, `-rest`, `-handle-bg`, `-ink`; the stage stays dark, so both blocks carry the same values). The turn dial holds the drawn build's `turn` bone at x through play's `adjust`, composed with the idle preview, and shows `#rig-fields-dial-label` (*preview — Apply decides*); it is never recorded. Apply is the generic runner's whole-rig `rig` op behind the reproduced baseline; the readout quotes `BLINK_NO_HOLE` and `FEET_STAY_LEVEL` before and after, and **Angle range** runs one #108 reading. Adding a stop and `turn.deform` are out of scope.
68
166
  - **Cloth.** In Setup, after Cuts: `#cloth-panel` (#111). One form per cloth tag the installed reader accepts (`bottomwear`, `back hair`, `front hair` — its own `CLOTH_TARGETS`), holding the recipe's fields as the config states them; each change is a patch op at `/cloth/<tag>/…` (`src/cloth-recipe.ts`, `web/cloth-panel.ts`). **Show links** draws, in rig px of the setup pose, every chain the tag's parts are meshed on from the config's `points` and `tip`, and after an Apply the chains of the config the producer wrote (one label per set). Apply runs `rig-parts propose --cloth --write-config` on the declared parts, painting and keypoints, then builds the written config (`build` when the config declares `limbs`, else `rig --config`) and reloads it under the stage's Environment. Review never merges the producer's draft: it reads only the written config, lists where it differs from its input and refuses one that differs outside the drafted sections. Hand-editing the drafted constraints is the physics block's, after the draft.
69
167
  - **Mesh edit.** In Setup only, the view bar's **Edit mesh** toggle (`#mesh-edit`, `aria-pressed`) opens `#mesh-editor-bar`: sub-modes Modify / Create / Delete / Edges (keys `V` / `C` / `X` / `E`, one pressed), Undo, Redo, Reset, Download JSON and **Apply · Rebuild** (#135: `rig-parts remesh --delta` through the shared runner, the revision loaded in place, the producer's refusal verbatim; while a delta revision is on the stage Reset returns to the inspected build). A package without the compiled model document refuses `MESH_EDIT_MODEL_UNAVAILABLE` and does not open; whole rig refuses `MESH_EDIT_SELECT_SLOT`; a non-mesh or linked-mesh slot `MESH_EDIT_NO_MESH <slot>`. It edits in setup space (#100): the attachment's stored provenance in the model document (`src/setup-mesh.ts`) and geometry from Play's public `readSetupMesh` (`web/setup-pose.ts`, shared with Weights) and drawn over the paused stage with the stage camera. It records a typed delta (`src/mesh-edit.ts`, `basis: "setup"`, the shape `rig-parts remesh --delta` reads) and previews it over the original triangulation on the overlay; Delete removes only constraint edges the delta added (the triangulation is the producer's); it is not a mesher and never retriangulates, writes the package or runs a producer. The chest editor and mesh edit are exclusive: turning one on turns the other off.
70
- - **Inspector.** Two sections and no section tab row: **Setup** is the mesh-review composition (selected part, part presets, the modeling-review proposals for mesh density, contour curvature and chest position) and holds no control that seeks or plays; **Animate** has the transport with the Repeat idle toggle, frame navigation, the motion-review proposals and angle inspection with its axis panel, sound cues and report events. Their element ids and saved section names (`rig`, `playback`) are unchanged. Each section opens with a sticky block row (`.block-row`, `web/inspector-blocks.ts`), a WAI-ARIA tablist: Setup — Part · Modeling · Chest · Mesh · Weights · Bones · Fields · Cuts · Cloth; Animate — Transport (the motion tools and the angle panel) · Sound · Environment · Physics · Idle tracks · Readings · Requirements · Retarget · Report, in document order. Animate's timeline is its own panel beside the blocks, not a tab. Each `role=tab` button controls the `role=tabpanel` block it names: selecting it shows that block alone and hides the others (`hidden`; a block a tab carries, such as the angle panel, by `data-block-hidden`, so its own `hidden` stays its own), and nothing scrolls between blocks. Arrow keys, Home and End move between tabs and select as they go. Hiding writes nothing inside a block, so drafts, pending edits and stage overlays such as the chest editor's are kept while their tab is hidden, and each block keeps its own scroll offset for the session. The row is one line that scrolls sideways when narrow. The active tab per section is the only thing the row adds to the inspection draft (`ui.inspectorBlocks`); the section's scroll offset stays with the Inspector scroll memory, and the control protocol and saved-view link are unchanged. A saved `view` or `feedback` section from older links and drafts restores without selecting a section or opening the dialog.
71
- - **Review dialog.** A native modal `<dialog id="review-dialog">` holds the former Feedback section unchanged (review status, reviewed source with the read-only source-file list, selected checkpoint, structured feedback, frame-strip export; every element id kept) and the **Submit review** button (`#save`). **Write review**, a part's or a proposal tool's Add feedback opens it with `showModal()` and pauses playback; Escape or Close dismisses it and focus returns to **Write review**. Its inputs stay in the document while it is closed, so the draft mechanism (autosave, recovery, conflict handling) is unchanged and closing loses nothing. The modal makes the rest of the page inert, so the dialog repeats the footer's message and draft state in its own status line; the footer keeps reporting both.
168
+ - **Inspector.** The shared bottom panel sits directly under the main view, with saved height and a resizable separator. Header mode selects its content; its tab row remains reachable when content is collapsed. Setup has Part · Modeling · Chest · Mesh · Weights · Bones · Fields · Cuts · Cloth; Animate has Transport · Sound · Environment · Physics · Idle tracks · Readings · Requirements · Retarget · Report and the existing timeline. Each mode appends the same **Comments (n)** tab, and the act bar stays at the right of that row (#741). Parts use Part and Comments; rig-only blocks are disabled with a missing-rig reason. `mountRigInspector`, `bindInspectorBlocks` and `mountBottomPanel` reuse the existing blocks, preserve their state and keep one Comments button/panel across modes. Block navigation does not apply or submit.
169
+ - **Review dialog.** This label is historical for rig feedback: `mountRigInspector` moves its existing source context, comments, frame range, category, typed target, correction request, provenance, strip downloads and warnings into **Comments (n)** and removes `#review-dialog`. The decision, submit and save state live in the act bar. Record publications separately reuse existing checkpoint, signoff, reopen and interview forms in a native dialog over this same screen (#754), including an explicitly empty workspace when no picture is supplied. That hosting has shipped; remaining interview-modal work B (#722), record-modal memo-to-Comments work C (#715), and legacy job-window owner-surface removal (#756) have not.
72
170
  - **Footer.** Message (truncated, full text as tooltip) on the left; player, effective layout, renderer, layers, idle, remote control and draft state in the middle; the numeric view region (behind **View region**) and the source hash on the right. The View region body is a `position:fixed` popover above the 40px footer, right-aligned, its width and height clamped to the viewport and its content scrolling inside, so the footer's clipping never hides it and opening it never scrolls the page.
73
171
 
74
172
  The compare page keeps its own markup and stylesheet: sources left, Parts explorer right, its four Inspector sections, its export buttons and its separator colour. It shares the workspace coordinator, so its separators are drawn at the same 4px.
@@ -149,82 +247,55 @@ Single review keeps the requested layout in the source-bound draft and shows it
149
247
 
150
248
  ## Four inspection stages
151
249
 
152
- The same numbered navigation appears on parts, compiled and compare inspections:
153
- 1 Parts + mesh, 2 Interview, 3 Rig + animation, 4 Direction. These are navigation,
154
- not create pipeline stages or sign-offs. Opening or switching never submits a
155
- verdict, applies an edit or starts a producer job. Interview and Direction name
156
- their missing consumer contracts; no tools are fabricated for them.
250
+ **Historical, superseded by #741:** the numbered Parts + mesh, Interview,
251
+ Rig + animation and Direction navigation was removed. This heading remains for
252
+ inbound links. Pipeline stages are internal and never another user mode switch.
253
+ The header selects Setup, Animate or the existing Compare; a pending ask is text
254
+ beside the act bar. Selecting a mode never applies, approves or submits.
157
255
 
158
256
  ### Standing live job boundary
159
257
 
160
- `src/job-contract.ts` freezes the semantic live-job boundary (`JOB_API_SCHEMA` set to `rig-review/job-api@2`, `JOB_ACT_SCHEMA` set to `rig-review/act@2`, [Review #484](https://github.com/rig-c/review/issues/484)), backed by the implemented backend session/store (`src/job-session.ts`, `src/job-source.ts`, `src/job-act.ts`, `src/job-api.ts`), standing loopback job front and browser window runtime (`src/job-front.ts`, `web/job-session.ts`), and `rig-review session open|publish|ask|next|close` CLI (`src/entry.ts`, `src/job-cli.ts`). The public installed managed-host entry is `@rig-c/review/job-host` with frozen exports in [Public API stability](STABILITY.md#managed-owner-host), and Create's production publication reader and writer-owned sibling `fetch-act` readback remain pending [Create #184](https://github.com/rig-c/create/issues/184). See [Live job contract](REVIEW_PACKAGE.md#live-job-contract) and [Standing live job workflow](WORKFLOWS.md#standing-live-job-workflow).
161
-
162
- - **One standing window and owner visual gate.** Every owner visual, question, choice, correction and verdict goes through one standing Review window/link plus one what-to-look-at line. Internal agent and HQ media remain internal. A missing required visual (`visual.status` set to `'unavailable'`) is an immediate stop plus a Create-filed on-path Review card, never a chat fallback.
163
- - **Human UI authority vs agent verbs.** People submit finalized acts through the browser UI (`actor` set to `'human'`, `channel` set to `'review-ui'`) under a bootstrap-declared `reviewer` (`id` and `role` as `'owner'` or `'delegate'`). That reviewer binding is declared by trusted host bootstrap, cannot be typed or overridden in the browser UI, represents provenance rather than keyboard-user authentication, and maps to Create's existing `by` authority. Agents use `publish`, `ask`, `next` and `close` with `expectedGeneration` CAS and `idempotencyKey`. `publish` requires an explicit producer-held freeze (`freeze.kind` set to `'producer-held'`, `holdId`, `record`) held until acknowledgment as a caller obligation, with no watched-root or automatic-close guarantee. Only explicit `close` ends an active job.
164
- - **Exact displayed source, cursor replay and draft retention.** Finalized acts and job events replay through durable cursors (`next` and `subscribeJob`). The daemon derives `JobSourceBinding` from validated retained bytes and the page-scoped `displayedNonce` receipt rather than browser-supplied hashes. When a new publication updates the displayed source, old local drafts remain retained for their original source binding and are flagged without rebinding onto the new publication.
165
- - **Enabled vs reserved act kinds.** Five act kinds are enabled (`interview-picks`, `checkpoint`, `parts-verdict`, `review-verdict`, `signoff`) while `described-correction` (awaiting the joint [Create #182](https://github.com/rig-c/create/issues/182) context allowlist) and `mesh-edit` (awaiting the joint [Parts #1159](https://github.com/rig-c/parts/issues/1159) freeze) stay reserved and disabled (`JOB_ACT_KIND_DISABLED`). Checkpoint acts carry `pass` or `fail` only (`pending` is UI draft only) and require `words` as a string preserved verbatim including empty or whitespace-only text, with `planStepId` copied by the daemon from the validated ask and stage derived by Create. Signoff acts carry `approved` only with required verbatim `words` (empty or whitespace-only allowed) and remain separate from verdicts and Create stage transitions. Plan-bound signoffs (`plan-approved`, `rigging-interview`, `post-interview`) and checkpoints use step IDs and hashes published by [Create #184](https://github.com/rig-c/create/issues/184) without Review recomputing `stepHash`. C4 binds the exact public `partsFileReferences(dir)` array from `@rig-c/parts/src/parts.ts`, whose contract is frozen at Parts 2.25.0. The trusted host resolves an installed version in `JOB_PARTS_ENUMERATOR_RANGE` (`>=2.25.0 <3.0.0`), supplies its actual version and official callback through `partsEnumerator`, and declares `partsEnumeratorId`. `JobPartsIdentity.enumeratorVersion` carries that actual version. Manifest paths are work-root-relative and image paths are relative to the manifest directory. Each image carries `path`, bounded-string `role` and raw-byte `sha256`. Review compares the claimed array positionally with the official array, preserving its role/order/duplicate semantics. Upstream roles include `part`, `alternate`, `depth`, `painting` and `figure_mask`. Review bounds shape and paths, refuses traversal/symlinks, decodes PNGs and hashes retained bytes. Missing references refuse with row, role and path, including a missing sibling figure mask when a render copy exists. Unreferenced extras stay outside this parts identity. Composite source hashes use `rig-review-job-source/2`. Create #184 production reader/projection and official-hook wiring remain pending.
166
- - **Writer-owned sibling fetch, public host seam and legacy file handoffs.** [Create #182](https://github.com/rig-c/create/issues/182) and [Create #184](https://github.com/rig-c/create/issues/184) own direct writer publication and `fetch-act` reads via a private writer-owned sibling binding outside `project.json` (`writer-owned-sibling-fetch-capability`, pending Create #184 production reader/writer integration), never tracked in version control or unstaged project output, never constructed or carried by agents, dead at explicit `close`, and renewed on each job incarnation. In the public managed-host startup seam (`startJobHost` from `@rig-c/review/job-host`, frozen in [Public API stability](STABILITY.md#managed-owner-host)), hook-bearing host callers declare `readerId`, `bindingId` and `partsEnumeratorId`; equality plus API/act schemas and actual enumerator version govern authenticated active-listener reuse and missing or mismatched IDs refuse by name (`JOB_HOST_OPTION_ID_INVALID`, `JOB_HOST_REUSE_MISMATCH`) with no function hashes. Future mesh acts will be fetched by Create and passed in process to Parts' public exported API owned by [Parts #1159](https://github.com/rig-c/parts/issues/1159) without Parts reading Review or Create storage, while standalone `--delta` remains legacy outside the active cycle. Agents never build, parse, reshape or carry Review session, picks, verdict or applied-record storage files, and existing `--picks-file`, saved verdict path, reshaped feedback JSON and `--verbatim-file` handoffs are legacy/history bypass findings for the active cycle.
167
- - **Direction scope.** Direction carriage in `#484` is metadata-only and distinct from [Review #482](https://github.com/rig-c/review/issues/482) preview and [Review #483](https://github.com/rig-c/review/issues/483) actual plated take playback, while [Review #373](https://github.com/rig-c/review/issues/373) remains parked.
168
-
169
- Stage 1 in a single compiled inspection with a producer handoff shows the
170
- handoff's **separated parts and draft meshes**, labelled **Draft rig · structure
171
- evidence only**. It proves each part's original raster crop against the rig image
172
- and binds its exact skin/slot/attachment, dimensions, UVs and triangle indices to
173
- the compiled mesh. UV values compare as exact float32 values, including the
174
- compiler's shortest round-trip decimal representation; no numeric tolerance is
175
- used. A name alone is insufficient. This is structure inspection, never final
176
- rigging approval or evidence of unmeasured compiler gates.
177
-
178
- Choose **Chest regions**, **Mesh parameters** or **Edit Mesh** on the selected
179
- part to open the existing Setup precision instrument. The part and exact
180
- `rig-parts remesh --mesh` or `rig-parts remesh --delta` operation remain visible.
181
- Apply/Rebuild and Reset are the existing producer-backed actions. Return with
182
- **1 Parts + mesh** to inspect the revision actually drawn by the parent, including
183
- a checked scratch revision. Each entry reloads against that explicit build ID;
184
- a pending candidate or the server's unrelated latest build is never substituted.
185
- Reset returns to the inspected revision. New scratch reads and made-mesh feedback
186
- submissions recheck pinned producer inputs, revision files and compiled files.
187
- A changed scratch input cannot inherit clean checked evidence.
188
-
189
- The embedding is read-only: original verdicts and comments are never copied onto
190
- scratch geometry or saved by navigating. Use the standalone `parts` command for
191
- its separate explicit original-parts sign-off. Parts-only inputs remain
192
- inspectable and name `STAGE_DRAFT_UNAVAILABLE` for direct correction. A missing
193
- handoff keeps the inspected atlas available where supplied. Compare retains its
194
- read-only, side-specific inspected atlas. Neither flow guesses a sibling draft.
195
-
196
- Named draft boundaries are `STAGE_DRAFT_UNAVAILABLE`, `STAGE_DRAFT_MISMATCH`,
197
- `STAGE_DRAFT_STALE`, `STAGE_DRAFT_CHANGED`, `STAGE_DRAFT_UNCHECKED` and
198
- `STAGE_DRAFT_OPERATION`. Producer discovery and its named missing/old-producer
199
- refusals are unchanged; Review never installs a producer. Correction-record
200
- export remains unavailable pending review#369 and create#91. Existing reviewer
201
- requests remain verbatim in their existing feedback/comment contracts; there
202
- is no fake Apply for art repair.
203
-
204
- Only Stage 3 shows the legacy Setup, Animate and Compare switch; its existing
205
- instruments, DOM and mode IDs are retained. In Stage 1 a compare session keeps
206
- the A/B source picker usable and shows the selected side's cached atlas frame.
207
- **Open setup mesh instruments** returns from the atlas to Setup; it does not
208
- rebuild. Existing bookmarks, Apply/Reset provenance, selected slot, compare side,
209
- time, pending edits and applied build stay owned by those original tools. Stage
210
- changes retain the original workspace and each compare side's atlas controller.
211
- Single draft frames are rebound on revision changes. Language changes update retained
212
- frames without applying or submitting.
213
- The parts-only entry retains its part selection, geometry and pending verdict
214
- while visiting unavailable stages; it needs no compiled model.
215
-
258
+ The standing Review window hosts published subjects on the existing inspection
259
+ screen. Rig and parts use its shared viewport and bottom panel. Record
260
+ checkpoint, signoff, reopen and interview asks use existing forms in a dialog
261
+ (#754). A record without a picture keeps that absence explicit; it does not
262
+ manufacture a model or package. Remaining B (#722), C (#715), F (#734) and #756
263
+ work is tracked in [the screen specification](https://github.com/rig-c/review/blob/main/docs/SCREENS.md#4-migration-order).
264
+
265
+ People submit decisions through Review's UI; agents use semantic `publish`,
266
+ `ask`, `next` and `close`, and consumer writers fetch finalized acts directly.
267
+ Opening or navigating never approves. Preserve reviewer authority, exact
268
+ source binding, publication freeze, generation checks, replay and recorded text.
269
+ A UI requirement does not authorize changing those public contracts or carrying
270
+ internal Review state as an agent handoff.
271
+
272
+ The [live job contract](REVIEW_PACKAGE.md#live-job-contract), including
273
+ [record mode](REVIEW_PACKAGE.md#model-free-record-mode-and-source-seam), and
274
+ [public API stability](STABILITY.md) own the schemas, fields and compatibility
275
+ rules. [Standing live job workflow](WORKFLOWS.md#standing-live-job-workflow)
276
+ owns the agent cycle. Historical stage-draft formats and named refusals remain
277
+ in [Stage-1 draft mesh inspection](REVIEW_PACKAGE.md#stage-1-draft-mesh-inspection);
278
+ they do not restore removed navigation or a second parts screen. Supplied inputs
279
+ and compiled models remain immutable, and precision edits still reach the
280
+ installed producer as data for a scratch rebuild.
216
281
 
217
282
  ## Shared parts viewport and comments
218
283
 
219
- Standalone pre-rig parts and the compiled Stage 1 atlas frame mount `viewport-pair.ts`'s actual
220
- rig/reference DOM. `parts-viewport-provider.ts` supplies raster geometry and painting-crop pixels;
284
+ Parts-only packages open the existing Setup screen, using `viewport-pair.ts`'s
285
+ actual rig/reference DOM (#745). They reuse `PartExplorer`, the toolbars,
286
+ resizable bottom panel, Comments and act bar rather than a standalone parts page. `parts-viewport-provider.ts` supplies raster geometry and painting-crop pixels;
221
287
  `viewport-controller.ts` and `view-controls.ts` own camera writes, cursor zoom, pan, fit, resize
222
288
  and the common two-pointer pinch. Parts' native scale policy is separate from the unchanged
223
289
  compiled-rig Fit-relative policy. `parts-render.ts` remains the source of part, footprint and
224
290
  mesh painting. The optional protected `--painting` input supplies the real reference crop;
225
- A/B and adjustable-opacity Overlay share the original painting
291
+ Side by side and adjustable-opacity Overlay share the original painting
226
292
  transform from declared rig/source canvas geometry, with exact fractional placement. This is a visual
227
293
  comparison using browser interpolation, not native pixel parity with the producer's resampled raster.
294
+ The Reference crop follows the selected part (#749). Parts verdicts are
295
+ comments-based (#751): no issues approves; issues request changes.
296
+ **Historical:** the old parts page, producer flags and mesh-numbers panel were
297
+ deleted (#745). Mesh edges provides visual mesh inspection; agent readers retain
298
+ the numbers. The rig Mesh precision instrument remains separate.
228
299
  Difference uses the producer-declared rig-space painting artifact; see [Declared-grid Difference](PARTS_VIEW.md#declared-grid-difference).
229
300
  `tests/parts-comparison.test.ts` guards the geometry/settings; `tests/parts-overlay-browser.ts` verifies
230
301
  displayed overlay pixels and comment restoration in both languages.
package/docs/PANELS.md CHANGED
@@ -449,11 +449,23 @@ A reference-basis comment cannot become a producer-frame strip: CLI and browser
449
449
 
450
450
  ## Four inspection stages
451
451
 
452
- The same numbered navigation appears on parts, compiled and compare inspections:
452
+ The same numbered navigation appears on compiled and compare inspections:
453
453
  1 Parts + mesh, 2 Interview, 3 Rig + animation, 4 Direction. These are navigation,
454
454
  not create pipeline stages or sign-offs. Opening or switching never submits a
455
- verdict, applies an edit or starts a producer job. Interview and Direction name
456
- their missing consumer contracts; no tools are fabricated for them.
455
+ verdict, applies an edit or starts a producer job. Each chip opens a mode of the
456
+ one screen or names itself unavailable; no chip loads a separate page (#726):
457
+
458
+ | Chip | Opens |
459
+ | --- | --- |
460
+ | 1 Parts + mesh | the Setup mode |
461
+ | 2 Interview | the interview over the screen; until that view lands it names `INTERVIEW_MODAL_UNAVAILABLE` |
462
+ | 3 Rig + animation | the Animate mode |
463
+ | 4 Direction | nothing: it names `DIRECTION_NOT_AVAILABLE` |
464
+
465
+ Without a rig on the stage, chips 1 and 3 and the Setup, Animate and Compare
466
+ switch name `MODEL_UNAVAILABLE` or `RIG_VERSION_UNAVAILABLE`. The standalone
467
+ `parts` page shows only its own chip. The former Stage 1 atlas frame is deleted;
468
+ the Stage 1 paragraphs below describe the `/api/stage-parts` data that Setup reads.
457
469
 
458
470
  Stage 1 in a single compiled inspection with a producer handoff shows the
459
471
  handoff's **separated parts and draft meshes**, labelled **Draft rig · structure
@@ -490,14 +502,10 @@ export remains unavailable pending review#369 and create#91. Existing reviewer
490
502
  requests remain verbatim in their existing feedback/comment contracts; there
491
503
  is no fake Apply for art repair.
492
504
 
493
- Only Stage 3 shows the legacy Setup, Animate and Compare switch; its existing
494
- instruments, DOM and mode IDs are retained. In Stage 1 a compare session keeps
495
- the A/B source picker usable and shows the selected side's cached atlas frame.
496
- **Open setup mesh instruments** returns from the atlas to Setup; it does not
497
- rebuild. Existing bookmarks, Apply/Reset provenance, selected slot, compare side,
498
- time, pending edits and applied build stay owned by those original tools. Stage
499
- changes retain the original workspace and each compare side's atlas controller.
500
- Single draft frames are rebound on revision changes. Language changes update retained
501
- frames without applying or submitting.
505
+ Chips 1 and 3 select the existing Setup and Animate modes, so the Setup,
506
+ Animate and Compare switch, its instruments, DOM and mode IDs are retained.
507
+ Existing bookmarks, Apply/Reset provenance, selected slot, compare side, time,
508
+ pending edits and applied build stay owned by those original tools. Choosing a
509
+ chip never applies or submits.
502
510
  The parts-only entry retains its part selection, geometry and pending verdict
503
511
  while visiting unavailable stages; it needs no compiled model.
@@ -1,27 +1,39 @@
1
1
  # Parts and atlas view
2
2
 
3
+ > **Historical UI reference:** the standalone parts page and its sidebar,
4
+ > flags and mesh-numbers panel were removed in #745. UI instructions for those
5
+ > surfaces below are superseded by the existing Setup workspace, Comments and
6
+ > act bar; see the [current screen specification](https://github.com/rig-c/review/blob/main/docs/SCREENS.md).
7
+ > Retained input formats, API details, historical verdicts and heading targets
8
+ > remain compatibility references, not instructions to restore that UI.
9
+
3
10
  `rig-review parts` shows a rig's parts as images, before any rig is built, so a part with missing material, a faint
4
- island or a ragged rim is caught before rigging rather than in motion after it. The same view reads a built rig's atlas
5
- to check what ships.
11
+ island or a ragged rim is caught before rigging rather than in motion after it. Atlas-only inputs refuse
12
+ `PARTS_ATLAS_NOT_CARRIED` before the parts workspace opens. Use rig review for read-only atlas inspection;
13
+ `parts --format json|issue` still reads saved atlas verdicts.
6
14
 
7
15
  ```sh
8
16
  npx rig-review parts <out> # a rig-parts build root: opens <out>/rig/parts.json
9
17
  npx rig-review parts <out>/rig # the same package, named directly
10
- npx rig-review parts <out>/check # a built rig's atlas (any review package with a compiled model)
18
+ npx rig-review open <out>/check # inspect a built rig, including its read-only atlas
19
+ npx rig-review parts <out>/check --format json # read a saved atlas verdict without opening a workspace
11
20
  ```
12
21
 
13
- Options: `--rig <file>` (mesh geometry), `--mesh-report <file>`, `--check <file>` (producer flags; see below), `--verdict <file>` (where the sign-off
22
+ Options: `--rig <file>` (mesh geometry), `--mesh-report <file>`, `--check <file>` (historical producer flags; former UI removed in #745; see below), `--verdict <file>` (where the sign-off
14
23
  is written), `--painting <png>` (the original painting), `--by <name>` (launch-only reviewer declaration), `--format json|issue` (export the saved verdict), `--port <n>`. Like `review`, it serves in the foreground and exits 3 s after its last tab closes.
15
24
 
16
25
  ## Inputs
17
26
 
18
- | Mode | Opens on | Items |
27
+ | Mode | Input and availability | Items |
19
28
  | --- | --- | --- |
20
29
  | parts | a directory holding `parts.json` beside `parts/<name>.png`, as `rig-parts assemble` writes it, or a build root whose `rig/` holds them | every part, in `parts.json` order (draw order, back first) |
21
- | atlas | a review package or build `check/` folder whose compiled model declares `pages[].regions[]` | every region, by page |
30
+ | atlas | a review package or build `check/` folder whose compiled model declares `pages[].regions[]`; read-only within rig review or saved-verdict export, refused at parts workspace open | every region, by page |
22
31
 
23
32
  ## What it shows
24
33
 
34
+ **Historical UI:** the following describes the former standalone parts page.
35
+ Use the current shared Setup workspace; these controls are not a second screen.
36
+
25
37
  - **Every part on its own**, on a checker background by default (green, magenta, black and white are also available), at native scale with
26
38
  Fit and exact **1:1**, cursor-anchored wheel zoom, pinch and drag pan in the shared rig/reference viewport pair. Sampling stays nearest-neighbour. **Alpha only** shows the alpha channel as grey (white is opaque).
27
39
  - **Footprints of parts in front** (parts mode): the alpha of every part later in `parts.json` whose box meets the
@@ -30,12 +42,15 @@ is written), `--painting <png>` (the original painting), `--by <name>` (launch-o
30
42
  occluder's shape at a glance. Nothing is measured; the tint is the front parts' own alpha.
31
43
  - **Atlas mode**: the pages as packed, with each region's box and name; the background shows through padding, and a
32
44
  region's own view keeps 4 page pixels around its box (dashed) so bleed is visible. Clicking a region opens it.
33
- - **Producer flags**, read from the files rig-parts writes and shown on the part they name. None is re-measured here. Each reads as one labelled line (an opening's parts, animation, frame and cells; a seam pair's pixel counts; a gate's name, status and readings), with the producer's object verbatim under a collapsed **Producer line**.
45
+ - **Historical UI — Producer flags (removed in #745)**, read from the files rig-parts writes and shown on the part they name. None is re-measured here. Each reads as one labelled line (an opening's parts, animation, frame and cells; a seam pair's pixel counts; a gate's name, status and readings), with the producer's object verbatim under a collapsed **Producer line**.
34
46
 
35
47
  The [23-part EN/KO comparison](https://github.com/rig-c/review/tree/main/tests/fixtures/parts-approve-all-evidence) records the same 1600×1100 initial view against installed 1.8.0: row height 49.375 → 26.1875 px, with all 23 after rows on one line (`tests/parts-approve-all-browser.ts`).
36
48
 
37
49
  ### Producer row groups
38
50
 
51
+ **Historical UI:** sidebar groups and badges below were removed in #745.
52
+ The producer row metadata and legacy API/verdict references are preserved.
53
+
39
54
  The sidebar counts **only mesh-report flags and explicit part findings**. A check row counts only
40
55
  when `row_scope: "part"`, `row_kind: "finding"` and a valid `row_subjects` array names that part.
41
56
  A block status, a JSON path, a reason or a legacy part/slot/bone field never determines classification.
@@ -97,7 +112,7 @@ The occlusion-coverage report (rig-c/parts#998) is not read yet; the footprint t
97
112
  Standalone sign-off uses saved files. The active Create and Parts cycle uses finalized acts through the
98
113
  [standing live job workflow](WORKFLOWS.md#standing-live-job-workflow).
99
114
 
100
- The shared workspace keeps pointed issues in the persistent **Issues** sidebar, including an empty state.
115
+ **Historical UI, superseded by #741/#751:** the former workspace kept pointed issues in the persistent **Issues** sidebar, including an empty state.
101
116
  **Save sign-off** saves the current issue collection. An empty collection approves the inspection, and a
102
117
  non-empty collection requests changes. The live job host submits the same issue collection through its
103
118
  review dialog. Reviewer wording stays verbatim.
@@ -148,8 +163,8 @@ Sign-off JSON requests are limited to 4 MiB (4,194,304 bytes) of UTF-8 while str
148
163
  cancelled before its remainder is read; a valid request exactly at the byte limit is accepted. Same-origin and
149
164
  write-capability requirements remain unchanged.
150
165
 
151
- On reopen, a saved sign-off is offered only when both `source.sha256` and `source.flags` match the files on disk. When
152
- only the producer flags differ, the page says the saved sign-off is for different producer flags and starts fresh.
166
+ **Historical flag-bound sign-off UI:** on reopen, the former page offered a saved sign-off only when both `source.sha256` and `source.flags` matched the files on disk.
167
+ **Historical UI:** when only the producer flags differed, the page said the saved sign-off was for different producer flags and started fresh.
153
168
  Consumers that gate on the sign-off (rig-c/create) check `source.sha256`.
154
169
 
155
170
  Every file the view reads from a package resolves inside it: a part PNG or `parts.json` that symlinks out is refused
@@ -235,6 +250,11 @@ Crash-proof exactly-once delivery requires an additional acknowledgment/replay p
235
250
 
236
251
  ## Mesh geometry
237
252
 
253
+ **Historical UI:** the toggle labels and geometry/numbers panel below describe
254
+ the removed standalone parts page (#745). Current visual inspection uses Mesh
255
+ edges in the shared workspace. Geometry inputs and legacy wire references below
256
+ remain compatibility information, not a request to restore the old panel.
257
+
238
258
  In parts mode, a `rig.json` beside `parts.json` supplies optional mesh geometry;
239
259
  `--rig <file>` selects an explicit input instead. The workspace-wide **mesh from
240
260
  rig.json UVs** toggle starts off and retains its setting across part selection, assembled view,
@@ -270,7 +290,7 @@ not an exact recovery of the producer's original unrounded positions.
270
290
 
271
291
  Mode, vertex count, triangle count, `art_coverage` and `stray_cleared` are copied
272
292
  from the part's `mesh_report.json` row without recomputing them. Absent fields
273
- say **not reported**; faint islands remain in Producer flags. A report count may
293
+ say **not reported**; **historical UI:** faint islands remained in Producer flags. A report count may
274
294
  differ from the loaded geometry. These are producer readings. Historical verdicts stored
275
295
  `parts[name].mesh` as `{outcome,note}` only for a mesh-bearing part.
276
296
  `rig.json` and the loaded mesh report enter `source.files`, and the mesh report