@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.
Files changed (417) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +234 -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 +27 -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 +365 -339
  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 +189 -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 +17 -0
  56. package/dist/services/cli/index.js.map +1 -0
  57. package/dist/services/cli/mcpInstallService.d.ts +57 -0
  58. package/dist/services/cli/mcpInstallService.d.ts.map +1 -0
  59. package/dist/services/cli/mcpInstallService.js +607 -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/utils/versionChecker.d.ts.map +1 -1
  315. package/dist/utils/versionChecker.js +17 -8
  316. package/dist/utils/versionChecker.js.map +1 -1
  317. package/dist/workflow/index.d.ts +1 -1
  318. package/dist/workflow/index.d.ts.map +1 -1
  319. package/dist/workflow/index.js +6 -1
  320. package/dist/workflow/index.js.map +1 -1
  321. package/dist/workflow/orchestrator.d.ts.map +1 -1
  322. package/dist/workflow/orchestrator.js +3 -14
  323. package/dist/workflow/orchestrator.js.map +1 -1
  324. package/dist/workflow/plans/planLinker.d.ts +13 -0
  325. package/dist/workflow/plans/planLinker.d.ts.map +1 -1
  326. package/dist/workflow/plans/planLinker.js +77 -2
  327. package/dist/workflow/plans/planLinker.js.map +1 -1
  328. package/dist/workflow/plans/types.d.ts +6 -0
  329. package/dist/workflow/plans/types.d.ts.map +1 -1
  330. package/dist/workflow/skills/frontmatter.d.ts +9 -0
  331. package/dist/workflow/skills/frontmatter.d.ts.map +1 -1
  332. package/dist/workflow/skills/frontmatter.js +16 -0
  333. package/dist/workflow/skills/frontmatter.js.map +1 -1
  334. package/dist/workflow/skills/index.d.ts +1 -1
  335. package/dist/workflow/skills/index.d.ts.map +1 -1
  336. package/dist/workflow/skills/index.js +3 -1
  337. package/dist/workflow/skills/index.js.map +1 -1
  338. package/dist/workflow/skills/skillRegistry.d.ts.map +1 -1
  339. package/dist/workflow/skills/skillRegistry.js +4 -1
  340. package/dist/workflow/skills/skillRegistry.js.map +1 -1
  341. package/dist/workflow/skills/skillTemplates.d.ts.map +1 -1
  342. package/dist/workflow/skills/skillTemplates.js +69 -30
  343. package/dist/workflow/skills/skillTemplates.js.map +1 -1
  344. package/dist/workflow/status/statusManager.d.ts +8 -3
  345. package/dist/workflow/status/statusManager.d.ts.map +1 -1
  346. package/dist/workflow/status/statusManager.js +60 -21
  347. package/dist/workflow/status/statusManager.js.map +1 -1
  348. package/dist/workflow/types.d.ts +1 -1
  349. package/package.json +19 -11
  350. package/dist/services/ai/aiSdkClient.d.ts +0 -67
  351. package/dist/services/ai/aiSdkClient.d.ts.map +0 -1
  352. package/dist/services/ai/aiSdkClient.js +0 -143
  353. package/dist/services/ai/aiSdkClient.js.map +0 -1
  354. package/dist/services/ai/index.d.ts +0 -5
  355. package/dist/services/ai/index.d.ts.map +0 -1
  356. package/dist/services/ai/index.js +0 -40
  357. package/dist/services/ai/index.js.map +0 -1
  358. package/dist/services/ai/providerFactory.d.ts +0 -35
  359. package/dist/services/ai/providerFactory.d.ts.map +0 -1
  360. package/dist/services/ai/providerFactory.js +0 -107
  361. package/dist/services/ai/providerFactory.js.map +0 -1
  362. package/dist/services/ai/schemas.d.ts +0 -557
  363. package/dist/services/ai/schemas.d.ts.map +0 -1
  364. package/dist/services/ai/schemas.js +0 -357
  365. package/dist/services/ai/schemas.js.map +0 -1
  366. package/dist/services/ai/toolRegistry.d.ts +0 -27
  367. package/dist/services/ai/toolRegistry.d.ts.map +0 -1
  368. package/dist/services/ai/toolRegistry.js +0 -151
  369. package/dist/services/ai/toolRegistry.js.map +0 -1
  370. package/dist/services/ai/tools/analyzeSymbolsTool.d.ts +0 -33
  371. package/dist/services/ai/tools/analyzeSymbolsTool.d.ts.map +0 -1
  372. package/dist/services/ai/tools/analyzeSymbolsTool.js +0 -57
  373. package/dist/services/ai/tools/analyzeSymbolsTool.js.map +0 -1
  374. package/dist/services/ai/tools/checkScaffoldingTool.d.ts +0 -18
  375. package/dist/services/ai/tools/checkScaffoldingTool.d.ts.map +0 -1
  376. package/dist/services/ai/tools/checkScaffoldingTool.js +0 -89
  377. package/dist/services/ai/tools/checkScaffoldingTool.js.map +0 -1
  378. package/dist/services/ai/tools/fillScaffoldingTool.d.ts +0 -124
  379. package/dist/services/ai/tools/fillScaffoldingTool.d.ts.map +0 -1
  380. package/dist/services/ai/tools/fillScaffoldingTool.js +0 -397
  381. package/dist/services/ai/tools/fillScaffoldingTool.js.map +0 -1
  382. package/dist/services/ai/tools/getCodebaseMapTool.d.ts +0 -17
  383. package/dist/services/ai/tools/getCodebaseMapTool.d.ts.map +0 -1
  384. package/dist/services/ai/tools/getCodebaseMapTool.js +0 -122
  385. package/dist/services/ai/tools/getCodebaseMapTool.js.map +0 -1
  386. package/dist/services/ai/tools/getFileStructureTool.d.ts +0 -29
  387. package/dist/services/ai/tools/getFileStructureTool.d.ts.map +0 -1
  388. package/dist/services/ai/tools/getFileStructureTool.js +0 -48
  389. package/dist/services/ai/tools/getFileStructureTool.js.map +0 -1
  390. package/dist/services/ai/tools/index.d.ts +0 -21
  391. package/dist/services/ai/tools/index.d.ts.map +0 -1
  392. package/dist/services/ai/tools/index.js +0 -75
  393. package/dist/services/ai/tools/index.js.map +0 -1
  394. package/dist/services/ai/tools/initializeContextTool.d.ts +0 -135
  395. package/dist/services/ai/tools/initializeContextTool.d.ts.map +0 -1
  396. package/dist/services/ai/tools/initializeContextTool.js +0 -447
  397. package/dist/services/ai/tools/initializeContextTool.js.map +0 -1
  398. package/dist/services/ai/tools/listFilesTool.d.ts +0 -18
  399. package/dist/services/ai/tools/listFilesTool.d.ts.map +0 -1
  400. package/dist/services/ai/tools/listFilesTool.js +0 -34
  401. package/dist/services/ai/tools/listFilesTool.js.map +0 -1
  402. package/dist/services/ai/tools/readFileTool.d.ts +0 -17
  403. package/dist/services/ai/tools/readFileTool.d.ts.map +0 -1
  404. package/dist/services/ai/tools/readFileTool.js +0 -63
  405. package/dist/services/ai/tools/readFileTool.js.map +0 -1
  406. package/dist/services/ai/tools/scaffoldPlanTool.d.ts +0 -41
  407. package/dist/services/ai/tools/scaffoldPlanTool.d.ts.map +0 -1
  408. package/dist/services/ai/tools/scaffoldPlanTool.js +0 -183
  409. package/dist/services/ai/tools/scaffoldPlanTool.js.map +0 -1
  410. package/dist/services/ai/tools/searchCodeTool.d.ts +0 -25
  411. package/dist/services/ai/tools/searchCodeTool.d.ts.map +0 -1
  412. package/dist/services/ai/tools/searchCodeTool.js +0 -96
  413. package/dist/services/ai/tools/searchCodeTool.js.map +0 -1
  414. package/dist/services/baseLLMClient.d.ts +0 -12
  415. package/dist/services/baseLLMClient.d.ts.map +0 -1
  416. package/dist/services/baseLLMClient.js +0 -80
  417. 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 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 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 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,227 @@ Export to any tool.
