wp-typia 0.22.2 → 0.22.4

package/dist-bunli/node-cli.js

@@ -3,7 +3,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.22.2",
+  version: "0.22.4",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -73,7 +73,7 @@ var package_default = {
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/project-tools": "0.22.2",
+    "@wp-typia/project-tools": "0.22.4",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -97,9 +97,9 @@ var package_default = {
 
 // src/node-cli.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES5,
-  createCliCommandError as createCliCommandError2,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError5,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES7,
+  createCliCommandError as createCliCommandError3,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError6,
   formatCliDiagnosticError,
   serializeCliDiagnosticError as serializeCliDiagnosticError2
 } from "@wp-typia/project-tools/cli-diagnostics";
@@ -336,7 +336,7 @@ var SYNC_OPTION_METADATA = {
 };
 var DOCTOR_OPTION_METADATA = {
   format: {
-    description: "Use `json` for machine-readable doctor check output.",
+    description: "Use `json` for machine-readable doctor check output or `toon` for human-readable output.",
     type: "string"
   }
 };
@@ -353,7 +353,7 @@ var GLOBAL_OPTION_METADATA = {
     type: "string"
   },
   format: {
-    description: "Output format for supported commands.",
+    description: "Output format for supported commands (`json` or `toon`).",
     type: "string"
   },
   id: {
@@ -580,10 +580,16 @@ function resolveCommandOptionValues(metadata, options) {
 
 // src/cli-diagnostic-output.ts
 import {
-  createCliCommandError,
+  createCliCommandError as createCliCommandError2,
   serializeCliDiagnosticError
 } from "@wp-typia/project-tools/cli-diagnostics";
 
+// src/cli-output-format.ts
+import {
+  CLI_DIAGNOSTIC_CODES,
+  createCliCommandError
+} from "@wp-typia/project-tools/cli-diagnostics";
+
 // bin/argv-walker.js
 function normalizeOptionSet(values) {
   return values instanceof Set ? values : new Set(values);
@@ -624,6 +630,60 @@ function findFirstPositionalIndex(argv, metadata) {
   const positionalIndexes = collectPositionalIndexes(argv, metadata);
   return positionalIndexes[0] ?? -1;
 }
+function findFirstPositional(argv, metadata) {
+  const firstPositionalIndex = findFirstPositionalIndex(argv, metadata);
+  return firstPositionalIndex === -1 ? undefined : argv[firstPositionalIndex];
+}
+
+// src/cli-output-format.ts
+var SUPPORTED_CLI_OUTPUT_FORMATS = ["json", "toon"];
+function formatSupportedCliOutputFormats() {
+  return SUPPORTED_CLI_OUTPUT_FORMATS.join(", ");
+}
+function isSupportedCliOutputFormat(value) {
+  return SUPPORTED_CLI_OUTPUT_FORMATS.includes(value);
+}
+function formatInvalidCliOutputFormatMessage(value) {
+  return `Invalid --format value "${value}". Supported values: ${formatSupportedCliOutputFormats()}.`;
+}
+function resolveEntrypointCliCommand(argv) {
+  return findFirstPositional(argv, COMMAND_ROUTING_METADATA) ?? "wp-typia";
+}
+function assertSupportedCliOutputFormat(value, argv) {
+  if (isSupportedCliOutputFormat(value)) {
+    return;
+  }
+  throw createCliCommandError({
+    code: CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT,
+    command: resolveEntrypointCliCommand(argv),
+    detailLines: [formatInvalidCliOutputFormatMessage(value)]
+  });
+}
+function validateCliOutputFormatArgv(argv) {
+  for (let index = 0;index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
+    if (arg === "--") {
+      return;
+    }
+    if (arg === "--format") {
+      const next = argv[index + 1];
+      if (next && !next.startsWith("-")) {
+        assertSupportedCliOutputFormat(next, argv);
+        index += 1;
+      }
+      continue;
+    }
+    if (arg.startsWith("--format=")) {
+      const value = arg.slice("--format=".length);
+      if (value) {
+        assertSupportedCliOutputFormat(value, argv);
+      }
+    }
+  }
+}
 
 // src/cli-diagnostic-output.ts
 function prefersStructuredCliArgv(argv) {
@@ -653,8 +713,8 @@ import {
 
 // src/add-kind-registry.ts
 import {
-  CLI_DIAGNOSTIC_CODES,
-  createCliDiagnosticCodeError
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES3,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError2
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/add-kind-ids.ts
@@ -673,6 +733,66 @@ var ADD_KIND_IDS = [
   "editor-plugin"
 ];
 
+// src/cli-string-flags.ts
+import {
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES2,
+  createCliDiagnosticCodeError
+} from "@wp-typia/project-tools/cli-diagnostics";
+function readOptionalCliStringFlagValue(flags, name, mode) {
+  const value = flags[name];
+  if (value === undefined || value === null) {
+    return;
+  }
+  if (typeof value !== "string") {
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES2.MISSING_ARGUMENT, `\`--${name}\` requires a value.`);
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    if (mode === "strict") {
+      throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES2.MISSING_ARGUMENT, `\`--${name}\` requires a value.`);
+    }
+    return;
+  }
+  return mode === "strict" ? value : trimmed;
+}
+function readOptionalLooseStringFlag(flags, name) {
+  return readOptionalCliStringFlagValue(flags, name, "loose");
+}
+function readOptionalStrictStringFlag(flags, name) {
+  return readOptionalCliStringFlagValue(flags, name, "strict");
+}
+function requireStrictStringFlag(flags, name, message) {
+  const value = readOptionalStrictStringFlag(flags, name);
+  if (!value) {
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES2.MISSING_ARGUMENT, message);
+  }
+  return value;
+}
+function readOptionalPairedStrictStringFlags(flags, leftName, rightName, message) {
+  const leftValue = readOptionalStrictStringFlag(flags, leftName);
+  const rightValue = readOptionalStrictStringFlag(flags, rightName);
+  if (Boolean(leftValue) !== Boolean(rightValue)) {
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES2.MISSING_ARGUMENT, message);
+  }
+  return [leftValue, rightValue];
+}
+
+// src/external-layer-prompt-options.ts
+function formatExternalLayerSelectHint(option) {
+  const details = [
+    option.description,
+    option.extends.length > 0 ? `extends ${option.extends.join(", ")}` : undefined
+  ].filter((value) => typeof value === "string" && value.length > 0);
+  return details.length > 0 ? details.join(" · ") : undefined;
+}
+function toExternalLayerPromptOptions(options) {
+  return options.map((option) => ({
+    hint: formatExternalLayerSelectHint(option),
+    label: option.id,
+    value: option.id
+  }));
+}
+
 // src/add-kind-registry.ts
 var BLOCK_VISIBLE_FIELD_ORDER = [
   "kind",
@@ -731,51 +851,12 @@ var NAME_NAMESPACE_VISIBLE_FIELDS = [
   "name",
   "namespace"
 ];
-function readOptionalStringFlag(flags, name) {
-  const value = flags[name];
-  if (value === undefined || value === null) {
-    return;
-  }
-  if (typeof value !== "string" || value.trim().length === 0) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `\`--${name}\` requires a value.`);
-  }
-  return value;
-}
-function requireStringFlag(flags, name, message) {
-  const value = readOptionalStringFlag(flags, name);
-  if (!value) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, message);
-  }
-  return value;
-}
-function readOptionalPairedStringFlags(flags, leftName, rightName, message) {
-  const leftValue = readOptionalStringFlag(flags, leftName);
-  const rightValue = readOptionalStringFlag(flags, rightName);
-  if (Boolean(leftValue) !== Boolean(rightValue)) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, message);
-  }
-  return [leftValue, rightValue];
-}
 function requireAddKindName(context, message) {
   if (!context.name) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, message);
