@wp-typia/project-tools 0.23.1 → 0.24.0

package/dist/runtime/cli-add-workspace-ai-source-emitters.js

@@ -2,6 +2,7 @@ import { quoteTsString } from "./cli-add-shared.js";
 import { buildAiFeatureEndpointManifest } from "./ai-feature-artifacts.js";
 import { OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY, createScaffoldCompatibilityConfig, renderScaffoldCompatibilityConfig, resolveScaffoldCompatibilityPolicy, } from "./scaffold-compatibility.js";
 import { toPascalCase, toTitleCase } from "./string-case.js";
+export { buildAiFeatureSyncScriptSource, } from "./cli-add-workspace-ai-sync-script-source.js";
 function indentMultiline(source, prefix) {
     return source
         .split("\n")
@@ -323,148 +324,3 @@ export {
 };
 `;
 }
-/**
- * Generate the `scripts/sync-ai-features.ts` source that projects AI-safe schemas for workspace features.
- */
-export function buildAiFeatureSyncScriptSource() {
-    return `/* eslint-disable no-console */
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-
-import { projectWordPressAiSchema } from '@wp-typia/project-tools/ai-artifacts';
-
-import {
-\tAI_FEATURES,
-\ttype WorkspaceAiFeatureConfig,
-} from './block-config';
-
-function parseCliOptions( argv: string[] ) {
-\tconst options = {
-\t\tcheck: false,
-\t};
-
-\tfor ( const argument of argv ) {
-\t\tif ( argument === '--check' ) {
-\t\t\toptions.check = true;
-\t\t\tcontinue;
-\t\t}
-
-\t\tthrow new Error( \`Unknown sync-ai flag: \${ argument }\` );
-\t}
-
-\treturn options;
-}
-
-function isWorkspaceAiFeature(
-\tfeature: WorkspaceAiFeatureConfig
-): feature is WorkspaceAiFeatureConfig & {
-\taiSchemaFile: string;
-\ttypesFile: string;
-} {
-\treturn (
-\t\ttypeof feature.aiSchemaFile === 'string' &&
-\t\ttypeof feature.typesFile === 'string'
-\t);
-}
-
-function normalizeGeneratedArtifactContent( content: string ) {
-\treturn content.replace( /\\r\\n?/g, '\\n' );
-}
-
-async function reconcileGeneratedArtifact( options: {
-\tcheck: boolean;
-\tcontent: string;
-\tfilePath: string;
-\tlabel: string;
-} ) {
-\tif ( ! options.check ) {
-\t\tawait mkdir( path.dirname( options.filePath ), {
-\t\t\trecursive: true,
-\t\t} );
-\t\tawait writeFile( options.filePath, options.content, 'utf8' );
-\t\treturn;
-\t}
-
-\tconst current = normalizeGeneratedArtifactContent(
-\t\tawait readFile( options.filePath, 'utf8' )
-\t);
-\tconst expected = normalizeGeneratedArtifactContent( options.content );
-\tif ( current !== expected ) {
-\t\tthrow new Error(
-\t\t\t\`Generated AI feature artifact is stale: \${ options.label } (\${ options.filePath }).\`
-\t\t);
-\t}
-}
-
-async function loadJsonDocument( filePath: string ) {
-\tlet source: string;
-\ttry {
-\t\tsource = await readFile( filePath, 'utf8' );
-\t} catch ( error ) {
-\t\tthrow new Error(
-\t\t\t\`Failed to read AI schema document at \${ filePath }: \${ error instanceof Error ? error.message : String( error ) }\`
-\t\t);
-\t}
-
-\tlet decoded: unknown;
-\ttry {
-\t\tdecoded = JSON.parse( source ) as unknown;
-\t} catch ( error ) {
-\t\tthrow new Error(
-\t\t\t\`Failed to parse AI schema document at \${ filePath }: \${ error instanceof Error ? error.message : String( error ) }\`
-\t\t);
-\t}
-\tif ( ! decoded || typeof decoded !== 'object' || Array.isArray( decoded ) ) {
-\t\tthrow new Error( \`Expected \${ filePath } to decode to a JSON object.\` );
-\t}
-
-\treturn decoded as Parameters< typeof projectWordPressAiSchema >[ 0 ];
-}
-
-async function main() {
-\tconst options = parseCliOptions( process.argv.slice( 2 ) );
-\tconst aiFeatures = AI_FEATURES.filter( isWorkspaceAiFeature );
-\tif ( AI_FEATURES.length > 0 && aiFeatures.length === 0 ) {
-\t\tconsole.warn(
-\t\t\t'⚠️ AI_FEATURES entries exist, but none satisfied the generated sync-ai guard. Check for missing aiSchemaFile/typesFile fields in scripts/block-config.ts.'
-\t\t);
-\t}
-
-\tif ( aiFeatures.length === 0 ) {
-\t\tconsole.log(
-\t\t\toptions.check
-\t\t\t\t? 'ℹ️ No workspace AI features are registered yet. \`sync-ai --check\` is already clean.'
-\t\t\t\t: 'ℹ️ No workspace AI features are registered yet.'
-\t\t);
-\t\treturn;
-\t}
-
-\tfor ( const feature of aiFeatures ) {
-\t\tconst sourceSchemaPath = path.join(
-\t\t\tpath.dirname( feature.typesFile ),
-\t\t\t'api-schemas',
-\t\t\t'feature-result.schema.json'
-\t\t);
-\t\tconst sourceSchema = await loadJsonDocument( sourceSchemaPath );
-\t\tconst aiSchema = projectWordPressAiSchema( sourceSchema );
-\t\tawait reconcileGeneratedArtifact( {
-\t\t\tcheck: options.check,
-\t\t\tcontent: \`\${ JSON.stringify( aiSchema, null, 2 ) }\\n\`,
-\t\t\tfilePath: feature.aiSchemaFile,
-\t\t\tlabel: feature.slug,
-\t\t} );
-\t}
-
-\tconsole.log(
-\t\toptions.check
-\t\t\t? '✅ AI feature structured-output schemas are already synchronized.'
-\t\t\t: '✅ AI feature structured-output schemas were synchronized.'
-\t);
-}
-
-main().catch( ( error ) => {
-\tconsole.error( '❌ AI feature sync failed:', error );
-\tprocess.exit( 1 );
-} );
-`;
-}

package/dist/runtime/cli-add-workspace-ai-sync-rest-anchors.d.ts

@@ -0,0 +1,5 @@
+import type { WorkspaceProject } from "./workspace-project.js";
+/**
+ * Patch `scripts/sync-rest-contracts.ts` after sync-project wiring so AI feature REST artifacts join the split sync flow.
+ */
+export declare function ensureAiFeatureSyncRestAnchors(workspace: WorkspaceProject): Promise<void>;

package/dist/runtime/cli-add-workspace-ai-sync-rest-anchors.js

@@ -0,0 +1,236 @@
+import path from "node:path";
+import { patchFile } from "./cli-add-shared.js";
+function assertSyncRestAnchor(nextSource, target, anchorDescription, hasAnchor, syncRestScriptPath) {
+    if (!nextSource.includes(target) && !hasAnchor) {
+        throw new Error([
+            `ensureAiFeatureSyncRestAnchors could not patch ${path.basename(syncRestScriptPath)}.`,
+            `Missing expected ${anchorDescription} anchor in scripts/sync-rest-contracts.ts.`,
+            "Restore the generated template or add the AI feature wiring manually before retrying.",
+        ].join(" "));
+    }
+}
+function replaceRequiredSyncRestSource(nextSource, target, anchor, replacement, anchorDescription, syncRestScriptPath) {
+    if (nextSource.includes(target)) {
+        return nextSource;
+    }
+    const hasAnchor = typeof anchor === "string" ? nextSource.includes(anchor) : anchor.test(nextSource);
+    assertSyncRestAnchor(nextSource, target, anchorDescription, hasAnchor, syncRestScriptPath);
+    return nextSource.replace(anchor, replacement);
+}
+function replaceBlockConfigImportForAiFeatures(nextSource, syncRestScriptPath) {
+    const importPatterns = [
+        /^import\s*\{\n(?:\t[^\n]*\n)+\} from ["']\.\/block-config["'];?$/mu,
+        /^import\s*\{[^\n]*\}\s*from\s*["']\.\/block-config["'];?$/mu,
+    ];
+    const importMatch = importPatterns.map((pattern) => pattern.exec(nextSource)).find(Boolean) ??
+        null;
+    if (!importMatch) {
+        throw new Error([
+            `ensureAiFeatureSyncRestAnchors could not patch ${path.basename(syncRestScriptPath)}.`,
+            "Missing expected workspace inventory import anchor in scripts/sync-rest-contracts.ts.",
+            "Restore the generated template or add the AI feature wiring manually before retrying.",
+        ].join(" "));
+    }
+    const importSource = importMatch[0];
+    if (importSource.includes("AI_FEATURES") &&
+        importSource.includes("WorkspaceAiFeatureConfig")) {
+        return nextSource;
+    }
+    const hasContracts = importSource.includes("CONTRACTS");
+    const hasContractConfig = importSource.includes("WorkspaceContractConfig");
+    const hasPostMeta = importSource.includes("POST_META");
+    const hasPostMetaConfig = importSource.includes("WorkspacePostMetaConfig");
+    const replacement = [
+        "import {",
+        "\tAI_FEATURES,",
+        "\tBLOCKS,",
+        ...(hasContracts ? ["\tCONTRACTS,"] : []),
+        ...(hasPostMeta ? ["\tPOST_META,"] : []),
+        "\tREST_RESOURCES,",
+        "\ttype WorkspaceAiFeatureConfig,",
+        "\ttype WorkspaceBlockConfig,",
+        ...(hasContractConfig ? ["\ttype WorkspaceContractConfig,"] : []),
+        ...(hasPostMetaConfig ? ["\ttype WorkspacePostMetaConfig,"] : []),
+        "\ttype WorkspaceRestResourceConfig,",
+        "} from './block-config';",
+    ].join("\n");
+    return nextSource.replace(importSource, replacement);
+}
+function replaceAiFeatureSyncSummaryCopy(nextSource, syncRestScriptPath) {
+    const standaloneSummary = "workspace blocks, standalone contracts, and plugin-level resources";
+    const standaloneAiSummary = "workspace blocks, standalone contracts, plugin-level resources, and AI features";
+    const standalonePostMetaSummary = "workspace blocks, standalone contracts, post meta contracts, and plugin-level resources";
+    const standalonePostMetaAiSummary = "workspace blocks, standalone contracts, post meta contracts, plugin-level resources, and AI features";
+    const postMetaSummary = "workspace blocks, post meta contracts, and plugin-level resources";
+    const postMetaAiSummary = "workspace blocks, post meta contracts, plugin-level resources, and AI features";
+    const restResourceSummary = "workspace blocks and plugin-level resources";
+    const restResourceAiSummary = "workspace blocks, plugin-level resources, and AI features";
+    if (nextSource.includes(standalonePostMetaSummary)) {
+        return nextSource
+            .split(standalonePostMetaSummary)
+            .join(standalonePostMetaAiSummary);
+    }
+    if (nextSource.includes(standaloneSummary)) {
+        return nextSource.split(standaloneSummary).join(standaloneAiSummary);
+    }
+    if (nextSource.includes(postMetaSummary)) {
+        return nextSource.split(postMetaSummary).join(postMetaAiSummary);
+    }
+    if (nextSource.includes(restResourceSummary)) {
+        return nextSource.split(restResourceSummary).join(restResourceAiSummary);
+    }
+    if (nextSource.includes(standaloneAiSummary) ||
+        nextSource.includes(standalonePostMetaAiSummary) ||
+        nextSource.includes(postMetaAiSummary) ||
+        nextSource.includes(restResourceAiSummary)) {
+        return nextSource;
+    }
+    throw new Error([
+        `ensureAiFeatureSyncRestAnchors could not patch ${path.basename(syncRestScriptPath)}.`,
+        "Missing expected sync summary copy anchor in scripts/sync-rest-contracts.ts.",
+        "Restore the generated template or add the AI feature wiring manually before retrying.",
+    ].join(" "));
+}
+function formatNoResourcesSubject(subjects) {
+    if (subjects.length <= 2) {
+        return subjects.join(" or ");
+    }
+    const lastSubject = subjects[subjects.length - 1];
+    return `${subjects.slice(0, -1).join(", ")}, or ${lastSubject}`;
+}
+function buildAiFeatureNoResourcesGuard({ hasPostMeta, hasStandaloneContracts, }) {
+    const condition = ["restBlocks.length === 0"];
+    if (hasStandaloneContracts) {
+        condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
+        condition.push("standaloneContracts.length === 0");
+    }
+    if (hasPostMeta) {
+        condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
+        condition.push("postMetaContracts.length === 0");
+    }
+    condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
+    condition.push("restResources.length === 0 &&");
+    condition.push("aiFeatures.length === 0");
+    const noResourcesSubject = formatNoResourcesSubject([
+        "REST-enabled workspace blocks",
+        ...(hasStandaloneContracts ? ["standalone contracts"] : []),
+        ...(hasPostMeta ? ["post meta contracts"] : []),
+        "plugin-level REST resources",
+        "AI features",
+    ]);
+    return [
+        "if (",
+        ...condition.map((line) => `\t\t${line}`),
+        "\t) {",
+        "\t\tconsole.log(",
+        "\t\t\toptions.check",
+        `\t\t\t\t? 'ℹ️ No ${noResourcesSubject} are registered yet. \`sync-rest --check\` is already clean.'`,
+        `\t\t\t\t: 'ℹ️ No ${noResourcesSubject} are registered yet.'`,
+        "\t\t);",
+        "\t\treturn;",
+        "\t}",
+    ].join("\n");
+}
+const NO_RESOURCES_GUARD_PATTERN = /if \(\s*restBlocks\.length === 0(?:\s*&&\s*standaloneContracts\.length === 0)?(?:\s*&&\s*postMetaContracts\.length === 0)?\s*&&\s*restResources\.length === 0(?:\s*&&\s*aiFeatures\.length === 0)?\s*\) \{[\s\S]*?\n\t\treturn;\n\t\}/u;
+/**
+ * Patch `scripts/sync-rest-contracts.ts` after sync-project wiring so AI feature REST artifacts join the split sync flow.
+ */
+export async function ensureAiFeatureSyncRestAnchors(workspace) {
+    const syncRestScriptPath = path.join(workspace.projectDir, "scripts", "sync-rest-contracts.ts");
+    await patchFile(syncRestScriptPath, (source) => {
+        let nextSource = replaceBlockConfigImportForAiFeatures(source, syncRestScriptPath);
+        const helperInsertionAnchor = "async function assertTypeArtifactsCurrent";
+        const restResourcesAnchor = "const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );";
+        const consoleLogPattern = /\n\tconsole\.log\(\n\t\toptions\.check/u;
+        nextSource = replaceRequiredSyncRestSource(nextSource, "function isWorkspaceAiFeature(", helperInsertionAnchor, [
+            "function isWorkspaceAiFeature(",
+            "\tfeature: WorkspaceAiFeatureConfig",
+            "): feature is WorkspaceAiFeatureConfig & {",
+            "\taiSchemaFile: string;",
+            "\tclientFile: string;",
+            "\topenApiFile: string;",
+            "\trestManifest: NonNullable< WorkspaceAiFeatureConfig[ 'restManifest' ] >;",
+            "\ttypesFile: string;",
+            "\tvalidatorsFile: string;",
+            "} {",
+            "\treturn (",
+            "\t\ttypeof feature.aiSchemaFile === 'string' &&",
+            "\t\ttypeof feature.clientFile === 'string' &&",
+            "\t\ttypeof feature.openApiFile === 'string' &&",
+            "\t\ttypeof feature.typesFile === 'string' &&",
+            "\t\ttypeof feature.validatorsFile === 'string' &&",
+            "\t\ttypeof feature.restManifest === 'object' &&",
+            "\t\tfeature.restManifest !== null &&",
+            "\t\ttypeof feature.restManifest.contracts === 'object' &&",
+            "\t\tfeature.restManifest.contracts !== null",
+            "\t);",
+            "}",
+            "",
+            "async function assertTypeArtifactsCurrent",
+        ].join("\n"), "type artifact assertion helper", syncRestScriptPath);
+        nextSource = replaceRequiredSyncRestSource(nextSource, "const aiFeatures = AI_FEATURES.filter( isWorkspaceAiFeature );", restResourcesAnchor, [
+            "const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );",
+            "const aiFeatures = AI_FEATURES.filter( isWorkspaceAiFeature );",
+        ].join("\n"), "rest resource filter", syncRestScriptPath);
+        nextSource = replaceRequiredSyncRestSource(nextSource, "aiFeatures.length === 0", NO_RESOURCES_GUARD_PATTERN, buildAiFeatureNoResourcesGuard({
+            hasPostMeta: nextSource.includes("const postMetaContracts = POST_META.filter( isWorkspacePostMetaContract );"),
+            hasStandaloneContracts: nextSource.includes("const standaloneContracts = CONTRACTS.filter( isWorkspaceStandaloneContract );"),
+        }), "no-resources guard", syncRestScriptPath);
+        nextSource = replaceRequiredSyncRestSource(nextSource, "for ( const feature of aiFeatures ) {", consoleLogPattern, [
+            "",
+            "\tfor ( const feature of aiFeatures ) {",
+            "\t\tconst contracts = feature.restManifest.contracts;",
+            "",
+            "\t\tfor ( const [ baseName, contract ] of Object.entries( contracts ) ) {",
+            "\t\t\tawait syncTypeSchemas(",
+            "\t\t\t\t{",
+            "\t\t\t\t\tjsonSchemaFile: path.join(",
+            "\t\t\t\t\t\tpath.dirname( feature.typesFile ),",
+            "\t\t\t\t\t\t'api-schemas',",
+            "\t\t\t\t\t\t`${ baseName }.schema.json`",
+            "\t\t\t\t\t),",
+            "\t\t\t\t\topenApiFile: path.join(",
+            "\t\t\t\t\t\tpath.dirname( feature.typesFile ),",
+            "\t\t\t\t\t\t'api-schemas',",
+            "\t\t\t\t\t\t`${ baseName }.openapi.json`",
+            "\t\t\t\t\t),",
+            "\t\t\t\t\tsourceTypeName: contract.sourceTypeName,",
+            "\t\t\t\t\ttypesFile: feature.typesFile,",
+            "\t\t\t\t},",
+            "\t\t\t\t{",
+            "\t\t\t\t\tcheck: options.check,",
+            "\t\t\t\t}",
+            "\t\t\t);",
+            "\t\t}",
+            "",
+            "\t\tawait syncRestOpenApi(",
+            "\t\t\t{",
+            "\t\t\t\tmanifest: feature.restManifest,",
+            "\t\t\t\topenApiFile: feature.openApiFile,",
+            "\t\t\t\ttypesFile: feature.typesFile,",
+            "\t\t\t},",
+            "\t\t\t{",
+            "\t\t\t\tcheck: options.check,",
+            "\t\t\t}",
+            "\t\t);",
+            "",
+            "\t\tawait syncEndpointClient(",
+            "\t\t\t{",
+            "\t\t\t\tclientFile: feature.clientFile,",
+            "\t\t\t\tmanifest: feature.restManifest,",
+            "\t\t\t\ttypesFile: feature.typesFile,",
+            "\t\t\t\tvalidatorsFile: feature.validatorsFile,",
+            "\t\t\t},",
+            "\t\t\t{",
+            "\t\t\t\tcheck: options.check,",
+            "\t\t\t}",
+            "\t\t);",
+            "\t}",
+            "",
+            "\tconsole.log(",
+            "\t\toptions.check",
+        ].join("\n"), "final sync summary", syncRestScriptPath);
+        nextSource = replaceAiFeatureSyncSummaryCopy(nextSource, syncRestScriptPath);
+        return nextSource;
+    });
+}

package/dist/runtime/cli-add-workspace-ai-sync-script-source.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generate the `scripts/sync-ai-features.ts` source that projects AI-safe schemas for workspace features.
+ */
+export declare function buildAiFeatureSyncScriptSource(): string;

package/dist/runtime/cli-add-workspace-ai-sync-script-source.js

@@ -0,0 +1,145 @@
+/**
+ * Generate the `scripts/sync-ai-features.ts` source that projects AI-safe schemas for workspace features.
+ */
+export function buildAiFeatureSyncScriptSource() {
+    return `/* eslint-disable no-console */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+
+import { projectWordPressAiSchema } from '@wp-typia/project-tools/ai-artifacts';
+
+import {
+\tAI_FEATURES,
+\ttype WorkspaceAiFeatureConfig,
+} from './block-config';
+
+function parseCliOptions( argv: string[] ) {
+\tconst options = {
+\t\tcheck: false,
+\t};
+
+\tfor ( const argument of argv ) {
+\t\tif ( argument === '--check' ) {
+\t\t\toptions.check = true;
+\t\t\tcontinue;
+\t\t}
+
+\t\tthrow new Error( \`Unknown sync-ai flag: \${ argument }\` );
+\t}
+
+\treturn options;
+}
+
+function isWorkspaceAiFeature(
+\tfeature: WorkspaceAiFeatureConfig
+): feature is WorkspaceAiFeatureConfig & {
+\taiSchemaFile: string;
+\ttypesFile: string;
+} {
+\treturn (
+\t\ttypeof feature.aiSchemaFile === 'string' &&
+\t\ttypeof feature.typesFile === 'string'
+\t);
+}
+
+function normalizeGeneratedArtifactContent( content: string ) {
+\treturn content.replace( /\\r\\n?/g, '\\n' );
+}
+
+async function reconcileGeneratedArtifact( options: {
+\tcheck: boolean;
+\tcontent: string;
+\tfilePath: string;
+\tlabel: string;
+} ) {
+\tif ( ! options.check ) {
+\t\tawait mkdir( path.dirname( options.filePath ), {
+\t\t\trecursive: true,
+\t\t} );
+\t\tawait writeFile( options.filePath, options.content, 'utf8' );
+\t\treturn;
+\t}
+
+\tconst current = normalizeGeneratedArtifactContent(
+\t\tawait readFile( options.filePath, 'utf8' )
+\t);
+\tconst expected = normalizeGeneratedArtifactContent( options.content );
+\tif ( current !== expected ) {
+\t\tthrow new Error(
+\t\t\t\`Generated AI feature artifact is stale: \${ options.label } (\${ options.filePath }).\`
+\t\t);
+\t}
+}
+
+async function loadJsonDocument( filePath: string ) {
+\tlet source: string;
+\ttry {
+\t\tsource = await readFile( filePath, 'utf8' );
+\t} catch ( error ) {
+\t\tthrow new Error(
+\t\t\t\`Failed to read AI schema document at \${ filePath }: \${ error instanceof Error ? error.message : String( error ) }\`
+\t\t);
+\t}
+
+\tlet decoded: unknown;
+\ttry {
+\t\tdecoded = JSON.parse( source ) as unknown;
+\t} catch ( error ) {
+\t\tthrow new Error(
+\t\t\t\`Failed to parse AI schema document at \${ filePath }: \${ error instanceof Error ? error.message : String( error ) }\`
+\t\t);
+\t}
+\tif ( ! decoded || typeof decoded !== 'object' || Array.isArray( decoded ) ) {
+\t\tthrow new Error( \`Expected \${ filePath } to decode to a JSON object.\` );
+\t}
+
+\treturn decoded as Parameters< typeof projectWordPressAiSchema >[ 0 ];
+}
+
+async function main() {
+\tconst options = parseCliOptions( process.argv.slice( 2 ) );
+\tconst aiFeatures = AI_FEATURES.filter( isWorkspaceAiFeature );
+\tif ( AI_FEATURES.length > 0 && aiFeatures.length === 0 ) {
+\t\tconsole.warn(
+\t\t\t'⚠️ AI_FEATURES entries exist, but none satisfied the generated sync-ai guard. Check for missing aiSchemaFile/typesFile fields in scripts/block-config.ts.'
+\t\t);
+\t}
+
+\tif ( aiFeatures.length === 0 ) {
+\t\tconsole.log(
+\t\t\toptions.check
+\t\t\t\t? 'ℹ️ No workspace AI features are registered yet. \`sync-ai --check\` is already clean.'
+\t\t\t\t: 'ℹ️ No workspace AI features are registered yet.'
+\t\t);
+\t\treturn;
+\t}
+
+\tfor ( const feature of aiFeatures ) {
+\t\tconst sourceSchemaPath = path.join(
+\t\t\tpath.dirname( feature.typesFile ),
+\t\t\t'api-schemas',
+\t\t\t'feature-result.schema.json'
+\t\t);
+\t\tconst sourceSchema = await loadJsonDocument( sourceSchemaPath );
+\t\tconst aiSchema = projectWordPressAiSchema( sourceSchema );
+\t\tawait reconcileGeneratedArtifact( {
+\t\t\tcheck: options.check,
+\t\t\tcontent: \`\${ JSON.stringify( aiSchema, null, 2 ) }\\n\`,
+\t\t\tfilePath: feature.aiSchemaFile,
+\t\t\tlabel: feature.slug,
+\t\t} );
+\t}
+
+\tconsole.log(
+\t\toptions.check
+\t\t\t? '✅ AI feature structured-output schemas are already synchronized.'
+\t\t\t: '✅ AI feature structured-output schemas were synchronized.'
+\t);
+}
+
+main().catch( ( error ) => {
+\tconsole.error( '❌ AI feature sync failed:', error );
+\tprocess.exit( 1 );
+} );
+`;
+}

package/dist/runtime/cli-add-workspace-assets.d.ts

@@ -1,66 +1,9 @@
-import { type RunAddBindingSourceCommandOptions, type RunAddEditorPluginCommandOptions, type RunAddPatternCommandOptions } from "./cli-add-shared.js";
 /**
- * Add one document-level editor plugin scaffold to an official workspace project.
+ * Compatibility facade for workspace asset add commands.
  *
- * @param options Command options for the editor-plugin scaffold workflow.
- * @param options.cwd Working directory used to resolve the nearest official workspace.
- * Defaults to `process.cwd()`.
- * @param options.editorPluginName Human-entered editor-plugin name that will be
- * normalized and validated before files are written.
- * @param options.slot Optional editor plugin shell slot. Defaults to `sidebar`.
- * @returns A promise that resolves with the normalized `editorPluginSlug`, chosen
- * `slot`, and owning `projectDir` after the scaffold files and inventory entry
- * are written successfully.
- * @throws {Error} When the command is run outside an official workspace, when the
- * slug or slot is invalid, or when a conflicting file or inventory entry exists.
+ * Keep the public runtime import path stable while each workflow lives in a
+ * focused implementation module.
  */
-export declare function runAddEditorPluginCommand({ cwd, editorPluginName, slot, }: RunAddEditorPluginCommandOptions): Promise<{
-    editorPluginSlug: string;
-    projectDir: string;
-    slot: string;
-}>;
-/**
- * Add one PHP block pattern shell to an official workspace project.
- *
- * @param options Command options for the pattern scaffold workflow.
- * @param options.cwd Working directory used to resolve the nearest official workspace.
- * Defaults to `process.cwd()`.
- * @param options.patternName Human-entered pattern name that will be normalized
- * and validated before files are written.
- * @returns A promise that resolves with the normalized `patternSlug` and
- * owning `projectDir` after the pattern file and inventory entry have been
- * written successfully.
- * @throws {Error} When the command is run outside an official workspace, when
- * the pattern slug is invalid, or when a conflicting file or inventory entry
- * already exists.
- */
-export declare function runAddPatternCommand({ cwd, patternName, }: RunAddPatternCommandOptions): Promise<{
-    patternSlug: string;
-    projectDir: string;
-}>;
-/**
- * Add one block binding source scaffold to an official workspace project.
- *
- * @param options Command options for the binding-source scaffold workflow.
- * @param options.attributeName Optional generated block attribute to declare as
- * bindable. Must be provided together with `blockName`.
- * @param options.blockName Optional generated block slug or full block name to
- * receive the bindable attribute wiring. Must be provided together with
- * `attributeName`.
- * @param options.bindingSourceName Human-entered binding source name that will
- * be normalized and validated before files are written.
- * @param options.cwd Working directory used to resolve the nearest official
- * workspace. Defaults to `process.cwd()`.
- * @returns A promise that resolves with the normalized `bindingSourceSlug` and
- * owning `projectDir` after the server/editor files, optional target block
- * metadata, and inventory entry have been written successfully.
- * @throws {Error} When the command is run outside an official workspace, when
- * the slug is invalid, when a binding target is incomplete or unknown, or when
- * a conflicting file or inventory entry exists.
- */
-export declare function runAddBindingSourceCommand({ attributeName, bindingSourceName, blockName, cwd, }: RunAddBindingSourceCommandOptions): Promise<{
-    attributeName?: string;
-    bindingSourceSlug: string;
-    blockSlug?: string;
-    projectDir: string;
-}>;
+export { runAddBindingSourceCommand, } from "./cli-add-workspace-binding-source.js";
+export { runAddEditorPluginCommand } from "./cli-add-workspace-editor-plugin.js";
+export { runAddPatternCommand } from "./cli-add-workspace-pattern.js";