@tyroneross/navgator 0.1.0

package/dist/scanners/prompts/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Prompt Scanner
+ *
+ * Comprehensive AI prompt detection and tracking for codebases.
+ * Tracks prompt locations, content, purpose, and which AI services they're sent to.
+ *
+ * Features:
+ * - Full prompt content extraction (up to 2000 chars)
+ * - Template variable detection
+ * - AI provider linkage (Claude, OpenAI, etc.)
+ * - Purpose inference from comments and content
+ * - Category classification
+ *
+ * @example
+ * ```typescript
+ * import { scanPrompts } from './scanners/prompts';
+ *
+ * const result = await scanPrompts('/path/to/project');
+ * console.log(`Found ${result.prompts.length} prompts`);
+ *
+ * for (const prompt of result.prompts) {
+ *   console.log(`${prompt.name} (${prompt.category})`);
+ *   console.log(`  File: ${prompt.location.file}:${prompt.location.lineStart}`);
+ *   console.log(`  Provider: ${prompt.provider?.provider || 'unknown'}`);
+ *   console.log(`  Purpose: ${prompt.purpose || 'not detected'}`);
+ * }
+ * ```
+ */
+import { DetectorOptions } from './detector.js';
+import { DetectedPrompt, PromptScanResult } from './types.js';
+import { ScanResult } from '../../types.js';
+export * from './types.js';
+export { PromptDetector, createDetector } from './detector.js';
+/**
+ * Scan a project for AI prompts
+ */
+export declare function scanPrompts(projectRoot: string, options?: DetectorOptions): Promise<PromptScanResult>;
+/**
+ * Convert detected prompts to NavGator components and connections
+ * for integration with the main architecture graph
+ */
+export declare function convertToArchitecture(prompts: DetectedPrompt[]): ScanResult;
+/**
+ * Format prompts for CLI output
+ */
+export declare function formatPromptsOutput(result: PromptScanResult): string;
+/**
+ * Format a single prompt for detailed view
+ */
+export declare function formatPromptDetail(prompt: DetectedPrompt): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/scanners/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scanners/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAkC,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EACL,cAAc,EAEd,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,UAAU,EAGX,MAAM,gBAAgB,CAAC;AAGxB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAM/D;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAY3B;AAwCD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EAAE,GACxB,UAAU,CAuHZ;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA6EpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAyEjE"}

package/dist/scanners/prompts/index.js

