Add linting, formatting, changelog, badges, and engines field

Author: KryptosAI

.eslintrc.json

@@ -0,0 +1,25 @@
+{
+  "env": { "node": true, "es2022": true },
+  "extends": "eslint:recommended",
+  "rules": {
+    "no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "no-undef": "error",
+    "semi": ["error", "always"],
+    "quotes": ["error", "single", { "avoidEscape": true }],
+    "comma-dangle": ["error", "always-multiline"],
+    "no-console": "off"
+  },
+  "overrides": [
+    {
+      "files": ["test.js"],
+      "rules": {
+        "no-empty": "off",
+        "no-unused-vars": "off"
+      }
+    },
+    {
+      "files": ["scripts/**/*.mjs"],
+      "parserOptions": { "sourceType": "module" }
+    }
+  ]
+}

.prettierignore

@@ -0,0 +1,7 @@
+node_modules/
+.agent-observability/
+*.db
+*.db-wal
+*.db-shm
+.env
+.eslintcache

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2
+}

CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+## v1.0.7 — 2026-07-24
+
+- Add `mcpName` and `server.json` for MCP Registry publication
+
+## v1.0.6 — 2026-07-23
+
+- Expand npm keywords for better discoverability
+- Keyword-rich package description
+
+## v1.0.5 — 2026-07-22
+
+- Fix database path to `~/.agent-observability`
+- Add postinstall hook for zero-touch onboarding
+
+## v1.0.4 — 2026-07-21
+
+- Fix `demo --port` flag
+- Setup command creates config files for users without a detected agent
+
+## v1.0.3 — 2026-07-20
+
+- Pre-loaded demo session showing a real agent trace
+- Auto-open browser on dashboard start
+- Polished empty state for no sessions
+
+## v1.0.2 — 2026-07-19
+
+- Zero-friction onboarding with `agent-obs setup`
+- Auto-detects opencode, Claude Code, and Cursor
+- Configures MCP automatically — no manual editing needed
+
+## v1.0.1 — 2026-07-18
+
+- Automatic self-reporting via MCP server
+- Session cleanup for stale sessions (>1 hour idle)
+- Claude Code and Cursor integration docs
+- Proxy mode deprecated in favor of native MCP self-reporting
+
+## v1.0.0 — 2026-07-17
+
+- First major release
+- Self-reporting protocol: start_session, log_tool_call, end_session
+- Integration docs for opencode, Claude Code, Cursor
+- CLI: `check`, `stats`, `inspect` commands
+- 6 MCP tools: start_session, log_tool_call, end_session, get_last_session, check_session, get_session_stats
+- Local dashboard at localhost:9400
+- SQLite storage in `~/.agent-observability/`

README.md

@@ -1,5 +1,9 @@
 # agent-observability
 
