@lumenflow/core 3.2.0 → 3.2.1

package/dist/recovery/index.js

@@ -0,0 +1,14 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Recovery Module
+ *
+ * WU-1090: Context-aware state machine for WU lifecycle commands
+ *
+ * Exports:
+ * - Recovery analysis (detect issues, suggest actions)
+ *
+ * @module
+ */
+export * from './recovery-analyzer.js';
+//# sourceMappingURL=index.js.map

package/dist/recovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recovery/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;GASG;AAEH,cAAc,wBAAwB,CAAC"}

package/dist/recovery/recovery-analyzer.d.ts

@@ -0,0 +1,49 @@
+import { type RecoveryActionType, type RecoveryIssueCode } from '../wu-constants.js';
+import type { WuContext } from '../validation/types.js';
+/**
+ * Issue detected during recovery analysis.
+ */
+export interface RecoveryIssue {
+    /** Issue code from RECOVERY_ISSUES */
+    code: RecoveryIssueCode;
+    /** Human-readable description */
+    description: string;
+    /** Additional context for the issue */
+    context?: Record<string, unknown>;
+}
+/**
+ * Suggested recovery action.
+ */
+export interface WuRecoveryAction {
+    /** Action type from RECOVERY_ACTIONS */
+    type: RecoveryActionType;
+    /** Human-readable description of what this action does */
+    description: string;
+    /** Command to execute (copy-paste ready) */
+    command: string;
+    /** Whether this action requires --force flag */
+    requiresForce: boolean;
+    /** Warning message if UnsafeAny */
+    warning?: string;
+}
+/**
+ * Result of recovery analysis.
+ */
+export interface RecoveryAnalysis {
+    /** Whether UnsafeAny issues were found */
+    hasIssues: boolean;
+    /** List of detected issues */
+    issues: RecoveryIssue[];
+    /** Suggested recovery actions */
+    actions: WuRecoveryAction[];
+    /** WU ID analyzed */
+    wuId: string | null;
+}
+/**
+ * Analyze context for recovery issues.
+ *
+ * @param context - Current WU context
+ * @returns Recovery analysis with issues and suggested actions
+ */
+export declare function analyzeRecovery(context: WuContext): Promise<RecoveryAnalysis>;
+//# sourceMappingURL=recovery-analyzer.d.ts.map

package/dist/recovery/recovery-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-analyzer.d.ts","sourceRoot":"","sources":["../../src/recovery/recovery-analyzer.ts"],"names":[],"mappings":"AAyBA,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,IAAI,EAAE,iBAAiB,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,IAAI,EAAE,kBAAkB,CAAC;IACzB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,aAAa,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,iCAAiC;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,qBAAqB;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAmBD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoHnF"}

package/dist/recovery/recovery-analyzer.js

