@devcxl/opencode-cabbage 0.1.0

package/dist/flowrun/gate.js

@@ -0,0 +1,130 @@
+import { FLOW_RUN_STAGES, TASK_STATUSES, } from "./types.js";
+function ok() {
+    return { allowed: true, missing: [], failedChecks: [] };
+}
+function block(reason, missing = [], failedChecks = []) {
+    return { allowed: false, reason, missing, failedChecks };
+}
+export function canStartStage(flowRun, stage) {
+    const stageIdx = FLOW_RUN_STAGES.indexOf(stage);
+    if (stageIdx === -1)
+        return block(`Unknown stage: ${stage}`);
+    if (flowRun.status !== "running") {
+        return block(`FlowRun is ${flowRun.status}, not running`);
+    }
+    const prevStages = FLOW_RUN_STAGES.slice(0, stageIdx);
+    for (const prev of prevStages) {
+        const s = flowRun.stages[prev];
+        if (s.status !== "pass") {
+            return block(`Prerequisite stage "${prev}" is not complete (status: ${s.status})`, [prev]);
+        }
+    }
+    const stageState = flowRun.stages[stage];
+    if (!stageState)
+        return block(`Stage state not found: ${stage}`);
+    if (stageState.status === "pass") {
+        return block(`Stage "${stage}" already completed`);
+    }
+    return ok();
+}
+export function canCompleteStage(flowRun, stage) {
+    const stageState = flowRun.stages[stage];
+    if (!stageState)
+        return block(`Stage state not found: ${stage}`);
+    const missingArtifacts = stageState.requiredArtifacts.filter(a => !a);
+    const failedChecks = stageState.checks.filter(c => c.status === "fail").map(c => c.name);
+    if (missingArtifacts.length > 0) {
+        return block(`Stage "${stage}" has missing required artifacts`, missingArtifacts);
+    }
+    if (failedChecks.length > 0) {
+        return block(`Stage "${stage}" has failed checks`, [], failedChecks);
+    }
+    const pendingChecks = stageState.checks.filter(c => c.status === "pending");
+    if (pendingChecks.length > 0) {
+        return block(`Stage "${stage}" has pending checks: ${pendingChecks.map(c => c.name).join(", ")}`);
+    }
+    if (stage === "merge") {
+        return canMerge(flowRun);
+    }
+    return ok();
+}
+export function canStartTask(flowRun, taskId) {
+    const task = flowRun.tasks[taskId];
+    if (!task)
+        return block(`Task not found: ${taskId}`);
+    if (flowRun.status !== "running") {
+        return block(`FlowRun is ${flowRun.status}, not running`);
+    }
+    const codeStage = flowRun.stages.code;
+    if (codeStage.status !== "running" && codeStage.status !== "pass") {
+        return block("Code stage is not active");
+    }
+    if (task.status === "merged")
+        return block(`Task "${taskId}" already merged`);
+    if (task.status === "running")
+        return block(`Task "${taskId}" already running`);
+    if (task.status === "blocked")
+        return block(`Task "${taskId}" is blocked: ${task.blockedReason || "unknown reason"}`);
+    for (const dep of task.dependsOn) {
+        const depTask = flowRun.tasks[dep];
+        if (!depTask)
+            return block(`Dependency task "${dep}" not found`);
+        if (depTask.status !== "merged") {
+            return block(`Dependency "${dep}" is not merged (status: ${depTask.status})`, [], [dep]);
+        }
+    }
+    return ok();
+}
+export function canCompleteTask(flowRun, taskId) {
+    const task = flowRun.tasks[taskId];
+    if (!task)
+        return block(`Task not found: ${taskId}`);
+    if (task.status !== "running") {
+        return block(`Task "${taskId}" is not running (status: ${task.status})`);
+    }
+    return ok();
+}
+export function canMerge(flowRun) {
+    if (flowRun.status !== "running" && flowRun.status !== "merging") {
+        return block("FlowRun is not in a mergeable state");
+    }
+    const reviewStage = flowRun.stages.review;
+    if (reviewStage.status !== "pass") {
+        return block("Review stage is not complete");
+    }
+    return ok();
+}
+export function allTasksComplete(flowRun) {
+    const taskIds = Object.keys(flowRun.tasks);
+    if (taskIds.length === 0)
+        return false;
+    return taskIds.every(id => flowRun.tasks[id].status === "merged");
+}
+export function getReadyTasks(flowRun) {
+    return Object.values(flowRun.tasks).filter(t => {
+        if (t.status !== "pending" && t.status !== "ready")
+            return false;
+        const depsMet = t.dependsOn.every(dep => {
+            const depTask = flowRun.tasks[dep];
+            return depTask && depTask.status === "merged";
+        });
+        return depsMet;
+    });
+}
+export function determineNextStage(flowRun) {
+    for (const stage of FLOW_RUN_STAGES) {
+        const s = flowRun.stages[stage];
+        if (s.status === "pending" || s.status === "failed" || s.status === "blocked") {
+            const gate = canStartStage(flowRun, stage);
+            if (gate.allowed) {
+                return { stage, reason: `Stage "${stage}" is ready to start` };
+            }
+            return { stage: null, reason: `Cannot start "${stage}": ${gate.reason}` };
+        }
+        if (s.status === "running") {
+            return { stage, reason: `Stage "${stage}" is in progress` };
+        }
+    }
+    return { stage: null, reason: "All stages complete" };
+}
+//# sourceMappingURL=gate.js.map

