rig-create 1.0.4 → 1.2.0

package/templates/agent-guide.md

@@ -60,33 +60,11 @@ Preserve history/dates; adopt choices explicitly.
 
 - **Prior words.** In adopted projects, show them verbatim as a tailored option
   with source/date; require a pick. Legacy derivation: {{DERIVED_LINK}}.
-- **Projection.** Ask and record it per {{PROJECTION_LINK}}.
-- **Camera options.** Offer fixed view or camera-box moves only. Head turn,
-  depth and plate parallax are unavailable: direction has no depth/turn fields.
-- **Upscale first** a painting smaller than the rig needs (SOURCE.md, step 2 below).
-- **The crux is a bar.** Before rigging, name every risk band, count background
-  or doubled pixels over every frame and both physics/breath extremes, and
-  report the maximum and its frame. Cover every band crossing another bone.
 - **Bars before sign-off.** Each reading names its command, checked against
   installed `--help`. A reading with no command is a STOP before sign-off.
   Loop bars: INTERVIEW.md, "Bars have reading commands".
-- **Appearance needs a person**, not a step bar: {{APPEARANCE_LINK}}.
-- **Nothing unnamed.** Add no unnamed motion, chain or physics. Read references
-  for what they show; ask about anything more.
-- **Re-run first, cut last**, never a polygon in code or config: the ladder in
-  SOURCE.md, step 2 below.
-- **A full-screen scene is a CG build.** For `rig_type` `fullscreen.*`, each
-  rig version declares the gates in {{CG_GATES_LINK}}. Refusals are the art's to fix.
-- **The bust is meshed** unless the `meshes` guide excludes it with a reason
-  ({{BUST_LINK}}).
-- **Overlaps.** A piece over a part with its own animation (glasses over
-  eyelids) holds none of that part's pixels, or the animation shows its copy.
-- **Pairs.** Measure left/right symmetry against the painting before calling a
-  pair uneven ({{GATES_LINK}}).
-- **Look before the user does**, at native resolution and every crux boundary:
-  a whole-figure |composite − painting| map, each component by box/part and
-  status (in the painting / fixed / left, why). Use the true part stack; crop on
-  white and mid-grey to show light fringes. Check beyond reviewer-chosen boxes.
+
+Stage reference: [Before you ask, plan or show](AGENT-REFERENCE.md).
 
 ## Where things go
 

package/templates/collection.json

@@ -17,6 +17,7 @@
   "signoffs": [],
   "interview": {
     "question_set": "rig-create/interview@2 (waypoints read from @rig-c/parts 2.37.0)",
+    "turn_question": "rig-create/turn-question@1",
     "held": false,
     "date": null,
     "interviewer": null,
@@ -158,6 +159,13 @@
         "guide": null,
         "history": []
       },
