@devcxl/opencode-cabbage 0.3.2 → 1.1.0

package/dist/kernel/legacy.d.ts

@@ -0,0 +1,19 @@
+/** 旧 FlowRun cabinet 标记（flowrun/types.ts 同款） */
+export declare const CABINET_START_MARKER = "<!-- cabbage-flow-run:start -->";
+export declare const CABINET_END_MARKER = "<!-- cabbage-flow-run:end -->";
+export type LegacyFlowDetection = {
+    legacy: true;
+    flowRunId?: string;
+} | {
+    legacy: false;
+};
+/** Issue body 同时含 start/end 标记 → 判定为旧架构 FlowRun（不自动迁移） */
+export declare function containsLegacyMarker(body: string): boolean;
+/**
+ * 检测指定 Issue 是否为旧架构 FlowRun。
+ * @param ghFn gh 执行器（测试可注入；默认宿主 gh CLI）
+ */
+export declare function detectLegacyFlowRun(parentIssueNumber: number, ghFn?: (args: string) => Promise<{
+    stdout: string;
+    stderr: string;
+}>): Promise<LegacyFlowDetection>;

package/dist/kernel/legacy.js

@@ -0,0 +1,34 @@
+/**
+ * 旧 FlowRun 检测（spec §11.2，自 flowrun/github.ts 只读部分迁移）。
+ * 不迁移、不读取旧状态——只判断 Issue body 是否仍是旧架构的 FlowRun cabinet。
+ */
+import { gh as ghCli } from "../util/gh.js";
+/** 旧 FlowRun cabinet 标记（flowrun/types.ts 同款） */
+export const CABINET_START_MARKER = "<!-- cabbage-flow-run:start -->";
+export const CABINET_END_MARKER = "<!-- cabbage-flow-run:end -->";
+/** Issue body 同时含 start/end 标记 → 判定为旧架构 FlowRun（不自动迁移） */
+export function containsLegacyMarker(body) {
+    return body.includes(CABINET_START_MARKER) && body.includes(CABINET_END_MARKER);
+}
+/** 从 cabinet JSON 块提取 flowRunId；缺失返回 null */
+function extractFlowRunId(body) {
+    const match = /"flowRunId"\s*:\s*"([^"]+)"/.exec(body);
+    return match ? match[1] : null;
+}
+/**
+ * 检测指定 Issue 是否为旧架构 FlowRun。
+ * @param ghFn gh 执行器（测试可注入；默认宿主 gh CLI）
+ */
+export async function detectLegacyFlowRun(parentIssueNumber, ghFn = ghCli) {
+    try {
+        const { stdout } = await ghFn(`issue view ${parentIssueNumber} --json body --jq .body`);
+        if (!containsLegacyMarker(stdout))
+            return { legacy: false };
+        const flowRunId = extractFlowRunId(stdout);
+        return flowRunId ? { legacy: true, flowRunId } : { legacy: true };
+    }
+    catch {
+        return { legacy: false };
+    }
+}
+//# sourceMappingURL=legacy.js.map

package/dist/kernel/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../src/kernel/legacy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,EAAE,IAAI,KAAK,EAAE,MAAM,eAAe,CAAA;AAE3C,gDAAgD;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,iCAAiC,CAAA;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,+BAA+B,CAAA;AAIjE,0DAA0D;AAC1D,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;AACjF,CAAC;AAED,6CAA6C;AAC7C,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,iBAAyB,EACzB,OAAsE,KAAK;IAE3E,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,iBAAiB,yBAAyB,CAAC,CAAA;QACvF,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;QAC3D,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAC1C,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC1B,CAAC;AACH,CAAC"}

package/dist/kernel/mutex.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 按 key 隔离的互斥锁，用于单进程内串行化并发操作。
+ * 相同 key 的操作依次执行，不同 key 的操作可并行。
+ */
+export declare class KeyedMutex {
+    private locks;
+    runExclusive<T>(key: string | number, fn: () => Promise<T>): Promise<T>;
+}

package/dist/kernel/mutex.js

@@ -0,0 +1,23 @@
+/**
+ * 按 key 隔离的互斥锁，用于单进程内串行化并发操作。
+ * 相同 key 的操作依次执行，不同 key 的操作可并行。
+ */
+export class KeyedMutex {
+    locks = new Map();
+    async runExclusive(key, fn) {
+        const prev = this.locks.get(key) ?? Promise.resolve();
+        let release;
+        const next = new Promise(r => {
+            release = r;
+        });
+        this.locks.set(key, next);
+        await prev;
+        try {
+            return await fn();
+        }
+        finally {
+            release();
+        }
+    }
+}
+//# sourceMappingURL=mutex.js.map

