oh-my-claude-sisyphus 3.6.1 → 3.6.2

package/dist/hooks/mnemosyne/writer.js

@@ -0,0 +1,126 @@
+/**
+ * Skill Writer
+ *
+ * Writes skill files to disk with proper formatting.
+ */
+import { writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { ensureSkillsDir, getSkillsDir } from './finder.js';
+import { generateSkillFrontmatter } from './parser.js';
+import { validateExtractionRequest } from './validator.js';
+import { DEBUG_ENABLED } from './constants.js';
+/**
+ * Generate a unique skill ID.
+ */
+function generateSkillId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).slice(2, 6);
+    return `skill-${timestamp}-${random}`;
+}
+/**
+ * Sanitize a string for use as filename.
+ */
+function sanitizeFilename(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 50);
+}
+/**
+ * Write a new skill from extraction request.
+ */
+export function writeSkill(request, projectRoot, skillName) {
+    // Validate first
+    const validation = validateExtractionRequest(request);
+    if (!validation.valid) {
+        return {
+            success: false,
+            error: `Quality validation failed: ${validation.missingFields.join(', ')}`,
+            validation,
+        };
+    }
+    // Ensure directory exists
+    if (!ensureSkillsDir(request.targetScope, projectRoot || undefined)) {
+        return {
+            success: false,
+            error: `Failed to create skills directory for scope: ${request.targetScope}`,
+            validation,
+        };
+    }
+    // Generate metadata
+    const metadata = {
+        id: generateSkillId(),
+        name: skillName,
+        description: request.problem.slice(0, 200),
+        source: 'extracted',
+        createdAt: new Date().toISOString(),
+        triggers: request.triggers,
+        tags: request.tags,
+        quality: validation.score,
+        usageCount: 0,
+    };
+    // Generate content
+    const frontmatter = generateSkillFrontmatter(metadata);
+    const content = `${frontmatter}
+
+# Problem
+
+${request.problem}
+
+# Solution
+
+${request.solution}
+`;
+    // Write to file
+    const filename = `${sanitizeFilename(skillName)}.md`;
+    const skillsDir = getSkillsDir(request.targetScope, projectRoot || undefined);
+    const filePath = join(skillsDir, filename);
+    // Check for duplicates
+    if (existsSync(filePath)) {
+        return {
+            success: false,
+            error: `Skill file already exists: ${filename}`,
+            validation,
+        };
+    }
+    try {
+        writeFileSync(filePath, content);
+        return {
+            success: true,
+            path: filePath,
+            validation,
+        };
+    }
+    catch (e) {
+        if (DEBUG_ENABLED) {
+            console.error('[mnemosyne] Error writing skill file:', e);
+        }
+        return {
+            success: false,
+            error: `Failed to write skill file: ${e}`,
+            validation,
+        };
+    }
+}
+/**
+ * Check if a skill with similar triggers already exists.
+ */
+export function checkDuplicateTriggers(triggers, projectRoot) {
+    // Import dynamically to avoid circular dependency
+    const { loadAllSkills } = require('./loader.js');
+    const skills = loadAllSkills(projectRoot);
+    const normalizedTriggers = new Set(triggers.map(t => t.toLowerCase()));
+    for (const skill of skills) {
+        const skillTriggers = skill.metadata.triggers.map((t) => t.toLowerCase());
+        const overlap = skillTriggers.filter((t) => normalizedTriggers.has(t));
+        if (overlap.length >= triggers.length * 0.5) {
+            return {
+                isDuplicate: true,
+                existingSkillId: skill.metadata.id,
+            };
+        }
+    }
+    return { isDuplicate: false };
+}
+//# sourceMappingURL=writer.js.map

package/dist/hooks/mnemosyne/writer.js.map

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

