@jevitate/cli 0.1.0 → 0.2.0

package/dist/github-issue-filer.js

@@ -0,0 +1,188 @@
+import { spawn } from "node:child_process";
+import { BACKOFF_SCHEDULE_MS, isTransientError, jittered, redactText, retryTransient, } from "@jevitate/ai-core";
+export const defaultExec = (cmd, args, stdin) => new Promise((resolve) => {
+    let stdout = "";
+    let stderr = "";
+    const child = spawn(cmd, [...args], { stdio: ["pipe", "pipe", "pipe"] });
+    child.stdout.on("data", (d) => (stdout += d.toString("utf8")));
+    child.stderr.on("data", (d) => (stderr += d.toString("utf8")));
+    child.on("error", (e) => resolve({ code: -1, stdout, stderr: e.message }));
+    child.on("close", (code) => resolve({ code: code ?? -1, stdout, stderr }));
+    child.stdin.end(stdin ?? "");
+});
+export class GitHubFilingError extends Error {
+    code = "E_ISSUE_FILING";
+    /** The HTTP status, for a REST failure (drives the transient-retry decision). */
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = "GitHubFilingError";
+        if (status !== undefined)
+            this.status = status;
+    }
+}
+const ISSUE_NUMBER = /\/issues\/(\d+)/;
+/** The dedup marker every jevitate draft body carries (see `fingerprintMarker`). */
+const FINGERPRINT_MARKER = /<!-- jevitate-fingerprint: [0-9a-f]+ -->/;
+function parseIssueUrl(url) {
+    const m = ISSUE_NUMBER.exec(url);
+    if (m?.[1] === undefined)
+        throw new GitHubFilingError(`unexpected issue URL: ${url}`);
+    return { number: Number(m[1]), url };
+}
+/** The bare fingerprint inside a `<!-- jevitate-fingerprint: … -->` marker (the searchable token). */
+function markerToken(marker) {
+    return marker.replace(/^<!--\s*jevitate-fingerprint:\s*/, "").replace(/\s*-->$/, "");
+}
+function isRecord(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+export class GitHubIssueFiler {
+    #exec;
+    #fetch;
+    #store;
+    #apiBase;
+    #retry;
+    #mode;
+    constructor(deps) {
+        this.#exec = deps.exec ?? defaultExec;
+        this.#fetch = deps.fetch;
+        this.#store = deps.store;
+        this.#apiBase = deps.apiBase ?? "https://api.github.com";
+        this.#retry = deps.retry ?? {};
+    }
+    /** `gh` when it is installed and runnable, else REST (which needs `GITHUB_TOKEN`). */
+    mode() {
+        this.#mode ??= this.#exec("gh", ["--version"]).then((r) => (r.code === 0 ? "gh" : "rest"));
+        return this.#mode;
+    }
+    #scrub(text) {
+        const token = this.#store.read("GITHUB_TOKEN");
+        return token === undefined ? text : redactText(text, [token]);
+    }
+    async #gh(args, stdin) {
+        const r = await this.#exec("gh", args, stdin);
+        if (r.code !== 0) {
+            // gh reports API failures as "HTTP 502: Bad Gateway (…)": keep the status so the transient
+            // classification is the same as for the REST transport.
+            const status = /\bHTTP (\d{3})\b/.exec(r.stderr)?.[1];
+            throw new GitHubFilingError(this.#scrub(`gh ${args[0] ?? ""} ${args[1] ?? ""} failed: ${r.stderr.trim()}`), status === undefined ? undefined : Number(status));
+        }
+        return r.stdout;
+    }
+    /**
+     * An IDEMPOTENT REST call (a read), retried with backoff on transient failures (429/5xx/network);
+     * typed failure after. Writes never go through here — see `create` / `comment`.
+     */
+    async #rest(method, path) {
+        const r = await retryTransient(() => this.#restOnce(method, path), this.#retry);
+        if (r.ok)
+            return r.value;
+        const e = r.error;
+        throw e instanceof GitHubFilingError
+            ? e
+            : new GitHubFilingError(this.#scrub(`GitHub API ${method} ${path} failed: ${e instanceof Error ? e.message : String(e)}`));
+    }
+    async #restOnce(method, path, body) {
+        const token = this.#store.read("GITHUB_TOKEN");
+        if (token === undefined) {
+            throw new GitHubFilingError("filing needs the gh CLI or a GITHUB_TOKEN in jevitate's credential store");
+        }
+        const doFetch = this.#fetch ?? globalThis.fetch;
+        const res = await doFetch(`${this.#apiBase}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: "application/vnd.github+json",
+                "X-GitHub-Api-Version": "2022-11-28",
+                "User-Agent": "jevitate",
+                ...(body === undefined ? {} : { "Content-Type": "application/json" }),
+            },
+            ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+        });
+        const text = await res.text();
+        if (res.status < 200 || res.status >= 300) {
+            throw new GitHubFilingError(this.#scrub(`GitHub API ${res.status} on ${method} ${path}: ${text.slice(0, 300)}`), res.status);
+        }
+        return text === "" ? null : JSON.parse(text);
+    }
+    async findOpenByMarker(repo, marker) {
+        const token = markerToken(marker);
+        if ((await this.mode()) === "gh") {
+            const out = await this.#gh([
+                "issue", "list", "--repo", repo, "--state", "open", "--search", `${token} in:body`,
+                "--json", "number,url,body", "--limit", "20",
+            ]);
+            const list = JSON.parse(out === "" ? "[]" : out);
+            if (!Array.isArray(list))
+                return null;
+            for (const item of list) {
+                if (isRecord(item) && typeof item.body === "string" && item.body.includes(marker) && typeof item.number === "number" && typeof item.url === "string") {
+                    return { number: item.number, url: item.url };
+                }
+            }
+            return null;
+        }
+        const q = encodeURIComponent(`repo:${repo} is:issue is:open in:body ${token}`);
+        const res = await this.#rest("GET", `/search/issues?q=${q}&per_page=20`);
+        const items = isRecord(res) && Array.isArray(res.items) ? res.items : [];
+        for (const item of items) {
+            if (isRecord(item) && typeof item.body === "string" && item.body.includes(marker) && typeof item.number === "number" && typeof item.html_url === "string") {
+                return { number: item.number, url: item.html_url };
+            }
+        }
+        return null;
+    }
+    /** One create attempt, on whichever transport is in use. */
+    async #createOnce(repo, issue) {
+        if ((await this.mode()) === "gh") {
+            const out = await this.#gh(["issue", "create", "--repo", repo, "--title", issue.title, "--body-file", "-"], issue.body);
+            return parseIssueUrl(out.trim());
+        }
+        const res = await this.#restOnce("POST", `/repos/${repo}/issues`, { title: issue.title, body: issue.body });
+        if (!isRecord(res) || typeof res.number !== "number" || typeof res.html_url !== "string") {
+            throw new GitHubFilingError("GitHub API returned no issue");
+        }
+        return { number: res.number, url: res.html_url };
+    }
+    /**
+     * Creating an issue is NOT idempotent, so it is never blindly retried: a "failed" create (a 502,
+     * a dropped connection) may well have persisted. After a transient failure the fingerprint
+     * search runs again — if the issue now exists it IS the one this call created and is returned;
+     * only if it is still absent is the create tried again, on the backoff schedule. A body without a
+     * fingerprint marker cannot be checked, so it gets exactly one attempt. Same for both transports.
+     */
+    async create(repo, issue) {
+        const marker = FINGERPRINT_MARKER.exec(issue.body)?.[0];
+        const schedule = this.#retry.schedule ?? BACKOFF_SCHEDULE_MS;
+        const sleep = this.#retry.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+        const random = this.#retry.random ?? Math.random;
+        for (let attempt = 0;; attempt++) {
+            try {
+                return await this.#createOnce(repo, issue);
+            }
+            catch (e) {
+                const delay = schedule[attempt];
+                if (marker === undefined || delay === undefined || !isTransientError(e))
+                    throw e;
+                const landed = await this.findOpenByMarker(repo, marker);
+                if (landed !== null)
+                    return landed;
+                await sleep(jittered(delay, random));
+            }
+        }
+    }
+    /**
+     * An occurrence comment is not idempotent either: it gets exactly one attempt (a duplicate
+     * comment is worse than a missing one — the draft on disk keeps the occurrence either way).
+     */
+    async comment(repo, number, body) {
+        if ((await this.mode()) === "gh") {
+            const out = await this.#gh(["issue", "comment", String(number), "--repo", repo, "--body-file", "-"], body);
+            return { number, url: out.trim() };
+        }
+        const res = await this.#restOnce("POST", `/repos/${repo}/issues/${number}/comments`, { body });
+        return { number, url: isRecord(res) && typeof res.html_url === "string" ? res.html_url : "" };
+    }
+}
+//# sourceMappingURL=github-issue-filer.js.map

package/dist/github-issue-filer.js.map

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

package/dist/host-health-run.d.ts

@@ -0,0 +1,24 @@
+import { HostHealthSampler, degradedEnvironmentOutcome } from "@jevitate/explore";
+import type { EnvironmentDegraded, HostHealthSummary, MissionFailure } from "@jevitate/domain";
+/**
+ * One host-health sampler per mission run (#203), shared by every strategy's runner: started (with
+ * one sample taken) BEFORE the browser opens, fed every transcript entry, handed to the mission so a
+ * hang/no-progress met on a starved host is marked `environment-degraded`, and summarised into the
+ * result's `hostHealth`. `injected` is the test seam (a deterministic fake host).
+ */
+export declare function startHostHealth(injected?: HostHealthSampler): Promise<HostHealthSampler>;
+/** What every result carries from the sampler, and the degraded-environment verdict rule applied. */
+export interface HostHealthVerdict<O extends string> {
+    readonly outcome: O | "inconclusive";
+    /** Set when the rule turned the outcome `inconclusive` (reason `degraded-environment`). */
+    readonly failure?: MissionFailure;
+    readonly fields: {
+        readonly hostHealth: HostHealthSummary;
+        readonly environmentDegraded: EnvironmentDegraded[];
+    };
+}
+/**
+ * Takes the closing sample and applies the run-level rule: most steps starved → `inconclusive`
+ * (`degraded-environment`), never `clean` (see `degradedEnvironmentOutcome`).
+ */
+export declare function finishHostHealth<O extends string>(health: HostHealthSampler, outcome: O, opts?: Parameters<typeof degradedEnvironmentOutcome>[2]): Promise<HostHealthVerdict<O>>;

package/dist/host-health-run.js

@@ -0,0 +1,27 @@
+import { HostHealthSampler, degradedEnvironmentOutcome } from "@jevitate/explore";
+/**
+ * One host-health sampler per mission run (#203), shared by every strategy's runner: started (with
+ * one sample taken) BEFORE the browser opens, fed every transcript entry, handed to the mission so a
+ * hang/no-progress met on a starved host is marked `environment-degraded`, and summarised into the
+ * result's `hostHealth`. `injected` is the test seam (a deterministic fake host).
+ */
+export async function startHostHealth(injected) {
+    const health = (injected ?? new HostHealthSampler()).start();
+    await health.sample();
+    return health;
+}
+/**
+ * Takes the closing sample and applies the run-level rule: most steps starved → `inconclusive`
+ * (`degraded-environment`), never `clean` (see `degradedEnvironmentOutcome`).
+ */
+export async function finishHostHealth(health, outcome, opts = {}) {
+    await health.sample();
+    const hostHealth = health.summary();
+    const verdict = degradedEnvironmentOutcome(outcome, hostHealth, opts);
+    return {
+        outcome: verdict.outcome,
+        ...(verdict.failure === undefined ? {} : { failure: verdict.failure }),
+        fields: { hostHealth, environmentDegraded: health.findings() },
+    };
+}
+//# sourceMappingURL=host-health-run.js.map

package/dist/host-health-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-health-run.js","sourceRoot":"","sources":["../src/host-health-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAGlF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAA4B;IAChE,MAAM,MAAM,GAAG,CAAC,QAAQ,IAAI,IAAI,iBAAiB,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7D,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAyB,EACzB,OAAU,EACV,OAAyD,EAAE;IAE3D,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,0BAA0B,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACtE,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACtE,MAAM,EAAE,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE;KAC/D,CAAC;AACJ,CAAC"}

package/dist/http-5xx-outcome.d.ts

@@ -0,0 +1,6 @@
+import type { GoalBasedOutcome, Http5xxDefect } from "@jevitate/explore";
+export declare function applyHttp5xxGoalOutcome(outcome: GoalBasedOutcome, defects: readonly Http5xxDefect[]): GoalBasedOutcome;
+/** `PUT /api/profile → 500` for each defect (first three), for a one-line `reason`. */
+export declare function describeHttp5xx(defects: readonly Http5xxDefect[]): string;
+/** The `reason` of a goal run that `applyHttp5xxGoalOutcome` turned into `defects-found`. */
+export declare function http5xxGoalReason(defects: readonly Http5xxDefect[], assertionPassed: boolean): string;

package/dist/http-5xx-outcome.js

@@ -0,0 +1,39 @@
+/**
+ * How an HTTP 5xx hard-signal defect (#208, `Http5xxOracle`) folds into a run's outcome — the same
+ * rule a `server-log` defect follows (#142):
+ *
+ *  - coverage/exploratory and feature runs count it with their own defects (a found defect wins
+ *    over a thin run's `inconclusive`, exactly like a declared-invariant defect);
+ *  - a goal run's own `GoalBasedOutcome`: `defects-found` over `succeeded` / `exhausted` /
+ *    `blocked`. A goal whose checks held but whose run hit a server error is NOT a success: the
+ *    checks' verdict stays on the result (`assertionPassed`, `checks`), and `reason` says both.
+ *    A broken run (`inconclusive` / `crashed`) and a hang keep their outcome; the defect is still
+ *    listed in `defects`, and `reason` names it.
+ */
+const BROKEN_GOAL_OUTCOMES = new Set(["inconclusive", "crashed", "hang", "intermittent"]);
+export function applyHttp5xxGoalOutcome(outcome, defects) {
+    return defects.length > 0 && !BROKEN_GOAL_OUTCOMES.has(outcome) ? "defects-found" : outcome;
+}
+/** `PUT /api/profile → 500` for each defect (first three), for a one-line `reason`. */
+export function describeHttp5xx(defects) {
+    const shown = defects.slice(0, 3).map((d) => {
+        const s = d.signals[0];
+        let path = s?.url ?? d.route;
+        try {
+            path = new URL(path).pathname;
+        }
+        catch {
+            /* keep the raw (redacted) url */
+        }
+        return `${d.method} ${path} → ${s?.status ?? "5xx"}`;
+    });
+    const more = defects.length > 3 ? ` (+${defects.length - 3} more)` : "";
+    return `${shown.join(", ")}${more}`;
+}
+/** The `reason` of a goal run that `applyHttp5xxGoalOutcome` turned into `defects-found`. */
+export function http5xxGoalReason(defects, assertionPassed) {
+    const n = defects.length;
+    const found = `${n} HTTP 5xx defect${n === 1 ? "" : "s"} found: ${describeHttp5xx(defects)}`;
+    return assertionPassed ? `${found} — the goal's success checks held, but the app answered with a server error` : found;
+}
+//# sourceMappingURL=http-5xx-outcome.js.map

package/dist/http-5xx-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-5xx-outcome.js","sourceRoot":"","sources":["../src/http-5xx-outcome.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,oBAAoB,GAAkC,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;AAEzH,MAAM,UAAU,uBAAuB,CAAC,OAAyB,EAAE,OAAiC;IAClG,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9F,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,OAAiC;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;QACD,OAAO,GAAG,CAAC,CAAC,MAAM,IAAI,IAAI,MAAM,CAAC,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,iBAAiB,CAAC,OAAiC,EAAE,eAAwB;IAC3F,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACzB,MAAM,KAAK,GAAG,GAAG,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7F,OAAO,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,6EAA6E,CAAC,CAAC,CAAC,KAAK,CAAC;AACzH,CAAC"}

package/dist/inbox-cli.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+import { type CliDeps } from "./cli-shared.js";
+export declare function formatInboxListHuman(data: unknown): string;
+export declare function formatInboxThreadHuman(id: string): (data: unknown) => string;
+export declare function formatInboxCommandHuman(data: unknown): string;
+export declare function formatInboxHealthHuman(data: unknown): string;
+export declare function registerInboxCommands(program: Command, deps: CliDeps): void;

package/dist/inbox-cli.js

@@ -0,0 +1,197 @@
+import { readFileSync } from "node:fs";
+import { Option } from "commander";
+import { ok, fail } from "./envelope.js";
+import { emitEnvelope } from "./cli-output.js";
+import { emitJsonOrRefusal } from "./cli-refusal.js";
+import { commandPath } from "./cli-refusal.js";
+import { FsInboxStore } from "@jevitate/inbox";
+import { resolveInboxDir } from "./cli-shared.js";
+import { currentEngineInfo } from "./engine.js";
+import { callMcpTool, mcpErrorOf, mcpToolDeps, refusalFor } from "./mcp-cli-bridge.js";
+/**
+ * `jevitate inbox …` (#254): the HITL inbox from the CLI — one command per MCP inbox tool, each calling
+ * the SAME served handler (mcp-cli-bridge.ts) over the SAME store `jevitate mcp` and `jevitate ui`
+ * use (`~/.jevitate/inbox`, or `--inbox-dir`):
+ *
+ *   list            → list_incoming     show <id>        → get_thread
+ *   command <id>    → get_command       health           → get_site_health
+ *   queue-retrieval → queue_retrieval   queue-action     → queue_action
+ *   approve <id>    → approve_action    cancel <id>      → cancel_command (both always refused)
+ *
+ * SM1: approving or cancelling is human-only, in the `jevitate ui` dashboard — `inbox approve` /
+ * `inbox cancel` refuse exactly as MCP does (E_HUMAN_APPROVAL_REQUIRED, exit 64).
+ * `inbox command` keeps get_command's burn-after-read. A human's unread input is consumed only with
+ * `--reveal`, which prints it exactly as MCP returns it; without it the command refuses
+ * (E_INBOX_INPUT_PENDING) and consumes nothing, so the input is never burned unseen.
+ */
+const INBOX_DIR_HELP = "inbox store directory (default: ~/.jevitate/inbox — the dir `jevitate mcp` and `jevitate ui` use)";
+const REDACTED = "***REDACTED***";
+function withInboxFlags(cmd) {
+    return cmd.option("--inbox-dir <path>", INBOX_DIR_HELP).option("--json", "emit a JSON envelope");
+}
+function isRecord(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function ageText(sec) {
+    const s = typeof sec === "number" && Number.isFinite(sec) ? sec : 0;
+    if (s < 90)
+        return `${s}s`;
+    if (s < 5400)
+        return `${Math.round(s / 60)}m`;
+    return `${Math.round(s / 3600)}h`;
+}
+export function formatInboxListHuman(data) {
+    const items = isRecord(data) && Array.isArray(data.items) ? data.items.filter(isRecord) : [];
+    if (items.length === 0)
+        return "no pending inbox items\n";
+    const lines = items.map((i) => `${String(i.id)}  ${String(i.kind)}  ${String(i.status)}  ${ageText(i.ageSec)}  ${String(i.run)} / ${String(i.journey)} / ${String(i.step)}  (${String(i.agent)})`);
+    return `${lines.join("\n")}\nnext: jevitate inbox show <id> · approve or cancel in \`jevitate ui\`\n`;
+}
+export function formatInboxThreadHuman(id) {
+    return (data) => {
+        const thread = isRecord(data) && Array.isArray(data.thread) ? data.thread.filter(isRecord) : [];
+        if (thread.length === 0)
+            return `${id}: no messages yet\n`;
+        return `${thread.map((e) => `${String(e.at)}  ${String(e.author)}: ${String(e.text)}`).join("\n")}\n`;
+    };
+}
+export function formatInboxCommandHuman(data) {
+    if (!isRecord(data))
+        return "";
+    const lines = [`${String(data.id)}  ${String(data.kind)}  ${String(data.status)}`, `  ${String(data.run)} / ${String(data.journey)} / ${String(data.step)}: ${String(data.reason)}`];
+    if (isRecord(data.resolution))
+        lines.push(`  resolution: ${String(data.resolution.decision)} by ${String(data.resolution.by)} at ${String(data.resolution.at)}`);
+    if (data.humanInput === REDACTED)
+        lines.push("  human input: provided concurrently — consumed by this poll without --reveal; its value is not printed");
+    else if (data.humanInput !== undefined)
+        lines.push(`  human input (consumed now, burn-after-read): ${String(data.humanInput)}`);
+    else if (data.secretConsumedAt !== undefined)
+        lines.push(`  human input: already consumed at ${String(data.secretConsumedAt)}`);
+    return `${lines.join("\n")}\n`;
+}
+export function formatInboxHealthHuman(data) {
+    if (!isRecord(data))
+        return "";
+    const build = [data.version, data.commit].filter((v) => typeof v === "string").join(" ");
+    return `inbox ${data.ok === true ? "ok" : "NOT ok"}: ${String(data.pending)} pending, oldest ${ageText(data.oldestPendingAgeSec)} · build ${build}\n`;
+}
+function formatQueuedHuman(data) {
+    if (!isRecord(data))
+        return "";
+    return `queued inbox item ${String(data.id)} (${String(data.status)})\nnext: a human answers it in \`jevitate ui\`; poll with \`jevitate inbox command ${String(data.id)}\`\n`;
+}
+/** get_command's item with the input's VALUE replaced — only for a poll without --reveal that raced a human's answer. */
+function withoutSecretValue(body) {
+    if (!isRecord(body) || body.humanInput === undefined)
+        return body;
+    return { ...body, humanInput: REDACTED };
+}
+export function registerInboxCommands(program, deps) {
+    const inbox = program.command("inbox").description("the HITL inbox from the CLI — the same tools `jevitate mcp` serves (approve/cancel stay human-only in `jevitate ui`)");
+    /** Calls MCP `tool` and prints its result (or its typed error as the matching CLI refusal). */
+    const run = async (cmd, tool, args, human, fallback, project = (b) => b) => {
+        const o = cmd.opts();
+        const json = o.json === true;
+        let envelope;
+        try {
+            const { body } = await callMcpTool(mcpToolDeps(deps, { inboxDir: resolveInboxDir(deps, o.inboxDir) }), tool, args);
+            const err = mcpErrorOf(body);
+            envelope = err === undefined ? ok(project(body)) : refusalFor(cmd, "INBOX", err, fallback);
+        }
+        catch (e) {
+            envelope = fail("E_INBOX_INTERNAL", e instanceof Error ? e.message : String(e));
+        }
+        if (envelope.ok)
+            emitEnvelope(program, envelope, { json, human, command: commandPath(cmd) });
+        else
+            emitJsonOrRefusal(program, envelope);
+    };
+    withInboxFlags(inbox.command("list").description("list pending inbox items (MCP list_incoming)")).action(async function () {
+        await run(this, "list_incoming", {}, formatInboxListHuman, "cannot list the inbox");
+    });
+    withInboxFlags(inbox.command("show <id>").description("an inbox item's conversation thread — never its secret input (MCP get_thread)")).action(async function (id) {
+        await run(this, "get_thread", { id }, formatInboxThreadHuman(id), `no inbox item '${id}'`);
+    });
+    withInboxFlags(inbox
+        .command("command <id>")
+        .description("poll one inbox item as the agent does (MCP get_command): burn-after-read — unread human input needs --reveal, which consumes and prints it")).option("--reveal", "consume the human's unread input and print it, exactly as MCP get_command returns it")
+        .action(async function (id) {
+        const o = this.opts();
+        if (o.reveal !== true) {
+            // Peek without consuming: a poll that would burn unread input needs --reveal. (A bad id falls
+            // through to get_command, which refuses it exactly as MCP does.)
+            const store = new FsInboxStore(resolveInboxDir(deps, o.inboxDir), currentEngineInfo());
+            const item = await store.get(id).catch(() => null);
+            if (item?.humanInput !== undefined && item.secretConsumedAt === undefined) {
+                emitJsonOrRefusal(program, fail("E_INBOX_INPUT_PENDING", `inbox item '${id}' has unread human input; reading it consumes it (burn-after-read). Rerun with --reveal to receive it`));
+                return;
+            }
+        }
+        await run(this, "get_command", { id }, formatInboxCommandHuman, `no inbox item '${id}'`, o.reveal === true ? (b) => b : withoutSecretValue);
+    });
+    withInboxFlags(inbox.command("health").description("inbox store health: pending count, oldest pending age, build (MCP get_site_health)")).action(async function () {
+        await run(this, "get_site_health", {}, formatInboxHealthHuman, "cannot read inbox health");
+    });
+    const queueFlags = (cmd) => withInboxFlags(cmd
+        .option("--run <id>", "the run this item belongs to (required)")
+        .option("--journey <id>", "the Journey (required)")
+        .option("--step <step>", "the step it stopped at (required)")
+        .option("--reason <text>", "what the human is asked for (required)")
+        .option("--agent <name>", "who is asking (required)")
+        .option("--target-url <url>", "the page it concerns")
+        .option("--has-screenshot", "a screenshot accompanies the item")
+        .option("--findings <file>", "a JSON file holding an array of {id, title, severity: low|med|high, evidence?}"));
+    const queueArgs = (cmd) => {
+        const o = cmd.opts();
+        let findings;
+        if (o.findings !== undefined) {
+            try {
+                findings = JSON.parse(readFileSync(o.findings, "utf8"));
+            }
+            catch (e) {
+                const code = `E_${commandPath(cmd).toUpperCase().replace(/[^A-Z0-9]+/g, "_")}_INPUT`;
+                emitJsonOrRefusal(program, fail(code, `cannot read --findings ${o.findings}: ${e instanceof Error ? e.message.split("\n")[0] : String(e)}`));
+                return undefined;
+            }
+        }
+        // Only what was given: the facade validates (required fields, finding shape) — never re-decided here.
+        return {
+            ...(o.run === undefined ? {} : { run: o.run }),
+            ...(o.journey === undefined ? {} : { journey: o.journey }),
+            ...(o.step === undefined ? {} : { step: o.step }),
+            ...(o.reason === undefined ? {} : { reason: o.reason }),
+            ...(o.agent === undefined ? {} : { agent: o.agent }),
+            ...(o.targetUrl === undefined ? {} : { targetUrl: o.targetUrl }),
+            ...(o.hasScreenshot === true ? { hasScreenshot: true } : {}),
+            ...(findings === undefined ? {} : { findings }),
+            ...(o.kind === undefined ? {} : { kind: o.kind }),
+        };
+    };
+    queueFlags(inbox.command("queue-retrieval").description("ask a human to provide something back to the agent — a 'handback' item; only queues (MCP queue_retrieval)")).action(async function () {
+        const args = queueArgs(this);
+        if (args !== undefined)
+            await run(this, "queue_retrieval", args, formatQueuedHuman, "cannot queue the item");
+    });
+    queueFlags(inbox
+        .command("queue-action")
+        .description("ask a human for a decision — an 'approval' item by default; only queues (MCP queue_action)")
+        .addOption(new Option("--kind <kind>", "approval (default) | handback | review").choices(["approval", "handback", "review"]))).action(async function () {
+        const args = queueArgs(this);
+        if (args !== undefined)
+            await run(this, "queue_action", args, formatQueuedHuman, "cannot queue the item");
+    });
+    // SM1: human-only. Registered so the CLI names the refusal (and where to go instead) rather than
+    // pretending the capability does not exist — they call the same always-refusing MCP handlers.
+    for (const [name, tool, verb] of [
+        ["approve", "approve_action", "approve"],
+        ["cancel", "cancel_command", "cancel"],
+    ]) {
+        withInboxFlags(inbox.command(`${name} <id>`).description(`always refused (MCP ${tool}): only a human can ${verb} an inbox item, in \`jevitate ui\``)).action(async function (id) {
+            const { body } = await callMcpTool(mcpToolDeps(deps), tool, { id });
+            const err = mcpErrorOf(body) ?? { error: "human_approval_required" };
+            const refusal = refusalFor(this, "INBOX", { error: err.error, message: `${err.message ?? `${verb} is human-only`} — run \`jevitate ui\`` }, "");
+            emitJsonOrRefusal(program, refusal);
+        });
+    }
+}
+//# sourceMappingURL=inbox-cli.js.map

package/dist/inbox-cli.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./envelope.js";
 export * from "./program.js";
+export * from "./result-schema.js";

package/dist/index.js

@@ -1,3 +1,4 @@
 export * from "./envelope.js";
 export * from "./program.js";
+export * from "./result-schema.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/init-cli.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+import { type CliDeps } from "./cli-shared.js";
+/** Registers `jevitate init` (API keys, skills/MCP wiring, the repo's .jevitate/). */
+export declare function registerInitCommands(program: Command, deps: CliDeps): void;