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

[Core] Heartbeat Loop v2 — Gather/Reason/Act with WorldInterface Integration #872

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

Why This Is High Leverage

Timmy already has think_once() firing every 5 minutes and a Gather → Reason → Act loop stub in src/loop/. But these are disconnected from any world. This ticket wires the heartbeat to the WorldInterface so Timmy's cognitive cycle drives real actions in whatever world he's embodied in — Morrowind, the Matrix, or a test mock.

Scope

Refactor the existing heartbeat/thinking loop to:

  1. Gather: Call world.observe() to get structured perception
  2. Reason: Feed perception + memory + goals to the LLM, get a decision
  3. Act: Call world.act(command) with the decision
  4. Reflect: Log the cycle to CommandLogger, update episodic memory
  5. Broadcast: Emit cognitive state to WebSocket clients (Matrix, dashboard)

Requirements

  • Integrate WorldInterface into the existing src/timmy/agentic_loop.py or src/loop/
  • Each heartbeat cycle produces: one observation, one reasoning trace, one action, one log entry
  • Configurable heartbeat interval (default 30s for game world, 5min for passive thinking)
  • Graceful degradation: if no world adapter is connected, fall back to current think_once() behavior
  • CommandLogger from PR #864 records every cycle automatically

Acceptance Criteria

  • With MockWorldAdapter: heartbeat runs, logs show observe→reason→act→reflect cycle
  • Without adapter: existing think_once() behavior unchanged
  • WebSocket broadcasts include current action and reasoning summary

Dependencies

  • WorldInterface (previous ticket)
  • PR #864 (CommandLogger)

Assignee: Kimi

## Why This Is High Leverage Timmy already has `think_once()` firing every 5 minutes and a Gather → Reason → Act loop stub in `src/loop/`. But these are disconnected from any world. This ticket wires the heartbeat to the WorldInterface so Timmy's cognitive cycle drives real actions in whatever world he's embodied in — Morrowind, the Matrix, or a test mock. ## Scope Refactor the existing heartbeat/thinking loop to: 1. **Gather:** Call `world.observe()` to get structured perception 2. **Reason:** Feed perception + memory + goals to the LLM, get a decision 3. **Act:** Call `world.act(command)` with the decision 4. **Reflect:** Log the cycle to CommandLogger, update episodic memory 5. **Broadcast:** Emit cognitive state to WebSocket clients (Matrix, dashboard) ## Requirements - [ ] Integrate WorldInterface into the existing `src/timmy/agentic_loop.py` or `src/loop/` - [ ] Each heartbeat cycle produces: one observation, one reasoning trace, one action, one log entry - [ ] Configurable heartbeat interval (default 30s for game world, 5min for passive thinking) - [ ] Graceful degradation: if no world adapter is connected, fall back to current think_once() behavior - [ ] CommandLogger from PR #864 records every cycle automatically ## Acceptance Criteria - With MockWorldAdapter: heartbeat runs, logs show observe→reason→act→reflect cycle - Without adapter: existing think_once() behavior unchanged - WebSocket broadcasts include current action and reasoning summary ## Dependencies - WorldInterface (previous ticket) - PR #864 (CommandLogger) ## Assignee: Kimi
claude was assigned by Rockachopa 2026-03-22 23:33:34 +00:00
claude added the harnessheartbeatp0-critical labels 2026-03-23 13:52:54 +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 heartbeat p0-critical
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#872
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?