Updating the documentation for things. Hopefully improvements to Gemini CLI.

documentation/AGENT_TODO.md

@@ -0,0 +1,19 @@
+# Backend Agent Task List
+> Use this file to track steps for complex features or bug fixes.
+> **Status:** 🔵 Active - ID Vision Phase 2 complete.
+
+## 📋 Active Task: ID Vision Audit & Compliance
+- [ ] **Step 1:** Audit remaining MariaDB models for ID Vision compliance.
+- [ ] **Step 2:** Harden `root_validator(pre=True)` on remaining models to prevent integer leakage.
+- [ ] **Step 3:** Refactor `api_crud_v2.py` and `person_methods.py` (Reduce file size < 800 lines).
+- [ ] **Step 4:** Coordination (Handshake with Frontend regarding "Badge Rendering" corrupted IDs).
+- [ ] **Step 5:** Finalize & Commit.
+
+## 🚧 Upcoming Strategic Goals
+- **Zoom Events Integration:** Implement cron synchronization for OAuth2 ticket retrieval.
+- **Aether V4 Architecture:** Migration to V4 core standards (Lifecycle fields).
+
+## 📝 Session Notes (Feb 11, 2026)
+- **Resolved:** Finalized 'Heal-on-Read' fallback resolution for relational IDs.
+- **Verification:** `test_e2e_v3_demo_parity.py` verified at 100% pass rate.
+- **Optimization:** Refactored `api_crud.py` and `hosted_file.py` to Registry pattern.

documentation/GUIDE__DEVELOPMENT.md

@@ -0,0 +1,35 @@
+# Aether Development SOP (Backend)
+> **Version:** 1.0 (2026-02-11)
+> **Location:** documentation/GUIDE__DEVELOPMENT.md
+
+## 1. 🛡️ Verification (The "Test-First" Mandate)
+**Rule:** No code is to be committed unless it has passed local verification. Skipping this is a violation of the Aether Dev Protocol.
+
+### Required Checks:
+1. **Syntax Validation:** `python3 -m py_compile <file_path>`
+2. **Linting/Style:** `flake8 <file_path>`
+3. **Pydantic Validation:** If changing models, verify with `app/models/` scripts.
+4. **Service Health:** Restart the service and check logs:
+   - `docker restart aether_container_env-ae_api-2`
+   - `tail -n 50 ../aether_container_env/logs/ae_api/aether_api.log`
+
+## 2. 📝 Commit & Sync Policy
+- **Atomic Commits:** One feature or one bug fix per commit. Do not batch unrelated changes.
+- **Verification Log:** Mention the verification steps taken in your work log (`ae_log_work`).
+- **Safety:** Use `~/tmp/gemini_trash` for removals; never use `rm` directly on source files.
+
+## 3. 🤝 The Handshake (Coordination)
+You are not working in a vacuum. You MUST coordinate with the Frontend Agent.
+
+### Mandatory Messaging Triggers:
+- **API Changes:** When changing an endpoint signature, payload, or ID format.
+- **Bugs:** When discovering a cross-stack issue.
+- **Status:** Update your shared Journal in `~/agents_sync/aether/journals/` after significant milestones.
+
+**Tool:** Use the `message` tool to communicate with the Frontend Agent.
+
+## 🧠 Continuity
+Before starting work:
+1. Read `~/agents_sync/README.md` to understand the fleet status and cross-agent tasks.
+2. Check `README.md` in the project root for technical specs.
+3. Review your local `documentation/AGENT_TODO.md` for active tasks.