@dreamlake/dreamlake-cli 0.88.1 → 0.90.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.
- package/dist/api/access.d.ts +83 -0
- package/dist/api/access.js +77 -0
- package/dist/api/agent.d.ts +156 -0
- package/dist/api/agent.js +111 -0
- package/dist/api/browser.d.ts +90 -0
- package/dist/api/browser.js +102 -0
- package/dist/api/client.d.ts +54 -0
- package/dist/api/client.js +102 -0
- package/dist/api/common.d.ts +28 -0
- package/dist/api/common.js +16 -0
- package/dist/api/content.d.ts +195 -0
- package/dist/api/content.js +147 -0
- package/dist/api/execution.d.ts +84 -0
- package/dist/api/execution.js +73 -0
- package/dist/api/http.d.ts +19 -0
- package/dist/api/http.js +66 -0
- package/dist/api/index.d.ts +2362 -0
- package/dist/api/index.js +116 -0
- package/dist/api/infra.d.ts +2 -0
- package/dist/api/infra.js +2 -0
- package/dist/api/jobs.d.ts +2 -0
- package/dist/api/jobs.js +2 -0
- package/dist/api/layout.d.ts +2 -0
- package/dist/api/layout.js +2 -0
- package/dist/api/library-edit.d.ts +3 -0
- package/dist/api/library-edit.js +3 -0
- package/dist/api/library-manifest.d.ts +2 -0
- package/dist/api/library-manifest.js +2 -0
- package/dist/api/note-character-plan.d.ts +2 -0
- package/dist/api/note-character-plan.js +2 -0
- package/dist/api/note-editing.d.ts +2 -0
- package/dist/api/note-editing.js +2 -0
- package/dist/api/note-edits.d.ts +21 -0
- package/dist/api/note-edits.js +10 -0
- package/dist/api/note-events.d.ts +5 -0
- package/dist/api/note-events.js +11 -0
- package/dist/api/note-files.d.ts +102 -0
- package/dist/api/note-files.js +107 -0
- package/dist/api/note-html-read.d.ts +2 -0
- package/dist/api/note-html-read.js +2 -0
- package/dist/api/note-html.d.ts +2 -0
- package/dist/api/note-html.js +2 -0
- package/dist/api/note-linger.d.ts +83 -0
- package/dist/api/note-linger.js +270 -0
- package/dist/api/note-presence.d.ts +82 -0
- package/dist/api/note-presence.js +72 -0
- package/dist/api/note-toc.d.ts +2 -0
- package/dist/api/note-toc.js +2 -0
- package/dist/api/notes.d.ts +329 -0
- package/dist/api/notes.js +209 -0
- package/dist/api/open-resources.d.ts +27 -0
- package/dist/api/open-resources.js +102 -0
- package/dist/api/ownership.d.ts +12 -0
- package/dist/api/ownership.js +24 -0
- package/dist/api/platform.d.ts +83 -0
- package/dist/api/platform.js +56 -0
- package/dist/api/presigned-transfer.d.ts +2 -0
- package/dist/api/presigned-transfer.js +2 -0
- package/dist/api/registered-runs.d.ts +48 -0
- package/dist/api/registered-runs.js +33 -0
- package/dist/api/sessions.d.ts +299 -0
- package/dist/api/sessions.js +105 -0
- package/dist/api/storage.d.ts +46 -0
- package/dist/api/storage.js +34 -0
- package/dist/api/streams.d.ts +18 -0
- package/dist/api/streams.js +70 -0
- package/dist/api/vault.d.ts +93 -0
- package/dist/api/vault.js +79 -0
- package/dist/api/workspace.d.ts +180 -0
- package/dist/api/workspace.js +146 -0
- package/dist/cli/agent-identity.d.ts +4 -0
- package/dist/cli/agent-identity.js +21 -0
- package/dist/cli/agents/identity.d.ts +50 -0
- package/dist/cli/agents/identity.js +105 -0
- package/dist/cli/agents/index.d.ts +31 -0
- package/dist/cli/agents/index.js +580 -0
- package/dist/cli/agents/manage.d.ts +43 -0
- package/dist/cli/agents/manage.js +376 -0
- package/dist/cli/agents/spec.d.ts +104 -0
- package/dist/cli/agents/spec.js +280 -0
- package/dist/cli/agents/web.d.ts +7 -0
- package/dist/cli/agents/web.js +109 -0
- package/dist/cli/artifact/incremental.d.ts +21 -0
- package/dist/cli/artifact/incremental.js +80 -0
- package/dist/cli/artifact/index.d.ts +52 -0
- package/dist/cli/artifact/index.js +405 -0
- package/dist/cli/artifact/meta.d.ts +69 -0
- package/dist/cli/artifact/meta.js +189 -0
- package/dist/cli/auth/commands.d.ts +29 -0
- package/dist/cli/auth/commands.js +327 -0
- package/dist/cli/auth/constants.d.ts +13 -0
- package/dist/cli/auth/constants.js +18 -0
- package/dist/cli/auth/credentials.d.ts +37 -0
- package/dist/cli/auth/credentials.js +155 -0
- package/dist/cli/auth/device-flow.d.ts +32 -0
- package/dist/cli/auth/device-flow.js +154 -0
- package/dist/cli/auth/device-secret.d.ts +6 -0
- package/dist/cli/auth/device-secret.js +26 -0
- package/dist/cli/auth/machine.d.ts +15 -0
- package/dist/cli/auth/machine.js +126 -0
- package/dist/cli/auth/materialized.d.ts +32 -0
- package/dist/cli/auth/materialized.js +102 -0
- package/dist/cli/auth/migrate.d.ts +10 -0
- package/dist/cli/auth/migrate.js +75 -0
- package/dist/cli/client.d.ts +102 -0
- package/dist/cli/client.js +206 -0
- package/dist/cli/collection-list.d.ts +3 -0
- package/dist/cli/collection-list.js +25 -0
- package/dist/cli/compat/ctx.d.ts +26 -0
- package/dist/cli/compat/ctx.js +76 -0
- package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
- package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
- package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
- package/dist/cli/compat/dreamdb-wasm.js +26 -0
- package/dist/cli/compat/dreamdb.d.ts +112 -0
- package/dist/cli/compat/dreamdb.js +219 -0
- package/dist/cli/compat/flags.d.ts +2 -0
- package/dist/cli/compat/flags.js +13 -0
- package/dist/cli/compat/http.d.ts +23 -0
- package/dist/cli/compat/http.js +137 -0
- package/dist/cli/compat/presignedTransfer.d.ts +139 -0
- package/dist/cli/compat/presignedTransfer.js +580 -0
- package/dist/cli/compat/s3-backend.d.ts +73 -0
- package/dist/cli/compat/s3-backend.js +132 -0
- package/dist/cli/config.d.ts +22 -0
- package/dist/cli/config.js +96 -0
- package/dist/cli/connection/dto.d.ts +159 -0
- package/dist/cli/connection/dto.js +497 -0
- package/dist/cli/connection/index.d.ts +50 -0
- package/dist/cli/connection/index.js +413 -0
- package/dist/cli/connection/oauth.d.ts +23 -0
- package/dist/cli/connection/oauth.js +290 -0
- package/dist/cli/connection/write.d.ts +47 -0
- package/dist/cli/connection/write.js +573 -0
- package/dist/cli/create/index.d.ts +19 -0
- package/dist/cli/create/index.js +209 -0
- package/dist/cli/declare/index.d.ts +29 -0
- package/dist/cli/declare/index.js +304 -0
- package/dist/cli/delete/index.d.ts +18 -0
- package/dist/cli/delete/index.js +232 -0
- package/dist/cli/download/index.d.ts +9 -0
- package/dist/cli/download/index.js +128 -0
- package/dist/cli/env/compose.d.ts +88 -0
- package/dist/cli/env/compose.js +402 -0
- package/dist/cli/env/index.d.ts +176 -0
- package/dist/cli/env/index.js +1011 -0
- package/dist/cli/experiments/index.d.ts +11 -0
- package/dist/cli/experiments/index.js +168 -0
- package/dist/cli/glob.d.ts +1 -0
- package/dist/cli/glob.js +45 -0
- package/dist/cli/graphql-helpers.d.ts +23 -0
- package/dist/cli/graphql-helpers.js +42 -0
- package/dist/cli/graphql.d.ts +10 -0
- package/dist/cli/graphql.js +47 -0
- package/dist/cli/help-examples.generated.d.ts +1 -0
- package/dist/cli/help-examples.generated.js +192 -0
- package/dist/cli/helpers.d.ts +8 -0
- package/dist/cli/helpers.js +106 -0
- package/dist/cli/hosts/api.d.ts +29 -0
- package/dist/cli/hosts/api.js +54 -0
- package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
- package/dist/cli/hosts/bootstrap-source.js +2 -0
- package/dist/cli/hosts/catalog.d.ts +26 -0
- package/dist/cli/hosts/catalog.js +55 -0
- package/dist/cli/hosts/config.d.ts +45 -0
- package/dist/cli/hosts/config.js +179 -0
- package/dist/cli/hosts/credentials.d.ts +19 -0
- package/dist/cli/hosts/credentials.js +173 -0
- package/dist/cli/hosts/enroll.d.ts +17 -0
- package/dist/cli/hosts/enroll.js +109 -0
- package/dist/cli/hosts/enrollments.d.ts +25 -0
- package/dist/cli/hosts/enrollments.js +54 -0
- package/dist/cli/hosts/index.d.ts +6 -0
- package/dist/cli/hosts/index.js +279 -0
- package/dist/cli/hosts/inventory.d.ts +40 -0
- package/dist/cli/hosts/inventory.js +91 -0
- package/dist/cli/hosts/lifecycle.d.ts +15 -0
- package/dist/cli/hosts/lifecycle.js +108 -0
- package/dist/cli/hosts/metrics-source.d.ts +12 -0
- package/dist/cli/hosts/metrics-source.js +89 -0
- package/dist/cli/hosts/observations.d.ts +39 -0
- package/dist/cli/hosts/observations.js +102 -0
- package/dist/cli/hosts/remote.d.ts +5 -0
- package/dist/cli/hosts/remote.js +66 -0
- package/dist/cli/hosts/ssh.d.ts +63 -0
- package/dist/cli/hosts/ssh.js +276 -0
- package/dist/cli/index.d.ts +1 -0
- package/dist/cli/index.js +288 -0
- package/dist/cli/infra/api.d.ts +95 -0
- package/dist/cli/infra/api.js +291 -0
- package/dist/cli/infra/index.d.ts +5 -0
- package/dist/cli/infra/index.js +102 -0
- package/dist/cli/infra/move.d.ts +15 -0
- package/dist/cli/infra/move.js +123 -0
- package/dist/cli/infra/transfer.d.ts +15 -0
- package/dist/cli/infra/transfer.js +280 -0
- package/dist/cli/jobs/api.d.ts +69 -0
- package/dist/cli/jobs/api.js +121 -0
- package/dist/cli/jobs/index.d.ts +5 -0
- package/dist/cli/jobs/index.js +140 -0
- package/dist/cli/lakeshore/index.d.ts +98 -0
- package/dist/cli/lakeshore/index.js +502 -0
- package/dist/cli/launch/index.d.ts +43 -0
- package/dist/cli/launch/index.js +270 -0
- package/dist/cli/layout/index.d.ts +2 -0
- package/dist/cli/layout/index.js +44 -0
- package/dist/cli/layout/transport.d.ts +12 -0
- package/dist/cli/layout/transport.js +70 -0
- package/dist/cli/library/add.d.ts +60 -0
- package/dist/cli/library/add.js +348 -0
- package/dist/cli/library/cache.d.ts +26 -0
- package/dist/cli/library/cache.js +88 -0
- package/dist/cli/library/config.d.ts +75 -0
- package/dist/cli/library/config.js +198 -0
- package/dist/cli/library/digest.d.ts +5 -0
- package/dist/cli/library/digest.js +19 -0
- package/dist/cli/library/discover.d.ts +87 -0
- package/dist/cli/library/discover.js +534 -0
- package/dist/cli/library/freshness.d.ts +35 -0
- package/dist/cli/library/freshness.js +109 -0
- package/dist/cli/library/generation.d.ts +35 -0
- package/dist/cli/library/generation.js +211 -0
- package/dist/cli/library/index.d.ts +2 -0
- package/dist/cli/library/index.js +36 -0
- package/dist/cli/library/info.d.ts +69 -0
- package/dist/cli/library/info.js +311 -0
- package/dist/cli/library/list.d.ts +33 -0
- package/dist/cli/library/list.js +86 -0
- package/dist/cli/library/manifest.d.ts +81 -0
- package/dist/cli/library/manifest.js +200 -0
- package/dist/cli/library/manifestCache.d.ts +45 -0
- package/dist/cli/library/manifestCache.js +169 -0
- package/dist/cli/library/pull.d.ts +30 -0
- package/dist/cli/library/pull.js +438 -0
- package/dist/cli/library/push.d.ts +72 -0
- package/dist/cli/library/push.js +642 -0
- package/dist/cli/library/rm.d.ts +31 -0
- package/dist/cli/library/rm.js +200 -0
- package/dist/cli/library/search.d.ts +18 -0
- package/dist/cli/library/search.js +181 -0
- package/dist/cli/library/stat.d.ts +15 -0
- package/dist/cli/library/stat.js +127 -0
- package/dist/cli/library/tools.d.ts +104 -0
- package/dist/cli/library/tools.js +163 -0
- package/dist/cli/library/wire.d.ts +47 -0
- package/dist/cli/library/wire.js +120 -0
- package/dist/cli/list/index.d.ts +26 -0
- package/dist/cli/list/index.js +256 -0
- package/dist/cli/notes/api-transport.d.ts +5 -0
- package/dist/cli/notes/api-transport.js +20 -0
- package/dist/cli/notes/character-plan.d.ts +22 -0
- package/dist/cli/notes/character-plan.js +232 -0
- package/dist/cli/notes/document.d.ts +73 -0
- package/dist/cli/notes/document.js +306 -0
- package/dist/cli/notes/edit-commands.d.ts +106 -0
- package/dist/cli/notes/edit-commands.js +623 -0
- package/dist/cli/notes/editing.d.ts +81 -0
- package/dist/cli/notes/editing.js +305 -0
- package/dist/cli/notes/events.d.ts +36 -0
- package/dist/cli/notes/events.js +54 -0
- package/dist/cli/notes/files-commands.d.ts +97 -0
- package/dist/cli/notes/files-commands.js +548 -0
- package/dist/cli/notes/html-read.d.ts +9 -0
- package/dist/cli/notes/html-read.js +90 -0
- package/dist/cli/notes/html.d.ts +73 -0
- package/dist/cli/notes/html.js +381 -0
- package/dist/cli/notes/index.d.ts +123 -0
- package/dist/cli/notes/index.js +1300 -0
- package/dist/cli/notes/linger.d.ts +4 -0
- package/dist/cli/notes/linger.js +96 -0
- package/dist/cli/notes/media-commands.d.ts +5 -0
- package/dist/cli/notes/media-commands.js +51 -0
- package/dist/cli/notes/move-command.d.ts +83 -0
- package/dist/cli/notes/move-command.js +259 -0
- package/dist/cli/notes/rm-command.d.ts +22 -0
- package/dist/cli/notes/rm-command.js +110 -0
- package/dist/cli/notes/select-command.d.ts +12 -0
- package/dist/cli/notes/select-command.js +63 -0
- package/dist/cli/notes/suggest-diff.d.ts +56 -0
- package/dist/cli/notes/suggest-diff.js +311 -0
- package/dist/cli/notes/toc.d.ts +38 -0
- package/dist/cli/notes/toc.js +144 -0
- package/dist/cli/notes/transfer-command.d.ts +6 -0
- package/dist/cli/notes/transfer-command.js +9 -0
- package/dist/cli/notes/version-commands.d.ts +19 -0
- package/dist/cli/notes/version-commands.js +178 -0
- package/dist/cli/nymph/index.d.ts +74 -0
- package/dist/cli/nymph/index.js +349 -0
- package/dist/cli/org/index.d.ts +34 -0
- package/dist/cli/org/index.js +341 -0
- package/dist/cli/ownership/index.d.ts +12 -0
- package/dist/cli/ownership/index.js +122 -0
- package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
- package/dist/cli/ownership/metadata-transfer.js +159 -0
- package/dist/cli/page/index.d.ts +58 -0
- package/dist/cli/page/index.js +387 -0
- package/dist/cli/pipeline/index.d.ts +69 -0
- package/dist/cli/pipeline/index.js +604 -0
- package/dist/cli/progress.d.ts +60 -0
- package/dist/cli/progress.js +276 -0
- package/dist/cli/project/attachments.d.ts +10 -0
- package/dist/cli/project/attachments.js +39 -0
- package/dist/cli/project/grants.d.ts +10 -0
- package/dist/cli/project/grants.js +39 -0
- package/dist/cli/project/index.d.ts +8 -0
- package/dist/cli/project/index.js +92 -0
- package/dist/cli/project/move.d.ts +57 -0
- package/dist/cli/project/move.js +242 -0
- package/dist/cli/project/output.d.ts +2 -0
- package/dist/cli/project/output.js +29 -0
- package/dist/cli/project/stream.d.ts +55 -0
- package/dist/cli/project/stream.js +207 -0
- package/dist/cli/project/transfer-preview.d.ts +8 -0
- package/dist/cli/project/transfer-preview.js +10 -0
- package/dist/cli/prompt.d.ts +1 -0
- package/dist/cli/prompt.js +17 -0
- package/dist/cli/provider/dreamdir.d.ts +52 -0
- package/dist/cli/provider/dreamdir.js +138 -0
- package/dist/cli/provider/index.d.ts +4 -0
- package/dist/cli/provider/index.js +419 -0
- package/dist/cli/provider/jump-worker.d.ts +9 -0
- package/dist/cli/provider/jump-worker.js +141 -0
- package/dist/cli/provider/lifecycle.d.ts +149 -0
- package/dist/cli/provider/lifecycle.js +1390 -0
- package/dist/cli/provider/machine.d.ts +17 -0
- package/dist/cli/provider/machine.js +116 -0
- package/dist/cli/provider/ssh.d.ts +105 -0
- package/dist/cli/provider/ssh.js +305 -0
- package/dist/cli/provider/terraform.d.ts +140 -0
- package/dist/cli/provider/terraform.js +288 -0
- package/dist/cli/providers/index.d.ts +18 -0
- package/dist/cli/providers/index.js +422 -0
- package/dist/cli/python.d.ts +61 -0
- package/dist/cli/python.js +255 -0
- package/dist/cli/queues/index.d.ts +33 -0
- package/dist/cli/queues/index.js +248 -0
- package/dist/cli/queues/slurm.d.ts +10 -0
- package/dist/cli/queues/slurm.js +134 -0
- package/dist/cli/resources.d.ts +72 -0
- package/dist/cli/resources.js +137 -0
- package/dist/cli/run/index.d.ts +15 -0
- package/dist/cli/run/index.js +163 -0
- package/dist/cli/run/input.d.ts +34 -0
- package/dist/cli/run/input.js +135 -0
- package/dist/cli/run/recovery.d.ts +2 -0
- package/dist/cli/run/recovery.js +18 -0
- package/dist/cli/run/setup.d.ts +3 -0
- package/dist/cli/run/setup.js +62 -0
- package/dist/cli/runconfig/index.d.ts +12 -0
- package/dist/cli/runconfig/index.js +130 -0
- package/dist/cli/runnable/index.d.ts +35 -0
- package/dist/cli/runnable/index.js +575 -0
- package/dist/cli/runnable/path.d.ts +115 -0
- package/dist/cli/runnable/path.js +288 -0
- package/dist/cli/runnable/run.d.ts +91 -0
- package/dist/cli/runnable/run.js +239 -0
- package/dist/cli/runnable/upload.d.ts +43 -0
- package/dist/cli/runnable/upload.js +342 -0
- package/dist/cli/runnable/worker.d.ts +1 -0
- package/dist/cli/runnable/worker.js +44 -0
- package/dist/cli/schemas/workflow-spec.schema.json +335 -0
- package/dist/cli/self-update/index.d.ts +5 -0
- package/dist/cli/self-update/index.js +107 -0
- package/dist/cli/self-update/install.d.ts +60 -0
- package/dist/cli/self-update/install.js +428 -0
- package/dist/cli/self-update/paths.d.ts +40 -0
- package/dist/cli/self-update/paths.js +87 -0
- package/dist/cli/self-update/releases.d.ts +41 -0
- package/dist/cli/self-update/releases.js +153 -0
- package/dist/cli/self-update/settings.d.ts +16 -0
- package/dist/cli/self-update/settings.js +68 -0
- package/dist/cli/self-update/update.d.ts +18 -0
- package/dist/cli/self-update/update.js +241 -0
- package/dist/cli/service-accounts/index.d.ts +3 -0
- package/dist/cli/service-accounts/index.js +149 -0
- package/dist/cli/session-affiliation.d.ts +26 -0
- package/dist/cli/session-affiliation.js +135 -0
- package/dist/cli/sessions/affiliation.d.ts +8 -0
- package/dist/cli/sessions/affiliation.js +66 -0
- package/dist/cli/sessions/api.d.ts +55 -0
- package/dist/cli/sessions/api.js +88 -0
- package/dist/cli/sessions/control.d.ts +6 -0
- package/dist/cli/sessions/control.js +159 -0
- package/dist/cli/sessions/conversation.d.ts +15 -0
- package/dist/cli/sessions/conversation.js +118 -0
- package/dist/cli/sessions/index.d.ts +2 -0
- package/dist/cli/sessions/index.js +209 -0
- package/dist/cli/sessions/managed.d.ts +39 -0
- package/dist/cli/sessions/managed.js +63 -0
- package/dist/cli/sessions/redaction.d.ts +2 -0
- package/dist/cli/sessions/redaction.js +11 -0
- package/dist/cli/sessions/runner/exec.d.ts +108 -0
- package/dist/cli/sessions/runner/exec.js +335 -0
- package/dist/cli/sessions/runner/journal.d.ts +26 -0
- package/dist/cli/sessions/runner/journal.js +49 -0
- package/dist/cli/sessions/runner/native.d.ts +48 -0
- package/dist/cli/sessions/runner/native.js +170 -0
- package/dist/cli/sessions/runner/pod.d.ts +30 -0
- package/dist/cli/sessions/runner/pod.js +129 -0
- package/dist/cli/sessions/runner/serve.d.ts +85 -0
- package/dist/cli/sessions/runner/serve.js +558 -0
- package/dist/cli/sessions/sync.d.ts +47 -0
- package/dist/cli/sessions/sync.js +80 -0
- package/dist/cli/sessions/transport.d.ts +14 -0
- package/dist/cli/sessions/transport.js +116 -0
- package/dist/cli/share.d.ts +15 -0
- package/dist/cli/share.js +139 -0
- package/dist/cli/skill/catalog.d.ts +141 -0
- package/dist/cli/skill/catalog.js +442 -0
- package/dist/cli/skill/files.d.ts +89 -0
- package/dist/cli/skill/files.js +264 -0
- package/dist/cli/skill/index.d.ts +268 -0
- package/dist/cli/skill/index.js +1216 -0
- package/dist/cli/skill/manifest.d.ts +30 -0
- package/dist/cli/skill/manifest.js +101 -0
- package/dist/cli/skill/prefs.d.ts +9 -0
- package/dist/cli/skill/prefs.js +32 -0
- package/dist/cli/skill/reminders.d.ts +15 -0
- package/dist/cli/skill/reminders.js +105 -0
- package/dist/cli/skill/tar.d.ts +17 -0
- package/dist/cli/skill/tar.js +195 -0
- package/dist/cli/snapshot/index.d.ts +24 -0
- package/dist/cli/snapshot/index.js +146 -0
- package/dist/cli/source/access.d.ts +45 -0
- package/dist/cli/source/access.js +563 -0
- package/dist/cli/source/control.d.ts +103 -0
- package/dist/cli/source/control.js +546 -0
- package/dist/cli/source/delete.d.ts +89 -0
- package/dist/cli/source/delete.js +463 -0
- package/dist/cli/source/index.d.ts +288 -0
- package/dist/cli/source/index.js +1348 -0
- package/dist/cli/source/share.d.ts +65 -0
- package/dist/cli/source/share.js +530 -0
- package/dist/cli/source/upload.d.ts +62 -0
- package/dist/cli/source/upload.js +258 -0
- package/dist/cli/source/write.d.ts +77 -0
- package/dist/cli/source/write.js +335 -0
- package/dist/cli/spawn.d.ts +28 -0
- package/dist/cli/spawn.js +81 -0
- package/dist/cli/target.d.ts +22 -0
- package/dist/cli/target.js +85 -0
- package/dist/cli/tasks/index.d.ts +38 -0
- package/dist/cli/tasks/index.js +365 -0
- package/dist/cli/team/index.d.ts +37 -0
- package/dist/cli/team/index.js +407 -0
- package/dist/cli/telemetry.d.ts +23 -0
- package/dist/cli/telemetry.js +262 -0
- package/dist/cli/telemetryJournal.d.ts +26 -0
- package/dist/cli/telemetryJournal.js +104 -0
- package/dist/cli/update/index.d.ts +21 -0
- package/dist/cli/update/index.js +284 -0
- package/dist/cli/upload/index.d.ts +11 -0
- package/dist/cli/upload/index.js +261 -0
- package/dist/cli/upload/kinds.d.ts +10 -0
- package/dist/cli/upload/kinds.js +85 -0
- package/dist/cli/upload/multipart.d.ts +21 -0
- package/dist/cli/upload/multipart.js +248 -0
- package/dist/cli/vault/affected-preview.d.ts +15 -0
- package/dist/cli/vault/affected-preview.js +38 -0
- package/dist/cli/vault/cloud.d.ts +55 -0
- package/dist/cli/vault/cloud.js +287 -0
- package/dist/cli/vault/format.d.ts +18 -0
- package/dist/cli/vault/format.js +104 -0
- package/dist/cli/vault/hostCredentials.d.ts +21 -0
- package/dist/cli/vault/hostCredentials.js +71 -0
- package/dist/cli/vault/hostSupersessions.d.ts +18 -0
- package/dist/cli/vault/hostSupersessions.js +68 -0
- package/dist/cli/vault/import.d.ts +3 -0
- package/dist/cli/vault/import.js +79 -0
- package/dist/cli/vault/index.d.ts +14 -0
- package/dist/cli/vault/index.js +225 -0
- package/dist/cli/vault/keys.d.ts +5 -0
- package/dist/cli/vault/keys.js +165 -0
- package/dist/cli/vault/kms.d.ts +6 -0
- package/dist/cli/vault/kms.js +169 -0
- package/dist/cli/vault/list.d.ts +13 -0
- package/dist/cli/vault/list.js +60 -0
- package/dist/cli/vault/listView.d.ts +21 -0
- package/dist/cli/vault/listView.js +123 -0
- package/dist/cli/vault/managementMetadata.d.ts +2 -0
- package/dist/cli/vault/managementMetadata.js +23 -0
- package/dist/cli/vault/mutations.d.ts +8 -0
- package/dist/cli/vault/mutations.js +151 -0
- package/dist/cli/vault/otp.d.ts +6 -0
- package/dist/cli/vault/otp.js +62 -0
- package/dist/cli/vault/otpIntent.d.ts +23 -0
- package/dist/cli/vault/otpIntent.js +76 -0
- package/dist/cli/vault/passImport.d.ts +25 -0
- package/dist/cli/vault/passImport.js +129 -0
- package/dist/cli/vault/passOtp.d.ts +51 -0
- package/dist/cli/vault/passOtp.js +101 -0
- package/dist/cli/vault/passStore.d.ts +26 -0
- package/dist/cli/vault/passStore.js +134 -0
- package/dist/cli/vault/passwordCommand.d.ts +39 -0
- package/dist/cli/vault/passwordCommand.js +101 -0
- package/dist/cli/vault/passwordProbe.d.ts +27 -0
- package/dist/cli/vault/passwordProbe.js +282 -0
- package/dist/cli/vault/passwordRotation.d.ts +9 -0
- package/dist/cli/vault/passwordRotation.js +273 -0
- package/dist/cli/vault/rotationApi.d.ts +13 -0
- package/dist/cli/vault/rotationApi.js +58 -0
- package/dist/cli/vault/rotationCommand.d.ts +2 -0
- package/dist/cli/vault/rotationCommand.js +75 -0
- package/dist/cli/vault/rotationEngine.d.ts +19 -0
- package/dist/cli/vault/rotationEngine.js +65 -0
- package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
- package/dist/cli/vault/rotationHelperSource.js +3 -0
- package/dist/cli/vault/rotationInput.d.ts +11 -0
- package/dist/cli/vault/rotationInput.js +48 -0
- package/dist/cli/vault/rotationJournal.d.ts +16 -0
- package/dist/cli/vault/rotationJournal.js +183 -0
- package/dist/cli/vault/rotationKeys.d.ts +4 -0
- package/dist/cli/vault/rotationKeys.js +48 -0
- package/dist/cli/vault/rotationPrepare.d.ts +17 -0
- package/dist/cli/vault/rotationPrepare.js +108 -0
- package/dist/cli/vault/rotationRemote.d.ts +33 -0
- package/dist/cli/vault/rotationRemote.js +156 -0
- package/dist/cli/vault/rotationState.d.ts +42 -0
- package/dist/cli/vault/rotationState.js +115 -0
- package/dist/cli/vault/rotationTransport.d.ts +18 -0
- package/dist/cli/vault/rotationTransport.js +71 -0
- package/dist/cli/vault/sshSource.d.ts +18 -0
- package/dist/cli/vault/sshSource.js +196 -0
- package/dist/cli/vault/sshSync.d.ts +17 -0
- package/dist/cli/vault/sshSync.js +224 -0
- package/dist/cli/vault/sshTransfer.d.ts +22 -0
- package/dist/cli/vault/sshTransfer.js +140 -0
- package/dist/cli/vault/terraformState.d.ts +66 -0
- package/dist/cli/vault/terraformState.js +252 -0
- package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
- package/dist/cli/vault/terraformStateCommand.js +61 -0
- package/dist/cli/vault/tree.d.ts +43 -0
- package/dist/cli/vault/tree.js +292 -0
- package/dist/cli/version.d.ts +1 -0
- package/dist/cli/version.js +9 -0
- package/dist/cli/workflow/index.d.ts +76 -0
- package/dist/cli/workflow/index.js +826 -0
- package/dist/cli/workflow/validate.d.ts +19 -0
- package/dist/cli/workflow/validate.js +353 -0
- package/dist/package.json +1 -0
- package/package.json +28 -10
|
@@ -0,0 +1,442 @@
|
|
|
1
|
+
// Where skills come from.
|
|
2
|
+
//
|
|
3
|
+
// Two sources, both producing the same in-memory `SkillPayload`:
|
|
4
|
+
//
|
|
5
|
+
// embedded — the one skill (`dreamlake-cli`) the CLI carries for offline
|
|
6
|
+
// use. In a release binary it is the `DREAMLAKE_EMBEDDED_*`
|
|
7
|
+
// defines the build injects; in a source or npm run it is the
|
|
8
|
+
// `skills/` directory next to the package (or
|
|
9
|
+
// `DREAMLAKE_SKILLS_DIR`) as `scripts/fetch-skills.mjs` writes
|
|
10
|
+
// it: `dreamlake-cli/` plus the side files `.manifest.json`
|
|
11
|
+
// (tag, commit, per-file sha256) and `catalog.json` (the
|
|
12
|
+
// snapshot). The same two files travel in the npm package, so
|
|
13
|
+
// a source run, an npm install and a release binary all report
|
|
14
|
+
// the same version; tests point the env at fixtures and never
|
|
15
|
+
// need the network.
|
|
16
|
+
// catalog — the public dreamlake-skills release: `catalog.json` lists
|
|
17
|
+
// every skill, its description and `requires`; `skills.tar.gz`
|
|
18
|
+
// holds the directories. `DREAMLAKE_SKILLS_RELEASE_URL` points
|
|
19
|
+
// at a mirror, or at a local directory holding both files.
|
|
20
|
+
//
|
|
21
|
+
// Nothing here writes to disk. The installer in index.ts decides what to do
|
|
22
|
+
// with a payload; this file only says what a payload is and where it is.
|
|
23
|
+
import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
|
|
24
|
+
import path from "node:path";
|
|
25
|
+
import { fileURLToPath } from "node:url";
|
|
26
|
+
import { sha256, walkFiles } from "./files.js";
|
|
27
|
+
import { readTarGz } from "./tar.js";
|
|
28
|
+
export const SKILLS_ENV = "DREAMLAKE_SKILLS_DIR";
|
|
29
|
+
export const MANIFEST_ENV = "DREAMLAKE_SKILLS_MANIFEST_FILE";
|
|
30
|
+
export const CATALOG_ENV = "DREAMLAKE_SKILLS_CATALOG_FILE";
|
|
31
|
+
export const RELEASE_ENV = "DREAMLAKE_SKILLS_RELEASE_URL";
|
|
32
|
+
export const RELEASE_BASE = "https://github.com/dreamlake-ai/dreamlake-skills/releases";
|
|
33
|
+
export const EMBEDDED_ROOT = "embedded-skills";
|
|
34
|
+
export const EMBEDDED_SKILL = "dreamlake-cli";
|
|
35
|
+
/** The release asset holding every skill directory. */
|
|
36
|
+
export const TARBALL_ASSET = "skills.tar.gz";
|
|
37
|
+
const embedded = typeof DREAMLAKE_EMBEDDED_SKILLS === "undefined" ? null : DREAMLAKE_EMBEDDED_SKILLS;
|
|
38
|
+
const embeddedManifestDefine = typeof DREAMLAKE_EMBEDDED_SKILLS_MANIFEST === "undefined"
|
|
39
|
+
? null : DREAMLAKE_EMBEDDED_SKILLS_MANIFEST;
|
|
40
|
+
const embeddedCatalogDefine = typeof DREAMLAKE_EMBEDDED_CATALOG === "undefined"
|
|
41
|
+
? null : DREAMLAKE_EMBEDDED_CATALOG;
|
|
42
|
+
/**
|
|
43
|
+
* Side files `scripts/fetch-skills.mjs` leaves beside the skill directory.
|
|
44
|
+
* The names are a contract with that script and with `scripts/native-skills.ts`,
|
|
45
|
+
* which embeds the same manifest; change all three together.
|
|
46
|
+
*/
|
|
47
|
+
export const BUNDLE_MANIFEST_FILE = ".manifest.json";
|
|
48
|
+
export const BUNDLE_CATALOG_FILE = "catalog.json";
|
|
49
|
+
// ─── the embedded bundle ─────────────────────────────────────────────────────
|
|
50
|
+
//
|
|
51
|
+
// Resolved relative to THIS MODULE, never to cwd, so it works identically
|
|
52
|
+
// under `tsx src/cli/index.ts` (module at src/cli/skill/) and under
|
|
53
|
+
// `node dist/cli/index.js` (module at dist/cli/skill/). Both are three levels
|
|
54
|
+
// below the package root, and `skills/` sits at the package root beside
|
|
55
|
+
// `dist/`. `skills` must be in package.json's `files` array or the published
|
|
56
|
+
// npm tarball carries nothing to install.
|
|
57
|
+
function isDir(p) {
|
|
58
|
+
try {
|
|
59
|
+
return statSync(p).isDirectory();
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
return false;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
export function resolveBundleDir() {
|
|
66
|
+
const fromEnv = process.env[SKILLS_ENV];
|
|
67
|
+
if (fromEnv)
|
|
68
|
+
return isDir(fromEnv) ? path.resolve(fromEnv) : null;
|
|
69
|
+
if (embedded)
|
|
70
|
+
return EMBEDDED_ROOT;
|
|
71
|
+
const here = path.dirname(fileURLToPath(import.meta.url));
|
|
72
|
+
// src/cli/skill → ../../.. · dist/cli/skill → ../../..
|
|
73
|
+
const candidates = [path.resolve(here, "..", "..", "..", "skills")];
|
|
74
|
+
// Walk up as a fallback: a bundler that flattens the tree, or a future
|
|
75
|
+
// layout change, must not silently break the installer.
|
|
76
|
+
let cur = here;
|
|
77
|
+
for (let i = 0; i < 6; i += 1) {
|
|
78
|
+
const parent = path.dirname(cur);
|
|
79
|
+
if (parent === cur)
|
|
80
|
+
break;
|
|
81
|
+
candidates.push(path.join(parent, "skills"));
|
|
82
|
+
cur = parent;
|
|
83
|
+
}
|
|
84
|
+
for (const c of candidates)
|
|
85
|
+
if (isDir(c))
|
|
86
|
+
return c;
|
|
87
|
+
return null;
|
|
88
|
+
}
|
|
89
|
+
function usingDefine(bundleDir) {
|
|
90
|
+
return bundleDir === EMBEDDED_ROOT && embedded !== null;
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Bundled skill names — directories only. A loose `.md` is not a skill, and
|
|
94
|
+
* neither is a dot-directory (the fetch script stages into one before it
|
|
95
|
+
* swaps the real directory in).
|
|
96
|
+
*/
|
|
97
|
+
export function listBundledSkills(bundleDir) {
|
|
98
|
+
if (usingDefine(bundleDir)) {
|
|
99
|
+
return [...new Set(Object.keys(embedded).map((key) => key.split("/")[0]))].sort();
|
|
100
|
+
}
|
|
101
|
+
return readdirSync(bundleDir, { withFileTypes: true })
|
|
102
|
+
.filter((e) => e.isDirectory() && !e.name.startsWith("."))
|
|
103
|
+
.map((e) => e.name)
|
|
104
|
+
.sort();
|
|
105
|
+
}
|
|
106
|
+
export function bundledFiles(bundleDir, name) {
|
|
107
|
+
if (usingDefine(bundleDir)) {
|
|
108
|
+
const prefix = `${name}/`;
|
|
109
|
+
return Object.keys(embedded).filter((key) => key.startsWith(prefix))
|
|
110
|
+
.map((key) => key.slice(prefix.length)).sort();
|
|
111
|
+
}
|
|
112
|
+
return walkFiles(path.join(bundleDir, name));
|
|
113
|
+
}
|
|
114
|
+
export function bundledBytes(bundleDir, name, rel) {
|
|
115
|
+
if (usingDefine(bundleDir))
|
|
116
|
+
return Buffer.from(embedded[`${name}/${rel}`], "base64");
|
|
117
|
+
return readFileSync(path.join(bundleDir, name, rel));
|
|
118
|
+
}
|
|
119
|
+
function readJsonFile(file) {
|
|
120
|
+
return JSON.parse(readFileSync(file, "utf8"));
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* The embedded manifest: tag, commit and per-file hashes of the bundled
|
|
124
|
+
* skill. From the define, else `DREAMLAKE_SKILLS_MANIFEST_FILE`, else
|
|
125
|
+
* `<bundle>/.manifest.json`, else computed from the files with no version.
|
|
126
|
+
*/
|
|
127
|
+
export function embeddedManifest(bundleDir = resolveBundleDir()) {
|
|
128
|
+
if (!bundleDir)
|
|
129
|
+
return null;
|
|
130
|
+
const declared = declaredManifest(bundleDir);
|
|
131
|
+
if (declared)
|
|
132
|
+
return declared;
|
|
133
|
+
const files = {};
|
|
134
|
+
for (const name of listBundledSkills(bundleDir)) {
|
|
135
|
+
for (const rel of bundledFiles(bundleDir, name))
|
|
136
|
+
files[`${name}/${rel}`] = sha256(bundledBytes(bundleDir, name, rel));
|
|
137
|
+
}
|
|
138
|
+
return { tag: null, commit: null, files };
|
|
139
|
+
}
|
|
140
|
+
/** The manifest as declared (define, env file, side file) — no hashing, so cheap at startup. */
|
|
141
|
+
function declaredManifest(bundleDir) {
|
|
142
|
+
const fromEnv = process.env[MANIFEST_ENV];
|
|
143
|
+
if (fromEnv)
|
|
144
|
+
return normalizeEmbeddedManifest(readJsonFile(fromEnv));
|
|
145
|
+
if (usingDefine(bundleDir))
|
|
146
|
+
return embeddedManifestDefine ? normalizeEmbeddedManifest(embeddedManifestDefine) : null;
|
|
147
|
+
const side = path.join(bundleDir, BUNDLE_MANIFEST_FILE);
|
|
148
|
+
return existsSync(side) ? normalizeEmbeddedManifest(readJsonFile(side)) : null;
|
|
149
|
+
}
|
|
150
|
+
function normalizeEmbeddedManifest(raw) {
|
|
151
|
+
if (!raw || typeof raw !== "object")
|
|
152
|
+
throw new Error("embedded skills manifest is not an object");
|
|
153
|
+
const m = raw;
|
|
154
|
+
const files = m.files && typeof m.files === "object" && !Array.isArray(m.files)
|
|
155
|
+
? Object.fromEntries(Object.entries(m.files).filter(([, v]) => typeof v === "string"))
|
|
156
|
+
: {};
|
|
157
|
+
return {
|
|
158
|
+
tag: typeof m.tag === "string" ? m.tag : null,
|
|
159
|
+
commit: typeof m.commit === "string" ? m.commit : null,
|
|
160
|
+
files,
|
|
161
|
+
};
|
|
162
|
+
}
|
|
163
|
+
/** The version the embedded bundle was cut from: its tag, else its commit. */
|
|
164
|
+
export function embeddedVersion(bundleDir = resolveBundleDir()) {
|
|
165
|
+
try {
|
|
166
|
+
if (!bundleDir)
|
|
167
|
+
return null;
|
|
168
|
+
const m = declaredManifest(bundleDir);
|
|
169
|
+
return m?.tag ?? m?.commit ?? null;
|
|
170
|
+
}
|
|
171
|
+
catch {
|
|
172
|
+
return null;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* The catalog snapshot the CLI carries. From the define, else
|
|
177
|
+
* `DREAMLAKE_SKILLS_CATALOG_FILE`, else `<bundle>/catalog.json`, else null.
|
|
178
|
+
*/
|
|
179
|
+
export function embeddedCatalog(bundleDir = resolveBundleDir()) {
|
|
180
|
+
const fromEnv = process.env[CATALOG_ENV];
|
|
181
|
+
if (fromEnv)
|
|
182
|
+
return normalizeCatalog(readJsonFile(fromEnv));
|
|
183
|
+
if (bundleDir && usingDefine(bundleDir)) {
|
|
184
|
+
return embeddedCatalogDefine ? normalizeCatalog(embeddedCatalogDefine) : null;
|
|
185
|
+
}
|
|
186
|
+
if (bundleDir) {
|
|
187
|
+
const side = path.join(bundleDir, BUNDLE_CATALOG_FILE);
|
|
188
|
+
if (existsSync(side))
|
|
189
|
+
return normalizeCatalog(readJsonFile(side));
|
|
190
|
+
}
|
|
191
|
+
return null;
|
|
192
|
+
}
|
|
193
|
+
export function embeddedPayload(bundleDir, name) {
|
|
194
|
+
const files = new Map();
|
|
195
|
+
for (const rel of bundledFiles(bundleDir, name))
|
|
196
|
+
files.set(rel, bundledBytes(bundleDir, name, rel));
|
|
197
|
+
return { name, version: embeddedVersion(bundleDir), source: "embedded", files };
|
|
198
|
+
}
|
|
199
|
+
// ─── catalog shape ───────────────────────────────────────────────────────────
|
|
200
|
+
export function normalizeCatalog(raw) {
|
|
201
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw))
|
|
202
|
+
throw new Error("catalog is not an object");
|
|
203
|
+
const c = raw;
|
|
204
|
+
if (typeof c.version !== "string" || c.version === "")
|
|
205
|
+
throw new Error("catalog has no version");
|
|
206
|
+
if (!c.skills || typeof c.skills !== "object" || Array.isArray(c.skills))
|
|
207
|
+
throw new Error("catalog has no skills");
|
|
208
|
+
const skills = {};
|
|
209
|
+
for (const [name, entry] of Object.entries(c.skills)) {
|
|
210
|
+
const e = (entry && typeof entry === "object" ? entry : {});
|
|
211
|
+
skills[name] = {
|
|
212
|
+
description: typeof e.description === "string" ? e.description : "",
|
|
213
|
+
requires: Array.isArray(e.requires) ? e.requires.filter((r) => typeof r === "string") : [],
|
|
214
|
+
...(e.tools !== undefined ? { tools: e.tools } : {}),
|
|
215
|
+
...(e.files !== undefined ? { files: e.files } : {}),
|
|
216
|
+
};
|
|
217
|
+
}
|
|
218
|
+
const renamed = {};
|
|
219
|
+
if (c.renamed && typeof c.renamed === "object" && !Array.isArray(c.renamed)) {
|
|
220
|
+
for (const [from, to] of Object.entries(c.renamed)) {
|
|
221
|
+
if (typeof to === "string")
|
|
222
|
+
renamed[from] = to;
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
const assets = normalizeAssets(c.assets);
|
|
226
|
+
return {
|
|
227
|
+
schema: typeof c.schema === "number" ? c.schema : 1,
|
|
228
|
+
version: c.version,
|
|
229
|
+
skills,
|
|
230
|
+
renamed,
|
|
231
|
+
...(assets ? { assets } : {}),
|
|
232
|
+
};
|
|
233
|
+
}
|
|
234
|
+
const SHA256_HEX = /^[0-9a-f]{64}$/;
|
|
235
|
+
/** Keep only well-formed asset records; a malformed one counts as absent, never as a match. */
|
|
236
|
+
function normalizeAssets(raw) {
|
|
237
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw))
|
|
238
|
+
return null;
|
|
239
|
+
const out = {};
|
|
240
|
+
for (const [name, entry] of Object.entries(raw)) {
|
|
241
|
+
if (!entry || typeof entry !== "object" || Array.isArray(entry))
|
|
242
|
+
continue;
|
|
243
|
+
const e = entry;
|
|
244
|
+
const asset = {};
|
|
245
|
+
if (typeof e.sha256 === "string" && SHA256_HEX.test(e.sha256.toLowerCase()))
|
|
246
|
+
asset.sha256 = e.sha256.toLowerCase();
|
|
247
|
+
if (typeof e.bytes === "number" && Number.isInteger(e.bytes) && e.bytes >= 0)
|
|
248
|
+
asset.bytes = e.bytes;
|
|
249
|
+
if (asset.sha256 !== undefined || asset.bytes !== undefined)
|
|
250
|
+
out[name] = asset;
|
|
251
|
+
}
|
|
252
|
+
return Object.keys(out).length > 0 ? out : null;
|
|
253
|
+
}
|
|
254
|
+
/** File count a catalog entry advertises, when it does. */
|
|
255
|
+
export function catalogFileCount(entry) {
|
|
256
|
+
if (!entry)
|
|
257
|
+
return null;
|
|
258
|
+
if (Array.isArray(entry.files))
|
|
259
|
+
return entry.files.length;
|
|
260
|
+
if (typeof entry.files === "number")
|
|
261
|
+
return entry.files;
|
|
262
|
+
return null;
|
|
263
|
+
}
|
|
264
|
+
// ─── versions ────────────────────────────────────────────────────────────────
|
|
265
|
+
/** `v2026.10.27` and `2026.10.27` are the same release. */
|
|
266
|
+
export function versionsEqual(a, b) {
|
|
267
|
+
if (!a || !b)
|
|
268
|
+
return false;
|
|
269
|
+
return a.replace(/^v/, "") === b.replace(/^v/, "");
|
|
270
|
+
}
|
|
271
|
+
/** Display form: one leading `v` for a tag; a commit pin shows its first 12 hex digits. */
|
|
272
|
+
export function fmtVersion(v) {
|
|
273
|
+
if (!v)
|
|
274
|
+
return "unversioned";
|
|
275
|
+
if (/^[0-9a-f]{40}$/.test(v))
|
|
276
|
+
return v.slice(0, 12);
|
|
277
|
+
return v.startsWith("v") ? v : `v${v}`;
|
|
278
|
+
}
|
|
279
|
+
/** Parse a release tag `vYYYY.MM.DD[.N]` into a comparable tuple. Null for anything else. */
|
|
280
|
+
function parseDateTag(v) {
|
|
281
|
+
const m = /^v?(\d{4})\.(\d{1,2})\.(\d{1,2})(?:\.(\d+))?$/.exec(v);
|
|
282
|
+
if (!m)
|
|
283
|
+
return null;
|
|
284
|
+
return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4] ?? 0)];
|
|
285
|
+
}
|
|
286
|
+
/**
|
|
287
|
+
* Order two versions. Identical strings (modulo the leading `v`) are the
|
|
288
|
+
* same version whatever their form, and two absent versions are too; two
|
|
289
|
+
* different release tags `vYYYY.MM.DD[.N]` order by date; anything else —
|
|
290
|
+
* a commit pin, an unknown format, one side missing — is not comparable,
|
|
291
|
+
* and the installer never guesses which is newer.
|
|
292
|
+
*/
|
|
293
|
+
export function compareVersions(candidate, installed) {
|
|
294
|
+
const a = candidate || null;
|
|
295
|
+
const b = installed || null;
|
|
296
|
+
if (a === null || b === null)
|
|
297
|
+
return a === null && b === null ? 0 : null;
|
|
298
|
+
if (a.replace(/^v/, "") === b.replace(/^v/, ""))
|
|
299
|
+
return 0;
|
|
300
|
+
const pa = parseDateTag(a);
|
|
301
|
+
const pb = parseDateTag(b);
|
|
302
|
+
if (!pa || !pb)
|
|
303
|
+
return null;
|
|
304
|
+
for (let i = 0; i < pa.length; i += 1) {
|
|
305
|
+
if (pa[i] !== pb[i])
|
|
306
|
+
return pa[i] > pb[i] ? 1 : -1;
|
|
307
|
+
}
|
|
308
|
+
return 0;
|
|
309
|
+
}
|
|
310
|
+
/** True only when both are release tags and `candidate` is strictly newer. */
|
|
311
|
+
export function isNewerVersion(candidate, installed) {
|
|
312
|
+
return compareVersions(candidate, installed) === 1;
|
|
313
|
+
}
|
|
314
|
+
export class ReleaseError extends Error {
|
|
315
|
+
url;
|
|
316
|
+
kind;
|
|
317
|
+
constructor(message, url, kind = "catalog-unreachable") {
|
|
318
|
+
super(message);
|
|
319
|
+
this.url = url;
|
|
320
|
+
this.kind = kind;
|
|
321
|
+
}
|
|
322
|
+
}
|
|
323
|
+
export function releaseSource() {
|
|
324
|
+
const raw = process.env[RELEASE_ENV];
|
|
325
|
+
if (!raw)
|
|
326
|
+
return { kind: "http", base: RELEASE_BASE };
|
|
327
|
+
if (raw.startsWith("file://"))
|
|
328
|
+
return { kind: "dir", dir: fileURLToPath(raw) };
|
|
329
|
+
if (/^https?:\/\//i.test(raw))
|
|
330
|
+
return { kind: "http", base: raw.replace(/\/+$/, "") };
|
|
331
|
+
return { kind: "dir", dir: path.resolve(raw) };
|
|
332
|
+
}
|
|
333
|
+
export function catalogUrl(source = releaseSource()) {
|
|
334
|
+
return source.kind === "http"
|
|
335
|
+
? `${source.base}/latest/download/catalog.json`
|
|
336
|
+
: path.join(source.dir, "catalog.json");
|
|
337
|
+
}
|
|
338
|
+
export function tarballUrl(version, source = releaseSource()) {
|
|
339
|
+
if (source.kind === "dir")
|
|
340
|
+
return path.join(source.dir, TARBALL_ASSET);
|
|
341
|
+
return version
|
|
342
|
+
? `${source.base}/download/${encodeURIComponent(version)}/${TARBALL_ASSET}`
|
|
343
|
+
: `${source.base}/latest/download/${TARBALL_ASSET}`;
|
|
344
|
+
}
|
|
345
|
+
/** The address a person can download by hand when the CLI cannot. */
|
|
346
|
+
export function manualDownloadUrl(source = releaseSource()) {
|
|
347
|
+
return tarballUrl(null, source);
|
|
348
|
+
}
|
|
349
|
+
async function fetchBytes(url, timeoutMs) {
|
|
350
|
+
let res;
|
|
351
|
+
try {
|
|
352
|
+
res = await fetch(url, { redirect: "follow", signal: AbortSignal.timeout(timeoutMs) });
|
|
353
|
+
}
|
|
354
|
+
catch (err) {
|
|
355
|
+
throw new ReleaseError(`cannot reach ${url}: ${err.message}`, url);
|
|
356
|
+
}
|
|
357
|
+
if (!res.ok)
|
|
358
|
+
throw new ReleaseError(`${url} answered HTTP ${res.status}`, url);
|
|
359
|
+
return Buffer.from(await res.arrayBuffer());
|
|
360
|
+
}
|
|
361
|
+
function readLocal(file) {
|
|
362
|
+
try {
|
|
363
|
+
return readFileSync(file);
|
|
364
|
+
}
|
|
365
|
+
catch (err) {
|
|
366
|
+
const code = err.code;
|
|
367
|
+
throw new ReleaseError(`cannot read ${file}${code ? ` (${code})` : `: ${err.message}`}`, file);
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
/** The latest `catalog.json`. Throws `ReleaseError` when it cannot be had. */
|
|
371
|
+
export async function fetchLatestCatalog(source = releaseSource()) {
|
|
372
|
+
const url = catalogUrl(source);
|
|
373
|
+
const bytes = source.kind === "dir" ? readLocal(url) : await fetchBytes(url, 20_000);
|
|
374
|
+
try {
|
|
375
|
+
return normalizeCatalog(JSON.parse(bytes.toString("utf8")));
|
|
376
|
+
}
|
|
377
|
+
catch (err) {
|
|
378
|
+
throw new ReleaseError(`${url} is not a skills catalog: ${err.message}`, url);
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
/**
|
|
382
|
+
* `skills.tar.gz` for the catalog's version, falling back to the latest asset
|
|
383
|
+
* when the tagged one is missing. The release catalog must name the
|
|
384
|
+
* tarball's sha256 under `assets["skills.tar.gz"]`: without it nothing is
|
|
385
|
+
* downloaded, and a download whose bytes do not hash to it is refused. Both
|
|
386
|
+
* are a `ReleaseError` of kind `integrity`. (The committed catalog, and so
|
|
387
|
+
* the embedded snapshot, never carries `assets`; it is never used to fetch.)
|
|
388
|
+
*/
|
|
389
|
+
export async function fetchSkillsTarball(catalog, source = releaseSource()) {
|
|
390
|
+
const version = catalog.version || null;
|
|
391
|
+
let url = tarballUrl(version, source);
|
|
392
|
+
const expected = catalog.assets?.[TARBALL_ASSET]?.sha256;
|
|
393
|
+
if (!expected) {
|
|
394
|
+
throw new ReleaseError(`release catalog carries no tarball checksum (assets["${TARBALL_ASSET}"].sha256), so ${url} cannot be verified`, url, "integrity");
|
|
395
|
+
}
|
|
396
|
+
let bytes;
|
|
397
|
+
if (source.kind === "dir") {
|
|
398
|
+
bytes = readLocal(url);
|
|
399
|
+
}
|
|
400
|
+
else {
|
|
401
|
+
try {
|
|
402
|
+
bytes = await fetchBytes(url, 120_000);
|
|
403
|
+
}
|
|
404
|
+
catch (err) {
|
|
405
|
+
if (!version)
|
|
406
|
+
throw err;
|
|
407
|
+
url = tarballUrl(null, source);
|
|
408
|
+
bytes = await fetchBytes(url, 120_000);
|
|
409
|
+
}
|
|
410
|
+
}
|
|
411
|
+
const actual = sha256(bytes);
|
|
412
|
+
if (actual !== expected) {
|
|
413
|
+
throw new ReleaseError(`${url} does not match the catalog: sha256 ${actual}, catalog says ${expected}`, url, "integrity");
|
|
414
|
+
}
|
|
415
|
+
return bytes;
|
|
416
|
+
}
|
|
417
|
+
/**
|
|
418
|
+
* Pull `names` out of a release tarball as payloads. The tarball's top-level
|
|
419
|
+
* entries are skill directories; anything else is ignored. A name missing
|
|
420
|
+
* from the archive is simply absent from the result.
|
|
421
|
+
*/
|
|
422
|
+
export function extractSkills(tgz, names, version) {
|
|
423
|
+
const wanted = new Set(names);
|
|
424
|
+
const out = new Map();
|
|
425
|
+
for (const entry of readTarGz(tgz)) {
|
|
426
|
+
if (entry.type !== "file")
|
|
427
|
+
continue;
|
|
428
|
+
const slash = entry.path.indexOf("/");
|
|
429
|
+
if (slash === -1)
|
|
430
|
+
continue;
|
|
431
|
+
const name = entry.path.slice(0, slash);
|
|
432
|
+
if (!wanted.has(name))
|
|
433
|
+
continue;
|
|
434
|
+
let payload = out.get(name);
|
|
435
|
+
if (!payload) {
|
|
436
|
+
payload = { name, version, source: "catalog", files: new Map() };
|
|
437
|
+
out.set(name, payload);
|
|
438
|
+
}
|
|
439
|
+
payload.files.set(entry.path.slice(slash + 1), entry.data);
|
|
440
|
+
}
|
|
441
|
+
return out;
|
|
442
|
+
}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
export type PathKind = "absent" | "file" | "dir" | "symlink" | "other";
|
|
2
|
+
/** What sits at `p`, without following a symlink. */
|
|
3
|
+
export declare function kindOf(p: string): PathKind;
|
|
4
|
+
export declare function sha256(data: Buffer | string): string;
|
|
5
|
+
export declare function hashFile(p: string): string;
|
|
6
|
+
/**
|
|
7
|
+
* Normalize an archive or manifest path. Returns `null` for anything that is
|
|
8
|
+
* not a plain relative file path: absolute paths, drive letters, `..`
|
|
9
|
+
* segments, backslashes, NULs. `./a/./b` becomes `a/b`.
|
|
10
|
+
*/
|
|
11
|
+
export declare function safeRelativePath(raw: unknown): string | null;
|
|
12
|
+
export interface DirListing {
|
|
13
|
+
/** Regular files, forward-slash relative, sorted. */
|
|
14
|
+
files: string[];
|
|
15
|
+
/** Symlinks and anything else that is neither a file nor a directory. Never followed. */
|
|
16
|
+
others: string[];
|
|
17
|
+
}
|
|
18
|
+
/** Every entry under `dir`, never descending into a symlinked directory. */
|
|
19
|
+
export declare function listDir(dir: string, prefix?: string): DirListing;
|
|
20
|
+
/** Every regular file under `dir`, as forward-slash relative paths, sorted. */
|
|
21
|
+
export declare function walkFiles(dir: string): string[];
|
|
22
|
+
/**
|
|
23
|
+
* `p` with every symlink in its longest existing prefix resolved; the part
|
|
24
|
+
* that does not exist yet is appended as given. This is how a scope's skills
|
|
25
|
+
* directory is canonicalised once per command: a symlinked `~/.claude/skills`
|
|
26
|
+
* (a dotfiles setup) is followed to where it points, and every path derived
|
|
27
|
+
* from it is the real one.
|
|
28
|
+
*/
|
|
29
|
+
export declare function resolveExisting(p: string): string;
|
|
30
|
+
/** True when `child` is exactly `<parent>/<one segment>`. */
|
|
31
|
+
export declare function isDirectChild(parent: string, child: string): boolean;
|
|
32
|
+
/** True when any directory between `root` and `root/rel` is a symlink. */
|
|
33
|
+
export declare function hasSymlinkAncestor(root: string, rel: string): boolean;
|
|
34
|
+
export declare class ContainmentError extends Error {
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* A skill directory as the installer is allowed to touch it. `skillDir` is
|
|
38
|
+
* the path addressed (a direct child of the scope's skills directory, which
|
|
39
|
+
* was itself resolved when the command began). `pinnedReal` is what that
|
|
40
|
+
* path resolved to at the same moment — its realpath when it existed, or
|
|
41
|
+
* the intended path below the resolved scope directory when it did not —
|
|
42
|
+
* and it is never recomputed: it is the one value every later write is
|
|
43
|
+
* checked against.
|
|
44
|
+
*/
|
|
45
|
+
export interface OwnedDir {
|
|
46
|
+
skillDir: string;
|
|
47
|
+
pinnedReal: string;
|
|
48
|
+
}
|
|
49
|
+
/** Pin a skill directory: the descriptor every mutation under it must present. */
|
|
50
|
+
export declare function pinOwnedDir(skillDir: string): OwnedDir;
|
|
51
|
+
/**
|
|
52
|
+
* The one way the installer addresses a path under a skill directory. Runs
|
|
53
|
+
* in full on every call, `rel === ""` (the skill directory itself) included:
|
|
54
|
+
*
|
|
55
|
+
* - `rel` must be a plain relative path: already normalised, no `..`, not
|
|
56
|
+
* absolute, no backslash, no NUL.
|
|
57
|
+
* - (a) Every existing component from the pinned scope directory down to
|
|
58
|
+
* the target — the scope directory, the skill directory, each part of
|
|
59
|
+
* `rel` — is `lstat`ed and must not be a symlink.
|
|
60
|
+
* - (b) The realpath of the target's longest existing prefix must equal,
|
|
61
|
+
* as a string, the same-depth prefix of `pinnedReal/rel`. A parent
|
|
62
|
+
* swapped for a symlink after the pin was taken resolves elsewhere and
|
|
63
|
+
* is refused, however plausible the new place looks.
|
|
64
|
+
*
|
|
65
|
+
* Throws `ContainmentError`; never returns a path it did not prove.
|
|
66
|
+
*/
|
|
67
|
+
export declare function safeTarget(owned: OwnedDir, rel: string): string;
|
|
68
|
+
/** `mkdir -p` of `rel` (a directory path; `""` for the skill directory itself) inside the owned directory. */
|
|
69
|
+
export declare function ensureOwnedDir(owned: OwnedDir, rel: string): string;
|
|
70
|
+
/** Write `bytes` at `rel` inside the owned directory, creating parent directories. Returns the absolute path. */
|
|
71
|
+
export declare function writeOwnedFile(owned: OwnedDir, rel: string, bytes: Buffer | string): string;
|
|
72
|
+
/** Unlink the regular file at `rel` inside the owned directory. Returns the absolute path. */
|
|
73
|
+
export declare function unlinkOwnedFile(owned: OwnedDir, rel: string): string;
|
|
74
|
+
/** Remove the directory at `rel` (`""` for the skill directory itself) when it is empty. True when removed. */
|
|
75
|
+
export declare function removeEmptyOwnedDir(owned: OwnedDir, rel: string): boolean;
|
|
76
|
+
/**
|
|
77
|
+
* Write one of the installer's own state files (preferences, reminder
|
|
78
|
+
* receipts) under the CLI state directory: the directory is created, a
|
|
79
|
+
* symlink at the file's path is refused rather than written through, and
|
|
80
|
+
* the bytes land atomically (a temporary file beside it, then rename) so a
|
|
81
|
+
* reader never sees a half-written file.
|
|
82
|
+
*/
|
|
83
|
+
export declare function writeStateFile(file: string, data: string): void;
|
|
84
|
+
/**
|
|
85
|
+
* Remove now-empty parent directories of `rel` inside the owned directory,
|
|
86
|
+
* innermost first. The skill directory itself is removed only when
|
|
87
|
+
* `includeRoot` is set and it is empty.
|
|
88
|
+
*/
|
|
89
|
+
export declare function pruneEmptyDirs(owned: OwnedDir, rel: string, includeRoot?: boolean): void;
|