0xray 4.0.13 → 4.0.15

package/dist/agents/growth-strategist.js

@@ -0,0 +1,111 @@
+/**
+ * Growth Strategist Agent
+ *
+ * Strategic marketing specialist for product positioning, campaign strategy,
+ * market analysis, and integrated marketing communications.
+ */
+export const growthStrategist = {
+    name: "growth-strategist",
+    mode: "subagent",
+    capabilities: [
+        "campaign-strategy",
+        "market-analysis",
+        "brand-positioning",
+        "content-marketing-strategy",
+        "product-marketing",
+        "competitive-analysis",
+        "marketing-automation",
+        "growth-strategy",
+        "customer-acquisition",
+        "conversion-optimization",
+        "marketing-messaging",
+        "go-to-market-strategy",
+    ],
+    maxComplexity: 70,
+    temperature: 0.5,
+    enabled: true,
+    description: "Marketing strategist. Expert in campaign strategy, market analysis, brand positioning, and integrated marketing communications for growth.",
+    system: `You are a strategic marketing expert focused on growth and conversion.
+
+Core Expertise:
+- Campaign strategy and execution
+- Market research and analysis
+- Brand positioning and messaging
+- Product marketing and launch
+- Customer acquisition strategy
+- Conversion optimization (CRO)
+- Landing page optimization
+- Competitive analysis
+- Go-to-market strategy
+
+// ============================================================================
+// LANDING PAGE OPTIMIZATION PRINCIPLES (Apply to All Landing Pages)
+// ============================================================================
+
+The "Don't Make Me Think" Principle (Steve Krug):
+- Users scan, don't read. Make it obvious.
+- 3 seconds to understand value proposition above the fold.
+- Each section should answer: "Why should I care?"
+
+Essential Landing Page Sections:
+1. HERO: Headline (hook), Subheadline (explain), CTA button
+2. SOCIAL PROOF: Logos, testimonials, stats
+3. PROBLEM/PAIN: Acknowledge user struggle
+4. SOLUTION: How your product solves it
+5. BENEFITS vs FEATURES: Lead with benefits
+6. HOW IT WORKS: Simple 1-2-3 steps
+7. CTA: Strong call-to-action (action verb + urgency)
+8. RISK REVERSAL: Guarantee, trial, testimonials
+9. FAQ: Address objections
+
+Conversion Triggers:
+- Action verbs: Get, Start, Try, Download, Join, Book
+- Urgency: "Limited time", "Only X left", "Today only"
+- Scarcity: "Enrollment closes", "spots available"
+- Social proof: "Join 10,000+ users", "4.9/5 rating"
+- Risk reversal: "30-day guarantee", "No credit card required"
+
+// ============================================================================
+// STRATEGIC FRAMEWORK
+// ============================================================================
+
+Strategic Framework:
+1. Market Analysis
+   - Target audience deep dive
+   - Market size and trends
+   - Competitive landscape
+   - SWOT analysis
+
+2. Positioning Strategy
+   - Unique value proposition
+   - Differentiation points
+   - Messaging hierarchy
+   - Brand voice guidelines
+
+3. Channel Strategy
+   - Organic (SEO, content, social)
+   - Paid (PPC, display, social ads)
+   - Email marketing
+   - Partnerships and outreach
+
+4. Campaign Development
+   - Campaign objectives (awareness, consideration, conversion)
+   - Key messages and creative direction
+   - Channel mix
+   - KPIs and measurement
+
+5. Growth Strategy
+   - Funnel optimization
+   - Retention and LTV
+   - Scaling playbook
+   - Attribution modeling
+
+Output Format:
+- Executive summary
+- Data-backed recommendations
+- Action items with timelines
+- Budget guidance where relevant
+- KPIs to track
+
+Tone: Professional, strategic, actionable. Zero fluff.`,
+};

package/dist/agents/index.d.ts

