@jevitate/cli 0.6.0 → 0.8.0

package/dist/catalog-api.js

@@ -0,0 +1,97 @@
+import { join } from "node:path";
+import { clock } from "@jevitate/domain";
+import { CatalogLoader, catalogJourney, journeyLinks, requireJob, requirePersona, writeJobApproval, writePersonaApproval } from "./catalog.js";
+import { acknowledgeFindings, preApprovalFindings } from "./pre-approval.js";
+import { findProjectDir } from "./project-dir.js";
+import { programmaticProvenance } from "./approval-provenance.js";
+/**
+ * #433 — the approvals of the catalog (`persona approve`, `job approve`: a person's act, CLI only)
+ * and the catalog gate every Journey approval (`journey promote`, `demo approve`) passes.
+ */
+/** The catalog's directory: `--dir`, else the CLI's seam, else the project's `.jevitate/` (null outside a project). */
+export function resolveCatalogDir(seam, flag) {
+    return flag ?? seam ?? findProjectDir();
+}
+/** Loads the catalog of a project data dir and a journeys dir. */
+export function loadCatalog(catalogDir, journeysDir) {
+    return new CatalogLoader({ catalogDir, journeysDir }).load();
+}
+/** The journeys directory of a catalog `--dir` (its `journeys/`), else the CLI's default. */
+export function catalogJourneysDir(flag, fallback) {
+    return flag === undefined ? fallback : join(flag, "journeys");
+}
+/** `persona|job approve --reviewed-hash`: the item changed after the reviewer's sheet was produced. */
+export class StaleCatalogReviewError extends Error {
+    code = "E_CATALOG_REVIEW_STALE";
+}
+/**
+ * #433: approves a persona or a job — bound to its content hash, after the shared pre-approval
+ * pipeline (`preApprovalFindings` + the acknowledgment rule). A human act: never an MCP tool.
+ */
+export async function approveCatalogItem(kind, catalog, id, opts = {}) {
+    const item = kind === "persona" ? requirePersona(catalog, id) : requireJob(catalog, id);
+    const reviewed = opts.reviewedHash?.trim().toLowerCase();
+    if (reviewed !== undefined && reviewed !== item.contentHash) {
+        throw new StaleCatalogReviewError(`${kind} '${id}' changed after its review sheet was produced (reviewed ${reviewed}, now ${item.contentHash}) — review it again: jevitate ${kind} review ${id}`);
+    }
+    const action = kind === "persona" ? "persona approve" : "job approve";
+    // #434: every approval runs the readiness checks (the Jev layer only with --real and a key).
+    const findings = await preApprovalFindings({ kind, id }, catalog, { action, readiness: true, ...(opts.jev === undefined ? {} : { jev: opts.jev }) });
+    const acceptedFindings = acknowledgeFindings(`${kind} '${id}'`, findings, opts.acceptFindings);
+    const provenance = opts.confirm === undefined
+        ? programmaticProvenance()
+        : await opts.confirm({
+            kind,
+            id,
+            contentHash: item.contentHash,
+            waivers: acceptedFindings === undefined ? [] : [{ flag: "--accept-findings", reason: acceptedFindings.reason, detail: acceptedFindings.findings.join(", ") }],
+        });
+    const approval = {
+        contentHash: item.contentHash,
+        at: clock.nowIso(),
+        provenance,
+        ...(acceptedFindings === undefined ? {} : { acceptedFindings: { ...acceptedFindings, provenance } }),
+    };
+    const file = kind === "persona" ? catalog.personasFile : catalog.jobsFile;
+    // requirePersona/requireJob found the item, so its file was read.
+    if (file === null)
+        throw new Error(`${kind} '${id}' has no catalog file`);
+    if (kind === "persona")
+        await writePersonaApproval(file, id, approval);
+    else
+        await writeJobApproval(file, id, approval);
+    return { kind, id, approval, previousStatus: item.status, findings, file };
+}
+/** #433: `journey promote` of a Journey whose linked job/persona is not approved, without `--accept-unvetted`. */
+export class UnvettedLinksError extends Error {
+    unvetted;
+    code = "E_JOURNEY_UNVETTED";
+    constructor(message, unvetted) {
+        super(message);
+        this.unvetted = unvetted;
+    }
+}
+/**
+ * #433: the catalog gate of a Journey approval. A Journey linking a job or a catalog persona needs
+ * each linked item approved (an unknown, draft or stale one is "unvetted"), or a recorded waiver
+ * (`--accept-unvetted "<reason>"` → `approval.waivers`). An unlinked Journey passes (opt-in). Then
+ * the shared pre-approval pipeline and its acknowledgment rule (`--accept-findings`).
+ */
+export async function journeyCatalogGate(journey, opts) {
+    const catalog = await loadCatalog(opts.catalogDir, opts.journeysDir);
+    const links = journeyLinks(catalog, catalogJourney(journey));
+    const id = journey.metadata.id;
+    let waivers;
+    if (links.unvetted.length > 0) {
+        const reason = opts.acceptUnvetted?.trim() ?? "";
+        if (reason === "") {
+            throw new UnvettedLinksError(`journey '${id}' links catalog items that are not approved: ${links.unvetted.join(", ")} — approve them first (jevitate job|persona review/approve <id>), ` +
+                `or promote anyway with --accept-unvetted "<reason>" (recorded on the approval)`, links.unvetted);
+        }
+        waivers = [{ kind: "unvetted", reason, items: [...links.unvetted] }];
+    }
+    const findings = await preApprovalFindings({ kind: "journey", id }, catalog, { action: opts.action, journey, readiness: true, ...(opts.jev === undefined ? {} : { jev: opts.jev }) });
+    const acceptedFindings = acknowledgeFindings(`journey '${id}'`, findings, opts.acceptFindings);
+    return { ...(waivers === undefined ? {} : { waivers }), ...(acceptedFindings === undefined ? {} : { acceptedFindings }), findings };
+}
+//# sourceMappingURL=catalog-api.js.map

