@jigyasudham/veto 1.2.0 → 1.2.2

package/README.md

@@ -1,8 +1,8 @@
 # veto
 
-> **50 agents. 34 tools. 3 AIs. Self-learning. Zero extra cost.**
+> **50 agents. 41 tools. 3 AIs. Self-learning. Zero extra cost.**
 
-An MCP server that runs locally on your machine, plugs into Claude Code, Codex CLI, and Gemini CLI using your existing subscriptions — giving every AI a council of specialist agents, persistent cross-platform memory, a self-learning router, reactive file watching, sequential agent pipelines, and the ability to say no to bad decisions.
+An MCP server that runs locally on your machine, plugs into Claude Code, Codex CLI, and Gemini CLI using your existing subscriptions — giving every AI a council of specialist agents, persistent cross-platform memory, a self-learning router, live usage tracking, CI/CD pipeline gates, live documentation fetching, and the ability to say no to bad decisions.
 
 ---
 
@@ -116,7 +116,7 @@ VS Code uses `"servers"` with `"type": "stdio"`:
 
 ---
 
-## MCP Tools (34)
+## MCP Tools (41)
 
 | Category | Tools |
 |---|---|
@@ -130,6 +130,9 @@ VS Code uses `"servers"` with `"type": "stdio"`:
 | **Memory** | `veto_memory_store` · `veto_memory_search` · `veto_memory_delete` · `veto_project_map_update` · `veto_project_map_get` · `veto_pattern_store` · `veto_patterns_list` · `veto_memory_export` · `veto_memory_import` |
 | **Learning** | `veto_record_outcome` · `veto_learning_stats` · `veto_learning_apply` |
 | **Handoff** | `veto_handoff` · `veto_continue` · `veto_platform_setup` |
+| **Intelligence** | `veto_docs_fetch` · `veto_context_status` · `veto_task_parse` |
+| **Observability** | `veto_usage_status` · `veto_audit_log` · `veto_health` |
+| **CI/CD** | `veto_ci_gate` |
 | **Plugins** | `veto_plugins` |
 
 ## MCP Resources
