@tyroneross/navgator 0.1.0

package/dist/setup.js

@@ -0,0 +1,261 @@
+/**
+ * NavGator Setup & Initial Scan
+ *
+ * Provides a two-phase scanning approach:
+ * 1. Fast scan: Quick package detection, basic file structure (instant feedback)
+ * 2. Deep scan: Full AST analysis, connection detection, prompt scanning
+ *
+ * The fast scan uses lightweight regex patterns and file system analysis.
+ * The deep scan uses ts-morph AST analysis for accurate detection.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { scan, quickScan } from './scanner.js';
+import { getConfig } from './config.js';
+import { generateMermaidDiagram, generateSummaryDiagram } from './diagram.js';
+import { loadGraph } from './storage.js';
+/**
+ * Run initial NavGator setup with two-phase scanning
+ */
+export async function setup(options = {}) {
+    const projectPath = options.projectPath || process.cwd();
+    const startTime = Date.now();
+    const errors = [];
+    const progress = options.onProgress || ((phase, msg) => {
+        if (options.verbose) {
+            console.log(`[${phase}] ${msg}`);
+        }
+    });
+    let fastScanComplete = false;
+    let deepScanComplete = false;
+    let componentsFound = 0;
+    let connectionsFound = 0;
+    let promptsFound = 0;
+    let diagram;
+    let fastDuration = 0;
+    let deepDuration;
+    // ==========================================================================
+    // PHASE 1: Fast Scan
+    // ==========================================================================
+    progress('FAST', 'Starting fast scan...');
+    const fastStart = Date.now();
+    try {
+        const fastResult = await quickScan(projectPath);
+        componentsFound = fastResult.components.length;
+        connectionsFound = fastResult.connections.length;
+        fastScanComplete = true;
+        fastDuration = Date.now() - fastStart;
+        progress('FAST', `Found ${componentsFound} components in ${fastDuration}ms`);
+        // Generate initial diagram from fast scan
+        if (options.generateDiagram) {
+            progress('FAST', 'Generating initial diagram...');
+            const config = getConfig();
+            const graph = await loadGraph(config);
+            if (graph) {
+                diagram = generateSummaryDiagram(graph, { maxNodes: 30 });
+                progress('FAST', 'Initial diagram generated');
+            }
+        }
+        // Create initial index to mark scan as complete
+        await markScanComplete(projectPath, {
+            totalComponents: componentsFound,
+            totalConnections: connectionsFound,
+            phase: 'fast',
+        });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : 'Fast scan failed';
+        errors.push(msg);
+        progress('FAST', `Error: ${msg}`);
+    }
+    // ==========================================================================
+    // PHASE 2: Deep Scan (if not fastOnly)
+    // ==========================================================================
+    if (!options.fastOnly) {
+        progress('DEEP', 'Starting deep scan with full analysis...');
+        const deepStart = Date.now();
+        try {
+            const deepResult = await scan(projectPath, {
+                connections: true,
+                prompts: true,
+                useAST: true,
+                verbose: options.verbose,
+            });
+            componentsFound = deepResult.components.length;
+            connectionsFound = deepResult.connections.length;
+            promptsFound = deepResult.promptScan?.prompts.length || 0;
+            deepScanComplete = true;
+            deepDuration = Date.now() - deepStart;
+            progress('DEEP', `Found ${componentsFound} components, ${connectionsFound} connections, ${promptsFound} prompts in ${deepDuration}ms`);
+            // Update diagram with deeper analysis
+            if (options.generateDiagram) {
+                progress('DEEP', 'Updating diagram with full analysis...');
+                const config = getConfig();
+                const graph = await loadGraph(config);
+                if (graph) {
+                    diagram = generateMermaidDiagram(graph, { maxNodes: 50 });
+                    progress('DEEP', 'Full diagram generated');
+                }
+            }
+            // Mark deep scan complete
+            await markScanComplete(projectPath, {
+                totalComponents: componentsFound,
+                totalConnections: connectionsFound,
+                phase: 'deep',
+            });
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : 'Deep scan failed';
+            errors.push(msg);
+            progress('DEEP', `Error: ${msg}`);
+        }
+    }
+    const totalDuration = Date.now() - startTime;
+    return {
+        success: fastScanComplete && (options.fastOnly || deepScanComplete),
+        fastScanComplete,
+        deepScanComplete,
+        componentsFound,
+        connectionsFound,
+        promptsFound,
+        diagram,
+        duration: {
+            fastMs: fastDuration,
+            deepMs: deepDuration,
+            totalMs: totalDuration,
+        },
+        errors,
+    };
+}
+/**
+ * Run fast scan only (for quick initial view)
+ */
+export async function fastSetup(projectPath) {
+    return setup({
+        projectPath,
+        fastOnly: true,
+        generateDiagram: true,
+    });
+}
+/**
+ * Run full setup with both phases
+ */
+export async function fullSetup(projectPath) {
+    return setup({
+        projectPath,
+        fastOnly: false,
+        generateDiagram: true,
+        verbose: true,
+    });
+}
+/**
+ * Check if NavGator has been set up for a project
+ */
+export async function isSetupComplete(projectPath) {
+    const root = projectPath || process.cwd();
+    const indexPath = path.join(root, '.claude', 'architecture', 'index.json');
+    try {
+        const content = await fs.promises.readFile(indexPath, 'utf-8');
+        const index = JSON.parse(content);
+        const lastScan = new Date(index.last_scan);
+        const hoursSince = (Date.now() - index.last_scan) / (1000 * 60 * 60);
+        return {
+            hasScanned: true,
+            lastScan,
+            phase: index.version?.includes('deep') ? 'deep' : 'fast',
+            stale: hoursSince > 24,
+        };
+    }
+    catch {
+        return {
+            hasScanned: false,
+            stale: true,
+        };
+    }
+}
+/**
+ * Mark scan as complete in the index
+ */
+async function markScanComplete(projectPath, stats) {
+    const config = getConfig();
+    const archDir = path.join(projectPath, '.claude', 'architecture');
+    // Ensure directory exists
+    await fs.promises.mkdir(archDir, { recursive: true });
+    const indexPath = path.join(archDir, 'index.json');
+    let index;
+    try {
+        const content = await fs.promises.readFile(indexPath, 'utf-8');
+        index = JSON.parse(content);
+    }
+    catch {
+        index = {
+            version: '1.0.0',
+            last_scan: Date.now(),
+            project_path: projectPath,
+            components: {
+                by_name: {},
+                by_type: {},
+                by_layer: {},
+                by_status: {},
+            },
+            connections: {
+                by_type: {},
+                by_from: {},
+                by_to: {},
+            },
+            stats: {
+                total_components: 0,
+                total_connections: 0,
+                components_by_type: {},
+                connections_by_type: {},
+                outdated_count: 0,
+                vulnerable_count: 0,
+            },
+        };
+    }
+    index.last_scan = Date.now();
+    index.version = `1.0.0-${stats.phase}`;
+    index.stats.total_components = stats.totalComponents;
+    index.stats.total_connections = stats.totalConnections;
+    await fs.promises.writeFile(indexPath, JSON.stringify(index, null, 2));
+}
+/**
+ * Get setup status for display
+ */
+export function formatSetupStatus(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('╔═══════════════════════════════════════════════════════════╗');
+    lines.push('║                    NavGator Setup Complete                ║');
+    lines.push('╚═══════════════════════════════════════════════════════════╝');
+    lines.push('');
+    if (result.success) {
+        lines.push('✓ Architecture scan complete');
+        lines.push('');
+        lines.push(`  Components: ${result.componentsFound}`);
+        lines.push(`  Connections: ${result.connectionsFound}`);
+        if (result.promptsFound > 0) {
+            lines.push(`  AI Prompts: ${result.promptsFound}`);
+        }
+        lines.push('');
+        lines.push(`  Fast scan: ${result.duration.fastMs}ms`);
+        if (result.duration.deepMs) {
+            lines.push(`  Deep scan: ${result.duration.deepMs}ms`);
+        }
+        lines.push(`  Total: ${result.duration.totalMs}ms`);
+    }
+    else {
+        lines.push('⚠ Setup completed with errors:');
+        for (const error of result.errors) {
+            lines.push(`  - ${error}`);
+        }
+    }
+    lines.push('');
+    lines.push('Next steps:');
+    lines.push('  • navgator status     - View architecture summary');
+    lines.push('  • navgator diagram    - Generate visual diagram');
+    lines.push('  • navgator impact <x> - See what changes affect');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,147 @@
+/**
+ * NavGator Storage System
+ * File-based persistence for components and connections
+ */
+import { ArchitectureComponent, ArchitectureConnection, ArchitectureIndex, ConnectionGraph, NavGatorConfig, NavHashes, FileHashRecord, FileChangeResult } from './types.js';
+/**
+ * Store a component to disk
+ */
+export declare function storeComponent(component: ArchitectureComponent, config?: NavGatorConfig, projectRoot?: string): Promise<{
+    component_id: string;
+    file_path: string;
+}>;
+/**
+ * Load a component by ID
+ */
+export declare function loadComponent(componentId: string, config?: NavGatorConfig, projectRoot?: string): Promise<ArchitectureComponent | null>;
+/**
+ * Load all components (parallelized for efficiency)
+ */
+export declare function loadAllComponents(config?: NavGatorConfig, projectRoot?: string): Promise<ArchitectureComponent[]>;
+/**
+ * Delete a component by ID
+ */
+export declare function deleteComponent(componentId: string, config?: NavGatorConfig, projectRoot?: string): Promise<boolean>;
+/**
+ * Store a connection to disk
+ */
+export declare function storeConnection(connection: ArchitectureConnection, config?: NavGatorConfig, projectRoot?: string): Promise<{
+    connection_id: string;
+    file_path: string;
+}>;
+/**
+ * Load a connection by ID
+ */
+export declare function loadConnection(connectionId: string, config?: NavGatorConfig, projectRoot?: string): Promise<ArchitectureConnection | null>;
+/**
+ * Load all connections (parallelized for efficiency)
+ */
+export declare function loadAllConnections(config?: NavGatorConfig, projectRoot?: string): Promise<ArchitectureConnection[]>;
+/**
+ * Delete a connection by ID
+ */
+export declare function deleteConnection(connectionId: string, config?: NavGatorConfig, projectRoot?: string): Promise<boolean>;
+/**
+ * Build and save the index from current components and connections
+ */
+export declare function buildIndex(config?: NavGatorConfig, projectRoot?: string): Promise<ArchitectureIndex>;
+/**
+ * Load the index
+ */
+export declare function loadIndex(config?: NavGatorConfig, projectRoot?: string): Promise<ArchitectureIndex | null>;
+/**
+ * Build the connection graph
+ */
+export declare function buildGraph(config?: NavGatorConfig, projectRoot?: string): Promise<ConnectionGraph>;
+/**
+ * Build a map of file paths → component IDs for fast lookup in hooks.
+ * Sources: component config_files + connection code_reference files + connection locations.
+ */
+export declare function buildFileMap(config?: NavGatorConfig, projectRoot?: string): Promise<Record<string, string>>;
+/**
+ * Save prompt scan results to prompts.json
+ */
+export declare function savePromptScan(promptData: unknown, config?: NavGatorConfig, projectRoot?: string): Promise<void>;
+/**
+ * Build a concise markdown summary with pointers to detail files.
+ * This is the "hot context" an LLM reads first on cold start.
+ */
+export declare function buildSummary(config?: NavGatorConfig, projectRoot?: string, promptScan?: {
+    prompts: Array<{
+        name: string;
+        location: {
+            file: string;
+            lineStart: number;
+        };
+        provider?: {
+            provider: string;
+            model?: string;
+        };
+        category?: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+    }>;
+    summary: {
+        totalPrompts: number;
+    };
+}): Promise<string>;
+/**
+ * Load the graph
+ */
+export declare function loadGraph(config?: NavGatorConfig, projectRoot?: string): Promise<ConnectionGraph | null>;
+/**
+ * Create a snapshot of current architecture
+ */
+export declare function createSnapshot(reason?: string, config?: NavGatorConfig, projectRoot?: string): Promise<{
+    snapshot_id: string;
+    file_path: string;
+}>;
+/**
+ * Store multiple components at once (parallelized for efficiency)
+ */
+export declare function storeComponents(components: ArchitectureComponent[], config?: NavGatorConfig, projectRoot?: string): Promise<void>;
+/**
+ * Store multiple connections at once (parallelized for efficiency)
+ */
+export declare function storeConnections(connections: ArchitectureConnection[], config?: NavGatorConfig, projectRoot?: string): Promise<void>;
+/**
+ * Clear all stored data (parallelized for efficiency)
+ */
+export declare function clearStorage(config?: NavGatorConfig, projectRoot?: string): Promise<void>;
+/**
+ * Get storage statistics
+ */
+export declare function getStorageStats(config?: NavGatorConfig, projectRoot?: string): Promise<{
+    total_components: number;
+    total_connections: number;
+    disk_usage_kb: number;
+    oldest_timestamp: number | null;
+    newest_timestamp: number | null;
+}>;
+/**
+ * Compute SHA-256 hash of a file
+ */
+export declare function computeFileHash(filePath: string): Promise<string>;
+/**
+ * Compute hashes for multiple files (parallelized in batches for efficiency)
+ */
+export declare function computeFileHashes(files: string[], projectRoot: string): Promise<Record<string, FileHashRecord>>;
+/**
+ * Save file hashes to disk
+ */
+export declare function saveHashes(hashes: Record<string, FileHashRecord>, config?: NavGatorConfig, projectRoot?: string): Promise<void>;
+/**
+ * Load file hashes from disk
+ */
+export declare function loadHashes(config?: NavGatorConfig, projectRoot?: string): Promise<NavHashes | null>;
+/**
+ * Detect which files have changed since last scan
+ */
+export declare function detectFileChanges(currentFiles: string[], projectRoot: string, config?: NavGatorConfig): Promise<FileChangeResult>;
+/**
+ * Get a summary of file changes for display
+ */
+export declare function formatFileChangeSummary(changes: FileChangeResult): string;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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