PR for #982: [GOVERNING] Session Crystallization & Operational Playbook — Master Handoff Document #1043

Closed
gemini wants to merge 0 commits from feature/issue-982 into main
Collaborator

Closes #982

Summary

This is the master handoff document for the Timmy Time project, synthesizing six deep research spikes from the March 22, 2026 session into a single operational playbook. Any agent picking up Timmy's development cold should read this first.

Document Structure

Section Content Use
0 How to use this document Read order for agents
1 The Breakthrough: Perception Without Vision OpenMW Lua = 95% API-readable game state
2 Current Project State Codebase map, critical gaps, blocking PRs, priority stack
3 The Sovereign Technology Stack 80+ tools with pinned versions and install commands
4 Pre-Computation ESM extraction, nav graph, dialogue pre-evaluation, UESP RAG
5 Sprint Plan: The Next 90 Days Foundation (week 1), Morrowind (month 1), Creative (quarter)
6 The Research Meta-Skill How to run autonomous research spikes
7 Key Constraints and Non-Negotiables Morrowind confirmed, no cloud deps, tests green
8 The Done Checklist 16 concrete, testable milestones

Critical Gaps from Operation Darling Purge (§2.3)

Commit 584eeb679e88 removed three capabilities that must be restored:

  1. Self-modification loop (self_coding/self_modify/loop.py) — DELETED. Restore using Goose or mini-swe-agent.
  2. MCP integration (mcp/registry.py) — DELETED. Replace with FastMCP v3.1.1 at /tools/mcp.
  3. Task delegation (delegate_task) — NEUTERED. Wire to brain/worker.py DistributedWorker.

Priority Stack (§2.5)

# Task Gitea Issue Blocked By
1 Merge 3 foundation PRs #864, #865, #900 Nothing
2 TES3MP Bridge (Python-to-Lua IPC) #878 PRs merged
3 TES3MP Server on Hermes VPS #818 Nothing (parallel)
4 Three-Tier Memory #873 PRs merged
5 Docker Compose #875 Tasks 1-4
6 Model Router upgrade (vllm-mlx) #882 Nothing (parallel)
7 Nostr Identity #877 Nothing (parallel)
8 AlexanderWhitestone.com #879 Tasks 5-7

The 16-Point Done Checklist (§8)

  • 1. All three PRs merged, pytest passes
  • 2. FastMCP v3.1.1 at /tools/mcp with 3+ tools
  • 3. vllm-mlx serves Qwen3-8B + Llama-3.3-70B
  • 4. OpenMW connects to TES3MP on Hermes
  • 5. to_python.json live player data at 1Hz
  • 6. pytest test_tes3mp_adapter.py passes
  • 7. Timmy walks Census Office to Fargoth autonomously
  • 8. TIMMY COMPLETES MORROWIND TUTORIAL (under 15 min, no human input)
  • 9. Graphiti episodic memory returns census office
  • 10. git clone + docker-compose up = working stack in 90s
  • 11. 5-min OBS recording with thought overlay
  • 12. Content pipeline: sub-5-min episode from 2hr raw
  • 13. ACE-Step 30s music loop in under 60s
  • 14. Nostr profile visible on nostr.band
  • 15. LND synced with 1+ open channel
  • 16. AlexanderWhitestone.com live with TLS, video, art, Lightning tips

Sovereign Tech Stack Manifest (§3)

8 categories, 40+ tools with pinned versions:

  • LLM Inference: vllm-mlx, Ollama v0.18.2, mlx-lm v0.31.1, exo 1.0 EA
  • Coding Agents: Goose v1.20.1, OpenHands v1.5.0, Aider, mini-swe-agent v2, Forgejo v14.0.3
  • Image Gen: ComfyUI v0.17.2, Draw Things, FLUX.1 Dev GGUF Q8, FLUX.2 Klein
  • Music/Voice: ACE-Step 1.5, mlx-audio v0.4.1, Piper TTS v1.4.1, GPT-SoVITS v2pro
  • Orchestration: FastMCP v3.1.1, PocketFlow, CrewAI v1.11.0, Agno v2.5.10
  • Nostr/Lightning: nostr-sdk v0.44.2, nostrdvm, LND v0.20.1, LN agent-tools, LNbits v1.4, Cashu v0.17.0
  • Memory/KG: Graphiti v0.28.2, Neo4j 2026.02, ChromaDB v1.5.5, Mem0 v1.0.5
  • Streaming: MediaMTX v1.16.3, OBS v32.0.4, obsws-python, MoviePy v2.1.2

PDF attached. See cross-reference comment for links to all related tickets.

