@lumenflow/core 3.1.2 → 3.2.0

package/dist/wu-helpers.js

@@ -1,268 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * WU Helpers - Shared utilities for worktree and WU validation hooks
- *
- * Used by:
- * - .husky/prepare-commit-msg
- * - .husky/pre-commit
- * - .husky/pre-push
- */
-import { execSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import path from 'node:path';
-import { parse } from 'yaml';
-import { BRANCHES, REMOTES, STDIO, REAL_GIT, PATTERNS } from './wu-constants.js';
-import { die } from './error-handler.js';
-import { isAgentBranchWithDetails } from './branch-check.js';
-/**
- * Validate WU ID format
- *
- * WU-1593: Extracted from duplicate implementations in wu-create.ts and wu-edit.ts (DRY).
- * Uses centralized PATTERNS.WU_ID regex from wu-constants.ts.
- *
- * @param {string} id - WU ID to validate (e.g., 'WU-123')
- * @throws {Error} If ID format is invalid
- *
- * @example
- * validateWUIDFormat('WU-123'); // OK
- * validateWUIDFormat('wu-123'); // throws Error
- * validateWUIDFormat('TICKET-123'); // throws Error
- */
-export function validateWUIDFormat(id) {
-    if (!PATTERNS.WU_ID.test(id)) {
-        die(`Invalid WU ID format: "${id}"\n\nExpected format: WU-<number> (e.g., WU-706)`);
-    }
-}
-/**
- * Execute a shell command and return the output
- * @param {string} cmd - Command to execute
- * @param {object} opts - Execution options
- * @returns {string} Command output
- */
-export function run(cmd, opts = {}) {
-    try {
-        return execSync(cmd, { stdio: STDIO.PIPE, encoding: 'utf-8', ...opts }).trim();
-    }
-    catch {
-        return '';
-    }
-}
-/**
- * Get the current Git branch name
- * Uses REAL_GIT to bypass shim and prevent recursion.
- * @returns {string|null} Branch name or null if not in a git repo
- */
-export function getCurrentBranch() {
-    return run(`${REAL_GIT} rev-parse --abbrev-ref HEAD`) || null;
-}
-/**
- * Get the current working directory relative to repo root
- * Uses REAL_GIT to bypass shim and prevent recursion.
- * @returns {string} Current directory path
- */
-export function getCurrentDir() {
-    const repoRoot = run(`${REAL_GIT} rev-parse --show-toplevel`);
-    const cwd = process.cwd();
-    if (!repoRoot)
-        return cwd;
-    return path.relative(repoRoot, cwd) || '.';
-}
-/**
- * Check if we're in the main worktree (not a lane worktree)
- * Uses REAL_GIT to bypass shim and prevent recursion.
- * @returns {boolean} True if in main worktree
- */
-export function isMainWorktree() {
-    const gitDir = run(`${REAL_GIT} rev-parse --git-dir`);
-    if (!gitDir)
-        return true;
-    const normalized = gitDir.replace(/\\/g, '/');
-    // Lane worktrees live under .git/worktrees/<name>
-    return !normalized.includes('/worktrees/');
-}
-/**
- * Extract WU ID from branch name
- * Expected format: lane/<lane-name>/<wu-id>
- * @param {string} branch - Branch name
- * @returns {string|null} WU ID (e.g., 'WU-401') or null
- */
-export function extractWUFromBranch(branch) {
-    if (!branch)
-        return null;
-    // Match lane/<lane>/<wu-id> format
-    const match = branch.match(/^lane\/[^/]+\/(wu-\d+)$/i);
-    if (match?.[1]) {
-        return match[1].toUpperCase();
-    }
-    return null;
-}
-/**
- * Validate branch name follows lane convention
- * Expected: lane/<lane-name>/<wu-id>
- * @param {string} branch - Branch name to validate
- * @returns {{valid: boolean, lane: string|null, wuid: string|null, error: string|null}}
- */
-export function validateBranchName(branch) {
-    if (!branch || branch === BRANCHES.MAIN) {
-        return { valid: true, lane: null, wuid: null, error: null };
-    }
-    const match = branch.match(/^lane\/([^/]+)\/(wu-\d+)$/i);
-    if (!match) {
-        return {
-            valid: false,
-            lane: null,
-            wuid: null,
-            error: `Branch '${branch}' doesn't follow lane/<lane>/<wu-id> convention`,
-        };
-    }
-    const lane = match[1] ?? null;
-    const wuid = match[2]?.toUpperCase() ?? null;
-    return {
-        valid: true,
-        lane,
-        wuid,
-        error: null,
-    };
-}
-/**
- * Read WU YAML file and return parsed content
- * Uses REAL_GIT to bypass shim and prevent recursion.
- * @param {string} wuid - WU ID (e.g., 'WU-401')
- * @returns {object|null} Parsed WU YAML or null if not found
- */
-export function readWUYaml(wuid) {
-    const repoRoot = run(`${REAL_GIT} rev-parse --show-toplevel`);
-    if (!repoRoot)
-        return null;
-    const wuPath = path.join(repoRoot, 'docs', '04-operations', 'tasks', 'wu', `${wuid}.yaml`);
-    if (!existsSync(wuPath))
-        return null;
-    try {
-        const content = readFileSync(wuPath, { encoding: 'utf-8' });
-        return parse(content);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Check if WU status allows the operation
- * @param {string} wuid - WU ID
- * @param {string[]} allowedStatuses - List of allowed statuses
- * @returns {{allowed: boolean, status: string|null, error: string|null}}
- */
-export function checkWUStatus(wuid, allowedStatuses = ['in_progress', 'waiting']) {
-    const wu = readWUYaml(wuid);
-    if (!wu) {
-        return {
-            allowed: false,
-            status: null,
-            error: `WU ${wuid} not found in docs/04-operations/tasks/wu/`,
-        };
-    }
-    const status = wu.status;
-    if (!status) {
-        return {
-            allowed: false,
-            status: null,
-            error: `WU ${wuid} has no status field`,
-        };
-    }
-    if (!allowedStatuses.includes(status)) {
-        return {
-            allowed: false,
-            status,
-            error: `WU ${wuid} status is '${status}' (expected one of: ${allowedStatuses.join(', ')})`,
-        };
-    }
-    return { allowed: true, status, error: null };
-}
-/**
- * Format an error message for hook output
- * @param {string} hookName - Name of the hook
- * @param {string} message - Error message
- * @returns {string} Formatted error message
- */
-export function formatHookError(hookName, message) {
-    return `
-╔═══════════════════════════════════════════════════════════════════╗
-║  ${hookName.toUpperCase()} HOOK ERROR
-╠═══════════════════════════════════════════════════════════════════╣
-║  ${message}
-╚═══════════════════════════════════════════════════════════════════╝
-`;
-}
-/**
- * Extract WU ID from commit message
- * Supports formats:
- * - wu(WU-401): message
- * - chore(wu-401): message
- * - feat(wu-401): message
- * @param {string} message - Commit message
- * @returns {string|null} WU ID or null
- */
-export function extractWUFromCommitMessage(message) {
-    if (!message)
-        return null;
-    // Match wu(WU-401) or type(wu-401) patterns
-    const patterns = [
-        /wu\((wu-\d+)\)/i, // wu(WU-401)
-        /\w+\((wu-\d+)\)/i, // chore(wu-401), feat(wu-401), etc.
-    ];
-    for (const pattern of patterns) {
-        const match = message.match(pattern);
-        if (match?.[1]) {
-            return match[1].toUpperCase();
-        }
-    }
-    return null;
-}
-/**
- * Ensure current branch is main. Throws if not.
- *
- * Centralized from duplicated ensureOnMain() functions across wu-* scripts (WU-1256).
- * Async version - accepts a git adapter with async getCurrentBranch() method.
- *
- * WU-1091: Agent branches (claude/*, codex/*, copilot/*, cursor/*, agent/*) bypass
- * the main branch requirement for web agent commands. Lane branches still require
- * worktree workflow (no bypass). Protected branches (main/master) remain protected.
- *
- * @param {object} git - Git adapter with async getCurrentBranch() method
- * @throws {Error} If not on main branch and not an agent branch
- */
-export async function ensureOnMain(git) {
-    const branch = await git.getCurrentBranch();
-    if (branch !== BRANCHES.MAIN) {
-        // WU-1091: Check if this is an agent branch that can bypass the main requirement
-        const agentResult = await isAgentBranchWithDetails(branch);
-        if (agentResult.isMatch) {
-            console.log(`[ensureOnMain] Bypassing for agent branch '${branch}' (${agentResult.patternResult.source})`);
-            return;
-        }
-        throw new Error(`Run from shared checkout on '${BRANCHES.MAIN}' (found '${branch}')`);
-    }
-}
-/**
- * Ensure main branch is up to date with origin.
- *
- * Centralized from duplicated ensureMainUpToDate() functions across wu-* scripts (WU-1256).
- *
- * @param {object} git - Git adapter with async fetch() and getCommitHash() methods
- * @param {string} [scriptName='wu'] - Script name for logging
- * @param {object} [options] - Options
- * @param {boolean} [options.skipRemote=false] - WU-1653: Skip remote check (requireRemote=false)
- * @throws {Error} If main is out of sync with origin
- */
-export async function ensureMainUpToDate(git, _scriptName = 'wu', { skipRemote = false } = {}) {
-    if (skipRemote)
-        return;
-    await git.fetch(REMOTES.ORIGIN, BRANCHES.MAIN);
-    const localMain = await git.getCommitHash(BRANCHES.MAIN);
-    const remoteMain = await git.getCommitHash(`${REMOTES.ORIGIN}/${BRANCHES.MAIN}`);
-    if (localMain !== remoteMain) {
-        throw new Error(`Main branch is out of sync with origin.\n\nRun: git pull ${REMOTES.ORIGIN} ${BRANCHES.MAIN}`);
-    }
-}
-//# sourceMappingURL=wu-helpers.js.map

package/dist/wu-helpers.js.map

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

package/dist/wu-id-generator.d.ts

@@ -1,51 +0,0 @@
-/** WU ID prefix constant */
-export declare const WU_ID_PREFIX = "WU-";
-/**
- * Parse the numeric part from a WU ID string.
- *
- * Supports formats:
- * - WU-123 (direct ID)
- * - WU-123.yaml (filename)
- *
- * @param wuIdOrFilename - WU ID or filename to parse
- * @returns Numeric ID or null if invalid format
- */
-export declare function parseWuIdNumber(wuIdOrFilename: string): number | null;
-/**
- * Get the highest WU ID number from the WU directory.
- *
- * Scans all WU-*.yaml files and returns the highest numeric ID found.
- * Returns 0 if directory doesn't exist or contains no valid WU files.
- *
- * @returns Highest WU ID number or 0 if none found
- */
-export declare function getHighestWuId(): number;
-/**
- * Get the next available WU ID.
- *
- * Returns the next sequential ID after the highest existing WU.
- * Does not fill gaps - always returns highest + 1.
- *
- * @returns Next WU ID in format "WU-{number}"
- */
-export declare function getNextWuId(): string;
-/** Options for generateWuIdWithRetry */
-interface GenerateOptions {
-    /** Maximum number of retry attempts (default: 5) */
-    maxRetries?: number;
-}
-/**
- * Generate a unique WU ID with retry handling for race conditions.
- *
- * This function handles concurrent wu:create calls by:
- * 1. Generating the next sequential ID
- * 2. Checking if the file already exists (race condition detection)
- * 3. Retrying with exponential backoff if conflict detected
- *
- * @param options - Generation options
- * @returns Promise resolving to unique WU ID
- * @throws Error if max retries exceeded
- */
-export declare function generateWuIdWithRetry(options?: GenerateOptions): Promise<string>;
-export {};
-//# sourceMappingURL=wu-id-generator.d.ts.map

package/dist/wu-id-generator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wu-id-generator.d.ts","sourceRoot":"","sources":["../src/wu-id-generator.ts"],"names":[],"mappings":"AAeA,4BAA4B;AAC5B,eAAO,MAAM,YAAY,QAAQ,CAAC;AAQlC;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBrE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAkBvC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED,wCAAwC;AACxC,UAAU,eAAe;IACvB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB1F"}

package/dist/wu-id-generator.js

@@ -1,110 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * WU ID Generator (WU-1246)
- *
- * Auto-generates sequential WU IDs by scanning existing WU YAML files.
- * Provides race-condition handling via retry mechanism.
- *
- * @module wu-id-generator
- */
-import { existsSync, readdirSync } from 'node:fs';
-import { WU_PATHS } from './wu-paths.js';
-/** WU ID prefix constant */
-export const WU_ID_PREFIX = 'WU-';
-/** Default maximum retry attempts for race condition handling */
-const DEFAULT_MAX_RETRIES = 5;
-/** Retry delay in milliseconds (exponential backoff base) */
-const RETRY_DELAY_BASE_MS = 50;
-/**
- * Parse the numeric part from a WU ID string.
- *
- * Supports formats:
- * - WU-123 (direct ID)
- * - WU-123.yaml (filename)
- *
- * @param wuIdOrFilename - WU ID or filename to parse
- * @returns Numeric ID or null if invalid format
- */
-export function parseWuIdNumber(wuIdOrFilename) {
-    if (!wuIdOrFilename || typeof wuIdOrFilename !== 'string') {
-        return null;
-    }
-    // Remove .yaml extension if present
-    const wuId = wuIdOrFilename.replace(/\.yaml$/, '');
-    // Match WU-{number} pattern using RegExp method per sonarjs/prefer-regexp-exec
-    const WU_ID_PATTERN = /^WU-(\d+)$/;
-    const regexResult = WU_ID_PATTERN.exec(wuId);
-    if (!regexResult) {
-        return null;
-    }
-    const idSegment = regexResult[1];
-    if (!idSegment) {
-        return null;
-    }
-    const num = parseInt(idSegment, 10);
-    return isNaN(num) ? null : num;
-}
-/**
- * Get the highest WU ID number from the WU directory.
- *
- * Scans all WU-*.yaml files and returns the highest numeric ID found.
- * Returns 0 if directory doesn't exist or contains no valid WU files.
- *
- * @returns Highest WU ID number or 0 if none found
- */
-export function getHighestWuId() {
-    const wuDir = WU_PATHS.WU_DIR();
-    if (!existsSync(wuDir)) {
-        return 0;
-    }
-    const files = readdirSync(wuDir);
-    let highest = 0;
-    for (const file of files) {
-        const num = parseWuIdNumber(file);
-        if (num !== null && num > highest) {
-            highest = num;
-        }
-    }
-    return highest;
-}
-/**
- * Get the next available WU ID.
- *
- * Returns the next sequential ID after the highest existing WU.
- * Does not fill gaps - always returns highest + 1.
- *
- * @returns Next WU ID in format "WU-{number}"
- */
-export function getNextWuId() {
-    const highest = getHighestWuId();
-    return `${WU_ID_PREFIX}${highest + 1}`;
-}
-/**
- * Generate a unique WU ID with retry handling for race conditions.
- *
- * This function handles concurrent wu:create calls by:
- * 1. Generating the next sequential ID
- * 2. Checking if the file already exists (race condition detection)
- * 3. Retrying with exponential backoff if conflict detected
- *
- * @param options - Generation options
- * @returns Promise resolving to unique WU ID
- * @throws Error if max retries exceeded
- */
-export async function generateWuIdWithRetry(options = {}) {
-    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
-    for (let attempt = 0; attempt < maxRetries; attempt++) {
-        const nextId = getNextWuId();
-        const wuPath = WU_PATHS.WU(nextId);
-        // Check if file already exists (race condition)
-        if (!existsSync(wuPath)) {
-            return nextId;
-        }
-        // Exponential backoff before retry
-        const delay = RETRY_DELAY_BASE_MS * Math.pow(2, attempt);
-        await new Promise((resolve) => setTimeout(resolve, delay));
-    }
-    throw new Error(`Failed to generate unique WU ID after ${maxRetries} attempts`);
-}
-//# sourceMappingURL=wu-id-generator.js.map

package/dist/wu-id-generator.js.map

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

package/dist/wu-lint.d.ts

@@ -1,191 +0,0 @@
-import { type ValidationPhase } from './wu-rules-engine.js';
-/**
- * Error type constants for WU spec linting
- */
-export declare const WU_LINT_ERROR_TYPES: {
-    ACCEPTANCE_PATH_NOT_IN_CODE_PATHS: string;
-    CODE_PATH_CONFLICTS_INVARIANT: string;
-    ACCEPTANCE_CONFLICTS_INVARIANT: string;
-    /** CLI registration parity surface missing */
-    REGISTRATION_PARITY_MISSING: string;
-    /** Backward-compatible key for minimum test intent */
-    UNIT_TESTS_REQUIRED: string;
-    /** Canonical minimum test intent key */
-    MINIMUM_TEST_INTENT_REQUIRED: string;
-};
-/**
- * Registration surface paths required when CLI bin changes.
- */
-export declare const REGISTRATION_SURFACES: {
-    readonly PUBLIC_MANIFEST: "packages/@lumenflow/cli/src/public-manifest.ts";
-    readonly MCP_TOOLS: "packages/@lumenflow/mcp/src/tools.ts";
-};
-/**
- * Paths historically used to indicate CLI command surface changes.
- * Kept exported for compatibility and docs/tests.
- */
-export declare const CLI_COMMAND_PATTERNS: string[];
-/**
- * Validate that acceptance criteria only reference paths in code_paths
- */
-export declare function validateAcceptanceCodePaths(wu: UnsafeAny): {
-    valid: boolean;
-    errors: {
-        type: string;
-        wuId: any;
-        path: string | undefined;
-        criterion: any;
-        message: string;
-        suggestion: string;
-    }[];
-};
-/**
- * Validate that code_paths and acceptance do not conflict with invariants
- */
-export declare function validateInvariantsCompliance(wu: UnsafeAny, invariants: UnsafeAny): {
-    valid: boolean;
-    errors: ({
-        type: string;
-        wuId: any;
-        invariantId: any;
-        path: any;
-        message: string;
-        suggestion: any;
-        criterion?: undefined;
-    } | {
-        type: string;
-        wuId: any;
-        invariantId: any;
-        path: any;
-        criterion: any;
-        message: string;
-        suggestion: any;
-    } | {
-        type: string;
-        wuId: any;
-        invariantId: any;
-        paths: any;
-        message: string;
-        suggestion: any;
-    })[];
-};
-/**
- * Backward-compatible adapter for minimum test intent.
- */
-export declare function validateUnitTestsRequirement(wu: {
-    id: string;
-    type?: string;
-    status?: string;
-    code_paths?: string[];
-    tests?: {
-        unit?: string[];
-        e2e?: string[];
-        integration?: string[];
-        manual?: string[];
-    };
-}): {
-    valid: boolean;
-    errors: Array<{
-        type: string;
-        wuId: string;
-        message: string;
-        suggestion: string;
-    }>;
-};
-/**
- * Adapter for parity surface validation.
- *
- * Parity is enforced in reality-phase preflight where git diff context is available.
- * This adapter only enforces when caller explicitly confirms `binChanged`.
- */
-export declare function validateRegistrationParity(wu: {
-    id: string;
-    code_paths?: string[];
-    status?: string;
-}, options?: {
-    binChanged?: boolean;
-}): {
-    valid: boolean;
-    errors: Array<{
-        type: string;
-        wuId: string;
-        message: string;
-        suggestion: string;
-    }>;
-    warnings?: Array<{
-        type: string;
-        wuId: string;
-        message: string;
-        suggestion: string;
-    }>;
-};
-/**
- * Options for linting WU spec
- */
-export interface LintWUSpecOptions {
-    /** Pre-loaded invariants */
-    invariants?: unknown[];
-    /** Path to invariants.yml */
-    invariantsPath?: string;
-    /** Validation phase for shared rule engine */
-    phase?: ValidationPhase;
-    /** Optional validation context */
-    context?: {
-        cwd?: string;
-        baseRef?: string;
-        headRef?: string;
-    };
-}
-/**
- * Lint a WU spec against all rules
- */
-export declare function lintWUSpec(wu: UnsafeAny, options?: LintWUSpecOptions): {
-    valid: boolean;
-    errors: ({
-        type: string;
-        wuId: any;
-        path: string | undefined;
-        criterion: any;
-        message: string;
-        suggestion: string;
-    } | {
-        type: string;
-        wuId: any;
-        invariantId: any;
-        path: any;
-        message: string;
-        suggestion: any;
-        criterion?: undefined;
-    } | {
-        type: string;
-        wuId: any;
-        invariantId: any;
-        path: any;
-        criterion: any;
-        message: string;
-        suggestion: any;
-    } | {
-        type: string;
-        wuId: any;
-        invariantId: any;
-        paths: any;
-        message: string;
-        suggestion: any;
-    } | {
-        type: string;
-        wuId: string;
-        message: string;
-        suggestion: string;
-    })[];
-    warnings: {
-        type: string;
-        wuId: string;
-        message: string;
-        suggestion: string;
-    }[];
-};
-/**
- * Format lint errors for display
- */
-export declare function formatLintErrors(errors: UnsafeAny): string;
-//# sourceMappingURL=wu-lint.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"wu-lint.d.ts","sourceRoot":"","sources":["../src/wu-lint.ts"],"names":[],"mappings":"AAiBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;IAI9B,8CAA8C;;IAE9C,sDAAsD;;IAEtD,wCAAwC;;CAEzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAA4B,CAAC;AAkDtE;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,SAAS;;;;;;;;;;EAyBxD;AAsDD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAehF;AAwCD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACxF,GAAG;IACF,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpF,CAuBA;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE;IACF,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL;IACD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvF,CAkDA;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,kCAAkC;IAClC,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,UAgBjD"}