@devcxl/opencode-cabbage 0.3.2 → 1.1.0

package/dist/kernel/review.js

@@ -0,0 +1,82 @@
+/**
+ * 审查与合并 kernel 逻辑（spec §4.1，自 flowrun/merge.ts + ci.ts 迁入，逻辑不变）。
+ * - mergeTaskPR：标准化合并 PR（--match-head-commit 防偷换）
+ * - checkBranchProtection：默认分支保护探测
+ * - createRevertPR：回滚 PR
+ */
+import { gh as ghCli, parsePrUrlNumber } from "../util/gh.js";
+import { escapeShellArg } from "../util/shell.js";
+let mergeGhExecutor = null;
+export function setMergeGhExecutor(fn) {
+    mergeGhExecutor = fn;
+}
+async function gh(args) {
+    if (mergeGhExecutor) {
+        return mergeGhExecutor(args);
+    }
+    return ghCli(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 '${escapeShellArg(revertTitle)}' --body '${escapeShellArg(revertBody)}' --base main --head main`);
+        return { prNumber: parsePrUrlNumber(newPR) ?? 0 };
+    }
+    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,45 @@
+export type FlowSessionStatus = "active" | "paused" | "completed" | "cancelled";
+export interface FlowSessionEntry {
+    sessionID: string;
+    status: FlowSessionStatus;
+    continuationCount: number;
+    /** goal-verify 已完成验证（goal complete）——flow 级持久化，不依赖会话一致性 */
+    goalComplete?: boolean;
+    updatedAt: number;
+}
+export interface SessionIndex {
+    flows: Record<string, FlowSessionEntry>;
+}
+export declare function sessionIndexPath(projectDir: string): string;
+/** 读取索引；文件不存在或损坏时返回空索引。 */
+export declare function readIndex(projectDir: string): Promise<SessionIndex>;
+/** 原子写：先写临时文件（PID 后缀防跨进程 tmp 冲突）再 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 的状态/计数/goal 完成标记；flow 未绑定时返回 null 且不创建 entry。 */
+export declare function updateFlowSession(projectDir: string, parentIssueNumber: number, patch: Partial<Pick<FlowSessionEntry, "status" | "continuationCount" | "goalComplete">>): 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,136 @@
+/**
+ * Flow → session 轻量索引（替代 session-state.json）。
+ * 路径：.opencode/opencode-cabbage/session-index.json
+ * 作用：parentIssueNumber → sessionID 绑定；双 session 检测（R7）。
+ * 并发：全部 read-modify-write 按 projectDir 走 KeyedMutex 串行，防丢失更新。
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { PLUGIN_ID } from "../util/paths.js";
+import { KeyedMutex } from "./mutex.js";
+const VALID_STATUSES = ["active", "paused", "completed", "cancelled"];
+/** 按 projectDir 串行化索引读写（防并发 bind/update 互覆盖） */
+const indexMutex = new KeyedMutex();
+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: {} };
+    }
+}
+/** 原子写：先写临时文件（PID 后缀防跨进程 tmp 冲突）再 rename。 */
+export async function writeIndex(projectDir, index) {
+    const target = sessionIndexPath(projectDir);
+    const tmp = `${target}.${process.pid}.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) {
+    return indexMutex.runExclusive(projectDir, async () => {
+        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) {
+    return indexMutex.runExclusive(projectDir, async () => {
+        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 的状态/计数/goal 完成标记；flow 未绑定时返回 null 且不创建 entry。 */
+export async function updateFlowSession(projectDir, parentIssueNumber, patch) {
+    if (patch.status !== undefined && !VALID_STATUSES.includes(patch.status)) {
+        return null;
+    }
+    return indexMutex.runExclusive(projectDir, async () => {
+        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) {
+    return indexMutex.runExclusive(projectDir, async () => {
+        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,95 @@
+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 InitRepoInput {
+    /** 创建 GitHub 远端（gh repo create --source . --push） */
+    createRemote?: boolean;
+    /** 远端仓库名（缺省用目录名） */
+    remoteName?: string;
+    /** 远端仓库私有 */
+    private?: boolean;
+}
+export interface InitRepoResult {
+    ok: boolean;
+    initialized: boolean;
+    committed: boolean;
+    remoteCreated: boolean;
+    error?: string;
+}
+/**
+ * 初始化 git 仓库（空目录场景）：git init → 首次提交 → 可选 gh repo create + push。
+ * 已初始化的仓库跳过对应步骤（幂等）。
+ */
+export declare function initRepo(projectDir: string, input: InitRepoInput): Promise<InitRepoResult>;
+export interface GenerateWorkflowsInput {
+    prTitle: string;
+    defaultBranch?: string | null;
+    testCommand?: string | null;
+    tagFormat?: string | null;
+    releaseWorkflowPath?: string | null;
+}
+export interface GenerateWorkflowsResult {
+    ok: boolean;
+    created: string[];
+    updated: string[];
+    existing: string[];
+    branch: string | null;
+    prNumber: number | null;
+    error?: string;
+}
+/**
+ * 缺失时生成 CI/release workflow 草案（技术栈无关，不硬编码包管理器），
+ * 创建 chore/setup-workflows 分支 + commit + push + Setup PR（人工合入）。
+ * 幂等增强：
+ * - 已存在的 workflow 含占位符（Profile 未确认时生成）→ 更新注入 test command（updated）
+ * - 分支已存在（上次 PR 创建失败残留的 orphan 分支）→ 复用分支，不重复 checkout -b
+ * - 分支已有 open PR → 复用 PR 编号，不重复创建（补建场景）
+ */
+export declare function generateWorkflows(projectDir: string, input: GenerateWorkflowsInput): Promise<GenerateWorkflowsResult>;
+/** CI workflow 草案：PR check 触发，运行 Profile 的测试命令（无则占位）；纯文档 PR 不触发（paths-ignore，技术栈无关） */
+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>;