@@ -0,0 +1,25 @@
+import type { AgentConfig } from "./types.js";
+import { architect } from "./architect.js";
+import { bugTriageSpecialist } from "./bug-triage-specialist.js";
+import { codeReviewer } from "./code-reviewer.js";
+import { securityAuditor } from "./security-auditor.js";
+import { refactorer } from "./refactorer.js";
+import { testingLead } from "./testing-lead.js";
+import { logMonitor } from "./log-monitor.js";
+import { researcher } from "./researcher.js";
+import { codeAnalyzer } from "./code-analyzer.js";
+import { backendEngineer } from "./backend-engineer.js";
+import { contentCreator } from "./content-creator.js";
+import { databaseEngineer } from "./database-engineer.js";
+import { devopsEngineer } from "./devops-engineer.js";
+import { frontendEngineer } from "./frontend-engineer.js";
+import { frontendUiUxEngineer } from "./frontend-ui-ux-engineer.js";
+import { growthStrategist } from "./growth-strategist.js";
+import { mobileDeveloper } from "./mobile-developer.js";
+import { performanceEngineer } from "./performance-engineer.js";
+import { seoConsultant } from "./seo-consultant.js";
+import { strategist } from "./strategist.js";
+import { techWriter } from "./tech-writer.js";
+import { multimodalLooker } from "./multimodal-looker.js";
+export declare const builtinAgents: Record<string, AgentConfig>;
+export { architect, bugTriageSpecialist, codeReviewer, securityAuditor, refactorer, testingLead, logMonitor, researcher, codeAnalyzer, backendEngineer, contentCreator, databaseEngineer, devopsEngineer, frontendEngineer, frontendUiUxEngineer, growthStrategist, mobileDeveloper, performanceEngineer, seoConsultant, strategist, techWriter, multimodalLooker, };

package/dist/agents/index.js

@@ -0,0 +1,47 @@
+import { architect } from "./architect.js";
+import { bugTriageSpecialist } from "./bug-triage-specialist.js";
+import { codeReviewer } from "./code-reviewer.js";
+import { securityAuditor } from "./security-auditor.js";
+import { refactorer } from "./refactorer.js";
+import { testingLead } from "./testing-lead.js";
+import { logMonitor } from "./log-monitor.js";
+import { researcher } from "./researcher.js";
+import { codeAnalyzer } from "./code-analyzer.js";
+import { backendEngineer } from "./backend-engineer.js";
+import { contentCreator } from "./content-creator.js";
+import { databaseEngineer } from "./database-engineer.js";
+import { devopsEngineer } from "./devops-engineer.js";
+import { frontendEngineer } from "./frontend-engineer.js";
+import { frontendUiUxEngineer } from "./frontend-ui-ux-engineer.js";
+import { growthStrategist } from "./growth-strategist.js";
+import { mobileDeveloper } from "./mobile-developer.js";
+import { performanceEngineer } from "./performance-engineer.js";
+import { seoConsultant } from "./seo-consultant.js";
+import { strategist } from "./strategist.js";
+import { techWriter } from "./tech-writer.js";
+import { multimodalLooker } from "./multimodal-looker.js";
+export const builtinAgents = {
+    architect,
+    "bug-triage-specialist": bugTriageSpecialist,
+    "code-reviewer": codeReviewer,
+    "security-auditor": securityAuditor,
+    refactorer,
+    "testing-lead": testingLead,
+    "log-monitor": logMonitor,
+    researcher,
+    "code-analyzer": codeAnalyzer,
+    "backend-engineer": backendEngineer,
+    "content-creator": contentCreator,
+    "database-engineer": databaseEngineer,
+    "devops-engineer": devopsEngineer,
+    "frontend-engineer": frontendEngineer,
+    "frontend-ui-ux-engineer": frontendUiUxEngineer,
+    "growth-strategist": growthStrategist,
+    "mobile-developer": mobileDeveloper,
+    "performance-engineer": performanceEngineer,
+    "seo-consultant": seoConsultant,
+    strategist,
+    "tech-writer": techWriter,
+    "multimodal-looker": multimodalLooker,
+};
+export { architect, bugTriageSpecialist, codeReviewer, securityAuditor, refactorer, testingLead, logMonitor, researcher, codeAnalyzer, backendEngineer, contentCreator, databaseEngineer, devopsEngineer, frontendEngineer, frontendUiUxEngineer, growthStrategist, mobileDeveloper, performanceEngineer, seoConsultant, strategist, techWriter, multimodalLooker, };

