@jevitate/cli 0.17.0 → 0.18.0

package/dist/journey-readiness.js

@@ -0,0 +1,369 @@
+import { relative, sep } from "node:path";
+import { checkCompatibility, journeyParamSchema, lintJourney, } from "@jevitate/journey";
+import { currentBuildTree, currentEngineInfo } from "./engine.js";
+import { environmentFromFlags } from "./environments.js";
+import { runJourneyChain, chainSucceeded } from "./journey-chain.js";
+import { journeyContentHash } from "./journey-annotate-api.js";
+import { reviewJourneyById } from "./journey-review-api.js";
+import { verifyRecordPath } from "./journey-review-store.js";
+import { verifyJourneyMutations } from "./journey-verify.js";
+import { runJourneyProgrammatically } from "./journey-api.js";
+export class ReadinessError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ReadinessError";
+        this.code = code;
+    }
+}
+const REQUIRED_PROOF_CHECK = "proof";
+/** #581 §1: the target shared by `replay` and `prove`, refused in this order before any runner call. */
+function resolveTarget(opts, deps, required) {
+    let environment;
+    if (opts.env !== undefined || opts.baseUrl !== undefined) {
+        environment = environmentFromFlags({ ...(opts.env === undefined ? {} : { env: opts.env }), ...(opts.baseUrl === undefined ? {} : { baseUrl: opts.baseUrl }) }, { ...(deps.environmentsFile === undefined ? {} : { environmentsFile: deps.environmentsFile }), ...(opts.targetsFile === undefined ? {} : { targetsFile: opts.targetsFile }) });
+    }
+    if (environment === undefined) {
+        throw new ReadinessError("E_READINESS_TARGET", "replay and prove need a target: pass --env <name> or --base-url <origin>");
+    }
+    if (environment.production === true) {
+        throw new ReadinessError("E_READINESS_PRODUCTION", `environment '${environment.name ?? environment.baseUrl}' is flagged production: readiness never replays or proves against it`);
+    }
+    const missing = required.filter((name) => !(name in (opts.params ?? {})));
+    if (missing.length > 0) {
+        throw new ReadinessError("E_READINESS_PARAMS", `missing required param(s): ${missing.join(", ")}`);
+    }
+    return environment;
+}
+/** The required params of the Journey the run/`--param` flags drive (a pair's consumer is bound by the chain). */
+function requiredParams(journey, pair, hasRequests) {
+    const names = journeyParamSchema(journey).required;
+    return pair && !hasRequests ? [...names, "requests"] : names;
+}
+function lintFindings(journey, projectDir) {
+    // `lintJourney` runs the upload-fixture rules itself when it is given a project root (#488).
+    return lintJourney(journey, projectDir === undefined ? {} : { baseDir: projectDir });
+}
+function lintCheck(ctx, projectDir) {
+    const findings = lintFindings(ctx.journey, projectDir);
+    const errors = findings.filter((f) => f.level === "error").length;
+    const warnings = findings.filter((f) => f.level === "warning").length;
+    if (errors > 0) {
+        return {
+            check: { check: "lint", journey: ctx.id, state: "fail", detail: `${errors} error(s)${warnings === 0 ? "" : `, ${warnings} warning(s)`}` },
+            blocker: { check: "lint", journey: ctx.id, why: `${errors} lint error(s)`, next: `jevitate journey lint ${ctx.id}` },
+        };
+    }
+    return { check: { check: "lint", journey: ctx.id, state: "pass", detail: warnings === 0 ? "no findings" : `${warnings} warning(s)` } };
+}
+function schemaCheck(ctx) {
+    return { check: "schema", journey: ctx.id, state: "pass", detail: "the Journey loads" };
+}
+/** #582: the producing/consuming contract of a pair; absent contracts are nothing to check. */
+function handoffCheck(producer, consumer) {
+    const declared = producer.journey.metadata.outputs !== undefined || consumer.journey.metadata.inputs !== undefined;
+    if (!declared) {
+        return { check: { check: "handoff", journey: producer.id, state: "not-run", detail: "neither Journey declares a handoff contract" } };
+    }
+    const issues = checkCompatibility(producer.journey, consumer.journey);
+    if (issues.length > 0) {
+        return {
+            check: { check: "handoff", journey: producer.id, state: "fail", detail: issues.map((i) => i.message).join("; ") },
+            blocker: { check: "handoff", journey: producer.id, why: issues.map((i) => i.message).join("; "), next: `jevitate journey chain --from ${producer.id} --to ${consumer.id} --requests <file>` },
+        };
+    }
+    return { check: { check: "handoff", journey: producer.id, state: "pass", detail: "contracts are compatible" } };
+}
+/** #583: a declared prepare-only boundary is what stops a Journey before the irreversible action. */
+function boundaryCheck(ctx) {
+    return ctx.journey.metadata.boundary === undefined
+        ? { check: "boundary", journey: ctx.id, state: "not-run", detail: "no prepare-only boundary declared" }
+        : { check: "boundary", journey: ctx.id, state: "pass", detail: "a prepare-only boundary is declared" };
+}
+/** `journey review --strict`: every `warn` attention item is a blocker (an `info` item is advice, not a gate). */
+function reviewStrictCheck(ctx) {
+    const warns = (ctx.review.attention ?? []).filter((a) => a.severity === "warn");
+    if (warns.length > 0) {
+        return {
+            check: { check: "review-strict", journey: ctx.id, state: "fail", detail: warns.map((a) => a.text).join("; ") },
+            blocker: { check: "review-strict", journey: ctx.id, why: warns.map((a) => a.text).join("; "), next: `jevitate journey review ${ctx.id} --strict` },
+        };
+    }
+    return { check: { check: "review-strict", journey: ctx.id, state: "pass", detail: "no strict attention items" } };
+}
+/** Every step objective written; a missing one is a person's annotation to draft. */
+function annotationsCheck(ctx) {
+    const missing = ctx.review.summary.missingIntent;
+    if (missing.length === 0)
+        return { check: { check: "annotations", journey: ctx.id, state: "pass", detail: "every step has an objective" }, awaiting: [] };
+    return {
+        check: { check: "annotations", journey: ctx.id, state: "awaiting-human", detail: `${missing.length} intent gap(s)` },
+        awaiting: missing.map((item) => ({ check: "annotations", journey: ctx.id, item, next: `jevitate journey annotate ${ctx.id}` })),
+    };
+}
+/** #433: the job/persona links resolve; a draft/stale approval is a person's call. */
+function catalogCheck(ctx) {
+    const links = ctx.review.catalog;
+    if (links === undefined)
+        return { check: { check: "catalog", journey: ctx.id, state: "not-run", detail: "the catalog was not loaded" }, awaiting: [] };
+    const dangling = [];
+    for (const [kind, link] of [["job", links.job], ["persona", links.persona]]) {
+        if (link !== undefined && link.status === "unknown")
+            dangling.push(`${kind}:${link.id}`);
+    }
+    if (dangling.length > 0) {
+        return {
+            check: { check: "catalog", journey: ctx.id, state: "fail", detail: `dangling link(s): ${dangling.join(", ")}` },
+            blocker: { check: "catalog", journey: ctx.id, why: `dangling link(s): ${dangling.join(", ")}`, next: `jevitate journey link ${ctx.id} --job <job-id> --persona <persona-id>` },
+            awaiting: [],
+        };
+    }
+    if (!links.linked) {
+        return {
+            check: { check: "catalog", journey: ctx.id, state: "fail", detail: "no job/persona link declared" },
+            blocker: { check: "catalog", journey: ctx.id, why: "no job/persona link declared", next: `jevitate journey link ${ctx.id} --job <job-id> --persona <persona-id>` },
+            awaiting: [],
+        };
+    }
+    if (links.unvetted.length > 0) {
+        return {
+            check: { check: "catalog", journey: ctx.id, state: "awaiting-human", detail: links.unvetted.join(", ") },
+            awaiting: links.unvetted.map((item) => ({
+                check: "catalog",
+                journey: ctx.id,
+                item,
+                next: item.startsWith("job:") ? `jevitate job review ${item.slice("job:".length)}` : `jevitate persona review ${item.slice("persona:".length)}`,
+            })),
+        };
+    }
+    return { check: { check: "catalog", journey: ctx.id, state: "pass", detail: "links resolve and are approved" }, awaiting: [] };
+}
+/** The `.verify/<id>.json` proof record, and the freshness rule shared with the review sheet. */
+function proofCheck(ctx, journeysDir, cwd) {
+    const verify = ctx.review.proof.verify;
+    const evidence = relativeEvidence(cwd, verifyRecordPath(journeysDir, ctx.id));
+    if (verify.status === "not-verified") {
+        return {
+            check: { check: "proof", journey: ctx.id, state: "not-run", detail: verify.hint },
+            blocker: { check: "proof", journey: ctx.id, why: "no mutation proof recorded", next: `jevitate journey verify ${ctx.id} --mutate` },
+        };
+    }
+    if (verify.stale) {
+        return {
+            check: { check: "proof", journey: ctx.id, state: "stale", detail: `the ${verify.verdict} proof at ${verify.at} is bound to older content`, evidence },
+            blocker: { check: "proof", journey: ctx.id, why: "the recorded proof is stale", next: `jevitate journey verify ${ctx.id} --mutate` },
+        };
+    }
+    if (verify.verdict === "proven") {
+        const passed = Object.values(verify.summary).reduce((a, b) => a + b, 0);
+        return { check: { check: "proof", journey: ctx.id, state: "pass", detail: `proven ${passed}/${passed}`, evidence } };
+    }
+    if (verify.verdict === "insensitive") {
+        return {
+            check: { check: "proof", journey: ctx.id, state: "fail", detail: verify.reason ?? "some checks cannot fail", evidence },
+            blocker: { check: "proof", journey: ctx.id, why: verify.reason ?? "some checks cannot fail", next: `jevitate journey verify ${ctx.id} --mutate` },
+        };
+    }
+    return { check: { check: "proof", journey: ctx.id, state: "inconclusive", detail: verify.reason ?? `proof verdict ${verify.verdict}`, evidence } };
+}
+function relativeEvidence(cwd, path) {
+    const r = relative(cwd, path);
+    return r === "" || r.startsWith("..") ? path : r.split(sep).join("/");
+}
+/** `review` promoted with an approval that still binds the current review hash. */
+function promotionCheck(ctx) {
+    const change = ctx.review.changeSinceApproval;
+    const stale = (change.kind === "diff" || change.kind === "snapshot-missing") && change.changed;
+    const current = ctx.journey.metadata.promoted && ctx.journey.metadata.approval !== undefined && !stale;
+    if (current)
+        return { check: { check: "promotion", journey: ctx.id, state: "pass", detail: "promoted with a current approval" }, awaiting: [] };
+    const why = !ctx.journey.metadata.promoted ? "not promoted" : stale ? "approval is stale (the Journey changed since it was approved)" : "no recorded approval";
+    return {
+        check: { check: "promotion", journey: ctx.id, state: "awaiting-human", detail: why },
+        awaiting: [{ check: "promotion", journey: ctx.id, item: why, next: `jevitate journey promote ${ctx.id}` }],
+    };
+}
+function replayCheck(ctx, outcome) {
+    const next = `jevitate journey run ${ctx.id}`;
+    const check = { check: "replay", journey: ctx.id, state: outcome.state, detail: outcome.detail };
+    return outcome.state === "pass" ? { check } : { check, blocker: { check: "replay", journey: ctx.id, why: outcome.detail, next } };
+}
+/** The #583 handback state, as `journey run` reports it. */
+function handbackOutcome(state) {
+    switch (state) {
+        case "prepared":
+            return { state: "pass", detail: "the run stopped at its prepare-only boundary" };
+        case "submitted":
+            return { state: "fail", detail: "the run submitted the irreversible action (a prepare-only boundary must stop before it)" };
+        case "inconclusive":
+            return { state: "inconclusive", detail: "the handback state is inconclusive" };
+        default:
+            return { state: "fail", detail: `the handback state is ${state}` };
+    }
+}
+function oneJourneyReplay(result) {
+    if (result.outcome === "ok") {
+        return result.handback === undefined ? { state: "pass", detail: "the recorded replay held" } : handbackOutcome(result.handback.state);
+    }
+    if (result.outcome === "quarantined")
+        return { state: "fail", detail: result.reason ?? "the replay diverged" };
+    if (result.outcome === "inconclusive")
+        return { state: "inconclusive", detail: result.reason ?? "the replay had no verdict" };
+    return { state: "fail", detail: `the replay ended ${result.outcome}` };
+}
+function pairReplay(result) {
+    if (chainSucceeded(result))
+        return { state: "pass", detail: "the chain held for every request" };
+    if (result.runs.some((r) => r.outcome === "inconclusive"))
+        return { state: "inconclusive", detail: "a chained run had no verdict" };
+    return { state: "fail", detail: `${result.unmatched.length} unmatched request(s), ${result.runs.filter((r) => r.outcome !== "ok").length} failed run(s)` };
+}
+function verdictOf(checks, mode) {
+    if (checks.some((c) => c.state === "fail"))
+        return "blocked";
+    if (checks.some((c) => c.state === "inconclusive"))
+        return "inconclusive";
+    const requiredReplay = mode !== "report";
+    const required = checks.filter((c) => c.check === REQUIRED_PROOF_CHECK || (requiredReplay && c.check === "replay"));
+    if (required.some((c) => c.state === "stale" || c.state === "not-run"))
+        return "incomplete";
+    return "technically-ready";
+}
+function commandsFor(verdict, mode, id, blockers, awaiting) {
+    const next = [];
+    const add = (command) => void (command !== "" && !next.includes(command) && next.push(command));
+    if (verdict === "blocked") {
+        for (const b of blockers)
+            add(b.next);
+        return next;
+    }
+    if (mode !== "prove")
+        add(`jevitate journey readiness ${id} --mode prove`);
+    if (verdict === "technically-ready")
+        add(`jevitate journey promote ${id}`);
+    for (const a of awaiting)
+        add(a.next);
+    return next;
+}
+/**
+ * #581: one Journey's (or a linked pair's) readiness receipt. Static checks only in `report`; the
+ * baseline replay in `replay`/`prove`; fresh mutation proofs in `prove`. Experience reuse is the
+ * existing rule: a proof is fresh only while it binds the current review hash.
+ */
+export async function runJourneyReadiness(opts, deps = {}) {
+    const mode = opts.mode ?? "report";
+    const cwd = (deps.cwd ?? (() => process.cwd()))();
+    const review = deps.review ?? reviewJourneyById;
+    const run = deps.run ?? runJourneyProgrammatically;
+    const chain = deps.chain ?? runJourneyChain;
+    const verify = deps.verify ?? verifyJourneyMutations;
+    const reviewOpts = { strict: true, ...(opts.catalogDir === undefined ? {} : { catalogDir: opts.catalogDir }), ...(opts.targetsFile === undefined ? {} : { targetsFile: opts.targetsFile }) };
+    const contexts = [];
+    const loaded = await review(opts.journeysDir, opts.id, reviewOpts);
+    contexts.push({ id: opts.id, journey: loaded.journey, review: loaded.review });
+    if (opts.with !== undefined) {
+        const consumer = await review(opts.journeysDir, opts.with, reviewOpts);
+        contexts.push({ id: opts.with, journey: consumer.journey, review: consumer.review });
+    }
+    const pair = opts.with !== undefined;
+    let environment;
+    let replay;
+    if (mode !== "report") {
+        environment = resolveTarget(opts, deps, requiredParams(contexts[0].journey, pair, opts.requests !== undefined));
+        const params = { ...(opts.params ?? {}) };
+        try {
+            if (pair) {
+                const chained = await chain({
+                    from: opts.id,
+                    to: opts.with,
+                    requests: opts.requests ?? "",
+                    dir: opts.journeysDir,
+                    environment,
+                    ...(opts.storageState === undefined ? {} : { storageState: opts.storageState }),
+                    ...(opts.browser === undefined ? {} : { browser: opts.browser }),
+                    ...(opts.browserPortFactory === undefined ? {} : { browserPortFactory: opts.browserPortFactory }),
+                });
+                replay = pairReplay(chained);
+            }
+            else {
+                const result = await run({
+                    dir: opts.journeysDir,
+                    id: opts.id,
+                    params,
+                    environment,
+                    ...(opts.storageState === undefined ? {} : { storageState: opts.storageState }),
+                    ...(opts.browser === undefined ? {} : { browser: opts.browser }),
+                    ...(opts.browserPortFactory === undefined ? {} : { browserPortFactory: opts.browserPortFactory }),
+                    ...(opts.fixtures === undefined ? {} : { fixtures: opts.fixtures(opts.id, environment) }),
+                });
+                replay = oneJourneyReplay(result);
+            }
+        }
+        catch (err) {
+            replay = { state: "inconclusive", detail: err instanceof Error ? err.message : String(err) };
+        }
+        if (mode === "prove") {
+            for (const ctx of contexts) {
+                try {
+                    await verify({
+                        dir: opts.journeysDir,
+                        id: ctx.id,
+                        params,
+                        environment,
+                        ...(opts.storageState === undefined ? {} : { storageState: opts.storageState }),
+                        ...(opts.browser === undefined ? {} : { browser: opts.browser }),
+                        ...(opts.browserPortFactory === undefined ? {} : { browserPortFactory: opts.browserPortFactory }),
+                        ...(opts.fixtures === undefined ? {} : { fixtures: opts.fixtures(ctx.id, environment) }),
+                    });
+                }
+                catch (err) {
+                    // A proof the host could not run leaves the existing evidence in place (never a crash).
+                    ctx.review = { ...ctx.review, proof: { ...ctx.review.proof, verify: { status: "not-verified", hint: err instanceof Error ? err.message : String(err) } } };
+                    continue;
+                }
+                // Re-read the freshly recorded proof through the same sheet the verdict is computed from.
+                const refreshed = await review(opts.journeysDir, ctx.id, reviewOpts);
+                ctx.review = refreshed.review;
+            }
+        }
+    }
+    const checks = [];
+    const blockers = [];
+    const awaiting = [];
+    const push = (r) => {
+        checks.push(r.check);
+        if (r.blocker !== undefined)
+            blockers.push(r.blocker);
+        if (r.awaiting !== undefined)
+            awaiting.push(...r.awaiting);
+    };
+    for (const ctx of contexts) {
+        push({ check: schemaCheck(ctx) });
+        push(lintCheck(ctx, opts.projectDir));
+        if (pair && ctx.id === opts.id)
+            push(handoffCheck(contexts[0], contexts[1]));
+        push({ check: boundaryCheck(ctx) });
+        push(reviewStrictCheck(ctx));
+        push(annotationsCheck(ctx));
+        push(catalogCheck(ctx));
+        push(proofCheck(ctx, opts.journeysDir, cwd));
+        if (mode !== "report")
+            push(replayCheck(ctx, replay ?? { state: "not-run", detail: "the replay did not run" }));
+        push(promotionCheck(ctx));
+    }
+    const verdict = verdictOf(checks, mode);
+    const engineInfo = currentEngineInfo();
+    const target = environment === undefined ? null : { origin: environment.baseUrl, ...(environment.name === undefined ? {} : { env: environment.name }) };
+    return {
+        engine: { version: engineInfo.version, commit: engineInfo.commit, tree: currentBuildTree() },
+        mode,
+        target,
+        journeys: contexts.map((ctx) => ({ id: ctx.id, contentHash: journeyContentHash(ctx.journey), reviewHash: ctx.review.contentHash, promoted: ctx.journey.metadata.promoted })),
+        checks,
+        verdict,
+        blockers,
+        awaitingHuman: awaiting,
+        next: commandsFor(verdict, mode, opts.id, blockers, awaiting),
+    };
+}
+//# sourceMappingURL=journey-readiness.js.map

