@tyroneross/navgator 0.2.2 → 0.10.0

package/dist/cli/commands/rules.js

@@ -0,0 +1,133 @@
+import { loadAllComponents, loadAllConnections } from '../../storage.js';
+import { getConfig } from '../../config.js';
+import { AGENT_OUTPUT_LIMITS, boundAgentCollection, wrapInEnvelope } from '../../agent-output.js';
+import { checkRules, countComponentsPerRule, describeReachability, detectRuleDegeneracy, getBuiltinRules, loadCustomRules, formatRulesOutput, } from '../../rules.js';
+import { checkDataAvailability } from './helpers.js';
+import { EXIT_CODES } from '../exit-codes.js';
+/**
+ * Prevalence check over the violations just produced. A rule that fires on most
+ * of the codebase is reported as one misconfiguration, not as N findings — see
+ * `detectRuleDegeneracy`.
+ */
+export function measureRuleDegeneracy(violations, componentCount) {
+    return detectRuleDegeneracy(countComponentsPerRule(violations), componentCount);
+}
+/**
+ * Warn when reachability analysis ran with a degraded root set.
+ *
+ * Every way this can go wrong looks identical in the output — a pile of
+ * `transitively-dead` findings — so the only way to tell a real result from an
+ * analysis pointed at the wrong directory is to say which inputs were found.
+ */
+export function formatReachabilityWarnings(d) {
+    const lines = [];
+    const roots = Object.values(d.entry_points).reduce((sum, n) => sum + (n ?? 0), 0);
+    if (d.manifest_errors.length > 0) {
+        lines.push(`UNREADABLE MANIFEST: ${d.manifest_errors.join(', ')}. ` +
+            `Entry points declared there were not found, so reachability is understated.`);
+    }
+    if (d.manifests.length === 0 && d.considered > 0) {
+        lines.push(`NO PACKAGE MANIFEST FOUND. Reachability used conventions only, so any ` +
+            `entry point declared in package.json bin/main/exports/scripts was missed. ` +
+            `If this project is an npm package, check the directory being analysed.`);
+    }
+    if (roots === 0 && d.considered > 0) {
+        lines.push('NO ENTRY POINTS FOUND. Reachability could not run; no component was judged.');
+    }
+    if (d.suppressed.vendored > 0) {
+        lines.push(`${d.suppressed.vendored} component(s) skipped as vendored third-party code. ` +
+            `A first-party directory under packages/ whose name matches a dependency is ` +
+            `skipped by the same test.`);
+    }
+    return lines;
+}
+export function buildRulesAgentData(violations, rulesChecked, severity, degeneracy, reachability) {
+    const severityRank = { error: 0, warning: 1, info: 2 };
+    const selected = (severity
+        ? violations.filter(v => v.severity === severity)
+        : [...violations]).sort((a, b) => severityRank[a.severity] - severityRank[b.severity] ||
+        a.rule_id.localeCompare(b.rule_id) ||
+        (a.component ?? '').localeCompare(b.component ?? '') ||
+        a.message.localeCompare(b.message));
+    const bounded = boundAgentCollection(selected, AGENT_OUTPUT_LIMITS.commandItems);
+    return {
+        violations: bounded.items,
+        summary: {
+            total: violations.length,
+            selected: selected.length,
+            returned: bounded.truncation.returned,
+            truncated: bounded.truncation.truncated,
+            errors: violations.filter(v => v.severity === 'error').length,
+            warnings: violations.filter(v => v.severity === 'warning').length,
+            info: violations.filter(v => v.severity === 'info').length,
+        },
+        rules_checked: rulesChecked,
+        // Present on every run so a consumer can branch on it without probing.
+        // `degenerate: []` is the healthy answer, not a missing field.
+        degeneracy: degeneracy ?? null,
+        // Where the dead-code roots came from. A caller cannot tell a clean graph
+        // from a graph analysed against the wrong directory without this.
+        reachability: reachability ?? null,
+        truncation: {
+            violations: bounded.truncation,
+        },
+    };
+}
+export function registerRulesCommand(program) {
+    program
+        .command('rules')
+        .description('Check architecture rules and show violations')
+        .option('--severity <level>', 'Filter by severity: error, warning, info')
+        .option('--json', 'Output as JSON')
+        .option('--agent', 'Output wrapped in agent envelope (implies --json)')
+        .action(async (options) => {
+        try {
+            const dataWarning = checkDataAvailability();
+            if (dataWarning) {
+                console.log(dataWarning);
+                process.exitCode = EXIT_CODES.NO_DATA;
+                return;
+            }
+            const config = getConfig();
+            const components = await loadAllComponents(config);
+            const connections = await loadAllConnections(config);
+            const allRules = [...getBuiltinRules(), ...loadCustomRules()];
+            const violations = checkRules(components, connections, allRules);
+            const degeneracy = measureRuleDegeneracy(violations, components.length);
+            const reachability = describeReachability(components, connections);
+            if (options.agent) {
+                const data = buildRulesAgentData(violations, allRules.length, options.severity, degeneracy, reachability);
+                console.log(wrapInEnvelope('rules', data));
+                return;
+            }
+            if (options.json) {
+                console.log(JSON.stringify({
+                    violations: options.severity
+                        ? violations.filter(v => v.severity === options.severity)
+                        : violations,
+                    summary: {
+                        total: violations.length,
+                        errors: violations.filter(v => v.severity === 'error').length,
+                        warnings: violations.filter(v => v.severity === 'warning').length,
+                        info: violations.filter(v => v.severity === 'info').length,
+                    },
+                    degeneracy,
+                    reachability,
+                }, null, 2));
+                return;
+            }
+            console.log(formatRulesOutput(violations, options.severity));
+            for (const warning of degeneracy.warnings) {
+                console.log(`\nDEGENERATE RULE: ${warning}`);
+            }
+            for (const line of formatReachabilityWarnings(reachability)) {
+                console.log(`\n${line}`);
+            }
+        }
+        catch (error) {
+            console.error('Rules check failed:', error);
+            process.exitCode = EXIT_CODES.OPERATIONAL;
+        }
+    });
+}
+//# sourceMappingURL=rules.js.map

