cozyclay 2.1.0 → 3.0.0

package/src/take-recipe.js

@@ -1,165 +0,0 @@
-/* ======================== take recipes (contract C9) ========================
- * A take is a RECIPE, not a result: seed + prompt blocks + the line edits that
- * were pulled on top of it. Determinism on the box (re-chain diff = 0 bitwise)
- * is what makes that true — given the recipe the same take can be rebuilt at
- * any time, which is the whole reason regenerate/extend no longer destroys the
- * refinements the artist spent their afternoon on.
- *
- *   recipe = {
- *     seed: 1234,                    // ALWAYS a concrete integer, never null
- *     blocks: [{ prompt, duration }],// ordered; a single-prompt take = length 1
- *     lineEdits: [ <C6 payload WITHOUT sourceMotion> ],  // application order
- *   }
- *
- * THE SEED RULE, and why it lives here. A recipe with no seed cannot replay,
- * so no request that CREATES a take may omit one. When the artist leaves the
- * seed field empty the app rolls one, SENDS it, and records it — rolling it
- * here rather than letting the box pick silently is the difference between a
- * take you can rebuild and a take you can only remember.
- *
- * This file is deliberately React-free and side-effect-free: every function is
- * a pure value transform, so test/verify-take-recipe.mjs can pin the whole
- * contract in plain node without a DOM. Recipes come out DEEP FROZEN — the
- * one invariant that keeps "the recipe travels with the motionUrl" honest is
- * that no later edit can reach back and rewrite a version that is already on
- * the strip. */
-
-/** C10's cap on a replay array. The bridge refuses more, and the app must not
- * discover that by being refused. */
-export const RECIPE_MAX_LINE_EDITS = 16;
-
-/** C12's cap on the version strip. The bridge's motion allowlist holds 64, so
- * 20 checkpoints are all still loadable when the oldest is dropped. */
-export const TAKE_VERSIONS_MAX = 20;
-
-/** Every key a C6 lineEdit payload may carry into a C10 replay entry, minus
- * sourceMotion (replay rebinds that to the freshly generated take). `seed` is
- * C10's optional per-entry seed and is the only field the app ADDS: it is the
- * seed that was actually sent with the edit, so a replay reproduces the edit
- * bit for bit instead of re-rolling it.
- *
- * `pins3d` is the second gesture's payload and rides the SAME list: a replayed
- * pin needs no camera and no polyline, and because the whitelist is a
- * whitelist, omitting it would have made a pinned edit vanish from its own
- * take's recipe silently — the take would regenerate without the refinement and
- * nothing would say why. */
-const REPLAY_KEYS = ["track", "frameRange", "points2d", "pins3d", "camera", "prompt", "seed"];
-
-function deepFreeze(value) {
-	if (value === null || typeof value !== "object" || Object.isFrozen(value)) return value;
-	Object.freeze(value);
-	for (const entry of Array.isArray(value) ? value : Object.values(value)) deepFreeze(entry);
-	return value;
-}
-
-/** Roll a seed the way the seed rule demands. `random` is injectable so tests
- * can pin the arithmetic instead of sampling it. */
-export function rollSeed(max, random = Math.random) {
-	if (!Number.isInteger(max) || max <= 0) throw new Error(`rollSeed needs a positive integer max, got ${max}`);
-	return Math.floor(random() * max);
-}
-
-/** The seed a request will actually carry. `typed` is the artist's raw field
- * value (empty string = "you pick"); a typed seed is NEVER overwritten, and an
- * empty one is rolled here so the same integer can be both sent and recorded.
- * Returns an integer, always — this is the function every take-creating call
- * site goes through. */
-export function resolveSeed(typed, max, random = Math.random) {
-	const text = typeof typed === "string" ? typed.trim() : typed;
-	if (text === "" || text === null || text === undefined) return rollSeed(max, random);
-	const value = Number(text);
-	if (!Number.isInteger(value) || value < 0 || value > max) {
-		throw new Error(`seed must be an integer in 0..${max}, got ${typed}`);
-	}
-	return value;
-}
-
-/** The prompt blocks a request actually asked for. A segments body (chained
- * blocks) contributes one block per segment on the WIRE clock it was built
- * against; anything else is the single prompt+duration pair the bridge was
- * handed. Durations come out in seconds either way, because that is the one
- * frame-rate-free number in the request. */
-export function blocksFromRequest(body, fps) {
-	if (!body || typeof body !== "object") throw new Error("blocksFromRequest needs a request body");
-	if (!(fps > 0)) throw new Error(`blocksFromRequest needs a positive fps, got ${fps}`);
-	const basePrompt = typeof body.prompt === "string" ? body.prompt : "";
-	if (Array.isArray(body.segments) && body.segments.length > 0) {
-		return body.segments.map((segment) => ({
-			prompt: (typeof segment.prompt === "string" && segment.prompt) || basePrompt,
-			duration: Math.max(0, (segment.endFrame - segment.startFrame) / fps),
-		}));
-	}
-	return [{ prompt: basePrompt, duration: Number(body.duration) || 0 }];
-}
-
-/** A recipe for a take that was just generated. `lineEdits` defaults to empty —
- * a plain generate has none — but a regeneration that CARRIED `replay` starts
- * life with exactly the edits the box re-applied, because those edits are in
- * the resulting npz and dropping them here would make the NEXT regeneration
- * lose them. */
-export function freshRecipe({ seed, blocks, lineEdits = [] }) {
-	if (!Number.isInteger(seed)) throw new Error(`a recipe needs a concrete integer seed, got ${seed}`);
-	if (!Array.isArray(blocks) || blocks.length === 0) throw new Error("a recipe needs at least one block");
-	return deepFreeze({
-		seed,
-		blocks: blocks.map((block) => ({ prompt: String(block.prompt ?? ""), duration: Number(block.duration) || 0 })),
-		lineEdits: lineEdits.map(stripSourceMotion),
-	});
-}
-
-/** A C6 payload reduced to what a C10 replay entry may carry: sourceMotion is
- * dropped (replay rebinds it), unknown keys are dropped with it, and absent
- * optional keys stay absent rather than becoming undefined on the wire. */
-export function stripSourceMotion(payload) {
-	if (!payload || typeof payload !== "object") throw new Error("a line edit payload is required");
-	const entry = {};
-	for (const key of REPLAY_KEYS) {
-		if (payload[key] !== undefined) entry[key] = payload[key];
-	}
-	if (!entry.track) throw new Error("a line edit payload must name a track");
-	return deepFreeze(entry);
-}
-
-/** Push a successful line edit onto the take's recipe. Returns a NEW recipe;
- * the input is never touched, which is what lets an old version keep the
- * recipe it was saved with after the artist edits from it. */
-export function withLineEdit(recipe, payload) {
-	if (!recipe) throw new Error("withLineEdit needs a recipe to extend");
-	return deepFreeze({
-		seed: recipe.seed,
-		blocks: recipe.blocks.map((block) => ({ ...block })),
-		lineEdits: [...recipe.lineEdits, stripSourceMotion(payload)],
-	});
-}
-
-/** The C10 `replay` array for this recipe, or [] when there is nothing to
- * replay. TRUNCATION KEEPS THE PREFIX, not the tail: entry i was authored on
- * top of entries 0..i-1, so the first N edits are the only slice that is
- * self-consistent. Dropping the newest work is the honest failure here, and
- * the caller surfaces it (replayTruncated) rather than silently shipping 16. */
-export function replayPayload(recipe) {
-	if (!recipe || !Array.isArray(recipe.lineEdits) || recipe.lineEdits.length === 0) return [];
-	return recipe.lineEdits.slice(0, RECIPE_MAX_LINE_EDITS).map(stripSourceMotion);
-}
-
-/** True when this recipe carries more edits than one replay request can hold. */
-export function replayTruncated(recipe) {
-	return (recipe?.lineEdits?.length ?? 0) > RECIPE_MAX_LINE_EDITS;
-}
-
-/** Append a checkpoint to the version strip, oldest dropped past the cap.
- * Re-pushing a motionUrl that is already on the strip is a no-op: loading an
- * old version must not clone it onto the top, and a retried delivery must not
- * either. */
-export function pushTakeVersion(versions, entry, cap = TAKE_VERSIONS_MAX) {
-	const list = Array.isArray(versions) ? versions : [];
-	if (!entry?.motionUrl) throw new Error("a take version needs a motionUrl");
-	if (list.some((item) => item.motionUrl === entry.motionUrl)) return list;
-	const next = [...list, Object.freeze({
-		motionUrl: entry.motionUrl,
-		recipe: entry.recipe ?? null,
-		savedAt: Number.isFinite(entry.savedAt) ? entry.savedAt : Date.now(),
-		label: typeof entry.label === "string" ? entry.label : "",
-	})];
-	return next.length > cap ? next.slice(next.length - cap) : next;
-}

