@devcxl/opencode-cabbage 1.3.0 → 2.0.0

package/dist/plugin/cabbage-cli.js

@@ -0,0 +1,92 @@
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+import { ensureInstalledDir } from "./install-dir.js";
+const execFileAsync = promisify(execFile);
+/** CLI 释放目录（按插件版本隔离）；env CABBAGE_CLI_DIR 可覆盖，方便测试。 */
+function resolveCliDir(version) {
+    if (process.env.CABBAGE_CLI_DIR) {
+        return path.join(process.env.CABBAGE_CLI_DIR, `cli@${version}`);
+    }
+    return path.join(homedir(), ".config", "opencode", "cabbage", `cli@${version}`);
+}
+/** 探测可用的 Python 解释器（python3 优先）；均不可用返回 null。 */
+export async function detectPython() {
+    for (const candidate of ["python3", "python"]) {
+        try {
+            await execFileAsync(candidate, ["--version"], { timeout: 5_000 });
+            return candidate;
+        }
+        catch {
+            // 尝试下一个候选
+        }
+    }
+    return null;
+}
+function errorMessage(err) {
+    return err?.message ?? String(err);
+}
+export async function setupCabbageCli(packageRoot, version) {
+    const sourceDir = path.join(packageRoot, "vendor", "cabbage", "cabbage_cli");
+    const python = await detectPython();
+    if (!python) {
+        return {
+            available: false,
+            python: null,
+            dir: null,
+            version: null,
+            reason: "Python 3.10+ not found on PATH; install Python or the bundled cabbage engine cannot run",
+        };
+    }
+    const dir = resolveCliDir(version);
+    try {
+        // Python 包必须位于 <dir>/cabbage_cli（PYTHONPATH=<dir> 时可按包名导入）
+        await ensureInstalledDir({
+            sourceDir,
+            destDir: path.join(dir, "cabbage_cli"),
+            isComplete: async (d) => existsSync(path.join(d, "__main__.py")),
+        });
+    }
+    catch (err) {
+        return { available: false, python, dir: null, version: null, reason: `failed to install the bundled cabbage CLI: ${errorMessage(err)}` };
+    }
+    try {
+        const { stdout } = await execFileAsync(python, ["-m", "cabbage_cli", "--version"], {
+            cwd: dir,
+            env: { ...process.env, PYTHONPATH: dir },
+            timeout: 15_000,
+        });
+        return { available: true, python, dir, version: stdout.trim(), reason: null };
+    }
+    catch (err) {
+        return { available: false, python, dir, version: null, reason: `bundled cabbage CLI failed to run: ${errorMessage(err)}` };
+    }
+}
+/**
+ * 执行一次 cabbage 子命令。非零退出以结果返回（code/stdout/stderr），
+ * 仅进程无法启动（如解释器消失）才抛错——调用方按 CLI 语义处理退出码。
+ */
+export async function runCabbage(cli, args, cwd) {
+    if (!cli.available || !cli.python || !cli.dir) {
+        throw new Error(cli.reason ?? "cabbage CLI unavailable");
+    }
+    try {
+        const { stdout, stderr } = await execFileAsync(cli.python, ["-m", "cabbage_cli", ...args], {
+            cwd,
+            env: { ...process.env, PYTHONPATH: cli.dir },
+            timeout: 120_000,
+            maxBuffer: 4 * 1024 * 1024,
+        });
+        return { code: 0, stdout: stdout.toString(), stderr: stderr.toString() };
+    }
+    catch (err) {
+        const e = err;
+        if (typeof e.code === "number") {
+            return { code: e.code, stdout: String(e.stdout ?? ""), stderr: String(e.stderr ?? "") };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=cabbage-cli.js.map

package/dist/plugin/cabbage-cli.js.map

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

package/dist/plugin/cabbage-tool.d.ts

@@ -0,0 +1,103 @@
+import type { CabbageCliRuntime } from "./cabbage-cli.js";
+/**
+ * `cabbage` 工具：把内置 Cabbage 引擎（变更记录 / 任务与文档 / 验证与归档）暴露为
+ * 一等工具。与 goal 工具相同的双层门控：权限规则层（agent permissions）隐藏/放行，
+ * 工具内自检兜底（仅 dev-lifecycle 编排器可用）。
+ */
+export declare const CABBAGE_ALLOWED_AGENTS: Set<string>;
+export interface CabbageToolInput {
+    op: "init" | "new" | "status" | "next" | "impact" | "validate" | "verify" | "gate" | "sync" | "archive" | "tasks" | "discard" | "adopt";
+    change?: string;
+    stage?: string;
+    target?: string;
+    type?: "change" | "incident";
+    impact?: string[];
+}
+export interface CabbageToolContext {
+    sessionID: string;
+    agent?: string;
+}
+export interface CabbageToolResult {
+    content: string;
+}
+export declare const CABBAGE_TOOL_INPUT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly op: {
+            readonly type: "string";
+            readonly enum: readonly ["init", "new", "status", "next", "impact", "validate", "verify", "gate", "sync", "archive", "tasks", "discard", "adopt"];
+            readonly description: "Cabbage operation";
+        };
+        readonly change: {
+            readonly type: "string";
+            readonly description: "Change id in kebab-case (required by new/next/impact/verify/gate/sync/archive/tasks/discard; optional for status/validate)";
+        };
+        readonly stage: {
+            readonly type: "string";
+            readonly description: "Stage id for verify — use the stage ids that `next` reports (new projects: `tasks`)";
+        };
+        readonly target: {
+            readonly type: "string";
+            readonly description: "Gate target for gate: a stage id (checks the stages before it), or `merge` / `archive`";
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["change", "incident"];
+            readonly description: "Change type for new (default: change)";
+        };
+        readonly impact: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "Impact entries for impact, e.g. [\"api=true\", \"design=true\"] — design/rfc/adr/api/database/security/deployment open specialist documents";
+        };
+    };
+    readonly required: readonly ["op"];
+    readonly additionalProperties: false;
+};
+export declare const CABBAGE_TOOL_DESCRIPTION = "Manage this project's Cabbage change records \u2014 the built-in tasks-and-docs workflow (the engine is bundled; Python 3.10+ required).\n\nOps:\n- init: scaffold .cabbage/ (workflows, docs skeleton, CI template, vendored CLI) \u2014 run once per project\n- adopt: inventory existing markdown outside the docs tree and write .cabbage/adoption-report.md (advisory; moves stay manual)\n- new: create a record (type: change|incident; change: kebab-case id)\n- status: list active records and per-stage state (change optional)\n- next: show ready and blocked stages for a record\n- impact: declare risks, e.g. impact:[\"api=true\",\"design=true\"] \u2014 opens specialist docs (design/rfc/adr/api/database/security/release)\n- verify: verify one stage artifact (stage required; use ids from next)\n- gate: check a milestone (target: stage id | merge | archive)\n- validate: structural checks (all records when change omitted)\n- sync: copy mapped documents into docs/\n- archive: gate, sync, and move the record to .cabbage/archive/ (only after the merge is confirmed)\n- tasks: read-only task checklist view\n- discard: delete an abandoned record\n\nLight path: new \u2192 fill tasks.md (Goal/Design/Tasks/Verification) \u2192 verify tasks \u2192 gate merge \u2192 archive after merge. Records live in .cabbage/changes/<id>/; state.json and change.yaml are CLI-owned \u2014 never edit them by hand.";
+export declare function buildCabbageTool(cli: CabbageCliRuntime, projectDir: string): {
+    name: string;
+    description: string;
+    input: {
+        readonly type: "object";
+        readonly properties: {
+            readonly op: {
+                readonly type: "string";
+                readonly enum: readonly ["init", "new", "status", "next", "impact", "validate", "verify", "gate", "sync", "archive", "tasks", "discard", "adopt"];
+                readonly description: "Cabbage operation";
+            };
+            readonly change: {
+                readonly type: "string";
+                readonly description: "Change id in kebab-case (required by new/next/impact/verify/gate/sync/archive/tasks/discard; optional for status/validate)";
+            };
+            readonly stage: {
+                readonly type: "string";
+                readonly description: "Stage id for verify — use the stage ids that `next` reports (new projects: `tasks`)";
+            };
+            readonly target: {
+                readonly type: "string";
+                readonly description: "Gate target for gate: a stage id (checks the stages before it), or `merge` / `archive`";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["change", "incident"];
+                readonly description: "Change type for new (default: change)";
+            };
+            readonly impact: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Impact entries for impact, e.g. [\"api=true\", \"design=true\"] — design/rfc/adr/api/database/security/deployment open specialist documents";
+            };
+        };
+        readonly required: readonly ["op"];
+        readonly additionalProperties: false;
+    };
+    options: {
+        permission: string;
+    };
+    execute(input: CabbageToolInput, context: CabbageToolContext): Promise<CabbageToolResult>;
+};

