@wp-typia/project-tools 0.24.6 → 0.24.8

package/dist/runtime/cli/cli-core.d.ts

@@ -30,7 +30,7 @@
  * `getTemplateSelectOptions`, `listTemplates`, and `isBuiltInTemplateId` for
  * template inspection flows.
  */
-export { createDoctorRunSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, runDoctor, type DoctorCheck, type DoctorCheckScope, type DoctorExitPolicy, type DoctorFailureSummary, type DoctorRunSummary, } from "../doctor/cli-doctor.js";
+export { createDoctorRunSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, runDoctor, type DoctorCheck, type DoctorCheckScope, type DoctorExitPolicy, type DoctorFailureSummary, type DoctorRunSummary, type GetDoctorChecksOptions, } from "../doctor/cli-doctor.js";
 export { createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODE_METADATA, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatDoctorCheckLine, formatDoctorSummaryLine, getCliDiagnosticCodeMetadata, getDoctorFailureDetailLines, getFailingDoctorChecks, isCliDiagnosticError, } from "./cli-diagnostics.js";
 export type { CliDiagnosticCode, CliDiagnosticCodeError, CliDiagnosticMessage, } from "./cli-diagnostics.js";
 export { EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, PATTERN_CATALOG_SCOPE_IDS, runAddAdminViewCommand, runAddAbilityCommand, runAddBindingSourceCommand, runAddAiFeatureCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, seedWorkspaceMigrationProject, } from "../add/cli-add.js";

package/dist/runtime/cli/cli-help.js

