@jango-blockchained/hoox-cli 0.7.0 → 0.7.3

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.
Files changed (3) hide show
  1. package/README.md +42 -26
  2. package/dist/index.js +602 -203
  3. package/package.json +5 -5
package/README.md CHANGED
@@ -2,15 +2,17 @@
2
2
 
3
3
  > **See also:** [Hoox User Guide](../docs/home.md) · [CLI Command Reference](../docs/reference/cli-commands.md)
4
4
 
5
- Hoox CLI — manage Cloudflare Workers, infrastructure, secrets, and deployments.
5
+ > Hoox CLI — manage Cloudflare Workers, infrastructure, secrets, and deployments.
6
6
 
7
- 381 unit tests, 15 command groups, 50+ subcommands.
7
+ > **Runtime requirement:** Bun ≥ 1.2. The bin shebang and bundle target are Bun-only; `npm install -g` will install the package but the CLI will not run under Node.js.
8
+
9
+ 528 unit tests, 21 command groups, 60+ subcommands.
8
10
 
9
11
  ## Features
10
12
 
11
13
  - **Interactive Setup**: `hoox init` guides you through project initialization with AI provider support
12
14
  - **Infrastructure as Code**: Manage D1, KV, R2, Queues, Vectorize, and Analytics via `hoox infra`
13
- - **Environment Management**: Declarative 31-key env matrix via `hoox config env`
15
+ - **Environment Management**: Declarative 27-key env matrix via `hoox config env`
14
16
  - **KV Config Sync**: 16-key manifest with `apply-manifest` for CONFIG_KV
15
17
  - **Database Operations**: Schema apply, migrations, query, export, reset via `hoox db`
16
18
  - **Deploy Automation**: Workers + dashboard + telegram webhook + KV config in one flow
@@ -26,13 +28,12 @@ Hoox CLI — manage Cloudflare Workers, infrastructure, secrets, and deployments
26
28
  ### Global Install (Recommended)
27
29
 
28
30
  ```bash
29
- # Using bun (recommended)
31
+ # Using bun (the only supported runtime)
30
32
  bun add -g @jango-blockchained/hoox-cli
31
-
32
- # Using npm
33
- npm install -g @jango-blockchained/hoox-cli
34
33
  ```
35
34
 
35
+ > The CLI is a Bun bundle — `npm install -g` will not produce a working binary.
36
+
36
37
  ### Local Development
37
38
 
38
39
  ```bash
@@ -57,22 +58,30 @@ hoox monitor status
57
58
 
58
59
  ## Available Commands
59
60
 
60
- | Command | Description |
61
- | ---------------- | ---------------------------------------------------------- |
62
- | `hoox init` | Initialize a new Hoox project with worker configuration |
63
- | `hoox clone` | Clone worker repositories as git submodules |
64
- | `hoox dev` | Start local development environment for all workers |
65
- | `hoox deploy` | Deploy workers, dashboard, telegram webhook, and KV config |
66
- | `hoox infra` | Manage infrastructure (D1, KV, R2, Queues, Vectorize, Analytics) |
67
- | `hoox config` | Manage wrangler.jsonc, env vars, KV keys, and secrets |
68
- | `hoox check` | Validate setup, prerequisites, and worker health |
69
- | `hoox db` | Manage D1 databases (apply, migrate, query, export, reset) |
70
- | `hoox monitor` | Monitor health, trades, logs, kill switch, queue, backup |
71
- | `hoox repair` | Diagnose and repair the system (check, rebuild, per-component) |
72
- | `hoox logs` | Stream and filter Cloudflare Worker logs |
73
- | `hoox test` | Run tests and CI pipeline |
74
- | `hoox waf` | Manage Cloudflare WAF rules and policies |
75
- | `hoox dashboard` | Launch or deploy the Next.js dashboard |
61
+ | Command | Description |
62
+ | ----------------- | ---------------------------------------------------------------- |
63
+ | `hoox init` | Initialize a new Hoox project with worker configuration |
64
+ | `hoox setup` | Auto-bootstrap infrastructure (auth, keys, D1, secrets) |
65
+ | `hoox clone` | Clone worker repositories as git submodules |
66
+ | `hoox dev` | Start local development environment for all workers |
67
+ | `hoox deploy` | Deploy workers, dashboard, telegram webhook, and KV config |
68
+ | `hoox infra` | Manage infrastructure (D1, KV, R2, Queues, Vectorize, Analytics) |
69
+ | `hoox config` | Manage wrangler.jsonc, env vars, KV keys, and secrets |
70
+ | `hoox check` | Validate setup, prerequisites, and worker health |
71
+ | `hoox db` | Manage D1 databases (apply, migrate, query, export, reset) |
72
+ | `hoox monitor` | Monitor health, trades, logs, kill switch, queue, backup |
73
+ | `hoox workers` | Per-worker operations (list, status, dev, logs) |
74
+ | `hoox repair` | Diagnose and repair the system (check, rebuild, per-component) |
75
+ | `hoox schema` | Manage D1 schema and migrations |
76
+ | `hoox update` | Self-update the CLI and check wrangler versions |
77
+ | `hoox logs` | Stream and filter Cloudflare Worker logs |
78
+ | `hoox test` | Run tests and CI pipeline |
79
+ | `hoox waf` | Manage Cloudflare WAF rules and policies |
80
+ | `hoox dashboard` | Launch or deploy the Next.js dashboard |
81
+ | `hoox tui` | Launch the OpenTUI terminal dashboard |
82
+ | `hoox agent` | AI agent operations (health probe) |
83
+ | `hoox disclaimer` | Display legal disclaimer |
84
+ | `hoox completion` | Generate shell completion script (bash, zsh, fish) |
76
85
 
77
86
  ### Global Options
78
87
 
@@ -108,7 +117,7 @@ Validates bun ≥1.2, git ≥2.40, wrangler, Docker, Cloudflare auth, and reposi
108
117
  ### Configure Environment
109
118
 
110
119
  ```bash
