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

[kimi-task] [feat] Add /api/matrix/config endpoint — serve world config to Matrix #674

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

Epic: Matrix Unification

Task

Add GET /api/matrix/config endpoint that returns world configuration: lighting presets,
environment settings, and feature flags. This lets the Matrix frontend be config-driven
rather than hardcoded.

Files

  • src/dashboard/routes/world.py — add /api/matrix/config route
  • config/matrix.yaml — NEW: world config (lighting, environment, features)
  • tests/timmy/test_world_api.py — add test

Acceptance Criteria

  • Returns JSON with sections: lighting, environment, features
  • lighting: ambient_color, ambient_intensity, point_lights (array of {color, intensity, position})
  • environment: rain_enabled, starfield_enabled, fog_color, fog_density
  • features: chat_enabled, visitor_avatars, pip_familiar, workshop_portal
  • Reads from config/matrix.yaml, falls back to sensible defaults
  • tox -e unit passes
  • tox -e lint passes

Context

The Matrix frontend has hardcoded lighting and environment. By serving config from the backend,
we can adjust the world without redeploying the frontend. This also enables the Workshop's warm
lighting to coexist with the Matrix's cool ambient (issue #87 in the-matrix repo).

## Epic: Matrix Unification ## Task Add GET /api/matrix/config endpoint that returns world configuration: lighting presets, environment settings, and feature flags. This lets the Matrix frontend be config-driven rather than hardcoded. ## Files - src/dashboard/routes/world.py — add /api/matrix/config route - config/matrix.yaml — NEW: world config (lighting, environment, features) - tests/timmy/test_world_api.py — add test ## Acceptance Criteria - [ ] Returns JSON with sections: lighting, environment, features - [ ] lighting: ambient_color, ambient_intensity, point_lights (array of {color, intensity, position}) - [ ] environment: rain_enabled, starfield_enabled, fog_color, fog_density - [ ] features: chat_enabled, visitor_avatars, pip_familiar, workshop_portal - [ ] Reads from config/matrix.yaml, falls back to sensible defaults - [ ] tox -e unit passes - [ ] tox -e lint passes ## Context The Matrix frontend has hardcoded lighting and environment. By serving config from the backend, we can adjust the world without redeploying the frontend. This also enables the Workshop's warm lighting to coexist with the Matrix's cool ambient (issue #87 in the-matrix repo).
kimi self-assigned this 2026-03-21 03:12:07 +00:00
kimi commented 2026-03-21 14:25:01 +00:00
Author
Collaborator
Copy Link

PR #736 created.

Summary of Changes

Files Added/Modified

  1. config/matrix.yaml (new) - World configuration with:

    • Lighting: ambient color/intensity, 3 point lights
    • Environment: rain/starfield toggles, fog settings
    • Features: chat, avatars, Pip familiar, workshop portal flags

  2. src/dashboard/routes/world.py - Added:

    • GET /api/matrix/config endpoint
    • _DEFAULT_MATRIX_CONFIG fallback defaults
    • _load_matrix_config() function with graceful degradation

  3. tests/dashboard/test_world_api.py - Added 10+ new tests:

    • TestMatrixConfigEndpoint: Tests for endpoint response structure
    • TestMatrixConfigLoading: Tests for config loading, merging, and fallbacks

Acceptance Criteria Met

  • ✅ Returns JSON with sections: lighting, environment, features
  • ✅ lighting: ambient_color, ambient_intensity, point_lights[]
  • ✅ environment: rain_enabled, starfield_enabled, fog_color, fog_density
  • ✅ features: chat_enabled, visitor_avatars, pip_familiar, workshop_portal
  • ✅ Reads from config/matrix.yaml, falls back to sensible defaults
  • ✅ tox -e unit passes (2491 tests)
  • ✅ tox -e lint passes
PR #736 created. ## Summary of Changes ### Files Added/Modified 1. **config/matrix.yaml** (new) - World configuration with: - Lighting: ambient color/intensity, 3 point lights - Environment: rain/starfield toggles, fog settings - Features: chat, avatars, Pip familiar, workshop portal flags 2. **src/dashboard/routes/world.py** - Added: - `GET /api/matrix/config` endpoint - `_DEFAULT_MATRIX_CONFIG` fallback defaults - `_load_matrix_config()` function with graceful degradation 3. **tests/dashboard/test_world_api.py** - Added 10+ new tests: - `TestMatrixConfigEndpoint`: Tests for endpoint response structure - `TestMatrixConfigLoading`: Tests for config loading, merging, and fallbacks ### Acceptance Criteria Met - ✅ Returns JSON with sections: lighting, environment, features - ✅ lighting: ambient_color, ambient_intensity, point_lights[] - ✅ environment: rain_enabled, starfield_enabled, fog_color, fog_density - ✅ features: chat_enabled, visitor_avatars, pip_familiar, workshop_portal - ✅ Reads from config/matrix.yaml, falls back to sensible defaults - ✅ tox -e unit passes (2491 tests) - ✅ tox -e lint passes
kimi closed this issue 2026-03-21 14:25:20 +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#674
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?