package/dist/hooks/ralph-loop/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Ralph Hook
+ *
+ * Self-referential work loop that continues until a completion promise is detected.
+ * Named after the character who keeps working until the job is done.
+ *
+ * Enhanced with PRD (Product Requirements Document) support for structured task tracking.
+ * When a prd.json exists, completion is based on all stories having passes: true.
+ *
+ * Ported from oh-my-opencode's ralph hook.
+ */
+import { type PRDStatus, type UserStory } from '../ralph-prd/index.js';
+export declare function isUltraQAActive(directory: string): boolean;
+export interface RalphLoopState {
+    /** Whether the loop is currently active */
+    active: boolean;
+    /** Current iteration number */
+    iteration: number;
+    /** Maximum iterations before stopping */
+    max_iterations: number;
+    /** The promise phrase to detect for completion */
+    completion_promise: string;
+    /** When the loop started */
+    started_at: string;
+    /** The original prompt/task */
+    prompt: string;
+    /** Session ID the loop is bound to */
+    session_id?: string;
+    /** Whether PRD mode is active */
+    prd_mode?: boolean;
+    /** Current story being worked on */
+    current_story_id?: string;
+    /** Whether ultrawork is linked/auto-activated with ralph */
+    linked_ultrawork?: boolean;
+}
+export interface RalphLoopOptions {
+    /** Maximum iterations (default: 10) */
+    maxIterations?: number;
+    /** Custom completion promise (default: "TASK_COMPLETE") */
+    completionPromise?: string;
+    /** Disable auto-activation of ultrawork (default: false - ultrawork is enabled) */
+    disableUltrawork?: boolean;
+}
+export interface RalphLoopHook {
+    startLoop: (sessionId: string, prompt: string, options?: RalphLoopOptions) => boolean;
+    cancelLoop: (sessionId: string) => boolean;
+    getState: () => RalphLoopState | null;
+}
+/**
+ * Read Ralph Loop state from disk
+ */
+export declare function readRalphState(directory: string): RalphLoopState | null;
+/**
+ * Write Ralph Loop state to disk
+ */
+export declare function writeRalphState(directory: string, state: RalphLoopState): boolean;
+/**
+ * Clear Ralph Loop state
+ */
+export declare function clearRalphState(directory: string): boolean;
+/**
+ * Clear ultrawork state (only if linked to ralph)
+ */
+export declare function clearLinkedUltraworkState(directory: string): boolean;
+/**
+ * Increment Ralph Loop iteration
+ */
+export declare function incrementRalphIteration(directory: string): RalphLoopState | null;
+/**
+ * Detect completion promise in session transcript
+ */
+export declare function detectCompletionPromise(sessionId: string, promise: string): boolean;
+/**
+ * Create a Ralph Loop hook instance
+ */
+export declare function createRalphLoopHook(directory: string): RalphLoopHook;
+/**
+ * Check if PRD mode is available (prd.json exists)
+ */
+export declare function hasPrd(directory: string): boolean;
+/**
+ * Get PRD completion status for ralph
+ */
+export declare function getPrdCompletionStatus(directory: string): {
+    hasPrd: boolean;
+    allComplete: boolean;
+    status: PRDStatus | null;
+    nextStory: UserStory | null;
+};
+/**
+ * Get context injection for ralph continuation
+ * Includes PRD current story and progress memory
+ */
+export declare function getRalphContext(directory: string): string;
+/**
+ * Update ralph state with current story
+ */
+export declare function setCurrentStory(directory: string, storyId: string): boolean;
+/**
+ * Enable PRD mode in ralph state
+ */
+export declare function enablePrdMode(directory: string): boolean;
+/**
+ * Record progress after completing a story
+ */
+export declare function recordStoryProgress(directory: string, storyId: string, implementation: string[], filesChanged: string[], learnings: string[]): boolean;
+/**
+ * Add a codebase pattern discovered during work
+ */
+export declare function recordPattern(directory: string, pattern: string): boolean;
+/**
+ * Check if ralph should complete based on PRD status
+ */
+export declare function shouldCompleteByPrd(directory: string): boolean;
+export type { PRD, PRDStatus, UserStory } from '../ralph-prd/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/ralph-loop/index.d.ts.map

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

package/dist/hooks/ralph-loop/index.js

