agent-nuvira 1.19.0 → 1.21.0

package/dist/agents/inspect-module.d.ts

@@ -0,0 +1,134 @@
+/**
+ * InspectModule — Scans the codebase to discover relevant files, extract
+ * structural context, and identify dependencies. Phase 6 adds LLM-based
+ * file classification with keyword-scanning fallback.
+ *
+ * @see ARCHITECTURE.md §3.2 — Inspect Module specification
+ */
+import type { EventBus } from '../observability/event-bus.js';
+import type { LLMCallFn } from './agent.js';
+/**
+ * A discovered file artifact with its content.
+ * Prefixed with "Inspect" to avoid collision with agent.ts's Artifact type.
+ */
+export interface InspectArtifact {
+    /** Relative path from the project root */
+    path: string;
+    /** Full file contents */
+    content: string;
+    /** Human-readable description (e.g. 'src/index.ts (12.5k characters)') */
+    description: string;
+}
+/** Statistics about the inspection run */
+export interface InspectionStats {
+    /** Total files in the project */
+    totalFiles: number;
+    /** Files that were inspected / read */
+    inspectedFiles: number;
+    /** Number of errors encountered during inspection */
+    errors: number;
+    /** Whether the LLM-based classification fell back to keyword scanning */
+    llmFallbackUsed: boolean;
+}
+/** Result of a codebase inspection */
+export interface InspectionResult {
+    /** Discovered file artifacts with full contents */
+    artifacts: InspectArtifact[];
+    /** Text representation of the project file tree */
+    fileTree: string;
+    /** File paths that are relevant to the goal */
+    relevantPaths: string[];
+    /** Inspection statistics */
+    stats: InspectionStats;
+}
+/** Parameters for the InspectModule.inspect() method */
+export interface InspectParams {
+    /** The user's goal / task description */
+    goal: string;
+    /** Working directory of the project */
+    workingDirectory: string;
+    /** Optional list of task plan descriptions for context */
+    taskDescriptions?: string[];
+    /** Maximum number of files to inspect (default: 10) */
+    maxFiles?: number;
+    /**
+     * Optional LLM call function for LLM-based file classification.
+     * When provided, the module first asks the LLM to identify relevant
+     * files. Falls back to keyword scanning if the LLM call fails.
+     * When omitted, only keyword scanning is used.
+     */
+    callLLM?: LLMCallFn;
+}
+/**
+ * PlanStep-like interface for dependency-aware planning.
+ * A minimal version of what the PlanModule produces.
+ */
+export interface PlanStepRef {
+    id: string;
+    description: string;
+}
+/**
+ * InspectModule — Scan the codebase to discover relevant files, extract
+ * structural context, and identify dependencies.
+ *
+ * @example
+ * ```typescript
+ * const module = new DefaultInspectModule();
+ * const result = await module.inspect({
+ *   goal: 'Add JWT auth',
+ *   workingDirectory: '/project',
+ * });
+ * console.log(result.artifacts.length); // Files discovered
+ * ```
+ */
+export interface InspectModule {
+    /**
+     * Scan the codebase for files relevant to the given goal.
+     * Uses LLM-based classification with keyword fallback.
+     */
+    inspect(params: InspectParams): Promise<InspectionResult>;
+    /**
+     * Synchronous fallback — scans files by keyword matching against the goal.
+     * Used when the LLM call fails or times out.
+     */
+    scanByKeywords(goal: string, workingDir: string): string[];
+}
+/**
+ * DefaultInspectModule — Built-in inspect module implementation.
+ *
+ * Wraps the existing keyword-scanning logic (previously private to
+ * ContextGathererAgent) into the modular InspectModule interface.
+ * The LLM-based file identification is delegated to the agent system
+ * via the callLLM parameter — when no callLLM is provided, only
+ * keyword-based scanning is used.
+ */
+export declare class DefaultInspectModule implements InspectModule {
+    /** The event bus for emitting observability events */
+    private eventBus;
+    constructor(eventBus?: EventBus);
+    /**
+     * Scan the codebase for files relevant to the given goal.
+     * Phase 6: Uses LLM-based classification with keyword-scanning fallback.
+     */
+    inspect(params: InspectParams): Promise<InspectionResult>;
+    /**
+     * Synchronous fallback — scan files by keyword matching against the goal.
+     * Used when the LLM call fails or as the base implementation.
+     */
+    scanByKeywords(goal: string, workingDir: string): string[];
+    /**
+     * Use the LLM to identify files relevant to the goal.
+     * Parses the LLM response as a JSON array of file paths.
+     * Throws if parsing fails or file list is empty.
+     */
+    private classifyFiles;
+    /** Build the prompt for LLM-based file classification */
+    private buildClassifyPrompt;
+    /** Parse the LLM response into an array of file paths. Throws on failure. */
+    private parseClassifyResponse;
+    /** Walk the directory tree and score files by keyword relevance */
+    private walkAndScore;
+    /** Format byte count to human-readable string */
+    private formatSize;
+}
+//# sourceMappingURL=inspect-module.d.ts.map

