@lumenflow/core 3.2.0 → 3.2.1

package/dist/wu-spawn.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Spawn - Thin Facade (WU-2012)
+ *
+ * Generates ready-to-use Task tool invocations for sub-agent WU execution.
+ *
+ * This file serves as the public API facade and CLI entry point.
+ * All implementation is delegated to focused modules:
+ *
+ * - spawn-template-assembler.ts: Template loading, context building, constants
+ * - spawn-guidance-generators.ts: Test methodology and architecture guidance
+ * - spawn-policy-resolver.ts: Mandatory standards, enforcement summary, telemetry
+ * - spawn-constraints-generator.ts: Constraints block generation
+ * - spawn-prompt-helpers.ts: WU doc formatting helpers (acceptance, invariants, agents)
+ * - spawn-agent-guidance.ts: Agent operational guidance sections
+ * - spawn-task-builder.ts: Task invocation, Codex prompt assembly, lane occupation
+ *
+ * Existing helper modules (pre-WU-2012):
+ * - wu-spawn-helpers.ts: Thinking mode, spawn registry
+ * - wu-spawn-skills.ts: Skills selection and client config
+ * - wu-spawn-context.ts: Memory context integration
+ *
+ * @module wu-spawn
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { createWUParser, WU_OPTIONS } from './arg-parser.js';
+import { WU_PATHS } from './wu-paths.js';
+import { parseYAML } from './wu-yaml.js';
+import { die, getErrorMessage } from './error-handler.js';
+import { WU_STATUS, PATTERNS, EMOJI, LUMENFLOW_PATHS } from './wu-constants.js';
+import { SpawnStrategyFactory } from './spawn-strategy.js';
+import { getConfig } from './lumenflow-config.js';
+import { resolvePolicy } from './resolve-policy.js';
+import { validateSpawnDependencies, formatDependencyError } from './dependency-validator.js';
+import { validateSpawnArgs, recordSpawnToRegistry, formatSpawnRecordedMessage, } from './wu-spawn-helpers.js';
+import { resolveClientConfig } from './wu-spawn-skills.js';
+// ============================================================================
+// Re-exports: Public API surface (zero breaking changes)
+// ============================================================================
+// From spawn-template-assembler
+export { TRUNCATION_WARNING_BANNER, SPAWN_END_SENTINEL, tryAssembleSpawnTemplates, buildTemplateContext, buildTemplateContextWithPolicy, } from './spawn-template-assembler.js';
+// From spawn-guidance-generators
+export { generateTestGuidance, generatePolicyBasedTestGuidance, generatePolicyBasedArchitectureGuidance, generateDesignContextSection, } from './spawn-guidance-generators.js';
+// From spawn-policy-resolver
+export { generateMandatoryStandards, generateEnforcementSummary, emitMethodologyTelemetry, } from './spawn-policy-resolver.js';
+// From spawn-guidance-generators (worktree recovery guidance)
+export { generateWorktreeBlockRecoverySection } from './spawn-guidance-generators.js';
+// From spawn-agent-guidance (agent operational guidance)
+export { generateEffortScalingRules, generateParallelToolCallGuidance, generateIterativeSearchHeuristics, generateTokenBudgetAwareness, generateCompletionFormat, generateAgentCoordinationSection, generateQuickFixCommands, generateLaneSelectionSection, generateWorktreePathGuidance, generateActionSection, } from './spawn-agent-guidance.js';
+// From spawn-task-builder (WU-2048: inlined spawn-lane-occupation re-exports)
+export { generateTaskInvocation, generateCodexPrompt, checkLaneOccupation, generateLaneOccupationWarning, } from './spawn-task-builder.js';
+const LOG_PREFIX = '[wu:spawn]';
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    // WU-2202: Validate dependencies BEFORE any other operation
+    const depResult = await validateSpawnDependencies();
+    if (!depResult.valid) {
+        die(formatDependencyError('wu:spawn', depResult.missing));
+    }
+    const args = createWUParser({
+        name: 'wu-spawn',
+        description: 'Generate Task tool invocation for sub-agent WU execution',
+        // WU-2044: Removed duplicate CLI options (copy-paste bug)
+        options: [
+            WU_OPTIONS.id,
+            WU_OPTIONS.thinking,
+            WU_OPTIONS.noThinking,
+            WU_OPTIONS.budget,
+            WU_OPTIONS.codex,
+            WU_OPTIONS.parentWu,
+            WU_OPTIONS.client,
+            WU_OPTIONS.vendor,
+        ].filter((option) => option !== undefined),
+        required: ['id'],
+        allowPositionalId: true,
+    });
+    // Validate thinking mode options
+    try {
+        validateSpawnArgs(args);
+    }
+    catch (e) {
+        die(getErrorMessage(e));
+    }
+    const id = args.id.toUpperCase();
+    if (!PATTERNS.WU_ID.test(id)) {
+        die(`Invalid WU id '${args.id}'. Expected format WU-123`);
+    }
+    const WU_PATH = WU_PATHS.WU(id);
+    // Check if WU file exists
+    if (!existsSync(WU_PATH)) {
+        die(`WU file not found: ${WU_PATH}\n\n` +
+            `Cannot spawn a sub-agent for a WU that doesn't exist.\n\n` +
+            `Options:\n` +
+            `  1. Create the WU first: pnpm wu:create --id ${id} --lane <lane> --title "..."\n` +
+            `  2. Check if the WU ID is correct`);
+    }
+    // Read and parse WU YAML
+    let doc;
+    let text;
+    try {
+        text = readFileSync(WU_PATH, { encoding: 'utf-8' });
+    }
+    catch (e) {
+        die(`Failed to read WU file: ${WU_PATH}\n\n` +
+            `Error: ${getErrorMessage(e)}\n\n` +
+            `Options:\n` +
+            `  1. Check file permissions: ls -la ${WU_PATH}\n` +
+            `  2. Ensure the file exists and is readable`);
+    }
+    try {
+        doc = parseYAML(text);
+    }
+    catch (e) {
+        die(`Failed to parse WU YAML ${WU_PATH}\n\n` +
+            `Error: ${getErrorMessage(e)}\n\n` +
+            `Options:\n` +
+            `  1. Validate YAML syntax: pnpm wu:validate --id ${id}\n` +
+            `  2. Fix YAML errors manually and retry`);
+    }
+    // Warn if WU is not in ready or in_progress status
+    const validStatuses = [WU_STATUS.READY, WU_STATUS.IN_PROGRESS];
+    if (!validStatuses.includes(doc.status)) {
+        console.warn(`${LOG_PREFIX} ${EMOJI.WARNING} Warning: ${id} has status '${doc.status}'.`);
+        console.warn(`${LOG_PREFIX} ${EMOJI.WARNING} Sub-agents typically work on ready or in_progress WUs.`);
+        console.warn('');
+    }
+    // WU-1603: Check if lane is already occupied and warn
+    const { checkLaneOccupation: checkOccupation } = await import('./spawn-task-builder.js');
+    const { generateLaneOccupationWarning: generateWarning } = await import('./spawn-task-builder.js');
+    const lane = doc.lane;
+    if (lane) {
+        const existingLock = checkOccupation(lane);
+        if (existingLock && existingLock.wuId !== id) {
+            const { isLockStale } = await import('./lane-lock.js');
+            const isStale = isLockStale(existingLock);
+            const warning = generateWarning(existingLock, id, { isStale });
+            console.warn(`${LOG_PREFIX} ${EMOJI.WARNING}\n${warning}\n`);
+        }
+    }
+    // Build thinking mode options for task invocation
+    const thinkingOptions = {
+        thinking: args.thinking,
+        noThinking: args.noThinking,
+        budget: args.budget,
+    };
+    // Client Resolution
+    const config = getConfig();
+    let clientName = args.client;
+    if (!clientName && args.vendor) {
+        console.warn(`${LOG_PREFIX} ${EMOJI.WARNING} Warning: --vendor is deprecated. Use --client.`);
+        clientName = args.vendor;
+    }
+    // Codex handling (deprecated legacy flag)
+    if (args.codex) {
+        if (!clientName) {
+            console.warn(`${LOG_PREFIX} ${EMOJI.WARNING} Warning: --codex is deprecated. Use --client codex-cli.`);
+            clientName = 'codex-cli';
+        }
+    }
+    if (!clientName) {
+        clientName = config.agents.defaultClient || 'claude-code';
+    }
+    // Create strategy
+    const strategy = SpawnStrategyFactory.create(clientName);
+    const clientContext = { name: clientName, config: resolveClientConfig(config, clientName) };
+    // Import task builders
+    const { generateTaskInvocation: buildTaskInvocation, generateCodexPrompt: buildCodexPrompt } = await import('./spawn-task-builder.js');
+    if (clientName === 'codex-cli' || args.codex) {
+        const _prompt = buildCodexPrompt(doc, id, strategy, {
+            ...thinkingOptions,
+            client: clientContext,
+            config,
+        });
+        console.log(`${LOG_PREFIX} Generated Codex/GPT prompt for ${id}`);
+        console.log(`${LOG_PREFIX} Copy the Markdown below:\n`);
+        // ...
+        // Generate and output the Task invocation
+        const invocation = buildTaskInvocation(doc, id, strategy, {
+            ...thinkingOptions,
+            client: clientContext,
+            config,
+        });
+        console.log(`${LOG_PREFIX} Generated Task tool invocation for ${id}`);
+        console.log(`${LOG_PREFIX} Copy the block below to spawn a sub-agent:\n`);
+        console.log(invocation);
+        // WU-1270: Emit methodology telemetry (opt-in only)
+        const { emitMethodologyTelemetry: emitTelemetry } = await import('./spawn-policy-resolver.js');
+        const policy = resolvePolicy(config);
+        emitTelemetry(config, policy);
+        // WU-1945: Record spawn event to registry (non-blocking)
+        if (args.parentWu) {
+            const registryResult = await recordSpawnToRegistry({
+                parentWuId: args.parentWu,
+                targetWuId: id,
+                lane: doc.lane || 'Unknown',
+                baseDir: LUMENFLOW_PATHS.STATE_DIR,
+            });
+            const registryMessage = formatSpawnRecordedMessage(registryResult.spawnId, registryResult.error);
+            console.log(`\n${registryMessage}`);
+        }
+    }
+}
+// Guard main() for testability
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    void main();
+}
+//# sourceMappingURL=wu-spawn.js.map

