@devcxl/opencode-cabbage 0.2.0 → 0.3.0

package/dist/plugin/shell.d.ts

@@ -0,0 +1,37 @@
+import type { AgentEntry } from "./agents.js";
+export interface AmbientCredentialSource {
+    source: string;
+    /** "env" | "config_file" | "credential_helper" */
+    kind: "env" | "config_file" | "credential_helper";
+    /** 具体位置（如 "GH_TOKEN" 或 "~/.config/gh/hosts.yml"） */
+    location: string;
+}
+export interface AmbientCredentialReport {
+    hasWriteCredentials: boolean;
+    hasGitCredentialHelper: boolean;
+    sources: AmbientCredentialSource[];
+}
+/**
+ * 检测宿主环境中的 GitHub 写凭证。
+ *
+ * 检查内容：
+ * - GH_TOKEN / GITHUB_TOKEN / GH_ENTERPRISE_TOKEN 环境变量
+ * - ~/.config/gh/hosts.yml（GitHub CLI OAuth token）
+ * - ~/.gitconfig 中的 credential helper
+ *
+ * 注意：这只能检测常见模式，不是完备的安全审计。
+ */
+export declare function detectAmbientCredentials(): AmbientCredentialReport;
+/**
+ * 为 Worker agent 创建隔离 shell 环境变量。
+ *
+ * 隔离措施：
+ * - HOME 设为临时目录（避免访问宿主 ~/.ssh, ~/.gitconfig 等）
+ * - GH_CONFIG_DIR 设为临时目录下的隔离路径
+ * - GH_TOKEN / GITHUB_TOKEN 显式清空
+ * - GIT_CONFIG_PARAMETERS 不传递（避免继承宿主 git config）
+ *
+ * 重要：shell.env 只作为附加措施，不作为唯一隔离边界。
+ * 真正的权限控制来自 agent permission 字段 + ambient credential 检测。
+ */
+export declare function createIsolatedShellEnv(agent: AgentEntry): Record<string, string>;

package/dist/plugin/shell.js

