@dbx-tools/cli 0.1.111 → 0.3.1

package/src/root.ts

@@ -0,0 +1,80 @@
+/**
+ * Workspace root detection for the `dbxtools` CLI.
+ */
+import { existsSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { exec } from "@dbx-tools/core";
+import { functionModule } from "@dbx-tools/shared-core";
+
+async function gitToplevel(): Promise<string | undefined> {
+  const { exitCode, stdout } = await exec.spawn("git", ["rev-parse", "--show-toplevel"], {
+    stdout: "capture",
+    stderr: "ignore",
+    stdin: "ignore",
+  });
+  if (exitCode !== 0) return undefined;
+  return stdout || undefined;
+}
+
+/**
+ * Walk upward from `startDir` for `.projenrc.ts`. If none is found, try git
+ * top-level only when that directory also contains `.projenrc.ts`; otherwise return
+ * `resolve(startDir)` (which may not be a workspace root).
+ */
+export async function findWorkspaceRoot(startDir: string = process.cwd()): Promise<string> {
+  let dir = resolve(startDir);
+  while (true) {
+    if (existsSync(join(dir, ".projenrc.ts"))) return dir;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+
+  const fromGit = await gitToplevel();
+  if (fromGit && existsSync(join(fromGit, ".projenrc.ts"))) return fromGit;
+
+  return resolve(startDir);
+}
+
+/**
+ * True when the folder has no `.projenrc.ts` yet and needs full bootstrapping.
+ * Keying off `.projenrc.ts` (not `package.json`) avoids clobbering a cleaned
+ * workspace that still has a hand-authored projenrc.
+ */
+export function needsBootstrap(root: string): boolean {
+  return !existsSync(join(root, ".projenrc.ts"));
+}
+
+/** True when `node_modules` or projen itself is missing under `root`. */
+export function needsInstall(root: string): boolean {
+  if (!existsSync(join(root, "node_modules"))) return true;
+  if (existsSync(join(root, ".projenrc.ts")) && !existsSync(join(root, "node_modules", "projen"))) {
+    return true;
+  }
+  return false;
+}
+
+/**
+ * True when the synth TOOLCHAIN isn't installed yet: no `node_modules`, or the
+ * dbx-tools engine / `projen` aren't resolvable under it. Distinct from a full
+ * bootstrap (which keys off a MISSING `.projenrc.ts`): here the projenrc exists
+ * but its dependencies don't - e.g. a copied project whose generated manifests
+ * and `node_modules` are gitignored. Seeding the toolchain (not scaffolding)
+ * makes it synth-ready without touching the hand-authored `.projenrc.ts`.
+ */
+export function needsToolchain(root: string): boolean {
+  const modules = join(root, "node_modules");
+  if (!existsSync(modules)) return true;
+  return (
+    !existsSync(join(modules, "projen")) ||
+    !existsSync(join(modules, "@dbx-tools", "projen"))
+  );
+}
+
+/** Async, memoized root lookup from the process cwd at first use. */
+export const workspaceRoot = functionModule.memoize(() => findWorkspaceRoot());
+
+/** Short label for log output (`basename` of the resolved root). */
+export function rootLabel(root: string): string {
+  return basename(root) || root;
+}

package/test/tsconfig.json

@@ -0,0 +1,14 @@
+// ~~ Generated by projen. To modify, edit .projenrc.js and run "pnpm exec projen".
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "rootDir": ".."
+  },
+  "include": [
+    "**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,43 @@
+// ~~ Generated by projen. To modify, edit .projenrc.js and run "pnpm exec projen".
+{
+  "compilerOptions": {
+    "rootDir": ".",
+    "outDir": "lib",
+    "alwaysStrict": true,
+    "declaration": true,
+    "esModuleInterop": true,
+    "experimentalDecorators": true,
+    "inlineSourceMap": true,
+    "inlineSources": true,
+    "lib": [
+      "ES2022"
+    ],
+    "module": "ESNext",
+    "noEmitOnError": false,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitAny": true,
+    "noImplicitReturns": true,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "resolveJsonModule": true,
+    "strict": true,
+    "strictNullChecks": true,
+    "strictPropertyInitialization": true,
+    "stripInternal": true,
+    "target": "ES2022",
+    "types": [
+      "node"
+    ],
+    "moduleResolution": "bundler",
+    "skipLibCheck": true
+  },
+  "include": [
+    "src/**/*.ts",
+    "index.ts",
+    "bin/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/dist/bin/dbxtools.d.ts

@@ -1 +0,0 @@
-export { };

package/dist/bin/dbxtools.js

@@ -1,55 +0,0 @@
-#!/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-ZnM5Gb2r.js";
-import { Command, InvalidArgumentError } from "commander";
-
-//#region packages/cli/bin/dbxtools.ts
-const program = new Command().name("dbxtools").description("Workspace build, scaffold, and release toolkit for Bun monorepos.");
-program.command("format").description("syncpack format, regroup lifecycle hooks, then prettier --write.").action(format);
-program.command("build").description("Compile every publishable package with the shared tsdown config.").action(build);
-program.command("release").description("Build, then publish each package with a stamped (complete) manifest.").option("-n, --dry-run", "rehearse with `bun publish --dry-run`", false).action(async (opts) => {
-	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("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());
-});
-program.command("create").description("Scaffold a new workspace package under packages/<slug>/.").argument("<slug>", "kebab-case slug (lowercase, starts with a letter)", (value) => {
-	if (!/^[a-z][a-z0-9-]*$/.test(value)) throw new InvalidArgumentError(`invalid slug "${value}"`);
-	return value;
-}).option("--plugin", "scaffold an AppKit plugin package").option("--shared", "scaffold a browser-safe shared package").action(async (slug, opts) => {
-	await create({
-		slug,
-		plugin: opts.plugin,
-		shared: opts.shared
-	});
-});
-program.command("agent").description("Run ucode codex exec with assistant output.").argument("[prompt...]", "prompt text (or pipe via stdin when omitted)").option("-t, --timeout <seconds>", "wall-clock budget in seconds (default 300)", (value) => {
-	const seconds = Number(value);
-	if (!Number.isFinite(seconds) || seconds <= 0) throw new InvalidArgumentError("timeout must be a positive number");
-	return Math.round(seconds * 1e3);
-}).action(async (promptParts, opts) => {
-	const code = await agent({
-		prompt: await resolveAgentPrompt(promptParts),
-		timeoutMs: opts.timeout
-	});
-	if (code !== 0) process.exit(code);
-});
-program.command("tag").description("Bump every workspace, commit, tag HEAD, and push to origin.").argument("[bump]", "version bump (patch | minor | major)", (value) => {
-	if (value !== "patch" && value !== "minor" && value !== "major") throw new InvalidArgumentError("expected patch, minor, or major");
-	return value;
-}, "patch").option("--no-publish", "skip publishing the tagged versions to the local registry").option("-n, --dry-run", "print the plan and release-notes preview; write nothing, push nothing", false).option("--notes-since <tag>", "widen release-notes baseline to this tag (e.g. v0.1.75); default is the previous tag on HEAD").option("--no-ai-notes", "skip ucode codex; use commit-grouped notes only").action(async (bump, opts) => {
-	await tag({
-		bump,
-		dryRun: opts.dryRun,
-		publish: opts.publish,
-		aiNotes: opts.aiNotes,
-		...notesSinceRequested(opts.notesSince) ? { notesSince: opts.notesSince } : {}
-	});
-});
-await program.parseAsync(process.argv);
-
-//#endregion
-export {  };

package/dist/index.d.ts

@@ -1,289 +0,0 @@
-import { FileSystemProject, Workspace } from "pacwich";
-
-//#region packages/cli/src/build.d.ts
-/** 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
- * release tooling that drafts notes programmatically.
- */
-/** Default wall-clock budget for a Codex invocation. */
-declare const AGENT_DEFAULT_TIMEOUT_MS = 300000;
-/** Options for {@link runAgent}. */
-interface AgentOptions {
-  /** Wall-clock budget in milliseconds. */
-  timeoutMs?: number;
-  /** Working directory for the agent (defaults to `process.cwd()`). */
-  cwd?: string;
-  /**
-   * When `true` (default), capture stdout via `sh({ quiet: true })` for
-   * programmatic callers. When `false`, inherit stdio like
-   * `ucode codex exec …` in a shell.
-   */
-  capture?: boolean;
-  /**
-   * When `true` (default) and `capture` is enabled, write the parsed
-   * assistant text to stdout. Set `false` when the caller will log the
-   * result itself (e.g. release-notes drafting).
-   */
-  echo?: boolean;
-}
-/** Outcome of {@link runAgent}. */
-interface AgentResult {
-  /** Trimmed assistant answer. */
-  text: string;
-  /** Subprocess exit code. */
-  exitCode: number;
-  /** Trimmed stderr. */
-  stderr: string;
-}
-/** Options for {@link agent}. */
-interface AgentCommandOptions {
-  /** Prompt passed to `ucode codex exec`. */
-  prompt: string;
-  /** Wall-clock budget in milliseconds. */
-  timeoutMs?: number;
-}
-/** Whether `ucode codex --version` reports a usable Codex CLI. */
-declare function agentAvailable(): Promise<boolean>;
-/** Whether an exit code looks like the process was killed on a timeout. */
-declare function agentTimedOut(exitCode: number): boolean;
-/** Pull assistant prose out of `ucode codex exec` stdout. */
-declare function parseCodexStdout(stdout: string): string;
-/**
- * Run `ucode codex exec` and return captured output. Throws when Codex
- * is absent or the wall-clock budget is exceeded. On a non-zero exit
- * the result is still returned so callers can use partial text.
- */
-declare function runAgent(prompt: string, opts?: AgentOptions): Promise<AgentResult>;
-/**
- * `dbxtools agent` entry: run Codex and return a process exit code (0 on
- * success, 1 on failure or timeout).
- */
-declare function agent(opts: AgentCommandOptions): Promise<number>;
-/** Join argv prompt parts, or read stdin when non-interactive and args are empty. */
-declare function resolveAgentPrompt(promptParts: string[]): Promise<string>;
-//#endregion
-//#region packages/cli/src/codegen.d.ts
-/** Regenerate the `generated/` tree for every package declaring a `codegen` field. */
-declare function codegen(): Promise<void>;
-//#endregion
-//#region packages/cli/src/config.d.ts
-/** Resolved toolkit configuration for the current repo. */
-interface DbxtoolsConfig {
-  /** npm scope (e.g. `@acme`) used when scaffolding new packages. */
-  scope: string;
-  /** `owner/name` slug used for release links, or null when undiscoverable. */
-  repo: string | null;
-  /**
-   * Name of the shared-helpers package `create` wires as a dependency
-   * into new plugin / standard packages (when it exists in the
-   * workspace). Defaults to `<scope>/shared`, or null when no scope
-   * resolves.
-   */
-  sharedPackage: string | null;
-}
-/**
- * Resolve toolkit config for the current repo, memoized for the
- * process. Overrides under the root `package.json` `dbxtools` key win
- * over the auto-derived defaults.
- */
-declare const getDbxtoolsConfig: () => Promise<DbxtoolsConfig>;
-//#endregion
-//#region packages/cli/src/create.d.ts
-/** Options for {@link create}. */
-interface CreateOptions {
-  /** kebab-case slug (lowercase, starts with a letter). */
-  slug: string;
-  /** Scaffold an AppKit plugin package. */
-  plugin?: boolean;
-  /** Scaffold a browser-safe shared package. */
-  shared?: boolean;
-}
-/** Scaffold a new workspace package under `packages/<slug>/`. */
-declare function create(options: CreateOptions): Promise<void>;
-//#endregion
-//#region packages/cli/src/format.d.ts
-/** syncpack + lifecycle-hook regroup + prettier across the workspace. */
-declare function format(): Promise<void>;
-//#endregion
-//#region packages/cli/src/shell.d.ts
-interface ShellResult {
-  exitCode: number;
-  stdout: string;
-  stderr: string;
-}
-interface ShellOptions {
-  /** Return the result on non-zero exit instead of throwing. */
-  nothrow?: boolean;
-  /** Working directory for the command. */
-  cwd?: string;
-  /** String piped to the command's stdin. */
-  input?: string;
-  /** Suppress the live echo. Output is still captured on the result. */
-  quiet?: boolean;
-}
-/**
- * Run a command, streaming live unless `quiet`. Returns trimmed captured
- * output regardless. Throws on non-zero unless `nothrow`.
- */
-declare function sh(args: string[], opts?: ShellOptions): Promise<ShellResult>;
-/** `bun x <args>` for one-off CLI tools (knip, syncpack, prettier, ...). */
-declare function bunx(args: string[], opts?: ShellOptions): Promise<ShellResult>;
-//#endregion
-//#region packages/cli/src/git.d.ts
-/**
- * Run `git <args>`, returning trimmed output. Quiet by default since git is
- * used mostly for its stdout (rev-parse, log, diff, ...); pass `quiet: false`
- * to stream a mutating op live. Throws on non-zero unless `nothrow`.
- */
-declare function git(args: string[], opts?: {
-  nothrow?: boolean;
-  quiet?: boolean;
-  cwd?: string;
-}): Promise<ShellResult>;
-//#endregion
-//#region packages/cli/src/package.d.ts
-/** Minimal package.json shape the commands care about. */
-interface PackageJson {
-  name?: string;
-  version?: string;
-  private?: boolean;
-  workspaces?: string[];
-  [key: string]: unknown;
-}
-/** A workspace package: its parsed manifest, location, and dependency edges. */
-declare class WorkspacePackage {
-  readonly meta: PackageJson;
-  readonly dir: string;
-  readonly slug: string;
-  readonly jsonPath: string;
-  private constructor();
-  /** Build from a pacwich {@link Workspace}, reading its manifest. */
-  static fromWorkspace(ws: Workspace): Promise<WorkspacePackage>;
-}
-/** Resolve `path` against the repo root. */
-declare function toAbsolute(path: string): string;
-/** Repo-relative form of `path`, or absolute when it sits outside the root. */
-declare function toRelative(path: string): string;
-/** Yield every workspace `package.json` path (`includeRoot` prepends the root manifest). */
-declare function discoverPackageJsons(includeRoot?: boolean): AsyncIterableIterator<string>;
-/** Workspace packages passing `filter` (default: non-private), sorted by slug. */
-declare function discoverPackages(filter?: (pkg: WorkspacePackage) => boolean): Promise<WorkspacePackage[]>;
-/** Write `value` as JSON, preserving the file's trailing newline to avoid format churn. */
-declare function writeJson(path: string, value: unknown): Promise<void>;
-//#endregion
-//#region packages/cli/src/project.d.ts
-declare const getProject: () => Promise<FileSystemProject>;
-//#endregion
-//#region packages/cli/src/release.d.ts
-/** Options for {@link release}. */
-interface ReleaseOptions {
-  /** Rehearse with `bun publish --dry-run` instead of publishing. */
-  dryRun?: boolean;
-}
-/**
- * Build every publishable package, then publish each with a stamped
- * (complete) `package.json`, restoring the slim source manifest after
- * each publish whether it succeeds or fails.
- */
-declare function release(opts?: ReleaseOptions): Promise<void>;
-//#endregion
-//#region packages/cli/src/script.d.ts
-/** Log `message` and exit non-zero. */
-declare function fail(message: string): never;
-/** Narrow an unknown thrown value to its message string. */
-declare function errorMessage(err: unknown): string;
-/** Split text on newlines, trimming each line and dropping blanks. */
-declare function nonEmptyLines(text: string): string[];
-//#endregion
-//#region packages/cli/src/tag.d.ts
-type Bump = "major" | "minor" | "patch";
-/** Options for {@link tag}. */
-interface TagOptions {
-  /** Version bump (defaults to `patch`). */
-  bump?: Bump;
-  /** Print everything, write nothing. */
-  dryRun?: boolean;
-  /** Publish the tagged versions to the local registry (default true). */
-  publish?: boolean;
-  /**
-   * When set, widen the release-notes baseline to this tag instead of
-   * the latest tag on `HEAD` (e.g. `v0.1.75` when several recent tags
-   * failed to publish). Omit to use the previous tag only.
-   */
-  notesSince?: string;
-  /** When false, skip Codex and use commit-grouped notes only. */
-  aiNotes?: boolean;
-}
-/**
- * Version-bump every publishable workspace, commit, tag, push, create
- * the GitHub Release (with generated notes), and publish to the local
- * registry. See the file header for the full local-state policy.
- */
-declare function tag(opts?: TagOptions): Promise<void>;
-//#endregion
-//#region packages/cli/src/update.d.ts
-/** True when `version` is a release with no prerelease segment. */
-declare function isStableVersion(version: string): boolean;
-/** Highest stable version in `versions` that satisfies `range`. */
-declare function latestStableInRange(versions: string[], range: string): string | null;
-/** Rewrite a single range (or `latest`) to a caret pin on the latest stable match. */
-declare function stableCaretRange(versions: string[], range: string): string;
-/** Refresh every root `catalog` entry to the latest stable release in-range. */
-declare function updateCatalog(): Promise<boolean>;
-/** Run `bun update` with `forwardArgs` at the repo root. */
-declare function runBunUpdate(forwardArgs: string[]): Promise<void>;
-/** Refresh catalog pins, then `bun update` at the repo root. */
-declare function update(forwardArgs?: string[]): Promise<void>;
-/** Args after the `update` subcommand in `process.argv`. */
-declare function forwardedUpdateArgs(argv?: string[]): string[];
-//#endregion
-//#region packages/cli/src/verify.d.ts
-/** 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 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,103 +0,0 @@
-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";
-
-//#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 };