stow-cli 2.2.0 → 2.2.1

package/dist/cli.js

@@ -11,12 +11,14 @@ import {
   setForceHuman,
   setGlobalFields,
   setGlobalNdjson
-} from "./chunk-P2BKGBQE.js";
+} from "./chunk-5IX3ASXH.js";
 
 // src/cli.ts
+import { createRequire } from "module";
 import { StowError } from "@howells/stow-server";
 import { Command } from "commander";
-var VERSION = "1.0.0";
+var require2 = createRequire(import.meta.url);
+var { version: VERSION } = require2("../package.json");
 function handleError(err) {
   if (err instanceof StowError) {
     outputError(err.message, err.code, { status: err.status });
@@ -65,7 +67,7 @@ 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-ZHP3LBLC.js");
+    const { listBuckets } = await import("./buckets-AFNX7FV3.js");
     await listBuckets();
   } catch (err) {
     handleError(err);
@@ -74,7 +76,7 @@ var bucketsCmd = program.command("buckets").description(CLI_DOCS.buckets.descrip
 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-ZHP3LBLC.js");
+      const { createBucket } = await import("./buckets-AFNX7FV3.js");
       await createBucket(name, options);
     } catch (err) {
       handleError(err);
@@ -84,7 +86,7 @@ bucketsCmd.command("create").description(CLI_DOCS.bucketsCreate.description).arg
 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-ZHP3LBLC.js");
+      const { renameBucket } = await import("./buckets-AFNX7FV3.js");
       await renameBucket(name, newName, options);
     } catch (err) {
       handleError(err);
@@ -93,7 +95,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-ZHP3LBLC.js");
+    const { deleteBucket } = await import("./buckets-AFNX7FV3.js");
     await deleteBucket(id, options);
   } catch (err) {
     handleError(err);
@@ -106,7 +108,7 @@ var filesCmd = program.command("files").description(CLI_DOCS.files.description).
       return;
     }
     try {
-      const { listFiles } = await import("./files-UQODXWNT.js");
+      const { listFiles } = await import("./files-XU6MDPP4.js");
       await listFiles(bucket, options);
     } catch (err) {
       handleError(err);
@@ -115,7 +117,7 @@ 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-UQODXWNT.js");
+    const { getFile } = await import("./files-XU6MDPP4.js");
     await getFile(bucket, key, options);
   } catch (err) {
     handleError(err);
@@ -124,7 +126,7 @@ filesCmd.command("get").description(CLI_DOCS.filesGet.description).argument("<bu
 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-UQODXWNT.js");
+      const { updateFile } = await import("./files-XU6MDPP4.js");
       await updateFile(bucket, key, options);
     } catch (err) {
       handleError(err);
@@ -133,7 +135,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-UQODXWNT.js");
+    const { enrichFile } = await import("./files-XU6MDPP4.js");
     await enrichFile(bucket, key);
   } catch (err) {
     handleError(err);
@@ -142,7 +144,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-UQODXWNT.js");
+      const { listMissing } = await import("./files-XU6MDPP4.js");
       await listMissing(bucket, type, options);
     } catch (err) {
       handleError(err);
@@ -169,7 +171,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-TRTPX2SQ.js");
+      const { textSearch } = await import("./search-ETC2EXKM.js");
       await textSearch(query, options);
     } catch (err) {
       handleError(err);
@@ -179,7 +181,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-TRTPX2SQ.js");
+      const { similarSearch } = await import("./search-ETC2EXKM.js");
       await similarSearch(options);
     } catch (err) {
       handleError(err);
@@ -189,7 +191,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-TRTPX2SQ.js");
+      const { colorSearch } = await import("./search-ETC2EXKM.js");
       await colorSearch(options);
     } catch (err) {
       handleError(err);
@@ -199,7 +201,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-TRTPX2SQ.js");
+      const { diverseSearch } = await import("./search-ETC2EXKM.js");
       await diverseSearch(options);
     } catch (err) {
       handleError(err);
@@ -208,7 +210,7 @@ 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-VH44BGQL.js");
+    const { listTags } = await import("./tags-TBFPDHIQ.js");
     await listTags(options);
   } catch (err) {
     handleError(err);
@@ -217,7 +219,7 @@ var tagsCmd = program.command("tags").description(CLI_DOCS.tags.description).opt
 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-VH44BGQL.js");
+      const { createTag } = await import("./tags-TBFPDHIQ.js");
       await createTag(name, options);
     } catch (err) {
       handleError(err);
@@ -226,7 +228,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-VH44BGQL.js");
+    const { deleteTag } = await import("./tags-TBFPDHIQ.js");
     await deleteTag(id, options);
   } catch (err) {
     handleError(err);
@@ -236,7 +238,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-CHBGKQOE.js");
+      const { createProfile } = await import("./profiles-MB3TZQE4.js");
       await createProfile(options);
     } catch (err) {
       handleError(err);
@@ -245,7 +247,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-CHBGKQOE.js");
+    const { getProfile } = await import("./profiles-MB3TZQE4.js");
     await getProfile(id, options);
   } catch (err) {
     handleError(err);
@@ -253,7 +255,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-CHBGKQOE.js");
+    const { deleteProfile } = await import("./profiles-MB3TZQE4.js");
     await deleteProfile(id);
   } catch (err) {
     handleError(err);
@@ -262,7 +264,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-PTV2W5PJ.js");
+      const { listJobs } = await import("./jobs-TND5AHCL.js");
       await listJobs(options.bucket, options);
     } catch (err) {
       handleError(err);
@@ -271,7 +273,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-PTV2W5PJ.js");
+    const { retryJob } = await import("./jobs-TND5AHCL.js");
     await retryJob(id, options);
   } catch (err) {
     handleError(err);
@@ -279,7 +281,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-PTV2W5PJ.js");
+    const { deleteJob } = await import("./jobs-TND5AHCL.js");
     await deleteJob(id, options);
   } catch (err) {
     handleError(err);
@@ -288,7 +290,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-RICGWQGN.js");
+    const { health } = await import("./health-SH6T6DZS.js");
     await health(options);
   } catch (err) {
     handleError(err);
@@ -298,7 +300,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-EVZT7RH6.js");
+      const { backfillDimensions } = await import("./backfill-VAORMLMY.js");
       await backfillDimensions(options);
     } catch (err) {
       handleError(err);
@@ -308,7 +310,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-EVZT7RH6.js");
+      const { backfillColors } = await import("./backfill-VAORMLMY.js");
       await backfillColors(options);
     } catch (err) {
       handleError(err);
@@ -318,7 +320,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-EVZT7RH6.js");
+      const { backfillEmbeddings } = await import("./backfill-VAORMLMY.js");
       await backfillEmbeddings(options);
     } catch (err) {
       handleError(err);
@@ -328,7 +330,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-ZJW2ES4L.js");
+      const { cleanupDrops } = await import("./maintenance-V2TXPXQE.js");
       await cleanupDrops(options);
     } catch (err) {
       handleError(err);
@@ -337,7 +339,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-ZJW2ES4L.js");
+    const { purgeEvents } = await import("./maintenance-V2TXPXQE.js");
     await purgeEvents(options);
   } catch (err) {
     handleError(err);
@@ -346,7 +348,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-ZJW2ES4L.js");
+      const { reconcileFiles } = await import("./maintenance-V2TXPXQE.js");
       await reconcileFiles(options);
     } catch (err) {
       handleError(err);
@@ -355,7 +357,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-ZJW2ES4L.js");
+    const { retrySyncFailures } = await import("./maintenance-V2TXPXQE.js");
     await retrySyncFailures(options);
   } catch (err) {
     handleError(err);
@@ -364,7 +366,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-ZWSEXNFA.js");
+      const { listAdminJobs } = await import("./jobs-ROJFRPMR.js");
       await listAdminJobs(options);
     } catch (err) {
       handleError(err);
@@ -373,7 +375,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-ZWSEXNFA.js");
+    const { retryAdminJob } = await import("./jobs-ROJFRPMR.js");
     await retryAdminJob(id, options);
   } catch (err) {
     handleError(err);
@@ -381,7 +383,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-ZWSEXNFA.js");
+    const { deleteAdminJob } = await import("./jobs-ROJFRPMR.js");
     await deleteAdminJob(id, options);
   } catch (err) {
     handleError(err);
@@ -389,7 +391,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-EZ2VZGXQ.js");
+    const { listQueues } = await import("./queues-NR25TGT7.js");
     await listQueues(options);
   } catch (err) {
     handleError(err);
@@ -398,7 +400,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-EZ2VZGXQ.js");
+      const { cleanQueue } = await import("./queues-NR25TGT7.js");
       await cleanQueue(name, options);
     } catch (err) {
       handleError(err);
@@ -433,7 +435,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-J4ZMUXK7.js");
+    const { describeCommand } = await import("./describe-HSEHMJVD.js");
     describeCommand(command ?? "");
   } catch (err) {
     handleError(err);

package/dist/describe-CU5FBHZS.js

@@ -0,0 +1,79 @@
+import {
+  CLI_DOCS
+} from "./chunk-XJDK2CBE.js";
+import {
+  output
+} from "./chunk-5BVMPHKH.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/describe-HSEHMJVD.js

@@ -0,0 +1,79 @@
+import {
+  CLI_DOCS
+} from "./chunk-XJDK2CBE.js";
+import {
+  output
+} from "./chunk-5IX3ASXH.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
+};