codehere 0.2.1 → 0.3.0-rc.1

package/dist/infrastructure/ux/team-standards.js

@@ -1,196 +0,0 @@
-/**
- * Infrastructure: Team Standards Integration
- *
- * Aligns AI-generated code with team style guides and automated linting
- * Research: Team standards integration, style guide enforcement, automated linting integration
- *
- * Features:
- * - Team style guide enforcement
- * - Automated linting integration
- * - Code formatting standards
- * - Team-specific patterns
- */
-/**
- * Team Standards Integration System
- * Enforces team style guides and integrates with linting
- */
-export class TeamStandards {
-    styleGuides = new Map();
-    defaultStyleGuide;
-    constructor() {
-        this.defaultStyleGuide = this.createDefaultStyleGuide();
-        this.styleGuides.set('default', this.defaultStyleGuide);
-    }
-    /**
-     * Load team style guide
-     */
-    loadStyleGuide(teamId, guide) {
-        this.styleGuides.set(teamId, guide);
-    }
-    /**
-     * Get style guide for team
-     */
-    getStyleGuide(teamId) {
-        return this.styleGuides.get(teamId) || this.defaultStyleGuide;
-    }
-    /**
-     * Validate code against style guide
-     */
-    validateCode(teamId, filepath, code) {
-        const styleGuide = this.getStyleGuide(teamId);
-        const issues = [];
-        const violations = [];
-        // Validate against each rule
-        for (const rule of styleGuide.rules) {
-            if (!rule.enabled)
-                continue;
-            const ruleIssues = this.checkRule(code, rule, filepath);
-            issues.push(...ruleIssues);
-            for (const issue of ruleIssues) {
-                violations.push({
-                    rule,
-                    line: issue.line,
-                    message: issue.message,
-                });
-            }
-        }
-        // Check for errors
-        const hasErrors = issues.some(i => i.severity === 'error');
-        const passed = !hasErrors;
-        return {
-            passed,
-            issues,
-            violations,
-        };
-    }
-    /**
-     * Apply style guide to code (auto-fix where possible)
-     */
-    applyStyleGuide(teamId, code, filepath) {
-        const styleGuide = this.getStyleGuide(teamId);
-        let modifiedCode = code;
-        let fixesApplied = 0;
-        const remainingIssues = [];
-        // Apply fixable rules
-        for (const rule of styleGuide.rules) {
-            if (!rule.enabled || !rule.fixable)
-                continue;
-            const { fixed, code: newCode } = this.applyRule(modifiedCode, rule, filepath);
-            if (fixed) {
-                modifiedCode = newCode;
-                fixesApplied++;
-            }
-        }
-        // Check remaining issues
-        const validation = this.validateCode(teamId, filepath, modifiedCode);
-        remainingIssues.push(...validation.issues.filter(i => !i.fixable || i.severity === 'error'));
-        return {
-            modified: modifiedCode,
-            fixesApplied,
-            remainingIssues,
-        };
-    }
-    /**
-     * Integrate with external linter (ESLint, Prettier, etc.)
-     */
-    async runLinter(filepath, code, linterConfig) {
-        // In production, this would:
-        // - Call external linter (ESLint, Prettier, etc.)
-        // - Parse linting results
-        // - Return structured results
-        // For now, return basic validation
-        const issues = [];
-        // Basic checks (in production, delegate to actual linter)
-        const lines = code.split('\n');
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i];
-            // Example: Check for trailing whitespace
-            if (line.trimEnd() !== line && line.trim().length > 0) {
-                issues.push({
-                    line: i + 1,
-                    message: 'Trailing whitespace',
-                    rule: 'no-trailing-whitespace',
-                    severity: 'warning',
-                    fixable: true,
-                    suggestedFix: line.trimEnd(),
-                });
-            }
-        }
-        const errors = issues.filter(i => i.severity === 'error');
-        const warnings = issues.filter(i => i.severity === 'warning');
-        const info = issues.filter(i => i.severity === 'info');
-        return {
-            filepath,
-            errors,
-            warnings,
-            info,
-            passed: errors.length === 0,
-        };
-    }
-    // Private helpers
-    checkRule(code, rule, filepath) {
-        const issues = [];
-        const lines = code.split('\n');
-        // Simple pattern matching (in production, use AST analysis)
-        if (rule.pattern) {
-            const regex = new RegExp(rule.pattern, 'g');
-            for (let i = 0; i < lines.length; i++) {
-                const matches = lines[i].match(regex);
-                if (matches) {
-                    issues.push({
-                        line: i + 1,
-                        message: rule.description,
-                        rule: rule.ruleId,
-                        severity: rule.severity,
-                        fixable: rule.fixable,
-                    });
-                }
-            }
-        }
-        return issues;
-    }
-    applyRule(code, rule, filepath) {
-        // Simple auto-fix (in production, use proper AST transformation)
-        let modified = code;
-        let fixed = false;
-        // Example: Fix trailing whitespace
-        if (rule.ruleId === 'no-trailing-whitespace') {
-            const lines = modified.split('\n');
-            const fixedLines = lines.map(line => line.trimEnd());
-            modified = fixedLines.join('\n');
-            fixed = modified !== code;
-        }
-        return { fixed, code: modified };
-    }
-    createDefaultStyleGuide() {
-        return {
-            teamId: 'default',
-            enabled: true,
-            version: '1.0.0',
-            createdAt: Date.now(),
-            updatedAt: Date.now(),
-            rules: [
-                {
-                    ruleId: 'no-trailing-whitespace',
-                    category: 'formatting',
-                    rule: 'Remove trailing whitespace',
-                    description: 'Lines should not end with whitespace',
-                    severity: 'warning',
-                    pattern: '\\s+$',
-                    fixable: true,
-                    enabled: true,
-                },
-                {
-                    ruleId: 'consistent-indentation',
-                    category: 'formatting',
-                    rule: 'Use consistent indentation (2 spaces)',
-                    description: 'Use 2 spaces for indentation',
-                    severity: 'error',
-                    fixable: true,
-                    enabled: true,
-                },
-            ],
-        };
-    }
-}
-//# sourceMappingURL=team-standards.js.map

