codehere 0.3.0 → 0.4.0

package/dist/infrastructure/validation/agent-validation-helper.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Infrastructure: Agent Validation Helper
+ * Shared utilities for integrating Validation Layer into agents
+ *
+ * Provides:
+ * - Automatic TraceSummary generation
+ * - AgentFeedback recording
+ * - Run context tracking
+ */
+import type { TraceSummary } from './trace-summary.js';
+import type { FeedbackOutcome, UserAction } from './agent-feedback.js';
+export interface AgentValidationContext {
+    runId: string;
+    agentName: string;
+    operation: string;
+    startTime: number;
+}
+export interface AgentValidationResult<T = any> {
+    result: T;
+    summary: TraceSummary;
+    feedbackId: string;
+    runId: string;
+}
+/**
+ * Helper class for agent validation integration
+ */
+export declare class AgentValidationHelper {
+    /**
+     * Start validation context for an agent operation
+     */
+    startAgentOperation(agentName: string, operation: string, context?: {
+        query?: string;
+        codebaseId?: string;
+    }): AgentValidationContext;
+    /**
+     * Complete agent operation and generate validation artifacts
+     */
+    completeAgentOperation<T>(validationContext: AgentValidationContext, result: T, metadata: {
+        outcome: FeedbackOutcome;
+        userAction?: UserAction;
+        filesChanged?: string[];
+        filesCreated?: string[];
+        filesDeleted?: string[];
+        errors?: string[];
+        warnings?: string[];
+        validationChecks?: Array<{
+            check: string;
+            passed: boolean;
+            message?: string;
+            critical?: boolean;
+        }>;
+        metrics?: {
+            tokensUsed?: number;
+            duration?: number;
+            filesAnalyzed?: number;
+            changesProposed?: number;
+            changesApplied?: number;
+        };
+        additionalContext?: Record<string, any>;
+    }): Promise<AgentValidationResult<T>>;
+    /**
+     * Record a trace during agent operation
+     */
+    trace(operation: {
+        operationType: 'llm_call' | 'tool_invocation' | 'memory_operation' | 'plan_generation' | 'code_analysis' | 'file_operation' | 'git_operation' | 'other';
+        operationName: string;
+        input?: any;
+        output?: any;
+        error?: Error;
+        metadata?: Record<string, any>;
+        duration?: number;
+    }): string;
+}
+export declare const agentValidationHelper: AgentValidationHelper;
+//# sourceMappingURL=agent-validation-helper.d.ts.map

package/dist/infrastructure/validation/agent-validation-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-validation-helper.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/validation/agent-validation-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAiB,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,GAAG;IAC5C,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,sBAAsB;IAczB;;OAEG;IACG,sBAAsB,CAAC,CAAC,EAC5B,iBAAiB,EAAE,sBAAsB,EACzC,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE;QACR,OAAO,EAAE,eAAe,CAAC;QACzB,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,gBAAgB,CAAC,EAAE,KAAK,CAAC;YACvB,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,OAAO,CAAC;YAChB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;QACH,OAAO,CAAC,EAAE;YACR,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,eAAe,CAAC,EAAE,MAAM,CAAC;YACzB,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,CAAC;QACF,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACzC,GACA,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAuDpC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE;QACf,aAAa,EAAE,UAAU,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,eAAe,GAAG,gBAAgB,GAAG,eAAe,GAAG,OAAO,CAAC;QACxJ,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,MAAM;CAGX;AAGD,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}

package/dist/infrastructure/validation/agent-validation-helper.js

