@jango-blockchained/hoox-cli 0.3.4 → 0.3.6

package/README.md

@@ -1,5 +1,7 @@
 # @jango-blockchained/hoox-cli
 
+> **See also:** [Hoox User Guide](../docs/home.md) · [CLI Command Reference](../docs/reference/cli-commands.md)
+
 Hoox CLI — manage Cloudflare Workers, infrastructure, secrets, and deployments.
 
 381 unit tests, 15 command groups, 50+ subcommands.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jango-blockchained/hoox-cli",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Hoox CLI — manage Cloudflare Workers, infrastructure, secrets, and deployments (@jango-blockchained/hoox-cli)",
   "type": "module",
   "main": "./bin/hoox.js",
@@ -9,7 +9,8 @@
     ".": "./bin/hoox.js"
   },
   "bin": {
-    "hoox": "./bin/hoox.js"
+    "hoox": "./bin/hoox.js",
+    "hx": "./bin/hoox.js"
   },
   "scripts": {
     "test": "bun test",
@@ -24,7 +25,8 @@
     "@jango-blockchained/hoox-shared": "workspace:*",
     "ansis": "^4.2.0",
     "commander": "^14.0.3",
-    "jsonc-parser": "^3.3.1"
+    "jsonc-parser": "^3.3.1",
+    "wrangler": "^4.92.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/src/commands/check/check-command.test.ts

@@ -244,16 +244,20 @@ describe("registerCheckCommand", () => {
   // -- check setup ----------------------------------------------------------
 
   describe("check setup", () => {
-    it("loads config and runs all 4 categories", { timeout: 30000 }, async () => {
-      const program = await createProgram();
-      await program.parseAsync(["check", "setup"], { from: "user" });
-
-      expect(loadMock).toHaveBeenCalled();
-      expect(d1ListMock).toHaveBeenCalled();
-      expect(kvListMock).toHaveBeenCalled();
-      expect(r2ListMock).toHaveBeenCalled();
-      expect(queueListMock).toHaveBeenCalled();
-    });
+    it(
+      "loads config and runs all 4 categories",
+      { timeout: 30000 },
+      async () => {
+        const program = await createProgram();
+        await program.parseAsync(["check", "setup"], { from: "user" });
+
+        expect(loadMock).toHaveBeenCalled();
+        expect(d1ListMock).toHaveBeenCalled();
+        expect(kvListMock).toHaveBeenCalled();
+        expect(r2ListMock).toHaveBeenCalled();
+        expect(queueListMock).toHaveBeenCalled();
+      }
+    );
 
     it("outputs JSON when --json flag is set", { timeout: 30000 }, async () => {
       const program = await createProgram();
@@ -285,18 +289,22 @@ describe("registerCheckCommand", () => {
       }
     });
 
-    it("sets exitCode to ERROR when validation fails", { timeout: 30000 }, async () => {
-      validateMock = mock(() => ({
-        valid: false,
-        errors: ["global.cloudflare_account_id is required"],
-      }));
-      ConfigService.prototype.validate = validateMock;
+    it(
+      "sets exitCode to ERROR when validation fails",
+      { timeout: 30000 },
+      async () => {
+        validateMock = mock(() => ({
+          valid: false,
+          errors: ["global.cloudflare_account_id is required"],
+        }));
+        ConfigService.prototype.validate = validateMock;
 
-      const program = await createProgram();
-      await program.parseAsync(["check", "setup"], { from: "user" });
+        const program = await createProgram();
+        await program.parseAsync(["check", "setup"], { from: "user" });
 
-      expect(process.exitCode).toBe(ExitCode.ERROR);
-    });
+        expect(process.exitCode).toBe(ExitCode.ERROR);
+      }
+    );
 
     it("sets exitCode to ERROR when infra check fails", async () => {
       d1ListMock = mock(async () => ({

package/src/commands/check/prerequisites-command.ts

@@ -7,7 +7,7 @@ import { CLIError, ExitCode } from "../../utils/errors.js";
 import type { FormatOptions } from "../../utils/formatters.js";
 
 export async function runPrerequisitesCheck(
-  service?: PrerequisitesService,
+  service?: PrerequisitesService
 ): Promise<PrerequisitesReport> {
   const svc = service ?? new PrerequisitesService();
   return await svc.runAll();
@@ -15,12 +15,16 @@ export async function runPrerequisitesCheck(
 
 function renderReport(report: PrerequisitesReport): void {
   for (const check of report.checks) {
-    const icon = check.passed ? theme.success(icons.success) : theme.error(icons.error);
+    const icon = check.passed
+      ? theme.success(icons.success)
+      : theme.error(icons.error);
     process.stdout.write(`${icon} ${check.name}\n`);
     process.stdout.write(`   ${theme.dim("Version:")} ${check.version}\n`);
     process.stdout.write(`   ${theme.dim("Required:")} ${check.required}\n`);
     if (check.hint) {
-      process.stdout.write(`   ${theme.warning(`${icons.warning} ${check.hint}`)}\n`);
+      process.stdout.write(
+        `   ${theme.warning(`${icons.warning} ${check.hint}`)}\n`
+      );
     }
     process.stdout.write("\n");
   }
@@ -33,7 +37,7 @@ function renderReport(report: PrerequisitesReport): void {
 
 async function handlePrerequisites(
   opts: FormatOptions,
-  tool?: string,
+  tool?: string
 ): Promise<void> {
   try {
     const svc = new PrerequisitesService();
@@ -78,7 +82,7 @@ OPTIONS:
 EXAMPLES:
   hoox check prerequisites
   hoox check prerequisites --tool bun
-  hoox check prerequisites --json`,
+  hoox check prerequisites --json`
     )
     .option("--tool <name>", "Only check a specific tool")
     .action(async (options: { tool?: string }, cmd: Command) => {

package/src/commands/clone/clone-command.ts

@@ -20,6 +20,7 @@ import {
   formatError,
   formatTable,
   formatJson,
+  getFormatOptions,
 } from "../../utils/formatters.js";
 import { CLIError, ExitCode } from "../../utils/errors.js";
 
@@ -36,16 +37,6 @@ interface CloneStatus {
   error?: string;
 }
 
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-/** Extract --json / --quiet from the global program options. */
-function getFormatOptions(cmd: Command) {
-  const opts = cmd.optsWithGlobals();
-  return { json: Boolean(opts.json), quiet: Boolean(opts.quiet) };
-}
-
 /**
  * Resolve the base GitHub URL for worker repos.
  * Tries `git remote get-url origin` first, falls back to a sensible default.

package/src/commands/config/config-command.ts

@@ -490,12 +490,10 @@ EXAMPLES:
         const syncSpin = spinner();
         syncSpin.start("Syncing to Cloudflare...");
         const result = await svc.syncToCloudflare(workerName);
-        if (result.success) {
+        if (result.ok) {
           syncSpin.stop(`Secret "${secretName}" synced to Cloudflare`);
         } else {
-          syncSpin.stop(
-            `Sync partial: ${result.error ?? "unknown error"}`
-          );
+          syncSpin.stop(`Sync partial: ${result.error ?? "unknown error"}`);
           formatError(
             new CLIError(
               `Sync partial: ${result.error ?? "unknown error"}`,
@@ -619,14 +617,12 @@ EXAMPLES:
           const syncSpin = spinner();
           syncSpin.start(`Syncing secrets for "${workerName}"...`);
           const result = await svc.syncToCloudflare(workerName);
-          if (result.success) {
+          if (result.ok) {
             syncSpin.stop(
-              `Synced ${result.data?.length ?? 0} secrets for "${workerName}"`
+              `Synced ${result.value?.length ?? 0} secrets for "${workerName}"`
             );
           } else {
-            syncSpin.stop(
-              `Sync failed: ${result.error ?? "unknown error"}`
-            );
+            syncSpin.stop(`Sync failed: ${result.error ?? "unknown error"}`);
             formatError(
               new CLIError(
                 `Sync failed: ${result.error ?? "unknown error"}`,
@@ -651,9 +647,9 @@ EXAMPLES:
           for (const name of workers) {
             syncSpin.start(`Syncing ${name}...`);
             const result = await svc.syncToCloudflare(name);
-            if (result.success) {
+            if (result.ok) {
               syncSpin.stop(
-                `${theme.success("synced")} ${result.data?.length ?? 0} for ${name}`
+                `${theme.success("synced")} ${result.value?.length ?? 0} for ${name}`
               );
               synced++;
             } else {

package/src/commands/config/env-command.ts

@@ -63,7 +63,7 @@ async function handleInit(opts: FormatOptions): Promise<void> {
 
   for (const section of sections) {
     const sectionDefs = EnvService.getDefinitions().filter(
-      (d) => d.section === section,
+      (d) => d.section === section
     );
     if (sectionDefs.length === 0) continue;
 
@@ -111,8 +111,7 @@ async function handleInit(opts: FormatOptions): Promise<void> {
       "",
     ].join("\n");
     await Bun.write(`${workerPath}/.dev.vars`, content);
-    if (!opts.quiet)
-      formatSuccess(`Created ${workerPath}/.dev.vars`, opts);
+    if (!opts.quiet) formatSuccess(`Created ${workerPath}/.dev.vars`, opts);
   }
 
   p.outro("Environment setup complete!");
@@ -127,7 +126,7 @@ async function handleShow(opts: FormatOptions): Promise<void> {
   if (!(await file.exists())) {
     throw new CLIError(
       ".env.local not found. Run `hoox config env init`.",
-      ExitCode.INVALID_USAGE,
+      ExitCode.INVALID_USAGE
     );
   }
 
@@ -157,7 +156,9 @@ async function handleValidate(opts: FormatOptions): Promise<void> {
     formatJson(result, opts);
   } else if (!opts.quiet) {
     if (!(await file.exists())) {
-      process.stdout.write(".env.local not found. Run `hoox config env init` first.\n\n");
+      process.stdout.write(
+        ".env.local not found. Run `hoox config env init` first.\n\n"
+      );
     }
     if (result.missing.length > 0) {
       process.stdout.write("Missing required variables:\n");
@@ -190,7 +191,7 @@ async function handleGenerateDevVars(opts: FormatOptions): Promise<void> {
   if (!(await file.exists())) {
     throw new CLIError(
       ".env.local not found. Run `hoox config env init`.",
-      ExitCode.INVALID_USAGE,
+      ExitCode.INVALID_USAGE
     );
   }
 
@@ -237,7 +238,7 @@ EXAMPLES:
   hoox config env init
   hoox config env show
   hoox config env validate
-  hoox config env generate-dev-vars`,
+  hoox config env generate-dev-vars`
     );
 
   envCmd
@@ -248,13 +249,8 @@ EXAMPLES:
       try {
         await handleInit(opts);
       } catch (err) {
-        formatError(
-          err instanceof Error ? err : String(err),
-          opts,
-        );
-        process.exit(
-          err instanceof CLIError ? err.code : ExitCode.ERROR,
-        );
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
       }
     });
 
@@ -266,13 +262,8 @@ EXAMPLES:
       try {
         await handleShow(opts);
       } catch (err) {
-        formatError(
-          err instanceof Error ? err : String(err),
-          opts,
-        );
-        process.exit(
-          err instanceof CLIError ? err.code : ExitCode.ERROR,
-        );
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
       }
     });
 
@@ -284,13 +275,8 @@ EXAMPLES:
       try {
         await handleValidate(opts);
       } catch (err) {
-        formatError(
-          err instanceof Error ? err : String(err),
-          opts,
-        );
-        process.exit(
-          err instanceof CLIError ? err.code : ExitCode.ERROR,
-        );
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
       }
     });
 
@@ -302,13 +288,8 @@ EXAMPLES:
       try {
         await handleGenerateDevVars(opts);
       } catch (err) {
-        formatError(
-          err instanceof Error ? err : String(err),
-          opts,
-        );
-        process.exit(
-          err instanceof CLIError ? err.code : ExitCode.ERROR,
-        );
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
       }
     });
 }

package/src/commands/config/kv-command.ts

@@ -27,9 +27,7 @@ function formatOpts(cmd: Command): FormatOptions {
   return { json: Boolean(opts.json), quiet: Boolean(opts.quiet) };
 }
 
-async function resolveNs(
-  cmd: Command,
-): Promise<string> {
+async function resolveNs(cmd: Command): Promise<string> {
   const svc = new KvSyncService();
   const opts = cmd.optsWithGlobals<{ namespaceId?: string }>();
   return await svc.resolveNamespaceId(opts.namespaceId);
@@ -39,10 +37,7 @@ async function resolveNs(
 // kv list
 // ---------------------------------------------------------------------------
 
-async function handleList(
-  opts: FormatOptions,
-  nsId: string,
-): Promise<void> {
+async function handleList(opts: FormatOptions, nsId: string): Promise<void> {
   const svc = new KvSyncService();
   const keys = await svc.list(nsId);
 
@@ -65,7 +60,7 @@ async function handleList(
 async function handleGet(
   opts: FormatOptions,
   nsId: string,
-  key: string,
+  key: string
 ): Promise<void> {
   const svc = new KvSyncService();
   const value = await svc.get(nsId, key);
@@ -73,7 +68,7 @@ async function handleGet(
   if (value === null) {
     throw new CLIError(
       `Key "${key}" not found in KV namespace`,
-      ExitCode.ERROR,
+      ExitCode.ERROR
     );
   }
 
@@ -92,7 +87,7 @@ async function handleSet(
   opts: FormatOptions,
   nsId: string,
   key: string,
-  value: string,
+  value: string
 ): Promise<void> {
   const svc = new KvSyncService();
   await svc.set(nsId, key, value);
@@ -106,7 +101,7 @@ async function handleSet(
 async function handleDelete(
   opts: FormatOptions,
   nsId: string,
-  key: string,
+  key: string
 ): Promise<void> {
   const svc = new KvSyncService();
   await svc.delete(nsId, key);
@@ -119,7 +114,7 @@ async function handleDelete(
 
 async function handleApplyManifest(
   opts: FormatOptions,
-  nsId: string,
+  nsId: string
 ): Promise<void> {
   const svc = new KvSyncService();
   const manifest = KvSyncService.getManifest();
@@ -133,7 +128,7 @@ async function handleApplyManifest(
         setCount++;
       } catch (err) {
         errors.push(
-          `${keyDef.key}: ${err instanceof Error ? err.message : String(err)}`,
+          `${keyDef.key}: ${err instanceof Error ? err.message : String(err)}`
         );
       }
     }
@@ -141,7 +136,7 @@ async function handleApplyManifest(
 
   formatSuccess(
     `Applied ${setCount}/${manifest.keys.length} manifest keys (${errors.length} errors)`,
-    opts,
+    opts
   );
 }
 
@@ -156,7 +151,7 @@ async function handleManifest(opts: FormatOptions): Promise<void> {
     formatJson(manifest, opts);
   } else if (!opts.quiet) {
     process.stdout.write(
-      `${theme.heading(`KV Manifest: ${manifest.namespace}`)}\n\n`,
+      `${theme.heading(`KV Manifest: ${manifest.namespace}`)}\n\n`
     );
     const rows = manifest.keys.map((k) => ({
       Key: k.key,
@@ -197,11 +192,11 @@ EXAMPLES:
   hoox config kv get trade:kill_switch
   hoox config kv delete trade:kill_switch
   hoox config kv apply-manifest
-  hoox config kv manifest`,
+  hoox config kv manifest`
     )
     .option(
       "--namespace-id <id>",
-      "KV namespace ID (auto-detected if omitted)",
+      "KV namespace ID (auto-detected if omitted)"
     );
 
   // -- list
@@ -214,13 +209,8 @@ EXAMPLES:
         const nsId = await resolveNs(cmd);
         await handleList(opts, nsId);
       } catch (err) {
-        formatError(
-          err instanceof Error ? err : String(err),
-          opts,
-        );
-        process.exit(
-          err instanceof CLIError ? err.code : ExitCode.ERROR,
-        );
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
       }
     });
 
@@ -234,13 +224,8 @@ EXAMPLES:
         const nsId = await resolveNs(cmd);
         await handleGet(opts, nsId, key);
       } catch (err) {
-        formatError(
-          err instanceof Error ? err : String(err),
-          opts,
-        );
-        process.exit(
-          err instanceof CLIError ? err.code : ExitCode.ERROR,
-        );
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
       }
     });
 
@@ -248,23 +233,16 @@ EXAMPLES:
   kvCmd
     .command("set <key> <value>")
     .description("Set a key's value in the KV namespace")
-    .action(
-      async (key: string, value: string, _, cmd: Command) => {
-        const opts = formatOpts(cmd);
-        try {
-          const nsId = await resolveNs(cmd);
-          await handleSet(opts, nsId, key, value);
-        } catch (err) {
-          formatError(
-            err instanceof Error ? err : String(err),
-            opts,
-          );
-          process.exit(
-            err instanceof CLIError ? err.code : ExitCode.ERROR,
-          );
-        }
-      },
-    );
+    .action(async (key: string, value: string, _, cmd: Command) => {
+      const opts = formatOpts(cmd);
+      try {
+        const nsId = await resolveNs(cmd);
+        await handleSet(opts, nsId, key, value);
+      } catch (err) {
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
+      }
+    });
 
   // -- delete
   kvCmd
@@ -276,35 +254,23 @@ EXAMPLES:
         const nsId = await resolveNs(cmd);
         await handleDelete(opts, nsId, key);
       } catch (err) {
-        formatError(
-          err instanceof Error ? err : String(err),
-          opts,
-        );
-        process.exit(
-          err instanceof CLIError ? err.code : ExitCode.ERROR,
-        );
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
       }
     });
 
   // -- apply-manifest
   kvCmd
     .command("apply-manifest")
-    .description(
-      "Apply manifest key defaults to the KV namespace",
-    )
+    .description("Apply manifest key defaults to the KV namespace")
     .action(async (_, cmd: Command) => {
       const opts = formatOpts(cmd);
       try {
         const nsId = await resolveNs(cmd);
         await handleApplyManifest(opts, nsId);
       } catch (err) {
-        formatError(
-          err instanceof Error ? err : String(err),
-          opts,
-        );
-        process.exit(
-          err instanceof CLIError ? err.code : ExitCode.ERROR,
-        );
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
       }
     });
 
@@ -317,13 +283,8 @@ EXAMPLES:
       try {
         await handleManifest(opts);
       } catch (err) {
-        formatError(
-          err instanceof Error ? err : String(err),
-          opts,
-        );
-        process.exit(
-          err instanceof CLIError ? err.code : ExitCode.ERROR,
-        );
+        formatError(err instanceof Error ? err : String(err), opts);
+        process.exit(err instanceof CLIError ? err.code : ExitCode.ERROR);
       }
     });
 }