wp-typia 0.22.0 → 0.22.2

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.0",
+  version: "0.22.2",
   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.0",
+    "@wp-typia/project-tools": "0.22.2",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -98,10 +98,10 @@ var package_default = {
 // src/node-cli.ts
 import {
   CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES5,
-  createCliCommandError,
+  createCliCommandError as createCliCommandError2,
   createCliDiagnosticCodeError as createCliDiagnosticCodeError5,
   formatCliDiagnosticError,
-  serializeCliDiagnosticError
+  serializeCliDiagnosticError as serializeCliDiagnosticError2
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/command-option-metadata.ts
@@ -316,6 +316,12 @@ var MIGRATE_OPTION_METADATA = {
     type: "string"
   }
 };
+var MCP_OPTION_METADATA = {
+  "output-dir": {
+    description: "Output directory for generated MCP metadata.",
+    type: "string"
+  }
+};
 var SYNC_OPTION_METADATA = {
   check: {
     argumentKind: "flag",
@@ -353,10 +359,6 @@ var GLOBAL_OPTION_METADATA = {
   id: {
     description: "Template id for top-level `templates inspect` convenience.",
     type: "string"
-  },
-  "output-dir": {
-    description: "Output directory for generated MCP metadata.",
-    type: "string"
   }
 };
 var COMMAND_OPTION_METADATA_BY_GROUP = {
@@ -366,6 +368,7 @@ var COMMAND_OPTION_METADATA_BY_GROUP = {
   global: GLOBAL_OPTION_METADATA,
   init: INIT_OPTION_METADATA,
   migrate: MIGRATE_OPTION_METADATA,
+  mcp: MCP_OPTION_METADATA,
   sync: SYNC_OPTION_METADATA,
   templates: TEMPLATES_OPTION_METADATA
 };
@@ -575,6 +578,73 @@ function resolveCommandOptionValues(metadata, options) {
   return resolved;
 }
 
+// src/cli-diagnostic-output.ts
+import {
+  createCliCommandError,
+  serializeCliDiagnosticError
+} from "@wp-typia/project-tools/cli-diagnostics";
+
+// 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;
+}
+
+// src/cli-diagnostic-output.ts
+function prefersStructuredCliArgv(argv) {
+  for (let index = 0;index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
+    if (arg === "--") {
+      return false;
+    }
+    if (arg === "--format") {
+      return argv[index + 1] === "json";
+    }
+    if (arg.startsWith("--format=")) {
+      return arg.slice("--format=".length) === "json";
+    }
+  }
+  return false;
+}
+
 // src/node-cli.ts
 import {
   getTemplateById,
@@ -586,6 +656,24 @@ import {
   CLI_DIAGNOSTIC_CODES,
   createCliDiagnosticCodeError
 } from "@wp-typia/project-tools/cli-diagnostics";
+
+// src/add-kind-ids.ts
+var ADD_KIND_IDS = [
+  "admin-view",
+  "block",
+  "variation",
+  "style",
+  "transform",
+  "pattern",
+  "binding-source",
+  "rest-resource",
+  "ability",
+  "ai-feature",
+  "hooked-block",
+  "editor-plugin"
+];
+
+// src/add-kind-registry.ts
 var BLOCK_VISIBLE_FIELD_ORDER = [
   "kind",
   "name",
@@ -595,6 +683,54 @@ var BLOCK_VISIBLE_FIELD_ORDER = [
   "data-storage",
   "persistence-policy"
 ];
+var NAME_ONLY_VISIBLE_FIELDS = [
+  "kind",
+  "name"
+];
+var NAME_SOURCE_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "source"
+];
+var NAME_BLOCK_ATTRIBUTE_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "block",
+  "attribute"
+];
+var NAME_BLOCK_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "block"
+];
+var NAME_SLOT_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "slot"
+];
+var NAME_ANCHOR_POSITION_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "anchor",
+  "position"
+];
+var NAME_FROM_TO_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "from",
+  "to"
+];
+var NAME_NAMESPACE_METHODS_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "namespace",
+  "methods"
+];
+var NAME_NAMESPACE_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "namespace"
+];
 function readOptionalStringFlag(flags, name) {
   const value = flags[name];
   if (value === undefined || value === null) {
@@ -605,6 +741,21 @@ function readOptionalStringFlag(flags, name) {
   }
   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);
@@ -628,6 +779,15 @@ function toExternalLayerPromptOptions(options) {
 function defineAddKindRegistryEntry(entry) {
   return entry;
 }
+function createNamedExecutionPlan(context, options) {
+  const name = options.name ?? requireAddKindName(context, options.missingNameMessage);
+  return {
+    execute: (cwd) => options.execute({ cwd, name }),
+    getValues: options.getValues,
+    ...options.getWarnings ? { getWarnings: options.getWarnings } : {},
+    ...options.warnLine ? { warnLine: options.warnLine } : {}
+  };
+}
 function isAddPersistenceTemplate(template) {
   return template === "persistence" || template === "compound";
 }
@@ -650,22 +810,24 @@ var ADD_KIND_REGISTRY = {
     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");
-      return {
-        execute: (cwd) => context.addRuntime.runAddAdminViewCommand({
-          adminViewName: name,
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name: name2 }) => context.addRuntime.runAddAdminViewCommand({
+          adminViewName: name2,
           cwd,
           source
         }),
         getValues: (result) => ({
           adminViewSlug: result.adminViewSlug,
           ...result.source ? { source: result.source } : {}
-        })
-      };
+        }),
+        missingNameMessage: "`wp-typia add admin-view` requires <name>. Usage: wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>].",
+        name
+      });
     },
     sortOrder: 10,
     supportsDryRun: true,
     usage: "wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>] [--dry-run]",
