@horizon36596/zenith-cli 0.1.1

package/dist/commands/estimate.js

@@ -0,0 +1,81 @@
+import { relative } from "node:path";
+import { estimate as coreEstimate, hasErrors } from "@horizon36596/zenith-core";
+import { loadAutoAndPlan, resolveAutoPath } from "../autoLoad.js";
+import { CORE_NOT_LANDED_EXIT_CODE, tryCore } from "../coreGate.js";
+import { formatFindingsTable } from "../findings.js";
+import { loadProject } from "../project.js";
+const slash = (path) => path.split("\\").join("/");
+const pad = (text, width) => (text.length >= width ? text : text + " ".repeat(width - text.length));
+function range(nominalS, lowS, highS) {
+    if (nominalS === null)
+        return "unknown";
+    if (lowS === null || highS === null)
+        return nominalS.toFixed(2);
+    return `${nominalS.toFixed(2)} (${lowS.toFixed(2)}–${highS.toFixed(2)})`;
+}
+function formatTable(estimateResult, periodS) {
+    const lines = [];
+    const idWidth = Math.max(2, ...estimateResult.steps.map((step) => step.stepId.length));
+    lines.push(`${pad("step", idWidth)}  nominal (low–high) s   strafe  unknown`);
+    for (const step of estimateResult.steps) {
+        const unknown = step.nominalS === null ? "yes" : "";
+        const strafe = step.strafeFraction === null ? "–" : `${(step.strafeFraction * 100).toFixed(0)} %`;
+        lines.push(`${pad(step.stepId, idWidth)}  ${pad(range(step.nominalS, step.lowS, step.highS), 22)}  ${pad(strafe, 6)}  ${unknown}`);
+    }
+    const total = `${range(estimateResult.nominalS, estimateResult.lowS, estimateResult.highS)}${estimateResult.hasUnknown ? "+" : ""}`;
+    lines.push(periodS === undefined ? `total: ${total}` : `total: ${total} of ${String(periodS)} s`);
+    return lines.join("\n");
+}
+/** `zenith estimate <auto> [--json] [--explain]`: the per-step time table of `03` section 3. */
+export function runEstimate(autoArg, options) {
+    const cwd = options.cwd ?? process.cwd();
+    const project = loadProject(cwd, options.project, autoArg);
+    const path = resolveAutoPath(cwd, project, autoArg);
+    const relPath = slash(relative(project.root, path));
+    const result = loadAutoAndPlan(path, project);
+    const findings = result.ok ? result.loaded.findings : result.findings;
+    if (!result.ok || hasErrors(findings)) {
+        const files = [{ path: relPath, findings }];
+        if (options.json === true) {
+            process.stdout.write(`${JSON.stringify({ project: slash(project.root), files, errors: findings.length }, null, 2)}\n`);
+        }
+        else {
+            process.stdout.write(`${formatFindingsTable(files)}\n`);
+        }
+        return 1;
+    }
+    const outcome = tryCore(() => coreEstimate(result.loaded.plan, result.loaded.robot));
+    if (!outcome.ok) {
+        if (options.json === true) {
+            process.stdout.write(`${JSON.stringify({ error: outcome.message }, null, 2)}\n`);
+        }
+        else {
+            process.stderr.write(`${outcome.message}\n`);
+        }
+        return CORE_NOT_LANDED_EXIT_CODE;
+    }
+    const periodS = result.loaded.field.periods?.autoS;
+    const seasonWarnings = result.loaded.seasonWarnings;
+    if (options.json === true) {
+        process.stdout.write(`${JSON.stringify({
+            project: slash(project.root),
+            auto: relPath,
+            periodS: periodS ?? null,
+            estimate: outcome.value,
+            assumptions: options.explain === true ? outcome.value.assumptions : undefined,
+            seasonWarnings,
+        }, null, 2)}\n`);
+    }
+    else {
+        for (const warning of seasonWarnings)
+            process.stderr.write(`warning: ${relPath}: ${warning}\n`);
+        process.stdout.write(`${formatTable(outcome.value, periodS)}\n`);
+        if (options.explain === true) {
+            process.stdout.write("\nassumptions:\n");
+            for (const line of outcome.value.assumptions)
+                process.stdout.write(`  - ${line}\n`);
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=estimate.js.map

package/dist/commands/estimate.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,10 @@
+export interface InitOptions {
+    cwd?: string;
+    force?: boolean;
+    json?: boolean;
+    /** `--command-library`: written to `deploy.commandLibrary`. Left out of the file when not given. */
+    commandLibrary?: string;
+}
+/** `zenith init`: writes zenith.json and an autos directory that validates. */
+export declare function runInit(options: InitOptions): number;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA8BD,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAuCpD"}

package/dist/commands/init.js

@@ -0,0 +1,67 @@
+import { copyFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { basename, dirname, join, resolve as resolvePath } from "node:path";
+import { LIBRARIES } from "../commandLibrary.js";
+import { LINK_FILE, ProjectError } from "../project.js";
+import { linkSkeleton, robotSkeleton, waypointsSkeleton } from "../skeletons.js";
+function write(root, relative, contents, force) {
+    const full = join(root, relative);
+    if (existsSync(full) && !force)
+        return { path: relative, status: "kept" };
+    mkdirSync(dirname(full), { recursive: true });
+    writeFileSync(full, contents, "utf8");
+    return { path: relative, status: "written" };
+}
+/** Copies the season's field file out of `@horizon36596/zenith-season-biobuzz` when it can be resolved. */
+function copySeasonField(root, relative, force) {
+    const full = join(root, relative);
+    if (existsSync(full) && !force)
+        return { path: relative, status: "kept" };
+    try {
+        const require = createRequire(import.meta.url);
+        const source = require.resolve("@horizon36596/zenith-season-biobuzz/field/biobuzz.field.json");
+        mkdirSync(dirname(full), { recursive: true });
+        copyFileSync(source, full);
+        return { path: relative, status: "written" };
+    }
+    catch {
+        return null;
+    }
+}
+/** `zenith init`: writes zenith.json and an autos directory that validates. */
+export function runInit(options) {
+    const root = resolvePath(options.cwd ?? process.cwd());
+    const force = options.force === true;
+    // Any case is accepted on the command line (`--command-library Ivy`); the file always gets the
+    // lowercase name, which is the only form the schema accepts.
+    const commandLibrary = options.commandLibrary?.toLowerCase();
+    if (commandLibrary !== undefined && !LIBRARIES.includes(commandLibrary)) {
+        throw new ProjectError(`--command-library must be "solverslib" or "ivy", not ${JSON.stringify(options.commandLibrary)}.`);
+    }
+    const library = commandLibrary;
+    const written = [
+        write(root, LINK_FILE, linkSkeleton(library), force),
+        write(root, "autos/robot.json", robotSkeleton(basename(root)), force),
+        write(root, "autos/waypoints.json", waypointsSkeleton(), force),
+    ];
+    const season = copySeasonField(root, "autos/field/biobuzz.field.json", force);
+    if (season !== null)
+        written.push(season);
+    if (options.json === true) {
+        process.stdout.write(`${JSON.stringify({ root, commandLibrary: library ?? null, written }, null, 2)}\n`);
+        return 0;
+    }
+    for (const file of written)
+        process.stdout.write(`${file.status}: ${file.path}\n`);
+    if (season === null) {
+        process.stdout.write("note: no season field file was copied. Put one at autos/field/biobuzz.field.json.\n");
+    }
+    if (library === undefined) {
+        process.stdout.write('note: zenith.json names no command library yet. Add "commandLibrary": "solverslib" or "commandLibrary": "ivy" ' +
+            'to its "deploy" section, or re-run with --command-library, before Zenith writes Java: zenith codegen, ' +
+            'or zenith deploy once zenith.json has a "codegen" section.\n');
+    }
+    process.stdout.write('Next: "zenith new <name>", then "zenith validate autos/<name>.auto.json".\n');
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAuB,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAejF,SAAS,KAAK,CAAC,IAAY,EAAE,QAAgB,EAAE,QAAgB,EAAE,KAAc;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1E,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/C,CAAC;AAED,2GAA2G;AAC3G,SAAS,eAAe,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAc;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,8DAA8D,CAAC,CAAC;QAC/F,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,OAAoB;IAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;IACrC,+FAA+F;IAC/F,6DAA6D;IAC7D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC;IAC7D,IAAI,cAAc,KAAK,SAAS,IAAI,CAAE,SAA+B,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,YAAY,CACpB,wDAAwD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAClG,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,cAA4C,CAAC;IAC7D,MAAM,OAAO,GAAc;QACzB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;QACpD,KAAK,CAAC,IAAI,EAAE,kBAAkB,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC;QACrE,KAAK,CAAC,IAAI,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,EAAE,KAAK,CAAC;KAChE,CAAC;IACF,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,gCAAgC,EAAE,KAAK,CAAC,CAAC;IAC9E,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE1C,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACzG,OAAO,CAAC,CAAC;IACX,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,OAAO;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IACnF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qFAAqF,CACtF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gHAAgH;YAC9G,wGAAwG;YACxG,8DAA8D,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACpG,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/new.d.ts

@@ -0,0 +1,10 @@
+export interface NewOptions {
+    cwd?: string;
+    project?: string;
+    alliance?: string;
+    json?: boolean;
+    force?: boolean;
+}
+/** `zenith new <name>`: writes a canonical skeleton into the project's autos directory. */
+export declare function runNew(name: string, options: NewOptions): number;
+//# sourceMappingURL=new.d.ts.map

package/dist/commands/new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,2FAA2F;AAC3F,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAoBhE"}

package/dist/commands/new.js

@@ -0,0 +1,28 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve as resolvePath } from "node:path";
+import { mirrorForField } from "@horizon36596/zenith-core";
+import { findProjectRoot, loadProject, ProjectError } from "../project.js";
+import { autoSkeleton } from "../skeletons.js";
+/** `zenith new <name>`: writes a canonical skeleton into the project's autos directory. */
+export function runNew(name, options) {
+    const cwd = options.cwd ?? process.cwd();
+    const project = loadProject(cwd, options.project);
+    const root = options.project === undefined ? (findProjectRoot(cwd) ?? cwd) : resolvePath(options.project);
+    const alliance = (options.alliance ?? "RED").toUpperCase();
+    if (alliance !== "RED" && alliance !== "BLUE") {
+        throw new ProjectError(`--alliance must be RED or BLUE, not ${JSON.stringify(alliance)}.`);
+    }
+    const relative = `${project.link.autosDir}/${name}.auto.json`;
+    const full = join(root, relative);
+    if (existsSync(full) && options.force !== true) {
+        throw new ProjectError(`${relative} already exists. Pass --force to overwrite it.`);
+    }
+    mkdirSync(dirname(full), { recursive: true });
+    writeFileSync(full, autoSkeleton(name, alliance, mirrorForField(project.field)), "utf8");
+    if (options.json === true)
+        process.stdout.write(`${JSON.stringify({ written: relative }, null, 2)}\n`);
+    else
+        process.stdout.write(`written: ${relative}\n`);
+    return 0;
+}
+//# sourceMappingURL=new.js.map

package/dist/commands/new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAU/C,2FAA2F;AAC3F,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,OAAmB;IACtD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1G,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC9C,MAAM,IAAI,YAAY,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,YAAY,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC/C,MAAM,IAAI,YAAY,CAAC,GAAG,QAAQ,gDAAgD,CAAC,CAAC;IACtF,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAEzF,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;;QAClG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,QAAQ,IAAI,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/propose.d.ts

@@ -0,0 +1,15 @@
+export interface ProposeOptions {
+    cwd?: string;
+    project?: string;
+    json?: boolean;
+    dryRun?: boolean;
+    base?: string;
+}
+/**
+ * `zenith propose <auto> [--dry-run]`: the CLI half of site/docs/github.md. The GitHub half (a work
+ * branch, a commit, an actual pull request) is another agent's (`packages/github`); today only
+ * `--dry-run` is implemented, exactly as section 5 describes for an agent that may not push:
+ * validate, render, print the PR body for a human to paste.
+ */
+export declare function runPropose(autoArg: string, options: ProposeOptions): number;
+//# sourceMappingURL=propose.d.ts.map

package/dist/commands/propose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../src/commands/propose.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAyD3E"}

package/dist/commands/propose.js

@@ -0,0 +1,67 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { estimate as coreEstimate, hasErrors, ledger as coreLedger, prBody, render as coreRender } from "@horizon36596/zenith-core";
+import { resolveSeason } from "@horizon36596/zenith-seasons";
+import { loadAutoAndPlan, resolveAutoPath } from "../autoLoad.js";
+import { tryCore } from "../coreGate.js";
+import { formatFindingsTable } from "../findings.js";
+import { confinePath, loadProject } from "../project.js";
+const slash = (path) => path.split("\\").join("/");
+/**
+ * `zenith propose <auto> [--dry-run]`: the CLI half of site/docs/github.md. The GitHub half (a work
+ * branch, a commit, an actual pull request) is another agent's (`packages/github`); today only
+ * `--dry-run` is implemented, exactly as section 5 describes for an agent that may not push:
+ * validate, render, print the PR body for a human to paste.
+ */
+export function runPropose(autoArg, options) {
+    if (options.dryRun !== true) {
+        process.stderr.write("GitHub mode: use the web app or pass --dry-run.\n");
+        return 2;
+    }
+    const cwd = options.cwd ?? process.cwd();
+    const project = loadProject(cwd, options.project, autoArg);
+    const path = resolveAutoPath(cwd, project, autoArg);
+    const result = loadAutoAndPlan(path, project);
+    const findings = result.ok ? result.loaded.findings : result.findings;
+    if (!result.ok || hasErrors(findings)) {
+        const files = [{ path: autoArg, findings }];
+        if (options.json === true)
+            process.stdout.write(`${JSON.stringify({ files }, null, 2)}\n`);
+        else
+            process.stdout.write(`${formatFindingsTable(files)}\n`);
+        return 1;
+    }
+    const { auto, plan, robot, field, seasonWarnings } = result.loaded;
+    const estimateOutcome = tryCore(() => coreEstimate(plan, robot));
+    const ledgerOutcome = tryCore(() => coreLedger(plan, field, resolveSeason(field).rules));
+    const renderOutcome = tryCore(() => coreRender(plan, estimateOutcome.ok ? estimateOutcome.value : null, findings, ledgerOutcome.ok ? ledgerOutcome.value : [], {}));
+    if (!renderOutcome.ok) {
+        const message = [renderOutcome.message, !estimateOutcome.ok ? estimateOutcome.message : null, !ledgerOutcome.ok ? ledgerOutcome.message : null]
+            .filter((line) => line !== null)
+            .join("\n");
+        if (options.json === true)
+            process.stdout.write(`${JSON.stringify({ error: message }, null, 2)}\n`);
+        else
+            process.stderr.write(`${message}\n`);
+        return 2;
+    }
+    const renderRelative = `${project.link.autosDir}/.renders/${auto.name}.svg`;
+    const renderFull = confinePath(project.root, renderRelative);
+    mkdirSync(dirname(renderFull), { recursive: true });
+    writeFileSync(renderFull, renderOutcome.value, "utf8");
+    // No commit has happened in --dry-run mode, so there is no raw GitHub URL to point at (that is
+    // packages/github's propose() once GitHub mode lands); the local render path is the closest
+    // useful thing to show a human in the meantime, passed straight in rather than substituted after
+    // the fact.
+    const body = prBody(auto, estimateOutcome.ok ? estimateOutcome.value : null, findings, ledgerOutcome.ok ? ledgerOutcome.value : [], { periodS: field.periods?.autoS, renderUrl: slash(renderRelative) });
+    if (options.json === true) {
+        process.stdout.write(`${JSON.stringify({ render: renderRelative, body, seasonWarnings }, null, 2)}\n`);
+    }
+    else {
+        for (const warning of seasonWarnings)
+            process.stderr.write(`warning: ${autoArg}: ${warning}\n`);
+        process.stdout.write(`${body}\n`);
+    }
+    return 0;
+}
+//# sourceMappingURL=propose.js.map

package/dist/commands/propose.js.map

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

package/dist/commands/render.d.ts

@@ -0,0 +1,16 @@
+export interface RenderCommandOptions {
+    cwd?: string;
+    project?: string;
+    json?: boolean;
+    svg?: string;
+    png?: string;
+    alliance?: string;
+    base?: string;
+}
+/**
+ * `zenith render <auto> --svg <out> | --png <out> [--alliance BLUE] [--base <otherAuto>]`.
+ * `--png` shells out to `@resvg/resvg-js`, a CLI-only dependency (`core` stays DOM-free); it is
+ * imported lazily so `--svg` never needs it installed.
+ */
+export declare function runRender(autoArg: string, options: RenderCommandOptions): Promise<number>;
+//# sourceMappingURL=render.d.ts.map

package/dist/commands/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/commands/render.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6E/F"}

package/dist/commands/render.js

@@ -0,0 +1,90 @@
+import { writeFileSync } from "node:fs";
+import { isAbsolute, resolve as resolvePath } from "node:path";
+import { estimate as coreEstimate, ledger as coreLedger, render as coreRender, } from "@horizon36596/zenith-core";
+import { resolveSeason } from "@horizon36596/zenith-seasons";
+import { loadAutoAndPlan, resolveAutoPath } from "../autoLoad.js";
+import { CORE_NOT_LANDED_EXIT_CODE, tryCore } from "../coreGate.js";
+import { fieldImageFor } from "../fieldImage.js";
+import { formatFindingsTable } from "../findings.js";
+import { loadProject, ProjectError } from "../project.js";
+/**
+ * `zenith render <auto> --svg <out> | --png <out> [--alliance BLUE] [--base <otherAuto>]`.
+ * `--png` shells out to `@resvg/resvg-js`, a CLI-only dependency (`core` stays DOM-free); it is
+ * imported lazily so `--svg` never needs it installed.
+ */
+export async function runRender(autoArg, options) {
+    if (options.svg === undefined && options.png === undefined) {
+        throw new ProjectError("zenith render needs --svg <out> or --png <out>.");
+    }
+    const cwd = options.cwd ?? process.cwd();
+    const project = loadProject(cwd, options.project, autoArg);
+    const path = resolveAutoPath(cwd, project, autoArg);
+    const result = loadAutoAndPlan(path, project);
+    if (!result.ok) {
+        const files = [{ path: autoArg, findings: result.findings }];
+        process.stdout.write(options.json === true ? `${JSON.stringify({ files }, null, 2)}\n` : `${formatFindingsTable(files)}\n`);
+        return 1;
+    }
+    const { plan, robot, field, findings, seasonWarnings } = result.loaded;
+    let alliance;
+    if (options.alliance !== undefined) {
+        const upper = options.alliance.toUpperCase();
+        if (upper !== "RED" && upper !== "BLUE") {
+            throw new ProjectError(`--alliance must be RED or BLUE, not ${JSON.stringify(options.alliance)}.`);
+        }
+        alliance = upper;
+    }
+    if (options.base !== undefined) {
+        const basePath = resolveAutoPath(cwd, project, options.base);
+        const baseResult = loadAutoAndPlan(basePath, project);
+        if (!baseResult.ok) {
+            process.stderr.write(`--base ${options.base} did not load: ${baseResult.findings[0]?.message ?? "unknown error"}\n`);
+            return 2;
+        }
+        // core.render's current signature (packages/core/src/types.ts RenderOptions) has no field for a
+        // second plan to ghost. The auto still has to load cleanly - that much is worth checking now -
+        // but the overlay itself waits on that option landing with the rest of M1.
+        process.stderr.write("note: --base loaded but core.render does not yet support a base overlay (pending M1).\n");
+    }
+    const estimateOutcome = tryCore(() => coreEstimate(plan, robot));
+    const estimateValue = estimateOutcome.ok ? estimateOutcome.value : null;
+    const ledgerOutcome = tryCore(() => coreLedger(plan, field, resolveSeason(field).rules));
+    const ledgerValue = ledgerOutcome.ok ? ledgerOutcome.value : [];
+    const fieldImage = fieldImageFor(project, field, plan.auto.field ?? project.link.field);
+    const renderOptions = {
+        ...(alliance === undefined ? {} : { alliance }),
+        ...(fieldImage === undefined ? {} : { fieldImage }),
+    };
+    const renderOutcome = tryCore(() => coreRender(plan, estimateValue, findings, ledgerValue, renderOptions));
+    if (!renderOutcome.ok) {
+        if (options.json === true)
+            process.stdout.write(`${JSON.stringify({ error: renderOutcome.message }, null, 2)}\n`);
+        else
+            process.stderr.write(`${renderOutcome.message}\n`);
+        return CORE_NOT_LANDED_EXIT_CODE;
+    }
+    const svgText = renderOutcome.value;
+    const written = [];
+    const outPath = (relativeOrAbsolute) => isAbsolute(relativeOrAbsolute) ? relativeOrAbsolute : resolvePath(cwd, relativeOrAbsolute);
+    if (options.svg !== undefined) {
+        writeFileSync(outPath(options.svg), svgText, "utf8");
+        written.push({ path: options.svg, kind: "svg" });
+    }
+    if (options.png !== undefined) {
+        const { Resvg } = await import("@resvg/resvg-js");
+        const png = new Resvg(svgText, { font: { loadSystemFonts: true } }).render().asPng();
+        writeFileSync(outPath(options.png), png);
+        written.push({ path: options.png, kind: "png" });
+    }
+    if (options.json === true) {
+        process.stdout.write(`${JSON.stringify({ written, findings, seasonWarnings }, null, 2)}\n`);
+    }
+    else {
+        for (const warning of seasonWarnings)
+            process.stderr.write(`warning: ${autoArg}: ${warning}\n`);
+        for (const file of written)
+            process.stdout.write(`written: ${file.path}\n`);
+    }
+    return 0;
+}
+//# sourceMappingURL=render.js.map

package/dist/commands/render.js.map

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

package/dist/commands/sim.d.ts

@@ -0,0 +1,31 @@
+import { spawn } from "node:child_process";
+import { type Platform } from "../launcher.js";
+/**
+ * Splits a command line into argv words the way a POSIX shell would, without ever handing the
+ * string to a shell: single quotes are fully literal, double quotes allow `\"`, `\\`, `` \` `` and
+ * `\$` to escape, and an unquoted backslash escapes the next character. `sim.command` in
+ * `zenith.json` is the team's own string (not attacker input), so this only needs to parse it the
+ * way a person reading it would, not defend against a hostile one; the actual security boundary is
+ * that `{auto}` is substituted in only after `auto.name` has already been validated against
+ * `AUTO_NAME_PATTERN`, so no token it lands in can ever contain a quote, space or shell
+ * metacharacter, and the whole argv array is then spawned with `shell: false`.
+ */
+export declare function splitShellWords(command: string): string[];
+export interface SimCommandOptions {
+    cwd?: string;
+    project?: string;
+    json?: boolean;
+    open?: boolean;
+    /** Seconds. The sim command is killed if it runs longer than this. */
+    timeout?: number;
+    /** Test seam: replaces `node:child_process.spawn`. */
+    spawnFn?: typeof spawn;
+    /** Test seam: the host the launcher resolves the command for (`launcher.ts`). */
+    host?: Platform;
+}
+/**
+ * `zenith sim <auto> [--open] [--timeout <s>]`: runs `zenith.json.sim.command`, reads the trace it
+ * writes, and prints estimate vs actual per step (site/docs/simulation.md).
+ */
+export declare function runSim(autoArg: string, options: SimCommandOptions): Promise<number>;
+//# sourceMappingURL=sim.d.ts.map

package/dist/commands/sim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim.d.ts","sourceRoot":"","sources":["../../src/commands/sim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAQ9D,OAAO,EAAiC,KAAK,QAAQ,EAAkB,MAAM,gBAAgB,CAAC;AAI9F;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAuDzD;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,iFAAiF;IACjF,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAqED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8EzF"}