package/src/trail-key-conflicts.js

@@ -1,39 +0,0 @@
-const CHAIN_BY_EFFECTOR = Object.freeze({
-	LeftHand: "leftHand",
-	RightHand: "rightHand",
-	LeftFoot: "leftFoot",
-	RightFoot: "rightFoot",
-});
-const EFFECTOR_BY_CHAIN = Object.freeze({
-	leftHand: "LeftHand",
-	rightHand: "RightHand",
-	leftFoot: "LeftFoot",
-	rightFoot: "RightFoot",
-});
-
-function trackIds(track) {
-	const id = typeof track === "string" ? track : track?.id ?? track?.joint ?? track?.effector;
-	const chain = typeof track === "object" ? track?.chain : null;
-	return new Set([id, chain, CHAIN_BY_EFFECTOR[id], EFFECTOR_BY_CHAIN[id]].filter(Boolean));
-}
-
-function entryFor(entries, id) {
-	return typeof entries?.get === "function" ? entries.get(id) : entries?.[id];
-}
-
-/** Return absolute IK-key frames that can override a trail edit. */
-export function findAbsoluteIkKeyConflicts({ keys, track, startFrame, endFrame }) {
-	const ids = trackIds(track);
-	const frames = [];
-	for (const [frame, entries] of keys ?? []) {
-		if (frame < startFrame || frame >= endFrame) continue;
-		for (const id of ids) {
-			const key = entryFor(entries, id);
-			if (key && key.baseQ == null) {
-				frames.push(frame);
-				break;
-			}
-		}
-	}
-	return [...new Set(frames)].sort((a, b) => a - b);
-}

