@jevitate/cli 0.7.0 → 0.8.0

package/dist/build-info.generated.js

@@ -5,6 +5,6 @@
 // this plain `tsc --build` dist (no bundler substitution), so it needs real committed values
 // here instead. See ./engine.ts, which prefers the esbuild-injected value when present and
 // falls back to these.
-export const GENERATED_COMMIT = "213ecc7";
-export const GENERATED_BUILT_AT = "2026-10-07T19:21:08.084Z";
+export const GENERATED_COMMIT = "dbde9df";
+export const GENERATED_BUILT_AT = "2026-10-08T17:46:36.756Z";
 //# sourceMappingURL=build-info.generated.js.map

package/dist/builtin-analyzers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * #434/#435: registers the built-in pre-approval analyzers — readiness (deterministic checks +
+ * GtWR rules), the advisory Jev readiness questions, and the incremental catalog analysis — once
+ * per process. Called by the program wiring (`buildProgram`), so every approval path and every
+ * review sheet, on the CLI and over MCP (which runs the CLI in process), runs them.
+ */
+export declare function registerBuiltinAnalyzers(): void;

package/dist/builtin-analyzers.js

@@ -0,0 +1,19 @@
+import { catalogAnalysisAnalyzer } from "./catalog-analysis.js";
+import { registerPreApprovalAnalyzer } from "./pre-approval.js";
+import { jevReadinessAnalyzer, readinessAnalyzer } from "./readiness.js";
+let registered = false;
+/**
+ * #434/#435: registers the built-in pre-approval analyzers — readiness (deterministic checks +
+ * GtWR rules), the advisory Jev readiness questions, and the incremental catalog analysis — once
+ * per process. Called by the program wiring (`buildProgram`), so every approval path and every
+ * review sheet, on the CLI and over MCP (which runs the CLI in process), runs them.
+ */
+export function registerBuiltinAnalyzers() {
+    if (registered)
+        return;
+    registered = true;
+    registerPreApprovalAnalyzer(readinessAnalyzer);
+    registerPreApprovalAnalyzer(jevReadinessAnalyzer);
+    registerPreApprovalAnalyzer(catalogAnalysisAnalyzer);
+}
+//# sourceMappingURL=builtin-analyzers.js.map

package/dist/builtin-analyzers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-analyzers.js","sourceRoot":"","sources":["../src/builtin-analyzers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEzE,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAClB,2BAA2B,CAAC,iBAAiB,CAAC,CAAC;IAC/C,2BAA2B,CAAC,oBAAoB,CAAC,CAAC;IAClD,2BAA2B,CAAC,uBAAuB,CAAC,CAAC;AACvD,CAAC"}

package/dist/campaign-cli.d.ts

@@ -2,6 +2,12 @@ import type { Command } from "commander";
 import { type CliDeps } from "./cli-shared.js";
 /** The flags every anchored mission of this `campaign run` is re-invoked with (#311). */
 export declare function campaignMissionArgv(cmd: Command): string[];
+/**
+ * #311: the `explore` options a campaign forwards to every anchored mission, as given — safety
+ * (destructive/paid/deny), invariants, backend-log evidence and media. Operator flags only: the
+ * spec file never widens what a mission may click or read.
+ */
+export declare function withMissionFlags(cmd: Command): Command;
 /** `campaign run`'s human summary: the outcome, every mission's branch point, and the deduped defects. */
 export declare function formatCampaignHuman(data: unknown): string;
 /** Registers `jevitate campaign run <spec.json>` (#293). */

package/dist/campaign-cli.js

@@ -1,3 +1,5 @@
+import { JEV_PROVIDER_FLAG_HELP, jevProviderArg } from "./cli-shared.js";
+import { TAG_FLAG, TAG_HELP, collectTag, taggedAction } from "./run-tags-cli.js";
 import { ok, fail } from "./envelope.js";
 import { withEngine } from "./engine.js";
 import { CampaignSpecError, runCampaign, validateCampaign } from "./campaign-api.js";
