@ozzylabs/feedradar 0.1.6 → 0.1.8

package/dist/core/triage/adapter.d.ts

@@ -0,0 +1,80 @@
+import type { AgentId } from "../../schemas/research.js";
+/**
+ * Triage channel adapter (ADR-0018 §W4 / §W-E-2).
+ *
+ * Separated from `src/agents/AgentAdapter` (research / review / update) on
+ * purpose: the triage prompt shape is different (JSON response, no file
+ * writes), and folding it into the existing interface would either pollute
+ * the contract or force per-adapter `triage()` no-ops. ADR-0018 §W4
+ * recommends "別 channel" so this module owns the triage spawn.
+ *
+ * Defaults shell out to the same agent CLIs (`claude`, `codex`, `gemini`,
+ * `copilot`). Tests inject `TriageRunner` instead of spawning a real CLI.
+ *
+ * Rate-limit policy (W-E-2):
+ *
+ * The runner classifies its return value into one of `ok` / `rate-limited`
+ * / `error` so the orchestrator can apply per-class retry policy:
+ *
+ * - `ok`: agent returned 0 exit, stdout has the JSON array — bubble up.
+ * - `rate-limited`: agent stderr / stdout looks like 429 / 503 — exponential
+ *   backoff (1s, 2s, 4s, ... cap 60s, max 3 retries). After exhaustion,
+ *   the orchestrator demotes affected items to `triaged_unsure` with reason
+ *   `"rate-limited"`.
+ * - `error`: any other non-zero exit — bubble up to the orchestrator which
+ *   applies the global fallback path (all items → `triaged_unsure`,
+ *   `fallback: true`).
+ *
+ * The 429 / 503 classifier is intentionally permissive (substring match on
+ * the error text). Cheap-model CLIs format rate-limit errors in
+ * idiosyncratic ways (HTTP status code in JSON envelope, plain "Too Many
+ * Requests" in stderr, etc.) and a precise regex would miss variants
+ * silently — false positives here just trigger a backoff retry, which is
+ * harmless.
+ */
+export interface TriageRunInput {
+    agent: AgentId;
+    prompt: string;
+    cwd: string;
+}
+export type TriageRunStatus = "ok" | "rate-limited" | "error";
+export interface TriageRunResult {
+    status: TriageRunStatus;
+    /** Raw agent stdout (used for JSON extraction on `ok`, debug on others). */
+    stdout: string;
+    /** Raw agent stderr (used for error reporting + rate-limit classification). */
+    stderr: string;
+    /** Exit code from the spawned CLI; `0` on `ok`, non-zero otherwise. */
+    exitCode: number;
+}
+/**
+ * Function shape for the agent-CLI runner. The default implementation
+ * shells out to the real `claude` / `codex` / `gemini` / `copilot` CLIs.
+ * Tests inject a fake so end-to-end coverage does not require an
+ * authenticated CLI on PATH.
+ */
+export type TriageRunner = (input: TriageRunInput) => Promise<TriageRunResult>;
+/**
+ * Cheap heuristic that flags a CLI failure as rate-limited.
+ *
+ * Exported so the orchestrator (`index.ts`) and tests can rely on the same
+ * classifier. Matches on substrings rather than exact codes because the
+ * cheap-model CLIs format rate-limit errors inconsistently — they all
+ * include one of the listed needles somewhere in stdout / stderr.
+ */
+export declare function looksLikeRateLimit(text: string): boolean;
+/**
+ * Default runner: spawn the per-agent CLI and capture stdout / stderr.
+ *
+ * Returns `{ status: "ok" }` only on exit code 0. Non-zero exit triggers
+ * the rate-limit classifier; if the heuristic matches, we surface
+ * `rate-limited` so the orchestrator's exponential backoff can engage,
+ * otherwise we surface `error` so the global fallback path runs.
+ *
+ * `ENOENT` (CLI not on PATH) propagates as `{ status: "error" }` rather
+ * than a thrown exception so the orchestrator's fallback path handles it
+ * the same way as any other CLI failure — triage shouldn't kill the
+ * workflow just because the user hasn't installed an optional CLI.
+ */
+export declare function runTriageAgentCli(input: TriageRunInput): Promise<TriageRunResult>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/core/triage/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/core/triage/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,cAAc,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAE/E;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAcxD;AAgDD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CA2CvF"}

