@devcxl/opencode-cabbage 0.3.2 → 1.1.0

package/dist/flowrun/transitions.js

@@ -1,168 +0,0 @@
-import { canStartStage, canCompleteStage, canStartTask, canMerge, } from "./gate.js";
-// ─── 受控 stage 集合 ───
-/** flow_control 可启动的 stage */
-const STARTABLE_STAGES = ["requirements", "design", "tasks", "code"];
-/** flow_control 可完成的 stage（code/test/review/merge 由 finalize 完成） */
-const COMPLETABLE_STAGES = ["requirements", "design", "tasks"];
-function gateToError(gate) {
-    return {
-        code: "GATE_BLOCKED",
-        message: gate.reason ?? "Gate check failed",
-    };
-}
-// ─── FlowRun 状态迁移 ───
-/**
- * 启动 FlowRun：planned → running
- *
- * 幂等：已经是 running 则直接返回（不报错）。
- */
-export function flowRunStart(flowRun) {
-    if (flowRun.status === "running") {
-        return { ok: true, value: flowRun };
-    }
-    if (flowRun.status !== "planned") {
-        return {
-            ok: false,
-            error: { code: "INVALID_TRANSITION", message: `FlowRun is ${flowRun.status}, not planned` },
-        };
-    }
-    flowRun.status = "running";
-    flowRun.startedAt = new Date().toISOString();
-    return { ok: true, value: flowRun };
-}
-// ─── Stage 状态迁移 ───
-/**
- * 启动 Stage：pending → running
- *
- * 约束：
- * - 仅允许 requirements/design/tasks/code
- * - 验证前置 stage 已 pass
- *
- * 幂等：已经是 running 则直接返回。
- */
-export function flowStageStart(flowRun, stage) {
-    if (!STARTABLE_STAGES.includes(stage)) {
-        return {
-            ok: false,
-            error: { code: "STAGE_NOT_CONTROLLABLE", message: `Stage "${stage}" cannot be started via flow_control` },
-        };
-    }
-    if (flowRun.stages[stage].status === "running") {
-        return { ok: true, value: flowRun };
-    }
-    const gate = canStartStage(flowRun, stage);
-    if (!gate.allowed) {
-        return { ok: false, error: gateToError(gate) };
-    }
-    flowRun.stages[stage].status = "running";
-    return { ok: true, value: flowRun };
-}
-/**
- * 完成 Stage：running → pass
- *
- * 约束：
- * - 仅允许 requirements/design/tasks
- * - code/test/review/merge 由 finalize 完成
- * - 验证 pending checks 均已 pass
- *
- * 幂等：已经是 pass 则直接返回。
- */
-export function flowStageComplete(flowRun, stage) {
-    if (!COMPLETABLE_STAGES.includes(stage)) {
-        return {
-            ok: false,
-            error: { code: "STAGE_NOT_CONTROLLABLE", message: `Stage "${stage}" completion is only via finalize` },
-        };
-    }
-    if (flowRun.stages[stage].status === "pass") {
-        return { ok: true, value: flowRun };
-    }
-    const gate = canCompleteStage(flowRun, stage);
-    if (!gate.allowed) {
-        return { ok: false, error: gateToError(gate) };
-    }
-    flowRun.stages[stage].status = "pass";
-    flowRun.stages[stage].completedAt = new Date().toISOString();
-    return { ok: true, value: flowRun };
-}
-// ─── Task 状态迁移 ───
-/**
- * 启动 Task：pending/ready → running
- *
- * 步骤：
- * 1. gate check：canStartTask（依赖已 merged、code stage 活跃等）
- * 2. policy 冻结：如果传入 tddPolicy，则覆盖 TaskState.tddPolicy
- * 3. 写入 executionBinding
- * 4. status → running
- *
- * 幂等：已经是 running 则直接返回（相同 taskId）。
- */
-export function flowTaskStart(flowRun, taskId, executionBinding, tddPolicy) {
-    const task = flowRun.tasks[taskId];
-    if (!task) {
-        return {
-            ok: false,
-            error: { code: "TASK_NOT_FOUND", message: `Task "${taskId}" not found in FlowRun` },
-        };
-    }
-    // 幂等：已经是 running
-    if (task.status === "running") {
-        // 更新 executionBinding（可能重连）
-        task.executionBinding = executionBinding;
-        return { ok: true, value: { flowRun, task } };
-    }
-    const gate = canStartTask(flowRun, taskId);
-    if (!gate.allowed) {
-        return { ok: false, error: gateToError(gate) };
-    }
-    // 冻结 policy
-    if (tddPolicy) {
-        task.tddPolicy = tddPolicy;
-    }
-    // 写入 execution binding
-    task.executionBinding = executionBinding;
-    task.status = "running";
-    task.startedAt = new Date().toISOString();
-    return { ok: true, value: { flowRun, task } };
-}
-// ─── FlowRun Finalize ───
-/**
- * FlowRun 终态绑定：所有 Task merged 后，顺序标记 code→test→review→merge 为 pass，
- * 并将 FlowRun 状态设为 completed。
- *
- * 规则：
- * - canMerge() 必须通过（所有 Task merged + FlowRun status 为 running/merging）
- * - 对 code/test/review/merge 四个 stage：若未 pass 则逐个标记 pass
- * - FlowRun status → completed，设置 completedAt
- *
- * 幂等：已经是 completed 则直接返回（不修改任何字段）。
- */
-export function flowRunFinalize(flowRun) {
-    // 幂等：已 completed
-    if (flowRun.status === "completed") {
-        return { ok: true, value: flowRun };
-    }
-    // 前置检查：canMerge（所有 Task merged + FlowRun 状态正确）
-    const mergeGate = canMerge(flowRun);
-    if (!mergeGate.allowed) {
-        return { ok: false, error: gateToError(mergeGate) };
-    }
-    // 顺序标记 finalize stages
-    const finalizeStages = ["code", "test", "review", "merge"];
-    for (const stage of finalizeStages) {
-        const stageState = flowRun.stages[stage];
-        if (!stageState)
-            continue;
-        // 已经是 pass → 跳过
-        if (stageState.status === "pass")
-            continue;
-        // 标记 pass
-        stageState.status = "pass";
-        stageState.completedAt = new Date().toISOString();
-    }
-    // FlowRun → completed
-    flowRun.status = "completed";
-    flowRun.completedAt = new Date().toISOString();
-    return { ok: true, value: flowRun };
-}
-//# sourceMappingURL=transitions.js.map