package/src/trail-pick.js

@@ -1,59 +0,0 @@
-/** Pure picking for motion-trail pointer rays. */
-
-const FRAME_PENALTY = 0.001;
-const TIE_DISTANCE = 0.01;
-const MIN_FRAME_WINDOW = 12;
-
-/** Pick the trail track/frame intended by a ray near the current playhead. */
-export function pickTrailPoint({
-	tracks,
-	playheadFrame,
-	falloffFrames,
-	rayOrigin,
-	rayDirection,
-	maxDistance,
-}) {
-	if (!Array.isArray(tracks) || !rayOrigin || !rayDirection) return null;
-	const directionLength = Math.hypot(rayDirection.x, rayDirection.y, rayDirection.z);
-	if (!Number.isFinite(directionLength) || directionLength === 0) return null;
-	const dx = rayDirection.x / directionLength;
-	const dy = rayDirection.y / directionLength;
-	const dz = rayDirection.z / directionLength;
-	const center = Number.isFinite(playheadFrame) ? playheadFrame : 0;
-	const radius = Math.max(2 * (Number.isFinite(falloffFrames) ? falloffFrames : 0), MIN_FRAME_WINDOW);
-	const limit = Number.isFinite(maxDistance) ? maxDistance : 0;
-	let best = null;
-
-	for (const track of tracks) {
-		const points = track?.flat;
-		if (!track?.id || !points || points.length < 3) continue;
-		const firstFrame = Math.max(0, Math.ceil(center - radius));
-		const lastFrame = Math.min(Math.floor(points.length / 3) - 1, Math.floor(center + radius));
-		for (let frame = firstFrame; frame <= lastFrame; frame += 1) {
-			const offset = frame * 3;
-			const px = points[offset] - rayOrigin.x;
-			const py = points[offset + 1] - rayOrigin.y;
-			const pz = points[offset + 2] - rayOrigin.z;
-			const depth = px * dx + py * dy + pz * dz;
-			if (depth < 0) continue;
-			const ox = px - depth * dx;
-			const oy = py - depth * dy;
-			const oz = pz - depth * dz;
-			const distance = Math.hypot(ox, oy, oz);
-			if (distance > limit) continue;
-			const score = distance + Math.abs(frame - center) * FRAME_PENALTY;
-			const scoreDelta = score - (best?.score ?? Infinity);
-			if (
-				!best
-				|| scoreDelta < -TIE_DISTANCE
-				|| (Math.abs(scoreDelta) <= TIE_DISTANCE && (
-					depth < best.depth
-					|| (depth === best.depth && score < best.score)
-				))
-			) {
-				best = { track: track.id, grabFrame: frame, score, depth };
-			}
-		}
-	}
-	return best ? { track: best.track, grabFrame: best.grabFrame } : null;
-}

