@devcxl/opencode-cabbage 0.3.2 → 1.1.0

package/dist/kernel/worktree.d.ts

@@ -0,0 +1,45 @@
+import type { BranchType } from "./slug.js";
+type GitFn = (args: string) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function setWorktreeGitExecutor(fn: GitFn | null): void;
+export type WorktreeStartResult = {
+    ok: true;
+    branch: string;
+    path: string;
+    reused: boolean;
+} | {
+    ok: false;
+    code: "BRANCH_EXISTS" | "BRANCH_EXISTS_UNMERGED" | "BRANCH_MISMATCH" | "INVALID_SLUG" | "GIT_FAILED";
+    message: string;
+};
+export interface WorktreeStartInput {
+    projectDir: string;
+    slug: string;
+    base: string;
+    branchType?: BranchType;
+}
+/** 分支已存在（本地 ref），未合并 → BRANCH_EXISTS_UNMERGED；已合并残留 → BRANCH_EXISTS */
+export declare function worktreeStart(input: WorktreeStartInput): Promise<WorktreeStartResult>;
+export type DestroyReason = "OK" | "DIRTY_WORKTREE" | "PR_NOT_MERGED" | "BRANCH_NOT_PUSHED" | "NOT_FOUND";
+export type DestroyWorktreeResult = {
+    ok: true;
+    reason: "OK" | "NOT_FOUND";
+} | {
+    ok: false;
+    reason: "DIRTY_WORKTREE" | "PR_NOT_MERGED" | "BRANCH_NOT_PUSHED" | "GIT_FAILED";
+    message: string;
+};
+export interface DestroyWorktreeInput {
+    worktreeDir: string;
+    branch: string;
+    prMerged: boolean;
+    userConfirmed: boolean;
+}
+/**
+ * preflight 顺序：不存在 → 幂等跳过；脏 → 拒绝（不 --force）；
+ * 未合并 → 需 user_confirmed 且分支已推送；合并且干净 → 自动删除。
+ */
+export declare function destroyWorktree(input: DestroyWorktreeInput): Promise<DestroyWorktreeResult>;
+export {};

package/dist/kernel/worktree.js

