total-recall-brain 3.1.0

package/templates/com.totalrecall.daemon.plist

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.totalrecall.daemon</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>__NODE__</string>
+    <string>src/core/dream.mjs</string>
+  </array>
+
+  <key>WorkingDirectory</key>
+  <string>__ROOT__</string>
+
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>NODE_ENV</key>
+    <string>production</string>
+    <key>HOME</key>
+    <string>__HOME__</string>
+  </dict>
+
+  <key>KeepAlive</key>
+  <true/>
+
+  <key>ThrottleInterval</key>
+  <integer>10</integer>
+
+  <key>StandardOutPath</key>
+  <string>__HOME__/.agent/logs/daemon.log</string>
+
+  <key>StandardErrorPath</key>
+  <string>__HOME__/.agent/logs/daemon.log</string>
+
+  <key>RunAtLoad</key>
+  <true/>
+</dict>
+</plist>

package/templates/com.totalrecall.duckdns.plist

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.totalrecall.duckdns</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/bin/curl</string>
+    <string>-s</string>
+    <string>https://www.duckdns.org/update?domains=__SUBDOMAIN__&amp;token=__TOKEN__&amp;ip=</string>
+    <string>-o</string>
+    <string>__HOME__/.agent/logs/duckdns.log</string>
+  </array>
+
+  <key>StartInterval</key>
+  <integer>300</integer>
+
+  <key>RunAtLoad</key>
+  <true/>
+</dict>
+</plist>

package/templates/com.totalrecall.server.plist

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.totalrecall.server</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>__NODE__</string>
+    <string>src/server/index.mjs</string>
+  </array>
+
+  <key>WorkingDirectory</key>
+  <string>__ROOT__</string>
+
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>NODE_ENV</key>
+    <string>production</string>
+    <key>PORT</key>
+    <string>3000</string>
+    <key>HOST</key>
+    <string>127.0.0.1</string>
+    <key>AGENT_DIR</key>
+    <string>__HOME__/.agent</string>
+    <key>HOME</key>
+    <string>__HOME__</string>
+  </dict>
+
+  <key>KeepAlive</key>
+  <true/>
+
+  <key>ThrottleInterval</key>
+  <integer>5</integer>
+
+  <key>StandardOutPath</key>
+  <string>__HOME__/.agent/logs/server.log</string>
+
+  <key>StandardErrorPath</key>
+  <string>__HOME__/.agent/logs/server.log</string>
+
+  <key>RunAtLoad</key>
+  <true/>
+</dict>
+</plist>

package/templates/default-config/budget.yml

@@ -0,0 +1,6 @@
+# Sovereign budget limits configuration for daily and weekly spend.
+# Copy to ~/.agent/config/budget.yml or config/budget.yml and customize.
+budget:
+  daily_cap_usd: 5.00
+  weekly_cap_usd: 25.00
+  enabled: true

package/templates/default-config/runtime.yml

@@ -0,0 +1,11 @@
+# Total Recall Runtime Configuration
+#
+# CLI agent dispatch and embedding config lives in the meta-skill:
+#   .agent/skills/total-recall/skills/cli-agents/agents.yml
+#
+# This file is kept for backward compatibility with the deploy system.
+# The daemon reads agents.yml directly for all AI dispatch settings.
+#
+# Non-AI runtime settings (if any) can go here.
+
+# Placeholder — agents.yml is the source of truth for all AI dispatch.

package/templates/default-config/security.yml