package/dist/wu-spawn.js.map

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

package/dist/wu-state-indexer.d.ts

@@ -0,0 +1,49 @@
+import { type WUEvent } from './wu-state-schema.js';
+import type { WUStateEntry, CheckpointOptions } from './ports/wu-state.ports.js';
+export type { WUStateEntry, CheckpointOptions };
+/**
+ * WU State Indexer
+ *
+ * Maintains in-memory WU state with O(1) indexes for status, lane,
+ * and parent-child queries. Processes events to update state.
+ */
+export declare class WUStateIndexer {
+    private wuState;
+    private byStatus;
+    private byLane;
+    private byParent;
+    constructor();
+    /**
+     * Clear all in-memory state and indexes.
+     */
+    clear(): void;
+    /**
+     * Apply an event to the in-memory state.
+     */
+    applyEvent(event: WUEvent): void;
+    /**
+     * Get current in-memory state for a WU.
+     */
+    getWUState(wuId: string): WUStateEntry | undefined;
+    /**
+     * Get WU IDs by status (O(1) lookup).
+     */
+    getByStatus(status: string): Set<string>;
+    /**
+     * Get WU IDs by lane (O(1) lookup).
+     */
+    getByLane(lane: string): Set<string>;
+    /**
+     * Get child WU IDs delegated from a parent WU (O(1) lookup).
+     */
+    getChildWUs(parentWuId: string): Set<string>;
+    /**
+     * Transition WU to a new status if it exists.
+     */
+    private _transitionToStatus;
+    /**
+     * Set WU state and update indexes.
+     */
+    private _setState;
+}
+//# sourceMappingURL=wu-state-indexer.d.ts.map