-    visibleFieldNames: () => ["kind", "name", "source"]
+    visibleFieldNames: () => NAME_SOURCE_VISIBLE_FIELDS
   }),
   "binding-source": defineAddKindRegistryEntry({
     completion: {
@@ -687,15 +849,11 @@ 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 = readOptionalStringFlag(context.flags, "block");
-      const attributeName = readOptionalStringFlag(context.flags, "attribute");
-      if (Boolean(blockName) !== Boolean(attributeName)) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, "`wp-typia add binding-source` requires --block and --attribute to be provided together.");
-      }
-      return {
-        execute: (cwd) => context.addRuntime.runAddBindingSourceCommand({
+      const [blockName, attributeName] = readOptionalPairedStringFlags(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,
-          bindingSourceName: name,
+          bindingSourceName: name2,
           blockName,
           cwd
         }),
@@ -703,13 +861,15 @@ var ADD_KIND_REGISTRY = {
           ...result.attributeName ? { attributeName: result.attributeName } : {},
           ...result.blockSlug ? { blockSlug: result.blockSlug } : {},
           bindingSourceSlug: result.bindingSourceSlug
-        })
-      };
+        }),
+        missingNameMessage: "`wp-typia add binding-source` requires <name>. Usage: wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>].",
+        name
+      });
     },
     sortOrder: 70,
     supportsDryRun: true,
     usage: "wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--dry-run]",
-    visibleFieldNames: () => ["kind", "name", "block", "attribute"]
+    visibleFieldNames: () => NAME_BLOCK_ATTRIBUTE_VISIBLE_FIELDS
   }),
   block: defineAddKindRegistryEntry({
     completion: {
@@ -747,10 +907,10 @@ var ADD_KIND_REGISTRY = {
         })), 1);
       }
       resolvedTemplateId ??= "basic";
