@wp-typia/project-tools 0.22.1 → 0.22.3

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

@@ -26,7 +26,9 @@ export interface ScaffoldCompatibilityPolicy {
 export interface ScaffoldCompatibilityConfig {
     hardMinimums: AiFeatureCompatibilityFloor;
     mode: 'baseline' | 'optional' | 'required';
+    optionalFeatureIds: string[];
     optionalFeatures: string[];
+    requiredFeatureIds: string[];
     requiredFeatures: string[];
     runtimeGates: string[];
 }

package/dist/runtime/scaffold-compatibility.js

@@ -88,7 +88,9 @@ export function createScaffoldCompatibilityConfig(policy) {
     return {
         hardMinimums: capabilityPlan.hardMinimums,
         mode: getPolicyMode(capabilityPlan),
+        optionalFeatureIds: capabilityPlan.optionalFeatures.map((feature) => feature.id),
         optionalFeatures: capabilityPlan.optionalFeatures.map((feature) => feature.label),
+        requiredFeatureIds: capabilityPlan.requiredFeatures.map((feature) => feature.id),
         requiredFeatures: capabilityPlan.requiredFeatures.map((feature) => feature.label),
         runtimeGates: [
             ...capabilityPlan.requiredFeatures.flatMap(formatRuntimeGate),

package/dist/runtime/typia-llm.d.ts

@@ -1,6 +1,6 @@
 import type { ArtifactSyncExecutionOptions, EndpointManifestDefinition, EndpointManifestEndpointDefinition } from '@wp-typia/block-runtime/metadata-core';
 import type { ILlmFunction, ILlmSchema, ILlmStructuredOutput } from 'typia';
-import { type EndpointAuthIntent, type EndpointWordPressAuthDefinition } from './schema-core.js';
+import { type EndpointAuthIntent, type EndpointWordPressAuthDefinition, type OpenApiDocument } from './schema-core.js';
 /**
  * Method-level descriptor projected from an endpoint manifest for a generated
  * `typia.llm` controller interface.
@@ -140,6 +140,16 @@ export interface ProjectedTypiaLlmStructuredOutputArtifact {
     /** Structured output parameters generated by `typia.llm`. */
     parameters: ILlmStructuredOutput['parameters'];
 }
+/**
+ * Configures optional OpenAPI-backed constraint restoration for projected
+ * `typia.llm` function artifacts.
+ */
+export interface ProjectTypiaLlmOpenApiProjectionOptions {
+    /** Canonical endpoint-aware OpenAPI document for the projected contracts. */
+    openApiDocument: OpenApiDocument;
+    /** Optional override for resolving one function schema to an operation id. */
+    resolveOperationId?: (functionSchema: TypiaLlmFunctionLike, functionArtifact: ProjectedTypiaLlmFunctionArtifact) => string;
+}
 /**
  * Configures projection of a compiled `typia.llm.application(...)` result into
  * the JSON-friendly adapter artifact.
@@ -149,9 +159,23 @@ export interface ProjectTypiaLlmApplicationArtifactOptions {
     application: TypiaLlmApplicationLike;
     /** Source metadata for the generated JSON artifact. */
     generatedFrom: ProjectedTypiaLlmApplicationArtifact['generatedFrom'];
+    /** Optional OpenAPI projection that restores canonical schema constraints. */
+    openApiProjection?: ProjectTypiaLlmOpenApiProjectionOptions;
     /** Optional hook for adapter-specific function schema normalization. */
     transformFunction?: (functionArtifact: ProjectedTypiaLlmFunctionArtifact, functionSchema: TypiaLlmFunctionLike) => ProjectedTypiaLlmFunctionArtifact;
 }
+/**
+ * Configures direct OpenAPI-backed constraint restoration for one projected
+ * function artifact.
+ */
+export interface ApplyOpenApiConstraintsToTypiaLlmFunctionArtifactOptions {
+    /** Projected function artifact to enrich with canonical constraints. */
+    functionArtifact: ProjectedTypiaLlmFunctionArtifact;
+    /** Canonical endpoint-aware OpenAPI document. */
+    openApiDocument: OpenApiDocument;
+    /** Operation id that owns the request/response contract for this function. */
+    operationId: string;
+}
 /**
  * Configures projection of a compiled `typia.llm.structuredOutput(...)` result
  * into the JSON-friendly adapter artifact.
@@ -197,6 +221,17 @@ export declare function syncTypiaLlmAdapterModule({ check, generatedSourceFile,
  * @returns JSON-friendly function artifact.
  */
 export declare function projectTypiaLlmApplicationFunction(functionSchema: TypiaLlmFunctionLike): ProjectedTypiaLlmFunctionArtifact;
+/**
+ * Restores canonical request and response constraints from an endpoint-aware
+ * OpenAPI document onto one projected `typia.llm` function artifact.
+ *
+ * Query-only inputs merge into the root parameter object. Mixed body/query
+ * inputs merge into the generated `body` and `query` properties.
+ *
+ * @param options Projected artifact plus the canonical OpenAPI document.
+ * @returns A cloned artifact enriched with OpenAPI-backed constraints when available.
+ */
+export declare function applyOpenApiConstraintsToTypiaLlmFunctionArtifact({ functionArtifact, openApiDocument, operationId, }: ApplyOpenApiConstraintsToTypiaLlmFunctionArtifactOptions): ProjectedTypiaLlmFunctionArtifact;
 /**
  * Projects a compiled `typia.llm.application(...)` result into a JSON-friendly
  * downstream adapter artifact.
@@ -204,7 +239,7 @@ export declare function projectTypiaLlmApplicationFunction(functionSchema: Typia
  * @param options Compiled application value and source metadata.
  * @returns JSON-friendly application artifact.
  */
-export declare function projectTypiaLlmApplicationArtifact({ application, generatedFrom, transformFunction, }: ProjectTypiaLlmApplicationArtifactOptions): ProjectedTypiaLlmApplicationArtifact;
+export declare function projectTypiaLlmApplicationArtifact({ application, generatedFrom, openApiProjection, transformFunction, }: ProjectTypiaLlmApplicationArtifactOptions): ProjectedTypiaLlmApplicationArtifact;
 /**
  * Projects a compiled `typia.llm.structuredOutput(...)` result into a
  * JSON-friendly downstream adapter artifact.

package/dist/runtime/typia-llm.js

@@ -81,9 +81,195 @@ const TYPESCRIPT_RESERVED_WORDS = new Set([
     'with',
     'yield',
 ]);
+const JSON_SCHEMA_CONSTRAINT_KEYS = [
+    'additionalProperties',
+    'const',
+    'default',
+    'enum',
+    'exclusiveMaximum',
+    'exclusiveMinimum',
+    'format',
+    'maxItems',
+    'maxLength',
+    'maximum',
+    'minItems',
+    'minLength',
+    'minimum',
+    'multipleOf',
+    'pattern',
+    'type',
+];
 function cloneJsonValueIfDefined(value) {
     return value === undefined ? undefined : cloneJsonValue(value);
 }
+function isJsonSchemaObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function decodeJsonPointerSegment(segment) {
+    return segment.replace(/~1/g, '/').replace(/~0/g, '~');
+}
+function resolveOpenApiReferenceTarget(document, reference) {
+    if (!reference.startsWith('#/')) {
+        throw new Error(`Unsupported OpenAPI schema reference "${reference}".`);
+    }
+    let current = document;
+    for (const rawSegment of reference.slice(2).split('/')) {
+        const segment = decodeJsonPointerSegment(rawSegment);
+        if (Array.isArray(current)) {
+            const index = Number.parseInt(segment, 10);
+            current = Number.isInteger(index) ? current[index] : undefined;
+            continue;
+        }
+        if (!isJsonSchemaObject(current)) {
+            current = undefined;
+            break;
+        }
+        current = current[segment];
+    }
+    if (!isJsonSchemaObject(current)) {
+        throw new Error(`Unable to resolve OpenAPI schema reference "${reference}".`);
+    }
+    return current;
+}
+function resolveOpenApiSchemaObject(document, schema, seenReferences = new Set()) {
+    if (!isJsonSchemaObject(schema)) {
+        return {};
+    }
+    const reference = schema.$ref;
+    if (typeof reference !== 'string') {
+        return schema;
+    }
+    if (seenReferences.has(reference)) {
+        return schema;
+    }
+    return resolveOpenApiSchemaObject(document, resolveOpenApiReferenceTarget(document, reference), new Set([...seenReferences, reference]));
+}
+function collectOpenApiSeenReferences(schema, seenReferences) {
+    const reference = schema.$ref;
+    if (typeof reference !== 'string' || seenReferences.has(reference)) {
+        return seenReferences;
+    }
+    return new Set([...seenReferences, reference]);
+}
+function mergeJsonSchemaConstraintProperties(document, target, source, seenReferences = new Set()) {
+    const nextSeenReferences = collectOpenApiSeenReferences(source, seenReferences);
+    const resolvedSource = resolveOpenApiSchemaObject(document, source, seenReferences);
+    const merged = target;
+    for (const key of JSON_SCHEMA_CONSTRAINT_KEYS) {
+        if (resolvedSource[key] !== undefined) {
+            merged[key] = cloneJsonValue(resolvedSource[key]);
+        }
+    }
+    if (Array.isArray(resolvedSource.required)) {
+        merged.required = resolvedSource.required.filter((value) => typeof value === 'string');
+    }
+    if (Array.isArray(resolvedSource.items)) {
+        merged.items = cloneJsonValue(resolvedSource.items);
+    }
+    else if (isJsonSchemaObject(resolvedSource.items)) {
+        const nextItems = isJsonSchemaObject(merged.items) ? merged.items : {};
+        merged.items = mergeJsonSchemaConstraintProperties(document, nextItems, resolvedSource.items, nextSeenReferences);
+    }
+    if (isJsonSchemaObject(resolvedSource.properties)) {
+        const targetProperties = isJsonSchemaObject(merged.properties)
+            ? merged.properties
+            : {};
+        for (const [propertyName, propertySchema] of Object.entries(resolvedSource.properties)) {
+            if (!isJsonSchemaObject(propertySchema)) {
+                continue;
+            }
+            const nextProperty = isJsonSchemaObject(targetProperties[propertyName])
+                ? targetProperties[propertyName]
+                : {};
+            targetProperties[propertyName] = mergeJsonSchemaConstraintProperties(document, nextProperty, propertySchema, nextSeenReferences);
+        }
+        merged.properties = targetProperties;
+    }
+    return merged;
+}
+function findOpenApiOperationById(document, operationId) {
+    for (const pathItem of Object.values(document.paths)) {
+        if (!isJsonSchemaObject(pathItem)) {
+            continue;
+        }
+        for (const method of ['delete', 'get', 'patch', 'post', 'put']) {
+            const operation = resolveOpenApiSchemaObject(document, pathItem[method]);
+            if (!isJsonSchemaObject(operation) ||
+                typeof operation.operationId !== 'string') {
+                continue;
+            }
+            if (operation.operationId === operationId) {
+                return operation;
+            }
+        }
+    }
+    return null;
+}
+function resolveOpenApiRequestBodySchema(operation, document) {
+    const requestBody = resolveOpenApiSchemaObject(document, operation.requestBody);
+    const content = isJsonSchemaObject(requestBody.content)
+        ? requestBody.content
+        : null;
+    const jsonMediaType = content && isJsonSchemaObject(content['application/json'])
+        ? content['application/json']
+        : null;
+    const schema = jsonMediaType?.schema;
+    if (!isJsonSchemaObject(schema)) {
+        return null;
+    }
+    return resolveOpenApiSchemaObject(document, schema);
+}
+function resolveOpenApiSuccessResponseSchema(operation, document) {
+    for (const [statusCode, response] of Object.entries(operation.responses)) {
+        const resolvedResponse = resolveOpenApiSchemaObject(document, response);
+        if (!/^2(?:\d\d|XX)$/u.test(statusCode) ||
+            !isJsonSchemaObject(resolvedResponse)) {
+            continue;
+        }
+        const content = isJsonSchemaObject(resolvedResponse.content)
+            ? resolvedResponse.content
+            : null;
+        const jsonMediaType = content && isJsonSchemaObject(content['application/json'])
+            ? content['application/json']
+            : null;
+        const schema = jsonMediaType?.schema;
+        if (!isJsonSchemaObject(schema)) {
+            continue;
+        }
+        return resolveOpenApiSchemaObject(document, schema);
+    }
+    return null;
+}
+function getOrCreateObjectProperty(target, propertyName) {
+    const targetProperties = isJsonSchemaObject(target.properties)
+        ? target.properties
+        : {};
+    const nextProperty = isJsonSchemaObject(targetProperties[propertyName])
+        ? targetProperties[propertyName]
+        : {};
+    targetProperties[propertyName] = nextProperty;
+    target.properties = targetProperties;
+    return nextProperty;
+}
+function applyOpenApiQueryParameterConstraints(target, operation, document) {
+    for (const parameter of operation.parameters ?? []) {
+        const resolvedParameter = resolveOpenApiSchemaObject(document, parameter);
+        if (!isJsonSchemaObject(resolvedParameter) ||
+            resolvedParameter.in !== 'query' ||
+            typeof resolvedParameter.name !== 'string') {
+            continue;
+        }
+        const propertyTarget = getOrCreateObjectProperty(target, resolvedParameter.name);
+        mergeJsonSchemaConstraintProperties(document, propertyTarget, resolveOpenApiSchemaObject(document, resolvedParameter.schema));
+        if (resolvedParameter.required === true) {
+            const required = new Set(Array.isArray(target.required)
+                ? target.required.filter((value) => typeof value === 'string')
+                : []);
+            required.add(resolvedParameter.name);
+            target.required = [...required];
+        }
+    }
+}
 function getContractSourceTypeName(manifest, endpoint, contractName) {
     const contract = manifest.contracts[contractName];
     if (!contract) {
@@ -342,6 +528,50 @@ function cloneProjectedTypiaLlmFunctionArtifact(functionArtifact) {
         ...(functionArtifact.tags ? { tags: [...functionArtifact.tags] } : {}),
     };
 }
+/**
+ * Restores canonical request and response constraints from an endpoint-aware
+ * OpenAPI document onto one projected `typia.llm` function artifact.
+ *
+ * Query-only inputs merge into the root parameter object. Mixed body/query
+ * inputs merge into the generated `body` and `query` properties.
+ *
+ * @param options Projected artifact plus the canonical OpenAPI document.
+ * @returns A cloned artifact enriched with OpenAPI-backed constraints when available.
+ */
+export function applyOpenApiConstraintsToTypiaLlmFunctionArtifact({ functionArtifact, openApiDocument, operationId, }) {
+    const constrainedArtifact = cloneProjectedTypiaLlmFunctionArtifact(functionArtifact);
+    const operation = findOpenApiOperationById(openApiDocument, operationId);
+    if (!operation) {
+        return constrainedArtifact;
+    }
+    const hasQueryParameters = (operation.parameters ?? []).some((parameter) => {
+        const resolvedParameter = resolveOpenApiSchemaObject(openApiDocument, parameter);
+        return (isJsonSchemaObject(resolvedParameter) &&
+            resolvedParameter.in === 'query' &&
+            typeof resolvedParameter.name === 'string');
+    });
+    const requestBodySchema = resolveOpenApiRequestBodySchema(operation, openApiDocument);
+    if (requestBodySchema) {
+        if (hasQueryParameters) {
+            mergeJsonSchemaConstraintProperties(openApiDocument, getOrCreateObjectProperty(constrainedArtifact.parameters, 'body'), requestBodySchema);
+        }
+        else {
+            mergeJsonSchemaConstraintProperties(openApiDocument, constrainedArtifact.parameters, requestBodySchema);
+        }
+    }
+    if (hasQueryParameters) {
+        applyOpenApiQueryParameterConstraints(requestBodySchema
+            ? getOrCreateObjectProperty(constrainedArtifact.parameters, 'query')
+            : constrainedArtifact.parameters, operation, openApiDocument);
+    }
+    if (constrainedArtifact.output) {
+        const responseSchema = resolveOpenApiSuccessResponseSchema(operation, openApiDocument);
+        if (responseSchema) {
+            mergeJsonSchemaConstraintProperties(openApiDocument, constrainedArtifact.output, responseSchema);
+        }
+    }
+    return constrainedArtifact;
+}
 /**
  * Projects a compiled `typia.llm.application(...)` result into a JSON-friendly
  * downstream adapter artifact.
@@ -349,13 +579,20 @@ function cloneProjectedTypiaLlmFunctionArtifact(functionArtifact) {
  * @param options Compiled application value and source metadata.
  * @returns JSON-friendly application artifact.
  */
-export function projectTypiaLlmApplicationArtifact({ application, generatedFrom, transformFunction, }) {
+export function projectTypiaLlmApplicationArtifact({ application, generatedFrom, openApiProjection, transformFunction, }) {
     return {
         functions: application.functions.map((functionSchema) => {
             const functionArtifact = projectTypiaLlmApplicationFunction(functionSchema);
-            const transformedArtifact = transformFunction
-                ? transformFunction(functionArtifact, functionSchema)
+            const openApiAlignedArtifact = openApiProjection
+                ? applyOpenApiConstraintsToTypiaLlmFunctionArtifact({
+                    functionArtifact,
+                    openApiDocument: openApiProjection.openApiDocument,
+                    operationId: openApiProjection.resolveOperationId?.(functionSchema, functionArtifact) ?? functionSchema.name,
+                })
                 : functionArtifact;
+            const transformedArtifact = transformFunction
+                ? transformFunction(openApiAlignedArtifact, functionSchema)
+                : openApiAlignedArtifact;
             return cloneProjectedTypiaLlmFunctionArtifact(transformedArtifact);
         }),
         generatedFrom: cloneJsonValue(generatedFrom),

package/dist/runtime/workspace-inventory.js

@@ -121,7 +121,9 @@ const WORKSPACE_COMPATIBILITY_CONFIG_FIELD = `\tcompatibility?: {
 \t\t\twordpress?: string;
 \t\t};
 \t\tmode: 'baseline' | 'optional' | 'required';
+\t\toptionalFeatureIds: string[];
 \t\toptionalFeatures: string[];
+\t\trequiredFeatureIds: string[];
 \t\trequiredFeatures: string[];
 \t\truntimeGates: string[];
 \t};
@@ -670,6 +672,26 @@ function ensureInterfaceField(source, interfaceName, fieldName, fieldSource) {
         return `${start}${body}${body.length > 0 && !body.endsWith(lineEnding) ? lineEnding : ""}${formattedFieldSource}${end}`;
     });
 }
+function normalizeInterfaceFieldBlock(source, interfaceName, fieldName, fieldSource, requiredFragments) {
+    const interfacePattern = new RegExp(`(export\\s+interface\\s+${escapeRegex(interfaceName)}\\s*\\{\\r?\\n)([\\s\\S]*?)(\\r?\\n\\})`, "u");
+    return source.replace(interfacePattern, (match, start, body, end) => {
+        const fieldPattern = new RegExp(`(^([ \\t]*)${escapeRegex(fieldName)}\\??:\\s*\\{[ \\t]*\\r?\\n)([\\s\\S]*?)(^\\2\\};\\r?\\n?)`, "mu");
+        const fieldMatch = fieldPattern.exec(body);
+        if (!fieldMatch) {
+            return match;
+        }
+        const existingFieldSource = fieldMatch[0];
+        if (requiredFragments.every((fragment) => existingFieldSource.includes(fragment))) {
+            return match;
+        }
+        const lineEnding = start.endsWith("\r\n") ? "\r\n" : "\n";
+        const formattedFieldSource = `${fieldSource
+            .replace(/\r?\n$/u, "")
+            .split("\n")
+            .join(lineEnding)}${lineEnding}`;
+        return `${start}${body.slice(0, fieldMatch.index)}${formattedFieldSource}${body.slice(fieldMatch.index + existingFieldSource.length)}${end}`;
+    });
+}
 /**
  * Update `scripts/block-config.ts` source text with additional inventory entries.
  *
@@ -701,7 +723,9 @@ export function updateWorkspaceInventorySource(source, { blockEntries = [], bloc
     nextSource = ensureInterfaceField(nextSource, "WorkspaceBindingSourceConfig", "attribute", "\tattribute?: string;");
     nextSource = ensureInterfaceField(nextSource, "WorkspaceBindingSourceConfig", "block", "\tblock?: string;");
     nextSource = ensureInterfaceField(nextSource, "WorkspaceAbilityConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD);
+    nextSource = normalizeInterfaceFieldBlock(nextSource, "WorkspaceAbilityConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD, ["optionalFeatureIds: string[];", "requiredFeatureIds: string[];"]);
     nextSource = ensureInterfaceField(nextSource, "WorkspaceAiFeatureConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD);
+    nextSource = normalizeInterfaceFieldBlock(nextSource, "WorkspaceAiFeatureConfig", "compatibility", WORKSPACE_COMPATIBILITY_CONFIG_FIELD, ["optionalFeatureIds: string[];", "requiredFeatureIds: string[];"]);
     nextSource = appendEntriesAtMarker(nextSource, EDITOR_PLUGIN_CONFIG_ENTRY_MARKER, editorPluginEntries);
     return nextSource;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.22.1",
+  "version": "0.22.3",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -105,9 +105,9 @@
     "prepack": "bun run build && node ./scripts/publish-manifest.mjs prepare",
     "postpack": "node ./scripts/publish-manifest.mjs restore",
     "test": "bun run build && bun test tests/*.test.ts",
-    "test:quick": "bun run build && bun test tests/workspace-add.test.ts tests/workspace-doctor.test.ts tests/scaffold-compound.test.ts",
+    "test:quick": "bun run build && bun test tests/workspace-add.test.ts tests/cli-add-workspace-ability.test.ts tests/cli-add-workspace-ai.test.ts tests/workspace-doctor.test.ts tests/scaffold-compound.test.ts",
     "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/init-command.test.ts tests/package-versions.test.ts tests/cli-entry.test.ts tests/cli-prompt.test.ts tests/import-policy.test.ts tests/wordpress-ai-spec.test.ts tests/typia-llm.test.ts",
-    "test:workspace": "bun run build && bun test tests/workspace-add.test.ts tests/workspace-doctor.test.ts",
+    "test:workspace": "bun run build && bun test tests/workspace-add.test.ts tests/cli-add-workspace-ability.test.ts tests/cli-add-workspace-ai.test.ts tests/workspace-doctor.test.ts",
     "test:compound": "bun run build && bun test tests/scaffold-compound.test.ts",
     "test:migration-planning": "bun run build && bun test tests/migration-init.test.ts tests/migration-config.test.ts tests/migration-plan-wizard.test.ts",
     "test:migration-execution": "bun run build && bun test tests/migration-scaffold-diff.test.ts tests/migration-doctor.test.ts tests/migration-fixtures-fuzz.test.ts",