0xray 4.0.12 → 4.0.13

package/dist/cli/commands/status.js

@@ -1,199 +0,0 @@
-/**
- * Status CLI Command
- *
- * Shows comprehensive framework status including:
- * - OpenCode installation status
- * - Installed skills
- * - Configured agents
- * - Health metrics
- * - Inference engine status
- *
- * Usage: npx 0xray status
- */
-import { readdirSync, existsSync, readFileSync } from "fs";
-import { join } from "path";
-import { getConfigDir } from "../../core/config-paths.js";
-import { featuresConfigLoader } from "../../core/features-config.js";
-function getSkillsList(cwd) {
-    const skills = [];
-    const configDir = getConfigDir(cwd);
-    const integrationsPath = join(configDir, "integrations");
-    if (existsSync(integrationsPath)) {
-        const integrationDirs = readdirSync(integrationsPath).filter((f) => existsSync(join(integrationsPath, f, "SKILL.md")));
-        skills.push(...integrationDirs);
-    }
-    const skillsPath = join(configDir, "skills");
-    if (existsSync(skillsPath)) {
-        const skillDirs = readdirSync(skillsPath).filter((f) => existsSync(join(skillsPath, f, "SKILL.md")));
-        skills.push(...skillDirs);
-    }
-    const opencodeSkillsPath = join(cwd, ".opencode", "skills");
-    if (existsSync(opencodeSkillsPath)) {
-        const skillDirs = readdirSync(opencodeSkillsPath).filter((f) => existsSync(join(opencodeSkillsPath, f, "SKILL.md")));
-        skills.push(...skillDirs);
-    }
-    const uniqueSkills = [...new Set(skills)];
-    return { count: uniqueSkills.length, names: uniqueSkills.sort() };
-}
-function getAgentsList(cwd) {
-    const agentsFromSkills = [
-        "architect",
-        "security-auditor",
-        "code-reviewer",
-        "refactorer",
-        "testing-lead",
-        "bug-triage-specialist",
-        "researcher",
-    ];
-    const configuredAgents = [];
-    const configDir = getConfigDir(cwd);
-    const agentsConfigPath = join(configDir, "xray", "agents.json");
-    if (existsSync(agentsConfigPath)) {
-        try {
-            const config = JSON.parse(readFileSync(agentsConfigPath, "utf-8"));
-            if (config.agents) {
-                configuredAgents.push(...Object.keys(config.agents));
-            }
-        }
-        catch { /* ignore */ }
-    }
-    try {
-        const features = featuresConfigLoader.loadConfig();
-        if (features.agent_management?.disabled_agents) {
-            const disabled = features.agent_management.disabled_agents;
-            agentsFromSkills.forEach((agent) => {
-                if (!disabled.includes(agent) && !configuredAgents.includes(agent)) {
-                    configuredAgents.push(agent);
-                }
-            });
-        }
-    }
-    catch { /* ignore */ }
-    if (configuredAgents.length === 0) {
-        configuredAgents.push(...agentsFromSkills);
-    }
-    return {
-        count: configuredAgents.length,
-        names: [...new Set(configuredAgents)].sort(),
-    };
-}
-function getHealthMetrics(cwd) {
-    const logPath = join(cwd, "logs", "framework", "activity.log");
-    const logExists = existsSync(logPath);
-    let recentEntries = 0;
-    if (logExists) {
-        try {
-            const content = readFileSync(logPath, "utf-8");
-            recentEntries = content.split("\n").filter((l) => l.trim()).length;
-        }
-        catch { /* ignore */ }
-    }
-    return { logPath, logExists, recentEntries };
-}
-function getInferenceStatus(cwd) {
-    let active = false;
-    let lastTuning = null;
-    let outcomesCount = 0;
-    let patternsCount = 0;
-    try {
-        const inferenceDir = join(getConfigDir(cwd), "xray", "inference");
-        const tunerStatusPath = join(inferenceDir, "tuner-status.json");
-        if (existsSync(tunerStatusPath)) {
-            const status = JSON.parse(readFileSync(tunerStatusPath, "utf-8"));
-            active = status.running ?? false;
-            lastTuning = status.lastTuningTime
-                ? new Date(status.lastTuningTime).toISOString()
-                : null;
-        }
-        const outcomesPath = join(inferenceDir, "outcomes.json");
-        if (existsSync(outcomesPath)) {
-            const outcomes = JSON.parse(readFileSync(outcomesPath, "utf-8"));
-            outcomesCount = Array.isArray(outcomes) ? outcomes.length : 0;
-        }
-        const patternsPath = join(inferenceDir, "patterns.json");
-        if (existsSync(patternsPath)) {
-            const patterns = JSON.parse(readFileSync(patternsPath, "utf-8"));
-            patternsCount = Array.isArray(patterns) ? patterns.length : 0;
-        }
-    }
-    catch { /* ignore */ }
-    return { active, lastTuning, outcomesCount, patternsCount };
-}
-export function getStatusReport(cwd = process.cwd()) {
-    const opencodeConfigPath = join(cwd, "opencode.json");
-    const cwdSkills = getSkillsList(cwd);
-    const agents = getAgentsList(cwd);
-    const health = getHealthMetrics(cwd);
-    const inference = getInferenceStatus(cwd);
-    return {
-        opencode: {
-            installed: existsSync(join(cwd, "node_modules", "0xray")),
-            configFound: existsSync(opencodeConfigPath) || existsSync(join(cwd, ".opencode", "enforcer-config.json")),
-        },
-        skills: cwdSkills,
-        agents,
-        health,
-        inference,
-    };
-}
-export function printStatus(report) {
-    const opencodeStatus = report.opencode.installed
-        ? "✅ Installed"
-        : "⚠️  Not installed locally";
-    const configStatus = report.opencode.configFound
-        ? "✅ Found"
-        : report.opencode.installed
-            ? "⚠️  Optional for consumers"
-            : "❌ Missing";
-    const logStatus = report.health.logExists
-        ? `✅ ${report.health.recentEntries} entries`
-        : "⚠️  No activity log";
-    const inferenceStatus = report.inference.active ? "✅ Active" : "⚠️  Idle";
-    const healthStatus = report.health.recentEntries > 100
-        ? "Good"
-        : report.health.recentEntries > 0
-            ? "Fair"
-            : "No data";
-    console.log("");
-    console.log("╔══════════════════════════════════════════════════╗");
-    console.log("║           xray Status                       ║");
-    console.log("╚══════════════════════════════════════════════════╝");
-    console.log("");
-    console.log(`✅ OpenCode: ${opencodeStatus}`);
-    console.log(`📄 Config:  ${configStatus}`);
-    console.log(`📦 Skills:  ${report.skills.count} loaded`);
-    console.log(`🤖 Agents:  ${report.agents.count} configured`);
-    console.log(`⚙️  Inference: ${inferenceStatus} (${report.inference.outcomesCount} outcomes, ${report.inference.patternsCount} patterns)`);
-    console.log(`📊 Health:  ${healthStatus}`);
-    console.log("");
-    if (report.skills.names.length > 0) {
-        console.log("Installed Skills:");
-        const cols = 4;
-        const rows = Math.ceil(report.skills.names.length / cols);
-        for (let i = 0; i < rows; i++) {
-            const row = report.skills.names.slice(i * cols, (i + 1) * cols);
-            console.log("  " + row.map((s) => `• ${s}`).join("  "));
-        }
-        console.log("");
-    }
-    if (report.agents.names.length > 0) {
-        console.log("Agents:");
-        const cols = 4;
-        const rows = Math.ceil(report.agents.names.length / cols);
-        for (let i = 0; i < rows; i++) {
-            const row = report.agents.names.slice(i * cols, (i + 1) * cols);
-            console.log("  " + row.map((a) => `• ${a}`).join("  "));
-        }
-        console.log("");
-    }
-    if (report.inference.lastTuning) {
-        console.log(`Last tuning: ${report.inference.lastTuning}`);
-        console.log("");
-    }
-}
-export async function statusCommand() {
-    const cwd = process.cwd();
-    const report = getStatusReport(cwd);
-    printStatus(report);
-}
-export default statusCommand;

