@specverse/engines 6.53.1 → 6.63.0

package/libs/instance-factories/services/templates/_shared/step-matching.d.ts

@@ -1,39 +0,0 @@
-/**
- * Shared step-matching machinery — common helpers + the canonical
- * `matchAgainstConventions` walker that any ORM-specific step-conventions
- * library can compose with.
- *
- * Each ORM library (prisma, mongodb-native) exports its own
- * `STEP_CONVENTIONS` array of `{name, pattern, generateCall}` items
- * describing what code to emit for matched patterns. The matcher itself
- * is identical across libraries: walk the conventions in order, first
- * match wins; if nothing matches, compute the AI-fallback shape
- * (functionName + inputs + resultVar) deterministically.
- *
- * Extracted from prisma/step-conventions.ts and mongodb-native/step-conventions.ts
- * so future ORM libraries can drop in just the conventions array
- * without re-implementing matching logic. (#43K-D)
- */
-/** Camel-case a step's text into a TS identifier. Identical algorithm
- * across all ORM libraries — function names emitted in `aiBehaviors.<X>(...)`
- * calls must agree with the function declarations the AI-behaviors-generator
- * emits. Both sides go through this. */
-export declare function toMethod(words: string): string;
-export declare function toVar(name: string): string;
-export type { SharedStepContext, SharedConvention, MatchResult, MatcherFn, } from '@specverse/types';
-import type { SharedStepContext, SharedConvention, MatchResult } from '@specverse/types';
-export interface StepMatchRecord {
-    ownerName: string;
-    actionName: string;
-    stepOrdinal: number;
-    stepText: string;
-    matched: boolean;
-    helperMethod?: string;
-    aiFunctionName?: string;
-}
-export declare function setStepMatchRecorder(fn: ((r: StepMatchRecord) => void) | null): void;
-/** Walk conventions in order. First match wins (with empty-string fallthrough).
- * Unmatched: compute the AI-delegate call site shape so the controller and
- * the AI-behaviors-generator agree on function name + inputs + resultVar. */
-export declare function matchAgainstConventions<C extends SharedStepContext>(step: string, ctx: C, conventions: ReadonlyArray<SharedConvention<C>>, aiArgsExpr: (inputs: string[], paramNames: string[]) => string): MatchResult;
-//# sourceMappingURL=step-matching.d.ts.map

package/libs/instance-factories/services/templates/_shared/step-matching.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"step-matching.d.ts","sourceRoot":"","sources":["step-matching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;wCAGwC;AACxC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAMD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAWzF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAEpF;AAED;;6EAE6E;AAC7E,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,iBAAiB,EACjE,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,CAAC,EACN,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAC/C,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,MAAM,GAC7D,WAAW,CAsDb"}

package/libs/instance-factories/services/templates/_shared/step-matching.js

@@ -1,90 +0,0 @@
-/**
- * Shared step-matching machinery — common helpers + the canonical
- * `matchAgainstConventions` walker that any ORM-specific step-conventions
- * library can compose with.
- *
- * Each ORM library (prisma, mongodb-native) exports its own
- * `STEP_CONVENTIONS` array of `{name, pattern, generateCall}` items
- * describing what code to emit for matched patterns. The matcher itself
- * is identical across libraries: walk the conventions in order, first
- * match wins; if nothing matches, compute the AI-fallback shape
- * (functionName + inputs + resultVar) deterministically.
- *
- * Extracted from prisma/step-conventions.ts and mongodb-native/step-conventions.ts
- * so future ORM libraries can drop in just the conventions array
- * without re-implementing matching logic. (#43K-D)
- */
-/** Camel-case a step's text into a TS identifier. Identical algorithm
- * across all ORM libraries — function names emitted in `aiBehaviors.<X>(...)`
- * calls must agree with the function declarations the AI-behaviors-generator
- * emits. Both sides go through this. */
-export function toMethod(words) {
-    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());
-    const safe = camel.replace(/[^A-Za-z0-9_$]/g, '');
-    return safe || 'unnamedStep';
-}
-export function toVar(name) {
-    return name.charAt(0).toLowerCase() + name.slice(1);
-}
-let _stepRecorder = null;
-export function setStepMatchRecorder(fn) {
-    _stepRecorder = fn;
-}
-/** Walk conventions in order. First match wins (with empty-string fallthrough).
- * Unmatched: compute the AI-delegate call site shape so the controller and
- * the AI-behaviors-generator agree on function name + inputs + resultVar. */
-export function matchAgainstConventions(step, ctx, conventions, aiArgsExpr) {
-    let result = null;
-    for (const convention of conventions) {
-        const m = step.match(convention.pattern);
-        if (m) {
-            const call = convention.generateCall(m, ctx);
-            if (call) {
-                result = {
-                    matched: true,
-                    call,
-                    helperMethod: convention.generateMethod?.(m, ctx),
-                };
-                break;
-            }
-        }
-    }
-    if (!result) {
-        // AI fallback shape — same across all ORMs.
-        const functionName = toMethod(step);
-        const declared = Array.from(ctx.declaredVars || []);
-        const paramNames = ctx.parameterNames || [];
-        const inputs = [...paramNames, ...declared];
-        const resultVar = ctx.resultName || `step${ctx.stepNum}Result`;
-        if (ctx.declaredVars)
-            ctx.declaredVars.add(resultVar);
-        const inputObj = aiArgsExpr(inputs, paramNames);
-        result = {
-            matched: false,
-            call: `    // Step ${ctx.stepNum}: ${step} [AI-generated — pure transform]
-    const ${resultVar} = await aiBehaviors.${functionName}(${inputObj});`,
-            functionName,
-            inputs,
-            resultVar,
-        };
-    }
-    // Forward-log the decision. ctx.serviceName carries the spec owner
-    // (controller or service — the shared context uses one field for both).
-    if (_stepRecorder) {
-        try {
-            _stepRecorder({
-                ownerName: ctx.serviceName,
-                actionName: ctx.operationName,
-                stepOrdinal: ctx.stepNum,
-                stepText: step,
-                matched: result.matched,
-                helperMethod: result.helperMethod,
-                aiFunctionName: result.functionName,
-            });
-        }
-        catch { /* recorder must never break generation */ }
-    }
-    return result;
-}
-//# sourceMappingURL=step-matching.js.map

package/libs/instance-factories/services/templates/_shared/step-matching.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"step-matching.js","sourceRoot":"","sources":["step-matching.ts"],"names":[],"mappings":"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"}