@horizon36596/zenith-mcp 0.1.1

package/dist/schemas.js

@@ -0,0 +1,197 @@
+import { z } from "zod";
+/**
+ * JSON Schema input shapes for the `zenith.edit.*` tools, mirroring `packages/schema/src/auto.ts`
+ * structurally so an MCP client can see exactly what a step, segment or marker looks like.
+ *
+ * These are written by hand against `zod` (the MCP SDK's peer version) rather than imported from
+ * `@horizon36596/zenith-schema` (which pins `zod` 3): the two packages can carry different major versions of
+ * `zod` side by side, but their schema objects are not interchangeable. The edit primitives in
+ * `@horizon36596/zenith-core` are the actual source of truth — every `zenith.edit.*` call still round-trips
+ * through `parseAuto` inside `finish()` (`packages/core/src/edit/finish.ts`), so a shape that
+ * slips past this file is still caught there with a precise `EditError`. `steps` inside a
+ * `parallel` or `branch` step are typed loosely (`z.unknown()`) rather than recursively for the
+ * same reason: the recursion is finitely enforced downstream, not lost.
+ */
+export const poseInputSchema = z
+    .object({
+    xIn: z.number(),
+    yIn: z.number(),
+    headingRad: z.number().optional(),
+    provenance: z.string().optional(),
+})
+    .describe("A literal pose in the field frame of the auto's own alliance (its `alliance`), where the robot " +
+    "drives it when running as that alliance: inches and radians.");
+export const poseRefSchema = z
+    .object({ ref: z.string().min(1) })
+    .describe("A named pose from waypoints.json.");
+export const poseSourceSchema = z
+    .union([z.literal("current"), poseRefSchema, poseInputSchema])
+    .describe('Where a segment starts or ends: "current" (the previous step\'s end pose), a waypoint ref, or a literal pose.');
+export const lineSegmentSchema = z.object({
+    kind: z.literal("line"),
+    from: poseSourceSchema,
+    to: poseSourceSchema,
+});
+export const bezierSegmentSchema = z.object({
+    kind: z.literal("bezier"),
+    from: poseSourceSchema,
+    control: z.array(poseInputSchema).min(1).max(3).describe("One to three Bezier control points."),
+    to: poseSourceSchema,
+});
+export const segmentSchema = z
+    .discriminatedUnion("kind", [lineSegmentSchema, bezierSegmentSchema])
+    .describe("A line or a Bezier segment of a path step.");
+const rangeHeadingModes = [
+    z.object({ mode: z.literal("tangent") }),
+    z.object({ mode: z.literal("tangentReversed") }),
+    z.object({ mode: z.literal("constant"), headingRad: z.number() }),
+    z.object({ mode: z.literal("linear"), fromRad: z.number(), toRad: z.number() }),
+    z.object({
+        mode: z.literal("facePoint"),
+        xIn: z.number(),
+        yIn: z.number(),
+        offsetRad: z.number().optional(),
+    }),
+];
+export const headingRangeSchema = z
+    .object({
+    startT: z.number().min(0).max(1),
+    endT: z.number().min(0).max(1),
+    heading: z.discriminatedUnion("mode", [...rangeHeadingModes]),
+})
+    .describe("One range of a piecewise heading: from startT to endT (fractions of the path) the robot uses this heading.");
+export const headingSchema = z
+    .discriminatedUnion("mode", [
+    ...rangeHeadingModes,
+    z.object({
+        mode: z.literal("piecewise"),
+        ranges: z
+            .array(headingRangeSchema)
+            .min(1)
+            .describe("In order, the first starting at 0, each starting where the one before ends, the last ending at 1."),
+    }),
+])
+    .describe("One of the six heading modes of the file format (https://libraries.horizon36596.org/zenith/file-format/).");
+export const commandArgsSchema = z
+    .record(z.string(), z.union([z.string(), z.number(), z.boolean()]))
+    .describe("Named-command arguments, keyed by the param names robot.json declares.");
+export const commandCallSchema = z.object({
+    name: z.string().min(1).describe("A command name registered in robot.json's commands[]."),
+    args: commandArgsSchema.optional(),
+});
+export const markerAtSchema = z
+    .union([
+    z.object({ t: z.number().min(0).max(1) }),
+    z.object({ distanceIn: z.number().nonnegative() }),
+    z.object({ distanceFromEndIn: z.number().nonnegative() }),
+])
+    .describe("Where along the path a marker fires: a path parameter t, or a distance.");
+export const markerSchema = z.object({ at: markerAtSchema, command: commandCallSchema });
+export const expectSchema = z.object({
+    collectFrom: z.string().min(1).optional(),
+    count: z.number().optional(),
+    launchesInto: z.string().min(1).optional(),
+    tip: z.enum(["own", "opponent"]).optional(),
+});
+export const pathStepInputSchema = z.object({
+    id: z.string().min(1).optional().describe("Omit to get an id assigned automatically."),
+    kind: z.literal("path"),
+    timeoutS: z.number().positive().optional(),
+    segments: z.array(segmentSchema).min(1),
+    heading: headingSchema.optional(),
+    speedFraction: z.number().positive().max(1).optional(),
+    markers: z.array(markerSchema).optional(),
+    endCondition: z.object({ condition: z.string().min(1) }).optional(),
+    expect: expectSchema.optional(),
+    notes: z.string().optional(),
+});
+export const commandStepInputSchema = z.object({
+    id: z.string().min(1).optional(),
+    kind: z.literal("command"),
+    name: z.string().min(1),
+    args: commandArgsSchema.optional(),
+    timeoutS: z.number().positive().optional(),
+    expect: expectSchema.optional(),
+    notes: z.string().optional(),
+});
+export const waitStepInputSchema = z.object({
+    id: z.string().min(1).optional(),
+    kind: z.literal("wait"),
+    seconds: z.number().nonnegative().optional(),
+    until: z.string().min(1).optional(),
+    timeoutS: z.number().positive().optional(),
+    notes: z.string().optional(),
+});
+export const sequenceStepInputSchema = z.object({
+    id: z.string().min(1).optional(),
+    kind: z.literal("sequence"),
+    steps: z
+        .array(z.unknown())
+        .describe("Nested steps, run one after another: the same shapes as a top-level step. At least one."),
+    notes: z.string().optional(),
+});
+export const parallelStepInputSchema = z.object({
+    id: z.string().min(1).optional(),
+    kind: z.literal("parallel"),
+    mode: z.enum(["all", "race", "deadline"]),
+    deadline: z.string().min(1).optional().describe("A child step's id; only meaningful for mode 'deadline'."),
+    steps: z.array(z.unknown()).describe("Nested steps: the same shapes as a top-level step."),
+    notes: z.string().optional(),
+});
+export const branchStepInputSchema = z.object({
+    id: z.string().min(1).optional(),
+    kind: z.literal("branch"),
+    condition: z.string().min(1).describe("A condition name registered in robot.json's conditions[]."),
+    then: z.array(z.unknown()),
+    else: z.array(z.unknown()).optional(),
+    notes: z.string().optional(),
+});
+export const stepInputSchema = z
+    .discriminatedUnion("kind", [
+    pathStepInputSchema,
+    commandStepInputSchema,
+    waitStepInputSchema,
+    sequenceStepInputSchema,
+    parallelStepInputSchema,
+    branchStepInputSchema,
+])
+    .describe("One step: path, command, wait, sequence, parallel or branch (https://libraries.horizon36596.org/zenith/file-format/).");
+export const intoGroupSchema = z
+    .object({
+    into: z.string().min(1).describe("The id of a sequence, parallel group or branch."),
+    index: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("0-based position in the group's list; clamps; the end when omitted."),
+    arm: z.enum(["then", "else"]).optional().describe("For a branch: which arm. then when omitted."),
+})
+    .describe("A place inside a group, for putting a step at the front of one or into an empty arm.");
+export const poseTargetSchema = z.object({
+    segmentIndex: z.number().int().nonnegative(),
+    pointKind: z.enum(["from", "to", "control"]),
+    controlIndex: z.number().int().nonnegative().optional().describe('Required, and only used, when pointKind is "control".'),
+});
+export const startInputSchema = z.object({
+    pose: poseSourceSchema,
+    holds: z.record(z.string(), z.number()).optional(),
+});
+// JSON has no "leave this field alone but not that one" beyond key presence, and no `undefined` —
+// so clearing a field over MCP is spelled `null` (translated to `undefined` before it reaches
+// `setMeta`, whose own "explicit undefined clears it" contract is a TypeScript-only convenience).
+// Omitting a key entirely leaves that field unchanged either way.
+export const autoMetaSchema = z.object({
+    title: z.string().nullable().optional().describe("Omit to leave unchanged; null clears it."),
+    description: z.string().nullable().optional().describe("Omit to leave unchanged; null clears it."),
+    authors: z.array(z.string().min(1)).nullable().optional().describe("Omit to leave unchanged; null clears it."),
+});
+export const autoRefField = z
+    .string()
+    .min(1)
+    .describe("The auto to operate on: a bare name (e.g. \"first-auto\", resolved against the project's autosDir), a path relative to the project root, or an absolute path.");
+export const projectField = z
+    .string()
+    .optional()
+    .describe("The robot repo's directory (holding zenith.json). Defaults to the server's own working directory.");
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SERVER_NAME = "zenith";
+/** The release version, stamped from the root package.json by scripts/stamp-version.mjs. */
+export declare const SERVER_VERSION = "0.1.1";
+/**
+ * Builds the Zenith MCP server (site/docs/agents-mcp.md): the same verbs the
+ * CLI has, plus structural edit tools, so an agent can author an auto end to end without
+ * hand-editing JSON. Exported on its own (rather than only from `index.ts`) so the integration
+ * test can connect a client to it directly, and so a host that wants to embed the server without
+ * spawning a child process can too.
+ */
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,4FAA4F;AAC5F,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAQxC"}

