@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.
Files changed (414) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +236 -135
  3. package/dist/cli/index.d.ts +15 -0
  4. package/dist/cli/index.d.ts.map +1 -0
  5. package/dist/cli/index.js +29 -0
  6. package/dist/cli/index.js.map +1 -0
  7. package/dist/generators/documentation/codebaseMapGenerator.d.ts +29 -46
  8. package/dist/generators/documentation/codebaseMapGenerator.d.ts.map +1 -1
  9. package/dist/generators/documentation/codebaseMapGenerator.js +148 -244
  10. package/dist/generators/documentation/codebaseMapGenerator.js.map +1 -1
  11. package/dist/generators/documentation/documentationGenerator.d.ts.map +1 -1
  12. package/dist/generators/documentation/documentationGenerator.js +13 -8
  13. package/dist/generators/documentation/documentationGenerator.js.map +1 -1
  14. package/dist/generators/documentation/index.d.ts +1 -1
  15. package/dist/generators/documentation/index.d.ts.map +1 -1
  16. package/dist/generators/shared/structures/documentation/architecture.d.ts.map +1 -1
  17. package/dist/generators/shared/structures/documentation/architecture.js +9 -9
  18. package/dist/generators/shared/structures/documentation/architecture.js.map +1 -1
  19. package/dist/generators/shared/structures/documentation/dataFlow.js +2 -2
  20. package/dist/generators/shared/structures/documentation/dataFlow.js.map +1 -1
  21. package/dist/generators/shared/structures/documentation/glossary.js +2 -2
  22. package/dist/generators/shared/structures/documentation/glossary.js.map +1 -1
  23. package/dist/generators/shared/structures/documentation/projectOverview.d.ts.map +1 -1
  24. package/dist/generators/shared/structures/documentation/projectOverview.js +10 -11
  25. package/dist/generators/shared/structures/documentation/projectOverview.js.map +1 -1
  26. package/dist/generators/shared/structures/skills/factory.d.ts.map +1 -1
  27. package/dist/generators/shared/structures/skills/factory.js +19 -15
  28. package/dist/generators/shared/structures/skills/factory.js.map +1 -1
  29. package/dist/generators/skills/skillGenerator.d.ts +2 -1
  30. package/dist/generators/skills/skillGenerator.d.ts.map +1 -1
  31. package/dist/generators/skills/skillGenerator.js +47 -6
  32. package/dist/generators/skills/skillGenerator.js.map +1 -1
  33. package/dist/generators/skills/templates/indexTemplate.d.ts.map +1 -1
  34. package/dist/generators/skills/templates/indexTemplate.js +22 -15
  35. package/dist/generators/skills/templates/indexTemplate.js.map +1 -1
  36. package/dist/harness/index.d.ts +11 -0
  37. package/dist/harness/index.d.ts.map +1 -0
  38. package/dist/harness/index.js +33 -0
  39. package/dist/harness/index.js.map +1 -0
  40. package/dist/index.js +370 -378
  41. package/dist/index.js.map +1 -1
  42. package/dist/mcp/bin.d.ts +19 -0
  43. package/dist/mcp/bin.d.ts.map +1 -0
  44. package/dist/mcp/bin.js +206 -0
  45. package/dist/mcp/bin.js.map +1 -0
  46. package/dist/mcp/index.d.ts +12 -0
  47. package/dist/mcp/index.d.ts.map +1 -0
  48. package/dist/mcp/index.js +28 -0
  49. package/dist/mcp/index.js.map +1 -0
  50. package/dist/services/autoFill/autoFillService.d.ts.map +1 -1
  51. package/dist/services/autoFill/autoFillService.js +7 -6
  52. package/dist/services/autoFill/autoFillService.js.map +1 -1
  53. package/dist/services/cli/index.d.ts +8 -0
  54. package/dist/services/cli/index.d.ts.map +1 -0
  55. package/dist/services/cli/index.js +19 -0
  56. package/dist/services/cli/index.js.map +1 -0
  57. package/dist/services/cli/mcpInstallService.d.ts +75 -0
  58. package/dist/services/cli/mcpInstallService.d.ts.map +1 -0
  59. package/dist/services/cli/mcpInstallService.js +646 -0
  60. package/dist/services/cli/mcpInstallService.js.map +1 -0
  61. package/dist/services/cli/stateDetector.d.ts +55 -0
  62. package/dist/services/cli/stateDetector.d.ts.map +1 -0
  63. package/dist/services/cli/stateDetector.js +191 -0
  64. package/dist/services/cli/stateDetector.js.map +1 -0
  65. package/dist/services/export/contextExportService.js +3 -3
  66. package/dist/services/export/contextExportService.js.map +1 -1
  67. package/dist/services/export/exportRulesService.d.ts +1 -0
  68. package/dist/services/export/exportRulesService.d.ts.map +1 -1
  69. package/dist/services/export/exportRulesService.js +20 -8
  70. package/dist/services/export/exportRulesService.js.map +1 -1
  71. package/dist/services/export/skillExportService.d.ts.map +1 -1
  72. package/dist/services/export/skillExportService.js +4 -1
  73. package/dist/services/export/skillExportService.js.map +1 -1
  74. package/dist/services/harness/agentsService.d.ts +31 -0
  75. package/dist/services/harness/agentsService.d.ts.map +1 -0
  76. package/dist/services/harness/agentsService.js +135 -0
  77. package/dist/services/harness/agentsService.js.map +1 -0
  78. package/dist/services/harness/contextService.d.ts +167 -0
  79. package/dist/services/harness/contextService.d.ts.map +1 -0
  80. package/dist/services/harness/contextService.js +403 -0
  81. package/dist/services/harness/contextService.js.map +1 -0
  82. package/dist/services/harness/contextTools.d.ts +95 -0
  83. package/dist/services/harness/contextTools.d.ts.map +1 -0
  84. package/dist/services/harness/contextTools.js +990 -0
  85. package/dist/services/harness/contextTools.js.map +1 -0
  86. package/dist/services/harness/datasetService.d.ts +63 -0
  87. package/dist/services/harness/datasetService.d.ts.map +1 -0
  88. package/dist/services/harness/datasetService.js +261 -0
  89. package/dist/services/harness/datasetService.js.map +1 -0
  90. package/dist/services/harness/executionService.d.ts +74 -0
  91. package/dist/services/harness/executionService.d.ts.map +1 -0
  92. package/dist/services/harness/executionService.js +213 -0
  93. package/dist/services/harness/executionService.js.map +1 -0
  94. package/dist/services/harness/index.d.ts +21 -0
  95. package/dist/services/harness/index.d.ts.map +1 -0
  96. package/dist/services/harness/index.js +52 -0
  97. package/dist/services/harness/index.js.map +1 -0
  98. package/dist/services/harness/plansService.d.ts +45 -0
  99. package/dist/services/harness/plansService.d.ts.map +1 -0
  100. package/dist/services/harness/plansService.js +251 -0
  101. package/dist/services/harness/plansService.js.map +1 -0
  102. package/dist/services/harness/policyService.d.ts +116 -0
  103. package/dist/services/harness/policyService.d.ts.map +1 -0
  104. package/dist/services/harness/policyService.js +510 -0
  105. package/dist/services/harness/policyService.js.map +1 -0
  106. package/dist/services/harness/replayService.d.ts +63 -0
  107. package/dist/services/harness/replayService.d.ts.map +1 -0
  108. package/dist/services/harness/replayService.js +242 -0
  109. package/dist/services/harness/replayService.js.map +1 -0
  110. package/dist/services/harness/runtimeStateService.d.ts +120 -0
  111. package/dist/services/harness/runtimeStateService.d.ts.map +1 -0
  112. package/dist/services/harness/runtimeStateService.js +316 -0
  113. package/dist/services/harness/runtimeStateService.js.map +1 -0
  114. package/dist/services/harness/sensorCatalogService.d.ts +50 -0
  115. package/dist/services/harness/sensorCatalogService.d.ts.map +1 -0
  116. package/dist/services/harness/sensorCatalogService.js +308 -0
  117. package/dist/services/harness/sensorCatalogService.js.map +1 -0
  118. package/dist/services/harness/sensorsService.d.ts +64 -0
  119. package/dist/services/harness/sensorsService.d.ts.map +1 -0
  120. package/dist/services/harness/sensorsService.js +88 -0
  121. package/dist/services/harness/sensorsService.js.map +1 -0
  122. package/dist/services/harness/skillsService.d.ts +31 -0
  123. package/dist/services/harness/skillsService.d.ts.map +1 -0
  124. package/dist/services/harness/skillsService.js +296 -0
  125. package/dist/services/harness/skillsService.js.map +1 -0
  126. package/dist/services/harness/taskContractsService.d.ts +88 -0
  127. package/dist/services/harness/taskContractsService.d.ts.map +1 -0
  128. package/dist/services/harness/taskContractsService.js +210 -0
  129. package/dist/services/harness/taskContractsService.js.map +1 -0
  130. package/dist/services/harness/workflowStateService.d.ts +51 -0
  131. package/dist/services/harness/workflowStateService.d.ts.map +1 -0
  132. package/dist/services/harness/workflowStateService.js +215 -0
  133. package/dist/services/harness/workflowStateService.js.map +1 -0
  134. package/dist/services/import/agentsDetector.d.ts.map +1 -1
  135. package/dist/services/import/agentsDetector.js +14 -8
  136. package/dist/services/import/agentsDetector.js.map +1 -1
  137. package/dist/services/import/importAgentsService.d.ts +2 -2
  138. package/dist/services/import/importAgentsService.d.ts.map +1 -1
  139. package/dist/services/import/importAgentsService.js +8 -1
  140. package/dist/services/import/importAgentsService.js.map +1 -1
  141. package/dist/services/import/importRulesService.d.ts +2 -2
  142. package/dist/services/import/importRulesService.d.ts.map +1 -1
  143. package/dist/services/import/importRulesService.js +8 -1
  144. package/dist/services/import/importRulesService.js.map +1 -1
  145. package/dist/services/import/presets.js +2 -2
  146. package/dist/services/import/presets.js.map +1 -1
  147. package/dist/services/import/rulesDetector.d.ts.map +1 -1
  148. package/dist/services/import/rulesDetector.js +16 -1
  149. package/dist/services/import/rulesDetector.js.map +1 -1
  150. package/dist/services/import/types.d.ts +1 -1
  151. package/dist/services/import/types.d.ts.map +1 -1
  152. package/dist/services/mcp/actionLogger.d.ts +2 -1
  153. package/dist/services/mcp/actionLogger.d.ts.map +1 -1
  154. package/dist/services/mcp/actionLogger.js +76 -15
  155. package/dist/services/mcp/actionLogger.js.map +1 -1
  156. package/dist/services/mcp/gateway/agent.d.ts.map +1 -1
  157. package/dist/services/mcp/gateway/agent.js +15 -104
  158. package/dist/services/mcp/gateway/agent.js.map +1 -1
  159. package/dist/services/mcp/gateway/context.d.ts.map +1 -1
  160. package/dist/services/mcp/gateway/context.js +60 -172
  161. package/dist/services/mcp/gateway/context.js.map +1 -1
  162. package/dist/services/mcp/gateway/explore.js +6 -6
  163. package/dist/services/mcp/gateway/explore.js.map +1 -1
  164. package/dist/services/mcp/gateway/harness.d.ts +7 -0
  165. package/dist/services/mcp/gateway/harness.d.ts.map +1 -0
  166. package/dist/services/mcp/gateway/harness.js +337 -0
  167. package/dist/services/mcp/gateway/harness.js.map +1 -0
  168. package/dist/services/mcp/gateway/index.d.ts +3 -2
  169. package/dist/services/mcp/gateway/index.d.ts.map +1 -1
  170. package/dist/services/mcp/gateway/index.js +4 -2
  171. package/dist/services/mcp/gateway/index.js.map +1 -1
  172. package/dist/services/mcp/gateway/metrics.d.ts.map +1 -1
  173. package/dist/services/mcp/gateway/metrics.js +8 -8
  174. package/dist/services/mcp/gateway/metrics.js.map +1 -1
  175. package/dist/services/mcp/gateway/plan.d.ts.map +1 -1
  176. package/dist/services/mcp/gateway/plan.js +23 -211
  177. package/dist/services/mcp/gateway/plan.js.map +1 -1
  178. package/dist/services/mcp/gateway/shared.d.ts +1 -32
  179. package/dist/services/mcp/gateway/shared.d.ts.map +1 -1
  180. package/dist/services/mcp/gateway/shared.js +4 -30
  181. package/dist/services/mcp/gateway/shared.js.map +1 -1
  182. package/dist/services/mcp/gateway/skill.d.ts.map +1 -1
  183. package/dist/services/mcp/gateway/skill.js +14 -281
  184. package/dist/services/mcp/gateway/skill.js.map +1 -1
  185. package/dist/services/mcp/gateway/types.d.ts +74 -3
  186. package/dist/services/mcp/gateway/types.d.ts.map +1 -1
  187. package/dist/services/mcp/gateway/workflowAdvance.d.ts.map +1 -1
  188. package/dist/services/mcp/gateway/workflowAdvance.js +37 -9
  189. package/dist/services/mcp/gateway/workflowAdvance.js.map +1 -1
  190. package/dist/services/mcp/gateway/workflowInit.d.ts.map +1 -1
  191. package/dist/services/mcp/gateway/workflowInit.js +8 -2
  192. package/dist/services/mcp/gateway/workflowInit.js.map +1 -1
  193. package/dist/services/mcp/gateway/workflowManage.d.ts +17 -1
  194. package/dist/services/mcp/gateway/workflowManage.d.ts.map +1 -1
  195. package/dist/services/mcp/gateway/workflowManage.js +155 -10
  196. package/dist/services/mcp/gateway/workflowManage.js.map +1 -1
  197. package/dist/services/mcp/gateway/workflowStatus.d.ts.map +1 -1
  198. package/dist/services/mcp/gateway/workflowStatus.js +5 -3
  199. package/dist/services/mcp/gateway/workflowStatus.js.map +1 -1
  200. package/dist/services/mcp/gatewayTools.d.ts +1 -1
  201. package/dist/services/mcp/gatewayTools.d.ts.map +1 -1
  202. package/dist/services/mcp/gatewayTools.js +2 -1
  203. package/dist/services/mcp/gatewayTools.js.map +1 -1
  204. package/dist/services/mcp/index.d.ts +10 -4
  205. package/dist/services/mcp/index.d.ts.map +1 -1
  206. package/dist/services/mcp/index.js +9 -3
  207. package/dist/services/mcp/index.js.map +1 -1
  208. package/dist/services/mcp/mcpInstallService.d.ts +4 -52
  209. package/dist/services/mcp/mcpInstallService.d.ts.map +1 -1
  210. package/dist/services/mcp/mcpInstallService.js +5 -596
  211. package/dist/services/mcp/mcpInstallService.js.map +1 -1
  212. package/dist/services/mcp/mcpServer.d.ts +5 -6
  213. package/dist/services/mcp/mcpServer.d.ts.map +1 -1
  214. package/dist/services/mcp/mcpServer.js +220 -28
  215. package/dist/services/mcp/mcpServer.js.map +1 -1
  216. package/dist/services/qa/patternInferer.d.ts +2 -31
  217. package/dist/services/qa/patternInferer.d.ts.map +1 -1
  218. package/dist/services/qa/patternInferer.js +4 -353
  219. package/dist/services/qa/patternInferer.js.map +1 -1
  220. package/dist/services/qa/qaService.d.ts +6 -10
  221. package/dist/services/qa/qaService.d.ts.map +1 -1
  222. package/dist/services/qa/qaService.js +17 -53
  223. package/dist/services/qa/qaService.js.map +1 -1
  224. package/dist/services/reverseSync/importSkillsService.d.ts.map +1 -1
  225. package/dist/services/reverseSync/importSkillsService.js +4 -1
  226. package/dist/services/reverseSync/importSkillsService.js.map +1 -1
  227. package/dist/services/reverseSync/reverseQuickSyncService.d.ts.map +1 -1
  228. package/dist/services/reverseSync/reverseQuickSyncService.js +10 -6
  229. package/dist/services/reverseSync/reverseQuickSyncService.js.map +1 -1
  230. package/dist/services/reverseSync/skillsDetector.js +2 -2
  231. package/dist/services/reverseSync/skillsDetector.js.map +1 -1
  232. package/dist/services/reverseSync/toolDetector.d.ts.map +1 -1
  233. package/dist/services/reverseSync/toolDetector.js +3 -0
  234. package/dist/services/reverseSync/toolDetector.js.map +1 -1
  235. package/dist/services/semantic/index.d.ts +1 -0
  236. package/dist/services/semantic/index.d.ts.map +1 -1
  237. package/dist/services/semantic/index.js +3 -1
  238. package/dist/services/semantic/index.js.map +1 -1
  239. package/dist/services/semantic/semanticSnapshotService.d.ts +86 -0
  240. package/dist/services/semantic/semanticSnapshotService.d.ts.map +1 -0
  241. package/dist/services/semantic/semanticSnapshotService.js +573 -0
  242. package/dist/services/semantic/semanticSnapshotService.js.map +1 -0
  243. package/dist/services/shared/contentTypeRegistry.d.ts.map +1 -1
  244. package/dist/services/shared/contentTypeRegistry.js +9 -0
  245. package/dist/services/shared/contentTypeRegistry.js.map +1 -1
  246. package/dist/services/shared/contextLayout.d.ts +18 -0
  247. package/dist/services/shared/contextLayout.d.ts.map +1 -0
  248. package/dist/services/shared/contextLayout.js +139 -0
  249. package/dist/services/shared/contextLayout.js.map +1 -0
  250. package/dist/services/shared/executionContext.d.ts +38 -0
  251. package/dist/services/shared/executionContext.d.ts.map +1 -0
  252. package/dist/services/shared/executionContext.js +39 -0
  253. package/dist/services/shared/executionContext.js.map +1 -0
  254. package/dist/services/shared/index.d.ts +2 -0
  255. package/dist/services/shared/index.d.ts.map +1 -1
  256. package/dist/services/shared/index.js +11 -1
  257. package/dist/services/shared/index.js.map +1 -1
  258. package/dist/services/shared/toolRegistry.d.ts +6 -0
  259. package/dist/services/shared/toolRegistry.d.ts.map +1 -1
  260. package/dist/services/shared/toolRegistry.js +34 -20
  261. package/dist/services/shared/toolRegistry.js.map +1 -1
  262. package/dist/services/stack/scaffoldFilter.d.ts +3 -3
  263. package/dist/services/state/stateDetector.d.ts +4 -49
  264. package/dist/services/state/stateDetector.d.ts.map +1 -1
  265. package/dist/services/state/stateDetector.js +9 -182
  266. package/dist/services/state/stateDetector.js.map +1 -1
  267. package/dist/services/sync/index.d.ts +1 -1
  268. package/dist/services/sync/index.d.ts.map +1 -1
  269. package/dist/services/sync/index.js.map +1 -1
  270. package/dist/services/sync/markdownReferenceHandler.d.ts.map +1 -1
  271. package/dist/services/sync/markdownReferenceHandler.js +7 -2
  272. package/dist/services/sync/markdownReferenceHandler.js.map +1 -1
  273. package/dist/services/sync/presets.d.ts.map +1 -1
  274. package/dist/services/sync/presets.js +1 -0
  275. package/dist/services/sync/presets.js.map +1 -1
  276. package/dist/services/sync/symlinkHandler.d.ts.map +1 -1
  277. package/dist/services/sync/symlinkHandler.js +7 -2
  278. package/dist/services/sync/symlinkHandler.js.map +1 -1
  279. package/dist/services/sync/syncService.d.ts +2 -2
  280. package/dist/services/sync/syncService.d.ts.map +1 -1
  281. package/dist/services/sync/syncService.js +17 -3
  282. package/dist/services/sync/syncService.js.map +1 -1
  283. package/dist/services/sync/types.d.ts +9 -1
  284. package/dist/services/sync/types.d.ts.map +1 -1
  285. package/dist/services/workflow/index.d.ts +1 -1
  286. package/dist/services/workflow/index.d.ts.map +1 -1
  287. package/dist/services/workflow/index.js +2 -1
  288. package/dist/services/workflow/index.js.map +1 -1
  289. package/dist/services/workflow/workflowService.d.ts +68 -0
  290. package/dist/services/workflow/workflowService.d.ts.map +1 -1
  291. package/dist/services/workflow/workflowService.js +416 -1
  292. package/dist/services/workflow/workflowService.js.map +1 -1
  293. package/dist/utils/gitignoreManager.d.ts +8 -0
  294. package/dist/utils/gitignoreManager.d.ts.map +1 -1
  295. package/dist/utils/gitignoreManager.js +40 -0
  296. package/dist/utils/gitignoreManager.js.map +1 -1
  297. package/dist/utils/i18n.d.ts +1 -1
  298. package/dist/utils/i18n.js +2 -2
  299. package/dist/utils/i18n.js.map +1 -1
  300. package/dist/utils/processShutdown.d.ts +20 -0
  301. package/dist/utils/processShutdown.d.ts.map +1 -0
  302. package/dist/utils/processShutdown.js +47 -0
  303. package/dist/utils/processShutdown.js.map +1 -0
  304. package/dist/utils/prompts/index.d.ts +1 -1
  305. package/dist/utils/prompts/index.d.ts.map +1 -1
  306. package/dist/utils/prompts/index.js +1 -3
  307. package/dist/utils/prompts/index.js.map +1 -1
  308. package/dist/utils/prompts/smartDefaults.d.ts +0 -9
  309. package/dist/utils/prompts/smartDefaults.d.ts.map +1 -1
  310. package/dist/utils/prompts/smartDefaults.js +0 -23
  311. package/dist/utils/prompts/smartDefaults.js.map +1 -1
  312. package/dist/utils/prompts/types.d.ts +0 -11
  313. package/dist/utils/prompts/types.d.ts.map +1 -1
  314. package/dist/workflow/index.d.ts +1 -1
  315. package/dist/workflow/index.d.ts.map +1 -1
  316. package/dist/workflow/index.js +6 -1
  317. package/dist/workflow/index.js.map +1 -1
  318. package/dist/workflow/orchestrator.d.ts.map +1 -1
  319. package/dist/workflow/orchestrator.js +3 -14
  320. package/dist/workflow/orchestrator.js.map +1 -1
  321. package/dist/workflow/plans/planLinker.d.ts +13 -0
  322. package/dist/workflow/plans/planLinker.d.ts.map +1 -1
  323. package/dist/workflow/plans/planLinker.js +77 -2
  324. package/dist/workflow/plans/planLinker.js.map +1 -1
  325. package/dist/workflow/plans/types.d.ts +6 -0
  326. package/dist/workflow/plans/types.d.ts.map +1 -1
  327. package/dist/workflow/skills/frontmatter.d.ts +9 -0
  328. package/dist/workflow/skills/frontmatter.d.ts.map +1 -1
  329. package/dist/workflow/skills/frontmatter.js +16 -0
  330. package/dist/workflow/skills/frontmatter.js.map +1 -1
  331. package/dist/workflow/skills/index.d.ts +1 -1
  332. package/dist/workflow/skills/index.d.ts.map +1 -1
  333. package/dist/workflow/skills/index.js +3 -1
  334. package/dist/workflow/skills/index.js.map +1 -1
  335. package/dist/workflow/skills/skillRegistry.d.ts.map +1 -1
  336. package/dist/workflow/skills/skillRegistry.js +4 -1
  337. package/dist/workflow/skills/skillRegistry.js.map +1 -1
  338. package/dist/workflow/skills/skillTemplates.d.ts.map +1 -1
  339. package/dist/workflow/skills/skillTemplates.js +69 -30
  340. package/dist/workflow/skills/skillTemplates.js.map +1 -1
  341. package/dist/workflow/status/statusManager.d.ts +8 -3
  342. package/dist/workflow/status/statusManager.d.ts.map +1 -1
  343. package/dist/workflow/status/statusManager.js +60 -21
  344. package/dist/workflow/status/statusManager.js.map +1 -1
  345. package/dist/workflow/types.d.ts +1 -1
  346. package/package.json +17 -8
  347. package/dist/services/ai/aiSdkClient.d.ts +0 -67
  348. package/dist/services/ai/aiSdkClient.d.ts.map +0 -1
  349. package/dist/services/ai/aiSdkClient.js +0 -143
  350. package/dist/services/ai/aiSdkClient.js.map +0 -1
  351. package/dist/services/ai/index.d.ts +0 -5
  352. package/dist/services/ai/index.d.ts.map +0 -1
  353. package/dist/services/ai/index.js +0 -40
  354. package/dist/services/ai/index.js.map +0 -1
  355. package/dist/services/ai/providerFactory.d.ts +0 -35
  356. package/dist/services/ai/providerFactory.d.ts.map +0 -1
  357. package/dist/services/ai/providerFactory.js +0 -107
  358. package/dist/services/ai/providerFactory.js.map +0 -1
  359. package/dist/services/ai/schemas.d.ts +0 -557
  360. package/dist/services/ai/schemas.d.ts.map +0 -1
  361. package/dist/services/ai/schemas.js +0 -357
  362. package/dist/services/ai/schemas.js.map +0 -1
  363. package/dist/services/ai/toolRegistry.d.ts +0 -27
  364. package/dist/services/ai/toolRegistry.d.ts.map +0 -1
  365. package/dist/services/ai/toolRegistry.js +0 -151
  366. package/dist/services/ai/toolRegistry.js.map +0 -1
  367. package/dist/services/ai/tools/analyzeSymbolsTool.d.ts +0 -33
  368. package/dist/services/ai/tools/analyzeSymbolsTool.d.ts.map +0 -1
  369. package/dist/services/ai/tools/analyzeSymbolsTool.js +0 -57
  370. package/dist/services/ai/tools/analyzeSymbolsTool.js.map +0 -1
  371. package/dist/services/ai/tools/checkScaffoldingTool.d.ts +0 -18
  372. package/dist/services/ai/tools/checkScaffoldingTool.d.ts.map +0 -1
  373. package/dist/services/ai/tools/checkScaffoldingTool.js +0 -89
  374. package/dist/services/ai/tools/checkScaffoldingTool.js.map +0 -1
  375. package/dist/services/ai/tools/fillScaffoldingTool.d.ts +0 -124
  376. package/dist/services/ai/tools/fillScaffoldingTool.d.ts.map +0 -1
  377. package/dist/services/ai/tools/fillScaffoldingTool.js +0 -397
  378. package/dist/services/ai/tools/fillScaffoldingTool.js.map +0 -1
  379. package/dist/services/ai/tools/getCodebaseMapTool.d.ts +0 -17
  380. package/dist/services/ai/tools/getCodebaseMapTool.d.ts.map +0 -1
  381. package/dist/services/ai/tools/getCodebaseMapTool.js +0 -122
  382. package/dist/services/ai/tools/getCodebaseMapTool.js.map +0 -1
  383. package/dist/services/ai/tools/getFileStructureTool.d.ts +0 -29
  384. package/dist/services/ai/tools/getFileStructureTool.d.ts.map +0 -1
  385. package/dist/services/ai/tools/getFileStructureTool.js +0 -48
  386. package/dist/services/ai/tools/getFileStructureTool.js.map +0 -1
  387. package/dist/services/ai/tools/index.d.ts +0 -21
  388. package/dist/services/ai/tools/index.d.ts.map +0 -1
  389. package/dist/services/ai/tools/index.js +0 -75
  390. package/dist/services/ai/tools/index.js.map +0 -1
  391. package/dist/services/ai/tools/initializeContextTool.d.ts +0 -135
  392. package/dist/services/ai/tools/initializeContextTool.d.ts.map +0 -1
  393. package/dist/services/ai/tools/initializeContextTool.js +0 -447
  394. package/dist/services/ai/tools/initializeContextTool.js.map +0 -1
  395. package/dist/services/ai/tools/listFilesTool.d.ts +0 -18
  396. package/dist/services/ai/tools/listFilesTool.d.ts.map +0 -1
  397. package/dist/services/ai/tools/listFilesTool.js +0 -34
  398. package/dist/services/ai/tools/listFilesTool.js.map +0 -1
  399. package/dist/services/ai/tools/readFileTool.d.ts +0 -17
  400. package/dist/services/ai/tools/readFileTool.d.ts.map +0 -1
  401. package/dist/services/ai/tools/readFileTool.js +0 -63
  402. package/dist/services/ai/tools/readFileTool.js.map +0 -1
  403. package/dist/services/ai/tools/scaffoldPlanTool.d.ts +0 -41
  404. package/dist/services/ai/tools/scaffoldPlanTool.d.ts.map +0 -1
  405. package/dist/services/ai/tools/scaffoldPlanTool.js +0 -183
  406. package/dist/services/ai/tools/scaffoldPlanTool.js.map +0 -1
  407. package/dist/services/ai/tools/searchCodeTool.d.ts +0 -25
  408. package/dist/services/ai/tools/searchCodeTool.d.ts.map +0 -1
  409. package/dist/services/ai/tools/searchCodeTool.js +0 -96
  410. package/dist/services/ai/tools/searchCodeTool.js.map +0 -1
  411. package/dist/services/baseLLMClient.d.ts +0 -12
  412. package/dist/services/baseLLMClient.d.ts.map +0 -1
  413. package/dist/services/baseLLMClient.js +0 -80
  414. package/dist/services/baseLLMClient.js.map +0 -1
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2024 AI Coders
3
+ Copyright (c) 2024 AI Coders Academy
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
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
- **The Ultimate MCP for AI Agent Orchestration, Context Engineering, and Spec-Driven Development.**
10
- Context engineering for AI now is stupidly simple.
9
+ **Dotcontext is a harness engineering runtime for AI-assisted software delivery.**
11
10
 
