@horizon36596/zenith-core 0.1.1

package/dist/diff.js

@@ -0,0 +1,258 @@
+import { childLists } from "@horizon36596/zenith-schema";
+import { childPrefix, effectiveId } from "./edit/ids.js";
+const CHILD_LISTS = ["steps", "then", "else"];
+/**
+ * The child lists of a step, each with the id prefix `resolve` gives its members.
+ *
+ * The prefix comes from `childPrefix`, the one definition of it: a branch with both arms numbers
+ * them (`b.1.`, `b.2.`) and one with only a `then` does not. Naming the two arms alike gave two
+ * different steps the id `b.1`, and review mode then anchored both changes to the same step, so one
+ * change hid the other.
+ */
+const childrenOf = (step, id) => {
+    const lists = childLists(step);
+    return lists.map((list, index) => ({
+        list: step.kind === "branch" ? (index === 0 ? "then" : "else") : "steps",
+        prefix: childPrefix(id, lists.length, index),
+        steps: list,
+    }));
+};
+/** Walks the whole step tree in document order, naming every step the way `resolve` names it. */
+export function walkSteps(steps) {
+    const entries = [];
+    const visit = (list, listName, prefix) => {
+        list.forEach((step, index) => {
+            const id = effectiveId(step, index, prefix);
+            entries.push({ id, step, list: listName, index, order: entries.length });
+            for (const child of childrenOf(step, id)) {
+                visit(child.steps, `${id}.${child.list}`, child.prefix);
+            }
+        });
+    };
+    visit(steps, "steps", "step");
+    return entries;
+}
+/** The keys of a step that are its own content, rather than the steps nested inside it. */
+const contentKeys = (step) => Object.keys(step).filter((key) => key !== "id" && !CHILD_LISTS.includes(key));
+/** Deep equality over the plain JSON a step is made of. Key order does not count as a difference. */
+function sameValue(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== "object" || typeof b !== "object" || a === null || b === null)
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((item, index) => sameValue(item, b[index]));
+    }
+    const left = a;
+    const right = b;
+    const keys = new Set([...Object.keys(left), ...Object.keys(right)]);
+    for (const key of keys)
+        if (!sameValue(left[key], right[key]))
+            return false;
+    return true;
+}
+const isPose = (source) => typeof source === "object" && source !== null && "xIn" in source;
+/** The short way round, so a heading that crossed pi does not read as a six-radian turn. */
+const wrapRad = (radians) => {
+    const wrapped = ((radians + Math.PI) % (2 * Math.PI)) - Math.PI;
+    return wrapped <= -Math.PI ? wrapped + 2 * Math.PI : wrapped;
+};
+function poseDelta(where, before, after) {
+    if (!isPose(before) || !isPose(after))
+        return null;
+    const dxIn = after.xIn - before.xIn;
+    const dyIn = after.yIn - before.yIn;
+    const dHeadingRad = before.headingRad === undefined || after.headingRad === undefined
+        ? null
+        : wrapRad(after.headingRad - before.headingRad);
+    if (dxIn === 0 && dyIn === 0 && (dHeadingRad === null || dHeadingRad === 0))
+        return null;
+    return { where, dxIn, dyIn, dHeadingRad, distanceIn: Math.hypot(dxIn, dyIn) };
+}
+/** Every pose that moved between two versions of a path step, named by where it sits. */
+export function poseDeltas(before, after) {
+    if (before.kind !== "path" || after.kind !== "path")
+        return [];
+    const deltas = [];
+    const count = Math.min(before.segments.length, after.segments.length);
+    for (let index = 0; index < count; index += 1) {
+        const from = before.segments[index];
+        const to = after.segments[index];
+        if (from === undefined || to === undefined)
+            continue;
+        const at = `segments[${String(index)}]`;
+        for (const end of ["from", "to"]) {
+            const delta = poseDelta(`${at}.${end}`, from[end], to[end]);
+            if (delta !== null)
+                deltas.push(delta);
+        }
+        if (from.kind === "bezier" && to.kind === "bezier") {
+            const controls = Math.min(from.control.length, to.control.length);
+            for (let point = 0; point < controls; point += 1) {
+                const delta = poseDelta(`${at}.control[${String(point)}]`, from.control[point], to.control[point]);
+                if (delta !== null)
+                    deltas.push(delta);
+            }
+        }
+    }
+    return deltas;
+}
+/** Inches to two places, without the trailing zeroes that make a table hard to read. */
+const inches = (value) => {
+    const fixed = value.toFixed(2);
+    return fixed.includes(".") ? fixed.replace(/\.?0+$/, "") : fixed;
+};
+/** One sentence saying what happened to a step, which is what a reviewer reads first. */
+function summarise(change, before, after) {
+    const kindOf = (step) => step?.kind ?? "step";
+    switch (change.kind) {
+        case "added":
+            return `A ${kindOf(after)} step was added at position ${String((change.toIndex ?? 0) + 1)}.`;
+        case "removed":
+            return `The ${kindOf(before)} step at position ${String((change.fromIndex ?? 0) + 1)} was removed.`;
+        case "moved":
+            return `The ${kindOf(after)} step moved from position ${String((change.fromIndex ?? 0) + 1)} to position ${String((change.toIndex ?? 0) + 1)}.`;
+        default: {
+            const fields = change.fields ?? [];
+            const moved = change.poseDeltas ?? [];
+            const furthest = moved.reduce((best, delta) => (best === null || delta.distanceIn > best.distanceIn ? delta : best), null);
+            const named = fields.length <= 1
+                ? `Its ${fields[0] ?? "content"} changed`
+                : `Its ${fields.slice(0, -1).join(", ")} and ${String(fields[fields.length - 1])} changed`;
+            const tail = furthest === null
+                ? "."
+                : `, and ${moved.length === 1 ? "one pose" : `${String(moved.length)} poses`} moved, the furthest by ${inches(furthest.distanceIn)} in.`;
+            return `${named}${tail}`;
+        }
+    }
+}
+/** The document's own fields, in the order the schema declares them. */
+const HEADER_KEYS = [
+    "name",
+    "title",
+    "description",
+    "robot",
+    "field",
+    "alliance",
+    "authors",
+    "created",
+    "start",
+];
+/** The step-level structural diff between two routines. */
+export function diff(a, b) {
+    const before = walkSteps(a.steps);
+    const after = walkSteps(b.steps);
+    const beforeById = new Map(before.map((entry) => [entry.id, entry]));
+    const afterById = new Map(after.map((entry) => [entry.id, entry]));
+    const changes = [];
+    for (const entry of before) {
+        if (afterById.has(entry.id))
+            continue;
+        changes.push({
+            kind: "removed",
+            stepId: entry.id,
+            fromIndex: entry.index,
+            summary: summarise({ kind: "removed", stepId: entry.id, fromIndex: entry.index }, entry.step, null),
+        });
+    }
+    for (const entry of after) {
+        const old = beforeById.get(entry.id);
+        if (old === undefined) {
+            changes.push({
+                kind: "added",
+                stepId: entry.id,
+                toIndex: entry.index,
+                summary: summarise({ kind: "added", stepId: entry.id, toIndex: entry.index }, null, entry.step),
+            });
+            continue;
+        }
+        const fields = [...new Set([...contentKeys(old.step), ...contentKeys(entry.step)])].filter((key) => !sameValue(old.step[key], entry.step[key]));
+        if (fields.length > 0) {
+            const deltas = poseDeltas(old.step, entry.step);
+            const change = {
+                kind: "changed",
+                stepId: entry.id,
+                summary: "",
+                fields,
+                ...(deltas.length > 0 ? { poseDeltas: deltas } : {}),
+                fromIndex: old.index,
+                toIndex: entry.index,
+            };
+            change.summary = summarise(change, old.step, entry.step);
+            changes.push(change);
+        }
+        if (old.list !== entry.list || old.index !== entry.index) {
+            const change = {
+                kind: "moved",
+                stepId: entry.id,
+                summary: "",
+                fromIndex: old.index,
+                toIndex: entry.index,
+            };
+            change.summary =
+                old.list === entry.list
+                    ? summarise(change, old.step, entry.step)
+                    : `The ${entry.step.kind} step moved out of ${old.list} and into ${entry.list}.`;
+            changes.push(change);
+        }
+    }
+    // Document order in the new file, so a review reads top to bottom. A removed step keeps the place
+    // it held in the old one, just ahead of whatever now stands there.
+    const orderOf = (change) => {
+        const now = afterById.get(change.stepId);
+        if (now !== undefined)
+            return now.order;
+        return (beforeById.get(change.stepId)?.order ?? 0) - 0.5;
+    };
+    changes.sort((left, right) => orderOf(left) - orderOf(right));
+    const header = HEADER_KEYS.filter((key) => !sameValue(a[key], b[key])).map((key) => String(key));
+    return { changes, header, identical: changes.length === 0 && header.length === 0 };
+}
+const seconds = (value) => value === null || value === undefined ? "unknown" : value.toFixed(2);
+const signed = (value, places = 2) => `${value >= 0 ? "+" : "-"}${Math.abs(value).toFixed(places)}`;
+/** The estimate change for one step, or null when neither side has one to compare. */
+function deltaS(stepId, a, b) {
+    const before = a?.byStepId[stepId]?.nominalS;
+    const after = b?.byStepId[stepId]?.nominalS;
+    if (before === undefined && after === undefined)
+        return null;
+    if (before === undefined || before === null || after === undefined || after === null) {
+        return `${seconds(before)} s to ${seconds(after)} s`;
+    }
+    return `${before.toFixed(2)} s to ${after.toFixed(2)} s (${signed(after - before)} s)`;
+}
+/**
+ * The diff as markdown, for a pull request comment or the CLI. Passing the two estimates adds what
+ * the change costs in seconds, which is usually the question being asked.
+ */
+export function diffToMarkdown(autoDiff, estimateA, estimateB) {
+    const lines = [];
+    if (autoDiff.identical) {
+        lines.push("No structural changes.");
+    }
+    else {
+        if (autoDiff.header.length > 0) {
+            lines.push(`Header: ${autoDiff.header.join(", ")} changed.`, "");
+        }
+        for (const change of autoDiff.changes) {
+            const cost = deltaS(change.stepId, estimateA, estimateB);
+            lines.push(`- \`${change.stepId}\` ${change.kind}. ${change.summary}${cost === null ? "" : ` Estimate ${cost}.`}`);
+            for (const delta of change.poseDeltas ?? []) {
+                const heading = delta.dHeadingRad === null || delta.dHeadingRad === 0
+                    ? ""
+                    : `, heading ${signed((delta.dHeadingRad * 180) / Math.PI, 1)} degrees`;
+                lines.push(`  - \`${delta.where}\` moved ${inches(delta.distanceIn)} in (x ${signed(delta.dxIn)}, y ${signed(delta.dyIn)}${heading}).`);
+            }
+        }
+    }
+    if (estimateA !== undefined && estimateB !== undefined) {
+        const before = estimateA.nominalS;
+        const after = estimateB.nominalS;
+        const change = before === null || after === null ? null : after - before;
+        lines.push("", `Total: ${seconds(before)} s to ${seconds(after)} s${change === null ? "" : ` (${signed(change)} s)`}.`);
+    }
+    return lines.join("\n").trim();
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/edit/command.d.ts

@@ -0,0 +1,4 @@
+import type { Auto, CommandCall } from "@horizon36596/zenith-schema";
+/** Replaces a `command` step's arguments outright. */
+export declare function setCommandArgs(auto: Auto, stepId: string, args: CommandCall["args"]): Auto;
+//# sourceMappingURL=command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/edit/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAKrE,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAS1F"}

package/dist/edit/command.js

@@ -0,0 +1,16 @@
+import { EditError } from "./errors.js";
+import { finish } from "./finish.js";
+import { updateStep } from "./tree.js";
+/** Replaces a `command` step's arguments outright. */
+export function setCommandArgs(auto, stepId, args) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        if (step.kind !== "command") {
+            throw new EditError(`Step ${JSON.stringify(stepId)} is a ${step.kind} step, not a command.`);
+        }
+        return { ...step, args };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+//# sourceMappingURL=command.js.map

package/dist/edit/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/edit/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,MAAc,EAAE,IAAyB;IAClF,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,IAAI,uBAAuB,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrF,OAAO,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/edit/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Thrown by every structural edit primitive in this directory: an id that does not exist, a
+ * target that does not fit the step kind, or a mutation that would leave the auto invalid. The
+ * message is written for whoever is holding the file, human or agent.
+ */
+export declare class EditError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/edit/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/edit/errors.js

@@ -0,0 +1,12 @@
+/**
+ * Thrown by every structural edit primitive in this directory: an id that does not exist, a
+ * target that does not fit the step kind, or a mutation that would leave the auto invalid. The
+ * message is written for whoever is holding the file, human or agent.
+ */
+export class EditError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EditError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/edit/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/edit/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/edit/fields.d.ts

@@ -0,0 +1,40 @@
+import type { Auto, CommandCall, ParallelStep, PoseSource, Segment } from "@horizon36596/zenith-schema";
+/**
+ * Points a segment endpoint at a waypoint (`{ ref }`), at the previous step's end (`"current"`),
+ * or at a literal pose. The one edit `setPose` cannot express.
+ */
+export declare function setSegmentSource(auto: Auto, stepId: string, segmentIndex: number, pointKind: "from" | "to", source: PoseSource): Auto;
+/**
+ * Turns a segment into a line or a Bezier. Becoming a Bezier needs somewhere to put the new
+ * control point, and core will not invent one (CLAUDE.md rule 4): the caller passes the point,
+ * which is the segment's midpoint when the editor does it.
+ */
+export declare function setSegmentKind(auto: Auto, stepId: string, segmentIndex: number, kind: Segment["kind"], control: {
+    xIn: number;
+    yIn: number;
+}): Auto;
+/** Sets or clears a path step's end condition ("stop when the hopper is full"). */
+export declare function setEndCondition(auto: Auto, stepId: string, condition: string | null): Auto;
+/** Sets a step's note, or removes it when the text is blank. */
+export declare function setNotes(auto: Auto, stepId: string, notes: string): Auto;
+/** Sets what a wait step waits for: a number of seconds, a robot-side condition, or both. */
+export declare function setWait(auto: Auto, stepId: string, wait: {
+    seconds?: number;
+    until?: string;
+}): Auto;
+/** Sets a parallel group's mode, and which child is its deadline. */
+export declare function setParallel(auto: Auto, stepId: string, patch: {
+    mode?: ParallelStep["mode"];
+    deadline?: string;
+}): Auto;
+/** Sets the robot-side condition a branch step asks about. */
+export declare function setBranchCondition(auto: Auto, stepId: string, condition: string): Auto;
+/**
+ * Points a command step at a different registered command. The arguments go with the old name:
+ * they were built from its parameters, and keeping them would silently pass one command's
+ * arguments to another.
+ */
+export declare function setCommandName(auto: Auto, stepId: string, name: string): Auto;
+/** Replaces the command a marker fires, keeping where on the path it sits. */
+export declare function setMarkerCommand(auto: Auto, stepId: string, markerIndex: number, command: CommandCall): Auto;
+//# sourceMappingURL=fields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/edit/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EAEJ,WAAW,EACX,YAAY,EAEZ,UAAU,EACV,OAAO,EAGR,MAAM,6BAA6B,CAAC;AAyCrC;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,UAAU,GACjB,IAAI,CAUN;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EACrB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpC,IAAI,CAWN;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAU1F;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CASxE;AAED,6FAA6F;AAC7F,wBAAgB,OAAO,CACrB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,IAAI,CAQN;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,IAAI,CAUN;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAQtF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAO7E;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,GACnB,IAAI,CAgBN"}

package/dist/edit/fields.js

@@ -0,0 +1,150 @@
+import { EditError } from "./errors.js";
+import { finish } from "./finish.js";
+import { updateStep } from "./tree.js";
+/**
+ * The field-level edits the inspector and an agent both need, on top of the structural primitives
+ * next to them: pointing a segment endpoint at a waypoint, turning a line into a curve, and
+ * setting the one field that makes a wait a wait or a branch a branch.
+ *
+ * `setPose` (`path.ts`) writes literal poses only, so the editor could not say "this endpoint is
+ * the `shootNorth` waypoint" through core at all; these fill that gap. Same contract as every
+ * other primitive here: never mutate the input, always `finish` the candidate, so an edit that
+ * would leave the file invalid throws rather than being written.
+ */
+function asPathStep(step, stepId) {
+    if (step.kind !== "path") {
+        throw new EditError(`Step ${JSON.stringify(stepId)} is a ${step.kind} step, not a path.`);
+    }
+    return step;
+}
+/** Applies `edit` to the step with this effective id, or throws naming the id that is not there. */
+function editStep(auto, stepId, edit) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => edit(step));
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+/** The segment at this index, or a message naming the step that has no such segment. */
+function segmentAt(step, stepId, segmentIndex) {
+    const segment = step.segments[segmentIndex];
+    if (segment === undefined) {
+        throw new EditError(`Step ${JSON.stringify(stepId)} has no segment at index ${String(segmentIndex)}.`);
+    }
+    return segment;
+}
+/**
+ * Points a segment endpoint at a waypoint (`{ ref }`), at the previous step's end (`"current"`),
+ * or at a literal pose. The one edit `setPose` cannot express.
+ */
+export function setSegmentSource(auto, stepId, segmentIndex, pointKind, source) {
+    return editStep(auto, stepId, (step) => {
+        const path = asPathStep(step, stepId);
+        segmentAt(path, stepId, segmentIndex);
+        const segments = path.segments.map((segment, index) => {
+            if (index !== segmentIndex)
+                return segment;
+            return pointKind === "from" ? { ...segment, from: source } : { ...segment, to: source };
+        });
+        return { ...path, segments };
+    });
+}
+/**
+ * Turns a segment into a line or a Bezier. Becoming a Bezier needs somewhere to put the new
+ * control point, and core will not invent one (CLAUDE.md rule 4): the caller passes the point,
+ * which is the segment's midpoint when the editor does it.
+ */
+export function setSegmentKind(auto, stepId, segmentIndex, kind, control) {
+    return editStep(auto, stepId, (step) => {
+        const path = asPathStep(step, stepId);
+        segmentAt(path, stepId, segmentIndex);
+        const segments = path.segments.map((segment, index) => {
+            if (index !== segmentIndex || segment.kind === kind)
+                return segment;
+            if (kind === "line")
+                return { kind: "line", from: segment.from, to: segment.to };
+            return { kind: "bezier", from: segment.from, control: [control], to: segment.to };
+        });
+        return { ...path, segments };
+    });
+}
+/** Sets or clears a path step's end condition ("stop when the hopper is full"). */
+export function setEndCondition(auto, stepId, condition) {
+    return editStep(auto, stepId, (step) => {
+        const path = asPathStep(step, stepId);
+        if (condition === null) {
+            const next = { ...path };
+            delete next.endCondition;
+            return next;
+        }
+        return { ...path, endCondition: { condition } };
+    });
+}
+/** Sets a step's note, or removes it when the text is blank. */
+export function setNotes(auto, stepId, notes) {
+    return editStep(auto, stepId, (step) => {
+        if (notes.trim() === "") {
+            const next = { ...step };
+            delete next.notes;
+            return next;
+        }
+        return { ...step, notes };
+    });
+}
+/** Sets what a wait step waits for: a number of seconds, a robot-side condition, or both. */
+export function setWait(auto, stepId, wait) {
+    return editStep(auto, stepId, (step) => {
+        if (step.kind !== "wait") {
+            throw new EditError(`Step ${JSON.stringify(stepId)} is a ${step.kind} step, not a wait.`);
+        }
+        const next = { ...step, seconds: wait.seconds, until: wait.until };
+        return next;
+    });
+}
+/** Sets a parallel group's mode, and which child is its deadline. */
+export function setParallel(auto, stepId, patch) {
+    return editStep(auto, stepId, (step) => {
+        if (step.kind !== "parallel") {
+            throw new EditError(`Step ${JSON.stringify(stepId)} is a ${step.kind} step, not a parallel group.`);
+        }
+        const next = { ...step, ...patch };
+        return next;
+    });
+}
+/** Sets the robot-side condition a branch step asks about. */
+export function setBranchCondition(auto, stepId, condition) {
+    return editStep(auto, stepId, (step) => {
+        if (step.kind !== "branch") {
+            throw new EditError(`Step ${JSON.stringify(stepId)} is a ${step.kind} step, not a branch.`);
+        }
+        const next = { ...step, condition };
+        return next;
+    });
+}
+/**
+ * Points a command step at a different registered command. The arguments go with the old name:
+ * they were built from its parameters, and keeping them would silently pass one command's
+ * arguments to another.
+ */
+export function setCommandName(auto, stepId, name) {
+    return editStep(auto, stepId, (step) => {
+        if (step.kind !== "command") {
+            throw new EditError(`Step ${JSON.stringify(stepId)} is a ${step.kind} step, not a command.`);
+        }
+        return { ...step, name, args: undefined };
+    });
+}
+/** Replaces the command a marker fires, keeping where on the path it sits. */
+export function setMarkerCommand(auto, stepId, markerIndex, command) {
+    return editStep(auto, stepId, (step) => {
+        const path = asPathStep(step, stepId);
+        const markers = path.markers ?? [];
+        if (markers[markerIndex] === undefined) {
+            throw new EditError(`Step ${JSON.stringify(stepId)} has no marker at index ${String(markerIndex)}.`);
+        }
+        return {
+            ...path,
+            markers: markers.map((marker, index) => index === markerIndex ? { ...marker, command } : marker),
+        };
+    });
+}
+//# sourceMappingURL=fields.js.map

