@vijaypjavvadi/bdd2pw 3.3.0 → 3.5.0

package/dist/llm/index.d.ts

@@ -11,7 +11,7 @@ import type { LLMClient, LLMClientOptions } from "./types";
 export { AnthropicLLMClient } from "./anthropicClient";
 export { CandidateRulesWriter } from "./candidateRules";
 export { GovernanceClient, GovernanceUnreachableError } from "./governanceClient";
-export { matchStepWithLLM, matchStepsWithLLM, type MatchStepWithLLMContext, } from "./llmStepMatcher";
+export { matchStepWithLLM, matchStepsWithLLM, matchScenarioWithLLM, type MatchStepWithLLMContext, } from "./llmStepMatcher";
 export type { CandidateRuleEntry, GenerateBindingInput, GenerateBindingResult, LLMClient, LLMClientOptions, LLMLogEvent, } from "./types";
 /**
  * Construct the right LLMClient for the given options. Today the only

package/dist/llm/index.js

@@ -42,7 +42,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.matchStepsWithLLM = exports.matchStepWithLLM = exports.GovernanceUnreachableError = exports.GovernanceClient = exports.CandidateRulesWriter = exports.AnthropicLLMClient = void 0;
+exports.matchScenarioWithLLM = exports.matchStepsWithLLM = exports.matchStepWithLLM = exports.GovernanceUnreachableError = exports.GovernanceClient = exports.CandidateRulesWriter = exports.AnthropicLLMClient = void 0;
 exports.createLLMClient = createLLMClient;
 const path = __importStar(require("path"));
 const anthropicClient_1 = require("./anthropicClient");
@@ -56,6 +56,7 @@ Object.defineProperty(exports, "GovernanceUnreachableError", { enumerable: true,
 var llmStepMatcher_1 = require("./llmStepMatcher");
 Object.defineProperty(exports, "matchStepWithLLM", { enumerable: true, get: function () { return llmStepMatcher_1.matchStepWithLLM; } });
 Object.defineProperty(exports, "matchStepsWithLLM", { enumerable: true, get: function () { return llmStepMatcher_1.matchStepsWithLLM; } });
+Object.defineProperty(exports, "matchScenarioWithLLM", { enumerable: true, get: function () { return llmStepMatcher_1.matchScenarioWithLLM; } });
 /**
  * Construct the right LLMClient for the given options. Today the only
  * provider is "anthropic"; the factory exists so v2.1 (OpenAI/Gemini)

package/dist/llm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCH,0CAiBC;AAlDD,2CAA6B;AAC7B,uDAAuD;AAGvD,qDAAuD;AAA9C,qHAAA,kBAAkB,OAAA;AAC3B,mDAAwD;AAA/C,sHAAA,oBAAoB,OAAA;AAC7B,uDAAkF;AAAzE,oHAAA,gBAAgB,OAAA;AAAE,8HAAA,0BAA0B,OAAA;AACrD,mDAI0B;AAHxB,kHAAA,gBAAgB,OAAA;AAChB,mHAAA,iBAAiB,OAAA;AAYnB;;;;;;;;;;;GAWG;AACH,SAAgB,eAAe,CAC7B,IAAkC,EAClC,QAAgB;IAEhB,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAChC,QAAQ,EACR,SAAS,EACT,kBAAkB,CACnB,CAAC;IACF,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,WAAW;YACd,OAAO,IAAI,oCAAkB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACxD;YACE,iCAAiC;YACjC,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCH,0CAiBC;AAnDD,2CAA6B;AAC7B,uDAAuD;AAGvD,qDAAuD;AAA9C,qHAAA,kBAAkB,OAAA;AAC3B,mDAAwD;AAA/C,sHAAA,oBAAoB,OAAA;AAC7B,uDAAkF;AAAzE,oHAAA,gBAAgB,OAAA;AAAE,8HAAA,0BAA0B,OAAA;AACrD,mDAK0B;AAJxB,kHAAA,gBAAgB,OAAA;AAChB,mHAAA,iBAAiB,OAAA;AACjB,sHAAA,oBAAoB,OAAA;AAYtB;;;;;;;;;;;GAWG;AACH,SAAgB,eAAe,CAC7B,IAAkC,EAClC,QAAgB;IAEhB,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAChC,QAAQ,EACR,SAAS,EACT,kBAAkB,CACnB,CAAC;IACF,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,WAAW;YACd,OAAO,IAAI,oCAAkB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACxD;YACE,iCAAiC;YACjC,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/llm/llmStepMatcher.d.ts

@@ -35,6 +35,15 @@ export interface MatchStepWithLLMContext {
      * stalled on disk, governance fetch stalled below the SDK).
      */
     stepDeadlineMs?: number;
