@jigyasudham/veto 1.2.6 → 1.2.9

package/dist/council/ux-designer.js

@@ -127,8 +127,8 @@ export function analyze(task) {
             recommendation: 'Default to minimal UI: one status bar item. Expand to sidebar only when user explicitly enables it. Follow VS Code\'s own design patterns and icon conventions.',
         },
         {
-            pattern: /41.?tool|tool.?count|tool.?list|discover/i,
-            concern: '41 tools requires users to read documentation before they can use the product. No tool is valuable if users can\'t discover it exists.',
+            pattern: /45.?tool|tool.?count|tool.?list|discover/i,
+            concern: '45 tools requires users to read documentation before they can use the product. No tool is valuable if users can\'t discover it exists.',
             recommendation: 'Make veto_discover the entry point. Ship it as the first thing users learn about. Consider surfacing 3 "most useful for your current task" recommendations automatically.',
         },
         {

package/dist/discover.d.ts

@@ -0,0 +1,24 @@
+export type DiscoverDepth = 'quick' | 'standard' | 'full';
+export interface DiscoverResult {
+    project_dir: string;
+    scanned_at: string;
+    depth: DiscoverDepth;
+    git: {
+        branch: string | null;
+        remote: string | null;
+        commit: string | null;
+        dirty_files: string[];
+        recent_commits: string[];
+    };
+    ecosystems: Record<string, string>;
+    tech_stack: string[];
+    dependencies: string[];
+    key_files: string[];
+    structure: string[];
+    file_counts: Record<string, number>;
+    total_files: number;
+    duration_ms: number;
+}
+export declare const KEY_CONFIG_FILES: string[];
+export declare function discoverProject(projectDir: string, depth?: DiscoverDepth): DiscoverResult;
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD,eAAO,MAAM,gBAAgB,UAM5B,CAAC;AA8BF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,aAA0B,GAAG,cAAc,CA+ErG"}

package/dist/discover.js

@@ -0,0 +1,143 @@
+// Shared workspace discovery logic — used by veto_discover (MCP tool) and veto init (CLI)
+import { readFileSync, statSync, readdirSync } from 'node:fs';
+import { join, extname, resolve } from 'node:path';
+import { execSync } from 'node:child_process';
+import { readProjectContext } from './context/reader.js';
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', '__pycache__', '.next', 'dist', 'build', 'target',
+    '.cache', 'coverage', '.venv', 'venv', '.idea', '.vs', 'out', '.turbo',
+]);
+export const KEY_CONFIG_FILES = [
+    'tsconfig.json', 'vite.config.ts', 'vite.config.js', 'next.config.ts', 'next.config.js',
+    'tailwind.config.ts', 'tailwind.config.js', 'drizzle.config.ts', 'prisma/schema.prisma',
+    '.env.example', 'Dockerfile', 'docker-compose.yml', '.github/workflows',
+    'eslint.config.js', '.eslintrc.json', 'vitest.config.ts', 'jest.config.ts',
+    'pyproject.toml', 'requirements.txt', 'Cargo.toml', 'go.mod', 'CLAUDE.md', 'README.md',
+];
+function safeExec(cmd, cwd) {
+    try {
+        return execSync(cmd, { cwd, encoding: 'utf8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+function safeRead(p) {
+    try {
+        return readFileSync(p, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function walkDir(dir, prefix, depth, structure, fileCounts) {
+    if (depth > 3 || structure.length > 200)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries.filter(e => !SKIP_DIRS.has(e)).sort()) {
+        const full = join(dir, entry);
+        let st;
+        try {
+            st = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory()) {
+            structure.push(`${prefix}${entry}/`);
+            walkDir(full, prefix + '  ', depth + 1, structure, fileCounts);
+        }
+        else {
+            structure.push(`${prefix}${entry}`);
+            const ext = extname(entry) || '(none)';
+            fileCounts[ext] = (fileCounts[ext] ?? 0) + 1;
+        }
+    }
+}
+export function discoverProject(projectDir, depth = 'standard') {
+    const dir = resolve(projectDir);
+    const start = Date.now();
+    // Git state
+    const git_branch = safeExec('git rev-parse --abbrev-ref HEAD', dir);
+    const git_remote = safeExec('git remote get-url origin', dir);
+    const git_commit = safeExec('git rev-parse --short HEAD', dir);
+    const git_status_raw = safeExec('git status --short', dir);
+    const git_log_raw = safeExec('git log --oneline -10 --no-color', dir);
+    const dirty_files = git_status_raw.split('\n').filter(Boolean).map(l => l.trim());
+    const recent_commits = git_log_raw.split('\n').filter(Boolean);
+    // Package metadata & tech stack
+    const ecosystems = {};
+    const tech_stack = [];
+    let dependencies = [];
+    const pkgRaw = safeRead(join(dir, 'package.json'));
+    if (pkgRaw) {
+        try {
+            const pkg = JSON.parse(pkgRaw);
+            ecosystems['node'] = `${String(pkg.name ?? 'unknown')} v${String(pkg.version ?? '?')}`;
+            const allDeps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+            dependencies = Object.keys(allDeps).slice(0, 30);
+            tech_stack.push(...readProjectContext(dir).tech_stack);
+        }
+        catch { /* malformed */ }
+    }
+    const pyprojectRaw = safeRead(join(dir, 'pyproject.toml'));
+    const requirementsRaw = safeRead(join(dir, 'requirements.txt'));
+    if (pyprojectRaw || requirementsRaw) {
+        ecosystems['python'] = pyprojectRaw ? 'pyproject.toml' : 'requirements.txt';
+        if (!tech_stack.includes('Python'))
+            tech_stack.push('Python');
+    }
+    const cargoRaw = safeRead(join(dir, 'Cargo.toml'));
+    if (cargoRaw) {
+        const nm = cargoRaw.match(/^name\s*=\s*"(.+)"/m);
+        const vm = cargoRaw.match(/^version\s*=\s*"(.+)"/m);
+        ecosystems['rust'] = `${nm?.[1] ?? 'crate'} v${vm?.[1] ?? '?'}`;
+        if (!tech_stack.includes('Rust'))
+            tech_stack.push('Rust');
+    }
+    const goModRaw = safeRead(join(dir, 'go.mod'));
+    if (goModRaw) {
+        const mm = goModRaw.match(/^module\s+(.+)/m);
+        ecosystems['go'] = mm?.[1]?.trim() ?? 'go module';
+        if (!tech_stack.includes('Go'))
+            tech_stack.push('Go');
+    }
+    // File tree
+    const file_counts = {};
+    const structure = [];
+    if (depth !== 'quick') {
+        walkDir(dir, '', 0, structure, file_counts);
+    }
+    // Key config files
+    const key_files = KEY_CONFIG_FILES.filter(f => {
+        try {
+            statSync(join(dir, f));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+    const total_files = Object.values(file_counts).reduce((s, c) => s + c, 0);
+    return {
+        project_dir: dir,
+        scanned_at: new Date().toISOString(),
+        depth,
+        git: { branch: git_branch || null, remote: git_remote || null, commit: git_commit || null, dirty_files, recent_commits },
+        ecosystems,
+        tech_stack: [...new Set(tech_stack)],
+        dependencies,
+        key_files,
+        structure: depth !== 'quick' ? structure : [],
+        file_counts,
+        total_files,
+        duration_ms: Date.now() - start,
+    };
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// Veto MCP Server — 41 tools, 15 phases, self-learning router
+// Veto MCP Server — 45 tools, 16 phases, self-learning router
 // Suppress node:sqlite experimental warning — it would corrupt the MCP stdio protocol
 process.removeAllListeners('warning');
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
@@ -16,6 +16,7 @@ import { startWatch, pollWatch, stopWatch } from './watcher/index.js';
 import { runPipeline } from './workflow/pipeline.js';
 import { loadPlugins, listPlugins } from './plugins/loader.js';
 import { fetchPrDiff } from './github/pr-fetcher.js';
+import { discoverProject } from './discover.js';
 import { readFileSync, statSync } from 'node:fs';
 import { extname, basename, join, dirname } from 'node:path';
 import { createHash } from 'node:crypto';
@@ -734,6 +735,34 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ['pr_url'],
             },
         },
+        // ── Phase 16: Workspace Discovery & Summarization ─────────────────────────
+        {
+            name: 'veto_discover',
+            description: 'Scans a project directory and builds a rich context map: git state, tech stack, file structure, dependencies, and key config files. Stores the result in Veto memory so agents always have accurate project context. Call this once per project or after major structural changes.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    project_dir: { type: 'string', description: 'Absolute path to the project directory to scan.' },
+                    depth: { type: 'string', enum: ['quick', 'standard', 'full'], description: 'Scan depth. quick: git + package metadata only. standard: + file tree up to 3 levels (default). full: + contents of key config files.' },
+                    store: { type: 'boolean', description: 'Whether to store the discovery in Veto memory as a project map. Default: true.' },
+                },
+                required: ['project_dir'],
+            },
+        },
+        {
+            name: 'veto_summarize',
+            description: 'Generates a concise expert briefing of a project, directory, or file. Use at the start of a session to orient yourself on unfamiliar code. Returns bullet-point summary, key components, tech stack, and entry points. Faster and higher-level than veto_explain.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    project_dir: { type: 'string', description: 'Absolute path to a project directory to summarize.' },
+                    file_path: { type: 'string', description: 'Absolute path to a single file to summarize. If both project_dir and file_path are given, file_path takes precedence.' },
+                    focus: { type: 'string', description: 'Optional focus area: e.g. "security", "APIs", "data flow", "architecture". Narrows the summary.' },
+                    format: { type: 'string', enum: ['brief', 'detailed'], description: 'brief: 4–6 bullet points (default). detailed: paragraph-level prose.' },
+                },
+                required: [],
+            },
+        },
     ],
 }));
 // ─── Shared Scan Utility ──────────────────────────────────────────────────────
