agentacta 1.1.4 → 1.2.0

package/README.md

@@ -108,7 +108,8 @@ On first run, AgentActa creates a config file with sensible defaults at `~/.conf
   "port": 4003,
   "storage": "reference",
   "sessionsPath": null,
-  "dbPath": "./agentacta.db"
+  "dbPath": "./agentacta.db",
+  "projectAliases": {}
 }
 ```
 
@@ -126,6 +127,7 @@ On first run, AgentActa creates a config file with sensible defaults at `~/.conf
 | `AGENTACTA_SESSIONS_PATH` | Auto-detected | Custom sessions directory |
 | `AGENTACTA_DB_PATH` | `./agentacta.db` | Database file location |
 | `AGENTACTA_STORAGE` | `reference` | Storage mode (`reference` or `archive`) |
+| `AGENTACTA_PROJECT_ALIASES_JSON` | unset | JSON object mapping inferred project names (e.g. `{"old-name":"new-name"}`) |
 
 ## API
 

package/config.js

@@ -18,7 +18,8 @@ const DEFAULTS = {
   port: 4003,
   storage: 'reference',
   sessionsPath: null,
-  dbPath: './agentacta.db'
+  dbPath: './agentacta.db',
+  projectAliases: {}
 };
 
 function loadConfig() {
@@ -45,9 +46,17 @@ function loadConfig() {
   if (process.env.AGENTACTA_STORAGE) config.storage = process.env.AGENTACTA_STORAGE;
   if (process.env.AGENTACTA_SESSIONS_PATH) config.sessionsPath = process.env.AGENTACTA_SESSIONS_PATH;
   if (process.env.AGENTACTA_DB_PATH) config.dbPath = process.env.AGENTACTA_DB_PATH;
+  if (process.env.AGENTACTA_PROJECT_ALIASES_JSON) {
+    try {
+      config.projectAliases = JSON.parse(process.env.AGENTACTA_PROJECT_ALIASES_JSON);
+    } catch (err) {
+      console.error('Warning: Could not parse AGENTACTA_PROJECT_ALIASES_JSON:', err.message);
+    }
+  }
 
   // Resolve dbPath relative to cwd
   config.dbPath = path.resolve(config.dbPath);
+  if (!config.projectAliases || typeof config.projectAliases !== 'object') config.projectAliases = {};
 
   return config;
 }

package/index.js

@@ -97,6 +97,31 @@ function getDbSize() {
   }
 }
 
+function normalizeAgentLabel(agent) {
+  if (!agent) return agent;
+  if (agent === 'main') return 'openclaw-main';
+  if (agent.startsWith('claude-') || agent.startsWith('claude--')) return 'claude-code';
+  return agent;
+}
+
+function looksLikeSessionId(q) {
+  const s = (q || '').trim();
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(s);
+}
+
+function toFtsQuery(q) {
+  const s = (q || '').trim();
+  if (!s) return '';
+  // Quote each token so dashes and punctuation don't break FTS parsing.
+  // Example: abc-def -> "abc-def"
+  const tokens = s.match(/"[^"]+"|\S+/g) || [];
+  return tokens
+    .map(t => t.replace(/^"|"$/g, '').replace(/"/g, '""'))
+    .filter(Boolean)
+    .map(t => `"${t}"`)
+    .join(' AND ');
+}
+
 // Init DB and start watcher
 init();
 const db = open();
@@ -197,7 +222,11 @@ const server = http.createServer((req, res) => {
       const tools = db.prepare("SELECT DISTINCT tool_name FROM events WHERE tool_name IS NOT NULL").all().map(r => r.tool_name);
       const dateRange = db.prepare('SELECT MIN(start_time) as earliest, MAX(start_time) as latest FROM sessions').get();
       const costData = db.prepare('SELECT SUM(total_cost) as cost, SUM(total_tokens) as tokens FROM sessions').get();
-      const agents = db.prepare('SELECT DISTINCT agent FROM sessions WHERE agent IS NOT NULL').all().map(r => r.agent);
+      const agents = [...new Set(
+        db.prepare('SELECT DISTINCT agent FROM sessions WHERE agent IS NOT NULL').all()
+          .map(r => normalizeAgentLabel(r.agent))
+          .filter(Boolean)
+      )];
       const dbSize = getDbSize();
       json(res, { sessions, events, messages, toolCalls, uniqueTools: tools.length, tools, dateRange, totalCost: costData.cost || 0, totalTokens: costData.tokens || 0, agents, storageMode: config.storage, dbSize, sessionDirs: sessionDirs.map(d => ({ path: d.path, agent: d.agent })) });
     }
@@ -256,7 +285,12 @@ const server = http.createServer((req, res) => {
       if (!q) { json(res, { error: 'No query' }, 400); return; }
       let results;
       try {
-        results = db.prepare(`SELECT e.*, s.start_time as session_start, s.summary as session_summary FROM events_fts fts JOIN events e ON e.rowid = fts.rowid JOIN sessions s ON s.id = e.session_id WHERE events_fts MATCH ? ORDER BY e.timestamp DESC LIMIT 200`).all(q);
+        if (looksLikeSessionId(q)) {
+          results = db.prepare(`SELECT e.*, s.start_time as session_start, s.summary as session_summary FROM events e JOIN sessions s ON s.id = e.session_id WHERE e.session_id = ? ORDER BY e.timestamp DESC LIMIT 200`).all(q.trim());
+        } else {
+          const ftsQuery = toFtsQuery(q);
+          results = db.prepare(`SELECT e.*, s.start_time as session_start, s.summary as session_summary FROM events_fts fts JOIN events e ON e.rowid = fts.rowid JOIN sessions s ON s.id = e.session_id WHERE events_fts MATCH ? ORDER BY e.timestamp DESC LIMIT 200`).all(ftsQuery);
+        }
       } catch (err) { json(res, { error: 'Invalid search query' }, 400); return; }
       if (format === 'md') {
         let md = `# Search Results: "${q}"\n\n${results.length} results\n\n`;