-      return {
-        execute: (cwd) => context.addRuntime.runAddBlockCommand({
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBlockCommand({
           alternateRenderTargets,
-          blockName: name,
+          blockName: name2,
           cwd,
           dataStorageMode,
           externalLayerId,
@@ -765,8 +925,10 @@ var ADD_KIND_REGISTRY = {
           templateId: result.templateId
         }),
         getWarnings: (result) => result.warnings,
+        missingNameMessage: "`wp-typia add block` requires <name>. Usage: wp-typia add block <name> [--template <basic|interactivity|persistence|compound>]",
+        name,
         warnLine: context.warnLine
-      };
+      });
     },
     sortOrder: 20,
     supportsDryRun: true,
@@ -799,21 +961,21 @@ var ADD_KIND_REGISTRY = {
     description: "Add a typed server/client workflow ability scaffold",
     nameLabel: "Ability name",
     async prepareExecution(context) {
-      const name = requireAddKindName(context, "`wp-typia add ability` requires <name>. Usage: wp-typia add ability <name>.");
-      return {
-        execute: (cwd) => context.addRuntime.runAddAbilityCommand({
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name }) => context.addRuntime.runAddAbilityCommand({
           abilityName: name,
           cwd
         }),
         getValues: (result) => ({
           abilitySlug: result.abilitySlug
-        })
-      };
+        }),
+        missingNameMessage: "`wp-typia add ability` requires <name>. Usage: wp-typia add ability <name>."
+      });
     },
     sortOrder: 90,
     supportsDryRun: true,
     usage: "wp-typia add ability <name> [--dry-run]",
-    visibleFieldNames: () => ["kind", "name"]
+    visibleFieldNames: () => NAME_ONLY_VISIBLE_FIELDS
   }),
   "editor-plugin": defineAddKindRegistryEntry({
     completion: {
@@ -833,22 +995,24 @@ var ADD_KIND_REGISTRY = {
     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");
-      return {
-        execute: (cwd) => context.addRuntime.runAddEditorPluginCommand({
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name: name2 }) => context.addRuntime.runAddEditorPluginCommand({
           cwd,
-          editorPluginName: name,
+          editorPluginName: name2,
           slot
         }),
         getValues: (result) => ({
           editorPluginSlug: result.editorPluginSlug,
           slot: result.slot
-        })
-      };
+        }),
+        missingNameMessage: "`wp-typia add editor-plugin` requires <name>. Usage: wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>].",
+        name
+      });
     },
     sortOrder: 120,
     supportsDryRun: true,
     usage: "wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>] [--dry-run]",
-    visibleFieldNames: () => ["kind", "name", "slot"]
+    visibleFieldNames: () => NAME_SLOT_VISIBLE_FIELDS
   }),
   "hooked-block": defineAddKindRegistryEntry({
     completion: {
@@ -868,18 +1032,12 @@ 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 = readOptionalStringFlag(context.flags, "anchor");
-      if (!anchorBlockName) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, "`wp-typia add hooked-block` requires --anchor <anchor-block-name>.");
-      }
-      const position = readOptionalStringFlag(context.flags, "position");
-      if (!position) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, "`wp-typia add hooked-block` requires --position <before|after|firstChild|lastChild>.");
-      }
-      return {
-        execute: (cwd) => context.addRuntime.runAddHookedBlockCommand({
+      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>.");
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name: name2 }) => context.addRuntime.runAddHookedBlockCommand({
           anchorBlockName,
-          blockName: name,
+          blockName: name2,
           cwd,
           position
         }),
@@ -887,13 +1045,15 @@ var ADD_KIND_REGISTRY = {
           anchorBlockName: result.anchorBlockName,
           blockSlug: result.blockSlug,
           position: result.position
-        })
-      };
+        }),
+        missingNameMessage: "`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>.",
+        name
+      });
     },
     sortOrder: 110,
     supportsDryRun: true,
     usage: "wp-typia add hooked-block <block-slug> --anchor <anchor-block-name> --position <before|after|firstChild|lastChild> [--dry-run]",
