docs: add TruthLens Vision; link from docs README

Author: Michael

tools/gh-pr-open-and-merge.cjs

@@ -13,7 +13,7 @@ const {
   repo, base, head, title,
   body = '',
   labels = '',
-  merge: mergeMethod = 'squash',
+  merge: mergeMethod = 'squash', // squash|merge|rebase|none
   interval = '15',
   timeout = '1800',
   dry = false,
@@ -73,7 +73,10 @@ async function mergePR(prNumber, method) {
   if (!repo || !base || !head || !title) { console.error('Usage: --repo --base --head --title [--body] [--labels] [--merge] [--interval] [--timeout] [--dry]'); process.exit(2); }
   console.log(`repo=${repo} base=${base} head=${head}`);
   const pr = await getOrCreatePR(); const prNum = pr.number; console.log(`PR #${prNum} ready (head sha=${pr.head.sha})`);
-  await addLabels(prNum, labels); await waitGreen(pr.head.sha, Number(interval), Number(timeout)); await mergePR(prNum, mergeMethod);
+  await addLabels(prNum, labels);
+  if (mergeMethod !== 'none') {
+    await waitGreen(pr.head.sha, Number(interval), Number(timeout));
+    await mergePR(prNum, mergeMethod);
+  }
   console.log('Done.');
 })().catch(e=>{ console.error('[gh-pr-open-and-merge]', e.message||e); process.exit(1); });
-

workspace/docs/README.md

@@ -26,3 +26,10 @@ bash tools/merge-three-prs.sh
 See also:
 - `.agent-os/instructions/core/pr-merge-runbook.md` (canonical, step-by-step)
 - `.agent-os/instructions/core/github-token-setup.md` (how to create/export token safely)
+
+---
+
+## Vision Reference
+
+For strategic context on **why TruthLens matters** and **where Soulfield OS is going**,  
+see: `workspace/knowledge/TruthLens-Vision.md`

workspace/knowledge/TruthLens-Vision.md

@@ -0,0 +1,73 @@
+# TruthLens Vision — Soulfield OS
+
+This document captures the strategic importance of **TruthLens** and its role in the future of **Soulfield OS**.  
+It is derived from early research discussions (see `Without truth lens this.txt`) and is meant to be a **north star context doc**.
+
+---
+
+## 🌐 Why TruthLens Matters
+- LLMs hallucinate by design — they generate plausible continuations, not truth.
+- In business modeling and research, hallucinations = wasted money and time.
+- TruthLens enforces **structure + no-simulation mode**, so outputs are:
+  - Fact-based
+  - Explicit about unknowns
+  - Structured and auditable
+
+---
+
+## 🚫 Without TruthLens
+- Other teams using raw GPT/Claude/LLMs:
+  - Get confident nonsense mixed with valid insights.
+  - Miss real market gaps (AI fills them with fictions).
+  - Struggle to scale workflows (garbage data compounds).
+- Their “AI researcher” is a dreamer.  
+- Soulfield OS (with TruthLens) is a **fact-checker**.
+
+---
+
+## ✅ Competitive Advantage
+- **Reliability moat** — Soulfield outputs *trusted business blueprints*, not hallucinations.
+- **Enterprise-ready** — structured, auditable outputs.
+- **Composable trust** — every agent and workflow passes through TruthLens.
+- **Differentiator** — “Other AI tools hallucinate. Soulfield OS doesn’t.”
+
+---
+
+## 🧩 Where TruthLens Fits
+TruthLens checkpoints sit between every stage of a **business orchestration pipeline**:
+- **Research Agent** → validates collected data.  
+- **Strategy Agent** → separates facts vs. assumptions.  
+- **Execution Agent** → blocks wasted spend on false inputs.  
+- **Analytics Agent** → ensures metrics are valid.
+
+This prevents cascading errors across multi-agent workflows.
+
+---
+
+## 🚀 Long-Term Soulfield OS Positioning
+- **Short term** — SaaS model: hosted Claude Opus + TruthLens orchestration.  
+- **Long term** — Enterprise license: Soulfield OS + TruthLens + pluggable private LLMs.  
+- **Hybrid** — Companies route sensitive data to private LLMs, reasoning to hosted models.  
+- **Moat** = TruthLens + Orchestration, not model weights.
+
+---
+
+## 💡 Example Pipeline Templates
+- Marketing funnel orchestration  
+- SEO agency pipeline  
+- Startup due diligence pipeline  
+- Product launch pipeline  
+- Lead generation & outreach  
+- Market research  
+- Compliance & policy checks  
+- Financial analysis  
+
+Each template = **research → strategy → execution → analytics**, gated by TruthLens.
+
+---
+
+## 📌 One-Liner Positioning
+**Soulfield OS** is the orchestration hub.  
+**TruthLens** is the trust filter.  
+Together → “The AI Business OS That Doesn’t Hallucinate.”
+