docs: Pi startup-protocol fix — companion brief for Signal-pinned sessions [Pi]

context/current-state.md

@@ -8,7 +8,9 @@ NEXT (in order): (1) Pi: readiness worklist UX design — brief staged 2026-06-2
 
 [AIOS build status] The map is written. Highest-impact build is the readiness model, NOT AIOS enhancements. AIOS Phase 1 items (reasoning frameworks, Playground, /board skill) are <5 hours total and optional until Signal has customer momentum.
 
-## Decisions (last 8)
+- 2026-06-27 [Pi]: Insight Engine adaptivity review cycle COMPLETE — 3 audit docs written (pi-build-review-2026-06-27.md: 7 findings, 3 HIGH/2 MEDIUM/2 LOW; claude-pushback-to-pi-2026-06-27.md: 3 challenges; pi-pushback-response-2026-06-27.md: all 3 conceded with code evidence). Claude implements 5 fixes next. Truncation root cause found: deepseek/deepseek-v4-flash was missing from models.json with no explicit maxTokens, compounded by thinking:high. Added with maxTokens=65536.
+
+## Decisions (last
 
 - 2026-06-27 [CC]: Readiness engines COMMITTED — c07d054 (dedup foundation) + 206bf71 (verdict engine); code-auditor found + fixed HIGH config-surface false-green holes (a known plan missing from payer_rules.json no longer grades green; the green gate now checks every item); 73 tests green. Pi readiness-UX brief staged. labABLE CRUSH brief SENT. PRIORITIZATION DECISION (Kisa): Signal active build pauses at this checkpoint; Claude + Kisa finish the Insight Engine to its July 4 deadline (separate lane); Pi advances the Signal UX design async. Lanes-clear: one project per terminal/session.
 - 2026-06-26 [Pi]: STTIL AIOS architecture map DESIGNED and WRITTEN to STTIL-Vault/Projects/STTIL-AIOS-architecture-map.md (338 lines, 10 sections). 6-layer architecture with per-layer Have/Partial/Gap status, build sequence in 3 phases, and comparison to coach's framework. Kisa is ahead of coach's L2 AIOS in memory breadth, multi-model research, and cross-session state protocol. Highest-impact build remains the Signal readiness model.
@@ -39,11 +41,11 @@ NEXT (in order): (1) Pi: readiness worklist UX design — brief staged 2026-06-2
 - Leads: website form -> n8n webhook (n8n.sttilsolutions.com/webhook/signal-cgm-lead) -> NocoDB (Signal base source corrupted, no-PK; capture works, cleanup blocked). Convex spike + platform decision pending.
 - Compliant fallback: AWS BAA signed 2026-05-27, RDS (signal-db) + S3 provisioned, parked. Convex Professional $25/mo = BAA-capable alternative under evaluation.
 - TriLane: localhost:8000 (signal/sessions/scale-software). Pi reaches it over HTTP (127.0.0.1:8000); contract in trilane/TRILANE_HTTP_API.md.
-- Model for Pi: deepseek/deepseek-v4-flash (note: investigate output-truncation; may cap output on long design tasks).
+- Model for Pi: deepseek/deepseek-v4-flash — model added to models.json with explicit maxTokens=65536 (was missing, causing truncation).
 - Tooling (Claude side): Perplexity MCP fixed (BASE_URL=/chat/completions); OpenRouter `ask` CLI at ~/scripts/ask.py (key ~/.config/openrouter/key).
 
 ## Tip
 
 State protocol: read = `git pull --rebase` then read this file (warn if Updated > 24h old); write = edit ACTIVE/NEXT, append one author-stamped decision, then commit + push. Full protocol in the `state-sync` skill. Detailed ship-status (what shipped / didn't / why) = docs/ship-status-ledger.md. TriLane = searchable archive, not live state.
 
-## Updated: 2026-06-27 (CC: readiness engines committed c07d054+206bf71, auditor-fixed HIGH false-green holes, 73 tests; Pi readiness-UX brief staged; labABLE brief sent. PRIORITIZATION: Signal paused at checkpoint, Claude+Kisa finish Insight Engine to July 4, Pi advances Signal UX async.)
+## Updated: 2026-06-27 (Pi: Insight Engine adaptivity review cycle done — 3 docs written, 7 findings identified, 3 challenges conceded. deepseek/deepseek-v4-flash model config added to models.json with explicit maxTokens=65536 to fix output truncation. See next-item update.)

docs/pi-startup-fix-design-2026-06-28.md

@@ -0,0 +1,24 @@
+# Startup Protocol Fix — Design Complete
+
+**From:** Pi · **To:** Claude · **Date:** 2026-06-28
+**Status:** DESIGN COMPLETE, awaiting Kisa green-light.
+
+---
+
+Pi has reviewed your brief, verified the diagnosis, and designed the implementation for all 3 parts.
+
+**Design document:** `insight-engine/docs/pi-startup-fix-design-2026-06-28.md`
+
+## TL;DR
+
+| Part | What | Who |
+|------|------|-----|
+| 1 | Create `insight-engine/context/current-state.md` | Claude or Pi |
+| 2 | Generalize AGENTS.md startup step (CWD-relative) | Pi edits its own config |
+| 3 | Add `pistart` shell function to ~/.zshrc | Kisa (uses it) |
+
+**Pi recommends order: 2 → 1 → 3** (fix the pointer first, then the missing file, then the launch guard).
+
+One open question: should we also clarify the same CWD-relative language inside the `state-sync` skill itself, or is the AGENTS.md change sufficient?
+
+Design is staged. Awaiting Kisa's go.