@jevitate/cli 0.9.0 → 0.11.0

package/dist/journeeze-connect.js

@@ -0,0 +1,357 @@
+import { execFile } from "node:child_process";
+import { chmod, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, resolve as resolvePath } from "node:path";
+import { redactText } from "@jevitate/ai-core";
+import { clock } from "@jevitate/domain";
+import { inMcpInvocation } from "./approval-provenance.js";
+import { resolveDataDir } from "./data-dir.js";
+import { readMaskedLine } from "./masked-input.js";
+import { secretCommandRunner } from "./secret-command.js";
+/**
+ * #464 — the Journeeze connection: which hosts an upload key may go to, how the key is found, and
+ * what `jevitate connect journeeze` saves (journeeze-saas `docs/contract/catalog-bundle-upload-v1.md`).
+ *
+ * The key itself is NEVER saved by jevitate. `connect` saves a REFERENCE to where the person keeps it
+ * (an environment variable, a command that prints it, or a password-manager entry), bound to the
+ * Journeeze origin it was verified against, in `~/.jevitate/journeeze.json` (outside the repo, 0600).
+ * The reference is shaped like `@jevitate/secrets`' `SecretRef` (`{manager, key, origin, field}`):
+ * jevitate delegates to the external source on every use and never implements a vault.
+ */
+/** The upload key's format (contract §3): `jzu_` + 40 lowercase base32 characters. */
+export const JOURNEEZE_KEY_RE = /^jzu_[a-z2-7]{40}$/;
+/** Anything that looks like (part of) a key — refused wherever only a reference belongs. */
+const KEY_LIKE_RE = /jzu_[a-z2-7]{8,}/i;
+/** The CI env var (contract §9); read through ai-core's `CredentialStore` (never its plaintext file). */
+export const JOURNEEZE_KEY_ENV = "JOURNEEZE_UPLOAD_KEY";
+/** Optional base URL for CI (`publish` only); pinned like `--url`. */
+export const JOURNEEZE_URL_ENV = "JOURNEEZE_URL";
+export const JOURNEEZE_API_PREFIX = "/api/upload/v1";
+/** Contract §2: the only hosts an upload key is ever sent to (plus loopback, only with `JEVITATE_JOURNEEZE_DEV=1`). */
+export const JOURNEEZE_PINNED_ORIGINS = ["https://app.journeeze.dev", "https://app.staging.journeeze.dev"];
+/** `JEVITATE_JOURNEEZE_DEV=1` allows a loopback Journeeze (local development of Journeeze itself). */
+export const JOURNEEZE_DEV_ENV = "JEVITATE_JOURNEEZE_DEV";
+const LOOPBACK_HOSTS = new Set(["localhost", "127.0.0.1", "[::1]"]);
+/** A Journeeze-specific refusal. `code` is stable; the message never carries a key. */
+export class JourneezeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "JourneezeError";
+    }
+}
+/**
+ * The Journeeze origin for a base URL, or a `JourneezeError`: HTTPS on a pinned host, or — only when
+ * `JEVITATE_JOURNEEZE_DEV=1` is set — http(s) on a loopback host (local development, contract §2;
+ * otherwise an upload key would go over plain HTTP to whatever listens on that port). No path,
+ * credentials, query or fragment.
+ */
+export function pinnedJourneezeOrigin(baseUrl, env = process.env) {
+    let u;
+    try {
+        u = new URL(baseUrl);
+    }
+    catch {
+        throw new JourneezeError("E_JOURNEEZE_URL", `not a URL: ${JSON.stringify(baseUrl)}`);
+    }
+    const bare = u.username === "" && u.password === "" && u.search === "" && u.hash === "" && (u.pathname === "/" || u.pathname === "");
+    if (!bare)
+        throw new JourneezeError("E_JOURNEEZE_URL", `the Journeeze URL must be a bare origin (got ${JSON.stringify(baseUrl)})`);
+    if (LOOPBACK_HOSTS.has(u.hostname) && (u.protocol === "http:" || u.protocol === "https:")) {
+        if (env[JOURNEEZE_DEV_ENV]?.trim() === "1")
+            return u.origin;
+        throw new JourneezeError("E_JOURNEEZE_URL", `refusing ${u.origin}: a loopback Journeeze is for local development only — set ${JOURNEEZE_DEV_ENV}=1 to send an upload key there`);
+    }
+    if (u.protocol === "https:" && JOURNEEZE_PINNED_ORIGINS.includes(u.origin))
+        return u.origin;
+    throw new JourneezeError("E_JOURNEEZE_URL", `an upload key is only ever sent to ${JOURNEEZE_PINNED_ORIGINS.join(" or ")} (or a loopback host with ${JOURNEEZE_DEV_ENV}=1) — refusing ${u.origin}`);
+}
+export const fetchJourneezeHttp = async (req) => {
+    const headers = { ...req.headers };
+    // undici sets Content-Length itself for a byte body (a forbidden request header to set by hand).
+    delete headers["Content-Length"];
+    return fetch(req.url, {
+        method: req.method,
+        headers,
+        redirect: "manual",
+        ...(req.body === undefined ? {} : { body: Buffer.from(req.body) }),
+    });
+};
+/** Sends `req`, refusing any response that is a redirect (the key never follows one to another origin). */
+export async function sendPinned(http, origin, req) {
+    if (new URL(req.url).origin !== origin) {
+        throw new JourneezeError("E_JOURNEEZE_ORIGIN", `refusing to send the upload key to ${new URL(req.url).origin}: it is bound to ${origin}`);
+    }
+    const res = await http(req);
+    if (res.status === 0 || (res.status >= 300 && res.status < 400)) {
+        const to = res.headers.get("location");
+        throw new JourneezeError("E_JOURNEEZE_REDIRECT", `Journeeze answered ${req.method} ${new URL(req.url).pathname} with a redirect${to ? ` to ${safeLocation(to, req.url)}` : ""} — redirects are never followed with an upload key`);
+    }
+    return res;
+}
+function safeLocation(location, base) {
+    try {
+        return new URL(location, base).origin;
+    }
+    catch {
+        return "an invalid location";
+    }
+}
+/** The JSON body of a response, or `{}` when it is not JSON (unknown fields are ignored, contract §8). */
+export async function jsonBody(res) {
+    try {
+        const parsed = JSON.parse(await res.text());
+        return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** `code (requestId)` of an error response (contract §5), for messages. Never echoes the request. */
+export function describeError(res, body) {
+    const code = typeof body.code === "string" ? body.code : "unknown";
+    const message = typeof body.message === "string" ? `: ${body.message.slice(0, 300)}` : "";
+    const requestId = res.headers.get("journeeze-request-id") ?? (typeof body.requestId === "string" ? body.requestId : undefined);
+    return `${res.status} ${code}${message}${requestId ? ` (request ${requestId})` : ""}`;
+}
+/**
+ * Parses what the person typed at the reference prompt: `env:<VAR>`, `cmd:<command>`, `op://…`,
+ * `bw:<item>` or `pass:<path>`. Anything that looks like a key itself is refused (without echoing it).
+ */
+export function parseKeyRef(text, origin) {
+    const t = text.trim();
+    if (KEY_LIKE_RE.test(t)) {
+        throw new JourneezeError("E_JOURNEEZE_REF", "that looks like the upload key itself — jevitate saves only WHERE the key is kept, never the key");
+    }
+    const ref = (manager, key) => {
+        if (key.trim() === "")
+            throw new JourneezeError("E_JOURNEEZE_REF", `the ${manager} reference is empty`);
+        return { manager, key: key.trim(), origin, field: "journeeze-upload-key" };
+    };
+    if (t.startsWith("env:")) {
+        const name = t.slice(4).trim();
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name))
+            throw new JourneezeError("E_JOURNEEZE_REF", `not an environment variable name: ${JSON.stringify(name)}`);
+        return ref("env", name);
+    }
+    if (t.startsWith("cmd:"))
+        return ref("cmd", t.slice(4));
+    if (t.startsWith("op://"))
+        return ref("op", t);
+    if (t.startsWith("bw:"))
+        return ref("bw", t.slice(3));
+    if (t.startsWith("pass:"))
+        return ref("pass", t.slice(5));
+    throw new JourneezeError("E_JOURNEEZE_REF", "expected env:<VAR>, cmd:<command>, op://…, bw:<item> or pass:<path>");
+}
+export function defaultKeySources(env = process.env) {
+    return {
+        env,
+        runCommand: secretCommandRunner(),
+        exec: (cmd, args) => new Promise((resolveOut, reject) => {
+            execFile(cmd, [...args], { timeout: 60_000, maxBuffer: 64 * 1024 }, (err, stdout) => (err ? reject(err) : resolveOut(String(stdout))));
+        }),
+    };
+}
+const MANAGER_COMMANDS = {
+    op: (key) => ["op", ["read", key]],
+    bw: (key) => ["bw", ["get", "password", key]],
+    pass: (key) => ["pass", ["show", key]],
+};
+/**
+ * The key a reference points to, or a `JourneezeError` that names the reference — never the source's
+ * output (a misconfigured source may print the secret on failure). The value is checked for the key
+ * format; the caller uses it only for the `Authorization` header.
+ */
+export async function resolveKeyRef(ref, sources) {
+    let raw;
+    try {
+        if (ref.manager === "env")
+            raw = sources.env[ref.key];
+        else if (ref.manager === "cmd")
+            raw = await sources.runCommand(ref.key);
+        else {
+            const [cmd, args] = MANAGER_COMMANDS[ref.manager](ref.key);
+            raw = await sources.exec(cmd, args);
+        }
+    }
+    catch (err) {
+        const code = err?.code;
+        throw new JourneezeError("E_JOURNEEZE_KEY_UNRESOLVABLE", `could not read the upload key from ${describeRef(ref)}${typeof code === "number" || typeof code === "string" ? ` (exit code ${String(code)})` : ""}`);
+    }
+    // `pass show` prints the secret on its first line; the others print it alone.
+    const value = (raw ?? "").split(/\r?\n/).map((l) => l.trim()).find((l) => l !== "") ?? "";
+    if (value === "")
+        throw new JourneezeError("E_JOURNEEZE_KEY_UNRESOLVABLE", `${describeRef(ref)} is empty or unset`);
+    if (!JOURNEEZE_KEY_RE.test(value)) {
+        throw new JourneezeError("E_JOURNEEZE_KEY_FORMAT", `the value from ${describeRef(ref)} is not a Journeeze upload key (jzu_ followed by 40 characters)`);
+    }
+    return value;
+}
+/** A display form of a reference (never a value). */
+export function describeRef(ref) {
+    switch (ref.manager) {
+        case "env":
+            return `environment variable ${ref.key}`;
+        case "cmd":
+            return "the saved key command";
+        default:
+            return `${ref.manager} entry ${ref.key}`;
+    }
+}
+export function connectionsPath(deps = {}) {
+    return resolveDataDir(["journeeze.json"], deps.homedir ? { homedir: deps.homedir } : {});
+}
+/** The connection's lookup key: the project data dir (absolute), or `*` outside a project. */
+export function projectKey(projectDir) {
+    return projectDir === null ? "*" : resolvePath(projectDir);
+}
+async function readConnections(deps) {
+    const path = connectionsPath(deps);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (err) {
+        if (err?.code === "ENOENT")
+            return { version: 1, connections: {} };
+        throw new JourneezeError("E_JOURNEEZE_CONFIG", `cannot read ${path}`);
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== 1 || typeof parsed.connections !== "object" || parsed.connections === null)
+            throw new Error("shape");
+        return parsed;
+    }
+    catch {
+        throw new JourneezeError("E_JOURNEEZE_CONFIG", `${path} is not a jevitate Journeeze connections file — fix or delete it, then run \`jevitate connect journeeze\``);
+    }
+}
+/**
+ * The saved connection for a project: ONLY that project's own (a connection made in one project, or
+ * outside any, never uploads another project's catalog). The `*` connection (made outside any
+ * project) applies only outside a project, and never inside an MCP call. A project without its own
+ * connection is not connected: a person runs `jevitate connect journeeze` in that project.
+ */
+export async function loadConnection(projectDir, deps = {}) {
+    if (projectDir === null && inMcpInvocation())
+        return undefined;
+    const file = await readConnections(deps);
+    const key = projectKey(projectDir);
+    return Object.prototype.hasOwnProperty.call(file.connections, key) ? file.connections[key] : undefined;
+}
+/** Saves a connection (a reference, never a key) — refuses anything that looks like a key. */
+export async function saveConnection(projectDir, conn, deps = {}) {
+    const file = await readConnections(deps);
+    const next = { version: 1, connections: { ...file.connections, [projectKey(projectDir)]: conn } };
+    const text = `${JSON.stringify(next, null, 2)}\n`;
+    if (KEY_LIKE_RE.test(text.replace(/"keyPrefix": "jzu_[a-z2-7]{4}"/g, ""))) {
+        throw new JourneezeError("E_JOURNEEZE_CONFIG", "refusing to save: the connection would hold an upload key in plain text");
+    }
+    const path = connectionsPath(deps);
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const tmp = `${path}.${process.pid}.tmp`;
+    await writeFile(tmp, text, { mode: 0o600 });
+    await chmod(tmp, 0o600);
+    await rename(tmp, path);
+    return path;
+}
+/** Verifies a key with `GET /whoami` — the only call `connect` makes with it. */
+export async function whoami(http, origin, key) {
+    const res = await sendPinned(http, origin, {
+        method: "GET",
+        url: `${origin}${JOURNEEZE_API_PREFIX}/whoami`,
+        headers: { Authorization: `Bearer ${key}`, Accept: "application/json" },
+    });
+    const body = await jsonBody(res);
+    if (res.status !== 200) {
+        const reconnect = res.status === 401 ? " — check the key (create a new one on the Journeeze board if it was revoked or expired)" : "";
+        throw new JourneezeError(res.status === 401 ? "E_JOURNEEZE_KEY_REFUSED" : "E_JOURNEEZE_HTTP", `Journeeze refused the key check: ${describeError(res, body)}${reconnect}`);
+    }
+    const product = body.product;
+    if (typeof product?.id !== "string" || typeof product.name !== "string") {
+        throw new JourneezeError("E_JOURNEEZE_HTTP", "Journeeze's key check returned no product");
+    }
+    const tenant = body.tenant?.name;
+    const prefix = typeof body.keyPrefix === "string" && /^jzu_[a-z2-7]{4}$/.test(body.keyPrefix) ? body.keyPrefix : key.slice(0, 8);
+    return { product: { id: product.id, name: product.name }, tenant: typeof tenant === "string" ? tenant : "", keyPrefix: prefix };
+}
+export function processTerminal() {
+    return {
+        isTTY: process.stdin.isTTY === true && process.stderr.isTTY === true,
+        async ask(question) {
+            const { createInterface } = await import("node:readline/promises");
+            const rl = createInterface({ input: process.stdin, output: process.stderr });
+            try {
+                return await rl.question(`${question} `);
+            }
+            finally {
+                rl.close();
+            }
+        },
+        askHidden: (question) => readMaskedLine(process.stdin, process.stderr, question),
+        say: (line) => void process.stderr.write(`${line}\n`),
+    };
+}
+const REF_PROMPT = [
+    "Where do you keep this product's Journeeze upload key? jevitate saves only this reference, never the key:",
+    "  env:<VAR>                           an environment variable",
+    "  cmd:<command>                       a command that prints it",
+    "  op://…  |  bw:<item>  |  pass:<path>  a password manager entry",
+].join("\n");
+/**
+ * `jevitate connect journeeze`: the person names where the key is kept (or types the key, hidden, to
+ * check it first — then names where it is kept, which must hold the same key); the key is verified
+ * with `whoami`; the person confirms the product; only the reference is saved.
+ */
+export async function runConnect(baseUrl, projectDir, deps = {}) {
+    const origin = pinnedJourneezeOrigin(baseUrl);
+    const term = deps.terminal ?? processTerminal();
+    if (!term.isTTY) {
+        throw new JourneezeError("E_CONNECT_NEEDS_TTY", "connect journeeze needs a person at a terminal (it asks for the upload key); in CI set JOURNEEZE_UPLOAD_KEY instead");
+    }
+    const http = deps.http ?? fetchJourneezeHttp;
+    const sources = deps.sources ?? defaultKeySources();
+    let typed;
+    const seen = [];
+    try {
+        term.say(REF_PROMPT);
+        let answer = (await term.ask("Reference (leave empty to type the key itself and check it first):")).trim();
+        if (answer === "") {
+            typed = (await term.askHidden("Journeeze upload key (jzu_…; hidden):")).trim();
+            seen.push(typed);
+            if (!JOURNEEZE_KEY_RE.test(typed))
+                throw new JourneezeError("E_JOURNEEZE_KEY_FORMAT", "that is not a Journeeze upload key (jzu_ followed by 40 characters)");
+            const who = await whoami(http, origin, typed);
+            term.say(`The key is valid for '${who.product.name}'${who.tenant ? ` (${who.tenant})` : ""}. Now say where it is kept.`);
+            answer = (await term.ask("Reference:")).trim();
+        }
+        const ref = parseKeyRef(answer, origin);
+        const key = await resolveKeyRef(ref, sources);
+        seen.push(key);
+        if (typed !== undefined && key !== typed) {
+            throw new JourneezeError("E_JOURNEEZE_REF", `${describeRef(ref)} holds a different key than the one you typed — nothing was saved`);
+        }
+        const who = await whoami(http, origin, key);
+        const yes = (await term.ask(`Connect this project to Journeeze product '${who.product.name}'${who.tenant ? ` (${who.tenant})` : ""} at ${origin}? [y/N]`)).trim().toLowerCase();
+        if (yes !== "y" && yes !== "yes") {
+            throw new JourneezeError("E_CONNECT_DECLINED", "not connected — nothing was saved");
+        }
+        await saveConnection(projectDir, { baseUrl: origin, product: who.product, keyPrefix: who.keyPrefix, keyRef: ref, connectedAt: new Date(clock.now()).toISOString() }, deps);
+        return { baseUrl: origin, product: who.product, keyPrefix: who.keyPrefix, stored: true };
+    }
+    catch (err) {
+        throw scrubError(err, seen, "E_CONNECT");
+    }
+}
+/** Re-throws `err` as a `JourneezeError` whose message has every given secret removed. */
+export function scrubError(err, secrets, fallbackCode) {
+    const code = err instanceof JourneezeError ? err.code : fallbackCode;
+    const message = err instanceof Error ? err.message : String(err);
+    return new JourneezeError(code, redactText(message, secrets));
+}
+/** Sleeps on jevitate's clock (tests inject their own). */
+export function clockSleep(ms) {
+    return new Promise((r) => clock.setTimeout(r, ms));
+}
+//# sourceMappingURL=journeeze-connect.js.map

