@lumenflow/core 3.1.2 → 3.1.3

package/dist/worktree-symlink.js

@@ -1,349 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Worktree Symlink Utilities
- *
- * WU-1443: Auto-symlink node_modules in new worktrees
- * WU-1579: Extend to symlink nested package node_modules
- * WU-2238: Detect and refuse symlinks when target contains worktree-path symlinks
- *
- * After wu:claim creates a worktree, running pnpm commands fails with
- * 'node_modules missing'. This module provides the symlink helper to
- * auto-create the node_modules symlink pointing to the main repo's
- * node_modules directory, including nested package node_modules.
- *
- * @module tools/lib/worktree-symlink.ts
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { LOG_PREFIX } from './wu-constants.js';
-import { getErrorMessage } from './error-handler.js';
-/**
- * Relative path from worktree to main repo's node_modules
- *
- * Worktrees are at: worktrees/<lane>-wu-<id>/
- * node_modules is at: ./node_modules (project root)
- *
- * So from worktree: ../../node_modules
- */
-const RELATIVE_NODE_MODULES_PATH = '../../node_modules';
-/**
- * node_modules directory name
- */
-const NODE_MODULES_DIR = 'node_modules';
-/**
- * Pattern to detect paths that are inside a worktrees directory.
- * Used to identify symlinks that may break when worktrees are removed.
- */
-const WORKTREES_PATH_SEGMENT = '/worktrees/';
-/**
- * pnpm store directory name (contains package symlinks)
- */
-const PNPM_DIR = '.pnpm';
-/**
- * List of nested package/app paths that have their own node_modules
- *
- * pnpm monorepos create node_modules in each package with symlinks
- * to the .pnpm store. turbo typecheck and tests need these to resolve imports.
- *
- * WU-1068: Removed @exampleapp references. Only @lumenflow packages are
- * relevant to the LumenFlow framework. Project-specific paths should be
- * configured in .lumenflow.config.yaml.
- *
- * @type {string[]}
- */
-export const NESTED_PACKAGE_PATHS = [
-    // Packages - @lumenflow/*
-    'packages/@lumenflow/core',
-    'packages/@lumenflow/cli',
-    'packages/@lumenflow/memory',
-    'packages/@lumenflow/agent',
-    'packages/@lumenflow/metrics',
-    'packages/@lumenflow/initiatives',
-    'packages/@lumenflow/shims',
-    'packages/@lumenflow/mcp',
-    // Apps (generic placeholders)
-    'apps/web',
-    'apps/docs',
-];
-/**
- * Check if a symlink target points into a worktrees directory
- *
- * @param {string} linkTarget - The symlink target path (relative or absolute)
- * @param {string} basePath - Base path to resolve relative targets against
- * @returns {{isWorktreePath: boolean, absoluteTarget: string, isBroken: boolean}}
- */
-function checkSymlinkTarget(linkTarget, basePath) {
-    const absoluteTarget = path.isAbsolute(linkTarget)
-        ? linkTarget
-        : path.resolve(basePath, linkTarget);
-    const isWorktreePath = absoluteTarget.includes(WORKTREES_PATH_SEGMENT);
-    const isBroken = isWorktreePath && !fs.existsSync(absoluteTarget);
-    return { isWorktreePath, absoluteTarget, isBroken };
-}
-/**
- * Process a single symlink entry to check for worktree-path references
- *
- * @param {string} entryPath - Full path to the symlink
- * @param {string} basePath - Base path to resolve relative targets
- * @param {{hasWorktreeSymlinks: boolean, brokenSymlinks: string[]}} result - Result object to mutate
- */
-function processSymlinkEntry(entryPath, basePath, result) {
-    const linkTarget = fs.readlinkSync(entryPath);
-    const check = checkSymlinkTarget(linkTarget, basePath);
-    if (check.isWorktreePath) {
-        result.hasWorktreeSymlinks = true;
-        if (check.isBroken) {
-            result.brokenSymlinks.push(entryPath);
-        }
-    }
-}
-/**
- * Scan .pnpm directory for symlinks pointing into worktrees
- * Only scans top-level entries to avoid deep recursion (performance)
- *
- * @param {string} pnpmPath - Absolute path to node_modules/.pnpm directory
- * @returns {{hasWorktreeSymlinks: boolean, brokenSymlinks: string[]}}
- */
-function scanPnpmForWorktreeSymlinks(pnpmPath) {
-    const result = { hasWorktreeSymlinks: false, brokenSymlinks: [] };
-    const entries = fs.readdirSync(pnpmPath, { withFileTypes: true });
-    for (const entry of entries) {
-        if (entry.isSymbolicLink()) {
-            const entryPath = path.join(pnpmPath, entry.name);
-            processSymlinkEntry(entryPath, pnpmPath, result);
-        }
-    }
-    return result;
-}
-/**
- * Check if a node_modules directory contains symlinks pointing into worktrees
- *
- * WU-2238: When pnpm install runs inside a worktree, it can create symlinks
- * that point to the worktree's .pnpm store. When that worktree is removed,
- * these symlinks become broken and cause ERR_MODULE_NOT_FOUND.
- *
- * @param {string} nodeModulesPath - Absolute path to node_modules directory
- * @returns {{hasWorktreeSymlinks: boolean, brokenSymlinks: string[]}}
- */
-export function hasWorktreePathSymlinks(nodeModulesPath) {
-    const result = { hasWorktreeSymlinks: false, brokenSymlinks: [] };
-    if (!fs.existsSync(nodeModulesPath)) {
-        return result;
-    }
-    const entries = fs.readdirSync(nodeModulesPath, { withFileTypes: true });
-    for (const entry of entries) {
-        const entryPath = path.join(nodeModulesPath, entry.name);
-        if (entry.isSymbolicLink()) {
-            processSymlinkEntry(entryPath, nodeModulesPath, result);
-        }
-        else if (entry.name === PNPM_DIR && entry.isDirectory()) {
-            const pnpmResult = scanPnpmForWorktreeSymlinks(entryPath);
-            if (pnpmResult.hasWorktreeSymlinks) {
-                result.hasWorktreeSymlinks = true;
-                result.brokenSymlinks.push(...pnpmResult.brokenSymlinks);
-            }
-        }
-    }
-    return result;
-}
-/**
- * Check if node_modules already exists at the target path
- *
- * @param {string} targetPath - Path to check
- * @returns {boolean} True if exists (should skip)
- */
-function nodeModulesExists(targetPath) {
-    try {
-        fs.lstatSync(targetPath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Check if main repo node_modules has worktree-path symlinks
- *
- * @param {string} mainRepoPath - Path to main repo
- * @param {object} logger - Logger with warn method
- * @returns {{refused: boolean, reason?: string}}
- */
-function checkMainNodeModulesHealth(mainRepoPath, logger) {
-    const mainNodeModulesPath = path.join(mainRepoPath, NODE_MODULES_DIR);
-    const check = hasWorktreePathSymlinks(mainNodeModulesPath);
-    if (!check.hasWorktreeSymlinks) {
-        return { refused: false };
-    }
-    const reason = check.brokenSymlinks.length > 0
-        ? `Main node_modules contains broken worktree-path symlinks: ${check.brokenSymlinks.slice(0, 3).join(', ')}${check.brokenSymlinks.length > 3 ? ` (+${check.brokenSymlinks.length - 3} more)` : ''}`
-        : 'Main node_modules contains symlinks pointing into worktrees directory';
-    if (logger.warn) {
-        logger.warn(`${LOG_PREFIX.CLAIM} Refusing to symlink node_modules: ${reason}`);
-        logger.warn(`${LOG_PREFIX.CLAIM} Run 'pnpm install' in the worktree instead, or heal main with 'pnpm install --force'`);
-    }
-    return { refused: true, reason };
-}
-/**
- * Create symlink to node_modules in a newly created worktree
- *
- * This enables immediate pnpm command execution without manual symlink creation.
- * The symlink is relative for portability across different project locations.
- *
- * WU-2238: When mainRepoPath is provided, checks if the target node_modules
- * contains symlinks pointing into worktrees. If so, refuses to create the
- * symlink to prevent inheriting broken module resolution.
- *
- * @param {string} worktreePath - Absolute path to the worktree directory
- * @param {object} [logger] - Logger object with info/warn methods (defaults to console)
- * @param {string} [mainRepoPath] - Optional: Absolute path to main repo for worktree-path check
- * @returns {{created: boolean, skipped: boolean, refused?: boolean, reason?: string, error?: Error}}
- *
- * @example
- * // In wu-claim.ts after worktree creation:
- * symlinkNodeModules('/path/to/worktrees/operations-tooling-wu-1443');
- */
-export function symlinkNodeModules(worktreePath, logger = console, mainRepoPath = null) {
-    const targetPath = path.join(worktreePath, NODE_MODULES_DIR);
-    // Check if node_modules already exists (idempotent)
-    if (nodeModulesExists(targetPath)) {
-        return { created: false, skipped: true };
-    }
-    // WU-2238: Check if main repo's node_modules contains worktree-path symlinks
-    if (mainRepoPath) {
-        const healthCheck = checkMainNodeModulesHealth(mainRepoPath, logger);
-        if (healthCheck.refused) {
-            return { created: false, skipped: false, refused: true, reason: healthCheck.reason };
-        }
-    }
-    try {
-        fs.symlinkSync(RELATIVE_NODE_MODULES_PATH, targetPath);
-        if (logger.info) {
-            logger.info(`${LOG_PREFIX.CLAIM} node_modules symlink created -> ${RELATIVE_NODE_MODULES_PATH}`);
-        }
-        return { created: true, skipped: false };
-    }
-    catch (error) {
-        const normalizedError = error instanceof Error ? error : new Error(String(error));
-        if (logger.warn) {
-            logger.warn(`${LOG_PREFIX.CLAIM} Failed to create node_modules symlink: ${getErrorMessage(error)}`);
-        }
-        return { created: false, skipped: false, error: normalizedError };
-    }
-}
-/**
- * Check if a directory should be skipped for symlink creation
- *
- * @param {string} targetDir - Target directory path
- * @param {string} sourceNodeModules - Source node_modules path
- * @returns {boolean} True if should skip
- */
-function shouldSkipNestedPackage(targetDir, sourceNodeModules) {
-    if (!fs.existsSync(targetDir)) {
-        return true;
-    }
-    if (!fs.existsSync(sourceNodeModules)) {
-        return true;
-    }
-    return false;
-}
-/**
- * Handle existing node_modules in nested package
- *
- * @param {string} targetNodeModules - Target node_modules path
- * @param {string} pkgPath - Package path for logging
- * @param {object|null} logger - Logger object
- * @param {Error[]} errors - Errors array to mutate
- * @returns {'skip'|'replace'|'create'} Action to take
- */
-function handleExistingNestedNodeModules(targetNodeModules, pkgPath, logger, errors) {
-    let targetStat;
-    try {
-        targetStat = fs.lstatSync(targetNodeModules);
-    }
-    catch {
-        return 'create'; // Doesn't exist, create symlink
-    }
-    // If already a symlink, skip (idempotent)
-    if (targetStat.isSymbolicLink()) {
-        return 'skip';
-    }
-    // If not a directory, skip
-    if (!targetStat.isDirectory()) {
-        return 'skip';
-    }
-    // Check if directory has meaningful content
-    const contents = fs.readdirSync(targetNodeModules);
-    const hasMeaningfulContent = contents.some((item) => !item.startsWith('.') && item !== '.vite' && item !== '.turbo');
-    if (hasMeaningfulContent) {
-        return 'skip';
-    }
-    // Only cache files - remove and replace with symlink
-    try {
-        fs.rmSync(targetNodeModules, { recursive: true, force: true });
-        return 'replace';
-    }
-    catch (rmError) {
-        const normalizedError = rmError instanceof Error ? rmError : new Error(String(rmError));
-        errors.push(normalizedError);
-        if (logger?.warn) {
-            logger.warn(`${LOG_PREFIX.CLAIM} Failed to remove stale ${pkgPath}/node_modules: ${getErrorMessage(rmError)}`);
-        }
-        return 'skip';
-    }
-}
-/**
- * Create symlinks for nested package node_modules in a worktree
- *
- * WU-1579: pnpm monorepos have node_modules in each package containing
- * symlinks to the .pnpm store. turbo typecheck needs these to resolve
- * package imports correctly.
- *
- * @param {string} worktreePath - Absolute path to the worktree directory
- * @param {string} mainRepoPath - Absolute path to the main repository root
- * @param {object} [logger] - Logger object with info/warn methods (defaults to silent)
- * @returns {{created: number, skipped: number, errors: Error[]}}
- *
- * @example
- * // In wu-claim.ts after worktree creation:
- * symlinkNestedNodeModules(
- *   '/path/to/worktrees/operations-tooling-wu-1579',
- *   '/path/to/main-repo'
- * );
- */
-export function symlinkNestedNodeModules(worktreePath, mainRepoPath, logger = null) {
-    let created = 0;
-    let skipped = 0;
-    const errors = [];
-    for (const pkgPath of NESTED_PACKAGE_PATHS) {
-        const targetDir = path.join(worktreePath, pkgPath);
-        const targetNodeModules = path.join(targetDir, NODE_MODULES_DIR);
-        const sourceNodeModules = path.join(mainRepoPath, pkgPath, NODE_MODULES_DIR);
-        if (shouldSkipNestedPackage(targetDir, sourceNodeModules)) {
-            skipped++;
-            continue;
-        }
-        const action = handleExistingNestedNodeModules(targetNodeModules, pkgPath, logger, errors);
-        if (action === 'skip') {
-            skipped++;
-            continue;
-        }
-        try {
-            const relativePath = path.relative(targetDir, sourceNodeModules);
-            fs.symlinkSync(relativePath, targetNodeModules);
-            created++;
-            if (logger?.info) {
-                logger.info(`${LOG_PREFIX.CLAIM} ${pkgPath}/node_modules symlink created`);
-            }
-        }
-        catch (error) {
-            const normalizedError = error instanceof Error ? error : new Error(String(error));
-            errors.push(normalizedError);
-            if (logger?.warn) {
-                logger.warn(`${LOG_PREFIX.CLAIM} Failed to create ${pkgPath}/node_modules symlink: ${getErrorMessage(error)}`);
-            }
-        }
-    }
-    return { created, skipped, errors };
-}
-//# sourceMappingURL=worktree-symlink.js.map

package/dist/worktree-symlink.js.map

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

package/dist/wu-backlog-updater.d.ts

@@ -1,10 +0,0 @@
-/**
- * Move WU to Done section in backlog.md (idempotent)
- * WU-1574: Simplified to use state store + generator (no BacklogManager)
- *
- * @param {string} backlogPath - Path to backlog.md
- * @param {string} id - WU ID
- * @param {string} title - WU title (unused - state store has it)
- */
-export declare function moveWUToDoneBacklog(backlogPath: UnsafeAny, id: UnsafeAny, _title: UnsafeAny): Promise<void>;
-//# sourceMappingURL=wu-backlog-updater.d.ts.map

package/dist/wu-backlog-updater.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wu-backlog-updater.d.ts","sourceRoot":"","sources":["../src/wu-backlog-updater.ts"],"names":[],"mappings":"AAmBA;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,SAAS,EACtB,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,SAAS,iBAiBlB"}

package/dist/wu-backlog-updater.js

@@ -1,40 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Backlog.md Update Utilities
- *
- * Centralized backlog.md update functions (extracted from wu-done.ts)
- * Refactored to use BacklogManager (WU-1212) for AST-based manipulation
- *
- * Used by both main wu:done flow AND recovery mode (DRY principle)
- */
-import { writeFile } from 'node:fs/promises';
-import { LOG_PREFIX } from './wu-constants.js';
-import { WUStateStore } from './wu-state-store.js';
-// WU-1574: Use backlog generator instead of BacklogManager
-import { generateBacklog } from './backlog-generator.js';
-import { getStateStoreDirFromBacklog } from './wu-paths.js';
-/**
- * Move WU to Done section in backlog.md (idempotent)
- * WU-1574: Simplified to use state store + generator (no BacklogManager)
- *
- * @param {string} backlogPath - Path to backlog.md
- * @param {string} id - WU ID
- * @param {string} title - WU title (unused - state store has it)
- */
-export async function moveWUToDoneBacklog(backlogPath, id, _title) {
-    const PREFIX = LOG_PREFIX.DONE;
-    const stateDir = getStateStoreDirFromBacklog(backlogPath);
-    // WU-1574: State store is now the single source of truth
-    // 1. Mark complete in state store
-    // 2. Regenerate backlog.md from state
-    const store = new WUStateStore(stateDir);
-    await store.load();
-    await store.complete(id);
-    console.log(`${PREFIX} Complete event appended to state store`);
-    // Regenerate backlog.md from state store
-    const content = await generateBacklog(store);
-    await writeFile(backlogPath, content, 'utf-8');
-    console.log(`${PREFIX} Backlog.md regenerated from state store`);
-}
-//# sourceMappingURL=wu-backlog-updater.js.map

package/dist/wu-backlog-updater.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wu-backlog-updater.js","sourceRoot":"","sources":["../src/wu-backlog-updater.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,2DAA2D;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAsB,EACtB,EAAa,EACb,MAAiB;IAEjB,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC;IAC/B,MAAM,QAAQ,GAAG,2BAA2B,CAAC,WAAW,CAAC,CAAC;IAE1D,yDAAyD;IACzD,kCAAkC;IAClC,sCAAsC;IACtC,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACnB,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,yCAAyC,CAAC,CAAC;IAEhE,yCAAyC;IACzC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,0CAA0C,CAAC,CAAC;AACnE,CAAC"}

package/dist/wu-checkpoint.d.ts

@@ -1,110 +0,0 @@
-/**
- * Schema version for checkpoint files
- * Increment when checkpoint format changes
- */
-export declare const CHECKPOINT_SCHEMA_VERSION = 1;
-/**
- * @typedef {Object} Checkpoint
- * @property {number} schemaVersion - Checkpoint format version
- * @property {string} checkpointId - Unique checkpoint identifier
- * @property {string} wuId - WU ID this checkpoint is for
- * @property {string} worktreePath - Path to worktree when checkpoint was created
- * @property {string} branchName - Lane branch name
- * @property {string} worktreeHeadSha - Git HEAD SHA of worktree at checkpoint time
- * @property {string} createdAt - ISO timestamp when checkpoint was created
- * @property {boolean} gatesPassed - Whether gates passed at this checkpoint
- * @property {string} [gatesPassedAt] - ISO timestamp when gates passed
- */
-/**
- * Options for checkpoint operations
- */
-interface CheckpointBaseDirOptions {
-    /** Base directory (defaults to cwd) */
-    baseDir?: string;
-}
-/**
- * Options for creating pre-gates checkpoint
- */
-export interface CreatePreGatesCheckpointOptions extends CheckpointBaseDirOptions {
-    /** Whether gates already passed (for testing) */
-    gatesPassed?: boolean;
-}
-/**
- * Create a checkpoint before running gates
- *
- * @param {Object} params - Checkpoint parameters
- * @param {string} params.wuId - WU ID
- * @param {string} params.worktreePath - Path to worktree
- * @param {string} params.branchName - Lane branch name
- * @param {CreatePreGatesCheckpointOptions} [options]
- * @returns {Promise<Checkpoint>} Created checkpoint
- */
-export declare function createPreGatesCheckpoint(params: UnsafeAny, options?: CreatePreGatesCheckpointOptions): Promise<{
-    schemaVersion: number;
-    checkpointId: string;
-    wuId: any;
-    worktreePath: any;
-    branchName: any;
-    worktreeHeadSha: string;
-    createdAt: string;
-    gatesPassed: any;
-    gatesPassedAt: string | null;
-}>;
-/**
- * Mark a checkpoint as having passed gates
- *
- * @param {string} wuId - WU ID
- * @param {CheckpointBaseDirOptions} [options]
- * @returns {boolean} True if checkpoint was updated
- */
-export declare function markGatesPassed(wuId: UnsafeAny, options?: CheckpointBaseDirOptions): boolean;
-/**
- * Get a checkpoint for a WU
- *
- * @param {string} wuId - WU ID
- * @param {CheckpointBaseDirOptions} [options]
- * @returns {Checkpoint|null} Checkpoint or null if not found
- */
-export declare function getCheckpoint(wuId: UnsafeAny, options?: CheckpointBaseDirOptions): any;
-/**
- * Clear a checkpoint for a WU
- *
- * @param {string} wuId - WU ID
- * @param {CheckpointBaseDirOptions} [options]
- */
-export declare function clearCheckpoint(wuId: UnsafeAny, options?: CheckpointBaseDirOptions): void;
-/**
- * @typedef {Object} CanSkipResult
- * @property {boolean} canSkip - Whether gates can be skipped
- * @property {string} [reason] - Reason if canSkip is false
- * @property {Checkpoint} [checkpoint] - Checkpoint if canSkip is true
- */
-/**
- * Check if gates can be skipped based on checkpoint
- *
- * Gates can be skipped if:
- * 1. A valid checkpoint exists
- * 2. Schema version matches
- * 3. Gates already passed at checkpoint
- * 4. Worktree HEAD SHA hasn't changed
- * 5. Checkpoint isn't stale
- *
- * @param {string} wuId - WU ID
- * @param {CanSkipGatesOptions} [options]
- * @returns {CanSkipResult} Result indicating if gates can be skipped
- */
-export interface CanSkipGatesOptions extends CheckpointBaseDirOptions {
-    /** Current worktree HEAD SHA to compare */
-    currentHeadSha?: string;
-}
-export declare function canSkipGates(wuId: UnsafeAny, options?: CanSkipGatesOptions): {
-    canSkip: boolean;
-    reason: string;
-    checkpoint?: undefined;
-} | {
-    canSkip: boolean;
-    checkpoint: any;
-    reason?: undefined;
-};
-export {};
-//# sourceMappingURL=wu-checkpoint.d.ts.map

package/dist/wu-checkpoint.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wu-checkpoint.d.ts","sourceRoot":"","sources":["../src/wu-checkpoint.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAY3C;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,UAAU,wBAAwB;IAChC,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2FD;;GAEG;AACH,MAAM,WAAW,+BAAgC,SAAQ,wBAAwB;IAC/E,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,+BAAoC;;;;;;;;;;GAyB9C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,wBAA6B,WAetF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,wBAA6B,OAcpF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,wBAA6B,QAOtF;AAED;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAoB,SAAQ,wBAAwB;IACnE,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,mBAAwB;;;;;;;;EA2C9E"}