stringray-ai 1.0.0

package/dist/plugin/agents/sisyphus.js

@@ -0,0 +1,53 @@
+export const sisyphusAgent = {
+    name: "Sisyphus",
+    model: "opencode/grok-code",
+    description: "Main orchestrator and command center for multi-agent coordination and workflow management",
+    mode: "primary",
+    system: `You are Sisyphus, the main orchestrator and command center for multi-agent coordination and workflow management in the StringRay Framework.
+
+Your core responsibilities:
+1. **Multi-Agent Orchestration**: Coordinate complex tasks across specialized agents (enforcer, architect, refactorer, etc.)
+2. **Workflow Coordination**: Manage task dependencies and execution flow
+3. **Task Delegation**: Analyze complexity and delegate to appropriate agents
+4. **Conflict Resolution**: Handle agent conflicts and consolidate results
+5. **Async Processing**: Manage concurrent agent operations
+6. **Error Recovery**: Implement fallback strategies and recovery mechanisms
+7. **Progress Tracking**: Monitor task completion and provide status updates
+
+COORDINATION PROTOCOL:
+- Analyze task complexity using 6 metrics (files, changes, dependencies, risk, duration)
+- Route to single-agent (score < 50), multi-agent (50-95), or orchestrator-led (95+)
+- Use async-multi-agent coordination model
+- Maintain session state and provide real-time updates
+- Escalate issues to appropriate specialized agents
+
+FRAMEWORK ENFORCEMENT:
+- Ensure all operations comply with Universal Development Codex v1.2.20
+- Log all framework activities for transparency
+- Prevent infinite loops and handle errors gracefully
+- Maintain 99.6% error prevention through systematic validation
+
+When delegating tasks, always provide complete context and clear success criteria.`,
+    temperature: 0.3,
+    tools: {
+        include: [
+            "read",
+            "grep",
+            "lsp_diagnostics",
+            "lsp_code_actions",
+            "lsp_rename",
+            "run_terminal_cmd",
+            "background_task",
+            "call_omo_agent",
+            "session_list",
+            "session_read",
+            "session_search",
+            "session_info",
+        ],
+    },
+    permission: {
+        edit: "allow",
+        bash: "allow",
+    },
+};
+//# sourceMappingURL=sisyphus.js.map

package/dist/plugin/agents/sisyphus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sisyphus.js","sourceRoot":"","sources":["../../../src/agents/sisyphus.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,2FAA2F;IAC7F,IAAI,EAAE,SAAS;IAEf,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;mFAwByE;IAEjF,WAAW,EAAE,GAAG;IAEhB,KAAK,EAAE;QACL,OAAO,EAAE;YACP,MAAM;YACN,MAAM;YACN,iBAAiB;YACjB,kBAAkB;YAClB,YAAY;YACZ,kBAAkB;YAClB,iBAAiB;YACjB,gBAAgB;YAChB,cAAc;YACd,cAAc;YACd,gBAAgB;YAChB,cAAc;SACf;KACF;IAED,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;KACd;CACF,CAAC"}

package/dist/plugin/agents/test-architect.d.ts

@@ -0,0 +1,3 @@
+import type { AgentConfig } from "./types.js";
+export declare const testArchitect: AgentConfig;
+//# sourceMappingURL=test-architect.d.ts.map

package/dist/plugin/agents/test-architect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-architect.d.ts","sourceRoot":"","sources":["../../../src/agents/test-architect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,aAAa,EAAE,WAgF3B,CAAC"}

package/dist/plugin/agents/test-architect.js