package/dist/journeeze-connect.js.map

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

package/dist/journey-anchor-api.d.ts

@@ -0,0 +1,37 @@
+import { AnchorEditError, type AddAnchorInput, type AnchorLintIssue, type AnchorSuggestion, type StampedAnchor } from "@jevitate/journey";
+/**
+ * #487: edit a draft Journey's anchors (`journey anchor add|remove`, `journey lint --fix`) — the API
+ * both the CLI and MCP call. Each edit writes the Journey (step ids minted and anchors stamped the
+ * way `promote` does) and returns the anchor lint issues that remain.
+ */
+/** A PROMOTED Journey's anchors changed: its approval binds to the content hash, so the edit would silently void it. Exit 64. */
+export declare class PromotedJourneyEditError extends Error {
+    readonly code = "E_JOURNEY_ANCHOR_ARGS";
+    constructor(id: string);
+}
+export interface AnchorEditResult {
+    readonly journeyId: string;
+    /** The Journey's anchor-rule problems after the edit (warnings; empty when it complies). */
+    readonly issues: readonly AnchorLintIssue[];
+}
+export interface AnchorFixResult extends AnchorEditResult {
+    /** The anchors given a step id (empty: nothing needed it, nothing was written). */
+    readonly stamped: readonly StampedAnchor[];
+}
+/** Adds an anchor (`stepId` written at once). Throws `UnknownJourneyError`, `PromotedJourneyEditError`, `AnchorEditError`. */
+export declare function addJourneyAnchor(dir: string, id: string, input: AddAnchorInput): Promise<AnchorEditResult>;
+/** Removes the named anchor. Throws as `addJourneyAnchor`. */
+export declare function removeJourneyAnchor(dir: string, id: string, name: string): Promise<AnchorEditResult>;
+/** `journey lint --fix`: stamps each number-only anchor with its step's id and writes the Journey. Nothing to stamp: nothing written, even when promoted. */
+export declare function fixJourneyAnchors(dir: string, id: string): Promise<AnchorFixResult>;
+export interface AnchorSuggestResult {
+    readonly journeyId: string;
+    readonly steps: number;
+    /** Advisory only: nothing was written. Each carries the `journey anchor add` command that accepts it. */
+    readonly suggestions: readonly (AnchorSuggestion & {
+        readonly command: string;
+    })[];
+}
+/** `journey anchors --suggest`: anchors worth adding where the recorded flow changes state. Writes nothing. */
+export declare function suggestJourneyAnchors(dir: string, id: string, readRequests?: readonly string[]): Promise<AnchorSuggestResult>;
+export { AnchorEditError };