package/dist/kernel/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../src/kernel/mutex.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACb,KAAK,GAAG,IAAI,GAAG,EAAkC,CAAA;IAEzD,KAAK,CAAC,YAAY,CAAI,GAAoB,EAAE,EAAoB;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;QACrD,IAAI,OAAmB,CAAA;QACvB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE;YACjC,OAAO,GAAG,CAAC,CAAA;QACb,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAEzB,MAAM,IAAI,CAAA;QACV,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;gBAAS,CAAC;YACT,OAAQ,EAAE,CAAA;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/kernel/permission.d.ts

@@ -0,0 +1,21 @@
+/**
+ * OpenCode permission 匹配纯函数（spec §7.2）。
+ *
+ * 语义与 OpenCode 当前实现对齐：
+ * - bash 模式规则：pattern 支持 `*` 通配（`*` 兜底、`cmd*` 前缀匹配）
+ * - 最后匹配优先：后声明的规则覆盖先声明的同命中规则
+ * - auto 模式：仅 allow 放行，deny/ask 均拒绝
+ */
+export type PermissionAction = "allow" | "deny" | "ask";
+/** pattern 是否命中 command：含 `/` 的路径规则走 glob（`**` 跨目录、`*` 单段，对齐引擎 edit/read 语义）；否则 bash 规则：`*` 全匹配、`前缀*` 前缀匹配、无通配精确匹配 */
+export declare function permissionPatternMatches(pattern: string, command: string): boolean;
+/**
+ * 按规则集解析 command 的最终动作。
+ * 按声明顺序遍历，命中即记录，后命中覆盖先前 → 最后匹配优先。
+ * 无任何命中返回 "ask"（默认询问，auto 模式下等效拒绝）。
+ */
+export declare function matchPermission(rules: Record<string, string>, command: string): PermissionAction;
+/**
+ * auto 模式门禁：仅 allow 放行；deny 与 ask（无命中）均拒绝。
+ */
+export declare function isAllowedInAutoMode(rules: Record<string, string>, command: string): boolean;

package/dist/kernel/permission.js

@@ -0,0 +1,45 @@
+/**
+ * OpenCode permission 匹配纯函数（spec §7.2）。
+ *
+ * 语义与 OpenCode 当前实现对齐：
+ * - bash 模式规则：pattern 支持 `*` 通配（`*` 兜底、`cmd*` 前缀匹配）
+ * - 最后匹配优先：后声明的规则覆盖先声明的同命中规则
+ * - auto 模式：仅 allow 放行，deny/ask 均拒绝
+ */
+/** 含 `**` 的 pattern 按 glob 语义匹配（`**` 跨目录、`*` 单段，对齐引擎 edit/read 路径规则） */
+function globPatternMatches(pattern, value) {
+    const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+    const regex = new RegExp(`^${escaped.replace(/\*\*/g, "\u0000").replace(/\*/g, "[^/]*").replace(/\u0000/g, ".*")}$`);
+    return regex.test(value);
+}
+/** pattern 是否命中 command：含 `/` 的路径规则走 glob（`**` 跨目录、`*` 单段，对齐引擎 edit/read 语义）；否则 bash 规则：`*` 全匹配、`前缀*` 前缀匹配、无通配精确匹配 */
+export function permissionPatternMatches(pattern, command) {
+    if (pattern.includes("/"))
+        return globPatternMatches(pattern, command);
+    if (pattern === "*")
+        return true;
+    if (pattern.endsWith("*"))
+        return command.startsWith(pattern.slice(0, -1));
+    return command === pattern;
+}
+/**
+ * 按规则集解析 command 的最终动作。
+ * 按声明顺序遍历，命中即记录，后命中覆盖先前 → 最后匹配优先。
+ * 无任何命中返回 "ask"（默认询问，auto 模式下等效拒绝）。
+ */
+export function matchPermission(rules, command) {
+    let action = "ask";
+    for (const [pattern, raw] of Object.entries(rules)) {
+        if (!permissionPatternMatches(pattern, command))
+            continue;
+        action = raw === "allow" ? "allow" : raw === "deny" ? "deny" : "ask";
+    }
+    return action;
+}
+/**
+ * auto 模式门禁：仅 allow 放行；deny 与 ask（无命中）均拒绝。
+ */
+export function isAllowedInAutoMode(rules, command) {
+    return matchPermission(rules, command) === "allow";
+}
+//# sourceMappingURL=permission.js.map

