Claude
9b18e2710d
- /docs/ now contains 12 numbered guides + index.md (navigator).
- Old duplicates removed: nexa-core/doc/, DEPLOYMENT.md, PLAN.md,
config/{classification_logic,workflows_spec}.md.
- 09-deployment.md targets the running infra (LXC 104 docker host,
Zoraxy at 192.168.1.4, existing Memos/n8n/LiteLLM/Nextcloud/Qdrant)
rather than spinning a parallel stack; minimal-config approach.
- 11-open-questions.md tracks user-info-required blockers.
- 12-optimization-opportunities.md captures homelab tweaks.
- CLAUDE.md added so future agent runs know repo conventions and infra.
2.2 KiB
2.2 KiB
02 — Roadmap & Phases
Iterative build-out, value-first. Each phase is shippable on its own.
Phase 1 — The Spine (connectivity)
Focus: datapath between Memos, n8n and SAIA. Milestone: Nexa replies on Memos and answers simple questions.
- 1.1 Memos ↔ n8n bridge — webhook ingress, content filter, comment-back.
- 1.2 SAIA integration — call LiteLLM proxy from n8n; chat via Memos comments.
- 1.3 Git-sync — periodic export of n8n workflows into this repo.
Phase 2 — Senses (input channels)
Focus: e-mail filter and the Work-vs-Personal router. Milestone: Nexa distinguishes work tasks from personal tasks without manual tags.
- 2.1 Email butler — filter & summarize the ~20 daily personal mails.
- 2.2 RSS morning digest — curated daily summary in Memos.
- 2.3 Bluesky antenna — store liked posts as knowledge snippets.
Phase 3 — Memory (Qdrant & RAG)
Focus: Qdrant + (optional) graph DB for retrieval-augmented answers. Milestone: RAG works — Nexa answers from archived notes.
- 3.1 Embedding pipeline — automatic vectorization of Memos & Obsidian.
- 3.2 Context retrieval —
#nexa:askreads Qdrant before answering. - 3.3 S3 long-term archive — Qdrant snapshots to the S3 server.
- 3.4 Graph layer (deferred decision — see 11-open-questions) — Neo4j or Ontotext GraphDB for structural queries.
Phase 4 — Motor (organization & action)
Focus: calendar integration and time-boxing. Milestone: Nexa proactively proposes morning focus slots in the work calendar.
- 4.1 Nextcloud Tasks sync — bidirectional status sync (Memos ↔ NC Tasks).
- 4.2 Time-boxing agent — calendar-aware slot suggestions.
- 4.3 Karakeep curation — automated review cycle for saved links.
Phase 5 — Daily integration (polish)
Focus: Home Assistant Voice and monitoring. Milestone: Nexa speaks via HA-Voice and surfaces critical system states proactively.
- 5.1 HA Voice — Wake-word integration, Wyoming protocol.
- 5.2 System monitoring — Proxmox / Backrest alerts into the Memos system feed via ntfy.