@@ -0,0 +1,88 @@
+/**
+ * Infrastructure: Agent Validation Helper
+ * Shared utilities for integrating Validation Layer into agents
+ *
+ * Provides:
+ * - Automatic TraceSummary generation
+ * - AgentFeedback recording
+ * - Run context tracking
+ */
+import { executionTracer } from '../observability/execution-tracer.js';
+import { agentFeedbackManager } from './agent-feedback.js';
+import { traceSummaryFormatter } from './trace-summary.js';
+/**
+ * Helper class for agent validation integration
+ */
+export class AgentValidationHelper {
+    /**
+     * Start validation context for an agent operation
+     */
+    startAgentOperation(agentName, operation, context) {
+        const runId = executionTracer.startRun(`${agentName}:${operation}`, {
+            query: context?.query,
+            codebaseId: context?.codebaseId,
+        });
+        return {
+            runId,
+            agentName,
+            operation,
+            startTime: Date.now(),
+        };
+    }
+    /**
+     * Complete agent operation and generate validation artifacts
+     */
+    async completeAgentOperation(validationContext, result, metadata) {
+        // End trace to finalize run context
+        executionTracer.endRun();
+        // Small delay to ensure file is written
+        await new Promise(resolve => setTimeout(resolve, 100));
+        // Get finalized run context
+        const run = executionTracer.getRun(validationContext.runId);
+        const duration = Date.now() - validationContext.startTime;
+        // Note: Feedback recording is handled by CLI commands with proper userAction from review decision
+        // This helper only creates the validation summary, not the feedback record
+        const feedbackId = 'pending-cli-feedback';
+        // Create trace summary
+        const summary = traceSummaryFormatter.createSummary(run || {
+            runId: validationContext.runId,
+            startTime: validationContext.startTime,
+            endTime: Date.now(),
+            operation: validationContext.operation,
+            query: metadata.additionalContext?.query,
+            codebaseId: metadata.additionalContext?.codebaseId,
+            traces: [],
+        }, agentFeedbackManager.getFeedbackForRun(validationContext.runId) || undefined, validationContext.agentName);
+        // Update summary with metadata if available
+        if (metadata.filesChanged) {
+            summary.filesChanged = metadata.filesChanged;
+        }
+        if (metadata.filesCreated) {
+            summary.filesCreated = metadata.filesCreated;
+        }
+        if (metadata.filesDeleted) {
+            summary.filesDeleted = metadata.filesDeleted;
+        }
+        if (metadata.errors) {
+            summary.errors = metadata.errors;
+        }
+        if (metadata.warnings) {
+            summary.warnings = metadata.warnings;
+        }
+        return {
+            result,
+            summary,
+            feedbackId,
+            runId: validationContext.runId,
+        };
+    }
+    /**
+     * Record a trace during agent operation
+     */
+    trace(operation) {
+        return executionTracer.trace(operation);
+    }
+}
+// Singleton instance
+export const agentValidationHelper = new AgentValidationHelper();
+//# sourceMappingURL=agent-validation-helper.js.map

package/dist/infrastructure/validation/agent-validation-helper.js.map

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

package/dist/infrastructure/validation/feedback-stats.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Infrastructure: Feedback Statistics Builders
+ * Pure functions to compute feedback analytics and status snapshots
+ *
+ * Clean Architecture: Infrastructure Layer
+ * Strategic: Provides machine-readable JSON outputs for CI/dashboards
+ */
+import type { TrustConfig } from './trust-config.js';
+export type FeedbackOutcome = 'success' | 'failure' | 'partial_success' | 'cancelled' | 'error';
+export type UserAction = 'approved' | 'rejected' | 'modified' | 'skipped' | 'not_required';
+export interface AgentFeedback {
+    feedbackId: string;
+    runId: string;
+    agentName: string;
+    timestamp: number;
+    operation: string;
+    query?: string;
+    outcome: FeedbackOutcome;
+    userAction?: UserAction;
+    filesChanged?: string[];
+    filesCreated?: string[];
+    filesDeleted?: string[];
+    errors?: string[];
+    warnings?: string[];
+    validationChecks?: Array<{
+        check: string;
+        passed: boolean;
+        message?: string;
+    }>;
+    metrics?: {
+        tokensUsed?: number;
+        duration?: number;
+        filesAnalyzed?: number;
+    };
+}
+/**
+ * JSON output for analyze-feedback script
+ */
+export interface FeedbackAnalyticsJson {
+    totalRecords: number;
+    agents: Array<{
+        agentName: string;
+        totalRuns: number;
+        trustScore: number;
+        belowThreshold: boolean;
+        threshold: number;
+        outcomes: Record<string, number>;
+        userActions: Record<string, number>;
+    }>;
+    operations: Array<{
+        operation: string;
+        count: number;
+        outcomes: Record<string, number>;
+    }>;
+}
+/**
+ * JSON output for status command
+ */
+export interface StatusSnapshotJson {
+    totalRecords: number;
+    agents: Array<{
+        agentName: string;
+        success: {
+            runs: number;
+            total: number;
+        };
+        trustScore: number;
+        threshold: number;
+        belowThreshold: boolean;
+    }>;
+    operations: Array<{
+        operation: string;
+        runs: number;
+    }>;
+}
+/**
+ * Build feedback analytics JSON from feedback records and trust config
+ */
+export declare function buildFeedbackAnalyticsJson(feedback: AgentFeedback[], trustConfig: TrustConfig): FeedbackAnalyticsJson;
+/**
+ * Build status snapshot JSON from feedback records and trust config
+ */
+export declare function buildStatusSnapshotJson(feedback: AgentFeedback[], trustConfig: TrustConfig): StatusSnapshotJson;
+/**
+ * Result of trust threshold evaluation
+ */
+export interface TrustCheckResult {
+    offenders: Array<{
+        agentName: string;
+        trustScore: number;
+        threshold: number;
+    }>;
+}
+/**
+ * Evaluate trust thresholds from analytics JSON
+ * Returns agents that are below their configured thresholds
+ */
+export declare function evaluateTrustThresholds(analytics: FeedbackAnalyticsJson): TrustCheckResult;
+//# sourceMappingURL=feedback-stats.d.ts.map