package/dist/journey-anchor-api.js

@@ -0,0 +1,58 @@
+import { AnchorEditError, FsJourneyStore, JourneyRegistry, addAnchor, anchorAddCommand, anchorLintIssues, removeAnchor, suggestAnchors, stampUnstampedAnchors } from "@jevitate/journey";
+import { UnknownJourneyError } from "./journey-api.js";
+/**
+ * #487: edit a draft Journey's anchors (`journey anchor add|remove`, `journey lint --fix`) — the API
+ * both the CLI and MCP call. Each edit writes the Journey (step ids minted and anchors stamped the
+ * way `promote` does) and returns the anchor lint issues that remain.
+ */
+/** A PROMOTED Journey's anchors changed: its approval binds to the content hash, so the edit would silently void it. Exit 64. */
+export class PromotedJourneyEditError extends Error {
+    code = "E_JOURNEY_ANCHOR_ARGS";
+    constructor(id) {
+        super(`journey '${id}' is promoted: changing its anchors changes the content hash its approval is bound to (stamping a step id included, since the hash covers it). ` +
+            `Edit it as a draft and re-promote — jevitate journey review ${id}, then jevitate journey promote ${id} — a person re-approves the new content`);
+    }
+}
+async function load(dir, id) {
+    const store = new FsJourneyStore(dir);
+    const journey = await new JourneyRegistry(store).get(id);
+    if (journey === null)
+        throw new UnknownJourneyError(`unknown journey '${id}'`);
+    return { store, journey };
+}
+async function edit(dir, id, change) {
+    const { store, journey } = await load(dir, id);
+    if (journey.metadata.promoted)
+        throw new PromotedJourneyEditError(id);
+    const next = change(journey);
+    await store.put(next);
+    const written = (await store.get(id)) ?? next;
+    return { journeyId: id, issues: anchorLintIssues(written) };
+}
+/** Adds an anchor (`stepId` written at once). Throws `UnknownJourneyError`, `PromotedJourneyEditError`, `AnchorEditError`. */
+export function addJourneyAnchor(dir, id, input) {
+    return edit(dir, id, (j) => addAnchor(j, input));
+}
+/** Removes the named anchor. Throws as `addJourneyAnchor`. */
+export function removeJourneyAnchor(dir, id, name) {
+    return edit(dir, id, (j) => removeAnchor(j, name));
+}
+/** `journey lint --fix`: stamps each number-only anchor with its step's id and writes the Journey. Nothing to stamp: nothing written, even when promoted. */
+export async function fixJourneyAnchors(dir, id) {
+    const { store, journey } = await load(dir, id);
+    const { journey: next, stamped } = stampUnstampedAnchors(journey);
+    if (stamped.length === 0)
+        return { journeyId: id, issues: anchorLintIssues(journey), stamped };
+    if (journey.metadata.promoted)
+        throw new PromotedJourneyEditError(id);
+    await store.put(next);
+    return { journeyId: id, issues: anchorLintIssues((await store.get(id)) ?? next), stamped };
+}
+/** `journey anchors --suggest`: anchors worth adding where the recorded flow changes state. Writes nothing. */
+export async function suggestJourneyAnchors(dir, id, readRequests) {
+    const { journey } = await load(dir, id);
+    const suggestions = suggestAnchors(journey, { readRequests }).map((s) => ({ ...s, command: anchorAddCommand(id, s) }));
+    return { journeyId: id, steps: journey.recording.pages.reduce((n, p) => n + p.steps.length, 0), suggestions };
+}
+export { AnchorEditError };
+//# sourceMappingURL=journey-anchor-api.js.map

