@devcxl/opencode-cabbage 0.3.2 → 1.1.0

package/dist/flowrun/validator.js

@@ -1,209 +0,0 @@
-import { FLOW_RUN_STAGES, FLOW_RUN_STATUSES, TASK_STATUSES, STAGE_STATUSES, CHECKPOINT_STATUSES, } from "./types.js";
-export function validateFlowRun(raw) {
-    const errors = [];
-    if (!raw || typeof raw !== "object") {
-        errors.push({ path: "", message: "FlowRun must be a non-null object" });
-        return { data: null, errors };
-    }
-    const obj = raw;
-    if (typeof obj.flowRunId !== "string" || !obj.flowRunId) {
-        errors.push({ path: "flowRunId", message: "Required string" });
-    }
-    if (typeof obj.repo !== "string" || !obj.repo) {
-        errors.push({ path: "repo", message: "Required string" });
-    }
-    if (typeof obj.parentIssueNumber !== "number" || obj.parentIssueNumber <= 0) {
-        errors.push({ path: "parentIssueNumber", message: "Required positive number" });
-    }
-    if (!FLOW_RUN_STATUSES.includes(obj.status)) {
-        errors.push({ path: "status", message: `Must be one of: ${FLOW_RUN_STATUSES.join(", ")}` });
-    }
-    if (typeof obj.schemaVersion !== "number") {
-        errors.push({ path: "schemaVersion", message: "Required number" });
-    }
-    if (typeof obj.revision !== "number" || obj.revision < 0) {
-        errors.push({ path: "revision", message: "Required non-negative number" });
-    }
-    // v2: FlowRun 级 repositoryQualityPolicy
-    if (!obj.repositoryQualityPolicy || typeof obj.repositoryQualityPolicy !== "object") {
-        errors.push({ path: "repositoryQualityPolicy", message: "Required object" });
-    }
-    else {
-        const rqp = obj.repositoryQualityPolicy;
-        if (typeof rqp.mode !== "string" || !["off", "required"].includes(rqp.mode)) {
-            errors.push({ path: "repositoryQualityPolicy.mode", message: 'Must be "off" or "required"' });
-        }
-        if (!Array.isArray(rqp.requiredChecks)) {
-            errors.push({ path: "repositoryQualityPolicy.requiredChecks", message: "Required array" });
-        }
-    }
-    validateStages(obj.stages, errors);
-    validateTasks(obj.tasks, errors);
-    const data = errors.length === 0 ? raw : null;
-    return { data, errors };
-}
-function validateStages(stages, errors) {
-    if (!stages || typeof stages !== "object") {
-        errors.push({ path: "stages", message: "Required object with stage keys" });
-        return false;
-    }
-    const stageObj = stages;
-    for (const key of FLOW_RUN_STAGES) {
-        const s = stageObj[key];
-        if (!s || typeof s !== "object") {
-            errors.push({ path: `stages.${key}`, message: "Missing or invalid stage object" });
-            continue;
-        }
-        validateStage(key, s, errors);
-    }
-    return true;
-}
-function validateStage(stageKey, stage, errors) {
-    if (!STAGE_STATUSES.includes(stage.status)) {
-        errors.push({ path: `stages.${stageKey}.status`, message: "Invalid stage status" });
-    }
-    if (!Array.isArray(stage.requiredArtifacts)) {
-        errors.push({ path: `stages.${stageKey}.requiredArtifacts`, message: "Required array" });
-    }
-    if (typeof stage.completedAt !== "string" && stage.completedAt !== null) {
-        errors.push({ path: `stages.${stageKey}.completedAt`, message: "Must be string or null" });
-    }
-    if (!Array.isArray(stage.checks)) {
-        errors.push({ path: `stages.${stageKey}.checks`, message: "Required array" });
-    }
-    if (!Array.isArray(stage.evidence)) {
-        errors.push({ path: `stages.${stageKey}.evidence`, message: "Required array" });
-    }
-}
-function validateTasks(tasks, errors) {
-    if (!tasks || typeof tasks !== "object") {
-        errors.push({ path: "tasks", message: "Required object with task keys" });
-        return false;
-    }
-    const taskObj = tasks;
-    for (const [key, value] of Object.entries(taskObj)) {
-        if (!value || typeof value !== "object") {
-            errors.push({ path: `tasks.${key}`, message: "Invalid task object" });
-            continue;
-        }
-        validateTask(key, value, errors);
-    }
-    return true;
-}
-function validateTask(taskKey, task, errors) {
-    if (!task.id || typeof task.id !== "string") {
-        errors.push({ path: `tasks.${taskKey}.id`, message: "Required string" });
-    }
-    if (!TASK_STATUSES.includes(task.status)) {
-        errors.push({ path: `tasks.${taskKey}.status`, message: "Invalid task status" });
-    }
-    if (!Array.isArray(task.dependsOn)) {
-        errors.push({ path: `tasks.${taskKey}.dependsOn`, message: "Required array" });
-    }
-    if (!Array.isArray(task.expectedFiles)) {
-        errors.push({ path: `tasks.${taskKey}.expectedFiles`, message: "Required array" });
-    }
-    if (!Array.isArray(task.testCommands)) {
-        errors.push({ path: `tasks.${taskKey}.testCommands`, message: "Required array" });
-    }
-    // v2: acceptanceCriteria
-    if (!Array.isArray(task.acceptanceCriteria)) {
-        errors.push({ path: `tasks.${taskKey}.acceptanceCriteria`, message: "Required array" });
-    }
-    // v2: verifyCommands
-    if (!Array.isArray(task.verifyCommands)) {
-        errors.push({ path: `tasks.${taskKey}.verifyCommands`, message: "Required array" });
-    }
-    // v2: tddPolicy
-    if (!task.tddPolicy || typeof task.tddPolicy !== "object") {
-        errors.push({ path: `tasks.${taskKey}.tddPolicy`, message: "Required object" });
-    }
-    // v2: tddEvidence
-    if (!task.tddEvidence || typeof task.tddEvidence !== "object") {
-        errors.push({ path: `tasks.${taskKey}.tddEvidence`, message: "Required object" });
-    }
-}
-/**
- * 验证 Task DAG：
- * - Task ID 唯一
- * - record key 与 Task.id 一致
- * - 所有依赖存在
- * - 禁止自依赖
- * - 检测环路
- */
-export function validateFlowRunDag(tasks) {
-    const errors = [];
-    // Task ID 唯一（Record key 天然唯一，检查 key 与 id 是否一致）
-    const seenIds = new Set();
-    for (const [key, task] of Object.entries(tasks)) {
-        if (key !== task.id) {
-            errors.push({ path: `tasks.${key}`, message: `Record key "${key}" does not match task.id "${task.id}"` });
-        }
-        if (seenIds.has(task.id)) {
-            errors.push({ path: `tasks.${key}`, message: `Duplicate task id "${task.id}"` });
-        }
-        seenIds.add(task.id);
-    }
-    // 禁止自依赖 + 依赖存在
-    for (const [key, task] of Object.entries(tasks)) {
-        for (const dep of task.dependsOn) {
-            if (dep === task.id) {
-                errors.push({ path: `tasks.${key}.dependsOn`, message: `Task "${task.id}" depends on itself` });
-            }
-            if (!seenIds.has(dep)) {
-                errors.push({ path: `tasks.${key}.dependsOn`, message: `Dependency "${dep}" not found in tasks` });
-            }
-        }
-    }
-    // 环路检测（拓扑排序）
-    if (errors.length === 0) {
-        const cycleError = detectCycle(tasks, seenIds);
-        if (cycleError) {
-            errors.push(cycleError);
-        }
-    }
-    return errors;
-}
-/**
- * 拓扑排序检测环路，返回发现环路时的错误
- */
-function detectCycle(tasks, allIds) {
-    const inDegree = new Map();
-    const adjacency = new Map();
-    for (const id of allIds) {
-        inDegree.set(id, 0);
-        adjacency.set(id, []);
-    }
-    for (const task of Object.values(tasks)) {
-        for (const dep of task.dependsOn) {
-            adjacency.get(dep).push(task.id);
-            inDegree.set(task.id, (inDegree.get(task.id) ?? 0) + 1);
-        }
-    }
-    const queue = [];
-    for (const [id, degree] of inDegree) {
-        if (degree === 0)
-            queue.push(id);
-    }
-    let visitedCount = 0;
-    while (queue.length > 0) {
-        const current = queue.shift();
-        visitedCount++;
-        for (const neighbor of adjacency.get(current) ?? []) {
-            const newDegree = (inDegree.get(neighbor) ?? 1) - 1;
-            inDegree.set(neighbor, newDegree);
-            if (newDegree === 0)
-                queue.push(neighbor);
-        }
-    }
-    if (visitedCount !== allIds.size) {
-        // 找出环路中的节点
-        const cycleNodes = [...allIds].filter(id => (inDegree.get(id) ?? 0) > 0);
-        return {
-            path: "tasks",
-            message: `Circular dependency detected involving: ${cycleNodes.join(", ")}`,
-        };
-    }
-    return null;
-}
-//# sourceMappingURL=validator.js.map