package/dist/plugin/cabbage-tool.js

@@ -0,0 +1,169 @@
+import { runCabbage } from "./cabbage-cli.js";
+/**
+ * `cabbage` 工具：把内置 Cabbage 引擎（变更记录 / 任务与文档 / 验证与归档）暴露为
+ * 一等工具。与 goal 工具相同的双层门控：权限规则层（agent permissions）隐藏/放行，
+ * 工具内自检兜底（仅 dev-lifecycle 编排器可用）。
+ */
+export const CABBAGE_ALLOWED_AGENTS = new Set(["dev-lifecycle"]);
+const OPS = ["init", "new", "status", "next", "impact", "validate", "verify", "gate", "sync", "archive", "tasks", "discard", "adopt"];
+export const CABBAGE_TOOL_INPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        op: {
+            type: "string",
+            enum: [...OPS],
+            description: "Cabbage operation",
+        },
+        change: {
+            type: "string",
+            description: "Change id in kebab-case (required by new/next/impact/verify/gate/sync/archive/tasks/discard; optional for status/validate)",
+        },
+        stage: {
+            type: "string",
+            description: "Stage id for verify — use the stage ids that `next` reports (new projects: `tasks`)",
+        },
+        target: {
+            type: "string",
+            description: "Gate target for gate: a stage id (checks the stages before it), or `merge` / `archive`",
+        },
+        type: {
+            type: "string",
+            enum: ["change", "incident"],
+            description: "Change type for new (default: change)",
+        },
+        impact: {
+            type: "array",
+            items: { type: "string" },
+            description: "Impact entries for impact, e.g. [\"api=true\", \"design=true\"] — design/rfc/adr/api/database/security/deployment open specialist documents",
+        },
+    },
+    required: ["op"],
+    additionalProperties: false,
+};
+export const CABBAGE_TOOL_DESCRIPTION = `Manage this project's Cabbage change records — the built-in tasks-and-docs workflow (the engine is bundled; Python 3.10+ required).
+
+Ops:
+- init: scaffold .cabbage/ (workflows, docs skeleton, CI template, vendored CLI) — run once per project
+- adopt: inventory existing markdown outside the docs tree and write .cabbage/adoption-report.md (advisory; moves stay manual)
+- new: create a record (type: change|incident; change: kebab-case id)
+- status: list active records and per-stage state (change optional)
+- next: show ready and blocked stages for a record
+- impact: declare risks, e.g. impact:["api=true","design=true"] — opens specialist docs (design/rfc/adr/api/database/security/release)
+- verify: verify one stage artifact (stage required; use ids from next)
+- gate: check a milestone (target: stage id | merge | archive)
+- validate: structural checks (all records when change omitted)
+- sync: copy mapped documents into docs/
+- archive: gate, sync, and move the record to .cabbage/archive/ (only after the merge is confirmed)
+- tasks: read-only task checklist view
+- discard: delete an abandoned record
+
+Light path: new → fill tasks.md (Goal/Design/Tasks/Verification) → verify tasks → gate merge → archive after merge. Records live in .cabbage/changes/<id>/; state.json and change.yaml are CLI-owned — never edit them by hand.`;
+function buildArgs(input) {
+    const change = input.change?.trim();
+    const requireChange = (op) => change ?? { error: `Error: op \`${op}\` requires \`change\`.` };
+    switch (input.op) {
+        case "init":
+            return ["init"];
+        case "adopt":
+            return ["adopt"];
+        case "new": {
+            if (!change || typeof change !== "string")
+                return { error: "Error: op `new` requires `change` (kebab-case id)." };
+            return ["new", input.type ?? "change", change];
+        }
+        case "status":
+            return change ? ["status", change] : ["status"];
+        case "next": {
+            const c = requireChange("next");
+            if (typeof c !== "string")
+                return c;
+            return ["next", c];
+        }
+        case "impact": {
+            const c = requireChange("impact");
+            if (typeof c !== "string")
+                return c;
+            const entries = (input.impact ?? []).filter((x) => typeof x === "string" && x.trim() !== "");
+            if (entries.length === 0)
+                return { error: "Error: op `impact` requires a non-empty `impact` array, e.g. [\"api=true\"]." };
+            return ["impact", c, ...entries.flatMap((entry) => ["--set", entry.trim()])];
+        }
+        case "validate":
+            return change ? ["validate", change] : ["validate", "--all"];
+        case "verify": {
+            const c = requireChange("verify");
+            if (typeof c !== "string")
+                return c;
+            const stage = input.stage?.trim();
+            if (!stage)
+                return { error: "Error: op `verify` requires `stage` (use the ids from `next`)." };
+            return ["verify", c, stage];
+        }
+        case "gate": {
+            const c = requireChange("gate");
+            if (typeof c !== "string")
+                return c;
+            const target = input.target?.trim();
+            if (!target)
+                return { error: "Error: op `gate` requires `target` (a stage id, `merge`, or `archive`)." };
+            return ["gate", c, target];
+        }
+        case "sync": {
+            const c = requireChange("sync");
+            if (typeof c !== "string")
+                return c;
+            return ["sync", c];
+        }
+        case "archive": {
+            const c = requireChange("archive");
+            if (typeof c !== "string")
+                return c;
+            return ["archive", c];
+        }
+        case "tasks": {
+            const c = requireChange("tasks");
+            if (typeof c !== "string")
+                return c;
+            return ["tasks", c];
+        }
+        case "discard": {
+            const c = requireChange("discard");
+            if (typeof c !== "string")
+                return c;
+            return ["discard", c];
+        }
+        default:
+            return { error: `Error: unknown op \`${String(input.op)}\`.` };
+    }
+}
+export function buildCabbageTool(cli, projectDir) {
+    return {
+        name: "cabbage",
+        description: CABBAGE_TOOL_DESCRIPTION,
+        input: CABBAGE_TOOL_INPUT_SCHEMA,
+        options: { permission: "cabbage" },
+        async execute(input, context) {
+            if (!context.agent || !CABBAGE_ALLOWED_AGENTS.has(context.agent)) {
+                return { content: `Error: the cabbage tool is restricted to the dev-lifecycle orchestrator. Agent "${context.agent ?? "unknown"}" is not authorized.` };
+            }
+            if (!cli.available) {
+                return { content: `Error: cabbage CLI unavailable: ${cli.reason ?? "unknown reason"}. The bundled engine needs Python 3.10+; install it and restart.` };
+            }
+            const built = buildArgs(input);
+            if ("error" in built)
+                return { content: built.error };
+            try {
+                const result = await runCabbage(cli, built, projectDir);
+                const parts = [result.stdout.trim()];
+                if (result.stderr.trim())
+                    parts.push(`[stderr]\n${result.stderr.trim()}`);
+                parts.push(`exit=${result.code}`);
+                return { content: parts.filter(Boolean).join("\n") };
+            }
+            catch (err) {
+                return { content: `Error: failed to run cabbage ${built.join(" ")}: ${err?.message ?? err}` };
+            }
+        },
+    };
+}
+//# sourceMappingURL=cabbage-tool.js.map

