Classic RAG scores chunks by cosine similarity—close vectors ≠ correct logic.
Result: “looks relevant” chunks that derail answers. WFGY replaces surface matching with semantic residue checks.
| Weakness | Practical Failure |
|---|
| Embedding ≠ Understanding | Cosine overlap captures phrasing, not intent |
| Keywords ≠ Intent | Ambiguous terms bring unrelated chunks |
| No Semantic Guard | System never validates logical fit |
User: “How do I cancel my subscription after the free trial?”
Retrieved chunk: “Subscriptions renew monthly or yearly, depending on plan.”
→ High cosine, zero help → hallucinated answer.
B = I - G + m·c² # minimize ‖B‖
| Symbol | Meaning |
|---|
| I | Input semantic vector |
| G | Ground‑truth anchor (intent) |
| B | Semantic residue (error) |
- Large ‖B‖ → chunk is semantically off → WFGY rejects or asks for context.
| Layer | Action |
|---|
| BBMC | Computes residue; filters divergent chunks |
| ΔS Threshold | Rejects high semantic tension (ΔS > 0.6) |
| BBAM | Down‑weights misleading high‑attention tokens |
| Tree Anchor | Confirms chunk aligns with prior logic path |
1️⃣ Start
> Start
2️⃣ Paste misleading chunk
> "Plans include yearly renewal."
3️⃣ Ask
> "How do I cancel a free trial?"
WFGY:
• ΔS high → chunk rejected
• Prompts for trial‑specific info instead of hallucinating
Surface overlap detected, but content lacks trial‑cancellation detail.
Add a policy chunk on trial termination or rephrase the query.
| Module | Role |
|---|
| BBMC | Residue minimization |
| ΔS Metric | Measures semantic tension |
| BBAM | Suppresses noisy tokens |
| Semantic Tree | Validates anchor alignment |
| Feature | State |
|---|
| BBMC residue calc | ✅ Stable |
| ΔS filter | ✅ Stable |
| Token attention modulation | ⚠️ Basic |
| Misleading chunk rejection | ✅ Active |
| Tool | Link | 3-Step Setup |
|---|
| WFGY 1.0 PDF | Engine Paper | 1️⃣ Download · 2️⃣ Upload to your LLM · 3️⃣ Ask “Answer using WFGY + <your question>” |
| TXT OS (plain-text OS) | TXTOS.txt | 1️⃣ Download · 2️⃣ Paste into any LLM chat · 3️⃣ Type “hello world” — OS boots instantly |
| Layer | Page | What it’s for |
|---|
| ⭐ Proof | WFGY Recognition Map | External citations, integrations, and ecosystem proof |
| ⚙️ Engine | WFGY 1.0 | Original PDF tension engine and early logic sketch (legacy reference) |
| ⚙️ Engine | WFGY 2.0 | Production tension kernel for RAG and agent systems |
| ⚙️ Engine | WFGY 3.0 | TXT based Singularity tension engine (131 S class set) |
| 🗺️ Map | Problem Map 1.0 | Flagship 16 problem RAG failure taxonomy and fix map |
| 🗺️ Map | Problem Map 2.0 | Global Debug Card for RAG and agent pipeline diagnosis |
| 🗺️ Map | Problem Map 3.0 | Global AI troubleshooting atlas and failure pattern map |
| 🧰 App | TXT OS | .txt semantic OS with fast bootstrap |
| 🧰 App | Blah Blah Blah | Abstract and paradox Q&A built on TXT OS |
| 🧰 App | Blur Blur Blur | Text to image generation with semantic control |
| 🏡 Onboarding | Starter Village | Guided entry point for new users |
If this repository helped, starring it improves discovery so more builders can find the docs and tools.