@@ -0,0 +1,149 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Recovery Analyzer for WU State Issues
+ *
+ * WU-1090: Context-aware state machine for WU lifecycle commands
+ *
+ * Analyzes WU context to detect state inconsistencies and suggests
+ * appropriate recovery actions.
+ *
+ * Issue types detected:
+ * - Partial claim: worktree exists but status is ready
+ * - Orphan claim: status is in_progress but worktree missing
+ * - Inconsistent state: YAML and state store disagree
+ * - Orphan branch: branch exists but worktree missing
+ * - Stale lock: lock file from old session
+ * - Leftover worktree: WU is done but worktree exists
+ * - Merged not done: branch merged to main but WU not stamped (WU-1746)
+ *
+ * @module
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { CONTEXT_VALIDATION, WU_STATUS, DEFAULTS, toKebab, } from '../wu-constants.js';
+const { RECOVERY_ISSUES, RECOVERY_ACTIONS } = CONTEXT_VALIDATION;
+/**
+ * Get expected worktree path for a WU.
+ */
+function getExpectedWorktreePath(mainCheckout, lane, wuId) {
+    const laneKebab = toKebab(lane);
+    const wuIdLower = wuId.toLowerCase();
+    return join(mainCheckout, DEFAULTS.WORKTREES_DIR, `${laneKebab}-${wuIdLower}`);
+}
+/**
+ * Check if worktree exists for a WU.
+ */
+function worktreeExists(mainCheckout, lane, wuId) {
+    const worktreePath = getExpectedWorktreePath(mainCheckout, lane, wuId);
+    return existsSync(worktreePath);
+}
+/**
+ * Analyze context for recovery issues.
+ *
+ * @param context - Current WU context
+ * @returns Recovery analysis with issues and suggested actions
+ */
+export async function analyzeRecovery(context) {
+    const issues = [];
+    const actions = [];
+    // No WU context means nothing to analyze
+    if (!context.wu) {
+        return {
+            hasIssues: false,
+            issues: [],
+            actions: [],
+            wuId: null,
+        };
+    }
+    const { wu } = context;
+    const mainCheckout = context.location.mainCheckout;
+    const hasWorktree = worktreeExists(mainCheckout, wu.lane, wu.id);
+    const worktreePath = getExpectedWorktreePath(mainCheckout, wu.lane, wu.id);
+    // Check for partial claim: worktree exists but status is ready
+    if (hasWorktree && wu.status === WU_STATUS.READY) {
+        issues.push({
+            code: RECOVERY_ISSUES.PARTIAL_CLAIM,
+            description: `Worktree exists for ${wu.id} but status is 'ready'. The claim may have been interrupted.`,
+            context: { worktreePath, status: wu.status },
+        });
+        actions.push({
+            type: RECOVERY_ACTIONS.RESUME,
+            description: 'Reconcile state and continue working (preserves work)',
+            command: `pnpm wu:recover --id ${wu.id} --action resume`,
+            requiresForce: false,
+        });
+        actions.push({
+            type: RECOVERY_ACTIONS.RESET,
+            description: 'Discard worktree and reset WU to ready',
+            command: `pnpm wu:recover --id ${wu.id} --action reset`,
+            requiresForce: false,
+            warning: 'This will discard UnsafeAny uncommitted work in the worktree',
+        });
+    }
+    // Check for orphan claim: status is in_progress but worktree missing
+    if (!hasWorktree && wu.status === WU_STATUS.IN_PROGRESS) {
+        issues.push({
+            code: RECOVERY_ISSUES.ORPHAN_CLAIM,
+            description: `${wu.id} is 'in_progress' but worktree is missing. The worktree may have been manually deleted.`,
+            context: { expectedPath: worktreePath, status: wu.status },
+        });
+        actions.push({
+            type: RECOVERY_ACTIONS.RESET,
+            description: 'Reset WU status back to ready for re-claiming',
+            command: `pnpm wu:recover --id ${wu.id} --action reset`,
+            requiresForce: false,
+        });
+    }
+    // Check for leftover worktree: WU is done but worktree exists
+    if (hasWorktree && wu.status === WU_STATUS.DONE) {
+        issues.push({
+            code: RECOVERY_ISSUES.LEFTOVER_WORKTREE,
+            description: `${wu.id} is 'done' but worktree still exists. The cleanup may have failed.`,
+            context: { worktreePath, status: wu.status },
+        });
+        actions.push({
+            type: RECOVERY_ACTIONS.CLEANUP,
+            description: 'Remove leftover worktree for completed WU',
+            command: `pnpm wu:recover --id ${wu.id} --action cleanup`,
+            requiresForce: false,
+        });
+    }
+    // Check for inconsistent state
+    if (!wu.isConsistent && wu.inconsistencyReason) {
+        issues.push({
+            code: RECOVERY_ISSUES.INCONSISTENT_STATE,
+            description: wu.inconsistencyReason,
+            context: { wuId: wu.id },
+        });
+        actions.push({
+            type: RECOVERY_ACTIONS.RESET,
+            description: 'Reconcile YAML and state store',
+            command: `pnpm wu:recover --id ${wu.id} --action reset`,
+            requiresForce: false,
+        });
+    }
+    // WU-1746: Check for merged-not-done: branch is merged to main but WU is not stamped
+    // This happens when a worktree is manually merged and deleted without running wu:done
+    if (wu.branchMergedToMain && !hasWorktree && wu.status !== WU_STATUS.DONE) {
+        issues.push({
+            code: RECOVERY_ISSUES.MERGED_NOT_DONE,
+            description: `${wu.id} branch commits are merged to main but WU is not marked as done (status: '${wu.status}'). ` +
+                `The worktree was likely manually merged and deleted without running wu:done.`,
+            context: { expectedPath: worktreePath, status: wu.status, branchMergedToMain: true },
+        });
+        actions.push({
+            type: RECOVERY_ACTIONS.COMPLETE,
+            description: 'Complete WU stamping and state cleanup (branch already merged)',
+            command: `pnpm wu:done --id ${wu.id}`,
+            requiresForce: false,
+        });
+    }
+    return {
+        hasIssues: issues.length > 0,
+        issues,
+        actions,
+        wuId: wu.id,
+    };
+}
+//# sourceMappingURL=recovery-analyzer.js.map

package/dist/recovery/recovery-analyzer.js.map

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

