@specverse/engines 6.11.2 → 6.16.0

package/dist/libs/instance-factories/services/templates/postgres-native/service-generator.js

@@ -0,0 +1,65 @@
+function generatePgNativeService(context) {
+  const { service } = context;
+  if (!service) throw new Error("Service is required in template context");
+  const serviceName = service.name;
+  const operationsCode = generateOperations(service);
+  const usesDb = /\bquery\b|\bgetPool\b/.test(operationsCode);
+  const hasEvents = service.publishes && service.publishes.length > 0 || service.subscribes && service.subscribes.length > 0;
+  return `/**
+ * ${serviceName}
+ * Abstract business logic service (PostgreSQL native driver)
+ * ${service.description || ""}
+ */
+${usesDb ? `import { query, getPool } from '../db/pgClient.js';` : ""}
+${hasEvents ? `import { eventBus } from '../events/eventBus.js';` : ""}
+
+export class ${serviceName} {
+${operationsCode}
+}
+
+const ${lowerFirst(serviceName)} = new ${serviceName}();
+export const ${lowerFirst(serviceName)}Instance = ${lowerFirst(serviceName)};
+export default ${lowerFirst(serviceName)};
+`;
+}
+function lowerFirst(s) {
+  return s.charAt(0).toLowerCase() + s.slice(1);
+}
+function generateOperations(service) {
+  const ops = service.operations;
+  if (!ops || Array.isArray(ops) && ops.length === 0 || !Array.isArray(ops) && Object.keys(ops).length === 0) {
+    return `
+  /**
+   * Default service entrypoint \u2014 replace with real operations once declared
+   * on the service's spec.
+   */
+  public async execute(_params: any = {}): Promise<any> {
+    throw new Error('${service.name}.execute is not implemented');
+  }
+`;
+  }
+  const entries = Array.isArray(ops) ? ops.map((op) => [op.name, op]) : Object.entries(ops);
+  return entries.map(([name, op]) => generateOperation(name, op, service.name)).join("\n");
+}
+function generateOperation(operationName, operation, serviceName) {
+  const stepsHeader = operation.steps && operation.steps.length > 0 ? operation.steps.map((s) => `   *   - ${typeof s === "string" ? s : s.action || JSON.stringify(s)}`).join("\n") : "   *   (no spec steps declared)";
+  return `
+  /**
+   * ${operationName}
+   * ${operation.description || ""}
+   *
+   * Spec steps:
+${stepsHeader}
+   */
+  public async ${operationName}(_args: any = {}): Promise<any> {
+    // TODO: translate spec steps into pg-native SQL calls. Controllers
+    // already inline conventions today; service-side parity is a
+    // follow-up. For now this stub keeps realize completing and the
+    // service surface callable.
+    throw new Error('${serviceName}.${operationName} is not implemented');
+  }
+`;
+}
+export {
+  generatePgNativeService as default
+};

package/dist/libs/instance-factories/services/templates/postgres-native/step-conventions.js

