🕌 CPS Platform Knowledge Hub
spiritualmessage.org — Internal Documentation & Status
v0.13.0 — Video Pipeline Overhaul
● Live
"A seeker anywhere in the world types a question — and receives an answer grounded in Maulana's actual words, with citation."
— The North Star · VISION.md
⚡
Running Services
RagFlow
port 9380 · chat.spiritualmessage.org · cpsglobal.org
PRODUCTION — don't touch
Annotation Tool v2
port 5000 · annotate.spiritualmessage.org
ACTIVE
LightRAG Annotations
port 9622 · single knowledge graph source
ACTIVE
LiveKit Voice Agent
port 7880 · livekit.spiritualmessage.org
ACTIVE
🎯
What's Next
v0.13.0 exit criteria
1
Test 3 videos end-to-end
Done when: 1 English + 1 Urdu + 1 mixed pass /process_video · English enrichment verified in output
2
Verify chat — ask "patience"
Done when: book + video sources both appear in response
3
Enable cron
Only after 3 successful video tests pass
4
Continue book pipeline
Process remaining books via /process
📋
Project Context
/root/critique/
🌟
VISION.md
Mission, north star, guiding principles
📍
CURRENT.md
v0.13.0 status, what's done, what's next
⚖️
DECISIONS.md
7 architectural decisions with reasoning
🔥
LEARNINGS.md
8 hard-won lessons — never repeat these
🔄
SESSION_CONTEXT.md
AI session handover — read first
🤝
HANDOVER.md
Server access for backup people
🏛️
Architecture Decision Records
NASA / Google / AWS standard · /docs/decisions/
001
SQLite over PostgreSQL
Zero config, nightly backup, sufficient for scale
002
Claude Code as Pipeline LLM
Zero API cost for /process and /process_video
003
LightRAG insert_custom_kg()
We control chunking + entity extraction quality
004
512–800 Token Keyword Grouping
Respects chapter boundaries, semantically coherent
005
OpenRouter + DeepSeek Fallback
Cost resilience when primary model unavailable
006
Docker COPY not Bind Mounts
Reproducible builds, no host path dependency
📚
Technical Documentation
/root/annotation_tool_v2/docs/
🗺️
GUIDE.md
Developer manual — start here
🏗️
ARCHITECTURE.md
System diagram + data flow
🎬
VIDEO_PIPELINE.md
Pipeline steps, states, recovery
⚔️
WAR_STORIES.md
NASA-style post-incident log
NASA style
🤖
MODEL_SELECTION.md
Per-step model routing guide
🗄️
DATABASE.md
Schema, migrations, backups
⚙️
PROCESS_COMMAND.md
/process command internals
🔌
API_REFERENCE.md
All endpoints documented
📝
CHANGELOG.md
Version history + rollback cmds
🖥️
Infrastructure
🌍
Hetzner Cloud
Helsinki · 32GB RAM · 300GB disk · ~$20/mo
💾
Backup
Nightly → Storage Box BX11 · Weekly snapshots
🔒
SSL
Certbot · All subdomains · Auto-renew