@@ -0,0 +1,322 @@
+/**
+ * Ralph Hook
+ *
+ * Self-referential work loop that continues until a completion promise is detected.
+ * Named after the character who keeps working until the job is done.
+ *
+ * Enhanced with PRD (Product Requirements Document) support for structured task tracking.
+ * When a prd.json exists, completion is based on all stories having passes: true.
+ *
+ * Ported from oh-my-opencode's ralph hook.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { readPrd, getPrdStatus, formatNextStoryPrompt, formatPrdStatus } from '../ralph-prd/index.js';
+import { getProgressContext, appendProgress, initProgress, addPattern } from '../ralph-progress/index.js';
+import { readUltraworkState as readUltraworkStateFromModule, writeUltraworkState as writeUltraworkStateFromModule } from '../ultrawork-state/index.js';
+// Forward declaration to avoid circular import - check ultraqa state file directly
+export function isUltraQAActive(directory) {
+    const omcDir = join(directory, '.omc');
+    const stateFile = join(omcDir, 'ultraqa-state.json');
+    if (!existsSync(stateFile)) {
+        return false;
+    }
+    try {
+        const content = readFileSync(stateFile, 'utf-8');
+        const state = JSON.parse(content);
+        return state && state.active === true;
+    }
+    catch {
+        return false;
+    }
+}
+const DEFAULT_MAX_ITERATIONS = 10;
+const DEFAULT_COMPLETION_PROMISE = 'TASK_COMPLETE';
+/**
+ * Get the state file path for Ralph Loop
+ */
+function getStateFilePath(directory) {
+    const omcDir = join(directory, '.omc');
+    return join(omcDir, 'ralph-state.json');
+}
+/**
+ * Ensure the .omc directory exists
+ */
+function ensureStateDir(directory) {
+    const omcDir = join(directory, '.omc');
+    if (!existsSync(omcDir)) {
+        mkdirSync(omcDir, { recursive: true });
+    }
+}
+/**
+ * Read Ralph Loop state from disk
+ */
+export function readRalphState(directory) {
+    const stateFile = getStateFilePath(directory);
+    if (!existsSync(stateFile)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(stateFile, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write Ralph Loop state to disk
+ */
+export function writeRalphState(directory, state) {
+    try {
+        ensureStateDir(directory);
+        const stateFile = getStateFilePath(directory);
+        writeFileSync(stateFile, JSON.stringify(state, null, 2));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clear Ralph Loop state
+ */
+export function clearRalphState(directory) {
+    const stateFile = getStateFilePath(directory);
+    if (!existsSync(stateFile)) {
+        return true;
+    }
+    try {
+        unlinkSync(stateFile);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clear ultrawork state (only if linked to ralph)
+ */
+export function clearLinkedUltraworkState(directory) {
+    const state = readUltraworkStateFromModule(directory);
+    // Only clear if it was linked to ralph (auto-activated)
+    if (!state || !state.linked_to_ralph) {
+        return true;
+    }
+    const omcDir = join(directory, '.omc');
+    const stateFile = join(omcDir, 'ultrawork-state.json');
+    try {
+        unlinkSync(stateFile);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Increment Ralph Loop iteration
+ */
+export function incrementRalphIteration(directory) {
+    const state = readRalphState(directory);
+    if (!state || !state.active) {
+        return null;
+    }
+    state.iteration += 1;
+    if (writeRalphState(directory, state)) {
+        return state;
+    }
+    return null;
+}
+/**
+ * Detect completion promise in session transcript
+ */
+export function detectCompletionPromise(sessionId, promise) {
+    // Try to find transcript in Claude's session directory
+    const claudeDir = join(homedir(), '.claude');
+    const possiblePaths = [
+        join(claudeDir, 'sessions', sessionId, 'transcript.md'),
+        join(claudeDir, 'sessions', sessionId, 'messages.json'),
+        join(claudeDir, 'transcripts', `${sessionId}.md`)
+    ];
+    for (const transcriptPath of possiblePaths) {
+        if (existsSync(transcriptPath)) {
+            try {
+                const content = readFileSync(transcriptPath, 'utf-8');
+                const pattern = new RegExp(`<promise>\\s*${escapeRegex(promise)}\\s*</promise>`, 'is');
+                if (pattern.test(content)) {
+                    return true;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Escape regex special characters
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Create a Ralph Loop hook instance
+ */
+export function createRalphLoopHook(directory) {
+    const startLoop = (sessionId, prompt, options) => {
+        // Mutual exclusion check: cannot start Ralph Loop if UltraQA is active
+        if (isUltraQAActive(directory)) {
+            console.error('Cannot start Ralph Loop while UltraQA is active. Cancel UltraQA first with /oh-my-claudecode:cancel-ultraqa.');
+            return false;
+        }
+        const enableUltrawork = !options?.disableUltrawork;
+        const now = new Date().toISOString();
+        const state = {
+            active: true,
+            iteration: 1,
+            max_iterations: options?.maxIterations ?? DEFAULT_MAX_ITERATIONS,
+            completion_promise: options?.completionPromise ?? DEFAULT_COMPLETION_PROMISE,
+            started_at: now,
+            prompt,
+            session_id: sessionId,
+            linked_ultrawork: enableUltrawork
+        };
+        const ralphSuccess = writeRalphState(directory, state);
+        // Auto-activate ultrawork (linked to ralph) by default
+        if (ralphSuccess && enableUltrawork) {
+            const ultraworkState = {
+                active: true,
+                reinforcement_count: 0,
+                original_prompt: prompt,
+                started_at: now,
+                last_checked_at: now,
+                linked_to_ralph: true
+            };
+            writeUltraworkStateFromModule(ultraworkState, directory);
+        }
+        return ralphSuccess;
+    };
+    const cancelLoop = (sessionId) => {
+        const state = readRalphState(directory);
+        if (!state || state.session_id !== sessionId) {
+            return false;
+        }
+        // Also clear linked ultrawork state if it was auto-activated
+        if (state.linked_ultrawork) {
+            clearLinkedUltraworkState(directory);
+        }
+        return clearRalphState(directory);
+    };
+    const getState = () => {
+        return readRalphState(directory);
+    };
+    return {
+        startLoop,
+        cancelLoop,
+        getState
+    };
+}
+// ============================================================================
+// PRD Integration
+// ============================================================================
+/**
+ * Check if PRD mode is available (prd.json exists)
+ */
+export function hasPrd(directory) {
+    const prd = readPrd(directory);
+    return prd !== null;
+}
+/**
+ * Get PRD completion status for ralph
+ */
+export function getPrdCompletionStatus(directory) {
+    const prd = readPrd(directory);
+    if (!prd) {
+        return {
+            hasPrd: false,
+            allComplete: false,
+            status: null,
+            nextStory: null
+        };
+    }
+    const status = getPrdStatus(prd);
+    return {
+        hasPrd: true,
+        allComplete: status.allComplete,
+        status,
+        nextStory: status.nextStory
+    };
+}
+/**
+ * Get context injection for ralph continuation
+ * Includes PRD current story and progress memory
+ */
+export function getRalphContext(directory) {
+    const parts = [];
+    // Add progress context (patterns, learnings)
+    const progressContext = getProgressContext(directory);
+    if (progressContext) {
+        parts.push(progressContext);
+    }
+    // Add current story from PRD
+    const prdStatus = getPrdCompletionStatus(directory);
+    if (prdStatus.hasPrd && prdStatus.nextStory) {
+        parts.push(formatNextStoryPrompt(prdStatus.nextStory));
+    }
+    // Add PRD status summary
+    if (prdStatus.status) {
+        parts.push(`<prd-status>\n${formatPrdStatus(prdStatus.status)}\n</prd-status>\n`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Update ralph state with current story
+ */
+export function setCurrentStory(directory, storyId) {
+    const state = readRalphState(directory);
+    if (!state) {
+        return false;
+    }
+    state.current_story_id = storyId;
+    return writeRalphState(directory, state);
+}
+/**
+ * Enable PRD mode in ralph state
+ */
+export function enablePrdMode(directory) {
+    const state = readRalphState(directory);
+    if (!state) {
+        return false;
+    }
+    state.prd_mode = true;
+    // Initialize progress.txt if it doesn't exist
+    initProgress(directory);
+    return writeRalphState(directory, state);
+}
+/**
+ * Record progress after completing a story
+ */
+export function recordStoryProgress(directory, storyId, implementation, filesChanged, learnings) {
+    return appendProgress(directory, {
+        storyId,
+        implementation,
+        filesChanged,
+        learnings
+    });
+}
+/**
+ * Add a codebase pattern discovered during work
+ */
+export function recordPattern(directory, pattern) {
+    return addPattern(directory, pattern);
+}
+/**
+ * Check if ralph should complete based on PRD status
+ */
+export function shouldCompleteByPrd(directory) {
+    const status = getPrdCompletionStatus(directory);
+    return status.hasPrd && status.allComplete;
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/ralph-loop/index.js.map

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