@build-astron-co/nimbus 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (469) hide show
  1. package/bin/nimbus +26 -10
  2. package/bin/nimbus.cmd +41 -0
  3. package/bin/nimbus.mjs +70 -0
  4. package/completions/nimbus.bash +38 -0
  5. package/completions/nimbus.fish +48 -0
  6. package/completions/nimbus.zsh +81 -0
  7. package/dist/src/agent/compaction-agent.js +215 -0
  8. package/dist/src/agent/context-manager.js +385 -0
  9. package/dist/src/agent/context.js +322 -0
  10. package/dist/src/agent/deploy-preview.js +395 -0
  11. package/dist/src/agent/expand-files.js +95 -0
  12. package/dist/src/agent/index.js +18 -0
  13. package/dist/src/agent/loop.js +1535 -0
  14. package/dist/src/agent/modes.js +347 -0
  15. package/dist/src/agent/permissions.js +396 -0
  16. package/dist/src/agent/subagents/base.js +67 -0
  17. package/dist/src/agent/subagents/cost.js +45 -0
  18. package/dist/src/agent/subagents/explore.js +36 -0
  19. package/dist/src/agent/subagents/general.js +41 -0
  20. package/dist/src/agent/subagents/index.js +88 -0
  21. package/dist/src/agent/subagents/infra.js +52 -0
  22. package/dist/src/agent/subagents/security.js +60 -0
  23. package/dist/src/agent/system-prompt.js +860 -0
  24. package/dist/src/app.js +152 -0
  25. package/dist/src/audit/activity-log.js +209 -0
  26. package/dist/src/audit/compliance-checker.js +419 -0
  27. package/dist/src/audit/cost-tracker.js +231 -0
  28. package/dist/src/audit/index.js +10 -0
  29. package/dist/src/audit/security-scanner.js +490 -0
  30. package/dist/src/auth/guard.js +64 -0
  31. package/dist/src/auth/index.js +19 -0
  32. package/dist/src/auth/keychain.js +79 -0
  33. package/dist/src/auth/oauth.js +389 -0
  34. package/dist/src/auth/providers.js +415 -0
  35. package/dist/src/auth/sso.js +87 -0
  36. package/dist/src/auth/store.js +424 -0
  37. package/dist/src/auth/types.js +5 -0
  38. package/dist/src/cli/index.js +8 -0
  39. package/dist/src/cli/init.js +1048 -0
  40. package/dist/src/cli/openapi-spec.js +346 -0
  41. package/dist/src/cli/run.js +505 -0
  42. package/dist/src/cli/serve-auth.js +56 -0
  43. package/dist/src/cli/serve.js +432 -0
  44. package/dist/src/cli/web.js +50 -0
  45. package/dist/src/cli.js +1574 -0
  46. package/dist/src/clients/core-engine-client.js +156 -0
  47. package/dist/src/clients/enterprise-client.js +246 -0
  48. package/dist/src/clients/generator-client.js +219 -0
  49. package/dist/src/clients/git-client.js +367 -0
  50. package/dist/src/clients/github-client.js +229 -0
  51. package/dist/src/clients/helm-client.js +299 -0
  52. package/dist/src/clients/index.js +18 -0
  53. package/dist/src/clients/k8s-client.js +270 -0
  54. package/dist/src/clients/llm-client.js +119 -0
  55. package/dist/src/clients/rest-client.js +104 -0
  56. package/dist/src/clients/service-discovery.js +35 -0
  57. package/dist/src/clients/terraform-client.js +302 -0
  58. package/dist/src/clients/tools-client.js +1227 -0
  59. package/dist/src/clients/ws-client.js +93 -0
  60. package/dist/src/commands/alias.js +91 -0
  61. package/dist/src/commands/analyze/index.js +313 -0
  62. package/dist/src/commands/apply/helm.js +375 -0
  63. package/dist/src/commands/apply/index.js +176 -0
  64. package/dist/src/commands/apply/k8s.js +350 -0
  65. package/dist/src/commands/apply/terraform.js +465 -0
  66. package/dist/src/commands/ask.js +137 -0
  67. package/dist/src/commands/audit/index.js +322 -0
  68. package/dist/src/commands/auth-cloud.js +345 -0
  69. package/dist/src/commands/auth-list.js +112 -0
  70. package/dist/src/commands/auth-profile.js +104 -0
  71. package/dist/src/commands/auth-refresh.js +161 -0
  72. package/dist/src/commands/auth-status.js +122 -0
  73. package/dist/src/commands/aws/ec2.js +402 -0
  74. package/dist/src/commands/aws/iam.js +304 -0
  75. package/dist/src/commands/aws/index.js +108 -0
  76. package/dist/src/commands/aws/lambda.js +317 -0
  77. package/dist/src/commands/aws/rds.js +345 -0
  78. package/dist/src/commands/aws/s3.js +346 -0
  79. package/dist/src/commands/aws/vpc.js +302 -0
  80. package/dist/src/commands/aws-discover.js +413 -0
  81. package/dist/src/commands/aws-terraform.js +618 -0
  82. package/dist/src/commands/azure/aks.js +305 -0
  83. package/dist/src/commands/azure/functions.js +200 -0
  84. package/dist/src/commands/azure/index.js +93 -0
  85. package/dist/src/commands/azure/storage.js +378 -0
  86. package/dist/src/commands/azure/vm.js +291 -0
  87. package/dist/src/commands/billing/index.js +224 -0
  88. package/dist/src/commands/chat.js +259 -0
  89. package/dist/src/commands/completions.js +255 -0
  90. package/dist/src/commands/config.js +291 -0
  91. package/dist/src/commands/cost/cloud-cost-estimator.js +211 -0
  92. package/dist/src/commands/cost/estimator.js +73 -0
  93. package/dist/src/commands/cost/index.js +625 -0
  94. package/dist/src/commands/cost/parsers/terraform.js +234 -0
  95. package/dist/src/commands/cost/parsers/types.js +4 -0
  96. package/dist/src/commands/cost/pricing/aws.js +501 -0
  97. package/dist/src/commands/cost/pricing/azure.js +462 -0
  98. package/dist/src/commands/cost/pricing/gcp.js +359 -0
  99. package/dist/src/commands/cost/pricing/index.js +24 -0
  100. package/dist/src/commands/demo.js +196 -0
  101. package/dist/src/commands/deploy.js +215 -0
  102. package/dist/src/commands/doctor.js +1291 -0
  103. package/dist/src/commands/drift/index.js +674 -0
  104. package/dist/src/commands/explain.js +235 -0
  105. package/dist/src/commands/export.js +120 -0
  106. package/dist/src/commands/feedback.js +319 -0
  107. package/dist/src/commands/fix.js +263 -0
  108. package/dist/src/commands/fs/index.js +338 -0
  109. package/dist/src/commands/gcp/compute.js +266 -0
  110. package/dist/src/commands/gcp/functions.js +221 -0
  111. package/dist/src/commands/gcp/gke.js +357 -0
  112. package/dist/src/commands/gcp/iam.js +295 -0
  113. package/dist/src/commands/gcp/index.js +105 -0
  114. package/dist/src/commands/gcp/storage.js +232 -0
  115. package/dist/src/commands/generate-helm.js +1026 -0
  116. package/dist/src/commands/generate-k8s.js +1263 -0
  117. package/dist/src/commands/generate-terraform.js +1058 -0
  118. package/dist/src/commands/gh/index.js +663 -0
  119. package/dist/src/commands/git/index.js +1208 -0
  120. package/dist/src/commands/helm/index.js +985 -0
  121. package/dist/src/commands/help.js +639 -0
  122. package/dist/src/commands/history.js +120 -0
  123. package/dist/src/commands/import.js +782 -0
  124. package/dist/src/commands/incident.js +144 -0
  125. package/dist/src/commands/index.js +109 -0
  126. package/dist/src/commands/init.js +955 -0
  127. package/dist/src/commands/k8s/index.js +979 -0
  128. package/dist/src/commands/login.js +588 -0
  129. package/dist/src/commands/logout.js +61 -0
  130. package/dist/src/commands/logs.js +160 -0
  131. package/dist/src/commands/onboarding.js +382 -0
  132. package/dist/src/commands/pipeline.js +153 -0
  133. package/dist/src/commands/plan/display.js +216 -0
  134. package/dist/src/commands/plan/index.js +525 -0
  135. package/dist/src/commands/plugin.js +325 -0
  136. package/dist/src/commands/preview.js +356 -0
  137. package/dist/src/commands/profile.js +297 -0
  138. package/dist/src/commands/questionnaire.js +1021 -0
  139. package/dist/src/commands/resume.js +35 -0
  140. package/dist/src/commands/rollback.js +259 -0
  141. package/dist/src/commands/rollout.js +74 -0
  142. package/dist/src/commands/runbook.js +307 -0
  143. package/dist/src/commands/schedule.js +202 -0
  144. package/dist/src/commands/status.js +213 -0
  145. package/dist/src/commands/team/index.js +309 -0
  146. package/dist/src/commands/team-context.js +200 -0
  147. package/dist/src/commands/template.js +204 -0
  148. package/dist/src/commands/tf/index.js +989 -0
  149. package/dist/src/commands/upgrade.js +515 -0
  150. package/dist/src/commands/usage/index.js +118 -0
  151. package/dist/src/commands/version.js +145 -0
  152. package/dist/src/commands/watch.js +127 -0
  153. package/dist/src/compat/index.js +2 -0
  154. package/dist/src/compat/runtime.js +10 -0
  155. package/dist/src/compat/sqlite.js +144 -0
  156. package/dist/src/config/index.js +6 -0
  157. package/dist/src/config/manager.js +469 -0
  158. package/dist/src/config/mode-store.js +57 -0
  159. package/dist/src/config/profiles.js +66 -0
  160. package/dist/src/config/safety-policy.js +251 -0
  161. package/dist/src/config/schema.js +107 -0
  162. package/dist/src/config/types.js +311 -0
  163. package/dist/src/config/workspace-state.js +38 -0
  164. package/dist/src/context/context-db.js +138 -0
  165. package/dist/src/demo/index.js +295 -0
  166. package/dist/src/demo/scenarios/full-journey.js +226 -0
  167. package/dist/src/demo/scenarios/getting-started.js +124 -0
  168. package/dist/src/demo/scenarios/helm-release.js +334 -0
  169. package/dist/src/demo/scenarios/k8s-deployment.js +190 -0
  170. package/dist/src/demo/scenarios/terraform-vpc.js +167 -0
  171. package/dist/src/demo/types.js +6 -0
  172. package/dist/src/engine/cost-estimator.js +334 -0
  173. package/dist/src/engine/diagram-generator.js +192 -0
  174. package/dist/src/engine/drift-detector.js +688 -0
  175. package/dist/src/engine/executor.js +832 -0
  176. package/dist/src/engine/index.js +39 -0
  177. package/dist/src/engine/orchestrator.js +436 -0
  178. package/dist/src/engine/planner.js +616 -0
  179. package/dist/src/engine/safety.js +609 -0
  180. package/dist/src/engine/verifier.js +664 -0
  181. package/dist/src/enterprise/audit.js +241 -0
  182. package/dist/src/enterprise/auth.js +189 -0
  183. package/dist/src/enterprise/billing.js +512 -0
  184. package/dist/src/enterprise/index.js +16 -0
  185. package/dist/src/enterprise/teams.js +315 -0
  186. package/dist/src/generator/best-practices.js +1375 -0
  187. package/dist/src/generator/helm.js +495 -0
  188. package/dist/src/generator/index.js +11 -0
  189. package/dist/src/generator/intent-parser.js +420 -0
  190. package/dist/src/generator/kubernetes.js +773 -0
  191. package/dist/src/generator/terraform.js +1472 -0
  192. package/dist/src/history/index.js +6 -0
  193. package/dist/src/history/manager.js +199 -0
  194. package/dist/src/history/types.js +6 -0
  195. package/dist/src/hooks/config.js +318 -0
  196. package/dist/src/hooks/engine.js +317 -0
  197. package/dist/src/hooks/index.js +2 -0
  198. package/dist/src/llm/auth-bridge.js +157 -0
  199. package/dist/src/llm/circuit-breaker.js +116 -0
  200. package/dist/src/llm/config-loader.js +172 -0
  201. package/dist/src/llm/cost-calculator.js +137 -0
  202. package/dist/src/llm/index.js +7 -0
  203. package/dist/src/llm/model-aliases.js +99 -0
  204. package/dist/src/llm/provider-registry.js +57 -0
  205. package/dist/src/llm/providers/anthropic.js +430 -0
  206. package/dist/src/llm/providers/bedrock.js +409 -0
  207. package/dist/src/llm/providers/google.js +344 -0
  208. package/dist/src/llm/providers/ollama.js +661 -0
  209. package/dist/src/llm/providers/openai-compatible.js +289 -0
  210. package/dist/src/llm/providers/openai.js +284 -0
  211. package/dist/src/llm/providers/openrouter.js +293 -0
  212. package/dist/src/llm/router.js +844 -0
  213. package/dist/src/llm/types.js +69 -0
  214. package/dist/src/lsp/client.js +239 -0
  215. package/dist/src/lsp/languages.js +95 -0
  216. package/dist/src/lsp/manager.js +243 -0
  217. package/dist/src/mcp/client.js +289 -0
  218. package/dist/src/mcp/index.js +5 -0
  219. package/dist/src/mcp/manager.js +113 -0
  220. package/dist/src/nimbus.js +212 -0
  221. package/dist/src/plugins/index.js +13 -0
  222. package/dist/src/plugins/loader.js +280 -0
  223. package/dist/src/plugins/manager.js +282 -0
  224. package/dist/src/plugins/types.js +23 -0
  225. package/dist/src/scanners/cicd-scanner.js +230 -0
  226. package/dist/src/scanners/cloud-scanner.js +415 -0
  227. package/dist/src/scanners/framework-scanner.js +430 -0
  228. package/dist/src/scanners/iac-scanner.js +350 -0
  229. package/dist/src/scanners/index.js +454 -0
  230. package/dist/src/scanners/language-scanner.js +258 -0
  231. package/dist/src/scanners/package-manager-scanner.js +252 -0
  232. package/dist/src/scanners/types.js +6 -0
  233. package/dist/src/sessions/manager.js +395 -0
  234. package/dist/src/sessions/types.js +4 -0
  235. package/dist/src/sharing/sync.js +238 -0
  236. package/dist/src/sharing/viewer.js +131 -0
  237. package/dist/src/snapshots/index.js +1 -0
  238. package/dist/src/snapshots/manager.js +432 -0
  239. package/dist/src/state/artifacts.js +94 -0
  240. package/dist/src/state/audit.js +73 -0
  241. package/dist/src/state/billing.js +126 -0
  242. package/dist/src/state/checkpoints.js +81 -0
  243. package/dist/src/state/config.js +58 -0
  244. package/dist/src/state/conversations.js +7 -0
  245. package/dist/src/state/credentials.js +96 -0
  246. package/dist/src/state/db.js +53 -0
  247. package/dist/src/state/index.js +23 -0
  248. package/dist/src/state/messages.js +76 -0
  249. package/dist/src/state/projects.js +92 -0
  250. package/dist/src/state/schema.js +233 -0
  251. package/dist/src/state/sessions.js +79 -0
  252. package/dist/src/state/teams.js +131 -0
  253. package/dist/src/telemetry.js +91 -0
  254. package/dist/src/tools/aws-ops.js +747 -0
  255. package/dist/src/tools/azure-ops.js +491 -0
  256. package/dist/src/tools/file-ops.js +451 -0
  257. package/dist/src/tools/gcp-ops.js +559 -0
  258. package/dist/src/tools/git-ops.js +557 -0
  259. package/dist/src/tools/github-ops.js +460 -0
  260. package/dist/src/tools/helm-ops.js +634 -0
  261. package/dist/src/tools/index.js +16 -0
  262. package/dist/src/tools/k8s-ops.js +579 -0
  263. package/dist/src/tools/schemas/converter.js +129 -0
  264. package/dist/src/tools/schemas/devops.js +3319 -0
  265. package/dist/src/tools/schemas/index.js +19 -0
  266. package/dist/src/tools/schemas/standard.js +966 -0
  267. package/dist/src/tools/schemas/types.js +409 -0
  268. package/dist/src/tools/spawn-exec.js +109 -0
  269. package/dist/src/tools/terraform-ops.js +627 -0
  270. package/dist/src/types/config.js +1 -0
  271. package/dist/src/types/drift.js +4 -0
  272. package/dist/src/types/enterprise.js +5 -0
  273. package/dist/src/types/index.js +14 -0
  274. package/dist/src/types/plan.js +1 -0
  275. package/dist/src/types/request.js +1 -0
  276. package/dist/src/types/response.js +1 -0
  277. package/dist/src/types/service.js +1 -0
  278. package/dist/src/ui/App.js +1672 -0
  279. package/dist/src/ui/DeployPreview.js +60 -0
  280. package/dist/src/ui/FileDiffModal.js +108 -0
  281. package/dist/src/ui/Header.js +46 -0
  282. package/dist/src/ui/HelpModal.js +9 -0
  283. package/dist/src/ui/InputBox.js +408 -0
  284. package/dist/src/ui/MessageList.js +795 -0
  285. package/dist/src/ui/PermissionPrompt.js +72 -0
  286. package/dist/src/ui/StatusBar.js +109 -0
  287. package/dist/src/ui/TerminalPane.js +31 -0
  288. package/dist/src/ui/ToolCallDisplay.js +303 -0
  289. package/dist/src/ui/TreePane.js +83 -0
  290. package/dist/src/ui/chat-ui.js +721 -0
  291. package/dist/src/ui/index.js +11 -0
  292. package/dist/src/ui/ink/index.js +1325 -0
  293. package/dist/src/ui/streaming.js +137 -0
  294. package/dist/src/ui/theme.js +78 -0
  295. package/dist/src/ui/types.js +7 -0
  296. package/dist/src/utils/analytics.js +61 -0
  297. package/dist/src/utils/cost-warning.js +25 -0
  298. package/dist/src/utils/env.js +42 -0
  299. package/dist/src/utils/errors.js +54 -0
  300. package/dist/src/utils/event-bus.js +22 -0
  301. package/dist/src/utils/index.js +16 -0
  302. package/dist/src/utils/logger.js +150 -0
  303. package/dist/src/utils/rate-limiter.js +90 -0
  304. package/dist/src/utils/service-auth.js +36 -0
  305. package/dist/src/utils/validation.js +39 -0
  306. package/dist/src/version.js +3 -0
  307. package/dist/src/watcher/index.js +192 -0
  308. package/dist/src/wizard/approval.js +275 -0
  309. package/dist/src/wizard/index.js +13 -0
  310. package/dist/src/wizard/prompts.js +273 -0
  311. package/dist/src/wizard/types.js +4 -0
  312. package/dist/src/wizard/ui.js +453 -0
  313. package/dist/src/wizard/wizard.js +227 -0
  314. package/package.json +31 -23
  315. package/src/__tests__/alias.test.ts +133 -0
  316. package/src/__tests__/app.test.ts +1 -1
  317. package/src/__tests__/audit.test.ts +1 -1
  318. package/src/__tests__/circuit-breaker.test.ts +1 -1
  319. package/src/__tests__/cli-run.test.ts +237 -1
  320. package/src/__tests__/compat-sqlite.test.ts +68 -0
  321. package/src/__tests__/context-manager.test.ts +131 -1
  322. package/src/__tests__/context.test.ts +1 -1
  323. package/src/__tests__/devops-terminal-gaps.test.ts +718 -0
  324. package/src/__tests__/doctor.test.ts +48 -0
  325. package/src/__tests__/enterprise.test.ts +1 -1
  326. package/src/__tests__/export.test.ts +236 -0
  327. package/src/__tests__/gap-11-18-20.test.ts +958 -0
  328. package/src/__tests__/generator.test.ts +1 -1
  329. package/src/__tests__/helm-streaming.test.ts +127 -0
  330. package/src/__tests__/hooks.test.ts +1 -1
  331. package/src/__tests__/incident.test.ts +179 -0
  332. package/src/__tests__/init.test.ts +55 -4
  333. package/src/__tests__/intent-parser.test.ts +1 -1
  334. package/src/__tests__/llm-router.test.ts +1 -1
  335. package/src/__tests__/logs.test.ts +107 -0
  336. package/src/__tests__/loop-errors.test.ts +244 -0
  337. package/src/__tests__/lsp.test.ts +1 -1
  338. package/src/__tests__/modes.test.ts +1 -1
  339. package/src/__tests__/perf-optimizations.test.ts +847 -0
  340. package/src/__tests__/permissions.test.ts +1 -1
  341. package/src/__tests__/pipeline.test.ts +50 -0
  342. package/src/__tests__/polish-phase3.test.ts +340 -0
  343. package/src/__tests__/profile.test.ts +237 -0
  344. package/src/__tests__/rollback.test.ts +83 -0
  345. package/src/__tests__/runbook.test.ts +219 -0
  346. package/src/__tests__/schedule.test.ts +206 -0
  347. package/src/__tests__/serve.test.ts +1 -1
  348. package/src/__tests__/sessions.test.ts +96 -1
  349. package/src/__tests__/sharing.test.ts +53 -1
  350. package/src/__tests__/snapshots.test.ts +1 -1
  351. package/src/__tests__/standalone-migration.test.ts +199 -0
  352. package/src/__tests__/state-db.test.ts +1 -1
  353. package/src/__tests__/status.test.ts +158 -0
  354. package/src/__tests__/stream-with-tools.test.ts +71 -25
  355. package/src/__tests__/subagents.test.ts +1 -1
  356. package/src/__tests__/system-prompt.test.ts +82 -3
  357. package/src/__tests__/terminal-gap-v2.test.ts +395 -0
  358. package/src/__tests__/terminal-parity.test.ts +393 -0
  359. package/src/__tests__/tf-apply.test.ts +187 -0
  360. package/src/__tests__/tool-converter.test.ts +1 -1
  361. package/src/__tests__/tool-schemas.test.ts +209 -4
  362. package/src/__tests__/tools.test.ts +4 -3
  363. package/src/__tests__/version-json.test.ts +184 -0
  364. package/src/__tests__/version.test.ts +1 -1
  365. package/src/__tests__/watch.test.ts +129 -0
  366. package/src/agent/compaction-agent.ts +40 -1
  367. package/src/agent/context-manager.ts +67 -3
  368. package/src/agent/deploy-preview.ts +62 -1
  369. package/src/agent/expand-files.ts +108 -0
  370. package/src/agent/loop.ts +1312 -31
  371. package/src/agent/permissions.ts +51 -4
  372. package/src/agent/system-prompt.ts +573 -19
  373. package/src/app.ts +58 -0
  374. package/src/audit/security-scanner.ts +45 -0
  375. package/src/auth/keychain.ts +82 -0
  376. package/src/auth/oauth.ts +15 -5
  377. package/src/cli/init.ts +378 -5
  378. package/src/cli/run.ts +407 -16
  379. package/src/cli/serve.ts +78 -1
  380. package/src/cli/web.ts +10 -6
  381. package/src/cli.ts +312 -1
  382. package/src/clients/service-discovery.ts +30 -25
  383. package/src/commands/alias.ts +100 -0
  384. package/src/commands/audit/index.ts +121 -2
  385. package/src/commands/auth-cloud.ts +113 -0
  386. package/src/commands/auth-refresh.ts +187 -0
  387. package/src/commands/aws-discover.ts +144 -251
  388. package/src/commands/aws-terraform.ts +68 -118
  389. package/src/commands/chat.ts +9 -3
  390. package/src/commands/completions.ts +268 -0
  391. package/src/commands/config.ts +26 -0
  392. package/src/commands/cost/index.ts +218 -2
  393. package/src/commands/deploy.ts +260 -0
  394. package/src/commands/doctor.ts +744 -152
  395. package/src/commands/drift/index.ts +371 -23
  396. package/src/commands/export.ts +146 -0
  397. package/src/commands/generate-k8s.ts +9 -61
  398. package/src/commands/generate-terraform.ts +191 -449
  399. package/src/commands/help.ts +212 -36
  400. package/src/commands/history.ts +8 -1
  401. package/src/commands/incident.ts +166 -0
  402. package/src/commands/init.ts +5 -0
  403. package/src/commands/login.ts +86 -1
  404. package/src/commands/logs.ts +167 -0
  405. package/src/commands/onboarding.ts +211 -34
  406. package/src/commands/pipeline.ts +186 -0
  407. package/src/commands/plugin.ts +398 -0
  408. package/src/commands/profile.ts +342 -0
  409. package/src/commands/questionnaire.ts +0 -98
  410. package/src/commands/resume.ts +26 -34
  411. package/src/commands/rollback.ts +315 -0
  412. package/src/commands/rollout.ts +88 -0
  413. package/src/commands/runbook.ts +346 -0
  414. package/src/commands/schedule.ts +236 -0
  415. package/src/commands/status.ts +252 -0
  416. package/src/commands/team-context.ts +220 -0
  417. package/src/commands/template.ts +58 -57
  418. package/src/commands/tf/index.ts +70 -11
  419. package/src/commands/upgrade.ts +57 -0
  420. package/src/commands/version.ts +54 -50
  421. package/src/commands/watch.ts +153 -0
  422. package/src/compat/runtime.ts +1 -1
  423. package/src/compat/sqlite.ts +75 -5
  424. package/src/config/mode-store.ts +62 -0
  425. package/src/config/profiles.ts +84 -0
  426. package/src/config/types.ts +83 -1
  427. package/src/config/workspace-state.ts +53 -0
  428. package/src/engine/cost-estimator.ts +52 -10
  429. package/src/engine/executor.ts +33 -2
  430. package/src/engine/planner.ts +68 -1
  431. package/src/generator/terraform.ts +8 -0
  432. package/src/history/manager.ts +2 -74
  433. package/src/hooks/engine.ts +5 -4
  434. package/src/llm/cost-calculator.ts +2 -2
  435. package/src/llm/providers/anthropic.ts +50 -21
  436. package/src/llm/router.ts +76 -7
  437. package/src/lsp/languages.ts +3 -0
  438. package/src/lsp/manager.ts +21 -5
  439. package/src/nimbus.ts +37 -18
  440. package/src/sessions/manager.ts +108 -1
  441. package/src/sharing/sync.ts +4 -0
  442. package/src/sharing/viewer.ts +66 -0
  443. package/src/tools/file-ops.ts +22 -0
  444. package/src/tools/schemas/devops.ts +3007 -117
  445. package/src/tools/schemas/standard.ts +5 -1
  446. package/src/tools/schemas/types.ts +31 -1
  447. package/src/tools/spawn-exec.ts +148 -0
  448. package/src/ui/App.tsx +1183 -66
  449. package/src/ui/DeployPreview.tsx +62 -57
  450. package/src/ui/FileDiffModal.tsx +162 -0
  451. package/src/ui/Header.tsx +87 -24
  452. package/src/ui/HelpModal.tsx +57 -0
  453. package/src/ui/InputBox.tsx +163 -10
  454. package/src/ui/MessageList.tsx +487 -40
  455. package/src/ui/PermissionPrompt.tsx +17 -5
  456. package/src/ui/StatusBar.tsx +122 -3
  457. package/src/ui/TerminalPane.tsx +84 -0
  458. package/src/ui/ToolCallDisplay.tsx +252 -18
  459. package/src/ui/TreePane.tsx +132 -0
  460. package/src/ui/chat-ui.ts +41 -44
  461. package/src/ui/ink/index.ts +771 -38
  462. package/src/ui/streaming.ts +1 -1
  463. package/src/ui/theme.ts +104 -0
  464. package/src/ui/types.ts +18 -0
  465. package/src/version.ts +1 -1
  466. package/src/watcher/index.ts +66 -15
  467. package/src/wizard/types.ts +1 -0
  468. package/src/wizard/ui.ts +1 -1
  469. package/tsconfig.json +2 -2