+    /**
+     * v3.5.0 — opt out of per-scenario batching. When true,
+     * `matchScenarioWithLLM` walks step-by-step through
+     * `matchStepWithLLM` instead of folding unmatched steps into a
+     * single batch call. Use only if you've hit a provider per-prompt
+     * token limit on large batches, or want strict 1:1 call accounting
+     * for audit reasons.
+     */
+    disableBatch?: boolean;
 }
 export declare function matchStepWithLLM(step: StepIR, pom: PageObjectIR, pageVar: string, ctx: MatchStepWithLLMContext): Promise<StepBinding>;
 /**
@@ -44,3 +53,31 @@ export declare function matchStepWithLLM(step: StepIR, pom: PageObjectIR, pageVa
  * the cache and pay for the same step twice.
  */
 export declare function matchStepsWithLLM(steps: StepIR[], pom: PageObjectIR, pageVar: string, ctx: MatchStepWithLLMContext): Promise<StepBinding[]>;
+/**
+ * v3.5.0 — batch the LLM fallback per scenario.
+ *
+ * Per-scenario, this is significantly cheaper than per-step:
+ *   - Each unmatched step is ONE entry in a single batch prompt.
+ *   - Shared POM context is sent ONCE per batch (not per step).
+ *   - One round-trip latency, not N.
+ *   - One budget tick, not N.
+ *
+ * The cache still works exactly as before — each step has the same
+ * cache key it would have in the per-step path. AnthropicLLMClient's
+ * `generateBatchBindings` checks the cache per-step first; only
+ * cache-misses go into the batch prompt.
+ *
+ * Failure modes:
+ *   - LLM client doesn't implement `generateBatchBindings` (e.g.
+ *     custom client, older MockLLMClient): falls back to per-step
+ *     `matchStepWithLLM` for every unmatched step.
+ *   - Batch parse error: every slot in the batch comes back with an
+ *     `error` result, which we then annotate as a per-step warning.
+ *   - One bad slot in an otherwise-good batch: only that slot's
+ *     step gets the warning annotation; the rest succeed.
+ *
+ * The candidate-rules.jsonl writer still receives one entry per
+ * successful LLM binding (same as per-step) so the offline review
+ * pipeline doesn't notice the batching change.
+ */
+export declare function matchScenarioWithLLM(steps: StepIR[], pom: PageObjectIR, pageVar: string, ctx: MatchStepWithLLMContext): Promise<StepBinding[]>;

package/dist/llm/llmStepMatcher.js

@@ -16,6 +16,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.matchStepWithLLM = matchStepWithLLM;
 exports.matchStepsWithLLM = matchStepsWithLLM;
+exports.matchScenarioWithLLM = matchScenarioWithLLM;
 const stepMatcher_1 = require("../transformers/stepMatcher");
 const commentSafe_1 = require("../utils/commentSafe");
 async function matchStepWithLLM(step, pom, pageVar, ctx) {
@@ -123,4 +124,120 @@ async function matchStepsWithLLM(steps, pom, pageVar, ctx) {
     }
     return out;
 }