package/dist/flowrun/transitions.js.map

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

package/dist/flowrun/types.d.ts

@@ -1,356 +0,0 @@
-export declare const FLOW_RUN_STAGES: readonly ["requirements", "design", "tasks", "code", "test", "review", "merge"];
-export type FlowStage = typeof FLOW_RUN_STAGES[number];
-export declare const FLOW_RUN_STATUSES: readonly ["planned", "running", "blocked", "merging", "completed", "cancelled"];
-export type FlowRunStatus = typeof FLOW_RUN_STATUSES[number];
-export declare const TASK_STATUSES: readonly ["pending", "ready", "running", "blocked", "reviewing", "merged", "cancelled"];
-export type TaskStatus = typeof TASK_STATUSES[number];
-export declare const STAGE_STATUSES: readonly ["pending", "running", "pass", "failed", "blocked"];
-export type StageStatus = typeof STAGE_STATUSES[number];
-export declare const CHECKPOINT_STATUSES: readonly ["pending", "pass", "fail"];
-export type CheckpointStatus = typeof CHECKPOINT_STATUSES[number];
-export interface EvidenceEntry {
-    command: string;
-    exitCode: number | null;
-    summary: string;
-    timestamp: string;
-}
-export interface Checkpoint {
-    name: string;
-    status: CheckpointStatus;
-    evidence: EvidenceEntry[];
-}
-export interface StageState {
-    status: StageStatus;
-    requiredArtifacts: string[];
-    checks: Checkpoint[];
-    completedAt: string | null;
-    evidence: EvidenceEntry[];
-}
-export interface AcceptanceCriterion {
-    id: string;
-    description: string;
-    verification: "tdd" | "regression" | "manual";
-}
-export type TddMode = "strict" | "relaxed" | "bypass";
-export type TddEnforcement = "advisory" | "runtime";
-export interface TddRunnerPolicy {
-    adapter: "vitest";
-    baseCommand: string;
-    timeoutMs: number;
-    executionInputPatterns: string[];
-}
-export interface VersionedDigest {
-    algorithm: "sha256-content-v1" | "sha256-output-v1" | "git-tree-v1";
-    value: string;
-}
-export type TddApproval = {
-    kind: "planning-pr";
-    repo: string;
-    prNumber: number;
-    reviewId: number;
-    approver: string;
-    mergedCommitSha: string;
-    policyDigest: string;
-} | {
-    kind: "issue-comment";
-    repo: string;
-    issueNumber: number;
-    commentId: number;
-    approver: string;
-    commentBodyDigest: VersionedDigest;
-    policyDigest: string;
-} | {
-    kind: "legacy-migration";
-    fromSchemaVersion: 1;
-};
-export interface TaskCommand {
-    command: string;
-    cwd: string;
-    timeoutMs: number;
-    env: Record<string, string>;
-}
-export type AlternativeValidation = {
-    validationId: string;
-    kind: "command";
-    command: TaskCommand;
-} | {
-    validationId: string;
-    kind: "manual";
-    description: string;
-};
-export interface TddException {
-    reason: string;
-    alternativeValidation: AlternativeValidation[];
-    approval: TddApproval;
-}
-export interface TddPolicy {
-    mode: TddMode;
-    enforcement: TddEnforcement;
-    runner: TddRunnerPolicy | null;
-    testFilePatterns: string[];
-    implementationFilePatterns: string[];
-    generatedArtifactPatterns: string[];
-    exception: TddException | null;
-    source: {
-        manifestPath: string;
-        revisionSha: string;
-    };
-}
-export type TddFailureKind = "assertion" | "missing-behavior" | "infrastructure" | "timeout" | "unknown";
-export interface TddCommandEvidence {
-    command: string;
-    testSelector: string | null;
-    exitCode: number | null;
-    failureKind: TddFailureKind | null;
-    testsCollected: number | null;
-    testsFailed: number | null;
-    startedAt: string;
-    finishedAt: string;
-    durationMs: number;
-    changedFiles: string[];
-    outputDigest: VersionedDigest;
-    workspaceDigest: VersionedDigest;
-    executionInputDigest: VersionedDigest;
-    summary: string;
-}
-export interface TddTaskStartEvidence {
-    status: "pending" | "pass" | "fail";
-    headSha: string | null;
-    treeSha: string | null;
-    startedAt: string | null;
-}
-export interface TaskExecutionBinding {
-    branch: string;
-    baseSha: string;
-    startHeadSha: string;
-    worktreeId: string;
-    sessionId: string;
-}
-export interface TddCycleEvidence {
-    cycleId: string;
-    criterionId: string;
-    reworkRevision: number;
-    status: "started" | "red" | "pass" | "failed" | "abandoned";
-    startWorkspaceDigest: VersionedDigest;
-    testFiles: string[];
-    redTestDigest: VersionedDigest | null;
-    redAttempts: TddCommandEvidence[];
-    greenAttempts: TddCommandEvidence[];
-}
-export interface TddRegressionEvidence {
-    status: "pending" | "pass" | "fail" | "skipped";
-    headSha: string | null;
-    treeSha: string | null;
-    reworkRevision: number;
-    runs: TddCommandEvidence[];
-}
-export interface FinalVerificationEvidence {
-    status: "pending" | "pass" | "fail";
-    headSha: string | null;
-    treeSha: string | null;
-    runs: TddCommandEvidence[];
-}
-export type AlternativeValidationEvidence = {
-    validationId: string;
-    kind: "command";
-    status: "pass" | "fail";
-    headSha: string;
-    treeSha: string;
-    reworkRevision: number;
-    evidence: TddCommandEvidence;
-} | {
-    validationId: string;
-    kind: "manual";
-    status: "pass" | "fail";
-    headSha: string;
-    treeSha: string;
-    reworkRevision: number;
-    reviewRef: string;
-    reviewer: string;
-    contentDigest: VersionedDigest;
-    policyDigest: string;
-    summary: string;
-};
-export interface ReworkApproval {
-    reworkRevision: number;
-    kind: "refactor";
-    headSha: string;
-    treeSha: string;
-    reviewerSessionId: string;
-    reviewerMessageId: string;
-    contentDigest: VersionedDigest;
-    policyDigest: string;
-}
-export interface TddReworkEvidence {
-    reworkRevision: number;
-    kind: "behavior" | "refactor";
-    affectedCriterionIds: string[];
-    status: "started" | "evidence-ready" | "pass" | "fail";
-    startHeadSha: string;
-    approval: ReworkApproval | null;
-}
-export interface TddEvidence {
-    revision: number;
-    reworkRevision: number;
-    status: "not-recorded" | "pending" | "in-progress" | "pass" | "fail" | "waived";
-    taskStart: TddTaskStartEvidence;
-    cycles: TddCycleEvidence[];
-    regression: TddRegressionEvidence;
-    verification: FinalVerificationEvidence;
-    alternativeValidation: AlternativeValidationEvidence[];
-    reworks: TddReworkEvidence[];
-    warnings: string[];
-    updatedAt: string | null;
-}
-export interface CoveragePolicy {
-    command: string;
-    threshold: number;
-    report: {
-        format: "istanbul-json-summary";
-        path: string;
-        metric: "lines";
-    };
-}
-export interface CoverageEvidence {
-    status: "pending" | "pass" | "fail";
-    headSha: string;
-    actual: number | null;
-    threshold: number;
-    metric: "lines";
-    reportDigest: string | null;
-    summary: string;
-}
-export interface TddComplianceCheckpoint {
-    status: "pending" | "pass" | "fail" | "waived";
-    evidenceRevision: number;
-    reworkRevision: number;
-    headSha: string;
-    treeSha: string;
-    summary: string;
-}
-export interface PRCheckpoints {
-    prNumber: number;
-    localChecks: Checkpoint;
-    ciChecks: Checkpoint;
-    reviewerApproval: Checkpoint;
-    goalVerification: Checkpoint;
-    branchProtection: Checkpoint;
-    mergeResult: Checkpoint;
-    tddCompliance: TddComplianceCheckpoint | null;
-    verification: FinalVerificationEvidence | null;
-    coverage: CoverageEvidence | null;
-    qualityContractDigest: string | null;
-}
-export interface TaskState {
-    id: string;
-    name: string;
-    status: TaskStatus;
-    dependsOn: string[];
-    area: string;
-    expectedFiles: string[];
-    parallelSafe: boolean;
-    prNumber: number | null;
-    prCheckpoints: PRCheckpoints | null;
-    blockedReason: string | null;
-    startedAt: string | null;
-    acceptanceCriteria: AcceptanceCriterion[];
-    testCommands: TaskCommand[];
-    verifyCommands: TaskCommand[];
-    executionBinding: TaskExecutionBinding | null;
-    tddPolicy: TddPolicy;
-    tddEvidence: TddEvidence;
-    coveragePolicy: CoveragePolicy | null;
-}
-export interface RepositoryQualityPolicy {
-    mode: "off" | "required";
-    requiredChecks: Array<{
-        context: string;
-        appId: number;
-        workflowPath: string;
-        workflowRef: string;
-        workflowBlobSha: string;
-    }>;
-}
-export interface FlowRun {
-    flowRunId: string;
-    repo: string;
-    parentIssueNumber: number;
-    status: FlowRunStatus;
-    schemaVersion: number;
-    revision: number;
-    stages: Record<FlowStage, StageState>;
-    tasks: Record<string, TaskState>;
-    startedAt: string | null;
-    lastTickAt: string | null;
-    nextTickAfter: string | null;
-    maxRuntime: number;
-    completedAt: string | null;
-    repositoryQualityPolicy: RepositoryQualityPolicy;
-}
-export interface GoalFlowRunRef {
-    repo: string;
-    parentIssueNumber: number;
-    flowRunId: string;
-}
-export type FlowControlOp = "run-start" | "stage-start" | "stage-complete" | "task-start" | "pr-create" | "run-finalize";
-export interface FlowControlRequest {
-    op: FlowControlOp;
-    parentIssueNumber: number;
-    stage?: FlowStage;
-    taskId?: string;
-    executionBinding?: TaskExecutionBinding;
-    tddPolicy?: TddPolicy;
-    currentHeadSha?: string;
-    prTitle?: string;
-    prBody?: string;
-    baseBranch?: string;
-}
-export interface FlowControlResponse {
-    ok: boolean;
-    error?: {
-        code: string;
-        message: string;
-    };
-    flowRunStatus?: FlowRunStatus;
-    stage?: {
-        name: FlowStage;
-        status: StageStatus;
-    };
-    task?: {
-        taskId: string;
-        status: TaskStatus;
-        executionBinding?: TaskExecutionBinding | null;
-    };
-    pr?: {
-        prNumber: number;
-        prUrl: string;
-        created: boolean;
-    };
-}
-export interface ValidationError {
-    path: string;
-    message: string;
-}
-export type FlowRunReadResult = {
-    ok: true;
-    data: FlowRun;
-    migrated: boolean;
-} | {
-    ok: false;
-    code: "NOT_FOUND" | "INVALID_JSON" | "UNSUPPORTED_SCHEMA" | "MIGRATION_FAILED" | "VALIDATION_FAILED";
-    errors: ValidationError[];
-};
-export declare const CURRENT_SCHEMA_VERSION = 2;
-export declare const DEFAULT_MAX_RUNTIME_MS = 86400000;
-export declare const CABINET_START_MARKER = "<!-- cabbage-flow-run:start -->";
-export declare const CABINET_END_MARKER = "<!-- cabbage-flow-run:end -->";
-export declare const LABEL_PREFIX = "cabbage:";
-export declare const FLOW_RUN_LABELS: {
-    readonly flow: "cabbage:flow";
-    readonly running: "cabbage:running";
-    readonly blocked: "cabbage:blocked";
-    readonly merging: "cabbage:merging";
-    readonly completed: "cabbage:completed";
-    readonly cancelled: "cabbage:cancelled";
-    readonly resume: "cabbage:resume";
-};