package/dist/catalog-api.js.map

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

package/dist/catalog-cli.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "commander";
+import { type CliDeps } from "./cli-shared.js";
+import { type JevSetup } from "./jev-advisor.js";
+/** #434/#435: `--readiness` / `--real` / `--jev-provider` help. */
+export declare const READINESS_FLAG_HELP = "#434: add the Readiness section \u2014 deterministic checks with INCOSE GtWR rule findings, and (with --real and a judgment key) advisory Jev questions with probabilities";
+export declare const REAL_JEV_FLAG_HELP = "#434/#435: ask Jev (advisory; never blocks on its own) \u2014 readiness questions and catalog pair classifications, cached by content hash. Without a judgment key the Jev layer is skipped, the deterministic layer still runs";
+/** The Jev layer of a catalog command (`--real`), its answer cache under the catalog's data dir. */
+export declare function jevSetupFor(deps: CliDeps, catalogDir: string | null, o: {
+    real?: boolean;
+    jevProvider?: string;
+}): Promise<JevSetup>;
+export declare function registerCatalogCommands(program: Command, deps: CliDeps): void;

package/dist/catalog-cli.js

@@ -0,0 +1,224 @@
+import { writeFile } from "node:fs/promises";
+import { ok, fail } from "./envelope.js";
+import { MissingCredentialError } from "@jevitate/ai-core";
+import { GatewaySelectionError, JEV_PROVIDER_FLAG_HELP, emitJson, emitUsageLine, jevProviderArg, resolveJourneysDir } from "./cli-shared.js";
+import { positiveIntArg } from "./cli-args.js";
+import { buildJevSetup, jevCacheDir } from "./jev-advisor.js";
+import { analyzeCatalog, renderCatalogAnalysis, ANALYZE_PAIR_CAP } from "./catalog-analysis.js";
+import { CatalogInputError, UnknownCatalogItemError } from "./catalog.js";
+import { StaleCatalogReviewError, approveCatalogItem, catalogJourneysDir, loadCatalog, resolveCatalogDir } from "./catalog-api.js";
+import { buildCatalogStatus, buildJobReview, buildPersonaReview, renderCatalogStatus, renderJobReview, renderPersonaReview } from "./catalog-review.js";
+import { ApprovalFindingsError } from "./pre-approval.js";
+import { EXIT_CODES } from "./exit-codes.js";
+import { ApprovalArgsError, approvalRefusal, approvalsReport, checkNonInteractiveReason, describeProvenance, makeApprovalConfirm, parseAllowedChannels, renderApprovals, } from "./approval-provenance.js";
+/**
+ * #433 — the catalog commands: `persona review|approve <id>`, `job review|approve <id>` and
+ * `catalog status`. Approving is a person's act: these approve commands are CLI only (no MCP tool;
+ * MCP gets the read-only `review_persona`, `review_job` and `catalog_status`).
+ */
+const DIR_HELP = "the project data dir holding personas.json and jobs.json (default: the repo's .jevitate/); its journeys/ are the Journeys";
+/** #434/#435: `--readiness` / `--real` / `--jev-provider` help. */
+export const READINESS_FLAG_HELP = "#434: add the Readiness section — deterministic checks with INCOSE GtWR rule findings, and (with --real and a judgment key) advisory Jev questions with probabilities";
+export const REAL_JEV_FLAG_HELP = "#434/#435: ask Jev (advisory; never blocks on its own) — readiness questions and catalog pair classifications, cached by content hash. Without a judgment key the Jev layer is skipped, the deterministic layer still runs";
+/** The Jev layer of a catalog command (`--real`), its answer cache under the catalog's data dir. */
+export function jevSetupFor(deps, catalogDir, o) {
+    return buildJevSetup(deps, { ...(o.real === undefined ? {} : { real: o.real }), ...(o.jevProvider === undefined ? {} : { jevProvider: o.jevProvider }), cacheDir: jevCacheDir(catalogDir) });
+}
+function refuse(program, err, fallbackCode) {
+    const refusal = approvalRefusal(err);
+    if (refusal !== null) {
+        emitJson(program, fail(refusal.code, refusal.message));
+    }
+    else if (err instanceof GatewaySelectionError || err instanceof MissingCredentialError) {
+        emitJson(program, fail("E_AI_SETUP_REQUIRED", err.message));
+    }
+    else if (err instanceof UnknownCatalogItemError) {
+        emitJson(program, fail(err.code, err.message));
+    }
+    else if (err instanceof CatalogInputError || err instanceof StaleCatalogReviewError) {
+        emitJson(program, fail(err.code, err.message));
+    }
+    else if (err instanceof ApprovalFindingsError) {
+        // #433: a refusal on the item's findings — exit 1 (a gating finding), like E_JOURNEY_WEAK.
+        emitJson(program, fail(err.code, err.message));
+        process.exitCode = EXIT_CODES.defects;
+    }
+    else {
+        emitJson(program, fail(fallbackCode, String(err instanceof Error ? err.message : err)));
+    }
+}
+function registerItemCommands(program, deps, kind) {
+    const group = program
+        .command(kind)
+        .description(kind === "persona"
+        ? "#433: catalog personas (.jevitate/personas.json) — review a persona's sheet, approve it (a person's sign-off, bound to its content hash)"
+        : "#433: catalog jobs — job stories in .jevitate/jobs.json (\"When …, I want to …, so I can ….\") — review a job's sheet, approve it (bound to its content hash)");
+    const code = kind === "persona" ? "E_PERSONA" : "E_JOB";
+    const argsCode = kind === "persona" ? "E_PERSONA_REVIEW_ARGS" : "E_JOB_REVIEW_ARGS";
+    const load = (dir) => loadCatalog(resolveCatalogDir(deps.catalogDir, dir), catalogJourneysDir(dir, resolveJourneysDir(deps)));
+    const sheet = async (dir, id, action, opts) => {
+        const catalog = await load(dir);
+        if (kind === "persona") {
+            const review = await buildPersonaReview(catalog, id, action, opts);
+            return { catalog, review, render: (style) => renderPersonaReview(review, style) };
+        }
+        const review = await buildJobReview(catalog, id, action, opts);
+        return { catalog, review, render: (style) => renderJobReview(review, style) };
+    };
+    group
+        .command("review <id>")
+        .description(kind === "persona"
+        ? "a persona's review sheet: who it is, the jobs it serves, the Journeys linked to it, its approval state (stale = needs re-review), the pre-approval findings, its content hash"
+        : "a job's review sheet: its story, its personas and which have a promoted Journey for it, the gaps, its Journeys, its approval state, the pre-approval findings, its content hash")
+        .option("--dir <path>", DIR_HELP)
+        .option("--markdown", "render the sheet as Markdown")
+        .option("--out <file>", "write the sheet (JSON with --json, Markdown with --markdown, else text) to this file")
+        .option("--readiness", READINESS_FLAG_HELP)
+        .option("--real", REAL_JEV_FLAG_HELP)
+        .option("--jev-provider <provider>", JEV_PROVIDER_FLAG_HELP, jevProviderArg)
+        .option("--json", "emit a JSON envelope (the schema-checked sheet)")
+        .action(async function (id) {
+        const { dir, json, markdown, out: outFile, readiness, real, jevProvider } = this.opts();
+        if (json === true && markdown === true) {
+            emitJson(program, fail(argsCode, "--json and --markdown are exclusive: pick one rendering"));
+            return;
+        }
+        try {
+            const jev = await jevSetupFor(deps, resolveCatalogDir(deps.catalogDir, dir), { real, jevProvider });
+            const { review, render } = await sheet(dir, id, "review", { readiness: readiness === true, jev });
+            const rendered = json ? `${JSON.stringify(review, null, 2)}\n` : render(markdown ? "markdown" : "text");
+            if (outFile !== undefined)
+                await writeFile(outFile, rendered, { mode: 0o600 });
+            if (json)
+                emitJson(program, ok(review));
+            else if (outFile !== undefined)
+                program.configureOutput().writeOut?.(`review sheet for ${kind} '${review.id}' written to ${outFile} (content hash ${review.contentHash})\n`);
+            else
+                program.configureOutput().writeOut?.(rendered);
+            emitUsageLine(program, review.jev);
+            // #434: a review never fails on its findings (readiness and Jev answers are advice).
+            process.exitCode = 0;
+        }
+        catch (err) {
+            refuse(program, err, `${code}_REVIEW`);
+        }
+    });
+    group
+        .command("approve <id>")
+        .description(`approve a ${kind} (a person's sign-off; CLI only, never an MCP tool): shows its review sheet, runs the pre-approval findings, then records {contentHash, at} in ${kind === "persona" ? "personas.json" : "its jobs file"}. Editing it later makes it — and its Journeys — "needs re-review"`)
+        .option("--dir <path>", DIR_HELP)
+        .option("--reviewed-hash <hash>", `the content hash of the review sheet you read; refused (E_CATALOG_REVIEW_STALE) if the ${kind} changed since`)
+        .option("--accept-findings <reason>", "approve although pre-approval findings need an acknowledgment, recording the reason with the approval")
+        .option("--real", `${REAL_JEV_FLAG_HELP}; a conflicting/duplicate pair classification at or above the documented threshold then needs --accept-findings`)
+        .option("--jev-provider <provider>", JEV_PROVIDER_FLAG_HELP, jevProviderArg)
+        .option("--non-interactive-approval <reason>", "#437: approve without a terminal confirmation (a scripted setup), recorded as channel non-interactive (ci under a CI marker) with the reason — never as a person's; check --require-approvals fails it. A coding agent never uses this")
+        .option("--json", "emit a JSON envelope")
+        .action(async function (id) {
+        const { dir, json, reviewedHash: hashFlag, acceptFindings, real, jevProvider, nonInteractiveApproval } = this.opts();
+        let reviewedHash = hashFlag?.trim().toLowerCase();
+        if (reviewedHash !== undefined && !/^[0-9a-f]{64}$/.test(reviewedHash)) {
+            emitJson(program, fail(argsCode, "--reviewed-hash needs the 64-hex content hash a review sheet shows"));
+            return;
+        }
+        if (acceptFindings !== undefined && acceptFindings.trim() === "") {
+            emitJson(program, fail(argsCode, "--accept-findings needs a reason"));
+            return;
+        }
+        try {
+            checkNonInteractiveReason(nonInteractiveApproval);
+            const action = kind === "persona" ? "persona approve" : "job approve";
+            // #434/#435: every approval shows readiness and the catalog analysis; Jev only with --real.
+            const jev = await jevSetupFor(deps, resolveCatalogDir(deps.catalogDir, dir), { real, jevProvider });
+            const { catalog, review, render } = await sheet(dir, id, action, { readiness: true, jev });
+            if (!json) {
+                // Human mode: the sheet (with its findings) is shown before approving; the approval binds to what was shown.
+                program.configureOutput().writeOut?.(`${render("text")}\n`);
+                reviewedHash ??= review.contentHash;
+            }
+            const result = await approveCatalogItem(kind, catalog, id, {
+                ...(reviewedHash === undefined ? {} : { reviewedHash }),
+                ...(acceptFindings === undefined ? {} : { acceptFindings }),
+                jev,
+                // #437: a typed confirmation on a TTY (or the escape hatch), recorded as provenance.
+                confirm: makeApprovalConfirm(deps.approval, nonInteractiveApproval === undefined ? {} : { nonInteractiveReason: nonInteractiveApproval }),
+            });
+            emitUsageLine(program, review.jev);
+            if (json)
+                emitJson(program, ok(result));
+            else {
+                program.configureOutput().writeOut?.(`approved ${kind} '${id}' (content hash ${result.approval.contentHash}; ${describeProvenance(result.approval.provenance)})${result.previousStatus === "stale" ? " — re-approved: its Journeys no longer need re-review on its account" : ""}\n`);
+                process.exitCode = 0;
+            }
+        }
+        catch (err) {
+            refuse(program, err, `${code}_APPROVE`);
+        }
+    });
+}
+export function registerCatalogCommands(program, deps) {
+    registerItemCommands(program, deps, "persona");
+    registerItemCommands(program, deps, "job");
+    const catalog = program.command("catalog").description("#433: the human-vetted catalog of personas, jobs and the Journeys linked to them");
+    catalog
+        .command("status")
+        .description("the jobs × personas matrix (which have a promoted Journey), approved jobs with no promoted Journey, Journeys linked to nothing, dangling links and stale approvals")
+        .option("--dir <path>", DIR_HELP)
+        .option("--require-approvals", "#437: exit 1 when a promoted Journey or an approved persona/job has a missing or stale approval, or one made over a channel not allowed (--allow-channels)")
+        .option("--allow-channels <list>", "#437: with --require-approvals, the approval channels that pass (comma list of tty, non-interactive, mcp, ci; default tty)")
+        .option("--json", "emit a JSON envelope (the schema-checked report)")
+        .action(async function () {
+        const { dir, json, requireApprovals, allowChannels } = this.opts();
+        try {
+            if (allowChannels !== undefined && requireApprovals !== true)
+                throw new ApprovalArgsError("--allow-channels needs --require-approvals");
+            const allowed = requireApprovals === true ? parseAllowedChannels(allowChannels) : undefined;
+            const catalog = await loadCatalog(resolveCatalogDir(deps.catalogDir, dir), catalogJourneysDir(dir, resolveJourneysDir(deps)));
+            // #437: every recorded approval and how it was made; with --require-approvals, the violations.
+            const approvals = approvalsReport([catalog], allowed);
+            const report = { ...buildCatalogStatus(catalog), approvals };
+            const failed = (approvals.requirement?.violations.length ?? 0) > 0;
+            if (json)
+                emitJson(program, ok(report));
+            else
+                program.configureOutput().writeOut?.(`${renderCatalogStatus(report)}${renderApprovals(approvals)}`);
+            process.exitCode = failed ? EXIT_CODES.defects : 0;
+        }
+        catch (err) {
+            refuse(program, err, "E_CATALOG_STATUS");
+        }
+    });
+    catalog
+        .command("analyze")
+        .description("#435: problems BETWEEN catalog items, grouped by INCOSE GtWR set characteristic — candidate pairs (paired by code: shared persona/terms, opposing writes, same role) classified by Jev (with --real) as compatible/duplicate/overlapping/conflicting/dependent, " +
+        "completeness gaps, and update advice (stale approvals, Journeys whose last mutation proof fails). Read-only and advisory: it never changes the catalog and never gates")
+        .option("--dir <path>", DIR_HELP)
+        .option("--real", "#435: classify the candidate pairs with Jev (advisory; cached by content hash). Without a judgment key: the deterministic layer only")
+        .option("--jev-provider <provider>", JEV_PROVIDER_FLAG_HELP, jevProviderArg)
+        .option("--max-pairs <n>", `the most candidate pairs to judge (default ${ANALYZE_PAIR_CAP}); the rest are listed as overflow, never dropped`, positiveIntArg)
+        .option("--markdown", "render the report as Markdown")
+        .option("--json", "emit a JSON envelope (the schema-checked report)")
+        .action(async function () {
+        const { dir, json, markdown, real, jevProvider, maxPairs } = this.opts();
+        if (json === true && markdown === true) {
+            emitJson(program, fail("E_CATALOG_ANALYZE_ARGS", "--json and --markdown are exclusive: pick one rendering"));
+            return;
+        }
+        try {
+            const catalogDir = resolveCatalogDir(deps.catalogDir, dir);
+            const loaded = await loadCatalog(catalogDir, catalogJourneysDir(dir, resolveJourneysDir(deps)));
+            const jev = await jevSetupFor(deps, catalogDir, { real, jevProvider });
+            const { report } = await analyzeCatalog(loaded, { jev, ...(maxPairs === undefined ? {} : { pairCap: maxPairs }) });
+            if (json)
+                emitJson(program, ok(report));
+            else
+                program.configureOutput().writeOut?.(renderCatalogAnalysis(report, markdown ? "markdown" : "text"));
+            emitUsageLine(program, report.jev);
+            // Advisory: the report's findings never change the exit code.
+            process.exitCode = 0;
+        }
+        catch (err) {
+            refuse(program, err, "E_CATALOG_ANALYZE");
+        }
+    });
+}
+//# sourceMappingURL=catalog-cli.js.map