package/dist/wu-state-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-state-indexer.d.ts","sourceRoot":"","sources":["../src/wu-state-indexer.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGjF,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAEhD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAA2B;;IAS3C;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAuDhC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIlD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIxC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIpC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAI5C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,SAAS;CA+BlB"}

package/dist/wu-state-indexer.js

@@ -0,0 +1,156 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU State Indexer (WU-2013)
+ *
+ * Manages in-memory WU state and maintains O(1) indexes by status, lane,
+ * and parent-child delegation relationships. Applies events to state
+ * following the INIT-007 event-sourcing pattern.
+ *
+ * Single responsibility: in-memory state management and event application.
+ *
+ * @see {@link ./wu-state-store.ts} - Facade that delegates to this service
+ */
+import { WU_STATUS } from './wu-constants.js';
+import { WU_EVENT_TYPE } from './wu-state-schema.js';
+/**
+ * WU State Indexer
+ *
+ * Maintains in-memory WU state with O(1) indexes for status, lane,
+ * and parent-child queries. Processes events to update state.
+ */
+export class WUStateIndexer {
+    wuState;
+    byStatus;
+    byLane;
+    byParent;
+    constructor() {
+        this.wuState = new Map();
+        this.byStatus = new Map();
+        this.byLane = new Map();
+        this.byParent = new Map();
+    }
+    /**
+     * Clear all in-memory state and indexes.
+     */
+    clear() {
+        this.wuState.clear();
+        this.byStatus.clear();
+        this.byLane.clear();
+        this.byParent.clear();
+    }
+    /**
+     * Apply an event to the in-memory state.
+     */
+    applyEvent(event) {
+        const { wuId, type } = event;
+        if (type === WU_EVENT_TYPE.CREATE || type === WU_EVENT_TYPE.CLAIM) {
+            // Discriminated union narrows to CreateEvent | ClaimEvent (both have lane/title)
+            this._setState(wuId, WU_STATUS.IN_PROGRESS, event.lane, event.title);
+            return;
+        }
+        if (type === WU_EVENT_TYPE.BLOCK) {
+            this._transitionToStatus(wuId, WU_STATUS.BLOCKED);
+            return;
+        }
+        if (type === WU_EVENT_TYPE.UNBLOCK) {
+            this._transitionToStatus(wuId, WU_STATUS.IN_PROGRESS);
+            return;
+        }
+        if (type === WU_EVENT_TYPE.COMPLETE) {
+            this._transitionToStatus(wuId, WU_STATUS.DONE);
+            // WU-2244: Store completion timestamp for accurate date reporting
+            const current = this.wuState.get(wuId);
+            if (current) {
+                current.completedAt = event.timestamp;
+            }
+            return;
+        }
+        if (type === WU_EVENT_TYPE.CHECKPOINT) {
+            // Discriminated union narrows to CheckpointEvent (has note field)
+            const currentCheckpoint = this.wuState.get(wuId);
+            if (currentCheckpoint) {
+                currentCheckpoint.lastCheckpoint = event.timestamp;
+                currentCheckpoint.lastCheckpointNote = event.note;
+            }
+            return;
+        }
+        if (type === WU_EVENT_TYPE.DELEGATION) {
+            // Discriminated union narrows to DelegationEvent (has parentWuId)
+            const { parentWuId } = event;
+            if (!this.byParent.has(parentWuId)) {
+                this.byParent.set(parentWuId, new Set());
+            }
+            this.byParent.get(parentWuId).add(wuId);
+            return;
+        }
+        // WU-1080: Handle release event - transitions from in_progress to ready
+        if (type === WU_EVENT_TYPE.RELEASE) {
+            this._transitionToStatus(wuId, WU_STATUS.READY);
+        }
+    }
+    /**
+     * Get current in-memory state for a WU.
+     */
+    getWUState(wuId) {
+        return this.wuState.get(wuId);
+    }
+    /**
+     * Get WU IDs by status (O(1) lookup).
+     */
+    getByStatus(status) {
+        return this.byStatus.get(status) ?? new Set();
+    }
+    /**
+     * Get WU IDs by lane (O(1) lookup).
+     */
+    getByLane(lane) {
+        return this.byLane.get(lane) ?? new Set();
+    }
+    /**
+     * Get child WU IDs delegated from a parent WU (O(1) lookup).
+     */
+    getChildWUs(parentWuId) {
+        return this.byParent.get(parentWuId) ?? new Set();
+    }
+    /**
+     * Transition WU to a new status if it exists.
+     */
+    _transitionToStatus(wuId, newStatus) {
+        const current = this.wuState.get(wuId);
+        if (current) {
+            this._setState(wuId, newStatus, current.lane, current.title);
+        }
+    }
+    /**
+     * Set WU state and update indexes.
+     */
+    _setState(wuId, status, lane, title) {
+        // Remove from old status index
+        const oldState = this.wuState.get(wuId);
+        if (oldState) {
+            const oldStatusSet = this.byStatus.get(oldState.status);
+            if (oldStatusSet) {
+                oldStatusSet.delete(wuId);
+            }
+            // Remove from old lane index
+            const oldLaneSet = this.byLane.get(oldState.lane);
+            if (oldLaneSet) {
+                oldLaneSet.delete(wuId);
+            }
+        }
+        // Update state
+        this.wuState.set(wuId, { status, lane, title });
+        // Add to new status index
+        if (!this.byStatus.has(status)) {
+            this.byStatus.set(status, new Set());
+        }
+        this.byStatus.get(status).add(wuId);
+        // Add to new lane index
+        if (!this.byLane.has(lane)) {
+            this.byLane.set(lane, new Set());
+        }
+        this.byLane.get(lane).add(wuId);
+    }
+}
+//# sourceMappingURL=wu-state-indexer.js.map

