منصوبے کے بارے میں

Atrium تین تہوں والے memory system کی دوسری تہہ ہے، جو canonical conversation archive پر derived، disposable retrieval فراہم کرتا ہے۔ یہ source data کا مالک نہیں ہے؛ اس کے بجائے، یہ ایک index بناتا ہے جسے canonical archive اور curated notes سے دوبارہ بنایا جا سکتا ہے۔ ڈیزائن پر زور دیتا ہے کہ index disposable ہے اور مشینوں archive کو sync کرتی ہیں، index کو نہیں، بغیر copy کیے convergence کو یقینی بناتے ہوئے۔ اہم خصوصیات میں شامل ہیں: - **Ingestion**: Conversation archives (JSONL) اور curated notes trees کو index کرنا۔ - **Search**: Adaptive search جو lexical (whole-word اور substring) اور dense (semantic) lanes کو ملاتی ہے، ہر lane کو الگ سے استعمال کرنے کے options کے ساتھ۔ Dense lane صرف curated notes اور session synthesis کو embed کرتا ہے، raw corpus کو نہیں۔ - **Session recording**: ایک Claude Code Stop hook (`stop-record-episode.sh`) جو agent کو thresholds پورے ہونے پر session episode ریکارڈ کرنے کا اشارہ دیتا ہے، `atrium record-session` کا استعمال کرتے ہوئے record کو validate، redact، اور store کرنے کے لیے۔ - **Context retrieval**: ایک `UserPromptSubmit` hook (`user-prompt-context.sh`) جو prompts میں متعلقہ evidence شامل کرتا ہے۔ `atrium context` command (MCP کے ذریعے بھی دستیاب) structured evidence واپس کرتا ہے، project اور curated notes تک محدود، bounded budgets اور safety checks کے ساتھ۔ - **State management**: State ایک مخصوص directory میں محفوظ ہوتا ہے جو environment variables یا config سے resolve ہوتا ہے، derived data کو الگ رکھتے ہوئے اور کبھی sync نہیں کرتا۔ - **Development**: Tests اور linting `uv` اور `pytest`/`ruff` کے ذریعے۔ README میں usage examples، hooks کی configuration، اور protocol acceptance test کی تفصیلات شامل ہیں۔ یہ search lanes کو الگ رکھنے کی rationale اور `AGENTS.md` میں دستاویزی decisions کو دوبارہ measure کرنے کی اہمیت بھی بیان کرتا ہے۔