clementine-agent 1.0.3 → 1.0.5

package/dist/agent/daily-planner.js

@@ -8,54 +8,9 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import pino from 'pino';
-import Anthropic from '@anthropic-ai/sdk';
 import { BASE_DIR, GOALS_DIR, CRON_REFLECTIONS_DIR, TASKS_FILE, INBOX_DIR, MODELS, } from '../config.js';
 const logger = pino({ name: 'clementine.daily-planner' });
 const PLANS_DIR = path.join(BASE_DIR, 'plans', 'daily');
-// ── .env reader (self-contained — no config.ts secret imports) ───────
-function getEnvValue(key) {
-    // Check process env first (already loaded by the daemon)
-    if (process.env[key])
-        return process.env[key];
-    // Fall back to .env file
-    const envPath = path.join(BASE_DIR, '.env');
-    if (!existsSync(envPath))
-        return '';
-    for (const line of readFileSync(envPath, 'utf-8').split('\n')) {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith('#'))
-            continue;
-        const eqIndex = trimmed.indexOf('=');
-        if (eqIndex === -1)
-            continue;
-        if (trimmed.slice(0, eqIndex) !== key)
-            continue;
-        let value = trimmed.slice(eqIndex + 1);
-        if ((value.startsWith('"') && value.endsWith('"')) ||
-            (value.startsWith("'") && value.endsWith("'"))) {
-            value = value.slice(1, -1);
-        }
-        return value;
-    }
-    return '';
-}
-/**
- * Build Anthropic client credentials.
- * Priority: ANTHROPIC_AUTH_TOKEN (OAuth) > ANTHROPIC_API_KEY (legacy raw key).
- * Returns null if neither is configured.
- */
-function getAnthropicCredentials() {
-    const oauthToken = getEnvValue('CLAUDE_CODE_OAUTH_TOKEN');
-    if (oauthToken)
-        return { authToken: oauthToken };
-    const authToken = getEnvValue('ANTHROPIC_AUTH_TOKEN');
-    if (authToken)
-        return { authToken };
-    const apiKey = getEnvValue('ANTHROPIC_API_KEY');
-    if (apiKey)
-        return { apiKey };
-    return null;
-}
 // ── Helpers ──────────────────────────────────────────────────────────
 function todayStr() {
     const d = new Date();
@@ -303,24 +258,27 @@ Rules:
 - Limit to at most 10 priorities, 5 cron changes, 5 new work items
 - Focus on actionable items, not status reports
 - If everything is on track, return minimal priorities`;
-        const creds = getAnthropicCredentials();
-        if (!creds) {
-            logger.warn('No Anthropic credentials found — generating fallback plan. Run `clementine login` to authenticate.');
-            return this.fallbackPlan(today);
-        }
         try {
-            const client = new Anthropic(creds.authToken ? { authToken: creds.authToken } : { apiKey: creds.apiKey });
-            const response = await client.messages.create({
-                model: MODELS.haiku,
-                max_tokens: 2000,
-                messages: [{ role: 'user', content: prompt }],
-                system: 'You are a planning assistant. Analyze the context and produce a prioritized daily plan as JSON. Return only valid JSON, no markdown fencing.',
+            const { query } = await import('@anthropic-ai/claude-agent-sdk');
+            let text = '';
+            const stream = query({
+                prompt,
+                options: {
+                    model: MODELS.haiku,
+                    maxTurns: 1,
+                    systemPrompt: 'You are a planning assistant. Analyze the context and produce a prioritized daily plan as JSON. Return only valid JSON, no markdown fencing.',
+                },
             });
-            const text = response.content
-                .filter(block => block.type === 'text')
-                .map(block => block.text)
-                .join('');
-            const plan = JSON.parse(text);
+            for await (const msg of stream) {
+                if (msg.type === 'result')
+                    text = msg.result ?? '';
+            }
+            if (!text) {
+                logger.warn('LLM returned empty plan — using fallback');
+                return this.fallbackPlan(today);
+            }
+            const cleaned = text.replace(/^```(?:json)?\s*/i, '').replace(/\s*```\s*$/, '').trim();
+            const plan = JSON.parse(cleaned);
             plan.date = today;
             plan.createdAt = new Date().toISOString();
             plan.priorities = plan.priorities ?? [];

package/dist/agent/strategic-planner.js

@@ -12,54 +12,27 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import pino from 'pino';
-import Anthropic from '@anthropic-ai/sdk';
 import { BASE_DIR, GOALS_DIR, MODELS } from '../config.js';
 const logger = pino({ name: 'clementine.strategic-planner' });
 const DAILY_PLANS_DIR = path.join(BASE_DIR, 'plans', 'daily');
 const WEEKLY_PLANS_DIR = path.join(BASE_DIR, 'plans', 'weekly');
 const MONTHLY_PLANS_DIR = path.join(BASE_DIR, 'plans', 'monthly');
-// ── .env reader ──────────────────────────────────────────────────────
-function getEnvValue(key) {
-    if (process.env[key])
-        return process.env[key];
-    const envPath = path.join(BASE_DIR, '.env');
-    if (!existsSync(envPath))
-        return '';
-    for (const line of readFileSync(envPath, 'utf-8').split('\n')) {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith('#'))
-            continue;
-        const eqIndex = trimmed.indexOf('=');
-        if (eqIndex === -1)
-            continue;
-        if (trimmed.slice(0, eqIndex) !== key)
-            continue;
-        let value = trimmed.slice(eqIndex + 1);
-        if ((value.startsWith('"') && value.endsWith('"')) ||
-            (value.startsWith("'") && value.endsWith("'"))) {
-            value = value.slice(1, -1);
-        }
-        return value;
+async function llmJsonCall(prompt, systemPrompt) {
+    const { query } = await import('@anthropic-ai/claude-agent-sdk');
+    let text = '';
+    const stream = query({
+        prompt,
+        options: {
+            model: MODELS.haiku,
+            maxTurns: 1,
+            systemPrompt,
+        },
+    });
+    for await (const msg of stream) {
+        if (msg.type === 'result')
+            text = msg.result ?? '';
     }
-    return '';
-}
-function getAnthropicCredentials() {
-    const oauthToken = getEnvValue('CLAUDE_CODE_OAUTH_TOKEN');
-    if (oauthToken)
-        return { authToken: oauthToken };
-    const authToken = getEnvValue('ANTHROPIC_AUTH_TOKEN');
-    if (authToken)
-        return { authToken };
-    const apiKey = getEnvValue('ANTHROPIC_API_KEY');
-    if (apiKey)
-        return { apiKey };
-    return null;
-}
-function makeAnthropicClient() {
-    const creds = getAnthropicCredentials();
-    if (!creds)
-        return null;
-    return new Anthropic(creds.authToken ? { authToken: creds.authToken } : { apiKey: creds.apiKey });
+    return text;
 }
 // ── Strategic Planner ────────────────────────────────────────────────
 export class StrategicPlanner {
@@ -153,16 +126,8 @@ export class StrategicPlanner {
             })),
             summary: 'No data available for weekly review.',
         };
-        const client = makeAnthropicClient();
-        if (!client)
-            return defaultReview;
         try {
-            const response = await client.messages.create({
-                model: MODELS.haiku,
-                max_tokens: 1000,
-                messages: [{ role: 'user', content: prompt }],
-            });
-            const text = response.content[0]?.type === 'text' ? response.content[0].text : '';
+            const text = await llmJsonCall(prompt, 'You synthesize weekly reviews. Return only valid JSON, no markdown fencing.');
             const jsonMatch = text.match(/\{[\s\S]*\}/);
             if (jsonMatch) {
                 const parsed = JSON.parse(jsonMatch[0]);
@@ -235,9 +200,6 @@ export class StrategicPlanner {
             proposedGoals: [],
             summary: 'No data available for monthly assessment.',
         };
-        const client2 = makeAnthropicClient();
-        if (!client2)
-            return defaultAssessment;
         const prompt = `You are generating a monthly strategic assessment for ${monthId}.\n\n` +
             `${context}\n\n` +
             `Output ONLY a JSON object:\n` +
@@ -248,12 +210,7 @@ export class StrategicPlanner {
             `  "summary": "2-3 sentence strategic assessment"\n` +
             `}`;
         try {
-            const response = await client2.messages.create({
-                model: MODELS.haiku,
-                max_tokens: 1000,
-                messages: [{ role: 'user', content: prompt }],
-            });
-            const text = response.content[0]?.type === 'text' ? response.content[0].text : '';
+            const text = await llmJsonCall(prompt, 'You produce monthly strategic assessments. Return only valid JSON, no markdown fencing.');
             const jsonMatch = text.match(/\{[\s\S]*\}/);
             if (jsonMatch) {
                 const parsed = JSON.parse(jsonMatch[0]);

package/dist/cli/index.js

@@ -57,6 +57,13 @@ function getLaunchdPlistPath() {
     const home = process.env.HOME ?? '';
     return path.join(home, 'Library', 'LaunchAgents', `${getLaunchdLabel()}.plist`);
 }
+function getSystemdServiceName() {
+    return `${getAssistantName().toLowerCase()}.service`;
+}
+function getSystemdServicePath() {
+    const home = process.env.HOME ?? '';
+    return path.join(home, '.config', 'systemd', 'user', getSystemdServiceName());
+}
 function readPid() {
     const pidFile = getPidFilePath();
     if (!existsSync(pidFile))
@@ -104,10 +111,10 @@ function killPid(pid) {
         // already dead
     }
 }
-/** Stop the daemon safely: unload LaunchAgent first (prevents respawn), then kill the process. */
+/** Stop the daemon safely: disable the service manager first (prevents respawn), then kill the process. */
 function stopDaemon(pid) {
-    // Unload LaunchAgent BEFORE killing — otherwise launchd respawns it immediately
     if (process.platform === 'darwin') {
+        // Unload LaunchAgent BEFORE killing — otherwise launchd respawns it immediately
         const plist = getLaunchdPlistPath();
         if (existsSync(plist)) {
             try {
@@ -118,6 +125,18 @@ function stopDaemon(pid) {
             }
         }
     }
+    else if (process.platform === 'linux') {
+        // Stop systemd service BEFORE killing — otherwise systemd respawns it
+        const servicePath = getSystemdServicePath();
+        if (existsSync(servicePath)) {
+            try {
+                execSync(`systemctl --user stop ${getSystemdServiceName()}`, { stdio: 'pipe' });
+            }
+            catch {
+                // not active — that's fine
+            }
+        }
+    }
     killPid(pid);
 }
 /** Bootstrap ~/.clementine/ on first run — create data dir and copy vault templates. */
@@ -136,43 +155,68 @@ function ensureDataHome() {
 // ── Commands ─────────────────────────────────────────────────────────
 function cmdLaunch(options) {
     if (options.uninstall) {
-        const plistPath = getLaunchdPlistPath();
-        if (existsSync(plistPath)) {
-            try {
-                execSync(`launchctl unload "${plistPath}"`, { stdio: 'ignore' });
+        if (process.platform === 'darwin') {
+            const plistPath = getLaunchdPlistPath();
+            if (existsSync(plistPath)) {
+                try {
+                    execSync(`launchctl unload "${plistPath}"`, { stdio: 'ignore' });
+                }
+                catch {
+                    // not loaded
+                }
+                unlinkSync(plistPath);
+                console.log(`  Uninstalled LaunchAgent: ${getLaunchdLabel()}`);
             }
-            catch {
-                // not loaded
+            else {
+                console.log('  LaunchAgent not installed.');
             }
-            unlinkSync(plistPath);
-            console.log(`  Uninstalled LaunchAgent: ${getLaunchdLabel()}`);
         }
-        else {
-            console.log('  LaunchAgent not installed.');
+        else if (process.platform === 'linux') {
+            const servicePath = getSystemdServicePath();
+            const serviceName = getSystemdServiceName();
+            if (existsSync(servicePath)) {
+                try {
+                    execSync(`systemctl --user stop ${serviceName}`, { stdio: 'ignore' });
+                    execSync(`systemctl --user disable ${serviceName}`, { stdio: 'ignore' });
+                }
+                catch {
+                    // not active
+                }
+                unlinkSync(servicePath);
+                try {
+                    execSync('systemctl --user daemon-reload', { stdio: 'ignore' });
+                }
+                catch { /* ignore */ }
+                console.log(`  Uninstalled systemd service: ${serviceName}`);
+            }
+            else {
+                console.log('  Systemd service not installed.');
+            }
         }
         return;
     }
     if (options.install) {
-        const plistPath = getLaunchdPlistPath();
-        const plistDir = path.dirname(plistPath);
-        if (!existsSync(plistDir)) {
-            mkdirSync(plistDir, { recursive: true });
-        }
-        // Unload existing plist if already installed (idempotent reinstall)
-        if (existsSync(plistPath)) {
-            try {
-                execSync(`launchctl unload "${plistPath}"`, { stdio: 'ignore' });
+        if (process.platform === 'darwin') {
+            const plistPath = getLaunchdPlistPath();
+            const plistDir = path.dirname(plistPath);
+            if (!existsSync(plistDir)) {
+                mkdirSync(plistDir, { recursive: true });
             }
-            catch {
-                // not loaded — fine
+            // Unload existing plist if already installed (idempotent reinstall)
+            if (existsSync(plistPath)) {
+                try {
+                    execSync(`launchctl unload "${plistPath}"`, { stdio: 'ignore' });
+                }
+                catch {
+                    // not loaded — fine
+                }
             }
-        }
-        const nodePath = process.execPath;
-        const logDir = path.join(BASE_DIR, 'logs');
-        if (!existsSync(logDir)) {
-            mkdirSync(logDir, { recursive: true });
-        }
-        const plist = `<?xml version="1.0" encoding="UTF-8"?>
+            const nodePath = process.execPath;
+            const logDir = path.join(BASE_DIR, 'logs');
+            if (!existsSync(logDir)) {
+                mkdirSync(logDir, { recursive: true });
+            }
+            const plist = `<?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>
@@ -204,15 +248,80 @@ function cmdLaunch(options) {
   </dict>
 </dict>
 </plist>`;