+/**
+ * v3.5.0 — batch the LLM fallback per scenario.
+ *
+ * Per-scenario, this is significantly cheaper than per-step:
+ *   - Each unmatched step is ONE entry in a single batch prompt.
+ *   - Shared POM context is sent ONCE per batch (not per step).
+ *   - One round-trip latency, not N.
+ *   - One budget tick, not N.
+ *
+ * The cache still works exactly as before — each step has the same
+ * cache key it would have in the per-step path. AnthropicLLMClient's
+ * `generateBatchBindings` checks the cache per-step first; only
+ * cache-misses go into the batch prompt.
+ *
+ * Failure modes:
+ *   - LLM client doesn't implement `generateBatchBindings` (e.g.
+ *     custom client, older MockLLMClient): falls back to per-step
+ *     `matchStepWithLLM` for every unmatched step.
+ *   - Batch parse error: every slot in the batch comes back with an
+ *     `error` result, which we then annotate as a per-step warning.
+ *   - One bad slot in an otherwise-good batch: only that slot's
+ *     step gets the warning annotation; the rest succeed.
+ *
+ * The candidate-rules.jsonl writer still receives one entry per
+ * successful LLM binding (same as per-step) so the offline review
+ * pipeline doesn't notice the batching change.
+ */
+async function matchScenarioWithLLM(steps, pom, pageVar, ctx) {
+    // 1) Rule pass for every step. Cheap; pure-sync inside.
+    const ruleBindings = steps.map((s) => (0, stepMatcher_1.matchStep)(s, pom, pageVar));
+    // 2) Identify warning slots. If no LLM client or budget exhausted,
+    //    bail out with the rule bindings — same as the per-step path.
+    if (!ctx.llm)
+        return ruleBindings;
+    const warningIndexes = ruleBindings
+        .map((b, i) => (b.warning ? i : -1))
+        .filter((i) => i >= 0);
+    if (warningIndexes.length === 0)
+        return ruleBindings;
+    if (ctx.llm.budgetExhausted())
+        return ruleBindings;
+    // 3) Choose the path: batch when the client supports it, otherwise
+    //    fall back to per-step. Single-warning batches also fall through
+    //    to the per-step path so the existing watchdog / deadline /
+    //    candidate-rules-writer machinery handles them.
+    const batchCapable = typeof ctx.llm.generateBatchBindings === "function";
+    if (!batchCapable || warningIndexes.length === 1 || ctx.disableBatch) {
+        const out = [...ruleBindings];
+        for (const idx of warningIndexes) {
+            out[idx] = await matchStepWithLLM(steps[idx], pom, pageVar, ctx);
+        }
+        return out;
+    }
+    // 4) Batch path. Build inputs in the same order as warningIndexes.
+    const inputs = warningIndexes.map((idx) => ({
+        step: steps[idx],
+        pom,
+        pageVar,
+        url: ctx.url,
+        scaffoldId: ctx.scaffoldId,
+    }));
+    let batchResults;
+    try {
+        batchResults = await ctx.llm.generateBatchBindings(inputs);
+    }
+    catch (err) {
+        // Wrap-failure: annotate every warning slot with the throw message
+        // and continue. Matches the per-step path's `LLM fallback threw`
+        // annotation.
+        const message = (0, commentSafe_1.flattenForComment)(err instanceof Error ? err.message : err);
+        const out = [...ruleBindings];
+        for (const idx of warningIndexes) {
+            out[idx] = {
+                ...ruleBindings[idx],
+                warning: `${ruleBindings[idx].warning} (LLM batch threw: ${message})`,
+            };
+        }
+        return out;
+    }
+    // 5) Distribute results back to their original positions. Write
+    //    candidate-rules.jsonl for every success; annotate warnings
+    //    for every failure.
+    const out = [...ruleBindings];
+    for (let j = 0; j < warningIndexes.length; j++) {
+        const idx = warningIndexes[j];
+        const result = batchResults[j];
+        if (!result || !result.binding) {
+            out[idx] = {
+                ...ruleBindings[idx],
+                warning: result?.error
+                    ? `${ruleBindings[idx].warning} (LLM fallback also failed: ${(0, commentSafe_1.flattenForComment)(result.error)})`
+                    : ruleBindings[idx].warning,
+            };
+            continue;
+        }
+        if (ctx.candidates) {
+            await ctx.candidates.append({
+                ts: new Date().toISOString(),
+                scaffoldId: ctx.scaffoldId,
+                stepText: steps[idx].text,
+                stepKeyword: steps[idx].keyword,
+                binding: result.binding,
+                pomSignature: {
+                    className: pom.className,
+                    fieldNames: pom.fields.map((f) => f.fieldName),
+                    methodNames: pom.methods.map((m) => m.name),
+                },
+                provider: "anthropic",
+                model: result.model ?? "(unknown)",
+                fromCache: result.fromCache,
+            });
+        }
+        out[idx] = result.binding;
+    }
+    return out;
+}
 //# sourceMappingURL=llmStepMatcher.js.map

