@dreamlake/dreamlake-cli 0.88.1 → 0.89.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 (535) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +53 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2330 -0
  18. package/dist/api/index.js +114 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +75 -0
  38. package/dist/api/note-files.js +65 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-toc.d.ts +2 -0
  44. package/dist/api/note-toc.js +2 -0
  45. package/dist/api/notes.d.ts +304 -0
  46. package/dist/api/notes.js +181 -0
  47. package/dist/api/open-resources.d.ts +27 -0
  48. package/dist/api/open-resources.js +102 -0
  49. package/dist/api/ownership.d.ts +12 -0
  50. package/dist/api/ownership.js +24 -0
  51. package/dist/api/platform.d.ts +83 -0
  52. package/dist/api/platform.js +56 -0
  53. package/dist/api/presigned-transfer.d.ts +2 -0
  54. package/dist/api/presigned-transfer.js +2 -0
  55. package/dist/api/registered-runs.d.ts +48 -0
  56. package/dist/api/registered-runs.js +33 -0
  57. package/dist/api/sessions.d.ts +299 -0
  58. package/dist/api/sessions.js +105 -0
  59. package/dist/api/storage.d.ts +46 -0
  60. package/dist/api/storage.js +34 -0
  61. package/dist/api/streams.d.ts +18 -0
  62. package/dist/api/streams.js +70 -0
  63. package/dist/api/vault.d.ts +93 -0
  64. package/dist/api/vault.js +79 -0
  65. package/dist/api/workspace.d.ts +180 -0
  66. package/dist/api/workspace.js +146 -0
  67. package/dist/cli/agent-identity.d.ts +4 -0
  68. package/dist/cli/agent-identity.js +21 -0
  69. package/dist/cli/agents/identity.d.ts +50 -0
  70. package/dist/cli/agents/identity.js +105 -0
  71. package/dist/cli/agents/index.d.ts +31 -0
  72. package/dist/cli/agents/index.js +580 -0
  73. package/dist/cli/agents/manage.d.ts +43 -0
  74. package/dist/cli/agents/manage.js +376 -0
  75. package/dist/cli/agents/spec.d.ts +104 -0
  76. package/dist/cli/agents/spec.js +280 -0
  77. package/dist/cli/agents/web.d.ts +7 -0
  78. package/dist/cli/agents/web.js +109 -0
  79. package/dist/cli/artifact/incremental.d.ts +21 -0
  80. package/dist/cli/artifact/incremental.js +80 -0
  81. package/dist/cli/artifact/index.d.ts +52 -0
  82. package/dist/cli/artifact/index.js +405 -0
  83. package/dist/cli/artifact/meta.d.ts +69 -0
  84. package/dist/cli/artifact/meta.js +189 -0
  85. package/dist/cli/auth/commands.d.ts +29 -0
  86. package/dist/cli/auth/commands.js +327 -0
  87. package/dist/cli/auth/constants.d.ts +13 -0
  88. package/dist/cli/auth/constants.js +18 -0
  89. package/dist/cli/auth/credentials.d.ts +37 -0
  90. package/dist/cli/auth/credentials.js +155 -0
  91. package/dist/cli/auth/device-flow.d.ts +32 -0
  92. package/dist/cli/auth/device-flow.js +154 -0
  93. package/dist/cli/auth/device-secret.d.ts +6 -0
  94. package/dist/cli/auth/device-secret.js +26 -0
  95. package/dist/cli/auth/machine.d.ts +15 -0
  96. package/dist/cli/auth/machine.js +126 -0
  97. package/dist/cli/auth/materialized.d.ts +32 -0
  98. package/dist/cli/auth/materialized.js +102 -0
  99. package/dist/cli/auth/migrate.d.ts +10 -0
  100. package/dist/cli/auth/migrate.js +75 -0
  101. package/dist/cli/client.d.ts +102 -0
  102. package/dist/cli/client.js +206 -0
  103. package/dist/cli/collection-list.d.ts +3 -0
  104. package/dist/cli/collection-list.js +25 -0
  105. package/dist/cli/compat/ctx.d.ts +26 -0
  106. package/dist/cli/compat/ctx.js +76 -0
  107. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  108. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  109. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  110. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  111. package/dist/cli/compat/dreamdb.d.ts +112 -0
  112. package/dist/cli/compat/dreamdb.js +219 -0
  113. package/dist/cli/compat/flags.d.ts +2 -0
  114. package/dist/cli/compat/flags.js +13 -0
  115. package/dist/cli/compat/http.d.ts +23 -0
  116. package/dist/cli/compat/http.js +137 -0
  117. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  118. package/dist/cli/compat/presignedTransfer.js +580 -0
  119. package/dist/cli/compat/s3-backend.d.ts +73 -0
  120. package/dist/cli/compat/s3-backend.js +132 -0
  121. package/dist/cli/config.d.ts +22 -0
  122. package/dist/cli/config.js +96 -0
  123. package/dist/cli/connection/dto.d.ts +159 -0
  124. package/dist/cli/connection/dto.js +497 -0
  125. package/dist/cli/connection/index.d.ts +50 -0
  126. package/dist/cli/connection/index.js +413 -0
  127. package/dist/cli/connection/oauth.d.ts +23 -0
  128. package/dist/cli/connection/oauth.js +290 -0
  129. package/dist/cli/connection/write.d.ts +47 -0
  130. package/dist/cli/connection/write.js +573 -0
  131. package/dist/cli/create/index.d.ts +19 -0
  132. package/dist/cli/create/index.js +209 -0
  133. package/dist/cli/declare/index.d.ts +29 -0
  134. package/dist/cli/declare/index.js +304 -0
  135. package/dist/cli/delete/index.d.ts +18 -0
  136. package/dist/cli/delete/index.js +232 -0
  137. package/dist/cli/download/index.d.ts +9 -0
  138. package/dist/cli/download/index.js +128 -0
  139. package/dist/cli/env/compose.d.ts +88 -0
  140. package/dist/cli/env/compose.js +402 -0
  141. package/dist/cli/env/index.d.ts +176 -0
  142. package/dist/cli/env/index.js +1011 -0
  143. package/dist/cli/experiments/index.d.ts +11 -0
  144. package/dist/cli/experiments/index.js +168 -0
  145. package/dist/cli/glob.d.ts +1 -0
  146. package/dist/cli/glob.js +45 -0
  147. package/dist/cli/graphql-helpers.d.ts +23 -0
  148. package/dist/cli/graphql-helpers.js +42 -0
  149. package/dist/cli/graphql.d.ts +10 -0
  150. package/dist/cli/graphql.js +47 -0
  151. package/dist/cli/help-examples.generated.d.ts +1 -0
  152. package/dist/cli/help-examples.generated.js +192 -0
  153. package/dist/cli/helpers.d.ts +8 -0
  154. package/dist/cli/helpers.js +106 -0
  155. package/dist/cli/hosts/api.d.ts +29 -0
  156. package/dist/cli/hosts/api.js +54 -0
  157. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  158. package/dist/cli/hosts/bootstrap-source.js +2 -0
  159. package/dist/cli/hosts/catalog.d.ts +26 -0
  160. package/dist/cli/hosts/catalog.js +55 -0
  161. package/dist/cli/hosts/config.d.ts +45 -0
  162. package/dist/cli/hosts/config.js +179 -0
  163. package/dist/cli/hosts/credentials.d.ts +19 -0
  164. package/dist/cli/hosts/credentials.js +173 -0
  165. package/dist/cli/hosts/enroll.d.ts +17 -0
  166. package/dist/cli/hosts/enroll.js +109 -0
  167. package/dist/cli/hosts/enrollments.d.ts +25 -0
  168. package/dist/cli/hosts/enrollments.js +54 -0
  169. package/dist/cli/hosts/index.d.ts +6 -0
  170. package/dist/cli/hosts/index.js +279 -0
  171. package/dist/cli/hosts/inventory.d.ts +40 -0
  172. package/dist/cli/hosts/inventory.js +91 -0
  173. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  174. package/dist/cli/hosts/lifecycle.js +108 -0
  175. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  176. package/dist/cli/hosts/metrics-source.js +89 -0
  177. package/dist/cli/hosts/observations.d.ts +39 -0
  178. package/dist/cli/hosts/observations.js +102 -0
  179. package/dist/cli/hosts/remote.d.ts +5 -0
  180. package/dist/cli/hosts/remote.js +66 -0
  181. package/dist/cli/hosts/ssh.d.ts +63 -0
  182. package/dist/cli/hosts/ssh.js +276 -0
  183. package/dist/cli/index.d.ts +1 -0
  184. package/dist/cli/index.js +288 -0
  185. package/dist/cli/infra/api.d.ts +95 -0
  186. package/dist/cli/infra/api.js +291 -0
  187. package/dist/cli/infra/index.d.ts +5 -0
  188. package/dist/cli/infra/index.js +102 -0
  189. package/dist/cli/infra/move.d.ts +15 -0
  190. package/dist/cli/infra/move.js +123 -0
  191. package/dist/cli/infra/transfer.d.ts +15 -0
  192. package/dist/cli/infra/transfer.js +280 -0
  193. package/dist/cli/jobs/api.d.ts +69 -0
  194. package/dist/cli/jobs/api.js +121 -0
  195. package/dist/cli/jobs/index.d.ts +5 -0
  196. package/dist/cli/jobs/index.js +140 -0
  197. package/dist/cli/lakeshore/index.d.ts +98 -0
  198. package/dist/cli/lakeshore/index.js +502 -0
  199. package/dist/cli/launch/index.d.ts +43 -0
  200. package/dist/cli/launch/index.js +270 -0
  201. package/dist/cli/layout/index.d.ts +2 -0
  202. package/dist/cli/layout/index.js +44 -0
  203. package/dist/cli/layout/transport.d.ts +12 -0
  204. package/dist/cli/layout/transport.js +70 -0
  205. package/dist/cli/library/add.d.ts +60 -0
  206. package/dist/cli/library/add.js +348 -0
  207. package/dist/cli/library/cache.d.ts +26 -0
  208. package/dist/cli/library/cache.js +88 -0
  209. package/dist/cli/library/config.d.ts +75 -0
  210. package/dist/cli/library/config.js +198 -0
  211. package/dist/cli/library/digest.d.ts +5 -0
  212. package/dist/cli/library/digest.js +19 -0
  213. package/dist/cli/library/discover.d.ts +87 -0
  214. package/dist/cli/library/discover.js +534 -0
  215. package/dist/cli/library/freshness.d.ts +35 -0
  216. package/dist/cli/library/freshness.js +109 -0
  217. package/dist/cli/library/generation.d.ts +35 -0
  218. package/dist/cli/library/generation.js +211 -0
  219. package/dist/cli/library/index.d.ts +2 -0
  220. package/dist/cli/library/index.js +36 -0
  221. package/dist/cli/library/info.d.ts +69 -0
  222. package/dist/cli/library/info.js +311 -0
  223. package/dist/cli/library/list.d.ts +33 -0
  224. package/dist/cli/library/list.js +86 -0
  225. package/dist/cli/library/manifest.d.ts +81 -0
  226. package/dist/cli/library/manifest.js +200 -0
  227. package/dist/cli/library/manifestCache.d.ts +45 -0
  228. package/dist/cli/library/manifestCache.js +169 -0
  229. package/dist/cli/library/pull.d.ts +30 -0
  230. package/dist/cli/library/pull.js +438 -0
  231. package/dist/cli/library/push.d.ts +72 -0
  232. package/dist/cli/library/push.js +642 -0
  233. package/dist/cli/library/rm.d.ts +31 -0
  234. package/dist/cli/library/rm.js +200 -0
  235. package/dist/cli/library/search.d.ts +18 -0
  236. package/dist/cli/library/search.js +181 -0
  237. package/dist/cli/library/stat.d.ts +15 -0
  238. package/dist/cli/library/stat.js +127 -0
  239. package/dist/cli/library/tools.d.ts +104 -0
  240. package/dist/cli/library/tools.js +163 -0
  241. package/dist/cli/library/wire.d.ts +47 -0
  242. package/dist/cli/library/wire.js +120 -0
  243. package/dist/cli/list/index.d.ts +26 -0
  244. package/dist/cli/list/index.js +256 -0
  245. package/dist/cli/notes/character-plan.d.ts +22 -0
  246. package/dist/cli/notes/character-plan.js +232 -0
  247. package/dist/cli/notes/document.d.ts +73 -0
  248. package/dist/cli/notes/document.js +306 -0
  249. package/dist/cli/notes/edit-commands.d.ts +106 -0
  250. package/dist/cli/notes/edit-commands.js +623 -0
  251. package/dist/cli/notes/editing.d.ts +81 -0
  252. package/dist/cli/notes/editing.js +305 -0
  253. package/dist/cli/notes/events.d.ts +36 -0
  254. package/dist/cli/notes/events.js +54 -0
  255. package/dist/cli/notes/files-commands.d.ts +120 -0
  256. package/dist/cli/notes/files-commands.js +554 -0
  257. package/dist/cli/notes/html-read.d.ts +9 -0
  258. package/dist/cli/notes/html-read.js +90 -0
  259. package/dist/cli/notes/html.d.ts +73 -0
  260. package/dist/cli/notes/html.js +381 -0
  261. package/dist/cli/notes/index.d.ts +123 -0
  262. package/dist/cli/notes/index.js +1303 -0
  263. package/dist/cli/notes/linger.d.ts +59 -0
  264. package/dist/cli/notes/linger.js +339 -0
  265. package/dist/cli/notes/media-commands.d.ts +5 -0
  266. package/dist/cli/notes/media-commands.js +51 -0
  267. package/dist/cli/notes/move-command.d.ts +83 -0
  268. package/dist/cli/notes/move-command.js +259 -0
  269. package/dist/cli/notes/rm-command.d.ts +22 -0
  270. package/dist/cli/notes/rm-command.js +110 -0
  271. package/dist/cli/notes/select-command.d.ts +12 -0
  272. package/dist/cli/notes/select-command.js +84 -0
  273. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  274. package/dist/cli/notes/suggest-diff.js +311 -0
  275. package/dist/cli/notes/toc.d.ts +38 -0
  276. package/dist/cli/notes/toc.js +144 -0
  277. package/dist/cli/notes/transfer-command.d.ts +6 -0
  278. package/dist/cli/notes/transfer-command.js +9 -0
  279. package/dist/cli/notes/version-commands.d.ts +19 -0
  280. package/dist/cli/notes/version-commands.js +178 -0
  281. package/dist/cli/nymph/index.d.ts +74 -0
  282. package/dist/cli/nymph/index.js +349 -0
  283. package/dist/cli/org/index.d.ts +34 -0
  284. package/dist/cli/org/index.js +341 -0
  285. package/dist/cli/ownership/index.d.ts +12 -0
  286. package/dist/cli/ownership/index.js +122 -0
  287. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  288. package/dist/cli/ownership/metadata-transfer.js +159 -0
  289. package/dist/cli/page/index.d.ts +58 -0
  290. package/dist/cli/page/index.js +387 -0
  291. package/dist/cli/pipeline/index.d.ts +69 -0
  292. package/dist/cli/pipeline/index.js +604 -0
  293. package/dist/cli/progress.d.ts +60 -0
  294. package/dist/cli/progress.js +276 -0
  295. package/dist/cli/project/attachments.d.ts +10 -0
  296. package/dist/cli/project/attachments.js +39 -0
  297. package/dist/cli/project/grants.d.ts +10 -0
  298. package/dist/cli/project/grants.js +39 -0
  299. package/dist/cli/project/index.d.ts +8 -0
  300. package/dist/cli/project/index.js +92 -0
  301. package/dist/cli/project/move.d.ts +57 -0
  302. package/dist/cli/project/move.js +242 -0
  303. package/dist/cli/project/output.d.ts +2 -0
  304. package/dist/cli/project/output.js +29 -0
  305. package/dist/cli/project/stream.d.ts +55 -0
  306. package/dist/cli/project/stream.js +207 -0
  307. package/dist/cli/project/transfer-preview.d.ts +8 -0
  308. package/dist/cli/project/transfer-preview.js +10 -0
  309. package/dist/cli/prompt.d.ts +1 -0
  310. package/dist/cli/prompt.js +17 -0
  311. package/dist/cli/provider/dreamdir.d.ts +52 -0
  312. package/dist/cli/provider/dreamdir.js +138 -0
  313. package/dist/cli/provider/index.d.ts +4 -0
  314. package/dist/cli/provider/index.js +419 -0
  315. package/dist/cli/provider/jump-worker.d.ts +9 -0
  316. package/dist/cli/provider/jump-worker.js +141 -0
  317. package/dist/cli/provider/lifecycle.d.ts +149 -0
  318. package/dist/cli/provider/lifecycle.js +1390 -0
  319. package/dist/cli/provider/machine.d.ts +17 -0
  320. package/dist/cli/provider/machine.js +116 -0
  321. package/dist/cli/provider/ssh.d.ts +105 -0
  322. package/dist/cli/provider/ssh.js +305 -0
  323. package/dist/cli/provider/terraform.d.ts +140 -0
  324. package/dist/cli/provider/terraform.js +288 -0
  325. package/dist/cli/providers/index.d.ts +18 -0
  326. package/dist/cli/providers/index.js +422 -0
  327. package/dist/cli/python.d.ts +61 -0
  328. package/dist/cli/python.js +255 -0
  329. package/dist/cli/queues/index.d.ts +33 -0
  330. package/dist/cli/queues/index.js +248 -0
  331. package/dist/cli/queues/slurm.d.ts +10 -0
  332. package/dist/cli/queues/slurm.js +134 -0
  333. package/dist/cli/resources.d.ts +72 -0
  334. package/dist/cli/resources.js +137 -0
  335. package/dist/cli/run/index.d.ts +15 -0
  336. package/dist/cli/run/index.js +163 -0
  337. package/dist/cli/run/input.d.ts +34 -0
  338. package/dist/cli/run/input.js +135 -0
  339. package/dist/cli/run/recovery.d.ts +2 -0
  340. package/dist/cli/run/recovery.js +18 -0
  341. package/dist/cli/run/setup.d.ts +3 -0
  342. package/dist/cli/run/setup.js +62 -0
  343. package/dist/cli/runconfig/index.d.ts +12 -0
  344. package/dist/cli/runconfig/index.js +130 -0
  345. package/dist/cli/runnable/index.d.ts +35 -0
  346. package/dist/cli/runnable/index.js +575 -0
  347. package/dist/cli/runnable/path.d.ts +115 -0
  348. package/dist/cli/runnable/path.js +288 -0
  349. package/dist/cli/runnable/run.d.ts +91 -0
  350. package/dist/cli/runnable/run.js +239 -0
  351. package/dist/cli/runnable/upload.d.ts +43 -0
  352. package/dist/cli/runnable/upload.js +342 -0
  353. package/dist/cli/runnable/worker.d.ts +1 -0
  354. package/dist/cli/runnable/worker.js +44 -0
  355. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  356. package/dist/cli/self-update/index.d.ts +5 -0
  357. package/dist/cli/self-update/index.js +107 -0
  358. package/dist/cli/self-update/install.d.ts +60 -0
  359. package/dist/cli/self-update/install.js +428 -0
  360. package/dist/cli/self-update/paths.d.ts +40 -0
  361. package/dist/cli/self-update/paths.js +87 -0
  362. package/dist/cli/self-update/releases.d.ts +41 -0
  363. package/dist/cli/self-update/releases.js +153 -0
  364. package/dist/cli/self-update/settings.d.ts +16 -0
  365. package/dist/cli/self-update/settings.js +68 -0
  366. package/dist/cli/self-update/update.d.ts +18 -0
  367. package/dist/cli/self-update/update.js +241 -0
  368. package/dist/cli/service-accounts/index.d.ts +3 -0
  369. package/dist/cli/service-accounts/index.js +149 -0
  370. package/dist/cli/session-affiliation.d.ts +26 -0
  371. package/dist/cli/session-affiliation.js +135 -0
  372. package/dist/cli/sessions/affiliation.d.ts +8 -0
  373. package/dist/cli/sessions/affiliation.js +66 -0
  374. package/dist/cli/sessions/api.d.ts +55 -0
  375. package/dist/cli/sessions/api.js +88 -0
  376. package/dist/cli/sessions/control.d.ts +6 -0
  377. package/dist/cli/sessions/control.js +159 -0
  378. package/dist/cli/sessions/conversation.d.ts +15 -0
  379. package/dist/cli/sessions/conversation.js +118 -0
  380. package/dist/cli/sessions/index.d.ts +2 -0
  381. package/dist/cli/sessions/index.js +209 -0
  382. package/dist/cli/sessions/managed.d.ts +39 -0
  383. package/dist/cli/sessions/managed.js +63 -0
  384. package/dist/cli/sessions/redaction.d.ts +2 -0
  385. package/dist/cli/sessions/redaction.js +11 -0
  386. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  387. package/dist/cli/sessions/runner/exec.js +335 -0
  388. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  389. package/dist/cli/sessions/runner/journal.js +49 -0
  390. package/dist/cli/sessions/runner/native.d.ts +48 -0
  391. package/dist/cli/sessions/runner/native.js +170 -0
  392. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  393. package/dist/cli/sessions/runner/pod.js +129 -0
  394. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  395. package/dist/cli/sessions/runner/serve.js +558 -0
  396. package/dist/cli/sessions/sync.d.ts +47 -0
  397. package/dist/cli/sessions/sync.js +80 -0
  398. package/dist/cli/sessions/transport.d.ts +14 -0
  399. package/dist/cli/sessions/transport.js +116 -0
  400. package/dist/cli/share.d.ts +15 -0
  401. package/dist/cli/share.js +139 -0
  402. package/dist/cli/skill/catalog.d.ts +141 -0
  403. package/dist/cli/skill/catalog.js +442 -0
  404. package/dist/cli/skill/files.d.ts +89 -0
  405. package/dist/cli/skill/files.js +264 -0
  406. package/dist/cli/skill/index.d.ts +268 -0
  407. package/dist/cli/skill/index.js +1216 -0
  408. package/dist/cli/skill/manifest.d.ts +30 -0
  409. package/dist/cli/skill/manifest.js +101 -0
  410. package/dist/cli/skill/prefs.d.ts +9 -0
  411. package/dist/cli/skill/prefs.js +32 -0
  412. package/dist/cli/skill/reminders.d.ts +15 -0
  413. package/dist/cli/skill/reminders.js +105 -0
  414. package/dist/cli/skill/tar.d.ts +17 -0
  415. package/dist/cli/skill/tar.js +195 -0
  416. package/dist/cli/snapshot/index.d.ts +24 -0
  417. package/dist/cli/snapshot/index.js +146 -0
  418. package/dist/cli/source/access.d.ts +45 -0
  419. package/dist/cli/source/access.js +563 -0
  420. package/dist/cli/source/control.d.ts +103 -0
  421. package/dist/cli/source/control.js +546 -0
  422. package/dist/cli/source/delete.d.ts +89 -0
  423. package/dist/cli/source/delete.js +463 -0
  424. package/dist/cli/source/index.d.ts +288 -0
  425. package/dist/cli/source/index.js +1348 -0
  426. package/dist/cli/source/share.d.ts +65 -0
  427. package/dist/cli/source/share.js +530 -0
  428. package/dist/cli/source/upload.d.ts +62 -0
  429. package/dist/cli/source/upload.js +258 -0
  430. package/dist/cli/source/write.d.ts +77 -0
  431. package/dist/cli/source/write.js +335 -0
  432. package/dist/cli/spawn.d.ts +28 -0
  433. package/dist/cli/spawn.js +81 -0
  434. package/dist/cli/target.d.ts +22 -0
  435. package/dist/cli/target.js +85 -0
  436. package/dist/cli/tasks/index.d.ts +38 -0
  437. package/dist/cli/tasks/index.js +365 -0
  438. package/dist/cli/team/index.d.ts +37 -0
  439. package/dist/cli/team/index.js +407 -0
  440. package/dist/cli/telemetry.d.ts +23 -0
  441. package/dist/cli/telemetry.js +262 -0
  442. package/dist/cli/telemetryJournal.d.ts +26 -0
  443. package/dist/cli/telemetryJournal.js +104 -0
  444. package/dist/cli/update/index.d.ts +21 -0
  445. package/dist/cli/update/index.js +284 -0
  446. package/dist/cli/upload/index.d.ts +11 -0
  447. package/dist/cli/upload/index.js +261 -0
  448. package/dist/cli/upload/kinds.d.ts +10 -0
  449. package/dist/cli/upload/kinds.js +85 -0
  450. package/dist/cli/upload/multipart.d.ts +21 -0
  451. package/dist/cli/upload/multipart.js +248 -0
  452. package/dist/cli/vault/affected-preview.d.ts +15 -0
  453. package/dist/cli/vault/affected-preview.js +38 -0
  454. package/dist/cli/vault/cloud.d.ts +55 -0
  455. package/dist/cli/vault/cloud.js +287 -0
  456. package/dist/cli/vault/format.d.ts +18 -0
  457. package/dist/cli/vault/format.js +104 -0
  458. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  459. package/dist/cli/vault/hostCredentials.js +71 -0
  460. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  461. package/dist/cli/vault/hostSupersessions.js +68 -0
  462. package/dist/cli/vault/import.d.ts +3 -0
  463. package/dist/cli/vault/import.js +79 -0
  464. package/dist/cli/vault/index.d.ts +14 -0
  465. package/dist/cli/vault/index.js +225 -0
  466. package/dist/cli/vault/keys.d.ts +5 -0
  467. package/dist/cli/vault/keys.js +165 -0
  468. package/dist/cli/vault/kms.d.ts +6 -0
  469. package/dist/cli/vault/kms.js +169 -0
  470. package/dist/cli/vault/list.d.ts +13 -0
  471. package/dist/cli/vault/list.js +60 -0
  472. package/dist/cli/vault/listView.d.ts +21 -0
  473. package/dist/cli/vault/listView.js +123 -0
  474. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  475. package/dist/cli/vault/managementMetadata.js +23 -0
  476. package/dist/cli/vault/mutations.d.ts +8 -0
  477. package/dist/cli/vault/mutations.js +151 -0
  478. package/dist/cli/vault/otp.d.ts +6 -0
  479. package/dist/cli/vault/otp.js +62 -0
  480. package/dist/cli/vault/otpIntent.d.ts +23 -0
  481. package/dist/cli/vault/otpIntent.js +76 -0
  482. package/dist/cli/vault/passImport.d.ts +25 -0
  483. package/dist/cli/vault/passImport.js +129 -0
  484. package/dist/cli/vault/passOtp.d.ts +51 -0
  485. package/dist/cli/vault/passOtp.js +101 -0
  486. package/dist/cli/vault/passStore.d.ts +26 -0
  487. package/dist/cli/vault/passStore.js +134 -0
  488. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  489. package/dist/cli/vault/passwordCommand.js +101 -0
  490. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  491. package/dist/cli/vault/passwordProbe.js +282 -0
  492. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  493. package/dist/cli/vault/passwordRotation.js +273 -0
  494. package/dist/cli/vault/rotationApi.d.ts +13 -0
  495. package/dist/cli/vault/rotationApi.js +58 -0
  496. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  497. package/dist/cli/vault/rotationCommand.js +75 -0
  498. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  499. package/dist/cli/vault/rotationEngine.js +65 -0
  500. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  501. package/dist/cli/vault/rotationHelperSource.js +3 -0
  502. package/dist/cli/vault/rotationInput.d.ts +11 -0
  503. package/dist/cli/vault/rotationInput.js +48 -0
  504. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  505. package/dist/cli/vault/rotationJournal.js +183 -0
  506. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  507. package/dist/cli/vault/rotationKeys.js +48 -0
  508. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  509. package/dist/cli/vault/rotationPrepare.js +108 -0
  510. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  511. package/dist/cli/vault/rotationRemote.js +156 -0
  512. package/dist/cli/vault/rotationState.d.ts +42 -0
  513. package/dist/cli/vault/rotationState.js +115 -0
  514. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  515. package/dist/cli/vault/rotationTransport.js +71 -0
  516. package/dist/cli/vault/sshSource.d.ts +18 -0
  517. package/dist/cli/vault/sshSource.js +196 -0
  518. package/dist/cli/vault/sshSync.d.ts +17 -0
  519. package/dist/cli/vault/sshSync.js +224 -0
  520. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  521. package/dist/cli/vault/sshTransfer.js +140 -0
  522. package/dist/cli/vault/terraformState.d.ts +66 -0
  523. package/dist/cli/vault/terraformState.js +252 -0
  524. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  525. package/dist/cli/vault/terraformStateCommand.js +61 -0
  526. package/dist/cli/vault/tree.d.ts +43 -0
  527. package/dist/cli/vault/tree.js +292 -0
  528. package/dist/cli/version.d.ts +1 -0
  529. package/dist/cli/version.js +9 -0
  530. package/dist/cli/workflow/index.d.ts +76 -0
  531. package/dist/cli/workflow/index.js +826 -0
  532. package/dist/cli/workflow/validate.d.ts +19 -0
  533. package/dist/cli/workflow/validate.js +353 -0
  534. package/dist/package.json +1 -0
  535. package/package.json +28 -10