@@ -0,0 +1,144 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+// ─── 凭证检测 ───
+const GITHUB_WRITE_TOKEN_PATTERNS = [
+    /^ghp_/, // classic PAT
+    /^github_pat_/, // fine-grained PAT
+    /^gho_/, // OAuth token
+    /^ghu_/, // user-to-server token
+    /^ghs_/, // server-to-server token
+    /^ghr_/, // refresh token
+];
+/**
+ * 检测 token 值是否看起来是 GitHub 写凭证。
+ */
+function looksLikeGithubToken(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return false;
+    return GITHUB_WRITE_TOKEN_PATTERNS.some(p => p.test(trimmed));
+}
+/**
+ * 检测环境变量中的 GitHub API 凭证。
+ */
+function detectEnvTokens() {
+    const sources = [];
+    const keys = ["GH_TOKEN", "GITHUB_TOKEN", "GH_ENTERPRISE_TOKEN"];
+    for (const key of keys) {
+        const value = process.env[key];
+        if (value && looksLikeGithubToken(value)) {
+            sources.push({
+                source: key,
+                kind: "env",
+                location: `$${key}`,
+            });
+        }
+    }
+    return sources;
+}
+/**
+ * 检测 ~/.config/gh/hosts.yml 中的 oauth_token。
+ */
+function detectGhHostsConfig() {
+    const sources = [];
+    const home = process.env.HOME || os.homedir();
+    const hostsPath = path.join(home, ".config", "gh", "hosts.yml");
+    try {
+        if (!fs.existsSync(hostsPath))
+            return sources;
+        const content = fs.readFileSync(hostsPath, "utf8");
+        // 简单检测 oauth_token 字段
+        if (/oauth_token\s*:\s*\S+/.test(content)) {
+            sources.push({
+                source: "gh_hosts_config",
+                kind: "config_file",
+                location: hostsPath,
+            });
+        }
+    }
+    catch {
+        // 读取失败时静默忽略
+    }
+    return sources;
+}
+/**
+ * 检测 git credential helper 配置。
+ * 检查 ~/.gitconfig 中是否配置了 credential.helper。
+ */
+function detectGitCredentialHelper() {
+    const sources = [];
+    const home = process.env.HOME || os.homedir();
+    const gitconfigPath = path.join(home, ".gitconfig");
+    let hasHelper = false;
+    try {
+        if (!fs.existsSync(gitconfigPath))
+            return { hasHelper, sources };
+        const content = fs.readFileSync(gitconfigPath, "utf8");
+        if (/credential\s*\]\s*\n\s*helper\s*=/.test(content) || /\[credential\s+"[^"]*"\]/.test(content)) {
+            hasHelper = true;
+            sources.push({
+                source: "git_credential_helper",
+                kind: "credential_helper",
+                location: gitconfigPath,
+            });
+        }
+    }
+    catch {
+        // 读取失败静默忽略
+    }
+    return { hasHelper, sources };
+}
+/**
+ * 检测宿主环境中的 GitHub 写凭证。
+ *
+ * 检查内容：
+ * - GH_TOKEN / GITHUB_TOKEN / GH_ENTERPRISE_TOKEN 环境变量
+ * - ~/.config/gh/hosts.yml（GitHub CLI OAuth token）
+ * - ~/.gitconfig 中的 credential helper
+ *
+ * 注意：这只能检测常见模式，不是完备的安全审计。
+ */
+export function detectAmbientCredentials() {
+    const envSources = detectEnvTokens();
+    const ghConfigSources = detectGhHostsConfig();
+    const { hasHelper, sources: helperSources } = detectGitCredentialHelper();
+    const allSources = [...envSources, ...ghConfigSources, ...helperSources];
+    const hasWriteCredentials = allSources.length > 0;
+    return {
+        hasWriteCredentials,
+        hasGitCredentialHelper: hasHelper,
+        sources: allSources,
+    };
+}
+// ─── Shell 隔离 ───
+/**
+ * 为 Worker agent 创建隔离 shell 环境变量。
+ *
+ * 隔离措施：
+ * - HOME 设为临时目录（避免访问宿主 ~/.ssh, ~/.gitconfig 等）
+ * - GH_CONFIG_DIR 设为临时目录下的隔离路径
+ * - GH_TOKEN / GITHUB_TOKEN 显式清空
+ * - GIT_CONFIG_PARAMETERS 不传递（避免继承宿主 git config）
+ *
+ * 重要：shell.env 只作为附加措施，不作为唯一隔离边界。
+ * 真正的权限控制来自 agent permission 字段 + ambient credential 检测。
+ */
+export function createIsolatedShellEnv(agent) {
+    const shellHome = fs.mkdtempSync(path.join(os.tmpdir(), "cabbage-shell-"));
+    const ghConfigDir = path.join(shellHome, ".config", "gh");
+    fs.mkdirSync(ghConfigDir, { recursive: true });
+    const env = {
+        HOME: shellHome,
+        GH_CONFIG_DIR: ghConfigDir,
+    };
+    // 清除所有 GitHub API token 环境变量
+    // shell.env 是附加措施 — 主要隔离由 agent permission 提供
+    env.GH_TOKEN = "";
+    env.GITHUB_TOKEN = "";
+    env.GH_ENTERPRISE_TOKEN = "";
+    // 不传递宿主 git config（隔离 HOME 已处理此问题，但显式清空更安全）
+    env.GIT_CONFIG_NOSYSTEM = "1";
+    return env;
+}
+//# sourceMappingURL=shell.js.map

package/dist/plugin/shell.js.map

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

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

