@warmhub/cli 0.87.0 → 0.88.0

package/dist/wh.js

@@ -43379,7 +43379,7 @@ function completedOperationsFrom(result) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.85.0",
+  version: "0.86.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -60702,10 +60702,10 @@ var checkpointFlags = {
   latest: flag.boolean({
     description: "Use the latest completed checkpoint"
   }),
-  archive: flag.boolean({ description: "Download the checkpoint archive" }),
-  manifest: flag.boolean({ description: "Download the checkpoint manifest" }),
+  archive: flag.boolean({ description: "Select the checkpoint archive" }),
+  manifest: flag.boolean({ description: "Select the checkpoint manifest" }),
   chunk: flag.string({
-    description: "Download this checkpoint chunk path",
+    description: "Select this checkpoint chunk path",
     constraints: { nonEmpty: true }
   }),
   output: flag.string({
@@ -60714,6 +60714,8 @@ var checkpointFlags = {
   })
 };
 var CHECKPOINT_ID_EXAMPLE = "0198f6d5-78aa-7000-8000-000000000001";
+var CHECKPOINT_ACCESS_EXAMPLE = "wh repo checkpoint access acme/widgets --latest --archive";
+var CHECKPOINT_DOWNLOAD_EXAMPLE = "wh repo checkpoint download acme/widgets --latest --archive --output checkpoint.zip";
 var CHECKPOINT_READ_NOTE = "Requires unrestricted repo:read plus repo:checkpoint-read.";
 var CHECKPOINT_MANAGEMENT_NOTE = "Requires unrestricted repo:read, repo:checkpoint-read, and repo:admin.";
 var generateFlags = {
@@ -60728,13 +60730,16 @@ var retryFlags = {
   checkpoint: checkpointFlags.checkpoint,
   wait: checkpointFlags.wait
 };
-var downloadFlags = {
+var accessFlags = {
   latest: checkpointFlags.latest,
   checkpoint: checkpointFlags.checkpoint,
   "repo-seq": checkpointFlags["repo-seq"],
   archive: checkpointFlags.archive,
   manifest: checkpointFlags.manifest,
-  chunk: checkpointFlags.chunk,
+  chunk: checkpointFlags.chunk
+};
+var downloadFlags = {
+  ...accessFlags,
   output: checkpointFlags.output
 };
 function repoFor(ctx, args) {
@@ -60760,19 +60765,30 @@ function selectCheckpoint(flags) {
     return { repoSeq };
   throw new Error("Checkpoint selector was validated without a selector");
 }
-function selectDownloadCheckpoint(flags) {
+function selectArtifactCheckpoint(flags, example) {
   const selected = Number(flags.latest === true) + Number(flags.checkpoint !== undefined) + Number(flags["repo-seq"] !== undefined);
   if (selected !== 1) {
-    usageError("Provide exactly one checkpoint selector: --latest, --checkpoint, or --repo-seq.", "wh repo checkpoint download acme/widgets --latest --archive --output checkpoint.zip");
+    usageError("Provide exactly one checkpoint selector: --latest, --checkpoint, or --repo-seq.", example);
   }
   if (flags.latest)
     return "latest";
   return selectCheckpoint(flags);
 }
-function selectArtifact(flags) {
+function printAccess(ctx, result) {
+  writeOutput(ctx, result, () => {
+    ctx.out(`Checkpoint: ${result.checkpointId}`);
+    ctx.out(`Repository sequence: ${result.repoSeq}`);
+    ctx.out(`Content type: ${result.contentType}`);
+    ctx.out(`Bytes: ${result.byteLength}`);
+    ctx.out(`SHA-256: ${result.sha256}`);
+    ctx.out(`Expires at: ${result.expiresAt.toISOString()}`);
+    ctx.out(`URL: ${result.url}`);
+  });
+}
+function selectArtifact(flags, example) {
   const selected = Number(flags.archive === true) + Number(flags.manifest === true) + Number(flags.chunk !== undefined);
   if (selected !== 1) {
-    usageError("Provide exactly one artifact selector: --archive, --manifest, or --chunk PATH.", "wh repo checkpoint download acme/widgets --latest --archive --output checkpoint.zip");
+    usageError("Provide exactly one artifact selector: --archive, --manifest, or --chunk PATH.", example);
   }
   if (flags.archive)
     return "archive";
@@ -60858,15 +60874,15 @@ var handleRetry = async (ctx, { args, flags }) => {
 };
 var handleDownload = async (ctx, { args, flags }) => {
   if (!flags.output) {
-    usageError("--output PATH|- is required for download.", "wh repo checkpoint download acme/widgets --latest --archive --output checkpoint.zip");
+    usageError("--output PATH|- is required for download.", CHECKPOINT_DOWNLOAD_EXAMPLE);
   }
   if (flags.output === "-" && ctx.format !== "pretty") {
     throw new CliError(2 /* UserInput */, "USER_INPUT", "Binary stdout requires --format pretty; JSON and JSONL cannot carry artifact bytes.");
   }
   const { org, repo } = repoFor(ctx, args);
   const access = await checkpointClient(ctx).getAccess(org, repo, {
-    checkpoint: selectDownloadCheckpoint(flags),
-    artifact: selectArtifact(flags)
+    checkpoint: selectArtifactCheckpoint(flags, CHECKPOINT_DOWNLOAD_EXAMPLE),
+    artifact: selectArtifact(flags, CHECKPOINT_DOWNLOAD_EXAMPLE)
   });
   if (!ctx.rawFetch) {
     throw new CliError(1 /* Runtime */, "UNKNOWN", "Raw signed-URL transport is unavailable for this command context.");
@@ -60878,6 +60894,13 @@ var handleDownload = async (ctx, { args, flags }) => {
   if (flags.output !== "-")
     ctx.status(`Downloaded checkpoint artifact to ${flags.output}`);
 };
+var handleAccess = async (ctx, { args, flags }) => {
+  const { org, repo } = repoFor(ctx, args);
+  printAccess(ctx, await checkpointClient(ctx).getAccess(org, repo, {
+    checkpoint: selectArtifactCheckpoint(flags, CHECKPOINT_ACCESS_EXAMPLE),
+    artifact: selectArtifact(flags, CHECKPOINT_ACCESS_EXAMPLE)
+  }));
+};
 var handleVerify = async (ctx, { args }) => {
   const archive = args[0];
   if (!archive) {
@@ -60905,7 +60928,7 @@ var handleVerify = async (ctx, { args }) => {
 };
 var CHECKPOINT_SUBDOMAIN = defineDomain({
   name: "checkpoint",
-  summary: "Generate, download, and verify portable repository checkpoints",
+  summary: "Generate, access, download, and verify repository checkpoints",
   verbs: {
     generate: {
       summary: "Generate a repository checkpoint",
@@ -60945,6 +60968,18 @@ var CHECKPOINT_SUBDOMAIN = defineDomain({
       ],
       handler: handleRetry
     },
+    access: {
+      summary: "Show a short-lived checkpoint artifact URL",
+      args: "[org/repo]",
+      flags: accessFlags,
+      notes: [
+        CHECKPOINT_READ_NOTE,
+        "The URL is a short-lived bearer credential. Handle command output as a secret.",
+        "Requires exactly one checkpoint selector and one artifact selector."
+      ],
+      examples: [CHECKPOINT_ACCESS_EXAMPLE],
+      handler: handleAccess
+    },
     download: {
       summary: "Download one checkpoint artifact",
       args: "[org/repo]",
@@ -60953,9 +60988,7 @@ var CHECKPOINT_SUBDOMAIN = defineDomain({
         CHECKPOINT_READ_NOTE,
         "Requires exactly one checkpoint selector, one artifact selector, and --output PATH|-."
       ],
-      examples: [
-        "wh repo checkpoint download acme/widgets --latest --archive --output checkpoint.zip"
-      ],
+      examples: [CHECKPOINT_DOWNLOAD_EXAMPLE],
       handler: handleDownload
     },
     verify: {
@@ -65810,7 +65843,7 @@ function resolveLogLevel(flagLevel, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.87.0",
+  version: "0.88.0",
   private: false,
   type: "module",
   description: "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -66429,5 +66462,5 @@ process.exitCode = interceptedExitCode === undefined ? await runPreparedCli(laun
   version: package_default3.version
 }) : interceptedExitCode;
 
-//# debugId=8EDFBA735C4E16A864756E2164756E21
-//# warmhub-cli-build-info {"cliVersion":"0.87.0","sdkVersion":"0.85.0"}
+//# debugId=964BFCCE631EA49D64756E2164756E21
+//# warmhub-cli-build-info {"cliVersion":"0.88.0","sdkVersion":"0.86.0"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmhub/cli",
-  "version": "0.87.0",
+  "version": "0.88.0",
   "private": false,
   "type": "module",
   "description": "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",