package/dist/kernel/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../src/kernel/permission.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,wEAAwE;AACxE,SAAS,kBAAkB,CAAC,OAAe,EAAE,KAAa;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;IACpH,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,OAAe;IACvE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACtE,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAChC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1E,OAAO,OAAO,KAAK,OAAO,CAAA;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAA6B,EAAE,OAAe;IAC5E,IAAI,MAAM,GAAqB,KAAK,CAAA;IACpC,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC;YAAE,SAAQ;QACzD,MAAM,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;IACtE,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA6B,EAAE,OAAe;IAChF,OAAO,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,OAAO,CAAA;AACpD,CAAC"}

package/dist/kernel/profile.d.ts

@@ -0,0 +1,35 @@
+/** AGENTS.md 中 Project Profile 区块的固定标题 */
+export declare const PROFILE_SECTION_TITLE = "## Project Profile";
+export type TddDefaultMode = "strict" | "relaxed" | "bypass";
+/** 解析后的结构化项目 Profile（只含可机检字段） */
+export interface ProjectProfile {
+    testCommand: string | null;
+    regressionCommand: string | null;
+    testFilePatterns: string[];
+    implementationFilePatterns: string[];
+    tddDefaultMode: TddDefaultMode | null;
+    versionBumpRule: string | null;
+    versionFile: string | null;
+    tagFormat: string | null;
+    releaseWorkflowPath: string | null;
+    riskPatterns: string[];
+}
+export interface ProfileParseResult {
+    profile: ProjectProfile;
+    warnings: string[];
+}
+/** 无 Profile 时的空值：所有可选字段为 null、列表字段为空数组 */
+export declare function emptyProfile(): ProjectProfile;
+/**
+ * 解析 markdown 中的 `## Project Profile` 区块。
+ * 定位标题到下一个 `##` 标题之间的条目行，按白名单提取；
+ * 未知 key 记 warning（不阻断），重复 key 取最后（文档语义）。
+ */
+export declare function parseProjectProfile(markdown: string): ProfileParseResult;
+/** 从项目根目录读取 AGENTS.md 并解析；文件缺失或区块缺失返回空 Profile，不抛错 */
+export declare function readProjectProfile(projectDir: string): Promise<ProjectProfile>;
+/**
+ * 确认回写辅助：将 profileBlock（完整 `## Project Profile` 区块）写入 markdown。
+ * 已存在区块则整块替换，否则追加到末尾。
+ */
+export declare function upsertProjectProfile(markdown: string, profileBlock: string): string;

package/dist/kernel/profile.js

