@itradingai/aiwiki 0.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iTradingAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# AIWiki
+
+AIWiki 是一个面向宿主 Agent 的本地知识库生产 CLI。用户把文章链接或正文发给 Codex、QClaw、OpenClaw、Claude Code 等 Agent，并使用“入库”触发词；宿主 Agent 负责读取网页或上下文，AIWiki 负责把内容写入本地知识库，并生成适合 Obsidian + Dataview 审阅的资料结构。
+
+AIWiki 的重点不是替代 Agent 抓网页，而是把 Agent 已经读到的内容稳定沉淀为可追踪、可复盘、可继续写作的本地知识库。
+
+## 安装与初始化
+
+一次性运行交互式 setup：
+
+```bash
+npx @itradingai/aiwiki@latest setup
+```
+
+CLI 会询问知识库路径。直接回车会使用默认目录，确认后会创建或补齐 AIWiki 目录，并写入默认知识库配置。
+
+自动化初始化可以使用：
+
+```bash
+npx @itradingai/aiwiki@latest setup --path "F:\knowledge_data\aiwiki" --yes
+```
+
+如果希望长期使用全局命令：
+
+```bash
+npm install -g @itradingai/aiwiki@latest
+aiwiki setup
+```
+
+升级到最新版本：
+
+```bash
+npm install -g @itradingai/aiwiki@latest
+```
+
+要求 Node.js `>=20`。
+
+## 让宿主 Agent 学会 AIWiki
+
+初始化知识库后，先扫描本机支持的宿主 Agent：
+
+```bash
+aiwiki agent list
+```
+
+再启动安装向导：
+
+```bash
+aiwiki agent install
+```
+
+也可以直接指定目标：
+
+```bash
+aiwiki agent install --agent codex --yes
+aiwiki agent install --agent qclaw --yes
+aiwiki agent install --agent openclaw --yes
+aiwiki agent install --agent claude --yes
+```
+
+如果当前宿主 Agent 暂不支持自动安装，可以输出通用对接协议：
+
+```bash
+aiwiki prompt agent
+```
+
+把输出内容安装成宿主 Agent 的 skill，或粘贴到宿主 Agent 的项目/会话说明里。
+
+## 入库流程
+
+完成 setup 和 Agent 安装后，对宿主 Agent 发送：
+
+```text
+入库 https://example.com/article
+```
+
+宿主 Agent 读取网页后，通过 `aiwiki ingest-agent --stdin` 把结构化内容交给 AIWiki CLI。用户不需要手动保存 payload，也不需要每次输入 `--path`。
+
+典型流程：
+
+```text
+用户发送链接 -> 宿主 Agent 读取内容 -> Agent 调用 AIWiki -> AIWiki 写入本地知识库 -> Obsidian 审阅和沉淀
+```
+
+## Obsidian 与 Dataview
+
+AIWiki 初始化时会创建面向 Obsidian 的目录、Dashboard、Dataview 查询和 frontmatter 约定。核心入口包括：
+
+- `dashboards/AIWiki Home.md`
+- `dashboards/Review Queue.md`
+- `dashboards/Claims Review.md`
+- `_system/schemas/aiwiki-frontmatter.md`
+
+完整方案见：[docs/OBSIDIAN_DATAVIEW_PLAN.md](docs/OBSIDIAN_DATAVIEW_PLAN.md)。
+
+## 常用命令
+
+```bash
+aiwiki setup
+aiwiki setup --path <path> --yes
+aiwiki agent list
+aiwiki agent install
+aiwiki prompt agent
+aiwiki doctor
+aiwiki status
+aiwiki ingest-agent --stdin
+aiwiki ingest-file --file <file>
+```
+
+高级/调试命令：
+
+```bash
+aiwiki init --path <path> --yes --set-default
+aiwiki config show
+aiwiki ingest-agent --payload <file>
+aiwiki ingest-url <url> --content-file <file>
+```
+
+## 当前范围
+
+- 单知识库
+- 单次处理一条输入
+- 宿主 Agent 读取网页、附件或正文
+- CLI 写入本地文件和 Obsidian 友好的结构
+- 生成资料卡、素材建议、主题候选、草稿大纲、处理摘要
+
+## 当前不包含
+
+- CLI 内置通用网页抓取
+- 跨主题自动路由
+- 批处理
+- 定时或指定采集
+- 长流程状态机
+- 技术支持流程
+
+## 文档
+
+- 使用说明：[docs/USAGE.md](docs/USAGE.md)
+- Agent 对接协议：[docs/AGENT_HANDOFF.md](docs/AGENT_HANDOFF.md)
+- Obsidian + Dataview 方案：[docs/OBSIDIAN_DATAVIEW_PLAN.md](docs/OBSIDIAN_DATAVIEW_PLAN.md)
+- 架构图：[docs/architecture.svg](docs/architecture.svg)
+
+## 联系与交流
+
+项目专题介绍：[maxking.cc](https://maxking.cc/aiwiki)
+
+<table>
+  <tr>
+    <td align="center" width="50%">
+      <img src="docs/assets/join-group.png" alt="扫码进群交流" width="360">
+      <br>
+      <strong>扫码进群</strong>
+    </td>
+    <td align="center" width="50%">
+      <img src="docs/assets/wechat-official-account.png" alt="扫码关注公众号" width="360">
+      <br>
+      <strong>关注公众号</strong>
+    </td>
+  </tr>
+</table>
+
+## 本地开发
+
+```bash
+npm install
+npm run build
+npm link
+aiwiki setup --path "F:\knowledge_data\aiwiki-test" --yes
+aiwiki prompt agent
+aiwiki doctor
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/dist/src/app.js

@@ -0,0 +1,417 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import { flagBool, flagString, parseArgs } from "./args.js";
+import { ingestFile, ingestPayload } from "./ingest.js";
+import { CliError, writeLine } from "./output.js";
+import { confirmInit, directorySummary, doctor, exists, initWorkspace, promptForSetup, promptForInitPath, readConfig, resolveWorkspace, setDefaultWorkspace, statusSummary } from "./workspace.js";
+export const VERSION = "0.2.2";
+export async function runCli(argv, streams = { stdout: process.stdout, stderr: process.stderr }) {
+    try {
+        const args = parseArgs(argv);
+        const [command, subcommand] = args.positional;
+        if (args.flags.has("version") || command === "version" || command === "-v") {
+            writeLine(streams.stdout, `aiwiki ${VERSION}`);
+            return 0;
+        }
+        if (args.flags.has("help") || !command || command === "help" || command === "-h") {
+            printHelp(streams.stdout);
+            return 0;
+        }
+        if (command === "setup") {
+            const setup = await promptForSetup({ rootPath: flagString(args, "path"), yes: flagBool(args, "yes") });
+            if (!setup.confirmed) {
+                writeLine(streams.stdout, "已取消。");
+                return 0;
+            }
+            const result = await initWorkspace(setup.rootPath);
+            const defaultConfig = await setDefaultWorkspace(result.root);
+            writeLine(streams.stdout, `AIWiki 已初始化: ${result.root}`);
+            writeLine(streams.stdout, `配置: ${result.createdConfig ? "已创建" : "已保留"}`);
+            writeLine(streams.stdout, `新建目录数: ${result.createdDirs.length}`);
+            writeLine(streams.stdout, `新建数据库文件数: ${result.seededFiles.filter((file) => file.created).length}`);
+            writeLine(streams.stdout, `默认知识库: ${defaultConfig.defaultPath}`);
+            writeLine(streams.stdout, `用户配置: ${defaultConfig.configPath}`);
+            writeLine(streams.stdout, "Obsidian 入口: dashboards/AIWiki Home.md");
+            writeLine(streams.stdout, "下一步: 运行 `aiwiki agent install`，把 AIWiki 安装到宿主 Agent。");
+            writeLine(streams.stdout, "Agent 设置完成后: 向 Agent 发送 `入库 <url>`");
+            return 0;
+        }
+        if (command === "agent" && subcommand === "install") {
+            const result = await installAgentSkill({
+                agentId: flagString(args, "agent"),
+                yes: flagBool(args, "yes"),
+                force: flagBool(args, "force"),
+                streams
+            });
+            if (result) {
+                writeLine(streams.stdout, `已安装: ${result.name}`);
+                writeLine(streams.stdout, `目标路径: ${result.target}`);
+                writeLine(streams.stdout, `下一步: 重启或重新加载 ${result.name}，然后发送 \`入库 <url>\`。`);
+            }
+            return 0;
+        }
+        if (command === "agent" && (subcommand === "list" || !subcommand)) {
+            printAgentList(streams.stdout, await discoverAgentTargets());
+            return 0;
+        }
+        if (command === "prompt" && (subcommand === "agent" || !subcommand)) {
+            printAgentPrompt(streams.stdout);
+            return 0;
+        }
+        if (command === "init") {
+            let rootPath = flagString(args, "path");
+            if (!rootPath) {
+                rootPath = await promptForInitPath();
+            }
+            if (!flagBool(args, "yes")) {
+                const confirmed = await confirmInit(rootPath);
+                if (!confirmed) {
+                    writeLine(streams.stdout, "已取消。");
+                    return 0;
+                }
+            }
+            const result = await initWorkspace(rootPath);
+            writeLine(streams.stdout, `AIWiki 已初始化: ${result.root}`);
+            writeLine(streams.stdout, `配置: ${result.createdConfig ? "已创建" : "已保留"}`);
+            writeLine(streams.stdout, `新建目录数: ${result.createdDirs.length}`);
+            writeLine(streams.stdout, `新建数据库文件数: ${result.seededFiles.filter((file) => file.created).length}`);
+            writeLine(streams.stdout, "Obsidian 入口: dashboards/AIWiki Home.md");
+            if (flagBool(args, "set-default")) {
+                const defaultConfig = await setDefaultWorkspace(result.root);
+                writeLine(streams.stdout, `默认知识库: ${defaultConfig.defaultPath}`);
+                writeLine(streams.stdout, `用户配置: ${defaultConfig.configPath}`);
+            }
+            return 0;
+        }
+        if (command === "config" && subcommand === "show") {
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const config = await readConfig(root);
+            const summary = await directorySummary(root);
+            writeLine(streams.stdout, `知识库路径: ${root}`);
+            writeLine(streams.stdout, `产品: ${config.product}`);
+            writeLine(streams.stdout, `配置版本: ${config.schemaVersion}`);
+            writeLine(streams.stdout, `创建时间: ${config.createdAt}`);
+            writeLine(streams.stdout, `目录状态: ${summary.present} 个正常，${summary.missing.length} 个缺失`);
+            if (summary.missing.length) {
+                writeLine(streams.stdout, `缺失目录: ${summary.missing.join(", ")}`);
+            }
+            return 0;
+        }
+        if (command === "doctor") {
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const checks = await doctor(root);
+            let failed = false;
+            for (const check of checks) {
+                writeLine(streams.stdout, `${doctorStatusText(check.status)}: ${check.name}`);
+                if (check.status !== "ok") {
+                    failed = true;
+                }
+            }
+            if (failed) {
+                writeLine(streams.stdout, `修复命令: aiwiki setup --path "${root}" --yes`);
+                return 1;
+            }
+            return 0;
+        }
+        if (command === "status") {
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const summary = await statusSummary(root);
+            writeLine(streams.stdout, `知识库路径: ${summary.root}`);
+            writeLine(streams.stdout, `处理次数: ${summary.runCount}`);
+            writeLine(streams.stdout, `失败次数: ${summary.failedCount}`);
+            writeLine(streams.stdout, `最近处理: ${summary.lastRunId ?? "无"}`);
+            return 0;
+        }
+        if (command === "ingest-agent") {
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const payloadPath = flagString(args, "payload");
+            const useStdin = flagBool(args, "stdin");
+            if (!payloadPath && !useStdin) {
+                throw new CliError("请提供 --payload <file> 或 --stdin。");
+            }
+            const rawText = payloadPath ? await fs.readFile(payloadPath, "utf8") : await readStdin();
+            const payload = parseJson(rawText);
+            const result = await ingestPayload(root, payload);
+            printIngestResult(streams.stdout, result);
+            return 0;
+        }
+        if (command === "ingest-file") {
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const file = flagString(args, "file") ?? args.positional[1];
+            if (!file) {
+                throw new CliError("请提供 --file <file>。");
+            }
+            const result = await ingestFile(root, path.resolve(file));
+            printIngestResult(streams.stdout, result);
+            return 0;
+        }
+        if (command === "ingest-url") {
+            const contentFile = flagString(args, "content-file");
+            if (!contentFile) {
+                throw new CliError("AIWiki CLI 不抓取网页。请提供 --content-file <file>，让宿主 Agent 或用户先提供正文。");
+            }
+            const url = args.positional[1];
+            if (!url) {
+                throw new CliError("请提供 URL。");
+            }
+            const root = await resolveWorkspace(flagString(args, "path"));
+            const content = await fs.readFile(contentFile, "utf8");
+            const result = await ingestPayload(root, {
+                schema_version: "aiwiki.agent_payload.v1",
+                source: {
+                    kind: "url",
+                    url,
+                    title: path.basename(contentFile),
+                    content_format: "markdown",
+                    content,
+                    fetcher: "content-file",
+                    fetch_status: "ok",
+                    captured_at: new Date().toISOString()
+                },
+                request: {
+                    mode: "ingest",
+                    outputs: ["source_card", "creative_assets", "topics", "draft_outline", "processing_summary"],
+                    language: "zh-CN"
+                }
+            });
+            printIngestResult(streams.stdout, result);
+            return 0;
+        }
+        throw new CliError(`未知命令: ${command}`);
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            writeLine(streams.stderr, `错误: ${error.message}`);
+            return error.exitCode;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        writeLine(streams.stderr, `错误: ${message}`);
+        return 1;
+    }
+}
+function printHelp(stream) {
+    writeLine(stream, "AIWiki");
+    writeLine(stream, "");
+    writeLine(stream, "用法:");
+    writeLine(stream, "  aiwiki setup");
+    writeLine(stream, "  aiwiki setup --path <path> --yes");
+    writeLine(stream, "  aiwiki agent list");
+    writeLine(stream, "  aiwiki agent install");
+    writeLine(stream, "  aiwiki agent install --agent codex --yes");
+    writeLine(stream, "  aiwiki prompt agent");
+    writeLine(stream, "  aiwiki doctor");
+    writeLine(stream, "  aiwiki status");
+    writeLine(stream, "  aiwiki ingest-agent --stdin");
+    writeLine(stream, "  aiwiki ingest-file --file <file>");
+    writeLine(stream, "  aiwiki init --path <path> --yes --set-default");
+    writeLine(stream, "  aiwiki config show");
+    writeLine(stream, "  aiwiki ingest-agent --payload <file>");
+    writeLine(stream, "  aiwiki ingest-url <url> --content-file <file>");
+}
+async function discoverAgentTargets() {
+    const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+    const skillSource = path.join(packageRoot, "skill", "SKILL.md");
+    const promptSource = path.join(packageRoot, "docs", "AGENT_HANDOFF.md");
+    const codexHome = process.env.CODEX_HOME ? path.resolve(process.env.CODEX_HOME) : path.join(os.homedir(), ".codex");
+    const qclawHome = process.env.QCLAW_HOME ? path.resolve(process.env.QCLAW_HOME) : path.join(os.homedir(), ".qclaw");
+    const openclawHome = process.env.OPENCLAW_HOME ? path.resolve(process.env.OPENCLAW_HOME) : path.join(os.homedir(), ".openclaw");
+    const claudeHome = process.env.CLAUDE_HOME ? path.resolve(process.env.CLAUDE_HOME) : path.join(os.homedir(), ".claude");
+    const opencodeHome = process.env.OPENCODE_HOME ? path.resolve(process.env.OPENCODE_HOME) : path.join(os.homedir(), ".opencode");
+    const hermesHome = process.env.HERMES_HOME ? path.resolve(process.env.HERMES_HOME) : path.join(process.env.LOCALAPPDATA ?? path.join(os.homedir(), "AppData", "Local"), "hermes");
+    return [
+        {
+            id: "codex",
+            name: "Codex",
+            detected: await exists(codexHome),
+            installable: true,
+            kind: "skill",
+            source: skillSource,
+            target: path.join(codexHome, "skills", "aiwiki", "SKILL.md"),
+            note: "安装到 Codex 用户 skills 目录。"
+        },
+        {
+            id: "qclaw",
+            name: "QClaw",
+            detected: await exists(qclawHome),
+            installable: true,
+            kind: "skill",
+            source: skillSource,
+            target: path.join(qclawHome, "skills", "aiwiki", "SKILL.md"),
+            note: "安装到本机 QClaw skills 目录。"
+        },
+        {
+            id: "openclaw",
+            name: "OpenClaw",
+            detected: await exists(openclawHome),
+            installable: true,
+            kind: "skill",
+            source: skillSource,
+            target: path.join(openclawHome, "workspace", "skills", "aiwiki", "SKILL.md"),
+            note: "安装到 OpenClaw workspace skills 目录。"
+        },
+        {
+            id: "claude",
+            name: "Claude Code",
+            detected: await exists(claudeHome),
+            installable: true,
+            kind: "command",
+            source: promptSource,
+            target: path.join(claudeHome, "commands", "aiwiki.md"),
+            note: "安装为 Claude Code slash-command 提示文件。"
+        },
+        {
+            id: "opencode",
+            name: "opencode",
+            detected: await exists(opencodeHome),
+            installable: false,
+            kind: "prompt",
+            note: "已检测到，但暂未确认稳定的用户提示目录。请先使用 aiwiki prompt agent。"
+        },
+        {
+            id: "hermes",
+            name: "Hermes",
+            detected: await exists(hermesHome),
+            installable: false,
+            kind: "prompt",
+            note: "已检测到，但暂未确认稳定的 skill 目录。请先使用 aiwiki prompt agent。"
+        }
+    ];
+}
+function printAgentList(stream, targets) {
+    writeLine(stream, "AIWiki 宿主 Agent 目标");
+    for (const target of targets) {
+        writeLine(stream, `${target.id}: ${target.name} | 已检测=${target.detected ? "是" : "否"} | 可安装=${target.installable ? "是" : "否"} | ${target.note}`);
+        if (target.target) {
+            writeLine(stream, `  目标路径: ${target.target}`);
+        }
+    }
+}
+async function installAgentSkill(options) {
+    const targets = await discoverAgentTargets();
+    const installable = targets.filter((target) => target.detected && target.installable);
+    let selected = options.agentId ? targets.find((target) => target.id === options.agentId) : undefined;
+    if (!selected && options.agentId) {
+        throw new CliError(`未知宿主 Agent: ${options.agentId}`);
+    }
+    if (!selected) {
+        if (installable.length === 0) {
+            printAgentList(options.streams.stdout, targets);
+            throw new CliError("未检测到可自动安装的宿主 Agent。请运行 aiwiki prompt agent，并手动粘贴对接协议。");
+        }
+        printAgentList(options.streams.stdout, targets);
+        const answer = await askQuestion(options.streams, "请输入要安装的目标 id 或序号: ");
+        const trimmed = answer.trim();
+        const byNumber = /^\d+$/.test(trimmed) ? installable[Number(trimmed) - 1] : undefined;
+        selected = byNumber ?? targets.find((target) => target.id === trimmed);
+    }
+    if (!selected) {
+        writeLine(options.streams.stdout, "已取消。");
+        return undefined;
+    }
+    if (!selected.installable) {
+        throw new CliError(`已检测到 ${selected.name}，但暂未配置自动安装。请运行 aiwiki prompt agent。`);
+    }
+    if (!selected.source || !selected.target) {
+        throw new CliError(`${selected.name} 没有可用安装目标。`);
+    }
+    if (!options.yes) {
+        writeLine(options.streams.stdout, `将 AIWiki 安装到 ${selected.name}:`);
+        writeLine(options.streams.stdout, `  来源: ${selected.source}`);
+        writeLine(options.streams.stdout, `  目标路径: ${selected.target}`);
+        const answer = await askQuestion(options.streams, "确认安装？输入 y 继续: ");
+        if (answer.trim().toLowerCase() !== "y") {
+            writeLine(options.streams.stdout, "已取消。");
+            return undefined;
+        }
+    }
+    await copyInstallFile(selected.source, selected.target, options.force);
+    return selected;
+}
+async function askQuestion(streams, question) {
+    if (!process.stdin.isTTY) {
+        throw new CliError("交互式 Agent 安装需要终端环境。脚本中请使用 --agent <id> --yes。");
+    }
+    const rl = createInterface({ input: process.stdin, output: streams.stdout });
+    try {
+        return await rl.question(question);
+    }
+    finally {
+        rl.close();
+    }
+}
+async function copyInstallFile(source, target, force) {
+    await fs.access(source);
+    if (!force && (await exists(target))) {
+        throw new CliError(`目标文件已存在: ${target}。如需覆盖，请加 --force。`);
+    }
+    await fs.mkdir(path.dirname(target), { recursive: true });
+    await fs.copyFile(source, target);
+}
+function printAgentPrompt(stream) {
+    writeLine(stream, "AIWiki Agent 中文提示");
+    writeLine(stream, "");
+    writeLine(stream, "当用户发送以下触发语时，请自动执行 AIWiki 入库流程：");
+    writeLine(stream, "- 入库 <url>");
+    writeLine(stream, "- 收录 <url>");
+    writeLine(stream, "- 存一下 <url>");
+    writeLine(stream, "- aiwiki <url>");
+    writeLine(stream, "");
+    writeLine(stream, "如果当前会话被用户明确设定为 AIWiki 入库助手，则用户只发送 URL 也默认触发入库。普通会话中不要把所有 URL 都自动入库。");
+    writeLine(stream, "");
+    writeLine(stream, "流程：读取网页正文；生成 aiwiki.agent_payload.v1；通过 stdin 调用 `aiwiki ingest-agent --stdin`；读取 CLI 输出；只向用户汇报 ingested、recorded、fit_score、fit_level、summary、run_dir、processing_summary、source_card、dashboard、review_queue。");
+    writeLine(stream, "回复措辞：成功时说“已加入 Obsidian 审阅队列”，并给出资料卡、处理记录、Obsidian 入口和待审队列。Dataview 是可选增强，不要替用户安装插件或修改 .obsidian。");
+    writeLine(stream, "");
+    writeLine(stream, "禁止：让用户保存 payload；让用户每次输入 --path；声称 AIWiki CLI 负责网页抓取。");
+}
+function doctorStatusText(status) {
+    if (status === "ok") {
+        return "正常";
+    }
+    if (status === "missing") {
+        return "缺失";
+    }
+    return "权限错误";
+}
+function printIngestResult(stream, result) {
+    writeLine(stream, `ingested: ${result.agentReport.ingested ? "yes" : "no"}`);
+    writeLine(stream, `recorded: ${result.agentReport.recorded ? "yes" : "no"}`);
+    writeLine(stream, `fetch_status: ${result.agentReport.fetchStatus}`);
+    writeLine(stream, `fit_score: ${result.agentReport.fitScore}`);
+    writeLine(stream, `fit_level: ${result.agentReport.fitLevel}`);
+    writeLine(stream, `source_title: ${result.agentReport.sourceTitle}`);
+    if (result.agentReport.sourceUrl) {
+        writeLine(stream, `source_url: ${result.agentReport.sourceUrl}`);
+    }
+    writeLine(stream, `summary: ${result.agentReport.summary}`);
+    writeLine(stream, `run_id: ${result.runId}`);
+    writeLine(stream, `run_dir: ${result.runDir}`);
+    writeLine(stream, `files: ${result.generatedFiles.length}`);
+    writeLine(stream, `processing_summary: ${result.agentReport.keyFiles.processingSummary}`);
+    if (result.agentReport.keyFiles.sourceCard) {
+        writeLine(stream, `source_card: ${result.agentReport.keyFiles.sourceCard}`);
+    }
+    if (result.agentReport.keyFiles.draftOutline) {
+        writeLine(stream, `draft_outline: ${result.agentReport.keyFiles.draftOutline}`);
+    }
+    writeLine(stream, `dashboard: ${result.agentReport.keyFiles.dashboard}`);
+    writeLine(stream, `review_queue: ${result.agentReport.keyFiles.reviewQueue}`);
+    writeLine(stream, `warnings: ${result.warnings.length}`);
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new CliError("payload must be valid JSON");
+    }
+}

package/dist/src/args.js

@@ -0,0 +1,32 @@
+export function parseArgs(argv) {
+    const positional = [];
+    const flags = new Map();
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (!arg.startsWith("--") || arg === "--") {
+            positional.push(arg);
+            continue;
+        }
+        const trimmed = arg.slice(2);
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex >= 0) {
+            flags.set(trimmed.slice(0, eqIndex), trimmed.slice(eqIndex + 1));
+            continue;
+        }
+        const next = argv[index + 1];
+        if (next && !next.startsWith("--")) {
+            flags.set(trimmed, next);
+            index += 1;
+            continue;
+        }
+        flags.set(trimmed, true);
+    }
+    return { positional, flags };
+}
+export function flagString(args, name) {
+    const value = args.flags.get(name);
+    return typeof value === "string" ? value : undefined;
+}
+export function flagBool(args, name) {
+    return args.flags.get(name) === true;
+}

package/dist/src/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from "./app.js";
+const exitCode = await runCli(process.argv.slice(2));
+process.exitCode = exitCode;