@@ -280,18 +314,32 @@ const server = http.createServer((req, res) => {
 
       if (!q) { json(res, { results: [], total: 0 }); }
       else {
-        let sql = `SELECT e.*, s.start_time as session_start, s.summary as session_summary
-                    FROM events_fts fts
-                    JOIN events e ON e.rowid = fts.rowid
-                    JOIN sessions s ON s.id = e.session_id
-                    WHERE events_fts MATCH ?`;
-        const params = [q];
+        const isSessionLookup = looksLikeSessionId(q);
+        let sql;
+        const params = [];
+
+        if (isSessionLookup) {
+          sql = `SELECT e.*, s.start_time as session_start, s.summary as session_summary
+                 FROM events e
+                 JOIN sessions s ON s.id = e.session_id
+                 WHERE e.session_id = ?`;
+          params.push(q.trim());
+        } else {
+          sql = `SELECT e.*, s.start_time as session_start, s.summary as session_summary
+                 FROM events_fts fts
+                 JOIN events e ON e.rowid = fts.rowid
+                 JOIN sessions s ON s.id = e.session_id
+                 WHERE events_fts MATCH ?`;
+          params.push(toFtsQuery(q));
+        }
+
         if (type) { sql += ` AND e.type = ?`; params.push(type); }
         if (role) { sql += ` AND e.role = ?`; params.push(role); }
         if (from) { sql += ` AND e.timestamp >= ?`; params.push(from); }
         if (to) { sql += ` AND e.timestamp <= ?`; params.push(to); }
         sql += ` ORDER BY e.timestamp DESC LIMIT ?`;
         params.push(limit);
+
         try {
           const results = db.prepare(sql).all(...params);
           json(res, { results, total: results.length });

package/indexer.js

@@ -38,12 +38,12 @@ function discoverSessionDirs(config) {
       // Claude Code: JSONL files directly in project dir
       if (fs.existsSync(projDir) && fs.statSync(projDir).isDirectory()) {
         const hasJsonl = fs.readdirSync(projDir).some(f => f.endsWith('.jsonl'));
-        if (hasJsonl) dirs.push({ path: projDir, agent: `claude-${proj}` });
+        if (hasJsonl) dirs.push({ path: projDir, agent: 'claude-code' });
       }
       // Also check sessions/ subdirectory (future-proofing)
       const sp = path.join(projDir, 'sessions');
       if (fs.existsSync(sp) && fs.statSync(sp).isDirectory()) {
-        dirs.push({ path: sp, agent: `claude-${proj}` });
+        dirs.push({ path: sp, agent: 'claude-code' });
       }
     }
   }
@@ -107,13 +107,19 @@ function extractFilePaths(toolName, toolArgs) {
   return paths;
 }
 
-function extractProjectFromPath(filePath) {
+function aliasProject(project, config) {
+  if (!project) return project;
+  const aliases = (config && config.projectAliases && typeof config.projectAliases === 'object') ? config.projectAliases : {};
+  return aliases[project] || project;
+}
+
+function extractProjectFromPath(filePath, config) {
   if (!filePath || typeof filePath !== 'string') return null;
 
   const normalized = filePath.replace(/\\/g, '/');
 
   // Relative paths are usually from workspace cwd -> treat as workspace activity
-  if (!normalized.startsWith('/') && !normalized.startsWith('~')) return 'workspace';
+  if (!normalized.startsWith('/') && !normalized.startsWith('~')) return aliasProject('workspace', config);
 
   let rel = normalized
     .replace(/^\/home\/[^/]+\//, '')
@@ -124,22 +130,22 @@ function extractProjectFromPath(filePath) {
   if (!parts.length) return null;
 
   // Common repo location: ~/Developer/<repo>/...
-  if (parts[0] === 'Developer' && parts[1]) return parts[1];
+  if (parts[0] === 'Developer' && parts[1]) return aliasProject(parts[1], config);
 
   // OpenClaw workspace and agent stores
-  if (parts[0] === '.openclaw' && parts[1] === 'workspace') return 'workspace';
-  if (parts[0] === '.openclaw' && parts[1] === 'agents' && parts[2]) return `agent:${parts[2]}`;
+  if (parts[0] === '.openclaw' && parts[1] === 'workspace') return aliasProject('workspace', config);
+  if (parts[0] === '.openclaw' && parts[1] === 'agents' && parts[2]) return aliasProject(`agent:${parts[2]}`, config);
 
   // Claude Code projects
-  if (parts[0] === '.claude' && parts[1] === 'projects' && parts[2]) return `claude:${parts[2]}`;
+  if (parts[0] === '.claude' && parts[1] === 'projects' && parts[2]) return aliasProject(`claude:${parts[2]}`, config);
 
   // Shared files area
-  if (parts[0] === 'Shared') return 'shared';
+  if (parts[0] === 'Shared') return aliasProject('shared', config);
 
   return null;
 }
 
-function indexFile(db, filePath, agentName, stmts, archiveMode) {
+function indexFile(db, filePath, agentName, stmts, archiveMode, config) {
   const stat = fs.statSync(filePath);
   const mtime = stat.mtime.toISOString();
 
@@ -312,7 +318,7 @@ function indexFile(db, filePath, agentName, stmts, archiveMode) {
             : 'read';
           fileActivities.push([sessionId, fp, op, ts]);
 
-          const project = extractProjectFromPath(fp);
+          const project = extractProjectFromPath(fp, config);
           if (project) projectCounts.set(project, (projectCounts.get(project) || 0) + 1);
         }
       }
@@ -391,7 +397,7 @@ function run() {
   const indexMany = db.transaction(() => {
     let indexed = 0;
     for (const f of allFiles) {
-      const result = indexFile(db, f.path, f.agent, stmts, archiveMode);
+      const result = indexFile(db, f.path, f.agent, stmts, archiveMode, config);
       if (!result.skipped) {
         indexed++;
         if (indexed % 10 === 0) process.stdout.write('.');
@@ -416,7 +422,7 @@ function run() {
         if (!fs.existsSync(filePath)) return;
         setTimeout(() => {
           try {
-            const result = indexFile(db, filePath, dir.agent, stmts, archiveMode);
+            const result = indexFile(db, filePath, dir.agent, stmts, archiveMode, config);
             if (!result.skipped) console.log(`Re-indexed: ${filename} (${dir.agent})`);
           } catch (err) {
             console.error(`Error re-indexing ${filename}:`, err.message);
@@ -437,7 +443,7 @@ function indexAll(db, config) {
   for (const dir of sessionDirs) {
     const files = fs.readdirSync(dir.path).filter(f => f.endsWith('.jsonl'));
     for (const file of files) {
-      const result = indexFile(db, path.join(dir.path, file), dir.agent, stmts, archiveMode);
+      const result = indexFile(db, path.join(dir.path, file), dir.agent, stmts, archiveMode, config);
       if (!result.skipped) totalSessions++;
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentacta",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "Audit trail and search engine for AI agent sessions",
   "main": "index.js",
   "bin": {