@horizon36596/zenith-core 0.1.1

package/dist/prBody.js

@@ -0,0 +1,112 @@
+import { walkSteps } from "./diff.js";
+/**
+ * The pull request body of site/docs/github.md: the name, what the
+ * routine does, the committed render, a table of steps with their estimates and strafe, the totals
+ * against the autonomous period, the ledger at the end and whether the simulator was run.
+ *
+ * It is built in core rather than in the CLI or the GitHub client so that `zenith propose`, the
+ * editor's Propose button and the review bot all write the same body, and so that the body can be
+ * tested without a network.
+ */
+/** The FTC autonomous period, used when the caller does not pass the field's own number. */
+export const DEFAULT_PERIOD_S = 30;
+const EN_DASH = "–";
+const MIDDLE_DOT = "·";
+/** A markdown table cell: a pipe in a step's detail would otherwise end the column. */
+const cell = (text) => text.split("|").join("\\|");
+const oneDecimal = (value) => value.toFixed(1);
+/** `2.5 (2.0–3.0)`, or `2.5` when the band is the whole estimate's and adds nothing here. */
+function estimateCell(step, until) {
+    if (step === undefined || step.nominalS === null) {
+        return until === null ? "unknown" : `unknown (until ${until})`;
+    }
+    const band = step.lowS === null || step.highS === null
+        ? ""
+        : ` (${oneDecimal(step.lowS)}${EN_DASH}${oneDecimal(step.highS)})`;
+    const tail = until === null ? "" : ` (until ${until})`;
+    return `${oneDecimal(step.nominalS)}${band}${tail}`;
+}
+/** Strafe is only a question on a path step; everything else gets a dash. */
+const strafeCell = (step) => step === undefined || step.kind !== "path" || step.strafeFraction === null
+    ? EN_DASH
+    : `${String(Math.round(step.strafeFraction * 100))} %`;
+/** The condition a step runs until, which is why it has no estimate. */
+function until(step) {
+    if (step.kind === "wait")
+        return step.until ?? null;
+    if (step.kind === "path")
+        return step.endCondition?.condition ?? null;
+    return null;
+}
+const plural = (count, noun) => `${String(count)} ${noun}${count === 1 ? "" : "s"}`;
+/** `1 error, 2 warnings`, leaving out the kinds there are none of; empty when the step is clean. */
+function findingsCell(findings) {
+    const codes = findings
+        .filter((finding) => finding.severity !== "info")
+        .map((finding) => `${finding.severity}: ${finding.code}`);
+    return [...new Set(codes)].join(", ");
+}
+function countsLine(findings) {
+    const of = (severity) => findings.filter((finding) => finding.severity === severity).length;
+    return `${plural(of("error"), "error")}, ${plural(of("warning"), "warning")}`;
+}
+/**
+ * The share of the driving that was sideways, weighted by how long each path step takes, because a
+ * long leg at 40 % matters more than a short one at 80 %.
+ */
+function overallStrafe(estimate) {
+    if (estimate === null)
+        return EN_DASH;
+    let weighted = 0;
+    let total = 0;
+    for (const step of estimate.steps) {
+        if (step.kind !== "path" || step.strafeFraction === null || step.nominalS === null)
+            continue;
+        weighted += step.strafeFraction * step.nominalS;
+        total += step.nominalS;
+    }
+    return total === 0 ? EN_DASH : `${String(Math.round((weighted / total) * 100))} %`;
+}
+/** The body of the pull request a proposal opens (`06` section 3). */
+export function prBody(auto, estimate, findings, ledgerRows, options = {}) {
+    const periodS = options.periodS ?? DEFAULT_PERIOD_S;
+    const byStep = new Map();
+    for (const finding of findings) {
+        byStep.set(finding.stepId, [...(byStep.get(finding.stepId) ?? []), finding]);
+    }
+    const lines = [`## ${auto.name}`, ""];
+    const description = auto.description ?? auto.title;
+    if (description !== undefined && description !== "")
+        lines.push(description, "");
+    if (options.renderUrl !== undefined && options.renderUrl !== "") {
+        lines.push(`![render](${options.renderUrl})`, "");
+    }
+    lines.push("| step | estimate (s) | strafe | findings |", "|---|---|---|---|");
+    // Only the top-level steps get a row: a parallel group's children are its own business, and the
+    // group's estimate already covers them.
+    for (const entry of walkSteps(auto.steps).filter((step) => step.list === "steps")) {
+        const step = estimate?.byStepId[entry.id];
+        lines.push(`| ${cell(entry.id)} | ${estimateCell(step, until(entry.step))} | ${strafeCell(step)} | ${cell(findingsCell(byStep.get(entry.id) ?? []))} |`);
+    }
+    const nominal = estimate?.nominalS ?? null;
+    const low = estimate?.lowS ?? null;
+    const high = estimate?.highS ?? null;
+    const band = low === null || high === null ? "" : ` (${oneDecimal(low)}${EN_DASH}${oneDecimal(high)})`;
+    // A routine with a step that has no estimate can only be given a floor, so the total says so
+    // rather than pretending the number is the whole of it.
+    const floor = estimate?.hasUnknown === true ? "at least " : "";
+    const total = nominal === null
+        ? `unknown of ${String(periodS)}`
+        : `${floor}${oneDecimal(nominal)}${band} of ${String(periodS)}`;
+    lines.push(`| **total** | **${total}** | **${overallStrafe(estimate)}** | ${countsLine(findings)} |`, "");
+    const end = ledgerRows.filter((row) => row.stepId === "end");
+    if (end.length > 0) {
+        const detail = end
+            .map((row) => `${row.label}${row.detail === undefined ? "" : ` ${row.detail}`}`)
+            .join(` ${MIDDLE_DOT} `);
+        lines.push(`Ledger at end: ${detail}`);
+    }
+    lines.push(`Sim: ${options.simSummary ?? "not run"}`);
+    return `${lines.join("\n").trim()}\n`;
+}
+//# sourceMappingURL=prBody.js.map