package/dist/flowrun/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/flowrun/gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAAE,aAAa,GAC/B,MAAM,YAAY,CAAA;AASnB,SAAS,EAAE;IACT,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAA;AACzD,CAAC;AAED,SAAS,KAAK,CAAC,MAAc,EAAE,UAAoB,EAAE,EAAE,eAAyB,EAAE;IAChF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,KAAgB;IAC9D,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/C,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAA;IAE5D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,cAAc,OAAO,CAAC,MAAM,eAAe,CAAC,CAAA;IAC3D,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IACrD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC,uBAAuB,IAAI,8BAA8B,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5F,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;IAEhE,IAAI,UAAU,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,UAAU,KAAK,qBAAqB,CAAC,CAAA;IACpD,CAAC;IAED,OAAO,EAAE,EAAE,CAAA;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,KAAgB;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAA;IAEhE,MAAM,gBAAgB,GAAG,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACrE,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAExF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,UAAU,KAAK,kCAAkC,EAAE,gBAAgB,CAAC,CAAA;IACnF,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,UAAU,KAAK,qBAAqB,EAAE,EAAE,EAAE,YAAY,CAAC,CAAA;IACtE,CAAC;IAED,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAA;IAC3E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,UAAU,KAAK,yBAAyB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnG,CAAC;IAED,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAED,OAAO,EAAE,EAAE,CAAA;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,MAAc;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAA;IAEpD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,cAAc,OAAO,CAAC,MAAM,eAAe,CAAC,CAAA;IAC3D,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA;IACrC,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,SAAS,MAAM,kBAAkB,CAAC,CAAA;IAC7E,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,SAAS,MAAM,mBAAmB,CAAC,CAAA;IAC/E,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,SAAS,MAAM,iBAAiB,IAAI,CAAC,aAAa,IAAI,gBAAgB,EAAE,CAAC,CAAA;IAErH,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC,oBAAoB,GAAG,aAAa,CAAC,CAAA;QAChE,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,eAAe,GAAG,4BAA4B,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QAC1F,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,CAAA;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,MAAc;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAA;IAEpD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,SAAS,MAAM,6BAA6B,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;IAC1E,CAAC;IAED,OAAO,EAAE,EAAE,CAAA;AACb,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAA;IACzC,IAAI,WAAW,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC,8BAA8B,CAAC,CAAA;IAC9C,CAAC;IAED,OAAO,EAAE,EAAE,CAAA;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,OAAO,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC7C,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO;YAAE,OAAO,KAAK,CAAA;QAEhE,MAAM,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YACtC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClC,OAAO,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAA;QAC/C,CAAC,CAAC,CAAA;QAEF,OAAO,OAAO,CAAA;IAChB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC/B,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9E,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAC1C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,KAAK,qBAAqB,EAAE,CAAA;YAChE,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,KAAK,MAAM,IAAI,CAAC,MAAM,EAAE,EAAE,CAAA;QAC3E,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,KAAK,kBAAkB,EAAE,CAAA;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAA;AACvD,CAAC"}

package/dist/flowrun/github.d.ts

