Rockachopa/Timmy-time-dashboard
1
0
Fork 2
Code Issues 7 Pull Requests Actions Packages Projects Releases Wiki Activity

[Sovereignty P1] Narration Template System with Variable Slots #958

New Issue
Closed
opened 2026-03-22 18:23:03 +00:00 by perplexity · 0 comments
perplexity commented 2026-03-22 18:23:03 +00:00
Collaborator
Copy Link

Parent

Part of #953 (The Sovereignty Loop) — P1 priority

Governing Principle

"Script the Predictable, Improvise the Novel" — Eliminates 60% of narration LLM cost.

Goal

Build a template-based narration system for predictable game moments. Templates have variable slots filled from game state. Voiced by Kokoro/Piper locally without touching any LLM.

Template Examples (from the governing doc)

templates["enemy_killed"] = [
    "Another {enemy_type} bites the dust.",
    "That {enemy_type} won't bother anyone again.",
    "{enemy_type} down. Moving on.",
]
templates["low_health"] = [
    "Getting rough out here. Need to find cover.",
    "That hurt. Where's my healing?",
]

Implementation

  1. Create src/timmy/sovereignty/narration_templates.py:
    • NarrationLibrary class with templates stored in data/narration.json
    • get_narration(event_type, context) -> str — template lookup + slot fill
    • crystallize_narration(llm_line, event_type, context) — new LLM lines get templatized
  2. Event categories: enemy_killed, low_health, entered_building, picked_up_loot, opened_menu, quest_complete, NPC_greeting, level_up, death, etc.
  3. LLM fallback only for: quest twists, player interactions, deaths, discoveries, genuinely novel moments
  4. Integration with Kokoro/Piper TTS for local voice synthesis

Metrics Targets

  • 60-70% templatized within a week of play

Effort Estimate

1 day

Cross-references

  • #953 (Sovereignty Loop — Section III.3)
  • #853 (Piper TTS Voice Model)
  • #903 (State-of-Art — mlx-audio/Kokoro for local voice)
## Parent Part of #953 (The Sovereignty Loop) — P1 priority ## Governing Principle > "Script the Predictable, Improvise the Novel" — Eliminates 60% of narration LLM cost. ## Goal Build a template-based narration system for predictable game moments. Templates have variable slots filled from game state. Voiced by Kokoro/Piper locally without touching any LLM. ## Template Examples (from the governing doc) ```python templates["enemy_killed"] = [ "Another {enemy_type} bites the dust.", "That {enemy_type} won't bother anyone again.", "{enemy_type} down. Moving on.", ] templates["low_health"] = [ "Getting rough out here. Need to find cover.", "That hurt. Where's my healing?", ] ``` ## Implementation 1. Create `src/timmy/sovereignty/narration_templates.py`: - `NarrationLibrary` class with templates stored in `data/narration.json` - `get_narration(event_type, context) -> str` — template lookup + slot fill - `crystallize_narration(llm_line, event_type, context)` — new LLM lines get templatized 2. Event categories: enemy_killed, low_health, entered_building, picked_up_loot, opened_menu, quest_complete, NPC_greeting, level_up, death, etc. 3. LLM fallback only for: quest twists, player interactions, deaths, discoveries, genuinely novel moments 4. Integration with Kokoro/Piper TTS for local voice synthesis ## Metrics Targets - 60-70% templatized within a week of play ## Effort Estimate 1 day ## Cross-references - #953 (Sovereignty Loop — Section III.3) - #853 (Piper TTS Voice Model) - #903 (State-of-Art — mlx-audio/Kokoro for local voice)
claude was assigned by Rockachopa 2026-03-22 23:31:14 +00:00
claude added the harnessmorrowindp1-important labels 2026-03-23 13:53:57 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
222-epic
Workshop: Timmy as Presence (Epic #222)
 actionable
Has a concrete code/config task extracted
 assigned-claude
Issue currently assigned to Claude agent — do not assign to another agent
 assigned-gemini
Issue currently assigned to Gemini agent — do not assign to another agent
 assigned-groq
assigned-kimi
Issue currently assigned to Kimi agent — do not assign to another agent
 assigned-manus
Issue currently assigned to Manus agent — do not assign to another agent
 claude-ready
consolidation
Part of a consolidation epic
 deprioritized
Keep open but not blocking P0 work
 deprioritized
Keep open but not blocking P0 work
 duplicate
Duplicate of another issue
 gemini-review
Auto-generated by Gemini, needs relevance review
 groq-ready
harness
Core product: agent framework, heartbeat, inference, memory
 heartbeat
Harness: Agent heartbeat loop
 inference
Harness: Inference and model routing
 infrastructure
Supporting stage: dashboard, CI/CD, deployment, DNS
 kimi-ready
Scoped and ready for Kimi to pick up
 memory-session
Harness: Memory and session crystallization
 morrowind
Harness: Morrowind embodiment
 needs-design
Needs architectural design before implementation
 needs-extraction
Philosophy with unextracted engineering work
 p0-critical
Priority 0: Must fix now
 p1-important
Priority 1: Important, next sprint
 p2-backlog
Priority 2: Backlog, do when time permits
 philosophy
Philosophical foundation — informs architecture decisions
 rejected-direction
Closed: rejected or superseded direction
 seed:know-purpose
Three Seeds: KNOW YOUR PURPOSE
 seed:serve-real
Three Seeds: SERVE THE REAL
 seed:tell-truth
Three Seeds: TELL THE TRUTH
 sovereignty
Harness: Sovereignty stack
No Label harness morrowind p1-important
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Timmy claude grok groq kimi manus perplexity Rockachopa
No Assignees claude
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#958
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?