package/dist/core/triage/adapter.js

@@ -0,0 +1,128 @@
+import { spawn } from "node:child_process";
+/**
+ * Cheap heuristic that flags a CLI failure as rate-limited.
+ *
+ * Exported so the orchestrator (`index.ts`) and tests can rely on the same
+ * classifier. Matches on substrings rather than exact codes because the
+ * cheap-model CLIs format rate-limit errors inconsistently — they all
+ * include one of the listed needles somewhere in stdout / stderr.
+ */
+export function looksLikeRateLimit(text) {
+    const haystack = text.toLowerCase();
+    return [
+        "429",
+        "rate limit",
+        "rate-limit",
+        "rate_limited",
+        "too many requests",
+        "503",
+        "service unavailable",
+        "quota exceeded",
+        "resource_exhausted",
+        "resource exhausted",
+    ].some((needle) => haystack.includes(needle));
+}
+/**
+ * Per-agent CLI invocation matrix. The triage channel reuses the same
+ * binaries as the research channel (claude-code → `claude`, etc.) but with
+ * triage-specific flags:
+ *
+ * - All adapters pass the prompt as the first argument and read stdin for
+ *   the trigger to start (we keep stdin empty — the prompt itself contains
+ *   the full request because the response shape is just a JSON array, not a
+ *   file write).
+ * - We launch each CLI in the equivalent "non-interactive, full-permission"
+ *   mode that the research adapter uses, so the user does not need to
+ *   re-authorize tools. See the individual `src/agents/*.ts` files for the
+ *   rationale on each flag set.
+ *
+ * For the cheap-model channel intent (gemini-2.5-flash-lite,
+ * claude-haiku-4-5), the model selection is left to the agent CLI's own
+ * config — ADR-0018 §W4 explicitly leaves "which model the triage channel
+ * routes to" as adapter-internal, not schema-modeled. Users who want a
+ * specific cheap model set it via `gemini config set model …` (or
+ * equivalent) on their workstation.
+ */
+function buildSpawnArgs(agent, prompt) {
+    switch (agent) {
+        case "claude-code":
+            return {
+                command: "claude",
+                args: ["-p", prompt, "--output-format", "text", "--permission-mode", "bypassPermissions"],
+            };
+        case "gemini-cli":
+            return {
+                command: "gemini",
+                args: ["-p", prompt, "-y", "--skip-trust", "--output-format", "text"],
+            };
+        case "codex-cli":
+            return {
+                command: "codex",
+                args: ["exec", "--dangerously-bypass-approvals-and-sandbox", prompt],
+            };
+        case "copilot":
+            return {
+                command: "copilot",
+                args: ["-p", prompt, "--allow-all-paths", "--allow-all-tools"],
+            };
+    }
+}
+/**
+ * Default runner: spawn the per-agent CLI and capture stdout / stderr.
+ *
+ * Returns `{ status: "ok" }` only on exit code 0. Non-zero exit triggers
+ * the rate-limit classifier; if the heuristic matches, we surface
+ * `rate-limited` so the orchestrator's exponential backoff can engage,
+ * otherwise we surface `error` so the global fallback path runs.
+ *
+ * `ENOENT` (CLI not on PATH) propagates as `{ status: "error" }` rather
+ * than a thrown exception so the orchestrator's fallback path handles it
+ * the same way as any other CLI failure — triage shouldn't kill the
+ * workflow just because the user hasn't installed an optional CLI.
+ */
+export async function runTriageAgentCli(input) {
+    const { command, args } = buildSpawnArgs(input.agent, input.prompt);
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(command, args, { cwd: input.cwd, stdio: ["pipe", "pipe", "pipe"] });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            resolve({ status: "error", stdout: "", stderr: `spawn failed: ${message}`, exitCode: -1 });
+            return;
+        }
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", (err) => {
+            // ENOENT, EACCES, etc. — surface as `error` so the orchestrator's
+            // global fallback runs. Storing the formatted message in stderr lets
+            // the audit log capture what went wrong.
+            resolve({
+                status: "error",
+                stdout,
+                stderr: `${stderr}\nspawn error: ${err.message}`.trim(),
+                exitCode: -1,
+            });
+        });
+        child.on("close", (code) => {
+            const exitCode = code ?? 0;
+            if (exitCode === 0) {
+                resolve({ status: "ok", stdout, stderr, exitCode });
+                return;
+            }
+            const combined = `${stderr}\n${stdout}`;
+            const status = looksLikeRateLimit(combined) ? "rate-limited" : "error";
+            resolve({ status, stdout, stderr, exitCode });
+        });
+        // Close stdin immediately — the prompt is on argv, not stdin.
+        child.stdin?.end();
+    });
+}
+//# sourceMappingURL=adapter.js.map