package/dist/resolve-policy.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Resolve Policy - Single Source of Truth for Methodology Decisions
+ *
+ * WU-1259: Provides a unified policy resolver that both wu:spawn and gates use.
+ *
+ * This module:
+ * - Defines the methodology.* config schema
+ * - Implements resolvePolicy() to produce ResolvedPolicy
+ * - Applies precedence: template defaults -> methodology.overrides -> explicit gates.* -> CLI flags
+ *
+ * @module resolve-policy
+ */
+import { z } from 'zod';
+import type { LumenFlowConfig } from './lumenflow-config-schema.js';
+/**
+ * Testing methodology options
+ */
+export declare const TESTING_METHODOLOGY: {
+    readonly TDD: "tdd";
+    readonly TEST_AFTER: "test-after";
+    readonly NONE: "none";
+};
+export type TestingMethodology = (typeof TESTING_METHODOLOGY)[keyof typeof TESTING_METHODOLOGY];
+/**
+ * Architecture methodology options
+ */
+export declare const ARCHITECTURE_METHODOLOGY: {
+    readonly HEXAGONAL: "hexagonal";
+    readonly LAYERED: "layered";
+    readonly NONE: "none";
+};
+export type ArchitectureMethodology = (typeof ARCHITECTURE_METHODOLOGY)[keyof typeof ARCHITECTURE_METHODOLOGY];
+/**
+ * Coverage mode options
+ */
+export declare const COVERAGE_MODE: {
+    readonly BLOCK: "block";
+    readonly WARN: "warn";
+    readonly OFF: "off";
+};
+export type CoverageMode = (typeof COVERAGE_MODE)[keyof typeof COVERAGE_MODE];
+/**
+ * Zod schema for testing methodology enum
+ */
+export declare const TestingMethodologySchema: z.ZodEnum<{
+    tdd: "tdd";
+    "test-after": "test-after";
+    none: "none";
+}>;
+/**
+ * Zod schema for architecture methodology enum
+ */
+export declare const ArchitectureMethodologySchema: z.ZodEnum<{
+    none: "none";
+    hexagonal: "hexagonal";
+    layered: "layered";
+}>;
+/**
+ * Zod schema for coverage mode enum
+ */
+export declare const CoverageModeSchema: z.ZodEnum<{
+    off: "off";
+    warn: "warn";
+    block: "block";
+}>;
+/**
+ * Methodology overrides schema
+ *
+ * These allow tweaking template defaults without changing methodology.
+ */
+export declare const MethodologyOverridesSchema: z.ZodObject<{
+    coverage_threshold: z.ZodOptional<z.ZodNumber>;
+    coverage_mode: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        warn: "warn";
+        block: "block";
+    }>>;
+}, z.core.$strip>;
+export type MethodologyOverrides = z.infer<typeof MethodologyOverridesSchema>;
+/**
+ * WU-1899: Work classification UI pattern configuration
+ *
+ * Allows extending default UI detection patterns with project-specific
+ * code path patterns and lane hints. Custom values EXTEND defaults,
+ * they do not replace them.
+ *
+ * @example
+ * ```yaml
+ * methodology:
+ *   work_classification:
+ *     ui:
+ *       code_path_patterns:
+ *         - 'src/widgets/*.tsx'
+ *       lane_hints:
+ *         - 'Design'
+ * ```
+ */
+export declare const WorkClassificationUiSchema: z.ZodObject<{
+    code_path_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    lane_hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/** WU-1899: TypeScript type for work classification UI config */
+export type WorkClassificationUi = z.infer<typeof WorkClassificationUiSchema>;
+/**
+ * WU-1899: Work classification configuration schema
+ *
+ * Controls signal-based work domain detection for code-path-aware
+ * UI/backend/docs/infra classification.
+ *
+ * @example
+ * ```yaml
+ * methodology:
+ *   work_classification:
+ *     ui:
+ *       code_path_patterns:
+ *         - 'src/widgets/*.tsx'
+ *       lane_hints:
+ *         - 'Design'
+ * ```
+ */
+export declare const WorkClassificationConfigSchema: z.ZodObject<{
+    ui: z.ZodOptional<z.ZodObject<{
+        code_path_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        lane_hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** WU-1899: TypeScript type for work classification config */
+export type WorkClassificationSchemaConfig = z.infer<typeof WorkClassificationConfigSchema>;
+/**
+ * Main methodology configuration schema
+ *
+ * Config example in workspace.yaml:
+ * ```yaml
+ * methodology:
+ *   testing: 'tdd'              # tdd | test-after | none
+ *   architecture: 'hexagonal'   # hexagonal | layered | none
+ *   overrides:
+ *     coverage_threshold: 85    # Override TDD's default 90%
+ *     coverage_mode: 'warn'     # Override TDD's default 'block'
+ *   work_classification:
+ *     ui:
+ *       code_path_patterns:
+ *         - 'src/widgets/*.tsx'
+ *       lane_hints:
+ *         - 'Design'
+ * ```
+ */
+export declare const MethodologyConfigSchema: z.ZodObject<{
+    testing: z.ZodDefault<z.ZodEnum<{
+        tdd: "tdd";
+        "test-after": "test-after";
+        none: "none";
+    }>>;
+    architecture: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        hexagonal: "hexagonal";
+        layered: "layered";
+    }>>;
+    overrides: z.ZodOptional<z.ZodObject<{
+        coverage_threshold: z.ZodOptional<z.ZodNumber>;
+        coverage_mode: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            warn: "warn";
+            block: "block";
+        }>>;
+    }, z.core.$strip>>;
+    work_classification: z.ZodOptional<z.ZodObject<{
+        ui: z.ZodOptional<z.ZodObject<{
+            code_path_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            lane_hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MethodologyConfig = z.infer<typeof MethodologyConfigSchema>;
+/**
+ * The resolved policy used by wu:spawn and gates
+ *
+ * This is the single source of truth for methodology decisions.
+ * All consumers (spawn prompts, gate runners, etc.) should use this type.
+ */
+export interface ResolvedPolicy {
+    /** Active testing methodology */
+    testing: TestingMethodology;
+    /** Active architecture methodology */
+    architecture: ArchitectureMethodology;
+    /** Resolved coverage threshold (0-100) */
+    coverage_threshold: number;
+    /** Resolved coverage mode */
+    coverage_mode: CoverageMode;
+    /** Whether tests are required for completion */
+    tests_required: boolean;
+}
+/**
+ * Options for resolvePolicy
+ */
+export interface ResolvePolicyOptions {
+    /**
+     * Raw config object before Zod defaults were applied.
+     * Used to detect explicit vs default values for gates.* fields.
+     *
+     * When provided, only EXPLICIT gates.* settings override methodology.
+     * When not provided, UnsafeAny gates.* value (including defaults) overrides methodology.
+     */
+    rawConfig?: {
+        gates?: {
+            minCoverage?: number;
+            enableCoverage?: boolean;
+        };
+    };
+}
+/**
+ * Resolve the effective policy from configuration
+ *
+ * Precedence (highest to lowest):
+ * 1. CLI flags (not handled here - handled by command layer)
+ * 2. Explicit gates.* configuration (only if rawConfig provided to detect explicit vs default)
+ * 3. methodology.overrides
+ * 4. methodology template defaults
+ *
+ * This ensures backwards compatibility: existing users with explicit
+ * gates.* config see no change, while new users can use methodology
+ * config for a higher-level abstraction.
+ *
+ * @param config - The full LumenFlow configuration
+ * @param options - Options including rawConfig for explicit detection
+ * @returns The resolved policy for use by wu:spawn and gates
+ *
+ * @example
+ * ```typescript
+ * import { getConfig } from './lumenflow-config.js';
+ * import { resolvePolicy } from './resolve-policy.js';
+ *
+ * const config = getConfig();
+ * const policy = resolvePolicy(config);
+ *
+ * console.log(policy.coverage_threshold); // 90 (or configured value)
+ * console.log(policy.testing); // 'tdd' (or configured value)
+ * ```
+ *
+ * @example With raw config for explicit detection
+ * ```typescript
+ * const rawConfig = { methodology: { testing: 'test-after' } };
+ * const config = parseConfig(rawConfig);
+ * const policy = resolvePolicy(config, { rawConfig });
+ * // policy.coverage_threshold will be 70 (test-after template default)
+ * // because gates.minCoverage wasn't EXPLICITLY set
+ * ```
+ */
+export declare function resolvePolicy(config: LumenFlowConfig, options?: ResolvePolicyOptions): ResolvedPolicy;
+/**
+ * Create a default resolved policy
+ *
+ * Convenience function for when no config is available.
+ * Returns strict TDD defaults.
+ */
+export declare function getDefaultPolicy(): ResolvedPolicy;
+//# sourceMappingURL=resolve-policy.d.ts.map

package/dist/resolve-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-policy.d.ts","sourceRoot":"","sources":["../src/resolve-policy.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;EAAwC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;EAA2C,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;EAAmC,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;;iBAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,0BAA0B;;;iBAcrC,CAAC;AAEH,iEAAiE;AACjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,8BAA8B;;;;;iBAGzC,CAAC;AAEH,8DAA8D;AAC9D,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE5F;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;iBAalC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAqCxE;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,sCAAsC;IACtC,YAAY,EAAE,uBAAuB,CAAC;IACtC,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,aAAa,EAAE,YAAY,CAAC;IAC5B,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE;YACN,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,cAAc,CAAC,EAAE,OAAO,CAAC;SAC1B,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,oBAAyB,GACjC,cAAc,CA+DhB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAQjD"}