@tyroneross/navgator 0.2.2 → 0.9.0

package/dist/projects.js

@@ -0,0 +1,153 @@
+/**
+ * NavGator Project Registry
+ * Manages ~/.navgator/projects.json with enhanced per-project context
+ */
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+// =============================================================================
+// REGISTRY I/O
+// =============================================================================
+function getRegistryDir() {
+    return path.join(os.homedir(), '.navgator');
+}
+function getRegistryPath() {
+    return path.join(getRegistryDir(), 'projects.json');
+}
+/**
+ * Load the project registry with v1→v2 auto-migration
+ */
+export async function loadRegistry() {
+    const registryPath = getRegistryPath();
+    try {
+        const content = await fs.promises.readFile(registryPath, 'utf-8');
+        const raw = JSON.parse(content);
+        // v1→v2 migration: add missing fields
+        if (raw.version === 1) {
+            raw.version = 2;
+            for (const p of raw.projects) {
+                if (p.scanCount === undefined)
+                    p.scanCount = p.lastScan ? 1 : 0;
+            }
+        }
+        return raw;
+    }
+    catch {
+        return { version: 2, projects: [] };
+    }
+}
+/**
+ * Save the project registry
+ */
+export async function saveRegistry(registry) {
+    const registryDir = getRegistryDir();
+    await fs.promises.mkdir(registryDir, { recursive: true });
+    await fs.promises.writeFile(getRegistryPath(), JSON.stringify(registry, null, 2), 'utf-8');
+}
+// =============================================================================
+// REGISTRATION
+// =============================================================================
+/**
+ * Register or update a project after scan.
+ * Replaces the inline registry code previously in cli/index.ts.
+ */
+export async function registerProject(projectRoot, stats, significance, gitInfo) {
+    try {
+        const registry = await loadRegistry();
+        const existing = registry.projects.find((p) => p.path === projectRoot);
+        if (existing) {
+            existing.lastScan = Date.now();
+            existing.scanCount = (existing.scanCount || 0) + 1;
+            if (stats)
+                existing.stats = stats;
+            if (significance && significance !== 'patch') {
+                existing.lastSignificantChange = Date.now();
+                existing.lastSignificance = significance;
+            }
+            if (gitInfo) {
+                existing.git = { branch: gitInfo.branch, commit: gitInfo.commit };
+            }
+        }
+        else {
+            const dirName = projectRoot.split(path.sep).pop() || 'project';
+            const name = dirName
+                .replace(/[-_]/g, ' ')
+                .replace(/\b\w/g, (c) => c.toUpperCase())
+                .trim();
+            registry.projects.push({
+                path: projectRoot,
+                name,
+                addedAt: Date.now(),
+                lastScan: Date.now(),
+                scanCount: 1,
+                stats,
+                lastSignificantChange: significance && significance !== 'patch' ? Date.now() : undefined,
+                lastSignificance: significance && significance !== 'patch' ? significance : undefined,
+                git: gitInfo ? { branch: gitInfo.branch, commit: gitInfo.commit } : undefined,
+            });
+        }
+        await saveRegistry(registry);
+    }
+    catch {
+        // Non-critical — don't fail the scan
+    }
+}
+// =============================================================================
+// LISTING
+// =============================================================================
+/**
+ * List all registered projects
+ */
+export async function listProjects() {
+    const registry = await loadRegistry();
+    return registry.projects;
+}
+/**
+ * Format the project list for CLI display
+ */
+export function formatProjectsList(projects, json) {
+    if (json) {
+        return JSON.stringify(projects, null, 2);
+    }
+    if (projects.length === 0) {
+        return 'No projects registered yet. Run `navgator scan` in a project to register it.';
+    }
+    const lines = [];
+    lines.push('Registered Projects');
+    lines.push('─'.repeat(60));
+    for (const p of projects) {
+        const lastScan = p.lastScan
+            ? timeSince(p.lastScan)
+            : 'never';
+        const stale = p.lastScan && (Date.now() - p.lastScan) > 24 * 60 * 60 * 1000;
+        const staleIndicator = stale ? ' (stale)' : '';
+        lines.push('');
+        lines.push(`  ${p.name}${staleIndicator}`);
+        lines.push(`  ${p.path}`);
+        lines.push(`  Scans: ${p.scanCount || 0} | Last: ${lastScan}`);
+        if (p.stats) {
+            lines.push(`  Components: ${p.stats.components} | Connections: ${p.stats.connections} | Prompts: ${p.stats.prompts}`);
+        }
+        if (p.git) {
+            lines.push(`  Branch: ${p.git.branch} @ ${p.git.commit}`);
+        }
+        if (p.lastSignificance && p.lastSignificantChange) {
+            lines.push(`  Last significant change: ${p.lastSignificance.toUpperCase()} (${timeSince(p.lastSignificantChange)})`);
+        }
+    }
+    return lines.join('\n');
+}
+function timeSince(timestamp) {
+    const seconds = Math.floor((Date.now() - timestamp) / 1000);
+    if (seconds < 60)
+        return 'just now';
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+//# sourceMappingURL=projects.js.map

package/dist/projects.js.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,22 @@
+/**
+ * NavGator Component Resolution
+ * Resolves component queries (names, file paths, IDs) to ArchitectureComponent objects
+ */
+import type { ArchitectureComponent } from './types.js';
+/**
+ * Resolve a query string to an architecture component.
+ *
+ * Resolution order:
+ * 1. Exact component ID match
+ * 2. Exact component name match (case-insensitive)
+ * 3. File path match via fileMap → component ID → component
+ * 4. Partial name match (substring, case-insensitive)
+ * 5. File path substring match (normalized, no leading ./)
+ */
+export declare function resolveComponent(query: string, components: ArchitectureComponent[], fileMap?: Record<string, string>): ArchitectureComponent | null;
+/**
+ * Find candidate suggestions when resolution fails.
+ * Returns up to 5 closest matches for "Did you mean?" hints.
+ */
+export declare function findCandidates(query: string, components: ArchitectureComponent[], maxResults?: number): string[];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,qBAAqB,EAAE,EACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,qBAAqB,GAAG,IAAI,CAkE9B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,qBAAqB,EAAE,EACnC,UAAU,GAAE,MAAU,GACrB,MAAM,EAAE,CAgCV"}

package/dist/resolve.js

@@ -0,0 +1,128 @@
+/**
+ * NavGator Component Resolution
+ * Resolves component queries (names, file paths, IDs) to ArchitectureComponent objects
+ */
+/**
+ * Resolve a query string to an architecture component.
+ *
+ * Resolution order:
+ * 1. Exact component ID match
+ * 2. Exact component name match (case-insensitive)
+ * 3. File path match via fileMap → component ID → component
+ * 4. Partial name match (substring, case-insensitive)
+ * 5. File path substring match (normalized, no leading ./)
+ */
+export function resolveComponent(query, components, fileMap) {
+    if (!query || components.length === 0)
+        return null;
+    // 1. Exact component ID match
+    const byId = components.find(c => c.component_id === query);
+    if (byId)
+        return byId;
+    // 2. Exact name match (case-insensitive)
+    const byName = components.find(c => c.name.toLowerCase() === query.toLowerCase());
+    if (byName)
+        return byName;
+    // 3. File path match via fileMap
+    if (fileMap) {
+        const normalizedQuery = normalizePath(query);
+        // Try exact match first
+        const componentId = fileMap[normalizedQuery] || fileMap[query];
+        if (componentId) {
+            const byFileMap = components.find(c => c.component_id === componentId);
+            if (byFileMap)
+                return byFileMap;
+        }
+        // Try all fileMap entries for normalized match
+        for (const [filePath, compId] of Object.entries(fileMap)) {
+            if (normalizePath(filePath) === normalizedQuery) {
+                const match = components.find(c => c.component_id === compId);
+                if (match)
+                    return match;
+            }
+        }
+    }
+    // 4. Partial name match (substring, case-insensitive)
+    // When multiple matches exist, prefer the one with more connections (more architecturally relevant)
+    const queryLower = query.toLowerCase();
+    const partialMatches = components.filter(c => c.name.toLowerCase().includes(queryLower));
+    if (partialMatches.length === 1)
+        return partialMatches[0];
+    if (partialMatches.length > 1) {
+        // Sort by connection count (descending), then by name length (shorter = more specific)
+        partialMatches.sort((a, b) => {
+            const aConns = a.connects_to.length + a.connected_from.length;
+            const bConns = b.connects_to.length + b.connected_from.length;
+            if (bConns !== aConns)
+                return bConns - aConns;
+            return a.name.length - b.name.length;
+        });
+        return partialMatches[0];
+    }
+    // 5. File path substring match
+    const normalizedQuery = normalizePath(query);
+    if (fileMap) {
+        for (const [filePath, compId] of Object.entries(fileMap)) {
+            if (normalizePath(filePath).includes(normalizedQuery)) {
+                const match = components.find(c => c.component_id === compId);
+                if (match)
+                    return match;
+            }
+        }
+    }
+    // Also check component source config_files for path matches
+    for (const comp of components) {
+        for (const configFile of comp.source.config_files || []) {
+            if (normalizePath(configFile).includes(normalizedQuery)) {
+                return comp;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Find candidate suggestions when resolution fails.
+ * Returns up to 5 closest matches for "Did you mean?" hints.
+ */
+export function findCandidates(query, components, maxResults = 5) {
+    const queryLower = query.toLowerCase();
+    // Score each component by relevance
+    const scored = components.map(c => {
+        const nameLower = c.name.toLowerCase();
+        let score = 0;
+        // Substring match
+        if (nameLower.includes(queryLower) || queryLower.includes(nameLower)) {
+            score += 3;
+        }
+        // Common prefix
+        let prefix = 0;
+        for (let i = 0; i < Math.min(nameLower.length, queryLower.length); i++) {
+            if (nameLower[i] === queryLower[i])
+                prefix++;
+            else
+                break;
+        }
+        score += prefix;
+        // Levenshtein-like: penalize length difference
+        score -= Math.abs(nameLower.length - queryLower.length) * 0.5;
+        return { name: c.name, score };
+    });
+    return scored
+        .filter(s => s.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxResults)
+        .map(s => s.name);
+}
+/**
+ * Normalize a file path for comparison:
+ * - Remove leading ./
+ * - Convert backslashes to forward slashes
+ * - Lowercase for case-insensitive comparison
+ */
+function normalizePath(p) {
+    return p
+        .replace(/\\/g, '/')
+        .replace(/^\.\//, '')
+        .toLowerCase();
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/rules.d.ts

@@ -0,0 +1,36 @@
+/**
+ * NavGator Architecture Rules
+ * Built-in and custom rule checking for architectural gap detection
+ */
+import { ArchitectureComponent, ArchitectureConnection } from './types.js';
+export interface ArchitectureRule {
+    id: string;
+    name: string;
+    description: string;
+    severity: 'error' | 'warning' | 'info';
+    check: (components: ArchitectureComponent[], connections: ArchitectureConnection[]) => RuleViolation[];
+}
+export interface RuleViolation {
+    rule_id: string;
+    severity: 'error' | 'warning' | 'info';
+    component?: string;
+    message: string;
+    suggestion?: string;
+}
+/**
+ * Get all built-in architecture rules
+ */
+export declare function getBuiltinRules(): ArchitectureRule[];
+/**
+ * Load custom rules from .navgator/architecture/rules.json
+ */
+export declare function loadCustomRules(projectRoot?: string): ArchitectureRule[];
+/**
+ * Check all rules (builtin + custom) against architecture
+ */
+export declare function checkRules(components: ArchitectureComponent[], connections: ArchitectureConnection[], rules?: ArchitectureRule[]): RuleViolation[];
+/**
+ * Format rule violations for human-readable CLI output
+ */
+export declare function formatRulesOutput(violations: RuleViolation[], filterSeverity?: string): string;
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG3E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,UAAU,EAAE,qBAAqB,EAAE,EAAE,WAAW,EAAE,sBAAsB,EAAE,KAAK,aAAa,EAAE,CAAC;CACxG;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,EAAE,CA8OpD;AAkLD;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAexE;AAmDD;;GAEG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,qBAAqB,EAAE,EACnC,WAAW,EAAE,sBAAsB,EAAE,EACrC,KAAK,CAAC,EAAE,gBAAgB,EAAE,GACzB,aAAa,EAAE,CASjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAwC9F"}