package/dist/wu-state-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-state-indexer.js","sourceRoot":"","sources":["../src/wu-state-indexer.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAgB,MAAM,sBAAsB,CAAC;AAMnE;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,CAA4B;IACnC,QAAQ,CAA2B;IACnC,MAAM,CAA2B;IACjC,QAAQ,CAA2B;IAE3C;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAc;QACvB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QAE7B,IAAI,IAAI,KAAK,aAAa,CAAC,MAAM,IAAI,IAAI,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC;YAClE,iFAAiF;YACjF,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,aAAa,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,aAAa,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YAC/C,kEAAkE;YAClE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC;YACxC,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,aAAa,CAAC,UAAU,EAAE,CAAC;YACtC,kEAAkE;YAClE,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,iBAAiB,EAAE,CAAC;gBACtB,iBAAiB,CAAC,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC;gBACnD,iBAAiB,CAAC,kBAAkB,GAAG,KAAK,CAAC,IAAI,CAAC;YACpD,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,aAAa,CAAC,UAAU,EAAE,CAAC;YACtC,kEAAkE;YAClE,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YAC3C,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QAED,wEAAwE;QACxE,IAAI,IAAI,KAAK,aAAa,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAc;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,UAAkB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IACpD,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,IAAY,EAAE,SAAiB;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY,EAAE,KAAa;QACzE,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;YAED,6BAA6B;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,eAAe;QACf,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhD,0BAA0B;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAErC,wBAAwB;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF"}