package/dist/server.js

@@ -0,0 +1,27 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerAnalysisTools } from "./tools/analysis.js";
+import { registerAutoTools } from "./tools/auto.js";
+import { registerEditTools } from "./tools/edit.js";
+import { registerProjectTools } from "./tools/project.js";
+import { registerResources } from "./resources.js";
+import { VERSION } from "./version.js";
+export const SERVER_NAME = "zenith";
+/** The release version, stamped from the root package.json by scripts/stamp-version.mjs. */
+export const SERVER_VERSION = VERSION;
+/**
+ * Builds the Zenith MCP server (site/docs/agents-mcp.md): the same verbs the
+ * CLI has, plus structural edit tools, so an agent can author an auto end to end without
+ * hand-editing JSON. Exported on its own (rather than only from `index.ts`) so the integration
+ * test can connect a client to it directly, and so a host that wants to embed the server without
+ * spawning a child process can too.
+ */
+export function createServer() {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
+    registerProjectTools(server);
+    registerAutoTools(server);
+    registerAnalysisTools(server);
+    registerEditTools(server);
+    registerResources(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAC7E,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/spawnCli.d.ts

@@ -0,0 +1,28 @@
+export interface CliRunResult {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * The CLI's own entry point, resolved through Node's module resolution rather than shelled out to by
+ * name. `@horizon36596/zenith-cli` is a dependency of this package, so it resolves from here both in
+ * the monorepo (pnpm links the workspace package) and after `npx -y @horizon36596/zenith-mcp`, where
+ * npm installs it next to this one. Its `exports["."]` is `./dist/index.js`, the same file the
+ * `zenith` bin points at and the same file that guards `main(process.argv)` behind an
+ * `import.meta.url === pathToFileURL(process.argv[1]).href` check, so `node <this path> <args>`
+ * behaves exactly like running the `zenith` binary.
+ *
+ * Resolving locally, rather than spawning `npx`, works offline and always runs the CLI version this
+ * server was installed with.
+ */
+export declare function resolveCliEntry(): string;
+/**
+ * Runs the `zenith` CLI as a child process: `zenith.render`'s PNG path and `zenith.sim` shell out
+ * to it rather than reimplementing resvg or the trace conversion in this package
+ * (site/docs/agents-mcp.md — "png via the CLI's resvg path"). A subprocess,
+ * rather than importing the CLI's `run*` functions in-process, is deliberate: those functions write
+ * their output straight to `process.stdout`/`process.stderr`, and this server's own `process.stdout`
+ * is the MCP stdio transport's JSON-RPC framing, which any stray text would corrupt.
+ */
+export declare function runZenithCli(args: readonly string[], cwd: string): Promise<CliRunResult>;
+//# sourceMappingURL=spawnCli.d.ts.map

package/dist/spawnCli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnCli.d.ts","sourceRoot":"","sources":["../src/spawnCli.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA4BxF"}

package/dist/spawnCli.js

@@ -0,0 +1,57 @@
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+/**
+ * The CLI's own entry point, resolved through Node's module resolution rather than shelled out to by
+ * name. `@horizon36596/zenith-cli` is a dependency of this package, so it resolves from here both in
+ * the monorepo (pnpm links the workspace package) and after `npx -y @horizon36596/zenith-mcp`, where
+ * npm installs it next to this one. Its `exports["."]` is `./dist/index.js`, the same file the
+ * `zenith` bin points at and the same file that guards `main(process.argv)` behind an
+ * `import.meta.url === pathToFileURL(process.argv[1]).href` check, so `node <this path> <args>`
+ * behaves exactly like running the `zenith` binary.
+ *
+ * Resolving locally, rather than spawning `npx`, works offline and always runs the CLI version this
+ * server was installed with.
+ */
+export function resolveCliEntry() {
+    const require = createRequire(import.meta.url);
+    return require.resolve("@horizon36596/zenith-cli");
+}
+/**
+ * Runs the `zenith` CLI as a child process: `zenith.render`'s PNG path and `zenith.sim` shell out
+ * to it rather than reimplementing resvg or the trace conversion in this package
+ * (site/docs/agents-mcp.md — "png via the CLI's resvg path"). A subprocess,
+ * rather than importing the CLI's `run*` functions in-process, is deliberate: those functions write
+ * their output straight to `process.stdout`/`process.stderr`, and this server's own `process.stdout`
+ * is the MCP stdio transport's JSON-RPC framing, which any stray text would corrupt.
+ */
+export function runZenithCli(args, cwd) {
+    return new Promise((resolvePromise, reject) => {
+        let entry;
+        try {
+            entry = resolveCliEntry();
+        }
+        catch (error) {
+            reject(error instanceof Error ? error : new Error(String(error)));
+            return;
+        }
+        const child = spawn(process.execPath, [entry, ...args], {
+            cwd,
+            shell: false,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", (error) => {
+            reject(error);
+        });
+        child.on("close", (code) => {
+            resolvePromise({ code, stdout, stderr });
+        });
+    });
+}
+//# sourceMappingURL=spawnCli.js.map

package/dist/spawnCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnCli.js","sourceRoot":"","sources":["../src/spawnCli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ5C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAuB,EAAE,GAAW;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE;QAC5C,IAAI,KAAa,CAAC;QAClB,IAAI,CAAC;YACH,KAAK,GAAG,eAAe,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE;YACtD,GAAG;YACH,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/analysis.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** `zenith.estimate`, `zenith.render`, `zenith.diff`, `zenith.sim`. */
+export declare function registerAnalysisTools(server: McpServer): void;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/tools/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/tools/analysis.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqH7D"}

package/dist/tools/analysis.js

@@ -0,0 +1,128 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { diff, estimate, hasErrors, ledger, loadAuto, render } from "@horizon36596/zenith-core";
+import { resolveSeason } from "@horizon36596/zenith-seasons";
+import { z } from "zod";
+import { errorCount, loadAutoAndPlan } from "../findings.js";
+import { confinePath, readJsonFile, relativeToRoot, resolveAutoPath, resolveProject } from "../project.js";
+import { guarded, jsonResult } from "../result.js";
+import { runZenithCli } from "../spawnCli.js";
+import { autoRefField, projectField } from "../schemas.js";
+const outField = z
+    .string()
+    .min(1)
+    .describe("Where to write the render: a path relative to the project root, or absolute (must resolve inside it).");
+/** Confined to the project root (finding 2): an `out` an agent supplies is untrusted input, the
+ * same as any other tool argument, and `zenith.render` writes there without asking. */
+const resolveOut = (project, out) => confinePath(project.root, out);
+/** `zenith.estimate`, `zenith.render`, `zenith.diff`, `zenith.sim`. */
+export function registerAnalysisTools(server) {
+    server.registerTool("zenith.estimate", {
+        title: "Estimate an auto's timing",
+        description: "Returns the per-step timing table (nominalS/lowS/highS/strafeFraction) and the total, from " +
+            "the estimate's kinematic model. A step whose " +
+            "command has estimateS \"unknown\" makes the total a lower bound (hasUnknown: true). Plans " +
+            "against the auto's own robot/field override when it has one, the same as zenith.validate, " +
+            "and refuses to return a number (estimate: null) when the auto has any error finding — read " +
+            "findings and seasonWarnings first, the way zenith estimate's CLI exit code forces a human to.",
+        inputSchema: { auto: autoRefField, project: projectField },
+    }, guarded(({ auto, project }) => {
+        const proj = resolveProject(project);
+        const path = resolveAutoPath(proj, auto);
+        const parsed = loadAuto(readJsonFile(path));
+        const { plan: planned, robot, findings, seasonWarnings } = loadAutoAndPlan(parsed, proj);
+        const blocked = hasErrors(findings);
+        return jsonResult({
+            estimate: blocked ? null : estimate(planned, robot),
+            findings,
+            errors: errorCount(findings),
+            seasonWarnings,
+        });
+    }));
+    server.registerTool("zenith.render", {
+        title: "Render an auto to a picture",
+        description: "Renders the field, path, footprint ghosts and findings to SVG (format \"svg\") or PNG " +
+            '(format "png", via the zenith CLI\'s resvg path) and writes it to `out`. Use this to hand a ' +
+            "human a picture of what an auto does, or to attach to a pull request body.",
+        inputSchema: {
+            auto: autoRefField,
+            out: outField,
+            format: z.enum(["svg", "png"]).default("svg"),
+            alliance: z.enum(["RED", "BLUE"]).optional().describe("Defaults to the auto's own alliance."),
+            project: projectField,
+        },
+    }, guarded(async ({ auto, out, format, alliance, project }) => {
+        const proj = resolveProject(project);
+        const autoPath = resolveAutoPath(proj, auto);
+        const outPath = resolveOut(proj, out);
+        mkdirSync(dirname(outPath), { recursive: true });
+        if (format === "png") {
+            const args = ["render", relativeToRoot(proj, autoPath), "--png", outPath];
+            if (alliance !== undefined)
+                args.push("--alliance", alliance);
+            const result = await runZenithCli(args, proj.root);
+            if (result.code !== 0) {
+                throw new Error(`zenith render --png failed (exit ${String(result.code)}): ${result.stderr || result.stdout}`);
+            }
+            return jsonResult({ written: relativeToRoot(proj, outPath), format, stdout: result.stdout });
+        }
+        const parsed = loadAuto(readJsonFile(autoPath));
+        // One plan, from the auto's own robot/field override when it has one, backs the render, the
+        // estimate and the findings overlay together — previously this re-planned a second time
+        // inside findingsForAuto, which (for an auto with an override) drew the footprint from one
+        // robot and the finding overlays from another (finding 24).
+        const { plan: planned, robot, field, findings, seasonWarnings } = loadAutoAndPlan(parsed, proj);
+        const estimateResult = tryOrNull(() => estimate(planned, robot));
+        const ledgerRows = tryOrEmpty(() => ledger(planned, field, resolveSeason(field).rules));
+        const svg = render(planned, estimateResult, findings, ledgerRows, { alliance });
+        writeFileSync(outPath, svg, "utf8");
+        return jsonResult({ written: relativeToRoot(proj, outPath), format, seasonWarnings });
+    }));
+    server.registerTool("zenith.diff", {
+        title: "Structurally diff two autos",
+        description: "Compares two auto files step by step and returns the added/removed/changed/moved steps, " +
+            "for a review view or for an agent checking what an edit actually changed.",
+        inputSchema: { a: autoRefField, b: autoRefField, project: projectField },
+    }, guarded(({ a, b, project }) => {
+        const proj = resolveProject(project);
+        const autoA = loadAuto(readJsonFile(resolveAutoPath(proj, a)));
+        const autoB = loadAuto(readJsonFile(resolveAutoPath(proj, b)));
+        return jsonResult(diff(autoA, autoB));
+    }));
+    server.registerTool("zenith.sim", {
+        title: "Run the robot repo's simulator on an auto",
+        description: "Runs zenith.json's sim command for this auto (via `zenith sim --json`) and returns the " +
+            "resulting trace summary: per-step estimate vs. actual. Requires the robot repo's build " +
+            "tooling (e.g. Gradle) to be available where the MCP server runs.",
+        inputSchema: { auto: autoRefField, project: projectField },
+    }, guarded(async ({ auto, project }) => {
+        const proj = resolveProject(project);
+        const result = await runZenithCli(["sim", relativeToRoot(proj, resolveAutoPath(proj, auto)), "--json"], proj.root);
+        if (result.code !== 0) {
+            throw new Error(`zenith sim failed (exit ${String(result.code)}): ${result.stderr || result.stdout}`);
+        }
+        try {
+            return jsonResult(JSON.parse(result.stdout));
+        }
+        catch {
+            return jsonResult({ stdout: result.stdout, stderr: result.stderr });
+        }
+    }));
+}
+function tryOrNull(fn) {
+    try {
+        return fn();
+    }
+    catch {
+        return null;
+    }
+}
+function tryOrEmpty(fn) {
+    try {
+        return fn();
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=analysis.js.map

package/dist/tools/analysis.js.map

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

package/dist/tools/auto.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** `zenith.auto.read` and `zenith.validate`. */
+export declare function registerAutoTools(server: McpServer): void;
+//# sourceMappingURL=auto.d.ts.map

package/dist/tools/auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../src/tools/auto.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8CzD"}

package/dist/tools/auto.js

@@ -0,0 +1,43 @@
+import { loadAuto } from "@horizon36596/zenith-core";
+import { findingsForAuto, errorCount, helpFor, warningCount } from "../findings.js";
+import { readJsonFile, relativeToRoot, resolveAutoPath, resolveProject } from "../project.js";
+import { guarded, jsonResult } from "../result.js";
+import { autoRefField, projectField } from "../schemas.js";
+/** `zenith.auto.read` and `zenith.validate`. */
+export function registerAutoTools(server) {
+    server.registerTool("zenith.auto.read", {
+        title: "Read an auto file",
+        description: "Reads and schema-validates one *.auto.json file and returns its full parsed contents " +
+            "(name, alliance, start, steps with their ids). Use this to see the current state of an " +
+            "auto before editing it, or to read the id an addStep/newAutoFromTemplate call assigned.",
+        inputSchema: { auto: autoRefField, project: projectField },
+    }, guarded(({ auto, project }) => {
+        const proj = resolveProject(project);
+        const path = resolveAutoPath(proj, auto);
+        const parsed = loadAuto(readJsonFile(path));
+        return jsonResult({ path: relativeToRoot(proj, path), auto: parsed });
+    }));
+    server.registerTool("zenith.validate", {
+        title: "Validate an auto",
+        description: "Schema-validates and checks one auto against its project's robot and field (or the auto's " +
+            "own robot/field override), the same rules `zenith validate` runs. Returns every Finding: " +
+            "severity, the step id and path parameter it points at, the check code, and a human-readable " +
+            "message, plus `help`: for each code present, a plain title, what it means and how to fix it. " +
+            "Call this after every edit to see whether the auto is closer to done.",
+        inputSchema: { auto: autoRefField, project: projectField },
+    }, guarded(({ auto, project }) => {
+        const proj = resolveProject(project);
+        const path = resolveAutoPath(proj, auto);
+        const parsed = loadAuto(readJsonFile(path));
+        const { findings, seasonWarnings } = findingsForAuto(parsed, proj);
+        return jsonResult({
+            path: relativeToRoot(proj, path),
+            findings,
+            errors: errorCount(findings),
+            warnings: warningCount(findings),
+            seasonWarnings,
+            help: helpFor(findings),
+        });
+    }));
+}
+//# sourceMappingURL=auto.js.map

package/dist/tools/auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.js","sourceRoot":"","sources":["../../src/tools/auto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3D,gDAAgD;AAChD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,uFAAuF;YACvF,yFAAyF;YACzF,yFAAyF;QAC3F,WAAW,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE;KAC3D,EACD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,4FAA4F;YAC5F,2FAA2F;YAC3F,8FAA8F;YAC9F,+FAA+F;YAC/F,uEAAuE;QACzE,WAAW,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE;KAC3D,EACD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnE,OAAO,UAAU,CAAC;YAChB,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC;YAChC,QAAQ;YACR,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC;YAC5B,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC;YAChC,cAAc;YACd,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC;SACxB,CAAC,CAAC;IACL,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/edit.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerEditTools(server: McpServer): void;
+//# sourceMappingURL=edit.d.ts.map

package/dist/tools/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgEzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkbzD"}