12
- Stop letting LLMs run on autopilot. PREVC is a universal process that improves AI output through 5 simple steps: **Planning, Review, Execution, Validation, and Confirmation**. Context-oriented. Spec-driven. No guesswork.
11
+ 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
- ## The Problem
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
- Every AI coding tool invented its own way to organize context:
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
- Using multiple tools? Enjoy duplicating your rules, agents, and documentation across 8 different formats. Context fragmentation is real.
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
- ## The Solution
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/cli mcp:install` — no API key needed!
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/cli mcp:install` — sem necessidade de API key!
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/cli mcp:install`
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/cli mcp:install`
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 — workflow, sync, imports, and MCP setup
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 workflow, sync, reverse sync, and MCP setup
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 workflow, sincronização, reverse sync e configuração MCP
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
- ### Quick Installation (v0.7.0+)
201
+ ### Recommended Installation
97
202
 
98
- Use the MCP Install command to automatically configure the MCP server:
203
+ Use the installer. It is the source of truth for supported tools and config formats:
99
204
 
100
205
  ```bash
101
- npx @dotcontext/cli mcp:install
206
+ npx @dotcontext/mcp install
102
207
  ```
103
208
 
104
- This interactive command:
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
+ - 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
- - Merges with existing MCP configurations without overwriting
109
- - Includes dry-run mode to preview changes
110
- - Works with Claude Code, Cursor, Windsurf, Codex, Continue.dev, and more
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
- > **Note:** If you cannot find the button in the UI, you can navigate directly through the file explorer and look for `.idx/mcp.json` or `mcp_config.json` in your workspace root.
221
+ Examples:
128
222
 