@@ -10,13 +10,13 @@ import { TEMPLATE_IDS } from "../templates/template-registry.js";
  */
 export function formatHelpText() {
     return `Usage:
-  wp-typia create <project-dir> [--template <basic|interactivity>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template workspace] [--profile <plugin-qa>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template query-loop] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--query-post-type <post-type>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template <./path|github:owner/repo/path[#ref]>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template <npm-package>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template persistence] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template compound] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
+  wp-typia create <project-dir> [--template <basic|interactivity>] [--wp-version <6.9|7.0>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
+  wp-typia create <project-dir> [--template workspace] [--wp-version <6.9|7.0>] [--profile <plugin-qa>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
+  wp-typia create <project-dir> [--template query-loop] [--wp-version <6.9|7.0>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--query-post-type <post-type>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
+  wp-typia create <project-dir> [--template <./path|github:owner/repo/path[#ref]>] [--wp-version <6.9|7.0>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
+  wp-typia create <project-dir> [--template <npm-package>] [--wp-version <6.9|7.0>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
+  wp-typia create <project-dir> [--template persistence] [--wp-version <6.9|7.0>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
+  wp-typia create <project-dir> [--template compound] [--wp-version <6.9|7.0>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
   wp-typia <project-dir> [create flags...]
   wp-typia init [project-dir] [--apply] [--package-manager <id>]
   wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>]
@@ -39,7 +39,7 @@ export function formatHelpText() {
   wp-typia migrate <init|snapshot|diff|scaffold|verify|doctor|fixtures|fuzz> [...]
   wp-typia templates list
   wp-typia templates inspect <id>
-  wp-typia doctor
+  wp-typia doctor [--wp-version-check]
   wp-typia mcp <list|sync>
   wp-typia skills <list|sync>
   wp-typia completions <bash|zsh|fish|powershell>
@@ -55,6 +55,7 @@ Notes:
   \`wp-typia init\` previews the minimum retrofit sync surface by default; rerun with \`--apply\` to write package.json updates and generated helper scripts.
   Use \`--template workspace\` as shorthand for \`@wp-typia/create-workspace-template\`, the official empty workspace scaffold behind \`wp-typia add ...\`.
   Use \`--profile plugin-qa\` with \`--template workspace\` when a plugin needs local wp-env smoke checks, \`.env.example\`, and release zip scripts from day one; omit it for the minimal workspace shell.
+  Use \`--wp-version 6.9\` to keep legacy \`Tested up to: 6.9\` headers; new scaffolds default to WordPress 7.0 while keeping \`Requires at least\` at the selected feature floor.
   Interactive add flows let you choose a template when \`--template\` is omitted; non-interactive runs default to \`basic\`.
   Unknown \`core/*\` targets for \`add core-variation\` warn instead of failing so newer WordPress core blocks remain scaffoldable; third-party namespaces are allowed without local discovery.
   \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`.
@@ -77,7 +78,7 @@ Notes:
   \`add ai-feature\` scaffolds server-owned AI feature endpoints under \`src/ai-features/\` and PHP route glue under \`inc/ai-features/\`.
   \`add editor-plugin\` scaffolds a document-level editor extension under \`src/editor-plugins/\`; legacy aliases \`PluginSidebar\` and \`PluginDocumentSettingPanel\` resolve to \`sidebar\` and \`document-setting-panel\`.
   \`add hooked-block\` patches an existing workspace block's \`block.json\` \`blockHooks\` metadata.
-  \`wp-typia doctor\` always checks environment readiness and reports when it only ran environment-level diagnostics; official workspace roots also get inventory, source-tree drift, shared convention checks, and iframe/API v3 compatibility checks.
+  \`wp-typia doctor\` always checks environment readiness and reports when it only ran environment-level diagnostics; official workspace roots also get inventory, source-tree drift, shared convention checks, and iframe/API v3 compatibility checks. Pass \`--wp-version-check\` to compare generated feature floors such as block supports, blockHooks, abilities, and AI feature metadata with plugin bootstrap compatibility headers.
   \`wp-typia init\` previews or applies the minimum sync/doctor/migration adoption layer for supported existing layouts; pass \`--package-manager <id>\` to pin emitted scripts and next steps.
   \`wp-typia migrate doctor --all\` checks migration target alignment, snapshots, fixtures, and generated migration artifacts.
   \`migrate\` is the canonical migration command; \`migrations\` is no longer supported.`;

package/dist/runtime/doctor/cli-doctor-wordpress-version.d.ts

@@ -0,0 +1,15 @@
+import type { DoctorCheck } from "./cli-doctor.js";
+import type { WorkspaceInventory } from "../workspace/workspace-inventory.js";
+import type { WorkspaceProject } from "../workspace/workspace-project.js";
+/** Options for opt-in WordPress version compatibility doctor checks. */
+export interface WorkspaceWordPressVersionDoctorCheckOptions {
+    /** WordPress target used for `Tested up to` warnings. Defaults to the scaffold target. */
+    targetVersion?: string;
+}
+/**
+ * Collect opt-in WordPress feature floor checks for an official workspace.
+ *
+ * These checks compare generated feature metadata against plugin bootstrap
+ * headers without changing the default doctor output shape.
+ */
+export declare function getWorkspaceWordPressVersionDoctorChecks(workspace: WorkspaceProject, inventory: WorkspaceInventory, options?: WorkspaceWordPressVersionDoctorCheckOptions): DoctorCheck[];

package/dist/runtime/doctor/cli-doctor-wordpress-version.js

@@ -0,0 +1,239 @@
+import fs from "node:fs";
+import path from "node:path";
+import { parseScaffoldBlockMetadata } from "@wp-typia/block-runtime/blocks";
+import { WORDPRESS_BLOCK_API_COMPATIBILITY } from "@wp-typia/block-types/blocks/compatibility";
+import { createDoctorCheck, resolveWorkspaceBootstrapPath, } from "./cli-doctor-workspace-shared.js";
+import { readJsonFileSync } from "../shared/json-utils.js";
+import { compareVersionFloors, pickHigherVersionFloor, } from "../shared/version-floor.js";
+import { DEFAULT_SCAFFOLD_WORDPRESS_TARGET_VERSION } from "../templates/scaffold-compatibility.js";
+const WORDPRESS_VERSION_CHECK_CODES = {
+    featureMinimum: "wp-typia.workspace.wordpress.feature-minimum",
+    testedTarget: "wp-typia.workspace.wordpress.tested-target",
+};
+function isEnabledMetadataValue(value) {
+    return value !== undefined && value !== false && value !== null;
+}
+function getNestedMetadataValue(object, key) {
+    if (!object) {
+        return undefined;
+    }
+    if (Object.prototype.hasOwnProperty.call(object, key)) {
+        return object[key];
+    }
+    return key
+        .split(".")
+        .reduce((current, segment) => {
+        if (current === null ||
+            typeof current !== "object" ||
+            Array.isArray(current)) {
+            return undefined;
+        }
+        const record = current;
+        return Object.prototype.hasOwnProperty.call(record, segment)
+            ? record[segment]
+            : undefined;
+    }, object);
+}
+function getBootstrapHeaderValue(source, headerName) {
+    const escapedHeaderName = headerName.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+    const pattern = new RegExp(`^\\s*\\*\\s*${escapedHeaderName}:\\s*([^\\r\\n]*)`, "mu");
+    const match = pattern.exec(source);
+    return match?.[1]?.trim();
+}
+function readBootstrapHeaderVersions(workspace) {
+    const bootstrapPath = resolveWorkspaceBootstrapPath(workspace.projectDir, workspace.packageName);
+    if (!fs.existsSync(bootstrapPath)) {
+        return {};
+    }
+    const source = fs.readFileSync(bootstrapPath, "utf8");
+    return {
+        requiresAtLeast: getBootstrapHeaderValue(source, "Requires at least"),
+        testedUpTo: getBootstrapHeaderValue(source, "Tested up to"),
+    };
+}
+function pushRequirement(requirements, label, version) {
+    requirements.push({
+        label,
+        version,
+    });
+}
+function pushBlockApiRequirement(requirements, labelPrefix, entry) {
+    pushRequirement(requirements, `${labelPrefix} ${entry.label}`, entry.since);
+}
+function readExistingTextFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return undefined;
+    }
+    return fs.readFileSync(filePath, "utf8");
+}
+function collectBlockMetadataRequirements(workspace, inventory) {
+    const issues = [];
+    const requirements = [];
+    for (const block of inventory.blocks) {
+        const blockJsonRelativePath = path.join("src", "blocks", block.slug, "block.json");
+        const blockJsonPath = path.join(workspace.projectDir, blockJsonRelativePath);
+        if (!fs.existsSync(blockJsonPath)) {
+            continue;
+        }
+        let blockJson;
+        try {
+            blockJson = parseScaffoldBlockMetadata(readJsonFileSync(blockJsonPath, {
+                context: "workspace block metadata",
+            }));
+        }
+        catch (error) {
+            issues.push(`${blockJsonRelativePath}: ${error instanceof Error ? error.message : String(error)}`);
+            continue;
+        }
+        for (const [feature, entry] of Object.entries(WORDPRESS_BLOCK_API_COMPATIBILITY.blockSupports)) {
+            if (isEnabledMetadataValue(getNestedMetadataValue(blockJson.supports, feature))) {
+                pushBlockApiRequirement(requirements, `Block ${block.slug}`, entry);
+            }
+        }
+        for (const [feature, entry] of Object.entries(WORDPRESS_BLOCK_API_COMPATIBILITY.blockMetadata)) {
+            if (isEnabledMetadataValue(getNestedMetadataValue(blockJson, feature))) {
+                pushBlockApiRequirement(requirements, `Block ${block.slug}`, entry);
+            }
+        }
+        for (const [feature, entry] of Object.entries(WORDPRESS_BLOCK_API_COMPATIBILITY.blockBindings)) {
+            if (entry.runtime.includes("block-json") &&
+                isEnabledMetadataValue(getNestedMetadataValue(blockJson, feature))) {
+                pushBlockApiRequirement(requirements, `Block ${block.slug}`, entry);
+            }
+        }
+    }
+    return {
+        issues,
+        requirements,
+    };
+}
+function collectInventoryCompatibilityRequirements(inventory) {
+    const requirements = [];
+    for (const ability of inventory.abilities) {
+        const wordpressMinimum = ability.compatibility?.hardMinimums.wordpress;
+        if (wordpressMinimum) {
+            requirements.push({
+                label: `Ability ${ability.slug} compatibility metadata`,
+                version: wordpressMinimum,
+            });
+        }
+    }
+    for (const aiFeature of inventory.aiFeatures) {
+        const wordpressMinimum = aiFeature.compatibility?.hardMinimums.wordpress;
+        if (wordpressMinimum) {
+            requirements.push({
+                label: `AI feature ${aiFeature.slug} compatibility metadata`,
+                version: wordpressMinimum,
+            });
+        }
+    }
+    return {
+        issues: [],
+        requirements,
+    };
+}
+function collectBindingSourceRequirements(workspace, inventory) {
+    const requirements = [];
+    const bindingEntries = WORDPRESS_BLOCK_API_COMPATIBILITY.blockBindings;
+    for (const bindingSource of inventory.bindingSources) {
+        pushBlockApiRequirement(requirements, `Binding source ${bindingSource.slug}`, bindingEntries.serverRegistration);
+        pushBlockApiRequirement(requirements, `Binding source ${bindingSource.slug}`, bindingEntries.editorRegistration);
+        const editorFilePath = path.join(workspace.projectDir, bindingSource.editorFile);
+        if (readExistingTextFile(editorFilePath)?.includes("getFieldsList")) {
+            pushBlockApiRequirement(requirements, `Binding source ${bindingSource.slug}`, bindingEntries.editorFieldsList);
+        }
+        const serverFilePath = path.join(workspace.projectDir, bindingSource.serverFile);
+        if (readExistingTextFile(serverFilePath)?.includes("block_bindings_supported_attributes_")) {
+            pushBlockApiRequirement(requirements, `Binding source ${bindingSource.slug}`, bindingEntries.supportedAttributesFilter);
+        }
+    }
+    return {
+        issues: [],
+        requirements,
+    };
+}
+function collectWordPressVersionRequirements(workspace, inventory) {
+    const blockRequirements = collectBlockMetadataRequirements(workspace, inventory);
+    const bindingRequirements = collectBindingSourceRequirements(workspace, inventory);
+    const inventoryRequirements = collectInventoryCompatibilityRequirements(inventory);
+    return {
+        issues: [
+            ...blockRequirements.issues,
+            ...bindingRequirements.issues,
+            ...inventoryRequirements.issues,
+        ],
+        requirements: [
+            ...blockRequirements.requirements,
+            ...bindingRequirements.requirements,
+            ...inventoryRequirements.requirements,
+        ],
+    };
+}
+function pickHighestRequirementFloor(requirements, issues) {
+    let highest;
+    for (const requirement of requirements) {
+        try {
+            highest = pickHigherVersionFloor(highest, requirement.version);
+        }
+        catch {
+            issues.push(`${requirement.label} declares invalid WordPress version floor "${requirement.version}".`);
+        }
+    }
+    return highest;
+}
+function formatRequirementSummary(requirements, floor) {
+    const labels = requirements
+        .filter((requirement) => requirement.version === floor)
+        .map((requirement) => requirement.label);
+    return labels.length > 0 ? labels.join(", ") : "generated workspace features";
+}
+function createFeatureMinimumCheck(workspace, inventory, headers) {
+    const { issues, requirements } = collectWordPressVersionRequirements(workspace, inventory);
+    const highestFloor = pickHighestRequirementFloor(requirements, issues);
+    if (issues.length > 0) {
+        return createDoctorCheck("WordPress feature minimum", "fail", issues.join("; "), WORDPRESS_VERSION_CHECK_CODES.featureMinimum);
+    }
+    if (!highestFloor) {
+        return createDoctorCheck("WordPress feature minimum", "pass", "No generated workspace features declare an additional WordPress hard floor.", WORDPRESS_VERSION_CHECK_CODES.featureMinimum);
+    }
+    if (!headers.requiresAtLeast) {
+        return createDoctorCheck("WordPress feature minimum", "fail", `Plugin bootstrap is missing a Requires at least header but generated features require WordPress ${highestFloor}.`, WORDPRESS_VERSION_CHECK_CODES.featureMinimum);
+    }
+    try {
+        if (compareVersionFloors(headers.requiresAtLeast, highestFloor) < 0) {
+            return createDoctorCheck("WordPress feature minimum", "fail", `Requires at least ${headers.requiresAtLeast} is below generated feature floor ${highestFloor} (${formatRequirementSummary(requirements, highestFloor)}).`, WORDPRESS_VERSION_CHECK_CODES.featureMinimum);
+        }
+    }
+    catch {
+        return createDoctorCheck("WordPress feature minimum", "fail", `Plugin bootstrap Requires at least header "${headers.requiresAtLeast}" is not a dotted numeric version.`, WORDPRESS_VERSION_CHECK_CODES.featureMinimum);
+    }
+    return createDoctorCheck("WordPress feature minimum", "pass", `Requires at least ${headers.requiresAtLeast} covers generated feature floor ${highestFloor} (${formatRequirementSummary(requirements, highestFloor)}).`, WORDPRESS_VERSION_CHECK_CODES.featureMinimum);
+}
+function createTestedTargetCheck(headers, targetVersion) {
+    if (!headers.testedUpTo) {
+        return createDoctorCheck("WordPress tested target", "fail", `Plugin bootstrap is missing a Tested up to header; expected ${targetVersion} or newer.`, WORDPRESS_VERSION_CHECK_CODES.testedTarget);
+    }
+    try {
+        if (compareVersionFloors(headers.testedUpTo, targetVersion) < 0) {
+            return createDoctorCheck("WordPress tested target", "warn", `Tested up to ${headers.testedUpTo} is below the selected WordPress target ${targetVersion}.`, WORDPRESS_VERSION_CHECK_CODES.testedTarget);
+        }
+    }
+    catch {
+        return createDoctorCheck("WordPress tested target", "fail", `Plugin bootstrap Tested up to header "${headers.testedUpTo}" is not a dotted numeric version.`, WORDPRESS_VERSION_CHECK_CODES.testedTarget);
+    }
+    return createDoctorCheck("WordPress tested target", "pass", `Tested up to ${headers.testedUpTo} covers the selected WordPress target ${targetVersion}.`, WORDPRESS_VERSION_CHECK_CODES.testedTarget);
+}
+/**
+ * Collect opt-in WordPress feature floor checks for an official workspace.
+ *
+ * These checks compare generated feature metadata against plugin bootstrap
+ * headers without changing the default doctor output shape.
+ */
+export function getWorkspaceWordPressVersionDoctorChecks(workspace, inventory, options = {}) {
+    const targetVersion = options.targetVersion ?? DEFAULT_SCAFFOLD_WORDPRESS_TARGET_VERSION;
+    const headers = readBootstrapHeaderVersions(workspace);
+    return [
+        createFeatureMinimumCheck(workspace, inventory, headers),
+        createTestedTargetCheck(headers, targetVersion),
+    ];
+}

