@lumenflow/core 3.2.0 → 3.2.1

package/dist/wu-cli-constants.js

@@ -0,0 +1,432 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * CLI and Tooling Constants
+ *
+ * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
+ * Contains CLI flags, package manager commands, ESLint configuration, gate names,
+ * process constants, and external tool configurations.
+ *
+ * @module wu-cli-constants
+ */
+/**
+ * CLI argument flags
+ *
+ * Centralized command-line argument strings to eliminate hardcoded flags.
+ * Used across wu-* scripts, gates, and validation tools.
+ */
+export const CLI_FLAGS = {
+    // Common flags
+    DRY_RUN: '--dry-run',
+    EXECUTE: '--execute',
+    HELP: '--help',
+    HELP_SHORT: '-h',
+    VERBOSE: '--verbose',
+    FIX: '--fix',
+    JSON: '--json',
+    FORCE: '--force',
+    // Gate-specific flags
+    DOCS_ONLY: '--docs-only',
+    FULL_LINT: '--full-lint',
+    FULL_TESTS: '--full-tests', // WU-1920: Force full test suite
+    FULL_COVERAGE: '--full-coverage', // WU-2244: Force full coverage (deterministic)
+    COVERAGE_MODE: '--coverage-mode=',
+    // WU-specific flags
+    WU: '--wu',
+    ID: '--id',
+    ALL: '--all',
+    CHECK: '--check',
+    TIER: '--tier',
+    AGENT_TYPE: '--agent-type',
+    DESCRIPTION: '--description',
+    ACCEPTANCE: '--acceptance',
+    VALIDATE: '--validate',
+    REASON: '--reason',
+    WEEK: '--week',
+    SINCE: '--since',
+};
+/**
+ * pnpm/npm command flags
+ *
+ * Centralized package manager flag strings.
+ */
+export const PKG_FLAGS = {
+    FILTER: '--filter',
+    FROZEN_LOCKFILE: '--frozen-lockfile',
+    /** WU-1527: Required for pnpm add at workspace root in monorepos */
+    WORKSPACE_ROOT: '-w',
+    SAVE_DEV: '--save-dev',
+    SAVE_EXACT: '--save-exact',
+};
+/**
+ * ESLint command flags
+ *
+ * Centralized ESLint CLI flag strings.
+ */
+export const ESLINT_FLAGS = {
+    MAX_WARNINGS: '--max-warnings',
+    NO_WARN_IGNORED: '--no-warn-ignored',
+    CACHE: '--cache',
+    CACHE_STRATEGY: '--cache-strategy',
+    CACHE_LOCATION: '--cache-location',
+    PASS_ON_UNPRUNED: '--pass-on-unpruned-suppressions',
+};
+/**
+ * pnpm script names
+ *
+ * Centralized script names for package.json commands.
+ */
+export const SCRIPTS = {
+    LINT: 'lint',
+    TEST: 'test',
+    TEST_UNIT: 'test:unit',
+    BUILD: 'build',
+    FORMAT: 'format',
+    FORMAT_CHECK: 'format:check',
+    TYPECHECK: 'typecheck',
+    DEV: 'dev',
+    SPEC_LINTER: 'spec:linter',
+    /** WU-1467: Stub script -- not an enforced gate. Retained for script surface only. */
+    PROMPTS_LINT: 'prompts:lint',
+    RUN: 'run',
+    GATES: 'gates',
+    /** WU-1467: Stub script -- not an enforced gate. Retained for script surface only. */
+    COS_GATES: 'cos:gates',
+    PRETTIER: 'prettier',
+    /** WU-1467: Root script surface for tasks:validate (delegates to wu:validate --all) */
+    TASKS_VALIDATE: 'tasks:validate',
+};
+/**
+ * Gate names for quality gates
+ *
+ * Centralized gate identifiers for gates.ts and telemetry.
+ */
+export const GATE_NAMES = {
+    /** WU-2252: Invariants check (runs first, non-bypassable) */
+    INVARIANTS: 'invariants',
+    FORMAT_CHECK: 'format:check',
+    SPEC_LINTER: 'spec:linter',
+    /** WU-1467: PROMPTS_LINT removed -- was a stub (exit 0), not an authoritative gate */
+    BACKLOG_SYNC: 'backlog-sync',
+    /** WU-2009: Spec-to-code absolute claim drift detector */
+    CLAIM_VALIDATION: 'claim-validation',
+    SUPABASE_DOCS_LINTER: 'supabase-docs:linter',
+    LINT: 'lint',
+    TYPECHECK: 'typecheck',
+    TEST: 'test',
+    COVERAGE: 'coverage',
+    /** WU-2062: Safety-critical tests (always run) */
+    SAFETY_CRITICAL_TEST: 'safety-critical-test',
+    /** WU-2062: Integration tests (for high-risk changes) */
+    INTEGRATION_TEST: 'integration-test',
+    /** WU-1191: Lane health check (overlap detection) */
+    LANE_HEALTH: 'lane-health',
+    /** WU-1315: Onboarding smoke test (init + wu:create validation) */
+    ONBOARDING_SMOKE_TEST: 'onboarding-smoke-test',
+};
+/**
+ * Gate command sentinels (special values for non-shell commands)
+ *
+ * These are not shell commands but trigger special handling in gates.ts.
+ */
+export const GATE_COMMANDS = {
+    /** WU-2252: Triggers invariants check */
+    INVARIANTS: 'invariants',
+    /** Triggers incremental lint (only changed files) */
+    INCREMENTAL: 'incremental',
+    /** Triggers incremental tests (only tests related to changed files) - WU-1920 */
+    INCREMENTAL_TEST: 'incremental-test',
+    /** Triggers coverage gate check */
+    COVERAGE_GATE: 'coverage-gate',
+    /** WU-2062: Triggers safety-critical tests (always run) */
+    SAFETY_CRITICAL_TEST: 'safety-critical-test',
+    /** WU-2062: Triggers tiered test execution based on risk */
+    TIERED_TEST: 'tiered-test',
+    /** WU-1315: Triggers onboarding smoke test */
+    ONBOARDING_SMOKE_TEST: 'onboarding-smoke-test',
+};
+/**
+ * CLI mode flags
+ *
+ * Command-line mode arguments.
+ */
+export const CLI_MODES = {
+    LOCAL: '--mode=local',
+};
+/**
+ * Prettier command flags
+ *
+ * Centralized prettier CLI flag strings.
+ */
+export const PRETTIER_FLAGS = {
+    WRITE: '--write',
+};
+/**
+ * Package manager commands
+ *
+ * Centralized pnpm command strings.
+ */
+export const PKG_MANAGER = 'pnpm';
+/**
+ * Package manager subcommands
+ *
+ * Centralized pnpm subcommand strings.
+ */
+export const PKG_COMMANDS = {
+    INSTALL: 'install',
+    /** WU-1527: Used by lumenflow-upgrade and deps-add */
+    ADD: 'add',
+    REMOVE: 'remove',
+};
+/**
+ * Package names (monorepo workspaces)
+ *
+ * Centralized package names for --filter usage.
+ * WU-1068: Changed from @exampleapp to @lumenflow for framework reusability.
+ * Project-specific packages should be configured in workspace.yaml.
+ */
+export const PACKAGES = {
+    WEB: 'web',
+    APPLICATION: '@lumenflow/core',
+    DOMAIN: '@lumenflow/core',
+    INFRASTRUCTURE: '@lumenflow/cli',
+};
+/**
+ * Process stdio constants
+ *
+ * Standard values for child_process execSync stdio option.
+ */
+export const STDIO = {
+    /** Pipe stdout/stderr (capture output) */
+    PIPE: 'pipe',
+    /** Inherit stdio from parent process */
+    INHERIT: 'inherit',
+    /** Ignore stdio (silent execution) */
+    IGNORE: 'ignore',
+};
+/**
+ * Process stdio modes
+ *
+ * Centralized stdio configuration values for child_process operations.
+ */
+export const STDIO_MODES = {
+    /** Inherit stdio from parent process (shows output in console) */
+    INHERIT: 'inherit',
+    /** Pipe stdio to parent process (capture output) */
+    PIPE: 'pipe',
+    /** Ignore stdio (discard output) */
+    IGNORE: 'ignore',
+};
+/**
+ * Process exit codes
+ *
+ * Standard exit code values for CLI scripts.
+ */
+export const EXIT_CODES = {
+    /** Success exit code */
+    SUCCESS: 0,
+    /** Generic error exit code */
+    ERROR: 1,
+    /** Fatal or distinct failure exit code */
+    FAILURE: 2,
+};
+/**
+ * Stream error codes
+ *
+ * WU-1233: Error codes for stream operations (stdout/stderr).
+ * Used by StreamErrorHandler for graceful pipe closure handling.
+ */
+export const STREAM_ERRORS = {
+    /**
+     * EPIPE error code
+     *
+     * Occurs when writing to a pipe whose read end has been closed.
+     * This is normal behavior when CLI output is piped through head/tail.
+     * Unix convention: exit with code 0 on EPIPE (consumer got what it needed).
+     */
+    EPIPE: 'EPIPE',
+};
+/**
+ * ESLint command names
+ *
+ * Centralized ESLint command strings.
+ */
+export const ESLINT_COMMANDS = {
+    /** ESLint CLI command */
+    ESLINT: 'eslint',
+};
+/**
+ * ESLint default values
+ *
+ * Default configuration values for ESLint operations.
+ */
+export const ESLINT_DEFAULTS = {
+    /**
+     * Maximum allowed warnings
+     *
+     * WU-1866: Temporarily increased from 0 to 100 to unblock gates.
+     * There are ~82 pre-existing warnings that need proper fixes.
+     */
+    MAX_WARNINGS: '100',
+};
+/**
+ * ESLint cache strategy values
+ */
+export const CACHE_STRATEGIES = {
+    CONTENT: 'content',
+    METADATA: 'metadata',
+};
+/**
+ * Prettier command arguments
+ *
+ * Centralized prettier CLI arguments.
+ */
+export const PRETTIER_ARGS = {
+    /** Check formatting without writing */
+    CHECK: '--check',
+    /** List files with formatting differences */
+    LIST_DIFFERENT: '--list-different',
+};
+/**
+ * Audit command arguments
+ *
+ * Centralized pnpm audit CLI arguments.
+ */
+export const AUDIT_ARGS = {
+    /** Audit subcommand */
+    AUDIT: 'audit',
+    /** Audit level flag */
+    AUDIT_LEVEL_MODERATE: '--audit-level=moderate',
+    /** Ignore registry errors */
+    IGNORE_REGISTRY_ERRORS: '--ignore-registry-errors',
+    /** Auto-fix flag */
+    FIX: '--fix',
+};
+/**
+ * Common shell commands
+ *
+ * Centralized command names for child_process operations.
+ */
+export const SHELL_COMMANDS = {
+    /** Which command (check if executable exists) */
+    WHICH: 'which',
+    /** Cat command (concatenate files) */
+    CAT: 'cat',
+    /** Node.js executable */
+    NODE: 'node',
+};
+/**
+ * External tool commands
+ *
+ * Centralized tool command names.
+ */
+export const TOOLS = {
+    /** Gitleaks secret scanner */
+    GITLEAKS: 'gitleaks',
+    /** ESLint linter */
+    ESLINT: 'eslint',
+    /** Prettier formatter */
+    PRETTIER: 'prettier',
+    /** TypeScript compiler */
+    TSC: 'tsc',
+};
+/**
+ * Gitleaks command arguments
+ *
+ * Centralized gitleaks CLI arguments.
+ */
+export const GITLEAKS_ARGS = {
+    /** Protect mode (scan staged files) */
+    PROTECT: 'protect',
+    /** Staged flag */
+    STAGED: '--staged',
+    /** Verbose output */
+    VERBOSE: '--verbose',
+};
+/**
+ * Known package names for vulnerability tracking
+ *
+ * Package identifiers used in dependency auditing.
+ */
+export const KNOWN_PACKAGES = {
+    /** node-forge crypto library */
+    NODE_FORGE: 'node-forge',
+    /** Next.js framework */
+    NEXT: 'next',
+    /** jsPDF PDF generation library */
+    JSPDF: 'jspdf',
+};
+/**
+ * Error codes and messages
+ *
+ * Centralized error identifiers for consistency.
+ */
+export const ERROR_CODES = {
+    /** Socket timeout error */
+    ERR_SOCKET_TIMEOUT: 'ERR_SOCKET_TIMEOUT',
+    /** Timeout error code */
+    ETIMEDOUT: 'ETIMEDOUT',
+};
+/**
+ * Micro-worktree operation identifiers
+ *
+ * WU-923: Centralized operation names for withMicroWorktree()
+ */
+export const MICRO_WORKTREE_OPERATIONS = {
+    WU_CREATE: 'wu-create',
+    WU_EDIT: 'wu-edit',
+    WU_DELETE: 'wu-delete', // WU-1809: Safe WU deletion
+    WU_DONE: 'wu-done',
+    WU_BLOCK: 'wu-block',
+    WU_UNBLOCK: 'wu-unblock',
+    WU_CLAIM: 'wu-claim',
+    ORPHAN_REPAIR: 'orphan-repair', // WU-1437: Pre-claim orphan WU repair
+    INITIATIVE_EDIT: 'initiative-edit', // WU-1451: Initiative edit operation
+    INITIATIVE_BULK_ASSIGN: 'initiative-bulk-assign', // WU-2553: Bulk WU assignment
+    LANE_EDIT: 'lane-edit', // WU-1854: Safe in-place lane definition editing
+};
+/**
+ * Telemetry step identifiers
+ *
+ * WU-1584: Centralized telemetry step names to eliminate string literals.
+ */
+export const TELEMETRY_STEPS = {
+    GATES: 'gates',
+    /** WU-1467: COS_GATES removed -- was a stub (exit 0), not an authoritative step */
+    PARALLEL_DETECTION: 'parallel_detection',
+    PARALLEL_AUTO_REBASE: 'parallel_auto_rebase',
+};
+/**
+ * WU-1747: Skip gates reason constants
+ */
+export const SKIP_GATES_REASONS = {
+    CHECKPOINT_VALID: 'checkpoint_valid',
+};
+/**
+ * WU-1747: Checkpoint-related log messages
+ */
+export const CHECKPOINT_MESSAGES = {
+    SKIPPING_GATES_VALID: 'Skipping gates - valid checkpoint found',
+    CHECKPOINT_LABEL: 'Checkpoint',
+    GATES_PASSED_AT: 'Gates passed at',
+    COULD_NOT_CREATE: 'Could not create WU-1747 checkpoint',
+};
+/**
+ * Process detection constants for background process warning (WU-1381)
+ *
+ * Used by process-detector.ts to identify processes that may interfere
+ * with wu:done gates execution.
+ */
+export const PROCESS_DETECTION = {
+    /**
+     * Process names that commonly interfere with gates execution.
+     * These processes may:
+     * - Write to stdout/stderr (causing mixed output)
+     * - Hold file locks that may cause test failures
+     * - Consume resources that affect gate performance
+     */
+    INTERFERING_NAMES: ['node', 'pnpm', 'npm', 'vitest', 'tsx', 'eslint', 'prettier', 'tsc', 'turbo'],
+    /** Maximum characters to display for command in warnings */
+    CMD_DISPLAY_LIMIT: 60,
+};
+//# sourceMappingURL=wu-cli-constants.js.map