@@ -171,7 +174,7 @@ npx @jigyasudham/veto help       # Same help output, no install needed
 npx @jigyasudham/veto status     # Check status from any machine
 ```
 
-`veto help` shows all CLI commands, all 34 MCP tool names, MCP Resources, and MCP Prompts — the full reference in one place.
+`veto help` shows all CLI commands, all 41 MCP tool names, MCP Resources, and MCP Prompts — the full reference in one place.
 
 ---
 
@@ -346,6 +349,9 @@ Machine B  →  veto_memory_import  →  veto_session_restore
 | 10 — Watch, Workflow, Explain, Plugins | ✅ Complete | v0.10.0 |
 | 11 — Smarter Council + Predictive Routing + Auto Project Map | ✅ Complete | v0.11.0 |
 | 12 — CLI Subcommands + Diff Review | ✅ Complete | v1.0.0 |
+| 13 — Developer Intelligence + Auto Docs | ✅ Complete | v1.1.0 |
+| 14 — Observability + Usage Stats + Audit Log | ✅ Complete | v1.2.0 |
+| 15 — CI/CD Pipeline Gates | ✅ Complete | v1.2.0 |
 
 ---
 

package/dist/cli.js

@@ -5,7 +5,7 @@ process.removeAllListeners('warning');
 import { mkdirSync, existsSync, readFileSync, writeFileSync, readdirSync, statSync } from 'node:fs';
 import { join, dirname, extname, resolve } from 'node:path';
 import { homedir } from 'node:os';
-const VERSION = '1.0.0';
+const VERSION = '1.2.2';
 const VETO_DIR = join(homedir(), '.veto');
 const HOME = homedir();
 const c = {
@@ -25,7 +25,7 @@ function printBanner() {
     console.log(c.bold(c.cyan('   ╚████╔╝ ███████╗   ██║   ╚██████╔╝')));
     console.log(c.bold(c.cyan('    ╚═══╝  ╚══════╝   ╚═╝    ╚═════╝')));
     console.log('');
-    console.log(c.dim(`  50 agents. 33 tools. 3 AIs. Self-learning. Zero extra cost.`));
+    console.log(c.dim(`  50 agents. 41 tools. 3 AIs. Self-learning. Zero extra cost.`));
     console.log(c.dim(`  v${VERSION}`));
     console.log('');
 }
@@ -49,12 +49,12 @@ function writeVetoConfig(configPath, format) {
     const wasEmpty = Object.keys(existing).length === 0;
     if (format === 'mcpServers') {
         const servers = existing.mcpServers ?? {};
-        servers['veto'] = { command: 'veto-server' };
+        servers['veto'] = { command: 'npx', args: ['-y', '--package', '@jigyasudham/veto', 'veto-server'] };
         existing.mcpServers = servers;
     }
     else {
         const servers = existing.servers ?? {};
-        servers['veto'] = { type: 'stdio', command: 'veto-server' };
+        servers['veto'] = { type: 'stdio', command: 'npx', args: ['-y', '--package', '@jigyasudham/veto', 'veto-server'] };
         existing.servers = servers;
     }
     writeFileSync(configPath, JSON.stringify(existing, null, 2) + '\n', 'utf8');
@@ -333,7 +333,7 @@ async function patternsCommand() {
 }
 function helpCommand() {
     console.log('');
-    console.log(c.bold(c.cyan('  veto')) + c.dim(` v${VERSION}`) + c.dim(' — 50 agents. 34 tools. 3 AIs. Self-learning. Zero extra cost.'));
+    console.log(c.bold(c.cyan('  veto')) + c.dim(` v${VERSION}`) + c.dim(' — 50 agents. 41 tools. 3 AIs. Self-learning. Zero extra cost.'));
     console.log('');
     console.log(c.bold('  CLI Commands'));
     console.log(c.dim('  ─────────────────────────────────────────────────────'));
@@ -344,22 +344,25 @@ function helpCommand() {
     console.log(`  ${c.cyan('veto patterns')} ${c.dim('[prefix]')}      List learned agent/routing patterns`);
     console.log(`  ${c.cyan('veto help')}                    Show this help`);
     console.log('');
-    console.log(c.bold('  MCP Tools (34)'));
+    console.log(c.bold('  MCP Tools (41)'));
     console.log(c.dim('  ─────────────────────────────────────────────────────'));
-    console.log(`  ${c.dim('Session')}    veto_status · veto_session_save · veto_session_restore · veto_sessions_list`);
-    console.log(`  ${c.dim('Router')}     veto_route_task · veto_rate_status`);
-    console.log(`  ${c.dim('Council')}    veto_council_debate`);
-    console.log(`  ${c.dim('Agents')}     veto_agent_plan · veto_execute_parallel · veto_explain`);
-    console.log(`  ${c.dim('Review')}     veto_code_review · veto_security_scan · veto_secrets_scan · veto_diff_review`);
-    console.log(`  ${c.dim('Pipeline')}   veto_workflow`);
-    console.log(`  ${c.dim('Watch')}      veto_watch · veto_watch_poll · veto_watch_stop`);
-    console.log(`  ${c.dim('Memory')}     veto_memory_store · veto_memory_search · veto_memory_delete`);
-    console.log(`             veto_project_map_update · veto_project_map_get`);
-    console.log(`             veto_pattern_store · veto_patterns_list`);
-    console.log(`             veto_memory_export · veto_memory_import`);
-    console.log(`  ${c.dim('Learning')}   veto_record_outcome · veto_learning_stats · veto_learning_apply`);
-    console.log(`  ${c.dim('Handoff')}    veto_handoff · veto_continue · veto_platform_setup`);
-    console.log(`  ${c.dim('Plugins')}    veto_plugins`);
+    console.log(`  ${c.dim('Session')}       veto_status · veto_session_save · veto_session_restore · veto_sessions_list`);
+    console.log(`  ${c.dim('Router')}        veto_route_task · veto_rate_status`);
+    console.log(`  ${c.dim('Council')}       veto_council_debate`);
+    console.log(`  ${c.dim('Agents')}        veto_agent_plan · veto_execute_parallel · veto_explain`);
+    console.log(`  ${c.dim('Review')}        veto_code_review · veto_security_scan · veto_secrets_scan · veto_diff_review`);
+    console.log(`  ${c.dim('Pipeline')}      veto_workflow`);
+    console.log(`  ${c.dim('Watch')}         veto_watch · veto_watch_poll · veto_watch_stop`);
+    console.log(`  ${c.dim('Memory')}        veto_memory_store · veto_memory_search · veto_memory_delete`);
+    console.log(`                veto_project_map_update · veto_project_map_get`);
+    console.log(`                veto_pattern_store · veto_patterns_list`);
+    console.log(`                veto_memory_export · veto_memory_import`);
+    console.log(`  ${c.dim('Learning')}      veto_record_outcome · veto_learning_stats · veto_learning_apply`);
+    console.log(`  ${c.dim('Handoff')}       veto_handoff · veto_continue · veto_platform_setup`);
+    console.log(`  ${c.dim('Intelligence')}  veto_docs_fetch · veto_context_status · veto_task_parse`);
+    console.log(`  ${c.dim('Observability')} veto_usage_status · veto_audit_log · veto_health`);
+    console.log(`  ${c.dim('CI/CD')}         veto_ci_gate`);
+    console.log(`  ${c.dim('Plugins')}       veto_plugins`);
     console.log('');
     console.log(c.bold('  MCP Resources'));
     console.log(c.dim('  ─────────────────────────────────────────────────────'));
@@ -372,9 +375,70 @@ function helpCommand() {
     console.log(c.dim('  ─────────────────────────────────────────────────────'));
     console.log(`  ${c.cyan('code-review')} · ${c.cyan('security-audit')} · ${c.cyan('deploy-checklist')} · ${c.cyan('explain-file')}`);
     console.log('');
-    console.log(c.bold('  Docs'));
+    console.log(c.bold('  Troubleshooting'));
+    console.log(c.dim('  ─────────────────────────────────────────────────────'));
+    console.log(`  ${c.yellow('MCP disconnected / tools not loading')}`);
+    console.log(`  ${c.dim('→')} Run ${c.cyan('veto init')} again, then fully restart your AI client (Claude / Gemini / Cursor)`);
+    console.log(`  ${c.dim('→')} Verify the MCP entry in your AI client config file`);
+    console.log(`  ${c.dim('→')} Check Node.js version: ${c.cyan('node --version')}  (need >= 22)`);
+    console.log('');
+    console.log(`  ${c.yellow('veto command not found after install')}`);
+    console.log(`  ${c.dim('→')} Global install: ${c.cyan('npm install -g @jigyasudham/veto')}`);
+    console.log(`  ${c.dim('→')} From source:    ${c.cyan('npm run build && npm link')}`);
+    console.log(`  ${c.dim('→')} Windows: restart terminal after install so PATH refreshes`);
+    console.log('');
+    console.log(`  ${c.yellow('Tools missing in Claude / Gemini after install')}`);
+    console.log(`  ${c.dim('→')} Run ${c.cyan('veto init')} to write / regenerate the MCP config`);
+    console.log(`  ${c.dim('→')} Fully quit and reopen the AI client (not just reload)`);
+    console.log(`  ${c.dim('→')} Claude Desktop config: ${c.dim('~/.config/claude/claude_desktop_config.json')}`);
+    console.log(`  ${c.dim('→')} Gemini / other: check the platform docs for MCP config location`);
+    console.log('');
+    console.log(`  ${c.yellow('Old version still showing after update')}`);
+    console.log(`  ${c.dim('→')} ${c.cyan('npm install -g @jigyasudham/veto@latest')}`);
+    console.log(`  ${c.dim('→')} From source: ${c.cyan('npm run build && npm link')}`);
+    console.log(`  ${c.dim('→')} Confirm active binary: ${c.cyan('which veto')} / ${c.cyan('where veto')}`);
+    console.log('');
+    console.log(`  ${c.yellow('Database / SQLite errors on startup')}`);
+    console.log(`  ${c.dim('→')} Requires Node.js >= 22 (uses built-in node:sqlite)`);
+    console.log(`  ${c.dim('→')} Check ${c.dim('~/.veto')} directory exists and is writable`);
+    console.log(`  ${c.dim('→')} Run ${c.cyan('veto status')} to see the active DB path`);
+    console.log('');
+    console.log(`  ${c.yellow('Memory or sessions not persisting between chats')}`);
+    console.log(`  ${c.dim('→')} Run ${c.cyan('veto status')} — verify DB path and memory count`);
+    console.log(`  ${c.dim('→')} Ensure ${c.dim('~/.veto')} is not on a read-only or temp volume`);
+    console.log('');
+    console.log(`  ${c.yellow('Permission denied on Windows (PowerShell)')}`);
+    console.log(`  ${c.dim('→')} ${c.cyan('Set-ExecutionPolicy -Scope CurrentUser RemoteSigned')}`);
+    console.log(`  ${c.dim('→')} Or run terminal as Administrator and retry`);
+    console.log('');
+    console.log(`  ${c.yellow('Rate limit / too many requests errors')}`);
+    console.log(`  ${c.dim('→')} Use ${c.cyan('veto_rate_status')} tool to check current usage`);
+    console.log(`  ${c.dim('→')} Wait a moment, then retry — limits reset per minute`);
+    console.log('');
+    console.log(`  ${c.yellow('veto init fails / API key not found')}`);
+    console.log(`  ${c.dim('→')} Set key in your shell: ${c.cyan('export ANTHROPIC_API_KEY=sk-...')}`);
+    console.log(`  ${c.dim('→')} Windows: ${c.cyan('$env:ANTHROPIC_API_KEY="sk-..."')}`);
+    console.log(`  ${c.dim('→')} Re-run ${c.cyan('veto init')} after setting the key`);
+    console.log('');
+    console.log(`  ${c.yellow('veto_health shows degraded / components failing')}`);
+    console.log(`  ${c.dim('→')} Run ${c.cyan('veto status')} for a summary of all components`);
+    console.log(`  ${c.dim('→')} Check ${c.cyan('veto_audit_log')} for recent error events`);
+    console.log(`  ${c.dim('→')} Re-run ${c.cyan('veto init')} to repair config and rescan project`);
+    console.log('');
+    console.log(`  ${c.yellow('Installed via npx but MCP disconnects after restart')}`);
+    console.log(`  ${c.dim('→')} npx runs temporarily — it does NOT add veto-server to PATH permanently`);
+    console.log(`  ${c.dim('→')} Fix: run ${c.cyan('npx veto init')} again so the config is rewritten with the correct npx command`);
+    console.log(`  ${c.dim('→')} Or install globally for a stable binary: ${c.cyan('npm install -g @jigyasudham/veto')}`);
+    console.log('');
+    console.log(`  ${c.yellow('Installed on a new machine but MCP not working')}`);
+    console.log(`  ${c.dim('→')} Run ${c.cyan('npx @jigyasudham/veto init')} on the new machine — config is not transferred`);
+    console.log(`  ${c.dim('→')} Each machine needs its own init run to register the MCP server`);
+    console.log(`  ${c.dim('→')} Then restart the AI client on that machine`);
+    console.log('');
+    console.log(c.bold('  Docs & Support'));
     console.log(c.dim('  ─────────────────────────────────────────────────────'));
     console.log(`  ${c.dim('GitHub:')}  https://github.com/jigyasudham/veto`);
