@ozzylabs/feedradar 0.1.0

package/dist/cli/research.js

@@ -0,0 +1,313 @@
+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";
+/**
+ * gray-matter defaults to js-yaml, which auto-converts ISO 8601 strings to
+ * Date objects per the YAML 1.1 timestamp tag. That breaks
+ * `ResearchFrontmatterSchema`, which expects `createdAt` / `updatedAt` to be
+ * strings (ADR-0003). Swap in the `yaml` v2 engine (already a dep of this
+ * package) which keeps quoted/unquoted ISO 8601 as a plain string.
+ */
+const matterOptions = {
+    engines: {
+        yaml: {
+            parse: (s) => parseYaml(s),
+            stringify: (data) => stringifyYaml(data),
+        },
+    },
+};
+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";
+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.itemId) {
+            out.itemId = a;
+            continue;
+        }
+        throw new Error(`unexpected positional argument: ${a}`);
+    }
+    return out;
+}
+function printHelp(log) {
+    log("Usage: radar research <item-id> [--agent <agent-id>] [--template <template-id>]");
+    log("");
+    log("Arguments:");
+    log("  <item-id>             Item id (matches items/<sourceId>/<item-id>.yaml)");
+    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("Writes research/<YYYYMMDD>_<slug>_v1.md (ADR-0003).");
+}
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Slug an Item into the `<sourceId>-<short-slug>` form used by the research
+ * filename (`research/<YYYYMMDD>_<slug>_v1.md`).
+ *
+ * Falls back to the item id when the title is empty/unicode-only. We trim to
+ * 60 chars so the resulting filename stays inside typical filesystem limits
+ * after adding date prefix and version suffix.
+ */
+function buildSlug(item) {
+    const baseSource = item.sourceId.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+    const titleSlug = item.title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+    const tail = titleSlug ||
+        item.id
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .slice(0, 60);
+    return `${baseSource}-${tail}`;
+}
+/**
+ * Pick `YYYYMMDD` from the item's `publishedAt`, falling back to today (UTC)
+ * when the source feed did not provide a publish date.
+ */
+function buildDatePrefix(item, now) {
+    const iso = item.publishedAt ?? now.toISOString();
+    return iso.slice(0, 10).replace(/-/g, "");
+}
+/**
+ * Locate `items/<sourceId>/<item-id>.yaml` across all source directories,
+ * since the CLI only takes `<item-id>` (sourceId is not on the command line).
+ *
+ * `loadItems` already walks every source subdir, so we delegate to it and
+ * then match by id. Returning the full Item (rather than just the path) lets
+ * the caller compute slug / date without a second read.
+ */
+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 research <item-id>`.
+ *
+ * High-level flow (Phase 1):
+ *   1. Parse + validate args (agent defaults to `claude-code`, template to `default`).
+ *   2. Locate `items/<sourceId>/<item-id>.yaml` and parse it.
+ *   3. Load `templates/<template-id>.md` (empty body when default is absent).
+ *   4. Compute `research/<YYYYMMDD>_<slug>_v1.md`; refuse to overwrite an
+ *      existing file (re-runs go through `update` per ADR-0003).
+ *   5. Invoke the registered agent adapter; the agent writes the report.
+ *   6. Validate the report's frontmatter against `ResearchFrontmatterSchema`.
+ *   7. Transition the item: `status` → `researched` and persist.
+ *
+ * Any step from 4 onward that fails surfaces a non-zero exit code with a
+ * targeted message so the user can debug without re-reading the source.
+ */
+export async function runResearch(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(`research: ${e instanceof Error ? e.message : String(e)}`);
+        return 2;
+    }
+    if (parsed.help) {
+        printHelp(log);
+        return 0;
+    }
+    if (!parsed.itemId) {
+        error("research: missing <item-id>");
+        printHelp(error);
+        return 2;
+    }
+    // Resolve the agent honoring the priority chain:
+    //   explicit --agent > radar.config.yaml defaultResearchAgent > "claude-code"
+    // The explicit value is validated against AgentIdSchema first so a bogus
+    // --agent never reaches the config / fallback path.
+    let explicitAgent;
+    if (parsed.agent !== undefined) {
+        const agentResult = AgentIdSchema.safeParse(parsed.agent);
+        if (!agentResult.success) {
+            error(`research: 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("research", { explicit: explicitAgent, configOverride: config });
+    }
+    catch (e) {
+        if (e instanceof RadarConfigError) {
+            error(`research: ${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";
+    // Locate the item.
+    const found = await findItem(cwd, parsed.itemId);
+    if (!found) {
+        error(`research: item '${parsed.itemId}' not found under items/`);
+        return 1;
+    }
+    const { item } = found;
+    // Surface any prompt-injection pre-filter hits recorded by the watcher
+    // (ADR-0009 M1a / M5a — Adopt). Audit-only: the agent still runs against
+    // the original content, but the user gets an explicit warning so they can
+    // `radar dismiss` and re-evaluate before committing tokens.
+    if (item.injectionFlags.length > 0) {
+        warn(`research: item '${item.id}' has ${item.injectionFlags.length} injection flag(s): ${item.injectionFlags.join(", ")} (audit-only; use \`radar dismiss\` to skip)`);
+    }
+    // Load template.
+    const templatesDir = join(cwd, "templates");
+    let template;
+    try {
+        template = await loadTemplate(templateId, templatesDir);
+    }
+    catch (e) {
+        error(`research: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+    // Compute output path. Refuse to overwrite an existing file — re-runs go
+    // through `radar update` per ADR-0003 (immutable history).
+    const now = new Date();
+    const datePrefix = buildDatePrefix(item, now);
+    const slug = buildSlug(item);
+    const filename = `${datePrefix}_${slug}_v1.md`;
+    const outputPath = join(cwd, "research", filename);
+    if (await pathExists(outputPath)) {
+        error(`research: ${outputPath} already exists (use \`radar update\` to re-research)`);
+        return 1;
+    }
+    log(`research: invoking ${agent} adapter for item '${item.id}' -> ${filename}`);
+    // Invoke adapter.
+    const adapter = getAgentAdapter(agent);
+    try {
+        await adapter.research({
+            agent,
+            templateId,
+            templateBody: template.body,
+            items: [item],
+            outputPath,
+            cwd,
+        });
+    }
+    catch (e) {
+        error(`research: adapter failed: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+    // Validate the produced file: frontmatter must parse and match schema.
+    if (!(await pathExists(outputPath))) {
+        error(`research: adapter completed but did not write ${outputPath} (agent ignored the output path?)`);
+        return 1;
+    }
+    let body;
+    try {
+        body = await readFile(outputPath, "utf8");
+    }
+    catch (e) {
+        error(`research: failed to read generated report: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+    let frontmatter;
+    try {
+        frontmatter = matter(body, matterOptions).data;
+    }
+    catch (e) {
+        error(`research: failed to parse frontmatter: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+    const fmResult = ResearchFrontmatterSchema.safeParse(frontmatter);
+    if (!fmResult.success) {
+        error(`research: frontmatter does not match ResearchFrontmatterSchema:`);
+        for (const issue of fmResult.error.issues) {
+            error(`  - ${issue.path.join(".") || "<root>"}: ${issue.message}`);
+        }
+        return 1;
+    }
+    // Phase 1 contract: review fields must be null. The schema permits null;
+    // we additionally enforce that the agent did not jump ahead and stamp them.
+    // Phase 5 contract: `supersedes` is null on v1 by definition (no predecessor
+    // exists). Defensive reset applies if a misbehaving agent populates it; the
+    // `update` command (Sub-issue B / #41) is the only writer that may set it.
+    const reviewedDrift = fmResult.data.reviewedAt !== null || fmResult.data.reviewedBy !== null;
+    const supersedesDrift = fmResult.data.supersedes !== null;
+    if (reviewedDrift || supersedesDrift) {
+        if (reviewedDrift) {
+            warn("research: agent populated reviewedAt/reviewedBy; resetting to null (Phase 1 contract — review handles this in Phase 2)");
+        }
+        if (supersedesDrift) {
+            warn("research: agent populated supersedes; resetting to null (Phase 5 contract — v1 has no predecessor; `update` writes supersedes)");
+        }
+        const parsed = matter(body, matterOptions);
+        const rewritten = matter.stringify(parsed.content, {
+            ...fmResult.data,
+            reviewedAt: null,
+            reviewedBy: null,
+            supersedes: null,
+        }, matterOptions);
+        await writeFile(outputPath, rewritten, "utf8");
+    }
+    // Transition item status.
+    const updated = { ...item, status: "researched" };
+    try {
+        // saveItems writes by sourceId+id, so it will overwrite the existing file
+        // in place. We rely on this rather than constructing the path manually.
+        await saveItems(join(cwd, "items"), [updated]);
+    }
+    catch (e) {
+        error(`research: failed to update item status: ${e instanceof Error ? e.message : String(e)}`);
+        error(`  (research file was written: ${outputPath})`);
+        return 1;
+    }
+    log(`research: wrote ${outputPath}`);
+    log(`research: items/${item.sourceId}/${item.id}.yaml status -> researched`);
+    return 0;
+}
+export const researchCommand = {
+    name: "research",
+    summary: "Generate Markdown research reports from items via an AI agent",
+    run: (args) => runResearch(args),
+};
+//# sourceMappingURL=research.js.map

package/dist/cli/research.js.map

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

package/dist/cli/review.d.ts

@@ -0,0 +1,34 @@
+import type { Command } from "./index.js";
+/** Sinks for the review command's user-facing output. Tests inject capturing sinks. */
+export interface ReviewIO {
+    log?: (message: string) => void;
+    warn?: (message: string) => void;
+    error?: (message: string) => void;
+}
+export interface ReviewCommandOptions {
+    cwd?: string;
+    io?: ReviewIO;
+}
+/**
+ * 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 declare function runReview(args: string[], options?: ReviewCommandOptions): Promise<number>;
+export declare const reviewCommand: Command;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/cli/review.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAiB1C,uFAAuF;AACvF,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,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAqID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CA2RjB;AAED,eAAO,MAAM,aAAa,EAAE,OAI3B,CAAC"}