clementine-agent 1.0.76 → 1.0.78

package/dist/tools/session-tools.js

@@ -5,6 +5,15 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from
 import path from 'node:path';
 import { z } from 'zod';
 import { BASE_DIR, HANDOFFS_DIR, INBOX_DIR, TASKS_FILE, logger, textResult, todayStr, listAllGoals, } from './shared.js';
+import { decideDiscoveredWorkItem } from '../agent/proactive-engine.js';
+import { recentDecisions } from '../agent/proactive-ledger.js';
+const ACTION_LABEL = {
+    act_now: 'Doing now',
+    queue: 'Queued',
+    ask_user: 'Needs you',
+    snooze: 'Snoozed',
+    ignore: 'Skipped',
+};
 function ensureHandoffsDir() {
     if (!existsSync(HANDOFFS_DIR))
         mkdirSync(HANDOFFS_DIR, { recursive: true });
@@ -78,7 +87,7 @@ export function registerSessionTools(server) {
             const staleThreshold = goal.reviewFrequency === 'daily' ? 1 : goal.reviewFrequency === 'weekly' ? 7 : 30;
             if (daysSinceUpdate > staleThreshold) {
                 const urgency = Math.min(5, Math.floor(daysSinceUpdate / staleThreshold) + (goal.priority === 'high' ? 2 : goal.priority === 'medium' ? 1 : 0));
-                items.push({ type: 'stale-goal', urgency, description: `Goal "${goal.title}" stale for ${daysSinceUpdate}d (${goal.priority} priority)` });
+                items.push({ type: 'stale-goal', id: goal.id, urgency, description: `Goal "${goal.title}" stale for ${daysSinceUpdate}d (${goal.priority} priority)` });
             }
         }
         // 2. Failing cron jobs
@@ -92,7 +101,7 @@ export function registerSessionTools(server) {
                     const errCount = consecutiveErrors === -1 ? recent.length : consecutiveErrors;
                     if (errCount >= 2) {
                         const jobName = recent[0]?.jobName ?? f.replace('.jsonl', '');
-                        items.push({ type: 'cron-failure', urgency: Math.min(5, errCount), description: `Job "${jobName}" has ${errCount} consecutive failures` });
+                        items.push({ type: 'cron-failure', id: jobName, urgency: Math.min(5, errCount), description: `Job "${jobName}" has ${errCount} consecutive failures` });
                     }
                 }
                 catch {
@@ -107,13 +116,13 @@ export function registerSessionTools(server) {
             const overdue = (content.match(/- \[ \].*?📅\s*(\d{4}-\d{2}-\d{2})/g) ?? [])
                 .filter(line => { const m = line.match(/📅\s*(\d{4}-\d{2}-\d{2})/); return m && m[1] < today; });
             if (overdue.length > 0)
-                items.push({ type: 'overdue-tasks', urgency: 4, description: `${overdue.length} overdue task(s) in TASKS.md` });
+                items.push({ type: 'overdue-tasks', id: 'tasks-overdue', urgency: 4, description: `${overdue.length} overdue task(s) in TASKS.md` });
         }
         // 4. Inbox items
         if (existsSync(INBOX_DIR)) {
             const inboxFiles = readdirSync(INBOX_DIR).filter(f => f.endsWith('.md') && !f.startsWith('_'));
             if (inboxFiles.length > 0)
-                items.push({ type: 'inbox', urgency: 2, description: `${inboxFiles.length} unprocessed inbox item(s)` });
+                items.push({ type: 'inbox', id: 'inbox', urgency: 2, description: `${inboxFiles.length} unprocessed inbox item(s)` });
         }
         // 5. Daily plan priorities
         const planFile = path.join(BASE_DIR, 'plans', 'daily', `${todayStr()}.json`);
@@ -123,7 +132,7 @@ export function registerSessionTools(server) {
                 for (const p of (plan.priorities ?? []).slice(0, 5)) {
                     const alreadyListed = items.some(i => i.description.includes(p.id) || i.description.includes(p.action?.slice(0, 20)));
                     if (!alreadyListed)
-                        items.push({ type: `plan-${p.type}`, urgency: p.urgency ?? 3, description: `[From daily plan] ${p.action}` });
+                        items.push({ type: `plan-${p.type}`, id: p.id, urgency: p.urgency ?? 3, description: `[From daily plan] ${p.action}` });
                 }
             }
             catch { /* non-fatal */ }
@@ -132,8 +141,56 @@ export function registerSessionTools(server) {
         const topItems = items.slice(0, maxItems);
         if (topItems.length === 0)
             return textResult('No work items discovered. All goals on track, no failures, inbox clear.');
-        const lines = topItems.map(i => `- [${i.type}] Urgency ${i.urgency}/5: ${i.description}`);
+        // Decisions here are advisory — the agent surveys, then chooses whether
+        // to act. We deliberately do NOT recordDecision: the autonomous paths
+        // (processInbox, daily-plan loop, goal advancement) record their own
+        // decisions when they actually act, so the ledger reflects committed
+        // decisions and proactive_stats stays signal-rich.
+        const lines = topItems.map((i) => {
+            const decision = decideDiscoveredWorkItem(i);
+            const label = ACTION_LABEL[decision.action];
+            return `- [${i.type}] Urgency ${i.urgency}/5 → ${label}: ${i.description}`;
+        });
         return textResult(`## Discovered Work Items (${topItems.length})\n${lines.join('\n')}`);
     });
+    server.tool('proactive_stats', 'Report how the proactive engine has been deciding and what those decisions led to. Use to tune urgency thresholds.', {
+        since_hours: z.number().optional().describe('Window in hours (default: 168 = 7 days)'),
+    }, async ({ since_hours }) => {
+        const windowMs = (since_hours ?? 168) * 60 * 60 * 1000;
+        const records = recentDecisions({ sinceMs: windowMs }, undefined);
+        if (records.length === 0)
+            return textResult('No proactive decisions recorded in window.');
+        const bySource = new Map();
+        const outcomeByKey = new Map();
+        for (const r of records) {
+            if (r.outcome)
+                outcomeByKey.set(r.decision.idempotencyKey, r.outcome.status);
+        }
+        for (const r of records) {
+            if (r.outcome)
+                continue;
+            const sourceMap = bySource.get(r.decision.source) ?? new Map();
+            const bucket = sourceMap.get(r.decision.action) ?? { decided: 0, outcomes: {} };
+            bucket.decided++;
+            const outcome = outcomeByKey.get(r.decision.idempotencyKey);
+            if (outcome)
+                bucket.outcomes[outcome] = (bucket.outcomes[outcome] ?? 0) + 1;
+            sourceMap.set(r.decision.action, bucket);
+            bySource.set(r.decision.source, sourceMap);
+        }
+        const lines = [`## Proactive Stats (last ${since_hours ?? 168}h, ${records.length} records)\n`];
+        for (const [source, actionMap] of bySource) {
+            lines.push(`### ${source}`);
+            for (const [action, bucket] of actionMap) {
+                const outcomes = Object.entries(bucket.outcomes);
+                const outcomeStr = outcomes.length === 0
+                    ? 'no outcomes recorded'
+                    : outcomes.map(([k, v]) => `${k}=${v}`).join(', ');
+                lines.push(`- ${ACTION_LABEL[action]} (${action}): decided ${bucket.decided}× → ${outcomeStr}`);
+            }
+            lines.push('');
+        }
+        return textResult(lines.join('\n'));
+    });
 }
 //# sourceMappingURL=session-tools.js.map

package/dist/types.d.ts

@@ -210,6 +210,7 @@ export interface HeartbeatWorkItem {
     description: string;
     prompt: string;
     source: string;
+    idempotencyKey?: string;
     priority: 'high' | 'normal';
     queuedAt: string;
     maxTurns: number;
@@ -220,6 +221,19 @@ export interface HeartbeatWorkItem {
     error?: string;
     agentSlug?: string;
 }
+/**
+ * State for one specialist agent's heartbeat scheduler. Persisted at
+ * ~/.clementine/heartbeat/agents/<slug>/state.json. Manager reads
+ * `nextCheckAt` to decide whether the agent is due for a tick.
+ */
+export interface AgentHeartbeatState {
+    slug: string;
+    lastTickAt: string;
+    nextCheckAt: string;
+    silentTickCount: number;
+    fingerprint: string;
+    lastSignalSummary?: string;
+}
 export interface CronJobDefinition {
     name: string;
     schedule: string;

package/package.json

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