gateproof 0.2.2 → 0.2.4

package/dist/prd/loop.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Native PRD loop function - enables agents and scripts to run the retry loop
+ * without external bash orchestration.
+ *
+ * This is an additive feature - the existing `bun run prd:loop` command remains unchanged.
+ */
+import type { Story } from "./types";
+import type { PrdReportV1 } from "../report";
+/**
+ * Context provided to custom agent functions
+ */
+export interface AgentContext {
+    /** The relevant PRD slice (title + failing story details) */
+    prdSlice: string;
+    /** Summary of what failed and why */
+    failureSummary: string;
+    /** Recent git diff (truncated if too large) */
+    recentDiff: string;
+    /** The full PRD content */
+    prdContent: string;
+    /** The failed story details */
+    failedStory?: Story;
+    /** The report from the last run */
+    lastReport?: PrdReportV1;
+    /** Current iteration number */
+    iteration: number;
+    /** Abort signal — agents should pass this to long-running calls so they can be cancelled on timeout */
+    signal?: AbortSignal;
+}
+/**
+ * Result from a custom agent function
+ */
+export interface AgentResult {
+    /** List of changes made (for logging) */
+    changes: string[];
+    /** Optional commit message if autoCommit is enabled */
+    commitMsg?: string;
+}
+/**
+ * Callback for iteration status updates
+ */
+export interface IterationStatus {
+    /** Current attempt number (1-indexed) */
+    attempt: number;
+    /** Whether this attempt passed all gates */
+    passed: boolean;
+    /** Failure details if !passed */
+    failure?: string;
+    /** The failed story if any */
+    failedStory?: Story;
+    /** Duration of this iteration in ms */
+    durationMs: number;
+}
+/**
+ * Options for runPrdLoop
+ */
+export interface PrdLoopOptions {
+    /** Maximum iterations before giving up (default: 7) */
+    maxIterations?: number;
+    /** Maximum wall-clock time for the entire loop in ms. Aborts after this budget is exhausted. */
+    maxTotalMs?: number;
+    /** Maximum time for a single agent call in ms. The agent is aborted if it exceeds this. */
+    iterationTimeoutMs?: number;
+    /** Custom agent function to make changes. If not provided, uses default OpenCode Zen agent. */
+    agent?: (ctx: AgentContext) => Promise<AgentResult>;
+    /** Callback fired after each iteration */
+    onIteration?: (status: IterationStatus) => void;
+    /** Auto-commit changes after each successful agent run */
+    autoCommit?: boolean | {
+        /** Use simple-git instance for commits */
+        git?: {
+            commit: (message: string) => Promise<void>;
+            add: (files: string[]) => Promise<void>;
+        };
+    };
+    /** Working directory (default: process.cwd()) */
+    cwd?: string;
+    /** Path to write PRD report (default: .gateproof/prd-report.json) */
+    reportPath?: string;
+    /** Whether to check scope constraints (default: true) */
+    checkScope?: boolean;
+    /** Git ref for scope checking */
+    baseRef?: string;
+    /** Append evidence to .gateproof/evidence.log */
+    writeEvidenceLog?: boolean;
+    /** Quiet mode - suppress console output */
+    quiet?: boolean;
+}
+/**
+ * Result from runPrdLoop
+ */
+export interface PrdLoopResult {
+    /** Whether all gates eventually passed */
+    success: boolean;
+    /** Number of iterations run */
+    attempts: number;
+    /** Final failure message if !success */
+    finalFailure?: string;
+    /** The last report */
+    lastReport?: PrdReportV1;
+    /** Total duration in ms */
+    totalDurationMs: number;
+}
+/**
+ * Runs the PRD loop, iterating until all gates pass or maxIterations is reached.
+ *
+ * This is the native, programmatic way to run the gateproof retry loop.
+ * It can be called from scripts, tests, or integrated into custom tooling.
+ *
+ * @example
+ * ```ts
+ * import { runPrdLoop } from "gateproof/prd";
+ *
+ * const result = await runPrdLoop("./prd.ts", {
+ *   maxIterations: 5,
+ *   maxTotalMs: 300_000, // 5 minute wall-clock budget
+ *   iterationTimeoutMs: 60_000, // 1 minute per agent call
+ *   agent: async (ctx) => {
+ *     // Make changes based on ctx.failureSummary
+ *     return { changes: ["fixed the bug"] };
+ *   },
+ *   onIteration: (status) => {
+ *     console.log(`Attempt ${status.attempt}: ${status.passed ? "passed" : "failed"}`);
+ *   },
+ * });
+ *
+ * if (result.success) {
+ *   console.log("All gates passed!");
+ * }
+ * ```
+ */
+export declare function runPrdLoop(
+/** Path to prd.ts file OR a Story object to run a single story */
+prdPathOrStory: string | Story, options?: PrdLoopOptions): Promise<PrdLoopResult>;
+/**
+ * Creates an agent function that uses the OpenCode Zen API.
+ * This is a convenience wrapper for the most common use case.
+ *
+ * @example
+ * ```ts
+ * const agent = createOpenCodeAgent({
+ *   apiKey: process.env.OPENCODE_ZEN_API_KEY,
+ *   model: "big-pickle",
+ *   timeoutMs: 60_000,
+ * });
+ *
+ * await runPrdLoop("./prd.ts", { agent });
+ * ```
+ */
+export declare function createOpenCodeAgent(config: {
+    apiKey?: string;
+    endpoint?: string;
+    model?: string;
+    maxSteps?: number;
+    /** Timeout for the LLM generateText call in ms (default: 120_000) */
+    timeoutMs?: number;
+    /** Max retries on 429/5xx errors (default: 1) */
+    maxRetries?: number;
+}): (ctx: AgentContext) => Promise<AgentResult>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/prd/loop.d.ts.map

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

