wp-typia 0.24.4 → 0.24.5

package/README.md

@@ -11,6 +11,10 @@ Use this package for new projects:
 - `npx wp-typia create my-plugin --template workspace --profile plugin-qa`
 - `npx wp-typia create my-books --template query-loop --query-post-type book`
 
+The published package executes through the Node-first CLI runtime. `bunx` is a
+supported package-runner invocation, not a requirement for npm-installed
+commands.
+
 Extend an existing workspace with:
 
 - `wp-typia add block counter-card --template basic`
@@ -45,18 +49,16 @@ Configuration files:
 Compatibility notes:
 
 - `@wp-typia/project-tools` is the canonical programmatic project orchestration package
-- the published CLI now ships built `dist-bunli` runtimes, and the canonical Node bin uses a Node-safe fallback runtime for non-TUI `create`/`add`/`migrate`, `doctor`, `sync`, `--version`, `--help`, and template inspection without requiring a locally installed Bun binary
-- if `wp-typia --help` says `Runtime: Node fallback`, you are on that Bun-free path. You get human-readable help/output, common non-interactive project workflows, and lighter prompt behavior where interactive fallback is still supported
+- the published CLI ships a built `dist` runtime, and the canonical Node bin supports `create`, `add`, `migrate`, `doctor`, `sync`, `skills`, `completions`, `mcp`, `--version`, `--help`, and template inspection without requiring a locally installed Bun binary
+- Bun remains supported for repository development, tests, and builds, while Node is the canonical npm runtime for the published CLI
 - when you request machine-readable output with `--format json`, CLI failures now include a stable `error.code` field so wrappers and CI can branch without parsing English text
 - the stable machine-handled branching key is `error.code`. Structured context like `error.command`, `error.kind`, and `error.tag` may also be useful to consumers, while free-form text like `error.message`, `error.summary`, and `error.detailLines` stays human-facing guidance and can evolve without notice
