stow-cli 2.1.0 → 2.2.0

package/dist/chunk-PLZFHPLC.js

@@ -0,0 +1,52 @@
+// src/lib/validate-input.ts
+import path from "path";
+var InputValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "InputValidationError";
+  }
+};
+function validateInput(value, context) {
+  if (value.includes("../") || value.includes("..\\")) {
+    throw new InputValidationError(`${context}: path traversal not allowed`);
+  }
+  if (context !== "url" && value.includes("?")) {
+    throw new InputValidationError(
+      `${context}: embedded query parameters not allowed`
+    );
+  }
+  if (/[\x00-\x08\x0b\x0c\x0e-\x1f]/.test(value)) {
+    throw new InputValidationError(
+      `${context}: control characters not allowed`
+    );
+  }
+  if (/%25/.test(value)) {
+    throw new InputValidationError(
+      `${context}: double-encoded values not allowed`
+    );
+  }
+  if (/%2[fF]/.test(value) || /%2[eE]/.test(value)) {
+    throw new InputValidationError(
+      `${context}: percent-encoded path characters not allowed`
+    );
+  }
+  if (context !== "url" && value.includes("#")) {
+    throw new InputValidationError(
+      `${context}: embedded hash fragments not allowed`
+    );
+  }
+  return value;
+}
+function validateBucketName(name) {
+  return validateInput(name, "bucket name");
+}
+function validateFileKey(key) {
+  return validateInput(key, "file key");
+}
+
+export {
+  InputValidationError,
+  validateInput,
+  validateBucketName,
+  validateFileKey
+};

package/dist/cli.js

@@ -3,6 +3,15 @@ import {
   CLI_DOCS,
   renderCommandHelp
 } from "./chunk-XJDK2CBE.js";
+import {
+  InputValidationError
+} from "./chunk-PLZFHPLC.js";
+import {
+  outputError,
+  setForceHuman,
+  setGlobalFields,
+  setGlobalNdjson
+} from "./chunk-P2BKGBQE.js";
 
 // src/cli.ts
 import { StowError } from "@howells/stow-server";
@@ -10,19 +19,35 @@ import { Command } from "commander";
 var VERSION = "1.0.0";
 function handleError(err) {
   if (err instanceof StowError) {
-    console.error(`Error: ${err.message}`);
+    outputError(err.message, err.code, { status: err.status });
+  } else if (err instanceof InputValidationError) {
+    outputError(err.message, "INPUT_VALIDATION");
   } else if (err instanceof Error) {
-    console.error(`Error: ${err.message}`);
+    outputError(err.message);
   } else {
-    console.error(`Error: ${err}`);
+    outputError(String(err));
   }
-  process.exit(1);
 }
 var program = new Command();
