@ozzylabs/feedradar 0.1.0

package/dist/claude-skills/review/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: review
+description: Cross-review an existing research report with a different agent via the FeedRadar CLI.
+argument-hint: <research-id> [--agent claude-code|codex-cli|gemini-cli|copilot] [--template <id>]
+---
+
+# review
+
+Append a review block to an existing `research/<id>.md` and stamp the
+frontmatter `reviewedAt` / `reviewedBy` fields.
+
+This skill is a thin wrapper: it delegates to the `radar` CLI, which
+handles research file resolution, template loading, adapter dispatch, schema
+validation, and the `researched → reviewed` status transition. The canonical
+review procedure (rubric, where the review block lands, frontmatter stamp
+format) lives in `.agents/skills/review/SKILL.md` (the SSoT) and is invoked
+by the agent adapter that the CLI spawns. Do not duplicate that procedure
+here.
+
+## Steps
+
+1. Resolve `$ARGUMENTS`. If empty or `--help`, run:
+
+   ```bash
+   radar review --help
+   ```
+
+   and report the usage. Otherwise pass `$ARGUMENTS` through verbatim.
+2. Execute:
+
+   ```bash
+   radar review $ARGUMENTS
+   ```
+
+3. Report the result: the CLI prints the research path it updated and the
+   item status transition (`status -> reviewed`).
+
+## Notes
+
+- For meaningful cross-checking, pick `--agent` different from the one that
+  wrote the original v1 (ADR-0001 § クロスエージェント運用). Example: if v1
+  was authored by `claude-code`, run review with `--agent codex-cli` or
+  `--agent gemini-cli`.
+- If the CLI exits non-zero, surface the error and exit code; do not retry
+  with a different agent without user direction.

