@devcxl/opencode-cabbage 0.3.1 → 1.0.0

package/dist/kernel/setup.js

@@ -0,0 +1,324 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { readdir, access, constants, readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { readProjectProfile, upsertProjectProfile } from "./profile.js";
+import { KeyedMutex } from "./mutex.js";
+import { escapeShellArg } from "../util/shell.js";
+const execAsync = promisify(exec);
+let setupGitExecutor = null;
+let setupGhExecutor = null;
+export function setSetupGitExecutor(fn) {
+    setupGitExecutor = fn;
+}
+export function setSetupGhExecutor(fn) {
+    setupGhExecutor = fn;
+}
+async function runGit(args, cwd) {
+    if (setupGitExecutor)
+        return setupGitExecutor(args, cwd);
+    return execAsync(`git ${args}`, { cwd });
+}
+async function runGh(args) {
+    if (setupGhExecutor)
+        return setupGhExecutor(args);
+    return execAsync(`gh ${args}`, {});
+}
+/**
+ * 探测项目 setup 就绪度（PRD R10）。
+ * development-ready：git/gh + Profile 确认 + TDD 命令可执行 + CI workflow + 分支保护；
+ * release-ready：额外版本规则 + release workflow。
+ */
+export async function probe(projectDir) {
+    const gitAvailable = await tryRun(() => runGit("--version", projectDir));
+    const ghAuthenticated = await tryRun(() => runGh("auth status"));
+    let remoteUrl = null;
+    try {
+        const { stdout } = await runGit("remote get-url origin", projectDir);
+        remoteUrl = stdout.trim() || null;
+    }
+    catch {
+        remoteUrl = null;
+    }
+    const hasRemote = remoteUrl !== null;
+    let defaultBranch = null;
+    try {
+        const { stdout } = await runGit("symbolic-ref --short refs/remotes/origin/HEAD", projectDir);
+        defaultBranch = stdout.trim() || null;
+    }
+    catch {
+        defaultBranch = null;
+    }
+    const profile = await readProjectProfile(projectDir);
+    const profileConfirmed = profile.testCommand !== null;
+    const versionRuleConfirmed = profile.versionBumpRule !== null && profile.versionFile !== null && profile.tagFormat !== null;
+    const tddCommandExecutable = await isCommandExecutable(profile.testCommand);
+    const { ci, release } = await scanWorkflows(projectDir, profile.releaseWorkflowPath);
+    const contextMdPresent = await fileExists(join(projectDir, "CONTEXT.md"));
+    let branchProtection = false;
+    const ownerRepo = remoteUrl ? parseGithubRemote(remoteUrl) : null;
+    if (ownerRepo && defaultBranch) {
+        branchProtection = await tryRun(() => runGh(`api repos/${ownerRepo.owner}/${ownerRepo.repo}/branches/${defaultBranch}/protection`));
+    }
+    const developmentReady = gitAvailable && ghAuthenticated && profileConfirmed && tddCommandExecutable && ci !== null && branchProtection;
+    const releaseReady = developmentReady && versionRuleConfirmed && release !== null;
+    return {
+        gitAvailable,
+        ghAuthenticated,
+        hasRemote,
+        defaultBranch,
+        profileConfirmed,
+        tddCommandExecutable,
+        ciWorkflow: ci,
+        releaseWorkflow: release,
+        contextMdPresent,
+        branchProtection,
+        versionRuleConfirmed,
+        developmentReady,
+        releaseReady,
+    };
+}
+/** 从 git remote URL 解析 GitHub owner/repo；非 GitHub 仓库返回 null */
+export function parseGithubRemote(url) {
+    const patterns = [
+        /^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/,
+        /^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/,
+        /^ssh:\/\/git@github\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/,
+    ];
+    for (const pattern of patterns) {
+        const match = pattern.exec(url);
+        if (match)
+            return { owner: match[1], repo: match[2] };
+    }
+    return null;
+}
+/** 扫描 .github/workflows/：文件名含 ci → CI workflow；含 release 或 Profile 指定路径 → release workflow */
+async function scanWorkflows(projectDir, profileReleasePath) {
+    const workflowsDir = join(projectDir, ".github", "workflows");
+    let files = [];
+    try {
+        files = (await readdir(workflowsDir)).filter(f => f.endsWith(".yml") || f.endsWith(".yaml"));
+    }
+    catch {
+        files = [];
+    }
+    let ci = null;
+    let release = null;
+    for (const file of files) {
+        const lower = file.toLowerCase();
+        if (ci === null && lower.includes("ci"))
+            ci = `.github/workflows/${file}`;
+        if (release === null && lower.includes("release"))
+            release = `.github/workflows/${file}`;
+    }
+    if (profileReleasePath && (await fileExists(join(projectDir, profileReleasePath)))) {
+        release = profileReleasePath;
+    }
+    return { ci, release };
+}
+/** TDD 命令可执行：首个 token 存在于 PATH（相对路径则直接检查可执行） */
+async function isCommandExecutable(testCommand) {
+    if (!testCommand)
+        return false;
+    const firstToken = testCommand.trim().split(/\s+/)[0];
+    if (!firstToken)
+        return false;
+    const candidates = firstToken.includes("/")
+        ? [firstToken]
+        : (process.env.PATH ?? "").split(":").filter(Boolean).map(dir => join(dir, firstToken));
+    for (const candidate of candidates) {
+        if (await isExecutable(candidate))
+            return true;
+    }
+    return false;
+}
+async function isExecutable(path) {
+    try {
+        await access(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function tryRun(fn) {
+    try {
+        await fn();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ─── generate-workflows：缺失时生成 CI/release 草案 + Setup PR ───
+const SETUP_WORKFLOWS_BRANCH = "chore/setup-workflows";
+/**
+ * 缺失时生成 CI/release workflow 草案（技术栈无关，不硬编码包管理器），
+ * 创建 chore/setup-workflows 分支 + commit + push + Setup PR（人工合入）。
+ */
+export async function generateWorkflows(projectDir, input) {
+    const profile = await readProjectProfile(projectDir);
+    const testCommand = input.testCommand ?? profile.testCommand;
+    const tagFormat = input.tagFormat ?? profile.tagFormat;
+    const releaseWorkflowPath = input.releaseWorkflowPath ?? profile.releaseWorkflowPath;
+    let defaultBranch = input.defaultBranch ?? null;
+    if (!defaultBranch) {
+        try {
+            const { stdout } = await runGit("symbolic-ref --short refs/remotes/origin/HEAD", projectDir);
+            defaultBranch = stdout.trim() || null;
+        }
+        catch {
+            defaultBranch = null;
+        }
+    }
+    const workflowsDir = join(projectDir, ".github", "workflows");
+    await mkdir(workflowsDir, { recursive: true });
+    const { ci, release } = await scanWorkflows(projectDir, releaseWorkflowPath);
+    const created = [];
+    const existing = [];
+    if (ci === null) {
+        await writeFile(join(workflowsDir, "ci.yml"), buildCiWorkflow(testCommand, defaultBranch));
+        created.push(".github/workflows/ci.yml");
+    }
+    else {
+        existing.push(ci);
+    }
+    if (release === null) {
+        const fileName = releaseWorkflowPath ? basename(releaseWorkflowPath) : "release.yml";
+        await writeFile(join(workflowsDir, fileName), buildReleaseWorkflow(tagFormat));
+        created.push(`.github/workflows/${fileName}`);
+    }
+    else {
+        existing.push(release);
+    }
+    if (created.length === 0) {
+        return { ok: true, created, existing, branch: null, prNumber: null };
+    }
+    try {
+        const prTitle = input.prTitle || "chore: add CI/release workflow drafts";
+        const prBody = `Setup generated workflow drafts for manual review:\n\n${created.map(f => `- ${f}`).join("\n")}`;
+        await runGit(`checkout -b ${SETUP_WORKFLOWS_BRANCH}`, projectDir);
+        await runGit("add .github/workflows", projectDir);
+        await runGit(`commit -m ${shellQuote(prTitle)}`, projectDir);
+        await runGit(`push -u origin ${SETUP_WORKFLOWS_BRANCH}`, projectDir);
+        const { stdout } = await runGh(`pr create --title ${shellQuote(prTitle)} --body ${shellQuote(prBody)} --base ${defaultBranch ?? "main"} --head ${SETUP_WORKFLOWS_BRANCH} --json number --jq .number`);
+        return {
+            ok: true,
+            created,
+            existing,
+            branch: SETUP_WORKFLOWS_BRANCH,
+            prNumber: Number(stdout.trim()) || null,
+        };
+    }
+    catch (err) {
+        return { ok: false, created, existing, branch: null, prNumber: null, error: String(err) };
+    }
+}
+/** CI workflow 草案：PR check 触发，运行 Profile 的测试命令（无则占位） */
+export function buildCiWorkflow(testCommand, defaultBranch) {
+    const command = testCommand ?? "<test-command>";
+    const branch = defaultBranch ?? "**";
+    return [
+        "name: CI",
+        "",
+        "on:",
+        "  pull_request:",
+        "    branches:",
+        `      - '${branch}'`,
+        "",
+        "jobs:",
+        "  check:",
+        "    runs-on: ubuntu-latest",
+        "    steps:",
+        "      - uses: actions/checkout@v4",
+        `      - run: ${command}`,
+        "",
+    ].join("\n");
+}
+/** release workflow 草案：tag 触发，技术栈无关占位步骤 */
+export function buildReleaseWorkflow(tagFormat) {
+    const tag = tagFormat ?? "v*";
+    return [
+        "name: Release",
+        "",
+        "on:",
+        "  push:",
+        "    tags:",
+        `      - '${tag}'`,
+        "",
+        "jobs:",
+        "  release:",
+        "    runs-on: ubuntu-latest",
+        "    steps:",
+        "      - uses: actions/checkout@v4",
+        "      - run: echo \"Define project-specific release steps here (version bump + artifact publish)\"",
+        "",
+    ].join("\n");
+}
+function shellQuote(value) {
+    return `'${escapeShellArg(value)}'`;
+}
+const profileMutex = new KeyedMutex();
+/** overrides JSON 键 → Profile 区块行键（§9.1 顺序） */
+const PROFILE_KEY_ORDER = [
+    { jsonKey: "testCommand", sectionKey: "test command" },
+    { jsonKey: "regressionCommand", sectionKey: "regression command" },
+    { jsonKey: "testFilePatterns", sectionKey: "test file patterns" },
+    { jsonKey: "implementationFilePatterns", sectionKey: "implementation file patterns" },
+    { jsonKey: "tddDefaultMode", sectionKey: "tdd default mode" },
+    { jsonKey: "versionBumpRule", sectionKey: "version bump rule" },
+    { jsonKey: "versionFile", sectionKey: "version file" },
+    { jsonKey: "tagFormat", sectionKey: "tag format" },
+    { jsonKey: "releaseWorkflowPath", sectionKey: "release workflow" },
+    { jsonKey: "riskPatterns", sectionKey: "risk patterns" },
+];
+/** 由用户确认的 overrides 生成完整 `## Project Profile` 区块（未提供的键省略） */
+export function buildProfileBlock(overrides) {
+    const lines = ["## Project Profile", ""];
+    for (const { jsonKey, sectionKey } of PROFILE_KEY_ORDER) {
+        const value = overrides[jsonKey];
+        if (value === undefined || value === null)
+            continue;
+        const formatted = Array.isArray(value) ? value.join(", ") : String(value);
+        if (formatted === "")
+            continue;
+        lines.push(`- ${sectionKey}: \`${formatted}\``);
+    }
+    return lines.join("\n");
+}
+/**
+ * 用户确认后把 Profile 区块写回根 AGENTS.md（§9.3）。
+ * 先读后写，按 key 串行（mutex）；testCommand 为必需键。
+ */
+export async function confirmProjectProfile(projectDir, overridesJson) {
+    let overrides;
+    try {
+        overrides = JSON.parse(overridesJson);
+    }
+    catch {
+        return { ok: false, code: "POLICY_INVALID", message: "profile_overrides is not valid JSON" };
+    }
+    if (typeof overrides !== "object" || overrides === null || Array.isArray(overrides)) {
+        return { ok: false, code: "POLICY_INVALID", message: "profile_overrides must be a JSON object" };
+    }
+    if (typeof overrides.testCommand !== "string" || overrides.testCommand.trim() === "") {
+        return { ok: false, code: "POLICY_INVALID", message: "testCommand is required to confirm the profile" };
+    }
+    const block = buildProfileBlock(overrides);
+    const agentsPath = join(projectDir, "AGENTS.md");
+    await profileMutex.runExclusive("agents-md", async () => {
+        const markdown = await readFile(agentsPath, "utf8").catch(() => "");
+        await writeFile(agentsPath, upsertProjectProfile(markdown, block));
+    });
+    return { ok: true, block };
+}
+//# sourceMappingURL=setup.js.map

package/dist/kernel/setup.js.map

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

package/dist/kernel/slug.d.ts

@@ -0,0 +1,23 @@
+export declare const MAX_SLUG_LENGTH = 60;
+export type BranchType = "feat" | "fix" | "chore" | "docs";
+export type SlugValidationResult = {
+    ok: true;
+    slug: string;
+} | {
+    ok: false;
+    code: "EMPTY_TITLE" | "INVALID_FORMAT" | "SLUG_TOO_LONG" | "GENERIC_TITLE";
+    message: string;
+};
+/**
+ * 严格 slug 派生：沿用 util/paths.ts slugify 的归一化规则，
+ * 但不做 "doc" 兜底——无意义输入返回空串，由调用方判定。
+ */
+export declare function deriveSlug(value: string): string;
+/**
+ * 校验功能标题（须已是 kebab-case slug）：
+ * - 空标题、非法字符（大写/下划线/空格/连续连字符/首尾连字符）、过长（>60）→ 格式拒绝
+ * - 纯序号或全部由泛化词组成（task-001、implement-task、fix-bug）→ GENERIC_TITLE
+ */
+export declare function validateTitle(title: string): SlugValidationResult;
+export declare function branchFor(slug: string, type: BranchType): string;
+export declare function worktreeFor(slug: string): string;

package/dist/kernel/slug.js

@@ -0,0 +1,67 @@
+export const MAX_SLUG_LENGTH = 60;
+/** 合法 slug：小写字母/数字分段，段间单个连字符 */
+const SLUG_FORMAT = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/** 泛化/占位词：与数字或其他泛化词组合时无法表达具体功能 */
+const GENERIC_WORDS = new Set([
+    "add", "bug", "bugs", "chore", "create", "delete", "docs", "feature",
+    "features", "fix", "fixes", "implement", "issue", "issues", "refactor",
+    "remove", "support", "task", "tasks", "test", "tests", "update", "wip",
+]);
+/**
+ * 严格 slug 派生：沿用 util/paths.ts slugify 的归一化规则，
+ * 但不做 "doc" 兜底——无意义输入返回空串，由调用方判定。
+ */
+export function deriveSlug(value) {
+    let slug = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/--+/g, "-");
+    if (slug.length > MAX_SLUG_LENGTH) {
+        const sliced = slug.slice(0, MAX_SLUG_LENGTH);
+        const lastDash = sliced.lastIndexOf("-");
+        slug = lastDash > MAX_SLUG_LENGTH / 2 ? sliced.slice(0, lastDash) : sliced;
+    }
+    return slug;
+}
+/**
+ * 校验功能标题（须已是 kebab-case slug）：
+ * - 空标题、非法字符（大写/下划线/空格/连续连字符/首尾连字符）、过长（>60）→ 格式拒绝
+ * - 纯序号或全部由泛化词组成（task-001、implement-task、fix-bug）→ GENERIC_TITLE
+ */
+export function validateTitle(title) {
+    if (title.trim() === "") {
+        return { ok: false, code: "EMPTY_TITLE", message: "Title must not be empty" };
+    }
+    if (title.length > MAX_SLUG_LENGTH) {
+        return { ok: false, code: "SLUG_TOO_LONG", message: `Title must be at most ${MAX_SLUG_LENGTH} characters` };
+    }
+    if (!SLUG_FORMAT.test(title)) {
+        return {
+            ok: false,
+            code: "INVALID_FORMAT",
+            message: "Title must be a kebab-case slug: lowercase letters, digits, and single hyphens between segments",
+        };
+    }
+    if (isGenericSlug(title)) {
+        return {
+            ok: false,
+            code: "GENERIC_TITLE",
+            message: "Title is too generic: use a functional slug that describes the concrete behavior",
+        };
+    }
+    return { ok: true, slug: title };
+}
+/** 纯序号，或所有分段均为泛化词/数字 → 无法描述具体功能 */
+function isGenericSlug(slug) {
+    const segments = slug.split("-");
+    return segments.every(seg => /^\d+$/.test(seg) || GENERIC_WORDS.has(seg));
+}
+export function branchFor(slug, type) {
+    return `${type}/${slug}`;
+}
+export function worktreeFor(slug) {
+    return `.worktree/${slug}`;
+}
+//# sourceMappingURL=slug.js.map

package/dist/kernel/slug.js.map

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

package/dist/kernel/task.d.ts

@@ -0,0 +1,208 @@
+import { type ProjectProfile } from "./profile.js";
+import { type WorkspaceBaseline } from "./tdd/evidence.js";
+import type { AcceptanceCriterion, TaskRecordRef, TddEvidence, TddPolicy } from "./types.js";
+/** Task Record 状态标签前缀：cabbage:task:<status> */
+export declare const TASK_STATUS_LABEL_PREFIX = "cabbage:task:";
+/** Task 状态标签取值 */
+export type TaskStatus = "running" | "reviewing" | "merged" | "cancelled";
+/** 默认最大并行 Task 数（PRD R7，Profile 可覆盖但内核按此判定） */
+export declare const MAX_PARALLEL_TASKS = 5;
+/** 内核内置风险 pattern（spec §12 #12：migrations/auth/permissions/release workflow/密钥/公共 API），与 Profile riskPatterns 合并 */
+export declare const BUILTIN_RISK_PATTERNS: string[];
+export type CmdResult = {
+    stdout: string;
+    stderr: string;
+};
+export type CmdFn = (args: string) => Promise<CmdResult>;
+export declare function setTaskGhExecutor(fn: CmdFn | null): void;
+export declare function setTaskGitExecutor(fn: CmdFn | null): void;
+export declare function taskGh(args: string, timeout?: number): Promise<CmdResult>;
+export declare function taskGit(args: string): Promise<CmdResult>;
+/**
+ * 新建 Task Record 的 body：acceptance criteria + 依赖 + 状态 checklist + Closes 约定。
+ * criteria 渲染为 `- [ ] <id>: <description> [<verification>]`，可被 parseCriteriaFromBody 还原。
+ */
+export declare function buildTaskBody(slug: string, criteria: AcceptanceCriterion[], dependencies: number[]): string;
+/** TDD 跨批协议：Task Record body 内 TDD 上下文块 marker（tdd_checkpoint 工具解析；spec §2.3/§4） */
+export declare const TASK_TDD_TAG = "<!-- cabbage-task-tdd -->";
+/** 构造 TDD 上下文块 JSON（policy + criteria + worktreeDir），供 tdd_checkpoint resolveTaskContext 解析 */
+export declare function buildTaskTddBlock(policy: TddPolicy, criteria: AcceptanceCriterion[], worktreePath: string): string;
+/** 解析 create-task 传入的 acceptance_criteria JSON（字符串数组 → AcceptanceCriterion[]）；非法返回 null */
+export declare function parseAcceptanceCriteria(json: string): AcceptanceCriterion[] | null;
+/** 从 Task Record body 还原 acceptance criteria（buildTaskBody 的逆操作） */
+export declare function parseCriteriaFromBody(body: string): AcceptanceCriterion[];
+/** 从 Task Record body 的 Dependencies 区块解析依赖 Issue 号 */
+export declare function parseDependenciesFromBody(body: string): number[];
+/** 解析 create-task 的 depends_on 参数："12, 13" 或 "#12,#13" → [12, 13]；空/非法输入返回 [] */
+export declare function parseDependenciesArg(raw: string | undefined): number[];
+/** 从 Project Profile 冻结 TDD policy：enforcement 固定 runtime（PRD R6 行为变更强制 Runtime TDD） */
+export declare function freezeTddPolicy(profile: ProjectProfile): TddPolicy;
+/** 轻量 glob 匹配（支持 **、*、?），风险 pattern 匹配专用 */
+export declare function matchRiskPattern(filePath: string, pattern: string): boolean;
+/**
+ * 风险双层判定：模型初判 + 内核按实际 diff 升级，只升不降（PRD R8 / spec §12 #12）。
+ * modelRisk 为 high → high；否则 diff 命中任一 risk pattern → high；否则 low。
+ */
+export declare function escalateRisk(modelRisk: "low" | "high", changedFiles: string[], riskPatterns: string[]): "low" | "high";
+export interface ParsedEvidenceBlock {
+    stage: string;
+    fields: Record<string, string>;
+}
+/** 解析受控 evidence comment 为结构化 blocks；无 marker 或畸形返回 null */
+export declare function parseEvidenceComment(body: string): ParsedEvidenceBlock[] | null;
+/** 把受控 comment 还原为 TddEvidence（供 evaluateTddCompliance 判定）；无 marker 返回 null */
+export declare function evidenceCommentToTddEvidence(comment: {
+    id: number;
+    body: string;
+    revision: number;
+}): TddEvidence | null;
+export interface TaskRuntimeState {
+    slug: string;
+    parentIssueNumber: number;
+    issueNumber: number;
+    branch: string;
+    worktreePath: string;
+    policy: TddPolicy;
+    baseline: WorkspaceBaseline;
+    startedAt: string;
+}
+export declare function taskStatePath(projectDir: string, slug: string): string;
+export declare function writeTaskState(projectDir: string, state: TaskRuntimeState): Promise<void>;
+export declare function readTaskState(projectDir: string, slug: string): Promise<TaskRuntimeState | null>;
+/** 设置 Task Record 状态标签（移除其它 cabbage:task:*，添加当前） */
+export declare function setTaskStatusLabel(issueNumber: number, status: TaskStatus): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export interface CreateTaskInput {
+    projectDir: string;
+    parentIssueNumber: number;
+    title: string;
+    acceptanceCriteriaJson?: string;
+    dependencies?: number[];
+}
+export type CreateTaskResult = {
+    ok: true;
+    ref: TaskRecordRef;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+/**
+ * create-task（spec §2.3）：validateTitle → slug → 未完成同名冲突检查（branch/worktree 已存在）→
+ * createTaskRecord（Sub Issue，body 含 acceptance criteria、依赖、Closes 约定）关联 Parent。
+ */
+export declare function createTask(input: CreateTaskInput): Promise<CreateTaskResult>;
+export type StartTaskResult = {
+    ok: true;
+    issueNumber: number;
+    branch: string;
+    worktreePath: string;
+    policy: TddPolicy;
+    baseline: WorkspaceBaseline;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+/**
+ * start-task（spec §2.3）：前置门禁（Planning Baseline 已合并、依赖 Task 已 merged、并行数 <5）→
+ * worktree-start → captureWorkspaceBaseline → freezeTddPolicy → 写 Task Record 状态。
+ */
+export declare function startTask(projectDir: string, parentIssueNumber: number, taskId: string): Promise<StartTaskResult>;
+export type SubmitTaskResult = {
+    ok: true;
+    prNumber: number;
+    evidenceRevision: number;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+    missing?: string[];
+};
+/**
+ * submit-task（spec §4.4）：TDD 硬门禁——evidence 不完整（无 comment、regression 未 pass、
+ * compliance 未 pass）→ 拒绝创建 PR；通过后 push 分支 → gh pr create（body 引用 Task Record +
+ * evidence comment 链接，含 Closes 约定）→ 标记 reviewing。
+ */
+export declare function submitTask(projectDir: string, parentIssueNumber: number, taskId: string): Promise<SubmitTaskResult>;
+export type SubmitReviewResult = {
+    ok: true;
+    prNumber: number;
+    verdict: "approve" | "request-changes";
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+/** submit-review（spec §2.3）：primary 提交 reviewer 双轴审查结果（reviewer 本身只读） */
+export declare function submitReview(prNumber: number, verdict: "approve" | "request-changes", comment?: string): Promise<SubmitReviewResult>;
+export type MergeTaskResult = {
+    ok: true;
+    prNumber: number;
+    risk: "low" | "high";
+    warning?: string;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+/**
+ * merge-task（spec §2.3 + PRD R8）：CI checks 通过 + 分支保护 + 风险双层判定（只升不降）+
+ * 高风险需非作者人类 approval → mergeTaskPR（--match-head-commit）→ 关闭 Sub Issue →
+ * worktree 干净销毁。
+ */
+export declare function mergeTask(projectDir: string, parentIssueNumber: number, taskId: string, modelRisk: "low" | "high"): Promise<MergeTaskResult>;
+/** 将原始 statusCheckRollup 映射为 {name, state}（纯函数，供测试直接验证 jq 语义） */
+export declare function mapCheckRollup(raw: unknown[]): Array<{
+    name: string;
+    state: string;
+}>;
+export type TaskLifecycleResult = {
+    ok: true;
+    issueNumber: number;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+export type DestroyTaskWorktreeResult = {
+    ok: true;
+    reason: string;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+export interface TaskStatusReport {
+    task: {
+        issueNumber: number;
+        slug: string;
+        state: string;
+        labels: string[];
+    };
+    pullRequests: Array<{
+        number: number;
+        state: string;
+        headRefName: string;
+        checks: Array<{
+            name: string;
+            state: string;
+        }>;
+    }>;
+}
+export type TaskStatusResult = {
+    ok: true;
+    report: TaskStatusReport;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+/** cancel-task：受控取消（user_confirmed）→ 关闭 Sub Issue + 状态标签 cancelled */
+export declare function cancelTask(projectDir: string, parentIssueNumber: number, taskId: string, userConfirmed: boolean): Promise<TaskLifecycleResult>;
+/** destroy-worktree：preflight 销毁（§3.3），需 user_confirmed（除非 PR 已合并且干净） */
+export declare function destroyTaskWorktree(projectDir: string, parentIssueNumber: number, taskId: string, userConfirmed: boolean): Promise<DestroyTaskWorktreeResult>;
+/** status-task：读 Task Record + PR + checks 汇总 */
+export declare function readTaskStatus(projectDir: string, parentIssueNumber: number, taskId: string): Promise<TaskStatusResult>;