package/dist/prBody.js.map

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

package/dist/provenance.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The provenance vocabulary of CLAUDE.md rule 4, and the three tiers it collapses into: how
+ * strongly a number is claimed, not what colour anything is drawn. The editor's chips
+ * (apps/web/UI_GUIDE.md section 4), the renderer and a CLI report all rank the same string the
+ * same way, so a PLACEHOLDER is never quietly promoted between one view of a file and another.
+ *
+ * The label is always shown in full; the tier only sorts it.
+ */
+export type ProvenanceTier = "measured" | "derived" | "unverified";
+/** What a number with no provenance at all is treated as: unmeasured (UI_GUIDE section 8.3). */
+export declare const NO_PROVENANCE = "NEEDS MEASUREMENT";
+/** The provenance the editor writes when a human drags or types a pose. */
+export declare const EDITOR_PROVENANCE = "SET FROM EDITOR";
+/**
+ * The tier a string belongs to. Unverified wins over derived and derived over measured, so a
+ * label like "SET FROM SIM; PLACEHOLDER until measured" reads as the weaker of the two claims.
+ */
+export declare function provenanceTier(provenance: string | undefined): ProvenanceTier;
+/** Every provenance label the chip menu offers, in the order CLAUDE.md rule 4 lists them. */
+export declare const PROVENANCE_LABELS: readonly ["MEASURED", "SET BY HAND", "SPEC", "NEEDS MEASUREMENT", "CARRIED OVER", "PLACEHOLDER", "APPROX", "SET FROM SIM", "SET FROM EDITOR", "CALIBRATED FROM SIM", "CALIBRATED FROM ROBOT"];
+//# sourceMappingURL=provenance.d.ts.map

package/dist/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAgBnE,gGAAgG;AAChG,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAEjD,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAM7E;AAED,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,+LAYpB,CAAC"}

package/dist/provenance.js