package/dist/flowrun/types.js

@@ -1,21 +0,0 @@
-export const FLOW_RUN_STAGES = ["requirements", "design", "tasks", "code", "test", "review", "merge"];
-export const FLOW_RUN_STATUSES = ["planned", "running", "blocked", "merging", "completed", "cancelled"];
-export const TASK_STATUSES = ["pending", "ready", "running", "blocked", "reviewing", "merged", "cancelled"];
-export const STAGE_STATUSES = ["pending", "running", "pass", "failed", "blocked"];
-export const CHECKPOINT_STATUSES = ["pending", "pass", "fail"];
-// ─── 常量 ───
-export const CURRENT_SCHEMA_VERSION = 2;
-export const DEFAULT_MAX_RUNTIME_MS = 86_400_000;
-export const CABINET_START_MARKER = "<!-- cabbage-flow-run:start -->";
-export const CABINET_END_MARKER = "<!-- cabbage-flow-run:end -->";
-export const LABEL_PREFIX = "cabbage:";
-export const FLOW_RUN_LABELS = {
-    flow: `${LABEL_PREFIX}flow`,
-    running: `${LABEL_PREFIX}running`,
-    blocked: `${LABEL_PREFIX}blocked`,
-    merging: `${LABEL_PREFIX}merging`,
-    completed: `${LABEL_PREFIX}completed`,
-    cancelled: `${LABEL_PREFIX}cancelled`,
-    resume: `${LABEL_PREFIX}resume`,
-};
-//# sourceMappingURL=types.js.map