package/dist/core/triage/adapter.js.map

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

package/dist/core/triage/index.d.ts

@@ -0,0 +1,105 @@
+import type { Item, TriageDecision } from "../../schemas/item.js";
+import type { SourceTriagePolicy } from "../../schemas/source.js";
+import { type TriageRunner } from "./adapter.js";
+/**
+ * Public API for the triage channel (ADR-0018 PR-2).
+ *
+ * `triageItems(items, options)` runs every supplied `detected` item through
+ * the configured agent CLI and returns a `Map<itemId, TriageDecision>`
+ * suitable for the PR-3 CLI to merge into `items/<id>.yaml > triage:`.
+ *
+ * The contract is:
+ *
+ * - **Every input item gets a decision.** Hallucinated ids, agent omission,
+ *   parse errors, and total fallbacks all resolve to `decision: "unsure"`
+ *   entries. The caller can rely on `result.decisions.size === items.length`
+ *   for the common case (we keep the invariant even when the agent omits
+ *   ids — the orchestrator fills the gap).
+ * - **`fallback: true` only when the agent itself failed end-to-end.** A
+ *   per-item demotion (low confidence, digest without group) is NOT a
+ *   fallback; only "agent CLI down, all items unsure" sets the flag.
+ * - **Soft-fail on rate limit (W-E-2).** Persistent 429 / 503 after
+ *   exponential backoff demotes affected items to `unsure` with reason
+ *   `"rate-limited"` rather than crashing the orchestrator. The workflow
+ *   continues so subsequent sources / commands run.
+ * - **Audit log (W-E-3).** When `auditLog` is supplied, the full request +
+ *   raw response + parsed decisions are appended as JSONL — one line per
+ *   triage call. Default off, so `radar triage` with no flag has the same
+ *   storage footprint as before.
+ */
+export interface TriageItemsOptions {
+    /** Per-source policy block. Drives prompt rules + confidence threshold. */
+    policy: SourceTriagePolicy;
+    /**
+     * Agent identifier to use for the triage call. Almost always `policy.agent`;
+     * exposed as a separate field so the CLI can override via
+     * `--agent <id>` for ad-hoc retries without mutating the source YAML.
+     */
+    agent: string;
+    /** Working directory for the spawned CLI. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /**
+     * Optional runner injection. Production code uses the default
+     * `runTriageAgentCli`; tests inject a fake so the suite does not depend
+     * on `claude` / `gemini` / `codex` / `copilot` being on PATH.
+     */
+    runner?: TriageRunner;
+    /**
+     * When set, raw request / response / parsed decisions are appended to
+     * this path as JSONL (one record per `triageItems()` call). Off by
+     * default — see ADR-0018 §W-E-3 for the storage-cost rationale.
+     */
+    auditLog?: string;
+    /** Override the ISO timestamp stamped on every decision. For test determinism. */
+    now?: () => string;
+    /**
+     * Maximum retry attempts for rate-limited (429 / 503) responses. Default
+     * 3 — matches ADR-0018 §W-E-2's recommendation. Each retry waits
+     * `min(initialDelayMs * 2^(attempt-1), maxDelayMs)`.
+     */
+    maxRetries?: number;
+    /** Initial backoff delay (ms). Default 1000. */
+    initialDelayMs?: number;
+    /** Backoff cap (ms). Default 60_000. */
+    maxDelayMs?: number;
+    /** Sleep override (ms → Promise). Defaults to `setTimeout`. Test seam. */
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface TriageResult {
+    /**
+     * One `TriageDecision` per input item, keyed by `item.id`. Includes items
+     * the agent omitted entirely (those carry `decision: "unsure"` + reason
+     * `"agent-omitted"`). Size equals `items.length` post-call.
+     */
+    decisions: Map<string, TriageDecision>;
+    /**
+     * `true` when the full-fallback path was hit (agent down, total parse
+     * failure, all retries exhausted with no usable entries). Per-item
+     * demotions (low confidence / hallucinated id) do NOT flip this flag.
+     */
+    fallback: boolean;
+    /**
+     * Free-form warnings for the operator. Mirrors the response parser's
+     * `warnings[]` plus orchestrator-level notes (retry exhaustion, audit
+     * log write failure, etc.).
+     */
+    errors: string[];
+}
+/**
+ * Triage the supplied items via the configured agent CLI.
+ *
+ * The function is the single entry point for PR-3's `radar triage` CLI and
+ * for any future caller (workflow generator, integration tests). It returns
+ * a `TriageResult` with one decision per input item plus a `fallback` flag
+ * and warning list.
+ *
+ * Empty input is handled as a no-op (no spawn) and returns
+ * `{ decisions: empty, fallback: false, errors: [] }` so callers can pass
+ * the result of a `filter()` chain without guarding for length.
+ */
+export declare function triageItems(items: Item[], options: TriageItemsOptions): Promise<TriageResult>;
+export { looksLikeRateLimit, runTriageAgentCli, type TriageRunInput, type TriageRunner, type TriageRunResult, type TriageRunStatus, } from "./adapter.js";
+export type { BuildTriagePromptOptions } from "./prompt.js";
+export { buildTriagePrompt } from "./prompt.js";
+export { type AgentEntry, type ParseTriageResponseResult, parseTriageResponse, TriageResponseParseError, type ValidatedTriageEntry, } from "./response.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/triage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/triage/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAqB,KAAK,YAAY,EAAwB,MAAM,cAAc,CAAC;AAI1F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,MAAM,EAAE,kBAAkB,CAAC;IAC3B;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA8FD;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA+KvB;AAED,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAI5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,yBAAyB,EAC9B,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC"}