package/dist/prd/loop.js

@@ -0,0 +1,462 @@
+/**
+ * Native PRD loop function - enables agents and scripts to run the retry loop
+ * without external bash orchestration.
+ *
+ * This is an additive feature - the existing `bun run prd:loop` command remains unchanged.
+ */
+import { resolve } from "node:path";
+import { readFileSync, existsSync, mkdirSync, appendFileSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { runPrd } from "./runner";
+/**
+ * Loads a PRD from a file path by dynamic import
+ */
+async function loadPrd(prdPath) {
+    const absolutePath = resolve(prdPath);
+    const mod = await import(`file://${absolutePath}`);
+    // Handle both default export and named 'prd' export
+    if (mod.default && typeof mod.default === 'object' && 'stories' in mod.default) {
+        return mod.default;
+    }
+    if (mod.prd && typeof mod.prd === 'object' && 'stories' in mod.prd) {
+        return mod.prd;
+    }
+    throw new Error(`PRD file must export 'prd' or a default object with 'stories': ${prdPath}`);
+}
+/**
+ * Gets a truncated git diff
+ */
+function getRecentDiff(baseRef = "HEAD", maxLines = 100) {
+    try {
+        const diff = execSync(`git diff ${baseRef}`, {
+            encoding: "utf-8",
+            cwd: process.cwd(),
+            maxBuffer: 1024 * 1024, // 1MB
+        });
+        const lines = diff.split("\n");
+        if (lines.length > maxLines) {
+            return lines.slice(0, maxLines).join("\n") + `\n... (truncated, ${lines.length - maxLines} more lines)`;
+        }
+        return diff;
+    }
+    catch {
+        return "(no diff available)";
+    }
+}
+/**
+ * Builds a context object for the agent
+ */
+function buildAgentContext(prdPath, result, iteration, baseRef) {
+    const prdContent = readFileSync(prdPath, "utf-8");
+    const failedStory = result.failedStory;
+    // Build a focused slice of the PRD relevant to the failure
+    let prdSlice = "";
+    if (failedStory) {
+        prdSlice = `Story: ${failedStory.id}\nTitle: ${failedStory.title}\nGate: ${failedStory.gateFile}`;
+        if (failedStory.scope) {
+            prdSlice += `\nScope: ${JSON.stringify(failedStory.scope, null, 2)}`;
+        }
+        if (failedStory.progress && failedStory.progress.length > 0) {
+            prdSlice += `\nProgress: ${failedStory.progress.join(", ")}`;
+        }
+    }
+    // Build failure summary
+    let failureSummary = "";
+    if (result.error) {
+        failureSummary = result.error.message;
+    }
+    if (result.report?.failedStory) {
+        const storyResult = result.report.stories.find(s => s.id === result.report?.failedStory?.id);
+        if (storyResult?.error) {
+            failureSummary += `\n${storyResult.error.tag || storyResult.error.name}: ${storyResult.error.message}`;
+        }
+    }
+    return {
+        prdSlice,
+        failureSummary,
+        recentDiff: getRecentDiff(baseRef),
+        prdContent,
+        failedStory,
+        lastReport: result.report,
+        iteration,
+    };
+}
+/**
+ * Ensures the .gateproof directory exists
+ */
+function ensureGateproofDir(cwd) {
+    const dir = resolve(cwd, ".gateproof");
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+/**
+ * Appends iteration evidence to the evidence log
+ */
+function appendEvidenceLog(cwd, iteration, status, report) {
+    const gateproofDir = ensureGateproofDir(cwd);
+    const logPath = resolve(gateproofDir, "evidence.log");
+    const entry = {
+        timestamp: new Date().toISOString(),
+        iteration,
+        passed: status.passed,
+        durationMs: status.durationMs,
+        failedStory: status.failedStory?.id,
+        failure: status.failure,
+        storiesRun: report?.stories.map(s => ({ id: s.id, status: s.status })),
+    };
+    appendFileSync(logPath, JSON.stringify(entry) + "\n", "utf-8");
+}
+/**
+ * Default agent that logs a warning (real agent integration requires API key)
+ */
+async function defaultNoopAgent(ctx) {
+    console.warn("[runPrdLoop] No agent function provided. Provide an agent option to enable automatic fixes.");
+    console.log("\n--- Agent Context ---");
+    console.log(`Iteration: ${ctx.iteration}`);
+    console.log(`Failed story: ${ctx.failedStory?.id || "(none)"}`);
+    console.log(`Failure: ${ctx.failureSummary}`);
+    console.log("---\n");
+    return { changes: [] };
+}
+/**
+ * Wraps a promise with a timeout and an AbortController for real cancellation.
+ * The caller should pass the AbortSignal into the underlying work so it actually stops.
+ */
+function withTimeout(fn, ms, label) {
+    const controller = new AbortController();
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            controller.abort();
+            reject(new Error(`${label} timed out after ${ms}ms`));
+        }, ms);
+    });
+    return Promise.race([fn(controller.signal), timeout]).finally(() => clearTimeout(timer));
+}
+/**
+ * Generates a short run ID for namespacing report files in concurrent CI.
+ */
+function generateRunId() {
+    const ts = Date.now().toString(36);
+    const rand = Math.random().toString(36).slice(2, 6);
+    return `${ts}-${rand}`;
+}
+/**
+ * Runs the PRD loop, iterating until all gates pass or maxIterations is reached.
+ *
+ * This is the native, programmatic way to run the gateproof retry loop.
+ * It can be called from scripts, tests, or integrated into custom tooling.
+ *
+ * @example
+ * ```ts
+ * import { runPrdLoop } from "gateproof/prd";
+ *
+ * const result = await runPrdLoop("./prd.ts", {
+ *   maxIterations: 5,
+ *   maxTotalMs: 300_000, // 5 minute wall-clock budget
+ *   iterationTimeoutMs: 60_000, // 1 minute per agent call
+ *   agent: async (ctx) => {
+ *     // Make changes based on ctx.failureSummary
+ *     return { changes: ["fixed the bug"] };
+ *   },
+ *   onIteration: (status) => {
+ *     console.log(`Attempt ${status.attempt}: ${status.passed ? "passed" : "failed"}`);
+ *   },
+ * });
+ *
+ * if (result.success) {
+ *   console.log("All gates passed!");
+ * }
+ * ```
+ */
+export async function runPrdLoop(
+/** Path to prd.ts file OR a Story object to run a single story */
+prdPathOrStory, options = {}) {
+    const { maxIterations = 7, maxTotalMs, iterationTimeoutMs, agent = defaultNoopAgent, onIteration, autoCommit = false, cwd = process.cwd(), reportPath, checkScope = true, baseRef, writeEvidenceLog = false, quiet = false, } = options;
+    const startTime = Date.now();
+    const gateproofDir = ensureGateproofDir(cwd);
+    const runId = generateRunId();
+    const effectiveReportPath = reportPath ?? resolve(gateproofDir, `prd-report-${runId}.json`);
+    // Determine the PRD path
+    let prdPath;
+    let singleStoryPrd;
+    if (typeof prdPathOrStory === "string") {
+        prdPath = resolve(cwd, prdPathOrStory);
+    }
+    else {
+        // Single story mode - create a synthetic PRD
+        const story = prdPathOrStory;
+        prdPath = resolve(cwd, "prd.ts"); // For context building only
+        singleStoryPrd = { stories: [story] };
+    }
+    const log = quiet ? () => { } : console.log;
+    for (let iteration = 1; iteration <= maxIterations; iteration++) {
+        // Check wall-clock budget
+        if (maxTotalMs && (Date.now() - startTime) >= maxTotalMs) {
+            log(`\n⏱️ Wall-clock budget exhausted (${maxTotalMs}ms)`);
+            break;
+        }
+        const iterStart = Date.now();
+        log(`\n=== PRD Loop Iteration ${iteration}/${maxIterations} ===`);
+        // Load or use the PRD
+        let prd;
+        if (singleStoryPrd) {
+            prd = singleStoryPrd;
+        }
+        else {
+            try {
+                // Clear module cache for hot reloading
+                delete require.cache[prdPath];
+                prd = await loadPrd(prdPath);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    success: false,
+                    attempts: iteration,
+                    finalFailure: `Failed to load PRD: ${msg}`,
+                    totalDurationMs: Date.now() - startTime,
+                };
+            }
+        }
+        // Run the PRD
+        const result = await runPrd(prd, cwd, {
+            reportPath: effectiveReportPath,
+            checkScope,
+            baseRef,
+        });
+        const iterDuration = Date.now() - iterStart;
+        // Build status for callback
+        const status = {
+            attempt: iteration,
+            passed: result.success,
+            failure: result.error?.message,
+            failedStory: result.failedStory,
+            durationMs: iterDuration,
+        };
+        // Write evidence log if enabled
+        if (writeEvidenceLog) {
+            appendEvidenceLog(cwd, iteration, status, result.report);
+        }
+        // Call iteration callback
+        onIteration?.(status);
+        if (result.success) {
+            log("\n✅ All PRD stories passed!");
+            return {
+                success: true,
+                attempts: iteration,
+                lastReport: result.report,
+                totalDurationMs: Date.now() - startTime,
+            };
+        }
+        log(`\n❌ Gate failed: ${result.failedStory?.id || "unknown"}`);
+        if (result.error) {
+            log(`   ${result.error.message}`);
+        }
+        // If this is the last iteration, don't call the agent
+        if (iteration >= maxIterations) {
+            break;
+        }
+        // Check wall-clock budget before calling agent
+        if (maxTotalMs && (Date.now() - startTime) >= maxTotalMs) {
+            log(`\n⏱️ Wall-clock budget exhausted (${maxTotalMs}ms), skipping agent`);
+            break;
+        }
+        // Build context and call agent
+        const ctx = buildAgentContext(prdPath, result, iteration, baseRef ?? (process.env.CI ? "origin/main" : "HEAD"));
+        log("\n🤖 Calling agent to fix...");
+        try {
+            const agentResult = iterationTimeoutMs
+                ? await withTimeout((signal) => agent({ ...ctx, signal }), iterationTimeoutMs, "Agent call")
+                : await agent(ctx);
+            if (agentResult.changes.length > 0) {
+                log(`   Made ${agentResult.changes.length} change(s):`);
+                for (const change of agentResult.changes.slice(0, 5)) {
+                    log(`   - ${change}`);
+                }
+                if (agentResult.changes.length > 5) {
+                    log(`   ... and ${agentResult.changes.length - 5} more`);
+                }
+                // Auto-commit if enabled
+                if (autoCommit && agentResult.commitMsg) {
+                    const commitMsg = agentResult.commitMsg;
+                    if (typeof autoCommit === "object" && autoCommit.git) {
+                        await autoCommit.git.add(["."]);
+                        await autoCommit.git.commit(commitMsg);
+                        log(`   📝 Committed: ${commitMsg}`);
+                    }
+                    else {
+                        try {
+                            execSync(`git add -A && git commit -m ${JSON.stringify(commitMsg)}`, {
+                                cwd,
+                                encoding: "utf-8",
+                            });
+                            log(`   📝 Committed: ${commitMsg}`);
+                        }
+                        catch {
+                            log(`   ⚠️ Commit failed (maybe no changes?)`);
+                        }
+                    }
+                }
+            }
+            else {
+                log("   No changes made by agent");
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log(`   ⚠️ Agent error: ${msg}`);
+        }
+    }
+    // Failed after all iterations
+    const lastReport = existsSync(effectiveReportPath)
+        ? JSON.parse(readFileSync(effectiveReportPath, "utf-8"))
+        : undefined;
+    return {
+        success: false,
+        attempts: maxIterations,
+        finalFailure: `Failed after ${maxIterations} iterations`,
+        lastReport,
+        totalDurationMs: Date.now() - startTime,
+    };
+}
+/**
+ * Creates an agent function that uses the OpenCode Zen API.
+ * This is a convenience wrapper for the most common use case.
+ *
+ * @example
+ * ```ts
+ * const agent = createOpenCodeAgent({
+ *   apiKey: process.env.OPENCODE_ZEN_API_KEY,
+ *   model: "big-pickle",
+ *   timeoutMs: 60_000,
+ * });
+ *
+ * await runPrdLoop("./prd.ts", { agent });
+ * ```
+ */
+export function createOpenCodeAgent(config) {
+    const { apiKey = process.env.OPENCODE_ZEN_API_KEY, endpoint = "https://opencode.ai/zen/v1", model = "big-pickle", maxSteps = 10, timeoutMs = 120_000, maxRetries = 1, } = config;
+    if (!apiKey) {
+        throw new Error("createOpenCodeAgent requires an API key (set OPENCODE_ZEN_API_KEY or pass apiKey)");
+    }
+    return async (ctx) => {
+        // Dynamic import to avoid requiring ai/openai-compatible as hard deps
+        const { generateText, tool } = await import("ai");
+        const { createOpenAICompatible } = await import("@ai-sdk/openai-compatible");
+        const { z } = await import("zod");
+        const { existsSync, readFileSync, writeFileSync } = await import("node:fs");
+        const opencode = createOpenAICompatible({
+            name: "opencode-zen",
+            apiKey,
+            baseURL: endpoint,
+        });
+        const changes = [];
+        // Define tools - using type assertions to work around strict AI SDK typing
+        // The runtime behavior is correct per AI SDK documentation
+        const readTool = tool({
+            description: "Read the contents of a file at the given path.",
+            parameters: z.object({
+                path: z.string().describe("The file path to read"),
+            }),
+            execute: async (params) => {
+                if (!existsSync(params.path))
+                    return `Error: file not found: ${params.path}`;
+                return readFileSync(params.path, "utf8");
+            },
+        });
+        const writeTool = tool({
+            description: "Write file contents exactly (overwrites).",
+            parameters: z.object({
+                path: z.string().describe("File path"),
+                content: z.string().describe("Full file contents"),
+            }),
+            execute: async (params) => {
+                writeFileSync(params.path, params.content, "utf8");
+                changes.push(`Wrote ${params.path}`);
+                return `Wrote ${params.path}`;
+            },
+        });
+        const replaceTool = tool({
+            description: "Replace a string in a file. Fails if the string is not found.",
+            parameters: z.object({
+                path: z.string().describe("File path"),
+                old_string: z.string().describe("String to replace"),
+                new_string: z.string().describe("Replacement string"),
+            }),
+            execute: async (params) => {
+                if (!existsSync(params.path))
+                    return `Error: file not found: ${params.path}`;
+                const content = readFileSync(params.path, "utf8");
+                if (!content.includes(params.old_string)) {
+                    return `Error: string not found in ${params.path}`;
+                }
+                const next = content.replace(params.old_string, params.new_string);
+                writeFileSync(params.path, next, "utf8");
+                changes.push(`Updated ${params.path}`);
+                return `Updated ${params.path}`;
+            },
+        });
+        const tools = { read: readTool, write: writeTool, replace: replaceTool };
+        const prompt = `You are a gateproof loop agent.
+
+Goal:
+- Make the PRD pass (all gates green).
+
+Rules:
+- Use the provided tools to inspect and edit files.
+- Keep changes minimal and scoped to what's needed to pass.
+- Fix only the specific failing assertion.
+
+PRD Content:
+${ctx.prdContent}
+
+Failed Story:
+${ctx.prdSlice}
+
+Failure Summary:
+${ctx.failureSummary}
+
+Recent Diff:
+${ctx.recentDiff}
+`;
+        // Retry wrapper for transient LLM errors (429, 5xx)
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                await withTimeout((signal) => generateText({
+                    model: opencode(model),
+                    tools,
+                    maxSteps: maxSteps,
+                    prompt,
+                    abortSignal: ctx.signal ?? signal,
+                }), timeoutMs, "LLM generateText");
+                // If we get here, the call succeeded
+                return {
+                    changes,
+                    commitMsg: changes.length > 0
+                        ? `fix(prd): ${ctx.failedStory?.id || "gate"} - iteration ${ctx.iteration}`
+                        : undefined,
+                };
+            }
+            catch (err) {
+                lastError = err;
+                const isRetryable = err instanceof Error && (err.message.includes("429") ||
+                    err.message.includes("500") ||
+                    err.message.includes("502") ||
+                    err.message.includes("503") ||
+                    err.message.includes("rate"));
+                if (isRetryable && attempt < maxRetries) {
+                    const backoffMs = 1000 * Math.pow(2, attempt); // 1s, 2s, 4s...
+                    await new Promise((r) => setTimeout(r, backoffMs));
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw lastError;
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/prd/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/prd/loop.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAW,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAiB,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAE,MAAM,EAAqB,MAAM,UAAU,CAAC;AA+GrD;;GAEG;AACH,KAAK,UAAU,OAAO,CAAqB,OAAe;IACxD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,YAAY,EAAE,CAAC,CAAC;IAEnD,oDAAoD;IACpD,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAC/E,OAAO,GAAG,CAAC,OAAmB,CAAC;IACjC,CAAC;IACD,IAAI,GAAG,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QACnE,OAAO,GAAG,CAAC,GAAe,CAAC;IAC7B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kEAAkE,OAAO,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,UAAkB,MAAM,EAAE,WAAmB,GAAG;IACrE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,OAAO,EAAE,EAAE;YAC3C,QAAQ,EAAE,OAAO;YACjB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM;SAC/B,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,qBAAqB,KAAK,CAAC,MAAM,GAAG,QAAQ,cAAc,CAAC;QAC1G,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,qBAAqB,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,OAAe,EACf,MAAoB,EACpB,SAAiB,EACjB,OAAe;IAEf,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAEvC,2DAA2D;IAC3D,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,GAAG,UAAU,WAAW,CAAC,EAAE,YAAY,WAAW,CAAC,KAAK,WAAW,WAAW,CAAC,QAAQ,EAAE,CAAC;QAClG,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACtB,QAAQ,IAAI,YAAY,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACvE,CAAC;QACD,IAAI,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,QAAQ,IAAI,eAAe,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IACxC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAC7F,IAAI,WAAW,EAAE,KAAK,EAAE,CAAC;YACvB,cAAc,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACzG,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,cAAc;QACd,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC;QAClC,UAAU;QACV,WAAW;QACX,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,GAAW,EACX,SAAiB,EACjB,MAAuB,EACvB,MAAoB;IAEpB,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS;QACT,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE;QACnC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KACvE,CAAC;IAEF,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,GAAiB;IAC/C,OAAO,CAAC,IAAI,CACV,6FAA6F,CAC9F,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAErB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAClB,EAAuC,EACvC,EAAU,EACV,KAAa;IAEb,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,KAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,EAAE,IAAI,CAAC,CAAC,CAAC;QACxD,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED;;GAEG;AACH,SAAS,aAAa;IACpB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;AAC9B,kEAAkE;AAClE,cAA8B,EAC9B,UAA0B,EAAE;IAE5B,MAAM,EACJ,aAAa,GAAG,CAAC,EACjB,UAAU,EACV,kBAAkB,EAClB,KAAK,GAAG,gBAAgB,EACxB,WAAW,EACX,UAAU,GAAG,KAAK,EAClB,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EACnB,UAAU,EACV,UAAU,GAAG,IAAI,EACjB,OAAO,EACP,gBAAgB,GAAG,KAAK,EACxB,KAAK,GAAG,KAAK,GACd,GAAG,OAAO,CAAC;IAEZ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,mBAAmB,GAAG,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC;IAE5F,yBAAyB;IACzB,IAAI,OAAe,CAAC;IACpB,IAAI,cAA+B,CAAC;IAEpC,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,6CAA6C;QAC7C,MAAM,KAAK,GAAG,cAAc,CAAC;QAC7B,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,4BAA4B;QAC9D,cAAc,GAAG,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAE3C,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,aAAa,EAAE,SAAS,EAAE,EAAE,CAAC;QAChE,0BAA0B;QAC1B,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC;YACzD,GAAG,CAAC,qCAAqC,UAAU,KAAK,CAAC,CAAC;YAC1D,MAAM;QACR,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,GAAG,CAAC,4BAA4B,SAAS,IAAI,aAAa,MAAM,CAAC,CAAC;QAElE,sBAAsB;QACtB,IAAI,GAAQ,CAAC;QACb,IAAI,cAAc,EAAE,CAAC;YACnB,GAAG,GAAG,cAAc,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,uCAAuC;gBACvC,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC9B,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,SAAS;oBACnB,YAAY,EAAE,uBAAuB,GAAG,EAAE;oBAC1C,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACxC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,cAAc;QACd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE;YACpC,UAAU,EAAE,mBAAmB;YAC/B,UAAU;YACV,OAAO;SACR,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE5C,4BAA4B;QAC5B,MAAM,MAAM,GAAoB;YAC9B,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,MAAM,CAAC,OAAO;YACtB,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO;YAC9B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,YAAY;SACzB,CAAC;QAEF,gCAAgC;QAChC,IAAI,gBAAgB,EAAE,CAAC;YACrB,iBAAiB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3D,CAAC;QAED,0BAA0B;QAC1B,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC;QAEtB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,GAAG,CAAC,6BAA6B,CAAC,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,SAAS;gBACnB,UAAU,EAAE,MAAM,CAAC,MAAM;gBACzB,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACxC,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,oBAAoB,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,SAAS,EAAE,CAAC,CAAC;QAC/D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,sDAAsD;QACtD,IAAI,SAAS,IAAI,aAAa,EAAE,CAAC;YAC/B,MAAM;QACR,CAAC;QAED,+CAA+C;QAC/C,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC;YACzD,GAAG,CAAC,qCAAqC,UAAU,qBAAqB,CAAC,CAAC;YAC1E,MAAM;QACR,CAAC;QAED,+BAA+B;QAC/B,MAAM,GAAG,GAAG,iBAAiB,CAC3B,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CACrD,CAAC;QAEF,GAAG,CAAC,8BAA8B,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,kBAAkB;gBACpC,CAAC,CAAC,MAAM,WAAW,CACf,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC,EACrC,kBAAkB,EAClB,YAAY,CACb;gBACH,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAErB,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,GAAG,CAAC,WAAW,WAAW,CAAC,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC;gBACxD,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBACrD,GAAG,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC;gBACxB,CAAC;gBACD,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnC,GAAG,CAAC,cAAc,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3D,CAAC;gBAED,yBAAyB;gBACzB,IAAI,UAAU,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;oBACxC,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;oBACxC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;wBACrD,MAAM,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;wBAChC,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;wBACvC,GAAG,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC;oBACvC,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC;4BACH,QAAQ,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE;gCACnE,GAAG;gCACH,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;4BACH,GAAG,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC;wBACvC,CAAC;wBAAC,MAAM,CAAC;4BACP,GAAG,CAAC,yCAAyC,CAAC,CAAC;wBACjD,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,6BAA6B,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,GAAG,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,UAAU,GAAG,UAAU,CAAC,mBAAmB,CAAC;QAChD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAgB;QACvE,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,aAAa;QACvB,YAAY,EAAE,gBAAgB,aAAa,aAAa;QACxD,UAAU;QACV,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACxC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,MASnC;IACC,MAAM,EACJ,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,EACzC,QAAQ,GAAG,4BAA4B,EACvC,KAAK,GAAG,YAAY,EACpB,QAAQ,GAAG,EAAE,EACb,SAAS,GAAG,OAAO,EACnB,UAAU,GAAG,CAAC,GACf,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;IAED,OAAO,KAAK,EAAE,GAAiB,EAAwB,EAAE;QACvD,sEAAsE;QACtE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC7E,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAE5E,MAAM,QAAQ,GAAG,sBAAsB,CAAC;YACtC,IAAI,EAAE,cAAc;YACpB,MAAM;YACN,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,2EAA2E;QAC3E,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC;YACpB,WAAW,EAAE,gDAAgD;YAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;aACnD,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,MAAwB,EAAE,EAAE;gBAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;oBAAE,OAAO,0BAA0B,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC7E,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC;SACoC,CAAC,CAAC;QAEzC,MAAM,SAAS,GAAG,IAAI,CAAC;YACrB,WAAW,EAAE,2CAA2C;YACxD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;aACnD,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,MAAyC,EAAE,EAAE;gBAC3D,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACnD,OAAO,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrC,OAAO,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,CAAC;SACoC,CAAC,CAAC;QAEzC,MAAM,WAAW,GAAG,IAAI,CAAC;YACvB,WAAW,EAAE,+DAA+D;YAC5E,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;aACtD,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,MAAgE,EAAE,EAAE;gBAClF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;oBAAE,OAAO,0BAA0B,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC7E,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAClD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBACzC,OAAO,8BAA8B,MAAM,CAAC,IAAI,EAAE,CAAC;gBACrD,CAAC;gBACD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;gBACnE,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;gBACzC,OAAO,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACvC,OAAO,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC;YAClC,CAAC;SACoC,CAAC,CAAC;QAEzC,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAEzE,MAAM,MAAM,GAAG;;;;;;;;;;;EAWjB,GAAG,CAAC,UAAU;;;EAGd,GAAG,CAAC,QAAQ;;;EAGZ,GAAG,CAAC,cAAc;;;EAGlB,GAAG,CAAC,UAAU;CACf,CAAC;QAEE,oDAAoD;QACpD,IAAI,SAAkB,CAAC;QACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,WAAW,CACf,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC;oBACvB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;oBACtB,KAAK;oBACL,QAAQ,EAAE,QAAkB;oBAC5B,MAAM;oBACN,WAAW,EAAE,GAAG,CAAC,MAAM,IAAI,MAAM;iBACI,CAAC,EACxC,SAAS,EACT,kBAAkB,CACnB,CAAC;gBACF,qCAAqC;gBACrC,OAAO;oBACL,OAAO;oBACP,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;wBAC3B,CAAC,CAAC,aAAa,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE;wBAC3E,CAAC,CAAC,SAAS;iBACd,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,CAAC;gBAChB,MAAM,WAAW,GAAG,GAAG,YAAY,KAAK,IAAI,CAC1C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAC3B,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAC3B,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAC3B,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAC3B,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC7B,CAAC;gBACF,IAAI,WAAW,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;oBACxC,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,gBAAgB;oBAC/D,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;oBACnD,SAAS;gBACX,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QAED,MAAM,SAAS,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/prd/runner.d.ts

@@ -8,11 +8,8 @@ export interface RunPrdResult {
 }
 /**
  * Runs a PRD by executing story gates in dependency order.
- * Stops on first failure.
- *
- * @param options.reportPath - If provided, writes a structured JSON report to this path
- * @param options.checkScope - If true, validates scope constraints against git diff
- * @param options.baseRef - Git ref to compare against for scope checking (default: "HEAD" for local, "origin/main" for CI)
+ * Independent stories (no mutual dependencies) within a level run concurrently.
+ * Stops on first failure within a level.
  */
 export declare function runPrd<TId extends string>(prd: Prd<TId>, cwd?: string, options?: {
     reportPath?: string;

package/dist/prd/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/prd/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAc,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAoC,MAAM,WAAW,CAAC;AAI/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAkFD;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,GAAG,SAAS,MAAM,EAC7C,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EACb,GAAG,GAAE,MAAsB,EAC3B,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,OAAO,CAAC,YAAY,CAAC,CAyJvB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/prd/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAc,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAoC,MAAM,WAAW,CAAC;AAK/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAuOD;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,GAAG,SAAS,MAAM,EAC7C,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EACb,GAAG,GAAE,MAAsB,EAC3B,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,OAAO,CAAC,YAAY,CAAC,CA2DvB"}