package/dist/llm/llmStepMatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"llmStepMatcher.js","sourceRoot":"","sources":["../../src/llm/llmStepMatcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"llmStepMatcher.js","sourceRoot":"","sources":["../../src/llm/llmStepMatcher.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAuCH,4CAwGC;AAQD,8CAWC;AA6BD,oDAkGC;AA/RD,6DAAwD;AAExD,sDAAyD;AAmClD,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,GAAiB,EACjB,OAAe,EACf,GAA4B;IAE5B,kCAAkC;IAClC,MAAM,SAAS,GAAG,IAAA,uBAAS,EAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAEhD,uEAAuE;IACvE,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAEzC,kEAAkE;IAClE,IAAI,CAAC,GAAG,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE/B,mEAAmE;IACnE,+DAA+D;IAC/D,IAAI,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE;QAAE,OAAO,SAAS,CAAC;IAEhD,6DAA6D;IAC7D,kEAAkE;IAClE,oEAAoE;IACpE,gEAAgE;IAChE,mDAAmD;IACnD,kEAAkE;IAClE,2BAA2B;IAC3B,MAAM,UAAU,GAAG,GAAG,CAAC,cAAc,IAAI,KAAM,CAAC;IAChD,IAAI,SAAoD,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC;YACzC,IAAI;YACJ,GAAG;YACH,OAAO;YACP,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,OAAO,CAIzB,CAAC,OAAO,EAAE,EAAE;YACb,SAAS,GAAG,UAAU,CACpB,GAAG,EAAE,CACH,OAAO,CAAC;gBACN,KAAK,EAAE,gCAAgC,UAAU,IAAI;gBACrD,SAAS,EAAE,KAAK;aACjB,CAAC,EACJ,UAAU,CACX,CAAC;YACF,gEAAgE;YAChE,kEAAkE;YAClE,2BAA2B;YAC3B,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC1D,iEAAiE;QACjE,oDAAoD;QACpD,IAAI,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,kEAAkE;YAClE,6DAA6D;YAC7D,mEAAmE;YACnE,4DAA4D;YAC5D,kEAAkE;YAClE,uDAAuD;YACvD,OAAO;gBACL,GAAG,SAAS;gBACZ,OAAO,EAAE,MAAM,CAAC,KAAK;oBACnB,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,+BAA+B,IAAA,+BAAiB,EAAC,MAAM,CAAC,KAAK,CAAC,GAAG;oBACvF,CAAC,CAAC,SAAS,CAAC,OAAO;aACtB,CAAC;QACJ,CAAC;QACD,mEAAmE;QACnE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,MAAM,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC1B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,WAAW,EAAE,IAAI,CAAC,OAAO;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,YAAY,EAAE;oBACZ,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC9C,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAC5C;gBACD,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,WAAW;gBAClC,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,sEAAsE;QACtE,qEAAqE;QACrE,wDAAwD;QACxD,IAAI,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,IAAA,+BAAiB,EAC/B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACzC,CAAC;QACF,OAAO;YACL,GAAG,SAAS;YACZ,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,yBAAyB,OAAO,GAAG;SACjE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,iBAAiB,CACrC,KAAe,EACf,GAAiB,EACjB,OAAe,EACf,GAA4B;IAE5B,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,KAAK,UAAU,oBAAoB,CACxC,KAAe,EACf,GAAiB,EACjB,OAAe,EACf,GAA4B;IAE5B,wDAAwD;IACxD,MAAM,YAAY,GAAkB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAClD,IAAA,uBAAS,EAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAC3B,CAAC;IAEF,mEAAmE;IACnE,kEAAkE;IAClE,IAAI,CAAC,GAAG,CAAC,GAAG;QAAE,OAAO,YAAY,CAAC;IAClC,MAAM,cAAc,GAAG,YAAY;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACnC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzB,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IACrD,IAAI,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE;QAAE,OAAO,YAAY,CAAC;IAEnD,mEAAmE;IACnE,qEAAqE;IACrE,gEAAgE;IAChE,oDAAoD;IACpD,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC,qBAAqB,KAAK,UAAU,CAAC;IACzE,IAAI,CAAC,YAAY,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrE,MAAM,GAAG,GAAkB,CAAC,GAAG,YAAY,CAAC,CAAC;QAC7C,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,mEAAmE;IACnE,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;QAChB,GAAG;QACH,OAAO;QACP,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC,CAAC,CAAC;IAEJ,IAAI,YAAY,CAAC;IACjB,IAAI,CAAC;QACH,YAAY,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,qBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mEAAmE;QACnE,iEAAiE;QACjE,cAAc;QACd,MAAM,OAAO,GAAG,IAAA,+BAAiB,EAC/B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACzC,CAAC;QACF,MAAM,GAAG,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,GAAG;gBACT,GAAG,YAAY,CAAC,GAAG,CAAC;gBACpB,OAAO,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,sBAAsB,OAAO,GAAG;aACtE,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gEAAgE;IAChE,gEAAgE;IAChE,wBAAwB;IACxB,MAAM,GAAG,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,GAAG,CAAC,GAAG,CAAC,GAAG;gBACT,GAAG,YAAY,CAAC,GAAG,CAAC;gBACpB,OAAO,EAAE,MAAM,EAAE,KAAK;oBACpB,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,+BAA+B,IAAA,+BAAiB,EAAC,MAAM,CAAC,KAAK,CAAC,GAAG;oBAC/F,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO;aAC9B,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,MAAM,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC1B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI;gBACzB,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO;gBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,YAAY,EAAE;oBACZ,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC9C,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAC5C;gBACD,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,WAAW;gBAClC,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/llm/prompt.d.ts

@@ -31,6 +31,32 @@ export declare const SYSTEM_PROMPT = "You are a deterministic step-binding gener
  *   - The pageVar variable name to use in pomCall.page.
  */
 export declare function buildUserPrompt(input: GenerateBindingInput): string;
+/**
+ * v3.5.0 — batch prompt builder for `generateBatchBindings`.
+ *
+ * Why batching exists: a single scenario with N unmatched steps used to
+ * fire N separate Anthropic calls. Each call paid full round-trip
+ * latency + system-prompt tokens + POM-context tokens. Batching folds
+ * all N into one call. Cost reduction is roughly proportional to N when
+ * N > 1.
+ *
+ * The shared POM context (className, fields, methods, URL) is emitted
+ * ONCE at the top of the prompt — same as the single-step builder.
+ * Each step appears as a numbered entry:
+ *
+ *   STEP 0001:
+ *     <keyword> <text>
+ *     <doc string / data table when present>
+ *
+ *   STEP 0002:
+ *     ...
+ *
+ * The model is instructed to return a JSON ARRAY of N binding objects,
+ * one per step, in the SAME ORDER. IDs are 4-digit zero-padded so the
+ * model can echo them back for sanity (we don't require it; callers
+ * parse by position).
+ */
+export declare function buildBatchUserPrompt(inputs: GenerateBindingInput[]): string;
 /**
  * Cache key — stable across runs given identical inputs. Determinism plus
  * cost control: the same step text + POM signature returns the same binding

package/dist/llm/prompt.js

@@ -24,6 +24,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SYSTEM_PROMPT = void 0;
 exports.buildUserPrompt = buildUserPrompt;
+exports.buildBatchUserPrompt = buildBatchUserPrompt;
 exports.cacheKey = cacheKey;
 /** System prompt — shared across all generations. */
 exports.SYSTEM_PROMPT = `You are a deterministic step-binding generator for bdd2pw, a Gherkin → Playwright TypeScript scaffolder.
@@ -102,6 +103,80 @@ ${methodsBlock}
 
 Return the JSON binding now.`;
 }
