clementine-agent 1.0.0

package/install.sh

@@ -0,0 +1,320 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ── Clementine Installer ─────────────────────────────────────────────
+# One-command install: system deps, npm packages, build, CLI, setup.
+# Safe to re-run — skips anything already installed.
+# ──────────────────────────────────────────────────────────────────────
+
+# ── Colors ────────────────────────────────────────────────────────────
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+DIM='\033[0;90m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+STEP=0
+WARNINGS=0
+
+# ── Helpers ───────────────────────────────────────────────────────────
+step()  { STEP=$((STEP + 1)); echo -e "\n  ${BOLD}[${STEP}] $1${RESET}"; }
+ok()    { echo -e "    ${GREEN}OK${RESET}  $1"; }
+warn()  { echo -e "    ${YELLOW}WARN${RESET}  $1"; WARNINGS=$((WARNINGS + 1)); }
+fail()  { echo -e "    ${RED}FAIL${RESET}  $1"; echo; exit 1; }
+info()  { echo -e "    ${DIM}$1${RESET}"; }
+run()   { echo -e "    ${CYAN}Running:${RESET} $1"; eval "$1"; }
+
+command_exists() { command -v "$1" &>/dev/null; }
+
+# ── Cleanup trap ──────────────────────────────────────────────────────
+trap 'if [ $? -ne 0 ]; then echo -e "\n  ${RED}Installation failed.${RESET} Check the output above for details.\n"; fi' EXIT
+
+# ── Banner ────────────────────────────────────────────────────────────
+echo
+echo -e "${CYAN}"
+cat << 'BANNER'
+ ██████╗██╗     ███████╗███╗   ███╗███████╗███╗   ██╗████████╗██╗███╗   ██╗███████╗
+██╔════╝██║     ██╔════╝████╗ ████║██╔════╝████╗  ██║╚══██╔══╝██║████╗  ██║██╔════╝
+██║     ██║     █████╗  ██╔████╔██║█████╗  ██╔██╗ ██║   ██║   ██║██╔██╗ ██║█████╗
+██║     ██║     ██╔══╝  ██║╚██╔╝██║██╔══╝  ██║╚██╗██║   ██║   ██║██║╚██╗██║██╔══╝
+╚██████╗███████╗███████╗██║ ╚═╝ ██║███████╗██║ ╚████║   ██║   ██║██║ ╚████║███████╗
+ ╚═════╝╚══════╝╚══════╝╚═╝     ╚═╝╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝╚═╝  ╚═══╝╚══════╝
+BANNER
+echo -e "${RESET}"
+
+VERSION=$(node -e "console.log(require('./package.json').version)" 2>/dev/null || echo "unknown")
+echo -e "  ${BOLD}Installer${RESET}  ${DIM}v${VERSION}${RESET}"
+
+# ── Platform detection ────────────────────────────────────────────────
+OS="$(uname -s)"
+ARCH="$(uname -m)"
+HAS_BREW=false
+HAS_APT=false
+MISSING_BREW=false
+
+case "$OS" in
+  Darwin)
+    OS="darwin"
+    echo -e "  ${DIM}Platform: macOS (${ARCH})${RESET}"
+    if command_exists brew; then
+      HAS_BREW=true
+    else
+      MISSING_BREW=true
+    fi
+    ;;
+  Linux)
+    OS="linux"
+    echo -e "  ${DIM}Platform: Linux (${ARCH})${RESET}"
+    if command_exists apt-get; then
+      HAS_APT=true
+    fi
+    ;;
+  *)
+    echo -e "\n  ${RED}Unsupported platform: ${OS}${RESET}"
+    echo -e "  Clementine supports macOS and Linux (apt-based)."
+    exit 1
+    ;;
+esac
+
+# ══════════════════════════════════════════════════════════════════════
+# Phase 1: Pre-flight checks
+# ══════════════════════════════════════════════════════════════════════
+step "Checking prerequisites"
+
+# Node.js
+if command_exists node; then
+  NODE_VERSION=$(node --version)
+  NODE_MAJOR=$(echo "$NODE_VERSION" | sed 's/v//' | cut -d. -f1)
+  if [ "$NODE_MAJOR" -ge 20 ] && [ "$NODE_MAJOR" -le 24 ]; then
+    ok "Node.js ${NODE_VERSION}"
+  else
+    fail "Node.js ${NODE_VERSION} — need v20-24 LTS.
+         Switch version:  nvm install 22 && nvm use 22
+         Then re-run:     bash install.sh"
+  fi
+else
+  fail "Node.js not found. Clementine requires Node.js 20-24 LTS.
+       Install via nvm:
+         curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+         nvm install 22
+       Then re-run: bash install.sh"
+fi
+
+# npm
+if command_exists npm; then
+  ok "npm $(npm --version)"
+else
+  fail "npm not found. Should be bundled with Node.js — check your Node installation."
+fi
+
+# Git repo
+if [ -d ".git" ]; then
+  ok "Git repository detected"
+else
+  fail "Not a git repository. Clone first:
+       git clone https://github.com/Natebreynolds/Clementine-AI-Assistant.git clementine
+       cd clementine && bash install.sh"
+fi
+
+# ══════════════════════════════════════════════════════════════════════
+# Phase 2: System dependencies
+# ══════════════════════════════════════════════════════════════════════
+step "Installing system dependencies"
+
+if [ "$MISSING_BREW" = true ]; then
+  warn "Homebrew not found. Some dependencies may need manual install."
+  info "Install Homebrew: /bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+fi
+
+# ── Build tools ───────────────────────────────────────────────────────
+if [ "$OS" = "darwin" ]; then
+  if xcode-select -p &>/dev/null; then
+    ok "Xcode Command Line Tools"
+  else
+    info "Installing Xcode Command Line Tools (a dialog may appear)..."
+    xcode-select --install 2>/dev/null || true
+    echo -e "    ${YELLOW}Waiting for Xcode CLT installation to complete...${RESET}"
+    until xcode-select -p &>/dev/null; do
+      sleep 5
+    done
+    ok "Xcode Command Line Tools installed"
+  fi
+elif [ "$OS" = "linux" ]; then
+  NEED_BUILD=false
+  if ! command_exists gcc; then NEED_BUILD=true; fi
+  if ! command_exists make; then NEED_BUILD=true; fi
+
+  if [ "$NEED_BUILD" = true ]; then
+    if [ "$HAS_APT" = true ]; then
+      info "Installing build-essential and python3..."
+      sudo apt-get update -qq
+      sudo apt-get install -y -qq build-essential python3
+      ok "Build tools installed"
+    else
+      warn "gcc/make not found and no apt-get available. Install build tools manually."
+    fi
+  else
+    ok "Build tools (gcc, make)"
+  fi
+
+  # Python3 (node-gyp needs it)
+  if command_exists python3; then
+    ok "python3"
+  elif [ "$HAS_APT" = true ]; then
+    sudo apt-get install -y -qq python3
+    ok "python3 installed"
+  else
+    warn "python3 not found. Native modules may fail to compile."
+  fi
+fi
+
+# ── redis-server ──────────────────────────────────────────────────────
+if command_exists redis-server; then
+  ok "redis-server (knowledge graph)"
+else
+  if [ "$HAS_BREW" = true ]; then
+    info "Installing redis..."
+    HOMEBREW_NO_AUTO_UPDATE=1 brew install redis 2>/dev/null
+    ok "redis-server installed"
+  elif [ "$HAS_APT" = true ]; then
+    info "Installing redis-server..."
+    sudo apt-get install -y -qq redis-server
+    ok "redis-server installed"
+  else
+    warn "redis-server not found (needed for knowledge graph, not core chat).
+         Install manually: brew install redis (macOS) or apt install redis-server (Linux)"
+  fi
+fi
+
+# ── libomp (OpenMP runtime for FalkorDB) ──────────────────────────────
+LIBOMP_FOUND=false
+if [ "$OS" = "darwin" ]; then
+  for p in /opt/homebrew/opt/libomp/lib/libomp.dylib /usr/local/opt/libomp/lib/libomp.dylib; do
+    [ -f "$p" ] && LIBOMP_FOUND=true && break
+  done
+elif [ "$OS" = "linux" ]; then
+  for p in /usr/lib/libomp.so /usr/lib/x86_64-linux-gnu/libomp.so; do
+    [ -f "$p" ] && LIBOMP_FOUND=true && break
+  done
+fi
+
+if [ "$LIBOMP_FOUND" = true ]; then
+  ok "libomp (OpenMP runtime)"
+else
+  if [ "$HAS_BREW" = true ]; then
+    info "Installing libomp..."
+    HOMEBREW_NO_AUTO_UPDATE=1 brew install libomp 2>/dev/null
+    ok "libomp installed"
+  elif [ "$HAS_APT" = true ]; then
+    info "Installing libomp-dev..."
+    sudo apt-get install -y -qq libomp-dev
+    ok "libomp installed"
+  else
+    warn "libomp not found (needed for knowledge graph, not core chat).
+         Install manually: brew install libomp (macOS) or apt install libomp-dev (Linux)"
+  fi
+fi
+
+# ══════════════════════════════════════════════════════════════════════
+# Phase 3: npm install
+# ══════════════════════════════════════════════════════════════════════
+step "Installing npm packages"
+
+if ! npm install --loglevel=error --no-audit 2>&1; then
+  fail "npm install failed. Check the output above.
+       Common fixes:
+         - Rebuild native modules: npm rebuild better-sqlite3
+         - Missing build tools: xcode-select --install (macOS) or apt install build-essential (Linux)
+         - Clear cache: rm -rf node_modules && npm install"
+fi
+ok "npm install complete"
+
+# ══════════════════════════════════════════════════════════════════════
+# Phase 4: Build TypeScript
+# ══════════════════════════════════════════════════════════════════════
+step "Building TypeScript"
+
+if ! npm run build 2>&1; then
+  fail "Build failed. Try: rm -rf dist && npm run build"
+fi
+ok "Build complete"
+
+# ══════════════════════════════════════════════════════════════════════
+# Phase 5: Install CLI globally
+# ══════════════════════════════════════════════════════════════════════
+step "Installing CLI globally"
+
+if npm install -g . --loglevel=error --no-audit 2>/dev/null; then
+  ok "clementine CLI installed"
+elif sudo npm install -g . --loglevel=error --no-audit 2>/dev/null; then
+  ok "clementine CLI installed (with sudo)"
+else
+  fail "Could not install CLI globally.
+       Try: sudo npm install -g . --loglevel=error --no-audit"
+fi
+
+# Verify
+if command_exists clementine; then
+  ok "clementine command available"
+else
+  warn "clementine not found in PATH. You may need to restart your shell."
+fi
+
+# ══════════════════════════════════════════════════════════════════════
+# Phase 6: Post-install verification
+# ══════════════════════════════════════════════════════════════════════
+step "Running health checks"
+
+# Claude CLI
+if command_exists claude; then
+  ok "Claude Code CLI found"
+else
+  warn "Claude Code CLI not found.
+       Install:       npm install -g @anthropic-ai/claude-code
+       Authenticate:  claude login
+       Clementine needs this to run, but setup can proceed without it."
+fi
+
+# Doctor (catch anything we missed — FalkorDB binaries, etc.)
+echo
+clementine doctor --fix || true
+
+# ══════════════════════════════════════════════════════════════════════
+# Phase 7: Configuration
+# ══════════════════════════════════════════════════════════════════════
+CLEMENTINE_HOME="${CLEMENTINE_HOME:-$HOME/.clementine}"
+ENV_FILE="${CLEMENTINE_HOME}/.env"
+
+step "Configuration"
+
+if [ -f "$ENV_FILE" ]; then
+  ok "Configuration already exists (${ENV_FILE})"
+  info "To reconfigure: clementine config setup"
+elif [ -t 0 ]; then
+  # Interactive terminal — launch setup wizard
+  info "Launching setup wizard..."
+  echo
+  clementine config setup
+else
+  # Non-interactive (CI, piped input)
+  warn "Non-interactive environment detected. Skipping setup wizard."
+  info "Run manually: clementine config setup"
+fi
+
+# ══════════════════════════════════════════════════════════════════════
+# Done
+# ══════════════════════════════════════════════════════════════════════
+echo
+echo -e "  ${GREEN}${BOLD}Installation complete!${RESET}"
+if [ "$WARNINGS" -gt 0 ]; then
+  echo -e "  ${YELLOW}${WARNINGS} warning(s) above — review before launching.${RESET}"
+fi
+echo
+echo -e "  ${BOLD}Next steps:${RESET}"
+echo -e "    clementine launch              ${DIM}Start the daemon${RESET}"
+echo -e "    clementine launch --install    ${DIM}Auto-start on login (macOS)${RESET}"
+echo -e "    clementine dashboard           ${DIM}Open the web command center${RESET}"
+echo -e "    clementine doctor              ${DIM}Verify everything is healthy${RESET}"
+echo

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "clementine-agent",
+  "version": "1.0.0",
+  "description": "Clementine — Personal AI Assistant (TypeScript)",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "clementine": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "rm -rf dist.tmp 2>/dev/null; tsc --outDir dist.tmp && rm -rf dist && mv dist.tmp dist && chmod +x dist/cli/index.js",
+    "prepublishOnly": "npm run build && find dist -name '*.map' -delete",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "mcp": "tsx src/tools/mcp-server.ts",
+    "cli": "tsx src/cli/index.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "postinstall": "node scripts/postinstall.js 2>/dev/null || true"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.91",
+    "@anthropic-ai/sdk": "^0.82.0",
+    "@inquirer/prompts": "^7.0.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@slack/bolt": "^4.2.0",
+    "better-sqlite3": "^11.7.0",
+    "commander": "^13.1.0",
+    "cron-parser": "^5.5.0",
+    "discord.js": "^14.18.0",
+    "express": "^4.21.0",
+    "falkordblite": "^0.2.0",
+    "grammy": "^1.35.0",
+    "gray-matter": "^4.0.3",
+    "node-cron": "^3.0.3",
+    "pino": "^9.6.0",
+    "twilio": "^5.5.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.12.0",
+    "@types/node-cron": "^3.0.11",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "author": "Nathan Reynolds",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Natebreynolds/Clementine-AI-Assistant.git"
+  },
+  "homepage": "https://github.com/Natebreynolds/Clementine-AI-Assistant",
+  "bugs": {
+    "url": "https://github.com/Natebreynolds/Clementine-AI-Assistant/issues"
+  },
+  "keywords": [
+    "ai-assistant",
+    "claude",
+    "discord-bot",
+    "slack-bot",
+    "personal-assistant",
+    "obsidian",
+    "memory",
+    "agent"
+  ],
+  "files": [
+    "dist/",
+    "vault/",
+    "scripts/",
+    "install.sh",
+    "README.md",
+    ".env.example"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * Clementine postinstall script.
+ *
+ * Runs after `npm install -g clementine-agent` to:
+ *   1. Rebuild native modules (better-sqlite3) for the current Node version
+ *   2. Initialize ~/.clementine/ directory structure if it doesn't exist
+ *   3. Copy default vault templates from package to data home
+ *   4. Check for `claude` CLI on PATH (needed for OAuth login)
+ *   5. Print first-run instructions
+ *
+ * Safe to re-run — skips steps already completed.
+ */
+
+import { execSync } from 'node:child_process';
+import { cpSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PKG_DIR = path.resolve(__dirname, '..');
+const DATA_HOME = process.env.CLEMENTINE_HOME || path.join(os.homedir(), '.clementine');
+
+// ── Step 1: Rebuild better-sqlite3 ─────────────────────────────────
+try {
+  process.stdout.write('Rebuilding native modules...');
+  execSync('npm rebuild better-sqlite3 --quiet', {
+    stdio: 'pipe',
+    cwd: PKG_DIR,
+  });
+  process.stdout.write(' done.\n');
+} catch {
+  // Non-fatal — prebuild-install may have a prebuilt binary available
+  process.stdout.write(' skipped (prebuilt may work).\n');
+}
+
+// ── Step 2: Create ~/.clementine directory structure ────────────────
+const dirs = [
+  DATA_HOME,
+  path.join(DATA_HOME, 'logs'),
+  path.join(DATA_HOME, 'vault'),
+  path.join(DATA_HOME, 'vault', '00-System'),
+  path.join(DATA_HOME, 'vault', '01-Daily-Notes'),
+  path.join(DATA_HOME, 'vault', '02-People'),
+  path.join(DATA_HOME, 'vault', '03-Projects'),
+  path.join(DATA_HOME, 'vault', '04-Topics'),
+  path.join(DATA_HOME, 'vault', '05-Tasks'),
+  path.join(DATA_HOME, 'vault', '06-Templates'),
+  path.join(DATA_HOME, 'vault', '07-Inbox'),
+  path.join(DATA_HOME, 'agents'),
+  path.join(DATA_HOME, 'self-improve'),
+  path.join(DATA_HOME, 'cron'),
+];
+
+for (const dir of dirs) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+// ── Step 3: Copy default vault templates if not already present ─────
+const srcVault = path.join(PKG_DIR, 'vault', '00-System');
+const dstVault = path.join(DATA_HOME, 'vault', '00-System');
+
+if (existsSync(srcVault)) {
+  const files = readdirSync(srcVault).filter(f => f.endsWith('.md'));
+  let copied = 0;
+  for (const file of files) {
+    const dst = path.join(dstVault, file);
+    if (!existsSync(dst)) {
+      try {
+        cpSync(path.join(srcVault, file), dst);
+        copied++;
+      } catch { /* skip */ }
+    }
+  }
+  if (copied > 0) {
+    console.log(`Initialized ${copied} default vault files in ${dstVault}`);
+  }
+}
+
+// ── Step 4: Check for claude CLI ────────────────────────────────────
+let claudeOnPath = false;
+try {
+  execSync('claude --version', { stdio: 'pipe' });
+  claudeOnPath = true;
+} catch { /* not on PATH */ }
+
+// ── Step 5: Print instructions ──────────────────────────────────────
+const alreadyConfigured = existsSync(path.join(DATA_HOME, '.env'));
+
+if (alreadyConfigured) {
+  console.log('\n✓ Clementine already configured. Run `clementine status` to check.\n');
+} else {
+  const claudeNote = claudeOnPath
+    ? '║  Auth: run `clementine login` (uses your Claude Code subscription) ║'
+    : '║  Auth: install Claude Code CLI first, then `clementine login`      ║';
+
+  console.log(`
+╔══════════════════════════════════════════════════════════════════╗
+║              Clementine installed successfully!                   ║
+╠══════════════════════════════════════════════════════════════════╣
+║                                                                  ║
+║  Next steps:                                                     ║
+║                                                                  ║
+║  1. Run: clementine login                                        ║
+║     Authenticate with your Claude Code subscription (OAuth)      ║
+║                                                                  ║
+║  2. Run: clementine setup                                        ║
+║     Configure your channels (Discord, Slack, Telegram...)        ║
+║                                                                  ║
+║  3. Run: clementine launch                                       ║
+║     Start the assistant as a background daemon                   ║
+║                                                                  ║
+║  4. Run: clementine dashboard                                    ║
+║     Open the web command center at localhost:3030                ║
+║                                                                  ║
+║  ${claudeNote.padEnd(65)}║
+║                                                                  ║
+║  Data directory: ${DATA_HOME.padEnd(47)}║
+║                                                                  ║
+╚══════════════════════════════════════════════════════════════════╝
+`);
+}

package/vault/00-System/AGENTS.md

@@ -0,0 +1,66 @@
+---
+type: core-system
+role: operating-instructions
+tags:
+  - system
+  - instructions
+---
+
+# Operating Instructions
+
+## Priority Order
+
+1. **Safety first** — never take irreversible actions without the owner's approval
+2. **Be helpful** — actually solve the problem, don't just describe it
+3. **Remember everything** — if it might matter later, write it down
+4. **Stay in character** — I'm Clementine, not "an AI assistant"
+
+## Message Handling
+
+When the owner sends a message:
+1. Read it carefully. Understand the intent, not just the literal words.
+2. Check [[MEMORY]] and recent [[01-Daily-Notes|daily notes]] for relevant context.
+3. If I need to take action, use my tools. Don't describe what I *would* do — do it.
+4. Respond concisely. If I did something, confirm what I did.
+5. Log key interactions to today's daily note.
+
+## Memory Protocol
+
+- **Durable facts** (preferences, people, decisions) → write to [[MEMORY]] or the appropriate topic/person note
+- **Daily context** (conversations, things that happened today) → append to today's [[01-Daily-Notes|daily note]]
+- **Tasks** → add to [[05-Tasks/TASKS|task list]] with status and priority
+- **Quick captures** → write to [[07-Inbox|Inbox]] for later sorting
+- If the owner tells me something about themselves, a person, or a project → update the relevant note immediately
+
+## Task Protocol
+
+- When asked to do something that isn't immediate → create a task
+- Check tasks during heartbeats
+- Move tasks through: `pending` → `in-progress` → `completed`
+- Overdue tasks get flagged to the owner
+
+## Heartbeat Protocol
+
+During autonomous heartbeats (see [[HEARTBEAT]]):
+1. Read standing instructions from HEARTBEAT.md
+2. Check for overdue or pending tasks
+3. Review any scheduled items
+4. If something needs attention → send a DM
+5. If nothing urgent → log a quiet entry to today's daily note
+6. Stay within security tier limits (no Tier 3 actions)
+
+## Wikilink Conventions
+
+- People: `[[02-People/Person Name|Person Name]]`
+- Projects: `[[03-Projects/Project Name|Project Name]]`
+- Topics: `[[04-Topics/Topic Name|Topic Name]]`
+- Tasks: `[[05-Tasks/TASKS|Tasks]]`
+- Daily: `[[01-Daily-Notes/YYYY-MM-DD|today]]`
+
+## What I Don't Do
+
+- I don't push code without asking
+- I don't delete files without asking
+- I don't send emails/messages without asking
+- I don't make purchases or financial transactions
+- I don't access accounts or credentials without explicit instruction

package/vault/00-System/CRON.md

@@ -0,0 +1,71 @@
+---
+type: core-system
+role: cron-config
+jobs:
+  - name: morning-briefing
+    schedule: "0 8 * * *"
+    prompt: >
+      Give the owner a comprehensive morning briefing:
+      1. Read the task list and list any overdue, due-today, or high-priority pending tasks
+      2. Read yesterday's daily note summary for context on what was happening
+      3. Check today's daily note for anything already logged
+      4. Check the inbox for unsorted items
+      5. Format as a clear briefing with sections: Tasks, Yesterday Recap, Today's Focus
+      Keep it concise but actionable.
+    tier: 1
+    enabled: true
+
+  - name: weekly-review
+    schedule: "0 18 * * 5"
+    prompt: >
+      Create a weekly review note:
+      1. Read daily notes from the past 7 days
+      2. Summarize what got done this week
+      3. List what's still pending
+      4. Suggest priorities for next week
+      5. Write the review to today's daily note under a "## Weekly Review" section
+    tier: 2
+    enabled: true
+
+  - name: daily-memory-cleanup
+    schedule: "0 22 * * *"
+    prompt: >
+      End of day cleanup:
+      1. Review today's daily note
+      2. Extract any durable facts (preferences, decisions, people details) and write them to MEMORY.md or the appropriate topic/person note
+      3. Move completed tasks from Pending to Completed in TASKS.md
+      4. Write a brief summary of the day in today's daily note under ## Summary
+    tier: 1
+    enabled: true
+tags:
+  - system
+  - cron
+---
+
+# Cron Jobs
+
+Scheduled tasks that run automatically at specific times. Edit the frontmatter above to add, modify, or disable jobs.
+
+## Active Jobs
+
+| Job | Schedule | Description |
+|-----|----------|-------------|
+| morning-briefing | 8:00 AM daily | Comprehensive morning briefing |
+| weekly-review | 6:00 PM Fridays | Weekly summary + planning |
+| daily-memory-cleanup | 10:00 PM daily | Promote daily facts to long-term memory |
+
+## Schedule Syntax
+
+Standard cron expressions: `minute hour day-of-month month day-of-week`
+See [crontab.guru](https://crontab.guru) for help.
+
+## Adding a Job
+
+Add a new entry to the `jobs` list in the frontmatter above:
+```yaml
+  - name: my-new-job
+    schedule: "0 12 * * *"
+    prompt: "What should Clementine do"
+    tier: 1
+    enabled: true
+```