@peterxiaoyang/superspec 0.1.14 → 0.1.16-alpha

package/README.md

@@ -77,17 +77,16 @@ npm install -g @peterxiaoyang/superspec@latest
 进入你的项目根目录，然后运行：
 
 ```bash
-superspec init --scope project
+superspec install
 ```
 
 这条命令的意思是：把 SuperSpec 当前可用的工作流入口安装到项目里。
-
-初始化还会安装托管的 `.codex/hooks.json`。默认 manifest 只在子智能体启动和停止时调用 SuperSpec，记录 best-effort 审计信息；它不会拦截普通文件写入，也不会在测试命令后自动记录结果。
+当前 beta 会安装 `.superspec/` 引擎目录、`.codex/skills/superspec-*` 阶段入口、`.codex/prompts/*.md` 角色 prompt、`.codex/agents/*.toml` 子智能体配置，并补齐 `.codex/config.toml` 的多 agent 开关。`superspec init --scope project` 仍作为兼容别名可用。
 
 Windows PowerShell 如果拦截 npm 的 `.ps1` 脚本，请改用：
 
 ```powershell
-superspec.cmd init --scope project
+superspec.cmd install
 ```
 
 ### 3. 按步骤使用
@@ -136,6 +135,8 @@ superspec.cmd init --scope project
 
 你日常主要记住这五个入口就够了。
 
+CLI 不带 `--risk` 时默认是 `normal`；但内置的 `superspec-explore` 和 `superspec-propose` 技能默认用 `--risk strict` 驱动。探索阶段会创建 `critic` 工作项审查需求澄清记录；计划阶段会创建 `proposal-auditor`、`critic`、`architect` 和 `test-engineer` 工作项后再进入实现准备。
+
 ## 它会多保存哪些记录
 
 SuperSpec 会在每次变更下面保存一些辅助记录，方便后续追溯。
@@ -200,34 +201,24 @@ superspec --version
 安装到当前项目：
 
 ```bash
-superspec init --scope project
+superspec install
 ```
 
-更新当前项目里的 SuperSpec 入口：
+`superspec init --scope project` 是兼容别名，也会执行同一套安装逻辑。
 
-```bash
-superspec update --scope project
-```
-
-这条命令会先通过 npm 更新全局 `@peterxiaoyang/superspec`，再用新版本更新当前项目里的入口文件。只想使用当前已安装包更新项目文件时，可以运行：
+检查当前项目的 OpenSpec 探测结果：
 
 ```bash
-superspec update --scope project --local-only
+superspec status
 ```
 
-卸载当前项目里的 SuperSpec 入口：
+更新当前 beta CLI：
 
 ```bash
-superspec uninstall --scope project
+superspec update
 ```
 
-这些命令默认不会删除已经生成的 `.superspec/` 过程记录。
-
-诊断全局安装、PATH、OpenSpec 依赖和 npm bin 指向问题：
-
-```bash
-superspec doctor
-```
+这条命令只检查当前 `.superspec/changes` 运行时是否已经是新引擎布局；真正升级全局 npm 包仍需使用 `npm install -g @peterxiaoyang/superspec@<version>`。
 
 ## 进阶信息
 
@@ -235,24 +226,35 @@ superspec doctor
 
 ```text
 .codex/
-  hooks.json
   skills/superspec-explore/
   skills/superspec-propose/
   skills/superspec-apply/
   skills/superspec-review/
   skills/superspec-archive/
+  prompts/architect.md
+  prompts/code-reviewer.md
+  prompts/critic.md
+  prompts/executor.md
+  prompts/explore.md
+  prompts/final-audit.md
+  prompts/proposal-auditor.md
+  prompts/test-engineer.md
+  prompts/test-runner.md
+  prompts/verifier.md
+  agents/architect.toml
+  agents/code-reviewer.toml
+  agents/critic.toml
+  agents/executor.toml
+  agents/explore.toml
+  agents/final-audit.toml
+  agents/proposal-auditor.toml
+  agents/test-engineer.toml
+  agents/test-runner.toml
+  agents/verifier.toml
+  config.toml
 ```
 
