@wp-typia/project-tools 0.23.1 → 0.24.0

package/dist/runtime/cli-add-workspace-ability-scaffold.js

@@ -1,320 +1,14 @@
 import { promises as fsp } from "node:fs";
 import path from "node:path";
 import { syncTypeSchemas } from "@wp-typia/block-runtime/metadata-core";
-import semver from "semver";
-import { appendWorkspaceInventoryEntries, readWorkspaceInventoryAsync, } from "./workspace-inventory.js";
-import { pathExists, readOptionalUtf8File } from "./fs-async.js";
-import { readJsonFile } from "./json-utils.js";
-import { buildAbilityClientSource, buildAbilityConfigEntry, buildAbilityConfigSource, buildAbilityDataSource, buildAbilityPhpSource, buildAbilityRegistrySource, buildAbilitySyncScriptSource, buildAbilityTypesSource, } from "./cli-add-workspace-ability-templates.js";
-import { ABILITY_EDITOR_ASSET, ABILITY_EDITOR_SCRIPT, ABILITY_REGISTRY_END_MARKER, ABILITY_REGISTRY_START_MARKER, ABILITY_SERVER_GLOB, WP_ABILITIES_SCRIPT_MODULE_ID, WP_CORE_ABILITIES_SCRIPT_MODULE_ID, } from "./cli-add-workspace-ability-types.js";
+import { appendWorkspaceInventoryEntries, } from "./workspace-inventory.js";
+import { ensureAbilityBootstrapAnchors, ensureAbilityBuildScriptAnchors, ensureAbilityPackageScripts, ensureAbilitySyncProjectAnchors, ensureAbilityWebpackAnchors, } from "./cli-add-workspace-ability-anchors.js";
+import { resolveAbilityRegistryPath, writeAbilityRegistry, } from "./cli-add-workspace-ability-registry.js";
+import { buildAbilityClientSource, buildAbilityConfigEntry, buildAbilityConfigSource, buildAbilityDataSource, buildAbilityPhpSource, buildAbilitySyncScriptSource, buildAbilityTypesSource, } from "./cli-add-workspace-ability-templates.js";
 import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
-import { appendPhpSnippetBeforeClosingTag, executeWorkspaceMutationPlan, insertPhpSnippetBeforeWorkspaceAnchors, } from "./cli-add-workspace-mutation.js";
+import { executeWorkspaceMutationPlan, } from "./cli-add-workspace-mutation.js";
 import { updatePluginHeaderCompatibility, } from "./scaffold-compatibility.js";
-import { DEFAULT_WORDPRESS_ABILITIES_VERSION, DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION, } from "./package-versions.js";
-import { escapeRegex, findPhpFunctionRange, hasPhpFunctionCall, hasPhpFunctionDefinition, replacePhpFunctionDefinition, } from "./php-utils.js";
 import { toPascalCase } from "./string-case.js";