package/dist/agents/known-names.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Known Names — Single combined vocabulary for agent names, skill names,
+ * system service names, and opencode built-in types. All consumers import
+ * from here instead of defining their own hardcoded lists.
+ *
+ * Imports:
+ *   - registry.ts (AGENT_REGISTRY, AGENT_KEYS) — canonical agent definitions
+ *   - mcps/index.ts (MCP_SERVERS) — canonical MCP server manifest
+ */
+import { AGENT_KEYS, type AgentKey } from "./registry.js";
+import { MCP_SERVERS } from "../mcps/index.js";
+export { AGENT_KEYS, type AgentKey };
+export type { AgentKey as AgentName };
+/** All agent names as a mutable array */
+export declare function getAgentNames(): string[];
+export declare const SYSTEM_SERVICE_NAMES: readonly ["enforcer", "orchestrator", "analyzer"];
+export declare const OPENCODE_BUILTIN_TYPES: readonly ["explore", "general"];
+export declare const ALL_KNOWN_NAMES: readonly [...string[], "enforcer", "orchestrator", "analyzer", "explore", "general"];
+export type KnownName = typeof ALL_KNOWN_NAMES[number];
+export declare const BOOT_AGENTS: readonly ["enforcer", "architect", "bug-triage-specialist", "code-reviewer", "security-auditor", "refactorer", "testing-lead"];
+export declare function isValidType(name: string): boolean;
+export declare const AGENT_TO_SKILL_MAP: Record<string, string>;
+/** Resolve agent name to skill name via alias map, fallback to identity */
+export declare function resolveSkill(agentOrSkill: string): string;
+export { MCP_SERVERS };
+export declare function getSkillNames(): string[];

package/dist/agents/known-names.js

@@ -0,0 +1,72 @@
+/**
+ * Known Names — Single combined vocabulary for agent names, skill names,
+ * system service names, and opencode built-in types. All consumers import
+ * from here instead of defining their own hardcoded lists.
+ *
+ * Imports:
+ *   - registry.ts (AGENT_REGISTRY, AGENT_KEYS) — canonical agent definitions
+ *   - mcps/index.ts (MCP_SERVERS) — canonical MCP server manifest
+ */
+import { AGENT_KEYS } from "./registry.js";
+import { MCP_SERVERS } from "../mcps/index.js";
+// ── Agent names (from SSOT) ──
+export { AGENT_KEYS };
+/** All agent names as a mutable array */
+export function getAgentNames() {
+    return [...AGENT_KEYS];
+}
+// ── System service names (not in AGENT_REGISTRY) ──
+export const SYSTEM_SERVICE_NAMES = [
+    "enforcer",
+    "orchestrator",
+    "analyzer",
+];
+// ── Opencode CLI built-in types ──
+export const OPENCODE_BUILTIN_TYPES = [
+    "explore",
+    "general",
+];
+// ── Combined vocabulary ──
+export const ALL_KNOWN_NAMES = [
+    ...AGENT_KEYS,
+    ...SYSTEM_SERVICE_NAMES,
+    ...OPENCODE_BUILTIN_TYPES,
+];
+// ── Boot-priority agents (loaded first by boot-orchestrator) ──
+export const BOOT_AGENTS = [
+    "enforcer",
+    "architect",
+    "bug-triage-specialist",
+    "code-reviewer",
+    "security-auditor",
+    "refactorer",
+    "testing-lead",
+];
+// ── Validation ──
+export function isValidType(name) {
+    return ALL_KNOWN_NAMES.includes(name);
+}
+// ── Agent → Skill alias map (single source) ──
+export const AGENT_TO_SKILL_MAP = {
+    "architect": "architecture-patterns",
+    "backend-engineer": "api-design",
+    "code-reviewer": "code-review",
+    "database-engineer": "database-design",
+    "devops-engineer": "devops-deployment",
+    "mobile-developer": "mobile-development",
+    "performance-engineer": "performance-optimization",
+    "security-auditor": "security-audit",
+    "testing-lead": "testing-strategy",
+    "tech-writer": "documentation-generation",
+    "frontend-ui-ux-engineer": "ui-ux-design",
+    "frontend-engineer": "project-analysis",
+};
+/** Resolve agent name to skill name via alias map, fallback to identity */
+export function resolveSkill(agentOrSkill) {
+    return AGENT_TO_SKILL_MAP[agentOrSkill] || agentOrSkill;
+}
+// ── MCP server names (for consumers that need them) ──
+export { MCP_SERVERS };
+export function getSkillNames() {
+    return MCP_SERVERS.map(s => s.serverName);
+}

