@tea-agent/loop-agent 0.1.0-fe-test.0

package/README.md

@@ -0,0 +1,177 @@
+# loop-agent
+
+`loop-agent` 是面向 AI coding agent 的仓库级任务运行时与治理工具。它把研发任务组织为可审查、可执行、可恢复、可验证的 Agent DAG，并将任务源、写入边界、运行事实和完成证据保存在仓库中。
+
+发布包提供两个 CLI：
+
+| CLI | 职责 |
+| --- | --- |
+| `loop-agent` | 单仓库任务、Agent DAG、验证、恢复与治理 |
+| `agent-worker` | 可选的 Feature、TaskSpec、Task Pool 与 Observe 外层编排 |
+
+受治理的 Agent writer 只有 Pi；`cursor-prompt` 仅用于显式手工 one-shot，不进入 DAG 或 Loop 自动写入路径。
+
+## 适合解决什么问题
+
+- 把模糊的 coding 请求转成有任务源、边界和验收标准的执行过程。
+- 在 Contract → Scout → Plan → Implement → Verify → Closeout 节点间保留可审查证据。
+- 用 `allowedPaths`、`forbiddenPaths` 和 DAG `writeSet` 限制模型写入。
+- 在中断、失败或跨会话后，从 `.harness/` 中恢复真实状态。
+- 用 shell verification 而不是模型自述判断任务是否完成。
+- 可选地通过 `agent-worker` 编排 Feature、Ready Queue、QA、交付与只读 Observe 看板。
+
+## 5 分钟开始
+
+### 安装
+
+```bash
+npm install -g @tea-agent/loop-agent@latest
+loop-agent --version
+```
+
+渠道说明（普通用户默认 `latest`；开发/测试用 `next`；固定某条版本线用
+`release-x.y`；正式 dogfood 用精确版本）：
+
+```bash
+npm install -g @tea-agent/loop-agent                 # 推荐稳定版本
+npm install -g @tea-agent/loop-agent@next            # main 高频开发构建
+npm install -g @tea-agent/loop-agent@release-0.37    # 0.37 版本线最新 patch
+npm install -g @tea-agent/loop-agent@0.37.5          # 精确、可复现
+```
+
+完整发布治理见 `docs/operations/version-and-release-management.md`。
+
+### 初始化当前项目
+
+```bash
+loop-agent init instructions --repo-root .
+loop-agent init --repo-root . --profile full --merge
+loop-agent init doctor --repo-root .
+loop-agent inspect --repo-root .
+```
+
+初始化会保留已有用户内容，并补充 `AGENTS.md`、`harness.json`、`ai_workspace/loop-agent/`、`.agents/skills/`、`.harness/` 和验证脚本等治理入口。
+
+控制器升级后，旧项目可能仍使用过期的 repo-local skills、模板、managed blocks 和治理说明。普通安全仓库命令结束时会自动检测目标项目是否需要对齐：非 TTY 只向 stderr 输出提示且不写入目标；TTY 且无 human decisions、无活跃 DAG/Worker 时，可经明确 `y/yes` 同意后应用 deterministic safe actions；也可手动运行统一入口：
+
+```bash
+loop-agent init reconcile --repo-root .
+```
+
+`init reconcile` 在 surface 缺失、存在 human decisions、存在活跃 DAG/Worker 或无法确认 Worker 状态时零写入，并返回 `needs-baseline`、`needs-human-decision` 或 `blocked-active-runtime`；其余情况复用 `init update --apply-safe` 的安全动作并复查返回 `clean`、`needs-model-merge` 或 `needs-safe-update`。
+
+写入型自然语言请求「`loop-agent初始化更新`」或「`loop-agent 初始化更新`」必须进入可恢复的统一闭环，而不是只做检查：
+
+```bash
+loop-agent init upgrade --repo-root . --json
+# controller 返回单文件 merge task 后：
+loop-agent init upgrade --repo-root . --run-id <run-id> --continue --json
+```
+
+它在 `.harness/init-upgrades/<run-id>/` 保存身份、扫描、动作收据、合并任务、验证与报告；`--status` / `--report` 只读。默认管理项目 `.opencode/plugins/`、`.pi/extensions/` 和 `.pi/settings.json`，不会默认写 `~/.pi/agent/settings.json`。旧项目首次执行后需 reload 宿主会话，以加载更新后的 AGENTS、skills 与 recovery 产物。明确「检查初始化更新」「只检查，不要修改」仍只运行 `init check-update`。
+
+完整说明见[初始化目标项目](website/docs/quick-start/init-target-project.md)。
+
+### 运行第一个任务
+
+初始化后，在已初始化的目标项目中你可以直接对宿主 agent 说「**loop-agent 帮我完成 XXX 需求**」（或「帮我实现 / 帮我修复 / 帮我开发 XXX」「使用 loop-agent 完成 XXX」「按 loop-agent 流程处理 XXX」），初始化写入的 `AGENTS.md` 与 `.agents/skills/loop-agent/` 会把这类通用需求表达确定性地路由进 Agent DAG，**无需**追加额外的 `cli` 关键词。主会话只负责编排与验证，业务实现由受治理 DAG writer 完成。
+
+```bash
+# 标准单任务路径：唯一 mutation 入口 task advance + 可选只读 task status
+loop-agent task advance example-task "实现一个有明确验收标准的小功能" \
+  --prd path/to/prd.md \
+  --allowed-path "src/**" \
+  --forbidden-path ".harness/**" \
+  --verify "<label>:<command>" \
+  --json
+
+# 审查返回的 writeSet / gate.digest 后，同一命令批准并长跑到稳定终态
+loop-agent task advance example-task \
+  --approve-gate "write-set-review:<digest>" \
+  --json
+
+# 可选只读查询（不 refresh、不 mutation）
+loop-agent task status example-task --json
+```
+
+`--verify` 命令应取项目 `AGENTS.md` / `docs/governance/verification-matrix.md` 登记的验证命令（不要假定 `npm run typecheck` 存在）；`--verify` 可选，省略时自动从 package.json scripts 或既有 managed `task.json.verifyCommands` 推导建议。
+
+首次 `task advance` 会 create/import PRD/派生 managed contract/生成并 strict validate DAG，然后停在 writeSet gate；未批准不会启动业务 writer。详细步骤见[第一次运行](website/docs/quick-start/first-run.md)和 [Agent DAG 工作流](website/docs/guides/agent-dag.md)。
+
+## 查看执行状态
+
+```bash
+loop-agent task status example-task --json
+# advanced forensic（非标准主路径）
+loop-agent dag report --run-id <run-id>
+```
+
+### Official 本地操作面（CLI + 统一 Operator Console）
+
+| 入口 | 命令 | 角色 |
+| --- | --- | --- |
+| 受治理 CLI | `loop-agent …` / `agent-worker …` | 权威写入与诊断 |
+| Loop Operator Console | `agent-worker console` | Official 本地控制面（默认 repo=当前目录、`127.0.0.1:8790`，含 Operate 与 Inspect） |
+| Inspect（只读） | `agent-worker console` → `/inspect/`；`observe snapshot` | 统一 Console 内只读检视；`observe serve` 已下线（REMOVED / exit 2） |
+
+```bash
+# 终端 A：Console（任务/运行操作面；canonical mutation 只经 sibling loop-agent）
+agent-worker console                              # 默认 repo=当前目录、port=8790；本地图形环境默认打开浏览器
+agent-worker console --no-open                    # 只启动服务，不打开浏览器
+agent-worker console doctor --repo .
+
+```
+
+访问 Console <http://127.0.0.1:8790/>；**Operator Chat Official** 是 Console 内的主引导交互，默认打开「对话」工作区。构建时设置 `VITE_OPERATOR_CHAT_DEFAULT_LANDING=tasks` 可改回 Tasks；URL hash（`#/tasks`）与 localStorage 仍优先于默认值。顶部「检视」以及 `/inspect/` 提供只读 Dashboard、DAG、时间线与 artifacts；`loop-agent …` / `agent-worker …` CLI direct path 仍是受治理 fallback。当前状态为 **code ready, dogfood pending/unmet**，不宣称已替代 openCode 或其他外部主会话。
+
+## 核心边界
+
+- `.harness/` 保存任务、DAG run、one-shot run、可选 Task Pool 与 `init-upgrades/` 可恢复升级运行事实。
+- `ai_workspace/loop-agent/` 保存目标项目的长期治理资料。
+- `.agents/skills/` 保存目标项目可审计的 repo-local skills。
+- `agent-worker` 通过已发布的 `loop-agent` 子进程执行 DAG，不维护第二套 runtime kernel。
+- 当前不内置远程 Task Pool、云 Worker 集群、自动 push、自动创建或合并 PR、生产凭据管理。
+
+架构说明见[系统全景](docs/architecture/system-overview.md)和 [runtime 边界](docs/architecture/runtime-boundaries.md)。
+
+## 文档导航
+
+### 使用者
+
+- [安装](website/docs/quick-start/installation.md)
+- [初始化目标项目](website/docs/quick-start/init-target-project.md)
+- [第一次运行](website/docs/quick-start/first-run.md)
+- [功能导览](website/docs/overview/feature-map.md)
+- [CLI 参考](website/docs/reference/cli.md)
+- [Observe 看板](website/docs/guides/observe-ui.md)
+
+### 维护者与 Agent
+
+- [`AGENTS.md`](AGENTS.md)：开工协议与工作规则
+- [`docs/README.md`](docs/README.md)：治理文档总索引
+- [`docs/governance/`](docs/governance/README.md)：工程原则、工作流与验证方法
+- [`docs/runtime/`](docs/runtime/README.md)：DAG 运行、恢复与 runtime 手册
+- [`docs/operations/`](docs/operations/README.md)：本地环境、合并与协作操作
+- [`docs/governance/feature-workflow.md`](docs/governance/feature-workflow.md)：会话治理与 runtime workflow
+- [`docs/governance/verification-matrix.md`](docs/governance/verification-matrix.md)：验证命令选择
+- [`docs/architecture/`](docs/architecture/README.md)：架构、事实与演进边界
+- [`CHANGELOG.md`](CHANGELOG.md)：版本变化与 breaking changes
+
+## 本仓库开发
+
+开始修改前先阅读 `AGENTS.md`。常用验证：
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+bash scripts/check-repo.sh
+```
+
+完整门禁和特定环境排障分别见：
+
+- [`docs/governance/verification-matrix.md`](docs/governance/verification-matrix.md)
+- [`docs/operations/local-development-environment.md`](docs/operations/local-development-environment.md)
+
+发布和初始化 surface 变更还应运行 `npm pack --dry-run` 与 `bash scripts/check-init-surface.sh`。

package/bin/agent-worker.js

@@ -0,0 +1,22 @@
+#!/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", "worker", "cli.js");
+
+if (!existsSync(cliEntry)) {
+  console.error(
+    `agent-worker: cannot find built CLI at ${cliEntry}. Run \`npm run build\` before using the package bin.`,
+  );
+  process.exit(1);
+}
+
+try {
+  const cli = await import(pathToFileURL(cliEntry).href);
+  await cli.main(process.argv);
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}

