@horizon36596/zenith-cli 0.1.1

package/dist/launcher.js

@@ -0,0 +1,153 @@
+/**
+ * Turns `zenith.json`'s `sim.command`, already split into argv, into an executable and arguments
+ * that `spawn` can start with `shell: false` on this platform. `zenith sim` and the desktop app's
+ * High-fidelity sim button both launch through this, so a command that runs in one runs in the other.
+ *
+ * The argv safety rule holds throughout:
+ * nothing here ever builds a shell string from the command's words, except for the one case Node
+ * leaves no choice about, a Windows batch file, and that is refused unless every word is one cmd.exe
+ * reads literally.
+ *
+ * Windows is the platform that needs this. `./gradlew` is a POSIX script and Node refuses to spawn a
+ * `.bat` or `.cmd` file without a shell, so on Windows a Gradle-wrapper command runs the wrapper the
+ * way `gradlew.bat` itself does, `java -classpath gradle/wrapper/gradle-wrapper.jar
+ * org.gradle.wrapper.GradleWrapperMain`, which needs no shell and lets a missing Java be reported in
+ * plain words before anything starts.
+ */
+import { existsSync } from "node:fs";
+import { posix, win32 } from "node:path";
+import { splitShellWords } from "./commands/sim.js";
+/** A sim command that cannot be launched, with a message written for the person running it. */
+export class LauncherError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LauncherError";
+    }
+}
+/** What a missing tool is, so the message can say what to install. */
+export class MissingToolError extends LauncherError {
+    tool;
+    constructor(tool, message) {
+        super(message);
+        this.tool = tool;
+        this.name = "MissingToolError";
+    }
+}
+export const hostPlatform = () => ({ platform: process.platform, env: process.env, exists: existsSync });
+const JAVA_MISSING = "High-fidelity sim runs the robot code's own simulator, which needs Java, and no Java was found on this computer. Install a Java 17 or newer JDK (Eclipse Temurin is free), then try again.";
+/** The `java` executable Gradle would use: `JAVA_HOME` first, then the `PATH`. */
+export function findJava(host = hostPlatform()) {
+    const path = host.platform === "win32" ? win32 : posix;
+    const exe = host.platform === "win32" ? "java.exe" : "java";
+    const javaHome = host.env["JAVA_HOME"];
+    if (javaHome !== undefined && javaHome.trim() !== "") {
+        const candidate = path.join(javaHome.trim().replace(/^"|"$/g, ""), "bin", exe);
+        if (host.exists(candidate))
+            return candidate;
+        throw new MissingToolError("java", `JAVA_HOME is set to ${javaHome}, but there is no ${exe} in its bin folder. Point JAVA_HOME at a Java 17 or newer JDK, or remove it, then try again.`);
+    }
+    const pathVar = host.env["PATH"] ?? host.env["Path"] ?? "";
+    for (const dir of pathVar.split(host.platform === "win32" ? ";" : ":")) {
+        if (dir.trim() === "")
+            continue;
+        const candidate = path.join(dir.trim().replace(/^"|"$/g, ""), exe);
+        if (host.exists(candidate))
+            return candidate;
+    }
+    throw new MissingToolError("java", JAVA_MISSING);
+}
+const GRADLEW = /^(?:\.[\\/])?gradlew(?:\.bat)?$/;
+/** A word cmd.exe passes through untouched: no spaces, quotes, `%`, `!`, `^`, `&`, `|`, `<`, `>` or parentheses. */
+const CMD_SAFE = /^[A-Za-z0-9_.:=/\\*+,@-]+$/;
+/** Finds `name` on the PATH the way Windows does, trying each PATHEXT extension. */
+function whichWindows(name, host) {
+    const exts = (host.env["PATHEXT"] ?? ".COM;.EXE;.BAT;.CMD").split(";").filter((ext) => ext !== "");
+    const hasExt = /\.[A-Za-z0-9]+$/.test(name);
+    const dirs = (host.env["PATH"] ?? host.env["Path"] ?? "").split(";").filter((dir) => dir.trim() !== "");
+    for (const dir of dirs) {
+        for (const ext of hasExt ? [""] : exts) {
+            const candidate = win32.join(dir.trim().replace(/^"|"$/g, ""), name + ext.toLowerCase());
+            if (host.exists(candidate))
+                return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Gradle skips a test task whose inputs have not changed since it last passed, and then no trace is
+ * written: running the sim again on an unchanged auto would only ever report a stale trace. Gradle's
+ * built-in `--rerun` task option (Gradle 7.6 and later) runs the task regardless. It is added last,
+ * where it binds to the command's last task, unless the command already forces a rerun itself.
+ */
+export function withRerun(args) {
+    return args.some((arg) => arg === "--rerun" || arg === "--rerun-tasks") ? [...args] : [...args, "--rerun"];
+}
+/**
+ * Turns the command's argv into something `spawn` can start with `shell: false` on this platform,
+ * and fails with a plain-language `LauncherError` when the tool it needs is missing or the command
+ * cannot be started safely.
+ */
+export function resolveLauncher(argv, root, host = hostPlatform()) {
+    const [command, ...rest] = argv;
+    if (command === undefined)
+        throw new LauncherError('zenith.json "sim.command" is empty.');
+    const display = argv.join(" ");
+    if (GRADLEW.test(command)) {
+        const gradleArgs = withRerun(rest);
+        const path = host.platform === "win32" ? win32 : posix;
+        const jar = path.join(root, "gradle", "wrapper", "gradle-wrapper.jar");
+        if (!host.exists(jar)) {
+            throw new MissingToolError("gradle", "This robot repository has no Gradle wrapper (gradle/wrapper/gradle-wrapper.jar), so the sim cannot start. Check that the whole repository was cloned, or open it once in Android Studio.");
+        }
+        const java = findJava(host);
+        if (host.platform !== "win32") {
+            const script = path.join(root, "gradlew");
+            if (!host.exists(script)) {
+                throw new MissingToolError("gradle", "This robot repository has no gradlew script, so the sim cannot start.");
+            }
+            return { file: script, args: gradleArgs, display };
+        }
+        // The same launch gradlew.bat performs, minus cmd.exe: its default JVM options, the app name
+        // Gradle prints in its help, the wrapper jar on the classpath, then the command's own arguments.
+        const extra = [host.env["JAVA_OPTS"], host.env["GRADLE_OPTS"]]
+            .filter((value) => value !== undefined && value.trim() !== "")
+            .flatMap((value) => splitShellWords(value));
+        return {
+            file: java,
+            args: [
+                "-Xmx64m",
+                "-Xms64m",
+                ...extra,
+                "-Dorg.gradle.appname=gradlew",
+                "-classpath",
+                jar,
+                "org.gradle.wrapper.GradleWrapperMain",
+                ...gradleArgs,
+            ],
+            display,
+        };
+    }
+    if (host.platform !== "win32")
+        return { file: command, args: rest, display };
+    const resolved = /[\\/]/.test(command) ? win32.resolve(root, command) : whichWindows(command, host);
+    if (resolved === null || !host.exists(resolved)) {
+        throw new MissingToolError(command.toLowerCase().startsWith("gradle") ? "gradle" : "command", `The sim command starts with "${command}", which is not installed or not on the PATH.${command.toLowerCase().startsWith("gradle")
+            ? " Install Gradle, or change zenith.json's sim.command to use the repository's ./gradlew."
+            : ""}`);
+    }
+    if (/\.(?:bat|cmd)$/i.test(resolved)) {
+        // Node cannot start a batch file without cmd.exe. Allow it only when every word is one cmd.exe
+        // reads literally, so nothing in the command can be taken as an operator.
+        const bad = rest.find((word) => !CMD_SAFE.test(word));
+        if (bad !== undefined || /[\s"%!^&|<>()]/.test(resolved)) {
+            throw new LauncherError(`The sim command runs a batch file, and "${bad ?? resolved}" is not safe to pass through cmd.exe. Use ./gradlew in zenith.json's sim.command instead.`);
+        }
+        return {
+            file: host.env["ComSpec"] ?? "cmd.exe",
+            args: ["/d", "/s", "/c", [resolved, ...rest].join(" ")],
+            display,
+        };
+    }
+    return { file: resolved, args: rest, display };
+}
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.js","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":"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"}

package/dist/lib.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The CLI's reusable pieces, for another host of the same logic (the desktop app's main process).
+ * This module has no side effects, unlike `index.ts`, which runs the
+ * program when it is the entry point; import it as `@horizon36596/zenith-cli/lib` from a bundle that cannot take
+ * the entry module's top-level await. `index.ts` re-exports all of it.
+ */
+export { confinePath, loadProject, ProjectError, type Project } from "./project.js";
+export { splitShellWords } from "./commands/sim.js";
+export { findJava, hostPlatform, LauncherError, MissingToolError, resolveLauncher, withRerun, type Platform, type SimLaunch, } from "./launcher.js";
+export { applyDeploy, planDeploy, type DeployAction, type DeployActionKind, type DeployPlan, } from "./commands/deploy.js";
+export { AUTO_NAME_PATTERN, loadAutoAndPlan, type LoadAutoResult, type LoadedAuto } from "./autoLoad.js";
+export { tryCore, type CoreResult } from "./coreGate.js";
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,SAAS,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,EACX,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/lib.js

@@ -0,0 +1,13 @@
+/**
+ * The CLI's reusable pieces, for another host of the same logic (the desktop app's main process).
+ * This module has no side effects, unlike `index.ts`, which runs the
+ * program when it is the entry point; import it as `@horizon36596/zenith-cli/lib` from a bundle that cannot take
+ * the entry module's top-level await. `index.ts` re-exports all of it.
+ */
+export { confinePath, loadProject, ProjectError } from "./project.js";
+export { splitShellWords } from "./commands/sim.js";
+export { findJava, hostPlatform, LauncherError, MissingToolError, resolveLauncher, withRerun, } from "./launcher.js";
+export { applyDeploy, planDeploy, } from "./commands/deploy.js";
+export { AUTO_NAME_PATTERN, loadAutoAndPlan } from "./autoLoad.js";
+export { tryCore } from "./coreGate.js";
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAgB,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,SAAS,GAGV,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,EACX,UAAU,GAIX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAwC,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,OAAO,EAAmB,MAAM,eAAe,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,33 @@
+import type { Field, Link, Robot, Waypoints } from "@horizon36596/zenith-schema";
+export declare const LINK_FILE = "zenith.json";
+export declare class ProjectError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolves `target` (a path from `zenith.json`, absolute or relative to `root`) and asserts it
+ * lands inside `root`. Every directory or file the CLI writes to or deletes from must go through
+ * this, so a `zenith.json` value like `"../ESCAPED-DEPLOY"` (or an absolute path outside the repo)
+ * is refused before any filesystem call rather than followed.
+ */
+export declare function confinePath(root: string, target: string): string;
+export interface Project {
+    /** The directory holding `zenith.json`. Every path in the link file is relative to it. */
+    root: string;
+    link: Link;
+    robot: Robot;
+    field: Field;
+    waypoints: Waypoints | undefined;
+}
+/** Walks up from a directory looking for `zenith.json`, the way git looks for `.git`. */
+export declare function findProjectRoot(from: string): string | null;
+export declare function readJsonFile(path: string): unknown;
+/**
+ * Loads `zenith.json` and the robot, field and waypoints files it points at.
+ *
+ * `autoHint` is a verb's raw `<auto>` argument (before any resolution against `autosDir`), tried
+ * as a last resort when neither `projectDir` nor walking up from `from` finds a `zenith.json`: the
+ * same "walk up from the file you were given" fallback every verb should have, not just
+ * `validate`.
+ */
+export declare function loadProject(from: string, projectDir?: string, autoHint?: string): Project;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAEjF,eAAO,MAAM,SAAS,gBAAgB,CAAC;AAEvC,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED,MAAM,WAAW,OAAO;IACtB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;CAClC;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAkBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYlD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CA4BzF"}

package/dist/project.js

@@ -0,0 +1,104 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, isAbsolute, join, relative, resolve as resolvePath } from "node:path";
+import { loadField, loadLink, loadRobot, loadWaypoints } from "@horizon36596/zenith-core";
+export const LINK_FILE = "zenith.json";
+export class ProjectError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ProjectError";
+    }
+}
+/**
+ * Resolves `target` (a path from `zenith.json`, absolute or relative to `root`) and asserts it
+ * lands inside `root`. Every directory or file the CLI writes to or deletes from must go through
+ * this, so a `zenith.json` value like `"../ESCAPED-DEPLOY"` (or an absolute path outside the repo)
+ * is refused before any filesystem call rather than followed.
+ */
+export function confinePath(root, target) {
+    const resolved = isAbsolute(target) ? resolvePath(target) : resolvePath(root, target);
+    const rel = relative(root, resolved);
+    if (rel === ".." || rel.startsWith("../") || rel.startsWith("..\\") || isAbsolute(rel)) {
+        throw new ProjectError(`"${target}" resolves outside the project root (${root}); refusing to use it.`);
+    }
+    return resolved;
+}
+/** Walks up from a directory looking for `zenith.json`, the way git looks for `.git`. */
+export function findProjectRoot(from) {
+    let current = resolvePath(from);
+    for (;;) {
+        if (existsSync(join(current, LINK_FILE)))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/**
+ * `loadProject`'s root-finding: an explicit `--project` wins outright; otherwise walk up from
+ * `from` (normally the working directory); and when that finds nothing, walk up from `autoHint`
+ * (a verb's raw auto argument) instead, so `zenith <verb> examples/starter/autos/x.auto.json` (run
+ * from the repository root, no `zenith.json` there) finds `examples/starter`'s project the same
+ * way `zenith validate` always has.
+ */
+function findProjectRootFor(from, projectDir, autoHint) {
+    if (projectDir !== undefined)
+        return resolvePath(projectDir);
+    const direct = findProjectRoot(from);
+    if (direct !== null)
+        return direct;
+    if (autoHint === undefined)
+        return null;
+    const hintPath = isAbsolute(autoHint) ? autoHint : resolvePath(from, autoHint);
+    return findProjectRoot(dirname(hintPath));
+}
+export function readJsonFile(path) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        throw new ProjectError(`Cannot read ${path}.`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new ProjectError(`${path} is not valid JSON: ${error.message}`);
+    }
+}
+/**
+ * Loads `zenith.json` and the robot, field and waypoints files it points at.
+ *
+ * `autoHint` is a verb's raw `<auto>` argument (before any resolution against `autosDir`), tried
+ * as a last resort when neither `projectDir` nor walking up from `from` finds a `zenith.json`: the
+ * same "walk up from the file you were given" fallback every verb should have, not just
+ * `validate`.
+ */
+export function loadProject(from, projectDir, autoHint) {
+    const root = findProjectRootFor(from, projectDir, autoHint);
+    if (root === null) {
+        throw new ProjectError(`No ${LINK_FILE} here or in any directory above. Run "zenith init" or pass --project <dir>.`);
+    }
+    const linkPath = join(root, LINK_FILE);
+    if (!existsSync(linkPath))
+        throw new ProjectError(`No ${LINK_FILE} in ${root}.`);
+    const link = loadLink(readJsonFile(linkPath));
+    const inRoot = (relativePath) => isAbsolute(relativePath) ? relativePath : join(root, relativePath);
+    // Every directory zenith.json names for writing (or deleting from) must resolve inside the
+    // project root; a "../ESCAPED-DEPLOY" or an absolute path is refused here, once, rather than
+    // trusted by every command that later joins a file name onto it (finding 13).
+    confinePath(root, link.autosDir);
+    if (link.deploy !== undefined)
+        confinePath(root, link.deploy.dir);
+    if (link.codegen !== undefined)
+        confinePath(root, link.codegen.dir);
+    return {
+        root,
+        link,
+        robot: loadRobot(readJsonFile(inRoot(link.robot))),
+        field: loadField(readJsonFile(inRoot(link.field))),
+        waypoints: link.waypoints === undefined ? undefined : loadWaypoints(readJsonFile(inRoot(link.waypoints))),
+    };
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"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"}

package/dist/skeletons.d.ts

@@ -0,0 +1,16 @@
+import { type MirrorMode } from "@horizon36596/zenith-core";
+import type { CommandLibrary } from "./commandLibrary.js";
+/**
+ * `zenith.json` for `zenith init`. The command library is written only when the person named one;
+ * Zenith never picks it (site/docs/command-libraries.md).
+ */
+export declare function linkSkeleton(commandLibrary?: CommandLibrary): string;
+export declare function robotSkeleton(name: string): string;
+export declare function waypointsSkeleton(): string;
+/**
+ * The skeleton auto for `zenith new`. It is laid out for RED; a BLUE one is the same routine
+ * mirrored by the field's own symmetry, `mirror`, so it starts on BLUE's half where the robot run as
+ * BLUE starts it.
+ */
+export declare function autoSkeleton(name: string, alliance?: "RED" | "BLUE", mirror?: MirrorMode): string;
+//# sourceMappingURL=skeletons.d.ts.map

package/dist/skeletons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeletons.d.ts","sourceRoot":"","sources":["../src/skeletons.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgC1D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAiBpE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6BlD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAc1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,KAAK,GAAG,MAAc,EAAE,MAAM,GAAE,UAA4B,GAAG,MAAM,CAkCzH"}

package/dist/skeletons.js

@@ -0,0 +1,120 @@
+import { canonicalize, mirrorAuto } from "@horizon36596/zenith-core";
+import { FORMAT_VERSIONS, parseAuto, parseLink, parseRobot, parseWaypoints, SCHEMA_ID, } from "@horizon36596/zenith-schema";
+/**
+ * The files `zenith init` and `zenith new` write. Each one is parsed before it is canonicalised, so
+ * a skeleton that would not validate cannot be written in the first place.
+ *
+ * Every number here carries a provenance label, because a skeleton is exactly where an invented
+ * number would otherwise slip in (CLAUDE.md rule 4).
+ */
+/**
+ * Where the skeleton auto starts, in RED's frame. A BLUE skeleton is this one mirrored, because a
+ * file's poses are in its own alliance's frame (site/docs/file-format.md). NEEDS MEASUREMENT: it is chosen to pass the BIOBUZZ field's `startRules` for
+ * `robotSkeleton`'s 18 x 14 in footprint, not measured off a real start. Facing +y, the robot's
+ * 18 in length runs along y, so y = -63 puts its back edge on the south wall (y = -72). x = -12
+ * keeps its 14 in width (x from -19 to -5) in RED's own half, clear of loadingZoneRed (on the
+ * x = -72 wall at y from +24 to +48) and of every flower (the nearest, flower3, stands on the same
+ * wall at x = +24, 29 in east of the robot's edge).
+ */
+const SKELETON_START = { xIn: -12, yIn: -63, headingRad: 1.5708 };
+/** How far the skeleton's one leg drives straight out from the wall. PLACEHOLDER. */
+const SKELETON_LEG_IN = 24;
+/**
+ * `zenith.json` for `zenith init`. The command library is written only when the person named one;
+ * Zenith never picks it (site/docs/command-libraries.md).
+ */
+export function linkSkeleton(commandLibrary) {
+    return canonicalize("link", parseLink({
+        $schema: SCHEMA_ID.link,
+        formatVersion: FORMAT_VERSIONS.link,
+        autosDir: "autos",
+        robot: "autos/robot.json",
+        field: "autos/field/biobuzz.field.json",
+        waypoints: "autos/waypoints.json",
+        deploy: {
+            kind: "androidAssets",
+            dir: "TeamCode/src/main/assets/autos",
+            ...(commandLibrary === undefined ? {} : { commandLibrary }),
+        },
+    }));
+}
+export function robotSkeleton(name) {
+    const placeholder = "NEEDS MEASUREMENT: written by zenith init";
+    return canonicalize("robot", parseRobot({
+        $schema: SCHEMA_ID.robot,
+        formatVersion: FORMAT_VERSIONS.robot,
+        name,
+        frame: { forward: "+x", left: "+y", headingZero: "+x", headingPositive: "ccw" },
+        footprint: {
+            startIn: { lengthIn: 18, widthIn: 14, provenance: placeholder },
+            expandedIn: { lengthIn: 18, widthIn: 14, provenance: placeholder },
+            centreOfRotationIn: { xIn: 0, yIn: 0, provenance: placeholder },
+        },
+        heightIn: { value: 18, provenance: placeholder },
+        kinematics: {
+            maxForwardVelInPerS: { value: 60, provenance: placeholder },
+            maxStrafeVelInPerS: { value: 50, provenance: placeholder },
+            forwardDecelInPerS2: { value: 60, provenance: placeholder },
+            strafeDecelInPerS2: { value: 30, provenance: placeholder },
+            accelInPerS2: { value: 60, provenance: placeholder },
+            maxAngularVelRadPerS: { value: 6, provenance: placeholder },
+            defaultPathSpeedFraction: { value: 0.8, provenance: placeholder },
+            follower: { library: "pedro", version: "3.0.0-20260828.185437-17", holdEnd: true },
+        },
+        commands: [],
+        conditions: [],
+    }));
+}
+export function waypointsSkeleton() {
+    return canonicalize("waypoints", parseWaypoints({
+        $schema: SCHEMA_ID.waypoints,
+        formatVersion: FORMAT_VERSIONS.waypoints,
+        waypoints: {
+            start: {
+                ...SKELETON_START,
+                provenance: "NEEDS MEASUREMENT: written by zenith init, a legal BIOBUZZ start for the skeleton robot",
+            },
+        },
+    }));
+}
+/**
+ * The skeleton auto for `zenith new`. It is laid out for RED; a BLUE one is the same routine
+ * mirrored by the field's own symmetry, `mirror`, so it starts on BLUE's half where the robot run as
+ * BLUE starts it.
+ */
+export function autoSkeleton(name, alliance = "RED", mirror = "pointSymmetry") {
+    const red = parseAuto({
+        $schema: SCHEMA_ID.auto,
+        formatVersion: FORMAT_VERSIONS.auto,
+        name,
+        title: name,
+        alliance: "RED",
+        start: {
+            pose: {
+                ...SKELETON_START,
+                provenance: "NEEDS MEASUREMENT: written by zenith new, a legal BIOBUZZ start for the skeleton robot",
+            },
+        },
+        steps: [
+            {
+                id: "leg1",
+                kind: "path",
+                segments: [
+                    {
+                        kind: "line",
+                        from: "current",
+                        to: {
+                            xIn: SKELETON_START.xIn,
+                            yIn: SKELETON_START.yIn + SKELETON_LEG_IN,
+                            provenance: "PLACEHOLDER: written by zenith new, 24 in straight out from the start",
+                        },
+                    },
+                ],
+                heading: { mode: "tangent" },
+                notes: "Replace this leg with the real opening move.",
+            },
+        ],
+    });
+    return canonicalize("auto", alliance === "RED" ? red : mirrorAuto(red, mirror));
+}
+//# sourceMappingURL=skeletons.js.map

package/dist/skeletons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeletons.js","sourceRoot":"","sources":["../src/skeletons.ts"],"names":[],"mappings":"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"}

package/dist/traceReport.d.ts

@@ -0,0 +1,75 @@
+import { type Estimate, type Plan } from "@horizon36596/zenith-core";
+/**
+ * The trace file `AutoTraceWriter` writes (site/docs/simulation.md). There
+ * is no zod schema for it in `@horizon36596/zenith-schema` - it is not one of the five file kinds the schema
+ * package owns - so this module does its own light validation, matching the writer's actual output
+ * (`robot/auto-runtime/AutoTraceWriter.java`) rather than the full spec shape, which the writer does
+ * not populate yet (`structureContacts`, `ledger` and `events` are empty until later sim batches).
+ */
+export interface TraceStep {
+    id: string;
+    startS: number;
+    endS: number;
+    interrupted: boolean;
+}
+/** `[timeS, xIn, yIn, headingRad]`. */
+export type TracePoseRow = readonly [number, number, number, number];
+export interface TraceLedgerRow {
+    timeS: number;
+    held?: number;
+    launches?: number;
+    tips?: Record<string, number>;
+}
+export interface TraceEvent {
+    timeS: number;
+    kind: string;
+    alliance?: string;
+}
+export interface TraceFile {
+    formatVersion: number;
+    auto: string;
+    simTimeS: number;
+    tickS: number;
+    capabilities: string[];
+    steps: TraceStep[];
+    poses: TracePoseRow[];
+    truthPoses: TracePoseRow[];
+    structureContacts: {
+        timeS: number;
+        obstacle: string;
+        penetrationIn: number;
+    }[];
+    ledger: TraceLedgerRow[];
+    events: TraceEvent[];
+}
+export declare class TraceParseError extends Error {
+}
+/** Parses and shape-checks a trace file, without assuming fields later sim batches have not filled. */
+export declare function parseTrace(json: unknown): TraceFile;
+export interface StepReport {
+    id: string;
+    estimateNominalS: number | null;
+    actualS: number;
+    deltaS: number | null;
+    interrupted: boolean;
+    /** Largest distance from a recorded pose to the nearest planned sample, inches. `null` for a
+     * non-path step or a trace with no poses in the step's time window. */
+    maxCrossTrackIn: number | null;
+}
+export interface SimReport {
+    auto: string;
+    simTimeS: number;
+    steps: StepReport[];
+    totalEstimateS: number | null;
+    totalActualS: number;
+    structureContacts: number;
+    launches: number;
+    tips: Record<string, number>;
+    heldAtEnd: number | null;
+    capabilities: string[];
+    /** Report sections the sim build does not measure yet, read from the trace's own capability list. */
+    inert: string[];
+}
+/** Builds the estimate-vs-actual report `zenith sim` prints, from a trace and the auto's plan. */
+export declare function buildSimReport(trace: TraceFile, plan: Plan, estimateResult: Estimate | null): SimReport;
+//# sourceMappingURL=traceReport.d.ts.map

package/dist/traceReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceReport.d.ts","sourceRoot":"","sources":["../src/traceReport.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAE7F;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,iBAAiB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChF,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAMD,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C,uGAAuG;AACvG,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAuBnD;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB;2EACuE;IACvE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qGAAqG;IACrG,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAID,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAuDvG"}