@rig-c/parts 2.47.1 → 2.49.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.
package/docs/AUTHORING.md CHANGED
@@ -206,7 +206,7 @@ read by no CPU stage).
206
206
  | `cloth` | `propose --cloth` only; no other stage reads it, so it moves no byte of any build | **authored**, optional (issue #364): one recipe per tag, `{"bottomwear": {…}, "back hair": {…}, "front hair": {…}}`, each `{chains, links, wind, gravity, split?, length_ratio?, strength?, damping?, alternate_damping?, translate?, swing?, part?, influence?}`. `influence` (issue #518) — `{across, max, shape, radius?}`: the parts this recipe meshes are drafted in the influence mode (`meshes.<part>.influence` above) at their lattice's cell, with `across`, `max` and `shape` as declared (each required — the reading behind the radius did not vary them) and `radius` as declared or, absent, drafted as the farthest vertex's distance plus 3 cells (the `influence.radius` row); without it the parts keep their lattice. `chains` — trees across the piece (for `back hair`, per side of the eye axis), a whole number, 1 or more; `links` — links from root to tip on every path, 1 or more; `split` — `{at, into}`: the first `at` links are the trunk, which forks into `into` (2 or more) branches; `at` below `links` (`CONFIG_CLOTH_SPLIT_BEFORE_TIP`); `length_ratio` — a path's last link over its first, above 0, default 0.5; `strength` — `{trunk, branch, edge}`, each above 0 and below the spring's stability bound (`CONFIG_CLOTH_SPRING_STABLE`), default 100 / 100 / 50; `damping` — in [0, 1], absent: rig-c's default; `alternate_damping` — the odd trees' damping, in [0, 1], beside `damping` and different from it (`CONFIG_CLOTH_ALTERNATE_DIFFERS`); `wind`, `gravity` — `[root, tip]`, each 0 or more, tip at or above root (`CONFIG_CLOTH_RESPONSE_GROWS_TO_TIP`); `translate` — the x and y mix of a dangling end's flutter, above 0 and at most 1; `swing` — `bottomwear` only, `{scales}`, one positive scale per tree (`CONFIG_CLOTH_SWING_SCALE_PER_TREE`); `part` — `bottomwear` only (`CONFIG_CLOTH_PART_ON_BOTTOMWEAR`), a non-empty part or cut-piece name: the `topwear` part that holds a skirt See-through returned inside it (a dress), or its skirt piece cut by `assemble.cuts`, which takes the skirt's trees (issue #402, *A skirt inside topwear* below; the part is checked by `propose`, `PROPOSE_CLOTH_PART`). The two defaults are the recipe's own, measured on its synthetic fixture (the recipe below). The recipe below says what each field drafts. The config written: `propose --cloth <config.json> --write-config <out.json>` (issue #537) writes this config's own text back with the sections the recipe drafts spliced in — `meshes.<part>` and `regions.<part>`, and `bones`, `constraints` and `motion.tracks` entry by entry by name (issue #552) — and every other byte as read; `--from <previous config>` (issue #571) takes an entry equal to the previous recipe's draft as the recipe's (*The config written*, under the recipe below) |
207
207
  | `proposed_rig_scale` | assemble, rig, build, `propose --from-config`/`--compare` | **proposed** by `propose` (issue #354): `parts.json`'s `scale_rig_per_source`, the `assemble.rig_scale` the rig sections (`bones`, `meshes`, `limbs`, `motion`) were drafted at. Held equal to `assemble.rig_scale` when present (`CONFIG_PROPOSED_RIG_SCALE`; 0, negative or not a number: `CONFIG_FIELD_TYPE`). Absent on a hand-authored config, where no byte of any output moves |
208
208
  | `motion_seams` | propose, assemble, check | Optional `[{part, neighbour}]`, using output part names. Each unordered pair is declared once; self-pairs, unknown names, wrong shapes and unknown fields refuse (`CONFIG_MOTION_SEAM`, `PARTS_MOTION_SEAM`, `CHECK_MOTION_SEAM_DECLARATION`). Empty adds no pair. Assemble copies the declaration into `parts.json`; check merges it with existing pairs and never regenerates a removed declaration. It uses the existing non-root WARN floor and changes no bar or exit status. See *Explicit motion seam observations* below. |
209
- | `requirements` | build (read in place of `--requirements` when the flag is not given), and so its check | **authored**, optional, never proposed (issue #556): a path, relative to the config file's directory, to the `spine-parts-requirements/1` file the build's check reads (§7, *Declared requirements*) — so a rig that needs one (a `not_swinging` part, a `may_fold`) rebuilds from its config alone. `build` reads it before assemble, as it reads the flag's file, and `check.json`'s `requirements.file` records it with `path` as declared. Given beside `--requirements`, the two must name the same file once resolved, or a file of the same bytes, and the declaration is read and recorded (a build given both writes what the config alone writes); otherwise `BUILD_REQUIREMENTS_CONFLICT`, naming both. Not a non-empty string: `CONFIG_FIELD_TYPE`; no such file, where the config is read from a path: `CONFIG_FILE_PRESENT`. `check`, `compose`, `mesh-draft`, `remesh` and `retune` do not read it: their `--requirements` is the only door. Absent, nothing is read and no byte of any output moves |
209
+ | `requirements` | build (read in place of `--requirements` when the flag is not given), and so its check; assemble, where a region take or a busy-visible figure mask reads requirements; and the assembly reading, wherever a stale check runs (`rig`, `check`, `depth-apply`) | **authored**, optional, never proposed (issue #556): a path, relative to the config file's directory, to the `spine-parts-requirements/1` file the build's check reads (§7, *Declared requirements*) — so a rig that needs one (a `not_swinging` part, a `may_fold`) rebuilds from its config alone. `build` reads it before assemble, as it reads the flag's file, and `check.json`'s `requirements.file` records it with `path` as declared. Given beside `--requirements`, the two must name the same file once resolved, or a file of the same bytes, and the declaration is read and recorded (a build given both writes what the config alone writes); otherwise `BUILD_REQUIREMENTS_CONFLICT`, naming both. When the file's content reaches assembly (a region take's `setup_painting.rgb_tolerance`, or a busy-visible `setup_painting.figure_mask`), `assemble` and `build` require this declaration to name the `--requirements` file, and refuse a flag without it as `ASSEMBLE_REQUIREMENTS_UNDECLARED` (issue #1418). Not a non-empty string: `CONFIG_FIELD_TYPE`; no such file, where the config is read from a path: `CONFIG_FILE_PRESENT`. `check`, `compose`, `mesh-draft`, `remesh` and `retune` do not read it for their own requirements: their `--requirements` is the only door. The assembly reading's stale check, which `rig`, `check` and `depth-apply` run against `parts.json`, does read it. Absent, nothing is read and no byte of any output moves |
210
210
 
211
211
  ### Drafting the chest carrier
212
212
 
@@ -990,7 +990,10 @@ one seed pixel on the target run canvas (integer x right, y down).
990
990
 
991
991
  The region is derived from base alpha < 128, donor alpha >= 128, and the
992
992
  maximum RGB channel difference after rounding each pixel source-over white.
993
- The tolerance is exactly `--requirements`' `setup_painting.rgb_tolerance`.
993
+ The tolerance is exactly `setup_painting.rgb_tolerance` in the requirements
994
+ file `config.requirements` names; `assemble --requirements` and `build
995
+ --requirements` are optional and, when given, must name the same file (the
996
+ same resolved file, or a file with the same bytes; issue #1418).
994
997
  A missing tolerance declaration is refused. The optional `reference` declares
995
998
  exactly one of `"source": true` (the stage's `--source`) or
996
999
  `"painting": "path/to/reference.png"` (config-relative), and `sha256`, the
@@ -4491,7 +4494,7 @@ existing hardlinks are refused before artifact output; the ordinary mode names
4491
4494
  | `layers <dir \| layers.json \| file.psd>` | keep the existing columns (`opaque_px` still means alpha >8) and append source-alpha boxes `drawn(a>8)` / `opaque(a>=250)` with exclusive right/bottom; name absent boxes, report the existing body-group union height at **CORE_ALPHA (>=250)** in **input-canvas px**, and show its >8 union separately; no anatomical height, ownership/erosion or painting registration is inferred ([units and rig-scale guidance](AUTHORING.md#4-the-command-order)) |
4492
4495
  | `sheet --source <png> --layers <path>… --out <png>` | a labelled contact sheet of the painting and every layer or part |
4493
4496
  | `assemble --propose-plan … [--write-config <config>]` | propose `assemble.plan` and `extend_below_crop` from the two runs, leaving out an implausible layer with a note naming the rule, naming in a note any full-run body no planned part covers, and naming every layer no row takes with why (empty, taken from the other run only, a plausibility rule; `nose`, never planned, with the row that lets `propose` read the head's pitch). Front/back hair reaching more than 8 rig pixels beyond a side or top edge receives explicit `edges`; each explicit edge has the same strict reach bar. The legacy bottom entry is retained unchanged; qualifying side/top edges receive a separate entry without bottom. With no qualifying side/top edge, the proposal remains unchanged. |
4494
- | `assemble --source --full --head --config --out [--seam] [--project]` | merge the two runs into rig-space parts, `parts.json`, the recomposite and its error map, and `run.json` (`spec` `rig-run/1`), and list the uncovered holes |
4497
+ | `assemble --source --full --head --config --out [--seam] [--project] [--requirements]` | merge the two runs into rig-space parts, `parts.json`, the recomposite and its error map, and `run.json` (`spec` `rig-run/1`), and list the uncovered holes. A region take's tolerance comes from `setup_painting.rgb_tolerance` in `config.requirements`'s file; under `ground: "busy"` with `project: "visible"`, so does `setup_painting.figure_mask`. `--requirements` is optional and, when given, must name the same file (the same resolved file, or the same bytes), or it is refused (`ASSEMBLE_REQUIREMENTS_UNDECLARED`, `BUILD_REQUIREMENTS_CONFLICT`) |
4495
4498
  | `diff-drafts --left <dir> --right <dir> --out <json>` | compare two assemble or build outputs (`rig/parts.json` + `rig/parts/` + `render/recomposite_rig.png`, or `parts.json` + `parts/` + `recomposite_rig.png`) and write `rig-parts-draft-diff/1` JSON: per-part status (`same`, `changed`, `added`, `removed`), file `sha256`, rig-pixel `box` and draw-order `index` per present side, `pixels_equal` and rig-space `pixels` (`changed_px`, `colour_px`, `alpha_px`, `bounds`) on changed parts, and `composite` ([Draft-to-draft assemble comparison](#draft-to-draft-assemble-comparison-issue-1369)) |
4496
4499
  | `head-crop-preflight --full <run> --canvas WxH --head-box '[left,top,right,bottom]'` | before the head run: JSON on stdout, one advice line per hit tag on stderr, exit 0 even when clipped. Counts original alpha > 8 full-run samples after centre registration through the square pad into painting coordinates: centres below left/top or at/above right/bottom are outside. Fractional boxes are accepted; corner samples count on both edges. No ghost cleanup, resampling, head run or assemble is needed. These counts cannot be compared with `ASSEMBLE_CROP_CLIPPED`, which counts rig pixels at alpha >= 128 after `cleanGhosts`. Preflight reads original samples before the head run exists, so soft fringes and ghost specks can be hits only here. Bottom is distinct because `extend_below_crop` handles it. Zero-hit tags remain in JSON. Existing pipeline outputs stay unchanged; help adds this command and guide reflects these documentation edits. |
4497
4500
  | `propose --head-box --full <run> --canvas WxH [--no-back-hair] [--write-config <config>]` | propose `seethrough.head_box` from the full run, held inside the painting; `--no-back-hair` leaves the back-hair layer out of that proposal |
@@ -4600,6 +4603,18 @@ than the config specifies, put the values used for assembly in `assemble.seam`
4600
4603
  and `assemble.project` in the config you pass to the standalone command.
4601
4604
  To use other values, re-run assemble with the config you intend to keep.
4602
4605
 
4606
+ A region take reads `setup_painting.rgb_tolerance` from the requirements
4607
+ file, and under `ground: "busy"` with `project: "visible"` assembly reads
4608
+ `setup_painting.figure_mask`. The digest binds both from `config.requirements`,
4609
+ so declare the file there: `assemble` reads it from there as `build` does,
4610
+ and `assemble --requirements` and `build --requirements` are optional and may
4611
+ name the same file, by any path that resolves to it or by a copy of its
4612
+ bytes. A `--requirements` file the config does not name is
4613
+ refused when either field reaches assembly
4614
+ ([`ASSEMBLE_REQUIREMENTS_UNDECLARED`](#ASSEMBLE_REQUIREMENTS_UNDECLARED), or
4615
+ [`BUILD_REQUIREMENTS_CONFLICT`](#BUILD_REQUIREMENTS_CONFLICT) when the config
4616
+ names another file), so a stamp never records a value assemble did not use.
4617
+
4603
4618
  Ordinary keyed-animation edits through `motion.animations_from` leave
4604
4619
  the assembly digest intact. Cloth changes can require reassembly when physics
4605
4620
  bone bindings change which part pairs move relative to each other under turn.
@@ -5889,7 +5904,7 @@ recorded transform. The record fields and sampling formula are specified in
5889
5904
  | <a id="ASSEMBLE_REGION_TAKE_REFERENCE"></a>`ASSEMBLE_REGION_TAKE_REFERENCE` | a declared region reference is unreadable | supply the declared PNG, with `source: true` or `painting` and its byte hash |
5890
5905
  | <a id="ASSEMBLE_REGION_TAKE_REFERENCE_MATCH"></a>`ASSEMBLE_REGION_TAKE_REFERENCE_MATCH` | a reference hash or painting dimensions differ | supply the declared PNG and preserve the source geometry |
5891
5906
  | <a id="ASSEMBLE_REGION_TAKE_CONTAINMENT"></a>`ASSEMBLE_REGION_TAKE_CONTAINMENT` | a non-target part has no pre-take counterpart | retain the same neighbour part population before and after the take |
5892
- | <a id="ASSEMBLE_REGION_TAKE_TOLERANCE"></a>`ASSEMBLE_REGION_TAKE_TOLERANCE` | a region take has no authored `setup_painting.rgb_tolerance` | supply the same requirements file to assemble/build and check |
5907
+ | <a id="ASSEMBLE_REGION_TAKE_TOLERANCE"></a>`ASSEMBLE_REGION_TAKE_TOLERANCE` | a region take finds no authored `setup_painting.rgb_tolerance`: `config.requirements` is absent and no `--requirements` was given, or the requirements file it reads declares none. The detail names that file, or says no file was given | declare `setup_painting.rgb_tolerance` (an integer 0-255) in the file `config.requirements` names, or add `config.requirements` naming such a file; `--requirements`, when given, must name the same file |
5893
5908
  | <a id="ASSEMBLE_REGION_TAKE_GEOMETRY"></a>`ASSEMBLE_REGION_TAKE_GEOMETRY` | without `crop`, donor and target canvases or entire input RGBA differ; with `crop`, the original input differs from its declared square-padded crop; or the target head run is absent | supply the matching original input PNG and declare `crop` for a crop donor; a head take requires a target head run |
5894
5909
  | <a id="ASSEMBLE_REGION_TAKE_PART"></a>`ASSEMBLE_REGION_TAKE_PART` | the named plan part/run or its base/donor tag is absent, or the target is taken twice | name an existing plan part and one donor holding its tag |
5895
5910
  | <a id="ASSEMBLE_REGION_TAKE_EMPTY"></a>`ASSEMBLE_REGION_TAKE_EMPTY` | the derived qualifying region has 0 pixels | supply material missing from the base that covers and matches the painting |
@@ -6396,8 +6411,8 @@ outside the consumed inputs pending [#1177](https://github.com/rig-c/parts/issue
6396
6411
  | <a id="CHECK_SETUP_PAINTING_MEASURED"></a>`CHECK_SETUP_PAINTING_MEASURED` | missing native setup/ownership or unsupported clipping | supply observable textured setup geometry; an unavailable instrument never passes |
6397
6412
  | <a id="CHECK_BOUNDARY_COLOUR_STEP"></a>`CHECK_BOUNDARY_COLOUR_STEP` | the requirements file declares `boundary_colour.max_step_excess` and a part boundary's colour step in the rig's render exceeds the same boundary's step in the rig's own pieces by more than it; the part pair, the frame (`setup` or `idle frame <n> (t <s> s)`), the stage pixel, the excess, the declared allowance and both steps are quoted. Unlike [`CHECK_SETUP_MATCHES_PAINTING`](#CHECK_SETUP_MATCHES_PAINTING), which compares the painting per declared region at the setup pose, this compares against the rig's own flat pieces (`parts.json` placement at setup, each piece's rest colour through its art UVs on every idle frame), so a part drawn over its neighbour's line art is not a failure | the pair's rig image or mesh: `rig/images/<part>.png` (a texture stretched into its padded UVs, or a notch cut out of it), or that part's mesh in `config.json` `meshes` when the mesh cuts a corner off the art; see [Boundary colour step](#boundary-colour-step-issue-942) |
6398
6413
  | <a id="CHECK_BOUNDARY_COLOUR_UNMEASURED"></a>`CHECK_BOUNDARY_COLOUR_UNMEASURED` | `boundary_colour` is declared and the step cannot be taken: no `parts.json`, no `idle`, or a default-skin region or mesh image without a sequence, with a parts record, whose rig image is not its parts PNG with one even pad on every side (refused before anything is built); otherwise a drawn slot has no `parts.json` piece, is clipped, or its rig image is not its parts PNG with one even pad on every side (the slot and frame are named). Never a pass | make every drawn slot a `parts.json` piece, or drop `boundary_colour` from the requirements file (the bar then reports SKIP) |
6399
- | <a id="CHECK_BEHIND_PART_SEAMS"></a>`CHECK_BEHIND_PART_SEAMS` | `behind_seams` is declared and a selected pair exceeds its allowance in the independent motion-opened or standing reading at setup, on an idle frame or at an opted-in named turn pose; the pair, behind slots, reading, frame, counted seam cells and allowance are named | repair the declared seam or author its per-pair allowance; no WARN mode or rest-visible mask; see [Behind-part seams](#behind-part-seams-issue-1314) |
6400
- | <a id="CHECK_BEHIND_PART_SEAMS_UNMEASURED"></a>`CHECK_BEHIND_PART_SEAMS_UNMEASURED` | a pair with an authored effective threshold cannot read a mandatory population: selected pair, eligible behind slots, idle, readable setup, motion support, boundary population, or verified render/grid/material evidence; mandatory unread evidence makes the combined line FAIL. A missing threshold alone is a nonrequired SKIP and HOLE without this refusal code | supply the named measurement evidence; an invalid selected-pair override also refuses by name, and existing renderer or sidecar refusals remain refusals |
6414
+ | <a id="CHECK_BEHIND_PART_SEAMS"></a>`CHECK_BEHIND_PART_SEAMS` | `behind_seams` is declared and a selected pair exceeds its allowance in the independent `motion_opened` reading on an idle frame, in the `standing` reading at setup (compared against the parts' flat recomposite at their painted positions), or in the `motion_opened` reading at an opted-in named turn pose (idle and turn `standing` are not measured); the pair, behind slots, reading, frame, counted seam cells and allowance are named | repair the declared seam in `parts/<part>.png` or `config.json` (`regions`, `meshes`, or `bones`), or author its allowance in `requirements.json` (`behind_seams.allowance` or `behind_seams.pairs[].allowance`); no WARN mode or rest-visible mask; see [Behind-part seams](#behind-part-seams-issue-1314) |
6415
+ | <a id="CHECK_BEHIND_PART_SEAMS_UNMEASURED"></a>`CHECK_BEHIND_PART_SEAMS_UNMEASURED` | a pair with an authored effective threshold cannot read a mandatory population: selected pair, eligible behind slots, `--parts` manifest (`parts.json` and `parts/*.png`) for setup standing's flat recomposite, idle, readable setup, motion support, boundary population, or verified render/grid/material evidence; mandatory unread evidence makes the combined line FAIL. A missing threshold alone is a nonrequired SKIP and HOLE without this refusal code | for the detail `no --parts manifest was supplied; setup standing compares the setup render with the parts' flat recomposite`, supply `parts.json` and `parts/<part>.png` (or pass `--parts <dir>` on the `rig-parts check` command line). For the detail `standing endpoints include ambiguous half-alpha owners` (measured at setup only), the line names the case and, for each case, the first endpoint in scan order with both members' alpha: *neither* member reaches 128/255 there (both members' soft edges paint the same cell, each below 128/255) or *both* do (the members' overlap reaches the gap's edge). Edit `parts/<part>.png` of one member, or its source layer, so that exactly one member reaches 128/255 at that endpoint and the other is below it or does not paint it; the corridor is then read and may fail [`CHECK_BEHIND_PART_SEAMS`](#CHECK_BEHIND_PART_SEAMS) on a real gap. A threshold at or above the cell's distance to the recomposite removes the cell from the reading altogether; the threshold decides what could count; it does not clear a cell that could. `requirements.json` `behind_seams.allowance` never clears an unread cell; removing `behind_seams.threshold` (or `behind_seams.pairs[].threshold`), or the pair from `behind_seams.pairs[]` in `requirements.json`, only silences the reading (issues #1405, #1408). When a turn pose (or idle frame) reads the `motion_opened` `HOLE` (`stock transported setup-overlap support is unavailable on every named turn pose; motion-opened is not measured`, or `stock transported setup-overlap support is unavailable on every idle frame; motion-opened is not measured`, or `both named front slots must draw on this frame`, or `no eligible slot is drawn strictly behind both pair members (including every fragment)`), give the pair's two front members a setup overlap band in `parts/<part>.png` or `config.json` (`regions`, `meshes`, or `bones`) and ensure both members and at least one rear slot in `behind_slots` draw in consistent order at setup and on every turn pose (or idle frame) so `motion_opened` can transport setup-overlap cells, or — when the pair is not a turn-tracked overlap seam — omit `behind_seams.turn` (or the pair's threshold in `requirements.json` `behind_seams`; issue #1412). For any other detail, supply the named measurement evidence in `parts/<part>.png`, `config.json` or `requirements.json` `behind_seams`; an invalid selected-pair override in `requirements.json` `behind_seams.pairs[]` also refuses by name, and existing renderer or sidecar refusals remain refusals |
6401
6416
  | <a id="SETUP_PAINTING_REQUIRED_LIMIT"></a>`SETUP_PAINTING_REQUIRED_LIMIT` | `setup_painting.required` is `true` and a limit the check needs is absent: `rgb_tolerance`, `regions`, or a region's `max_pixels` (the object names the region). Refused when the requirements file is read, before anything is built (issue #943) | author the named limit; none is derived from the art. Without `required` the same region reports SKIP |
6402
6417
  | <a id="CHECK_SOURCE_GRID"></a>`CHECK_SOURCE_GRID` | the setup-pose still and its black-tinted twin (the coverage `SETUP_POSE_VS_SOURCE` reads) did not come back on one grid over one opaque background | a rigc problem; report it |
6403
6418
  | <a id="CHECK_RIGC_VERSION"></a>`CHECK_RIGC_VERSION` | `rigc --version` is below 1.4.0, or prints no version: its `render` has no `--geometry`, which `TEXTURE_STRETCH` reads. Refused before anything is built | `bun install` (this package depends on rig-c ^2.20.4), or put a newer `rigc` first on `PATH` |
@@ -6448,7 +6463,8 @@ outside the consumed inputs pending [#1177](https://github.com/rig-c/parts/issue
6448
6463
  | <a id="CHECK_PACK_SHAPE"></a>`CHECK_PACK_SHAPE` | the pack line disagrees with the `--pack-shape` the build was run with — it ends `, shape rect` under `polygon` or `, shape polygon` under `rect`, or it has no shape clause (the 1.5–2.0 form, read as `rect`) under `polygon` | a rigc older than 2.1.0 on `PATH`: rigc 2.0.3 takes `--pack-shape` without a word, packs by rectangles and prints the form with no shape clause, so this refusal is what catches it — `bun install` (this package depends on rig-c ^2.20.4); otherwise a rigc problem, report it with `rigc --version` |
6449
6464
  | <a id="PACK_PAGE_SIZE"></a>`PACK_PAGE_SIZE` | `--page-size` is not a positive integer (e.g. `0`, `-1`, `1.5`, `"abc"` or `""`); the value found and the value required (`a positive integer`) are named, and nothing is built or written | a positive integer in px; rigc's own range and power-of-two rules are enforced by `rigc build --pack` itself |
6450
6465
  | <a id="BUILD_ARTIFACT_PRESENT"></a>`BUILD_ARTIFACT_PRESENT` | the packed build lacks its `.json`, `.atlas` or page | a rigc problem; report it |
6451
- | <a id="BUILD_REQUIREMENTS_CONFLICT"></a>`BUILD_REQUIREMENTS_CONFLICT` | `build --requirements <file>` names a file with other bytes than the one `config.requirements` declares (issue #556): the detail names both, each resolved (the flag against the working directory, the declaration against the config's) with its sha256 — or `no such file`. Refused before assemble writes anything. The same file by both, or a copy of its bytes, is not refused: the declaration is read and recorded | drop the flag to build from the config's file, or point `config.requirements` at the flag's |
6466
+ | <a id="BUILD_REQUIREMENTS_CONFLICT"></a>`BUILD_REQUIREMENTS_CONFLICT` | `build --requirements <file>` (or `assemble --requirements <file>` where requirements reach assembly) names a file that is not the one `config.requirements` declares — not the same resolved file, nor a file with the same bytes (issue #556): the detail names both, each resolved (the flag against the working directory, the declaration against the config's) with its sha256 — or `no such file`. Refused before assemble writes anything. `assemble` raises it too when the flag's file reaches assembly (issue #1418: a region take, or a busy-visible `setup_painting.figure_mask`), and then the detail ends naming that field. The same file by both, or a copy of its bytes, is not refused: the declaration is read and recorded | drop the flag to read the config's file, or point `config.requirements` at the flag's |
6467
+ | <a id="ASSEMBLE_REQUIREMENTS_UNDECLARED"></a>`ASSEMBLE_REQUIREMENTS_UNDECLARED` | `assemble --requirements <file>` or `build --requirements <file>` names a file whose content reaches assembly (a region take reads its `setup_painting.rgb_tolerance`; under `ground: "busy"` with `project: "visible"`, its `setup_painting.figure_mask`) while the config declares no `config.requirements` (issue #1418); `config.requirements` would have to name the same file, the same resolved file or a file with the same bytes. `assembly_config` reads only `config.requirements`, so the stamp could not hold what assemble used. The detail names the file, resolved, its sha256 and the field. Refused before anything is written. A flag file none of whose content reaches assembly is accepted | add the `"requirements"` entry the detail writes out, the file's path relative to the config's directory, to the config the detail names; the flag may stay, naming the same file |
6452
6468
  | <a id="BUILD_STAGE_REQUEST"></a>`BUILD_STAGE_REQUEST` | an internal build worker was given a missing or malformed request, an unknown stage, or incomplete runner, input, output or scratch paths; the worker refuses before running a stage. This is the internal process protocol, not a public command or option | invoke `rig-parts build` with its documented flags; if that command produces this refusal, report the named request defect rather than constructing or modifying a worker request |
6453
6469
  | <a id="REQUIREMENTS_FILE"></a>`REQUIREMENTS_FILE` | `--requirements` names no file, or one that does not parse as a JSON object. Refused before anything is built (by `build`, before assemble) | the path of a `spine-parts-requirements/1` file |
6454
6470
  | <a id="REQUIREMENTS_FIELD"></a>`REQUIREMENTS_FIELD` | a field of the file is missing, of the wrong type, or not one the format reads: `spec`, `fps` (a positive number when supplied, required only when a declared measurement reads the file's sampling rate, with no default), `requirements`, each requirement's `name` (letters, digits, underscores; once each), `kind`, `animation` and its kind's fields — every bar among them (`within_px`, `fraction`, `tolerance`, `least_drive` above 0, `within_degrees` from 0 to 180, `lo_degrees` ≤ `hi_degrees`, `within_ratio` ≥ 1) — and each target's `bone`, `animation` and exactly one of `at` and `keys` (times strictly increasing), and `not_planted`, `not_swinging`, `rises` and `rests` when given (each a non-empty list of part names, each once; no part both in `not_swinging` and in `rises` or `rests`), and `may_fold` when given (a non-empty list of `{ "slot", "animation", "why" }`, every one a non-blank string, each pair once; issue #320), and `pinholes` when given (an object whose one field, `required`, is `true` or `false`; issue #944), `seam_over_motion` when given (the same shape; issue #941), and `boundary_colour` when given (an object whose one field, `max_step_excess`, is an integer from 0 through 255; issue #942), and `motion_seams` when given (an array of `{part, neighbour}`, each an unordered pair of distinct output part names, once per list; issue #1269), and `behind_seams` when given (optional `threshold`, `allowance`, `pairs`, `turn: true`; each pair requires distinct nonempty `part` and `neighbour`, with optional `threshold` and `allowance`; thresholds are integers from 0 through 255, allowances are nonnegative safe integers, and reverse duplicates are invalid; issue #1314). `note`, `*_note` (strings) and `x-…` (any value) are read by nothing, as in the config | write the field; the bar is yours. For a pair read only by `seam_over_motion.required`, declare requirements-level `motion_seams` `[{part, neighbour}]` and omit a seam requirement; this leaves a frozen `parts.json` untouched. `config.motion_seams` remains an assemble-time carrier into `parts.json`. See the [carrier contract](#CONFIG_MOTION_SEAM) and [background over every frame](#background-over-every-frame-issue-941). |
@@ -7726,7 +7742,9 @@ it when the flag is not given: a build with `--requirements reqs.json`, typed fr
7726
7742
  config's directory, and a rebuild from a config declaring `"requirements": "reqs.json"`
7727
7743
  write the same bytes, every file (selftest `BU178`). A flag naming other bytes than the
7728
7744
  declaration is `BUILD_REQUIREMENTS_CONFLICT` (`BU179`); the same file by both, or a copy
7729
- of it, builds what the config alone builds (`BU180`). Without either, no `requirements`
7745
+ of it, builds what the config alone builds (`BU180`). When the file reaches assembly (a
7746
+ region take, or a busy-visible figure mask), `assemble` holds the same rule and refuses
7747
+ a flag the config does not declare (`ASSEMBLE_REQUIREMENTS_UNDECLARED`, selftest `URQ01`–`URQ08`). Without either, no `requirements`
7730
7748
  block is written and no byte moves.
7731
7749
 
7732
7750
  **Which config a build read** (issue #607). `build` records its config in the same
@@ -8333,8 +8351,24 @@ setup, followed by every full min/max corner; duplicate poses occur once.
8333
8351
  For yaw, pitch and body yaw this means six axis endpoints and eight corners.
8334
8352
  Each row names the planned and observed dial locals and observed slider mapped
8335
8353
  times, using independent t=0 reset samples rather than idle time. The turn block records selected pose names, per-pair native
8336
- frames and sampled/read/unmeasured pose counts, and separate standing and
8337
- motion-opened maxima. No sweep or temporal span is claimed. Its stock transported
8354
+ frames and sampled/read/unmeasured pose counts, the `motion_opened` status and
8355
+ maximum count, and the `standing` summary (`status: "SKIP"`, `reason`,
8356
+ `max_px: 0`). Because a turn pose is an independent `t=0` pose and the parts'
8357
+ flat recomposite is not transported to it, turn `standing` is never measured
8358
+ (issue #1412): on each turn pose, `turn.pairs[].frames[].standing` is `SKIP`
8359
+ with zero counts, `box: null`, `samples: []`, no `unread_cells` or
8360
+ `unread_corridors`, and its per-pose `reason`
8361
+ (`"not applicable: motion_opened reads the pair"` when `motion_opened` reads the
8362
+ pair on that pose, or
8363
+ `"turn standing is not measured: turn poses have no recomposite oracle, and the pair's turn reading is motion_opened"`
8364
+ when `motion_opened` cannot read that pose), while `motion_opened` is the turn
8365
+ reading. When a turn pose reads the `motion_opened` `HOLE`
8366
+ (`stock transported setup-overlap support is unavailable on every named turn pose; motion-opened is not measured`),
8367
+ give the pair a setup overlap band in `parts/<part>.png` or `config.json`
8368
+ (`regions`, `meshes`, or `bones`) and keep both members and at least one rear
8369
+ slot drawn in front/behind order across the turn poses so `motion_opened` can
8370
+ transport setup-overlap support, or omit `behind_seams.turn` (or the pair's
8371
+ threshold in `requirements.json`). No sweep or temporal span is claimed. Its stock transported
8338
8372
  setup-overlap evidence is computed separately with the official seam reader;
8339
8373
  the idle's exact stock binding is unchanged. One throwaway rig-c build appends a
8340
8374
  duration-0 animation for each selected pose, retaining the accepted setup,
@@ -8351,8 +8385,8 @@ the original accepted skeleton SHA-256 once. The scratch copy is removed even
8351
8385
  on refusal; without the turn opt-in no copy or extra build is created.
8352
8386
  A missing optional poser is a named HOLE. A missing dial persists turn SKIP and
8353
8387
  its HOLE; an effective T makes it a required-unmeasured failure. Legacy `turn.x`
8354
- has no finite range declaration and stays unread. Unread corridors cannot become
8355
- zero counts. Thresholds and per-pair allowances apply unchanged to turn. A pair
8388
+ has no finite range declaration and stays unread. Per-pair allowances apply
8389
+ unchanged to turn `motion_opened`. A pair
8356
8390
  without its own effective T stays SKIP with a HOLE; another pair's override
8357
8391
  does not make that optional reading fail the turn block.
8358
8392
 
@@ -8372,24 +8406,77 @@ it does not uniquely attribute a defect to one rear slot.
8372
8406
  The two readings are independent:
8373
8407
 
8374
8408
  - `motion_opened` attributes core's stock transported setup-overlap
8375
- `gapCovered` cells to that behind set. Its ordinary all-behind-hidden
8376
- counterfactual must be transparent at the exact seam-cell centre, and setup
8377
- attribution must show A or B covering that material. It uses no one-cell
8378
- floor. A rigidly translated closed pair stays closed; no setup overlap band
8379
- means this half is unmeasured, even when the standing half can read.
8380
- - `standing` scans row and column runs whose combined A/B alpha is below
8381
- 128/255, bracketed immediately by different unambiguous A/B owners. A cell
8382
- counts when the behind set has positive surviving source-over contribution
8383
- and its straight RGB differs from BOTH endpoint neighbours by strictly more
8384
- than the effective T in max-channel distance. Equal-colour antialias ramps
8385
- count zero contrast. Later opaque art contributes no visible rear colour.
8386
- There is no width guess, rest mask or subtraction of setup-visible cells.
8387
- A corridor with an ambiguous endpoint owner stays unread; neither A nor B
8388
- is inferred. Other readable corridors on that frame retain their measured
8389
- cells. A counted total above allowance stays FAIL even when another corridor
8390
- is unread; an unread population cannot turn a measured failure into SKIP.
8391
- With unread corridors and no measured excess, standing is SKIP, never PASS.
8392
- This bracketed-run definition does not certify curved or diagonal openings.
8409
+ `gapCovered` cells to that behind set on every idle frame (and at opted-in
8410
+ turn poses). Its ordinary all-behind-hidden counterfactual must be
8411
+ transparent at the exact seam-cell centre, and setup attribution must show A
8412
+ or B covering that material. It uses no one-cell floor. A rigidly translated
8413
+ closed pair stays closed; no setup overlap band means this half is unmeasured
8414
+ on idle and turn.
8415
+ - `standing` is measured at `setup` against the parts' flat recomposite at their
8416
+ painted positions (issues #1408, #1412); it is not measured on idle frames or
8417
+ turn poses. At `setup`, it
8418
+ scans row and column runs whose combined A/B alpha is below 128/255, bracketed
8419
+ immediately by different unambiguous A/B owners (`1` and `2`), and compares
8420
+ the full setup render at each cell with the parts' flat recomposite
8421
+ (`flatComposite` of `parts.json` and `parts/*.png` over white in `rig.json`
8422
+ slot order, rendered onto the pair's native seam grid) when both are
8423
+ flattened source-over white (`[255, 255, 255]`). A cell is geometric when the
8424
+ behind set has positive surviving source-over contribution; it is raw
8425
+ (`raw_px`) when its straight rear RGB differs from both endpoint neighbours
8426
+ (`d[0] > 0` and `d[1] > 0`) and the full setup render's white-flattened RGB
8427
+ differs from the white-flattened parts' recomposite (`dRecomposite > 0`); it
8428
+ counts (`px`) when both endpoint distances and the recomposite distance
8429
+ strictly exceed the effective threshold T (`d[0] > T`, `d[1] > T` and
8430
+ `dRecomposite > T`, in max-channel distance). A cell outside the recomposite's
8431
+ canvas (`alpha === 0` on the rendered recomposite plate) is not excused
8432
+ (`dRecomposite = Infinity`). Equal-colour antialias ramps count zero contrast,
8433
+ and later opaque art — or any intervening or behind part already visible in
8434
+ the parts' recomposite at their painted positions — contributes zero
8435
+ recomposite difference. On a corridor whose endpoint owner is ambiguous
8436
+ (`0` or `3`) at setup, cells within T of the recomposite (`dRecomposite <= T`)
8437
+ are left out of the unread population, without adding their endpoints to
8438
+ `boundary_cells` (`support`), so a corridor whose cells all match the
8439
+ recomposite within T is not unread; elsewhere they stay geometric (`geometric_px`
8440
+ and `samples`) but cannot count (a threshold at or above the cell's distance
8441
+ to the recomposite removes the cell from the reading altogether; the
8442
+ threshold decides what could count; it does not clear a cell that could, and
8443
+ `allowance` never clears an unread cell). An ambiguous endpoint makes a
8444
+ corridor unread only when at least one of its cells differs from the
8445
+ recomposite by more than T (`dRecomposite > T`). Other readable corridors on
8446
+ that frame retain their measured cells. A counted total above allowance stays
8447
+ FAIL even when another corridor is unread; an unread population cannot turn a
8448
+ measured failure into SKIP. With unread corridors and no measured excess,
8449
+ standing is SKIP, never PASS. Without `--parts` (`parts.json` and
8450
+ `parts/*.png`), setup standing is `SKIP` with
8451
+ `reason: "no --parts manifest was supplied; setup standing compares the setup render with the parts' flat recomposite"`,
8452
+ records a `setup` `unmeasured[]` row, and with an authored T emits
8453
+ [`CHECK_BEHIND_PART_SEAMS_UNMEASURED`](#CHECK_BEHIND_PART_SEAMS_UNMEASURED).
8454
+ On idle frames and opted-in turn poses, `standing` is never measured: where a
8455
+ frame's or pose's `motion_opened` is read, `frames[].standing` reports `SKIP`
8456
+ with `reason: "not applicable: motion_opened reads the pair"`, zero counts,
8457
+ `box: null`, `samples: []`, no unread fields, and no standing problem or
8458
+ unmeasured row; where `motion_opened` cannot be read on an idle frame or turn
8459
+ pose, `frames[].standing` reports `SKIP` with
8460
+ `reason: "idle standing is not measured: idle frames have no recomposite oracle, and the pair's idle reading is motion_opened"`
8461
+ (on idle) or
8462
+ `reason: "turn standing is not measured: turn poses have no recomposite oracle, and the pair's turn reading is motion_opened"`
8463
+ (on turn) while `motion_opened` records its named `HOLE` (and
8464
+ `pairs[].standing` / `turn.pairs[].standing` carry the pair's idle or turn
8465
+ summary reason). This bracketed-run definition does
8466
+ not certify curved or diagonal openings.
8467
+
8468
+ Setup standing in `BEHIND_PART_SEAMS` measures whether the rig's setup pose
8469
+ places a selected front pair A/B away from where its parts were painted in
8470
+ `parts.json` and `parts/*.png`, opening a gap over `behind_slots` that was not
8471
+ in the parts' flat recomposite (`8-apart`). Because its oracle is the parts'
8472
+ flat recomposite at their painted positions rather than the `--source`
8473
+ painting, an intervening third part painted between A and B (`7a`), a distant
8474
+ foot or notch across an open silhouette (`7b`), or a half-alpha rear fringe
8475
+ already present in the parts' flat stack reads zero at setup without needing
8476
+ `--source`, and without failing on differences between the parts and the
8477
+ original painting. Fidelity to the `--source` painting is not setup standing's
8478
+ job: fidelity to the painting is [`SETUP_MATCHES_PAINTING`](#CHECK_SETUP_MATCHES_PAINTING)'s
8479
+ and the `RECOMPOSITE_HOLES` / `parts.json` `recomposite` record's job.
8393
8480
 
8394
8481
  Both readings use core's public `seamGridOf` from `@rig-c/core/seam` and its
8395
8482
  official raster traversal. The full
@@ -8398,31 +8485,44 @@ constraints, physics, environment and viewport; the hidden render does not
8398
8485
  combine `--hide` with `--seam`. A viewport match alone is not a seam-grid proof.
8399
8486
  Cells join by world centre and cell side, never by nearest image pixel.
8400
8487
 
8401
- The report keeps `setup` separate from idle. Setup standing is measured in its
8402
- own right; setup motion-opened is zero by definition only if setup was read.
8403
- Standing is measured independently on every idle frame, including the trough.
8404
- Rows name the pair, declaration provenance, animation, `behind_slots`, grid and
8405
- sampled/read/unmeasured frame counts. Independent `motion_opened` and `standing`
8406
- readings retain per-frame `index`, `time`, `px`, `cell`, `box`, `max_px`, the
8407
- earliest worst hit and contiguous spans. `max_run` is temporal, in frames and
8408
- seconds; `max_spatial_run_cells` is the longest counted horizontal/vertical run,
8409
- with world length equal to cells times cell side. Counts named `px` are seam
8410
- cells; rig-pixel area is count times cell side squared. Geometric rear-visible,
8411
- raw contrast and threshold-filtered counts remain distinct. Overlapping pair
8412
- counts are not a unique whole-rig area.
8488
+ The report keeps `setup` separate from idle. Setup standing lives at
8489
+ `pairs[].setup.standing` (`object: "pair \"<A>|<B>\" setup standing"` on
8490
+ excess); setup motion-opened is zero by definition only if setup was read.
8491
+ `pairs[].standing` describes the idle summary only (`status: "SKIP"` with the
8492
+ applicable idle `reason`), without folding setup into it, so a pair with setup
8493
+ `PASS 0`, `motion_opened` `PASS`, and not-applicable idle standing reads
8494
+ `PASS`. Rows name the pair, declaration provenance, animation, `behind_slots`,
8495
+ grid and sampled/read/unmeasured frame counts. The `motion_opened` reading
8496
+ retains per-frame hits (`index`, `time`, `px`, `cell`, `area`, `box`),
8497
+ `max_px`, the earliest worst hit and contiguous `spans`; the idle `standing`
8498
+ summary (`pairs[].standing`) is always `SKIP` with its `reason`, zero counts,
8499
+ `worst: null`, and empty `frames` and `spans`, and the turn `standing` summary
8500
+ (`turn.pairs[].standing`) is always `SKIP` with its `reason` and `max_px: 0`
8501
+ (while setup standing at `pairs[].setup.standing` retains its measured counts,
8502
+ `box` and `samples`).
8503
+ `max_run` is temporal, in frames and seconds; `max_spatial_run_cells` is the
8504
+ longest counted horizontal/vertical run, with world length equal to cells times
8505
+ cell side. Counts named `px` are seam cells; rig-pixel area is count times cell
8506
+ side squared. Geometric rear-visible, raw contrast and threshold-filtered
8507
+ counts remain distinct. Overlapping pair counts are not a unique whole-rig
8508
+ area.
8413
8509
 
8414
8510
  Issue #1325 adds optional unread-corridor evidence to the per-frame `standing`
8415
- record, both at `BEHIND_PART_SEAMS.pairs[].setup.standing` and at
8416
- `BEHIND_PART_SEAMS.pairs[].frames[].standing`. The fields below are relative to
8417
- that record. They describe bracketed low-alpha runs with an endpoint owner of
8418
- 0 or 3; they do not infer an owner or count those runs as measured contrast.
8419
- The reported cells are the run's interior, excluding its endpoints, whether
8420
- or not rear colour would qualify against T. A cell can be unread on one axis
8421
- and readable on the other; unread evidence does not remove a measured hit.
8511
+ record at `BEHIND_PART_SEAMS.pairs[].setup.standing` (idle `frames[].standing`
8512
+ and turn `turn.pairs[].frames[].standing` are never measured). The fields below
8513
+ are relative to that record. They describe
8514
+ bracketed low-alpha runs with an endpoint owner of 0 or 3 that have at least
8515
+ one cell differing from the parts' recomposite by more than T at setup
8516
+ (`dRecomposite > T`); they do not infer an owner or count those runs as
8517
+ measured contrast. At setup, `unread_corridors[].cells`, `cell_count` and
8518
+ `unread_cells` leave out cells within T of the recomposite (`dRecomposite <= T`)
8519
+ and report the remaining interior cells of the run, excluding its endpoints,
8520
+ whether or not rear colour would qualify against endpoint contrast T. A cell can be unread on one axis and readable on the other; unread
8521
+ evidence does not remove a measured hit.
8422
8522
 
8423
8523
  | Field | Contract |
8424
8524
  | --- | --- |
8425
- | `unread_cells` | Optional positive integer: the number of distinct native grid cells in all unread corridors of this frame. Cross-axis intersections count once; this is not a sum of `cell_count` values or a measured defect count. |
8525
+ | `unread_cells` | Optional positive integer: the number of distinct native grid cells in all unread corridors of this frame (at setup, leaving out cells within T of the parts' recomposite). Cross-axis intersections count once; this is not a sum of `cell_count` values or a measured defect count. |
8426
8526
  | `unread_corridors` | Optional nonempty array. Horizontal corridors come first, in top-to-bottom row and left-to-right run order; vertical corridors follow, in left-to-right column and top-to-bottom run order. |
8427
8527
  | `unread_corridors[].axis` | `horizontal` for a row run, `vertical` for a column run. |
8428
8528
  | `unread_corridors[].endpoints` | Two numeric tuples in spatial order: left/right for horizontal, top/bottom for vertical. They are not reordered into A/B ownership order. Each tuple is `[grid_x, grid_y, world_x, world_y, owner]`. |
@@ -8431,8 +8531,8 @@ and readable on the other; unread evidence does not remove a measured hit.
8431
8531
  | `unread_corridors[].endpoints[][2]` | World-space x coordinate of the endpoint cell centre. |
8432
8532
  | `unread_corridors[].endpoints[][3]` | World-space y coordinate of the endpoint cell centre, y up. |
8433
8533
  | `unread_corridors[].endpoints[][4]` | Observed half-alpha owner code: 0 means neither A nor B reaches 128/255; 1 means only A does; 2 means only B does; 3 means both do. A and B are the selected pair's named members; 0 and 3 are not resolved by guessing. |
8434
- | `unread_corridors[].cells` | Interior native-cell centres as numeric `[world_x, world_y]` tuples, y up, left-to-right or top-to-bottom along the run. A centre may occur in multiple corridors. |
8435
- | `unread_corridors[].cell_count` | The number of interior cells in this corridor, exactly `cells.length`. |
8534
+ | `unread_corridors[].cells` | Interior native-cell centres as numeric `[world_x, world_y]` tuples, y up, left-to-right or top-to-bottom along the run, leaving out cells within T of the parts' recomposite at setup. A centre may occur in multiple corridors. |
8535
+ | `unread_corridors[].cell_count` | The number of reported interior cells in this corridor (at setup, leaving out cells within T of the recomposite), exactly `cells.length`. |
8436
8536
  | `unread_corridors[].row_scope` | `pair`; the corridor observes the selected front pair, not an individual rear slot. |
8437
8537
  | `unread_corridors[].row_kind` | `evidence`, including when the required check fails. |
8438
8538
  | `unread_corridors[].row_subjects` | The two selected part names in producer A/B order. |
@@ -8445,19 +8545,22 @@ unmeasured handling; absence of these optional fields alone does not prove a
8445
8545
  fully read frame.
8446
8546
 
8447
8547
  `sampled_frames`, `read_frames` and `unmeasured_frames` count idle frames only.
8448
- A frame enters `read_frames` only when both halves are available and no standing
8449
- corridor is unread. A partially unread frame remains in `unmeasured_frames`
8450
- even when its measured standing cells already make it FAIL. Setup is reported
8451
- separately and is not counted as an idle frame.
8548
+ An idle frame enters `read_frames` when `motion_opened` is read on that frame;
8549
+ when `motion_opened` is unavailable on that frame, the frame enters
8550
+ `unmeasured_frames` (and on turn poses, `sampled_poses`, `read_poses` and
8551
+ `unmeasured_poses` follow the same `motion_opened` rule; idle and turn
8552
+ `standing` are never measured). Setup is reported
8553
+ separately at `pairs[].setup` and is not counted as an idle frame.
8452
8554
 
8453
8555
  A measured count above the effective allowance is
8454
8556
  [`CHECK_BEHIND_PART_SEAMS`](#CHECK_BEHIND_PART_SEAMS). A pair without an
8455
8557
  effective T reports a nonrequired SKIP and HOLE; missing T alone emits no
8456
8558
  `CHECK_BEHIND_PART_SEAMS_UNMEASURED` problem and cannot establish a behind-part
8457
- PASS. With authored T, missing behind slots, idle, setup, motion support,
8458
- boundary population or verified render/material evidence cannot establish PASS.
8459
- An unavailable reading is SKIP; a partially unread standing reading retains
8460
- any measured FAIL as described above. An unread population reports a HOLE and emits
8559
+ PASS. With authored T, missing behind slots, `--parts` manifest for setup
8560
+ standing's recomposite, idle, setup, motion support, boundary population or
8561
+ verified render/material evidence cannot establish PASS. An unavailable reading
8562
+ is SKIP; a partially unread setup standing reading retains any
8563
+ measured FAIL as described above. An unread population reports a HOLE and emits
8461
8564
  [`CHECK_BEHIND_PART_SEAMS_UNMEASURED`](#CHECK_BEHIND_PART_SEAMS_UNMEASURED),
8462
8565
  making the combined line FAIL. Existing hard render and sidecar failures
8463
8566
  remain named refusals. Setup-only or partial readings cannot establish the
@@ -9539,18 +9642,18 @@ Internal `SeamSupport.drawings` never enters check JSON. Named requirement
9539
9642
  | `ANIMATIONS_DO_NOT_FOLD.declared_not_folding` | `ANIMATIONS_DO_NOT_FOLD.declared_not_folding` | part when the supplied mapping resolves a piece; otherwise rig | finding | resolved piece for e.slot; otherwise [] | [check.ts:3697](../src/check.ts#L3697) |
9540
9643
  | `ANIMATIONS_DO_NOT_FOLD.folding` | `ANIMATIONS_DO_NOT_FOLD.folding` | part when the supplied mapping resolves a piece; otherwise rig | finding when entry === undefined; otherwise evidence | resolved piece for slot; otherwise [] | [check.ts:3659](../src/check.ts#L3659) |
9541
9644
  | `ART_JOINT_DISTANCE.joints` | `ART_JOINT_DISTANCE.joints` | 'rig' | finding when status === 'FAIL'; otherwise evidence | [] | [artjoints.ts:86](../src/artjoints.ts#L86) |
9542
- | `BEHIND_PART_SEAMS.contributors` | `BEHIND_PART_SEAMS.turn.pairs[].frames[].standing.samples[].contributors`; `BEHIND_PART_SEAMS.turn.pairs[].frames[].motion_opened.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].setup.motion_opened.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].setup.standing.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].frames[].motion_opened.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].frames[].standing.samples[].contributors` | 'pair' | evidence | [pair.a, pair.b] | [behindseams.ts:454](../src/behindseams.ts#L454) |
9543
- | `BEHIND_PART_SEAMS.hits` | `BEHIND_PART_SEAMS.pairs[].motion_opened.frames`; `BEHIND_PART_SEAMS.pairs[].standing.frames`; `BEHIND_PART_SEAMS.pairs[].motion_opened.worst`; `BEHIND_PART_SEAMS.pairs[].standing.worst` | 'pair' | finding when r.px > allowance; otherwise evidence | parts | [behindseams.ts:521](../src/behindseams.ts#L521) |
9544
- | `BEHIND_PART_SEAMS.pairs` | `BEHIND_PART_SEAMS.pairs` | 'pair' | finding when failed; otherwise evidence | parts | [behindseams.ts:598](../src/behindseams.ts#L598) |
9645
+ | `BEHIND_PART_SEAMS.contributors` | `BEHIND_PART_SEAMS.turn.pairs[].frames[].standing.samples[].contributors`; `BEHIND_PART_SEAMS.turn.pairs[].frames[].motion_opened.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].setup.motion_opened.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].setup.standing.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].frames[].motion_opened.samples[].contributors`; `BEHIND_PART_SEAMS.pairs[].frames[].standing.samples[].contributors` | 'pair' | evidence | [pair.a, pair.b] | [behindseams.ts:526](../src/behindseams.ts#L526) |
9646
+ | `BEHIND_PART_SEAMS.hits` | `BEHIND_PART_SEAMS.pairs[].motion_opened.frames`; `BEHIND_PART_SEAMS.pairs[].standing.frames`; `BEHIND_PART_SEAMS.pairs[].motion_opened.worst`; `BEHIND_PART_SEAMS.pairs[].standing.worst` | 'pair' | finding when r.px > allowance; otherwise evidence | parts | [behindseams.ts:608](../src/behindseams.ts#L608) |
9647
+ | `BEHIND_PART_SEAMS.pairs` | `BEHIND_PART_SEAMS.pairs` | 'pair' | finding when failed; otherwise evidence | parts | [behindseams.ts:693](../src/behindseams.ts#L693) |
9545
9648
  | `BEHIND_PART_SEAMS.pairs[].frames` | `BEHIND_PART_SEAMS.pairs[].frames` | | | | |
9546
9649
  | `BEHIND_PART_SEAMS.pairs[].setup` | `BEHIND_PART_SEAMS.pairs[].setup` | | | | |
9547
- | `BEHIND_PART_SEAMS.samples` | `BEHIND_PART_SEAMS.turn.pairs[].frames[].standing.samples`; `BEHIND_PART_SEAMS.turn.pairs[].frames[].motion_opened.samples`; `BEHIND_PART_SEAMS.pairs[].setup.motion_opened.samples`; `BEHIND_PART_SEAMS.pairs[].setup.standing.samples`; `BEHIND_PART_SEAMS.pairs[].frames[].motion_opened.samples`; `BEHIND_PART_SEAMS.pairs[].frames[].standing.samples` | 'pair' | evidence | [pair.a, pair.b] | [behindseams.ts:453](../src/behindseams.ts#L453) |
9548
- | `BEHIND_PART_SEAMS.spans` | `BEHIND_PART_SEAMS.pairs[].motion_opened.spans`; `BEHIND_PART_SEAMS.pairs[].standing.spans` | 'pair' | evidence | parts | [behindseams.ts:529](../src/behindseams.ts#L529) |
9549
- | `BEHIND_PART_SEAMS.turn.pairs` | `BEHIND_PART_SEAMS.turn.pairs` | 'pair' | finding when required; otherwise evidence; finding when motion.status === 'FAIL' &#124;&#124; standing.status === 'FAIL' &#124;&#124; threshold !== null && read !== turn.poses.length; otherwise evidence | [pair.a, pair.b]; parts | [behindseams.ts:628](../src/behindseams.ts#L628), [behindseams.ts:670](../src/behindseams.ts#L670) |
9650
+ | `BEHIND_PART_SEAMS.samples` | `BEHIND_PART_SEAMS.turn.pairs[].frames[].standing.samples`; `BEHIND_PART_SEAMS.turn.pairs[].frames[].motion_opened.samples`; `BEHIND_PART_SEAMS.pairs[].setup.motion_opened.samples`; `BEHIND_PART_SEAMS.pairs[].setup.standing.samples`; `BEHIND_PART_SEAMS.pairs[].frames[].motion_opened.samples`; `BEHIND_PART_SEAMS.pairs[].frames[].standing.samples` | 'pair' | evidence | [pair.a, pair.b] | [behindseams.ts:525](../src/behindseams.ts#L525) |
9651
+ | `BEHIND_PART_SEAMS.spans` | `BEHIND_PART_SEAMS.pairs[].motion_opened.spans`; `BEHIND_PART_SEAMS.pairs[].standing.spans` | 'pair' | evidence | parts | [behindseams.ts:616](../src/behindseams.ts#L616) |
9652
+ | `BEHIND_PART_SEAMS.turn.pairs` | `BEHIND_PART_SEAMS.turn.pairs` | 'pair' | finding when required; otherwise evidence; finding when motion.status === 'FAIL' &#124;&#124; standing.status === 'FAIL' &#124;&#124; threshold !== null && read !== turn.poses.length; otherwise evidence | [pair.a, pair.b]; parts | [behindseams.ts:723](../src/behindseams.ts#L723), [behindseams.ts:773](../src/behindseams.ts#L773) |
9550
9653
  | `BEHIND_PART_SEAMS.turn.pairs[].frames` | `BEHIND_PART_SEAMS.turn.pairs[].frames` | | | | |
9551
- | `BEHIND_PART_SEAMS.turn.unmeasured` | `BEHIND_PART_SEAMS.turn.unmeasured` | pair === null ? 'rig' : 'pair' | finding when mandatory; otherwise evidence | pair === null ? [] : [pair.a, pair.b] | [behindseams.ts:620](../src/behindseams.ts#L620) |
9552
- | `BEHIND_PART_SEAMS.unmeasured` | `BEHIND_PART_SEAMS.unmeasured` | pair === null ? 'rig' : 'pair'; 'rig' | finding when required; otherwise evidence; finding | pair === null ? [] : [pair.a, pair.b]; [] | [behindseams.ts:542](../src/behindseams.ts#L542), [behindseams.ts:871](../src/behindseams.ts#L871), [behindseams.ts:903](../src/behindseams.ts#L903) |
9553
- | `BEHIND_PART_SEAMS.unread_corridors` | `BEHIND_PART_SEAMS.turn.pairs[].frames[].standing.unread_corridors`; `BEHIND_PART_SEAMS.pairs[].setup.standing.unread_corridors`; `BEHIND_PART_SEAMS.pairs[].frames[].standing.unread_corridors` | 'pair' | evidence | [pair.a, pair.b] | [behindseams.ts:377](../src/behindseams.ts#L377) |
9654
+ | `BEHIND_PART_SEAMS.turn.unmeasured` | `BEHIND_PART_SEAMS.turn.unmeasured` | pair === null ? 'rig' : 'pair' | finding when mandatory; otherwise evidence | pair === null ? [] : [pair.a, pair.b] | [behindseams.ts:715](../src/behindseams.ts#L715) |
9655
+ | `BEHIND_PART_SEAMS.unmeasured` | `BEHIND_PART_SEAMS.unmeasured` | pair === null ? 'rig' : 'pair'; 'rig' | finding when required; otherwise evidence; finding | pair === null ? [] : [pair.a, pair.b]; [] | [behindseams.ts:629](../src/behindseams.ts#L629), [behindseams.ts:974](../src/behindseams.ts#L974), [behindseams.ts:1022](../src/behindseams.ts#L1022) |
9656
+ | `BEHIND_PART_SEAMS.unread_corridors` | `BEHIND_PART_SEAMS.turn.pairs[].frames[].standing.unread_corridors`; `BEHIND_PART_SEAMS.pairs[].setup.standing.unread_corridors`; `BEHIND_PART_SEAMS.pairs[].frames[].standing.unread_corridors` | 'pair' | evidence | [pair.a, pair.b] | [behindseams.ts:459](../src/behindseams.ts#L459) |
9554
9657
  | `BOUNDARY_COLOUR_STEP.over` | `BOUNDARY_COLOUR_STEP.over` | 'pair' | finding | r.parts | [boundarycolour.ts:221](../src/boundarycolour.ts#L221) |
9555
9658
  | `BOUNDARY_COLOUR_STEP.unmeasured` | `BOUNDARY_COLOUR_STEP.unmeasured` | part when the supplied mapping resolves a piece; otherwise rig | evidence | resolved piece for r.slot; otherwise [] | [boundarycolour.ts:222](../src/boundarycolour.ts#L222) |
9556
9659
  | `CLOTH_SETTLES.rows` | `CLOTH_SETTLES.rows` | 'rig' | finding when speeds.length > 0 && s < speeds.length; otherwise evidence | [] | [check.ts:6144](../src/check.ts#L6144) |
@@ -9574,21 +9677,21 @@ Internal `SeamSupport.drawings` never enters check JSON. Named requirement
9574
9677
  | `SEAM_OVER_RANGE.joints[].poses` | `SEAM_OVER_RANGE.joints[].poses` | 'part' | finding when fail; otherwise evidence | [j.part] | [check.ts:4558](../src/check.ts#L4558) |
9575
9678
  | `SETUP_MATCHES_PAINTING.regions` | `SETUP_MATCHES_PAINTING.regions` | 'rig' | finding when status === 'FAIL'; otherwise evidence | [] | [setuppainting.ts:175](../src/setuppainting.ts#L175) |
9576
9679
  | `SETUP_MATCHES_PAINTING.regions[].slots` | `SETUP_MATCHES_PAINTING.regions[].slots` | part when the supplied mapping resolves a piece; otherwise rig | evidence | resolved piece for slot; otherwise [] | [setuppainting.ts:176](../src/setuppainting.ts#L176) |
9577
- | `STILL_REGIONS_DARK.*.crossing` | `STILL_REGIONS_DARK.*.crossing` | part when the supplied mapping resolves a piece; otherwise rig | finding | resolved piece for sl.name; otherwise [] | [check.ts:9286](../src/check.ts#L9286) |
9578
- | `STILL_REGIONS_DARK.*.still_slots` | `STILL_REGIONS_DARK.*.still_slots` | part when the supplied mapping resolves a piece; otherwise rig | evidence; finding when r.max > tolerance; otherwise evidence | resolved piece for slot; otherwise [] | [check.ts:9272](../src/check.ts#L9272), [check.ts:9277](../src/check.ts#L9277) |
9680
+ | `STILL_REGIONS_DARK.*.crossing` | `STILL_REGIONS_DARK.*.crossing` | part when the supplied mapping resolves a piece; otherwise rig | finding | resolved piece for sl.name; otherwise [] | [check.ts:9288](../src/check.ts#L9288) |
9681
+ | `STILL_REGIONS_DARK.*.still_slots` | `STILL_REGIONS_DARK.*.still_slots` | part when the supplied mapping resolves a piece; otherwise rig | evidence; finding when r.max > tolerance; otherwise evidence | resolved piece for slot; otherwise [] | [check.ts:9274](../src/check.ts#L9274), [check.ts:9279](../src/check.ts#L9279) |
9579
9682
  | `STRESS_OFF_CHAIN.not_read` | `STRESS_OFF_CHAIN.not_read` | 'part' | evidence | [r.part] | [check.ts:4118](../src/check.ts#L4118) |
9580
9683
  | `STRESS_OFF_CHAIN.per_part` | `STRESS_OFF_CHAIN.per_part` | 'part' | finding when poses.some(p => typeof p.reading === 'number' && p.reading > STRESS_RIGID); otherwise evidence | [r.part] | [check.ts:4106](../src/check.ts#L4106) |
9581
9684
  | `STRESS_OFF_CHAIN.per_part[].off_chain` | `STRESS_OFF_CHAIN.per_part[].off_chain` | 'part' | evidence | [r.part] | [check.ts:4106](../src/check.ts#L4106) |
9582
9685
  | `STRESS_OFF_CHAIN.per_part[].poses` | `STRESS_OFF_CHAIN.per_part[].poses` | 'part' | evidence; finding when shown > STRESS_RIGID; otherwise evidence | [r.part] | [check.ts:4074](../src/check.ts#L4074), [check.ts:4092](../src/check.ts#L4092) |
9583
- | `TEXTURE_STRETCH.per_mesh` | `TEXTURE_STRETCH.per_mesh` | part when the supplied mapping resolves a piece; otherwise rig | evidence; finding when severity > TEXTURE_STRETCH_CEILING; otherwise evidence | resolved piece for m.slot; otherwise [] | [check.ts:9936](../src/check.ts#L9936), [check.ts:9946](../src/check.ts#L9946) |
9584
- | `TIP_OVER_ROOT.parts` | `TIP_OVER_ROOT.parts` | 'part' | evidence; finding when !ok && !(!rigid && hanging.onLink && Math.max(c.root, c.tip) < TIP_TRAVEL_FLOOR); otherwise evidence | [p.name] | [check.ts:8661](../src/check.ts#L8661), [check.ts:8666](../src/check.ts#L8666), [check.ts:8687](../src/check.ts#L8687), [check.ts:8698](../src/check.ts#L8698) |
9686
+ | `TEXTURE_STRETCH.per_mesh` | `TEXTURE_STRETCH.per_mesh` | part when the supplied mapping resolves a piece; otherwise rig | evidence; finding when severity > TEXTURE_STRETCH_CEILING; otherwise evidence | resolved piece for m.slot; otherwise [] | [check.ts:9938](../src/check.ts#L9938), [check.ts:9948](../src/check.ts#L9948) |
9687
+ | `TIP_OVER_ROOT.parts` | `TIP_OVER_ROOT.parts` | 'part' | evidence; finding when !ok && !(!rigid && hanging.onLink && Math.max(c.root, c.tip) < TIP_TRAVEL_FLOOR); otherwise evidence | [p.name] | [check.ts:8663](../src/check.ts#L8663), [check.ts:8668](../src/check.ts#L8668), [check.ts:8689](../src/check.ts#L8689), [check.ts:8700](../src/check.ts#L8700) |
9585
9688
  | `WIND_BAND.pairs` | `WIND_BAND.pairs` | 'pair' | finding when !holdsAll; otherwise evidence | [p.a, p.b] | [check.ts:6648](../src/check.ts#L6648) |
9586
9689
  | `WIND_BAND.pairs[].steps` | `WIND_BAND.pairs[].steps` | 'pair' | finding when !s.holds; otherwise evidence | [p.a, p.b] | [check.ts:6659](../src/check.ts#L6659) |
9587
9690
  | `figure_openings.openings` | `figure_openings.openings` | 'pair' | finding | [ps.under, ps.above] | [check.ts:5965](../src/check.ts#L5965) |
9588
- | `loop_physics` | `loop_physics` | 'rig' | evidence | [] | [check.ts:7702](../src/check.ts#L7702) |
9589
- | `requirements.lines.* (bone)` | `requirements.lines.*` | 'rig' | finding when line.status === 'FAIL'; otherwise evidence | [] | [check.ts:8029](../src/check.ts#L8029) |
9590
- | `requirements.lines.* (seam)` | `requirements.lines.*` | 'pair' | finding when line.status === 'FAIL'; otherwise evidence | [r.part, r.neighbour] | [check.ts:8029](../src/check.ts#L8029) |
9591
- | `requirements.lines.* (stretch)` | `requirements.lines.*` | part when the supplied mapping resolves a piece; otherwise rig | finding when line.status === 'FAIL'; otherwise evidence | resolved piece for r.slot; otherwise [] | [check.ts:8029](../src/check.ts#L8029) |
9691
+ | `loop_physics` | `loop_physics` | 'rig' | evidence | [] | [check.ts:7704](../src/check.ts#L7704) |
9692
+ | `requirements.lines.* (bone)` | `requirements.lines.*` | 'rig' | finding when line.status === 'FAIL'; otherwise evidence | [] | [check.ts:8031](../src/check.ts#L8031) |
9693
+ | `requirements.lines.* (seam)` | `requirements.lines.*` | 'pair' | finding when line.status === 'FAIL'; otherwise evidence | [r.part, r.neighbour] | [check.ts:8031](../src/check.ts#L8031) |
9694
+ | `requirements.lines.* (stretch)` | `requirements.lines.*` | part when the supplied mapping resolves a piece; otherwise rig | finding when line.status === 'FAIL'; otherwise evidence | resolved piece for r.slot; otherwise [] | [check.ts:8031](../src/check.ts#L8031) |
9592
9695
  | `seam_cells.frames` | `frames` | 'pair' | evidence | [p.a, p.b] | [check.ts:4849](../src/check.ts#L4849) |
9593
9696
  | `seam_cells.frames[].cells` | `frames[].cells` | part when the supplied mapping resolves a piece; otherwise rig | evidence | resolved piece for cell.setupTop ?? ''; otherwise [] | [check.ts:4809](../src/check.ts#L4809) |
9594
9697
  | `seam_pairs` | `seam_pairs`; `seam_scope.whole_pairs`; `sets.*.seam_pairs`; `sets.*.seam_scope.whole_pairs` | subjects.length === 0 ? 'rig' : subjects.length === 1 ? 'part' : 'pair' | evidence | subjects | [check.ts:2548](../src/check.ts#L2548) |