package/dist/infrastructure/ux/transparency.js

@@ -1,71 +0,0 @@
-/**
- * Transparency Bar — show timing, tokens, model after every AI response
- *
- * v0.3.0: Makes every interaction feel measurable.
- */
-import chalk from 'chalk';
-const dim = chalk.dim;
-/**
- * Format a transparency line for display after an AI response.
- * Example: "  2.4s · ~320 tokens · Claude Sonnet"
- */
-export function formatTransparency(info) {
-    const parts = [];
-    // Elapsed time
-    const seconds = (info.elapsedMs / 1000).toFixed(1);
-    parts.push(`${seconds}s`);
-    // Token estimate
-    if (info.tokenEstimate && info.tokenEstimate > 0) {
-        parts.push(`~${info.tokenEstimate} tokens`);
-    }
-    // Model name (clean up long IDs)
-    if (info.model) {
-        parts.push(cleanModelName(info.model));
-    }
-    return dim('  ' + parts.join(' · '));
-}
-/**
- * Format hook block stats for display.
- * Example: "  blocked 5 times this session · 72 total"
- */
-export function formatBlockStats(sessionBlocks, totalBlocks) {
-    const parts = [];
-    if (sessionBlocks > 0) {
-        parts.push(`blocked ${sessionBlocks} time${sessionBlocks !== 1 ? 's' : ''} this session`);
-    }
-    if (totalBlocks > 0) {
-        parts.push(`${totalBlocks} total`);
-    }
-    if (parts.length === 0)
-        return '';
-    return dim('  ' + parts.join(' · '));
-}
-/**
- * Clean up model ID to a short display name.
- * "claude-sonnet-4-20250514" → "Claude Sonnet"
- * "gpt-4o" → "GPT-4o"
- */
-function cleanModelName(model) {
-    const lower = model.toLowerCase();
-    if (lower.includes('claude') && lower.includes('opus'))
-        return 'Claude Opus';
-    if (lower.includes('claude') && lower.includes('sonnet'))
-        return 'Claude Sonnet';
-    if (lower.includes('claude') && lower.includes('haiku'))
-        return 'Claude Haiku';
-    if (lower.includes('gpt-4o'))
-        return 'GPT-4o';
-    if (lower.includes('gpt-4'))
-        return 'GPT-4';
-    if (lower.includes('gpt-3.5'))
-        return 'GPT-3.5';
-    // Fallback: return as-is but truncated
-    return model.length > 30 ? model.slice(0, 27) + '...' : model;
-}
-/**
- * Estimate token count from text (rough: ~4 chars per token for English).
- */
-export function estimateTokens(text) {
-    return Math.round(text.length / 4);
-}
-//# sourceMappingURL=transparency.js.map

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