@@ -0,0 +1,156 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import path from "node:path";
+import { symlink } from "node:fs/promises";
+import { branchFor, worktreeFor } from "./slug.js";
+import { pathExists } from "../util/fs.js";
+import { escapeShellArg } from "../util/shell.js";
+const execAsync = promisify(exec);
+let worktreeGitExecutor = null;
+export function setWorktreeGitExecutor(fn) {
+    worktreeGitExecutor = fn;
+}
+async function git(args) {
+    if (worktreeGitExecutor) {
+        return worktreeGitExecutor(args);
+    }
+    return execAsync(`git ${args}`);
+}
+/** 合法 kebab-case slug（与 slug.ts 一致；防御：从远端标题派生的 slug 也必须过此关） */
+const SLUG_SAFE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/** git 分支名安全白名单：仅允许分支名合法字符，杜绝 shell 元字符 */
+const BRANCH_SAFE = /^[A-Za-z0-9._/-]+$/;
+/** 分支已存在（本地 ref），未合并 → BRANCH_EXISTS_UNMERGED；已合并残留 → BRANCH_EXISTS */
+export async function worktreeStart(input) {
+    if (!SLUG_SAFE.test(input.slug)) {
+        return { ok: false, code: "INVALID_SLUG", message: `Invalid worktree slug format: ${input.slug}` };
+    }
+    if (!BRANCH_SAFE.test(input.base)) {
+        return { ok: false, code: "INVALID_SLUG", message: `Invalid base branch name: ${input.base}` };
+    }
+    const branch = branchFor(input.slug, input.branchType ?? "feat");
+    const worktreeDir = path.join(input.projectDir, worktreeFor(input.slug));
+    if (await pathExists(worktreeDir)) {
+        return reuseWorktree(worktreeDir, branch);
+    }
+    if (await branchExists(branch)) {
+        const merged = await isMergedToBase(branch, input.base);
+        return merged
+            ? { ok: false, code: "BRANCH_EXISTS", message: `branch ${branch} already exists and is merged; remove leftover branch manually` }
+            : { ok: false, code: "BRANCH_EXISTS_UNMERGED", message: `branch ${branch} already exists and is not merged into ${input.base}` };
+    }
+    try {
+        await git(`worktree add -b '${escapeShellArg(branch)}' '${escapeShellArg(worktreeDir)}' '${escapeShellArg(input.base)}'`);
+        await linkSharedNodeModules(input.projectDir, worktreeDir);
+        return { ok: true, branch, path: worktreeDir, reused: false };
+    }
+    catch (err) {
+        return { ok: false, code: "GIT_FAILED", message: String(err) };
+    }
+}
+/**
+ * worktree 依赖复用：主工作区已有 node_modules 且 worktree 无 → 符号链接
+ * （避免每个 worktree 重新 npm install 约 1-2 分钟；非 Node 项目自然跳过）。
+ * 失败不阻塞（模型可自行安装）。
+ */
+async function linkSharedNodeModules(projectDir, worktreeDir) {
+    try {
+        const src = path.join(projectDir, "node_modules");
+        const dst = path.join(worktreeDir, "node_modules");
+        if ((await pathExists(src)) && !(await pathExists(dst))) {
+            await symlink(src, dst, "dir");
+        }
+    }
+    catch {
+        // 链接失败（如跨文件系统/权限）：忽略，worktree 可自行安装
+    }
+}
+/** 目录已存在：HEAD 分支与期望分支一致才复用，否则报错 */
+async function reuseWorktree(worktreeDir, branch) {
+    try {
+        const { stdout } = await git(`-C '${escapeShellArg(worktreeDir)}' rev-parse --abbrev-ref HEAD`);
+        const current = stdout.trim();
+        if (current !== branch) {
+            return {
+                ok: false,
+                code: "BRANCH_MISMATCH",
+                message: `worktree at ${worktreeDir} is on branch ${current}, expected ${branch}`,
+            };
+        }
+        return { ok: true, branch, path: worktreeDir, reused: true };
+    }
+    catch (err) {
+        return { ok: false, code: "GIT_FAILED", message: String(err) };
+    }
+}
+async function branchExists(branch) {
+    try {
+        const { stdout } = await git(`rev-parse --verify 'refs/heads/${escapeShellArg(branch)}'`);
+        return stdout.trim() !== "";
+    }
+    catch {
+        return false;
+    }
+}
+/** branch 是否是 base 的祖先（已合并）；非祖先或 git 失败 → false */
+async function isMergedToBase(branch, base) {
+    try {
+        await git(`merge-base --is-ancestor '${escapeShellArg(branch)}' '${escapeShellArg(base)}'`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * preflight 顺序：不存在 → 幂等跳过；脏 → 拒绝（不 --force）；
+ * 未合并 → 需 user_confirmed 且分支已推送；合并且干净 → 自动删除。
+ */
+export async function destroyWorktree(input) {
+    if (!(await pathExists(input.worktreeDir))) {
+        return { ok: true, reason: "NOT_FOUND" };
+    }
+    if (await isDirty(input.worktreeDir)) {
+        return { ok: false, reason: "DIRTY_WORKTREE", message: `worktree ${input.worktreeDir} has uncommitted changes; refusing to remove without --force` };
+    }
+    if (!input.prMerged) {
+        if (!input.userConfirmed) {
+            return { ok: false, reason: "PR_NOT_MERGED", message: "PR is not merged; require user_confirmed to destroy the worktree" };
+        }
+        if (!(await isBranchPushed(input.branch))) {
+            return { ok: false, reason: "BRANCH_NOT_PUSHED", message: `branch ${input.branch} is not pushed to origin` };
+        }
+    }
+    try {
+        await git(`worktree remove '${escapeShellArg(input.worktreeDir)}'`);
+        await removeLocalBranch(input.branch);
+        return { ok: true, reason: "OK" };
+    }
+    catch (err) {
+        return { ok: false, reason: "GIT_FAILED", message: String(err) };
+    }
+}
+async function isDirty(worktreeDir) {
+    const { stdout } = await git(`-C '${escapeShellArg(worktreeDir)}' status --porcelain`);
+    return stdout.trim() !== "";
+}
+/** 分支是否已推送到 origin（ls-remote 命中 refs/heads/<branch>） */
+async function isBranchPushed(branch) {
+    try {
+        const { stdout } = await git(`ls-remote --heads origin '${escapeShellArg(branch)}'`);
+        return stdout.includes(`refs/heads/${branch}`);
+    }
+    catch {
+        return false;
+    }
+}
+async function removeLocalBranch(branch) {
+    try {
+        await git(`rev-parse --verify 'refs/heads/${escapeShellArg(branch)}'`);
+    }
+    catch {
+        return; // 本地分支不存在，跳过
+    }
+    await git(`branch -D '${escapeShellArg(branch)}'`);
+}
+//# sourceMappingURL=worktree.js.map

package/dist/kernel/worktree.js.map

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

package/dist/plugin/agents.d.ts

@@ -1,18 +1,8 @@
-export interface AgentTools {
-    read?: boolean;
-    bash?: boolean;
-    write?: boolean;
-    edit?: boolean;
-}
-export interface AgentCapabilities {
-    create_pr: boolean;
-    merge_pr: boolean;
-    modify_files: boolean;
-    run_tests: boolean;
-    push_branch: boolean;
-    approve_review: boolean;
-    complete_goal: boolean;
-}
+/**
+ * Agent frontmatter 的 permission 解析。
+ * 值可为字符串（如 "deny"、"npm test|git push"）或嵌套规则对象
+ * （OpenCode 语义：pattern → action，如 bash: { "*": "deny", "npm *": "allow" }）。
+ */
 export interface AgentPermission {
     [key: string]: string | Record<string, string> | undefined;
 }
@@ -21,8 +11,6 @@ export interface AgentEntry {
     description?: string;
     mode?: "subagent" | "primary" | "all";
     color?: string;
-    tools?: AgentTools;
-    capabilities?: AgentCapabilities;
     permission?: AgentPermission;
     prompt: string;
 }

package/dist/plugin/agents.js

@@ -20,27 +20,6 @@ function parseAgentFile(filePath) {
     const name = String(parsed.name ?? "");
     if (!name)
         return null;
-    const toolsRaw = parsed.tools;
-    const tools = toolsRaw && typeof toolsRaw === "object" && !Array.isArray(toolsRaw)
-        ? {
-            read: Boolean(toolsRaw.read),
-            bash: Boolean(toolsRaw.bash),
-            write: Boolean(toolsRaw.write),
-            edit: Boolean(toolsRaw.edit),
-        }
-        : undefined;
-    const capabilitiesRaw = parsed.capabilities;
-    const capabilities = capabilitiesRaw && typeof capabilitiesRaw === "object" && !Array.isArray(capabilitiesRaw)
-        ? {
-            create_pr: Boolean(capabilitiesRaw.create_pr),
-            merge_pr: Boolean(capabilitiesRaw.merge_pr),
-            modify_files: Boolean(capabilitiesRaw.modify_files),
-            run_tests: Boolean(capabilitiesRaw.run_tests),
-            push_branch: Boolean(capabilitiesRaw.push_branch),
-            approve_review: Boolean(capabilitiesRaw.approve_review),
-            complete_goal: Boolean(capabilitiesRaw.complete_goal),
-        }
-        : undefined;
     const permissionRaw = parsed.permission;
     const permission = permissionRaw && typeof permissionRaw === "object" && !Array.isArray(permissionRaw)
         ? Object.fromEntries(Object.entries(permissionRaw)
@@ -64,8 +43,6 @@ function parseAgentFile(filePath) {
         description: parsed.description,
         mode: parsed.mode,
         color: parsed.color,
-        tools,
-        capabilities,
         permission,
         prompt: body,
     };

package/dist/plugin/agents.js.map

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

package/dist/plugin/flow-control.d.ts

@@ -0,0 +1,91 @@
+import { type FlowStage } from "../kernel/flow.js";
+/** session client 最小可见面：get（caller 判定 + goal 读取）+ update（goal 写入） */
+export interface FlowControlSessionClient {
+    session: {
+        get(input: {
+            sessionID: string;
+        }): Promise<{
+            data?: {
+                parentID?: string | null;
+                metadata?: Record<string, unknown>;
+            };
+        }>;
+        update(input: {
+            sessionID: string;
+            metadata: Record<string, unknown>;
+        }): Promise<unknown>;
+    };
+}
+/** flow_control 工具依赖 */
+export interface FlowControlDeps {
+    projectDir: string;
+    sessionClient: FlowControlSessionClient;
+}
+export type FlowControlResponse = {
+    ok: boolean;
+    flow?: {
+        parentIssueNumber: number;
+        slug?: string;
+    };
+    status?: unknown;
+    stage?: FlowStage;
+    completedStages?: FlowStage[];
+    prNumber?: number;
+    worktreePath?: string;
+    branch?: string;
+    oldSessionID?: string | null;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+/**
+ * flow_control 工具工厂（spec §2.3）。
+ * caller 门禁：primary（除 complete-flow 外）；complete-flow 仅 goal-verify。
+ */
+export declare function createFlowControlTool(deps: FlowControlDeps): {
+    description: string;
+    args: {
+        op: import("zod").ZodEnum<{
+            status: "status";
+            "complete-flow": "complete-flow";
+            "planning-pr": "planning-pr";
+            "stage-start": "stage-start";
+            "stage-complete": "stage-complete";
+            "create-flow": "create-flow";
+            "planning-start": "planning-start";
+            "cancel-flow": "cancel-flow";
+            takeover: "takeover";
+        }>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        auto_mode: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        goal: import("zod").ZodOptional<import("zod").ZodString>;
+        acceptance_criteria: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        parent_issue_number: import("zod").ZodOptional<import("zod").ZodNumber>;
+        stage: import("zod").ZodOptional<import("zod").ZodEnum<{
+            tasks: "tasks";
+            code: "code";
+            requirements: "requirements";
+            design: "design";
+            review: "review";
+        }>>;
+        risk: import("zod").ZodOptional<import("zod").ZodEnum<{
+            high: "high";
+            low: "low";
+        }>>;
+        user_confirmed: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    };
+    execute(args: {
+        op: "status" | "complete-flow" | "planning-pr" | "stage-start" | "stage-complete" | "create-flow" | "planning-start" | "cancel-flow" | "takeover";
+        title?: string | undefined;
+        auto_mode?: boolean | undefined;
+        goal?: string | undefined;
+        acceptance_criteria?: string[] | undefined;
+        parent_issue_number?: number | undefined;
+        stage?: "tasks" | "code" | "requirements" | "design" | "review" | undefined;
+        risk?: "high" | "low" | undefined;
+        user_confirmed?: boolean | undefined;
+    }, context: import("@opencode-ai/plugin/tool").ToolContext): Promise<import("@opencode-ai/plugin/tool").ToolResult>;
+};
+/** 独立注册辅助：把 flow_control 挂到工具注册表（后续接线批次使用） */
+export declare function registerFlowControl(registry: Record<string, unknown>, deps: FlowControlDeps): void;