+    throw createCliDiagnosticCodeError2(CLI_DIAGNOSTIC_CODES3.MISSING_ARGUMENT, message);
   }
   return context.name;
 }
-function formatExternalLayerSelectHint(option) {
-  const details = [
-    option.description,
-    option.extends.length > 0 ? `extends ${option.extends.join(", ")}` : undefined
-  ].filter((value) => typeof value === "string" && value.length > 0);
-  return details.length > 0 ? details.join(" · ") : undefined;
-}
-function toExternalLayerPromptOptions(options) {
-  return options.map((option) => ({
-    hint: formatExternalLayerSelectHint(option),
-    label: option.id,
-    value: option.id
-  }));
-}
 function defineAddKindRegistryEntry(entry) {
   return entry;
 }
@@ -791,6 +872,18 @@ function createNamedExecutionPlan(context, options) {
 function isAddPersistenceTemplate(template) {
   return template === "persistence" || template === "compound";
 }
+function formatAddBlockTemplateIds(addRuntime) {
+  return addRuntime.ADD_BLOCK_TEMPLATE_IDS.join(", ");
+}
+function assertAddBlockTemplateId(context, templateId) {
+  if (context.addRuntime.isAddBlockTemplateId(templateId)) {
+    return templateId;
+  }
+  if (templateId === "query-loop") {
+    throw createCliDiagnosticCodeError2(CLI_DIAGNOSTIC_CODES3.INVALID_ARGUMENT, "`wp-typia add block --template query-loop` is not supported. Query Loop is a create-time `core/query` variation scaffold, so use `wp-typia create <project-dir> --template query-loop` instead.");
+  }
+  throw createCliDiagnosticCodeError2(CLI_DIAGNOSTIC_CODES3.UNKNOWN_TEMPLATE, `Unknown add-block template "${templateId}". Expected one of: ${formatAddBlockTemplateIds(context.addRuntime)}. Run \`wp-typia templates list\` to inspect available templates.`);
+}
 var ADD_KIND_REGISTRY = {
   "admin-view": defineAddKindRegistryEntry({
     completion: {
@@ -809,7 +902,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Admin view name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add admin-view` requires <name>. Usage: wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>].");
-      const source = readOptionalStringFlag(context.flags, "source");
+      const source = readOptionalStrictStringFlag(context.flags, "source");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddAdminViewCommand({
           adminViewName: name2,
@@ -849,7 +942,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Binding source name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add binding-source` requires <name>. Usage: wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>].");
-      const [blockName, attributeName] = readOptionalPairedStringFlags(context.flags, "block", "attribute", "`wp-typia add binding-source` requires --block and --attribute to be provided together.");
+      const [blockName, attributeName] = readOptionalPairedStrictStringFlags(context.flags, "block", "attribute", "`wp-typia add binding-source` requires --block and --attribute to be provided together.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBindingSourceCommand({
           attributeName,
@@ -889,15 +982,16 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Block name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add block` requires <name>. Usage: wp-typia add block <name> [--template <basic|interactivity|persistence|compound>]");
-      const externalLayerId = readOptionalStringFlag(context.flags, "external-layer-id");
-      const externalLayerSource = readOptionalStringFlag(context.flags, "external-layer-source");
+      const externalLayerId = readOptionalStrictStringFlag(context.flags, "external-layer-id");
+      const externalLayerSource = readOptionalStrictStringFlag(context.flags, "external-layer-source");
       const shouldPromptForLayerSelection = Boolean(externalLayerSource) && !Boolean(externalLayerId) && context.isInteractiveSession;
       const selectPrompt = shouldPromptForLayerSelection ? await context.getOrCreatePrompt() : undefined;
-      const alternateRenderTargets = readOptionalStringFlag(context.flags, "alternate-render-targets");
-      const dataStorageMode = readOptionalStringFlag(context.flags, "data-storage");
-      const innerBlocksPreset = readOptionalStringFlag(context.flags, "inner-blocks-preset");
-      const persistencePolicy = readOptionalStringFlag(context.flags, "persistence-policy");
-      let resolvedTemplateId = readOptionalStringFlag(context.flags, "template");
+      const alternateRenderTargets = readOptionalStrictStringFlag(context.flags, "alternate-render-targets");
+      const dataStorageMode = readOptionalStrictStringFlag(context.flags, "data-storage");
+      const innerBlocksPreset = readOptionalStrictStringFlag(context.flags, "inner-blocks-preset");
+      const persistencePolicy = readOptionalStrictStringFlag(context.flags, "persistence-policy");
+      const requestedTemplateId = readOptionalStrictStringFlag(context.flags, "template");
+      let resolvedTemplateId = requestedTemplateId ? assertAddBlockTemplateId(context, requestedTemplateId) : undefined;
       if (!resolvedTemplateId && context.isInteractiveSession) {
         const templatePrompt = await context.getOrCreatePrompt();
         resolvedTemplateId = await templatePrompt.select("Select a block template", context.addRuntime.ADD_BLOCK_TEMPLATE_IDS.map((templateId) => ({
@@ -994,7 +1088,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Editor plugin name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add editor-plugin` requires <name>. Usage: wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>].");
-      const slot = readOptionalStringFlag(context.flags, "slot");
+      const slot = readOptionalStrictStringFlag(context.flags, "slot");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddEditorPluginCommand({
           cwd,
@@ -1032,8 +1126,8 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Target block",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add hooked-block` requires <block-slug>. Usage: wp-typia add hooked-block <block-slug> --anchor <anchor-block-name> --position <before|after|firstChild|lastChild>.");
-      const anchorBlockName = requireStringFlag(context.flags, "anchor", "`wp-typia add hooked-block` requires --anchor <anchor-block-name>.");
-      const position = requireStringFlag(context.flags, "position", "`wp-typia add hooked-block` requires --position <before|after|firstChild|lastChild>.");
+      const anchorBlockName = requireStrictStringFlag(context.flags, "anchor", "`wp-typia add hooked-block` requires --anchor <anchor-block-name>.");
+      const position = requireStrictStringFlag(context.flags, "position", "`wp-typia add hooked-block` requires --position <before|after|firstChild|lastChild>.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddHookedBlockCommand({
           anchorBlockName,
@@ -1103,7 +1197,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Style name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add style` requires <name>. Usage: wp-typia add style <name> --block <block-slug>.");
-      const blockSlug = requireStringFlag(context.flags, "block", "`wp-typia add style` requires --block <block-slug>.");
+      const blockSlug = requireStrictStringFlag(context.flags, "block", "`wp-typia add style` requires --block <block-slug>.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBlockStyleCommand({
           blockName: blockSlug,
@@ -1141,8 +1235,8 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Transform name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add transform` requires <name>. Usage: wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug>.");
-      const fromBlockName = requireStringFlag(context.flags, "from", "`wp-typia add transform` requires --from <namespace/block>.");
-      const toBlockName = requireStringFlag(context.flags, "to", "`wp-typia add transform` requires --to <block-slug|namespace/block-slug>.");
+      const fromBlockName = requireStrictStringFlag(context.flags, "from", "`wp-typia add transform` requires --from <namespace/block>.");
+      const toBlockName = requireStrictStringFlag(context.flags, "to", "`wp-typia add transform` requires --to <block-slug|namespace/block-slug>.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBlockTransformCommand({
           cwd,
@@ -1183,8 +1277,8 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "REST resource name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add rest-resource` requires <name>. Usage: wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create>].");
-      const methods = readOptionalStringFlag(context.flags, "methods");
-      const namespace = readOptionalStringFlag(context.flags, "namespace");
+      const methods = readOptionalStrictStringFlag(context.flags, "methods");
+      const namespace = readOptionalStrictStringFlag(context.flags, "namespace");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddRestResourceCommand({
           cwd,
@@ -1223,7 +1317,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "AI feature name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add ai-feature` requires <name>. Usage: wp-typia add ai-feature <name> [--namespace <vendor/v1>].");
-      const namespace = readOptionalStringFlag(context.flags, "namespace");
+      const namespace = readOptionalStrictStringFlag(context.flags, "namespace");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddAiFeatureCommand({
           aiFeatureName: name2,
@@ -1262,7 +1356,7 @@ var ADD_KIND_REGISTRY = {
     nameLabel: "Variation name",
     async prepareExecution(context) {
       const name = requireAddKindName(context, "`wp-typia add variation` requires <name>. Usage: wp-typia add variation <name> --block <block-slug>");
-      const blockSlug = requireStringFlag(context.flags, "block", "`wp-typia add variation` requires --block <block-slug>.");
+      const blockSlug = requireStrictStringFlag(context.flags, "block", "`wp-typia add variation` requires --block <block-slug>.");
       return createNamedExecutionPlan(context, {
         execute: ({ cwd, name: name2 }) => context.addRuntime.runAddVariationCommand({
           blockName: blockSlug,
@@ -1313,8 +1407,8 @@ import os from "node:os";
 import path from "node:path";
 import { isPlainObject as isRecord } from "@wp-typia/api-client/runtime-primitives";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES2,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError2
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES4,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError3
 } from "@wp-typia/project-tools/cli-diagnostics";
 var WP_TYPIA_CONFIG_SOURCES = [
   "~/.config/wp-typia/config.json",
@@ -1351,7 +1445,7 @@ async function readJsonFile(filePath) {
     return isRecord(parsed) ? parsed : null;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    throw createCliDiagnosticCodeError2(CLI_DIAGNOSTIC_CODES2.INVALID_ARGUMENT, `Unable to parse ${filePath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
+    throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES4.INVALID_ARGUMENT, `Unable to parse ${filePath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
   }
 }
 function resolveConfigPath(cwd, source) {
@@ -1404,8 +1498,8 @@ function extractWpTypiaConfigOverride(argv) {
 
 // src/runtime-bridge.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES4,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError4
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES6,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError5
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/runtime-bridge-add-dry-run.ts
@@ -1536,9 +1630,10 @@ async function simulateWorkspaceAddDryRun({
 }
 
 // src/runtime-bridge-output.ts
-import fs3 from "node:fs";
-import path3 from "node:path";
-import { formatPackageExecCommand } from "@wp-typia/project-tools/package-managers";
+import {
+  formatPackageExecCommand,
+  inferPackageManagerId
+} from "@wp-typia/project-tools/package-managers";
 
 // src/output-markers.ts
 var UNICODE_OUTPUT_MARKERS = {
@@ -1785,32 +1880,6 @@ function buildInitCompletionPayload(plan, markerOptions) {
     warningLines: plan.notes
   };
 }
-function inferProjectPackageManager(projectDir) {
-  try {
-    const packageJsonPath = path3.join(projectDir, "package.json");
-    if (fs3.existsSync(packageJsonPath)) {
-      const manifest = JSON.parse(fs3.readFileSync(packageJsonPath, "utf8"));
-      if (manifest.packageManager?.startsWith("bun@"))
-        return "bun";
-      if (manifest.packageManager?.startsWith("pnpm@"))
-        return "pnpm";
-      if (manifest.packageManager?.startsWith("yarn@"))
-        return "yarn";
-      if (manifest.packageManager?.startsWith("npm@"))
-        return "npm";
-    }
-  } catch {}
-  if (fs3.existsSync(path3.join(projectDir, "bun.lock")) || fs3.existsSync(path3.join(projectDir, "bun.lockb"))) {
-    return "bun";
-  }
-  if (fs3.existsSync(path3.join(projectDir, "pnpm-lock.yaml"))) {
-    return "pnpm";
-  }
-  if (fs3.existsSync(path3.join(projectDir, "yarn.lock")) || fs3.existsSync(path3.join(projectDir, ".yarnrc.yml"))) {
-    return "yarn";
-  }
-  return "npm";
-}
 function buildMigrationCompletionPayload(options, markerOptions) {
   const summaryLines = options.lines.filter((line) => line.trim().length > 0);
   return {
@@ -1820,7 +1889,7 @@ function buildMigrationCompletionPayload(options, markerOptions) {
 }
 function buildAddCompletionPayload(options, markerOptions) {
   const verificationLines = [
-    formatPackageExecCommand(options.packageManager ?? inferProjectPackageManager(options.projectDir), `wp-typia@${package_default.version}`, "doctor")
+    formatPackageExecCommand(options.packageManager ?? inferPackageManagerId(options.projectDir), `wp-typia@${package_default.version}`, "doctor")
   ];
   const verificationNote = "Run doctor via your package manager for a quick inventory and generated-artifact check after the add workflow.";
   const completion = buildAddKindCompletionDetails(options.kind, {
@@ -1870,20 +1939,6 @@ function printBlock(lines, printLine) {
     printLine(line);
   }
 }
-function formatExternalLayerSelectHint2(option) {
-  const details = [
-    option.description,
-    option.extends.length > 0 ? `extends ${option.extends.join(", ")}` : undefined
-  ].filter((value) => typeof value === "string" && value.length > 0);
-  return details.length > 0 ? details.join(" · ") : undefined;
-}
-function toExternalLayerPromptOptions2(options) {
-  return options.map((option) => ({
-    hint: formatExternalLayerSelectHint2(option),
-    label: option.id,
-    value: option.id
-  }));
-}
 
 // src/runtime-capabilities.ts
 function isInteractiveTerminal({
@@ -1895,12 +1950,17 @@ function isInteractiveTerminal({
 }
 // src/runtime-bridge-sync.ts
 import { spawnSync } from "node:child_process";
-import fs4 from "node:fs";
-import path4 from "node:path";
+import fs3 from "node:fs";
+import path3 from "node:path";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES3,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError3
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES5,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError4
 } from "@wp-typia/project-tools/cli-diagnostics";
+import {
+  formatInstallCommand,
+  formatRunScript,
+  inferPackageManagerId as inferPackageManagerId2
+} from "@wp-typia/project-tools/package-managers";
 var SYNC_INSTALL_MARKERS = [
   "node_modules",
   ".pnp.cjs",
@@ -1915,66 +1975,17 @@ function resolveSyncExecutionTarget(subcommand) {
   if (subcommand === "ai") {
     return "ai";
   }
-  throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
-}
-function formatRunScript(packageManagerId, scriptName, extraArgs = "") {
-  const args = extraArgs.trim();
-  if (packageManagerId === "bun") {
-    return args ? `bun run ${scriptName} ${args}` : `bun run ${scriptName}`;
-  }
-  if (packageManagerId === "npm") {
-    return args ? `npm run ${scriptName} -- ${args}` : `npm run ${scriptName}`;
-  }
-  if (packageManagerId === "pnpm") {
-    return args ? `pnpm run ${scriptName} ${args}` : `pnpm run ${scriptName}`;
-  }
-  return args ? `yarn run ${scriptName} ${args}` : `yarn run ${scriptName}`;
-}
-function formatInstallCommand(packageManagerId) {
-  switch (packageManagerId) {
-    case "bun":
-      return "bun install";
-    case "pnpm":
-      return "pnpm install";
-    case "yarn":
-      return "yarn install";
-    default:
-      return "npm install";
-  }
+  throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES5.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
 }
 function getSyncRootError(cwd) {
-  return createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.OUTSIDE_PROJECT_ROOT, `No generated wp-typia project root was found at ${cwd}. Run \`wp-typia sync\` from a scaffolded project or official workspace root that already contains generated sync scripts. If you expected this directory to work, cd into the scaffold root first or rerun the scaffold before syncing.`);
-}
-function inferSyncPackageManager(cwd, packageManagerField) {
-  const field = String(packageManagerField ?? "");
-  if (field.startsWith("bun@"))
-    return "bun";
-  if (field.startsWith("npm@"))
-    return "npm";
-  if (field.startsWith("pnpm@"))
-    return "pnpm";
-  if (field.startsWith("yarn@"))
-    return "yarn";
-  if (fs4.existsSync(path4.join(cwd, "bun.lock")) || fs4.existsSync(path4.join(cwd, "bun.lockb"))) {
-    return "bun";
-  }
-  if (fs4.existsSync(path4.join(cwd, "pnpm-lock.yaml"))) {
-    return "pnpm";
-  }
-  if (fs4.existsSync(path4.join(cwd, "yarn.lock")) || fs4.existsSync(path4.join(cwd, ".pnp.cjs")) || fs4.existsSync(path4.join(cwd, ".pnp.loader.mjs")) || fs4.existsSync(path4.join(cwd, ".yarnrc.yml"))) {
-    return "yarn";
-  }
-  if (fs4.existsSync(path4.join(cwd, "package-lock.json")) || fs4.existsSync(path4.join(cwd, "npm-shrinkwrap.json"))) {
-    return "npm";
-  }
-  return "npm";
+  return createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES5.OUTSIDE_PROJECT_ROOT, `No generated wp-typia project root was found at ${cwd}. Run \`wp-typia sync\` from a scaffolded project or official workspace root that already contains generated sync scripts. If you expected this directory to work, cd into the scaffold root first or rerun the scaffold before syncing.`);
 }
 function resolveSyncProjectContext(cwd) {
-  const packageJsonPath = path4.join(cwd, "package.json");
-  if (!fs4.existsSync(packageJsonPath)) {
+  const packageJsonPath = path3.join(cwd, "package.json");
+  if (!fs3.existsSync(packageJsonPath)) {
     throw getSyncRootError(cwd);
   }
-  const packageJson = JSON.parse(fs4.readFileSync(packageJsonPath, "utf8"));
+  const packageJson = JSON.parse(fs3.readFileSync(packageJsonPath, "utf8"));
   const scripts = packageJson.scripts ?? {};
   const syncScripts = {
     sync: typeof scripts.sync === "string" ? {
@@ -2000,17 +2011,17 @@ function resolveSyncProjectContext(cwd) {
   return {
     cwd,
     packageJsonPath,
-    packageManager: inferSyncPackageManager(cwd, packageJson.packageManager),
+    packageManager: inferPackageManagerId2(cwd, packageJson.packageManager),
     scripts: syncScripts
   };
 }
 function findInstalledDependencyMarkerDir(projectDir) {
-  let currentDir = path4.resolve(projectDir);
+  let currentDir = path3.resolve(projectDir);
   while (true) {
-    if (SYNC_INSTALL_MARKERS.some((marker) => fs4.existsSync(path4.join(currentDir, marker)))) {
+    if (SYNC_INSTALL_MARKERS.some((marker) => fs3.existsSync(path3.join(currentDir, marker)))) {
       return currentDir;
     }
-    const parentDir = path4.dirname(currentDir);
+    const parentDir = path3.dirname(currentDir);
     if (parentDir === currentDir) {
       return null;
     }
@@ -2033,7 +2044,7 @@ function assertSyncDependenciesInstalled(project, target) {
   if (markerDir) {
     return;
   }
-  throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.DEPENDENCIES_NOT_INSTALLED, `Project dependencies have not been installed yet. Run \`${formatInstallCommand(project.packageManager)}\` from the project root before \`wp-typia sync\`. The generated sync scripts rely on local tools such as \`tsx\`.`);
+  throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES5.DEPENDENCIES_NOT_INSTALLED, `Project dependencies have not been installed yet. Run \`${formatInstallCommand(project.packageManager)}\` from the project root before \`wp-typia sync\`. The generated sync scripts rely on local tools such as \`tsx\`.`);
 }
 function getPackageManagerRunInvocation(packageManager, scriptName, extraArgs) {
   switch (packageManager) {
@@ -2071,7 +2082,7 @@ function buildSyncPlannedCommands(project, extraArgs, target) {
   if (target === "ai") {
     const syncAiCommand2 = createSyncPlannedCommand(project, "sync-ai", extraArgs);
     if (!syncAiCommand2) {
-      throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
+      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES5.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
     }
     return [syncAiCommand2];
   }
@@ -2080,7 +2091,7 @@ function buildSyncPlannedCommands(project, extraArgs, target) {
   }
   const syncTypesCommand = createSyncPlannedCommand(project, "sync-types", extraArgs);
   if (!syncTypesCommand) {
-    throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES3.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
+    throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES5.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
   }
   const plannedCommands = [syncTypesCommand];
   const syncRestCommand = createSyncPlannedCommand(project, "sync-rest", extraArgs);
@@ -2154,8 +2165,8 @@ var loadCliScaffoldRuntime = () => import("@wp-typia/project-tools/cli-scaffold"
 var loadCliTemplatesRuntime = () => import("@wp-typia/project-tools/cli-templates");
 var loadMigrationsRuntime = () => import("@wp-typia/project-tools/migrations");
 async function wrapCliCommandError(command, error) {
-  const { createCliCommandError: createCliCommandError2 } = await loadCliDiagnosticsRuntime();
-  return createCliCommandError2({ command, error });
+  const { createCliCommandError: createCliCommandError3 } = await loadCliDiagnosticsRuntime();
+  return createCliCommandError3({ command, error });
 }
 function shouldWrapCliCommandError(options) {
   if (options.emitOutput === false) {
@@ -2166,17 +2177,6 @@ function shouldWrapCliCommandError(options) {
   }
   return true;
 }
-function readOptionalLooseStringFlag(flags, name) {
-  const value = flags[name];
-  if (value === undefined || value === null) {
-    return;
-  }
-  if (typeof value !== "string") {
-    throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.MISSING_ARGUMENT, `\`--${name}\` requires a value.`);
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : undefined;
-}
 function pushFlag(argv, name, value) {
   if (value === undefined || value === null || value === false) {
     return;
@@ -2318,7 +2318,7 @@ async function executeCreateCommand({
       promptText: activePrompt ? (message, defaultValue, validate) => activePrompt.text(message, defaultValue, validate) : undefined,
       queryPostType: readOptionalLooseStringFlag(flags, "query-post-type"),
       selectDataStorage: activePrompt ? () => activePrompt.select("Select a data storage mode", [...DATA_STORAGE_PROMPT_OPTIONS], 1) : undefined,
-      selectExternalLayerId: shouldPromptForExternalLayerSelection && activePrompt ? (options) => activePrompt.select("Select an external layer", toExternalLayerPromptOptions2(options), 1) : undefined,
+      selectExternalLayerId: shouldPromptForExternalLayerSelection && activePrompt ? (options) => activePrompt.select("Select an external layer", toExternalLayerPromptOptions(options), 1) : undefined,
       selectPackageManager: activePrompt ? () => activePrompt.select("Select a package manager", [...PACKAGE_MANAGER_PROMPT_OPTIONS], 1) : undefined,
       selectPersistencePolicy: activePrompt ? () => activePrompt.select("Select a persistence policy", [...PERSISTENCE_POLICY_PROMPT_OPTIONS], 1) : undefined,
       selectTemplate: activePrompt ? () => activePrompt.select("Select a template", getTemplateSelectOptions(), 1) : undefined,
@@ -2371,13 +2371,13 @@ async function executeAddCommand({
       if (emitOutput) {
         printLine(addRuntime.formatAddHelpText());
       }
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.MISSING_ARGUMENT, `\`wp-typia add\` requires <kind>. Usage: wp-typia add ${formatAddKindUsagePlaceholder()} ...`);
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT, `\`wp-typia add\` requires <kind>. Usage: wp-typia add ${formatAddKindUsagePlaceholder()} ...`);
     }
     if (!isAddKindId(kind)) {
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
     }
     if (dryRun && !supportsAddKindDryRun(kind)) {
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
     }
     const executionContext = {
       addRuntime,
@@ -2429,16 +2429,16 @@ async function executeTemplatesCommand({ flags }, printLine = console.log) {
   }
   if (subcommand === "inspect") {
     if (!flags.id) {
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
     }
     const template = getTemplateById(flags.id);
     if (!template) {
-      throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
+      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
     }
     printBlock([formatTemplateDetails(template)], printLine);
     return;
   }
-  throw createCliDiagnosticCodeError4(CLI_DIAGNOSTIC_CODES4.INVALID_COMMAND, `Unknown templates subcommand "${subcommand}". Expected list or inspect.`);
+  throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.INVALID_COMMAND, `Unknown templates subcommand "${subcommand}". Expected list or inspect.`);
 }
 async function executeInitCommand({ apply, cwd, packageManager, projectDir }, options = {}) {
   try {
@@ -2526,7 +2526,7 @@ async function executeMigrateCommand({
 }
 
 // src/command-contract.ts
-import path5 from "node:path";
+import path4 from "node:path";
 
 // src/command-registry.ts
 var WP_TYPIA_CANONICAL_CREATE_USAGE = "wp-typia create <project-dir>";
@@ -2740,7 +2740,7 @@ function looksLikeStructuredProjectInput(value) {
   return value.startsWith("@") && value.includes("/");
 }
 function assertPositionalAliasProjectDir(projectDir) {
-  const normalizedProjectDir = path5.normalize(projectDir).replace(/[\\/]+$/u, "") || path5.normalize(projectDir);
+  const normalizedProjectDir = path4.normalize(projectDir).replace(/[\\/]+$/u, "") || path4.normalize(projectDir);
   if (normalizedProjectDir === "." || normalizedProjectDir === "..") {
     throw new Error(`The positional alias does not scaffold into \`${projectDir}\`. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` with an explicit child directory instead.`);
   }
@@ -2823,7 +2823,7 @@ function parseGlobalFlags(argv) {
     };
   } catch (error) {
     if (error instanceof Error && /\`--format\` requires a value\.|\`--id\` requires a value\./.test(error.message)) {
-      throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT, error.message);
+      throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT, error.message);
     }
     throw error;
   }
@@ -2986,16 +2986,16 @@ function renderTemplatesJson(flags, subcommand) {
   }
   const templateId = flags.id;
   if (!templateId) {
-    throw createCliCommandError2({
-      code: CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT,
+    throw createCliCommandError3({
+      code: CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT,
       command: "templates",
       detailLines: ["`wp-typia templates inspect` requires <template-id>."]
     });
   }
   const template = getTemplateById(templateId);
   if (!template) {
-    throw createCliCommandError2({
-      code: CLI_DIAGNOSTIC_CODES5.INVALID_ARGUMENT,
+    throw createCliCommandError3({
+      code: CLI_DIAGNOSTIC_CODES7.INVALID_ARGUMENT,
       command: "templates",
       detailLines: [`Unknown template "${templateId}".`]
     });
@@ -3005,8 +3005,8 @@ function renderTemplatesJson(flags, subcommand) {
   }, null, 2));
 }
 function renderUnsupportedCommand(command) {
-  throw createCliCommandError2({
-    code: CLI_DIAGNOSTIC_CODES5.UNSUPPORTED_COMMAND,
+  throw createCliCommandError3({
+    code: CLI_DIAGNOSTIC_CODES7.UNSUPPORTED_COMMAND,
     command,
     detailLines: [
       [
@@ -3021,7 +3021,7 @@ function renderUnsupportedCommand(command) {
 async function renderDoctorJson() {
   const [
     { getDoctorChecks },
-    { createCliCommandError: createCliCommandError3, getDoctorFailureDetailLines }
+    { createCliCommandError: createCliCommandError4, getDoctorFailureDetailLines }
   ] = await Promise.all([
     import("@wp-typia/project-tools/cli-doctor"),
     import("@wp-typia/project-tools/cli-diagnostics")
@@ -3031,8 +3031,8 @@ async function renderDoctorJson() {
     checks
   }, null, 2));
   if (checks.some((check) => check.status === "fail")) {
-    throw createCliCommandError3({
-      code: CLI_DIAGNOSTIC_CODES5.DOCTOR_CHECK_FAILED,
+    throw createCliCommandError4({
+      code: CLI_DIAGNOSTIC_CODES7.DOCTOR_CHECK_FAILED,
       command: "doctor",
       detailLines: getDoctorFailureDetailLines(checks),
       summary: "One or more doctor checks failed."
@@ -3048,8 +3048,8 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
     if (!positionals[1]) {
       const { formatAddHelpText } = await import("@wp-typia/project-tools/cli-add");
       printLine(formatAddHelpText());
-      throw createCliCommandError2({
-        code: CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT,
+      throw createCliCommandError3({
+        code: CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT,
         command: "add",
         detailLines: [
           `\`wp-typia add\` requires <kind>. Usage: wp-typia add ${formatAddKindUsagePlaceholder()} ...`
@@ -3068,7 +3068,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
           name: positionals[2]
         });
       } catch (error) {
-        throw createCliCommandError2({
+        throw createCliCommandError3({
           command: "add",
           error
         });
@@ -3096,8 +3096,8 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
   }) => {
     const projectDir = positionals[1];
     if (!projectDir) {
-      throw createCliCommandError2({
-        code: CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT,
+      throw createCliCommandError3({
+        code: CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT,
         command: "create",
         detailLines: [
           "`wp-typia create` requires <project-dir>.",
@@ -3115,7 +3115,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
         projectDir
       });
     } catch (error) {
-      throw createCliCommandError2({
+      throw createCliCommandError3({
         command: "create",
         error
       });
@@ -3193,7 +3193,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
         }));
       }
     } catch (error) {
-      throw createCliCommandError2({
+      throw createCliCommandError3({
         command: "sync",
         error
       });
@@ -3207,8 +3207,8 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
     const templateId = typeof mergedFlags.id === "string" ? mergedFlags.id : positionals[2];
     const resolvedSubcommand = templateId ? "inspect" : subcommand ?? "list";
     if (resolvedSubcommand !== "list" && resolvedSubcommand !== "inspect") {
-      throw createCliCommandError2({
-        code: CLI_DIAGNOSTIC_CODES5.INVALID_COMMAND,
+      throw createCliCommandError3({
+        code: CLI_DIAGNOSTIC_CODES7.INVALID_COMMAND,
         command: "templates",
         detailLines: [
           `Unknown templates subcommand "${resolvedSubcommand}". Expected list or inspect.`
@@ -3233,6 +3233,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
 async function runNodeCli(argv = process.argv.slice(2)) {
   const normalizedArgv = normalizeWpTypiaArgv(argv);
   const { argv: argvWithoutConfigOverride, configOverridePath } = extractWpTypiaConfigOverride(normalizedArgv);
+  validateCliOutputFormatArgv(argvWithoutConfigOverride);
   const { argv: cliArgv, flags } = parseGlobalFlags(argvWithoutConfigOverride);
   const { flags: commandFlags, positionals } = parseArgv(cliArgv);
   const rawMergedFlags = {
@@ -3240,9 +3241,14 @@ async function runNodeCli(argv = process.argv.slice(2)) {
     ...flags
   };
   const [command, subcommand] = positionals;
-  const helpRequested = cliArgv.length === 0 || hasFlagBeforeTerminator(cliArgv, "--help") || command === "help";
+  const helpRequested = hasFlagBeforeTerminator(cliArgv, "--help") || command === "help";
   const helpTarget = command === "help" ? subcommand : command;
   const versionRequested = hasFlagBeforeTerminator(cliArgv, "--version") || command === "version";
+  if (cliArgv.length === 0) {
+    renderGeneralHelp();
+    process.exitCode = 1;
+    return;
+  }
   if (helpRequested) {
     if (helpTarget) {
       const helpRenderer = NODE_FALLBACK_HELP_RENDERERS[helpTarget];
@@ -3304,4 +3310,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=F8B7C97D684FB07764756E2164756E21
+//# debugId=8CAE70B24462975F64756E2164756E21