@wandoupeas/coding-forge 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wandoupeas
+
+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,347 @@
+# WebForge
+
+WebForge 是一个面向 Coding Agent 的 `agent-first harness` 参考实现。  
+它的目标不是替 agent 做决策，而是把项目状态、执行上下文、恢复机制和协作协议稳定地落在仓库里。
+
+最重要的一点：
+
+> 你应该直接使用 `Codex` 或 `Claude Code` 在仓库里工作，而 WebForge 负责约束和辅助它们如何工作。
+
+## 它是什么
+
+- 一个可持久化的 workspace contract
+- 一组围绕 `.webforge/` 运行的 core services
+- 一个 ready-task runtime 主循环
+- 一层以观察和校验为主的轻量 CLI
+- 一套能与 `superpowers` 共存的工程方法
+
+## 它不是什么
+
+- 不是把 CLI 当成主控制面的工作流引擎
+- 不是 if/else 驱动的伪 agent 编排器
+- 不是只靠聊天上下文维持连续性的工具
+- 不是把 `superpowers` 当成唯一记忆源的包装器
+
+## 核心模型
+
+```text
+用户目标
+  -> Coding Agent
+  -> WebForge workspace contract (.webforge/)
+  -> WebForge repo-side harness contract
+  -> planning/context/runtime core
+  -> deliverables / code / sessions
+```
+
+真正的项目真相位于 `.webforge/`：
+
+- `runtime.json`：当前执行状态
+- `tasks.json` / `phases.json`：任务图与阶段图
+- `knowledge/index.json`：知识入口
+- `deliverables/index.json`：交付物索引
+- `sessions/index.json`：跨会话恢复入口
+
+## 快速开始
+
+先构建 CLI：
+
+```bash
+npm install
+npm run build
+```
+
+如果你是 npm 使用者，安装方式会是：
+
+```bash
+npm install -g @wandoupeas/coding-forge
+```
+
+或者直接临时运行：
+
+```bash
+npx @wandoupeas/coding-forge --help
+```
+
+然后初始化一个新仓库：
+
+```bash
+node dist/cli/index.js init demo-app
+```
+
+这一步会同时生成：
+
+- `.webforge/` workspace contract
+- `AGENTS.md`
+- `docs/agent-guide.md`
+- `docs/methodology/superpowers-integration.md`
+
+初始化完成后，进入新仓库先运行：
+
+```bash
+node dist/cli/index.js doctor
+```
+
+如果你希望让正在仓库里工作的 agent 直接消费结构化状态，可以使用：
+
+```bash
+node dist/cli/index.js doctor --json
+node dist/cli/index.js resume --json
+```
+
+这两个命令分别回答：
+
+- 仓库契约是否完整
+- 当前 agent 下一步应该做什么
+
+如果你想用本地 Web UI 统一查看多个 WebForge 项目，可以直接启动：
+
+```bash
+node dist/cli/index.js ui --root ~/projects
+```
+
+如果你已经通过 npm 安装，则等价命令是：
+
+```bash
+webforge ui --root ~/projects
+```
+
+这个 UI 当前是只读监控台，会自动扫描根目录下带 `.webforge/` 的项目，并提供：
+
+- 多项目总览
+- 单项目 dashboard
+- 文档 / 交付物 / session 浏览
+- runtime / drift / checkpoint / mailbox / superpowers 观察
+
+## 怎么使用
+
+如果你是人类开发者，先看这两份：
+
+- [`docs/manuals/operations.md`](docs/manuals/operations.md)
+- [`docs/manuals/command-reference.md`](docs/manuals/command-reference.md)
+- [`docs/manuals/scenario-playbooks.md`](docs/manuals/scenario-playbooks.md)
+
+如果你是正在仓库里工作的 `Codex` 或 `Claude Code`，先看这两份：
+
+- [`AGENTS.md`](AGENTS.md)
+- [`docs/agent-guide.md`](docs/agent-guide.md)
+
+推荐最短使用路径：
+
+```bash
+node dist/cli/index.js init demo-app
+cd demo-app
+node /path/to/work-forge/dist/cli/index.js onboard --json
+```
+
+如果你已经通过 npm 安装，则等价命令是：
+
+```bash
+webforge init demo-app
+cd demo-app
+webforge onboard --json
+```
+
+`init` 会同时生成带 onboarding contract 的 `AGENTS.md`、`docs/agent-guide.md`、`docs/methodology/superpowers-integration.md`，以及可直接照着执行的 `docs/examples/agent-onboarding-protocol.md`。初始化结束时还会立即跑一次 post-init self-check，确认 `doctor` 和 `onboard` 与这些协议文件保持一致。
+
+如果你想显式重跑这次自检，可以直接执行：
+
+```bash
+node /path/to/work-forge/dist/cli/index.js verify init demo-app --json
+```
+
+如果你是 npm 安装用户，则直接执行：
+
+```bash
+webforge verify init demo-app --json
+```
+
+然后：
+
+1. 读取 `shouldRead`
+2. 导入需求到 `.webforge/knowledge/`
+3. 运行 `plan`
+4. 运行 `run`
+5. 用 `dashboard / logs runtime / deliverables / review` 观察和收口
+   其中 `logs runtime --json` 会同时给出 runtime 事件流、这条日志对应的恢复快照，以及当前工作区恢复快照
+
+如果你需要并行观察多个项目，则直接开 Web UI：
+
+```bash
+webforge ui --root ~/projects
+```
+
+推荐用法：
+
+1. 在首页看项目健康、blocked、pending review、drift
+2. 进入单项目页看 recovery、tasks、deliverables 和 runtime pulse
+3. 切到 `Artifacts` 页直接看 knowledge / deliverable / session 文本预览
+4. 切到 `Runtime` 页看日志快照 vs 当前工作区快照，以及 checkpoint 列表
+
+## 仓库结构
+
+```text
+.
+├── AGENTS.md
+├── README.md
+├── ARCHITECTURE.md
+├── docs/
+│   ├── agent-guide.md
+│   └── methodology/
+├── src/
+│   ├── core/
+│   ├── agent/
+│   ├── cli/
+│   └── testing/
+└── .webforge/              # 由 workspace 初始化后生成
+```
+
+## 五层分工
+
+1. `workspace contract`
+   `.webforge/` 的目录、文件、索引和字段约定。
+2. `state services`
+   `workspace / session / deliverable / mailbox / task` 等稳定持久化服务。
+3. `execution core`
+   `planning / context / runtime`，负责构建任务图和 ready-task 主循环。
+4. `agent facade`
+   `Agent` 只接收 `{ task, context }`，返回标准结果。
+5. `workflow enhancement layer`
+   `superpowers` 等方法增强层，负责“怎么做更稳”，不负责“项目真相是什么”。
+
+## 与 superpowers 的关系
+
+WebForge 和 `superpowers` 不是互相替代的关系：
+
+- WebForge 负责项目状态、恢复和执行协议
+- `superpowers` 负责设计、计划、评审、compact、线程化恢复等工作方法
+
+一句话：
+
+> WebForge 决定项目如何运作；superpowers 决定某类工作如何做得更稳。
+
+## 当前实现重点
+
+- `src/core/planning.ts`
+  从 knowledge index 构建任务图与阶段图
+- `src/core/context.ts`
+  为任务构建统一执行上下文
+- `src/core/runtime.ts`
+  按 ready 队列执行 `claim -> context -> agent.execute -> persist`
+- `src/agent/`
+  只保留标准执行门面与 handler
+- `src/cli/`
+  只保留兼容层和观察入口
+  包括 `init / plan / run / onboard / resume / dashboard / doctor / superpowers / knowledge / logs / deliverables / review / checkpoint / mailbox`
+
+## 适配对象
+
+这套设计优先兼容：
+
+- Codex
+- Claude Code
+
+兼容方式不是强行统一交互体验，而是统一仓库内事实模型：
+
+- 统一读 `.webforge/`
+- 统一写 `.webforge/`
+- 统一通过 runtime / session / thread linkage / deliverable / knowledge 恢复上下文
+
+## Codex / Claude Code 接入范式
+
+如果你是人类开发者在仓库里工作，推荐顺序是：
+
+```bash
+node dist/cli/index.js doctor
+node dist/cli/index.js resume
+node dist/cli/index.js dashboard
+```
+
+如果你是希望让 agent 直接消费仓库状态，推荐顺序是：
+
+```bash
+node dist/cli/index.js onboard --json
+```
+
+或者显式拆开：
+
+```bash
+node dist/cli/index.js doctor --json
+node dist/cli/index.js resume --json
+```
+
+标准含义：
+
+1. `onboard --json`
+   一次性输出 `doctor + resume + runtime log + recoveryReadiness` 的统一握手结果。
+2. `doctor --json`
+   先判断仓库契约是否完整，再决定能否直接继续工作。
+3. `resume --json`
+   获取当前 `nextAction`、`shouldRead`、`readyCount`、`blockedCount`、`pendingReviewCount`。
+4. 读取 `shouldRead` 里的文件。
+5. 如问题还在发散，用 `brainstorming`；如 spec 已经稳定，用 `writing-plans`。
+6. 如果使用了 `superpowers` workflow，把结果用 `webforge superpowers record ...` 回写到 `.webforge/superpowers-runs.json`。
+7. 执行工作，并把结果回写到 `.webforge/`。
+
+一句话：
+
+> `doctor` 先回答“仓库能不能继续”，`resume` 再回答“现在应该做什么”。
+
+`onboard --json` 里的 `recoveryReadiness` 会继续回答第三个问题：
+
+> 当前 `workflow context / latest superpowers run / thread linkage` 指向的 `artifact / worktree / compact / thread` 线索还能不能直接恢复。
+
+## 推荐阅读顺序
+
+1. `AGENTS.md`
+2. `ARCHITECTURE.md`
+3. `docs/manuals/operations.md`
+4. `docs/manuals/scenario-playbooks.md`
+5. `docs/manuals/command-reference.md`
+6. `docs/agent-guide.md`
+
+## 里程碑说明
+
+如果你想看当前内部工程进展、已完成能力、验证状态和下一阶段建议，直接看：
+
+- [`docs/milestones/2026-03-31-v0.1-internal-progress.md`](docs/milestones/2026-03-31-v0.1-internal-progress.md)
+6. `docs/methodology/harness-principles.md`
+7. `docs/methodology/superpowers-integration.md`
+8. `docs/examples/minimal-agent-onboarding.md`
+
+## 本地验证
+
+常用验证命令：
+
+```bash
+npm run test:unit
+npm run build
+npm run smoke:onboarding
+node dist/cli/index.js --help
+node dist/cli/index.js doctor
+```
+
+常用结构化观察命令：
+
+```bash
+node dist/cli/index.js onboard --json
+node dist/cli/index.js doctor --json
+node dist/cli/index.js resume --json
+node dist/cli/index.js logs runtime --json
+```
+
+常用 workflow 回写命令：
+
+```bash
+node dist/cli/index.js superpowers record writing-plans \
+  --summary "approved spec converted into execution plan" \
+  --artifact plan:docs/superpowers/plans/demo-plan.md \
+  --task T001
+```
+
+## 项目状态
+
+当前仓库正在向 WebForge v0.2 收敛：
+
+- `runtime` 已成为唯一主循环
+- CLI 已缩减为兼容层
+- 文档正在统一到 harness-first 叙事