package/dist/flowrun/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/flowrun/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAA;AAG9G,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAU,CAAA;AAGhH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAA;AAGpH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAA;AAG1F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAU,CAAA;AAoZvE,aAAa;AAEb,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAA;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAA;AAEhD,MAAM,CAAC,MAAM,oBAAoB,GAAG,iCAAiC,CAAA;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,+BAA+B,CAAA;AAEjE,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAA;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,GAAG,YAAY,MAAM;IAC3B,OAAO,EAAE,GAAG,YAAY,SAAS;IACjC,OAAO,EAAE,GAAG,YAAY,SAAS;IACjC,OAAO,EAAE,GAAG,YAAY,SAAS;IACjC,SAAS,EAAE,GAAG,YAAY,WAAW;IACrC,SAAS,EAAE,GAAG,YAAY,WAAW;IACrC,MAAM,EAAE,GAAG,YAAY,QAAQ;CACvB,CAAA"}

package/dist/flowrun/validator.d.ts

@@ -1,19 +0,0 @@
-import { type FlowRun, type TaskState, type ValidationError } from "./types.js";
-export type { ValidationError } from "./types.js";
-export declare function validateFlowRun(raw: unknown): {
-    data: FlowRun | null;
-    errors: ValidationError[];
-};
-export interface DagValidationError {
-    path: string;
-    message: string;
-}
-/**
- * 验证 Task DAG：
- * - Task ID 唯一
- * - record key 与 Task.id 一致
- * - 所有依赖存在
- * - 禁止自依赖
- * - 检测环路
- */
-export declare function validateFlowRunDag(tasks: Record<string, TaskState>): DagValidationError[];