@@ -1,55 +0,0 @@
-/**
- * Agent Feedback
- * Records and manages feedback about agent operations
- *
- * Phase 1: v0.5.0-alpha.0
- */
-/**
- * Agent Feedback Manager
- */
-class AgentFeedbackManager {
-    feedbackRecords = [];
-    maxRecords = 1000;
-    /**
-     * Record feedback for an agent operation
-     */
-    recordFeedback(feedback) {
-        const record = {
-            ...feedback,
-            timestamp: feedback.timestamp || Date.now(),
-        };
-        this.feedbackRecords.push(record);
-        // Trim old records if too many
-        if (this.feedbackRecords.length > this.maxRecords) {
-            this.feedbackRecords = this.feedbackRecords.slice(-this.maxRecords);
-        }
-        // In alpha, feedback is stored in memory only
-        // Can be enhanced later to persist to disk
-    }
-    /**
-     * Get feedback records for an agent
-     */
-    getFeedbackForAgent(agentName, limit = 10) {
-        return this.feedbackRecords
-            .filter(r => r.agentName === agentName)
-            .slice(-limit)
-            .reverse();
-    }
-    /**
-     * Get all feedback records
-     */
-    getAllFeedback(limit = 100) {
-        return this.feedbackRecords.slice(-limit).reverse();
-    }
-}
-export const agentFeedbackManager = new AgentFeedbackManager();
-/**
- * AgentFeedback class (kept for backward compatibility)
- */
-export class AgentFeedback {
-    data;
-    constructor(data) {
-        this.data = data;
-    }
-}
-//# sourceMappingURL=agent-feedback.js.map

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