68
173
 
69
174
  #### Português
70
175
 
71
- 1. Execute `npx dotcontext 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`
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`
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 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
+ - 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 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"**.
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
- > **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.
219
+ Examples:
128
220
 
129
- #### 2. Add Custom Server
221
+ ```bash
222
+ # Interactive install for detected tools
223
+ npx @dotcontext/mcp install
130
224
 
131
- You will see a JSON file. You must add a new entry inside the `"mcpServers"` object.
225
+ # Install for a specific tool
226
+ npx @dotcontext/mcp install codex
132
227
 
133
- Here is the template to add a server (example using `npx` for a Node.js server or a local executable):
228
+ # Install in the current project instead of your home directory
229
+ npx @dotcontext/mcp install cursor --local
134
230
 
135
- ```json
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
- #### 3. Restart the Connection
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
- 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).
258
+ ### Manual Configuration
153
259
 
154
- ### Claude Code (CLI)
260
+ Use manual configuration only when you cannot use `@dotcontext/mcp install`. The exact file format depends on the client.
155
261
 
156
- Add the MCP server using the Claude CLI:
262
+ Dotcontext writes this command into client configs:
157
263
 
158
- ```bash
159
- claude mcp add dotcontext -- npx dotcontext mcp
264
+ ```text
265
+ command: npx
266
+ args: ["-y", "@dotcontext/mcp@latest"]
160
267
  ```