package/dist/core/triage/index.js

@@ -0,0 +1,246 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { runTriageAgentCli } from "./adapter.js";
+import { buildTriagePrompt } from "./prompt.js";
+import { parseTriageResponse, TriageResponseParseError } from "./response.js";
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_INITIAL_DELAY_MS = 1_000;
+const DEFAULT_MAX_DELAY_MS = 60_000;
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function defaultNow() {
+    return new Date().toISOString();
+}
+/**
+ * Build a fallback `TriageDecision` for an item the agent did not classify
+ * (omission, hallucinated id rejected, parse failure, full fallback, etc.).
+ * Centralised so every fallback path stamps the same shape.
+ */
+function buildFallbackDecision(agent, reason, triagedAt) {
+    return {
+        decision: "unsure",
+        confidence: 0,
+        reason,
+        agent,
+        triagedAt,
+        feedback: [],
+    };
+}
+/**
+ * Append a JSONL audit record. Failures here are non-fatal: an unwritable
+ * audit log path should not kill the triage workflow. We surface the
+ * failure as a `result.errors[]` entry instead so the operator can see it
+ * in the CLI output.
+ */
+async function appendAuditLog(path, record) {
+    try {
+        await mkdir(dirname(path), { recursive: true });
+        await appendFile(path, `${JSON.stringify(record)}\n`, "utf8");
+        return undefined;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return `audit log write failed (${path}): ${message}`;
+    }
+}
+/**
+ * Invoke the agent runner with exponential-backoff retry on `rate-limited`
+ * results. Returns the final `TriageRunResult` (which may itself be
+ * `rate-limited` if every retry hit the cap) plus the number of attempts
+ * made (for the audit log).
+ */
+async function runWithRetry(runner, agent, prompt, cwd, maxRetries, initialDelayMs, maxDelayMs, sleep) {
+    let attempt = 0;
+    let result = {
+        status: "error",
+        stdout: "",
+        stderr: "no attempts",
+        exitCode: -1,
+    };
+    while (attempt <= maxRetries) {
+        attempt++;
+        result = await runner({ agent: agent, prompt, cwd });
+        if (result.status !== "rate-limited" || attempt > maxRetries) {
+            break;
+        }
+        const delay = Math.min(initialDelayMs * 2 ** (attempt - 1), maxDelayMs);
+        await sleep(delay);
+    }
+    return { result, attempts: attempt };
+}
+/**
+ * Triage the supplied items via the configured agent CLI.
+ *
+ * The function is the single entry point for PR-3's `radar triage` CLI and
+ * for any future caller (workflow generator, integration tests). It returns
+ * a `TriageResult` with one decision per input item plus a `fallback` flag
+ * and warning list.
+ *
+ * Empty input is handled as a no-op (no spawn) and returns
+ * `{ decisions: empty, fallback: false, errors: [] }` so callers can pass
+ * the result of a `filter()` chain without guarding for length.
+ */
+export async function triageItems(items, options) {
+    const errors = [];
+    const decisions = new Map();
+    const now = options.now ?? defaultNow;
+    const triagedAt = now();
+    const cwd = options.cwd ?? process.cwd();
+    const runner = options.runner ?? runTriageAgentCli;
+    const sleep = options.sleep ?? defaultSleep;
+    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    const initialDelayMs = options.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;
+    const maxDelayMs = options.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;
+    if (items.length === 0) {
+        return { decisions, fallback: false, errors };
+    }
+    const promptOptions = { items, policy: options.policy };
+    const prompt = buildTriagePrompt(promptOptions);
+    let runResult;
+    let attempts = 0;
+    try {
+        const retryOutcome = await runWithRetry(runner, options.agent, prompt, cwd, maxRetries, initialDelayMs, maxDelayMs, sleep);
+        runResult = retryOutcome.result;
+        attempts = retryOutcome.attempts;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        runResult = {
+            status: "error",
+            stdout: "",
+            stderr: `runner threw: ${message}`,
+            exitCode: -1,
+        };
+        attempts = 1;
+    }
+    // --- Failure paths ---------------------------------------------------
+    // Rate-limited after exhausting retries → soft-fail with per-item reason.
+    if (runResult.status === "rate-limited") {
+        errors.push(`triage agent persistently rate-limited after ${attempts} attempt(s); falling back to unsure (rate-limited)`);
+        for (const item of items) {
+            decisions.set(item.id, buildFallbackDecision(options.agent, "rate-limited", triagedAt));
+        }
+        if (options.auditLog) {
+            const auditErr = await appendAuditLog(options.auditLog, {
+                ts: triagedAt,
+                agent: options.agent,
+                attempts,
+                status: "rate-limited",
+                itemIds: items.map((i) => i.id),
+                request: prompt,
+                response: runResult.stdout,
+                stderr: runResult.stderr,
+                exitCode: runResult.exitCode,
+                fallback: true,
+                rateLimited: true,
+            });
+            if (auditErr)
+                errors.push(auditErr);
+        }
+        return { decisions, fallback: true, errors };
+    }
+    // Hard error (CLI down, non-zero exit unrelated to rate-limit, runner threw)
+    if (runResult.status === "error") {
+        const tail = (runResult.stderr || runResult.stdout || "(no output)").trim();
+        errors.push(`triage agent CLI failed (exit ${runResult.exitCode}): ${tail}`);
+        for (const item of items) {
+            decisions.set(item.id, buildFallbackDecision(options.agent, "agent CLI failure", triagedAt));
+        }
+        if (options.auditLog) {
+            const auditErr = await appendAuditLog(options.auditLog, {
+                ts: triagedAt,
+                agent: options.agent,
+                attempts,
+                status: "error",
+                itemIds: items.map((i) => i.id),
+                request: prompt,
+                response: runResult.stdout,
+                stderr: runResult.stderr,
+                exitCode: runResult.exitCode,
+                fallback: true,
+            });
+            if (auditErr)
+                errors.push(auditErr);
+        }
+        return { decisions, fallback: true, errors };
+    }
+    // --- Happy / partial path ---------------------------------------------
+    try {
+        const parsed = parseTriageResponse(runResult.stdout, items, options.policy);
+        errors.push(...parsed.warnings);
+        for (const item of items) {
+            const entry = parsed.entries.get(item.id);
+            if (entry === undefined) {
+                decisions.set(item.id, buildFallbackDecision(options.agent, "agent-omitted", triagedAt));
+                continue;
+            }
+            decisions.set(item.id, {
+                decision: entry.decision,
+                confidence: entry.confidence,
+                reason: entry.reason,
+                group: entry.group,
+                agent: options.agent,
+                triagedAt,
+                feedback: [],
+            });
+        }
+        if (options.auditLog) {
+            const auditErr = await appendAuditLog(options.auditLog, {
+                ts: triagedAt,
+                agent: options.agent,
+                attempts,
+                status: "ok",
+                itemIds: items.map((i) => i.id),
+                request: prompt,
+                response: runResult.stdout,
+                stderr: runResult.stderr,
+                exitCode: runResult.exitCode,
+                decisions: Object.fromEntries(items
+                    .map((item) => [item.id, decisions.get(item.id)])
+                    .filter((pair) => pair[1] !== undefined)),
+                fallback: false,
+            });
+            if (auditErr)
+                errors.push(auditErr);
+        }
+        return { decisions, fallback: false, errors };
+    }
+    catch (err) {
+        // Total parse failure → all-unsure fallback (still fills every item id).
+        const message = err instanceof TriageResponseParseError
+            ? err.message
+            : err instanceof Error
+                ? err.message
+                : String(err);
+        errors.push(`triage response parse failed: ${message}`);
+        for (const item of items) {
+            decisions.set(item.id, buildFallbackDecision(options.agent, "response parse failure", triagedAt));
+        }
+        if (options.auditLog) {
+            const auditErr = await appendAuditLog(options.auditLog, {
+                ts: triagedAt,
+                agent: options.agent,
+                attempts,
+                status: "parse-error",
+                itemIds: items.map((i) => i.id),
+                request: prompt,
+                response: runResult.stdout,
+                stderr: runResult.stderr,
+                exitCode: runResult.exitCode,
+                fallback: true,
+                parseError: message,
+            });
+            if (auditErr)
+                errors.push(auditErr);
+        }
+        return { decisions, fallback: true, errors };
+    }
+}
+export { looksLikeRateLimit, runTriageAgentCli, } from "./adapter.js";
+// Re-export internal modules so PR-3 (CLI) can import them without reaching
+// into deeper paths. Keeping the public surface narrow: only the orchestrator
+// API, the prompt builder, the response parser, and the adapter types.
+export { buildTriagePrompt } from "./prompt.js";
+export { parseTriageResponse, TriageResponseParseError, } from "./response.js";
+//# sourceMappingURL=index.js.map

