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.
49 lines
2.2 KiB
Markdown
49 lines
2.2 KiB
Markdown
# 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:ask` reads 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](./11-open-questions.md))** — 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.
|