package/dist/cli/commands/rules.js.map

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

package/dist/cli/commands/scan.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerScanCommand(program: Command): void;
+//# sourceMappingURL=scan.d.ts.map

package/dist/cli/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8O1D"}

package/dist/cli/commands/scan.js

@@ -0,0 +1,232 @@
+import { scan } from '../../scanner.js';
+import { wrapInEnvelope } from '../../agent-output.js';
+import { EXIT_CODES } from '../exit-codes.js';
+export function registerScanCommand(program) {
+    program
+        .command('scan')
+        .description('Scan project architecture and update connection tracking')
+        .option('-q, --quick', 'Quick scan (packages only, no code analysis)')
+        .option('-c, --connections', 'Focus on connection detection')
+        .option('-p, --prompts', 'Enhanced AI prompt scanning with full content')
+        .option('--content', 'Scan Markdown documents, wikilinks, internal Markdown links, and typed frontmatter relationships')
+        .option('-v, --verbose', 'Show detailed output')
+        .option('--clear', 'Clear existing data before scanning (alias for --full)')
+        .option('--full', 'Force a full scan (clear all and rebuild)')
+        .option('--incremental', 'Force an incremental scan (walk only changed files + reverse-deps)')
+        .option('--auto', 'Auto-pick mode based on file changes and index staleness (default)')
+        .option('--ast', 'Use AST-based scanning (more accurate, slightly slower)')
+        .option('--track-branch', 'Capture git branch/commit in scan output')
+        .option('--commit', 'Auto-commit scan output to nested .navgator/.git for temporal queries (~180ms overhead)')
+        .option('--scip', 'Run SCIP indexer for compiler-accurate cross-file edges (requires tsconfig; ~500ms cold)')
+        .option('--field-usage', 'Analyze DB field usage across codebase (requires Prisma schema)')
+        .option('--typespec', 'Validate Prisma types against TypeScript interfaces')
+        .option('--no-audit', 'Skip the SQC audit pass (Run 2)')
+        .option('--audit-plan <plan>', 'Audit plan: aql | sprt | cochran (default: auto)')
+        .option('--single-stack', 'Disable multi-stack auto-discovery — scan only the project root')
+        .option('--per-entity-files', 'Write one JSON per component + per connection alongside canonical components.full.jsonl/connections.full.jsonl records (off by default; graph and compact files are derived views)')
+        .option('--json', 'Output scan results as JSON')
+        .option('--agent', 'Output wrapped in agent envelope (implies --json)')
+        .action(async (options) => {
+        try {
+            const isAgent = !!options.agent;
+            const isJson = !!options.json || isAgent;
+            // Suppress console output in agent/json mode
+            const origLog = console.log;
+            if (isJson) {
+                console.log = () => { };
+            }
+            // Resolve mode: explicit flags > --clear (legacy alias) > default 'auto'.
+            // Mutually-exclusive flags resolve in priority order full > incremental > auto.
+            let mode = 'auto';
+            if (options.full || options.clear)
+                mode = 'full';
+            else if (options.incremental)
+                mode = 'incremental';
+            else if (options.auto)
+                mode = 'auto';
+            const result = await scan(process.cwd(), {
+                quick: options.quick,
+                connections: options.connections,
+                prompts: options.prompts,
+                content: options.content === true,
+                verbose: options.verbose,
+                clearFirst: options.clear,
+                mode,
+                useAST: options.ast,
+                trackBranch: options.trackBranch,
+                fieldUsage: options.fieldUsage,
+                typeSpec: options.typespec,
+                commit: options.commit,
+                scip: options.scip,
+                // Run 2 — D4: SQC audit. Commander's `--no-audit` sets
+                // `options.audit === false`; we map that to `noAudit: true`.
+                noAudit: options.audit === false,
+                auditPlan: options.auditPlan,
+                singleStack: options.singleStack === true,
+                perEntityFiles: options.perEntityFiles === true,
+            });
+            // Restore console for output
+            if (isJson) {
+                console.log = origLog;
+            }
+            if (result.status === 'busy') {
+                const busyData = {
+                    status: result.status,
+                    retryable: result.retryable,
+                    message: result.message,
+                };
+                if (isAgent) {
+                    console.log(wrapInEnvelope('scan', busyData));
+                }
+                else if (isJson) {
+                    console.log(JSON.stringify(busyData, null, 2));
+                }
+                else {
+                    console.error(`Scan busy: ${result.message}`);
+                }
+                process.exitCode = EXIT_CODES.NO_DATA;
+                return;
+            }
+            // JSON/Agent output mode
+            if (isJson) {
+                const jsonData = {
+                    status: result.status,
+                    components_found: result.stats.components_found,
+                    connections_found: result.stats.connections_found,
+                    scan_duration_ms: result.stats.scan_duration_ms,
+                    files_scanned: result.stats.files_scanned,
+                    files_changed: result.stats.files_changed,
+                    warnings_count: result.stats.warnings_count,
+                    prompts_found: result.stats.prompts_found,
+                };
+                if (result.gitInfo) {
+                    jsonData.git = result.gitInfo;
+                }
+                if (result.timelineEntry) {
+                    jsonData.significance = result.timelineEntry.significance;
+                    jsonData.triggers = result.timelineEntry.triggers;
+                    jsonData.total_changes = result.timelineEntry.diff.stats.total_changes;
+                    if (result.timelineEntry.audit) {
+                        jsonData.audit = result.timelineEntry.audit;
+                    }
+                }
+                if (result.degraded) {
+                    jsonData.degraded = result.degraded;
+                }
+                if (result.coverage) {
+                    jsonData.coverage = result.coverage;
+                }
+                if (isAgent) {
+                    console.log(wrapInEnvelope('scan', jsonData));
+                }
+                else {
+                    console.log(JSON.stringify(jsonData, null, 2));
+                }
+                return;
+            }
+            console.log('\n========================================');
+            console.log(result.status === 'noop' ? 'SCAN NO CHANGES' : 'SCAN COMPLETE');
+            console.log('========================================\n');
+            // Degraded-scan banner: make it impossible to mistake a restricted,
+            // capability-reduced scan for a complete one while skimming. Printed
+            // only when the scan actually disabled something (result.degraded is
+            // absent for a complete scan).
+            if (result.degraded) {
+                console.log('!! DEGRADED SCAN !!');
+                console.log(result.degraded.message);
+                console.log(`Restrictions: ${result.degraded.restrictions.join(', ')}`);
+                console.log(`Disabled: ${result.degraded.disabled_capabilities.join(', ')}\n`);
+            }
+            // Coverage-gap banner: a language present in the tree that no
+            // registered scanner consumes must not read as "this repo has no
+            // components there" — that is indistinguishable from a genuinely
+            // clean result otherwise. Printed only when `result.coverage` is
+            // present, which the scanner guarantees only for `status !== 'full'`.
+            if (result.coverage) {
+                console.log('!! COVERAGE GAP !!');
+                const shown = result.coverage.blind_spots.slice(0, 3);
+                for (const line of shown) {
+                    console.log(line);
+                }
+                const remaining = result.coverage.blind_spots.length - shown.length;
+                if (remaining > 0) {
+                    console.log(`  ... and ${remaining} more (see --json coverage)`);
+                }
+                console.log('');
+            }
+            // Group components by type
+            const byType = {};
+            for (const c of result.components) {
+                byType[c.type] = (byType[c.type] || 0) + 1;
+            }
+            console.log('COMPONENTS:');
+            for (const [type, count] of Object.entries(byType)) {
+                console.log(`  ${type}: ${count}`);
+            }
+            // Group connections by type
+            const connByType = {};
+            for (const c of result.connections) {
+                connByType[c.connection_type] = (connByType[c.connection_type] || 0) + 1;
+            }
+            if (Object.keys(connByType).length > 0) {
+                console.log('\nCONNECTIONS:');
+                for (const [type, count] of Object.entries(connByType)) {
+                    console.log(`  ${type}: ${count}`);
+                }
+            }
+            if (result.warnings.length > 0) {
+                console.log(`\nWARNINGS: ${result.warnings.length}`);
+                for (const w of result.warnings.slice(0, 5)) {
+                    console.log(`  - ${w.message}`);
+                }
+                if (result.warnings.length > 5) {
+                    console.log(`  ... and ${result.warnings.length - 5} more`);
+                }
+            }
+            // Show file change summary
+            if (result.fileChanges) {
+                const { added, modified, removed } = result.fileChanges;
+                if (added.length > 0 || modified.length > 0 || removed.length > 0) {
+                    console.log('\nFILE CHANGES:');
+                    if (added.length > 0)
+                        console.log(`  Added: ${added.length}`);
+                    if (modified.length > 0)
+                        console.log(`  Modified: ${modified.length}`);
+                    if (removed.length > 0)
+                        console.log(`  Removed: ${removed.length}`);
+                }
+            }
+            // Show prompt scan results if enhanced scanning was used
+            if (result.promptScan && result.promptScan.prompts.length > 0) {
+                console.log('\nAI PROMPTS:');
+                console.log(`  Total: ${result.promptScan.summary.totalPrompts}`);
+                console.log(`  Templates: ${result.promptScan.summary.templatesCount}`);
+                if (Object.keys(result.promptScan.summary.byProvider).length > 0) {
+                    console.log('  By provider:');
+                    for (const [provider, count] of Object.entries(result.promptScan.summary.byProvider)) {
+                        console.log(`    ${provider}: ${count}`);
+                    }
+                }
+            }
+            console.log(`\nFiles scanned: ${result.stats.files_scanned}`);
+            console.log(`Scan completed in ${result.stats.scan_duration_ms}ms`);
+            // Show branch info if tracking
+            if (result.gitInfo) {
+                console.log(`Branch: ${result.gitInfo.branch} @ ${result.gitInfo.commit}`);
+            }
+            // Project registration is now handled inside the scanner (Phase 5)
+            // Show timeline entry summary if available
+            if (result.timelineEntry && result.timelineEntry.diff.stats.total_changes > 0) {
+                console.log(`\nArchitecture diff: ${result.timelineEntry.significance.toUpperCase()} — ${result.timelineEntry.diff.stats.total_changes} change(s)`);
+                if (result.timelineEntry.triggers.length > 0) {
+                    console.log(`  Triggers: ${result.timelineEntry.triggers.join(', ')}`);
+                }
+            }
+        }
+        catch (error) {
+            console.error('Scan failed:', error);
+            process.exitCode = EXIT_CODES.OPERATIONAL;
+        }
+    });
+}
+//# sourceMappingURL=scan.js.map