-- when that Node fallback prompts interactively, it intentionally stays lighter than the Bun/OpenTUI flow: numbered lists, option label/value matching, inline validation retries, and redraw commands for the current choices: `?` for the short reprint shortcut, `help` for the explicit redraw command, and `list` for users who expect option listing semantics
-- Bunli-specific command surfaces such as `skills`, `completions`, and `mcp` still run through the built `dist-bunli/cli.js` artifact and require Bun when you use the npm package directly; if you want the full Bunli/OpenTUI runtime story without a local Bun install, prefer the standalone installer from the latest GitHub Release
 - standalone release assets are published per platform together with checksum manifests and install scripts: `install-wp-typia.sh` for macOS/Linux and `install-wp-typia.ps1` for Windows
 - internal runtime-bridge helper modules are implementation details; integrations
   should target the CLI or `@wp-typia/project-tools`, not CLI internals
 
 Maintainers: see [`docs/bunli-cli-migration.md`](https://imjlk.github.io/wp-typia/maintainers/bunli-cli-migration/)
-for the active CLI ownership contract and the staged Bunli cutover plan.
+for historical Gunshi migration notes.
 
 Project meta docs:
 

package/bin/wp-typia.js

@@ -5,42 +5,18 @@ import { spawnSync } from 'node:child_process';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 
-import {
-  fullRuntimeCommands,
-  interactiveRuntimeCommands,
-  longValueOptions,
-  reservedCommands,
-  shortValueOptions,
-} from './routing-metadata.generated.js';
-import {
-  getRuntimeRoutingInvocation,
-  shouldRouteToFullRuntime,
-} from './runtime-routing.js';
-
 const packageRoot = path.resolve(
   path.dirname(fileURLToPath(import.meta.url)),
   '..',
 );
-const cliEntrypoint = path.join(packageRoot, 'dist-bunli', 'cli.js');
-const nodeCliEntrypoint = path.join(packageRoot, 'dist-bunli', 'node-cli.js');
-const bunBinary = process.env.BUN_BIN || 'bun';
-const fullRuntimeCommandSet = new Set(fullRuntimeCommands);
-const interactiveRuntimeCommandSet = new Set(interactiveRuntimeCommands);
-const longValueOptionSet = new Set(longValueOptions);
-const reservedCommandSet = new Set(reservedCommands);
-const shortValueOptionSet = new Set(shortValueOptions);
-const buildScriptEntrypoint = path.join(
-  packageRoot,
-  'scripts',
-  'build-bunli-runtime.ts',
-);
-const sourceCliEntrypoint = path.join(packageRoot, 'src', 'cli.ts');
-const sourceCheckoutRoot = path.resolve(packageRoot, '..', '..');
+const cliEntrypoint = path.join(packageRoot, 'dist', 'cli.js');
+const buildScriptEntrypoint = path.join(packageRoot, 'scripts', 'build-runtime.ts');
 const sourceProjectToolsPackageRoot = path.resolve(
   packageRoot,
   '..',
   'wp-typia-project-tools',
 );
+const sourceCheckoutRoot = path.resolve(packageRoot, '..', '..');
 const sourceProjectToolsPackageManifest = path.join(
   sourceProjectToolsPackageRoot,
   'package.json',
@@ -53,8 +29,6 @@ const sourceProjectToolsRuntimeProbe = path.join(
 );
 const sourceProjectToolsBuildCommand =
   'bun run --filter @wp-typia/project-tools build';
-const standaloneGuidance =
-  'Prefer not to install Bun? Use the standalone wp-typia binary from the GitHub release assets.';
 
 function normalizeTopLevelHelpArgv(argv) {
   const [firstArg, secondArg, ...rest] = argv;
@@ -70,8 +44,12 @@ function normalizeTopLevelHelpArgv(argv) {
   return argv;
 }
 
+function canAutobuildSourceCheckout() {
+  return fs.existsSync(buildScriptEntrypoint);
+}
+
 function isWorkingBunBinary() {
-  const bunCheck = spawnSync(bunBinary, ['--version'], {
+  const bunCheck = spawnSync(process.env.BUN_BIN || 'bun', ['--version'], {
     env: process.env,
     stdio: 'ignore',
   });
@@ -79,10 +57,13 @@ function isWorkingBunBinary() {
   return !bunCheck.error && bunCheck.status === 0;
 }
 
-function canAutobuildSourceCheckout() {
-  return (
-    fs.existsSync(buildScriptEntrypoint) && fs.existsSync(sourceCliEntrypoint)
-  );
+function runBun(args, options) {
+  return spawnSync(process.env.BUN_BIN || 'bun', args, {
+    cwd: packageRoot,
+    env: process.env,
+    stdio: 'inherit',
+    ...options,
+  });
 }
 
 function hasMissingSourceProjectToolsRuntime() {
@@ -119,13 +100,10 @@ function ensureSourceProjectToolsRuntime() {
     `Running \`${sourceProjectToolsBuildCommand}\` from ${sourceCheckoutRoot} before rebuilding the CLI runtime...`,
   );
 
-  const buildResult = spawnSync(
-    bunBinary,
+  const buildResult = runBun(
     ['run', '--filter', '@wp-typia/project-tools', 'build'],
     {
       cwd: sourceCheckoutRoot,
-      env: process.env,
-      stdio: 'inherit',
     },
   );
 
@@ -136,14 +114,7 @@ function ensureSourceProjectToolsRuntime() {
     process.exit(buildResult.status ?? 1);
   }
 
-  if (fs.existsSync(sourceProjectToolsRuntimeProbe)) {
-    return true;
-  }
-
-  console.error(
-    `Error: @wp-typia/project-tools build completed but ${relativeProbe} is still missing. Run \`${sourceProjectToolsBuildCommand}\` from the repository root, then rerun wp-typia.`,
-  );
-  return false;
+  return fs.existsSync(sourceProjectToolsRuntimeProbe);
 }
 
 function ensureBuiltRuntime() {
@@ -151,7 +122,7 @@ function ensureBuiltRuntime() {
     return false;
   }
 
-  if (fs.existsSync(cliEntrypoint) && fs.existsSync(nodeCliEntrypoint)) {
+  if (fs.existsSync(cliEntrypoint)) {
     return true;
   }
 
@@ -159,72 +130,22 @@ function ensureBuiltRuntime() {
     return false;
   }
 
-  const buildResult = spawnSync(bunBinary, ['run', 'build'], {
-    cwd: packageRoot,
-    env: process.env,
-    stdio: 'inherit',
-  });
-
+  const buildResult = runBun(['run', 'build']);
   if (buildResult.status !== 0) {
     process.exit(buildResult.status ?? 1);
   }
 
-  return fs.existsSync(cliEntrypoint) && fs.existsSync(nodeCliEntrypoint);
+  return fs.existsSync(cliEntrypoint);
 }
 
 const argv = normalizeTopLevelHelpArgv(process.argv.slice(2));
-const { command } = getRuntimeRoutingInvocation(argv, {
-  longValueOptions: longValueOptionSet,
-  reservedCommands: reservedCommandSet,
-  shortValueOptions: shortValueOptionSet,
-});
-const commandRequiresFullRuntime = command
-  ? fullRuntimeCommandSet.has(command)
-  : false;
-const hasBuiltRuntime = ensureBuiltRuntime();
-const hasWorkingBun = isWorkingBunBinary();
-const shouldUseFullRuntime = shouldRouteToFullRuntime({
-  argv,
-  fullRuntimeCommands: fullRuntimeCommandSet,
-  hasBuiltRuntime,
-  hasWorkingBun,
-  interactiveRuntimeCommands: interactiveRuntimeCommandSet,
-  longValueOptions: longValueOptionSet,
-  reservedCommands: reservedCommandSet,
-  shortValueOptions: shortValueOptionSet,
-});
-
-// Keep common help and explicit non-TUI calls on the human-readable Node fallback
-// even when Bun is present.
-if (hasWorkingBun && hasBuiltRuntime && shouldUseFullRuntime) {
-  const result = spawnSync(bunBinary, [cliEntrypoint, ...argv], {
-    cwd: process.cwd(),
-    env: process.env,
-    stdio: 'inherit',
-  });
-  process.exit(result.status ?? 1);
-}
-
-if (commandRequiresFullRuntime) {
-  if (!hasBuiltRuntime) {
-    console.error(
-      'Error: wp-typia could not locate its built CLI runtime. Reinstall the published package, or run `bun run build` when using a source checkout.',
-    );
-    process.exit(1);
-  }
-
-  console.error(
-    `Error: wp-typia ${command} requires Bun. Install Bun locally, run with bunx, or set BUN_BIN to a working Bun executable. ${standaloneGuidance}`,
-  );
-  process.exit(1);
-}
 
-if (!hasBuiltRuntime || !fs.existsSync(nodeCliEntrypoint)) {
+if (!ensureBuiltRuntime()) {
   console.error(
-    'Error: wp-typia could not locate its Node fallback runtime. Reinstall the published package, or run `bun run build` when using a source checkout.',
+    'Error: wp-typia could not locate its CLI runtime. Reinstall the published package, or run `bun run build` when using a source checkout.',
   );
   process.exit(1);
 }
 
-const cliModule = await import(pathToFileURL(nodeCliEntrypoint).href);
-await cliModule.runNodeCliEntrypoint(argv);
+const cliModule = await import(pathToFileURL(cliEntrypoint).href);
+await cliModule.runGunshiCliEntrypoint(argv);