@@ -0,0 +1,81 @@
+export const testArchitect = {
+    name: "test-architect",
+    model: "opencode/grok-code",
+    description: "StringRay Framework test architect with automatic test generation, coverage optimization, and behavioral testing capabilities",
+    mode: "subagent",
+    system: `You are the StringRay Test Architect, a specialized agent responsible for comprehensive testing strategy and quality assurance.
+
+Your core responsibilities include:
+1. **Test Auto-Creation**: Automatically generate comprehensive test files for new code components
+2. **Test Strategy Design**: Create comprehensive testing plans covering unit, integration, and E2E scenarios
+3. **Coverage Optimization**: Maximize test coverage while minimizing redundancy and maintenance overhead
+4. **Behavioral Testing**: Focus on behavior validation over implementation details
+5. **Performance Validation**: Ensure tests validate performance requirements and scalability
+6. **Quality Assurance**: Maintain 85%+ test coverage with reliable, maintainable test suites
+
+Key Facilities Available:
+- Test coverage tracking: coverage_trends, test_execution_time, flaky_test_rate
+- Performance analytics: execution timing patterns, failure prediction models
+- Processor pipeline: test-validation, coverage-analysis, performance-testing, integration-testing
+- Alert thresholds: 40s response time, 2% error rate, 400MB memory usage
+- Parallel test execution with 4+ worker threads
+
+Testing Strategy:
+1. **Unit Testing**: Pure functions, component isolation, edge case coverage
+2. **Integration Testing**: Component interaction, API validation, data flow testing
+3. **End-to-End Testing**: Complete user workflows, critical path validation
+4. **Performance Testing**: Load testing, scalability validation, bottleneck identification
+5. **Security Testing**: Input validation, authentication, authorization testing
+
+When designing tests:
+- Focus on behavior over implementation details
+- Maintain 85%+ coverage across all test types
+- Implement parallel execution for efficiency
+- Use predictive models for failure prevention
+- Validate both positive and negative test scenarios
+
+Integration Points:
+- Automated testing frameworks and runners
+- Coverage analysis and reporting tools
+- Performance monitoring and profiling systems
+- CI/CD pipeline integration and validation
+- Test result analysis and trend monitoring
+
+Test Auto-Creation Guidelines:
+1. **Automatic Test Generation**: When new files are created (functions, classes, components), automatically generate corresponding test files
+2. **Template-Based Creation**: Use appropriate test templates based on file type (.ts → unit tests, .tsx → component tests)
+3. **Comprehensive Coverage**: Generate tests for all public exports, edge cases, and error conditions
+4. **Framework Consistency**: Follow existing test patterns and naming conventions in the codebase
+5. **Integration Ready**: Ensure generated tests are immediately runnable and contribute to coverage goals
+
+When creating tests automatically:
+- Analyze the source file structure and exports
+- Generate test stubs for all functions, classes, and components
+- Include basic assertions, mocks, and error handling tests
+- Follow the project's testing patterns (Vitest, React Testing Library, etc.)
+- Place test files in appropriate __tests__ directories
+
+Your goal is to ensure comprehensive test coverage and reliable validation of system behavior and performance.`,
+    temperature: 0.1,
+    tools: {
+        include: [
+            "read",
+            "grep",
+            "lsp_*",
+            "run_terminal_cmd",
+            "run_terminal_cmd",
+            "write",
+        ],
+    },
+    permission: {
+        edit: "allow",
+        bash: {
+            git: "allow",
+            npm: "allow",
+            bun: "allow",
+            test: "allow",
+            coverage: "allow",
+        },
+    },
+};
+//# sourceMappingURL=test-architect.js.map

package/dist/plugin/agents/test-architect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-architect.js","sourceRoot":"","sources":["../../../src/agents/test-architect.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,+HAA+H;IACjI,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+GAoDqG;IAC7G,WAAW,EAAE,GAAG;IAChB,KAAK,EAAE;QACL,OAAO,EAAE;YACP,MAAM;YACN,MAAM;YACN,OAAO;YACP,kBAAkB;YAClB,kBAAkB;YAClB,OAAO;SACR;KACF;IACD,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,IAAI,EAAE;YACJ,GAAG,EAAE,OAAO;YACZ,GAAG,EAAE,OAAO;YACZ,GAAG,EAAE,OAAO;YACZ,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,OAAO;SAClB;KACF;CACF,CAAC"}

package/dist/plugin/agents/types.d.ts

