@devcxl/opencode-cabbage 0.3.2 → 1.1.0

package/dist/plugin/flow-control.js

@@ -0,0 +1,287 @@
+/**
+ * flow_control 工具（spec §2.3）：Flow Record 生命周期（替代旧 FlowRun 状态机）。
+ * 九 op：create-flow / status / planning-start / planning-pr / stage-start / stage-complete /
+ *       complete-flow / cancel-flow / takeover。
+ * caller：primary 全量（除 complete-flow）；complete-flow 仅 goal-verify。
+ * server.ts 接线由后续批次统一处理（本批不注册，避免文件冲突）。
+ */
+import { tool } from "@opencode-ai/plugin/tool";
+import { resolveProjectDir } from "../util/paths.js";
+import { requireToolCaller, CALLER_NOT_AUTHORIZED } from "../kernel/caller.js";
+import { FLOW_STAGES, createFlow, readFlowStatus, planningStart, planningPr, applyStageOp, completeFlow, cancelFlow, takeoverFlow, } from "../kernel/flow.js";
+import { readIndex, getFlowSession } from "../kernel/session-index.js";
+import { detectLegacyFlowRun } from "../kernel/legacy.js";
+import { flowGh } from "../kernel/flow.js";
+/**
+ * flow_control 工具工厂（spec §2.3）。
+ * caller 门禁：primary（除 complete-flow 外）；complete-flow 仅 goal-verify。
+ */
+export function createFlowControlTool(deps) {
+    return tool({
+        description: `Control the Flow Record lifecycle (a Flow = one GitHub Parent Issue).
+
+Operations:
+- create-flow: Validate the functional title, derive the slug, create a Draft Parent Issue (body contains goal/acceptance/stage checklist, label cabbage:flow), bind the session, and write the minimal goal. When parent_issue_number is given, bind an existing issue instead (legacy FlowRun detection + double-session check).
+- status: Aggregate the Flow Record body, subtasks (issue list --json parent 过滤), and related PR checks into one report.
+- planning-start: Create the planning worktree .worktree/planning-<slug> for the architect.
+- planning-pr: Commit/push the planning worktree changes and open the Planning PR (Planning Baseline).
+- stage-start / stage-complete: Enforce stage gates (requirements baseline confirmed once; design must complete before tasks; high-risk flows pause between design and tasks) and update the Parent Issue checklist + cabbage:stage:* label.
+- complete-flow: goal-verify only. After independent verification, close the Parent Issue.
+- cancel-flow: Controlled cancellation (requires user_confirmed).
+- takeover: Take over a flow bound to another active session (requires user_confirmed; old session goal is paused).
+
+Caller: primary for all ops except complete-flow (goal-verify only).`,
+        args: {
+            op: tool.schema
+                .enum(["create-flow", "status", "planning-start", "planning-pr", "stage-start", "stage-complete", "complete-flow", "cancel-flow", "takeover"])
+                .describe("Flow control operation"),
+            title: tool.schema.string().optional().describe("Functional title (kebab-case slug) for create-flow"),
+            auto_mode: tool.schema
+                .boolean()
+                .optional()
+                .describe("Full-auto mode: label the flow cabbage:auto so stage confirmation gates (requirements/high-risk) pass without user_confirmed"),
+            goal: tool.schema.string().optional().describe("Initial objective to fill the Flow Record Goal block (create-flow)"),
+            acceptance_criteria: tool.schema
+                .array(tool.schema.string())
+                .optional()
+                .describe("Initial acceptance criteria list to fill the Flow Record Acceptance Criteria block (create-flow)"),
+            parent_issue_number: tool.schema.number().optional().describe("Parent GitHub Issue number of the Flow Record"),
+            stage: tool.schema
+                .enum(["requirements", "design", "tasks", "code", "review"])
+                .optional()
+                .describe("Stage name (for stage-start/stage-complete)"),
+            risk: tool.schema
+                .enum(["high", "low"])
+                .optional()
+                .describe("Risk declaration for stage-start/stage-complete tasks handoff: high triggers the R11 user-confirmation gate (user_confirmed) and persists the cabbage:risk:high label"),
+            user_confirmed: tool.schema.boolean().optional().describe("User confirmation (required for cancel-flow/takeover and high-risk gates)"),
+        },
+        async execute(args, ctx) {
+            const op = args.op;
+            // caller 门禁（矩阵单一来源，§2.2）：complete-flow 仅 goal-verify；status 另开放 architect；其余仅 primary
+            const denied = await requireToolCaller(ctx, "flow_control", op, deps.sessionClient);
+            if (denied)
+                return errorResponse(CALLER_NOT_AUTHORIZED, denied);
+            // 会话级项目目录优先（workspace root 异常会话下插件级 projectDir 可能是 `/`）
+            const runtimeDeps = { ...deps, projectDir: resolveProjectDir(ctx.directory, deps.projectDir) };
+            try {
+                switch (op) {
+                    case "create-flow":
+                        return handleCreateFlow(runtimeDeps, args, ctx.sessionID);
+                    case "status":
+                        return handleStatus(runtimeDeps, args);
+                    case "planning-start":
+                        return handlePlanningStart(runtimeDeps, args);
+                    case "planning-pr":
+                        return handlePlanningPr(runtimeDeps, args);
+                    case "stage-start":
+                    case "stage-complete":
+                        return handleStage(runtimeDeps, args, op);
+                    case "complete-flow":
+                        return handleCompleteFlow(runtimeDeps, args, ctx);
+                    case "cancel-flow":
+                        return handleCancelFlow(runtimeDeps, args);
+                    case "takeover":
+                        return handleTakeover(runtimeDeps, args, ctx.sessionID);
+                    default:
+                        return errorResponse("UNKNOWN_OP", `Unknown op: "${op}"`);
+                }
+            }
+            catch (err) {
+                return errorResponse("INTERNAL_ERROR", String(err));
+            }
+        },
+    });
+}
+/** 独立注册辅助：把 flow_control 挂到工具注册表（后续接线批次使用） */
+export function registerFlowControl(registry, deps) {
+    registry.flow_control = createFlowControlTool(deps);
+}
+// ─── op handlers ───
+async function handleCreateFlow(deps, args, sessionID) {
+    const parent = args.parent_issue_number !== undefined ? Number(args.parent_issue_number) : undefined;
+    const title = args.title ?? "";
+    if (parent === undefined && title.trim() === "") {
+        return errorResponse("POLICY_INVALID", "title is required for create-flow (or pass parent_issue_number to bind an existing issue)");
+    }
+    const result = await createFlow({
+        projectDir: deps.projectDir,
+        title,
+        sessionID,
+        autoMode: args.auto_mode === true,
+        goal: args.goal,
+        acceptanceCriteria: args.acceptance_criteria,
+        parentIssueNumber: parent,
+    });
+    if (!result.ok) {
+        return errorResponse(result.code, result.message);
+    }
+    const goalWritten = await writeMinimalGoal(deps.sessionClient, sessionID, result.ref.parentIssueNumber);
+    if (!goalWritten) {
+        return errorResponse("GOAL_WRITE_FAILED", "flow created but failed to write the minimal goal to the session");
+    }
+    return okResponse({ flow: result.ref });
+}
+async function handleStatus(_deps, args) {
+    const n = requireParentIssueNumber(args);
+    if (typeof n === "string")
+        return n;
+    const legacy = await detectLegacyFlowRun(n, flowGh);
+    if (legacy.legacy)
+        return legacyDetectedResponse(legacy);
+    const result = await readFlowStatus(n);
+    if (!result.ok) {
+        return errorResponse(result.code, result.message);
+    }
+    return okResponse({ status: result.status });
+}
+async function handlePlanningStart(deps, args) {
+    const n = requireParentIssueNumber(args);
+    if (typeof n === "string")
+        return n;
+    const result = await planningStart(deps.projectDir, n);
+    if (!result.ok) {
+        return errorResponse(result.code, result.message);
+    }
+    return okResponse({ worktreePath: result.worktreePath, branch: result.branch });
+}
+async function handlePlanningPr(deps, args) {
+    const n = requireParentIssueNumber(args);
+    if (typeof n === "string")
+        return n;
+    const result = await planningPr(deps.projectDir, n);
+    if (!result.ok) {
+        return errorResponse(result.code, result.message);
+    }
+    return okResponse({ prNumber: result.prNumber, worktreePath: result.worktreePath, branch: result.branch });
+}
+async function handleStage(deps, args, op) {
+    const n = requireParentIssueNumber(args);
+    if (typeof n === "string")
+        return n;
+    const stage = args.stage;
+    if (!stage || !FLOW_STAGES.includes(stage)) {
+        return errorResponse("POLICY_INVALID", "stage is required for stage ops: requirements|design|tasks|code|review");
+    }
+    const risk = args.risk;
+    if (risk !== undefined && risk !== "high" && risk !== "low") {
+        return errorResponse("POLICY_INVALID", "risk must be \"high\" or \"low\"");
+    }
+    const result = await applyStageOp(deps.projectDir, n, op, stage, args.user_confirmed === true, risk);
+    if (!result.ok) {
+        return errorResponse(result.code, result.message);
+    }
+    const note = op === "stage-complete" && stage === "requirements"
+        ? "requirements 产物（PRD/CONTEXT/decision-map）请 commit+push 到 main：planning worktree 基于 main HEAD 创建，未提交的文件在其中不可见"
+        : undefined;
+    return okResponse({
+        stage: result.stage,
+        completedStages: result.completedStages,
+        ...(result.highRisk ? { highRisk: true } : {}),
+        ...(note ? { note } : {}),
+    });
+}
+async function handleCompleteFlow(deps, args, ctx) {
+    const n = requireParentIssueNumber(args);
+    if (typeof n === "string")
+        return n;
+    // 独立 goal-verify 验证通过：flow 级 goalComplete 标记（跨会话持久，最可靠）
+    // 或绑定 session 的 goal 已 complete（向后兼容）
+    const index = await readIndex(deps.projectDir);
+    const entry = getFlowSession(index, n);
+    const goalCompleteAtFlowLevel = entry?.goalComplete === true;
+    const targetSessionID = entry?.sessionID ?? ctx.sessionID;
+    const goalStatus = await readGoalStatus(deps.sessionClient, targetSessionID);
+    if (!goalCompleteAtFlowLevel && goalStatus !== "complete") {
+        return errorResponse("GOAL_NOT_COMPLETE", "complete-flow requires the goal to be verified complete first (goal({op:'complete'}) by goal-verify)");
+    }
+    const result = await completeFlow(deps.projectDir, n);
+    if (!result.ok) {
+        return errorResponse(result.code, result.message);
+    }
+    return okResponse({ flow: { parentIssueNumber: result.parentIssueNumber } });
+}
+async function handleCancelFlow(deps, args) {
+    const n = requireParentIssueNumber(args);
+    if (typeof n === "string")
+        return n;
+    const result = await cancelFlow(deps.projectDir, n, args.user_confirmed === true);
+    if (!result.ok) {
+        return errorResponse(result.code, result.message);
+    }
+    return okResponse({ flow: { parentIssueNumber: result.parentIssueNumber } });
+}
+async function handleTakeover(deps, args, sessionID) {
+    const n = requireParentIssueNumber(args);
+    if (typeof n === "string")
+        return n;
+    const result = await takeoverFlow(deps.projectDir, n, sessionID, args.user_confirmed === true);
+    if (!result.ok) {
+        return errorResponse(result.code, result.message);
+    }
+    if (result.oldSessionID && result.oldSessionID !== sessionID) {
+        await pauseOldSessionGoal(deps.sessionClient, result.oldSessionID);
+    }
+    return okResponse({ flow: { parentIssueNumber: result.parentIssueNumber }, oldSessionID: result.oldSessionID });
+}
+// ─── helpers ───
+function requireParentIssueNumber(args) {
+    const n = Number(args.parent_issue_number);
+    if (!Number.isInteger(n) || n <= 0) {
+        return errorResponse("POLICY_INVALID", "parent_issue_number is required");
+    }
+    return n;
+}
+/** 写最小 goal（§10.2）：{parentIssueNumber, status:"active", continuationCount:0} */
+async function writeMinimalGoal(client, sessionID, parentIssueNumber) {
+    try {
+        const { data } = await client.session.get({ sessionID });
+        const existing = data?.metadata ?? {};
+        await client.session.update({
+            sessionID,
+            metadata: { ...existing, goal: { parentIssueNumber, status: "active", continuationCount: 0 } },
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 读指定 session 的 goal 状态；无 goal 返回 null */
+async function readGoalStatus(client, sessionID) {
+    try {
+        const { data } = await client.session.get({ sessionID });
+        const goal = data?.metadata?.goal;
+        return goal?.status ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** takeover 后把旧 session 的 goal 置 paused（§10.3） */
+async function pauseOldSessionGoal(client, sessionID) {
+    try {
+        const { data } = await client.session.get({ sessionID });
+        const metadata = data?.metadata;
+        const goal = metadata?.goal;
+        if (!goal)
+            return;
+        await client.session.update({ sessionID, metadata: { ...metadata, goal: { ...goal, status: "paused" } } });
+    }
+    catch {
+        // 旧 session goal 置 paused 失败不阻断 takeover
+    }
+}
+function legacyDetectedResponse(legacy) {
+    const detail = legacy.flowRunId ? ` (flowRunId: ${legacy.flowRunId})` : "";
+    return errorResponse("LEGACY_FLOW_DETECTED", `This issue is a legacy-architecture FlowRun${detail}; complete it with the old plugin version (0.x). New versions do not auto-migrate.`);
+}
+function okResponse(overrides = {}) {
+    const resp = { ok: true, ...overrides };
+    return JSON.stringify(resp, null, 2);
+}
+function errorResponse(code, message) {
+    const resp = { ok: false, error: { code, message } };
+    return JSON.stringify(resp, null, 2);
+}
+//# sourceMappingURL=flow-control.js.map

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

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

package/dist/plugin/goal.d.ts

@@ -1,18 +1,28 @@
 import type { ToolContext, ToolResult } from "@opencode-ai/plugin";
 import { createOpencodeClient } from "@opencode-ai/sdk/v2";
 import type { Session } from "@opencode-ai/sdk/v2";
-import type { GoalFlowRunRef } from "../flowrun/types.js";
 export type GoalStatus = "active" | "paused" | "complete";
+/** 用户最后使用的会话配置快照：续接注入时显式传回，防止 idle 后回落/切换默认 agent 与模型 */
+export interface GoalSessionProfile {
+    agent: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+}
+/** 最小化 goal（§10.2）：目标与验收条件从 Flow Record（Parent Issue body）读取 */
 export interface GoalData {
-    objective: string;
-    completionCriterion: string;
+    parentIssueNumber: number;
     status: GoalStatus;
     continuationCount: number;
+    /** 用户最后使用的 agent/模型（create 或用户消息时快照） */
+    sessionProfile?: GoalSessionProfile;
 }
+export declare function createGoal(parentIssueNumber: number, sessionProfile?: GoalSessionProfile): GoalData;
 export declare function canTransitionTo(goal: GoalData, target: GoalStatus): boolean;
 export declare function formatGoal(goal: GoalData): string;
 export declare const MAX_CONTINUATIONS = 50;
-export declare function continuationPrompt(objective: string, completionCriterion: string): string;
+export declare function continuationPrompt(parentIssueNumber: number): string;
 export declare function verifyAgentPrompt(): string;
 export declare function createGoalClient(serverUrl: URL, v1Client: any): import("@opencode-ai/sdk/v2").OpencodeClient;
 export declare function readGoal(client: ReturnType<typeof createOpencodeClient>, sessionID: string): Promise<{
@@ -20,44 +30,7 @@ export declare function readGoal(client: ReturnType<typeof createOpencodeClient>
     session: Session | null;
 }>;
 export declare function writeGoal(client: ReturnType<typeof createOpencodeClient>, sessionID: string, goal: GoalData | null, existingSession?: Session | null): Promise<void>;
-/**
- * 读取 session metadata 中的 GoalFlowRunRef。
- * 返回 null 表示尚未绑定。
- */
-export declare function readFlowRunRef(client: ReturnType<typeof createOpencodeClient>, sessionID: string): Promise<GoalFlowRunRef | null>;
-/**
- * Goal → FlowRun 绑定结果。
- */
-export type BindFlowRunResult = {
-    ok: true;
-} | {
-    ok: false;
-    code: "GOAL_FLOW_CONFLICT";
-    message: string;
-};
-/**
- * 原子绑定 Goal → FlowRun。
- *
- * 规则：
- * - 未绑定 → 写入 flowRunRef，返回 ok
- * - 已绑定同一 FlowRun（repo + parentIssueNumber + flowRunId 相同）→ 幂等，返回 ok
- * - 已绑定不同 FlowRun → 返回 GOAL_FLOW_CONFLICT
- */
-export declare function bindFlowRunRef(client: ReturnType<typeof createOpencodeClient>, sessionID: string, ref: GoalFlowRunRef): Promise<BindFlowRunResult>;
-/**
- * 解析 GoalFlowRunRef 的显示名称。
- */
-export declare function formatFlowRunRef(ref: GoalFlowRunRef): string;
-/**
- * 验证 FlowRun 终态 — 检查是否满足 Goal complete 的前提条件。
- *
- * 返回 null 表示允许完成；
- * 返回错误信息字符串表示阻止完成。
- *
- * @param flowRunStatus FlowRun 当前状态，null 表示无绑定的 FlowRun
- */
-export declare function checkFlowRunBlockers(flowRunStatus: string | null): string | null;
-export declare function createGoalTool(client: ReturnType<typeof createOpencodeClient>, onBeforeComplete?: (parentSessionID: string) => Promise<string | null>): {
+export declare function createGoalTool(client: ReturnType<typeof createOpencodeClient>): {
     description: string;
     args: {
         op: import("zod").ZodEnum<{
@@ -68,12 +41,10 @@ export declare function createGoalTool(client: ReturnType<typeof createOpencodeC
             cancel: "cancel";
             pause: "pause";
         }>;
-        objective: import("zod").ZodString;
-        completion_criterion: import("zod").ZodString;
+        parent_issue_number: import("zod").ZodNumber;
     };
     execute(args: {
         op: "complete" | "create" | "get" | "resume" | "cancel" | "pause";
-        objective: string;
-        completion_criterion: string;
+        parent_issue_number: number;
     }, context: ToolContext): Promise<ToolResult>;
 };