feat(demo): Rewrite Theater — query normalization, step by step

[konjoinfinity]

A seventh flagship demo surface (/rewrite) showing kyro's real query-rewrite pipeline — the deterministic, LLM-free normalizer that runs before every semantic-cache lookup so differently-phrased questions share one canonical key (would-be misses → hits).

What's new

• demo/rewriting.py — RewriteEngine wraps konjoai.cache.rewriter.QueryRewriter unmodified. trace() exposes the real explain() per-step before/after trace; scenario() runs curated paraphrase clusters through the real rewrite() to measure the cache-key collapse (keys saved → cache hits gained). No stubs — this is the exact transform on the live lookup path.
• demo/rewrite.html — cinematic step pipeline: each of the 6 real steps (lowercase → expand contractions → strip fillers → strip punctuation → normalize whitespace → strip trailing ?) shows changed-vs-no-op with a before→after diff and the final canonical key, plus a paraphrase-collapse panel (phrasings → unique keys → hits gained). Ships reduced-motion, focus-visible, View Transitions, and responsive layout.
• demo/server.py — GET /rewrite + GET /api/rewrite/{trace,scenario}.
• Rewrite linked in the nav across all surfaces — now Playground · Observatory · Pipeline · Agent · Security · HyDE · Rewrite.
• tests/unit/test_demo_rewrite.py — 8 contract tests (per-step trace equals the real rewrite(), the real 6-step pipeline, paraphrase-collapse arithmetic).

The payoff (real numbers)

The curated clusters: 10 phrasings → 3 unique cache keys → 7 keys saved / +7 cache hits gained — each case/whitespace/punctuation/contraction variant canonicalizes to one key.

Honesty notes

• 100% real, offline, deterministic — the trace is QueryRewriter.explain and the canonical key is QueryRewriter.rewrite, the same code kyro runs before a cache lookup. The UI shows partial collapse faithfully (no-op steps are labelled).

Verification

• 51 demo tests pass, stable across multiple PYTHONHASHSEED values; ruff check . clean repo-wide.
• All seven surfaces serve 200; the scenario endpoint returns the measured collapse.
• Rendered & screenshotted headless against the live server.
• Only demo/* + a new test changed — no production konjoai/ code touched.

Run it:

python3 demo/server.py        # http://localhost:8766/rewrite

https://claude.ai/code/session_01WWWgV1NwxaaNdPfy4PHN1K

---

Generated by Claude Code