@@ -0,0 +1,20 @@
+import { type FlowRun } from "./types.js";
+export declare function extractFlowRunFromBody(body: string): FlowRun | null;
+export declare function replaceFlowRunInBody(body: string, flowRun: FlowRun): string;
+export declare function readFlowRun(issueNumber: number): Promise<FlowRun | null>;
+export declare function writeFlowRun(issueNumber: number, flowRun: FlowRun): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+export declare function readFlowRunWithLock(issueNumber: number): Promise<{
+    flowRun: FlowRun | null;
+    currentBody: string | null;
+}>;
+export declare function writeFlowRunWithLock(issueNumber: number, flowRun: FlowRun, previousBody: string): Promise<{
+    success: boolean;
+    error?: string;
+    conflict: boolean;
+}>;
+export declare function applyLabel(issueNumber: number, label: string): Promise<boolean>;
+export declare function removeLabel(issueNumber: number, label: string): Promise<boolean>;
+export declare function createInitialFlowRun(flowRunId: string, repo: string, parentIssueNumber: number): FlowRun;

package/dist/flowrun/github.js

@@ -0,0 +1,134 @@
+import { gh } from "../util/gh.js";
+import { escapeShellArg } from "../util/shell.js";
+import { CABINET_START_MARKER, CABINET_END_MARKER, CURRENT_SCHEMA_VERSION, } from "./types.js";
+import { validateFlowRun } from "./validator.js";
+function buildFlowRunBlock(flowRun) {
+    const json = JSON.stringify(flowRun, null, 2);
+    return `${CABINET_START_MARKER}\n\`\`\`json\n${json}\n\`\`\`\n${CABINET_END_MARKER}`;
+}
+export function extractFlowRunFromBody(body) {
+    const startIdx = body.indexOf(CABINET_START_MARKER);
+    const endIdx = body.indexOf(CABINET_END_MARKER);
+    if (startIdx === -1 || endIdx === -1)
+        return null;
+    const block = body.slice(startIdx + CABINET_START_MARKER.length, endIdx).trim();
+    const jsonMatch = block.match(/```json\n?([\s\S]*?)```/);
+    if (!jsonMatch)
+        return null;
+    try {
+        const parsed = JSON.parse(jsonMatch[1].trim());
+        const { data } = validateFlowRun(parsed);
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export function replaceFlowRunInBody(body, flowRun) {
+    const startIdx = body.indexOf(CABINET_START_MARKER);
+    const endIdx = body.indexOf(CABINET_END_MARKER);
+    const block = buildFlowRunBlock(flowRun);
+    if (startIdx === -1 || endIdx === -1) {
+        return body + "\n\n" + block;
+    }
+    return body.slice(0, startIdx) + block + body.slice(endIdx + CABINET_END_MARKER.length);
+}
+export async function readFlowRun(issueNumber) {
+    try {
+        const { stdout } = await gh(`issue view ${issueNumber} --json body --jq .body`);
+        return extractFlowRunFromBody(stdout);
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeFlowRun(issueNumber, flowRun) {
+    try {
+        const { stdout } = await gh(`issue view ${issueNumber} --json body --jq .body`);
+        const body = stdout;
+        const newBody = replaceFlowRunInBody(body, flowRun);
+        const escaped = escapeShellArg(newBody);
+        await gh(`issue edit ${issueNumber} --body '${escaped}'`);
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+export async function readFlowRunWithLock(issueNumber) {
+    try {
+        const { stdout } = await gh(`issue view ${issueNumber} --json body --jq .body`);
+        const flowRun = extractFlowRunFromBody(stdout);
+        return { flowRun, currentBody: stdout };
+    }
+    catch {
+        return { flowRun: null, currentBody: null };
+    }
+}
+export async function writeFlowRunWithLock(issueNumber, flowRun, previousBody) {
+    try {
+        const { stdout } = await gh(`issue view ${issueNumber} --json body --jq .body`);
+        if (previousBody !== stdout) {
+            return { success: false, error: "Conflict: body has changed since last read", conflict: true };
+        }
+        const newBody = replaceFlowRunInBody(stdout, flowRun);
+        const escaped = escapeShellArg(newBody);
+        await gh(`issue edit ${issueNumber} --body '${escaped}'`);
+        return { success: true, conflict: false };
+    }
+    catch (err) {
+        return { success: false, error: String(err), conflict: false };
+    }
+}
+export async function applyLabel(issueNumber, label) {
+    try {
+        await gh(`issue edit ${issueNumber} --add-label '${label}'`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function removeLabel(issueNumber, label) {
+    try {
+        await gh(`issue edit ${issueNumber} --remove-label '${label}'`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function createInitialFlowRun(flowRunId, repo, parentIssueNumber) {
+    const now = new Date().toISOString();
+    const emptyStage = () => ({
+        status: "pending",
+        requiredArtifacts: [],
+        checks: [],
+        completedAt: null,
+        evidence: [],
+    });
+    return {
+        flowRunId,
+        repo,
+        parentIssueNumber,
+        status: "planned",
+        schemaVersion: CURRENT_SCHEMA_VERSION,
+        revision: 0,
+        stages: {
+            requirements: emptyStage(),
+            design: emptyStage(),
+            tasks: emptyStage(),
+            code: emptyStage(),
+            test: emptyStage(),
+            review: emptyStage(),
+            merge: emptyStage(),
+        },
+        tasks: {},
+        startedAt: now,
+        lastTickAt: now,
+        nextTickAfter: null,
+        maxRuntime: 86_400_000,
+        completedAt: null,
+    };
+}
+//# sourceMappingURL=github.js.map

package/dist/flowrun/github.js.map

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

package/dist/flowrun/index.d.ts

@@ -0,0 +1,7 @@
+export { type FlowRun, type FlowRunStatus, type FlowStage, type TaskState, type TaskStatus, type StageState, type StageStatus, type Checkpoint, type CheckpointStatus, type EvidenceEntry, type PRCheckpoints, FLOW_RUN_STAGES, FLOW_RUN_STATUSES, TASK_STATUSES, STAGE_STATUSES, CHECKPOINT_STATUSES, CURRENT_SCHEMA_VERSION, DEFAULT_MAX_RUNTIME_MS, CABINET_START_MARKER, CABINET_END_MARKER, LABEL_PREFIX, FLOW_RUN_LABELS, } from "./types.js";
+export { validateFlowRun, type ValidationError, } from "./validator.js";
+export { extractFlowRunFromBody, replaceFlowRunInBody, readFlowRun, writeFlowRun, readFlowRunWithLock, writeFlowRunWithLock, applyLabel, removeLabel, createInitialFlowRun, } from "./github.js";
+export { canStartStage, canCompleteStage, canStartTask, canCompleteTask, canMerge, allTasksComplete, getReadyTasks, determineNextStage, type GateResult, } from "./gate.js";
+export { checkBranchProtection, validateCheckpoint, validatePRCheckpoints, canAutoMergeTask, mergePR, createRevertPR, type MergeGateResult, } from "./merge.js";
+export { checkRuntime, hasRuntimeExpired, getRuntimeMs, checkBackpressure, buildContinuationContext, type RuntimeCheckResult, type BackpressureStatus, } from "./resilience.js";
+export { postAuditComment, postPRComment, buildStageAudit, buildMergeAudit, } from "./audit.js";

package/dist/flowrun/index.js

@@ -0,0 +1,8 @@
+export { FLOW_RUN_STAGES, FLOW_RUN_STATUSES, TASK_STATUSES, STAGE_STATUSES, CHECKPOINT_STATUSES, CURRENT_SCHEMA_VERSION, DEFAULT_MAX_RUNTIME_MS, CABINET_START_MARKER, CABINET_END_MARKER, LABEL_PREFIX, FLOW_RUN_LABELS, } from "./types.js";
+export { validateFlowRun, } from "./validator.js";
+export { extractFlowRunFromBody, replaceFlowRunInBody, readFlowRun, writeFlowRun, readFlowRunWithLock, writeFlowRunWithLock, applyLabel, removeLabel, createInitialFlowRun, } from "./github.js";
+export { canStartStage, canCompleteStage, canStartTask, canCompleteTask, canMerge, allTasksComplete, getReadyTasks, determineNextStage, } from "./gate.js";
+export { checkBranchProtection, validateCheckpoint, validatePRCheckpoints, canAutoMergeTask, mergePR, createRevertPR, } from "./merge.js";
+export { checkRuntime, hasRuntimeExpired, getRuntimeMs, checkBackpressure, buildContinuationContext, } from "./resilience.js";
+export { postAuditComment, postPRComment, buildStageAudit, buildMergeAudit, } from "./audit.js";
+//# sourceMappingURL=index.js.map

package/dist/flowrun/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flowrun/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EACtF,sBAAsB,EAAE,sBAAsB,EAC9C,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,GACxE,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,sBAAsB,EAAE,oBAAoB,EAC5C,WAAW,EAAE,YAAY,EACzB,mBAAmB,EAAE,oBAAoB,EACzC,UAAU,EAAE,WAAW,EAAE,oBAAoB,GAC9C,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAC9D,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,GAE9D,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,qBAAqB,EAAE,kBAAkB,EAAE,qBAAqB,EAChE,gBAAgB,EAAE,OAAO,EAAE,cAAc,GAE1C,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAC7C,iBAAiB,EAAE,wBAAwB,GAE5C,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,gBAAgB,EAAE,aAAa,EAC/B,eAAe,EAAE,eAAe,GACjC,MAAM,YAAY,CAAA"}

package/dist/flowrun/merge.d.ts

@@ -0,0 +1,24 @@
+import type { FlowRun, PRCheckpoints, Checkpoint, TaskState } from "./types.js";
+export interface BranchProtectionStatus {
+    exists: boolean;
+    requiredChecks: string[];
+    requiresPR: boolean;
+    dismissesStale: boolean;
+}
+export interface MergeGateResult {
+    allowed: boolean;
+    reason?: string;
+    checkpointResults: Record<string, "pending" | "pass" | "fail" | "skipped">;
+}
+export declare function checkBranchProtection(owner: string, repo: string): Promise<BranchProtectionStatus>;
+export declare function validateCheckpoint(cp: Checkpoint): "pending" | "pass" | "fail";
+export declare function validatePRCheckpoints(checkpoints: PRCheckpoints): MergeGateResult;
+export declare function canAutoMergeTask(flowRun: FlowRun, task: TaskState, protection: BranchProtectionStatus): MergeGateResult;
+export declare function mergePR(prNumber: number): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+export declare function createRevertPR(prNumber: number, reason: string): Promise<{
+    prNumber?: number;
+    error?: string;
+}>;

package/dist/flowrun/merge.js

@@ -0,0 +1,116 @@
+import { canMerge } from "./gate.js";
+import { gh } from "../util/gh.js";
+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,
+        };
+    }
+}
+export function validateCheckpoint(cp) {
+    if (cp.status === "pass")
+        return "pass";
+    if (cp.status === "fail")
+        return "fail";
+    return "pending";
+}
+export function validatePRCheckpoints(checkpoints) {
+    const gates = {
+        localChecks: checkpoints.localChecks,
+        ciChecks: checkpoints.ciChecks,
+        reviewerApproval: checkpoints.reviewerApproval,
+        goalVerification: checkpoints.goalVerification,
+        branchProtection: checkpoints.branchProtection,
+    };
+    const results = {};
+    for (const [name, cp] of Object.entries(gates)) {
+        results[name] = validateCheckpoint(cp);
+    }
+    const failures = Object.entries(gates).filter(([_, cp]) => cp.status === "fail");
+    if (failures.length > 0) {
+        return {
+            allowed: false,
+            reason: `Failed checkpoints: ${failures.map(([k]) => k).join(", ")}`,
+            checkpointResults: results,
+        };
+    }
+    const pending = Object.entries(gates).filter(([_, cp]) => cp.status === "pending");
+    if (pending.length > 0) {
+        return {
+            allowed: false,
+            reason: `Pending checkpoints: ${pending.map(([k]) => k).join(", ")}`,
+            checkpointResults: results,
+        };
+    }
+    return { allowed: true, checkpointResults: results };
+}
+export function canAutoMergeTask(flowRun, task, protection) {
+    const flowGate = canMerge(flowRun);
+    if (!flowGate.allowed) {
+        return { allowed: false, reason: flowGate.reason, checkpointResults: {} };
+    }
+    if (task.status === "merged") {
+        return { allowed: false, reason: "Task already merged", checkpointResults: {} };
+    }
+    if (task.status !== "reviewing") {
+        return { allowed: false, reason: `Task status is ${task.status}, expected reviewing`, checkpointResults: {} };
+    }
+    if (!task.prCheckpoints) {
+        return { allowed: false, reason: "No PR checkpoints recorded", checkpointResults: {} };
+    }
+    const prResult = validatePRCheckpoints(task.prCheckpoints);
+    if (!prResult.allowed)
+        return prResult;
+    if (!protection.exists) {
+        prResult.checkpointResults.branchProtection = "fail";
+        return {
+            allowed: false,
+            reason: "Branch protection not enabled on main",
+            checkpointResults: prResult.checkpointResults,
+        };
+    }
+    prResult.checkpointResults.branchProtection = "pass";
+    return prResult;
+}
+export async function mergePR(prNumber) {
+    try {
+        await gh(`pr merge ${prNumber} --squash --delete-branch`);
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+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 '${revertTitle}' --body '${revertBody}' --base main --head main`);
+        return { prNumber: parseInt(newPR.trim().split("/").pop() || "0", 10) };
+    }
+    catch (err) {
+        return { error: String(err) };
+    }
+}
+//# sourceMappingURL=merge.js.map

package/dist/flowrun/merge.js.map

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

package/dist/flowrun/resilience.d.ts

@@ -0,0 +1,18 @@
+import { type FlowRun } from "./types.js";
+export declare function getRuntimeMs(flowRun: FlowRun): number;
+export declare function hasRuntimeExpired(flowRun: FlowRun): boolean;
+export interface RuntimeCheckResult {
+    expired: boolean;
+    runtimeMs: number;
+    maxRuntimeMs: number;
+    remainingMs: number;
+}
+export declare function checkRuntime(flowRun: FlowRun): RuntimeCheckResult;
+export interface BackpressureStatus {
+    canContinue: boolean;
+    reason?: string;
+    rateLimitRemaining: number | null;
+    ciQueueLength: number | null;
+}
+export declare function checkBackpressure(owner: string, repo: string): Promise<BackpressureStatus>;
+export declare function buildContinuationContext(flowRun: FlowRun): string;

package/dist/flowrun/resilience.js

@@ -0,0 +1,80 @@
+import { DEFAULT_MAX_RUNTIME_MS, FLOW_RUN_STAGES } from "./types.js";
+import { gh } from "../util/gh.js";
+export function getRuntimeMs(flowRun) {
+    if (!flowRun.startedAt)
+        return 0;
+    return Date.now() - new Date(flowRun.startedAt).getTime();
+}
+export function hasRuntimeExpired(flowRun) {
+    const max = flowRun.maxRuntime || DEFAULT_MAX_RUNTIME_MS;
+    return getRuntimeMs(flowRun) > max;
+}
+export function checkRuntime(flowRun) {
+    const runtimeMs = getRuntimeMs(flowRun);
+    const maxRuntimeMs = flowRun.maxRuntime || DEFAULT_MAX_RUNTIME_MS;
+    return {
+        expired: runtimeMs > maxRuntimeMs,
+        runtimeMs,
+        maxRuntimeMs,
+        remainingMs: Math.max(0, maxRuntimeMs - runtimeMs),
+    };
+}
+export async function checkBackpressure(owner, repo) {
+    const status = {
+        canContinue: true,
+        rateLimitRemaining: null,
+        ciQueueLength: null,
+    };
+    try {
+        const { stdout } = await gh(`api rate_limit --jq .rate.remaining`);
+        const remaining = parseInt(stdout.trim(), 10);
+        status.rateLimitRemaining = remaining;
+        if (remaining < 100) {
+            status.canContinue = false;
+            status.reason = `GitHub API rate limit low: ${remaining} remaining`;
+            return status;
+        }
+    }
+    catch {
+        status.rateLimitRemaining = null;
+    }
+    try {
+        const { stdout } = await gh(`run list --repo ${owner}/${repo} --json status --jq '[.[] | select(.status == "queued" or .status == "in_progress")] | length'`);
+        const queueLen = parseInt(stdout.trim(), 10);
+        status.ciQueueLength = queueLen;
+        if (queueLen >= 10) {
+            status.canContinue = false;
+            status.reason = `CI queue too long: ${queueLen} queued/in_progress`;
+            return status;
+        }
+    }
+    catch {
+        status.ciQueueLength = null;
+    }
+    return status;
+}
+export function buildContinuationContext(flowRun) {
+    const parts = [
+        `FlowRun: ${flowRun.flowRunId}`,
+        `Status: ${flowRun.status}`,
+        `Runtime: ${Math.round(getRuntimeMs(flowRun) / 60000)} minutes`,
+        "",
+        "## Stage Status",
+    ];
+    for (const stage of FLOW_RUN_STAGES) {
+        const s = flowRun.stages[stage];
+        const checkSummary = s.checks
+            .map(c => `${c.name}=${c.status}`)
+            .join(", ");
+        parts.push(`- ${stage}: ${s.status}${checkSummary ? ` (${checkSummary})` : ""}`);
+    }
+    const taskEntries = Object.entries(flowRun.tasks);
+    if (taskEntries.length > 0) {
+        parts.push("", "## Tasks");
+        for (const [id, task] of taskEntries) {
+            parts.push(`- ${id}: ${task.status}${task.prNumber ? ` PR #${task.prNumber}` : ""}`);
+        }
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=resilience.js.map

package/dist/flowrun/resilience.js.map

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