Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .ai/cli/tests/test_project_registry.py
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand All @@ -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"

Expand Down
2 changes: 1 addition & 1 deletion docs/VERSION_LINEAGE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand Down
2 changes: 1 addition & 1 deletion docs/VERSION_LINEAGE_TH.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down
2 changes: 1 addition & 1 deletion docs/contracts/browser-cli/AI_AGENT_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/migration/01_CONTEXT_AND_DECISIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ audience: "Anyone executing or auditing the trinity_v2 migration"
**Source:** Commit 0 evidence (`diff` shows IDENTICAL)

### D6 — ai-docs source = <upstream-project>/ai-docs/ (Option B) พร้อม scrub
**Why:** <upstream-project>/ai-docs/ มี structure ที่ดี (`01-CORE_PROTOCOL/`, `02-STANDARDS/`, `03-PROCESS/`, `04-MEMORY/`) — battle-tested มากกว่า generic /yai_project/ai-docs/
**Why:** <upstream-project>/ai-docs/ มี structure ที่ดี (`01-CORE_PROTOCOL/`, `02-STANDARDS/`, `03-PROCESS/`, `04-MEMORY/`) — battle-tested มากกว่า generic /<workspace-root>/ai-docs/
**How to apply:** Copy 11 ไฟล์ + scrub 3 ไฟล์ที่มี <upstream-project>-specific keywords (`SAFETY_GATES.md`, `ENV_VARS.md`, `ROLLBACK_PROCEDURES.md`)
**Risk acknowledged:** Star + Gemini + Claude เตือนว่าเสี่ยง <upstream-project> contamination — ผู้ใช้ยืนยันยังเลือก B (override)
**Mitigation:** Sanitization บังคับ — replace `<upstream-project>/smarty/deploy_dev_order/FTP_CRED` ด้วย placeholders
Expand Down
2 changes: 1 addition & 1 deletion docs/migration/03_COMMIT_PLAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 จาก `<workspace-root>/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

Expand Down
2 changes: 1 addition & 1 deletion docs/specs/10_UPSTREAM_AUDIT.md
Original file line number Diff line number Diff line change
Expand Up @@ -244,7 +244,7 @@ target: <upstream-project> (production project)

---

### 2.7 browser-cli (external `~/yai_project/browser-cli/`)
### 2.7 browser-cli (external `<workspace-root>/browser-cli/`)

#### Current State

Expand Down
2 changes: 1 addition & 1 deletion docs/specs/11_RELATED_PROJECTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
22 changes: 11 additions & 11 deletions docs/specs/INDEX.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -121,11 +121,11 @@ Going to migrate <upstream-project>? → INDEX → 10 → 09

## 3. Project Family

`/<home>/<user>/Downloads/yai_project/` มีโฟลเดอร์เกี่ยวข้องดังนี้:
`<workspace-root>/` มีโฟลเดอร์เกี่ยวข้องดังนี้:

```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.)
Expand Down Expand Up @@ -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
<upstream-project>/ ← Real production project
↓ informs
Expand Down Expand Up @@ -332,12 +332,12 @@ Bootstrap Pack ← Template for new projects
|-----------|----------|--------|
| Trinity kernel | `<upstream-project>/.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 | `<workspace-root>/browser-cli/` | ✅ Production |
| memory-cli | (future: `<workspace-root>/memory-cli/`) | 📋 Phase 2 |
| verify-cli | (future: `<workspace-root>/verify-cli/`) | 📋 Phase 4 |
| retro-cli | (future: `<workspace-root>/retro-cli/`) | 📋 Phase 7 |
| trinity-shell | (future: `<workspace-root>/trinity-shell/`) | 📋 Phase 8 |
| Bootstrap Pack | (future: `<workspace-root>/trinity-bootstrap-pack/`) | 📋 Phase 0.5 |

### 5.3 Per-project Trinity instance

Expand Down
2 changes: 1 addition & 1 deletion docs/specs/en/10_UPSTREAM_AUDIT.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<workspace-root>/browser-cli/`)

#### Current State

Expand Down
2 changes: 1 addition & 1 deletion docs/specs/en/11_RELATED_PROJECTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
2 changes: 1 addition & 1 deletion docs/specs/en/12_GLOSSARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<project>/ai-docs/` (per-project)
**Locations:** `/<workspace-root>/ai-docs/` (original) and `<project>/ai-docs/` (per-project)
**Role:** Knowledge Brain (memory substrate)

### Anthropic insight (1.6%/98.4%)
Expand Down
6 changes: 3 additions & 3 deletions docs/specs/en/INDEX.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,11 +110,11 @@ note: "Translation of ../INDEX.md — refer to Thai version for latest details"

## 3. Project Family

`/<home>/<user>/Downloads/yai_project/` contains:
`<workspace-root>/` 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
Expand Down
2 changes: 1 addition & 1 deletion docs/specs/en/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
2 changes: 1 addition & 1 deletion scripts/export_github.sh
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ while IFS= read -r file; do
s/\Q$from\E/$to/g;
}
s#/Users/[^/"'"'"'`[:space:]]+#<user-home>#g;
s#/<home>/<user>/Downloads/yai_project#<workspace-root>#g;
s#/<home>/<user>/Downloads/[^/"'"'"'`[:space:]]+#<workspace-root>#g;
s#/<home>/<user>#<user-home>#g;
s/\bvape[0-9]+/example_project/g;
s/\bVape[0-9]+/Example Project/g;
Expand Down
Loading