@specverse/engines 6.7.8 → 6.16.0

package/libs/instance-factories/services/templates/prisma/step-conventions.ts

@@ -3,45 +3,25 @@
  *
  * Each convention maps a natural language step pattern to generated code.
  * Patterns are tried in order; first match wins. Unmatched steps get stubs.
+ *
+ * The match-walker + toMethod/toVar identifier helpers live in
+ * `../_shared/step-matching.ts` so the same machinery powers
+ * `mongodb-native/step-conventions.ts`. This file is now (almost
+ * entirely) the prisma-specific conventions array.  (#43K-D)
  */
 
-export interface StepConvention {
-  name: string;
-  pattern: RegExp;
-  generateCall: (match: RegExpMatchArray, ctx: StepContext) => string;
-  generateMethod?: (match: RegExpMatchArray, ctx: StepContext) => string;
-}
-
-export interface StepContext {
-  modelName: string;
-  prismaModel: string;
-  serviceName: string;
-  operationName: string;
-  stepNum: number;
-  /** Parameter names from the action (e.g., ['pollId', 'optionId']) */
-  parameterNames?: string[];
-  /** Variables already declared (to avoid redeclaration) */
-  declaredVars?: Set<string>;
-  /** Named result variable (from spec's `as:` clause) */
-  resultName?: string;
-}
+import {
+  toMethod,
+  toVar,
+  matchAgainstConventions,
+  type SharedConvention,
+  type SharedStepContext,
+} from '../_shared/step-matching.js';
 
-function toVar(name: string): string {
-  return name.charAt(0).toLowerCase() + name.slice(1);
-}
+export type StepConvention = SharedConvention<StepContext>;
 
-function toMethod(words: string): string {
-  // Split on whitespace AND non-identifier chars (hyphens, commas, equals,
-  // parens, etc.) so step text like "Compile via expr-eval Parser" yields
-  // "compileViaExprEvalParser", not "compileViaExpr-evalParser" (which is
-  // not a valid TypeScript identifier and breaks esbuild downstream).
-  const cleaned = words.trim().replace(/[^A-Za-z0-9\s]+/g, ' ');
-  const camel = cleaned.replace(/\s+(.)/g, (_, c) => c.toUpperCase()).replace(/^\w/, c => c.toLowerCase());
-  // Strip any remaining non-identifier chars (digits at start, etc.) and
-  // ensure the result is a valid TS identifier. If the input collapses to
-  // the empty string, fall back to a generic name.
-  const safe = camel.replace(/[^A-Za-z0-9_$]/g, '');
-  return safe || 'unnamedStep';
+export interface StepContext extends SharedStepContext {
+  prismaModel: string;
 }
 
 /**
@@ -367,37 +347,10 @@ export function matchStep(
   inputs?: string[];
   resultVar?: string;
 } {
-  for (const convention of STEP_CONVENTIONS) {
-    const match = step.match(convention.pattern);
-    if (match) {
-      return {
-        call: convention.generateCall(match, ctx),
-        helperMethod: convention.generateMethod?.(match, ctx),
-        matched: true,
-      };
-    }
-  }
-
-  // No match — pure AI function call
-  // Inputs = all variables declared by previous steps + operation parameters
-  const functionName = toMethod(step);
-  const declared = Array.from(ctx.declaredVars || []);
-  const paramNames = ctx.parameterNames || [];
-  const inputs = [...paramNames, ...declared];
-
-  // Use named result from spec (`as:`) or default to stepNResult
-  const resultVar = ctx.resultName || `step${ctx.stepNum}Result`;
-  const inputObj = inputs.length > 0 ? `{ ${inputs.join(', ')} }` : '{}';
-
-  // Register the result variable so subsequent steps can reference it
-  if (ctx.declaredVars) ctx.declaredVars.add(resultVar);
-
-  return {
-    call: `    // Step ${ctx.stepNum}: ${step} [AI-generated — pure function]
-    const ${resultVar} = await aiBehaviors.${functionName}(${inputObj});`,
-    matched: false,
-    functionName,
-    inputs,
-    resultVar,
-  };
+  // Prisma's AI-fallback uses plain field shorthand `{ a, b, c }` (no
+  // `args.X` indirection — the controller-generator destructures params
+  // at function entry).
+  const aiArgsExpr = (inputs: string[], _paramNames: string[]) =>
+    inputs.length > 0 ? `{ ${inputs.join(', ')} }` : '{}';
+  return matchAgainstConventions(step, ctx, STEP_CONVENTIONS, aiArgsExpr);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specverse/engines",
-  "version": "6.7.8",
+  "version": "6.16.0",
   "description": "SpecVerse toolchain — parser, inference, realize, generators, AI, registry, bundles",
   "type": "module",
   "main": "dist/index.js",
@@ -61,8 +61,9 @@
     "@ai-sdk/anthropic": "^3.0.71",
     "@ai-sdk/openai-compatible": "^2.0.41",
     "@ai-sdk/provider": "^3.0.8",
-    "@specverse/assets": "^1.6.0",
-    "@specverse/entities": "^5.1.0",
+    "@specverse/assets": "^1.10.2",
+    "@specverse/engines": "^6.15.0",
+    "@specverse/entities": "^5.2.2",
     "@specverse/runtime": "^5.0.1",
     "@specverse/types": "^5.1.0",
     "ai": "^6.0.168",