package/dist/wu-cli-constants.js.map

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

package/dist/wu-consistency-checker.d.ts

@@ -0,0 +1,23 @@
+/**
+ * WU Consistency Checker — Barrel Re-export (WU-2015)
+ *
+ * WU-2015: This file was decomposed from a 1255-line monolith into
+ * three single-responsibility modules. It now serves as a backward-compatible
+ * barrel re-exporting all public API from their domain modules.
+ *
+ * Domain modules:
+ * - wu-consistency-detector.ts: Error detection logic (checkWUConsistency, checkAllWUConsistency, checkLaneForOrphanDoneWU)
+ * - wu-inconsistency-repairer.ts: Repair orchestration (repairWUInconsistency)
+ * - wu-consistency-file-repairs.ts: File-level stamp/YAML/markdown repairs
+ *
+ * @see {@link ./wu-consistency-detector.ts} Detection logic
+ * @see {@link ./wu-inconsistency-repairer.ts} Repair orchestration
+ * @see {@link ./wu-consistency-file-repairs.ts} File-level repairs
+ * @see {@link ../wu-repair.ts} CLI interface
+ */
+export { checkWUConsistency, checkAllWUConsistency, checkLaneForOrphanDoneWU, } from './wu-consistency-detector.js';
+export type { CheckWUConsistencyOptions, ConsistencyError } from './wu-consistency-detector.js';
+export { repairWUInconsistency, FILE_REPAIR_STRATEGIES, GIT_REPAIR_STRATEGIES, } from './wu-inconsistency-repairer.js';
+export type { RepairWUInconsistencyOptions, FileRepairStrategy, GitRepairStrategy, } from './wu-inconsistency-repairer.js';
+export type { RepairResult } from './wu-consistency-file-repairs.js';
+//# sourceMappingURL=wu-consistency-checker.d.ts.map