package/dist/edit/fields.js.map

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

package/dist/edit/finish.d.ts

@@ -0,0 +1,15 @@
+import { type Auto } from "@horizon36596/zenith-schema";
+/**
+ * Every primitive in this directory ends by calling this on the candidate document it built.
+ * Parsing through the zod schema is what "keep canonical validity" means in practice: the schema
+ * both validates the result and produces a fresh object tree, so a primitive can build its
+ * candidate with ordinary object spreads without worrying about mutating anything the caller
+ * still holds a reference to, and a mutation that would leave the file invalid throws here with
+ * every failing key named, instead of writing a broken file.
+ *
+ * Unique effective ids are part of that validity, and the schema cannot express them: every
+ * primitive addresses a step by its id and `updateStep` stops at the first match, so a document
+ * with the same id twice would have its later steps silently unreachable.
+ */
+export declare function finish(candidate: unknown): Auto;
+//# sourceMappingURL=finish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../src/edit/finish.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAIhF;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAsB/C"}

package/dist/edit/finish.js

@@ -0,0 +1,36 @@
+import { parseAuto, SchemaError } from "@horizon36596/zenith-schema";
+import { EditError } from "./errors.js";
+import { duplicateIds } from "./ids.js";
+/**
+ * Every primitive in this directory ends by calling this on the candidate document it built.
+ * Parsing through the zod schema is what "keep canonical validity" means in practice: the schema
+ * both validates the result and produces a fresh object tree, so a primitive can build its
+ * candidate with ordinary object spreads without worrying about mutating anything the caller
+ * still holds a reference to, and a mutation that would leave the file invalid throws here with
+ * every failing key named, instead of writing a broken file.
+ *
+ * Unique effective ids are part of that validity, and the schema cannot express them: every
+ * primitive addresses a step by its id and `updateStep` stops at the first match, so a document
+ * with the same id twice would have its later steps silently unreachable.
+ */
+export function finish(candidate) {
+    try {
+        const auto = parseAuto(candidate);
+        const repeated = duplicateIds(auto.steps);
+        if (repeated.length > 0) {
+            throw new EditError(`This edit would leave two steps sharing the id ${repeated
+                .map((id) => JSON.stringify(id))
+                .join(", ")}, and every step is addressed by its id.`);
+        }
+        return auto;
+    }
+    catch (error) {
+        if (error instanceof SchemaError) {
+            throw new EditError(`This edit would leave the auto invalid:\n  ${error.issues
+                .map((issue) => `${issue.path.length === 0 ? "(root)" : issue.path.join(".")}: ${issue.message}`)
+                .join("\n  ")}`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=finish.js.map

package/dist/edit/finish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.js","sourceRoot":"","sources":["../../src/edit/finish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAa,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB;IACvC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CACjB,kDAAkD,QAAQ;iBACvD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;iBAC/B,IAAI,CAAC,IAAI,CAAC,0CAA0C,CACxD,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CACjB,8CAA8C,KAAK,CAAC,MAAM;iBACvD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;iBAChG,IAAI,CAAC,MAAM,CAAC,EAAE,CAClB,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}