package/dist/agent/adapters/base.d.ts

@@ -0,0 +1,9 @@
+import type { AgentConfig, AgentExecutionInput, AgentExecutionResult } from '../context.js';
+import type { AgentProvider } from '../../types/index.js';
+export interface AgentExecutionEngine {
+    execute(input: AgentExecutionInput, config: AgentConfig): Promise<AgentExecutionResult>;
+}
+export interface AgentAdapter extends AgentExecutionEngine {
+    provider: AgentProvider;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/agent/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,OAAO,CACL,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAa,SAAQ,oBAAoB;IACxD,QAAQ,EAAE,aAAa,CAAC;CACzB"}

package/dist/agent/adapters/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/agent/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/agent/adapters/base.ts"],"names":[],"mappings":""}

package/dist/agent/adapters/claude-code.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from './base.js';
+import { type CommandRunner } from './command-bridge.js';
+export declare function createClaudeCodeAgentAdapter(fallback: AgentAdapter, runner?: CommandRunner): AgentAdapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/agent/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/claude-code.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,YAAY,EACtB,MAAM,GAAE,aAA0B,GACjC,YAAY,CA6Bd"}

package/dist/agent/adapters/claude-code.js

@@ -0,0 +1,25 @@
+import { enrichResultMetadata, mapClaudeArgs, parseAgentExecutionResult, runCommand } from './command-bridge.js';
+export function createClaudeCodeAgentAdapter(fallback, runner = runCommand) {
+    return {
+        provider: 'claude-code',
+        async execute(input, config) {
+            const command = config.runtimeProfile.command ?? 'claude';
+            try {
+                const execution = await runner(mapClaudeArgs(command, input, config));
+                if (execution.exitCode !== 0) {
+                    throw new Error(execution.stderr.trim() || execution.stdout.trim() || 'claude failed');
+                }
+                const parsed = parseAgentExecutionResult(execution.stdout);
+                return enrichResultMetadata(parsed, 'claude-code', 'external-command', config);
+            }
+            catch (error) {
+                const fallbackResult = await fallback.execute(input, config);
+                return enrichResultMetadata(fallbackResult, 'claude-code', 'bridge-fallback', config, {
+                    adapterFallbackProvider: fallback.provider,
+                    adapterError: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+    };
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/agent/adapters/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/agent/adapters/claude-code.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,oBAAoB,EACpB,aAAa,EACb,yBAAyB,EACzB,UAAU,EACX,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,4BAA4B,CAC1C,QAAsB,EACtB,SAAwB,UAAU;IAElC,OAAO;QACL,QAAQ,EAAE,aAAa;QACvB,KAAK,CAAC,OAAO,CAAC,KAA0B,EAAE,MAAmB;YAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,IAAI,QAAQ,CAAC;YAE1D,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;gBACtE,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC7B,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,CAAC;gBACzF,CAAC;gBAED,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC3D,OAAO,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;YACjF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC7D,OAAO,oBAAoB,CACzB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,MAAM,EACN;oBACE,uBAAuB,EAAE,QAAQ,CAAC,QAAQ;oBAC1C,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBACrE,CACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/agent/adapters/codex.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from './base.js';
+import { type CommandRunner } from './command-bridge.js';
+export declare function createCodexAgentAdapter(fallback: AgentAdapter, runner?: CommandRunner): AgentAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/agent/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/codex.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACL,KAAK,aAAa,EAMnB,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,MAAM,GAAE,aAA0B,GACjC,YAAY,CA4Bd"}

package/dist/agent/adapters/codex.js

@@ -0,0 +1,27 @@
+import { enrichResultMetadata, mapCodexArgs, readStructuredOutput, runCommand, withTemporarySchemaFiles } from './command-bridge.js';
+export function createCodexAgentAdapter(fallback, runner = runCommand) {
+    return {
+        provider: 'codex',
+        async execute(input, config) {
+            const command = config.runtimeProfile.command ?? 'codex';
+            try {
+                return await withTemporarySchemaFiles(async ({ schemaPath, outputPath }) => {
+                    const execution = await runner(mapCodexArgs(command, input, config, schemaPath, outputPath));
+                    if (execution.exitCode !== 0) {
+                        throw new Error(execution.stderr.trim() || execution.stdout.trim() || 'codex failed');
+                    }
+                    const parsed = await readStructuredOutput(outputPath, execution.stdout);
+                    return enrichResultMetadata(parsed, 'codex', 'external-command', config);
+                });
+            }
+            catch (error) {
+                const fallbackResult = await fallback.execute(input, config);
+                return enrichResultMetadata(fallbackResult, 'codex', 'bridge-fallback', config, {
+                    adapterFallbackProvider: fallback.provider,
+                    adapterError: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+    };
+}
+//# sourceMappingURL=codex.js.map

package/dist/agent/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/agent/adapters/codex.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,uBAAuB,CACrC,QAAsB,EACtB,SAAwB,UAAU;IAElC,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,KAAK,CAAC,OAAO,CAAC,KAA0B,EAAE,MAAmB;YAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,IAAI,OAAO,CAAC;YAEzD,IAAI,CAAC;gBACH,OAAO,MAAM,wBAAwB,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE;oBACzE,MAAM,SAAS,GAAG,MAAM,MAAM,CAC5B,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAC7D,CAAC;oBAEF,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;wBAC7B,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,cAAc,CAAC,CAAC;oBACxF,CAAC;oBAED,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;oBACxE,OAAO,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;gBAC3E,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC7D,OAAO,oBAAoB,CAAC,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE;oBAC9E,uBAAuB,EAAE,QAAQ,CAAC,QAAQ;oBAC1C,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBACrE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/agent/adapters/command-bridge.d.ts

@@ -0,0 +1,67 @@
+import type { AgentConfig, AgentExecutionInput, AgentExecutionResult, AgentRuntimeProfile } from '../context.js';
+export interface CommandExecutionResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface CommandExecutionRequest {
+    command: string;
+    args: string[];
+    cwd: string;
+    input?: string;
+}
+export type CommandRunner = (request: CommandExecutionRequest) => Promise<CommandExecutionResult>;
+export declare function runCommand(request: CommandExecutionRequest): Promise<CommandExecutionResult>;
+export declare const AGENT_RESULT_SCHEMA: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["success", "summary", "needsReview"];
+    readonly properties: {
+        readonly success: {
+            readonly type: "boolean";
+        };
+        readonly summary: {
+            readonly type: "string";
+        };
+        readonly needsReview: {
+            readonly type: "boolean";
+        };
+        readonly error: {
+            readonly type: readonly ["string", "null"];
+        };
+        readonly metadata: {
+            readonly type: "object";
+        };
+        readonly deliverables: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type", "title", "content"];
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["document", "code", "test", "config", "design", "review"];
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                    };
+                    readonly content: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+    };
+};
+export declare function buildAgentPrompt(input: AgentExecutionInput, config: AgentConfig): string;
+export declare function mapCodexArgs(command: string, input: AgentExecutionInput, config: AgentConfig, schemaPath: string, outputPath: string): CommandExecutionRequest;
+export declare function mapClaudeArgs(command: string, input: AgentExecutionInput, config: AgentConfig): CommandExecutionRequest;
+export declare function withTemporarySchemaFiles<T>(callback: (paths: {
+    schemaPath: string;
+    outputPath: string;
+}) => Promise<T>): Promise<T>;
+export declare function readStructuredOutput(outputPath: string, stdout: string): Promise<AgentExecutionResult>;
+export declare function parseAgentExecutionResult(raw: string): AgentExecutionResult;
+export declare function enrichResultMetadata(result: AgentExecutionResult, provider: AgentRuntimeProfile['provider'], mode: 'external-command' | 'bridge-fallback', config: AgentConfig, extra?: Record<string, unknown>): AgentExecutionResult;
+//# sourceMappingURL=command-bridge.d.ts.map

package/dist/agent/adapters/command-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bridge.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/command-bridge.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC,wBAAsB,UAAU,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CA0DjC;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BtB,CAAC;AAEX,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,WAAW,GAClB,MAAM,CA0ER;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,uBAAuB,CAsBzB;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,WAAW,GAClB,uBAAuB,CA4BzB;AAED,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,QAAQ,EAAE,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1E,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAe3E;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC,EACzC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,EAC5C,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,oBAAoB,CAatB"}