@@ -0,0 +1,62 @@
+import type { TaskState, TddEvidence, TddCycleEvidence, TddCommandEvidence } from "../flowrun/types.js";
+import { createTaskEvidence as createBaseEvidence } from "../flowrun/state.js";
+import type { FlowBroker } from "./broker.js";
+export type TddCheckpointOp = "cycle-start" | "red" | "green" | "final-regression" | "final-verification" | "status" | "alternative-command" | "abandon-cycle";
+export interface TddCheckpointRequest {
+    op: TddCheckpointOp;
+    parentIssueNumber: number;
+    taskId: string;
+    cycleId?: string;
+    criterionId?: string;
+    testPaths?: string[];
+    testSelector?: string;
+    redEvidence?: TddCommandEvidence;
+    greenEvidence?: TddCommandEvidence;
+    reason?: string;
+    validationId?: string;
+    regressionRuns?: TddCommandEvidence[];
+    verificationRuns?: TddCommandEvidence[];
+}
+export interface TddCheckpointResponse {
+    ok: boolean;
+    evidence?: TddEvidence;
+    cycle?: TddCycleEvidence;
+    evidenceRevision?: number;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Broker-aware 响应：包含冲突暂停标志。
+ * PERSIST_CONFLICT 时 conflictPause=true，调用方应暂停 FlowRun。
+ */
+export interface TddCheckpointBrokerResponse extends TddCheckpointResponse {
+    conflictPause: boolean;
+    persisted: boolean;
+}
+export { createBaseEvidence as createTaskEvidence };
+/**
+ * 处理 tdd_checkpoint 工具请求。
+ *
+ * 职责：
+ * - 验证 Task 状态（running + executionBinding）
+ * - 根据 op 分发到 state.ts 各纯函数
+ * - 返回结构化 response（evidence revision + cycle/evidence）
+ *
+ * 注意：C2 只实现内存状态机。持久化由 C3 broker 负责。
+ */
+export declare function handleTddCheckpoint(req: TddCheckpointRequest, task: TaskState): TddCheckpointResponse;
+/**
+ * 通过 FlowBroker 执行 tdd_checkpoint 操作。
+ *
+ * 流程：
+ * 1. 通过 broker.writeFlowRunWithLock 读取 FlowRun
+ * 2. 提取目标 TaskState
+ * 3. 调用 handleTddCheckpoint 执行状态机转换
+ * 4. 成功时持久化回 Issue（broker 自动处理 revision + 乐观锁）
+ * 5. PERSIST_CONFLICT 时设置 conflictPause=true
+ *
+ * @returns TddCheckpointBrokerResponse — 包含 conflictPause 标志
+ */
+export declare function handleTddCheckpointWithBroker(broker: FlowBroker, req: TddCheckpointRequest): Promise<TddCheckpointBrokerResponse>;

package/dist/plugin/tdd-tool.js

@@ -0,0 +1,336 @@
+import { startCycle, recordRed, recordGreen, recordFinalRegression, recordFinalVerification, abandonCycle, createTaskEvidence as createBaseEvidence, } from "../flowrun/state.js";
+// ─── 内部辅助 ───
+const PLACEHOLDER_DIGEST = {
+    algorithm: "sha256-content-v1",
+    value: "0".repeat(64),
+};
+/**
+ * 简单 glob 匹配（支持 *、**）
+ */
+function matchSimpleGlob(filePath, pattern) {
+    const normalized = filePath.split("/").join("/");
+    let regexStr = "";
+    let i = 0;
+    while (i < pattern.length) {
+        if (pattern[i] === "*" && pattern[i + 1] === "*") {
+            i += 2;
+            if (i < pattern.length && pattern[i] === "/") {
+                regexStr += "(.*/)?";
+                i++;
+            }
+            else {
+                regexStr += ".*";
+            }
+        }
+        else if (pattern[i] === "*") {
+            regexStr += "[^/]*";
+            i++;
+        }
+        else if (pattern[i] === ".") {
+            regexStr += "\\.";
+            i++;
+        }
+        else if (pattern[i] === "?") {
+            regexStr += "[^/]";
+            i++;
+        }
+        else {
+            if ("+^$(){}[]|\\".includes(pattern[i])) {
+                regexStr += "\\" + pattern[i];
+            }
+            else {
+                regexStr += pattern[i];
+            }
+            i++;
+        }
+    }
+    return new RegExp(`^${regexStr}$`).test(normalized);
+}
+function matchesAnyPattern(path, patterns) {
+    if (patterns.length === 0)
+        return false;
+    return patterns.some(p => matchSimpleGlob(path, p));
+}
+// ─── 重新导出 createTaskEvidence ───
+export { createBaseEvidence as createTaskEvidence };
+// ─── 主处理函数 ───
+/**
+ * 处理 tdd_checkpoint 工具请求。
+ *
+ * 职责：
+ * - 验证 Task 状态（running + executionBinding）
+ * - 根据 op 分发到 state.ts 各纯函数
+ * - 返回结构化 response（evidence revision + cycle/evidence）
+ *
+ * 注意：C2 只实现内存状态机。持久化由 C3 broker 负责。
+ */
+export function handleTddCheckpoint(req, task) {
+    // ── 验证 Task 状态 ──
+    if (task.status !== "running") {
+        return {
+            ok: false,
+            error: { code: "TASK_NOT_RUNNING", message: `Task "${task.id}" is not running (status: ${task.status})` },
+        };
+    }
+    if (!task.executionBinding) {
+        return {
+            ok: false,
+            error: { code: "TASK_NOT_FOUND", message: `Task "${task.id}" has no execution binding` },
+        };
+    }
+    const evidence = task.tddEvidence;
+    // ── 分发 ──
+    switch (req.op) {
+        case "status":
+            return {
+                ok: true,
+                evidence,
+                evidenceRevision: evidence.revision,
+            };
+        case "cycle-start":
+            return handleCycleStart(req, task, evidence);
+        case "red":
+            return handleRed(req, task, evidence);
+        case "green":
+            return handleGreen(req, task, evidence);
+        case "final-regression":
+            return handleFinalRegression(req, task, evidence);
+        case "final-verification":
+            return handleFinalVerification(req, task, evidence);
+        case "abandon-cycle":
+            return handleAbandonCycle(req, evidence);
+        case "alternative-command":
+            // C2 暂不实现 alternative-command，由 C3 broker 处理
+            return {
+                ok: false,
+                error: { code: "POLICY_INVALID", message: "alternative-command not implemented in C2" },
+            };
+        default:
+            return {
+                ok: false,
+                error: { code: "POLICY_INVALID", message: `Unknown op: "${req.op}"` },
+            };
+    }
+}
+function handleCycleStart(req, task, evidence) {
+    const cycleId = req.cycleId;
+    const criterionId = req.criterionId;
+    if (!cycleId || !criterionId || !req.testPaths || !req.testSelector) {
+        return {
+            ok: false,
+            error: { code: "POLICY_INVALID", message: "cycle-start requires cycleId, criterionId, testPaths, testSelector" },
+        };
+    }
+    // workspace digest: 由 broker 计算，C2 阶段使用 placeholder
+    // （实际运行时 broker 调用 computeWorkspaceDigest 获取）
+    const wsDigest = PLACEHOLDER_DIGEST;
+    const result = startCycle(evidence, cycleId, criterionId, req.testPaths, req.testSelector, wsDigest, task.acceptanceCriteria, task.tddPolicy.testFilePatterns);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.error.code, message: result.error.message },
+        };
+    }
+    // 更新 task.tddEvidence（内存变异，由调用方/C3 持久化）
+    task.tddEvidence = result.value.evidence;
+    return {
+        ok: true,
+        evidence: result.value.evidence,
+        cycle: result.value.cycle,
+        evidenceRevision: result.value.evidence.revision,
+    };
+}
+function handleRed(req, task, evidence) {
+    const cycleId = req.cycleId;
+    if (!cycleId) {
+        return {
+            ok: false,
+            error: { code: "POLICY_INVALID", message: "red requires cycleId" },
+        };
+    }
+    // runner 必须存在
+    if (!task.tddPolicy.runner) {
+        return {
+            ok: false,
+            error: { code: "RUNNER_UNSUPPORTED", message: "RED requires a configured test runner" },
+        };
+    }
+    // 使用内联 evidence（C2 测试模式）或由 broker 执行 vitest adapter
+    const redEvidence = req.redEvidence;
+    if (!redEvidence) {
+        // 生产模式下由 broker 执行 vitest adapter 获取 evidence
+        // C2 阶段不直接执行命令
+        return {
+            ok: false,
+            error: { code: "POLICY_INVALID", message: "red requires redEvidence (in testing mode) or broker execution" },
+        };
+    }
+    const result = recordRed(evidence, cycleId, redEvidence);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.error.code, message: result.error.message },
+        };
+    }
+    task.tddEvidence = result.value.evidence;
+    return {
+        ok: true,
+        evidence: result.value.evidence,
+        cycle: result.value.cycle,
+        evidenceRevision: result.value.evidence.revision,
+    };
+}
+function handleGreen(req, task, evidence) {
+    const cycleId = req.cycleId;
+    if (!cycleId) {
+        return {
+            ok: false,
+            error: { code: "POLICY_INVALID", message: "green requires cycleId" },
+        };
+    }
+    if (!task.tddPolicy.runner) {
+        return {
+            ok: false,
+            error: { code: "RUNNER_UNSUPPORTED", message: "GREEN requires a configured test runner" },
+        };
+    }
+    const greenEvidence = req.greenEvidence;
+    if (!greenEvidence) {
+        return {
+            ok: false,
+            error: { code: "POLICY_INVALID", message: "green requires greenEvidence (in testing mode) or broker execution" },
+        };
+    }
+    // 检查实现文件是否有变化
+    const implPatterns = task.tddPolicy.implementationFilePatterns;
+    const implFilesChanged = greenEvidence.changedFiles.some(f => matchesAnyPattern(f, implPatterns));
+    const result = recordGreen(evidence, cycleId, greenEvidence, implFilesChanged);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.error.code, message: result.error.message },
+        };
+    }
+    task.tddEvidence = result.value.evidence;
+    return {
+        ok: true,
+        evidence: result.value.evidence,
+        cycle: result.value.cycle,
+        evidenceRevision: result.value.evidence.revision,
+    };
+}
+function handleFinalRegression(req, task, evidence) {
+    // 必须有 testCommands
+    if (!req.regressionRuns && task.testCommands.length === 0) {
+        return {
+            ok: false,
+            error: { code: "REGRESSION_FAILED", message: "No test commands configured for final regression" },
+        };
+    }
+    // 使用内联 evidence 或占位
+    const runs = req.regressionRuns ?? [];
+    // headSha + treeSha 在生产模式下由 broker 通过 git 获取
+    // C2 测试模式使用 placeholder
+    const headSha = "placeholder-head";
+    const treeSha = "placeholder-tree";
+    const result = recordFinalRegression(evidence, headSha, treeSha, runs);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.error.code, message: result.error.message },
+        };
+    }
+    task.tddEvidence = result.value;
+    return {
+        ok: true,
+        evidence: result.value,
+        evidenceRevision: result.value.revision,
+    };
+}
+function handleFinalVerification(req, task, evidence) {
+    // 使用内联 evidence 或空数组（无 verifyCommands 时 pass）
+    const runs = req.verificationRuns ?? [];
+    const headSha = "placeholder-head";
+    const treeSha = "placeholder-tree";
+    const result = recordFinalVerification(evidence, headSha, treeSha, runs);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.error.code, message: result.error.message },
+        };
+    }
+    task.tddEvidence = result.value;
+    return {
+        ok: true,
+        evidence: result.value,
+        evidenceRevision: result.value.revision,
+    };
+}
+function handleAbandonCycle(req, evidence) {
+    const cycleId = req.cycleId;
+    const reason = req.reason ?? "no reason given";
+    if (!cycleId) {
+        return {
+            ok: false,
+            error: { code: "POLICY_INVALID", message: "abandon-cycle requires cycleId" },
+        };
+    }
+    const result = abandonCycle(evidence, cycleId, reason);
+    if (!result.ok) {
+        return {
+            ok: false,
+            error: { code: result.error.code, message: result.error.message },
+        };
+    }
+    return {
+        ok: true,
+        evidence: result.value,
+        evidenceRevision: result.value.revision,
+    };
+}
+// ─── Broker-aware handler ───
+/**
+ * 通过 FlowBroker 执行 tdd_checkpoint 操作。
+ *
+ * 流程：
+ * 1. 通过 broker.writeFlowRunWithLock 读取 FlowRun
+ * 2. 提取目标 TaskState
+ * 3. 调用 handleTddCheckpoint 执行状态机转换
+ * 4. 成功时持久化回 Issue（broker 自动处理 revision + 乐观锁）
+ * 5. PERSIST_CONFLICT 时设置 conflictPause=true
+ *
+ * @returns TddCheckpointBrokerResponse — 包含 conflictPause 标志
+ */
+export async function handleTddCheckpointWithBroker(broker, req) {
+    const writeResult = await broker.writeFlowRunWithLock(req.parentIssueNumber, (flowRun) => {
+        const task = flowRun.tasks[req.taskId];
+        if (!task) {
+            const resp = {
+                ok: false,
+                error: { code: "TASK_NOT_FOUND", message: `Task "${req.taskId}" not found in FlowRun` },
+            };
+            return { flowRun, result: resp, shouldPersist: false };
+        }
+        const tddResp = handleTddCheckpoint(req, task);
+        return { flowRun, result: tddResp, shouldPersist: tddResp.ok };
+    });
+    if (!writeResult.ok) {
+        // PERSIST_CONFLICT or READ_FAILED
+        return {
+            ok: false,
+            conflictPause: writeResult.code === "PERSIST_CONFLICT",
+            persisted: false,
+            error: {
+                code: writeResult.code,
+                message: writeResult.message,
+            },
+        };
+    }
+    // 成功（或 shouldPersist=false）
+    return {
+        ...writeResult.result,
+        conflictPause: false,
+        persisted: writeResult.persisted,
+    };
+}
+//# sourceMappingURL=tdd-tool.js.map

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

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