package/dist/wu-consistency-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-consistency-checker.d.ts","sourceRoot":"","sources":["../src/wu-consistency-checker.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/wu-consistency-checker.js

@@ -0,0 +1,24 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU Consistency Checker — Barrel Re-export (WU-2015)
+ *
+ * WU-2015: This file was decomposed from a 1255-line monolith into
+ * three single-responsibility modules. It now serves as a backward-compatible
+ * barrel re-exporting all public API from their domain modules.
+ *
+ * Domain modules:
+ * - wu-consistency-detector.ts: Error detection logic (checkWUConsistency, checkAllWUConsistency, checkLaneForOrphanDoneWU)
+ * - wu-inconsistency-repairer.ts: Repair orchestration (repairWUInconsistency)
+ * - wu-consistency-file-repairs.ts: File-level stamp/YAML/markdown repairs
+ *
+ * @see {@link ./wu-consistency-detector.ts} Detection logic
+ * @see {@link ./wu-inconsistency-repairer.ts} Repair orchestration
+ * @see {@link ./wu-consistency-file-repairs.ts} File-level repairs
+ * @see {@link ../wu-repair.ts} CLI interface
+ */
+// Detection logic
+export { checkWUConsistency, checkAllWUConsistency, checkLaneForOrphanDoneWU, } from './wu-consistency-detector.js';
+// Repair orchestration
+export { repairWUInconsistency, FILE_REPAIR_STRATEGIES, GIT_REPAIR_STRATEGIES, } from './wu-inconsistency-repairer.js';
+//# sourceMappingURL=wu-consistency-checker.js.map