@@ -1,137 +0,0 @@
-/**
- * Agent Validation Helper
- * Validates agent outputs and checks trust scores
- *
- * Phase 1: v0.5.0-alpha.0
- */
-import { TraceSummary } from './trace-summary.js';
-import { executionTracer } from '../observability/execution-tracer.js';
-import { randomUUID } from 'crypto';
-/**
- * Agent validation helper
- */
-export const agentValidationHelper = {
-    /**
-     * Start an agent operation and return validation context
-     */
-    startAgentOperation(agentName, operation, metadata) {
-        return {
-            agentName,
-            operation,
-            startTime: Date.now(),
-            metadata,
-        };
-    },
-    /**
-     * Complete an agent operation and return validation result
-     */
-    async completeAgentOperation(context, result, options) {
-        const endTime = Date.now();
-        const duration = endTime - context.startTime;
-        const opts = options || {};
-        // Basic validation
-        const issues = [];
-        const warnings = [];
-        // Check validation checks
-        if (opts.validationChecks) {
-            for (const check of opts.validationChecks) {
-                if (!check.passed) {
-                    issues.push(check.message || check.check);
-                }
-            }
-        }
-        // Check errors
-        if (opts.errors && opts.errors.length > 0) {
-            issues.push(...opts.errors.map((e) => typeof e === 'string' ? e : e.message || String(e)));
-        }
-        // Check warnings
-        if (opts.warnings && opts.warnings.length > 0) {
-            warnings.push(...opts.warnings.map((w) => typeof w === 'string' ? w : w.message || String(w)));
-        }
-        // Check outcome
-        if (opts.outcome === 'failure') {
-            issues.push('Operation failed');
-        }
-        else if (opts.outcome === 'partial_success') {
-            warnings.push('Operation partially succeeded');
-        }
-        // Check overallSuccess in result
-        if (result && result.overallSuccess === false) {
-            issues.push('Overall operation was not successful');
-        }
-        // Get runId from execution tracer
-        const runId = executionTracer.getCurrentRunId();
-        // Generate feedbackId
-        const feedbackId = randomUUID();
-        // Collect files affected
-        const filesAffected = [];
-        if (opts.filesChanged)
-            filesAffected.push(...opts.filesChanged);
-        if (opts.filesCreated)
-            filesAffected.push(...opts.filesCreated);
-        if (opts.filesDeleted)
-            filesAffected.push(...opts.filesDeleted);
-        // Create trace summary
-        const summaryData = {
-            runId: runId || `run-${Date.now()}`,
-            agentName: context.agentName,
-            operation: context.operation,
-            startTime: context.startTime,
-            endTime,
-            success: issues.length === 0,
-            filesAffected: filesAffected.length > 0 ? filesAffected : undefined,
-            error: issues.length > 0 ? issues.join('; ') : undefined,
-            metadata: {
-                ...context.metadata,
-                duration,
-                validationChecks: opts.validationChecks?.length || 0,
-            },
-        };
-        const summary = new TraceSummary(summaryData);
-        return {
-            passed: issues.length === 0,
-            issues: issues.length > 0 ? issues : undefined,
-            warnings: warnings.length > 0 ? warnings : undefined,
-            score: issues.length === 0 ? 1.0 : Math.max(0, 1.0 - (issues.length * 0.2)),
-            summary,
-            feedbackId,
-            runId,
-        };
-    },
-    /**
-     * Trace an operation step
-     */
-    trace(data) {
-        // In alpha, tracing is a no-op
-        // Can be enhanced later to log to execution tracer
-    },
-    /**
-     * Validate agent output
-     */
-    validate(output, context) {
-        // Basic validation - can be enhanced later
-        if (!output) {
-            return {
-                passed: false,
-                issues: ['Output is empty'],
-            };
-        }
-        return {
-            passed: true,
-            score: 1.0,
-        };
-    },
-    /**
-     * Check trust score for an agent
-     */
-    checkTrust(agentName, operation) {
-        // In alpha, default to passing
-        // Can be enhanced later with actual trust score tracking
-        return {
-            passed: true,
-            trustScore: 1.0,
-            threshold: 0.7,
-        };
-    },
-};
-//# sourceMappingURL=agent-validation-helper.js.map

package/dist/infrastructure/validation/review-handler.js

@@ -1,40 +0,0 @@
-/**
- * Review Handler
- * Handles review requests and decisions
- *
- * Phase 1: v0.5.0-alpha.0
- */
-/**
- * Review handler instance
- */
-export const reviewHandler = {
-    /**
-     * Request review from user
-     */
-    async requestReview(summary) {
-        // In alpha, auto-approve for non-interactive mode
-        // Can be enhanced later with interactive prompts
-        console.log('\n📋 Review Request:');
-        console.log(summary);
-        console.log('\n[Auto-approved in alpha mode]');
-        return {
-            approved: true,
-            proceed: true,
-            userAction: 'approved',
-        };
-    },
-    /**
-     * Get review decision (with optional review requested flag)
-     */
-    async getReviewDecision(summary, reviewRequested) {
-        if (!reviewRequested) {
-            return {
-                approved: true,
-                proceed: true,
-                userAction: 'not_required',
-            };
-        }
-        return this.requestReview(summary);
-    },
-};
-//# sourceMappingURL=review-handler.js.map

package/dist/infrastructure/validation/summary-aggregator.js