-        writeFileSync(plistPath, plist);
-        try {
-            execSync(`launchctl load "${plistPath}"`);
-            console.log(`  Installed and loaded LaunchAgent: ${getLaunchdLabel()}`);
-            console.log(`  Plist: ${plistPath}`);
-            console.log(`  Logs:  ${logDir}/`);
+            writeFileSync(plistPath, plist);
+            try {
+                execSync(`launchctl load "${plistPath}"`);
+                console.log(`  Installed and loaded LaunchAgent: ${getLaunchdLabel()}`);
+                console.log(`  Plist: ${plistPath}`);
+                console.log(`  Logs:  ${logDir}/`);
+            }
+            catch (err) {
+                console.error(`  Failed to load LaunchAgent: ${err}`);
+            }
         }
-        catch (err) {
-            console.error(`  Failed to load LaunchAgent: ${err}`);
+        else if (process.platform === 'linux') {
+            const servicePath = getSystemdServicePath();
+            const serviceName = getSystemdServiceName();
+            const serviceDir = path.dirname(servicePath);
+            if (!existsSync(serviceDir)) {
+                mkdirSync(serviceDir, { recursive: true });
+            }
+            // Stop existing service if already installed (idempotent reinstall)
+            if (existsSync(servicePath)) {
+                try {
+                    execSync(`systemctl --user stop ${serviceName}`, { stdio: 'ignore' });
+                }
+                catch {
+                    // not active — fine
+                }
+            }
+            const nodePath = process.execPath;
+            const logDir = path.join(BASE_DIR, 'logs');
+            if (!existsSync(logDir)) {
+                mkdirSync(logDir, { recursive: true });
+            }
+            const envPath = path.join(BASE_DIR, '.env');
+            const servicePATH = [path.dirname(nodePath), '/usr/local/bin', '/usr/bin', '/bin']
+                .join(':');
+            const unit = `[Unit]
+Description=${getAssistantName()} AI Assistant
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=${nodePath} ${DIST_ENTRY}
+WorkingDirectory=${BASE_DIR}
+Environment=PATH=${servicePATH}
+Environment=CLEMENTINE_HOME=${BASE_DIR}
+EnvironmentFile=-${envPath}
+Restart=always
+RestartSec=5
+StandardOutput=append:${path.join(logDir, 'clementine.log')}
+StandardError=append:${path.join(logDir, 'clementine-error.log')}
+
+[Install]
+WantedBy=default.target
+`;
+            writeFileSync(servicePath, unit);
+            try {
+                execSync('systemctl --user daemon-reload', { stdio: 'pipe' });
+                execSync(`systemctl --user enable --now ${serviceName}`, { stdio: 'pipe' });
+                // Enable lingering so the service runs even when the user is not logged in (VPS)
+                try {
+                    execSync(`loginctl enable-linger $(whoami)`, { stdio: 'pipe' });
+                }
+                catch {
+                    console.log('  Note: Could not enable linger. Run as root: loginctl enable-linger $(whoami)');
+                }
+                console.log(`  Installed and started systemd service: ${serviceName}`);
+                console.log(`  Service: ${servicePath}`);
+                console.log(`  Logs:    ${logDir}/`);
+                console.log(`  Status:  systemctl --user status ${serviceName}`);
+            }
+            catch (err) {
+                console.error(`  Failed to enable systemd service: ${err}`);
+            }
         }
         // Also install the cron scheduler alongside the daemon
         console.log();
@@ -681,7 +790,7 @@ function cmdDoctor(opts = {}) {
     else {
         console.log(`  ${DIM}  ○  Daemon not running${RESET}`);
     }
-    // LaunchAgent health check (macOS only)
+    // Service health check (platform-specific)
     if (process.platform === 'darwin') {
         const plistPath = getLaunchdPlistPath();
         if (existsSync(plistPath)) {
@@ -700,6 +809,25 @@ function cmdDoctor(opts = {}) {
             issues++;
         }
     }
+    else if (process.platform === 'linux') {
+        const servicePath = getSystemdServicePath();
+        const serviceName = getSystemdServiceName();
+        if (existsSync(servicePath)) {
+            try {
+                execSync(`systemctl --user is-active ${serviceName}`, { stdio: 'pipe' });
+                console.log(`  ${GREEN}OK${RESET}  Systemd service installed and active`);
+            }
+            catch {
+                console.log(`  ${YELLOW}WARN${RESET}  Systemd service installed but not active`);
+                console.log(`       Start it: systemctl --user start ${serviceName}`);
+                issues++;
+            }
+        }
+        else {
+            console.log(`  ${YELLOW}WARN${RESET}  Systemd service not installed (run: clementine launch --install)`);
+            issues++;
+        }
+    }
     console.log();
     if (issues === 0 && fixed === 0) {
         console.log(`  ${GREEN}All checks passed.${RESET}`);
@@ -925,6 +1053,16 @@ program
     .description('Restart the assistant (daemon by default)')
     .option('-f, --foreground', 'Run in foreground after restart')
     .action(cmdRestart);
+program
+    .command('setup')
+    .description('Run interactive setup wizard')
+    .action(() => {
+    ensureDataHome();
+    runSetup().catch((err) => {
+        console.error('Setup failed:', err);
+        process.exit(1);
+    });
+});
 program
     .command('rebuild')
     .description('Rebuild from source and restart all processes (daemon + dashboard)')

package/dist/cli/setup.js

@@ -629,19 +629,20 @@ export async function runSetup() {
     console.log(`  All users:  ${allowAll ? 'yes' : 'no (owner only)'}`);
     console.log();
     // ── Step 8: Auto-start on login ───────────────────────────────────
-    if (process.platform === 'darwin') {
+    if (process.platform === 'darwin' || process.platform === 'linux') {
         sectionHeader('Step 8: Auto-Start');
-        console.log(`  ${DIM}Install a login service so ${entries['ASSISTANT_NAME'] || 'Clementine'} starts${RESET}`);
-        console.log(`  ${DIM}automatically when you turn on your computer.${RESET}`);
+        const serviceName = process.platform === 'darwin' ? 'LaunchAgent' : 'systemd service';
+        console.log(`  ${DIM}Install a ${serviceName} so ${entries['ASSISTANT_NAME'] || 'Clementine'} starts${RESET}`);
+        console.log(`  ${DIM}automatically when the system boots.${RESET}`);
         console.log();
         const installService = await confirm({
-            message: 'Start automatically on login? (recommended)',
+            message: 'Start automatically on boot? (recommended)',
             default: true,
         });
         if (installService) {
-            // Signal to the caller that LaunchAgent should be installed
-            writeFileSync(path.join(BASE_DIR, '.install-launchagent'), '');
-            console.log(`  ${GREEN}✔ Will install login service after first launch${RESET}`);
+            // Signal to the caller that the service should be installed
+            writeFileSync(path.join(BASE_DIR, '.install-service'), '');
+            console.log(`  ${GREEN}✔ Will install ${serviceName} after first launch${RESET}`);
         }
     }
     console.log();

package/dist/gateway/cron-scheduler.js

@@ -990,6 +990,19 @@ export class CronScheduler {
                 }
                 catch { /* non-fatal */ }
             }
+            // Auto-disable after too many consecutive failures — prevents zombie jobs
+            // from burning resources indefinitely. Re-enable from the dashboard.
+            if (consErrors >= 10 && !this.disabledJobs.has(job.name)) {
+                this.disabledJobs.add(job.name);
+                const scheduledTask = this.scheduledTasks.get(job.name);
+                if (scheduledTask) {
+                    scheduledTask.stop();
+                    this.scheduledTasks.delete(job.name);
+                }
+                logger.error({ job: job.name, consErrors }, `Auto-disabled cron after ${consErrors} consecutive failures`);
+                this.logAdvisorEvent('auto-disabled', job.name, `Auto-disabled after ${consErrors} consecutive failures`);
+                this.dispatcher.send(`🛑 **Cron auto-disabled** — \`${job.name}\` failed ${consErrors} times in a row. Fix the job and re-enable it from the dashboard.`, { agentSlug: job.agentSlug }).catch(err => logger.debug({ err }, 'Failed to send auto-disable notification'));
+            }
         }
     }
     /**

package/dist/gateway/heartbeat-scheduler.js

@@ -204,7 +204,7 @@ export class HeartbeatScheduler {
                 '(preferences, decisions, people info, project updates) to long-term memory using ' +
                 'memory_write. Skip anything already in MEMORY.md. Be selective — only save facts ' +
                 'that will be useful in future conversations. Do not create duplicate entries.', 1, // tier 1 (vault-only)
-            3, // max 3 turns
+            10, // max 10 turns — workflow needs read + candidates + read + write + mark_consolidated
             'haiku').catch(err => {
                 logger.error({ err }, 'Evening memory consolidation failed');
             });

package/install.sh

@@ -87,15 +87,15 @@ step "Checking prerequisites"
 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
+  if [ "$NODE_MAJOR" -ge 20 ]; then
     ok "Node.js ${NODE_VERSION}"
   else
-    fail "Node.js ${NODE_VERSION} — need v20-24 LTS.
+    fail "Node.js ${NODE_VERSION} — need v20 or newer.
          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.
+  fail "Node.js not found. Clementine requires Node.js 20 or newer.
        Install via nvm:
          curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
          nvm install 22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",