stringray-ai 1.0.0

package/dist/plugin/context-loader.js

@@ -0,0 +1,273 @@
+/**
+ * StringRay Context Loader
+ *
+ * Loads Universal Development Codex v1.2.20 context for agent initialization.
+ * Provides structured access to 30+ codex terms, interweaves, lenses, and anti-patterns.
+ *
+ * @version 1.0.0
+ * @since 2026-01-06
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { parseCodexContent, detectContentFormat, } from "./utils/codex-parser.js";
+/**
+ * Type guard for regex match results
+ */
+function isValidMatch(match, index) {
+    return match !== null && match[index] !== undefined;
+}
+/**
+ * StringRay Context Loader
+ *
+ * Loads and parses the Universal Development Codex v1.2.20 from codex.json
+ */
+export class StringRayContextLoader {
+    static instance;
+    cachedContext = null;
+    codexFilePaths = [];
+    constructor() {
+        this.codexFilePaths = [".strray/codex.json", "codex.json"];
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!StringRayContextLoader.instance) {
+            StringRayContextLoader.instance = new StringRayContextLoader();
+        }
+        return StringRayContextLoader.instance;
+    }
+    /**
+     * Load codex context
+     *
+     * Attempts to load the Universal Development Codex from multiple possible locations.
+     * Returns cached context if available and not expired.
+     */
+    async loadCodexContext(projectRoot) {
+        const warnings = [];
+        // Validate project root
+        if (!projectRoot || projectRoot.trim() === "") {
+            return {
+                success: false,
+                error: "Invalid project root path: path cannot be empty",
+                warnings,
+            };
+        }
+        if (this.cachedContext) {
+            return {
+                success: true,
+                context: this.cachedContext,
+                warnings,
+            };
+        }
+        for (const relativePath of this.codexFilePaths) {
+            const fullPath = path.join(projectRoot, relativePath);
+            if (fs.existsSync(fullPath)) {
+                try {
+                    const content = fs.readFileSync(fullPath, "utf-8");
+                    const context = this.parseCodexContent(content, fullPath);
+                    this.cachedContext = context;
+                    return {
+                        success: true,
+                        context,
+                        warnings,
+                    };
+                }
+                catch (error) {
+                    const msg = `Failed to parse ${fullPath}: ${error instanceof Error ? error.message : String(error)}`;
+                    warnings.push(msg);
+                }
+            }
+        }
+        return {
+            success: false,
+            error: "No valid codex file found. Checked: " + this.codexFilePaths.join(", "),
+            warnings,
+        };
+    }
+    /**
+     * Parse codex content from JSON or Markdown
+     *
+     * Extracts all 30+ codex terms, interweaves, lenses, and principles from content.
+     * Supports both JSON and Markdown formats with explicit format detection.
+     */
+    parseCodexContent(content, sourcePath) {
+        // Validate inputs before format detection
+        if (!content || content.trim() === "") {
+            throw new Error("Invalid content provided");
+        }
+        if (!sourcePath || sourcePath.trim() === "") {
+            throw new Error("Invalid source path provided");
+        }
+        // Detect format before parsing
+        const formatResult = detectContentFormat(content);
+        if (formatResult.format === "unknown") {
+            throw new Error(`Unable to detect content format for ${sourcePath}. Content appears to be neither valid JSON nor Markdown.`);
+        }
+        // Log format detection for debugging
+        console.log(`StringRay: Detected ${formatResult.format} format for ${sourcePath} (confidence: ${formatResult.confidence})`);
+        const result = parseCodexContent(content, sourcePath);
+        if (!result.success) {
+            throw new Error(result.error || "Failed to parse codex content");
+        }
+        if (!result.context) {
+            throw new Error("Parsing succeeded but no context was returned");
+        }
+        return result.context;
+    }
+    inferTermCategory(termNumber, termName) {
+        if (termNumber <= 10) {
+            return "core";
+        }
+        else if (termNumber <= 20) {
+            return "extended";
+        }
+        else if (termNumber <= 30) {
+            return "architecture";
+        }
+        else {
+            return "advanced";
+        }
+    }
+    /**
+     * Get specific codex term by number
+     */
+    getTerm(context, termNumber) {
+        return context.terms.get(termNumber);
+    }
+    /**
+     * Get all core terms (1-10)
+     */
+    getCoreTerms(context) {
+        return Array.from(context.terms.values())
+            .filter((term) => term.category === "core")
+            .sort((a, b) => a.number - b.number);
+    }
+    /**
+     * Get zero-tolerance terms that require immediate blocking
+     */
+    getZeroToleranceTerms(context) {
+        return Array.from(context.terms.values())
+            .filter((term) => term.zeroTolerance || term.enforcementLevel === "blocking")
+            .sort((a, b) => a.number - b.number);
+    }
+    /**
+     * Validate action against codex
+     *
+     * Checks if an action complies with relevant codex terms.
+     * Returns validation result with violations and recommendations.
+     */
+    validateAgainstCodex(context, action, actionDetails) {
+        // Input validation
+        if (!context || !context.terms) {
+            throw new Error("Invalid codex context provided");
+        }
+        if (!action || action.trim() === "") {
+            throw new Error("Invalid action provided");
+        }
+        const violations = [];
+        const recommendations = [];
+        if (actionDetails.includesAny) {
+            const dangerousPatterns = ["any", "@ts-ignore", "@ts-expect-error"];
+            if (dangerousPatterns.some((pattern) => action.includes(pattern))) {
+                const term11 = context.terms.get(11);
+                if (term11) {
+                    violations.push({
+                        term: term11,
+                        reason: 'Type safety violation detected - using "any" or type suppression',
+                        severity: term11.enforcementLevel || "high",
+                    });
+                }
+            }
+        }
+        // Check for unresolved tasks in code
+        const codeContent = typeof actionDetails.code === "string" ? actionDetails.code : "";
+        if (codeContent.includes("TODO") ||
+            codeContent.includes("FIXME") ||
+            codeContent.includes("XXX") ||
+            action.includes("TODO") ||
+            action.includes("FIXME") ||
+            action.includes("XXX")) {
+            const term7 = context.terms.get(7);
+            if (term7) {
+                violations.push({
+                    term: term7,
+                    reason: "Unresolved tasks detected - violates Resolve All Errors principle",
+                    severity: "blocking",
+                });
+            }
+        }
+        if (actionDetails.isOverEngineered) {
+            const term3 = context.terms.get(3);
+            if (term3) {
+                violations.push({
+                    term: term3,
+                    reason: "Solution appears over-engineered - violates simplicity principle",
+                    severity: term3.enforcementLevel || "medium",
+                });
+                recommendations.push("Simplify the solution by removing unnecessary abstractions");
+            }
+        }
+        if (actionDetails.isInfiniteLoop ||
+            action.includes("while(true)") ||
+            action.includes("for(;;)")) {
+            const term8 = context.terms.get(8);
+            if (term8) {
+                violations.push({
+                    term: term8,
+                    reason: "Infinite loop detected - violates termination principle",
+                    severity: term8.enforcementLevel || "blocking",
+                });
+                recommendations.push("Add clear termination conditions to prevent infinite loops");
+            }
+        }
+        return {
+            compliant: violations.length === 0,
+            violations,
+            recommendations,
+        };
+    }
+    /**
+     * Clear cached context (useful for testing or forced reload)
+     */
+    clearCache() {
+        this.cachedContext = null;
+    }
+    /**
+     * Check if context is loaded and valid
+     */
+    isContextLoaded() {
+        return this.cachedContext !== null;
+    }
+    /**
+     * Get context statistics
+     */
+    getContextStats() {
+        if (!this.cachedContext) {
+            return {
+                loaded: false,
+                termCount: 0,
+                categoryBreakdown: {},
+                zeroToleranceCount: 0,
+            };
+        }
+        const context = this.cachedContext;
+        const terms = Array.from(context.terms.values());
+        const categoryBreakdown = {};
+        terms.forEach((term) => {
+            categoryBreakdown[term.category] =
+                (categoryBreakdown[term.category] || 0) + 1;
+        });
+        return {
+            loaded: true,
+            termCount: context.terms.size,
+            categoryBreakdown,
+            zeroToleranceCount: this.getZeroToleranceTerms(context).length,
+        };
+    }
+}
+/**
+ * Export singleton instance
+ */
+export const strRayContextLoader = StringRayContextLoader.getInstance();
+//# sourceMappingURL=context-loader.js.map

