rig-create 1.0.2 → 1.1.0

package/templates/example-remesh/.gitignore

@@ -0,0 +1,6 @@
+/derived/
+/outputs/
+/scratch/
+node_modules/
+/.rig-create-review-binding.json
+/.rig-create-review/

package/templates/example-remesh/.npmignore

@@ -0,0 +1 @@
+!**

package/templates/example-remesh/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-remesh/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-remesh/derived/drafts/remesh/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-remesh/derived/drafts/remesh/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-remesh/derived/drafts/remesh/interview-requirements.json

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

package/templates/example-remesh/derived/drafts/remesh/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-14T00:00:00.000Z",
+  "finished_at": "2026-11-14T00: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-remesh/derived/drafts/remesh/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