@devcxl/opencode-cabbage 0.3.2 → 1.1.0

package/dist/kernel/records.js

@@ -0,0 +1,240 @@
+import { gh as ghCli, parsePrUrlNumber } from "../util/gh.js";
+import { escapeShellArg } from "../util/shell.js";
+import { KeyedMutex } from "./mutex.js";
+/** TDD evidence 受控 comment 的 marker（单个 comment 承载全部证据） */
+export const EVIDENCE_MARKER_START = "<!-- cabbage-tdd-evidence:start -->";
+export const EVIDENCE_MARKER_END = "<!-- cabbage-tdd-evidence:end -->";
+/** Flow Record（Parent Issue）标签 */
+export const FLOW_LABEL = "cabbage:flow";
+/** 全自动授权标签：用户打此标签 = 该 flow 全自动运行，阶段确认门禁（requirements/高风险）自动放行 */
+export const AUTO_LABEL = "cabbage:auto";
+/** 阶段标签前缀：cabbage:stage:<stage> */
+export const STAGE_LABEL_PREFIX = "cabbage:stage:";
+let recordsGhExecutor = null;
+export function setRecordsGhExecutor(fn) {
+    recordsGhExecutor = fn;
+}
+async function gh(args, timeout) {
+    if (recordsGhExecutor) {
+        return recordsGhExecutor(args);
+    }
+    return ghCli(args, timeout);
+}
+// ─── evidence comment 纯函数 ───
+/** 构造 marker 包裹的受控 comment body，START marker 行内携带 revision */
+export function buildEvidenceCommentBody(block, revision) {
+    return `${EVIDENCE_MARKER_START} revision:${revision}\n${block}\n${EVIDENCE_MARKER_END}`;
+}
+/** 从受控 comment body 提取 revision 与 marker 区间内容；无 marker 或畸形返回 null */
+export function extractEvidenceBlock(body) {
+    const startIdx = body.indexOf(EVIDENCE_MARKER_START);
+    const endIdx = body.indexOf(EVIDENCE_MARKER_END);
+    if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) {
+        return null;
+    }
+    const newlineAfterStart = body.indexOf("\n", startIdx);
+    if (newlineAfterStart === -1 || newlineAfterStart > endIdx) {
+        return null;
+    }
+    const header = body.slice(startIdx, newlineAfterStart);
+    const revisionMatch = header.match(/revision:(\d+)/);
+    if (!revisionMatch) {
+        return null;
+    }
+    const content = body.slice(newlineAfterStart + 1, endIdx).trim();
+    if (content === "") {
+        return null;
+    }
+    return { revision: Number(revisionMatch[1]), content };
+}
+// ─── 记录写入互斥（按 issueNumber 串行） ───
+const recordMutex = new KeyedMutex();
+async function readBody(issueNumber) {
+    const { stdout } = await gh(`issue view ${issueNumber} --json body --jq .body`);
+    return stdout;
+}
+async function writeBody(issueNumber, body) {
+    const escaped = escapeShellArg(body);
+    await gh(`issue edit ${issueNumber} --body '${escaped}'`);
+}
+/** 创建 Parent Issue（Flow Record），打 cabbage:flow 标签（gh 2.96：issue create 无 --draft/--json） */
+export async function createFlowRecord(input) {
+    try {
+        await ensureLabel(FLOW_LABEL);
+        if (input.autoMode)
+            await ensureLabel(AUTO_LABEL);
+        const escapedBody = escapeShellArg(input.body);
+        const labelArgs = input.autoMode
+            ? `--label '${FLOW_LABEL}' --label '${AUTO_LABEL}'`
+            : `--label '${FLOW_LABEL}'`;
+        const { stdout } = await gh(`issue create --title '${escapeShellArg(input.slug)}' --body '${escapedBody}' ${labelArgs}`);
+        // issue create 不支持 --json：解析 stdout 中的 issue URL
+        const number = parsePrUrlNumber(stdout);
+        if (number === null) {
+            throw new Error(`invalid issue create output: ${stdout}`);
+        }
+        return { ok: true, ref: { parentIssueNumber: number, slug: input.slug } };
+    }
+    catch (err) {
+        return { ok: false, error: String(err) };
+    }
+}
+export async function readFlowRecord(parentIssueNumber) {
+    try {
+        const { stdout } = await gh(`issue view ${parentIssueNumber} --json body --jq .body`);
+        return { ok: true, body: stdout };
+    }
+    catch (err) {
+        return { ok: false, code: "NOT_FOUND", error: String(err) };
+    }
+}
+/**
+ * 乐观锁更新 Flow Record body：mutex 串行 + previousBody 比对。
+ * 比对不一致（外部并发修改）→ 重读最新 body，基于最新内容合并写入（retried: true）。
+ * 合并语义保留外部修改；跨进程完全串行化需 ETag/If-Match（GitHub REST 限制，超出范围）。
+ */
+export async function updateFlowRecord(parentIssueNumber, previousBody, buildNewBody) {
+    return recordMutex.runExclusive(parentIssueNumber, async () => {
+        try {
+            const current = await readBody(parentIssueNumber);
+            if (current === previousBody) {
+                await writeBody(parentIssueNumber, buildNewBody(current));
+                return { ok: true, retried: false };
+            }
+            // 冲突：重读最新 body，基于最新内容合并（保留外部修改）
+            const latest = await readBody(parentIssueNumber);
+            await writeBody(parentIssueNumber, buildNewBody(latest));
+            return { ok: true, retried: true };
+        }
+        catch (err) {
+            return { ok: false, error: String(err) };
+        }
+    });
+}
+/** 创建关联 Parent 的 Sub Issue（Task Record） */
+export async function createTaskRecord(input) {
+    try {
+        const escapedBody = escapeShellArg(input.body);
+        const { stdout } = await gh(`issue create --title '${escapeShellArg(input.title)}' --body '${escapedBody}' --parent ${input.parentIssueNumber}`);
+        // issue create 不支持 --json：解析 stdout 中的 issue URL
+        const number = parsePrUrlNumber(stdout);
+        if (number === null) {
+            throw new Error(`invalid issue create output: ${stdout}`);
+        }
+        return {
+            ok: true,
+            ref: { parentIssueNumber: input.parentIssueNumber, taskId: input.title, issueNumber: number },
+        };
+    }
+    catch (err) {
+        return { ok: false, error: String(err) };
+    }
+}
+/**
+ * 读取 Task Record 的受控 evidence comment（取最新的，兼容历史多 comment）；不存在返回 null。
+ * 兼容旧格式注释：只有 start marker、无 end marker 的注释（旧版本插件写入）也视为受控，
+ * revision 从 `revision:N` 行提取；完全无法解析时返回 null。
+ */
+export async function readTddEvidenceComment(issueNumber) {
+    try {
+        const { stdout } = await gh(`issue view ${issueNumber} --json comments --jq '[.comments[] | select(.body | contains("${EVIDENCE_MARKER_START}")) | {id: (.id|tonumber), body}] | last'`);
+        const trimmed = stdout.trim();
+        if (trimmed === "" || trimmed === "null") {
+            return null;
+        }
+        const parsed = JSON.parse(trimmed);
+        const extracted = extractEvidenceBlock(parsed.body);
+        if (extracted) {
+            return { id: parsed.id, body: parsed.body, revision: extracted.revision };
+        }
+        // 旧格式兼容：只有 start marker（无 end marker）→ 从 body 提取 revision
+        const legacyRevision = parsed.body.match(/revision:(\d+)/)?.[1];
+        if (legacyRevision === undefined) {
+            return null;
+        }
+        return { id: parsed.id, body: parsed.body, revision: Number(legacyRevision) };
+    }
+    catch {
+        return null;
+    }
+}
+/** 单条 evidence comment 超过该字节数后滚动到新 comment（GitHub comment body 上限 65536 字节） */
+export const MAX_EVIDENCE_COMMENT_BYTES = 55_000;
+/**
+ * 追加 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 async function appendTddEvidence(issueNumber, block) {
+    return recordMutex.runExclusive(issueNumber, async () => {
+        try {
+            // 幂等：block 已在最新 comment 的 marker 区间内，不重复追加
+            const existing = await readTddEvidenceComment(issueNumber);
+            if (existing && extractEvidenceBlock(existing.body)?.content.includes(block)) {
+                return { ok: true, revision: existing.revision };
+            }
+            if (!existing) {
+                const body = buildEvidenceCommentBody(block, 1);
+                await gh(`issue comment ${issueNumber} --body '${escapeShellArg(body)}'`);
+                return { ok: true, revision: 1 };
+            }
+            // 滚动：最新 comment 超限 → 新建 comment 承载新证据
+            if (existing.body.length > MAX_EVIDENCE_COMMENT_BYTES) {
+                const body = buildEvidenceCommentBody(block, existing.revision + 1);
+                await gh(`issue comment ${issueNumber} --body '${escapeShellArg(body)}'`);
+                return { ok: true, revision: existing.revision + 1 };
+            }
+            // 追加前基于最新重读的 body 构造（跨进程冲突时尽量以最新为准，防覆盖丢失）
+            const current = await readTddEvidenceComment(issueNumber);
+            const base = current && current.id === existing.id ? current : existing;
+            const newBody = appendBlockToEvidenceBody(base.body, block, base.revision);
+            const repo = await gh("repo view --json nameWithOwner --jq .nameWithOwner");
+            await gh(`api repos/${repo.stdout.trim()}/issues/comments/${base.id} -X PATCH -f body='${escapeShellArg(newBody)}'`);
+            return { ok: true, revision: base.revision + 1 };
+        }
+        catch (err) {
+            return { ok: false, revision: 0, error: String(err) };
+        }
+    });
+}
+/** 在 END marker 前插入新 block，并将 START 行 revision 递增 */
+function appendBlockToEvidenceBody(body, block, revision) {
+    const endIdx = body.indexOf(EVIDENCE_MARKER_END);
+    const prefix = body.slice(0, endIdx);
+    const suffix = body.slice(endIdx);
+    return `${prefix}${block}\n${suffix}`.replace(/(revision:)\d+/, `$1${revision + 1}`);
+}
+// ─── labels ───
+/** 确保 label 存在（gh label create --force：存在则更新，幂等）；创建失败不阻塞（后续 add-label 会显式报错） */
+export async function ensureLabel(name) {
+    try {
+        await gh(`label create '${escapeShellArg(name)}' --force`);
+    }
+    catch {
+        // 已存在或权限不足：忽略，add-label 阶段仍会暴露真实错误
+    }
+}
+/** 设置 Flow Record 的阶段标签：移除其它 cabbage:stage:*，添加当前阶段（自动创建目标标签） */
+export async function setStageLabel(parentIssueNumber, stage) {
+    try {
+        const { stdout } = await gh(`issue view ${parentIssueNumber} --json labels --jq '[.labels[].name] | join(" ") | tostring'`);
+        const currentLabels = stdout.trim() === "" ? [] : stdout.trim().split(" ");
+        const target = `${STAGE_LABEL_PREFIX}${stage}`;
+        const stale = currentLabels.filter(l => l.startsWith(STAGE_LABEL_PREFIX) && l !== target);
+        const args = [];
+        for (const label of stale) {
+            args.push(`--remove-label '${escapeShellArg(label)}'`);
+        }
+        args.push(`--add-label '${escapeShellArg(target)}'`);
+        await ensureLabel(target);
+        await gh(`issue edit ${parentIssueNumber} ${args.join(" ")}`);
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, error: String(err) };
+    }
+}
+//# sourceMappingURL=records.js.map