-    visibleFieldNames: () => ["kind", "name", "anchor", "position"]
+    visibleFieldNames: () => NAME_ANCHOR_POSITION_VISIBLE_FIELDS
   }),
   pattern: defineAddKindRegistryEntry({
     completion: {
@@ -910,21 +1070,21 @@ var ADD_KIND_REGISTRY = {
     description: "Add a PHP block pattern shell",
     nameLabel: "Pattern name",
     async prepareExecution(context) {
-      const name = requireAddKindName(context, "`wp-typia add pattern` requires <name>. Usage: wp-typia add pattern <name>.");
-      return {
-        execute: (cwd) => context.addRuntime.runAddPatternCommand({
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name }) => context.addRuntime.runAddPatternCommand({
           cwd,
           patternName: name
         }),
         getValues: (result) => ({
           patternSlug: result.patternSlug
-        })
-      };
+        }),
+        missingNameMessage: "`wp-typia add pattern` requires <name>. Usage: wp-typia add pattern <name>."
+      });
     },
     sortOrder: 60,
     supportsDryRun: true,
     usage: "wp-typia add pattern <name> [--dry-run]",
-    visibleFieldNames: () => ["kind", "name"]
+    visibleFieldNames: () => NAME_ONLY_VISIBLE_FIELDS
   }),
   style: defineAddKindRegistryEntry({
     completion: {
@@ -943,26 +1103,25 @@ 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 = readOptionalStringFlag(context.flags, "block");
-      if (!blockSlug) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, "`wp-typia add style` requires --block <block-slug>.");
-      }
-      return {
-        execute: (cwd) => context.addRuntime.runAddBlockStyleCommand({
+      const blockSlug = requireStringFlag(context.flags, "block", "`wp-typia add style` requires --block <block-slug>.");
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBlockStyleCommand({
           blockName: blockSlug,
           cwd,
-          styleName: name
+          styleName: name2
         }),
         getValues: (result) => ({
           blockSlug: result.blockSlug,
           styleSlug: result.styleSlug
-        })
-      };
+        }),
+        missingNameMessage: "`wp-typia add style` requires <name>. Usage: wp-typia add style <name> --block <block-slug>.",
+        name
+      });
     },
     sortOrder: 40,
     supportsDryRun: true,
     usage: "wp-typia add style <name> --block <block-slug> [--dry-run]",
-    visibleFieldNames: () => ["kind", "name", "block"]
+    visibleFieldNames: () => NAME_BLOCK_VISIBLE_FIELDS
   }),
   transform: defineAddKindRegistryEntry({
     completion: {
@@ -982,33 +1141,29 @@ 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 = readOptionalStringFlag(context.flags, "from");
-      if (!fromBlockName) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, "`wp-typia add transform` requires --from <namespace/block>.");
-      }
-      const toBlockName = readOptionalStringFlag(context.flags, "to");
-      if (!toBlockName) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, "`wp-typia add transform` requires --to <block-slug|namespace/block-slug>.");
-      }
-      return {
-        execute: (cwd) => context.addRuntime.runAddBlockTransformCommand({
+      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>.");
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBlockTransformCommand({
           cwd,
           fromBlockName,
           toBlockName,
-          transformName: name
+          transformName: name2
         }),
         getValues: (result) => ({
           blockSlug: result.blockSlug,
           fromBlockName: result.fromBlockName,
           toBlockName: result.toBlockName,
           transformSlug: result.transformSlug
-        })
-      };
+        }),
+        missingNameMessage: "`wp-typia add transform` requires <name>. Usage: wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug>.",
+        name
+      });
     },
     sortOrder: 50,
     supportsDryRun: true,
     usage: "wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug> [--dry-run]",