@@ -0,0 +1,147 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+/** AGENTS.md 中 Project Profile 区块的固定标题 */
+export const PROFILE_SECTION_TITLE = "## Project Profile";
+/** 无 Profile 时的空值：所有可选字段为 null、列表字段为空数组 */
+export function emptyProfile() {
+    return {
+        testCommand: null,
+        regressionCommand: null,
+        testFilePatterns: [],
+        implementationFilePatterns: [],
+        tddDefaultMode: null,
+        versionBumpRule: null,
+        versionFile: null,
+        tagFormat: null,
+        releaseWorkflowPath: null,
+        riskPatterns: [],
+    };
+}
+/** 条目行：`- key: value`，key 仅含小写字母/数字/空格/下划线/连字符 */
+const KEY_VALUE_PATTERN = /^- ([a-z0-9 _-]+):\s*(.+)$/;
+const VALID_TDD_MODES = new Set(["strict", "relaxed", "bypass"]);
+/**
+ * 解析 markdown 中的 `## Project Profile` 区块。
+ * 定位标题到下一个 `##` 标题之间的条目行，按白名单提取；
+ * 未知 key 记 warning（不阻断），重复 key 取最后（文档语义）。
+ */
+export function parseProjectProfile(markdown) {
+    const profile = emptyProfile();
+    const warnings = [];
+    const section = findProfileSection(markdown);
+    if (!section) {
+        return { profile, warnings };
+    }
+    const lines = markdown.split("\n");
+    for (let i = section.start + 1; i < section.end; i++) {
+        const match = KEY_VALUE_PATTERN.exec(lines[i]);
+        if (!match)
+            continue;
+        applyKey(profile, warnings, match[1], cleanValue(match[2]));
+    }
+    return { profile, warnings };
+}
+/** 从项目根目录读取 AGENTS.md 并解析；文件缺失或区块缺失返回空 Profile，不抛错 */
+export async function readProjectProfile(projectDir) {
+    let markdown;
+    try {
+        markdown = await readFile(join(projectDir, "AGENTS.md"), "utf8");
+    }
+    catch {
+        return emptyProfile();
+    }
+    return parseProjectProfile(markdown).profile;
+}
+/**
+ * 确认回写辅助：将 profileBlock（完整 `## Project Profile` 区块）写入 markdown。
+ * 已存在区块则整块替换，否则追加到末尾。
+ */
+export function upsertProjectProfile(markdown, profileBlock) {
+    const section = findProfileSection(markdown);
+    if (!section) {
+        const trimmed = markdown.trimEnd();
+        if (trimmed === "")
+            return profileBlock.trimStart();
+        return `${trimmed}\n\n${profileBlock}`;
+    }
+    const lines = markdown.split("\n");
+    const before = lines.slice(0, section.start).join("\n").trimEnd();
+    const after = lines.slice(section.end).join("\n").trimStart();
+    return [before, profileBlock.trim(), after].filter(part => part !== "").join("\n\n");
+}
+/** 定位 Profile 区块：标题行索引与结束行索引（下一个 `##` 标题，含；无则到文件末尾） */
+function findProfileSection(markdown) {
+    const lines = markdown.split("\n");
+    const start = lines.findIndex(line => line.trim() === PROFILE_SECTION_TITLE);
+    if (start === -1)
+        return null;
+    let end = lines.length;
+    for (let i = start + 1; i < lines.length; i++) {
+        if (/^#{2,}\s/.test(lines[i])) {
+            end = i;
+            break;
+        }
+    }
+    return { start, end };
+}
+/** 去掉值中的反引号与两端空白 */
+function cleanValue(raw) {
+    return raw.replaceAll("`", "").trim();
+}
+/**
+ * 逗号分隔的模式列表：trim 并过滤空项。
+ * 忽略 glob 花括号组内的逗号（如 test 文件的 ts/tsx 花括号写法不得被拆开）。
+ */
+function splitPatterns(value) {
+    return value
+        .split(/,(?![^{}]*})/)
+        .map(part => part.trim())
+        .filter(part => part !== "");
+}
+function applyKey(profile, warnings, key, value) {
+    switch (key) {
+        case "test command":
+            profile.testCommand = value;
+            return;
+        case "regression command":
+            profile.regressionCommand = value;
+            return;
+        case "test file patterns":
+            profile.testFilePatterns = splitPatterns(value);
+            return;
+        case "implementation file patterns":
+            profile.implementationFilePatterns = splitPatterns(value);
+            return;
+        case "tdd default mode":
+            if (VALID_TDD_MODES.has(value)) {
+                profile.tddDefaultMode = value;
+            }
+            else {
+                warnings.push(`Invalid tdd default mode: ${value}`);
+            }
+            return;
+        case "version bump rule":
+            profile.versionBumpRule = value;
+            return;
+        case "version file":
+            profile.versionFile = value;
+            return;
+        case "tag format":
+            if (value.includes("{version}")) {
+                profile.tagFormat = value;
+            }
+            else {
+                warnings.push(`tag format must contain {version} placeholder: ${value}`);
+            }
+            return;
+        case "release workflow":
+            profile.releaseWorkflowPath = value;
+            return;
+        case "risk patterns":
+            profile.riskPatterns = splitPatterns(value);
+            return;
+        default:
+            warnings.push(`Unknown profile key: ${key}`);
+    }
+}
+//# sourceMappingURL=profile.js.map

package/dist/kernel/profile.js.map

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

package/dist/kernel/records.d.ts

