golangLAKEHOUSE/reports/reality-tests/playbook_lift_real_003b.md
root 3263254f1c reality_test real_003: 40-query paraphrase stress + extractor extension
Stress-tests the role gate with 40 queries (10 fill_events rows × 4
styles): need, client_first, looking, shorthand. Each row's role +
client + city stays the same; only the surface phrasing changes.

real_003 (original extractor) confirmed the shorthand-vs-shorthand
failure mode: CNC Operator shorthand recording leaked w-2404 onto
Forklift Operator shorthand query within the same Beacon Freight
Detroit cluster. Both record + query had empty role (extractor
returns "" for shorthand because there's no separator between role
and city), gate disabled, distance check passed, bleed fired.

Fix: extended extractRoleFromNeed to handle client_first
("{client} needs N {role} in...") and looking ("Looking for N
{role} at...") patterns. Shorthand left intentionally unmatched —
"Forklift Operator Detroit" is shape-indistinguishable from
"Forklift" + "Operator Detroit" without an LLM extractor or known-
cities lookup.

real_003b (extended extractor) verifies bleed closed across all 4
styles for this dataset. Forklift Operator queries keep w-2136 (the
cold-pass-correct match) regardless of which style the query came
in. Same-role boosts now fire correctly across styles — a CNC
Operator recording made in `looking` style boosts the CNC need-form
query.

scripts/cutover/gen_real_queries.go: added -styles flag with values
need|client_first|looking|shorthand|all (default need preserves
real_001/002 behavior). Tests/reality/real_coord_queries_v2.txt is
the 40-query stress file.

scripts/playbook_lift/main_test.go: 10 sub-tests lock the four
documented patterns + shorthand limitation + lift-suite-style
queries (no clean role, returns empty as expected).

Aggregate metrics:
- real_003  (original): disc=7,  lift=7,  boost=14, meanΔ=-0.108
- real_003b (extended): disc=11, lift=10, boost=31, meanΔ=-0.202
The growth reflects more LEGITIMATE same-role same-cluster transfer
firing across styles, not bleed (verified by per-cluster bleed
table — Forklift Operator queries unchanged across all 4 styles).

Known limitation documented in real_003_findings.md: same-cluster,
same-role queries in shorthand still embed close enough that a
shorthand recording could bleed onto a different-role shorthand
query if both record + query strip role. Closing this requires
LLM extraction or known-cities lookup at record + query time.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 21:42:02 -05:00

7.5 KiB
Raw Blame History

Playbook-Lift Reality Test — Run real_003b

Generated: 2026-05-01T02:38:56.283100116Z Judge: qwen2.5:latest (Ollama, resolved from config [models].local_judge) Corpora: workers,ethereal_workers Workers limit: 5000 Queries: tests/reality/real_coord_queries_v2.txt (40 executed) K per pass: 10 Paraphrase pass: disabled Re-judge pass: disabled Evidence: reports/reality-tests/playbook_lift_real_003b.json


Headline

Metric Value
Total queries run 40
Cold-pass discoveries (judge-best ≠ top-1) 11
Warm-pass lifts (recorded playbook → top-1) 10
No change (judge-best already top-1, no playbook needed) 30
Playbook boosts triggered (warm pass) 31
Mean Δ top-1 distance (warm cold) -0.20235376

Verbatim lift rate: 10 of 11 discoveries became top-1 after warm pass.


Per-query results

# Query Cold top-1 Cold judge-best (rank/rating) Recorded? Warm top-1 Judge-best warm rank Lift
1 Need 5 Warehouse Associates in Kansas City MO starting at 09 e-7863 0/4 e-7863 0 no
2 Parallel Machining needs 5 Warehouse Associates in Kansas Ci e-8089 1/4 ✓ e-7863 e-7863 0 YES
3 Looking for 5 Warehouse Associates at Parallel Machining in e-7538 0/4 e-7863 1 no
4 5 Warehouse Associates Kansas City MO 09:00 Parallel Machini e-7538 0/4 e-7863 1 no
5 Need 1 Forklift Operator in Detroit MI starting at 15:00 for w-2136 0/5 w-2136 0 no
6 Beacon Freight needs 1 Forklift Operator in Detroit MI at 15 w-2136 0/5 w-2136 0 no
7 Looking for 1 Forklift Operator at Beacon Freight in Detroit w-2136 0/5 w-2136 0 no
8 1 Forklift Operator Detroit MI 15:00 Beacon Freight w-2136 0/5 w-2136 0 no
9 Need 4 Loaders in Indianapolis IN starting at 12:00 for Midw w-2742 1/4 ✓ w-4397 w-4397 0 YES
10 Midway Distribution needs 4 Loaders in Indianapolis IN at 12 w-2742 2/5 ✓ w-4397 w-4397 0 YES
11 Looking for 4 Loaders at Midway Distribution in Indianapolis w-2742 2/4 ✓ w-4397 w-4397 0 YES
12 4 Loaders Indianapolis IN 12:00 Midway Distribution w-2742 1/5 ✓ w-4397 w-4397 0 YES
13 Need 3 Warehouse Associates in Fort Wayne IN starting at 17: w-3370 0/4 w-1398 1 no
14 Cornerstone Fabrication needs 3 Warehouse Associates in Fort w-3370 0/4 w-1398 1 no
15 Looking for 3 Warehouse Associates at Cornerstone Fabricatio w-1784 1/4 ✓ w-1398 w-1398 0 YES
16 3 Warehouse Associates Fort Wayne IN 17:30 Cornerstone Fabri e-8661 0/4 w-1398 1 no
17 Need 4 Pickers in Detroit MI starting at 13:30 for Beacon Fr e-7644 0/2 w-1367 1 no
18 Beacon Freight needs 4 Pickers in Detroit MI at 13:30 e-7644 0/2 w-1367 1 no
19 Looking for 4 Pickers at Beacon Freight in Detroit MI for 13 e-438 2/3 w-1367 3 no
20 4 Pickers Detroit MI 13:30 Beacon Freight e-7644 8/4 ✓ w-1367 w-1367 0 YES
21 Need 2 Packers in Joliet IL starting at 09:30 for Parallel M e-846 8/3 e-2120 0 no
22 Parallel Machining needs 2 Packers in Joliet IL at 09:30 e-846 9/4 ✓ e-2120 e-2120 0 YES
23 Looking for 2 Packers at Parallel Machining in Joliet IL for e-846 1/2 e-2120 2 no
24 2 Packers Joliet IL 09:30 Parallel Machining e-7105 4/3 e-2120 0 no
25 Need 3 Assemblers in Flint MI starting at 08:30 for Heritage w-2582 0/2 w-2582 0 no
26 Heritage Foods needs 3 Assemblers in Flint MI at 08:30 w-2582 0/2 w-2582 0 no
27 Looking for 3 Assemblers at Heritage Foods in Flint MI for 0 w-4817 0/2 w-4817 0 no
28 3 Assemblers Flint MI 08:30 Heritage Foods w-4124 1/2 w-4124 1 no
29 Need 3 Packers in Flint MI starting at 12:30 for Parallel Ma e-6019 0/1 e-2120 1 no
30 Parallel Machining needs 3 Packers in Flint MI at 12:30 e-6019 0/1 e-2120 1 no
31 Looking for 3 Packers at Parallel Machining in Flint MI for e-6019 0/1 e-2120 1 no
32 3 Packers Flint MI 12:30 Parallel Machining e-6019 0/2 e-2120 1 no
33 Need 1 Shipping Clerk in Flint MI starting at 17:00 for Pion w-3988 3/4 ✓ w-1367 w-122 1 no
34 Pioneer Assembly needs 1 Shipping Clerk in Flint MI at 17:00 w-3988 1/3 w-122 3 no
35 Looking for 1 Shipping Clerk at Pioneer Assembly in Flint MI w-3988 2/3 w-122 0 no
36 1 Shipping Clerk Flint MI 17:00 Pioneer Assembly w-2564 2/4 ✓ w-122 w-122 0 YES
37 Need 1 CNC Operator in Detroit MI starting at 17:30 for Beac w-2404 0/5 e-637 1 no
38 Beacon Freight needs 1 CNC Operator in Detroit MI at 17:30 w-2404 0/5 e-637 1 no
39 Looking for 1 CNC Operator at Beacon Freight in Detroit MI f e-8106 1/4 ✓ e-637 e-637 0 YES
40 1 CNC Operator Detroit MI 17:30 Beacon Freight w-2404 0/5 e-637 1 no

Honesty caveats

  1. Judge IS the ground truth proxy. Without human-labeled relevance, the LLM judge's verdict is what defines "best." If `` rates badly, the lift number is meaningless. To validate the judge itself, sample 510 verdicts manually and check agreement.
  2. Score-1.0 boost = distance halved. Playbook math is distance' = distance × (1 - 0.5 × score). Lift requires the judge-best result's pre-boost distance to be ≤ 2× the cold top-1's distance, otherwise even halving doesn't promote it. Tight clusters → little visible lift.
  3. Verbatim vs paraphrase. The verbatim lift rate (above) is the cheap case — same query, recorded playbook, expected boost. The paraphrase pass (when enabled) is the actual learning property: similar-but-different queries hitting a recorded playbook. Compare verbatim and paraphrase lift rates — paraphrase should be lower (semantic-distance gates some playbook hits) but non-zero is the meaningful signal.
  4. Multi-corpus skew. Default corpora=workers,ethereal_workers — if all judge-best results land in one corpus, the matrix layer's purpose isn't being tested. Check per-corpus distribution in the JSON.
  5. Judge resolution. This run used qwen2.5:latest from config [models].local_judge. Bumping the judge for run #N+1 means editing one line in lakehouse.toml.
  6. Paraphrase generation also uses the judge. The same model that rates relevance also rephrases queries. A judge that's bad at rating staffing queries is probably also bad at rephrasing them. Worth sanity-checking a sample of paraphrase_query values in the JSON before trusting the paraphrase lift number.

Next moves

  • If lift rate ≥ 50% of discoveries: matrix layer + playbook is doing real work. Move to paraphrase queries + tag-based boost (currently ignored).
  • If lift rate < 20%: investigate why — judge variance, distance gap too wide, or playbook math too gentle. The score=1.0 / 0.5× formula may need retuning.
  • If discovery rate (cold judge-best ≠ top-1) is itself low: cosine is already close to optimal on this query distribution. Either the corpus is too narrow or the queries are too easy.