package/dist/flowrun/validator.js.map

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

package/dist/plugin/broker.d.ts

@@ -1,73 +0,0 @@
-import type { FlowRun } from "../flowrun/types.js";
-export interface BrokerCredentials {
-    /** 独立 GitHub API token（不传入 Agent shell） */
-    token: string;
-}
-export interface MutateResult<R> {
-    flowRun: FlowRun;
-    result: R;
-    shouldPersist: boolean;
-}
-export type WriteResult<R> = {
-    ok: true;
-    flowRun: FlowRun;
-    result: R;
-    persisted: boolean;
-} | {
-    ok: false;
-    code: "PERSIST_CONFLICT" | "READ_FAILED";
-    message: string;
-};
-/**
- * 单进程 broker，负责：
- * 1. 按 parentIssueNumber 的 keyed mutex 串行所有 FlowRun 写入
- * 2. read-modify-write 循环（乐观锁）
- * 3. 检测外部 body 变化 → PERSIST_CONFLICT
- * 4. 持有独立 GitHub API 凭证，Agent shell 不可访问
- *
- * 所有 FlowRun/Task/Evidence 写入必须经过 broker，不直接暴露 GitHub API。
- *
- * 凭证安全：credentials 存储在闭包变量中，不挂载在 this 上，
- * JSON.stringify / Object.keys 无法访问。
- */
-export declare class FlowBroker {
-    #private;
-    private mutex;
-    /**
-     * @param credentials  可选。独立 GitHub API 凭证。
-     *                     传入时：所有 gh 操作使用该 token，而非 ambient 环境。
-     *                     不传时：降级使用 ambient 环境变量（GH_TOKEN etc.）。
-     */
-    constructor(credentials?: BrokerCredentials);
-    /**
-     * 获取凭证对应的环境变量覆盖（仅内部使用）。
-     * 返回 undefined 表示无独立凭证，应使用 ambient 环境。
-     */
-    private get ghEnv();
-    /**
-     * 验证 broker 持有的 GitHub 凭证是否有效。
-     *
-     * 调用 `gh auth status` 检查 token 可用性。
-     * 无凭证时返回 ok: false。
-     */
-    verifyCredentials(): Promise<{
-        ok: boolean;
-        message: string;
-    }>;
-    /**
-     * 将操作加入 keyed mutex 队列。
-     *
-     * 用于需要串行化但对 FlowRun 无影响的通用操作。
-     */
-    enqueue<T>(parentIssueNumber: number, op: () => Promise<T>): Promise<T>;
-    /**
-     * read-modify-write 循环：读取 FlowRun → 应用 handler 变更 → 乐观锁写回。
-     *
-     * - handler 返回 { flowRun, result, shouldPersist }
-     * - shouldPersist=false 时跳过写入（如校验失败）
-     * - 自动增加 revision 和时间戳
-     * - body 不匹配时返回 PERSIST_CONFLICT
-     * - 使用 broker 独立凭证执行 gh 操作
-     */
-    writeFlowRunWithLock<R>(issueNumber: number, handler: (flowRun: FlowRun) => MutateResult<R>): Promise<WriteResult<R>>;
-}