+/**
+ * v3.5.0 — batch prompt builder for `generateBatchBindings`.
+ *
+ * Why batching exists: a single scenario with N unmatched steps used to
+ * fire N separate Anthropic calls. Each call paid full round-trip
+ * latency + system-prompt tokens + POM-context tokens. Batching folds
+ * all N into one call. Cost reduction is roughly proportional to N when
+ * N > 1.
+ *
+ * The shared POM context (className, fields, methods, URL) is emitted
+ * ONCE at the top of the prompt — same as the single-step builder.
+ * Each step appears as a numbered entry:
+ *
+ *   STEP 0001:
+ *     <keyword> <text>
+ *     <doc string / data table when present>
+ *
+ *   STEP 0002:
+ *     ...
+ *
+ * The model is instructed to return a JSON ARRAY of N binding objects,
+ * one per step, in the SAME ORDER. IDs are 4-digit zero-padded so the
+ * model can echo them back for sanity (we don't require it; callers
+ * parse by position).
+ */
+function buildBatchUserPrompt(inputs) {
+    if (inputs.length === 0) {
+        throw new Error("buildBatchUserPrompt: inputs must be non-empty");
+    }
+    // POM context is the same across all inputs in a batch (same scaffold,
+    // same scenario, same POM). Use the first input as the source of
+    // truth.
+    const head = inputs[0];
+    const { pom, pageVar, url } = head;
+    const fieldsBlock = pom.fields.length
+        ? pom.fields
+            .map((f) => `  - ${f.fieldName}: ${pageVar}.${f.fieldName} (page.${f.api}(${f.args}))`)
+            .join("\n")
+        : "  (no fields discovered yet)";
+    const methodsBlock = pom.methods.length
+        ? pom.methods
+            .map((m) => `  - ${m.name}(${m.params.map((p) => `${p.name}: ${p.type}`).join(", ")})`)
+            .join("\n")
+        : "  (no methods)";
+    const stepBlocks = inputs
+        .map((input, idx) => {
+        const id = String(idx + 1).padStart(4, "0");
+        const arg = input.step.argument
+            ? typeof input.step.argument === "string"
+                ? `\n  Doc string:\n  ${input.step.argument.replace(/\n/g, "\n  ")}`
+                : `\n  Data table:\n  ${JSON.stringify(input.step.argument)}`
+            : "";
+        return `STEP ${id}:\n  ${input.step.keyword} ${input.step.text}${arg}`;
+    })
+        .join("\n\n");
+    return `Multiple Gherkin steps from the same scenario didn't match any rule. Produce one StepBinding per step.
+
+POM context (shared across all steps):
+  className: ${pom.className}
+  pageVar: ${pageVar}
+  url: ${url ?? "(none)"}
+
+POM fields:
+${fieldsBlock}
+
+POM methods:
+${methodsBlock}
+
+Steps:
+
+${stepBlocks}
+
+Return a JSON ARRAY of ${inputs.length} StepBinding object(s) — one per step, IN THE SAME ORDER as the STEP ${String(1).padStart(4, "0")}..STEP ${String(inputs.length).padStart(4, "0")} list above. Same per-binding shape and rules as the single-step prompt. Do NOT wrap the array in any other object; the response must be a bare \`[...]\`.`;
+}
 /**
  * Cache key — stable across runs given identical inputs. Determinism plus
  * cost control: the same step text + POM signature returns the same binding

package/dist/llm/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/llm/prompt.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAiDH,0CA0CC;AAOD,4BAaC;AA3GD,qDAAqD;AACxC,QAAA,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iVAmCoT,CAAC;AAElV;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IAE1C,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM;QACnC,CAAC,CAAC,GAAG,CAAC,MAAM;aACP,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,SAAS,KAAK,OAAO,IAAI,CAAC,CAAC,SAAS,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,CAC7E;aACA,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,8BAA8B,CAAC;IAEnC,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM;QACrC,CAAC,CAAC,GAAG,CAAC,OAAO;aACR,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7E;aACA,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,gBAAgB,CAAC;IAErB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ;QAC3B,CAAC,CAAC,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;YACjC,CAAC,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE;YACnC,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;QACrD,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;IACL,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO;;;eAGxB,GAAG,CAAC,SAAS;aACf,OAAO;SACX,GAAG,IAAI,QAAQ;;;EAGtB,WAAW;;;EAGX,YAAY;;6BAEe,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,KAA2B,EAAE,KAAa;IACjE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1E,sEAAsE;IACtE,OAAO;QACL,IAAI;QACJ,KAAK;QACL,KAAK,CAAC,IAAI,CAAC,OAAO;QAClB,KAAK,CAAC,IAAI,CAAC,IAAI;QACf,KAAK,CAAC,GAAG,CAAC,SAAS;QACnB,UAAU;QACV,WAAW;KACZ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/llm/prompt.ts"],"names":[],"mappings":"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"}

package/dist/llm/types.d.ts

@@ -67,6 +67,14 @@ export interface LLMClientOptions {
      * Default: 15_000 (15 s).
      */
     governanceTimeoutMs?: number;