@@ -767,7 +796,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                             status: 'running',
                             version: VERSION,
                             server: 'veto',
-                            phase: 16,
+                            phase: 17,
                             capabilities: [
                                 'session_save', 'session_restore', 'sessions_list',
                                 'router', 'rate_monitor',
@@ -783,7 +812,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                                 'plugins',
                                 'docs_fetch', 'context_status', 'task_parse',
                                 'usage_status', 'audit_log', 'health',
-                                'auto_save',
+                                'auto_save', 'discover', 'summarize',
                             ],
                             db_path: getDbPath(),
                             uptime_ms: process.uptime() * 1000,
@@ -1748,6 +1777,107 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     }],
             };
         }
+        // ── Phase 16: Workspace Discovery & Summarization ─────────────────────────
+        case 'veto_discover': {
+            const discoverDir = String(args?.project_dir ?? '').trim();
+            const discoverDepth = (['quick', 'standard', 'full'].includes(String(args?.depth ?? '')))
+                ? String(args.depth)
+                : 'standard';
+            const discoverStore = args?.store !== false;
+            if (!discoverDir) {
+                return { content: [{ type: 'text', text: JSON.stringify({ success: false, message: 'project_dir is required.' }) }], isError: true };
+            }
+            try {
+                statSync(discoverDir);
+            }
+            catch {
+                return { content: [{ type: 'text', text: JSON.stringify({ success: false, message: `Directory not found: ${discoverDir}` }) }], isError: true };
+            }
+            const result = discoverProject(discoverDir, discoverDepth);
+            if (discoverStore) {
+                updateProjectMap({
+                    project_dir: result.project_dir,
+                    structure: { ecosystems: result.ecosystems, key_files: result.key_files, file_count_by_ext: result.file_counts, total_files: result.total_files, scanned_at: result.scanned_at },
+                    key_modules: result.key_files,
+                    tech_stack: result.tech_stack,
+                });
+                storeKnowledge({
+                    type: 'solution',
+                    title: `Project discovery: ${result.project_dir}`,
+                    content: `Stack: ${result.tech_stack.join(', ') || 'unknown'}. Branch: ${result.git.branch || 'none'}. Commit: ${result.git.commit || 'none'}. Files: ${result.total_files}. Ecosystems: ${Object.keys(result.ecosystems).join(', ') || 'none'}. Key files: ${result.key_files.join(', ')}.`,
+                    tags: ['discover', ...result.tech_stack.map(t => t.toLowerCase().replace(/[^a-z0-9]/g, ''))],
+                    project_dir: result.project_dir,
+                });
+            }
+            return { content: [{ type: 'text', text: JSON.stringify({ success: true, stored: discoverStore, ...result }, null, 2) }] };
+        }
+        case 'veto_summarize': {
+            const sumFilePath = args?.file_path ? String(args.file_path).trim() : undefined;
+            const sumProjectDir = args?.project_dir ? String(args.project_dir).trim() : undefined;
+            const sumFocus = args?.focus ? String(args.focus) : undefined;
+            const sumFormat = args?.format === 'detailed' ? 'detailed' : 'brief';
+            if (!sumFilePath && !sumProjectDir) {
+                return { content: [{ type: 'text', text: JSON.stringify({ success: false, message: 'Provide project_dir or file_path.' }) }], isError: true };
+            }
+            const sumStart = Date.now();
+            // ── File summary ───────────────────────────────────────────────────────
+            if (sumFilePath) {
+                let fileContent;
+                try {
+                    fileContent = readFileSync(sumFilePath, 'utf8');
+                }
+                catch {
+                    return { content: [{ type: 'text', text: JSON.stringify({ success: false, message: `Cannot read file: ${sumFilePath}` }) }], isError: true };
+                }
+                const ext = extname(sumFilePath).toLowerCase();
+                const name_ = basename(sumFilePath).toLowerCase();
+                let agent = 'documentation';
+                if (['.tsx', '.jsx', '.vue', '.svelte'].includes(ext))
+                    agent = 'frontend';
+                else if (['.sql', '.prisma'].includes(ext) || name_.includes('schema'))
+                    agent = 'database';
+                else if (/\.(test|spec)\.(ts|js)$/.test(name_))
+                    agent = 'tester';
+                else if (['.yaml', '.yml', '.dockerfile'].includes(ext) || name_ === 'dockerfile')
+                    agent = 'devops';
+                else if (name_.includes('auth') || name_.includes('jwt'))
+                    agent = 'auth';
+                const focusNote = sumFocus ? ` Focus on: ${sumFocus}.` : '';
+                const depthNote = sumFormat === 'detailed' ? 'Write paragraph-level prose.' : 'Return 4–6 bullet points only.';
+                const task = `Summarize this file concisely for a developer who has never seen it.${focusNote} ${depthNote} File: ${basename(sumFilePath)}`;
+                const r = await executeOne({ id: 'sum-file', agent, task, code: fileContent.slice(0, 8000) });
+                return { content: [{ type: 'text', text: JSON.stringify({
+                                success: true, subject: 'file', path: sumFilePath, format: sumFormat,
+                                summary: r.plan ?? r.analysis ?? r.output,
+                                agent_used: agent, duration_ms: Date.now() - sumStart,
+                            }, null, 2) }] };
+            }
+            // ── Project / directory summary ────────────────────────────────────────
+            const discResult = discoverProject(sumProjectDir, 'standard');
+            const ctx = [
+                `Project: ${sumProjectDir}`,
+                `Stack: ${discResult.tech_stack.join(', ') || 'unknown'}`,
+                `Ecosystems: ${JSON.stringify(discResult.ecosystems)}`,
+                `Key files: ${discResult.key_files.join(', ')}`,
+                `Total files: ${discResult.total_files}`,
+                `Git branch: ${discResult.git.branch ?? 'none'}, commit: ${discResult.git.commit ?? 'none'}`,
+                discResult.structure.length > 0 ? `\nFile tree (top 60 lines):\n${discResult.structure.slice(0, 60).join('\n')}` : '',
+            ].filter(Boolean).join('\n');
+            const focusNote = sumFocus ? ` Focus especially on: ${sumFocus}.` : '';
+            const depthNote = sumFormat === 'detailed' ? 'Write paragraph-level prose with sections.' : 'Return 5–7 bullet points that capture the essence.';
+            const task = `You are a senior engineer briefing a colleague on this codebase.${focusNote} ${depthNote} Be concise and precise — no filler.`;
+            const r = await executeOne({ id: 'sum-proj', agent: 'project-mapper', task, context: ctx });
+            return { content: [{ type: 'text', text: JSON.stringify({
+                            success: true, subject: 'project', path: sumProjectDir, format: sumFormat,
+                            tech_stack: discResult.tech_stack,
+                            ecosystems: discResult.ecosystems,
+                            key_files: discResult.key_files,
+                            total_files: discResult.total_files,
+                            git: discResult.git,
+                            summary: r.plan ?? r.analysis ?? r.output,
+                            agent_used: 'project-mapper', duration_ms: Date.now() - sumStart,
+                        }, null, 2) }] };
+        }
         default:
             throw new Error(`Unknown tool: ${name}`);
     }