@ozzylabs/feedradar 0.1.0

package/dist/core/items.js

@@ -0,0 +1,105 @@
+import { createHash } from "node:crypto";
+import { access, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { ItemSchema } from "../schemas/index.js";
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Sanitize an item id for use as a filename.
+ *
+ * RSS GUIDs are commonly URLs containing `/` `:` `?`, which `path.join` would
+ * interpret as path separators (or that fail outright on Windows / NTFS). The
+ * yaml body still carries the original `id`, so this is purely a filename
+ * concern — `loadItems` discovers items by directory scan, not by name lookup.
+ *
+ * Strategy: keep alphanumerics + `.` `-` `_`, replace everything else with `_`,
+ * and append a short content hash whenever sanitization changed the string or
+ * the id exceeds 100 chars. The hash keeps two ids that sanitize to the same
+ * string from overwriting each other.
+ */
+function safeFilename(itemId) {
+    const sanitized = itemId.replace(/[^A-Za-z0-9._-]/g, "_");
+    if (sanitized === itemId && sanitized.length <= 100) {
+        return sanitized;
+    }
+    const hash = createHash("sha256").update(itemId).digest("hex").slice(0, 8);
+    return `${sanitized.slice(0, 90)}-${hash}`;
+}
+/**
+ * Build the on-disk filename for an item.
+ *
+ * Each item is stored as `items/<sourceId>/<filename>.yaml`. Grouping by source
+ * keeps the directory listing manageable for users running dozens of sources
+ * and aligns with how `source remove` preserves history under
+ * `items/<sourceId>/` (see issue #12). Filenames are sanitized via
+ * `safeFilename` to tolerate URL-shaped ids that real RSS feeds emit.
+ */
+function itemFile(itemsDir, sourceId, itemId) {
+    return join(itemsDir, sourceId, `${safeFilename(itemId)}.yaml`);
+}
+/**
+ * Load all items under `items/<sourceId>/` and return them parsed + validated.
+ *
+ * Malformed files surface as thrown errors with the offending filename so
+ * tooling can pinpoint the issue. Callers that want a fault-tolerant scan
+ * should wrap the call in try/catch per file.
+ */
+export async function loadItems(itemsDir, sourceId) {
+    if (!(await pathExists(itemsDir)))
+        return [];
+    const out = [];
+    const sourceDirs = sourceId ? [sourceId] : await readdir(itemsDir);
+    for (const sid of sourceDirs) {
+        const dir = join(itemsDir, sid);
+        if (!(await pathExists(dir)))
+            continue;
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.endsWith(".yaml"))
+                continue;
+            const raw = await readFile(join(dir, entry), "utf8");
+            const parsed = parseYaml(raw);
+            const result = ItemSchema.safeParse(parsed);
+            if (!result.success) {
+                throw new Error(`loadItems: schema mismatch in ${sid}/${entry}: ${result.error.issues
+                    .map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`)
+                    .join("; ")}`);
+            }
+            out.push(result.data);
+        }
+    }
+    return out;
+}
+/**
+ * Persist items as YAML files under `items/<sourceId>/<itemId>.yaml`.
+ *
+ * Existing files for the same id are overwritten — callers are responsible
+ * for de-duplication via the `state.lastSeenIds` cursor before invoking this.
+ * The watcher uses this only for newly-detected items, so the overwrite path
+ * is effectively unreachable in normal operation; we still leave it permissive
+ * to keep the function idempotent under retry.
+ */
+export async function saveItems(itemsDir, items) {
+    for (const item of items) {
+        const validated = ItemSchema.parse(item);
+        const dir = join(itemsDir, validated.sourceId);
+        await mkdir(dir, { recursive: true });
+        const file = itemFile(itemsDir, validated.sourceId, validated.id);
+        await writeFile(file, stringifyYaml(validated), "utf8");
+    }
+}
+//# sourceMappingURL=items.js.map

package/dist/core/items.js.map

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

package/dist/core/state.d.ts

@@ -0,0 +1,12 @@
+import type { SourceState } from "../schemas/index.js";
+/**
+ * Load a single source's state from `state/<sourceId>.yaml`.
+ *
+ * Returns an empty record (no `lastFetchedAt` / `lastEtag` and an empty
+ * `lastSeenIds`) when the file does not exist, so callers can treat absence
+ * as "fresh start" without branching.
+ */
+export declare function loadSourceState(stateDir: string, sourceId: string): Promise<SourceState>;
+/** Persist a source's state, creating the directory if needed. */
+export declare function saveSourceState(stateDir: string, state: SourceState): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/core/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAgBvD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAU9F;AAED,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzF"}

package/dist/core/state.js

@@ -0,0 +1,42 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { SourceStateSchema } from "../schemas/index.js";
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function stateFile(stateDir, sourceId) {
+    return join(stateDir, `${sourceId}.yaml`);
+}
+/**
+ * Load a single source's state from `state/<sourceId>.yaml`.
+ *
+ * Returns an empty record (no `lastFetchedAt` / `lastEtag` and an empty
+ * `lastSeenIds`) when the file does not exist, so callers can treat absence
+ * as "fresh start" without branching.
+ */
+export async function loadSourceState(stateDir, sourceId) {
+    const file = stateFile(stateDir, sourceId);
+    if (!(await pathExists(file))) {
+        return { sourceId, lastSeenIds: [] };
+    }
+    const raw = await readFile(file, "utf8");
+    const parsed = parseYaml(raw);
+    // Fill in sourceId if older files don't carry it (defensive).
+    const candidate = { ...(parsed ?? {}), sourceId: parsed?.sourceId ?? sourceId };
+    return SourceStateSchema.parse(candidate);
+}
+/** Persist a source's state, creating the directory if needed. */
+export async function saveSourceState(stateDir, state) {
+    const validated = SourceStateSchema.parse(state);
+    const file = stateFile(stateDir, validated.sourceId);
+    await mkdir(dirname(file), { recursive: true });
+    await writeFile(file, stringifyYaml(validated), "utf8");
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAEtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,KAAK,UAAU,UAAU,CAAC,CAAS;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,QAAgB;IACnD,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAgB;IACtE,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAmC,CAAC;IAChE,8DAA8D;IAC9D,MAAM,SAAS,GAAG,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,QAAQ,EAAE,CAAC;IAChF,OAAO,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,KAAkB;IACxE,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/dist/core/templates.d.ts

@@ -0,0 +1,21 @@
+export interface ResearchTemplate {
+    id: string;
+    path: string;
+    body: string;
+}
+/**
+ * Load `templates/<id>.md` from the workspace.
+ *
+ * The CLI defaults `--template default`, so callers will typically pass
+ * `"default"` here. If the file is missing we surface a clear error rather
+ * than silently falling back to an empty body — the agent prompt is built
+ * from the template, and a silently-empty template would produce confusing
+ * agent output that's hard to diagnose.
+ *
+ * `default` is also accepted when no `templates/default.md` exists: the
+ * agent's research SKILL has its own built-in default structure, so callers
+ * may legitimately skip provisioning a template file. In that case we return
+ * an empty body and the SKILL falls back to its bundled structure.
+ */
+export declare function loadTemplate(id: string, dir: string): Promise<ResearchTemplate>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/core/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAsBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBrF"}

package/dist/core/templates.js

@@ -0,0 +1,52 @@
+import { access, readFile } from "node:fs/promises";
+import { join } from "node:path";
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate a template id as a safe filename component.
+ *
+ * Mirrors `source` id validation: reject path separators, dot-prefixed names,
+ * and shell-unsafe characters so `templates/<id>.md` cannot escape the
+ * templates directory.
+ */
+function isSafeTemplateId(id) {
+    return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(id) && !id.includes("..");
+}
+/**
+ * Load `templates/<id>.md` from the workspace.
+ *
+ * The CLI defaults `--template default`, so callers will typically pass
+ * `"default"` here. If the file is missing we surface a clear error rather
+ * than silently falling back to an empty body — the agent prompt is built
+ * from the template, and a silently-empty template would produce confusing
+ * agent output that's hard to diagnose.
+ *
+ * `default` is also accepted when no `templates/default.md` exists: the
+ * agent's research SKILL has its own built-in default structure, so callers
+ * may legitimately skip provisioning a template file. In that case we return
+ * an empty body and the SKILL falls back to its bundled structure.
+ */
+export async function loadTemplate(id, dir) {
+    if (!isSafeTemplateId(id)) {
+        throw new Error(`loadTemplate: invalid template id '${id}' (must match [A-Za-z0-9][A-Za-z0-9._-]*)`);
+    }
+    const path = join(dir, `${id}.md`);
+    if (!(await pathExists(path))) {
+        if (id === "default") {
+            // `default` is allowed to be absent — the bundled research SKILL ships
+            // its own structure. Returning an empty body signals "use built-in".
+            return { id, path, body: "" };
+        }
+        throw new Error(`loadTemplate: template not found: ${path}`);
+    }
+    const body = await readFile(path, "utf8");
+    return { id, path, body };
+}
+//# sourceMappingURL=templates.js.map

package/dist/core/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,KAAK,UAAU,UAAU,CAAC,CAAS;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,EAAU;IAClC,OAAO,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAU,EAAE,GAAW;IACxD,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,sCAAsC,EAAE,2CAA2C,CACpF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,uEAAuE;YACvE,qEAAqE;YACrE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}

package/dist/core/watcher.d.ts

@@ -0,0 +1,72 @@
+import type { Item, Source, SourceState } from "../schemas/index.js";
+import type { FeedAdapter, FetchLike } from "./feeds/index.js";
+export interface WorkspacePaths {
+    /** Workspace root; defaults to process.cwd() at the CLI layer. */
+    cwd: string;
+    sourcesDir?: string;
+    itemsDir?: string;
+    stateDir?: string;
+}
+export interface WatchRunOptions extends WorkspacePaths {
+    /** Limit the run to a single source id. Defaults to all sources. */
+    sourceId?: string;
+    /**
+     * Bootstrap mode: ingest all current entries into `lastSeenIds` without
+     * emitting any items. Used on first install to suppress noise from existing
+     * backlogs (ADR-0008 §運用: 初回ノイズ抑制).
+     */
+    bootstrap?: boolean;
+    /** Override the adapter registry (tests). */
+    getAdapter?: (kind: Source["kind"]) => FeedAdapter;
+    /** Override the HTTP fetcher (tests). */
+    fetch?: FetchLike;
+    /** Sinks for diagnostic output; defaults to console.* . */
+    log?: (message: string) => void;
+    warn?: (message: string) => void;
+    error?: (message: string) => void;
+}
+export interface WatchRunResult {
+    /** Map of sourceId → detected (filter-passing, not previously seen) items. */
+    detected: Record<string, Item[]>;
+    /** Map of sourceId → the SourceState that was persisted after the run. */
+    states: Record<string, SourceState>;
+    /** Sources that errored during fetch/parse, so the CLI can exit non-zero. */
+    errors: Array<{
+        sourceId: string;
+        message: string;
+    }>;
+}
+/**
+ * Load all enabled sources from `sources/*.yaml`.
+ *
+ * Malformed files are reported through `onError` but do not abort the load —
+ * one broken YAML should not block the entire run, mirroring how `source list`
+ * behaves (see `src/cli/source.ts`).
+ */
+export declare function loadSources(sourcesDir: string, onError: (message: string) => void): Promise<Source[]>;
+/**
+ * Execute one full watch cycle.
+ *
+ * Per source:
+ *   1. Load previous state (`state/<id>.yaml`).
+ *   2. Invoke the feed adapter with the previous ETag.
+ *   3. Filter freshly-fetched items.
+ *   4. Subtract anything in `lastSeenIds`.
+ *   5. In bootstrap mode, persist *all* fetched ids to seen without emitting
+ *      items. Otherwise, write the new items to `items/<sourceId>/` and merge
+ *      their ids into `lastSeenIds`.
+ *   6. Persist `state/<sourceId>.yaml`.
+ *
+ * Step 4 + 5 ensure idempotency: re-running the watcher does not produce
+ * duplicate item files. ADR-0006 filter semantics are applied in step 3.
+ */
+export declare function watchRun(options: WatchRunOptions): Promise<WatchRunResult>;
+/**
+ * Legacy convenience: fetch every source serially without any state I/O.
+ *
+ * Kept for callers that just want the raw items (e.g. the placeholder
+ * `radar watch` invocation). The real CLI now goes through
+ * `watchRun`, which threads state and filters.
+ */
+export declare function watch(sources: Source[]): Promise<Item[]>;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/core/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/core/watcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA+C/D,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC;IACnD,yCAAyC;IACzC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,6EAA6E;IAC7E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAWD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAkHhF;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAQ9D"}

package/dist/core/watcher.js

@@ -0,0 +1,240 @@
+import { access, readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { SourceSchema } from "../schemas/index.js";
+import { getFeedAdapter } from "./feeds/index.js";
+import { filterItems } from "./filter.js";
+import { detectInjection } from "./injection-detector.js";
+import { saveItems } from "./items.js";
+import { loadSourceState, saveSourceState } from "./state.js";
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run the injection pre-filter (ADR-0009 M1a — Adopt) over an item's
+ * untrusted text fields and return the item with `injectionFlags` populated.
+ *
+ * Coverage: `title`, `summary`, and `raw`. The `raw` payload is structured
+ * (varies by adapter — RSS / Atom / npm / HTML), so we `JSON.stringify` it so
+ * embedded strings are still scanned without forcing each adapter to know
+ * about the detector. Fields that are unset / empty contribute nothing.
+ *
+ * Audit-only: the flags are recorded for later inspection by `research` /
+ * `review` / `update` and surface in CLI logs. We do NOT mutate `status`,
+ * sanitize content, or drop items — that aligns with ADR-0009 M5a (Adopt /
+ * user retains judgment) and M5b (Reject — no auto-drop).
+ */
+function annotateInjectionFlags(item) {
+    const parts = [item.title];
+    if (item.summary)
+        parts.push(item.summary);
+    if (item.raw !== undefined) {
+        try {
+            parts.push(JSON.stringify(item.raw));
+        }
+        catch {
+            // Circular / unserializable raw payload — fall back to a coarse string
+            // cast so we still scan something rather than silently skip.
+            parts.push(String(item.raw));
+        }
+    }
+    const haystack = parts.join("\n");
+    const { matched } = detectInjection(haystack);
+    return { ...item, injectionFlags: matched };
+}
+function defaultPaths(opts) {
+    return {
+        cwd: opts.cwd,
+        sourcesDir: opts.sourcesDir ?? join(opts.cwd, "sources"),
+        itemsDir: opts.itemsDir ?? join(opts.cwd, "items"),
+        stateDir: opts.stateDir ?? join(opts.cwd, "state"),
+    };
+}
+/**
+ * Load all enabled sources from `sources/*.yaml`.
+ *
+ * Malformed files are reported through `onError` but do not abort the load —
+ * one broken YAML should not block the entire run, mirroring how `source list`
+ * behaves (see `src/cli/source.ts`).
+ */
+export async function loadSources(sourcesDir, onError) {
+    if (!(await pathExists(sourcesDir)))
+        return [];
+    const entries = await readdir(sourcesDir);
+    const yamlFiles = entries.filter((f) => f.endsWith(".yaml")).sort();
+    const sources = [];
+    for (const filename of yamlFiles) {
+        const file = join(sourcesDir, filename);
+        let raw;
+        try {
+            raw = await readFile(file, "utf8");
+        }
+        catch (e) {
+            onError(`failed to read ${filename}: ${e instanceof Error ? e.message : String(e)}`);
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = parseYaml(raw);
+        }
+        catch (e) {
+            onError(`invalid YAML in ${filename}: ${e instanceof Error ? e.message : String(e)}`);
+            continue;
+        }
+        const result = SourceSchema.safeParse(parsed);
+        if (!result.success) {
+            onError(`schema mismatch in ${filename}: ${result.error.issues[0]?.message ?? "unknown"}`);
+            continue;
+        }
+        sources.push(result.data);
+    }
+    return sources;
+}
+/**
+ * Execute one full watch cycle.
+ *
+ * Per source:
+ *   1. Load previous state (`state/<id>.yaml`).
+ *   2. Invoke the feed adapter with the previous ETag.
+ *   3. Filter freshly-fetched items.
+ *   4. Subtract anything in `lastSeenIds`.
+ *   5. In bootstrap mode, persist *all* fetched ids to seen without emitting
+ *      items. Otherwise, write the new items to `items/<sourceId>/` and merge
+ *      their ids into `lastSeenIds`.
+ *   6. Persist `state/<sourceId>.yaml`.
+ *
+ * Step 4 + 5 ensure idempotency: re-running the watcher does not produce
+ * duplicate item files. ADR-0006 filter semantics are applied in step 3.
+ */
+export async function watchRun(options) {
+    const paths = defaultPaths(options);
+    const log = options.log ?? ((m) => console.log(m));
+    const warn = options.warn ?? ((m) => console.warn(m));
+    const error = options.error ?? ((m) => console.error(m));
+    const getAdapter = options.getAdapter ?? getFeedAdapter;
+    const sources = await loadSources(paths.sourcesDir, (m) => warn(`watch run: ${m}`));
+    const filtered = options.sourceId ? sources.filter((s) => s.id === options.sourceId) : sources;
+    if (filtered.length === 0) {
+        if (options.sourceId) {
+            warn(`watch run: no source with id '${options.sourceId}'`);
+        }
+        else {
+            log("watch run: no sources defined (use `radar source add ...`)");
+        }
+        return { detected: {}, states: {}, errors: [] };
+    }
+    const result = { detected: {}, states: {}, errors: [] };
+    for (const source of filtered) {
+        const previousState = await loadSourceState(paths.stateDir, source.id);
+        let adapter;
+        try {
+            adapter = getAdapter(source.kind);
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            error(`watch run: '${source.id}' adapter error: ${message}`);
+            result.errors.push({ sourceId: source.id, message });
+            continue;
+        }
+        let fetched;
+        let nextStatePatch;
+        let notModified = false;
+        try {
+            const fetchResult = await adapter.fetch(source, {
+                fetch: options.fetch,
+                state: previousState,
+            });
+            fetched = fetchResult.items;
+            nextStatePatch = fetchResult.state;
+            notModified = fetchResult.notModified ?? false;
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            error(`watch run: '${source.id}' fetch failed: ${message}`);
+            result.errors.push({ sourceId: source.id, message });
+            continue;
+        }
+        const seenIds = new Set(previousState.lastSeenIds);
+        let detectedItems = [];
+        if (options.bootstrap) {
+            // Bootstrap: seed the state with every id we saw so the *next* run can
+            // diff against it. We intentionally skip filter + emit so the user does
+            // not get blasted with historical detections (ADR-0008 §運用 hint).
+            for (const item of fetched)
+                seenIds.add(item.id);
+            log(`watch run: bootstrap '${source.id}' — ${fetched.length} ids recorded, no items written`);
+        }
+        else if (notModified) {
+            log(`watch run: '${source.id}' unchanged (304)`);
+        }
+        else {
+            const passed = filterItems(fetched, source);
+            const fresh = passed
+                .filter((item) => !seenIds.has(item.id))
+                .map((item) => annotateInjectionFlags(item));
+            if (fresh.length > 0) {
+                await saveItems(paths.itemsDir, fresh);
+                for (const item of fresh)
+                    seenIds.add(item.id);
+            }
+            // Always add every fetched id to seen — even items that failed the
+            // filter should not be re-evaluated next run, since the filter result
+            // would not change without a content change (and we already keep the
+            // raw payload for any item that did pass).
+            for (const item of fetched)
+                seenIds.add(item.id);
+            detectedItems = fresh;
+            // Diagnose the most common "why are 0 items new?" pitfall: a source
+            // with no include keywords. `src/core/filter.ts` short-circuits to
+            // `match nothing` in that case (firehose guard), so fetched-but-zero
+            // is otherwise indistinguishable from "feed unchanged". The hint
+            // points the user at the YAML file they need to edit to fix it.
+            if (fetched.length > 0 && fresh.length === 0 && source.filters.keywords.length === 0) {
+                warn(`watch run: '${source.id}' has no keywords configured — all ${fetched.length} fetched item(s) were filtered out. Add keywords to sources/${source.id}.yaml to start ingesting.`);
+            }
+            log(`watch run: '${source.id}' fetched ${fetched.length} items, ${fresh.length} new after filter`);
+            // Surface a per-source audit summary for items that tripped the
+            // injection pre-filter (ADR-0009 M1a). We log once per source rather
+            // than per item to keep the watch output readable when a feed has many
+            // hits; the per-item view is available via `radar research` /
+            // `review` / `update` logs and in `items/<id>.yaml` directly.
+            const flagged = fresh.filter((i) => i.injectionFlags.length > 0);
+            if (flagged.length > 0) {
+                warn(`watch run: '${source.id}' ${flagged.length} item(s) tripped the prompt-injection pre-filter (audit-only; status unchanged). See injectionFlags in items/<id>.yaml.`);
+            }
+        }
+        const nextState = {
+            sourceId: source.id,
+            lastFetchedAt: nextStatePatch.lastFetchedAt ?? previousState.lastFetchedAt,
+            lastEtag: nextStatePatch.lastEtag ?? previousState.lastEtag,
+            lastSeenIds: Array.from(seenIds),
+        };
+        await saveSourceState(paths.stateDir, nextState);
+        result.detected[source.id] = detectedItems;
+        result.states[source.id] = nextState;
+    }
+    return result;
+}
+/**
+ * Legacy convenience: fetch every source serially without any state I/O.
+ *
+ * Kept for callers that just want the raw items (e.g. the placeholder
+ * `radar watch` invocation). The real CLI now goes through
+ * `watchRun`, which threads state and filters.
+ */
+export async function watch(sources) {
+    const results = [];
+    for (const source of sources) {
+        const adapter = getFeedAdapter(source.kind);
+        const { items } = await adapter.fetch(source);
+        results.push(...items);
+    }
+    return results;
+}
+//# sourceMappingURL=watcher.js.map

package/dist/core/watcher.js.map

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

package/dist/gemini-commands/dismiss.toml

@@ -0,0 +1,2 @@
+prompt = "Run `radar dismiss {{args}}` to mark the specified detected item as dismissed. This command does not invoke an LLM; the CLI flips the item status directly. Surface the resulting status and any errors from stdout/stderr."
+description = "Mark a detected item as dismissed via FeedRadar (no LLM)."

package/dist/gemini-commands/research.toml

@@ -0,0 +1,2 @@
+prompt = "Run `radar research {{args}}` to generate a research report for the specified item. Surface the resulting file path and any errors from stdout/stderr. The canonical procedure lives in `.agents/skills/research/SKILL.md` (SSoT); this command is a thin wrapper that delegates to the CLI."
+description = "Generate a research report for a detected item via FeedRadar."

package/dist/gemini-commands/review.toml

@@ -0,0 +1,2 @@
+prompt = "Run `radar review {{args}}` to cross-review the specified research report. Surface the resulting file path and any errors from stdout/stderr. The canonical procedure lives in `.agents/skills/review/SKILL.md` (SSoT); this command is a thin wrapper that delegates to the CLI."
+description = "Cross-review an existing research report via FeedRadar."

package/dist/gemini-commands/update.toml

@@ -0,0 +1,2 @@
+prompt = "Run `radar update {{args}}` to regenerate the specified research report as a new v+1 version. Surface the resulting file path and any errors from stdout/stderr. The canonical procedure lives in `.agents/skills/update/SKILL.md` (SSoT); this command is a thin wrapper that delegates to the CLI."
+description = "Regenerate a research report as a new version via FeedRadar."

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { run } from "./cli/index.js";
+run(process.argv.slice(2)).catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`radar: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAChD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}