@wp-typia/project-tools 0.23.0 → 0.24.0

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

@@ -3,8 +3,13 @@ import path from "node:path";
 import { getPackageVersions } from "./package-versions.js";
 import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
 import { appendPhpSnippetBeforeClosingTag, insertPhpSnippetBeforeWorkspaceAnchors, } from "./cli-add-workspace-mutation.js";
+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.
  */
@@ -43,7 +48,9 @@ function ${registerFunctionName}() {
  */
 export async function ensureAiFeaturePackageScripts(workspace) {
     const packageJsonPath = path.join(workspace.projectDir, "package.json");
-    const packageJson = JSON.parse(await fsp.readFile(packageJsonPath, "utf8"));
+    const packageJson = await readJsonFile(packageJsonPath, {
+        context: "workspace package manifest",
+    });
     const nextScripts = {
         ...(packageJson.scripts ?? {}),
         "sync-ai": packageJson.scripts?.["sync-ai"] ?? "tsx scripts/sync-ai-features.ts",
@@ -109,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;

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,132 +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 ) {
-\tconst decoded = JSON.parse( await readFile( filePath, 'utf8' ) ) as unknown;
-\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>;