package/src/use-i2v-capture-modal.js

@@ -1,15 +0,0 @@
-import { useState } from "react";
-
-export function useI2vCaptureModal() {
-	const [i2vMotionEnabled, setI2vMotionEnabled] = useState(false);
-	const [i2vMotionMode, setI2vMotionMode] = useState("interpolate");
-	const [i2vMotionCameraUnlocked, setI2vMotionCameraUnlocked] = useState(false);
-	return {
-		i2vMotionEnabled,
-		setI2vMotionEnabled,
-		i2vMotionMode,
-		setI2vMotionMode,
-		i2vMotionCameraUnlocked,
-		setI2vMotionCameraUnlocked,
-	};
-}

package/tools/ardy/BRIDGE.md

@@ -1,37 +0,0 @@
-# Motion bridge (`tools/ardy/bridge.mjs`)
-
-This is the loopback HTTP sidecar used by the Studio. It keeps the historical
-`/ardy/*` route names so saved projects and motion URLs remain readable, but
-the local Studio uses Kimodo for authored generation and GVHMR for video mocap
-extraction. Legacy ARDY local/remote selection and its setup scripts are no
-longer part of the bridge launch path.
-
-Run it directly when debugging:
-
-```bash
-CCLAY_KIMODO_HOST=user@gpu-box node tools/ardy/bridge.mjs --port 5181
-```
-
-The sidecar owns health, base-listing, generation, footage download,
-video-to-motion extraction, and allowlisted motion delivery. It binds to
-`127.0.0.1`; the Vite dev server proxies only those API routes while serving
-`public/ardy/` assets itself.
-
-Kimodo settings:
-
-| Variable | Default | Purpose |
-| --- | --- | --- |
-| `CCLAY_KIMODO_HOST` | required | SSH destination for the generation host |
-| `CCLAY_KIMODO_REPO` | `$HOME/kimodo` | Kimodo checkout on that host |
-| `CCLAY_KIMODO_MODEL` | `Kimodo-SOMA-RP-v1.1` | model identifier |
-| `COZYCLAY_BRIDGE_PORT` | `5181` | loopback listen port |
-
-Video mocap extraction requires `CCLAY_EXTRACT_BACKEND=gvhmr` (the default).
-Any other backend or `CCLAY_EXTRACT_CMD` makes `/ardy/extract` return the named
-`extract-backend-unsupported` error. Set `CCLAY_EXTRACT_HOST` (or
-`CCLAY_ARDY_HOST`) to the GPU host that has the GVHMR checkout and virtualenv.
-The GVHMR detector is fixed to palette segmentation for the coloured mannequin;
-`CCLAY_EXTRACT_DETECTOR` cannot switch it to YOLO or auto.
-
-The wire path stays `/ardy` for backward compatibility; this does not
-re-enable the removed ARDY backend.

package/tools/ardy/GVHMR-NPZ.md