package/dist/agents/inspect-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-module.d.ts","sourceRoot":"","sources":["../../src/agents/inspect-module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,4BAA4B;IAC5B,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE1D;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5D;AAYD;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAW;gBAEf,QAAQ,CAAC,EAAE,QAAQ;IAI/B;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkH/D;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAwB1D;;;;OAIG;YACW,aAAa;IAY3B,yDAAyD;IACzD,OAAO,CAAC,mBAAmB;IA8B3B,6EAA6E;IAC7E,OAAO,CAAC,qBAAqB;IA8B7B,mEAAmE;IACnE,OAAO,CAAC,YAAY;IAgDpB,iDAAiD;IACjD,OAAO,CAAC,UAAU;CAKnB"}

package/dist/agents/inspect-module.js

@@ -0,0 +1,266 @@
+/**
+ * InspectModule — Scans the codebase to discover relevant files, extract
+ * structural context, and identify dependencies. Phase 6 adds LLM-based
+ * file classification with keyword-scanning fallback.
+ *
+ * @see ARCHITECTURE.md §3.2 — Inspect Module specification
+ */
+import { join, relative } from 'node:path';
+import { existsSync, readFileSync, statSync, readdirSync } from 'node:fs';
+import { getEventBus, EventNames } from '../observability/event-bus.js';
+import { buildProjectFileTree } from './utils/file-tree.js';
+// ─── Constants ──────────────────────────────────────────────────────────────
+// Reuse constants from the shared file-tree utility to avoid duplication
+import { SOURCE_EXTENSIONS, IGNORE_DIRS } from './utils/file-tree.js';
+/** Maximum characters per file when reading */
+const MAX_FILE_CHARS = 100_000;
+// ─── Default InspectModule ─────────────────────────────────────────────────
+/**
+ * DefaultInspectModule — Built-in inspect module implementation.
+ *
+ * Wraps the existing keyword-scanning logic (previously private to
+ * ContextGathererAgent) into the modular InspectModule interface.
+ * The LLM-based file identification is delegated to the agent system
+ * via the callLLM parameter — when no callLLM is provided, only
+ * keyword-based scanning is used.
+ */
+export class DefaultInspectModule {
+    /** The event bus for emitting observability events */
+    eventBus;
+    constructor(eventBus) {
+        this.eventBus = eventBus ?? getEventBus();
+    }
+    /**
+     * Scan the codebase for files relevant to the given goal.
+     * Phase 6: Uses LLM-based classification with keyword-scanning fallback.
+     */
+    async inspect(params) {
+        const { goal, workingDirectory, taskDescriptions, maxFiles = 10, callLLM } = params;
+        // ── Emit: scanning started ───────────────────────────────────────
+        this.eventBus.emit(EventNames.INSPECT_SCANNING, {
+            directory: workingDirectory,
+            goal,
+        }, 'inspect-module');
+        // 1. Build the project file tree
+        const fileTree = await buildProjectFileTree(workingDirectory);
+        const totalFiles = fileTree.split('\n').filter((l) => l.includes('📄')).length;
+        // 2. Identify relevant paths — try LLM first, fall back to keywords
+        let usedLlm = false;
+        let relevantPaths;
+        if (callLLM) {
+            try {
+                relevantPaths = await this.classifyFiles({
+                    goal,
+                    workingDirectory,
+                    fileTree,
+                    callLLM,
+                    taskDescriptions,
+                });
+                usedLlm = true;
+                // ── Emit: LLM classification completed ───────────────────────
+                this.eventBus.emit(EventNames.INSPECT_LLM_CLASSIFY, {
+                    fileCount: relevantPaths.length,
+                    method: 'llm',
+                }, 'inspect-module');
+            }
+            catch {
+                // LLM call failed — fall back to keyword scanning
+                relevantPaths = this.scanByKeywords(goal, workingDirectory);
+                // ── Emit: LLM classification failed, using fallback ──────────
+                this.eventBus.emit(EventNames.INSPECT_LLM_CLASSIFY, {
+                    fileCount: relevantPaths.length,
+                    method: 'keyword-fallback',
+                }, 'inspect-module');
+            }
+        }
+        else {
+            // No callLLM provided — use keyword scanning directly
+            relevantPaths = this.scanByKeywords(goal, workingDirectory);
+        }
+        // Limit to maxFiles
+        const limitedPaths = relevantPaths.slice(0, maxFiles);
+        // 3. Read the identified files
+        const artifacts = [];
+        const errors = [];
+        for (const filePath of limitedPaths) {
+            const absolutePath = join(workingDirectory, filePath);
+            if (!existsSync(absolutePath) || !statSync(absolutePath).isFile()) {
+                errors.push(`File not found: ${filePath}`);
+                continue;
+            }
+            try {
+                const size = statSync(absolutePath).size;
+                if (size > MAX_FILE_CHARS) {
+                    errors.push(`File too large: ${filePath} (${this.formatSize(size)})`);
+                    continue;
+                }
+                const content = readFileSync(absolutePath, 'utf-8');
+                // ── Emit: file found event ───────────────────────────────────
+                this.eventBus.emit(EventNames.INSPECT_FILE_FOUND, {
+                    path: filePath,
+                    extension: filePath.slice(filePath.lastIndexOf('.')),
+                    size,
+                }, 'inspect-module');
+                artifacts.push({
+                    path: filePath,
+                    content,
+                    description: `${filePath} (${this.formatSize(content.length)} characters)`,
+                });
+            }
+            catch {
+                errors.push(`Could not read: ${filePath}`);
+            }
+        }
+        const stats = {
+            totalFiles,
+            inspectedFiles: artifacts.length,
+            errors: errors.length,
+            // When callLLM was provided and succeeded, LLM was used (no fallback).
+            // When callLLM was provided but failed, or when no callLLM was given,
+            // keyword scanning was used (the fallback).
+            llmFallbackUsed: !usedLlm,
+        };
+        // ── Emit: completed event ────────────────────────────────────────
+        this.eventBus.emit(EventNames.INSPECT_COMPLETED, {
+            artifactCount: artifacts.length,
+            errors: errors.length,
+            totalFiles,
+        }, 'inspect-module');
+        return {
+            artifacts,
+            fileTree,
+            relevantPaths: limitedPaths,
+            stats,
+        };
+    }
+    /**
+     * Synchronous fallback — scan files by keyword matching against the goal.
+     * Used when the LLM call fails or as the base implementation.
+     */
+    scanByKeywords(goal, workingDir) {
+        const stopWords = new Set([
+            'the', 'a', 'an', 'in', 'to', 'for', 'of', 'and', 'or', 'is',
+            'add', 'fix', 'update', 'change', 'remove', 'create', 'implement',
+            'with', 'on', 'at', 'by', 'from', 'as', 'be', 'this', 'that',
+        ]);
+        const keywords = goal
+            .toLowerCase()
+            .split(/[\s,.-]+/)
+            .filter((w) => w.length > 2 && !stopWords.has(w));
+        if (keywords.length === 0)
+            return [];
+        const scored = this.walkAndScore(workingDir, keywords, 0);
+        return scored
+            .sort((a, b) => b.score - a.score)
+            .filter((s) => s.score > 0)
+            .slice(0, 10)
+            .map((s) => s.path);
+    }
+    // ─── LLM-Based Classification ─────────────────────────────────────────
+    /**
+     * Use the LLM to identify files relevant to the goal.
+     * Parses the LLM response as a JSON array of file paths.
+     * Throws if parsing fails or file list is empty.
+     */
+    async classifyFiles(params) {
+        const prompt = this.buildClassifyPrompt(params);
+        const response = await params.callLLM(prompt);
+        return this.parseClassifyResponse(response);
+    }
+    /** Build the prompt for LLM-based file classification */
+    buildClassifyPrompt(params) {
+        let prompt = `You are a codebase inspector. Given a project goal and its file tree, identify which files are most relevant to accomplish the goal.
+
+Goal: ${params.goal}
+
+Project file tree:
+${params.fileTree.slice(0, 2000)}
+`;
+        if (params.taskDescriptions && params.taskDescriptions.length > 0) {
+            prompt += `\nAdditional context — task plan steps:
+${params.taskDescriptions.map((d, i) => `  ${i + 1}. ${d}`).join('\n')}
+`;
+        }
+        prompt += `
+Respond with ONLY a JSON array of file paths (relative to the project root) that are most relevant to this goal. Limit to 10 files. Use the exact paths as shown in the file tree.
+
+Example: ["src/auth/login.ts", "src/auth/middleware.ts"]
+
+JSON array:`;
+        return prompt;
+    }
+    /** Parse the LLM response into an array of file paths. Throws on failure. */
+    parseClassifyResponse(response) {
+        // Try to extract a JSON array from the response
+        const trimmed = response.trim();
+        // Find the first `[` and last `]` to extract the JSON array
+        const start = trimmed.indexOf('[');
+        const end = trimmed.lastIndexOf(']');
+        if (start === -1 || end === -1 || end <= start) {
+            throw new Error('LLM response did not contain a JSON array');
+        }
+        const jsonStr = trimmed.slice(start, end + 1);
+        const paths = JSON.parse(jsonStr);
+        if (!Array.isArray(paths) || paths.length === 0) {
+            throw new Error('LLM returned empty or invalid file list');
+        }
+        // Validate all entries are strings
+        const filePaths = paths.filter((p) => typeof p === 'string');
+        if (filePaths.length === 0) {
+            throw new Error('LLM returned no valid file paths');
+        }
+        return filePaths;
+    }
+    // ─── Private Helpers ─────────────────────────────────────────────────
+    /** Walk the directory tree and score files by keyword relevance */
+    walkAndScore(dir, keywords, depth, baseDir) {
+        const root = baseDir ?? dir;
+        if (depth > 5)
+            return [];
+        const results = [];
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return [];
+        }
+        for (const entry of entries) {
+            if (IGNORE_DIRS.has(entry.name))
+                continue;
+            const entryPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const subResults = this.walkAndScore(entryPath, keywords, depth + 1, root);
+                results.push(...subResults);
+            }
+            else if (entry.isFile()) {
+                const ext = entry.name.slice(entry.name.lastIndexOf('.'));
+                if (!SOURCE_EXTENSIONS.has(ext))
+                    continue;
+                let score = 0;
+                const lowerName = entry.name.toLowerCase();
+                const lowerPath = entryPath.toLowerCase();
+                for (const kw of keywords) {
+                    if (lowerName.includes(kw))
+                        score += 3;
+                    else if (lowerPath.includes(kw))
+                        score += 1;
+                }
+                if (score > 0) {
+                    const relPath = relative(root, entryPath);
+                    results.push({ path: relPath, score });
+                }
+            }
+        }
+        return results;
+    }
+    /** Format byte count to human-readable string */
+    formatSize(bytes) {
+        if (bytes < 1024)
+            return String(bytes);
+        if (bytes < 1024 * 1024)
+            return `${(bytes / 1024).toFixed(1)}k`;
+        return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+    }
+}
+//# sourceMappingURL=inspect-module.js.map

