@documentation-robotics/cli 0.1.0 → 0.1.7

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 (510) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +466 -693
  3. package/dist/analysis/data-model-analyzer.js +189 -0
  4. package/dist/analysis/data-model-analyzer.js.map +7 -0
  5. package/dist/analysis/index.js +3 -0
  6. package/dist/analysis/index.js.map +7 -0
  7. package/dist/analysis/relationship-classifier.js +181 -0
  8. package/dist/analysis/relationship-classifier.js.map +7 -0
  9. package/dist/analyzers/base-analyzer.js +1 -0
  10. package/dist/analyzers/base-analyzer.js.map +7 -0
  11. package/dist/analyzers/call-graph-utils.js +39 -0
  12. package/dist/analyzers/call-graph-utils.js.map +7 -0
  13. package/dist/analyzers/cbm-analyzer.js +1205 -0
  14. package/dist/analyzers/cbm-analyzer.js.map +7 -0
  15. package/dist/analyzers/heuristic-utils.js +55 -0
  16. package/dist/analyzers/heuristic-utils.js.map +7 -0
  17. package/dist/analyzers/mapping-loader.js +146 -0
  18. package/dist/analyzers/mapping-loader.js.map +7 -0
  19. package/dist/analyzers/registry.js +124 -0
  20. package/dist/analyzers/registry.js.map +7 -0
  21. package/dist/analyzers/session-state.js +176 -0
  22. package/dist/analyzers/session-state.js.map +7 -0
  23. package/dist/analyzers/stdio-client.js +208 -0
  24. package/dist/analyzers/stdio-client.js.map +7 -0
  25. package/dist/analyzers/types.js +15 -0
  26. package/dist/analyzers/types.js.map +7 -0
  27. package/dist/analyzers/verify-engine.js +209 -0
  28. package/dist/analyzers/verify-engine.js.map +7 -0
  29. package/dist/analyzers/verify-ignore.js +130 -0
  30. package/dist/analyzers/verify-ignore.js.map +7 -0
  31. package/dist/analyzers/version.js +8 -0
  32. package/dist/analyzers/version.js.map +7 -0
  33. package/dist/audit/ai/runner.js +41 -0
  34. package/dist/audit/ai/runner.js.map +7 -0
  35. package/dist/audit/differential-analyzer.js +183 -0
  36. package/dist/audit/differential-analyzer.js.map +7 -0
  37. package/dist/audit/index.js +32 -0
  38. package/dist/audit/index.js.map +7 -0
  39. package/dist/audit/nodes/ai/evaluator.js +49 -0
  40. package/dist/audit/nodes/ai/evaluator.js.map +7 -0
  41. package/dist/audit/nodes/ai/parser.js +55 -0
  42. package/dist/audit/nodes/ai/parser.js.map +7 -0
  43. package/dist/audit/nodes/ai/prompts.js +103 -0
  44. package/dist/audit/nodes/ai/prompts.js.map +7 -0
  45. package/dist/audit/nodes/analysis/node-completeness-checker.js +32 -0
  46. package/dist/audit/nodes/analysis/node-completeness-checker.js.map +7 -0
  47. package/dist/audit/nodes/analysis/node-definition-analyzer.js +47 -0
  48. package/dist/audit/nodes/analysis/node-definition-analyzer.js.map +7 -0
  49. package/dist/audit/nodes/analysis/node-overlap-detector.js +79 -0
  50. package/dist/audit/nodes/analysis/node-overlap-detector.js.map +7 -0
  51. package/dist/audit/nodes/model/orchestrator.js +82 -0
  52. package/dist/audit/nodes/model/orchestrator.js.map +7 -0
  53. package/dist/audit/nodes/spec/loader.js +116 -0
  54. package/dist/audit/nodes/spec/loader.js.map +7 -0
  55. package/dist/audit/nodes/spec/orchestrator.js +68 -0
  56. package/dist/audit/nodes/spec/orchestrator.js.map +7 -0
  57. package/dist/audit/nodes/types.js +1 -0
  58. package/dist/audit/nodes/types.js.map +7 -0
  59. package/dist/audit/pipeline/index.js +5 -0
  60. package/dist/audit/pipeline/index.js.map +7 -0
  61. package/dist/audit/pipeline/pipeline-orchestrator.js +218 -0
  62. package/dist/audit/pipeline/pipeline-orchestrator.js.map +7 -0
  63. package/dist/audit/relationships/ai/evaluator.js +235 -0
  64. package/dist/audit/relationships/ai/evaluator.js.map +7 -0
  65. package/dist/audit/relationships/ai/parser.js +197 -0
  66. package/dist/audit/relationships/ai/parser.js.map +7 -0
  67. package/dist/audit/relationships/ai/prompts.js +274 -0
  68. package/dist/audit/relationships/ai/prompts.js.map +7 -0
  69. package/dist/audit/relationships/analysis/balance-assessor.js +115 -0
  70. package/dist/audit/relationships/analysis/balance-assessor.js.map +7 -0
  71. package/dist/audit/relationships/analysis/coverage-analyzer.js +99 -0
  72. package/dist/audit/relationships/analysis/coverage-analyzer.js.map +7 -0
  73. package/dist/audit/relationships/analysis/duplicate-detector.js +95 -0
  74. package/dist/audit/relationships/analysis/duplicate-detector.js.map +7 -0
  75. package/dist/audit/relationships/analysis/gap-analyzer.js +99 -0
  76. package/dist/audit/relationships/analysis/gap-analyzer.js.map +7 -0
  77. package/dist/audit/relationships/analysis/layer-templates.js +294 -0
  78. package/dist/audit/relationships/analysis/layer-templates.js.map +7 -0
  79. package/dist/audit/relationships/graph/connectivity.js +129 -0
  80. package/dist/audit/relationships/graph/connectivity.js.map +7 -0
  81. package/dist/audit/relationships/graph/relationship-graph.js +179 -0
  82. package/dist/audit/relationships/graph/relationship-graph.js.map +7 -0
  83. package/dist/audit/relationships/model/balance-assessor.js +49 -0
  84. package/dist/audit/relationships/model/balance-assessor.js.map +7 -0
  85. package/dist/audit/relationships/model/coverage-analyzer.js +34 -0
  86. package/dist/audit/relationships/model/coverage-analyzer.js.map +7 -0
  87. package/dist/audit/relationships/model/duplicate-detector.js +68 -0
  88. package/dist/audit/relationships/model/duplicate-detector.js.map +7 -0
  89. package/dist/audit/relationships/model/gap-analyzer.js +41 -0
  90. package/dist/audit/relationships/model/gap-analyzer.js.map +7 -0
  91. package/dist/audit/relationships/model/orchestrator.js +126 -0
  92. package/dist/audit/relationships/model/orchestrator.js.map +7 -0
  93. package/dist/audit/relationships/spec/orchestrator.js +157 -0
  94. package/dist/audit/relationships/spec/orchestrator.js.map +7 -0
  95. package/dist/audit/reports/index.js +5 -0
  96. package/dist/audit/reports/index.js.map +7 -0
  97. package/dist/audit/reports/report-generator.js +118 -0
  98. package/dist/audit/reports/report-generator.js.map +7 -0
  99. package/dist/audit/snapshot-storage.js +163 -0
  100. package/dist/audit/snapshot-storage.js.map +7 -0
  101. package/dist/audit/types.js +21 -0
  102. package/dist/audit/types.js.map +7 -0
  103. package/dist/cli.js +223 -92
  104. package/dist/cli.js.map +3 -3
  105. package/dist/coding-agents/agents/claude-code.js +147 -0
  106. package/dist/coding-agents/agents/claude-code.js.map +7 -0
  107. package/dist/coding-agents/agents/index.js +5 -0
  108. package/dist/coding-agents/agents/index.js.map +7 -0
  109. package/dist/coding-agents/agents/types.js +1 -0
  110. package/dist/coding-agents/agents/types.js.map +7 -0
  111. package/dist/coding-agents/base-chat-client.js +45 -0
  112. package/dist/coding-agents/base-chat-client.js.map +7 -0
  113. package/dist/coding-agents/chat-utils.js +23 -0
  114. package/dist/coding-agents/chat-utils.js.map +7 -0
  115. package/dist/coding-agents/claude-code-client.js +246 -0
  116. package/dist/coding-agents/claude-code-client.js.map +7 -0
  117. package/dist/coding-agents/copilot-client.js +209 -0
  118. package/dist/coding-agents/copilot-client.js.map +7 -0
  119. package/dist/commands/add.js +95 -33
  120. package/dist/commands/add.js.map +2 -2
  121. package/dist/commands/analyzer.js +511 -0
  122. package/dist/commands/analyzer.js.map +7 -0
  123. package/dist/commands/audit-diff.js +49 -0
  124. package/dist/commands/audit-diff.js.map +7 -0
  125. package/dist/commands/audit-snapshots.js +62 -0
  126. package/dist/commands/audit-snapshots.js.map +7 -0
  127. package/dist/commands/audit.js +81 -0
  128. package/dist/commands/audit.js.map +7 -0
  129. package/dist/commands/catalog.js +248 -0
  130. package/dist/commands/catalog.js.map +7 -0
  131. package/dist/commands/changeset.js +577 -66
  132. package/dist/commands/changeset.js.map +2 -2
  133. package/dist/commands/chat.js +106 -83
  134. package/dist/commands/chat.js.map +2 -2
  135. package/dist/commands/claude.js +74 -0
  136. package/dist/commands/claude.js.map +7 -0
  137. package/dist/commands/conformance.js +71 -68
  138. package/dist/commands/conformance.js.map +2 -2
  139. package/dist/commands/copilot.js +75 -0
  140. package/dist/commands/copilot.js.map +7 -0
  141. package/dist/commands/delete.js +125 -11
  142. package/dist/commands/delete.js.map +3 -3
  143. package/dist/commands/discover-logic.js +44 -0
  144. package/dist/commands/discover-logic.js.map +7 -0
  145. package/dist/commands/docs.js +87 -0
  146. package/dist/commands/docs.js.map +7 -0
  147. package/dist/commands/element.js +14 -20
  148. package/dist/commands/element.js.map +2 -2
  149. package/dist/commands/export.js +13 -3
  150. package/dist/commands/export.js.map +2 -2
  151. package/dist/commands/import.js +51 -0
  152. package/dist/commands/import.js.map +7 -0
  153. package/dist/commands/info.js +30 -24
  154. package/dist/commands/info.js.map +2 -2
  155. package/dist/commands/init.js +27 -11
  156. package/dist/commands/init.js.map +2 -2
  157. package/dist/commands/list.js +63 -13
  158. package/dist/commands/list.js.map +3 -3
  159. package/dist/commands/relationship.js +225 -37
  160. package/dist/commands/relationship.js.map +2 -2
  161. package/dist/commands/report.js +54 -0
  162. package/dist/commands/report.js.map +7 -0
  163. package/dist/commands/reports.js +45 -0
  164. package/dist/commands/reports.js.map +7 -0
  165. package/dist/commands/schema.js +135 -0
  166. package/dist/commands/schema.js.map +7 -0
  167. package/dist/commands/search.js +40 -12
  168. package/dist/commands/search.js.map +2 -2
  169. package/dist/commands/show.js +58 -27
  170. package/dist/commands/show.js.map +2 -2
  171. package/dist/commands/stats.js +35 -0
  172. package/dist/commands/stats.js.map +7 -0
  173. package/dist/commands/trace.js +39 -16
  174. package/dist/commands/trace.js.map +2 -2
  175. package/dist/commands/update.js +141 -14
  176. package/dist/commands/update.js.map +2 -2
  177. package/dist/commands/upgrade.js +210 -46
  178. package/dist/commands/upgrade.js.map +3 -3
  179. package/dist/commands/validate.js +142 -23
  180. package/dist/commands/validate.js.map +3 -3
  181. package/dist/commands/version.js +8 -12
  182. package/dist/commands/version.js.map +2 -2
  183. package/dist/commands/visualize.js +162 -25
  184. package/dist/commands/visualize.js.map +2 -2
  185. package/dist/core/base-snapshot-manager.js +84 -0
  186. package/dist/core/base-snapshot-manager.js.map +7 -0
  187. package/dist/core/changeset-exporter.js +305 -0
  188. package/dist/core/changeset-exporter.js.map +7 -0
  189. package/dist/core/changeset-validator.js +41 -0
  190. package/dist/core/changeset-validator.js.map +7 -0
  191. package/dist/core/changeset.js +88 -173
  192. package/dist/core/changeset.js.map +2 -2
  193. package/dist/core/dependency-tracker.js +4 -2
  194. package/dist/core/dependency-tracker.js.map +2 -2
  195. package/dist/core/element.js +98 -27
  196. package/dist/core/element.js.map +2 -2
  197. package/dist/core/golden-copy-cache.js +290 -0
  198. package/dist/core/golden-copy-cache.js.map +7 -0
  199. package/dist/core/graph-model.js +266 -0
  200. package/dist/core/graph-model.js.map +7 -0
  201. package/dist/core/layer.js +159 -16
  202. package/dist/core/layer.js.map +2 -2
  203. package/dist/core/layers.js +32 -0
  204. package/dist/core/layers.js.map +7 -0
  205. package/dist/core/manifest.js +32 -11
  206. package/dist/core/manifest.js.map +2 -2
  207. package/dist/core/migration-registry.js +56 -1
  208. package/dist/core/migration-registry.js.map +2 -2
  209. package/dist/core/model.js +424 -217
  210. package/dist/core/model.js.map +3 -3
  211. package/dist/core/mutation-handler.js +179 -0
  212. package/dist/core/mutation-handler.js.map +7 -0
  213. package/dist/core/reference-registry.js +29 -21
  214. package/dist/core/reference-registry.js.map +2 -2
  215. package/dist/core/relationship-catalog.js +189 -0
  216. package/dist/core/relationship-catalog.js.map +7 -0
  217. package/dist/core/relationship-registry.js.map +2 -2
  218. package/dist/core/relationships.js.map +1 -1
  219. package/dist/core/report-data-model.js +285 -0
  220. package/dist/core/report-data-model.js.map +7 -0
  221. package/dist/core/spec-data-service.js +185 -0
  222. package/dist/core/spec-data-service.js.map +7 -0
  223. package/dist/core/spec-loader-types.js +1 -0
  224. package/dist/core/spec-loader-types.js.map +7 -0
  225. package/dist/core/spec-loader.js +234 -0
  226. package/dist/core/spec-loader.js.map +7 -0
  227. package/dist/core/staged-changeset-storage.js +282 -0
  228. package/dist/core/staged-changeset-storage.js.map +7 -0
  229. package/dist/core/staging-area.js +1002 -0
  230. package/dist/core/staging-area.js.map +7 -0
  231. package/dist/core/stats-collector.js +169 -0
  232. package/dist/core/stats-collector.js.map +7 -0
  233. package/dist/core/virtual-projection.js +443 -0
  234. package/dist/core/virtual-projection.js.map +7 -0
  235. package/dist/export/archimate-exporter.js +99 -60
  236. package/dist/export/archimate-exporter.js.map +2 -2
  237. package/dist/export/audit-formatters.js +479 -0
  238. package/dist/export/audit-formatters.js.map +7 -0
  239. package/dist/export/diff-formatters.js +99 -0
  240. package/dist/export/diff-formatters.js.map +7 -0
  241. package/dist/export/export-manager.js.map +2 -2
  242. package/dist/export/graphml-exporter.js +44 -27
  243. package/dist/export/graphml-exporter.js.map +2 -2
  244. package/dist/export/index.js +4 -0
  245. package/dist/export/index.js.map +2 -2
  246. package/dist/export/json-schema-exporter.js +55 -42
  247. package/dist/export/json-schema-exporter.js.map +2 -2
  248. package/dist/export/markdown-exporter.js +92 -70
  249. package/dist/export/markdown-exporter.js.map +2 -2
  250. package/dist/export/markdown-generator.js +248 -0
  251. package/dist/export/markdown-generator.js.map +7 -0
  252. package/dist/export/markdown-utils.js +30 -0
  253. package/dist/export/markdown-utils.js.map +7 -0
  254. package/dist/export/mermaid-markdown-exporter.js +37 -0
  255. package/dist/export/mermaid-markdown-exporter.js.map +7 -0
  256. package/dist/export/openapi-exporter.js +119 -71
  257. package/dist/export/openapi-exporter.js.map +2 -2
  258. package/dist/export/plantuml-exporter.js +104 -39
  259. package/dist/export/plantuml-exporter.js.map +2 -2
  260. package/dist/export/report-formatters.js +111 -0
  261. package/dist/export/report-formatters.js.map +7 -0
  262. package/dist/export/stats-formatters.js +98 -0
  263. package/dist/export/stats-formatters.js.map +7 -0
  264. package/dist/export/types.js +2 -14
  265. package/dist/export/types.js.map +2 -2
  266. package/dist/export/verify-formatters.js +153 -0
  267. package/dist/export/verify-formatters.js.map +7 -0
  268. package/dist/generated/compiled-validators.js +17 -0
  269. package/dist/generated/compiled-validators.js.map +7 -0
  270. package/dist/generated/index.js +31 -0
  271. package/dist/generated/index.js.map +7 -0
  272. package/dist/generated/layer-registry.js +190 -0
  273. package/dist/generated/layer-registry.js.map +7 -0
  274. package/dist/generated/layer-types.js +7 -0
  275. package/dist/generated/layer-types.js.map +7 -0
  276. package/dist/generated/node-types.js +1719 -0
  277. package/dist/generated/node-types.js.map +7 -0
  278. package/dist/generated/relationship-index.js +14552 -0
  279. package/dist/generated/relationship-index.js.map +7 -0
  280. package/dist/import/archimate-importer.js +166 -0
  281. package/dist/import/archimate-importer.js.map +7 -0
  282. package/dist/import/index.js +47 -0
  283. package/dist/import/index.js.map +7 -0
  284. package/dist/import/openapi-importer.js +143 -0
  285. package/dist/import/openapi-importer.js.map +7 -0
  286. package/dist/import/types.js +1 -0
  287. package/dist/import/types.js.map +7 -0
  288. package/dist/integrations/base-manager.js +311 -0
  289. package/dist/integrations/base-manager.js.map +7 -0
  290. package/dist/integrations/claude-manager.js +360 -0
  291. package/dist/integrations/claude-manager.js.map +7 -0
  292. package/dist/integrations/claude_code/agents/dr-advisor.md +253 -0
  293. package/dist/integrations/claude_code/agents/dr-architect.md +278 -0
  294. package/dist/integrations/claude_code/agents/dr-extractor.md +286 -0
  295. package/dist/integrations/claude_code/commands/dr-changeset.md +657 -0
  296. package/dist/integrations/claude_code/commands/dr-design.md +373 -0
  297. package/dist/integrations/claude_code/commands/dr-info.md +132 -0
  298. package/dist/integrations/claude_code/commands/dr-init.md +251 -0
  299. package/dist/integrations/claude_code/commands/dr-map.md +936 -0
  300. package/dist/integrations/claude_code/commands/dr-model.md +493 -0
  301. package/dist/integrations/claude_code/commands/dr-relate.md +814 -0
  302. package/dist/integrations/claude_code/commands/dr-sync.md +279 -0
  303. package/dist/integrations/claude_code/commands/dr-validate.md +654 -0
  304. package/dist/integrations/claude_code/commands/dr-verify.md +559 -0
  305. package/dist/integrations/claude_code/docs/END_TO_END_WALKTHROUGH.md +903 -0
  306. package/dist/integrations/claude_code/docs/QUICK_START.md +271 -0
  307. package/dist/integrations/claude_code/docs/README.md +347 -0
  308. package/dist/integrations/claude_code/skills/dr_01_motivation_layer/SKILL.md +550 -0
  309. package/dist/integrations/claude_code/skills/dr_02_business_layer/SKILL.md +620 -0
  310. package/dist/integrations/claude_code/skills/dr_03_security_layer/SKILL.md +642 -0
  311. package/dist/integrations/claude_code/skills/dr_04_application_layer/SKILL.md +911 -0
  312. package/dist/integrations/claude_code/skills/dr_05_technology_layer/SKILL.md +836 -0
  313. package/dist/integrations/claude_code/skills/dr_06_api_layer/SKILL.md +933 -0
  314. package/dist/integrations/claude_code/skills/dr_07_data_model_layer/SKILL.md +210 -0
  315. package/dist/integrations/claude_code/skills/dr_08_dataset_layer/SKILL.md +319 -0
  316. package/dist/integrations/claude_code/skills/dr_09_ux_layer/SKILL.md +319 -0
  317. package/dist/integrations/claude_code/skills/dr_10_navigation_layer/SKILL.md +318 -0
  318. package/dist/integrations/claude_code/skills/dr_11_apm_layer/SKILL.md +273 -0
  319. package/dist/integrations/claude_code/skills/dr_12_testing_layer/SKILL.md +273 -0
  320. package/dist/integrations/claude_code/skills/dr_changeset_reviewer/SKILL.md +187 -0
  321. package/dist/integrations/claude_code/skills/dr_codebase_memory/SKILL.md +590 -0
  322. package/dist/integrations/claude_code/skills/dr_engineering_guide/SKILL.md +295 -0
  323. package/dist/integrations/copilot-manager.js +328 -0
  324. package/dist/integrations/copilot-manager.js.map +7 -0
  325. package/dist/integrations/github_copilot/agents/dr-advisor.md +243 -0
  326. package/dist/integrations/github_copilot/agents/dr-architect.md +1567 -0
  327. package/dist/integrations/github_copilot/skills/dr_01_motivation_layer/SKILL.md +491 -0
  328. package/dist/integrations/github_copilot/skills/dr_02_business_layer/SKILL.md +539 -0
  329. package/dist/integrations/github_copilot/skills/dr_03_security_layer/SKILL.md +667 -0
  330. package/dist/integrations/github_copilot/skills/dr_04_application_layer/SKILL.md +670 -0
  331. package/dist/integrations/github_copilot/skills/dr_05_technology_layer/SKILL.md +660 -0
  332. package/dist/integrations/github_copilot/skills/dr_06_api_layer/SKILL.md +855 -0
  333. package/dist/integrations/github_copilot/skills/dr_07_data_model_layer/SKILL.md +171 -0
  334. package/dist/integrations/github_copilot/skills/dr_08_dataset_layer/SKILL.md +216 -0
  335. package/dist/integrations/github_copilot/skills/dr_09_ux_layer/SKILL.md +230 -0
  336. package/dist/integrations/github_copilot/skills/dr_10_navigation_layer/SKILL.md +228 -0
  337. package/dist/integrations/github_copilot/skills/dr_11_apm_layer/SKILL.md +234 -0
  338. package/dist/integrations/github_copilot/skills/dr_12_testing_layer/SKILL.md +230 -0
  339. package/dist/integrations/github_copilot/skills/dr_changeset_reviewer/SKILL.md +187 -0
  340. package/dist/integrations/hash-utils.js +51 -0
  341. package/dist/integrations/hash-utils.js.map +7 -0
  342. package/dist/integrations/types.js +16 -0
  343. package/dist/integrations/types.js.map +7 -0
  344. package/dist/reports/model-layer-report-generator.js +278 -0
  345. package/dist/reports/model-layer-report-generator.js.map +7 -0
  346. package/dist/reports/model-report-data.js +57 -0
  347. package/dist/reports/model-report-data.js.map +7 -0
  348. package/dist/reports/model-report-orchestrator.js +103 -0
  349. package/dist/reports/model-report-orchestrator.js.map +7 -0
  350. package/dist/schemas/bundled/analyzers/cbm.json +595 -0
  351. package/dist/schemas/bundled/analyzers/manifest.json +9 -0
  352. package/dist/schemas/bundled/api.json +3411 -0
  353. package/dist/schemas/bundled/apm.json +2371 -0
  354. package/dist/schemas/bundled/application.json +1253 -0
  355. package/dist/schemas/bundled/base.json +1622 -0
  356. package/dist/schemas/bundled/business.json +1279 -0
  357. package/dist/schemas/bundled/data-model.json +1298 -0
  358. package/dist/schemas/bundled/data-store.json +2025 -0
  359. package/dist/schemas/bundled/manifest.json +93 -0
  360. package/dist/schemas/bundled/motivation.json +1360 -0
  361. package/dist/schemas/bundled/navigation.json +1874 -0
  362. package/dist/schemas/bundled/security.json +3488 -0
  363. package/dist/schemas/bundled/technology.json +2067 -0
  364. package/dist/schemas/bundled/testing.json +3120 -0
  365. package/dist/schemas/bundled/ux.json +3592 -0
  366. package/dist/server/schemas.js +202 -0
  367. package/dist/server/schemas.js.map +7 -0
  368. package/dist/server/server.js +1336 -252
  369. package/dist/server/server.js.map +3 -3
  370. package/dist/server/telemetry-middleware.js +22 -15
  371. package/dist/server/telemetry-middleware.js.map +2 -2
  372. package/dist/server-entry.js +65 -0
  373. package/dist/server-entry.js.map +7 -0
  374. package/dist/telemetry/config.js +89 -0
  375. package/dist/telemetry/config.js.map +7 -0
  376. package/dist/telemetry/console-interceptor.js.map +1 -1
  377. package/dist/telemetry/detect.js +24 -0
  378. package/dist/telemetry/detect.js.map +7 -0
  379. package/dist/telemetry/fetch-otlp-exporter.js +112 -0
  380. package/dist/telemetry/fetch-otlp-exporter.js.map +7 -0
  381. package/dist/telemetry/index.js +153 -3
  382. package/dist/telemetry/index.js.map +2 -2
  383. package/dist/telemetry/resilient-exporter.js +22 -8
  384. package/dist/telemetry/resilient-exporter.js.map +2 -2
  385. package/dist/telemetry/resilient-log-exporter.js +17 -8
  386. package/dist/telemetry/resilient-log-exporter.js.map +2 -2
  387. package/dist/telemetry/test-instrumentation.js.map +2 -2
  388. package/dist/types/index.js +84 -0
  389. package/dist/types/index.js.map +3 -3
  390. package/dist/types/source-reference.js +1 -0
  391. package/dist/types/source-reference.js.map +7 -0
  392. package/dist/utils/chat-logger.js +292 -0
  393. package/dist/utils/chat-logger.js.map +7 -0
  394. package/dist/utils/claude-stream.js +8 -0
  395. package/dist/utils/claude-stream.js.map +7 -0
  396. package/dist/utils/date-utils.js +7 -0
  397. package/dist/utils/date-utils.js.map +7 -0
  398. package/dist/utils/element-utils.js.map +1 -1
  399. package/dist/utils/errors.js +88 -15
  400. package/dist/utils/errors.js.map +3 -3
  401. package/dist/utils/export-python-annotations.js +82 -0
  402. package/dist/utils/export-python-annotations.js.map +7 -0
  403. package/dist/utils/file-io.js +7 -2
  404. package/dist/utils/file-io.js.map +2 -2
  405. package/dist/utils/file-lock.js +156 -0
  406. package/dist/utils/file-lock.js.map +7 -0
  407. package/dist/utils/id-generator.js +18 -0
  408. package/dist/utils/id-generator.js.map +7 -0
  409. package/dist/utils/layer-name-formatter.js +16 -0
  410. package/dist/utils/layer-name-formatter.js.map +7 -0
  411. package/dist/utils/markdown-anchor.js +7 -0
  412. package/dist/utils/markdown-anchor.js.map +7 -0
  413. package/dist/utils/markdown-link.js +12 -0
  414. package/dist/utils/markdown-link.js.map +7 -0
  415. package/dist/utils/markdown-table.js +17 -0
  416. package/dist/utils/markdown-table.js.map +7 -0
  417. package/dist/utils/mermaid-utils.js +11 -0
  418. package/dist/utils/mermaid-utils.js.map +7 -0
  419. package/dist/utils/project-paths.js.map +2 -2
  420. package/dist/utils/source-reference.js +52 -0
  421. package/dist/utils/source-reference.js.map +7 -0
  422. package/dist/utils/spec-installer.js +40 -53
  423. package/dist/utils/spec-installer.js.map +2 -2
  424. package/dist/utils/spec-version.js +5 -1
  425. package/dist/utils/spec-version.js.map +2 -2
  426. package/dist/utils/string-utils.js +12 -0
  427. package/dist/utils/string-utils.js.map +7 -0
  428. package/dist/utils/table-formatting.js +19 -0
  429. package/dist/utils/table-formatting.js.map +7 -0
  430. package/dist/validators/index.js +4 -0
  431. package/dist/validators/index.js.map +2 -2
  432. package/dist/validators/naming-validator.js +20 -23
  433. package/dist/validators/naming-validator.js.map +2 -2
  434. package/dist/validators/reference-validator.js +23 -38
  435. package/dist/validators/reference-validator.js.map +2 -2
  436. package/dist/validators/relationship-schema-validator.js +243 -0
  437. package/dist/validators/relationship-schema-validator.js.map +7 -0
  438. package/dist/validators/schema-validator.js +168 -68
  439. package/dist/validators/schema-validator.js.map +2 -2
  440. package/dist/validators/semantic-validator.js +36 -60
  441. package/dist/validators/semantic-validator.js.map +2 -2
  442. package/dist/validators/types.js.map +2 -2
  443. package/dist/validators/validation-formatter.js +159 -0
  444. package/dist/validators/validation-formatter.js.map +7 -0
  445. package/dist/validators/validator.js +24 -38
  446. package/dist/validators/validator.js.map +2 -2
  447. package/dist/viewer/README.md +139 -0
  448. package/dist/viewer/assets/main-CY0Xufuj.css +1 -0
  449. package/dist/viewer/assets/main-DtgErnwF.js +81 -0
  450. package/dist/viewer/assets/vendor-CxKvDp2x.js +17 -0
  451. package/dist/viewer/favicon.svg +11 -0
  452. package/dist/viewer/fonts/inter/Inter-Black.woff2 +0 -0
  453. package/dist/viewer/fonts/inter/Inter-Bold.woff2 +0 -0
  454. package/dist/viewer/fonts/inter/Inter-ExtraBold.woff2 +0 -0
  455. package/dist/viewer/fonts/inter/Inter-Light.woff2 +0 -0
  456. package/dist/viewer/fonts/inter/Inter-Medium.woff2 +0 -0
  457. package/dist/viewer/fonts/inter/Inter-Regular.woff2 +0 -0
  458. package/dist/viewer/fonts/inter/Inter-SemiBold.woff2 +0 -0
  459. package/dist/viewer/fonts/jetbrains-mono/JetBrainsMono-Medium.woff2 +0 -0
  460. package/dist/viewer/fonts/jetbrains-mono/JetBrainsMono-Regular.woff2 +0 -0
  461. package/dist/viewer/fonts/jetbrains-mono/JetBrainsMono-SemiBold.woff2 +0 -0
  462. package/dist/viewer/index.html +15 -0
  463. package/dist/viewer/manifest.json +99 -0
  464. package/dist/viewer/version.json +1 -0
  465. package/package.json +42 -16
  466. package/PYTHON_CLI_PARITY.md +0 -265
  467. package/PYTHON_CLI_STRUCTURE_UPDATE.md +0 -246
  468. package/biome.json +0 -42
  469. package/bunfig.toml +0 -3
  470. package/dist/ai/claude-client.js +0 -71
  471. package/dist/ai/claude-client.js.map +0 -7
  472. package/dist/ai/context-provider.js +0 -129
  473. package/dist/ai/context-provider.js.map +0 -7
  474. package/dist/ai/tools.js +0 -231
  475. package/dist/ai/tools.js.map +0 -7
  476. package/dist/commands/migrate.js +0 -36
  477. package/dist/commands/migrate.js.map +0 -7
  478. package/dist/commands/project.js +0 -74
  479. package/dist/commands/project.js.map +0 -7
  480. package/dist/core/active-changeset.js +0 -52
  481. package/dist/core/active-changeset.js.map +0 -7
  482. package/dist/core/projection-engine.js +0 -288
  483. package/dist/core/projection-engine.js.map +0 -7
  484. package/dist/schemas/bundled/01-motivation-layer.schema.json +0 -942
  485. package/dist/schemas/bundled/02-business-layer.schema.json +0 -1293
  486. package/dist/schemas/bundled/03-security-layer.schema.json +0 -2177
  487. package/dist/schemas/bundled/04-application-layer.schema.json +0 -1328
  488. package/dist/schemas/bundled/05-technology-layer.schema.json +0 -1465
  489. package/dist/schemas/bundled/06-api-layer.schema.json +0 -1743
  490. package/dist/schemas/bundled/07-data-model-layer.schema.json +0 -1253
  491. package/dist/schemas/bundled/08-datastore-layer.schema.json +0 -892
  492. package/dist/schemas/bundled/09-ux-layer.schema.json +0 -1506
  493. package/dist/schemas/bundled/10-navigation-layer.schema.json +0 -843
  494. package/dist/schemas/bundled/11-apm-observability-layer.schema.json +0 -1430
  495. package/dist/schemas/bundled/12-testing-layer.schema.json +0 -1091
  496. package/dist/schemas/bundled/common/layer-extensions.schema.json +0 -266
  497. package/dist/schemas/bundled/common/predicates.schema.json +0 -493
  498. package/dist/schemas/bundled/common/relationships.schema.json +0 -791
  499. package/dist/schemas/bundled/common/source-references.schema.json +0 -71
  500. package/dist/schemas/bundled/link-registry.json +0 -1839
  501. package/dist/schemas/bundled/link-registry.schema.json +0 -339
  502. package/dist/schemas/bundled/relationship-catalog.json +0 -1302
  503. package/dist/schemas/bundled/relationship-type.schema.json +0 -221
  504. package/dist/utils/model-path.js +0 -22
  505. package/dist/utils/model-path.js.map +0 -7
  506. package/docs/TEST-INSTRUMENTATION.md +0 -405
  507. package/docs/telemetry.md +0 -427
  508. package/test-debug.js +0 -33
  509. package/test-special.mjs +0 -46
  510. package/test_runner.ts +0 -7
