Hein
1d4dbad33f
Some checks failed
CI / build-and-test (push) Failing after -30m34s
- Moved to future plugin as part of project scope adjustment - Updated tool registration and descriptions accordingly
173 lines
6.5 KiB
Markdown
173 lines
6.5 KiB
Markdown
# AMCS TODO
|
|
|
|
## Future Plugin: Lifestyle Tools (calendar, meals, household, CRM)
|
|
|
|
The following tool groups have been removed from the core server and are candidates for a separate optional plugin or extension server. The store/tool implementations remain in the codebase but are no longer registered.
|
|
|
|
### calendar
|
|
- `add_family_member` — Add a family member to the household.
|
|
- `list_family_members` — List all family members.
|
|
- `add_activity` — Schedule a one-time or recurring family activity.
|
|
- `get_week_schedule` — Get all activities scheduled for a given week.
|
|
- `search_activities` — Search activities by title, type, or family member.
|
|
- `add_important_date` — Track a birthday, anniversary, deadline, or other important date.
|
|
- `get_upcoming_dates` — Get important dates coming up in the next N days.
|
|
|
|
### meals
|
|
- `add_recipe` — Save a recipe with ingredients and instructions.
|
|
- `search_recipes` — Search recipes by name, cuisine, tags, or ingredient.
|
|
- `update_recipe` — Update an existing recipe.
|
|
- `create_meal_plan` — Set the weekly meal plan; replaces existing.
|
|
- `get_meal_plan` — Get the meal plan for a given week.
|
|
- `generate_shopping_list` — Generate shopping list from the weekly meal plan.
|
|
|
|
### household
|
|
- `add_household_item` — Store a household fact (paint, appliance, measurement, etc.).
|
|
- `search_household_items` — Search household items by name, category, or location.
|
|
- `get_household_item` — Retrieve a household item by id.
|
|
- `add_vendor` — Add a service provider (plumber, electrician, landscaper, etc.).
|
|
- `list_vendors` — List household service vendors, optionally filtered by service type.
|
|
|
|
### crm
|
|
- `add_professional_contact` — Add a professional contact to the CRM.
|
|
- `search_contacts` — Search professional contacts by name, company, title, notes, or tags.
|
|
- `log_interaction` — Log an interaction with a professional contact.
|
|
- `get_contact_history` — Get full history (interactions and opportunities) for a contact.
|
|
- `create_opportunity` — Create a deal, project, or opportunity linked to a contact.
|
|
- `get_follow_ups_due` — List contacts with a follow-up date due within the next N days.
|
|
- `link_thought_to_contact` — Append a stored thought to a contact's notes.
|
|
|
|
**Implementation notes:**
|
|
- Store implementations: `internal/tools/calendar.go`, `internal/tools/meals.go`, `internal/tools/household.go`, `internal/tools/crm.go`
|
|
- DB store layers: `internal/store/calendar.go`, `internal/store/meals.go`, `internal/store/household.go`, `internal/store/crm.go`
|
|
- Re-register via `mcpserver.ToolSet` fields: `Household`, `Calendar`, `Meals`, `CRM`
|
|
- Re-add `registerHouseholdTools`, `registerCalendarTools`, `registerMealTools`, `registerCRMTools` to the register slice in `NewHandlers`
|
|
- Add catalog entries back in `BuildToolCatalog`
|
|
|
|
---
|
|
## Embedding Backfill and Text-Search Fallback Audit
|
|
|
|
This file originally described the planned `backfill_embeddings` work and semantic-to-text fallback behavior. Most of that work is now implemented. This document now tracks what landed, what still needs verification, and what follow-up work remains.
|
|
|
|
For current operator-facing behavior, prefer `README.md`.
|
|
|
|
---
|
|
|
|
## Status summary
|
|
|
|
### Implemented
|
|
|
|
The main work described in this file is already present in the repo:
|
|
|
|
- `backfill_embeddings` MCP tool exists
|
|
- missing-embedding selection helpers exist in the store layer
|
|
- embedding upsert helpers exist in the store layer
|
|
- semantic retrieval falls back to Postgres full-text search when the active model has no embeddings in scope
|
|
- fallback behavior is wired into the main query-driven tools
|
|
- a full-text index migration exists
|
|
- optional automatic backfill runner exists in config/startup flow
|
|
- retry and reparse maintenance tooling also exists around metadata quality
|
|
|
|
### Still worth checking or improving
|
|
|
|
The broad feature is done, but some implementation-depth items are still worth tracking:
|
|
|
|
- test coverage around fallback/backfill behavior
|
|
- whether configured backfill batching is used consistently end-to-end
|
|
- observability depth beyond logs
|
|
- response visibility into which retrieval mode was used
|
|
|
|
---
|
|
|
|
## What is already implemented
|
|
|
|
### Backfill tool
|
|
|
|
Implemented:
|
|
|
|
- `backfill_embeddings`
|
|
- project scoping
|
|
- archived-thought filtering
|
|
- age filtering
|
|
- dry-run mode
|
|
- bounded concurrency
|
|
- best-effort per-item failure handling
|
|
- idempotent embedding upsert behavior
|
|
|
|
### Search fallback
|
|
|
|
Implemented:
|
|
|
|
- full-text fallback when no embeddings exist for the active model in scope
|
|
- fallback helper shared by query-based tools
|
|
- full-text index migration on thought content
|
|
|
|
### Tools using fallback
|
|
|
|
Implemented fallback coverage for:
|
|
|
|
- `search_thoughts`
|
|
- `recall_context`
|
|
- `get_project_context` when a query is provided
|
|
- `summarize_thoughts` when a query is provided
|
|
- semantic neighbors in `related_thoughts`
|
|
|
|
### Optional automatic behavior
|
|
|
|
Implemented:
|
|
|
|
- config-gated startup backfill pass
|
|
- config-gated periodic backfill loop
|
|
|
|
---
|
|
|
|
## Remaining follow-ups
|
|
|
|
### 1. Expose retrieval mode in responses
|
|
|
|
Still outstanding.
|
|
|
|
Why it matters:
|
|
- callers currently benefit from fallback automatically
|
|
- but debugging is easier if responses explicitly say whether retrieval was `semantic` or `text`
|
|
|
|
Suggested shape:
|
|
- add a machine-readable field such as `retrieval_mode: semantic|text`
|
|
- keep it consistent across all query-based tools that use shared retrieval logic
|
|
|
|
### 2. Verify and improve tests
|
|
|
|
Still worth auditing.
|
|
|
|
Recommended checks:
|
|
- no-embedding scope falls back to text search
|
|
- project-scoped fallback only searches within project scope
|
|
- archived thoughts remain excluded by default
|
|
- `related_thoughts` falls back correctly when semantic vectors are unavailable
|
|
- backfill creates embeddings that later restore semantic search
|
|
|
|
### 3. Re-embedding / migration ergonomics
|
|
|
|
Still optional future work.
|
|
|
|
Potential additions:
|
|
- count missing embeddings by project
|
|
- add `missing_embeddings` stats to `thought_stats`
|
|
- add a controlled re-embed or reindex flow for model migrations
|
|
|
|
---
|
|
|
|
## Notes for maintainers
|
|
|
|
Do not read this file as an untouched future roadmap item anymore. The repo has already implemented the core work described here.
|
|
|
|
If more backfill/fallback work is planned, append it as concrete follow-ups against the current codebase rather than preserving the old speculative rollout order.
|
|
|
|
---
|
|
|
|
## Historical note
|
|
|
|
The original long-form proposal was replaced during the repo audit because it described work that is now largely complete and was causing issue/document drift.
|
|
|
|
If needed, recover the older version from git history.
|