package/dist/kernel/records.js.map

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

package/dist/kernel/release.d.ts

@@ -0,0 +1,106 @@
+export type ChangeCategory = "feature" | "fix" | "maintenance" | "docs" | "unclassified";
+export type VersionType = "major" | "minor" | "patch";
+export interface ReleaseChange {
+    sha: string;
+    title: string;
+    category: ChangeCategory;
+    breaking: boolean;
+}
+export interface Version {
+    major: number;
+    minor: number;
+    patch: number;
+}
+export interface VersionFileSpec {
+    path: string;
+    key: string;
+}
+/**
+ * 解析版本文件规则（Profile `version file` 值）：
+ * 形如 `package.json`（默认 $.version）或 `lib/version.json $.version`；
+ * json 路径必须为 `$.<key>` 形式，否则返回 null。
+ */
+export declare function parseVersionFileSpec(spec: string): VersionFileSpec | null;
+/** 从 JSON 文本按 key 读取版本字符串；非字符串或解析失败返回 null */
+export declare function readVersionFromJson(json: string, key: string): string | null;
+/** 更新 JSON 文本中指定 key 的版本；保留缩进风格与结尾换行 */
+export declare function updateVersionInJson(json: string, key: string, version: string): string;
+export declare function parseVersion(raw: string): Version | null;
+export declare function formatVersion(v: Version): string;
+/** SemVer bump：major 重置 minor/patch，minor 重置 patch，patch +1 */
+export declare function bumpVersion(current: Version, type: VersionType): Version;
+/** 取最高 bump 级别：major > minor > patch */
+export declare function highestBumpType(types: VersionType[]): VersionType;
+type Classified = {
+    category: ChangeCategory;
+    breaking: boolean;
+};
+/**
+ * 从 commit message 分类（conventional commits，关联 Flow/Task type）：
+ * - breaking：`type!:` 或 body 含 `BREAKING CHANGE`
+ * - feat→feature、fix→fix、docs→docs、chore/refactor/build/ci/perf/test/merge→maintenance
+ * - 其余 → unclassified
+ */
+export declare function classifyCommitTitle(title: string): Classified;
+export declare function classifyChanges(commits: {
+    sha: string;
+    title: string;
+}[]): ReleaseChange[];
+export type ProposeVersionResult = {
+    ok: true;
+    proposed: string;
+    type: VersionType;
+} | {
+    ok: false;
+    code: "INVALID_VERSION";
+    message: string;
+} | {
+    ok: false;
+    code: "UNCLASSIFIED_CHANGES";
+    unclassified: {
+        sha: string;
+        title: string;
+    }[];
+    message: string;
+};
+/**
+ * SemVer 提议：breaking→major（含 0.x）、feature→minor、fix/maintenance/docs→patch；
+ * 多变更取最高级别；存在未分类变更时拒绝（版本提议前必须分类）。
+ */
+export declare function proposeVersion(currentVersion: string, changes: ReleaseChange[]): ProposeVersionResult;
+/** 按 tag 格式（如 v{version}）构建 tag；缺省 v{version} */
+export declare function buildTag(version: string, tagFormat: string): string;
+/** tag 名是否可安全进入 shell 命令；非法（含 tagFormat 注入）→ false */
+export declare function validateTagName(tag: string): boolean;
+/** tag 是否匹配格式（替换 {version} 为语义版本正则后整体匹配） */
+export declare function validateTagFormat(tag: string, tagFormat: string): boolean;
+/** 按分类聚合生成 Release Notes markdown；breaking 变更单独列出 */
+export declare function buildReleaseNotes(version: string, changes: ReleaseChange[]): string;
+export type GhFn = (args: string) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function setReleaseGhExecutor(fn: GhFn | null): void;
+/** 仓库上一 tag 名（tags 列表第一个）；无 tag 返回 null */
+export declare function latestTag(executor?: GhFn): Promise<string | null>;
+/** 聚合上一 tag 之后 base 分支的全部 commit（sha + 首行标题） */
+export declare function listCommitsSinceTag(tag: string, baseBranch: string, executor?: GhFn): Promise<{
+    sha: string;
+    title: string;
+}[]>;
+/** 远程已存在 tag 指向的 commit SHA；不存在返回 null */
+export declare function existingTagSha(tag: string, executor?: GhFn): Promise<string | null>;
+export type TagImmutabilityResult = {
+    ok: true;
+    reason?: string;
+} | {
+    ok: false;
+    code: "TAG_ALREADY_EXISTS";
+    message: string;
+};
+/**
+ * tag 不可变校验：不得删除重打。
+ * 远程已存在且指向不同 SHA → 拒绝；指向同一 SHA → 幂等通过；不存在 → 可创建。
+ */
+export declare function validateTagImmutability(tag: string, expectedSha: string, executor?: GhFn): Promise<TagImmutabilityResult>;
+export {};

