@garygentry/system1-core 0.3.2 → 0.4.0

package/dist/opportunities/backlog.js

@@ -0,0 +1,393 @@
+import { createHash } from "node:crypto";
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { Type } from "typebox";
+import { Value } from "typebox/value";
+import { stateDir } from "../config/load.js";
+import { DecisionsError } from "../errors.js";
+import { QuestionSchema } from "../model/schema.js";
+import { assertQuestionSet } from "../model/validate.js";
+import { tokenizeFilter, tokenizeSort } from "../project/project.js";
+/**
+ * The scout backlog: places where an LLM call, a hand-written heuristic or an
+ * agent fan-out is doing a decision model's job. The `scout` skill decides what
+ * counts; this module validates and persists it, so the backlog is a typed
+ * artifact rather than prose in a transcript. Every saving in it is projected
+ * (arithmetic over the inputs shown beside it), never measured.
+ */
+export const BACKLOG_FORMAT = 1;
+const CLOSED = { additionalProperties: false };
+const Text = Type.String({ minLength: 1 });
+/** Bounded so the computed saving is always a finite number that survives JSON. */
+const Usd = Type.Number({ minimum: 0, maximum: 1e6 });
+const Status = Type.Union([
+    Type.Literal("new"),
+    Type.Literal("stale"),
+    Type.Literal("adopted"),
+    Type.Literal("rejected"),
+]);
+const candidateFields = {
+    /** `code`: a codebase (Mode A). `agents`: skills, hooks, agent configuration (Mode B). */
+    mode: Type.Union([Type.Literal("code"), Type.Literal("agents")]),
+    location: Type.Object({
+        path: Text,
+        lines: Type.Optional(Type.Object({ start: Type.Integer({ minimum: 1 }), end: Type.Integer({ minimum: 1 }) }, CLOSED)),
+    }, CLOSED),
+    /** What does the job today, e.g. "gpt-4o call parsed to an enum". */
+    mechanism: Text,
+    shape: Type.Union([
+        Type.Literal("single"),
+        Type.Literal("fanout"),
+        Type.Literal("cascade"),
+        Type.Literal("pairwise"),
+    ]),
+    /**
+     * The text that triggered it, taken verbatim from the screened item. The id is
+     * derived from it, so it must be copied, not paraphrased.
+     */
+    evidence: Type.String({ pattern: "\\S" }),
+    /** A draft question set that would replace the mechanism. */
+    questions: Type.Record(Type.String(), QuestionSchema, { minProperties: 1 }),
+    /**
+     * What replacing the mechanism would mainly buy. `cost`: cheaper calls.
+     * `quality`: better or more consistent verdicts (a regex or heuristic that
+     * costs nothing today, so its `savingUsd` can be negative). `latency`:
+     * faster answers. Rank within a benefit, not across them.
+     */
+    benefit: Type.Union([Type.Literal("cost"), Type.Literal("quality"), Type.Literal("latency")]),
+    /** The inputs of the projected saving. The saving itself is computed here. */
+    projected: Type.Object({
+        volume: Type.Number({ minimum: 0, maximum: 1e12 }),
+        /** What `volume` counts per, e.g. "day", "PR", "run". */
+        per: Text,
+        currentCostPerItemUsd: Usd,
+        decisionCostPerItemUsd: Usd,
+        /** Where the figures came from. */
+        note: Type.Optional(Type.String()),
+    }, CLOSED),
+    risk: Type.Object({
+        level: Type.Union([Type.Literal("low"), Type.Literal("medium"), Type.Literal("high")]),
+        /** What would go wrong if the replacement erred. */
+        note: Text,
+    }, CLOSED),
+    /** The next step, e.g. "save the spec with design, then adopt". */
+    next: Text,
+    /** Defaults to `new`. `rejected` needs a `statusReason`. */
+    status: Type.Optional(Status),
+    statusReason: Type.Optional(Text),
+    /** Which sweep produced it, and whether its screening answers were live or replayed. */
+    source: Type.Object({
+        sweep: Text,
+        answers: Type.Union([Type.Literal("live"), Type.Literal("replay")]),
+    }, CLOSED),
+};
+export const CandidateSchema = Type.Object(candidateFields, CLOSED);
+export const OpportunitySchema = Type.Object({
+    id: Type.String({ pattern: "^op-[0-9a-f]{12}$" }),
+    ...candidateFields,
+    status: Status,
+    projected: Type.Object({
+        ...candidateFields.projected.properties,
+        basis: Type.Literal("projected"),
+        /** volume × (current − decision), per `per`. Negative means it would cost more. */
+        savingUsd: Type.Number(),
+    }, CLOSED),
+    firstSeenAt: Type.String(),
+    seenAt: Type.String(),
+}, CLOSED);
+export const BacklogSchema = Type.Object({
+    version: Type.Literal(BACKLOG_FORMAT),
+    opportunities: Type.Array(OpportunitySchema),
+}, CLOSED);
+export function backlogPath(repoRoot) {
+    return join(stateDir(repoRoot), "opportunities.json");
+}
+/**
+ * Stable across re-runs and file moves: the mode and the evidence, with
+ * whitespace collapsed. Not the path (a moved file keeps its id) and nothing
+ * the agent paraphrases.
+ */
+export function opportunityId(mode, evidence) {
+    const normal = evidence.replace(/\s+/g, " ").trim();
+    return `op-${createHash("sha256").update(`${mode}\n${normal}`).digest("hex").slice(0, 12)}`;
+}
+export function projectedSaving(p) {
+    return round(p.volume * (p.currentCostPerItemUsd - p.decisionCostPerItemUsd));
+}
+/** Every problem with a backlog value, as `path message` lines. Empty when valid. */
+export function backlogProblems(value) {
+    const problems = [...Value.Errors(BacklogSchema, value)].map((e) => `${e.instancePath || "/"} ${e.message}`);
+    if (problems.length)
+        return problems;
+    const backlog = value;
+    const seen = new Set();
+    backlog.opportunities.forEach((o, i) => {
+        if (seen.has(o.id))
+            problems.push(`/opportunities/${i}/id ${o.id} appears twice`);
+        seen.add(o.id);
+        if (o.id !== opportunityId(o.mode, o.evidence)) {
+            problems.push(`/opportunities/${i}/id does not match its mode and evidence`);
+        }
+        if (o.projected.savingUsd !== projectedSaving(o.projected)) {
+            problems.push(`/opportunities/${i}/projected/savingUsd does not match its inputs`);
+        }
+        problems.push(...candidateProblems(o, `/opportunities/${i}`));
+    });
+    return problems;
+}
+/** The checks a schema can't express. */
+function candidateProblems(c, at) {
+    const problems = [];
+    if (c.status === "rejected" && !c.statusReason) {
+        problems.push(`${at}/statusReason is required when status is rejected`);
+    }
+    if (!Number.isFinite(projectedSaving(c.projected))) {
+        problems.push(`${at}/projected gives a saving that isn't a finite number`);
+    }
+    if (c.location.lines && c.location.lines.end < c.location.lines.start) {
+        problems.push(`${at}/location/lines end is before start`);
+    }
+    try {
+        assertQuestionSet(c.questions);
+    }
+    catch (error) {
+        problems.push(`${at}/questions ${error.message}`);
+    }
+    return problems;
+}
+/**
+ * Read the backlog. A missing file is an empty backlog; a malformed one is an
+ * error, and is never repaired or overwritten.
+ */
+export function readBacklog(file) {
+    if (!existsSync(file))
+        return { version: BACKLOG_FORMAT, opportunities: [] };
+    let text;
+    try {
+        text = readFileSync(file, "utf8");
+    }
+    catch (error) {
+        throw malformed(file, [`cannot read it: ${error.message}`]);
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        throw malformed(file, [`not JSON: ${error.message}`]);
+    }
+    const problems = backlogProblems(value);
+    if (problems.length)
+        throw malformed(file, problems);
+    return value;
+}
+function malformed(file, problems) {
+    return new DecisionsError("invalid-request", `${file} is not a valid backlog (it was left as it is):\n  ${problems.join("\n  ")}`, { file, problems });
+}
+const LOCK_WAIT_MS = 5_000;
+const LOCK_STALE_MS = 30_000;
+/**
+ * Run `body` holding the backlog's lock, so concurrent `add`s (two sweeps, or
+ * a sweep run in parallel) serialise instead of losing each other's entries.
+ * A lock older than 30 s is from a crashed run and is taken over.
+ */
+export function withBacklogLock(file, body) {
+    mkdirSync(dirname(file), { recursive: true });
+    const lock = `${file}.lock`;
+    const deadline = Date.now() + LOCK_WAIT_MS;
+    for (;;) {
+        try {
+            closeSync(openSync(lock, "wx"));
+            break;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            try {
+                if (Date.now() - statSync(lock).mtimeMs > LOCK_STALE_MS)
+                    rmSync(lock, { force: true });
+            }
+            catch { }
+            if (Date.now() > deadline) {
+                throw new DecisionsError("invalid-request", `${file} is locked by another \`decide opportunities add\` (${lock}). Retry, or delete the lock file if no add is running.`, { file, lock });
+            }
+            Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 25);
+        }
+    }
+    try {
+        return body();
+    }
+    finally {
+        rmSync(lock, { force: true });
+    }
+}
+/** Written whole, through a temp file, so a crash never leaves half a backlog. */
+export function writeBacklog(file, backlog) {
+    mkdirSync(dirname(file), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    writeFileSync(tmp, `${JSON.stringify(backlog, null, 2)}\n`);
+    renameSync(tmp, file);
+}
+/**
+ * Merge candidates into a backlog.
+ *
+ * - A candidate whose id exists updates that entry (location, draft, figures,
+ *   `seenAt`), keeping `firstSeenAt`. Its status changes only when the
+ *   candidate gives one, so a rejection survives a re-sweep.
+ * - A new id is added with status `new` unless the candidate says otherwise.
+ * - A `new` entry that this add's sweep produced before, at a path the add
+ *   covers, in the same mode, and that the add didn't see again is marked
+ *   `stale`: its evidence changed. It is never deleted. A stale entry seen again
+ *   is `new` again.
+ */
+export function mergeCandidates(backlog, candidates, now) {
+    const problems = candidates.flatMap((c, i) => candidateProblems(c, `/candidates/${i}`));
+    if (problems.length) {
+        throw new DecisionsError("invalid-request", `Invalid candidates:\n  ${problems.join("\n  ")}`, {
+            problems,
+        });
+    }
+    const byId = new Map(backlog.opportunities.map((o) => [o.id, o]));
+    const existed = new Set(byId.keys());
+    const seen = new Set();
+    for (const { statusReason: reason, ...c } of candidates) {
+        const id = opportunityId(c.mode, c.evidence);
+        seen.add(id);
+        const before = byId.get(id);
+        // A new status replaces the old reason; no status keeps both.
+        const statusReason = reason ?? (c.status ? undefined : before?.statusReason);
+        byId.set(id, {
+            id,
+            ...c,
+            // Seeing the evidence again disproves "stale"; any other status stands.
+            status: c.status ?? (before?.status === "stale" ? "new" : before?.status) ?? "new",
+            ...(statusReason ? { statusReason } : {}),
+            projected: { ...c.projected, basis: "projected", savingUsd: projectedSaving(c.projected) },
+            firstSeenAt: before?.firstSeenAt ?? now,
+            seenAt: now,
+        });
+    }
+    const added = [...seen].filter((id) => !existed.has(id));
+    const updated = [...seen].filter((id) => existed.has(id));
+    // Coverage is per sweep: another sweep's entries at the same path (different
+    // questions, or an incremental add) are not disproved by this one.
+    const key = (o) => `${o.mode}\n${o.location.path}\n${o.source.sweep}`;
+    const covered = new Set(candidates.map(key));
+    const staled = [];
+    for (const o of byId.values()) {
+        if (o.status === "new" && !seen.has(o.id) && covered.has(key(o))) {
+            byId.set(o.id, { ...o, status: "stale" });
+            staled.push(o.id);
+        }
+    }
+    return {
+        backlog: { version: BACKLOG_FORMAT, opportunities: [...byId.values()] },
+        added,
+        updated,
+        staled,
+    };
+}
+/**
+ * Fields a record filter or sort may name: the sub-fields each object field
+ * has, and the one a bare name means. Checked statically, so a typo is an
+ * error even on an empty backlog.
+ */
+const FIELDS = {
+    id: {},
+    mode: {},
+    benefit: {},
+    status: {},
+    statusReason: {},
+    shape: {},
+    mechanism: {},
+    evidence: {},
+    next: {},
+    firstSeenAt: {},
+    seenAt: {},
+    risk: { default: "level", subs: ["level", "note"] },
+    projected: {
+        default: "savingUsd",
+        subs: [
+            "savingUsd",
+            "volume",
+            "per",
+            "currentCostPerItemUsd",
+            "decisionCostPerItemUsd",
+            "basis",
+            "note",
+        ],
+    },
+    location: { default: "path", subs: ["path", "lines.start", "lines.end"] },
+    source: { default: "sweep", subs: ["sweep", "answers"] },
+};
+/** Top-level fields of an entry, for `--fields`. */
+export const ENTRY_FIELDS = [...Object.keys(OpportunitySchema.properties)];
+/** `status=new`, `risk in medium,high`, `projected>=0.5`, `location.path=src/a.ts`. */
+export function parseRecordFilter(text) {
+    const t = tokenizeFilter(text);
+    if (!t) {
+        throw new DecisionsError("invalid-request", `Cannot parse --keep "${text}". Use <field>[.<sub>]<op><value>, e.g. status=new or projected>=0.01`);
+    }
+    const field = recordField(t.name, t.path, text);
+    if ((t.op === ">" || t.op === ">=" || t.op === "<" || t.op === "<=") &&
+        typeof t.value !== "number") {
+        throw new DecisionsError("invalid-request", `--keep "${text}": ${t.op} needs a number`);
+    }
+    return { field, op: t.op, value: t.value, source: text };
+}
+export function parseRecordSort(text) {
+    const t = tokenizeSort(text);
+    if (!t) {
+        throw new DecisionsError("invalid-request", `Cannot parse --sort "${text}". Use <field>[.<sub>][:asc|desc]`);
+    }
+    return { field: recordField(t.name, t.path, text), direction: t.direction };
+}
+function recordField(name, path, text) {
+    const spec = Object.hasOwn(FIELDS, name) ? FIELDS[name] : undefined;
+    if (!spec) {
+        throw new DecisionsError("invalid-request", `"${text}": no field "${name}". Fields: ${Object.keys(FIELDS).join(", ")}`);
+    }
+    if (path && !spec.subs?.includes(path)) {
+        throw new DecisionsError("invalid-request", spec.subs
+            ? `"${text}": ${name} has no "${path}". Use one of: ${spec.subs.join(", ")}`
+            : `"${text}": ${name} has no sub-fields`);
+    }
+    const sub = path || spec.default;
+    return sub ? `${name}.${sub}` : name;
+}
+export function readField(o, field) {
+    let value = o;
+    for (const key of field.split(".")) {
+        if (value === null || typeof value !== "object")
+            return undefined;
+        value = value[key];
+    }
+    return value;
+}
+export function recordMatches(o, f) {
+    const actual = readField(o, f.field);
+    switch (f.op) {
+        case "in":
+            return f.value.includes(String(actual));
+        case "=":
+            return String(actual) === String(f.value);
+        case "!=":
+            return String(actual) !== String(f.value);
+        default: {
+            if (typeof actual !== "number")
+                return false;
+            const v = f.value;
+            return f.op === ">="
+                ? actual >= v
+                : f.op === ">"
+                    ? actual > v
+                    : f.op === "<="
+                        ? actual <= v
+                        : actual < v;
+        }
+    }
+}
+function round(n) {
+    return Math.round(n * 1e9) / 1e9;
+}
+//# sourceMappingURL=backlog.js.map

package/dist/opportunities/backlog.js.map

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

package/dist/prepare.d.ts

@@ -12,9 +12,17 @@ export interface PrepareInput {
     cwd: string;
     /** Extra exclude patterns from config. */
     exclude?: readonly string[];
+    /** Paths the caller asked to leave out (`--exclude`), reported as `filtered`. */
+    filter?: readonly string[];
     maxFileBytes?: number;
     /** Allow content from outside the repo (off by default). */
     allowOutside?: boolean;
+    /**
+     * `skip`: an item over the model's size limit is reported in `skipped` as
+     * `too-large`, with the fix in `detail`, and the rest go ahead. A fan-out
+     * wants this; `ask`, which has one item, keeps the error (`throw`, the default).
+     */
+    oversize?: "throw" | "skip";
 }
 export interface Prepared {
     /** Ready to send: excluded, scrubbed and size-checked. */

package/dist/prepare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../src/prepare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,mBAAmB,CAAA;AAG3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,kBAAkB,CAAA;AAE1D,OAAO,EAAE,KAAK,UAAU,EAAW,MAAM,iBAAiB,CAAA;AAE1D,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAAa,KAAK,SAAS,EAAS,MAAM,kBAAkB,CAAA;AAEnE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IAC9B,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,WAAW,CAAA;IACtB,OAAO,EAAE,YAAY,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,0DAA0D;IAC1D,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,2EAA2E;IAC3E,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,uEAAuE;IACvE,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACjE,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4DpE"}
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../src/prepare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,mBAAmB,CAAA;AAG3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,kBAAkB,CAAA;AAE1D,OAAO,EAAE,KAAK,UAAU,EAAW,MAAM,iBAAiB,CAAA;AAG1D,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAAa,KAAK,SAAS,EAAS,MAAM,kBAAkB,CAAA;AAEnE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IAC9B,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,WAAW,CAAA;IACtB,OAAO,EAAE,YAAY,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,iFAAiF;IACjF,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,0DAA0D;IAC1D,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,2EAA2E;IAC3E,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,uEAAuE;IACvE,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACjE,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkFpE"}

package/dist/prepare.js

@@ -1,9 +1,10 @@
 import { applyExcludes } from "./egress/exclude.js";
 import { scrubState, scrubText } from "./egress/scrub.js";
 import { assertStateFits } from "./egress/size.js";
-import { DecisionsError } from "./errors.js";
+import { DecisionsError, isDecisionsError } from "./errors.js";
 import { assertQuestionSet } from "./model/validate.js";
 import { project } from "./run/budget.js";
+import { applyFilter } from "./sources/filter.js";
 import { readSources } from "./sources/read.js";
 import { joinItems, split } from "./split/split.js";
 /**
@@ -19,6 +20,7 @@ export async function prepare(input) {
         cwd: input.cwd,
         ...(input.maxFileBytes ? { maxFileBytes: input.maxFileBytes } : {}),
         ...(input.allowOutside ? { allowOutside: true } : {}),
+        ...(input.filter?.length ? { filter: input.filter, withhold: input.exclude ?? [] } : {}),
     });
     const byKind = {};
     /** How many documents or items had at least one redaction. */
@@ -32,9 +34,12 @@ export async function prepare(input) {
     // Excluded files are dropped before anything else touches them, so a
     // withheld file is never reported as scrubbed.
     const allowed = applyExcludes(read.documents, input.exclude);
+    // Then what the caller left out. Globs were filtered before reading; this
+    // catches files, diffs and rows. After egress, so a secret is never `filtered`.
+    const chosen = applyFilter(allowed.items, input.filter);
     // Then scrub whole documents: a private key cut across two line windows
     // would otherwise lose the markers that identify it.
-    const documents = allowed.items.map((doc) => {
+    const documents = chosen.items.map((doc) => {
         const counts = {};
         const scrubbed = {
             ...doc,
@@ -51,17 +56,37 @@ export async function prepare(input) {
     // Then each item again, so anything the split produced (a join, a row read
     // as a value) is covered too.
     const tokens = [];
-    const items = kept.map((item) => {
+    const oversize = [];
+    const items = kept.flatMap((item) => {
         const counts = {};
         const state = scrubState(item.state, counts);
         if (count(counts) > 0)
             redactedSources += 1;
-        tokens.push(assertStateFits(item.id, state, input.questions, input.profile));
-        return { ...item, state };
+        try {
+            tokens.push(assertStateFits(item.id, state, input.questions, input.profile));
+        }
+        catch (error) {
+            if (input.oversize !== "skip" || !isDecisionsError(error))
+                throw error;
+            const estimated = error.details.estimatedTokens;
+            oversize.push({
+                path: item.path ?? item.id,
+                reason: "too-large",
+                detail: `about ${estimated} tokens with its questions (limit ${input.profile.maxStateTokens}); re-run it with --split lines:400/40`,
+            });
+            return [];
+        }
+        return [{ ...item, state }];
     });
     return {
         items,
-        skipped: [...read.skipped, ...allowed.excluded, ...filtered.excluded],
+        skipped: unique([
+            ...read.skipped,
+            ...allowed.excluded,
+            ...chosen.filtered,
+            ...filtered.excluded,
+            ...oversize,
+        ]),
         redactions: {
             total: Object.values(byKind).reduce((a, b) => a + b, 0),
             byKind,
@@ -81,4 +106,15 @@ function assertChoicesFit(questions, profile) {
         }
     }
 }
+/** One entry per path and reason: a glob and a `--file` can name the same path. */
+function unique(skipped) {
+    const seen = new Set();
+    return skipped.filter((s) => {
+        const key = `${s.path}\0${s.reason}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
 //# sourceMappingURL=prepare.js.map

package/dist/prepare.js.map

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

package/dist/project/project.d.ts

@@ -19,6 +19,24 @@ export interface SortKey {
     field: string;
     direction: "asc" | "desc";
 }
+/**
+ * The `--keep` grammar, shared by answer filters and record filters
+ * (`decide opportunities list`): `<name>[.<path>]<op><value>`.
+ */
+export interface FilterTokens {
+    name: string;
+    /** The dotted path after the name, without the leading dot; "" when absent. */
+    path: string;
+    op: Op;
+    value: number | string | string[];
+}
+export declare function tokenizeFilter(text: string): FilterTokens | undefined;
+/** The `--sort` grammar: `<name>[.<path>][:asc|desc]`. */
+export declare function tokenizeSort(text: string): {
+    name: string;
+    path: string;
+    direction: "asc" | "desc";
+} | undefined;
 /** Parse `relevant>=0.7`, `kind=fix`, `kind in fix,feature`, `kind.probabilities.fix>=0.5`. */
 export declare function parseFilter(text: string, questions?: QuestionSet): Filter;
 /** Parse `relevant`, `relevant.noul:asc`, `risk.score:desc`. Defaults to descending. */
@@ -29,6 +47,8 @@ export interface ProjectInput<T extends {
 }> {
     rows: readonly T[];
     keep?: readonly Filter[];
+    /** Kept when any of these matches (and every `keep` does). */
+    keepAny?: readonly Filter[];
     sort?: SortKey;
     limit?: number;
     fields?: readonly string[];
@@ -46,6 +66,22 @@ export interface Projected<T> {
     }>;
     dropped: number;
 }
+export interface Verdict {
+    verdict: "kept" | "dropped" | "undecided";
+    /** For `undecided`: the questions whose flat answers could change the outcome. */
+    questions: string[];
+}
+/**
+ * One row's verdict under `keep` (all must match) and `keepAny` (at least one
+ * must match).
+ *
+ * A flat answer on a `keep` or `sort` question makes the row undecided, as
+ * before. A flat `keepAny` answer only does when it could change the outcome:
+ * if a decided `keepAny` filter already matches, the row is kept; if none
+ * matches and none is flat, it is dropped. With no filters and no sort, every
+ * question counts.
+ */
+export declare function verdictOf(answers: Answers, flat: readonly string[], keep: readonly Filter[], keepAny?: readonly Filter[], sortQuestion?: string): Verdict;
 /**
  * Split rows into kept / undecided / dropped.
  *

package/dist/project/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project/project.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAU,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAErE;;;;GAIG;AAEH,MAAM,MAAM,EAAE,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAA;AAE5D,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,EAAE,CAAA;IACN,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;IACjC,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAC1B;AAID,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,CA2BzE;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,OAAO,CAWxE;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAqBjE;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE;IAC1D,IAAI,EAAE,SAAS,CAAC,EAAE,CAAA;IAClB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,6CAA6C;IAC7C,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,CAAA;CAC3C;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,SAAS,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACjD,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CA2B5F"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project/project.ts"],"names":[],"mappings":"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"}