@boshu2/vibe-check 0.1.0

package/dist/inner-loop/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Inner Loop Failure Pattern Types
+ *
+ * These detect the 4 "Inner Loop Disasters" from vibe coding:
+ * 1. "Tests Passing" Lie - AI claims success but code doesn't work
+ * 2. Context Amnesia - Forgets instructions, re-does work
+ * 3. Instruction Drift - "Improves" things not asked for
+ * 4. Debug Loop Spiral - Adds logging instead of fixing
+ */
+export interface TestsPassingLieResult {
+    detected: boolean;
+    lies: TestsPassingLie[];
+    totalLies: number;
+    message: string;
+}
+export interface TestsPassingLie {
+    commitHash: string;
+    commitMessage: string;
+    timestamp: Date;
+    claimedSuccess: boolean;
+    /**
+     * Actual verification result:
+     * - 'build_failed': Build command failed
+     * - 'tests_failed': Test command failed
+     * - 'inferred': Detected from commit patterns (no actual verification)
+     * - 'unknown': Verification attempted but result unclear
+     */
+    actualResult: 'build_failed' | 'tests_failed' | 'inferred' | 'unknown';
+    verificationMethod: 'npm_test' | 'npm_build' | 'make_test' | 'inferred';
+}
+export interface ContextAmnesiaResult {
+    detected: boolean;
+    incidents: ContextAmnesiaIncident[];
+    totalIncidents: number;
+    totalTimeWasted: number;
+    message: string;
+}
+export interface ContextAmnesiaIncident {
+    type: 'revert' | 'reimplementation' | 'forgotten_change';
+    originalCommit: {
+        hash: string;
+        message: string;
+        timestamp: Date;
+    };
+    repeatCommit: {
+        hash: string;
+        message: string;
+        timestamp: Date;
+    };
+    scope: string | null;
+    filesAffected: string[];
+    gapMinutes: number;
+    description: string;
+}
+export interface InstructionDriftResult {
+    detected: boolean;
+    drifts: InstructionDrift[];
+    totalDriftCommits: number;
+    totalUnauthorizedFiles: number;
+    message: string;
+}
+export interface InstructionDrift {
+    commitHash: string;
+    commitMessage: string;
+    timestamp: Date;
+    driftType: 'scope_creep' | 'unrequested_refactor' | 'unrequested_improvement' | 'style_change';
+    unauthorizedFiles: string[];
+    authorizedScope: string[];
+    description: string;
+}
+export interface SessionScope {
+    intendedFiles: string[];
+    intendedDirs: string[];
+    taskDescription?: string;
+    startTime: Date;
+}
+export interface LoggingOnlyResult {
+    detected: boolean;
+    loggingCommits: LoggingOnlyCommit[];
+    consecutiveLoggingCount: number;
+    totalLoggingCommits: number;
+    message: string;
+}
+export interface LoggingOnlyCommit {
+    hash: string;
+    message: string;
+    timestamp: Date;
+    loggingStatements: number;
+    actualFixes: number;
+    isLoggingOnly: boolean;
+    loggingPatterns: string[];
+    /**
+     * How this commit was analyzed:
+     * - 'inferred': Lightweight mode - loggingStatements/actualFixes are estimates from message patterns
+     * - 'diff_analysis': Full mode - accurate counts from git diff inspection
+     */
+    detectionMode?: 'inferred' | 'diff_analysis';
+}
+export interface InnerLoopAnalysis {
+    testsPassingLie: TestsPassingLieResult;
+    contextAmnesia: ContextAmnesiaResult;
+    instructionDrift: InstructionDriftResult;
+    loggingOnly: LoggingOnlyResult;
+    summary: {
+        totalIssuesDetected: number;
+        criticalIssues: number;
+        warningIssues: number;
+        overallHealth: 'healthy' | 'warning' | 'critical';
+    };
+    recommendations: string[];
+}
+export interface InnerLoopConfig {
+    runTestsAfterCommit: boolean;
+    testCommand?: string;
+    buildCommand?: string;
+    amnesiaWindowMinutes: number;
+    similarityThreshold: number;
+    sessionScope?: SessionScope;
+    allowedDriftFiles: string[];
+    workingSetCommitCount: number;
+    maxConsecutiveLoggingCommits: number;
+    loggingPatterns: RegExp[];
+}
+export declare const DEFAULT_INNER_LOOP_CONFIG: InnerLoopConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/inner-loop/types.d.ts.map

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

package/dist/inner-loop/types.js