package/dist/infrastructure/validation/feedback-stats.d.ts.map

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

package/dist/infrastructure/validation/feedback-stats.js

@@ -0,0 +1,173 @@
+/**
+ * Infrastructure: Feedback Statistics Builders
+ * Pure functions to compute feedback analytics and status snapshots
+ *
+ * Clean Architecture: Infrastructure Layer
+ * Strategic: Provides machine-readable JSON outputs for CI/dashboards
+ */
+import { getAgentThreshold } from './trust-config.js';
+/**
+ * Build feedback analytics JSON from feedback records and trust config
+ */
+export function buildFeedbackAnalyticsJson(feedback, trustConfig) {
+    const byAgent = {};
+    const byOperationMap = {};
+    // Aggregate feedback
+    for (const record of feedback) {
+        // Aggregate by agent
+        if (!byAgent[record.agentName]) {
+            byAgent[record.agentName] = {
+                totalRuns: 0,
+                outcomes: {
+                    success: 0,
+                    failure: 0,
+                    partial_success: 0,
+                    cancelled: 0,
+                    error: 0,
+                },
+                userActions: {
+                    approved: 0,
+                    rejected: 0,
+                    modified: 0,
+                    skipped: 0,
+                    not_required: 0,
+                },
+            };
+        }
+        const agentStats = byAgent[record.agentName];
+        agentStats.totalRuns++;
+        agentStats.outcomes[record.outcome] = (agentStats.outcomes[record.outcome] || 0) + 1;
+        if (record.userAction) {
+            agentStats.userActions[record.userAction] =
+                (agentStats.userActions[record.userAction] || 0) + 1;
+        }
+        // Aggregate by operation
+        if (record.operation) {
+            if (!byOperationMap[record.operation]) {
+                byOperationMap[record.operation] = {
+                    operation: record.operation,
+                    count: 0,
+                    outcomes: {
+                        success: 0,
+                        failure: 0,
+                        partial_success: 0,
+                        cancelled: 0,
+                        error: 0,
+                    },
+                };
+            }
+            const opStats = byOperationMap[record.operation];
+            opStats.count++;
+            opStats.outcomes[record.outcome] = (opStats.outcomes[record.outcome] || 0) + 1;
+        }
+    }
+    // Calculate trust scores and build agent array
+    const agents = Object.entries(byAgent)
+        .map(([agentName, stats]) => {
+        const approvedSuccessRuns = feedback.filter(f => f.agentName === agentName &&
+            f.outcome === 'success' &&
+            f.userAction === 'approved').length;
+        const trustScore = stats.totalRuns > 0
+            ? (approvedSuccessRuns / stats.totalRuns) * 100
+            : 0;
+        const threshold = getAgentThreshold(trustConfig, agentName);
+        const belowThreshold = threshold > 0 && trustScore < threshold;
+        return {
+            agentName,
+            totalRuns: stats.totalRuns,
+            trustScore: Math.round(trustScore * 100) / 100, // Round to 2 decimal places
+            belowThreshold,
+            threshold,
+            outcomes: stats.outcomes,
+            userActions: stats.userActions,
+        };
+    })
+        .sort((a, b) => b.totalRuns - a.totalRuns);
+    // Build operations array
+    const operations = Object.values(byOperationMap)
+        .sort((a, b) => b.count - a.count);
+    return {
+        totalRecords: feedback.length,
+        agents,
+        operations,
+    };
+}
+/**
+ * Build status snapshot JSON from feedback records and trust config
+ */
+export function buildStatusSnapshotJson(feedback, trustConfig) {
+    const agentStatsMap = {};
+    const operationStatsMap = {};
+    // Aggregate feedback
+    for (const record of feedback) {
+        // Aggregate by agent
+        if (!agentStatsMap[record.agentName]) {
+            agentStatsMap[record.agentName] = {
+                totalRuns: 0,
+                successRuns: 0,
+                trustScore: 0,
+            };
+        }
+        const stats = agentStatsMap[record.agentName];
+        stats.totalRuns++;
+        if (record.outcome === 'success') {
+            stats.successRuns++;
+        }
+        // Aggregate by operation
+        if (record.operation) {
+            operationStatsMap[record.operation] = (operationStatsMap[record.operation] || 0) + 1;
+        }
+    }
+    // Calculate trust scores and build agent array
+    const agents = Object.entries(agentStatsMap)
+        .map(([agentName, stats]) => {
+        const approvedSuccessRuns = feedback.filter(f => f.agentName === agentName &&
+            f.outcome === 'success' &&
+            f.userAction === 'approved').length;
+        const trustScore = stats.totalRuns > 0
+            ? (approvedSuccessRuns / stats.totalRuns) * 100
+            : 0;
+        const threshold = getAgentThreshold(trustConfig, agentName);
+        const belowThreshold = threshold > 0 && trustScore < threshold;
+        return {
+            agentName,
+            success: {
+                runs: stats.successRuns,
+                total: stats.totalRuns,
+            },
+            trustScore: Math.round(trustScore * 100) / 100, // Round to 2 decimal places
+            threshold,
+            belowThreshold,
+        };
+    })
+        .sort((a, b) => b.trustScore - a.trustScore);
+    // Build operations array
+    const operations = Object.entries(operationStatsMap)
+        .map(([operation, runs]) => ({ operation, runs }))
+        .sort((a, b) => b.runs - a.runs)
+        .slice(0, 5); // Top 5 operations
+    return {
+        totalRecords: feedback.length,
+        agents,
+        operations,
+    };
+}
+/**
+ * Evaluate trust thresholds from analytics JSON
+ * Returns agents that are below their configured thresholds
+ */
+export function evaluateTrustThresholds(analytics) {
+    const offenders = [];
+    for (const agent of analytics.agents) {
+        // Only consider agents with threshold > 0
+        if (agent.threshold > 0 && agent.trustScore < agent.threshold) {
+            offenders.push({
+                agentName: agent.agentName,
+                trustScore: agent.trustScore,
+                threshold: agent.threshold,
+            });
+        }
+    }
+    return { offenders };
+}
+//# sourceMappingURL=feedback-stats.js.map

