2026-04-28: vault catchup — purpose, self-modification, CI pipeline, agent rules

- Add personal-os-purpose.md: ADHD context, design principles, quadrant model
- Add personal-os-self-modification.md: Eagle's guide for evolving the system
- Update personal-os-agent-rules.md: fix status.md path, corrections_log → SQL, add #retrospector cron, personal project activity notes
- Update personal-os-architecture.md: correct paths, add executor/tables/data flow
- Add work/wiki/apple-browsers/ci-pipeline.md: full CI schema, xcodebuild commands, local equivalents, VM/executor build commands
- Add raw/ symlinks to planning docs (state-2026-04-27-final, catchup-plan-2026-04-27)

wiki/personal-os-architecture.md

@@ -1,44 +1,135 @@
 ---
 namespace: work
 tags: [system, architecture]
-last_synced: 2026-04-27
+last_updated: 2026-04-28
 confidence: 1.0
 ---
 
-# Personal OS Architecture
+# Personal OS — Architecture
 
-## Стратег (Claude Code, локально)
-- `~/scripts/run-pipeline.sh` → sync.js + generate-status.js каждые 30 мин (workdays)
-- `~/Developer/personal-os/asana_context.md` — сырые данные Asana
-- `~/Developer/personal-os/status.md` — живой срез задач для Орла
-- `~/scripts/run-wiki-ingest.sh` → обновляет ~/obsidian/wiki/ (22:00, launchd)
+## Why It Exists
 
-## Орёл (Hermes v0.11.x, Discord бот)
-- Читает только `~/Developer/personal-os/status.md` — никогда не идёт в БД напрямую
-- Discord каналы: #daily-brief #inbox #focus #executor #projects #journal
-- Ищет знания через obsidian MCP по vault
-- Логирует корректировки в `~/Developer/personal-os/logs/corrections_log.md`
-- Cron jobs: morning-brief (08:30), eod-summary (18:00), inbox-check (30 мин), weekly-plan (Пн 08:00), weekly-review (Пт 17:00)
+See: `personal-os-purpose.md`
 
-## Vault (~/obsidian/)
-- `wiki/` — LLM-синтез, генерируется wiki-ingest, не редактировать руками
-- `raw/` — symlinks на внешние файлы проекта
-- `work/`, `personal/`, `family/` — заметки, редактировать свободно
-- Git репозиторий, автокоммит в 23:00 с агентным summary
+## Agents
 
-## База данных (Postgres, только Asana + activity)
-- tasks, stories, task_edges, sync_state
-- signal_queue, activity_daily
-- Нет wiki данных — всё в vault файлах
+### Стратег (Strategist) — data pipeline, no conversation
+- `~/scripts/run-pipeline.sh` → sync.js + generate-status.js every 30 min (workdays via Hermes cron)
+- Writes `~/context/status.md` and `~/Developer/personal-os/asana_context.md`
+- Writes daily AW activity summaries to `activity_daily` table with quadrant classification
+- No Discord output — pure data layer
 
-## Почему wiki-ingest через launchd, не Hermes
-Claude через API не имеет доступа к файловой системе Mac.
-wiki-ingest пишет файлы в ~/obsidian/wiki/ — это требует
-`claude -p` запущенного локально, не API вызова.
+### Орёл / Eagle (Tactician + reactive layer) — Hermes v0.11.x Discord bot
+- Reads `~/context/status.md`, daily/weekly briefs, vault via obsidian MCP
+- Discord channels: `#daily-brief` `#inbox` `#focus` `#executor` `#projects` `#journal` `#retrospector`
+- Cron jobs: morning-brief (08:30 MTWRF), eod-summary (18:00 MTWRF), inbox-check (30 min 09–19 MTWRF), weekly-plan (Mon 08:00), weekly-review (Fri 17:00), retrospector (Fri 17:30), commit-vault (23:00 daily)
+- Logs corrections to `corrections_log` table (SQL INSERT, silently on pushback)
+- **Never accesses Asana API directly** — only reads pre-rendered markdown and DB
 