@@ -0,0 +1,53 @@
+# Total Recall Security Configuration
+# Copy to ~/.agent/config/security.yml and customize
+
+# Privacy controls
+privacy:
+  # Nodes with privacy: local_only are NEVER sent to frontier API
+  enforce_local_only: true
+
+  # Default export policy for frontier API calls
+  # Options: always | ask_per_skill | never
+  allow_frontier_export: ask_per_skill
+
+# YOLO Mode (fully autonomous operation)
+yolo_mode: false
+
+# Dashboard authentication
+dashboard:
+  # Set a bcrypt-hashed password (generate with: npx total-recall hash-password)
+  password_hash: null
+
+  # Session TTL in hours
+  session_ttl_hours: 24
+
+# API authentication
+api:
+  # Personal Access Tokens are stored as hashes in ~/.agent/config/keys.jsonl.
+  # Generate one with: npx total-recall generate-pat --name "codex"
+  #
+  # Static PATs in this YAML file are disabled by default because they are
+  # plaintext secrets. Use keys.jsonl unless you are doing a temporary migration.
+  allow_static_pats: false
+  pats: []
+
+# Rate limiting
+rate_limits:
+  api_requests_per_minute: 60
+
+# Network binding
+bind:
+  # Express should stay private behind Caddy/Cloudflare. Do not expose :3000.
+  host: "127.0.0.1"
+  port: 3000
+  allow_public_bind: false
+
+network:
+  # Production requests must arrive through HTTPS at Caddy/Cloudflare.
+  require_https: true
+
+  # Keep public health checks closed; localhost and authenticated requests work.
+  public_health: false
+
+  # Browser cross-origin callers. Same-origin dashboard traffic does not need CORS.
+  allowed_origins: []

package/templates/default-config/voice.yml

@@ -0,0 +1,34 @@
+# Total Recall — Voice Configuration
+#
+# Wires the Sovereign OS to local speech engines. Both TTS (Kokoro-82M) and
+# STT (whisper.cpp) are optional — the system functions without either, but
+# the dashboard's voice mode and the iOS/Android shortcut voice-memory bank
+# both depend on these being configured.
+#
+# To enable Kokoro:
+#   1. Install kokoro-fastapi (or any OpenAI-compatible Kokoro server).
+#   2. Run it on the host as a systemd service bound to 127.0.0.1:8880.
+#   3. Change `engine: disabled` to `engine: kokoro` below.
+#   4. systemctl restart total-recall-server
+
+tts:
+  # "kokoro" → POST to the endpoint below using the OpenAI /v1/audio/speech contract.
+  # "disabled" → /api/tts returns 503 and the dashboard falls back to browser speechSynthesis.
+  engine: disabled
+  endpoint: http://127.0.0.1:8880/v1/audio/speech
+  voice: af_heart
+  format: wav        # wav | mp3 | flac | opus | pcm
+  speed: 1.0
+
+stt:
+  # "whisper" → call out to a local whisper.cpp binary for /api/voice/memorize.
+  # "disabled" → voice memory bank disabled; mobile shortcuts will receive 503.
+  engine: disabled
+  model_path: ~/.agent/models/whisper/ggml-tiny.en.bin
+  binary: whisper-cli   # must be on $PATH or absolute
+
+capture:
+  archive_audio: true             # keep raw audio in ~/.agent/files/voice/
+  max_duration_seconds: 120
+  auto_categorize: true           # let Gemma decide the SSSS category
+  respond_with_voice: false       # if true, dashboard plays a TTS reply automatically

package/templates/obsidian-queries/conflicts.md

@@ -0,0 +1,26 @@
+---
+type: query
+title: "Total Recall — Conflicts"
+tags: [query, conflicts]
+---
+
+# Pending Conflicts
+
+Nodes that contradicted existing knowledge and were quarantined for review.
+
+```dataview
+TABLE conflict_id, new_slug, existing_slug, reason, detected_at
+FROM "Total Recall"
+WHERE type = "conflict" AND status = "pending"
+SORT detected_at DESC
+```
+
+## Resolved
+
+```dataview
+TABLE conflict_id, resolution, resolved_at
+FROM "Total Recall"
+WHERE type = "conflict" AND status = "resolved"
+SORT resolved_at DESC
+LIMIT 10
+```

package/templates/obsidian-queries/daily.md

@@ -0,0 +1,17 @@
+---
+type: query
+title: "Total Recall — Daily Notes"
+tags: [query, daily]
+---
+
+# Daily Notes
+
+Dream cycle summaries — one file per day in `daily/`.
+
+```dataview
+TABLE title, updated
+FROM "Total Recall/daily"
+WHERE type = "memory"
+SORT updated DESC
+LIMIT 30
+```

