clementine-agent 1.0.79 → 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/dist/cli/index.js

@@ -1074,10 +1074,16 @@ function cmdTools() {
 }
 // ── Program ──────────────────────────────────────────────────────────
 const program = new Command();
+let pkgVersion = '0.0.0';
+try {
+    const pkgRaw = readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf-8');
+    pkgVersion = String(JSON.parse(pkgRaw).version ?? '0.0.0');
+}
+catch { /* fall back to placeholder */ }
 program
     .name('clementine')
     .description('Clementine Personal AI Assistant')
-    .version('1.0.0');
+    .version(pkgVersion);
 program
     .command('launch')
     .description('Start the assistant (daemon by default)')
@@ -1609,11 +1615,46 @@ async function cmdUpdate(options) {
     console.log();
     console.log(`  ${DIM}Updating ${getAssistantName()}...${RESET}`);
     console.log();
-    // 1. Check we're in a git repo
-    if (!existsSync(path.join(PACKAGE_ROOT, '.git'))) {
-        console.error(`  ${RED}FAIL${RESET}  Package root is not a git repository: ${PACKAGE_ROOT}`);
-        console.error('  Update requires a git-cloned installation.');
-        process.exit(1);
+    // 1. Detect install flavor. Two valid paths:
+    //    - git-clone install (PACKAGE_ROOT has .git) → pull + rebuild path below
+    //    - npm-global install (no .git) → delegate to `npm install -g clementine-agent@latest`
+    const isGitInstall = existsSync(path.join(PACKAGE_ROOT, '.git'));
+    if (!isGitInstall) {
+        if (options.dryRun) {
+            console.log(`  ${DIM}[dry-run]${RESET}  Would run: npm install -g clementine-agent@latest`);
+            if (options.restart)
+                console.log(`  ${DIM}[dry-run]${RESET}  Would restart the daemon`);
+            return;
+        }
+        console.log(`  ${DIM}npm-global install detected at ${PACKAGE_ROOT}${RESET}`);
+        console.log(`  ${DIM}Running: npm install -g clementine-agent@latest${RESET}`);
+        console.log();
+        try {
+            execSync('npm install -g clementine-agent@latest', { stdio: 'inherit' });
+            console.log();
+            console.log(`  ${GREEN}OK${RESET}  Updated via npm`);
+        }
+        catch (err) {
+            console.error(`  ${RED}FAIL${RESET}  npm update failed: ${String(err).slice(0, 200)}`);
+            console.error(`  ${YELLOW}Hint${RESET}  If you see EACCES, see README "Troubleshooting" for npm prefix setup.`);
+            process.exit(1);
+        }
+        if (options.restart) {
+            try {
+                console.log(`  ${DIM}Restarting daemon...${RESET}`);
+                execSync('clementine restart', { stdio: 'inherit' });
+                console.log(`  ${GREEN}OK${RESET}  Daemon restarted`);
+            }
+            catch (err) {
+                console.error(`  ${YELLOW}WARN${RESET}  Restart failed: ${String(err).slice(0, 200)}. Run \`clementine restart\` manually.`);
+            }
+        }
+        else {
+            console.log();
+            console.log(`  ${DIM}Restart your daemon to pick up the new code:${RESET}`);
+            console.log(`    clementine restart`);
+        }
+        return;
     }
     let step = 0;
     const S = () => `[${++step}]`;
@@ -1643,11 +1684,16 @@ async function cmdUpdate(options) {
     try {
         const status = execSync('git status --porcelain', { cwd: PACKAGE_ROOT, encoding: 'utf-8' }).trim();
         if (status) {
-            console.log(`  ${S()} Stashing local changes...`);
-            const stashOut = execSync('git stash', { cwd: PACKAGE_ROOT, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-            didStash = !stashOut.includes('No local changes');
-            if (didStash) {
-                console.log(`  ${GREEN}OK${RESET}  Stashed local changes`);
+            if (options.dryRun) {
+                console.log(`  ${S()} Would stash local changes`);
+            }
+            else {
+                console.log(`  ${S()} Stashing local changes...`);
+                const stashOut = execSync('git stash', { cwd: PACKAGE_ROOT, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+                didStash = !stashOut.includes('No local changes');
+                if (didStash) {
+                    console.log(`  ${GREEN}OK${RESET}  Stashed local changes`);
+                }
             }
         }
     }
@@ -1688,15 +1734,18 @@ async function cmdUpdate(options) {
     const pid = readPid();
     const wasRunning = pid && isProcessAlive(pid);
     if (wasRunning) {
-        console.log(`  ${S()} Stopping daemon (PID ${pid})...`);
-        if (!options.dryRun) {
+        if (options.dryRun) {
+            console.log(`  ${S()} Would stop daemon (PID ${pid})`);
+        }
+        else {
+            console.log(`  ${S()} Stopping daemon (PID ${pid})...`);
             stopDaemon(pid);
             try {
                 unlinkSync(getPidFilePath());
             }
             catch { /* ignore */ }
+            console.log(`  ${GREEN}OK${RESET}  Daemon stopped`);
         }
-        console.log(`  ${GREEN}OK${RESET}  Daemon stopped`);
     }
     // Helper: if update fails after stopping daemon, relaunch before exiting
     function failAndRestart(backupDir) {

package/package.json

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