cozyclay 2.1.0 → 3.0.0

package/tools/track/rig-dump.mjs

@@ -1,227 +0,0 @@
-/**
- * rig-dump.mjs — pack a plain-JSON Studio rig dump (tools/track/export-rig.mjs
- * `dumpRig`, or the synthetic fixture test/fixtures/track-rig-dump.json) into
- * the numpy members the tracker reads (todo 6, tools/track/py/rig.py).
- *
- * Pure: no three.js, no filesystem. Everything is validated here so a bad dump
- * fails loudly instead of producing a rig the tracker silently mis-skins.
- *
- * Conventions of the packed arrays (also recorded in `meta_json`):
- *   - matrices are 4x4 ROW-major (numpy order, M @ [x, y, z, 1]); quaternions
- *     are [x, y, z, w] (three.js order).
- *   - `vertices`, `bone_rest_world`, `bone_bind_inverse`: metres, world space
- *     of the Studio rig at rest (rig root at the origin with its 0.01
- *     centimetre scale, Character scale 1, no clip-to-scene yaw). Skinning:
- *       v(pose) = sum_k w_k * boneWorld_k(pose) @ bone_bind_inverse_k @ v_rest
- *   - `bone_rest_local` and every `prep_*` array: rig units (the space BELOW
- *     the rig root, Mixamo centimetres), exactly the values
- *     src/ardy/playback.js prepOf/applyMotionFrame compute with;
- *     `rig_root_scale` (0.01) maps rig units to metres.
- *   - cskel27-indexed arrays have 27 rows; rows of joints that drive no bone
- *     are zero (vectors) / identity (matrices) with prep_bone = -1.
- *   - `meta_json` is the UTF-8 bytes of a JSON document (names, conventions),
- *     stored as int32 because writeNpz carries only float32/int32:
- *       json.loads(bytes(z["meta_json"].astype("uint8")))
- */
-
-export const RIG_DUMP_VERSION = 1;
-const CSKEL = 27;
-const INFLUENCES = 4;
-const WEIGHT_TOLERANCE = 1e-5;
-
-const IDENTITY16 = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
-
-function fail(code, detail) {
-	throw new Error(`${code}: ${detail}`);
-}
-
-function finiteList(value, length, label) {
-	if (!Array.isArray(value) || value.length !== length || !value.every(Number.isFinite)) {
-		fail("bad-rig-dump", `${label} must be ${length} finite numbers`);
-	}
-	return value;
-}
-
-/** Rows of a cskel27-indexed field; null rows become `fill`. */
-function jointRows(rows, width, fill, label) {
-	if (!Array.isArray(rows) || rows.length !== CSKEL) fail("bad-rig-dump", `${label} must have ${CSKEL} rows`);
-	const out = new Float32Array(CSKEL * width);
-	rows.forEach((row, j) => out.set(finiteList(row ?? fill, width, `${label}[${j}]`), j * width));
-	return out;
-}
-
-function intList(value, length, label, min, max) {
-	if (!Array.isArray(value) || value.length !== length || !value.every((v) => Number.isInteger(v) && v >= min && v < max)) {
-		fail("bad-rig-dump", `${label} must be ${length} integers in [${min}, ${max})`);
-	}
-	return Int32Array.from(value);
-}
-
-function nameMask(names, label, joints) {
-	if (!Array.isArray(names)) fail("bad-rig-dump", `${label} must be a list of cskel27 names`);
-	const mask = new Int32Array(CSKEL);
-	for (const name of names) {
-		const j = joints.indexOf(name);
-		if (j < 0) fail("bad-rig-dump", `${label}: ${name} is not a cskel27 joint`);
-		mask[j] = 1;
-	}
-	return mask;
-}
-
-const member = (data, shape) => ({ data, shape });
-
-/**
- * dump -> { members, meta }. `members` goes straight into
- * tools/ardy/npz.mjs writeNpz; `meta` is the decoded meta_json document.
- */
-export function rigArraysFromDump(dump) {
-	if (!dump || dump.version !== RIG_DUMP_VERSION) fail("bad-rig-dump", `version must be ${RIG_DUMP_VERSION}`);
-	const { bones, meshes, prep, cskel27 } = dump;
-	if (!(dump.rootScale > 0)) fail("bad-rig-dump", "rootScale must be positive");
-
-	// --- cskel27 reference --------------------------------------------------
-	if (!cskel27 || !Array.isArray(cskel27.joints) || cskel27.joints.length !== CSKEL) {
-		fail("bad-rig-dump", `cskel27.joints must list ${CSKEL} joints`);
-	}
-	const cskelParents = intList(cskel27.parents, CSKEL, "cskel27.parents", -1, CSKEL);
-	cskelParents.forEach((p, j) => { if (p >= j) fail("bad-rig-dump", `cskel27 parent ${p} of joint ${j} is not topological`); });
-	const neutral = jointRows(cskel27.neutral, 3, null, "cskel27.neutral");
-
-	// --- bones ---------------------------------------------------------------
-	if (!Array.isArray(bones) || bones.length === 0) fail("bad-rig-dump", "bones must be a non-empty list");
-	const B = bones.length;
-	const boneParent = new Int32Array(B);
-	const restLocal = new Float32Array(B * 16);
-	const restWorld = new Float32Array(B * 16);
-	const bindInverse = new Float32Array(B * 16);
-	bones.forEach((bone, i) => {
-		if (typeof bone.name !== "string" || !bone.name) fail("bad-rig-dump", `bones[${i}].name missing`);
-		if (!Number.isInteger(bone.parent) || bone.parent < -1 || bone.parent >= i) {
-			fail("bone-order", `bone ${i} (${bone.name}) has parent ${bone.parent}; parents must precede children`);
-		}
-		boneParent[i] = bone.parent;
-		restLocal.set(finiteList(bone.restLocal, 16, `bones[${i}].restLocal`), i * 16);
-		restWorld.set(finiteList(bone.restWorld, 16, `bones[${i}].restWorld`), i * 16);
-		bindInverse.set(finiteList(bone.bindInverse, 16, `bones[${i}].bindInverse`), i * 16);
-	});
-	const boneNames = bones.map((b) => b.name);
-	if (new Set(boneNames).size !== B) fail("bad-rig-dump", "bone names must be unique");
-
-	// --- merged mesh -----------------------------------------------------------
-	if (!Array.isArray(meshes) || meshes.length === 0) fail("bad-rig-dump", "meshes must be a non-empty list");
-	let V = 0;
-	let F = 0;
-	for (const [m, mesh] of meshes.entries()) {
-		const n = mesh.vertices?.length / 3;
-		if (!Number.isInteger(n) || n < 3) fail("bad-rig-dump", `meshes[${m}].vertices must be a flat xyz list`);
-		if (!Number.isInteger(mesh.faces?.length / 3)) fail("bad-rig-dump", `meshes[${m}].faces must be a flat triangle list`);
-		V += n;
-		F += mesh.faces.length / 3;
-	}
-	const vertices = new Float32Array(V * 3);
-	const faces = new Int32Array(F * 3);
-	const skinIndex = new Int32Array(V * INFLUENCES);
-	const skinWeight = new Float32Array(V * INFLUENCES);
-	const meshRanges = new Int32Array(meshes.length * 4);
-	let v0 = 0;
-	let f0 = 0;
-	for (const [m, mesh] of meshes.entries()) {
-		const n = mesh.vertices.length / 3;
-		const nf = mesh.faces.length / 3;
-		vertices.set(finiteList(mesh.vertices, n * 3, `meshes[${m}].vertices`), v0 * 3);
-		faces.set(intList(mesh.faces, nf * 3, `meshes[${m}].faces`, 0, n).map((i) => i + v0), f0 * 3);
-		skinIndex.set(intList(mesh.skinIndex, n * INFLUENCES, `meshes[${m}].skinIndex`, 0, B), v0 * INFLUENCES);
-		skinWeight.set(finiteList(mesh.skinWeight, n * INFLUENCES, `meshes[${m}].skinWeight`), v0 * INFLUENCES);
-		meshRanges.set([v0, n, f0, nf], m * 4);
-		v0 += n;
-		f0 += nf;
-	}
-	for (let v = 0; v < V; v += 1) {
-		let sum = 0;
-		for (let k = 0; k < INFLUENCES; k += 1) {
-			const w = skinWeight[v * INFLUENCES + k];
-			if (w < 0) fail("bad-skin-weights", `vertex ${v} has negative weight ${w}`);
-			sum += w;
-		}
-		if (Math.abs(sum - 1) > WEIGHT_TOLERANCE) fail("bad-skin-weights", `vertex ${v} weights sum to ${sum}`);
-	}
-
-	// --- Studio positional-skinning prep (playback.js prepOf) ------------------
-	if (!prep) fail("bad-rig-dump", "prep missing");
-	const prepBone = intList(prep.bones, CSKEL, "prep.bones", -1, B);
-	if (!prepBone.some((b) => b >= 0)) fail("bad-rig-dump", "prep.bones maps no cskel27 joint to a bone");
-	const chainParent = intList(prep.chainParent, CSKEL, "prep.chainParent", -1, CSKEL);
-	chainParent.forEach((p, j) => {
-		if (p >= 0 && (p >= j || prepBone[p] < 0 || prepBone[j] < 0)) fail("bad-rig-dump", `prep.chainParent[${j}]=${p} must be an earlier mapped joint`);
-	});
-	if (!(prep.scale > 0)) fail("bad-rig-dump", "prep.scale must be positive");
-	const leaves = prep.stretchedLeaves;
-	if (!Array.isArray(leaves)) fail("bad-rig-dump", "prep.stretchedLeaves must be a list");
-	const leafIndex = new Int32Array(leaves.length * 2);
-	const leafPos = new Float32Array(leaves.length * 3);
-	const leafQuat = new Float32Array(leaves.length * 4);
-	leaves.forEach((leaf, i) => {
-		leafIndex.set(intList([leaf.bone], 1, `prep.stretchedLeaves[${i}].bone`, 0, B), i * 2);
-		leafIndex.set(intList([leaf.joint], 1, `prep.stretchedLeaves[${i}].joint`, 0, CSKEL), i * 2 + 1);
-		leafPos.set(finiteList(leaf.bindLocalPos, 3, `prep.stretchedLeaves[${i}].bindLocalPos`), i * 3);
-		leafQuat.set(finiteList(leaf.bindLocalQuat, 4, `prep.stretchedLeaves[${i}].bindLocalQuat`), i * 4);
-	});
-	const hierarchyPreserved = nameMask(prep.hierarchyPreserved, "prep.hierarchyPreserved", cskel27.joints);
-	const girdle = nameMask(prep.girdleJoints, "prep.girdleJoints", cskel27.joints);
-	if (!Number.isFinite(prep.ardyNeutralMinY)) fail("bad-rig-dump", "prep.ardyNeutralMinY must be finite");
-
-	const meta = {
-		version: RIG_DUMP_VERSION,
-		model: dump.model ?? null,
-		source: dump.source ?? null,
-		boneNames,
-		meshNames: meshes.map((m) => m.name ?? ""),
-		cskel27Joints: cskel27.joints,
-		hierarchyPreservedJoints: prep.hierarchyPreserved,
-		girdleJoints: prep.girdleJoints,
-		conventions: {
-			matrices: "4x4 row-major, M @ [x, y, z, 1]",
-			quaternions: "[x, y, z, w]",
-			worldArrays: "vertices, bone_rest_world, bone_bind_inverse: metres, Studio world at rest (rig root scale applied, Character scale 1)",
-			rigArrays: "bone_rest_local, prep_*: rig units below the rig root; multiply by rig_root_scale for metres",
-			skinning: "v = sum_k w_k * boneWorld_k @ bone_bind_inverse_k @ v_rest",
-			meshRanges: "mesh_ranges[m] = [vertexStart, vertexCount, faceStart, faceCount]",
-		},
-	};
-	const metaBytes = Int32Array.from(new TextEncoder().encode(JSON.stringify(meta)));
-
-	const members = {
-		meta_json: member(metaBytes, [metaBytes.length]),
-		rig_root_scale: member(Float32Array.of(dump.rootScale), [1]),
-		vertices: member(vertices, [V, 3]),
-		faces: member(faces, [F, 3]),
-		skin_index: member(skinIndex, [V, INFLUENCES]),
-		skin_weight: member(skinWeight, [V, INFLUENCES]),
-		mesh_ranges: member(meshRanges, [meshes.length, 4]),
-		bone_parent: member(boneParent, [B]),
-		bone_rest_local: member(restLocal, [B, 4, 4]),
-		bone_rest_world: member(restWorld, [B, 4, 4]),
-		bone_bind_inverse: member(bindInverse, [B, 4, 4]),
-		prep_bone: member(prepBone, [CSKEL]),
-		prep_scale: member(Float32Array.of(prep.scale), [1]),
-		prep_offsets: member(jointRows(prep.offsets, 3, [0, 0, 0], "prep.offsets"), [CSKEL, 3]),
-		prep_bind_pos: member(jointRows(prep.bindPos, 3, [0, 0, 0], "prep.bindPos"), [CSKEL, 3]),
-		prep_bind_quat: member(jointRows(prep.bindQuat, 4, [0, 0, 0, 1], "prep.bindQuat"), [CSKEL, 4]),
-		prep_bind_scale: member(jointRows(prep.bindScale, 3, [1, 1, 1], "prep.bindScale"), [CSKEL, 3]),
-		prep_bind_local_pos: member(jointRows(prep.bindLocalPos, 3, [0, 0, 0], "prep.bindLocalPos"), [CSKEL, 3]),
-		prep_parent_bind_world: member(jointRows(prep.parentBindWorld, 16, IDENTITY16, "prep.parentBindWorld"), [CSKEL, 4, 4]),
-		prep_chain_parent: member(chainParent, [CSKEL]),
-		prep_chain_rel: member(jointRows(prep.chainRel, 16, IDENTITY16, "prep.chainRel"), [CSKEL, 4, 4]),
-		prep_canonical_bone_length: member(Float32Array.from(finiteList(prep.canonicalBoneLength, CSKEL, "prep.canonicalBoneLength")), [CSKEL]),
-		prep_rig_bone_length: member(Float32Array.from(finiteList(prep.rigBoneLength, CSKEL, "prep.rigBoneLength")), [CSKEL]),
-		prep_stretched_leaves: member(leafIndex, [leaves.length, 2]),
-		prep_stretched_leaf_local_pos: member(leafPos, [leaves.length, 3]),
-		prep_stretched_leaf_local_quat: member(leafQuat, [leaves.length, 4]),
-		hierarchy_preserved: member(hierarchyPreserved, [CSKEL]),
-		girdle_joints: member(girdle, [CSKEL]),
-		ardy_neutral_min_y: member(Float32Array.of(prep.ardyNeutralMinY), [1]),
-		cskel27_parents: member(cskelParents, [CSKEL]),
-		cskel27_neutral: member(neutral, [CSKEL, 3]),
-	};
-	return { members, meta };
-}