package/dist/util/gh.d.ts

@@ -1,4 +1,11 @@
-export declare function gh(args: string, timeout?: number): Promise<{
+/**
+ * 执行 gh CLI 命令。
+ *
+ * @param args   gh 子命令及参数
+ * @param timeout  超时毫秒数（默认 30s）
+ * @param env  可选的环境变量覆盖（如注入 GH_TOKEN）
+ */
+export declare function gh(args: string, timeout?: number, env?: Record<string, string>): Promise<{
     stdout: string;
     stderr: string;
 }>;

package/dist/util/gh.js

@@ -1,7 +1,15 @@
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
 const execAsync = promisify(exec);
-export function gh(args, timeout = 30_000) {
-    return execAsync(`gh ${args}`, { timeout });
+/**
+ * 执行 gh CLI 命令。
+ *
+ * @param args   gh 子命令及参数
+ * @param timeout  超时毫秒数（默认 30s）
+ * @param env  可选的环境变量覆盖（如注入 GH_TOKEN）
+ */
+export function gh(args, timeout = 30_000, env) {
+    const execEnv = env ? { ...process.env, ...env } : process.env;
+    return execAsync(`gh ${args}`, { timeout, env: execEnv });
 }
 //# sourceMappingURL=gh.js.map

package/dist/util/gh.js.map

@@ -1 +1 @@
-{"version":3,"file":"gh.js","sourceRoot":"","sources":["../../src/util/gh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;AAEjC,MAAM,UAAU,EAAE,CAAC,IAAY,EAAE,OAAO,GAAG,MAAM;IAC/C,OAAO,SAAS,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;AAC7C,CAAC"}
+{"version":3,"file":"gh.js","sourceRoot":"","sources":["../../src/util/gh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,EAAE,CAAC,IAAY,EAAE,OAAO,GAAG,MAAM,EAAE,GAA4B;IAC7E,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA;IAC9D,OAAO,SAAS,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devcxl/opencode-cabbage",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "OpenCode 全流程开发插件 — 需求→设计→任务→编码→测试→审查→自动合并，支持自动编排与并行 Subagent",
   "repository": {
     "type": "git",
@@ -46,6 +46,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "prompt-lint": "vitest run test/plugin/prompt-lint.test.ts",
+    "test:pack": "npm pack --dry-run 2>&1 | tee /dev/stderr | grep -q 'assets/skills/flow-tdd/SKILL.md' && echo 'PASS: flow-tdd/SKILL.md found in tarball' || (echo 'FAIL: flow-tdd/SKILL.md not found in tarball' && exit 1)",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs"