@tea-agent/loop-agent 0.1.0

package/AGENTS.md

@@ -0,0 +1,121 @@
+@/Users/mac/.codex/RTK.md
+
+<!-- CODEGRAPH_START -->
+## CodeGraph
+
+如果仓库根目录存在 `.codegraph/`，在理解或定位代码前优先使用 CodeGraph，再考虑 rg/fd 或手动读文件。
+<!-- CODEGRAPH_END -->
+
+# AGENTS.md
+
+本仓库采用“人类掌舵，智能体执行”的工程方式。目标不是一次性写完所有代码，而是在一个可持续演进、可交接、可验证的系统里做小步增量。
+
+`AGENTS.md` 是地图，不是百科。顶层只保留开工协议、会话协议与文档导航；长期知识、方法论、决策、计划、报告和模板应进入 `docs/`。
+
+## 默认立场
+
+- 仓库是记录系统：决策、契约、计划、测试、报告优先落到仓库，而不是停留在聊天里。
+- 一次只推进一个清晰工作块；主会话按 Orient → Select → Contract → Implement → Verify → Handoff 治理，runtime 真实流程以 `src/workflows/` 为准。
+- 先验证基线，再叠加改动；如果当前基线已坏，优先定位基线问题。
+- 完成定义必须可验证；不能靠删测试、降标准或模糊描述制造“完成”。
+- 搜索先于实现；先查现有代码、文档、脚本、测试，避免重复造轮子或误判系统能力。
+- 在 DAG runtime 中，搜索/侦察是显式节点：标准路径是 Contract → Scout → Plan → Implement → Verify → Closeout/Handoff。
+- Shell 搜索优先 `rg`，按名找文件优先 `fd`；脚本确为 Bash 脚本时使用 Git Bash 或已配置的兼容 Bash，不要求 Windows 环境适配 POSIX 路径。
+- 用 loop-agent 迭代本仓库时，控制器必须来自已发布的 npm 安装包；首次安装或有意升级可用 `@tea-agent/loop-agent@latest`，但一次自举任务启动后不要中途升级控制器，并记录 `npm list -g @tea-agent/loop-agent --depth=0` 显示的实际版本。不要用当前工作区的 `npm link` 或 `npm run dev` 控制可能改动 CLI、DAG runtime、executor、package metadata 或 build output 的任务。
+- 反复出现的约束要固化为文档、脚本、检查项、测试或模板。
+- 禁止占位实现；除非 contract 明确约定为脚手架且标出后续闭环。
+
+## 开始顺序
+
+改文件前必须先完成：
+
+1. 运行 `pwd`。
+2. 阅读 `README.md`。
+3. 阅读 `harness.json`。
+4. 阅读 `docs/README.md`。
+5. 如果是实现类工作，继续阅读：
+   - `docs/development-principles.md`
+   - `docs/feature-workflow.md`
+   - `docs/verification-matrix.md`
+6. 如果任务涉及测试纪律、验证声明或调试，继续阅读：
+   - `docs/harness-methodology-tdd.md`
+   - `docs/harness-methodology-verification.md`
+   - `docs/harness-methodology-debugging.md`
+7. 查看最近提交、相关执行计划、progress/report，确认当前上下文。
+8. 检查 `git status --short --branch`。
+9. 运行本次任务相关的最小基线验证。
+
+## 会话协议
+
+1. Orient：读入口文档、相关专题、最近变更和现有实现。
+2. Select：只选一个清晰工作块；避免把重构、新功能、文档迁移混在一轮里。
+3. Contract：写清本轮交付物、非目标、完成标准、验证方法和失败条件。
+4. Implement：做最小增量实现，同步维护必要文档、脚本和测试。
+5. Verify：优先跑快速反馈，再跑必要的真实路径验证。
+6. Handoff：更新 progress/report/plan 中有长期价值的信息，写清风险、剩余项和下一步。
+
+这套会话协议不是 DAG runtime 的节点序列。复杂实现默认采用 Agent DAG：主 agent 负责拆任务、写 contract、限制路径、审查 DAG/writeSet、盯验证与 handoff；runtime 通过 `loop-agent dag run-task` 生成 DAG、`loop-agent dag validate` 校验、`loop-agent run-dag` 按依赖 ranks 执行节点。标准生成 DAG 的主干默认是 `contract-pi → scout-src/scout-tests → plan-pi → implement-pi → verify-pi → closeout-pi`，其中 `implement-pi` 使用 `executor: "pi"` 和 `toolProfile: "write"`；当 `harness.json` 显式禁用 Pi 且启用 Cursor 时，writer 节点才切换为 `implement-cursor` / `repair-cursor`。微小任务或 DAG runtime 自身修复也应优先使用 DAG 或 one-shot `pi-prompt` / `cursor-prompt` escape hatch。
+
+## 项目地图
+
+- `src/`：loop-agent 运行时代码
+- `test/`：Vitest 测试套件
+- `bin/loop-agent.js`：CLI 可执行入口
+- `skills/`：loop-agent 和 DAG 模板引用的本地 skill 指令与参考资料
+- `.harness/`：任务、DAG、run、cache 和 live state 等运行态目录
+- `docs/`：治理文档、计划、报告和模板
+- `website/`：Docusaurus 用户文档站
+- `scripts/`：验证和维护脚本
+
+## 工作规则
+
+- 每次任务只推进一个清晰、有边界的工作块。
+- 保留无关的用户改动，不要回退自己没有做的修改。
+- 优先沿用现有 helper、目录边界和局部模式，再考虑新增抽象。
+- 长期决策写入 `docs/`，不要只留在聊天里。
+- 面向使用者的新增、修改、删除或修复，应同步更新根目录 `CHANGELOG.md`；保持版本级摘要即可，不写过细技术细节。
+- 不提交占位实现。
+- 没有新鲜验证证据时，不声明工作完成。
+- 发现新 bug、技术债或契约漂移时，写回当前 plan、progress 或 report，而不是只在对话里提一句。
+- 涉及 harness 流程变化时，优先把变化落到 `harness.json`、模板、脚本或治理文档，而不是只改提示词。
+
+## 验证
+
+用 `docs/verification-matrix.md` 选择命令。常用门禁：
+
+```bash
+npm run typecheck
+npm test
+npm run build
+node bin/loop-agent.js --help
+bash scripts/check-repo.sh
+bash scripts/ci.sh
+```
+
+Windows 上运行 `scripts/*.sh` 时使用 Git Bash 或已配置的兼容 Bash。CLI、Node 代码、模板和提示词里的实际文件路径必须兼容 macOS 与 Windows：优先使用平台原生临时目录和 `path`/`os.tmpdir()`；仅在 repo 引用、JSON/Markdown 证据引用和 glob 约定中使用 `/` 作为稳定分隔符。
+
+文档站相关变更还需要按范围运行：
+
+```bash
+npm run docs:build
+```
+
+## 交接
+
+较大的工作结束时记录：
+
+- 改了什么
+- 为什么这样改
+- 执行过哪些验证命令以及结果
+- 是否影响契约、文档、测试或脚本
+- 剩余风险
+- 后续工作
+
+## 禁止事项
+
+- 不要在未读相关文档的前提下直接大改。
+- 不要一次混合重构、新功能和文档大迁移而没有清晰边界。
+- 不要把仅存在于对话里的约束当作长期知识。
+- 不要在缺少验证的情况下宣称完成。
+- 不要假设系统没有某个能力；先搜索再判断。
+- 不要用 stub、假数据通路或注释承诺替代真正交付。

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+# 更新日志
+
+这里记录每个版本面向使用者的主要变化。保持简短即可：新增、修改、修复或删除了什么，不需要展开实现细节。
+
+## [0.1.0] - 未发布
+
+### 新增
+
+- Agent DAG 支持 no-Cursor 环境：Pi 只读规划/审查、Pi `toolProfile: "write"` 受控写入、shell 验证。
+- 默认 implementation / repair writer 使用 `executor: "pi"` 加 `toolProfile: "write"`。
+- executor 配置保持 `pi` / `cursor` / `shell` / `static` 四类；Cursor 仍是显式启用的可选 backend。
+- Windows 环境下 shell verification 可自动使用 Git Bash。
+- Dynamic Workflow DAG Engine 的编译、校验、运行与回放命令。
+- 仓库内置 `skills/` 目录，用于 DAG 模板和本项目技能引用。
+- CLI 入口迁移为 commander 驱动的 command tree，顶层 help、子命令 help 和未知命令错误改用 commander 语义，同时保留既有命令能力。
+- `commander` 成为正式运行时依赖。
+- npm 发布包入口加载构建产物 `dist/cli.js`，并携带静态能力资料：`skills/`、顶层治理文档、`docs/templates/`、`examples/`、`harness.json`、`AGENTS.md`、`README.md` 和 `CHANGELOG.md`。
+- DAG skill 指令在目标项目没有本地 skill 时会回退到 npm 包内置 `skills/`，支持发布包作为任意项目的稳定控制器。
+
+### 修改
+
+- 默认 DAG 和模板从 Cursor-heavy 调整为 Pi read-only + Pi write profile + shell verify。
+- 移除独立 Pi 写入 executor 概念，写入能力改由 `toolProfile: "write"` 表达。
+- 文档、示例和 skill 指引将 Cursor 描述为可选 backend，而不是默认路径。
+- 治理和校验说明改为覆盖所有受控写入 executor，不再只绑定 Cursor。
+- 顺序式 Level 1 workflow 入口从推荐/公开路径中移除，DAG 成为主路径。
+- DAG 默认工程上下文 skill 从 `agent-context` 调整为 `ai-engineering-context`。
+- `npm run dev` 明确为源码调试入口；用 loop-agent 迭代本仓库时应使用已发布的 npm 安装包作为稳定控制器，安装或升级可用 `@latest`，单次任务执行期记录并冻结实际安装版本。
+- 发布包不携带已有 `docs/progress/`、`docs/reports/`、`docs/exec-plans/`、`docs/decisions/` 任务正文；这些目录的正文由目标仓库运行时生成。
+
+### 修复
+
+- no-Cursor DAG 生成、校验和 runner 测试可以在没有 Cursor 的环境下通过。
+- Windows 路径和 shell 执行相关的跨平台测试问题。
+- `doctor` 的 Pi CLI 探测支持当前 `@earendil-works/pi-coding-agent` 包名，并兼容 Windows npm shim 与跨平台 global npm 安装。
+- DAG draft、final verification 和 closeout draft 的默认临时输出路径改为平台原生临时目录，不再假设 `/tmp` 存在。
+- exec-plan 索引同步检查兼容发布包目录契约 README，不要求 npm 包内 README 链接未打包的源码历史计划正文。

package/README.md

@@ -0,0 +1,144 @@
+# loop-agent
+
+`loop-agent` 是从 `agent-memory/tools/code-agent` 独立出来的 TypeScript 工作流运行时，用来支撑 AI coding agent 在一个仓库内完成可恢复、可验证、可交接的研发任务。
+
+它保留了原 `code-agent` 的核心思路：以 Agent DAG 为主路径，用 `.harness/` 记录运行态事实，用 shell verification 作为完成依据，并把长期治理、计划和交接资料沉淀到 `docs/`。
+
+当前 CLI 使用 `commander` 组织 command tree。顶层 help、子命令 help、参数解析和未知命令错误都由 commander 驱动。
+
+## 核心能力
+
+- 生成、校验、执行和汇总 Agent DAG
+- 支持以 Agent DAG 为主的任务生成、校验、执行和收口
+- 维护 `loop` 长程任务状态，包括目标、轮次、信号、验证事实和收口草稿
+- 通过 Pi executor 执行只读规划、评审和诊断
+- 通过 Pi executor 的 `toolProfile: "write"` 执行有边界的写代码任务；Cursor executor 保留为显式启用的可选后端
+- 通过 shell executor 运行确定性的验证命令
+- 检查任务状态、运行态工件、文档链接和源码结构等治理规则
+
+## 目录结构
+
+| 路径 | 用途 |
+|---|---|
+| `src/` | CLI、命令、工作流、执行器、任务运行时、治理和共享 helper |
+| `test/` | Vitest 回归测试 |
+| `bin/loop-agent.js` | CLI 可执行入口 |
+| `skills/` | loop-agent 和 DAG 模板引用的本地 skill 指令与参考资料 |
+| `.harness/` | 任务、DAG、run、cache 和 live state 等运行态目录 |
+| `docs/` | 治理文档、工作流规则、执行计划、报告和模板 |
+| `website/` | Docusaurus 用户文档站 |
+| `examples/` | 可复用 DAG 示例 |
+| `scripts/` | 仓库验证和维护脚本 |
+
+## 安装
+
+```bash
+npm install
+```
+
+发布包 CLI 使用构建产物：
+
+```bash
+npm run build
+loop-agent --help
+```
+
+本地源码调试使用开发入口：
+
+```bash
+npm run dev -- --help
+```
+
+如果要用 loop-agent 迭代 loop-agent 本仓库，不要使用当前工作区的 `npm link` 或 `npm run dev` 作为控制器。应安装 npm 上已发布版本，让已安装的稳定版本操作当前仓库。首次安装或有意升级时使用 `@latest`，启动一次自举任务后不要在任务中途升级控制器：
+
+```bash
+npm install -g @tea-agent/loop-agent@latest
+npm list -g @tea-agent/loop-agent --depth=0
+loop-agent doctor
+loop-agent run-dag --dag <temp-dir>/<task-id>-dag.json --cwd <repo-root>
+```
+
+`@latest` 只用于安装或升级，不要在 DAG 节点里反复用 `npx @latest` 拉取。自举任务应记录 `npm list -g` 显示的实际版本号。
+
+发布包包含静态运行和指导资料：`bin/`、`dist/`、`skills/`、`docs/*.md`、`docs/templates/`、`examples/`、`harness.json`、`AGENTS.md`、`README.md` 和 `CHANGELOG.md`。`docs/progress/`、`docs/reports/`、`docs/exec-plans/`、`docs/decisions/` 等目录下的任务正文是目标仓库实时生成或历史事实；npm 包只携带这些目录的 README，不携带本仓库已有历史记录。
+
+发布包可作为任意目标项目的稳定控制器。DAG skill 指令优先从目标项目或用户配置目录解析；目标项目未提供本地 `skills/` 时，CLI 会回退到 npm 包内置的 `skills/`。因此普通项目不需要复制 loop-agent 仓库历史文档或内置 skills 才能获得默认 DAG 能力。
+
+## 常用命令
+
+```bash
+npm run typecheck
+npm test
+bash scripts/check-repo.sh
+bash scripts/ci.sh
+npm run docs:dev
+npm run docs:build
+```
+
+跨平台约定：
+
+- `scripts/*.sh` 是 Bash 脚本；Windows 上请通过 Git Bash 或已配置的兼容 Bash 运行，不要求使用 WSL 或 POSIX 路径。
+- 实际文件操作和 `--output` / `--dag` / `--cwd` 参数使用当前平台原生路径。仓库内引用、JSON/Markdown 证据引用和 glob 约定可继续用 `/` 作为稳定分隔符。
+
+创建并运行一个任务 DAG：
+
+```bash
+loop-agent new-task <task-id> "任务标题"
+loop-agent dag run-task <task-id> --profile auto --strict-models --output <temp-dir>/<task-id>-dag.json
+loop-agent dag validate --dag <temp-dir>/<task-id>-dag.json --strict-models --strict-governance
+loop-agent run-dag --dag <temp-dir>/<task-id>-dag.json --cwd .
+```
+
+`<temp-dir>` 表示平台原生临时目录；也可以省略 `--output`，再使用命令 JSON 输出里的 `outputPath`。
+
+一次性只读评审或有边界写入：
+
+```bash
+loop-agent pi-prompt --cwd . --tools read,grep,find,ls "只读评审这个任务，不要编辑文件。"
+loop-agent pi-prompt --cwd . --tools read,bash,edit,write,grep,find,ls "<包含 allowedPaths 和 forbiddenPaths 的有边界任务说明>"
+```
+
+## 文档站
+
+面向使用者的 Markdown 文档放在 `website/docs/`，通过 Docusaurus 渲染为静态 HTML。
+
+```bash
+npm run docs:dev
+npm run docs:build
+npm run docs:serve
+```
+
+构建产物输出到 `website/build/`。仓库根目录的 `docs/` 仍然是治理根目录，不和用户文档站混用。
+
+## 验证原则
+
+选择能覆盖本次变更的最小命令：
+
+- 文档或治理变更：`bash scripts/check-repo.sh`
+- TypeScript 运行时代码变更：`npm run typecheck`
+- 行为变更：`npm test`
+- 完整本地门禁：`bash scripts/ci.sh`
+
+Windows 上的 Bash 验证命令同样通过 Git Bash 或配置好的 Bash 执行；不要把 `/tmp`、`which`、POSIX shell builtin 等假设写进跨平台 CLI 逻辑。
+
+不要在没有新鲜验证结果的情况下声明完成。
+
+## 发布前检查
+
+发布 npm 包前至少运行：
+
+```bash
+npm run typecheck
+npm test
+npm run build
+node bin/loop-agent.js --help
+npm pack --dry-run
+```
+
+发布入口 `bin/loop-agent.js` 只加载 `dist/cli.js`；`npm run dev -- <args>` 只用于源码开发和定位问题。
+
+## 改造来源
+
+`loop-agent` 来自 `agent-memory/tools/code-agent` 的主仓库化改造。原型阶段的 `code-agent` 文档偏内部说明；当前仓库入口文档面向独立项目维护和使用。
+
+已完成的主仓库重构记录保留在源码仓库的历史 execution plans 中；发布包只携带目录说明和可复用运行资料。

package/bin/loop-agent.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const cliEntry = join(packageRoot, "dist", "cli.js");
+
+if (!existsSync(cliEntry)) {
+  console.error(
+    `loop-agent: cannot find built CLI at ${cliEntry}. Run \`npm run build\` before using the package bin.`,
+  );
+  process.exit(1);
+}
+
+try {
+  await import(pathToFileURL(cliEntry).href);
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}

package/dist/adapters/aimax.js

@@ -0,0 +1,91 @@
+import path from 'node:path';
+import { buildStepContextFiles } from './context.js';
+import { loadHarnessManifest as coreLoadHarnessManifest } from '../governance/harness.js';
+function getKeyRepoPaths(repoRoot, manifest) {
+    const keys = [];
+    for (const key of ['readme', 'agents', 'governanceIndex', 'principles', 'workflow', 'verificationMatrix', 'systemOverview', 'architectureBoundaries', 'repoMap', 'backlog']) {
+        const value = manifest.entrypoints[key];
+        if (value)
+            keys.push(path.join(repoRoot, value));
+    }
+    return keys.filter((filePath) => filePath.length > 0);
+}
+function getRepoFilesForStep(repoRoot, manifest, step, contextProfile) {
+    const slim = contextProfile === 'slim';
+    if (step === 'analyze') {
+        if (slim) {
+            return [path.join(repoRoot, 'harness.json')];
+        }
+        return getKeyRepoPaths(repoRoot, manifest);
+    }
+    if (step === 'spec') {
+        if (slim) {
+            return [
+                path.join(repoRoot, 'harness.json'),
+                ...['verificationMatrix', 'architectureBoundaries']
+                    .map((key) => manifest.entrypoints[key])
+                    .filter((value) => Boolean(value))
+                    .map((value) => path.join(repoRoot, value)),
+            ];
+        }
+        return Array.from(new Set([
+            ...getKeyRepoPaths(repoRoot, manifest),
+            ...['principles', 'workflow', 'verificationMatrix', 'architectureBoundaries']
+                .map((key) => manifest.entrypoints[key])
+                .filter((value) => Boolean(value))
+                .map((value) => path.join(repoRoot, value)),
+        ]));
+    }
+    if (step === 'plan') {
+        if (slim) {
+            const keys = ['verificationMatrix', 'architectureBoundaries'];
+            return keys
+                .map((key) => manifest.entrypoints[key])
+                .filter((value) => Boolean(value))
+                .map((value) => path.join(repoRoot, value));
+        }
+        return ['principles', 'workflow', 'verificationMatrix', 'architectureBoundaries']
+            .map((key) => manifest.entrypoints[key])
+            .filter((value) => Boolean(value))
+            .map((value) => path.join(repoRoot, value));
+    }
+    return [];
+}
+async function getContextFilesForStep(repoRoot, manifest, taskId, step, taskConfig) {
+    const repoFiles = getRepoFilesForStep(repoRoot, manifest, step, taskConfig.contextProfile);
+    return buildStepContextFiles({
+        repoRoot,
+        manifest,
+        taskId,
+        step,
+        taskConfig,
+        repoFiles,
+    });
+}
+function getVerifyCommands(repoRoot, options) {
+    const quickCommands = [
+        {
+            args: ['bash', 'scripts/check-repo.sh'],
+            cwd: repoRoot,
+            label: 'repo governance checks',
+        },
+    ];
+    const standardCommands = [
+        {
+            args: ['bash', 'scripts/ci.sh'],
+            cwd: repoRoot,
+            label: 'full CI suite',
+        },
+    ];
+    if (options.preset === 'quick')
+        return quickCommands;
+    if (options.preset === 'standard')
+        return [...quickCommands, ...standardCommands];
+    return [...quickCommands, ...standardCommands];
+}
+export const aimaxAdapter = {
+    name: 'aimax',
+    loadHarnessManifest: coreLoadHarnessManifest,
+    getContextFilesForStep,
+    getVerifyCommands,
+};

