stringray-ai 1.0.0

package/dist/plugin/processors/processor-types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * StringRay Framework v1.0.0 - Processor Types
+ *
+ * Type definitions for the processor activation system.
+ *
+ * @version 1.0.0
+ * @since 2026-01-07
+ */
+export interface PreValidateContext {
+    operation: string;
+    data: any;
+    syntaxCheck?: boolean;
+    codexCompliance?: boolean;
+}
+export interface PostValidateContext {
+    operation: string;
+    data: any;
+    preResults: any[];
+    testResults?: any;
+    regressionResults?: any;
+    stateValidation?: boolean;
+}
+export interface ProcessorHook {
+    name: string;
+    execute: (context: PreValidateContext | PostValidateContext) => Promise<any>;
+    priority: number;
+    enabled: boolean;
+}
+export interface ProcessorRegistration {
+    name: string;
+    type: "pre" | "post";
+    hook: ProcessorHook;
+}
+export interface ProcessorExecutionResult {
+    success: boolean;
+    result?: any;
+    error?: string;
+    duration: number;
+    processorName: string;
+}
+export interface ProcessorHealthCheck {
+    name: string;
+    status: "healthy" | "degraded" | "failed";
+    lastRun: number;
+    successRate: number;
+    averageExecutionTime: number;
+    totalRuns: number;
+    failedRuns: number;
+}
+//# sourceMappingURL=processor-types.d.ts.map

package/dist/plugin/processors/processor-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-types.d.ts","sourceRoot":"","sources":["../../../src/processors/processor-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,iBAAiB,CAAC,EAAE,GAAG,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/plugin/processors/processor-types.js

@@ -0,0 +1,10 @@
+/**
+ * StringRay Framework v1.0.0 - Processor Types
+ *
+ * Type definitions for the processor activation system.
+ *
+ * @version 1.0.0
+ * @since 2026-01-07
+ */
+export {};
+//# sourceMappingURL=processor-types.js.map

package/dist/plugin/processors/processor-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-types.js","sourceRoot":"","sources":["../../../src/processors/processor-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/plugin/processors/refactoring-logging-processor.d.ts

@@ -0,0 +1,61 @@
+/**
+ * StringRay Framework v1.0.0 - Refactoring Logging Processor
+ *
+ * Post-processor that automatically logs agent task completions to REFACTORING_LOG.md
+ * for pattern analysis and continuous improvement.
+ *
+ * @version 1.0.0
+ * @since 2026-01-12
+ */
+import { ProcessorHook, ProcessorRegistration } from "./processor-types";
+export interface AgentTaskContext {
+    agentName: string;
+    task: string;
+    startTime: number;
+    endTime: number;
+    success: boolean;
+    result?: any;
+    capabilities?: string[] | undefined;
+    sessionId?: string | undefined;
+}
+/**
+ * Refactoring Logging Post-Processor
+ * Automatically logs agent task completions for pattern analysis
+ */
+export declare class RefactoringLoggingProcessor implements ProcessorHook {
+    name: string;
+    priority: number;
+    enabled: boolean;
+    debugEnabled: boolean;
+    execute(context: any): Promise<any>;
+    private isAgentTaskContext;
+    private formatLogEntry;
+    private summarizeResult;
+    private categorizeTask;
+    private assessComplexity;
+    private identifySuccessFactors;
+    /**
+     * Enable or disable debug logging
+     */
+    setDebugEnabled(enabled: boolean): void;
+    /**
+     * Check if debug logging is enabled
+     */
+    isDebugEnabled(): boolean;
+    private appendToRefactoringLog;
+}
+export declare const refactoringLoggingProcessor: ProcessorRegistration;
+/**
+
+
+}
+
+/**
+ * Helper function to create agent task context for logging
+ */
+export declare function createAgentTaskContext(agentName: string, task: string, startTime: number, success: boolean, result?: any, capabilities?: string[], sessionId?: string): AgentTaskContext;
+/**
+ * Manual test function to verify refactoring logging works
+ */
+export declare function testRefactoringLogging(): Promise<void>;
+//# sourceMappingURL=refactoring-logging-processor.d.ts.map

package/dist/plugin/processors/refactoring-logging-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactoring-logging-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/refactoring-logging-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,2BAA4B,YAAW,aAAa;IAC/D,IAAI,SAAyB;IAC7B,QAAQ,SAAO;IACf,OAAO,UAAQ;IACf,YAAY,UAAkG;IAExG,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAyEzC,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,sBAAsB;IAoB9B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIvC;;OAEG;IACH,cAAc,IAAI,OAAO;YAIX,sBAAsB;CAgBrC;AAGD,eAAO,MAAM,2BAA2B,EAAE,qBAIzC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,GAAG,EACZ,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,gBAAgB,CAWlB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgD5D"}

