@horizon36596/zenith-cli 0.1.1

package/dist/traceReport.js

@@ -0,0 +1,91 @@
+import { distance, flattenSteps } from "@horizon36596/zenith-core";
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export class TraceParseError extends Error {
+}
+/** Parses and shape-checks a trace file, without assuming fields later sim batches have not filled. */
+export function parseTrace(json) {
+    if (!isObject(json))
+        throw new TraceParseError("the trace file is not a JSON object");
+    const auto = json.auto;
+    const steps = json.steps;
+    const poses = json.poses;
+    if (typeof auto !== "string" || !Array.isArray(steps) || !Array.isArray(poses)) {
+        throw new TraceParseError('the trace file is missing "auto", "steps" or "poses"');
+    }
+    return {
+        formatVersion: typeof json.formatVersion === "number" ? json.formatVersion : 1,
+        auto,
+        simTimeS: typeof json.simTimeS === "number" ? json.simTimeS : 0,
+        tickS: typeof json.tickS === "number" ? json.tickS : 0.02,
+        capabilities: Array.isArray(json.capabilities) ? json.capabilities.map(String) : [],
+        steps: steps,
+        poses: poses,
+        truthPoses: Array.isArray(json.truthPoses) ? json.truthPoses : [],
+        structureContacts: Array.isArray(json.structureContacts)
+            ? json.structureContacts
+            : [],
+        ledger: Array.isArray(json.ledger) ? json.ledger : [],
+        events: Array.isArray(json.events) ? json.events : [],
+    };
+}
+const KNOWN_CAPABILITIES = ["structureContacts", "ledger"];
+/** Builds the estimate-vs-actual report `zenith sim` prints, from a trace and the auto's plan. */
+export function buildSimReport(trace, plan, estimateResult) {
+    const planSteps = flattenSteps(plan.steps);
+    const estimateById = new Map((estimateResult?.steps ?? []).map((step) => [step.stepId, step]));
+    const steps = trace.steps.map((traceStep) => {
+        const actualS = traceStep.endS - traceStep.startS;
+        const stepEstimate = estimateById.get(traceStep.id) ?? null;
+        const nominalS = stepEstimate?.nominalS ?? null;
+        const planStep = planSteps.find((candidate) => candidate.id === traceStep.id);
+        let maxCrossTrackIn = null;
+        if (planStep !== undefined && planStep.samples.length > 0) {
+            const posesInWindow = trace.poses.filter((row) => row[0] >= traceStep.startS && row[0] <= traceStep.endS);
+            if (posesInWindow.length > 0) {
+                maxCrossTrackIn = 0;
+                for (const row of posesInWindow) {
+                    const point = { xIn: row[1], yIn: row[2] };
+                    let nearest = Number.POSITIVE_INFINITY;
+                    for (const sample of planStep.samples) {
+                        const d = distance(point, sample.pose);
+                        if (d < nearest)
+                            nearest = d;
+                    }
+                    if (nearest > maxCrossTrackIn)
+                        maxCrossTrackIn = nearest;
+                }
+            }
+        }
+        return {
+            id: traceStep.id,
+            estimateNominalS: nominalS,
+            actualS,
+            deltaS: nominalS === null ? null : actualS - nominalS,
+            interrupted: traceStep.interrupted,
+            maxCrossTrackIn,
+        };
+    });
+    const lastLedger = trace.ledger[trace.ledger.length - 1];
+    const launches = trace.ledger.reduce((sum, row) => sum + (row.launches ?? 0), 0);
+    const tips = {};
+    for (const row of trace.ledger) {
+        for (const [alliance, count] of Object.entries(row.tips ?? {}))
+            tips[alliance] = count;
+    }
+    return {
+        auto: trace.auto,
+        simTimeS: trace.simTimeS,
+        steps,
+        totalEstimateS: estimateResult?.nominalS ?? null,
+        totalActualS: trace.steps.reduce((sum, step) => sum + (step.endS - step.startS), 0),
+        structureContacts: trace.structureContacts.length,
+        launches,
+        tips,
+        heldAtEnd: lastLedger?.held ?? null,
+        capabilities: trace.capabilities,
+        inert: KNOWN_CAPABILITIES.filter((capability) => !trace.capabilities.includes(capability)),
+    };
+}
+//# sourceMappingURL=traceReport.js.map

package/dist/traceReport.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** The Zenith release this CLI belongs to. */
+export declare const VERSION = "0.1.1";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,8CAA8C;AAC9C,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,4 @@
+// Written by scripts/stamp-version.mjs from the root package.json; do not edit by hand.
+/** The Zenith release this CLI belongs to. */
+export const VERSION = "0.1.1";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,8CAA8C;AAC9C,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@horizon36596/zenith-cli",
+  "version": "0.1.1",
+  "description": "The zenith command: validate, estimate, render, codegen, deploy and simulate FTC autonomous routines.",
+  "keywords": [
+    "ftc",
+    "first-tech-challenge",
+    "robotics",
+    "autonomous",
+    "zenith",
+    "cli",
+    "codegen",
+    "pedro-pathing",
+    "solverslib"
+  ],
+  "homepage": "https://libraries.horizon36596.org/zenith/",
+  "bugs": {
+    "url": "https://github.com/Horizon-36596/zenith/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Horizon-36596/zenith.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "author": "Horizon (FTC 36596)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "zenith": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./lib": {
+      "types": "./dist/lib.d.ts",
+      "default": "./dist/lib.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/*.qa.test.*",
+    "!dist/**/testSupport.*",
+    "!dist/**/*.tsbuildinfo",
+    "!dist/testing",
+    "!dist/**/testing.*",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@resvg/resvg-js": "^2.6.2",
+    "commander": "^13.1.0",
+    "@horizon36596/zenith-core": "0.1.1",
+    "@horizon36596/zenith-season-biobuzz": "0.1.1",
+    "@horizon36596/zenith-seasons": "0.1.1",
+    "@horizon36596/zenith-schema": "0.1.1"
+  },
+  "scripts": {}
+}