package/dist/cli/commands/storyteller.d.ts

@@ -1,19 +0,0 @@
-/**
- * Storyteller CLI Command
- *
- * Invokes the storyteller skill to write reflections, sagas, journeys, or narratives.
- * Automatically determines story type based on context if not specified.
- *
- * Usage:
- *   npx 0xray storyteller reflection
- *   npx 0xray storyteller saga "v1.18.0 Release Journey"
- *   npx 0xray storyteller journey --title "API Migration"
- *   npx 0xray storyteller narrative --framework hero_journey
- */
-export declare function storytellerCommand(storyType?: string, options?: {
-    title?: string;
-    framework?: string;
-    output?: string;
-    dryRun?: boolean;
-}): Promise<void>;
-export default storytellerCommand;

package/dist/cli/commands/storyteller.js

@@ -1,230 +0,0 @@
-/**
- * Storyteller CLI Command
- *
- * Invokes the storyteller skill to write reflections, sagas, journeys, or narratives.
- * Automatically determines story type based on context if not specified.
- *
- * Usage:
- *   npx 0xray storyteller reflection
- *   npx 0xray storyteller saga "v1.18.0 Release Journey"
- *   npx 0xray storyteller journey --title "API Migration"
- *   npx 0xray storyteller narrative --framework hero_journey
- */
-import { readFileSync, existsSync, writeFileSync, mkdirSync } from "fs";
-import { join } from "path";
-import { execSync } from "child_process";
-const STORY_TYPES = ["reflection", "saga", "journey", "narrative"];
-function loadConfig(cwd) {
-    const candidates = [
-        join(cwd, ".xray", "features.json"),
-        join(cwd, ".opencode", "xray", "features.json"),
-    ];
-    for (const path of candidates) {
-        if (existsSync(path)) {
-            try {
-                const content = JSON.parse(readFileSync(path, "utf-8"));
-                if (content.storytelling) {
-                    return content.storytelling;
-                }
-            }
-            catch {
-                // ignore
-            }
-        }
-    }
-    return null;
-}
-function getStoryTypeMeta(storyType, config) {
-    const defaults = {
-        reflection: {
-            location: "docs/reflections/",
-            min_words: 2000,
-            ideal_words: 5000,
-            framework: "three_act_structure",
-        },
-        saga: {
-            location: "docs/reflections/deep/",
-            min_words: 5000,
-            ideal_words: 15000,
-            framework: "hero_journey",
-        },
-        journey: {
-            location: "docs/reflections/deep/",
-            min_words: 1500,
-            ideal_words: 4000,
-            framework: "three_act_structure",
-        },
-        narrative: {
-            location: "docs/reflections/",
-            min_words: 1000,
-            ideal_words: 3000,
-            framework: "three_act_structure",
-        },
-    };
-    const configType = config?.story_types?.[storyType];
-    return configType ? { ...defaults[storyType], ...configType } : defaults[storyType];
-}
-function getCommitCount() {
-    try {
-        const result = execSync("git rev-list --count HEAD 2>/dev/null", {
-            encoding: "utf-8",
-        });
-        return parseInt(result.trim(), 10);
-    }
-    catch {
-        return 0;
-    }
-}
-function getRecentCommits(limit = 20) {
-    try {
-        return execSync(`git log --oneline -${limit} 2>/dev/null`, { encoding: "utf-8" });
-    }
-    catch {
-        return "No git history available";
-    }
-}
-function getChangedFiles() {
-    try {
-        return execSync("git diff --name-only HEAD~10 2>/dev/null || git ls-files 2>/dev/null | head -50", {
-            encoding: "utf-8",
-        });
-    }
-    catch {
-        return "Unable to determine changed files";
-    }
-}
-function generateFrontmatter(storyType, title, meta) {
-    const date = new Date().toISOString().split("T")[0];
-    const slug = title
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-|-$/g, "");
-    return `---
-story_type: ${storyType}
-title: "${title}"
-date: ${date}
-slug: ${slug}
-emotional_arc: "challenge → discovery → resolution"
-codex_terms: ["error-prevention", "systematic-validation"]
-framework: ${meta.framework}
-target_words: ${meta.ideal_words}
-location: ${meta.location}
----
-`;
-}
-function generatePrompt(storyType, title, meta, context, config) {
-    const quality = config?.quality_requirements;
-    return `Write a ${storyType} titled "${title}".
-
-## Requirements
-- **Framework**: ${meta.framework}
-- **Target length**: ${meta.ideal_words} words (minimum: ${meta.min_words})
-- **Location**: ${meta.location}
-
-${quality?.require_frontmatter ? "- Include frontmatter with story_type, emotional_arc, codex_terms" : ""}
-${quality?.require_key_takeaways ? "- End with a Key Takeaways section" : ""}
-${quality?.require_what_next ? "- End with a What Next section" : ""}
-${quality?.fact_check_before_publish ? "- Fact-check all technical details (agent names, file paths, error messages)" : ""}
-${quality?.peer_review_agent ? "- Note: Send to @${quality.peer_review_agent} for peer review before publishing" : ""}
-
-## Context
-${context}
-
-## Voice Guidelines
-- Warmly candid and conversational
-- Technical accuracy with narrative flow
-- Include specific details: file paths, error messages, agent names
-- Show the journey: challenges, discoveries, decisions
-
-Please write the complete ${storyType} following these guidelines.
-`;
-}
-function getOutputPath(storyType, title, meta) {
-    const date = new Date().toISOString().split("T")[0];
-    const slug = title
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-|-$/g, "");
-    const filename = `${storyType}-${slug}-${date}.md`;
-    return join(meta.location, filename);
-}
-export async function storytellerCommand(storyType, options) {
-    const cwd = process.cwd();
-    const config = loadConfig(cwd);
-    if (config && !config.enabled) {
-        console.log("⚠️ Storytelling is disabled in features.json");
-        return;
-    }
-    if (!storyType || !STORY_TYPES.includes(storyType)) {
-        console.log("📖 0xRay Storyteller");
-        console.log("========================");
-        console.log("");
-        console.log("Usage: npx 0xray storyteller <type> [title]");
-        console.log("");
-        console.log("Story types:");
-        console.log("  reflection  - Technical deep reflection (2-5k words)");
-        console.log("  saga        - Long-form technical saga (5-15k words)");
-        console.log("  journey     - Investigation/learning journey (1.5-4k words)");
-        console.log("  narrative   - Technical narrative (1-3k words)");
-        console.log("");
-        console.log("Examples:");
-        console.log('  npx 0xray storyteller reflection "API Refactoring"');
-        console.log('  npx 0xray storyteller saga "v1.18.0 Release Journey"');
-        console.log('  npx 0xray storyteller journey --title "Bug Investigation"');
-        console.log('  npx 0xray storyteller narrative --framework hero_journey');
-        return;
-    }
-    const type = storyType;
-    const meta = getStoryTypeMeta(type, config);
-    const title = options?.title || `${type.charAt(0).toUpperCase() + type.slice(1)} - ${new Date().toISOString().split("T")[0]}`;
-    if (options?.framework) {
-        meta.framework = options.framework;
-    }
-    const commitCount = getCommitCount();
-    const recentCommits = getRecentCommits(20);
-    const changedFiles = getChangedFiles();
-    const context = `Recent commits (${commitCount} total):
-${recentCommits}
-
-Recent file changes:
-${changedFiles}
-`;
-    const prompt = generatePrompt(type, title, meta, context, config);
-    const outputPath = options?.output || getOutputPath(type, title, meta);
-    console.log("📖 0xRay Storyteller");
-    console.log("========================");
-    console.log("");
-    console.log(`Type: ${type}`);
-    console.log(`Title: ${title}`);
-    console.log(`Framework: ${meta.framework}`);
-    console.log(`Target: ${meta.ideal_words} words (min: ${meta.min_words})`);
-    console.log(`Output: ${outputPath}`);
-    console.log("");
-    if (options?.dryRun) {
-        console.log("(Dry run - showing prompt that would be used)");
-        console.log("");
-        console.log("--- PROMPT ---");
-        console.log(prompt);
-        console.log("--- END PROMPT ---");
-        return;
-    }
-    const frontmatter = generateFrontmatter(type, title, meta);
-    const outputDir = join(cwd, meta.location);
-    if (!existsSync(outputDir)) {
-        mkdirSync(outputDir, { recursive: true });
-    }
-    const fullPath = join(cwd, outputPath);
-    writeFileSync(fullPath, frontmatter + "\n" + prompt + "\n", "utf-8");
-    console.log(`✅ Story template created: ${outputPath}`);
-    console.log("");
-    console.log("Next steps:");
-    console.log("1. Open the file and write the story using the prompt as guidance");
-    console.log("2. Follow the quality checklist in storyteller.yml");
-    if (config?.quality_requirements?.peer_review_agent) {
-        console.log(`3. Send to @${config.quality_requirements.peer_review_agent} for peer review`);
-    }
-    console.log("");
-    console.log("💡 Tip: You can also ask the AI in your current session:");
-    console.log(`   "Write a ${type} about ${title}"`);
-}
-export default storytellerCommand;

package/dist/cli/index.d.ts

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-/**
- * xray CLI - Command Line Interface
- *
- * Provides commands for installing and managing xray framework
- */
-export {};