@cluesmith/codev 2.0.0-rc.1 → 2.0.0-rc.10

package/dist/commands/porch/checks.js

@@ -1,195 +1,141 @@
 /**
- * Defense Checks
+ * Porch Check Runner
  *
- * Runs build/test commands defined in protocol phases.
- * Supports retry logic and configurable failure behavior.
+ * Runs check commands (npm test, npm run build, etc.)
+ * with timeout support.
  */
 import { spawn } from 'node:child_process';
-import chalk from 'chalk';
+/** Default timeout for checks: 5 minutes */
+const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000;
 /**
- * Run a single command with timeout
+ * Run a single check command
  */
-async function runCommand(command, options = {}) {
+export async function runCheck(name, command, cwd, env, timeoutMs = DEFAULT_TIMEOUT_MS) {
     const startTime = Date.now();
-    const timeout = options.timeout || 300000; // 5 minutes default
     return new Promise((resolve) => {
-        const [cmd, ...args] = command.split(/\s+/);
-        const proc = spawn(cmd, args, {
-            cwd: options.cwd,
+        let stdout = '';
+        let stderr = '';
+        let killed = false;
+        // Parse command into executable and args
+        const parts = command.split(/\s+/);
+        const executable = parts[0];
+        const args = parts.slice(1);
+        const proc = spawn(executable, args, {
+            cwd,
             shell: true,
             stdio: ['ignore', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                PROJECT_ID: env.PROJECT_ID,
+                PROJECT_TITLE: env.PROJECT_TITLE,
+            },
         });
-        let output = '';
-        let stderr = '';
-        let timedOut = false;
-        const timeoutId = setTimeout(() => {
-            timedOut = true;
+        // Set up timeout
+        const timeout = setTimeout(() => {
+            killed = true;
             proc.kill('SIGTERM');
-        }, timeout);
+            setTimeout(() => {
+                if (!proc.killed) {
+                    proc.kill('SIGKILL');
+                }
+            }, 5000);
+        }, timeoutMs);
         proc.stdout.on('data', (data) => {
-            output += data.toString();
+            stdout += data.toString();
         });
         proc.stderr.on('data', (data) => {
             stderr += data.toString();
         });
         proc.on('close', (code) => {
-            clearTimeout(timeoutId);
+            clearTimeout(timeout);
             const duration = Date.now() - startTime;
-            if (timedOut) {
+            if (killed) {
                 resolve({
-                    success: false,
-                    output,
-                    error: `Command timed out after ${timeout}ms`,
-                    duration,
+                    name,
+                    command,
+                    passed: false,
+                    error: `Timed out after ${timeoutMs / 1000}s`,
+                    duration_ms: duration,
+                });
+            }
+            else if (code === 0) {
+                resolve({
+                    name,
+                    command,
+                    passed: true,
+                    output: stdout.trim(),
+                    duration_ms: duration,
                 });
             }
             else {
                 resolve({
-                    success: code === 0,
-                    output: output + stderr,
-                    error: code !== 0 ? `Exit code: ${code}` : undefined,
-                    duration,
+                    name,
+                    command,
+                    passed: false,
+                    output: stdout.trim(),
+                    error: stderr.trim() || `Exit code ${code}`,
+                    duration_ms: duration,
                 });
             }
         });
         proc.on('error', (err) => {
-            clearTimeout(timeoutId);
+            clearTimeout(timeout);
             resolve({
-                success: false,
-                output: '',
+                name,
+                command,
+                passed: false,
                 error: err.message,
-                duration: Date.now() - startTime,
+                duration_ms: Date.now() - startTime,
             });
         });
     });
 }
 /**
- * Run a check with retry logic
+ * Run multiple checks for a phase
  */
-async function runCheckWithRetry(name, check, options = {}) {
-    const maxRetries = check.max_retries || 3;
-    const retryDelay = check.retry_delay || 5; // seconds
-    let attempts = 0;
-    let lastResult = null;
-    while (attempts < maxRetries) {
-        attempts++;
-        console.log(chalk.blue(`[check] Running ${name} (attempt ${attempts}/${maxRetries}): ${check.command}`));
-        lastResult = await runCommand(check.command, options);
-        if (lastResult.success) {
-            console.log(chalk.green(`[check] ${name} passed (${lastResult.duration}ms)`));
-            return {
-                name,
-                success: true,
-                output: lastResult.output,
-                attempts,
-                duration: lastResult.duration,
-            };
-        }
-        console.log(chalk.yellow(`[check] ${name} failed: ${lastResult.error}`));
-        // Only retry if on_fail is 'retry'
-        if (check.on_fail !== 'retry' || attempts >= maxRetries) {
+export async function runPhaseChecks(checks, cwd, env, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const results = [];
+    for (const [name, command] of Object.entries(checks)) {
+        const result = await runCheck(name, command, cwd, env, timeoutMs);
+        results.push(result);
+        // Stop on first failure
+        if (!result.passed) {
             break;
         }
-        console.log(chalk.blue(`[check] Retrying in ${retryDelay}s...`));
-        await new Promise(r => setTimeout(r, retryDelay * 1000));
     }
-    return {
-        name,
-        success: false,
-        output: lastResult?.output || '',
-        error: lastResult?.error,
-        attempts,
-        duration: lastResult?.duration || 0,
-    };
+    return results;
 }
+// ============================================================================
+// Result Formatting
+// ============================================================================
 /**
- * Run all checks for a phase
+ * Format check results for terminal output
  */
-export async function runPhaseChecks(phase, options = {}) {
-    if (!phase.checks || Object.keys(phase.checks).length === 0) {
-        return { success: true, checks: [] };
-    }
-    if (options.dryRun) {
-        console.log(chalk.yellow(`[check] [DRY RUN] Would run checks for phase ${phase.id}:`));
-        for (const [name, check] of Object.entries(phase.checks)) {
-            console.log(chalk.yellow(`  - ${name}: ${check.command}`));
-        }
-        return { success: true, checks: [] };
-    }
-    const results = [];
-    let returnTo;
-    for (const [name, check] of Object.entries(phase.checks)) {
-        const result = await runCheckWithRetry(name, check, { cwd: options.cwd });
-        results.push(result);
-        if (!result.success) {
-            console.log(chalk.red(`[check] ${name} failed after ${result.attempts} attempts`));
-            // Determine failure action
-            if (check.on_fail === 'retry') {
-                // Already retried, now fail
-                returnTo = undefined;
+export function formatCheckResults(results) {
+    const lines = [];
+    for (const result of results) {
+        const status = result.passed ? '✓' : '✗';
+        const duration = result.duration_ms
+            ? ` (${(result.duration_ms / 1000).toFixed(1)}s)`
+            : '';
+        lines.push(`  ${status} ${result.name}${duration}`);
+        if (!result.passed && result.error) {
+            // Indent error message
+            const errorLines = result.error.split('\n').slice(0, 5);
+            for (const line of errorLines) {
+                lines.push(`    ${line}`);
             }
-            else {
-                // on_fail specifies a phase to return to
-                returnTo = check.on_fail;
+            if (result.error.split('\n').length > 5) {
+                lines.push('    ...');
             }
-            return {
-                success: false,
-                checks: results,
-                returnTo,
-            };
         }
     }
-    console.log(chalk.green(`[check] All checks passed for phase ${phase.id}`));
-    return {
-        success: true,
-        checks: results,
-    };
-}
-/**
- * Create default checks for common phases
- */
-export function getDefaultChecks(phaseName) {
-    switch (phaseName.toLowerCase()) {
-        case 'implement':
-            return {
-                build: {
-                    command: 'npm run build',
-                    on_fail: 'retry',
-                    max_retries: 2,
-                },
-            };
-        case 'defend':
-            return {
-                tests: {
-                    command: 'npm test',
-                    on_fail: 'implement', // Return to implement on test failure
-                    max_retries: 1,
-                },
-            };
-        default:
-            return {};
-    }
+    return lines.join('\n');
 }
 /**
- * Format check results for display
+ * Check if all results passed
  */
-export function formatCheckResults(results) {
-    if (results.checks.length === 0) {
-        return 'No checks ran';
-    }
-    const lines = ['Check Results:'];
-    for (const check of results.checks) {
-        const status = check.success ? '✓' : '✗';
-        const duration = `(${check.duration}ms)`;
-        const attempts = check.attempts > 1 ? ` [${check.attempts} attempts]` : '';
-        lines.push(`  ${status} ${check.name} ${duration}${attempts}`);
-        if (!check.success && check.error) {
-            lines.push(`    Error: ${check.error}`);
-        }
-    }
-    if (results.returnTo) {
-        lines.push(`  → Returning to phase: ${results.returnTo}`);
-    }
-    return lines.join('\n');
+export function allChecksPassed(results) {
+    return results.every(r => r.passed);
 }
 //# sourceMappingURL=checks.js.map

package/dist/commands/porch/checks.js.map

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

package/dist/commands/porch/claude.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Claude process management for Porch
+ *
+ * Spawns Claude with output to a file for monitoring.
+ */
+export interface ClaudeProcess {
+    /**
+     * Kill the Claude process.
+     */
+    kill(): void;
+    /**
+     * Check if Claude is still running.
+     */
+    isRunning(): boolean;
+    /**
+     * Get the exit code (null if still running).
+     */
+    getExitCode(): number | null;
+    /**
+     * Register a callback for when Claude exits.
+     */
+    onExit(callback: (code: number) => void): void;
+}
+/**
+ * Spawn Claude with the given prompt.
+ * Output goes to the specified file.
+ */
+export declare function spawnClaude(prompt: string, outputPath: string, cwd: string): ClaudeProcess;
+//# sourceMappingURL=claude.d.ts.map

package/dist/commands/porch/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/claude.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC;IAErB;;OAEG;IACH,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CAChD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,aAAa,CA2Ef"}

package/dist/commands/porch/claude.js

@@ -0,0 +1,79 @@
+/**
+ * Claude process management for Porch
+ *
+ * Spawns Claude with output to a file for monitoring.
+ */
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs';
+/**
+ * Spawn Claude with the given prompt.
+ * Output goes to the specified file.
+ */
+export function spawnClaude(prompt, outputPath, cwd) {
+    // Open file for writing
+    const outputFd = fs.openSync(outputPath, 'w');
+    // Save prompt to file for reference
+    const promptFile = outputPath.replace(/\.txt$/, '-prompt.txt');
+    fs.writeFileSync(promptFile, prompt);
+    // Spawn Claude with prompt as command-line argument
+    // Node's spawn handles escaping correctly for long prompts
+    // Using --dangerously-skip-permissions so Claude can write files without prompts
+    const proc = spawn('claude', [
+        '--dangerously-skip-permissions',
+        '-p',
+        prompt, // Pass prompt directly as argument
+    ], {
+        cwd,
+        stdio: ['ignore', outputFd, outputFd],
+        env: {
+            ...process.env,
+            // Ensure Claude doesn't try to use interactive features
+            CI: '1',
+        },
+    });
+    let exitCode = null;
+    let running = true;
+    const exitCallbacks = [];
+    proc.on('close', (code) => {
+        exitCode = code ?? 1;
+        running = false;
+        fs.closeSync(outputFd);
+        for (const callback of exitCallbacks) {
+            callback(exitCode);
+        }
+    });
+    proc.on('error', (err) => {
+        console.error('Claude spawn error:', err.message);
+        running = false;
+        fs.closeSync(outputFd);
+    });
+    return {
+        kill() {
+            if (running) {
+                proc.kill('SIGTERM');
+                // Give it a moment, then force kill if needed
+                setTimeout(() => {
+                    if (running) {
+                        proc.kill('SIGKILL');
+                    }
+                }, 3000);
+            }
+        },
+        isRunning() {
+            return running;
+        },
+        getExitCode() {
+            return exitCode;
+        },
+        onExit(callback) {
+            if (!running && exitCode !== null) {
+                // Already exited, call immediately
+                callback(exitCode);
+            }
+            else {
+                exitCallbacks.push(callback);
+            }
+        },
+    };
+}
+//# sourceMappingURL=claude.js.map

package/dist/commands/porch/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/commands/porch/claude.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAwB9B;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,UAAkB,EAClB,GAAW;IAEX,wBAAwB;IACxB,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAE9C,oCAAoC;IACpC,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC/D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAErC,oDAAoD;IACpD,2DAA2D;IAC3D,iFAAiF;IACjF,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE;QAC3B,gCAAgC;QAChC,IAAI;QACJ,MAAM,EAAG,mCAAmC;KAC7C,EAAE;QACD,GAAG;QACH,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACrC,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,wDAAwD;YACxD,EAAE,EAAE,GAAG;SACR;KACF,CAAC,CAAC;IAEH,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,MAAM,aAAa,GAAkC,EAAE,CAAC;IAExD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC;QACrB,OAAO,GAAG,KAAK,CAAC;QAChB,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEvB,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,GAAG,KAAK,CAAC;QAChB,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;YACF,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrB,8CAA8C;gBAC9C,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,OAAO,EAAE,CAAC;wBACZ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC,EAAE,IAAI,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,SAAS;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,WAAW;YACT,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,CAAC,QAAQ;YACb,IAAI,CAAC,OAAO,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAClC,mCAAmC;gBACnC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commands/porch/index.d.ts

@@ -1,60 +1,38 @@
 /**
  * Porch - Protocol Orchestrator
  *
- * Generic loop orchestrator that reads protocol definitions from JSON
- * and executes them with Claude. Implements the Ralph pattern: fresh
- * context per iteration with state persisted to files.
+ * Claude calls porch as a tool; porch returns prescriptive instructions.
+ * All commands produce clear, actionable output.
  */
-import type { Protocol, PorchRunOptions, PorchInitOptions } from './types.js';
 /**
- * List available protocols
- * Delegates to protocol-loader.ts for proper conversion
+ * porch status <id>
+ * Shows current state and prescriptive next steps.
  */
-export declare function listProtocols(projectRoot?: string): string[];
+export declare function status(projectRoot: string, projectId: string): Promise<void>;
 /**
- * Load a protocol definition
- * Delegates to protocol-loader.ts which properly converts steps→substates
+ * porch check <id>
+ * Runs the phase checks and reports results.
  */
-export declare function loadProtocol(name: string, projectRoot?: string): Protocol;
+export declare function check(projectRoot: string, projectId: string): Promise<void>;
 /**
- * Initialize a new project with a protocol
+ * porch done <id>
+ * Advances to next phase if checks pass. Refuses if checks fail.
  */
-export declare function init(protocolName: string, projectId: string, projectName: string, options?: PorchInitOptions): Promise<void>;
+export declare function done(projectRoot: string, projectId: string): Promise<void>;
 /**
- * Run the protocol loop for a project
+ * porch gate <id>
+ * Requests human approval for current gate.
  */
-export declare function run(projectId: string, options?: PorchRunOptions): Promise<void>;
+export declare function gate(projectRoot: string, projectId: string): Promise<void>;
 /**
- * Approve a gate
+ * porch approve <id> <gate> --a-human-explicitly-approved-this
+ * Human approves a gate. Requires explicit flag to prevent automated approvals.
  */
-export declare function approve(projectId: string, gateId: string): Promise<void>;
+export declare function approve(projectRoot: string, projectId: string, gateName: string, hasHumanFlag: boolean): Promise<void>;
 /**
- * Show project status
+ * porch init <protocol> <id> <name>
+ * Initialize a new project.
  */
-export declare function status(projectId?: string): Promise<void>;
-/**
- * List available protocols
- */
-export declare function list(): Promise<void>;
-/**
- * Show protocol definition
- */
-export declare function show(protocolName: string): Promise<void>;
-/**
- * Show pending gates across all projects
- */
-export declare function pending(): Promise<void>;
-/**
- * Main porch entry point - handles subcommands
- */
-export interface PorchOptions {
-    subcommand: string;
-    args: string[];
-    dryRun?: boolean;
-    noClaude?: boolean;
-    pollInterval?: number;
-    description?: string;
-    worktree?: string;
-}
-export declare function porch(options: PorchOptions): Promise<void>;
+export declare function init(projectRoot: string, protocolName: string, projectId: string, projectName: string): Promise<void>;
+export declare function cli(args: string[]): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/porch/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EACV,QAAQ,EAGR,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA+CpB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAG5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,CASzE;AA8MD;;GAEG;AACH,wBAAsB,IAAI,CACxB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAgFD;;GAEG;AACH,wBAAsB,GAAG,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAwUf;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9E;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6E9D;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB1C;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9D;AAED;;GAEG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAe7C;AAyDD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyDH;;;GAGG;AACH,wBAAsB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6FlF;AAED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCjF;AAED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuGhF;AAiED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDhF;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED;;;GAGG;AACH,wBAAsB,IAAI,CACxB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAkBf;AA2DD,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEvD"}