@ozzylabs/feedradar 0.1.6 → 0.1.7

package/dist/cli/triage.d.ts

@@ -0,0 +1,136 @@
+import { type TriageRunner } from "../core/triage/index.js";
+import type { Item } from "../schemas/item.js";
+import type { Command } from "./index.js";
+/**
+ * `radar triage` and `radar triage feedback` CLI implementations (ADR-0018 PR-3).
+ *
+ * The CLI is a thin wrapper around `core/triage/index.ts > triageItems()` that:
+ *
+ * 1. Loads `detected` items from `items/`, optionally narrowing by
+ *    `--source` / `--filter-tags` / `--max-items`.
+ * 2. Resolves the per-source `triagePolicy` (either from `sources/<id>.yaml`
+ *    or from `--policy <path>`).
+ * 3. Calls `triageItems()` once per source (each source has its own policy /
+ *    agent, so batching cross-source would either lose policy nuance or
+ *    require a multi-policy prompt — neither worth the complexity).
+ * 4. Either prints the proposed decisions (`--dry-run`), opens `$EDITOR` to
+ *    let the user massage them (`--interactive`), or writes them to disk
+ *    (`--apply`).
+ *
+ * `radar triage feedback` is a separate path that mutates the `triage.feedback`
+ * array on a single item — no agent call, no policy resolution.
+ */
+export interface TriageIO {
+    log?: (message: string) => void;
+    warn?: (message: string) => void;
+    error?: (message: string) => void;
+}
+export interface TriageCommandOptions {
+    cwd?: string;
+    io?: TriageIO;
+    /** Test seam: inject the triage runner instead of spawning a real CLI. */
+    runner?: TriageRunner;
+    /** Test seam: override `$EDITOR` invocation for `--interactive`. */
+    editor?: (path: string) => Promise<void>;
+    /**
+     * Test seam: override the interactive confirmation prompt. Default reads
+     * from stdin until a newline is seen; tests inject a function that
+     * returns the canned answer.
+     */
+    confirm?: (message: string) => Promise<boolean>;
+    /** Test seam: override the `now()` clock stamped on every decision / feedback. */
+    now?: () => string;
+}
+/**
+ * Top-level dispatcher for `radar triage`. Routes to the feedback subcommand
+ * when the first positional is `feedback`, otherwise runs the triage flow.
+ */
+export declare function runTriage(args: string[], options?: TriageCommandOptions): Promise<number>;
+interface PerSourceStats {
+    source: string;
+    total: number;
+    byDecision: Record<"research" | "digest" | "dismiss" | "unsure", number>;
+    digestGroups: number;
+    humanOverrides: {
+        triagedDismissToResearch: number;
+        triagedResearchToDismiss: number;
+        triagedUnsureToResearch: number;
+        triagedUnsureToDismiss: number;
+    };
+    agent: string | null;
+    policyPath: string | null;
+    policyLastEditedDaysAgo: number | null;
+    suggestions: string[];
+}
+/**
+ * Parse `Nd | Nh | Nm | Ns` into a `Date` cutoff. Returns `null` when the
+ * shape doesn't match — callers translate that into a CLI error. Mirrors
+ * `parseSinceCutoff` in items.ts so the two `--since` flags accept the same
+ * syntax.
+ */
+declare function parseSinceCutoffForStats(value: string, now?: Date): Date | null;
+/**
+ * Derive the human-override breakdown for a single source's triaged items.
+ *
+ * Two pathways feed the same counters:
+ *
+ * 1. `triage.feedback[].correct === false` (research / digest / dismiss
+ *    decisions) — an explicit signal the human disagreed. Each decision class
+ *    only flips one direction (research → dismiss, dismiss → research), so a
+ *    single boolean is enough.
+ * 2. `status` mutation downstream of `triaged_unsure` — the schema has no
+ *    "unsure direction" feedback field; instead we infer from where the item
+ *    landed (`researched` / `reviewed` → research; `dismissed` → dismiss).
+ *    This is best-effort: items still sitting in `triaged_unsure` are
+ *    excluded.
+ *
+ * The function only walks items whose `triage.decision` is set — items
+ * without a triage record (legacy or pending) are silently skipped.
+ */
+declare function computeHumanOverrides(items: Item[]): PerSourceStats["humanOverrides"];
+/**
+ * Heuristic policy-tuning hints (ADR-0018 §W5, #242).
+ *
+ * Triggered by 3 thresholds:
+ *
+ * - 3+ false negatives → recommend reviewing dismiss criteria, prefixing
+ *   common `matchedKeywords` from the offending items so the user knows
+ *   *which* dismissed items the agent missed.
+ * - 3+ false positives → recommend tightening research criteria with the
+ *   same keyword extraction pattern (different message).
+ * - 5+ unsure decisions → recommend lowering `confidenceThreshold` or
+ *   spelling out unsure cases in `rules:`.
+ *
+ * Below the thresholds we stay silent — surfacing 1-event "trends" would
+ * train users to ignore the section.
+ */
+declare function buildSuggestions(items: Item[], overrides: PerSourceStats["humanOverrides"]): string[];
+/**
+ * Extract the top 1-3 most common `matchedKeywords` (or title-derived words
+ * when keywords are absent) from a set of items, joined as ` / `. Used to
+ * give the suggestion a concrete "what to look at" hook without dumping
+ * every keyword in the source.
+ */
+declare function extractTopKeywordHint(items: Item[]): string;
+/**
+ * Aggregate stats per source group. Pure: takes items + a per-source policy
+ * lookup, returns a sorted array of `PerSourceStats`. The CLI layer wires
+ * disk I/O around it.
+ */
+declare function aggregatePerSource(items: Item[], policyMeta: Map<string, {
+    agent: string;
+    path: string;
+    lastEditedDaysAgo: number | null;
+}>, sinceCutoff: Date | null): PerSourceStats[];
+declare function renderStatsBlock(stat: PerSourceStats, sinceDays: number | null): string[];
+export declare const __test__: {
+    aggregatePerSource: typeof aggregatePerSource;
+    buildSuggestions: typeof buildSuggestions;
+    computeHumanOverrides: typeof computeHumanOverrides;
+    extractTopKeywordHint: typeof extractTopKeywordHint;
+    parseSinceCutoffForStats: typeof parseSinceCutoffForStats;
+    renderStatsBlock: typeof renderStatsBlock;
+};
+export declare const triageCommand: Command;
+export {};
+//# sourceMappingURL=triage.d.ts.map

package/dist/cli/triage.d.ts.map

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