-program.name("stow").description(CLI_DOCS.root.description).version(VERSION).addHelpText("after", renderCommandHelp("root"));
+program.name("stow").description(CLI_DOCS.root.description).version(VERSION).option("--human", "Force human-readable output (default when TTY)").option(
+  "--fields <fields>",
+  "Comma-separated fields to include in output (e.g. key,similarity)"
+).option("--ndjson", "Output as newline-delimited JSON (one object per line)").addHelpText("after", renderCommandHelp("root"));
+program.hook("preAction", () => {
+  const opts2 = program.opts();
+  if (opts2.human) {
+    setForceHuman(true);
+  }
+  if (opts2.fields) {
+    setGlobalFields(opts2.fields);
+  }
+  if (opts2.ndjson) {
+    setGlobalNdjson(true);
+  }
+});
 program.command("drop").description(CLI_DOCS.drop.description).argument("<file>", "File to upload").option("-q, --quiet", "Only output the URL").addHelpText("after", renderCommandHelp("drop")).action(async (file, options) => {
   try {
-    const { uploadDrop } = await import("./upload-5TAWJU5N.js");
+    const { uploadDrop } = await import("./upload-OS6Q6LW5.js");
     await uploadDrop(file, options);
   } catch (err) {
     handleError(err);
@@ -31,7 +56,7 @@ program.command("drop").description(CLI_DOCS.drop.description).argument("<file>"
 program.command("upload").description(CLI_DOCS.upload.description).argument("<file>", "File to upload").option("-b, --bucket <name>", "Bucket name or ID").option("-q, --quiet", "Only output the URL").option("--dry-run", "Preview without uploading").addHelpText("after", renderCommandHelp("upload")).action(
   async (file, options) => {
     try {
-      const { uploadFile } = await import("./upload-5TAWJU5N.js");
+      const { uploadFile } = await import("./upload-OS6Q6LW5.js");
       await uploadFile(file, options);
     } catch (err) {
       handleError(err);
@@ -40,26 +65,26 @@ program.command("upload").description(CLI_DOCS.upload.description).argument("<fi
 );
 var bucketsCmd = program.command("buckets").description(CLI_DOCS.buckets.description).addHelpText("after", renderCommandHelp("buckets")).action(async () => {
   try {
-    const { listBuckets } = await import("./buckets-ESAOL6CH.js");
+    const { listBuckets } = await import("./buckets-ZHP3LBLC.js");
     await listBuckets();
   } catch (err) {
     handleError(err);
   }
 });
-bucketsCmd.command("create").description(CLI_DOCS.bucketsCreate.description).argument("<name>", "Bucket name").option("-d, --description <text>", "Bucket description").option("--public", "Make bucket public").option("--dry-run", "Preview without creating").addHelpText("after", renderCommandHelp("bucketsCreate")).action(
+bucketsCmd.command("create").description(CLI_DOCS.bucketsCreate.description).argument("<name>", "Bucket name").option("-d, --description <text>", "Bucket description").option("--public", "Make bucket public").option("--dry-run", "Preview without creating").option("--input-json <json>", "Raw JSON payload").addHelpText("after", renderCommandHelp("bucketsCreate")).action(
   async (name, options) => {
     try {
-      const { createBucket } = await import("./buckets-ESAOL6CH.js");
+      const { createBucket } = await import("./buckets-ZHP3LBLC.js");
       await createBucket(name, options);
     } catch (err) {
       handleError(err);
     }
   }
 );
-bucketsCmd.command("rename").description(CLI_DOCS.bucketsRename.description).argument("<name>", "Current bucket name").argument("<new-name>", "New bucket name").option("-y, --yes", "Skip confirmation warning").option("--dry-run", "Preview without renaming").addHelpText("after", renderCommandHelp("bucketsRename")).action(
+bucketsCmd.command("rename").description(CLI_DOCS.bucketsRename.description).argument("<name>", "Current bucket name").argument("<new-name>", "New bucket name").option("-y, --yes", "Skip confirmation warning").option("--dry-run", "Preview without renaming").option("--input-json <json>", "Raw JSON payload").addHelpText("after", renderCommandHelp("bucketsRename")).action(
   async (name, newName, options) => {
     try {
-      const { renameBucket } = await import("./buckets-ESAOL6CH.js");
+      const { renameBucket } = await import("./buckets-ZHP3LBLC.js");
       await renameBucket(name, newName, options);
     } catch (err) {
       handleError(err);
@@ -68,7 +93,7 @@ bucketsCmd.command("rename").description(CLI_DOCS.bucketsRename.description).arg
 );
 bucketsCmd.command("delete").description(CLI_DOCS.bucketsDelete.description).argument("<id>", "Bucket ID").option("--dry-run", "Preview without deleting").addHelpText("after", renderCommandHelp("bucketsDelete")).action(async (id, options) => {
   try {
-    const { deleteBucket } = await import("./buckets-ESAOL6CH.js");
+    const { deleteBucket } = await import("./buckets-ZHP3LBLC.js");
     await deleteBucket(id, options);
   } catch (err) {
     handleError(err);
@@ -81,7 +106,7 @@ var filesCmd = program.command("files").description(CLI_DOCS.files.description).
       return;
     }
     try {
-      const { listFiles } = await import("./files-TDIGJDN3.js");
+      const { listFiles } = await import("./files-UQODXWNT.js");
       await listFiles(bucket, options);
     } catch (err) {
       handleError(err);
@@ -90,16 +115,16 @@ var filesCmd = program.command("files").description(CLI_DOCS.files.description).
 );
 filesCmd.command("get").description(CLI_DOCS.filesGet.description).argument("<bucket>", "Bucket name").argument("<key>", "File key").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("filesGet")).action(async (bucket, key, options) => {
   try {
-    const { getFile } = await import("./files-TDIGJDN3.js");
+    const { getFile } = await import("./files-UQODXWNT.js");
     await getFile(bucket, key, options);
   } catch (err) {
     handleError(err);
   }
 });
-filesCmd.command("update").description(CLI_DOCS.filesUpdate.description).argument("<bucket>", "Bucket name").argument("<key>", "File key").option("-m, --metadata <kv...>", "Metadata key=value pairs").option("--json", "Output as JSON").option("--dry-run", "Preview without updating").addHelpText("after", renderCommandHelp("filesUpdate")).action(
+filesCmd.command("update").description(CLI_DOCS.filesUpdate.description).argument("<bucket>", "Bucket name").argument("<key>", "File key").option("-m, --metadata <kv...>", "Metadata key=value pairs").option("--json", "Output as JSON").option("--dry-run", "Preview without updating").option("--input-json <json>", "Raw JSON payload").addHelpText("after", renderCommandHelp("filesUpdate")).action(
   async (bucket, key, options) => {
     try {
-      const { updateFile } = await import("./files-TDIGJDN3.js");
+      const { updateFile } = await import("./files-UQODXWNT.js");
       await updateFile(bucket, key, options);
     } catch (err) {
       handleError(err);
@@ -108,7 +133,7 @@ filesCmd.command("update").description(CLI_DOCS.filesUpdate.description).argumen
 );
 filesCmd.command("enrich").description(CLI_DOCS.filesEnrich.description).argument("<bucket>", "Bucket name").argument("<key>", "File key").addHelpText("after", renderCommandHelp("filesEnrich")).action(async (bucket, key) => {
   try {
-    const { enrichFile } = await import("./files-TDIGJDN3.js");
+    const { enrichFile } = await import("./files-UQODXWNT.js");
     await enrichFile(bucket, key);
   } catch (err) {
     handleError(err);
@@ -117,7 +142,7 @@ filesCmd.command("enrich").description(CLI_DOCS.filesEnrich.description).argumen
 filesCmd.command("missing").description(CLI_DOCS.filesMissing.description).argument("<bucket>", "Bucket name").argument("<type>", "dimensions | embeddings | colors").option("-l, --limit <count>", "Max files to return").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("filesMissing")).action(
   async (bucket, type, options) => {
     try {
-      const { listMissing } = await import("./files-TDIGJDN3.js");
+      const { listMissing } = await import("./files-UQODXWNT.js");
       await listMissing(bucket, type, options);
     } catch (err) {
       handleError(err);
@@ -126,7 +151,7 @@ filesCmd.command("missing").description(CLI_DOCS.filesMissing.description).argum
 );
 var dropsCmd = program.command("drops").description(CLI_DOCS.drops.description).addHelpText("after", renderCommandHelp("drops")).action(async () => {
   try {
-    const { listDrops } = await import("./drops-RD55IDZ4.js");
+    const { listDrops } = await import("./drops-5VIEW3XZ.js");
     await listDrops();
   } catch (err) {
     handleError(err);
@@ -134,7 +159,7 @@ var dropsCmd = program.command("drops").description(CLI_DOCS.drops.description).
 });
 dropsCmd.command("delete").description(CLI_DOCS.dropsDelete.description).argument("<id>", "Drop ID").addHelpText("after", renderCommandHelp("dropsDelete")).action(async (id) => {
   try {
-    const { deleteDrop } = await import("./drops-RD55IDZ4.js");
+    const { deleteDrop } = await import("./drops-5VIEW3XZ.js");
     await deleteDrop(id);
   } catch (err) {
     handleError(err);
@@ -144,7 +169,7 @@ var searchCmd = program.command("search").description(CLI_DOCS.search.descriptio
 searchCmd.command("text").description(CLI_DOCS.searchText.description).argument("<query>", "Search query").option("-b, --bucket <name>", "Bucket name").option("-l, --limit <count>", "Max results").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("searchText")).action(
   async (query, options) => {
     try {
-      const { textSearch } = await import("./search-DV4VV62L.js");
+      const { textSearch } = await import("./search-TRTPX2SQ.js");
       await textSearch(query, options);
     } catch (err) {
       handleError(err);
@@ -154,7 +179,7 @@ searchCmd.command("text").description(CLI_DOCS.searchText.description).argument(
 searchCmd.command("similar").description(CLI_DOCS.searchSimilar.description).requiredOption("--file <key>", "File key to search from").option("-b, --bucket <name>", "Bucket name").option("-l, --limit <count>", "Max results").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("searchSimilar")).action(
   async (options) => {
     try {
-      const { similarSearch } = await import("./search-DV4VV62L.js");
+      const { similarSearch } = await import("./search-TRTPX2SQ.js");
       await similarSearch(options);
     } catch (err) {
       handleError(err);
@@ -164,7 +189,7 @@ searchCmd.command("similar").description(CLI_DOCS.searchSimilar.description).req
 searchCmd.command("color").description(CLI_DOCS.searchColor.description).requiredOption("--hex <color>", "Hex color code").option("-b, --bucket <name>", "Bucket name").option("-l, --limit <count>", "Max results").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("searchColor")).action(
   async (options) => {
     try {
-      const { colorSearch } = await import("./search-DV4VV62L.js");
+      const { colorSearch } = await import("./search-TRTPX2SQ.js");
       await colorSearch(options);
     } catch (err) {
       handleError(err);
@@ -174,7 +199,7 @@ searchCmd.command("color").description(CLI_DOCS.searchColor.description).require
 searchCmd.command("diverse").description(CLI_DOCS.searchDiverse.description).option("-b, --bucket <name>", "Bucket name").option("-l, --limit <count>", "Max results").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("searchDiverse")).action(
   async (options) => {
     try {
-      const { diverseSearch } = await import("./search-DV4VV62L.js");
+      const { diverseSearch } = await import("./search-TRTPX2SQ.js");
       await diverseSearch(options);
     } catch (err) {
       handleError(err);
@@ -183,16 +208,16 @@ searchCmd.command("diverse").description(CLI_DOCS.searchDiverse.description).opt
 );
 var tagsCmd = program.command("tags").description(CLI_DOCS.tags.description).option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("tags")).action(async (options) => {
   try {
-    const { listTags } = await import("./tags-MCFL5M2J.js");
+    const { listTags } = await import("./tags-VH44BGQL.js");
     await listTags(options);
   } catch (err) {
     handleError(err);
   }
 });
-tagsCmd.command("create").description(CLI_DOCS.tagsCreate.description).argument("<name>", "Tag name").option("--color <hex>", "Tag color (hex)").option("--json", "Output as JSON").option("--dry-run", "Preview without creating").addHelpText("after", renderCommandHelp("tagsCreate")).action(
+tagsCmd.command("create").description(CLI_DOCS.tagsCreate.description).argument("<name>", "Tag name").option("--color <hex>", "Tag color (hex)").option("--json", "Output as JSON").option("--dry-run", "Preview without creating").option("--input-json <json>", "Raw JSON payload").addHelpText("after", renderCommandHelp("tagsCreate")).action(
   async (name, options) => {
     try {
-      const { createTag } = await import("./tags-MCFL5M2J.js");
+      const { createTag } = await import("./tags-VH44BGQL.js");
       await createTag(name, options);
     } catch (err) {
       handleError(err);
@@ -201,7 +226,7 @@ tagsCmd.command("create").description(CLI_DOCS.tagsCreate.description).argument(
 );
 tagsCmd.command("delete").description(CLI_DOCS.tagsDelete.description).argument("<id>", "Tag ID").option("--dry-run", "Preview without deleting").addHelpText("after", renderCommandHelp("tagsDelete")).action(async (id, options) => {
   try {
-    const { deleteTag } = await import("./tags-MCFL5M2J.js");
+    const { deleteTag } = await import("./tags-VH44BGQL.js");
     await deleteTag(id, options);
   } catch (err) {
     handleError(err);
@@ -211,7 +236,7 @@ var profilesCmd = program.command("profiles").description(CLI_DOCS.profiles.desc
 profilesCmd.command("create").description(CLI_DOCS.profilesCreate.description).requiredOption("--name <name>", "Profile name").option("-b, --bucket <id>", "Bucket ID").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("profilesCreate")).action(
   async (options) => {
     try {
-      const { createProfile } = await import("./profiles-C6SCFXS6.js");
+      const { createProfile } = await import("./profiles-CHBGKQOE.js");
       await createProfile(options);
     } catch (err) {
       handleError(err);
@@ -220,7 +245,7 @@ profilesCmd.command("create").description(CLI_DOCS.profilesCreate.description).r
 );
 profilesCmd.command("get").description(CLI_DOCS.profilesGet.description).argument("<id>", "Profile ID").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("profilesGet")).action(async (id, options) => {
   try {
-    const { getProfile } = await import("./profiles-C6SCFXS6.js");
+    const { getProfile } = await import("./profiles-CHBGKQOE.js");
     await getProfile(id, options);
   } catch (err) {
     handleError(err);
@@ -228,7 +253,7 @@ profilesCmd.command("get").description(CLI_DOCS.profilesGet.description).argumen
 });
 profilesCmd.command("delete").description(CLI_DOCS.profilesDelete.description).argument("<id>", "Profile ID").addHelpText("after", renderCommandHelp("profilesDelete")).action(async (id) => {
   try {
-    const { deleteProfile } = await import("./profiles-C6SCFXS6.js");
+    const { deleteProfile } = await import("./profiles-CHBGKQOE.js");
     await deleteProfile(id);
   } catch (err) {
     handleError(err);
@@ -237,7 +262,7 @@ profilesCmd.command("delete").description(CLI_DOCS.profilesDelete.description).a
 var jobsCmd = program.command("jobs").description(CLI_DOCS.jobs.description).requiredOption("-b, --bucket <id>", "Bucket ID (required)").option("-s, --status <status>", "Filter by status").option("-q, --queue <name>", "Filter by queue name").option("-l, --limit <count>", "Max jobs to return").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("jobs")).action(
   async (options) => {
     try {
-      const { listJobs } = await import("./jobs-CLXYKZ3B.js");
+      const { listJobs } = await import("./jobs-PTV2W5PJ.js");
       await listJobs(options.bucket, options);
     } catch (err) {
       handleError(err);
@@ -246,7 +271,7 @@ var jobsCmd = program.command("jobs").description(CLI_DOCS.jobs.description).req
 );
 jobsCmd.command("retry").description(CLI_DOCS.jobsRetry.description).argument("<id>", "Job ID").requiredOption("-q, --queue <name>", "Queue name").requiredOption("-b, --bucket <id>", "Bucket ID").addHelpText("after", renderCommandHelp("jobsRetry")).action(async (id, options) => {
   try {
-    const { retryJob } = await import("./jobs-CLXYKZ3B.js");
+    const { retryJob } = await import("./jobs-PTV2W5PJ.js");
     await retryJob(id, options);
   } catch (err) {
     handleError(err);
@@ -254,7 +279,7 @@ jobsCmd.command("retry").description(CLI_DOCS.jobsRetry.description).argument("<
 });
 jobsCmd.command("delete").description(CLI_DOCS.jobsDelete.description).argument("<id>", "Job ID").requiredOption("-q, --queue <name>", "Queue name").requiredOption("-b, --bucket <id>", "Bucket ID").addHelpText("after", renderCommandHelp("jobsDelete")).action(async (id, options) => {
   try {
-    const { deleteJob } = await import("./jobs-CLXYKZ3B.js");
+    const { deleteJob } = await import("./jobs-PTV2W5PJ.js");
     await deleteJob(id, options);
   } catch (err) {
     handleError(err);
@@ -263,7 +288,7 @@ jobsCmd.command("delete").description(CLI_DOCS.jobsDelete.description).argument(
 var adminCmd = program.command("admin").description(CLI_DOCS.admin.description).addHelpText("after", renderCommandHelp("admin"));
 adminCmd.command("health").description(CLI_DOCS.adminHealth.description).option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminHealth")).action(async (options) => {
   try {
-    const { health } = await import("./health-6LWM7KAT.js");
+    const { health } = await import("./health-RICGWQGN.js");
     await health(options);
   } catch (err) {
     handleError(err);
@@ -273,7 +298,7 @@ var backfillCmd = adminCmd.command("backfill").description(CLI_DOCS.adminBackfil
 backfillCmd.command("dimensions").description("Backfill image dimensions").option("--bucket <id>", "Bucket ID").option("-l, --limit <count>", "Max files to enqueue").option("--dry-run", "Preview without enqueuing").option("--json", "Output as JSON").action(
   async (options) => {
     try {
-      const { backfillDimensions } = await import("./backfill-G57M2BRA.js");
+      const { backfillDimensions } = await import("./backfill-EVZT7RH6.js");
       await backfillDimensions(options);
     } catch (err) {
       handleError(err);
@@ -283,7 +308,7 @@ backfillCmd.command("dimensions").description("Backfill image dimensions").optio
 backfillCmd.command("colors").description("Backfill color extraction").option("--bucket <id>", "Bucket ID").option("-l, --limit <count>", "Max files to enqueue").option("--dry-run", "Preview without enqueuing").option("--json", "Output as JSON").action(
   async (options) => {
     try {
-      const { backfillColors } = await import("./backfill-G57M2BRA.js");
+      const { backfillColors } = await import("./backfill-EVZT7RH6.js");
       await backfillColors(options);
     } catch (err) {
       handleError(err);
@@ -293,7 +318,7 @@ backfillCmd.command("colors").description("Backfill color extraction").option("-
 backfillCmd.command("embeddings").description("Backfill embedding generation").option("--bucket <id>", "Bucket ID").option("-l, --limit <count>", "Max files to enqueue").option("--dry-run", "Preview without enqueuing").option("--json", "Output as JSON").action(
   async (options) => {
     try {
-      const { backfillEmbeddings } = await import("./backfill-G57M2BRA.js");
+      const { backfillEmbeddings } = await import("./backfill-EVZT7RH6.js");
       await backfillEmbeddings(options);
     } catch (err) {
       handleError(err);
@@ -303,7 +328,7 @@ backfillCmd.command("embeddings").description("Backfill embedding generation").o
 adminCmd.command("cleanup-drops").description(CLI_DOCS.adminCleanupDrops.description).option("--max-age-hours <hours>", "Max age in hours").option("--dry-run", "Preview without deleting").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminCleanupDrops")).action(
   async (options) => {
     try {
-      const { cleanupDrops } = await import("./maintenance-7LOAGG6J.js");
+      const { cleanupDrops } = await import("./maintenance-ZJW2ES4L.js");
       await cleanupDrops(options);
     } catch (err) {
       handleError(err);
@@ -312,7 +337,7 @@ adminCmd.command("cleanup-drops").description(CLI_DOCS.adminCleanupDrops.descrip
 );
 adminCmd.command("purge-events").description(CLI_DOCS.adminPurgeEvents.description).option("--dry-run", "Preview without deleting").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminPurgeEvents")).action(async (options) => {
   try {
-    const { purgeEvents } = await import("./maintenance-7LOAGG6J.js");
+    const { purgeEvents } = await import("./maintenance-ZJW2ES4L.js");
     await purgeEvents(options);
   } catch (err) {
     handleError(err);
@@ -321,7 +346,7 @@ adminCmd.command("purge-events").description(CLI_DOCS.adminPurgeEvents.descripti
 adminCmd.command("reconcile-files").description(CLI_DOCS.adminReconcileFiles.description).requiredOption("--bucket <id>", "Bucket ID").option("--dry-run", "Preview without reconciling").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminReconcileFiles")).action(
   async (options) => {
     try {
-      const { reconcileFiles } = await import("./maintenance-7LOAGG6J.js");
+      const { reconcileFiles } = await import("./maintenance-ZJW2ES4L.js");
       await reconcileFiles(options);
     } catch (err) {
       handleError(err);
@@ -330,7 +355,7 @@ adminCmd.command("reconcile-files").description(CLI_DOCS.adminReconcileFiles.des
 );
 adminCmd.command("retry-sync-failures").description(CLI_DOCS.adminRetrySyncFailures.description).option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminRetrySyncFailures")).action(async (options) => {
   try {
-    const { retrySyncFailures } = await import("./maintenance-7LOAGG6J.js");
+    const { retrySyncFailures } = await import("./maintenance-ZJW2ES4L.js");
     await retrySyncFailures(options);
   } catch (err) {
     handleError(err);
@@ -339,7 +364,7 @@ adminCmd.command("retry-sync-failures").description(CLI_DOCS.adminRetrySyncFailu
 var adminJobsCmd = adminCmd.command("jobs").description(CLI_DOCS.adminJobs.description).option("--org <id>", "Filter by org ID").option("--bucket <id>", "Filter by bucket ID").option("-s, --status <status>", "Filter by status").option("-q, --queue <name>", "Filter by queue name").option("-l, --limit <count>", "Max jobs to return").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminJobs")).action(
   async (options) => {
     try {
-      const { listAdminJobs } = await import("./jobs-K3LTNETU.js");
+      const { listAdminJobs } = await import("./jobs-ZWSEXNFA.js");
       await listAdminJobs(options);
     } catch (err) {
       handleError(err);
@@ -348,7 +373,7 @@ var adminJobsCmd = adminCmd.command("jobs").description(CLI_DOCS.adminJobs.descr
 );
 adminJobsCmd.command("retry").description(CLI_DOCS.adminJobsRetry.description).argument("<id>", "Job ID").requiredOption("-q, --queue <name>", "Queue name").addHelpText("after", renderCommandHelp("adminJobsRetry")).action(async (id, options) => {
   try {
-    const { retryAdminJob } = await import("./jobs-K3LTNETU.js");
+    const { retryAdminJob } = await import("./jobs-ZWSEXNFA.js");
     await retryAdminJob(id, options);
   } catch (err) {
     handleError(err);
@@ -356,7 +381,7 @@ adminJobsCmd.command("retry").description(CLI_DOCS.adminJobsRetry.description).a
 });
 adminJobsCmd.command("delete").description(CLI_DOCS.adminJobsDelete.description).argument("<id>", "Job ID").requiredOption("-q, --queue <name>", "Queue name").addHelpText("after", renderCommandHelp("adminJobsDelete")).action(async (id, options) => {
   try {
-    const { deleteAdminJob } = await import("./jobs-K3LTNETU.js");
+    const { deleteAdminJob } = await import("./jobs-ZWSEXNFA.js");
     await deleteAdminJob(id, options);
   } catch (err) {
     handleError(err);
@@ -364,7 +389,7 @@ adminJobsCmd.command("delete").description(CLI_DOCS.adminJobsDelete.description)
 });
 var adminQueuesCmd = adminCmd.command("queues").description(CLI_DOCS.adminQueues.description).option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminQueues")).action(async (options) => {
   try {
-    const { listQueues } = await import("./queues-2GJAMMNF.js");
+    const { listQueues } = await import("./queues-EZ2VZGXQ.js");
     await listQueues(options);
   } catch (err) {
     handleError(err);
@@ -373,7 +398,7 @@ var adminQueuesCmd = adminCmd.command("queues").description(CLI_DOCS.adminQueues
 adminQueuesCmd.command("clean").description(CLI_DOCS.adminQueuesClean.description).argument("<name>", "Queue name").option("--failed", "Clean failed jobs").option("--completed", "Clean completed jobs").option("--grace <seconds>", "Grace period in seconds").addHelpText("after", renderCommandHelp("adminQueuesClean")).action(
   async (name, options) => {
     try {
-      const { cleanQueue } = await import("./queues-2GJAMMNF.js");
+      const { cleanQueue } = await import("./queues-EZ2VZGXQ.js");
       await cleanQueue(name, options);
     } catch (err) {
       handleError(err);
@@ -383,7 +408,7 @@ adminQueuesCmd.command("clean").description(CLI_DOCS.adminQueuesClean.descriptio
 program.command("delete").description(CLI_DOCS.delete.description).argument("<bucket>", "Bucket name").argument("<key>", "File key").option("--dry-run", "Preview without deleting").addHelpText("after", renderCommandHelp("delete")).action(
   async (bucket, key, options) => {
     try {
-      const { deleteFile } = await import("./delete-4JSVNETO.js");
+      const { deleteFile } = await import("./delete-YEXSMG4I.js");
       await deleteFile(bucket, key, options);
     } catch (err) {
       handleError(err);
@@ -392,7 +417,7 @@ program.command("delete").description(CLI_DOCS.delete.description).argument("<bu
 );
 program.command("whoami").description(CLI_DOCS.whoami.description).addHelpText("after", renderCommandHelp("whoami")).action(async () => {
   try {
-    const { whoami } = await import("./whoami-5IYRZKWS.js");
+    const { whoami } = await import("./whoami-TVRKBM74.js");
     await whoami();
   } catch (err) {
     handleError(err);
@@ -408,7 +433,7 @@ program.command("open").description(CLI_DOCS.open.description).argument("<bucket
 });
 program.command("describe").argument("[command]", "Command path (dot notation, e.g. search.text)").description("Show command schema for AI agents").action(async (command) => {
   try {
-    const { describeCommand } = await import("./describe-UFMXNNUB.js");
+    const { describeCommand } = await import("./describe-J4ZMUXK7.js");
     describeCommand(command ?? "");
   } catch (err) {
     handleError(err);
@@ -427,5 +452,5 @@ program.parse();
 var opts = program.opts();
 var args = process.argv.slice(2);
 if (args.length === 0 || args.length === 1 && opts.interactive) {
-  import("./app-DTW2LNXW.js").then(({ startInteractive }) => startInteractive()).catch(handleError);
+  import("./app-Q6EW7VSM.js").then(({ startInteractive }) => startInteractive()).catch(handleError);
 }

package/dist/delete-YEXSMG4I.js

@@ -0,0 +1,34 @@
+import {
+  validateBucketName,
+  validateFileKey
+} from "./chunk-PLZFHPLC.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/delete.ts
+async function deleteFile(bucket, key, options = {}) {
+  validateBucketName(bucket);
+  validateFileKey(key);
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "deleteFile",
+          details: { bucket, key }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  await stow.deleteFile(key, { bucket });
+  console.log(`Deleted: ${key} from ${bucket}`);
+}
+export {
+  deleteFile
+};

package/dist/describe-J4ZMUXK7.js

@@ -0,0 +1,79 @@
+import {
+  CLI_DOCS
+} from "./chunk-XJDK2CBE.js";
+import {
+  output
+} from "./chunk-P2BKGBQE.js";
+
+// src/commands/describe.ts
+var COMMAND_MAP = {
+  upload: "upload",
+  drop: "drop",
+  delete: "delete",
+  whoami: "whoami",
+  open: "open",
+  buckets: "buckets",
+  "buckets.create": "bucketsCreate",
+  "buckets.rename": "bucketsRename",
+  "buckets.delete": "bucketsDelete",
+  files: "files",
+  "files.get": "filesGet",
+  "files.update": "filesUpdate",
+  "files.enrich": "filesEnrich",
+  "files.missing": "filesMissing",
+  search: "search",
+  "search.text": "searchText",
+  "search.similar": "searchSimilar",
+  "search.color": "searchColor",
+  "search.diverse": "searchDiverse",
+  tags: "tags",
+  "tags.create": "tagsCreate",
+  "tags.delete": "tagsDelete",
+  drops: "drops",
+  "drops.delete": "dropsDelete",
+  profiles: "profiles",
+  "profiles.create": "profilesCreate",
+  "profiles.get": "profilesGet",
+  "profiles.delete": "profilesDelete",
+  jobs: "jobs",
+  "jobs.retry": "jobsRetry",
+  "jobs.delete": "jobsDelete",
+  admin: "admin",
+  "admin.health": "adminHealth",
+  "admin.backfill": "adminBackfill",
+  "admin.cleanup-drops": "adminCleanupDrops",
+  "admin.purge-events": "adminPurgeEvents",
+  "admin.reconcile-files": "adminReconcileFiles",
+  "admin.retry-sync-failures": "adminRetrySyncFailures",
+  "admin.jobs": "adminJobs",
+  "admin.jobs.retry": "adminJobsRetry",
+  "admin.jobs.delete": "adminJobsDelete",
+  "admin.queues": "adminQueues",
+  "admin.queues.clean": "adminQueuesClean"
+};
+function describeCommand(commandPath) {
+  if (!commandPath) {
+    output({
+      commands: Object.keys(COMMAND_MAP).sort()
+    });
+    return;
+  }
+  const docKey = COMMAND_MAP[commandPath];
+  if (!(docKey && CLI_DOCS[docKey])) {
+    console.error(`Unknown command: ${commandPath}`);
+    console.error(`Available: ${Object.keys(COMMAND_MAP).sort().join(", ")}`);
+    process.exit(1);
+    return;
+  }
+  const doc = CLI_DOCS[docKey];
+  output({
+    command: commandPath,
+    description: doc.description,
+    usage: doc.usage,
+    examples: doc.examples,
+    notes: doc.notes ?? []
+  });
+}
+export {
+  describeCommand
+};

package/dist/drops-5VIEW3XZ.js

@@ -0,0 +1,39 @@
+import {
+  formatBytes,
+  formatTable,
+  usageBar
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/drops.ts
+async function listDrops() {
+  const stow = createStow();
+  const data = await stow.listDrops();
+  if (data.drops.length === 0) {
+    console.log("No drops yet. Create one with: stow drop <file>");
+    return;
+  }
+  const rows = data.drops.map((d) => [
+    d.filename,
+    formatBytes(Number(d.size)),
+    d.contentType,
+    d.url
+  ]);
+  console.log(formatTable(["Filename", "Size", "Type", "URL"], rows));
+  console.log(
+    `
+Storage: ${usageBar(data.usage.bytes, data.usage.limit)}  ${formatBytes(data.usage.bytes)} / ${formatBytes(data.usage.limit)}`
+  );
+}
+async function deleteDrop(id) {
+  const stow = createStow();
+  await stow.deleteDrop(id);
+  console.log(`Deleted drop: ${id}`);
+}
+export {
+  deleteDrop,
+  listDrops
+};