@devcxl/opencode-cabbage 0.3.1 → 1.0.0

package/dist/kernel/release.js

@@ -0,0 +1,229 @@
+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}`;
+}
+/** 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) {
+    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) {
+    const { stdout } = await ghFn(executor)(`api repos/{owner}/{repo}/tags --jq '.[] | select(.name == "${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":"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"}

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;
+}>;

package/dist/kernel/review.js

@@ -0,0 +1,81 @@
+/**
+ * 审查与合并 kernel 逻辑（spec §4.1，自 flowrun/merge.ts + ci.ts 迁入，逻辑不变）。
+ * - mergeTaskPR：标准化合并 PR（--match-head-commit 防偷换）
+ * - checkBranchProtection：默认分支保护探测
+ * - createRevertPR：回滚 PR
+ */
+let mergeGhExecutor = null;
+export function setMergeGhExecutor(fn) {
+    mergeGhExecutor = fn;
+}
+async function gh(args) {
+    if (mergeGhExecutor) {
+        return mergeGhExecutor(args);
+    }
+    const mod = await import("../util/gh.js");
+    return mod.gh(args);
+}
+// ─── Branch Protection ───
+export async function checkBranchProtection(owner, repo) {
+    try {
+        const { stdout } = await gh(`api repos/${owner}/${repo}/branches/main/protection`);
+        const data = JSON.parse(stdout);
+        const checks = [];
+        const requiredPulls = data?.required_pull_request_reviews ?? null;
+        const requiredChecks = data?.required_status_checks?.checks ?? [];
+        for (const c of requiredChecks) {
+            checks.push(c.context);
+        }
+        return {
+            exists: true,
+            requiredChecks: checks,
+            requiresPR: !!requiredPulls,
+            dismissesStale: requiredPulls?.dismiss_stale_reviews ?? false,
+        };
+    }
+    catch {
+        return {
+            exists: false,
+            requiredChecks: [],
+            requiresPR: false,
+            dismissesStale: false,
+        };
+    }
+}
+// ─── PR 合并操作 ───
+/**
+ * Task PR 合并（带 --match-head-commit 安全检查）。
+ *
+ * 步骤：
+ * 1. 验证 verifiedSha 非空
+ * 2. 使用 gh pr merge --squash --delete-branch --match-head-commit <verifiedSha>
+ * 3. 失败时返回错误
+ */
+export async function mergeTaskPR(prNumber, verifiedSha) {
+    if (!verifiedSha) {
+        return { success: false, error: "verifiedSha is required for merge --match-head-commit" };
+    }
+    try {
+        // --match-head-commit 确保只有 verified 的 commit 才会被合并
+        await gh(`pr merge ${prNumber} --squash --delete-branch --match-head-commit ${verifiedSha}`);
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+// ─── Revert ───
+export async function createRevertPR(prNumber, reason) {
+    try {
+        const { stdout } = await gh(`pr view ${prNumber} --json headRefName,headRepository,body,title`);
+        const pr = JSON.parse(stdout);
+        const revertTitle = `revert: ${pr.title}`;
+        const revertBody = `Reverts #${prNumber}\n\nReason: ${reason}\n\nAuto-generated by opencode-cabbage.`;
+        const { stdout: newPR } = await gh(`pr create --title '${revertTitle}' --body '${revertBody}' --base main --head main`);
+        return { prNumber: parseInt(newPR.trim().split("/").pop() || "0", 10) };
+    }
+    catch (err) {
+        return { error: String(err) };
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/kernel/review.js.map

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

package/dist/kernel/session-index.d.ts

@@ -0,0 +1,43 @@
+export type FlowSessionStatus = "active" | "paused" | "completed" | "cancelled";
+export interface FlowSessionEntry {
+    sessionID: string;
+    status: FlowSessionStatus;
+    continuationCount: number;
+    updatedAt: number;
+}
+export interface SessionIndex {
+    flows: Record<string, FlowSessionEntry>;
+}
+export declare function sessionIndexPath(projectDir: string): string;
+/** 读取索引；文件不存在或损坏时返回空索引。 */
+export declare function readIndex(projectDir: string): Promise<SessionIndex>;
+/** 原子写：先写临时文件再 rename。 */
+export declare function writeIndex(projectDir: string, index: SessionIndex): Promise<void>;
+export declare function getFlowSession(index: SessionIndex, parentIssueNumber: number): FlowSessionEntry | null;
+export type BindSessionResult = {
+    ok: true;
+    entry: FlowSessionEntry;
+} | {
+    ok: false;
+    code: "FLOW_SESSION_CONFLICT";
+    message: string;
+} | {
+    ok: false;
+    code: "TAKEOVER_NOT_CONFIRMED";
+    message: string;
+};
+/**
+ * 绑定 parentIssueNumber → sessionID。
+ * 双 session 检测（§10.3）：该 flow 已被另一 active session 绑定时拒绝。
+ */
+export declare function bindSession(projectDir: string, parentIssueNumber: number, sessionID: string): Promise<BindSessionResult>;
+/**
+ * 接管绑定：旧 session 置 paused，新 session 绑定 active（R7）。
+ * 旧 session 为另一 active session 时要求 userConfirmed（§10.3）；
+ * 调用方还需将旧 session 的 goal status 置 paused（goalClient 层）。
+ */
+export declare function takeoverSession(projectDir: string, parentIssueNumber: number, newSessionID: string, userConfirmed: boolean): Promise<BindSessionResult>;
+/** 更新已绑定 flow 的状态/计数；flow 未绑定时返回 null 且不创建 entry。 */
+export declare function updateFlowSession(projectDir: string, parentIssueNumber: number, patch: Partial<Pick<FlowSessionEntry, "status" | "continuationCount">>): Promise<FlowSessionEntry | null>;
+/** 解绑：仅当 sessionID 与当前绑定匹配时删除 entry。 */
+export declare function unbindSession(projectDir: string, parentIssueNumber: number, sessionID: string): Promise<boolean>;

package/dist/kernel/session-index.js

@@ -0,0 +1,120 @@
+/**
+ * Flow → session 轻量索引（替代 session-state.json）。
+ * 路径：.opencode/opencode-cabbage/session-index.json
+ * 作用：parentIssueNumber → sessionID 绑定；双 session 检测（R7）。
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { PLUGIN_ID } from "../util/paths.js";
+export function sessionIndexPath(projectDir) {
+    return path.join(projectDir, ".opencode", PLUGIN_ID, "session-index.json");
+}
+/** 读取索引；文件不存在或损坏时返回空索引。 */
+export async function readIndex(projectDir) {
+    try {
+        const parsed = JSON.parse(await readFile(sessionIndexPath(projectDir), "utf8"));
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed) && parsed.flows && typeof parsed.flows === "object") {
+            return parsed;
+        }
+        return { flows: {} };
+    }
+    catch {
+        return { flows: {} };
+    }
+}
+/** 原子写：先写临时文件再 rename。 */
+export async function writeIndex(projectDir, index) {
+    const target = sessionIndexPath(projectDir);
+    const tmp = `${target}.tmp`;
+    await mkdir(path.dirname(target), { recursive: true });
+    await writeFile(tmp, JSON.stringify(index, null, 2), "utf8");
+    await rename(tmp, target);
+}
+export function getFlowSession(index, parentIssueNumber) {
+    return index.flows[String(parentIssueNumber)] ?? null;
+}
+/**
+ * 绑定 parentIssueNumber → sessionID。
+ * 双 session 检测（§10.3）：该 flow 已被另一 active session 绑定时拒绝。
+ */
+export async function bindSession(projectDir, parentIssueNumber, sessionID) {
+    const index = await readIndex(projectDir);
+    const key = String(parentIssueNumber);
+    const existing = index.flows[key];
+    if (existing && existing.sessionID !== sessionID && existing.status === "active") {
+        return {
+            ok: false,
+            code: "FLOW_SESSION_CONFLICT",
+            message: `Flow #${parentIssueNumber} is already bound to active session "${existing.sessionID}". Use flow_control takeover with user confirmation to take over.`,
+        };
+    }
+    const entry = {
+        sessionID,
+        status: "active",
+        continuationCount: existing && existing.sessionID === sessionID ? existing.continuationCount : 0,
+        updatedAt: Date.now(),
+    };
+    index.flows[key] = entry;
+    await writeIndex(projectDir, index);
+    return { ok: true, entry };
+}
+/**
+ * 接管绑定：旧 session 置 paused，新 session 绑定 active（R7）。
+ * 旧 session 为另一 active session 时要求 userConfirmed（§10.3）；
+ * 调用方还需将旧 session 的 goal status 置 paused（goalClient 层）。
+ */
+export async function takeoverSession(projectDir, parentIssueNumber, newSessionID, userConfirmed) {
+    const index = await readIndex(projectDir);
+    const key = String(parentIssueNumber);
+    const existing = index.flows[key];
+    if (existing && existing.sessionID !== newSessionID && existing.status === "active" && !userConfirmed) {
+        return {
+            ok: false,
+            code: "TAKEOVER_NOT_CONFIRMED",
+            message: `Flow #${parentIssueNumber} is bound to active session "${existing.sessionID}". Takeover requires user confirmation (user_confirmed: true).`,
+        };
+    }
+    if (existing) {
+        if (existing.sessionID === newSessionID) {
+            const entry = { ...existing, status: "active", updatedAt: Date.now() };
+            index.flows[key] = entry;
+            await writeIndex(projectDir, index);
+            return { ok: true, entry };
+        }
+        existing.status = "paused";
+        existing.updatedAt = Date.now();
+    }
+    const entry = {
+        sessionID: newSessionID,
+        status: "active",
+        continuationCount: 0,
+        updatedAt: Date.now(),
+    };
+    index.flows[key] = entry;
+    await writeIndex(projectDir, index);
+    return { ok: true, entry };
+}
+/** 更新已绑定 flow 的状态/计数；flow 未绑定时返回 null 且不创建 entry。 */
+export async function updateFlowSession(projectDir, parentIssueNumber, patch) {
+    const index = await readIndex(projectDir);
+    const key = String(parentIssueNumber);
+    const existing = index.flows[key];
+    if (!existing)
+        return null;
+    const entry = { ...existing, ...patch, updatedAt: Date.now() };
+    index.flows[key] = entry;
+    await writeIndex(projectDir, index);
+    return entry;
+}
+/** 解绑：仅当 sessionID 与当前绑定匹配时删除 entry。 */
+export async function unbindSession(projectDir, parentIssueNumber, sessionID) {
+    const index = await readIndex(projectDir);
+    const key = String(parentIssueNumber);
+    const existing = index.flows[key];
+    if (!existing || existing.sessionID !== sessionID)
+        return false;
+    delete index.flows[key];
+    await writeIndex(projectDir, index);
+    return true;
+}
+//# sourceMappingURL=session-index.js.map

package/dist/kernel/session-index.js.map

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

package/dist/kernel/setup.d.ts

@@ -0,0 +1,70 @@
+export type CmdResult = {
+    stdout: string;
+    stderr: string;
+};
+export type CmdFn = (args: string, cwd?: string) => Promise<CmdResult>;
+export declare function setSetupGitExecutor(fn: CmdFn | null): void;
+export declare function setSetupGhExecutor(fn: CmdFn | null): void;
+export interface SetupProbeReport {
+    gitAvailable: boolean;
+    ghAuthenticated: boolean;
+    hasRemote: boolean;
+    defaultBranch: string | null;
+    profileConfirmed: boolean;
+    tddCommandExecutable: boolean;
+    ciWorkflow: string | null;
+    releaseWorkflow: string | null;
+    contextMdPresent: boolean;
+    branchProtection: boolean;
+    versionRuleConfirmed: boolean;
+    developmentReady: boolean;
+    releaseReady: boolean;
+}
+/**
+ * 探测项目 setup 就绪度（PRD R10）。
+ * development-ready：git/gh + Profile 确认 + TDD 命令可执行 + CI workflow + 分支保护；
+ * release-ready：额外版本规则 + release workflow。
+ */
+export declare function probe(projectDir: string): Promise<SetupProbeReport>;
+/** 从 git remote URL 解析 GitHub owner/repo；非 GitHub 仓库返回 null */
+export declare function parseGithubRemote(url: string): {
+    owner: string;
+    repo: string;
+} | null;
+export interface GenerateWorkflowsInput {
+    prTitle: string;
+    defaultBranch?: string | null;
+    testCommand?: string | null;
+    tagFormat?: string | null;
+    releaseWorkflowPath?: string | null;
+}
+export interface GenerateWorkflowsResult {
+    ok: boolean;
+    created: string[];
+    existing: string[];
+    branch: string | null;
+    prNumber: number | null;
+    error?: string;
+}
+/**
+ * 缺失时生成 CI/release workflow 草案（技术栈无关，不硬编码包管理器），
+ * 创建 chore/setup-workflows 分支 + commit + push + Setup PR（人工合入）。
+ */
+export declare function generateWorkflows(projectDir: string, input: GenerateWorkflowsInput): Promise<GenerateWorkflowsResult>;
+/** CI workflow 草案：PR check 触发，运行 Profile 的测试命令（无则占位） */
+export declare function buildCiWorkflow(testCommand: string | null, defaultBranch: string | null): string;
+/** release workflow 草案：tag 触发，技术栈无关占位步骤 */
+export declare function buildReleaseWorkflow(tagFormat: string | null): string;
+export interface ConfirmProfileResult {
+    ok: boolean;
+    block?: string;
+    code?: string;
+    message?: string;
+}
+/** 由用户确认的 overrides 生成完整 `## Project Profile` 区块（未提供的键省略） */
+export declare function buildProfileBlock(overrides: Record<string, unknown>): string;
+/**
+ * 用户确认后把 Profile 区块写回根 AGENTS.md（§9.3）。
+ * 先读后写，按 key 串行（mutex）；testCommand 为必需键。
+ */
+export declare function confirmProjectProfile(projectDir: string, overridesJson: string): Promise<ConfirmProfileResult>;