+      {
+        "id": "turn",
+        "config": ["turn", "depth"],
+        "prompts": [{"id":"view","text":"Should this rig keep the painted view, or turn its head with depth?","source":"rig-create","required_for":["all"]}],
+        "guide": null,
+        "history": []
+      },
       {
         "id": "motion",
         "config": ["motion"],
@@ -190,8 +198,8 @@
       "items": [
         {
           "id": "camera_depth",
-          "config": ["turn", "depth"],
-          "text": "Does the view move (a 2.5D head-turn with parallax, a push-in) or is it fixed?",
+          "config": [],
+          "text": "Is the view fixed, or does it move along a camera-box path such as a push-in?",
           "source": "rig-create",
           "guide": null,
           "history": []

package/templates/example-chain/AGENT-REFERENCE.md

@@ -0,0 +1,62 @@
+# Agent reference
+
+## Before you ask, plan or show
+
+- **Projection.** Ask and record it per [CHECKS.md § Projection and ground](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#projection-and-ground).
+- **Head turn is a rig decision.** Ask `turn` at rigging-interview: fixed view
+  or head turn with depth. Record the chosen route and reason in the `turn`
+  plan step text. Default to per-part depth: parts 2.37.0's `docs/DEPTH.md`
+  describes it as better by eye. Run `depth-prepare`, the supplied model,
+  `depth-apply`, then `rig`. Retain the prepare manifest with
+  `rig-version --depth-manifest`; registration binds it, `depth-report.json`
+  and rig's `depth_sheets.json` by SHA-256.
+  The layer alternative requires sheets already retained in the accepted
+  assembled parts, bound alongside the existing `config.depth` images:
+  `assemble` consumes `config.depth`, so declaring it after acceptance cannot
+  add sheets. Do not reassemble accepted parts here. Existing sheets need no
+  model manifest.
+- **Camera options.** Post decides fixed framing or camera-box moves. Timed
+  head-turn dials, plate parallax and take-wide gaze remain unavailable in direction.
+- **Seamless loop on a rig with physics.** A looping take that starts at
+  source 0 begins with springs at rest and ends with them moving, so hair and
+  ribbons jump at the seam. Map the take onto a source interval that starts
+  after whole periods of the clip; ten were enough on the measured rig. The
+  number depends on the rig's damping, so compare the first and last frames
+  before choosing it.
+- **Upscale first** a painting smaller than the rig needs (SOURCE.md, step 2 below).
+- **The crux is a bar.** Before rigging, name every risk band, count background
+  or doubled pixels over every frame and both physics/breath extremes, and
+  report the maximum and its frame. Cover every band crossing another bone.
+- **Appearance needs a person**, not a step bar: [CHECKS.md § Appearance bar wording](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#appearance-bar-wording).
+- **Nothing unnamed.** Add no unnamed motion, chain or physics. Read references
+  for what they show; ask about anything more.
+- **Re-run first, cut last**, never a polygon in code or config: the ladder in
+  SOURCE.md, step 2 below.
+- **A full-screen scene is a CG build.** For `rig_type` `fullscreen.*`, each
+  rig version declares the gates in [CHECKS.md § CG gates](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#cg-gates). Refusals are the art's to fix.
+- **The bust is meshed** unless the `meshes` guide excludes it with a reason
+  ([CHECKS.md § The bust at meshes](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#the-bust-at-meshes)).
+- **Overlaps.** A piece over a part with its own animation (glasses over
+  eyelids) holds none of that part's pixels, or the animation shows its copy.
+- **Pairs.** Measure left/right symmetry against the painting before calling a
+  pair uneven ([CRAFT.md G8](https://github.com/rig-c/create/blob/main/docs/CRAFT.md#for-the-gates-not-the-interview)).
+- **Look before the user does**, at native resolution and every crux boundary:
+  a whole-figure |composite − painting| map, each component by box/part and
+  status (in the painting / fixed / left, why). Use the true part stack; crop on
+  white and mid-grey to show light fringes. Check beyond reviewer-chosen boxes.
+
+## What to read, and why
+
+1. **Before the interview**: INTERVIEW.md; CRAFT.md (waypoint defaults);
+   parts AUTHORING §3, *`config.json`, field by field*;
+   [CHECKS.md](https://github.com/rig-c/create/blob/main/docs/CHECKS.md) before a sign-off.
+2. **Before `seethrough` and `assemble`**: SOURCE.md, split/cut order:
+   [bad-split reruns](https://github.com/rig-c/create/blob/main/docs/SOURCE.md#re-run-first),
+   [allowed cuts](https://github.com/rig-c/create/blob/main/docs/SOURCE.md#where-a-cut-is-allowed);
+   parts AUTHORING *See-through head-run source reading*, *Source before
+   scissors* and *Limbs: cut at their joints*.
+3. **Before rigging**: [CRAFT.md § For the gates](https://github.com/rig-c/create/blob/main/docs/CRAFT.md#for-the-gates-not-the-interview)
+   (G1–G9); core RIGGING and MOTION; parts AUTHORING §7, the bars `check` enforces.
+4. **Before showing the user**: [LESSONS.md § The self-check](https://github.com/rig-c/create/blob/main/docs/LESSONS.md#the-self-check),
+   the [per-frame seam count](https://github.com/rig-c/create/blob/main/docs/LESSONS.md#count-the-seam-bar-over-every-frame),
+   [what to show first](https://github.com/rig-c/create/blob/main/docs/LESSONS.md#what-to-show-the-user-first).

package/templates/example-chain/AGENTS.md

@@ -8,7 +8,7 @@ One painting; one rig and its takes.
 2. Run `rig-create next` to derive the next moves and whose they are.
 3. Resume per [Resume](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#how-an-agent-resumes-a-project).
 
-Until create#493, agents may type `reopen` only from Review host raw export `act@4`: save nonempty `value.words` byte-for-byte to a verbatim file; `--source` names `actId`. Empty/missing words: STOP. Never supply words. `job fetch-act` rejects act@4.
+After an accepted post is bounced, reopen direction-review through Review: `job open --plan`, then `job acts --json`, ingest `reopen direction-review --from-review <actId>`, and `job close`. The exported act supplies the reviewer, date and verbatim words.
 
 Stale pins: `rig-create packages upgrade --by <operator>`.
 
@@ -60,33 +60,11 @@ Preserve history/dates; adopt choices explicitly.
 
 - **Prior words.** In adopted projects, show them verbatim as a tailored option
   with source/date; require a pick. Legacy derivation: [INTERVIEW.md § Derived answers](https://github.com/rig-c/create/blob/main/docs/INTERVIEW.md#derived-answers).
-- **Projection.** Ask and record it per [CHECKS.md § Projection and ground](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#projection-and-ground).
-- **Camera options.** Offer fixed view or camera-box moves only. Head turn,
-  depth and plate parallax are unavailable: direction has no depth/turn fields.
-- **Upscale first** a painting smaller than the rig needs (SOURCE.md, step 2 below).
-- **The crux is a bar.** Before rigging, name every risk band, count background
-  or doubled pixels over every frame and both physics/breath extremes, and
-  report the maximum and its frame. Cover every band crossing another bone.
 - **Bars before sign-off.** Each reading names its command, checked against
   installed `--help`. A reading with no command is a STOP before sign-off.
   Loop bars: INTERVIEW.md, "Bars have reading commands".
-- **Appearance needs a person**, not a step bar: [CHECKS.md § Appearance bar wording](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#appearance-bar-wording).
-- **Nothing unnamed.** Add no unnamed motion, chain or physics. Read references
-  for what they show; ask about anything more.
-- **Re-run first, cut last**, never a polygon in code or config: the ladder in
-  SOURCE.md, step 2 below.
-- **A full-screen scene is a CG build.** For `rig_type` `fullscreen.*`, each
-  rig version declares the gates in [CHECKS.md § CG gates](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#cg-gates). Refusals are the art's to fix.
-- **The bust is meshed** unless the `meshes` guide excludes it with a reason
-  ([CHECKS.md § The bust at meshes](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#the-bust-at-meshes)).
-- **Overlaps.** A piece over a part with its own animation (glasses over
-  eyelids) holds none of that part's pixels, or the animation shows its copy.
-- **Pairs.** Measure left/right symmetry against the painting before calling a
-  pair uneven ([CRAFT.md G8](https://github.com/rig-c/create/blob/main/docs/CRAFT.md#for-the-gates-not-the-interview)).
-- **Look before the user does**, at native resolution and every crux boundary:
-  a whole-figure |composite − painting| map, each component by box/part and
-  status (in the painting / fixed / left, why). Use the true part stack; crop on
-  white and mid-grey to show light fringes. Check beyond reviewer-chosen boxes.
+
+Stage reference: [Before you ask, plan or show](AGENT-REFERENCE.md).
 
 ## Where things go
 
@@ -114,7 +92,7 @@ Run refusal `(see … guide …)` commands first.
 - [@rig-c/parts README.md](node_modules/@rig-c/parts/README.md): painting-to-rig pipeline and command order.
 - [@rig-c/parts docs/AUTHORING.md](node_modules/@rig-c/parts/docs/AUTHORING.md): config fields, interview waypoints and refusal remedies.
 - [@rig-c/parts docs/PAINTING.md](node_modules/@rig-c/parts/docs/PAINTING.md): what makes a painting riggable, and the check to run on it before See-through.
-- [@rig-c/parts docs/DEPTH.md](node_modules/@rig-c/parts/docs/DEPTH.md): depth reference; unavailable in current direction.
+- [@rig-c/parts docs/DEPTH.md](node_modules/@rig-c/parts/docs/DEPTH.md): depth-driven head turn before rigging; timed direction is separate.
 - [@rig-c/parts docs/STABILITY.md](node_modules/@rig-c/parts/docs/STABILITY.md): stable commands, fields and outputs.
 - [@rig-c/parts docs/MIGRATION.md](node_modules/@rig-c/parts/docs/MIGRATION.md): only when the pinned version is bumped.
 - [@rig-c/core README.md](node_modules/@rig-c/core/README.md): rigc scope, commands and documentation.

package/templates/example-chain/README.md

@@ -8,6 +8,6 @@ The public create CLI writes stage moves, signoffs, rig plan steps (plan add), p
 
 Two seed kinds cover plan.steps (setup and status progress) with split.parts, and the rig version declaration. Source inventory is registered by input add. Each seed declares its consuming command and records that command’s step index in chain.json.
 
-checkpoints/ contains frozen prefix projects and adjacent pending-act declarations. Checkpoint 0a-interview-options follows interview-options rig_type and precedes the interview answers, the plan add calls and signoff interview; it has no skeleton.model.json and four expected INTERVIEW_INCOMPLETE refusal codes (interview.framing[rig_type].answer, interview.framing[reference].answer, interview.waypoints[seethrough].guide, interview.waypoints[assemble].guide) with zero warnings. Checkpoint 0b-plan-pending follows advance plan-approved with the plan add steps drafted and precedes signoff plan-approved; it has no skeleton.model.json, zero refusals and zero warnings. Stage 1 (1-parts-verdict, zero refusals, zero warnings) follows the producer parts-stage check report that the parts-review move binds, and precedes the synthetic review-tool parts verdict export and the structure-snapshot writer, which copies the meshes declarations of the labelled draft once that verdict is approved. Stage 2 (2-rigging-answers) precedes the first rigging answer and still needs later option sets to be agent-drafted in declared steps before registration by public writers. Pending answers use the SHA-256 of the file drafted during the walk. Stage 3 (3-rig-review, zero refusals, zero warnings) precedes rig review. Stage 4 (4-direction-post, zero refusals, zero warnings) precedes the background plate registration, the scene write, the declared agent-authored direction@2 input and the direction write. Pending stage moves use advance with the existing authorizing signoffs. Every file authored or copied for a later writer has a declared producer step with output hashes. The chain_step indices are zero-based. Stage 2 has four expected INTERVIEW_INCOMPLETE findings for its unanswered rigging guides (interview.waypoints[bones].guide, interview.waypoints[meshes].guide, interview.waypoints[constraints].guide, interview.waypoints[motion].guide) and zero warnings. Every prefix has zero warnings and records its stage moves in advances[]. tests/example-chain.test.ts checks these states.
+checkpoints/ contains frozen prefix projects and adjacent pending-act declarations. Checkpoint 0a-interview-options follows interview-options rig_type and precedes the interview answers, the plan add calls and signoff interview; it has no skeleton.model.json and four expected INTERVIEW_INCOMPLETE refusal codes (interview.framing[rig_type].answer, interview.framing[reference].answer, interview.waypoints[seethrough].guide, interview.waypoints[assemble].guide) with zero warnings. Checkpoint 0b-plan-pending follows advance plan-approved with the plan add steps drafted and precedes signoff plan-approved; it has no skeleton.model.json, zero refusals and zero warnings. Stage 1 (1-parts-verdict, zero refusals, zero warnings) follows the producer parts-stage check report that the parts-review move binds, and precedes the synthetic review-tool parts verdict export and the structure-snapshot writer, which copies the meshes declarations of the labelled draft once that verdict is approved. Stage 2 (2-rigging-answers) precedes the first rigging answer and still needs later option sets to be agent-drafted in declared steps before registration by public writers. Pending answers use the SHA-256 of the file drafted during the walk. Stage 3 (3-rig-review, zero refusals, zero warnings) precedes rig review. Stage 4 (4-direction-post, zero refusals, zero warnings) precedes the background plate registration, the scene write, the declared agent-authored direction@2 input and the direction write. Pending stage moves use advance with the existing authorizing signoffs. Every file authored or copied for a later writer has a declared producer step with output hashes. The chain_step indices are zero-based. Stage 2 has five expected INTERVIEW_INCOMPLETE findings for its unanswered rigging guides (interview.waypoints[bones].guide, interview.waypoints[meshes].guide, interview.waypoints[constraints].guide, interview.waypoints[turn].guide, interview.waypoints[motion].guide) and zero warnings. Every prefix has zero warnings and records its stage moves in advances[]. tests/example-chain.test.ts checks these states.
 
 Reproduce with `bun scripts/generate-example-chain.ts <fresh-dir> --check` from the create repository.