@dbx-tools/cli 0.1.103 → 0.1.105

package/README.md

@@ -1,4 +1,4 @@
-# @dbx-tools/dbxtools
+# @dbx-tools/cli
 
 Scaffold, formatting, codegen, verification, build, and release helpers for Bun +
 workspaces monorepos. It wraps the shared `tsdown` config for building and a
@@ -8,7 +8,7 @@ orthogonal to writing package code.
 ## Installation
 
 ```bash
-bun add -d @dbx-tools/dbxtools
+bun add -d @dbx-tools/cli
 ```
 
 Then point your root `package.json` scripts at the `dbxtools` bin for the helper
@@ -35,7 +35,7 @@ commands you want:
 | `dbxtools format`                             | `syncpack format`, regroup lifecycle hooks, then `prettier --write`.                                 |
 | `dbxtools build`                              | Compile every publishable package with the shared `tsdown` config.                                   |
 | `dbxtools codegen`                            | Regenerate each package's `generated/` zod tree from the `.d.ts` inputs its `package.json` declares. |
-| `dbxtools verify`                             | Fail on imports of sibling packages not declared as dependencies.                                    |
+| `dbxtools verify [--workspace-deps]`          | Workspace verify pass; `--workspace-deps` fails on undeclared sibling imports.                       |
 | `dbxtools create [--plugin\|--shared] <slug>` | Scaffold a new package under `packages/<slug>/`.                                                     |
 | `dbxtools release [--dry-run]`                | Build, then publish each package with a stamped (complete) manifest.                                 |
 | `dbxtools tag [patch\|minor\|major]`          | Version bump, commit, tag, push, and create a GitHub Release. `--notes-since v0.1.75` widens the notes baseline; default is the previous tag. `--no-ai-notes` skips Codex release notes. |