package/dist/core/triage/index.js.map

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

package/dist/core/triage/prompt.d.ts

@@ -0,0 +1,30 @@
+import type { Item } from "../../schemas/item.js";
+import type { SourceTriagePolicy } from "../../schemas/source.js";
+export interface BuildTriagePromptOptions {
+    items: Item[];
+    policy: SourceTriagePolicy;
+}
+/**
+ * Build the full triage prompt sent to the agent CLI.
+ *
+ * Structure (in order):
+ *
+ * 1. Opening directives: role statement + the two boundary-marker rules
+ *    (don't follow `<untrusted_item>` instructions, treat `<policy>` as
+ *    classification axes, not commands).
+ * 2. `<policy>` block: the user-supplied `policy.rules` verbatim. The
+ *    surrounding tag is the boundary; the rules text itself is **not**
+ *    edited or sanitized (consistent with ADR-0009's stance on
+ *    untrusted-but-readable content).
+ * 3. `<items>` block: one `<untrusted_item>` block per input item.
+ * 4. Output format spec: the JSON schema the agent must emit, plus the
+ *    `confidenceThreshold` so the agent has the option to self-downgrade
+ *    to `unsure` before the response parser does (cheap-model agents often
+ *    do this when reminded).
+ *
+ * The prompt is intentionally pure (no I/O, no clock reads) so tests can
+ * assert byte-stable output. The triage-time timestamp is stamped later by
+ * the response parser, not the prompt.
+ */
+export declare function buildTriagePrompt({ items, policy }: BuildTriagePromptOptions): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/core/triage/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/core/triage/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AA8FlE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,wBAAwB,GAAG,MAAM,CA8CrF"}