@rig-c/create 1.0.1 → 1.0.4

package/templates/example-chain/checkpoints/4-direction-post/AGENTS.md

@@ -1,20 +1,20 @@
 # Agent guide
 
-One painting in, one rig and its takes out. Start here.
+One painting; one rig and its takes.
 
 ## Start here
 
-1. Read `project.json` first. Only its decisions count. Copy chat decisions
-   verbatim, with speaker and time.
+1. Read `project.json`. Human acts go through Review; ingest exports. Never type human answers/signatures.
 2. Run `rig-create next` to derive the next moves and whose they are.
-3. Resume per [PROJECT.md § How an agent resumes a project](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#how-an-agent-resumes-a-project).
+3. Resume per [Resume](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#how-an-agent-resumes-a-project).
 
-Update stale pins with `rig-create packages upgrade --by <operator>`; see PROJECT.md.
+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.
 
-Declare the project's painting with `init --painting <file> --origin <words>`
-or `input add <path> --painting --origin <words>`. `project.json.painting` binds
-one input and survives restart; only it checks siblings for duplicate artwork.
-Older records may omit it.
+Stale pins: `rig-create packages upgrade --by <operator>`.
+
+Declare the painting: `init --painting <file> --origin <words>` or
+`input add <path> --painting --origin <words>`. `project.json.painting` binds
+one input, survives restart and checks sibling artwork; optional on older records.
 
 ## The order, and what you may not do
 
@@ -22,21 +22,18 @@ Older records may omit it.
 `rigging-interview` → `rigging` → `rig-review` (the rig, still frame) → `post-interview` → `post` →
 `direction-review` → `accepted`. Any stage can become `paused`.
 
-- Only a person's `signoffs[]` advances `stage` or passes a plan checkpoint.
-  You may draft, propose, build and measure in any stage; production rigging
-  waits for `rigging-interview` ([PROJECT.md § Stages](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#stages)).
-- Never derive answers from the image. Offer a pick per ask, with one reasoned
+- Only human `signoffs[]` advance `stage` or pass plan checkpoints.
+  Draft, propose, build and measure in any stage; production rigging waits for `rigging-interview` ([Stages](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#stages)).
+- Never infer answers from images. Offer a pick per ask: one reasoned
   recommendation, Other and auto. Retain the shown set; never preselect.
-- Record "auto" as delegated, with your decision on the item. It is never a
-  blank for you to fill later.
-- Before asking the user to sign the interview, run `rig-create interview --check`: it names every `null` answer.
+- Record "auto" as delegated with your decision on the item; never leave it blank.
+- Run `rig-create interview --check` before interview sign-off: it names every `null` answer.
 
 ## The user's four steps
 
-1. **Parts and meshes**. Ask framing/source. Review a labelled draft's parts and
-   mesh/chest structure. `parts-review` records its Review API response.
+1. **Parts and meshes**. Ask framing/source; review a labelled draft's parts and mesh/chest structure. `parts-review` records its Review API response.
    The latest receipt must approve the draft for `structure-snapshot --draft <id> --out <f>`
-   and `signoff parts-review --draft <id> --structure-file <f>`; record component triage with `diff-classes --diff-report <p> --by agent` ([PROJECT.md § Labelled draft rigs](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#labelled-draft-rigs-and-structure-decisions)).
+   and `signoff parts-review --draft <id> --structure-file <f>`; record component triage with `diff-classes --diff-report <p> --by agent` ([Draft rigs](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#labelled-draft-rigs-and-structure-decisions)).
 2. **Rigging interview**. Ask fresh bones, deformation, physics and motion
    against approved parts/structure; use interview-options/answer/decision.
 3. **Rig and animation**. Keep rig feedback.
@@ -47,21 +44,25 @@ Older records may omit it.
 
 Ask: `job open --reviewer <id> --role owner --question <id>` or `--plan`;
 ingest `--from-review <actId>`, then advance.
+Keep the host up across bound writes; after a stop, `job open` with reviewer/role,
+then `job reconcile` before writing.
 
-Use `advance <stage>`, `step-status <id>`; see `rig-create --help`.
+Use `advance <stage>` and `step-status <id>` (`rig-create --help`).
 `advance parts-review` needs `--parts-check <report> --parts <assembled dir>`,
 refusing [`PARTS_CHECK_MISSING`, `PARTS_CHECK_UNREAD`, `PARTS_CHECK_INVALID`, `PARTS_CHECK_CHANGED`, `PARTS_CHECK_FAILED`, `PARTS_CHECK_STALE`](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#parts-stage-check-at-the-parts--parts-review-move).
 In `parts`, record an `intake-report` preflight and offer its choice, both advisory:
 [PROJECT.md § Advisory intake reports](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#advisory-intake-reports).
 
-Drafts stay under `derived/drafts/<id>/`, never versions/handoff. Old records
-warn: preserve history and dates; adopt choices explicitly.
+Keep drafts in `derived/drafts/<id>/`, outside versions/handoff.
+Preserve history/dates; adopt choices explicitly.
 
 ## Before you ask, plan or show
 
 - **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
@@ -70,9 +71,8 @@ warn: preserve history and dates; adopt choices explicitly.
   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 motion, chain or physics the user did not name. A
-  reference ("move like X") is read for what it shows; anything more is a
-  question, not a default.
+- **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
@@ -83,12 +83,10 @@ warn: preserve history and dates; adopt choices explicitly.
   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 boundary the
-  crux names: a whole-figure |composite − painting| map, every component listed
-  by box and part with a status (in the painting / fixed / left, why). Use the
-  true stack of part images, not a render flattened on white; crop on white and
-  on mid-grey, as white hides light fringes. Eye boxes a
-  reviewer chose are not the check: a seam outside them got through.
+- **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.
 
 ## Where things go
 
@@ -96,13 +94,13 @@ Each folder's lifetime and git status: [PROJECT.md § Data is split by lifetime]
 
 ## What to read, and why
 
-1. **Before the interview**: INTERVIEW.md, and CRAFT.md for the default at each
-   waypoint (both linked below); 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, the order of the split and
-   the cut: [re-running a bad split](https://github.com/rig-c/create/blob/main/docs/SOURCE.md#re-run-first),
-   [where a cut is allowed](https://github.com/rig-c/create/blob/main/docs/SOURCE.md#where-a-cut-is-allowed);
-   then parts AUTHORING *See-through head-run source reading*, *Source before
+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.
@@ -110,23 +108,23 @@ Each folder's lifetime and git status: [PROJECT.md § Data is split by lifetime]
    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).
 
-Read installed docs here at `package.json`'s pins to match tools, not memory.
-Run refusal `(see … guide …)` commands before changes.
+Use installed docs at `package.json`'s pins, not memory.
+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): when the plan has a head turn driven by depth.
+- [@rig-c/parts docs/DEPTH.md](node_modules/@rig-c/parts/docs/DEPTH.md): depth reference; unavailable in current direction.
 - [@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.
 - [@rig-c/core docs/AUTHORING.md](node_modules/@rig-c/core/docs/AUTHORING.md): rig/motion formats, build loop and failure remedies.
 - [@rig-c/core docs/RIGGING.md](node_modules/@rig-c/core/docs/RIGGING.md): bones and pivots at the bones waypoint.
 - [@rig-c/core docs/MOTION.md](node_modules/@rig-c/core/docs/MOTION.md): key-pose motions at the motion waypoint.
-- [@rig-c/core docs/FACE.md](node_modules/@rig-c/core/docs/FACE.md): blink, gaze and head-turn plans.
+- [@rig-c/core docs/FACE.md](node_modules/@rig-c/core/docs/FACE.md): blink and gaze in the accepted rig.
 - [@rig-c/core docs/INGEST.md](node_modules/@rig-c/core/docs/INGEST.md): only when you were handed a skeleton this project did not author.
 
-Project organisation: rig-c/create docs (not installed).
+Project docs (not installed):
 
 - [docs/PROJECT.md](https://github.com/rig-c/create/blob/main/docs/PROJECT.md): the folder, stages and sign-offs, the plan, versions, and `project.json` field by field.
 - [docs/INTERVIEW.md](https://github.com/rig-c/create/blob/main/docs/INTERVIEW.md): how to ask, and the shape every answer, delegation and piece of feedback takes.

package/templates/example-chain/checkpoints/4-direction-post/derived/drafts/chain/config.json

@@ -0,0 +1,88 @@
+{
+  "key": "synthetic",
+  "requirements": "interview-requirements.json",
+  "assemble": {
+    "rig_scale": 1,
+    "plan": [
+      [
+        "background",
+        "full",
+        "author:background"
+      ],
+      [
+        "torso",
+        "full",
+        "topwear"
+      ],
+      [
+        "lantern",
+        "full",
+        "author:lantern"
+      ],
+      [
+        "face",
+        "full",
+        "face"
+      ],
+      [
+        "eye_r",
+        "full",
+        "eyewhite-r"
+      ],
+      [
+        "eye_l",
+        "full",
+        "eyewhite-l"
+      ]
+    ]
+  },
+  "bones": [
+    {
+      "name": "body",
+      "parent": "root",
+      "at": [
+        64,
+        64
+      ]
+    }
+  ],
+  "meshes": {
+    "torso": {
+      "grid": 16,
+      "r": 16,
+      "segments": [
+        [
+          "body",
+          [
+            64,
+            8
+          ],
+          [
+            64,
+            72
+          ]
+        ]
+      ]
+    }
+  },
+  "regions": {
+    "background": "body",
+    "lantern": "body",
+    "face": "body",
+    "eye_r": "body",
+    "eye_l": "body"
+  },
+  "motion": {
+    "duration": 4,
+    "tracks": [
+      {
+        "bone": "body",
+        "prop": "translatey",
+        "amp": 0.9,
+        "period": 4,
+        "phase": 0,
+        "base": 0
+      }
+    ]
+  }
+}

package/templates/example-chain/checkpoints/4-direction-post/derived/drafts/chain/input/parts.json

@@ -0,0 +1,188 @@
+{
+  "rig_size": [
+    128,
+    128
+  ],
+  "scale_rig_per_source": 1,
+  "painting_in_rig": {
+    "path": "painting_in_rig.png",
+    "sha256": "02e6ea41dfec89a7eced0f66b98e0fea048846c6f4174fa1cc7631fe360e614f",
+    "resample": "lanczos3-rgb-opaque"
+  },
+  "parts": [
+    {
+      "name": "background",
+      "from": "full:author:background",
+      "x": 0,
+      "y": 0,
+      "w": 128,
+      "h": 128,
+      "opaque_px": 16384,
+      "provenance": {
+        "unchanged_layer_px": 0,
+        "hand_px": 16384,
+        "automatic_px": 0,
+        "edits": [
+          {
+            "edit": "full:author:background",
+            "px": 16384
+          }
+        ],
+        "automatic": []
+      },
+      "visible_px": 11648,
+      "occluded_px": 4736,
+      "projected_core_px": 10704,
+      "source_px_taken": 10704,
+      "visible_not_projected_px": 944,
+      "refused_drift_px": 0,
+      "merged_px": 0,
+      "seam_override_px": 0
+    },
+    {
+      "name": "torso",
+      "from": "full:topwear",
+      "x": 40,
+      "y": 56,
+      "w": 48,
+      "h": 64,
+      "opaque_px": 3072,
+      "provenance": {
+        "unchanged_layer_px": 3072,
+        "hand_px": 0,
+        "automatic_px": 0,
+        "edits": [],
+        "automatic": []
+      },
+      "visible_px": 3072,
+      "occluded_px": 0,
+      "projected_core_px": 2640,
+      "source_px_taken": 2640,
+      "visible_not_projected_px": 432,
+      "refused_drift_px": 0,
+      "merged_px": 0,
+      "seam_override_px": 0
+    },
+    {
+      "name": "lantern",
+      "from": "full:author:lantern",
+      "x": 96,
+      "y": 72,
+      "w": 16,
+      "h": 24,
+      "opaque_px": 384,
+      "provenance": {
+        "unchanged_layer_px": 0,
+        "hand_px": 384,
+        "automatic_px": 0,
+        "edits": [
+          {
+            "edit": "full:author:lantern",
+            "px": 384
+          }
+        ],
+        "automatic": []
+      },
+      "visible_px": 384,
+      "occluded_px": 0,
+      "projected_core_px": 240,
+      "source_px_taken": 240,
+      "visible_not_projected_px": 144,
+      "refused_drift_px": 0,
+      "merged_px": 0,
+      "seam_override_px": 0
+    },
+    {
+      "name": "face",
+      "from": "full:face",
+      "x": 44,
+      "y": 16,
+      "w": 40,
+      "h": 32,
+      "opaque_px": 1280,
+      "provenance": {
+        "unchanged_layer_px": 1280,
+        "hand_px": 0,
+        "automatic_px": 0,
+        "edits": [],
+        "automatic": []
+      },
+      "visible_px": 1152,
+      "occluded_px": 128,
+      "projected_core_px": 720,
+      "source_px_taken": 720,
+      "visible_not_projected_px": 432,
+      "refused_drift_px": 0,
+      "merged_px": 0,
+      "seam_override_px": 0
+    },
+    {
+      "name": "eye_r",
+      "from": "full:eyewhite-r",
+      "x": 50,
+      "y": 28,
+      "w": 8,
+      "h": 8,
+      "opaque_px": 64,
+      "provenance": {
+        "unchanged_layer_px": 64,
+        "hand_px": 0,
+        "automatic_px": 0,
+        "edits": [],
+        "automatic": []
+      },
+      "visible_px": 64,
+      "occluded_px": 0,
+      "projected_core_px": 16,
+      "source_px_taken": 16,
+      "visible_not_projected_px": 48,
+      "refused_drift_px": 0,
+      "merged_px": 0,
+      "seam_override_px": 0
+    },
+    {
+      "name": "eye_l",
+      "from": "full:eyewhite-l",
+      "x": 70,
+      "y": 28,
+      "w": 8,
+      "h": 8,
+      "opaque_px": 64,
+      "provenance": {
+        "unchanged_layer_px": 64,
+        "hand_px": 0,
+        "automatic_px": 0,
+        "edits": [],
+        "automatic": []
+      },
+      "visible_px": 64,
+      "occluded_px": 0,
+      "projected_core_px": 16,
+      "source_px_taken": 16,
+      "visible_not_projected_px": 48,
+      "refused_drift_px": 0,
+      "merged_px": 0,
+      "seam_override_px": 0
+    }
+  ],
+  "ghost_px": {
+    "full:author:background": 0,
+    "full:author:lantern": 0,
+    "full:eyewhite-l": 0,
+    "full:eyewhite-r": 0,
+    "full:face": 0,
+    "full:topwear": 0
+  },
+  "recomposite": {
+    "mean_abs": 0,
+    "within_limit": 8,
+    "within_share": 1,
+    "error_limit": 40,
+    "error_px": 0,
+    "covered_alpha": 128,
+    "uncovered_error_px": 0,
+    "hole_count": 0,
+    "holes_listed": 5,
+    "holes": []
+  }
+}

package/templates/example-chain/checkpoints/4-direction-post/derived/drafts/chain/interview-requirements.json

@@ -0,0 +1,8 @@
+{
+  "spec": "spine-parts-requirements/1",
+  "fps": 12,
+  "requirements": [],
+  "setup_painting": {
+    "required": true
+  }
+}

package/templates/example-chain/checkpoints/4-direction-post/derived/drafts/chain/out/check/build/run.json

@@ -0,0 +1,40 @@
+{
+  "spec": "rigc-run/1",
+  "package": {
+    "name": "@rig-c/core",
+    "version": "3.7.0"
+  },
+  "command": "build",
+  "started_at": "2026-11-13T00:00:00.000Z",
+  "finished_at": "2026-11-13T00:00:00.000Z",
+  "inputs": [
+    {
+      "role": "rig",
+      "path": "../../rig.json",
+      "sha256": "d266d58324d252e7c932ad41f856284a277e3c84204f7a081de7a5e1d3935de3"
+    },
+    {
+      "role": "motion",
+      "path": "../../motion.json",
+      "sha256": "727746f1a894513ea33c26b984ceb637f7eef06e935cb174ad99ad65826ec5c9"
+    }
+  ],
+  "outputs": [
+    {
+      "path": "skeleton.atlas",
+      "sha256": "68f9cb5eea7a194d59fb14d5c2363894b2eca78c26bf9aee67a760955a6125f3"
+    },
+    {
+      "path": "skeleton.json",
+      "sha256": "8e2b5edae8cce48ca98587ddb458f38406d28ba7fb7ade02dbd2a0bc8f28e03d"
+    },
+    {
+      "path": "skeleton.model.json",
+      "sha256": "3c899fedb29f61722790c7ae54686d92dad2980699c416b0912dc7883c016d46"
+    },
+    {
+      "path": "skeleton.png",
+      "sha256": "1b1836dc1a2700302723ebfebc8fd2be918ba69dff41029788a90595c426c6b2"
+    }
+  ]
+}

package/templates/example-chain/checkpoints/4-direction-post/derived/drafts/chain/out/check/build/skeleton.atlas

@@ -0,0 +1,28 @@
+skeleton.png
+size: 140, 216
+filter: Linear, Linear
+pma: false
+background
+bounds: 2, 2, 136, 136
+offsets: 0, 0, 136, 136
+rotate: 0
+eye_l
+bounds: 114, 178, 16, 16
+offsets: 0, 0, 16, 16
+rotate: 0
+eye_r
+bounds: 62, 186, 16, 16
+offsets: 0, 0, 16, 16
+rotate: 0
+face
+bounds: 62, 142, 48, 40
+offsets: 0, 0, 48, 40
+rotate: 0
+lantern
+bounds: 114, 142, 24, 32
+offsets: 0, 0, 24, 32
+rotate: 0
+torso
+bounds: 2, 142, 56, 72
+offsets: 0, 0, 56, 72
+rotate: 0