package/dist/cli.js.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../src/cli.ts"],
4
- "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * Documentation Robotics CLI - Bun Implementation\n * Entry point for the command-line interface\n *\n * Instrumented with OpenTelemetry to create root spans for command execution.\n * Telemetry is controlled by the TELEMETRY_ENABLED build-time constant.\n */\n\nimport { Command } from 'commander';\nimport { setGlobalOptions } from './utils/globals.js';\nimport { initCommand } from './commands/init.js';\nimport { addCommand } from './commands/add.js';\nimport { updateCommand } from './commands/update.js';\nimport { deleteCommand } from './commands/delete.js';\nimport { showCommand } from './commands/show.js';\nimport { listCommand } from './commands/list.js';\nimport { searchCommand } from './commands/search.js';\nimport { validateCommand } from './commands/validate.js';\nimport { infoCommand } from './commands/info.js';\nimport { elementCommands } from './commands/element.js';\nimport { relationshipCommands } from './commands/relationship.js';\nimport { traceCommand } from './commands/trace.js';\nimport { projectCommand, projectAllCommand } from './commands/project.js';\nimport { exportCommand } from './commands/export.js';\nimport { chatCommand } from './commands/chat.js';\nimport { upgradeCommand } from './commands/upgrade.js';\nimport { conformanceCommand } from './commands/conformance.js';\nimport { changesetCommands } from './commands/changeset.js';\nimport { versionCommand } from './commands/version.js';\nimport { initTelemetry, startActiveSpan, shutdownTelemetry } from './telemetry/index.js';\nimport { installConsoleInterceptor } from './telemetry/console-interceptor.js';\nimport { readJSON, fileExists } from './utils/file-io.js';\n\n// Declare TELEMETRY_ENABLED as a build-time constant (substituted by esbuild)\n// Provide runtime fallback when not running through esbuild\ndeclare const TELEMETRY_ENABLED: boolean;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== 'undefined' ? TELEMETRY_ENABLED : false;\n\n\n// Get CLI version from package.json\nasync function getCliVersion(): Promise<string> {\n const possiblePaths = [\n `${process.cwd()}/package.json`,\n `${import.meta.url.replace('file://', '').split('/src/')[0]}/package.json`,\n ];\n\n for (const path of possiblePaths) {\n if (await fileExists(path)) {\n try {\n const data = await readJSON<{ version: string }>(path);\n return data.version;\n } catch {\n continue;\n }\n }\n }\n\n return '0.1.0';\n}\n\nconst cliVersion = await getCliVersion();\n\nconst program = new Command();\n\n// Handle --version and -V flags early, before commander processes them\nif (process.argv.includes('--version') || process.argv.includes('-V')) {\n const { versionCommand } = await import('./commands/version.js');\n await versionCommand();\n process.exit(0);\n}\n\nprogram\n .name('dr')\n .description('Documentation Robotics CLI - Architecture Model Management')\n .option('-v, --verbose', 'Enable verbose output')\n .option('--debug', 'Enable debug mode')\n .hook('preAction', async (thisCommand) => {\n // Set up global state (verbose/debug flags)\n const options = thisCommand.opts();\n setGlobalOptions({\n verbose: options.verbose as boolean | undefined,\n debug: options.debug as boolean | undefined,\n });\n });\n\n// Model commands\nprogram\n .command('init')\n .description('Initialize a new architecture model')\n .option('--name <name>', 'Model name')\n .option('--author <author>', 'Model author')\n .option('--description <desc>', 'Model description')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr init\n $ dr init --name \"Enterprise Architecture\" --author \"Team A\"\n $ dr init --description \"12-layer federated model\"`\n )\n .action(initCommand);\n\nprogram\n .command('add <layer> <type> <id>')\n .description('Add an element to a layer')\n .option('--name <name>', 'Element name (defaults to ID)')\n .option('--description <desc>', 'Element description')\n .option('--properties <json>', 'Element properties as JSON object')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr add business business-service customer-mgmt --name \"Customer Management\"\n $ dr add api endpoint create-customer --properties '{\"method\":\"POST\",\"path\":\"/customers\"}'\n $ dr add application component customer-api --description \"REST API for customer operations\"`\n )\n .action(addCommand);\n\nprogram\n .command('update <id>')\n .description('Update an element')\n .option('--name <name>', 'New element name')\n .option('--description <desc>', 'New description')\n .option('--properties <json>', 'Updated properties (JSON)')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr update api-endpoint-create-customer --name \"Create Customer (v2)\"\n $ dr update business-service-order --description \"Updated description\"`\n )\n .action(updateCommand);\n\nprogram\n .command('delete <id>')\n .description('Delete an element')\n .option('--force', 'Skip confirmation prompt')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr delete api-endpoint-old-endpoint\n $ dr delete api-endpoint-old-endpoint --force`\n )\n .action(deleteCommand);\n\nprogram\n .command('show <id>')\n .description('Display element details')\n .option('--model <path>', 'Path to model root (contains model/manifest.yaml)')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr show api-endpoint-create-customer\n $ dr show business-service-order-mgmt`\n )\n .action((id, options) => showCommand(id, options));\n\nprogram\n .command('list <layer>')\n .description('List elements in a layer')\n .option('--type <type>', 'Filter by element type')\n .option('--json', 'Output as JSON')\n .option('--model <path>', 'Path to model root (contains model/manifest.yaml)')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr list api\n $ dr list business --type business-service\n $ dr list api --json`\n )\n .action(listCommand);\n\nprogram\n .command('search <query>')\n .description('Search for elements by name or ID')\n .option('--layer <layer>', 'Limit search to specific layer')\n .option('--type <type>', 'Filter by element type')\n .option('--json', 'Output as JSON')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr search customer\n $ dr search \"order processing\" --layer business\n $ dr search create-* --type endpoint`\n )\n .action(searchCommand);\n\nprogram\n .command('validate')\n .description('Validate the architecture model')\n .option('--layers <layers...>', 'Specific layers to validate')\n .option('--strict', 'Treat warnings as errors')\n .option('--model <path>', 'Path to model root (contains model/manifest.yaml)')\n .option('--all', 'Run all validations (default behavior)')\n .option('--markdown', 'Validate markdown structure')\n .option('--schemas', 'Validate JSON schemas')\n .option('--schema', 'Validate JSON schemas (alias for --schemas)')\n .option('--relationships', 'Validate relationships')\n .option('--structure', 'Validate documentation structure')\n .option('--naming', 'Validate naming conventions')\n .option('--references', 'Validate cross-layer references')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr validate\n $ dr validate --all --strict\n $ dr validate --schemas\n $ dr validate --relationships\n $ dr validate --layers business api`\n )\n .action(validateCommand);\n\nprogram\n .command('export <format>')\n .description('Export the architecture model to various formats')\n .option('--output <path>', 'Output file path (default: print to stdout)')\n .option('--layers <layers...>', 'Specific layers to export')\n .option('--model <path>', 'Path to model root directory or manifest.yaml file')\n .addHelpText(\n 'after',\n `\nSupported formats:\n archimate Export to ArchiMate XML (layers 1, 2, 4, 5)\n openapi Export to OpenAPI 3.0 specification (layer 6)\n jsonschema Export to JSON Schema (layer 7)\n plantuml Export to PlantUML diagram\n graphml Export to GraphML (graph visualization)\n markdown Export to Markdown documentation\n\nExamples:\n $ dr export archimate --output model.xml\n $ dr export openapi --layers api\n $ dr export markdown --output docs/architecture.md`\n )\n .action(async (format, options) => {\n await exportCommand({\n format,\n output: options.output,\n layers: options.layers,\n model: options.model,\n });\n });\n\nprogram\n .command('info')\n .description('Show model information')\n .option('--layer <layer>', 'Show specific layer details')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr info\n $ dr info --layer business`\n )\n .action(infoCommand);\n\n// Element subcommands\nconst elementGroup = program\n .command('element')\n .description('Element operations');\nelementCommands(elementGroup);\n\n// Relationship subcommands\nconst relationshipGroup = program\n .command('relationship')\n .description('Relationship operations');\nrelationshipCommands(relationshipGroup);\n\n// Dependency analysis commands\nprogram\n .command('trace <elementId>')\n .description('Trace dependencies for an element')\n .option('--direction <dir>', 'Trace direction: up (dependencies), down (dependents), both (default)')\n .option('--depth <num>', 'Maximum traversal depth')\n .option('--metrics', 'Show graph and element metrics')\n .option('--model <path>', 'Path to model root (contains model/manifest.yaml)')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr trace api-endpoint-create-customer\n $ dr trace business-service-order --direction down --metrics\n $ dr trace application-component-api --depth 3`\n )\n .action(async (elementId, options) => {\n await traceCommand(elementId, {\n direction: options.direction as 'up' | 'down' | 'both' | undefined,\n depth: options.depth ? parseInt(options.depth) : undefined,\n showMetrics: options.metrics,\n model: options.model,\n });\n });\n\nprogram\n .command('project <elementId> <targetLayers>')\n .description('Project an element to other layers using projection rules')\n .option('--rule <name>', 'Specific projection rule to use')\n .option('--dry-run', 'Show what would be created without saving')\n .option('--force', 'Overwrite existing elements')\n .option('--model <path>', 'Path to model directory')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr project application.service.api-service \"api,data-model\"\n $ dr project business.process.order-fulfillment application --dry-run\n $ dr project api.endpoint.create-order data-model --rule api-to-data`\n )\n .action(async (elementId, targetLayers, options) => {\n await projectCommand(elementId, targetLayers, {\n rule: options.rule,\n dryRun: options.dryRun,\n force: options.force,\n model: options.model,\n });\n });\n\nprogram\n .command('project-all')\n .description('Project all applicable elements based on rules')\n .option('--from <layer>', 'Source layer filter')\n .option('--to <layer>', 'Target layer filter')\n .option('--dry-run', 'Show what would be created without saving')\n .option('--model <path>', 'Path to model directory')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr project-all --from application --to api\n $ dr project-all --to data-model --dry-run\n $ dr project-all`\n )\n .action(async (options) => {\n await projectAllCommand({\n from: options.from,\n to: options.to,\n dryRun: options.dryRun,\n model: options.model,\n });\n });\n\nprogram\n .command('visualize')\n .description('Launch visualization server with WebSocket support')\n .option('--port <num>', 'Server port (default: 8080)')\n .option('--no-browser', 'Do not auto-open browser')\n .option('--no-auth', 'Disable authentication (enabled by default)')\n .option('--token <token>', 'Custom auth token (auto-generated by default)')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr visualize\n $ dr visualize --port 3000\n $ dr visualize --no-browser\n $ dr visualize --no-auth\n $ dr visualize --token my-secret-token`\n )\n .action(async (options) => {\n const { visualizeCommand } = await import('./commands/visualize.js');\n await visualizeCommand({\n port: options.port,\n noBrowser: options.browser === false, // Commander sets 'browser' to false when --no-browser is used\n noAuth: options.auth === false, // Commander sets 'auth' to false when --no-auth is used\n token: options.token,\n });\n });\n\n// AI Integration command\nprogram\n .command('chat')\n .description('Interactive chat with Claude about the architecture model')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr chat\n\nThis launches an interactive chat interface where you can ask Claude questions\nabout your architecture model. Requires Claude Code CLI to be installed and authenticated.`\n )\n .action(async () => {\n await chatCommand();\n });\n\n// Advanced commands\n// Note: migrate command has been merged into upgrade command\nprogram\n .command('version')\n .description('Show CLI and embedded spec version information')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr version`\n )\n .action(async () => {\n await versionCommand();\n });\n\nprogram\n .command('upgrade')\n .description('Upgrade spec reference and migrate model to latest versions')\n .option('-y, --yes', 'Automatically upgrade without prompting')\n .option('--dry-run', 'Show what would be upgraded without making changes')\n .option('--force', 'Skip validation during migration')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr upgrade # Scan, show plan, and prompt for upgrades\n $ dr upgrade --dry-run # Preview available upgrades\n $ dr upgrade --yes # Upgrade without prompting\n $ dr upgrade --force # Skip validation during migration`\n )\n .action(async (options) => {\n await upgradeCommand({\n yes: options.yes,\n dryRun: options.dryRun,\n force: options.force,\n });\n });\n\nprogram\n .command('conformance')\n .description('Check model conformance to layer specifications')\n .option('--layers <layers...>', 'Specific layers to check')\n .option('--json', 'Output as JSON')\n .option('--verbose', 'Verbose output')\n .addHelpText(\n 'after',\n `\nExamples:\n $ dr conformance\n $ dr conformance --layers business api application\n $ dr conformance --json\n $ dr conformance --verbose`\n )\n .action(async (options) => {\n await conformanceCommand({\n layers: options.layers,\n json: options.json,\n verbose: options.verbose,\n });\n });\n\n// Changeset subcommands\nchangesetCommands(program);\n\n// Execute CLI with proper telemetry span wrapping\n// This creates a root span that all child spans will be linked to\n(async () => {\n try {\n if (isTelemetryEnabled) {\n // Initialize telemetry before execution\n await initTelemetry();\n await installConsoleInterceptor();\n\n const commandName = process.argv[2] || 'unknown';\n const args = process.argv.slice(3).join(' ');\n\n // Wrap entire CLI execution in active span for proper context propagation\n await startActiveSpan(\n 'cli.execute',\n async (span) => {\n span.setAttributes({\n 'cli.command': commandName,\n 'cli.args': args,\n 'cli.cwd': process.cwd(),\n 'cli.version': cliVersion,\n });\n\n try {\n // Execute command - all child spans will now link to this root span\n await program.parseAsync(process.argv);\n\n // Set success status\n span.setStatus({ code: 0 }); // SpanStatusCode.OK\n } catch (error) {\n // Record exception and set error status\n span.recordException(error as Error);\n span.setStatus({\n code: 2, // SpanStatusCode.ERROR\n message: error instanceof Error ? error.message : String(error),\n });\n throw error;\n }\n },\n {\n 'cli.command': commandName,\n 'cli.args': args,\n 'cli.cwd': process.cwd(),\n 'cli.version': cliVersion,\n }\n );\n\n // Shutdown telemetry after execution completes\n await shutdownTelemetry();\n } else {\n // No telemetry - just parse normally\n await program.parseAsync(process.argv);\n }\n } catch (error) {\n // Re-throw to preserve CLI exit behavior\n throw error;\n }\n})();\n"],
5
- "mappings": "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",
6
- "names": ["versionCommand"]
4
+ "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * Documentation Robotics CLI - Bun Implementation\n * Entry point for the command-line interface\n *\n * Instrumented with OpenTelemetry to create root spans for command execution.\n * Telemetry is controlled by the TELEMETRY_ENABLED build-time constant.\n */\n\nimport { Command, CommanderError } from \"commander\";\nimport { setGlobalOptions } from \"./utils/globals.js\";\nimport { initCommand } from \"./commands/init.js\";\nimport { addCommand } from \"./commands/add.js\";\nimport { updateCommand } from \"./commands/update.js\";\nimport { deleteCommand } from \"./commands/delete.js\";\nimport { showCommand } from \"./commands/show.js\";\nimport { listCommand } from \"./commands/list.js\";\nimport { searchCommand } from \"./commands/search.js\";\nimport { validateCommand } from \"./commands/validate.js\";\nimport { infoCommand } from \"./commands/info.js\";\nimport { relationshipCommands } from \"./commands/relationship.js\";\nimport { elementCommands } from \"./commands/element.js\";\nimport { schemaCommands } from \"./commands/schema.js\";\nimport { catalogCommands } from \"./commands/catalog.js\";\nimport { docsCommands } from \"./commands/docs.js\";\nimport { traceCommand } from \"./commands/trace.js\";\nimport { exportCommand } from \"./commands/export.js\";\nimport { importCommand } from \"./commands/import.js\";\nimport { chatCommand } from \"./commands/chat.js\";\nimport { upgradeCommand } from \"./commands/upgrade.js\";\nimport { conformanceCommand } from \"./commands/conformance.js\";\nimport { changesetCommands } from \"./commands/changeset.js\";\nimport { claudeCommands } from \"./commands/claude.js\";\nimport { copilotCommands } from \"./commands/copilot.js\";\nimport { analyzerCommands } from \"./commands/analyzer.js\";\nimport { versionCommand } from \"./commands/version.js\";\nimport { statsCommand } from \"./commands/stats.js\";\nimport { reportCommand } from \"./commands/report.js\";\nimport { reportsCommands } from \"./commands/reports.js\";\nimport { auditCommand } from \"./commands/audit.js\";\nimport { auditDiffCommand } from \"./commands/audit-diff.js\";\nimport { auditSnapshotsCommand } from \"./commands/audit-snapshots.js\";\nimport { initTelemetry, startActiveSpan, shutdownTelemetry } from \"./telemetry/index.js\";\nimport { installConsoleInterceptor } from \"./telemetry/console-interceptor.js\";\nimport { getErrorMessage } from \"./utils/errors.js\";\n\n// Declare TELEMETRY_ENABLED as a build-time constant (substituted by esbuild)\n// Provide runtime fallback when not running through esbuild\ndeclare const TELEMETRY_ENABLED: boolean;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n\n// Commands that require console interceptor for telemetry logging\nconst CONSOLE_LOGGING_COMMANDS = new Set(['chat', 'validate', 'import', 'export']);\n\n/**\n * Extract exit code from an error object.\n * Handles CLIError instances and duck-typed objects with exitCode property.\n */\nasync function extractExitCode(error: unknown): Promise<number> {\n const { CLIError } = await import(\"./utils/errors.js\");\n\n if (error instanceof CLIError) {\n return error.exitCode;\n }\n\n // Commander's own errors (--help, unknown commands, etc.) carry exitCode as\n // expected control flow \u2014 handle them directly without duck-typing.\n if (error instanceof CommanderError) {\n return error.exitCode;\n }\n\n // Fallback for duck-typing (handles bundling/module issues)\n if (error && typeof error === \"object\" && \"exitCode\" in error) {\n const errorObj = error as any;\n if (typeof errorObj.exitCode === \"number\") {\n // Validate this looks like a CLIError before accepting\n if (errorObj.name === \"CLIError\" || errorObj.message) {\n if (process.argv.includes(\"--debug\")) {\n console.warn(\n \"[DEBUG] Using duck-typed error object as fallback - this may indicate a module loading issue\"\n );\n }\n return errorObj.exitCode;\n }\n }\n }\n\n return 1;\n}\n\n// Declare build-time constant (substituted by esbuild)\ndeclare const CLI_VERSION: string;\nconst cliVersion = typeof CLI_VERSION !== \"undefined\" ? CLI_VERSION : \"0.1.3\";\n\nconst program = new Command();\n\n// Handle --version and -V flags by redirecting to version command\n// This ensures they go through the telemetry wrapper\nif (process.argv.includes(\"--version\") || process.argv.includes(\"-V\")) {\n process.argv = [\"node\", \"dr\", \"version\"];\n}\n\nprogram\n .name(\"dr\")\n .description(\"Documentation Robotics CLI - Architecture Model Management\")\n .option(\"-v, --verbose\", \"Enable verbose output\")\n .option(\"--debug\", \"Enable debug mode\")\n .exitOverride() // Prevent Commander from calling process.exit() - we handle exit ourselves\n .showSuggestionAfterError() // \"Did you mean X?\" on unknown commands/options\n .hook(\"preAction\", async (thisCommand) => {\n // Set up global state (verbose/debug flags)\n const options = thisCommand.opts();\n setGlobalOptions({\n verbose: options.verbose as boolean | undefined,\n debug: options.debug as boolean | undefined,\n });\n });\n\n// Model commands\nprogram\n .command(\"init [name]\")\n .description(\"Initialize a new architecture model\")\n .option(\"--name <name>\", \"Model name (overrides positional argument)\")\n .option(\"--author <author>\", \"Model author\")\n .option(\"--description <desc>\", \"Model description\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr init\n $ dr init claudetoreum\n $ dr init \"Enterprise Architecture\" --author \"Team A\"\n $ dr init --name \"My Project\" --description \"12-layer federated model\"`\n )\n .action((name, options) => initCommand({ ...options, name: options.name || name }));\n\nprogram\n .command(\"add <layer> <type> <name>\")\n .description(\"Add an element to a layer\")\n .option(\"--name <name>\", \"Element display name (defaults to the name argument)\")\n .option(\"--description <desc>\", \"Element description\")\n .option(\"--attributes <json>\", \"Element type-specific attributes as JSON object\")\n .option(\"--source-file <path>\", \"Source file path (relative from repository root)\")\n .option(\"--source-symbol <name>\", \"Symbol name (class, function, variable) in source file\")\n .option(\"--source-provenance <type>\", \"Provenance type: extracted, manual, inferred, generated\")\n .option(\"--source-repo-remote <url>\", \"Git remote URL for repository context\")\n .option(\"--source-repo-commit <sha>\", \"Git commit SHA (40 hex characters) for repository context\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr add business service \"Customer Management\"\n $ dr add api operation \"Create Customer\" --attributes '{\"operationId\":\"createCustomer\",\"summary\":\"Create a customer\",\"tags\":\"customers\"}'\n $ dr add application component \"Customer API\" --description \"REST API for customer operations\"\n $ dr add security policy \"Auth Validator\" --source-file \"src/auth/validator.ts\" --source-symbol \"validateToken\" --source-provenance \"extracted\"\n\nNote: Element IDs are generated automatically in format {layer}.{type}.{kebab-name}`\n )\n .action(addCommand);\n\nprogram\n .command(\"update <id>\")\n .description(\"Update an element\")\n .option(\"--name <name>\", \"New element name\")\n .option(\"--description <desc>\", \"New description\")\n .option(\"--type <new-type>\", \"Change element type (must be valid for the element's layer; incompatible attributes must be cleaned up manually)\")\n .option(\"--attributes <json>\", \"Updated type-specific attributes (JSON)\")\n .option(\"--source-file <path>\", \"Source file path (relative from repository root)\")\n .option(\"--source-symbol <name>\", \"Symbol name (class, function, variable) in source file\")\n .option(\"--source-provenance <type>\", \"Provenance type: extracted, manual, inferred, generated\")\n .option(\"--source-repo-remote <url>\", \"Git remote URL for repository context\")\n .option(\"--source-repo-commit <sha>\", \"Git commit SHA (40 hex characters) for repository context\")\n .option(\"--clear-source-reference\", \"Remove source reference from element\")\n .addHelpText(\n \"after\",\n `\nNote: Changes are written immediately to model files.\nTo track changes for review, activate a changeset first:\n $ dr changeset activate my-changeset\n\nExamples:\n $ dr update api-endpoint-create-customer --name \"Create Customer (v2)\"\n $ dr update business-service-order --description \"Updated description\"\n $ dr update application-applicationfunction-process-orders --type applicationservice\n $ dr update security-policy-auth --source-file \"src/auth/policy.ts\" --source-provenance \"extracted\"`\n )\n .action(updateCommand);\n\nprogram\n .command(\"delete <id>\")\n .description(\"Delete an element\")\n .option(\"--force\", \"Skip dependency checks (confirmation is also skipped in non-TTY environments)\")\n .option(\"--cascade\", \"Remove dependent elements automatically\")\n .option(\"--dry-run\", \"Show what would be removed without actually removing\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr delete api-endpoint-old-endpoint\n $ dr delete api-endpoint-old-endpoint --force\n $ dr delete api-endpoint-old-endpoint --cascade\n $ dr delete api-endpoint-old-endpoint --dry-run\n $ dr delete api-endpoint-old-endpoint --cascade --dry-run`\n )\n .action(deleteCommand);\n\nprogram\n .command(\"show <id>\")\n .description(\"Display element details\")\n .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr show api-endpoint-create-customer\n $ dr show business-service-order-mgmt`\n )\n .action((id, options) => showCommand(id, options));\n\nprogram\n .command(\"list [layer]\")\n .description(\"List elements in a layer (or all layers if omitted)\")\n .option(\"--type <type>\", \"Filter by element type\")\n .option(\"--json\", \"Output as JSON\")\n .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr list\n $ dr list api\n $ dr list business --type businessservice\n $ dr list api --json\n $ dr list --json`\n )\n .action(listCommand);\n\nprogram\n .command(\"search <query>\")\n .description(\"Search for elements by name or ID\")\n .option(\"--layer <layer>\", \"Limit search to specific layer\")\n .option(\"--type <type>\", \"Filter by element type\")\n .option(\n \"--source-file <path>\",\n \"Find elements referencing a source file (takes precedence over pattern matching)\"\n )\n .option(\"--json\", \"Output as JSON\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr search customer\n $ dr search \"order processing\" --layer business\n $ dr search create-* --type endpoint\n $ dr search \"\" --source-file src/api/customer.ts`\n )\n .action(searchCommand);\n\nprogram\n .command(\"validate\")\n .description(\"Validate the architecture model\")\n .option(\"--layers <layers...>\", \"Specific layers to validate\")\n .option(\"--strict\", \"Treat warnings as errors\")\n .option(\"--verbose\", \"Show detailed validation output with relationship breakdown\")\n .option(\"--quiet\", \"Show minimal output\")\n .option(\"--output <path>\", \"Export validation report to file (JSON or Markdown)\")\n .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n .option(\"--orphans\", \"Show only orphaned elements grouped by layer with relationship suggestions\")\n .option(\"--all\", \"Run all validations (default behavior)\")\n .option(\"--markdown\", \"Validate markdown structure\")\n .option(\"--schemas\", \"Validate JSON schemas\")\n .option(\"--schema\", \"Validate JSON schemas (alias for --schemas)\")\n .option(\"--relationships\", \"Validate relationships\")\n .option(\"--structure\", \"Validate documentation structure\")\n .option(\"--naming\", \"Validate naming conventions\")\n .option(\"--references\", \"Validate cross-layer references\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr validate\n $ dr validate --all --strict\n $ dr validate --verbose\n $ dr validate --quiet\n $ dr validate --output report.json\n $ dr validate --output report.md\n $ dr validate --schemas\n $ dr validate --relationships\n $ dr validate --layers business api\n $ dr validate --orphans\n $ dr validate --orphans --output orphans.json`\n )\n .action(validateCommand);\n\nprogram\n .command(\"export <format>\")\n .description(\"Export the architecture model to various formats\")\n .option(\"--output <path>\", \"Output file path (default: print to stdout)\")\n .option(\"--layers <layers...>\", \"Specific layers to export\")\n .option(\"--model <path>\", \"Path to model root directory or manifest.yaml file\")\n .option(\"--include-sources\", \"Include source file paths in PlantUML diagrams as notes\")\n .addHelpText(\n \"after\",\n `\nSupported formats:\n archimate Export to ArchiMate XML (layers 1, 2, 4, 5)\n openapi Export to OpenAPI 3.0 specification (layer 6)\n jsonschema Export to JSON Schema (layer 7)\n plantuml Export to PlantUML diagram\n graphml Export to GraphML (graph visualization)\n markdown Export to Markdown documentation\n\nExamples:\n $ dr export archimate --output model.xml\n $ dr export openapi --layers api\n $ dr export plantuml --include-sources --output diagram.puml\n $ dr export markdown --output docs/architecture.md`\n )\n .action(async (format, options) => {\n await exportCommand({\n format,\n output: options.output,\n layers: options.layers,\n model: options.model,\n includeSources: options.includeSources,\n });\n });\n\nprogram\n .command(\"import <format>\")\n .description(\"Import architecture model from various formats\")\n .option(\"--input <path>\", \"Input file path (required)\", undefined)\n .option(\"--model <path>\", \"Path to model root directory or manifest.yaml file\")\n .option(\n \"--merge-strategy <strategy>\",\n \"How to handle existing elements: add, update, skip (default: add)\"\n )\n .addHelpText(\n \"after\",\n `\nSupported formats:\n archimate Import from ArchiMate XML (layers 1, 2, 4, 5)\n openapi Import from OpenAPI 3.0 specification (layer 6)\n\nExamples:\n $ dr import archimate --input model.xml\n $ dr import openapi --input api.json --merge-strategy add\n $ dr import archimate --input model.xml --model ./myproject`\n )\n .action(async (format, options) => {\n if (!options.input) {\n console.error(\"Error: --input path is required\");\n process.exit(1);\n }\n await importCommand({\n format,\n input: options.input,\n model: options.model,\n mergeStrategy: options.mergeStrategy as \"add\" | \"update\" | \"skip\" | undefined,\n });\n });\n\nprogram\n .command(\"info\")\n .description(\"Show model information\")\n .option(\"--layer <layer>\", \"Show specific layer details\")\n .option(\"--verbose\", \"Show detailed breakdown by element type\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr info\n $ dr info --layer business\n $ dr info --layer api --verbose`\n )\n .action(infoCommand);\n\nprogram\n .command(\"stats\")\n .description(\"Display model statistics and health metrics\")\n .option(\"--model <path>\", \"Path to the model directory\")\n .option(\"--format <format>\", \"Output format: text (default), json, markdown, compact\")\n .option(\"--output <path>\", \"Output file path (auto-detects format from extension)\")\n .option(\"--compact\", \"Show compact one-line summary\")\n .option(\"--verbose\", \"Show detailed information\")\n .addHelpText(\n \"after\",\n `\nOutput formats:\n text Full formatted statistics (default)\n json JSON output for automation\n markdown Markdown report format\n compact Single-line summary\n\nExamples:\n $ dr stats # Show full statistics\n $ dr stats --compact # Show one-line summary\n $ dr stats --format json # Output as JSON\n $ dr stats --output stats.md # Save as markdown file\n $ dr stats --output stats.json # Save as JSON file\n $ dr stats --verbose # Show detailed information`\n )\n .action((options) => statsCommand(options));\n\nprogram\n .command(\"report\")\n .description(\"Generate comprehensive architecture reports\")\n .option(\"--model <path>\", \"Path to the model directory\")\n .option(\"--type <type>\", \"Report type: comprehensive (default), statistics, relationships, data-model, quality\")\n .option(\"--format <format>\", \"Output format: text (default), json, markdown\")\n .option(\"--output <path>\", \"Output file path (auto-detects format from extension)\")\n .option(\"--verbose\", \"Show detailed information\")\n .option(\"--include-data-model\", \"Include data model analysis (default: true)\")\n .option(\"--include-quality\", \"Include quality metrics (default: true)\")\n .addHelpText(\n \"after\",\n `\nReport types:\n comprehensive Full report with statistics, relationships, and data model (default)\n statistics Statistics and quality metrics\n relationships Relationship analysis and classification\n data-model Layer 7 data model analysis\n quality Quality metrics and recommendations\n\nOutput formats:\n text Full formatted report (default)\n json JSON output for automation\n markdown Markdown report format\n\nExamples:\n $ dr report # Show comprehensive report\n $ dr report --type relationships # Show relationship analysis\n $ dr report --format json # Output as JSON\n $ dr report --output report.md # Save as markdown file\n $ dr report --type data-model --output dm.md # Data model report as markdown\n $ dr report --verbose # Show detailed information`\n )\n .action((options) => reportCommand(options));\n\n// Reports subcommands (managed layer report files)\nconst reportsGroup = program.command(\"reports\").description(\"Manage architecture layer reports\");\nreportsCommands(reportsGroup);\n\n// Audit command - Relationship analysis\nprogram\n .command(\"audit [layer]\")\n .description(\"Analyze relationship coverage, gaps, duplicates, and balance\")\n .option(\"--type <type>\", \"Audit type: relationships (default), nodes, all\")\n .option(\"--format <format>\", \"Output format: text (default), json, markdown\")\n .option(\"--output <path>\", \"Output file path (auto-detects format from extension)\")\n .option(\"--verbose\", \"Show detailed analysis\")\n .option(\"--save-snapshot\", \"Save audit report as snapshot for differential analysis\")\n .addHelpText(\n \"after\",\n `\nAudit types:\n relationships Relationship coverage, gaps, duplicates, balance (default)\n nodes Node type usage distribution across model layers\n all Both relationship and node audits\n\nOutput formats:\n text Full formatted audit report (default)\n json JSON output for automation\n markdown Markdown audit report format\n\nExamples:\n $ dr audit # Full relationship audit of all layers\n $ dr audit security # Audit security layer only\n $ dr audit --type nodes # Node type distribution audit\n $ dr audit --type all # Combined relationship + node audit\n $ dr audit --format json # Output as JSON\n $ dr audit --output audit.md # Save as markdown file\n $ dr audit --verbose # Show detailed analysis\n $ dr audit --save-snapshot # Save snapshot for later comparison\n $ dr audit api --output api-audit.json # API layer audit as JSON`\n )\n .action((layer, options) =>\n auditCommand({ ...options, layer, verbose: options.verbose ?? program.opts().verbose }));\n\n// Audit diff command - Compare snapshots\nprogram\n .command(\"audit:diff\")\n .description(\"Compare before/after audit snapshots\")\n .option(\"--before <id>\", \"Before snapshot ID or timestamp\")\n .option(\"--after <id>\", \"After snapshot ID or timestamp\")\n .option(\"--format <format>\", \"Output format: text (default), json, markdown\")\n .option(\"--output <path>\", \"Output file path\")\n .option(\"--verbose\", \"Show detailed comparison\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr audit:diff # Compare latest two snapshots\n $ dr audit:diff --before 20260220-100000 --after 20260220-150000\n $ dr audit:diff --format markdown --output diff.md\n $ dr audit:diff --verbose # Show detailed changes`\n )\n .action((options) => auditDiffCommand(options));\n\n// Audit snapshots command - Manage snapshots\nprogram\n .command(\"audit:snapshots <action>\")\n .description(\"Manage audit snapshots (list, delete, clear)\")\n .option(\"--id <id>\", \"Snapshot ID (for delete action)\")\n .addHelpText(\n \"after\",\n `\nActions:\n list List all available snapshots\n delete Delete a specific snapshot (requires --id)\n clear Delete all snapshots\n\nExamples:\n $ dr audit:snapshots list\n $ dr audit:snapshots delete --id 20260220-100000\n $ dr audit:snapshots clear`\n )\n .action((action, options) => auditSnapshotsCommand({ ...options, action }));\n\n// Relationship subcommands\nconst relationshipGroup = program.command(\"relationship\").description(\"Relationship operations\");\nrelationshipCommands(relationshipGroup);\n\n// Element subcommands\nconst elementGroup = program.command(\"element\").description(\"Element operations\");\nelementCommands(elementGroup);\n\n// Schema introspection subcommands\nschemaCommands(program);\n\n// Catalog subcommands (modern relationship catalog)\ncatalogCommands(program);\n\n// Documentation subcommands (schema-driven generation)\ndocsCommands(program);\n\n// Dependency analysis commands\nprogram\n .command(\"trace <elementId>\")\n .description(\"Trace dependencies for an element\")\n .option(\n \"--direction <dir>\",\n \"Trace direction: up (dependencies), down (dependents), both (default)\"\n )\n .option(\"--depth <num>\", \"Maximum traversal depth\")\n .option(\"--metrics\", \"Show graph and element metrics\")\n .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr trace api-endpoint-create-customer\n $ dr trace business-service-order --direction down --metrics\n $ dr trace application-component-api --depth 3`\n )\n .action(async (elementId, options) => {\n await traceCommand(elementId, {\n direction: options.direction as \"up\" | \"down\" | \"both\" | undefined,\n depth: options.depth ? parseInt(options.depth) : undefined,\n showMetrics: options.metrics,\n model: options.model,\n });\n });\n\nprogram\n .command(\"visualize\")\n .description(\"Launch visualization server with WebSocket support\")\n .option(\"--port <num>\", \"Server port (default: 8080)\")\n .option(\"--no-browser\", \"Do not auto-open browser\")\n .option(\"--no-auth\", \"Disable authentication (enabled by default)\")\n .option(\"--token <token>\", \"Custom auth token (auto-generated by default)\")\n .option(\"--with-danger\", \"Enable dangerous mode for chat (skip permissions)\")\n .option(\n \"--viewer-path <path>\",\n \"Path to custom viewer build (e.g., ./dist/embedded/dr-viewer-bundle)\"\n )\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr visualize\n $ dr visualize --port 3000\n $ dr visualize --no-browser\n $ dr visualize --no-auth\n $ dr visualize --token my-secret-token\n $ dr visualize --with-danger\n $ dr visualize --viewer-path ./dist/embedded/dr-viewer-bundle\n\nThe --with-danger flag enables dangerous mode for chat functionality:\n - Claude Code: --dangerously-skip-permissions\n - GitHub Copilot: --allow-all-tools\n\nThe --viewer-path option allows loading a local build of the web UI:\n - Point to a directory containing index.html and supporting files\n - Useful for developing custom viewers or using bundled distributions`\n )\n .action(async (options) => {\n const { visualizeCommand } = await import(\"./commands/visualize.js\");\n await visualizeCommand({\n port: options.port,\n noBrowser: options.browser === false, // Commander sets 'browser' to false when --no-browser is used\n noAuth: options.auth === false, // Commander sets 'auth' to false when --no-auth is used\n token: options.token,\n withDanger: options.withDanger,\n viewerPath: options.viewerPath,\n });\n });\n\n// AI Integration command\nprogram\n .command(\"chat [client] [withDanger]\")\n .description(\"Interactive chat with AI about the architecture model\")\n .addHelpText(\n \"after\",\n `\nArguments:\n client Optional AI client to use: \"claude-code\" or \"github-copilot\"\n withDanger Enable dangerous mode: \"with-danger\"\n\nExamples:\n $ dr chat # Auto-detect or use saved preference\n $ dr chat claude-code # Use Claude Code, save as preference\n $ dr chat github-copilot # Use GitHub Copilot, save as preference\n $ dr chat with-danger # Auto-detect with dangerous mode\n $ dr chat claude-code with-danger # Use Claude Code with dangerous mode\n $ dr chat github-copilot with-danger # Use GitHub Copilot with dangerous mode\n\nDangerous mode enables:\n - Claude Code: --dangerously-skip-permissions\n - GitHub Copilot: --allow-all-tools\n\nThis launches an interactive chat interface where you can ask AI questions\nabout your architecture model. Supports Claude Code CLI and GitHub Copilot CLI.\n\nInstall instructions:\n - Claude Code: https://claude.ai\n - GitHub Copilot: gh extension install github/gh-copilot`\n )\n .action(async (client?: string, withDangerArg?: string) => {\n // Parse arguments - handle both \"with-danger\" as first or second arg\n let selectedClient: string | undefined;\n let withDanger = false;\n\n if (client === \"with-danger\") {\n // Format: dr chat with-danger\n withDanger = true;\n selectedClient = undefined;\n } else if (withDangerArg === \"with-danger\") {\n // Format: dr chat <client> with-danger\n withDanger = true;\n selectedClient = client;\n } else {\n // Format: dr chat <client>\n selectedClient = client;\n }\n\n await chatCommand(selectedClient, withDanger);\n });\n\n// Advanced commands\nprogram\n .command(\"version\")\n .description(\"Show CLI and embedded spec version information\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr version`\n )\n .action(async () => {\n await versionCommand();\n });\n\nprogram\n .command(\"upgrade\")\n .description(\"Upgrade spec reference and migrate model to latest versions\")\n .option(\"-y, --yes\", \"Automatically upgrade without prompting\")\n .option(\"--dry-run\", \"Show what would be upgraded without making changes\")\n .option(\"--force\", \"Force all upgrades regardless of current versions; skips migration validation\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr upgrade # Scan, show plan, and prompt for upgrades\n $ dr upgrade --dry-run # Preview available upgrades\n $ dr upgrade --yes # Upgrade without prompting\n $ dr upgrade --force # Force all upgrades, ignoring version checks`\n )\n .action(async (options) => {\n await upgradeCommand({\n yes: options.yes,\n dryRun: options.dryRun,\n force: options.force,\n });\n });\n\nprogram\n .command(\"conformance\")\n .description(\"Check model conformance to layer specifications\")\n .option(\"--layers <layers...>\", \"Specific layers to check\")\n .option(\"--json\", \"Output as JSON\")\n .option(\"--verbose\", \"Verbose output\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ dr conformance\n $ dr conformance --layers business api application\n $ dr conformance --json\n $ dr conformance --verbose`\n )\n .action(async (options) => {\n await conformanceCommand({\n layers: options.layers,\n json: options.json,\n verbose: options.verbose ?? program.opts().verbose,\n });\n });\n\n// Changeset subcommands\nchangesetCommands(program);\n\n// Claude Code integration subcommands\nclaudeCommands(program);\n\n// GitHub Copilot integration subcommands\ncopilotCommands(program);\n\n// Analyzer integration subcommands\nanalyzerCommands(program);\n\n// Execute CLI with proper telemetry span wrapping\n// This creates a root span that all child spans will be linked to\n(async () => {\n let exitCode = 0;\n try {\n if (isTelemetryEnabled) {\n // Initialize telemetry before execution\n await initTelemetry();\n\n // Only install console interceptor for commands that need it\n const commandName = process.argv[2] || \"unknown\";\n if (CONSOLE_LOGGING_COMMANDS.has(commandName)) {\n await installConsoleInterceptor();\n }\n\n const args = process.argv.slice(3).join(\" \");\n\n // Wrap entire CLI execution in active span for proper context propagation\n await startActiveSpan(\n \"cli.execute\",\n async (span) => {\n // Attributes already set via options parameter - no duplicate setAttributes needed\n try {\n // Execute command - all child spans will now link to this root span\n await program.parseAsync(process.argv);\n\n // Set success status\n span.setStatus({ code: 0 }); // SpanStatusCode.OK\n } catch (error) {\n // Record exception and set error status\n // CommanderError with exitCode 0 is help text / unknown subcommand shown \u2014 not a real error\n if (error instanceof CommanderError) {\n if (error.exitCode === 0) {\n span.setStatus({ code: 0 }); // SpanStatusCode.OK\n } else {\n span.recordException(error as Error);\n span.setStatus({\n code: 2, // SpanStatusCode.ERROR\n message: error.message,\n });\n }\n } else {\n span.recordException(error as Error);\n span.setStatus({\n code: 2, // SpanStatusCode.ERROR\n message: getErrorMessage(error),\n });\n }\n\n // Print error message for CLIError instances\n // Skip CommanderError \u2014 Commander already printed its own output (e.g. help text, unknown command)\n const { CLIError } = await import(\"./utils/errors.js\");\n if (error instanceof CommanderError) {\n // Commander handled its own output; nothing to print\n } else if (error instanceof CLIError) {\n console.error(error.format());\n } else if (error instanceof Error) {\n console.error(error.message);\n } else {\n console.error(String(error));\n }\n\n // Extract exit code from CLIError if available\n exitCode = await extractExitCode(error);\n // Don't throw - let telemetry shutdown complete\n }\n },\n {\n \"cli.command\": commandName,\n \"cli.args\": args,\n \"cli.cwd\": process.cwd(),\n \"cli.version\": cliVersion,\n }\n );\n\n // Shutdown telemetry after execution completes\n await shutdownTelemetry();\n\n // Exit with exit code (keepAlive disabled in exporters prevents hanging)\n process.exit(exitCode);\n } else {\n // No telemetry - just parse normally with error handling\n try {\n await program.parseAsync(process.argv);\n } catch (error) {\n // Extract exit code from CLIError if available\n // Skip CommanderError \u2014 Commander already printed its own output (e.g. help text, unknown command)\n const { CLIError } = await import(\"./utils/errors.js\");\n if (error instanceof CommanderError) {\n // Commander handled its own output; nothing to print\n } else if (error instanceof CLIError) {\n console.error(error.format());\n } else {\n // Unexpected exceptions need to be printed\n if (error instanceof Error) {\n console.error(error.message);\n } else {\n console.error(String(error));\n }\n }\n const exitCodeFromError = await extractExitCode(error);\n process.exit(exitCodeFromError);\n }\n }\n } catch (error) {\n // Error during telemetry init or shutdown\n if (!isTelemetryEnabled) {\n // No telemetry - exit immediately with error\n process.exit(1);\n }\n // Telemetry enabled - try to shutdown before exit\n await shutdownTelemetry();\n process.exit(1);\n }\n})();\n"],
5
+ "mappings": "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",
6
+ "names": []
7
7
  }
