@ozzylabs/feedradar 0.1.5 → 0.1.7

package/dist/core/triage/response.js

@@ -0,0 +1,188 @@
+import { z } from "zod";
+import { TriageDecisionValueSchema } from "../../schemas/item.js";
+/**
+ * Triage response parser + validator (ADR-0018 §W4).
+ *
+ * The agent returns a JSON array (one entry per input item) on stdout. This
+ * module turns that raw string into a `Map<itemId, ValidatedTriageEntry>`,
+ * applying the safety rules from ADR-0018:
+ *
+ * 1. **Strict JSON parse.** Total parse failure is reported to the caller as
+ *    a `TriageResponseParseError`; the caller (adapter.ts) decides whether
+ *    to retry the agent invocation or fall back to all-unsure.
+ * 2. **Schema validate per entry.** Entries that fail Zod parse become
+ *    `unsure` entries with a synthesized reason; only the malformed entry is
+ *    downgraded, the rest of the array is kept.
+ * 3. **Hallucinated id reject.** Entries whose `id` is not in the input set
+ *    are dropped from the result entirely (the caller's full-coverage check
+ *    will turn the missing items into `unsure` entries with reason
+ *    `"agent-omitted"`). Storing a hallucinated id on disk would corrupt the
+ *    items index.
+ * 4. **Duplicate id reject.** When the agent emits two entries for the same
+ *    id, the **first** is kept and the duplicate triggers a warning. This is
+ *    safer than overwriting — agents that hallucinate duplicates often emit
+ *    contradictory decisions, and the first is at least likely to reflect
+ *    the policy more directly.
+ * 5. **Confidence threshold demotion.** Entries below
+ *    `policy.confidenceThreshold` are demoted to `decision: "unsure"`. The
+ *    original confidence is preserved so downstream feedback analysis can
+ *    correlate "low confidence + demoted" outcomes.
+ * 6. **Digest without group → unsure.** A `decision: "digest"` entry without
+ *    a non-empty `group` is structurally invalid (the digest CLI needs the
+ *    key to collect siblings). We demote rather than reject so the operator
+ *    still gets a record.
+ *
+ * The output is a `Map`, not an array, so the adapter can do O(1) coverage
+ * checks against the input id set.
+ */
+/**
+ * Raw schema for one element of the agent's JSON response. We accept any
+ * shape that has the four required fields (id / decision / confidence /
+ * reason) and an optional group; unknown fields are dropped silently so the
+ * agent has room to add metadata without breaking parse.
+ *
+ * `decision` is parsed via `TriageDecisionValueSchema` so the same enum is
+ * shared with `TriageDecisionSchema` on the item — any drift would be caught
+ * at this boundary instead of corrupting the items index.
+ */
+const AgentEntrySchema = z.object({
+    id: z.string().min(1),
+    decision: TriageDecisionValueSchema,
+    confidence: z.number().min(0).max(1),
+    reason: z.string().min(1),
+    group: z.string().min(1).optional(),
+});
+/**
+ * The whole response body is just an array of entries. We extract this as a
+ * named schema so the malformed-array error message stays consistent across
+ * test cases.
+ */
+const AgentResponseSchema = z.array(AgentEntrySchema);
+/**
+ * Thrown by `parseTriageResponse` when the agent's stdout could not be
+ * parsed as JSON at all, or when the top-level value is not an array of
+ * entries. The adapter catches this and treats it as a total-fallback
+ * situation (every item becomes `triaged_unsure`, `fallback: true`).
+ *
+ * Per-entry validation failures (one entry malformed but the array parses)
+ * do NOT throw — they are recorded in `warnings[]` and the malformed entry
+ * is dropped so the rest of the array still applies.
+ */
+export class TriageResponseParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TriageResponseParseError";
+    }
+}
+/**
+ * Best-effort JSON extraction from agent stdout.
+ *
+ * Cheap models occasionally wrap their JSON in Markdown code fences
+ * (```json ... ```) or prepend / append a sentence even when instructed not
+ * to. We strip a leading / trailing code fence and locate the outermost
+ * `[ ... ]` slice so the JSON.parse call has a fighting chance. If neither
+ * heuristic helps, we let `JSON.parse` fail and propagate the error.
+ */
+function extractJsonArrayPayload(raw) {
+    const trimmed = raw.trim();
+    // Strip a single ```json / ``` ... ``` fence if present.
+    const fenceMatch = trimmed.match(/^```(?:json)?\s*\n([\s\S]*?)\n```$/);
+    const fenced = fenceMatch ? fenceMatch[1].trim() : trimmed;
+    // If the agent already emitted a clean array, return it directly.
+    if (fenced.startsWith("[")) {
+        return fenced;
+    }
+    // Otherwise locate the first `[` ... last `]` slice. This is intentionally
+    // greedy: cheap-model preamble usually sits before `[`, so trimming to the
+    // outermost brackets recovers the array.
+    const first = fenced.indexOf("[");
+    const last = fenced.lastIndexOf("]");
+    if (first === -1 || last === -1 || last <= first) {
+        return fenced;
+    }
+    return fenced.slice(first, last + 1);
+}
+/**
+ * Parse and validate the agent's triage response against the input item set
+ * and per-source policy.
+ *
+ * `inputItems` is consulted for two reasons: (a) hallucinated-id reject — we
+ * only accept ids that appear in the input set, and (b) the caller (adapter)
+ * uses the returned `entries` Map to figure out which items the agent
+ * omitted entirely (those become `unsure` with reason `"agent-omitted"`).
+ */
+export function parseTriageResponse(raw, inputItems, policy) {
+    const payload = extractJsonArrayPayload(raw);
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(payload);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new TriageResponseParseError(`triage response is not valid JSON: ${message}`);
+    }
+    const arrayResult = AgentResponseSchema.safeParse(parsedJson);
+    if (!arrayResult.success) {
+        // If the top-level shape failed (e.g. agent returned an object instead of
+        // an array), bail to the total-fallback path. Per-entry shape errors are
+        // handled below (we still get a partial array there).
+        if (!Array.isArray(parsedJson)) {
+            throw new TriageResponseParseError(`triage response top-level value is not an array: ${arrayResult.error.message}`);
+        }
+    }
+    const inputIds = new Set(inputItems.map((i) => i.id));
+    const entries = new Map();
+    const warnings = [];
+    // Iterate the raw parsed JSON (which we know is an array at this point) so
+    // we can per-entry validate and gather warnings without aborting on the
+    // first malformed entry. We re-run AgentEntrySchema per element to get
+    // precise error messages.
+    const rawArray = Array.isArray(parsedJson) ? parsedJson : [];
+    for (let idx = 0; idx < rawArray.length; idx++) {
+        const entryResult = AgentEntrySchema.safeParse(rawArray[idx]);
+        if (!entryResult.success) {
+            warnings.push(`entry[${idx}] failed schema validation: ${entryResult.error.issues
+                .map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`)
+                .join("; ")}`);
+            continue;
+        }
+        const entry = entryResult.data;
+        if (!inputIds.has(entry.id)) {
+            warnings.push(`entry[${idx}] references unknown id "${entry.id}" (hallucinated, rejected)`);
+            continue;
+        }
+        if (entries.has(entry.id)) {
+            warnings.push(`entry[${idx}] duplicates id "${entry.id}" (kept first, ignored)`);
+            continue;
+        }
+        // Apply demotion rules. We track the original decision in the warning so
+        // the operator (or feedback CLI) can see why a low-confidence research
+        // decision became unsure.
+        let decision = entry.decision;
+        let reason = entry.reason;
+        let demoted = false;
+        if (decision === "digest" && (entry.group === undefined || entry.group.trim() === "")) {
+            decision = "unsure";
+            reason = `digest decision without group key (demoted from "digest"): ${entry.reason}`;
+            demoted = true;
+            warnings.push(`entry[${idx}] "${entry.id}" demoted: digest without group key`);
+        }
+        if (decision !== "unsure" && entry.confidence < policy.confidenceThreshold) {
+            const original = decision;
+            decision = "unsure";
+            reason = `confidence ${entry.confidence.toFixed(2)} below threshold ${policy.confidenceThreshold.toFixed(2)} (demoted from "${original}"): ${entry.reason}`;
+            demoted = true;
+            warnings.push(`entry[${idx}] "${entry.id}" demoted: confidence ${entry.confidence.toFixed(2)} < threshold ${policy.confidenceThreshold.toFixed(2)}`);
+        }
+        entries.set(entry.id, {
+            id: entry.id,
+            decision,
+            confidence: entry.confidence,
+            reason,
+            group: decision === "digest" ? entry.group : undefined,
+            demoted,
+        });
+    }
+    return { entries, warnings };
+}
+//# sourceMappingURL=response.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../src/core/triage/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAGlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH;;;;;;;;;GASG;AACH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,QAAQ,EAAE,yBAAyB;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AA+BtD;;;;;;;;;GASG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,GAAW;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,yDAAyD;IACzD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3D,kEAAkE;IAClE,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,2EAA2E;IAC3E,2EAA2E;IAC3E,yCAAyC;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,UAAkB,EAClB,MAA0B;IAE1B,MAAM,OAAO,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,UAAmB,CAAC;IACxB,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,wBAAwB,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,WAAW,GAAG,mBAAmB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC9D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,0EAA0E;QAC1E,yEAAyE;QACzE,sDAAsD;QACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,wBAAwB,CAChC,oDAAoD,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,2EAA2E;IAC3E,wEAAwE;IACxE,uEAAuE;IACvE,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC/C,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CACX,SAAS,GAAG,+BAA+B,WAAW,CAAC,KAAK,CAAC,MAAM;iBAChE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC3D,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;YACF,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC;QAE/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,4BAA4B,KAAK,CAAC,EAAE,4BAA4B,CAAC,CAAC;YAC5F,SAAS;QACX,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,oBAAoB,KAAK,CAAC,EAAE,yBAAyB,CAAC,CAAC;YACjF,SAAS;QACX,CAAC;QAED,yEAAyE;QACzE,uEAAuE;QACvE,0BAA0B;QAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC9B,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACtF,QAAQ,GAAG,QAAQ,CAAC;YACpB,MAAM,GAAG,8DAA8D,KAAK,CAAC,MAAM,EAAE,CAAC;YACtF,OAAO,GAAG,IAAI,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,MAAM,KAAK,CAAC,EAAE,qCAAqC,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAC3E,MAAM,QAAQ,GAAG,QAAQ,CAAC;YAC1B,QAAQ,GAAG,QAAQ,CAAC;YACpB,MAAM,GAAG,cAAc,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,QAAQ,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5J,OAAO,GAAG,IAAI,CAAC;YACf,QAAQ,CAAC,IAAI,CACX,SAAS,GAAG,MAAM,KAAK,CAAC,EAAE,yBAAyB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CACtI,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE;YACpB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,QAAQ;YACR,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM;YACN,KAAK,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACtD,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/dist/recipes/aws-whats-new.yaml

@@ -1,7 +1,11 @@
 name: AWS What's New
 description: AWS What's New announcements (page-based JSON API, full-history backfill capable)
 kind: json-api
-url: https://aws.amazon.com/api/dirs/items/search?item.directoryId=whats-new&sort_by=item.additionalFields.postDateTime&sort_order=desc&size=100&page=0&item.locale=en_US
+# `whats-new-v2` is the active directoryId that backs the current
+# aws.amazon.com/new/ landing page. The legacy `whats-new` directoryId is
+# frozen at 2024-05-17 (16,281 items) and no longer ingests new posts. We
+# discovered v2 by grepping the rendered HTML of /new/ for `whats-new-v2`.
+url: https://aws.amazon.com/api/dirs/items/search?item.directoryId=whats-new-v2&sort_by=item.additionalFields.postDateTime&sort_order=desc&size=100&page=0&item.locale=en_US
 tags:
   - aws
   - cloud
@@ -33,13 +37,35 @@ pagination:
   start: 0
   pageSize: 100
   pageSizeParam: size
-  # 200 pages * 100 items/page = ~20,000 items, well above the ~16,281 total
-  # observed in 2026-05. `--backfill --max-pages N` can narrow further.
-  maxPages: 200
-  # `metadata.totalHits` is the AWS-reported total; the adapter uses it to
-  # short-circuit backfill once `ceil(totalHits / pageSize)` pages have been
-  # walked (ADR-0012 §D2 backfill early-stop hint).
+  # PER-FACET inner cap (ADR-0017). The 10,000-item offset cap is
+  # circumvented by the year-by-year facet sweep below — each year holds
+  # at most ~2,345 items (2024), which fits in ≤24 pages at pageSize=100.
+  # 30 leaves ~25% headroom for the largest year. Previous value 250 was
+  # dictated by full-history sweep on a single axis (PR #232) and is
+  # superseded by the facet sweep approach in ADR-0017. `--backfill
+  # --max-pages N` applies to this inner cap, not the outer year axis.
+  maxPages: 30
+  # `metadata.totalHits` is the AWS-reported total per facet value; the
+  # adapter uses it to short-circuit backfill once `ceil(totalHits /
+  # pageSize)` pages have been walked (ADR-0012 §D2 backfill early-stop
+  # hint). With the year facet active, each year reports its own
+  # totalHits (~2,000-2,300 for active years).
   totalPath: $.metadata.totalHits
+# Facet sweep (ADR-0017). The AWS dirs API enforces a hard
+# `(page + 1) * size <= 10000` cap, making the upper ~half of the catalog
+# (totalHits 21,834 vs reachable 10,000) unreachable via inner pagination
+# alone. Sweeping year-by-year recovers full coverage with zero gap: each
+# year holds well under 10,000 items, so the inner traversal never bumps
+# the AWS-side limit. Range covers 2004 (AWS's first announcement year)
+# through the current year; out-of-range years simply return 0 items and
+# the inner loop terminates immediately.
+facets:
+  year:
+    type: range
+    range: [2004, 2026]
+    step: 1
+    param: tags.id
+    template: "whats-new-v2#year#{}"
 jsonSelectors:
   # Each result is wrapped in `{ "item": { ... } }`, so we dereference one
   # extra level inside `items[*].item` to keep the per-element selectors
@@ -59,3 +85,32 @@ jsonSelectors:
   summary: $.additionalFields.postBody
   publisherId: $.id
 trustLevel: untrusted
+# Default triage policy bundled with this recipe (ADR-0018 §W3 / #241).
+# Propagates onto `sources/<id>.yaml > triagePolicy:` when the user runs
+# `radar source add <id> --recipe aws-whats-new`. The rules block is
+# free-form markdown — see docs/user-guide.md "triage workflow" §policy
+# 書き方ガイド for tuning tips. Cheap-model channel (gemini-2.5-flash-lite)
+# keeps per-source triage cost well below $0.01/month even at AWS's volume
+# (~700 items/month at peak).
+triagePolicy:
+  agent: gemini-cli
+  confidenceThreshold: 0.7
+  rules: |
+    重要 (research):
+      - 新サービス / 新機能の GA, Preview ローンチ
+      - 価格改定 / 料金体系変更
+      - リブランド・ブランド統合 (例: QuickSight → Quick)
+      - セキュリティ関連 (脆弱性対応、認証方式変更)
+      - メジャーな API 変更 / 既存サービスの semantics 変更
+    集約 (digest):
+      - 既存サービスへの incremental な機能追加 (UI option, filter 追加)
+        group: ui-incremental
+      - 連携サービス追加 (新 connector, 新 integration)
+        group: integrations
+      - performance 改善・SLA 向上 announcement
+        group: performance-sla
+    除外 (dismiss):
+      - リージョン拡張のみ (例: "now available in <region>")
+      - SDK バージョン bump
+      - ドキュメント更新通知
+      - 既存リソースの minor 設定追加 (例: "now supports tagging")

package/dist/recipes/dev-to.yaml

@@ -38,3 +38,27 @@ pagination:
 # `jsonSelectors` omitted intentionally: the default chain (ADR-0012 §D2 /
 # #174) handles the dev.to shape end-to-end.
 trustLevel: untrusted
+# Default triage policy bundled with this recipe (ADR-0018 §W3 / #241).
+# dev.to mixes technical deep-dives with marketing posts and "hello world"
+# tutorials, so the rules below bias toward research for framework /
+# performance / security topics, digest tutorial round-ups, and dismiss
+# personal promo / intro content. Adjust per workspace by overriding the
+# generated `sources/<id>.yaml > triagePolicy.rules:` block.
+triagePolicy:
+  agent: gemini-cli
+  confidenceThreshold: 0.7
+  rules: |
+    重要 (research):
+      - 新フレームワーク / 新ツールの紹介 / GA 発表記事
+      - performance benchmark / architecture deep-dive
+      - security 脆弱性報告 / CVE 解説
+      - メジャーアップデート (vN.0 リリース解説)
+    集約 (digest):
+      - tutorial 系の週次 round-up (関連トピック数本まとめ)
+        group: tutorial-roundup
+      - "Top N libraries for X" のようなキュレーション記事
+        group: curation
+    除外 (dismiss):
+      - 個人ブログ宣伝 / SaaS プロダクト promo
+      - 入門記事 ("hello world", "what is X" 系)
+      - "I built X in N hours" 系の体験記

package/dist/schemas/item.d.ts

@@ -1,21 +1,139 @@
 import { z } from "zod";
 /**
- * Item status state machine (ADR-0008).
+ * Item status state machine (ADR-0008 + ADR-0018).
+ *
+ * Original 4-state machine:
  *
  *   detected ──► (dismissed | researched) ──► reviewed
  *
- * - `detected`: watch run emitted the item after filter
- * - `dismissed`: user decided not to research (terminal)
+ * Triage extension (ADR-0018) adds 3 intermediate states. `triaged_dismiss`
+ * is intentionally **not** a separate status — it is collapsed into existing
+ * `dismissed` with the `dismissedBy: "human" | "triage_<agent>"` sub-field
+ * recording the origin. Total status count: 4 → 7.
+ *
+ *   detected
+ *     ├── triage ──► triaged_research ──► researched ──► reviewed
+ *     ├── triage ──► triaged_digest   ──► researched (digest 合流)
+ *     ├── triage ──► triaged_unsure   ──► (human loop) ──► research / dismiss
+ *     └── triage ──► dismissed (dismissedBy: triage_<agent>)
+ *
+ *   dismissed ──► detected (via `radar undismiss`)
+ *
+ * Status semantics (per ADR-0018 §W-B):
+ *
+ * - `detected`: watch run emitted the item after filter, triage not yet run
+ * - `triaged_research`: triage classified as research-worthy
+ * - `triaged_digest`: triage classified as digest candidate (group key in `triage.group`)
+ * - `triaged_unsure`: triage confidence below threshold; human judgment needed
  * - `researched`: research report written
  * - `reviewed`: research report reviewed (terminal happy path)
+ * - `dismissed`: human or triage agent decided not to research (terminal,
+ *   reversible via `radar undismiss`; origin in `dismissedBy`)
  */
 export declare const ItemStatusSchema: z.ZodEnum<{
     detected: "detected";
-    dismissed: "dismissed";
+    triaged_research: "triaged_research";
+    triaged_digest: "triaged_digest";
+    triaged_unsure: "triaged_unsure";
     researched: "researched";
     reviewed: "reviewed";
+    dismissed: "dismissed";
 }>;
 export type ItemStatus = z.infer<typeof ItemStatusSchema>;
+/**
+ * Decision values produced by a triage agent (ADR-0018).
+ *
+ * - `research`: item is research-worthy on its own
+ * - `digest`: item belongs to a group worth summarizing as a single digest
+ * - `dismiss`: item is not research-worthy; collapse into `dismissed`
+ * - `unsure`: triage agent's confidence is below `confidenceThreshold`; defer
+ *   to human judgment
+ */
+export declare const TriageDecisionValueSchema: z.ZodEnum<{
+    research: "research";
+    digest: "digest";
+    dismiss: "dismiss";
+    unsure: "unsure";
+}>;
+export type TriageDecisionValue = z.infer<typeof TriageDecisionValueSchema>;
+/**
+ * One feedback datapoint on a prior triage decision (ADR-0018 §W5).
+ *
+ * `radar triage feedback <item-id> --correct | --wrong [--reason <text>]`
+ * appends to the array. Stored as a list so multiple reviewers (or the same
+ * reviewer revisiting later) can leave independent verdicts without
+ * overwriting each other; downstream stats aggregations decide how to
+ * combine them.
+ */
+export declare const TriageFeedbackSchema: z.ZodObject<{
+    correct: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+    feedbackAt: z.ZodString;
+}, z.core.$strip>;
+export type TriageFeedback = z.infer<typeof TriageFeedbackSchema>;
+/**
+ * Triage decision attached to an item by a triage agent (ADR-0018 §W2 / §W5).
+ *
+ * Schema rationale (post-review #238 W-I):
+ *
+ * - The outer field on `Item` is the **singular** `triage` (not `triages`).
+ *   This preserves the option of moving to a multi-agent shape (`triage: {
+ *   decisions: [...], consensus: ... }`) later via a Zod union without
+ *   renaming the field. PR-1 ships the single-agent inner shape only;
+ *   multi-agent extension is a future PR and explicitly NOT in scope.
+ * - `decision` is a discriminated string, not a nested object, so the same
+ *   union-extension pattern can reuse the field name on the inner decision
+ *   list without ambiguity.
+ * - `feedback` is an array, not a single object — multiple human reviewers
+ *   can leave independent verdicts (see `TriageFeedbackSchema` docstring).
+ */
+export declare const TriageDecisionSchema: z.ZodObject<{
+    decision: z.ZodEnum<{
+        research: "research";
+        digest: "digest";
+        dismiss: "dismiss";
+        unsure: "unsure";
+    }>;
+    confidence: z.ZodNumber;
+    reason: z.ZodString;
+    group: z.ZodOptional<z.ZodString>;
+    agent: z.ZodString;
+    triagedAt: z.ZodString;
+    feedback: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        correct: z.ZodBoolean;
+        reason: z.ZodOptional<z.ZodString>;
+        feedbackAt: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type TriageDecision = z.infer<typeof TriageDecisionSchema>;
+/**
+ * Origin of a `dismissed` decision (ADR-0018 §W2 / §W6).
+ *
+ * Distinguishes human dismiss from triage-agent dismiss so `radar undismiss`
+ * can apply the right safety behavior: triage-origin dismisses are reversible
+ * without a flag, human-origin dismisses require `--force` (= confirms the
+ * user is overriding their own prior decision, not just an agent's).
+ *
+ * Defined as a string enum (not a union with `AgentIdSchema`) because the
+ * `triage_` prefix lets schema validation reject malformed values like
+ * `"claude-code"` (missing prefix) that would silently collide with the
+ * `human` case.
+ *
+ * Maintenance note: this enum mirrors `AgentIdSchema` (`src/schemas/research.ts`)
+ * with a `triage_` prefix. When a new agent adapter is added, both enums
+ * must be updated in lockstep. A test (`tests/schemas/item.test.ts`)
+ * iterates each `AgentIdSchema` value and asserts the corresponding
+ * `triage_<agent>` variant parses; that test will fail loudly if the two
+ * lists drift out of sync.
+ */
+export declare const DismissedBySchema: z.ZodEnum<{
+    human: "human";
+    "triage_claude-code": "triage_claude-code";
+    "triage_codex-cli": "triage_codex-cli";
+    "triage_gemini-cli": "triage_gemini-cli";
+    triage_copilot: "triage_copilot";
+}>;
+export type DismissedBy = z.infer<typeof DismissedBySchema>;
 export declare const ItemSchema: z.ZodObject<{
     id: z.ZodString;
     sourceId: z.ZodString;
@@ -28,11 +146,39 @@ export declare const ItemSchema: z.ZodObject<{
     matchedKeywords: z.ZodDefault<z.ZodArray<z.ZodString>>;
     status: z.ZodDefault<z.ZodEnum<{
         detected: "detected";
-        dismissed: "dismissed";
+        triaged_research: "triaged_research";
+        triaged_digest: "triaged_digest";
+        triaged_unsure: "triaged_unsure";
         researched: "researched";
         reviewed: "reviewed";
+        dismissed: "dismissed";
     }>>;
     injectionFlags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    triage: z.ZodOptional<z.ZodObject<{
+        decision: z.ZodEnum<{
+            research: "research";
+            digest: "digest";
+            dismiss: "dismiss";
+            unsure: "unsure";
+        }>;
+        confidence: z.ZodNumber;
+        reason: z.ZodString;
+        group: z.ZodOptional<z.ZodString>;
+        agent: z.ZodString;
+        triagedAt: z.ZodString;
+        feedback: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            correct: z.ZodBoolean;
+            reason: z.ZodOptional<z.ZodString>;
+            feedbackAt: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    dismissedBy: z.ZodOptional<z.ZodEnum<{
+        human: "human";
+        "triage_claude-code": "triage_claude-code";
+        "triage_codex-cli": "triage_codex-cli";
+        "triage_gemini-cli": "triage_gemini-cli";
+        triage_copilot: "triage_copilot";
+    }>>;
 }, z.core.$strip>;
 export type Item = z.infer<typeof ItemSchema>;
 //# sourceMappingURL=item.d.ts.map

package/dist/schemas/item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../src/schemas/item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB;;;;;EAA8D,CAAC;AAC5F,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;iBAoBrB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../src/schemas/item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;EAQ3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB;;;;;EAAsD,CAAC;AAC7F,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;iBAW/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;iBAmC/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyCrB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}