@@ -1,68 +0,0 @@
-# GVHMR extraction npz contract (box runner → CozyClay)
-
-Written by `cclay_gvhmr_extract.py` (lives in the GVHMR checkout on the GPU
-box, `~/cclay-ingest/GVHMR`), read by `tools/ardy/extract.mjs` when
-`CCLAY_EXTRACT_BACKEND=gvhmr`.
-
-All arrays float32 unless noted. World frame: metres, Y-up, gravity-aligned;
-pelvis XZ of frame 0 at the origin, the clip's lowest body vertex at Y=0,
-the body facing +Z at frame 0 (GVHMR's own "ayfz" normalisation).
-
-| member              | shape        | meaning |
-|---------------------|--------------|---------|
-| `fps`               | int32 scalar | source video rate |
-| `positions`         | [T, 22, 3]   | SMPL body joints 0..21 in the world frame (legacy; the positions lift reads this) |
-| `contact`           | [T, 6]       | GVHMR static-contact logits (order as the model emits) |
-| `smpl_joints`       | [T, 24, 3]   | SMPL joints 0..23 (22 body + L/R hand) in the world frame, from the neutral SMPL J-regressor |
-| `smpl_global_orient`| [T, 3]       | axis-angle (rad) of the pelvis in the world frame |
-| `smpl_body_pose`    | [T, 23, 3]   | axis-angle (rad) LOCAL rotation of SMPL joints 1..23 relative to their SMPL parent, standard SMPL kinematic tree |
-| `smpl_transl`       | [T, 3]       | pelvis position in the world frame, i.e. equal to `smpl_joints[:, 0]` |
-| `smpl_betas`        | [10]         | mean shape over the clip |
-| `smpl_rest_joints`  | [24, 3]      | SMPL joints of the ZERO pose for `smpl_betas` (pelvis at origin): the source rest skeleton the rotations are relative to |
-
-SMPL joint order (parents in brackets):
-```
- 0 pelvis(-)   1 L_hip(0)     2 R_hip(0)     3 spine1(0)
- 4 L_knee(1)   5 R_knee(2)    6 spine2(3)    7 L_ankle(4)
- 8 R_ankle(5)  9 spine3(6)   10 L_foot(7)   11 R_foot(8)
-12 neck(9)    13 L_collar(9) 14 R_collar(9) 15 head(12)
-16 L_shoulder(13) 17 R_shoulder(14) 18 L_elbow(16) 19 R_elbow(17)
-20 L_wrist(18) 21 R_wrist(19) 22 L_hand(20) 23 R_hand(21)
-```
-
-Rotation convention: SMPL global rotation of joint j is
-`G_j = G_parent(j) · R(body_pose[j-1])`, with `G_0 = R(global_orient)`, and
-joint positions are `P_j = P_parent + G_parent · (rest_j - rest_parent)`.
-The world frame's normalisation (heading, floor) has ALREADY been folded into
-`global_orient`/`transl`, so FK from these arrays reproduces `smpl_joints`
-exactly (up to float32). The SMPL zero pose is NOT a T-pose: the upper arm
-rests ~11° below horizontal and the collar points ~58° up. Retarget visible
-limb rest-pose differences, but keep the target rig's pelvis/spine/neck/head
-bind shape. SMPL's J-regressor joints form an internal torso S-curve and put
-the head joint forward inside the skull; aiming the target bones at those
-positions visibly hunches an otherwise upright character.
-
-## Repeatable QA loop
-
-Convert the raw runner archive, gate the retarget math, then capture the same
-sampled frames from the front and side on both shipped bodies:
-
-```bash
-node tools/ardy/gvhmr-to-cskel27.mjs /path/to/gvhmr.npz public/demo/qa-gvhmr.npz
-# For takes extracted from CozyClay-rendered clips, use --bone-scale 1.
-node --test test/smpl-cskel27.test.mjs
-
-# Keep `npm run dev:ui -- --host 127.0.0.1 --port 5180` running separately.
-for model in x-bot-tpose y-bot-tpose; do
-  for view in front side; do
-    QA_URL='http://127.0.0.1:5180/app/?motion=/demo/qa-gvhmr.npz' \
-      MODEL="$model" VIEW="$view" FRAMES=0,60,120,180,240,300 \
-      OUT="/tmp/gvhmr-qa/$model" npm run qa:browser -- node test/qa-screenshot-browser.mjs
-  done
-done
-```
-
-Review the captures against video frames at the same timestamps. Do not accept
-a take unless the test passes, upright samples retain the character's bind
-torso/neck silhouette, performed bends remain present, and neither body shows
-detached joints. Remove the temporary `public/demo/qa-gvhmr.npz` afterwards.

package/tools/ardy/README.md

@@ -1,124 +0,0 @@
-# Motion bridge support files
-
-The local Studio uses Kimodo for authored motion generation. Video mocap
-extraction is a separate path and uses GVHMR as its only backend. The bridge
-entry point remains at `tools/ardy/bridge.mjs` for compatibility with the
-existing `/ardy/*` browser protocol and stored motion URLs; the name is a
-wire-format path, not a selectable backend.
-
-## Local development
-
-```bash
-CCLAY_KIMODO_HOST=user@gpu-box npm run dev
-```
-
-Install the Kimodo host once with `npm run kimodo:setup`. To run the UI without
-any sidecar, use `npm run dev:ui`; the seeded motion and all staging, camera,
-IK, and playback features still work.
-
-The bridge accepts `COZYCLAY_BRIDGE_PORT` (or `--port`) and binds loopback
-only. Kimodo connection settings are `CCLAY_KIMODO_HOST`,
-`CCLAY_KIMODO_REPO`, and `CCLAY_KIMODO_MODEL`.
-
-## Shared utilities
-
-`npz.mjs`, `artifacts.mjs`, `footage.mjs`, `extract.mjs`, and the files under
-`src/ardy/` provide the common motion archive, ingest, conversion, IK, and
-playback contracts used by both generated and imported takes. They are not an
-ARDY runtime installation.
-
-The hosted demo worker still has a separately managed local runner for its
-queue jobs; that deployment path is intentionally independent of the local
-Studio selector.
-
-## GVHMR extraction (required backend)
-
-`CCLAY_EXTRACT_BACKEND` defaults to `gvhmr`, and GVHMR is the only supported
-video mocap backend. The bridge rejects another backend value or a custom
-`CCLAY_EXTRACT_CMD` with `extract-backend-unsupported`; the Studio also refuses
-to extract until the local GPU bridge reports GVHMR. There is no browser
-MediaPipe fallback for video or photo mocap.
-
-GVHMR's subject detector is fixed to the `palette` segmentation path for
-CozyClay's coloured mannequin. `CCLAY_EXTRACT_DETECTOR` is retained for
-deployment compatibility but cannot switch the detector to YOLO or auto.
-
-`CCLAY_EXTRACT_KEYPOINTS` picks the 2D joint source: `vitpose`, `palette`,
-`hybrid`, or `auto` (default, which is `hybrid` on a palette clip). Hybrid is
-palette joints for the body and ViTPose for the five face points, measured on
-the v15 bat-swagger clip (#380): ViTPose body joints jitter 29 px/f² frame to
-frame on the flat-shaded mannequin (ankle confidence 0.30) where the palette's
-overlap/axis joints jitter 8; but the palette pins every face point to the
-head centroid and GVHMR then reads a head that never turns (root travel 6.3 →
-2.9 m), so the face stays ViTPose (travel 6.1 m, arm swing 0.84 m). Shoulders
-from ViTPose wreck the arms (wrist-above-shoulder 93 % → 12 %). Where the
-render lost a limb part (a prop repainting the hand) the joint comes from the
-surviving part's axis end. The runner side lives in
-`~/cclay-ingest/GVHMR/cclay_gvhmr_extract.py` on the box (`hybrid_kp2d`).
-
-With GVHMR enabled, extraction uses one serial SSH worker.
-It deploys the repo-owned worker, preparation and trajectory Python modules into a content-addressed
-remote `/tmp/cozyclay-gvhmr-worker-*` directory and imports the existing
-`~/cclay-ingest/GVHMR/cclay_gvhmr_extract.py`. The original runner and model
-checkpoints are not overwritten. The host needs its existing GVHMR venv
-(validated with PyTorch 2.3.0+cu121 on an RTX 3070 8 GB).
-
-ViTPose/HMR2 share identical decoded crops. Complete checkpoint coverage is
-checked before accepting skipped random initialization; memory mapping falls
-back for legacy checkpoint formats. Their models stay on **CPU** between jobs,
-moving to CUDA one at a time. The tracker is new for every clip. Precision,
-flip testing, batch sizes, camera settings and neural motion prediction
-are unchanged by acceleration. The optional trajectory stage below intentionally
-changes accepted vertical trajectories. There is no cached motion-result shortcut.
-
-Concurrent extraction returns `extract-worker-busy`. Disconnect, timeout or
-bridge shutdown terminates the owned worker; it also exits after ten idle
-minutes. Restart the bridge after upgrading upstream code. Checkpoint
-size/mtime changes invalidate cached preprocessing models. The final `done`
-event includes stage timing, cache hits and PyTorch GPU-memory metrics.
-Palette takes also include `performance.segmentation`: detected and missing
-frames, dropout gaps, mask coverage quantiles, per-frame coverage, and HSV hue
-error (median/P95/max). These values come from the detector's own mask; older
-bridges without the instrumentation omit this optional report rather than
-reporting a clean zero-valued take.
-
-Rollback: launch the bridge with `CCLAY_GVHMR_WORKER=0` to use the original
-GVHMR one-shot command. Other extraction backends and `CCLAY_EXTRACT_CMD` stay
-unsupported so a misconfigured bridge fails explicitly.
-CPU lifecycle tests run in `npm test`; `test/qa-gvhmr-speed.py` performs real
-GPU raw-output/preprocessing equality checks, and `test/qa-gvhmr-bridge.mjs`
-compares original/cold/warm HTTP extraction including retargeted NPZ arrays.
-
-## GVHMR delayed-descent recovery
-
-The worker now defaults to observation-anchored vertical recovery for static
-camera footage. It requires a confident, large image-space descent, a stable
-observed landing, and delayed world-space descent. If the world endpoint never
-settles before the clip ends, a persistent observed landing plateau and camera
-scale recover its height instead; short or moving landings remain unchanged.
-It keeps frame count, timestamps, joint
-rotations and XZ travel; it does not classify a particular action such as bowing.
-An actual-time, segment-mass COM gravity curve is used only when it agrees with
-the observed motion. Disagreement keeps observation-based timing and is reported
-as `mode: observed-timing`, not as a physically verified flight.
-
-After retargeting, a root-only safety pass measures both shipped character skins
-with Studio's playback transforms and prevents floor penetration throughout a
-take with an accepted descent, including initial standing frames. Observation-derived endpoints are calibrated upward
-to measured skin clearance before residual floor safety, with the datum change
-distributed over the descent; after landing each pose uses its own clearance
-instead of retaining an unnecessary constant lift. Elevated landings are not forced down to the floor.
-It does not run AutoPhysics or create IK edits.
-This is not full human-scene reconstruction: moving cameras and ambiguous
-landings are skipped, and existing articulation errors can still cause small
-post-landing height variation. Metadata is in `done.performance.trajectory`,
-including rejected spans, gravity fit, timing and per-model floor clearance.
-
-Set `CCLAY_GVHMR_TRAJECTORY=0` and restart the bridge for legacy motion with
-acceleration retained. `CCLAY_GVHMR_WORKER=0` disables both stages. Previously
-extracted takes are not rewritten; re-extract the source to use the improvement.
-See `test/GVHMR-TRAJECTORY-QA.md` for actual source/Studio comparisons and limits.
-The follow-up failure, fix checklist and actual user-clip QA are recorded in
-`test/GVHMR-FOLLOWUP-QA.md`. The Studio extraction receipt now distinguishes
-applied recovery from rejected/disabled recovery and reports authored scene Y
-offsets. Playback uses elapsed time rather than one frame per delayed timer.

package/tools/ardy/artifacts.mjs

@@ -1,34 +0,0 @@
-import { chmodSync, lstatSync, mkdirSync, mkdtempSync, rmSync } from "node:fs";
-import { dirname, join } from "node:path";
-
-/**
- * Creates a mode-0700 request directory beneath a mode-0700 artifact root.
- * The atomic mkdtemp allocation makes artifact names unguessable; exclusive
- * ownership prevents a local peer from planting a symlink for a later write.
- */
-export function createPrivateArtifactDir(parentDir, label) {
-	mkdirSync(parentDir, { recursive: true, mode: 0o700 });
-	if (lstatSync(parentDir).isSymbolicLink()) {
-		throw new Error(`artifact root must not be a symlink: ${parentDir}`);
-	}
-	chmodSync(parentDir, 0o700);
-	const requestDir = mkdtempSync(join(parentDir, `${label}-`));
-	chmodSync(requestDir, 0o700);
-	return requestDir;
-}
-
-/** Removes a failed request's private artifacts without following contents. */
-export function removePrivateArtifactDir(path) {
-	rmSync(path, { recursive: true, force: true, maxRetries: 3 });
-}
-
-/** Drop one allowlist id and remove its request directory only after every
- * sibling artifact from that same request has also expired. */
-export function evictPrivateArtifact(allowlist, id) {
-	const evictedPath = allowlist.get(id);
-	allowlist.delete(id);
-	if (!evictedPath) return;
-	const artifactDir = dirname(evictedPath);
-	const siblingRemains = [...allowlist.values()].some((path) => dirname(path) === artifactDir);
-	if (!siblingRemains) removePrivateArtifactDir(artifactDir);
-}