@build-astron-co/nimbus 0.4.2 → 0.4.3

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 (430) hide show
  1. package/dist/src/agent/compaction-agent.js +24 -12
  2. package/dist/src/agent/context-manager.js +2 -1
  3. package/dist/src/agent/expand-files.js +2 -1
  4. package/dist/src/agent/loop.js +71 -33
  5. package/dist/src/agent/permissions.js +4 -2
  6. package/dist/src/agent/system-prompt.js +34 -17
  7. package/dist/src/app.js +1 -1
  8. package/dist/src/auth/keychain.js +8 -4
  9. package/dist/src/auth/store.js +70 -107
  10. package/dist/src/cli/init.js +35 -19
  11. package/dist/src/cli/run.js +18 -10
  12. package/dist/src/cli/serve.js +4 -2
  13. package/dist/src/cli.js +52 -11
  14. package/dist/src/commands/alias.js +5 -3
  15. package/dist/src/commands/audit/index.js +2 -1
  16. package/dist/src/commands/aws-terraform.js +36 -18
  17. package/dist/src/commands/completions.js +1 -1
  18. package/dist/src/commands/config.js +3 -2
  19. package/dist/src/commands/connect-github.js +92 -0
  20. package/dist/src/commands/cost/index.js +3 -2
  21. package/dist/src/commands/deploy.js +15 -10
  22. package/dist/src/commands/doctor.js +6 -3
  23. package/dist/src/commands/drift/index.js +2 -1
  24. package/dist/src/commands/export.js +5 -3
  25. package/dist/src/commands/generate-terraform.js +110 -2
  26. package/dist/src/commands/import.js +3 -3
  27. package/dist/src/commands/incident.js +10 -5
  28. package/dist/src/commands/login.js +8 -93
  29. package/dist/src/commands/logs.js +16 -8
  30. package/dist/src/commands/onboarding.js +6 -4
  31. package/dist/src/commands/pipeline.js +6 -3
  32. package/dist/src/commands/plugin.js +3 -2
  33. package/dist/src/commands/profile.js +27 -14
  34. package/dist/src/commands/questionnaire.js +1 -1
  35. package/dist/src/commands/rollback.js +3 -2
  36. package/dist/src/commands/rollout.js +5 -3
  37. package/dist/src/commands/runbook.js +17 -10
  38. package/dist/src/commands/schedule.js +10 -5
  39. package/dist/src/commands/status.js +2 -1
  40. package/dist/src/commands/team-context.js +12 -7
  41. package/dist/src/commands/template.js +1 -1
  42. package/dist/src/commands/tf/index.js +6 -3
  43. package/dist/src/commands/version.js +6 -3
  44. package/dist/src/commands/watch.js +6 -3
  45. package/dist/src/compat/sqlite.js +5 -3
  46. package/dist/src/config/mode-store.js +2 -1
  47. package/dist/src/config/profiles.js +4 -2
  48. package/dist/src/config/types.js +2 -1
  49. package/dist/src/engine/executor.js +8 -4
  50. package/dist/src/engine/planner.js +9 -5
  51. package/dist/src/llm/providers/anthropic.js +6 -3
  52. package/dist/src/llm/providers/ollama.js +1 -1
  53. package/dist/src/llm/router.js +22 -7
  54. package/dist/src/sessions/manager.js +6 -3
  55. package/dist/src/sharing/viewer.js +2 -1
  56. package/dist/src/tools/file-ops.js +1 -2
  57. package/dist/src/tools/schemas/devops.js +197 -108
  58. package/dist/src/tools/schemas/standard.js +1 -1
  59. package/dist/src/ui/App.js +25 -13
  60. package/dist/src/ui/FileDiffModal.js +22 -11
  61. package/dist/src/ui/HelpModal.js +2 -1
  62. package/dist/src/ui/InputBox.js +6 -3
  63. package/dist/src/ui/MessageList.js +40 -20
  64. package/dist/src/ui/TerminalPane.js +2 -1
  65. package/dist/src/ui/ToolCallDisplay.js +12 -6
  66. package/dist/src/ui/TreePane.js +2 -1
  67. package/dist/src/ui/ink/index.js +37 -21
  68. package/dist/src/watcher/index.js +8 -4
  69. package/package.json +3 -5
  70. package/src/__tests__/alias.test.ts +0 -133
  71. package/src/__tests__/app.test.ts +0 -76
  72. package/src/__tests__/audit.test.ts +0 -877
  73. package/src/__tests__/circuit-breaker.test.ts +0 -116
  74. package/src/__tests__/cli-run.test.ts +0 -351
  75. package/src/__tests__/compat-sqlite.test.ts +0 -68
  76. package/src/__tests__/context-manager.test.ts +0 -632
  77. package/src/__tests__/context.test.ts +0 -242
  78. package/src/__tests__/devops-terminal-gaps.test.ts +0 -718
  79. package/src/__tests__/doctor.test.ts +0 -48
  80. package/src/__tests__/enterprise.test.ts +0 -401
  81. package/src/__tests__/export.test.ts +0 -236
  82. package/src/__tests__/gap-11-18-20.test.ts +0 -958
  83. package/src/__tests__/generator.test.ts +0 -433
  84. package/src/__tests__/helm-streaming.test.ts +0 -127
  85. package/src/__tests__/hooks.test.ts +0 -582
  86. package/src/__tests__/incident.test.ts +0 -179
  87. package/src/__tests__/init.test.ts +0 -487
  88. package/src/__tests__/intent-parser.test.ts +0 -229
  89. package/src/__tests__/llm-router.test.ts +0 -209
  90. package/src/__tests__/logs.test.ts +0 -107
  91. package/src/__tests__/loop-errors.test.ts +0 -244
  92. package/src/__tests__/lsp.test.ts +0 -293
  93. package/src/__tests__/modes.test.ts +0 -336
  94. package/src/__tests__/perf-optimizations.test.ts +0 -847
  95. package/src/__tests__/permissions.test.ts +0 -338
  96. package/src/__tests__/pipeline.test.ts +0 -50
  97. package/src/__tests__/polish-phase3.test.ts +0 -340
  98. package/src/__tests__/profile.test.ts +0 -237
  99. package/src/__tests__/rollback.test.ts +0 -83
  100. package/src/__tests__/runbook.test.ts +0 -219
  101. package/src/__tests__/schedule.test.ts +0 -206
  102. package/src/__tests__/serve.test.ts +0 -275
  103. package/src/__tests__/sessions.test.ts +0 -322
  104. package/src/__tests__/sharing.test.ts +0 -340
  105. package/src/__tests__/snapshots.test.ts +0 -581
  106. package/src/__tests__/standalone-migration.test.ts +0 -199
  107. package/src/__tests__/state-db.test.ts +0 -334
  108. package/src/__tests__/status.test.ts +0 -158
  109. package/src/__tests__/stream-with-tools.test.ts +0 -778
  110. package/src/__tests__/subagents.test.ts +0 -176
  111. package/src/__tests__/system-prompt.test.ts +0 -248
  112. package/src/__tests__/terminal-gap-v2.test.ts +0 -395
  113. package/src/__tests__/terminal-parity.test.ts +0 -393
  114. package/src/__tests__/tf-apply.test.ts +0 -187
  115. package/src/__tests__/tool-converter.test.ts +0 -256
  116. package/src/__tests__/tool-schemas.test.ts +0 -602
  117. package/src/__tests__/tools.test.ts +0 -144
  118. package/src/__tests__/version-json.test.ts +0 -184
  119. package/src/__tests__/version.test.ts +0 -49
  120. package/src/__tests__/watch.test.ts +0 -129
  121. package/src/agent/compaction-agent.ts +0 -266
  122. package/src/agent/context-manager.ts +0 -499
  123. package/src/agent/context.ts +0 -427
  124. package/src/agent/deploy-preview.ts +0 -487
  125. package/src/agent/expand-files.ts +0 -108
  126. package/src/agent/index.ts +0 -68
  127. package/src/agent/loop.ts +0 -1998
  128. package/src/agent/modes.ts +0 -429
  129. package/src/agent/permissions.ts +0 -513
  130. package/src/agent/subagents/base.ts +0 -116
  131. package/src/agent/subagents/cost.ts +0 -51
  132. package/src/agent/subagents/explore.ts +0 -42
  133. package/src/agent/subagents/general.ts +0 -54
  134. package/src/agent/subagents/index.ts +0 -102
  135. package/src/agent/subagents/infra.ts +0 -59
  136. package/src/agent/subagents/security.ts +0 -69
  137. package/src/agent/system-prompt.ts +0 -990
  138. package/src/app.ts +0 -180
  139. package/src/audit/activity-log.ts +0 -290
  140. package/src/audit/compliance-checker.ts +0 -540
  141. package/src/audit/cost-tracker.ts +0 -318
  142. package/src/audit/index.ts +0 -23
  143. package/src/audit/security-scanner.ts +0 -641
  144. package/src/auth/guard.ts +0 -75
  145. package/src/auth/index.ts +0 -56
  146. package/src/auth/keychain.ts +0 -82
  147. package/src/auth/oauth.ts +0 -465
  148. package/src/auth/providers.ts +0 -470
  149. package/src/auth/sso.ts +0 -113
  150. package/src/auth/store.ts +0 -505
  151. package/src/auth/types.ts +0 -187
  152. package/src/build.ts +0 -141
  153. package/src/cli/index.ts +0 -16
  154. package/src/cli/init.ts +0 -1227
  155. package/src/cli/openapi-spec.ts +0 -356
  156. package/src/cli/run.ts +0 -628
  157. package/src/cli/serve-auth.ts +0 -80
  158. package/src/cli/serve.ts +0 -539
  159. package/src/cli/web.ts +0 -71
  160. package/src/cli.ts +0 -1728
  161. package/src/clients/core-engine-client.ts +0 -227
  162. package/src/clients/enterprise-client.ts +0 -334
  163. package/src/clients/generator-client.ts +0 -351
  164. package/src/clients/git-client.ts +0 -627
  165. package/src/clients/github-client.ts +0 -410
  166. package/src/clients/helm-client.ts +0 -504
  167. package/src/clients/index.ts +0 -80
  168. package/src/clients/k8s-client.ts +0 -497
  169. package/src/clients/llm-client.ts +0 -161
  170. package/src/clients/rest-client.ts +0 -130
  171. package/src/clients/service-discovery.ts +0 -38
  172. package/src/clients/terraform-client.ts +0 -482
  173. package/src/clients/tools-client.ts +0 -1843
  174. package/src/clients/ws-client.ts +0 -115
  175. package/src/commands/alias.ts +0 -100
  176. package/src/commands/analyze/index.ts +0 -352
  177. package/src/commands/apply/helm.ts +0 -473
  178. package/src/commands/apply/index.ts +0 -213
  179. package/src/commands/apply/k8s.ts +0 -454
  180. package/src/commands/apply/terraform.ts +0 -582
  181. package/src/commands/ask.ts +0 -167
  182. package/src/commands/audit/index.ts +0 -357
  183. package/src/commands/auth-cloud.ts +0 -407
  184. package/src/commands/auth-list.ts +0 -134
  185. package/src/commands/auth-profile.ts +0 -121
  186. package/src/commands/auth-refresh.ts +0 -187
  187. package/src/commands/auth-status.ts +0 -141
  188. package/src/commands/aws/ec2.ts +0 -501
  189. package/src/commands/aws/iam.ts +0 -397
  190. package/src/commands/aws/index.ts +0 -133
  191. package/src/commands/aws/lambda.ts +0 -396
  192. package/src/commands/aws/rds.ts +0 -439
  193. package/src/commands/aws/s3.ts +0 -439
  194. package/src/commands/aws/vpc.ts +0 -393
  195. package/src/commands/aws-discover.ts +0 -542
  196. package/src/commands/aws-terraform.ts +0 -755
  197. package/src/commands/azure/aks.ts +0 -376
  198. package/src/commands/azure/functions.ts +0 -253
  199. package/src/commands/azure/index.ts +0 -116
  200. package/src/commands/azure/storage.ts +0 -478
  201. package/src/commands/azure/vm.ts +0 -355
  202. package/src/commands/billing/index.ts +0 -256
  203. package/src/commands/chat.ts +0 -320
  204. package/src/commands/completions.ts +0 -268
  205. package/src/commands/config.ts +0 -372
  206. package/src/commands/cost/cloud-cost-estimator.ts +0 -266
  207. package/src/commands/cost/estimator.ts +0 -79
  208. package/src/commands/cost/index.ts +0 -810
  209. package/src/commands/cost/parsers/terraform.ts +0 -273
  210. package/src/commands/cost/parsers/types.ts +0 -25
  211. package/src/commands/cost/pricing/aws.ts +0 -544
  212. package/src/commands/cost/pricing/azure.ts +0 -499
  213. package/src/commands/cost/pricing/gcp.ts +0 -396
  214. package/src/commands/cost/pricing/index.ts +0 -40
  215. package/src/commands/demo.ts +0 -250
  216. package/src/commands/deploy.ts +0 -260
  217. package/src/commands/doctor.ts +0 -1386
  218. package/src/commands/drift/index.ts +0 -787
  219. package/src/commands/explain.ts +0 -277
  220. package/src/commands/export.ts +0 -146
  221. package/src/commands/feedback.ts +0 -389
  222. package/src/commands/fix.ts +0 -324
  223. package/src/commands/fs/index.ts +0 -402
  224. package/src/commands/gcp/compute.ts +0 -325
  225. package/src/commands/gcp/functions.ts +0 -271
  226. package/src/commands/gcp/gke.ts +0 -438
  227. package/src/commands/gcp/iam.ts +0 -344
  228. package/src/commands/gcp/index.ts +0 -129
  229. package/src/commands/gcp/storage.ts +0 -284
  230. package/src/commands/generate-helm.ts +0 -1249
  231. package/src/commands/generate-k8s.ts +0 -1508
  232. package/src/commands/generate-terraform.ts +0 -1202
  233. package/src/commands/gh/index.ts +0 -863
  234. package/src/commands/git/index.ts +0 -1343
  235. package/src/commands/helm/index.ts +0 -1126
  236. package/src/commands/help.ts +0 -715
  237. package/src/commands/history.ts +0 -149
  238. package/src/commands/import.ts +0 -868
  239. package/src/commands/incident.ts +0 -166
  240. package/src/commands/index.ts +0 -367
  241. package/src/commands/init.ts +0 -1051
  242. package/src/commands/k8s/index.ts +0 -1137
  243. package/src/commands/login.ts +0 -716
  244. package/src/commands/logout.ts +0 -83
  245. package/src/commands/logs.ts +0 -167
  246. package/src/commands/onboarding.ts +0 -405
  247. package/src/commands/pipeline.ts +0 -186
  248. package/src/commands/plan/display.ts +0 -279
  249. package/src/commands/plan/index.ts +0 -599
  250. package/src/commands/plugin.ts +0 -398
  251. package/src/commands/preview.ts +0 -452
  252. package/src/commands/profile.ts +0 -342
  253. package/src/commands/questionnaire.ts +0 -1172
  254. package/src/commands/resume.ts +0 -47
  255. package/src/commands/rollback.ts +0 -315
  256. package/src/commands/rollout.ts +0 -88
  257. package/src/commands/runbook.ts +0 -346
  258. package/src/commands/schedule.ts +0 -236
  259. package/src/commands/status.ts +0 -252
  260. package/src/commands/team/index.ts +0 -346
  261. package/src/commands/team-context.ts +0 -220
  262. package/src/commands/template.ts +0 -233
  263. package/src/commands/tf/index.ts +0 -1093
  264. package/src/commands/upgrade.ts +0 -609
  265. package/src/commands/usage/index.ts +0 -134
  266. package/src/commands/version.ts +0 -174
  267. package/src/commands/watch.ts +0 -153
  268. package/src/compat/index.ts +0 -2
  269. package/src/compat/runtime.ts +0 -12
  270. package/src/compat/sqlite.ts +0 -177
  271. package/src/config/index.ts +0 -17
  272. package/src/config/manager.ts +0 -530
  273. package/src/config/mode-store.ts +0 -62
  274. package/src/config/profiles.ts +0 -84
  275. package/src/config/safety-policy.ts +0 -358
  276. package/src/config/schema.ts +0 -125
  277. package/src/config/types.ts +0 -609
  278. package/src/config/workspace-state.ts +0 -53
  279. package/src/context/context-db.ts +0 -199
  280. package/src/demo/index.ts +0 -349
  281. package/src/demo/scenarios/full-journey.ts +0 -229
  282. package/src/demo/scenarios/getting-started.ts +0 -127
  283. package/src/demo/scenarios/helm-release.ts +0 -341
  284. package/src/demo/scenarios/k8s-deployment.ts +0 -194
  285. package/src/demo/scenarios/terraform-vpc.ts +0 -170
  286. package/src/demo/types.ts +0 -92
  287. package/src/engine/cost-estimator.ts +0 -480
  288. package/src/engine/diagram-generator.ts +0 -256
  289. package/src/engine/drift-detector.ts +0 -902
  290. package/src/engine/executor.ts +0 -1066
  291. package/src/engine/index.ts +0 -76
  292. package/src/engine/orchestrator.ts +0 -636
  293. package/src/engine/planner.ts +0 -787
  294. package/src/engine/safety.ts +0 -743
  295. package/src/engine/verifier.ts +0 -770
  296. package/src/enterprise/audit.ts +0 -348
  297. package/src/enterprise/auth.ts +0 -270
  298. package/src/enterprise/billing.ts +0 -822
  299. package/src/enterprise/index.ts +0 -17
  300. package/src/enterprise/teams.ts +0 -443
  301. package/src/generator/best-practices.ts +0 -1608
  302. package/src/generator/helm.ts +0 -630
  303. package/src/generator/index.ts +0 -37
  304. package/src/generator/intent-parser.ts +0 -514
  305. package/src/generator/kubernetes.ts +0 -976
  306. package/src/generator/terraform.ts +0 -1875
  307. package/src/history/index.ts +0 -8
  308. package/src/history/manager.ts +0 -250
  309. package/src/history/types.ts +0 -34
  310. package/src/hooks/config.ts +0 -432
  311. package/src/hooks/engine.ts +0 -392
  312. package/src/hooks/index.ts +0 -4
  313. package/src/llm/auth-bridge.ts +0 -198
  314. package/src/llm/circuit-breaker.ts +0 -140
  315. package/src/llm/config-loader.ts +0 -201
  316. package/src/llm/cost-calculator.ts +0 -171
  317. package/src/llm/index.ts +0 -8
  318. package/src/llm/model-aliases.ts +0 -115
  319. package/src/llm/provider-registry.ts +0 -63
  320. package/src/llm/providers/anthropic.ts +0 -462
  321. package/src/llm/providers/bedrock.ts +0 -477
  322. package/src/llm/providers/google.ts +0 -405
  323. package/src/llm/providers/ollama.ts +0 -767
  324. package/src/llm/providers/openai-compatible.ts +0 -340
  325. package/src/llm/providers/openai.ts +0 -328
  326. package/src/llm/providers/openrouter.ts +0 -338
  327. package/src/llm/router.ts +0 -1104
  328. package/src/llm/types.ts +0 -232
  329. package/src/lsp/client.ts +0 -298
  330. package/src/lsp/languages.ts +0 -119
  331. package/src/lsp/manager.ts +0 -294
  332. package/src/mcp/client.ts +0 -402
  333. package/src/mcp/index.ts +0 -5
  334. package/src/mcp/manager.ts +0 -133
  335. package/src/nimbus.ts +0 -234
  336. package/src/plugins/index.ts +0 -27
  337. package/src/plugins/loader.ts +0 -334
  338. package/src/plugins/manager.ts +0 -376
  339. package/src/plugins/types.ts +0 -284
  340. package/src/scanners/cicd-scanner.ts +0 -258
  341. package/src/scanners/cloud-scanner.ts +0 -466
  342. package/src/scanners/framework-scanner.ts +0 -469
  343. package/src/scanners/iac-scanner.ts +0 -388
  344. package/src/scanners/index.ts +0 -539
  345. package/src/scanners/language-scanner.ts +0 -276
  346. package/src/scanners/package-manager-scanner.ts +0 -277
  347. package/src/scanners/types.ts +0 -172
  348. package/src/sessions/manager.ts +0 -472
  349. package/src/sessions/types.ts +0 -44
  350. package/src/sharing/sync.ts +0 -300
  351. package/src/sharing/viewer.ts +0 -163
  352. package/src/snapshots/index.ts +0 -2
  353. package/src/snapshots/manager.ts +0 -530
  354. package/src/state/artifacts.ts +0 -147
  355. package/src/state/audit.ts +0 -137
  356. package/src/state/billing.ts +0 -240
  357. package/src/state/checkpoints.ts +0 -117
  358. package/src/state/config.ts +0 -67
  359. package/src/state/conversations.ts +0 -14
  360. package/src/state/credentials.ts +0 -154
  361. package/src/state/db.ts +0 -58
  362. package/src/state/index.ts +0 -26
  363. package/src/state/messages.ts +0 -115
  364. package/src/state/projects.ts +0 -123
  365. package/src/state/schema.ts +0 -236
  366. package/src/state/sessions.ts +0 -147
  367. package/src/state/teams.ts +0 -200
  368. package/src/telemetry.ts +0 -108
  369. package/src/tools/aws-ops.ts +0 -952
  370. package/src/tools/azure-ops.ts +0 -579
  371. package/src/tools/file-ops.ts +0 -615
  372. package/src/tools/gcp-ops.ts +0 -625
  373. package/src/tools/git-ops.ts +0 -773
  374. package/src/tools/github-ops.ts +0 -799
  375. package/src/tools/helm-ops.ts +0 -943
  376. package/src/tools/index.ts +0 -17
  377. package/src/tools/k8s-ops.ts +0 -819
  378. package/src/tools/schemas/converter.ts +0 -184
  379. package/src/tools/schemas/devops.ts +0 -3502
  380. package/src/tools/schemas/index.ts +0 -73
  381. package/src/tools/schemas/standard.ts +0 -1148
  382. package/src/tools/schemas/types.ts +0 -735
  383. package/src/tools/spawn-exec.ts +0 -148
  384. package/src/tools/terraform-ops.ts +0 -862
  385. package/src/types/ambient.d.ts +0 -193
  386. package/src/types/config.ts +0 -83
  387. package/src/types/drift.ts +0 -116
  388. package/src/types/enterprise.ts +0 -335
  389. package/src/types/index.ts +0 -20
  390. package/src/types/plan.ts +0 -44
  391. package/src/types/request.ts +0 -65
  392. package/src/types/response.ts +0 -54
  393. package/src/types/service.ts +0 -51
  394. package/src/ui/App.tsx +0 -2114
  395. package/src/ui/DeployPreview.tsx +0 -174
  396. package/src/ui/FileDiffModal.tsx +0 -162
  397. package/src/ui/Header.tsx +0 -131
  398. package/src/ui/HelpModal.tsx +0 -57
  399. package/src/ui/InputBox.tsx +0 -503
  400. package/src/ui/MessageList.tsx +0 -1032
  401. package/src/ui/PermissionPrompt.tsx +0 -163
  402. package/src/ui/StatusBar.tsx +0 -277
  403. package/src/ui/TerminalPane.tsx +0 -84
  404. package/src/ui/ToolCallDisplay.tsx +0 -643
  405. package/src/ui/TreePane.tsx +0 -132
  406. package/src/ui/chat-ui.ts +0 -850
  407. package/src/ui/index.ts +0 -33
  408. package/src/ui/ink/index.ts +0 -1444
  409. package/src/ui/streaming.ts +0 -176
  410. package/src/ui/theme.ts +0 -104
  411. package/src/ui/types.ts +0 -75
  412. package/src/utils/analytics.ts +0 -72
  413. package/src/utils/cost-warning.ts +0 -27
  414. package/src/utils/env.ts +0 -46
  415. package/src/utils/errors.ts +0 -69
  416. package/src/utils/event-bus.ts +0 -38
  417. package/src/utils/index.ts +0 -24
  418. package/src/utils/logger.ts +0 -171
  419. package/src/utils/rate-limiter.ts +0 -121
  420. package/src/utils/service-auth.ts +0 -49
  421. package/src/utils/validation.ts +0 -53
  422. package/src/version.ts +0 -4
  423. package/src/watcher/index.ts +0 -214
  424. package/src/wizard/approval.ts +0 -383
  425. package/src/wizard/index.ts +0 -25
  426. package/src/wizard/prompts.ts +0 -338
  427. package/src/wizard/types.ts +0 -172
  428. package/src/wizard/ui.ts +0 -556
  429. package/src/wizard/wizard.ts +0 -304
  430. package/tsconfig.json +0 -24