111
- # Interactive env setup (all 31 vars across 8 sections)
120
+ # Interactive env setup (all 27 vars across 8 sections)
112
121
  hoox config env init
113
122
 
114
123
  # Show current env (secrets redacted)
@@ -322,6 +331,7 @@ packages/cli/
322
331
  │ ├── index.ts # Main entry point
323
332
  │ ├── commands/
324
333
  │ │ ├── init/ # Interactive setup wizard
334
+ │ │ ├── setup/ # Auto-bootstrap infrastructure
325
335
  │ │ ├── dev/ # Local development
326
336
  │ │ ├── deploy/ # Deploy, telegram-webhook, update-internal-urls
327
337
  │ │ ├── infra/ # D1, KV, R2, Queues, Vectorize, Analytics
@@ -329,12 +339,18 @@ packages/cli/
329
339
  │ │ ├── check/ # Prerequisites, setup, health
330
340
  │ │ ├── db/ # Database operations
331
341
  │ │ ├── monitor/ # Health, trades, logs, kill-switch
342
+ │ │ ├── workers/ # Per-worker operations
332
343
  │ │ ├── repair/ # Check, worker, infra, secrets, rebuild
344
+ │ │ ├── schema/ # Schema management
345
+ │ │ ├── update/ # Self-update
333
346
  │ │ ├── logs/ # Worker log tailing
334
347
  │ │ ├── test/ # CI pipeline
335
348
  │ │ ├── waf/ # WAF management
336
349
  │ │ ├── clone/ # Submodule cloning
337
- │ │ └── dashboard/ # Dashboard operations
350
+ │ │ ├── dashboard/ # Dashboard operations
351
+ │ │ ├── tui/ # TUI launcher
352
+ │ │ ├── agent/ # AI agent operations
353
+ │ │ └── disclaimer/ # Legal disclaimer
338
354
  │ ├── services/
339
355
  │ │ ├── cloudflare/ # Wrangler CLI wrapper
340
356
  │ │ ├── config/ # wrangler.jsonc reader
@@ -359,7 +375,7 @@ packages/cli/
359
375
  | `commander` | CLI framework for command registration and parsing |
360
376
  | `@clack/prompts` | Interactive prompts for the TUI |
361
377
  | `ansis` | Terminal styling and colors |
362
- | `jsonc-parser` | Parse `wrangler.jsonc` configuration files |
378
+ | `jsonc-parser` | Parse `wrangler.jsonc` configuration files |
363
379
  | `@jango-blockchained/hoox-shared` | Shared types and utilities |
364
380
 
365
381
  ## Contributing