package/dist/agents/librarian-agents-updater.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Librarian AGENTS.md Auto-Update Service
+ *
+ * Analyzes the project codebase and updates AGENTS.md to reflect
+ * the current project state (frameworks, APIs, components, etc.)
+ */
+export declare class LibrarianAgentsUpdater {
+    /**
+     * Main entry point to update AGENTS.md based on project analysis
+     * Now MERGES with existing content instead of overwriting
+     */
+    updateAgentsMd(projectRoot?: string): Promise<void>;
+    /**
+     * Generate only the auto-generated sections with markers
+     */
+    private generateAutoGeneratedContent;
+    /**
+     * Merge auto-generated content with existing AGENTS.md
+     * Preserves all manual sections outside the markers
+     */
+    private mergeAgentsMd;
+    private analyzeProject;
+    private detectProjectInfo;
+    private detectFrameworks;
+    private detectLanguages;
+    private detectAPIs;
+    private detectComponents;
+    private generateAgentsMd;
+}
+export declare const librarianAgentsUpdater: LibrarianAgentsUpdater;

package/dist/agents/librarian-agents-updater.js

@@ -0,0 +1,333 @@
+/**
+ * Librarian AGENTS.md Auto-Update Service
+ *
+ * Analyzes the project codebase and updates AGENTS.md to reflect
+ * the current project state (frameworks, APIs, components, etc.)
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { frameworkLogger } from "../core/framework-logger.js";
+export class LibrarianAgentsUpdater {
+    /**
+     * Main entry point to update AGENTS.md based on project analysis
+     * Now MERGES with existing content instead of overwriting
+     */
+    async updateAgentsMd(projectRoot = process.cwd()) {
+        const agentsPath = path.join(projectRoot, "AGENTS.md");
+        // Analyze project structure
+        const analysis = await this.analyzeProject(projectRoot);
+        // Detect project components
+        const info = this.detectProjectInfo(analysis, projectRoot);
+        // Generate auto-generated content with markers
+        const autoContent = this.generateAutoGeneratedContent(info);
+        // Merge with existing AGENTS.md (preserve manual sections)
+        const mergedContent = this.mergeAgentsMd(agentsPath, autoContent);
+        // Write to file
+        fs.writeFileSync(agentsPath, mergedContent, "utf-8");
+        frameworkLogger.log("librarian-agents-updater", "agents-md-updated", "info", {
+            message: `Updated AGENTS.md at ${agentsPath}`,
+        });
+    }
+    /**
+     * Generate only the auto-generated sections with markers
+     */
+    generateAutoGeneratedContent(info) {
+        const sections = [];
+        // Mark start of auto-generated content
+        sections.push("<!-- AUTO-GENERATED START -->");
+        sections.push("");
+        if (info.frameworks.length > 0) {
+            sections.push("## Frameworks & Libraries");
+            sections.push(info.frameworks.map((f) => `- ${f}`).join("\n"));
+            sections.push("");
+        }
+        if (info.languages.length > 0) {
+            sections.push("## Languages");
+            sections.push(info.languages.map((l) => `- ${l}`).join("\n"));
+            sections.push("");
+        }
+        if (info.apis.length > 0) {
+            sections.push("## APIs");
+            sections.push(info.apis.map((a) => `- ${a}`).join("\n"));
+            sections.push("");
+        }
+        if (info.components.length > 0) {
+            sections.push("## Project Components");
+            sections.push(info.components.map((c) => `- ${c}`).join("\n"));
+            sections.push("");
+        }
+        // Add plugin systems section (this is auto-detected)
+        sections.push("## Plugin Systems");
+        sections.push("");
+        sections.push("0xRay has one plugin system for OpenCode integration:");
+        sections.push("");
+        sections.push("### OpenCode Plugin (`.opencode/plugin/`)");
+        sections.push("**Purpose:** Injects 0xRay into OpenCode framework");
+        sections.push("- Location: `.opencode/plugin/xray-codex-injection.js`");
+        sections.push("- What it does: Injects Universal Development Codex into OpenCode's AI agents");
+        sections.push("- For: OpenCode integration");
+        sections.push("");
+        // Mark end of auto-generated content
+        sections.push("<!-- AUTO-GENERATED END -->");
+        sections.push("");
+        return sections.join("\n");
+    }
+    /**
+     * Merge auto-generated content with existing AGENTS.md
+     * Preserves all manual sections outside the markers
+     */
+    mergeAgentsMd(agentsPath, autoContent) {
+        const header = `# ${path.basename(process.cwd())} - Project Agents Guide
+
+**Last Updated**: ${new Date().toISOString().split("T")[0]}
+**Generated by**: 0xRay AI Librarian
+
+---
+
+`;
+        // If file doesn't exist, create from scratch
+        if (!fs.existsSync(agentsPath)) {
+            return header + autoContent;
+        }
+        const existing = fs.readFileSync(agentsPath, "utf-8");
+        // Check if file has auto-generated markers
+        if (existing.includes("<!-- AUTO-GENERATED START -->") && existing.includes("<!-- AUTO-GENERATED END -->")) {
+            // Replace only the auto-generated section
+            const regex = /<!-- AUTO-GENERATED START -->[\s\S]*?<!-- AUTO-GENERATED END -->/;
+            return existing.replace(regex, autoContent.trim());
+        }
+        // No markers found - create new file with markers
+        return header + autoContent + "---\n\n*This AGENTS.md is auto-maintained by 0xRay AI Librarian*\n";
+    }
+    async analyzeProject(projectRoot) {
+        const files = [];
+        let packageJson = {};
+        // Read package.json if exists
+        const pkgPath = path.join(projectRoot, "package.json");
+        if (fs.existsSync(pkgPath)) {
+            try {
+                packageJson = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+            }
+            catch (e) {
+                // Ignore parse errors
+            }
+        }
+        // Recursively collect file paths (limit depth)
+        const collectFiles = (dir, depth = 0) => {
+            if (depth > 5)
+                return; // Limit depth
+            try {
+                const entries = fs.readdirSync(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = path.join(dir, entry.name);
+                    // Skip common non-project directories
+                    if (entry.isDirectory()) {
+                        if ([
+                            ".git",
+                            "node_modules",
+                            "dist",
+                            "build",
+                            ".next",
+                            ".nuxt",
+                            "coverage",
+                            "__pycache__",
+                        ].includes(entry.name)) {
+                            continue;
+                        }
+                        collectFiles(fullPath, depth + 1);
+                    }
+                    else {
+                        files.push(fullPath);
+                    }
+                }
+            }
+            catch (e) {
+                // Ignore permission errors
+            }
+        };
+        collectFiles(projectRoot);
+        return { files, packageJson };
+    }
+    detectProjectInfo(analysis, projectRoot) {
+        const today = new Date().toISOString().split("T")[0] || "2026-02-16";
+        return {
+            frameworks: this.detectFrameworks(analysis),
+            languages: this.detectLanguages(analysis),
+            apis: this.detectAPIs(analysis, projectRoot),
+            components: this.detectComponents(analysis),
+            lastUpdated: today,
+        };
+    }
+    detectFrameworks(analysis) {
+        const frameworks = [];
+        const deps = {
+            ...analysis.packageJson?.dependencies,
+            ...analysis.packageJson?.devDependencies,
+        };
+        const frameworkMap = {
+            react: "React",
+            "react-dom": "React",
+            vue: "Vue",
+            "@vue/core": "Vue",
+            "@angular/core": "Angular",
+            next: "Next.js",
+            express: "Express",
+            fastify: "Fastify",
+            "@nestjs/core": "NestJS",
+            django: "Django",
+            flask: "Flask",
+            "@springframework/core": "Spring",
+            svelte: "Svelte",
+        };
+        for (const [dep, name] of Object.entries(frameworkMap)) {
+            if (deps[dep] && !frameworks.includes(name)) {
+                frameworks.push(name);
+            }
+        }
+        return frameworks;
+    }
+    detectLanguages(analysis) {
+        const languages = [];
+        const extCounts = {};
+        for (const file of analysis.files) {
+            const ext = path.extname(file).slice(1);
+            extCounts[ext] = (extCounts[ext] || 0) + 1;
+        }
+        if ((extCounts["ts"] || extCounts["tsx"]) &&
+            !languages.includes("TypeScript")) {
+            languages.push("TypeScript");
+        }
+        if (extCounts["js"] && !languages.includes("JavaScript")) {
+            languages.push("JavaScript");
+        }
+        if (extCounts["py"])
+            languages.push("Python");
+        if (extCounts["java"])
+            languages.push("Java");
+        if (extCounts["go"])
+            languages.push("Go");
+        if (extCounts["rs"])
+            languages.push("Rust");
+        if (extCounts["rb"])
+            languages.push("Ruby");
+        if (extCounts["php"])
+            languages.push("PHP");
+        return languages;
+    }
+    detectAPIs(analysis, projectRoot) {
+        const apis = [];
+        const relFiles = analysis.files.map((f) => path.relative(projectRoot, f));
+        // Detect REST API patterns
+        if (relFiles.some((f) => f.includes("/api/") ||
+            f.includes("/routes/") ||
+            f.includes("/router"))) {
+            apis.push("REST API");
+        }
+        // Detect GraphQL
+        if (relFiles.some((f) => f.includes(".graphql") ||
+            f.includes("schema.gql") ||
+            f.includes("resolvers"))) {
+            apis.push("GraphQL");
+        }
+        // Detect gRPC
+        if (relFiles.some((f) => f.includes(".proto"))) {
+            apis.push("gRPC");
+        }
+        // Detect WebSocket
+        if (relFiles.some((f) => f.includes("websocket") ||
+            f.includes("ws.") ||
+            f.includes("socket.io"))) {
+            apis.push("WebSocket");
+        }
+        // Detect tRPC
+        if (relFiles.some((f) => f.includes("trpc") || f.includes("trouter"))) {
+            apis.push("tRPC");
+        }
+        return apis;
+    }
+    detectComponents(analysis) {
+        const components = [];
+        const relFiles = analysis.files.map((f) => path.relative(process.cwd(), f));
+        // Detect common component patterns
+        if (relFiles.some((f) => f.includes("/components/") ||
+            f.includes("/Component") ||
+            f.includes(".component."))) {
+            components.push("UI Components");
+        }
+        if (relFiles.some((f) => f.includes("/services/") ||
+            f.includes("/service.") ||
+            f.includes("/api/"))) {
+            components.push("Services");
+        }
+        if (relFiles.some((f) => f.includes("/models/") ||
+            f.includes("/schemas/") ||
+            f.includes("/entities/"))) {
+            components.push("Data Models");
+        }
+        if (relFiles.some((f) => f.includes("/middleware/"))) {
+            components.push("Middleware");
+        }
+        if (relFiles.some((f) => f.includes("/hooks/") || f.includes("use."))) {
+            components.push("Hooks");
+        }
+        if (relFiles.some((f) => f.includes("/store/") ||
+            f.includes("/state/") ||
+            f.includes("redux") ||
+            f.includes("zustand"))) {
+            components.push("State Management");
+        }
+        if (relFiles.some((f) => f.includes("/utils/") || f.includes("/helpers/"))) {
+            components.push("Utilities");
+        }
+        if (relFiles.some((f) => f.includes("/config/") || f.includes("/settings/"))) {
+            components.push("Configuration");
+        }
+        return components;
+    }
+    generateAgentsMd(info) {
+        const sections = [];
+        sections.push(`# ${path.basename(process.cwd())} - Project Agents Guide`);
+        sections.push("");
+        sections.push(`**Last Updated**: ${info.lastUpdated}`);
+        sections.push(`**Generated by**: 0xRay AI Librarian`);
+        sections.push("");
+        sections.push("---");
+        sections.push("");
+        if (info.frameworks.length > 0) {
+            sections.push("## Frameworks & Libraries");
+            sections.push(info.frameworks.map((f) => `- ${f}`).join("\n"));
+            sections.push("");
+        }
+        if (info.languages.length > 0) {
+            sections.push("## Languages");
+            sections.push(info.languages.map((l) => `- ${l}`).join("\n"));
+            sections.push("");
+        }
+        if (info.apis.length > 0) {
+            sections.push("## APIs");
+            sections.push(info.apis.map((a) => `- ${a}`).join("\n"));
+            sections.push("");
+        }
+        if (info.components.length > 0) {
+            sections.push("## Project Components");
+            sections.push(info.components.map((c) => `- ${c}`).join("\n"));
+            sections.push("");
+        }
+        // Add plugin systems section
+        sections.push("## Plugin Systems");
+        sections.push("");
+        sections.push("0xRay has one plugin system for OpenCode integration:");
+        sections.push("");
+        sections.push("### OpenCode Plugin (`.opencode/plugin/`)");
+        sections.push("**Purpose:** Injects 0xRay into OpenCode framework");
+        sections.push("- Location: `.opencode/plugin/xray-codex-injection.js`");
+        sections.push("- What it does: Injects Universal Development Codex into OpenCode's AI agents");
+        sections.push("- For: OpenCode integration");
+        sections.push("");
+        sections.push("---");
+        sections.push("*This AGENTS.md is auto-maintained by 0xRay AI Librarian*");
+        return sections.join("\n");
+    }
+}
+// Export singleton instance
+export const librarianAgentsUpdater = new LibrarianAgentsUpdater();

package/dist/agents/log-monitor.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "./types.js";
+export declare const logMonitor: AgentConfig;