@@ -0,0 +1,147 @@
1
+ import { spawnSync, spawn } from "child_process";
2
+ class ClaudeCodeAgent {
3
+ name = "Claude Code";
4
+ command = "claude";
5
+ /**
6
+ * Check if Claude Code CLI is available
7
+ * Uses 'which' on Unix-like systems or 'where' on Windows
8
+ */
9
+ async isAvailable() {
10
+ try {
11
+ const checkCommand = process.platform === "win32" ? "where" : "which";
12
+ return spawnSync(checkCommand, [this.command], {
13
+ stdio: "pipe",
14
+ encoding: "utf-8"
15
+ }).status === 0;
16
+ } catch {
17
+ return !1;
18
+ }
19
+ }
20
+ /**
21
+ * Spawn Claude Code CLI process
22
+ *
23
+ * Creates subprocess with dr-architect agent, sends initial message via stdin,
24
+ * and monitors stdout for JSON events.
25
+ */
26
+ spawn(options) {
27
+ const { cwd, message, agentName = "dr-architect", additionalArgs = [] } = options, conversationId = `claude-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`, args = [
28
+ "--agent",
29
+ agentName,
30
+ "--print",
31
+ "--dangerously-skip-permissions",
32
+ "--verbose",
33
+ "--output-format",
34
+ "stream-json",
35
+ ...additionalArgs
36
+ ], proc = spawn(this.command, args, {
37
+ cwd,
38
+ stdio: ["pipe", "pipe", "pipe"]
39
+ });
40
+ proc.stdin.write(message), proc.stdin.end();
41
+ const completion = this.monitorProcess(proc, conversationId);
42
+ return {
43
+ process: proc,
44
+ conversationId,
45
+ completion
46
+ };
47
+ }
48
+ /**
49
+ * Parse Claude Code JSON output into chat events
50
+ *
51
+ * Claude Code outputs line-delimited JSON events:
52
+ * - {"type":"assistant","message":{"content":[{"type":"text","text":"..."}]}}
53
+ * - {"type":"assistant","message":{"content":[{"type":"tool_use","name":"..."}]}}
54
+ *
55
+ * Non-JSON lines are treated as plain text output.
56
+ */
57
+ parseOutput(chunk) {
58
+ const events = [], lines = chunk.split(`
59
+ `);
60
+ for (const line of lines)
61
+ if (line.trim())
62
+ try {
63
+ const event = JSON.parse(line);
64
+ if (event.type === "assistant") {
65
+ const content = event.message?.content || [];
66
+ for (const block of content)
67
+ block.type === "text" ? events.push({
68
+ type: "text",
69
+ content: block.text
70
+ }) : block.type === "tool_use" && events.push({
71
+ type: "tool_use",
72
+ toolName: block.name,
73
+ toolInput: block.input
74
+ });
75
+ } else event.type === "result" ? events.push({
76
+ type: "tool_result",
77
+ toolResult: event.result
78
+ }) : event.type === "error" && events.push({
79
+ type: "error",
80
+ error: event.message || "Unknown error"
81
+ });
82
+ } catch {
83
+ events.push({
84
+ type: "text",
85
+ content: line
86
+ });
87
+ }
88
+ return events;
89
+ }
90
+ /**
91
+ * Monitor process execution and accumulate results
92
+ *
93
+ * Collects all output, parses events, and resolves when process completes.
94
+ */
95
+ monitorProcess(proc, _conversationId) {
96
+ return new Promise((resolve) => {
97
+ let buffer = "";
98
+ const allEvents = [];
99
+ let fullResponse = "", errorMessage;
100
+ proc.stdout?.on("data", (data) => {
101
+ const chunk = data.toString();
102
+ buffer += chunk;
103
+ const lines = buffer.split(`
104
+ `);
105
+ buffer = lines.pop() || "";
106
+ const lineChunk = lines.join(`
107
+ `);
108
+ if (lineChunk) {
109
+ const events = this.parseOutput(lineChunk);
110
+ allEvents.push(...events);
111
+ for (const event of events)
112
+ event.type === "text" && event.content && (fullResponse += event.content);
113
+ }
114
+ }), proc.stderr?.on("data", (data) => {
115
+ const error = data.toString();
116
+ error.trim() && (errorMessage = error);
117
+ }), proc.on("close", (exitCode) => {
118
+ if (buffer.trim()) {
119
+ const events = this.parseOutput(buffer);
120
+ allEvents.push(...events);
121
+ for (const event of events)
122
+ event.type === "text" && event.content && (fullResponse += event.content);
123
+ }
124
+ allEvents.push({ type: "complete" }), resolve({
125
+ exitCode: exitCode || 0,
126
+ fullResponse,
127
+ events: allEvents,
128
+ error: errorMessage
129
+ });
130
+ }), proc.on("error", (error) => {
131
+ allEvents.push({
132
+ type: "error",
133
+ error: error.message
134
+ }), resolve({
135
+ exitCode: 1,
136
+ fullResponse,
137
+ events: allEvents,
138
+ error: error.message
139
+ });
140
+ });
141
+ });
142
+ }
143
+ }
144
+ export {
145
+ ClaudeCodeAgent
146
+ };
147
+ //# sourceMappingURL=claude-code.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/coding-agents/agents/claude-code.ts"],
4
+ "sourcesContent": ["/**\n * Claude Code CLI Agent Implementation\n *\n * Integrates Claude Code CLI (https://claude.ai) for AI-powered\n * architecture model exploration. Supports the dr-architect agent\n * with streaming JSON output parsing.\n */\n\nimport { spawnSync, spawn } from \"child_process\";\nimport {\n CodingAgent,\n AgentProcess,\n ChatEvent,\n SpawnAgentOptions,\n AgentProcessResult,\n} from \"./types.js\";\n\n/**\n * Claude Code CLI agent implementation\n *\n * Uses `claude` command with:\n * - dr-architect agent for DR-specific knowledge\n * - --output-format stream-json for structured events\n * - stdin for message input\n * - stdout for JSON event stream\n */\nexport class ClaudeCodeAgent implements CodingAgent {\n readonly name = \"Claude Code\";\n readonly command = \"claude\";\n\n /**\n * Check if Claude Code CLI is available\n * Uses 'which' on Unix-like systems or 'where' on Windows\n */\n async isAvailable(): Promise<boolean> {\n try {\n const isWindows = process.platform === \"win32\";\n const checkCommand = isWindows ? \"where\" : \"which\";\n\n const result = spawnSync(checkCommand, [this.command], {\n stdio: \"pipe\",\n encoding: \"utf-8\",\n });\n return result.status === 0;\n } catch {\n return false;\n }\n }\n\n /**\n * Spawn Claude Code CLI process\n *\n * Creates subprocess with dr-architect agent, sends initial message via stdin,\n * and monitors stdout for JSON events.\n */\n spawn(options: SpawnAgentOptions): AgentProcess {\n const { cwd, message, agentName = \"dr-architect\", additionalArgs = [] } = options;\n\n // Generate conversation ID\n const conversationId = `claude-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;\n\n // Build command arguments\n const args = [\n \"--agent\",\n agentName,\n \"--print\",\n \"--dangerously-skip-permissions\",\n \"--verbose\",\n \"--output-format\",\n \"stream-json\",\n ...additionalArgs,\n ];\n\n // Spawn process\n const proc = spawn(this.command, args, {\n cwd,\n stdio: [\"pipe\", \"pipe\", \"pipe\"],\n });\n\n // Send initial message via stdin\n proc.stdin.write(message);\n proc.stdin.end();\n\n // Set up completion promise\n const completion = this.monitorProcess(proc, conversationId);\n\n return {\n process: proc,\n conversationId,\n completion,\n };\n }\n\n /**\n * Parse Claude Code JSON output into chat events\n *\n * Claude Code outputs line-delimited JSON events:\n * - {\"type\":\"assistant\",\"message\":{\"content\":[{\"type\":\"text\",\"text\":\"...\"}]}}\n * - {\"type\":\"assistant\",\"message\":{\"content\":[{\"type\":\"tool_use\",\"name\":\"...\"}]}}\n *\n * Non-JSON lines are treated as plain text output.\n */\n parseOutput(chunk: string): ChatEvent[] {\n const events: ChatEvent[] = [];\n const lines = chunk.split(\"\\n\");\n\n for (const line of lines) {\n if (!line.trim()) continue;\n\n try {\n const event = JSON.parse(line);\n\n if (event.type === \"assistant\") {\n const content = event.message?.content || [];\n for (const block of content) {\n if (block.type === \"text\") {\n events.push({\n type: \"text\",\n content: block.text,\n });\n } else if (block.type === \"tool_use\") {\n events.push({\n type: \"tool_use\",\n toolName: block.name,\n toolInput: block.input,\n });\n }\n }\n } else if (event.type === \"result\") {\n events.push({\n type: \"tool_result\",\n toolResult: event.result,\n });\n } else if (event.type === \"error\") {\n events.push({\n type: \"error\",\n error: event.message || \"Unknown error\",\n });\n }\n } catch {\n // Non-JSON line - treat as plain text\n events.push({\n type: \"text\",\n content: line,\n });\n }\n }\n\n return events;\n }\n\n /**\n * Monitor process execution and accumulate results\n *\n * Collects all output, parses events, and resolves when process completes.\n */\n private monitorProcess(\n proc: ReturnType<typeof spawn>,\n _conversationId: string\n ): Promise<AgentProcessResult> {\n return new Promise((resolve) => {\n let buffer = \"\";\n const allEvents: ChatEvent[] = [];\n let fullResponse = \"\";\n let errorMessage: string | undefined;\n\n // Collect stdout\n proc.stdout?.on(\"data\", (data: Buffer) => {\n const chunk = data.toString();\n buffer += chunk;\n\n // Process complete lines\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() || \"\";\n\n const lineChunk = lines.join(\"\\n\");\n if (lineChunk) {\n const events = this.parseOutput(lineChunk);\n allEvents.push(...events);\n\n // Accumulate text content\n for (const event of events) {\n if (event.type === \"text\" && event.content) {\n fullResponse += event.content;\n }\n }\n }\n });\n\n // Collect stderr for errors\n proc.stderr?.on(\"data\", (data: Buffer) => {\n const error = data.toString();\n if (error.trim()) {\n errorMessage = error;\n }\n });\n\n // Handle process completion\n proc.on(\"close\", (exitCode) => {\n // Process any remaining buffer\n if (buffer.trim()) {\n const events = this.parseOutput(buffer);\n allEvents.push(...events);\n for (const event of events) {\n if (event.type === \"text\" && event.content) {\n fullResponse += event.content;\n }\n }\n }\n\n // Add completion event\n allEvents.push({ type: \"complete\" });\n\n resolve({\n exitCode: exitCode || 0,\n fullResponse,\n events: allEvents,\n error: errorMessage,\n });\n });\n\n // Handle process errors\n proc.on(\"error\", (error) => {\n allEvents.push({\n type: \"error\",\n error: error.message,\n });\n\n resolve({\n exitCode: 1,\n fullResponse,\n events: allEvents,\n error: error.message,\n });\n });\n });\n }\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,5 @@
1
+ import { ClaudeCodeAgent } from "./claude-code.js";
2
+ export {
3
+ ClaudeCodeAgent
4
+ };
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/coding-agents/agents/index.ts"],
4
+ "sourcesContent": ["/**\n * Coding Agent Abstraction Layer\n *\n * Provides a unified interface for integrating multiple coding agent CLIs\n * (Claude Code, GitHub Copilot, etc.) with consistent availability checking,\n * process spawning, and output parsing.\n *\n * @module ai/agents\n */\n\n// Types\nexport type {\n CodingAgent,\n AgentProcess,\n AgentProcessResult,\n ChatEvent,\n ChatEventType,\n SpawnAgentOptions,\n} from \"./types.js\";\n\n// Implementations\nexport { ClaudeCodeAgent } from \"./claude-code.js\";\n"],
5
+ "mappings": "AAqBA,SAAS,uBAAuB;",
6
+ "names": []
7
+ }
@@ -0,0 +1 @@
1
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": [],
4
+ "sourcesContent": [],
5
+ "mappings": "",
6
+ "names": []
7
+ }
@@ -0,0 +1,45 @@
1
+ class BaseChatClient {
2
+ currentSession;
3
+ /**
4
+ * Get the current session information
5
+ * @returns Current session or undefined if no session exists
6
+ */
7
+ getCurrentSession() {
8
+ return this.currentSession;
9
+ }
10
+ /**
11
+ * Clear the current session
12
+ */
13
+ clearSession() {
14
+ this.currentSession = void 0;
15
+ }
16
+ /**
17
+ * Create a new session
18
+ * @returns The newly created session
19
+ */
20
+ createSession() {
21
+ const session = {
22
+ id: this.generateSessionId(),
23
+ createdAt: /* @__PURE__ */ new Date(),
24
+ lastMessageAt: /* @__PURE__ */ new Date()
25
+ };
26
+ return this.currentSession = session, session;
27
+ }
28
+ /**
29
+ * Update the last message timestamp for the current session
30
+ */
31
+ updateSessionTimestamp() {
32
+ this.currentSession && (this.currentSession.lastMessageAt = /* @__PURE__ */ new Date());
33
+ }
34
+ /**
35
+ * Generate a unique session ID
36
+ * @returns A unique session identifier
37
+ */
38
+ generateSessionId() {
39
+ return `session-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
40
+ }
41
+ }
42
+ export {
43
+ BaseChatClient
44
+ };
45
+ //# sourceMappingURL=base-chat-client.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/coding-agents/base-chat-client.ts"],
4
+ "sourcesContent": ["/**\n * Base Chat Client Interface\n *\n * Defines the abstraction layer for AI chat clients that can be used with\n * the Documentation Robotics CLI. Implementations include Claude Code CLI\n * and GitHub Copilot CLI.\n */\n\n/**\n * Chat message in a conversation\n */\nexport interface ChatMessage {\n role: \"user\" | \"assistant\" | \"system\";\n content: string;\n}\n\n/**\n * Session information for maintaining conversation state\n */\nexport interface ChatSession {\n id: string;\n createdAt: Date;\n lastMessageAt: Date;\n}\n\n/**\n * Options for sending a chat message\n */\nexport interface ChatOptions {\n /** Optional agent/skill name to use */\n agent?: string;\n /** Working directory for the chat */\n workingDirectory?: string;\n /** Optional session ID to continue a conversation */\n sessionId?: string;\n /** Enable dangerous mode (skip permissions for Claude, allow all tools for Copilot) */\n withDanger?: boolean;\n /**\n * Stream for real-time text output. Defaults to process.stdout.\n * Pass process.stderr to keep stdout clean for programmatic callers.\n * Pass null to suppress text output entirely.\n * Tool-use notifications always go to process.stderr regardless of this setting.\n */\n outputStream?: NodeJS.WriteStream | null;\n}\n\n/**\n * Abstract base class for AI chat clients\n *\n * Provides a common interface for different AI chat CLI tools,\n * handling availability detection, message streaming, and session management.\n */\nexport abstract class BaseChatClient {\n protected currentSession?: ChatSession;\n\n /**\n * Check if the chat CLI tool is available on the system\n * @returns Promise that resolves to true if available, false otherwise\n */\n abstract isAvailable(): Promise<boolean>;\n\n /**\n * Send a message and stream the response\n * @param message The user's message\n * @param options Chat options including agent, working directory, and session\n * @returns Promise that resolves with the complete assistant response text\n */\n abstract sendMessage(message: string, options?: ChatOptions): Promise<string>;\n\n /**\n * Get the current session information\n * @returns Current session or undefined if no session exists\n */\n getCurrentSession(): ChatSession | undefined {\n return this.currentSession;\n }\n\n /**\n * Clear the current session\n */\n clearSession(): void {\n this.currentSession = undefined;\n }\n\n /**\n * Create a new session\n * @returns The newly created session\n */\n protected createSession(): ChatSession {\n const session: ChatSession = {\n id: this.generateSessionId(),\n createdAt: new Date(),\n lastMessageAt: new Date(),\n };\n this.currentSession = session;\n return session;\n }\n\n /**\n * Update the last message timestamp for the current session\n */\n protected updateSessionTimestamp(): void {\n if (this.currentSession) {\n this.currentSession.lastMessageAt = new Date();\n }\n }\n\n /**\n * Generate a unique session ID\n * @returns A unique session identifier\n */\n protected generateSessionId(): string {\n return `session-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;\n }\n\n /**\n * Get the name of this chat client (for display purposes)\n */\n abstract getClientName(): string;\n}\n"],
5
+ "mappings": "AAoDM,MAAgB,eAAc;EACxB;;;;;EAoBV,oBAAiB;AACf,WAAO,KAAK;EACd;;;;EAKA,eAAY;AACV,SAAK,iBAAiB;EACxB;;;;;EAMU,gBAAa;AACrB,UAAM,UAAuB;MAC3B,IAAI,KAAK,kBAAiB;MAC1B,WAAW,oBAAI,KAAI;MACnB,eAAe,oBAAI,KAAI;;AAEzB,gBAAK,iBAAiB,SACf;EACT;;;;EAKU,yBAAsB;AAC9B,IAAI,KAAK,mBACP,KAAK,eAAe,gBAAgB,oBAAI,KAAI;EAEhD;;;;;EAMU,oBAAiB;AACzB,WAAO,WAAW,KAAK,IAAG,CAAE,IAAI,KAAK,OAAM,EAAG,SAAS,EAAE,EAAE,UAAU,GAAG,EAAE,CAAC;EAC7E;;",
6
+ "names": []
7
+ }
@@ -0,0 +1,23 @@
1
+ import { ClaudeCodeClient } from "./claude-code-client.js";
2
+ import { CopilotClient } from "./copilot-client.js";
3
+ async function detectAvailableClients() {
4
+ const clients = [], claudeClient = new ClaudeCodeClient();
5
+ await claudeClient.isAvailable() && clients.push(claudeClient);
6
+ const copilotClient = new CopilotClient();
7
+ return await copilotClient.isAvailable() && clients.push(copilotClient), clients;
8
+ }
9
+ function selectChatClient(clients, preferredClientName) {
10
+ if (clients.length !== 0) {
11
+ if (preferredClientName) {
12
+ const preferred = clients.find((c) => c.getClientName() === preferredClientName);
13
+ if (preferred)
14
+ return preferred;
15
+ }
16
+ return clients[0];
17
+ }
18
+ }
19
+ export {
20
+ detectAvailableClients,
21
+ selectChatClient
22
+ };
23
+ //# sourceMappingURL=chat-utils.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/coding-agents/chat-utils.ts"],
4
+ "sourcesContent": ["/**\n * Chat Utilities\n *\n * Common utilities for chat client detection and management.\n */\n\nimport { BaseChatClient } from \"./base-chat-client.js\";\nimport { ClaudeCodeClient } from \"./claude-code-client.js\";\nimport { CopilotClient } from \"./copilot-client.js\";\n\n/**\n * Detect available AI chat clients\n * Checks for Claude Code CLI and GitHub Copilot CLI\n * @returns Array of available client instances\n */\nexport async function detectAvailableClients(): Promise<BaseChatClient[]> {\n const clients: BaseChatClient[] = [];\n\n const claudeClient = new ClaudeCodeClient();\n if (await claudeClient.isAvailable()) {\n clients.push(claudeClient);\n }\n\n const copilotClient = new CopilotClient();\n if (await copilotClient.isAvailable()) {\n clients.push(copilotClient);\n }\n\n return clients;\n}\n\n/**\n * Select a chat client from available clients based on preference\n * @param clients Array of available clients\n * @param preferredClientName Optional preferred client name\n * @returns Selected client or undefined if none available\n */\nexport function selectChatClient(\n clients: BaseChatClient[],\n preferredClientName?: string | null\n): BaseChatClient | undefined {\n if (clients.length === 0) {\n return undefined;\n }\n\n // If a preference is specified, try to find it\n if (preferredClientName) {\n const preferred = clients.find((c) => c.getClientName() === preferredClientName);\n if (preferred) {\n return preferred;\n }\n }\n\n // Return first available client\n return clients[0];\n}\n"],
5
+ "mappings": "AAOA,SAAS,wBAAwB;AACjC,SAAS,qBAAqB;AAO9B,eAAsB,yBAAsB;AAC1C,QAAM,UAA4B,CAAA,GAE5B,eAAe,IAAI,iBAAgB;AACzC,EAAI,MAAM,aAAa,YAAW,KAChC,QAAQ,KAAK,YAAY;AAG3B,QAAM,gBAAgB,IAAI,cAAa;AACvC,SAAI,MAAM,cAAc,YAAW,KACjC,QAAQ,KAAK,aAAa,GAGrB;AACT;AAQM,SAAU,iBACd,SACA,qBAAmC;AAEnC,MAAI,QAAQ,WAAW,GAKvB;QAAI,qBAAqB;AACvB,YAAM,YAAY,QAAQ,KAAK,CAAC,MAAM,EAAE,cAAa,MAAO,mBAAmB;AAC/E,UAAI;AACF,eAAO;IAEX;AAGA,WAAO,QAAQ,CAAC;;AAClB;",
6
+ "names": []
7
+ }