@rig-c/parts 2.41.0 → 2.42.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/README.md +1 -0
- package/cli.ts +76 -20
- package/docs/AUTHORING.md +323 -53
- package/docs/STABILITY.md +128 -10
- package/package.json +4 -2
- package/src/behindseams.ts +622 -0
- package/src/build.ts +76 -9
- package/src/check.ts +134 -18
- package/src/checkrow.ts +21 -0
- package/src/configrelocation.ts +25 -0
- package/src/configwrite.ts +20 -2
- package/src/depthworkflow.ts +3 -4
- package/src/meshdraft.ts +10 -10
- package/src/remesh.ts +18 -12
- package/src/requirements.ts +30 -4
- package/src/retune.ts +8 -5
- package/src/runstamp.ts +54 -1
- package/tools/configwrite.ts +83 -1
- package/tools/edited-part-cli.ts +61 -0
package/docs/STABILITY.md
CHANGED
|
@@ -242,9 +242,36 @@ also answers to the alias `spine-parts` as long as the install keeps it
|
|
|
242
242
|
`--help` and `--version`. The flags' meanings are `rig-parts --help`'s; their
|
|
243
243
|
defaults are the help's too, and none is guessed from the art.
|
|
244
244
|
|
|
245
|
+
The check diagnostic vocabulary adds the following refusal (issue #1308):
|
|
246
|
+
|
|
247
|
+
- `CHECK_CARRIER_NOT_EXCITED` — the measured root-to-carrier chain, including
|
|
248
|
+
the carrier, is static during idle. Its check output row adds `carrier_chain`
|
|
249
|
+
(a string array in root-to-carrier order) and `measured_driver: "none"`. A
|
|
250
|
+
declared requirement for this cloth to move remains FAIL; it is not relaxed
|
|
251
|
+
to WARNING.
|
|
252
|
+
|
|
253
|
+
Carrier excitation is measured from idle transforms, including inherited and
|
|
254
|
+
physics-driven movement, rather than an authored-key scan. Below-floor
|
|
255
|
+
`UNMEASURED` diagnostics retain actual root and tip travel in rig px, the
|
|
256
|
+
unchanged 0.5 rig px floor, and the additive `measured_driver` field: the nearest
|
|
257
|
+
world-moving bone on the root-to-carrier chain (including the carrier),
|
|
258
|
+
`"none"` when the chain is measured still, or `"unavailable"` for missing or
|
|
259
|
+
unusable geometry. Unknown movement does not establish a static chain. The
|
|
260
|
+
nearest moving bone is an observation, not causal attribution to authored keys.
|
|
261
|
+
The helper reads world-origin span and both affine columns rounded to three
|
|
262
|
+
decimal places, without changing public thresholds.
|
|
263
|
+
The reading stays `UNMEASURED` under the existing SKIP and mixed-line verdict
|
|
264
|
+
policy; it does not automatically make the generic check FAIL. A separately
|
|
265
|
+
declared requirement for measurable movement is not satisfied by that reading.
|
|
266
|
+
Drive the carrier, or remove the requirement for this cloth to move on idle
|
|
267
|
+
when still cloth is intended. These diagnostics change no threshold or gate
|
|
268
|
+
and do not certify visibility. See the
|
|
269
|
+
[carrier excitation diagnostics](AUTHORING.md#CHECK_CARRIER_NOT_EXCITED).
|
|
270
|
+
|
|
245
271
|
<!-- stable:commands -->
|
|
246
272
|
| command | flags |
|
|
247
273
|
| --- | --- |
|
|
274
|
+
| `edited-part` | `--config`, `--part`, `--file`, `--from`, `--editor`; optional `--rig-config` (issue #1328; splice a receipt into explicit full configs, without reassembly) |
|
|
248
275
|
| `diff-components` | `--stack`, `--painting`, `--parts`, `--floor`; optional `--threshold`, `--figure`, `--owners`; exactly one of `--out`, `--verify` (issues #1005, #1291; exhaustive native error inventory, `rig-parts-diff-components/1` by default and `rig-parts-diff-components/2` with `--owners`, and byte-bound reader for both) |
|
|
249
276
|
| `depth-prepare` | `--parts`, `--config`, `--out` (issue #897; separate numeric-depth recipe) |
|
|
250
277
|
| `depth-bind` | `--map`, `--input`, `--part` (issue #1284; exclusive receipt creation from current file bytes) |
|
|
@@ -262,16 +289,16 @@ defaults are the help's too, and none is guessed from the art.
|
|
|
262
289
|
| `propose` | `--parts`, `--source`, `--out`; optional `--compare` or `--from-config` (one of them), `--keypoints`, `--person` and `--wrist-snap` (each with `--keypoints`), `--full`, `--head` (the turn control's depths; not with `--from-config`), `--grid-rule` (`figure` or `part`, the drafted lattice's spacing; not with `--from-config`), `--cloth` (a config whose `cloth` block is the recipe, issue #364; not with `--from-config`), `--write-config` (existing config for an ordinary proposal, issue #356; a new file with `--cloth`, issue #537; not with `--from-config` — additive: without it nothing `propose` writes changes), `--from` (the config the recipe is changed from, only with `--write-config`, issue #571 — additive: without it nothing `--write-config` writes changes), `--only-missing` (only with `--parts` and `--write-config`, not with `--cloth` or `--from-config`, issue #671 — additive: without it nothing `--write-config` writes changes) `--bust-landmarks` (rig-pixel apex_r/apex_l and optional cleavage), or `--no-bust` (non-blank omission reason), one required when drafting a chest-holding torso, both incompatible with `--from-config` |
|
|
263
290
|
| `propose` | `--parts`, `--source`, `--out`, `--full`, `--head`, `--write-config` together: the [neck draft](AUTHORING.md#a-neck-that-moves-on-its-own) for an existing config with `turn.body` and one neck plan row; reassembles under `<out>/rig`, preserves the sampled turn and drafts a rigid neck unit (issue #826) |
|
|
264
291
|
| `compare` | `--left`, `--right`; optional `--map` |
|
|
265
|
-
| `rig` | `--config`, `--parts`, `--out`; optional `--idle-keys` (ctl, direct), `--page-edges` (pot, free), `--pack-shape` (rect, polygon) |
|
|
292
|
+
| `rig` | `--config`, `--parts`, `--out`; optional `--idle-keys` (ctl, direct), `--page-edges` (pot, free), `--pack-shape` (rect, polygon), `--page-size` |
|
|
266
293
|
| `check-parts` | `--parts`, `--out`; optional `--json` |
|
|
267
|
-
| `check` | `--rig`, `--out`; optional `--parts`, `--source`, `--page-edges`, `--pack-shape`, `--requirements`, `--seam-pairs`, `--keep-stills`, `--no-extremes` (issue #829), `--set` or `--all-sets` (issue #454), `--environment` (issue #538, additive), `--wind-band` (issue #590, additive), `--json` (issue #904) |
|
|
294
|
+
| `check` | `--rig`, `--out`; optional `--parts`, `--source`, `--page-edges`, `--pack-shape`, `--page-size`, `--requirements`, `--seam-pairs`, `--keep-stills`, `--no-extremes` (issue #829), `--set` or `--all-sets` (issue #454), `--environment` (issue #538, additive), `--wind-band` (issue #590, additive), `--json` (issue #904) |
|
|
268
295
|
| `loop` | `--frames`, `--out`; optional `--palette` |
|
|
269
|
-
| `build` | `--config`, `--source`, `--full`, `--out`; optional `--head` (as for `assemble`), `--seam`, `--project`, `--page-edges`, `--pack-shape`, `--loop`, `--lead-in`, `--requirements`, `--idle-keys`, `--seam-pairs`, `--keep-stills`, `--no-extremes` (issue #829), `--alt` (as for `assemble`, issue #454), `--set` or `--all-sets` (as for `check`, issue #454), `--environment` (as for `check`, issue #538, additive), `--wind-band` (as for `check`, issue #590, additive) |
|
|
296
|
+
| `build` | `--config`, `--source`, `--full`, `--out`; optional `--head` (as for `assemble`), `--seam`, `--project`, `--page-edges`, `--pack-shape`, `--page-size`, `--loop`, `--lead-in`, `--requirements`, `--idle-keys`, `--seam-pairs`, `--keep-stills`, `--no-extremes` (issue #829), `--alt` (as for `assemble`, issue #454), `--set` or `--all-sets` (as for `check`, issue #454), `--environment` (as for `check`, issue #538, additive), `--wind-band` (as for `check`, issue #590, additive) |
|
|
270
297
|
| `compose` | `--scene`, `--out`; optional `--requirements`, `--accept` |
|
|
271
|
-
| `mesh-draft` | `--config`, `--parts`, `--out`; optional `--requirements`, `--idle-keys` (ctl, direct), `--page-edges` (pot, free), `--pack-shape` (rect, polygon), `--more-triangles` |
|
|
298
|
+
| `mesh-draft` | `--config`, `--parts`, `--out`; optional `--requirements`, `--idle-keys` (ctl, direct), `--page-edges` (pot, free), `--pack-shape` (rect, polygon), `--page-size`, `--more-triangles` |
|
|
272
299
|
| `mesh-stats` | `--config`, `--parts` (issue #566, additive: prints, writes nothing) |
|
|
273
|
-
| `remesh` | `--rig`, `--config`, `--parts`, `--part`, `--out`, and one of `--mesh` or `--delta` (issue #526); optional `--requirements`, `--idle-keys` (ctl, direct), `--page-edges` (pot, free), `--pack-shape` (rect, polygon), `--record-input-check` and `--input-check` (issue #617, additive: without them nothing `remesh` prints or writes changes) |
|
|
274
|
-
| `retune` | `--rig`, `--config`, `--parts`, `--out`; optional `--requirements`, `--idle-keys` (ctl, direct), `--page-edges` (pot, free), `--pack-shape` (rect, polygon), `--record-input-check` and `--input-check` (as for `remesh`, issue #617, additive) |
|
|
300
|
+
| `remesh` | `--rig`, `--config`, `--parts`, `--part`, `--out`, and one of `--mesh` or `--delta` (issue #526); optional `--requirements`, `--idle-keys` (ctl, direct), `--page-edges` (pot, free), `--pack-shape` (rect, polygon), `--page-size`, `--record-input-check` and `--input-check` (issue #617, additive: without them nothing `remesh` prints or writes changes) |
|
|
301
|
+
| `retune` | `--rig`, `--config`, `--parts`, `--out`; optional `--requirements`, `--idle-keys` (ctl, direct), `--page-edges` (pot, free), `--pack-shape` (rect, polygon), `--page-size`, `--record-input-check` and `--input-check` (as for `remesh`, issue #617, additive) |
|
|
275
302
|
| `painting` | one positional path, the painting; `--keypoints`; optional `--person`, `--form` (`standee` or `illustration`, issue #931) |
|
|
276
303
|
| `guide` | one positional argument: a rule name, `§<n>`, `§<n>.<m>` or `§<n>.<m>.<k>` |
|
|
277
304
|
| (none) | `--version`, `--help` |
|
|
@@ -693,7 +720,7 @@ execution in historical evidence is inferred from a current export.
|
|
|
693
720
|
| `parts.json`, `parts/<name>.png` | `assemble`, `build` | one record per part: `from` (`<run>:<tag>` with a See-through v3 tag, `<run>:author:<label>` for a layer the author made — issue #256, read by no role rule — or `painting:<name>` for a patch), `cut_from` on a cut's piece only (the plan part it was cut from, issue #230), `limb` on a limb segment's part only (issue #349: `name`, `segment`, `of`, `bone`, and below a joint `joint`, `range` when the config segment declares one (issue #360), and `cap` — `at`, `width`, `radius`, `box`, `layer_px`, `image_px` with a cap image, `image_layer` after it when that image was a hidden-art layer — issue #359, `<run>:<layer>:hidden` — `missing_px`, `short_px` (`left`, `right`) after it only when `missing_px` is above 0 (issue #557, additive), `excluded_px` after them only on a subset set's limb part whose cap the set exclusion took a pixel of (issue #603, additive: each pixel taken out of the count it was in, so the cap's counts are the written PNG's), then `shape` and `upper_px` under the segment's `cap_shape` — `upper_px` without the shape only when the upper segment gave a pixel (issue #557, additive) — and after them `lower_px`, `lower_kept_px` and `lower_missing_px` under `cap_shape: "ball"` (issue #579, additive), and `edge`, `feather_radius` and `feathered_px` under its `edge`, and `cut_band`, `cut_offset`, `cut_at`, `cut_crossed`, `joint_crossed`, `band_px` and `stroke_luma_max` (when the band has a split) under its `cut_band`, issue #360), the box `x`, `y`, `w`, `h` (rig px), the pixel counts `src/parts.ts` documents (`opaque_px`, `visible_px`, `occluded_px`, `projected_core_px`, `source_px_taken`, `visible_not_projected_px`, `refused_drift_px`, `merged_px` — on a subset set's limb part counted after the set exclusion, issue #603 — `seam_override_px`, and `fringe_pushed_back` when not empty); per-part `taken_layers` (with optional `transport`, issue #973, and optional `split` — `occluder`, `image`, `sha256`, `covered_px`, `visible_px` — on a split take, additive, issue #1242) and `provenance` (`unchanged_layer_px`, `hand_px`, `automatic_px`, `edits`, `automatic`, additive, issue #823); optional top-level `motion_seams`, `occluder_plates` (one record per `assemble.occluders` entry declaring `plate` — `receipt`, `receipt_sha256`, `occluder_sha256`, `painting_sha256`, `output_sha256`, `mask_sha256`, additive, issue #1237), `occluder_grow` (one record per `assemble.occluders` entry with `grow > 0` — `occluder`, `image`, `grow`, `covered_px_before`, `covered_px_after`, additive, issue #1251), `occluder_guard` (one record per `assemble.occluders` entry with `guard > 0` — `occluder`, `image`, `guard`, `guarded_px_before`, `guarded_px_after`, additive, issue #1259), `alternates` and `cut_ownership` (one row per cut, independent of RGBA equality, issue #823, with optional `under_plate` — `receipt`, `receipt_sha256`, `occluder_sha256`, `painting_sha256`, `output_sha256`, `mask_sha256` — on a `{plate}` under, additive, issue #1230); `rig_size`, `scale_rig_per_source`, `ghost_px`, `recomposite`, and `scene` (`figure_alpha_above`, `figure_px`, `figure_mask`) under `config.scene` only, with the figure's mask `figure_rig.png` beside the recomposite (issue #242), and the same bytes beside `parts.json` when the two directories differ (issue #1177); `single_run_pad` (`file_size`, `side`, `left`, `top`) last, only for one run whose file is not the `seethrough.resolution` square (issue #366) |
|
|
694
721
|
| `rig/rig.json`, `rig/motion.json`, `rig/images/` | `rig`, `build`, `compose` | rig-c's rig spec and motion spec, `spec` `rigc-rig/1` and `rigc-motion/1`: the format is rig-c's, and this package writes only what rig-c's parser accepts; a bone carries `inherit` only where config.bones declares one, rig-c's mode name as written (issue #348) |
|
|
695
722
|
| `rig/mesh_report.json` | `rig`, `build` | one row per mesh: `part`, `vertices`, `triangles`, `hull`, `bones` (the sorted names the attachment's weights bind in the written `rig.json`, in every mode — since 1.49.1 (issue #536) a rig with `turn` or `stops` names the twins and `<link>_d` bones there, where the row named the segment bones they replace: a fix of a wrong name, not a format change; a rig with neither writes the bytes it wrote), `max_influences`, `mean_influences`, `art_coverage`, then `grid` (a lattice); or `mode` "explicit" with `image_sha256` and `region_sha256` (the verified guards; counts and coverage are measured from the supplied mesh, no legacy generator report is adopted); `mode` "contour" with `params`, `contour`, `regions` (`params.maxEdge` and `contour.outlineCut` only when the mesh declares `contour.maxEdge`; `params.bridges` and `contour.bridges` — `islands`, `units`, `joins`, and `faint` only when an island was left out as faint — only when it declares `contour.bridges`); or `mode` "influence" with `influence` (as declared), `reach` (`farthest`, `at`, `nearest`, `capped`, `widest`) and `lattice` (rig-c's `SegmentsLatticeReport`: `cols`, `rows`, `artCells`, `keptCells`, `passes`, `islands`) (issue #378); or `mode` "auto" with `settings`, `source`, `result`, `residuals`, `worst_residual`, `worst_region`, `motion_amplitude`, `termination`, `weights`, `regions`, `deformation`, `quality_report` (rig-c's `mesh-quality-report/1` document whole), `motion_report`, and, only when they apply, `stray_cleared` (after `source`, when `source.stray` is declared), `skinning_residual` and `replay` (`AutoMeshReport` in `src/rig.ts`); in every mode, `exponent` when the mesh declares one (after `grid`, or after `mode`); `influences`, as declared, when a lattice or contour mesh declares it (after `exponent`, or where `exponent` would be); `stray` and `stray_cleared` when a lattice mesh declares `stray` (after `influences`, or where `influences` would be); `ribs` when a contour or auto mesh declares them (after `exponent`, or after `mode`), and then `contour.ribs` (`source.contour.ribs` in the automatic mode) |
|
|
696
|
-
| `check/check.json` and the rest of `check/` | `check`, `build`, `compose` | the reference's fields in its order (`gate_spine_html_green`, `rigc_entry`, `pack_mode
|
|
723
|
+
| `check/check.json` and the rest of `check/` | `check`, `build`, `compose` | the reference's fields in its order (`gate_spine_html_green`, `rigc_entry`, `pack_mode` (with `page_size` under `--page-size` only, issue #1273, additive), `environment` after it under `--environment` only (issue #538, additive: `path` as given, `sha256`, `steps`), `loop_max_diff`, the seam figures — `seam_mean`, `seam_px_over_40`, `seam_px_over_80` and, from issue #216, `seam_frame_scale`, the frame scale the bar divides the count by), `loop_physics` after `loop_max_diff` when the rig declares a physics constraint, `seam_border` after the seam figures when `parts.json` declares a scene (issue #242), `seam_pairs` after the seam figures when the seam bar fails or `--seam-pairs` asks (each row's picture under `check/seam/`; `--keep-stills` leaves the setup-pose still and its `frames.json` under `check/setup_still/`), then the judgement lines (`BREATH_VISIBLE`, `BLINK_NO_HOLE`, `CHAIN_LAG`, `TIP_OVER_ROOT`, `STILL_REGIONS_DARK`, `TEXTURE_STRETCH`), `ANIMATIONS_DO_NOT_FOLD` after them when `motion.json` holds an animation, the idle included — on every rig with an idle since issue #333 (issues #320, #363: `status`, `animations`, `fps`, `physics_left_out`, `folding` — each `animation`, `slot`, `attachment`, `frames`, `worst_frame`, `worst_triangles`, `triangles`, `physics_on`, `physics_off`, `physics_constraints`, `declared`, `line` — `folding_undeclared`, `declared_not_folding`, `bar`), `FEET_STAY_LEVEL` after it when a `footwear` part rides a bone that hangs from another and `motion.json` holds an animation (issue #348: `status`, `reason` on a SKIP only, `animations`, `fps`, `physics_left_out`, `bar_degrees`, `bar`, `feet` — each `part`, `bone`, `hangs_from`, `status`, `frames_posed`, `worst`), `LIMB_ONE_BONE` after it (and after `STRESS_OFF_CHAIN` where that is written) when `parts.json` holds a limb segment's part (issue #349: `status`, `parts` — each `part`, `limb`, `bone`, `status`, `others`), `SEAM_OVER_RANGE` after it when a limb record carries a `range` (issue #360: `status`, `frame_scale`, `physics_left_out`, `bar` — `mean`, `rig_px_over_40`, `level` — and `joints`, each `part`, `limb`, `segment`, `joint`, `bone`, `range`, `at`, `radius`, `under_px`, `status`, `poses` — each `degrees`, `status`, `mean`, `px_over_40`, `px_over_80`, `rig_px_over_40`, and `step_px` (`left`, `right`) only on a joint whose cap record carries `short_px` (issue #557, additive) — and `unread` on a joint not read), `SEAM_OVER_MOTION` after it when `parts.json` holds a limb segment or `--requirements` a `seam` (issue #493 retains existing pair warnings; issue #686 gates GAP on proven body-root pairs only (gap-only; mixed ghost remains INFO until rig-c/core#1555 supplies owners): `status` — `WARN`, `CLEAR`, `SKIP` or `FAIL` — `reason` on a SKIP only, `fps`, `floor`, `pairs` — each `pair`, `a`, `b`, `declared`, optional `root` (`limb`, `bone`, `parent`) on a proven body-root pair, and `unread` on a pair not read — `animations`, `warnings`, `rows` — each `pair`, `animation`, `status`, `drawn`, `banded`, `opens`, `px`, `max_px`, `under_floor`, and only on new-root rows stock `gapOpen` plus UNDER-owned `ghostA`/`ghostB` cells selected by resolved per-frame draw order gate their summed count against the unchanged strict one-cell floor on the original raw kind boxes (their union when both kinds contribute), never narrowed partition boxes, while `gapCovered` and OVER-owned ghost cells are excluded (issue #711); `cells` retains partition counts, UNDER owner and counted total, `worst` retains frame/count/cell/box, and `roots` retains status, mode `gap-open+under-ghost`, ghost_owner `resolved-draw-order`, pairs, failed, reason and optional unmeasured bindings; eligible candidates whose valid setup bands are all zero retain a named unmeasured root and SKIP bar, including when no pair is selected; measured root FAIL wins over SKIP, while measured PASS plus an unmeasured root remains SKIP; every eligible body drawing with stock setup `banded > 0` is selected, including both when a parent is shared; issue #708 resolves a body slot on its exact generated turn child to the same named carrier only after unique identity-bone/control/per-part-transform proof, without changing pair identity, setup selection or the direct-carrier path; setup-only observation preserves the authored motion and default drawing, root-free inputs add no setup compile/render, and no animation remains SKIP rather than a measured zero; existing internal pair warnings and their exits are unchanged; issue #941 adds optional `required` only under the requirements file's `seam_over_motion.required: true` — `status` (`PASS` or `FAIL`), `mode` `gap-open`, `bar_px` 0, `pairs` (each `pair`, `class` — `body-root`, `internal-joint` or `explicit` — `frames`, `background_frames`, `max_px`) and `failed` — and with it the key is written even when no pair is declared; issue #591 adds optional `worlds` on physics rigs with readable declared pairs and animations: `default` and `still`, each `wind`, `gravity`, `status` (`REPORTED` or `SKIP`), `reason` on SKIP, `dir` only when rendered (relative to check.json: `seam_motion/default` or `seam_motion/still`, the complete retained render with frames.json and each animation's raw seam.json), and `rows` — pair, animation, status, drawn, banded, `gap` and `ghost`, each `max_px` and `worst` only; worst carries `index`, `px`, `cell`, `box`. Per-frame hits stay in the raw sidecars. These raw reference readings add no bar or warning and leave the custom environment reading unchanged), `CLOTH_SETTLES` after it when the rig declares a physics constraint and has an idle (issue #501, a warning and not a bar: `status` — `WARN` or `CLEAR` — `fps`, `frames`, `duration`, `floor_rig_px_per_s`, `floor`, `levers`, `warnings`, `rows` — each `tip`, `root`, `links`, `point`, `settles_at`, `max_rig_px_per_s`, `min_rig_px_per_s`), `RECOMPOSITE_HOLES` (its first figure `declared_scene` when `parts.json` declares a scene), `SETUP_POSE_VS_SOURCE`, `WIND_BAND` after it under `--wind-band` only (issue #590, additive: `status` `"REPORTED"`, `spec` `"rig-parts-wind-band/1"`, `path` as given, `sha256`, `steady_wind_only` `true`, `gravity` `[0, 1]`, `min`, `max`, `step`, `steps`, `fps`, `animations`, `max_gap`, `max_ghost`, `holds_from`, `holds_to`, `pairs_holding_all`, and `pairs` — each `pair`, `a`, `b`, `holds_all`, `holds_from`, `holds_to`, `first_break_below`, `first_break_above`, `worst_gap`, `worst_ghost`, `steps`), `skipped`, `config` under `build` only (issue #607, additive: `path` as `--config` was typed, `sha256` of the bytes the build read; `check` and `compose` read no config and write none), a `requirements` block under `--requirements` (or `build`'s `config.requirements`) — `file` first from issue #556, additive: `path` as typed or declared, `sha256`, `keys` — and `PASS`; `check/build/skeleton.json`, `.atlas` and `.png` are the packed artifact rig-c writes. Missing stock partitions or resolved owner are named refusals, never zero. No whole-box exemption or consumer compositor remains; internal warnings and reference raw readings are unchanged. |
|
|
697
724
|
| `part_support_domains.json` | `assemble`, `build` | optional `rig-parts-support-domains/1` independent cut masks and unavailable reasons, with per-domain config-entry provenance and parts/PNG/payload digests; additive beside parts.json, whose bytes and PNGs are unchanged. Legacy output may omit it. `PART_SUPPORT_REPORT` reads pairs in the assembly placement frame and Unowned in actual setup, never as an acceptance gate. |
|
|
698
725
|
| `layers.json`, `<index>_<name>.png` | `layers --export` | the wrapper form `layers` reads (issue #359): `width`, `height`, then `layers` — each `name`, `filename`, `left`, `top`, `right`, `bottom`, `depth_median` (the input's own; `null` for a PSD, the manifest's order then being the draw order) — drawn layers in draw order, then the hidden-art layers; a PNG's name is its index and its layer's name, and the manifest, not the file name, says which layer it is |
|
|
699
726
|
| the template `.psd` | `layers --template` | one empty layer per name `templateLayerNames` (`src/layers.ts`) holds, bottom first; the same canvas writes the same bytes |
|
|
@@ -704,10 +731,10 @@ execution in historical evidence is inferred from a current export.
|
|
|
704
731
|
| `config.json`, `mesh_draft.json` | `mesh-draft` | `config.json` is the config read, byte for byte, but for each drafted part's `meshes` entry; `mesh_draft.json` is spec `rig-parts-mesh-draft/1`: `rules`, `lattice_check`, `draft_check`, `figure_overdraw`, and per lattice part `part`, `mode`, `lattice`, `candidate` (with `bridges` — `units`, `joins` of `span` and `area_px2`, `area_px2`, `overdraw`, and `faint` only when an island was left out as faint — only when the candidate is a bridged one, issue #326), `delta` (under `--more-triangles` only), `readings`, `gate` (each line's `reading`, `pass`, `text`, `margin`), `note`; and `not_compared` (issue #307), only when the config holds an `auto`, `contour`, `influence` or `explicit` entry: per such entry, in config order, `part`, `mode` and `note` — the part was neither drafted nor compared, and a config of lattices alone writes no such key |
|
|
705
732
|
| `rig.json`, `motion.json`, `mesh_report.json`, `images/`, `remesh.json` | `remesh` | the input revision's files, `rig.json` and `mesh_report.json` with the part's attachment and row replaced (under `--delta` the row is the input's with its counts, `bones` and influences recomputed and `mode` "delta"), every other file byte for byte; `remesh.json` is spec `rig-parts-remesh/1`: `request` (`part`, `mesh`, `mesh_sha256`, `idle_keys`, `page_edges`, `pack_shape`; under `--delta`, issue #526: `part`, `delta` — the mesh edit as read — `delta_sha256`, `ops`, `applied` — `moved`, `added`, `removed`, `constrained` — `idle_keys`, `page_edges`, `pack_shape`), `versions` (`parts`, `rigc`), `input` (`rig` — `path`, `bytes`, `sha256` per file — `config_sha256`, `parts_json_sha256`), `baseline` (`reproduced`, `not_compared`; under `--delta` `reproduced` holds one sentence: no config is built, the input is the baseline), `target` (`before`, `after`: `vertices`, `triangles`, `hull`), `preserved` (`identical`, `spliced`), `revision` (per file as `input.rig`), `check` (`input`, `revision`: `pass`, `measured`, `not_met`, `skipped`, `physics`, then `line` and `status` — issue #541, additive, the spec stays `rig-parts-remesh/1`: `line` is the last line `check` prints on that tree, byte for byte, and `status` every block's status as that tree's `check.json` records it, by name in the file's order — `gate`, `loop` and `seam` read from their figures, every other block its own `status`, a block the file does not write absent; `scope`) |
|
|
706
733
|
| `rig.json`, `motion.json`, `mesh_report.json`, `images/`, `retune.json` | `retune` | the input revision's files, `rig.json` with `constraints` and `invariants.detached` replaced and `motion.json` with `animations.idle` replaced by the config's build, every other file byte for byte; `retune.json` is spec `rig-parts-retune/1`: `request` (`idle_keys`, `page_edges`, `pack_shape`), `versions` (`parts`, `rigc`), `input` (`rig` — `path`, `bytes`, `sha256` per file — `config_sha256`, `parts_json_sha256`), `held` (`compared`, `not_compared`), `changed` (`constraints` — each `name`, `type`, `fields` — `added`, `removed`, `idle`: `tracks_changed`, `duration` as before and after), `preserved` (`identical`, `spliced`), `revision` (per file as `input.rig`), `check` (`input`, `revision`: `pass`, `measured`, `not_met`, `skipped`, `physics`, then `line` and `status` — issue #541, additive, the spec stays `rig-parts-retune/1`: `line` is the last line `check` prints on that tree, byte for byte, and `status` every block's status as that tree's `check.json` records it, by name in the file's order — `gate`, `loop` and `seam` read from their figures, every other block its own `status`, a block the file does not write absent; `scope`) |
|
|
707
|
-
| `input-check.json` | `remesh --record-input-check`, `retune --record-input-check` | spec `rig-parts-input-check/1` (issue #617, additive): `versions` (`parts`, `rigc` — `rigc --version`'s whole output), `options` (`page_edges`, `pack_shape`, `requirements` — null, or `path` as resolved and `sha256`), `rig` and `parts` (`dir` as resolved, `files` — `path`, `bytes`, `sha256` per file: every file under `--rig`; `parts.json` and every file under `parts/`), `check` (the input's check side as `remesh.json` carries it); `--input-check` reads it back, and either command's serves the other |
|
|
734
|
+
| `input-check.json` | `remesh --record-input-check`, `retune --record-input-check` | spec `rig-parts-input-check/1` (issue #617, additive): `versions` (`parts`, `rigc` — `rigc --version`'s whole output), `options` (`page_edges`, `pack_shape`, `page_size` when `--page-size` is given, `requirements` — null, or `path` as resolved and `sha256`), `rig` and `parts` (`dir` as resolved, `files` — `path`, `bytes`, `sha256` per file: every file under `--rig`; `parts.json` and every file under `parts/`), `check` (the input's check side as `remesh.json` carries it); `--input-check` reads it back, and either command's serves the other |
|
|
708
735
|
| the scene report | `compose` | spec `spine-parts-scene-report/1`; the plate block carries `sha256` of the plate PNG's bytes after `size` (issue #1183, additive under *What "stable" means here*: a new report key in a minor version, so the spec stays `/1`) |
|
|
709
736
|
| `idle.png`, `idle-indexed.png`, `idle.gif` | `loop`, `build --loop` | APNG and GIF encodings of the rendered idle |
|
|
710
|
-
| `run.json` | `rig`, `assemble` | spec `rig-run/1` (issue #1165, additive): `spec`, `package` (`name`, `version`), `command` (`"rig"` or `"assemble"`), `started_at` and `finished_at` (UTC ISO-8601 millisecond timestamps ending in `Z`, read in the CLI layer), `config` (`path` relative to `--out`, `sha256` of the config file on disk), and `outputs` (`path` relative to `--out`, `sha256` of each written output file on disk, sorted by `path` in code-unit order and excluding `run.json` itself); written only after the command's gate is green |
|
|
737
|
+
| `run.json` | `rig`, `assemble` | spec `rig-run/1` (issue #1165, additive): `spec`, `package` (`name`, `version`), `command` (`"rig"` or `"assemble"`), `started_at` and `finished_at` (UTC ISO-8601 millisecond timestamps ending in `Z`, read in the CLI layer), `config` (`path` relative to `--out`, `sha256` of the config file on disk), `inputs` on `assemble` (issue #1316, additive: one `{role, path, sha256}` entry for each of `--source`, `--full` and `--head` that was given, in that order, with `path` relative to the run's cwd and `sha256` of the file or of the directory's `layers.json`), and `outputs` (`path` relative to `--out`, `sha256` of each written output file on disk, sorted by `path` in code-unit order and excluding `run.json` itself); written only after the command's gate is green |
|
|
711
738
|
| the difference inventory (`--out`) | `diff-components` | spec `rig-parts-diff-components/1` by default (issue #1005: `stack`, `painting`, `definition`, `error_px`, `uncovered_error_px`, `components` — each `id`, `px`, `box`, `coverage`, `uncovered_px`, `borders` — and `below_floor`, byte-identical to 2.38.1), and spec `rig-parts-diff-components/2` under `--owners` (issue #1291: adds `owners` — each `{part, px}`, the topmost `parts.json` part above `COVERED_ALPHA` per covered pixel, back to front — before `borders` on every component); `--verify` verifies both `/1` and `/2` reports (with `--owners`, `/2` is required), while a `/1`-only reader (`readDiffComponents(text, input, [DIFF_COMPONENTS_SPEC])`) refuses `/2` by name |
|
|
712
739
|
|
|
713
740
|
Issue #705 pins setup-seam acceptance to one source-relative scale1 union U of the authored stage and all actual drawn base/checked-set still vertices. U is snapped relative to the source origin, including odd-width half phase.
|
|
@@ -832,7 +859,13 @@ after all stage gates pass and all other output files are on disk:
|
|
|
832
859
|
Key order is fixed as shown; `outputs` is sorted by `/`-separated `path` in UTF-16
|
|
833
860
|
code-unit order. Every `path` in `config` and `outputs` is relative to the `--out`
|
|
834
861
|
directory (`../`-prefixed when `--config` sits outside `--out`; never an absolute or
|
|
835
|
-
home path).
|
|
862
|
+
home path). On `assemble`, `inputs` sits between `config` and `outputs` (issue #1316,
|
|
863
|
+
additive): one `{ "role", "path", "sha256" }` entry (keys in that order) for each of
|
|
864
|
+
`--source`, `--full` and `--head` that was given, in the fixed order `source`, `full`,
|
|
865
|
+
`head` (an input not given is absent from the list, never `null` or guessed), with
|
|
866
|
+
`/`-separated `path` relative to the run's working directory and `sha256` of the file
|
|
867
|
+
on disk, or of `<dir>/layers.json` when the input is a directory; `rig` writes no
|
|
868
|
+
`inputs` key. Every `sha256` is computed from the bytes on disk after writing. A refused
|
|
836
869
|
run writes no `run.json`. By default, `started_at` and `finished_at` record wall-clock
|
|
837
870
|
time read in `cli.ts` (`src/` remains pure). With that default, `run.json` is outside
|
|
838
871
|
the byte-for-byte
|
|
@@ -1151,6 +1184,76 @@ original resolution **before** existing Lanczos3 stage resampling. Setup RGBA
|
|
|
1151
1184
|
is composited on the native stage grid. Source readers preserve alpha; the
|
|
1152
1185
|
global RGB-only source helper and checks without this declaration are unchanged.
|
|
1153
1186
|
|
|
1187
|
+
The optional `motion_seams` key in `spine-parts-requirements/1` (issue #1269,
|
|
1188
|
+
additive) is a bar-free array of `{part, neighbour}` declarations. Check reads
|
|
1189
|
+
its union with the manifest's motion seams and existing `seam` requirements,
|
|
1190
|
+
retaining every declaration source and counting unordered pairs once across
|
|
1191
|
+
sources. Each list uses the shared motion-seam validator: malformed entries,
|
|
1192
|
+
self-pairs and duplicate or reversed pairs within a list are `REQUIREMENTS_FIELD`;
|
|
1193
|
+
names absent from the rig or parts manifest are `REQUIREMENTS_RESOLVES`, and a
|
|
1194
|
+
nonempty declaration without parts is `REQUIREMENTS_SEAM`. The checker never
|
|
1195
|
+
writes `parts.json`. Empty lists add no coverage; zero pairs retain the existing
|
|
1196
|
+
required-gate failure bytes. Existing `seam` requirements and `within_px`
|
|
1197
|
+
measurements are unchanged. Config declarations retain their assemble-to-parts
|
|
1198
|
+
route. See [Background over every frame](AUTHORING.md#background-over-every-frame-issue-941).
|
|
1199
|
+
|
|
1200
|
+
The optional `behind_seams` key in `spine-parts-requirements/1` (issue #1314,
|
|
1201
|
+
additive) declares the required `BEHIND_PART_SEAMS` check, independently of the
|
|
1202
|
+
existing requirement kinds and without a new CLI flag. Its optional fields are
|
|
1203
|
+
`threshold`, `allowance` and `pairs`; pair entries require distinct nonempty
|
|
1204
|
+
`part` and `neighbour` names and may override `threshold` and `allowance`.
|
|
1205
|
+
Names must resolve to known parts and an already selected pair; duplicate
|
|
1206
|
+
pairs, including reversed pairs, are invalid. Shape errors use `REQUIREMENTS_FIELD`.
|
|
1207
|
+
An authored threshold T is an integer from 0 through 255; omission has no
|
|
1208
|
+
default, and a pair without either a rig or pair T reports SKIP and a HOLE,
|
|
1209
|
+
never PASS. Allowance is a nonnegative safe integer, defaulting to 0 by the
|
|
1210
|
+
explicit design ruling, with optional per-pair override for both halves.
|
|
1211
|
+
|
|
1212
|
+
Declared readings independently measure motion-opened rear visibility and
|
|
1213
|
+
standing contrasting rear visibility on core's official seam grid, at setup
|
|
1214
|
+
and every idle frame. There is no WARN mode, one-cell floor, rest mask or
|
|
1215
|
+
subtraction of setup-visible cells. `BEHIND_PART_SEAMS` keeps `setup`,
|
|
1216
|
+
`motion_opened` and `standing` separate, names the selected pair and provenance,
|
|
1217
|
+
per-frame `behind_slots`, grid and sampled/read/unmeasured counts, and reports
|
|
1218
|
+
per-frame hits, worst counts, temporal spans and spatial runs. Exceeding the
|
|
1219
|
+
allowance uses `CHECK_BEHIND_PART_SEAMS`; a mandatory unread population uses
|
|
1220
|
+
`CHECK_BEHIND_PART_SEAMS_UNMEASURED`. Missing behind slots, idle, setup,
|
|
1221
|
+
motion support, boundary population or verified render evidence is a HOLE,
|
|
1222
|
+
not a zero PASS. Existing render/sidecar refusals remain refusals. The standing
|
|
1223
|
+
bracketed-run definition does not certify curved or diagonal openings.
|
|
1224
|
+
|
|
1225
|
+
Issue #1325 adds the following optional evidence fields to
|
|
1226
|
+
`BEHIND_PART_SEAMS.pairs[].setup.standing` and
|
|
1227
|
+
`BEHIND_PART_SEAMS.pairs[].frames[].standing` only. Paths in the table are
|
|
1228
|
+
relative to that standing record.
|
|
1229
|
+
|
|
1230
|
+
| Field | Stable meaning |
|
|
1231
|
+
| --- | --- |
|
|
1232
|
+
| `unread_cells` | Distinct native cells in this frame's unread corridors; cross-axis intersections count once. This is an unread population, not a contrast count. |
|
|
1233
|
+
| `unread_corridors` | Nonempty array of ambiguous-endpoint runs, horizontal rows before vertical columns, each in native scan order. |
|
|
1234
|
+
| `unread_corridors[].axis` | `horizontal` or `vertical`. |
|
|
1235
|
+
| `unread_corridors[].endpoints` | Two `[grid_x, grid_y, world_x, world_y, owner]` tuples in left/right or top/bottom order. Grid indices are zero-based, x right and y down; world coordinates are cell centres, y up. Owner codes are 0 for neither A/B reaching half alpha, 1 for A only, 2 for B only and 3 for both; no owner is inferred. |
|
|
1236
|
+
| `unread_corridors[].cells` | Interior world-centre `[x, y]` tuples in run order, excluding endpoints. All corridor cells are reported, without a rear-colour or contrast filter; intersections may repeat across corridors. |
|
|
1237
|
+
| `unread_corridors[].cell_count` | Exactly `cells.length` for that corridor. |
|
|
1238
|
+
| `unread_corridors[].row_scope` | `pair`. |
|
|
1239
|
+
| `unread_corridors[].row_kind` | `evidence`. |
|
|
1240
|
+
| `unread_corridors[].row_subjects` | The two selected part names in producer A/B order. |
|
|
1241
|
+
|
|
1242
|
+
Both fields are omitted when no ambiguous corridor is found, preserving the
|
|
1243
|
+
bytes of fully read frames; no zero or empty-array placeholders are added.
|
|
1244
|
+
`motion_opened` gains no field. Missing optional unread-corridor evidence does
|
|
1245
|
+
not certify other unavailable readings or numeric colour underflow as read.
|
|
1246
|
+
A corridor with an ambiguous endpoint owner remains unread without choosing
|
|
1247
|
+
an A/B owner. Readable corridors retain their measured cells: a standing count
|
|
1248
|
+
above allowance remains FAIL even with unread corridors, while unread
|
|
1249
|
+
corridors without a measured excess leave standing SKIP. Required unread
|
|
1250
|
+
evidence still makes the combined line FAIL. Idle `read_frames` excludes
|
|
1251
|
+
partially unread frames, including those whose measured count already fails;
|
|
1252
|
+
they remain in `unmeasured_frames`. Setup is counted separately.
|
|
1253
|
+
A boundary-colour PASS does not prove seam closure. Without `behind_seams`,
|
|
1254
|
+
existing configurations remain optional and their checks retain their behavior;
|
|
1255
|
+
no behind-part PASS is claimed. See [Behind-part seams](AUTHORING.md#behind-part-seams-issue-1314).
|
|
1256
|
+
|
|
1154
1257
|
The optional `cut_material` block in `--requirements` declares a part, joint,
|
|
1155
1258
|
independent stage-pixel centre, inward axis, reach and continuous bend interval.
|
|
1156
1259
|
`assemble --requirements` and `build --requirements` write source-edge evidence
|
|
@@ -1199,6 +1302,21 @@ moves.
|
|
|
1199
1302
|
|
|
1200
1303
|
### Edited rig-space parts
|
|
1201
1304
|
|
|
1305
|
+
`edited-part` (issue #1328) records `sha256` and `from_sha256` from the
|
|
1306
|
+
supplied PNG bytes and the non-empty `editor` declaration. It replaces the
|
|
1307
|
+
named part's receipt in place or appends one, preserving every other row and
|
|
1308
|
+
unrelated config byte. Both explicit full configs are validated before either
|
|
1309
|
+
destination changes; each must already declare `assemble.edited_parts`. Paths are recorded
|
|
1310
|
+
relative to each config's edited-parts directory. There is no config discovery
|
|
1311
|
+
or reassembly: a wrong same-size `--from` is recorded successfully, then the
|
|
1312
|
+
existing build baseline verifier refuses it with `ASSEMBLE_EDITED_PART_BASELINE`.
|
|
1313
|
+
Writer validation refusals leave both configs unchanged. The shared staged
|
|
1314
|
+
writer validates full configs and their relative sidecars; all configs stage
|
|
1315
|
+
before the shared batch commits, restoring earlier originals on a later commit
|
|
1316
|
+
failure. The command prints shared config-change lines on stderr and one
|
|
1317
|
+
stdout line naming the part, both hashes and the declared editor. Repeated
|
|
1318
|
+
identical receipts preserve bytes and report `unchanged`.
|
|
1319
|
+
|
|
1202
1320
|
The optional `assemble.edited_parts` block (issue #1278, additive) replaces
|
|
1203
1321
|
existing base-plan parts with verified rig-pixel PNG files after all automatic
|
|
1204
1322
|
passes and final restoration. It preserves boxes, names, draw order and
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@rig-c/parts",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.42.0",
|
|
4
4
|
"description": "AI-authored 2D character parts from one anime painting and its See-through layer decomposition: measured parts, weighted-mesh rig specs, verified through rig-c before anything is written. A CLI for agents that cannot see the image.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -40,6 +40,7 @@
|
|
|
40
40
|
"bin/rig-parts.cjs",
|
|
41
41
|
"cli.ts",
|
|
42
42
|
"tools/configwrite.ts",
|
|
43
|
+
"tools/edited-part-cli.ts",
|
|
43
44
|
"tools/build-process.ts",
|
|
44
45
|
"tools/alternate-cli.ts",
|
|
45
46
|
"tools/neck-propose.ts",
|
|
@@ -62,13 +63,14 @@
|
|
|
62
63
|
"check:readme": "bun scripts/readme_policy.ts",
|
|
63
64
|
"selftest:pre": "bun selftest.ts --pre",
|
|
64
65
|
"smoke": "bun scripts/install_smoke.ts",
|
|
66
|
+
"verify:nova": "bun scripts/verify_nova.ts",
|
|
65
67
|
"typecheck": "bunx tsc --noEmit",
|
|
66
68
|
"lint": "bunx eslint .",
|
|
67
69
|
"prepublishOnly": "node scripts/prepublish.cjs"
|
|
68
70
|
},
|
|
69
71
|
"dependencies": {
|
|
70
72
|
"ag-psd": "^31.0.2",
|
|
71
|
-
"@rig-c/core": "3.
|
|
73
|
+
"@rig-c/core": "3.8.0"
|
|
72
74
|
},
|
|
73
75
|
"devDependencies": {
|
|
74
76
|
"@esotericsoftware/spine-core": "4.3.13",
|