@horizon36596/zenith-cli 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { VERSION } from "./version.js";
+export * from "./lib.js";
+export { VERSION };
+/**
+ * The `zenith` binary (site/docs/cli-reference.md).
+ *
+ * Every verb has `--json` and none of them ever prompts, so an agent can drive the CLI. Exit codes
+ * are the same convention across every verb: 0 ok, 1 the auto has findings errors, 2 usage, IO, or a
+ * verb that depends on a `@horizon36596/zenith-core` M1 export (`estimate`, `ledger`, `render`, `diff`) that has
+ * not landed yet.
+ */
+export declare function buildProgram(): Command;
+/**
+ * Drops a single leading bare `--` from the verb's own arguments (`argv[2]`, right after the node
+ * executable and the script path). `pnpm zenith -- <verb> ...` forwards that `--` literally, and
+ * without stripping it commander treats it as "end of options": every flag after it, `--project`
+ * included, is read as an operand instead of being parsed.
+ */
+export declare function stripWrapperSeparator(argv: readonly string[]): string[];
+export declare function main(argv: readonly string[]): Promise<number>;
+/**
+ * True when `entry`, the script Node was started with, is the module at `moduleUrl`.
+ *
+ * Both sides are resolved through symlinks first. npm installs a package's bin on Linux and macOS as
+ * a symlink in `node_modules/.bin`, and Node reports that link's path in `process.argv[1]` while
+ * `import.meta.url` is the real file, so a plain comparison is false there and the CLI would exit
+ * without doing anything. On Windows npm writes a `.cmd` shim that passes the real path instead.
+ */
+export declare function isEntryPoint(entry: string | undefined, moduleUrl: string): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAiJtC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAGvE;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAWnE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOlF"}

