@dbx-tools/cli 0.3.19 → 0.3.21

package/.projen/deps.json

@@ -5,11 +5,6 @@
       "version": "catalog:",
       "type": "build"
     },
-    {
-      "name": "tsx",
-      "version": "^4.23.0",
-      "type": "build"
-    },
     {
       "name": "typescript",
       "type": "build"
@@ -37,6 +32,11 @@
     {
       "name": "pnpm",
       "type": "runtime"
+    },
+    {
+      "name": "tsx",
+      "version": "catalog:",
+      "type": "runtime"
     }
   ],
   "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\"."

package/.projen/files.json

@@ -1,8 +1,10 @@
 {
   "files": [
+    ".gitignore",
     ".projen/deps.json",
     ".projen/files.json",
     ".projen/tasks.json",
+    "bin/dbx-tools.mjs",
     "test/tsconfig.json",
     "tsconfig.json"
   ],

package/README.md

@@ -1,59 +1,54 @@
-# dbx-tools
+# @dbx-tools/cli
 
-CLI package for the dbx-tools projen workspace engine.
+Bootstrap CLI for the dbx-tools projen workspace engine.
 
-Run the `dbxtools` command to bootstrap a repo, synthesize generated files,
-rebuild barrels, generate OpenAPI clients, or clean generated output. Import the
-package modules when custom tooling needs the same root detection, pnpm
+Run the `dbx-tools` command (aliased `dbxt`) to turn a folder that has no
+`.projenrc.ts` or toolchain yet into a working dbx-tools workspace. Once that
+workspace exists, everything else is a projen task you run with
+`pnpm run <task>` - the CLI only forwards to projen from that point on. Import
+the package modules when custom tooling needs the same root detection, pnpm
 delegation, or CLI program behavior.
 
 Key features:
 
-- `sync` bootstrap path for empty folders plus normal projen synthesis for
-  existing workspaces.
-- Focused `--watch` loop for projenrc changes, barrel generation, and OpenAPI
-  generation.
-- Standalone barrel and OpenAPI commands for post-synth workflows.
-- Generated-file cleanup with an interactive or non-interactive mode.
+- Bootstrap path that scaffolds pnpm/projen into an empty or partially-set-up
+  folder, including the initial install and synth.
+- Toolchain repair for a cloned repo whose generated files and `node_modules`
+  are gitignored.
+- Transparent forwarding to projen for any task once the workspace is ready.
 - Importable CLI/root/pnpm helpers for tests and thin wrapper commands.
 
-## Bootstrap Or Sync A Workspace
+## Bootstrap A Workspace
 
 ```sh
-dbxtools sync
-dbxtools sync --watch
+dbx-tools sync
 ```
 
-In an empty folder, `sync` creates the minimum pnpm/projen structure needed for
-`@dbx-tools/projen`. In an existing workspace, it runs projen and the post-synth
-generators. `--watch` starts focused watchers for structural changes, barrels,
-and OpenAPI generation.
+In an empty folder this creates the minimum pnpm/projen structure needed for
+`@dbx-tools/projen`, installs the toolchain, and runs the first synth. In a
+freshly cloned repo it seeds the missing toolchain and synthesizes. This is the
+case projen cannot handle on its own, because there are no tasks to run yet.
 
-## Generate Barrels And OpenAPI Clients
+## After Bootstrap, Use The Projen Tasks
 
-```sh
-dbxtools barrels
-dbxtools openapi
-```
-
-`barrels` rebuilds package-root `index.ts` files from exported modules under
-`src/`. `openapi` scans tsoa controllers and writes generated OpenAPI packages.
-
-## Clean Generated Output
+The engine registers its commands as projen tasks on the workspace root, so run
+them directly instead of going through this CLI:
 
 ```sh
-dbxtools clean
-dbxtools clean -y
+pnpm run sync            # one-shot full synth
+pnpm run sync --watch    # projenrc + barrels + openapi watchers
+pnpm run barrels         # rebuild every package-root index.ts barrel
+pnpm run openapi         # generate the openapi packages from tsoa controllers
+pnpm run clean           # remove generated (read-only) files; -y to skip the picker
 ```
 
-`clean` removes generated read-only files and can also remove install output. Use
-it before debugging synthesis drift or validating that the repo can regenerate
-from source.
+`dbx-tools <task>` still works and forwards to the same projen task, but the
+`pnpm run` form is the documented one for an established workspace.
 
 ## Use The CLI Internals
 
 ```ts
-import { cli, root, pnpm } from "dbx-tools";
+import { cli, root, pnpm } from "@dbx-tools/cli";
 
 await cli.runCli(["sync"]);
 const workspaceRoot = await root.findWorkspaceRoot();
@@ -61,7 +56,7 @@ pnpm.runProjen(["barrels"], workspaceRoot);
 ```
 
 Importing internals is mainly useful for tests or wrapper scripts; most users
-should run the `dbxtools` bin.
+should run the `dbx-tools` bin.
 
 ## Modules
 

package/bin/dbx-tools.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// GENERATED by projen synth (cli tag) - DO NOT EDIT.
+// Regenerated from ./dbx-tools.ts.
+// Hand edits are overwritten on the next watch; this file is read-only.
+
+// Resolved as a bare specifier so Node looks in THIS file's package rather than the
+// caller's cwd - the only way a globally installed CLI finds its own tsx.
+import { register } from "tsx/esm/api";
+
+register();
+await import(new URL("./dbx-tools.ts", import.meta.url).href);

package/bin/{dbxtools.ts → dbx-tools.ts}

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S npx tsx
 /**
- * `dbxtools` bootstraps uninitialized workspaces, then forwards to projen.
+ * `dbx-tools` bootstraps uninitialized workspaces, then forwards to projen.
  */
 import { runCli } from "../src/cli";
 

package/package.json

@@ -6,31 +6,35 @@
     "directory": "workspaces/cli/dbx-tools"
   },
   "bin": {
-    "dbxtools": "./bin/dbxtools.ts"
+    "dbx-tools": "./bin/dbx-tools.mjs",
+    "dbxt": "./bin/dbx-tools.mjs"
   },
   "devDependencies": {
     "@types/node": "^24.6.0",
-    "tsx": "^4.23.0",
     "typescript": "^5.9.3"
   },
   "dependencies": {
     "@clack/prompts": "^1.7.0",
     "commander": "^15.0.0",
     "pnpm": "^11.0.6",
-    "@dbx-tools/core": "0.3.19",
-    "@dbx-tools/shared-core": "0.3.19"
+    "tsx": "^4.23.0",
+    "@dbx-tools/core": "0.3.21",
+    "@dbx-tools/shared-core": "0.3.21"
   },
   "main": "index.ts",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.19",
