brainclaw 0.21.0 → 0.22.0

package/dist/commands/session-start.js

@@ -11,6 +11,7 @@ import { nowISO, generateId } from '../core/ids.js';
 import { appendAuditEntry } from '../core/audit.js';
 import { SessionSnapshotSchema } from '../core/schema.js';
 import { auditLocalAgentWorkspaceFiles } from '../core/agent-files.js';
+import { buildAgentInventory, loadAgentInventory, saveAgentInventory, diffInventory } from '../core/agent-inventory.js';
 function sessionsDir(cwd) {
     return resolveEntityDir('sessions', cwd ?? process.cwd(), 'read');
 }
@@ -47,6 +48,11 @@ export function runSessionStart(options = {}) {
                 console.warn('  After fixing .gitignore, untrack them with `git rm --cached <path>` as needed.');
             }
         }
+        if (snapshot.inventory_advisory) {
+            for (const line of snapshot.inventory_advisory) {
+                console.warn(`⚠ ${line}`);
+            }
+        }
     }
     catch (e) {
         console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
@@ -121,6 +127,25 @@ export function startSession(options = {}) {
     }, options.cwd);
     appendAuditEntry({ action: 'session_start', actor: actor.agent, actor_id: actor.agent_id, item_id: snapshot.session_id, item_type: 'session' }, options.cwd);
     const agentGitHygiene = auditLocalAgentWorkspaceFiles(options.cwd ?? process.cwd());
+    // Inventory reconciliation — detect new/disappeared agents on this machine
+    let inventoryAdvisory;
+    try {
+        const previousInventory = loadAgentInventory();
+        const currentInventory = buildAgentInventory();
+        const diff = diffInventory(previousInventory, currentInventory);
+        saveAgentInventory(currentInventory);
+        const lines = [];
+        if (diff.appeared.length > 0)
+            lines.push(`New agents detected: ${diff.appeared.join(', ')}`);
+        if (diff.disappeared.length > 0)
+            lines.push(`Agents no longer detected: ${diff.disappeared.join(', ')}`);
+        for (const vc of diff.version_changed) {
+            lines.push(`${vc.name} version changed: ${vc.from ?? '?'} → ${vc.to ?? '?'}`);
+        }
+        if (lines.length > 0)
+            inventoryAdvisory = lines;
+    }
+    catch { /* non-fatal — inventory scan failure should not block session start */ }
     return {
         ...snapshot,
         ...(agentGitHygiene.isGitRepo && (agentGitHygiene.missingGitignorePaths.length > 0 || agentGitHygiene.trackedPaths.length > 0)
@@ -131,6 +156,7 @@ export function startSession(options = {}) {
                 },
             }
             : {}),
+        ...(inventoryAdvisory ? { inventory_advisory: inventoryAdvisory } : {}),
     };
 }
 export function loadSessionSnapshot(sessionId, cwd) {

package/dist/core/agent-inventory.js

@@ -398,4 +398,32 @@ export function renderAgentInventorySummary(inventory) {
     lines.push(`Inventory generated: ${inventory.generated_at}`);
     return lines.join('\n');
 }
+/**
+ * Compare two agent inventories and return what changed.
+ * Only considers agents that are `installed` in either snapshot.
+ */
+export function diffInventory(previous, current) {
+    const prevMap = new Map((previous?.agents ?? []).filter(a => a.installed).map(a => [a.name, a]));
+    const currMap = new Map(current.agents.filter(a => a.installed).map(a => [a.name, a]));
+    const appeared = [];
+    const disappeared = [];
+    const version_changed = [];
+    for (const [name, entry] of currMap) {
+        if (!prevMap.has(name)) {
+            appeared.push(name);
+        }
+        else {
+            const prev = prevMap.get(name);
+            if (prev.version !== entry.version && (prev.version || entry.version)) {
+                version_changed.push({ name, from: prev.version, to: entry.version });
+            }
+        }
+    }
+    for (const name of prevMap.keys()) {
+        if (!currMap.has(name)) {
+            disappeared.push(name);
+        }
+    }
+    return { appeared, disappeared, version_changed };
+}
 //# sourceMappingURL=agent-inventory.js.map

package/dist/core/agent-registry.js

@@ -2,6 +2,7 @@ import crypto from 'node:crypto';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { detectAiAgent } from './ai-agent-detection.js';
 import { loadConfig, saveConfig } from './config.js';
 import { nowISO } from './ids.js';
 import { MEMORY_DIR, resolveEntityDir } from './io.js';
@@ -205,6 +206,15 @@ export function resolveCurrentAgentIdentity(cwd, preferredDirName) {
         if (byEnvName)
             return byEnvName;
     }
+    // Auto-detect from native agent env vars (e.g. CLAUDECODE, CURSOR_TRACE_ID).
+    // Falls through to config if the detected agent is not registered.
+    const detected = detectAiAgent();
+    if (detected) {
+        const byDetected = findAgentIdentityByName(detected.name, cwd, preferredDirName);
+        if (byDetected)
+            return byDetected;
+    }
+    // Config fallback (last resort — may not reflect the actual calling agent)
     const config = loadConfig(cwd, preferredDirName);
     if (config.current_agent_id) {
         const byId = findAgentIdentityById(config.current_agent_id, cwd, preferredDirName);

package/dist/core/ai-agent-detection.js

@@ -32,13 +32,17 @@ export function detectAiAgent(env = process.env, homeDir = os.homedir()) {
         };
     }
     // Claude Code — tested BEFORE Copilot because both can be present in VS Code.
-    // CLAUDE_CODE_VERSION is set by Claude Code itself, not by VS Code passively.
-    if (env.CLAUDE_CODE_VERSION || env.ANTHROPIC_AI_PRODUCT === 'claude-code') {
+    // CLAUDE_CODE_VERSION is set by Claude Code CLI; CLAUDECODE is set by the VS Code extension.
+    if (env.CLAUDE_CODE_VERSION || env.CLAUDECODE || env.ANTHROPIC_AI_PRODUCT === 'claude-code') {
         return {
             name: 'claude-code',
             kind: 'agent',
             trust_level: 'trusted',
-            detection_source: env.CLAUDE_CODE_VERSION ? 'CLAUDE_CODE_VERSION env var' : 'ANTHROPIC_AI_PRODUCT env var',
+            detection_source: env.CLAUDE_CODE_VERSION
+                ? 'CLAUDE_CODE_VERSION env var'
+                : env.CLAUDECODE
+                    ? 'CLAUDECODE env var'
+                    : 'ANTHROPIC_AI_PRODUCT env var',
         };
     }
     // Cursor IDE
@@ -73,7 +77,7 @@ export function detectAiAgent(env = process.env, homeDir = os.homedir()) {
     // whenever the Copilot extension is installed, even when another agent is active.
     // We only match if no higher-priority agent was detected above.
     if (env.GITHUB_COPILOT_PRODUCT ||
-        (env.GITHUB_COPILOT_TOKEN && !env.CLAUDE_CODE_VERSION && !env.CURSOR_TRACE_ID && !env.WINDSURF_SESSION_ID) ||
+        (env.GITHUB_COPILOT_TOKEN && !env.CLAUDE_CODE_VERSION && !env.CLAUDECODE && !env.CURSOR_TRACE_ID && !env.WINDSURF_SESSION_ID) ||
         (env.VSCODE_GIT_IPC_HANDLE && (env.AGENT_NAME?.toLowerCase().includes('copilot') || env.GH_COPILOT_AGENT))) {
         return {
             name: 'github-copilot',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainclaw",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Shared project memory for humans and coding agents.",
   "type": "module",
   "bin": {