From 327df55eca691abb0703b7bcd4656a6c7558e474 Mon Sep 17 00:00:00 2001 From: yai_mac_big Date: Mon, 18 May 2026 22:50:12 +0700 Subject: [PATCH] docs: scrub public workspace references --- .ai/cli/tests/test_project_registry.py | 4 ++-- docs/VERSION_LINEAGE.md | 2 +- docs/VERSION_LINEAGE_TH.md | 2 +- docs/contracts/browser-cli/AI_AGENT_GUIDE.md | 2 +- docs/migration/01_CONTEXT_AND_DECISIONS.md | 2 +- docs/migration/03_COMMIT_PLAN.md | 2 +- docs/specs/10_UPSTREAM_AUDIT.md | 2 +- docs/specs/11_RELATED_PROJECTS.md | 2 +- docs/specs/INDEX.md | 22 ++++++++++---------- docs/specs/en/10_UPSTREAM_AUDIT.md | 2 +- docs/specs/en/11_RELATED_PROJECTS.md | 2 +- docs/specs/en/12_GLOSSARY.md | 2 +- docs/specs/en/INDEX.md | 6 +++--- docs/specs/en/README.md | 2 +- scripts/export_github.sh | 2 +- 15 files changed, 28 insertions(+), 28 deletions(-) diff --git a/.ai/cli/tests/test_project_registry.py b/.ai/cli/tests/test_project_registry.py index f19fab1..78a52d9 100644 --- a/.ai/cli/tests/test_project_registry.py +++ b/.ai/cli/tests/test_project_registry.py @@ -58,7 +58,7 @@ def test_touch_memory_db_creates_sqlite_file(tmp_path: Path) -> None: def test_default_homes_live_inside_trinity_checkout(tmp_path: Path, monkeypatch) -> None: fake_file = ( tmp_path - / "yai_project" + / "workspace-root" / "trinity_v2" / ".ai" / "cli" @@ -67,7 +67,7 @@ def test_default_homes_live_inside_trinity_checkout(tmp_path: Path, monkeypatch) ) monkeypatch.setattr(registry_mod, "__file__", str(fake_file)) - trinity_root = tmp_path / "yai_project" / "trinity_v2" + trinity_root = tmp_path / "workspace-root" / "trinity_v2" assert default_trinity_home(env={}) == trinity_root / ".trinity" assert default_memory_home(env={}) == trinity_root / ".memory" diff --git a/docs/VERSION_LINEAGE.md b/docs/VERSION_LINEAGE.md index 1cd607b..9682b1d 100644 --- a/docs/VERSION_LINEAGE.md +++ b/docs/VERSION_LINEAGE.md @@ -40,7 +40,7 @@ Clean export without optional sibling tools: 1860 passed, 8 skipped ## Lineage -- Source family: `TRINITY_ULTIMAT` kernel lessons and migration evidence. +- Source family: `TRINITY_LEGACY` kernel lessons and migration evidence. - Current repo: `trinity_v2`, clean public bootstrap/runtime target. - Public export: generated with `scripts/export_github.sh` and `scripts/package_github_zip.sh`. diff --git a/docs/VERSION_LINEAGE_TH.md b/docs/VERSION_LINEAGE_TH.md index ee838ae..7522e54 100644 --- a/docs/VERSION_LINEAGE_TH.md +++ b/docs/VERSION_LINEAGE_TH.md @@ -40,7 +40,7 @@ Clean export without optional sibling tools: 1860 passed, 8 skipped ## Lineage -- Source family: บทเรียนจาก `TRINITY_ULTIMAT` kernel และ migration evidence +- Source family: บทเรียนจาก `TRINITY_LEGACY` kernel และ migration evidence - Current repo: `trinity_v2`, clean public bootstrap/runtime target - Public export: สร้างด้วย `scripts/export_github.sh` และ `scripts/package_github_zip.sh` diff --git a/docs/contracts/browser-cli/AI_AGENT_GUIDE.md b/docs/contracts/browser-cli/AI_AGENT_GUIDE.md index f379651..af9768b 100644 --- a/docs/contracts/browser-cli/AI_AGENT_GUIDE.md +++ b/docs/contracts/browser-cli/AI_AGENT_GUIDE.md @@ -254,7 +254,7 @@ AI actions are logged — be aware: ### Don't log sensitive commands explicitly ```bash # ❌ Don't print credentials to logs -bcmd "fill #password 'actual-password'" # logged to actions.ndjson +bcmd "fill #password 'replace-me'" # logged to actions.ndjson # ✅ Use config-based auth # Config file has creds → AI uses --login backend diff --git a/docs/migration/01_CONTEXT_AND_DECISIONS.md b/docs/migration/01_CONTEXT_AND_DECISIONS.md index dc2a1ec..d9c0582 100644 --- a/docs/migration/01_CONTEXT_AND_DECISIONS.md +++ b/docs/migration/01_CONTEXT_AND_DECISIONS.md @@ -58,7 +58,7 @@ audience: "Anyone executing or auditing the trinity_v2 migration" **Source:** Commit 0 evidence (`diff` shows IDENTICAL) ### D6 — ai-docs source = /ai-docs/ (Option B) พร้อม scrub -**Why:** /ai-docs/ มี structure ที่ดี (`01-CORE_PROTOCOL/`, `02-STANDARDS/`, `03-PROCESS/`, `04-MEMORY/`) — battle-tested มากกว่า generic /yai_project/ai-docs/ +**Why:** /ai-docs/ มี structure ที่ดี (`01-CORE_PROTOCOL/`, `02-STANDARDS/`, `03-PROCESS/`, `04-MEMORY/`) — battle-tested มากกว่า generic //ai-docs/ **How to apply:** Copy 11 ไฟล์ + scrub 3 ไฟล์ที่มี -specific keywords (`SAFETY_GATES.md`, `ENV_VARS.md`, `ROLLBACK_PROCEDURES.md`) **Risk acknowledged:** Star + Gemini + Claude เตือนว่าเสี่ยง contamination — ผู้ใช้ยืนยันยังเลือก B (override) **Mitigation:** Sanitization บังคับ — replace `/smarty/deploy_dev_order/FTP_CRED` ด้วย placeholders diff --git a/docs/migration/03_COMMIT_PLAN.md b/docs/migration/03_COMMIT_PLAN.md index 617ca23..247999d 100644 --- a/docs/migration/03_COMMIT_PLAN.md +++ b/docs/migration/03_COMMIT_PLAN.md @@ -261,7 +261,7 @@ trinity_v2/docs/schemas/browser-cli/ ### Sub-tasks 18. Create `docs/contracts/browser-cli/README.md` with notice: - > ⚠️ **REFERENCE ONLY** — เอกสารในโฟลเดอร์นี้คือ DNA reference จาก `~/yai_project/browser-cli/` ไม่ใช่ active code ของ trinity_v2. ใช้เป็นต้นแบบสำหรับ tool ใหม่ (memory-cli, verify-cli) ตาม `01_TOOL_CONTRACT.md` + > ⚠️ **REFERENCE ONLY** — เอกสารในโฟลเดอร์นี้คือ DNA reference จาก `/browser-cli/` ไม่ใช่ active code ของ trinity_v2. ใช้เป็นต้นแบบสำหรับ tool ใหม่ (memory-cli, verify-cli) ตาม `01_TOOL_CONTRACT.md` 19. Copy 5 markdown docs 20. Copy 2 JSON schemas diff --git a/docs/specs/10_UPSTREAM_AUDIT.md b/docs/specs/10_UPSTREAM_AUDIT.md index b617702..9ca9444 100644 --- a/docs/specs/10_UPSTREAM_AUDIT.md +++ b/docs/specs/10_UPSTREAM_AUDIT.md @@ -244,7 +244,7 @@ target: (production project) --- -### 2.7 browser-cli (external `~/yai_project/browser-cli/`) +### 2.7 browser-cli (external `/browser-cli/`) #### Current State diff --git a/docs/specs/11_RELATED_PROJECTS.md b/docs/specs/11_RELATED_PROJECTS.md index f092c7b..8f94105 100644 --- a/docs/specs/11_RELATED_PROJECTS.md +++ b/docs/specs/11_RELATED_PROJECTS.md @@ -22,7 +22,7 @@ last-updated: 2026-04-28 --- -## 1. Project Family (Internal — yai_project/) +## 1. Project Family (Internal — workspace-root/) ### 1.1 TRINITY_LEGACY (this project) diff --git a/docs/specs/INDEX.md b/docs/specs/INDEX.md index 3f5622a..3d17505 100644 --- a/docs/specs/INDEX.md +++ b/docs/specs/INDEX.md @@ -18,7 +18,7 @@ read-time: 15 minutes 1. [Welcome](#1-welcome) — What this is, For whom 2. [The Big Picture](#2-the-big-picture) — One diagram, two paragraphs -3. [Project Family](#3-project-family) — All `yai_project/` folders +3. [Project Family](#3-project-family) — All `workspace-root/` folders 4. [Vocabulary (Glossary)](#4-vocabulary-glossary) — ทุกคำมีความหมาย 5. [Component Index](#5-component-index) — Where to find what 6. [Roles & Responsibilities](#6-roles--responsibilities) — Who does what @@ -121,11 +121,11 @@ Going to migrate ? → INDEX → 10 → 09 ## 3. Project Family -`///Downloads/yai_project/` มีโฟลเดอร์เกี่ยวข้องดังนี้: +`/` มีโฟลเดอร์เกี่ยวข้องดังนี้: ```text -yai_project/ -├── TRINITY_ULTIMAT/ ← Trinity kernel (development) +workspace-root/ +├── TRINITY_LEGACY/ ← Trinity kernel (development) │ ├── .ai/ ← Trinity runtime: cli, sessions, audit, policies, schemas │ ├── archive/ ← Legacy AI docs, old sessions │ ├── references/ ← External AI harness references (claw-code, openclaude, etc.) @@ -171,7 +171,7 @@ yai_project/ ### Cross-relationships ```text -TRINITY_ULTIMAT/ ← Source of truth for kernel + specs +TRINITY_LEGACY/ ← Source of truth for kernel + specs ↓ used by / ← Real production project ↓ informs @@ -332,12 +332,12 @@ Bootstrap Pack ← Template for new projects |-----------|----------|--------| | Trinity kernel | `/.ai/cli/` (existing) | ✅ Production | | Trinity kernel (canonical) | (future: `~/code/trinity-kernel/`) | 📋 | -| browser-cli | `~/yai_project/browser-cli/` | ✅ Production | -| memory-cli | (future: `~/yai_project/memory-cli/`) | 📋 Phase 2 | -| verify-cli | (future: `~/yai_project/verify-cli/`) | 📋 Phase 4 | -| retro-cli | (future: `~/yai_project/retro-cli/`) | 📋 Phase 7 | -| trinity-shell | (future: `~/yai_project/trinity-shell/`) | 📋 Phase 8 | -| Bootstrap Pack | (future: `~/yai_project/trinity-bootstrap-pack/`) | 📋 Phase 0.5 | +| browser-cli | `/browser-cli/` | ✅ Production | +| memory-cli | (future: `/memory-cli/`) | 📋 Phase 2 | +| verify-cli | (future: `/verify-cli/`) | 📋 Phase 4 | +| retro-cli | (future: `/retro-cli/`) | 📋 Phase 7 | +| trinity-shell | (future: `/trinity-shell/`) | 📋 Phase 8 | +| Bootstrap Pack | (future: `/trinity-bootstrap-pack/`) | 📋 Phase 0.5 | ### 5.3 Per-project Trinity instance diff --git a/docs/specs/en/10_UPSTREAM_AUDIT.md b/docs/specs/en/10_UPSTREAM_AUDIT.md index 1c91993..06614c0 100644 --- a/docs/specs/en/10_UPSTREAM_AUDIT.md +++ b/docs/specs/en/10_UPSTREAM_AUDIT.md @@ -246,7 +246,7 @@ note: "Translation of ../10_UPSTREAM_AUDIT.md" --- -### 2.7 browser-cli (external `~/yai_project/browser-cli/`) +### 2.7 browser-cli (external `/browser-cli/`) #### Current State diff --git a/docs/specs/en/11_RELATED_PROJECTS.md b/docs/specs/en/11_RELATED_PROJECTS.md index 469919c..3765e94 100644 --- a/docs/specs/en/11_RELATED_PROJECTS.md +++ b/docs/specs/en/11_RELATED_PROJECTS.md @@ -24,7 +24,7 @@ note: "Translation of ../11_RELATED_PROJECTS.md" --- -## 1. Project Family (Internal — yai_project/) +## 1. Project Family (Internal — workspace-root/) ### 1.1 TRINITY_LEGACY (this project) diff --git a/docs/specs/en/12_GLOSSARY.md b/docs/specs/en/12_GLOSSARY.md index 33aa106..fd0f60b 100644 --- a/docs/specs/en/12_GLOSSARY.md +++ b/docs/specs/en/12_GLOSSARY.md @@ -36,7 +36,7 @@ note: "Translation of ../12_GLOSSARY.md — English-only entries" ### ai-docs 🏷 *Project Family* **Definition:** Methodology framework — markdown documentation for AI workflow rituals -**Locations:** `/yai_project/ai-docs/` (original) and `/ai-docs/` (per-project) +**Locations:** `//ai-docs/` (original) and `/ai-docs/` (per-project) **Role:** Knowledge Brain (memory substrate) ### Anthropic insight (1.6%/98.4%) diff --git a/docs/specs/en/INDEX.md b/docs/specs/en/INDEX.md index ace3e3c..eeaeb93 100644 --- a/docs/specs/en/INDEX.md +++ b/docs/specs/en/INDEX.md @@ -110,11 +110,11 @@ note: "Translation of ../INDEX.md — refer to Thai version for latest details" ## 3. Project Family -`///Downloads/yai_project/` contains: +`/` contains: ``` -yai_project/ -├── TRINITY_ULTIMAT/ ← Trinity kernel (development) +workspace-root/ +├── TRINITY_LEGACY/ ← Trinity kernel (development) │ ├── .ai/ ← Trinity runtime: cli, sessions, audit, policies │ ├── archive/ ← Legacy AI docs │ ├── references/ ← External AI harness study diff --git a/docs/specs/en/README.md b/docs/specs/en/README.md index d41021f..1d63f45 100644 --- a/docs/specs/en/README.md +++ b/docs/specs/en/README.md @@ -238,7 +238,7 @@ All tools follow the same Tool Contract: stdin/stdout JSON, schema-locked, NDJSO ## Project Structure ``` -yai_project/ +workspace-root/ ├── TRINITY_LEGACY/ ← Trinity kernel + specs │ ├── .ai/ ← Production runtime │ └── TRINITY_EVOLUTION/ ← v2 specs (16 docs, 13K lines) diff --git a/scripts/export_github.sh b/scripts/export_github.sh index 324ad4d..9869222 100755 --- a/scripts/export_github.sh +++ b/scripts/export_github.sh @@ -66,7 +66,7 @@ while IFS= read -r file; do s/\Q$from\E/$to/g; } s#/Users/[^/"'"'"'`[:space:]]+##g; - s#///Downloads/yai_project##g; + s#///Downloads/[^/"'"'"'`[:space:]]+##g; s#//##g; s/\bvape[0-9]+/example_project/g; s/\bVape[0-9]+/Example Project/g;