package/dist/adapters/context.js

@@ -0,0 +1,32 @@
+import { getArtifactPath } from '../shared/artifacts-core.js';
+import { buildContextFiles } from '../shared/context-files.js';
+import { getTaskDir, listTaskSourceFiles } from '../task/runtime.js';
+import { getReferenceContextFiles } from '../shared/reference-context.js';
+export async function buildStepContextFiles(input) {
+    const sourceFiles = await listTaskSourceFiles(input.repoRoot, input.taskId);
+    const taskDir = getTaskDir(input.repoRoot, input.taskId);
+    const referenceFiles = await getReferenceContextFiles(input.repoRoot, input.taskId, input.taskConfig);
+    const artifactFiles = input.step === 'plan'
+        ? [getArtifactPath(taskDir, 'analyze')]
+        : input.step === 'implement'
+            ? [getArtifactPath(taskDir, 'analyze'), getArtifactPath(taskDir, 'plan')]
+            : input.step === 'retrospective'
+                ? [
+                    getArtifactPath(taskDir, 'analyze'),
+                    getArtifactPath(taskDir, 'plan'),
+                    getArtifactPath(taskDir, 'implement'),
+                    getArtifactPath(taskDir, 'verify'),
+                    `${taskDir}/logs/workflow.log`,
+                ]
+                : [];
+    const groups = input.step === 'analyze'
+        ? [sourceFiles, referenceFiles, input.repoFiles, artifactFiles]
+        : input.step === 'plan'
+            ? [sourceFiles, referenceFiles, artifactFiles, input.repoFiles]
+            : input.step === 'implement'
+                ? [sourceFiles, referenceFiles, artifactFiles, input.repoFiles]
+                : input.step === 'retrospective'
+                    ? [artifactFiles, sourceFiles, referenceFiles, input.repoFiles]
+                    : [sourceFiles, referenceFiles, input.repoFiles, artifactFiles];
+    return buildContextFiles(groups, input.taskConfig);
+}

