@flaid/devmap 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +168 -0
- package/dist/ai/completion.d.ts +7 -0
- package/dist/ai/completion.d.ts.map +1 -0
- package/dist/ai/completion.js +27 -0
- package/dist/ai/completion.js.map +1 -0
- package/dist/ai/contextBuilder.d.ts +42 -0
- package/dist/ai/contextBuilder.d.ts.map +1 -0
- package/dist/ai/contextBuilder.js +632 -0
- package/dist/ai/contextBuilder.js.map +1 -0
- package/dist/ai/groq.d.ts +36 -0
- package/dist/ai/groq.d.ts.map +1 -0
- package/dist/ai/groq.js +368 -0
- package/dist/ai/groq.js.map +1 -0
- package/dist/ai/openrouter.d.ts +20 -0
- package/dist/ai/openrouter.d.ts.map +1 -0
- package/dist/ai/openrouter.js +187 -0
- package/dist/ai/openrouter.js.map +1 -0
- package/dist/ai/prompts.d.ts +7 -0
- package/dist/ai/prompts.d.ts.map +1 -0
- package/dist/ai/prompts.js +88 -0
- package/dist/ai/prompts.js.map +1 -0
- package/dist/ai/provider.d.ts +15 -0
- package/dist/ai/provider.d.ts.map +1 -0
- package/dist/ai/provider.js +28 -0
- package/dist/ai/provider.js.map +1 -0
- package/dist/ai/snapshotEnrichment.d.ts +4 -0
- package/dist/ai/snapshotEnrichment.d.ts.map +1 -0
- package/dist/ai/snapshotEnrichment.js +188 -0
- package/dist/ai/snapshotEnrichment.js.map +1 -0
- package/dist/ai/types.d.ts +29 -0
- package/dist/ai/types.d.ts.map +1 -0
- package/dist/ai/types.js +2 -0
- package/dist/ai/types.js.map +1 -0
- package/dist/analyzers/analysis/extractors/fallbackExtractor.d.ts +30 -0
- package/dist/analyzers/analysis/extractors/fallbackExtractor.d.ts.map +1 -0
- package/dist/analyzers/analysis/extractors/fallbackExtractor.js +114 -0
- package/dist/analyzers/analysis/extractors/fallbackExtractor.js.map +1 -0
- package/dist/analyzers/analysis/extractors/index.d.ts +16 -0
- package/dist/analyzers/analysis/extractors/index.d.ts.map +1 -0
- package/dist/analyzers/analysis/extractors/index.js +135 -0
- package/dist/analyzers/analysis/extractors/index.js.map +1 -0
- package/dist/analyzers/analysis/extractors/prismaExtractor.d.ts +15 -0
- package/dist/analyzers/analysis/extractors/prismaExtractor.d.ts.map +1 -0
- package/dist/analyzers/analysis/extractors/prismaExtractor.js +183 -0
- package/dist/analyzers/analysis/extractors/prismaExtractor.js.map +1 -0
- package/dist/analyzers/analysis/extractors/sqlExtractor.d.ts +14 -0
- package/dist/analyzers/analysis/extractors/sqlExtractor.d.ts.map +1 -0
- package/dist/analyzers/analysis/extractors/sqlExtractor.js +163 -0
- package/dist/analyzers/analysis/extractors/sqlExtractor.js.map +1 -0
- package/dist/analyzers/analysis/extractors/types.d.ts +76 -0
- package/dist/analyzers/analysis/extractors/types.d.ts.map +1 -0
- package/dist/analyzers/analysis/extractors/types.js +2 -0
- package/dist/analyzers/analysis/extractors/types.js.map +1 -0
- package/dist/analyzers/analysis/fileAnalysis.d.ts +36 -0
- package/dist/analyzers/analysis/fileAnalysis.d.ts.map +1 -0
- package/dist/analyzers/analysis/fileAnalysis.js +2 -0
- package/dist/analyzers/analysis/fileAnalysis.js.map +1 -0
- package/dist/analyzers/analysis/fileRole.d.ts +30 -0
- package/dist/analyzers/analysis/fileRole.d.ts.map +1 -0
- package/dist/analyzers/analysis/fileRole.js +242 -0
- package/dist/analyzers/analysis/fileRole.js.map +1 -0
- package/dist/analyzers/analysis/fileScanner.d.ts +10 -0
- package/dist/analyzers/analysis/fileScanner.d.ts.map +1 -0
- package/dist/analyzers/analysis/fileScanner.js +44 -0
- package/dist/analyzers/analysis/fileScanner.js.map +1 -0
- package/dist/analyzers/analysis/filterEngine.d.ts +2 -0
- package/dist/analyzers/analysis/filterEngine.d.ts.map +1 -0
- package/dist/analyzers/analysis/filterEngine.js +110 -0
- package/dist/analyzers/analysis/filterEngine.js.map +1 -0
- package/dist/analyzers/analysis/index.d.ts +12 -0
- package/dist/analyzers/analysis/index.d.ts.map +1 -0
- package/dist/analyzers/analysis/index.js +8 -0
- package/dist/analyzers/analysis/index.js.map +1 -0
- package/dist/analyzers/analysis/preprocessors/astroPreprocessor.d.ts +23 -0
- package/dist/analyzers/analysis/preprocessors/astroPreprocessor.d.ts.map +1 -0
- package/dist/analyzers/analysis/preprocessors/astroPreprocessor.js +40 -0
- package/dist/analyzers/analysis/preprocessors/astroPreprocessor.js.map +1 -0
- package/dist/analyzers/analysis/preprocessors/index.d.ts +5 -0
- package/dist/analyzers/analysis/preprocessors/index.d.ts.map +1 -0
- package/dist/analyzers/analysis/preprocessors/index.js +4 -0
- package/dist/analyzers/analysis/preprocessors/index.js.map +1 -0
- package/dist/analyzers/analysis/preprocessors/sveltePreprocessor.d.ts +27 -0
- package/dist/analyzers/analysis/preprocessors/sveltePreprocessor.d.ts.map +1 -0
- package/dist/analyzers/analysis/preprocessors/sveltePreprocessor.js +50 -0
- package/dist/analyzers/analysis/preprocessors/sveltePreprocessor.js.map +1 -0
- package/dist/analyzers/analysis/preprocessors/types.d.ts +45 -0
- package/dist/analyzers/analysis/preprocessors/types.d.ts.map +1 -0
- package/dist/analyzers/analysis/preprocessors/types.js +2 -0
- package/dist/analyzers/analysis/preprocessors/types.js.map +1 -0
- package/dist/analyzers/analysis/preprocessors/vuePreprocessor.d.ts +21 -0
- package/dist/analyzers/analysis/preprocessors/vuePreprocessor.d.ts.map +1 -0
- package/dist/analyzers/analysis/preprocessors/vuePreprocessor.js +44 -0
- package/dist/analyzers/analysis/preprocessors/vuePreprocessor.js.map +1 -0
- package/dist/analyzers/analysis/tsMorphAnalyzer.d.ts +10 -0
- package/dist/analyzers/analysis/tsMorphAnalyzer.d.ts.map +1 -0
- package/dist/analyzers/analysis/tsMorphAnalyzer.js +190 -0
- package/dist/analyzers/analysis/tsMorphAnalyzer.js.map +1 -0
- package/dist/analyzers/detectors/capabilityDetector.d.ts +28 -0
- package/dist/analyzers/detectors/capabilityDetector.d.ts.map +1 -0
- package/dist/analyzers/detectors/capabilityDetector.js +288 -0
- package/dist/analyzers/detectors/capabilityDetector.js.map +1 -0
- package/dist/analyzers/detectors/databaseDetector.d.ts +7 -0
- package/dist/analyzers/detectors/databaseDetector.d.ts.map +1 -0
- package/dist/analyzers/detectors/databaseDetector.js +71 -0
- package/dist/analyzers/detectors/databaseDetector.js.map +1 -0
- package/dist/analyzers/detectors/frameworkDetector.d.ts +22 -0
- package/dist/analyzers/detectors/frameworkDetector.d.ts.map +1 -0
- package/dist/analyzers/detectors/frameworkDetector.js +160 -0
- package/dist/analyzers/detectors/frameworkDetector.js.map +1 -0
- package/dist/analyzers/detectors/frontendFeatureDetector.d.ts +26 -0
- package/dist/analyzers/detectors/frontendFeatureDetector.d.ts.map +1 -0
- package/dist/analyzers/detectors/frontendFeatureDetector.js +269 -0
- package/dist/analyzers/detectors/frontendFeatureDetector.js.map +1 -0
- package/dist/analyzers/detectors/index.d.ts +11 -0
- package/dist/analyzers/detectors/index.d.ts.map +1 -0
- package/dist/analyzers/detectors/index.js +7 -0
- package/dist/analyzers/detectors/index.js.map +1 -0
- package/dist/analyzers/detectors/nestRouteDetector.d.ts +13 -0
- package/dist/analyzers/detectors/nestRouteDetector.d.ts.map +1 -0
- package/dist/analyzers/detectors/nestRouteDetector.js +69 -0
- package/dist/analyzers/detectors/nestRouteDetector.js.map +1 -0
- package/dist/analyzers/detectors/routeDetector.d.ts +22 -0
- package/dist/analyzers/detectors/routeDetector.d.ts.map +1 -0
- package/dist/analyzers/detectors/routeDetector.js +368 -0
- package/dist/analyzers/detectors/routeDetector.js.map +1 -0
- package/dist/analyzers/detectors/serviceDetector.d.ts +3 -0
- package/dist/analyzers/detectors/serviceDetector.d.ts.map +1 -0
- package/dist/analyzers/detectors/serviceDetector.js +81 -0
- package/dist/analyzers/detectors/serviceDetector.js.map +1 -0
- package/dist/analyzers/features/featureDetector.d.ts +22 -0
- package/dist/analyzers/features/featureDetector.d.ts.map +1 -0
- package/dist/analyzers/features/featureDetector.js +821 -0
- package/dist/analyzers/features/featureDetector.js.map +1 -0
- package/dist/analyzers/features/featureMerge.d.ts +65 -0
- package/dist/analyzers/features/featureMerge.d.ts.map +1 -0
- package/dist/analyzers/features/featureMerge.js +168 -0
- package/dist/analyzers/features/featureMerge.js.map +1 -0
- package/dist/analyzers/features/featureSimilarity.d.ts +152 -0
- package/dist/analyzers/features/featureSimilarity.d.ts.map +1 -0
- package/dist/analyzers/features/featureSimilarity.js +264 -0
- package/dist/analyzers/features/featureSimilarity.js.map +1 -0
- package/dist/analyzers/features/index.d.ts +6 -0
- package/dist/analyzers/features/index.d.ts.map +1 -0
- package/dist/analyzers/features/index.js +4 -0
- package/dist/analyzers/features/index.js.map +1 -0
- package/dist/analyzers/graph/dependencyGraph.d.ts +5 -0
- package/dist/analyzers/graph/dependencyGraph.d.ts.map +1 -0
- package/dist/analyzers/graph/dependencyGraph.js +88 -0
- package/dist/analyzers/graph/dependencyGraph.js.map +1 -0
- package/dist/analyzers/graph/dependencyMap.d.ts +43 -0
- package/dist/analyzers/graph/dependencyMap.d.ts.map +1 -0
- package/dist/analyzers/graph/dependencyMap.js +85 -0
- package/dist/analyzers/graph/dependencyMap.js.map +1 -0
- package/dist/analyzers/graph/entryPoints.d.ts +3 -0
- package/dist/analyzers/graph/entryPoints.d.ts.map +1 -0
- package/dist/analyzers/graph/entryPoints.js +21 -0
- package/dist/analyzers/graph/entryPoints.js.map +1 -0
- package/dist/analyzers/graph/index.d.ts +7 -0
- package/dist/analyzers/graph/index.d.ts.map +1 -0
- package/dist/analyzers/graph/index.js +5 -0
- package/dist/analyzers/graph/index.js.map +1 -0
- package/dist/analyzers/graph/sourceScope.d.ts +2 -0
- package/dist/analyzers/graph/sourceScope.d.ts.map +1 -0
- package/dist/analyzers/graph/sourceScope.js +30 -0
- package/dist/analyzers/graph/sourceScope.js.map +1 -0
- package/dist/analyzers/inference/domainInference.d.ts +58 -0
- package/dist/analyzers/inference/domainInference.d.ts.map +1 -0
- package/dist/analyzers/inference/domainInference.js +234 -0
- package/dist/analyzers/inference/domainInference.js.map +1 -0
- package/dist/analyzers/inference/index.d.ts +5 -0
- package/dist/analyzers/inference/index.d.ts.map +1 -0
- package/dist/analyzers/inference/index.js +3 -0
- package/dist/analyzers/inference/index.js.map +1 -0
- package/dist/analyzers/inference/ownershipTopology.d.ts +8 -0
- package/dist/analyzers/inference/ownershipTopology.d.ts.map +1 -0
- package/dist/analyzers/inference/ownershipTopology.js +65 -0
- package/dist/analyzers/inference/ownershipTopology.js.map +1 -0
- package/dist/analyzers/pipeline/analyzerRegistry.d.ts +9 -0
- package/dist/analyzers/pipeline/analyzerRegistry.d.ts.map +1 -0
- package/dist/analyzers/pipeline/analyzerRegistry.js +35 -0
- package/dist/analyzers/pipeline/analyzerRegistry.js.map +1 -0
- package/dist/analyzers/pipeline/heuristicAnalyzer.d.ts +12 -0
- package/dist/analyzers/pipeline/heuristicAnalyzer.d.ts.map +1 -0
- package/dist/analyzers/pipeline/heuristicAnalyzer.js +150 -0
- package/dist/analyzers/pipeline/heuristicAnalyzer.js.map +1 -0
- package/dist/analyzers/pipeline/index.d.ts +7 -0
- package/dist/analyzers/pipeline/index.d.ts.map +1 -0
- package/dist/analyzers/pipeline/index.js +5 -0
- package/dist/analyzers/pipeline/index.js.map +1 -0
- package/dist/analyzers/pipeline/projectMap.d.ts +120 -0
- package/dist/analyzers/pipeline/projectMap.d.ts.map +1 -0
- package/dist/analyzers/pipeline/projectMap.js +726 -0
- package/dist/analyzers/pipeline/projectMap.js.map +1 -0
- package/dist/analyzers/pipeline/projectMetadata.d.ts +19 -0
- package/dist/analyzers/pipeline/projectMetadata.d.ts.map +1 -0
- package/dist/analyzers/pipeline/projectMetadata.js +149 -0
- package/dist/analyzers/pipeline/projectMetadata.js.map +1 -0
- package/dist/analyzers/pipeline/reasonTags.d.ts +6 -0
- package/dist/analyzers/pipeline/reasonTags.d.ts.map +1 -0
- package/dist/analyzers/pipeline/reasonTags.js +6 -0
- package/dist/analyzers/pipeline/reasonTags.js.map +1 -0
- package/dist/analyzers/registry/ai-providers.d.ts +3 -0
- package/dist/analyzers/registry/ai-providers.d.ts.map +1 -0
- package/dist/analyzers/registry/ai-providers.js +94 -0
- package/dist/analyzers/registry/ai-providers.js.map +1 -0
- package/dist/analyzers/registry/analytics.d.ts +3 -0
- package/dist/analyzers/registry/analytics.d.ts.map +1 -0
- package/dist/analyzers/registry/analytics.js +15 -0
- package/dist/analyzers/registry/analytics.js.map +1 -0
- package/dist/analyzers/registry/auth.d.ts +3 -0
- package/dist/analyzers/registry/auth.d.ts.map +1 -0
- package/dist/analyzers/registry/auth.js +18 -0
- package/dist/analyzers/registry/auth.js.map +1 -0
- package/dist/analyzers/registry/background-jobs.d.ts +3 -0
- package/dist/analyzers/registry/background-jobs.d.ts.map +1 -0
- package/dist/analyzers/registry/background-jobs.js +14 -0
- package/dist/analyzers/registry/background-jobs.js.map +1 -0
- package/dist/analyzers/registry/caching.d.ts +3 -0
- package/dist/analyzers/registry/caching.d.ts.map +1 -0
- package/dist/analyzers/registry/caching.js +13 -0
- package/dist/analyzers/registry/caching.js.map +1 -0
- package/dist/analyzers/registry/cms-content.d.ts +3 -0
- package/dist/analyzers/registry/cms-content.d.ts.map +1 -0
- package/dist/analyzers/registry/cms-content.js +15 -0
- package/dist/analyzers/registry/cms-content.js.map +1 -0
- package/dist/analyzers/registry/database.d.ts +3 -0
- package/dist/analyzers/registry/database.d.ts.map +1 -0
- package/dist/analyzers/registry/database.js +13 -0
- package/dist/analyzers/registry/database.js.map +1 -0
- package/dist/analyzers/registry/email.d.ts +3 -0
- package/dist/analyzers/registry/email.d.ts.map +1 -0
- package/dist/analyzers/registry/email.js +19 -0
- package/dist/analyzers/registry/email.js.map +1 -0
- package/dist/analyzers/registry/file-upload.d.ts +3 -0
- package/dist/analyzers/registry/file-upload.d.ts.map +1 -0
- package/dist/analyzers/registry/file-upload.js +19 -0
- package/dist/analyzers/registry/file-upload.js.map +1 -0
- package/dist/analyzers/registry/firebase.d.ts +3 -0
- package/dist/analyzers/registry/firebase.d.ts.map +1 -0
- package/dist/analyzers/registry/firebase.js +8 -0
- package/dist/analyzers/registry/firebase.js.map +1 -0
- package/dist/analyzers/registry/index.d.ts +16 -0
- package/dist/analyzers/registry/index.d.ts.map +1 -0
- package/dist/analyzers/registry/index.js +88 -0
- package/dist/analyzers/registry/index.js.map +1 -0
- package/dist/analyzers/registry/internationalization.d.ts +3 -0
- package/dist/analyzers/registry/internationalization.d.ts.map +1 -0
- package/dist/analyzers/registry/internationalization.js +13 -0
- package/dist/analyzers/registry/internationalization.js.map +1 -0
- package/dist/analyzers/registry/logging-monitoring.d.ts +3 -0
- package/dist/analyzers/registry/logging-monitoring.d.ts.map +1 -0
- package/dist/analyzers/registry/logging-monitoring.js +14 -0
- package/dist/analyzers/registry/logging-monitoring.js.map +1 -0
- package/dist/analyzers/registry/notifications.d.ts +3 -0
- package/dist/analyzers/registry/notifications.d.ts.map +1 -0
- package/dist/analyzers/registry/notifications.js +14 -0
- package/dist/analyzers/registry/notifications.js.map +1 -0
- package/dist/analyzers/registry/payments.d.ts +3 -0
- package/dist/analyzers/registry/payments.d.ts.map +1 -0
- package/dist/analyzers/registry/payments.js +23 -0
- package/dist/analyzers/registry/payments.js.map +1 -0
- package/dist/analyzers/registry/rate-limiting.d.ts +3 -0
- package/dist/analyzers/registry/rate-limiting.d.ts.map +1 -0
- package/dist/analyzers/registry/rate-limiting.js +13 -0
- package/dist/analyzers/registry/rate-limiting.js.map +1 -0
- package/dist/analyzers/registry/search.d.ts +3 -0
- package/dist/analyzers/registry/search.d.ts.map +1 -0
- package/dist/analyzers/registry/search.js +15 -0
- package/dist/analyzers/registry/search.js.map +1 -0
- package/dist/analyzers/registry/testing.d.ts +3 -0
- package/dist/analyzers/registry/testing.d.ts.map +1 -0
- package/dist/analyzers/registry/testing.js +13 -0
- package/dist/analyzers/registry/testing.js.map +1 -0
- package/dist/analyzers/registry/types.d.ts +14 -0
- package/dist/analyzers/registry/types.d.ts.map +1 -0
- package/dist/analyzers/registry/types.js +2 -0
- package/dist/analyzers/registry/types.js.map +1 -0
- package/dist/cache/agentNavigation.d.ts +7 -0
- package/dist/cache/agentNavigation.d.ts.map +1 -0
- package/dist/cache/agentNavigation.js +253 -0
- package/dist/cache/agentNavigation.js.map +1 -0
- package/dist/cache/fileHash.d.ts +2 -0
- package/dist/cache/fileHash.d.ts.map +1 -0
- package/dist/cache/fileHash.js +5 -0
- package/dist/cache/fileHash.js.map +1 -0
- package/dist/cache/snapshot.d.ts +20 -0
- package/dist/cache/snapshot.d.ts.map +1 -0
- package/dist/cache/snapshot.js +184 -0
- package/dist/cache/snapshot.js.map +1 -0
- package/dist/commands/analyze.d.ts +12 -0
- package/dist/commands/analyze.d.ts.map +1 -0
- package/dist/commands/analyze.js +201 -0
- package/dist/commands/analyze.js.map +1 -0
- package/dist/commands/config.d.ts +10 -0
- package/dist/commands/config.d.ts.map +1 -0
- package/dist/commands/config.js +65 -0
- package/dist/commands/config.js.map +1 -0
- package/dist/commands/doctor.d.ts +11 -0
- package/dist/commands/doctor.d.ts.map +1 -0
- package/dist/commands/doctor.js +141 -0
- package/dist/commands/doctor.js.map +1 -0
- package/dist/commands/explain.d.ts +37 -0
- package/dist/commands/explain.d.ts.map +1 -0
- package/dist/commands/explain.js +101 -0
- package/dist/commands/explain.js.map +1 -0
- package/dist/commands/flow.d.ts +34 -0
- package/dist/commands/flow.d.ts.map +1 -0
- package/dist/commands/flow.js +151 -0
- package/dist/commands/flow.js.map +1 -0
- package/dist/commands/init.d.ts +16 -0
- package/dist/commands/init.d.ts.map +1 -0
- package/dist/commands/init.js +197 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/map.d.ts +24 -0
- package/dist/commands/map.d.ts.map +1 -0
- package/dist/commands/map.js +282 -0
- package/dist/commands/map.js.map +1 -0
- package/dist/commands/onboarding.d.ts +36 -0
- package/dist/commands/onboarding.d.ts.map +1 -0
- package/dist/commands/onboarding.js +226 -0
- package/dist/commands/onboarding.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +104 -0
- package/dist/index.js.map +1 -0
- package/dist/onboarding/model.d.ts +27 -0
- package/dist/onboarding/model.d.ts.map +1 -0
- package/dist/onboarding/model.js +2 -0
- package/dist/onboarding/model.js.map +1 -0
- package/dist/onboarding/modelBuilder.d.ts +4 -0
- package/dist/onboarding/modelBuilder.d.ts.map +1 -0
- package/dist/onboarding/modelBuilder.js +330 -0
- package/dist/onboarding/modelBuilder.js.map +1 -0
- package/dist/utils/agentsFile.d.ts +6 -0
- package/dist/utils/agentsFile.d.ts.map +1 -0
- package/dist/utils/agentsFile.js +85 -0
- package/dist/utils/agentsFile.js.map +1 -0
- package/dist/utils/config.d.ts +20 -0
- package/dist/utils/config.d.ts.map +1 -0
- package/dist/utils/config.js +88 -0
- package/dist/utils/config.js.map +1 -0
- package/dist/utils/devmapFile.d.ts +3 -0
- package/dist/utils/devmapFile.d.ts.map +1 -0
- package/dist/utils/devmapFile.js +43 -0
- package/dist/utils/devmapFile.js.map +1 -0
- package/dist/utils/errors.d.ts +8 -0
- package/dist/utils/errors.d.ts.map +1 -0
- package/dist/utils/errors.js +92 -0
- package/dist/utils/errors.js.map +1 -0
- package/dist/utils/gitignore.d.ts +2 -0
- package/dist/utils/gitignore.d.ts.map +1 -0
- package/dist/utils/gitignore.js +22 -0
- package/dist/utils/gitignore.js.map +1 -0
- package/dist/utils/help.d.ts +3 -0
- package/dist/utils/help.d.ts.map +1 -0
- package/dist/utils/help.js +19 -0
- package/dist/utils/help.js.map +1 -0
- package/dist/utils/mapRenderer.d.ts +39 -0
- package/dist/utils/mapRenderer.d.ts.map +1 -0
- package/dist/utils/mapRenderer.js +90 -0
- package/dist/utils/mapRenderer.js.map +1 -0
- package/dist/utils/markdownTerminal.d.ts +6 -0
- package/dist/utils/markdownTerminal.d.ts.map +1 -0
- package/dist/utils/markdownTerminal.js +153 -0
- package/dist/utils/markdownTerminal.js.map +1 -0
- package/dist/utils/output.d.ts +29 -0
- package/dist/utils/output.d.ts.map +1 -0
- package/dist/utils/output.js +108 -0
- package/dist/utils/output.js.map +1 -0
- package/dist/utils/packageMetadata.d.ts +2 -0
- package/dist/utils/packageMetadata.d.ts.map +1 -0
- package/dist/utils/packageMetadata.js +5 -0
- package/dist/utils/packageMetadata.js.map +1 -0
- package/dist/utils/prompt.d.ts +11 -0
- package/dist/utils/prompt.d.ts.map +1 -0
- package/dist/utils/prompt.js +81 -0
- package/dist/utils/prompt.js.map +1 -0
- package/dist/utils/slug.d.ts +2 -0
- package/dist/utils/slug.d.ts.map +1 -0
- package/dist/utils/slug.js +8 -0
- package/dist/utils/slug.js.map +1 -0
- package/dist/utils/targetResolver.d.ts +7 -0
- package/dist/utils/targetResolver.d.ts.map +1 -0
- package/dist/utils/targetResolver.js +15 -0
- package/dist/utils/targetResolver.js.map +1 -0
- package/dist/utils/welcome.d.ts +10 -0
- package/dist/utils/welcome.d.ts.map +1 -0
- package/dist/utils/welcome.js +80 -0
- package/dist/utils/welcome.js.map +1 -0
- package/package.json +61 -0
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
import { resolve } from "node:path";
|
|
2
|
+
import { completeWithOptionalStreaming } from "../ai/completion.js";
|
|
3
|
+
import { createAiClient as createDefaultAiClient, resolveAiRouting } from "../ai/provider.js";
|
|
4
|
+
import { buildAnalyzeMessages } from "../ai/prompts.js";
|
|
5
|
+
import { enrichSnapshotWithAi } from "../ai/snapshotEnrichment.js";
|
|
6
|
+
import { createProjectMap } from "../analyzers/pipeline/index.js";
|
|
7
|
+
import { inspectSnapshot, saveSnapshot } from "../cache/snapshot.js";
|
|
8
|
+
import { writeAgentNavigationFiles } from "../cache/agentNavigation.js";
|
|
9
|
+
import { resolveEffectiveConfig } from "../utils/config.js";
|
|
10
|
+
import { DevmapError } from "../utils/errors.js";
|
|
11
|
+
import { output, withJsonOutput } from "../utils/output.js";
|
|
12
|
+
export async function analyzeCommand(target = ".", options = {}, dependencies = {}) {
|
|
13
|
+
if (options.json) {
|
|
14
|
+
await withJsonOutput(async () => {
|
|
15
|
+
const snapshot = await runAnalyze(target, options, dependencies);
|
|
16
|
+
output.json(snapshot);
|
|
17
|
+
});
|
|
18
|
+
return;
|
|
19
|
+
}
|
|
20
|
+
await runAnalyze(target, options, dependencies);
|
|
21
|
+
}
|
|
22
|
+
async function runAnalyze(target, options, dependencies) {
|
|
23
|
+
const projectRoot = resolve(target);
|
|
24
|
+
output.section("DevMap Analyze");
|
|
25
|
+
output.step(`Scanning ${projectRoot}`);
|
|
26
|
+
// Build callAI wrapper — dipakai oleh domain inference (Step 5) di createProjectMap.
|
|
27
|
+
// Dibuat di sini biar analyze command yang kontrol config + client lifecycle,
|
|
28
|
+
// sementara projectMap tetap decoupled dari AI provider specifics.
|
|
29
|
+
const callAI = await buildCallAI(projectRoot, dependencies);
|
|
30
|
+
let snapshot = await createProjectMap(projectRoot, callAI);
|
|
31
|
+
const previous = options.fresh ? { status: "missing" } : await inspectSnapshot(projectRoot);
|
|
32
|
+
if (previous.status === "valid" && previous.snapshot.fingerprint === snapshot.fingerprint) {
|
|
33
|
+
await writeAgentNavigationFiles(projectRoot, previous.snapshot);
|
|
34
|
+
printSnapshot(previous.snapshot);
|
|
35
|
+
output.success("Project is unchanged. Reused existing snapshot.");
|
|
36
|
+
return printOrGenerateInterpretation(projectRoot, previous.snapshot, options, dependencies);
|
|
37
|
+
}
|
|
38
|
+
snapshot = await enrichSnapshot(snapshot, projectRoot, options, dependencies);
|
|
39
|
+
await saveSnapshot(projectRoot, snapshot);
|
|
40
|
+
await writeAgentNavigationFiles(projectRoot, snapshot);
|
|
41
|
+
printSnapshot(snapshot);
|
|
42
|
+
output.success("Snapshot saved to .devmap/snapshot.json");
|
|
43
|
+
output.success("Agent navigation saved to .devmap/index.json and .devmap/features/");
|
|
44
|
+
if (options.fresh) {
|
|
45
|
+
output.success("Fresh analysis completed");
|
|
46
|
+
}
|
|
47
|
+
return printOrGenerateInterpretation(projectRoot, snapshot, options, dependencies);
|
|
48
|
+
}
|
|
49
|
+
async function enrichSnapshot(snapshot, projectRoot, options, dependencies) {
|
|
50
|
+
const loadConfig = dependencies.loadConfig
|
|
51
|
+
?? (() => resolveEffectiveConfig(projectRoot));
|
|
52
|
+
const config = await loadConfig();
|
|
53
|
+
if (!config?.apiKey) {
|
|
54
|
+
return snapshot;
|
|
55
|
+
}
|
|
56
|
+
const createAiClient = dependencies.createAiClient
|
|
57
|
+
?? createDefaultAiClient;
|
|
58
|
+
const client = createAiClient(config);
|
|
59
|
+
const routing = resolveAiRouting(config, "analyze");
|
|
60
|
+
const enriched = await enrichSnapshotWithAi(snapshot, client, routing.model, routing.fallbackModels);
|
|
61
|
+
if (enriched !== snapshot) {
|
|
62
|
+
output.note("Snapshot file index enriched with AI metadata.");
|
|
63
|
+
}
|
|
64
|
+
return enriched;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* buildCallAI — build callAI wrapper untuk domain inference di createProjectMap.
|
|
68
|
+
*
|
|
69
|
+
* Return undefined kalau config tidak ada atau apiKey tidak di-set —
|
|
70
|
+
* createProjectMap akan skip domain inference dan hanya jalankan static analysis.
|
|
71
|
+
*
|
|
72
|
+
* Wrapper ini intentionally simple: satu user message, satu string response.
|
|
73
|
+
* Domain inference prompt sudah structured di domainInference.ts — tidak perlu
|
|
74
|
+
* system prompt tambahan di sini.
|
|
75
|
+
*/
|
|
76
|
+
async function buildCallAI(projectRoot, dependencies) {
|
|
77
|
+
const loadConfig = dependencies.loadConfig
|
|
78
|
+
?? (() => resolveEffectiveConfig(projectRoot));
|
|
79
|
+
const config = await loadConfig();
|
|
80
|
+
if (!config?.apiKey)
|
|
81
|
+
return undefined;
|
|
82
|
+
const createAiClient = dependencies.createAiClient ?? createDefaultAiClient;
|
|
83
|
+
const client = createAiClient(config);
|
|
84
|
+
const routing = resolveAiRouting(config, "analyze");
|
|
85
|
+
return async (prompt) => {
|
|
86
|
+
const result = await client.complete({
|
|
87
|
+
messages: [{ role: "user", content: prompt }],
|
|
88
|
+
model: routing.model,
|
|
89
|
+
fallbackModels: routing.fallbackModels,
|
|
90
|
+
maxCompletionTokens: 600, // domain inference gak butuh banyak token
|
|
91
|
+
temperature: 0.1 // low temperature buat consistent JSON output
|
|
92
|
+
});
|
|
93
|
+
return result.content;
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
function printSnapshot(snapshot) {
|
|
97
|
+
output.keyValue("Project", snapshot.project.name);
|
|
98
|
+
output.keyValue("Framework", snapshot.project.framework);
|
|
99
|
+
output.keyValue("Workspace Frameworks", snapshot.project.frameworks.join(", ") || "none detected");
|
|
100
|
+
output.keyValue("Language", snapshot.project.language);
|
|
101
|
+
output.keyValue("Package Manager", snapshot.project.packageManager);
|
|
102
|
+
output.keyValue("Files", snapshot.stats.relevantFiles);
|
|
103
|
+
output.keyValue("Lines", snapshot.stats.totalLines);
|
|
104
|
+
for (const warning of snapshot.warnings ?? []) {
|
|
105
|
+
output.warning(warning);
|
|
106
|
+
output.note("Fix package.json and run devmap analyze --fresh.");
|
|
107
|
+
}
|
|
108
|
+
printList("Entry Points", snapshot.entryPoints);
|
|
109
|
+
printList("Critical Files", snapshot.criticalFiles.map((file) => `${file.path} (${file.reasons.join(", ")})`));
|
|
110
|
+
printList("Routes", snapshot.routes.map((route) => `${route.path} -> ${route.file}`));
|
|
111
|
+
printList("External Services", snapshot.externalServices);
|
|
112
|
+
printList("Features", snapshot.features.map((feature) => feature.name));
|
|
113
|
+
if (snapshot.domain) {
|
|
114
|
+
output.section("Domain");
|
|
115
|
+
output.keyValue("Type", snapshot.domain.domain);
|
|
116
|
+
output.item(snapshot.domain.summary);
|
|
117
|
+
}
|
|
118
|
+
if (snapshot.database) {
|
|
119
|
+
output.section("Database");
|
|
120
|
+
output.item(snapshot.database.provider);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
function printList(title, values) {
|
|
124
|
+
output.section(title);
|
|
125
|
+
if (values.length === 0) {
|
|
126
|
+
output.note("None detected yet");
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
for (const value of values) {
|
|
130
|
+
output.item(value);
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
async function printOrGenerateInterpretation(projectRoot, snapshot, options, dependencies) {
|
|
134
|
+
if (snapshot.ai && !options.fresh) {
|
|
135
|
+
output.section("Architecture");
|
|
136
|
+
output.markdown(snapshot.ai.architecture);
|
|
137
|
+
output.note(formatAiMetadata(snapshot.ai.model, snapshot.ai.usage, true));
|
|
138
|
+
return snapshot;
|
|
139
|
+
}
|
|
140
|
+
const loadConfig = dependencies.loadConfig
|
|
141
|
+
?? (() => resolveEffectiveConfig(projectRoot));
|
|
142
|
+
const config = await loadConfig();
|
|
143
|
+
if (!config?.apiKey) {
|
|
144
|
+
output.note("AI architecture interpretation is not configured. Run devmap init to enable it.");
|
|
145
|
+
return snapshot;
|
|
146
|
+
}
|
|
147
|
+
const createAiClient = dependencies.createAiClient
|
|
148
|
+
?? createDefaultAiClient;
|
|
149
|
+
const client = createAiClient(config);
|
|
150
|
+
const routing = resolveAiRouting(config, "analyze");
|
|
151
|
+
const model = routing.model;
|
|
152
|
+
output.step(`Interpreting architecture with ${model}`);
|
|
153
|
+
try {
|
|
154
|
+
const execution = await completeWithOptionalStreaming(client, {
|
|
155
|
+
messages: buildAnalyzeMessages(snapshot),
|
|
156
|
+
model,
|
|
157
|
+
fallbackModels: routing.fallbackModels,
|
|
158
|
+
maxCompletionTokens: 1800,
|
|
159
|
+
temperature: 0.2
|
|
160
|
+
}, !options.json, () => output.section("Architecture"));
|
|
161
|
+
const interpretation = execution.result;
|
|
162
|
+
const updatedSnapshot = {
|
|
163
|
+
...snapshot,
|
|
164
|
+
ai: {
|
|
165
|
+
architecture: interpretation.content,
|
|
166
|
+
model: interpretation.model,
|
|
167
|
+
generatedAt: new Date().toISOString(),
|
|
168
|
+
...(interpretation.usage ? { usage: interpretation.usage } : {})
|
|
169
|
+
}
|
|
170
|
+
};
|
|
171
|
+
await saveSnapshot(projectRoot, updatedSnapshot);
|
|
172
|
+
if (!execution.streamed) {
|
|
173
|
+
output.section("Architecture");
|
|
174
|
+
output.markdown(interpretation.content);
|
|
175
|
+
}
|
|
176
|
+
output.note(formatAiMetadata(interpretation.model, interpretation.usage, false));
|
|
177
|
+
return updatedSnapshot;
|
|
178
|
+
}
|
|
179
|
+
catch (error) {
|
|
180
|
+
if (!(error instanceof DevmapError)) {
|
|
181
|
+
throw error;
|
|
182
|
+
}
|
|
183
|
+
output.warning(error.message);
|
|
184
|
+
if (error.hint) {
|
|
185
|
+
output.note(`Tip: ${error.hint}`);
|
|
186
|
+
}
|
|
187
|
+
output.note("Static analysis and snapshot were still completed successfully.");
|
|
188
|
+
return snapshot;
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
function formatAiMetadata(model, usage, cached) {
|
|
192
|
+
const values = [
|
|
193
|
+
`Model: ${model}`,
|
|
194
|
+
cached ? "Cached: yes" : "Cached: no"
|
|
195
|
+
];
|
|
196
|
+
if (usage) {
|
|
197
|
+
values.push(`Total tokens: ${usage.totalTokens}`);
|
|
198
|
+
}
|
|
199
|
+
return values.join(" | ");
|
|
200
|
+
}
|
|
201
|
+
//# sourceMappingURL=analyze.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { type DevmapConfig } from "../utils/config.js";
|
|
2
|
+
export type ConfigDependencies = {
|
|
3
|
+
json?: boolean;
|
|
4
|
+
local?: boolean;
|
|
5
|
+
projectRoot?: string;
|
|
6
|
+
loadConfig?: () => Promise<DevmapConfig | null>;
|
|
7
|
+
persistConfig?: (config: DevmapConfig) => Promise<void>;
|
|
8
|
+
};
|
|
9
|
+
export declare function configModelCommand(model: string, dependencies?: ConfigDependencies): Promise<void>;
|
|
10
|
+
//# sourceMappingURL=config.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,YAAY,GAAE,kBAAuB,GACpC,OAAO,CAAC,IAAI,CAAC,CASf"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { resolve } from "node:path";
|
|
2
|
+
import { readConfig, writeConfig, writeLocalConfig } from "../utils/config.js";
|
|
3
|
+
import { output, withJsonOutput } from "../utils/output.js";
|
|
4
|
+
export async function configModelCommand(model, dependencies = {}) {
|
|
5
|
+
if (dependencies.json) {
|
|
6
|
+
await withJsonOutput(async () => {
|
|
7
|
+
output.json(await updateModel(model, dependencies));
|
|
8
|
+
});
|
|
9
|
+
return;
|
|
10
|
+
}
|
|
11
|
+
await updateModel(model, dependencies);
|
|
12
|
+
}
|
|
13
|
+
async function updateModel(model, dependencies) {
|
|
14
|
+
const selectedModel = model.trim();
|
|
15
|
+
if (!selectedModel) {
|
|
16
|
+
output.error("Model name cannot be empty.");
|
|
17
|
+
return { status: "error", error: "Model name cannot be empty." };
|
|
18
|
+
}
|
|
19
|
+
const loadConfig = dependencies.loadConfig ?? readConfig;
|
|
20
|
+
const persistConfig = dependencies.persistConfig ?? writeConfig;
|
|
21
|
+
const config = await loadConfig();
|
|
22
|
+
if (!config) {
|
|
23
|
+
output.error("DevMap is not configured yet.");
|
|
24
|
+
output.note("Run devmap init before changing the model.");
|
|
25
|
+
return {
|
|
26
|
+
status: "error",
|
|
27
|
+
error: "DevMap is not configured yet.",
|
|
28
|
+
hint: "Run devmap init before changing the model."
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
if (dependencies.local) {
|
|
32
|
+
const projectRoot = resolve(dependencies.projectRoot ?? process.cwd());
|
|
33
|
+
await writeLocalConfig(projectRoot, { model: selectedModel });
|
|
34
|
+
output.success(`Project model override set to ${selectedModel} (.devmap/config.local.json).`);
|
|
35
|
+
return {
|
|
36
|
+
status: "ok",
|
|
37
|
+
scope: "local",
|
|
38
|
+
provider: config.provider,
|
|
39
|
+
model: selectedModel,
|
|
40
|
+
automaticRouting: selectedModel === "auto",
|
|
41
|
+
...(selectedModel === "auto" && config.provider === "openrouter"
|
|
42
|
+
? { resolvedModel: "openrouter/free" }
|
|
43
|
+
: {})
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
await persistConfig({
|
|
47
|
+
...config,
|
|
48
|
+
model: selectedModel
|
|
49
|
+
});
|
|
50
|
+
output.success(selectedModel === "auto"
|
|
51
|
+
? config.provider === "openrouter"
|
|
52
|
+
? "Restored OpenRouter free model routing (openrouter/free)."
|
|
53
|
+
: "Restored automatic command-based model routing."
|
|
54
|
+
: `Default model override set to ${selectedModel}.`);
|
|
55
|
+
return {
|
|
56
|
+
status: "ok",
|
|
57
|
+
provider: config.provider,
|
|
58
|
+
model: selectedModel,
|
|
59
|
+
automaticRouting: selectedModel === "auto",
|
|
60
|
+
...(selectedModel === "auto" && config.provider === "openrouter"
|
|
61
|
+
? { resolvedModel: "openrouter/free" }
|
|
62
|
+
: {})
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
//# sourceMappingURL=config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { type ProviderInspection } from "../ai/provider.js";
|
|
2
|
+
import { type DevmapConfig, type LocalDevmapConfig } from "../utils/config.js";
|
|
3
|
+
export type DoctorDependencies = {
|
|
4
|
+
json?: boolean;
|
|
5
|
+
projectRoot?: string;
|
|
6
|
+
loadConfig?: () => Promise<DevmapConfig | null>;
|
|
7
|
+
loadLocalConfig?: (projectRoot: string) => Promise<LocalDevmapConfig | null>;
|
|
8
|
+
inspectProvider?: (apiKey: string, model: string, provider: DevmapConfig["provider"]) => Promise<ProviderInspection>;
|
|
9
|
+
};
|
|
10
|
+
export declare function doctorCommand(dependencies?: DoctorDependencies): Promise<void>;
|
|
11
|
+
//# sourceMappingURL=doctor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAO5B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC7E,eAAe,CAAC,EAAE,CAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,KAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAsB,aAAa,CACjC,YAAY,GAAE,kBAAuB,GACpC,OAAO,CAAC,IAAI,CAAC,CASf"}
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
import { arch, platform } from "node:os";
|
|
2
|
+
import { resolve } from "node:path";
|
|
3
|
+
import { inspectAiProvider, resolveAiRouting } from "../ai/provider.js";
|
|
4
|
+
import { scanFiles } from "../analyzers/analysis/index.js";
|
|
5
|
+
import { detectFramework, detectFrameworks } from "../analyzers/detectors/index.js";
|
|
6
|
+
import { detectProjectMetadata } from "../analyzers/pipeline/index.js";
|
|
7
|
+
import { inspectSnapshot } from "../cache/snapshot.js";
|
|
8
|
+
import { readConfig, readLocalConfig } from "../utils/config.js";
|
|
9
|
+
import { DevmapError } from "../utils/errors.js";
|
|
10
|
+
import { output, withJsonOutput } from "../utils/output.js";
|
|
11
|
+
import { DEVMAP_VERSION } from "../utils/packageMetadata.js";
|
|
12
|
+
const MINIMUM_NODE_MAJOR = 18;
|
|
13
|
+
export async function doctorCommand(dependencies = {}) {
|
|
14
|
+
if (dependencies.json) {
|
|
15
|
+
await withJsonOutput(async () => {
|
|
16
|
+
output.json(await runDoctor(dependencies));
|
|
17
|
+
});
|
|
18
|
+
return;
|
|
19
|
+
}
|
|
20
|
+
await runDoctor(dependencies);
|
|
21
|
+
}
|
|
22
|
+
async function runDoctor(dependencies) {
|
|
23
|
+
const projectRoot = resolve(dependencies.projectRoot ?? process.cwd());
|
|
24
|
+
const loadConfig = dependencies.loadConfig ?? readConfig;
|
|
25
|
+
const loadLocalConfig = dependencies.loadLocalConfig ?? readLocalConfig;
|
|
26
|
+
const inspectProvider = dependencies.inspectProvider
|
|
27
|
+
?? ((apiKey, model, provider) => (inspectAiProvider(provider, apiKey, model)));
|
|
28
|
+
const [config, localConfig, snapshotResult, files] = await Promise.all([
|
|
29
|
+
loadConfig(),
|
|
30
|
+
loadLocalConfig(projectRoot),
|
|
31
|
+
inspectSnapshot(projectRoot),
|
|
32
|
+
scanFiles(projectRoot)
|
|
33
|
+
]);
|
|
34
|
+
const framework = detectFramework(files);
|
|
35
|
+
const frameworks = detectFrameworks(files);
|
|
36
|
+
const project = detectProjectMetadata(projectRoot, framework, files, frameworks);
|
|
37
|
+
const modelSource = config && localConfig?.model
|
|
38
|
+
? "project override"
|
|
39
|
+
: "global";
|
|
40
|
+
const effectiveConfig = config && localConfig?.model
|
|
41
|
+
? { ...config, model: localConfig.model }
|
|
42
|
+
: config;
|
|
43
|
+
const selectedModel = effectiveConfig
|
|
44
|
+
? resolveAiRouting(effectiveConfig, "analyze").model
|
|
45
|
+
: undefined;
|
|
46
|
+
const issues = [];
|
|
47
|
+
const nodeSupported = readNodeMajor(process.version) >= MINIMUM_NODE_MAJOR;
|
|
48
|
+
let apiKeyStatus = "not configured";
|
|
49
|
+
let modelStatus = selectedModel ?? "not configured";
|
|
50
|
+
output.section("DevMap Doctor");
|
|
51
|
+
output.keyValue("DevMap", DEVMAP_VERSION);
|
|
52
|
+
output.keyValue("Node.js", `${process.version} (${nodeSupported ? "supported" : "unsupported"})`);
|
|
53
|
+
output.keyValue("OS", `${platform()}/${arch()}`);
|
|
54
|
+
output.keyValue("Project", project.name);
|
|
55
|
+
output.keyValue("Framework", project.framework);
|
|
56
|
+
output.keyValue("Workspace Frameworks", project.frameworks.join(", ") || "none detected");
|
|
57
|
+
output.keyValue("Package Manager", project.packageManager);
|
|
58
|
+
output.keyValue("Provider", config?.provider ?? "not configured");
|
|
59
|
+
output.keyValue("Config", config ? "exists" : "missing");
|
|
60
|
+
output.keyValue("Snapshot", snapshotResult.status);
|
|
61
|
+
if (!config) {
|
|
62
|
+
issues.push("Run devmap init to create ~/.devmap/config.json.");
|
|
63
|
+
output.keyValue("API key", "not configured");
|
|
64
|
+
output.keyValue("Model", "not configured");
|
|
65
|
+
}
|
|
66
|
+
else if (!config.apiKey || !selectedModel) {
|
|
67
|
+
issues.push("Run devmap init again to configure the selected provider.");
|
|
68
|
+
output.keyValue("API key", "missing");
|
|
69
|
+
modelStatus = selectedModel
|
|
70
|
+
? describeModel(selectedModel, modelSource)
|
|
71
|
+
: "not configured";
|
|
72
|
+
output.keyValue("Model", modelStatus);
|
|
73
|
+
apiKeyStatus = "missing";
|
|
74
|
+
}
|
|
75
|
+
else {
|
|
76
|
+
try {
|
|
77
|
+
const provider = await inspectProvider(config.apiKey, selectedModel, config.provider);
|
|
78
|
+
apiKeyStatus = provider.reachable ? "valid" : "unreachable";
|
|
79
|
+
modelStatus = provider.modelAvailable
|
|
80
|
+
? describeModel(selectedModel, modelSource)
|
|
81
|
+
: describeModel(`unavailable: ${selectedModel}`, modelSource);
|
|
82
|
+
output.keyValue("API key", apiKeyStatus);
|
|
83
|
+
output.keyValue("Model", modelStatus);
|
|
84
|
+
if (!provider.modelAvailable) {
|
|
85
|
+
issues.push("Run devmap init or choose an available provider model.");
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
catch (error) {
|
|
89
|
+
const message = error instanceof DevmapError
|
|
90
|
+
? error.message
|
|
91
|
+
: "Provider diagnostics failed.";
|
|
92
|
+
output.keyValue("API key", "invalid or unreachable");
|
|
93
|
+
modelStatus = describeModel(selectedModel, modelSource);
|
|
94
|
+
output.keyValue("Model", modelStatus);
|
|
95
|
+
apiKeyStatus = "invalid or unreachable";
|
|
96
|
+
issues.push(message);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
if (!nodeSupported) {
|
|
100
|
+
issues.push(`Install Node.js ${MINIMUM_NODE_MAJOR} or newer.`);
|
|
101
|
+
}
|
|
102
|
+
if (snapshotResult.status === "corrupt" || snapshotResult.status === "unsupported") {
|
|
103
|
+
issues.push("Run devmap analyze --fresh to regenerate the snapshot.");
|
|
104
|
+
}
|
|
105
|
+
if (issues.length === 0) {
|
|
106
|
+
output.success("No issues found");
|
|
107
|
+
}
|
|
108
|
+
else {
|
|
109
|
+
output.section("Issues");
|
|
110
|
+
for (const issue of issues) {
|
|
111
|
+
output.warning(issue);
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
return {
|
|
115
|
+
status: issues.length === 0 ? "ok" : "issues",
|
|
116
|
+
devmapVersion: DEVMAP_VERSION,
|
|
117
|
+
node: {
|
|
118
|
+
version: process.version,
|
|
119
|
+
supported: nodeSupported
|
|
120
|
+
},
|
|
121
|
+
os: {
|
|
122
|
+
platform: platform(),
|
|
123
|
+
arch: arch()
|
|
124
|
+
},
|
|
125
|
+
project,
|
|
126
|
+
provider: config?.provider ?? null,
|
|
127
|
+
config: config ? "exists" : "missing",
|
|
128
|
+
snapshot: snapshotResult.status,
|
|
129
|
+
apiKey: apiKeyStatus,
|
|
130
|
+
model: modelStatus,
|
|
131
|
+
issues
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
function readNodeMajor(version) {
|
|
135
|
+
const match = version.match(/^v?(\d+)/);
|
|
136
|
+
return match ? Number(match[1]) : 0;
|
|
137
|
+
}
|
|
138
|
+
function describeModel(model, source) {
|
|
139
|
+
return `${model} (${source})`;
|
|
140
|
+
}
|
|
141
|
+
//# sourceMappingURL=doctor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import type { AiClient } from "../ai/types.js";
|
|
2
|
+
import type { ProjectMap } from "../analyzers/pipeline/index.js";
|
|
3
|
+
import { type DevmapConfig } from "../utils/config.js";
|
|
4
|
+
export type ExplainOptions = {
|
|
5
|
+
json?: boolean;
|
|
6
|
+
write?: boolean;
|
|
7
|
+
projectRoot?: string;
|
|
8
|
+
};
|
|
9
|
+
export type ExplainDependencies = {
|
|
10
|
+
loadConfig?: () => Promise<DevmapConfig | null>;
|
|
11
|
+
createAiClient?: (config: DevmapConfig) => AiClient;
|
|
12
|
+
};
|
|
13
|
+
export type ExplainResult = {
|
|
14
|
+
status: "ok";
|
|
15
|
+
mode: "file" | "feature" | "function";
|
|
16
|
+
target: string;
|
|
17
|
+
resolvedFile?: string;
|
|
18
|
+
answer: string;
|
|
19
|
+
model: string;
|
|
20
|
+
contextFiles: string[];
|
|
21
|
+
writtenPath?: string;
|
|
22
|
+
};
|
|
23
|
+
export type ResolvedExplainTarget = {
|
|
24
|
+
mode: "file";
|
|
25
|
+
value: string;
|
|
26
|
+
} | {
|
|
27
|
+
mode: "feature";
|
|
28
|
+
value: string;
|
|
29
|
+
} | {
|
|
30
|
+
mode: "function";
|
|
31
|
+
value: string;
|
|
32
|
+
file: string;
|
|
33
|
+
line: number;
|
|
34
|
+
};
|
|
35
|
+
export declare function explainCommand(target: string, options?: ExplainOptions, dependencies?: ExplainDependencies): Promise<void>;
|
|
36
|
+
export declare function resolveExplainTarget(snapshot: ProjectMap, target: string): ResolvedExplainTarget;
|
|
37
|
+
//# sourceMappingURL=explain.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAM/E,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,EAC5B,YAAY,GAAE,mBAAwB,GACrC,OAAO,CAAC,IAAI,CAAC,CAaf;AAiED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,MAAM,GACb,qBAAqB,CA6CvB"}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import { mkdir, writeFile } from "node:fs/promises";
|
|
2
|
+
import { join, resolve } from "node:path";
|
|
3
|
+
import { buildQuestionContext } from "../ai/contextBuilder.js";
|
|
4
|
+
import { completeWithOptionalStreaming } from "../ai/completion.js";
|
|
5
|
+
import { createAiClient as createDefaultAiClient, resolveAiRouting } from "../ai/provider.js";
|
|
6
|
+
import { buildExplainMessages } from "../ai/prompts.js";
|
|
7
|
+
import { readSnapshotOrThrow } from "../cache/snapshot.js";
|
|
8
|
+
import { resolveEffectiveConfig } from "../utils/config.js";
|
|
9
|
+
import { DevmapError } from "../utils/errors.js";
|
|
10
|
+
import { output, withJsonOutput } from "../utils/output.js";
|
|
11
|
+
import { slugifyMapName } from "../utils/slug.js";
|
|
12
|
+
import { resolveFileTarget } from "../utils/targetResolver.js";
|
|
13
|
+
export async function explainCommand(target, options = {}, dependencies = {}) {
|
|
14
|
+
if (options.json) {
|
|
15
|
+
await withJsonOutput(async () => {
|
|
16
|
+
output.json(await runExplain(target, options, dependencies));
|
|
17
|
+
});
|
|
18
|
+
return;
|
|
19
|
+
}
|
|
20
|
+
const result = await runExplain(target, options, dependencies);
|
|
21
|
+
output.note(`Context files: ${result.contextFiles.join(", ")}`);
|
|
22
|
+
if (result.writtenPath) {
|
|
23
|
+
output.success(`Wrote ${result.writtenPath}`);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
async function runExplain(target, options, dependencies) {
|
|
27
|
+
const projectRoot = resolve(options.projectRoot ?? ".");
|
|
28
|
+
const snapshot = await readSnapshotOrThrow(projectRoot);
|
|
29
|
+
const loadConfig = dependencies.loadConfig
|
|
30
|
+
?? (() => resolveEffectiveConfig(projectRoot));
|
|
31
|
+
const config = await loadConfig();
|
|
32
|
+
if (!config?.apiKey) {
|
|
33
|
+
throw new DevmapError("devmap explain requires an AI provider, but none is configured.", "Run devmap init to set up Groq or OpenRouter, then try again.");
|
|
34
|
+
}
|
|
35
|
+
const createAiClient = dependencies.createAiClient
|
|
36
|
+
?? createDefaultAiClient;
|
|
37
|
+
const client = createAiClient(config);
|
|
38
|
+
const routing = resolveAiRouting(config, "explain");
|
|
39
|
+
const resolved = resolveExplainTarget(snapshot, target);
|
|
40
|
+
const targetLabel = resolved.mode === "function"
|
|
41
|
+
? `${resolved.value} in ${resolved.file}`
|
|
42
|
+
: resolved.value;
|
|
43
|
+
const context = await buildQuestionContext(projectRoot, snapshot, targetLabel);
|
|
44
|
+
const execution = await completeWithOptionalStreaming(client, {
|
|
45
|
+
messages: buildExplainMessages(targetLabel, context),
|
|
46
|
+
model: routing.model,
|
|
47
|
+
fallbackModels: routing.fallbackModels,
|
|
48
|
+
maxCompletionTokens: 700,
|
|
49
|
+
temperature: 0.2
|
|
50
|
+
}, !options.json, () => output.section("Answer"));
|
|
51
|
+
let writtenPath;
|
|
52
|
+
if (options.write) {
|
|
53
|
+
const slug = slugifyMapName(resolved.value);
|
|
54
|
+
const explainDir = join(projectRoot, ".devmap", "explain");
|
|
55
|
+
await mkdir(explainDir, { recursive: true });
|
|
56
|
+
await writeFile(join(explainDir, `${slug}.md`), `# ${targetLabel}\n\n${execution.result.content}\n`, "utf8");
|
|
57
|
+
writtenPath = `.devmap/explain/${slug}.md`;
|
|
58
|
+
}
|
|
59
|
+
return {
|
|
60
|
+
status: "ok",
|
|
61
|
+
mode: resolved.mode,
|
|
62
|
+
target: resolved.value,
|
|
63
|
+
...(resolved.mode === "function" ? { resolvedFile: resolved.file } : {}),
|
|
64
|
+
answer: execution.result.content,
|
|
65
|
+
model: execution.result.model,
|
|
66
|
+
contextFiles: context.files.map((file) => file.path),
|
|
67
|
+
...(writtenPath ? { writtenPath } : {})
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
export function resolveExplainTarget(snapshot, target) {
|
|
71
|
+
const feature = snapshot.features.find((candidate) => candidate.name.toLowerCase() === target.toLowerCase());
|
|
72
|
+
if (feature) {
|
|
73
|
+
return { mode: "feature", value: feature.name };
|
|
74
|
+
}
|
|
75
|
+
const fileTarget = resolveFileTarget(snapshot, target);
|
|
76
|
+
if (fileTarget) {
|
|
77
|
+
return fileTarget;
|
|
78
|
+
}
|
|
79
|
+
const matches = [];
|
|
80
|
+
for (const [file, entry] of Object.entries(snapshot.fileIndex)) {
|
|
81
|
+
for (const fn of entry.topFunctions) {
|
|
82
|
+
if (fn.name.toLowerCase() === target.toLowerCase()) {
|
|
83
|
+
matches.push({ file, fn });
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
if (matches.length === 1) {
|
|
88
|
+
return {
|
|
89
|
+
mode: "function",
|
|
90
|
+
value: matches[0].fn.name,
|
|
91
|
+
file: matches[0].file,
|
|
92
|
+
line: matches[0].fn.line
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
if (matches.length > 1) {
|
|
96
|
+
throw new DevmapError(`"${target}" matches multiple functions.`, `Be more specific — found in: ${matches.map((match) => `${match.file}:${match.fn.line}`).slice(0, 5).join(", ")}`);
|
|
97
|
+
}
|
|
98
|
+
const featureNames = snapshot.features.map((f) => f.name).join(", ") || "(none detected)";
|
|
99
|
+
throw new DevmapError(`"${target}" isn't a known file, feature, or function.`, `Known features: ${featureNames}. For a file, use its path relative to the project root, or use a top-level function name.`);
|
|
100
|
+
}
|
|
101
|
+
//# sourceMappingURL=explain.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"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"}
|