spec-gen-cli 1.0.0

package/dist/core/analyzer/repository-mapper.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Repository Mapper
+ *
+ * Combines file walking and significance scoring into a comprehensive "map"
+ * of the repository that guides all subsequent analysis.
+ */
+import type { ProjectType, ScoredFile } from '../../types/index.js';
+import { type ScoringConfig } from './significance-scorer.js';
+/**
+ * Language breakdown in the repository
+ */
+export interface LanguageBreakdown {
+    language: string;
+    extension: string;
+    fileCount: number;
+    percentage: number;
+}
+/**
+ * Detected framework information
+ */
+export interface DetectedFramework {
+    name: string;
+    category: 'frontend' | 'backend' | 'database' | 'testing' | 'auth' | 'ci' | 'other';
+    confidence: 'high' | 'medium' | 'low';
+    evidence: string[];
+}
+/**
+ * Directory statistics
+ */
+export interface DirectoryStats {
+    path: string;
+    fileCount: number;
+    purpose: string;
+    avgScore: number;
+}
+/**
+ * File clusters by domain/layer
+ */
+export interface FileClusters {
+    byDirectory: Record<string, ScoredFile[]>;
+    byDomain: Record<string, ScoredFile[]>;
+    byLayer: {
+        presentation: ScoredFile[];
+        business: ScoredFile[];
+        data: ScoredFile[];
+        infrastructure: ScoredFile[];
+    };
+}
+/**
+ * Repository map metadata
+ */
+export interface RepositoryMapMetadata {
+    projectName: string;
+    projectType: ProjectType;
+    rootPath: string;
+    analyzedAt: string;
+    version: string;
+}
+/**
+ * Repository map summary
+ */
+export interface RepositoryMapSummary {
+    totalFiles: number;
+    analyzedFiles: number;
+    skippedFiles: number;
+    languages: LanguageBreakdown[];
+    frameworks: DetectedFramework[];
+    directories: DirectoryStats[];
+}
+/**
+ * Complete repository map
+ */
+export interface RepositoryMap {
+    metadata: RepositoryMapMetadata;
+    summary: RepositoryMapSummary;
+    highValueFiles: ScoredFile[];
+    entryPoints: ScoredFile[];
+    schemaFiles: ScoredFile[];
+    configFiles: ScoredFile[];
+    clusters: FileClusters;
+    allFiles: ScoredFile[];
+}
+/**
+ * Options for repository mapping
+ */
+export interface RepositoryMapperOptions {
+    /** Maximum files to process */
+    maxFiles?: number;
+    /** Patterns to force-include, overriding gitignore and excludePatterns */
+    includePatterns?: string[];
+    /** Additional patterns to exclude */
+    excludePatterns?: string[];
+    /** Custom scoring configuration */
+    scoringConfig?: ScoringConfig;
+    /** Progress callback */
+    onProgress?: (stage: string, progress: number) => void;
+    /** Output directory for analysis files */
+    outputDir?: string;
+}
+export declare class RepositoryMapper {
+    private rootPath;
+    private options;
+    private packageJson;
+    constructor(rootPath: string, options?: RepositoryMapperOptions);
+    /**
+     * Load package.json if it exists
+     */
+    private loadPackageJson;
+    /**
+     * Get project name from package.json or directory name
+     */
+    private getProjectName;
+    /**
+     * Detect project type
+     */
+    private detectProjectType;
+    /**
+     * Calculate language breakdown
+     */
+    private calculateLanguages;
+    /**
+     * Detect frameworks
+     */
+    private detectFrameworks;
+    /**
+     * Calculate directory statistics
+     */
+    private calculateDirectoryStats;
+    /**
+     * Cluster files by various dimensions
+     */
+    private clusterFiles;
+    /**
+     * Generate the repository map
+     */
+    map(): Promise<RepositoryMap>;
+    /**
+     * Write repository map to output directory
+     */
+    writeOutput(map: RepositoryMap): Promise<void>;
+    /**
+     * Generate human-readable summary
+     */
+    private generateSummaryMarkdown;
+}
+/**
+ * Convenience function to map a repository
+ */
+export declare function mapRepository(rootPath: string, options?: RepositoryMapperOptions): Promise<RepositoryMap>;
+//# sourceMappingURL=repository-mapper.d.ts.map

package/dist/core/analyzer/repository-mapper.d.ts.map

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