-## Файлы конфигурации
-- `~/.hermes/config.yaml` — Hermes config, модель, Discord, cron
-- `~/.hermes/SOUL.md` — характер и правила Орла
-- `~/.hermes/auth.json` — Claude Code OAuth (credential_pool)
-- `~/Developer/personal-os/config.json` — Asana workspace/user GIDs
-- `~/.config/personal-os/env` — env vars (ASANA_API_KEY, POSTGRES_URL)
+### Ретроспектор (Retrospector) — Friday pattern analysis
+- Runs as separate Hermes cron at 17:30 Friday → `#retrospector`
+- Sources: corrections_log table, status.md subtask counts, obsidian git log, activity_daily quadrants, stories visibility metric
+- Prompt: `~/Developer/personal-os/agent/prompts/retrospector.md`
+
+### Исполнитель (Executor) — on-demand autonomous worker
+- Triggered by explicit "fix bug [GID]" in #executor — never autonomous
+- Creates git worktree at `~/DuckDuckGo/apple-browsers.git/.claude/worktrees/executor-{gid}-{slug}/`
+- Single STOP gate after analysis; then autonomous: fix → build → test → draft PR → CI loop
+- State machine in `executor_runs` table
+- Prompt: `~/Developer/personal-os/agent/prompts/executor-bug-fix.md`
+- For UI tests: spins VM via ddg-vm MCP (virfield), cleans up on PR close/merge
+
+## Data Flow
+
+```
+Asana API
+  → sync.js (30 min, Hermes cron, silent)
+  → PostgreSQL: tasks, stories, task_edges, sync_state, task_annotations
+
+ActivityWatch (local daemon)
+  → generate-status.js (reads AW HTTP API)
+  → activity_daily (upserts daily project/quadrant summaries)
+
+generate-status.js
+  → ~/context/status.md              ← Eagle reads this
+  → ~/Developer/personal-os/asana_context.md  ← inbox-check reads this
+
+Eagle corrections in Discord
+  → corrections_log table (INSERT on pushback, no announcement)
+  → Retrospector reads weekly
+
+Executor runs
+  → executor_runs table (state machine)
+  → ~/DuckDuckGo/apple-browsers.git/.claude/worktrees/
+  → GitHub draft PRs (--draft, --assignee @me, no reviewers)
+```
+
+## Key File Locations
+
+| File / Path | Purpose |
+|-------------|---------|
+| `~/context/status.md` | Live Asana + AW snapshot. Written by generate-status.js. Eagle reads this. |
+| `~/Developer/personal-os/asana_context.md` | Raw Asana context for inbox-check |
+| `~/Developer/personal-os/agent/prompts/` | All agent prompts (Hermes cron + on-demand) |
+| `~/.hermes/SOUL.md` | Eagle's identity, rules, vault write permissions |
+| `~/Developer/personal-os/config.json` | Asana workspace/user GIDs, section GIDs |
+| `~/Developer/personal-os/aw-projects.json` | ActivityWatch project classification rules |
+| `~/.hermes/config.yaml` | Hermes config: model, MCP servers, cron settings |
+| `~/obsidian/` | Vault — git repo, NAS remote, obsidian-mcp for search |
+| `~/Developer/personal-os/logs/` | heartbeat.log, wiki-ingest-YYYY-MM-DD.md |
+| `~/Developer/personal-os/briefs/` | daily/, weekly/, inbox/ — agent-written brief files |
+| `~/DuckDuckGo/apple-browsers.git/` | Browser repo (bare), worktrees as sibling dirs |
+| `~/DuckDuckGo/apple-browsers.git/.claude/worktrees/` | Executor worktrees |
+
+## Database Tables
+
+| Table | Written by | Read by |
+|-------|-----------|---------|
+| tasks | sync.js | generate-status.js, executor, status queries |
+| stories | sync.js | generate-status.js, executor, retrospector |
+| task_edges | sync.js | subtask traversal |
+| sync_state | sync.js | generate-status.js header |
+| task_annotations | manual / Eagle | generate-status.js irrelevant filter |
+| activity_daily | generate-status.js | retrospector quadrant drift |
+| corrections_log | Eagle on pushback | retrospector pattern analysis |
+| executor_runs | executor | generate-status.js active runs, executor state machine |
+
+## MCP Servers
+
+**Hermes agents:**
+| Name | Command | Used for |
+|------|---------|---------|
+| obsidian | `/opt/homebrew/bin/obsidian-mcp ~/obsidian` | Vault search, read, write |
+
+**Claude Code / `claude -p` sessions:**
+| Name | Command | Used for |
+|------|---------|---------|
+| ddg-vm | `npx tsx ~/Developer/virfield/server/mcp-server.ts` | VM lifecycle for UI tests |
+| obsidian | `/opt/homebrew/bin/obsidian-mcp ~/obsidian` | Vault access |
+
+## launchd Agents
+
+| Label | Schedule | Purpose |
+|-------|----------|---------|
+| personal.os.heartbeat | :05 every hour | Watchdog — triggers missed Hermes jobs after wake |
+| personal.os.wiki-ingest | 22:00 daily | `claude -p` wiki synthesis (needs filesystem access) |
+
+## Vault Structure
+
+```
+~/obsidian/
+├── wiki/          ← LLM-generated + hand-written (confidence: 1.0 = never overwrite)
+│   ├── personal-os-architecture.md    (this file)
+│   ├── personal-os-purpose.md
+│   ├── personal-os-agent-rules.md
+│   ├── personal-os-self-modification.md
+│   ├── personal-os-sync-pipeline.md
+│   ├── personal-os-schema.md          (auto-generated)
+│   ├── ddg-asana-workflow.md
+│   └── vault-filling-guide.md
+├── raw/           ← symlinks to external source files (schema.sql, etc.)
+├── work/
+│   └── wiki/
+│       └── apple-browsers/    ← .cursor/rules copies (.md) + vm-ui-testing.md
+└── personal/ family/
+```