@@ -0,0 +1,46 @@
+const MEASURED = ["MEASURED", "SPEC", "CALIBRATED FROM ROBOT"];
+const DERIVED = [
+    "SET BY HAND",
+    "SET FROM EDITOR",
+    "SET FROM SIM",
+    "CALIBRATED FROM SIM",
+    "CARRIED OVER",
+    // Deliberately a prefix, not a label: the vocabulary's two "SET FROM ..." labels are already
+    // above, and this catches a hand-written "SET FROM RobotConfig.java", naming the robot code a
+    // number was copied from, as derived rather than dropping it to the unverified default.
+    "SET FROM",
+];
+const UNVERIFIED = ["NEEDS MEASUREMENT", "PLACEHOLDER", "APPROX"];
+/** What a number with no provenance at all is treated as: unmeasured (UI_GUIDE section 8.3). */
+export const NO_PROVENANCE = "NEEDS MEASUREMENT";
+/** The provenance the editor writes when a human drags or types a pose. */
+export const EDITOR_PROVENANCE = "SET FROM EDITOR";
+/**
+ * The tier a string belongs to. Unverified wins over derived and derived over measured, so a
+ * label like "SET FROM SIM; PLACEHOLDER until measured" reads as the weaker of the two claims.
+ */
+export function provenanceTier(provenance) {
+    const text = (provenance ?? NO_PROVENANCE).toUpperCase();
+    if (UNVERIFIED.some((label) => text.includes(label)))
+        return "unverified";
+    if (DERIVED.some((label) => text.includes(label)))
+        return "derived";
+    if (MEASURED.some((label) => text.includes(label)))
+        return "measured";
+    return "unverified";
+}
+/** Every provenance label the chip menu offers, in the order CLAUDE.md rule 4 lists them. */
+export const PROVENANCE_LABELS = [
+    "MEASURED",
+    "SET BY HAND",
+    "SPEC",
+    "NEEDS MEASUREMENT",
+    "CARRIED OVER",
+    "PLACEHOLDER",
+    "APPROX",
+    "SET FROM SIM",
+    "SET FROM EDITOR",
+    "CALIBRATED FROM SIM",
+    "CALIBRATED FROM ROBOT",
+];
+//# sourceMappingURL=provenance.js.map

package/dist/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAUA,MAAM,QAAQ,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAC/D,MAAM,OAAO,GAAG;IACd,aAAa;IACb,iBAAiB;IACjB,cAAc;IACd,qBAAqB;IACrB,cAAc;IACd,6FAA6F;IAC7F,8FAA8F;IAC9F,wFAAwF;IACxF,UAAU;CACX,CAAC;AACF,MAAM,UAAU,GAAG,CAAC,mBAAmB,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;AAElE,gGAAgG;AAChG,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAEjD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAA8B;IAC3D,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,YAAY,CAAC;IAC1E,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACpE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC;IACtE,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,UAAU;IACV,aAAa;IACb,MAAM;IACN,mBAAmB;IACnB,cAAc;IACd,aAAa;IACb,QAAQ;IACR,cAAc;IACd,iBAAiB;IACjB,qBAAqB;IACrB,uBAAuB;CACf,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,18 @@
+import type { Estimate, Finding, LedgerRow, Plan, RenderOptions } from "./types.js";
+/**
+ * `render`: one SVG string that the pull
+ * request, the CLI's `--png` and the editor's static layer all share.
+ *
+ * Frame: `field.json` says the audience is at the bottom and +Y runs away from them, so the
+ * drawing flips Y. Everything is in field inches until the last moment, where `at()` turns a point
+ * into pixels.
+ *
+ * Colours are the literal hex of `tokens.ts`, not CSS custom properties, because an SVG that is
+ * rasterised has no stylesheet to read them from.
+ */
+/** How far apart the footprint ghosts are in seconds of estimated time; density shows speed. */
+export declare const GHOST_EVERY_S = 0.5;
+/** How far apart they are in inches when there is no estimate to place them by. */
+export declare const GHOST_EVERY_IN = 12;
+export declare function render(plan: Plan, estimateResult: Estimate | null, findings: readonly Finding[], ledgerRows: readonly LedgerRow[], options?: RenderOptions): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,IAAI,EAGJ,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AAEH,gGAAgG;AAChG,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,mFAAmF;AACnF,eAAO,MAAM,cAAc,KAAK,CAAC;AA+BjC,wBAAgB,MAAM,CACpB,IAAI,EAAE,IAAI,EACV,cAAc,EAAE,QAAQ,GAAG,IAAI,EAC/B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAyDR"}