129
- #### 2. Add Custom Server
223
+ ```bash
224
+ # Interactive install for detected tools
225
+ npx @dotcontext/mcp install
130
226
 
131
- You will see a JSON file. You must add a new entry inside the `"mcpServers"` object.
227
+ # Install for a specific tool
228
+ npx @dotcontext/mcp install codex
132
229
 
133
- Here is the template to add a server (example using `npx` for a Node.js server or a local executable):
230
+ # Install in the current project instead of your home directory
231
+ npx @dotcontext/mcp install cursor --local
134
232
 
135
- ```json
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
- #### 3. Restart the Connection
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
- After saving the `mcp.json` file:
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
- ### Claude Code (CLI)
262
+ Use manual configuration only when you cannot use `@dotcontext/mcp install`. The exact file format depends on the client.
155
263
 
156
- Add the MCP server using the Claude CLI:
264
+ Dotcontext writes this command into client configs:
157
265
 
158
- ```bash
159
- claude mcp add dotcontext -- npx @dotcontext/cli mcp
266
+ ```text
267
+ command: npx
268
+ args: ["-y", "@dotcontext/mcp@latest"]
160
269
  ```
161
270
 
162
- Or configure manually in `~/.claude.json`:
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": ["@dotcontext/cli", "mcp"]
280
+ "args": ["-y", "@dotcontext/mcp@latest"]
170
281
  }
171
282
  }
172
283
  }
173
284
  ```