package/dist/catalog-cli.js.map

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

package/dist/catalog-review.d.ts

@@ -0,0 +1,29 @@
+import { type CatalogStatusReport, type Finding, type JobReview, type PersonaReview } from "@jevitate/journey";
+import { type Catalog } from "./catalog.js";
+import { type ApprovalAction } from "./pre-approval.js";
+import { type JevSetup } from "./jev-advisor.js";
+/** #434/#435: what a review sheet asks of the pipeline beyond the defaults. */
+export interface SheetOptions {
+    /** #434: include the Readiness section (`--readiness`; every approval sets it). */
+    readonly readiness?: boolean;
+    /** #434/#435: the advisory Jev layer (`--real`), or why it is skipped. */
+    readonly jev?: JevSetup;
+}
+export declare function buildPersonaReview(catalog: Catalog, id: string, action?: ApprovalAction, opts?: SheetOptions): Promise<PersonaReview>;
+export declare function buildJobReview(catalog: Catalog, id: string, action?: ApprovalAction, opts?: SheetOptions): Promise<JobReview>;
+/** #433: `catalog status` — the jobs × personas matrix, gaps, unlinked Journeys, dangling links, stale approvals. */
+export declare function buildCatalogStatus(catalog: Catalog): CatalogStatusReport;
+type Style = "markdown" | "text";
+/** #435: catalog-analysis findings, one sub-section per INCOSE GtWR set characteristic (non-empty ones, in the guide's order). */
+export declare function renderAnalysisGroups(findings: readonly Finding[], style: Style): string[];
+/**
+ * #433: the pre-approval findings every review sheet shows before an approval. #434: the readiness
+ * findings form their own Readiness section, its two layers apart (deterministic checks; the
+ * advisory Jev review). #435: the catalog analysis forms its own section, grouped by GtWR set
+ * characteristic. The acknowledgment line counts every section.
+ */
+export declare function renderFindings(findings: readonly Finding[], style: Style): string[];
+export declare function renderPersonaReview(r: PersonaReview, style: Style): string;
+export declare function renderJobReview(r: JobReview, style: Style): string;
+export declare function renderCatalogStatus(r: CatalogStatusReport): string;
+export {};