package/tools/track/run-box-tests.mjs

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-import { runBox } from "./run-box.mjs";
-
-const tests = process.argv.slice(2);
-if (!tests.length || tests.some(name => !/^test_[A-Za-z0-9_.-]+\.py$/.test(name))) {
-  console.error("usage: run-box-tests.mjs test_*.py [test_*.py ...]");
-  process.exit(2);
-}
-try {
-  await runBox({ entry: "pytest", args: ["-q", ...tests] });
-} catch (error) {
-  console.error(error.message);
-  process.exitCode = 1;
-}

package/tools/track/run-box.mjs

@@ -1,168 +0,0 @@
-#!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { randomBytes } from "node:crypto";
-import { mkdirSync, readdirSync, statSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-
-const here = dirname(fileURLToPath(import.meta.url));
-const host = process.env.COZYFIT_HOST || "ubuntu-baremetal";
-const sshBase = ["-o", "BatchMode=yes", "-o", "ConnectTimeout=15", "-o", "ServerAliveInterval=15", "-o", "ServerAliveCountMax=3"];
-const port = process.env.CCLAY_EXTRACT_SSH_PORT;
-const sshFlags = port ? [...sshBase, "-p", port] : sshBase;
-const scpFlags = port ? [...sshBase, "-P", port] : sshBase;
-
-export const quote = value => `'${String(value).replaceAll("'", "'\\''")}'`;
-export const idleCheck = `python3 - <<'PY'
-from pathlib import Path
-import subprocess
-busy = []
-for p in Path('/proc').iterdir():
-    if not p.name.isdigit(): continue
-    try:
-        argv = (p/'cmdline').read_bytes().split(b'\\0')
-        executable = Path(argv[0].decode(errors='replace')).name
-        cmd = b' '.join(argv).decode(errors='replace')
-    except (FileNotFoundError, ProcessLookupError, PermissionError): continue
-    if 'python' in executable and ('cclay_gvhmr' in cmd or 'cclay_bench' in cmd): busy.append(cmd)
-usage = subprocess.check_output(['nvidia-smi','--query-compute-apps=used_memory','--format=csv,noheader,nounits'], text=True)
-used = sum(int(v.strip()) for v in usage.splitlines() if v.strip())
-if busy or used > 1600:
-    raise SystemExit('gpu-busy: ' + repr(busy) + '; compute memory=' + str(used) + ' MiB')
-print('GPU idle for GVHMR; compute memory=' + str(used) + ' MiB')
-PY`;
-
-export function gpuBusyDecision({ processes = [], usedMiB = 0 } = {}) {
-  return processes.some(command => /(?:^|\s)python(?:\d(?:\.\d+)?)?(?:\s|$)/.test(command) && (command.includes("cclay_gvhmr") || command.includes("cclay_bench"))) || usedMiB > 1600;
-}
-
-export function buildRemoteCommand(remote, entry, args = []) {
-  if (entry !== "pytest" && !/^[A-Za-z0-9_.-]+\.py$/.test(entry)) throw new Error(`invalid Python entry: ${entry}`);
-  const executable = entry === "pytest" ? "$HOME/cclay-ingest/cozyfit/.venv/bin/pytest" : "$HOME/cclay-ingest/cozyfit/.venv/bin/python";
-  const target = entry === "pytest" ? "" : ` ${quote(join(remote, entry))}`;
-  return `set -e\n${idleCheck}\ncd ${quote(remote)}\nexec ${executable}${target}${args.length ? ` ${args.map(quote).join(" ")}` : ""}`;
-}
-
-function exec(program, args, { onLine } = {}) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(program, args, { stdio: ["ignore", "pipe", "pipe"] });
-    let output = "", pending = "";
-    const onData = chunk => {
-      const text = String(chunk);
-      process.stdout.write(text);
-      output += text;
-      pending += text;
-      const lines = pending.split(/\\r?\\n/);
-      pending = lines.pop() ?? "";
-      for (const line of lines) if (line) onLine?.(line);
-    };
-    child.stdout.on("data", onData); child.stderr.on("data", onData);
-    child.once("error", reject);
-    child.once("close", code => {
-      if (pending) onLine?.(pending);
-      code === 0 ? resolve(output) : reject(new Error(`${program} exited ${code}: ${output.slice(-4000)}`));
-    });
-  });
-}
-
-function pyFiles(root) {
-  return readdirSync(root).filter(name => name.endsWith(".py") && statSync(join(root, name)).isFile()).sort();
-}
-
-function transfer(item, kind) {
-  if (typeof item === "string") {
-    const separator = item.indexOf(":");
-    if (separator < 1 || separator === item.length - 1) throw new Error(`${kind} must be ${kind === "upload" ? "localPath:remoteRelPath" : "remoteRelPath:localPath"}`);
-    return kind === "upload"
-      ? { localPath: item.slice(0, separator), remoteRelPath: item.slice(separator + 1) }
-      : { remoteRelPath: item.slice(0, separator), localPath: item.slice(separator + 1) };
-  }
-  const localPath = item?.localPath ?? item?.path;
-  const remoteRelPath = item?.remoteRelPath ?? item?.remotePath;
-  if (typeof localPath !== "string" || typeof remoteRelPath !== "string") throw new Error(`${kind} requires localPath and remoteRelPath`);
-  return { localPath, remoteRelPath };
-}
-
-function safeRemoteRelPath(path) {
-  if (!path || path.startsWith("/") || path.split("/").includes("..")) throw new Error(`unsafe remote relative path: ${path}`);
-  return path;
-}
-
-export function normalizeTransfers(items = [], kind) {
-  return items.map(item => {
-    const value = transfer(item, kind);
-    return { ...value, remoteRelPath: safeRemoteRelPath(value.remoteRelPath) };
-  });
-}
-
-/**
- * Upload, run and fetch. When the remote command fails, every requested output
- * that exists is still fetched (a failed tracker writes diagnostics.json), and
- * the command's own error is rethrown with `fetched` = local paths retrieved.
- * A missing output on a failed run never replaces that error. `spawnCommand`
- * is the (program, args, {onLine}) -> Promise<output> seam for tests.
- */
-export async function runBox({ entry, args = [], hostName = host, onLine, upload = [], fetch = [], spawnCommand = exec } = {}) {
-  if (!entry) throw new Error("usage: run-box.mjs <entry.py> [args...]");
-  if (entry !== "pytest" && !/^[A-Za-z0-9_.-]+\.py$/.test(entry)) throw new Error(`invalid Python entry: ${entry}`);
-  const uploads = normalizeTransfers(upload, "upload");
-  const fetches = normalizeTransfers(fetch, "fetch");
-  const remote = `/tmp/cozyfit-${Date.now()}-${randomBytes(5).toString("hex")}`;
-  const ssh = (command, options = {}) => spawnCommand("ssh", [...sshFlags, hostName, command], options);
-  const scp = (source, destination, options = {}) => spawnCommand("scp", [...scpFlags, source, destination], options);
-  const stream = { onLine };
-  let failure, output;
-  try {
-    await ssh(`umask 077 && mkdir -p ${quote(remote)}`, stream);
-    for (const name of pyFiles(join(here, "py"))) await scp(join(here, "py", name), `${hostName}:${join(remote, name)}`);
-    for (const item of uploads) {
-      await ssh(`mkdir -p ${quote(join(remote, item.remoteRelPath, ".."))}`, stream);
-      await scp(item.localPath, `${hostName}:${join(remote, item.remoteRelPath)}`);
-    }
-    let runError;
-    try { output = await ssh(buildRemoteCommand(remote, entry, args), stream); }
-    catch (error) { runError = error; }
-    const fetched = [];
-    for (const item of fetches) {
-      mkdirSync(join(item.localPath, ".."), { recursive: true });
-      if (!runError) {
-        await scp(`${hostName}:${join(remote, item.remoteRelPath)}`, item.localPath);
-        fetched.push(item.localPath);
-        continue;
-      }
-      // Best effort after a failed command: absent outputs are expected.
-      try {
-        await scp(`${hostName}:${join(remote, item.remoteRelPath)}`, item.localPath);
-        fetched.push(item.localPath);
-      } catch { /* the command error below is the reported failure */ }
-    }
-    if (runError) {
-      runError.fetched = fetched;
-      throw runError;
-    }
-    return fetches.length ? { output, fetched } : output;
-  } catch (error) {
-    failure = error;
-    throw error;
-  } finally {
-    try { await ssh(`rm -rf ${quote(remote)}`); }
-    catch (cleanupError) { if (failure) throw new AggregateError([failure, cleanupError], `box cleanup failed: ${remote}`); throw cleanupError; }
-  }
-}
-
-if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
-  const argv = process.argv.slice(2), entry = argv.shift();
-  const args = [], upload = [], fetch = [];
-  for (let i = 0; i < argv.length; i++) {
-    const flag = argv[i];
-    if (flag === "--fetch" || flag === "--upload") {
-      const value = argv[++i];
-      if (!value) throw new Error(`${flag} requires a value`);
-      (flag === "--fetch" ? fetch : upload).push(value);
-    } else args.push(flag);
-  }
-  runBox({ entry, args, upload, fetch }).catch(error => {
-    console.error(error.message);
-    process.exitCode = 1;
-  });
-}