161
268
 
162
- Or configure manually in `~/.claude.json`:
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": ["@dotcontext/cli", "mcp"]
278
+ "args": ["-y", "@dotcontext/mcp@latest"]
170
279
  }
171
280
  }
172
281
  }
173
282
  ```
174
283
 
175
- ### Claude Desktop
284
+ #### Cursor
176
285
 
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):
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": ["@dotcontext/cli", "mcp"]
294
+ "args": ["-y", "@dotcontext/mcp@latest"]
185
295
  }
186
296
  }
187
297
  }
188
298
  ```
189
299
 
190
- ### Cursor AI
300
+ #### Continue.dev
191
301
 
192
- Create `.cursor/mcp.json` in your project root:
302
+ Continue uses a standalone per-server file:
193
303
 
194
304
  ```json
195
305
  {
196
- "mcpServers": {
197
- "dotcontext": {
198
- "command": "npx",
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
- ### Windsurf
312
+ #### VS Code (GitHub Copilot)
206
313
 
207
- Add to your Windsurf MCP config (`~/.codeium/windsurf/mcp_config.json`):
314
+ VS Code uses `servers` instead of `mcpServers`:
208
315
 
209
316
  ```json
210
317
  {
211
- "mcpServers": {
318
+ "servers": {
212
319
  "dotcontext": {
320
+ "type": "stdio",
213
321
  "command": "npx",
214
- "args": ["@dotcontext/cli", "mcp"]
322
+ "args": ["-y", "@dotcontext/mcp@latest"]
215
323
  }
216
324
  }
217
325
  }
218
326
  ```
219
327
 
220
- ### Zed Editor
328
+ #### Zed
221
329
 
222
- Add to your Zed settings (`~/.config/zed/settings.json`):
330
+ Zed uses `context_servers`:
223
331
 
224
332
  ```json
225
333
  {
226
334
  "context_servers": {
227
335
  "dotcontext": {
228
- "command": {
229
- "path": "npx",
230
- "args": ["@dotcontext/cli", "mcp"]
231
- }
336
+ "command": "npx",
337
+ "args": ["-y", "@dotcontext/mcp@latest"],
338
+ "env": {}
232
339
  }
233
340
  }
234
341
  }
235
342
  ```
236
343
 
237
- ### Cline (VS Code Extension)
344
+ #### JetBrains IDEs
238
345
 
239
- Configure in Cline settings (VS Code → Settings → Cline → MCP Servers):
346
+ JetBrains uses a `servers` array:
240
347
 
241
348
  ```json
242
349
  {
243
- "mcpServers": {
244
- "dotcontext": {
350
+ "servers": [
351
+ {
352
+ "name": "dotcontext",
245
353
  "command": "npx",
246
- "args": ["@dotcontext/cli", "mcp"]
354
+ "args": ["-y", "@dotcontext/mcp@latest"],
355
+ "env": {}
247
356
  }
248
- }
357
+ ]
249
358
  }
250
359
  ```
251
360
 
252
- ### Codex CLI
361
+ #### Kilo Code
253
362
 
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`):
363
+ Kilo uses `mcp.dotcontext` with a command array:
265
364
 
266
365
  ```json
267
366
  {
268
- "mcpServers": {
367
+ "mcp": {
269
368
  "dotcontext": {
270
- "command": "npx",
271
- "args": ["@dotcontext/cli", "mcp"]
369
+ "type": "local",
370
+ "command": ["npx", "-y", "@dotcontext/mcp@latest"],
371
+ "enabled": true
272
372
  }
273
373
  }
274
374
  }
275
375
  ```
276
376
 
277
- ### Trae AI
377
+ #### Codex CLI
278
378
 
279
- Add to your Trae AI MCP config (Settings > MCP Servers):
379
+ Codex uses TOML:
280
380
 
281
- ```json
282
- {
283
- "mcpServers": {
284
- "dotcontext": {
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 built distribution:
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/dotcontext-cli/dist/index.js", "mcp"]
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 mcp:install` and let your AI tool use its own LLM.
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 and semantic context | `check`, `init`, `fill`, `fillSingle`, `listToFill`, `getMap`, `buildSemantic`, `scaffoldPlan` |
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 mcp:install
653
+ npx @dotcontext/mcp install
555
654
  ```
556
- Or manually replace `"ai-context"` with `"dotcontext"` and `"@ai-coders/context"` with `"@dotcontext/cli"` in your MCP JSON configs.
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"}