@@ -0,0 +1,27 @@
+/**
+ * Inner Loop Failure Pattern Types
+ *
+ * These detect the 4 "Inner Loop Disasters" from vibe coding:
+ * 1. "Tests Passing" Lie - AI claims success but code doesn't work
+ * 2. Context Amnesia - Forgets instructions, re-does work
+ * 3. Instruction Drift - "Improves" things not asked for
+ * 4. Debug Loop Spiral - Adds logging instead of fixing
+ */
+export const DEFAULT_INNER_LOOP_CONFIG = {
+    runTestsAfterCommit: false,
+    amnesiaWindowMinutes: 60,
+    similarityThreshold: 0.7,
+    allowedDriftFiles: ['package.json', 'package-lock.json', 'tsconfig.json', '.gitignore'],
+    workingSetCommitCount: 3, // First 3 commits define working set for drift detection
+    maxConsecutiveLoggingCommits: 3,
+    loggingPatterns: [
+        /console\.(log|error|warn|debug|info)\(/,
+        /print\s*\(/,
+        /logger\.(log|error|warn|debug|info)\(/,
+        /System\.out\.print/,
+        /fmt\.Print/,
+        /debug!\(/,
+        /println!\(/,
+    ],
+};
+//# sourceMappingURL=types.js.map

package/dist/inner-loop/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/inner-loop/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqKH,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,mBAAmB,EAAE,KAAK;IAC1B,oBAAoB,EAAE,EAAE;IACxB,mBAAmB,EAAE,GAAG;IACxB,iBAAiB,EAAE,CAAC,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAE,YAAY,CAAC;IACvF,qBAAqB,EAAE,CAAC,EAAE,yDAAyD;IACnF,4BAA4B,EAAE,CAAC;IAC/B,eAAe,EAAE;QACf,wCAAwC;QACxC,YAAY;QACZ,uCAAuC;QACvC,oBAAoB;QACpB,YAAY;QACZ,UAAU;QACV,YAAY;KACb;CACF,CAAC"}

package/dist/internal/context/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Global CLI Context Module
+ *
+ * Manages shared state across all vibe-check commands.
+ * This is the foundation for global hooks and cross-command coordination.
+ *
+ * Usage:
+ *   import { createContext, getContext, setContext } from '@/internal/context';
+ *
+ *   // Create and set initial context
+ *   const ctx = createContext({ repo: '/path/to/repo', verbose: true });
+ *   setContext(ctx);
+ *
+ *   // Access context from anywhere
+ *   const ctx = getContext();
+ *   console.log(ctx.repo);
+ */
+import { CLIContext, CreateContextOptions } from './types.js';
+export * from './types.js';
+/**
+ * Create a new CLI context with the given options
+ *
+ * Applies sensible defaults for any missing options.
+ *
+ * @param options - Context configuration options
+ * @returns Fully initialized CLIContext
+ */
+export declare function createContext(options?: CreateContextOptions): CLIContext;
+/**
+ * Get the current global context
+ *
+ * @throws Error if context has not been initialized
+ * @returns The global CLIContext
+ */
+export declare function getContext(): CLIContext;
+/**
+ * Set the global context
+ *
+ * Used by hooks and the CLI bootstrap to establish global state.
+ *
+ * @param ctx - The context to set as global
+ */
+export declare function setContext(ctx: CLIContext): void;
+/**
+ * Check if context has been initialized
+ *
+ * @returns true if context is available, false otherwise
+ */
+export declare function hasContext(): boolean;
+/**
+ * Clear the global context
+ *
+ * Primarily used for testing or resetting state.
+ */
+export declare function clearContext(): void;
+/**
+ * Debug logging utility
+ *
+ * Only logs when debug mode is enabled (--debug flag or DEBUG=1 env var).
+ * Prefixes all output with [DEBUG] for easy filtering.
+ *
+ * @param ctx - CLI context (or just check ctx.debug)
+ * @param args - Arguments to log (same as console.log)
+ */
+export declare function debugLog(ctx: CLIContext, ...args: unknown[]): void;
+/**
+ * Debug logging utility that works without context
+ *
+ * Checks environment variable directly. Use when context is not available.
+ *
+ * @param args - Arguments to log (same as console.log)
+ */
+export declare function debugLogEnv(...args: unknown[]): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAmB,MAAM,YAAY,CAAC;AAG/E,cAAc,YAAY,CAAC;AAwC3B;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,UAAU,CAyB5E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAOvC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAIlE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAIpD"}

package/dist/internal/context/index.js

@@ -0,0 +1,151 @@
+/**
+ * Global CLI Context Module
+ *
+ * Manages shared state across all vibe-check commands.
+ * This is the foundation for global hooks and cross-command coordination.
+ *
+ * Usage:
+ *   import { createContext, getContext, setContext } from '@/internal/context';
+ *
+ *   // Create and set initial context
+ *   const ctx = createContext({ repo: '/path/to/repo', verbose: true });
+ *   setContext(ctx);
+ *
+ *   // Access context from anywhere
+ *   const ctx = getContext();
+ *   console.log(ctx.repo);
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+// Export types
+export * from './types.js';
+/**
+ * Default configuration values (minimal)
+ */
+const DEFAULT_CONFIG = {
+    output: {
+        format: 'terminal',
+        simple: false,
+        verbose: false,
+        quiet: false,
+    },
+};
+/**
+ * Global context singleton
+ * Initialized on first createContext() call or explicitly via setContext()
+ */
+let globalContext = null;
+/**
+ * Check if a directory is a git repository
+ */
+function isGitRepository(repoPath) {
+    try {
+        const gitDir = join(repoPath, '.git');
+        return existsSync(gitDir);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if debug mode is enabled via environment variable
+ */
+function isDebugEnabled() {
+    const debugEnv = process.env.DEBUG;
+    return debugEnv === '1' || debugEnv === 'true' || debugEnv === 'vibe-check';
+}
+/**
+ * Create a new CLI context with the given options
+ *
+ * Applies sensible defaults for any missing options.
+ *
+ * @param options - Context configuration options
+ * @returns Fully initialized CLIContext
+ */
+export function createContext(options = {}) {
+    const repo = options.repo ?? process.cwd();
+    const isGitRepo = options.isGitRepo ?? isGitRepository(repo);
+    // Use provided config or defaults (no file loading)
+    const config = options.config ?? DEFAULT_CONFIG;
+    // Apply config defaults to context options (CLI flags override config)
+    // Debug mode: CLI flag takes precedence, then env var
+    const debug = options.debug ?? isDebugEnabled();
+    const context = {
+        repo,
+        outputMode: options.outputMode ?? (config.output?.format === 'json' ? 'json' : 'terminal'),
+        verbose: options.verbose ?? config.output?.verbose ?? false,
+        quiet: options.quiet ?? config.output?.quiet ?? false,
+        debug,
+        timeout: options.timeout,
+        maxCommits: options.maxCommits,
+        version: options.version ?? '0.0.0', // Will be overridden by CLI
+        isGitRepo,
+        config,
+    };
+    return context;
+}
+/**
+ * Get the current global context
+ *
+ * @throws Error if context has not been initialized
+ * @returns The global CLIContext
+ */
+export function getContext() {
+    if (!globalContext) {
+        throw new Error('CLI context not initialized. Call createContext() or setContext() first.');
+    }
+    return globalContext;
+}
+/**
+ * Set the global context
+ *
+ * Used by hooks and the CLI bootstrap to establish global state.
+ *
+ * @param ctx - The context to set as global
+ */
+export function setContext(ctx) {
+    globalContext = ctx;
+}
+/**
+ * Check if context has been initialized
+ *
+ * @returns true if context is available, false otherwise
+ */
+export function hasContext() {
+    return globalContext !== null;
+}
+/**
+ * Clear the global context
+ *
+ * Primarily used for testing or resetting state.
+ */
+export function clearContext() {
+    globalContext = null;
+}
+/**
+ * Debug logging utility
+ *
+ * Only logs when debug mode is enabled (--debug flag or DEBUG=1 env var).
+ * Prefixes all output with [DEBUG] for easy filtering.
+ *
+ * @param ctx - CLI context (or just check ctx.debug)
+ * @param args - Arguments to log (same as console.log)
+ */
+export function debugLog(ctx, ...args) {
+    if (ctx.debug) {
+        console.log('[DEBUG]', ...args);
+    }
+}
+/**
+ * Debug logging utility that works without context
+ *
+ * Checks environment variable directly. Use when context is not available.
+ *
+ * @param args - Arguments to log (same as console.log)
+ */
+export function debugLogEnv(...args) {
+    if (isDebugEnabled()) {
+        console.log('[DEBUG]', ...args);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/internal/context/index.js.map

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

package/dist/internal/context/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Global CLI Context Types
+ *
+ * This module defines the shared context available across all commands.
+ * The context is initialized at CLI startup and can be accessed by hooks and commands.
+ */
+/**
+ * Output configuration
+ */
+export interface OutputConfig {
+    /** Default output format */
+    format?: 'terminal' | 'json' | 'markdown';
+    /** Use simple output by default */
+    simple?: boolean;
+    /** Enable verbose output by default */
+    verbose?: boolean;
+    /** Suppress non-essential output */
+    quiet?: boolean;
+}
+/**
+ * Minimal configuration for CLI context
+ */
+export interface VibeCheckConfig {
+    /** Output preferences */
+    output?: OutputConfig;
+}
+/**
+ * Main CLI context interface
+ *
+ * Contains global state and configuration that persists across command execution:
+ * - Repository information
+ * - Output formatting preferences
+ * - Verbosity settings
+ * - CLI version
+ */
+export interface CLIContext {
+    /** Repository path (absolute) */
+    repo: string;
+    /** Output format mode */
+    outputMode: 'terminal' | 'json';
+    /** Enable verbose logging */
+    verbose: boolean;
+    /** Suppress non-essential output */
+    quiet: boolean;
+    /** Enable debug logging (--debug flag or DEBUG=1 env var) */
+    debug: boolean;
+    /** Timeout for git operations in seconds */
+    timeout?: number;
+    /** Maximum number of commits to analyze */
+    maxCommits?: number;
+    /** CLI version */
+    version: string;
+    /** Whether the current directory is a git repository */
+    isGitRepo: boolean;
+    /** Loaded configuration (minimal) */
+    config: Required<VibeCheckConfig>;
+}
+/**
+ * Options for creating a new context
+ *
+ * All fields are optional - defaults will be applied.
+ */
+export interface CreateContextOptions {
+    repo?: string;
+    outputMode?: 'terminal' | 'json';
+    verbose?: boolean;
+    quiet?: boolean;
+    debug?: boolean;
+    timeout?: number;
+    maxCommits?: number;
+    version?: string;
+    isGitRepo?: boolean;
+    config?: Required<VibeCheckConfig>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/internal/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/internal/context/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1C,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,yBAAyB;IACzB,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;IAEhC,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IAEf,6DAA6D;IAC7D,KAAK,EAAE,OAAO,CAAC;IAEf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAEhB,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;IAEnB,qCAAqC;IACrC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;CACpC"}

package/dist/internal/context/types.js

@@ -0,0 +1,8 @@
+/**
+ * Global CLI Context Types
+ *
+ * This module defines the shared context available across all commands.
+ * The context is initialized at CLI startup and can be accessed by hooks and commands.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/internal/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internal/context/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/internal/output/contract.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Standardized Output Contract
+ *
+ * All commands should use this format when --json is set.
+ * This provides consistent structure for agent consumption:
+ * - success: boolean indicating command success
+ * - data: the actual command output (type varies by command)
+ * - metadata: command context (name, timestamp, version)
+ * - error: optional error message if success is false
+ *
+ * Usage:
+ *   import { wrapOutput, outputJson } from '@/internal/output/contract';
+ *
+ *   // In command:
+ *   const result = { spiraling: false, ... };
+ *   outputJson(wrapOutput('spiral', result));
+ */
+/**
+ * Standard metadata included in all outputs
+ */
+export interface OutputMetadata {
+    command: string;
+    timestamp: string;
+    version: string;
+    repo?: string;
+}
+/**
+ * Standard output contract for all commands
+ */
+export interface CommandOutput<T> {
+    success: boolean;
+    data: T;
+    metadata: OutputMetadata;
+    error?: string;
+}
+/**
+ * Wrap command output in the standard contract format
+ *
+ * @param command - The command name (e.g., 'spiral', 'diagnose')
+ * @param data - The command's output data
+ * @param error - Optional error message (sets success to false)
+ * @returns Wrapped output in standard format
+ */
+export declare function wrapOutput<T>(command: string, data: T, error?: string): CommandOutput<T>;
+/**
+ * Create an error output in standard format
+ *
+ * @param command - The command name
+ * @param error - The error message
+ * @param partialData - Optional partial data to include
+ * @returns Error output in standard format
+ */
+export declare function wrapError<T>(command: string, error: string, partialData?: Partial<T>): CommandOutput<Partial<T> | null>;
+/**
+ * Output JSON to stdout in standard format
+ *
+ * @param output - The wrapped command output
+ * @param pretty - Whether to pretty-print (default: true)
+ */
+export declare function outputJson<T>(output: CommandOutput<T>, pretty?: boolean): void;
+/**
+ * Check if we should use standard contract output
+ *
+ * Returns true if:
+ * - Global --json flag is set
+ * - Context is initialized with json output mode
+ */
+export declare function shouldUseContract(): boolean;
+/**
+ * Higher-order function to wrap command output in contract
+ *
+ * Usage:
+ *   const result = await runSpiral(options);
+ *   withContract('spiral', result); // Outputs wrapped if --json
+ *
+ * @param command - The command name
+ * @param data - The command's output data
+ * @param error - Optional error message
+ */
+export declare function withContract<T>(command: string, data: T, error?: string): void;
+//# sourceMappingURL=contract.d.ts.map

package/dist/internal/output/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/internal/output/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,EACP,KAAK,CAAC,EAAE,MAAM,GACb,aAAa,CAAC,CAAC,CAAC,CAyBlB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GACvB,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,UAAO,GAAG,IAAI,CAM3E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAU3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,EACP,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAIN"}