oh-my-claude-sisyphus 2.6.1 → 3.0.0

package/dist/hooks/learner/index.js

@@ -0,0 +1,137 @@
+/**
+ * Learned Skills Hook
+ *
+ * Automatically injects relevant learned skills into context
+ * based on message content triggers.
+ */
+import { contextCollector } from '../../features/context-injector/index.js';
+import { loadAllSkills, findMatchingSkills } from './loader.js';
+import { MAX_SKILLS_PER_SESSION } from './constants.js';
+import { loadConfig } from './config.js';
+// Re-export submodules
+export * from './types.js';
+export * from './constants.js';
+export * from './finder.js';
+export * from './parser.js';
+export * from './loader.js';
+export * from './validator.js';
+export * from './writer.js';
+export * from './detector.js';
+export * from './detection-hook.js';
+export * from './promotion.js';
+export * from './config.js';
+/**
+ * Session cache for tracking injected skills.
+ */
+const sessionCaches = new Map();
+/**
+ * Check if feature is enabled.
+ */
+export function isLearnerEnabled() {
+    return loadConfig().enabled;
+}
+/**
+ * Format skills for context injection.
+ */
+function formatSkillsForContext(skills) {
+    if (skills.length === 0)
+        return '';
+    const lines = [
+        '<learner>',
+        '',
+        '## Relevant Learned Skills',
+        '',
+        'The following skills have been learned from previous sessions and may be helpful:',
+        '',
+    ];
+    for (const skill of skills) {
+        lines.push(`### ${skill.metadata.name}`);
+        lines.push(`**Triggers:** ${skill.metadata.triggers.join(', ')}`);
+        if (skill.metadata.tags && skill.metadata.tags.length > 0) {
+            lines.push(`**Tags:** ${skill.metadata.tags.join(', ')}`);
+        }
+        lines.push('');
+        lines.push(skill.content);
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+    }
+    lines.push('</learner>');
+    return lines.join('\n');
+}
+/**
+ * Process a user message and inject matching skills.
+ */
+export function processMessageForSkills(message, sessionId, projectRoot) {
+    if (!isLearnerEnabled()) {
+        return { injected: 0, skills: [] };
+    }
+    // Get or create session cache
+    if (!sessionCaches.has(sessionId)) {
+        sessionCaches.set(sessionId, new Set());
+    }
+    const injectedHashes = sessionCaches.get(sessionId);
+    // Find matching skills not already injected
+    const matchingSkills = findMatchingSkills(message, projectRoot, MAX_SKILLS_PER_SESSION);
+    const newSkills = matchingSkills.filter(s => !injectedHashes.has(s.contentHash));
+    if (newSkills.length === 0) {
+        return { injected: 0, skills: [] };
+    }
+    // Mark as injected
+    for (const skill of newSkills) {
+        injectedHashes.add(skill.contentHash);
+    }
+    // Register with context collector
+    const content = formatSkillsForContext(newSkills);
+    contextCollector.register(sessionId, {
+        id: 'learner',
+        source: 'learner',
+        content,
+        priority: 'normal',
+        metadata: {
+            skillCount: newSkills.length,
+            skillIds: newSkills.map(s => s.metadata.id),
+        },
+    });
+    return { injected: newSkills.length, skills: newSkills };
+}
+/**
+ * Clear session cache.
+ */
+export function clearSkillSession(sessionId) {
+    sessionCaches.delete(sessionId);
+}
+/**
+ * Get all loaded skills (for debugging/display).
+ */
+export function getAllSkills(projectRoot) {
+    return loadAllSkills(projectRoot);
+}
+/**
+ * Create the learned skills hook for Claude Code.
+ */
+export function createLearnedSkillsHook(projectRoot) {
+    return {
+        /**
+         * Process user message for skill injection.
+         */
+        processMessage: (message, sessionId) => {
+            return processMessageForSkills(message, sessionId, projectRoot);
+        },
+        /**
+         * Clear session when done.
+         */
+        clearSession: (sessionId) => {
+            clearSkillSession(sessionId);
+        },
+        /**
+         * Get all skills for display.
+         */
+        getAllSkills: () => getAllSkills(projectRoot),
+        /**
+         * Check if feature enabled.
+         */
+        isEnabled: isLearnerEnabled,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/learner/index.js.map

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

package/dist/hooks/learner/loader.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Skill Loader
+ *
+ * Loads and caches skills from disk.
+ */
+import type { LearnedSkill } from './types.js';
+/**
+ * Load all skills for a project.
+ * Project skills override user skills with same ID.
+ */
+export declare function loadAllSkills(projectRoot: string | null): LearnedSkill[];
+/**
+ * Load a specific skill by ID.
+ */
+export declare function loadSkillById(skillId: string, projectRoot: string | null): LearnedSkill | null;
+/**
+ * Find skills matching keywords in user message.
+ */
+export declare function findMatchingSkills(message: string, projectRoot: string | null, limit?: number): LearnedSkill[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/hooks/learner/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/hooks/learner/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAS9D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,EAAE,CA4CxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAG9F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,KAAK,GAAE,MAAU,GAChB,YAAY,EAAE,CA+ChB"}

package/dist/hooks/learner/loader.js

@@ -0,0 +1,113 @@
+/**
+ * Skill Loader
+ *
+ * Loads and caches skills from disk.
+ */
+import { readFileSync } from 'fs';
+import { createHash } from 'crypto';
+import { relative } from 'path';
+import { findSkillFiles, getSkillsDir } from './finder.js';
+import { parseSkillFile } from './parser.js';
+import { DEBUG_ENABLED } from './constants.js';
+/**
+ * Create SHA-256 hash of content.
+ */
+function createContentHash(content) {
+    return createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+/**
+ * Load all skills for a project.
+ * Project skills override user skills with same ID.
+ */
+export function loadAllSkills(projectRoot) {
+    const candidates = findSkillFiles(projectRoot);
+    const seenIds = new Map();
+    for (const candidate of candidates) {
+        try {
+            const rawContent = readFileSync(candidate.path, 'utf-8');
+            const { metadata, content, valid, errors } = parseSkillFile(rawContent);
+            if (!valid) {
+                if (DEBUG_ENABLED) {
+                    console.warn(`Invalid skill file ${candidate.path}: ${errors.join(', ')}`);
+                }
+                continue;
+            }
+            const skillId = metadata.id;
+            const skillsDir = getSkillsDir(candidate.scope, projectRoot || undefined);
+            const relativePath = relative(skillsDir, candidate.path);
+            const skill = {
+                path: candidate.path,
+                relativePath,
+                scope: candidate.scope,
+                metadata: metadata,
+                content,
+                contentHash: createContentHash(content),
+                priority: candidate.scope === 'project' ? 1 : 0,
+            };
+            // Project skills override user skills with same ID
+            const existing = seenIds.get(skillId);
+            if (!existing || skill.priority > existing.priority) {
+                seenIds.set(skillId, skill);
+            }
+        }
+        catch (e) {
+            if (DEBUG_ENABLED) {
+                console.warn(`Error loading skill ${candidate.path}:`, e);
+            }
+        }
+    }
+    // Return skills sorted by priority (project first)
+    return Array.from(seenIds.values()).sort((a, b) => b.priority - a.priority);
+}
+/**
+ * Load a specific skill by ID.
+ */
+export function loadSkillById(skillId, projectRoot) {
+    const skills = loadAllSkills(projectRoot);
+    return skills.find(s => s.metadata.id === skillId) || null;
+}
+/**
+ * Find skills matching keywords in user message.
+ */
+export function findMatchingSkills(message, projectRoot, limit = 5) {
+    const skills = loadAllSkills(projectRoot);
+    const messageLower = message.toLowerCase();
+    const scored = skills.map(skill => {
+        let score = 0;
+        let hasMatch = false;
+        // Check trigger matches
+        for (const trigger of skill.metadata.triggers) {
+            if (messageLower.includes(trigger.toLowerCase())) {
+                score += 10;
+                hasMatch = true;
+            }
+        }
+        // Check tag matches
+        if (skill.metadata.tags) {
+            for (const tag of skill.metadata.tags) {
+                if (messageLower.includes(tag.toLowerCase())) {
+                    score += 5;
+                    hasMatch = true;
+                }
+            }
+        }
+        // Only apply quality/usage boosts if there was a trigger or tag match
+        if (hasMatch) {
+            // Boost by quality score
+            if (skill.metadata.quality) {
+                score += skill.metadata.quality / 20;
+            }
+            // Boost by usage count
+            if (skill.metadata.usageCount) {
+                score += Math.min(skill.metadata.usageCount, 10);
+            }
+        }
+        return { skill, score };
+    });
+    return scored
+        .filter(s => s.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit)
+        .map(s => s.skill);
+}
+//# sourceMappingURL=loader.js.map

package/dist/hooks/learner/loader.js.map

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

package/dist/hooks/learner/parser.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Skill Parser
+ *
+ * Parses YAML frontmatter from skill files.
+ */
+import type { SkillMetadata } from './types.js';
+export interface SkillParseResult {
+    metadata: Partial<SkillMetadata>;
+    content: string;
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Parse skill file frontmatter and content.
+ */
+export declare function parseSkillFile(rawContent: string): SkillParseResult;
+/**
+ * Generate YAML frontmatter for a skill.
+ */
+export declare function generateSkillFrontmatter(metadata: SkillMetadata): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/hooks/learner/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/hooks/learner/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CA2CnE;AAsHD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAoCxE"}

package/dist/hooks/learner/parser.js

@@ -0,0 +1,190 @@
+/**
+ * Skill Parser
+ *
+ * Parses YAML frontmatter from skill files.
+ */
+/**
+ * Parse skill file frontmatter and content.
+ */
+export function parseSkillFile(rawContent) {
+    const frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+    const match = rawContent.match(frontmatterRegex);
+    if (!match) {
+        return {
+            metadata: {},
+            content: rawContent,
+            valid: false,
+            errors: ['Missing YAML frontmatter'],
+        };
+    }
+    const yamlContent = match[1];
+    const content = match[2].trim();
+    const errors = [];
+    try {
+        const metadata = parseYamlMetadata(yamlContent);
+        // Validate required fields
+        if (!metadata.id)
+            errors.push('Missing required field: id');
+        if (!metadata.name)
+            errors.push('Missing required field: name');
+        if (!metadata.description)
+            errors.push('Missing required field: description');
+        if (!metadata.triggers || metadata.triggers.length === 0) {
+            errors.push('Missing required field: triggers');
+        }
+        if (!metadata.source)
+            errors.push('Missing required field: source');
+        return {
+            metadata,
+            content,
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    catch (e) {
+        return {
+            metadata: {},
+            content: rawContent,
+            valid: false,
+            errors: [`YAML parse error: ${e}`],
+        };
+    }
+}
+/**
+ * Parse YAML metadata without external library.
+ */
+function parseYamlMetadata(yamlContent) {
+    const lines = yamlContent.split('\n');
+    const metadata = {};
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const colonIndex = line.indexOf(':');
+        if (colonIndex === -1) {
+            i++;
+            continue;
+        }
+        const key = line.slice(0, colonIndex).trim();
+        const rawValue = line.slice(colonIndex + 1).trim();
+        switch (key) {
+            case 'id':
+                metadata.id = parseStringValue(rawValue);
+                break;
+            case 'name':
+                metadata.name = parseStringValue(rawValue);
+                break;
+            case 'description':
+                metadata.description = parseStringValue(rawValue);
+                break;
+            case 'source':
+                metadata.source = parseStringValue(rawValue);
+                break;
+            case 'createdAt':
+                metadata.createdAt = parseStringValue(rawValue);
+                break;
+            case 'sessionId':
+                metadata.sessionId = parseStringValue(rawValue);
+                break;
+            case 'quality':
+                metadata.quality = parseInt(rawValue, 10) || undefined;
+                break;
+            case 'usageCount':
+                metadata.usageCount = parseInt(rawValue, 10) || 0;
+                break;
+            case 'triggers':
+            case 'tags': {
+                const { value, consumed } = parseArrayValue(rawValue, lines, i);
+                if (key === 'triggers') {
+                    metadata.triggers = Array.isArray(value) ? value : [value];
+                }
+                else {
+                    metadata.tags = Array.isArray(value) ? value : [value];
+                }
+                i += consumed - 1;
+                break;
+            }
+        }
+        i++;
+    }
+    return metadata;
+}
+function parseStringValue(value) {
+    if (!value)
+        return '';
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+function parseArrayValue(rawValue, lines, currentIndex) {
+    // Inline array: ["a", "b"]
+    if (rawValue.startsWith('[')) {
+        const content = rawValue.slice(1, rawValue.lastIndexOf(']')).trim();
+        if (!content)
+            return { value: [], consumed: 1 };
+        const items = content.split(',').map(s => parseStringValue(s.trim())).filter(Boolean);
+        return { value: items, consumed: 1 };
+    }
+    // Multi-line array
+    if (!rawValue || rawValue === '') {
+        const items = [];
+        let consumed = 1;
+        for (let j = currentIndex + 1; j < lines.length; j++) {
+            const nextLine = lines[j];
+            const arrayMatch = nextLine.match(/^\s+-\s*(.*)$/);
+            if (arrayMatch) {
+                const itemValue = parseStringValue(arrayMatch[1].trim());
+                if (itemValue)
+                    items.push(itemValue);
+                consumed++;
+            }
+            else if (nextLine.trim() === '') {
+                consumed++;
+            }
+            else {
+                break;
+            }
+        }
+        if (items.length > 0) {
+            return { value: items, consumed };
+        }
+    }
+    // Single value
+    return { value: parseStringValue(rawValue), consumed: 1 };
+}
+/**
+ * Generate YAML frontmatter for a skill.
+ */
+export function generateSkillFrontmatter(metadata) {
+    const lines = [
+        '---',
+        `id: "${metadata.id}"`,
+        `name: "${metadata.name}"`,
+        `description: "${metadata.description}"`,
+        `source: ${metadata.source}`,
+        `createdAt: "${metadata.createdAt}"`,
+    ];
+    if (metadata.sessionId) {
+        lines.push(`sessionId: "${metadata.sessionId}"`);
+    }
+    if (metadata.quality !== undefined) {
+        lines.push(`quality: ${metadata.quality}`);
+    }
+    if (metadata.usageCount !== undefined) {
+        lines.push(`usageCount: ${metadata.usageCount}`);
+    }
+    lines.push('triggers:');
+    for (const trigger of metadata.triggers) {
+        lines.push(`  - "${trigger}"`);
+    }
+    if (metadata.tags && metadata.tags.length > 0) {
+        lines.push('tags:');
+        for (const tag of metadata.tags) {
+            lines.push(`  - "${tag}"`);
+        }
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+//# sourceMappingURL=parser.js.map

package/dist/hooks/learner/parser.js.map

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

package/dist/hooks/learner/promotion.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Ralph-Progress Promotion
+ *
+ * Promotes learnings from ralph-progress to full skills.
+ */
+import type { WriteSkillResult } from './writer.js';
+export interface PromotionCandidate {
+    /** The learning text */
+    learning: string;
+    /** Story ID it came from */
+    storyId: string;
+    /** Timestamp */
+    timestamp: string;
+    /** Suggested triggers (extracted from text) */
+    suggestedTriggers: string[];
+}
+/**
+ * Get promotion candidates from ralph-progress learnings.
+ */
+export declare function getPromotionCandidates(directory: string, limit?: number): PromotionCandidate[];
+/**
+ * Promote a learning to a full skill.
+ */
+export declare function promoteLearning(candidate: PromotionCandidate, skillName: string, additionalTriggers: string[], targetScope: 'user' | 'project', projectRoot: string | null): WriteSkillResult;
+/**
+ * List learnings that could be promoted.
+ */
+export declare function listPromotableLearnings(directory: string): string;
+//# sourceMappingURL=promotion.d.ts.map

package/dist/hooks/learner/promotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.d.ts","sourceRoot":"","sources":["../../../src/hooks/learner/promotion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAgBD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAW,GACjB,kBAAkB,EAAE,CA2BtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,EAAE,EAC5B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,gBAAgB,CASlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA4BjE"}

package/dist/hooks/learner/promotion.js

@@ -0,0 +1,87 @@
+/**
+ * Ralph-Progress Promotion
+ *
+ * Promotes learnings from ralph-progress to full skills.
+ */
+import { readProgress } from '../ralph-progress/index.js';
+import { writeSkill } from './writer.js';
+/**
+ * Extract trigger keywords from learning text.
+ */
+function extractTriggers(text) {
+    const technicalKeywords = [
+        'react', 'typescript', 'javascript', 'python', 'api', 'database',
+        'testing', 'debugging', 'performance', 'async', 'state', 'component',
+        'error', 'validation', 'authentication', 'cache', 'query', 'mutation',
+    ];
+    const textLower = text.toLowerCase();
+    return technicalKeywords.filter(kw => textLower.includes(kw));
+}
+/**
+ * Get promotion candidates from ralph-progress learnings.
+ */
+export function getPromotionCandidates(directory, limit = 10) {
+    const progress = readProgress(directory);
+    if (!progress) {
+        return [];
+    }
+    const candidates = [];
+    // Get recent entries with learnings
+    const recentEntries = progress.entries.slice(-limit);
+    for (const entry of recentEntries) {
+        for (const learning of entry.learnings) {
+            // Skip very short learnings
+            if (learning.length < 20)
+                continue;
+            candidates.push({
+                learning,
+                storyId: entry.storyId,
+                timestamp: entry.timestamp,
+                suggestedTriggers: extractTriggers(learning),
+            });
+        }
+    }
+    // Sort by number of triggers (more specific = better candidate)
+    return candidates.sort((a, b) => b.suggestedTriggers.length - a.suggestedTriggers.length);
+}
+/**
+ * Promote a learning to a full skill.
+ */
+export function promoteLearning(candidate, skillName, additionalTriggers, targetScope, projectRoot) {
+    const request = {
+        problem: `Learning from ${candidate.storyId}: ${candidate.learning.slice(0, 100)}...`,
+        solution: candidate.learning,
+        triggers: [...new Set([...candidate.suggestedTriggers, ...additionalTriggers])],
+        targetScope,
+    };
+    return writeSkill(request, projectRoot, skillName);
+}
+/**
+ * List learnings that could be promoted.
+ */
+export function listPromotableLearnings(directory) {
+    const candidates = getPromotionCandidates(directory);
+    if (candidates.length === 0) {
+        return 'No promotion candidates found in ralph-progress learnings.';
+    }
+    const lines = [
+        '# Promotion Candidates',
+        '',
+        'The following learnings from ralph-progress could be promoted to skills:',
+        '',
+    ];
+    candidates.forEach((candidate, index) => {
+        lines.push(`## ${index + 1}. From ${candidate.storyId} (${candidate.timestamp})`);
+        lines.push('');
+        lines.push(candidate.learning);
+        lines.push('');
+        if (candidate.suggestedTriggers.length > 0) {
+            lines.push(`**Suggested triggers:** ${candidate.suggestedTriggers.join(', ')}`);
+        }
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+    });
+    return lines.join('\n');
+}
+//# sourceMappingURL=promotion.js.map

package/dist/hooks/learner/promotion.js.map

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