package/dist/src/sharing/viewer.js ADDED
@@ -0,0 +1,131 @@
1
+ /**
2
+ * Minimal HTML viewer for shared sessions.
3
+ *
4
+ * Generates a standalone HTML page that can be served by nimbus serve
5
+ * for viewing shared sessions when the Web UI is not available.
6
+ */
7
+ /**
8
+ * Generate a standalone HTML page for viewing a shared session.
9
+ */
10
+ export function generateShareViewer(shared) {
11
+ const messagesHtml = shared.messages
12
+ .filter(m => m.role === 'user' || m.role === 'assistant')
13
+ .map(m => {
14
+ const isUser = m.role === 'user';
15
+ const bgColor = isUser ? '#3b82f6' : '#1e293b';
16
+ const align = isUser ? 'flex-end' : 'flex-start';
17
+ const content = typeof m.content === 'string'
18
+ ? escapeHtml(m.content)
19
+ : escapeHtml(JSON.stringify(m.content));
20
+ return `
21
+ <div style="display:flex;justify-content:${align};margin:8px 0">
22
+ <div style="max-width:75%;padding:12px 16px;border-radius:16px;background:${bgColor};color:#e2e8f0;font-size:14px;line-height:1.6;white-space:pre-wrap;word-break:break-word">
23
+ ${content}
24
+ </div>
25
+ </div>`;
26
+ })
27
+ .join('\n');
28
+ return `<!DOCTYPE html>
29
+ <html lang="en">
30
+ <head>
31
+ <meta charset="UTF-8">
32
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
33
+ <title>Nimbus Session: ${escapeHtml(shared.name)}</title>
34
+ <style>
35
+ * { margin: 0; padding: 0; box-sizing: border-box; }
36
+ body {
37
+ background: #0a0e1a;
38
+ color: #e2e8f0;
39
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
40
+ min-height: 100vh;
41
+ }
42
+ .header {
43
+ border-bottom: 1px solid rgba(255,255,255,0.1);
44
+ padding: 16px 24px;
45
+ display: flex;
46
+ align-items: center;
47
+ gap: 12px;
48
+ }
49
+ .logo { color: #22d3ee; font-weight: bold; font-size: 18px; }
50
+ .title { color: #94a3b8; font-size: 14px; }
51
+ .meta { color: #64748b; font-size: 12px; margin-left: auto; }
52
+ .messages { max-width: 800px; margin: 0 auto; padding: 24px; }
53
+ .badge {
54
+ display: inline-block; padding: 2px 8px; border-radius: 9999px;
55
+ font-size: 11px; font-weight: 500; background: rgba(34,211,238,0.1);
56
+ color: #22d3ee; border: 1px solid rgba(34,211,238,0.2);
57
+ }
58
+ .footer {
59
+ border-top: 1px solid rgba(255,255,255,0.1);
60
+ padding: 16px 24px; text-align: center;
61
+ color: #64748b; font-size: 12px;
62
+ }
63
+ </style>
64
+ </head>
65
+ <body>
66
+ <div class="header">
67
+ <span class="logo">Nimbus</span>
68
+ <span class="title">${escapeHtml(shared.name)}</span>
69
+ <span class="badge">${escapeHtml(shared.mode)}</span>
70
+ ${shared.isLive ? '<span class="badge" style="background:rgba(16,185,129,0.1);color:#10b981;border-color:rgba(16,185,129,0.2)">LIVE</span>' : ''}
71
+ <span class="meta">${shared.model} &bull; $${shared.costUSD.toFixed(4)} &bull; ${shared.tokenCount.toLocaleString()} tokens</span>
72
+ </div>
73
+ <div class="messages">
74
+ ${messagesHtml}
75
+ </div>
76
+ <div class="footer">
77
+ Shared via Nimbus &bull; Created ${new Date(shared.createdAt).toLocaleString()} &bull; Expires ${new Date(shared.expiresAt).toLocaleString()}
78
+ </div>
79
+ </body>
80
+ </html>`;
81
+ }
82
+ /** Escape HTML special characters. */
83
+ function escapeHtml(text) {
84
+ return text
85
+ .replace(/&/g, '&amp;')
86
+ .replace(/</g, '&lt;')
87
+ .replace(/>/g, '&gt;')
88
+ .replace(/"/g, '&quot;')
89
+ .replace(/'/g, '&#39;');
90
+ }
91
+ /**
92
+ * Format a chat session as a Markdown runbook for team documentation.
93
+ *
94
+ * Produces a self-contained `.md` file with:
95
+ * - Session metadata header (model, date, mode, cost)
96
+ * - Each user message as a `## User` section
97
+ * - Each assistant message as an `## Agent` section
98
+ * - Tool calls as collapsible `<details>` blocks
99
+ * - System messages skipped (they are implementation details)
100
+ */
101
+ export function formatSessionAsRunbook(messages, session) {
102
+ const date = new Date().toISOString().slice(0, 19).replace('T', ' ');
103
+ const lines = [
104
+ '# Nimbus Session Runbook',
105
+ '',
106
+ '| Field | Value |',
107
+ '|-------|-------|',
108
+ `| Date | ${date} |`,
109
+ `| Model | ${session?.model ?? 'default'} |`,
110
+ `| Mode | ${session?.mode ?? 'build'} |`,
111
+ `| Tokens | ${session?.tokenCount?.toLocaleString() ?? 'N/A'} |`,
112
+ `| Cost | $${session?.costUSD?.toFixed(4) ?? '0.0000'} |`,
113
+ '',
114
+ '---',
115
+ '',
116
+ ];
117
+ for (const msg of messages) {
118
+ if (msg.role === 'system')
119
+ continue;
120
+ const heading = msg.role === 'user' ? '## User' : '## Agent';
121
+ lines.push(heading);
122
+ lines.push('');
123
+ // Preserve code blocks; escape HTML outside them
124
+ const content = msg.content.trim();
125
+ lines.push(content);
126
+ lines.push('');
127
+ lines.push('---');
128
+ lines.push('');
129
+ }
130
+ return lines.join('\n');
131
+ }
package/dist/src/snapshots/index.js ADDED
@@ -0,0 +1 @@
1
+ export { SnapshotManager } from './manager';
package/dist/src/snapshots/manager.js ADDED
@@ -0,0 +1,432 @@
1
+ /**
2
+ * Snapshot Manager
3
+ *
4
+ * Captures and restores file state using git tree objects (for git projects)
5
+ * or filesystem copies (for non-git projects). Supports undo/redo operations
6
+ * for file-modifying tool calls during a Nimbus CLI session.
7
+ */
8
+ import { exec } from 'node:child_process';
9
+ import { promisify } from 'node:util';
10
+ import * as fs from 'node:fs';
11
+ import * as path from 'node:path';
12
+ import * as crypto from 'node:crypto';
13
+ const execAsync = promisify(exec);
14
+ /** Default maximum number of snapshots to retain. */
15
+ const DEFAULT_MAX_SNAPSHOTS = 100;
16
+ /** Default maximum age for snapshots: 7 days in milliseconds. */
17
+ const DEFAULT_MAX_AGE = 7 * 24 * 60 * 60 * 1000;
18
+ /**
19
+ * Directories and patterns to skip when copying files in non-git mode.
20
+ * These are typically large, generated, or internal directories that
21
+ * should not be included in snapshot copies.
22
+ */
23
+ const SKIP_DIRS = new Set([
24
+ 'node_modules',
25
+ '.git',
26
+ 'dist',
27
+ 'coverage',
28
+ '.nimbus',
29
+ '.next',
30
+ '.cache',
31
+ '__pycache__',
32
+ ]);
33
+ /**
34
+ * Shell command patterns that indicate file-modifying operations.
35
+ * Used by `shouldSnapshot` to detect bash commands that alter the filesystem.
36
+ */
37
+ const FILE_MODIFYING_PATTERNS = [
38
+ /\brm\b/,
39
+ /\bmv\b/,
40
+ /\bcp\b/,
41
+ /\bchmod\b/,
42
+ /\bchown\b/,
43
+ /\bsed\b/,
44
+ /\bawk\b/,
45
+ /\bmkdir\b/,
46
+ /\brmdir\b/,
47
+ /\btouch\b/,
48
+ /\btruncate\b/,
49
+ /\bln\b/,
50
+ /\bunlink\b/,
51
+ />/, // redirect operators: >, >>, 2>, etc.
52
+ ];
53
+ /**
54
+ * Tool names that always trigger a snapshot because they directly
55
+ * modify files on disk.
56
+ */
57
+ const SNAPSHOT_TOOL_NAMES = new Set(['edit_file', 'multi_edit', 'write_file']);
58
+ /**
59
+ * Manages snapshots of the working tree for undo/redo support.
60
+ *
61
+ * For git-based projects, snapshots are captured as git tree objects using
62
+ * `git write-tree`, which records the full index state without creating a commit.
63
+ * Restoring reads the tree back into the index and checks out all files.
64
+ *
65
+ * For non-git projects, snapshots are stored as full directory copies under
66
+ * `.nimbus/snapshots/{id}/`, skipping large generated directories like
67
+ * `node_modules` and `dist`.
68
+ */
69
+ export class SnapshotManager {
70
+ projectDir;
71
+ maxSnapshots;
72
+ maxAge;
73
+ isGitProject;
74
+ snapshotDir;
75
+ snapshots = [];
76
+ undoneSnapshots = [];
77
+ nextId = 1;
78
+ constructor(options) {
79
+ this.projectDir = options.projectDir;
80
+ this.maxSnapshots = options.maxSnapshots ?? DEFAULT_MAX_SNAPSHOTS;
81
+ this.maxAge = options.maxAge ?? DEFAULT_MAX_AGE;
82
+ this.snapshotDir = path.join(options.projectDir, '.nimbus', 'snapshots');
83
+ // Detect if the project directory is a git repository
84
+ this.isGitProject = fs.existsSync(path.join(options.projectDir, '.git'));
85
+ // For non-git projects, ensure the snapshot directory exists
86
+ if (!this.isGitProject) {
87
+ fs.mkdirSync(this.snapshotDir, { recursive: true });
88
+ }
89
+ }
90
+ /**
91
+ * Capture a snapshot of the current working tree state.
92
+ *
93
+ * For git projects:
94
+ * 1. Creates a temporary git index and stages all changes into it
95
+ * 2. Captures a tree hash with `git write-tree` (no commit is created)
96
+ * 3. Removes the temporary index; the user's real staging area is untouched
97
+ *
98
+ * For non-git projects:
99
+ * 1. Creates a numbered snapshot directory under `.nimbus/snapshots/{id}/`
100
+ * 2. Recursively copies all tracked files, skipping `node_modules`,
101
+ * `.git`, `dist`, `coverage`, and `.nimbus/snapshots`
102
+ *
103
+ * @param params - Metadata describing the tool call that triggered this snapshot.
104
+ * @returns The newly created Snapshot record.
105
+ */
106
+ async captureSnapshot(params) {
107
+ const snapshotId = crypto.randomUUID();
108
+ let treeHash = '';
109
+ if (this.isGitProject) {
110
+ treeHash = await this.captureGitSnapshot();
111
+ }
112
+ else {
113
+ await this.captureFilesystemSnapshot(snapshotId);
114
+ }
115
+ const snapshot = {
116
+ id: snapshotId,
117
+ sessionId: params.sessionId,
118
+ messageId: params.messageId,
119
+ toolCallId: params.toolCallId,
120
+ treeHash,
121
+ timestamp: new Date(),
122
+ description: params.description,
123
+ isGitProject: this.isGitProject,
124
+ };
125
+ this.snapshots.push(snapshot);
126
+ this.nextId++;
127
+ // Clear the redo stack whenever a new snapshot is captured,
128
+ // since the timeline has diverged
129
+ this.undoneSnapshots = [];
130
+ return snapshot;
131
+ }
132
+ /**
133
+ * Restore the working tree to the state recorded in a specific snapshot.
134
+ *
135
+ * For git projects:
136
+ * Uses `git read-tree` and `git checkout-index -a -f` to replace the
137
+ * working tree contents with the snapshot's tree hash.
138
+ *
139
+ * For non-git projects:
140
+ * Copies files back from the snapshot directory, replacing current contents.
141
+ *
142
+ * @param snapshotId - The ID of the snapshot to restore.
143
+ * @returns An object indicating whether the restore succeeded and a description.
144
+ */
145
+ async restoreSnapshot(snapshotId) {
146
+ const snapshot = this.snapshots.find(s => s.id === snapshotId);
147
+ if (!snapshot) {
148
+ return { restored: false, description: `Snapshot ${snapshotId} not found` };
149
+ }
150
+ try {
151
+ if (snapshot.isGitProject) {
152
+ await this.restoreGitSnapshot(snapshot.treeHash);
153
+ }
154
+ else {
155
+ await this.restoreFilesystemSnapshot(snapshot.id);
156
+ }
157
+ return { restored: true, description: `Restored snapshot: ${snapshot.description}` };
158
+ }
159
+ catch (error) {
160
+ const message = error instanceof Error ? error.message : String(error);
161
+ return { restored: false, description: `Failed to restore snapshot: ${message}` };
162
+ }
163
+ }
164
+ /**
165
+ * Undo the last file-modifying tool call by restoring the previous snapshot.
166
+ *
167
+ * Before restoring, the current working tree state is captured so that
168
+ * `redo()` can reverse the undo operation if needed.
169
+ *
170
+ * @returns An object indicating whether the undo succeeded and a description.
171
+ */
172
+ async undo() {
173
+ if (this.snapshots.length < 2) {
174
+ return { success: false, description: 'Nothing to undo' };
175
+ }
176
+ try {
177
+ // Pop the most recent snapshot (this is the state we are undoing)
178
+ const current = this.snapshots.pop();
179
+ // Push it onto the redo stack so we can redo later
180
+ this.undoneSnapshots.push(current);
181
+ // The snapshot we want to restore is now the last one in the stack
182
+ const target = this.snapshots[this.snapshots.length - 1];
183
+ if (target.isGitProject) {
184
+ await this.restoreGitSnapshot(target.treeHash);
185
+ }
186
+ else {
187
+ await this.restoreFilesystemSnapshot(target.id);
188
+ }
189
+ return { success: true, description: `Undone: ${current.description}` };
190
+ }
191
+ catch (error) {
192
+ const message = error instanceof Error ? error.message : String(error);
193
+ return { success: false, description: `Undo failed: ${message}` };
194
+ }
195
+ }
196
+ /**
197
+ * Redo a previously undone snapshot.
198
+ *
199
+ * Pops the most recently undone snapshot from the redo stack and restores
200
+ * it, pushing it back onto the main snapshot stack.
201
+ *
202
+ * @returns An object indicating whether the redo succeeded and a description.
203
+ */
204
+ async redo() {
205
+ if (this.undoneSnapshots.length === 0) {
206
+ return { success: false, description: 'Nothing to redo' };
207
+ }
208
+ try {
209
+ const snapshot = this.undoneSnapshots.pop();
210
+ if (snapshot.isGitProject) {
211
+ await this.restoreGitSnapshot(snapshot.treeHash);
212
+ }
213
+ else {
214
+ await this.restoreFilesystemSnapshot(snapshot.id);
215
+ }
216
+ // Push back onto main stack
217
+ this.snapshots.push(snapshot);
218
+ return { success: true, description: `Redone: ${snapshot.description}` };
219
+ }
220
+ catch (error) {
221
+ const message = error instanceof Error ? error.message : String(error);
222
+ return { success: false, description: `Redo failed: ${message}` };
223
+ }
224
+ }
225
+ /**
226
+ * Get snapshot history, optionally filtered to a specific session.
227
+ *
228
+ * @param sessionId - If provided, only return snapshots from this session.
229
+ * @returns An array of Snapshot records, ordered oldest to newest.
230
+ */
231
+ getHistory(sessionId) {
232
+ if (sessionId) {
233
+ return this.snapshots.filter(s => s.sessionId === sessionId);
234
+ }
235
+ return [...this.snapshots];
236
+ }
237
+ /**
238
+ * Get the total number of snapshots currently stored.
239
+ */
240
+ get count() {
241
+ return this.snapshots.length;
242
+ }
243
+ /**
244
+ * Clean up old snapshots that exceed `maxAge` or `maxSnapshots`.
245
+ *
246
+ * Snapshots older than `maxAge` are removed first, then the oldest
247
+ * snapshots are trimmed until the total count is at or below `maxSnapshots`.
248
+ * For non-git projects, the corresponding snapshot directories are also
249
+ * deleted from disk.
250
+ *
251
+ * @returns The number of snapshots that were removed.
252
+ */
253
+ async cleanup() {
254
+ const now = Date.now();
255
+ const originalCount = this.snapshots.length;
256
+ // Remove snapshots older than maxAge
257
+ const expired = this.snapshots.filter(s => now - s.timestamp.getTime() > this.maxAge);
258
+ this.snapshots = this.snapshots.filter(s => now - s.timestamp.getTime() <= this.maxAge);
259
+ // Trim to maxSnapshots (keep most recent)
260
+ let trimmed = [];
261
+ if (this.snapshots.length > this.maxSnapshots) {
262
+ const excess = this.snapshots.length - this.maxSnapshots;
263
+ trimmed = this.snapshots.splice(0, excess);
264
+ }
265
+ // Clean up filesystem snapshot directories for non-git projects
266
+ const removed = [...expired, ...trimmed];
267
+ if (!this.isGitProject) {
268
+ for (const snapshot of removed) {
269
+ const snapshotPath = path.join(this.snapshotDir, snapshot.id);
270
+ try {
271
+ if (fs.existsSync(snapshotPath)) {
272
+ fs.rmSync(snapshotPath, { recursive: true, force: true });
273
+ }
274
+ }
275
+ catch {
276
+ // Best-effort cleanup; do not throw on individual directory failures
277
+ }
278
+ }
279
+ }
280
+ // Also clean stale entries from the redo stack
281
+ this.undoneSnapshots = this.undoneSnapshots.filter(s => now - s.timestamp.getTime() <= this.maxAge);
282
+ return originalCount - this.snapshots.length;
283
+ }
284
+ /**
285
+ * Determine whether a tool call should trigger a snapshot capture.
286
+ *
287
+ * Returns `true` for tools that directly modify files:
288
+ * - `edit_file`, `multi_edit`, `write_file` always return true.
289
+ * - `bash` returns true if the command string contains patterns
290
+ * indicative of file modification (rm, mv, cp, sed, redirect operators, etc.).
291
+ *
292
+ * @param toolName - The name of the tool being invoked.
293
+ * @param input - Optional input parameters for the tool call.
294
+ * @returns Whether a snapshot should be taken before this tool executes.
295
+ */
296
+ static shouldSnapshot(toolName, input) {
297
+ // These tools always modify files
298
+ if (SNAPSHOT_TOOL_NAMES.has(toolName)) {
299
+ return true;
300
+ }
301
+ // For bash commands, inspect the command string for file-modifying patterns
302
+ if (toolName === 'bash' && input) {
303
+ const command = typeof input.command === 'string' ? input.command : '';
304
+ if (!command) {
305
+ return false;
306
+ }
307
+ return FILE_MODIFYING_PATTERNS.some(pattern => pattern.test(command));
308
+ }
309
+ return false;
310
+ }
311
+ // ---------------------------------------------------------------------------
312
+ // Private helpers
313
+ // ---------------------------------------------------------------------------
314
+ /**
315
+ * Capture a git tree hash using a temporary index file.
316
+ *
317
+ * Uses `GIT_INDEX_FILE` to operate on an isolated temporary index so that
318
+ * the user's real staging area (`.git/index`) is never modified.
319
+ *
320
+ * @returns The git tree hash string.
321
+ * @throws If the git commands fail.
322
+ */
323
+ async captureGitSnapshot() {
324
+ // Use a temporary index to avoid corrupting the user's staging area.
325
+ // GIT_INDEX_FILE tells git to use an alternate index, so `git add -A`
326
+ // and `git write-tree` operate on the temp file, leaving the real
327
+ // index (.git/index) untouched.
328
+ const tmpIndex = path.join(this.projectDir, '.git', `index.nimbus-snapshot-${Date.now()}`);
329
+ const env = { ...process.env, GIT_INDEX_FILE: tmpIndex };
330
+ try {
331
+ await execAsync('git add -A', { cwd: this.projectDir, env });
332
+ const { stdout } = await execAsync('git write-tree', { cwd: this.projectDir, env });
333
+ return stdout.trim();
334
+ }
335
+ finally {
336
+ // Clean up the temporary index file
337
+ try {
338
+ fs.unlinkSync(tmpIndex);
339
+ }
340
+ catch {
341
+ /* ignore */
342
+ }
343
+ }
344
+ }
345
+ /**
346
+ * Restore the working tree from a git tree hash.
347
+ *
348
+ * @param treeHash - The git tree hash to restore.
349
+ * @throws If the git commands fail.
350
+ */
351
+ async restoreGitSnapshot(treeHash) {
352
+ await execAsync(`git read-tree ${treeHash}`, { cwd: this.projectDir });
353
+ await execAsync('git checkout-index -a -f', { cwd: this.projectDir });
354
+ }
355
+ /**
356
+ * Copy the current project files into a numbered snapshot directory.
357
+ * Skips directories listed in SKIP_DIRS.
358
+ *
359
+ * @param snapshotId - The snapshot ID used to name the directory.
360
+ */
361
+ async captureFilesystemSnapshot(snapshotId) {
362
+ const destDir = path.join(this.snapshotDir, snapshotId);
363
+ fs.mkdirSync(destDir, { recursive: true });
364
+ this.copyDirectoryRecursive(this.projectDir, destDir);
365
+ }
366
+ /**
367
+ * Restore project files from a snapshot directory by copying them back.
368
+ * Cleans the project directory first (except for SKIP_DIRS and .nimbus)
369
+ * to ensure deleted files are also restored correctly.
370
+ *
371
+ * @param snapshotId - The snapshot ID whose directory to restore from.
372
+ * @throws If the snapshot directory does not exist.
373
+ */
374
+ async restoreFilesystemSnapshot(snapshotId) {
375
+ const srcDir = path.join(this.snapshotDir, snapshotId);
376
+ if (!fs.existsSync(srcDir)) {
377
+ throw new Error(`Snapshot directory not found: ${srcDir}`);
378
+ }
379
+ // Remove current project files (excluding skipped directories)
380
+ this.cleanProjectDirectory();
381
+ // Copy snapshot files back into the project directory
382
+ this.copyDirectoryRecursive(srcDir, this.projectDir);
383
+ }
384
+ /**
385
+ * Recursively copy a directory, skipping entries in SKIP_DIRS.
386
+ * Uses `fs.cpSync` for individual files and recurses into subdirectories.
387
+ *
388
+ * @param src - Source directory path.
389
+ * @param dest - Destination directory path.
390
+ */
391
+ copyDirectoryRecursive(src, dest) {
392
+ const entries = fs.readdirSync(src, { withFileTypes: true });
393
+ for (const entry of entries) {
394
+ if (SKIP_DIRS.has(entry.name)) {
395
+ continue;
396
+ }
397
+ const srcPath = path.join(src, entry.name);
398
+ const destPath = path.join(dest, entry.name);
399
+ if (entry.isDirectory()) {
400
+ fs.mkdirSync(destPath, { recursive: true });
401
+ this.copyDirectoryRecursive(srcPath, destPath);
402
+ }
403
+ else {
404
+ fs.cpSync(srcPath, destPath);
405
+ }
406
+ }
407
+ }
408
+ /**
409
+ * Remove all files and non-skipped directories from the project directory.
410
+ * This is used before restoring a non-git snapshot to ensure a clean state.
411
+ */
412
+ cleanProjectDirectory() {
413
+ const entries = fs.readdirSync(this.projectDir, { withFileTypes: true });
414
+ for (const entry of entries) {
415
+ if (SKIP_DIRS.has(entry.name)) {
416
+ continue;
417
+ }
418
+ const fullPath = path.join(this.projectDir, entry.name);
419
+ try {
420
+ if (entry.isDirectory()) {
421
+ fs.rmSync(fullPath, { recursive: true, force: true });
422
+ }
423
+ else {
424
+ fs.unlinkSync(fullPath);
425
+ }
426
+ }
427
+ catch {
428
+ // Best-effort cleanup; continue on individual file failures
429
+ }
430
+ }
431
+ }
432
+ }
package/dist/src/state/artifacts.js ADDED
@@ -0,0 +1,94 @@
1
+ /**
2
+ * Artifact CRUD helpers.
3
+ *
4
+ * Refactored from SQLiteAdapter.saveArtifact, getArtifact, listArtifacts,
5
+ * and deleteArtifact.
6
+ */
7
+ import { getDb } from './db';
8
+ // ---------------------------------------------------------------------------
9
+ // Public API
10
+ // ---------------------------------------------------------------------------
11
+ /**
12
+ * Persist or update an artifact. Uses INSERT ... ON CONFLICT to upsert.
13
+ */
14
+ export function saveArtifact(id, conversationId, name, type, content, language, metadata, db) {
15
+ const d = db || getDb();
16
+ const stmt = d.prepare(`
17
+ INSERT INTO artifacts (id, conversation_id, name, type, content, language, created_at, updated_at, metadata)
18
+ VALUES (?, ?, ?, ?, ?, ?, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, ?)
19
+ ON CONFLICT(id) DO UPDATE SET
20
+ conversation_id = excluded.conversation_id,
21
+ name = excluded.name,
22
+ type = excluded.type,
23
+ content = excluded.content,
24
+ language = excluded.language,
25
+ updated_at = CURRENT_TIMESTAMP,
26
+ metadata = excluded.metadata
27
+ `);
28
+ stmt.run(id, conversationId || null, name, type, content, language || null, metadata ? JSON.stringify(metadata) : null);
29
+ }
30
+ /**
31
+ * Retrieve a single artifact by id.
32
+ */
33
+ export function getArtifact(id, db) {
34
+ const d = db || getDb();
35
+ const stmt = d.prepare('SELECT * FROM artifacts WHERE id = ?');
36
+ const row = stmt.get(id);
37
+ if (!row) {
38
+ return null;
39
+ }
40
+ return {
41
+ id: row.id,
42
+ conversationId: row.conversation_id,
43
+ name: row.name,
44
+ type: row.type,
45
+ content: row.content,
46
+ language: row.language,
47
+ createdAt: row.created_at,
48
+ updatedAt: row.updated_at,
49
+ metadata: row.metadata ? JSON.parse(row.metadata) : null,
50
+ };
51
+ }
52
+ /**
53
+ * List artifacts with optional type and conversation filters.
54
+ */
55
+ export function listArtifacts(type, conversationId, limit = 50, offset = 0, db) {
56
+ const d = db || getDb();
57
+ let query = 'SELECT * FROM artifacts';
58
+ const params = [];
59
+ const conditions = [];
60
+ if (type) {
61
+ conditions.push('type = ?');
62
+ params.push(type);
63
+ }
64
+ if (conversationId) {
65
+ conditions.push('conversation_id = ?');
66
+ params.push(conversationId);
67
+ }
68
+ if (conditions.length > 0) {
69
+ query += ` WHERE ${conditions.join(' AND ')}`;
70
+ }
71
+ query += ' ORDER BY created_at DESC LIMIT ? OFFSET ?';
72
+ params.push(limit, offset);
73
+ const stmt = d.prepare(query);
74
+ const rows = stmt.all(...params);
75
+ return rows.map(row => ({
76
+ id: row.id,
77
+ conversationId: row.conversation_id,
78
+ name: row.name,
79
+ type: row.type,
80
+ content: row.content,
81
+ language: row.language,
82
+ createdAt: row.created_at,
83
+ updatedAt: row.updated_at,
84
+ metadata: row.metadata ? JSON.parse(row.metadata) : null,
85
+ }));
86
+ }
87
+ /**
88
+ * Delete an artifact by id.
89
+ */
90
+ export function deleteArtifact(id, db) {
91
+ const d = db || getDb();
92
+ const stmt = d.prepare('DELETE FROM artifacts WHERE id = ?');
93
+ stmt.run(id);
94
+ }