@dotcontext/cli 0.8.1 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +234 -135
- package/dist/cli/index.d.ts +15 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +27 -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 +365 -339
- 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 +189 -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 +17 -0
- package/dist/services/cli/index.js.map +1 -0
- package/dist/services/cli/mcpInstallService.d.ts +57 -0
- package/dist/services/cli/mcpInstallService.d.ts.map +1 -0
- package/dist/services/cli/mcpInstallService.js +607 -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/utils/versionChecker.d.ts.map +1 -1
- package/dist/utils/versionChecker.js +17 -8
- package/dist/utils/versionChecker.js.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 +19 -11
- 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,227 @@ 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`
|
|
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`
|
|
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
|
-
- Configures dotcontext MCP server in each tool
|
|
213
|
+
- Configures the `dotcontext` MCP server in each tool
|
|
107
214
|
- Supports global (home directory) and local (project directory) installation
|
|
108
|
-
- Merges with existing MCP configurations without overwriting
|
|
109
|
-
- Includes dry-run
|
|
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"**.
|
|
215
|
+
- Merges with existing MCP configurations without overwriting unrelated servers
|
|
216
|
+
- Includes `--dry-run` and `--verbose` modes
|
|
217
|
+
- Writes the config shape required by each supported client
|
|
126
218
|
|
|
127
|
-
|
|
219
|
+
Examples:
|
|
128
220
|
|
|
129
|
-
|
|
221
|
+
```bash
|
|
222
|
+
# Interactive install for detected tools
|
|
223
|
+
npx @dotcontext/mcp install
|
|
130
224
|
|
|
131
|
-
|
|
225
|
+
# Install for a specific tool
|
|
226
|
+
npx @dotcontext/mcp install codex
|
|
132
227
|
|
|
133
|
-
|
|
228
|
+
# Install in the current project instead of your home directory
|
|
229
|
+
npx @dotcontext/mcp install cursor --local
|
|
134
230
|
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
"mcpServers": {
|
|
138
|
-
"dotcontext": {
|
|
139
|
-
"command": "npx",
|
|
140
|
-
"args": ["@dotcontext/cli", "mcp"]
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
}
|
|
231
|
+
# Preview without writing files
|
|
232
|
+
npx @dotcontext/mcp install claude --dry-run --verbose
|
|
144
233
|
```
|
|
145
234
|
|
|
146
|
-
|
|
235
|
+
### Supported MCP Install Targets
|
|
236
|
+
|
|
237
|
+
`install` currently supports these tool ids:
|
|
238
|
+
|
|
239
|
+
| Tool ID | Tool | Config Shape |
|
|
240
|
+
| --- | --- | --- |
|
|
241
|
+
| `claude` | Claude Code | `mcpServers` JSON |
|
|
242
|
+
| `cursor` | Cursor AI | `mcpServers` JSON with `type: "stdio"` |
|
|
243
|
+
| `windsurf` | Windsurf | `mcpServers` JSON |
|
|
244
|
+
| `continue` | Continue.dev | standalone `.continue/mcpServers/dotcontext.json` |
|
|
245
|
+
| `claude-desktop` | Claude Desktop | `mcpServers` JSON |
|
|
246
|
+
| `vscode` | VS Code (GitHub Copilot) | `servers` JSON |
|
|
247
|
+
| `roo` | Roo Code | `mcpServers` JSON |
|
|
248
|
+
| `amazonq` | Amazon Q Developer CLI | `mcpServers` JSON |
|
|
249
|
+
| `gemini-cli` | Gemini CLI | `mcpServers` JSON |
|
|
250
|
+
| `codex` | Codex CLI | TOML `[mcp_servers.dotcontext]` |
|
|
251
|
+
| `kiro` | Kiro | `mcpServers` JSON |
|
|
252
|
+
| `zed` | Zed Editor | `context_servers` JSON |
|
|
253
|
+
| `jetbrains` | JetBrains IDEs | `servers` array |
|
|
254
|
+
| `trae` | Trae AI | `mcpServers` JSON |
|
|
255
|
+
| `kilo` | Kilo Code | `mcp` JSON |
|
|
256
|
+
| `copilot-cli` | GitHub Copilot CLI | `mcpServers` JSON |
|
|
147
257
|
|
|
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).
|
|
258
|
+
### Manual Configuration
|
|
153
259
|
|
|
154
|
-
|
|
260
|
+
Use manual configuration only when you cannot use `@dotcontext/mcp install`. The exact file format depends on the client.
|
|
155
261
|
|
|
156
|
-
|
|
262
|
+
Dotcontext writes this command into client configs:
|
|
157
263
|
|
|
158
|
-
```
|
|
159
|
-
|
|
264
|
+
```text
|
|
265
|
+
command: npx
|
|
266
|
+
args: ["-y", "@dotcontext/mcp@latest"]
|
|
160
267
|
```
|
|
161
268
|
|
|
162
|
-
|
|
269
|
+
#### Standard `mcpServers` JSON
|
|
270
|
+
|
|
271
|
+
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
272
|
|
|
164
273
|
```json
|
|
165
274
|
{
|
|
166
275
|
"mcpServers": {
|
|
167
276
|
"dotcontext": {
|
|
168
277
|
"command": "npx",
|
|
169
|
-
"args": ["
|
|
278
|
+
"args": ["-y", "@dotcontext/mcp@latest"]
|
|
170
279
|
}
|
|
171
280
|
}
|
|
172
281
|
}
|
|
173
282
|
```
|
|
174
283
|
|
|
175
|
-
|
|
284
|
+
#### Cursor
|
|
176
285
|
|
|
177
|
-
|
|
286
|
+
Cursor expects `type: "stdio"`:
|
|
178
287
|
|
|
179
288
|
```json
|
|
180
289
|
{
|
|
181
290
|
"mcpServers": {
|
|
182
291
|
"dotcontext": {
|
|
292
|
+
"type": "stdio",
|
|
183
293
|
"command": "npx",
|
|
184
|
-
"args": ["
|
|
294
|
+
"args": ["-y", "@dotcontext/mcp@latest"]
|
|
185
295
|
}
|
|
186
296
|
}
|
|
187
297
|
}
|
|
188
298
|
```
|
|
189
299
|
|
|
190
|
-
|
|
300
|
+
#### Continue.dev
|
|
191
301
|
|
|
192
|
-
|
|
302
|
+
Continue uses a standalone per-server file:
|
|
193
303
|
|
|
194
304
|
```json
|
|
195
305
|
{
|
|
196
|
-
"
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
"args": ["@dotcontext/cli", "mcp"]
|
|
200
|
-
}
|
|
201
|
-
}
|
|
306
|
+
"command": "npx",
|
|
307
|
+
"args": ["-y", "@dotcontext/mcp@latest"],
|
|
308
|
+
"env": {}
|
|
202
309
|
}
|
|
203
310
|
```
|
|
204
311
|
|
|
205
|
-
|
|
312
|
+
#### VS Code (GitHub Copilot)
|
|
206
313
|
|
|
207
|
-
|
|
314
|
+
VS Code uses `servers` instead of `mcpServers`:
|
|
208
315
|
|
|
209
316
|
```json
|
|
210
317
|
{
|
|
211
|
-
"
|
|
318
|
+
"servers": {
|
|
212
319
|
"dotcontext": {
|
|
320
|
+
"type": "stdio",
|
|
213
321
|
"command": "npx",
|
|
214
|
-
"args": ["
|
|
322
|
+
"args": ["-y", "@dotcontext/mcp@latest"]
|
|
215
323
|
}
|
|
216
324
|
}
|
|
217
325
|
}
|
|
218
326
|
```
|
|
219
327
|
|
|
220
|
-
|
|
328
|
+
#### Zed
|
|
221
329
|
|
|
222
|
-
|
|
330
|
+
Zed uses `context_servers`:
|
|
223
331
|
|
|
224
332
|
```json
|
|
225
333
|
{
|
|
226
334
|
"context_servers": {
|
|
227
335
|
"dotcontext": {
|
|
228
|
-
"command":
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
}
|
|
336
|
+
"command": "npx",
|
|
337
|
+
"args": ["-y", "@dotcontext/mcp@latest"],
|
|
338
|
+
"env": {}
|
|
232
339
|
}
|
|
233
340
|
}
|
|
234
341
|
}
|
|
235
342
|
```
|
|
236
343
|
|
|
237
|
-
|
|
344
|
+
#### JetBrains IDEs
|
|
238
345
|
|
|
239
|
-
|
|
346
|
+
JetBrains uses a `servers` array:
|
|
240
347
|
|
|
241
348
|
```json
|
|
242
349
|
{
|
|
243
|
-
"
|
|
244
|
-
|
|
350
|
+
"servers": [
|
|
351
|
+
{
|
|
352
|
+
"name": "dotcontext",
|
|
245
353
|
"command": "npx",
|
|
246
|
-
"args": ["
|
|
354
|
+
"args": ["-y", "@dotcontext/mcp@latest"],
|
|
355
|
+
"env": {}
|
|
247
356
|
}
|
|
248
|
-
|
|
357
|
+
]
|
|
249
358
|
}
|
|
250
359
|
```
|
|
251
360
|
|
|
252
|
-
|
|
361
|
+
#### Kilo Code
|
|
253
362
|
|
|
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`):
|
|
363
|
+
Kilo uses `mcp.dotcontext` with a command array:
|
|
265
364
|
|
|
266
365
|
```json
|
|
267
366
|
{
|
|
268
|
-
"
|
|
367
|
+
"mcp": {
|
|
269
368
|
"dotcontext": {
|
|
270
|
-
"
|
|
271
|
-
"
|
|
369
|
+
"type": "local",
|
|
370
|
+
"command": ["npx", "-y", "@dotcontext/mcp@latest"],
|
|
371
|
+
"enabled": true
|
|
272
372
|
}
|
|
273
373
|
}
|
|
274
374
|
}
|
|
275
375
|
```
|
|
276
376
|
|
|
277
|
-
|
|
377
|
+
#### Codex CLI
|
|
278
378
|
|
|
279
|
-
|
|
379
|
+
Codex uses TOML:
|
|
280
380
|
|
|
281
|
-
```
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
"command": "npx",
|
|
286
|
-
"args": ["@dotcontext/cli", "mcp"]
|
|
287
|
-
}
|
|
288
|
-
}
|
|
289
|
-
}
|
|
381
|
+
```toml
|
|
382
|
+
[mcp_servers.dotcontext]
|
|
383
|
+
command = "npx"
|
|
384
|
+
args = ["-y", "@dotcontext/mcp@latest"]
|
|
290
385
|
```
|
|
291
386
|
|
|
292
387
|
### Local Development
|
|
293
388
|
|
|
294
|
-
For local development, point directly to the
|
|
389
|
+
For local development, point directly to the dedicated MCP binary after `npm run build`:
|
|
295
390
|
|
|
296
391
|
```json
|
|
297
392
|
{
|
|
298
393
|
"mcpServers": {
|
|
299
394
|
"dotcontext-dev": {
|
|
300
395
|
"command": "node",
|
|
301
|
-
"args": ["/path/to/
|
|
396
|
+
"args": ["/absolute/path/to/this-repo/dist/mcp/bin.js"]
|
|
302
397
|
}
|
|
303
398
|
}
|
|
304
399
|
}
|
|
@@ -435,7 +530,7 @@ The system automatically detects project scale and adjusts the workflow:
|
|
|
435
530
|
|
|
436
531
|
- Node.js 20+
|
|
437
532
|
|
|
438
|
-
**Context creation, AI generation, and refresh are MCP-only.** Use `npx dotcontext
|
|
533
|
+
**Context creation, AI generation, and refresh are MCP-only.** Use `npx @dotcontext/mcp install` and let your AI tool use its own LLM.
|
|
439
534
|
|
|
440
535
|
### Available MCP Tools
|
|
441
536
|
|
|
@@ -446,12 +541,16 @@ Once configured, your AI assistant will have access to 9 gateway tools with acti
|
|
|
446
541
|
| Gateway | Description | Actions |
|
|
447
542
|
|---------|-------------|---------|
|
|
448
543
|
| **explore** | File and code exploration | `read`, `list`, `analyze`, `search`, `getStructure` |
|
|
449
|
-
| **context** | Context scaffolding
|
|
544
|
+
| **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
545
|
| **plan** | Plan management and execution tracking | `link`, `getLinked`, `getDetails`, `getForPhase`, `updatePhase`, `recordDecision`, `updateStep`, `getStatus`, `syncMarkdown`, `commitPhase` |
|
|
451
546
|
| **agent** | Agent orchestration and discovery | `discover`, `getInfo`, `orchestrate`, `getSequence`, `getDocs`, `getPhaseDocs`, `listTypes` |
|
|
452
547
|
| **skill** | Skill management for on-demand expertise | `list`, `getContent`, `getForPhase`, `scaffold`, `export`, `fill` |
|
|
453
548
|
| **sync** | Import/export synchronization with AI tools | `exportRules`, `exportDocs`, `exportAgents`, `exportContext`, `exportSkills`, `reverseSync`, `importDocs`, `importAgents`, `importSkills` |
|
|
454
549
|
|
|
550
|
+
`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.
|
|
551
|
+
|
|
552
|
+
`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.
|
|
553
|
+
|
|
455
554
|
#### Dedicated Workflow Tools
|
|
456
555
|
|
|
457
556
|
| Tool | Description |
|
|
@@ -489,8 +588,8 @@ Skills are task-specific procedures that AI agents activate when needed:
|
|
|
489
588
|
| `security-audit` | Security review checklist | R, V |
|
|
490
589
|
|
|
491
590
|
```bash
|
|
492
|
-
npx dotcontext skill list # List available skills
|
|
493
|
-
npx dotcontext skill export # Export to AI tools
|
|
591
|
+
npx -y @dotcontext/cli@latest admin skill list # List available skills
|
|
592
|
+
npx -y @dotcontext/cli@latest admin skill export # Export to AI tools
|
|
494
593
|
```
|
|
495
594
|
|
|
496
595
|
Use MCP tools from your AI assistant to scaffold, fill, or refresh skills and other context files.
|
|
@@ -528,7 +627,7 @@ The previous name `@ai-coders/context` caused frequent confusion with **Context7
|
|
|
528
627
|
| Before | After |
|
|
529
628
|
|--------|-------|
|
|
530
629
|
| `npm install @ai-coders/context` | `npm install @dotcontext/cli` |
|
|
531
|
-
| `npx @ai-coders/context` | `npx dotcontext` |
|
|
630
|
+
| `npx @ai-coders/context` | `npx -y @dotcontext/cli@latest` |
|
|
532
631
|
| CLI command: `ai-context` | CLI command: `dotcontext` |
|
|
533
632
|
| MCP server name: `"ai-context"` | MCP server name: `"dotcontext"` |
|
|
534
633
|
| Env var: `AI_CONTEXT_LANG` | Env var: `DOTCONTEXT_LANG` |
|
|
@@ -551,9 +650,9 @@ The previous name `@ai-coders/context` caused frequent confusion with **Context7
|
|
|
551
650
|
|
|
552
651
|
2. **Update MCP configurations** -- re-run the installer:
|
|
553
652
|
```bash
|
|
554
|
-
npx dotcontext
|
|
653
|
+
npx @dotcontext/mcp install
|
|
555
654
|
```
|
|
556
|
-
Or manually replace `"ai-context"` with `"dotcontext"` and `"@ai-coders/context"` with `"@dotcontext/
|
|
655
|
+
Or manually replace `"ai-context"` with `"dotcontext"` and `"@ai-coders/context"` with `"@dotcontext/mcp"` in your MCP JSON configs.
|
|
557
656
|
|
|
558
657
|
3. **Update shell aliases** -- replace `ai-context` with `dotcontext` in your `.bashrc`, `.zshrc`, or equivalent.
|
|
559
658
|
|
|
@@ -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, type MCPInstallServiceDependencies, type MCPInstallOptions, type MCPInstallResult, type MCPInstallation, 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,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,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,27 @@
|
|
|
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.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, "StateDetector", { enumerable: true, get: function () { return cli_1.StateDetector; } });
|
|
14
|
+
var syncService_1 = require("../services/sync/syncService");
|
|
15
|
+
Object.defineProperty(exports, "SyncService", { enumerable: true, get: function () { return syncService_1.SyncService; } });
|
|
16
|
+
var import_1 = require("../services/import");
|
|
17
|
+
Object.defineProperty(exports, "ImportRulesService", { enumerable: true, get: function () { return import_1.ImportRulesService; } });
|
|
18
|
+
Object.defineProperty(exports, "ImportAgentsService", { enumerable: true, get: function () { return import_1.ImportAgentsService; } });
|
|
19
|
+
var export_1 = require("../services/export");
|
|
20
|
+
Object.defineProperty(exports, "ExportRulesService", { enumerable: true, get: function () { return export_1.ExportRulesService; } });
|
|
21
|
+
var report_1 = require("../services/report");
|
|
22
|
+
Object.defineProperty(exports, "ReportService", { enumerable: true, get: function () { return report_1.ReportService; } });
|
|
23
|
+
var quickSync_1 = require("../services/quickSync");
|
|
24
|
+
Object.defineProperty(exports, "QuickSyncService", { enumerable: true, get: function () { return quickSync_1.QuickSyncService; } });
|
|
25
|
+
var reverseSync_1 = require("../services/reverseSync");
|
|
26
|
+
Object.defineProperty(exports, "ReverseQuickSyncService", { enumerable: true, get: function () { return reverseSync_1.ReverseQuickSyncService; } });
|
|
27
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,uCAUyB;AATvB,wGAAA,iBAAiB,OAAA;AAKjB,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"}
|