package/dist/kernel/release.js

@@ -0,0 +1,241 @@
+import { gh as ghCli } from "../util/gh.js";
+/**
+ * 解析版本文件规则（Profile `version file` 值）：
+ * 形如 `package.json`（默认 $.version）或 `lib/version.json $.version`；
+ * json 路径必须为 `$.<key>` 形式，否则返回 null。
+ */
+export function parseVersionFileSpec(spec) {
+    const trimmed = spec.trim();
+    if (trimmed === "")
+        return null;
+    const parts = trimmed.split(/\s+/);
+    if (parts.length === 1) {
+        return { path: parts[0], key: "version" };
+    }
+    const jsonPath = parts[parts.length - 1];
+    const key = jsonPath.startsWith("$.") ? jsonPath.slice(2) : "";
+    if (key === "")
+        return null;
+    return { path: parts.slice(0, -1).join(" "), key };
+}
+/** 从 JSON 文本按 key 读取版本字符串；非字符串或解析失败返回 null */
+export function readVersionFromJson(json, key) {
+    try {
+        const value = JSON.parse(json)?.[key];
+        return typeof value === "string" ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 更新 JSON 文本中指定 key 的版本；保留缩进风格与结尾换行 */
+export function updateVersionInJson(json, key, version) {
+    const parsed = JSON.parse(json);
+    parsed[key] = version;
+    const updated = JSON.stringify(parsed, null, 2);
+    return json.endsWith("\n") ? `${updated}\n` : updated;
+}
+// ─── 版本纯函数 ───
+const VERSION_PATTERN = /^(\d+)\.(\d+)\.(\d+)$/;
+export function parseVersion(raw) {
+    const match = VERSION_PATTERN.exec(raw.trim());
+    if (!match)
+        return null;
+    return { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) };
+}
+export function formatVersion(v) {
+    return `${v.major}.${v.minor}.${v.patch}`;
+}
+/** SemVer bump：major 重置 minor/patch，minor 重置 patch，patch +1 */
+export function bumpVersion(current, type) {
+    switch (type) {
+        case "major":
+            return { major: current.major + 1, minor: 0, patch: 0 };
+        case "minor":
+            return { major: current.major, minor: current.minor + 1, patch: 0 };
+        case "patch":
+            return { major: current.major, minor: current.minor, patch: current.patch + 1 };
+    }
+}
+/** 取最高 bump 级别：major > minor > patch */
+export function highestBumpType(types) {
+    if (types.includes("major"))
+        return "major";
+    if (types.includes("minor"))
+        return "minor";
+    return "patch";
+}
+const CONVENTIONAL_PATTERN = /^([a-z]+)(!)?(\([^)]*\))?:/;
+const MAINTENANCE_TYPES = new Set(["chore", "refactor", "build", "ci", "perf", "test", "merge"]);
+/**
+ * 从 commit message 分类（conventional commits，关联 Flow/Task type）：
+ * - breaking：`type!:` 或 body 含 `BREAKING CHANGE`
+ * - feat→feature、fix→fix、docs→docs、chore/refactor/build/ci/perf/test/merge→maintenance
+ * - 其余 → unclassified
+ */
+export function classifyCommitTitle(title) {
+    const firstLine = title.split("\n")[0];
+    const breaking = /^[a-z]+!(:|\()/.test(firstLine) || title.includes("BREAKING CHANGE");
+    if (firstLine.startsWith("Merge ")) {
+        return { category: "maintenance", breaking };
+    }
+    const match = CONVENTIONAL_PATTERN.exec(firstLine);
+    if (!match)
+        return { category: "unclassified", breaking };
+    const type = match[1];
+    switch (type) {
+        case "feat":
+            return { category: "feature", breaking };
+        case "fix":
+            return { category: "fix", breaking };
+        case "docs":
+            return { category: "docs", breaking };
+        default:
+            if (MAINTENANCE_TYPES.has(type))
+                return { category: "maintenance", breaking };
+            return { category: "unclassified", breaking };
+    }
+}
+export function classifyChanges(commits) {
+    return commits.map(commit => {
+        const { category, breaking } = classifyCommitTitle(commit.title);
+        return { sha: commit.sha, title: commit.title.split("\n")[0], category, breaking };
+    });
+}
+/**
+ * SemVer 提议：breaking→major（含 0.x）、feature→minor、fix/maintenance/docs→patch；
+ * 多变更取最高级别；存在未分类变更时拒绝（版本提议前必须分类）。
+ */
+export function proposeVersion(currentVersion, changes) {
+    const current = parseVersion(currentVersion);
+    if (!current) {
+        return { ok: false, code: "INVALID_VERSION", message: `Invalid current version: ${currentVersion}` };
+    }
+    const unclassified = changes
+        .filter(c => c.category === "unclassified")
+        .map(c => ({ sha: c.sha, title: c.title }));
+    if (unclassified.length > 0) {
+        return {
+            ok: false,
+            code: "UNCLASSIFIED_CHANGES",
+            unclassified,
+            message: `Unclassified changes must be classified before proposing a version (${unclassified.length} change(s))`,
+        };
+    }
+    const breaking = changes.some(c => c.breaking);
+    const types = [];
+    for (const c of changes) {
+        if (c.category === "feature")
+            types.push("minor");
+        else if (c.category === "fix" || c.category === "maintenance" || c.category === "docs")
+            types.push("patch");
+    }
+    if (breaking)
+        types.push("major");
+    const type = highestBumpType(types);
+    return { ok: true, proposed: formatVersion(bumpVersion(current, type)), type };
+}
+// ─── tag ───
+/** 按 tag 格式（如 v{version}）构建 tag；缺省 v{version} */
+export function buildTag(version, tagFormat) {
+    if (tagFormat.includes("{version}")) {
+        return tagFormat.replace("{version}", version);
+    }
+    return `v${version}`;
+}
+/** git tag 名安全白名单（git ref 合法字符子集，杜绝 shell 元字符/引号/分号） */
+const TAG_SAFE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+/** tag 名是否可安全进入 shell 命令；非法（含 tagFormat 注入）→ false */
+export function validateTagName(tag) {
+    return TAG_SAFE.test(tag);
+}
+/** tag 是否匹配格式（替换 {version} 为语义版本正则后整体匹配） */
+export function validateTagFormat(tag, tagFormat) {
+    const escaped = tagFormat.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace("\\{version\\}", "(\\d+\\.\\d+\\.\\d+)");
+    return new RegExp(`^${escaped}$`).test(tag);
+}
+// ─── Release Notes ───
+const SECTION_TITLES = [
+    ["feature", "Features"],
+    ["fix", "Fixes"],
+    ["maintenance", "Maintenance"],
+    ["docs", "Documentation"],
+];
+/** 按分类聚合生成 Release Notes markdown；breaking 变更单独列出 */
+export function buildReleaseNotes(version, changes) {
+    const lines = [`## ${version}`];
+    const breaking = changes.filter(c => c.breaking);
+    if (breaking.length > 0) {
+        lines.push("", "### BREAKING CHANGES");
+        for (const c of breaking)
+            lines.push(`- ${c.title}`);
+    }
+    for (const [category, title] of SECTION_TITLES) {
+        const group = changes.filter(c => c.category === category);
+        if (group.length === 0)
+            continue;
+        lines.push("", `### ${title}`);
+        for (const c of group)
+            lines.push(`- ${c.title}`);
+    }
+    return lines.join("\n");
+}
+let releaseGhExecutor = null;
+export function setReleaseGhExecutor(fn) {
+    releaseGhExecutor = fn;
+}
+/** 解析实际 gh 执行函数：显式 executor > 模块级 mock > 真实 gh CLI */
+function ghFn(executor) {
+    return executor ?? releaseGhExecutor ?? ghCli;
+}
+/** 仓库上一 tag 名（tags 列表第一个）；无 tag 返回 null */
+export async function latestTag(executor) {
+    const { stdout } = await ghFn(executor)(`api repos/{owner}/{repo}/tags --jq '.[0].name'`);
+    const trimmed = stdout.trim();
+    if (trimmed === "" || trimmed === "null")
+        return null;
+    return trimmed;
+}
+/** 聚合上一 tag 之后 base 分支的全部 commit（sha + 首行标题） */
+export async function listCommitsSinceTag(tag, baseBranch, executor) {
+    if (!validateTagName(tag)) {
+        throw new Error(`Invalid tag name: ${tag}`);
+    }
+    const { stdout } = await ghFn(executor)(`api repos/{owner}/{repo}/compare/${tag}...${baseBranch} --jq '.commits[] | {sha: .sha, title: (.commit.message | split("\\n")[0])}'`);
+    const trimmed = stdout.trim();
+    if (trimmed === "" || trimmed === "null")
+        return [];
+    const commits = JSON.parse(trimmed);
+    // jq 已截断首行，这里再截断一次（mock/调用方绕过 jq 时兜底）
+    return commits.map(c => ({ sha: c.sha, title: c.title.split("\n")[0] }));
+}
+/** 远程已存在 tag 指向的 commit SHA；不存在返回 null */
+export async function existingTagSha(tag, executor) {
+    if (!validateTagName(tag)) {
+        throw new Error(`Invalid tag name: ${tag}`);
+    }
+    const { stdout } = await ghFn(executor)(`api repos/{owner}/{repo}/tags --jq '.[] | select(.name == ${JSON.stringify(tag)}) | .commit.sha'`);
+    const trimmed = stdout.trim();
+    if (trimmed === "" || trimmed === "null")
+        return null;
+    return trimmed;
+}
+/**
+ * tag 不可变校验：不得删除重打。
+ * 远程已存在且指向不同 SHA → 拒绝；指向同一 SHA → 幂等通过；不存在 → 可创建。
+ */
+export async function validateTagImmutability(tag, expectedSha, executor) {
+    const existing = await existingTagSha(tag, executor);
+    if (existing === null) {
+        return { ok: true };
+    }
+    if (existing === expectedSha) {
+        return { ok: true, reason: "tag already points at the expected commit (idempotent)" };
+    }
+    return {
+        ok: false,
+        code: "TAG_ALREADY_EXISTS",
+        message: `Tag ${tag} already exists at ${existing}, refusing to re-point it to ${expectedSha} (tags are immutable)`,
+    };
+}
+//# sourceMappingURL=release.js.map

package/dist/kernel/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../src/kernel/release.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,KAAK,EAAE,MAAM,eAAe,CAAA;AA2B3C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;IAC3C,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9D,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAA;AACpD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,GAAW;IAC3D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;QACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,GAAW,EAAE,OAAe;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAA;IAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAA;IACrB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;AACvD,CAAC;AAED,gBAAgB;AAEhB,MAAM,eAAe,GAAG,uBAAuB,CAAA;AAE/C,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACtF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,CAAA;AAC3C,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,IAAiB;IAC7D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QACzD,KAAK,OAAO;YACV,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QACrE,KAAK,OAAO;YACV,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAA;IACnF,CAAC;AACH,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IAC3C,OAAO,OAAO,CAAA;AAChB,CAAC;AAMD,MAAM,oBAAoB,GAAG,4BAA4B,CAAA;AAEzD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEhG;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IAEtF,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAA;IAC9C,CAAC;IAED,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAA;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAErB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;QAC1C,KAAK,KAAK;YACR,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;QACtC,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;QACvC;YACE,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAA;YAC7E,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAA;IACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAyC;IACvE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;QAC1B,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAChE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;IACpF,CAAC,CAAC,CAAA;AACJ,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,cAAsB,EAAE,OAAwB;IAC7E,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,4BAA4B,cAAc,EAAE,EAAE,CAAA;IACtG,CAAC;IAED,MAAM,YAAY,GAAG,OAAO;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,cAAc,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAC7C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,sBAAsB;YAC5B,YAAY;YACZ,OAAO,EAAE,uEAAuE,YAAY,CAAC,MAAM,aAAa;SACjH,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IAC9C,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;aAC5C,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,IAAI,CAAC,CAAC,QAAQ,KAAK,aAAa,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7G,CAAC;IACD,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAEjC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;IACnC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;AAChF,CAAC;AAED,cAAc;AAEd,iDAAiD;AACjD,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,SAAiB;IACzD,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,IAAI,OAAO,EAAE,CAAA;AACtB,CAAC;AAED,wDAAwD;AACxD,MAAM,QAAQ,GAAG,8BAA8B,CAAA;AAE/C,sDAAsD;AACtD,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC3B,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,SAAiB;IAC9D,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAAA;IACjH,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC7C,CAAC;AAED,wBAAwB;AAExB,MAAM,cAAc,GAA+B;IACjD,CAAC,SAAS,EAAE,UAAU,CAAC;IACvB,CAAC,KAAK,EAAE,OAAO,CAAC;IAChB,CAAC,aAAa,EAAE,aAAa,CAAC;IAC9B,CAAC,MAAM,EAAE,eAAe,CAAC;CAC1B,CAAA;AAED,qDAAqD;AACrD,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,OAAwB;IACzE,MAAM,KAAK,GAAa,CAAC,MAAM,OAAO,EAAE,CAAC,CAAA;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IAChD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,sBAAsB,CAAC,CAAA;QACtC,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;IACtD,CAAC;IACD,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAA;QAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,KAAK,EAAE,CAAC,CAAA;QAC9B,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAMD,IAAI,iBAAiB,GAAgB,IAAI,CAAA;AAEzC,MAAM,UAAU,oBAAoB,CAAC,EAAe;IAClD,iBAAiB,GAAG,EAAE,CAAA;AACxB,CAAC;AAED,sDAAsD;AACtD,SAAS,IAAI,CAAC,QAAe;IAC3B,OAAO,QAAQ,IAAI,iBAAiB,IAAI,KAAK,CAAA;AAC/C,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAe;IAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,gDAAgD,CAAC,CAAA;IACzF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAC7B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IACrD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,UAAkB,EAClB,QAAe;IAEf,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAA;IAC7C,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CACrC,oCAAoC,GAAG,MAAM,UAAU,8EAA8E,CACtI,CAAA;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAC7B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,EAAE,CAAA;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqC,CAAA;IACvE,sCAAsC;IACtC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC1E,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,QAAe;IAC/D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAA;IAC7C,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,6DAA6D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;IAC3I,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;IAC7B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IACrD,OAAO,OAAO,CAAA;AAChB,CAAC;AAMD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAW,EACX,WAAmB,EACnB,QAAe;IAEf,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACpD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACrB,CAAC;IACD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,wDAAwD,EAAE,CAAA;IACvF,CAAC;IACD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO,GAAG,sBAAsB,QAAQ,gCAAgC,WAAW,uBAAuB;KACpH,CAAA;AACH,CAAC"}

package/dist/kernel/review.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 审查与合并 kernel 逻辑（spec §4.1，自 flowrun/merge.ts + ci.ts 迁入，逻辑不变）。
+ * - mergeTaskPR：标准化合并 PR（--match-head-commit 防偷换）
+ * - checkBranchProtection：默认分支保护探测
+ * - createRevertPR：回滚 PR
+ */
+export type GhFn = (args: string) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function setMergeGhExecutor(fn: GhFn | null): void;
+export interface BranchProtectionStatus {
+    exists: boolean;
+    requiredChecks: string[];
+    requiresPR: boolean;
+    dismissesStale: boolean;
+}
+export declare function checkBranchProtection(owner: string, repo: string): Promise<BranchProtectionStatus>;
+/**
+ * Task PR 合并（带 --match-head-commit 安全检查）。
+ *
+ * 步骤：
+ * 1. 验证 verifiedSha 非空
+ * 2. 使用 gh pr merge --squash --delete-branch --match-head-commit <verifiedSha>
+ * 3. 失败时返回错误
+ */
+export declare function mergeTaskPR(prNumber: number, verifiedSha: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+export declare function createRevertPR(prNumber: number, reason: string): Promise<{
+    prNumber?: number;
+    error?: string;
+}>;