package/dist/claude-skills/update/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: update
+description: Regenerate an existing research report as v+1 via the FeedRadar CLI (rewrite-and-supersede).
+argument-hint: <research-id> [--agent claude-code|codex-cli|gemini-cli|copilot] [--template <id>]
+---
+
+# update
+
+Generate a new `<base>_v<N+1>.md` from the supplied predecessor research,
+writing `supersedes: <prev-id>` into the new frontmatter and leaving the
+predecessor file untouched (immutable history, ADR-0003).
+
+This skill is a thin wrapper: it delegates to the `radar` CLI, which
+handles predecessor parsing, version increment, supersedes wiring, adapter
+dispatch, schema validation, and the **items.yaml status invariance** rule
+(ADR-0008: update never changes the source item's `status`, regardless of
+how many v+N files it generates). The canonical update procedure
+(rewrite-and-supersede strategy, materiality judgement, what fields v+1
+resets) lives in `.agents/skills/update/SKILL.md` (the SSoT) and is invoked
+by the agent adapter that the CLI spawns. Do not duplicate that procedure
+here.
+
+## Steps
+
+1. Resolve `$ARGUMENTS`. If empty or `--help`, run:
+
+   ```bash
+   radar update --help
+   ```
+
+   and report the usage. Otherwise pass `$ARGUMENTS` through verbatim.
+2. Execute:
+
+   ```bash
+   radar update $ARGUMENTS
+   ```
+
+3. Report the v+1 file path the CLI produced (printed as `update: wrote
+   <path>` and `update: supersedes <prev-id> (items.yaml status unchanged
+   per ADR-0008)`).
+
+## Notes
+
+- v+1 always resets `reviewedAt` / `reviewedBy` to `null` because a review
+  only applies to the version it was written against (ADR-0003). To
+  re-review the new version, run `/review <new-id>` afterwards.
+- If the CLI exits non-zero (e.g. the supplied predecessor's frontmatter
+  doesn't match the schema), surface the error and exit code; do not edit
+  the predecessor file to fix it — that violates immutable history.

package/dist/cli/dismiss.d.ts

@@ -0,0 +1,28 @@
+import type { Command } from "./index.js";
+/** Sinks for the dismiss command's user-facing output. Tests inject capturing sinks. */
+export interface DismissIO {
+    log?: (message: string) => void;
+    error?: (message: string) => void;
+}
+export interface DismissCommandOptions {
+    cwd?: string;
+    io?: DismissIO;
+}
+/**
+ * Implementation of `radar dismiss <item-id>`.
+ *
+ * Triggers the `detected → dismissed` state transition (ADR-0008). The command
+ * is intentionally agent-free: it only mutates `items/<sourceId>/<item-id>.yaml`
+ * so users can prune noise from `watch run` output without spending agent
+ * tokens.
+ *
+ * Flow:
+ *   1. Parse + validate args.
+ *   2. Locate `items/<sourceId>/<item-id>.yaml`.
+ *   3. Reject if the item is not in `detected` (terminal/researched states
+ *      cannot be dismissed; there is no `undismiss`).
+ *   4. Write back with `status: dismissed`.
+ */
+export declare function runDismiss(args: string[], options?: DismissCommandOptions): Promise<number>;
+export declare const dismissCommand: Command;
+//# sourceMappingURL=dismiss.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss.d.ts","sourceRoot":"","sources":["../../src/cli/dismiss.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wFAAwF;AACxF,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB;AA8DD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,CAgDjB;AAED,eAAO,MAAM,cAAc,EAAE,OAI5B,CAAC"}

package/dist/cli/dismiss.js

@@ -0,0 +1,122 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { loadItems, saveItems } from "../core/items.js";
+function parseArgs(args) {
+    const out = {};
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "-h" || a === "--help") {
+            out.help = true;
+            continue;
+        }
+        if (a?.startsWith("--")) {
+            throw new Error(`unknown option: ${a}`);
+        }
+        if (!out.itemId) {
+            out.itemId = a;
+            continue;
+        }
+        throw new Error(`unexpected positional argument: ${a}`);
+    }
+    return out;
+}
+function printHelp(log) {
+    log("Usage: radar dismiss <item-id>");
+    log("");
+    log("Arguments:");
+    log("  <item-id>             Item id (matches items/<sourceId>/<item-id>.yaml)");
+    log("");
+    log("Transitions the item's status from `detected` to `dismissed` (ADR-0008).");
+    log("Items already in `researched`, `reviewed`, or `dismissed` cannot be dismissed.");
+}
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Locate `items/<sourceId>/<item-id>.yaml` across all source directories.
+ *
+ * Mirrors the lookup strategy used by `research`: `loadItems` walks every
+ * source subdir and we match by id, so the caller only needs `<item-id>`
+ * (sourceId is inferred from the loaded item).
+ */
+async function findItem(cwd, itemId) {
+    const itemsDir = join(cwd, "items");
+    if (!(await pathExists(itemsDir)))
+        return null;
+    const items = await loadItems(itemsDir);
+    const match = items.find((i) => i.id === itemId);
+    if (!match)
+        return null;
+    return { item: match };
+}
+/**
+ * Implementation of `radar dismiss <item-id>`.
+ *
+ * Triggers the `detected → dismissed` state transition (ADR-0008). The command
+ * is intentionally agent-free: it only mutates `items/<sourceId>/<item-id>.yaml`
+ * so users can prune noise from `watch run` output without spending agent
+ * tokens.
+ *
+ * Flow:
+ *   1. Parse + validate args.
+ *   2. Locate `items/<sourceId>/<item-id>.yaml`.
+ *   3. Reject if the item is not in `detected` (terminal/researched states
+ *      cannot be dismissed; there is no `undismiss`).
+ *   4. Write back with `status: dismissed`.
+ */
+export async function runDismiss(args, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const log = options.io?.log ?? ((m) => console.log(m));
+    const error = options.io?.error ?? ((m) => console.error(m));
+    let parsed;
+    try {
+        parsed = parseArgs(args);
+    }
+    catch (e) {
+        error(`dismiss: ${e instanceof Error ? e.message : String(e)}`);
+        return 2;
+    }
+    if (parsed.help) {
+        printHelp(log);
+        return 0;
+    }
+    if (!parsed.itemId) {
+        error("dismiss: missing <item-id>");
+        printHelp(error);
+        return 2;
+    }
+    const found = await findItem(cwd, parsed.itemId);
+    if (!found) {
+        error(`dismiss: item '${parsed.itemId}' not found under items/`);
+        return 1;
+    }
+    const { item } = found;
+    if (item.status !== "detected") {
+        error(`dismiss: item '${item.id}' is in status '${item.status}', expected 'detected' (dismiss is only valid from the detected state; ADR-0008)`);
+        return 1;
+    }
+    const updated = { ...item, status: "dismissed" };
+    try {
+        // saveItems writes by sourceId+id, so it overwrites the existing file in
+        // place. The status transition is the entire effect of the command.
+        await saveItems(join(cwd, "items"), [updated]);
+    }
+    catch (e) {
+        error(`dismiss: failed to update item status: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+    log(`dismiss: items/${item.sourceId}/${item.id}.yaml status -> dismissed`);
+    return 0;
+}
+export const dismissCommand = {
+    name: "dismiss",
+    summary: "Mark a detected item as dismissed (no research/review)",
+    run: (args) => runDismiss(args),
+};
+//# sourceMappingURL=dismiss.js.map

package/dist/cli/dismiss.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+export interface Command {
+    name: string;
+    summary: string;
+    run: (args: string[]) => Promise<number>;
+}
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAqCD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBvD"}

package/dist/cli/index.js

@@ -0,0 +1,64 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { dismissCommand } from "./dismiss.js";
+import { initCommand } from "./init.js";
+import { researchCommand } from "./research.js";
+import { reviewCommand } from "./review.js";
+import { sourceCommand } from "./source.js";
+import { updateCommand } from "./update.js";
+import { watchCommand } from "./watch.js";
+const commands = [
+    initCommand,
+    sourceCommand,
+    watchCommand,
+    researchCommand,
+    dismissCommand,
+    reviewCommand,
+    updateCommand,
+];
+// Read the installed package's version at runtime so `radar --version`
+// tracks release-please bumps without a parallel source edit. The bin
+// ships as dist/cli/index.js with package.json two levels up; the path
+// is identical in both npm-installed and local-built layouts because
+// tsc preserves src/ → dist/ structure.
+const PKG_PATH = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json");
+const VERSION = JSON.parse(readFileSync(PKG_PATH, "utf8")).version;
+function printHelp() {
+    console.log("FeedRadar — Multi-agent CLI for blog/release feed research");
+    console.log("");
+    console.log("Usage: radar <command> [options]");
+    console.log("");
+    console.log("Commands:");
+    for (const c of commands) {
+        console.log(`  ${c.name.padEnd(10)} ${c.summary}`);
+    }
+    console.log("");
+    console.log("Options:");
+    console.log("  -h, --help     Show this help");
+    console.log("  -v, --version  Show version");
+    console.log("");
+    console.log("Status: alpha — Phase 1-5 complete, Phase 6 (npm publish 0.1.0) pending.");
+}
+export async function run(argv) {
+    const [first, ...rest] = argv;
+    if (!first || first === "-h" || first === "--help" || first === "help") {
+        printHelp();
+        return;
+    }
+    if (first === "-v" || first === "--version" || first === "version") {
+        console.log(VERSION);
+        return;
+    }
+    const command = commands.find((c) => c.name === first);
+    if (!command) {
+        console.error(`radar: unknown command '${first}'`);
+        console.error("Run 'radar --help' for available commands.");
+        process.exit(2);
+    }
+    const code = await command.run(rest);
+    if (code !== 0) {
+        process.exit(code);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,148 @@
+import type { Command } from "./index.js";
+interface InitOptions {
+    cwd: string;
+    force: boolean;
+    /** Override the source location of bundled engine skills (used by tests). */
+    skillsRoot?: string;
+    /** Override the source location of bundled init templates (used by tests). */
+    templatesRoot?: string;
+    /** Override the source location of bundled Claude discovery skills (used by tests). */
+    claudeSkillsRoot?: string;
+    /** Override the source location of bundled Gemini CLI command TOMLs (used by tests). */
+    geminiCommandsRoot?: string;
+    /**
+     * Skip writing Claude Code slash-command wrappers to
+     * `<cwd>/.claude/skills/`. Useful for workspaces that already manage that
+     * directory via the `@ozzylabs/skills` Renovate preset and don't want
+     * FeedRadar's discovery skills to land alongside the preset ones.
+     *
+     * The engine SKILLs at `<cwd>/.agents/skills/` (which the agent adapter
+     * reads when the CLI spawns the agent) are always written regardless of
+     * this flag; they are the SSoT.
+     */
+    noClaudeSkills?: boolean;
+    /**
+     * Skip writing Gemini CLI slash-command TOMLs to
+     * `<cwd>/.gemini/commands/`. Useful for workspaces that already manage
+     * that directory via another mechanism, or that don't use Gemini CLI.
+     *
+     * The engine SKILLs at `<cwd>/.agents/skills/` are always written
+     * regardless of this flag; they are the SSoT. Codex CLI / Gemini CLI
+     * interactive sessions also fall back to the engine SKILLs via the
+     * "Invocation modes" dual-mode procedure when no slash command is
+     * configured.
+     */
+    noGeminiCommands?: boolean;
+    /**
+     * Skip writing `<cwd>/AGENTS.md`. By default `init` copies the bundled
+     * AGENTS.md template into the workspace so that agent CLIs which auto-read
+     * an agent-agnostic instructions file (Codex / Gemini / Copilot) get
+     * workspace context (available commands, typical workflow, docs pointers)
+     * the moment a user opens an interactive session.
+     *
+     * Useful for workspaces that already manage their own AGENTS.md (e.g. a
+     * monorepo with project-wide instructions) and don't want FeedRadar's
+     * boilerplate to land at the root.
+     *
+     * See ADR-0007 (revised 2026-05-17 b) for the four-layer init bundle
+     * (engine SKILL / claude discovery / AGENTS.md / schedule scaffolds).
+     */
+    noAgentsMd?: boolean;
+    /**
+     * Skip writing `<cwd>/CLAUDE.md`. By default `init` writes a minimal
+     * `CLAUDE.md` at the workspace root that re-exports `AGENTS.md` via the
+     * `@AGENTS.md` import directive. Without `CLAUDE.md`, Claude Code does
+     * not auto-read `AGENTS.md`, so the industry-standard pattern of "single
+     * source of truth in AGENTS.md, imported by CLAUDE.md" breaks.
+     *
+     * Useful for workspaces that already manage their own `CLAUDE.md` (and
+     * load `AGENTS.md` via a different mechanism) or that don't use Claude
+     * Code at all.
+     *
+     * Note: when `noAgentsMd` is true, the bundled `CLAUDE.md` template's
+     * `@AGENTS.md` import would dangle, so `init` auto-skips `CLAUDE.md` in
+     * that case and emits a warning explaining why.
+     */
+    noClaudeMd?: boolean;
+    /**
+     * Skip writing `<cwd>/templates/default.md`. By default `init` emits a
+     * starter Markdown template body that mirrors the engine `research`
+     * SKILL's fallback structure (要約 / 詳細 / 出典). The file is the
+     * first editable artifact the user can tweak to customize report
+     * shape; the research engine SKILL falls back to its own built-in
+     * structure when `templateBody` is empty, so skipping does not break
+     * runtime behavior — it only removes the editable starter.
+     *
+     * Useful for workspaces that manage `templates/` via another mechanism
+     * or that already have a populated `templates/default.md`.
+     */
+    noTemplates?: boolean;
+    /**
+     * Skip writing `<cwd>/FEEDRADAR.md` (human-facing workspace guide).
+     * By default `init` emits this file at the workspace root to teach the
+     * user how to drive the workspace via natural-language requests to AI
+     * agents (primary) or CLI direct invocation (secondary). Useful for
+     * workspaces that already have their own user-facing documentation, or
+     * that manage this file via another mechanism.
+     */
+    noFeedradarMd?: boolean;
+    /**
+     * Emit the Claude Routines schedule template
+     * (`claude/routines/watch-daily.md`).
+     */
+    withRoutines?: boolean;
+    /**
+     * Emit the GitHub Actions schedule template (`.github/workflows/watch.yaml`).
+     */
+    withActions?: boolean;
+    /** Sink for warnings; defaults to console.warn. */
+    warn?: (message: string) => void;
+    /** Sink for info messages; defaults to console.log. */
+    info?: (message: string) => void;
+}
+interface InitResult {
+    createdDirs: string[];
+    copiedFiles: string[];
+    skippedFiles: string[];
+}
+/**
+ * Initialize the current directory as a FeedRadar workspace.
+ *
+ * Creates the canonical workspace directories and copies bundled SKILL.md
+ * files into `.agents/skills/<name>/SKILL.md`. Existing files are protected
+ * unless `force` is true.
+ *
+ * Claude Code discoverability (ADR-0007, revised 2026-05-17 via #75): in
+ * addition to the engine SKILLs at `.agents/skills/`, `init` also writes
+ * thin slash-command wrappers to `.claude/skills/` so that Claude Code,
+ * when opened interactively in the workspace, surfaces `/research` /
+ * `/review` / `/update` / `/dismiss`. The wrappers delegate to the
+ * `radar` CLI rather than duplicating the engine procedure (the
+ * engine SKILL at `.agents/skills/<name>/SKILL.md` remains the SSoT).
+ * Existing files are protected, so workspaces that already manage
+ * `.claude/skills/` via the `@ozzylabs/skills` Renovate preset won't be
+ * surprised; alternatively use `--no-claude-skills` to skip the discovery
+ * layer entirely.
+ *
+ * Multi-agent context (ADR-0007, revised 2026-05-17 b via #77): `init`
+ * also writes an agent-agnostic `AGENTS.md` at the workspace root. Codex
+ * CLI, Gemini CLI, and GitHub Copilot CLI auto-read this file when opened
+ * interactively in the workspace, giving those agents context about
+ * available commands, typical workflow, and docs pointers without any
+ * extra setup. Opt out via `--no-agents-md` (workspaces that already have
+ * their own AGENTS.md).
+ *
+ * Gemini CLI slash commands (ADR-0007, revised 2026-05-17 c via #78):
+ * `init` writes Gemini CLI's native slash command TOMLs at
+ * `<cwd>/.gemini/commands/{research,review,update,dismiss}.toml`. These
+ * thin wrappers shell out to the `radar` CLI through Gemini's
+ * `{{args}}` interpolation, surfacing `/research` etc. inside Gemini CLI
+ * interactive sessions. Opt out via `--no-gemini-commands` (engine SKILLs
+ * remain in place via the dual-mode "Invocation modes" fallback). This
+ * closes the slash-command UX gap for Gemini CLI (Codex CLI is covered by
+ * the engine SKILL dual-mode procedure itself).
+ */
+export declare function initWorkspace(options: InitOptions): Promise<InitResult>;
+export declare const initCommand: Command;
+export {};
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA0F1C,UAAU,WAAW;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mDAAmD;IACnD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,uDAAuD;IACvD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAoJD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAuN7E;AAoGD,eAAO,MAAM,WAAW,EAAE,OAkGzB,CAAC"}