wp-typia 0.22.9 → 0.23.0

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.9",
+  version: "0.23.0",
   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.9",
+    "@wp-typia/project-tools": "0.23.0",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -97,9 +97,10 @@ var package_default = {
 
 // src/node-cli.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES12,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES13,
   createCliCommandError as createCliCommandError5,
   formatCliDiagnosticError,
+  isCliDiagnosticError,
   serializeCliDiagnosticError as serializeCliDiagnosticError2
 } from "@wp-typia/project-tools/cli-diagnostics";
 
@@ -109,6 +110,163 @@ import {
   CLI_DIAGNOSTIC_CODES,
   createCliDiagnosticCodeError
 } from "@wp-typia/project-tools/cli-diagnostics";
+
+// src/command-options/add.ts
+var ADD_OPTION_METADATA = {
+  "alternate-render-targets": {
+    description: "Comma-separated alternate render targets for dynamic block scaffolds (email,mjml,plain-text).",
+    type: "string"
+  },
+  anchor: {
+    description: "Anchor block name for hooked-block workflows.",
+    type: "string"
+  },
+  attribute: {
+    description: "Target block attribute for end-to-end binding-source workflows.",
+    type: "string"
+  },
+  auth: {
+    description: "Auth intent for manual REST contract workflows (public, authenticated, or public-write-protected).",
+    type: "string"
+  },
+  block: {
+    description: "Target block slug for variation, style, and end-to-end binding-source workflows.",
+    type: "string"
+  },
+  "controller-class": {
+    description: "Generated REST resource controller class used for route callbacks.",
+    type: "string"
+  },
+  "controller-extends": {
+    description: "Optional base class for generated REST resource controller wrappers.",
+    type: "string"
+  },
+  "data-storage": {
+    description: "Persistence storage mode for persistence-capable templates.",
+    type: "string"
+  },
+  "dry-run": {
+    argumentKind: "flag",
+    description: "Preview workspace file updates and completion guidance without writing them.",
+    type: "boolean"
+  },
+  "external-layer-id": {
+    description: "Explicit layer id when an external layer package exposes multiple selectable layers.",
+    type: "string"
+  },
+  "external-layer-source": {
+    description: "Local path, GitHub locator, or npm package that exposes wp-typia.layers.json for built-in block templates.",
+    type: "string"
+  },
+  from: {
+    description: "Source full block name (namespace/block) for transform workflows.",
+    type: "string"
+  },
+  "inner-blocks-preset": {
+    description: "Compound-only InnerBlocks preset (freeform, ordered, horizontal, locked-structure).",
+    type: "string"
+  },
+  manual: {
+    argumentKind: "flag",
+    description: "Create a type-only manual REST contract without PHP route/controller files.",
+    type: "boolean"
+  },
+  "hide-from-rest": {
+    argumentKind: "flag",
+    description: "Keep a generated post-meta contract out of WordPress REST/editor responses.",
+    type: "boolean"
+  },
+  "meta-key": {
+    description: "WordPress meta key for post-meta workflows; defaults to _<phpPrefix>_<name>.",
+    type: "string"
+  },
+  method: {
+    description: "HTTP method for manual REST contract workflows (GET, POST, PUT, PATCH, or DELETE).",
+    type: "string"
+  },
+  methods: {
+    description: "Comma-separated REST resource methods for rest-resource workflows.",
+    type: "string"
+  },
+  namespace: {
+    description: "REST namespace for rest-resource and ai-feature workflows.",
+    type: "string"
+  },
+  "permission-callback": {
+    description: "PHP permission callback for generated REST resource route registrations.",
+    type: "string"
+  },
+  "post-type": {
+    description: "WordPress post type key for post-meta workflows.",
+    type: "string"
+  },
+  "persistence-policy": {
+    description: "Persistence write policy for persistence-capable templates.",
+    type: "string"
+  },
+  path: {
+    description: "Route path pattern for manual REST contract workflows, relative to the REST namespace.",
+    type: "string"
+  },
+  position: {
+    description: "Hook position for hooked-block workflows.",
+    type: "string"
+  },
+  "query-type": {
+    description: "Exported TypeScript query type for manual REST contract workflows.",
+    type: "string"
+  },
+  "response-type": {
+    description: "Exported TypeScript response type for manual REST contract workflows.",
+    type: "string"
+  },
+  "route-pattern": {
+    description: "Generated REST resource item route pattern relative to the REST namespace.",
+    type: "string"
+  },
+  "secret-field": {
+    description: "Write-only request body field for manual settings REST contracts.",
+    type: "string"
+  },
+  "secret-state-field": {
+    description: "Masked response boolean field for --secret-field; defaults to has<SecretField>.",
+    type: "string"
+  },
+  service: {
+    description: "Optional local service starter for integration-env workflows (none or docker-compose).",
+    type: "string"
+  },
+  slot: {
+    description: "Document editor shell slot for editor-plugin workflows (sidebar or document-setting-panel).",
+    type: "string"
+  },
+  source: {
+    description: "Optional data source locator for admin-view workflows, such as rest-resource:products or core-data:postType/post.",
+    type: "string"
+  },
+  template: {
+    description: "Optional built-in block family for the new block; interactive flows let you choose it when omitted and non-interactive runs default to basic.",
+    type: "string"
+  },
+  type: {
+    description: "Exported TypeScript type or interface name for standalone contract workflows.",
+    type: "string"
+  },
+  "body-type": {
+    description: "Exported TypeScript body type for manual REST contract workflows.",
+    type: "string"
+  },
+  to: {
+    description: "Target workspace block slug or full block name for transform workflows.",
+    type: "string"
+  },
+  "wp-env": {
+    argumentKind: "flag",
+    description: "Add a local @wordpress/env preset for integration-env workflows.",
+    type: "boolean"
+  }
+};
+// src/command-options/create.ts
 var CREATE_OPTION_METADATA = {
   "alternate-render-targets": {
     description: "Comma-separated alternate render targets for dynamic block scaffolds (email,mjml,plain-text).",
@@ -196,81 +354,30 @@ var CREATE_OPTION_METADATA = {
     type: "boolean"
   }
 };
-var ADD_OPTION_METADATA = {
-  "alternate-render-targets": {
-    description: "Comma-separated alternate render targets for dynamic block scaffolds (email,mjml,plain-text).",
-    type: "string"
-  },
-  anchor: {
-    description: "Anchor block name for hooked-block workflows.",
-    type: "string"
-  },
-  attribute: {
-    description: "Target block attribute for end-to-end binding-source workflows.",
-    type: "string"
-  },
-  block: {
-    description: "Target block slug for variation, style, and end-to-end binding-source workflows.",
-    type: "string"
-  },
-  "data-storage": {
-    description: "Persistence storage mode for persistence-capable templates.",
-    type: "string"
-  },
-  "dry-run": {
-    argumentKind: "flag",
-    description: "Preview workspace file updates and completion guidance without writing them.",
-    type: "boolean"
-  },
-  "external-layer-id": {
-    description: "Explicit layer id when an external layer package exposes multiple selectable layers.",
-    type: "string"
-  },
-  "external-layer-source": {
-    description: "Local path, GitHub locator, or npm package that exposes wp-typia.layers.json for built-in block templates.",
-    type: "string"
-  },
-  from: {
-    description: "Source full block name (namespace/block) for transform workflows.",
-    type: "string"
-  },
-  "inner-blocks-preset": {
-    description: "Compound-only InnerBlocks preset (freeform, ordered, horizontal, locked-structure).",
-    type: "string"
-  },
-  methods: {
-    description: "Comma-separated REST resource methods for rest-resource workflows.",
-    type: "string"
-  },
-  namespace: {
-    description: "REST namespace for rest-resource and ai-feature workflows.",
-    type: "string"
-  },
-  "persistence-policy": {
-    description: "Persistence write policy for persistence-capable templates.",
-    type: "string"
-  },
-  position: {
-    description: "Hook position for hooked-block workflows.",
-    type: "string"
-  },
-  slot: {
-    description: "Document editor shell slot for editor-plugin workflows (sidebar or document-setting-panel).",
+// src/command-options/doctor.ts
+var DOCTOR_OPTION_METADATA = {
+  format: {
+    description: "Use `json` for machine-readable doctor check output or `text` for human-readable output.",
     type: "string"
-  },
-  source: {
-    description: "Optional data source locator for admin-view workflows, such as rest-resource:products or core-data:postType/post.",
+  }
+};
+// src/command-options/global.ts
+var GLOBAL_OPTION_METADATA = {
+  config: {
+    description: "Config override file path.",
+    short: "c",
     type: "string"
   },
-  template: {
-    description: "Optional built-in block family for the new block; interactive flows let you choose it when omitted and non-interactive runs default to basic.",
+  format: {
+    description: "Output format for supported commands (`json` or `text`).",
     type: "string"
   },
-  to: {
-    description: "Target workspace block slug or full block name for transform workflows.",
+  id: {
+    description: "Template id for top-level `templates inspect` convenience.",
     type: "string"
   }
 };
+// src/command-options/init.ts
 var INIT_OPTION_METADATA = {
   apply: {
     argumentKind: "flag",
@@ -283,6 +390,14 @@ var INIT_OPTION_METADATA = {
     type: "string"
   }
 };
+// src/command-options/mcp.ts
+var MCP_OPTION_METADATA = {
+  "output-dir": {
+    description: "Output directory for generated MCP metadata.",
+    type: "string"
+  }
+};
+// src/command-options/migrate.ts
 var MIGRATE_OPTION_METADATA = {
   all: {
     argumentKind: "flag",
@@ -319,12 +434,7 @@ var MIGRATE_OPTION_METADATA = {
     type: "string"
   }
 };
-var MCP_OPTION_METADATA = {
-  "output-dir": {
-    description: "Output directory for generated MCP metadata.",
-    type: "string"
-  }
-};
+// src/command-options/sync.ts
 var SYNC_OPTION_METADATA = {
   check: {
     argumentKind: "flag",
@@ -337,33 +447,14 @@ var SYNC_OPTION_METADATA = {
     type: "boolean"
   }
 };
-var DOCTOR_OPTION_METADATA = {
-  format: {
-    description: "Use `json` for machine-readable doctor check output or `text` for human-readable output.",
-    type: "string"
-  }
-};
+// src/command-options/templates.ts
 var TEMPLATES_OPTION_METADATA = {
   id: {
     description: "Template id for `templates inspect`.",
     type: "string"
   }
 };
-var GLOBAL_OPTION_METADATA = {
-  config: {
-    description: "Config override file path.",
-    short: "c",
-    type: "string"
-  },
-  format: {
-    description: "Output format for supported commands (`json` or `text`).",
-    type: "string"
-  },
-  id: {
-    description: "Template id for top-level `templates inspect` convenience.",
-    type: "string"
-  }
-};
+// src/command-option-metadata.ts
 var COMMAND_OPTION_METADATA_BY_GROUP = {
   add: ADD_OPTION_METADATA,
   create: CREATE_OPTION_METADATA,
@@ -927,14 +1018,21 @@ function extractWpTypiaConfigOverride(argv) {
   };
 }
 
-// src/runtime-bridge.ts
+// src/runtime-bridge-add.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES8,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError7
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES7,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError6
 } from "@wp-typia/project-tools/cli-diagnostics";
 
 // src/add-kind-ids.ts
 import { ADD_KIND_IDS } from "@wp-typia/project-tools/cli-add-kind-ids";
+import { ADD_KIND_IDS as ADD_KIND_IDS2 } from "@wp-typia/project-tools/cli-add-kind-ids";
+function formatAddKindList() {
+  return ADD_KIND_IDS.join(", ");
+}
+function formatAddKindUsagePlaceholder() {
+  return `<${ADD_KIND_IDS.join("|")}>`;
+}
 
 // src/add-kind-registry-shared.ts
 import {
@@ -959,6 +1057,11 @@ var NAME_SOURCE_VISIBLE_FIELDS = [
   "name",
   "source"
 ];
+var NAME_TYPE_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "type"
+];
 var NAME_BLOCK_ATTRIBUTE_VISIBLE_FIELDS = [
   "kind",
   "name",
@@ -998,6 +1101,12 @@ var NAME_NAMESPACE_VISIBLE_FIELDS = [
   "name",
   "namespace"
 ];
+var NAME_POST_TYPE_TYPE_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "post-type",
+  "type"
+];
 function requireAddKindName(context, message) {
   if (!context.name) {
     throw createCliDiagnosticCodeError3(CLI_DIAGNOSTIC_CODES4.MISSING_ARGUMENT, message);
@@ -1044,6 +1153,7 @@ function assertAddBlockTemplateId(context, templateId) {
 }
 
 // src/add-kinds/ability.ts
+var ABILITY_MISSING_NAME_MESSAGE = "`wp-typia add ability` requires <name>. Usage: wp-typia add ability <name>.";
 var abilityAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1068,7 +1178,7 @@ var abilityAddKindEntry = defineAddKindRegistryEntry({
         abilitySlug: result.abilitySlug
       }),
       getWarnings: (result) => result.warnings,
-      missingNameMessage: "`wp-typia add ability` requires <name>. Usage: wp-typia add ability <name>.",
+      missingNameMessage: ABILITY_MISSING_NAME_MESSAGE,
       warnLine: context.warnLine
     });
   },
@@ -1106,6 +1216,9 @@ function readOptionalLooseStringFlag(flags, name) {
 function readOptionalStrictStringFlag(flags, name) {
   return readOptionalCliStringFlagValue(flags, name, "strict");
 }
+function readOptionalDashedOrCamelStringFlag(flags, dashedName, camelName) {
+  return readOptionalStrictStringFlag(flags, dashedName) ?? readOptionalStrictStringFlag(flags, camelName);
+}
 function requireStrictStringFlag(flags, name, message) {
   const value = readOptionalStrictStringFlag(flags, name);
   if (!value) {
@@ -1123,6 +1236,7 @@ function readOptionalPairedStrictStringFlags(flags, leftName, rightName, message
 }
 
 // src/add-kinds/admin-view.ts
+var ADMIN_VIEW_MISSING_NAME_MESSAGE = "`wp-typia add admin-view` requires <name>. Usage: wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>].";
 var adminViewAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1139,7 +1253,7 @@ var adminViewAddKindEntry = defineAddKindRegistryEntry({
   description: "Add an opt-in DataViews-powered admin screen",
   nameLabel: "Admin view name",
   async prepareExecution(context) {
-    const name = requireAddKindName(context, "`wp-typia add admin-view` requires <name>. Usage: wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>].");
+    const name = requireAddKindName(context, ADMIN_VIEW_MISSING_NAME_MESSAGE);
     const source = readOptionalStrictStringFlag(context.flags, "source");
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddAdminViewCommand({
@@ -1151,8 +1265,9 @@ var adminViewAddKindEntry = defineAddKindRegistryEntry({
         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
+      missingNameMessage: ADMIN_VIEW_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 10,
@@ -1162,6 +1277,7 @@ var adminViewAddKindEntry = defineAddKindRegistryEntry({
 });
 
 // src/add-kinds/ai-feature.ts
+var AI_FEATURE_MISSING_NAME_MESSAGE = "`wp-typia add ai-feature` requires <name>. Usage: wp-typia add ai-feature <name> [--namespace <vendor/v1>].";
 var aiFeatureAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1178,7 +1294,7 @@ var aiFeatureAddKindEntry = defineAddKindRegistryEntry({
   description: "Add a server-owned WordPress AI feature endpoint",
   nameLabel: "AI feature name",
   async prepareExecution(context) {
-    const name = requireAddKindName(context, "`wp-typia add ai-feature` requires <name>. Usage: wp-typia add ai-feature <name> [--namespace <vendor/v1>].");
+    const name = requireAddKindName(context, AI_FEATURE_MISSING_NAME_MESSAGE);
     const namespace = readOptionalStrictStringFlag(context.flags, "namespace");
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddAiFeatureCommand({
@@ -1191,7 +1307,7 @@ var aiFeatureAddKindEntry = defineAddKindRegistryEntry({
         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>].",
+      missingNameMessage: AI_FEATURE_MISSING_NAME_MESSAGE,
       name,
       warnLine: context.warnLine
     });
@@ -1203,6 +1319,7 @@ var aiFeatureAddKindEntry = defineAddKindRegistryEntry({
 });
 
 // src/add-kinds/binding-source.ts
+var BINDING_SOURCE_MISSING_NAME_MESSAGE = "`wp-typia add binding-source` requires <name>. Usage: wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>].";
 var bindingSourceAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1222,7 +1339,7 @@ var bindingSourceAddKindEntry = defineAddKindRegistryEntry({
   description: "Add a shared block bindings source",
   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 name = requireAddKindName(context, BINDING_SOURCE_MISSING_NAME_MESSAGE);
     const [blockName, attributeName] = readOptionalPairedStrictStringFlags(context.flags, "block", "attribute", "`wp-typia add binding-source` requires --block and --attribute to be provided together.");
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBindingSourceCommand({
@@ -1236,8 +1353,9 @@ var bindingSourceAddKindEntry = defineAddKindRegistryEntry({
         ...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
+      missingNameMessage: BINDING_SOURCE_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 70,
@@ -1263,6 +1381,7 @@ function toExternalLayerPromptOptions(options) {
 }
 
 // src/add-kinds/block.ts
+var BLOCK_MISSING_NAME_MESSAGE = "`wp-typia add block` requires <name>. Usage: wp-typia add block <name> [--template <basic|interactivity|persistence|compound>]";
 var blockAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: () => [
@@ -1280,7 +1399,7 @@ var blockAddKindEntry = defineAddKindRegistryEntry({
   hiddenStringSubmitFields: ["external-layer-id", "external-layer-source"],
   nameLabel: "Block name",
   async prepareExecution(context) {
-    const name = requireAddKindName(context, "`wp-typia add block` requires <name>. Usage: wp-typia add block <name> [--template <basic|interactivity|persistence|compound>]");
+    const name = requireAddKindName(context, BLOCK_MISSING_NAME_MESSAGE);
     const externalLayerId = readOptionalStrictStringFlag(context.flags, "external-layer-id");
     const externalLayerSource = readOptionalStrictStringFlag(context.flags, "external-layer-source");
     const shouldPromptForLayerSelection = Boolean(externalLayerSource) && !Boolean(externalLayerId) && context.isInteractiveSession;
@@ -1318,7 +1437,7 @@ var blockAddKindEntry = defineAddKindRegistryEntry({
         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>]",
+      missingNameMessage: BLOCK_MISSING_NAME_MESSAGE,
       name,
       warnLine: context.warnLine
     });
@@ -1340,11 +1459,56 @@ var blockAddKindEntry = defineAddKindRegistryEntry({
   })
 });
 
-// src/add-kinds/editor-plugin.ts
-var editorPluginAddKindEntry = defineAddKindRegistryEntry({
+// src/add-kinds/contract.ts
+var CONTRACT_MISSING_NAME_MESSAGE = "`wp-typia add contract` requires <name>. Usage: wp-typia add contract <name> [--type <ExportedTypeName>].";
+var contractAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
-      `Review src/editor-plugins/${values.editorPluginSlug}/.`,
+      `Edit ${values.typesFile} when the standalone wire shape changes.`,
+      "Run `wp-typia sync-rest` or `wp-typia sync` to refresh the generated schema artifact."
+    ],
+    summaryLines: (values, projectDir) => [
+      `Contract: ${values.contractSlug}`,
+      `Source type: ${values.sourceTypeName}`,
+      `Schema: ${values.schemaFile}`,
+      `Project directory: ${projectDir}`
+    ],
+    title: "Added standalone contract"
+  },
+  description: "Add a standalone TypeScript schema contract",
+  nameLabel: "Contract name",
+  async prepareExecution(context) {
+    const name = requireAddKindName(context, CONTRACT_MISSING_NAME_MESSAGE);
+    const typeName = readOptionalStrictStringFlag(context.flags, "type");
+    return createNamedExecutionPlan(context, {
+      execute: ({ cwd, name: name2 }) => context.addRuntime.runAddContractCommand({
+        contractName: name2,
+        cwd,
+        typeName
+      }),
+      getValues: (result) => ({
+        contractSlug: result.contractSlug,
+        schemaFile: result.schemaFile,
+        sourceTypeName: result.sourceTypeName,
+        typesFile: result.typesFile
+      }),
+      missingNameMessage: CONTRACT_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
+    });
+  },
+  sortOrder: 75,
+  supportsDryRun: true,
+  usage: "wp-typia add contract <name> [--type <ExportedTypeName>] [--dry-run]",
+  visibleFieldNames: () => NAME_TYPE_VISIBLE_FIELDS
+});
+
+// src/add-kinds/editor-plugin.ts
+var EDITOR_PLUGIN_MISSING_NAME_MESSAGE = "`wp-typia add editor-plugin` requires <name>. Usage: wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>].";
+var editorPluginAddKindEntry = defineAddKindRegistryEntry({
+  completion: {
+    nextSteps: (values) => [
+      `Review src/editor-plugins/${values.editorPluginSlug}/.`,
       "Run your workspace build or dev command to verify the new editor plugin registration."
     ],
     summaryLines: (values, projectDir) => [
@@ -1357,7 +1521,7 @@ var editorPluginAddKindEntry = defineAddKindRegistryEntry({
   description: "Add a slot-aware document editor extension shell",
   nameLabel: "Editor plugin name",
   async prepareExecution(context) {
-    const name = requireAddKindName(context, "`wp-typia add editor-plugin` requires <name>. Usage: wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>].");
+    const name = requireAddKindName(context, EDITOR_PLUGIN_MISSING_NAME_MESSAGE);
     const slot = readOptionalStrictStringFlag(context.flags, "slot");
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddEditorPluginCommand({
@@ -1369,8 +1533,9 @@ var editorPluginAddKindEntry = defineAddKindRegistryEntry({
         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
+      missingNameMessage: EDITOR_PLUGIN_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 120,
@@ -1380,6 +1545,7 @@ var editorPluginAddKindEntry = defineAddKindRegistryEntry({
 });
 
 // src/add-kinds/hooked-block.ts
+var HOOKED_BLOCK_MISSING_NAME_MESSAGE = "`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>.";
 var hookedBlockAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1397,7 +1563,7 @@ var hookedBlockAddKindEntry = defineAddKindRegistryEntry({
   description: "Add block.json hook metadata to an existing block",
   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 name = requireAddKindName(context, HOOKED_BLOCK_MISSING_NAME_MESSAGE);
     const anchorBlockName = requireStrictStringFlag(context.flags, "anchor", "`wp-typia add hooked-block` requires --anchor <anchor-block-name>.");
     const position = requireStrictStringFlag(context.flags, "position", "`wp-typia add hooked-block` requires --position <before|after|firstChild|lastChild>.");
     return createNamedExecutionPlan(context, {
@@ -1412,8 +1578,9 @@ var hookedBlockAddKindEntry = defineAddKindRegistryEntry({
         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
+      missingNameMessage: HOOKED_BLOCK_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 110,
@@ -1422,7 +1589,53 @@ var hookedBlockAddKindEntry = defineAddKindRegistryEntry({
   visibleFieldNames: () => NAME_ANCHOR_POSITION_VISIBLE_FIELDS
 });
 
+// src/add-kinds/integration-env.ts
+var INTEGRATION_ENV_MISSING_NAME_MESSAGE = "`wp-typia add integration-env` requires <name>. Usage: wp-typia add integration-env <name> [--wp-env] [--service <none|docker-compose>].";
+var integrationEnvAddKindEntry = defineAddKindRegistryEntry({
+  completion: {
+    nextSteps: (values) => [
+      `Review scripts/integration-smoke/${values.integrationEnvSlug}.mjs and docs/integration-env/${values.integrationEnvSlug}.md.`,
+      "Copy `.env.example` to `.env`, adjust local URLs or credentials, then run the generated smoke script.",
+      ...values.withWpEnv === "true" ? ["Run `npm run wp-env:start` before the smoke check when using the generated wp-env preset."] : []
+    ],
+    summaryLines: (values, projectDir) => [
+      `Integration env: ${values.integrationEnvSlug}`,
+      `wp-env preset: ${values.withWpEnv}`,
+      `Service starter: ${values.service}`,
+      `Project directory: ${projectDir}`
+    ],
+    title: "Added integration environment starter"
+  },
+  description: "Add an opt-in local WordPress integration smoke environment starter",
+  nameLabel: "Integration env name",
+  async prepareExecution(context) {
+    const service = readOptionalStrictStringFlag(context.flags, "service");
+    const withWpEnv = Boolean(context.flags["wp-env"]);
+    return createNamedExecutionPlan(context, {
+      execute: ({ cwd, name }) => context.addRuntime.runAddIntegrationEnvCommand({
+        cwd,
+        integrationEnvName: name,
+        service,
+        withWpEnv
+      }),
+      getValues: (result) => ({
+        integrationEnvSlug: result.integrationEnvSlug,
+        service: result.service,
+        withWpEnv: String(result.withWpEnv)
+      }),
+      getWarnings: (result) => result.warnings,
+      missingNameMessage: INTEGRATION_ENV_MISSING_NAME_MESSAGE,
+      warnLine: context.warnLine
+    });
+  },
+  sortOrder: 25,
+  supportsDryRun: true,
+  usage: "wp-typia add integration-env <name> [--wp-env] [--service <none|docker-compose>] [--dry-run]",
+  visibleFieldNames: () => NAME_ONLY_VISIBLE_FIELDS
+});
+
 // src/add-kinds/pattern.ts
+var PATTERN_MISSING_NAME_MESSAGE = "`wp-typia add pattern` requires <name>. Usage: wp-typia add pattern <name>.";
 var patternAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1446,7 +1659,8 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
       getValues: (result) => ({
         patternSlug: result.patternSlug
       }),
-      missingNameMessage: "`wp-typia add pattern` requires <name>. Usage: wp-typia add pattern <name>."
+      missingNameMessage: PATTERN_MISSING_NAME_MESSAGE,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 60,
@@ -1455,50 +1669,182 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
   visibleFieldNames: () => NAME_ONLY_VISIBLE_FIELDS
 });
 
+// src/add-kinds/post-meta.ts
+var POST_META_MISSING_NAME_MESSAGE = "`wp-typia add post-meta` requires <name>. Usage: wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>].";
+var POST_META_MISSING_POST_TYPE_MESSAGE = "`wp-typia add post-meta` requires --post-type <post-type>. Usage: wp-typia add post-meta <name> --post-type <post-type>.";
+var postMetaAddKindEntry = defineAddKindRegistryEntry({
+  completion: {
+    nextSteps: (values) => [
+      `Edit ${values.typesFile} when the post meta shape changes.`,
+      "Run `wp-typia sync-rest --check` to verify the generated meta schema is current.",
+      `Smoke test ${values.metaKey} on the ${values.postType} post type in WordPress.`
+    ],
+    summaryLines: (values, projectDir) => [
+      `Post meta contract: ${values.postMetaSlug}`,
+      `Post type: ${values.postType}`,
+      `Meta key: ${values.metaKey}`,
+      `REST/editor exposure: ${values.showInRest}`,
+      `Schema: ${values.schemaFile}`,
+      `PHP: ${values.phpFile}`,
+      `Project directory: ${projectDir}`
+    ],
+    title: "Added post meta contract"
+  },
+  description: "Add a typed WordPress post meta contract",
+  hiddenBooleanSubmitFields: ["hide-from-rest"],
+  hiddenStringSubmitFields: ["meta-key"],
+  nameLabel: "Post meta name",
+  async prepareExecution(context) {
+    const name = requireAddKindName(context, POST_META_MISSING_NAME_MESSAGE);
+    const hideFromRest = Boolean(context.flags["hide-from-rest"] ?? context.flags.hideFromRest);
+    const metaKey = readOptionalDashedOrCamelStringFlag(context.flags, "meta-key", "metaKey");
+    const postType = readOptionalDashedOrCamelStringFlag(context.flags, "post-type", "postType") ?? requireStrictStringFlag(context.flags, "post-type", POST_META_MISSING_POST_TYPE_MESSAGE);
+    const typeName = readOptionalStrictStringFlag(context.flags, "type");
+    return createNamedExecutionPlan(context, {
+      execute: ({ cwd, name: name2 }) => context.addRuntime.runAddPostMetaCommand({
+        cwd,
+        hideFromRest,
+        metaKey,
+        postMetaName: name2,
+        postType,
+        typeName
+      }),
+      getValues: (result) => ({
+        metaKey: result.metaKey,
+        phpFile: result.phpFile,
+        postMetaSlug: result.postMetaSlug,
+        postType: result.postType,
+        schemaFile: result.schemaFile,
+        showInRest: result.showInRest ? "enabled" : "disabled",
+        sourceTypeName: result.sourceTypeName,
+        typesFile: result.typesFile
+      }),
+      missingNameMessage: POST_META_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
+    });
+  },
+  sortOrder: 85,
+  supportsDryRun: true,
+  usage: "wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>] [--hide-from-rest] [--dry-run]",
+  visibleFieldNames: () => NAME_POST_TYPE_TYPE_VISIBLE_FIELDS
+});
+
 // src/add-kinds/rest-resource.ts
+var REST_RESOURCE_MISSING_NAME_MESSAGE = "`wp-typia add rest-resource` requires <name>. Usage: wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create,update,delete>] or wp-typia add rest-resource <name> --manual [--method GET] [--path /external].";
+function readOptionalDashedOrCamelStringFlag2(flags, dashedName, camelName) {
+  return readOptionalStrictStringFlag(flags, dashedName) ?? readOptionalStrictStringFlag(flags, camelName);
+}
 var restResourceAddKindEntry = defineAddKindRegistryEntry({
   completion: {
-    nextSteps: (values) => [
+    nextSteps: (values) => values.mode === "manual" ? [
+      `Review src/rest/${values.restResourceSlug}/ and edit the manual contract types to match the external route owner.`,
+      "Run sync-rest --check after changing the contract types to verify schemas, OpenAPI, and client artifacts."
+    ] : [
       `Review src/rest/${values.restResourceSlug}/ and inc/rest/${values.restResourceSlug}.php.`,
       "Run your workspace build or dev command to verify the generated REST resource contract."
     ],
     summaryLines: (values, projectDir) => [
       `REST resource: ${values.restResourceSlug}`,
+      `Mode: ${values.mode}`,
       `Namespace: ${values.namespace}`,
-      `Methods: ${values.methods}`,
+      ...values.mode === "manual" ? [
+        `Route: ${values.method} /${values.namespace}${values.pathPattern}`,
+        `Auth: ${values.auth}`,
+        ...values.secretFieldName ? [
+          `Secret field: ${values.secretFieldName} -> ${values.secretStateFieldName}`
+        ] : []
+      ] : [
+        `Methods: ${values.methods}`,
+        ...values.routePattern ? [`Item route: /${values.namespace}${values.routePattern}`] : [],
+        ...values.permissionCallback ? [`Permission callback: ${values.permissionCallback}`] : [],
+        ...values.controllerClass ? [`Controller class: ${values.controllerClass}`] : []
+      ],
       `Project directory: ${projectDir}`
     ],
-    title: "Added plugin-level REST resource"
-  },
-  description: "Add a plugin-level typed REST resource",
+    title: "Added REST resource contract"
+  },
+  description: "Add a generated or type-only REST resource contract",
+  hiddenBooleanSubmitFields: ["manual"],
+  hiddenStringSubmitFields: [
+    "auth",
+    "body-type",
+    "controller-class",
+    "controller-extends",
+    "method",
+    "path",
+    "permission-callback",
+    "query-type",
+    "response-type",
+    "route-pattern",
+    "secret-field",
+    "secret-state-field"
+  ],
   nameLabel: "REST resource name",
   async prepareExecution(context) {
-    const name = requireAddKindName(context, "`wp-typia add rest-resource` requires <name>. Usage: wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create,update,delete>].");
+    const name = requireAddKindName(context, REST_RESOURCE_MISSING_NAME_MESSAGE);
+    const auth = readOptionalStrictStringFlag(context.flags, "auth");
+    const bodyTypeName = readOptionalStrictStringFlag(context.flags, "body-type");
+    const controllerClass = readOptionalDashedOrCamelStringFlag2(context.flags, "controller-class", "controllerClass");
+    const controllerExtends = readOptionalDashedOrCamelStringFlag2(context.flags, "controller-extends", "controllerExtends");
+    const manual = Boolean(context.flags.manual);
+    const method = readOptionalStrictStringFlag(context.flags, "method");
     const methods = readOptionalStrictStringFlag(context.flags, "methods");
     const namespace = readOptionalStrictStringFlag(context.flags, "namespace");
+    const permissionCallback = readOptionalDashedOrCamelStringFlag2(context.flags, "permission-callback", "permissionCallback");
+    const pathPattern = readOptionalStrictStringFlag(context.flags, "path");
+    const queryTypeName = readOptionalStrictStringFlag(context.flags, "query-type");
+    const responseTypeName = readOptionalStrictStringFlag(context.flags, "response-type");
+    const routePattern = readOptionalDashedOrCamelStringFlag2(context.flags, "route-pattern", "routePattern");
+    const secretFieldName = readOptionalDashedOrCamelStringFlag2(context.flags, "secret-field", "secretField");
+    const secretStateFieldName = readOptionalDashedOrCamelStringFlag2(context.flags, "secret-state-field", "secretStateField");
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddRestResourceCommand({
+        auth,
+        bodyTypeName,
+        controllerClass,
+        controllerExtends,
         cwd,
+        manual,
+        method,
         methods,
         namespace,
-        restResourceName: name2
+        permissionCallback,
+        pathPattern,
+        queryTypeName,
+        restResourceName: name2,
+        responseTypeName,
+        routePattern,
+        secretFieldName,
+        secretStateFieldName
       }),
       getValues: (result) => ({
+        auth: result.auth ?? "",
+        controllerClass: result.controllerClass ?? "",
+        method: result.method ?? "",
         methods: result.methods.join(", "),
+        mode: result.mode,
         namespace: result.namespace,
-        restResourceSlug: result.restResourceSlug
+        pathPattern: result.pathPattern ?? "",
+        permissionCallback: result.permissionCallback ?? "",
+        restResourceSlug: result.restResourceSlug,
+        routePattern: result.routePattern ?? "",
+        secretFieldName: result.secretFieldName ?? "",
+        secretStateFieldName: result.secretStateFieldName ?? ""
       }),
-      missingNameMessage: "`wp-typia add rest-resource` requires <name>. Usage: wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create,update,delete>].",
-      name
+      missingNameMessage: REST_RESOURCE_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 80,
   supportsDryRun: true,
-  usage: "wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <list,read,create,update,delete>] [--dry-run]",
+  usage: "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>] [--manual --method <GET|POST|PUT|PATCH|DELETE> --auth <public|authenticated|public-write-protected> --path <route-pattern> --query-type <Type> --body-type <Type> --response-type <Type> --secret-field <field> --secret-state-field <field>] [--dry-run]",
   visibleFieldNames: () => NAME_NAMESPACE_METHODS_VISIBLE_FIELDS
 });
 
 // src/add-kinds/style.ts
+var STYLE_MISSING_NAME_MESSAGE = "`wp-typia add style` requires <name>. Usage: wp-typia add style <name> --block <block-slug>.";
 var styleAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1515,7 +1861,7 @@ var styleAddKindEntry = defineAddKindRegistryEntry({
   description: "Add a Block Styles registration to an existing block",
   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 name = requireAddKindName(context, STYLE_MISSING_NAME_MESSAGE);
     const blockSlug = requireStrictStringFlag(context.flags, "block", "`wp-typia add style` requires --block <block-slug>.");
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddBlockStyleCommand({
@@ -1527,8 +1873,9 @@ var styleAddKindEntry = defineAddKindRegistryEntry({
         blockSlug: result.blockSlug,
         styleSlug: result.styleSlug
       }),
-      missingNameMessage: "`wp-typia add style` requires <name>. Usage: wp-typia add style <name> --block <block-slug>.",
-      name
+      missingNameMessage: STYLE_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 40,
@@ -1538,6 +1885,7 @@ var styleAddKindEntry = defineAddKindRegistryEntry({
 });
 
 // src/add-kinds/transform.ts
+var TRANSFORM_MISSING_NAME_MESSAGE = "`wp-typia add transform` requires <name>. Usage: wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug>.";
 var transformAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1555,7 +1903,7 @@ var transformAddKindEntry = defineAddKindRegistryEntry({
   description: "Add a block-to-block transform into a workspace block",
   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 name = requireAddKindName(context, TRANSFORM_MISSING_NAME_MESSAGE);
     const fromBlockName = requireStrictStringFlag(context.flags, "from", "`wp-typia add transform` requires --from <namespace/block>.");
     const toBlockName = requireStrictStringFlag(context.flags, "to", "`wp-typia add transform` requires --to <block-slug|namespace/block-slug>.");
     return createNamedExecutionPlan(context, {
@@ -1571,8 +1919,9 @@ var transformAddKindEntry = defineAddKindRegistryEntry({
         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
+      missingNameMessage: TRANSFORM_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 50,
@@ -1582,6 +1931,7 @@ var transformAddKindEntry = defineAddKindRegistryEntry({
 });
 
 // src/add-kinds/variation.ts
+var VARIATION_MISSING_NAME_MESSAGE = "`wp-typia add variation` requires <name>. Usage: wp-typia add variation <name> --block <block-slug>";
 var variationAddKindEntry = defineAddKindRegistryEntry({
   completion: {
     nextSteps: (values) => [
@@ -1598,7 +1948,7 @@ var variationAddKindEntry = defineAddKindRegistryEntry({
   description: "Add a variation to an existing block",
   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 name = requireAddKindName(context, VARIATION_MISSING_NAME_MESSAGE);
     const blockSlug = requireStrictStringFlag(context.flags, "block", "`wp-typia add variation` requires --block <block-slug>.");
     return createNamedExecutionPlan(context, {
       execute: ({ cwd, name: name2 }) => context.addRuntime.runAddVariationCommand({
@@ -1610,8 +1960,9 @@ var variationAddKindEntry = defineAddKindRegistryEntry({
         blockSlug: result.blockSlug,
         variationSlug: result.variationSlug
       }),
-      missingNameMessage: "`wp-typia add variation` requires <name>. Usage: wp-typia add variation <name> --block <block-slug>",
-      name
+      missingNameMessage: VARIATION_MISSING_NAME_MESSAGE,
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 30,
@@ -1624,19 +1975,22 @@ var variationAddKindEntry = defineAddKindRegistryEntry({
 var ADD_KIND_REGISTRY = {
   "admin-view": adminViewAddKindEntry,
   block: blockAddKindEntry,
+  "integration-env": integrationEnvAddKindEntry,
   variation: variationAddKindEntry,
   style: styleAddKindEntry,
   transform: transformAddKindEntry,
   pattern: patternAddKindEntry,
   "binding-source": bindingSourceAddKindEntry,
+  contract: contractAddKindEntry,
   "rest-resource": restResourceAddKindEntry,
+  "post-meta": postMetaAddKindEntry,
   ability: abilityAddKindEntry,
   "ai-feature": aiFeatureAddKindEntry,
   "hooked-block": hookedBlockAddKindEntry,
   "editor-plugin": editorPluginAddKindEntry
 };
 function isAddKindId(value) {
-  return typeof value === "string" && ADD_KIND_IDS.includes(value);
+  return typeof value === "string" && ADD_KIND_IDS2.includes(value);
 }
 async function getAddKindExecutionPlan(kind, context) {
   return ADD_KIND_REGISTRY[kind].prepareExecution(context);
@@ -1649,12 +2003,6 @@ function buildAddKindCompletionDetails(kind, options) {
     title: descriptor.title
   };
 }
-function formatAddKindList() {
-  return ADD_KIND_IDS.join(", ");
-}
-function formatAddKindUsagePlaceholder() {
-  return `<${ADD_KIND_IDS.join("|")}>`;
-}
 function supportsAddKindDryRun(kind) {
   return ADD_KIND_REGISTRY[kind].supportsDryRun;
 }
@@ -1705,6 +2053,55 @@ async function copyWorkspaceProject(sourceDir, targetDir) {
     recursive: true
   });
 }
+function formatInstallMarkerError(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}
+function formatInstallMarkerFailures(failures) {
+  return failures.map((failure) => `${failure.operation}: ${failure.reason}`).join("; ");
+}
+function ensureWorkspaceInstallMarker({
+  fsAdapter = fs2,
+  sourceMarker,
+  targetMarker
+}) {
+  const failures = [];
+  try {
+    fsAdapter.symlinkSync(sourceMarker, targetMarker);
+    return;
+  } catch (error) {
+    failures.push({
+      operation: "symlink",
+      reason: formatInstallMarkerError(error)
+    });
+  }
+  try {
+    fsAdapter.linkSync(sourceMarker, targetMarker);
+    return;
+  } catch (error) {
+    failures.push({
+      operation: "hard link",
+      reason: formatInstallMarkerError(error)
+    });
+  }
+  try {
+    fsAdapter.copyFileSync(sourceMarker, targetMarker);
+    return;
+  } catch (error) {
+    failures.push({
+      operation: "copy",
+      reason: formatInstallMarkerError(error)
+    });
+  }
+  throw new Error([
+    "Failed to prepare dry-run install marker.",
+    `Source: ${sourceMarker}`,
+    `Target: ${targetMarker}`,
+    `Fallback failures: ${formatInstallMarkerFailures(failures)}`
+  ].join(" "));
+}
 function ensureWorkspaceInstallMarkers(sourceDir, targetDir) {
   const sourceNodeModules = path2.join(sourceDir, "node_modules");
   if (fs2.existsSync(sourceNodeModules)) {
@@ -1716,15 +2113,7 @@ function ensureWorkspaceInstallMarkers(sourceDir, targetDir) {
       continue;
     }
     const targetMarker = path2.join(targetDir, marker);
-    try {
-      fs2.symlinkSync(sourceMarker, targetMarker);
-    } catch {
-      try {
-        fs2.linkSync(sourceMarker, targetMarker);
-      } catch {
-        fs2.copyFileSync(sourceMarker, targetMarker);
-      }
-    }
+    ensureWorkspaceInstallMarker({ sourceMarker, targetMarker });
   }
 }
 async function listWorkspaceFiles(rootDir) {
@@ -1807,17 +2196,10 @@ async function simulateWorkspaceAddDryRun({
   }
 }
 
-// src/runtime-bridge-output.ts
-import {
-  PACKAGE_MANAGER_IDS,
-  formatPackageExecCommand,
-  inferPackageManagerId,
-  parsePackageManagerField
-} from "@wp-typia/project-tools/package-managers";
-import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES6,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError5
-} from "@wp-typia/project-tools/cli-diagnostics";
+// src/string-utils.ts
+function escapeRegExp(source) {
+  return source.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}
 
 // src/output-markers.ts
 var UNICODE_OUTPUT_MARKERS = {
@@ -1834,9 +2216,6 @@ var ASCII_OUTPUT_MARKERS = {
 };
 var ASCII_ENV_TRUTHY_VALUES = new Set(["1", "on", "true", "yes"]);
 var ASCII_ENV_FALSY_VALUES = new Set(["0", "off", "false", "no"]);
-function escapeRegExp(source) {
-  return source.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
 function readAsciiPreferenceFromEnv(env) {
   const rawValue = env.WP_TYPIA_ASCII;
   if (typeof rawValue !== "string") {
@@ -1897,47 +2276,38 @@ function stripLeadingOutputMarker(text, kind) {
   return text.replace(new RegExp(`^(?:${markerPattern})\\s*`, "u"), "");
 }
 
-// src/print-block.ts
-function printBlock(printLine, lines) {
-  for (const line of lines) {
-    printLine(line);
-  }
+// src/runtime-output/init.ts
+function buildInitCompletionPayload(plan, markerOptions) {
+  const changeLines = [
+    ...plan.packageChanges.addDevDependencies.map((dependency) => `devDependency ${dependency.action} ${dependency.name} -> ${dependency.requiredValue}`),
+    ...plan.packageChanges.packageManagerField ? [
+      `packageManager ${plan.packageChanges.packageManagerField.action} -> ${plan.packageChanges.packageManagerField.requiredValue}`
+    ] : [],
+    ...plan.packageChanges.scripts.map((script) => `script ${script.action} ${script.name} -> ${script.requiredValue}`),
+    ...plan.plannedFiles.map((filePlan) => `file ${filePlan.action} ${filePlan.path} (${filePlan.purpose})`),
+    ...plan.commandMode === "preview-only" ? plan.generatedArtifacts.map((artifactPath) => `generated artifact ${artifactPath}`) : []
+  ];
+  const modeLine = plan.commandMode === "apply" ? plan.status === "already-initialized" ? "Mode: apply requested; no files were written because the retrofit surface already existed." : "Mode: apply; package.json and retrofit helper files were written." : "Mode: preview only; no files were written.";
+  const optionalTitle = plan.commandMode === "apply" ? `Applied adoption changes (${changeLines.length}):` : `Planned adoption changes (${changeLines.length}):`;
+  const title = plan.status === "already-initialized" ? formatOutputMarker("success", `wp-typia init: ${plan.projectName} is already initialized`, markerOptions) : plan.commandMode === "apply" ? formatOutputMarker("success", `Applied retrofit init for ${plan.projectName}`, markerOptions) : formatOutputMarker("dryRun", `Retrofit init plan for ${plan.projectName}`, markerOptions);
+  return {
+    nextSteps: plan.nextSteps,
+    optionalLines: changeLines,
+    optionalNote: plan.summary,
+    optionalTitle,
+    summaryLines: [
+      `Project directory: ${plan.projectDir}`,
+      `Detected layout: ${plan.detectedLayout.description}`,
+      ...plan.detectedLayout.blockNames.length > 0 ? [`Block targets: ${plan.detectedLayout.blockNames.join(", ")}`] : [],
+      `Package manager: ${plan.packageManager}`,
+      modeLine
+    ],
+    title,
+    warningLines: plan.notes
+  };
 }
 
-// src/runtime-bridge-output.ts
-function printCompletionPayload(payload, options = {}) {
-  const printLine = options.printLine ?? console.log;
-  const warnLine = options.warnLine ?? printLine;
-  for (const line of payload.preambleLines ?? []) {
-    printLine(line);
-  }
-  for (const warning of payload.warningLines ?? []) {
-    warnLine(formatOutputMarker("warning", warning, options.markerOptions));
-  }
-  const hasDetails = (payload.summaryLines?.length ?? 0) > 0 || (payload.nextSteps?.length ?? 0) > 0 || (payload.optionalLines?.length ?? 0) > 0 || Boolean(payload.optionalNote);
-  const hasLeadingContext = (payload.preambleLines?.length ?? 0) > 0 || (payload.warningLines?.length ?? 0) > 0;
-  printLine(hasLeadingContext && hasDetails ? `
-${payload.title}` : payload.title);
-  for (const line of payload.summaryLines ?? []) {
-    printLine(line);
-  }
-  if ((payload.nextSteps?.length ?? 0) > 0) {
-    printLine("Next steps:");
-    for (const step of payload.nextSteps ?? []) {
-      printLine(`  ${step}`);
-    }
-  }
-  if ((payload.optionalLines?.length ?? 0) > 0) {
-    printLine(`
-${payload.optionalTitle ?? "Optional:"}`);
-    for (const step of payload.optionalLines ?? []) {
-      printLine(`  ${step}`);
-    }
-  }
-  if (payload.optionalNote) {
-    printLine(`Note: ${payload.optionalNote}`);
-  }
-}
+// src/runtime-output/structured.ts
 function toNonEmptyArray(values) {
   return values && values.length > 0 ? values : undefined;
 }
@@ -1946,13 +2316,6 @@ function extractPlannedFiles(payload) {
   return toNonEmptyArray(files);
 }
 var PROJECT_DIRECTORY_SUMMARY_PREFIX = "Project directory: ";
-function resolveCreateCompletionPackageManager(packageManager) {
-  const parsedPackageManager = parsePackageManagerField(packageManager);
-  if (parsedPackageManager) {
-    return parsedPackageManager;
-  }
-  throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.INVALID_ARGUMENT, `Unsupported package manager "${packageManager}" in create completion payload. Expected one of: ${PACKAGE_MANAGER_IDS.join(", ")}.`);
-}
 function extractCompletionProjectDir(completion) {
   const projectDir = completion?.summaryLines?.find((line) => line.startsWith(PROJECT_DIRECTORY_SUMMARY_PREFIX))?.slice(PROJECT_DIRECTORY_SUMMARY_PREFIX.length).trim();
   return projectDir && projectDir.length > 0 ? projectDir : undefined;
@@ -2005,6 +2368,34 @@ function buildStructuredInitSuccessPayload(plan) {
     }
   };
 }
+// src/runtime-output/create.ts
+import {
+  PACKAGE_MANAGER_IDS,
+  formatPackageExecCommand,
+  parsePackageManagerField
+} from "@wp-typia/project-tools/package-managers";
+import {
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES6,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError5
+} 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) {
+  const normalizedPackageManager = packageManager.trim();
+  const parsedPackageManager = parsePackageManagerField(normalizedPackageManager);
+  if (parsedPackageManager) {
+    return parsedPackageManager;
+  }
+  const looseMatch = LOOSE_CREATE_COMPLETION_PACKAGE_MANAGER_PATTERN.exec(normalizedPackageManager);
+  const loosePackageManager = looseMatch?.[1]?.toLowerCase();
+  return PACKAGE_MANAGER_IDS.includes(loosePackageManager) ? loosePackageManager : null;
+}
+function resolveCreateCompletionPackageManager(packageManager) {
+  const parsedPackageManager = parseCreateCompletionPackageManager(packageManager);
+  if (parsedPackageManager) {
+    return parsedPackageManager;
+  }
+  throw createCliDiagnosticCodeError5(CLI_DIAGNOSTIC_CODES6.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);
 }
@@ -2050,45 +2441,14 @@ function buildCreateDryRunPayload(flow, markerOptions) {
     warningLines: flow.result.warnings
   };
 }
-function buildInitCompletionPayload(plan, markerOptions) {
-  const changeLines = [
-    ...plan.packageChanges.addDevDependencies.map((dependency) => `devDependency ${dependency.action} ${dependency.name} -> ${dependency.requiredValue}`),
-    ...plan.packageChanges.packageManagerField ? [
-      `packageManager ${plan.packageChanges.packageManagerField.action} -> ${plan.packageChanges.packageManagerField.requiredValue}`
-    ] : [],
-    ...plan.packageChanges.scripts.map((script) => `script ${script.action} ${script.name} -> ${script.requiredValue}`),
-    ...plan.plannedFiles.map((filePlan) => `file ${filePlan.action} ${filePlan.path} (${filePlan.purpose})`),
-    ...plan.commandMode === "preview-only" ? plan.generatedArtifacts.map((artifactPath) => `generated artifact ${artifactPath}`) : []
-  ];
-  const modeLine = plan.commandMode === "apply" ? plan.status === "already-initialized" ? "Mode: apply requested; no files were written because the retrofit surface already existed." : "Mode: apply; package.json and retrofit helper files were written." : "Mode: preview only; no files were written.";
-  const optionalTitle = plan.commandMode === "apply" ? `Applied adoption changes (${changeLines.length}):` : `Planned adoption changes (${changeLines.length}):`;
-  const title = plan.status === "already-initialized" ? formatOutputMarker("success", `wp-typia init: ${plan.projectName} is already initialized`, markerOptions) : plan.commandMode === "apply" ? formatOutputMarker("success", `Applied retrofit init for ${plan.projectName}`, markerOptions) : formatOutputMarker("dryRun", `Retrofit init plan for ${plan.projectName}`, markerOptions);
-  return {
-    nextSteps: plan.nextSteps,
-    optionalLines: changeLines,
-    optionalNote: plan.summary,
-    optionalTitle,
-    summaryLines: [
-      `Project directory: ${plan.projectDir}`,
-      `Detected layout: ${plan.detectedLayout.description}`,
-      ...plan.detectedLayout.blockNames.length > 0 ? [`Block targets: ${plan.detectedLayout.blockNames.join(", ")}`] : [],
-      `Package manager: ${plan.packageManager}`,
-      modeLine
-    ],
-    title,
-    warningLines: plan.notes
-  };
-}
-function buildMigrationCompletionPayload(options, markerOptions) {
-  const summaryLines = options.lines.filter((line) => line.trim().length > 0);
-  return {
-    summaryLines,
-    title: formatOutputMarker("success", `Completed wp-typia migrate ${options.command}`, markerOptions)
-  };
-}
+// src/runtime-output/add.ts
+import {
+  formatPackageExecCommand as formatPackageExecCommand2,
+  inferPackageManagerId
+} from "@wp-typia/project-tools/package-managers";
 function buildAddCompletionPayload(options, markerOptions) {
   const verificationLines = [
-    formatPackageExecCommand(options.packageManager ?? inferPackageManagerId(options.projectDir), `wp-typia@${package_default.version}`, "doctor")
+    formatPackageExecCommand2(options.packageManager ?? inferPackageManagerId(options.projectDir), `wp-typia@${package_default.version}`, "doctor")
   ];
   const verificationNote = "Run doctor via your package manager for a quick inventory and generated-artifact check after the add workflow.";
   const completion = buildAddKindCompletionDetails(options.kind, {
@@ -2117,10 +2477,19 @@ function buildAddDryRunPayload(options, markerOptions) {
     warningLines: options.completion.warningLines
   };
 }
-function buildSyncDryRunPayload(options, markerOptions) {
-  const targetSuffix = options.target === "ai" ? " ai" : "";
-  const targetSummary = options.target === "ai" ? "Sync target: AI artifacts only." : options.target === "default" ? "Sync target: generated project defaults." : undefined;
-  return {
+// src/runtime-output/migrate.ts
+function buildMigrationCompletionPayload(options, markerOptions) {
+  const summaryLines = options.lines.filter((line) => line.trim().length > 0);
+  return {
+    summaryLines,
+    title: formatOutputMarker("success", `Completed wp-typia migrate ${options.command}`, markerOptions)
+  };
+}
+// src/runtime-output/sync.ts
+function buildSyncDryRunPayload(options, markerOptions) {
+  const targetSuffix = options.target === "ai" ? " ai" : "";
+  const targetSummary = options.target === "ai" ? "Sync target: AI artifacts only." : options.target === "default" ? "Sync target: generated project defaults." : undefined;
+  return {
     optionalLines: options.plannedCommands.map((command) => command.displayCommand),
     optionalNote: options.check ? `No sync scripts were executed because --dry-run was enabled. Re-run \`wp-typia sync${targetSuffix} --check\` to verify generated artifacts without rewriting them.` : `No sync scripts were executed because --dry-run was enabled. Re-run \`wp-typia sync${targetSuffix}\` without --dry-run to apply generated-file updates, or add --check to verify without rewriting.`,
     optionalTitle: `Planned sync commands (${options.plannedCommands.length}):`,
@@ -2133,232 +2502,58 @@ function buildSyncDryRunPayload(options, markerOptions) {
     title: formatOutputMarker("dryRun", `Dry run for wp-typia sync${targetSuffix}`, markerOptions)
   };
 }
-
-// src/runtime-capabilities.ts
-function isInteractiveTerminal({
-  stdin = process.stdin,
-  stdout = process.stdout,
-  term = process.env.TERM
-} = {}) {
-  return Boolean(stdin?.isTTY) && Boolean(stdout?.isTTY) && term !== "dumb";
-}
-// src/runtime-bridge-sync.ts
-import { spawnSync } from "node:child_process";
-import fs3 from "node:fs";
-import path3 from "node:path";
-import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES7,
-  createCliDiagnosticCodeError as createCliDiagnosticCodeError6
-} from "@wp-typia/project-tools/cli-diagnostics";
-import {
-  formatInstallCommand,
-  formatRunScript,
-  inferPackageManagerId as inferPackageManagerId2
-} from "@wp-typia/project-tools/package-managers";
-var SYNC_INSTALL_MARKERS = [
-  "node_modules",
-  ".pnp.cjs",
-  ".pnp.loader.mjs"
-];
-var LOCAL_SYNC_TOOL_PATTERN = /(^|[\s;&|()])(?:tsx|wp-scripts)(?=($|[\s;&|()]))/u;
-var CAPTURED_SYNC_OUTPUT_MAX_BUFFER = 16 * 1024 * 1024;
-function resolveSyncExecutionTarget(subcommand) {
-  if (!subcommand) {
-    return "default";
-  }
-  if (subcommand === "ai") {
-    return "ai";
-  }
-  throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
-}
-function getSyncRootError(cwd) {
-  return createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.OUTSIDE_PROJECT_ROOT, `No generated wp-typia project root was found at ${cwd}. Run \`wp-typia sync\` from a scaffolded project or official workspace root that already contains generated sync scripts. If you expected this directory to work, cd into the scaffold root first or rerun the scaffold before syncing.`);
-}
-function resolveSyncProjectContext(cwd) {
-  const packageJsonPath = path3.join(cwd, "package.json");
-  if (!fs3.existsSync(packageJsonPath)) {
-    throw getSyncRootError(cwd);
-  }
-  const packageJson = JSON.parse(fs3.readFileSync(packageJsonPath, "utf8"));
-  const scripts = packageJson.scripts ?? {};
-  const syncScripts = {
-    sync: typeof scripts.sync === "string" ? {
-      command: scripts.sync,
-      scriptName: "sync"
-    } : undefined,
-    "sync-ai": typeof scripts["sync-ai"] === "string" ? {
-      command: scripts["sync-ai"],
-      scriptName: "sync-ai"
-    } : typeof scripts["sync-wordpress-ai"] === "string" ? {
-      command: scripts["sync-wordpress-ai"],
-      scriptName: "sync-wordpress-ai"
-    } : undefined,
-    "sync-rest": typeof scripts["sync-rest"] === "string" ? {
-      command: scripts["sync-rest"],
-      scriptName: "sync-rest"
-    } : undefined,
-    "sync-types": typeof scripts["sync-types"] === "string" ? {
-      command: scripts["sync-types"],
-      scriptName: "sync-types"
-    } : undefined
-  };
-  return {
-    cwd,
-    packageJsonPath,
-    packageManager: inferPackageManagerId2(cwd, packageJson.packageManager),
-    scripts: syncScripts
-  };
-}
-function findInstalledDependencyMarkerDir(projectDir) {
-  let currentDir = path3.resolve(projectDir);
-  while (true) {
-    if (SYNC_INSTALL_MARKERS.some((marker) => fs3.existsSync(path3.join(currentDir, marker)))) {
-      return currentDir;
-    }
-    const parentDir = path3.dirname(currentDir);
-    if (parentDir === currentDir) {
-      return null;
-    }
-    currentDir = parentDir;
+// src/print-block.ts
+function printBlock(printLine, lines) {
+  for (const line of lines) {
+    printLine(line);
   }
 }
-function scriptsLikelyNeedInstalledDependencies(project, target) {
-  const candidateScripts = target === "ai" ? [project.scripts["sync-ai"]] : project.scripts.sync ? [project.scripts.sync] : [
-    project.scripts["sync-types"],
-    project.scripts["sync-rest"],
-    project.scripts["sync-ai"]
-  ];
-  return candidateScripts.some((script) => script !== undefined && LOCAL_SYNC_TOOL_PATTERN.test(script.command));
-}
-function assertSyncDependenciesInstalled(project, target) {
-  if (!scriptsLikelyNeedInstalledDependencies(project, target)) {
-    return;
-  }
-  const markerDir = findInstalledDependencyMarkerDir(project.cwd);
-  if (markerDir) {
-    return;
+
+// src/runtime-output/print.ts
+function printCompletionPayload(payload, options = {}) {
+  const printLine = options.printLine ?? console.log;
+  const warnLine = options.warnLine ?? printLine;
+  for (const line of payload.preambleLines ?? []) {
+    printLine(line);
   }
-  throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.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) {
-    case "bun":
-      return { args: ["run", scriptName, ...extraArgs], command: "bun" };
-    case "npm":
-      return {
-        args: [
-          "run",
-          scriptName,
-          ...extraArgs.length > 0 ? ["--", ...extraArgs] : []
-        ],
-        command: "npm"
-      };
-    case "pnpm":
-      return { args: ["run", scriptName, ...extraArgs], command: "pnpm" };
-    case "yarn":
-      return { args: ["run", scriptName, ...extraArgs], command: "yarn" };
+  for (const warning of payload.warningLines ?? []) {
+    warnLine(formatOutputMarker("warning", warning, options.markerOptions));
   }
-}
-function createSyncPlannedCommand(project, scriptName, extraArgs) {
-  const script = project.scripts[scriptName];
-  if (!script) {
-    return null;
+  const hasDetails = (payload.summaryLines?.length ?? 0) > 0 || (payload.nextSteps?.length ?? 0) > 0 || (payload.optionalLines?.length ?? 0) > 0 || Boolean(payload.optionalNote);
+  const hasLeadingContext = (payload.preambleLines?.length ?? 0) > 0 || (payload.warningLines?.length ?? 0) > 0;
+  printLine(hasLeadingContext && hasDetails ? `
+${payload.title}` : payload.title);
+  for (const line of payload.summaryLines ?? []) {
+    printLine(line);
   }
-  const invocation = getPackageManagerRunInvocation(project.packageManager, script.scriptName, extraArgs);
-  return {
-    args: invocation.args,
-    command: invocation.command,
-    displayCommand: formatRunScript(project.packageManager, script.scriptName, extraArgs.join(" ")),
-    scriptName: script.scriptName
-  };
-}
-function buildSyncPlannedCommands(project, extraArgs, target) {
-  if (target === "ai") {
-    const syncAiCommand2 = createSyncPlannedCommand(project, "sync-ai", extraArgs);
-    if (!syncAiCommand2) {
-      throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
+  if ((payload.nextSteps?.length ?? 0) > 0) {
+    printLine("Next steps:");
+    for (const step of payload.nextSteps ?? []) {
+      printLine(`  ${step}`);
     }
-    return [syncAiCommand2];
   }
-  if (project.scripts.sync) {
-    return [createSyncPlannedCommand(project, "sync", extraArgs)];
-  }
-  const syncTypesCommand = createSyncPlannedCommand(project, "sync-types", extraArgs);
-  if (!syncTypesCommand) {
-    throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
-  }
-  const plannedCommands = [syncTypesCommand];
-  const syncRestCommand = createSyncPlannedCommand(project, "sync-rest", extraArgs);
-  if (syncRestCommand) {
-    plannedCommands.push(syncRestCommand);
-  }
-  const syncAiCommand = createSyncPlannedCommand(project, "sync-ai", extraArgs);
-  if (syncAiCommand) {
-    plannedCommands.push(syncAiCommand);
+  if ((payload.optionalLines?.length ?? 0) > 0) {
+    printLine(`
+${payload.optionalTitle ?? "Optional:"}`);
+    for (const step of payload.optionalLines ?? []) {
+      printLine(`  ${step}`);
+    }
   }
-  return plannedCommands;
-}
-function runProjectScript(project, plannedCommand, options) {
-  const result = spawnSync(plannedCommand.command, plannedCommand.args, {
-    cwd: project.cwd,
-    encoding: options.captureOutput ? "utf8" : undefined,
-    ...options.captureOutput ? { maxBuffer: CAPTURED_SYNC_OUTPUT_MAX_BUFFER } : {},
-    shell: process.platform === "win32",
-    stdio: options.captureOutput ? "pipe" : "inherit"
-  });
-  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 createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.COMMAND_EXECUTION, `\`${plannedCommand.displayCommand}\` failed.`, {
-      cause: result.error ?? (stderr ? new Error(stderr.trim()) : undefined)
-    });
+  if (payload.optionalNote) {
+    printLine(`Note: ${payload.optionalNote}`);
   }
-  return {
-    ...plannedCommand,
-    exitCode: result.status ?? 0,
-    ...stderr !== undefined ? { stderr } : {},
-    ...stdout !== undefined ? { stdout } : {}
-  };
 }
-async function executeSyncCommand({
-  captureOutput = false,
-  check = false,
-  cwd,
-  dryRun = false,
-  target = "default"
-}) {
-  const project = resolveSyncProjectContext(cwd);
-  const extraArgs = check ? ["--check"] : [];
-  const plannedCommands = buildSyncPlannedCommands(project, extraArgs, target);
-  const result = {
-    check,
-    dryRun,
-    packageJsonPath: project.packageJsonPath,
-    packageManager: project.packageManager,
-    plannedCommands,
-    projectDir: project.cwd,
-    target
-  };
-  if (dryRun) {
-    return result;
-  }
-  assertSyncDependenciesInstalled(project, target);
-  result.executedCommands = plannedCommands.map((plannedCommand) => runProjectScript(project, plannedCommand, {
-    captureOutput
-  }));
-  return result;
+// src/runtime-capabilities.ts
+function isInteractiveTerminal({
+  stdin = process.stdin,
+  stdout = process.stdout,
+  term = process.env.TERM
+} = {}) {
+  return Boolean(stdin?.isTTY) && Boolean(stdout?.isTTY) && term !== "dumb";
 }
 
-// src/runtime-bridge.ts
-var loadCliAddRuntime = () => import("@wp-typia/project-tools/cli-add");
+// src/runtime-bridge-shared.ts
 var loadCliDiagnosticsRuntime = () => import("@wp-typia/project-tools/cli-diagnostics");
-var loadCliDoctorRuntime = () => import("@wp-typia/project-tools/cli-doctor");
-var loadCliInitRuntime = () => import("@wp-typia/project-tools/cli-init");
-var loadCliPromptRuntime = () => import("@wp-typia/project-tools/cli-prompt");
-var loadCliScaffoldRuntime = () => import("@wp-typia/project-tools/cli-scaffold");
-var loadCliTemplatesRuntime = () => import("@wp-typia/project-tools/cli-templates");
-var loadCreateTemplateValidationRuntime = () => import("@wp-typia/project-tools/create-template-validation");
-var loadMigrationsRuntime = () => import("@wp-typia/project-tools/migrations");
 async function wrapCliCommandError(command, error) {
   const { createCliCommandError: createCliCommandError3 } = await loadCliDiagnosticsRuntime();
   return createCliCommandError3({ command, error });
@@ -2372,6 +2567,15 @@ function shouldWrapCliCommandError(options) {
   }
   return true;
 }
+function emitCompletion(payload, options) {
+  if (options.emitOutput) {
+    printCompletionPayload(payload, {
+      printLine: options.printLine,
+      warnLine: options.warnLine
+    });
+  }
+  return payload;
+}
 function pushFlag(argv, name, value) {
   if (value === undefined || value === null || value === false) {
     return;
@@ -2382,6 +2586,10 @@ function pushFlag(argv, name, value) {
   }
   argv.push(`--${name}`, String(value));
 }
+
+// src/runtime-bridge-add.ts
+var loadCliAddRuntime = () => import("@wp-typia/project-tools/cli-add");
+var loadCliPromptRuntime = () => import("@wp-typia/project-tools/cli-prompt");
 async function executeWorkspaceAddWithOptionalDryRun(options) {
   const simulated = options.dryRun ? await simulateWorkspaceAddDryRun({
     cwd: options.cwd,
@@ -2396,35 +2604,101 @@ async function executeWorkspaceAddWithOptionalDryRun(options) {
       warnLine: options.warnLine
     });
   }
-  return emitCompletion(buildAddDryRunPayload({
-    completion,
-    fileOperations: simulated.fileOperations
-  }), {
-    emitOutput: options.emitOutput ?? true,
-    printLine: options.printLine,
-    warnLine: options.warnLine
-  });
-}
-function executePreparedAddKind(kind, context, plan) {
-  return executeWorkspaceAddWithOptionalDryRun({
-    buildCompletion: (result) => buildAddCompletionPayload({
-      kind,
-      projectDir: result.projectDir,
-      values: plan.getValues(result),
-      warnings: plan.getWarnings?.(result)
-    }),
-    cwd: context.cwd,
-    dryRun: context.dryRun,
-    emitOutput: context.emitOutput,
-    execute: plan.execute,
-    printLine: context.printLine,
-    warnLine: plan.warnLine
-  });
-}
-async function executePlannedAddKind(kind, executionContext, context) {
-  const plan = await getAddKindExecutionPlan(kind, executionContext);
-  return executePreparedAddKind(kind, context, plan);
+  return emitCompletion(buildAddDryRunPayload({
+    completion,
+    fileOperations: simulated.fileOperations
+  }), {
+    emitOutput: options.emitOutput ?? true,
+    printLine: options.printLine,
+    warnLine: options.warnLine
+  });
+}
+function executePreparedAddKind(kind, context, plan) {
+  return executeWorkspaceAddWithOptionalDryRun({
+    buildCompletion: (result) => buildAddCompletionPayload({
+      kind,
+      projectDir: result.projectDir,
+      values: plan.getValues(result),
+      warnings: plan.getWarnings?.(result)
+    }),
+    cwd: context.cwd,
+    dryRun: context.dryRun,
+    emitOutput: context.emitOutput,
+    execute: plan.execute,
+    printLine: context.printLine,
+    warnLine: plan.warnLine
+  });
+}
+async function executePlannedAddKind(kind, executionContext, context) {
+  const plan = await getAddKindExecutionPlan(kind, executionContext);
+  return executePreparedAddKind(kind, context, plan);
+}
+async function executeAddCommand({
+  cwd,
+  emitOutput = true,
+  flags,
+  interactive,
+  kind,
+  name,
+  printLine = console.log,
+  prompt,
+  warnLine = console.warn
+}) {
+  let activePrompt;
+  const dryRun = Boolean(flags["dry-run"]);
+  try {
+    const addRuntime = await loadCliAddRuntime();
+    const isInteractiveSession = interactive ?? isInteractiveTerminal();
+    if (!kind) {
+      if (shouldPrintMissingAddKindHelp({ emitOutput })) {
+        printLine(addRuntime.formatAddHelpText());
+      }
+      throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.MISSING_ARGUMENT, formatMissingAddKindDetailLine());
+    }
+    if (!isAddKindId(kind)) {
+      throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
+    }
+    if (dryRun && !supportsAddKindDryRun(kind)) {
+      throw createCliDiagnosticCodeError6(CLI_DIAGNOSTIC_CODES7.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
+    }
+    const executionContext = {
+      addRuntime,
+      cwd,
+      flags,
+      getOrCreatePrompt: async () => {
+        if (activePrompt) {
+          return activePrompt;
+        }
+        const { createReadlinePrompt } = await loadCliPromptRuntime();
+        activePrompt = prompt ?? createReadlinePrompt();
+        return activePrompt;
+      },
+      isInteractiveSession,
+      name,
+      warnLine
+    };
+    return await executePlannedAddKind(kind, executionContext, {
+      cwd,
+      dryRun,
+      emitOutput,
+      printLine
+    });
+  } catch (error) {
+    if (!shouldWrapCliCommandError({ emitOutput })) {
+      throw error;
+    }
+    throw await wrapCliCommandError("add", error);
+  } finally {
+    if (activePrompt && activePrompt !== prompt) {
+      activePrompt.close();
+    }
+  }
 }
+// src/runtime-bridge-create.ts
+var loadCliPromptRuntime2 = () => import("@wp-typia/project-tools/cli-prompt");
+var loadCliScaffoldRuntime = () => import("@wp-typia/project-tools/cli-scaffold");
+var loadCliTemplatesRuntime = () => import("@wp-typia/project-tools/cli-templates");
+var loadCreateTemplateValidationRuntime = () => import("@wp-typia/project-tools/create-template-validation");
 var PACKAGE_MANAGER_PROMPT_OPTIONS = [
   { label: "npm", value: "npm", hint: "Use npm" },
   { label: "pnpm", value: "pnpm", hint: "Use pnpm" },
@@ -2451,15 +2725,6 @@ var BOOLEAN_PROMPT_OPTIONS = [
   { label: "Yes", value: "yes", hint: "Enable this option" },
   { label: "No", value: "no", hint: "Keep the default disabled state" }
 ];
-function emitCompletion(payload, options) {
-  if (options.emitOutput) {
-    printCompletionPayload(payload, {
-      printLine: options.printLine,
-      warnLine: options.warnLine
-    });
-  }
-  return payload;
-}
 async function executeCreateCommand({
   projectDir,
   cwd,
@@ -2480,7 +2745,7 @@ async function executeCreateCommand({
       { runScaffoldFlow },
       { getTemplateSelectOptions }
     ] = await Promise.all([
-      loadCliPromptRuntime(),
+      loadCliPromptRuntime2(),
       loadCliScaffoldRuntime(),
       loadCliTemplatesRuntime()
     ]);
@@ -2550,185 +2815,354 @@ async function executeCreateCommand({
     }
   }
 }
-async function executeAddCommand({
+// src/runtime-bridge-doctor.ts
+var loadCliDoctorRuntime = () => import("@wp-typia/project-tools/cli-doctor");
+async function executeDoctorCommand(cwd) {
+  try {
+    const { runDoctor } = await loadCliDoctorRuntime();
+    await runDoctor(cwd);
+  } catch (error) {
+    throw await wrapCliCommandError("doctor", error);
+  }
+}
+// src/runtime-bridge-init.ts
+import path3 from "node:path";
+var loadCliInitRuntime = () => import("@wp-typia/project-tools/cli-init");
+async function executeInitCommand({ apply, cwd, packageManager, projectDir }, options = {}) {
+  try {
+    const { runInitCommand } = await loadCliInitRuntime();
+    const resolvedProjectDir = projectDir ? path3.resolve(cwd, projectDir) : cwd;
+    const plan = await runInitCommand({
+      apply,
+      packageManager,
+      projectDir: resolvedProjectDir
+    });
+    const completion = buildInitCompletionPayload(plan);
+    if (options.emitOutput ?? true) {
+      printCompletionPayload(completion, {
+        printLine: options.printLine,
+        warnLine: options.warnLine
+      });
+    }
+    return plan;
+  } catch (error) {
+    if (!shouldWrapCliCommandError({ emitOutput: options.emitOutput })) {
+      throw error;
+    }
+    throw await wrapCliCommandError("init", error);
+  }
+}
+// src/runtime-bridge-migrate.ts
+var loadMigrationsRuntime = () => import("@wp-typia/project-tools/migrations");
+var defaultPrintLine = (line) => {
+  process.stdout.write(`${line}
+`);
+};
+async function executeMigrateCommand({
+  command,
   cwd,
-  emitOutput = true,
   flags,
-  interactive,
-  kind,
-  name,
-  printLine = console.log,
+  printLine = defaultPrintLine,
   prompt,
-  warnLine = console.warn
+  renderLine
 }) {
-  let activePrompt;
-  const dryRun = Boolean(flags["dry-run"]);
   try {
-    const addRuntime = await loadCliAddRuntime();
-    const isInteractiveSession = interactive ?? isInteractiveTerminal();
-    if (!kind) {
-      if (shouldPrintMissingAddKindHelp({ emitOutput })) {
-        printLine(addRuntime.formatAddHelpText());
-      }
-      throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.MISSING_ARGUMENT, formatMissingAddKindDetailLine());
-    }
-    if (!isAddKindId(kind)) {
-      throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_COMMAND, `Unknown add kind "${kind}". Expected one of: ${formatAddKindList()}.`);
-    }
-    if (dryRun && !supportsAddKindDryRun(kind)) {
-      throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_ARGUMENT, `\`wp-typia add ${kind}\` does not support \`--dry-run\` yet.`);
+    const { formatMigrationHelpText, parseMigrationArgs, runMigrationCommand } = await loadMigrationsRuntime();
+    const outputLine = renderLine ?? printLine;
+    if (!command) {
+      const helpText = formatMigrationHelpText();
+      outputLine(helpText);
+      return;
     }
-    const executionContext = {
-      addRuntime,
-      cwd,
-      flags,
-      getOrCreatePrompt: async () => {
-        if (activePrompt) {
-          return activePrompt;
-        }
-        const { createReadlinePrompt } = await loadCliPromptRuntime();
-        activePrompt = prompt ?? createReadlinePrompt();
-        return activePrompt;
-      },
-      isInteractiveSession,
-      name,
-      warnLine
+    const argv = [command];
+    pushFlag(argv, "all", flags.all);
+    pushFlag(argv, "force", flags.force);
+    pushFlag(argv, "current-migration-version", readOptionalLooseStringFlag(flags, "current-migration-version"));
+    pushFlag(argv, "migration-version", readOptionalLooseStringFlag(flags, "migration-version"));
+    pushFlag(argv, "from-migration-version", readOptionalLooseStringFlag(flags, "from-migration-version"));
+    pushFlag(argv, "to-migration-version", readOptionalLooseStringFlag(flags, "to-migration-version"));
+    pushFlag(argv, "iterations", readOptionalLooseStringFlag(flags, "iterations"));
+    pushFlag(argv, "seed", readOptionalLooseStringFlag(flags, "seed"));
+    const parsed = parseMigrationArgs(argv);
+    const lines = renderLine ? [] : null;
+    const captureLine = (line) => {
+      lines?.push(line);
+      outputLine(line);
     };
-    return await executePlannedAddKind(kind, executionContext, {
-      cwd,
-      dryRun,
-      emitOutput,
-      printLine
+    const result = await runMigrationCommand(parsed, cwd, {
+      prompt,
+      renderLine: captureLine
     });
+    if (renderLine) {
+      return result && typeof result === "object" && "cancelled" in result && result.cancelled === true ? undefined : buildMigrationCompletionPayload({
+        command: parsed.command ?? "plan",
+        lines: lines ?? []
+      });
+    }
+    if (result && typeof result === "object" && "cancelled" in result && result.cancelled === true) {
+      return;
+    }
   } catch (error) {
-    if (!shouldWrapCliCommandError({ emitOutput })) {
+    if (!shouldWrapCliCommandError({ renderLine })) {
       throw error;
     }
-    throw await wrapCliCommandError("add", error);
-  } finally {
-    if (activePrompt && activePrompt !== prompt) {
-      activePrompt.close();
+    throw await wrapCliCommandError("migrate", error);
+  }
+}
+// src/runtime-bridge-templates.ts
+import {
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES8,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError7
+} from "@wp-typia/project-tools/cli-diagnostics";
+var loadCliTemplatesRuntime2 = () => import("@wp-typia/project-tools/cli-templates");
+async function executeTemplatesCommand({ flags }, printLine = console.log) {
+  const {
+    formatTemplateDetails,
+    formatTemplateFeatures,
+    formatTemplateSummary,
+    getTemplateById,
+    listTemplates
+  } = await loadCliTemplatesRuntime2();
+  const subcommand = flags.subcommand ?? "list";
+  if (subcommand === "list") {
+    for (const template of listTemplates()) {
+      printBlock(printLine, [formatTemplateSummary(template), formatTemplateFeatures(template)]);
+    }
+    return;
+  }
+  if (subcommand === "inspect") {
+    if (!flags.id) {
+      throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
+    }
+    const template = getTemplateById(flags.id);
+    if (!template) {
+      throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
+    }
+    printBlock(printLine, [formatTemplateDetails(template)]);
+    return;
+  }
+  throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.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_CODES9,
+  createCliDiagnosticCodeError as createCliDiagnosticCodeError8
+} from "@wp-typia/project-tools/cli-diagnostics";
+import {
+  formatInstallCommand,
+  formatRunScript,
+  inferPackageManagerId as inferPackageManagerId2
+} from "@wp-typia/project-tools/package-managers";
+var SYNC_INSTALL_MARKERS = [
+  "node_modules",
+  ".pnp.cjs",
+  ".pnp.loader.mjs"
+];
+var LOCAL_SYNC_TOOL_PATTERN = /(^|[\s;&|()])(?:tsx|wp-scripts)(?=($|[\s;&|()]))/u;
+var CAPTURED_SYNC_OUTPUT_MAX_BUFFER = 16 * 1024 * 1024;
+function resolveSyncExecutionTarget(subcommand) {
+  if (!subcommand) {
+    return "default";
+  }
+  if (subcommand === "ai") {
+    return "ai";
+  }
+  throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_COMMAND, `Unknown sync subcommand "${subcommand}". Expected one of: "ai".`);
+}
+function getSyncRootError(cwd) {
+  return createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.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");
+  try {
+    return JSON.parse(source);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_ARGUMENT, `Unable to parse ${packageJsonPath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
+  }
+}
+function resolveSyncProjectContext(cwd) {
+  const packageJsonPath = path4.join(cwd, "package.json");
+  if (!fs3.existsSync(packageJsonPath)) {
+    throw getSyncRootError(cwd);
+  }
+  const packageJson = readSyncPackageJson(packageJsonPath);
+  const scripts = packageJson.scripts ?? {};
+  const syncScripts = {
+    sync: typeof scripts.sync === "string" ? {
+      command: scripts.sync,
+      scriptName: "sync"
+    } : undefined,
+    "sync-ai": typeof scripts["sync-ai"] === "string" ? {
+      command: scripts["sync-ai"],
+      scriptName: "sync-ai"
+    } : typeof scripts["sync-wordpress-ai"] === "string" ? {
+      command: scripts["sync-wordpress-ai"],
+      scriptName: "sync-wordpress-ai"
+    } : undefined,
+    "sync-rest": typeof scripts["sync-rest"] === "string" ? {
+      command: scripts["sync-rest"],
+      scriptName: "sync-rest"
+    } : undefined,
+    "sync-types": typeof scripts["sync-types"] === "string" ? {
+      command: scripts["sync-types"],
+      scriptName: "sync-types"
+    } : undefined
+  };
+  return {
+    cwd,
+    packageJsonPath,
+    packageManager: inferPackageManagerId2(cwd, packageJson.packageManager),
+    scripts: syncScripts
+  };
+}
+function findInstalledDependencyMarkerDir(projectDir) {
+  let currentDir = path4.resolve(projectDir);
+  while (true) {
+    if (SYNC_INSTALL_MARKERS.some((marker) => fs3.existsSync(path4.join(currentDir, marker)))) {
+      return currentDir;
+    }
+    const parentDir = path4.dirname(currentDir);
+    if (parentDir === currentDir) {
+      return null;
     }
+    currentDir = parentDir;
   }
 }
-async function executeTemplatesCommand({ flags }, printLine = console.log) {
-  const {
-    formatTemplateDetails,
-    formatTemplateFeatures,
-    formatTemplateSummary,
-    getTemplateById,
-    listTemplates
-  } = await loadCliTemplatesRuntime();
-  const subcommand = flags.subcommand ?? "list";
-  if (subcommand === "list") {
-    for (const template of listTemplates()) {
-      printBlock(printLine, [formatTemplateSummary(template), formatTemplateFeatures(template)]);
-    }
+function scriptsLikelyNeedInstalledDependencies(project, target) {
+  const candidateScripts = target === "ai" ? [project.scripts["sync-ai"]] : project.scripts.sync ? [project.scripts.sync] : [
+    project.scripts["sync-types"],
+    project.scripts["sync-rest"],
+    project.scripts["sync-ai"]
+  ];
+  return candidateScripts.some((script) => script !== undefined && LOCAL_SYNC_TOOL_PATTERN.test(script.command));
+}
+function assertSyncDependenciesInstalled(project, target) {
+  if (!scriptsLikelyNeedInstalledDependencies(project, target)) {
     return;
   }
-  if (subcommand === "inspect") {
-    if (!flags.id) {
-      throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.MISSING_ARGUMENT, "`wp-typia templates inspect` requires <template-id>.");
-    }
-    const template = getTemplateById(flags.id);
-    if (!template) {
-      throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_ARGUMENT, `Unknown template "${flags.id}".`);
-    }
-    printBlock(printLine, [formatTemplateDetails(template)]);
+  const markerDir = findInstalledDependencyMarkerDir(project.cwd);
+  if (markerDir) {
     return;
   }
-  throw createCliDiagnosticCodeError7(CLI_DIAGNOSTIC_CODES8.INVALID_COMMAND, `Unknown templates subcommand "${subcommand}". Expected list or inspect.`);
+  throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.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\`.`);
 }
-async function executeInitCommand({ apply, cwd, packageManager, projectDir }, options = {}) {
-  try {
-    const { runInitCommand } = await loadCliInitRuntime();
-    const resolvedProjectDir = projectDir ? (await import("node:path")).resolve(cwd, projectDir) : cwd;
-    const plan = await runInitCommand({
-      apply,
-      packageManager,
-      projectDir: resolvedProjectDir
-    });
-    const completion = buildInitCompletionPayload(plan);
-    if (options.emitOutput ?? true) {
-      printCompletionPayload(completion, {
-        printLine: options.printLine,
-        warnLine: options.warnLine
-      });
-    }
-    return plan;
-  } catch (error) {
-    if (!shouldWrapCliCommandError({ emitOutput: options.emitOutput })) {
-      throw error;
+function getPackageManagerRunInvocation(packageManager, scriptName, extraArgs) {
+  switch (packageManager) {
+    case "bun":
+      return { args: ["run", scriptName, ...extraArgs], command: "bun" };
+    case "npm":
+      return {
+        args: [
+          "run",
+          scriptName,
+          ...extraArgs.length > 0 ? ["--", ...extraArgs] : []
+        ],
+        command: "npm"
+      };
+    case "pnpm":
+      return { args: ["run", scriptName, ...extraArgs], command: "pnpm" };
+    case "yarn":
+      return { args: ["run", scriptName, ...extraArgs], command: "yarn" };
+  }
+}
+function createSyncPlannedCommand(project, scriptName, extraArgs) {
+  const script = project.scripts[scriptName];
+  if (!script) {
+    return null;
+  }
+  const invocation = getPackageManagerRunInvocation(project.packageManager, script.scriptName, extraArgs);
+  return {
+    args: invocation.args,
+    command: invocation.command,
+    displayCommand: formatRunScript(project.packageManager, script.scriptName, extraArgs.join(" ")),
+    scriptName: script.scriptName
+  };
+}
+function buildSyncPlannedCommands(project, extraArgs, target) {
+  if (target === "ai") {
+    const syncAiCommand2 = createSyncPlannedCommand(project, "sync-ai", extraArgs);
+    if (!syncAiCommand2) {
+      throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define a \`sync-ai\` script for \`wp-typia sync ai\`.`);
     }
-    throw await wrapCliCommandError("init", error);
+    return [syncAiCommand2];
+  }
+  if (project.scripts.sync) {
+    return [createSyncPlannedCommand(project, "sync", extraArgs)];
+  }
+  const syncTypesCommand = createSyncPlannedCommand(project, "sync-types", extraArgs);
+  if (!syncTypesCommand) {
+    throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.CONFIGURATION_MISSING, `Expected ${project.packageJsonPath} to define either a \`sync\` or \`sync-types\` script.`);
+  }
+  const plannedCommands = [syncTypesCommand];
+  const syncRestCommand = createSyncPlannedCommand(project, "sync-rest", extraArgs);
+  if (syncRestCommand) {
+    plannedCommands.push(syncRestCommand);
+  }
+  const syncAiCommand = createSyncPlannedCommand(project, "sync-ai", extraArgs);
+  if (syncAiCommand) {
+    plannedCommands.push(syncAiCommand);
   }
+  return plannedCommands;
 }
-async function executeDoctorCommand(cwd) {
-  try {
-    const { runDoctor } = await loadCliDoctorRuntime();
-    await runDoctor(cwd);
-  } catch (error) {
-    throw await wrapCliCommandError("doctor", error);
+function runProjectScript(project, plannedCommand, options) {
+  const result = spawnSync(plannedCommand.command, plannedCommand.args, {
+    cwd: project.cwd,
+    encoding: options.captureOutput ? "utf8" : undefined,
+    ...options.captureOutput ? { maxBuffer: CAPTURED_SYNC_OUTPUT_MAX_BUFFER } : {},
+    shell: process.platform === "win32",
+    stdio: options.captureOutput ? "pipe" : "inherit"
+  });
+  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 createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.COMMAND_EXECUTION, `\`${plannedCommand.displayCommand}\` failed.`, {
+      cause: result.error ?? (stderr ? new Error(stderr.trim()) : undefined)
+    });
   }
+  return {
+    ...plannedCommand,
+    exitCode: result.status ?? 0,
+    ...stderr !== undefined ? { stderr } : {},
+    ...stdout !== undefined ? { stdout } : {}
+  };
 }
-async function executeMigrateCommand({
-  command,
+async function executeSyncCommand({
+  captureOutput = false,
+  check = false,
   cwd,
-  flags,
-  prompt,
-  renderLine
+  dryRun = false,
+  target = "default"
 }) {
-  const { formatMigrationHelpText, parseMigrationArgs, runMigrationCommand } = await loadMigrationsRuntime();
-  if (!command) {
-    console.log(formatMigrationHelpText());
-    return;
-  }
-  try {
-    const argv = [command];
-    pushFlag(argv, "all", flags.all);
-    pushFlag(argv, "force", flags.force);
-    pushFlag(argv, "current-migration-version", readOptionalLooseStringFlag(flags, "current-migration-version"));
-    pushFlag(argv, "migration-version", readOptionalLooseStringFlag(flags, "migration-version"));
-    pushFlag(argv, "from-migration-version", readOptionalLooseStringFlag(flags, "from-migration-version"));
-    pushFlag(argv, "to-migration-version", readOptionalLooseStringFlag(flags, "to-migration-version"));
-    pushFlag(argv, "iterations", readOptionalLooseStringFlag(flags, "iterations"));
-    pushFlag(argv, "seed", readOptionalLooseStringFlag(flags, "seed"));
-    const parsed = parseMigrationArgs(argv);
-    const lines = renderLine ? [] : null;
-    const captureLine = (line) => {
-      lines?.push(line);
-      if (renderLine) {
-        renderLine(line);
-        return;
-      }
-      console.log(line);
-    };
-    const result = await runMigrationCommand(parsed, cwd, {
-      prompt,
-      renderLine: captureLine
-    });
-    if (renderLine) {
-      return result && typeof result === "object" && "cancelled" in result && result.cancelled === true ? undefined : buildMigrationCompletionPayload({
-        command: parsed.command ?? "plan",
-        lines: lines ?? []
-      });
-    }
-    if (result && typeof result === "object" && "cancelled" in result && result.cancelled === true) {
-      return;
-    }
-  } catch (error) {
-    if (!shouldWrapCliCommandError({ renderLine })) {
-      throw error;
-    }
-    throw await wrapCliCommandError("migrate", error);
+  const project = resolveSyncProjectContext(cwd);
+  const extraArgs = check ? ["--check"] : [];
+  const plannedCommands = buildSyncPlannedCommands(project, extraArgs, target);
+  const result = {
+    check,
+    dryRun,
+    packageJsonPath: project.packageJsonPath,
+    packageManager: project.packageManager,
+    plannedCommands,
+    projectDir: project.cwd,
+    target
+  };
+  if (dryRun) {
+    return result;
   }
+  assertSyncDependenciesInstalled(project, target);
+  result.executedCommands = plannedCommands.map((plannedCommand) => runProjectScript(project, plannedCommand, {
+    captureOutput
+  }));
+  return result;
 }
-
 // src/command-contract.ts
-import path4 from "node:path";
+import path5 from "node:path";
 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/command-registry.ts
@@ -2770,7 +3204,7 @@ var WP_TYPIA_COMMAND_REGISTRY = [
     nodeFallback: true,
     optionGroups: ["add"],
     requiresBunRuntime: false,
-    subcommands: ADD_KIND_IDS
+    subcommands: ADD_KIND_IDS2
   },
   {
     commandTree: true,
@@ -2997,12 +3431,12 @@ function looksLikeStructuredProjectInput(value) {
   return value.startsWith("@") && value.includes("/");
 }
 function assertPositionalAliasProjectDir(projectDir) {
-  const normalizedProjectDir = path4.normalize(projectDir).replace(/[\\/]+$/u, "") || path4.normalize(projectDir);
+  const normalizedProjectDir = path5.normalize(projectDir).replace(/[\\/]+$/u, "") || path5.normalize(projectDir);
   if (normalizedProjectDir === "." || normalizedProjectDir === "..") {
-    throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_ARGUMENT, `The positional alias does not scaffold into \`${projectDir}\`. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` with an explicit child directory instead.`);
+    throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.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 createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_ARGUMENT, `The positional alias only accepts unambiguous local project directories. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for \`${projectDir}\`.`);
+    throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_ARGUMENT, `The positional alias only accepts unambiguous local project directories. Use \`${WP_TYPIA_CANONICAL_CREATE_USAGE}\` for \`${projectDir}\`.`);
   }
 }
 function normalizeWpTypiaArgv(argv) {
@@ -3016,7 +3450,7 @@ function normalizeWpTypiaArgv(argv) {
     return argv;
   }
   if (firstPositional === "migrations") {
-    throw createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.INVALID_ARGUMENT, "`wp-typia migrations` was removed in favor of `wp-typia migrate`. Use `wp-typia migrate <subcommand>` instead.");
+    throw createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.INVALID_ARGUMENT, "`wp-typia migrations` was removed in favor of `wp-typia migrate`. Use `wp-typia migrate <subcommand>` instead.");
   }
   if (isReservedTopLevelCommandName(firstPositional)) {
     assertStringOptionValues(argv);
@@ -3024,7 +3458,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 createCliDiagnosticCodeError8(CLI_DIAGNOSTIC_CODES9.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 createCliDiagnosticCodeError9(CLI_DIAGNOSTIC_CODES10.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 = [
@@ -3038,14 +3472,15 @@ function normalizeWpTypiaArgv(argv) {
 
 // src/node-fallback/dispatchers/add.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES10,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES11,
   createCliCommandError as createCliCommandError3
 } from "@wp-typia/project-tools/cli-diagnostics";
 async function dispatchNodeFallbackAdd({
   cwd,
   mergedFlags,
   positionals,
-  printLine
+  printLine,
+  warnLine
 }) {
   if (!positionals[1]) {
     if (shouldPrintMissingAddKindHelp({ format: mergedFlags.format })) {
@@ -3053,7 +3488,7 @@ async function dispatchNodeFallbackAdd({
       printLine(formatAddHelpText());
     }
     throw createCliCommandError3({
-      code: CLI_DIAGNOSTIC_CODES10.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES11.MISSING_ARGUMENT,
       command: "add",
       detailLines: buildMissingAddKindDetailLines()
     });
@@ -3067,7 +3502,9 @@ async function dispatchNodeFallbackAdd({
         flags: mergedFlags,
         interactive: false,
         kind: positionals[1],
-        name: positionals[2]
+        name: positionals[2],
+        printLine,
+        warnLine
       });
     } catch (error) {
       throw createCliCommandError3({
@@ -3088,25 +3525,28 @@ async function dispatchNodeFallbackAdd({
     flags: mergedFlags,
     interactive: undefined,
     kind: positionals[1],
-    name: positionals[2]
+    name: positionals[2],
+    printLine,
+    warnLine
   });
 }
 
 // src/node-fallback/dispatchers/create.ts
 import {
-  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES11,
+  CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES12,
   createCliCommandError as createCliCommandError4
 } from "@wp-typia/project-tools/cli-diagnostics";
 async function dispatchNodeFallbackCreate({
   cwd,
   mergedFlags,
   positionals,
-  printLine
+  printLine,
+  warnLine
 }) {
   const projectDir = positionals[1];
   if (!projectDir) {
     throw createCliCommandError4({
-      code: CLI_DIAGNOSTIC_CODES11.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES12.MISSING_ARGUMENT,
       command: "create",
       detailLines: buildMissingCreateProjectDirDetailLines()
     });
@@ -3118,7 +3558,9 @@ async function dispatchNodeFallbackCreate({
       emitOutput: mergedFlags.format !== "json",
       flags: mergedFlags,
       interactive: mergedFlags.format === "json" ? false : undefined,
-      projectDir
+      printLine,
+      projectDir,
+      warnLine
     });
   } catch (error) {
     throw createCliCommandError4({
@@ -3143,6 +3585,7 @@ 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."
 ];
+var NODE_FALLBACK_NO_COMMAND_REASON_LINE = "No command provided. Run wp-typia --help for usage information.";
 function renderGeneralHelp(printLine) {
   printBlock(printLine, [
     `wp-typia ${package_default.version}`,
@@ -3161,6 +3604,10 @@ function renderGeneralHelp(printLine) {
     `- ${WP_TYPIA_POSITIONAL_ALIAS_USAGE}`
   ]);
 }
+function renderNoCommandHelp(printLine) {
+  printBlock(printLine, [NODE_FALLBACK_NO_COMMAND_REASON_LINE, ""]);
+  renderGeneralHelp(printLine);
+}
 function renderNodeFallbackCommandHelp(printLine, config) {
   printBlock(printLine, [
     config.heading,
@@ -3220,6 +3667,20 @@ var NODE_FALLBACK_BOOLEAN_OPTION_NAMES = ["help", "version"];
 var printLine = (line) => {
   console.log(line);
 };
+var warnLine = (line) => {
+  console.warn(line);
+};
+function createNoCommandCliError() {
+  return createCliCommandError5({
+    code: CLI_DIAGNOSTIC_CODES13.INVALID_COMMAND,
+    command: "wp-typia",
+    detailLines: [NODE_FALLBACK_NO_COMMAND_REASON_LINE],
+    summary: "No command was provided."
+  });
+}
+function isNoCommandCliDiagnostic(error) {
+  return isCliDiagnosticError(error) && error.code === CLI_DIAGNOSTIC_CODES13.INVALID_COMMAND && error.command === "wp-typia" && error.detailLines.includes(NODE_FALLBACK_NO_COMMAND_REASON_LINE);
+}
 function hasFlagBeforeTerminator(argv, flag) {
   for (const arg of argv) {
     if (arg === "--") {
@@ -3300,7 +3761,7 @@ function renderTemplatesJson(flags, subcommand) {
   const templateId = flags.id;
   if (!templateId) {
     throw createCliCommandError5({
-      code: CLI_DIAGNOSTIC_CODES12.MISSING_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES13.MISSING_ARGUMENT,
       command: "templates",
       detailLines: ["`wp-typia templates inspect` requires <template-id>."]
     });
@@ -3308,7 +3769,7 @@ function renderTemplatesJson(flags, subcommand) {
   const template = getTemplateById(templateId);
   if (!template) {
     throw createCliCommandError5({
-      code: CLI_DIAGNOSTIC_CODES12.INVALID_ARGUMENT,
+      code: CLI_DIAGNOSTIC_CODES13.INVALID_ARGUMENT,
       command: "templates",
       detailLines: [`Unknown template "${templateId}".`]
     });
@@ -3319,7 +3780,7 @@ function renderTemplatesJson(flags, subcommand) {
 }
 function renderUnsupportedCommand(command) {
   throw createCliCommandError5({
-    code: CLI_DIAGNOSTIC_CODES12.UNSUPPORTED_COMMAND,
+    code: CLI_DIAGNOSTIC_CODES13.UNSUPPORTED_COMMAND,
     command,
     detailLines: [
       [
@@ -3345,7 +3806,7 @@ async function renderDoctorJson() {
   }, null, 2));
   if (checks.some((check) => check.status === "fail")) {
     throw createCliCommandError6({
-      code: CLI_DIAGNOSTIC_CODES12.DOCTOR_CHECK_FAILED,
+      code: CLI_DIAGNOSTIC_CODES13.DOCTOR_CHECK_FAILED,
       command: "doctor",
       detailLines: getDoctorFailureDetailLines(checks),
       summary: "One or more doctor checks failed."
@@ -3365,7 +3826,9 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
   init: async ({
     cwd,
     mergedFlags,
-    positionals
+    positionals,
+    printLine: printLine2,
+    warnLine: warnLine2
   }) => {
     const plan = await executeInitCommand({
       apply: Boolean(mergedFlags.apply),
@@ -3373,27 +3836,33 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
       packageManager: typeof mergedFlags["package-manager"] === "string" ? mergedFlags["package-manager"] : undefined,
       projectDir: positionals[1]
     }, {
-      emitOutput: mergedFlags.format !== "json"
+      emitOutput: mergedFlags.format !== "json",
+      printLine: printLine2,
+      warnLine: warnLine2
     });
     if (mergedFlags.format === "json") {
-      printLine(JSON.stringify(buildStructuredInitSuccessPayload(plan), null, 2));
+      printLine2(JSON.stringify(buildStructuredInitSuccessPayload(plan), null, 2));
     }
   },
   migrate: async ({
     cwd,
     mergedFlags,
-    positionals
+    positionals,
+    printLine: printLine2
   }) => {
     await executeMigrateCommand({
       command: positionals[1],
       cwd,
-      flags: mergedFlags
+      flags: mergedFlags,
+      printLine: printLine2
     });
   },
   sync: async ({
     cwd,
     mergedFlags,
-    positionals
+    positionals,
+    printLine: printLine2,
+    warnLine: warnLine2
   }) => {
     try {
       const syncTarget = resolveSyncExecutionTarget(positionals[1]);
@@ -3405,7 +3874,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
         target: syncTarget
       });
       if (mergedFlags.format === "json") {
-        printLine(JSON.stringify({
+        printLine2(JSON.stringify({
           sync
         }, null, 2));
         return;
@@ -3417,7 +3886,10 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
           plannedCommands: sync.plannedCommands,
           projectDir: sync.projectDir,
           target: sync.target
-        }));
+        }), {
+          printLine: printLine2,
+          warnLine: warnLine2
+        });
       }
     } catch (error) {
       throw createCliCommandError5({
@@ -3428,14 +3900,15 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
   },
   templates: async ({
     mergedFlags,
-    positionals
+    positionals,
+    printLine: printLine2
   }) => {
     const subcommand = positionals[1];
     const templateId = typeof mergedFlags.id === "string" ? mergedFlags.id : positionals[2];
     const resolvedSubcommand = templateId ? "inspect" : subcommand ?? "list";
     if (resolvedSubcommand !== "list" && resolvedSubcommand !== "inspect") {
       throw createCliCommandError5({
-        code: CLI_DIAGNOSTIC_CODES12.INVALID_COMMAND,
+        code: CLI_DIAGNOSTIC_CODES13.INVALID_COMMAND,
         command: "templates",
         detailLines: [
           `Unknown templates subcommand "${resolvedSubcommand}". Expected list or inspect.`
@@ -3454,7 +3927,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
         id: templateId,
         subcommand: resolvedSubcommand
       }
-    });
+    }, printLine2);
   }
 };
 async function runNodeCli(argv = process.argv.slice(2)) {
@@ -3473,9 +3946,11 @@ async function runNodeCli(argv = process.argv.slice(2)) {
   const helpTarget = command === "help" ? subcommand : command;
   const versionRequested = hasFlagBeforeTerminator(cliArgv, "--version") || command === "version";
   if (cliArgv.length === 0) {
-    renderGeneralHelp(printLine);
-    process.exitCode = 1;
-    return;
+    const noCommandError = createNoCommandCliError();
+    if (rawMergedFlags.format !== "json") {
+      renderNoCommandHelp(printLine);
+    }
+    throw noCommandError;
   }
   if (helpRequested) {
     if (helpTarget) {
@@ -3508,7 +3983,8 @@ async function runNodeCli(argv = process.argv.slice(2)) {
       cwd: process.cwd(),
       mergedFlags,
       positionals,
-      printLine
+      printLine,
+      warnLine
     });
     return;
   }
@@ -3532,6 +4008,10 @@ async function runNodeCliEntrypoint(argv = process.argv.slice(2)) {
       process.exitCode = 1;
       return;
     }
+    if (isNoCommandCliDiagnostic(error)) {
+      process.exitCode = 1;
+      return;
+    }
     console.error(`Error: ${await formatCliDiagnosticError(error)}`);
     process.exitCode = 1;
   }
@@ -3543,4 +4023,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=B5CA87A93189F22464756E2164756E21
+//# debugId=CA11CB4ECD0D26E464756E2164756E21