wp-typia 0.22.10 → 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.10",
+  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.10",
+    "@wp-typia/project-tools": "0.23.0",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -100,6 +100,7 @@ import {
   CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES13,
   createCliCommandError as createCliCommandError5,
   formatCliDiagnosticError,
+  isCliDiagnosticError,
   serializeCliDiagnosticError as serializeCliDiagnosticError2
 } from "@wp-typia/project-tools/cli-diagnostics";
 
@@ -124,10 +125,22 @@ var ADD_OPTION_METADATA = {
     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"
@@ -153,6 +166,24 @@ var ADD_OPTION_METADATA = {
     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"
@@ -161,14 +192,50 @@ var ADD_OPTION_METADATA = {
     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"
@@ -181,9 +248,22 @@ var ADD_OPTION_METADATA = {
     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
@@ -977,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",
@@ -1016,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);
@@ -1125,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) {
@@ -1172,7 +1266,8 @@ var adminViewAddKindEntry = defineAddKindRegistryEntry({
         ...result.source ? { source: result.source } : {}
       }),
       missingNameMessage: ADMIN_VIEW_MISSING_NAME_MESSAGE,
-      name
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 10,
@@ -1259,7 +1354,8 @@ var bindingSourceAddKindEntry = defineAddKindRegistryEntry({
         bindingSourceSlug: result.bindingSourceSlug
       }),
       missingNameMessage: BINDING_SOURCE_MISSING_NAME_MESSAGE,
-      name
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 70,
@@ -1363,6 +1459,50 @@ var blockAddKindEntry = 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) => [
+      `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({
@@ -1394,7 +1534,8 @@ var editorPluginAddKindEntry = defineAddKindRegistryEntry({
         slot: result.slot
       }),
       missingNameMessage: EDITOR_PLUGIN_MISSING_NAME_MESSAGE,
-      name
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 120,
@@ -1438,7 +1579,8 @@ var hookedBlockAddKindEntry = defineAddKindRegistryEntry({
         position: result.position
       }),
       missingNameMessage: HOOKED_BLOCK_MISSING_NAME_MESSAGE,
-      name
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 110,
@@ -1447,6 +1589,51 @@ 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({
@@ -1482,47 +1669,177 @@ 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>].";
+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, 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: REST_RESOURCE_MISSING_NAME_MESSAGE,
-      name
+      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
 });
 
@@ -1557,7 +1874,8 @@ var styleAddKindEntry = defineAddKindRegistryEntry({
         styleSlug: result.styleSlug
       }),
       missingNameMessage: STYLE_MISSING_NAME_MESSAGE,
-      name
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 40,
@@ -1602,7 +1920,8 @@ var transformAddKindEntry = defineAddKindRegistryEntry({
         transformSlug: result.transformSlug
       }),
       missingNameMessage: TRANSFORM_MISSING_NAME_MESSAGE,
-      name
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 50,
@@ -1642,7 +1961,8 @@ var variationAddKindEntry = defineAddKindRegistryEntry({
         variationSlug: result.variationSlug
       }),
       missingNameMessage: VARIATION_MISSING_NAME_MESSAGE,
-      name
+      name,
+      warnLine: context.warnLine
     });
   },
   sortOrder: 30,
@@ -1655,12 +1975,15 @@ 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,
@@ -1873,6 +2196,11 @@ async function simulateWorkspaceAddDryRun({
   }
 }
 
+// src/string-utils.ts
+function escapeRegExp(source) {
+  return source.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}
+
 // src/output-markers.ts
 var UNICODE_OUTPUT_MARKERS = {
   dryRun: "\uD83E\uDDEA",
@@ -1888,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") {
@@ -2053,10 +2378,7 @@ import {
   CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES6,
   createCliDiagnosticCodeError as createCliDiagnosticCodeError5
 } from "@wp-typia/project-tools/cli-diagnostics";
-function escapeRegExp2(source) {
-  return source.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
-}
-var LOOSE_CREATE_COMPLETION_PACKAGE_MANAGER_PATTERN = new RegExp(`^(?:corepack\\s+)?(${PACKAGE_MANAGER_IDS.map(escapeRegExp2).join("|")})(?=$|[@:/+\\s])`, "iu");
+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);
@@ -2532,22 +2854,24 @@ async function executeInitCommand({ apply, cwd, packageManager, projectDir }, op
 }
 // 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,
   flags,
+  printLine = defaultPrintLine,
   prompt,
   renderLine
 }) {
   try {
     const { formatMigrationHelpText, parseMigrationArgs, runMigrationCommand } = await loadMigrationsRuntime();
+    const outputLine = renderLine ?? printLine;
     if (!command) {
       const helpText = formatMigrationHelpText();
-      if (renderLine) {
-        renderLine(helpText);
-      } else {
-        console.log(helpText);
-      }
+      outputLine(helpText);
       return;
     }
     const argv = [command];
@@ -2563,11 +2887,7 @@ async function executeMigrateCommand({
     const lines = renderLine ? [] : null;
     const captureLine = (line) => {
       lines?.push(line);
-      if (renderLine) {
-        renderLine(line);
-        return;
-      }
-      console.log(line);
+      outputLine(line);
     };
     const result = await runMigrationCommand(parsed, cwd, {
       prompt,
@@ -3350,6 +3670,17 @@ var printLine = (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 === "--") {
@@ -3516,12 +3847,14 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
   migrate: async ({
     cwd,
     mergedFlags,
-    positionals
+    positionals,
+    printLine: printLine2
   }) => {
     await executeMigrateCommand({
       command: positionals[1],
       cwd,
-      flags: mergedFlags
+      flags: mergedFlags,
+      printLine: printLine2
     });
   },
   sync: async ({
@@ -3567,7 +3900,8 @@ 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];
@@ -3593,7 +3927,7 @@ var NODE_FALLBACK_COMMAND_DISPATCHERS = {
         id: templateId,
         subcommand: resolvedSubcommand
       }
-    });
+    }, printLine2);
   }
 };
 async function runNodeCli(argv = process.argv.slice(2)) {
@@ -3612,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) {
-    renderNoCommandHelp(printLine);
-    process.exitCode = 1;
-    return;
+    const noCommandError = createNoCommandCliError();
+    if (rawMergedFlags.format !== "json") {
+      renderNoCommandHelp(printLine);
+    }
+    throw noCommandError;
   }
   if (helpRequested) {
     if (helpTarget) {
@@ -3672,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;
   }
@@ -3683,4 +4023,4 @@ export {
   hasFlagBeforeTerminator
 };
 
-//# debugId=7726AE527215959664756E2164756E21
+//# debugId=CA11CB4ECD0D26E464756E2164756E21