package/dist/journey-readiness.js.map

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

package/dist/mcp-cli-tools.js

@@ -29,6 +29,8 @@ export const OMIT = {
 const HOOK_FLAGS = { "--before": OMIT.hooks, "--after": OMIT.hooks, "--allow-shell-hooks": OMIT.hooks, "--hook-timeout-ms": OMIT.hooks };
 const BROWSER_FLAGS = { "--browser-executable": OMIT.browserBin, "--browser-channel": OMIT.browserBin, "--browser-arg": OMIT.browserBin, "--ignore-host-load": OMIT.hostLoad };
 const JSON_FLAG = { "--json": OMIT.json };
+/** #585: --project / --journeys-dir pick a store, which over MCP is always the server's (as --dir). */
+const LOCATION_FLAGS = { "--project": OMIT.storeDir, "--journeys-dir": OMIT.storeDir };
 /** #426: `--tag key=value` → a `tags` object (`{"feature": "checkout"}`); keys/values validated by the command. */
 const TAGS = { kind: "params", flag: "--tag" };
 // ── Param helpers ─────────────────────────────────────────────────────────────────────────────
@@ -63,7 +65,7 @@ export const CLI_TOOL_SPECS = [
     {
         name: "list_journeys",
         description: "`jevitate journey list`: every Journey in the store (promoted and not) — id, name, promoted, params. find_capabilities is the promoted-only search.",
-        command: { path: "journey list", params: {}, omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG } },
+        command: { path: "journey list", params: {}, omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG } },
     },
     {
         name: "promote_journey",
@@ -82,7 +84,7 @@ export const CLI_TOOL_SPECS = [
                 reason: s("--reason"),
                 ...JEV_ADVICE,
             },
-            omitted: {
+            omitted: { ...LOCATION_FLAGS,
                 "--dir": OMIT.storeDir,
                 "--accept-weak": OMIT.acceptWeak,
                 "--full": OMIT.reviewRendering,
@@ -98,20 +100,20 @@ export const CLI_TOOL_SPECS = [
         description: "`jevitate persona review <id> --json` (#433): read-only. A catalog persona's review sheet — description, account role, session presence (never a credential), the jobs it serves, the Journeys linked to it, its approval state (draft / approved / stale = needs re-review), the pre-approval findings, and its content hash. " +
             "readiness: true adds the #434 Readiness section (deterministic checks + INCOSE GtWR rule findings; with real: true and a judgment key, advisory Jev questions with probabilities). The #435 catalog analysis of its pairs is always included (classified by Jev with real: true). " +
             "Approving a persona is a person's act on the CLI (`jevitate persona approve`): there is no MCP tool for it.",
-        command: { path: "persona review", params: { id: pos(), readiness: b("--readiness"), ...JEV_ADVICE }, omitted: { "--dir": OMIT.storeDir, "--markdown": OMIT.catalogRendering, "--out": OMIT.catalogRendering, ...JSON_FLAG } },
+        command: { path: "persona review", params: { id: pos(), readiness: b("--readiness"), ...JEV_ADVICE }, omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, "--markdown": OMIT.catalogRendering, "--out": OMIT.catalogRendering, ...JSON_FLAG } },
     },
     {
         name: "review_job",
         description: "`jevitate job review <id> --json` (#433): read-only. A catalog job's review sheet — its job story (\"When …, I want to …, so I can ….\"), its personas and which of them have a promoted Journey for it, the gaps, its Journeys, its approval state (draft / approved / stale = needs re-review), the pre-approval findings, and its content hash. " +
             "readiness: true adds the #434 Readiness section (deterministic checks + INCOSE GtWR rule findings; with real: true and a judgment key, advisory Jev questions with probabilities). The #435 catalog analysis of its pairs is always included (classified by Jev with real: true). " +
             "Approving a job is a person's act on the CLI (`jevitate job approve`): there is no MCP tool for it.",
-        command: { path: "job review", params: { id: pos(), readiness: b("--readiness"), ...JEV_ADVICE }, omitted: { "--dir": OMIT.storeDir, "--markdown": OMIT.catalogRendering, "--out": OMIT.catalogRendering, ...JSON_FLAG } },
+        command: { path: "job review", params: { id: pos(), readiness: b("--readiness"), ...JEV_ADVICE }, omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, "--markdown": OMIT.catalogRendering, "--out": OMIT.catalogRendering, ...JSON_FLAG } },
     },
     {
         name: "draft_job_outcomes",
         description: "`jevitate job draft-outcomes <jobId> --json` (#465): draft 1–3 desired outcomes (count, default 3) for a catalog job with the generation model (real: true live, or fakeAi: true deterministic — exactly one) and write them into its jobs file marked provenance ai_draft for the team to review. " +
             "It NEVER approves: an approved job becomes stale (needs re-review), and approving stays a person's act on the CLI (`jevitate job approve`) — there is no MCP tool for it.",
-        command: { path: "job draft-outcomes", params: { jobId: pos(), count: n("--count"), ...AI }, omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG } },
+        command: { path: "job draft-outcomes", params: { jobId: pos(), count: n("--count"), ...AI }, omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG } },
     },
     {
         name: "catalog_status",
@@ -122,7 +124,7 @@ export const CLI_TOOL_SPECS = [
         command: {
             path: "catalog status",
             params: { requireApprovals: b("--require-approvals"), allowChannels: s("--allow-channels"), strict: b("--strict") },
-            omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG },
         },
     },
     {
@@ -140,14 +142,14 @@ export const CLI_TOOL_SPECS = [
                 trigger: s("--trigger"),
                 outcome: s("--outcome"),
             },
-            omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG },
         },
     },
     {
         name: "analyze_catalog",
         description: "`jevitate catalog analyze --json` (#435): read-only and advisory. Problems BETWEEN catalog items, grouped by INCOSE GtWR set characteristic (complete, consistent, feasible, comprehensible, able to be validated, correct): candidate pairs chosen by code (shared persona or trigger/outcome terms, opposing writes on one resource, same role), each with why it was paired and — with real: true — Jev's typed classification (compatible | duplicate | overlapping | conflicting | dependent, with a probability), " +
             "completeness gaps, and update advice (stale approvals, Journeys whose last mutation proof fails). Pairs over maxPairs are listed as overflow, never dropped. It never changes the catalog and never gates.",
-        command: { path: "catalog analyze", params: { ...JEV_ADVICE, maxPairs: n("--max-pairs") }, omitted: { "--dir": OMIT.storeDir, "--markdown": OMIT.catalogRendering, ...JSON_FLAG } },
+        command: { path: "catalog analyze", params: { ...JEV_ADVICE, maxPairs: n("--max-pairs") }, omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, "--markdown": OMIT.catalogRendering, ...JSON_FLAG } },
     },
     {
         name: "export_catalog_bundle",
@@ -162,7 +164,7 @@ export const CLI_TOOL_SPECS = [
                 check: { kind: "path[]", flag: "--check" },
                 productName: s("--product-name"),
             },
-            omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG },
         },
     },
     {
@@ -182,20 +184,20 @@ export const CLI_TOOL_SPECS = [
         command: {
             path: "journey review",
             params: { id: { kind: "string", positional: true }, stale: b("--stale"), readiness: b("--readiness"), strict: b("--strict"), ...JEV_ADVICE },
-            omitted: { "--dir": OMIT.storeDir, "--markdown": OMIT.reviewRendering, "--full": OMIT.reviewRendering, "--out": OMIT.reviewRendering, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, "--markdown": OMIT.reviewRendering, "--full": OMIT.reviewRendering, "--out": OMIT.reviewRendering, ...JSON_FLAG },
         },
     },
     {
         name: "lint_journey",
         description: "`jevitate journey lint <id>`: the assertion-strength lint — the assertions that cannot prove the Journey's outcome (a write with no asserted effect, visibility-only claims, nothing after the last write, …). promote_journey refuses a Journey with any error finding. " +
             "#487: fix: true stamps the step id of each anchor that references a step by number only and writes the Journey (#507: on a promoted Journey its approval goes stale; the result carries needsReapproval and reapproveCommand), reporting what was stamped.",
-        command: { path: "journey lint", params: { id: pos(), fix: b("--fix") }, omitted: { "--dir": OMIT.storeDir, "--sarif": OMIT.storeDir, ...JSON_FLAG } },
+        command: { path: "journey lint", params: { id: pos(), fix: b("--fix") }, omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, "--sarif": OMIT.storeDir, ...JSON_FLAG } },
     },
     {
         name: "journey_anchors",
         description: "`jevitate journey anchors <id>` (#293): a Journey's named anchors — states worth exploring from, each with the step it follows and its suggested adversarial probes. Branch a mission off one with run_exploration fromJourney + atStep. " +
             "#487: suggest: true instead proposes anchors where the recorded flow changes state (a new page, a form that became valid, a completed write) — advisory, writes nothing; accept one with journey_anchor_add.",
-        command: { path: "journey anchors", params: { id: pos(), suggest: b("--suggest") }, omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG } },
+        command: { path: "journey anchors", params: { id: pos(), suggest: b("--suggest") }, omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG } },
     },
     {
         name: "journey_anchor_add",
@@ -204,13 +206,13 @@ export const CLI_TOOL_SPECS = [
         command: {
             path: "journey anchor add",
             params: { journeyId: pos(), name: s("--name", { required: true }), step: s("--step", { required: true }), description: s("--description"), probe: many("--probe"), region: s("--region") },
-            omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG },
         },
     },
     {
         name: "journey_anchor_remove",
         description: "`jevitate journey anchor remove <journeyId>` (#487): remove the named anchor from a Journey; returns the anchor lint issues that remain. On a promoted Journey (#507) the approval goes stale: it stays promoted, the old approval is kept for the review diff, and the result carries needsReapproval: true and reapproveCommand (jevitate journey promote <id> --reviewed-hash <new review hash>), which only a person runs.",
-        command: { path: "journey anchor remove", params: { journeyId: pos(), name: s("--name", { required: true }) }, omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG } },
+        command: { path: "journey anchor remove", params: { journeyId: pos(), name: s("--name", { required: true }) }, omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG } },
     },
     {
         name: "journey_link",
@@ -220,7 +222,7 @@ export const CLI_TOOL_SPECS = [
         command: {
             path: "journey link",
             params: { id: pos(), job: s("--job"), persona: s("--persona"), unlinkJob: b("--unlink-job"), unlinkPersona: b("--unlink-persona") },
-            omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG },
         },
     },
     {
@@ -230,7 +232,7 @@ export const CLI_TOOL_SPECS = [
         command: {
             path: "journey annotate",
             params: { ...EXTENSION, id: pos(), approve: b("--approve"), params: { kind: "params", flag: "--param" }, storageState: session("--storage-state"), fixtures: path("--fixtures"), fixtureIdentity: FIXTURE_IDENTITY, screenshots: { kind: "screenshots", flag: "--screenshots" }, actionDeltas: b("--action-deltas"), ...ENVIRONMENT, ...EMULATION, ...AI },
-            omitted: { "--dir": OMIT.storeDir, ...HOOK_FLAGS, ...BROWSER_FLAGS, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...HOOK_FLAGS, ...BROWSER_FLAGS, ...JSON_FLAG },
         },
     },
     {
@@ -254,7 +256,7 @@ export const CLI_TOOL_SPECS = [
                 ...EMULATION,
                 ...DEMO_SHOW,
             },
-            omitted: { "--dir": OMIT.storeDir, ...HOOK_FLAGS, ...BROWSER_FLAGS, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...HOOK_FLAGS, ...BROWSER_FLAGS, ...JSON_FLAG },
         },
     },
     {
@@ -272,7 +274,41 @@ export const CLI_TOOL_SPECS = [
                 fixtureIdentity: FIXTURE_IDENTITY,
                 ...ENVIRONMENT,
             },
-            omitted: { "--dir": OMIT.storeDir, "--allow": OMIT.mcpOrigins, ...HOOK_FLAGS, ...BROWSER_FLAGS, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, "--allow": OMIT.mcpOrigins, ...HOOK_FLAGS, ...BROWSER_FLAGS, ...JSON_FLAG },
+        },
+    },
+    {
+        name: "journey_readiness",
+        description: "`jevitate journey readiness <id> [--with <toId>] --json` (#581): one readiness receipt for a Journey or a linked pair — lint, schema, the #582 handoff, the #583 boundary, strict review, annotations, catalog links/approvals, the recorded mutation proof (fresh only while bound to the current review hash) and promotion, each pass / fail / inconclusive / stale / not-run / awaiting-human. mode: report (default; no browser, sends nothing) | replay (baseline run, or the chain for a pair with requests) | prove (replay plus verify --mutate). replay/prove need env or baseUrl, refuse an environment flagged production and refuse missing params by name, all before any browser. verdict: technically-ready (exit 0) | blocked (1) | inconclusive / incomplete (2); a passing replay never hides an inconclusive proof. Approvals are listed under awaitingHuman and never acted on; the receipt carries no param value, page text or secret.",
+        command: {
+            path: "journey readiness",
+            params: {
+                id: pos(),
+                with: s("--with"),
+                mode: s("--mode", { enum: ["report", "replay", "prove"] }),
+                params: { kind: "params", flag: "--param" },
+                requests: path("--requests"),
+                storageState: session("--storage-state"),
+                fixtures: path("--fixtures"),
+                fixtureIdentity: FIXTURE_IDENTITY,
+                ...EXTENSION,
+                ...ENVIRONMENT,
+            },
+            omitted: { ...LOCATION_FLAGS, ...HOOK_FLAGS, ...BROWSER_FLAGS, ...JSON_FLAG },
+        },
+    },
+    {
+        name: "journey_bundle",
+        description: "`jevitate journey bundle <id> [--with <toId>] --out <dir> --json` (#584): write a local human review bundle (bundle.md + manifest.json) for a Journey or a linked pair from a report-mode readiness — verdict and blockers first, contracts, boundary, side effects, hashes, distinct approval states and the ordered human-only commands (promote carries the review hash only when technically ready). check: re-derive an existing bundle's hashes; a changed Journey or catalog entry fails closed with E_BUNDLE_STALE. out is a directory inside the project. It never uploads, approves or promotes.",
+        command: {
+            path: "journey bundle",
+            params: {
+                id: { kind: "string", positional: true },
+                with: s("--with"),
+                out: { kind: "project-path", flag: "--out" },
+                check: path("--check"),
+            },
+            omitted: { ...LOCATION_FLAGS, ...JSON_FLAG },
         },
     },
     {
@@ -289,7 +325,7 @@ export const CLI_TOOL_SPECS = [
                 ...EMULATION,
                 ...ENVIRONMENT,
             },
-            omitted: {
+            omitted: { ...LOCATION_FLAGS,
                 "--allow-draft": "#580: over MCP a chain runs promoted Journeys only, as run_journey does; running drafts is the operator's CLI call",
                 "--dir": OMIT.storeDir,
                 "--allow": OMIT.mcpOrigins,
@@ -304,7 +340,7 @@ export const CLI_TOOL_SPECS = [
         command: {
             path: "journey publish",
             params: { id: pos(), to: s("--to", { required: true }), declareOrigin: many("--declare-origin"), as: s("--as") },
-            omitted: { "--dir": OMIT.storeDir, ...JSON_FLAG },
+            omitted: { ...LOCATION_FLAGS, "--dir": OMIT.storeDir, ...JSON_FLAG },
         },
     },
     {
@@ -607,7 +643,7 @@ export const CLI_TOOL_SPECS = [
                 ...EMULATION,
                 ...JEV_AI,
             },
-            omitted: {
+            omitted: { ...LOCATION_FLAGS,
                 "--journeys-dir": OMIT.storeDir,
                 ...HOOK_FLAGS,
                 ...BROWSER_FLAGS,