package/dist/wu-consistency-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-consistency-checker.js","sourceRoot":"","sources":["../src/wu-consistency-checker.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AAEH,kBAAkB;AAClB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AAItC,uBAAuB;AACvB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC"}

package/dist/wu-consistency-detector.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Options for checking a single WU's consistency
+ */
+export interface CheckWUConsistencyOptions {
+    trackedStampIds?: Set<string> | null;
+    activeWorktreeIds?: Set<string> | null;
+}
+/**
+ * Error object structure from checkWUConsistency()
+ */
+export interface ConsistencyError {
+    type: string;
+    wuId: string;
+    title?: string;
+    lane?: string;
+    description?: string;
+    repairAction?: string;
+    canAutoRepair: boolean;
+}
+/**
+ * Check a single WU for state inconsistencies
+ *
+ * @param {string} id - WU ID (e.g., 'WU-123')
+ * @param {string} [projectRoot=process.cwd()] - Project root directory
+ * @param {CheckWUConsistencyOptions} [options] - Optional precomputed context
+ * @returns {Promise<object>} Consistency report with valid, errors, and stats
+ */
+export declare function checkWUConsistency(id: string, projectRoot?: string, options?: CheckWUConsistencyOptions): Promise<{
+    valid: boolean;
+    errors: never[];
+    stats: {
+        wuExists: boolean;
+        yamlStatus?: undefined;
+        hasStamp?: undefined;
+        backlogInDone?: undefined;
+        backlogInProgress?: undefined;
+        statusInProgress?: undefined;
+        hasWorktree?: undefined;
+        worktreePathExists?: undefined;
+    };
+} | {
+    valid: boolean;
+    errors: ConsistencyError[];
+    stats: {
+        yamlStatus: string;
+        hasStamp: boolean;
+        backlogInDone: boolean;
+        backlogInProgress: boolean;
+        statusInProgress: boolean;
+        hasWorktree: boolean;
+        worktreePathExists: boolean;
+        wuExists?: undefined;
+    };
+}>;
+/**
+ * Check all WUs for consistency
+ *
+ * @param {string} [projectRoot=process.cwd()] - Project root directory
+ * @returns {Promise<object>} Aggregated report with valid, errors, and checked count
+ */
+export declare function checkAllWUConsistency(projectRoot?: string): Promise<{
+    valid: boolean;
+    errors: ConsistencyError[];
+    checked: number;
+}>;
+/**
+ * Check lane for orphan done WUs (pre-flight for wu:claim)
+ *
+ * @param {string} lane - Lane name to check
+ * @param {string} excludeId - WU ID to exclude from check (the one being claimed)
+ * @param {string} [projectRoot=process.cwd()] - Project root directory
+ * @returns {Promise<object>} Result with valid, orphans list, and reports
+ */
+export declare function checkLaneForOrphanDoneWU(lane: string, excludeId: string, projectRoot?: string): Promise<{
+    valid: boolean;
+    orphans: never[];
+    reports?: undefined;
+} | {
+    valid: boolean;
+    orphans: string[];
+    reports: {
+        id: string;
+        errors: ConsistencyError[];
+    }[];
+}>;
+/**
+ * Precompute active WU IDs from git worktree list.
+ *
+ * Returns:
+ * - Set of normalized WU IDs (e.g. WU-1234) when query succeeds
+ * - null when git worktree listing is unavailable (caller should fall back)
+ */
+export declare function listActiveWorktreeIds(projectRoot: string): Promise<Set<string> | null>;
+//# sourceMappingURL=wu-consistency-detector.d.ts.map

package/dist/wu-consistency-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-consistency-detector.d.ts","sourceRoot":"","sources":["../src/wu-consistency-detector.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACrC,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AA8BD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,MAAM,EACV,WAAW,SAAgB,EAC3B,OAAO,GAAE,yBAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;GA+JxC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,SAAgB;;;;GA+BtE;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,SAAgB;;;;;;;;YAcA,MAAM;gBAAU,gBAAgB,EAAE;;GAqC9D;AAoGD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAa5F"}