rig-parts 1.9.1 → 1.10.0

package/README.md

@@ -283,12 +283,13 @@ agent skill.
 | `propose --head-box --full <run> --canvas WxH` | propose `seethrough.head_box` from the full run, held inside the painting |
 | `propose --parts --source --out [--compare <config>]` | propose bones, meshes, regions and an idle; draw the overlay; print, per bone, which check read it or that none did and why (its role, its kind of segment), and write `basis.json` beside the proposal — what each bone rests on (a joint, a part's mask, a ratio, other bones) and, with `--compare`, whether the config's bone differs |
 | `propose … --keypoints <file> [--person <id>]` | read a posed figure's joints from one explicit file (space, image size, people, each joint observed, occluded or missing, its source): a joint with a position places the neck, hip, chest or a sleeve chain as given, a note says how every joint was used or which rule stood in, and LINT reads the torso and sleeves along the joints instead of by screen y ([AUTHORING §3](docs/AUTHORING.md)) |
+| `propose … --grid-rule figure\|part` | how each drafted lattice's spacing is chosen: `figure` (the default) one spacing for the figure, round(H / 37) rig px, a part already coarser keeping its own, with a note on its calibration and cost; `part` the reference's rule, a tenth of the part's short side (the oracle examples are proposed under it) |
 | `propose … --from-config <config>` | draw and LINT the config's current bones (by the joints too, given `--keypoints`) |
 | `compare --left <file> --right <file> [--map <bonemap.json>]` | compare two skeletons — a config, a proposal or a `rig.json` — bone by bone: origin, parent, tip, length and direction per pair, the bones neither side pairs, the required ones missing, and each side's roles read off the spec; no frame is guessed, and nothing pairs by resemblance (`propose --compare` reads origins only) |
 | `rig --config --parts --out [--idle-keys ctl\|direct]` | author `rig.json` + `motion.json`, written only after rig-c's gate is green; each mesh is in the mode its config entry names — `grid` (the lattice, what `propose` writes), `contour` (the traced outline with declared interior points) or `auto` (the contour mesh at alpha 1 and above, reduced and locally refined by rig-c's `reduceMesh` under the author's declared bounds, written only when its motion against the unreduced source on the idle passes the author's `motion` bounds through rig-c's `compareMeshesInMotion`; [AUTHORING §3](docs/AUTHORING.md)); every chain link is turned along its chain and carries its `length`, so a physics constraint added later has a lever, with every offset under it in the turned frame so nothing moves; `--idle-keys` says whether the idle's keys on mesh-driving bones go through `<bone>_ctl` parents (default) or stay on the bones with `invariants.idleDrivesMeshes` declared; the config's `constraints` go to rigc as written, and a two-bone ik over keyed links needs `--idle-keys direct` (on `rig` or `build`) |
 | `check --rig --out [--parts] [--source] [--requirements]` | build packed, gated under `spine-html`, render the idle, measure seam, loop and the six judgement lines (mesh texture stretch among them, from the idle's `render --geometry`), and report the recomposite's holes from `parts.json`; on a rig spec with no `parts.json` or no `idle` (a merged rig, issue #77) the gate still runs and every line that needs the missing input says SKIP by name; `--source <painting.png>` adds `SETUP_POSE_VS_SOURCE`, the setup pose against the painting by assemble's recomposite figures; `--requirements <scene.json>` measures what a scene declares of the motion — a contact, a follow fraction, an aim, a joint range, a mesh's stretch, the seam between two parts over the motion — each against the author's own bar, from rig-c's posed frames, one line each, PASS, FAIL or NOT MEASURABLE (AUTHORING §7, *Declared requirements*) |
 | `loop --frames <dir> --out <file.gif \| file.png> [--palette]` | encode a rendered idle as a looping GIF, lossless APNG, or indexed APNG (`--palette`) |
-| `build --config --source --full --head --out [--seam] [--project] [--loop] [--lead-in <periods>] [--requirements] [--idle-keys ctl\|direct]` | assemble, rig and check in one process, stopping at the first refusal; `--requirements` is forwarded to check, `--idle-keys` to rig; `--lead-in` (with `--loop`) encodes the loop from the last of n + 1 idle periods played back to back, for a rig whose physics does not end where the render starts it |
+| `build --config --source --full --head --out [--seam] [--project] [--loop] [--lead-in <periods>] [--requirements] [--seam-pairs] [--keep-stills] [--idle-keys ctl\|direct]` | assemble, rig and check in one process, stopping at the first refusal; `--requirements`, `--seam-pairs` and `--keep-stills` are forwarded to check, `--idle-keys` to rig; `--lead-in` (with `--loop`) encodes the loop from the last of n + 1 idle periods played back to back, for a rig whose physics does not end where the render starts it |
 | `compose --scene <scene.json> --out [--requirements] [--accept]` | bind several characters' green builds into one rig (or, under `--accept`, builds failing only the bars named — for looking, not shipping): every name prefixed `<id>:` under one shared root, each character's offset added at its first-level bones, an optional background plate (its provenance recorded, judged by nothing) drawn first, and the draw order between the characters' slots as the scene file declares it — nothing inferred, nothing scaled; gated through rig-c as `rig` is, then checked ([AUTHORING §7](docs/AUTHORING.md), *Composing several characters*) |
 
 `rig-parts --help` has every flag. Exit codes: 0 done, 1 input refused (every

package/cli.ts

@@ -16,7 +16,7 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, statSync, wri
 import { tmpdir } from 'node:os';
 import { basename, dirname, extname, join } from 'node:path';
 import { DEFAULT_PROJECT_RULE, DEFAULT_SEAM_RULE, HOLES_LISTED, PROJECT_RULES, type ProjectRule, proposeFields, proposePlan, SEAM_RULES, type SeamRule } from './src/assemble.ts';
-import { assembleStage, build, checkStage, ERROR_MAP_FILE, loopStage, readRuns, readSource, rigStage } from './src/build.ts';
+import { assembleStage, build, checkStage, ERROR_MAP_FILE, loopStage, readRuns, readSource, rigStage, suppliedCheckFlag } from './src/build.ts';
 import { ACCEPTABLE_BARS, DEFAULT_PACK_SHAPE, DEFAULT_PAGE_EDGES, findRigc, PACK_SHAPES, type PackShape, PAGE_EDGES, type PageEdges, PARTS_HOME_SENTENCE, RIGC_GEOMETRY_VERSION, type RigcRunner, NO_PARTS_SENTENCE, SEAM_MEAN_BAR, SOURCE_SENTENCE, SEAM_PX_BAR, SEAM_PX_LEVEL, SPINEBOY_YARDSTICK, TEXTURE_STRETCH_CEILING } from './src/check.ts';
 import { ComfyClient, resolveHost, runPainting, runSeeThrough } from './src/comfy/index.ts';
 import { type CharacterConfig, loadConfig, loadEarlyConfig, loadPaintConfig } from './src/config.ts';
@@ -26,13 +26,15 @@ import { makeInputs } from './src/inputs.ts';
 import { idleKeysOf, isIdleKeys } from './src/rig.ts';
 import { figuresPhrase, implausibleRules, layerFigures, type LayerSet, pct, readLayers, ruleSummary, times } from './src/layers.ts';
 import { checkImageSize, choosePerson, KEYPOINTS_SPEC, loadKeypoints, type RigJoints, toRigJoints } from './src/keypoints.ts';
-import { basisLines, checkProposal, compare, compareLines, draftTurn, drawLandmarks, FRINGE_STEP_PX, HIP_MIN_FRACTION, lint, lintLine, type PartSet, proposeWithBasis, readPartSet, serializeProposal, withTurn, WRIST_ON_PART_PX } from './src/propose.ts';
+import { basisLines, checkProposal, compare, compareLines, DEFAULT_GRID_RULE, draftTurn, drawLandmarks, FIGURE_GRID_DIVISOR, FRINGE_STEP_PX, GRID_RULES, type GridRule, HIP_MIN_FRACTION, lint, lintLine, type PartSet, proposeWithBasis, readPartSet, serializeProposal, withTurn, WRIST_ON_PART_PX } from './src/propose.ts';
 import { BASIS_FILE, BASIS_SPEC, basisFile, basisLine, coverageLines, serializeBasis } from './src/diagnostics.ts';
+import { BEND_DEGREES, BEND_WORST_SHARE, DUST_MAX_PX, DUST_MAX_SHARE, IDLE_BOUND_PX, MESH_DRAFT_REPORT, MESH_DRAFT_SPEC, meshDraftStage, MORE_TRIANGLES_FLAG, TOLERANCE_FIGURE_DIVISOR } from './src/meshdraft.ts';
 import { readPng, writePng } from './src/raster/png.ts';
 import { REQUIREMENTS_SENTENCE } from './src/requirements.ts';
 import { composeStage, IMAGE_SEP, PLATE, PROVENANCES, SCENE_REPORT_FILE, SCENE_REPORT_SPEC, SCENE_SPEC } from './src/scene.ts';
 import { buildSheet, defaultCaption, type Tile, tilesFrom } from './src/sheet.ts';
 import { loadComparison, requiredProblems, structureLines } from './src/structure.ts';
+import { authorLayerLine } from './src/tags.ts';
 
 const EXIT_OK = 0;
 const EXIT_REFUSED = 1;
@@ -62,9 +64,11 @@ usage:
       (alpha below 128), background share (min channel above 235) and area as a
       multiple of the rest of the figure (the other layers' union). A layer that
       crosses a plausibility rule gets a WARN line naming the rule and the bar;
-      --propose-plan leaves it out. Refuses, by name, a missing file, an
-      unknown tag, a PNG whose size is not its box, and anything else outside
-      the input contract — never a WARN.
+      --propose-plan leaves it out. A layer named author:<label> is one the
+      author made by hand: its group is author, and a line says it has no
+      role. Refuses, by name, a missing file, an unknown tag, a PNG whose
+      size is not its box, and anything else outside the input contract —
+      never a WARN.
 
   rig-parts sheet --source <painting.png> --layers <path> [--layers <path> ...]
                     --out <sheet.png> [--cell <px>] [--cols <n>]
@@ -77,7 +81,8 @@ usage:
   rig-parts propose --parts <dir> --source <painting.png> --out <dir> [--compare <config.json>]
       Propose bones, meshes, regions and an idle from the assembled parts (<dir>
       holds parts.json and parts/). Roles come from each part's See-through tag,
-      never its name. Writes <out>/proposal.json (config-shaped: bones, meshes,
+      never its name; a part from an author:<label> layer has no role and
+      rides the nearest trunk bone until the config names one. Writes <out>/proposal.json (config-shaped: bones, meshes,
       regions, motion with its blink — and a blink.still cut for a lash that
       reaches far above its eyewhite, when a clear row allows one; no blink
       when no part is an eyewhite, and no brows in it when no part is an
@@ -149,6 +154,16 @@ usage:
       or a layer with no depth is refused by name. Without either flag nothing
       changes.
 
+  rig-parts propose … [--grid-rule figure|part]
+      How each drafted lattice's spacing (meshes.<part>.grid) is chosen.
+      figure, the default: round(H / ${FIGURE_GRID_DIVISOR}) rig px for every lattice, H the
+      height of every part's box together, and a part whose own spacing is
+      already coarser keeps it; a note says which parts took it, that it was
+      calibrated on three figures of similar size, and what it costs (the
+      idle moved against the finer lattice, which no bar reads). part: the
+      reference's rule, a tenth of the part's short side clamped to 5..36.
+      r is the part rule's under both.
+
   rig-parts propose --parts <dir> --source <painting.png> --out <dir> --from-config <config.json>
       Draw the config's CURRENT bones instead (<out>/render/landmarks_config.png
       and _head) and LINT them (by the joints too, given --keypoints), with the
@@ -226,6 +241,42 @@ usage:
       rig-c 1.3.0 or later and makes A15 a SKIP that prints its cost (the
       stage prints that SKIP line). The pose is the same to one level of float
       rounding, and so is the per-frame mesh work (AUTHORING §5).
+  rig-parts mesh-draft --config <config.json> --parts <dir> --out <dir> [--requirements <file.json>]
+                  [--idle-keys ctl|direct] [--page-edges pot|free] [--pack-shape rect|polygon]
+                  [--more-triangles]
+      Draft a traced outline around a coarse grid for every lattice mesh the
+      config states, and keep it only where it holds against that part's
+      lattice (issue #265). The config is read, never written: --out receives
+      config.json — the input's own text with each drafted part's meshes entry
+      replaced, every other byte as read — and ${MESH_DRAFT_REPORT} (spec
+      "${MESH_DRAFT_SPEC}": the rules, both checks' bars, and per part its
+      lattice and candidate triangles and overdraw, the five readings, each
+      with its margin to its line, and the note). H is the height of the union of the parts' boxes; the candidate is
+      contour {tolerance T, margin T, spacing S, maxEdge S, stray} with
+      T = max(1, round(H / ${TOLERANCE_FIGURE_DIVISOR})) and S = round(H / ${FIGURE_GRID_DIVISOR}) (a figure whose S is 0 is
+      refused, MESH_DRAFT_FIGURE), stray the largest dust island (at most
+      ${DUST_MAX_PX} px and ${DUST_MAX_SHARE * 100} % of the part's art); a part with any other extra island
+      keeps its lattice. The config as written must build and check PASS first
+      (MESH_DRAFT_LATTICE_GREEN). Then each candidate is held to its lattice:
+      every check bar that reads the part passes on the drafted rig; within
+      ${IDLE_BOUND_PX} rig px of the lattice over the idle; at the bend set (every chain
+      link the part's segments name turned ${BEND_DEGREES} degrees, both ways) no more
+      inverted triangles than the lattice and the worst sample within
+      ${BEND_WORST_SHARE * 100} % of the lattice's, both against a denser lattice of the same
+      part; and no more triangles than the lattice — every motion reading
+      rig-c's (check, and compareMeshesInMotion over three unpacked gate
+      builds). The lattice is the config's own grid entry: for a proposed
+      config, the figure's spacing propose drafts. The gate is a judgment
+      relative to that lattice, not an absolute quality: when the lattice
+      coarsens, the reference moves with it. --more-triangles drafts a
+      candidate that holds the four motion readings even with more triangles
+      than its lattice, and the report records each part's triangle and
+      overdraw difference. A part that passes is drafted, its note saying
+      what it was measured against; one that fails keeps its entry, and the
+      report names each failed reading and by how much. Written only when the
+      drafted config's check is PASS. --requirements, --idle-keys,
+      --page-edges and --pack-shape are as for rig and check.
+
   rig-parts check --rig <dir> --out <dir> [--parts <dir>] [--source <painting.png>]
                     [--page-edges pot|free] [--pack-shape rect|polygon]
                     [--requirements <file.json>] [--seam-pairs] [--keep-stills]
@@ -436,7 +487,7 @@ usage:
                     --head <dir|psd> --out <dir> [--seam near-white|silhouette]
                     [--project core|visible] [--page-edges pot|free]
                     [--pack-shape rect|polygon] [--loop] [--requirements <file.json>]
-                    [--idle-keys ctl|direct] [--lead-in <periods>]
+                    [--idle-keys ctl|direct] [--lead-in <periods>] [--seam-pairs] [--keep-stills]
       assemble, then rig, then check, in one process, each stage's own lines
       printed under [assemble], [rig] and [check]; the first stage that refuses
       stops the build with its own FAIL lines. The config must already carry
@@ -459,6 +510,13 @@ usage:
       and check's artifact, take them). --requirements is forwarded to check
       (as for check); the file's own shape is read before assemble runs, and
       its names resolve against the rig in the check, before it builds.
+      --seam-pairs and --keep-stills are forwarded to check (as for check:
+      the seam split by pair on a pass too, under check/seam/; the setup-pose
+      still under check/setup_still/). check's --rig and --parts are refused:
+      build's check reads the rig and the parts it wrote, <out>/rig and <out>.
+      build's --source is the painting assemble reads and is not handed to
+      the check, so check.json carries no SETUP_POSE_VS_SOURCE; run check
+      --rig <out>/rig --parts <out> --source <painting> for that line.
       --idle-keys is forwarded to the rig stage (as for rig) and defaults to
       ctl; the first line names it when it is direct. A config with a
       two-bone ik over chain links the idle keys needs --idle-keys direct:
@@ -568,6 +626,8 @@ function printLayerTable(set: LayerSet): void {
   for (const r of rows) console.log(line(r));
   const painted = set.layers.filter((l) => l.opaquePx > 0).length;
   console.log(`  ${set.layers.length} layer(s): ${painted} with opaque pixels, ${set.layers.length - painted} with none`);
+  // Issue #256: a layer the author made is said to be one, so it never reads as See-through's. None, no line.
+  for (const l of set.layers) if (l.tag.group === 'author') console.log(`  ${authorLayerLine(l.name)}`);
   // A reader refuses nothing on plausibility: it says what --propose-plan will leave out, and why.
   let warned = 0;
   for (const f of figures) {
@@ -587,7 +647,7 @@ function printLayerTable(set: LayerSet): void {
 const TAKES = {
   sheet: { valued: ['--source', '--layers', '--out', '--cell', '--cols'], switches: [] },
   rig: { valued: ['--config', '--parts', '--out', '--idle-keys', '--page-edges', '--pack-shape'], switches: [] },
-  propose: { valued: ['--parts', '--source', '--out', '--from-config', '--compare', '--full', '--head', '--canvas', '--keypoints', '--person', '--wrist-snap'], switches: ['--head-box'] },
+  propose: { valued: ['--parts', '--source', '--out', '--from-config', '--compare', '--full', '--head', '--canvas', '--keypoints', '--person', '--wrist-snap', '--grid-rule'], switches: ['--head-box'] },
   compare: { valued: ['--left', '--right', '--map'], switches: [] },
   check: { valued: ['--rig', '--out', '--parts', '--source', '--page-edges', '--pack-shape', '--requirements'], switches: ['--seam-pairs', '--keep-stills'] },
   loop: { valued: ['--frames', '--out'], switches: ['--palette'] },
@@ -595,8 +655,9 @@ const TAKES = {
   'comfy seethrough': { valued: ['--image', '--out', '--resolution', '--steps', '--seed', '--prefix', '--host', '--wait', '--timeout', '--poll'], switches: ['--offload', '--lama', '--nf4'] },
   'comfy paint': { valued: ['--config', '--out', '--seeds', '--seed0', '--host', '--wait', '--timeout', '--poll'], switches: [] },
   inputs: { valued: ['--source', '--config', '--out'], switches: [] },
-  build: { valued: ['--config', '--source', '--full', '--head', '--out', '--seam', '--project', '--page-edges', '--pack-shape', '--requirements', '--idle-keys', '--lead-in'], switches: ['--loop'] },
+  build: { valued: ['--config', '--source', '--full', '--head', '--out', '--seam', '--project', '--page-edges', '--pack-shape', '--requirements', '--idle-keys', '--lead-in'], switches: ['--loop', '--seam-pairs', '--keep-stills'] },
   compose: { valued: ['--scene', '--out', '--requirements', '--accept'], switches: [] },
+  'mesh-draft': { valued: ['--config', '--parts', '--out', '--requirements', '--idle-keys', '--page-edges', '--pack-shape'], switches: ['--more-triangles'] },
 } as const satisfies Record<string, { valued: readonly string[]; switches: readonly string[] }>;
 
 type Command = keyof typeof TAKES;
@@ -891,6 +952,11 @@ function cmdPropose(args: string[]): number {
       }
       wristSnap = Number(snapArg);
     }
+    // Issue #265: the drafted lattice's spacing; the figure's unless the reference's per-part rule is asked for.
+    const ruleArg = flags.get('--grid-rule');
+    if (ruleArg !== undefined && flags.has('--from-config')) return usage('--grid-rule chooses the drafted spacing; --from-config proposes nothing');
+    if (ruleArg !== undefined && !(GRID_RULES as readonly string[]).includes(ruleArg)) return usage(`--grid-rule ${ruleArg}; one of ${GRID_RULES.join(', ')} is required`);
+    const gridRule = (ruleArg ?? DEFAULT_GRID_RULE) as GridRule;
     const partsDir = existsSync(partsArg) && statSync(partsArg).isFile() ? dirname(partsArg) : partsArg;
     if (!existsSync(source)) {
       throw new PartsError([{ code: 'PROPOSE_SOURCE_PRESENT', object: source, detail: 'no such file; the painting is drawn under the overlay' }]);
@@ -918,7 +984,7 @@ function cmdPropose(args: string[]): number {
     }
     const cmpPath = flags.get('--compare');
     const cfg = cmpPath === undefined ? null : loadConfig(cmpPath);
-    const { proposal: drafted, basis } = proposeWithBasis(P, joints, wristSnap);
+    const { proposal: drafted, basis } = proposeWithBasis(P, joints, wristSnap, gridRule);
     const fullRun = flags.get('--full');
     const headRun = flags.get('--head');
     const prop =
@@ -1175,14 +1241,19 @@ function cmdInputs(args: string[]): number {
 
 function cmdBuild(args: string[]): number {
   const flags = new Map<string, string>();
-  let loop = false;
+  // The bare switches build takes: --loop its own, --seam-pairs and --keep-stills check's, forwarded (issue #257).
+  const on = new Set<string>();
+  const switches: readonly string[] = TAKES.build.switches;
   for (let i = 0; i < args.length; i++) {
     const flag = args[i];
-    if (flag === '--loop') {
-      if (loop) return usage('--loop is given twice');
-      loop = true;
+    if (switches.includes(flag)) {
+      if (on.has(flag)) return usage(`${flag} is given twice`);
+      on.add(flag);
       continue;
     }
+    // A check flag whose value build supplies itself (--rig, --parts) is refused with what build reads instead (issue #257).
+    const supplied = suppliedCheckFlag(flag);
+    if (supplied !== null) return usage(supplied);
     if (!takesValued('build', flag)) return usage(notTaken('build', flag));
     const value = args[i + 1];
     if (value === undefined) return usage(`${flag} needs a value`);
@@ -1201,6 +1272,7 @@ function cmdBuild(args: string[]): number {
   if (!isPackShape(shape)) return usage(shape);
   const keys = idleKeysOf(flags.get('--idle-keys'));
   if (!isIdleKeys(keys)) return usage(keys);
+  const loop = on.has('--loop');
   const leadText = flags.get('--lead-in');
   if (leadText !== undefined && !/^[1-9][0-9]*$/.test(leadText)) return usage(`--lead-in ${leadText}; a whole number of idle periods, 1 or more, is required`);
   if (leadText !== undefined && !loop) return usage('--lead-in needs --loop; it says which frames the loop is encoded from');
@@ -1214,7 +1286,7 @@ function cmdBuild(args: string[]): number {
   const scratch = mkdtempSync(join(tmpdir(), 'rig-parts-build-'));
   try {
     const r = build(
-      { config, source, full, head, out, seam: seam as SeamRule, project: project as ProjectRule, loop, pageEdges: edges, packShape: shape, ...(flags.has('--requirements') ? { requirements: flags.get('--requirements') as string } : {}), idleKeys: keys, ...(leadText === undefined ? {} : { leadIn: Number(leadText) }) },
+      { config, source, full, head, out, seam: seam as SeamRule, project: project as ProjectRule, loop, pageEdges: edges, packShape: shape, ...(flags.has('--requirements') ? { requirements: flags.get('--requirements') as string } : {}), idleKeys: keys, ...(leadText === undefined ? {} : { leadIn: Number(leadText) }), seamPairs: on.has('--seam-pairs'), keepStills: on.has('--keep-stills') },
       { rig: rigcRunner(bin), check: rigcRunner(bin), checkBin: bin, scratch: join(scratch, 'rig-gate') },
       console.log,
     );
@@ -1248,6 +1320,46 @@ function cmdCompose(args: string[]): number {
   }
 }
 
+function cmdMeshDraft(args: string[]): number {
+  // The one switch mesh-draft takes (#295): taken out before the valued flags are read.
+  const more = args.filter((a) => a === MORE_TRIANGLES_FLAG).length;
+  if (more > 1) return usage(`${MORE_TRIANGLES_FLAG} is given twice`);
+  const f = flags(
+    args.filter((a) => a !== MORE_TRIANGLES_FLAG),
+    'mesh-draft',
+    ['--config', '--parts', '--out'],
+  );
+  if (typeof f === 'string') return usage(f);
+  const keys = idleKeysOf(f.get('--idle-keys'));
+  if (!isIdleKeys(keys)) return usage(keys);
+  const edges = pageEdgesOf(f.get('--page-edges'));
+  if (!isPageEdges(edges)) return usage(edges);
+  const shape = packShapeOf(f.get('--pack-shape'));
+  if (!isPackShape(shape)) return usage(shape);
+  let bin: string;
+  try {
+    bin = findRigc(import.meta.dir, process.env.PATH ?? '');
+  } catch (err) {
+    return printRefusal(err);
+  }
+  const scratch = mkdtempSync(join(tmpdir(), 'rig-parts-mesh-draft-'));
+  try {
+    const req = f.get('--requirements');
+    meshDraftStage(
+      { config: f.get('--config') as string, parts: f.get('--parts') as string, out: f.get('--out') as string, idleKeys: keys, pageEdges: edges, packShape: shape, ...(req === undefined ? {} : { requirements: req }), ...(more === 1 ? { moreTriangles: true } : {}) },
+      rigcRunner(bin),
+      bin,
+      scratch,
+      console.log,
+    );
+    return EXIT_OK;
+  } catch (err) {
+    return printRefusal(err);
+  } finally {
+    rmSync(scratch, { recursive: true, force: true });
+  }
+}
+
 function main(argv: string[]): number | Promise<number> {
   const [command, ...rest] = argv;
   if (command === undefined || command === '--help' || command === '-h' || command === 'help') {
@@ -1270,6 +1382,7 @@ function main(argv: string[]): number | Promise<number> {
   if (command === 'comfy') return cmdComfy(rest);
   if (command === 'build') return cmdBuild(rest);
   if (command === 'compose') return cmdCompose(rest);
+  if (command === 'mesh-draft') return cmdMeshDraft(rest);
   const later = LATER.find(([name]) => name === command);
   if (later !== undefined) {
     console.log(`  FAIL  NOT_IMPLEMENTED: \`rig-parts ${command}\` (${later[1]}) is not implemented in this version, ${version()}`);