package/dist/agents/inspect-module.js.map

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

package/dist/agents/orchestrator.d.ts

@@ -20,6 +20,7 @@ import { ConfigManager } from '../config/manager.js';
 import type { TaskStep } from './agent.js';
 import { type ModuleRegistry } from './module-registry.js';
 import type { EventBus } from '../observability/event-bus.js';
+import { type ReportModule } from './report-module.js';
 /** Configuration for an orchestration session */
 export interface OrchestratorOptions {
     /** Inference provider type (default: from configManager) */
@@ -130,7 +131,9 @@ export declare class Orchestrator {
     private moduleRegistry;
     /** The event bus for emitting observability events */
     private eventBus;
-    constructor(configManager?: ConfigManager, moduleRegistry?: ModuleRegistry, eventBus?: EventBus);
+    /** The report module for generating structured execution reports */
+    private reportModule;
+    constructor(configManager?: ConfigManager, moduleRegistry?: ModuleRegistry, eventBus?: EventBus, reportModule?: ReportModule);
     /**
      * Execute a multi-agent pipeline for the given goal.
      */

package/dist/agents/orchestrator.d.ts.map

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

package/dist/agents/orchestrator.js

@@ -30,6 +30,7 @@ import { getMCPManager, resetMCPManager } from '../mcp/manager.js';
 import { formatMcpToolsForPrompt } from './agents/mcp-agent.js';
 import { getModuleRegistry } from './module-registry.js';
 import { getEventBus, EventNames } from '../observability/event-bus.js';
+import { DefaultReportModule } from './report-module.js';
 import { ContextPruner } from '../learning/context-pruner.js';
 import { ErrorRepairEngine } from '../learning/error-repair.js';
 import { scanForInjections, formatScanReport } from '../security/scanner.js';
@@ -87,10 +88,13 @@ export class Orchestrator {
     moduleRegistry;
     /** The event bus for emitting observability events */
     eventBus;
-    constructor(configManager, moduleRegistry, eventBus) {
+    /** The report module for generating structured execution reports */
+    reportModule;
+    constructor(configManager, moduleRegistry, eventBus, reportModule) {
         this.configManager = configManager ?? new ConfigManager();
         this.moduleRegistry = moduleRegistry ?? getModuleRegistry();
         this.eventBus = eventBus ?? getEventBus();
+        this.reportModule = reportModule ?? new DefaultReportModule(this.eventBus);
     }
     /**
      * Execute a multi-agent pipeline for the given goal.
@@ -444,15 +448,25 @@ export class Orchestrator {
             tasksTotal: total,
             durationMs: Date.now() - startTime,
         }, 'orchestrator');
-        const summaryLines = [];
-        summaryLines.push(hasFailures
-            ? `Completed ${completed}/${total} tasks with some failures in ${elapsed}s`
-            : `Completed all ${completed} tasks successfully in ${elapsed}s`);
-        summaryLines.push('');
-        summaryLines.push('Changes:');
-        summaryLines.push(vault.getDiffSummary());
+        // ── Generate structured report via ReportModule ──────────────────
+        const report = await this.reportModule.generate({
+            goal,
+            agentResults,
+            fileChanges: vault.context.fileChanges.map((c) => ({
+                path: c.path,
+                status: c.status,
+            })),
+            hasFailures,
+            durationMs: Date.now() - startTime,
+            runOutput,
+            error: undefined,
+            trajectoryId,
+            reviewId,
+        });
+        // Format as text for the result summary
+        const reportText = this.reportModule.format(report, 'text');
         return this.buildResult(!hasFailures, goal, agentResults, vault, {
-            summary: summaryLines.join('\n'),
+            summary: reportText,
             tasksCompleted: completed,
             tasksTotal: total,
             trajectoryId,