package/dist/cli/commands/scan.js.map

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

package/dist/cli/commands/schema.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerSchemaCommand(program: Command): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/cli/commands/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkI5D"}

package/dist/cli/commands/schema.js

@@ -0,0 +1,129 @@
+import { loadAllComponents, loadAllConnections } from '../../storage.js';
+import { getConfig } from '../../config.js';
+import { wrapInEnvelope } from '../../agent-output.js';
+import { resolveComponent, findCandidates } from '../../resolve.js';
+import { checkDataAvailability } from './helpers.js';
+import { EXIT_CODES } from '../exit-codes.js';
+export function registerSchemaCommand(program) {
+    program
+        .command('schema [model]')
+        .description('Show which files read from and write to a database model')
+        .option('--reads', 'Show only files that read')
+        .option('--writes', 'Show only files that write')
+        .option('--json', 'Output as JSON')
+        .option('--agent', 'Output wrapped in agent envelope (implies --json)')
+        .action(async (modelName, options) => {
+        try {
+            const dataWarning = checkDataAvailability();
+            if (dataWarning) {
+                console.log(dataWarning);
+                process.exitCode = EXIT_CODES.NO_DATA;
+                return;
+            }
+            const config = getConfig();
+            const components = await loadAllComponents(config);
+            const connections = await loadAllConnections(config);
+            // If no model specified, show overview of all database models
+            if (!modelName) {
+                const dbComps = components.filter(c => c.type === 'database');
+                const dbConns = connections.filter(c => c.connection_type === 'api-calls-db');
+                if (options.agent) {
+                    console.log(wrapInEnvelope('schema', { models: dbComps, connections: dbConns }));
+                    return;
+                }
+                console.log(`NavGator - Schema Overview (${dbComps.length} models)\n`);
+                for (const model of dbComps.sort((a, b) => {
+                    const aConns = dbConns.filter(c => c.to.component_id === a.component_id).length;
+                    const bConns = dbConns.filter(c => c.to.component_id === b.component_id).length;
+                    return bConns - aConns;
+                }).slice(0, 20)) {
+                    const modelConns = dbConns.filter(c => c.to.component_id === model.component_id);
+                    const readers = modelConns.filter(c => {
+                        const d = c.description || '';
+                        return (d.includes('[reads') || d.includes('reads]')) && !d.includes('writes');
+                    });
+                    const writers = modelConns.filter(c => {
+                        const d = c.description || '';
+                        return (d.includes('[writes') || d.includes('writes,')) && !d.includes('reads');
+                    });
+                    const both = modelConns.filter(c => {
+                        const d = c.description || '';
+                        return d.includes('reads') && d.includes('writes');
+                    });
+                    console.log(`  ${model.name}: ${modelConns.length} connections (${readers.length} read, ${writers.length} write, ${both.length} read+write)`);
+                }
+                return;
+            }
+            // Find the specific model
+            const component = resolveComponent(modelName, components);
+            if (!component || component.type !== 'database') {
+                if (!component) {
+                    console.log(`Model "${modelName}" not found.`);
+                    const candidates = findCandidates(modelName, components, 5)
+                        .filter(c => components.find(comp => comp.name === c && comp.type === 'database'));
+                    if (candidates.length > 0) {
+                        console.log('\nDid you mean:');
+                        for (const name of candidates)
+                            console.log(`  - ${name}`);
+                    }
+                }
+                else {
+                    console.log(`"${modelName}" is a ${component.type}, not a database model.`);
+                }
+                process.exitCode = EXIT_CODES.NOT_FOUND;
+                return;
+            }
+            const modelConns = connections.filter(c => c.to.component_id === component.component_id && c.connection_type === 'api-calls-db');
+            // Separate reads and writes
+            const readers = [];
+            const writers = [];
+            const readWriters = [];
+            for (const conn of modelConns) {
+                const desc = conn.description || '';
+                const hasReads = desc.includes('[reads') || desc.includes('reads]');
+                const hasWrites = desc.includes('[writes') || desc.includes('writes]') || desc.includes('writes,');
+                if (hasReads && hasWrites)
+                    readWriters.push(conn);
+                else if (hasWrites)
+                    writers.push(conn);
+                else if (hasReads)
+                    readers.push(conn);
+                else
+                    readers.push(conn); // default to read
+            }
+            if (options.agent) {
+                console.log(wrapInEnvelope('schema', { model: component, readers, writers, readWriters }));
+                return;
+            }
+            if (options.json) {
+                console.log(JSON.stringify({ model: component.name, readers: readers.length, writers: writers.length, readWriters: readWriters.length, connections: modelConns }, null, 2));
+                return;
+            }
+            console.log(`NavGator - Schema: ${component.name}\n`);
+            console.log(`${modelConns.length} files access this model`);
+            if (!options.writes && (readers.length > 0 || readWriters.length > 0)) {
+                console.log(`\nREADERS (${readers.length + readWriters.length}):`);
+                for (const conn of [...readers, ...readWriters].slice(0, 20)) {
+                    const badge = conn.description?.includes('[reads+writes]') ? ' [also writes]' : '';
+                    const cls = conn.semantic?.classification;
+                    const clsBadge = cls && cls !== 'production' ? ` [${cls}]` : '';
+                    console.log(`  ${conn.code_reference.file}:${conn.code_reference.line_start || ''}${badge}${clsBadge}`);
+                }
+            }
+            if (!options.reads && (writers.length > 0 || readWriters.length > 0)) {
+                console.log(`\nWRITERS (${writers.length + readWriters.length}):`);
+                for (const conn of [...writers, ...readWriters].slice(0, 20)) {
+                    const badge = conn.description?.includes('[reads+writes]') ? ' [also reads]' : '';
+                    const cls = conn.semantic?.classification;
+                    const clsBadge = cls && cls !== 'production' ? ` [${cls}]` : '';
+                    console.log(`  ${conn.code_reference.file}:${conn.code_reference.line_start || ''}${badge}${clsBadge}`);
+                }
+            }
+        }
+        catch (error) {
+            console.error('Schema query failed:', error);
+            process.exitCode = EXIT_CODES.OPERATIONAL;
+        }
+    });
+}
+//# sourceMappingURL=schema.js.map

package/dist/cli/commands/schema.js.map

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

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2V5D"}