package/tools/track/setup-box.sh

@@ -1,59 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT="$HOME/cclay-ingest/cozyfit"
-VENV="$ROOT/.venv"
-PYTHON="$VENV/bin/python"
-GVHMR_PY="$HOME/cclay-ingest/GVHMR/.venv/bin/python"
-
-if [[ ! -x "$GVHMR_PY" ]]; then
-  echo "missing GVHMR interpreter: $GVHMR_PY" >&2
-  exit 1
-fi
-read -r PY_MAJOR PY_MINOR < <("$GVHMR_PY" -c 'import sys; print(sys.version_info.major, sys.version_info.minor)')
-PY_BIN="python${PY_MAJOR}.${PY_MINOR}"
-if ! command -v "$PY_BIN" >/dev/null 2>&1; then
-  echo "missing matching Python minor: $PY_BIN" >&2
-  exit 1
-fi
-
-mkdir -p "$ROOT/checkpoints"
-if [[ ! -x "$PYTHON" ]]; then
-  "$PY_BIN" -m venv "$VENV"
-fi
-
-# Keep all installs in CozyFit's venv. In particular, never invoke or modify
-# the existing GVHMR environment after reading its Python minor above.
-pip_install() {
-  "$PYTHON" - "$@" <<'PY'
-import subprocess
-import sys
-subprocess.run([sys.executable, "-m", "pip", "install", *sys.argv[1:]], check=True, timeout=1200)
-PY
-}
-pip_install --upgrade pip setuptools wheel
-pip_install \
-  --index-url https://download.pytorch.org/whl/cu121 \
-  --extra-index-url https://pypi.org/simple \
-  'torch==2.5.1+cu121' 'torchvision==0.20.1+cu121'
-pip_install \
-  'git+https://github.com/facebookresearch/sam2.git' \
-  fast-simplification numpy scipy opencv-python-headless pytest
-
-CHECKPOINT="$ROOT/checkpoints/sam2.1_hiera_small.pt"
-if [[ ! -s "$CHECKPOINT" ]]; then
-  tmp="$CHECKPOINT.tmp.$$"
-  trap 'rm -f "$tmp"' EXIT
-  curl --fail --location --retry 3 --connect-timeout 15 --max-time 900 \
-    -o "$tmp" \
-    https://dl.fbaipublicfiles.com/segment_anything_2/092824/sam2.1_hiera_small.pt
-  mv "$tmp" "$CHECKPOINT"
-  trap - EXIT
-fi
-
-"$PYTHON" - <<'PY'
-import torch
-assert torch.__version__.startswith("2.5.1+cu121"), torch.__version__
-import sam2
-print("cozyfit environment ready", torch.__version__, sam2.__file__)
-PY