package/dist/infrastructure/validation/feedback-stats.js.map

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

package/dist/infrastructure/validation/review-handler.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Infrastructure: Review Handler
+ * Handles --review flag behavior: pause, display summary, ask yes/no
+ */
+import type { TraceSummary } from './trace-summary.js';
+export interface ReviewDecision {
+    approved: boolean;
+    proceed: boolean;
+    reason?: string;
+    userAction: 'approved' | 'rejected' | 'not_required';
+}
+/**
+ * Review Handler
+ * Manages the review flow when --review flag is enabled
+ */
+export declare class ReviewHandler {
+    /**
+     * Request user review before proceeding
+     */
+    requestReview(summary: TraceSummary, options?: {
+        timeout?: number;
+        defaultAction?: 'approve' | 'reject';
+    }): Promise<ReviewDecision>;
+    /**
+     * Prompt user for approval (yes/no)
+     */
+    private promptApproval;
+    /**
+     * Check if review should be required based on summary
+     */
+    shouldRequireReview(summary: TraceSummary): boolean;
+    /**
+     * Get review decision - single source of truth for userAction
+     *
+     * This method is the ONLY place where userAction is determined.
+     * All CLI commands must use this method and trust its userAction value.
+     *
+     * Logic:
+     * 1. If reviewRequested === false:
+     *    → userAction = 'not_required'
+     *
+     * 2. If reviewRequested === true and shouldReview === false:
+     *    → userAction = 'approved' (user explicitly requested review, treat as approved)
+     *
+     * 3. If reviewRequested === true and shouldReview === true:
+     *    → Call requestReview() which handles:
+     *       - Interactive mode: prompt user, return 'approved' or 'rejected'
+     *       - Non-interactive + auto-approve: return 'approved'
+     *       - Non-interactive + no auto-approve: return 'rejected'
+     */
+    getReviewDecision(summary: TraceSummary, reviewRequested: boolean): Promise<ReviewDecision>;
+}
+export declare const reviewHandler: ReviewHandler;
+//# sourceMappingURL=review-handler.d.ts.map

package/dist/infrastructure/validation/review-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-handler.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/validation/review-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,cAAc,CAAC;CACtD;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;KACjC,GACL,OAAO,CAAC,cAAc,CAAC;IAkE1B;;OAEG;YACW,cAAc;IAmE5B;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAwBnD;;;;;;;;;;;;;;;;;;OAkBG;IACG,iBAAiB,CACrB,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,OAAO,GACvB,OAAO,CAAC,cAAc,CAAC;CAiC3B;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}