package/dist/journey-anchor-api.js.map

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

package/dist/journey-anchor-cli.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from "commander";
+import { type CliDeps } from "./cli-shared.js";
+/** Maps an edit failure to its envelope: unknown id and refused edits are usage errors (64). */
+export declare function anchorEditFailure(program: Command, err: unknown): void;
+/**
+ * #487 — `jevitate journey anchor add|remove`: edit a draft Journey's anchors without hand-editing
+ * `metadata.anchors`. The step id is written at once; the anchor lint issues that remain are printed.
+ */
+export declare function registerJourneyAnchorCommands(journey: Command, program: Command, deps: CliDeps): void;
+/**
+ * #487 — `journey anchors <id> --suggest`: advisory anchor proposals (a new page, a form that became
+ * valid, a completed write), each with the `journey anchor add` command that accepts it. Writes nothing.
+ */
+export declare function runAnchorSuggest(program: Command, deps: CliDeps, id: string, opts: {
+    dir?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/journey-anchor-cli.js

@@ -0,0 +1,104 @@
+import { ok, fail } from "./envelope.js";
+import { UnknownJourneyError } from "./journey-api.js";
+import { AnchorEditError, PromotedJourneyEditError, addJourneyAnchor, removeJourneyAnchor, suggestJourneyAnchors } from "./journey-anchor-api.js";
+import { emitJson, resolveJourneysDir } from "./cli-shared.js";
+function collect(value, prev) {
+    return [...prev, value];
+}
+/** One human line per anchor-rule problem left after an edit. */
+function renderIssues(result, out) {
+    for (const i of result.issues)
+        out?.(`${i.severity}\t${i.code}\t${i.message}\n\t  fix: ${i.fix}\n`);
+    out?.(`${result.issues.length} anchor issue(s) — journey '${result.journeyId}'\n`);
+}
+/** Maps an edit failure to its envelope: unknown id and refused edits are usage errors (64). */
+export function anchorEditFailure(program, err) {
+    if (err instanceof UnknownJourneyError)
+        emitJson(program, fail("E_UNKNOWN_JOURNEY", err.message));
+    else if (err instanceof AnchorEditError || err instanceof PromotedJourneyEditError)
+        emitJson(program, fail("E_JOURNEY_ANCHOR_ARGS", err.message));
+    else
+        emitJson(program, fail("E_JOURNEY_ANCHOR_ARGS", String(err instanceof Error ? err.message : err)));
+}
+/**
+ * #487 — `jevitate journey anchor add|remove`: edit a draft Journey's anchors without hand-editing
+ * `metadata.anchors`. The step id is written at once; the anchor lint issues that remain are printed.
+ */
+export function registerJourneyAnchorCommands(journey, program, deps) {
+    const anchor = journey.command("anchor").description("add or remove a draft Journey's anchors (#487): named steps to branch missions off, written with the step's stable id");
+    anchor
+        .command("add <journeyId>")
+        .description("add an anchor to a draft Journey: --step takes a 1-based step number or a step id and writes the step id at once; re-lints and prints the anchor issues")
+        .requiredOption("--name <name>", "the anchor's name: 1-64 of lowercase a-z, 0-9, . _ - starting with a letter or digit")
+        .requiredOption("--step <n|stepId>", "the step the anchor follows: a 1-based step number or a step id")
+        .option("--description <text>", "what this state is, in words")
+        .option("--probe <text>", "a suggested adversarial probe at this state (repeatable)", collect, [])
+        .option("--dir <path>", "journeys directory (default: the repo's .jevitate/journeys; outside a repo ~/.jevitate/journeys)")
+        .option("--json", "emit a JSON envelope")
+        .action(async function (journeyId) {
+        const { name, step, description, probe, dir, json } = this.opts();
+        try {
+            const result = await addJourneyAnchor(resolveJourneysDir(deps, dir), journeyId, { name, step, ...(description === undefined ? {} : { description }), probes: probe });
+            if (json)
+                emitJson(program, ok(result));
+            else {
+                const out = program.configureOutput().writeOut;
+                out?.(`added anchor '${name}' to journey '${journeyId}' (step ${step})\n`);
+                renderIssues(result, out);
+                process.exitCode = 0;
+            }
+        }
+        catch (err) {
+            anchorEditFailure(program, err);
+        }
+    });
+    anchor
+        .command("remove <journeyId>")
+        .description("remove an anchor from a draft Journey; re-lints and prints the anchor issues")
+        .requiredOption("--name <name>", "the anchor to remove")
+        .option("--dir <path>", "journeys directory (default: the repo's .jevitate/journeys; outside a repo ~/.jevitate/journeys)")
+        .option("--json", "emit a JSON envelope")
+        .action(async function (journeyId) {
+        const { name, dir, json } = this.opts();
+        try {
+            const result = await removeJourneyAnchor(resolveJourneysDir(deps, dir), journeyId, name);
+            if (json)
+                emitJson(program, ok(result));
+            else {
+                const out = program.configureOutput().writeOut;
+                out?.(`removed anchor '${name}' from journey '${journeyId}'\n`);
+                renderIssues(result, out);
+                process.exitCode = 0;
+            }
+        }
+        catch (err) {
+            anchorEditFailure(program, err);
+        }
+    });
+}
+/**
+ * #487 — `journey anchors <id> --suggest`: advisory anchor proposals (a new page, a form that became
+ * valid, a completed write), each with the `journey anchor add` command that accepts it. Writes nothing.
+ */
+export async function runAnchorSuggest(program, deps, id, opts) {
+    try {
+        const result = await suggestJourneyAnchors(resolveJourneysDir(deps, opts.dir), id);
+        if (opts.json) {
+            emitJson(program, ok(result));
+            return;
+        }
+        const out = program.configureOutput().writeOut;
+        for (const s of result.suggestions) {
+            out?.(`${s.name}\tstep ${s.step}${s.stepId === undefined ? "" : ` (${s.stepId})`}\t${s.kind}\t${s.reason}\n\tprobes: ${s.probes.join("; ")}\n\t${s.command}\n`);
+        }
+        out?.(`${result.suggestions.length} suggestion(s) for journey '${id}' — advisory, nothing was written\n`);
+        process.exitCode = 0;
+    }
+    catch (err) {
+        if (err instanceof UnknownJourneyError)
+            emitJson(program, fail("E_UNKNOWN_JOURNEY", err.message));
+        else
+            emitJson(program, fail("E_JOURNEY_ANCHORS_ARGS", String(err instanceof Error ? err.message : err)));
+    }
+}
+//# sourceMappingURL=journey-anchor-cli.js.map

package/dist/journey-anchor-cli.js.map

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