package/bin/loop-agent.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { existsSync, readdirSync, statSync } 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);
+}
+
+/**
+ * Stale-dist guard: when running from a source checkout (src/ present), refuse
+ * to silently execute a dist/ that predates the latest source edit. The
+ * classic failure mode is editing src/** and running the bin without
+ * `npm run build`, which executes the previous build. Suppress with
+ * --ignore-stale-dist when intentionally running a stale build.
+ */
+const srcDir = join(packageRoot, "src");
+const ignoreStale = process.argv.includes("--ignore-stale-dist");
+if (ignoreStale) {
+  process.argv = process.argv.filter((arg) => arg !== "--ignore-stale-dist");
+}
+if (!ignoreStale && existsSync(srcDir)) {
+  const distCliMtime = statSync(cliEntry).mtimeMs;
+  let newestSrcMtime = 0;
+  const walk = (dir) => {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const full = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(full);
+      } else {
+        const mtime = statSync(full).mtimeMs;
+        if (mtime > newestSrcMtime) newestSrcMtime = mtime;
+      }
+    }
+  };
+  walk(srcDir);
+  if (newestSrcMtime > distCliMtime) {
+    console.error(
+      `loop-agent: dist/ is stale relative to src/ (a source file is newer than ${cliEntry}).\n` +
+        `  Run \`npm run build\` before using the bin, or pass --ignore-stale-dist to run the stale build intentionally.`,
+    );
+    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,29 @@
+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 adapterName = manifest.adapter ?? manifest.project;
+        const adapter = ADAPTERS[adapterName];
+        if (!adapter)
+            throw new Error(`no adapter registered for project "${adapterName}"; 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,192 @@
+import path from 'node:path';
+import { readFileSync } from 'node:fs';
+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 manifestCommands = getManifestVerifyCommands(repoRoot, options.preset);
+    if (manifestCommands) {
+        return applyQuota(manifestCommands, options);
+    }
+    if (options.taskConfig?.taskKind === 'frontend-implementation') {
+        const frontendCommands = getFrontendProjectVerifyCommands(repoRoot, options);
+        if (frontendCommands)
+            return frontendCommands;
+    }
+    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];
+    return applyQuota(selectedCommands, options);
+}
+function getFrontendProjectVerifyCommands(repoRoot, options) {
+    let scripts;
+    try {
+        const packageJson = JSON.parse(readFileSync(path.join(repoRoot, 'package.json'), 'utf8'));
+        if (!packageJson.scripts || typeof packageJson.scripts !== 'object')
+            return undefined;
+        scripts = packageJson.scripts;
+    }
+    catch {
+        return undefined;
+    }
+    let packageManager = 'npm';
+    for (const [lockfile, manager] of [
+        ['pnpm-lock.yaml', 'pnpm'],
+        ['yarn.lock', 'yarn'],
+        ['bun.lockb', 'bun'],
+        ['bun.lock', 'bun'],
+    ]) {
+        try {
+            readFileSync(path.join(repoRoot, lockfile));
+            packageManager = manager;
+            break;
+        }
+        catch {
+            // Try the next package-manager marker.
+        }
+    }
+    const hasScript = (name) => typeof scripts[name] === 'string' && String(scripts[name]).trim().length > 0;
+    const commandFor = (name) => ({
+        args: name === 'test'
+            ? [packageManager, 'test']
+            : [packageManager, 'run', name],
+        cwd: repoRoot,
+        label: `${packageManager} ${name === 'test' ? 'test' : `run ${name}`}`,
+    });
+    const collect = (names) => names.filter(hasScript).map(commandFor);
+    const staticCommands = collect(['typecheck', 'check-types', 'lint', 'check', 'build']);
+    const behaviorCommands = collect(['test:unit', 'test:frontend', 'test:component', 'test', 'test:e2e', 'e2e']);
+    if (staticCommands.length === 0 && behaviorCommands.length === 0)
+        return undefined;
+    const selected = options.phase === 'final'
+        ? [...staticCommands, ...behaviorCommands]
+        : staticCommands;
+    if (selected.length === 0)
+        return behaviorCommands;
+    return applyQuota(selected, options);
+}
+function applyQuota(commands, options) {
+    if (options.phase === 'final' || !options.quota || options.quota === 'full') {
+        return commands;
+    }
+    const maxCommands = options.quota === '1' ? 1 : 3;
+    return commands.slice(0, maxCommands);
+}
+function commandFromScript(repoRoot, label, command) {
+    return {
+        args: ['bash', '-lc', command],
+        cwd: repoRoot,
+        label,
+    };
+}
+function getManifestVerifyCommands(repoRoot, preset) {
+    try {
+        const manifest = JSON.parse(readFileSync(path.join(repoRoot, 'harness.json'), 'utf-8'));
+        const quick = typeof manifest.scripts?.quickVerify === 'string'
+            ? manifest.scripts.quickVerify
+            : undefined;
+        const standard = typeof manifest.scripts?.standardVerify === 'string'
+            ? manifest.scripts.standardVerify
+            : undefined;
+        const full = typeof manifest.scripts?.fullVerify === 'string'
+            ? manifest.scripts.fullVerify
+            : undefined;
+        if (!quick && !standard && !full)
+            return undefined;
+        const quickCommands = quick ? [commandFromScript(repoRoot, 'repo quick verification', quick)] : [];
+        const standardCommands = standard ? [commandFromScript(repoRoot, 'repo standard verification', standard)] : [];
+        const fullCommands = full ? [commandFromScript(repoRoot, 'repo full verification', full)] : [];
+        if (preset === 'quick')
+            return quickCommands;
+        if (preset === 'standard')
+            return [...quickCommands, ...standardCommands];
+        return [...quickCommands, ...standardCommands, ...fullCommands];
+    }
+    catch {
+        return undefined;
+    }
+}
+export const loopAgentAdapter = {
+    name: 'loop-agent',
+    loadHarnessManifest,
+    getContextFilesForStep,
+    getVerifyCommands,
+};

package/dist/adapters/types.js

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