@wp-typia/project-tools 0.22.10 → 0.23.0

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

@@ -418,6 +418,345 @@ export async function ${fetchName}(
 }
 `;
 }
+/**
+ * Build type aliases for a manual REST settings form admin screen.
+ */
+export function buildRestSettingsAdminViewTypesSource(adminViewSlug, restResource) {
+    const pascalName = toPascalCase(adminViewSlug);
+    const restTypesModule = getAdminViewRelativeModuleSpecifier(adminViewSlug, restResource.typesFile);
+    const formStateTypeName = `${pascalName}SettingsFormState`;
+    const loadResultTypeName = `${pascalName}SettingsLoadResult`;
+    return `import type {
+\t${restResource.bodyTypeName},
+\t${restResource.queryTypeName},
+\t${restResource.responseTypeName},
+} from ${quoteTsString(restTypesModule)};
+
+export type ${pascalName}SettingsRequest = ${restResource.bodyTypeName};
+export type ${pascalName}SettingsQuery = ${restResource.queryTypeName};
+export type ${pascalName}SettingsResponse = ${restResource.responseTypeName};
+export type ${formStateTypeName} = Partial<${pascalName}SettingsRequest>;
+
+export interface ${loadResultTypeName} {
+\tform: ${formStateTypeName};
+\tresponse: ${pascalName}SettingsResponse | null;
+}
+`;
+}
+/**
+ * Build display metadata for a manual REST settings form admin screen.
+ */
+export function buildRestSettingsAdminViewConfigSource(adminViewSlug, textDomain, restResource) {
+    const pascalName = toPascalCase(adminViewSlug);
+    const camelName = toCamelCase(adminViewSlug);
+    const title = toTitleCase(adminViewSlug);
+    const configName = `${camelName}SettingsConfig`;
+    const formStateTypeName = `${pascalName}SettingsFormState`;
+    const secretFieldSource = restResource.secretFieldName && restResource.secretStateFieldName
+        ? `\t{
+\t\tdescription: __( 'Write-only secret value. Leave blank to keep the existing secret unless your route treats blank values as removal.', ${quoteTsString(textDomain)} ),
+\t\tid: ${quoteTsString(restResource.secretFieldName)},
+\t\tlabel: __( ${quoteTsString(toTitleCase(restResource.secretFieldName))}, ${quoteTsString(textDomain)} ),
+\t\tsecretStateField: ${quoteTsString(restResource.secretStateFieldName)},
+\t\ttype: 'secret',
+\t},`
+        : '';
+    return `import { __ } from '@wordpress/i18n';
+
+import type { ${formStateTypeName} } from './types';
+
+export type ${pascalName}SettingsFieldType = 'secret' | 'text' | 'textarea';
+
+export interface ${pascalName}SettingsField {
+\tdescription?: string;
+\tid: Extract<keyof ${formStateTypeName}, string> | string;
+\tlabel: string;
+\tsecretStateField?: string;
+\ttype: ${pascalName}SettingsFieldType;
+}
+
+export const ${configName} = {
+\tdescription: __( 'This generated settings form is backed by the ${restResource.slug} REST contract. Adjust config.ts and data.ts as the contract becomes product-specific.', ${quoteTsString(textDomain)} ),
+\tfields: [
+\t\t{
+\t\t\tdescription: __( 'Primary settings payload for this integration.', ${quoteTsString(textDomain)} ),
+\t\t\tid: 'payload',
+\t\t\tlabel: __( 'Payload', ${quoteTsString(textDomain)} ),
+\t\t\ttype: 'textarea',
+\t\t},
+\t\t{
+\t\t\tdescription: __( 'Optional operator note included with the save request.', ${quoteTsString(textDomain)} ),
+\t\t\tid: 'comment',
+\t\t\tlabel: __( 'Comment', ${quoteTsString(textDomain)} ),
+\t\t\ttype: 'text',
+\t\t},
+${secretFieldSource}
+\t] satisfies ${pascalName}SettingsField[],
+\tsecretFieldName: ${restResource.secretFieldName ? quoteTsString(restResource.secretFieldName) : 'undefined'},
+\tsecretStateFieldName: ${restResource.secretStateFieldName ? quoteTsString(restResource.secretStateFieldName) : 'undefined'},
+\ttitle: __( ${quoteTsString(title)}, ${quoteTsString(textDomain)} ),
+};
+`;
+}
+/**
+ * Build data helpers for a manual REST settings form admin screen.
+ */
+export function buildRestSettingsAdminViewDataSource(adminViewSlug, restResource) {
+    const pascalName = toPascalCase(adminViewSlug);
+    const restApiModule = getAdminViewRelativeModuleSpecifier(adminViewSlug, restResource.apiFile);
+    const formStateTypeName = `${pascalName}SettingsFormState`;
+    const loadResultTypeName = `${pascalName}SettingsLoadResult`;
+    const loadName = `load${pascalName}Settings`;
+    const saveName = `save${pascalName}Settings`;
+    const initialFields = [
+        '\tpayload: \'\',',
+        '\tcomment: \'\',',
+    ].join('\n');
+    const requestBodySource = restResource.secretFieldName
+        ? `\tconst requestBody = { ...form } as Record<string, unknown>;
+\tif (requestBody[${quoteTsString(restResource.secretFieldName)}] === '') {
+\t\tdelete requestBody[${quoteTsString(restResource.secretFieldName)}];
+\t}
+`
+        : `\tconst requestBody = form as Record<string, unknown>;
+`;
+    return `import { callManualRestContract } from ${quoteTsString(restApiModule)};
+import type {
+\t${formStateTypeName},
+\t${loadResultTypeName},
+\t${pascalName}SettingsQuery,
+\t${pascalName}SettingsRequest,
+\t${pascalName}SettingsResponse,
+} from './types';
+
+function formatValidationError(prefix: string, errors: unknown): string {
+\tif (!Array.isArray(errors) || errors.length === 0) {
+\t\treturn prefix;
+\t}
+
+\treturn \`\${prefix} \${JSON.stringify(errors)}\`;
+}
+
+export function createInitial${pascalName}SettingsFormState(): ${formStateTypeName} {
+\treturn {
+${initialFields}
+\t} as ${formStateTypeName};
+}
+
+export async function ${loadName}(): Promise<${loadResultTypeName}> {
+\treturn {
+\t\tform: createInitial${pascalName}SettingsFormState(),
+\t\tresponse: null,
+\t};
+}
+
+export async function ${saveName}(
+\tform: ${formStateTypeName},
+\tquery: Partial<${pascalName}SettingsQuery> = {},
+): Promise<${pascalName}SettingsResponse> {
+${requestBodySource}
+\tconst result = await callManualRestContract({
+\t\tbody: requestBody as unknown as ${pascalName}SettingsRequest,
+\t\tquery: query as ${pascalName}SettingsQuery,
+\t});
+\tif (!result.isValid) {
+\t\tconst message =
+\t\t\tresult.validationTarget === 'request'
+\t\t\t\t? 'Settings request failed validation.'
+\t\t\t\t: 'Settings response failed validation.';
+\t\tthrow new Error(formatValidationError(message, result.errors));
+\t}
+
+\treturn result.data as ${pascalName}SettingsResponse;
+}
+`;
+}
+/**
+ * Build a React settings form screen backed by a manual REST contract.
+ */
+export function buildRestSettingsAdminViewScreenSource(adminViewSlug, textDomain) {
+    const pascalName = toPascalCase(adminViewSlug);
+    const componentName = `${pascalName}AdminViewScreen`;
+    const formStateTypeName = `${pascalName}SettingsFormState`;
+    const responseTypeName = `${pascalName}SettingsResponse`;
+    const camelName = toCamelCase(adminViewSlug);
+    const configName = `${camelName}SettingsConfig`;
+    const loadName = `load${pascalName}Settings`;
+    const saveName = `save${pascalName}Settings`;
+    return `import {
+\tButton,
+\tNotice,
+\tSpinner,
+\tTextControl,
+\tTextareaControl,
+} from '@wordpress/components';
+import { useEffect, useState } from '@wordpress/element';
+import { __ } from '@wordpress/i18n';
+
+import { ${configName} } from './config';
+import { ${loadName}, ${saveName} } from './data';
+import type { ${formStateTypeName}, ${responseTypeName} } from './types';
+
+function getFieldValue(form: ${formStateTypeName}, fieldId: string): string {
+\tconst value = (form as Record<string, unknown>)[fieldId];
+\tif (typeof value === 'string') {
+\t\treturn value;
+\t}
+\tif (value == null) {
+\t\treturn '';
+\t}
+
+\treturn String(value);
+}
+
+function getSecretState(response: ${responseTypeName} | null): boolean | null {
+\tconst stateField = ${configName}.secretStateFieldName;
+\tif (!stateField || !response) {
+\t\treturn null;
+\t}
+
+\tconst value = (response as unknown as Record<string, unknown>)[stateField];
+\treturn typeof value === 'boolean' ? value : null;
+}
+
+export function ${componentName}() {
+\tconst [form, setForm] = useState<${formStateTypeName}>({});
+\tconst [response, setResponse] = useState<${responseTypeName} | null>(null);
+\tconst [error, setError] = useState<string | null>(null);
+\tconst [isLoading, setIsLoading] = useState(true);
+\tconst [isSaving, setIsSaving] = useState(false);
+\tconst [successMessage, setSuccessMessage] = useState<string | null>(null);
+
+\tuseEffect(() => {
+\t\tlet isCurrent = true;
+\t\tsetIsLoading(true);
+\t\tsetError(null);
+
+\t\tvoid ${loadName}()
+\t\t\t.then((result) => {
+\t\t\t\tif (isCurrent) {
+\t\t\t\t\tsetForm(result.form);
+\t\t\t\t\tsetResponse(result.response);
+\t\t\t\t}
+\t\t\t})
+\t\t\t.catch((nextError: unknown) => {
+\t\t\t\tif (isCurrent) {
+\t\t\t\t\tsetError(
+\t\t\t\t\t\tnextError instanceof Error
+\t\t\t\t\t\t\t? nextError.message
+\t\t\t\t\t\t\t: __( 'Unable to prepare settings form.', ${quoteTsString(textDomain)} ),
+\t\t\t\t\t);
+\t\t\t\t}
+\t\t\t})
+\t\t\t.finally(() => {
+\t\t\t\tif (isCurrent) {
+\t\t\t\t\tsetIsLoading(false);
+\t\t\t\t}
+\t\t\t});
+
+\t\treturn () => {
+\t\t\tisCurrent = false;
+\t\t};
+\t}, []);
+
+\tconst setFormValue = (fieldId: string, value: string) => {
+\t\tsetForm(
+\t\t\t(current) =>
+\t\t\t\t({
+\t\t\t\t\t...current,
+\t\t\t\t\t[fieldId]: value,
+\t\t\t\t}) as ${formStateTypeName},
+\t\t);
+\t};
+\tconst secretState = getSecretState(response);
+
+\tconst handleSubmit = (event: { preventDefault: () => void }) => {
+\t\tevent.preventDefault();
+\t\tsetError(null);
+\t\tsetSuccessMessage(null);
+\t\tsetIsSaving(true);
+
+\t\tvoid ${saveName}(form)
+\t\t\t.then((nextResponse) => {
+\t\t\t\tsetResponse(nextResponse);
+\t\t\t\tsetSuccessMessage(__( 'Settings saved.', ${quoteTsString(textDomain)} ));
+\t\t\t})
+\t\t\t.catch((nextError: unknown) => {
+\t\t\t\tsetError(
+\t\t\t\t\tnextError instanceof Error
+\t\t\t\t\t\t? nextError.message
+\t\t\t\t\t\t: __( 'Unable to save settings.', ${quoteTsString(textDomain)} ),
+\t\t\t\t);
+\t\t\t})
+\t\t\t.finally(() => setIsSaving(false));
+\t};
+
+\treturn (
+\t\t<div className="wp-typia-admin-view-screen wp-typia-admin-view-screen--settings">
+\t\t\t<header className="wp-typia-admin-view-screen__header">
+\t\t\t\t<div>
+\t\t\t\t\t<p className="wp-typia-admin-view-screen__eyebrow">
+\t\t\t\t\t\t{ __( 'Typed settings screen', ${quoteTsString(textDomain)} ) }
+\t\t\t\t\t</p>
+\t\t\t\t\t<h1>{ ${configName}.title }</h1>
+\t\t\t\t\t<p>{ ${configName}.description }</p>
+\t\t\t\t</div>
+\t\t\t\t<div className="wp-typia-admin-view-screen__actions">
+\t\t\t\t\t{ isLoading || isSaving ? <Spinner /> : null }
+\t\t\t\t</div>
+\t\t\t</header>
+\t\t\t{ error ? (
+\t\t\t\t<Notice isDismissible={ false } status="error">
+\t\t\t\t\t{ error }
+\t\t\t\t</Notice>
+\t\t\t) : null }
+\t\t\t{ successMessage ? (
+\t\t\t\t<Notice isDismissible={ false } status="success">
+\t\t\t\t\t{ successMessage }
+\t\t\t\t</Notice>
+\t\t\t) : null }
+\t\t\t{ secretState !== null ? (
+\t\t\t\t<Notice isDismissible={ false } status="info">
+\t\t\t\t\t{ secretState
+\t\t\t\t\t\t? __( 'A secret is currently configured for this integration.', ${quoteTsString(textDomain)} )
+\t\t\t\t\t\t: __( 'No secret is currently configured for this integration.', ${quoteTsString(textDomain)} ) }
+\t\t\t\t</Notice>
+\t\t\t) : null }
+\t\t\t<form className="wp-typia-admin-view-screen__settings-form" onSubmit={ handleSubmit }>
+\t\t\t\t{ ${configName}.fields.map((field) => (
+\t\t\t\t\t<div className="wp-typia-admin-view-screen__field" key={ field.id }>
+\t\t\t\t\t\t{ field.type === 'textarea' ? (
+\t\t\t\t\t\t\t<TextareaControl
+\t\t\t\t\t\t\t\thelp={ field.description }
+\t\t\t\t\t\t\t\tlabel={ field.label }
+\t\t\t\t\t\t\t\tonChange={ (value) => setFormValue(field.id, value) }
+\t\t\t\t\t\t\t\tvalue={ getFieldValue(form, field.id) }
+\t\t\t\t\t\t\t/>
+\t\t\t\t\t\t) : (
+\t\t\t\t\t\t\t<TextControl
+\t\t\t\t\t\t\t\thelp={ field.description }
+\t\t\t\t\t\t\t\tlabel={ field.label }
+\t\t\t\t\t\t\t\tonChange={ (value) => setFormValue(field.id, value) }
+\t\t\t\t\t\t\t\ttype={ field.type === 'secret' ? 'password' : 'text' }
+\t\t\t\t\t\t\t\tvalue={ getFieldValue(form, field.id) }
+\t\t\t\t\t\t\t/>
+\t\t\t\t\t\t) }
+\t\t\t\t\t</div>
+\t\t\t\t)) }
+\t\t\t\t<Button
+\t\t\t\t\tdisabled={ isLoading || isSaving }
+\t\t\t\t\tisBusy={ isSaving }
+\t\t\t\t\ttype="submit"
+\t\t\t\t\tvariant="primary"
+\t\t\t\t>
+\t\t\t\t\t{ __( 'Save settings', ${quoteTsString(textDomain)} ) }
+\t\t\t\t</Button>
+\t\t\t</form>
+\t\t</div>
+\t);
+}
+`;
+}
 /**
  * Build a core-data-backed admin-view data module for a supported entity family.
  */
