spine-parts 2.16.1 → 2.17.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
@@ -7965,3 +7965,97 @@ It does not authenticate a caller's chosen threshold or floor: consumers must
7965
7965
  compare those to their own policy. The report does not choose which components
7966
7966
  a consumer accepts. The named refusals are `DIFF_COMPONENTS_INPUT`,
7967
7967
  `DIFF_COMPONENTS_BINDING` and `DIFF_COMPONENTS_REPORT` in the rule table.
7968
+
7969
+
7970
+ ### Consumer check rows (issue #1089)
7971
+
7972
+ Every object in a row-bearing array in `check.json`, including nested observation
7973
+ arrays and alternate-set seam arrays, carries `row_scope` (`part`, `pair`, `rig`),
7974
+ `row_kind` (`finding`, `evidence`) and `row_subjects` (the named parts, in producer
7975
+ order; empty for rig scope). A pair is not a per-part flag. A bone, chain or
7976
+ authored observation region has rig scope: its name does not identify a part.
7977
+ The producer applies its existing bar or warning predicate; a block FAIL does
7978
+ not turn every row into a finding. Unavailable/unmeasured readings and raw
7979
+ reference readings are evidence. Most unavailable readings explain the gap in
7980
+ an existing reason, unread or unmeasured field, or an enclosing SKIP reason.
7981
+ The exception is `SEAM_OVER_MOTION.required.pairs`: unread or unbanded rows
7982
+ carry no row-level reason; their reason is reported in problems/stdout, with
7983
+ no new JSON key. A measured
7984
+ SKIP such as an art distance without a declared limit remains evidence.
7985
+ `WIND_BAND` pairs that do not hold throughout and steps that do not hold are
7986
+ findings past the declared gap/ghost bars; holding pairs and steps are evidence.
7987
+
7988
+ All six scope/kind combinations occur in the generated CLI fixture. Existing
7989
+ `scope` and `kind` fields keep their meanings and bytes. The document has no
7990
+ top-level spec/version tag to advance; these fields are additive under its
7991
+ existing contract. Removing only the three `row_` fields recovers legacy JSON.
7992
+
7993
+ The table is generated from the actual `checkRow` calls, including their finding
7994
+ predicates, by `bun tools/check_row_reference.ts --write`; the tree suite checks
7995
+ it against the producers and rejects a planted omission. Subjects are explicit
7996
+ in `row_subjects`; existing part/slot, front/back, a/b and parts fields remain
7997
+ unchanged. `seam_scope.whole_pairs` copies the `seam_pairs` producer rows without
7998
+ the picture, and `sets.*` reuses the same seam producers.
7999
+
8000
+ Scalar/string arrays (animations, frame indices, bones, constraint names and
8001
+ formatted chain/lag strings), numeric coordinate tuples, and aggregate blocks
8002
+ are not object rows and retain their shape. Singleton summaries (`worst`,
8003
+ `physics_on/off`, wind breaks, largest hole, viewport, unowned summary and
8004
+ no-reference-art totals) are fields of their parent reading, not independent
8005
+ row collections; they retain their existing shape. Arrays inside these records
8006
+ are still labelled (for example the level worst's `through` and posed joints).
8007
+ Changed drawing identities have rig scope because generated slots need not name a part.
8008
+ Internal `SeamSupport.drawings` never enters check JSON. Named requirement
8009
+ `lines` are the one dictionary of individual rows and are also labelled;
8010
+ `sets` is a dictionary of whole check blocks.
8011
+
8012
+ <!-- check-row-table:begin -->
8013
+ | Row family | row_scope | row_kind | row_subjects (producer expression) | Producer |
8014
+ | --- | --- | --- | --- | --- |
8015
+ | `ANIMATIONS_DO_NOT_FOLD.declared_not_folding` | 'part' | finding | [e.slot] | [check.ts:3479](../src/check.ts#L3479) |
8016
+ | `ANIMATIONS_DO_NOT_FOLD.folding` | 'part' | finding when entry === undefined; otherwise evidence | [slot] | [check.ts:3441](../src/check.ts#L3441) |
8017
+ | `ART_JOINT_DISTANCE.joints` | 'rig' | finding when status === 'FAIL'; otherwise evidence | [] | [artjoints.ts:86](../src/artjoints.ts#L86) |
8018
+ | `BOUNDARY_COLOUR_STEP.over` | 'pair' | finding | r.parts | [boundarycolour.ts:219](../src/boundarycolour.ts#L219) |
8019
+ | `BOUNDARY_COLOUR_STEP.unmeasured` | 'part' | evidence | [r.slot] | [boundarycolour.ts:220](../src/boundarycolour.ts#L220) |
8020
+ | `CLOTH_SETTLES.rows` | 'rig' | finding when speeds.length > 0 && s < speeds.length; otherwise evidence | [] | [check.ts:5764](../src/check.ts#L5764) |
8021
+ | `CUT_JOINT_MATERIAL.rows` | 'part' | finding when r.status === 'FAIL'; otherwise evidence | [r.part] | [cutmaterial.ts:280](../src/cutmaterial.ts#L280) |
8022
+ | `FEET_STAY_LEVEL.feet` | 'part' | finding when row.status === 'FAIL'; otherwise evidence | [row.part] | [check.ts:3680](../src/check.ts#L3680) |
8023
+ | `FEET_STAY_LEVEL.feet[].worst.through` | 'rig' | evidence | [] | [check.ts:3655](../src/check.ts#L3655) |
8024
+ | `LIMB_ONE_BONE.parts` | 'part' | finding when fail; otherwise evidence | [p.name] | [check.ts:3972](../src/check.ts#L3972) |
8025
+ | `PART_SUPPORT_REPORT.pairs` | 'pair' | evidence; finding when length > 0; otherwise evidence | [F.name, B.name] | [coincide.ts:114](../src/coincide.ts#L114), [coincide.ts:130](../src/coincide.ts#L130) |
8026
+ | `PART_SUPPORT_REPORT.raw_pairs` | 'pair' | evidence | [F.name, B.name] | [coincide.ts:110](../src/coincide.ts#L110) |
8027
+ | `PART_SUPPORT_REPORT.unowned.regions` | 'rig' | finding | [] | [coincide.ts:145](../src/coincide.ts#L145) |
8028
+ | `SEAM_OVER_MOTION.pairs` | 'pair' | evidence | [p.a, p.b] | [check.ts:5165](../src/check.ts#L5165) |
8029
+ | `SEAM_OVER_MOTION.required.pairs` | 'pair' | finding when open > 0; otherwise evidence | [p.a, p.b] | [check.ts:4573](../src/check.ts#L4573) |
8030
+ | `SEAM_OVER_MOTION.roots.unmeasured` | 'part' | evidence | [root.part] | [check.ts:5142](../src/check.ts#L5142) |
8031
+ | `SEAM_OVER_MOTION.rows` | 'pair' | finding when p.status === 'read' && opens.length > 0; otherwise evidence; finding when r.status === 'read' && r.opens.length > 0; otherwise evidence | [want.a, want.b]; pairs.filter(p => p.pair === r.pair).flatMap(p => [p.a, p.b]) | [check.ts:5104](../src/check.ts#L5104), [check.ts:5168](../src/check.ts#L5168) |
8032
+ | `SEAM_OVER_MOTION.rows[].cells` | 'pair' | evidence | [want.a, want.b] | [check.ts:5117](../src/check.ts#L5117) |
8033
+ | `SEAM_OVER_MOTION.rows[].joint_contact.reasons` | 'pair' | evidence | [want.a, want.b] | [check.ts:5107](../src/check.ts#L5107) |
8034
+ | `SEAM_OVER_MOTION.rows[].pose_at_worst.joints` | 'rig' | evidence | [] | [motionseampose.ts:53](../src/motionseampose.ts#L53) |
8035
+ | `SEAM_OVER_MOTION.worlds.*.rows` | 'pair' | evidence | [want.a, want.b] | [check.ts:5101](../src/check.ts#L5101) |
8036
+ | `SEAM_OVER_RANGE.joints` | 'part' | evidence; finding when poses.some(p => p.status === 'FAIL'); otherwise evidence | [j.part] | [check.ts:4296](../src/check.ts#L4296), [check.ts:4342](../src/check.ts#L4342) |
8037
+ | `SEAM_OVER_RANGE.joints[].poses` | 'part' | finding when fail; otherwise evidence | [j.part] | [check.ts:4340](../src/check.ts#L4340) |
8038
+ | `SETUP_MATCHES_PAINTING.regions` | 'rig' | finding when status === 'FAIL'; otherwise evidence | [] | [setuppainting.ts:174](../src/setuppainting.ts#L174) |
8039
+ | `SETUP_MATCHES_PAINTING.regions[].slots` | slot === '(uncovered)' ? 'rig' : 'part' | evidence | slot === '(uncovered)' ? [] : [slot] | [setuppainting.ts:175](../src/setuppainting.ts#L175) |
8040
+ | `STILL_REGIONS_DARK.*.crossing` | 'part' | finding | [sl.name] | [check.ts:8704](../src/check.ts#L8704) |
8041
+ | `STILL_REGIONS_DARK.*.still_slots` | 'part' | evidence; finding when r.max > tolerance; otherwise evidence | [slot] | [check.ts:8690](../src/check.ts#L8690), [check.ts:8695](../src/check.ts#L8695) |
8042
+ | `STRESS_OFF_CHAIN.not_read` | 'part' | evidence | [r.part] | [check.ts:3900](../src/check.ts#L3900) |
8043
+ | `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:3888](../src/check.ts#L3888) |
8044
+ | `STRESS_OFF_CHAIN.per_part[].off_chain` | 'part' | evidence | [r.part] | [check.ts:3888](../src/check.ts#L3888) |
8045
+ | `STRESS_OFF_CHAIN.per_part[].poses` | 'part' | evidence; finding when shown > STRESS_RIGID; otherwise evidence | [r.part] | [check.ts:3856](../src/check.ts#L3856), [check.ts:3874](../src/check.ts#L3874) |
8046
+ | `TEXTURE_STRETCH.per_mesh` | 'part' | evidence; finding when severity > TEXTURE_STRETCH_CEILING; otherwise evidence | [m.slot] | [check.ts:9338](../src/check.ts#L9338), [check.ts:9348](../src/check.ts#L9348) |
8047
+ | `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:8120](../src/check.ts#L8120), [check.ts:8125](../src/check.ts#L8125), [check.ts:8146](../src/check.ts#L8146), [check.ts:8157](../src/check.ts#L8157) |
8048
+ | `WIND_BAND.pairs` | 'pair' | finding when !holdsAll; otherwise evidence | [p.a, p.b] | [check.ts:6268](../src/check.ts#L6268) |
8049
+ | `WIND_BAND.pairs[].steps` | 'pair' | finding when !s.holds; otherwise evidence | [p.a, p.b] | [check.ts:6279](../src/check.ts#L6279) |
8050
+ | `figure_openings.openings` | 'pair' | finding | [ps.under, ps.above] | [check.ts:5585](../src/check.ts#L5585) |
8051
+ | `loop_physics` | 'rig' | evidence | [] | [check.ts:7243](../src/check.ts#L7243) |
8052
+ | `requirements.lines.* (bone)` | 'rig' | finding when line.status === 'FAIL'; otherwise evidence | [] | [check.ts:7539](../src/check.ts#L7539) |
8053
+ | `requirements.lines.* (seam)` | 'pair' | finding when line.status === 'FAIL'; otherwise evidence | [r.part, r.neighbour] | [check.ts:7539](../src/check.ts#L7539) |
8054
+ | `requirements.lines.* (stretch)` | 'part' | finding when line.status === 'FAIL'; otherwise evidence | [r.slot] | [check.ts:7539](../src/check.ts#L7539) |
8055
+ | `seam_pairs` | pair[0] === SEAM_NO_ART ? 'rig' : pair[1] === SEAM_NO_ART ? 'part' : 'pair' | evidence | pair.filter(p => p !== SEAM_NO_ART) | [check.ts:2442](../src/check.ts#L2442) |
8056
+ | `seam_scope.changes` | 'rig' | evidence | [] | [check.ts:1921](../src/check.ts#L1921) |
8057
+ | `seam_scope.domain.states` | 'rig' | evidence | [] | [check.ts:2006](../src/check.ts#L2006) |
8058
+ | `seam_scope.pairs` | row.parts[0] === SEAM_NO_ART ? 'rig' : row.parts[1] === SEAM_NO_ART ? 'part' : 'pair' | evidence | row.parts.filter(p => p !== SEAM_NO_ART) | [check.ts:7153](../src/check.ts#L7153) |
8059
+ | `seam_scope.population.pairs` | 'pair' | evidence | row.parts | [check.ts:2377](../src/check.ts#L2377) |
8060
+ | `seam_scope.population.single_art` | 'part' | evidence | [row.part] | [check.ts:2378](../src/check.ts#L2378) |
8061
+ <!-- check-row-table:end -->
package/docs/STABILITY.md CHANGED
@@ -719,3 +719,11 @@ A see-through `--source` with an opaque explicit painting reference was accepted
719
719
  when donor geometry followed the reference and is now refused with
720
720
  `INPUTS_PAINTING_OPAQUE` before the donor is read. The reference remains a colour
721
721
  binding. The donor continues to be bound to the opaque PNG accepted by `inputs`.
722
+
723
+
724
+ The check document's row objects additionally carry `row_scope` (`part`,
725
+ `pair`, `rig`), `row_kind` (`finding`, `evidence`), and `row_subjects` (one part,
726
+ two parts, or an empty list respectively). These are additive; legacy `scope`,
727
+ `kind`, measurements, statuses and exit decisions are unchanged. There is no
728
+ top-level check spec/version tag to bump. See [Consumer check rows](AUTHORING.md#consumer-check-rows-issue-1089)
729
+ for the producer-derived family table and the boundary between rows and summaries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "spine-parts",
3
- "version": "2.16.1",
3
+ "version": "2.17.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": {
package/src/artjoints.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { checkRow } from './checkrow.ts';
1
2
  /** Explicit art-joint measurements on a fixed skeleton (issue #880). */
2
3
  import { refuseIfAny, type Problem } from './errors.ts';
3
4
  import { cropToSpineY } from './coords.ts';
@@ -82,7 +83,7 @@ export function artJointLine(
82
83
  if (!Number.isFinite(distance)) refuseIfAny([{ code: 'CHECK_ART_JOINT_MEASURED', object: `joint "${j.name}" (bone "${j.bone}")`, detail: 'has no finite art-to-setup distance; finite stage-pixel coordinates are required' }]);
83
84
  const status = limit === undefined ? 'SKIP' : distance > limit ? 'FAIL' : 'PASS';
84
85
  if (status === 'FAIL') problems.push({ code: 'CHECK_ART_JOINT_DISTANCE', object: `joint "${j.name}" (bone "${j.bone}")`, detail: `art at [${j.at.join(', ')}] is ${distance} stage px from setup origin [${boneAt.join(', ')}]; distance <= declared fixed_skeleton.within_px ${limit} px is required — correct the art measurement/correspondence if wrong, or supply art aligned to the fixed skeleton; bones are not moved` });
85
- return { name: j.name, bone: j.bone, at: [...j.at] as [number, number], bone_at: boneAt, distance_px: distance, status };
86
+ return { ...checkRow('ART_JOINT_DISTANCE.joints', 'rig', status === 'FAIL', []), name: j.name, bone: j.bone, at: [...j.at] as [number, number], bone_at: boneAt, distance_px: distance, status };
86
87
  });
87
88
  return { status: limit === undefined ? 'SKIP' : joints.some(j => j.status === 'FAIL') ? 'FAIL' : 'PASS', instrument: 'rigc-geometry/1 setup.bones', source: fixed.source, within_px: limit ?? null, joints,
88
89
  ...(limit === undefined ? { reason: 'fixed_skeleton.within_px is absent; distances are measured, no limit is invented and no joint passes' } : {}) };
@@ -1,3 +1,4 @@
1
+ import { checkRow } from './checkrow.ts';
1
2
  /**
2
3
  * Issue #942: the colour step across part boundaries, against the rig's own pieces.
3
4
  *
@@ -215,8 +216,8 @@ export function measureBoundaryColour(api: Api, input: BoundaryColourInput, decl
215
216
  frames: 1 + idle.length,
216
217
  boundary_pairs: boundaryPairs,
217
218
  worst,
218
- over,
219
- unmeasured,
219
+ over: over.map(r => ({ ...r, ...checkRow('BOUNDARY_COLOUR_STEP.over', 'pair', true, r.parts) })),
220
+ unmeasured: unmeasured.map(r => ({ ...r, ...checkRow('BOUNDARY_COLOUR_STEP.unmeasured', 'part', false, [r.slot]) })),
220
221
  alternates: 'not measured',
221
222
  };
222
223
  }
package/src/build.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { withoutCheckRows } from './checkrow.ts';
1
2
  import { readSetupFigureMask } from './setupfiguremask.ts';
2
3
  import { EDGE_RESIDUAL_FILE, edgeResidualLines } from './edgeresidual.ts';
3
4
  import { SUPPORT_DOMAINS_FILE, writeSupportDomains } from './supportdomains.ts';
@@ -1756,7 +1757,7 @@ export function packLines(r: CheckReport): string[] {
1756
1757
 
1757
1758
  function showFigure(v: unknown): string {
1758
1759
  if (Array.isArray(v)) return v.length === 0 ? 'none' : v.map(showFigure).join(' | ');
1759
- if (typeof v === 'object' && v !== null) return Object.entries(v).map(([k, x]) => `${k} ${showFigure(x)}`).join(', ');
1760
+ if (typeof v === 'object' && v !== null) return Object.entries(v).filter(([key]) => !['row_scope', 'row_kind', 'row_subjects'].includes(key)).map(([k, x]) => `${k} ${showFigure(x)}`).join(', ');
1760
1761
  return String(v);
1761
1762
  }
1762
1763
 
@@ -1950,7 +1951,7 @@ export function clothLines(line: ClothLine, plant: { silent?: boolean } = {}): s
1950
1951
 
1951
1952
  /** A requirement's line as the console prints it: its name and status, the reason first when NOT MEASURABLE, then its figures as check.json holds them. */
1952
1953
  export function requirementText(name: string, line: RequirementLine): string {
1953
- const rest = Object.entries(line).filter(([k]) => k !== 'status' && k !== 'reason');
1954
+ const rest = Object.entries(withoutCheckRows(line) as Record<string, unknown>).filter(([k]) => k !== 'status' && k !== 'reason');
1954
1955
  return `${name}: ${line.status} — ${[...(line.status === 'NOT MEASURABLE' ? [String(line.reason)] : []), ...rest.map(([k, v]) => `${k} ${showFigure(v)}`)].join('; ')}`;
1955
1956
  }
1956
1957
 
@@ -1995,7 +1996,7 @@ export function checkStage(input: CheckStageInput, rigc: RigcRunner, bin: string
1995
1996
  );
1996
1997
  if (setFig.seam_scope !== undefined) {
1997
1998
  const scope = setFig.seam_scope;
1998
- log(` seam scope (${setName}): ${scope.mode}, denominator ${scope.denominator_px} base source cells; union ${scope.domain?.viewport.pixelWidth}x${scope.domain?.viewport.pixelHeight}, numerator ${scope.domain?.numerator}; whole canonical ${scope.whole.px_over_40} px over ${SEAM_PX_LEVEL}, mean ${scope.whole.mean}; auto-frame raw ${scope.auto_frame_raw.px_over_40} at scale ${scope.auto_frame_raw.frame_scale} (diagnostic only); effects ${JSON.stringify(scope.effects)}, changes ${JSON.stringify(scope.changes)}${scope.unavailable === undefined ? '' : `; ${JSON.stringify(scope.unavailable)}`}`);
1999
+ log(` seam scope (${setName}): ${scope.mode}, denominator ${scope.denominator_px} base source cells; union ${scope.domain?.viewport.pixelWidth}x${scope.domain?.viewport.pixelHeight}, numerator ${scope.domain?.numerator}; whole canonical ${scope.whole.px_over_40} px over ${SEAM_PX_LEVEL}, mean ${scope.whole.mean}; auto-frame raw ${scope.auto_frame_raw.px_over_40} at scale ${scope.auto_frame_raw.frame_scale} (diagnostic only); effects ${JSON.stringify(scope.effects)}, changes ${JSON.stringify(withoutCheckRows(scope.changes))}${scope.unavailable === undefined ? '' : `; ${JSON.stringify(scope.unavailable)}`}`);
1999
2000
  for (const pair of scope.pairs ?? []) log(` seam inheritance (${setName}): ${JSON.stringify(pair.parts)}, whole ${pair.whole_px_over_40}, affected ${pair.affected_px_over_40}, inherited from base ${pair.inherited_px_over_40} px over ${SEAM_PX_LEVEL}`);
2000
2001
  }
2001
2002
  const setPairs = setFig.seam_pairs ?? [];
package/src/check.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { checkRow } from './checkrow.ts';
1
2
  import { readSetupFigureMask } from './setupfiguremask.ts';
2
3
  import { readSetupBackdrop } from './setupbackdrop.ts';
3
4
  import { COINCIDE_LINE, type SupportReport } from './coincide.ts';
@@ -1917,7 +1918,7 @@ export function seamEffectSelection(base: SeamSupport, selected: SeamSupport): S
1917
1918
  const b = before.find(d => d.scope === scope && d.name === name), a = after.find(d => d.scope === scope && d.name === name);
1918
1919
  const fields = b === undefined ? ['added'] : a === undefined ? ['hidden/removed'] :
1919
1920
  (['identity', 'order', 'geometry', 'art'] as const).filter(k => b[k] !== a[k]);
1920
- if (fields.length > 0) changes.push({ scope, drawing: name, reasons: fields });
1921
+ if (fields.length > 0) changes.push({ ...checkRow('seam_scope.changes', 'rig', false, []), scope, drawing: name, reasons: fields });
1921
1922
  }
1922
1923
  }
1923
1924
  return { mask, cellReasons, reasons, changes };
@@ -2002,7 +2003,7 @@ export function seamStateBounds(build: string, state: string): SeamStateBounds {
2002
2003
  }
2003
2004
  }
2004
2005
  }
2005
- return { state, frames: frames.length, pieces, bounds,
2006
+ return { ...checkRow('seam_scope.domain.states', 'rig', false, []), state, frames: frames.length, pieces, bounds,
2006
2007
  pose_sha256: digest.digest('hex') };
2007
2008
  } catch {
2008
2009
  refuseIfAny([{ code: 'CHECK_SEAM_DOMAIN', object: 'setup seam union state ' + JSON.stringify(state), detail: 'official selected candidate/still drawn-piece bounds are unavailable; no guessed or empty bounds are substituted' }]);
@@ -2373,8 +2374,8 @@ export function createSeamPopulation(parts: readonly PlacedAlpha[], rigSize: rea
2373
2374
  const rows = [...pairs.entries()].sort(([a], [b]) => a - b)
2374
2375
  .flatMap(([, lower]) => [...lower.entries()].sort(([a], [b]) => a - b).map(([, row]) => ({ ...row })));
2375
2376
  return { basis: 'reference-alpha/top-two-of-2x2', measured_sample_px: measured,
2376
- pair_count: rows.length, pairs: rows,
2377
- single_art: [...singles.entries()].sort(([a], [b]) => a - b).map(([, row]) => ({ ...row })),
2377
+ pair_count: rows.length, pairs: rows.map(row => ({ ...row, ...checkRow('seam_scope.population.pairs', 'pair', false, row.parts) })),
2378
+ single_art: [...singles.entries()].sort(([a], [b]) => a - b).map(([, row]) => ({ ...row, ...checkRow('seam_scope.population.single_art', 'part', false, [row.part]) })),
2378
2379
  no_reference_art: { ...noArt } };
2379
2380
  },
2380
2381
  rows: (seam: SeamFigures) => seamPairRowsFrom(seam, parts, rigSize, vp, at),
@@ -2438,7 +2439,7 @@ function seamPairRowsFrom(seam: SeamFigures, parts: readonly PlacedAlpha[], rigS
2438
2439
  const pair: [string, string] = acc.a < 0 ? [name(acc.b), SEAM_NO_ART] : [name(acc.a), name(acc.b)];
2439
2440
  const file = `${String(i + 1).padStart(Math.max(2, width), '0')}_${pair.map((n) => (n === SEAM_NO_ART ? 'no-art' : n)).join('_')}.png`;
2440
2441
  const cut = acc.a >= 0 && parts[acc.a].from === parts[acc.b].from ? { cut: { from: parts[acc.a].from, differing_copies_px: acc.differing } } : {};
2441
- return { row: { parts: pair, px_over_40: acc.over40,
2442
+ return { row: { ...checkRow('seam_pairs', pair[0] === SEAM_NO_ART ? 'rig' : pair[1] === SEAM_NO_ART ? 'part' : 'pair', false, pair.filter(p => p !== SEAM_NO_ART)), parts: pair, px_over_40: acc.over40,
2442
2443
  ...(acc.outside > 0 ? { outside_authored_px: acc.outside } : {}), px_over_80: acc.over80, frame_box: acc.f, rig_box: acc.r, ...cut, picture: `${SEAM_DIR}/${file}` }, pixels: acc.pixels };
2443
2444
  });
2444
2445
  }
@@ -3437,6 +3438,7 @@ export function foldsLine(
3437
3438
  const onlyPhysicsOn = on !== undefined && off === undefined;
3438
3439
  const constraints = onlyPhysicsOn ? meshPhysicsConstraints(rig, slot, attachment, physicsList) : [];
3439
3440
  const row: FoldRow = {
3441
+ ...checkRow('ANIMATIONS_DO_NOT_FOLD.folding', 'part', entry === undefined, [slot]),
3440
3442
  animation: name,
3441
3443
  slot,
3442
3444
  attachment,
@@ -3474,7 +3476,7 @@ export function foldsLine(
3474
3476
  detail: `rigc render --folds at ${fps} fps${physics}${sideClause}: ${r.line}; ${foldBonesText(rig, motion, r.slot, r.attachment, r.worst_frame, worstOf.get(r) ?? [], context)}; no triangle turned over against the setup pose is required — a fold the art means is declared in the --requirements file's may_fold, { "slot": "${r.slot}", "animation": "${r.animation}", "why": … }`,
3475
3477
  });
3476
3478
  }
3477
- const declaredNotFolding = mayFold.filter((e) => !folding.some((r) => r.slot === e.slot && r.animation === e.animation)).map((e) => ({ slot: e.slot, animation: e.animation }));
3479
+ const declaredNotFolding = mayFold.filter((e) => !folding.some((r) => r.slot === e.slot && r.animation === e.animation)).map((e) => ({ ...checkRow('ANIMATIONS_DO_NOT_FOLD.declared_not_folding', 'part', true, [e.slot]), slot: e.slot, animation: e.animation }));
3478
3480
  for (const e of declaredNotFolding) {
3479
3481
  problems.push({
3480
3482
  code: `CHECK_${FOLD_LINE}`,
@@ -3650,7 +3652,7 @@ export function levelLine(feet: readonly LevelFoot[], rig: Record<string, unknow
3650
3652
  if (row.worst !== null && Math.abs(degrees) <= Math.abs(row.worst.degrees)) return;
3651
3653
  const t = track(turned);
3652
3654
  const through: Array<{ bone: string; inherit: string }> = [];
3653
- for (let b: string | null = row.bone; b !== null && b !== turned; b = parentOf(b)) through.push({ bone: b, inherit: inheritOf(b) });
3655
+ for (let b: string | null = row.bone; b !== null && b !== turned; b = parentOf(b)) through.push({ ...checkRow('FEET_STAY_LEVEL.feet[].worst.through', 'rig', false, []), bone: b, inherit: inheritOf(b) });
3654
3656
  row.worst = { animation: r.animation, frame: r.set.frames[i].index, time: t.times[i], degrees, turned, turned_degrees: round6(boneTurn(t.setup, t.frames[i])), through };
3655
3657
  });
3656
3658
  }
@@ -3675,7 +3677,7 @@ export function levelLine(feet: readonly LevelFoot[], rig: Record<string, unknow
3675
3677
  }
3676
3678
  const status: LevelLine['status'] = rows.some((r) => r.status === 'FAIL') ? 'FAIL' : rows.some((r) => r.status === 'PASS') ? 'PASS' : 'SKIP';
3677
3679
  const names = readings.map((r) => r.animation);
3678
- const line: LevelLine = { status, animations: names, fps, physics_left_out: physicsLeftOut, bar_degrees: LEVEL_BAR_DEGREES, bar: LEVEL_BAR_SOURCE, feet: rows };
3680
+ const line: LevelLine = { status, animations: names, fps, physics_left_out: physicsLeftOut, bar_degrees: LEVEL_BAR_DEGREES, bar: LEVEL_BAR_SOURCE, feet: rows.map(row => ({ ...row, ...checkRow('FEET_STAY_LEVEL.feet', 'part', row.status === 'FAIL', [row.part]) })) };
3679
3681
  if (status === 'SKIP') {
3680
3682
  line.reason = `no frame of ${names.map((n) => `"${n}"`).join(', ')} turns a bone above ${rows.map((r) => `"${r.bone}" (which "${r.part}" rides)`).join(', ')}, so no foot was seen while its leg was posed`;
3681
3683
  }
@@ -3851,7 +3853,7 @@ export function stressLine(plan: StressPlan, geometry: (animation: string) => Id
3851
3853
  );
3852
3854
  const seen = m.filter((x) => x.max !== null && x.min !== null);
3853
3855
  if (seen.length === 0) {
3854
- poses.push({ turn, unmeasured: `the "${name}" render shows no mesh on slot "${r.part}"` });
3856
+ poses.push({ ...checkRow('STRESS_OFF_CHAIN.per_part[].poses', 'part', false, [r.part]), turn, unmeasured: `the "${name}" render shows no mesh on slot "${r.part}"` });
3855
3857
  failed = true;
3856
3858
  problems.push({ code: `CHECK_${STRESS_LINE}`, object: `mesh "${r.part}" with "${r.chain[0]}" turned ${turn}°`, detail: `the "${name}" render shows no mesh on slot "${r.part}", so its stretch was not read; a part not read is not a pass` });
3857
3859
  continue;
@@ -3869,7 +3871,7 @@ export function stressLine(plan: StressPlan, geometry: (animation: string) => Id
3869
3871
  }
3870
3872
  const shown = roundStress(reading);
3871
3873
  const a = at as StretchAt;
3872
- poses.push({ turn, reading: shown, worst: { triangle: a.triangle, edge: a.edge, ratio: round3(a.ratio) } });
3874
+ poses.push({ ...checkRow('STRESS_OFF_CHAIN.per_part[].poses', 'part', shown > STRESS_RIGID, [r.part]), turn, reading: shown, worst: { triangle: a.triangle, edge: a.edge, ratio: round3(a.ratio) } });
3873
3875
  if (worst === null || reading > worst.reading) worst = { part: r.part, link: r.chain[0], turn, reading };
3874
3876
  if (shown > STRESS_RIGID) {
3875
3877
  failed = true;
@@ -3883,7 +3885,7 @@ export function stressLine(plan: StressPlan, geometry: (animation: string) => Id
3883
3885
  });
3884
3886
  }
3885
3887
  }
3886
- rows.push({ part: r.part, link: r.chain[0], links: r.chain.length, off_chain: r.off_chain.map((o) => ({ ...o, largest_weight: round3(o.largest_weight) })), poses });
3888
+ rows.push({ ...checkRow('STRESS_OFF_CHAIN.per_part', 'part', poses.some(p => typeof p.reading === 'number' && p.reading > STRESS_RIGID), [r.part]), part: r.part, link: r.chain[0], links: r.chain.length, off_chain: r.off_chain.map((o) => ({ ...o, ...checkRow('STRESS_OFF_CHAIN.per_part[].off_chain', 'part', false, [r.part]), largest_weight: round3(o.largest_weight) })), poses });
3887
3889
  }
3888
3890
  const w = worst as { part: string; link: string; turn: number; reading: number } | null;
3889
3891
  return {
@@ -3895,7 +3897,7 @@ export function stressLine(plan: StressPlan, geometry: (animation: string) => Id
3895
3897
  worst: w === null ? null : { part: w.part, link: w.link, turn: w.turn },
3896
3898
  bar: STRESS_RIGID,
3897
3899
  per_part: rows,
3898
- not_read: plan.notRead,
3900
+ not_read: plan.notRead.map(r => ({ ...r, ...checkRow('STRESS_OFF_CHAIN.not_read', 'part', false, [r.part]) })),
3899
3901
  };
3900
3902
  }
3901
3903
 
@@ -3967,7 +3969,7 @@ export function limbLine(parts: PartsFile, rig: Record<string, unknown>, problem
3967
3969
  : `is weighted to ${others.map((b) => `"${b}"`).join(', ')} besides "${l.bone}"; a limb part rides its one bone with weight 1 — a bend is a rotation at the joint, never a deformed mesh — so a region on "${l.bone}" (config.regions.${p.name}), or a mesh whose segments name "${l.bone}" alone, is required`,
3968
3970
  });
3969
3971
  }
3970
- return { part: p.name, limb: l.name, bone: l.bone, status: fail ? 'FAIL' : 'PASS', others, ...(regionBones.length === 0 ? {} : { region_bones: regionBones }) };
3972
+ return { ...checkRow('LIMB_ONE_BONE.parts', 'part', fail, [p.name]), part: p.name, limb: l.name, bone: l.bone, status: fail ? 'FAIL' : 'PASS', others, ...(regionBones.length === 0 ? {} : { region_bones: regionBones }) };
3971
3973
  });
3972
3974
  return { status: rows.some((r) => r.status === 'FAIL') ? 'FAIL' : 'PASS', parts: rows };
3973
3975
  }
@@ -4291,7 +4293,7 @@ export function sweepLine(
4291
4293
  const why = unread[i];
4292
4294
  if (why !== null) {
4293
4295
  problems.push({ code: `CHECK_${SWEEP_LINE}`, object: object(`over its range [${j.range.join(', ')}]`), detail: `is not read: ${why}; a joint not read is not a pass` });
4294
- return { ...head, status: 'FAIL', poses: [], unread: why };
4296
+ return { ...head, ...checkRow('SEAM_OVER_RANGE.joints', 'part', false, [j.part]), status: 'FAIL', poses: [], unread: why };
4295
4297
  }
4296
4298
  const poses: SweepPose[] = sweepAngles(j.range).map((a) => {
4297
4299
  const { under, bare } = frames(sweepAnimationName(j.part, a));
@@ -4335,9 +4337,9 @@ export function sweepLine(
4335
4337
  // Issue #557: the contour step on the bent frame — a reading, recorded only where the cap is short.
4336
4338
  const st = step(j, bare);
4337
4339
  if (st !== null) printed.set(`${j.part} ${a}`, st);
4338
- return { degrees: a, status: fail ? 'FAIL' : 'PASS', mean, px_over_40: f.over40, px_over_80: f.over80, rig_px_over_40: Number(seamRigPxText(f.over40, scale)), ...(st === null || j.short === undefined ? {} : { step_px: st }) };
4340
+ return { ...checkRow('SEAM_OVER_RANGE.joints[].poses', 'part', fail, [j.part]), degrees: a, status: fail ? 'FAIL' : 'PASS', mean, px_over_40: f.over40, px_over_80: f.over80, rig_px_over_40: Number(seamRigPxText(f.over40, scale)), ...(st === null || j.short === undefined ? {} : { step_px: st }) };
4339
4341
  });
4340
- return { ...head, status: poses.some((p) => p.status === 'FAIL') ? 'FAIL' : 'PASS', poses };
4342
+ return { ...head, ...checkRow('SEAM_OVER_RANGE.joints', 'part', poses.some(p => p.status === 'FAIL'), [j.part]), status: poses.some((p) => p.status === 'FAIL') ? 'FAIL' : 'PASS', poses };
4341
4343
  });
4342
4344
  const g = seen.grid;
4343
4345
  return {
@@ -4568,7 +4570,7 @@ export function motionSeamRequired(line: MotionSeamLine, rows: readonly MotionBa
4568
4570
  refuse(`${label} in "${animation}" at frame ${worst.index} (t = ${worst.time}s)`,
4569
4571
  `background on ${r.hits.length} of ${r.frames} frame(s) read ${frameRuns(r.hits.map((h) => h.index))}: found ${worst.px} px (rigc gapOpen cells of ${worst.cell} world units, world box [${worst.box.join(', ')}]) on the worst frame, 0 required; ${why}`);
4570
4572
  }
4571
- out.push({ pair: p.pair, class: cls, frames, background_frames: open, max_px: max });
4573
+ out.push({ ...checkRow('SEAM_OVER_MOTION.required.pairs', 'pair', open > 0, [p.a, p.b]), pair: p.pair, class: cls, frames, background_frames: open, max_px: max });
4572
4574
  }
4573
4575
  const failed = problems.length - before;
4574
4576
  return { status: failed === 0 ? 'PASS' : 'FAIL', mode: 'gap-open', bar_px: 0, pairs: out, failed };
@@ -5096,12 +5098,13 @@ function readSeamRows(dir: string, animations: readonly string[], fps: number, p
5096
5098
  }
5097
5099
  const contact = setup ? undefined : jointContactReading(p.jointContact, want.joints ?? [], set.written ?? set.sampled, at, problems);
5098
5100
  if (contact === null) return;
5099
- worldRows?.push({ pair: want.pair, animation, status: p.status, drawn: p.drawn, banded: p.banded, gap: kinds.gap, ghost: kinds.ghost });
5101
+ worldRows?.push({ ...checkRow('SEAM_OVER_MOTION.worlds.*.rows', 'pair', false, [want.a, want.b]), pair: want.pair, animation, status: p.status, drawn: p.drawn, banded: p.banded, gap: kinds.gap, ghost: kinds.ghost });
5100
5102
  const opens = [...over.keys()].sort((x, y) => x - y);
5101
5103
  rows.push({
5104
+ ...checkRow('SEAM_OVER_MOTION.rows', 'pair', p.status === 'read' && opens.length > 0, [want.a, want.b]),
5102
5105
  pair: want.pair,
5103
5106
  animation,
5104
- ...(setup ? {} : { joint_contact: contact }),
5107
+ ...(setup ? {} : { joint_contact: contact === undefined ? undefined : { ...contact, reasons: contact.reasons.map(r => ({ ...r, ...checkRow('SEAM_OVER_MOTION.rows[].joint_contact.reasons', 'pair', false, [want.a, want.b]) })) } }),
5105
5108
  status: p.status,
5106
5109
  drawn: p.drawn,
5107
5110
  banded: p.banded,
@@ -5111,7 +5114,7 @@ function readSeamRows(dir: string, animations: readonly string[], fps: number, p
5111
5114
  under_floor: (want.root === undefined ? p.opens : [...rootFrames].filter(f => cells.some(c => c.index === f && c.counted > 0))).filter((f) => !over.has(f)),
5112
5115
  ...(rootWorst === undefined ? {} : { worst: rootWorst }),
5113
5116
  ...(warnWorst === undefined || setup ? {} : { worst: warnWorst }),
5114
- ...(want.root === undefined ? {} : { cells }),
5117
+ ...(want.root === undefined ? {} : { cells: cells.map(r => ({ ...r, ...checkRow('SEAM_OVER_MOTION.rows[].cells', 'pair', false, [want.a, want.b]) })) }),
5115
5118
  });
5116
5119
  });
5117
5120
  }
@@ -5136,7 +5139,7 @@ export function motionSeamLine(pairs: MotionSeamPair[], animations: string[], fp
5136
5139
  const row = rows.find(r => r.pair === p.pair && r.animation === a);
5137
5140
  return row?.status === 'read' && row.banded > 0 ? [] : ['"' + p.pair + '" in "' + a + '": ' + (p.unread ?? (row === undefined ? 'no returned reading' : 'no band on any frame'))];
5138
5141
  }));
5139
- const unmeasured = unmeasuredRoots.map(root => ({ ...root, candidates: [...root.candidates] }));
5142
+ const unmeasured = unmeasuredRoots.map(root => ({ ...root, ...checkRow('SEAM_OVER_MOTION.roots.unmeasured', 'part', false, [root.part]), candidates: [...root.candidates] }));
5140
5143
  const rootReasons = [...missing, ...unmeasured.map(root => 'root pair for ' + root.limb + ': ' + root.reason)];
5141
5144
  const rootGate: MotionSeamLine['roots'] = roots.length === 0 && unmeasured.length === 0 ? undefined : {
5142
5145
  status: failed.length > 0 ? 'FAIL' : rootReasons.length > 0 || reason !== undefined ? 'SKIP' : 'PASS',
@@ -5159,10 +5162,10 @@ export function motionSeamLine(pairs: MotionSeamPair[], animations: string[], fp
5159
5162
  ...(skipWhy === undefined ? {} : { reason: skipWhy }),
5160
5163
  fps,
5161
5164
  floor: MOTION_SEAM_FLOOR,
5162
- pairs,
5165
+ pairs: pairs.map(p => ({ ...p, ...checkRow('SEAM_OVER_MOTION.pairs', 'pair', false, [p.a, p.b]) })),
5163
5166
  animations,
5164
5167
  warnings,
5165
- rows,
5168
+ rows: rows.map(r => ({ ...r, ...checkRow('SEAM_OVER_MOTION.rows', 'pair', r.status === 'read' && r.opens.length > 0, pairs.filter(p => p.pair === r.pair).flatMap(p => [p.a, p.b])) })),
5166
5169
  ...(rootGate === undefined ? {} : { roots: rootGate }),
5167
5170
  };
5168
5171
  }
@@ -5579,6 +5582,7 @@ export function readFigurePairOpenings(
5579
5582
  for (const ps of pairSetups) {
5580
5583
  if (ps.opens.length > 0) {
5581
5584
  openings.push({
5585
+ ...checkRow('figure_openings.openings', 'pair', true, [ps.under, ps.above]),
5582
5586
  pair: ps.pair,
5583
5587
  under: ps.under,
5584
5588
  above: ps.above,
@@ -5757,6 +5761,7 @@ export function clothRow(chain: { tip: string; root: string; links: number; leng
5757
5761
  let s = speeds.length;
5758
5762
  while (s > 0 && speeds[s - 1] < floor) s--;
5759
5763
  return {
5764
+ ...checkRow('CLOTH_SETTLES.rows', 'rig', speeds.length > 0 && s < speeds.length, []),
5760
5765
  tip: chain.tip,
5761
5766
  root: chain.root,
5762
5767
  links: chain.links,
@@ -6260,6 +6265,7 @@ export function measureWindBand(
6260
6265
  const worstGhost = perStep.reduce((best, s) => (s.ghostPx > best.ghostPx ? s : best), perStep[0]);
6261
6266
 
6262
6267
  return {
6268
+ ...checkRow('WIND_BAND.pairs', 'pair', !holdsAll, [p.a, p.b]),
6263
6269
  pair: p.pair,
6264
6270
  a: p.a,
6265
6271
  b: p.b,
@@ -6270,7 +6276,7 @@ export function measureWindBand(
6270
6276
  first_break_above: span === null ? breakAt(0) : span.end < wb.steps.length - 1 ? breakAt(span.end + 1) : null,
6271
6277
  worst_gap: { x: worstGap.x, px: worstGap.gapPx, animation: worstGap.gapAnim, frame: worstGap.gapFrame },
6272
6278
  worst_ghost: { x: worstGhost.x, px: worstGhost.ghostPx, animation: worstGhost.ghostAnim, frame: worstGhost.ghostFrame },
6273
- steps: perStep.map((s) => ({ x: s.x, holds: s.holds, gap_max_px: s.gapPx, ghost_max_px: s.ghostPx })),
6279
+ steps: perStep.map((s) => ({ ...checkRow('WIND_BAND.pairs[].steps', 'pair', !s.holds, [p.a, p.b]), x: s.x, holds: s.holds, gap_max_px: s.gapPx, ghost_max_px: s.ghostPx })),
6274
6280
  };
6275
6281
  });
6276
6282
 
@@ -7144,7 +7150,7 @@ export function runCheck(rigDir: string, outDir: string, rigc: RigcRunner, parts
7144
7150
  const affected = pixels.filter(q => effects.mask[q] !== 0).length;
7145
7151
  const reasons: Partial<SeamEffects['reasons']> = {};
7146
7152
  for (const q of pixels) { const reason = SEAM_EFFECT_REASONS[effects.cellReasons[q]]; reasons[reason] = (reasons[reason] ?? 0) + 1; }
7147
- return { parts: row.parts, whole_px_over_40: row.px_over_40, affected_px_over_40: affected, inherited_px_over_40: row.px_over_40 - affected, reasons };
7153
+ return { ...checkRow('seam_scope.pairs', row.parts[0] === SEAM_NO_ART ? 'rig' : row.parts[1] === SEAM_NO_ART ? 'part' : 'pair', false, row.parts.filter(p => p !== SEAM_NO_ART)), parts: row.parts, whole_px_over_40: row.px_over_40, affected_px_over_40: affected, inherited_px_over_40: row.px_over_40 - affected, reasons };
7148
7154
  }),
7149
7155
  };
7150
7156
  const altMean = round3(altSeam.mean);
@@ -7234,7 +7240,7 @@ export function runCheck(rigDir: string, outDir: string, rigc: RigcRunner, parts
7234
7240
  pack_mode: { page_edges: mode.pageEdges, pack_shape: mode.packShape },
7235
7241
  ...(env === null ? {} : { environment: env }),
7236
7242
  loop_max_diff: loop === null ? null : loop.max,
7237
- ...(loopPhysics === null ? {} : { loop_physics: loopPhysics }),
7243
+ ...(loopPhysics === null ? {} : { loop_physics: loopPhysics.map(row => ({ ...row, ...checkRow('loop_physics', 'rig', false, []) })) }),
7238
7244
  seam_mean: seam === null ? null : round3(seam.mean),
7239
7245
  seam_px_over_40: seam === null ? null : seam.over40,
7240
7246
  seam_px_over_80: seam === null ? null : seam.over80,
@@ -7530,7 +7536,7 @@ export function measureRequirements(inp: CheckInputs, file: RequirementsFile, bu
7530
7536
  }
7531
7537
  line = { ...followLine(r, d.poses, released.poses, full.poses), released_copy: door ?? 'built as forced: rig-c\'s gate passed it with no further declaration' };
7532
7538
  }
7533
- lines[r.name] = line;
7539
+ lines[r.name] = { ...line, ...(r.kind === 'seam' ? checkRow('requirements.lines.* (seam)', 'pair', line.status === 'FAIL', [r.part, r.neighbour]) : r.kind === 'stretch' ? checkRow('requirements.lines.* (stretch)', 'part', line.status === 'FAIL', [r.slot]) : checkRow('requirements.lines.* (bone)', 'rig', line.status === 'FAIL', [])) };
7534
7540
  const p = requirementProblem(r, line);
7535
7541
  if (p !== null) problems.push(p);
7536
7542
  }
@@ -8111,12 +8117,12 @@ function tipLine(inp: FullInputs, geometryPath: string, frames: number, problems
8111
8117
  let failed = false;
8112
8118
  for (const p of swing) {
8113
8119
  if (excepted.not_swinging.includes(p.name)) {
8114
- rows.push({ part: p.name, unmeasured: "declared not swinging by the scene file's not_swinging, so it is not held to the bar" });
8120
+ rows.push({ ...checkRow('TIP_OVER_ROOT.parts', 'part', false, [p.name]), part: p.name, unmeasured: "declared not swinging by the scene file's not_swinging, so it is not held to the bar" });
8115
8121
  continue;
8116
8122
  }
8117
8123
  // Issue #349: a limb segment is rigid on its one bone and turns at its joint; it does not hang, so no tip trails a root.
8118
8124
  if (p.limb !== undefined) {
8119
- rows.push({ part: p.name, unmeasured: p.limb.band !== undefined ? `a hybrid joint band (config.limbs.${p.limb.name}): it bends between adjacent carriers, does not hang, and is not held to a trailing-tip bar` : `a limb segment (config.limbs.${p.limb.name}), rigid on its one bone "${p.limb.bone}": it turns at its joint and does not hang, so it is not held to the bar` });
8125
+ rows.push({ ...checkRow('TIP_OVER_ROOT.parts', 'part', false, [p.name]), part: p.name, unmeasured: p.limb.band !== undefined ? `a hybrid joint band (config.limbs.${p.limb.name}): it bends between adjacent carriers, does not hang, and is not held to a trailing-tip bar` : `a limb segment (config.limbs.${p.limb.name}), rigid on its one bone "${p.limb.bone}": it turns at its joint and does not hang, so it is not held to the bar` });
8120
8126
  continue;
8121
8127
  }
8122
8128
  const rises = excepted.rises.includes(p.name);
@@ -8137,7 +8143,7 @@ function tipLine(inp: FullInputs, geometryPath: string, frames: number, problems
8137
8143
  const said = { ...(rests ? { declared: 'rests' } : {}), ...(rises ? { tip_half: tipHalf, tip_read: risesRead.get(p.name) as string } : {}) };
8138
8144
  if (w.root === null || w.tip === null || c.root === null || c.tip === null) {
8139
8145
  const half = w.root === null || c.root === null ? rootHalf : tipHalf;
8140
- rows.push({ part: p.name, ...said, unmeasured: shown[0] === null ? 'its slot shows no attachment on idle frame 0' : `on idle frame 0 the ${half} half of its box holds no art its attachment draws` });
8146
+ rows.push({ ...checkRow('TIP_OVER_ROOT.parts', 'part', false, [p.name]), part: p.name, ...said, unmeasured: shown[0] === null ? 'its slot shows no attachment on idle frame 0' : `on idle frame 0 the ${half} half of its box holds no art its attachment draws` });
8141
8147
  continue;
8142
8148
  }
8143
8149
  // Issue #987: a half that does not move against its carrier, read at the line's precision, is 0 and not the
@@ -8148,7 +8154,7 @@ function tipLine(inp: FullInputs, geometryPath: string, frames: number, problems
8148
8154
  // Issue #245: a resting tip is held to the opposite relation — no further than its root, at the line's precision.
8149
8155
  const rigid = t.root === 0 && t.tip === 0;
8150
8156
  const ok = !rigid && (rests ? (ratio === null ? t.tip === 0 : ratio <= TIP_REST_RATIO_CEILING) : ratio === null ? t.tip > 0 : ratio >= TIP_RATIO_FLOOR);
8151
- rows.push({ part: p.name, ...said, hang_from: hang, root_rig_px: round3(t.root), tip_rig_px: round3(t.tip), ratio, world_root_rig_px: round3(w.root), world_tip_rig_px: round3(w.tip), world_ratio: worldRatio });
8157
+ rows.push({ ...checkRow('TIP_OVER_ROOT.parts', 'part', !ok && !(!rigid && hanging.onLink && Math.max(c.root, c.tip) < TIP_TRAVEL_FLOOR), [p.name]), part: p.name, ...said, hang_from: hang, root_rig_px: round3(t.root), tip_rig_px: round3(t.tip), ratio, world_root_rig_px: round3(w.root), world_tip_rig_px: round3(w.tip), world_ratio: worldRatio });
8152
8158
  // Structural 0 / 0 stays a failure before the link-only magnitude policy (issue #994).
8153
8159
  if (!rigid && hanging.onLink && Math.max(c.root, c.tip) < TIP_TRAVEL_FLOOR) {
8154
8160
  belowGrid++;
@@ -8681,12 +8687,12 @@ export function stillLine(inp: FullInputs, idle: FrameSet, geo: IdleGeometry | n
8681
8687
  const tolerance = stillTolerance(coordMax, entryMax);
8682
8688
  for (const { slot, r } of readings) {
8683
8689
  if (r.max === null) {
8684
- rows.push({ slot, unmeasured: 'no idle frame shows it' });
8690
+ rows.push({ ...checkRow('STILL_REGIONS_DARK.*.still_slots', 'part', false, [slot]), slot, unmeasured: 'no idle frame shows it' });
8685
8691
  continue;
8686
8692
  }
8687
8693
  sumSq += r.sumSq;
8688
8694
  weight += r.weight;
8689
- rows.push({ slot, max_rig_px: sig4(r.max), rms_rig_px: sig4(r.weight > 0 ? Math.sqrt(r.sumSq / r.weight) : 0) });
8695
+ rows.push({ ...checkRow('STILL_REGIONS_DARK.*.still_slots', 'part', r.max > tolerance, [slot]), slot, max_rig_px: sig4(r.max), rms_rig_px: sig4(r.weight > 0 ? Math.sqrt(r.sumSq / r.weight) : 0) });
8690
8696
  if (worst === null || r.max > worst.max) worst = { slot, max: r.max, frame: frameIndex(r.frame) };
8691
8697
  if (r.max > tolerance) over.push({ slot, max: r.max, frame: frameIndex(r.frame) as number });
8692
8698
  }
@@ -8695,7 +8701,7 @@ export function stillLine(inp: FullInputs, idle: FrameSet, geo: IdleGeometry | n
8695
8701
  if (still.includes(sl.name) || !record.has(sl.name)) continue;
8696
8702
  const c = crossingOf(artOf(sl.name), inp.stage, shownOf(sl.name), maps, region);
8697
8703
  // Art that only touches the region within the arithmetic's tolerance has not entered it.
8698
- if (c !== null && c.depth > tolerance) crossing.push({ slot: sl.name, depth_rig_px: round3(c.depth), area_rig_px2: round3(c.area), frame: frameIndex(c.frame) });
8704
+ if (c !== null && c.depth > tolerance) crossing.push({ ...checkRow('STILL_REGIONS_DARK.*.crossing', 'part', true, [sl.name]), slot: sl.name, depth_rig_px: round3(c.depth), area_rig_px2: round3(c.area), frame: frameIndex(c.frame) });
8699
8705
  }
8700
8706
  const rms = weight > 0 ? Math.sqrt(sumSq / weight) : 0;
8701
8707
  return {
@@ -9329,7 +9335,7 @@ export function stretchLine(geo: IdleGeometry | null, path: string, problems: Pr
9329
9335
  });
9330
9336
  }
9331
9337
  if (m.max === null || m.min === null) {
9332
- rows.push({ slot: m.slot, triangles: m.triangles, unmeasured: 'no idle frame shows this attachment' });
9338
+ rows.push({ ...checkRow('TEXTURE_STRETCH.per_mesh', 'part', false, [m.slot]), slot: m.slot, triangles: m.triangles, unmeasured: 'no idle frame shows this attachment' });
9333
9339
  continue;
9334
9340
  }
9335
9341
  const sMax = stretchSeverity(m.max.ratio);
@@ -9339,7 +9345,7 @@ export function stretchLine(geo: IdleGeometry | null, path: string, problems: Pr
9339
9345
  if (worst === null || severity > worst.severity) worst = { mesh: m, at, severity };
9340
9346
  maxAll = maxAll === null ? m.max.ratio : Math.max(maxAll, m.max.ratio);
9341
9347
  minAll = minAll === null ? m.min.ratio : Math.min(minAll, m.min.ratio);
9342
- rows.push({ slot: m.slot, triangles: m.triangles, max_ratio: round3(m.max.ratio), max_at: stretchAtText(m.max), min_ratio: round3(m.min.ratio), min_at: stretchAtText(m.min), severity });
9348
+ rows.push({ ...checkRow('TEXTURE_STRETCH.per_mesh', 'part', severity > TEXTURE_STRETCH_CEILING, [m.slot]), slot: m.slot, triangles: m.triangles, max_ratio: round3(m.max.ratio), max_at: stretchAtText(m.max), min_ratio: round3(m.min.ratio), min_at: stretchAtText(m.min), severity });
9343
9349
  if (severity > TEXTURE_STRETCH_CEILING) {
9344
9350
  failed = true;
9345
9351
  const step = bound === undefined ? '' : weightStepText(bound.rig, m.slot, m.attachment, at.edge, bound);
@@ -0,0 +1,23 @@
1
+ /** Additive consumer metadata, assigned where a check row is produced (#1089).
2
+ * The family literal anchors the generated reference table; it is not serialized.
3
+ * Finding is the producer's existing bar/warning decision, never a status guess.
4
+ */
5
+ export type CheckRowScope = 'part' | 'pair' | 'rig';
6
+ export interface CheckRowLabels {
7
+ row_scope: CheckRowScope;
8
+ row_kind: 'finding' | 'evidence';
9
+ /** Actual named parts only; rig observations have no implied part attribution. */
10
+ row_subjects: string[];
11
+ }
12
+ export function checkRow(_family: string, scope: CheckRowScope, finding: boolean, subjects: readonly string[]): CheckRowLabels {
13
+ return { row_scope: scope, row_kind: finding ? 'finding' : 'evidence', row_subjects: [...subjects] };
14
+ }
15
+
16
+ /** Legacy figures for human-readable formatters and compatibility oracles. */
17
+ export function withoutCheckRows(value: unknown): unknown {
18
+ if (Array.isArray(value)) return value.map(withoutCheckRows);
19
+ if (value !== null && typeof value === 'object') return Object.fromEntries(Object.entries(value)
20
+ .filter(([key]) => !['row_scope', 'row_kind', 'row_subjects'].includes(key))
21
+ .map(([key, entry]) => [key, withoutCheckRows(entry)]));
22
+ return value;
23
+ }
package/src/coincide.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { checkRow } from './checkrow.ts';
1
2
  /** Report-only missing support observations on the native setup grid (#998). */
2
3
  import { refuseIfAny } from './errors.ts';
3
4
  import { connectedComponents } from './raster/components.ts';
@@ -106,11 +107,11 @@ export function supportReport(
106
107
  if (x + 1 < width) { rawEdge(p, p + 1, x + 1, y, 0, 1); rawEdge(p + 1, p, x + 1, y, 0, 1); }
107
108
  if (y + 1 < height) { rawEdge(p, p + width, x, y + 1, 1, 0); rawEdge(p + width, p, x, y + 1, 1, 0); }
108
109
  }
109
- if (rawLength > 0 || overlap > 0) raw_pairs.push({ front: F.name, back: B.name,
110
+ if (rawLength > 0 || overlap > 0) raw_pairs.push({ ...checkRow('PART_SUPPORT_REPORT.raw_pairs', 'pair', false, [F.name, B.name]), front: F.name, back: B.name,
110
111
  boundary_length_px: rawLength, box: [rx0, ry0, rx1 - rx0, ry1 - ry0], overlap_area_px: overlap,
111
112
  classification: 'ownership unknown, unclassified' });
112
113
  if (domain === undefined || !('mask' in domain)) {
113
- pairs.push({ front: F.name, back: B.name, status: 'unavailable', reason: `${B.name}: ${domain === undefined ? unavailableReason : domain.reason}`, boundary_length_px: null, box: null, continuation_candidate_area_px: null });
114
+ pairs.push({ ...checkRow('PART_SUPPORT_REPORT.pairs', 'pair', false, [F.name, B.name]), front: F.name, back: B.name, status: 'unavailable', reason: `${B.name}: ${domain === undefined ? unavailableReason : domain.reason}`, boundary_length_px: null, box: null, continuation_candidate_area_px: null });
114
115
  continue;
115
116
  }
116
117
  let length = 0, area = 0, x0 = width, y0 = height, x1 = 0, y1 = 0;
@@ -126,7 +127,7 @@ export function supportReport(
126
127
  if (x + 1 < width) { edge(p, p + 1, x + 1, y, 0, 1); edge(p + 1, p, x + 1, y, 0, 1); }
127
128
  if (y + 1 < height) { edge(p, p + width, x, y + 1, 1, 0); edge(p + width, p, x, y + 1, 1, 0); }
128
129
  }
129
- pairs.push({ front: F.name, back: B.name, status: 'measured', boundary_length_px: length,
130
+ pairs.push({ ...checkRow('PART_SUPPORT_REPORT.pairs', 'pair', length > 0, [F.name, B.name]), front: F.name, back: B.name, status: 'measured', boundary_length_px: length,
130
131
  box: length === 0 ? null : [x0, y0, x1 - x0, y1 - y0], continuation_candidate_area_px: area });
131
132
  }
132
133
  const unowned = unownedSupport(width, height, parts, paintedFigure);
@@ -141,7 +142,7 @@ export function unownedSupport(width: number, height: number, parts: readonly Su
141
142
  if (paintedFigure !== null) {
142
143
  const missing = paintedFigure.data.slice();
143
144
  for (const part of parts) for (let p = 0; p < missing.length; p++) if (part.mask.data[p] !== 0) missing[p] = 0;
144
- const regions = connectedComponents({ width, height, data: missing }, 4).stats.slice(1).map(s => ({ box: [s.left, s.top, s.width, s.height] as SupportBox, area_px: s.area }));
145
+ const regions = connectedComponents({ width, height, data: missing }, 4).stats.slice(1).map(s => ({ ...checkRow('PART_SUPPORT_REPORT.unowned.regions', 'rig', true, []), box: [s.left, s.top, s.width, s.height] as SupportBox, area_px: s.area }));
145
146
  unowned = { status: 'measured', area_px: regions.reduce((sum, r) => sum + r.area_px, 0), regions };
146
147
  }
147
148
  return unowned;
@@ -1,3 +1,4 @@
1
+ import { checkRow } from './checkrow.ts';
1
2
  import { edgeLength } from './length.ts';
2
3
  import { createHash } from 'node:crypto';
3
4
  /** Source support at declared joints (#888). Geometry is in stage pixels, y down.
@@ -276,7 +277,7 @@ export function checkJointMaterial(declarations: readonly JointMaterial[] | unde
276
277
  const read=materialRows(req.part,req,(original as MaterialSource).edges,[],piece);
277
278
  if(read.every(r=>r.rays===0))refuseIfAny([{code:'CHECK_CUT_MATERIAL_MEASURED',object,detail:'no opaque cut interface within declared reach; correct the explicit joint correspondence/reach or supply source material; no PASS is invented'}]);
278
279
  for(const r of read.filter(r=>r.rays>0)){
279
- rows.push(r);
280
+ rows.push({ ...r, ...checkRow('CUT_JOINT_MATERIAL.rows', 'part', r.status === 'FAIL', [r.part]) });
280
281
  if(r.status==='FAIL')problems.push({code:'CHECK_CUT_JOINT_MATERIAL',object,detail:`edge [${r.edge.map(p=>p.join(',')).join(' -> ')}], opaque edge length ${r.edge_length_px} px (${r.within_reach_px} px within reach): material found ${r.found_px} px, required ${r.required_px} px by bend [${req.bend_degrees.join(', ')}] degrees within reach ${req.reach_px} px; source art past the joint is required — follow AUTHORING Source before scissors; no crop or under-piece repair`});
281
282
  }
282
283
  }
@@ -1,3 +1,4 @@
1
+ import { checkRow } from './checkrow.ts';
1
2
  /** Posed-axis evidence from one stock seam render, never sampled source keys. */
2
3
  import type { GeometryFile } from '@rig-c/core/render-shared';
3
4
  import type { FrameSet } from './check.ts';
@@ -49,7 +50,7 @@ const regular = (m: SeamMatrix): boolean => {
49
50
  /** World axes remain evidence even when local-range equivalence is unavailable. */
50
51
  export function seamJointPose(bone: string, parent: string | null, inherit: string, setup: SeamMatrix, posed: SeamMatrix,
51
52
  parentSetup: SeamMatrix | null, parentPosed: SeamMatrix | null, range: [number, number] | null, rangeReason?: string): SeamJointPose {
52
- const out: SeamJointPose = { bone, parent, world_x_axis_degrees: posed.a === 0 && posed.c === 0 ? null : angle(posed.a, posed.c),
53
+ const out: SeamJointPose = { ...checkRow('SEAM_OVER_MOTION.rows[].pose_at_worst.joints', 'rig', false, []), bone, parent, world_x_axis_degrees: posed.a === 0 && posed.c === 0 ? null : angle(posed.a, posed.c),
53
54
  parent_relative_setup_axis_delta_degrees_mod360: null, static_range: range, comparison: 'unavailable' };
54
55
  if (inherit !== 'normal') return { ...out, reason: `inherit ${inherit}: parent-relative local-range comparison unavailable` };
55
56
  if (parent === null || parentSetup === null || parentPosed === null) return { ...out, reason: 'no parent frame for a local-range comparison' };
@@ -1,3 +1,4 @@
1
+ import { checkRow } from './checkrow.ts';
1
2
  /** Authored source-painting limits over actual renderer setup pixels (#887). */
2
3
  import { refuseIfAny, type Problem } from './errors.ts';
3
4
  import type { Raster } from './raster/types.ts';
@@ -170,8 +171,8 @@ export function setupPaintingLine(
170
171
  else { row.pixels++; row.x0 = Math.min(row.x0, x); row.y0 = Math.min(row.y0, y); row.x1 = Math.max(row.x1, x + 1); row.y1 = Math.max(row.y1, y + 1); }
171
172
  }
172
173
  const status = r.max_pixels === undefined ? 'SKIP' : count > r.max_pixels ? 'FAIL' : 'PASS';
173
- const result: SetupPaintingReading = { ...r, status, pixel_count: count, limit: r.max_pixels ?? null,
174
- slots: [...rows].map(([slot, row]) => ({ slot, box: [row.x0, row.y0, row.x1 - row.x0, row.y1 - row.y0], pixel_count: row.pixels })) };
174
+ const result: SetupPaintingReading = { ...r, ...checkRow('SETUP_MATCHES_PAINTING.regions', 'rig', status === 'FAIL', []), status, pixel_count: count, limit: r.max_pixels ?? null,
175
+ slots: [...rows].map(([slot, row]) => ({ ...checkRow('SETUP_MATCHES_PAINTING.regions[].slots', slot === '(uncovered)' ? 'rig' : 'part', false, slot === '(uncovered)' ? [] : [slot]), slot, box: [row.x0, row.y0, row.x1 - row.x0, row.y1 - row.y0], pixel_count: row.pixels })) };
175
176
  if (status === 'FAIL') {
176
177
  for (const row of result.slots) problems.push({ code: 'CHECK_SETUP_MATCHES_PAINTING', object: `region "${r.name}" slot "${row.slot}"`, detail: `box [${row.box.join(', ')}], pixelcount ${row.pixel_count}; region pixelcount ${count} > declared limit ${r.max_pixels}, RGB tolerance ${declared.rgb_tolerance}; compare the actual setup to the source painting on the declared stage grid` });
177
178
  }