+[![CI](https://github.com/KryptosAI/agent-observability/actions/workflows/ci.yml/badge.svg)](https://github.com/KryptosAI/agent-observability/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/agent-obs)](https://www.npmjs.com/package/agent-obs)
+[![license](https://img.shields.io/npm/l/agent-obs)](./LICENSE)
+
 > Open source agent observability — see what your agents did, why they failed, and what it cost. Runs locally. No cloud required.
 
 ## Quick Start

cli.js

@@ -176,7 +176,7 @@ async function main() {
           config.mcp['agent-obs'] = {
             type: 'local',
             command: ['npx', '-y', 'agent-obs@latest', 'server'],
-            enabled: true
+            enabled: true,
           };
           fs.writeFileSync(opencodeJson, JSON.stringify(config, null, 2) + '\n');
           actions.push('opencode.json updated (agent-obs MCP server added)');
@@ -211,13 +211,13 @@ async function main() {
       const target = mcpJson;
       let mcpConfig = {};
       if (fs.existsSync(target)) {
-        try { mcpConfig = JSON.parse(fs.readFileSync(target, 'utf8')); } catch(e) {}
+        try { mcpConfig = JSON.parse(fs.readFileSync(target, 'utf8')); } catch (_) { /* use empty default */ }
       }
       if (!mcpConfig.mcpServers) mcpConfig.mcpServers = {};
       if (!mcpConfig.mcpServers['agent-obs']) {
         mcpConfig.mcpServers['agent-obs'] = {
           command: 'npx',
-          args: ['-y', 'agent-obs@latest', 'server']
+          args: ['-y', 'agent-obs@latest', 'server'],
         };
         fs.writeFileSync(target, JSON.stringify(mcpConfig, null, 2) + '\n');
         actions.push('.mcp.json created (agent-obs MCP server configured)');
@@ -366,7 +366,7 @@ Never skip log_tool_call — every tool call must be logged.\n`);
   if (command === 'demo') {
     const portIdx = args.indexOf('--port');
     const port = portIdx >= 0 ? parseInt(args[portIdx + 1]) : 9400;
-    const { seedDemoSession, getSessions } = require('./database');
+    const { seedDemoSession } = require('./database');
     seedDemoSession();
     printSummary();
     console.log('Demo session loaded — showing a real agent trace');
@@ -383,15 +383,14 @@ Never skip log_tool_call — every tool call must be logged.\n`);
       process.exit(1);
     }
 
-    const { getSession, getToolCalls, getDecisions } = require('./database');
+    const { getSession, getToolCalls } = require('./database');
     const session = getSession(sessionId);
     if (!session) {
       console.error('Session not found');
       process.exit(1);
     }
 
     const calls = getToolCalls(session.id);
-    const decisions = getDecisions(session.id);
 
     console.log(`\n  Session: ${session.id}`);
     console.log(`  Agent:   ${session.agent_type}`);

database.js

@@ -123,7 +123,7 @@ function initSchema() {
 function createSession({ agentType, model, taskDescription }) {
   const db = getDb();
   const id = uuidv4();
-  db.prepare(`INSERT INTO sessions (id, agent_type, model, task_description) VALUES (?, ?, ?, ?)`)
+  db.prepare('INSERT INTO sessions (id, agent_type, model, task_description) VALUES (?, ?, ?, ?)')
     .run(id, agentType || 'unknown', model || null, taskDescription || null);
   return { id, agentType, model };
 }
@@ -243,7 +243,7 @@ function getLatestHealthChecks() {
 
 function getHealthHistory(toolServer, limit = 20) {
   return getDb().prepare(
-    'SELECT * FROM tool_health_checks WHERE tool_server = ? ORDER BY checked_at DESC LIMIT ?'
+    'SELECT * FROM tool_health_checks WHERE tool_server = ? ORDER BY checked_at DESC LIMIT ?',
   ).all(toolServer, limit);
 }
 
@@ -256,7 +256,7 @@ function getDashboardStats() {
   const failedSessions = db.prepare("SELECT COUNT(*) as c FROM sessions WHERE status IN ('error', 'failed')").get().c;
   const totalToolCalls = db.prepare('SELECT COUNT(*) as c FROM tool_calls').get().c;
   const avgDuration = db.prepare(
-    "SELECT AVG((julianday(ended_at) - julianday(started_at)) * 86400) as avg FROM sessions WHERE ended_at IS NOT NULL"
+    'SELECT AVG((julianday(ended_at) - julianday(started_at)) * 86400) as avg FROM sessions WHERE ended_at IS NOT NULL',
   ).get().avg || 0;
   const totalCost = db.prepare('SELECT SUM(estimated_cost_usd) as c FROM sessions').get().c || 0;
   const totalTokens = db.prepare('SELECT SUM(total_tokens) as c FROM sessions').get().c || 0;
@@ -275,7 +275,7 @@ function estimateCost(totalTokens) {
   return Math.round((totalTokens / 1000000) * 3 * 10000) / 10000;
 }
 
-function computeGrade({ errorCount, totalCalls, durationMs }) {
+function computeGrade({ errorCount, totalCalls }) {
   if (totalCalls === 0) return { grade: 'N/A', score: 0 };
   const errorRate = errorCount / totalCalls;
   if (errorRate === 0) return { grade: 'A', score: 95 };
@@ -301,7 +301,7 @@ function closeStaleSessions() {
     endSession(s.id, { 
       status: 'timeout', 
       errorMessage: 'Auto-closed: no activity for over 1 hour',
-      grade: grade.grade
+      grade: grade.grade,
     });
   }
   return stale.length;
@@ -337,9 +337,9 @@ function seedDemoSession() {
     { name: 'Edit', server: 'filesystem', step: 12, status: 'success', duration: 22, input: '{"filePath":"/src/auth.ts","oldString":"console.log(expiry)","newString":""}', output: '{"applied":true}', summary: 'Removed debug console.log from auth.ts' },
   ];
 
-  const insertCall = db.prepare(`INSERT INTO tool_calls (id, session_id, tool_name, tool_server, step_number, input_json, output_json, output_summary, duration_ms, status, error_message, timestamp) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
-  const insertDecision = db.prepare(`INSERT INTO decision_points (id, session_id, step_number, chosen_action, rationale, timestamp) VALUES (?, ?, ?, ?, ?, ?)`);
-  const insertAudit = db.prepare(`INSERT INTO audit_entries (id, session_id, event_type, actor, resource_accessed, outcome, timestamp) VALUES (?, ?, ?, ?, ?, ?, ?)`);
+  const insertCall = db.prepare('INSERT INTO tool_calls (id, session_id, tool_name, tool_server, step_number, input_json, output_json, output_summary, duration_ms, status, error_message, timestamp) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)');
+  const insertDecision = db.prepare('INSERT INTO decision_points (id, session_id, step_number, chosen_action, rationale, timestamp) VALUES (?, ?, ?, ?, ?, ?)');
+  const insertAudit = db.prepare('INSERT INTO audit_entries (id, session_id, event_type, actor, resource_accessed, outcome, timestamp) VALUES (?, ?, ?, ?, ?, ?, ?)');
 
   const tx = db.transaction(() => {
     for (const t of tools) {

mcp-server.js

@@ -120,20 +120,20 @@ function sendToolResult(id, data) {
   });
 }
 
-function handleInitialize(id, params) {
+function handleInitialize(id, _params) {
   log('Received initialize request');
   sendResponse(id, {
     protocolVersion: '2024-11-05',
     serverInfo: SERVER_INFO,
     capabilities: CAPABILITIES,
-    instructions: "After every tool call (Read, Write, Edit, Bash, Glob, Grep, or any MCP tool), you MUST call log_tool_call on the agent-obs server with: toolName, status (success/error), outputSummary, and durationMs. Never skip a call — even fast operations. Start a session with start_session at task start. End it with end_session when done. The only tools you do NOT log are the agent-obs tools themselves.",
+    instructions: 'After every tool call (Read, Write, Edit, Bash, Glob, Grep, or any MCP tool), you MUST call log_tool_call on the agent-obs server with: toolName, status (success/error), outputSummary, and durationMs. Never skip a call — even fast operations. Start a session with start_session at task start. End it with end_session when done. The only tools you do NOT log are the agent-obs tools themselves.',
   });
 }
 
 function handleToolsList(id) {
   sendResponse(id, { 
     tools: TOOLS,
-    instructions: "After every tool call (Read, Write, Edit, Bash, Glob, Grep, or any MCP tool), you MUST call log_tool_call on the agent-obs server with: toolName, status (success/error), outputSummary, and durationMs. Never skip a call — even fast operations. Start a session with start_session at task start. End it with end_session when done. The only tools you do NOT log are the agent-obs tools themselves."
+    instructions: 'After every tool call (Read, Write, Edit, Bash, Glob, Grep, or any MCP tool), you MUST call log_tool_call on the agent-obs server with: toolName, status (success/error), outputSummary, and durationMs. Never skip a call — even fast operations. Start a session with start_session at task start. End it with end_session when done. The only tools you do NOT log are the agent-obs tools themselves.',
   });
 }
 
@@ -282,7 +282,7 @@ function handleToolsCall(id, params) {
         const stats = database.getDashboardStats();
         const sessions = database.getSessions({ limit: 1000 });
         const grades = { A: 0, B: 0, C: 0, D: 0, F: 0 };
-        sessions.forEach(s => { if (s.grade && grades.hasOwnProperty(s.grade)) grades[s.grade]++; });
+        sessions.forEach(s => { if (s.grade && Object.hasOwn(grades, s.grade)) grades[s.grade]++; });
 
         sendToolResult(id, {
           ...stats,