~5 minutes · Low risk · Your VAULT data is untouched
Let your AI handle the upgrade
Download this file, give it to your AI (Claude, GPT, DeepSeek…) and it will migrate you to v2.0 automatically. Your data stays safe.
Download UPDATE-V1-TO-V2.md ↓Or follow the manual steps below.
Six defense-in-depth improvements that turn DARA from "good if you actively maintain it" to "self-correcting if you ignore it for weeks."
1. Librarian self-trigger. Every read of BRAIN.md now shows the Librarian status in the header. Alert threshold tightened from 7 days to 3. The post-compile status report (W6) must include Librarian status and prompt you if overdue.
2. Missing-summary auto-push. When compile detects neurons >1500 chars without a →brain: summary, it auto-writes a feedback file to INBOX. The header shows a to-do count. W6 also reports and prompts.
3. Session-closing summaries capped. W9 closing recaps must be ≤500 words per neuron. Longer recaps go to a dedicated session neuron. Compile emits a WARNING when any single neuron grows ≥50% in one pass.
4. Sandbox/FUSE stale-view caveat. W12 now includes: when working in sandboxed environments, files can appear truncated due to stale caches. Cross-verify before any restore.
5. W3(b) integrity check. New compile step tracks sizes of 5 protected files. Any size drop ≥50 bytes without justification fires a CRITICAL alert with a rollback pointer.
6. Cowork environment detection. compile.py detects Cowork/sandboxed runs and skips the git auto-commit step cleanly instead of erroring.
7. Anti-tampering. If .librarian-last-run says "today" but no [Librarian] entry exists in today's changelog, compile flags it as suspicious.
8. Librarian MISSION section. The Librarian protocol now opens with an explicit mission: format checking is necessary but not sufficient.
9. Arrow auto-fix extended. validators.py now auto-converts ->brain: and ->detail: to Unicode arrows.
Your data. None of your VAULT content is touched. The upgrade only replaces 5 system files:
DARA.md (the constitution)SYSTEM/compile.py + SYSTEM/validators.pyVAULT/ENABLERS/agent-librarian.mdSYSTEM/config.json (version bump only)Your NEURONS, changelog, BRAIN.md, BACKUP, and all other ENABLERS are preserved as-is.
Open PowerShell (Windows) or Terminal (Mac/Linux):
Mac/Linux: cp -r ~/Desktop/DARA ~/Desktop/DARA_v1_backup_$(date +%Y-%m-%d)
Download EIDARA v2.0 from GitHub.
From the v2.0 package, copy these into your existing DARA folder, overwriting the v1 versions:
DARA.mdSYSTEM/compile.pySYSTEM/validators.pySYSTEM/config.jsonVAULT/ENABLERS/agent-librarian.mdRun python SYSTEM/compile.py once. You should see:
BRAIN.md compiled! at the endCompiler version: 3.2 in the COMPILATION STATSLibrarian: lineOpen LIBRARY/BRAIN.md and check the header has the new Librarian line. You're on v2.0.
Librarian: never run in the header is expected on first compile. If you've been running the Librarian, update VAULT/.librarian-last-run with today's date and add a [Librarian] entry to today's changelog.
.w3b_sizes.json is created automatically, capturing baseline sizes of the 5 protected files.
ASCII arrow auto-fix: if you had ->brain: instead of the Unicode arrow, the validator will fix it on the next compile.
Missing-summary push: if you have neurons >1500 chars without a summary, the next compile will show them in the header and auto-write a feedback file to INBOX.
The compile noticed .librarian-last-run is set to today but there's no [Librarian] entry in today's changelog. Either add one or investigate what touched the file.
One of the 5 protected files dropped in size unexpectedly. Most likely an Edit-tool truncation. Roll back from VAULT/BACKUP/SYSTEM/.
Replace the 5 upgraded files with their v1 versions from your backup. Delete SYSTEM/.w3b_sizes.json. Recompile.
No. The reading interface (BRAIN.md, INDEX, summaries) is backward-compatible. New lines are additive.