174
285
 
175
- ### Claude Desktop
286
+ #### Cursor
176
287
 
177
- Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `%APPDATA%\Claude\claude_desktop_config.json` on Windows):
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": ["@dotcontext/cli", "mcp"]
296
+ "args": ["-y", "@dotcontext/mcp@latest"]
185
297
  }
186
298
  }
187
299
  }
188
300
  ```
189
301
 
190
- ### Cursor AI
302
+ #### Continue.dev
191
303
 
192
- Create `.cursor/mcp.json` in your project root:
304
+ Continue uses a standalone per-server file:
193
305
 
194
306
  ```json
195
307
  {
196
- "mcpServers": {
197
- "dotcontext": {
198
- "command": "npx",
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
- ### Windsurf
314
+ #### VS Code (GitHub Copilot)
206
315
 
207
- Add to your Windsurf MCP config (`~/.codeium/windsurf/mcp_config.json`):
316
+ VS Code uses `servers` instead of `mcpServers`:
208
317
 
209
318
  ```json
210
319
  {
211
- "mcpServers": {
320
+ "servers": {
212
321
  "dotcontext": {
322
+ "type": "stdio",
213
323
  "command": "npx",
214
- "args": ["@dotcontext/cli", "mcp"]
324
+ "args": ["-y", "@dotcontext/mcp@latest"]
215
325
  }
216
326
  }
217
327
  }
218
328
  ```
219
329
 
220
- ### Zed Editor
330
+ #### Zed
221
331
 
222
- Add to your Zed settings (`~/.config/zed/settings.json`):
332
+ Zed uses `context_servers`:
223
333
 
224
334
  ```json
225
335
  {
226
336
  "context_servers": {
227
337
  "dotcontext": {
228
- "command": {
229
- "path": "npx",
230
- "args": ["@dotcontext/cli", "mcp"]
231
- }
338
+ "command": "npx",
339
+ "args": ["-y", "@dotcontext/mcp@latest"],
340
+ "env": {}
232
341
  }
233
342
  }
234
343
  }
235
344
  ```
236
345
 
237
- ### Cline (VS Code Extension)
346
+ #### JetBrains IDEs
238
347
 
239
- Configure in Cline settings (VS Code → Settings → Cline → MCP Servers):
348
+ JetBrains uses a `servers` array:
240
349
 
241
350
  ```json
242
351
  {
243
- "mcpServers": {
244
- "dotcontext": {
352
+ "servers": [
353
+ {
354
+ "name": "dotcontext",
245
355
  "command": "npx",
246
- "args": ["@dotcontext/cli", "mcp"]
356
+ "args": ["-y", "@dotcontext/mcp@latest"],
357
+ "env": {}
247
358
  }
248
- }
359
+ ]
249
360
  }
250
361
  ```
251
362
 
252
- ### Codex CLI
363
+ #### Kilo Code
253
364
 
254
- Add to your Codex CLI config (`~/.codex/config.toml`):
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
- "mcpServers": {
369
+ "mcp": {
269
370
  "dotcontext": {
270
- "command": "npx",
271
- "args": ["@dotcontext/cli", "mcp"]
371
+ "type": "local",
372
+ "command": ["npx", "-y", "@dotcontext/mcp@latest"],
373
+ "enabled": true
272
374
  }
273
375
  }
274
376
  }
275
377
  ```
276
378
 
277
- ### Trae AI
379
+ #### Codex CLI
278
380
 
279
- Add to your Trae AI MCP config (Settings > MCP Servers):
381
+ Codex uses TOML:
280
382
 
281
- ```json
282
- {
283
- "mcpServers": {
284
- "dotcontext": {
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 built distribution:
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/dotcontext-cli/dist/index.js", "mcp"]
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 mcp:install` and let your AI tool use its own LLM.
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 and semantic context | `check`, `init`, `fill`, `fillSingle`, `listToFill`, `getMap`, `buildSemantic`, `scaffoldPlan` |
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 mcp:install
655
+ npx @dotcontext/mcp install
555
656
  ```
556
- Or manually replace `"ai-context"` with `"dotcontext"` and `"@ai-coders/context"` with `"@dotcontext/cli"` in your MCP JSON configs.
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"}