@@ -0,0 +1,22 @@
1
+ import { type SshItem } from './sshSource.js';
2
+ export interface Transfer {
3
+ item: SshItem;
4
+ name: string;
5
+ revision?: number;
6
+ status: 'pending' | 'success' | 'failure' | 'unknown';
7
+ detail: string;
8
+ value?: string | Record<string, string>;
9
+ }
10
+ export type VaultCall = (path: string, body?: unknown, method?: string, revision?: number) => Promise<any>;
11
+ export declare function boundVault(remote: string, token: string): VaultCall;
12
+ export declare function validateKey(value: string): void;
13
+ export declare function prepareTransfers(transfers: Transfer[]): Promise<void>;
14
+ export declare function transferSelected(transfers: Transfer[], call: VaultCall, cancelled?: () => boolean): Promise<void>;
15
+ export declare function transferReport(transfers: Transfer[]): {
16
+ status: "unknown" | "success" | "pending" | "failure";
17
+ detail: string;
18
+ ifMatch?: number | undefined;
19
+ id: string;
20
+ kind: "profile" | "private-key";
21
+ name: string;
22
+ }[];
@@ -0,0 +1,140 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { request, VaultRequestError } from './index.js';
3
+ import { validateEntries } from './format.js';
4
+ import { secretValue } from './mutations.js';
5
+ import { readSshFile } from './sshSource.js';
6
+ export function boundVault(remote, token) {
7
+ return (path, body, method, revision) => request(path, body, method, revision, {}, { remote, token });
8
+ }
9
+ export function validateKey(value) {
10
+ // No conversion or trimming: encrypted PEM/OpenSSH keys are uploaded byte-for-byte.
11
+ const match = /^-----BEGIN (OPENSSH PRIVATE KEY|RSA PRIVATE KEY|EC PRIVATE KEY|DSA PRIVATE KEY|PRIVATE KEY|ENCRYPTED PRIVATE KEY)-----\r?\n([\s\S]+)\r?\n-----END \1-----(?:\r?\n)*$/.exec(value);
12
+ if (!match)
13
+ throw new Error('Selected file is not a supported private-key envelope');
14
+ if (match[1] === 'OPENSSH PRIVATE KEY') {
15
+ const payload = match[2].replace(/\s/g, '');
16
+ if (!/^[A-Za-z0-9+/]+={0,2}$/.test(payload))
17
+ throw new Error('Invalid OpenSSH private-key envelope');
18
+ const data = Buffer.from(payload, 'base64');
19
+ try {
20
+ if (data.subarray(0, 15).toString() !== 'openssh-key-v1\0')
21
+ throw new Error();
22
+ let offset = 15;
23
+ const field = () => { const size = data.readUInt32BE(offset); offset += 4; if (size > data.length - offset)
24
+ throw new Error(); const bytes = data.subarray(offset, offset + size); offset += size; return bytes; };
25
+ field();
26
+ field();
27
+ field();
28
+ if (data.readUInt32BE(offset) !== 1)
29
+ throw new Error();
30
+ offset += 4;
31
+ const pub = field();
32
+ const typeLength = pub.readUInt32BE(0);
33
+ if (typeLength > pub.length - 4 || pub.subarray(4, 4 + typeLength).toString().startsWith('sk-'))
34
+ throw new Error();
35
+ field();
36
+ if (offset !== data.length)
37
+ throw new Error();
38
+ }
39
+ catch {
40
+ throw new Error('Hardware-backed or invalid OpenSSH key; retain its reference');
41
+ }
42
+ finally {
43
+ data.fill(0);
44
+ }
45
+ }
46
+ }
47
+ export async function prepareTransfers(transfers) {
48
+ // Read only selected keys, once, after destination consent; prepare before any writes.
49
+ for (const transfer of transfers) {
50
+ if (transfer.status === 'success' || transfer.value !== undefined)
51
+ continue;
52
+ try {
53
+ const value = transfer.item.kind === 'profile' ? transfer.item.profile : await readSshFile(transfer.item.keyPath, true);
54
+ if (typeof value === 'string')
55
+ validateKey(value);
56
+ transfer.value = secretValue(value instanceof Object ? JSON.stringify(value) : value, typeof value !== 'string');
57
+ }
58
+ catch {
59
+ transfer.status = 'failure';
60
+ transfer.detail = 'Selected source unavailable, unsafe, unsupported or too large; no write attempted';
61
+ }
62
+ }
63
+ }
64
+ function metadata(result, name) {
65
+ validateEntries([result?.entry]);
66
+ const entry = result.entry;
67
+ if (entry.name !== name || entry.type !== 'string' || !Number.isSafeInteger(entry.revision) || entry.revision < 1)
68
+ throw new Error('Invalid vault response');
69
+ return entry;
70
+ }
71
+ async function inspect(transfer, call) {
72
+ let meta;
73
+ try {
74
+ meta = metadata(await call(`/v1/vault/entry?name=${encodeURIComponent(transfer.name)}`), transfer.name);
75
+ }
76
+ catch (error) {
77
+ if (error instanceof VaultRequestError && error.status === 404)
78
+ return 'absent';
79
+ throw error;
80
+ }
81
+ if (meta.deleteAt || meta.expiresAt && Date.parse(meta.expiresAt) <= Date.now())
82
+ return 'different';
83
+ const result = await call('/v1/vault/entries/read', { selectors: [transfer.name] });
84
+ validateEntries(result?.entries, true);
85
+ if (result.entries.length !== 1 || result.entries[0].name !== transfer.name || result.entries[0].type !== 'string')
86
+ throw new Error('Invalid vault response');
87
+ // A matching current value makes the desired state observable. This does not
88
+ // prove which client wrote it and is not an idempotency receipt.
89
+ return isDeepStrictEqual(result.entries[0].value, transfer.value) ? 'equal' : 'different';
90
+ }
91
+ export async function transferSelected(transfers, call, cancelled = () => false) {
92
+ for (const transfer of transfers) {
93
+ if (cancelled())
94
+ break;
95
+ if (transfer.status === 'success' || transfer.value === undefined)
96
+ continue;
97
+ const wasUnknown = transfer.status === 'unknown';
98
+ let writing = false;
99
+ try {
100
+ const state = await inspect(transfer, call);
101
+ if (cancelled())
102
+ break;
103
+ if (state === 'equal') {
104
+ transfer.status = 'success';
105
+ transfer.detail = 'Destination verified equal; no additional write';
106
+ continue;
107
+ }
108
+ if (wasUnknown) {
109
+ transfer.detail = 'Write remains unknown; backend has no entry operation receipt. No replay attempted';
110
+ continue;
111
+ }
112
+ if (state === 'different' && transfer.revision === undefined) {
113
+ transfer.status = 'failure';
114
+ transfer.detail = 'Destination exists and differs; explicit --if-match item=revision required';
115
+ continue;
116
+ }
117
+ // No If-Match means create-only on the existing vault API. A supplied
118
+ // revision is never refreshed automatically, including on retry.
119
+ writing = true;
120
+ const meta = metadata(await call('/v1/vault/entry', { name: transfer.name, type: 'string', value: transfer.value }, 'PUT', transfer.revision), transfer.name);
121
+ if (meta.deleteAt || meta.revision !== (transfer.revision === undefined ? 1 : transfer.revision + 1))
122
+ throw new Error('Invalid vault response');
123
+ transfer.status = 'success';
124
+ transfer.detail = `Saved revision ${meta.revision}`;
125
+ }
126
+ catch (error) {
127
+ const status = error instanceof VaultRequestError ? error.status : undefined;
128
+ // A transport error, malformed acknowledgement, timeout or server error
129
+ // during PUT can follow a committed write. Only explicit rejection is failure.
130
+ const rejected = status !== undefined && [400, 401, 403, 404, 405, 409, 412, 413, 422, 429, 501].includes(status);
131
+ transfer.status = wasUnknown || writing && !rejected ? 'unknown' : 'failure';
132
+ transfer.detail = status === 404 || status === 405 || status === 501 ? 'Required vault API unavailable; no alternative upload supported' :
133
+ transfer.status === 'unknown' ? 'Write outcome unknown; retry reconciles only, without replay' :
134
+ status === 409 || status === 412 ? 'Revision or destination conflict; no automatic overwrite' : 'Vault operation failed; response details redacted';
135
+ }
136
+ }
137
+ }
138
+ export function transferReport(transfers) {
139
+ return transfers.map(({ item, name, revision, status, detail }) => ({ id: item.id, kind: item.kind, name, ...(revision === undefined ? {} : { ifMatch: revision }), status, detail }));
140
+ }
@@ -0,0 +1,66 @@
1
+ import { request } from './index.js';
2
+ export type TerraformVaultCall = typeof request;
3
+ export declare const SNAPSHOT_SCHEMA = "dreamlake-terraform-snapshot-v1";
4
+ export declare const BACKEND_SCHEMA = "dreamlake-terraform-backend-reference-v1";
5
+ export interface StateMetadata {
6
+ lineage: string;
7
+ serial: number;
8
+ sha256: string;
9
+ bytes: number;
10
+ }
11
+ export interface StateSnapshot extends StateMetadata {
12
+ schema: typeof SNAPSHOT_SCHEMA;
13
+ encoding: 'base64';
14
+ data: string;
15
+ }
16
+ export interface BackendReference {
17
+ schema: typeof BACKEND_SCHEMA;
18
+ backend: 's3';
19
+ bucket: string;
20
+ key: string;
21
+ region: string;
22
+ expectedBucketOwner: string;
23
+ useLockfile: true;
24
+ versioning: true;
25
+ encrypt: true;
26
+ credentialRef: string;
27
+ kmsKeyArn?: string;
28
+ }
29
+ export interface PreparedEntry {
30
+ name: string;
31
+ value: string;
32
+ metadata: StateMetadata | BackendReference;
33
+ }
34
+ export declare function stateMetadata(value: string): StateMetadata;
35
+ export declare function snapshotValue(value: string): {
36
+ value: string;
37
+ metadata: StateMetadata;
38
+ };
39
+ export declare function decodeSnapshot(value: string): {
40
+ state: string;
41
+ metadata: StateMetadata;
42
+ };
43
+ export declare function selectedState(file: string): Promise<string>;
44
+ export declare function prepareSnapshot(file: string, prefix: string): Promise<PreparedEntry>;
45
+ export declare function backendReference(value: string): BackendReference;
46
+ export declare function prepareBackendReference(file: string, name: string): Promise<PreparedEntry>;
47
+ export interface WriteResult {
48
+ name: string;
49
+ requestId: string;
50
+ status: 'created-verified' | 'existing-verified' | 'recovered-verified' | 'conflict' | 'unavailable' | 'unknown';
51
+ revision?: number;
52
+ complete: boolean;
53
+ }
54
+ /** Create only. A receipt and matching readback prove a point-in-time copy, not a Terraform lock or immutable server object. */
55
+ export declare function saveTerraformEntry(prepared: PreparedEntry, id: string, call?: TerraformVaultCall): Promise<WriteResult>;
56
+ export declare function compareRestore(snapshot: StateMetadata, current: StateMetadata): void;
57
+ export declare function writeSnapshotFile(to: string, value: string): Promise<void>;
58
+ export declare function restoreTerraformSnapshot(name: string, revision: number, currentFile: string, to: string, apply: boolean, call?: TerraformVaultCall): Promise<{
59
+ name: string;
60
+ revision: number;
61
+ snapshot: StateMetadata;
62
+ comparison: StateMetadata;
63
+ restored: boolean;
64
+ destination: string;
65
+ authoritativeBackendChanged: boolean;
66
+ }>;
@@ -0,0 +1,252 @@
1
+ import { createHash, randomUUID } from 'node:crypto';
2
+ import { constants } from 'node:fs';
3
+ import { lstat, open, realpath, link, unlink } from 'node:fs/promises';
4
+ import { basename, dirname, join, resolve, sep } from 'node:path';
5
+ import { request, VaultRequestError } from './index.js';
6
+ import { validateEntries } from './format.js';
7
+ import { entryName, secretValue, writeReceipt, writeRequestId } from './mutations.js';
8
+ import { readSshFile } from './sshSource.js';
9
+ export const SNAPSHOT_SCHEMA = 'dreamlake-terraform-snapshot-v1';
10
+ export const BACKEND_SCHEMA = 'dreamlake-terraform-backend-reference-v1';
11
+ const hash = (value) => createHash('sha256').update(value, 'utf8').digest('hex');
12
+ const UUID = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/;
13
+ function json(value) { try {
14
+ return JSON.parse(value);
15
+ }
16
+ catch {
17
+ throw new Error('Invalid selected JSON');
18
+ } }
19
+ function object(value) { return !!value && typeof value === 'object' && !Array.isArray(value); }
20
+ export function stateMetadata(value) {
21
+ if (Buffer.byteLength(value) > 65536)
22
+ throw new Error('Selected state exceeds size limit');
23
+ const state = json(value);
24
+ if (!object(state) || state.version !== 4 || typeof state.lineage !== 'string' || !UUID.test(state.lineage) || !Number.isSafeInteger(state.serial) || state.serial < 0 ||
25
+ !object(state.outputs) || !Array.isArray(state.resources) || typeof state.terraform_version !== 'string' || !/^\d+\.\d+\.\d+(?:[-+][A-Za-z0-9.-]+)?$/.test(state.terraform_version)) {
26
+ throw new Error('Selected state requires Terraform format 4, UUID lineage, nonnegative safe serial, outputs and resources');
27
+ }
28
+ return { lineage: state.lineage, serial: state.serial, sha256: hash(value), bytes: Buffer.byteLength(value) };
29
+ }
30
+ export function snapshotValue(value) {
31
+ const metadata = stateMetadata(value);
32
+ const envelope = { schema: SNAPSHOT_SCHEMA, ...metadata, encoding: 'base64', data: Buffer.from(value, 'utf8').toString('base64') };
33
+ const encoded = JSON.stringify(envelope);
34
+ secretValue(encoded); // Existing Vault cap applies to JSON-string-escaped envelope, not raw state size.
35
+ return { value: encoded, metadata };
36
+ }
37
+ export function decodeSnapshot(value) {
38
+ secretValue(value);
39
+ const data = json(value);
40
+ if (!object(data) || Object.keys(data).sort().join(',') !== 'bytes,data,encoding,lineage,schema,serial,sha256' || data.schema !== SNAPSHOT_SCHEMA || data.encoding !== 'base64' || typeof data.data !== 'string' || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(data.data))
41
+ throw new Error('Invalid snapshot envelope');
42
+ let state;
43
+ try {
44
+ state = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(Buffer.from(data.data, 'base64'));
45
+ }
46
+ catch {
47
+ throw new Error('Invalid snapshot encoding');
48
+ }
49
+ const metadata = stateMetadata(state);
50
+ if (metadata.lineage !== data.lineage || metadata.serial !== data.serial || metadata.sha256 !== data.sha256 || metadata.bytes !== data.bytes || Buffer.from(state, 'utf8').toString('base64') !== data.data)
51
+ throw new Error('Snapshot integrity mismatch');
52
+ return { state, metadata };
53
+ }
54
+ export async function selectedState(file) {
55
+ if (process.platform === 'win32' || typeof process.getuid !== 'function')
56
+ throw new Error('Private state selection requires POSIX ownership and permissions');
57
+ try {
58
+ return await readSshFile(resolve(file), true);
59
+ }
60
+ catch {
61
+ throw new Error('Selected state must be an owned, owner-only, bounded regular UTF-8 file without links');
62
+ }
63
+ }
64
+ export async function prepareSnapshot(file, prefix) {
65
+ if (!prefix)
66
+ throw new Error('Snapshot requires explicit --prefix');
67
+ entryName('probe', prefix);
68
+ const snapshot = snapshotValue(await selectedState(file));
69
+ return { name: entryName(`state-${snapshot.metadata.sha256}`, prefix), ...snapshot };
70
+ }
71
+ export function backendReference(value) {
72
+ const data = json(value);
73
+ const keys = ['schema', 'backend', 'bucket', 'key', 'region', 'expectedBucketOwner', 'useLockfile', 'versioning', 'encrypt', 'credentialRef', 'kmsKeyArn'];
74
+ if (!object(data) || Object.keys(data).some(key => !keys.includes(key)) || data.schema !== BACKEND_SCHEMA || data.backend !== 's3' ||
75
+ typeof data.bucket !== 'string' || !/^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$/.test(data.bucket) || data.bucket.includes('..') || /^\d+\.\d+\.\d+\.\d+$/.test(data.bucket) ||
76
+ typeof data.key !== 'string' || !/^[A-Za-z0-9_-][A-Za-z0-9_./-]{0,1023}$/.test(data.key) || data.key.split('/').some((part) => !part || part === '.' || part === '..') ||
77
+ typeof data.region !== 'string' || !/^[a-z]{2}(?:-[a-z]+)+-\d$/.test(data.region) ||
78
+ typeof data.expectedBucketOwner !== 'string' || !/^\d{12}$/.test(data.expectedBucketOwner) ||
79
+ data.useLockfile !== true || data.versioning !== true || data.encrypt !== true || typeof data.credentialRef !== 'string' ||
80
+ (data.kmsKeyArn !== undefined && (typeof data.kmsKeyArn !== 'string' || !/^arn:aws(?:-us-gov|-cn)?:kms:[a-z0-9-]+:\d{12}:key\/[a-f0-9-]{36}$/.test(data.kmsKeyArn))))
81
+ throw new Error('Invalid nonsecret S3 backend reference; require locking, versioning, encryption and credential reference');
82
+ if (entryName(data.credentialRef) !== data.credentialRef)
83
+ throw new Error('Credential reference must be a canonical Vault entry path');
84
+ return { schema: BACKEND_SCHEMA, backend: 's3', bucket: data.bucket, key: data.key, region: data.region, expectedBucketOwner: data.expectedBucketOwner, useLockfile: true, versioning: true, encrypt: true, credentialRef: data.credentialRef, ...(data.kmsKeyArn === undefined ? {} : { kmsKeyArn: data.kmsKeyArn }) };
85
+ }
86
+ export async function prepareBackendReference(file, name) {
87
+ const metadata = backendReference(await selectedState(file));
88
+ const value = JSON.stringify(metadata);
89
+ secretValue(value);
90
+ return { name: entryName(name), value, metadata };
91
+ }
92
+ function activeEntry(entry, name, revision) {
93
+ validateEntries([entry]);
94
+ if (entry.name !== name || entry.type !== 'string' || !Number.isSafeInteger(entry.revision) || entry.revision < 1 || (revision !== undefined && entry.revision !== revision) || entry.deleteAt || entry.expiresAt)
95
+ throw new Error('Vault entry unavailable, expiring or revision changed');
96
+ return entry;
97
+ }
98
+ async function readEntry(name, revision, call) {
99
+ const response = await call('/v1/vault/entries/read', { selectors: [name] });
100
+ validateEntries(response?.entries, true);
101
+ if (response.entries.length !== 1)
102
+ throw new Error('Invalid Vault readback');
103
+ const entry = activeEntry(response.entries[0], name, revision);
104
+ if (typeof entry.value !== 'string')
105
+ throw new Error('Invalid Vault readback');
106
+ secretValue(entry.value);
107
+ return entry.value;
108
+ }
109
+ /** Create only. A receipt and matching readback prove a point-in-time copy, not a Terraform lock or immutable server object. */
110
+ export async function saveTerraformEntry(prepared, id, call = request) {
111
+ const name = entryName(prepared.name);
112
+ writeRequestId(id);
113
+ secretValue(prepared.value);
114
+ const result = (status, revision) => ({ name, requestId: id, status, ...(revision === undefined ? {} : { revision }), complete: status.endsWith('-verified') });
115
+ let sent = false;
116
+ try {
117
+ let recovered, receiptFound = false;
118
+ try {
119
+ recovered = await call(`/v1/vault/write-operations/${id}`);
120
+ receiptFound = true;
121
+ }
122
+ catch (error) {
123
+ if (!(error instanceof VaultRequestError && error.status === 404))
124
+ throw error;
125
+ }
126
+ if (receiptFound) {
127
+ const receipt = writeReceipt(recovered, id), entry = activeEntry(receipt.entry, name, 1);
128
+ if (await readEntry(name, entry.revision, call) !== prepared.value)
129
+ return result('conflict');
130
+ return result('recovered-verified', entry.revision);
131
+ }
132
+ let existing;
133
+ try {
134
+ existing = activeEntry((await call(`/v1/vault/entry?name=${encodeURIComponent(name)}`)).entry, name);
135
+ }
136
+ catch (error) {
137
+ if (!(error instanceof VaultRequestError && error.status === 404))
138
+ throw error;
139
+ }
140
+ if (existing) {
141
+ // Never accept a rewritten content-addressed entry, even if someone restored identical bytes.
142
+ if (existing.revision !== 1 || await readEntry(name, existing.revision, call) !== prepared.value)
143
+ return result('conflict');
144
+ return result('existing-verified', existing.revision);
145
+ }
146
+ sent = true;
147
+ const response = await call('/v1/vault/entry', { name, type: 'string', value: prepared.value }, 'PUT', undefined, { 'Idempotency-Key': id });
148
+ const receipt = writeReceipt(response, id), entry = activeEntry(receipt.entry, name, 1);
149
+ if (typeof response.replayed !== 'boolean' || await readEntry(name, entry.revision, call) !== prepared.value)
150
+ return result('unknown');
151
+ return result(response.replayed ? 'recovered-verified' : 'created-verified', entry.revision);
152
+ }
153
+ catch (error) {
154
+ const code = error instanceof VaultRequestError ? error.status : undefined;
155
+ // No retry, fallback upload or response diagnostics; errors may follow a commit.
156
+ return result(sent ? 'unknown' : code === 409 || code === 412 ? 'conflict' : 'unavailable');
157
+ }
158
+ }
159
+ export function compareRestore(snapshot, current) {
160
+ if (snapshot.lineage !== current.lineage)
161
+ throw new Error('Foreign-lineage restore refused');
162
+ if (snapshot.serial < current.serial)
163
+ throw new Error('Newer current state prevents rollback');
164
+ if (snapshot.serial === current.serial && snapshot.sha256 !== current.sha256)
165
+ throw new Error('Equal-serial divergent state refused');
166
+ }
167
+ async function restoreDestination(to) {
168
+ const target = resolve(to), parent = dirname(target);
169
+ if (process.platform === 'win32' || typeof process.getuid !== 'function' || !/^[A-Za-z0-9_-]+\.snapshot\.json$/.test(basename(target)) || target.split(sep).includes('.terraform'))
170
+ throw new Error('Restore requires a new *.snapshot.json file outside .terraform');
171
+ try {
172
+ if (await realpath(parent) !== parent)
173
+ throw new Error();
174
+ const directory = await lstat(parent);
175
+ if (!directory.isDirectory() || directory.uid !== process.getuid() || (directory.mode & 0o077) !== 0)
176
+ throw new Error();
177
+ try {
178
+ await lstat(target);
179
+ throw new Error('exists');
180
+ }
181
+ catch (error) {
182
+ if (error.code !== 'ENOENT')
183
+ throw error;
184
+ }
185
+ return { target, parent, directory };
186
+ }
187
+ catch {
188
+ throw new Error('Restore requires an absent output in an owned mode-0700 directory without symlinks');
189
+ }
190
+ }
191
+ export async function writeSnapshotFile(to, value) {
192
+ const before = await restoreDestination(to);
193
+ const temporary = join(before.parent, `.dreamlake-snapshot-${randomUUID()}`);
194
+ let created = false;
195
+ try {
196
+ const file = await open(temporary, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
197
+ created = true;
198
+ try {
199
+ await file.chmod(0o600);
200
+ await file.writeFile(value, 'utf8');
201
+ await file.sync();
202
+ }
203
+ finally {
204
+ await file.close();
205
+ }
206
+ const after = await restoreDestination(to);
207
+ if (after.directory.ino !== before.directory.ino || after.directory.dev !== before.directory.dev)
208
+ throw new Error('Restore directory changed');
209
+ await link(temporary, before.target); // atomic no-overwrite publication, including a competing destination creator
210
+ const directory = await open(before.parent, constants.O_RDONLY | constants.O_NOFOLLOW);
211
+ try {
212
+ await directory.sync();
213
+ }
214
+ finally {
215
+ await directory.close();
216
+ }
217
+ }
218
+ catch {
219
+ throw new Error('Isolated restore failed; inspect selected destination before retrying');
220
+ }
221
+ finally {
222
+ if (created) {
223
+ try {
224
+ await unlink(temporary);
225
+ }
226
+ catch {
227
+ throw new Error('Restore cleanup uncertain; inspect selected destination');
228
+ }
229
+ }
230
+ }
231
+ }
232
+ export async function restoreTerraformSnapshot(name, revision, currentFile, to, apply, call = request) {
233
+ name = entryName(name);
234
+ if (!Number.isSafeInteger(revision) || revision !== 1)
235
+ throw new Error('Snapshot restore requires original Vault revision 1');
236
+ const target = await restoreDestination(to);
237
+ const currentValue = await selectedState(currentFile), current = stateMetadata(currentValue);
238
+ activeEntry((await call(`/v1/vault/entry?name=${encodeURIComponent(name)}`)).entry, name, revision);
239
+ const envelope = await readEntry(name, revision, call);
240
+ const snapshot = decodeSnapshot(envelope);
241
+ if (name.split('/').at(-1) !== `state-${snapshot.metadata.sha256}`)
242
+ throw new Error('Snapshot name integrity mismatch');
243
+ compareRestore(snapshot.metadata, current);
244
+ const preview = { name, revision, snapshot: snapshot.metadata, comparison: current, restored: false, destination: target.target, authoritativeBackendChanged: false };
245
+ if (!apply)
246
+ return preview;
247
+ // Recheck selected comparison and entry immediately before local publication; this is not a backend lock.
248
+ if (await readEntry(name, revision, call) !== envelope || await selectedState(currentFile) !== currentValue)
249
+ throw new Error('Comparison or snapshot changed; preview again');
250
+ await writeSnapshotFile(to, snapshot.state);
251
+ return { ...preview, restored: true };
252
+ }
@@ -0,0 +1,2 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerTerraformState(vault: Command): void;
@@ -0,0 +1,61 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { collectPrefix, invocationPrefix } from './index.js';
3
+ import { entryName, revisionNumber, writeRequestId } from './mutations.js';
4
+ import { prepareBackendReference, prepareSnapshot, restoreTerraformSnapshot, saveTerraformEntry } from './terraformState.js';
5
+ export function registerTerraformState(vault) {
6
+ const terraform = vault.command('terraform').description('explicit backend references and encrypted-at-rest state snapshots; not an active Terraform backend');
7
+ for (const action of ['backend', 'backup']) {
8
+ const command = terraform.command(action).description(action === 'backend' ? 'preview or save a selected nonsecret S3 backend reference (does not configure AWS)' : 'preview or save one explicitly selected format-4 state snapshot; never scan')
9
+ .requiredOption('--file <path>', 'explicit owner-only regular JSON file, no links; serialized envelope <=64 KiB')
10
+ .option('-p, --prefix <prefix>', 'explicit Vault destination prefix', collectPrefix)
11
+ .option('--apply', 'create and verify selected Vault entry; otherwise local preview only')
12
+ .option('--request-id <id>', 'stable nonsecret write ID for identical-input recovery within 30 days');
13
+ if (action === 'backend')
14
+ command.requiredOption('--name <name>', 'new backend-reference entry path');
15
+ command.action(async (options, cmd) => {
16
+ try {
17
+ if (options.requestId && !options.apply)
18
+ throw new Error();
19
+ const prefix = invocationPrefix(cmd);
20
+ const prepared = action === 'backup' ? await prepareSnapshot(options.file, prefix) : await prepareBackendReference(options.file, entryName(options.name, prefix));
21
+ const preview = { name: prepared.name, kind: action, metadata: prepared.metadata, uploaded: false, authoritativeBackendChanged: false, backendSettingsVerified: false };
22
+ if (!options.apply) {
23
+ process.stdout.write(JSON.stringify(preview, null, 2) + '\n');
24
+ return;
25
+ }
26
+ const id = writeRequestId(options.requestId ?? randomUUID());
27
+ process.stderr.write(JSON.stringify({ requestId: id, name: prepared.name }) + '\n');
28
+ const result = await saveTerraformEntry(prepared, id);
29
+ process.stdout.write(JSON.stringify({ ...result, authoritativeBackendChanged: false }, null, 2) + '\n');
30
+ if (!result.complete) {
31
+ process.stderr.write('Vault snapshot/reference not verified. Reconcile vault write-status with the same request ID; missing status does not prove failure. Retry only identical input within original 30-day receipt retention. No fallback upload or overwrite.\n');
32
+ process.exitCode = 1;
33
+ }
34
+ }
35
+ catch {
36
+ process.stderr.write('Terraform Vault selection failed. Check explicit file, owner-only permissions, format, size, prefix and request ID. No secret contents logged.\n');
37
+ process.exitCode = 1;
38
+ }
39
+ });
40
+ }
41
+ terraform.command('restore').description('preview or restore a verified snapshot to a new isolated file; never overwrite or push state')
42
+ .requiredOption('--name <name>', 'content-addressed snapshot Vault entry')
43
+ .option('-p, --prefix <prefix>', 'Vault prefix', collectPrefix)
44
+ .requiredOption('--if-match <revision>', 'original Vault entry revision (1)')
45
+ .requiredOption('--current-state <path>', 'explicit owner-only current comparison export; not proof of backend freshness')
46
+ .requiredOption('--to <path>', 'new *.snapshot.json in an owned mode-0700 directory outside .terraform')
47
+ .option('--apply', 'write only the new local snapshot file; otherwise read-only preview')
48
+ .action(async (options, command) => {
49
+ try {
50
+ const revision = revisionNumber(options.ifMatch);
51
+ if (revision === undefined)
52
+ throw new Error();
53
+ const result = await restoreTerraformSnapshot(entryName(options.name, invocationPrefix(command)), revision, options.currentState, options.to, !!options.apply);
54
+ process.stdout.write(JSON.stringify(result, null, 2) + '\n');
55
+ }
56
+ catch {
57
+ process.stderr.write('Terraform snapshot restore refused: check original revision, integrity, current comparison lineage/serial, and new private destination. No backend state changed. If --apply was used, inspect destination before retrying.\n');
58
+ process.exitCode = 1;
59
+ }
60
+ });
61
+ }
@@ -0,0 +1,43 @@
1
+ export type TreeRow = {
2
+ kind: "prefix" | "entry";
3
+ path: string;
4
+ parentPath: string | null;
5
+ entry?: Record<string, unknown>;
6
+ policy: {
7
+ state: "known" | "unknown" | "unavailable";
8
+ reason: string | null;
9
+ governingPrefix: string | null;
10
+ keyRef: string | null;
11
+ keyId: string | null;
12
+ provider: string | null;
13
+ epoch: string | null;
14
+ migration: {
15
+ state: string;
16
+ requestId: string | null;
17
+ };
18
+ };
19
+ };
20
+ export type TreePage = {
21
+ schemaVersion: 1;
22
+ prefix: string;
23
+ observedAt: string;
24
+ rows: TreeRow[];
25
+ nextCursor: string | null;
26
+ };
27
+ export declare function validateTree(value: any, prefix: string, limit: number): TreePage;
28
+ export declare function treeReader(prefix: string): (options?: {
29
+ limit?: string;
30
+ cursor?: string;
31
+ }) => Promise<TreePage>;
32
+ /** Escape controls including ANSI/OSC; metadata is never interpreted as terminal commands. */
33
+ export declare const governingLabel: (policy: TreeRow["policy"]) => string;
34
+ export declare const terminalText: (v: unknown) => string;
35
+ /** The existing preview is a counts/blockers observation, never a write permit. */
36
+ export declare function policyPreviewReader(keyRef: string | undefined): (row: TreeRow) => Promise<Record<string, unknown>>;
37
+ export declare function previewLines(view: Record<string, unknown>): string[];
38
+ export declare function showTree(prefix: string, options: {
39
+ limit?: string;
40
+ cursor?: string;
41
+ toJson?: boolean;
42
+ previewKey?: string;
43
+ }): Promise<void>;