package/templates/obsidian-queries/index.md

@@ -0,0 +1,38 @@
+---
+type: query
+title: "Total Recall — Dashboard"
+tags: [query, dashboard]
+---
+
+# Total Recall Dashboard
+
+> Auto-generated by `total-recall connect obsidian`. Powered by [Dataview](https://blacksmithgu.github.io/obsidian-dataview/).
+
+## Active Memory Nodes
+
+```dataview
+TABLE title, category, confidence, importance, updated
+FROM "Total Recall"
+WHERE type = "memory" AND status = "active"
+SORT importance DESC, updated DESC
+LIMIT 20
+```
+
+## Recent Activity (Last 7 Days)
+
+```dataview
+TABLE title, category, updated
+FROM "Total Recall"
+WHERE type = "memory" AND date(updated) >= date(today) - dur(7 days)
+SORT updated DESC
+```
+
+## Node Health
+
+```dataview
+TABLE length(rows) AS count, rows.category AS category
+FROM "Total Recall"
+WHERE type = "memory"
+GROUP BY category
+SORT count DESC
+```

package/templates/obsidian-queries/skills.md

@@ -0,0 +1,14 @@
+---
+type: query
+title: "Total Recall — Skills"
+tags: [query, skills]
+---
+
+# Skills
+
+```dataview
+TABLE title, file.path AS path, tags
+FROM "Total Recall/skills"
+WHERE type = "skill" OR contains(tags, "skill")
+SORT title ASC
+```

package/templates/onboarding-interview.md

@@ -0,0 +1,72 @@
+---
+type: task
+slug: onboarding-interview
+category: onboarding
+title: "Conduct user onboarding interview"
+status: pending
+priority: 1
+created: {{CREATED_AT}}
+updated: {{CREATED_AT}}
+---
+
+## Objective
+
+Conduct a warm, conversational onboarding interview with the user to deeply understand who they are, what they care about, and how you can best serve them. This is the most important task in the queue.
+
+## Instructions for the Agent
+
+When the user starts their next chat session, you MUST conduct this interview BEFORE doing any other work. Do NOT dump all the questions at once. Ask them one at a time, naturally, like a thoughtful conversation. Acknowledge and reflect on each answer before asking the next question.
+
+Once the user has answered all questions (or says they want to skip any), write their answers into the vault immediately using your file tools.
+
+## Interview Questions (ask one at a time, conversationally)
+
+1. **Who are you?** — "To get started, can you tell me a bit about yourself? What do you do for work or what are you most focused on in life right now?"
+
+2. **What are you working on?** — "What are the main projects or goals you're working toward? These could be professional, personal, creative — anything you want me to help you with."
+
+3. **What do you want to remember?** — "What kinds of things are most important for me to keep track of for you? (Ideas, research, decisions, people, tasks, reading, etc.)"
+
+4. **What topics excite you?** — "What subjects, fields, or areas of knowledge do you find yourself coming back to? What should I research and follow for you automatically?"
+
+5. **How do you like to communicate?** — "Do you prefer direct, brief answers or detailed explanations? Do you want me to push back on ideas or mostly support your thinking?"
+
+6. **What frustrates you?** — "Is there anything that drives you crazy — things you keep forgetting, information that's hard to find, tasks that slip through the cracks?"
+
+7. **What would success look like?** — "Six months from now, if I've done my job perfectly, what would be different for you?"
+
+8. **Telegram Notifications** — "Would you like me to message you on Telegram when I finish background tasks or find something interesting during my idle time? If yes, you'll need to create a bot on Telegram via BotFather and give me the Bot Token and your Chat ID."
+
+## After the Interview
+
+Write the following files using your terminal tools:
+
+**`.agent/config/notifications.yml`** — If they provided Telegram details, write them exactly like this:
+```yaml
+telegram_bot_token: "their-token-here"
+telegram_chat_id: "their-chat-id-here"
+```
+
+**`.agent/memory-vault/preferences/user-profile.md`** — Full SSSS memory node with the user's identity, role, and communication style.
+
+**`.agent/memory-vault/preferences/user-priorities.md`** — SSSS memory node listing the user's top goals, active projects, and what they want from Total Recall.
+
+**`.agent/memory-vault/preferences/user-interests.md`** — SSSS memory node listing topics to research autonomously.
+
+Use this frontmatter template for each file:
+```yaml
+---
+type: memory
+slug: user-profile
+category: preferences
+title: "User Profile"
+status: active
+confidence: 1.0
+importance: 5
+created: <ISO timestamp>
+updated: <ISO timestamp>
+tags: [user, profile, onboarding]
+---
+```
+
+After writing the files, mark this task `status: done` and confirm to the user that their profile has been saved.

package/templates/skill_engineering.md

@@ -0,0 +1,40 @@
+---
+type: template
+name: skill-engineering-workflow
+description: Standard workflow for autonomous subagents to engineer new skills.
+---
+
+# Autonomous Skill Engineering Workflow
+
+You have been dispatched by the Total Recall Task Scheduler to engineer a new skill module.
+
+## 1. Research Phase
+- Execute web searches to find official documentation for the target topic.
+- Extract key workflows, rules, and best practices.
+- Avoid deprecated APIs or legacy knowledge.
+
+## 2. Draft Phase (AgentSkills 2.0 Format)
+- Create `~/.agent/skills/<topic-name>/` and the required AgentSkills runtime folders:
+  - `assets/`: Images, media, and static assets
+  - `evals/`: Self-evaluation test scripts
+  - `hooks/`: Lifecycle hooks
+  - `references/`: Downloaded docs and PDFs
+  - `scripts/`: Helper JS/Python scripts
+  - `subagents/`: Agent prompts for specific sub-tasks
+- Create `~/.agent/skills/<topic-name>/SKILL.md`.
+- Include the exact SSSS skill schema YAML frontmatter:
+  ```yaml
+  ---
+  name: <topic-name>
+  description: <When to route to this skill>
+  ---
+  ```
+- Write out the explicit procedures and anti-patterns.
+- Leave an empty `<!-- BEGIN INJECTED MEMORY: do not edit by hand; rebuilt by total-recall surface --><!-- END INJECTED MEMORY -->` block for the memory compiler.
+
+## 3. Validation Phase
+- Write a quick `.mjs` test script in `scratch/` to verify your assumptions against the API or tool.
+- If it fails, update the skill. If it passes, commit the skill.
+
+## 4. Blackboard State
+Log your progress to the local blackboard `~/.agent/blackboard/skill-engineering-<slug>.json` to ensure resume-ability if the process crashes.

package/templates/total-recall-daemon.service

@@ -0,0 +1,21 @@
+[Unit]
+Description=Total Recall Dream Cycle Daemon (Background Intelligence)
+After=network.target ollama.service total-recall-server.service
+
+[Service]
+Type=simple
+User=%i
+WorkingDirectory=/opt/total-recall
+ExecStart=/usr/bin/node src/core/dream.mjs
+Restart=always
+RestartSec=10
+Environment=NODE_ENV=production
+StandardOutput=append:/var/log/total-recall/daemon.log
+StandardError=append:/var/log/total-recall/daemon.log
+
+# Prevent idle reclamation by keeping CPU active
+# dream.mjs naturally maintains >10% CPU via inference loops
+CPUAccounting=true
+
+[Install]
+WantedBy=multi-user.target

package/templates/total-recall-server.service

@@ -0,0 +1,20 @@
+[Unit]
+Description=Total Recall HTTP Server (API + MCP + Dashboard)
+After=network.target ollama.service
+
+[Service]
+Type=simple
+User=%i
+WorkingDirectory=/opt/total-recall
+ExecStart=/usr/bin/node src/server/index.mjs
+Restart=always
+RestartSec=5
+Environment=NODE_ENV=production
+Environment=PORT=3000
+Environment=HOST=127.0.0.1
+Environment=AGENT_DIR=%h/.agent
+StandardOutput=append:/var/log/total-recall/server.log
+StandardError=append:/var/log/total-recall/server.log
+
+[Install]
+WantedBy=multi-user.target