-    visibleFieldNames: () => ["kind", "name", "from", "to"]
+    visibleFieldNames: () => NAME_FROM_TO_VISIBLE_FIELDS
   }),
   "rest-resource": defineAddKindRegistryEntry({
     completion: {
@@ -1030,24 +1185,26 @@ var ADD_KIND_REGISTRY = {
       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");
-      return {
-        execute: (cwd) => context.addRuntime.runAddRestResourceCommand({
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name: name2 }) => context.addRuntime.runAddRestResourceCommand({
           cwd,
           methods,
           namespace,
-          restResourceName: name
+          restResourceName: name2
         }),
         getValues: (result) => ({
           methods: result.methods.join(", "),
           namespace: result.namespace,
           restResourceSlug: result.restResourceSlug
-        })
-      };
+        }),
+        missingNameMessage: "`wp-typia add rest-resource` requires <name>. Usage: wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create>].",
+        name
+      });
     },
     sortOrder: 80,
     supportsDryRun: true,
     usage: "wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create,update,delete>] [--dry-run]",
-    visibleFieldNames: () => ["kind", "name", "namespace", "methods"]
+    visibleFieldNames: () => NAME_NAMESPACE_METHODS_VISIBLE_FIELDS
   }),
   "ai-feature": defineAddKindRegistryEntry({
     completion: {
@@ -1067,9 +1224,9 @@ var ADD_KIND_REGISTRY = {
     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");
-      return {
-        execute: (cwd) => context.addRuntime.runAddAiFeatureCommand({
-          aiFeatureName: name,
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name: name2 }) => context.addRuntime.runAddAiFeatureCommand({
+          aiFeatureName: name2,
           cwd,
           namespace
         }),
@@ -1078,13 +1235,15 @@ var ADD_KIND_REGISTRY = {
           namespace: result.namespace
         }),
         getWarnings: (result) => result.warnings,
+        missingNameMessage: "`wp-typia add ai-feature` requires <name>. Usage: wp-typia add ai-feature <name> [--namespace <vendor/v1>].",
+        name,
         warnLine: context.warnLine
-      };
+      });
     },
     sortOrder: 100,
     supportsDryRun: true,
     usage: "wp-typia add ai-feature <name> [--namespace <vendor/v1>] [--dry-run]",
-    visibleFieldNames: () => ["kind", "name", "namespace"]
+    visibleFieldNames: () => NAME_NAMESPACE_VISIBLE_FIELDS
   }),
   variation: defineAddKindRegistryEntry({
     completion: {
@@ -1103,29 +1262,27 @@ 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 = readOptionalStringFlag(context.flags, "block");
-      if (!blockSlug) {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, "`wp-typia add variation` requires --block <block-slug>.");
-      }
-      return {
-        execute: (cwd) => context.addRuntime.runAddVariationCommand({
+      const blockSlug = requireStringFlag(context.flags, "block", "`wp-typia add variation` requires --block <block-slug>.");
+      return createNamedExecutionPlan(context, {
+        execute: ({ cwd, name: name2 }) => context.addRuntime.runAddVariationCommand({
           blockName: blockSlug,
           cwd,
-          variationName: name
+          variationName: name2
         }),
         getValues: (result) => ({
           blockSlug: result.blockSlug,
           variationSlug: result.variationSlug
-        })
-      };
+        }),
+        missingNameMessage: "`wp-typia add variation` requires <name>. Usage: wp-typia add variation <name> --block <block-slug>",
+        name
+      });
     },
     sortOrder: 30,
     supportsDryRun: true,
     usage: "wp-typia add variation <name> --block <block-slug> [--dry-run]",
-    visibleFieldNames: () => ["kind", "name", "block"]
+    visibleFieldNames: () => NAME_BLOCK_VISIBLE_FIELDS
   })
 };
-var ADD_KIND_IDS = Object.keys(ADD_KIND_REGISTRY).sort((left, right) => ADD_KIND_REGISTRY[left].sortOrder - ADD_KIND_REGISTRY[right].sortOrder);
 function isAddKindId(value) {
   return typeof value === "string" && ADD_KIND_IDS.includes(value);
 }
