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

[kimi-task] [enhancement] Add /api/matrix/health endpoint #685

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

Epic: Matrix Unification

Task

Add a dedicated health endpoint for the Matrix frontend to check if the backend is alive
and what capabilities are available.

Files

  • src/dashboard/routes/world.py — add /api/matrix/health route
  • tests/timmy/test_world_api.py — add test

Acceptance Criteria

  • GET /api/matrix/health returns JSON with: status (ok/degraded), version, capabilities
  • capabilities is a dict of feature:bool (thinking, memory, bark, familiar, lightning)
  • Each capability checks if the relevant module is actually available
  • Response time must be <100ms (no heavy checks)
  • Returns 200 even if some capabilities are degraded
  • tox -e unit passes
  • tox -e lint passes

Context

The Matrix frontend needs to know what the backend supports so it can show/hide UI elements.
If thinking is disabled, don't show thought bubbles. If memory is empty, skip the crystal ball.

## Epic: Matrix Unification ## Task Add a dedicated health endpoint for the Matrix frontend to check if the backend is alive and what capabilities are available. ## Files - src/dashboard/routes/world.py — add /api/matrix/health route - tests/timmy/test_world_api.py — add test ## Acceptance Criteria - [ ] GET /api/matrix/health returns JSON with: status (ok/degraded), version, capabilities - [ ] capabilities is a dict of feature:bool (thinking, memory, bark, familiar, lightning) - [ ] Each capability checks if the relevant module is actually available - [ ] Response time must be <100ms (no heavy checks) - [ ] Returns 200 even if some capabilities are degraded - [ ] tox -e unit passes - [ ] tox -e lint passes ## Context The Matrix frontend needs to know what the backend supports so it can show/hide UI elements. If thinking is disabled, don't show thought bubbles. If memory is empty, skip the crystal ball.
kimi self-assigned this 2026-03-21 03:12:16 +00:00
kimi commented 2026-03-21 15:51:15 +00:00
Author
Collaborator
Copy Link

PR created: http://143.198.27.163:3000/rockachopa/Timmy-time-dashboard/pulls/745

Summary of Changes

src/dashboard/routes/world.py

Added GET /api/matrix/health endpoint that returns:

  • status: "ok" or "degraded" (based on core capabilities: thinking, memory, bark)
  • version: API version string
  • capabilities: dict with feature availability
    • thinking: true if thinking engine is available
    • memory: true if memory system is available
    • bark: true if bark production is available
    • familiar: true if Pip familiar is available
    • lightning: true if Lightning payments are enabled (currently false)

tests/dashboard/test_world_api.py

Added comprehensive tests for:

  • Endpoint response structure
  • Status field values
  • Version field
  • Capabilities dict structure
  • Individual capability check functions
  • Response time (<100ms)
  • 200 status even when degraded

Testing Results

  • tox -e unit: 2589 passed, 1 skipped ✓
  • tox -e lint: All checks passed ✓
  • tox -e format: Applied ✓
PR created: http://143.198.27.163:3000/rockachopa/Timmy-time-dashboard/pulls/745 ## Summary of Changes ### src/dashboard/routes/world.py Added `GET /api/matrix/health` endpoint that returns: - `status`: "ok" or "degraded" (based on core capabilities: thinking, memory, bark) - `version`: API version string - `capabilities`: dict with feature availability - `thinking`: true if thinking engine is available - `memory`: true if memory system is available - `bark`: true if bark production is available - `familiar`: true if Pip familiar is available - `lightning`: true if Lightning payments are enabled (currently false) ### tests/dashboard/test_world_api.py Added comprehensive tests for: - Endpoint response structure - Status field values - Version field - Capabilities dict structure - Individual capability check functions - Response time (<100ms) - 200 status even when degraded ### Testing Results - `tox -e unit`: 2589 passed, 1 skipped ✓ - `tox -e lint`: All checks passed ✓ - `tox -e format`: Applied ✓
kimi closed this issue 2026-03-21 15:51:30 +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#685
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?