clementine-agent 1.0.80 → 1.0.81

package/README.md

@@ -556,7 +556,7 @@ Both paths trigger an automatic daemon restart when the new agent is detected.
 
 ### Agent configuration
 
-Each agent is defined by a YAML frontmatter file in `~/.clementine/agents/<slug>/agent.md`:
+Each agent is defined by a YAML frontmatter file in `~/.clementine/vault/00-System/agents/<slug>/agent.md`:
 
 | Field | Description |
 |-------|-------------|
@@ -585,6 +585,26 @@ The dashboard's "The Office" page shows each agent as an animated desk station w
 - Channel assignment, model badge, project badge, tool count
 - Edit and "Let Go" (delete) actions
 
+### Per-agent heartbeats
+
+Each specialist (Ross / Sasha / your hires) gets their own autonomous heartbeat scheduler alongside Clementine's. The cycle:
+
+1. **Cheap tick** every 30 min: load the agent's state, hash three signals (pending delegated tasks, latest goal update, latest cron run). If unchanged → silent tick, no LLM call, no cost.
+2. **LLM tick** when a signal *changes* between ticks (a delegated task arrived, a goal moved, a cron deliverable to review): the scheduler invokes `assistant.heartbeat()` with the agent's profile. Output flows through their dedicated Discord bot to their channel.
+3. **Self-adjusting cadence**: agents end their LLM-tick output with `[NEXT_CHECK: Xm]` to set when to check in next (5–720 min). Clamped at the bounds. Default 30m if omitted.
+
+State per agent at `~/.clementine/heartbeat/agents/<slug>/state.json`. Live observability via:
+
+```bash
+curl -H "X-Token: $(cat ~/.clementine/.dashboard-token)" \
+     http://localhost:3030/api/agent-heartbeats | jq
+```
+
+Routing rules — Clementine remains the master delegator:
+- Inbox triage runs as Clementine, but she'll hand off via `team_message` when an item clearly belongs to a specialist (she's allowed to guess).
+- Daily-plan goal-priorities owned by a specialist now fire goal-triggers (which run as the owner) instead of queueing as Clementine's work.
+- Goal advancement triggers route to `goal.owner` automatically.
+
 ---
 
 ## Scheduled tasks & cron jobs

package/dist/cli/dashboard.js

@@ -1049,6 +1049,55 @@ function getHeartbeat() {
         return {};
     }
 }
+/**
+ * Read per-agent heartbeat states from disk (one state.json per agent
+ * under ~/.clementine/heartbeat/agents/<slug>/). Returns an array sorted
+ * by next-due-soonest, with relative-time strings convenient for UI use.
+ */
+function getAgentHeartbeats() {
+    const agentsRoot = path.join(BASE_DIR, 'heartbeat', 'agents');
+    if (!existsSync(agentsRoot))
+        return [];
+    const out = [];
+    let dirs = [];
+    try {
+        dirs = readdirSync(agentsRoot, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    catch {
+        return [];
+    }
+    const now = Date.now();
+    for (const slug of dirs) {
+        const stateFile = path.join(agentsRoot, slug, 'state.json');
+        if (!existsSync(stateFile))
+            continue;
+        try {
+            const state = JSON.parse(readFileSync(stateFile, 'utf-8'));
+            const lastTickMs = state.lastTickAt ? new Date(String(state.lastTickAt)).getTime() : 0;
+            const nextCheckMs = state.nextCheckAt ? new Date(String(state.nextCheckAt)).getTime() : 0;
+            out.push({
+                slug,
+                lastTickAt: state.lastTickAt ?? null,
+                nextCheckAt: state.nextCheckAt ?? null,
+                silentTickCount: Number(state.silentTickCount ?? 0),
+                fingerprint: state.fingerprint ?? '',
+                lastSignalSummary: state.lastSignalSummary ?? null,
+                lastTickAgoMs: lastTickMs ? now - lastTickMs : null,
+                nextCheckInMs: nextCheckMs ? nextCheckMs - now : null,
+                isDue: nextCheckMs > 0 && nextCheckMs <= now,
+            });
+        }
+        catch { /* skip malformed */ }
+    }
+    out.sort((a, b) => {
+        const ai = typeof a.nextCheckInMs === 'number' ? a.nextCheckInMs : Number.MAX_SAFE_INTEGER;
+        const bi = typeof b.nextCheckInMs === 'number' ? b.nextCheckInMs : Number.MAX_SAFE_INTEGER;
+        return ai - bi;
+    });
+    return out;
+}
 async function getMemory() {
     const memoryFile = path.join(VAULT_DIR, '00-System', 'MEMORY.md');
     let content = '';
@@ -1925,6 +1974,9 @@ export async function cmdDashboard(opts) {
     app.get('/api/heartbeat', (_req, res) => {
         res.json(getHeartbeat());
     });
+    app.get('/api/agent-heartbeats', (_req, res) => {
+        res.json(getAgentHeartbeats());
+    });
     app.get('/api/heartbeat/agent/:slug', (req, res) => {
         const slug = req.params.slug;
         const state = getHeartbeat();

package/package.json

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