package/dist/index.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { Command } from "commander";
+import { runCalibrate } from "./commands/calibrate.js";
+import { runCodegen } from "./commands/codegen.js";
+import { runDeploy } from "./commands/deploy.js";
+import { runDiff } from "./commands/diff.js";
+import { runEstimate } from "./commands/estimate.js";
+import { runInit } from "./commands/init.js";
+import { runNew } from "./commands/new.js";
+import { runPropose } from "./commands/propose.js";
+import { runRender } from "./commands/render.js";
+import { runSim } from "./commands/sim.js";
+import { runValidate } from "./commands/validate.js";
+import { VERSION } from "./version.js";
+export * from "./lib.js";
+export { VERSION };
+/**
+ * The `zenith` binary (site/docs/cli-reference.md).
+ *
+ * Every verb has `--json` and none of them ever prompts, so an agent can drive the CLI. Exit codes
+ * are the same convention across every verb: 0 ok, 1 the auto has findings errors, 2 usage, IO, or a
+ * verb that depends on a `@horizon36596/zenith-core` M1 export (`estimate`, `ledger`, `render`, `diff`) that has
+ * not landed yet.
+ */
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name("zenith")
+        .description("An auto planner for FTC that humans and agents share. Horizon (FTC 36596).")
+        .version(VERSION)
+        .showHelpAfterError();
+    program
+        .command("validate")
+        .description("Check autos against the schema and the feasibility rules; exit 1 on any error.")
+        .argument("<autos...>", "paths to .auto.json files")
+        .option("--json", "print findings as JSON")
+        .option("--explain", "say what each finding means and how to fix it")
+        .option("--project <dir>", "the directory holding zenith.json")
+        .action((autos, options) => {
+        process.exitCode = runValidate(autos, options);
+    });
+    program
+        .command("init")
+        .description("Write zenith.json and an autos directory that validates.")
+        .option("--json", "print what was written as JSON")
+        .option("--force", "overwrite files that already exist")
+        .option("--command-library <library>", "solverslib or ivy: the command library your robot code uses")
+        .action((options) => {
+        process.exitCode = runInit(options);
+    });
+    program
+        .command("new")
+        .description("Write a new auto from a canonical skeleton.")
+        .argument("<name>", "the auto's name, used for the file name too")
+        .option("--json", "print what was written as JSON")
+        .option("--force", "overwrite the file if it exists")
+        .option("--project <dir>", "the directory holding zenith.json")
+        .option("--alliance <alliance>", "RED or BLUE", "RED")
+        .action((name, options) => {
+        process.exitCode = runNew(name, options);
+    });
+    program
+        .command("estimate")
+        .description("Print the per-step time estimate and the total against the auto period.")
+        .argument("<auto>", "path to a .auto.json file, or its bare name in autosDir")
+        .option("--json", "print the estimate as JSON")
+        .option("--explain", "also print the assumptions behind the numbers")
+        .option("--project <dir>", "the directory holding zenith.json")
+        .action((auto, options) => {
+        process.exitCode = runEstimate(auto, options);
+    });
+    program
+        .command("render")
+        .description("Draw an auto to SVG or PNG: the field, the path, findings and the ledger.")
+        .argument("<auto>", "path to a .auto.json file, or its bare name in autosDir")
+        .option("--svg <out>", "write an SVG file")
+        .option("--png <out>", "write a PNG file (via @resvg/resvg-js)")
+        .option("--alliance <alliance>", "RED or BLUE; mirrors the preview")
+        .option("--base <auto>", "another auto to load for comparison (overlay pending core.render support)")
+        .option("--json", "print what was written as JSON")
+        .option("--project <dir>", "the directory holding zenith.json")
+        .action(async (auto, options) => {
+        process.exitCode = await runRender(auto, options);
+    });
+    program
+        .command("codegen")
+        .description("Write the readable, derived Java class for an auto (never edited by hand).")
+        .argument("<auto>", "path to a .auto.json file, or its bare name in autosDir")
+        .option("--json", "print what was written as JSON")
+        .option("--project <dir>", "the directory holding zenith.json")
+        .action((auto, options) => {
+        process.exitCode = runCodegen(auto, options);
+    });
+    program
+        .command("deploy")
+        .description("Copy the autos, waypoints, robot and field files to the deploy directory, and refresh the @Autonomous stubs.")
+        .option("--dry-run", "list what would happen without writing anything")
+        .option("--json", "print the action list as JSON")
+        .option("--project <dir>", "the directory holding zenith.json")
+        .action((options) => {
+        process.exitCode = runDeploy(options);
+    });
+    program
+        .command("diff")
+        .description("Print the structural diff between two autos.")
+        .argument("<a>", "path to the first .auto.json file")
+        .argument("<b>", "path to the second .auto.json file")
+        .option("--json", "print the diff as JSON")
+        .action((a, b, options) => {
+        process.exitCode = runDiff(a, b, options);
+    });
+    program
+        .command("sim")
+        .description("Run zenith.json's sim command and print estimate vs actual per step from its trace.")
+        .argument("<auto>", "path to a .auto.json file, or its bare name in autosDir")
+        .option("--open", "also render an SVG of the plan next to the trace, and print its path")
+        .option("--timeout <seconds>", "kill the sim command after this many seconds", (value) => Number(value))
+        .option("--json", "print the report as JSON")
+        .option("--project <dir>", "the directory holding zenith.json")
+        .action(async (auto, options) => {
+        process.exitCode = await runSim(auto, options);
+    });
+    program
+        .command("calibrate")
+        .description("Fit accel, settleS and a per-heading-mode scale from recorded sim traces.")
+        .option("--traces <dir>", "directory of *.trace.json files (default: traces/, or zenith.json's sim.trace directory)")
+        .option("--write", "write the fitted accelInPerS2 and settleS into robot.json")
+        .option("--date <date>", "the provenance date (default: today)")
+        .option("--json", "print the fit as JSON")
+        .option("--project <dir>", "the directory holding zenith.json")
+        .action((options) => {
+        process.exitCode = runCalibrate(options);
+    });
+    program
+        .command("propose")
+        .description("Validate, render and print a PR body for an auto. Only --dry-run is implemented today.")
+        .argument("<auto>", "path to a .auto.json file, or its bare name in autosDir")
+        .option("--dry-run", "the only mode this build supports: print the PR body to stdout")
+        .option("--base <branch>", "accepted for forward compatibility with GitHub mode; unused by --dry-run")
+        .option("--json", "print the render path and the PR body as JSON")
+        .option("--project <dir>", "the directory holding zenith.json")
+        .action((auto, options) => {
+        process.exitCode = runPropose(auto, options);
+    });
+    return program;
+}
+/**
+ * Drops a single leading bare `--` from the verb's own arguments (`argv[2]`, right after the node
+ * executable and the script path). `pnpm zenith -- <verb> ...` forwards that `--` literally, and
+ * without stripping it commander treats it as "end of options": every flag after it, `--project`
+ * included, is read as an operand instead of being parsed.
+ */
+export function stripWrapperSeparator(argv) {
+    if (argv[2] !== "--")
+        return [...argv];
+    return [...argv.slice(0, 2), ...argv.slice(3)];
+}
+export async function main(argv) {
+    try {
+        await buildProgram().parseAsync(stripWrapperSeparator(argv));
+        return process.exitCode === undefined ? 0 : Number(process.exitCode);
+    }
+    catch (error) {
+        process.stderr.write(`zenith: ${error instanceof Error ? error.message : String(error)}\n`);
+        // Every thrown error reaching here is a usage or IO problem: loadProject not finding a project,
+        // a missing zenith.json section, a bad --alliance, and so on. A verb's own findings-related
+        // failure returns 1 directly from its run* function instead of throwing.
+        return 2;
+    }
+}
+/**
+ * True when `entry`, the script Node was started with, is the module at `moduleUrl`.
+ *
+ * Both sides are resolved through symlinks first. npm installs a package's bin on Linux and macOS as
+ * a symlink in `node_modules/.bin`, and Node reports that link's path in `process.argv[1]` while
+ * `import.meta.url` is the real file, so a plain comparison is false there and the CLI would exit
+ * without doing anything. On Windows npm writes a `.cmd` shim that passes the real path instead.
+ */
+export function isEntryPoint(entry, moduleUrl) {
+    if (entry === undefined)
+        return false;
+    try {
+        return pathToFileURL(realpathSync(entry)).href === pathToFileURL(realpathSync(fileURLToPath(moduleUrl))).href;
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntryPoint(process.argv[1], import.meta.url)) {
+    process.exitCode = await main(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/javaCodegen.d.ts

@@ -0,0 +1,44 @@
+import type { Plan } from "@horizon36596/zenith-core";
+import { type CommandLibrary } from "./commandLibrary.js";
+/**
+ * `zenith codegen`: a readable Java class a student can read as the plan
+ * (site/docs/robot-runtime.md, "Generated Java"). It is derived and never edited; the file
+ * is the source of truth. It is an abstract subclass of the chosen runtime's `AutoFromFile`
+ * (`deploy.commandLibrary`, which has no default) that overrides `startPose()` and `buildRoutine()`,
+ * and every call here is against that runtime's real API (`PathMarkers`, `RobotTimeout`,
+ * `WaitRobotTime`, `NamedCommands`, `DeferredPath`, and the `AutoContext` methods `step`, `alliance`,
+ * `followPath` and `defaultSpeedFraction`, and `AutoFromFile`'s `headingRad` and `turnRad`), so a
+ * reader who goes looking for `PathMarkers.wrap` or `NamedCommands.build` finds them. Every pose goes
+ * through `alliance(...)` and every heading through `headingRad` and `turnRad`, so the class mirrors a
+ * file run as the other alliance exactly as the runtime's AutoBuilder does.
+ *
+ * The two forms build the same tree as their runtime's AutoBuilder. The SolversLib form
+ * (`org.horizon36596.zenith.solverslib`) uses SolversLib's `Pose2d`, converted with `Poses.toPedro`, and its
+ * `SequentialCommandGroup`, `ConditionalCommand`, `WaitUntilCommand` and `InstantCommand`. The Ivy
+ * form (`org.horizon36596.zenith.ivy`) uses Pedro's `Pose`, the runtime's `Sequence` and `Branch`, and
+ * Ivy's `Commands.waitUntil` and `Commands.instant`.
+ *
+ * A path whose first segment starts from `"current"` is written as `DeferredPath.of`, the call the
+ * runtime's AutoBuilder makes for such a step, so it is built when the step starts from the live pose.
+ * Only the numbers that come from the path's length (the segment lengths that place a marker anywhere
+ * but the start, a heading shared out by arc length) are the planned path's there, and the class
+ * says so.
+ *
+ * Deterministic: every number in the plan is already resolved (waypoints included), so the same
+ * auto and the same sha always produce byte-identical Java. No clock, no randomness.
+ */
+export interface CodegenOptions {
+    /** Dotted Java package, e.g. `org.firstinspires.ftc.teamcode.opmode.Auto`. */
+    packageName: string;
+    /** Short hex digest of the source file's canonical bytes, printed in the header comment. */
+    shaHex: string;
+    /** The auto file's path as it should read in the header, e.g. `autos/first-auto.auto.json`. */
+    sourcePath: string;
+    /** `zenith.json` `deploy.commandLibrary`: which runtime the class is written against. */
+    commandLibrary: CommandLibrary;
+}
+/** `first-auto` -> `FirstAuto`; the class is `<Pascal>Generated`. */
+export declare function pascalCase(name: string): string;
+/** Renders the full generated class. Pure: every input is the plan's own numbers. */
+export declare function generateAutoJava(plan: Plan, options: CodegenOptions): string;
+//# sourceMappingURL=javaCodegen.d.ts.map

package/dist/javaCodegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"javaCodegen.d.ts","sourceRoot":"","sources":["../src/javaCodegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,2BAA2B,CAAC;AAWtE,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,cAAc,EAAE,cAAc,CAAC;CAChC;AAsFD,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAweD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAgD5E"}