package/dist/plugin/broker.js

@@ -1,140 +0,0 @@
-import { readFlowRunWithLock, writeFlowRunWithLock as ghWriteFlowRunWithLock } from "../flowrun/github.js";
-// ─── Keyed Mutex ───
-/**
- * 按 key 隔离的互斥锁，用于单进程内串行化并发操作。
- *
- * 每个 key（parentIssueNumber）维护独立的 promise 链，
- * 相同 key 的操作依次执行，不同 key 的操作可以并行。
- */
-class KeyedMutex {
-    locks = new Map();
-    async runExclusive(key, fn) {
-        const prev = this.locks.get(key) ?? Promise.resolve();
-        let release;
-        const next = new Promise(r => {
-            release = r;
-        });
-        this.locks.set(key, next);
-        await prev;
-        try {
-            return await fn();
-        }
-        finally {
-            release();
-        }
-    }
-}
-// ─── FlowBroker ───
-/**
- * 单进程 broker，负责：
- * 1. 按 parentIssueNumber 的 keyed mutex 串行所有 FlowRun 写入
- * 2. read-modify-write 循环（乐观锁）
- * 3. 检测外部 body 变化 → PERSIST_CONFLICT
- * 4. 持有独立 GitHub API 凭证，Agent shell 不可访问
- *
- * 所有 FlowRun/Task/Evidence 写入必须经过 broker，不直接暴露 GitHub API。
- *
- * 凭证安全：credentials 存储在闭包变量中，不挂载在 this 上，
- * JSON.stringify / Object.keys 无法访问。
- */
-export class FlowBroker {
-    mutex = new KeyedMutex();
-    #credentials;
-    /**
-     * @param credentials  可选。独立 GitHub API 凭证。
-     *                     传入时：所有 gh 操作使用该 token，而非 ambient 环境。
-     *                     不传时：降级使用 ambient 环境变量（GH_TOKEN etc.）。
-     */
-    constructor(credentials) {
-        this.#credentials = credentials ?? null;
-    }
-    /**
-     * 获取凭证对应的环境变量覆盖（仅内部使用）。
-     * 返回 undefined 表示无独立凭证，应使用 ambient 环境。
-     */
-    get ghEnv() {
-        if (!this.#credentials)
-            return undefined;
-        return {
-            GH_TOKEN: this.#credentials.token,
-            GITHUB_TOKEN: this.#credentials.token,
-        };
-    }
-    /**
-     * 验证 broker 持有的 GitHub 凭证是否有效。
-     *
-     * 调用 `gh auth status` 检查 token 可用性。
-     * 无凭证时返回 ok: false。
-     */
-    async verifyCredentials() {
-        if (!this.#credentials) {
-            return { ok: false, message: "No broker credentials configured" };
-        }
-        try {
-            const { gh } = await import("../util/gh.js");
-            await gh("auth status", 15_000, this.ghEnv);
-            return { ok: true, message: "Broker credentials are valid" };
-        }
-        catch (err) {
-            return { ok: false, message: `Broker credentials verification failed: ${String(err)}` };
-        }
-    }
-    /**
-     * 将操作加入 keyed mutex 队列。
-     *
-     * 用于需要串行化但对 FlowRun 无影响的通用操作。
-     */
-    async enqueue(parentIssueNumber, op) {
-        return this.mutex.runExclusive(parentIssueNumber, op);
-    }
-    /**
-     * read-modify-write 循环：读取 FlowRun → 应用 handler 变更 → 乐观锁写回。
-     *
-     * - handler 返回 { flowRun, result, shouldPersist }
-     * - shouldPersist=false 时跳过写入（如校验失败）
-     * - 自动增加 revision 和时间戳
-     * - body 不匹配时返回 PERSIST_CONFLICT
-     * - 使用 broker 独立凭证执行 gh 操作
-     */
-    async writeFlowRunWithLock(issueNumber, handler) {
-        return this.mutex.runExclusive(issueNumber, async () => {
-            // ── 读取（broker 凭证） ──
-            const { flowRunResult, currentBody } = await readFlowRunWithLock(issueNumber, this.ghEnv);
-            if (!flowRunResult.ok || currentBody === null) {
-                return {
-                    ok: false,
-                    code: "READ_FAILED",
-                    message: `Failed to read FlowRun from issue #${issueNumber}: ${flowRunResult.ok ? "missing body" : flowRunResult.code}`,
-                };
-            }
-            // ── 修改 ──
-            const { flowRun: updated, result, shouldPersist } = handler(flowRunResult.data);
-            if (!shouldPersist) {
-                return {
-                    ok: true,
-                    flowRun: flowRunResult.data,
-                    result,
-                    persisted: false,
-                };
-            }
-            // ── 写入（乐观锁，broker 凭证） ──
-            updated.revision += 1;
-            updated.lastTickAt = new Date().toISOString();
-            const writeResult = await ghWriteFlowRunWithLock(issueNumber, updated, currentBody, this.ghEnv);
-            if (!writeResult.success) {
-                return {
-                    ok: false,
-                    code: "PERSIST_CONFLICT",
-                    message: writeResult.error ?? "Issue body changed since last read — external modification detected",
-                };
-            }
-            return {
-                ok: true,
-                flowRun: updated,
-                result,
-                persisted: true,
-            };
-        });
-    }
-}
-//# sourceMappingURL=broker.js.map

package/dist/plugin/broker.js.map

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

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

@@ -1,62 +0,0 @@
-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>;