@dreamlake/dreamlake-cli 0.88.0 → 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,35 @@
1
+ import { type JsonResult } from '../compat/http.js';
2
+ import { type UploadItem } from './push.js';
3
+ export declare function libraryGenerationRequired(base: string, token: string): Promise<boolean>;
4
+ /** Copy authorized carried generated objects into the local build cache. New
5
+ * generations need a complete closure; the legacy differential set is unsafe. */
6
+ export declare function stageCarriedGenerationFiles(base: string, token: string, paths: string[], cacheDir: string, fetchFn?: typeof fetch): Promise<(UploadItem & {
7
+ absPath: string;
8
+ })[]>;
9
+ /** The local journal stores signed URLs, so it is private and atomically
10
+ * replaced. It binds one stable session to the exact full upload intent. */
11
+ export declare function publishLibraryGeneration(input: {
12
+ base: string;
13
+ token: string;
14
+ uploads: UploadItem[];
15
+ localPath: (file: UploadItem) => string;
16
+ cacheDir: string;
17
+ expectedRevision: number;
18
+ visibility?: string;
19
+ fetchFn?: typeof fetch;
20
+ onFileDone?: (bytes: number) => void;
21
+ }): Promise<JsonResult>;
22
+ /** Remote add/rm edits must also publish a complete isolated generation. */
23
+ export declare function publishLibraryManifestGeneration(input: {
24
+ base: string;
25
+ token: string;
26
+ manifest: import('./manifest.js').LibraryManifest;
27
+ manifestFile: {
28
+ abs: string;
29
+ size: number;
30
+ };
31
+ localByRel: Map<string, string>;
32
+ cacheDir: string;
33
+ expectedRevision: number;
34
+ fetchFn?: typeof fetch;
35
+ }): Promise<JsonResult>;
@@ -0,0 +1,211 @@
1
+ import { copyFile } from 'node:fs/promises';
2
+ import { createHash, randomUUID } from 'node:crypto';
3
+ import { createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
4
+ import path from 'node:path';
5
+ import { Readable } from 'node:stream';
6
+ import { pipeline } from 'node:stream/promises';
7
+ import { errorMessage, jsonRequest } from '../compat/http.js';
8
+ import { executePresignedBatch, isRecord } from '../compat/presignedTransfer.js';
9
+ import { sha256File } from './manifest.js';
10
+ import { assertLibraryAuthorization, planBatches } from './push.js';
11
+ export async function libraryGenerationRequired(base, token) {
12
+ const response = await jsonRequest('GET', base + '/upload-capabilities', token);
13
+ if (response.status === 404)
14
+ return false; // older server, before activation
15
+ if (response.status !== 200)
16
+ throw new Error(`upload-capabilities → ${response.status}: ${errorMessage(response)}`);
17
+ const caps = response.body;
18
+ if (!isRecord(caps) || caps.apiVersion !== 2 || typeof caps.requiresSession !== 'boolean' || typeof caps.legacyUploadEnabled !== 'boolean')
19
+ throw new Error('incompatible library upload capabilities');
20
+ if (caps.requiresSession) {
21
+ if (caps.protocolVersion !== 2)
22
+ throw new Error('incompatible required Library session protocol');
23
+ return true;
24
+ }
25
+ if (caps.protocolVersion !== 1 || caps.legacyUploadEnabled !== true)
26
+ throw new Error('Library server refuses legacy upload');
27
+ return false;
28
+ }
29
+ /** Copy authorized carried generated objects into the local build cache. New
30
+ * generations need a complete closure; the legacy differential set is unsafe. */
31
+ export async function stageCarriedGenerationFiles(base, token, paths, cacheDir, fetchFn = fetch) {
32
+ const staged = [];
33
+ mkdirSync(cacheDir, { recursive: true, mode: 0o700 });
34
+ for (let offset = 0; offset < paths.length; offset += 1000) {
35
+ const wanted = paths.slice(offset, offset + 1000), res = await jsonRequest('POST', base + '/files-presign', token, { paths: wanted, ttlSeconds: 3600 });
36
+ if (res.status !== 200 || !isRecord(res.body) || !Array.isArray(res.body.files))
37
+ throw new Error(`cannot retain generated Library files: ${res.status}`);
38
+ const rows = new Map(res.body.files.map((r) => { if (!isRecord(r) || typeof r.path !== 'string' || typeof r.url !== 'string')
39
+ throw new Error('incompatible carried-file authorization'); return [r.path, r]; }));
40
+ // Bounded sequential downloads stream to disk; no whole-artifact buffering.
41
+ for (const rel of wanted) {
42
+ const row = rows.get(rel);
43
+ if (!row)
44
+ throw new Error(`missing carried-file authorization: ${rel}`);
45
+ const response = await fetchFn(row.url);
46
+ if (!response.ok || !response.body)
47
+ throw new Error(`cannot retain ${rel}: HTTP ${response.status}`);
48
+ const target = path.join(cacheDir, createHash('sha256').update(rel).digest('hex')), temporary = target + '.' + randomUUID() + '.part';
49
+ try {
50
+ await pipeline(Readable.fromWeb(response.body), createWriteStream(temporary, { mode: 0o600 }));
51
+ const size = statSync(temporary).size;
52
+ if (typeof row.size === 'number' && size !== row.size)
53
+ throw new Error(`carried-file size mismatch: ${rel}`);
54
+ if (typeof row.sha256 === 'string' && await sha256File(temporary) !== row.sha256)
55
+ throw new Error(`carried-file checksum mismatch: ${rel}`);
56
+ renameSync(temporary, target);
57
+ }
58
+ finally {
59
+ rmSync(temporary, { force: true });
60
+ }
61
+ staged.push({ relativePath: rel, size: statSync(target).size, absPath: target });
62
+ }
63
+ }
64
+ return staged;
65
+ }
66
+ const objectId = (value) => typeof value === 'string' && /^[a-f0-9]{24}$/.test(value);
67
+ function assertImmutable(file) {
68
+ const operation = file.transfer.kind === 'single-put' ? file.transfer.put : file.transfer.complete;
69
+ if (new Headers(operation.headers).get('if-none-match') !== '*')
70
+ throw new Error('Library generation authorization lacks immutable write condition');
71
+ }
72
+ /** The local journal stores signed URLs, so it is private and atomically
73
+ * replaced. It binds one stable session to the exact full upload intent. */
74
+ export async function publishLibraryGeneration(input) {
75
+ const planned = [];
76
+ for (const file of input.uploads)
77
+ planned.push({ ...file, sha256: await sha256File(input.localPath(file)) });
78
+ const fingerprint = createHash('sha256').update(JSON.stringify({ base: input.base, visibility: input.visibility ?? null, files: planned })).digest('hex');
79
+ const snapshot = path.join(input.cacheDir, `generation-${fingerprint}-files`);
80
+ mkdirSync(snapshot, { recursive: true, mode: 0o700 });
81
+ const localByPath = new Map();
82
+ for (const file of planned) {
83
+ const target = path.join(snapshot, createHash('sha256').update(file.relativePath).digest('hex'));
84
+ if (!existsSync(target) || await sha256File(target) !== file.sha256) {
85
+ const temporary = target + '.' + process.pid + '.tmp';
86
+ try {
87
+ await copyFile(input.localPath(file), temporary);
88
+ if (await sha256File(temporary) !== file.sha256)
89
+ throw new Error(`Library source changed while snapshotting: ${file.relativePath}`);
90
+ renameSync(temporary, target);
91
+ }
92
+ finally {
93
+ rmSync(temporary, { force: true });
94
+ }
95
+ }
96
+ localByPath.set(file.relativePath, target);
97
+ }
98
+ const localPath = (file) => localByPath.get(file.relativePath);
99
+ const cleanup = () => { rmSync(journal, { force: true }); rmSync(snapshot, { recursive: true, force: true }); };
100
+ const journal = path.join(input.cacheDir, `generation-${fingerprint}.json`);
101
+ let state = { version: 2, fingerprint, sessionKey: randomUUID(), expectedRevision: input.expectedRevision, plans: Object.create(null), parts: Object.create(null) };
102
+ if (existsSync(journal)) {
103
+ const saved = JSON.parse(readFileSync(journal, 'utf8'));
104
+ if (saved.version !== 2 || saved.fingerprint !== fingerprint || typeof saved.sessionKey !== 'string' || !isRecord(saved.plans) || !isRecord(saved.parts))
105
+ throw new Error('invalid Library generation recovery journal');
106
+ state = { ...saved, plans: Object.assign(Object.create(null), saved.plans), parts: Object.assign(Object.create(null), saved.parts) };
107
+ }
108
+ const save = () => { mkdirSync(input.cacheDir, { recursive: true, mode: 0o700 }); const temporary = journal + '.' + process.pid + '.tmp'; writeFileSync(temporary, JSON.stringify(state), { mode: 0o600, flush: true }); renameSync(temporary, journal); };
109
+ save();
110
+ const register = () => jsonRequest('POST', input.base + '/register', input.token, { protocolVersion: 2, uploadSessionId: state.uploadSessionId, expectedRevision: state.expectedRevision, ...(input.visibility ? { visibility: input.visibility } : {}) });
111
+ const readStatus = async () => {
112
+ const res = await jsonRequest('GET', input.base + '/upload-sessions/' + state.uploadSessionId, input.token);
113
+ if (res.status !== 200 || !isRecord(res.body) || res.body.protocolVersion !== 2 || res.body.uploadSessionId !== state.uploadSessionId || res.body.libraryId !== state.libraryId)
114
+ throw new Error(`cannot recover Library session: ${res.status}`);
115
+ return res.body;
116
+ };
117
+ if (state.uploadSessionId) {
118
+ const status = await readStatus();
119
+ if (status.state === 'published') {
120
+ const receipt = await register();
121
+ if (receipt.status < 200 || receipt.status >= 300)
122
+ throw new Error(`cannot recover published Library receipt: ${receipt.status}`);
123
+ cleanup();
124
+ return receipt;
125
+ }
126
+ if (status.state === 'abandoned' || status.state === 'uploading' && typeof status.expiresAt === 'string' && Date.parse(status.expiresAt) <= Date.now()) {
127
+ state = { version: 2, fingerprint, sessionKey: randomUUID(), expectedRevision: input.expectedRevision, plans: Object.create(null), parts: Object.create(null) };
128
+ save();
129
+ }
130
+ else if (status.state !== 'uploading' || typeof status.expiresAt !== 'string')
131
+ throw new Error('invalid Library recovery session state');
132
+ }
133
+ const fetchFn = input.fetchFn ?? fetch;
134
+ for (const batch of planBatches(planned)) {
135
+ let missing = new Set(batch.map(f => f.relativePath));
136
+ if (state.uploadSessionId) {
137
+ const status = await jsonRequest('POST', `${input.base}/upload-sessions/${state.uploadSessionId}/files-status`, input.token, { files: batch });
138
+ if (status.status !== 200 || !isRecord(status.body) || !Array.isArray(status.body.files) || status.body.uploadSessionId !== state.uploadSessionId)
139
+ throw new Error(`cannot verify Library upload recovery: ${status.status}`);
140
+ const rows = new Map(status.body.files.map((r) => { if (!isRecord(r) || typeof r.path !== 'string' || typeof r.present !== 'boolean')
141
+ throw new Error('invalid Library upload presence'); return [r.path, r.present]; }));
142
+ for (const file of batch) {
143
+ if (!rows.has(file.relativePath))
144
+ throw new Error('incomplete Library upload presence');
145
+ if (rows.get(file.relativePath))
146
+ missing.delete(file.relativePath);
147
+ }
148
+ }
149
+ const need = batch.filter(f => missing.has(f.relativePath));
150
+ if (!need.length)
151
+ continue;
152
+ const unprepared = need.filter(f => !state.plans[f.relativePath]);
153
+ if (unprepared.length) {
154
+ const response = await jsonRequest('POST', input.base + '/upload-authorizations', input.token, { protocolVersion: 2, sessionKey: state.sessionKey, expectedRevision: state.expectedRevision, ...(state.uploadSessionId ? { uploadSessionId: state.uploadSessionId } : {}), files: unprepared });
155
+ if (response.status !== 200 || !isRecord(response.body) || response.body.protocolVersion !== 2 || !objectId(response.body.uploadSessionId) || !objectId(response.body.libraryId))
156
+ throw new Error(`cannot authorize Library generation: ${response.status}: ${errorMessage(response)}`);
157
+ if (state.uploadSessionId && response.body.uploadSessionId !== state.uploadSessionId || state.libraryId && response.body.libraryId !== state.libraryId)
158
+ throw new Error('Library generation identity changed');
159
+ const authorization = assertLibraryAuthorization(response.body, { files: unprepared });
160
+ state.uploadSessionId = response.body.uploadSessionId;
161
+ state.libraryId = response.body.libraryId;
162
+ state.expiresAt = authorization.expiresAt;
163
+ for (const file of authorization.files) {
164
+ assertImmutable(file);
165
+ state.plans[file.relativePath] = file;
166
+ }
167
+ save();
168
+ }
169
+ for (const file of need) {
170
+ const prepared = state.plans[file.relativePath];
171
+ assertLibraryAuthorization({ mode: 's3-presigned-batch', expiresAt: state.expiresAt, files: [prepared] }, { files: [file] });
172
+ assertImmutable(prepared);
173
+ if (await sha256File(localPath(file)) !== file.sha256)
174
+ throw new Error(`Library source changed during upload: ${file.relativePath}`);
175
+ const completedParts = state.parts[file.relativePath] ?? [];
176
+ const transfer = prepared.transfer.kind === 's3-multipart' ? { ...prepared.transfer, parts: prepared.transfer.parts.filter(p => !completedParts.some(c => c.partNumber === p.partNumber)) } : prepared.transfer;
177
+ await executePresignedBatch([{ ...prepared, transfer, ...(transfer.kind === 's3-multipart' ? { completedParts } : {}) }], { localPath: () => localPath(file), fetchFn, onFailure: 'keep',
178
+ onPartDone: (_f, partNumber, etag) => { state.parts[file.relativePath] = [...(state.parts[file.relativePath] ?? []).filter(p => p.partNumber !== partNumber), { partNumber, etag }]; save(); }, onFileDone: (_f, bytes) => input.onFileDone?.(bytes) });
179
+ }
180
+ }
181
+ // A lost acknowledgement is resolved through the durable session, never by
182
+ // rebasing the expected revision or falling back to an older protocol.
183
+ let result;
184
+ try {
185
+ result = await register();
186
+ }
187
+ catch (error) {
188
+ const status = await readStatus();
189
+ if (status.state !== 'published')
190
+ throw error;
191
+ result = await register();
192
+ }
193
+ if (result.status >= 200 && result.status < 300)
194
+ cleanup();
195
+ return result;
196
+ }
197
+ /** Remote add/rm edits must also publish a complete isolated generation. */
198
+ export async function publishLibraryManifestGeneration(input) {
199
+ const { manifestFileMap, MANIFEST_PATH_PRIMARY } = await import('./manifest.js');
200
+ const fileMap = manifestFileMap(input.manifest), paths = new Set([...fileMap.keys(), ...(input.manifest.generated ?? [])]), local = new Map(input.localByRel);
201
+ local.set(MANIFEST_PATH_PRIMARY, input.manifestFile.abs);
202
+ for (const staged of await stageCarriedGenerationFiles(input.base, input.token, [...paths].filter(rel => !local.has(rel)), path.join(input.cacheDir, 'carried'), input.fetchFn)) {
203
+ const expected = fileMap.get(staged.relativePath);
204
+ if (expected && await sha256File(staged.absPath) !== expected.sha256)
205
+ throw new Error(`remote Library changed during retained-file download: ${staged.relativePath}`);
206
+ local.set(staged.relativePath, staged.absPath);
207
+ }
208
+ const uploads = [...paths].map(relativePath => ({ relativePath, size: statSync(local.get(relativePath)).size }));
209
+ uploads.push({ relativePath: MANIFEST_PATH_PRIMARY, size: input.manifestFile.size });
210
+ return publishLibraryGeneration({ ...input, uploads, localPath: file => local.get(file.relativePath) });
211
+ }
@@ -0,0 +1,2 @@
1
+ import type { Command } from "commander";
2
+ export declare function registerLibraryCommand(program: Command): void;
@@ -0,0 +1,36 @@
1
+ // `dreamlake library push|pull|list|search` — Asset Libraries.
2
+ //
3
+ // A library is a PLAIN local directory: the user's asset files plus one
4
+ // optional `dreamlake.yml` (metadata, discovery globs). Push discovers the
5
+ // assets, generates the dreamlake.assets/v1 wire manifest (and optional
6
+ // thumbnails/vectors) into a cache dir, and uploads user files at their own
7
+ // paths with platform artifacts under the reserved `.dreamlake/` prefix.
8
+ // There is no versioning: `revision` is a CAS counter, push reconciles the
9
+ // remote copy to match the directory (removed files are deleted SERVER-side
10
+ // at register — the CLI never deletes), and pull materializes the user files
11
+ // back onto disk, hash-verified (`--all` for platform artifacts too).
12
+ //
13
+ // Connection flags follow the env command's model: --remote/--token/--debug
14
+ // per invocation, with the active login as the default.
15
+ import { withConnFlags } from "../compat/flags.js";
16
+ import { registerLibraryPushCommand } from "./push.js";
17
+ import { registerLibraryPullCommand } from "./pull.js";
18
+ import { registerLibraryListCommand } from "./list.js";
19
+ import { registerLibrarySearchCommand } from "./search.js";
20
+ import { registerLibraryStatCommand } from "./stat.js";
21
+ import { registerLibraryInfoCommand } from "./info.js";
22
+ import { registerLibraryAddCommand } from "./add.js";
23
+ import { registerLibraryRmCommand } from "./rm.js";
24
+ export function registerLibraryCommand(program) {
25
+ const library = program
26
+ .command("library")
27
+ .description("asset libraries (a directory of assets + optional dreamlake.yml) — push, pull, list, search, stat, info, add, rm");
28
+ registerLibraryPushCommand(library, withConnFlags);
29
+ registerLibraryPullCommand(library, withConnFlags);
30
+ registerLibraryListCommand(library, withConnFlags);
31
+ registerLibrarySearchCommand(library, withConnFlags);
32
+ registerLibraryStatCommand(library, withConnFlags);
33
+ registerLibraryInfoCommand(library, withConnFlags);
34
+ registerLibraryAddCommand(library, withConnFlags);
35
+ registerLibraryRmCommand(library, withConnFlags);
36
+ }
@@ -0,0 +1,69 @@
1
+ import type { Command } from "commander";
2
+ import { type DreamlakeOpts } from "../compat/ctx.js";
3
+ import { type LibraryManifest } from "./manifest.js";
4
+ export interface LibraryInfoArgs extends DreamlakeOpts {
5
+ /** `<namespace>/<name>`, or a bare `<name>` under the active login. */
6
+ spec: string;
7
+ asset?: string;
8
+ /** Re-download the manifest, bypassing the revision-keyed local cache. */
9
+ verify?: boolean;
10
+ json?: boolean;
11
+ }
12
+ export interface LibraryInfoSummary {
13
+ namespace: string;
14
+ name: string;
15
+ title: string | null;
16
+ description: string | null;
17
+ revision: number | null;
18
+ visibility: string | null;
19
+ assetCount: number;
20
+ /** Distinct paths — assets may share files. */
21
+ fileCount: number;
22
+ /** Bytes over distinct paths, not the per-asset sum. */
23
+ totalBytes: number;
24
+ facets: {
25
+ kinds: Record<string, number>;
26
+ categories: Record<string, number>;
27
+ /** Effective licenses (asset ?? library default); unlicensed assets are skipped. */
28
+ licenses: Record<string, number>;
29
+ };
30
+ /**
31
+ * Vector sidecar present in generated[] → true; listed generated[] without
32
+ * one → false; a legacy manifest (no generated[] at all) cannot say → null.
33
+ */
34
+ semantic: boolean | null;
35
+ }
36
+ export declare function computeLibraryInfo(namespace: string, name: string, detail: Record<string, unknown>, manifest: LibraryManifest): LibraryInfoSummary;
37
+ export interface AssetCard {
38
+ namespace: string;
39
+ library: string;
40
+ asset: string;
41
+ kind: string | null;
42
+ format: string | null;
43
+ title: string | null;
44
+ description: string | null;
45
+ category: string | null;
46
+ tags: string[];
47
+ license: string | null;
48
+ licenseSource: "asset" | "library" | null;
49
+ attribution: string | null;
50
+ entry: string | null;
51
+ entryPoints: Record<string, {
52
+ kind: string | null;
53
+ file: string;
54
+ }>;
55
+ files: {
56
+ count: number;
57
+ bytes: number;
58
+ };
59
+ digest: string;
60
+ meta: Record<string, unknown> | null;
61
+ upstream: Record<string, unknown> | null;
62
+ thumbnail: string | null;
63
+ revision: number | null;
64
+ }
65
+ export declare function computeAssetCard(namespace: string, name: string, detail: Record<string, unknown>, manifest: LibraryManifest, assetId: string): AssetCard | null;
66
+ export declare function renderLibraryInfo(info: LibraryInfoSummary): string;
67
+ export declare function renderAssetCard(card: AssetCard): string;
68
+ export declare function runLibraryInfo(args: LibraryInfoArgs): Promise<number>;
69
+ export declare function registerLibraryInfoCommand(library: Command, withConnFlags: (c: Command) => Command): void;
@@ -0,0 +1,311 @@
1
+ // `dreamlake library info <spec>` — one library's statistical portrait, or
2
+ // (with --asset) one asset's full decision card.
3
+ //
4
+ // RFC 0008's `summary` and `peek` verbs, computed CLIENT-side from exactly
5
+ // two GETs — the catalog row and the manifest. No presigning, no other
6
+ // endpoints: the manifest already carries every per-asset fact (files,
7
+ // sizes, hashes, metadata), so the card costs metadata only. Search hits
8
+ // deliberately stay light (no `meta`); THIS is where the full detail lives.
9
+ // The manifest GET goes through the revision-keyed local cache
10
+ // (manifestCache.ts) — an unchanged library answers from disk; `--verify`
11
+ // re-downloads it.
12
+ //
13
+ // Public libraries answer anonymously — like list/pull, nothing here
14
+ // demands a token; it rides along when the login has one.
15
+ import path from "node:path";
16
+ import { emitJson, fail, humanSize } from "../helpers.js";
17
+ import { resolveCtx } from "../compat/ctx.js";
18
+ import { errorMessage, jsonRequest, requireNamespace } from "../compat/http.js";
19
+ import { assetClosureDigest } from "./digest.js";
20
+ import { GENERATED_VECTORS_JSON, assertLibraryManifest, manifestFileMap, } from "./manifest.js";
21
+ import { fetchManifestCached } from "./manifestCache.js";
22
+ import { parseLibrarySpec } from "./pull.js";
23
+ function str(v) {
24
+ return typeof v === "string" && v !== "" ? v : null;
25
+ }
26
+ function bump(map, key) {
27
+ if (key === null)
28
+ return;
29
+ map[key] = (map[key] ?? 0) + 1;
30
+ }
31
+ function effectiveLicense(asset, manifest) {
32
+ const own = str(asset.license);
33
+ if (own)
34
+ return { license: own, source: "asset" };
35
+ const lib = str(manifest.library?.license);
36
+ if (lib)
37
+ return { license: lib, source: "library" };
38
+ return { license: null, source: null };
39
+ }
40
+ export function computeLibraryInfo(namespace, name, detail, manifest) {
41
+ const files = manifestFileMap(manifest);
42
+ let totalBytes = 0;
43
+ for (const stat of files.values())
44
+ totalBytes += stat.size;
45
+ const kinds = {};
46
+ const categories = {};
47
+ const licenses = {};
48
+ for (const asset of manifest.assets) {
49
+ // The server defaults an absent kind to 'file'; count the same way.
50
+ bump(kinds, str(asset.kind) ?? "file");
51
+ bump(categories, str(asset.category));
52
+ bump(licenses, effectiveLicense(asset, manifest).license);
53
+ }
54
+ const generated = Array.isArray(manifest.generated) ? manifest.generated : null;
55
+ const semantic = generated === null ? null : generated.includes(GENERATED_VECTORS_JSON);
56
+ return {
57
+ namespace,
58
+ name,
59
+ title: str(detail.title) ?? str(manifest.library?.title),
60
+ description: str(detail.description) ?? str(manifest.library?.description),
61
+ revision: typeof detail.revision === "number" ? detail.revision : null,
62
+ visibility: str(detail.visibility),
63
+ assetCount: manifest.assets.length,
64
+ fileCount: files.size,
65
+ totalBytes,
66
+ facets: { kinds, categories, licenses },
67
+ semantic,
68
+ };
69
+ }
70
+ function record(v) {
71
+ return typeof v === "object" && v !== null && !Array.isArray(v)
72
+ ? v
73
+ : null;
74
+ }
75
+ export function computeAssetCard(namespace, name, detail, manifest, assetId) {
76
+ const asset = manifest.assets.find((a) => a.id === assetId);
77
+ if (!asset)
78
+ return null;
79
+ const { license, source } = effectiveLicense(asset, manifest);
80
+ let bytes = 0;
81
+ for (const f of asset.files)
82
+ bytes += f.size;
83
+ const entryPoints = {};
84
+ const rawPoints = record(asset.entryPoints);
85
+ if (rawPoints) {
86
+ for (const [pointName, rawPoint] of Object.entries(rawPoints)) {
87
+ const p = record(rawPoint);
88
+ const file = p ? str(p.file) : null;
89
+ if (file)
90
+ entryPoints[pointName] = { kind: p ? str(p.kind) : null, file };
91
+ }
92
+ }
93
+ const tags = Array.isArray(asset.tags)
94
+ ? asset.tags.filter((t) => typeof t === "string")
95
+ : [];
96
+ return {
97
+ namespace,
98
+ library: name,
99
+ asset: asset.id,
100
+ kind: str(asset.kind) ?? "file",
101
+ format: str(asset.format),
102
+ title: str(asset.title),
103
+ description: str(asset.description),
104
+ category: str(asset.category),
105
+ tags,
106
+ license,
107
+ licenseSource: source,
108
+ attribution: str(asset.attribution),
109
+ entry: str(asset.entry),
110
+ entryPoints,
111
+ files: { count: asset.files.length, bytes },
112
+ digest: assetClosureDigest(asset.files),
113
+ meta: record(asset.meta),
114
+ upstream: record(asset.upstream),
115
+ thumbnail: str(asset.thumbnail),
116
+ revision: typeof detail.revision === "number" ? detail.revision : null,
117
+ };
118
+ }
119
+ // ─── rendering ───────────────────────────────────────────────────────
120
+ function firstLine(s) {
121
+ return s.split("\n", 1)[0].trim();
122
+ }
123
+ /** `household 90 · footwear 39` — count desc, then key asc. */
124
+ function facetLine(map) {
125
+ const entries = Object.entries(map);
126
+ if (entries.length === 0)
127
+ return null;
128
+ entries.sort((a, b) => b[1] - a[1] || (a[0] < b[0] ? -1 : 1));
129
+ return entries.map(([k, n]) => `${k} ${n}`).join(" · ");
130
+ }
131
+ export function renderLibraryInfo(info) {
132
+ const lines = [];
133
+ const head = [`${info.namespace}/${info.name}`];
134
+ if (info.revision !== null)
135
+ head.push(`revision ${info.revision}`);
136
+ if (info.visibility)
137
+ head.push(info.visibility);
138
+ lines.push(head.join(" · "));
139
+ if (info.title || info.description) {
140
+ const title = info.title ?? info.name;
141
+ lines.push(info.description ? `${title} — ${firstLine(info.description)}` : title);
142
+ }
143
+ const stats = [`assets ${info.assetCount}`, `files ${info.fileCount}`, humanSize(info.totalBytes)];
144
+ if (info.semantic !== null)
145
+ stats.push(`semantic ${info.semantic ? "✓" : "✗"}`);
146
+ lines.push(stats.join(" · "));
147
+ const facets = [
148
+ ["kinds", facetLine(info.facets.kinds)],
149
+ ["categories", facetLine(info.facets.categories)],
150
+ ["licenses", facetLine(info.facets.licenses)],
151
+ ];
152
+ const label = (s) => s.padEnd("categories".length);
153
+ for (const [name, line] of facets) {
154
+ if (line)
155
+ lines.push(`${label(name)} ${line}`);
156
+ }
157
+ return lines.join("\n") + "\n";
158
+ }
159
+ function renderMeta(meta) {
160
+ const entries = Object.entries(meta);
161
+ if (entries.length === 0)
162
+ return null;
163
+ return entries
164
+ .map(([k, v]) => {
165
+ const shown = typeof v === "string" || typeof v === "number" || typeof v === "boolean"
166
+ ? String(v)
167
+ : JSON.stringify(v);
168
+ return `${k} ${shown}`;
169
+ })
170
+ .join(" · ");
171
+ }
172
+ export function renderAssetCard(card) {
173
+ const lines = [];
174
+ const head = [];
175
+ if (card.kind)
176
+ head.push(card.kind);
177
+ if (card.format)
178
+ head.push(card.format);
179
+ if (card.entry)
180
+ head.push(`entry ${card.entry}`);
181
+ head.push(`${card.files.count} files / ${humanSize(card.files.bytes)}`);
182
+ lines.push(head.join(" · "));
183
+ if (card.title || card.description) {
184
+ const title = card.title ?? card.asset;
185
+ lines.push(card.description ? `${title} — ${firstLine(card.description)}` : title);
186
+ }
187
+ const provenance = [];
188
+ if (card.license) {
189
+ provenance.push(`license ${card.license}${card.licenseSource === "library" ? " (library default)" : ""}`);
190
+ }
191
+ provenance.push(`digest ${card.digest}`);
192
+ lines.push(provenance.join(" · "));
193
+ const taxonomy = [];
194
+ if (card.category)
195
+ taxonomy.push(`category ${card.category}`);
196
+ if (card.tags.length > 0)
197
+ taxonomy.push(`tags ${card.tags.join(", ")}`);
198
+ if (taxonomy.length > 0)
199
+ lines.push(taxonomy.join(" · "));
200
+ const points = Object.entries(card.entryPoints);
201
+ if (points.length > 0) {
202
+ lines.push("entryPoints " +
203
+ points.map(([pointName, p]) => `${pointName} (${path.posix.basename(p.file)})`).join(" · "));
204
+ }
205
+ if (card.meta) {
206
+ const rendered = renderMeta(card.meta);
207
+ if (rendered)
208
+ lines.push(`meta ${rendered}`);
209
+ }
210
+ if (card.attribution)
211
+ lines.push(`attribution ${card.attribution}`);
212
+ if (card.upstream) {
213
+ const upstream = str(card.upstream.url) ?? str(card.upstream.repo) ?? str(card.upstream.id);
214
+ if (upstream)
215
+ lines.push(`upstream ${upstream}`);
216
+ }
217
+ if (card.thumbnail)
218
+ lines.push(`thumbnail ${card.thumbnail}`);
219
+ return lines.join("\n") + "\n";
220
+ }
221
+ // ─── the command ─────────────────────────────────────────────────────
222
+ export async function runLibraryInfo(args) {
223
+ const parsed = parseLibrarySpec(args.spec);
224
+ if ("error" in parsed) {
225
+ fail(parsed.error);
226
+ return 1;
227
+ }
228
+ const { name } = parsed;
229
+ const ctx = resolveCtx(args);
230
+ let namespace = parsed.namespace;
231
+ if (!namespace) {
232
+ namespace = await requireNamespace(ctx, undefined);
233
+ if (!namespace)
234
+ return 1;
235
+ }
236
+ const base = `${ctx.remote}/namespaces/${encodeURIComponent(namespace)}/libraries/${encodeURIComponent(name)}`;
237
+ const dRes = await jsonRequest("GET", base, ctx.token);
238
+ if (dRes.status === 404) {
239
+ fail(`library ${namespace}/${name} not found`);
240
+ return 1;
241
+ }
242
+ if (dRes.status !== 200) {
243
+ fail(`could not read the library → ${dRes.status}: ${errorMessage(dRes)}`);
244
+ return 1;
245
+ }
246
+ const detail = record(dRes.body) ?? {};
247
+ // The manifest, through the revision-keyed cache — the detail row above
248
+ // carries the revision that keys it.
249
+ const { res: mRes } = await fetchManifestCached({
250
+ remote: ctx.remote,
251
+ namespace,
252
+ name,
253
+ token: ctx.token,
254
+ revision: typeof detail.revision === "number" ? detail.revision : null,
255
+ bypass: args.verify,
256
+ });
257
+ if (mRes.status === 404) {
258
+ fail(`${namespace}/${name} has not been pushed yet — nothing to inspect`);
259
+ return 1;
260
+ }
261
+ if (mRes.status !== 200) {
262
+ fail(`could not read the manifest → ${mRes.status}: ${errorMessage(mRes)}`);
263
+ return 1;
264
+ }
265
+ let manifest;
266
+ try {
267
+ manifest = assertLibraryManifest(mRes.body, "the remote manifest");
268
+ }
269
+ catch (e) {
270
+ fail(e.message);
271
+ return 1;
272
+ }
273
+ if (args.asset) {
274
+ const card = computeAssetCard(namespace, name, detail, manifest, args.asset);
275
+ if (!card) {
276
+ const known = manifest.assets.map((a) => a.id);
277
+ const shown = known.slice(0, 20).join(", ");
278
+ fail(`asset '${args.asset}' not found in ${namespace}/${name} — ` +
279
+ `available: ${shown}${known.length > 20 ? `, … (${known.length} total)` : ""}`);
280
+ return 1;
281
+ }
282
+ if (args.json)
283
+ emitJson(card);
284
+ else
285
+ process.stdout.write(renderAssetCard(card));
286
+ return 0;
287
+ }
288
+ let info;
289
+ try {
290
+ info = computeLibraryInfo(namespace, name, detail, manifest);
291
+ }
292
+ catch (e) {
293
+ fail(e.message);
294
+ return 1;
295
+ }
296
+ if (args.json)
297
+ emitJson(info);
298
+ else
299
+ process.stdout.write(renderLibraryInfo(info));
300
+ return 0;
301
+ }
302
+ export function registerLibraryInfoCommand(library, withConnFlags) {
303
+ withConnFlags(library
304
+ .command("info <spec>")
305
+ .description("library summary — or one asset's full decision card with --asset")
306
+ .option("--asset <id>", "show one asset instead of the library summary")
307
+ .option("--verify", "re-download the manifest, bypassing the local manifest cache")
308
+ .option("--json", "emit JSON")).action(async (spec, opts) => {
309
+ process.exit(await runLibraryInfo({ ...opts, spec }));
310
+ });
311
+ }