package/dist/adapters/index.js

@@ -0,0 +1,28 @@
+import { loadHarnessManifest } from '../governance/harness.js';
+import { loopAgentAdapter } from './loop-agent.js';
+import { aimaxAdapter } from './aimax.js';
+const ADAPTERS = {
+    'loop-agent': loopAgentAdapter,
+    aimax: aimaxAdapter,
+};
+export async function resolveAdapter(repoRoot, explicit) {
+    if (explicit) {
+        const adapter = ADAPTERS[explicit];
+        if (!adapter)
+            throw new Error(`unknown adapter: ${explicit}; valid options: ${Object.keys(ADAPTERS).join(', ')}`);
+        return adapter;
+    }
+    try {
+        const manifest = await loadHarnessManifest(repoRoot);
+        const adapter = ADAPTERS[manifest.project];
+        if (!adapter)
+            throw new Error(`no adapter registered for project "${manifest.project}"; valid options: ${Object.keys(ADAPTERS).join(', ')}`);
+        return adapter;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('no adapter registered'))
+            throw error;
+        throw new Error(`failed to resolve adapter from ${repoRoot}/harness.json: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export { loopAgentAdapter, aimaxAdapter };

package/dist/adapters/loop-agent.js

@@ -0,0 +1,98 @@
+import path from 'node:path';
+import { buildStepContextFiles } from './context.js';
+import { loadHarnessManifest } from '../governance/harness.js';
+function getKeyRepoPaths(repoRoot, manifest) {
+    const keys = [];
+    for (const key of ['readme', 'agents', 'governanceIndex', 'principles', 'workflow', 'verificationMatrix']) {
+        const value = manifest.entrypoints[key];
+        if (value)
+            keys.push(path.join(repoRoot, value));
+    }
+    return keys;
+}
+function getRepoFilesForStep(repoRoot, manifest, step, contextProfile) {
+    const slim = contextProfile === 'slim';
+    if (step === 'analyze') {
+        if (slim) {
+            return [path.join(repoRoot, 'harness.json')];
+        }
+        return getKeyRepoPaths(repoRoot, manifest);
+    }
+    if (step === 'spec') {
+        if (slim) {
+            const files = [path.join(repoRoot, 'harness.json')];
+            const verification = manifest.entrypoints.verificationMatrix;
+            if (verification)
+                files.push(path.join(repoRoot, verification));
+            return files;
+        }
+        return Array.from(new Set([
+            ...getKeyRepoPaths(repoRoot, manifest),
+            ...['principles', 'workflow', 'verificationMatrix']
+                .map((key) => manifest.entrypoints[key])
+                .filter((value) => Boolean(value))
+                .map((value) => path.join(repoRoot, value)),
+        ]));
+    }
+    if (step === 'plan') {
+        if (slim) {
+            const verification = manifest.entrypoints.verificationMatrix;
+            return verification ? [path.join(repoRoot, verification)] : [];
+        }
+        return ['principles', 'workflow', 'verificationMatrix']
+            .map((key) => manifest.entrypoints[key])
+            .filter((value) => Boolean(value))
+            .map((value) => path.join(repoRoot, value));
+    }
+    return [];
+}
+async function getContextFilesForStep(repoRoot, manifest, taskId, step, taskConfig) {
+    const repoFiles = getRepoFilesForStep(repoRoot, manifest, step, taskConfig.contextProfile);
+    return buildStepContextFiles({
+        repoRoot,
+        manifest,
+        taskId,
+        step,
+        taskConfig,
+        repoFiles,
+    });
+}
+function getVerifyCommands(repoRoot, options) {
+    const quickCommands = [
+        {
+            args: ['bash', 'scripts/check-repo.sh'],
+            cwd: repoRoot,
+            label: 'repo governance checks',
+        },
+    ];
+    const standardCommands = [
+        {
+            args: ['npm', 'run', 'typecheck'],
+            cwd: repoRoot,
+            label: 'loop-agent typecheck',
+        },
+    ];
+    const fullCommands = [
+        {
+            args: ['npm', 'test'],
+            cwd: repoRoot,
+            label: 'loop-agent tests',
+        },
+    ];
+    const selectedCommands = options.preset === 'quick'
+        ? quickCommands
+        : options.preset === 'standard'
+            ? [...quickCommands, ...standardCommands]
+            : [...quickCommands, ...standardCommands, ...fullCommands];
+    if (options.phase === 'final' || !options.quota || options.quota === 'full') {
+        return selectedCommands;
+    }
+    const maxCommands = options.quota === '1' ? 1 : 3;
+    return selectedCommands.slice(0, maxCommands);
+}
+export const loopAgentAdapter = {
+    name: 'loop-agent',
+    loadHarnessManifest,
+    getContextFilesForStep,
+    getVerifyCommands,
+};

package/dist/adapters/types.js

@@ -0,0 +1 @@
+export {};