+    /**
+     * v3.5.0 — disable the batch fallback path. When true, every
+     * unmatched step fires its own provider call (the pre-v3.5 default).
+     * Use only if a customer hits a provider-side per-prompt token
+     * limit on large batches, or wants strict 1:1 call accounting for
+     * audit reasons.
+     */
+    disableBatch?: boolean;
 }
 export type LLMLogEvent = {
     kind: "cache_hit";
@@ -139,6 +147,20 @@ export interface GenerateBindingResult {
 export interface LLMClient {
     /** Generate a StepBinding for an unmatched step. */
     generateBinding(input: GenerateBindingInput): Promise<GenerateBindingResult>;
+    /**
+     * v3.5.0 — generate bindings for MULTIPLE unmatched steps in one
+     * provider call. The implementation must:
+     *   1. Honour cache per-step (skip steps already cached, return their
+     *      cached results in order, fold the rest into a batch prompt).
+     *   2. Count the batch as ONE call against `budgetExhausted`.
+     *   3. Return results in the same order as `inputs`.
+     *   4. Soft-fail per-step on parse error (one bad slot doesn't kill
+     *      the whole batch).
+     *
+     * Optional — older clients (or test stubs) that don't implement it
+     * make `matchScenarioWithLLM` fall back to per-step `generateBinding`.
+     */
+    generateBatchBindings?(inputs: GenerateBindingInput[]): Promise<GenerateBindingResult[]>;
     /** Have we hit the max-calls budget for this scaffold? */
     budgetExhausted(): boolean;
     /** Successful provider responses (parsed bindings). */

package/dist/transformers/domains/banking.d.ts

@@ -0,0 +1,37 @@
+/**
+ * v3.4.0 — Banking domain rule pack.
+ *
+ * Opt-in via `ScaffoldOptions.domains: ["banking"]`. When activated,
+ * these rules slot into the matcher registry BEFORE the URL-slug
+ * guardrails so banking-specific prose ("the account balance is
+ * $1,234.56") intercepts before drifting into the generic catch-all.
+ *
+ * Each rule emits `customBody` rather than a pomCall/assertion so the
+ * downstream emitter doesn't need to invent a POM field. The body
+ * lines reference standard test helpers (`page.evaluate`,
+ * `expect(text).toMatch`) that work against any banking app.
+ *
+ * Coverage:
+ *   - Account balance (toContainText with currency-formatted value)
+ *   - Transfers between accounts
+ *   - Transaction fees
+ *   - Statement transaction counts
+ *   - Daily withdrawal / deposit limits
+ *   - Regulation E (dispute filing windows)
+ *   - Regulation D (savings withdrawal counts)
+ *   - KYC / AML statuses
+ *   - Transaction dates
+ *   - Account opening / closing
+ *
+ * Patterns intentionally accept either `$1,234.56` or `"$1,234.56"`
+ * (LLM-emitted .feature files sometimes quote the currency). Numeric
+ * captures preserve commas — they're surfaced to the test as-is so
+ * the assertion matches what the page actually renders.
+ */
+import type { PageObjectIR, StepBinding, StepIR } from "../../types";
+interface Rule {
+    pattern: RegExp;
+    build(m: RegExpMatchArray, step: StepIR, pom: PageObjectIR, pageVar: string): StepBinding | null;
+}
+export declare const BANKING_RULES: Rule[];
+export {};