@@ -0,0 +1,103 @@
+import type { FlowRecordRef, TaskRecordRef } from "./types.js";
+/** TDD evidence 受控 comment 的 marker（单个 comment 承载全部证据） */
+export declare const EVIDENCE_MARKER_START = "<!-- cabbage-tdd-evidence:start -->";
+export declare const EVIDENCE_MARKER_END = "<!-- cabbage-tdd-evidence:end -->";
+/** Flow Record（Parent Issue）标签 */
+export declare const FLOW_LABEL = "cabbage:flow";
+/** 全自动授权标签：用户打此标签 = 该 flow 全自动运行，阶段确认门禁（requirements/高风险）自动放行 */
+export declare const AUTO_LABEL = "cabbage:auto";
+/** 阶段标签前缀：cabbage:stage:<stage> */
+export declare const STAGE_LABEL_PREFIX = "cabbage:stage:";
+type GhFn = (args: string) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function setRecordsGhExecutor(fn: GhFn | null): void;
+/** 构造 marker 包裹的受控 comment body，START marker 行内携带 revision */
+export declare function buildEvidenceCommentBody(block: string, revision: number): string;
+/** 从受控 comment body 提取 revision 与 marker 区间内容；无 marker 或畸形返回 null */
+export declare function extractEvidenceBlock(body: string): {
+    revision: number;
+    content: string;
+} | null;
+export interface CreateFlowRecordInput {
+    slug: string;
+    body: string;
+    /** 全自动模式：创建时同时打 cabbage:auto 标签（阶段确认门禁自动放行） */
+    autoMode?: boolean;
+}
+/** 创建 Parent Issue（Flow Record），打 cabbage:flow 标签（gh 2.96：issue create 无 --draft/--json） */
+export declare function createFlowRecord(input: CreateFlowRecordInput): Promise<{
+    ok: true;
+    ref: FlowRecordRef;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function readFlowRecord(parentIssueNumber: number): Promise<{
+    ok: true;
+    body: string;
+} | {
+    ok: false;
+    code: "NOT_FOUND";
+    error: string;
+}>;
+/**
+ * 乐观锁更新 Flow Record body：mutex 串行 + previousBody 比对。
+ * 比对不一致（外部并发修改）→ 重读最新 body，基于最新内容合并写入（retried: true）。
+ * 合并语义保留外部修改；跨进程完全串行化需 ETag/If-Match（GitHub REST 限制，超出范围）。
+ */
+export declare function updateFlowRecord(parentIssueNumber: number, previousBody: string, buildNewBody: (current: string) => string): Promise<{
+    ok: true;
+    retried: boolean;
+} | {
+    ok: false;
+    error: string;
+}>;
+export interface CreateTaskRecordInput {
+    title: string;
+    body: string;
+    parentIssueNumber: number;
+}
+/** 创建关联 Parent 的 Sub Issue（Task Record） */
+export declare function createTaskRecord(input: CreateTaskRecordInput): Promise<{
+    ok: true;
+    ref: TaskRecordRef;
+} | {
+    ok: false;
+    error: string;
+}>;
+export interface TddEvidenceComment {
+    id: number;
+    body: string;
+    revision: number;
+}
+/**
+ * 读取 Task Record 的受控 evidence comment（取最新的，兼容历史多 comment）；不存在返回 null。
+ * 兼容旧格式注释：只有 start marker、无 end marker 的注释（旧版本插件写入）也视为受控，
+ * revision 从 `revision:N` 行提取；完全无法解析时返回 null。
+ */
+export declare function readTddEvidenceComment(issueNumber: number): Promise<TddEvidenceComment | null>;
+/** 单条 evidence comment 超过该字节数后滚动到新 comment（GitHub comment body 上限 65536 字节） */
+export declare const MAX_EVIDENCE_COMMENT_BYTES = 55000;
+/**
+ * 追加 TDD evidence 到 Task Record 的受控 comment：
+ * 无受控 comment → 新建（revision 1）；有 → marker 区间内 append，revision+1（PATCH 更新）；
+ * 单 comment 超限 → 滚动到新 comment（revision 从当前继续）。
+ * mutex 按 issueNumber 串行；block 已存在则幂等跳过（追加不重复）。
+ * 跨进程并发为最佳努力（PATCH 前基于最新重读的 body 构造，丢失概率显著降低）；
+ * 完全串行化需 ETag/If-Match（GitHub REST 限制，超出当前范围）。
+ */
+export declare function appendTddEvidence(issueNumber: number, block: string): Promise<{
+    ok: boolean;
+    revision: number;
+    error?: string;
+}>;
+/** 确保 label 存在（gh label create --force：存在则更新，幂等）；创建失败不阻塞（后续 add-label 会显式报错） */
+export declare function ensureLabel(name: string): Promise<void>;
+/** 设置 Flow Record 的阶段标签：移除其它 cabbage:stage:*，添加当前阶段（自动创建目标标签） */
+export declare function setStageLabel(parentIssueNumber: number, stage: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export {};