@@ -1528,15 +1685,7 @@ function buildStructuredCompletionSuccessPayload(command, completion, metadata =
       command,
       ...serializedCompletion ? {
         completion: serializedCompletion,
-        files: extractPlannedFiles(serializedCompletion),
-        nextSteps: serializedCompletion.nextSteps,
-        optionalLines: serializedCompletion.optionalLines,
-        optionalNote: serializedCompletion.optionalNote,
-        optionalTitle: serializedCompletion.optionalTitle,
-        preambleLines: serializedCompletion.preambleLines,
-        summaryLines: serializedCompletion.summaryLines,
-        title: serializedCompletion.title,
-        warnings: serializedCompletion.warningLines
+        files: extractPlannedFiles(serializedCompletion)
       } : {}
     }
   };
@@ -1555,14 +1704,11 @@ function buildStructuredInitSuccessPayload(plan) {
       detectedLayout: plan.detectedLayout,
       files: toNonEmptyArray(files),
       mode: plan.commandMode === "apply" ? "apply" : "preview",
-      nextSteps: toNonEmptyArray(plan.nextSteps),
       packageManager: plan.packageManager,
       plan,
       projectDir: plan.projectDir,
       status: plan.status,
-      summary: plan.summary,
-      title: completion.title,
-      warnings: toNonEmptyArray(plan.notes)
+      summary: plan.summary
     }
   };
 }
