@ai-coders/context 0.5.2 → 0.6.1
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/README.md +247 -12
- package/dist/generators/agents/agentGenerator.d.ts +3 -0
- package/dist/generators/agents/agentGenerator.d.ts.map +1 -1
- package/dist/generators/agents/agentGenerator.js +13 -7
- package/dist/generators/agents/agentGenerator.js.map +1 -1
- package/dist/generators/agents/templates/playbookTemplate.d.ts.map +1 -1
- package/dist/generators/agents/templates/playbookTemplate.js +3 -1
- package/dist/generators/agents/templates/playbookTemplate.js.map +1 -1
- package/dist/generators/documentation/codebaseMapGenerator.d.ts +98 -0
- package/dist/generators/documentation/codebaseMapGenerator.d.ts.map +1 -0
- package/dist/generators/documentation/codebaseMapGenerator.js +247 -0
- package/dist/generators/documentation/codebaseMapGenerator.js.map +1 -0
- package/dist/generators/documentation/documentationGenerator.d.ts +2 -0
- package/dist/generators/documentation/documentationGenerator.d.ts.map +1 -1
- package/dist/generators/documentation/documentationGenerator.js +20 -1
- package/dist/generators/documentation/documentationGenerator.js.map +1 -1
- package/dist/generators/documentation/index.d.ts +2 -0
- package/dist/generators/documentation/index.d.ts.map +1 -1
- package/dist/generators/documentation/index.js +3 -1
- package/dist/generators/documentation/index.js.map +1 -1
- package/dist/generators/documentation/templates/architectureTemplate.d.ts.map +1 -1
- package/dist/generators/documentation/templates/architectureTemplate.js +2 -31
- package/dist/generators/documentation/templates/architectureTemplate.js.map +1 -1
- package/dist/generators/documentation/templates/common.d.ts +4 -1
- package/dist/generators/documentation/templates/common.d.ts.map +1 -1
- package/dist/generators/documentation/templates/common.js +4 -2
- package/dist/generators/documentation/templates/common.js.map +1 -1
- package/dist/generators/plans/templates/planTemplate.d.ts.map +1 -1
- package/dist/generators/plans/templates/planTemplate.js +46 -2
- package/dist/generators/plans/templates/planTemplate.js.map +1 -1
- package/dist/generators/skills/index.d.ts +7 -0
- package/dist/generators/skills/index.d.ts.map +1 -0
- package/dist/generators/skills/index.js +15 -0
- package/dist/generators/skills/index.js.map +1 -0
- package/dist/generators/skills/skillGenerator.d.ts +53 -0
- package/dist/generators/skills/skillGenerator.d.ts.map +1 -0
- package/dist/generators/skills/skillGenerator.js +149 -0
- package/dist/generators/skills/skillGenerator.js.map +1 -0
- package/dist/generators/skills/templates/indexTemplate.d.ts +13 -0
- package/dist/generators/skills/templates/indexTemplate.d.ts.map +1 -0
- package/dist/generators/skills/templates/indexTemplate.js +102 -0
- package/dist/generators/skills/templates/indexTemplate.js.map +1 -0
- package/dist/generators/skills/templates/skillTemplate.d.ts +20 -0
- package/dist/generators/skills/templates/skillTemplate.d.ts.map +1 -0
- package/dist/generators/skills/templates/skillTemplate.js +85 -0
- package/dist/generators/skills/templates/skillTemplate.js.map +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1315 -43
- package/dist/index.js.map +1 -1
- package/dist/services/ai/agentEvents.d.ts +1 -1
- package/dist/services/ai/agentEvents.d.ts.map +1 -1
- package/dist/services/ai/agents/index.d.ts +2 -0
- package/dist/services/ai/agents/index.d.ts.map +1 -1
- package/dist/services/ai/agents/index.js +3 -1
- package/dist/services/ai/agents/index.js.map +1 -1
- package/dist/services/ai/agents/skillAgent.d.ts +49 -0
- package/dist/services/ai/agents/skillAgent.d.ts.map +1 -0
- package/dist/services/ai/agents/skillAgent.js +179 -0
- package/dist/services/ai/agents/skillAgent.js.map +1 -0
- package/dist/services/ai/prompts/index.d.ts +1 -1
- package/dist/services/ai/prompts/index.d.ts.map +1 -1
- package/dist/services/ai/prompts/index.js +2 -1
- package/dist/services/ai/prompts/index.js.map +1 -1
- package/dist/services/ai/prompts/sharedPrompts.d.ts +4 -0
- package/dist/services/ai/prompts/sharedPrompts.d.ts.map +1 -1
- package/dist/services/ai/prompts/sharedPrompts.js +33 -0
- package/dist/services/ai/prompts/sharedPrompts.js.map +1 -1
- package/dist/services/ai/schemas.d.ts +98 -1
- package/dist/services/ai/schemas.d.ts.map +1 -1
- package/dist/services/ai/schemas.js +61 -3
- package/dist/services/ai/schemas.js.map +1 -1
- package/dist/services/ai/toolRegistry.d.ts.map +1 -1
- package/dist/services/ai/toolRegistry.js +17 -0
- package/dist/services/ai/toolRegistry.js.map +1 -1
- package/dist/services/ai/tools/fillScaffoldingTool.d.ts +21 -4
- package/dist/services/ai/tools/fillScaffoldingTool.d.ts.map +1 -1
- package/dist/services/ai/tools/fillScaffoldingTool.js +17 -0
- package/dist/services/ai/tools/fillScaffoldingTool.js.map +1 -1
- package/dist/services/ai/tools/getCodebaseMapTool.d.ts +17 -0
- package/dist/services/ai/tools/getCodebaseMapTool.d.ts.map +1 -0
- package/dist/services/ai/tools/getCodebaseMapTool.js +115 -0
- package/dist/services/ai/tools/getCodebaseMapTool.js.map +1 -0
- package/dist/services/ai/tools/index.d.ts +3 -2
- package/dist/services/ai/tools/index.d.ts.map +1 -1
- package/dist/services/ai/tools/index.js +12 -3
- package/dist/services/ai/tools/index.js.map +1 -1
- package/dist/services/ai/tools/initializeContextTool.d.ts +22 -4
- package/dist/services/ai/tools/initializeContextTool.d.ts.map +1 -1
- package/dist/services/ai/tools/initializeContextTool.js +201 -16
- package/dist/services/ai/tools/initializeContextTool.js.map +1 -1
- package/dist/services/ai/tools/scaffoldPlanTool.d.ts +11 -0
- package/dist/services/ai/tools/scaffoldPlanTool.d.ts.map +1 -1
- package/dist/services/ai/tools/scaffoldPlanTool.js +79 -7
- package/dist/services/ai/tools/scaffoldPlanTool.js.map +1 -1
- package/dist/services/export/exportRulesService.d.ts +62 -0
- package/dist/services/export/exportRulesService.d.ts.map +1 -0
- package/dist/services/export/exportRulesService.js +242 -0
- package/dist/services/export/exportRulesService.js.map +1 -0
- package/dist/services/export/index.d.ts +5 -0
- package/dist/services/export/index.d.ts.map +1 -0
- package/dist/services/export/index.js +10 -0
- package/dist/services/export/index.js.map +1 -0
- package/dist/services/export/skillExportService.d.ts +64 -0
- package/dist/services/export/skillExportService.d.ts.map +1 -0
- package/dist/services/export/skillExportService.js +238 -0
- package/dist/services/export/skillExportService.js.map +1 -0
- package/dist/services/fill/skillFillService.d.ts +50 -0
- package/dist/services/fill/skillFillService.d.ts.map +1 -0
- package/dist/services/fill/skillFillService.js +254 -0
- package/dist/services/fill/skillFillService.js.map +1 -0
- package/dist/services/import/agentsDetector.d.ts +12 -0
- package/dist/services/import/agentsDetector.d.ts.map +1 -0
- package/dist/services/import/agentsDetector.js +183 -0
- package/dist/services/import/agentsDetector.js.map +1 -0
- package/dist/services/import/importAgentsService.d.ts +14 -0
- package/dist/services/import/importAgentsService.d.ts.map +1 -0
- package/dist/services/import/importAgentsService.js +195 -0
- package/dist/services/import/importAgentsService.js.map +1 -0
- package/dist/services/import/importRulesService.d.ts +17 -0
- package/dist/services/import/importRulesService.d.ts.map +1 -0
- package/dist/services/import/importRulesService.js +222 -0
- package/dist/services/import/importRulesService.js.map +1 -0
- package/dist/services/import/index.d.ts +7 -0
- package/dist/services/import/index.d.ts.map +1 -0
- package/dist/services/import/index.js +28 -0
- package/dist/services/import/index.js.map +1 -0
- package/dist/services/import/presets.d.ts +8 -0
- package/dist/services/import/presets.d.ts.map +1 -0
- package/dist/services/import/presets.js +176 -0
- package/dist/services/import/presets.js.map +1 -0
- package/dist/services/import/rulesDetector.d.ts +16 -0
- package/dist/services/import/rulesDetector.d.ts.map +1 -0
- package/dist/services/import/rulesDetector.js +278 -0
- package/dist/services/import/rulesDetector.js.map +1 -0
- package/dist/services/import/types.d.ts +72 -0
- package/dist/services/import/types.d.ts.map +1 -0
- package/dist/services/import/types.js +3 -0
- package/dist/services/import/types.js.map +1 -0
- package/dist/services/mcp/mcpServer.d.ts +24 -0
- package/dist/services/mcp/mcpServer.d.ts.map +1 -1
- package/dist/services/mcp/mcpServer.js +1651 -7
- package/dist/services/mcp/mcpServer.js.map +1 -1
- package/dist/services/quickSync/index.d.ts +3 -0
- package/dist/services/quickSync/index.d.ts.map +1 -0
- package/dist/services/quickSync/index.js +7 -0
- package/dist/services/quickSync/index.js.map +1 -0
- package/dist/services/quickSync/quickSyncService.d.ts +72 -0
- package/dist/services/quickSync/quickSyncService.d.ts.map +1 -0
- package/dist/services/quickSync/quickSyncService.js +268 -0
- package/dist/services/quickSync/quickSyncService.js.map +1 -0
- package/dist/services/report/index.d.ts +3 -0
- package/dist/services/report/index.d.ts.map +1 -0
- package/dist/services/report/index.js +6 -0
- package/dist/services/report/index.js.map +1 -0
- package/dist/services/report/reportService.d.ts +131 -0
- package/dist/services/report/reportService.d.ts.map +1 -0
- package/dist/services/report/reportService.js +372 -0
- package/dist/services/report/reportService.js.map +1 -0
- package/dist/services/semantic/contextBuilder.d.ts +8 -1
- package/dist/services/semantic/contextBuilder.d.ts.map +1 -1
- package/dist/services/semantic/contextBuilder.js +107 -20
- package/dist/services/semantic/contextBuilder.js.map +1 -1
- package/dist/services/shared/globPatterns.d.ts +48 -0
- package/dist/services/shared/globPatterns.d.ts.map +1 -0
- package/dist/services/shared/globPatterns.js +110 -0
- package/dist/services/shared/globPatterns.js.map +1 -0
- package/dist/services/shared/index.d.ts +10 -0
- package/dist/services/shared/index.d.ts.map +1 -0
- package/dist/services/shared/index.js +46 -0
- package/dist/services/shared/index.js.map +1 -0
- package/dist/services/shared/pathHelpers.d.ts +71 -0
- package/dist/services/shared/pathHelpers.d.ts.map +1 -0
- package/dist/services/shared/pathHelpers.js +162 -0
- package/dist/services/shared/pathHelpers.js.map +1 -0
- package/dist/services/shared/types.d.ts +74 -0
- package/dist/services/shared/types.d.ts.map +1 -0
- package/dist/services/shared/types.js +44 -0
- package/dist/services/shared/types.js.map +1 -0
- package/dist/services/shared/uiHelpers.d.ts +70 -0
- package/dist/services/shared/uiHelpers.d.ts.map +1 -0
- package/dist/services/shared/uiHelpers.js +131 -0
- package/dist/services/shared/uiHelpers.js.map +1 -0
- package/dist/services/stack/index.d.ts +6 -0
- package/dist/services/stack/index.d.ts.map +1 -0
- package/dist/services/stack/index.js +25 -0
- package/dist/services/stack/index.js.map +1 -0
- package/dist/services/stack/projectTypeClassifier.d.ts +59 -0
- package/dist/services/stack/projectTypeClassifier.d.ts.map +1 -0
- package/dist/services/stack/projectTypeClassifier.js +242 -0
- package/dist/services/stack/projectTypeClassifier.js.map +1 -0
- package/dist/services/stack/scaffoldFilter.d.ts +75 -0
- package/dist/services/stack/scaffoldFilter.d.ts.map +1 -0
- package/dist/services/stack/scaffoldFilter.js +222 -0
- package/dist/services/stack/scaffoldFilter.js.map +1 -0
- package/dist/services/stack/stackDetector.d.ts +43 -0
- package/dist/services/stack/stackDetector.d.ts.map +1 -0
- package/dist/services/stack/stackDetector.js +406 -0
- package/dist/services/stack/stackDetector.js.map +1 -0
- package/dist/services/start/index.d.ts +3 -0
- package/dist/services/start/index.d.ts.map +1 -0
- package/dist/services/start/index.js +6 -0
- package/dist/services/start/index.js.map +1 -0
- package/dist/services/start/startService.d.ts +64 -0
- package/dist/services/start/startService.d.ts.map +1 -0
- package/dist/services/start/startService.js +180 -0
- package/dist/services/start/startService.js.map +1 -0
- package/dist/services/sync/presets.d.ts.map +1 -1
- package/dist/services/sync/presets.js +16 -1
- package/dist/services/sync/presets.js.map +1 -1
- package/dist/services/sync/types.d.ts +1 -1
- package/dist/services/sync/types.d.ts.map +1 -1
- package/dist/services/workflow/autoAdvance.d.ts +38 -0
- package/dist/services/workflow/autoAdvance.d.ts.map +1 -0
- package/dist/services/workflow/autoAdvance.js +219 -0
- package/dist/services/workflow/autoAdvance.js.map +1 -0
- package/dist/services/workflow/index.d.ts +6 -0
- package/dist/services/workflow/index.d.ts.map +1 -0
- package/dist/services/workflow/index.js +11 -0
- package/dist/services/workflow/index.js.map +1 -0
- package/dist/services/workflow/workflowService.d.ts +98 -0
- package/dist/services/workflow/workflowService.d.ts.map +1 -0
- package/dist/services/workflow/workflowService.js +210 -0
- package/dist/services/workflow/workflowService.js.map +1 -0
- package/dist/utils/cliUI.d.ts +4 -0
- package/dist/utils/cliUI.d.ts.map +1 -1
- package/dist/utils/cliUI.js +31 -1
- package/dist/utils/cliUI.js.map +1 -1
- package/dist/utils/i18n.d.ts +202 -0
- package/dist/utils/i18n.d.ts.map +1 -1
- package/dist/utils/i18n.js +438 -2
- package/dist/utils/i18n.js.map +1 -1
- package/dist/utils/theme.d.ts +1 -0
- package/dist/utils/theme.d.ts.map +1 -1
- package/dist/utils/theme.js +1 -0
- package/dist/utils/theme.js.map +1 -1
- package/dist/workflow/agents/agentRegistry.d.ts +82 -0
- package/dist/workflow/agents/agentRegistry.d.ts.map +1 -0
- package/dist/workflow/agents/agentRegistry.js +205 -0
- package/dist/workflow/agents/agentRegistry.js.map +1 -0
- package/dist/workflow/agents/index.d.ts +7 -0
- package/dist/workflow/agents/index.d.ts.map +1 -0
- package/dist/workflow/agents/index.js +14 -0
- package/dist/workflow/agents/index.js.map +1 -0
- package/dist/workflow/collaboration.d.ts +110 -0
- package/dist/workflow/collaboration.d.ts.map +1 -0
- package/dist/workflow/collaboration.js +301 -0
- package/dist/workflow/collaboration.js.map +1 -0
- package/dist/workflow/index.d.ts +25 -0
- package/dist/workflow/index.d.ts.map +1 -0
- package/dist/workflow/index.js +124 -0
- package/dist/workflow/index.js.map +1 -0
- package/dist/workflow/orchestration/agentOrchestrator.d.ts +68 -0
- package/dist/workflow/orchestration/agentOrchestrator.d.ts.map +1 -0
- package/dist/workflow/orchestration/agentOrchestrator.js +280 -0
- package/dist/workflow/orchestration/agentOrchestrator.js.map +1 -0
- package/dist/workflow/orchestration/documentLinker.d.ts +100 -0
- package/dist/workflow/orchestration/documentLinker.d.ts.map +1 -0
- package/dist/workflow/orchestration/documentLinker.js +266 -0
- package/dist/workflow/orchestration/documentLinker.js.map +1 -0
- package/dist/workflow/orchestration/index.d.ts +9 -0
- package/dist/workflow/orchestration/index.d.ts.map +1 -0
- package/dist/workflow/orchestration/index.js +25 -0
- package/dist/workflow/orchestration/index.js.map +1 -0
- package/dist/workflow/orchestrator.d.ts +99 -0
- package/dist/workflow/orchestrator.d.ts.map +1 -0
- package/dist/workflow/orchestrator.js +217 -0
- package/dist/workflow/orchestrator.js.map +1 -0
- package/dist/workflow/phases.d.ts +64 -0
- package/dist/workflow/phases.d.ts.map +1 -0
- package/dist/workflow/phases.js +151 -0
- package/dist/workflow/phases.js.map +1 -0
- package/dist/workflow/plans/index.d.ts +8 -0
- package/dist/workflow/plans/index.d.ts.map +1 -0
- package/dist/workflow/plans/index.js +27 -0
- package/dist/workflow/plans/index.js.map +1 -0
- package/dist/workflow/plans/planLinker.d.ts +119 -0
- package/dist/workflow/plans/planLinker.d.ts.map +1 -0
- package/dist/workflow/plans/planLinker.js +499 -0
- package/dist/workflow/plans/planLinker.js.map +1 -0
- package/dist/workflow/plans/types.d.ts +167 -0
- package/dist/workflow/plans/types.d.ts.map +1 -0
- package/dist/workflow/plans/types.js +25 -0
- package/dist/workflow/plans/types.js.map +1 -0
- package/dist/workflow/prevcConfig.d.ts +27 -0
- package/dist/workflow/prevcConfig.d.ts.map +1 -0
- package/dist/workflow/prevcConfig.js +153 -0
- package/dist/workflow/prevcConfig.js.map +1 -0
- package/dist/workflow/roles.d.ts +44 -0
- package/dist/workflow/roles.d.ts.map +1 -0
- package/dist/workflow/roles.js +112 -0
- package/dist/workflow/roles.js.map +1 -0
- package/dist/workflow/scaling.d.ts +44 -0
- package/dist/workflow/scaling.d.ts.map +1 -0
- package/dist/workflow/scaling.js +224 -0
- package/dist/workflow/scaling.js.map +1 -0
- package/dist/workflow/skills/frontmatter.d.ts +23 -0
- package/dist/workflow/skills/frontmatter.d.ts.map +1 -0
- package/dist/workflow/skills/frontmatter.js +100 -0
- package/dist/workflow/skills/frontmatter.js.map +1 -0
- package/dist/workflow/skills/index.d.ts +10 -0
- package/dist/workflow/skills/index.d.ts.map +1 -0
- package/dist/workflow/skills/index.js +22 -0
- package/dist/workflow/skills/index.js.map +1 -0
- package/dist/workflow/skills/skillRegistry.d.ts +60 -0
- package/dist/workflow/skills/skillRegistry.d.ts.map +1 -0
- package/dist/workflow/skills/skillRegistry.js +257 -0
- package/dist/workflow/skills/skillRegistry.js.map +1 -0
- package/dist/workflow/skills/skillTemplates.d.ts +16 -0
- package/dist/workflow/skills/skillTemplates.d.ts.map +1 -0
- package/dist/workflow/skills/skillTemplates.js +610 -0
- package/dist/workflow/skills/skillTemplates.js.map +1 -0
- package/dist/workflow/skills/types.d.ts +72 -0
- package/dist/workflow/skills/types.d.ts.map +1 -0
- package/dist/workflow/skills/types.js +48 -0
- package/dist/workflow/skills/types.js.map +1 -0
- package/dist/workflow/status/statusManager.d.ts +84 -0
- package/dist/workflow/status/statusManager.d.ts.map +1 -0
- package/dist/workflow/status/statusManager.js +402 -0
- package/dist/workflow/status/statusManager.js.map +1 -0
- package/dist/workflow/status/templates.d.ts +40 -0
- package/dist/workflow/status/templates.d.ts.map +1 -0
- package/dist/workflow/status/templates.js +148 -0
- package/dist/workflow/status/templates.js.map +1 -0
- package/dist/workflow/types.d.ts +178 -0
- package/dist/workflow/types.d.ts.map +1 -0
- package/dist/workflow/types.js +25 -0
- package/dist/workflow/types.js.map +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,8 +4,62 @@
|
|
|
4
4
|
[](https://github.com/vinilana/ai-coders-context/actions/workflows/ci.yml)
|
|
5
5
|
[](https://opensource.org/licenses/MIT)
|
|
6
6
|
|
|
7
|
+
**The Ultimate MCP for AI Agent Orchestration, Context Engineering, and Spec-Driven Development.**
|
|
8
|
+
Context engineering for AI now is stupidly simple.
|
|
7
9
|
|
|
8
|
-
|
|
10
|
+
Stop letting LLMs run on autopilot. PREVC is a universal process that improves AI output through 5 simple steps: **Planning, Review, Execution, Validation, and Confirmation**. Context-oriented. Spec-driven. No guesswork.
|
|
11
|
+
|
|
12
|
+
## The Problem
|
|
13
|
+
|
|
14
|
+
Every AI coding tool invented its own way to organize context:
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
.cursor/rules/ # Cursor
|
|
18
|
+
.claude/ # Claude Code
|
|
19
|
+
.windsurf/rules/ # Windsurf
|
|
20
|
+
.github/agents/ # Copilot
|
|
21
|
+
.cline/ # Cline
|
|
22
|
+
AGENTS.md # Codex
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Using multiple tools? Enjoy duplicating your rules, agents, and documentation across 6 different formats. Context fragmentation is real.
|
|
26
|
+
|
|
27
|
+
## The Solution
|
|
28
|
+
|
|
29
|
+
One `.context/` directory. Works everywhere.
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
.context/
|
|
33
|
+
├── docs/ # Your documentation (architecture, patterns, decisions)
|
|
34
|
+
├── agents/ # Agent playbooks (code-reviewer, feature-developer, etc.)
|
|
35
|
+
├── plans/ # Work plans linked to PREVC workflow
|
|
36
|
+
└── skills/ # On-demand expertise (commit-message, pr-review, etc.)
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Export to any tool.
|
|
40
|
+
**Write once. Use anywhere. No boilerplate.**
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
## Youtube video
|
|
44
|
+
[](https://www.youtube.com/watch?v=p9uV3CeLaKY)
|
|
45
|
+
|
|
46
|
+
## Connect with Us
|
|
47
|
+
|
|
48
|
+
Built by [AI Coders Academy](http://aicoders.academy/) — Learn AI-assisted development and become a more productive developer.
|
|
49
|
+
|
|
50
|
+
- [AI Coders Academy](http://aicoders.academy/) — Courses and resources for AI-powered coding
|
|
51
|
+
- [YouTube Channel](https://www.youtube.com/@aicodersacademy) — Tutorials, demos, and best practices
|
|
52
|
+
- [Connect with Vini](https://www.linkedin.com/in/viniciuslanadepaula/) — Creator of @ai-coders/context
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
## Why PREVC?
|
|
56
|
+
|
|
57
|
+
LLMs produce better results when they follow a structured process instead of generating code blindly. PREVC ensures:
|
|
58
|
+
|
|
59
|
+
- **Specifications before code** — AI understands what to build before building it
|
|
60
|
+
- **Context awareness** — Each phase has the right documentation and agent
|
|
61
|
+
- **Human checkpoints** — Review and validate at each step, not just at the end
|
|
62
|
+
- **Reproducible quality** — Same process, consistent results across projects
|
|
9
63
|
|
|
10
64
|
## Usage
|
|
11
65
|
|
|
@@ -15,26 +69,92 @@ npx @ai-coders/context
|
|
|
15
69
|
|
|
16
70
|
That's it. The wizard detects what needs to be done.
|
|
17
71
|
|
|
72
|
+
|
|
73
|
+
PT-BR Tutorial
|
|
74
|
+
https://www.youtube.com/watch?v=5BPrfZAModk
|
|
75
|
+
|
|
18
76
|
## What it does
|
|
19
77
|
|
|
20
|
-
1. **Creates documentation** — Structured docs from your codebase
|
|
21
|
-
2. **Generates playbooks** —
|
|
22
|
-
3. **
|
|
78
|
+
1. **Creates documentation** — Structured docs from your codebase (architecture, data flow, decisions)
|
|
79
|
+
2. **Generates agent playbooks** — 14 specialized AI agents (code-reviewer, bug-fixer, architect, etc.)
|
|
80
|
+
3. **Manages workflows** — PREVC process with scale detection and visual dashboards
|
|
81
|
+
4. **Provides skills** — On-demand expertise (commit messages, PR reviews, security audits)
|
|
82
|
+
5. **Syncs everywhere** — Export to Cursor, Claude, Copilot, Windsurf, Cline, Codex, and more
|
|
83
|
+
6. **Keeps it updated** — Detects code changes and suggests documentation updates
|
|
23
84
|
|
|
24
|
-
##
|
|
85
|
+
## Quick Start
|
|
25
86
|
|
|
87
|
+
1. Install the MCP
|
|
88
|
+
2. Prompt to the agent:
|
|
89
|
+
```bash
|
|
90
|
+
init the context
|
|
91
|
+
```
|
|
92
|
+
3. This will setup the context and fill it according the the codebase
|
|
93
|
+
4. With the context ready prompt
|
|
26
94
|
```bash
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
95
|
+
plan [YOUR TASK HERE] using ai-context
|
|
96
|
+
```
|
|
97
|
+
5. After planned, prompt
|
|
98
|
+
```bash
|
|
99
|
+
start the workflow
|
|
100
|
+
```
|
|
101
|
+
6. That's it!
|
|
102
|
+
|
|
103
|
+
## PREVC Workflow System
|
|
104
|
+
|
|
105
|
+
A universal 5-phase process designed to improve LLM output quality through structured, spec-driven development:
|
|
106
|
+
|
|
107
|
+
| Phase | Name | Purpose |
|
|
108
|
+
|-------|------|---------|
|
|
109
|
+
| **P** | Planning | Define what to build. Gather requirements, write specs, identify scope. No code yet. |
|
|
110
|
+
| **R** | Review | Validate the approach. Architecture decisions, technical design, risk assessment. |
|
|
111
|
+
| **E** | Execution | Build it. Implementation follows the approved specs and design. |
|
|
112
|
+
| **V** | Validation | Verify it works. Tests, QA, code review against original specs. |
|
|
113
|
+
| **C** | Confirmation | Ship it. Documentation, deployment, stakeholder handoff. |
|
|
114
|
+
|
|
115
|
+
### The Problem with Autopilot AI
|
|
116
|
+
|
|
117
|
+
Most AI coding workflows look like this:
|
|
118
|
+
```
|
|
119
|
+
User: "Add authentication"
|
|
120
|
+
AI: *generates 500 lines of code*
|
|
121
|
+
User: "That's not what I wanted..."
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
PREVC fixes this:
|
|
125
|
+
```
|
|
126
|
+
P: What type of auth? OAuth, JWT, session? What providers?
|
|
127
|
+
R: Here's the architecture. Dependencies: X, Y. Risks: Z. Approve?
|
|
128
|
+
E: Implementing approved design...
|
|
129
|
+
V: All 15 tests pass. Security audit complete.
|
|
130
|
+
C: Deployed. Docs updated. Ready for review.
|
|
31
131
|
```
|
|
32
132
|
|
|
33
|
-
##
|
|
133
|
+
## Documentation
|
|
134
|
+
|
|
135
|
+
- [User Guide](./docs/GUIDE.md) — Complete usage guide
|
|
136
|
+
|
|
137
|
+
|
|
138
|
+
### Scale-Adaptive Routing
|
|
139
|
+
|
|
140
|
+
The system automatically detects project scale and adjusts the workflow:
|
|
141
|
+
|
|
142
|
+
| Scale | Phases | Use Case |
|
|
143
|
+
|-------|--------|----------|
|
|
144
|
+
| QUICK | E → V | Bug fixes, small tweaks |
|
|
145
|
+
| SMALL | P → E → V | Simple features |
|
|
146
|
+
| MEDIUM | P → R → E → V | Regular features |
|
|
147
|
+
| LARGE | P → R → E → V → C | Full products |
|
|
148
|
+
| ENTERPRISE | All + extras | Systems with compliance |
|
|
149
|
+
|
|
150
|
+
## Requirements for the CLI
|
|
34
151
|
|
|
35
152
|
- Node.js 20+
|
|
36
153
|
- API key from a supported provider (for AI features)
|
|
37
154
|
|
|
155
|
+
**If you are using throught MCP you don't need to setup an API key from a supported provider, your AI agent will use it's own LLM.**
|
|
156
|
+
|
|
157
|
+
|
|
38
158
|
## Supported Providers
|
|
39
159
|
|
|
40
160
|
| Provider | Environment Variable |
|
|
@@ -156,23 +276,138 @@ command = "npx"
|
|
|
156
276
|
args = ["--yes", "@ai-coders/context@latest", "mcp"]
|
|
157
277
|
```
|
|
158
278
|
|
|
279
|
+
### Local Development
|
|
280
|
+
|
|
281
|
+
For local development, point directly to the built distribution:
|
|
282
|
+
|
|
283
|
+
```json
|
|
284
|
+
{
|
|
285
|
+
"mcpServers": {
|
|
286
|
+
"ai-context-dev": {
|
|
287
|
+
"command": "node",
|
|
288
|
+
"args": ["/path/to/ai-coders-context/dist/index.js", "mcp"]
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
}
|
|
292
|
+
```
|
|
293
|
+
|
|
159
294
|
### Available MCP Tools
|
|
160
295
|
|
|
161
296
|
Once configured, your AI assistant will have access to:
|
|
162
297
|
|
|
298
|
+
#### Context Tools
|
|
299
|
+
|
|
163
300
|
| Tool | Description |
|
|
164
301
|
|------|-------------|
|
|
165
302
|
| `buildSemanticContext` | Build optimized context for LLM prompts |
|
|
166
303
|
| `initializeContext` | Create `.context` scaffolding |
|
|
167
304
|
| `fillScaffolding` | Generate documentation content |
|
|
305
|
+
| `getCodebaseMap` | Get structured codebase data (stack, symbols, architecture) |
|
|
168
306
|
| `analyzeSymbols` | Analyze code symbols (classes, functions, etc.) |
|
|
169
307
|
| `searchCode` | Search for patterns across files |
|
|
170
308
|
| `getFileStructure` | Get repository directory structure |
|
|
171
309
|
| `scaffoldPlan` | Create work plans |
|
|
172
310
|
|
|
173
|
-
|
|
311
|
+
#### Workflow Tools
|
|
312
|
+
|
|
313
|
+
| Tool | Description |
|
|
314
|
+
|------|-------------|
|
|
315
|
+
| `workflowInit` | Initialize a PREVC workflow with scale detection |
|
|
316
|
+
| `workflowStatus` | Get current workflow status |
|
|
317
|
+
| `workflowAdvance` | Advance to the next phase |
|
|
318
|
+
| `workflowHandoff` | Handoff between roles with artifacts |
|
|
319
|
+
| `workflowCollaborate` | Start multi-agent collaboration session |
|
|
320
|
+
| `workflowCreateDoc` | Generate phase-specific documents |
|
|
321
|
+
|
|
322
|
+
#### Orchestration Tools
|
|
323
|
+
|
|
324
|
+
| Tool | Description |
|
|
325
|
+
|------|-------------|
|
|
326
|
+
| `orchestrateAgents` | Select agents by task, phase, or role |
|
|
327
|
+
| `getAgentSequence` | Get recommended agent handoff sequence |
|
|
328
|
+
| `getAgentDocs` | Get documentation relevant to an agent |
|
|
329
|
+
| `getPhaseDocs` | Get documentation for a PREVC phase |
|
|
330
|
+
| `listAgentTypes` | List all 14 available agent types |
|
|
331
|
+
|
|
332
|
+
#### Plan-Workflow Tools
|
|
333
|
+
|
|
334
|
+
| Tool | Description |
|
|
335
|
+
|------|-------------|
|
|
336
|
+
| `linkPlan` | Link a plan file to current workflow |
|
|
337
|
+
| `getLinkedPlans` | Get all linked plans for workflow |
|
|
338
|
+
| `getPlanDetails` | Get plan details with agent lineup |
|
|
339
|
+
| `getPlansForPhase` | Get plans for a PREVC phase |
|
|
340
|
+
| `updatePlanPhase` | Update plan phase status |
|
|
341
|
+
| `recordDecision` | Record a plan decision |
|
|
342
|
+
| `discoverAgents` | Discover all agents (built-in + custom) |
|
|
343
|
+
| `getAgentInfo` | Get metadata for a specific agent |
|
|
344
|
+
|
|
345
|
+
#### Skill Tools
|
|
346
|
+
|
|
347
|
+
| Tool | Description |
|
|
348
|
+
|------|-------------|
|
|
349
|
+
| `listSkills` | List all available skills (built-in + custom) |
|
|
350
|
+
| `getSkillContent` | Get full SKILL.md content by slug |
|
|
351
|
+
| `getSkillsForPhase` | Get skills relevant to a PREVC phase |
|
|
352
|
+
| `scaffoldSkills` | Generate skill files in .context/skills/ |
|
|
353
|
+
| `fillSkills` | Fill skills with AI-generated project-specific content |
|
|
354
|
+
| `exportSkills` | Export skills to Claude/Gemini/Codex directories |
|
|
355
|
+
|
|
356
|
+
#### Utility Tools
|
|
357
|
+
|
|
358
|
+
| Tool | Description |
|
|
359
|
+
|------|-------------|
|
|
360
|
+
| `projectStart` | Unified setup: scaffolding + fill + workflow init |
|
|
361
|
+
| `projectReport` | Visual progress report for PREVC workflow |
|
|
362
|
+
| `exportRules` | Export context rules to AI tool directories |
|
|
363
|
+
| `detectStack` | Detect project technology stack |
|
|
364
|
+
|
|
365
|
+
### Skills (On-Demand Expertise)
|
|
366
|
+
|
|
367
|
+
Skills are task-specific procedures that AI agents activate when needed:
|
|
368
|
+
|
|
369
|
+
| Skill | Description | Phases |
|
|
370
|
+
|-------|-------------|--------|
|
|
371
|
+
| `commit-message` | Generate conventional commits | E, C |
|
|
372
|
+
| `pr-review` | Review PRs against standards | R, V |
|
|
373
|
+
| `code-review` | Code quality review | R, V |
|
|
374
|
+
| `test-generation` | Generate test cases | E, V |
|
|
375
|
+
| `documentation` | Generate/update docs | P, C |
|
|
376
|
+
| `refactoring` | Safe refactoring steps | E |
|
|
377
|
+
| `bug-investigation` | Bug investigation flow | E, V |
|
|
378
|
+
| `feature-breakdown` | Break features into tasks | P |
|
|
379
|
+
| `api-design` | Design RESTful APIs | P, R |
|
|
380
|
+
| `security-audit` | Security review checklist | R, V |
|
|
381
|
+
|
|
382
|
+
```bash
|
|
383
|
+
npx @ai-coders/context skill init # Initialize skills
|
|
384
|
+
npx @ai-coders/context skill fill # Fill skills with AI (project-specific content)
|
|
385
|
+
npx @ai-coders/context skill list # List available skills
|
|
386
|
+
npx @ai-coders/context skill export # Export to AI tools
|
|
387
|
+
npx @ai-coders/context skill create my-skill # Create custom skill
|
|
388
|
+
```
|
|
389
|
+
|
|
390
|
+
### Agent Types
|
|
391
|
+
|
|
392
|
+
The orchestration system maps tasks to specialized agents:
|
|
393
|
+
|
|
394
|
+
| Agent | Focus |
|
|
395
|
+
|-------|-------|
|
|
396
|
+
| `architect-specialist` | System architecture and patterns |
|
|
397
|
+
| `feature-developer` | New feature implementation |
|
|
398
|
+
| `bug-fixer` | Bug identification and fixes |
|
|
399
|
+
| `test-writer` | Test suites and coverage |
|
|
400
|
+
| `code-reviewer` | Code quality and best practices |
|
|
401
|
+
| `security-auditor` | Security vulnerabilities |
|
|
402
|
+
| `performance-optimizer` | Performance bottlenecks |
|
|
403
|
+
| `documentation-writer` | Technical documentation |
|
|
404
|
+
| `backend-specialist` | Server-side logic and APIs |
|
|
405
|
+
| `frontend-specialist` | User interfaces |
|
|
406
|
+
| `database-specialist` | Database solutions |
|
|
407
|
+
| `devops-specialist` | CI/CD and deployment |
|
|
408
|
+
| `mobile-specialist` | Mobile applications |
|
|
409
|
+
| `refactoring-specialist` | Code structure improvements |
|
|
174
410
|
|
|
175
|
-
- [Development Guide](./AGENTS.md) — Development guidelines
|
|
176
411
|
|
|
177
412
|
## License
|
|
178
413
|
|
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import { RepoStructure } from '../../types';
|
|
2
|
+
import { AgentType } from './agentTypes';
|
|
2
3
|
interface AgentGenerationConfig {
|
|
3
4
|
selectedAgents?: string[];
|
|
4
5
|
semantic?: boolean;
|
|
6
|
+
/** Filtered list of agents based on project type classification */
|
|
7
|
+
filteredAgents?: AgentType[];
|
|
5
8
|
}
|
|
6
9
|
export declare class AgentGenerator {
|
|
7
10
|
private readonly docTouchpoints;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agentGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"agentGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAe,SAAS,EAAE,MAAM,cAAc,CAAC;AAWtD,UAAU,qBAAqB;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC;CAC9B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAS7B;IAEF,OAAO,CAAC,QAAQ,CAAC,CAAmB;gBAExB,GAAG,WAAW,EAAE,OAAO,EAAE;IAE/B,oBAAoB,CACxB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,qBAAqB,GAAG,MAAM,EAAO,EAC7C,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,MAAM,CAAC;IAuDlB,OAAO,CAAC,0BAA0B;IA2FlC,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,YAAY;CAgBrB"}
|
|
@@ -74,7 +74,7 @@ class AgentGenerator {
|
|
|
74
74
|
}
|
|
75
75
|
}
|
|
76
76
|
const context = this.buildContext(repoStructure, semantics);
|
|
77
|
-
const agentTypes = this.resolveAgentSelection(normalizedConfig.selectedAgents);
|
|
77
|
+
const agentTypes = this.resolveAgentSelection(normalizedConfig.selectedAgents, normalizedConfig.filteredAgents);
|
|
78
78
|
let created = 0;
|
|
79
79
|
for (const agentType of agentTypes) {
|
|
80
80
|
const relevantSymbols = this.getRelevantSymbolsForAgent(agentType, semantics);
|
|
@@ -169,13 +169,19 @@ class AgentGenerator {
|
|
|
169
169
|
line: s.location.line,
|
|
170
170
|
}));
|
|
171
171
|
}
|
|
172
|
-
resolveAgentSelection(selected) {
|
|
173
|
-
|
|
174
|
-
|
|
172
|
+
resolveAgentSelection(selected, filteredByProjectType) {
|
|
173
|
+
// If explicitly selected agents are provided, use those
|
|
174
|
+
if (selected && selected.length > 0) {
|
|
175
|
+
const allowed = new Set(agentTypes_1.AGENT_TYPES);
|
|
176
|
+
const filtered = selected.filter((agent) => allowed.has(agent));
|
|
177
|
+
return (filtered.length > 0 ? filtered : agentTypes_1.AGENT_TYPES);
|
|
175
178
|
}
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
+
// If filtered by project type, use those
|
|
180
|
+
if (filteredByProjectType && filteredByProjectType.length > 0) {
|
|
181
|
+
return filteredByProjectType;
|
|
182
|
+
}
|
|
183
|
+
// Default: all agents
|
|
184
|
+
return agentTypes_1.AGENT_TYPES;
|
|
179
185
|
}
|
|
180
186
|
buildContext(repoStructure, semantics) {
|
|
181
187
|
const directorySet = new Set();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agentGenerator.js","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAE7B,sCAA2C;AAC3C,6CAAsD;AACtD,2CAAoE;AACpE,kEAAiE;AACjE,sDAA6F;
|
|
1
|
+
{"version":3,"file":"agentGenerator.js","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playbookTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/playbookTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAwB,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAiH7D,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,mBAAmB,EAAE,MAAM,EAAE,EAC7B,WAAW,EAAE,aAAa,EAAE,EAC5B,SAAS,CAAC,EAAE,eAAe,EAC3B,eAAe,CAAC,EAAE,aAAa,EAAE,EACjC,QAAQ,GAAE,MAAsB,GAC/B,MAAM,
|
|
1
|
+
{"version":3,"file":"playbookTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/playbookTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAwB,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAiH7D,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,mBAAmB,EAAE,MAAM,EAAE,EAC7B,WAAW,EAAE,aAAa,EAAE,EAC5B,SAAS,CAAC,EAAE,eAAe,EAC3B,eAAe,CAAC,EAAE,aAAa,EAAE,EACjC,QAAQ,GAAE,MAAsB,GAC/B,MAAM,CA2DR"}
|
|
@@ -184,7 +184,9 @@ ${touchpointList}
|
|
|
184
184
|
|
|
185
185
|
Summarize outcomes, remaining risks, and suggested follow-up actions after the agent completes its work.
|
|
186
186
|
`;
|
|
187
|
-
|
|
187
|
+
// Get first responsibility as description for front matter
|
|
188
|
+
const description = responsibilities[0] || 'Agent playbook';
|
|
189
|
+
return (0, common_1.wrapWithFrontMatter)(content, { name: title, description });
|
|
188
190
|
}
|
|
189
191
|
function formatTitle(agentType) {
|
|
190
192
|
return agentType
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"playbookTemplate.js","sourceRoot":"","sources":["../../../../src/generators/agents/templates/playbookTemplate.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqHA,
|
|
1
|
+
{"version":3,"file":"playbookTemplate.js","sourceRoot":"","sources":["../../../../src/generators/agents/templates/playbookTemplate.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Codebase Map Generator
|
|
3
|
+
*
|
|
4
|
+
* Generates a JSON file that serves as a quick LLM-readable summary
|
|
5
|
+
* of the entire codebase structure, symbols, and architecture.
|
|
6
|
+
*/
|
|
7
|
+
import { RepoStructure } from '../../types';
|
|
8
|
+
import { SemanticContext } from '../../services/semantic';
|
|
9
|
+
import { StackInfo } from '../../services/stack';
|
|
10
|
+
export interface SymbolSummary {
|
|
11
|
+
name: string;
|
|
12
|
+
kind: string;
|
|
13
|
+
file: string;
|
|
14
|
+
line: number;
|
|
15
|
+
exported: boolean;
|
|
16
|
+
signature?: string;
|
|
17
|
+
description?: string;
|
|
18
|
+
}
|
|
19
|
+
export interface CodebaseMap {
|
|
20
|
+
version: string;
|
|
21
|
+
generated: string;
|
|
22
|
+
stack: {
|
|
23
|
+
primaryLanguage: string | null;
|
|
24
|
+
languages: string[];
|
|
25
|
+
frameworks: string[];
|
|
26
|
+
buildTools: string[];
|
|
27
|
+
testFrameworks: string[];
|
|
28
|
+
packageManager: string | null;
|
|
29
|
+
isMonorepo: boolean;
|
|
30
|
+
hasDocker: boolean;
|
|
31
|
+
hasCI: boolean;
|
|
32
|
+
};
|
|
33
|
+
structure: {
|
|
34
|
+
totalFiles: number;
|
|
35
|
+
topDirectories: Array<{
|
|
36
|
+
name: string;
|
|
37
|
+
fileCount: number;
|
|
38
|
+
}>;
|
|
39
|
+
languageDistribution: Array<{
|
|
40
|
+
extension: string;
|
|
41
|
+
count: number;
|
|
42
|
+
}>;
|
|
43
|
+
};
|
|
44
|
+
architecture: {
|
|
45
|
+
layers: Array<{
|
|
46
|
+
name: string;
|
|
47
|
+
description: string;
|
|
48
|
+
directories: string[];
|
|
49
|
+
symbolCount: number;
|
|
50
|
+
dependsOn: string[];
|
|
51
|
+
}>;
|
|
52
|
+
patterns: Array<{
|
|
53
|
+
name: string;
|
|
54
|
+
confidence: number;
|
|
55
|
+
description: string;
|
|
56
|
+
occurrences: number;
|
|
57
|
+
}>;
|
|
58
|
+
entryPoints: string[];
|
|
59
|
+
};
|
|
60
|
+
symbols: {
|
|
61
|
+
classes: SymbolSummary[];
|
|
62
|
+
interfaces: SymbolSummary[];
|
|
63
|
+
functions: SymbolSummary[];
|
|
64
|
+
types: SymbolSummary[];
|
|
65
|
+
enums: SymbolSummary[];
|
|
66
|
+
};
|
|
67
|
+
publicAPI: SymbolSummary[];
|
|
68
|
+
dependencies: {
|
|
69
|
+
mostImported: Array<{
|
|
70
|
+
file: string;
|
|
71
|
+
importedBy: number;
|
|
72
|
+
}>;
|
|
73
|
+
};
|
|
74
|
+
stats: {
|
|
75
|
+
totalSymbols: number;
|
|
76
|
+
exportedSymbols: number;
|
|
77
|
+
analysisTimeMs: number;
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
export interface CodebaseMapOptions {
|
|
81
|
+
maxSymbolsPerCategory?: number;
|
|
82
|
+
}
|
|
83
|
+
export declare class CodebaseMapGenerator {
|
|
84
|
+
private maxSymbols;
|
|
85
|
+
constructor(options?: CodebaseMapOptions);
|
|
86
|
+
generate(repoStructure: RepoStructure, semantics?: SemanticContext, stackInfo?: StackInfo): CodebaseMap;
|
|
87
|
+
private buildStackSection;
|
|
88
|
+
private buildStructureSection;
|
|
89
|
+
private buildArchitectureSection;
|
|
90
|
+
private buildSymbolsSection;
|
|
91
|
+
private buildPublicAPISection;
|
|
92
|
+
private buildDependenciesSection;
|
|
93
|
+
private buildStatsSection;
|
|
94
|
+
private extractSymbols;
|
|
95
|
+
private toSymbolSummary;
|
|
96
|
+
private relativePath;
|
|
97
|
+
}
|
|
98
|
+
//# sourceMappingURL=codebaseMapGenerator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codebaseMapGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/documentation/codebaseMapGenerator.ts"],"names":[],"mappings":"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"}
|