wp-typia 0.24.7 → 0.24.9

package/README.md

@@ -15,6 +15,12 @@ The published package executes through the Node-first CLI runtime. `bunx` is a
 supported package-runner invocation, not a requirement for npm-installed
 commands.
 
+Generated scaffolds target WordPress 7.0 for `Tested up to` plugin headers by
+default. Pass `--wp-version 6.9` to restore the legacy 6.9 scaffold target; the
+`Requires at least` header remains tied to the selected feature hard floor. Use
+`wp-typia doctor --wp-version-check` to validate workspace headers against
+generated block, ability, and AI feature metadata.
+
 Extend an existing workspace with:
 
 - `wp-typia add block counter-card --template basic`

package/dist/cli.js

@@ -21,7 +21,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "wp-typia",
-    version: "0.24.7",
+    version: "0.24.9",
     description: "Canonical CLI package for wp-typia scaffolding and project workflows",
     packageManager: "bun@1.3.11",
     type: "module",
@@ -77,7 +77,7 @@ var init_package = __esm(() => {
     dependencies: {
       "@gunshi/plugin-completion": "0.32.0",
       "@wp-typia/api-client": "^0.4.6",
-      "@wp-typia/project-tools": "0.24.6",
+      "@wp-typia/project-tools": "0.24.7",
       gunshi: "0.32.0",
       zod: "4.3.6"
     },
@@ -1287,7 +1287,8 @@ var init_pattern = __esm(() => {
       const catalogTitle = rawCatalogTitle;
       const tags = normalizePatternTagFlags(context.flags.tags, context.flags.tag);
       const thumbnailUrl = rawThumbnailUrl;
-      if (context.flags.tag !== undefined && context.flags.format !== "json") {
+      const legacyTagWarning = context.flags.tag !== undefined ? LEGACY_TAG_FLAG_WARNING : undefined;
+      if (legacyTagWarning && context.flags.format !== "json") {
         context.warnLine(LEGACY_TAG_FLAG_WARNING);
       }
       return {
@@ -1313,6 +1314,7 @@ var init_pattern = __esm(() => {
           patternScope: result.patternScope,
           ...result.sectionRole ? { sectionRole: result.sectionRole } : {}
         }),
+        getWarnings: () => context.flags.format === "json" && legacyTagWarning ? [legacyTagWarning] : undefined,
         warnLine: context.warnLine
       };
     },
@@ -2446,6 +2448,7 @@ function isInteractiveTerminal({
 }
 
 // src/runtime-bridge-add.ts
+import { HOOKED_BLOCK_POSITION_IDS } from "@wp-typia/project-tools/hooked-blocks";
 import {
   CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES16,
   createCliDiagnosticCodeError as createCliDiagnosticCodeError12
@@ -2498,6 +2501,29 @@ async function executePlannedAddKind(kind, executionContext, context) {
 function contextAllowsInteractivePrompts(flags) {
   return flags.format !== "json";
 }
+function shouldPromptForRequiredAddField(flags, fieldName) {
+  const value = flags[fieldName];
+  return value === undefined || value === null || typeof value === "string" && value.trim().length === 0;
+}
+async function promptForRequiredAddFields(options) {
+  const requiredFields = REQUIRED_FIELD_PROMPTS_BY_ADD_KIND[options.kind] ?? [];
+  for (const fieldName of requiredFields) {
+    if (!shouldPromptForRequiredAddField(options.flags, fieldName)) {
+      continue;
+    }
+    const label = REQUIRED_FIELD_PROMPT_LABELS[fieldName];
+    const fieldPrompt = await options.getOrCreatePrompt();
+    if (fieldName === "position") {
+      options.flags[fieldName] = await fieldPrompt.select(label, HOOKED_BLOCK_POSITION_IDS.map((position) => ({
+        hint: `Insert relative to the anchor block as ${position}`,
+        label: position,
+        value: position
+      })), 2);
+      continue;
+    }
+    options.flags[fieldName] = await fieldPrompt.text(label, "", (value) => value.trim().length > 0 ? true : `${label} is required.`);
+  }
+}
 async function executeAddCommand({
   cwd,
   emitOutput = true,
@@ -2511,7 +2537,8 @@ async function executeAddCommand({
   warnLine = console.warn
 }) {
   let activePrompt;
-  const dryRun = Boolean(flags["dry-run"]);
+  const resolvedFlags = { ...flags };
+  const dryRun = Boolean(resolvedFlags["dry-run"]);
   try {
     const addRuntime = await loadCliAddRuntime();
     const isInteractiveSession = interactive ?? isInteractiveTerminal();
@@ -2525,15 +2552,13 @@ async function executeAddCommand({
     };
     let resolvedKind = kind;
     let resolvedName = name;
-    let promptedForKind = false;
-    if (!resolvedKind && isInteractiveSession && contextAllowsInteractivePrompts(flags)) {
+    if (!resolvedKind && isInteractiveSession && contextAllowsInteractivePrompts(resolvedFlags)) {
       const kindPrompt = await getOrCreatePrompt();
       resolvedKind = await kindPrompt.select("Select what to add", getAddKindOptions().map((option) => ({
         hint: option.description,
         label: option.name,
         value: option.value
       })), 1);
-      promptedForKind = true;
     }
     if (!resolvedKind) {
       if (shouldPrintMissingAddKindHelp({ emitOutput })) {
@@ -2544,17 +2569,24 @@ async function executeAddCommand({
     if (!isAddKindId(resolvedKind)) {
       throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES16.INVALID_COMMAND, `Unknown add kind "${resolvedKind}". Expected one of: ${formatAddKindList()}.`);
     }
-    if (!resolvedName && promptedForKind) {
+    if (!resolvedName && isInteractiveSession && contextAllowsInteractivePrompts(resolvedFlags)) {
       const namePrompt = await getOrCreatePrompt();
       resolvedName = await namePrompt.text(getAddNameLabel(resolvedKind), "", (value) => value.trim().length > 0 ? true : `${getAddNameLabel(resolvedKind)} is required.`);
     }
+    if (isInteractiveSession && contextAllowsInteractivePrompts(resolvedFlags)) {
+      await promptForRequiredAddFields({
+        flags: resolvedFlags,
+        getOrCreatePrompt,
+        kind: resolvedKind
+      });
+    }
     if (dryRun && !supportsAddKindDryRun(resolvedKind)) {
       throw createCliDiagnosticCodeError12(CLI_DIAGNOSTIC_CODES16.INVALID_ARGUMENT, `\`wp-typia add ${resolvedKind}\` does not support \`--dry-run\` yet.`);
     }
     const executionContext = {
       addRuntime,
       cwd,
-      flags,
+      flags: resolvedFlags,
       getOrCreatePrompt,
       isInteractiveSession,
       name: resolvedName,
@@ -2578,13 +2610,29 @@ async function executeAddCommand({
     }
   }
 }
-var loadCliAddRuntime = () => import("@wp-typia/project-tools/cli-add"), loadCliPromptRuntime = () => import("@wp-typia/project-tools/cli-prompt");
+var loadCliAddRuntime = () => import("@wp-typia/project-tools/cli-add"), loadCliPromptRuntime = () => import("@wp-typia/project-tools/cli-prompt"), REQUIRED_FIELD_PROMPTS_BY_ADD_KIND, REQUIRED_FIELD_PROMPT_LABELS;
 var init_runtime_bridge_add = __esm(() => {
   init_add_kind_registry();
   init_cli_error_messages();
   init_runtime_bridge_add_dry_run();
   init_runtime_bridge_output();
   init_runtime_bridge_shared();
+  REQUIRED_FIELD_PROMPTS_BY_ADD_KIND = {
+    "core-variation": ["block"],
+    "hooked-block": ["anchor", "position"],
+    "post-meta": ["post-type"],
+    style: ["block"],
+    transform: ["from", "to"],
+    variation: ["block"]
+  };
+  REQUIRED_FIELD_PROMPT_LABELS = {
+    anchor: "Anchor block",
+    block: "Target block",
+    from: "Source block",
+    position: "Hook position",
+    "post-type": "Post type",
+    to: "Target block"
+  };
 });
 
 // src/runtime-bridge-create.ts
@@ -2659,6 +2707,7 @@ async function executeCreateCommand({
       withMigrationUi: flags["with-migration-ui"],
       withTestPreset: flags["with-test-preset"],
       withWpEnv: flags["with-wp-env"],
+      wpVersion: readOptionalLooseStringFlag(flags, "wp-version"),
       yes: effectiveYes
     });
     const payload = flow.dryRun && flow.plan ? buildCreateDryRunPayload({
@@ -2716,7 +2765,10 @@ var init_runtime_bridge_create = __esm(() => {
 async function executeDoctorCommand(cwd, options = {}) {
   try {
     const { runDoctor } = await loadCliDoctorRuntime();
-    await runDoctor(cwd, { exitPolicy: options.exitPolicy });
+    await runDoctor(cwd, {
+      exitPolicy: options.exitPolicy,
+      wordpressVersionCheck: options.wordpressVersionCheck
+    });
   } catch (error) {
     throw await wrapCliCommandError("doctor", error);
   }
@@ -2906,13 +2958,13 @@ import {
   CLI_DIAGNOSTIC_CODES as CLI_DIAGNOSTIC_CODES19,
   createCliCommandError as createCliCommandError8
 } from "@wp-typia/project-tools/cli-diagnostics";
-async function renderPortableCliDoctorJson(cwd, exitPolicy, printLine) {
+async function renderPortableCliDoctorJson(cwd, exitPolicy, wordpressVersionCheck, printLine) {
   const {
     createDoctorRunSummary,
     getDoctorChecks,
     getDoctorExitFailureDetailLines
   } = await import("@wp-typia/project-tools/cli-doctor");
-  const checks = await getDoctorChecks(cwd);
+  const checks = await getDoctorChecks(cwd, { wordpressVersionCheck });
   const summary = createDoctorRunSummary(checks, { exitPolicy });
   printLine(JSON.stringify({
     checks,
@@ -2933,11 +2985,12 @@ async function dispatchPortableCliDoctor({
   printLine
 }) {
   const exitPolicy = mergedFlags["workspace-only"] ? "workspace-only" : "strict";
+  const wordpressVersionCheck = Boolean(mergedFlags["wp-version-check"]);
   if (mergedFlags.format === "json") {
-    await renderPortableCliDoctorJson(cwd, exitPolicy, printLine);
+    await renderPortableCliDoctorJson(cwd, exitPolicy, wordpressVersionCheck, printLine);
     return;
   }
-  await executeDoctorCommand(cwd, { exitPolicy });
+  await executeDoctorCommand(cwd, { exitPolicy, wordpressVersionCheck });
 }
 var init_doctor = __esm(() => {
   init_runtime_bridge();
@@ -3566,6 +3619,10 @@ var CREATE_OPTION_METADATA = {
     description: "Include a local wp-env preset.",
     type: "boolean"
   },
+  "wp-version": {
+    description: "WordPress target for generated plugin headers; one of 6.9 or 7.0. Defaults to 7.0.",
+    type: "string"
+  },
   yes: {
     argumentKind: "flag",
     description: "Accept defaults without prompt fallbacks.",
@@ -3583,6 +3640,11 @@ var DOCTOR_OPTION_METADATA = {
     argumentKind: "flag",
     description: "Fail only on workspace-scoped doctor checks; environment/runtime failures remain advisory in JSON summaries.",
     type: "boolean"
+  },
+  "wp-version-check": {
+    argumentKind: "flag",
+    description: "Check generated WordPress feature floors against plugin bootstrap headers and the current scaffold target.",
+    type: "boolean"
   }
 };
 // src/command-options/global.ts
@@ -4314,8 +4376,10 @@ function renderNoCommandHelp(printLine) {
   renderGeneralHelp(printLine);
 }
 function renderUnknownHelpTarget(printLine, target) {
+  const suggestion = suggestTopLevelCommandTypo(target);
   printBlock(printLine, [
     `Unknown help target "${target}".`,
+    ...suggestion ? [`Did you mean "${suggestion}"? Run wp-typia ${suggestion} --help.`] : [],
     `Supported commands: ${WP_TYPIA_PORTABLE_CLI_TOP_LEVEL_COMMAND_NAMES.join(", ")}.`,
     "Run wp-typia --help for general usage."
   ]);
@@ -4343,9 +4407,9 @@ var PORTABLE_CLI_COMMAND_HELP_CONFIG = {
   },
   doctor: {
     bodyLines: [
-      "Runs read-only environment readiness checks. Official wp-typia workspace roots also get inventory, source-tree drift, iframe/API v3 compatibility, and shared convention checks. Use --workspace-only for CI gates that should fail only on workspace-scoped checks while keeping environment failures advisory."
+      "Runs read-only environment readiness checks. Official wp-typia workspace roots also get inventory, source-tree drift, iframe/API v3 compatibility, and shared convention checks. Use --workspace-only for CI gates that should fail only on workspace-scoped checks while keeping environment failures advisory. Use --wp-version-check to compare generated feature floors with plugin bootstrap headers."
     ],
-    heading: "Usage: wp-typia doctor [--format json] [--workspace-only]",
+    heading: "Usage: wp-typia doctor [--format json] [--workspace-only] [--wp-version-check]",
     optionMetadata: DOCTOR_OPTION_METADATA
   },
   mcp: {
@@ -5945,4 +6009,4 @@ export {
   runGunshiCli
 };
 
-//# debugId=23F1B8999F88E0E464756E2164756E21
+//# debugId=DA4A175C5AECCFDA64756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-typia",
-  "version": "0.24.7",
+  "version": "0.24.9",
   "description": "Canonical CLI package for wp-typia scaffolding and project workflows",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -56,7 +56,7 @@
   "dependencies": {
     "@gunshi/plugin-completion": "0.32.0",
     "@wp-typia/api-client": "^0.4.6",
-    "@wp-typia/project-tools": "0.24.6",
+    "@wp-typia/project-tools": "0.24.7",
     "gunshi": "0.32.0",
     "zod": "4.3.6"
   },