@@ -0,0 +1,340 @@
+/**
+ * Prompt Scanner
+ *
+ * Comprehensive AI prompt detection and tracking for codebases.
+ * Tracks prompt locations, content, purpose, and which AI services they're sent to.
+ *
+ * Features:
+ * - Full prompt content extraction (up to 2000 chars)
+ * - Template variable detection
+ * - AI provider linkage (Claude, OpenAI, etc.)
+ * - Purpose inference from comments and content
+ * - Category classification
+ *
+ * @example
+ * ```typescript
+ * import { scanPrompts } from './scanners/prompts';
+ *
+ * const result = await scanPrompts('/path/to/project');
+ * console.log(`Found ${result.prompts.length} prompts`);
+ *
+ * for (const prompt of result.prompts) {
+ *   console.log(`${prompt.name} (${prompt.category})`);
+ *   console.log(`  File: ${prompt.location.file}:${prompt.location.lineStart}`);
+ *   console.log(`  Provider: ${prompt.provider?.provider || 'unknown'}`);
+ *   console.log(`  Purpose: ${prompt.purpose || 'not detected'}`);
+ * }
+ * ```
+ */
+import { createDetector } from './detector.js';
+import { generateComponentId, generateConnectionId, } from '../../types.js';
+// Re-export types
+export * from './types.js';
+export { PromptDetector, createDetector } from './detector.js';
+// =============================================================================
+// MAIN SCAN FUNCTION
+// =============================================================================
+/**
+ * Scan a project for AI prompts
+ */
+export async function scanPrompts(projectRoot, options) {
+    const detector = createDetector(options);
+    const { prompts, warnings } = await detector.scanProject(projectRoot);
+    // Build summary
+    const summary = buildSummary(prompts);
+    return {
+        prompts,
+        summary,
+        warnings,
+    };
+}
+/**
+ * Build summary statistics from prompts
+ */
+function buildSummary(prompts) {
+    const byProvider = {};
+    const byCategory = {};
+    let templatesCount = 0;
+    let withToolsCount = 0;
+    for (const prompt of prompts) {
+        // Count by provider
+        const provider = prompt.provider?.provider || 'unknown';
+        byProvider[provider] = (byProvider[provider] || 0) + 1;
+        // Count by category
+        const category = prompt.category || 'unknown';
+        byCategory[category] = (byCategory[category] || 0) + 1;
+        // Count templates
+        if (prompt.isTemplate)
+            templatesCount++;
+        // Count tool-using prompts
+        if (prompt.tags.includes('tool-use'))
+            withToolsCount++;
+    }
+    return {
+        totalPrompts: prompts.length,
+        byProvider,
+        byCategory,
+        templatesCount,
+        withToolsCount,
+    };
+}
+// =============================================================================
+// CONVERT TO ARCHITECTURE COMPONENTS/CONNECTIONS
+// =============================================================================
+/**
+ * Convert detected prompts to NavGator components and connections
+ * for integration with the main architecture graph
+ */
+export function convertToArchitecture(prompts) {
+    const components = [];
+    const connections = [];
+    const timestamp = Date.now();
+    for (const prompt of prompts) {
+        // Create component for the prompt
+        const component = {
+            component_id: generateComponentId('prompt', prompt.name),
+            name: prompt.name,
+            type: 'prompt',
+            version: undefined,
+            role: {
+                purpose: prompt.purpose || `AI prompt (${prompt.category})`,
+                layer: 'backend',
+                critical: true,
+            },
+            source: {
+                detection_method: 'auto',
+                config_files: [prompt.location.file],
+                confidence: prompt.confidence,
+            },
+            connects_to: [],
+            connected_from: [],
+            status: 'active',
+            tags: [
+                'prompt',
+                prompt.category || 'unknown',
+                ...(prompt.provider ? [prompt.provider.provider] : []),
+                ...prompt.tags,
+            ],
+            timestamp,
+            last_updated: timestamp,
+            // Store rich prompt metadata
+            metadata: {
+                promptId: prompt.id,
+                category: prompt.category,
+                isTemplate: prompt.isTemplate,
+                variables: prompt.variables.map(v => v.name),
+                provider: prompt.provider?.provider,
+                model: prompt.provider?.model,
+                messageCount: prompt.messages.length,
+                hasSystemPrompt: prompt.messages.some(m => m.role === 'system'),
+                // Store first message content (truncated)
+                systemPrompt: prompt.messages.find(m => m.role === 'system')?.content?.slice(0, 500),
+                userTemplate: prompt.messages.find(m => m.role === 'user')?.content?.slice(0, 500),
+            },
+        };
+        components.push(component);
+        // Create connection showing where prompt is defined
+        const locationConnection = {
+            connection_id: generateConnectionId('prompt-location'),
+            from: {
+                component_id: component.component_id,
+                location: {
+                    file: prompt.location.file,
+                    line: prompt.location.lineStart,
+                    function: prompt.location.functionName,
+                },
+            },
+            to: {
+                component_id: component.component_id,
+            },
+            connection_type: 'prompt-location',
+            code_reference: {
+                file: prompt.location.file,
+                symbol: prompt.location.functionName || prompt.name,
+                symbol_type: prompt.location.functionName ? 'function' : 'variable',
+                line_start: prompt.location.lineStart,
+                line_end: prompt.location.lineEnd,
+                code_snippet: prompt.rawContent?.slice(0, 200),
+            },
+            description: `Prompt defined: ${prompt.name}`,
+            detected_from: 'Prompt scanner',
+            confidence: prompt.confidence,
+            timestamp,
+            last_verified: timestamp,
+        };
+        connections.push(locationConnection);
+        // Create connections for each usage
+        for (const usage of prompt.usedBy) {
+            const usageConnection = {
+                connection_id: generateConnectionId('prompt-usage'),
+                from: {
+                    component_id: `FILE:${usage.file}`,
+                    location: {
+                        file: usage.file,
+                        line: usage.line,
+                        function: usage.functionName,
+                    },
+                },
+                to: {
+                    component_id: component.component_id,
+                },
+                connection_type: 'service-call',
+                code_reference: {
+                    file: usage.file,
+                    symbol: usage.functionName || `line_${usage.line}`,
+                    symbol_type: 'function',
+                    line_start: usage.line,
+                    code_snippet: usage.callPattern,
+                },
+                description: `Calls AI (${prompt.provider?.provider || 'unknown'}) with ${prompt.name}`,
+                detected_from: 'Prompt usage detection',
+                confidence: prompt.confidence,
+                timestamp,
+                last_verified: timestamp,
+            };
+            connections.push(usageConnection);
+        }
+    }
+    return {
+        components,
+        connections,
+        warnings: [],
+    };
+}
+// =============================================================================
+// FORMATTED OUTPUT
+// =============================================================================
+/**
+ * Format prompts for CLI output
+ */
+export function formatPromptsOutput(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('AI PROMPTS DETECTED');
+    lines.push('='.repeat(60));
+    lines.push('');
+    if (result.prompts.length === 0) {
+        lines.push('No AI prompts detected.');
+        return lines.join('\n');
+    }
+    // Summary
+    lines.push(`Total prompts: ${result.summary.totalPrompts}`);
+    lines.push(`Templates: ${result.summary.templatesCount}`);
+    lines.push(`With tools: ${result.summary.withToolsCount}`);
+    lines.push('');
+    // By provider
+    lines.push('By Provider:');
+    for (const [provider, count] of Object.entries(result.summary.byProvider)) {
+        lines.push(`  ${provider}: ${count}`);
+    }
+    lines.push('');
+    // By category
+    lines.push('By Category:');
+    for (const [category, count] of Object.entries(result.summary.byCategory)) {
+        lines.push(`  ${category}: ${count}`);
+    }
+    lines.push('');
+    // Individual prompts
+    lines.push('-'.repeat(60));
+    for (const prompt of result.prompts) {
+        lines.push('');
+        lines.push(`PROMPT: ${prompt.name}`);
+        lines.push(`  File: ${prompt.location.file}:${prompt.location.lineStart}-${prompt.location.lineEnd}`);
+        if (prompt.location.functionName) {
+            lines.push(`  Function: ${prompt.location.functionName}`);
+        }
+        lines.push(`  Provider: ${prompt.provider?.provider || 'unknown'}`);
+        lines.push(`  Category: ${prompt.category}`);
+        if (prompt.purpose) {
+            lines.push(`  Purpose: ${prompt.purpose}`);
+        }
+        if (prompt.isTemplate && prompt.variables.length > 0) {
+            lines.push(`  Variables: ${prompt.variables.map(v => v.name).join(', ')}`);
+        }
+        if (prompt.tags.length > 0) {
+            lines.push(`  Tags: ${prompt.tags.join(', ')}`);
+        }
+        // Show message preview
+        const systemMsg = prompt.messages.find(m => m.role === 'system');
+        if (systemMsg) {
+            const preview = systemMsg.content.slice(0, 100).replace(/\n/g, ' ');
+            lines.push(`  System: "${preview}${systemMsg.content.length > 100 ? '...' : ''}"`);
+        }
+        const userMsg = prompt.messages.find(m => m.role === 'user');
+        if (userMsg) {
+            const preview = userMsg.content.slice(0, 100).replace(/\n/g, ' ');
+            lines.push(`  User: "${preview}${userMsg.content.length > 100 ? '...' : ''}"`);
+        }
+        lines.push(`  Confidence: ${(prompt.confidence * 100).toFixed(0)}%`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a single prompt for detailed view
+ */
+export function formatPromptDetail(prompt) {
+    const lines = [];
+    lines.push('');
+    lines.push(`PROMPT: ${prompt.name}`);
+    lines.push('='.repeat(60));
+    lines.push('');
+    lines.push(`ID: ${prompt.id}`);
+    lines.push(`File: ${prompt.location.file}`);
+    lines.push(`Lines: ${prompt.location.lineStart}-${prompt.location.lineEnd}`);
+    if (prompt.location.functionName) {
+        lines.push(`Function: ${prompt.location.functionName}`);
+    }
+    if (prompt.location.className) {
+        lines.push(`Class: ${prompt.location.className}`);
+    }
+    lines.push('');
+    lines.push('METADATA');
+    lines.push('-'.repeat(40));
+    lines.push(`Provider: ${prompt.provider?.provider || 'unknown'}`);
+    if (prompt.provider?.model) {
+        lines.push(`Model: ${prompt.provider.model}`);
+    }
+    lines.push(`Category: ${prompt.category}`);
+    lines.push(`Is Template: ${prompt.isTemplate}`);
+    if (prompt.templateSyntax) {
+        lines.push(`Template Syntax: ${prompt.templateSyntax}`);
+    }
+    if (prompt.purpose) {
+        lines.push(`Purpose: ${prompt.purpose}`);
+    }
+    lines.push(`Confidence: ${(prompt.confidence * 100).toFixed(0)}%`);
+    lines.push(`Tags: ${prompt.tags.join(', ') || 'none'}`);
+    if (prompt.variables.length > 0) {
+        lines.push('');
+        lines.push('VARIABLES');
+        lines.push('-'.repeat(40));
+        for (const variable of prompt.variables) {
+            lines.push(`  ${variable.name} (${variable.pattern})`);
+        }
+    }
+    lines.push('');
+    lines.push('MESSAGES');
+    lines.push('-'.repeat(40));
+    for (const msg of prompt.messages) {
+        lines.push('');
+        lines.push(`[${msg.role.toUpperCase()}]`);
+        lines.push(msg.content);
+        if (msg.truncated) {
+            lines.push(`... (truncated, original length: ${msg.originalLength})`);
+        }
+    }
+    if (prompt.usedBy.length > 0) {
+        lines.push('');
+        lines.push('USAGE LOCATIONS');
+        lines.push('-'.repeat(40));
+        for (const usage of prompt.usedBy) {
+            lines.push(`  ${usage.file}:${usage.line}`);
+            lines.push(`    Call: ${usage.callPattern}`);
+            if (usage.functionName) {
+                lines.push(`    Function: ${usage.functionName}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/scanners/prompts/index.js.map

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

package/dist/scanners/prompts/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Prompt Scanner Types
+ *
+ * Rich types for tracking AI prompts in codebases.
+ * Inspired by PromptLayer's registry pattern for version control and metadata.
+ *
+ * @see https://docs.promptlayer.com/features/prompt-registry/overview
+ */
+/**
+ * A single message in a prompt (system, user, assistant)
+ */
+export interface PromptMessage {
+    role: 'system' | 'user' | 'assistant' | 'function' | 'tool';
+    content: string;
+    name?: string;
+    truncated?: boolean;
+    originalLength?: number;
+}
+/**
+ * Variables/placeholders in a prompt template
+ */
+export interface PromptVariable {
+    name: string;
+    pattern: string;
+    type?: 'string' | 'array' | 'object' | 'unknown';
+    required?: boolean;
+    defaultValue?: string;
+}
+/**
+ * AI provider configuration detected with the prompt
+ */
+export interface PromptProviderConfig {
+    provider: 'anthropic' | 'openai' | 'azure' | 'google' | 'cohere' | 'unknown';
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    stopSequences?: string[];
+    tools?: string[];
+}
+/**
+ * A detected prompt in the codebase
+ */
+export interface DetectedPrompt {
+    id: string;
+    name: string;
+    location: {
+        file: string;
+        lineStart: number;
+        lineEnd: number;
+        functionName?: string;
+        className?: string;
+        exportName?: string;
+    };
+    messages: PromptMessage[];
+    rawContent?: string;
+    isTemplate: boolean;
+    variables: PromptVariable[];
+    templateSyntax?: 'jinja2' | 'fstring' | 'mustache' | 'template-literal' | 'unknown';
+    provider?: PromptProviderConfig;
+    usedBy: PromptUsage[];
+    purpose?: string;
+    tags: string[];
+    category?: PromptCategory;
+    confidence: number;
+    detectionMethod: 'ast' | 'regex' | 'heuristic';
+    timestamp: number;
+}
+/**
+ * Where a prompt is used (called)
+ */
+export interface PromptUsage {
+    file: string;
+    line: number;
+    functionName?: string;
+    callPattern: string;
+    isAsync: boolean;
+    hasStreaming: boolean;
+}
+/**
+ * Prompt category based on detected purpose
+ */
+export type PromptCategory = 'chat' | 'completion' | 'extraction' | 'classification' | 'summarization' | 'translation' | 'code-generation' | 'code-review' | 'agent' | 'embedding' | 'unknown';
+/**
+ * Pattern definition for detecting prompts
+ */
+export interface PromptPattern {
+    name: string;
+    provider: PromptProviderConfig['provider'];
+    patterns: RegExp[];
+    messageExtractor?: (content: string, match: RegExpMatchArray) => PromptMessage[] | null;
+    configExtractor?: (content: string) => Partial<PromptProviderConfig>;
+}
+/**
+ * Result of prompt scanning
+ */
+export interface PromptScanResult {
+    prompts: DetectedPrompt[];
+    summary: {
+        totalPrompts: number;
+        byProvider: Record<string, number>;
+        byCategory: Record<string, number>;
+        templatesCount: number;
+        withToolsCount: number;
+    };
+    warnings: PromptWarning[];
+}
+export interface PromptWarning {
+    type: 'parse_error' | 'truncated' | 'ambiguous' | 'deprecated_pattern';
+    message: string;
+    file?: string;
+    line?: number;
+}
+/**
+ * Maximum prompt content length to store (characters)
+ * Longer prompts are truncated with a note
+ */
+export declare const MAX_PROMPT_LENGTH = 2000;
+/**
+ * Maximum number of messages to store per prompt
+ */
+export declare const MAX_MESSAGES_PER_PROMPT = 10;
+/**
+ * Keywords that suggest prompt purpose
+ */
+export declare const PURPOSE_KEYWORDS: Record<PromptCategory, string[]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/scanners/prompts/types.d.ts.map

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

package/dist/scanners/prompts/types.js

@@ -0,0 +1,37 @@
+/**
+ * Prompt Scanner Types
+ *
+ * Rich types for tracking AI prompts in codebases.
+ * Inspired by PromptLayer's registry pattern for version control and metadata.
+ *
+ * @see https://docs.promptlayer.com/features/prompt-registry/overview
+ */
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/**
+ * Maximum prompt content length to store (characters)
+ * Longer prompts are truncated with a note
+ */
+export const MAX_PROMPT_LENGTH = 2000;
+/**
+ * Maximum number of messages to store per prompt
+ */
+export const MAX_MESSAGES_PER_PROMPT = 10;
+/**
+ * Keywords that suggest prompt purpose
+ */
+export const PURPOSE_KEYWORDS = {
+    'chat': ['chat', 'conversation', 'assistant', 'helpful'],
+    'completion': ['complete', 'continue', 'generate'],
+    'extraction': ['extract', 'parse', 'identify', 'find'],
+    'classification': ['classify', 'categorize', 'label', 'determine'],
+    'summarization': ['summarize', 'summary', 'tldr', 'condense'],
+    'translation': ['translate', 'convert', 'language'],
+    'code-generation': ['code', 'implement', 'write function', 'generate code'],
+    'code-review': ['review', 'analyze code', 'find bugs', 'improve'],
+    'agent': ['tool', 'function', 'action', 'execute'],
+    'embedding': ['embed', 'vector', 'similarity'],
+    'unknown': [],
+};
+//# sourceMappingURL=types.js.map

package/dist/scanners/prompts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/scanners/prompts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4JH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,CAAC;IACxD,YAAY,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;IAClD,YAAY,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC;IACtD,gBAAgB,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,CAAC;IAClE,eAAe,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC;IAC7D,aAAa,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC;IACnD,iBAAiB,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,CAAC;IAC3E,aAAa,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,CAAC;IACjE,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC;IAClD,WAAW,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC;IAC9C,SAAS,EAAE,EAAE;CACd,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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.
+ */
+export interface SetupOptions {
+    /** Project root path */
+    projectPath?: string;
+    /** Skip the deep scan phase */
+    fastOnly?: boolean;
+    /** Run deep scan immediately instead of in background */
+    deepImmediate?: boolean;
+    /** Generate initial diagram */
+    generateDiagram?: boolean;
+    /** Verbose output */
+    verbose?: boolean;
+    /** Callback for progress updates */
+    onProgress?: (phase: string, message: string) => void;
+}
+export interface SetupResult {
+    success: boolean;
+    fastScanComplete: boolean;
+    deepScanComplete: boolean;
+    componentsFound: number;
+    connectionsFound: number;
+    promptsFound: number;
+    diagram?: string;
+    duration: {
+        fastMs: number;
+        deepMs?: number;
+        totalMs: number;
+    };
+    errors: string[];
+}
+/**
+ * Run initial NavGator setup with two-phase scanning
+ */
+export declare function setup(options?: SetupOptions): Promise<SetupResult>;
+/**
+ * Run fast scan only (for quick initial view)
+ */
+export declare function fastSetup(projectPath?: string): Promise<SetupResult>;
+/**
+ * Run full setup with both phases
+ */
+export declare function fullSetup(projectPath?: string): Promise<SetupResult>;
+/**
+ * Check if NavGator has been set up for a project
+ */
+export declare function isSetupComplete(projectPath?: string): Promise<{
+    hasScanned: boolean;
+    lastScan?: Date;
+    phase?: 'fast' | 'deep';
+    stale: boolean;
+}>;
+/**
+ * Get setup status for display
+ */
+export declare function formatSetupStatus(result: SetupResult): string;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAmI5E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAM1E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAO1E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC,CAuBD;AAyDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsC7D"}