jevctl 0.1.0 → 0.2.1

package/dist/commands/compact.js

@@ -0,0 +1,146 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { COMPACT_FAIL_CONDITIONS, compactFailed, runCompact } from "../core/compact.js";
+import { parseTranscript } from "../core/transcript.js";
+import { CliError, EXIT } from "../errors.js";
+import { readInput, readStdin } from "../input.js";
+import { parseFailOn, parseProbability } from "../lib.js";
+import { clip, emit, formatProbability, paint } from "../output.js";
+import { collectToolCalls, fitState, resolveOptions } from "../vendor/compaction/index.js";
+function int(name, raw, fallback, min = 0) {
+    if (raw === undefined)
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < min)
+        throw new CliError(`${name} must be an integer ≥ ${min}.`);
+    return n;
+}
+export function resolveCompactOptions(flags, ctx) {
+    const c = ctx.config.compact;
+    return {
+        goal: flags.goal,
+        keepThreshold: parseProbability("--keep-threshold", flags.keepThreshold, c.keepThreshold),
+        preserveRecentMessages: int("--preserve-recent", flags.preserveRecent, c.preserveRecent),
+        maxStateTokens: int("--max-state-tokens", flags.maxStateTokens, c.maxStateTokens, 1),
+        maxRequestTokens: int("--max-request-tokens", flags.maxRequestTokens, c.maxRequestTokens, 1),
+        truncateHeadChars: int("--truncate-head", flags.truncateHead, c.truncateHead),
+        minReduction: parseProbability("--min-reduction", flags.minReduction, c.minReduction),
+        failOn: parseFailOn(flags.failOn, COMPACT_FAIL_CONDITIONS, []),
+    };
+}
+export function loadTranscript(positional) {
+    let raw;
+    if (positional !== undefined)
+        raw = readInput(positional, "transcript");
+    else if (!process.stdin.isTTY)
+        raw = readStdin("transcript");
+    else
+        throw new CliError("Provide a transcript: @session.jsonl, @messages.json, or - for stdin.");
+    try {
+        return parseTranscript(raw);
+    }
+    catch (err) {
+        throw new CliError(err.message);
+    }
+}
+export async function compactAction(positional, flags, ctx) {
+    const { failOn, minReduction, ...options } = resolveCompactOptions(flags, ctx);
+    const transcript = loadTranscript(positional);
+    if (ctx.dryRun) {
+        const resolved = resolveOptions(options);
+        const calls = collectToolCalls(transcript.messages, resolved.preserveRecentMessages);
+        const candidates = calls.filter((c) => !c.pinned);
+        const fitted = candidates.length ? fitState(transcript.messages, calls, resolved) : null;
+        emit({ ...ctx.output, format: "json" }, {
+            model: ctx.config.model,
+            format: transcript.format,
+            messages: transcript.messages.length,
+            skipped_records: transcript.skipped,
+            tool_calls: calls.length,
+            candidates: candidates.length,
+            pinned: calls.length - candidates.length,
+            state_tokens: fitted?.tokens ?? 0,
+            state_stage: fitted?.stage ?? "",
+            state: fitted?.state ?? null,
+        }, () => ({}));
+        return EXIT.OK;
+    }
+    const output = await runCompact(ctx.ask(), { messages: transcript.messages, minReduction, ...options });
+    if (flags.out) {
+        const path = flags.out.startsWith("@") ? flags.out.slice(1) : flags.out;
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${JSON.stringify(output.messages, null, 2)}\n`, "utf8");
+    }
+    emit(ctx.output, flags.out ? { ...output, messages: undefined, messages_written_to: flags.out } : output, () => renderCompact(output, ctx, transcript.format, flags.out));
+    return compactFailed(output, failOn) ? EXIT.JUDGMENT : EXIT.OK;
+}
+export function renderCompact(out, ctx, format, wrote) {
+    const c = ctx.output.color;
+    const s = out.stats;
+    const pct = `${Math.round(out.reduction * 100)}%`;
+    const headline = out.worth_it
+        ? paint(c, ["bold", "green"], `${pct} smaller`)
+        : paint(c, ["bold", "yellow"], `${pct} smaller (below ${Math.round(out.min_reduction * 100)}% minimum)`);
+    const head = [
+        `${headline}  ${s.messagesBefore} → ${s.messagesAfter} messages · ${s.charsBefore.toLocaleString()} → ${s.charsAfter.toLocaleString()} chars`,
+        paint(c, "dim", `${s.calls} tool calls: ${s.kept} kept · ${s.resultsDropped} results truncated · ${s.callsDropped} calls dropped · ${s.pinned} pinned · state ~${s.stateTokens} tokens (${s.stateStage || "no request"}) in ${s.requests} request(s), ${s.ms} ms`),
+    ];
+    const decided = out.decisions.filter((d) => d.reason !== "pinned");
+    const style = (a) => a === "keep"
+        ? paint(c, "green", a)
+        : a === "drop_result"
+            ? paint(c, "yellow", "truncate")
+            : paint(c, "red", "drop");
+    const rows = decided.map((d) => [
+        d.id,
+        clip(d.tool, 14),
+        style(d.action),
+        formatProbability(d.keepCall),
+        formatProbability(d.keepResult),
+    ]);
+    return {
+        head,
+        table: decided.length ? { columns: ["Call", "Tool", "Action", "P(call)", "P(result)"], rows } : undefined,
+        tail: [
+            paint(c, "dim", wrote
+                ? `compacted messages written to ${wrote.replace(/^@/, "")} (${format} in, messages JSON out)`
+                : `add --out <file> to write the compacted messages (${format} in, messages JSON out)`),
+        ],
+        usage: { usage: out.usage, model: out.model, provider: out.provider },
+    };
+}
+export function registerCompact(program, run) {
+    program
+        .command("compact")
+        .description("Shrink an agent transcript without summarizing: Jev decides which old tool calls and results still matter; everything kept stays verbatim.")
+        .argument("[transcript]", "@session.jsonl (Claude Code), @messages.json, or - for stdin (default: stdin)")
+        .option("-g, --goal <text>", "the ongoing task, so Jev knows what still matters (default: the last three user prompts)")
+        .option("--keep-threshold <p>", "keep a call or result when Jev's probability is at least this (default 0.5)")
+        .option("--preserve-recent <n>", "newest messages never touched; the first message is always kept (default 6)")
+        .option("--max-state-tokens <n>", "estimated token budget for the history sent to Jev (default 25000)")
+        .option("--max-request-tokens <n>", "estimated budget for history plus one batch of questions (default 30000)")
+        .option("--truncate-head <n>", "characters of a dropped result to keep before the note (default 300)")
+        .option("--min-reduction <p>", "below this reduction ratio the result is flagged not worth applying (default 0.25)")
+        .option("-o, --out <path>", "write the compacted transcript (messages JSON) here")
+        .option("--fail-on <list>", "exit 2 when: low-reduction, or none (default none)")
+        .addHelpText("after", `
+Input formats:
+  Claude Code session log   ~/.claude/projects/<project>/<session>.jsonl (one record per line)
+  Messages JSON             [{"role","text","toolUses":[{"tool_use_id","tool","input"}],"toolResults":[{"tool_use_id","text"}]}]
+
+Text messages are never removed or shortened. Only tool calls and their results outside the pinned
+first and newest messages are candidates. A dropped result keeps its first --truncate-head chars plus a
+note; a dropped call disappears with its result. The assistant can always re-run a tool.
+
+Examples:
+  jev compact @~/.claude/projects/-me-repo/abc123.jsonl
+  jev compact @session.jsonl --goal "fix the flaky auth test" --out compacted.json --json
+  jev compact @messages.json --keep-threshold 0.6 --fail-on low-reduction
+
+In-session use: install the jev Claude Code plugin; its hook replaces Claude Code's compaction summary
+with this exact procedure. See plugin/hooks/README.md.`)
+        .action(async (transcript, flags, cmd) => {
+        await run((ctx) => compactAction(transcript, flags, ctx), cmd);
+    });
+}
+//# sourceMappingURL=compact.js.map

package/dist/commands/compact.js.map

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

package/dist/commands/config.d.ts

@@ -9,5 +9,6 @@ export declare function credentialReport(env: NodeJS.ProcessEnv): {
     CLOUDFLARE_ACCOUNT_ID: string | null;
     TYPESAFE_BASE_URL: string | null;
 };
-export declare function configShow(ctx: CommandContext, env: NodeJS.ProcessEnv): Promise<number>;
+/** `rawEnv` is the shell environment; `ctx.env` additionally holds stored credentials. */
+export declare function configShow(ctx: CommandContext, rawEnv: NodeJS.ProcessEnv): Promise<number>;
 export declare function registerConfig(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;

package/dist/commands/config.js

@@ -1,15 +1,15 @@
 import { existsSync, unlinkSync } from "node:fs";
 import { configPath, DEFAULT_CONFIG, readConfigFile, setConfigValue, writeConfigFile } from "../config.js";
+import { resolveCredentials } from "../credentials.js";
 import { CliError, EXIT } from "../errors.js";
-import { emit, paint, table } from "../output.js";
+import { emit, paint } from "../output.js";
 import { resolveProvider } from "../provider.js";
 /** Mask a secret to its first four and last two characters. */
 export function mask(secret) {
     if (!secret)
         return null;
-    if (secret.length <= 8)
-        return "*".repeat(secret.length);
-    return `${secret.slice(0, 4)}…${secret.slice(-2)}`;
+    // Show only the last four characters, regardless of source, so env and stored keys look alike.
+    return secret.length > 8 ? `…${secret.slice(-4)}` : "********";
 }
 export function credentialReport(env) {
     return {
@@ -20,7 +20,9 @@ export function credentialReport(env) {
         TYPESAFE_BASE_URL: env.TYPESAFE_BASE_URL ?? null,
     };
 }
-export async function configShow(ctx, env) {
+/** `rawEnv` is the shell environment; `ctx.env` additionally holds stored credentials. */
+export async function configShow(ctx, rawEnv) {
+    const env = ctx.env;
     const path = configPath(env);
     let resolved = null;
     let problem = null;
@@ -35,13 +37,13 @@ export async function configShow(ctx, env) {
         config_file_exists: existsSync(path),
         config: ctx.config,
         credentials: credentialReport(env),
+        credential_sources: Object.fromEntries(resolveCredentials(rawEnv).map((c) => [c.provider, c.source])),
         resolved_provider: resolved,
         problem,
     };
     emit(ctx.output, payload, () => {
         const c = ctx.output.color;
         const rows = [
-            ["Key", "Value"],
             ["config file", `${path}${payload.config_file_exists ? "" : paint(c, "dim", " (not present)")}`],
             ["provider", `${ctx.config.provider}${resolved ? paint(c, "dim", ` → ${resolved}`) : ""}`],
             ["model", ctx.config.model],
@@ -53,13 +55,28 @@ export async function configShow(ctx, env) {
                 "find.topK / found / absent",
                 `${ctx.config.find.topK} / ${ctx.config.find.found} / ${ctx.config.find.absent}`,
             ],
+            [
+                "classify.minConfidence / threshold",
+                `${ctx.config.classify.minConfidence} / ${ctx.config.classify.threshold}`,
+            ],
+            ["extract.minConfidence", String(ctx.config.extract.minConfidence)],
+            ["batch.concurrency", String(ctx.config.batch.concurrency)],
+            ["rerank.topK / min", `${ctx.config.rerank.topK} / ${ctx.config.rerank.min}`],
+            ["route.minConfidence", String(ctx.config.route.minConfidence)],
+            [
+                "compact.keepThreshold / preserveRecent / minReduction",
+                `${ctx.config.compact.keepThreshold} / ${ctx.config.compact.preserveRecent} / ${ctx.config.compact.minReduction}`,
+            ],
         ];
         for (const [k, v] of Object.entries(payload.credentials))
             rows.push([k, v ?? paint(c, "dim", "unset")]);
-        const lines = [table(rows, { color: c })];
-        if (problem)
-            lines.push("", paint(c, "yellow", problem));
-        return lines.join("\n");
+        for (const [k, v] of Object.entries(payload.credential_sources)) {
+            rows.push([`${k} key source`, v === "none" ? paint(c, "dim", "none (run: jev auth login)") : v]);
+        }
+        return {
+            table: { columns: ["Key", "Value"], rows },
+            tail: problem ? [paint(c, "yellow", problem)] : undefined,
+        };
     });
     return problem ? EXIT.ERROR : EXIT.OK;
 }

package/dist/commands/config.js.map

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

package/dist/commands/extract.d.ts

@@ -0,0 +1,18 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../context.js";
+import type { BatchItemRunner } from "../core/batch.js";
+import { type ExtractOutput, type FieldSpec } from "../core/extract.js";
+import { type View } from "../output.js";
+export interface ExtractFlags {
+    want?: string[];
+    context?: string;
+    minConfidence?: string;
+    failOn?: string;
+}
+export declare function resolveFields(flags: ExtractFlags): FieldSpec[];
+export declare function resolveExtractText(positional: string | undefined): string;
+export declare function extractAction(positional: string | undefined, flags: ExtractFlags, ctx: CommandContext): Promise<number>;
+export declare function renderExtract(out: ExtractOutput, ctx: CommandContext): View;
+/** Batch: each row's text is extracted with the shared field specs. */
+export declare function prepareExtractBatch(flags: ExtractFlags, ctx: CommandContext): BatchItemRunner;
+export declare function registerExtract(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;

package/dist/commands/extract.js

@@ -0,0 +1,108 @@
+import { BUILTIN_FIELDS, buildExtractRequest, EXTRACT_FAIL_CONDITIONS, extractFailed, parseFieldSpec, runExtract, } from "../core/extract.js";
+import { CliError, EXIT } from "../errors.js";
+import { readInput, readStdin } from "../input.js";
+import { parseFailOn, parseProbability } from "../lib.js";
+import { clip, emit, formatProbability, paint } from "../output.js";
+export function resolveFields(flags) {
+    const raw = flags.want ?? [];
+    if (raw.length === 0)
+        throw new CliError(`Provide at least one --want field. Builtins: ${Object.keys(BUILTIN_FIELDS).join(", ")}.`);
+    try {
+        // Allow comma-separated builtins in one flag: --want email,phone
+        return raw
+            .flatMap((entry) => entry.includes("=")
+            ? [entry]
+            : entry
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean))
+            .map(parseFieldSpec);
+    }
+    catch (err) {
+        throw new CliError(err.message);
+    }
+}
+export function resolveExtractText(positional) {
+    if (positional !== undefined)
+        return readInput(positional, "text");
+    if (process.stdin.isTTY)
+        throw new CliError("Provide text as an argument, @file, or pipe it on stdin.");
+    return readStdin("text");
+}
+export async function extractAction(positional, flags, ctx) {
+    const fields = resolveFields(flags);
+    const text = resolveExtractText(positional);
+    const minConfidence = parseProbability("--min-confidence", flags.minConfidence, ctx.config.extract.minConfidence);
+    const failOn = parseFailOn(flags.failOn, EXTRACT_FAIL_CONDITIONS, []);
+    if (ctx.dryRun) {
+        const { state, questions } = buildExtractRequest({ text, fields, context: flags.context });
+        emit({ ...ctx.output, format: "json" }, { model: ctx.config.model, state, questions }, () => ({}));
+        return EXIT.OK;
+    }
+    const output = await runExtract(ctx.ask(), { text, fields, context: flags.context, minConfidence });
+    emit(ctx.output, output, () => renderExtract(output, ctx));
+    return extractFailed(output, failOn) ? EXIT.JUDGMENT : EXIT.OK;
+}
+export function renderExtract(out, ctx) {
+    const c = ctx.output.color;
+    const rows = Object.entries(out.fields).map(([name, f]) => [
+        name,
+        f.value === null ? paint(c, "dim", "-") : paint(c, "green", clip(f.value, 40)),
+        f.normalized === null || f.normalized === undefined || f.normalized === f.value
+            ? ""
+            : clip(typeof f.normalized === "string" ? f.normalized : JSON.stringify(f.normalized), 30),
+        formatProbability(f.confidence),
+        f.action === "review"
+            ? paint(c, "yellow", f.action)
+            : f.action === "none"
+                ? paint(c, "dim", `none${f.reason ? ` (${f.reason})` : ""}`)
+                : "auto",
+        String(f.candidates),
+    ]);
+    return {
+        table: { columns: ["Field", "Value", "Normalized", "Conf", "Action", "Cands"], rows },
+        usage: { usage: out.usage, model: out.model, provider: out.provider },
+    };
+}
+/** Batch: each row's text is extracted with the shared field specs. */
+export function prepareExtractBatch(flags, ctx) {
+    const fields = resolveFields(flags);
+    const minConfidence = parseProbability("--min-confidence", flags.minConfidence, ctx.config.extract.minConfidence);
+    const failOn = parseFailOn(flags.failOn, EXTRACT_FAIL_CONDITIONS, []);
+    return async (row) => {
+        const output = await runExtract(ctx.ask(), {
+            text: row.text,
+            fields,
+            context: flags.context,
+            minConfidence,
+        });
+        return { output, failed: extractFailed(output, failOn) };
+    };
+}
+export function registerExtract(program, run) {
+    program
+        .command("extract")
+        .description("Pull values out of text without hallucination: regex finds candidates, Jev picks the right one, code normalizes it.")
+        .argument("[text]", "text to extract from, @file, or - for stdin (default: stdin)")
+        .option("-w, --want <field>", "field to extract (repeatable, or comma-separated builtins)", collect, [])
+        .option("-c, --context <text>", 'what the document is, e.g. "supplier invoice"; sharpens the questions')
+        .option("--min-confidence <p>", "confidence below which a value is flagged 'review' (default 0.6)")
+        .option("--fail-on <list>", `exit 2 when any field is: ${EXTRACT_FAIL_CONDITIONS.join(", ")}, or none (default none)`)
+        .addHelpText("after", `
+Fields:
+  Builtins: ${Object.keys(BUILTIN_FIELDS).join(", ")}
+  Custom:   name=/regex/            e.g. invoice=/INV-\\d+/
+            name=/regex/:description e.g. po=/PO\\s?\\d{6}/:the purchase order number
+            name=builtin:description e.g. "sender=email:the sender's address" (quote descriptions with spaces)
+
+Examples:
+  jev extract @invoice.txt --want amount,date --want invoice=/INV-\\d+/ --context "supplier invoice"
+  cat email.eml | jev extract --want "sender=email:the sender" --want "reply_by=date:the reply deadline" --json`)
+        .action(async (text, flags, cmd) => {
+        await run((ctx) => extractAction(text, flags, ctx), cmd);
+    });
+}
+function collect(value, previous) {
+    return [...previous, value];
+}
+//# sourceMappingURL=extract.js.map

package/dist/commands/extract.js.map

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

package/dist/commands/find.d.ts

@@ -1,6 +1,8 @@
 import type { Command } from "commander";
 import type { CommandContext } from "../context.js";
+import type { BatchItemRunner } from "../core/batch.js";
 import { type CandidateInput, type FindOutput } from "../core/find.js";
+import { type View } from "../output.js";
 export interface FindFlags {
     candidates?: string;
     files?: string[];
@@ -12,5 +14,7 @@ export interface FindFlags {
 }
 export declare function collectCandidates(flags: FindFlags): CandidateInput[];
 export declare function findAction(query: string, flags: FindFlags, ctx: CommandContext): Promise<number>;
-export declare function renderFind(out: FindOutput, ctx: CommandContext): string;
+export declare function renderFind(out: FindOutput, ctx: CommandContext): View;
 export declare function registerFind(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;
+/** Batch: each row is a query ranked against the shared candidates. */
+export declare function prepareFindBatch(flags: FindFlags, ctx: CommandContext): BatchItemRunner;

package/dist/commands/find.js

@@ -1,9 +1,9 @@
 import { statSync } from "node:fs";
 import { buildFindRequest, FIND_FAIL_CONDITIONS, findFailed, runFind, } from "../core/find.js";
 import { CliError, EXIT } from "../errors.js";
-import { nonEmptyLines, parseItems, readFile, readInput } from "../input.js";
+import { parseItems, readFile, readInput } from "../input.js";
 import { MAX_CANDIDATES, parseFailOn, parseProbability } from "../lib.js";
-import { clip, emit, formatProbability, paint, table, usageLine } from "../output.js";
+import { clip, emit, formatProbability, paint } from "../output.js";
 export function collectCandidates(flags) {
     const items = [];
     if (flags.candidates)
@@ -21,9 +21,13 @@ export function collectCandidates(flags) {
         items.push({ id: path, text: readFile(path, "candidate file") });
     }
     if (flags.lines) {
-        const lines = nonEmptyLines(readInput(flags.lines, "lines"));
-        lines.forEach((line, i) => {
-            items.push({ id: `L${i + 1}`, text: line });
+        // Ids are source line numbers (1-based, blank lines counted) so a hit can be found in the file.
+        readInput(flags.lines, "lines")
+            .split(/\r?\n/)
+            .forEach((raw, i) => {
+            const line = raw.trim();
+            if (line.length > 0)
+                items.push({ id: `L${i + 1}`, text: line });
         });
     }
     if (items.length === 0) {
@@ -44,7 +48,7 @@ export async function findAction(query, flags, ctx) {
     const failOn = parseFailOn(flags.failOn, FIND_FAIL_CONDITIONS, []);
     if (ctx.dryRun) {
         const { state, questions } = buildFindRequest({ query, candidates });
-        emit({ ...ctx.output, format: "json" }, { model: ctx.config.model, state, questions }, () => "");
+        emit({ ...ctx.output, format: "json" }, { model: ctx.config.model, state, questions }, () => ({}));
         return EXIT.OK;
     }
     const output = await runFind(ctx.ask(), { query, candidates, topK, found, absent });
@@ -64,14 +68,11 @@ export function renderFind(out, ctx) {
         hit.id,
         clip(hit.text, 60),
     ]);
-    const lines = [
-        `${verdict}  (exists ${formatProbability(out.exists)})  ${paint(c, "dim", out.query)}`,
-        "",
-        table([["#", "Prob", "Id", "Text"], ...rows], { color: c }),
-    ];
-    if (!ctx.output.quiet)
-        lines.push("", paint(c, "dim", usageLine(out.usage, out.model, out.provider)));
-    return lines.join("\n");
+    return {
+        head: [`${verdict}  (exists ${formatProbability(out.exists)})  ${paint(c, "dim", out.query)}`],
+        table: { columns: ["#", "Prob", "Id", "Text"], rows },
+        usage: { usage: out.usage, model: out.model, provider: out.provider },
+    };
 }
 export function registerFind(program, run) {
     program
@@ -80,7 +81,7 @@ export function registerFind(program, run) {
         .argument("<query>", "what you are looking for")
         .option("-c, --candidates <ref>", "JSON candidates (@file or -): array of strings, array of {id,text}, or {id: text}")
         .option("-f, --files <paths...>", "treat each file as a candidate (id = path)")
-        .option("-l, --lines <ref>", "treat each non-empty line of @file or - as a candidate (id = L<n>)")
+        .option("-l, --lines <ref>", "treat each non-empty line of @file or - as a candidate (id = L<line number>)")
         .option("-k, --top-k <n>", "how many ranked results to return (default 5)")
         .option("--found <p>", "exists probability at or above which the verdict is 'answered' (default 0.7)")
         .option("--absent <p>", "exists probability below which the verdict is 'absent' (default 0.35)")
@@ -94,4 +95,18 @@ Examples:
         await run((ctx) => findAction(query, flags, ctx), cmd);
     });
 }
+/** Batch: each row is a query ranked against the shared candidates. */
+export function prepareFindBatch(flags, ctx) {
+    const candidates = collectCandidates(flags);
+    const topK = flags.topK === undefined ? ctx.config.find.topK : Number(flags.topK);
+    if (!Number.isInteger(topK) || topK < 1 || topK > 50)
+        throw new CliError("--top-k must be an integer from 1 to 50.");
+    const found = parseProbability("--found", flags.found, ctx.config.find.found);
+    const absent = parseProbability("--absent", flags.absent, ctx.config.find.absent);
+    const failOn = parseFailOn(flags.failOn, FIND_FAIL_CONDITIONS, []);
+    return async (row) => {
+        const output = await runFind(ctx.ask(), { query: row.text, candidates, topK, found, absent });
+        return { output, failed: findFailed(output, failOn) };
+    };
+}
 //# sourceMappingURL=find.js.map

package/dist/commands/find.js.map

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

package/dist/commands/match.d.ts

@@ -0,0 +1,18 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../context.js";
+import { type MatchOutput, type MatchPair } from "../core/match.js";
+import { type View } from "../output.js";
+export interface MatchFlags {
+    pairs?: string;
+    left?: string;
+    right?: string;
+    dedupe?: string;
+    kind?: string;
+    failOn?: string;
+}
+/** Pairs JSON: array of [a, b] or {left, right}. */
+export declare function parsePairs(raw: string): MatchPair[];
+export declare function collectPairs(flags: MatchFlags): MatchPair[];
+export declare function matchAction(flags: MatchFlags, ctx: CommandContext): Promise<number>;
+export declare function renderMatch(out: MatchOutput, ctx: CommandContext): View;
+export declare function registerMatch(program: Command, run: (fn: (ctx: CommandContext) => Promise<number>, cmd: Command) => Promise<void>): void;