@@ -16,15 +18,16 @@ export function campaignMissionArgv(cmd) {
  * (destructive/paid/deny), invariants, backend-log evidence and media. Operator flags only: the
  * spec file never widens what a mission may click or read.
  */
-function withMissionFlags(cmd) {
+export function withMissionFlags(cmd) {
     const each = "(forwarded to every mission, as explore's)";
     const repeatable = [
         ["--deny <pattern>", "a control no mission may click (repeatable)"],
         ["--paid <pattern>", "an app control that costs money or credits (repeatable)"],
+        ["--allow-control <regex>", "exempt a control whose name matches from the soft 'may cost money' heuristic only (repeatable, #428)"],
         ["--invariants <file>", "app-declared invariants JSON (repeatable)"],
         ["--log-source <spec>", "backend log source: file:<path> | docker:<container> | cmd:<command> (needs --allow-log-cmd) (repeatable)"],
         ["--log-defect <level|/regex/>", "backend log lines matching this become a server-log defect (repeatable)"],
-        ["--log-quiet-ok <spec>", "a --log-source that is legitimately quiet (repeatable)"],
+        ["--log-quiet-ok <spec>", "compatibility only since 0.8.0 (#420): quiet sources are always healthy (repeatable)"],
         ["--log-ignore <regex|substring>", "known-noise backend log lines to exclude (repeatable)"],
         ["--log-scope <regex|substring>", "attribute only backend log lines matching this (repeatable)"],
         ["--log-correlation-header <name>", "another header carrying a correlation id (repeatable)"],
@@ -71,8 +74,10 @@ export function registerCampaignCommands(program, deps, buildProgram) {
         .option("--hook-timeout-ms <ms>", "timeout for each of the spec's before/after hooks (default 60000; the process group is killed)", positiveIntArg)
         .option("--real", "use live Jev + OpenRouter gateways for the missions (requires keys)", false)
         .option("--fake-ai", "use deterministic fake gateways (pipeline smoke only)", false)
+        .option("--jev-provider <provider>", JEV_PROVIDER_FLAG_HELP, jevProviderArg)
         .option("--json", "emit the JSON envelope (default: a human summary)")
-        .action(async function (spec) {
+        .option(TAG_FLAG, TAG_HELP, collectTag, [])
+        .action(taggedAction(program, "campaign run", async function (spec) {
         const o = this.opts();
         const emit = (envelope, exitCode) => emitCommandResult(program, envelope, { json: o.json === true, command: "campaign run", human: formatCampaignHuman, ...(exitCode === undefined ? {} : { exitCode }) });
         if (o.real !== true && o.fakeAi !== true) {
@@ -104,6 +109,6 @@ export function registerCampaignCommands(program, deps, buildProgram) {
             else
                 emit(fail("E_CAMPAIGN_RUN", String(err instanceof Error ? err.message : err)));
         }
-    });
+    }));
 }
 //# sourceMappingURL=campaign-cli.js.map

package/dist/campaign-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"campaign-cli.js","sourceRoot":"","sources":["../src/campaign-cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"campaign-cli.js","sourceRoot":"","sources":["../src/campaign-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAuB,MAAM,mBAAmB,CAAC;AAC1G,OAAO,EAAgB,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvJ,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,sGAAsG;AACtG,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1I,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,IAAc,EAAY,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;AAEtE,yFAAyF;AACzF,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,aAAa,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,MAAM,IAAI,GAAG,4CAA4C,CAAC;IAC1D,MAAM,UAAU,GAA6C;QAC3D,CAAC,kBAAkB,EAAE,6CAA6C,CAAC;QACnE,CAAC,kBAAkB,EAAE,yDAAyD,CAAC;QAC/E,CAAC,yBAAyB,EAAE,sGAAsG,CAAC;QACnI,CAAC,qBAAqB,EAAE,2CAA2C,CAAC;QACpE,CAAC,qBAAqB,EAAE,2GAA2G,CAAC;QACpI,CAAC,8BAA8B,EAAE,yEAAyE,CAAC;QAC3G,CAAC,uBAAuB,EAAE,sFAAsF,CAAC;QACjH,CAAC,gCAAgC,EAAE,uDAAuD,CAAC;QAC3F,CAAC,+BAA+B,EAAE,6DAA6D,CAAC;QAChG,CAAC,iCAAiC,EAAE,uDAAuD,CAAC;QAC5F,CAAC,4BAA4B,EAAE,2DAA2D,CAAC;KAC5F,CAAC;IACF,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,UAAU;QAAE,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,EAAc,CAAC,CAAC;IACtG,GAAG;SACA,MAAM,CAAC,qBAAqB,EAAE,mGAAmG,IAAI,EAAE,CAAC;SACxI,MAAM,CAAC,gBAAgB,EAAE,yCAAyC,IAAI,EAAE,CAAC;SACzE,MAAM,CAAC,iBAAiB,EAAE,wDAAwD,IAAI,EAAE,CAAC;SACzF,MAAM,CAAC,cAAc,EAAE,iGAAiG,IAAI,EAAE,CAAC;SAC/H,MAAM,CAAC,4BAA4B,EAAE,sFAAsF,IAAI,EAAE,EAAE,iBAAiB,CAAC;SACrJ,MAAM,CAAC,kBAAkB,EAAE,gEAAgE,IAAI,EAAE,CAAC;SAClG,MAAM,CAAC,sBAAsB,EAAE,oDAAoD,IAAI,EAAE,CAAC,CAAC;IAC9F,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,MAAM,CAAC,GAAG,IAAsB,CAAC;IACjC,MAAM,KAAK,GAAG;QACZ,YAAY,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE;QACpC,YAAY,CAAC,CAAC,cAAc,UAAU,CAAC,CAAC,QAAQ,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,iBAAiB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,WAAW;QAC5K,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,8BAA8B,CAAC;QACnK,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CACf,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;YAClE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,EAAE,CACxN;QACD,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,UAAU,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACpM,YAAY,CAAC,CAAC,UAAU,EAAE;QAC1B,YAAY,CAAC,CAAC,UAAU,EAAE;KAC3B,CAAC;IACF,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,wBAAwB,CAAC,OAAgB,EAAE,IAAa,EAAE,YAAwC;IAChH,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,oFAAoF,CAAC,CAAC;IAC/I,gBAAgB,CAAC,QAAQ;SACtB,OAAO,CAAC,YAAY,CAAC,CAAC;SACtB,WAAW,CACV,wHAAwH;QACtH,4HAA4H;QAC5H,4HAA4H,CAC/H;SACA,MAAM,CAAC,uBAAuB,EAAE,kGAAkG,CAAC;SACnI,MAAM,CAAC,aAAa,EAAE,mIAAmI,CAAC;SAC1J,MAAM,CAAC,qBAAqB,EAAE,gGAAgG,EAAE,KAAK,CAAC;SACtI,MAAM,CAAC,wBAAwB,EAAE,gGAAgG,EAAE,cAAc,CAAC;SAClJ,MAAM,CAAC,QAAQ,EAAE,qEAAqE,EAAE,KAAK,CAAC;SAC9F,MAAM,CAAC,WAAW,EAAE,uDAAuD,EAAE,KAAK,CAAC;SACnF,MAAM,CAAC,2BAA2B,EAAE,sBAAsB,EAAE,cAAc,CAAC;SAC3E,MAAM,CAAC,QAAQ,EAAE,mDAAmD,CAAC;SACrE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAC;SAC1C,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,WAA0B,IAAY;QACvF,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAqK,CAAC;QACzL,MAAM,IAAI,GAAG,CAAC,QAAiD,EAAE,QAAiB,EAAQ,EAAE,CAC1F,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACxK,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,wGAAwG,CAAC,CAAC,CAAC;YACxI,OAAO;QACT,CAAC;QACD,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE;gBACxC,WAAW;gBACX,eAAe,EAAE,CAAC,CAAC,eAAe,KAAK,IAAI;gBAC3C,GAAG,CAAC,CAAC,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;gBAC5E,gBAAgB,EAAE,gBAAgB,CAAC,IAAI,CAAC;aACzC,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE;gBACrC,UAAU,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;gBACpC,WAAW;gBACX,iBAAiB,EAAE,wBAAwB,CAAC,IAAI,CAAC;gBACjD,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;gBACjD,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1C,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9C,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,iBAAiB;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;;gBACnE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtF,CAAC;IACH,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/catalog-analysis.d.ts

@@ -0,0 +1,70 @@
+import { type CandidatePair, type CatalogAnalysis, type Finding } from "@jevitate/journey";
+import { type Catalog, type CatalogJourney } from "./catalog.js";
+import { type JevSetup } from "./jev-advisor.js";
+import type { ApprovalSubject, PreApprovalAnalyzer } from "./pre-approval.js";
+/**
+ * #435 — catalog analysis: problems BETWEEN items (conflicts, duplicates, overlaps, gaps, drift),
+ * grouped by the INCOSE Guide to Writing Requirements' set characteristics (complete, consistent,
+ * feasible, comprehensible, able to be validated, correct).
+ *
+ *  - Candidate pairs are chosen by CODE, so cost is bounded (never O(n²) model calls): jobs that
+ *    share a persona or trigger/outcome terms; Journeys whose expected writes (the #432 sheet's) hit
+ *    the same resource, flagged when the methods oppose (create vs delete, enable vs disable) or
+ *    when they do the same job as the same persona; personas with the same role or largely the same
+ *    jobs. Each pair records why it was paired.
+ *  - Jev classifies each judged pair as a typed Choice (compatible | duplicate | overlapping |
+ *    conflicting | dependent) with a probability. The one-line reason is built by code from the two
+ *    items' own text and the pairing evidence — never model prose.
+ *  - The acknowledgment rule is code over the typed answer: on an APPROVAL, a `conflicting` or
+ *    `duplicate` classification with probability ≥ `CONFLICT_ACK_THRESHOLD` on a pair involving the
+ *    item being approved requires `--accept-findings "<reason>"`. Everything else is informational,
+ *    and the on-demand `catalog analyze` never gates anything.
+ *  - Per approval only the item's own pairs are judged, at most `APPROVAL_PAIR_CAP` of them; the
+ *    rest are listed as overflow (never silently dropped). Answers are cached by content hash
+ *    (jev-advisor.ts), so re-approving an unchanged item asks nothing new.
+ *  - It only READS: it never writes a catalog file, a Journey or an approval.
+ */
+export declare const CATALOG_ANALYSIS = "catalog-analysis";
+/** A `conflicting` / `duplicate` classification at or above this probability needs an acknowledgment to approve. */
+export declare const CONFLICT_ACK_THRESHOLD = 0.7;
+/** The most candidate pairs judged before one approval (the rest are reported as overflow). */
+export declare const APPROVAL_PAIR_CAP = 8;
+/** The default most candidate pairs judged by `catalog analyze` (`--max-pairs`). */
+export declare const ANALYZE_PAIR_CAP = 50;
+/** The significant terms of a text: lowercase words of 3+ letters, stopwords dropped, a plural `s` folded. */
+export declare function significantTerms(text: string): Set<string>;
+interface WriteRef {
+    readonly method: string;
+    readonly endpoint: string;
+    /** The resource path with ids and a trailing action dropped (`/api/posts`). */
+    readonly resource: string;
+    readonly action?: string;
+}
+/** #435: a write request's resource: the path without ids, wildcards and a trailing action verb. */
+export declare function writeResource(method: string, endpoint: string): WriteRef;
+/** #435: every candidate pair of the catalog, each with why code paired it. */
+export declare function candidatePairs(catalog: Catalog): CandidatePair[];
+/** The catalog an approval sees: the Journey being approved as it will be approved (demo approve annotates first). */
+export declare function withJourney(catalog: Catalog, journey: CatalogJourney | undefined): Catalog;
+export interface AnalyzeOptions {
+    /** The item being approved/reviewed: only its pairs are judged, and only advice involving it is given. Absent: the whole catalog. */
+    readonly subject?: ApprovalSubject;
+    /** The Jev layer; absent or skipped: the deterministic layer only. */
+    readonly jev?: JevSetup;
+    readonly pairCap?: number;
+    /** True for an approval: the acknowledgment rule applies to the subject's pairs. */
+    readonly gate?: boolean;
+}
+/**
+ * #435: the catalog analysis — of the whole catalog (`catalog analyze`), or incrementally of the
+ * item being approved/reviewed (`opts.subject`: only its pairs, only advice involving it). Never writes.
+ */
+export declare function analyzeCatalog(catalog: Catalog, opts?: AnalyzeOptions): Promise<{
+    report: CatalogAnalysis;
+    findings: Finding[];
+}>;
+/** #435: the incremental analysis before every approval (and in every review sheet). */
+export declare const catalogAnalysisAnalyzer: PreApprovalAnalyzer;
+/** #435: `jevitate catalog analyze` as text or Markdown. */
+export declare function renderCatalogAnalysis(r: CatalogAnalysis, style: "markdown" | "text"): string;
+export {};