@dotcontext/cli 0.8.2 → 0.9.0

package/dist/generators/documentation/codebaseMapGenerator.d.ts

@@ -1,21 +1,15 @@
 /**
  * Codebase Map Generator
  *
- * Generates a JSON file that serves as a quick LLM-readable summary
- * of the entire codebase structure, symbols, and architecture.
+ * Generates a summary JSON file for the codebase structure, stack,
+ * architecture, dependencies, and functional capabilities.
+ *
+ * Symbol payloads are intentionally excluded. Detailed symbol data belongs
+ * to live semantic analysis, not persisted summary artifacts.
  */
 import { RepoStructure } from '../../types';
-import { SemanticContext } from '../../services/semantic';
-import { StackInfo } from '../../services/stack';
-export interface SymbolSummary {
-    name: string;
-    kind: string;
-    file: string;
-    line: number;
-    exported: boolean;
-    signature?: string;
-    description?: string;
-}
+import type { SemanticContext, DetectedFunctionalPatterns } from '../../services/semantic/types';
+import type { StackInfo } from '../../services/stack/stackDetector';
 export interface KeyFile {
     path: string;
     description: string;
@@ -27,9 +21,19 @@ export interface NavigationHints {
     types: string[];
     mainLogic: string[];
 }
+export interface SemanticSnapshotMetadata {
+    schemaVersion: string;
+    generatedAt: string;
+    repoFingerprint: string;
+    analyzer: {
+        useLSP: boolean;
+        includesSymbolPayload: false;
+    };
+}
 export interface CodebaseMap {
     version: string;
     generated: string;
+    meta?: SemanticSnapshotMetadata;
     stack: {
         primaryLanguage: string | null;
         languages: string[];
@@ -42,6 +46,10 @@ export interface CodebaseMap {
         hasCI: boolean;
         nodeVersion?: string;
         runtimeEnvironment?: 'node' | 'browser' | 'both';
+        hasBinField?: boolean;
+        hasMainExport?: boolean;
+        hasTypesField?: boolean;
+        cliLibraries?: string[];
     };
     structure: {
         totalFiles: number;
@@ -74,14 +82,7 @@ export interface CodebaseMap {
         mainEntryPoints?: string[];
         moduleExports?: string[];
     };
-    symbols: {
-        classes: SymbolSummary[];
-        interfaces: SymbolSummary[];
-        functions: SymbolSummary[];
-        types: SymbolSummary[];
-        enums: SymbolSummary[];
-    };
-    publicAPI: SymbolSummary[];
+    functionalPatterns: DetectedFunctionalPatterns;
     dependencies: {
         mostImported: Array<{
             file: string;
@@ -90,6 +91,7 @@ export interface CodebaseMap {
         }>;
     };
     stats: {
+        totalFiles: number;
         totalSymbols: number;
         exportedSymbols: number;
         analysisTimeMs: number;
@@ -98,46 +100,27 @@ export interface CodebaseMap {
     navigation?: NavigationHints;
 }
 export interface CodebaseMapOptions {
-    maxSymbolsPerCategory?: number;
+    maxDependencies?: number;
+    maxKeyFiles?: number;
 }
+export declare function createEmptyFunctionalPatterns(): DetectedFunctionalPatterns;
 export declare class CodebaseMapGenerator {
-    private maxSymbols;
+    private readonly maxDependencies;
+    private readonly maxKeyFiles;
     constructor(options?: CodebaseMapOptions);
-    generate(repoStructure: RepoStructure, semantics?: SemanticContext, stackInfo?: StackInfo): CodebaseMap;
+    generate(repoStructure: RepoStructure, semantics?: SemanticContext, stackInfo?: StackInfo, functionalPatterns?: DetectedFunctionalPatterns, metadata?: SemanticSnapshotMetadata): CodebaseMap;
     private buildStackSection;
     private buildStructureSection;
     private getDirectoryDescription;
     private buildArchitectureSection;
-    /**
-     * Categorize entry points into main (actual CLI/server/library) vs barrel exports
-     */
     private categorizeEntryPoints;
-    private buildSymbolsSection;
-    private buildPublicAPISection;
     private buildDependenciesSection;
-    /**
-     * Infer a description for a file based on its path and name
-     */
     private inferFileDescription;
     private buildStatsSection;
-    private extractSymbols;
-    private toSymbolSummary;
     private relativePath;
-    /**
-     * Build key files section with descriptions and categories
-     */
     private buildKeyFilesSection;
-    /**
-     * Enhance a file description with semantic context if available
-     */
     private enhanceFileDescription;
-    /**
-     * Infer category from file path
-     */
     private inferCategory;
-    /**
-     * Build navigation hints section
-     */
     private buildNavigationSection;
 }
 //# sourceMappingURL=codebaseMapGenerator.d.ts.map

package/dist/generators/documentation/codebaseMapGenerator.d.ts.map

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