Closes #982 ## Summary This is the **master handoff document** for the Timmy Time project, synthesizing six deep research spikes from the March 22, 2026 session into a single operational playbook. Any agent picking up Timmy's development cold should read this first. ## Document Structure | Section | Content | Use | |---------|---------|-----| | 0 | How to use this document | Read order for agents | | 1 | The Breakthrough: Perception Without Vision | OpenMW Lua = 95% API-readable game state | | 2 | Current Project State | Codebase map, critical gaps, blocking PRs, priority stack | | 3 | The Sovereign Technology Stack | 80+ tools with pinned versions and install commands | | 4 | Pre-Computation | ESM extraction, nav graph, dialogue pre-evaluation, UESP RAG | | 5 | Sprint Plan: The Next 90 Days | Foundation (week 1), Morrowind (month 1), Creative (quarter) | | 6 | The Research Meta-Skill | How to run autonomous research spikes | | 7 | Key Constraints and Non-Negotiables | Morrowind confirmed, no cloud deps, tests green | | 8 | The Done Checklist | 16 concrete, testable milestones | ## Critical Gaps from Operation Darling Purge (§2.3) Commit `584eeb679e88` removed three capabilities that must be restored: 1. **Self-modification loop** (`self_coding/self_modify/loop.py`) — DELETED. Restore using Goose or mini-swe-agent. 2. **MCP integration** (`mcp/registry.py`) — DELETED. Replace with FastMCP v3.1.1 at `/tools/mcp`. 3. **Task delegation** (`delegate_task`) — NEUTERED. Wire to `brain/worker.py` DistributedWorker. ## Priority Stack (§2.5) | # | Task | Gitea Issue | Blocked By | |---|------|-------------|------------| | 1 | Merge 3 foundation PRs | #864, #865, #900 | Nothing | | 2 | TES3MP Bridge (Python-to-Lua IPC) | #878 | PRs merged | | 3 | TES3MP Server on Hermes VPS | #818 | Nothing (parallel) | | 4 | Three-Tier Memory | #873 | PRs merged | | 5 | Docker Compose | #875 | Tasks 1-4 | | 6 | Model Router upgrade (vllm-mlx) | #882 | Nothing (parallel) | | 7 | Nostr Identity | #877 | Nothing (parallel) | | 8 | AlexanderWhitestone.com | #879 | Tasks 5-7 | ## The 16-Point Done Checklist (§8) - [ ] 1. All three PRs merged, pytest passes - [ ] 2. FastMCP v3.1.1 at /tools/mcp with 3+ tools - [ ] 3. vllm-mlx serves Qwen3-8B + Llama-3.3-70B - [ ] 4. OpenMW connects to TES3MP on Hermes - [ ] 5. to_python.json live player data at 1Hz - [ ] 6. pytest test_tes3mp_adapter.py passes - [ ] 7. Timmy walks Census Office to Fargoth autonomously - [ ] 8. **TIMMY COMPLETES MORROWIND TUTORIAL** (under 15 min, no human input) - [ ] 9. Graphiti episodic memory returns census office - [ ] 10. git clone + docker-compose up = working stack in 90s - [ ] 11. 5-min OBS recording with thought overlay - [ ] 12. Content pipeline: sub-5-min episode from 2hr raw - [ ] 13. ACE-Step 30s music loop in under 60s - [ ] 14. Nostr profile visible on nostr.band - [ ] 15. LND synced with 1+ open channel - [ ] 16. AlexanderWhitestone.com live with TLS, video, art, Lightning tips ## Sovereign Tech Stack Manifest (§3) 8 categories, 40+ tools with pinned versions: - **LLM Inference:** vllm-mlx, Ollama v0.18.2, mlx-lm v0.31.1, exo 1.0 EA - **Coding Agents:** Goose v1.20.1, OpenHands v1.5.0, Aider, mini-swe-agent v2, Forgejo v14.0.3 - **Image Gen:** ComfyUI v0.17.2, Draw Things, FLUX.1 Dev GGUF Q8, FLUX.2 Klein - **Music/Voice:** ACE-Step 1.5, mlx-audio v0.4.1, Piper TTS v1.4.1, GPT-SoVITS v2pro - **Orchestration:** FastMCP v3.1.1, PocketFlow, CrewAI v1.11.0, Agno v2.5.10 - **Nostr/Lightning:** nostr-sdk v0.44.2, nostrdvm, LND v0.20.1, LN agent-tools, LNbits v1.4, Cashu v0.17.0 - **Memory/KG:** Graphiti v0.28.2, Neo4j 2026.02, ChromaDB v1.5.5, Mem0 v1.0.5 - **Streaming:** MediaMTX v1.16.3, OBS v32.0.4, obsws-python, MoviePy v2.1.2 --- **PDF attached. See cross-reference comment for links to all related tickets.**
Timmy closed this pull request 2026-03-23 15:03:00 +00:00
Some checks failed
Tests / lint (push) Has been cancelled
Tests / test (push) Has been cancelled
Tests / lint (pull_request) Successful in 19s
Tests / test (pull_request) Failing after 25m3s

Pull request closed

Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#1043