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/memory/search endpoint — visitors query Timmy's memory #678

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

Epic: Matrix Unification

Task

Add GET /api/matrix/memory/search?q= endpoint that lets Matrix visitors search
Timmy's memory. Returns relevant memories formatted for the 3D world display.

Files

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

Acceptance Criteria

  • GET /api/matrix/memory/search?q=bitcoin returns JSON array of memory snippets
  • Each result: {text (truncated 200 chars), relevance (0-1), created_at, context_type}
  • Max 5 results per query
  • Returns 400 if q param missing or empty
  • Rate limited to 1 search per 5 seconds per IP
  • Reuses existing memory_system.search() internals
  • tox -e unit passes
  • tox -e lint passes

Context

In the Matrix 3D world, visitors can interact with Timmy. Being able to search his memory
("what do you remember about sovereignty?") is a core presence feature. Results will appear
as floating crystal-ball text in the Workshop room.

## Epic: Matrix Unification ## Task Add GET /api/matrix/memory/search?q=<query> endpoint that lets Matrix visitors search Timmy's memory. Returns relevant memories formatted for the 3D world display. ## Files - src/dashboard/routes/world.py — add /api/matrix/memory/search route - tests/timmy/test_world_api.py — add test ## Acceptance Criteria - [ ] GET /api/matrix/memory/search?q=bitcoin returns JSON array of memory snippets - [ ] Each result: {text (truncated 200 chars), relevance (0-1), created_at, context_type} - [ ] Max 5 results per query - [ ] Returns 400 if q param missing or empty - [ ] Rate limited to 1 search per 5 seconds per IP - [ ] Reuses existing memory_system.search() internals - [ ] tox -e unit passes - [ ] tox -e lint passes ## Context In the Matrix 3D world, visitors can interact with Timmy. Being able to search his memory ("what do you remember about sovereignty?") is a core presence feature. Results will appear as floating crystal-ball text in the Workshop room.
kimi self-assigned this 2026-03-21 03:12:10 +00:00
kimi commented 2026-03-21 14:52:17 +00:00
Author
Collaborator
Copy Link

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

Implementation Summary

Implemented the /api/matrix/memory/search endpoint as specified:

✅ Acceptance Criteria Met

  • GET /api/matrix/memory/search?q=bitcoin returns JSON array of memory snippets
  • Each result includes: text (truncated 200 chars), relevance (0-1), created_at, context_type
  • Max 5 results per query
  • Returns 400 if q param missing or empty
  • Rate limited to 1 search per 5 seconds per IP (with Retry-After header)
  • Reuses existing memory_system.search() internals
  • tox -e unit passes (2535 passed)
  • tox -e lint passes

Additional Features

  • IP extraction respects X-Forwarded-For header (for proxy support)
  • Graceful degradation returns empty array on search failure
  • Comprehensive test coverage (18 new tests)

Files Changed

  • src/dashboard/routes/world.py (+120 lines)
  • tests/dashboard/test_world_api.py (+263 lines)
PR created: http://143.198.27.163:3000/rockachopa/Timmy-time-dashboard/pulls/740 ## Implementation Summary Implemented the `/api/matrix/memory/search` endpoint as specified: ### ✅ Acceptance Criteria Met - [x] GET `/api/matrix/memory/search?q=bitcoin` returns JSON array of memory snippets - [x] Each result includes: `text` (truncated 200 chars), `relevance` (0-1), `created_at`, `context_type` - [x] Max 5 results per query - [x] Returns 400 if `q` param missing or empty - [x] Rate limited to 1 search per 5 seconds per IP (with `Retry-After` header) - [x] Reuses existing `memory_system.search()` internals - [x] `tox -e unit` passes (2535 passed) - [x] `tox -e lint` passes ### Additional Features - IP extraction respects `X-Forwarded-For` header (for proxy support) - Graceful degradation returns empty array on search failure - Comprehensive test coverage (18 new tests) ### Files Changed - `src/dashboard/routes/world.py` (+120 lines) - `tests/dashboard/test_world_api.py` (+263 lines)
kimi closed this issue 2026-03-21 14:52:32 +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 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#678
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?