@ozzylabs/feedradar 0.1.0

package/dist/cli/init.js

@@ -0,0 +1,578 @@
+import { access, copyFile, mkdir, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Resolve the directory holding the bundled skill assets (`dist/skills/`).
+ *
+ * The compiled CLI lives at `dist/cli/init.js`, so the bundled skills sit at
+ * `../skills` relative to this module. During tests we may be running from
+ * source (`src/cli/init.ts`), so we also fall back to `src/skills/` if the
+ * compiled location does not exist.
+ */
+async function resolveSkillsRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    // Compiled layout: dist/cli/init.js -> dist/skills
+    const compiled = resolve(here, "../skills");
+    if (await pathExists(compiled)) {
+        return compiled;
+    }
+    // Source layout fallback: src/cli/init.ts -> src/skills (used by tests run on .ts).
+    const source = resolve(here, "../skills");
+    return source;
+}
+/** Same resolution strategy as `resolveSkillsRoot`, but for `src|dist/templates`. */
+async function resolveTemplatesRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const compiled = resolve(here, "../templates");
+    if (await pathExists(compiled)) {
+        return compiled;
+    }
+    return resolve(here, "../templates");
+}
+/**
+ * Resolve the directory holding the bundled Claude Code slash-command
+ * wrappers (`dist/claude-skills/`).
+ *
+ * These are distinct from the engine SKILLs at `dist/skills/`. The engine
+ * SKILLs land at `<cwd>/.agents/skills/<name>/SKILL.md` and are read by the
+ * agent adapter when the CLI spawns claude/codex/gemini/copilot. The Claude
+ * discovery skills land at `<cwd>/.claude/skills/<name>/SKILL.md` so that
+ * Claude Code, when opened in the workspace, surfaces `/research` /
+ * `/review` / `/update` / `/dismiss` as invocable slash commands. The
+ * discovery skills are thin wrappers — they shell out to the `radar`
+ * CLI rather than duplicating the engine procedure.
+ *
+ * See ADR-0007 (revised 2026-05-17) for the policy and `docs/design/
+ * skill-design.md` for the SSoT vs discovery layering rationale.
+ */
+async function resolveClaudeSkillsRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const compiled = resolve(here, "../claude-skills");
+    if (await pathExists(compiled)) {
+        return compiled;
+    }
+    return resolve(here, "../claude-skills");
+}
+/**
+ * Resolve the directory holding the bundled Gemini CLI slash command TOMLs
+ * (`dist/gemini-commands/`).
+ *
+ * These are distinct from the engine SKILLs at `dist/skills/` and the Claude
+ * Code discovery wrappers at `dist/claude-skills/`. Gemini CLI surfaces slash
+ * commands from `.gemini/commands/<name>.toml` (TOML format with `prompt` and
+ * `description` keys). The bundled TOMLs are thin wrappers — they tell Gemini
+ * to shell out to the `radar` CLI with `{{args}}` interpolation; the
+ * canonical procedure stays in the engine SKILLs (SSoT) under
+ * `.agents/skills/`.
+ *
+ * See ADR-0007 (revised 2026-05-17 c) for the five-layer init bundle and the
+ * cross-agent slash-command parity rationale.
+ */
+async function resolveGeminiCommandsRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const compiled = resolve(here, "../gemini-commands");
+    if (await pathExists(compiled)) {
+        return compiled;
+    }
+    return resolve(here, "../gemini-commands");
+}
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const WORKSPACE_DIRS = ["sources", "state", "items", "research", "templates"];
+/**
+ * Data directories that receive a `.gitkeep` placeholder so the empty
+ * directory survives an initial `git add .` commit.
+ *
+ * AGENTS.md's "データ管理ポリシー" recommends committing `sources/` / `items/`
+ * / `state/` / `research/` to git (state preservation for scheduled runs,
+ * audit trail for research history). Git does not track empty directories,
+ * so without a placeholder, a user who runs `init` and then `git add .`
+ * loses the directory layout entirely.
+ *
+ * `templates/` is intentionally excluded — the bundled `default.md` ships
+ * via a separate `init` codepath (see ADR-0007 follow-up) and serves as
+ * its own placeholder.
+ */
+const GITKEEP_DIRS = ["sources", "items", "state", "research"];
+/**
+ * Engine SKILLs (SSoT): canonical procedure documents that the agent adapter
+ * reads when the CLI spawns claude/codex/gemini/copilot. They land at
+ * `<cwd>/.agents/skills/<name>/SKILL.md`.
+ */
+const BUNDLED_SKILLS = ["research", "review", "update"];
+/**
+ * Claude Code discovery SKILLs: thin slash-command wrappers that surface
+ * `/research` / `/review` / `/update` / `/dismiss` inside Claude Code
+ * interactive sessions opened in the workspace. They land at
+ * `<cwd>/.claude/skills/<name>/SKILL.md` and delegate to the `radar`
+ * CLI; they do not duplicate the engine procedure.
+ *
+ * Note `dismiss` is here but NOT in `BUNDLED_SKILLS` — the dismiss command
+ * does not invoke an agent (no LLM call), so there is no engine SKILL for
+ * it. The slash-command wrapper is purely a UX affordance for Claude Code
+ * users (vs typing `radar dismiss` in a terminal).
+ *
+ * See ADR-0007 (revised 2026-05-17) for the SSoT vs discovery split.
+ */
+const CLAUDE_DISCOVERY_SKILLS = ["research", "review", "update", "dismiss"];
+/**
+ * Gemini CLI slash commands: thin TOML wrappers that surface `/research` /
+ * `/review` / `/update` / `/dismiss` inside Gemini CLI interactive sessions
+ * opened in the workspace. They land at `<cwd>/.gemini/commands/<name>.toml`
+ * and delegate to the `radar` CLI via `{{args}}` interpolation; they
+ * do not duplicate the engine procedure.
+ *
+ * Note `dismiss` is here but NOT in `BUNDLED_SKILLS` — the dismiss command
+ * does not invoke an agent (no LLM call), so there is no engine SKILL for
+ * it. The TOML is purely a UX affordance for Gemini CLI users.
+ *
+ * See ADR-0007 (revised 2026-05-17 c) for the five-layer init bundle and the
+ * cross-agent slash-command parity rationale (#78).
+ */
+const GEMINI_COMMANDS = ["research", "review", "update", "dismiss"];
+/**
+ * Schedule scaffolds that `init` may emit on opt-in flags.
+ *
+ * - `src`: bundled template path under `<templatesRoot>/`
+ * - `dest`: where the file lands in the user's workspace
+ *
+ * See ADR-0004 for the policy: `radar` does not run schedules
+ * itself; these scaffolds wire it into Claude Routines / GitHub Actions.
+ */
+const SCHEDULE_SCAFFOLDS = {
+    routines: {
+        src: "routines/watch-daily.md",
+        dest: ["claude", "routines", "watch-daily.md"],
+    },
+    actions: {
+        src: "workflows/watch.yaml",
+        dest: [".github", "workflows", "watch.yaml"],
+    },
+};
+/**
+ * Bundled agent-agnostic instructions file emitted by default at the
+ * workspace root. Codex CLI / Gemini CLI / GitHub Copilot CLI auto-read
+ * `AGENTS.md` from project root; Claude Code does not, but the standard
+ * pattern is `CLAUDE.md` → `@AGENTS.md` include.
+ *
+ * See ADR-0007 (revised 2026-05-17 b) for the four-layer init bundle.
+ */
+const AGENTS_MD_SCAFFOLD = {
+    src: "agents/AGENTS.md",
+    dest: ["AGENTS.md"],
+};
+/**
+ * Bundled minimal Claude Code workspace instructions emitted by default at
+ * the workspace root. The template re-exports `AGENTS.md` via the
+ * `@AGENTS.md` import directive so that the SSoT for cross-agent
+ * instructions stays in `AGENTS.md` while Claude Code (which does NOT
+ * auto-read `AGENTS.md`) still gets the workspace context the moment a
+ * user opens an interactive session.
+ *
+ * When `--no-agents-md` is also passed, the `@AGENTS.md` import would
+ * dangle, so `init` auto-skips this scaffold (emit a warning).
+ *
+ * See ADR-0007 (revised 2026-05-17 b) for the multi-layer init bundle.
+ */
+const CLAUDE_MD_SCAFFOLD = {
+    src: "claude/CLAUDE.md",
+    dest: ["CLAUDE.md"],
+};
+/**
+ * Bundled starter Markdown template emitted by default into
+ * `<cwd>/templates/default.md`. The body mirrors the engine `research`
+ * SKILL's fallback structure (要約 / 詳細 / 出典) so editing it has an
+ * immediately predictable effect on generated reports.
+ *
+ * Note the template stores the **body only** — no frontmatter. The
+ * research engine SKILL constructs `ResearchFrontmatter` itself per
+ * ADR-0003 and appends the templateBody as the report body. Including
+ * frontmatter here would conflict with that contract.
+ *
+ * See ADR-0007 (revised 2026-05-17) for the init bundle layering and
+ * `src/skills/research/SKILL.md` §3 for the template body contract.
+ */
+const DEFAULT_TEMPLATE_SCAFFOLD = {
+    src: "default.md",
+    dest: ["templates", "default.md"],
+};
+/**
+ * Bundled human-facing workspace guide emitted by default at the workspace
+ * root. Distinct from `AGENTS.md` / `CLAUDE.md`, which are AI-agent-facing
+ * instruction files auto-read by the respective CLIs. `FEEDRADAR.md`
+ * is for the human who ran `init` and needs to learn what they can do in
+ * this workspace — with skills-based / natural-language agent invocation
+ * as the primary path and CLI direct invocation as the secondary
+ * (scheduler / CI) path.
+ *
+ * Named `FEEDRADAR.md` (not `README.md`) so it does not collide with
+ * a workspace that already has its own README, and so its purpose is
+ * obvious from the filename. Same warning+skip + `--force` overwrite
+ * policy as all other bundled files.
+ */
+const FEEDRADAR_MD_SCAFFOLD = {
+    src: "feedradar.md",
+    dest: ["FEEDRADAR.md"],
+};
+/**
+ * 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 async function initWorkspace(options) {
+    const { cwd, force } = options;
+    const warn = options.warn ?? ((m) => console.warn(m));
+    const info = options.info ?? ((m) => console.log(m));
+    const createdDirs = [];
+    const copiedFiles = [];
+    const skippedFiles = [];
+    for (const dir of WORKSPACE_DIRS) {
+        const abs = join(cwd, dir);
+        await mkdir(abs, { recursive: true });
+        createdDirs.push(dir);
+    }
+    // Place a `.gitkeep` in each data directory so an empty workspace survives
+    // the user's first `git add .`. AGENTS.md's "データ管理ポリシー" recommends
+    // committing these directories (state preservation across scheduled runs,
+    // audit trail), which is impossible without a tracked placeholder file.
+    //
+    // Always create when missing, regardless of `--force` — a 0-byte placeholder
+    // has no user content worth protecting. Existing `.gitkeep` files (or any
+    // other content the user may have placed at that path) are left untouched
+    // to avoid surprising overwrites.
+    for (const dir of GITKEEP_DIRS) {
+        const gitkeepPath = join(cwd, dir, ".gitkeep");
+        if (await pathExists(gitkeepPath)) {
+            continue;
+        }
+        await writeFile(gitkeepPath, "", "utf8");
+        copiedFiles.push(`${dir}/.gitkeep`);
+    }
+    const skillsRoot = options.skillsRoot ?? (await resolveSkillsRoot());
+    for (const skill of BUNDLED_SKILLS) {
+        const src = join(skillsRoot, skill, "SKILL.md");
+        const destDir = join(cwd, ".agents", "skills", skill);
+        const dest = join(destDir, "SKILL.md");
+        await mkdir(destDir, { recursive: true });
+        if (!(await pathExists(src))) {
+            warn(`init: bundled skill not found, skipped: ${src}`);
+            skippedFiles.push(`.agents/skills/${skill}/SKILL.md`);
+            continue;
+        }
+        if ((await pathExists(dest)) && !force) {
+            warn(`init: skipped existing file (use --force to overwrite): .agents/skills/${skill}/SKILL.md`);
+            skippedFiles.push(`.agents/skills/${skill}/SKILL.md`);
+            continue;
+        }
+        await copyFile(src, dest);
+        copiedFiles.push(`.agents/skills/${skill}/SKILL.md`);
+    }
+    if (!options.noClaudeSkills) {
+        const claudeSkillsRoot = options.claudeSkillsRoot ?? (await resolveClaudeSkillsRoot());
+        for (const skill of CLAUDE_DISCOVERY_SKILLS) {
+            const src = join(claudeSkillsRoot, skill, "SKILL.md");
+            const destDir = join(cwd, ".claude", "skills", skill);
+            const dest = join(destDir, "SKILL.md");
+            await mkdir(destDir, { recursive: true });
+            if (!(await pathExists(src))) {
+                warn(`init: bundled claude discovery skill not found, skipped: ${src}`);
+                skippedFiles.push(`.claude/skills/${skill}/SKILL.md`);
+                continue;
+            }
+            if ((await pathExists(dest)) && !force) {
+                warn(`init: skipped existing file (use --force to overwrite): .claude/skills/${skill}/SKILL.md`);
+                skippedFiles.push(`.claude/skills/${skill}/SKILL.md`);
+                continue;
+            }
+            await copyFile(src, dest);
+            copiedFiles.push(`.claude/skills/${skill}/SKILL.md`);
+        }
+    }
+    if (!options.noGeminiCommands) {
+        const geminiCommandsRoot = options.geminiCommandsRoot ?? (await resolveGeminiCommandsRoot());
+        for (const command of GEMINI_COMMANDS) {
+            const src = join(geminiCommandsRoot, `${command}.toml`);
+            const destDir = join(cwd, ".gemini", "commands");
+            const dest = join(destDir, `${command}.toml`);
+            await mkdir(destDir, { recursive: true });
+            if (!(await pathExists(src))) {
+                warn(`init: bundled gemini command not found, skipped: ${src}`);
+                skippedFiles.push(`.gemini/commands/${command}.toml`);
+                continue;
+            }
+            if ((await pathExists(dest)) && !force) {
+                warn(`init: skipped existing file (use --force to overwrite): .gemini/commands/${command}.toml`);
+                skippedFiles.push(`.gemini/commands/${command}.toml`);
+                continue;
+            }
+            await copyFile(src, dest);
+            copiedFiles.push(`.gemini/commands/${command}.toml`);
+        }
+    }
+    if (!options.noAgentsMd) {
+        await emitScaffold({
+            cwd,
+            force,
+            templatesRoot: options.templatesRoot,
+            scaffold: AGENTS_MD_SCAFFOLD,
+            copiedFiles,
+            skippedFiles,
+            warn,
+        });
+    }
+    // CLAUDE.md is auto-skipped when AGENTS.md is also skipped, because the
+    // bundled CLAUDE.md template re-exports AGENTS.md via `@AGENTS.md` and
+    // that import would otherwise dangle. Users who want CLAUDE.md without
+    // AGENTS.md should manage CLAUDE.md themselves.
+    if (!options.noClaudeMd) {
+        if (options.noAgentsMd) {
+            warn("init: skipped CLAUDE.md because --no-agents-md was passed (the bundled CLAUDE.md imports @AGENTS.md and would dangle)");
+            skippedFiles.push("CLAUDE.md");
+        }
+        else {
+            await emitScaffold({
+                cwd,
+                force,
+                templatesRoot: options.templatesRoot,
+                scaffold: CLAUDE_MD_SCAFFOLD,
+                copiedFiles,
+                skippedFiles,
+                warn,
+            });
+        }
+    }
+    if (!options.noTemplates) {
+        await emitScaffold({
+            cwd,
+            force,
+            templatesRoot: options.templatesRoot,
+            scaffold: DEFAULT_TEMPLATE_SCAFFOLD,
+            copiedFiles,
+            skippedFiles,
+            warn,
+        });
+    }
+    if (!options.noFeedradarMd) {
+        await emitScaffold({
+            cwd,
+            force,
+            templatesRoot: options.templatesRoot,
+            scaffold: FEEDRADAR_MD_SCAFFOLD,
+            copiedFiles,
+            skippedFiles,
+            warn,
+        });
+    }
+    if (options.withRoutines) {
+        await emitScaffold({
+            cwd,
+            force,
+            templatesRoot: options.templatesRoot,
+            scaffold: SCHEDULE_SCAFFOLDS.routines,
+            copiedFiles,
+            skippedFiles,
+            warn,
+        });
+    }
+    if (options.withActions) {
+        await emitScaffold({
+            cwd,
+            force,
+            templatesRoot: options.templatesRoot,
+            scaffold: SCHEDULE_SCAFFOLDS.actions,
+            copiedFiles,
+            skippedFiles,
+            warn,
+        });
+    }
+    info(`init: workspace ready at ${cwd}`);
+    info(`init: directories created: ${createdDirs.join(", ")}`);
+    if (copiedFiles.length > 0) {
+        info(`init: skills copied: ${copiedFiles.join(", ")}`);
+    }
+    if (skippedFiles.length > 0) {
+        info(`init: files skipped: ${skippedFiles.join(", ")}`);
+    }
+    // Next-step hint: FEEDRADAR.md is the canonical entry point for the
+    // human who just ran init. Point them at it (when present) so they don't
+    // have to hunt for usage docs. Skip the hint when the file wasn't written
+    // (workspace owner chose --no-feedradar-md or pre-existing protected).
+    if (copiedFiles.includes("FEEDRADAR.md")) {
+        info("init: next steps — read FEEDRADAR.md for natural-language and slash usage.");
+    }
+    return { createdDirs, copiedFiles, skippedFiles };
+}
+/**
+ * Copy one bundled schedule scaffold into `cwd`. Existing files are protected
+ * unless `force` is true (mirrors the bundled-skills path).
+ */
+async function emitScaffold(args) {
+    const { cwd, force, scaffold, copiedFiles, skippedFiles, warn } = args;
+    const templatesRoot = args.templatesRoot ?? (await resolveTemplatesRoot());
+    const src = join(templatesRoot, scaffold.src);
+    const dest = join(cwd, ...scaffold.dest);
+    const relDest = scaffold.dest.join("/");
+    if (!(await pathExists(src))) {
+        warn(`init: bundled template not found, skipped: ${src}`);
+        skippedFiles.push(relDest);
+        return;
+    }
+    await mkdir(dirname(dest), { recursive: true });
+    if ((await pathExists(dest)) && !force) {
+        warn(`init: skipped existing file (use --force to overwrite): ${relDest}`);
+        skippedFiles.push(relDest);
+        return;
+    }
+    await copyFile(src, dest);
+    copiedFiles.push(relDest);
+}
+function parseArgs(args) {
+    let force = false;
+    let withRoutines = false;
+    let withActions = false;
+    let noClaudeSkills = false;
+    let noGeminiCommands = false;
+    let noAgentsMd = false;
+    let noClaudeMd = false;
+    let noTemplates = false;
+    let noFeedradarMd = false;
+    let help = false;
+    for (const arg of args) {
+        if (arg === "--force" || arg === "-f") {
+            force = true;
+        }
+        else if (arg === "--with-routines") {
+            withRoutines = true;
+        }
+        else if (arg === "--with-actions") {
+            withActions = true;
+        }
+        else if (arg === "--no-claude-skills") {
+            noClaudeSkills = true;
+        }
+        else if (arg === "--no-gemini-commands") {
+            noGeminiCommands = true;
+        }
+        else if (arg === "--no-agents-md") {
+            noAgentsMd = true;
+        }
+        else if (arg === "--no-claude-md") {
+            noClaudeMd = true;
+        }
+        else if (arg === "--no-templates") {
+            noTemplates = true;
+        }
+        else if (arg === "--no-feedradar-md") {
+            noFeedradarMd = true;
+        }
+        else if (arg === "-h" || arg === "--help") {
+            help = true;
+        }
+    }
+    return {
+        force,
+        withRoutines,
+        withActions,
+        noClaudeSkills,
+        noGeminiCommands,
+        noAgentsMd,
+        noClaudeMd,
+        noTemplates,
+        noFeedradarMd,
+        help,
+    };
+}
+export const initCommand = {
+    name: "init",
+    summary: "Initialize a workspace (sources/items/state/research/templates)",
+    run: async (args) => {
+        const { force, withRoutines, withActions, noClaudeSkills, noGeminiCommands, noAgentsMd, noClaudeMd, noTemplates, noFeedradarMd, help, } = parseArgs(args);
+        if (help) {
+            console.log("Usage: radar init [--force] [--with-routines] [--with-actions]");
+            console.log("                          [--no-claude-skills] [--no-gemini-commands]");
+            console.log("                          [--no-agents-md] [--no-claude-md] [--no-templates]");
+            console.log("                          [--no-feedradar-md]");
+            console.log("");
+            console.log("Creates the workspace directories and copies bundled skills:");
+            console.log("  - Engine SKILLs (SSoT): .agents/skills/{research,review,update}/SKILL.md");
+            console.log("  - Claude Code slash-command wrappers: .claude/skills/{research,review,update,dismiss}/SKILL.md");
+            console.log("  - Gemini CLI slash commands: .gemini/commands/{research,review,update,dismiss}.toml");
+            console.log("  - Agent-agnostic instructions: AGENTS.md (auto-read by Codex / Gemini / Copilot)");
+            console.log("  - Claude Code workspace instructions: CLAUDE.md (imports @AGENTS.md so Claude reads it)");
+            console.log("  - Starter report template: templates/default.md (editable; mirrors research SKILL fallback)");
+            console.log("  - Human-facing workspace guide: FEEDRADAR.md (natural-language / slash usage)");
+            console.log("");
+            console.log("Options:");
+            console.log("  --force                Overwrite existing files");
+            console.log("  --with-routines        Generate claude/routines/watch-daily.md (Claude Routines scaffold)");
+            console.log("  --with-actions         Generate .github/workflows/watch.yaml (GitHub Actions cron scaffold)");
+            console.log("  --no-claude-skills     Skip writing slash-command wrappers to .claude/skills/");
+            console.log("                         (useful if @ozzylabs/skills Renovate preset manages that directory)");
+            console.log("  --no-gemini-commands   Skip writing Gemini CLI slash commands to .gemini/commands/");
+            console.log("                         (engine SKILLs still serve interactive Gemini via dual-mode)");
+            console.log("  --no-agents-md         Skip writing AGENTS.md at the workspace root");
+            console.log("                         (useful if the workspace already has its own AGENTS.md;");
+            console.log("                          implies --no-claude-md since the bundled CLAUDE.md imports @AGENTS.md)");
+            console.log("  --no-claude-md         Skip writing CLAUDE.md at the workspace root");
+            console.log("                         (useful if the workspace already has its own CLAUDE.md)");
+            console.log("  --no-templates         Skip writing templates/default.md starter template");
+            console.log("                         (research engine SKILL falls back to its built-in structure)");
+            console.log("  --no-feedradar-md      Skip writing FEEDRADAR.md at the workspace root");
+            console.log("                         (useful if the workspace already has its own user-facing docs)");
+            return 0;
+        }
+        await initWorkspace({
+            cwd: process.cwd(),
+            force,
+            withRoutines,
+            withActions,
+            noClaudeSkills,
+            noGeminiCommands,
+            noAgentsMd,
+            noClaudeMd,
+            noTemplates,
+            noFeedradarMd,
+        });
+        return 0;
+    },
+};
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/research.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/cli/research.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,yFAAyF;AACzF,MAAM,WAAW,UAAU;IACzB,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,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,UAAU,CAAC;CACjB;AA+GD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CA+LjB;AAED,eAAO,MAAM,eAAe,EAAE,OAI7B,CAAC"}