package/dist/plugin/context-loader.js.map

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

package/dist/plugin/delegation/agent-delegator.d.ts

@@ -0,0 +1,217 @@
+/**
+ * StringRay Framework v1.0.0 - Agent Delegator
+ *
+ * Intelligent agent delegation system that uses complexity analysis to determine
+ * optimal task distribution strategies and conflict resolution.
+ *
+ * @version 1.0.0
+ * @since 2026-01-07
+ */
+import { ComplexityScore, ComplexityMetrics } from "./complexity-analyzer.js";
+import { StringRayStateManager } from "../state/state-manager";
+export interface DelegationContext {
+    fileCount?: number;
+    changeVolume?: number;
+    dependencies?: number | string[];
+    riskLevel?: "low" | "medium" | "high" | "critical";
+    estimatedDuration?: number;
+    [key: string]: unknown;
+}
+export interface FileChanges {
+    added?: number;
+    deleted?: number;
+    modified?: number;
+    addedLines?: number;
+    deletedLines?: number;
+    complexityIncrease?: number;
+    fileSizeIncrease?: number;
+    type?: "typescript" | "javascript" | "python" | "other";
+    [key: string]: unknown;
+}
+export interface AgentExecutionResult {
+    agent: string;
+    result?: unknown;
+    success: boolean;
+    error?: string;
+}
+export interface DelegationRequest {
+    operation: string;
+    description: string;
+    context: DelegationContext;
+    sessionId?: string;
+    priority?: "high" | "medium" | "low";
+    forceMultiAgent?: boolean;
+    requiredAgents?: string[];
+    mentionAgent?: string;
+}
+export interface DelegationResult {
+    strategy: "single-agent" | "multi-agent" | "orchestrator-led";
+    agents: string[];
+    complexity: ComplexityScore;
+    metrics: ComplexityMetrics;
+    estimatedDuration: number;
+    conflictResolution?: "majority_vote" | "expert_priority" | "consensus";
+}
+export interface AgentCapability {
+    name: string;
+    expertise: string[];
+    capacity: number;
+    performance: number;
+    specialties: string[];
+}
+export interface DelegationMetrics {
+    totalDelegations: number;
+    successfulDelegations: number;
+    failedDelegations: number;
+    averageComplexity: number;
+    averageDuration: number;
+    strategyUsage: Record<string, number>;
+}
+export declare class AgentDelegator {
+    private complexityAnalyzer;
+    private stateManager;
+    private agentCapabilities;
+    private delegationMetrics;
+    constructor(stateManager: StringRayStateManager);
+    /**
+     * Analyze request and determine optimal delegation strategy
+     */
+    analyzeDelegation(request: DelegationRequest): Promise<DelegationResult>;
+    /**
+     * Execute delegation with monitoring and error handling
+     */
+    executeDelegation(delegation: DelegationResult, request: DelegationRequest): Promise<any>;
+    /**
+     * Get delegation performance metrics
+     */
+    getPerformanceMetrics(): {
+        totalDelegations: number;
+        averageResponseTime: number;
+    };
+    /**
+     * Get delegation performance metrics
+     */
+    getDelegationMetrics(): DelegationMetrics;
+    /**
+     * Update agent capabilities based on performance
+     */
+    updateAgentCapability(agentName: string, performance: Partial<AgentCapability>): void;
+    /**
+     * Handle file creation events - delegate to appropriate agents
+     */
+    handleFileCreation(filePath: string, content?: string): Promise<void>;
+    /**
+     * Handle file modification events
+     */
+    handleFileModification(filePath: string, changes: FileChanges): Promise<void>;
+    /**
+     * Determine if test architect should be consulted
+     */
+    private shouldConsultTestArchitect;
+    /**
+     * Determine if code reviewer should be consulted
+     */
+    private shouldConsultCodeReviewer;
+    /**
+     * Determine if security auditor should be consulted
+     */
+    private shouldConsultSecurityAuditor;
+    /**
+     * Determine if architect should be consulted
+     */
+    private shouldConsultArchitect;
+    /**
+     * Determine if bug triage should be consulted
+     */
+    private shouldConsultBugTriage;
+    /**
+     * Determine if refactorer should be consulted
+     */
+    private shouldConsultRefactorer;
+    /**
+     * Delegate to test architect for new file analysis
+     */
+    private delegateToTestArchitect;
+    /**
+     * Delegate to code reviewer
+     */
+    private delegateToCodeReviewer;
+    /**
+     * Delegate to security auditor
+     */
+    private delegateToSecurityAuditor;
+    /**
+     * Delegate to architect
+     */
+    private delegateToArchitect;
+    /**
+     * Delegate to bug triage
+     */
+    private delegateToBugTriage;
+    /**
+     * Delegate to refactorer
+     */
+    private delegateToRefactorer;
+    /**
+     * Get file type from path
+     */
+    private getFileType;
+    /**
+     * Analyze file complexity
+     */
+    private analyzeFileComplexity;
+    /**
+     * Get available agents and their current status
+     */
+    getAvailableAgents(): AgentCapability[];
+    private initializeAgentCapabilities;
+    private selectAgents;
+    private selectSingleAgent;
+    private selectMultiAgent;
+    private selectOrchestratorLed;
+    private determineConflictResolution;
+    private isAgentAvailable;
+    private executeSingleAgent;
+    private executeMultiAgent;
+    private executeOrchestratorLed;
+    private callAgent;
+    private resolveMultiAgentConflicts;
+    private consolidateOrchestratorResults;
+    private updateDelegationMetrics;
+    private recordSuccessfulDelegation;
+    private recordFailedDelegation;
+    private logDelegationDecision;
+    /**
+     * Select default multi-agent team when manual override is requested
+     */
+    private selectDefaultMultiAgentTeam;
+    /**
+     * Format task description for oh-my-opencode agent system
+     */
+    private formatTaskForAgent;
+    /**
+     * Invoke agent through oh-my-opencode system
+     */
+    private invokeOhMyOpenCodeAgent;
+    /**
+     * Get agent from oh-my-opencode system
+     */
+    private getOhMyOpenCodeAgent;
+    /**
+     * Simulate agent execution (fallback when oh-my-opencode integration fails)
+     */
+    private simulateAgentExecution;
+    /**
+     * Simulate agent execution time based on agent type
+     */
+    private simulateAgentExecutionTime;
+    /**
+     * Parse @mention from text input
+     */
+    parseMention(text: string): {
+        agentName?: string;
+        cleanText: string;
+    };
+}
+export declare const createAgentDelegator: (stateManager: StringRayStateManager) => AgentDelegator;
+//# sourceMappingURL=agent-delegator.d.ts.map

package/dist/plugin/delegation/agent-delegator.d.ts.map

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