-function resolveManagedDependencyVersion(existingVersion, requiredVersion) {
-    if (!existingVersion) {
-        return requiredVersion;
-    }
-    const existingMinimum = semver.minVersion(existingVersion);
-    const requiredMinimum = semver.minVersion(requiredVersion);
-    if (!existingMinimum || !requiredMinimum) {
-        return requiredVersion;
-    }
-    return semver.gte(existingMinimum, requiredMinimum)
-        ? existingVersion
-        : requiredVersion;
-}
-async function resolveAbilityRegistryPath(projectDir) {
-    const abilitiesDir = path.join(projectDir, "src", "abilities");
-    for (const candidatePath of [
-        path.join(abilitiesDir, "index.ts"),
-        path.join(abilitiesDir, "index.js"),
-    ]) {
-        if (await pathExists(candidatePath)) {
-            return candidatePath;
-        }
-    }
-    return path.join(abilitiesDir, "index.ts");
-}
-async function readAbilityRegistrySlugs(registryPath) {
-    const source = await readOptionalUtf8File(registryPath);
-    if (source === null) {
-        return [];
-    }
-    return Array.from(source.matchAll(/^\s*export\s+\*\s+from\s+['"]\.\/([^/'"]+)\/client(?:\.[cm]?[jt]sx?)?['"];?\s*$/gmu)).map((match) => match[1]);
-}
-async function writeAbilityRegistry(projectDir, abilitySlug) {
-    const abilitiesDir = path.join(projectDir, "src", "abilities");
-    const registryPath = await resolveAbilityRegistryPath(projectDir);
-    await fsp.mkdir(abilitiesDir, { recursive: true });
-    const existingAbilitySlugs = (await readWorkspaceInventoryAsync(projectDir)).abilities.map((entry) => entry.slug);
-    const existingRegistrySlugs = await readAbilityRegistrySlugs(registryPath);
-    const nextAbilitySlugs = Array.from(new Set([...existingAbilitySlugs, ...existingRegistrySlugs, abilitySlug])).sort();
-    const generatedSection = buildAbilityRegistrySource(nextAbilitySlugs);
-    const existingSource = (await readOptionalUtf8File(registryPath)) ?? "";
-    const generatedSectionPattern = new RegExp(`${escapeRegex(ABILITY_REGISTRY_START_MARKER)}[\\s\\S]*?${escapeRegex(ABILITY_REGISTRY_END_MARKER)}\\n?`, "u");
-    const nextSource = existingSource
-        ? generatedSectionPattern.test(existingSource)
-            ? existingSource.replace(generatedSectionPattern, generatedSection)
-            : `${existingSource.trimEnd()}\n\n${generatedSection}`
-        : generatedSection;
-    await fsp.writeFile(registryPath, nextSource, "utf8");
-}
-async function ensureAbilityBootstrapAnchors(workspace) {
-    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
-    await patchFile(bootstrapPath, (source) => {
-        let nextSource = source;
-        const workspaceBaseName = workspace.packageName.split("/").pop() ?? workspace.packageName;
-        const loadFunctionName = `${workspace.workspace.phpPrefix}_load_workflow_abilities`;
-        const enqueueFunctionName = `${workspace.workspace.phpPrefix}_enqueue_workflow_abilities`;
-        const loadHook = `add_action( 'plugins_loaded', '${loadFunctionName}' );`;
-        const adminEnqueueHook = `add_action( 'admin_enqueue_scripts', '${enqueueFunctionName}' );`;
-        const editorEnqueueHook = `add_action( 'enqueue_block_editor_assets', '${enqueueFunctionName}' );`;
-        const loadFunction = `
-
-function ${loadFunctionName}() {
-\tforeach ( glob( __DIR__ . '${ABILITY_SERVER_GLOB}' ) ?: array() as $ability_module ) {
-\t\trequire_once $ability_module;
-\t}
-}
-`;
-        const enqueueFunction = `
-
-function ${enqueueFunctionName}() {
-\tif ( ! class_exists( 'WP_Ability' ) ) {
-\t\treturn;
-\t}
-
-\t$script_path = __DIR__ . '/${ABILITY_EDITOR_SCRIPT}';
-\t$asset_path  = __DIR__ . '/${ABILITY_EDITOR_ASSET}';
-
-\tif ( ! file_exists( $script_path ) || ! file_exists( $asset_path ) ) {
-\t\treturn;
-\t}
-
-\t$asset = require $asset_path;
-\tif ( ! is_array( $asset ) ) {
-\t\t$asset = array();
-\t}
-
-\t$dependencies = isset( $asset['dependencies'] ) && is_array( $asset['dependencies'] )
-\t\t? $asset['dependencies']
-\t\t: array();
-
-\tforeach ( array( '${WP_CORE_ABILITIES_SCRIPT_MODULE_ID}', '${WP_ABILITIES_SCRIPT_MODULE_ID}' ) as $ability_dependency ) {
-\t\t$has_dependency = false;
-\t\tforeach ( $dependencies as $dependency ) {
-\t\t\t$dependency_id = is_array( $dependency ) && isset( $dependency['id'] )
-\t\t\t\t? $dependency['id']
-\t\t\t\t: $dependency;
-\t\t\tif ( $dependency_id === $ability_dependency ) {
-\t\t\t\t$has_dependency = true;
-\t\t\t\tbreak;
-\t\t\t}
-\t\t}
-\t\tif ( ! $has_dependency ) {
-\t\t\t$dependencies[] = $ability_dependency;
-\t\t}
-\t}
-
-\tif ( ! function_exists( 'wp_enqueue_script_module' ) ) {
-\t\treturn;
-\t}
-
-\twp_enqueue_script_module(
-\t\t'${workspaceBaseName}-abilities',
-\t\tplugins_url( '${ABILITY_EDITOR_SCRIPT}', __FILE__ ),
-\t\t$dependencies,
-\t\tisset( $asset['version'] ) ? $asset['version'] : filemtime( $script_path )
-\t);
-}
-`;
-        if (!hasPhpFunctionDefinition(nextSource, loadFunctionName)) {
-            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, loadFunction);
-        }
-        if (!hasPhpFunctionDefinition(nextSource, enqueueFunctionName)) {
-            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, enqueueFunction);
-        }
-        else {
-            const functionRange = findPhpFunctionRange(nextSource, enqueueFunctionName);
-            const functionSource = functionRange
-                ? nextSource.slice(functionRange.start, functionRange.end)
-                : "";
-            if (!hasPhpFunctionCall(functionSource, "wp_enqueue_script_module")) {
-                const replacedSource = replacePhpFunctionDefinition(nextSource, enqueueFunctionName, enqueueFunction, { trimReplacementStart: true });
-                if (!replacedSource) {
-                    throw new Error(`Unable to repair ${path.basename(bootstrapPath)} for ${enqueueFunctionName}.`);
-                }
-                nextSource = replacedSource;
-            }
-        }
-        if (!nextSource.includes(loadHook)) {
-            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, loadHook);
-        }
-        if (!nextSource.includes(adminEnqueueHook)) {
-            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, adminEnqueueHook);
-        }
-        if (!nextSource.includes(editorEnqueueHook)) {
-            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, editorEnqueueHook);
-        }
-        return nextSource;
-    });
-}
-async function ensureAbilityPackageScripts(workspace) {
-    const packageJsonPath = path.join(workspace.projectDir, "package.json");
-    const packageJson = await readJsonFile(packageJsonPath, {
-        context: "workspace package manifest",
-    });
-    const nextScripts = {
-        ...(packageJson.scripts ?? {}),
-        "sync-abilities": packageJson.scripts?.["sync-abilities"] ?? "tsx scripts/sync-abilities.ts",
-    };
-    const nextDependencies = {
-        ...(packageJson.dependencies ?? {}),
-        [WP_ABILITIES_SCRIPT_MODULE_ID]: resolveManagedDependencyVersion(packageJson.dependencies?.[WP_ABILITIES_SCRIPT_MODULE_ID], DEFAULT_WORDPRESS_ABILITIES_VERSION),
-        [WP_CORE_ABILITIES_SCRIPT_MODULE_ID]: resolveManagedDependencyVersion(packageJson.dependencies?.[WP_CORE_ABILITIES_SCRIPT_MODULE_ID], DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION),
-    };
-    if (JSON.stringify(nextScripts) === JSON.stringify(packageJson.scripts ?? {}) &&
-        JSON.stringify(nextDependencies) === JSON.stringify(packageJson.dependencies ?? {})) {
-        return;
-    }
-    packageJson.scripts = nextScripts;
-    packageJson.dependencies = nextDependencies;
-    await fsp.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, "\t")}\n`, "utf8");
-}
-async function ensureAbilitySyncProjectAnchors(workspace) {
-    const syncProjectScriptPath = path.join(workspace.projectDir, "scripts", "sync-project.ts");
-    await patchFile(syncProjectScriptPath, (source) => {
-        let nextSource = source;
-        const syncRestConst = "const syncRestScriptPath = path.join( 'scripts', 'sync-rest-contracts.ts' );";
-        const syncAbilitiesConst = "const syncAbilitiesScriptPath = path.join( 'scripts', 'sync-abilities.ts' );";
-        const syncRestBlockPattern = /if \( fs\.existsSync\( path\.resolve\( process\.cwd\(\), syncRestScriptPath \) \) \) \{\n\s*runSyncScript\( syncRestScriptPath, options \);\n\s*\}/u;
-        const syncAbilitiesBlock = [
-            "if ( fs.existsSync( path.resolve( process.cwd(), syncAbilitiesScriptPath ) ) ) {",
-            "\trunSyncScript( syncAbilitiesScriptPath, options );",
-            "}",
-        ].join("\n");
-        if (!nextSource.includes(syncAbilitiesConst)) {
-            if (!nextSource.includes(syncRestConst)) {
-                throw new Error([
-                    `ensureAbilitySyncProjectAnchors could not patch ${path.basename(syncProjectScriptPath)}.`,
-                    "Missing the expected sync-rest script constant in scripts/sync-project.ts.",
-                    "Restore the generated template or wire sync-abilities manually before retrying.",
-                ].join(" "));
-            }
-            nextSource = nextSource.replace(syncRestConst, `${syncRestConst}\n${syncAbilitiesConst}`);
-        }
-        if (!nextSource.includes("runSyncScript( syncAbilitiesScriptPath, options );")) {
-            if (!syncRestBlockPattern.test(nextSource)) {
-                throw new Error([
-                    `ensureAbilitySyncProjectAnchors could not patch ${path.basename(syncProjectScriptPath)}.`,
-                    "Missing the expected sync-rest invocation block in scripts/sync-project.ts.",
-                    "Restore the generated template or wire sync-abilities manually before retrying.",
-                ].join(" "));
-            }
-            nextSource = nextSource.replace(syncRestBlockPattern, (match) => `${match}\n\n${syncAbilitiesBlock}`);
-        }
-        return nextSource;
-    });
-}
-async function ensureAbilityBuildScriptAnchors(workspace) {
-    const buildScriptPath = path.join(workspace.projectDir, "scripts", "build-workspace.mjs");
-    await patchFile(buildScriptPath, (source) => {
-        let nextSource = source;
-        if (/['"]src\/abilities\/index\.(?:ts|js)['"]/u.test(nextSource)) {
-            return nextSource;
-        }
-        const sharedEntriesPattern = /(for\s*\(\s*const\s+relativePath\s+of\s+\[)([\s\S]*?)(\]\s*\)\s*\{)/u;
-        const match = nextSource.match(sharedEntriesPattern);
-        if (!match ||
-            !/['"]src\/bindings\/index\.(?:ts|js)['"]/u.test(match[2]) ||
-            !/['"]src\/editor-plugins\/index\.(?:tsx|ts|js)['"]/u.test(match[2])) {
-            throw new Error([
-                `ensureAbilityBuildScriptAnchors could not patch ${path.basename(buildScriptPath)}.`,
-                "Missing the expected shared editor entries array in scripts/build-workspace.mjs.",
-                "Restore the generated template or wire abilities/index manually before retrying.",
-            ].join(" "));
-        }
-        nextSource = nextSource.replace(sharedEntriesPattern, (fullMatch, sharedEntries) => {
-            const missingAbilityEntries = [
-                "'src/abilities/index.ts'",
-                "'src/abilities/index.js'",
-            ].filter((entry) => !sharedEntries.includes(entry));
-            if (missingAbilityEntries.length === 0) {
-                return fullMatch;
-            }
-            const itemIndent = sharedEntries.match(/\n([ \t]*)['"]/u)?.[1] ?? "\t\t";
-            const trimmedEntries = sharedEntries.replace(/\s*$/u, "");
-            const trailingWhitespace = sharedEntries.slice(trimmedEntries.length);
-            const separator = trimmedEntries.trimEnd().endsWith(",") ? "" : ",";
-            const nextEntries = `${trimmedEntries}${separator}` +
-                missingAbilityEntries.map((entry) => `\n${itemIndent}${entry},`).join("") +
-                trailingWhitespace;
-            return fullMatch.replace(sharedEntries, nextEntries);
-        });
-        return nextSource;
-    });
-}
-async function ensureAbilityWebpackAnchors(workspace) {
-    const webpackConfigPath = path.join(workspace.projectDir, "webpack.config.js");
-    await patchFile(webpackConfigPath, (source) => {
-        if (/['"]abilities\/index['"]/u.test(source)) {
-            return source;
-        }
-        const optionalModuleReturnPattern = /(function\s+getOptionalModuleEntries\s*\(\)\s*\{[\s\S]*?)(\n\treturn Object\.fromEntries\(\s*entries\s*\);\n\})/u;
-        if (optionalModuleReturnPattern.test(source)) {
-            return source.replace(optionalModuleReturnPattern, `$1
-
-\tfor ( const [ entryName, candidates ] of [
-\t\t[
-\t\t\t'abilities/index',
-\t\t\t[ 'src/abilities/index.ts', 'src/abilities/index.js' ],
-\t\t],
-\t] ) {
-\t\tfor ( const relativePath of candidates ) {
-\t\t\tconst entryPath = path.resolve( process.cwd(), relativePath );
-\t\t\tif ( ! fs.existsSync( entryPath ) ) {
-\t\t\t\tcontinue;
-\t\t\t}
-
-\t\t\tentries.push( [ entryName, entryPath ] );
-\t\t\tbreak;
-\t\t}
-\t}$2`);
-        }
-        const sharedEntriesPattern = /for\s*\(\s*const\s+\[\s*entryName\s*,\s*candidates\s*\]\s+of\s+\[([\s\S]*?)\]\s*\)\s*\{/u;
-        const match = source.match(sharedEntriesPattern);
-        if (!match ||
-            !match[1].includes("bindings/index") ||
-            !match[1].includes("editor-plugins/index")) {
-            throw new Error([
-                `ensureAbilityWebpackAnchors could not patch ${path.basename(webpackConfigPath)}.`,
-                "Missing the expected shared editor entries block in webpack.config.js.",
-                "Restore the generated template or wire abilities/index manually before retrying.",
-            ].join(" "));
-        }
-        return source.replace(sharedEntriesPattern, (fullMatch, sharedEntries) => {
-            if (/['"]abilities\/index['"]/u.test(sharedEntries)) {
-                return fullMatch;
-            }
-            const tupleIndent = sharedEntries.match(/\n([ \t]*)\[/u)?.[1] ?? "\t\t";
-            const nestedIndent = `${tupleIndent}\t`;
-            const trimmedEntries = sharedEntries.replace(/\s*$/u, "");
-            const trailingWhitespace = sharedEntries.slice(trimmedEntries.length);
-            const separator = trimmedEntries.trimEnd().endsWith(",") ? "" : ",";
-            const abilityTuple = [
-                `${tupleIndent}[`,
-                `${nestedIndent}'abilities/index',`,
-                `${nestedIndent}[ 'src/abilities/index.ts', 'src/abilities/index.js' ],`,
-                `${tupleIndent}],`,
-            ].join("\n");
-            const nextEntries = `${trimmedEntries}${separator}\n${abilityTuple}` + trailingWhitespace;
-            return fullMatch.replace(sharedEntries, nextEntries);
-        });
-    });
-}
 /**
  * Write generated workflow ability sources and patch shared workspace anchors.
  */

package/dist/runtime/cli-add-workspace-admin-view-scaffold.js

@@ -5,7 +5,7 @@ import { safeJsonParse } from './json-utils.js';
 import { appendWorkspaceInventoryEntries, readWorkspaceInventoryAsync, } from './workspace-inventory.js';
 import { buildAdminViewConfigEntry, buildAdminViewConfigSource, buildAdminViewEntrySource, buildAdminViewPhpSource, buildAdminViewRegistrySource, buildAdminViewScreenSource, buildAdminViewStyleSource, buildAdminViewTypesSource, buildCoreDataAdminViewDataSource, buildCoreDataAdminViewScreenSource, buildDefaultAdminViewDataSource, buildRestAdminViewDataSource, buildRestSettingsAdminViewConfigSource, buildRestSettingsAdminViewDataSource, buildRestSettingsAdminViewScreenSource, buildRestSettingsAdminViewTypesSource, } from './cli-add-workspace-admin-view-templates.js';
 import { ADMIN_VIEWS_PHP_GLOB, isAdminViewCoreDataSource, isAdminViewManualSettingsRestResource, } from './cli-add-workspace-admin-view-types.js';
-import { buildManualRestContractApiSource } from './cli-add-workspace-rest-source-emitters.js';
+import { buildManualRestContractApiSource } from './cli-add-workspace-rest-manual-source-emitters.js';
 import { getWorkspaceBootstrapPath, patchFile, } from './cli-add-shared.js';
 import { appendPhpSnippetBeforeClosingTag, executeWorkspaceMutationPlan, insertPhpSnippetBeforeWorkspaceAnchors, } from './cli-add-workspace-mutation.js';
 import { DEFAULT_WORDPRESS_CORE_DATA_VERSION, DEFAULT_WORDPRESS_DATA_VERSION, DEFAULT_WORDPRESS_DATAVIEWS_VERSION, DEFAULT_WP_TYPIA_DATAVIEWS_VERSION, resolveManagedPackageVersionRange, } from './package-versions.js';

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

@@ -1,4 +1,8 @@
 import type { WorkspaceProject } from "./workspace-project.js";
+/**
+ * Patch generated sync-rest scripts so AI feature REST artifacts join workspace REST synchronization.
+ */
+export { ensureAiFeatureSyncRestAnchors, } from "./cli-add-workspace-ai-sync-rest-anchors.js";
 /**
  * Patch the workspace bootstrap file so it loads generated AI feature PHP modules.
  */
@@ -16,7 +20,3 @@ export declare function ensureAiFeaturePackageScripts(workspace: WorkspaceProjec
  * Patch `scripts/sync-project.ts` after package scripts so generated workspaces invoke `sync-ai` when present.
  */
 export declare function ensureAiFeatureSyncProjectAnchors(workspace: WorkspaceProject): Promise<void>;
-/**
- * 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-anchors.js

@@ -6,6 +6,10 @@ import { appendPhpSnippetBeforeClosingTag, insertPhpSnippetBeforeWorkspaceAnchor
 import { readJsonFile } from "./json-utils.js";
 import { hasPhpFunctionDefinition } from "./php-utils.js";
 const AI_FEATURE_SERVER_GLOB = "/inc/ai-features/*.php";
+/**
+ * Patch generated sync-rest scripts so AI feature REST artifacts join workspace REST synchronization.
+ */
+export { ensureAiFeatureSyncRestAnchors, } from "./cli-add-workspace-ai-sync-rest-anchors.js";
 /**
  * Patch the workspace bootstrap file so it loads generated AI feature PHP modules.
  */
@@ -112,235 +116,3 @@ export async function ensureAiFeatureSyncProjectAnchors(workspace) {
         return nextSource;
     });
 }
-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);",
-            "}",
-            "",
-            "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-scaffold.js

@@ -1,8 +1,10 @@
 import { promises as fsp } from "node:fs";
 import path from "node:path";
 import { ensureBlockConfigCanAddRestManifests } from "./cli-add-block-legacy-validator.js";
-import { buildAiFeatureConfigEntry, buildAiFeatureDataSource, buildAiFeatureSyncScriptSource, buildAiFeatureTypesSource, buildAiFeatureValidatorsSource, buildAiFeatureApiSource, } from "./cli-add-workspace-ai-source-emitters.js";
-import { ensureAiFeatureBootstrapAnchors, ensureAiFeaturePackageScripts, ensureAiFeatureSyncProjectAnchors, ensureAiFeatureSyncRestAnchors, } from "./cli-add-workspace-ai-anchors.js";
+import { buildAiFeatureConfigEntry, buildAiFeatureDataSource, buildAiFeatureTypesSource, buildAiFeatureValidatorsSource, buildAiFeatureApiSource, } from "./cli-add-workspace-ai-source-emitters.js";
+import { buildAiFeatureSyncScriptSource, } from "./cli-add-workspace-ai-sync-script-source.js";
+import { ensureAiFeatureBootstrapAnchors, ensureAiFeaturePackageScripts, ensureAiFeatureSyncProjectAnchors, } from "./cli-add-workspace-ai-anchors.js";
+import { ensureAiFeatureSyncRestAnchors, } from "./cli-add-workspace-ai-sync-rest-anchors.js";
 import { buildAiFeaturePhpSource } from "./cli-add-workspace-ai-templates.js";
 import { appendWorkspaceInventoryEntries } from "./workspace-inventory.js";
 import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";

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

@@ -1,3 +1,4 @@
+export { buildAiFeatureSyncScriptSource, } from "./cli-add-workspace-ai-sync-script-source.js";
 /**
  * Build the workspace inventory entry written into `scripts/block-config.ts` for one AI feature.
  */
@@ -18,7 +19,3 @@ export declare function buildAiFeatureApiSource(aiFeatureSlug: string): string;
  * Generate React endpoint-mutation hooks for the scaffolded AI feature client wrapper.
  */
 export declare function buildAiFeatureDataSource(aiFeatureSlug: string): string;
-/**
- * Generate the `scripts/sync-ai-features.ts` source that projects AI-safe schemas for workspace features.
- */
-export declare function buildAiFeatureSyncScriptSource(): string;