wp-typia 0.24.1 → 0.24.3

package/dist-bunli/node-cli.js

@@ -146,11 +146,11 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   scope: {
-    description: "Pattern catalog scope for pattern workflows (full or section).",
+    description: "Pattern catalog scope for pattern workflows; one of full or section.",
     type: "string"
   },
   "section-role": {
-    description: "Typed section role for section-scoped pattern catalog entries.",
+    description: "Typed section role for section-scoped pattern catalog entries; requires --scope section.",
     type: "string"
   },
   "secret-field": {
@@ -194,12 +194,12 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   tags: {
-    description: "Comma-separated tags for typed pattern catalog entries; may be repeated.",
+    description: "Comma-separated tags for typed pattern catalog entries; combine with repeatable --tag for single tags.",
     repeatable: true,
     type: "string"
   },
   tag: {
-    description: "Repeatable singular tag for typed pattern catalog entries.",
+    description: "Repeatable single tag for typed pattern catalog entries; use --tags for comma-separated lists.",
     repeatable: true,
     type: "string"
   },
@@ -492,22 +492,29 @@ function createMissingOptionValueError(optionLabel) {
 function createUnknownOptionError(optionLabel) {
   return createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Unknown option \`${optionLabel}\`.`);
 }
-function extractKnownOptionValuesFromArgv(argv, options) {
+function walkArgvOptions(argv, options) {
   const flags = {};
   const nextArgv = [];
-  const optionNames = new Set(options.optionNames);
+  const booleanOptionNames = new Set(options.parser.booleanOptionNames);
+  const optionNames = new Set(options.optionNames ?? []);
+  for (const optionName of options.extraBooleanOptionNames ?? []) {
+    booleanOptionNames.add(optionName);
+  }
   for (let index = 0;index < argv.length; index += 1) {
     const arg = argv[index];
     if (!arg) {
       continue;
     }
     if (arg === "--") {
-      nextArgv.push(...argv.slice(index));
+      nextArgv.push(...argv.slice(index + (options.strict ? 1 : 0)));
       break;
     }
     if (arg.length === 2 && arg.startsWith("-")) {
       const shortFlag = options.parser.shortFlagMap.get(arg.slice(1));
-      if (!shortFlag || !optionNames.has(shortFlag.name)) {
+      if (!shortFlag || !options.strict && !optionNames.has(shortFlag.name)) {
+        if (options.strict) {
+          throw createUnknownOptionError(arg);
+        }
         nextArgv.push(arg);
         continue;
       }
@@ -532,15 +539,18 @@ function extractKnownOptionValuesFromArgv(argv, options) {
       const separatorIndex = option.indexOf("=");
       const rawName = separatorIndex === -1 ? option : option.slice(0, separatorIndex);
       const inlineValue = separatorIndex === -1 ? undefined : option.slice(separatorIndex + 1);
-      if (!optionNames.has(rawName)) {
+      if (!options.strict && !optionNames.has(rawName)) {
         nextArgv.push(arg);
         continue;
       }
-      if (options.parser.booleanOptionNames.has(rawName)) {
+      if (booleanOptionNames.has(rawName)) {
         flags[rawName] = true;
         continue;
       }
       if (!options.parser.stringOptionNames.has(rawName)) {
+        if (options.strict) {
+          throw createUnknownOptionError(`--${rawName}`);
+        }
         nextArgv.push(arg);
         continue;
       }
@@ -567,6 +577,9 @@ function extractKnownOptionValuesFromArgv(argv, options) {
       index += 1;
       continue;
     }
+    if (arg.startsWith("-") && options.strict) {
+      throw createUnknownOptionError(arg);
+    }
     nextArgv.push(arg);
   }
   return {
@@ -574,83 +587,19 @@ function extractKnownOptionValuesFromArgv(argv, options) {
     flags
   };
 }
+function extractKnownOptionValuesFromArgv(argv, options) {
+  return walkArgvOptions(argv, {
+    optionNames: options.optionNames,
+    parser: options.parser,
+    strict: false
+  });
+}
 function parseCommandArgvWithMetadata(argv, options) {
-  const flags = {};
-  const positionals = [];
-  const booleanOptionNames = new Set(options.parser.booleanOptionNames);
-  for (const optionName of options.extraBooleanOptionNames ?? []) {
-    booleanOptionNames.add(optionName);
-  }
-  for (let index = 0;index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (!arg) {
-      continue;
-    }
-    if (arg === "--") {
-      positionals.push(...argv.slice(index + 1));
-      break;
-    }
-    if (arg.length === 2 && arg.startsWith("-")) {
-      const shortFlag = options.parser.shortFlagMap.get(arg.slice(1));
-      if (!shortFlag) {
-        throw createUnknownOptionError(arg);
-      }
-      if (shortFlag.type === "boolean") {
-        flags[shortFlag.name] = true;
-        continue;
-      }
-      const next = argv[index + 1];
-      if (!next || next.startsWith("-")) {
-        throw createMissingOptionValueError(arg);
-      }
-      assignParsedOptionValue(flags, {
-        name: shortFlag.name,
-        parser: options.parser,
-        value: next
-      });
-      index += 1;
-      continue;
-    }
-    if (arg.startsWith("--")) {
-      const option = arg.slice(2);
-      const separatorIndex = option.indexOf("=");
-      const rawName = separatorIndex === -1 ? option : option.slice(0, separatorIndex);
-      const inlineValue = separatorIndex === -1 ? undefined : option.slice(separatorIndex + 1);
-      if (booleanOptionNames.has(rawName)) {
-        flags[rawName] = true;
-        continue;
-      }
-      if (!options.parser.stringOptionNames.has(rawName)) {
-        throw createUnknownOptionError(`--${rawName}`);
-      }
-      if (inlineValue !== undefined) {
-        if (!inlineValue) {
-          throw createMissingOptionValueError(`--${rawName}`);
-        }
-        assignParsedOptionValue(flags, {
-          name: rawName,
-          parser: options.parser,
-          value: inlineValue
-        });
-        continue;
-      }
-      const next = argv[index + 1];
-      if (!next || next.startsWith("-")) {
-        throw createMissingOptionValueError(`--${rawName}`);
-      }
-      assignParsedOptionValue(flags, {
-        name: rawName,
-        parser: options.parser,
-        value: next
-      });
-      index += 1;
-      continue;
-    }
-    if (arg.startsWith("-")) {
-      throw createUnknownOptionError(arg);
-    }
-    positionals.push(arg);
-  }
+  const { argv: positionals, flags } = walkArgvOptions(argv, {
+    extraBooleanOptionNames: options.extraBooleanOptionNames,
+    parser: options.parser,
+    strict: true
+  });
   return {
     flags,
     positionals
@@ -1003,8 +952,8 @@ function extractWpTypiaConfigOverride(argv) {
 
 // src/runtime-bridge-add.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES9,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError8
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES10,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError9
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/add-kind-ids.ts
@@ -1035,6 +984,15 @@ var NAME_ONLY_VISIBLE_FIELDS = [
   "kind",
   "name"
 ];
+var PATTERN_CATALOG_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "scope",
+  "section-role",
+  "catalog-title",
+  "tags",
+  "thumbnail-url"
+];
 var NAME_SOURCE_VISIBLE_FIELDS = [
   "kind",
   "name",
@@ -1511,6 +1469,15 @@ import {
 } from "@wp-typia/project-tools/cli-diagnostics";
 var CORE_VARIATION_MISSING_NAME_MESSAGE = "`wp-typia add core-variation` requires <name>. Usage: wp-typia add core-variation <block-name> <name> or wp-typia add core-variation <name> --block <namespace/block>.";
 var CORE_VARIATION_MISSING_BLOCK_MESSAGE = "`wp-typia add core-variation` requires <block-name>. Usage: wp-typia add core-variation <block-name> <name> or wp-typia add core-variation <name> --block <namespace/block>.";
+var CORE_VARIATION_BLOCK_NAME_PATTERN = /^[^/\s]+\/[^/\s]+$/u;
+function formatCoreVariationMissingPositionalNameMessage(blockName) {
+  return [
+    `\`wp-typia add core-variation ${blockName}\` is missing <name>.`,
+    "Usage: wp-typia add core-variation <block-name> <name>",
+    "Alternative: wp-typia add core-variation <name> --block <namespace/block>"
+  ].join(`
+`);
+}
 function resolveCoreVariationInputs(context) {
   const positionalTargetBlockName = context.positionalArgs?.[1];
   const positionalVariationName = context.positionalArgs?.[2];
@@ -1523,16 +1490,17 @@ function resolveCoreVariationInputs(context) {
       variationName: positionalVariationName
     };
   }
-  if (context.name?.includes("/") && !readOptionalStrictStringFlag(context.flags, "block")) {
-    throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT, CORE_VARIATION_MISSING_NAME_MESSAGE);
+  const targetBlockFlag = readOptionalStrictStringFlag(context.flags, "block");
+  const missingPositionalNameTarget = context.name !== undefined && positionalTargetBlockName === context.name && CORE_VARIATION_BLOCK_NAME_PATTERN.test(context.name) ? context.name : undefined;
+  if (missingPositionalNameTarget && !targetBlockFlag) {
+    throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT, formatCoreVariationMissingPositionalNameMessage(missingPositionalNameTarget));
   }
   const variationName = requireAddKindName(context, CORE_VARIATION_MISSING_NAME_MESSAGE);
-  const targetBlockName = readOptionalStrictStringFlag(context.flags, "block");
-  if (!targetBlockName) {
+  if (!targetBlockFlag) {
     throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.MISSING_ARGUMENT, CORE_VARIATION_MISSING_BLOCK_MESSAGE);
   }
   return {
-    targetBlockName,
+    targetBlockName: targetBlockFlag,
     variationName
   };
 }
@@ -1711,10 +1679,15 @@ var integrationEnvAddKindEntry = defineAddKindRegistryEntry({
   supportsDryRun: true,
   usage: "wp-typia add integration-env <name> [--wp-env] [--release-zip] [--service <none|docker-compose>] [--dry-run]",
   visibleFieldNames: () => NAME_ONLY_VISIBLE_FIELDS,
-  hiddenBooleanSubmitFields: ["wp-env", "release-zip"]
+  hiddenBooleanSubmitFields: ["wp-env", "release-zip"],
+  hiddenStringSubmitFields: ["service"]
 });
 
 // src/add-kinds/pattern.ts
+import {
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES7,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError6
+} from "@wp-typia/project-tools/cli-diagnostics";
 var PATTERN_MISSING_NAME_MESSAGE = "`wp-typia add pattern` requires <name>. Usage: wp-typia add pattern <name>.";
 var patternAddKindEntry = defineAddKindRegistryEntry({
   completion: {
@@ -1730,19 +1703,12 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
     title: "Added workspace pattern"
   },
   description: "Add a PHP block pattern shell",
-  hiddenStringSubmitFields: [
-    "catalog-title",
-    "scope",
-    "section-role",
-    "tag",
-    "tags",
-    "thumbnail-url"
-  ],
+  hiddenStringSubmitFields: ["tag"],
   nameLabel: "Pattern name",
   async prepareExecution(context) {
     const name = requireAddKindName(context, PATTERN_MISSING_NAME_MESSAGE);
-    const scope = typeof context.flags.scope === "string" ? context.flags.scope : undefined;
-    const sectionRole = typeof context.flags["section-role"] === "string" ? context.flags["section-role"] : undefined;
+    const scope = resolvePatternScopeFlag(context);
+    const sectionRole = resolvePatternSectionRoleFlag(context, scope);
     const catalogTitle = typeof context.flags["catalog-title"] === "string" ? context.flags["catalog-title"] : undefined;
     const tags = normalizePatternTagFlags(context.flags.tags, context.flags.tag);
     const thumbnailUrl = typeof context.flags["thumbnail-url"] === "string" ? context.flags["thumbnail-url"] : undefined;
@@ -1767,9 +1733,42 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
   },
   sortOrder: 60,
   supportsDryRun: true,
-  usage: "wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--catalog-title <title>] [--tags <tag,...>|--tag <tag>...] [--thumbnail-url <url>] [--dry-run]",
-  visibleFieldNames: () => NAME_ONLY_VISIBLE_FIELDS
+  usage: "wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--catalog-title <title>] [--tags <tag,...>] [--tag <tag>...] [--thumbnail-url <url>] [--dry-run]",
+  visibleFieldNames: () => PATTERN_CATALOG_VISIBLE_FIELDS
 });
+function createInvalidPatternArgumentError(message) {
+  return createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.INVALID_ARGUMENT, message);
+}
+function createMissingPatternArgumentError(message) {
+  return createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT, message);
+}
+function resolvePatternScopeFlag(context) {
+  const scope = readOptionalLooseStringFlag(context.flags, "scope");
+  if (!scope) {
+    return;
+  }
+  if (context.addRuntime.PATTERN_CATALOG_SCOPE_IDS.includes(scope)) {
+    return scope;
+  }
+  throw createInvalidPatternArgumentError(`\`--scope\` must be one of: ${context.addRuntime.PATTERN_CATALOG_SCOPE_IDS.join(", ")}. Usage: wp-typia add pattern <name> --scope <full|section>.`);
+}
+function resolvePatternSectionRoleFlag(context, scope) {
+  const sectionRole = readOptionalLooseStringFlag(context.flags, "section-role");
+  if (scope === "section" && sectionRole === undefined) {
+    throw createMissingPatternArgumentError("`wp-typia add pattern --scope section` requires --section-role <role> because section-scoped patterns need a typed catalog section role.");
+  }
+  if (scope !== "section" && sectionRole !== undefined) {
+    throw createInvalidPatternArgumentError("`--section-role` only applies with `--scope section`. Use `--scope section --section-role <role>` or omit `--section-role` for full patterns.");
+  }
+  const normalizedSectionRole = sectionRole === undefined ? undefined : context.addRuntime.normalizeBlockSlug(sectionRole);
+  if (normalizedSectionRole && !context.addRuntime.PATTERN_SECTION_ROLE_PATTERN.test(normalizedSectionRole)) {
+    throw createInvalidPatternArgumentError("`--section-role` must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens. Section roles apply only with `--scope section`.");
+  }
+  if (sectionRole !== undefined && !normalizedSectionRole) {
+    throw createInvalidPatternArgumentError("`--section-role` must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens. Section roles apply only with `--scope section`.");
+  }
+  return normalizedSectionRole;
+}
 function collectStringFlagValues(value) {
   if (typeof value === "string") {
     return [value];
@@ -1784,13 +1783,7 @@ function normalizePatternTagFlags(tagsFlag, tagFlag) {
     ...collectStringFlagValues(tagsFlag),
     ...collectStringFlagValues(tagFlag)
   ];
-  if (tags.length === 0) {
-    return;
-  }
-  if (tags.length === 1) {
-    return tags[0];
-  }
-  return tags;
+  return tags.length > 0 ? tags : undefined;
 }
 
 // src/add-kinds/post-meta.ts
@@ -1856,8 +1849,8 @@ var postMetaAddKindEntry = defineAddKindRegistryEntry({
 
 // src/add-kinds/rest-resource.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES7,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError6
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES8,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError7
 } from "@wp-typia/project-tools/cli-diagnostics";
 var REST_RESOURCE_GENERATED_USAGE = "Generated: wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create,update,delete>] [--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--dry-run]";
 var REST_RESOURCE_MANUAL_USAGE = "Manual: wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>|--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--secret-field <field>] [--secret-state-field|--secret-has-value-field <field>] [--secret-preserve-on-empty <true|false>] [--dry-run]";
@@ -1880,11 +1873,11 @@ function readOptionalSecretPreserveOnEmptyFlag(flags) {
     return value;
   }
   if (typeof value !== "string") {
-    throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT, "`--secret-preserve-on-empty` requires a value.");
+    throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.MISSING_ARGUMENT, "`--secret-preserve-on-empty` requires a value.");
   }
   const normalized = value.trim().toLowerCase();
   if (normalized.length === 0) {
-    throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT, "`--secret-preserve-on-empty` requires a value.");
+    throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.MISSING_ARGUMENT, "`--secret-preserve-on-empty` requires a value.");
   }
   if (SECRET_PRESERVE_ON_EMPTY_TRUE_VALUES.has(normalized)) {
     return true;
@@ -1892,7 +1885,7 @@ function readOptionalSecretPreserveOnEmptyFlag(flags) {
   if (SECRET_PRESERVE_ON_EMPTY_FALSE_VALUES.has(normalized)) {
     return false;
   }
-  throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.INVALID_ARGUMENT, "Manual REST contract --secret-preserve-on-empty must be true or false.");
+  throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_ARGUMENT, "Manual REST contract --secret-preserve-on-empty must be true or false.");
 }
 var restResourceAddKindEntry = defineAddKindRegistryEntry({
   completion: {
@@ -2546,7 +2539,7 @@ function buildStructuredInitSuccessPayload(plan) {
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.24.1",
+  version: "0.24.3",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -2616,7 +2609,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.24.1",
+    "@wp-typia/project-tools": "0.24.3",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -2645,8 +2638,8 @@ import {
   parsePackageManagerField
 } from "@wp-typia/project-tools/package-managers";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES8,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError7
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES9,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError8
 } from "@wp-typia/project-tools/cli-diagnostics";
 var LOOSE_CREATE_COMPLETION_PACKAGE_MANAGER_PATTERN = new RegExp(`^(?:corepack\\s+)?(${PACKAGE_MANAGER_IDS.map(escapeRegExp).join("|")})(?=$|[@:/+\\s])`, "iu");
 function parseCreateCompletionPackageManager(packageManager) {
@@ -2664,7 +2657,7 @@ function resolveCreateCompletionPackageManager(packageManager) {
   if (parsedPackageManager) {
     return parsedPackageManager;
   }
-  throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_ARGUMENT, `Unsupported package manager "${packageManager}" in create completion payload. Expected one of: ${PACKAGE_MANAGER_IDS.join(", ")}.`);
+  throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_ARGUMENT, `Unsupported package manager "${packageManager}" in create completion payload. Expected one of: ${PACKAGE_MANAGER_IDS.join(", ")}.`);
 }
 function formatCreateProgressLine(payload, markerOptions) {
   return formatOutputMarker("progress", `${payload.title}: ${payload.detail}`, markerOptions);
@@ -2924,13 +2917,13 @@ async function executeAddCommand({
       if (shouldPrintMissingAddKindHelp({ emitOutput })) {
         printLine(addRuntime.formatAddHelpText());
       }
-      throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.MISSING_ARGUMENT, formatMissingAddKindDetailLine());
+      throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.MISSING_ARGUMENT, formatMissingAddKindDetailLine());
     }
     if (!isAddKindId(kind)) {
-      throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
+      throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
     }
     if (dryRun && !supportsAddKindDryRun(kind)) {
-      throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
+      throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
     }
     const executionContext = {
       addRuntime,
@@ -3184,8 +3177,8 @@ async function executeMigrateCommand({
 }
 // src/runtime-bridge-templates.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES10,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError9
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES11,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError10
 } from "@wp-typia/project-tools/cli-diagnostics";
 var loadCliTemplatesRuntime2 = () => import("@wp-typia/project-tools/cli-templates");
 async function executeTemplatesCommand({ flags }, printLine = console.log) {
@@ -3205,24 +3198,24 @@ async function executeTemplatesCommand({ flags }, printLine = console.log) {
   }
   if (subcommand === "inspect") {
     if (!flags.id) {
-      throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
+      throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
     }
     const template = getTemplateById(flags.id);
     if (!template) {
-      throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
+      throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
     }
     printBlock(printLine, [formatTemplateDetails(template)]);
     return;
   }
-  throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_COMMAND, `Unknown templates subcommand "${subcommand}". Expected list or inspect.`);
+  throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.INVALID_COMMAND, `Unknown templates subcommand "${subcommand}". Expected list or inspect.`);
 }
 // src/runtime-bridge-sync.ts
 import { spawnSync } from "node:child_process";
 import fs3 from "node:fs";
 import path4 from "node:path";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES11,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError10
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES12,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError11
 } from "@wp-typia/project-tools/cli-diagnostics";
 import {
   formatInstallCommand,
@@ -3243,10 +3236,10 @@ function resolveSyncExecutionTarget(subcommand) {
   if (subcommand === "ai") {
     return "ai";
   }
-  throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
+  throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
 }
 function getSyncRootError(cwd) {
-  return createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.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.`);
+  return createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.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 readSyncPackageJson(packageJsonPath) {
   const source = fs3.readFileSync(packageJsonPath, "utf8");
@@ -3254,7 +3247,7 @@ function readSyncPackageJson(packageJsonPath) {
     return JSON.parse(source);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.INVALID_ARGUMENT, `Unable to parse ${packageJsonPath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
+    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT, `Unable to parse ${packageJsonPath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
   }
 }
 function resolveSyncProjectContext(cwd) {
@@ -3321,7 +3314,7 @@ function assertSyncDependenciesInstalled(project, target) {
   if (markerDir) {
     return;
   }
-  throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.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 createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.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) {
@@ -3359,7 +3352,7 @@ function buildSyncPlannedCommands(project, extraArgs, target) {
   if (target === "ai") {
     const syncAiCommand2 = createSyncPlannedCommand(project, "sync-ai", extraArgs);
     if (!syncAiCommand2) {
-      throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
+      throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
     }
     return [syncAiCommand2];
   }
@@ -3368,7 +3361,7 @@ function buildSyncPlannedCommands(project, extraArgs, target) {
   }
   const syncTypesCommand = createSyncPlannedCommand(project, "sync-types", extraArgs);
   if (!syncTypesCommand) {
-    throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
+    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
   }
   const plannedCommands = [syncTypesCommand];
   const syncRestCommand = createSyncPlannedCommand(project, "sync-rest", extraArgs);
@@ -3392,7 +3385,7 @@ function runProjectScript(project, plannedCommand, options) {
   const stderr = options.captureOutput && typeof result.stderr === "string" ? result.stderr : undefined;
   const stdout = options.captureOutput && typeof result.stdout === "string" ? result.stdout : undefined;
   if (result.error || result.status !== 0) {
-    throw createCliDiagnosticCodeError10(CLI_DIAGNOSTIC_CODES11.COMMAND_EXECUTION, `\`${plannedCommand.displayCommand}\` failed.`, {
+    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.COMMAND_EXECUTION, `\`${plannedCommand.displayCommand}\` failed.`, {
       cause: result.error ?? (stderr ? new Error(stderr.trim()) : undefined)
     });
   }
@@ -3434,8 +3427,8 @@ async function executeSyncCommand({
 // src/command-contract.ts
 import path5 from "node:path";
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES12,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError11
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES13,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError12
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/command-registry.ts
@@ -3706,10 +3699,10 @@ function looksLikeStructuredProjectInput(value) {
 function assertPositionalAliasProjectDir(projectDir) {
   const normalizedProjectDir = path5.normalize(projectDir).replace(/[\\/]+$/u, "") || path5.normalize(projectDir);
   if (normalizedProjectDir === "." || normalizedProjectDir === "..") {
-    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT, `The positional alias does not scaffold into \`${projectDir}\`. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` with an explicit child directory instead.`);
+    throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES13.INVALID_ARGUMENT, `The positional alias does not scaffold into \`${projectDir}\`. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` with an explicit child directory instead.`);
   }
   if (looksLikeStructuredProjectInput(projectDir)) {
-    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT, `The positional alias only accepts unambiguous local project directories. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for \`${projectDir}\`.`);
+    throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES13.INVALID_ARGUMENT, `The positional alias only accepts unambiguous local project directories. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for \`${projectDir}\`.`);
   }
 }
 function normalizeWpTypiaArgv(argv) {
@@ -3723,7 +3716,7 @@ function normalizeWpTypiaArgv(argv) {
     return argv;
   }
   if (firstPositional === "migrations") {
-    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT, "`wp-typia migrations` was removed in favor of `wp-typia migrate`. Use `wp-typia migrate <subcommand>` instead.");
+    throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES13.INVALID_ARGUMENT, "`wp-typia migrations` was removed in favor of `wp-typia migrate`. Use `wp-typia migrate <subcommand>` instead.");
   }
   if (isReservedTopLevelCommandName(firstPositional)) {
     assertStringOptionValues(argv);
@@ -3731,7 +3724,7 @@ function normalizeWpTypiaArgv(argv) {
   }
   if (positionalIndexes.length > 1) {
     const extraPositionals = positionalIndexes.slice(1).map((index) => argv[index]).filter((value) => typeof value === "string" && value.length > 0);
-    throw createCliDiagnosticCodeError11(CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT, `The positional alias only accepts a single project directory. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for scaffold invocations with additional positional arguments, or check the command spelling if you meant another top-level command. Extra positional arguments: ${extraPositionals.map((value) => `\`${value}\``).join(", ")}.`);
+    throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES13.INVALID_ARGUMENT, `The positional alias only accepts a single project directory. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for scaffold invocations with additional positional arguments, or check the command spelling if you meant another top-level command. Extra positional arguments: ${extraPositionals.map((value) => `\`${value}\``).join(", ")}.`);
   }
   assertPositionalAliasProjectDir(firstPositional);
   const normalizedArgv = [
@@ -3745,7 +3738,7 @@ function normalizeWpTypiaArgv(argv) {
 
 // src/node-fallback/doctor.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES13,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES14,
   createCliCommandError as createCliCommandError2
 } from "@wp-typia/project-tools/cli-diagnostics";
 async function renderNodeFallbackDoctorJson(cwd, exitPolicy, printLine) {
@@ -3762,7 +3755,7 @@ async function renderNodeFallbackDoctorJson(cwd, exitPolicy, printLine) {
   }, null, 2));
   if (summary.exitCode === 1) {
     throw createCliCommandError2({
-      code: CLI_DIAGNOSTIC_CODES13.DOCTOR_CHECK_FAILED,
+      code: CLI_DIAGNOSTIC_CODES14.DOCTOR_CHECK_FAILED,
       command: "doctor",
       detailLines: getDoctorExitFailureDetailLines(checks, { exitPolicy }),
       summary: "One or more doctor checks failed."
@@ -3784,7 +3777,7 @@ async function dispatchNodeFallbackDoctor({
 
 // src/node-fallback/dispatchers/add.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES14,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES15,
   createCliCommandError as createCliCommandError3
 } from "@wp-typia/project-tools/cli-diagnostics";
 function resolveNodeFallbackAddName(positionals) {
@@ -3806,7 +3799,7 @@ async function dispatchNodeFallbackAdd({
       printLine(formatAddHelpText());
     }
     throw createCliCommandError3({
-      code: CLI_DIAGNOSTIC_CODES14.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES15.MISSING_ARGUMENT,
       command: "add",
       detailLines: buildMissingAddKindDetailLines()
     });
@@ -3856,7 +3849,7 @@ async function dispatchNodeFallbackAdd({
 
 // src/node-fallback/dispatchers/create.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES15,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES16,
   createCliCommandError as createCliCommandError4
 } from "@wp-typia/project-tools/cli-diagnostics";
 async function dispatchNodeFallbackCreate({
@@ -3869,7 +3862,7 @@ async function dispatchNodeFallbackCreate({
   const projectDir = positionals[1];
   if (!projectDir) {
     throw createCliCommandError4({
-      code: CLI_DIAGNOSTIC_CODES15.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES16.MISSING_ARGUMENT,
       command: "create",
       detailLines: buildMissingCreateProjectDirDetailLines()
     });
@@ -3902,7 +3895,7 @@ async function dispatchNodeFallbackCreate({
 
 // src/node-fallback/errors.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES16,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES17,
   createCliCommandError as createCliCommandError6,
   formatCliDiagnosticError,
   isCliDiagnosticError,
@@ -4020,18 +4013,18 @@ var NODE_FALLBACK_HELP_RENDERERS = Object.fromEntries(Object.entries(NODE_FALLBA
 // src/node-fallback/errors.ts
 function createNodeFallbackNoCommandCliError() {
   return createCliCommandError6({
-    code: CLI_DIAGNOSTIC_CODES16.INVALID_COMMAND,
+    code: CLI_DIAGNOSTIC_CODES17.INVALID_COMMAND,
     command: "wp-typia",
     detailLines: [NODE_FALLBACK_NO_COMMAND_REASON_LINE],
     summary: "No command was provided."
   });
 }
 function isNodeFallbackNoCommandCliDiagnostic(error) {
-  return isCliDiagnosticError(error) && error.code === CLI_DIAGNOSTIC_CODES16.INVALID_COMMAND && error.command === "wp-typia" && error.detailLines.includes(NODE_FALLBACK_NO_COMMAND_REASON_LINE);
+  return isCliDiagnosticError(error) && error.code === CLI_DIAGNOSTIC_CODES17.INVALID_COMMAND && error.command === "wp-typia" && error.detailLines.includes(NODE_FALLBACK_NO_COMMAND_REASON_LINE);
 }
 function throwUnsupportedNodeFallbackCommand(command) {
   throw createCliCommandError6({
-    code: CLI_DIAGNOSTIC_CODES16.UNSUPPORTED_COMMAND,
+    code: CLI_DIAGNOSTIC_CODES17.UNSUPPORTED_COMMAND,
     command,
     detailLines: [
       [
@@ -4067,7 +4060,7 @@ async function handleNodeFallbackEntrypointError(error, argv) {
 
 // src/node-fallback/templates.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES17,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES18,
   createCliCommandError as createCliCommandError7
 } from "@wp-typia/project-tools/cli-diagnostics";
 import {
@@ -4084,7 +4077,7 @@ function renderNodeFallbackTemplatesJson(printLine, flags, subcommand) {
   const templateId = flags.id;
   if (!templateId) {
     throw createCliCommandError7({
-      code: CLI_DIAGNOSTIC_CODES17.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES18.MISSING_ARGUMENT,
       command: "templates",
       detailLines: ["`wp-typia templates inspect` requires <template-id>."]
     });
@@ -4092,7 +4085,7 @@ function renderNodeFallbackTemplatesJson(printLine, flags, subcommand) {
   const template = getTemplateById(templateId);
   if (!template) {
     throw createCliCommandError7({
-      code: CLI_DIAGNOSTIC_CODES17.INVALID_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES18.INVALID_ARGUMENT,
       command: "templates",
       detailLines: [`Unknown template "${templateId}".`]
     });
@@ -4111,7 +4104,7 @@ async function dispatchNodeFallbackTemplates({
   const resolvedSubcommand = subcommand ?? (templateId ? "inspect" : "list");
   if (resolvedSubcommand !== "list" && resolvedSubcommand !== "inspect") {
     throw createCliCommandError7({
-      code: CLI_DIAGNOSTIC_CODES17.INVALID_COMMAND,
+      code: CLI_DIAGNOSTIC_CODES18.INVALID_COMMAND,
       command: "templates",
       detailLines: [
         `Unknown templates subcommand "${resolvedSubcommand}". Expected list or inspect.`
@@ -4369,4 +4362,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=9C14F1C0B8D6AB4264756E2164756E21
+//# debugId=5AEE5FBC0C6CEA8264756E2164756E21