wp-typia 0.22.4 → 0.22.5

package/dist-bunli/{cli-gsj6vyn5.js → cli-nzwpmw4y.js}

@@ -11,7 +11,7 @@ import {
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.22.4",
+  version: "0.22.5",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -81,7 +81,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.4",
+    "@wp-typia/project-tools": "0.22.5",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -103,6 +103,51 @@ var package_default = {
   }
 };
 
+// bin/argv-walker.js
+function normalizeOptionSet(values) {
+  return values instanceof Set ? values : new Set(values);
+}
+function collectPositionalIndexes(argv, metadata) {
+  const longValueOptionSet = normalizeOptionSet(metadata.longValueOptions);
+  const shortValueOptionSet = normalizeOptionSet(metadata.shortValueOptions);
+  const positionalIndexes = [];
+  for (let index = 0;index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--") {
+      for (let restIndex = index + 1;restIndex < argv.length; restIndex += 1) {
+        positionalIndexes.push(restIndex);
+      }
+      break;
+    }
+    if (!arg.startsWith("-") || arg === "-") {
+      positionalIndexes.push(index);
+      continue;
+    }
+    if (arg.startsWith("--")) {
+      if (arg.includes("=")) {
+        continue;
+      }
+      const next = argv[index + 1];
+      if (longValueOptionSet.has(arg) && next && !next.startsWith("-")) {
+        index += 1;
+      }
+      continue;
+    }
+    if (arg.length === 2 && shortValueOptionSet.has(arg) && argv[index + 1] && !argv[index + 1].startsWith("-")) {
+      index += 1;
+    }
+  }
+  return positionalIndexes;
+}
+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/command-option-metadata.ts
 var CREATE_OPTION_METADATA = {
   "alternate-render-targets": {
@@ -334,7 +379,7 @@ var SYNC_OPTION_METADATA = {
 };
 var DOCTOR_OPTION_METADATA = {
   format: {
-    description: "Use `json` for machine-readable doctor check output or `toon` for human-readable output.",
+    description: "Use `json` for machine-readable doctor check output or `text` for human-readable output.",
     type: "string"
   }
 };
@@ -351,7 +396,7 @@ var GLOBAL_OPTION_METADATA = {
     type: "string"
   },
   format: {
-    description: "Output format for supported commands (`json` or `toon`).",
+    description: "Output format for supported commands (`json` or `text`).",
     type: "string"
   },
   id: {
@@ -511,65 +556,56 @@ function resolveCommandOptionValues(metadata, options) {
   return resolved;
 }
 
-// bin/argv-walker.js
-function normalizeOptionSet(values) {
-  return values instanceof Set ? values : new Set(values);
+// src/cli-command-resolution.ts
+function resolveEntrypointCliCommand(argv) {
+  return findFirstPositional(argv, COMMAND_ROUTING_METADATA) ?? "wp-typia";
 }
-function collectPositionalIndexes(argv, metadata) {
-  const longValueOptionSet = normalizeOptionSet(metadata.longValueOptions);
-  const shortValueOptionSet = normalizeOptionSet(metadata.shortValueOptions);
-  const positionalIndexes = [];
+
+// src/cli-output-format.ts
+var PUBLIC_CLI_OUTPUT_FORMATS = ["json", "text"];
+var LEGACY_CLI_OUTPUT_FORMAT_ALIASES = ["toon"];
+var SUPPORTED_CLI_OUTPUT_FORMATS = [
+  ...PUBLIC_CLI_OUTPUT_FORMATS,
+  ...LEGACY_CLI_OUTPUT_FORMAT_ALIASES
+];
+var SUPPORTED_CLI_OUTPUT_FORMAT_VALUES = SUPPORTED_CLI_OUTPUT_FORMATS;
+function formatSupportedCliOutputFormats() {
+  return PUBLIC_CLI_OUTPUT_FORMATS.join(", ");
+}
+function isSupportedCliOutputFormat(value) {
+  return typeof value === "string" && SUPPORTED_CLI_OUTPUT_FORMAT_VALUES.includes(value);
+}
+function normalizeCliOutputFormatArgv(argv) {
+  let normalized;
   for (let index = 0;index < argv.length; index += 1) {
     const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
     if (arg === "--") {
-      for (let restIndex = index + 1;restIndex < argv.length; restIndex += 1) {
-        positionalIndexes.push(restIndex);
-      }
       break;
     }
-    if (!arg.startsWith("-") || arg === "-") {
-      positionalIndexes.push(index);
-      continue;
-    }
-    if (arg.startsWith("--")) {
-      if (arg.includes("=")) {
-        continue;
-      }
+    if (arg === "--format") {
       const next = argv[index + 1];
-      if (longValueOptionSet.has(arg) && next && !next.startsWith("-")) {
+      if (next === "text") {
+        normalized ??= [...argv];
+        normalized[index + 1] = "toon";
+      }
+      if (next && !next.startsWith("-")) {
         index += 1;
       }
       continue;
     }
-    if (arg.length === 2 && shortValueOptionSet.has(arg) && argv[index + 1] && !argv[index + 1].startsWith("-")) {
-      index += 1;
+    if (arg === "--format=text") {
+      normalized ??= [...argv];
+      normalized[index] = "--format=toon";
     }
   }
-  return positionalIndexes;
-}
-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);
+  return normalized ?? argv;
 }
 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;
@@ -607,9 +643,6 @@ function validateCliOutputFormatArgv(argv) {
 }
 
 // src/cli-diagnostic-output.ts
-function resolveEntrypointCliCommand2(argv) {
-  return findFirstPositional(argv, COMMAND_ROUTING_METADATA) ?? "wp-typia";
-}
 function writeStructuredCliJsonToStderr(payload) {
   process.stderr.write(`${JSON.stringify(payload, null, 2)}
 `);
@@ -633,7 +666,10 @@ function prefersStructuredCliArgv(argv) {
   return false;
 }
 function prefersStructuredCliOutput(args) {
-  return args.formatExplicit && args.format === "json" && isSupportedCliOutputFormat(args.format) || Boolean(args.agent) || Boolean(args.context?.store?.isAIAgent);
+  if (args.formatExplicit) {
+    return args.format === "json" && isSupportedCliOutputFormat(args.format);
+  }
+  return Boolean(args.agent) || Boolean(args.context?.store?.isAIAgent);
 }
 function emitCliDiagnosticFailure(args, options) {
   const diagnostic = createCliCommandError(options);
@@ -654,7 +690,7 @@ function writeStructuredCliDiagnosticError(argv, error) {
   }
   writeStructuredCliJsonToStderr({
     error: serializeCliDiagnosticError(createCliCommandError({
-      command: resolveEntrypointCliCommand2(argv),
+      command: resolveEntrypointCliCommand(argv),
       error
     })),
     ok: false
@@ -902,6 +938,6 @@ function getMcpSchemaSources(config) {
 function createPlugin(input) {
   return input;
 }
-export { createPlugin, package_default, CREATE_OPTION_METADATA, ADD_OPTION_METADATA, INIT_OPTION_METADATA, MIGRATE_OPTION_METADATA, MCP_OPTION_METADATA, SYNC_OPTION_METADATA, DOCTOR_OPTION_METADATA, TEMPLATES_OPTION_METADATA, GLOBAL_OPTION_METADATA, COMMAND_OPTION_METADATA_BY_GROUP, ALL_COMMAND_OPTION_METADATA, buildCommandOptions, collectOptionNamesByType, buildCommandOptionParser, COMMAND_ROUTING_METADATA, extractKnownOptionValuesFromArgv, resolveCommandOptionValues, collectPositionalIndexes, findFirstPositionalIndex, validateCliOutputFormatArgv, prefersStructuredCliOutput, emitCliDiagnosticFailure, writeStructuredCliDiagnosticError, ADD_KIND_IDS, WP_TYPIA_CANONICAL_CREATE_USAGE, WP_TYPIA_RESERVED_TOP_LEVEL_COMMAND_NAMES, WP_TYPIA_TOP_LEVEL_COMMAND_NAMES, WP_TYPIA_COMMAND_OPTION_GROUP_NAMES_BY_TOP_LEVEL_COMMAND, WP_TYPIA_CONFIG_SOURCES, mergeWpTypiaUserConfig, loadWpTypiaUserConfigFromSource, loadWpTypiaUserConfig, getCreateDefaults, getAddBlockDefaults, getMcpSchemaSources };
+export { createPlugin, package_default, collectPositionalIndexes, findFirstPositionalIndex, CREATE_OPTION_METADATA, ADD_OPTION_METADATA, INIT_OPTION_METADATA, MIGRATE_OPTION_METADATA, MCP_OPTION_METADATA, SYNC_OPTION_METADATA, DOCTOR_OPTION_METADATA, TEMPLATES_OPTION_METADATA, GLOBAL_OPTION_METADATA, COMMAND_OPTION_METADATA_BY_GROUP, ALL_COMMAND_OPTION_METADATA, buildCommandOptions, collectOptionNamesByType, buildCommandOptionParser, COMMAND_ROUTING_METADATA, extractKnownOptionValuesFromArgv, resolveCommandOptionValues, normalizeCliOutputFormatArgv, validateCliOutputFormatArgv, prefersStructuredCliOutput, emitCliDiagnosticFailure, writeStructuredCliDiagnosticError, ADD_KIND_IDS, WP_TYPIA_CANONICAL_CREATE_USAGE, WP_TYPIA_RESERVED_TOP_LEVEL_COMMAND_NAMES, WP_TYPIA_TOP_LEVEL_COMMAND_NAMES, WP_TYPIA_COMMAND_OPTION_GROUP_NAMES_BY_TOP_LEVEL_COMMAND, WP_TYPIA_CONFIG_SOURCES, mergeWpTypiaUserConfig, loadWpTypiaUserConfigFromSource, loadWpTypiaUserConfig, getCreateDefaults, getAddBlockDefaults, getMcpSchemaSources };
 
-//# debugId=6F7F012C6A86461164756E2164756E21
+//# debugId=B9D55210C12B16C464756E2164756E21

package/dist-bunli/{cli-scaffold-f57ccf5v.js → cli-scaffold-ad3bd555.js}

@@ -19,9 +19,9 @@ import {
   resolvePackageManagerId,
   resolveTemplateId,
   scaffoldProject
-} from "./cli-6ymn63t4.js";
+} from "./cli-ctddkm3n.js";
 import"./cli-1sm60g1z.js";
-import"./cli-2mt6bvcj.js";
+import"./cli-xbzfx7qz.js";
 import"./cli-hb9vpsev.js";
 import"./cli-bq2v559b.js";
 import"./cli-10pe4mf8.js";
@@ -29,7 +29,7 @@ import {
   OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE,
   isBuiltInTemplateId
 } from "./cli-tke8twkn.js";
-import"./cli-qr2ek735.js";
+import"./cli-j30rk466.js";
 import {
   createManagedTempRoot
 } from "./cli-t73q5aqz.js";

package/dist-bunli/{cli-2mt6bvcj.js → cli-xbzfx7qz.js}

@@ -51,7 +51,7 @@ import {
 } from "./cli-bq2v559b.js";
 import {
   readWorkspaceInventory
-} from "./cli-qr2ek735.js";
+} from "./cli-j30rk466.js";
 import {
   getInvalidWorkspaceProjectReason,
   tryResolveWorkspaceProject

package/dist-bunli/cli.js

@@ -17,10 +17,11 @@ import {
   loadWpTypiaUserConfig,
   loadWpTypiaUserConfigFromSource,
   mergeWpTypiaUserConfig,
+  normalizeCliOutputFormatArgv,
   package_default,
   validateCliOutputFormatArgv,
   writeStructuredCliDiagnosticError
-} from "./cli-gsj6vyn5.js";
+} from "./cli-nzwpmw4y.js";
 import"./cli-03j0axbt.js";
 import {
   GLOBAL_FLAGS,
@@ -2454,7 +2455,7 @@ async function formatCliError(error) {
 }
 async function createWpTypiaCli(options = {}) {
   applyStandaloneSupportLayoutEnv();
-  const { wpTypiaCommands } = await import("./command-list-wsaa4t2p.js");
+  const { wpTypiaCommands } = await import("./command-list-scd6zqp8.js");
   const cli = await createCLI({
     ...bunliConfig,
     description: package_default.description,
@@ -2490,7 +2491,7 @@ async function main(argv = process.argv.slice(2)) {
   const { argv: cliArgv, configOverridePath } = extractWpTypiaConfigOverride(normalizedArgv);
   validateCliOutputFormatArgv(cliArgv);
   const cli = await createWpTypiaCli({ configOverridePath });
-  await cli.run(cliArgv);
+  await cli.run(normalizeCliOutputFormatArgv(cliArgv));
 }
 async function runCliEntrypoint(argv = process.argv.slice(2)) {
   try {
@@ -2514,4 +2515,4 @@ export {
   createWpTypiaCli
 };
 
-//# debugId=CF070B64D3FCE30F64756E2164756E21
+//# debugId=47FFF7F809C451D764756E2164756E21

package/dist-bunli/{command-list-wsaa4t2p.js → command-list-scd6zqp8.js}

@@ -18,7 +18,7 @@ import {
   package_default,
   prefersStructuredCliOutput,
   resolveCommandOptionValues
-} from "./cli-gsj6vyn5.js";
+} from "./cli-nzwpmw4y.js";
 import {
   Result,
   TaggedError,
@@ -1380,14 +1380,14 @@ async function executeSyncCommand({
 }
 
 // src/runtime-bridge.ts
-var loadCliAddRuntime = () => import("./cli-add-6s6kzf7x.js");
+var loadCliAddRuntime = () => import("./cli-add-1gqgshf0.js");
 var loadCliDiagnosticsRuntime = () => import("./cli-diagnostics-5dvztm7q.js");
-var loadCliDoctorRuntime = () => import("./cli-doctor-70zd5m3b.js");
-var loadCliInitRuntime = () => import("./cli-init-kjjyky1y.js");
+var loadCliDoctorRuntime = () => import("./cli-doctor-w35s8y9w.js");
+var loadCliInitRuntime = () => import("./cli-init-z8sjmkvc.js");
 var loadCliPromptRuntime = () => import("./cli-prompt-614tq57c.js");
-var loadCliScaffoldRuntime = () => import("./cli-scaffold-f57ccf5v.js");
+var loadCliScaffoldRuntime = () => import("./cli-scaffold-ad3bd555.js");
 var loadCliTemplatesRuntime = () => import("./cli-templates-9t2a7zqd.js");
-var loadMigrationsRuntime = () => import("./migrations-vw502qf9.js");
+var loadMigrationsRuntime = () => import("./migrations-skkzdvhm.js");
 async function wrapCliCommandError(command, error) {
   const { createCliCommandError } = await loadCliDiagnosticsRuntime();
   return createCliCommandError({ command, error });
@@ -2335,7 +2335,7 @@ var doctorCommand = defineCommand({
     const prefersStructuredOutput = prefersStructuredCliOutput(args);
     if (prefersStructuredOutput) {
       const [{ getDoctorChecks }, { getDoctorFailureDetailLines }] = await Promise.all([
-        import("./cli-doctor-70zd5m3b.js"),
+        import("./cli-doctor-w35s8y9w.js"),
         import("./cli-diagnostics-5dvztm7q.js")
       ]);
       const checks = await getDoctorChecks(args.cwd);

package/dist-bunli/{migrations-vw502qf9.js → migrations-skkzdvhm.js}

@@ -15,10 +15,10 @@ import {
   snapshotProjectVersion,
   verifyProjectMigrations,
   wizardProjectMigrations
-} from "./cli-2mt6bvcj.js";
+} from "./cli-xbzfx7qz.js";
 import"./cli-hb9vpsev.js";
 import"./cli-bq2v559b.js";
-import"./cli-qr2ek735.js";
+import"./cli-j30rk466.js";
 import"./cli-btbpt84c.js";
 import"./cli-6bhfzq5e.js";
 import"./cli-xnn9xjcy.js";

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.4",
+  version: "0.22.5",
   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.4",
+    "@wp-typia/project-tools": "0.22.5",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -336,7 +336,7 @@ var SYNC_OPTION_METADATA = {
 };
 var DOCTOR_OPTION_METADATA = {
   format: {
-    description: "Use `json` for machine-readable doctor check output or `toon` for human-readable output.",
+    description: "Use `json` for machine-readable doctor check output or `text` for human-readable output.",
     type: "string"
   }
 };
@@ -353,7 +353,7 @@ var GLOBAL_OPTION_METADATA = {
     type: "string"
   },
   format: {
-    description: "Output format for supported commands (`json` or `toon`).",
+    description: "Output format for supported commands (`json` or `text`).",
     type: "string"
   },
   id: {
@@ -584,12 +584,6 @@ import {
   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);
@@ -635,20 +629,32 @@ function findFirstPositional(argv, metadata) {
   return firstPositionalIndex === -1 ? undefined : argv[firstPositionalIndex];
 }
 
+// src/cli-command-resolution.ts
+function resolveEntrypointCliCommand(argv) {
+  return findFirstPositional(argv, COMMAND_ROUTING_METADATA) ?? "wp-typia";
+}
+
 // src/cli-output-format.ts
-var SUPPORTED_CLI_OUTPUT_FORMATS = ["json", "toon"];
+import {
+  CLI_DIAGNOSTIC_CODES,
+  createCliCommandError
+} from "@wp-typia/project-tools/cli-diagnostics";
+var PUBLIC_CLI_OUTPUT_FORMATS = ["json", "text"];
+var LEGACY_CLI_OUTPUT_FORMAT_ALIASES = ["toon"];
+var SUPPORTED_CLI_OUTPUT_FORMATS = [
+  ...PUBLIC_CLI_OUTPUT_FORMATS,
+  ...LEGACY_CLI_OUTPUT_FORMAT_ALIASES
+];
+var SUPPORTED_CLI_OUTPUT_FORMAT_VALUES = SUPPORTED_CLI_OUTPUT_FORMATS;
 function formatSupportedCliOutputFormats() {
-  return SUPPORTED_CLI_OUTPUT_FORMATS.join(", ");
+  return PUBLIC_CLI_OUTPUT_FORMATS.join(", ");
 }
 function isSupportedCliOutputFormat(value) {
-  return SUPPORTED_CLI_OUTPUT_FORMATS.includes(value);
+  return typeof value === "string" && SUPPORTED_CLI_OUTPUT_FORMAT_VALUES.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;
@@ -2789,9 +2795,9 @@ var NODE_FALLBACK_RUNTIME_SUMMARY_LINES = [
   `Install Bun 1.3.11+ or use \`bunx wp-typia ...\` for the full Bunli/OpenTUI runtime and Bun-only command surfaces such as \`skills\`, \`completions\`, and \`mcp\`. ${STANDALONE_GUIDANCE_LINE}`,
   "Output markers: WP_TYPIA_ASCII=1 forces ASCII markers, WP_TYPIA_ASCII=0 opts back into Unicode markers, and non-empty NO_COLOR requests ASCII markers when WP_TYPIA_ASCII is unset."
 ];
-function printLine(line = "") {
+var printLine = (line) => {
   console.log(line);
-}
+};
 function printBlock2(lines) {
   for (const line of lines) {
     printLine(line);
@@ -2878,91 +2884,58 @@ function renderGeneralHelp() {
     `- ${WP_TYPIA_POSITIONAL_ALIAS_USAGE}`
   ]);
 }
-function renderTemplatesHelp() {
-  printBlock2([
-    "wp-typia templates <list|inspect>",
-    "",
-    ...NODE_FALLBACK_RUNTIME_SUMMARY_LINES,
-    "",
-    "Supported flags:",
-    ...formatNodeFallbackOptionHelp(TEMPLATES_OPTION_METADATA)
-  ]);
-}
-function renderCreateHelp() {
-  printBlock2([
-    `Usage: ${WP_TYPIA_CANONICAL_CREATE_USAGE}`,
-    "",
-    ...NODE_FALLBACK_RUNTIME_SUMMARY_LINES,
-    "",
-    "Supported flags:",
-    ...formatNodeFallbackOptionHelp(CREATE_OPTION_METADATA)
-  ]);
-}
-function renderInitHelp() {
-  printBlock2([
-    "Usage: wp-typia init [project-dir]",
-    "",
-    ...NODE_FALLBACK_RUNTIME_SUMMARY_LINES,
-    "",
-    "Preview-by-default retrofit planner for existing WordPress block or plugin projects. Re-run with --apply to write package.json updates and helper scripts.",
-    "",
-    "Supported flags:",
-    ...formatNodeFallbackOptionHelp(INIT_OPTION_METADATA)
-  ]);
-}
-function renderAddHelp() {
-  printBlock2([
-    "Usage: wp-typia add <kind> <name>",
-    "",
-    ...NODE_FALLBACK_RUNTIME_SUMMARY_LINES,
-    "",
-    `Supported kinds: ${formatAddKindList()}`,
-    "",
-    "Supported flags:",
-    ...formatNodeFallbackOptionHelp(ADD_OPTION_METADATA)
-  ]);
-}
-function renderMigrateHelp() {
-  printBlock2([
-    `Usage: ${WP_TYPIA_CANONICAL_MIGRATE_USAGE}`,
-    "",
-    ...NODE_FALLBACK_RUNTIME_SUMMARY_LINES,
-    "",
-    "Supported flags:",
-    ...formatNodeFallbackOptionHelp(MIGRATE_OPTION_METADATA)
-  ]);
-}
-function renderSyncHelp() {
+function renderNodeFallbackCommandHelp(config) {
   printBlock2([
-    "Usage: wp-typia sync [ai]",
+    config.heading,
     "",
     ...NODE_FALLBACK_RUNTIME_SUMMARY_LINES,
     "",
+    ...config.bodyLines ? [...config.bodyLines, ""] : [],
     "Supported flags:",
-    ...formatNodeFallbackOptionHelp(SYNC_OPTION_METADATA)
+    ...formatNodeFallbackOptionHelp(config.optionMetadata)
   ]);
 }
-function renderDoctorHelp() {
-  printBlock2([
-    "Usage: wp-typia doctor [--format json]",
-    "",
-    ...NODE_FALLBACK_RUNTIME_SUMMARY_LINES,
-    "",
-    "Runs read-only environment readiness checks. Official wp-typia workspace roots also get inventory, source-tree drift, iframe/API v3 compatibility, and shared convention checks.",
-    "",
-    "Supported flags:",
-    ...formatNodeFallbackOptionHelp(DOCTOR_OPTION_METADATA)
-  ]);
-}
-var NODE_FALLBACK_HELP_RENDERERS = {
-  add: renderAddHelp,
-  create: renderCreateHelp,
-  doctor: renderDoctorHelp,
-  init: renderInitHelp,
-  migrate: renderMigrateHelp,
-  sync: renderSyncHelp,
-  templates: renderTemplatesHelp
+var NODE_FALLBACK_COMMAND_HELP_CONFIG = {
+  add: {
+    bodyLines: [`Supported kinds: ${formatAddKindList()}`],
+    heading: "Usage: wp-typia add <kind> <name>",
+    optionMetadata: ADD_OPTION_METADATA
+  },
+  create: {
+    heading: `Usage: ${WP_TYPIA_CANONICAL_CREATE_USAGE}`,
+    optionMetadata: CREATE_OPTION_METADATA
+  },
+  doctor: {
+    bodyLines: [
+      "Runs read-only environment readiness checks. Official wp-typia workspace roots also get inventory, source-tree drift, iframe/API v3 compatibility, and shared convention checks."
+    ],
+    heading: "Usage: wp-typia doctor [--format json]",
+    optionMetadata: DOCTOR_OPTION_METADATA
+  },
+  init: {
+    bodyLines: [
+      "Preview-by-default retrofit planner for existing WordPress block or plugin projects. Re-run with --apply to write package.json updates and helper scripts."
+    ],
+    heading: "Usage: wp-typia init [project-dir]",
+    optionMetadata: INIT_OPTION_METADATA
+  },
+  migrate: {
+    heading: `Usage: ${WP_TYPIA_CANONICAL_MIGRATE_USAGE}`,
+    optionMetadata: MIGRATE_OPTION_METADATA
+  },
+  sync: {
+    heading: "Usage: wp-typia sync [ai]",
+    optionMetadata: SYNC_OPTION_METADATA
+  },
+  templates: {
+    heading: "wp-typia templates <list|inspect>",
+    optionMetadata: TEMPLATES_OPTION_METADATA
+  }
 };
+var NODE_FALLBACK_HELP_RENDERERS = Object.fromEntries(Object.entries(NODE_FALLBACK_COMMAND_HELP_CONFIG).map(([command, config]) => [
+  command,
+  () => renderNodeFallbackCommandHelp(config)
+]));
 function renderVersion(options = {}) {
   if (options.format === "json") {
     printLine(JSON.stringify({
@@ -3310,4 +3283,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=8CAE70B24462975F64756E2164756E21
+//# debugId=A8E2D093C9BAE2C064756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.22.4",
+  "version": "0.22.5",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -70,7 +70,7 @@
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/project-tools": "0.22.4",
+    "@wp-typia/project-tools": "0.22.5",
     "better-result": "^2.7.0",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",