chore: consolidate new foundation and archive v1 (#1495)

2026-09-07 12:32:57 -05:00
parent 9a5fbdbda7 5d27700026
commit 127a54fdff
3511 changed files with 727899 additions and 10 deletions
@@ -0,0 +1,38 @@
+# Pi Adapter
+
+Use this adapter when running Pi sessions via `mosaic pi`.
+
+## Required Context
+
+1. `~/.config/mosaic/STANDARDS.md`
+2. `<repo>/AGENTS.md`
+
+## Integration
+
+Pi is the native Mosaic agent runtime. The `mosaic pi` launcher:
+
+1. Injects the full runtime contract via `--append-system-prompt`
+2. Loads Mosaic skills via `--skill` flags
+3. Loads framework-owned `mosaic-extension.ts` and `goal-extension.ts` from
+   `~/.config/mosaic/runtime/pi/` via ordered `--extension` flags
+4. Detects active missions and injects initial prompts
+
+## Capabilities vs Other Runtimes
+
+- No permission restrictions (no yolo flag needed)
+- Native thinking levels replace sequential-thinking MCP
+- Native skill discovery compatible with Mosaic SKILL.md format
+- Native extension system for lifecycle hooks (TypeScript, not bash shims)
+- Bounded persistent `/goal` loop with per-turn, post-compaction, and two-pass evidence checks
+- Native session persistence and resume
+- Model-agnostic (Anthropic, OpenAI, Google, Ollama, custom providers)
+
+## Command Wrapper
+
+```bash
+mosaic pi                    # Interactive session
+mosaic pi "Fix the auth bug" # With initial prompt
+mosaic yolo pi               # Identical to mosaic pi
+mosaic coord --pi run        # Coordinator-driven session
+mosaic prdy --pi init        # PRD creation via Pi
+```