@s_s/harmonia 1.0.0 → 1.1.1

package/README.md

@@ -1,3 +1,397 @@
-# harmonia
+# Harmonia
 
-让不同角色和谐协作
+> _众声喧哗之中，和谐不是沉默，而是各得其所。_
+
+Multi-agent orchestration MCP server with pluggable workflows.
+
+Harmonia 是一个基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 的智能体编排服务器。它为 AI 编程助手（Claude Code、OpenCode、OpenClaw、Codex）提供项目管理工具，让多个 AI agent 在预定义的工作流中按角色协作完成软件开发任务。
+
+## 核心理念
+
+- **角色分离** — PM、架构师、开发者、测试各司其职，通过文档交接而非直接对话
+- **流程驱动** — 预定义的阶段和文档类型确保不跳步骤
+- **数据隔离** — 所有项目数据存储在平台数据目录（非项目源码目录），不污染代码仓库
+- **可插拔工作流** — 工作流定义为 JSON，可扩展自定义
+
+## 特性
+
+### 工作流编排
+
+- 5 个阶段：需求澄清 → 方案设计 → 开发 → 测试 → 交付验收
+- 4 个角色：PM / 架构师 / 开发者 / 测试
+- 15 种文档类型，按项目规模（small / medium / large）自动调整必选/可选
+- 项目规模延迟设定 — PRD 审批后由 PM 设定，设定后不可更改
+- 角色调度与报告机制（`role_dispatch` / `dispatch_report`）
+
+### 文档结构校验
+
+对文档内容进行结构化校验，包括 Markdown 标题结构和 JSON 字段/类型验证。每次 `doc_write` 时自动执行，确保产出物符合预期格式。
+
+### 工具访问控制
+
+基于 MCP tool 级别的硬性约束。为每个角色定义允许使用的工具白名单/黑名单，在 agent 层面强制执行，防止角色越权操作。
+
+### 覆盖配置体系（overrides.json）
+
+三层合并的配置覆盖系统，优先级：**项目级 > 全局级 > 工作流默认值**。
+
+```
+<data_dir>/harmonia/overrides.json                   # 全局覆盖
+<data_dir>/harmonia/<project_name>/overrides.json     # 项目级覆盖
+```
+
+支持覆盖的配置项：
+
+- **审批规则** — 控制哪些文档需要审批（review）
+  - `review: true` — 全局开启所有文档审批
+  - `review: { "prd": true, "tech-design": false }` — 按文档类型逐一配置
+  - 通过 `review_set_rule` 工具设置
+- **角色配置** — 为每个角色指定 agent 类型和模型
+  - `agent` — 执行角色的 agent 类型（opencode / claude-code / openclaw / codex）
+  - `model` — 模型覆盖（如使用不同能力级别的模型）
+  - 通过 `guard_set` 工具设置
+- **能力映射** — 将角色的抽象能力映射到具体工具
+  - `capabilities.{capId}` — 指定工具类型（skill / mcp）、工具名、服务器名、静态参数
+  - 通过 `guard_set` 工具设置
+
+示例 `overrides.json`：
+
+```json
+{
+  "review": { "prd": true },
+  "roles": {
+    "developer": {
+      "agent": "opencode",
+      "model": "claude-sonnet-4-20250514",
+      "capabilities": {
+        "read_file": {
+          "type": "mcp",
+          "tool": "read_file",
+          "server": "filesystem"
+        }
+      }
+    }
+  }
+}
+```
+
+### 跨 Agent 边界守卫
+
+为 AI 编程助手安装 hook 脚本，在工具调用前拦截越界操作：
+
+- **Claude Code / Codex** — Shell hook，通过 exit code 阻断
+- **OpenCode** — TypeScript plugin hook
+- **OpenClaw** — handler.ts hook
+
+同时提供主动提醒机制，在角色提示词中注入当前约束上下文。
+
+### 逐步文档写入
+
+大型文档拆分为多个步骤（steps），每步独立写入并校验。支持：
+
+- 每步独立的 JSON Schema 校验
+- 步骤回滚（重写某步时自动清除后续步骤记录）
+- `project_status` 中展示步骤进度
+
+## MCP 工具一览
+
+| 工具                | 说明                                               |
+| ------------------- | -------------------------------------------------- |
+| `project_init`      | 注册项目，创建数据目录，初始化工作流               |
+| `project_set_scale` | 设定项目规模（PRD 审批后，不可更改）               |
+| `project_status`    | 查看项目状态（无参数返回项目列表，有参数返回详情） |
+| `phase_update`      | 推进项目阶段                                       |
+| `doc_write`         | 写入文档（自动 schema 校验，支持逐步写入）         |
+| `doc_read`          | 读取文档内容                                       |
+| `doc_list`          | 列出项目所有文档                                   |
+| `doc_approve`       | 审批需要 review 的文档（如 PRD）                   |
+| `review_list`       | 列出待审批的文档                                   |
+| `review_set_rule`   | 设置审批规则覆盖                                   |
+| `role_prompt`       | 获取角色提示词（含约束上下文注入）                 |
+| `role_dispatch`     | 调度角色执行任务                                   |
+| `dispatch_report`   | 角色报告任务完成状态                               |
+| `guard_set`         | 设置角色的工具白名单/黑名单                        |
+| `guard_get`         | 查看当前工具约束配置                               |
+
+## 工作流结构
+
+Harmonia 使用声明式工作流定义。内置的 `dev` 工作流（软件开发流程）：
+
+```
+clarify (需求澄清)     → PM 产出 PRD、用户故事
+    ↓
+design (方案设计)       → 架构师产出技术方案、任务拆解
+    ↓
+develop (开发)          → 开发者按任务拆解编码实现
+    ↓
+test (测试)             → 测试编写测试、输出测试报告
+    ↓
+deliver (交付验收)      → PM 验收成果、输出复盘记录
+```
+
+每个文档类型可定义 **steps**（步骤），例如 PRD 的写入流程：
+
+1. `requirements` — 需求结构化（JSON）
+2. `completeness-check` — 完整性校验（JSON）
+3. `draft` — PRD 草稿（Markdown）
+4. `final` — PRD 最终版（Markdown）
+
+## 安装
+
+```bash
+npm install -g @s_s/harmonia
+```
+
+## 快速开始
+
+```bash
+harmonia setup --agent openclaw
+```
+
+`harmonia setup` 一键完成：
+
+1. 注入 PM 提示词到 agent 配置文件（AGENTS.md / CLAUDE.md）
+2. 安装 agent hook 脚本（边界守卫 + 主动提醒）
+
+之后启动你的 AI 编程助手，PM 会自动通过 `project_init` 注册项目，通过 `project_status` 获取项目信息。
+
+### CLI 命令
+
+```
+harmonia                启动 MCP stdio 服务器（供 agent 调用）
+harmonia setup          初始化 agent 配置（注入提示词 + 安装 hook）
+harmonia --help         显示帮助信息
+harmonia --version      显示版本号
+```
+
+`setup` 选项：
+
+| 选项             | 说明                                                          | 默认值                                                     |
+| ---------------- | ------------------------------------------------------------- | ---------------------------------------------------------- |
+| `--agent <type>` | agent 类型：`opencode` / `claude-code` / `codex` / `openclaw` | 建议显式指定。省略时通过 cwd 和 `~` 下的配置文件自动检测。 |
+
+## 配置
+
+将 Harmonia 注册为 MCP 服务器。
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+通过命令行：
+
+```bash
+claude mcp add --transport stdio harmonia -- harmonia
+```
+
+或添加到 `.mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "harmonia": {
+      "command": "harmonia"
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>OpenCode</strong></summary>
+
+添加到 `opencode.json`：
+
+```json
+{
+  "mcp": {
+    "harmonia": {
+      "type": "local",
+      "command": ["harmonia"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Codex</strong></summary>
+
+通过命令行：
+
+```bash
+codex mcp add harmonia -- harmonia
+```
+
+或添加到 `~/.codex/config.toml`：
+
+```toml
+[mcp_servers.harmonia]
+command = "harmonia"
+```
+
+</details>
+
+<details>
+<summary><strong>OpenClaw</strong>（通过 mcporter）</summary>
+
+添加到 `config/mcporter.json`（全局配置用 `~/.mcporter/mcporter.json`）：
+
+```json
+{
+  "mcpServers": {
+    "harmonia": {
+      "command": "harmonia"
+    }
+  }
+}
+```
+
+或通过 mcporter 命令行：
+
+```bash
+mcporter config add harmonia --command harmonia --scope home
+```
+
+</details>
+
+## 全局目录
+
+Harmonia 的所有项目数据存储在平台特定的数据目录中（通过 [agent-kit](https://github.com/anthropics/agent-kit) 管理），**不会在项目源码目录中创建任何文件**。
+
+全局目录结构：
+
+```
+<data_dir>/harmonia/
+├── overrides.json              # 全局覆盖配置
+├── .workflows/                 # 自定义工作流目录
+│   └── <workflow_name>/
+│       ├── workflow.json
+│       ├── roles/
+│       └── schemas/
+├── <project_name>/
+│   ├── state.json              # 项目状态（当前阶段、规模等）
+│   ├── steps.json              # 文档步骤进度
+│   ├── overrides.json          # 项目级覆盖配置
+│   ├── docs/                   # 文档产出物
+│   │   ├── prd.md
+│   │   ├── prd.requirements.json    # 步骤产出物
+│   │   ├── tech-design.md
+│   │   └── ...
+│   ├── reviews/                # 审批记录
+│   └── dispatch/               # 调度记录
+└── <other_project>/
+    └── ...
+```
+
+## 自定义工作流
+
+Harmonia 使用两层工作流查找机制：
+
+1. **自定义目录**（高优先级）：`<data_dir>/harmonia/.workflows/<name>/`
+2. **内置目录**（回退）：`<package>/workflows/<name>/`
+
+自定义工作流会覆盖同名的内置工作流。内置工作流随包版本自动更新，零维护。
+
+### 创建自定义工作流
+
+在全局数据目录下创建 `.workflows/<name>/` 目录：
+
+```
+<data_dir>/harmonia/.workflows/
+└── my-workflow/
+    ├── workflow.json      # 工作流定义（阶段、角色、文档类型）
+    ├── roles/             # 角色提示词
+    │   ├── pm.md
+    │   └── ...
+    └── schemas/           # 文档 Schema（可选）
+        ├── prd.json
+        ├── prd.requirements.json   # 步骤 Schema
+        └── ...
+```
+
+### workflow.json 格式
+
+```json
+{
+  "name": "my-workflow",
+  "description": "自定义工作流描述",
+  "version": "1.0.0",
+  "author": "your-name",
+  "phases": [ ... ],
+  "docs": { ... }
+}
+```
+
+可参考内置 `dev` 工作流（`node_modules/@s_s/harmonia/workflows/dev/`）作为模板。
+
+### project_init 工作流选择
+
+- 只有一个可用工作流时自动选中
+- 多个可用工作流时，需在 `project_init` 中指定 `workflow` 参数
+- 示例：`project_init(project_name="my-app", project_dir="/path/to/src", workflow="my-workflow")`
+
+## 项目结构
+
+```
+harmonia/
+├── src/
+│   ├── index.ts              # 入口，注册所有 MCP 工具
+│   ├── cli/
+│   │   └── setup.ts          # CLI setup 命令
+│   ├── core/
+│   │   ├── types.ts          # 核心类型定义
+│   │   ├── state.ts          # 项目状态管理
+│   │   ├── docs.ts           # 文档读写
+│   │   ├── schema.ts         # P0 Schema 校验引擎
+│   │   ├── steps.ts          # P3 步骤管理
+│   │   ├── dispatch.ts       # 角色调度
+│   │   ├── registry.ts       # 项目注册表
+│   │   ├── workflow.ts       # 工作流加载
+│   │   ├── overrides.ts      # 工具约束管理
+│   │   └── reviews.ts        # 文档审批
+│   ├── tools/                # 11 个 MCP 工具注册
+│   ├── hooks/                # P2 Agent Hook 系统
+│   │   ├── content.ts        # Hook 内容生成
+│   │   ├── install.ts        # Hook 安装逻辑
+│   │   ├── claude-code.ts    # Claude Code hook 适配
+│   │   ├── opencode.ts       # OpenCode hook 适配
+│   │   └── openclaw.ts       # OpenClaw hook 适配
+│   └── setup/                # 项目初始化设置
+│       ├── inject.ts         # 配置注入
+│       └── templates.ts      # 模板管理
+├── workflows/
+│   └── dev/
+│       ├── workflow.json     # 工作流定义
+│       ├── roles/            # 角色提示词 (pm.md, architect.md, ...)
+│       └── schemas/          # 文档 + 步骤 Schema
+├── tests/                    # 测试 (261 tests, 13 files)
+└── .dev-logs/                # 开发日志
+```
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建
+npm run build
+
+# 开发模式（watch）
+npm run dev
+
+# 运行测试
+npm test
+
+# 运行测试（watch 模式）
+npm run test:watch
+
+# 代码格式化
+npm run prettier:fix
+```
+
+## License
+
+MIT

package/build/cli/setup.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI command: harmonia setup
+ *
+ * Prompt injection + hook installation only.
+ * No project registration, no state init — PM does that at runtime via MCP tools.
+ *
+ * Usage:
+ *   harmonia setup [options]
+ *
+ * Options:
+ *   --agent <type>       Agent type: opencode | claude-code | codex | openclaw (default: auto-detect)
+ */
+import type { AgentType } from '@s_s/agent-kit';
+interface SetupOptions {
+    agent?: AgentType;
+}
+/** Parse CLI flags from argv (starting after 'setup'). */
+export declare function parseSetupArgs(args: string[]): SetupOptions;
+/** Execute the setup command. */
+export declare function runSetup(opts: SetupOptions): Promise<void>;
+export {};

package/build/cli/setup.js

@@ -0,0 +1,71 @@
+/**
+ * CLI command: harmonia setup
+ *
+ * Prompt injection + hook installation only.
+ * No project registration, no state init — PM does that at runtime via MCP tools.
+ *
+ * Usage:
+ *   harmonia setup [options]
+ *
+ * Options:
+ *   --agent <type>       Agent type: opencode | claude-code | codex | openclaw (default: auto-detect)
+ */
+import { resolve } from 'node:path';
+import { detectHostAgent, injectPrompt } from '../setup/inject.js';
+import { installHooks } from '../hooks/install.js';
+import { getGlobalDir } from '../core/registry.js';
+const VALID_AGENTS = ['opencode', 'claude-code', 'codex', 'openclaw'];
+/** Parse CLI flags from argv (starting after 'setup'). */
+export function parseSetupArgs(args) {
+    const opts = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case '--agent':
+                if (!next || !VALID_AGENTS.includes(next)) {
+                    throw new Error(`--agent must be one of: ${VALID_AGENTS.join(', ')}`);
+                }
+                opts.agent = next;
+                i++;
+                break;
+            default:
+                throw new Error(`Unknown option: ${arg}\n\nUsage: harmonia setup [--agent opencode|claude-code|codex|openclaw]`);
+        }
+    }
+    return opts;
+}
+/** Execute the setup command. */
+export async function runSetup(opts) {
+    const projectDir = resolve(process.cwd());
+    console.log(`\nHarmonia Setup`);
+    console.log(`──────────────────────────────`);
+    // 1. Detect agent
+    const agentType = opts.agent ?? (await detectHostAgent(projectDir));
+    console.log(`  Agent: ${agentType}`);
+    // 2. Inject prompt (global scope — project-agnostic)
+    const result = await injectPrompt(agentType);
+    const action = result.created ? 'Created' : result.replaced ? 'Updated' : 'Appended to';
+    console.log(`  [done] ${action} ${result.filePath}`);
+    // 3. Install hooks
+    try {
+        const hookResult = await installHooks(agentType, {
+            dataDir: getGlobalDir(),
+        });
+        if (hookResult.success) {
+            console.log(`  [done] Hooks installed (${hookResult.filesWritten.length} files)`);
+            for (const w of hookResult.warnings) {
+                console.log(`  [warn] ${w}`);
+            }
+        }
+        else {
+            console.log(`  [fail] Hook install failed: ${hookResult.error ?? 'unknown'}`);
+        }
+    }
+    catch (err) {
+        console.log(`  [fail] Hook install error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // 4. Summary
+    console.log(`\n  Ready. Run your agent and call project_status() to begin.\n`);
+}
+//# sourceMappingURL=setup.js.map

package/build/cli/setup.js.map

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

package/build/core/dispatch.d.ts

@@ -36,3 +36,13 @@ export declare function updateDispatch(projectName: string, dispatchId: string,
  * Get a single dispatch record by ID.
  */
 export declare function getDispatch(projectName: string, dispatchId: string): Promise<DispatchRecord | null>;
+/** Valid state transitions for dispatch status. */
+export declare const DISPATCH_TRANSITIONS: Record<DispatchStatus, DispatchStatus[]>;
+/**
+ * Check if a dispatch status transition is valid.
+ */
+export declare function isValidTransition(from: DispatchStatus, to: DispatchStatus): boolean;
+/**
+ * Check if a dispatch status is terminal (no further transitions allowed).
+ */
+export declare function isTerminalStatus(status: DispatchStatus): boolean;

package/build/core/dispatch.js

@@ -153,4 +153,25 @@ export async function getDispatch(projectName, dispatchId) {
     const dispatches = await readDispatches(projectName);
     return dispatches.find((d) => d.id === dispatchId) ?? null;
 }
+// ─── Dispatch State Machine ───
+/** Valid state transitions for dispatch status. */
+export const DISPATCH_TRANSITIONS = {
+    dispatched: ['running', 'cancelled'],
+    running: ['completed', 'failed', 'cancelled'],
+    completed: [],
+    failed: [],
+    cancelled: [],
+};
+/**
+ * Check if a dispatch status transition is valid.
+ */
+export function isValidTransition(from, to) {
+    return DISPATCH_TRANSITIONS[from].includes(to);
+}
+/**
+ * Check if a dispatch status is terminal (no further transitions allowed).
+ */
+export function isTerminalStatus(status) {
+    return DISPATCH_TRANSITIONS[status].length === 0;
+}
 //# sourceMappingURL=dispatch.js.map

package/build/core/dispatch.js.map

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

package/build/core/docs.d.ts

@@ -2,6 +2,7 @@
  * Document management — read/write files under <data_dir>/<project_name>/docs/
  *
  * Supports both .md and .html files based on doc format configuration.
+ * Also supports step artifact files for sequential mode (e.g. prd.requirements.json).
  */
 import type { DocDefinition } from './types.js';
 /**
@@ -17,3 +18,15 @@ export declare function readDoc(projectName: string, docId: string): Promise<str
  * List all documents in <data_dir>/<project_name>/docs/
  */
 export declare function listDocs(projectName: string): Promise<string[]>;
+/**
+ * Write a step artifact to <data_dir>/<project_name>/docs/<docId>.<stepId>.<ext>
+ *
+ * @param format - "json" or "md" (determines file extension)
+ * @returns The file path written
+ */
+export declare function writeStepArtifact(projectName: string, docId: string, stepId: string, content: string, format: 'json' | 'md'): Promise<string>;
+/**
+ * Read a step artifact from <data_dir>/<project_name>/docs/<docId>.<stepId>.<ext>
+ * Tries .json first, then .md.
+ */
+export declare function readStepArtifact(projectName: string, docId: string, stepId: string): Promise<string>;

package/build/core/docs.js

@@ -2,6 +2,7 @@
  * Document management — read/write files under <data_dir>/<project_name>/docs/
  *
  * Supports both .md and .html files based on doc format configuration.
+ * Also supports step artifact files for sequential mode (e.g. prd.requirements.json).
  */
 import { mkdir, readFile, writeFile, readdir } from 'node:fs/promises';
 import { join } from 'node:path';
@@ -56,4 +57,35 @@ export async function listDocs(projectName) {
         return [];
     }
 }
+// ─── Step Artifact I/O ───
+/**
+ * Write a step artifact to <data_dir>/<project_name>/docs/<docId>.<stepId>.<ext>
+ *
+ * @param format - "json" or "md" (determines file extension)
+ * @returns The file path written
+ */
+export async function writeStepArtifact(projectName, docId, stepId, content, format) {
+    const dir = docsDir(projectName);
+    await mkdir(dir, { recursive: true });
+    const ext = format === 'json' ? '.json' : '.md';
+    const filePath = join(dir, `${docId}.${stepId}${ext}`);
+    await writeFile(filePath, content, 'utf-8');
+    return filePath;
+}
+/**
+ * Read a step artifact from <data_dir>/<project_name>/docs/<docId>.<stepId>.<ext>
+ * Tries .json first, then .md.
+ */
+export async function readStepArtifact(projectName, docId, stepId) {
+    const dir = docsDir(projectName);
+    for (const ext of ['.json', '.md']) {
+        try {
+            return await readFile(join(dir, `${docId}.${stepId}${ext}`), 'utf-8');
+        }
+        catch {
+            // try next extension
+        }
+    }
+    throw new Error(`Step artifact "${docId}.${stepId}" not found`);
+}
 //# sourceMappingURL=docs.js.map

package/build/core/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/core/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,SAAS,OAAO,CAAC,WAAmB;IAChC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,MAAsB;IAC3C,OAAO,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC1B,WAAmB,EACnB,KAAa,EACb,OAAe,EACf,MAAsB;IAEtB,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,WAAmB,EAAE,KAAa;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjC,4BAA4B;IAC5B,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACL,qBAAqB;QACzB,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,aAAa,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,WAAmB;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC;IACnH,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC"}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/core/docs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,SAAS,OAAO,CAAC,WAAmB;IAChC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,MAAsB;IAC3C,OAAO,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC1B,WAAmB,EACnB,KAAa,EACb,OAAe,EACf,MAAsB;IAEtB,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,WAAmB,EAAE,KAAa;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjC,4BAA4B;IAC5B,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACL,qBAAqB;QACzB,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,aAAa,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,WAAmB;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC;IACnH,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,4BAA4B;AAE5B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,WAAmB,EACnB,KAAa,EACb,MAAc,EACd,OAAe,EACf,MAAqB;IAErB,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,KAAa,EAAE,MAAc;IACrF,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACL,qBAAqB;QACzB,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,IAAI,MAAM,aAAa,CAAC,CAAC;AACpE,CAAC"}

package/build/core/registry.d.ts

@@ -34,7 +34,7 @@ export interface Registry {
 /**
  * Get the global Harmonia data directory, following system conventions.
  *
- * Resolution order:
+ * Delegates to @s_s/agent-kit which handles:
  *   1. HARMONIA_DATA_DIR env var (explicit override)
  *   2. Platform default:
  *      - macOS:   ~/Library/Application Support/harmonia