@devcxl/opencode-cabbage 1.1.0 → 1.3.0

package/dist/kernel/legacy.d.ts

@@ -1,19 +0,0 @@
-/** 旧 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

@@ -1,34 +0,0 @@
-/**
- * 旧 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

@@ -1 +0,0 @@
-{"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/records.d.ts

@@ -1,103 +0,0 @@
-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 {};

package/dist/kernel/records.js

@@ -1,240 +0,0 @@
-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

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

package/dist/kernel/release.d.ts

@@ -1,106 +0,0 @@
-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 {};