package/dist/runtime/doctor/cli-doctor-workspace.d.ts

@@ -1,4 +1,9 @@
 import type { DoctorCheck } from "./cli-doctor.js";
+/** Options used when collecting workspace-scoped doctor rows. */
+export interface WorkspaceDoctorChecksOptions {
+    /** Include opt-in WordPress feature floor and plugin header checks. */
+    wordpressVersionCheck?: boolean;
+}
 /**
  * Collect workspace-scoped doctor checks for the given working directory.
  *
@@ -9,10 +14,12 @@ import type { DoctorCheck } from "./cli-doctor.js";
  * failing rows are returned early and the remaining checks are skipped.
  * When an official workspace is detected, a passing "Doctor scope" row is
  * emitted first so the remaining package metadata, inventory, source-tree
- * drift, and optional migration hint rows are clearly framed as workspace
- * diagnostics for that run.
+ * drift, optional WordPress version checks, and optional migration hint rows
+ * are clearly framed as workspace diagnostics for that run.
  *
  * @param cwd Working directory expected to host an official workspace.
+ * @param options Optional feature gates for additional workspace doctor rows.
+ * @param options.wordpressVersionCheck Include WordPress feature floor and plugin header checks.
  * @returns Ordered workspace check rows ready for CLI rendering.
  */
-export declare function getWorkspaceDoctorChecks(cwd: string): Promise<DoctorCheck[]>;
+export declare function getWorkspaceDoctorChecks(cwd: string, options?: WorkspaceDoctorChecksOptions): Promise<DoctorCheck[]>;

package/dist/runtime/doctor/cli-doctor-workspace.js

@@ -1,6 +1,7 @@
 import { getWorkspaceBindingDoctorChecks, } from "./cli-doctor-workspace-bindings.js";
 import { getWorkspaceBlockDoctorChecks, } from "./cli-doctor-workspace-blocks.js";
 import { getWorkspaceFeatureDoctorChecks, } from "./cli-doctor-workspace-features.js";
+import { getWorkspaceWordPressVersionDoctorChecks, } from "./cli-doctor-wordpress-version.js";
 import { getMigrationWorkspaceHintCheck, getWorkspacePackageMetadataCheck, prepareWorkspacePackageDoctorSnapshot, } from "./cli-doctor-workspace-package.js";
 import { createDoctorCheck, createDoctorScopeCheck, } from "./cli-doctor-workspace-shared.js";
 import { readWorkspaceInventoryAsync, } from "../workspace/workspace-inventory.js";