package/dist/plugin/cabbage-tool.js.map

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

package/dist/plugin/commands.d.ts

@@ -1,3 +1,13 @@
+/**
+ * 解析并剥离 Markdown 文件的 frontmatter
+ *
+ * Frontmatter 是位于文件开头的 --- 包裹的 YAML 格式元数据，
+ * 例如：---\ntitle: foo\n---\n正文内容
+ */
+export declare function extractAndStripFrontmatter(content: string): {
+    frontmatter: Record<string, string>;
+    content: string;
+};
 /** 解析后的 slash command 结构 */
 export interface ParsedCommand {
     name: string;

package/dist/plugin/commands.js

@@ -6,7 +6,7 @@ import path from "node:path";
  * Frontmatter 是位于文件开头的 --- 包裹的 YAML 格式元数据，
  * 例如：---\ntitle: foo\n---\n正文内容
  */
-function extractAndStripFrontmatter(content) {
+export function extractAndStripFrontmatter(content) {
     const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
     if (!match)
         return { frontmatter: {}, content };

package/dist/plugin/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/plugin/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/plugin/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAA;IAChE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,WAAW,EAAE,EAA4B,EAAE,OAAO,EAAE,CAAA;IAEzE,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACrB,MAAM,WAAW,GAA2B,EAAE,CAAA;IAE9C,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAA;YAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;YACzE,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACvC,CAAC;AAYD,2BAA2B;AAC3B,IAAI,cAAmE,CAAA;AAEvE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,SAAiB;IACjE,MAAM,QAAQ,GAAG,GAAG,WAAW,IAAI,SAAS,EAAE,CAAA;IAC9C,IAAI,cAAc,EAAE,GAAG,KAAK,QAAQ;QAAE,OAAO,cAAc,CAAC,KAAK,CAAA;IAEjE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,cAAc,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;QAC7C,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,MAAM,GAAoB,EAAE,CAAA;IAElC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAQ;QAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACvC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;QAC9D,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAA;QAEhE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,mBAAmB,EAAE,GAAG,SAAS,GAAG,CAAC,CAAA;QAEhF,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,OAAO,EAAE,WAAW,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACpG,QAAQ;SACT,CAAC,CAAA;IACJ,CAAC;IAED,cAAc,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IACjD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/plugin/continuation.d.ts

@@ -0,0 +1,22 @@
+import type { Plugin } from "@opencode/plugin";
+import type { GoalStore } from "./goal-store.js";
+type Context = Plugin.Context;
+/**
+ * 子会话活动跟踪（V2 无 session.list/children 查询 API，改用事件溯源）：
+ * - session.created（带 parentID）建立父子关系
+ * - execution.started / retry.scheduled → busy；execution.succeeded/failed/interrupted → idle
+ *
+ * 局限：重启后内存清空，重启瞬间仍在运行且未再发事件的子会话不被识别（窗口小，可接受；
+ * 子代理结果注入父会话会重新触发事件流）。V1 依赖实时查询，此为 V2 的降级替代。
+ */
+export declare class SessionActivityTracker {
+    private parentOf;
+    private busy;
+    onCreated(sessionID: string, parentID?: string): void;
+    onBusy(sessionID: string): void;
+    onIdle(sessionID: string): void;
+    hasWorkingChildren(sessionID: string): boolean;
+}
+export declare function queueContinuation(ctx: Context, store: GoalStore, sessionID: string, projectDir: string, tracker: SessionActivityTracker): Promise<void>;
+export declare function autoResume(ctx: Context, store: GoalStore, projectDir: string): Promise<void>;
+export {};