@@ -1,70 +0,0 @@
-/**
- * Summary Aggregator
- * Merges multiple trace summaries into a composite summary
- *
- * Phase 1: v0.5.0-alpha.0
- */
-/**
- * Summary aggregator instance
- */
-class SummaryAggregatorImpl {
-    /**
-     * Merge multiple trace summaries into a composite summary
-     */
-    mergeSummaries(agentSummaries, unifiedRunId, operation) {
-        if (agentSummaries.length === 0) {
-            return {
-                runId: unifiedRunId,
-                operation,
-                agents: [],
-                totalDuration: 0,
-                success: true,
-                summaries: [],
-                filesAffected: [],
-                errors: [],
-                startTime: Date.now(),
-            };
-        }
-        // Collect all data
-        const agents = [];
-        const filesAffected = new Set();
-        const errors = [];
-        let minStartTime = Infinity;
-        let maxEndTime = 0;
-        let allSuccess = true;
-        for (const { agent, summary } of agentSummaries) {
-            agents.push(agent);
-            const data = summary.data;
-            if (!data.success) {
-                allSuccess = false;
-            }
-            if (data.startTime < minStartTime) {
-                minStartTime = data.startTime;
-            }
-            if (data.endTime && data.endTime > maxEndTime) {
-                maxEndTime = data.endTime;
-            }
-            if (data.filesAffected) {
-                data.filesAffected.forEach(f => filesAffected.add(f));
-            }
-            if (data.error) {
-                errors.push(`${agent}: ${data.error}`);
-            }
-        }
-        const compositeSummary = {
-            runId: unifiedRunId,
-            operation,
-            agents,
-            totalDuration: maxEndTime > 0 ? maxEndTime - minStartTime : 0,
-            success: allSuccess,
-            summaries: agentSummaries,
-            filesAffected: Array.from(filesAffected),
-            errors,
-            startTime: minStartTime !== Infinity ? minStartTime : Date.now(),
-            endTime: maxEndTime > 0 ? maxEndTime : undefined,
-        };
-        return compositeSummary;
-    }
-}
-export const summaryAggregator = new SummaryAggregatorImpl();
-//# sourceMappingURL=summary-aggregator.js.map

package/dist/infrastructure/validation/summary-extractor.js

@@ -1,45 +0,0 @@
-/**
- * Summary Extractor
- * Extracts summaries from routing and orchestration results
- *
- * Phase 1: v0.5.0-alpha.0
- */
-/**
- * Summary extractor instance
- */
-export const summaryExtractor = {
-    /**
-     * Extract summary from routing result
-     */
-    extractFromRouting(result) {
-        if (!result) {
-            return null;
-        }
-        const summary = result.message || result.summary || 'Operation completed';
-        return {
-            summary,
-            metadata: {
-                action: result.action,
-                success: result.success,
-            },
-        };
-    },
-    /**
-     * Extract summary from orchestration result
-     */
-    extractFromOrchestration(result) {
-        if (!result) {
-            return null;
-        }
-        const summary = result.message || result.summary || 'Orchestration completed';
-        return {
-            summary,
-            metadata: {
-                success: result.success,
-                planId: result.plan?.id,
-                executionStatus: result.execution?.status,
-            },
-        };
-    },
-};
-//# sourceMappingURL=summary-extractor.js.map

package/dist/infrastructure/validation/trace-summary.js

@@ -1,52 +0,0 @@
-/**
- * Trace Summary
- * Represents execution trace summaries for agents
- *
- * Phase 1: v0.5.0-alpha.0
- */
-/**
- * Trace Summary class
- */
-export class TraceSummary {
-    data;
-    constructor(data) {
-        this.data = data;
-    }
-    /**
-     * Get summary as JSON
-     */
-    toJSON() {
-        return this.data;
-    }
-    /**
-     * Get duration in milliseconds
-     */
-    getDuration() {
-        if (this.data.endTime && this.data.startTime) {
-            return this.data.endTime - this.data.startTime;
-        }
-        return Date.now() - this.data.startTime;
-    }
-}
-/**
- * Format trace summary for display
- */
-export const traceSummaryFormatter = {
-    format(summary) {
-        const data = summary.data;
-        const duration = summary.getDuration();
-        const lines = [];
-        lines.push(`Agent: ${data.agentName}`);
-        lines.push(`Operation: ${data.operation}`);
-        lines.push(`Status: ${data.success ? 'Success' : 'Failed'}`);
-        lines.push(`Duration: ${(duration / 1000).toFixed(2)}s`);
-        if (data.filesAffected && data.filesAffected.length > 0) {
-            lines.push(`Files affected: ${data.filesAffected.length}`);
-        }
-        if (data.error) {
-            lines.push(`Error: ${data.error}`);
-        }
-        return lines.join('\n');
-    },
-};
-//# sourceMappingURL=trace-summary.js.map