@@ -0,0 +1,29 @@
+export interface ToolConfig {
+    include?: string[];
+    exclude?: string[];
+    [key: string]: any;
+}
+export interface PermissionConfig {
+    edit?: "ask" | "allow" | "deny";
+    bash?: "ask" | "allow" | "deny" | {
+        [command: string]: "ask" | "allow" | "deny";
+    };
+    webfetch?: "ask" | "allow" | "deny";
+    [key: string]: any;
+}
+export interface AgentConfig {
+    name: string;
+    model: string;
+    description: string;
+    mode: "primary" | "subagent" | "all";
+    system: string;
+    temperature?: number;
+    top_p?: number;
+    tools?: ToolConfig;
+    permission?: PermissionConfig;
+    prompt?: string;
+    prompt_append?: string;
+    disable?: boolean;
+    color?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugin/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,EACD,KAAK,GACL,OAAO,GACP,MAAM,GACN;QACE,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;KAC7C,CAAC;IACN,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/plugin/agents/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugin/agents/types.js.map

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

package/dist/plugin/config-loader.d.ts

@@ -0,0 +1,67 @@
+/**
+ * StringRay Framework v1.0.0 - Configuration Loader
+ *
+ * Loads and validates StringRay-specific configuration from oh-my-opencode.json
+ *
+ * @version 1.0.0
+ * @since 2026-01-09
+ */
+export interface MultiAgentOrchestrationConfig {
+    enabled: boolean;
+    coordination_model: "async-multi-agent" | "sync-multi-agent";
+    max_concurrent_agents: number;
+    task_distribution_strategy: "capability-based" | "load-balanced" | "round-robin";
+    conflict_resolution: "expert-priority" | "majority-vote" | "consensus";
+    progress_tracking: boolean;
+    session_persistence: boolean;
+}
+export interface SisyphusOrchestratorConfig {
+    enabled: boolean;
+    relentless_execution: boolean;
+    todo_enforcement: boolean;
+    max_retries: number;
+    backoff_strategy: "exponential" | "linear" | "fixed";
+    progress_persistence: boolean;
+}
+export interface StringRayConfig {
+    multi_agent_orchestration: MultiAgentOrchestrationConfig;
+    sisyphus_orchestrator: SisyphusOrchestratorConfig;
+    disabled_agents: string[];
+}
+export declare class StringRayConfigLoader {
+    private configPath;
+    private cachedConfig;
+    private cacheExpiry;
+    private lastLoadTime;
+    constructor(configPath?: string);
+    /**
+     * Load StringRay configuration from .strray/strray-config.json
+     */
+    loadConfig(): StringRayConfig;
+    /**
+     * Parse configuration data with validation
+     */
+    private parseConfig;
+    /**
+     * Parse multi-agent orchestration configuration
+     */
+    private parseMultiAgentConfig;
+    /**
+     * Parse Sisyphus orchestrator configuration
+     */
+    private parseSisyphusConfig;
+    /**
+     * Get default configuration
+     */
+    private getDefaultConfig;
+    /**
+     * Validate enum values
+     */
+    private validateEnum;
+    /**
+     * Clear configuration cache
+     */
+    clearCache(): void;
+}
+export declare const strRayConfigLoader: StringRayConfigLoader;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/plugin/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,mBAAmB,GAAG,kBAAkB,CAAC;IAC7D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,0BAA0B,EACtB,kBAAkB,GAClB,eAAe,GACf,aAAa,CAAC;IAClB,mBAAmB,EAAE,iBAAiB,GAAG,eAAe,GAAG,WAAW,CAAC;IACvE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrD,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,yBAAyB,EAAE,6BAA6B,CAAC;IACzD,qBAAqB,EAAE,0BAA0B,CAAC;IAClD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,YAAY,CAAa;gBAErB,UAAU,CAAC,EAAE,MAAM;IAI/B;;OAEG;IACI,UAAU,IAAI,eAAe;IA+BpC;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACI,UAAU,IAAI,IAAI;CAI1B;AAGD,eAAO,MAAM,kBAAkB,uBAA8B,CAAC"}

package/dist/plugin/config-loader.js

@@ -0,0 +1,125 @@
+/**
+ * StringRay Framework v1.0.0 - Configuration Loader
+ *
+ * Loads and validates StringRay-specific configuration from oh-my-opencode.json
+ *
+ * @version 1.0.0
+ * @since 2026-01-09
+ */
+import * as fs from "fs";
+import * as path from "path";
+export class StringRayConfigLoader {
+    configPath;
+    cachedConfig = null;
+    cacheExpiry = 30000; // 30 seconds
+    lastLoadTime = 0;
+    constructor(configPath) {
+        this.configPath = configPath || ".strray/config.json";
+    }
+    /**
+     * Load StringRay configuration from .strray/strray-config.json
+     */
+    loadConfig() {
+        const now = Date.now();
+        // Return cached config if still valid
+        if (this.cachedConfig && now - this.lastLoadTime < this.cacheExpiry) {
+            return this.cachedConfig;
+        }
+        try {
+            const configPath = path.resolve(process.cwd(), this.configPath);
+            if (!fs.existsSync(configPath)) {
+                console.warn(`⚠️  StringRay config not found at ${configPath}, using defaults`);
+                return this.getDefaultConfig();
+            }
+            const configData = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            const config = this.parseConfig(configData);
+            this.cachedConfig = config;
+            this.lastLoadTime = now;
+            return config;
+        }
+        catch (error) {
+            console.error(`❌ Failed to load StringRay config:`, error);
+            return this.getDefaultConfig();
+        }
+    }
+    /**
+     * Parse configuration data with validation
+     */
+    parseConfig(configData) {
+        return {
+            multi_agent_orchestration: this.parseMultiAgentConfig(configData.multi_agent_orchestration),
+            sisyphus_orchestrator: this.parseSisyphusConfig(configData.sisyphus_orchestrator),
+            disabled_agents: Array.isArray(configData.disabled_agents)
+                ? configData.disabled_agents
+                : [],
+        };
+    }
+    /**
+     * Parse multi-agent orchestration configuration
+     */
+    parseMultiAgentConfig(config) {
+        return {
+            enabled: config?.enabled ?? true,
+            coordination_model: this.validateEnum(config?.coordination_model, ["async-multi-agent", "sync-multi-agent"], "async-multi-agent"),
+            max_concurrent_agents: Math.max(1, Math.min(10, config?.max_concurrent_agents ?? 3)),
+            task_distribution_strategy: this.validateEnum(config?.task_distribution_strategy, ["capability-based", "load-balanced", "round-robin"], "capability-based"),
+            conflict_resolution: this.validateEnum(config?.conflict_resolution, ["expert-priority", "majority-vote", "consensus"], "expert-priority"),
+            progress_tracking: config?.progress_tracking ?? true,
+            session_persistence: config?.session_persistence ?? true,
+        };
+    }
+    /**
+     * Parse Sisyphus orchestrator configuration
+     */
+    parseSisyphusConfig(config) {
+        return {
+            enabled: config?.enabled ?? true,
+            relentless_execution: config?.relentless_execution ?? true,
+            todo_enforcement: config?.todo_enforcement ?? true,
+            max_retries: Math.max(0, Math.min(10, config?.max_retries ?? 3)),
+            backoff_strategy: this.validateEnum(config?.backoff_strategy, ["exponential", "linear", "fixed"], "exponential"),
+            progress_persistence: config?.progress_persistence ?? true,
+        };
+    }
+    /**
+     * Get default configuration
+     */
+    getDefaultConfig() {
+        return {
+            multi_agent_orchestration: {
+                enabled: true,
+                coordination_model: "async-multi-agent",
+                max_concurrent_agents: 3,
+                task_distribution_strategy: "capability-based",
+                conflict_resolution: "expert-priority",
+                progress_tracking: true,
+                session_persistence: true,
+            },
+            sisyphus_orchestrator: {
+                enabled: true,
+                relentless_execution: true,
+                todo_enforcement: true,
+                max_retries: 3,
+                backoff_strategy: "exponential",
+                progress_persistence: true,
+            },
+            disabled_agents: [],
+        };
+    }
+    /**
+     * Validate enum values
+     */
+    validateEnum(value, allowedValues, defaultValue) {
+        return allowedValues.includes(value) ? value : defaultValue;
+    }
+    /**
+     * Clear configuration cache
+     */
+    clearCache() {
+        this.cachedConfig = null;
+        this.lastLoadTime = 0;
+    }
+}
+// Export singleton instance
+export const strRayConfigLoader = new StringRayConfigLoader();
+//# sourceMappingURL=config-loader.js.map

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

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

package/dist/plugin/context-loader.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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
+ */
+/**
+ * Codex term structure
+ */
+export interface CodexTerm {
+    number: number;
+    description: string;
+    category: "core" | "extended" | "architecture" | "advanced";
+    zeroTolerance?: boolean;
+    enforcementLevel?: "low" | "medium" | "high" | "blocking";
+}
+/**
+ * Parsed codex context
+ */
+export interface CodexContext {
+    version: string;
+    lastUpdated: string;
+    terms: Map<number, CodexTerm>;
+    interweaves: string[];
+    lenses: string[];
+    principles: string[];
+    antiPatterns: string[];
+    validationCriteria: Record<string, boolean>;
+    frameworkAlignment: Record<string, string>;
+    errorPreventionTarget: number;
+}
+/**
+ * Context loading result
+ */
+export interface ContextLoadResult {
+    success: boolean;
+    context?: CodexContext;
+    error?: string;
+    warnings: string[];
+}
+/**
+ * StringRay Context Loader
+ *
+ * Loads and parses the Universal Development Codex v1.2.20 from codex.json
+ */
+export declare class StringRayContextLoader {
+    private static instance;
+    private cachedContext;
+    private codexFilePaths;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): StringRayContextLoader;
+    /**
+     * Load codex context
+     *
+     * Attempts to load the Universal Development Codex from multiple possible locations.
+     * Returns cached context if available and not expired.
+     */
+    loadCodexContext(projectRoot: string): Promise<ContextLoadResult>;
+    /**
+     * 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.
+     */
+    private parseCodexContent;
+    private inferTermCategory;
+    /**
+     * Get specific codex term by number
+     */
+    getTerm(context: CodexContext, termNumber: number): CodexTerm | undefined;
+    /**
+     * Get all core terms (1-10)
+     */
+    getCoreTerms(context: CodexContext): CodexTerm[];
+    /**
+     * Get zero-tolerance terms that require immediate blocking
+     */
+    getZeroToleranceTerms(context: CodexContext): CodexTerm[];
+    /**
+     * Validate action against codex
+     *
+     * Checks if an action complies with relevant codex terms.
+     * Returns validation result with violations and recommendations.
+     */
+    validateAgainstCodex(context: CodexContext, action: string, actionDetails: Record<string, unknown>): {
+        compliant: boolean;
+        violations: Array<{
+            term: CodexTerm;
+            reason: string;
+            severity: "low" | "medium" | "high" | "blocking";
+        }>;
+        recommendations: string[];
+    };
+    /**
+     * Clear cached context (useful for testing or forced reload)
+     */
+    clearCache(): void;
+    /**
+     * Check if context is loaded and valid
+     */
+    isContextLoaded(): boolean;
+    /**
+     * Get context statistics
+     */
+    getContextStats(): {
+        loaded: boolean;
+        termCount: number;
+        categoryBreakdown: Record<string, number>;
+        zeroToleranceCount: number;
+    };
+}
+/**
+ * Export singleton instance
+ */
+export declare const strRayContextLoader: StringRayContextLoader;
+//# sourceMappingURL=context-loader.d.ts.map

package/dist/plugin/context-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-loader.d.ts","sourceRoot":"","sources":["../../src/context-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgBD;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyB;IAChD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,cAAc,CAAgB;IAEtC,OAAO;IAIP;;OAEG;WACW,WAAW,IAAI,sBAAsB;IAOnD;;;;;OAKG;IACU,gBAAgB,CAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAgD7B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAqCzB,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACI,OAAO,CACZ,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,GACjB,SAAS,GAAG,SAAS;IAIxB;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE;IAMvD;;OAEG;IACI,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE;IAQhE;;;;;OAKG;IACI,oBAAoB,CACzB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC;QACD,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,SAAS,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;SAClD,CAAC,CAAC;QACH,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B;IA8FD;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACI,eAAe,IAAI,OAAO;IAIjC;;OAEG;IACI,eAAe,IAAI;QACxB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,kBAAkB,EAAE,MAAM,CAAC;KAC5B;CA0BF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,wBAAuC,CAAC"}