Ingest System
📦 Ingest System
Clara's automated routing — from Smart Todo to the right "home" in the Hub
🎯 Purpose
Ingest bridges the gap between organized content (Smart Todo items classified as todo/info/thought) and their permanent homes (D1 tasks, KB, projects). Clara reads, matches, and routes.
Scope: Ingest handles short-form already-structured items. For long-form, use /distill instead.
🔄 Ingest Flow
📋 "Has a Home?" Matching
Clara loads context from multiple sources to determine if an item has a pre-existing home:
Context Source | Match Signal | Example |
|---|---|---|
| Name match | "MIBOS" → ongoing.md has MIBOS entry |
D1 tasks (active/in-progress) | Task name match | "e-invoice bug" → task A108 |
KB index | Topic match | "Sunmi SDK" → kb/dev/sunmi.md |
Nexus nodes (future) | Area match | "hiring" → Work > Team |
📊 Routing Rules
Type | Has Home? | Route To |
|---|---|---|
🔵 Todo | ✅ Yes | D1 task comment or ongoing update |
🔵 Todo | ❌ No | Stay in Smart Todo |
🟡 Info | ✅ Yes | Task context, KB entry, or project comment |
🟡 Info | ❌ No | Stay in Smart Todo |
🟢 Thought | Any | Always stays in Smart Todo |
Key rule: Thoughts never get auto-routed. They stay as "unforced" creative space. Actions only route when there's a clear match.
⚡ Priority Escalation
If Clara detects urgency signals ("urgent", "ASAP", "by Monday"):
Item marked [promoted] in Smart Todo, then cleaned up on next ingest pass.
🚫 Ingest Does NOT
Action | Who Does It Instead |
|---|---|
Create new tasks | Clara sweep (via feedback API) |
Add new entries to ongoing.md | Manual or /ongoing workflow |
Delete items | Only routes — never destructive |
Rush thoughts into action | Thoughts are sacred — they stay |
🏗️ Technical Design
Aspect | Decision | Status |
|---|---|---|
Execution model | Bifrost remote job (periodic cron) | DESIGNED |
Smart Todo read API | Cross-project API bridge needed | OPEN |
Cadence | TBD — daily? on-demand? both? | OPEN |
Project list sync | Clara writes to Smart Todo settings API | DESIGNED |
🔗 Design Source
Full design documented in A133-smart-todo-hub-integration/insights.md (Step 3: Ingest section).