@ozzylabs/feedradar 0.1.0

package/dist/cli/review.js

@@ -0,0 +1,418 @@
+import { access, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import matter from "gray-matter";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { getAgentAdapter } from "../agents/index.js";
+import { getDefaultAgent, loadRadarConfig, RadarConfigError } from "../core/config.js";
+import { loadItems, saveItems } from "../core/items.js";
+import { loadTemplate } from "../core/templates.js";
+import { AgentIdSchema, ResearchFrontmatterSchema } from "../schemas/index.js";
+/**
+ * gray-matter defaults to js-yaml which auto-converts ISO 8601 strings to
+ * `Date` objects. That breaks `ResearchFrontmatterSchema`, which expects
+ * timestamps as strings. Swap in the `yaml` v2 engine for parity with the
+ * `research` command (see src/cli/research.ts for the same rationale).
+ */
+const matterOptions = {
+    engines: {
+        yaml: {
+            parse: (s) => parseYaml(s),
+            stringify: (data) => stringifyYaml(data),
+        },
+    },
+};
+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 === "--agent") {
+            out.agent = args[++i];
+            continue;
+        }
+        if (a === "--template") {
+            out.template = args[++i];
+            continue;
+        }
+        if (a?.startsWith("--")) {
+            throw new Error(`unknown option: ${a}`);
+        }
+        if (!out.researchId) {
+            out.researchId = a;
+            continue;
+        }
+        throw new Error(`unexpected positional argument: ${a}`);
+    }
+    return out;
+}
+function printHelp(log) {
+    log("Usage: radar review <research-id> [--agent <agent-id>] [--template <template-id>]");
+    log("");
+    log("Arguments:");
+    log("  <research-id>         Research id (basename of research/<id>.md without .md)");
+    log("");
+    log("Options:");
+    log("  --agent <agent-id>    claude-code | codex-cli | gemini-cli | copilot (default: claude-code)");
+    log("  --template <id>       Template id under templates/ (default: default)");
+    log("");
+    log("Appends a review block to research/<research-id>.md, stamps the");
+    log("frontmatter `reviewedAt` / `reviewedBy`, and transitions the linked");
+    log("items/<id>.yaml `status` from `researched` to `reviewed`. Both updates");
+    log("happen atomically — a partial failure rolls back the research file.");
+}
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve `<research-id>` to the actual file on disk.
+ *
+ * The CLI accepts both `<id>` and `<id>.md` for ergonomics. We validate the
+ * resulting path stays inside `research/` so a malicious id like
+ * `../etc/passwd` cannot escape the workspace.
+ */
+function resolveResearchPath(cwd, researchId) {
+    const id = researchId.endsWith(".md") ? researchId.slice(0, -3) : researchId;
+    if (id.includes("/") || id.includes("\\") || id.includes("..")) {
+        throw new Error(`invalid <research-id>: '${researchId}'`);
+    }
+    return join(cwd, "research", `${id}.md`);
+}
+/**
+ * Locate the items/<sourceId>/<itemId>.yaml files for a research file's
+ * `itemIds`. The research frontmatter records `itemIds` (zero or more) so we
+ * need to walk the items dir to find each one — items are stored under the
+ * source dir, and the CLI does not carry sourceId in the research frontmatter
+ * (ADR-0003 keeps the schema minimal).
+ */
+async function findItemsForResearch(cwd, itemIds) {
+    const itemsDir = join(cwd, "items");
+    if (!(await pathExists(itemsDir)))
+        return [];
+    const allItems = await loadItems(itemsDir);
+    const out = [];
+    for (const id of itemIds) {
+        const match = allItems.find((i) => i.id === id);
+        if (match)
+            out.push(match);
+    }
+    return out;
+}
+/**
+ * Restore the snapshot. Best-effort — if a restore step itself fails, we
+ * surface the error to the caller so they can warn the user that manual
+ * recovery is required, but we still attempt the remaining restores.
+ */
+async function restoreSnapshot(snapshot) {
+    const errors = [];
+    try {
+        await writeFile(snapshot.researchPath, snapshot.researchBody, "utf8");
+    }
+    catch (e) {
+        errors.push(e instanceof Error ? e : new Error(String(e)));
+    }
+    try {
+        await saveItems(snapshot.itemsDir, snapshot.items);
+    }
+    catch (e) {
+        errors.push(e instanceof Error ? e : new Error(String(e)));
+    }
+    return errors;
+}
+/**
+ * Implementation of `radar review <research-id>`.
+ *
+ * High-level flow (Phase 2):
+ *   1. Parse + validate args (agent defaults to `claude-code`, template to `default`).
+ *   2. Resolve `research/<research-id>.md` and parse its frontmatter.
+ *   3. Refuse to re-review (frontmatter already has `reviewedAt`).
+ *   4. Locate the linked items and verify their status is `researched`.
+ *   5. Load `templates/<template-id>.md` (empty body when default is absent).
+ *   6. Snapshot the research file body and item payloads (rollback target).
+ *   7. Invoke the adapter; the agent rewrites the research file in place
+ *      (appends review block + stamps `reviewedAt` / `reviewedBy`).
+ *   8. Re-read the research file, validate the updated frontmatter.
+ *   9. Transition each linked item: `status` → `reviewed` and persist.
+ *      If this step fails, restore the snapshot from (6) and exit non-zero.
+ *
+ * The snapshot/restore strategy gives us atomicity at the workspace level
+ * (ADR-0003 / ADR-0008): either both the research file and the linked items
+ * reflect the new review, or neither does.
+ */
+export async function runReview(args, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const log = options.io?.log ?? ((m) => console.log(m));
+    const warn = options.io?.warn ?? ((m) => console.warn(m));
+    const error = options.io?.error ?? ((m) => console.error(m));
+    let parsed;
+    try {
+        parsed = parseArgs(args);
+    }
+    catch (e) {
+        error(`review: ${e instanceof Error ? e.message : String(e)}`);
+        return 2;
+    }
+    if (parsed.help) {
+        printHelp(log);
+        return 0;
+    }
+    if (!parsed.researchId) {
+        error("review: missing <research-id>");
+        printHelp(error);
+        return 2;
+    }
+    // Resolve the agent honoring the priority chain:
+    //   explicit --agent > radar.config.yaml defaultReviewAgent > "claude-code"
+    // The explicit value is validated against AgentIdSchema first so a bogus
+    // --agent never reaches the config / fallback path. Mirrors runResearch's
+    // resolver so #29 (review) and #30 (radar.config) stay aligned.
+    let explicitAgent;
+    if (parsed.agent !== undefined) {
+        const agentResult = AgentIdSchema.safeParse(parsed.agent);
+        if (!agentResult.success) {
+            error(`review: invalid --agent '${parsed.agent}' (expected: claude-code | codex-cli | gemini-cli | copilot)`);
+            return 2;
+        }
+        explicitAgent = agentResult.data;
+    }
+    let agent;
+    try {
+        const config = await loadRadarConfig(cwd);
+        agent = await getDefaultAgent("review", { explicit: explicitAgent, configOverride: config });
+    }
+    catch (e) {
+        if (e instanceof RadarConfigError) {
+            error(`review: ${e.message}`);
+            return 2;
+        }
+        throw e;
+    }
+    // Phase 2 sub-issues B / C / D / E ship all four adapters. AgentIdSchema
+    // already rejected invalid `--agent` values upstream, so any value that
+    // reaches here is supported.
+    const templateId = parsed.template ?? "default";
+    // Resolve research path.
+    let researchPath;
+    try {
+        researchPath = resolveResearchPath(cwd, parsed.researchId);
+    }
+    catch (e) {
+        error(`review: ${e instanceof Error ? e.message : String(e)}`);
+        return 2;
+    }
+    if (!(await pathExists(researchPath))) {
+        error(`review: research file not found: ${researchPath}`);
+        return 1;
+    }
+    // Parse research frontmatter (pre-review state).
+    let researchBody;
+    try {
+        researchBody = await readFile(researchPath, "utf8");
+    }
+    catch (e) {
+        error(`review: failed to read research file: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+    let preFrontmatter;
+    try {
+        preFrontmatter = matter(researchBody, matterOptions).data;
+    }
+    catch (e) {
+        error(`review: failed to parse frontmatter: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+    const preResult = ResearchFrontmatterSchema.safeParse(preFrontmatter);
+    if (!preResult.success) {
+        error(`review: research frontmatter does not match ResearchFrontmatterSchema:`);
+        for (const issue of preResult.error.issues) {
+            error(`  - ${issue.path.join(".") || "<root>"}: ${issue.message}`);
+        }
+        return 1;
+    }
+    const preFm = preResult.data;
+    // Refuse re-review. ADR-0008 leaves "re-review after update" undefined and
+    // we explicitly block the idempotent case here so users do not silently
+    // overwrite an existing review stamp.
+    if (preFm.reviewedAt !== null || preFm.reviewedBy !== null) {
+        error(`review: research '${preFm.id}' is already reviewed (reviewedAt=${preFm.reviewedAt}, reviewedBy=${preFm.reviewedBy})`);
+        return 1;
+    }
+    // Resolve linked items.
+    const linkedItems = await findItemsForResearch(cwd, preFm.itemIds);
+    if (linkedItems.length === 0) {
+        error(`review: no items/<id>.yaml found for itemIds=[${preFm.itemIds.join(", ")}] referenced by ${preFm.id}`);
+        return 1;
+    }
+    if (linkedItems.length !== preFm.itemIds.length) {
+        const found = new Set(linkedItems.map((i) => i.id));
+        const missing = preFm.itemIds.filter((id) => !found.has(id));
+        error(`review: ${missing.length} linked item(s) not found: ${missing.join(", ")} (referenced by ${preFm.id})`);
+        return 1;
+    }
+    const unresearched = linkedItems.filter((i) => i.status !== "researched");
+    if (unresearched.length > 0) {
+        error(`review: linked items must be in status 'researched' before review. Offenders: ${unresearched
+            .map((i) => `${i.id}=${i.status}`)
+            .join(", ")}`);
+        return 1;
+    }
+    // Surface any prompt-injection pre-filter hits recorded by the watcher
+    // (ADR-0009 M1a / M5a — Adopt). Audit-only: review still proceeds against
+    // the original research file, but the user sees the audit trail before
+    // tokens are spent on the cross-agent review pass.
+    for (const linked of linkedItems) {
+        if (linked.injectionFlags.length > 0) {
+            warn(`review: item '${linked.id}' has ${linked.injectionFlags.length} injection flag(s): ${linked.injectionFlags.join(", ")} (audit-only; the linked research was generated from possibly tainted content)`);
+        }
+    }
+    // Load template.
+    const templatesDir = join(cwd, "templates");
+    let template;
+    try {
+        template = await loadTemplate(templateId, templatesDir);
+    }
+    catch (e) {
+        error(`review: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+    // Snapshot for atomic rollback.
+    const itemsDir = join(cwd, "items");
+    const snapshot = {
+        researchPath,
+        researchBody,
+        itemsDir,
+        items: linkedItems.map((i) => ({ ...i })),
+    };
+    log(`review: invoking ${agent} adapter for research '${preFm.id}'`);
+    // Invoke adapter.
+    const adapter = getAgentAdapter(agent);
+    try {
+        await adapter.review({
+            agent,
+            templateId,
+            templateBody: template.body,
+            researchPath,
+            researchFrontmatter: preFm,
+            researchBody,
+            cwd,
+        });
+    }
+    catch (e) {
+        error(`review: adapter failed: ${e instanceof Error ? e.message : String(e)}`);
+        // The agent may have partially written to researchPath before failing.
+        // Restore the snapshot so the workspace stays consistent.
+        const restoreErrors = await restoreSnapshot(snapshot);
+        if (restoreErrors.length > 0) {
+            for (const re of restoreErrors) {
+                error(`review: rollback partially failed: ${re.message}`);
+            }
+            error(`review: workspace may be in an inconsistent state — inspect ${researchPath} and items/`);
+        }
+        else {
+            warn("review: rolled back research file and item status to pre-review state");
+        }
+        return 1;
+    }
+    // Re-read and validate the modified research file.
+    let postBody;
+    try {
+        postBody = await readFile(researchPath, "utf8");
+    }
+    catch (e) {
+        error(`review: failed to read research file after adapter: ${e instanceof Error ? e.message : String(e)}`);
+        await restoreSnapshot(snapshot);
+        return 1;
+    }
+    let postFrontmatter;
+    try {
+        postFrontmatter = matter(postBody, matterOptions).data;
+    }
+    catch (e) {
+        error(`review: failed to parse frontmatter after adapter: ${e instanceof Error ? e.message : String(e)}`);
+        await restoreSnapshot(snapshot);
+        return 1;
+    }
+    const postResult = ResearchFrontmatterSchema.safeParse(postFrontmatter);
+    if (!postResult.success) {
+        error(`review: post-adapter frontmatter does not match ResearchFrontmatterSchema:`);
+        for (const issue of postResult.error.issues) {
+            error(`  - ${issue.path.join(".") || "<root>"}: ${issue.message}`);
+        }
+        await restoreSnapshot(snapshot);
+        return 1;
+    }
+    const postFm = postResult.data;
+    if (postFm.reviewedAt === null) {
+        error("review: adapter completed but did not stamp `reviewedAt` in frontmatter");
+        await restoreSnapshot(snapshot);
+        return 1;
+    }
+    if (postFm.reviewedBy !== agent) {
+        error(`review: adapter stamped reviewedBy='${postFm.reviewedBy}', expected '${agent}'`);
+        await restoreSnapshot(snapshot);
+        return 1;
+    }
+    // Other immutable frontmatter fields must remain unchanged. Catching a
+    // misbehaving agent that rewrote `id` / `itemIds` / `agent` / `createdAt` /
+    // `supersedes` here is cheaper than letting the inconsistency leak
+    // downstream. `supersedes` is owned by `research` (v1=null) and `update`
+    // (v+1=<prev id>); `review` must never touch it.
+    const drift = [];
+    if (postFm.id !== preFm.id)
+        drift.push(`id (${preFm.id} -> ${postFm.id})`);
+    if (postFm.agent !== preFm.agent)
+        drift.push(`agent (${preFm.agent} -> ${postFm.agent})`);
+    if (postFm.templateId !== preFm.templateId)
+        drift.push(`templateId (${preFm.templateId} -> ${postFm.templateId})`);
+    if (postFm.createdAt !== preFm.createdAt)
+        drift.push(`createdAt (${preFm.createdAt} -> ${postFm.createdAt})`);
+    if (JSON.stringify(postFm.itemIds) !== JSON.stringify(preFm.itemIds))
+        drift.push(`itemIds (${preFm.itemIds.join(",")} -> ${postFm.itemIds.join(",")})`);
+    if (postFm.supersedes !== preFm.supersedes)
+        drift.push(`supersedes (${preFm.supersedes} -> ${postFm.supersedes})`);
+    if (drift.length > 0) {
+        error(`review: adapter mutated immutable frontmatter fields: ${drift.join("; ")}`);
+        await restoreSnapshot(snapshot);
+        return 1;
+    }
+    // Now transition item status. If this fails (filesystem error, permissions,
+    // etc.), restore both the research file and the items snapshot so the
+    // workspace stays atomic.
+    const updatedItems = linkedItems.map((i) => ({ ...i, status: "reviewed" }));
+    try {
+        await saveItems(itemsDir, updatedItems);
+    }
+    catch (e) {
+        error(`review: failed to update item status: ${e instanceof Error ? e.message : String(e)}`);
+        const restoreErrors = await restoreSnapshot(snapshot);
+        if (restoreErrors.length > 0) {
+            for (const re of restoreErrors) {
+                error(`review: rollback partially failed: ${re.message}`);
+            }
+            error(`review: workspace may be in an inconsistent state — inspect ${researchPath} and items/`);
+        }
+        else {
+            warn("review: rolled back research file (item status update failed)");
+        }
+        return 1;
+    }
+    log(`review: stamped ${researchPath} reviewedAt=${postFm.reviewedAt} reviewedBy=${agent}`);
+    for (const item of updatedItems) {
+        log(`review: items/${item.sourceId}/${item.id}.yaml status -> reviewed`);
+    }
+    return 0;
+}
+export const reviewCommand = {
+    name: "review",
+    summary: "Cross-review existing research reports using a different AI agent",
+    run: (args) => runReview(args),
+};
+//# sourceMappingURL=review.js.map

package/dist/cli/review.js.map

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

package/dist/cli/source.d.ts

@@ -0,0 +1,57 @@
+import type { Command } from "./index.js";
+/**
+ * Sinks for the source command's user-facing output.
+ *
+ * The CLI binds these to `console.*` by default; tests inject capturing sinks
+ * to assert against printed lines without poking at stdio.
+ *
+ * `warn` is separate from `error` so non-fatal hints (e.g. "no keywords
+ * configured — items will be filtered out") still surface on stderr without
+ * affecting the exit code or being treated as a hard failure by callers.
+ */
+export interface SourceIO {
+    log?: (message: string) => void;
+    warn?: (message: string) => void;
+    error?: (message: string) => void;
+}
+/** Options accepted across all `source` subcommands. */
+export interface SourceCommandOptions {
+    /** Workspace root (defaults to `process.cwd()` for the real CLI). */
+    cwd?: string;
+    io?: SourceIO;
+}
+/**
+ * Implementation of `source add`.
+ *
+ * Builds a Source object from CLI flags, validates it with the Zod schema, and
+ * writes `sources/<id>.yaml`. Refuses to overwrite an existing file (issue #12
+ * explicitly forbids `--force`-style escape hatches; YAML edits remain the
+ * supported workflow for mutation).
+ */
+export declare function addSource(args: string[], options?: SourceCommandOptions): Promise<number>;
+/**
+ * Implementation of `source list`.
+ *
+ * Renders a fixed-width table (id / kind / url / tags). When no sources exist
+ * we print a guidance message instead of an empty table so first-time users
+ * are nudged toward `source add`.
+ */
+export declare function listSources(args: string[], options?: SourceCommandOptions): Promise<number>;
+/**
+ * Implementation of `source remove`.
+ *
+ * Deletes `sources/<id>.yaml` only. Per user-guide.md and issue #12, this
+ * intentionally preserves `state/<id>.yaml` and any `items/` history so users
+ * never lose recorded research by toggling a source off.
+ */
+export declare function removeSource(args: string[], options?: SourceCommandOptions): Promise<number>;
+/**
+ * Top-level dispatcher for `radar source <subcommand>`.
+ *
+ * Sub-commands are kept as named functions (addSource/listSources/removeSource)
+ * so tests can call them directly with injected IO sinks without spawning the
+ * full CLI.
+ */
+export declare function runSource(args: string[], options?: SourceCommandOptions): Promise<number>;
+export declare const sourceCommand: Command;
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/cli/source.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,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,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AA4ND;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAoHjB;AA6CD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CA2FjB;AA4BD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAmCjB;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,eAAO,MAAM,aAAa,EAAE,OAI3B,CAAC"}