-SuperSpec 内部还有一些检查命令，例如：
-
-```bash
-superspec check check-init --change <变更ID>
-superspec check check-apply-ready --change <变更ID>
-superspec check check-review-ready --change <变更ID>
-superspec check check-archive-ready --change <变更ID>
-```
-
-普通使用者通常不需要手动运行这些命令；对应的阶段入口会在需要时使用它们。
+当前 beta 的阶段入口由 `superspec transition next --change <变更ID>` 驱动，不再提供旧版 `superspec check ...` surface。
 
 如果你要开发 SuperSpec 本身：
 
@@ -260,14 +262,13 @@ superspec check check-archive-ready --change <变更ID>
 npm run build
 npm run typecheck
 npm test
-npm run pack:dry-run
+npm pack --dry-run
 ```
 
 更多细节见：
 
-- `docs/SPEC.md`：完整设计和规则
-- `docs/DISTRIBUTION.md`：安装、升级、卸载和分发说明
-- `.codex/skills/superspec-*/SKILL.md`：当前 Codex 适配器使用的阶段入口说明
+- `docs/plans/SUPERSPEC_TRANSITION_ENGINE_SPEC_LITE.md`：transition engine 设计
+- `templates/workflow/skills/superspec-*/SKILL.md`：当前 Codex 适配器使用的阶段入口说明
 
 ## 致谢与灵感来源
 

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,301 @@
+#!/usr/bin/env node
+// SuperSpec 流程引擎 — CLI 入口
+import { join } from "node:path";
+import { installProject } from "./install.js";
+import { writeSnapshot } from "./store.js";
+import { rebuildSnapshot } from "./sync.js";
+import { next as nextCmd } from "./next.js";
+import { proposeReady, commitTransition, transitionInit, transitionExplore, startApply, taskStart, taskComplete, reviewReady, accept, archive } from "./transition.js";
+import { recordJobSubmit, recordUserDecision, jobsList, jobsPacket } from "./record.js";
+import { recordTestRun } from "./task.js";
+import { probeOpenSpec, openspecStatus, changeRoot } from "./openspec.js";
+// ===== 参数解析 =====
+function parseArgs(argv) {
+    const [command, subcommand, ...rest] = argv;
+    const opts = {};
+    for (let i = 0; i < rest.length; i++) {
+        if (rest[i].startsWith("--")) {
+            const key = rest[i].slice(2);
+            const val = rest[i + 1] && !rest[i + 1].startsWith("--") ? rest[++i] : "true";
+            opts[key] = val;
+        }
+    }
+    // 如果 subcommand 以 -- 开头，说明没有 subcommand
+    if (subcommand && subcommand.startsWith("--")) {
+        Object.entries(parseFlags([subcommand, ...rest])).forEach(([k, v]) => { opts[k] = v; });
+        return { command, opts };
+    }
+    return { command, subcommand, opts };
+}
+function parseFlags(args) {
+    const opts = {};
+    for (let i = 0; i < args.length; i++) {
+        if (args[i].startsWith("--")) {
+            const key = args[i].slice(2);
+            const val = args[i + 1] && !args[i + 1].startsWith("--") ? args[++i] : "true";
+            opts[key] = val;
+        }
+    }
+    return opts;
+}
+// ===== 初始化 transition init =====
+// ===== init/explore 现在在 transition.ts 中（走统一锁内路径）=====
+// ===== 主分发 =====
+async function main(argv) {
+    // --help / 无参数 → 打印用法
+    if (argv.length === 0 || argv.includes("--help") || argv.includes("-h")) {
+        console.log(`SuperSpec 流程引擎 0.1.16-alpha
+
+用法：superspec <命令> [选项]
+
+命令：
+  status --change <C>              查看状态
+  transition <子命令> --change <C>  状态流转（见下）
+  record <子命令> --change <C>      登记证据（见下）
+  jobs <子命令> --change <C>        工作项管理（见下）
+  install                           安装项目工作流入口
+  init --scope project              install 的兼容别名
+  update                           更新 SuperSpec
+  version                          版本号
+
+transition 子命令：
+  init / explore / sync / next / propose-ready / start-apply
+  task-start --task <T> / task-complete --task <T>
+  review-ready / accept / archive
+
+record 子命令：
+  job-submit --job <J> --report <F>
+  user-decision --input <F>
+  test-run --input <F>
+
+jobs 子命令：
+  list / packet --job <J>
+`);
+        return 0;
+    }
+    // version
+    if (argv[0] === "version" || argv[0] === "--version" || argv[0] === "-v") {
+        console.log("SuperSpec 0.1.16-alpha");
+        return 0;
+    }
+    const { command, subcommand, opts } = parseArgs(argv);
+    const projectRoot = process.cwd();
+    // install / init / update 不需要 --change
+    if (command === "install" || command === "init") {
+        if (command === "init" && opts.scope && opts.scope !== "project") {
+            console.log(JSON.stringify({
+                ok: false,
+                message: "当前 beta 只支持 init --scope project",
+            }));
+            return 1;
+        }
+        try {
+            console.log(JSON.stringify(installProject(projectRoot)));
+            return 0;
+        }
+        catch (err) {
+            console.log(JSON.stringify({
+                ok: false,
+                message: err.message,
+            }));
+            return 1;
+        }
+    }
+    if (command === "update") {
+        // 检测是否从老版 update 过来
+        const { existsSync } = await import("node:fs");
+        const isLegacyUpdate = !existsSync(join(projectRoot, ".superspec", "changes"));
+        if (isLegacyUpdate) {
+            console.log(JSON.stringify({
+                ok: false,
+                message: "SuperSpec 0.1.16-alpha 是全新引擎，不能从 0.x 直接 update。\n" +
+                    "请用 npm install -g @peterxiaoyang/superspec@0.1.16-alpha 手动安装。\n" +
+                    "现有 change 请先用 0.1.x 完成归档。",
+            }));
+            return 1;
+        }
+        console.log(JSON.stringify({ ok: true, message: "已是最新版本 0.1.16-alpha" }));
+        return 0;
+    }
+    const change = opts.change;
+    if (!change && command !== "status") {
+        console.error("错误：缺少 --change（用 --help 查看用法）");
+        return 1;
+    }
+    try {
+        switch (command) {
+            case "status": {
+                if (!change) {
+                    // 全局 status
+                    const probe = probeOpenSpec(projectRoot);
+                    console.log(JSON.stringify({ openspec: probe }, null, 2));
+                    return 0;
+                }
+                const cr = changeRoot(projectRoot, change);
+                const snapshot = rebuildSnapshot(projectRoot, change, cr);
+                const jobs = jobsList(projectRoot, change);
+                console.log(JSON.stringify({
+                    change,
+                    state: snapshot.state,
+                    open_jobs: jobs.open.length,
+                    accepted_jobs: jobs.accepted.length,
+                    rejected_jobs: jobs.rejected.length,
+                    document_digests: snapshot.document_digests,
+                    last_transition: snapshot.last_transition,
+                }, null, 2));
+                return 0;
+            }
+            case "transition": {
+                const cr = changeRoot(projectRoot, change);
+                switch (subcommand) {
+                    case "init":
+                        console.log(JSON.stringify(transitionInit(projectRoot, change, cr), null, 2));
+                        return 0;
+                    case "explore":
+                        {
+                            const risk = opts.risk ?? "normal";
+                            console.log(JSON.stringify(transitionExplore(projectRoot, change, cr, risk), null, 2));
+                        }
+                        return 0;
+                    case "sync": {
+                        const snapshot = rebuildSnapshot(projectRoot, change, cr, openspecStatus(projectRoot, change));
+                        writeSnapshot(projectRoot, change, snapshot);
+                        console.log(JSON.stringify({
+                            ok: true,
+                            state: snapshot.state,
+                            message: "snapshot 已重建",
+                            stale_accepted_removed: 0, // sync 不报告具体移除（轻量）
+                        }, null, 2));
+                        return 0;
+                    }
+                    case "next": {
+                        const risk = opts.risk ?? "normal";
+                        const result = nextCmd(projectRoot, change, cr, risk);
+                        console.log(JSON.stringify(result, null, 2));
+                        return 0;
+                    }
+                    case "propose-ready": {
+                        const risk = opts.risk ?? "normal";
+                        const result = proposeReady(projectRoot, change, cr, risk);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.events_written === 0 && result.message.includes("不能") ? 1 : 0;
+                    }
+                    case "start-apply": {
+                        const result = startApply(projectRoot, change, cr);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.events_written === 0 ? 1 : 0;
+                    }
+                    case "task-start": {
+                        const taskId = opts.task;
+                        if (!taskId) {
+                            console.error("task-start 需要 --task");
+                            return 1;
+                        }
+                        const result = taskStart(projectRoot, change, cr, taskId);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.events_written === 0 ? 1 : 0;
+                    }
+                    case "task-complete": {
+                        const taskId = opts.task;
+                        if (!taskId) {
+                            console.error("task-complete 需要 --task");
+                            return 1;
+                        }
+                        const result = taskComplete(projectRoot, change, cr, taskId);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.events_written === 0 ? 1 : 0;
+                    }
+                    case "review-ready": {
+                        const risk = opts.risk ?? "normal";
+                        const result = reviewReady(projectRoot, change, cr, risk);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.events_written === 0 ? 1 : 0;
+                    }
+                    case "accept": {
+                        const result = accept(projectRoot, change, cr);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.events_written === 0 ? 1 : 0;
+                    }
+                    case "archive": {
+                        const result = archive(projectRoot, change, cr);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.events_written === 0 ? 1 : 0;
+                    }
+                    default:
+                        console.error(`未知的 transition 子命令：${subcommand}`);
+                        return 1;
+                }
+            }
+            case "record": {
+                const cr = changeRoot(projectRoot, change);
+                switch (subcommand) {
+                    case "job-submit": {
+                        const jobId = opts.job;
+                        const report = opts.report;
+                        if (!jobId || !report) {
+                            console.error("record job-submit 需要 --job 和 --report");
+                            return 1;
+                        }
+                        const result = recordJobSubmit(projectRoot, change, cr, jobId, report);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.accepted ? 0 : 1;
+                    }
+                    case "user-decision": {
+                        const inputFile = opts.input;
+                        if (!inputFile) {
+                            console.error("record user-decision 需要 --input");
+                            return 1;
+                        }
+                        const result = recordUserDecision(projectRoot, change, inputFile);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.accepted ? 0 : 1;
+                    }
+                    case "test-run": {
+                        const inputFile = opts.input;
+                        if (!inputFile) {
+                            console.error("record test-run 需要 --input");
+                            return 1;
+                        }
+                        const result = recordTestRun(projectRoot, change, inputFile);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.accepted ? 0 : 1;
+                    }
+                    default:
+                        console.error(`未知的 record 子命令：${subcommand}`);
+                        return 1;
+                }
+            }
+            case "jobs": {
+                switch (subcommand) {
+                    case "list": {
+                        const result = jobsList(projectRoot, change);
+                        console.log(JSON.stringify(result, null, 2));
+                        return 0;
+                    }
+                    case "packet": {
+                        const jobId = opts.job;
+                        if (!jobId) {
+                            console.error("jobs packet 需要 --job");
+                            return 1;
+                        }
+                        const result = jobsPacket(projectRoot, change, jobId);
+                        console.log(JSON.stringify(result, null, 2));
+                        return result.found ? 0 : 1;
+                    }
+                    default:
+                        console.error(`未知的 jobs 子命令：${subcommand}`);
+                        return 1;
+                }
+            }
+            default:
+                console.error(`未知命令：${command}。可用：status, transition, record, jobs, install, init, update, version`);
+                return 1;
+        }
+    }
+    catch (err) {
+        console.error(`错误：${err.message}`);
+        return 2;
+    }
+}
+// 入口
+main(process.argv.slice(2)).then(exitCode => process.exit(exitCode));

package/dist/format.d.ts

@@ -0,0 +1,29 @@
+/** 从 discovery.md 提取"待确认问题"段内的未确认项数量 */
+export declare function countDiscoveryOpenQuestions(content: string): number;
+/** 完整校验 discovery.md：存在 + 非空 + 无未确认问题 */
+export declare function validateDiscovery(changeRoot: string): {
+    ok: boolean;
+    message: string;
+    openCount: number;
+};
+export interface ParsedTask {
+    taskId: string;
+    lineIdx: number;
+    done: boolean;
+    tddRequired: boolean;
+    noTddReason: string | null;
+}
+/** 解析 tasks.md 的全部任务行 */
+export declare function parseTasksMd(content: string): ParsedTask[];
+/** 在 tasks.md 中按 taskId 精确查找任务（词边界，不误判子串） */
+export declare function findTaskInLines(lines: string[], taskId: string): number;
+/** tasks.md 结构指纹（复选框归一化） */
+export declare function tasksStructureDigest(content: string, sha256Text: (s: string) => string): string;
+export declare function validateTestRunInput(tr: Record<string, unknown>): {
+    ok: boolean;
+    message: string;
+};
+export declare function validateUserDecision(d: Record<string, unknown>): {
+    ok: boolean;
+    message: string;
+};

package/dist/format.js

@@ -0,0 +1,141 @@
+// SuperSpec 流程引擎 — format.ts：文档格式解析的唯一权威源
+//
+// 所有文档的格式定义和解析逻辑都在这里。skills 文案引用这里的格式。
+// 修改格式 = 修改这里 + 对应 skill。禁止在其它地方重复解析。
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+// ===== discovery.md =====
+//
+// 格式（explore skill 定义）：
+//   ## 待确认问题
+//   - [ ] 问题1的描述
+//   - [ ] 问题2的描述
+//
+// 引擎只解析"待确认问题"段内的 `- [ ]`，不误判正常 checklist。
+/** 从 discovery.md 提取"待确认问题"段内的未确认项数量 */
+export function countDiscoveryOpenQuestions(content) {
+    // 找"待确认问题"标题（中英文兼容）
+    const sectionMatch = content.match(/^#{1,6}\s*(待确认问题|Open Questions|Pending Questions)\s*$/im);
+    if (!sectionMatch)
+        return 0;
+    const sectionStart = sectionMatch.index + sectionMatch[0].length;
+    // 截取到下一个标题或文件末尾
+    const restContent = content.slice(sectionStart);
+    const nextHeadingMatch = restContent.match(/^#{1,6}\s+/m);
+    const sectionBody = nextHeadingMatch ? restContent.slice(0, nextHeadingMatch.index) : restContent;
+    // 数未确认项
+    const matches = sectionBody.match(/- \[ \]/g);
+    return matches ? matches.length : 0;
+}
+/** 完整校验 discovery.md：存在 + 非空 + 无未确认问题 */
+export function validateDiscovery(changeRoot) {
+    const path = join(changeRoot, ".superspec", "artifacts", "discovery.md");
+    if (!existsSync(path))
+        return { ok: false, message: "discovery.md 不存在", openCount: -1 };
+    const content = readFileSync(path, "utf8");
+    if (!content.trim())
+        return { ok: false, message: "discovery.md 为空", openCount: -1 };
+    const openCount = countDiscoveryOpenQuestions(content);
+    if (openCount > 0)
+        return { ok: false, message: `discovery.md 有 ${openCount} 个未确认问题`, openCount };
+    return { ok: true, message: "discovery.md 就绪", openCount: 0 };
+}
+const TASK_LINE_RE = /^(- \[([ xX])\])\s+(\S+)/;
+/** 解析 tasks.md 的全部任务行 */
+export function parseTasksMd(content) {
+    const lines = content.split("\n");
+    const tasks = [];
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(TASK_LINE_RE);
+        if (!m)
+            continue;
+        const taskId = m[3];
+        const done = m[2].toLowerCase() === "x";
+        // 用正则锚定字段边界，不依赖 includes()
+        const tddMatch = lines[i].match(/\btdd_required:(true|false)\b/);
+        const reasonMatch = lines[i].match(/\bno_tdd_reason:(\S+)\b/);
+        tasks.push({
+            taskId,
+            lineIdx: i,
+            done,
+            tddRequired: tddMatch ? tddMatch[1] === "true" : true, // 默认 true
+            noTddReason: reasonMatch ? reasonMatch[1] : null,
+        });
+    }
+    return tasks;
+}
+/** 在 tasks.md 中按 taskId 精确查找任务（词边界，不误判子串） */
+export function findTaskInLines(lines, taskId) {
+    for (let i = 0; i < lines.length; i++) {
+        // 精确匹配行内的 taskId token
+        const m = lines[i].match(TASK_LINE_RE);
+        if (m && m[3] === taskId)
+            return i;
+        // 回退：用转义正则匹配（兼容 taskId 后跟标点的情况）
+        const escaped = taskId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        if (new RegExp("(?:^|\\s)" + escaped + "(?:\\s|$|[.,:;!?)\\]])").test(lines[i]))
+            return i;
+    }
+    return -1;
+}
+/** tasks.md 结构指纹（复选框归一化） */
+export function tasksStructureDigest(content, sha256Text) {
+    return sha256Text(content.replace(/- \[[xX]\]/g, "- [ ]"));
+}
+// ===== test-run JSON =====
+//
+// 格式（apply skill 定义）：
+//   {
+//     "test_id": "TEST-XXX",
+//     "attempt_id": "ATT-TASK-XXX-...",
+//     "task_structure_digest": "sha256:...",
+//     "command": "npm test",
+//     "cwd": "/path",
+//     "exit_code": 1,
+//     "semantic_status": "expected_failure",
+//     "target_fingerprint": "sha256:..."
+//   }
+//
+// 引擎校验：test_id + task_structure_digest 必填，其余可选
+export function validateTestRunInput(tr) {
+    if (!tr.test_id)
+        return { ok: false, message: "缺少 test_id" };
+    if (!tr.task_structure_digest)
+        return { ok: false, message: "缺少 task_structure_digest" };
+    return { ok: true, message: "" };
+}
+// ===== user-decision JSON =====
+//
+// 格式（explore skill 定义）：
+//   {
+//     "scope": "enter_propose",
+//     "question": "是否进入计划阶段？",
+//     "answer": "yes"
+//   }
+//
+// 引擎校验：scope + answer 必填
+export function validateUserDecision(d) {
+    if (!d.scope)
+        return { ok: false, message: "决策文件缺少 scope" };
+    if (!d.answer)
+        return { ok: false, message: "决策文件缺少 answer" };
+    return { ok: true, message: "" };
+}
+// ===== business-invariants.md =====
+//
+// 格式（propose skill 定义）：
+//   # Business Invariants
+//   - INV-001 用户密码必须加密存储
+//
+// 引擎行为：Phase 1-5 只校验文件存在性（轻量）。
+// 内部结构（INV-XXX 编号）是 agent 指引，引擎不逐行解析。
+// ===== test-contract.md =====
+//
+// 格式（propose skill 定义）：
+//   # Test Contract
+//   | test_id | invariant | scenario |
+//   |---|---|---|
+//   | TEST-001 | INV-001 | 注册时密码被加密 |
+//
+// 引擎行为：Phase 1-5 只校验文件存在性（轻量）。
+// 表格结构是 agent 指引，引擎不逐行解析。

package/dist/install.d.ts

@@ -0,0 +1,18 @@
+export declare const WORKFLOW_SKILLS: readonly ["superspec-explore", "superspec-propose", "superspec-apply", "superspec-review", "superspec-archive"];
+export declare const WORKFLOW_PROMPTS: readonly ["architect.md", "code-reviewer.md", "critic.md", "executor.md", "explore.md", "final-audit.md", "proposal-auditor.md", "test-engineer.md", "test-runner.md", "verifier.md"];
+export declare const WORKFLOW_AGENTS: readonly ["architect.toml", "code-reviewer.toml", "critic.toml", "executor.toml", "explore.toml", "final-audit.toml", "proposal-auditor.toml", "test-engineer.toml", "test-runner.toml", "verifier.toml"];
+export interface InstallResult {
+    ok: boolean;
+    message: string;
+    installed: {
+        engine_dir: string;
+        skills: string[];
+        prompts: string[];
+        agents: string[];
+        config: string;
+    };
+}
+export interface InstallOptions {
+    templateRoot?: string;
+}
+export declare function installProject(projectRoot: string, options?: InstallOptions): InstallResult;