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

[kimi-task] [feat] Add matrix config loader utility #680

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

Epic: Matrix Unification

Task

Create a config loader module that the Matrix frontend will use to fetch its configuration
from the Dashboard API instead of using hardcoded values.

Files

  • src/infrastructure/matrix_config.py — NEW: MatrixConfig dataclass + load_from_yaml()
  • config/matrix.yaml — NEW: default Matrix world configuration
  • tests/unit/test_matrix_config.py — NEW: test loading and defaults

Acceptance Criteria

  • MatrixConfig dataclass with sections: lighting, environment, features, agents
  • load_from_yaml(path) loads config/matrix.yaml
  • Missing keys fall back to sensible defaults (not crash)
  • Default lighting: warm amber ambient + cool blue starfield (Workshop + Matrix blend)
  • Default features: all enabled
  • tox -e unit passes
  • tox -e lint passes

Context

This is the backend side of config. The /api/matrix/config endpoint will serve this.
The Matrix frontend js/ files will fetch this on boot instead of hardcoding values.
Lighting defaults should blend Workshop warmth (amber 0xFFAA55) with Matrix cool (blue 0x4466FF).

## Epic: Matrix Unification ## Task Create a config loader module that the Matrix frontend will use to fetch its configuration from the Dashboard API instead of using hardcoded values. ## Files - src/infrastructure/matrix_config.py — NEW: MatrixConfig dataclass + load_from_yaml() - config/matrix.yaml — NEW: default Matrix world configuration - tests/unit/test_matrix_config.py — NEW: test loading and defaults ## Acceptance Criteria - [ ] MatrixConfig dataclass with sections: lighting, environment, features, agents - [ ] load_from_yaml(path) loads config/matrix.yaml - [ ] Missing keys fall back to sensible defaults (not crash) - [ ] Default lighting: warm amber ambient + cool blue starfield (Workshop + Matrix blend) - [ ] Default features: all enabled - [ ] tox -e unit passes - [ ] tox -e lint passes ## Context This is the backend side of config. The /api/matrix/config endpoint will serve this. The Matrix frontend js/ files will fetch this on boot instead of hardcoding values. Lighting defaults should blend Workshop warmth (amber 0xFFAA55) with Matrix cool (blue 0x4466FF).
kimi self-assigned this 2026-03-21 03:12:12 +00:00
kimi commented 2026-03-21 15:04:47 +00:00
Author
Collaborator
Copy Link

✅ PR created: #742

Implementation Summary

Created the matrix config loader utility as specified:

Files Added/Modified

  • src/infrastructure/matrix_config.py (258 lines)

    • MatrixConfig dataclass with nested sections: lighting, environment, features, agents
    • load_from_yaml(path) - loads config with sensible defaults for missing keys
    • to_dict() - serialization for API responses

  • config/matrix.yaml - Updated with Workshop+Matrix blend:

    • Ambient: warm amber #FFAA55 (Workshop warmth)
    • Point lights: warm center + cool blue/purple accents (Matrix feel)
    • Starfield enabled by default
    • All features enabled

  • tests/unit/test_matrix_config.py (289 lines)

    • Comprehensive tests for all dataclasses
    • Tests for loading, defaults, error handling
    • 2564 tests passing

API Usage

from infrastructure.matrix_config import load_from_yaml

config = load_from_yaml("config/matrix.yaml")
print(config.lighting.ambient_color)  # "#FFAA55"
print(config.features.chat_enabled)   # True

Ready for review.

✅ **PR created: #742** ## Implementation Summary Created the matrix config loader utility as specified: ### Files Added/Modified - `src/infrastructure/matrix_config.py` (258 lines) - `MatrixConfig` dataclass with nested sections: lighting, environment, features, agents - `load_from_yaml(path)` - loads config with sensible defaults for missing keys - `to_dict()` - serialization for API responses - `config/matrix.yaml` - Updated with Workshop+Matrix blend: - Ambient: warm amber `#FFAA55` (Workshop warmth) - Point lights: warm center + cool blue/purple accents (Matrix feel) - Starfield enabled by default - All features enabled - `tests/unit/test_matrix_config.py` (289 lines) - Comprehensive tests for all dataclasses - Tests for loading, defaults, error handling - 2564 tests passing ### API Usage ```python from infrastructure.matrix_config import load_from_yaml config = load_from_yaml("config/matrix.yaml") print(config.lighting.ambient_color) # "#FFAA55" print(config.features.chat_enabled) # True ``` Ready for review.
kimi closed this issue 2026-03-21 15:05:07 +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#680
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?