package/dist/plugin/processors/refactoring-logging-processor.js

@@ -0,0 +1,257 @@
+/**
+ * StringRay Framework v1.0.0 - Refactoring Logging Processor
+ *
+ * Post-processor that automatically logs agent task completions to REFACTORING_LOG.md
+ * for pattern analysis and continuous improvement.
+ *
+ * @version 1.0.0
+ * @since 2026-01-12
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { frameworkLogger } from "../framework-logger.js";
+/**
+ * Refactoring Logging Post-Processor
+ * Automatically logs agent task completions for pattern analysis
+ */
+export class RefactoringLoggingProcessor {
+    name = "refactoring-logging";
+    priority = 100; // High priority to ensure logging happens
+    enabled = true;
+    debugEnabled = process.env.STRRAY_DEBUG_LOGGING === "true" || process.env.NODE_ENV === "development" || false;
+    async execute(context) {
+        if (this.debugEnabled) {
+            console.log("🔍 RefactoringLoggingProcessor.execute called with context:", {
+                hasAgentName: !!context.agentName,
+                hasTask: !!context.task,
+                hasStartTime: typeof context.startTime === "number",
+                contextKeys: Object.keys(context),
+            });
+        }
+        // Check if this is an agent task completion context
+        if (!this.isAgentTaskContext(context)) {
+            if (this.debugEnabled) {
+                console.log("❌ Not an agent task context, returning early");
+            }
+            return { logged: false, reason: "Not an agent task context" };
+        }
+        if (this.debugEnabled) {
+            console.log("✅ Valid agent task context detected, proceeding with logging");
+        }
+        const taskContext = context;
+        const duration = taskContext.endTime - taskContext.startTime;
+        try {
+            // Format the log entry
+            const logEntry = this.formatLogEntry(taskContext, duration);
+            // Write to REFACTORING_LOG.md
+            await this.appendToRefactoringLog(logEntry);
+            // Also log to framework logger
+            await frameworkLogger.log("refactoring-logging", "agent-task-logged", "info", {
+                agentName: taskContext.agentName,
+                task: taskContext.task.substring(0, 100),
+                duration,
+                success: taskContext.success,
+            });
+            return {
+                logged: true,
+                logEntry: logEntry.substring(0, 200) + "...", // Truncated for response
+                duration,
+            };
+        }
+        catch (error) {
+            await frameworkLogger.log("refactoring-logging", "logging-failed", "error", {
+                agentName: taskContext.agentName,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                logged: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    isAgentTaskContext(context) {
+        return (context &&
+            typeof context.agentName === "string" &&
+            typeof context.task === "string" &&
+            typeof context.startTime === "number" &&
+            typeof context.endTime === "number" &&
+            typeof context.success === "boolean");
+    }
+    formatLogEntry(context, duration) {
+        const timestamp = new Date().toISOString();
+        const durationSeconds = (duration / 1000).toFixed(2);
+        return `## 🤖 Agent Task Completion: ${context.agentName}
+
+**Agent**: ${context.agentName}
+**Task**: ${context.task}
+**Execution Time**: ${durationSeconds} seconds
+**Timestamp**: ${timestamp}
+**Capabilities Used**: ${context.capabilities?.join(", ") || "unknown"}
+
+### Agent Context
+- Agent Type: TypeScript Agent
+- Session ID: ${context.sessionId || "unknown"}
+- Framework Version: StringRay v1.0.0
+- Auto-logged: True
+
+### Performance Metrics
+- Task Duration: ${durationSeconds}s
+- Success Status: ${context.success ? "✅ Completed" : "❌ Failed"}
+- Result Size: ${JSON.stringify(context.result).length} characters
+
+### Task Result Summary
+${this.summarizeResult(context.result)}
+
+### Pattern Analysis Data
+- Task Category: ${this.categorizeTask(context.task)}
+- Complexity Level: ${this.assessComplexity(context.task, duration)}
+- Success Factors: ${this.identifySuccessFactors(context)}`;
+    }
+    summarizeResult(result) {
+        if (!result)
+            return "No result data available";
+        if (typeof result === "string") {
+            return result.length > 500 ? result.substring(0, 500) + "..." : result;
+        }
+        try {
+            const jsonStr = JSON.stringify(result, null, 2);
+            return jsonStr.length > 500 ? jsonStr.substring(0, 500) + "..." : jsonStr;
+        }
+        catch {
+            return "Complex result data (cannot serialize)";
+        }
+    }
+    categorizeTask(task) {
+        const lowerTask = task.toLowerCase();
+        if (lowerTask.includes("review") || lowerTask.includes("audit"))
+            return "Code Review";
+        if (lowerTask.includes("design") || lowerTask.includes("architect"))
+            return "System Design";
+        if (lowerTask.includes("test") || lowerTask.includes("testing"))
+            return "Testing";
+        if (lowerTask.includes("refactor") || lowerTask.includes("improve"))
+            return "Refactoring";
+        if (lowerTask.includes("debug") || lowerTask.includes("fix"))
+            return "Debugging";
+        if (lowerTask.includes("security"))
+            return "Security";
+        return "General Development";
+    }
+    assessComplexity(task, duration) {
+        const words = task.split(" ").length;
+        const durationMinutes = duration / (1000 * 60);
+        if (durationMinutes > 10 || words > 50)
+            return "High";
+        if (durationMinutes > 5 || words > 25)
+            return "Medium";
+        return "Low";
+    }
+    identifySuccessFactors(context) {
+        const factors = [];
+        if (context.capabilities && context.capabilities.length > 0) {
+            factors.push("capabilities-utilized");
+        }
+        if (context.success) {
+            factors.push("task-completed");
+        }
+        else {
+            factors.push("task-failed");
+        }
+        if (context.result) {
+            factors.push("result-generated");
+        }
+        return factors.join(", ");
+    }
+    /**
+     * Enable or disable debug logging
+     */
+    setDebugEnabled(enabled) {
+        this.debugEnabled = enabled;
+    }
+    /**
+     * Check if debug logging is enabled
+     */
+    isDebugEnabled() {
+        return this.debugEnabled;
+    }
+    async appendToRefactoringLog(content) {
+        const projectRoot = process.cwd();
+        const logPath = path.join(projectRoot, ".opencode", "REFACTORING_LOG.md");
+        // Ensure directory exists
+        const logDir = path.dirname(logPath);
+        if (!fs.existsSync(logDir)) {
+            fs.mkdirSync(logDir, { recursive: true });
+        }
+        // Format entry with separators
+        const entry = `\n\n---\n\n${content}\n\n---\n\n_This entry was automatically logged by the StringRay Framework refactoring logging processor._`;
+        // Append to file
+        await fs.promises.appendFile(logPath, entry, "utf-8");
+    }
+}
+// Create processor registration
+export const refactoringLoggingProcessor = {
+    name: "refactoring-logging",
+    type: "post",
+    hook: new RefactoringLoggingProcessor(),
+};
+/**
+
+
+}
+
+/**
+ * Helper function to create agent task context for logging
+ */
+export function createAgentTaskContext(agentName, task, startTime, success, result, capabilities, sessionId) {
+    return {
+        agentName,
+        task,
+        startTime,
+        endTime: Date.now(),
+        success,
+        result,
+        capabilities,
+        sessionId,
+    };
+}
+/**
+ * Manual test function to verify refactoring logging works
+ */
+export async function testRefactoringLogging() {
+    console.log("🧪 Testing Refactoring Logging Processor...");
+    const processor = new RefactoringLoggingProcessor();
+    processor.setDebugEnabled(true);
+    // Create test context
+    const testContext = createAgentTaskContext("test-agent", "Test task for REFACTORING_LOG.md verification", Date.now() - 5000, // 5 seconds ago
+    true, // success
+    "This is a test result that should be logged verbatim to REFACTORING_LOG.md", ["testing", "logging", "verification"], "test-session-123");
+    console.log("📝 Test context created:", {
+        agentName: testContext.agentName,
+        task: testContext.task.substring(0, 50) + "...",
+        duration: testContext.endTime - testContext.startTime,
+        success: testContext.success
+    });
+    try {
+        const result = await processor.execute(testContext);
+        console.log("✅ Refactoring logging test result:", result);
+        // Check if file was written
+        const fs = await import("fs");
+        const path = await import("path");
+        const logPath = path.join(process.cwd(), ".opencode", "REFACTORING_LOG.md");
+        if (fs.existsSync(logPath)) {
+            const content = fs.readFileSync(logPath, "utf-8");
+            const hasTestEntry = content.includes("test-agent");
+            console.log("📄 REFACTORING_LOG.md exists:", hasTestEntry ? "✅ Contains test entry" : "❌ Missing test entry");
+            if (hasTestEntry) {
+                console.log("🎯 SUCCESS: Agent summary was written to REFACTORING_LOG.md");
+            }
+        }
+        else {
+            console.log("❌ REFACTORING_LOG.md file not found");
+        }
+    }
+    catch (error) {
+        console.error("❌ Refactoring logging test failed:", error);
+    }
+}
+//# sourceMappingURL=refactoring-logging-processor.js.map

package/dist/plugin/processors/refactoring-logging-processor.js.map

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

package/dist/plugin/reporting/framework-reporting-system.d.ts

@@ -0,0 +1,157 @@
+/**
+ * StringRay Framework - On-Demand Reporting System
+ *
+ * Automated reporting infrastructure for comprehensive framework analysis.
+ * Generates detailed orchestration, agent usage, and performance reports on demand.
+ *
+ * @version 1.0.0
+ * @since 2026-01-11
+ */
+export interface ReportConfig {
+    type: "orchestration" | "agent-usage" | "context-awareness" | "performance" | "full-analysis";
+    sessionId?: string;
+    timeRange?: {
+        start?: Date;
+        end?: Date;
+        lastHours?: number;
+    };
+    outputFormat: "markdown" | "json" | "html";
+    outputPath?: string;
+    includeCharts?: boolean;
+    detailedMetrics?: boolean;
+}
+export interface OrchestrationMetrics {
+    totalDelegations: number;
+    agentUsage: Map<string, number>;
+    complexityDistribution: Map<string, number>;
+    successRate: number;
+    averageResponseTime: number;
+    contextOperations: number;
+    enhancementSuccessRate: number;
+    commandUsage: Map<string, number>;
+    toolExecutionStats: {
+        totalCommands: number;
+        uniqueTools: number;
+        mostUsedTool: string;
+        toolSuccessRate: Map<string, {
+            success: number;
+            total: number;
+            rate: number;
+        }>;
+    };
+    systemOperationDetails: {
+        fileOperations: number;
+        searchOperations: number;
+        terminalOperations: number;
+        analysisOperations: number;
+        orchestrationOperations: number;
+    };
+}
+export interface ReportData {
+    generatedAt: Date;
+    timeRange: {
+        start: Date;
+        end: Date;
+    };
+    metrics: OrchestrationMetrics;
+    chronologicalEvents: any[];
+    insights: string[];
+    recommendations: string[];
+    summary: {
+        totalEvents: number;
+        activeComponents: string[];
+        peakActivity: {
+            timestamp: Date;
+            eventsPerMinute: number;
+        };
+        healthScore: number;
+    };
+}
+export declare class FrameworkReportingSystem {
+    private logRetentionHours;
+    private reportCache;
+    /**
+     * Generate on-demand report based on configuration
+     */
+    generateReport(config: ReportConfig): Promise<string>;
+    /**
+     * Schedule automated report generation
+     */
+    scheduleAutomatedReports(schedule: {
+        frequency: "hourly" | "daily" | "weekly";
+        types: ReportConfig["type"][];
+        outputDir: string;
+        retentionDays: number;
+    }): void;
+    /**
+     * Get real-time framework status
+     */
+    getRealtimeStatus(): Promise<{
+        activeComponents: string[];
+        recentActivity: any[];
+        healthScore: number;
+        alerts: string[];
+    }>;
+    /**
+     * Create custom report templates
+     */
+    createCustomReport(template: {
+        name: string;
+        filters: {
+            components?: string[];
+            actions?: string[];
+            status?: string[];
+            timeRange?: {
+                start: Date;
+                end: Date;
+            };
+        };
+        aggregations: {
+            groupBy: "component" | "action" | "status" | "hour";
+            metrics: ("count" | "avgResponseTime" | "successRate")[];
+        };
+        visualizations: ("timeline" | "pie-chart" | "bar-chart")[];
+    }): string;
+    private generateReportId;
+    private getCachedReport;
+    private isCacheValid;
+    private cacheReport;
+    /**
+     * Get comprehensive logs including current and rotated files
+     */
+    private getComprehensiveLogs;
+    /**
+     * Read and parse rotated log files for historical data
+     */
+    private readRotatedLogFiles;
+    /**
+     * Parse a compressed log file and extract relevant entries
+     */
+    private parseCompressedLogFile;
+    /**
+     * Read and parse the current log file
+     */
+    private readCurrentLogFile;
+    /**
+     * Parse a single log line into structured format
+     */
+    private parseLogLine;
+    private collectReportData;
+    private filterLogsByConfig;
+    private calculateTimeRange;
+    private calculateMetrics;
+    private calculatePeakActivity;
+    private calculateHealthScore;
+    private generateInsights;
+    private generateRecommendations;
+    private generateAlerts;
+    private getHighFrequencyComponents;
+    private formatReport;
+    private formatAsMarkdown;
+    private formatAsHtml;
+    private saveReportToFile;
+    private cleanupOldReports;
+    private getIntervalMs;
+}
+export declare const frameworkReportingSystem: FrameworkReportingSystem;
+//# sourceMappingURL=framework-reporting-system.d.ts.map

package/dist/plugin/reporting/framework-reporting-system.d.ts.map

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