@devcxl/opencode-cabbage 0.3.1 → 1.0.0

package/dist/plugin/release-control.js

@@ -0,0 +1,304 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tool } from "@opencode-ai/plugin/tool";
+import { gh as ghCli } from "../util/gh.js";
+import { escapeShellArg } from "../util/shell.js";
+import { readProjectProfile } from "../kernel/profile.js";
+import { requireCaller } from "../kernel/caller.js";
+import { classifyChanges, buildTag, buildReleaseNotes, parseVersion, parseVersionFileSpec, proposeVersion, readVersionFromJson, updateVersionInJson, latestTag, listCommitsSinceTag, validateTagImmutability, } from "../kernel/release.js";
+let releaseGhExecutor = null;
+let releaseGitExecutor = null;
+export function setReleaseControlGhExecutor(fn) {
+    releaseGhExecutor = fn;
+}
+export function setReleaseControlGitExecutor(fn) {
+    releaseGitExecutor = fn;
+}
+const execAsync = promisify(exec);
+async function runGh(args) {
+    if (releaseGhExecutor)
+        return releaseGhExecutor(args);
+    return ghCli(args);
+}
+async function runGit(cwd, args) {
+    if (releaseGitExecutor)
+        return releaseGitExecutor(args, cwd);
+    return execAsync(`git ${args}`, { cwd });
+}
+function releaseBranch(version) {
+    return `release/v${version}`;
+}
+/** 聚合上一 tag 后 main 的变更并分类；无 tag 时返回空变更集 */
+async function collectChanges(profile) {
+    const tag = await latestTag(runGh);
+    if (!tag)
+        return { tag: null, changes: [] };
+    const commits = await listCommitsSinceTag(tag, "main", runGh);
+    return { tag, changes: classifyChanges(commits) };
+}
+async function readCurrentVersion(profile, projectDir) {
+    const spec = parseVersionFileSpec(profile.versionFile ?? "");
+    if (!spec)
+        return null;
+    try {
+        const raw = await readFile(join(projectDir, spec.path), "utf8");
+        return readVersionFromJson(raw, spec.key);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeVersionFile(profile, projectDir, version) {
+    const spec = parseVersionFileSpec(profile.versionFile ?? "");
+    if (!spec)
+        return "Error: Profile version file 配置无效（期望 `path[ $.key]`，如 `package.json $.version`）";
+    try {
+        const path = join(projectDir, spec.path);
+        const raw = await readFile(path, "utf8");
+        await writeFile(path, updateVersionInJson(raw, spec.key, version));
+        return null;
+    }
+    catch (err) {
+        return `Error: 无法更新版本文件：${String(err)}`;
+    }
+}
+// ─── 工具 ───
+/**
+ * release_control — 版本提议 / Release PR / 合并打 tag / release workflow 监控。
+ * 技术栈无关：版本读写规则与 tag 格式全部来自 Profile（§9.1），不硬编码 npm。
+ */
+export function createReleaseControlTool(deps) {
+    return tool({
+        description: `Control the release lifecycle (R9, tech-stack agnostic).
+
+Ops:
+- propose-version: aggregate all changes on main since the last tag, classify them
+  (feature/fix/maintenance/docs + breaking), and propose a SemVer bump.
+  Unclassified changes block the proposal until classified. Returns the proposed
+  version and its tag.
+- open-release-pr: create the release branch, bump the version file (per Profile
+  version write rule), generate Release Notes, push, and open a Release PR.
+- merge-release-pr: after CI passes and human approval, merge the Release PR,
+  verify the merge SHA, and push the tag (tags are immutable, never re-pointed).
+- monitor: poll the project GitHub Actions release workflow run until success;
+  a failed run is rerun once.`,
+        args: {
+            op: tool.schema.enum(["propose-version", "open-release-pr", "merge-release-pr", "monitor"])
+                .describe("Release control operation"),
+            proposed_version: tool.schema.string().describe("Proposed semantic version (x.y.z), required for open-release-pr / merge-release-pr"),
+            release_notes: tool.schema.string().describe("Optional override for the Release Notes body"),
+            user_confirmed: tool.schema.boolean().describe("Human approval — required for merge-release-pr (release is a manual flow)"),
+        },
+        async execute(args, ctx) {
+            try {
+                const op = args.op;
+                // caller 门禁：release 为人工流程，仅 primary 可调用（§2.2/§2.3），fail-closed
+                const denied = await requireCaller({ agent: ctx.agent, sessionID: ctx.sessionID }, ["primary"], op, deps.sessionClient);
+                if (denied)
+                    return `Error: ${denied}`;
+                const profile = await readProjectProfile(deps.projectDir);
+                switch (op) {
+                    case "propose-version":
+                        return proposeVersionOp(profile, deps.projectDir);
+                    case "open-release-pr":
+                        return openReleasePrOp(profile, args, deps.projectDir);
+                    case "merge-release-pr":
+                        return mergeReleasePrOp(profile, args);
+                    case "monitor":
+                        return monitorOp(profile);
+                    default:
+                        return `Error: unknown operation "${op}"`;
+                }
+            }
+            catch (err) {
+                return `Error: INTERNAL_ERROR — ${String(err)}`;
+            }
+        },
+    });
+}
+async function proposeVersionOp(profile, projectDir) {
+    if (!profile.versionFile) {
+        return "Error: Profile 缺少 version file 配置（先运行 /setup 确认 Release Profile）";
+    }
+    const current = await readCurrentVersion(profile, projectDir);
+    if (current === null) {
+        return `Error: 无法从版本文件（${profile.versionFile}）读取当前版本`;
+    }
+    const { tag, changes } = await collectChanges(profile);
+    if (!tag) {
+        return "Error: 仓库尚无 tag，无法聚合上一 tag 后的变更；请先人工创建基线 tag";
+    }
+    const unclassified = changes.filter(c => c.category === "unclassified");
+    if (unclassified.length > 0) {
+        const list = unclassified.map(c => `${c.sha.slice(0, 7)} ${c.title}`).join("\n");
+        return `Error: ${unclassified.length} 个未分类变更，版本提议前必须分类（propose-version 不产出版本号）：\n${list}`;
+    }
+    const result = proposeVersion(current, changes);
+    if (!result.ok) {
+        return `Error: ${result.message}`;
+    }
+    const tagFormat = profile.tagFormat ?? "v{version}";
+    const nextTag = buildTag(result.proposed, tagFormat);
+    const summary = changes
+        .filter(c => c.category !== "unclassified")
+        .reduce((acc, c) => {
+        acc[c.category] = (acc[c.category] ?? 0) + 1;
+        return acc;
+    }, {});
+    return [
+        `Version proposal: ${current} → ${result.proposed} (${result.type} bump)`,
+        `Tag: ${nextTag}`,
+        `Changes since ${tag}: ${changes.length} (${Object.entries(summary).map(([k, v]) => `${k}: ${v}`).join(", ")})`,
+        "",
+        buildReleaseNotes(result.proposed, changes),
+    ].join("\n");
+}
+async function openReleasePrOp(profile, args, projectDir) {
+    const version = String(args.proposed_version ?? "");
+    const parsed = parseVersion(version);
+    if (!parsed) {
+        return "Error: proposed_version 必填且必须为 x.y.z（先调用 propose-version 获取提议版本）";
+    }
+    if (!profile.versionFile) {
+        return "Error: Profile 缺少 version file 配置（先运行 /setup 确认 Release Profile）";
+    }
+    const tagFormat = profile.tagFormat ?? "v{version}";
+    const tag = buildTag(version, tagFormat);
+    const branch = releaseBranch(version);
+    const mainSha = (await runGh(`api repos/{owner}/{repo}/commits/main --jq .sha`)).stdout.trim();
+    const immutability = await validateTagImmutability(tag, mainSha, runGh);
+    if (!immutability.ok) {
+        return `Error: ${immutability.message}`;
+    }
+    try {
+        await runGit(projectDir, "fetch origin");
+        await runGit(projectDir, `checkout -b ${branch} origin/main`);
+    }
+    catch (err) {
+        return `Error: 创建 release branch 失败：${String(err)}`;
+    }
+    const writeError = await writeVersionFile(profile, projectDir, version);
+    if (writeError)
+        return writeError;
+    try {
+        await runGit(projectDir, `add ${parseVersionFileSpec(profile.versionFile)?.path}`);
+        await runGit(projectDir, `commit -m "release: ${tag}"`);
+    }
+    catch (err) {
+        return `Error: 提交版本更新失败：${String(err)}`;
+    }
+    let notes = String(args.release_notes ?? "");
+    if (notes === "") {
+        const { changes } = await collectChanges(profile);
+        notes = buildReleaseNotes(version, changes);
+    }
+    try {
+        await runGit(projectDir, `push -u origin ${branch}`);
+    }
+    catch (err) {
+        return `Error: push release branch 失败：${String(err)}`;
+    }
+    try {
+        const { stdout } = await runGh(`pr create --base main --head ${branch} --title 'release: ${tag}' --body '${escapeShellArg(notes)}' --json number --jq .number`);
+        return `Release PR created: #${stdout.trim()} (branch ${branch}, tag ${tag})`;
+    }
+    catch (err) {
+        return `Error: 创建 Release PR 失败：${String(err)}`;
+    }
+}
+async function mergeReleasePrOp(profile, args) {
+    const version = String(args.proposed_version ?? "");
+    if (!parseVersion(version)) {
+        return "Error: proposed_version 必填且必须为 x.y.z";
+    }
+    // 人工批准门禁：release 为人工流程（R9），必须显式 user_confirmed
+    if (args.user_confirmed !== true) {
+        return "Error: merge-release-pr 需要人工批准（user_confirmed: true）。请先审查 Release PR 与版本提议后再确认。";
+    }
+    const branch = releaseBranch(version);
+    const prNumber = (await runGh(`pr list --head ${branch} --json number --jq '.[0].number'`)).stdout.trim();
+    if (!prNumber || prNumber === "null") {
+        return "Error: 未找到对应 Release PR（branch: " + branch + "）";
+    }
+    // CI 校验：读取 statusCheckRollup；进行中项显式标记 IN_PROGRESS，不得放行
+    const rollup = (await runGh(`pr view ${prNumber} --json statusCheckRollup --jq '[.statusCheckRollup[] | if .conclusion == null then "IN_PROGRESS" else .conclusion end] | unique'`)).stdout.trim();
+    let conclusions;
+    try {
+        conclusions = JSON.parse(rollup);
+    }
+    catch {
+        return `Error: 无法解析 PR #${prNumber} 的 CI checks 状态`;
+    }
+    if (conclusions.length === 0) {
+        return `Error: PR #${prNumber} 没有任何 CI checks 报告，无法自动合并（需要 CI 或人工介入）`;
+    }
+    if (conclusions.includes("IN_PROGRESS")) {
+        return `Error: PR #${prNumber} 的 CI checks 尚未全部完成，请等待完成后再重试`;
+    }
+    if (conclusions.includes("FAILURE") || conclusions.includes("CANCELLED") || conclusions.includes("ACTION_REQUIRED")) {
+        return `Error: PR #${prNumber} 的 CI checks 存在失败项（${conclusions.join(", ")}），无法合并`;
+    }
+    if (!conclusions.every(c => c === "SUCCESS" || c === "NEUTRAL" || c === "SKIPPED")) {
+        return `Error: PR #${prNumber} 的 CI checks 存在未知结论（${conclusions.join(", ")}），无法合并`;
+    }
+    try {
+        await runGh(`pr merge ${prNumber} --squash --delete-branch`);
+    }
+    catch (err) {
+        return `Error: 合并 Release PR 失败：${String(err)}`;
+    }
+    const mergeSha = (await runGh(`pr view ${prNumber} --json mergeCommit --jq '.mergeCommit.oid'`)).stdout.trim();
+    if (!mergeSha || mergeSha === "null") {
+        return "Error: 无法读取 merge commit SHA";
+    }
+    const tagFormat = profile.tagFormat ?? "v{version}";
+    const tag = buildTag(version, tagFormat);
+    const immutability = await validateTagImmutability(tag, mergeSha, runGh);
+    if (!immutability.ok) {
+        return `Error: ${immutability.message}`;
+    }
+    try {
+        await runGh(`api repos/{owner}/{repo}/git/refs -f ref=refs/tags/${tag} -f sha=${mergeSha}`);
+    }
+    catch (err) {
+        return `Error: 打 tag 失败（可能已存在）：${String(err)}`;
+    }
+    return `Merged #${prNumber} and tagged ${tag} @ ${mergeSha.slice(0, 7)}`;
+}
+async function monitorOp(profile) {
+    const workflow = profile.releaseWorkflowPath;
+    if (!workflow) {
+        return "Error: Profile 缺少 release workflow 配置（release-ready 未满足，先运行 /setup）";
+    }
+    const { stdout } = await runGh(`run list --workflow ${workflow} --limit 1 --json databaseId,status,conclusion,headBranch --jq '.[0]'`);
+    const runJson = stdout.trim();
+    if (!runJson || runJson === "null") {
+        return "No release workflow runs found yet.";
+    }
+    let run;
+    try {
+        run = JSON.parse(runJson);
+    }
+    catch {
+        return "Error: 无法解析 release workflow run 状态（gh 输出异常）";
+    }
+    if (run.status !== "completed") {
+        return `Release workflow run #${run.databaseId} is ${run.status} (branch ${run.headBranch}) — not finished, check again later`;
+    }
+    if (run.conclusion === "success") {
+        return `Release workflow run #${run.databaseId} succeeded — release complete`;
+    }
+    if (run.conclusion === "failure") {
+        try {
+            await runGh(`run rerun ${run.databaseId}`);
+            return `Release workflow run #${run.databaseId} failed — rerun triggered, check again later`;
+        }
+        catch (err) {
+            return `Release workflow run #${run.databaseId} failed and rerun failed: ${String(err)}`;
+        }
+    }
+    return `Release workflow run #${run.databaseId} ${run.conclusion} — needs human intervention (Corrective Flow + new version)`;
+}
+//# sourceMappingURL=release-control.js.map

package/dist/plugin/release-control.js.map

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

package/dist/plugin/server.d.ts

@@ -1,4 +1,18 @@
 import type { Plugin } from "@opencode-ai/plugin";
+import type { ContextBlock } from "../kernel/context.js";
+export interface FirstUserInjectionInput {
+    hasGoal: boolean;
+    isSubAgent: boolean;
+    contextBlock: ContextBlock | null;
+    bootstrap: string;
+}
+/**
+ * 决定首条 user 消息注入内容：
+ * - Primary（goal 激活）→ bootstrap + Project Context 块
+ * - 子 agent → 仅 Project Context 块
+ * - 其他 → 不注入
+ */
+export declare function buildFirstUserInjection(input: FirstUserInjectionInput): string | null;
 interface AgentToolConfig {
     tools?: Record<string, boolean>;
 }
@@ -6,5 +20,10 @@ interface GoalToolConfig extends AgentToolConfig {
     agent?: Record<string, unknown>;
 }
 export declare function configureGoalTools(config: GoalToolConfig): void;
+/**
+ * config 层第二道门（spec §2.2）：按 caller 矩阵把 5 个生命周期工具
+ * 对每个 agent 置 true/false。agent 名 → 角色映射与 caller.ts ROLE_BY_AGENT 一致。
+ */
+export declare function configureLifecycleTools(config: GoalToolConfig): void;
 export declare function createOpencodeCabbage(packageRoot: string): Plugin;
 export {};