+    console.log(`  ${c.dim('Issues:')} https://github.com/jigyasudham/veto/issues`);
     console.log(`  ${c.dim('npm:')}     https://www.npmjs.com/package/@jigyasudham/veto`);
     console.log('');
 }

package/dist/memory/local.js

@@ -1,10 +1,13 @@
 // Local SQLite memory — all operations for session save/restore
 // Uses Node.js built-in node:sqlite (Node 22.5+, no native compilation needed)
-import { DatabaseSync } from 'node:sqlite';
+import { createRequire } from 'node:module';
 import { randomUUID } from 'node:crypto';
-import { join } from 'node:path';
+import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import { mkdirSync } from 'node:fs';
+// node:sqlite is a Node 22.5+ built-in — use createRequire so bundlers (Vite/esbuild) skip it
+const _require = createRequire(import.meta.url);
+const DbSync = _require('node:sqlite').DatabaseSync;
 import { CREATE_TABLES } from './schema.js';
 // Context window sizes per platform (tokens)
 export const CONTEXT_WINDOWS = {
@@ -13,13 +16,20 @@ export const CONTEXT_WINDOWS = {
     codex: 128_000,
 };
 const VETO_DIR = join(homedir(), '.veto');
-const DB_PATH = join(VETO_DIR, 'veto.db');
+const DB_PATH = process.env.VETO_TEST_DB ?? join(VETO_DIR, 'veto.db');
 let _db = null;
+export function resetDb() {
+    if (_db) {
+        _db.close();
+        _db = null;
+    }
+}
 export function getDb() {
     if (_db)
         return _db;
-    mkdirSync(VETO_DIR, { recursive: true });
-    _db = new DatabaseSync(DB_PATH);
+    if (DB_PATH !== ':memory:')
+        mkdirSync(dirname(DB_PATH), { recursive: true });
+    _db = new DbSync(DB_PATH);
     _db.exec('PRAGMA journal_mode = WAL');
     _db.exec('PRAGMA foreign_keys = ON');
     _db.exec(CREATE_TABLES);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jigyasudham/veto",
-  "version": "1.2.0",
-  "description": "50 agents. 34 tools. 3 AIs. Self-learning. Zero extra cost.",
+  "version": "1.2.2",
+  "description": "50 agents. 41 tools. 3 AIs. Self-learning. Zero extra cost.",
   "keywords": [
     "mcp",
     "ai",
@@ -34,7 +34,10 @@
     "build": "tsc",
     "dev": "tsx src/cli.ts",
     "start": "node dist/server.js",
-    "init": "tsx src/cli.ts init"
+    "init": "tsx src/cli.ts init",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0"
@@ -42,6 +45,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "tsx": "^4.7.0",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "vitest": "^2.1.9"
   }
 }

package/vitest.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    environment: 'node',
+    pool: 'forks',
+    env: {
+      VETO_TEST_DB: ':memory:',
+    },
+  },
+});