@@ -69,7 +69,7 @@ The same commands are exported as functions for projects that want to compose
 their own automation:
 
 ```ts
-import { build, codegen, create, release, tag, verify } from "@dbx-tools/dbxtools";
+import { build, codegen, create, release, tag, verify } from "@dbx-tools/cli";
 
 await build();
 await codegen();

package/dist/bin/dbxtools.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import { C as codegen, S as build, b as resolveAgentPrompt, d as release, f as format, g as agent, l as notesSinceRequested, n as forwardedUpdateArgs, p as create, s as update, t as verify, u as tag } from "../verify-CTCK1U-t.js";
+import { C as codegen, S as build, b as resolveAgentPrompt, d as release, f as format, g as agent, l as notesSinceRequested, n as forwardedUpdateArgs, p as create, s as update, t as verify, u as tag } from "../verify-ZnM5Gb2r.js";
 import { Command, InvalidArgumentError } from "commander";
 
 //#region packages/cli/bin/dbxtools.ts
@@ -10,7 +10,9 @@ program.command("release").description("Build, then publish each package with a
 	await release({ dryRun: opts.dryRun });
 });
 program.command("codegen").description("Regenerate each package's `generated/` zod tree from its inputs.").action(codegen);
-program.command("verify").description("Fail on imports of sibling packages not declared as dependencies.").action(verify);
+program.command("verify").description("Workspace verify pass (optional sibling dependency scan).").option("--workspace-deps", "fail on imports of sibling packages not declared as dependencies", false).action(async (opts) => {
+	await verify({ workspaceDeps: opts.workspaceDeps });
+});
 program.command("update").description("Pin root catalog entries to latest stable versions, then bun update at the repo root.").allowUnknownOption().action(async () => {
 	await update(forwardedUpdateArgs());
 });

package/dist/index.d.ts

@@ -4,6 +4,39 @@ import { FileSystemProject, Workspace } from "pacwich";
 /** Compile every publishable package with the shared tsdown config. */
 declare function build(): Promise<void>;
 //#endregion
+//#region packages/cli/src/exec.d.ts
+/**
+ * Subprocess helper with optional per-line stdout/stderr callbacks.
+ *
+ * Defaults to `Bun.spawn` so line callbacks stream as output arrives. Set
+ * `shell: true` to use Bun's cross-platform `$` shell (PATH resolution,
+ * Windows `.cmd` handling) when you do not need streaming line handlers.
+ *
+ * For capture-and-throw semantics, prefer {@link sh} / {@link bunx}.
+ */
+type BunSpawnOptions = NonNullable<Parameters<typeof Bun.spawn>[1]>;
+type ExecOptions = Omit<BunSpawnOptions, "stdin" | "stdout" | "stderr" | "stdio"> & {
+  stdin?: BunSpawnOptions["stdin"];
+  stdout?: BunSpawnOptions["stdout"] | ((line: string) => void);
+  stderr?: BunSpawnOptions["stderr"] | ((line: string) => void);
+  /**
+   * Run through Bun's `$` shell instead of `Bun.spawn`. Cross-platform
+   * command resolution; stdout/stderr echo to the terminal by default.
+   * Line callbacks are satisfied from buffered output after exit (Bun
+   * shell does not stream `.lines()` while the process runs).
+   */
+  shell?: boolean; /** Shell only: suppress live stdout/stderr echo (output is still buffered). */
+  quiet?: boolean;
+};
+/**
+ * Spawn a subprocess and wait for exit.
+ *
+ * Unset stdio fds default to `"inherit"`. Pass a function as `stdout` or
+ * `stderr` to receive each line; with the default `Bun.spawn` path that fd
+ * is piped and lines stream as they arrive.
+ */
+declare function exec(command: string, args: string[], options?: ExecOptions): Promise<number>;
+//#endregion
 //#region packages/cli/src/agent.d.ts
 /**
  * Run Codex headlessly via `ucode codex exec` for `dbxtools agent` and
@@ -242,7 +275,15 @@ declare function update(forwardArgs?: string[]): Promise<void>;
 declare function forwardedUpdateArgs(argv?: string[]): string[];
 //#endregion
 //#region packages/cli/src/verify.d.ts
-/** Fail when any workspace imports a sibling it doesn't declare as a dependency. */
-declare function verify(): Promise<void>;
+/** Options for {@link verify}. */
+interface VerifyOptions {
+  /**
+   * When true, fail on imports of sibling workspace packages not declared
+   * as dependencies. Off by default.
+   */
+  workspaceDeps?: boolean;
+}
+/** Workspace verify pass (optional implicit-dependency scan). */
+declare function verify(options?: VerifyOptions): Promise<void>;
 //#endregion
-export { AGENT_DEFAULT_TIMEOUT_MS, type AgentCommandOptions, type AgentOptions, type AgentResult, type Bump, type CreateOptions, type DbxtoolsConfig, type PackageJson, type ReleaseOptions, type ShellResult, type TagOptions, WorkspacePackage, agent, agentAvailable, agentTimedOut, build, bunx, codegen, create, discoverPackageJsons, discoverPackages, errorMessage, fail, format, forwardedUpdateArgs, getDbxtoolsConfig, getProject, git, isStableVersion, latestStableInRange, nonEmptyLines, parseCodexStdout, release, resolveAgentPrompt, runAgent, runBunUpdate, sh, stableCaretRange, tag, toAbsolute, toRelative, update, updateCatalog, verify, writeJson };
+export { AGENT_DEFAULT_TIMEOUT_MS, type AgentCommandOptions, type AgentOptions, type AgentResult, type Bump, type CreateOptions, type DbxtoolsConfig, type ExecOptions, type PackageJson, type ReleaseOptions, type ShellResult, type TagOptions, type VerifyOptions, WorkspacePackage, agent, agentAvailable, agentTimedOut, build, bunx, codegen, create, discoverPackageJsons, discoverPackages, errorMessage, exec, fail, format, forwardedUpdateArgs, getDbxtoolsConfig, getProject, git, isStableVersion, latestStableInRange, nonEmptyLines, parseCodexStdout, release, resolveAgentPrompt, runAgent, runBunUpdate, sh, stableCaretRange, tag, toAbsolute, toRelative, update, updateCatalog, verify, writeJson };

package/dist/index.js

@@ -1,3 +1,103 @@
-import { A as git, C as codegen, D as toAbsolute, E as discoverPackages, F as nonEmptyLines, I as getProject, M as sh, N as errorMessage, O as toRelative, P as fail, S as build, T as discoverPackageJsons, _ as agentAvailable, a as runBunUpdate, b as resolveAgentPrompt, c as updateCatalog, d as release, f as format, g as agent, h as AGENT_DEFAULT_TIMEOUT_MS, i as latestStableInRange, j as bunx, k as writeJson, m as getDbxtoolsConfig, n as forwardedUpdateArgs, o as stableCaretRange, p as create, r as isStableVersion, s as update, t as verify, u as tag, v as agentTimedOut, w as WorkspacePackage, x as runAgent, y as parseCodexStdout } from "./verify-CTCK1U-t.js";
+import { A as git, C as codegen, D as toAbsolute, E as discoverPackages, F as nonEmptyLines, I as getProject, M as sh, N as errorMessage, O as toRelative, P as fail, S as build, T as discoverPackageJsons, _ as agentAvailable, a as runBunUpdate, b as resolveAgentPrompt, c as updateCatalog, d as release, f as format, g as agent, h as AGENT_DEFAULT_TIMEOUT_MS, i as latestStableInRange, j as bunx, k as writeJson, m as getDbxtoolsConfig, n as forwardedUpdateArgs, o as stableCaretRange, p as create, r as isStableVersion, s as update, t as verify, u as tag, v as agentTimedOut, w as WorkspacePackage, x as runAgent, y as parseCodexStdout } from "./verify-ZnM5Gb2r.js";
+import { $ } from "bun";
+import * as readline from "node:readline";
+import { Readable } from "node:stream";
 
-export { AGENT_DEFAULT_TIMEOUT_MS, WorkspacePackage, agent, agentAvailable, agentTimedOut, build, bunx, codegen, create, discoverPackageJsons, discoverPackages, errorMessage, fail, format, forwardedUpdateArgs, getDbxtoolsConfig, getProject, git, isStableVersion, latestStableInRange, nonEmptyLines, parseCodexStdout, release, resolveAgentPrompt, runAgent, runBunUpdate, sh, stableCaretRange, tag, toAbsolute, toRelative, update, updateCatalog, verify, writeJson };
+//#region packages/cli/src/exec.ts
+/**
+* Subprocess helper with optional per-line stdout/stderr callbacks.
+*
+* Defaults to `Bun.spawn` so line callbacks stream as output arrives. Set
+* `shell: true` to use Bun's cross-platform `$` shell (PATH resolution,
+* Windows `.cmd` handling) when you do not need streaming line handlers.
+*
+* For capture-and-throw semantics, prefer {@link sh} / {@link bunx}.
+*/
+/**
+* Spawn a subprocess and wait for exit.
+*
+* Unset stdio fds default to `"inherit"`. Pass a function as `stdout` or
+* `stderr` to receive each line; with the default `Bun.spawn` path that fd
+* is piped and lines stream as they arrive.
+*/
+async function exec(command, args, options = {}) {
+	if (options.shell) return execShell(command, args, options);
+	return execSpawn(command, args, options);
+}
+async function execSpawn(command, args, options) {
+	const { stdin, stdout, stderr, shell: _shell, quiet: _quiet, ...spawnOpts } = options;
+	const onStdout = typeof stdout === "function" ? stdout : void 0;
+	const onStderr = typeof stderr === "function" ? stderr : void 0;
+	const stdoutMode = typeof stdout === "function" ? "pipe" : stdout ?? "inherit";
+	const stderrMode = typeof stderr === "function" ? "pipe" : stderr ?? "inherit";
+	const proc = Bun.spawn([command, ...args], {
+		...spawnOpts,
+		stdin: stdin ?? "inherit",
+		stdout: stdoutMode,
+		stderr: stderrMode
+	});
+	const reads = [];
+	if (onStdout && isReadableStream(proc.stdout)) reads.push(readLines(proc.stdout, onStdout));
+	if (onStderr && isReadableStream(proc.stderr)) reads.push(readLines(proc.stderr, onStderr));
+	try {
+		const exitCode = await proc.exited;
+		await Promise.all(reads);
+		return exitCode;
+	} catch (err) {
+		await Promise.allSettled(reads);
+		throw err;
+	}
+}
+async function execShell(command, args, options) {
+	const { cwd, env, quiet, stdout, stderr, stdin, shell: _shell, ..._spawnOnly } = options;
+	const onStdout = typeof stdout === "function" ? stdout : void 0;
+	const onStderr = typeof stderr === "function" ? stderr : void 0;
+	const argv = [command, ...args];
+	let cmd = typeof stdin === "string" ? $`${argv} < ${new Response(stdin)}`.nothrow() : $`${argv}`.nothrow();
+	if (cwd) cmd = cmd.cwd(cwd);
+	if (env) cmd = cmd.env(env);
+	if (quiet) cmd = cmd.quiet();
+	if (onStdout) {
+		const [res] = await Promise.all([cmd, (async () => {
+			for await (const line of cmd.lines()) onStdout(line);
+		})()]);
+		if (onStderr) emitBufferedLines(res.stderr.toString(), onStderr);
+		return res.exitCode;
+	}
+	const res = await cmd;
+	if (onStderr) emitBufferedLines(res.stderr.toString(), onStderr);
+	return res.exitCode;
+}
+function isReadableStream(value) {
+	return typeof value === "object" && value !== null && "getReader" in value;
+}
+async function readLines(stream, onLine) {
+	const rl = readline.createInterface({
+		input: Readable.fromWeb(stream),
+		crlfDelay: Infinity
+	});
+	for await (const line of rl) onLine(line);
+}
+function emitBufferedLines(text, onLine) {
+	if (text.length === 0) return;
+	const body = text.endsWith("\n") ? text.slice(0, -1) : text;
+	for (const line of body.split("\n")) onLine(line.endsWith("\r") ? line.slice(0, -1) : line);
+}
+if (import.meta.main) {
+	const useShell = process.argv.includes("--shell");
+	const [command, ...args] = process.argv.slice(2).filter((arg) => arg !== "--shell");
+	if (!command) {
+		console.error("Usage: exec [--shell] <command> [args...]");
+		process.exit(1);
+	}
+	const exitCode = await exec(command, args, {
+		shell: useShell,
+		stdout: (line) => console.log(line),
+		stderr: (line) => console.error(line)
+	});
+	console.log(`Exit code: ${exitCode}`);
+	process.exit(exitCode);
+}
+
+//#endregion
+export { AGENT_DEFAULT_TIMEOUT_MS, WorkspacePackage, agent, agentAvailable, agentTimedOut, build, bunx, codegen, create, discoverPackageJsons, discoverPackages, errorMessage, exec, fail, format, forwardedUpdateArgs, getDbxtoolsConfig, getProject, git, isStableVersion, latestStableInRange, nonEmptyLines, parseCodexStdout, release, resolveAgentPrompt, runAgent, runBunUpdate, sh, stableCaretRange, tag, toAbsolute, toRelative, update, updateCatalog, verify, writeJson };

package/dist/{verify-CTCK1U-t.js → verify-ZnM5Gb2r.js}

@@ -902,6 +902,22 @@ function resolveWorkspaceDeps(deps, siblingVersions) {
 	}
 	return next;
 }
+/** Rewrite dev `bin` pointers (`./bin/foo.ts`) to built `dist` targets. */
+function stampBin(meta) {
+	const bin = meta.bin;
+	if (!bin) return meta;
+	const stampTarget = (target) => /^\.\/bin\/[^/]+\.[cm]?tsx?$/.test(target) ? target.replace(/^\.\/bin\/(.+)\.[cm]?tsx?$/, "./dist/bin/$1.js") : target;
+	if (typeof bin === "string") return {
+		...meta,
+		bin: stampTarget(bin)
+	};
+	const next = {};
+	for (const [name, target] of Object.entries(bin)) next[name] = stampTarget(target);
+	return {
+		...meta,
+		bin: next
+	};
+}
 /**
 * Return a publishable copy of `meta`: resolve `workspace:` sibling
 * pins to concrete versions (via `siblingVersions`), expand any source
@@ -941,7 +957,7 @@ function stampManifest(meta, siblingVersions) {
 	stamped.license ??= DEFAULT_LICENSE;
 	stamped.type ??= "module";
 	if (typeof stamped.name === "string" && stamped.name.startsWith("@") && !stamped.publishConfig) stamped.publishConfig = { access: "public" };
-	return stamped;
+	return stampBin(stamped);
 }
 /**
 * Build every publishable package, then publish each with a stamped
@@ -1356,7 +1372,7 @@ async function tag(opts = {}) {
 		consola.log("Refreshing bun.lock to the bumped versions before local publish...");
 		if ((await sh(["bun", "install"], { nothrow: true })).exitCode !== 0) consola.warn("bun install failed; skipping local publish so stale sibling pins aren't shipped. CI will publish from the tag.");
 		else {
-			consola.log("Publishing packages to the local registry (bun run release)...");
+			consola.log("Publishing packages to the local registry (bun dbxtools release)...");
 			await sh([
 				"bun",
 				"run",
@@ -1476,9 +1492,13 @@ function forwardedUpdateArgs(argv = process.argv) {
 
 //#endregion
 //#region packages/cli/src/verify.ts
-/** Fail when any workspace imports a sibling it doesn't declare as a dependency. */
-async function verify() {
+/** Workspace verify pass (optional implicit-dependency scan). */
+async function verify(options = {}) {
 	const project = await getProject();
+	if (!options.workspaceDeps) {
+		consola.log(`verify: ${project.workspaces.length} workspace(s) OK (skipped workspace dependency scan; pass --workspace-deps to enable)`);
+		return;
+	}
 	const result = await project.verify({ strict: true });
 	for (const issue of [...result.errors, ...result.warnings]) if (issue.level === "error") consola.error(issue.message);
 	else consola.warn(issue.message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dbx-tools/cli",
-  "version": "0.1.103",
+  "version": "0.1.105",
   "bin": {
     "dbxtools": "./dist/bin/dbxtools.js"
   },