@@ -31,13 +32,15 @@ function formatWorkspaceInventorySummary(inventory) {
  * failing rows are returned early and the remaining checks are skipped.
  * When an official workspace is detected, a passing "Doctor scope" row is
  * emitted first so the remaining package metadata, inventory, source-tree
- * drift, and optional migration hint rows are clearly framed as workspace
- * diagnostics for that run.
+ * drift, optional WordPress version checks, and optional migration hint rows
+ * are clearly framed as workspace diagnostics for that run.
  *
  * @param cwd Working directory expected to host an official workspace.
+ * @param options Optional feature gates for additional workspace doctor rows.
+ * @param options.wordpressVersionCheck Include WordPress feature floor and plugin header checks.
  * @returns Ordered workspace check rows ready for CLI rendering.
  */
-export async function getWorkspaceDoctorChecks(cwd) {
+export async function getWorkspaceDoctorChecks(cwd, options = {}) {
     const checks = [];
     let workspace = null;
     let invalidWorkspaceReason = null;
@@ -85,6 +88,9 @@ export async function getWorkspaceDoctorChecks(cwd) {
         checks.push(...getWorkspaceBlockDoctorChecks(workspace, inventory));
         checks.push(...getWorkspaceBindingDoctorChecks(workspace, inventory));
         checks.push(...getWorkspaceFeatureDoctorChecks(workspace, inventory));
+        if (options.wordpressVersionCheck) {
+            checks.push(...getWorkspaceWordPressVersionDoctorChecks(workspace, inventory));
+        }
         const migrationWorkspaceCheck = getMigrationWorkspaceHintCheck(workspacePackageJson, packageDoctorSnapshot);
         if (migrationWorkspaceCheck) {
             checks.push(migrationWorkspaceCheck);

package/dist/runtime/doctor/cli-doctor.d.ts

@@ -41,10 +41,16 @@ interface RunDoctorOptions {
     exitPolicy?: DoctorExitPolicy;
     renderLine?: (check: DoctorCheck) => void;
     renderSummaryLine?: (summaryLine: string) => void;
+    wordpressVersionCheck?: boolean;
 }
 interface DoctorSummaryOptions {
     exitPolicy?: DoctorExitPolicy;
 }
+/** Options used when collecting doctor checks before rendering. */
+export interface GetDoctorChecksOptions {
+    /** Include opt-in WordPress feature floor and plugin header checks. */
+    wordpressVersionCheck?: boolean;
+}
 /**
  * Collect all runtime doctor checks for the current environment.
  *
@@ -54,9 +60,11 @@ interface DoctorSummaryOptions {
  * patterns, bindings, and optional migration hints) in display order.
  *
  * @param cwd Working directory to validate for writability.
+ * @param options Optional feature gates for additional doctor rows.
+ * @param options.wordpressVersionCheck Include WordPress feature floor and plugin header checks.
  * @returns Ordered doctor check rows ready for CLI rendering.
  */
-export declare function getDoctorChecks(cwd: string): Promise<DoctorCheck[]>;
+export declare function getDoctorChecks(cwd: string, options?: GetDoctorChecksOptions): Promise<DoctorCheck[]>;
 /**
  * Return failed rows that contribute to the process exit code for one policy.
  */
@@ -83,6 +91,7 @@ export declare function createDoctorRunSummary(checks: readonly DoctorCheck[], o
  * @param options.exitPolicy Policy deciding which failed checks contribute to the process exit code.
  * @param options.renderLine Optional renderer for each check row. Defaults to the stdout line printer.
  * @param options.renderSummaryLine Optional renderer for the summary row. Defaults to the stdout line printer unless a custom `renderLine` suppresses implicit summary output.
+ * @param options.wordpressVersionCheck Include WordPress feature floor and plugin header checks.
  * @returns The completed list of doctor checks.
  * @throws {Error} When one or more failed checks contribute to the exit code under the active policy.
  */

package/dist/runtime/doctor/cli-doctor.js

@@ -46,12 +46,16 @@ function toFailureSummary(check, severity) {
  * patterns, bindings, and optional migration hints) in display order.
  *
  * @param cwd Working directory to validate for writability.
+ * @param options Optional feature gates for additional doctor rows.
+ * @param options.wordpressVersionCheck Include WordPress feature floor and plugin header checks.
  * @returns Ordered doctor check rows ready for CLI rendering.
  */
-export async function getDoctorChecks(cwd) {
+export async function getDoctorChecks(cwd, options = {}) {
     return [
         ...annotateDoctorChecks(await getEnvironmentDoctorChecks(cwd), "environment"),
-        ...annotateDoctorChecks(await getWorkspaceDoctorChecks(cwd), "workspace"),
+        ...annotateDoctorChecks(await getWorkspaceDoctorChecks(cwd, {
+            wordpressVersionCheck: options.wordpressVersionCheck,
+        }), "workspace"),
     ];
 }
 /**
@@ -103,6 +107,7 @@ export function createDoctorRunSummary(checks, options = {}) {
  * @param options.exitPolicy Policy deciding which failed checks contribute to the process exit code.
  * @param options.renderLine Optional renderer for each check row. Defaults to the stdout line printer.
  * @param options.renderSummaryLine Optional renderer for the summary row. Defaults to the stdout line printer unless a custom `renderLine` suppresses implicit summary output.
+ * @param options.wordpressVersionCheck Include WordPress feature floor and plugin header checks.
  * @returns The completed list of doctor checks.
  * @throws {Error} When one or more failed checks contribute to the exit code under the active policy.
  */
@@ -111,7 +116,9 @@ export async function runDoctor(cwd, options = {}) {
     const renderLine = options.renderLine ?? renderDefaultDoctorCheckLine;
     const renderSummaryLine = options.renderSummaryLine ??
         (options.renderLine ? () => undefined : renderDefaultDoctorSummaryLine);
-    const checks = await getDoctorChecks(cwd);
+    const checks = await getDoctorChecks(cwd, {
+        wordpressVersionCheck: options.wordpressVersionCheck,
+    });
     for (const check of checks) {
         renderLine(check);
     }

package/dist/runtime/index.d.ts

@@ -41,5 +41,5 @@ export type { ExternalTemplateCachePruneOptions, ExternalTemplateCachePruneResul
 export { STALE_TEMP_ROOT_MAX_AGE_MS, WP_TYPIA_TEMP_ROOT_PREFIX, cleanupManagedTempRoot, cleanupStaleTempRoots, createManagedTempRoot, getTrackedTempRoots, } from "./temp-roots.js";
 export { createReadlinePrompt, createDoctorRunSummary, createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatAddHelpText, formatDoctorCheckLine, formatDoctorSummaryLine, formatHelpText, formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, getDoctorFailureDetailLines, getFailingDoctorChecks, getNextSteps, getOptionalOnboarding, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, HOOKED_BLOCK_POSITION_IDS, EDITOR_PLUGIN_SLOT_IDS, isCliDiagnosticError, runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
 export { extractPatternSectionRoleMatches, extractPatternSectionRolesFromAttributes, formatPatternCatalogDiagnostics, PATTERN_CATALOG_SCOPE_IDS, PATTERN_SECTION_ROLE_PATTERN, PATTERN_TAG_PATTERN, resolvePatternCatalogContentFile, validatePatternCatalog, } from "./pattern-catalog.js";
-export type { CliDiagnosticCode, CliDiagnosticCodeError, CliDiagnosticMessage, DoctorCheck, DoctorCheckScope, DoctorExitPolicy, DoctorFailureSummary, DoctorRunSummary, EditorPluginSlotId, HookedBlockPositionId, ReadlinePrompt, WorkspaceBlockSelectOption, } from "./cli-core.js";
+export type { CliDiagnosticCode, CliDiagnosticCodeError, CliDiagnosticMessage, DoctorCheck, DoctorCheckScope, DoctorExitPolicy, DoctorFailureSummary, DoctorRunSummary, GetDoctorChecksOptions, EditorPluginSlotId, HookedBlockPositionId, ReadlinePrompt, WorkspaceBlockSelectOption, } from "./cli-core.js";
 export type { PatternCatalogDiagnostic, PatternCatalogDiagnosticCode, PatternCatalogDiagnosticSeverity, PatternCatalogEntry, PatternCatalogScope, PatternCatalogSectionRoleConvention, PatternCatalogSectionRoleMatch, PatternCatalogValidationOptions, PatternCatalogValidationResult, } from "./pattern-catalog.js";

package/dist/runtime/templates/block-generator-service-core.d.ts

@@ -1,7 +1,7 @@
 import { type ApplyBlockInput, type PlanBlockInput, type PlanBlockResult, type RenderBlockInput, type RenderBlockResult, type ValidateBlockInput, type ValidateBlockResult } from "./block-generator-service-spec.js";
 import type { ScaffoldProjectResult } from "./scaffold.js";
 export declare class BlockGeneratorService {
-    plan({ allowExistingDir, alternateRenderTargets, answers, cwd, dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi, withTestPreset, withWpEnv, }: PlanBlockInput): Promise<PlanBlockResult>;
+    plan({ allowExistingDir, alternateRenderTargets, answers, cwd, dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi, withTestPreset, withWpEnv, wpVersion, }: PlanBlockInput): Promise<PlanBlockResult>;
     validate({ plan }: ValidateBlockInput): Promise<ValidateBlockResult>;
     render({ validated }: RenderBlockInput): Promise<RenderBlockResult>;
     apply({ rendered, installDependencies, onProgress, }: ApplyBlockInput): Promise<ScaffoldProjectResult>;

package/dist/runtime/templates/block-generator-service-core.js

@@ -83,7 +83,7 @@ async function runCleanupGroup(label, cleanups) {
     }
 }
 export class BlockGeneratorService {
-    async plan({ allowExistingDir = false, alternateRenderTargets, answers, cwd = process.cwd(), dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall = false, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
+    async plan({ allowExistingDir = false, alternateRenderTargets, answers, cwd = process.cwd(), dataStorageMode, externalLayerId, externalLayerSource, externalLayerSourceLabel, noInstall = false, packageManager, persistencePolicy, projectDir, repositoryReference, templateId, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, wpVersion, }) {
         return {
             spec: createBuiltInBlockSpec({
                 alternateRenderTargets,
@@ -94,6 +94,7 @@ export class BlockGeneratorService {
                 withMigrationUi,
                 withTestPreset,
                 withWpEnv,
+                wpVersion,
             }),
             target: {
                 allowExistingDir,

package/dist/runtime/templates/block-generator-service-spec.d.ts

@@ -3,6 +3,7 @@ import { type AlternateRenderTargetId } from "../add/alternate-render-targets.js
 import { type CompoundInnerBlocksPresetId } from "../add/compound-inner-blocks.js";
 import { type BuiltInTemplateId } from "./template-registry.js";
 import type { InstallDependenciesOptions } from "./scaffold-apply-utils.js";
+import { type ScaffoldWordPressTargetVersion } from "./scaffold-compatibility.js";
 import type { DataStorageMode, PersistencePolicy, ScaffoldAnswers, ScaffoldProgressEvent, ScaffoldTemplateVariables } from "./scaffold.js";
 export interface BlockSpec {
     alternateRenderTargets: readonly AlternateRenderTargetId[];
@@ -42,6 +43,7 @@ export interface BlockSpec {
         withMigrationUi: boolean;
         withTestPreset: boolean;
         withWpEnv: boolean;
+        wpVersion: ScaffoldWordPressTargetVersion;
     };
     template: {
         description: string;
@@ -81,6 +83,7 @@ export interface PlanBlockInput {
     queryPostType?: string;
     withTestPreset?: boolean;
     withWpEnv?: boolean;
+    wpVersion?: ScaffoldWordPressTargetVersion;
 }
 export interface PlanBlockResult {
     spec: BlockSpec;
@@ -114,5 +117,5 @@ export interface ApplyBlockInput {
     installDependencies?: ((options: InstallDependenciesOptions) => Promise<void>) | undefined;
     onProgress?: ((event: ScaffoldProgressEvent) => void | Promise<void>) | undefined;
 }
-export declare function createBuiltInBlockSpec({ alternateRenderTargets, answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi, withTestPreset, withWpEnv, }: Omit<PlanBlockInput, "allowExistingDir" | "cwd" | "noInstall" | "packageManager" | "projectDir" | "variant">): BlockSpec;
+export declare function createBuiltInBlockSpec({ alternateRenderTargets, answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi, withTestPreset, withWpEnv, wpVersion, }: Omit<PlanBlockInput, "allowExistingDir" | "cwd" | "noInstall" | "packageManager" | "projectDir" | "variant">): BlockSpec;
 export declare function buildTemplateVariablesFromBlockSpec(spec: BlockSpec): ScaffoldTemplateVariables;

package/dist/runtime/templates/block-generator-service-spec.js

@@ -5,7 +5,7 @@ import { DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID, getCompoundInnerBlocksPresetDe
 import { getTemplateById, } from "./template-registry.js";
 import { toPascalCase, toSnakeCase, } from "../shared/string-case.js";
 import { buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, } from "./scaffold-identifiers.js";
-import { resolveScaffoldCompatibilityPolicy } from "./scaffold-compatibility.js";
+import { createScaffoldCompatibilityBaseline, DEFAULT_SCAFFOLD_WORDPRESS_TARGET_VERSION, resolveScaffoldCompatibilityPolicy, } from "./scaffold-compatibility.js";
 import { attachScaffoldTemplateVariableGroups } from "./scaffold-template-variable-groups.js";
 function getBuiltInPersistenceSpec({ templateId, dataStorageMode, persistencePolicy, }) {
     if (templateId === "persistence") {
@@ -37,7 +37,7 @@ const DEFAULT_QUERY_LOOP_ALLOWED_CONTROLS = [
     "author",
     "search",
 ];
-export function createBuiltInBlockSpec({ alternateRenderTargets, answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
+export function createBuiltInBlockSpec({ alternateRenderTargets, answers, dataStorageMode, persistencePolicy, templateId, withMigrationUi = false, withTestPreset = false, withWpEnv = false, wpVersion, }) {
     const template = getTemplateById(templateId);
     const metadataDefaults = getBuiltInTemplateMetadataDefaults(templateId);
     const identifiers = resolveScaffoldIdentifiers({
@@ -89,6 +89,7 @@ export function createBuiltInBlockSpec({ alternateRenderTargets, answers, dataSt
             withMigrationUi,
             withTestPreset,
             withWpEnv,
+            wpVersion: wpVersion ?? DEFAULT_SCAFFOLD_WORDPRESS_TARGET_VERSION,
         },
         template: {
             description: template.description,
@@ -123,7 +124,9 @@ export function buildTemplateVariablesFromBlockSpec(spec) {
         ? spec.persistence.persistencePolicy
         : "authenticated";
     const queryVariationNamespace = `${namespace}/${slug}`;
-    const compatibility = resolveScaffoldCompatibilityPolicy([]);
+    const compatibility = resolveScaffoldCompatibilityPolicy([], {
+        baseline: createScaffoldCompatibilityBaseline(spec.runtime.wpVersion),
+    });
     const flatVariables = {
         alternateRenderTargetsCsv: formatAlternateRenderTargets(alternateRenderTargets),
         alternateRenderTargetsJson: JSON.stringify(alternateRenderTargets),

package/dist/runtime/templates/cli-scaffold-emission.d.ts

@@ -103,6 +103,10 @@ export interface ScaffoldEmissionOptions {
      * Whether local wp-env support should be emitted.
      */
     withWpEnv: boolean;
+    /**
+     * WordPress version target used for generated plugin Tested up to headers.
+     */
+    wpVersion?: ScaffoldProjectOptions["wpVersion"];
 }
 /**
  * Emit scaffold files into the target project directory.

package/dist/runtime/templates/cli-scaffold.d.ts

@@ -42,6 +42,7 @@ interface RunScaffoldFlowOptions {
     withMigrationUi?: boolean;
     withTestPreset?: boolean;
     withWpEnv?: boolean;
+    wpVersion?: string;
     yes?: boolean;
 }
 /**
@@ -51,7 +52,7 @@ interface RunScaffoldFlowOptions {
  * project.
  * @returns The scaffold result together with next-step guidance.
  */
-export declare function runScaffoldFlow({ projectInput, cwd, templateId, alternateRenderTargets, dataStorageMode, dryRun, externalLayerId, externalLayerSource, innerBlocksPreset, persistencePolicy, packageManager, namespace, profile, textDomain, phpPrefix, queryPostType, yes, noInstall, onProgress, isInteractive, allowExistingDir, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }: RunScaffoldFlowOptions): Promise<{
+export declare function runScaffoldFlow({ projectInput, cwd, templateId, alternateRenderTargets, dataStorageMode, dryRun, externalLayerId, externalLayerSource, innerBlocksPreset, persistencePolicy, packageManager, namespace, profile, textDomain, phpPrefix, queryPostType, yes, noInstall, onProgress, isInteractive, allowExistingDir, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, wpVersion, }: RunScaffoldFlowOptions): Promise<{
     dryRun: boolean;
     optionalOnboarding: import("./cli-scaffold-output.js").OptionalOnboardingGuidance;
     plan: import("./cli-scaffold-emission.js").ScaffoldDryRunPlan | undefined;

package/dist/runtime/templates/cli-scaffold.js

@@ -9,6 +9,7 @@ import { collectProjectDirectoryWarnings, collectTemplateCapabilityWarnings, res
 import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, isBuiltInTemplateId, } from "./template-registry.js";
 import { resolveOptionalInteractiveExternalLayerId, } from "./external-layer-selection.js";
 import { resolveLocalCliPathOption, normalizeOptionalCliString, } from "../cli/cli-validation.js";
+import { resolveScaffoldWordPressTargetVersion, } from "./scaffold-compatibility.js";
 export { getNextSteps, getOptionalOnboarding } from "./cli-scaffold-output.js";
 /**
  * Resolve scaffold options, prompts, and follow-up steps for one CLI run.
@@ -17,7 +18,7 @@ export { getNextSteps, getOptionalOnboarding } from "./cli-scaffold-output.js";
  * project.
  * @returns The scaffold result together with next-step guidance.
  */
-export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templateId, alternateRenderTargets, dataStorageMode, dryRun = false, externalLayerId, externalLayerSource, innerBlocksPreset, persistencePolicy, packageManager, namespace, profile, textDomain, phpPrefix, queryPostType, yes = false, noInstall = false, onProgress, isInteractive = false, allowExistingDir = false, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies = undefined, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, }) {
+export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templateId, alternateRenderTargets, dataStorageMode, dryRun = false, externalLayerId, externalLayerSource, innerBlocksPreset, persistencePolicy, packageManager, namespace, profile, textDomain, phpPrefix, queryPostType, yes = false, noInstall = false, onProgress, isInteractive = false, allowExistingDir = false, selectTemplate, selectDataStorage, selectExternalLayerId, selectPersistencePolicy, selectPackageManager, promptText, installDependencies = undefined, variant, selectWithTestPreset, selectWithWpEnv, selectWithMigrationUi, withMigrationUi, withTestPreset, withWpEnv, wpVersion, }) {
     const normalizedExternalLayerId = normalizeOptionalCliString(externalLayerId);
     const normalizedExternalLayerSource = resolveLocalCliPathOption({
         cwd,
@@ -85,6 +86,7 @@ export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templ
             isInteractive,
             selectPackageManager,
         });
+        const resolvedWpVersion = resolveScaffoldWordPressTargetVersion(wpVersion);
         const resolvedWithWpEnv = resolvedProfile === "plugin-qa"
             ? true
             : await resolveOptionalBooleanFlag({
@@ -145,6 +147,7 @@ export async function runScaffoldFlow({ projectInput, cwd = process.cwd(), templ
             withMigrationUi: resolvedWithMigrationUi,
             withTestPreset: resolvedWithTestPreset,
             withWpEnv: resolvedWithWpEnv,
+            wpVersion: resolvedWpVersion,
         };
         const resolvedResult = dryRun
             ? await buildScaffoldDryRunPlan(emissionOptions)

package/dist/runtime/templates/scaffold-compatibility.d.ts

@@ -20,6 +20,18 @@ export interface ScaffoldCompatibilityPolicy {
     capabilityPlan: ResolvedAiFeatureCapabilityPlan;
     pluginHeader: ScaffoldPluginHeaderCompatibility;
 }
+/**
+ * Supported WordPress target versions for generated scaffold plugin headers.
+ */
+export declare const SCAFFOLD_WORDPRESS_TARGET_VERSIONS: readonly ["6.9", "7.0"];
+/**
+ * String literal union for scaffold WordPress targets, currently `6.9` or `7.0`.
+ */
+export type ScaffoldWordPressTargetVersion = (typeof SCAFFOLD_WORDPRESS_TARGET_VERSIONS)[number];
+/**
+ * Default WordPress target version used when create callers omit `--wp-version`.
+ */
+export declare const DEFAULT_SCAFFOLD_WORDPRESS_TARGET_VERSION: ScaffoldWordPressTargetVersion;
 /**
  * Serializable compatibility metadata stored in generated workspace inventory.
  */
@@ -46,6 +58,23 @@ export interface UpdatePluginHeaderCompatibilityOptions {
  * Baseline headers used by scaffold output before optional features are added.
  */
 export declare const DEFAULT_SCAFFOLD_COMPATIBILITY: ScaffoldPluginHeaderCompatibility;
+/**
+ * Return whether a string is one of the supported scaffold WordPress targets.
+ */
+export declare function isScaffoldWordPressTargetVersion(value: string): value is ScaffoldWordPressTargetVersion;
+/**
+ * Resolve CLI input into a supported scaffold WordPress target version.
+ *
+ * Empty input falls back to the default `7.0` target.
+ */
+export declare function resolveScaffoldWordPressTargetVersion(value?: string): ScaffoldWordPressTargetVersion;
+/**
+ * Build scaffold header compatibility for the selected WordPress target.
+ *
+ * The selected target controls `Tested up to`; hard minimums remain tied to the
+ * compatibility policy floor.
+ */
+export declare function createScaffoldCompatibilityBaseline(wpVersion?: ScaffoldWordPressTargetVersion): ScaffoldPluginHeaderCompatibility;
 /**
  * Optional WordPress AI Client surface used by server-only AI feature scaffold.
  */

package/dist/runtime/templates/scaffold-compatibility.js

@@ -5,7 +5,16 @@
  * metadata aligned when optional or required AI-capable features are added.
  */
 import { AI_FEATURE_DEFINITIONS, resolveAiFeatureCapabilityPlan, } from '../add/ai-feature-capability.js';
+import { CLI_DIAGNOSTIC_CODES, createCliDiagnosticCodeError, } from '../cli/cli-diagnostics.js';
 import { parseVersionFloorParts, pickHigherVersionFloor, } from '../shared/version-floor.js';
+/**
+ * Supported WordPress target versions for generated scaffold plugin headers.
+ */
+export const SCAFFOLD_WORDPRESS_TARGET_VERSIONS = ['6.9', '7.0'];
+/**
+ * Default WordPress target version used when create callers omit `--wp-version`.
+ */
+export const DEFAULT_SCAFFOLD_WORDPRESS_TARGET_VERSION = '7.0';
 /**
  * Baseline headers used by scaffold output before optional features are added.
  */
@@ -14,6 +23,40 @@ export const DEFAULT_SCAFFOLD_COMPATIBILITY = {
     requiresPhp: '8.0',
     testedUpTo: '6.9',
 };
+/**
+ * Return whether a string is one of the supported scaffold WordPress targets.
+ */
+export function isScaffoldWordPressTargetVersion(value) {
+    return SCAFFOLD_WORDPRESS_TARGET_VERSIONS.includes(value);
+}
+/**
+ * Resolve CLI input into a supported scaffold WordPress target version.
+ *
+ * Empty input falls back to the default `7.0` target.
+ */
+export function resolveScaffoldWordPressTargetVersion(value) {
+    if (value === undefined || value.trim().length === 0) {
+        return DEFAULT_SCAFFOLD_WORDPRESS_TARGET_VERSION;
+    }
+    const normalized = value.trim();
+    if (isScaffoldWordPressTargetVersion(normalized)) {
+        return normalized;
+    }
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Unsupported --wp-version "${value}". Expected one of: ${SCAFFOLD_WORDPRESS_TARGET_VERSIONS.join(', ')}.`);
+}
+/**
+ * Build scaffold header compatibility for the selected WordPress target.
+ *
+ * The selected target controls `Tested up to`; hard minimums remain tied to the
+ * compatibility policy floor.
+ */
+export function createScaffoldCompatibilityBaseline(wpVersion) {
+    const testedUpTo = wpVersion ?? DEFAULT_SCAFFOLD_WORDPRESS_TARGET_VERSION;
+    return {
+        ...DEFAULT_SCAFFOLD_COMPATIBILITY,
+        testedUpTo,
+    };
+}
 /**
  * Optional WordPress AI Client surface used by server-only AI feature scaffold.
  */

package/dist/runtime/templates/scaffold-template-variables.d.ts

@@ -1,9 +1,20 @@
 import type { ScaffoldAnswers, ScaffoldTemplateVariables } from './scaffold.js';
+import { type ScaffoldWordPressTargetVersion } from "./scaffold-compatibility.js";
+/**
+ * Optional overrides for scaffold template variable generation.
+ */
+export interface GetTemplateVariablesOptions {
+    /**
+     * WordPress target version used for generated plugin `Tested up to` headers.
+     */
+    wpVersion?: ScaffoldWordPressTargetVersion;
+}
 /**
  * Build the normalized template variables used by scaffold rendering.
  *
  * @param templateId Selected scaffold template identifier.
  * @param answers Normalized scaffold answers collected from defaults, flags, and prompts.
+ * @param options Optional compatibility overrides used while building variables.
  * @returns Template variables ready for file interpolation and generated artifacts.
  */
-export declare function getTemplateVariables(templateId: string, answers: ScaffoldAnswers): ScaffoldTemplateVariables;
+export declare function getTemplateVariables(templateId: string, answers: ScaffoldAnswers, options?: GetTemplateVariablesOptions): ScaffoldTemplateVariables;

package/dist/runtime/templates/scaffold-template-variables.js

@@ -6,21 +6,23 @@ import { DEFAULT_COMPOUND_INNER_BLOCKS_PRESET_ID, getCompoundInnerBlocksPresetDe
 import { getTemplateById, isBuiltInTemplateId, } from './template-registry.js';
 import { toPascalCase, toSnakeCase, } from '../shared/string-case.js';
 import { attachScaffoldTemplateVariableGroups } from "./scaffold-template-variable-groups.js";
-import { resolveScaffoldCompatibilityPolicy } from "./scaffold-compatibility.js";
+import { createScaffoldCompatibilityBaseline, resolveScaffoldCompatibilityPolicy, } from "./scaffold-compatibility.js";
 /**
  * Build the normalized template variables used by scaffold rendering.
  *
  * @param templateId Selected scaffold template identifier.
  * @param answers Normalized scaffold answers collected from defaults, flags, and prompts.
+ * @param options Optional compatibility overrides used while building variables.
  * @returns Template variables ready for file interpolation and generated artifacts.
  */
-export function getTemplateVariables(templateId, answers) {
+export function getTemplateVariables(templateId, answers, options = {}) {
     if (isBuiltInTemplateId(templateId)) {
         return buildTemplateVariablesFromBlockSpec(createBuiltInBlockSpec({
             answers,
             dataStorageMode: answers.dataStorageMode,
             persistencePolicy: answers.persistencePolicy,
             templateId,
+            wpVersion: options.wpVersion,
         }));
     }
     const { apiClientPackageVersion, blockRuntimePackageVersion, blockTypesPackageVersion, projectToolsPackageVersion, restPackageVersion, wpTypiaPackageVersion, } = getPackageVersions();
@@ -59,7 +61,9 @@ export function getTemplateVariables(templateId, answers) {
     const persistencePolicy = templateId === 'persistence' || compoundPersistenceEnabled
         ? answers.persistencePolicy ?? 'authenticated'
         : 'authenticated';
-    const compatibility = resolveScaffoldCompatibilityPolicy([]);
+    const compatibility = resolveScaffoldCompatibilityPolicy([], {
+        baseline: createScaffoldCompatibilityBaseline(options.wpVersion),
+    });
     const flatVariables = {
         alternateRenderTargetsCsv: '',
         alternateRenderTargetsJson: '[]',

package/dist/runtime/templates/scaffold.d.ts

@@ -1,4 +1,5 @@
 import type { PackageManagerId } from "../shared/package-managers.js";
+import type { ScaffoldWordPressTargetVersion } from "./scaffold-compatibility.js";
 import type { ScaffoldTemplateVariableGroupsCarrier } from "./scaffold-template-variable-groups.js";
 /**
  * User-facing scaffold answers before template rendering.
@@ -176,6 +177,7 @@ interface ScaffoldProjectOptions {
     withMigrationUi?: boolean;
     withTestPreset?: boolean;
     withWpEnv?: boolean;
+    wpVersion?: ScaffoldWordPressTargetVersion;
 }
 export interface ScaffoldProjectResult {
     packageManager: PackageManagerId;
@@ -202,4 +204,4 @@ export declare function isCreateProfileId(value: string): value is CreateProfile
  * profile list for CLI diagnostics.
  */
 export declare function resolveCreateProfileId(profile?: string): CreateProfileId | undefined;
-export declare function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, cwd, allowExistingDir, noInstall, installDependencies, onProgress, variant, withMigrationUi, withTestPreset, withWpEnv, }: ScaffoldProjectOptions): Promise<ScaffoldProjectResult>;
+export declare function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, cwd, allowExistingDir, noInstall, installDependencies, onProgress, variant, withMigrationUi, withTestPreset, withWpEnv, wpVersion, }: ScaffoldProjectOptions): Promise<ScaffoldProjectResult>;

package/dist/runtime/templates/scaffold.js

@@ -77,7 +77,7 @@ async function applyCreateProfile({ profile, projectDir, }) {
 async function reportScaffoldProgress(onProgress, event) {
     await onProgress?.(event);
 }
-export async function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, cwd = process.cwd(), allowExistingDir = false, noInstall = false, installDependencies = undefined, onProgress = undefined, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
+export async function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, cwd = process.cwd(), allowExistingDir = false, noInstall = false, installDependencies = undefined, onProgress = undefined, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, wpVersion, }) {
     const resolvedTemplateId = normalizeTemplateSelection(templateId);
     const resolvedPackageManager = getPackageManager(packageManager).id;
     const isBuiltInTemplate = isBuiltInTemplateId(resolvedTemplateId);
@@ -115,6 +115,7 @@ export async function scaffoldProject({ projectDir, templateId, answers, alterna
             withMigrationUi,
             withTestPreset,
             withWpEnv,
+            wpVersion,
         });
         const validated = await blockGeneratorService.validate({ plan });
         const rendered = await blockGeneratorService.render({ validated });
@@ -131,6 +132,8 @@ export async function scaffoldProject({ projectDir, templateId, answers, alterna
         ...answers,
         dataStorageMode: dataStorageMode ?? answers.dataStorageMode,
         persistencePolicy: persistencePolicy ?? answers.persistencePolicy,
+    }, {
+        wpVersion,
     });
     await reportScaffoldProgress(onProgress, {
         detail: "Loading template files, variants, and external package metadata when needed.",

package/dist/runtime/workspace/workspace-inventory-parser-entries.js

@@ -1,5 +1,6 @@
 import ts from "typescript";
 import { getPropertyNameText } from "../shared/ts-property-names.js";
+import { parseVersionFloorParts } from "../shared/version-floor.js";
 import { assertParsedInventoryEntry, } from "./workspace-inventory-parser-validation.js";
 function findExportedArrayLiteral(sourceFile, exportName) {
     for (const statement of sourceFile.statements) {
@@ -88,6 +89,106 @@ function getOptionalBooleanProperty(entryName, elementIndex, objectLiteral, key)
     }
     return undefined;
 }
+function findObjectPropertyExpression(objectLiteral, key) {
+    for (const property of objectLiteral.properties) {
+        if (!ts.isPropertyAssignment(property)) {
+            continue;
+        }
+        if (getPropertyNameText(property.name) === key) {
+            return property.initializer;
+        }
+    }
+    return undefined;
+}
+function getRequiredObjectLiteralProperty(objectLiteral, key, context) {
+    const expression = findObjectPropertyExpression(objectLiteral, key);
+    if (!expression) {
+        throw new Error(`${context}.${key} is required in scripts/block-config.ts.`);
+    }
+    if (!ts.isObjectLiteralExpression(expression)) {
+        throw new Error(`${context}.${key} must be an object literal in scripts/block-config.ts.`);
+    }
+    return expression;
+}
+function getRequiredStringProperty(objectLiteral, key, context) {
+    const expression = findObjectPropertyExpression(objectLiteral, key);
+    if (!expression) {
+        throw new Error(`${context}.${key} is required in scripts/block-config.ts.`);
+    }
+    if (!ts.isStringLiteralLike(expression)) {
+        throw new Error(`${context}.${key} must be a string literal in scripts/block-config.ts.`);
+    }
+    return expression.text;
+}
+function getOptionalNestedStringProperty(objectLiteral, key, context) {
+    const expression = findObjectPropertyExpression(objectLiteral, key);
+    if (!expression) {
+        return undefined;
+    }
+    if (!ts.isStringLiteralLike(expression)) {
+        throw new Error(`${context}.${key} must be a string literal in scripts/block-config.ts.`);
+    }
+    return expression.text;
+}
+function getOptionalVersionFloorProperty(objectLiteral, key, context) {
+    const value = getOptionalNestedStringProperty(objectLiteral, key, context);
+    if (value === undefined) {
+        return undefined;
+    }
+    try {
+        parseVersionFloorParts(value);
+    }
+    catch {
+        throw new Error(`${context}.${key} must be a dotted numeric version such as "6.7" or "8.1.2" in scripts/block-config.ts.`);
+    }
+    return value;
+}
+function getRequiredStringArrayProperty(objectLiteral, key, context) {
+    const expression = findObjectPropertyExpression(objectLiteral, key);
+    if (!expression) {
+        throw new Error(`${context}.${key} is required in scripts/block-config.ts.`);
+    }
+    if (!ts.isArrayLiteralExpression(expression)) {
+        throw new Error(`${context}.${key} must be an array literal in scripts/block-config.ts.`);
+    }
+    return expression.elements.map((element, itemIndex) => {
+        if (!ts.isStringLiteralLike(element)) {
+            throw new Error(`${context}.${key}[${itemIndex}] must be a string literal in scripts/block-config.ts.`);
+        }
+        return element.text;
+    });
+}
+function parseCompatibilityConfigLiteral(objectLiteral, context) {
+    const hardMinimumsObject = getRequiredObjectLiteralProperty(objectLiteral, "hardMinimums", context);
+    const mode = getRequiredStringProperty(objectLiteral, "mode", context);
+    if (mode !== "baseline" && mode !== "optional" && mode !== "required") {
+        throw new Error(`${context}.mode must be baseline, optional, or required in scripts/block-config.ts.`);
+    }
+    const php = getOptionalVersionFloorProperty(hardMinimumsObject, "php", `${context}.hardMinimums`);
+    const wordpress = getOptionalVersionFloorProperty(hardMinimumsObject, "wordpress", `${context}.hardMinimums`);
+    return {
+        hardMinimums: {
+            ...(php ? { php } : {}),
+            ...(wordpress ? { wordpress } : {}),
+        },
+        mode,
+        optionalFeatureIds: getRequiredStringArrayProperty(objectLiteral, "optionalFeatureIds", context),
+        optionalFeatures: getRequiredStringArrayProperty(objectLiteral, "optionalFeatures", context),
+        requiredFeatureIds: getRequiredStringArrayProperty(objectLiteral, "requiredFeatureIds", context),
+        requiredFeatures: getRequiredStringArrayProperty(objectLiteral, "requiredFeatures", context),
+        runtimeGates: getRequiredStringArrayProperty(objectLiteral, "runtimeGates", context),
+    };
+}
+function getOptionalCompatibilityConfigProperty(entryName, elementIndex, objectLiteral, key) {
+    const expression = findObjectPropertyExpression(objectLiteral, key);
+    if (!expression) {
+        return undefined;
+    }
+    if (!ts.isObjectLiteralExpression(expression)) {
+        throw new Error(`${entryName}[${elementIndex}].${key} must be an object literal in scripts/block-config.ts.`);
+    }
+    return parseCompatibilityConfigLiteral(expression, `${entryName}[${elementIndex}].${key}`);
+}
 function parseInventoryEntries(arrayLiteral, descriptor) {
     return arrayLiteral.elements.map((element, elementIndex) => {
         if (!ts.isObjectLiteralExpression(element)) {
@@ -98,9 +199,11 @@ function parseInventoryEntries(arrayLiteral, descriptor) {
             const kind = field.kind ?? "string";
             const value = kind === "stringArray"
                 ? getOptionalStringArrayProperty(descriptor.entryName, elementIndex, element, field.key)
-                : kind === "boolean"
-                    ? getOptionalBooleanProperty(descriptor.entryName, elementIndex, element, field.key)
-                    : getOptionalStringProperty(descriptor.entryName, elementIndex, element, field.key);
+                : kind === "compatibilityConfig"
+                    ? getOptionalCompatibilityConfigProperty(descriptor.entryName, elementIndex, element, field.key)
+                    : kind === "boolean"
+                        ? getOptionalBooleanProperty(descriptor.entryName, elementIndex, element, field.key)
+                        : getOptionalStringProperty(descriptor.entryName, elementIndex, element, field.key);
             field.validate?.(value, {
                 elementIndex,
                 entryName: descriptor.entryName,

package/dist/runtime/workspace/workspace-inventory-parser-validation.d.ts

@@ -1,8 +1,9 @@
 import type { WorkspaceInventoryAppendOptionKey, WorkspaceInventoryEntriesKey, WorkspaceInventorySectionFlagKey } from "./workspace-inventory-types.js";
+import type { ScaffoldCompatibilityConfig } from "../templates/scaffold-compatibility.js";
 /**
  * Literal value shape accepted by descriptor-driven inventory entry fields.
  */
-export type InventoryEntryFieldValue = string | string[] | boolean | undefined;
+export type InventoryEntryFieldValue = string | string[] | boolean | ScaffoldCompatibilityConfig | undefined;
 /**
  * Context passed to custom field validators while parsing one inventory entry.
  */
@@ -13,7 +14,7 @@ export type InventoryEntryFieldValidationContext = {
 };
 type InventoryEntryFieldDescriptor = {
     key: string;
-    kind?: "boolean" | "string" | "stringArray";
+    kind?: "boolean" | "compatibilityConfig" | "string" | "stringArray";
     required?: boolean;
     validate?: (value: InventoryEntryFieldValue, context: InventoryEntryFieldValidationContext) => void;
 };

package/dist/runtime/workspace/workspace-inventory-section-descriptors.js

@@ -336,6 +336,7 @@ export const INVENTORY_SECTIONS = [
                 entryName: "ABILITIES",
                 fields: [
                     { key: "clientFile", required: true },
+                    { key: "compatibility", kind: "compatibilityConfig" },
                     { key: "configFile", required: true },
                     { key: "dataFile", required: true },
                     { key: "inputSchemaFile", required: true },
@@ -371,6 +372,7 @@ export const INVENTORY_SECTIONS = [
                     { key: "aiSchemaFile", required: true },
                     { key: "apiFile", required: true },
                     { key: "clientFile", required: true },
+                    { key: "compatibility", kind: "compatibilityConfig" },
                     { key: "dataFile", required: true },
                     { key: "namespace", required: true },
                     { key: "openApiFile", required: true },

package/dist/runtime/workspace/workspace-inventory-types.d.ts

@@ -1,3 +1,4 @@
+import type { ScaffoldCompatibilityConfig } from "../templates/scaffold-compatibility.js";
 export interface WorkspaceBlockInventoryEntry {
     apiTypesFile?: string;
     attributeTypeName?: string;
@@ -113,6 +114,7 @@ export interface WorkspacePostMetaInventoryEntry {
  */
 export interface WorkspaceAbilityInventoryEntry {
     clientFile: string;
+    compatibility?: ScaffoldCompatibilityConfig;
     configFile: string;
     dataFile: string;
     inputSchemaFile: string;
@@ -134,6 +136,7 @@ export interface WorkspaceAiFeatureInventoryEntry {
     aiSchemaFile: string;
     apiFile: string;
     clientFile: string;
+    compatibility?: ScaffoldCompatibilityConfig;
     dataFile: string;
     namespace: string;
     openApiFile: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.24.6",
+  "version": "0.24.8",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -121,7 +121,7 @@
     "package.json"
   ],
   "scripts": {
-    "build": "bun run --filter @wp-typia/api-client build && bun run --filter @wp-typia/block-runtime build && rm -rf dist && tsc -p tsconfig.runtime.json",
+    "build": "bun run --filter @wp-typia/block-types build && bun run --filter @wp-typia/api-client build && bun run --filter @wp-typia/block-runtime build && rm -rf dist && tsc -p tsconfig.runtime.json",
     "prepack": "bun run build && node ./scripts/publish-manifest.mjs prepare",
     "postpack": "node ./scripts/publish-manifest.mjs restore",
     "test": "bun run build && bun test tests/*.test.ts",
@@ -168,7 +168,7 @@
     "@wp-typia/api-client": "^0.4.6",
     "@wp-typia/block-runtime": "^0.7.1",
     "@wp-typia/rest": "^0.3.14",
-    "@wp-typia/block-types": "^0.3.3",
+    "@wp-typia/block-types": "^0.3.4",
     "mustache": "^4.2.0",
     "npm-package-arg": "^13.0.0",
     "semver": "^7.7.3",