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

[kimi-task] [feat] Add Pip familiar state to agent_state messages #676

New Issue
Closed
opened 2026-03-21 03:12:09 +00:00 by kimi · 1 comment
kimi commented 2026-03-21 03:12:09 +00:00
Collaborator
Copy Link

Epic: Matrix Unification

Task

Extend the agent_state message for Timmy to include Pip familiar state. The Workshop
already has a Pip behavioral state machine (familiar.py). Include Pip's state in the
agent_state so the Matrix can render the familiar orb.

Files

  • src/infrastructure/presence.py — extend produce_agent_state() to include familiar field
  • tests/unit/test_presence.py — add test for familiar data in agent_state

Acceptance Criteria

  • agent_state.data.familiar includes: name, mood, energy, color, trail_color
  • Falls back to default Pip state if familiar module not available
  • Does not crash if familiar.py raises an exception
  • tox -e unit passes
  • tox -e lint passes

Context

Pip is an emerald green glowing orb (core 0x00b450) with gold particle trail (0xdaa520).
Behavioral states: curious, content, alert, sleepy, playful. Energy decays over time.
The Matrix (js/familiar.js, issue #86) needs this data to animate Pip.

## Epic: Matrix Unification ## Task Extend the agent_state message for Timmy to include Pip familiar state. The Workshop already has a Pip behavioral state machine (familiar.py). Include Pip's state in the agent_state so the Matrix can render the familiar orb. ## Files - src/infrastructure/presence.py — extend produce_agent_state() to include familiar field - tests/unit/test_presence.py — add test for familiar data in agent_state ## Acceptance Criteria - [ ] agent_state.data.familiar includes: name, mood, energy, color, trail_color - [ ] Falls back to default Pip state if familiar module not available - [ ] Does not crash if familiar.py raises an exception - [ ] tox -e unit passes - [ ] tox -e lint passes ## Context Pip is an emerald green glowing orb (core 0x00b450) with gold particle trail (0xdaa520). Behavioral states: curious, content, alert, sleepy, playful. Energy decays over time. The Matrix (js/familiar.js, issue #86) needs this data to animate Pip.
kimi self-assigned this 2026-03-21 03:12:09 +00:00
kimi commented 2026-03-21 14:37:26 +00:00
Author
Collaborator
Copy Link

PR created: #738

Summary of Changes

src/infrastructure/presence.py

  • Added DEFAULT_PIP_STATE constant with Pip familiar defaults:
    • name: "Pip"
    • mood: "sleepy"
    • energy: 0.5
    • color: "0x00b450" (emerald green)
    • trail_color: "0xdaa520" (gold)
  • Added _get_familiar_state() helper with graceful error handling
  • Extended produce_agent_state() to include familiar in data dict

tests/unit/test_presence.py

  • Added TestFamiliarState class with 5 test cases
  • Added tests for familiar data in produce_agent_state() output
  • Tests verify fallback behavior on exception

All acceptance criteria met. All tests pass (2507 passed).

PR created: #738 ## Summary of Changes ### src/infrastructure/presence.py - Added `DEFAULT_PIP_STATE` constant with Pip familiar defaults: - name: "Pip" - mood: "sleepy" - energy: 0.5 - color: "0x00b450" (emerald green) - trail_color: "0xdaa520" (gold) - Added `_get_familiar_state()` helper with graceful error handling - Extended `produce_agent_state()` to include `familiar` in `data` dict ### tests/unit/test_presence.py - Added `TestFamiliarState` class with 5 test cases - Added tests for familiar data in `produce_agent_state()` output - Tests verify fallback behavior on exception All acceptance criteria met. All tests pass (2507 passed).
kimi closed this issue 2026-03-21 14:37:40 +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
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Timmy claude grok groq kimi manus perplexity Rockachopa
No Assignees kimi
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#676
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?