@@ -820,13 +1159,15 @@ export function ${componentName}() {
 }
 `;
 }
-export function buildAdminViewEntrySource(adminViewSlug) {
+export function buildAdminViewEntrySource(adminViewSlug, options = {}) {
     const pascalName = toPascalCase(adminViewSlug);
     const componentName = `${pascalName}AdminViewScreen`;
     const rootId = `wp-typia-admin-view-${adminViewSlug}`;
+    const dataViewsStyleImport = options.includeDataViewsStyle === false
+        ? ''
+        : "\nimport '@wordpress/dataviews/build-style/style.css';";
     return `import { createRoot } from '@wordpress/element';
-
-import '@wordpress/dataviews/build-style/style.css';
+${dataViewsStyleImport}
 import { ${componentName} } from './Screen';
 import './style.scss';
 
@@ -887,6 +1228,21 @@ export function buildAdminViewStyleSource() {
 \tdisplay: flex;
 \tgap: 12px;
 }
+
+.wp-typia-admin-view-screen__settings-form {
+\tbackground: #fff;
+\tborder: 1px solid #dcdcde;
+\tborder-radius: 2px;
+\tbox-shadow: 0 1px 1px rgba(0, 0, 0, 0.04);
+\tdisplay: grid;
+\tgap: 20px;
+\tmax-width: 720px;
+\tpadding: 24px;
+}
+
+.wp-typia-admin-view-screen__field .components-base-control {
+\tmargin-bottom: 0;
+}
 `;
 }
 export function buildAdminViewPhpSource(adminViewSlug, workspace) {

package/dist/runtime/cli-add-workspace-admin-view-types.d.ts

@@ -22,6 +22,27 @@ export interface AdminViewCoreDataSource {
 }
 export type AdminViewSource = AdminViewCoreDataSource | AdminViewRestResourceSource;
 export type AdminViewRestResource = WorkspaceRestResourceInventoryEntry;
+/**
+ * Manual REST resource metadata required to scaffold a typed admin settings
+ * screen. The type narrows a workspace REST inventory entry to manual
+ * contracts that expose request body, query, and response type names.
+ */
+export type AdminViewManualSettingsRestResource = AdminViewRestResource & {
+    bodyTypeName: string;
+    mode: 'manual';
+    queryTypeName: string;
+    responseTypeName: string;
+};
 export declare function isAdminViewCoreDataSource(source: AdminViewSource | undefined): source is AdminViewCoreDataSource;
 export declare function isAdminViewRestResourceSource(source: AdminViewSource | undefined): source is AdminViewRestResourceSource;
+/**
+ * Return whether a REST inventory entry has the manual contract shape required
+ * by generated settings screens.
+ */
+export declare function isAdminViewManualSettingsRestResource(restResource: AdminViewRestResource | undefined): restResource is AdminViewManualSettingsRestResource;
+/**
+ * Return whether a REST inventory entry uses route regex groups that a
+ * generated singleton settings screen cannot satisfy with path input.
+ */
+export declare function hasAdminViewManualSettingsRouteParameters(restResource: AdminViewRestResource | undefined): boolean;
 export declare function formatAdminViewSourceLocator(source: AdminViewSource): string;

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

@@ -12,12 +12,34 @@ export const ADMIN_VIEWS_ASSET = 'build/admin-views/index.asset.php';
 export const ADMIN_VIEWS_STYLE = 'build/admin-views/style-index.css';
 export const ADMIN_VIEWS_STYLE_RTL = 'build/admin-views/style-index-rtl.css';
 export const ADMIN_VIEWS_PHP_GLOB = '/inc/admin-views/*.php';
+const ADMIN_VIEW_MANUAL_REST_ROUTE_PARAMETER_PATTERN = /(?:^|[^\\])\(/u;
 export function isAdminViewCoreDataSource(source) {
     return source?.kind === ADMIN_VIEW_CORE_DATA_SOURCE_KIND;
 }
 export function isAdminViewRestResourceSource(source) {
     return source?.kind === ADMIN_VIEW_REST_SOURCE_KIND;
 }
+/**
+ * Return whether a REST inventory entry has the manual contract shape required
+ * by generated settings screens.
+ */
+export function isAdminViewManualSettingsRestResource(restResource) {
+    return (restResource?.mode === 'manual' &&
+        typeof restResource.bodyTypeName === 'string' &&
+        restResource.bodyTypeName.trim().length > 0 &&
+        typeof restResource.queryTypeName === 'string' &&
+        restResource.queryTypeName.trim().length > 0 &&
+        typeof restResource.responseTypeName === 'string' &&
+        restResource.responseTypeName.trim().length > 0);
+}
+/**
+ * Return whether a REST inventory entry uses route regex groups that a
+ * generated singleton settings screen cannot satisfy with path input.
+ */
+export function hasAdminViewManualSettingsRouteParameters(restResource) {
+    return [restResource?.pathPattern, restResource?.routePattern].some((pattern) => typeof pattern === 'string' &&
+        ADMIN_VIEW_MANUAL_REST_ROUTE_PARAMETER_PATTERN.test(pattern));
+}
 export function formatAdminViewSourceLocator(source) {
     if (isAdminViewCoreDataSource(source)) {
         return `${source.kind}:${source.entityKind}/${source.entityName}`;

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

@@ -126,35 +126,131 @@ function replaceRequiredSyncRestSource(nextSource, target, anchor, replacement,
     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 = source;
-        const importAnchor = [
-            "import {",
-            "\tBLOCKS,",
-            "\tREST_RESOURCES,",
-            "\ttype WorkspaceBlockConfig,",
-            "\ttype WorkspaceRestResourceConfig,",
-            "} from './block-config';",
-        ].join("\n");
+        let nextSource = replaceBlockConfigImportForAiFeatures(source, syncRestScriptPath);
         const helperInsertionAnchor = "async function assertTypeArtifactsCurrent";
         const restResourcesAnchor = "const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );";
-        const noResourcesPattern = /if \( restBlocks.length === 0 && restResources.length === 0 \) \{[\s\S]*?\n\t\treturn;\n\t\}/u;
         const consoleLogPattern = /\n\tconsole\.log\(\n\t\toptions\.check/u;
-        nextSource = replaceRequiredSyncRestSource(nextSource, "AI_FEATURES", importAnchor, [
-            "import {",
-            "\tAI_FEATURES,",
-            "\tBLOCKS,",
-            "\tREST_RESOURCES,",
-            "\ttype WorkspaceAiFeatureConfig,",
-            "\ttype WorkspaceBlockConfig,",
-            "\ttype WorkspaceRestResourceConfig,",
-            "} from './block-config';",
-        ].join("\n"), "workspace inventory import", syncRestScriptPath);
         nextSource = replaceRequiredSyncRestSource(nextSource, "function isWorkspaceAiFeature(", helperInsertionAnchor, [
             "function isWorkspaceAiFeature(",
             "\tfeature: WorkspaceAiFeatureConfig",
@@ -183,16 +279,10 @@ export async function ensureAiFeatureSyncRestAnchors(workspace) {
             "const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );",
             "const aiFeatures = AI_FEATURES.filter( isWorkspaceAiFeature );",
         ].join("\n"), "rest resource filter", syncRestScriptPath);
-        nextSource = replaceRequiredSyncRestSource(nextSource, "restBlocks.length === 0 && restResources.length === 0 && aiFeatures.length === 0", noResourcesPattern, [
-            "if ( restBlocks.length === 0 && restResources.length === 0 && aiFeatures.length === 0 ) {",
-            "\t\tconsole.log(",
-            "\t\t\toptions.check",
-            "\t\t\t\t? 'ℹ️ No REST-enabled workspace blocks, plugin-level REST resources, or AI features are registered yet. `sync-rest --check` is already clean.'",
-            "\t\t\t\t: 'ℹ️ No REST-enabled workspace blocks, plugin-level REST resources, or AI features are registered yet.'",
-            "\t\t);",
-            "\t\treturn;",
-            "\t}",
-        ].join("\n"), "no-resources guard", 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 ) {",
@@ -247,7 +337,7 @@ export async function ensureAiFeatureSyncRestAnchors(workspace) {
             "\tconsole.log(",
             "\t\toptions.check",
         ].join("\n"), "final sync summary", syncRestScriptPath);
-        nextSource = replaceRequiredSyncRestSource(nextSource, "workspace blocks, plugin-level resources, and AI features", "workspace blocks and plugin-level resources", "workspace blocks, plugin-level resources, and AI features", "sync summary copy", syncRestScriptPath);
+        nextSource = replaceAiFeatureSyncSummaryCopy(nextSource, syncRestScriptPath);
         return nextSource;
     });
 }

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

@@ -0,0 +1,15 @@
+/**
+ * Render one `CONTRACTS` inventory entry for `scripts/block-config.ts`.
+ *
+ * @param contractSlug Stable kebab-case contract id.
+ * @param sourceTypeName Exported TypeScript type/interface used for schema generation.
+ */
+export declare function buildContractConfigEntry(contractSlug: string, sourceTypeName: string): string;
+/**
+ * Render a small starter TypeScript contract that users can replace with their
+ * real external route, smoke-test, or PHP integration payload shape.
+ *
+ * @param contractSlug Stable kebab-case contract id.
+ * @param sourceTypeName Exported TypeScript type/interface used for schema generation.
+ */
+export declare function buildContractTypesSource(contractSlug: string, sourceTypeName: string): string;