@@ -2008,8 +2154,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 } = await loadCliDiagnosticsRuntime();
-  return createCliCommandError({ command, error });
+  const { createCliCommandError: createCliCommandError2 } = await loadCliDiagnosticsRuntime();
+  return createCliCommandError2({ command, error });
 }
 function shouldWrapCliCommandError(options) {
   if (options.emitOutput === false) {
@@ -2382,47 +2528,6 @@ async function executeMigrateCommand({
 // src/command-contract.ts
 import path5 from "node:path";
 
-// 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;
-}
-
 // src/command-registry.ts
 var WP_TYPIA_CANONICAL_CREATE_USAGE = "wp-typia create <project-dir>";
 var WP_TYPIA_POSITIONAL_ALIAS_USAGE = "wp-typia <project-dir>";
@@ -2462,17 +2567,7 @@ var WP_TYPIA_COMMAND_REGISTRY = [
     nodeFallback: true,
     optionGroups: ["add"],
     requiresBunRuntime: false,
-    subcommands: [
-      "block",
-      "variation",
-      "style",
-      "transform",
-      "pattern",
-      "binding-source",
-      "rest-resource",
-      "editor-plugin",
-      "hooked-block"
-    ]
+    subcommands: ADD_KIND_IDS
   },
   {
     commandTree: true,
@@ -2517,7 +2612,7 @@ var WP_TYPIA_COMMAND_REGISTRY = [
     description: "Inspect or sync schema-driven MCP metadata.",
     name: "mcp",
     nodeFallback: false,
-    optionGroups: [],
+    optionGroups: ["mcp"],
     requiresBunRuntime: true,
     subcommands: ["list", "sync"]
   },
@@ -2891,7 +2986,7 @@ function renderTemplatesJson(flags, subcommand) {
   }
   const templateId = flags.id;
   if (!templateId) {
-    throw createCliCommandError({
+    throw createCliCommandError2({
       code: CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT,
       command: "templates",
       detailLines: ["`wp-typia templates inspect` requires <template-id>."]
@@ -2899,7 +2994,7 @@ function renderTemplatesJson(flags, subcommand) {
   }
   const template = getTemplateById(templateId);
   if (!template) {
-    throw createCliCommandError({
+    throw createCliCommandError2({
       code: CLI_DIAGNOSTIC_CODES5.INVALID_ARGUMENT,
       command: "templates",
       detailLines: [`Unknown template "${templateId}".`]
@@ -2910,7 +3005,7 @@ function renderTemplatesJson(flags, subcommand) {
   }, null, 2));
 }
 function renderUnsupportedCommand(command) {
-  throw createCliCommandError({
+  throw createCliCommandError2({
     code: CLI_DIAGNOSTIC_CODES5.UNSUPPORTED_COMMAND,
     command,
     detailLines: [
@@ -2926,7 +3021,7 @@ function renderUnsupportedCommand(command) {
 async function renderDoctorJson() {
   const [
     { getDoctorChecks },
-    { createCliCommandError: createCliCommandError2, getDoctorFailureDetailLines }
+    { createCliCommandError: createCliCommandError3, getDoctorFailureDetailLines }
   ] = await Promise.all([
     import("@wp-typia/project-tools/cli-doctor"),
     import("@wp-typia/project-tools/cli-diagnostics")
@@ -2936,7 +3031,7 @@ async function renderDoctorJson() {
     checks
   }, null, 2));
   if (checks.some((check) => check.status === "fail")) {
-    throw createCliCommandError2({
+    throw createCliCommandError3({
       code: CLI_DIAGNOSTIC_CODES5.DOCTOR_CHECK_FAILED,
       command: "doctor",
       detailLines: getDoctorFailureDetailLines(checks),
@@ -2953,7 +3048,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
     if (!positionals[1]) {
       const { formatAddHelpText } = await import("@wp-typia/project-tools/cli-add");
       printLine(formatAddHelpText());
-      throw createCliCommandError({
+      throw createCliCommandError2({
         code: CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT,
         command: "add",
         detailLines: [
@@ -2973,7 +3068,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
           name: positionals[2]
         });
       } catch (error) {
-        throw createCliCommandError({
+        throw createCliCommandError2({
           command: "add",
           error
         });
@@ -3001,7 +3096,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
   }) => {
     const projectDir = positionals[1];
     if (!projectDir) {
-      throw createCliCommandError({
+      throw createCliCommandError2({
         code: CLI_DIAGNOSTIC_CODES5.MISSING_ARGUMENT,
         command: "create",
         detailLines: [
@@ -3020,7 +3115,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
         projectDir
       });
     } catch (error) {
-      throw createCliCommandError({
+      throw createCliCommandError2({
         command: "create",
         error
       });
@@ -3098,7 +3193,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
         }));
       }
     } catch (error) {
-      throw createCliCommandError({
+      throw createCliCommandError2({
         command: "sync",
         error
       });
@@ -3112,7 +3207,7 @@ 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 createCliCommandError({
+      throw createCliCommandError2({
         code: CLI_DIAGNOSTIC_CODES5.INVALID_COMMAND,
         command: "templates",
         detailLines: [
@@ -3185,21 +3280,16 @@ async function runNodeCli(argv = process.argv.slice(2)) {
   renderUnsupportedCommand(command ?? "(missing)");
 }
 async function runNodeCliEntrypoint(argv = process.argv.slice(2)) {
+  const prefersStructuredErrorOutput = prefersStructuredCliArgv(argv);
   try {
     await runNodeCli(argv);
   } catch (error) {
-    let prefersStructuredErrorOutput = false;
-    try {
-      const normalizedArgv = normalizeWpTypiaArgv(argv);
-      const { argv: argvWithoutConfigOverride } = extractWpTypiaConfigOverride(normalizedArgv);
-      const { flags } = parseGlobalFlags(argvWithoutConfigOverride);
-      prefersStructuredErrorOutput = flags.format === "json";
-    } catch {}
     if (prefersStructuredErrorOutput) {
-      console.error(JSON.stringify({
+      process.stderr.write(`${JSON.stringify({
         ok: false,
-        error: serializeCliDiagnosticError(error)
-      }, null, 2));
+        error: serializeCliDiagnosticError2(error)
+      }, null, 2)}
+`);
       process.exitCode = 1;
       return;
     }
@@ -3214,4 +3304,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=9D8430CB181D13B964756E2164756E21
+//# debugId=F8B7C97D684FB07764756E2164756E21