chore(config): update gitignore and finalize orchestration logic

- Excluded local SQLite binary data from version control.
- Staged core Phase 1 files: active_intents.yaml and tmd.py.
- Maintaining L5 Physical Layer integrity without repo bloat.

.gitignore

@@ -23,7 +23,7 @@ AGENTS.local.md
 # Test environment
 .test_env
 .vscode-test/
-
+.venv/
 # Docs
 docs/_site/
 
@@ -59,3 +59,11 @@ roo-cli-*.tar.gz*
 
 # VS Code MCP analytics file — do not commit
 .vscode/mcp.json
+
+# --- Orchestration Sidecar (Phase 1) ---
+# We commit the .yaml spec and .py hooks, but NEVER the local data
+.orchestration/*.db
+.orchestration/*.db-journal
+.orchestration/*.db-wal
+.orchestration/zvec_store/
+.orchestration/agent_trace.jsonl

.orchestration/hooks/init_zvec.py

@@ -0,0 +1,34 @@
+import sqlite3
+import os
+
+# Logic: Define the path for our Sidecar DB
+db_path = os.path.join(".orchestration", "trace_storage.db")
+
+def init_db():
+    try:
+        conn = sqlite3.connect(db_path)
+        cursor = conn.cursor()
+        
+        # Logic: Create the table for your Agent Traces (Phase 1 Data Model)
+        cursor.execute('''
+            CREATE TABLE IF NOT EXISTS agent_traces (
+                id TEXT PRIMARY KEY,
+                timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+                intent_id TEXT,
+                file_path TEXT,
+                content_hash TEXT,
+                metadata TEXT
+            )
+        ''')
+        
+        # Logic: Optimization for low RAM - use Disk as Virtual RAM
+        cursor.execute("PRAGMA mmap_size = 268435456;") # 256MB mmap
+        
+        conn.commit()
+        conn.close()
+        print(f"✅ Orchestration Ledger Initialized at {db_path}")
+    except Exception as e:
+        print(f"❌ Error: {e}")
+
+if __name__ == "__main__":
+    init_db()