+  "version": "0.3.21",
   "types": "index.ts",
   "type": "module",
   "exports": {
     ".": "./index.ts",
+    "./bootstrap": "./src/bootstrap.ts",
+    "./cli": "./src/cli.ts",
     "./pnpm": "./src/pnpm.ts",
+    "./root": "./src/root.ts",
     "./package.json": "./package.json"
   },
   "dbxToolsConfig": {

package/src/bootstrap.ts

@@ -31,7 +31,7 @@ allowBuilds:
  * Turn a folder into a functioning dbx-tools workspace: `pnpm init`, seed
  * `pnpm-workspace.yaml`, add `projen`/`typescript`/`tsx` + the engine package,
  * write a minimal `.projenrc.ts`, synth once (with `PROJEN_DISABLE_POST`), then
- * install. Does not run barrels - run `dbxtools barrels` or a full projen synth
+ * install. Does not run barrels - run `pnpm run barrels` or a full projen synth
  * post-install to generate package barrels.
  *
  * Every step is idempotent and self-guarded, so this is safe to run against a
@@ -58,7 +58,7 @@ export function bootstrapWorkspace(
   runInitialSynth(root);
 
   runPnpm(["install", "--no-frozen-lockfile", "--force"], root);
-  outro("Workspace ready - re-run dbxtools or add packages under workspaces/");
+  outro("Workspace ready - re-run dbx-tools or add packages under workspaces/");
 }
 
 /**

package/src/cli.ts

@@ -1,5 +1,5 @@
 /**
- * `dbxtools` commander entry: detect root, bootstrap or install, forward to projen.
+ * `dbx-tools` commander entry: detect root, bootstrap or install, forward to projen.
  *
  * @module
  */
@@ -40,12 +40,12 @@ async function prepareAndRunProjen(projenArgs: string[], startDir?: string): Pro
 /** Parse `argv` with commander and forward remaining args to projen. */
 export async function runCli(argv: string[]): Promise<void> {
   const program = new Command()
-    .name("dbxtools")
+    .name("dbx-tools")
     .description("Bootstrap dbx-tools workspaces and forward to projen")
     .allowUnknownOption()
     .allowExcessArguments()
     .showHelpAfterError()
-    .helpOption("-h, --help", "Show dbxtools help");
+    .helpOption("-h, --help", "Show dbx-tools help");
 
   program.parse(argv);
   await prepareAndRunProjen(program.args);

package/src/pnpm.ts

@@ -1,5 +1,5 @@
 /**
- * pnpm discovery, workspace install, and projen forwarding for the `dbxtools` CLI.
+ * pnpm discovery, workspace install, and projen forwarding for the `dbx-tools` CLI.
  *
  * @module
  */

package/src/root.ts

@@ -1,5 +1,5 @@
 /**
- * Workspace root detection for the `dbxtools` CLI.
+ * Workspace root detection for the `dbx-tools` CLI.
  *
  * @module
  */