@@ -1,715 +0,0 @@
1
- /**
2
- * Help Command
3
- *
4
- * Display help documentation for CLI commands
5
- *
6
- * Usage: nimbus help [command]
7
- */
8
-
9
- import { logger } from '../utils';
10
- import { ui } from '../wizard';
11
-
12
- /**
13
- * Command options
14
- */
15
- export interface HelpOptions {
16
- command?: string;
17
- }
18
-
19
- /**
20
- * Command documentation structure
21
- */
22
- interface CommandDoc {
23
- name: string;
24
- description: string;
25
- usage: string;
26
- options?: Array<{
27
- flag: string;
28
- description: string;
29
- default?: string;
30
- }>;
31
- examples?: string[];
32
- subcommands?: Array<{
33
- name: string;
34
- description: string;
35
- }>;
36
- }
37
-
38
- /**
39
- * Command documentation
40
- */
41
- const COMMANDS: Record<string, CommandDoc> = {
42
- run: {
43
- name: 'run',
44
- description: 'Run the Nimbus DevOps agent non-interactively with a prompt',
45
- usage: 'nimbus run "<prompt>" [options]',
46
- options: [
47
- { flag: '--mode <mode>', description: 'Agent mode: plan, build, deploy', default: 'build' },
48
- { flag: '--format <fmt>', description: 'Output format: text, json', default: 'text' },
49
- { flag: '--auto-approve, -y', description: 'Auto-approve all tool permissions' },
50
- { flag: '--stdin', description: 'Read prompt from stdin (pipe support)' },
51
- { flag: '--model <model>', description: 'Override LLM model' },
52
- { flag: '--max-turns <n>', description: 'Maximum agent turns', default: '50' },
53
- ],
54
- examples: [
55
- 'nimbus run "run terraform plan and summarize changes"',
56
- 'nimbus run "check for k8s pod restarts in production" --mode plan',
57
- 'nimbus run "apply the staging deployment" --mode deploy --auto-approve',
58
- 'echo "review my IAM policies" | nimbus run --stdin --format json',
59
- ],
60
- },
61
-
62
- chat: {
63
- name: 'chat',
64
- description: 'Interactive DevOps agent — Terraform, Kubernetes, Helm, AWS, GCP, Azure',
65
- usage: 'nimbus chat [options]',
66
- options: [
67
- { flag: '-m, --message <text>', description: 'Send a single message (non-interactive)' },
68
- { flag: '-M, --model <model>', description: 'Specify LLM model to use' },
69
- { flag: '--system-prompt <prompt>', description: 'Custom system prompt' },
70
- { flag: '--show-tokens', description: 'Display token count for each message' },
71
- {
72
- flag: '--ui <mode>',
73
- description: 'UI mode: ink (default rich TUI) or readline (simple)',
74
- default: 'ink',
75
- },
76
- { flag: '--non-interactive', description: 'Run in non-interactive mode' },
77
- ],
78
- examples: [
79
- 'nimbus chat',
80
- 'nimbus chat -m "How do I create an S3 bucket?"',
81
- 'nimbus chat --model gpt-4',
82
- 'nimbus chat --ui=readline',
83
- ],
84
- },
85
-
86
- 'generate-terraform': {
87
- name: 'generate terraform',
88
- description: 'Generate Terraform configurations from existing AWS infrastructure',
89
- usage: 'nimbus generate terraform [options]',
90
- options: [
91
- { flag: '--profile <name>', description: 'AWS profile to use' },
92
- { flag: '--regions <list>', description: 'Comma-separated list of AWS regions' },
93
- { flag: '--services <list>', description: 'Comma-separated list of services to scan' },
94
- { flag: '--output <path>', description: 'Output directory for generated files' },
95
- { flag: '--non-interactive', description: 'Run in non-interactive mode' },
96
- { flag: '--accept-all-improvements', description: 'Accept all suggested improvements' },
97
- { flag: '--reject-all-improvements', description: 'Reject all suggested improvements' },
98
- ],
99
- examples: [
100
- 'nimbus generate terraform',
101
- 'nimbus generate terraform --profile production --regions us-east-1,us-west-2',
102
- 'nimbus generate terraform --services EC2,S3,RDS --output ./infra',
103
- ],
104
- },
105
-
106
- 'generate-k8s': {
107
- name: 'generate k8s',
108
- description: 'Generate Kubernetes manifests for your application',
109
- usage: 'nimbus generate k8s [options]',
110
- options: [
111
- {
112
- flag: '--type, --workload-type <type>',
113
- description: 'Workload type: deployment, statefulset, daemonset, job, cronjob',
114
- default: 'deployment',
115
- },
116
- { flag: '--name <name>', description: 'Application name' },
117
- { flag: '-n, --namespace <ns>', description: 'Kubernetes namespace', default: 'default' },
118
- { flag: '--image <image>', description: 'Container image (e.g., nginx:latest)' },
119
- { flag: '--replicas <count>', description: 'Number of replicas', default: '2' },
120
- { flag: '--port <port>', description: 'Container port', default: '8080' },
121
- {
122
- flag: '--service-type <type>',
123
- description: 'Service type: ClusterIP, NodePort, LoadBalancer',
124
- default: 'ClusterIP',
125
- },
126
- { flag: '-o, --output <path>', description: 'Output directory' },
127
- { flag: '--include-ingress', description: 'Generate Ingress resource' },
128
- { flag: '--include-hpa', description: 'Generate HorizontalPodAutoscaler' },
129
- { flag: '--include-pdb', description: 'Generate PodDisruptionBudget' },
130
- { flag: '--include-configmap', description: 'Generate ConfigMap' },
131
- { flag: '--include-secret', description: 'Generate Secret template' },
132
- { flag: '--non-interactive', description: 'Run in non-interactive mode' },
133
- ],
134
- examples: [
135
- 'nimbus generate k8s',
136
- 'nimbus generate k8s --name myapp --image nginx:latest',
137
- 'nimbus generate k8s --type deployment --name api --image myregistry/api:v1 --replicas 3',
138
- 'nimbus generate-k8s --name myapp --image nginx --non-interactive',
139
- ],
140
- },
141
-
142
- 'generate-helm': {
143
- name: 'generate helm',
144
- description: 'Generate Helm values files for chart deployment',
145
- usage: 'nimbus generate helm [options]',
146
- options: [
147
- { flag: '--chart <name>', description: 'Helm chart name (e.g., bitnami/nginx)' },
148
- { flag: '--release, --release-name <name>', description: 'Release name' },
149
- { flag: '-n, --namespace <ns>', description: 'Kubernetes namespace', default: 'default' },
150
- {
151
- flag: '--environment <env>',
152
- description: 'Target environment: dev, staging, production',
153
- default: 'dev',
154
- },
155
- { flag: '--version <version>', description: 'Chart version' },
156
- { flag: '-o, --output <path>', description: 'Output directory' },
157
- { flag: '--include-secrets', description: 'Generate separate secrets values file' },
158
- { flag: '--no-secrets', description: 'Skip secrets file generation' },
159
- { flag: '--non-interactive', description: 'Run in non-interactive mode' },
160
- ],
161
- examples: [
162
- 'nimbus generate helm',
163
- 'nimbus generate helm --chart bitnami/nginx --release my-nginx',
164
- 'nimbus generate helm --chart bitnami/postgresql --release mydb --environment production',
165
- 'nimbus generate-helm --chart bitnami/redis --release cache --non-interactive',
166
- ],
167
- },
168
-
169
- apply: {
170
- name: 'apply',
171
- description: 'Apply infrastructure changes',
172
- usage: 'nimbus apply <type> [options]',
173
- subcommands: [
174
- { name: 'terraform', description: 'Apply Terraform configuration' },
175
- { name: 'k8s', description: 'Apply Kubernetes manifests' },
176
- { name: 'helm', description: 'Install or upgrade Helm release' },
177
- ],
178
- options: [
179
- { flag: '--dry-run', description: 'Show what would be applied without making changes' },
180
- { flag: '--auto-approve', description: 'Skip confirmation prompts' },
181
- { flag: '-n, --namespace <ns>', description: 'Kubernetes namespace (for k8s/helm)' },
182
- ],
183
- examples: [
184
- 'nimbus apply terraform',
185
- 'nimbus apply k8s ./manifests/',
186
- 'nimbus apply helm myrelease ./chart',
187
- ],
188
- },
189
-
190
- plan: {
191
- name: 'plan',
192
- description: 'Preview infrastructure changes',
193
- usage: 'nimbus plan [options]',
194
- options: [
195
- {
196
- flag: '--type <type>',
197
- description: 'Infrastructure type: terraform, k8s, helm, auto',
198
- default: 'auto',
199
- },
200
- { flag: '--target <path>', description: 'Target directory or file' },
201
- { flag: '--out <file>', description: 'Save plan to file (Terraform)' },
202
- { flag: '--detailed', description: 'Show detailed plan output' },
203
- ],
204
- examples: [
205
- 'nimbus plan',
206
- 'nimbus plan --type terraform',
207
- 'nimbus plan --type k8s --target ./manifests',
208
- ],
209
- },
210
-
211
- ask: {
212
- name: 'ask',
213
- description: 'Quick question and answer with AI',
214
- usage: 'nimbus ask "<question>" [options]',
215
- options: [
216
- { flag: '--context <file>', description: 'Include file content as context' },
217
- { flag: '--model <model>', description: 'Specify LLM model to use' },
218
- ],
219
- examples: [
220
- 'nimbus ask "How do I create an EKS cluster?"',
221
- 'nimbus ask "What is the best practice for IAM roles?" --model gpt-4',
222
- 'nimbus ask "Explain this config" --context ./terraform/main.tf',
223
- ],
224
- },
225
-
226
- explain: {
227
- name: 'explain',
228
- description: 'Get AI explanations for code, infrastructure, or errors',
229
- usage: 'nimbus explain <target> [options]',
230
- options: [
231
- {
232
- flag: '--type <type>',
233
- description: 'Content type: code, infra, error, auto',
234
- default: 'auto',
235
- },
236
- { flag: '--file <path>', description: 'Read content from file' },
237
- { flag: '--verbose', description: 'Show detailed explanations' },
238
- ],
239
- examples: [
240
- 'nimbus explain ./main.tf',
241
- 'nimbus explain "Error: resource not found" --type error',
242
- 'nimbus explain --file ./deployment.yaml --verbose',
243
- ],
244
- },
245
-
246
- fix: {
247
- name: 'fix',
248
- description: 'AI-assisted error fixing',
249
- usage: 'nimbus fix <error-or-file> [options]',
250
- options: [
251
- { flag: '--file <path>', description: 'File to fix' },
252
- { flag: '--auto-apply', description: 'Automatically apply the fix' },
253
- { flag: '--dry-run', description: 'Show fix without applying' },
254
- ],
255
- examples: [
256
- 'nimbus fix "Error: undefined variable"',
257
- 'nimbus fix ./broken.tf',
258
- 'nimbus fix --file ./app.ts --auto-apply',
259
- ],
260
- },
261
-
262
- doctor: {
263
- name: 'doctor',
264
- description: 'Run diagnostic checks on your Nimbus installation',
265
- usage: 'nimbus doctor [options]',
266
- options: [
267
- { flag: '--fix', description: 'Attempt to fix issues automatically' },
268
- { flag: '--verbose', description: 'Show detailed diagnostic information' },
269
- ],
270
- examples: ['nimbus doctor', 'nimbus doctor --fix', 'nimbus doctor --verbose'],
271
- },
272
-
273
- init: {
274
- name: 'init',
275
- description: 'Initialize a Nimbus workspace in the current directory',
276
- usage: 'nimbus init [options]',
277
- options: [
278
- { flag: '-n, --name <name>', description: 'Project name' },
279
- { flag: '--provider <provider>', description: 'Cloud provider' },
280
- { flag: '-o, --output <path>', description: 'Output directory' },
281
- { flag: '-f, --force', description: 'Overwrite existing configuration' },
282
- { flag: '--non-interactive', description: 'Run in non-interactive mode' },
283
- ],
284
- examples: ['nimbus init', 'nimbus init --name my-project --provider aws'],
285
- },
286
-
287
- login: {
288
- name: 'login',
289
- description: 'Set up authentication and configure LLM providers',
290
- usage: 'nimbus login [options]',
291
- options: [
292
- { flag: '--provider <name>', description: 'LLM provider: anthropic, openai, bedrock' },
293
- { flag: '--api-key <key>', description: 'API key for the provider' },
294
- { flag: '--model <model>', description: 'Default model to use' },
295
- { flag: '--skip-github', description: 'Skip GitHub authentication' },
296
- { flag: '--sso', description: 'Use SSO authentication' },
297
- { flag: '--non-interactive', description: 'Run in non-interactive mode' },
298
- ],
299
- examples: ['nimbus login', 'nimbus login --provider anthropic --api-key sk-...'],
300
- },
301
-
302
- logout: {
303
- name: 'logout',
304
- description: 'Clear all stored credentials',
305
- usage: 'nimbus logout [options]',
306
- options: [{ flag: '-f, --force', description: 'Skip confirmation prompt' }],
307
- examples: ['nimbus logout', 'nimbus logout --force'],
308
- },
309
-
310
- config: {
311
- name: 'config',
312
- description: 'Manage Nimbus configuration',
313
- usage: 'nimbus config <subcommand> [options]',
314
- subcommands: [
315
- { name: 'list', description: 'List all configuration values' },
316
- { name: 'get <key>', description: 'Get a specific configuration value' },
317
- { name: 'set <key> <value>', description: 'Set a configuration value' },
318
- { name: 'init', description: 'Initialize configuration interactively' },
319
- { name: 'reset', description: 'Reset configuration to defaults' },
320
- ],
321
- options: [
322
- { flag: 'default-model <model>', description: 'Default LLM model to use', default: 'anthropic/claude-sonnet-4-6' },
323
- { flag: 'default-mode <mode>', description: 'Default agent mode: plan | build | deploy', default: 'build' },
324
- { flag: 'theme <theme>', description: 'TUI color theme: default | dark | light', default: 'default' },
325
- { flag: 'auto-approve <bool>', description: 'Auto-approve all tool permissions (true/false)', default: 'false' },
326
- { flag: 'max-tokens <n>', description: 'Maximum output tokens per LLM response', default: '8192' },
327
- { flag: 'telemetry <bool>', description: 'Enable anonymous usage analytics (true/false)', default: 'true' },
328
- { flag: 'serve.port <port>', description: 'Default port for nimbus serve', default: '4200' },
329
- { flag: 'serve.auth <user:pass>', description: 'HTTP Basic Auth for nimbus serve (user:password)' },
330
- ],
331
- examples: [
332
- 'nimbus config list',
333
- 'nimbus config get default-model',
334
- 'nimbus config set default-model anthropic/claude-opus-4-6',
335
- 'nimbus config set auto-approve true',
336
- 'nimbus config set serve.port 8080',
337
- ],
338
- },
339
-
340
- tf: {
341
- name: 'tf',
342
- description: 'Terraform operations',
343
- usage: 'nimbus tf <subcommand> [options]',
344
- subcommands: [
345
- { name: 'init', description: 'Initialize Terraform working directory' },
346
- { name: 'plan', description: 'Generate execution plan' },
347
- { name: 'apply', description: 'Apply changes' },
348
- { name: 'validate', description: 'Validate configuration' },
349
- { name: 'destroy', description: 'Destroy infrastructure' },
350
- { name: 'show', description: 'Show state' },
351
- ],
352
- examples: ['nimbus tf init', 'nimbus tf plan', 'nimbus tf apply --auto-approve'],
353
- },
354
-
355
- k8s: {
356
- name: 'k8s',
357
- description: 'Kubernetes operations',
358
- usage: 'nimbus k8s <subcommand> [options]',
359
- subcommands: [
360
- { name: 'get <resource>', description: 'Get Kubernetes resources' },
361
- { name: 'apply <manifest>', description: 'Apply manifests' },
362
- { name: 'delete <resource> <name>', description: 'Delete resources' },
363
- { name: 'logs <pod>', description: 'Get pod logs' },
364
- { name: 'describe <resource> <name>', description: 'Describe resource' },
365
- { name: 'scale <resource> <name> <replicas>', description: 'Scale deployment' },
366
- ],
367
- examples: [
368
- 'nimbus k8s get pods',
369
- 'nimbus k8s apply ./deployment.yaml',
370
- 'nimbus k8s logs my-pod -f',
371
- ],
372
- },
373
-
374
- helm: {
375
- name: 'helm',
376
- description: 'Helm operations',
377
- usage: 'nimbus helm <subcommand> [options]',
378
- subcommands: [
379
- { name: 'list', description: 'List releases' },
380
- { name: 'install <name> <chart>', description: 'Install a chart' },
381
- { name: 'upgrade <name> <chart>', description: 'Upgrade a release' },
382
- { name: 'uninstall <name>', description: 'Uninstall a release' },
383
- { name: 'rollback <name> <rev>', description: 'Rollback to revision' },
384
- { name: 'history <name>', description: 'Show release history' },
385
- { name: 'search <keyword>', description: 'Search for charts' },
386
- { name: 'repo add <name> <url>', description: 'Add repository' },
387
- { name: 'repo update', description: 'Update repositories' },
388
- ],
389
- examples: [
390
- 'nimbus helm list',
391
- 'nimbus helm install nginx bitnami/nginx',
392
- 'nimbus helm upgrade nginx bitnami/nginx -f values.yaml',
393
- ],
394
- },
395
-
396
- history: {
397
- name: 'history',
398
- description: 'View command history',
399
- usage: 'nimbus history [options]',
400
- options: [
401
- { flag: '-n, --limit <count>', description: 'Number of entries to show' },
402
- { flag: '-f, --filter <term>', description: 'Filter entries by term' },
403
- { flag: '--since <date>', description: 'Show entries since date' },
404
- { flag: '--until <date>', description: 'Show entries until date' },
405
- { flag: '--status <status>', description: 'Filter by status: success, failure, pending' },
406
- { flag: '--json', description: 'Output as JSON' },
407
- { flag: '--clear', description: 'Clear all history' },
408
- ],
409
- subcommands: [{ name: 'show <id>', description: 'Show details for a specific entry' }],
410
- examples: ['nimbus history', 'nimbus history -n 20', 'nimbus history show abc123'],
411
- },
412
-
413
- version: {
414
- name: 'version',
415
- description: 'Display version information',
416
- usage: 'nimbus version [options]',
417
- options: [
418
- { flag: '--verbose', description: 'Show detailed version info including components' },
419
- { flag: '--json', description: 'Output as JSON' },
420
- ],
421
- examples: ['nimbus version', 'nimbus version --verbose'],
422
- },
423
-
424
- team: {
425
- name: 'team',
426
- description: 'Team management (Enterprise)',
427
- usage: 'nimbus team <subcommand> [options]',
428
- subcommands: [
429
- { name: 'create <name>', description: 'Create a new team' },
430
- { name: 'invite <email>', description: 'Invite a member' },
431
- { name: 'members', description: 'List team members' },
432
- { name: 'remove <email>', description: 'Remove a member' },
433
- { name: 'switch', description: 'Switch active team' },
434
- ],
435
- examples: [
436
- 'nimbus team create my-team',
437
- 'nimbus team invite user@example.com',
438
- 'nimbus team members',
439
- ],
440
- },
441
-
442
- drift: {
443
- name: 'drift',
444
- description: 'Detect infrastructure drift between desired state (IaC) and actual cloud state',
445
- usage: 'nimbus drift [options]',
446
- options: [
447
- { flag: '--provider <type>', description: 'IaC provider: terraform, kubernetes, helm', default: 'terraform' },
448
- { flag: '--workdir <path>', description: 'Working directory with IaC configs', default: '.' },
449
- ],
450
- examples: [
451
- 'nimbus drift',
452
- 'nimbus drift --provider kubernetes',
453
- 'nimbus run "check for infrastructure drift" --mode plan',
454
- ],
455
- },
456
-
457
- cost: {
458
- name: 'cost',
459
- description: 'Estimate infrastructure costs from Terraform plans or working directory',
460
- usage: 'nimbus cost [options]',
461
- options: [
462
- { flag: '--plan-file <file>', description: 'Path to a saved Terraform plan file' },
463
- { flag: '--workdir <path>', description: 'Working directory containing Terraform config', default: '.' },
464
- ],
465
- examples: [
466
- 'nimbus cost',
467
- 'nimbus cost --plan-file tfplan.json',
468
- 'nimbus run "estimate monthly cost for this infrastructure"',
469
- ],
470
- },
471
-
472
- 'auth-refresh': {
473
- name: 'auth-refresh',
474
- description: 'Re-validate and refresh cloud provider credentials (AWS SSO, GCP, Azure)',
475
- usage: 'nimbus auth-refresh [options]',
476
- options: [
477
- { flag: '--provider <name>', description: 'Provider to refresh: aws, gcp, azure, all', default: 'all' },
478
- ],
479
- examples: [
480
- 'nimbus auth-refresh',
481
- 'nimbus auth-refresh --provider aws',
482
- 'nimbus auth-refresh --provider gcp',
483
- ],
484
- },
485
-
486
- profile: {
487
- name: 'profile',
488
- description: 'Manage per-project credential profiles (AWS, kubectl, Terraform, GCP)',
489
- usage: 'nimbus profile <list|create|set|delete|show> [name]',
490
- subcommands: [
491
- { name: 'list', description: 'Show all profiles (current marked with *)' },
492
- { name: 'create <name>', description: 'Create a new profile (interactive wizard)' },
493
- { name: 'set <name>', description: 'Switch to a profile atomically (sets AWS_PROFILE, kubectl context, TF workspace)' },
494
- { name: 'delete <name>', description: 'Delete a profile' },
495
- { name: 'show [name]', description: 'Display profile details' },
496
- ],
497
- examples: [
498
- 'nimbus profile list',
499
- 'nimbus profile create prod',
500
- 'nimbus profile set prod',
501
- 'nimbus profile delete staging',
502
- ],
503
- },
504
-
505
- incident: {
506
- name: 'incident',
507
- description: 'Launch an incident response session pre-loaded with alert context (G14)',
508
- usage: 'nimbus incident <pagerduty-url-or-id|description> [--notes "observed behavior"]',
509
- options: [
510
- { flag: '--notes <text>', description: 'Observed behavior or additional context' },
511
- ],
512
- examples: [
513
- 'nimbus incident https://example.pagerduty.com/incidents/P1234',
514
- 'nimbus incident "high CPU on api-service pods" --notes "started after deploy at 14:00"',
515
- 'nimbus incident PABC123',
516
- ],
517
- },
518
-
519
- runbook: {
520
- name: 'runbook',
521
- description: 'Load and execute operational runbooks as agent prompts (G15)',
522
- usage: 'nimbus runbook <list|run|create> [name]',
523
- subcommands: [
524
- { name: 'list', description: 'List available runbooks' },
525
- { name: 'run <name>', description: 'Execute a runbook as an agent session' },
526
- { name: 'create <name>', description: 'Create a new runbook interactively' },
527
- ],
528
- examples: [
529
- 'nimbus runbook list',
530
- 'nimbus runbook run rotate-certs',
531
- 'nimbus runbook run cert-rotation --auto',
532
- 'nimbus runbook create db-backup',
533
- ],
534
- },
535
-
536
- schedule: {
537
- name: 'schedule',
538
- description: 'Manage periodic DevOps automation tasks (G13)',
539
- usage: 'nimbus schedule <list|add|remove|run-now>',
540
- subcommands: [
541
- { name: 'list', description: 'List configured schedules with next-run times' },
542
- { name: 'add "<cron>" "<prompt>"', description: 'Add a new periodic task' },
543
- { name: 'remove <id-or-name>', description: 'Remove a schedule' },
544
- { name: 'run-now <id-or-name>', description: 'Execute a schedule immediately' },
545
- ],
546
- examples: [
547
- 'nimbus schedule list',
548
- 'nimbus schedule add "0 8 * * *" "check for infrastructure drift" --name daily-drift',
549
- 'nimbus schedule add "0 9 * * 1" "generate weekly cost report"',
550
- 'nimbus schedule run-now daily-drift',
551
- 'nimbus schedule remove daily-drift',
552
- ],
553
- },
554
-
555
- export: {
556
- name: 'export',
557
- description: 'Export session conversation to markdown, HTML, or JSON (G19)',
558
- usage: 'nimbus export [session-id] [--format md|html|json] [--output file]',
559
- options: [
560
- { flag: '--format <fmt>', description: 'Output format: md, html, json', default: 'md' },
561
- { flag: '--output <file>', description: 'Save to file instead of stdout' },
562
- ],
563
- examples: [
564
- 'nimbus export',
565
- 'nimbus export abc123 --format html --output session.html',
566
- 'nimbus export --format json > session.json',
567
- ],
568
- },
569
- };
570
-
571
- /**
572
- * Show help for a specific command
573
- */
574
- function showCommandHelp(commandName: string): void {
575
- // Normalize command name (handle aliases like "generate k8s" -> "generate-k8s")
576
- const normalizedName = commandName.replace(/^generate /, 'generate-');
577
-
578
- const doc = COMMANDS[normalizedName] || COMMANDS[commandName];
579
-
580
- if (!doc) {
581
- ui.error(`Unknown command: ${commandName}`);
582
- ui.newLine();
583
- ui.info('Run "nimbus help" to see available commands');
584
- return;
585
- }
586
-
587
- ui.header(`nimbus ${doc.name}`);
588
- ui.print(doc.description);
589
- ui.newLine();
590
-
591
- ui.print('Usage:');
592
- ui.print(` ${doc.usage}`);
593
- ui.newLine();
594
-
595
- if (doc.subcommands?.length) {
596
- ui.print('Subcommands:');
597
- for (const sub of doc.subcommands) {
598
- ui.print(` ${sub.name.padEnd(28)} ${sub.description}`);
599
- }
600
- ui.newLine();
601
- }
602
-
603
- if (doc.options?.length) {
604
- ui.print('Options:');
605
- for (const opt of doc.options) {
606
- const flagStr = opt.flag.padEnd(30);
607
- const defaultStr = opt.default ? ` (default: ${opt.default})` : '';
608
- ui.print(` ${flagStr} ${opt.description}${defaultStr}`);
609
- }
610
- ui.newLine();
611
- }
612
-
613
- if (doc.examples?.length) {
614
- ui.print('Examples:');
615
- for (const ex of doc.examples) {
616
- ui.print(` ${ex}`);
617
- }
618
- }
619
- }
620
-
621
- /**
622
- * Show general help
623
- */
624
- function showGeneralHelp(): void {
625
- ui.header('Nimbus — AI-Powered DevOps Terminal');
626
- ui.print('Plan, apply, and manage Terraform, Kubernetes, Helm, AWS, GCP, Azure with natural language.');
627
- ui.print('Type a DevOps request directly or use any command below.');
628
- ui.newLine();
629
-
630
- ui.print('Usage:');
631
- ui.print(' nimbus <command> [options]');
632
- ui.print(' nimbus Open interactive DevOps agent TUI');
633
- ui.print(' nimbus run "<prompt>" Run agent non-interactively');
634
- ui.newLine();
635
-
636
- ui.print('DevOps Operations:');
637
- ui.print(' plan Preview infrastructure changes (tf/k8s/helm)');
638
- ui.print(' apply Apply infrastructure changes');
639
- ui.print(' tf <cmd> Terraform init/plan/apply/validate/destroy');
640
- ui.print(' k8s <cmd> Kubernetes get/apply/delete/logs/scale');
641
- ui.print(' helm <cmd> Helm install/upgrade/rollback/list');
642
- ui.print(' drift Detect infrastructure drift (IaC vs actual)');
643
- ui.print(' cost Estimate infrastructure costs');
644
- ui.print(' status Live infra health dashboard (TF + K8s + Helm)');
645
- ui.newLine();
646
-
647
- ui.print('Incident & Automation:');
648
- ui.print(' incident Incident response session with alert pre-loading');
649
- ui.print(' runbook Load and execute operational runbooks');
650
- ui.print(' schedule Manage periodic DevOps automation tasks');
651
- ui.print(' rollout Safe rolling deployment management');
652
- ui.newLine();
653
-
654
- ui.print('Infrastructure Generation:');
655
- ui.print(' generate terraform Generate Terraform from live AWS infrastructure');
656
- ui.print(' generate k8s Generate Kubernetes manifests for your app');
657
- ui.print(' generate helm Generate Helm values files');
658
- ui.newLine();
659
-
660
- ui.print('Cloud Auth & Profiles:');
661
- ui.print(' auth-refresh Refresh AWS SSO, GCP, Azure credentials');
662
- ui.print(' profile Manage per-project profiles (AWS, kubectl, TF, GCP)');
663
- ui.print(' login Set up LLM provider authentication');
664
- ui.print(' logout Clear stored credentials');
665
- ui.newLine();
666
-
667
- ui.print('AI Agent:');
668
- ui.print(' chat Interactive DevOps agent TUI (same as nimbus)');
669
- ui.print(' run Run agent non-interactively with a prompt');
670
- ui.newLine();
671
-
672
- ui.print('Setup & Config:');
673
- ui.print(' init Initialize Nimbus workspace (generates NIMBUS.md)');
674
- ui.print(' config Manage global configuration');
675
- ui.print(' doctor Run diagnostic checks on your installation');
676
- ui.print(' history View command history');
677
- ui.print(' export Export session to markdown/HTML/JSON');
678
- ui.print(' version Show version info');
679
- ui.print(' audit View audit logs');
680
- ui.newLine();
681
-
682
- ui.print('Slash Commands (in TUI):');
683
- ui.print(' /plan Run infrastructure plan');
684
- ui.print(' /apply Apply infrastructure changes (deploy mode)');
685
- ui.print(' /k8s-ctx Switch Kubernetes context');
686
- ui.print(' /tf-ws Switch Terraform workspace');
687
- ui.print(' /mode Switch agent mode (plan/build/deploy)');
688
- ui.print(' /model Switch LLM model');
689
- ui.print(' /cost Show session cost');
690
- ui.print(' /diff Show file diff modal');
691
- ui.print(' /tree Toggle file tree sidebar');
692
- ui.print(' /terminal Toggle terminal output pane');
693
- ui.print(' ? Open keyboard shortcuts help');
694
- ui.newLine();
695
-
696
- ui.print('Get detailed help for a command:');
697
- ui.print(' nimbus help <command>');
698
- ui.print(' nimbus <command> --help');
699
- }
700
-
701
- /**
702
- * Run the help command
703
- */
704
- export async function helpCommand(options: HelpOptions = {}): Promise<void> {
705
- logger.debug('Running help command', { options });
706
-
707
- if (options.command) {
708
- showCommandHelp(options.command);
709
- } else {
710
- showGeneralHelp();
711
- }
712
- }
713
-
714
- // Export as default command
715
- export default helpCommand;