@dotcontext/cli 0.8.2 → 0.9.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/LICENSE +1 -1
- package/README.md +236 -135
- package/dist/cli/index.d.ts +15 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +29 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/generators/documentation/codebaseMapGenerator.d.ts +29 -46
- package/dist/generators/documentation/codebaseMapGenerator.d.ts.map +1 -1
- package/dist/generators/documentation/codebaseMapGenerator.js +148 -244
- package/dist/generators/documentation/codebaseMapGenerator.js.map +1 -1
- package/dist/generators/documentation/documentationGenerator.d.ts.map +1 -1
- package/dist/generators/documentation/documentationGenerator.js +13 -8
- package/dist/generators/documentation/documentationGenerator.js.map +1 -1
- package/dist/generators/documentation/index.d.ts +1 -1
- package/dist/generators/documentation/index.d.ts.map +1 -1
- package/dist/generators/shared/structures/documentation/architecture.d.ts.map +1 -1
- package/dist/generators/shared/structures/documentation/architecture.js +9 -9
- package/dist/generators/shared/structures/documentation/architecture.js.map +1 -1
- package/dist/generators/shared/structures/documentation/dataFlow.js +2 -2
- package/dist/generators/shared/structures/documentation/dataFlow.js.map +1 -1
- package/dist/generators/shared/structures/documentation/glossary.js +2 -2
- package/dist/generators/shared/structures/documentation/glossary.js.map +1 -1
- package/dist/generators/shared/structures/documentation/projectOverview.d.ts.map +1 -1
- package/dist/generators/shared/structures/documentation/projectOverview.js +10 -11
- package/dist/generators/shared/structures/documentation/projectOverview.js.map +1 -1
- package/dist/generators/shared/structures/skills/factory.d.ts.map +1 -1
- package/dist/generators/shared/structures/skills/factory.js +19 -15
- package/dist/generators/shared/structures/skills/factory.js.map +1 -1
- package/dist/generators/skills/skillGenerator.d.ts +2 -1
- package/dist/generators/skills/skillGenerator.d.ts.map +1 -1
- package/dist/generators/skills/skillGenerator.js +47 -6
- package/dist/generators/skills/skillGenerator.js.map +1 -1
- package/dist/generators/skills/templates/indexTemplate.d.ts.map +1 -1
- package/dist/generators/skills/templates/indexTemplate.js +22 -15
- package/dist/generators/skills/templates/indexTemplate.js.map +1 -1
- package/dist/harness/index.d.ts +11 -0
- package/dist/harness/index.d.ts.map +1 -0
- package/dist/harness/index.js +33 -0
- package/dist/harness/index.js.map +1 -0
- package/dist/index.js +370 -378
- package/dist/index.js.map +1 -1
- package/dist/mcp/bin.d.ts +19 -0
- package/dist/mcp/bin.d.ts.map +1 -0
- package/dist/mcp/bin.js +206 -0
- package/dist/mcp/bin.js.map +1 -0
- package/dist/mcp/index.d.ts +12 -0
- package/dist/mcp/index.d.ts.map +1 -0
- package/dist/mcp/index.js +28 -0
- package/dist/mcp/index.js.map +1 -0
- package/dist/services/autoFill/autoFillService.d.ts.map +1 -1
- package/dist/services/autoFill/autoFillService.js +7 -6
- package/dist/services/autoFill/autoFillService.js.map +1 -1
- package/dist/services/cli/index.d.ts +8 -0
- package/dist/services/cli/index.d.ts.map +1 -0
- package/dist/services/cli/index.js +19 -0
- package/dist/services/cli/index.js.map +1 -0
- package/dist/services/cli/mcpInstallService.d.ts +75 -0
- package/dist/services/cli/mcpInstallService.d.ts.map +1 -0
- package/dist/services/cli/mcpInstallService.js +646 -0
- package/dist/services/cli/mcpInstallService.js.map +1 -0
- package/dist/services/cli/stateDetector.d.ts +55 -0
- package/dist/services/cli/stateDetector.d.ts.map +1 -0
- package/dist/services/cli/stateDetector.js +191 -0
- package/dist/services/cli/stateDetector.js.map +1 -0
- package/dist/services/export/contextExportService.js +3 -3
- package/dist/services/export/contextExportService.js.map +1 -1
- package/dist/services/export/exportRulesService.d.ts +1 -0
- package/dist/services/export/exportRulesService.d.ts.map +1 -1
- package/dist/services/export/exportRulesService.js +20 -8
- package/dist/services/export/exportRulesService.js.map +1 -1
- package/dist/services/export/skillExportService.d.ts.map +1 -1
- package/dist/services/export/skillExportService.js +4 -1
- package/dist/services/export/skillExportService.js.map +1 -1
- package/dist/services/harness/agentsService.d.ts +31 -0
- package/dist/services/harness/agentsService.d.ts.map +1 -0
- package/dist/services/harness/agentsService.js +135 -0
- package/dist/services/harness/agentsService.js.map +1 -0
- package/dist/services/harness/contextService.d.ts +167 -0
- package/dist/services/harness/contextService.d.ts.map +1 -0
- package/dist/services/harness/contextService.js +403 -0
- package/dist/services/harness/contextService.js.map +1 -0
- package/dist/services/harness/contextTools.d.ts +95 -0
- package/dist/services/harness/contextTools.d.ts.map +1 -0
- package/dist/services/harness/contextTools.js +990 -0
- package/dist/services/harness/contextTools.js.map +1 -0
- package/dist/services/harness/datasetService.d.ts +63 -0
- package/dist/services/harness/datasetService.d.ts.map +1 -0
- package/dist/services/harness/datasetService.js +261 -0
- package/dist/services/harness/datasetService.js.map +1 -0
- package/dist/services/harness/executionService.d.ts +74 -0
- package/dist/services/harness/executionService.d.ts.map +1 -0
- package/dist/services/harness/executionService.js +213 -0
- package/dist/services/harness/executionService.js.map +1 -0
- package/dist/services/harness/index.d.ts +21 -0
- package/dist/services/harness/index.d.ts.map +1 -0
- package/dist/services/harness/index.js +52 -0
- package/dist/services/harness/index.js.map +1 -0
- package/dist/services/harness/plansService.d.ts +45 -0
- package/dist/services/harness/plansService.d.ts.map +1 -0
- package/dist/services/harness/plansService.js +251 -0
- package/dist/services/harness/plansService.js.map +1 -0
- package/dist/services/harness/policyService.d.ts +116 -0
- package/dist/services/harness/policyService.d.ts.map +1 -0
- package/dist/services/harness/policyService.js +510 -0
- package/dist/services/harness/policyService.js.map +1 -0
- package/dist/services/harness/replayService.d.ts +63 -0
- package/dist/services/harness/replayService.d.ts.map +1 -0
- package/dist/services/harness/replayService.js +242 -0
- package/dist/services/harness/replayService.js.map +1 -0
- package/dist/services/harness/runtimeStateService.d.ts +120 -0
- package/dist/services/harness/runtimeStateService.d.ts.map +1 -0
- package/dist/services/harness/runtimeStateService.js +316 -0
- package/dist/services/harness/runtimeStateService.js.map +1 -0
- package/dist/services/harness/sensorCatalogService.d.ts +50 -0
- package/dist/services/harness/sensorCatalogService.d.ts.map +1 -0
- package/dist/services/harness/sensorCatalogService.js +308 -0
- package/dist/services/harness/sensorCatalogService.js.map +1 -0
- package/dist/services/harness/sensorsService.d.ts +64 -0
- package/dist/services/harness/sensorsService.d.ts.map +1 -0
- package/dist/services/harness/sensorsService.js +88 -0
- package/dist/services/harness/sensorsService.js.map +1 -0
- package/dist/services/harness/skillsService.d.ts +31 -0
- package/dist/services/harness/skillsService.d.ts.map +1 -0
- package/dist/services/harness/skillsService.js +296 -0
- package/dist/services/harness/skillsService.js.map +1 -0
- package/dist/services/harness/taskContractsService.d.ts +88 -0
- package/dist/services/harness/taskContractsService.d.ts.map +1 -0
- package/dist/services/harness/taskContractsService.js +210 -0
- package/dist/services/harness/taskContractsService.js.map +1 -0
- package/dist/services/harness/workflowStateService.d.ts +51 -0
- package/dist/services/harness/workflowStateService.d.ts.map +1 -0
- package/dist/services/harness/workflowStateService.js +215 -0
- package/dist/services/harness/workflowStateService.js.map +1 -0
- package/dist/services/import/agentsDetector.d.ts.map +1 -1
- package/dist/services/import/agentsDetector.js +14 -8
- package/dist/services/import/agentsDetector.js.map +1 -1
- package/dist/services/import/importAgentsService.d.ts +2 -2
- package/dist/services/import/importAgentsService.d.ts.map +1 -1
- package/dist/services/import/importAgentsService.js +8 -1
- package/dist/services/import/importAgentsService.js.map +1 -1
- package/dist/services/import/importRulesService.d.ts +2 -2
- package/dist/services/import/importRulesService.d.ts.map +1 -1
- package/dist/services/import/importRulesService.js +8 -1
- package/dist/services/import/importRulesService.js.map +1 -1
- package/dist/services/import/presets.js +2 -2
- package/dist/services/import/presets.js.map +1 -1
- package/dist/services/import/rulesDetector.d.ts.map +1 -1
- package/dist/services/import/rulesDetector.js +16 -1
- package/dist/services/import/rulesDetector.js.map +1 -1
- package/dist/services/import/types.d.ts +1 -1
- package/dist/services/import/types.d.ts.map +1 -1
- package/dist/services/mcp/actionLogger.d.ts +2 -1
- package/dist/services/mcp/actionLogger.d.ts.map +1 -1
- package/dist/services/mcp/actionLogger.js +76 -15
- package/dist/services/mcp/actionLogger.js.map +1 -1
- package/dist/services/mcp/gateway/agent.d.ts.map +1 -1
- package/dist/services/mcp/gateway/agent.js +15 -104
- package/dist/services/mcp/gateway/agent.js.map +1 -1
- package/dist/services/mcp/gateway/context.d.ts.map +1 -1
- package/dist/services/mcp/gateway/context.js +60 -172
- package/dist/services/mcp/gateway/context.js.map +1 -1
- package/dist/services/mcp/gateway/explore.js +6 -6
- package/dist/services/mcp/gateway/explore.js.map +1 -1
- package/dist/services/mcp/gateway/harness.d.ts +7 -0
- package/dist/services/mcp/gateway/harness.d.ts.map +1 -0
- package/dist/services/mcp/gateway/harness.js +337 -0
- package/dist/services/mcp/gateway/harness.js.map +1 -0
- package/dist/services/mcp/gateway/index.d.ts +3 -2
- package/dist/services/mcp/gateway/index.d.ts.map +1 -1
- package/dist/services/mcp/gateway/index.js +4 -2
- package/dist/services/mcp/gateway/index.js.map +1 -1
- package/dist/services/mcp/gateway/metrics.d.ts.map +1 -1
- package/dist/services/mcp/gateway/metrics.js +8 -8
- package/dist/services/mcp/gateway/metrics.js.map +1 -1
- package/dist/services/mcp/gateway/plan.d.ts.map +1 -1
- package/dist/services/mcp/gateway/plan.js +23 -211
- package/dist/services/mcp/gateway/plan.js.map +1 -1
- package/dist/services/mcp/gateway/shared.d.ts +1 -32
- package/dist/services/mcp/gateway/shared.d.ts.map +1 -1
- package/dist/services/mcp/gateway/shared.js +4 -30
- package/dist/services/mcp/gateway/shared.js.map +1 -1
- package/dist/services/mcp/gateway/skill.d.ts.map +1 -1
- package/dist/services/mcp/gateway/skill.js +14 -281
- package/dist/services/mcp/gateway/skill.js.map +1 -1
- package/dist/services/mcp/gateway/types.d.ts +74 -3
- package/dist/services/mcp/gateway/types.d.ts.map +1 -1
- package/dist/services/mcp/gateway/workflowAdvance.d.ts.map +1 -1
- package/dist/services/mcp/gateway/workflowAdvance.js +37 -9
- package/dist/services/mcp/gateway/workflowAdvance.js.map +1 -1
- package/dist/services/mcp/gateway/workflowInit.d.ts.map +1 -1
- package/dist/services/mcp/gateway/workflowInit.js +8 -2
- package/dist/services/mcp/gateway/workflowInit.js.map +1 -1
- package/dist/services/mcp/gateway/workflowManage.d.ts +17 -1
- package/dist/services/mcp/gateway/workflowManage.d.ts.map +1 -1
- package/dist/services/mcp/gateway/workflowManage.js +155 -10
- package/dist/services/mcp/gateway/workflowManage.js.map +1 -1
- package/dist/services/mcp/gateway/workflowStatus.d.ts.map +1 -1
- package/dist/services/mcp/gateway/workflowStatus.js +5 -3
- package/dist/services/mcp/gateway/workflowStatus.js.map +1 -1
- package/dist/services/mcp/gatewayTools.d.ts +1 -1
- package/dist/services/mcp/gatewayTools.d.ts.map +1 -1
- package/dist/services/mcp/gatewayTools.js +2 -1
- package/dist/services/mcp/gatewayTools.js.map +1 -1
- package/dist/services/mcp/index.d.ts +10 -4
- package/dist/services/mcp/index.d.ts.map +1 -1
- package/dist/services/mcp/index.js +9 -3
- package/dist/services/mcp/index.js.map +1 -1
- package/dist/services/mcp/mcpInstallService.d.ts +4 -52
- package/dist/services/mcp/mcpInstallService.d.ts.map +1 -1
- package/dist/services/mcp/mcpInstallService.js +5 -596
- package/dist/services/mcp/mcpInstallService.js.map +1 -1
- package/dist/services/mcp/mcpServer.d.ts +5 -6
- package/dist/services/mcp/mcpServer.d.ts.map +1 -1
- package/dist/services/mcp/mcpServer.js +220 -28
- package/dist/services/mcp/mcpServer.js.map +1 -1
- package/dist/services/qa/patternInferer.d.ts +2 -31
- package/dist/services/qa/patternInferer.d.ts.map +1 -1
- package/dist/services/qa/patternInferer.js +4 -353
- package/dist/services/qa/patternInferer.js.map +1 -1
- package/dist/services/qa/qaService.d.ts +6 -10
- package/dist/services/qa/qaService.d.ts.map +1 -1
- package/dist/services/qa/qaService.js +17 -53
- package/dist/services/qa/qaService.js.map +1 -1
- package/dist/services/reverseSync/importSkillsService.d.ts.map +1 -1
- package/dist/services/reverseSync/importSkillsService.js +4 -1
- package/dist/services/reverseSync/importSkillsService.js.map +1 -1
- package/dist/services/reverseSync/reverseQuickSyncService.d.ts.map +1 -1
- package/dist/services/reverseSync/reverseQuickSyncService.js +10 -6
- package/dist/services/reverseSync/reverseQuickSyncService.js.map +1 -1
- package/dist/services/reverseSync/skillsDetector.js +2 -2
- package/dist/services/reverseSync/skillsDetector.js.map +1 -1
- package/dist/services/reverseSync/toolDetector.d.ts.map +1 -1
- package/dist/services/reverseSync/toolDetector.js +3 -0
- package/dist/services/reverseSync/toolDetector.js.map +1 -1
- package/dist/services/semantic/index.d.ts +1 -0
- package/dist/services/semantic/index.d.ts.map +1 -1
- package/dist/services/semantic/index.js +3 -1
- package/dist/services/semantic/index.js.map +1 -1
- package/dist/services/semantic/semanticSnapshotService.d.ts +86 -0
- package/dist/services/semantic/semanticSnapshotService.d.ts.map +1 -0
- package/dist/services/semantic/semanticSnapshotService.js +573 -0
- package/dist/services/semantic/semanticSnapshotService.js.map +1 -0
- package/dist/services/shared/contentTypeRegistry.d.ts.map +1 -1
- package/dist/services/shared/contentTypeRegistry.js +9 -0
- package/dist/services/shared/contentTypeRegistry.js.map +1 -1
- package/dist/services/shared/contextLayout.d.ts +18 -0
- package/dist/services/shared/contextLayout.d.ts.map +1 -0
- package/dist/services/shared/contextLayout.js +139 -0
- package/dist/services/shared/contextLayout.js.map +1 -0
- package/dist/services/shared/executionContext.d.ts +38 -0
- package/dist/services/shared/executionContext.d.ts.map +1 -0
- package/dist/services/shared/executionContext.js +39 -0
- package/dist/services/shared/executionContext.js.map +1 -0
- package/dist/services/shared/index.d.ts +2 -0
- package/dist/services/shared/index.d.ts.map +1 -1
- package/dist/services/shared/index.js +11 -1
- package/dist/services/shared/index.js.map +1 -1
- package/dist/services/shared/toolRegistry.d.ts +6 -0
- package/dist/services/shared/toolRegistry.d.ts.map +1 -1
- package/dist/services/shared/toolRegistry.js +34 -20
- package/dist/services/shared/toolRegistry.js.map +1 -1
- package/dist/services/stack/scaffoldFilter.d.ts +3 -3
- package/dist/services/state/stateDetector.d.ts +4 -49
- package/dist/services/state/stateDetector.d.ts.map +1 -1
- package/dist/services/state/stateDetector.js +9 -182
- package/dist/services/state/stateDetector.js.map +1 -1
- package/dist/services/sync/index.d.ts +1 -1
- package/dist/services/sync/index.d.ts.map +1 -1
- package/dist/services/sync/index.js.map +1 -1
- package/dist/services/sync/markdownReferenceHandler.d.ts.map +1 -1
- package/dist/services/sync/markdownReferenceHandler.js +7 -2
- package/dist/services/sync/markdownReferenceHandler.js.map +1 -1
- package/dist/services/sync/presets.d.ts.map +1 -1
- package/dist/services/sync/presets.js +1 -0
- package/dist/services/sync/presets.js.map +1 -1
- package/dist/services/sync/symlinkHandler.d.ts.map +1 -1
- package/dist/services/sync/symlinkHandler.js +7 -2
- package/dist/services/sync/symlinkHandler.js.map +1 -1
- package/dist/services/sync/syncService.d.ts +2 -2
- package/dist/services/sync/syncService.d.ts.map +1 -1
- package/dist/services/sync/syncService.js +17 -3
- package/dist/services/sync/syncService.js.map +1 -1
- package/dist/services/sync/types.d.ts +9 -1
- package/dist/services/sync/types.d.ts.map +1 -1
- package/dist/services/workflow/index.d.ts +1 -1
- package/dist/services/workflow/index.d.ts.map +1 -1
- package/dist/services/workflow/index.js +2 -1
- package/dist/services/workflow/index.js.map +1 -1
- package/dist/services/workflow/workflowService.d.ts +68 -0
- package/dist/services/workflow/workflowService.d.ts.map +1 -1
- package/dist/services/workflow/workflowService.js +416 -1
- package/dist/services/workflow/workflowService.js.map +1 -1
- package/dist/utils/gitignoreManager.d.ts +8 -0
- package/dist/utils/gitignoreManager.d.ts.map +1 -1
- package/dist/utils/gitignoreManager.js +40 -0
- package/dist/utils/gitignoreManager.js.map +1 -1
- package/dist/utils/i18n.d.ts +1 -1
- package/dist/utils/i18n.js +2 -2
- package/dist/utils/i18n.js.map +1 -1
- package/dist/utils/processShutdown.d.ts +20 -0
- package/dist/utils/processShutdown.d.ts.map +1 -0
- package/dist/utils/processShutdown.js +47 -0
- package/dist/utils/processShutdown.js.map +1 -0
- package/dist/utils/prompts/index.d.ts +1 -1
- package/dist/utils/prompts/index.d.ts.map +1 -1
- package/dist/utils/prompts/index.js +1 -3
- package/dist/utils/prompts/index.js.map +1 -1
- package/dist/utils/prompts/smartDefaults.d.ts +0 -9
- package/dist/utils/prompts/smartDefaults.d.ts.map +1 -1
- package/dist/utils/prompts/smartDefaults.js +0 -23
- package/dist/utils/prompts/smartDefaults.js.map +1 -1
- package/dist/utils/prompts/types.d.ts +0 -11
- package/dist/utils/prompts/types.d.ts.map +1 -1
- package/dist/workflow/index.d.ts +1 -1
- package/dist/workflow/index.d.ts.map +1 -1
- package/dist/workflow/index.js +6 -1
- package/dist/workflow/index.js.map +1 -1
- package/dist/workflow/orchestrator.d.ts.map +1 -1
- package/dist/workflow/orchestrator.js +3 -14
- package/dist/workflow/orchestrator.js.map +1 -1
- package/dist/workflow/plans/planLinker.d.ts +13 -0
- package/dist/workflow/plans/planLinker.d.ts.map +1 -1
- package/dist/workflow/plans/planLinker.js +77 -2
- package/dist/workflow/plans/planLinker.js.map +1 -1
- package/dist/workflow/plans/types.d.ts +6 -0
- package/dist/workflow/plans/types.d.ts.map +1 -1
- package/dist/workflow/skills/frontmatter.d.ts +9 -0
- package/dist/workflow/skills/frontmatter.d.ts.map +1 -1
- package/dist/workflow/skills/frontmatter.js +16 -0
- package/dist/workflow/skills/frontmatter.js.map +1 -1
- package/dist/workflow/skills/index.d.ts +1 -1
- package/dist/workflow/skills/index.d.ts.map +1 -1
- package/dist/workflow/skills/index.js +3 -1
- package/dist/workflow/skills/index.js.map +1 -1
- package/dist/workflow/skills/skillRegistry.d.ts.map +1 -1
- package/dist/workflow/skills/skillRegistry.js +4 -1
- package/dist/workflow/skills/skillRegistry.js.map +1 -1
- package/dist/workflow/skills/skillTemplates.d.ts.map +1 -1
- package/dist/workflow/skills/skillTemplates.js +69 -30
- package/dist/workflow/skills/skillTemplates.js.map +1 -1
- package/dist/workflow/status/statusManager.d.ts +8 -3
- package/dist/workflow/status/statusManager.d.ts.map +1 -1
- package/dist/workflow/status/statusManager.js +60 -21
- package/dist/workflow/status/statusManager.js.map +1 -1
- package/dist/workflow/types.d.ts +1 -1
- package/package.json +17 -8
- package/dist/services/ai/aiSdkClient.d.ts +0 -67
- package/dist/services/ai/aiSdkClient.d.ts.map +0 -1
- package/dist/services/ai/aiSdkClient.js +0 -143
- package/dist/services/ai/aiSdkClient.js.map +0 -1
- package/dist/services/ai/index.d.ts +0 -5
- package/dist/services/ai/index.d.ts.map +0 -1
- package/dist/services/ai/index.js +0 -40
- package/dist/services/ai/index.js.map +0 -1
- package/dist/services/ai/providerFactory.d.ts +0 -35
- package/dist/services/ai/providerFactory.d.ts.map +0 -1
- package/dist/services/ai/providerFactory.js +0 -107
- package/dist/services/ai/providerFactory.js.map +0 -1
- package/dist/services/ai/schemas.d.ts +0 -557
- package/dist/services/ai/schemas.d.ts.map +0 -1
- package/dist/services/ai/schemas.js +0 -357
- package/dist/services/ai/schemas.js.map +0 -1
- package/dist/services/ai/toolRegistry.d.ts +0 -27
- package/dist/services/ai/toolRegistry.d.ts.map +0 -1
- package/dist/services/ai/toolRegistry.js +0 -151
- package/dist/services/ai/toolRegistry.js.map +0 -1
- package/dist/services/ai/tools/analyzeSymbolsTool.d.ts +0 -33
- package/dist/services/ai/tools/analyzeSymbolsTool.d.ts.map +0 -1
- package/dist/services/ai/tools/analyzeSymbolsTool.js +0 -57
- package/dist/services/ai/tools/analyzeSymbolsTool.js.map +0 -1
- package/dist/services/ai/tools/checkScaffoldingTool.d.ts +0 -18
- package/dist/services/ai/tools/checkScaffoldingTool.d.ts.map +0 -1
- package/dist/services/ai/tools/checkScaffoldingTool.js +0 -89
- package/dist/services/ai/tools/checkScaffoldingTool.js.map +0 -1
- package/dist/services/ai/tools/fillScaffoldingTool.d.ts +0 -124
- package/dist/services/ai/tools/fillScaffoldingTool.d.ts.map +0 -1
- package/dist/services/ai/tools/fillScaffoldingTool.js +0 -397
- package/dist/services/ai/tools/fillScaffoldingTool.js.map +0 -1
- package/dist/services/ai/tools/getCodebaseMapTool.d.ts +0 -17
- package/dist/services/ai/tools/getCodebaseMapTool.d.ts.map +0 -1
- package/dist/services/ai/tools/getCodebaseMapTool.js +0 -122
- package/dist/services/ai/tools/getCodebaseMapTool.js.map +0 -1
- package/dist/services/ai/tools/getFileStructureTool.d.ts +0 -29
- package/dist/services/ai/tools/getFileStructureTool.d.ts.map +0 -1
- package/dist/services/ai/tools/getFileStructureTool.js +0 -48
- package/dist/services/ai/tools/getFileStructureTool.js.map +0 -1
- package/dist/services/ai/tools/index.d.ts +0 -21
- package/dist/services/ai/tools/index.d.ts.map +0 -1
- package/dist/services/ai/tools/index.js +0 -75
- package/dist/services/ai/tools/index.js.map +0 -1
- package/dist/services/ai/tools/initializeContextTool.d.ts +0 -135
- package/dist/services/ai/tools/initializeContextTool.d.ts.map +0 -1
- package/dist/services/ai/tools/initializeContextTool.js +0 -447
- package/dist/services/ai/tools/initializeContextTool.js.map +0 -1
- package/dist/services/ai/tools/listFilesTool.d.ts +0 -18
- package/dist/services/ai/tools/listFilesTool.d.ts.map +0 -1
- package/dist/services/ai/tools/listFilesTool.js +0 -34
- package/dist/services/ai/tools/listFilesTool.js.map +0 -1
- package/dist/services/ai/tools/readFileTool.d.ts +0 -17
- package/dist/services/ai/tools/readFileTool.d.ts.map +0 -1
- package/dist/services/ai/tools/readFileTool.js +0 -63
- package/dist/services/ai/tools/readFileTool.js.map +0 -1
- package/dist/services/ai/tools/scaffoldPlanTool.d.ts +0 -41
- package/dist/services/ai/tools/scaffoldPlanTool.d.ts.map +0 -1
- package/dist/services/ai/tools/scaffoldPlanTool.js +0 -183
- package/dist/services/ai/tools/scaffoldPlanTool.js.map +0 -1
- package/dist/services/ai/tools/searchCodeTool.d.ts +0 -25
- package/dist/services/ai/tools/searchCodeTool.d.ts.map +0 -1
- package/dist/services/ai/tools/searchCodeTool.js +0 -96
- package/dist/services/ai/tools/searchCodeTool.js.map +0 -1
- package/dist/services/baseLLMClient.d.ts +0 -12
- package/dist/services/baseLLMClient.d.ts.map +0 -1
- package/dist/services/baseLLMClient.js +0 -80
- package/dist/services/baseLLMClient.js.map +0 -1
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -6,29 +6,91 @@
|
|
|
6
6
|
|
|
7
7
|
> **Formerly `@ai-coders/context`.** Renamed to avoid confusion with Context7 and other "context" tools in the AI space. The `.context/` directory standard is unchanged. See [Migration Guide](#migration-from-ai-coderscontext).
|
|
8
8
|
|
|
9
|
-
**
|
|
10
|
-
Context engineering for AI now is stupidly simple.
|
|
9
|
+
**Dotcontext is a harness engineering runtime for AI-assisted software delivery.**
|
|
11
10
|
|
|
12
|
-
|
|
11
|
+
It gives coding agents a real operating environment instead of a loose prompt and a pile of conventions. Dotcontext combines shared project context, workflow structure, policies, sensors, task contracts, replayable execution history, and MCP access into one system.
|
|
13
12
|
|
|
14
|
-
|
|
13
|
+
The point is not just to "give the model more context". The point is to make agent execution legible, constrained, reusable, and auditable.
|
|
15
14
|
|
|
16
|
-
|
|
15
|
+
## What Dotcontext Is
|
|
17
16
|
|
|
17
|
+
Dotcontext is three things at once:
|
|
18
|
+
|
|
19
|
+
- a `.context/` convention for durable project knowledge
|
|
20
|
+
- a harness runtime that governs how agents execute work
|
|
21
|
+
- a CLI and MCP surface that expose that runtime to humans and AI tools
|
|
22
|
+
|
|
23
|
+
PREVC remains the default execution model for structured work: **Planning, Review, Execution, Validation, and Confirmation**.
|
|
24
|
+
|
|
25
|
+
## Why Dotcontext Exists
|
|
26
|
+
|
|
27
|
+
Most agent workflows break down for the same reasons:
|
|
28
|
+
|
|
29
|
+
- project knowledge is scattered across tool-specific formats
|
|
30
|
+
- execution rules live in prompts instead of in runtime controls
|
|
31
|
+
- agents can change code without producing evidence
|
|
32
|
+
- there is no durable record of why an agent did what it did
|
|
33
|
+
- teams cannot reuse the same operating model across Claude, Cursor, Codex, Copilot, and others
|
|
34
|
+
|
|
35
|
+
Dotcontext exists to solve that layer, not just the prompt layer.
|
|
36
|
+
|
|
37
|
+
## Architecture
|
|
38
|
+
|
|
39
|
+
Dotcontext is now organized around an explicit harness runtime:
|
|
40
|
+
|
|
41
|
+
```text
|
|
42
|
+
cli -> harness <- mcp
|
|
18
43
|
```
|
|
19
|
-
.cursor/rules/ # Cursor
|
|
20
|
-
.claude/ # Claude Code
|
|
21
|
-
.windsurf/rules/ # Windsurf
|
|
22
|
-
.github/agents/ # Copilot
|
|
23
|
-
.cline/ # Cline
|
|
24
|
-
.agent/rules/ # Google Antigravity
|
|
25
|
-
.trae/rules/ # Trae AI
|
|
26
|
-
AGENTS.md # Codex
|
|
27
|
-
```
|
|
28
44
|
|
|
29
|
-
|
|
45
|
+
- `@dotcontext/cli` is the operator-facing surface
|
|
46
|
+
- `dotcontext/harness` is the reusable runtime and domain layer
|
|
47
|
+
- `dotcontext/mcp` is the MCP transport adapter
|
|
48
|
+
|
|
49
|
+
The main architecture reference, with Mermaid diagrams for runtime flow, boundaries, and packaging, lives in [ARCHITECTURE.md](./ARCHITECTURE.md).
|
|
50
|
+
|
|
51
|
+
## Problems It Solves
|
|
52
|
+
|
|
53
|
+
### 1. Context Fragmentation
|
|
54
|
+
|
|
55
|
+
Every AI coding tool now has a primary surface plus older compatibility paths that still show up in the wild. Dotcontext keeps track of both so teams can write against the current surface without losing legacy imports.
|
|
56
|
+
|
|
57
|
+
| Tool | Primary surface | Legacy / compatibility surface |
|
|
58
|
+
| --- | --- | --- |
|
|
59
|
+
| Cursor | `.cursor/rules/*.mdc`, `AGENTS.md`-scoped instructions | `.cursorrules`, `.cursor/rules/*.md` |
|
|
60
|
+
| Claude Code | `CLAUDE.md`, `.claude/agents`, `.claude/skills` | older memory-style files under `.claude/` |
|
|
61
|
+
| GitHub Copilot | `.github/copilot-instructions.md`, `.github/instructions/*.instructions.md`, `.github/agents/*.agent.md`, `.github/skills` | `.github/copilot/*` and `.github/.copilot/*` |
|
|
62
|
+
| Windsurf | `AGENTS.md`, `.windsurf/rules`, `.windsurf/skills` | `.windsurfrules`, older `.windsurf/` rule files |
|
|
63
|
+
| Gemini | `GEMINI.md`, `.gemini/commands`, `.gemini/settings.json`, `.gemini/skills` | older `.gemini/` config layouts |
|
|
64
|
+
| Codex | `AGENTS.md`, `.codex/skills`, `.codex/config.toml` | `.codex/instructions.md` |
|
|
65
|
+
| Google Antigravity | `.agents/rules`, `.agents/workflows` | older `.agent/` layouts |
|
|
66
|
+
| Trae AI | `.trae/rules`, `.trae/agents` | older `.trae/` rule files |
|
|
67
|
+
|
|
68
|
+
Using multiple tools means duplicating rules, playbooks, and documentation across incompatible formats.
|
|
69
|
+
|
|
70
|
+
### 2. Weak Runtime Control
|
|
71
|
+
|
|
72
|
+
Most agent setups still rely on:
|
|
73
|
+
|
|
74
|
+
- a long agent file
|
|
75
|
+
- a few MCP tools
|
|
76
|
+
- best-effort conventions
|
|
77
|
+
|
|
78
|
+
That is not enough for production-grade behavior. You need runtime controls such as policies, sensors, contracts, and backpressure.
|
|
79
|
+
|
|
80
|
+
### 3. No Durable Execution Model
|
|
81
|
+
|
|
82
|
+
Without sessions, traces, artifacts, and replay:
|
|
83
|
+
|
|
84
|
+
- agents cannot hand off work cleanly
|
|
85
|
+
- failures are hard to cluster and learn from
|
|
86
|
+
- workflow gates are hard to enforce
|
|
87
|
+
- evaluation becomes anecdotal instead of operational
|
|
30
88
|
|
|
31
|
-
##
|
|
89
|
+
## What Dotcontext Does
|
|
90
|
+
|
|
91
|
+
Dotcontext consolidates those concerns into one operating model.
|
|
92
|
+
|
|
93
|
+
### Shared Context
|
|
32
94
|
|
|
33
95
|
One `.context/` directory. Works everywhere.
|
|
34
96
|
|
|
@@ -43,11 +105,54 @@ One `.context/` directory. Works everywhere.
|
|
|
43
105
|
Export to any tool.
|
|
44
106
|
**Write once. Use anywhere. No boilerplate.**
|
|
45
107
|
|
|
108
|
+
### Harness Runtime
|
|
109
|
+
|
|
110
|
+
The runtime adds execution controls on top of the shared context:
|
|
111
|
+
|
|
112
|
+
- durable sessions, traces, artifacts, and checkpoints
|
|
113
|
+
- sensors and backpressure
|
|
114
|
+
- task contracts and handoffs
|
|
115
|
+
- policy enforcement
|
|
116
|
+
- replay and failure dataset generation
|
|
117
|
+
|
|
118
|
+
### Multi-Surface Access
|
|
119
|
+
|
|
120
|
+
The same runtime is exposed through:
|
|
121
|
+
|
|
122
|
+
- `@dotcontext/cli` for operator workflows
|
|
123
|
+
- `dotcontext/mcp` for AI tools
|
|
124
|
+
- `dotcontext/harness` as the reusable domain/runtime boundary
|
|
125
|
+
|
|
126
|
+
## How The Harness Works
|
|
127
|
+
|
|
128
|
+
At runtime, both the CLI and the MCP server delegate to the same harness services. The harness is responsible for:
|
|
129
|
+
|
|
130
|
+
- durable sessions, traces, artifacts, and checkpoints
|
|
131
|
+
- sensors and backpressure
|
|
132
|
+
- task contracts and handoffs
|
|
133
|
+
- policy enforcement
|
|
134
|
+
- replay generation
|
|
135
|
+
- failure dataset clustering
|
|
136
|
+
|
|
137
|
+
```mermaid
|
|
138
|
+
flowchart LR
|
|
139
|
+
CLI["CLI"] --> H["Harness Runtime"]
|
|
140
|
+
MCP["MCP Server"] --> H
|
|
141
|
+
|
|
142
|
+
H --> S["Sessions + State"]
|
|
143
|
+
H --> Q["Sensors + Backpressure"]
|
|
144
|
+
H --> T["Task Contracts + Handoffs"]
|
|
145
|
+
H --> P["Policy Engine"]
|
|
146
|
+
H --> R["Replay + Datasets"]
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
For the full system view, see [ARCHITECTURE.md](./ARCHITECTURE.md).
|
|
150
|
+
|
|
46
151
|
> **Using GitHub Copilot, Cursor, Claude, or another AI tool?**
|
|
47
|
-
> Just run `npx @dotcontext/
|
|
152
|
+
> Just run `npx @dotcontext/mcp install` — no API key needed!
|
|
48
153
|
>
|
|
49
154
|
> **Usando GitHub Copilot, Cursor, Claude ou outra ferramenta de IA?**
|
|
50
|
-
> Execute `npx @dotcontext/
|
|
155
|
+
> Execute `npx @dotcontext/mcp install` — sem necessidade de API key!
|
|
51
156
|
|
|
52
157
|
> **Note / Nota**
|
|
53
158
|
> Standalone CLI generation is no longer supported. Use MCP-enabled AI tools to create, fill, or refresh context.
|
|
@@ -59,7 +164,7 @@ Export to any tool.
|
|
|
59
164
|
|
|
60
165
|
#### English
|
|
61
166
|
|
|
62
|
-
1. Run `npx @dotcontext/
|
|
167
|
+
1. Run `npx @dotcontext/mcp install`
|
|
63
168
|
2. Prompt your AI agent: `init the context`
|
|
64
169
|
3. Then: `plan [YOUR TASK] using dotcontext`
|
|
65
170
|
4. After planned: `start the workflow`
|
|
@@ -68,237 +173,229 @@ Export to any tool.
|
|
|
68
173
|
|
|
69
174
|
#### Português
|
|
70
175
|
|
|
71
|
-
1. Execute `npx @dotcontext/
|
|
176
|
+
1. Execute `npx @dotcontext/mcp install`
|
|
72
177
|
2. Diga ao seu agente de IA: `init the context`
|
|
73
178
|
3. Depois: `plan [SUA TAREFA] using dotcontext`
|
|
74
179
|
4. Após o planejamento: `start the workflow`
|
|
75
180
|
|
|
76
181
|
**Sem necessidade de API key.** Sua ferramenta de IA fornece o LLM.
|
|
77
182
|
|
|
78
|
-
### Path 2: Standalone CLI —
|
|
183
|
+
### Path 2: Standalone CLI — sync, imports, and admin tools
|
|
79
184
|
|
|
80
185
|
#### English
|
|
81
186
|
|
|
82
|
-
1. Run `npx @dotcontext/cli`
|
|
83
|
-
2. Use the interactive CLI for
|
|
187
|
+
1. Run `npx -y @dotcontext/cli@latest`
|
|
188
|
+
2. Use the interactive CLI for sync, reverse sync, hidden admin tools, and MCP setup
|
|
84
189
|
3. When you need context creation or AI-generated content, use your MCP-connected AI tool
|
|
85
190
|
|
|
86
191
|
#### Português
|
|
87
192
|
|
|
88
|
-
1. Execute `npx @dotcontext/cli`
|
|
89
|
-
2. Use a CLI interativa para
|
|
193
|
+
1. Execute `npx -y @dotcontext/cli@latest`
|
|
194
|
+
2. Use a CLI interativa para sincronização, reverse sync, ferramentas administrativas ocultas e configuração MCP
|
|
90
195
|
3. Quando precisar criar contexto ou gerar conteúdo com IA, use sua ferramenta conectada via MCP
|
|
91
196
|
|
|
92
197
|
## MCP Server Setup
|
|
93
198
|
|
|
94
199
|
This package includes an MCP (Model Context Protocol) server that provides AI coding assistants with powerful tools to analyze and document your codebase.
|
|
95
200
|
|
|
96
|
-
###
|
|
201
|
+
### Recommended Installation
|
|
97
202
|
|
|
98
|
-
Use the
|
|
203
|
+
Use the installer. It is the source of truth for supported tools and config formats:
|
|
99
204
|
|
|
100
205
|
```bash
|
|
101
|
-
npx @dotcontext/
|
|
206
|
+
npx @dotcontext/mcp install
|
|
102
207
|
```
|
|
103
208
|
|
|
104
|
-
|
|
209
|
+
If you already have the MCP package installed globally, `dotcontext-mcp install` works too. The legacy `dotcontext mcp:install` CLI flow still works as a compatibility path.
|
|
210
|
+
|
|
211
|
+
The installer:
|
|
105
212
|
- Detects installed AI tools on your system
|
|
106
|
-
-
|
|
213
|
+
- Opens the interactive tool picker when you run `install` in a terminal without a tool id
|
|
214
|
+
- Configures the `dotcontext` MCP server in each tool
|
|
107
215
|
- Supports global (home directory) and local (project directory) installation
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
|
|
112
|
-
### Manual Configuration
|
|
113
|
-
|
|
114
|
-
Alternatively, manually configure for your preferred tool.
|
|
115
|
-
|
|
116
|
-
### Antigravity
|
|
117
|
-
|
|
118
|
-
#### 1. Access Raw Config
|
|
119
|
-
|
|
120
|
-
The visual interface only shows official partners, but the manual editing mode allows any local or remote executable.
|
|
121
|
-
|
|
122
|
-
1. Open the **Agent** panel (usually in the sidebar or `Ctrl+L`).
|
|
123
|
-
2. Click the options menu (three dots `...`) or the settings icon.
|
|
124
|
-
3. Select **Manage MCP Servers**.
|
|
125
|
-
4. At the top of this screen, look for a discreet button or link named **"View raw config"** or **"Edit JSON"**.
|
|
216
|
+
- Falls back to `all` detected tools in non-interactive runs without a tool id
|
|
217
|
+
- Merges with existing MCP configurations without overwriting unrelated servers
|
|
218
|
+
- Includes `--dry-run` and `--verbose` modes
|
|
219
|
+
- Writes the config shape required by each supported client
|
|
126
220
|
|
|
127
|
-
|
|
221
|
+
Examples:
|
|
128
222
|
|
|
129
|
-
|
|
223
|
+
```bash
|
|
224
|
+
# Interactive install for detected tools
|
|
225
|
+
npx @dotcontext/mcp install
|
|
130
226
|
|
|
131
|
-
|
|
227
|
+
# Install for a specific tool
|
|
228
|
+
npx @dotcontext/mcp install codex
|
|
132
229
|
|
|
133
|
-
|
|
230
|
+
# Install in the current project instead of your home directory
|
|
231
|
+
npx @dotcontext/mcp install cursor --local
|
|
134
232
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
"mcpServers": {
|
|
138
|
-
"dotcontext": {
|
|
139
|
-
"command": "npx",
|
|
140
|
-
"args": ["@dotcontext/cli", "mcp"]
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
}
|
|
233
|
+
# Preview without writing files
|
|
234
|
+
npx @dotcontext/mcp install claude --dry-run --verbose
|
|
144
235
|
```
|
|
145
236
|
|
|
146
|
-
|
|
237
|
+
### Supported MCP Install Targets
|
|
238
|
+
|
|
239
|
+
`install` currently supports these tool ids:
|
|
240
|
+
|
|
241
|
+
| Tool ID | Tool | Config Shape |
|
|
242
|
+
| --- | --- | --- |
|
|
243
|
+
| `claude` | Claude Code | `mcpServers` JSON |
|
|
244
|
+
| `cursor` | Cursor AI | `mcpServers` JSON with `type: "stdio"` |
|
|
245
|
+
| `windsurf` | Windsurf | `mcpServers` JSON |
|
|
246
|
+
| `continue` | Continue.dev | standalone `.continue/mcpServers/dotcontext.json` |
|
|
247
|
+
| `claude-desktop` | Claude Desktop | `mcpServers` JSON |
|
|
248
|
+
| `vscode` | VS Code (GitHub Copilot) | `servers` JSON |
|
|
249
|
+
| `roo` | Roo Code | `mcpServers` JSON |
|
|
250
|
+
| `amazonq` | Amazon Q Developer CLI | `mcpServers` JSON |
|
|
251
|
+
| `gemini-cli` | Gemini CLI | `mcpServers` JSON |
|
|
252
|
+
| `codex` | Codex CLI | TOML `[mcp_servers.dotcontext]` |
|
|
253
|
+
| `kiro` | Kiro | `mcpServers` JSON |
|
|
254
|
+
| `zed` | Zed Editor | `context_servers` JSON |
|
|
255
|
+
| `jetbrains` | JetBrains IDEs | `servers` array |
|
|
256
|
+
| `trae` | Trae AI | `mcpServers` JSON |
|
|
257
|
+
| `kilo` | Kilo Code | `mcp` JSON |
|
|
258
|
+
| `copilot-cli` | GitHub Copilot CLI | `mcpServers` JSON |
|
|
147
259
|
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
1. Return to the **"Manage MCP Servers"** panel.
|
|
151
|
-
2. Click the **Refresh** button or restart the Antigravity environment (*Reload Window*).
|
|
152
|
-
3. The new server should appear in the list with a status indicator (usually a green light if connected successfully).
|
|
260
|
+
### Manual Configuration
|
|
153
261
|
|
|
154
|
-
|
|
262
|
+
Use manual configuration only when you cannot use `@dotcontext/mcp install`. The exact file format depends on the client.
|
|
155
263
|
|
|
156
|
-
|
|
264
|
+
Dotcontext writes this command into client configs:
|
|
157
265
|
|
|
158
|
-
```
|
|
159
|
-
|
|
266
|
+
```text
|
|
267
|
+
command: npx
|
|
268
|
+
args: ["-y", "@dotcontext/mcp@latest"]
|
|
160
269
|
```
|
|
161
270
|
|
|
162
|
-
|
|
271
|
+
#### Standard `mcpServers` JSON
|
|
272
|
+
|
|
273
|
+
Used by tools such as Claude Code, Windsurf, Claude Desktop, Roo Code, Amazon Q Developer CLI, Gemini CLI, Trae AI, and GitHub Copilot CLI.
|
|
163
274
|
|
|
164
275
|
```json
|
|
165
276
|
{
|
|
166
277
|
"mcpServers": {
|
|
167
278
|
"dotcontext": {
|
|
168
279
|
"command": "npx",
|
|
169
|
-
"args": ["
|
|
280
|
+
"args": ["-y", "@dotcontext/mcp@latest"]
|
|
170
281
|
}
|
|
171
282
|
}
|
|
172
283
|
}
|
|
173
284
|
```
|
|
174
285
|
|
|
175
|
-
|
|
286
|
+
#### Cursor
|
|
176
287
|
|
|
177
|
-
|
|
288
|
+
Cursor expects `type: "stdio"`:
|
|
178
289
|
|
|
179
290
|
```json
|
|
180
291
|
{
|
|
181
292
|
"mcpServers": {
|
|
182
293
|
"dotcontext": {
|
|
294
|
+
"type": "stdio",
|
|
183
295
|
"command": "npx",
|
|
184
|
-
"args": ["
|
|
296
|
+
"args": ["-y", "@dotcontext/mcp@latest"]
|
|
185
297
|
}
|
|
186
298
|
}
|
|
187
299
|
}
|
|
188
300
|
```
|
|
189
301
|
|
|
190
|
-
|
|
302
|
+
#### Continue.dev
|
|
191
303
|
|
|
192
|
-
|
|
304
|
+
Continue uses a standalone per-server file:
|
|
193
305
|
|
|
194
306
|
```json
|
|
195
307
|
{
|
|
196
|
-
"
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
"args": ["@dotcontext/cli", "mcp"]
|
|
200
|
-
}
|
|
201
|
-
}
|
|
308
|
+
"command": "npx",
|
|
309
|
+
"args": ["-y", "@dotcontext/mcp@latest"],
|
|
310
|
+
"env": {}
|
|
202
311
|
}
|
|
203
312
|
```
|
|
204
313
|
|
|
205
|
-
|
|
314
|
+
#### VS Code (GitHub Copilot)
|
|
206
315
|
|
|
207
|
-
|
|
316
|
+
VS Code uses `servers` instead of `mcpServers`:
|
|
208
317
|
|
|
209
318
|
```json
|
|
210
319
|
{
|
|
211
|
-
"
|
|
320
|
+
"servers": {
|
|
212
321
|
"dotcontext": {
|
|
322
|
+
"type": "stdio",
|
|
213
323
|
"command": "npx",
|
|
214
|
-
"args": ["
|
|
324
|
+
"args": ["-y", "@dotcontext/mcp@latest"]
|
|
215
325
|
}
|
|
216
326
|
}
|
|
217
327
|
}
|
|
218
328
|
```
|
|
219
329
|
|
|
220
|
-
|
|
330
|
+
#### Zed
|
|
221
331
|
|
|
222
|
-
|
|
332
|
+
Zed uses `context_servers`:
|
|
223
333
|
|
|
224
334
|
```json
|
|
225
335
|
{
|
|
226
336
|
"context_servers": {
|
|
227
337
|
"dotcontext": {
|
|
228
|
-
"command":
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
}
|
|
338
|
+
"command": "npx",
|
|
339
|
+
"args": ["-y", "@dotcontext/mcp@latest"],
|
|
340
|
+
"env": {}
|
|
232
341
|
}
|
|
233
342
|
}
|
|
234
343
|
}
|
|
235
344
|
```
|
|
236
345
|
|
|
237
|
-
|
|
346
|
+
#### JetBrains IDEs
|
|
238
347
|
|
|
239
|
-
|
|
348
|
+
JetBrains uses a `servers` array:
|
|
240
349
|
|
|
241
350
|
```json
|
|
242
351
|
{
|
|
243
|
-
"
|
|
244
|
-
|
|
352
|
+
"servers": [
|
|
353
|
+
{
|
|
354
|
+
"name": "dotcontext",
|
|
245
355
|
"command": "npx",
|
|
246
|
-
"args": ["
|
|
356
|
+
"args": ["-y", "@dotcontext/mcp@latest"],
|
|
357
|
+
"env": {}
|
|
247
358
|
}
|
|
248
|
-
|
|
359
|
+
]
|
|
249
360
|
}
|
|
250
361
|
```
|
|
251
362
|
|
|
252
|
-
|
|
363
|
+
#### Kilo Code
|
|
253
364
|
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
```toml
|
|
257
|
-
[mcp_servers.dotcontext]
|
|
258
|
-
command = "npx"
|
|
259
|
-
args = ["--yes", "@dotcontext/cli@latest", "mcp"]
|
|
260
|
-
```
|
|
261
|
-
|
|
262
|
-
### Google Antigravity
|
|
263
|
-
|
|
264
|
-
Add to your Antigravity MCP config (`~/.gemini/mcp_config.json`):
|
|
365
|
+
Kilo uses `mcp.dotcontext` with a command array:
|
|
265
366
|
|
|
266
367
|
```json
|
|
267
368
|
{
|
|
268
|
-
"
|
|
369
|
+
"mcp": {
|
|
269
370
|
"dotcontext": {
|
|
270
|
-
"
|
|
271
|
-
"
|
|
371
|
+
"type": "local",
|
|
372
|
+
"command": ["npx", "-y", "@dotcontext/mcp@latest"],
|
|
373
|
+
"enabled": true
|
|
272
374
|
}
|
|
273
375
|
}
|
|
274
376
|
}
|
|
275
377
|
```
|
|
276
378
|
|
|
277
|
-
|
|
379
|
+
#### Codex CLI
|
|
278
380
|
|
|
279
|
-
|
|
381
|
+
Codex uses TOML:
|
|
280
382
|
|
|
281
|
-
```
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
"command": "npx",
|
|
286
|
-
"args": ["@dotcontext/cli", "mcp"]
|
|
287
|
-
}
|
|
288
|
-
}
|
|
289
|
-
}
|
|
383
|
+
```toml
|
|
384
|
+
[mcp_servers.dotcontext]
|
|
385
|
+
command = "npx"
|
|
386
|
+
args = ["-y", "@dotcontext/mcp@latest"]
|
|
290
387
|
```
|
|
291
388
|
|
|
292
389
|
### Local Development
|
|
293
390
|
|
|
294
|
-
For local development, point directly to the
|
|
391
|
+
For local development, point directly to the dedicated MCP binary after `npm run build`:
|
|
295
392
|
|
|
296
393
|
```json
|
|
297
394
|
{
|
|
298
395
|
"mcpServers": {
|
|
299
396
|
"dotcontext-dev": {
|
|
300
397
|
"command": "node",
|
|
301
|
-
"args": ["/path/to/
|
|
398
|
+
"args": ["/absolute/path/to/this-repo/dist/mcp/bin.js"]
|
|
302
399
|
}
|
|
303
400
|
}
|
|
304
401
|
}
|
|
@@ -435,7 +532,7 @@ The system automatically detects project scale and adjusts the workflow:
|
|
|
435
532
|
|
|
436
533
|
- Node.js 20+
|
|
437
534
|
|
|
438
|
-
**Context creation, AI generation, and refresh are MCP-only.** Use `npx dotcontext
|
|
535
|
+
**Context creation, AI generation, and refresh are MCP-only.** Use `npx @dotcontext/mcp install` and let your AI tool use its own LLM.
|
|
439
536
|
|
|
440
537
|
### Available MCP Tools
|
|
441
538
|
|
|
@@ -446,12 +543,16 @@ Once configured, your AI assistant will have access to 9 gateway tools with acti
|
|
|
446
543
|
| Gateway | Description | Actions |
|
|
447
544
|
|---------|-------------|---------|
|
|
448
545
|
| **explore** | File and code exploration | `read`, `list`, `analyze`, `search`, `getStructure` |
|
|
449
|
-
| **context** | Context scaffolding
|
|
546
|
+
| **context** | Context scaffolding, semantic context, and optional Q&A/flow helpers | `check`, `bootstrapStatus`, `init`, `fill`, `fillSingle`, `listToFill`, `getMap`, `buildSemantic`, `scaffoldPlan`, `searchQA`, `generateQA`, `getFlow`, `detectPatterns` |
|
|
450
547
|
| **plan** | Plan management and execution tracking | `link`, `getLinked`, `getDetails`, `getForPhase`, `updatePhase`, `recordDecision`, `updateStep`, `getStatus`, `syncMarkdown`, `commitPhase` |
|
|
451
548
|
| **agent** | Agent orchestration and discovery | `discover`, `getInfo`, `orchestrate`, `getSequence`, `getDocs`, `getPhaseDocs`, `listTypes` |
|
|
452
549
|
| **skill** | Skill management for on-demand expertise | `list`, `getContent`, `getForPhase`, `scaffold`, `export`, `fill` |
|
|
453
550
|
| **sync** | Import/export synchronization with AI tools | `exportRules`, `exportDocs`, `exportAgents`, `exportContext`, `exportSkills`, `reverseSync`, `importDocs`, `importAgents`, `importSkills` |
|
|
454
551
|
|
|
552
|
+
`context init` also bootstraps `.context/harness/sensors.json`. While that catalog is still in bootstrap form, `context listToFill`/`fill` can return it so the AI can customize project-specific quality sensors.
|
|
553
|
+
|
|
554
|
+
`searchQA` ranks generated `.context/docs/qa/*.md` helper docs by keyword match. It is a lightweight shortcut, not embedding-based semantic retrieval, and `generateQA` is opt-in.
|
|
555
|
+
|
|
455
556
|
#### Dedicated Workflow Tools
|
|
456
557
|
|
|
457
558
|
| Tool | Description |
|
|
@@ -489,8 +590,8 @@ Skills are task-specific procedures that AI agents activate when needed:
|
|
|
489
590
|
| `security-audit` | Security review checklist | R, V |
|
|
490
591
|
|
|
491
592
|
```bash
|
|
492
|
-
npx dotcontext skill list # List available skills
|
|
493
|
-
npx dotcontext skill export # Export to AI tools
|
|
593
|
+
npx -y @dotcontext/cli@latest admin skill list # List available skills
|
|
594
|
+
npx -y @dotcontext/cli@latest admin skill export # Export to AI tools
|
|
494
595
|
```
|
|
495
596
|
|
|
496
597
|
Use MCP tools from your AI assistant to scaffold, fill, or refresh skills and other context files.
|
|
@@ -528,7 +629,7 @@ The previous name `@ai-coders/context` caused frequent confusion with **Context7
|
|
|
528
629
|
| Before | After |
|
|
529
630
|
|--------|-------|
|
|
530
631
|
| `npm install @ai-coders/context` | `npm install @dotcontext/cli` |
|
|
531
|
-
| `npx @ai-coders/context` | `npx dotcontext` |
|
|
632
|
+
| `npx @ai-coders/context` | `npx -y @dotcontext/cli@latest` |
|
|
532
633
|
| CLI command: `ai-context` | CLI command: `dotcontext` |
|
|
533
634
|
| MCP server name: `"ai-context"` | MCP server name: `"dotcontext"` |
|
|
534
635
|
| Env var: `AI_CONTEXT_LANG` | Env var: `DOTCONTEXT_LANG` |
|
|
@@ -551,9 +652,9 @@ The previous name `@ai-coders/context` caused frequent confusion with **Context7
|
|
|
551
652
|
|
|
552
653
|
2. **Update MCP configurations** -- re-run the installer:
|
|
553
654
|
```bash
|
|
554
|
-
npx dotcontext
|
|
655
|
+
npx @dotcontext/mcp install
|
|
555
656
|
```
|
|
556
|
-
Or manually replace `"ai-context"` with `"dotcontext"` and `"@ai-coders/context"` with `"@dotcontext/
|
|
657
|
+
Or manually replace `"ai-context"` with `"dotcontext"` and `"@ai-coders/context"` with `"@dotcontext/mcp"` in your MCP JSON configs.
|
|
557
658
|
|
|
558
659
|
3. **Update shell aliases** -- replace `ai-context` with `dotcontext` in your `.bashrc`, `.zshrc`, or equivalent.
|
|
559
660
|
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI boundary exports.
|
|
3
|
+
*
|
|
4
|
+
* This module defines the operator-facing surface that is expected to
|
|
5
|
+
* become the future `dotcontext/cli` package. Keep domain/runtime logic
|
|
6
|
+
* out of this boundary whenever possible.
|
|
7
|
+
*/
|
|
8
|
+
export { MCPInstallService, buildMcpInstallToolChoices, resolveMcpInstallToolSelection, type MCPInstallServiceDependencies, type MCPInstallOptions, type MCPInstallResult, type MCPInstallation, type MCPInstallToolChoice, type MCPInstallToolPrompt, type ResolveMcpInstallToolSelectionOptions, StateDetector, type ProjectState, type StateDetectionResult, type StateDetectorOptions, } from '../services/cli';
|
|
9
|
+
export { SyncService } from '../services/sync/syncService';
|
|
10
|
+
export { ImportRulesService, ImportAgentsService } from '../services/import';
|
|
11
|
+
export { ExportRulesService } from '../services/export';
|
|
12
|
+
export { ReportService } from '../services/report';
|
|
13
|
+
export { QuickSyncService, type QuickSyncOptions } from '../services/quickSync';
|
|
14
|
+
export { ReverseQuickSyncService, type MergeStrategy } from '../services/reverseSync';
|
|
15
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,8BAA8B,EAC9B,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,qCAAqC,EAC1C,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* CLI boundary exports.
|
|
4
|
+
*
|
|
5
|
+
* This module defines the operator-facing surface that is expected to
|
|
6
|
+
* become the future `dotcontext/cli` package. Keep domain/runtime logic
|
|
7
|
+
* out of this boundary whenever possible.
|
|
8
|
+
*/
|
|
9
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
10
|
+
exports.ReverseQuickSyncService = exports.QuickSyncService = exports.ReportService = exports.ExportRulesService = exports.ImportAgentsService = exports.ImportRulesService = exports.SyncService = exports.StateDetector = exports.resolveMcpInstallToolSelection = exports.buildMcpInstallToolChoices = exports.MCPInstallService = void 0;
|
|
11
|
+
var cli_1 = require("../services/cli");
|
|
12
|
+
Object.defineProperty(exports, "MCPInstallService", { enumerable: true, get: function () { return cli_1.MCPInstallService; } });
|
|
13
|
+
Object.defineProperty(exports, "buildMcpInstallToolChoices", { enumerable: true, get: function () { return cli_1.buildMcpInstallToolChoices; } });
|
|
14
|
+
Object.defineProperty(exports, "resolveMcpInstallToolSelection", { enumerable: true, get: function () { return cli_1.resolveMcpInstallToolSelection; } });
|
|
15
|
+
Object.defineProperty(exports, "StateDetector", { enumerable: true, get: function () { return cli_1.StateDetector; } });
|
|
16
|
+
var syncService_1 = require("../services/sync/syncService");
|
|
17
|
+
Object.defineProperty(exports, "SyncService", { enumerable: true, get: function () { return syncService_1.SyncService; } });
|
|
18
|
+
var import_1 = require("../services/import");
|
|
19
|
+
Object.defineProperty(exports, "ImportRulesService", { enumerable: true, get: function () { return import_1.ImportRulesService; } });
|
|
20
|
+
Object.defineProperty(exports, "ImportAgentsService", { enumerable: true, get: function () { return import_1.ImportAgentsService; } });
|
|
21
|
+
var export_1 = require("../services/export");
|
|
22
|
+
Object.defineProperty(exports, "ExportRulesService", { enumerable: true, get: function () { return export_1.ExportRulesService; } });
|
|
23
|
+
var report_1 = require("../services/report");
|
|
24
|
+
Object.defineProperty(exports, "ReportService", { enumerable: true, get: function () { return report_1.ReportService; } });
|
|
25
|
+
var quickSync_1 = require("../services/quickSync");
|
|
26
|
+
Object.defineProperty(exports, "QuickSyncService", { enumerable: true, get: function () { return quickSync_1.QuickSyncService; } });
|
|
27
|
+
var reverseSync_1 = require("../services/reverseSync");
|
|
28
|
+
Object.defineProperty(exports, "ReverseQuickSyncService", { enumerable: true, get: function () { return reverseSync_1.ReverseQuickSyncService; } });
|
|
29
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,uCAeyB;AAdvB,wGAAA,iBAAiB,OAAA;AACjB,iHAAA,0BAA0B,OAAA;AAC1B,qHAAA,8BAA8B,OAAA;AAQ9B,oGAAA,aAAa,OAAA;AAMf,4DAA2D;AAAlD,0GAAA,WAAW,OAAA;AACpB,6CAA6E;AAApE,4GAAA,kBAAkB,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAChD,6CAAwD;AAA/C,4GAAA,kBAAkB,OAAA;AAC3B,6CAAmD;AAA1C,uGAAA,aAAa,OAAA;AACtB,mDAAgF;AAAvE,6GAAA,gBAAgB,OAAA;AACzB,uDAAsF;AAA7E,sHAAA,uBAAuB,OAAA"}
|