@@ -0,0 +1,433 @@
+import {
+  toVar,
+  matchAgainstConventions
+} from "../_shared/step-matching.js";
+function deriveModelDefaults(modelName, ctx) {
+  if (!ctx.models) return [];
+  const model = ctx.models[modelName] || ctx.models[modelName.charAt(0).toUpperCase() + modelName.slice(1)];
+  if (!model) return [];
+  const attrs = model.attributes;
+  if (!attrs) return [];
+  const list = Array.isArray(attrs) ? attrs.map((a) => [a.name, a]) : Object.entries(attrs);
+  const declaredVars = ctx.declaredVars || /* @__PURE__ */ new Set();
+  const out = [];
+  const conventionManaged = /* @__PURE__ */ new Set(["createdAt", "updatedAt", "id"]);
+  for (const [name, attr] of list) {
+    if (!name) continue;
+    if (conventionManaged.has(name)) continue;
+    const required = !!attr.required;
+    const hasDefault = attr.default !== void 0;
+    if (!required && !hasDefault) continue;
+    if (hasDefault) {
+      out.push(`${name}: ${formatDefault(attr.default, attr.type)}`);
+      continue;
+    }
+    const type = (attr.type || "String").toLowerCase();
+    if (type === "integer" || type === "int" || type === "number" || type === "float") {
+      const min = attr.min ?? 0;
+      out.push(`${name}: ${min}`);
+    } else if (type === "boolean") {
+      out.push(`${name}: false`);
+    } else if (type === "datetime" || type === "date") {
+      out.push(`${name}: new Date().toISOString()`);
+    } else {
+      const selfVar = modelName.charAt(0).toLowerCase() + modelName.slice(1);
+      const fkMatch = name.match(/^(.+)Id$/);
+      if (fkMatch && fkMatch[1] !== selfVar && declaredVars.has(fkMatch[1])) {
+        out.push(`${name}: (${fkMatch[1]} as any)?.id`);
+      } else {
+        out.push(`${name}: ''`);
+      }
+    }
+  }
+  return out;
+}
+function formatDefault(value, type) {
+  if (value === null || value === void 0) return "null";
+  if (typeof value === "boolean") return String(value);
+  if (typeof value === "number") return String(value);
+  if (typeof value === "string") {
+    if (/^-?\d+(\.\d+)?$/.test(value)) return value;
+    if (value === "true" || value === "false") return value;
+    if (value === "now" && (type === "DateTime" || type === "Date")) {
+      return "new Date().toISOString()";
+    }
+    return JSON.stringify(value);
+  }
+  return JSON.stringify(value);
+}
+function toTable(modelName) {
+  return modelName.toLowerCase() + "s";
+}
+function resolveValue(rawValue, ctx) {
+  const value = rawValue.trim().replace(/^['"]|['"]$/g, "");
+  if (/^(current\s*time|now|timestamp)$/i.test(value)) return "new Date().toISOString()";
+  if (/^-?\d+(\.\d+)?$/.test(value)) return value;
+  if (value === "true" || value === "false") return value;
+  if (value === "null") return "null";
+  const declared = ctx.declaredVars || /* @__PURE__ */ new Set();
+  const params = ctx.parameterNames || [];
+  const head = value.split(".")[0];
+  if (declared.has(head)) return value;
+  if (params.includes(head)) return `args.${value}`;
+  return `'${value.replace(/'/g, "\\'")}'`;
+}
+function mostRecentStepResult(ctx) {
+  const declared = Array.from(ctx.declaredVars || []);
+  const stepResults = declared.filter((v) => /^step\d+Result$/.test(v)).sort((a, b) => parseInt(b.slice(4), 10) - parseInt(a.slice(4), 10));
+  return stepResults[0] ?? null;
+}
+function pascal(model) {
+  return model.charAt(0).toUpperCase() + model.slice(1);
+}
+const PG_STEP_CONVENTIONS = [
+  // --- Find / Lookup by single field ---
+  {
+    name: "find-by-field",
+    pattern: /^(?:look\s+up|find|fetch|get)\s+(\w+)\s+by\s+(\w+)(?:\s+or\s+fail.*)?$/i,
+    generateCall: (m, ctx) => {
+      const model = m[1];
+      const field = m[2];
+      const modelVar = toVar(model);
+      const table = toTable(model);
+      const params = ctx.parameterNames || [];
+      const declared = ctx.declaredVars || /* @__PURE__ */ new Set();
+      const idVal = field === "id" ? params.includes(`${modelVar}Id`) ? `args.${modelVar}Id` : "args.id" : `args.${field}`;
+      if (declared.has(modelVar)) {
+        return `    // Step ${ctx.stepNum}: Find ${model} by ${field} (already loaded)`;
+      }
+      declared.add(modelVar);
+      const failOnMissing = /or\s+fail/i.test(m[0]);
+      return `    // Step ${ctx.stepNum}: Find ${model} by ${field}
+    let ${modelVar} = await findOneByField('${table}', '${field}', ${idVal}) as any;${failOnMissing ? `
+    if (!${modelVar}) throw new Error('${model} not found');` : ""}`;
+    }
+  },
+  // --- Find by composite (two fields) ---
+  {
+    name: "find-by-composite",
+    pattern: /^(?:look\s+up|find|fetch|get)(?:\s+existing)?\s+(\w+)\s+by\s+(\w+)\s+and\s+(\w+)$/i,
+    generateCall: (m, ctx) => {
+      const model = m[1];
+      const f1 = m[2];
+      const f2 = m[3];
+      const modelVar = toVar(model);
+      const table = toTable(model);
+      const declared = ctx.declaredVars || /* @__PURE__ */ new Set();
+      if (declared.has(modelVar)) {
+        return `    // Step ${ctx.stepNum}: Find ${model} by ${f1} and ${f2} (already loaded)`;
+      }
+      declared.add(modelVar);
+      const resolveFieldSource = (f) => {
+        const stripIdMatch = f.match(/^(.+)Id$/);
+        if (stripIdMatch) {
+          const candidate = stripIdMatch[1];
+          if (candidate !== modelVar && declared.has(candidate)) {
+            return `(${candidate} as any)?.id`;
+          }
+        }
+        return `args.${f}`;
+      };
+      const f1Src = resolveFieldSource(f1);
+      const f2Src = resolveFieldSource(f2);
+      return `    // Step ${ctx.stepNum}: Find ${model} by ${f1} and ${f2}
+    let ${modelVar} = await findOneByFields('${table}', { ${f1}: ${f1Src}, ${f2}: ${f2Src} }) as any;`;
+    }
+  },
+  // --- Create model record ---
+  {
+    name: "create",
+    pattern: /^create\s+(?:new\s+)?(\w+)(?:\s+(?:with\s+)?(.+))?/i,
+    generateCall: (m, ctx) => {
+      const model = m[1];
+      const modelVar = toVar(model);
+      const table = toTable(model);
+      const params = ctx.parameterNames || [];
+      const declared = ctx.declaredVars || /* @__PURE__ */ new Set();
+      declared.add(modelVar);
+      const dataExpr = params.length > 0 ? `{ ${params.join(", ")} }` : "args";
+      return `    // Step ${ctx.stepNum}: Create ${model}
+    const ${modelVar} = await insertOne('${table}', ${dataExpr}) as any;`;
+    }
+  },
+  // --- Update specific field on previously-loaded model ---
+  {
+    name: "update-field",
+    pattern: /^update\s+(\w+)\s+(\w+)\s+to\s+(.+)/i,
+    generateCall: (m, ctx) => {
+      const model = m[1];
+      const field = m[2];
+      const rawValue = m[3];
+      const modelVar = toVar(model);
+      if (!ctx.declaredVars?.has(modelVar)) return "";
+      const table = toTable(model);
+      const val = resolveValue(rawValue, ctx);
+      return `    // Step ${ctx.stepNum}: Update ${model}.${field} to ${rawValue.trim()}
+    await updateOneById('${table}', ${modelVar}.id, { ${field}: ${val} });`;
+    }
+  },
+  // --- Update field timestamp ---
+  {
+    name: "update-field-timestamp",
+    pattern: /^update\s+(\w+)\s+(\w+)\s+timestamp$/i,
+    generateCall: (m, ctx) => {
+      const model = m[1];
+      const field = m[2];
+      const modelVar = toVar(model);
+      if (!ctx.declaredVars?.has(modelVar)) return "";
+      const table = toTable(model);
+      return `    // Step ${ctx.stepNum}: Update ${model}.${field} timestamp
+    await updateOneById('${table}', ${modelVar}.id, { ${field}: new Date().toISOString() });`;
+    }
+  },
+  // --- Generic "Update X" (writes args back) ---
+  {
+    name: "update",
+    pattern: /^update\s+(\w+)(?:\s+(.+))?$/i,
+    generateCall: (m, ctx) => {
+      const model = m[1];
+      const modelVar = toVar(model);
+      if (!ctx.declaredVars?.has(modelVar)) return "";
+      const table = toTable(model);
+      return `    // Step ${ctx.stepNum}: Update ${model}
+    await updateOneById('${table}', ${modelVar}.id, args);`;
+    }
+  },
+  // --- Delete model record ---
+  {
+    name: "delete",
+    pattern: /^delete\s+(\w+)/i,
+    generateCall: (m, ctx) => {
+      const model = m[1];
+      const modelVar = toVar(model);
+      if (!ctx.declaredVars?.has(modelVar)) return "";
+      const table = toTable(model);
+      return `    // Step ${ctx.stepNum}: Delete ${model}
+    await deleteOneById('${table}', ${modelVar}.id);`;
+    }
+  },
+  // --- Transition to lifecycle state ---
+  {
+    name: "transition",
+    pattern: /^transition\s+(\w+)\s+to\s+(\w+)/i,
+    generateCall: (m, ctx) => {
+      const model = m[1];
+      const state = m[2];
+      const modelVar = toVar(model);
+      if (!ctx.declaredVars?.has(modelVar)) return "";
+      const table = toTable(model);
+      return `    // Step ${ctx.stepNum}: Transition ${model} to ${state}
+    if ((${modelVar} as any).status === '${state}') throw new Error('${model} is already ${state}');
+    await updateOneById('${table}', ${modelVar}.id, { status: '${state}' });`;
+    }
+  },
+  // --- Set field to value (on the controller's primary model) ---
+  {
+    name: "set",
+    pattern: /^set\s+(\w+)\s+to\s+(.+)/i,
+    generateCall: (m, ctx) => {
+      const field = m[1];
+      const rawValue = m[2];
+      const modelVar = toVar(ctx.modelName);
+      const val = resolveValue(rawValue, ctx);
+      return `    // Step ${ctx.stepNum}: Set ${field} to ${rawValue.trim()}
+    await updateOneById(TABLE_NAME, (${modelVar} as any).id, { ${field}: ${val} });`;
+    }
+  },
+  // --- Increment / Decrement ---
+  // Postgres has no Mongo $inc; emit a column = column +/- N update. The
+  // helper updateOneById doesn't support raw SQL fragments, so emit query
+  // directly here.
+  {
+    name: "increment",
+    pattern: /^increment\s+(\w+)\s+by\s+(\w+)/i,
+    generateCall: (m, ctx) => {
+      const field = m[1];
+      const amount = m[2];
+      const modelVar = toVar(ctx.modelName);
+      return `    // Step ${ctx.stepNum}: Increment ${field} by ${amount}
+    await query(\`UPDATE "\${TABLE_NAME}" SET "${field}" = "${field}" + $1 WHERE "id" = $2\`, [${amount}, (${modelVar} as any).id]);`;
+    }
+  },
+  {
+    name: "decrement",
+    pattern: /^decrement\s+(\w+)\s+by\s+(\w+)/i,
+    generateCall: (m, ctx) => {
+      const field = m[1];
+      const amount = m[2];
+      const modelVar = toVar(ctx.modelName);
+      return `    // Step ${ctx.stepNum}: Decrement ${field} by ${amount}
+    await query(\`UPDATE "\${TABLE_NAME}" SET "${field}" = "${field}" - $1 WHERE "id" = $2\`, [${amount}, (${modelVar} as any).id]);`;
+    }
+  },
+  // --- Persist / Save / Store ---
+  {
+    name: "persist",
+    pattern: /^(?:persist|save|store)\s+(\w+(?:\s+\w+)?)(?:\s+(?:for|to|record).*)?$/i,
+    generateCall: (m, ctx) => {
+      const target = toVar(m[1].replace(/\s+(.)/g, (_, c) => c.toUpperCase()));
+      const table = toTable(target);
+      const recordSrc = mostRecentStepResult(ctx) ?? "args";
+      return `    // Step ${ctx.stepNum}: Persist ${m[1]}
+    {
+      const _rec: any = ${recordSrc} && typeof ${recordSrc} === 'object' && !Array.isArray(${recordSrc})
+        ? ${recordSrc} : { value: ${recordSrc} };
+      await insertOne('${table}', _rec);
+    }`;
+    }
+  },
+  // --- Conditional create ---
+  {
+    name: "conditional-create",
+    pattern: /^if\s+(\w+)\s+does\s+not\s+exist,?\s+create\s+new\s+(\w+)(?:\s+with\s+.+)?$/i,
+    generateCall: (m, ctx) => {
+      const modelVar = toVar(m[1]);
+      const Model = pascal(m[2]);
+      const table = toTable(Model);
+      if (!ctx.declaredVars?.has(modelVar)) return "";
+      const defaults = deriveModelDefaults(Model, ctx);
+      const defaultsBlock = defaults.length > 0 ? defaults.join(", ") + "," : "";
+      return `    // Step ${ctx.stepNum}: If ${modelVar} does not exist, create new ${Model}
+    if (!${modelVar}) {
+      const _newRecord = { ${defaultsBlock} ...args, createdAt: new Date().toISOString(), updatedAt: new Date().toISOString() };
+      ${modelVar} = await insertOne('${table}', _newRecord) as any;
+    }`;
+    }
+  },
+  // --- Conditional update ---
+  {
+    name: "conditional-update",
+    pattern: /^if\s+(\w+)\s+exists,?\s+update\s+(\w+)(?:\s+(.+))?$/i,
+    generateCall: (m, ctx) => {
+      const modelVar = toVar(m[1]);
+      const field = m[2];
+      const table = toTable(m[1]);
+      if (!ctx.declaredVars?.has(modelVar)) return "";
+      return `    // Step ${ctx.stepNum}: If ${modelVar} exists, update ${field}
+    if (${modelVar}) {
+      await updateOneById('${table}', (${modelVar} as any).id, { ${field}: new Date().toISOString() });
+    }`;
+    }
+  },
+  // --- Auto-create / Bulk fan-out ---
+  {
+    name: "auto-create-loop",
+    pattern: /^(?:auto-create|bulk\s+create)\s+(\w+)\s+(?:profile|record|entry|entries)?s?\s+for\s+(?:all\s+)?(?:available\s+)?(\w+)$/i,
+    generateCall: (m, ctx) => {
+      const Model = pascal(m[1]);
+      const targetTable = toTable(Model);
+      const sourceTable = m[2].toLowerCase();
+      const declared = Array.from(ctx.declaredVars || []);
+      const ownerVar = declared.find((v) => !/^step\d+Result$/.test(v) && v !== "args");
+      const sourceSingular = sourceTable.replace(/s$/, "");
+      const linkField = sourceSingular + "Id";
+      const ownerLinkField = ownerVar ? ownerVar + "Id" : "ownerId";
+      const modelDefaults = deriveModelDefaults(Model, ctx);
+      const defaultsBlock = modelDefaults.length > 0 ? modelDefaults.filter((d) => !d.startsWith(`${ownerLinkField}:`) && !d.startsWith(`${linkField}:`)).join(", ") : "";
+      return `    // Step ${ctx.stepNum}: Auto-create ${m[1]} ${m[2]} for all ${m[2]}
+    {
+      const _allItems = await findAll('${sourceTable}');
+      const _ownerId = ${ownerVar ? `(${ownerVar} as any)?.id` : "null"};
+      const _records = _allItems.map((_item: any) => ({
+        ${defaultsBlock ? defaultsBlock + "," : ""}
+        ${ownerLinkField}: _ownerId,
+        ${linkField}: (_item as any).${sourceSingular}Id ?? (_item as any).id,
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+      }));
+      if (_records.length > 0) {
+        await insertMany('${targetTable}', _records);
+      }
+    }`;
+    }
+  },
+  // --- "Otherwise create new X record" ---
+  {
+    name: "otherwise-create",
+    pattern: /^otherwise\s+create\s+(?:new\s+)?(\w+)\s+record$/i,
+    generateCall: (m, ctx) => {
+      const Model = pascal(m[1]);
+      const modelVar = toVar(Model);
+      const table = toTable(Model);
+      const wasDeclared = ctx.declaredVars?.has(modelVar);
+      const declared = Array.from(ctx.declaredVars || []);
+      const defaults = deriveModelDefaults(Model, ctx);
+      const supplied = /* @__PURE__ */ new Set();
+      for (const entry of defaults) {
+        const colonIdx = entry.indexOf(":");
+        if (colonIdx > 0) supplied.add(entry.slice(0, colonIdx).trim());
+      }
+      const fkAssignments = declared.filter((v) => v !== modelVar && !/^step\d+Result$/.test(v) && v !== "args").filter((v) => !supplied.has(v + "Id")).map((v) => {
+        supplied.add(v + "Id");
+        return `${v}Id: (${v} as any)?.id`;
+      }).join(", ");
+      const defaultsBlock = defaults.length > 0 ? defaults.join(", ") + "," : "";
+      ctx.declaredVars?.add(modelVar);
+      return `    // Step ${ctx.stepNum}: Otherwise create new ${Model} record
+    else {
+      const _newRecord = { ${defaultsBlock} ${fkAssignments ? fkAssignments + "," : ""} ...args, createdAt: new Date().toISOString(), updatedAt: new Date().toISOString() };
+      ${wasDeclared ? `${modelVar} = await insertOne('${table}', _newRecord) as any;` : `const ${modelVar} = await insertOne('${table}', _newRecord) as any;
+      void ${modelVar};`}
+    }`;
+    }
+  },
+  // --- Send/Emit/Publish event ---
+  {
+    name: "send-event",
+    pattern: /^(?:send|emit|publish)\s+(\w+)\s+event/i,
+    generateCall: (m, ctx) => {
+      const event = m[1];
+      const modelVar = toVar(ctx.modelName);
+      const hasModelVar = ctx.declaredVars?.has(modelVar);
+      const payload = hasModelVar ? `{ ${modelVar}Id: (${modelVar} as any)?.id, operation: '${ctx.operationName}', timestamp: new Date().toISOString() }` : `{ operation: '${ctx.operationName}', timestamp: new Date().toISOString() }`;
+      return `    // Step ${ctx.stepNum}: Emit ${event} event
+    await eventBus.publish('${event}', ${payload} as any);`;
+    }
+  },
+  // --- Call service ---
+  {
+    name: "call-service",
+    pattern: /^call\s+(\w+)\.(\w+)/i,
+    generateCall: (m, ctx) => {
+      const service = m[1];
+      const method = m[2];
+      const args = (ctx.parameterNames || []).join(", ");
+      return `    // Step ${ctx.stepNum}: Call ${service}.${method}
+    await (${toVar(service)} as any).${method}({ ${args} });`;
+    }
+  },
+  // --- Return ---
+  {
+    name: "return-model",
+    pattern: /^return\s+(?:the\s+|updated\s+|created\s+)?(\w+)\s*$/i,
+    generateCall: (m, ctx) => {
+      const valueRaw = m[1].trim();
+      const declared = ctx.declaredVars || /* @__PURE__ */ new Set();
+      const params = ctx.parameterNames || [];
+      const modelVar = toVar(ctx.modelName);
+      if (valueRaw.toLowerCase() === ctx.modelName.toLowerCase() || valueRaw === modelVar) {
+        return `    // Step ${ctx.stepNum}: Return ${ctx.modelName}
+    return ${modelVar};`;
+      }
+      if (declared.has(valueRaw)) {
+        return `    // Step ${ctx.stepNum}: Return ${valueRaw}
+    return ${valueRaw};`;
+      }
+      if (params.includes(valueRaw)) {
+        return `    // Step ${ctx.stepNum}: Return ${valueRaw}
+    return args.${valueRaw};`;
+      }
+      return `    // Step ${ctx.stepNum}: Return ${valueRaw} \u2014 TODO: resolve binding
+    return null;`;
+    }
+  }
+];
+function matchPgStep(step, ctx) {
+  const aiArgsExpr = (inputs, paramNames) => inputs.length > 0 ? `{ ${inputs.map((n) => paramNames.includes(n) ? `${n}: args.${n}` : n).join(", ")} }` : "{}";
+  return matchAgainstConventions(step, ctx, PG_STEP_CONVENTIONS, aiArgsExpr);
+}
+export {
+  PG_STEP_CONVENTIONS,
+  deriveModelDefaults,
+  matchPgStep
+};

package/dist/libs/instance-factories/services/templates/prisma/ai-behaviors-generator.js

@@ -75,7 +75,7 @@ async function validateTypeScriptTypes(code) {
     return null;
   }
 }
-const PROMPT_VERSION = "9.2.0";
+const PROMPT_VERSION = "9.7.0";
 function cacheKey(step, modelName, operationName, functionName, inputs) {
   const payload = JSON.stringify({ step, modelName, operationName, functionName, inputs: [...inputs].sort(), v: PROMPT_VERSION });
   return createHash("sha256").update(payload).digest("hex").slice(0, 16);

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

@@ -1,12 +1,8 @@
-function toVar(name) {
-  return name.charAt(0).toLowerCase() + name.slice(1);
-}
-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";
-}
+import {
+  toMethod,
+  toVar,
+  matchAgainstConventions
+} from "../_shared/step-matching.js";
 function resolveValue(rawValue, ctx) {
   const value = rawValue.trim().replace(/^['"]|['"]$/g, "");
   if (/^(current\s*time|now|timestamp)$/i.test(value)) {
@@ -252,31 +248,8 @@ const STEP_CONVENTIONS = [
   }
 ];
 function matchStep(step, ctx) {
-  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
-      };
-    }
-  }
-  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`;
-  const inputObj = inputs.length > 0 ? `{ ${inputs.join(", ")} }` : "{}";
-  if (ctx.declaredVars) ctx.declaredVars.add(resultVar);
-  return {
-    call: `    // Step ${ctx.stepNum}: ${step} [AI-generated \u2014 pure function]
-    const ${resultVar} = await aiBehaviors.${functionName}(${inputObj});`,
-    matched: false,
-    functionName,
-    inputs,
-    resultVar
-  };
+  const aiArgsExpr = (inputs, _paramNames) => inputs.length > 0 ? `{ ${inputs.join(", ")} }` : "{}";
+  return matchAgainstConventions(step, ctx, STEP_CONVENTIONS, aiArgsExpr);
 }
 export {
   STEP_CONVENTIONS,

package/dist/realize/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realize/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AAItC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMlE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AA0DnF,cAAM,sBAAuB,YAAW,aAAa;IACnD,IAAI,SAAa;IACjB,OAAO,SAAW;IAClB,YAAY,WAA+E;IAE3F,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAS;IAEtB,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDjB,OAAO,IAAI,UAAU;IAIrB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG;IAK1B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAKvF;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA40B9F;;;OAGG;YACW,UAAU;IA8DxB,OAAO,CAAC,oBAAoB;CAuB7B;AAED,eAAO,MAAM,MAAM,wBAA+B,CAAC;AACnD,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realize/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AAItC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMlE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AA0DnF,cAAM,sBAAuB,YAAW,aAAa;IACnD,IAAI,SAAa;IACjB,OAAO,SAAW;IAClB,YAAY,WAA+E;IAE3F,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAS;IAEtB,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDjB,OAAO,IAAI,UAAU;IAIrB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG;IAK1B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAKvF;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAm1B9F;;;OAGG;YACW,UAAU;IA8DxB,OAAO,CAAC,oBAAoB;CAuB7B;AAED,eAAO,MAAM,MAAM,wBAA+B,CAAC;AACnD,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/realize/index.js

@@ -286,6 +286,14 @@ class SpecVerseRealizeEngine {
                             matcher = matchMongoStep;
                         }
                     }
+                    else if (ormFactoryName === 'PostgresNativeDriver') {
+                        const pgMatcherPath = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'libs', 'instance-factories', 'services', 'templates', 'postgres-native', 'step-conventions.ts');
+                        const pgMatcherSrc = resolveGenPath(pgMatcherPath);
+                        if (pgMatcherSrc) {
+                            const { matchPgStep } = await import(pgMatcherSrc);
+                            matcher = matchPgStep;
+                        }
+                    }
                     let aiBehaviorCount = 0;
                     for (const model of allModels) {
                         const ctrlName = `${model.name}Controller`;