@hivehub/rulebook 5.5.2 → 5.8.0

package/dist/core/prd-generator.d.ts

@@ -1,48 +0,0 @@
-import { Logger } from './logger.js';
-import { RalphPRD } from '../types.js';
-/**
- * Converts rulebook tasks to Ralph-compatible PRD JSON format
- */
-export declare class PRDGenerator {
-    private tasksDir;
-    private logger;
-    constructor(projectRoot: string, logger: Logger, tasksDir?: string);
-    /**
-     * Generate PRD from rulebook tasks
-     */
-    generatePRD(projectName: string): Promise<RalphPRD>;
-    /**
-     * Load tasks from rulebook/tasks directory
-     */
-    private loadTasksFromDisk;
-    /**
-     * Convert a rulebook task to Ralph user story format
-     * Uses the full rulebook task structure: proposal.md + tasks.md + specs/
-     */
-    private convertTaskToUserStory;
-    /**
-     * Load SHALL/MUST requirements from specs/*.md files as acceptance criteria.
-     */
-    private loadSpecCriteria;
-    /**
-     * Extract SHALL/MUST statements from spec content as acceptance criteria.
-     */
-    private extractShallMust;
-    /**
-     * List relative paths of spec files for notes/traceability.
-     */
-    private listSpecFiles;
-    /**
-     * Load tasks checklist from tasks.md
-     */
-    private loadTasksChecklist;
-    /**
-     * Extract title from proposal markdown
-     */
-    private extractTitle;
-    /**
-     * Extract description from proposal markdown
-     */
-    private extractDescription;
-}
-//# sourceMappingURL=prd-generator.d.ts.map

package/dist/core/prd-generator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prd-generator.d.ts","sourceRoot":"","sources":["../../src/core/prd-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAgB,QAAQ,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA0B;IAKrF;;OAEG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwBzD;;OAEG;YACW,iBAAiB;IAyC/B;;;OAGG;YACW,sBAAsB;IA+BpC;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;YACW,aAAa;IA6B3B;;OAEG;YACW,kBAAkB;IA0BhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAY3B"}

package/dist/core/prd-generator.js

@@ -1,233 +0,0 @@
-import path from 'path';
-import { readFile, readdir } from 'fs/promises';
-import { existsSync } from 'fs';
-/**
- * Converts rulebook tasks to Ralph-compatible PRD JSON format
- */
-export class PRDGenerator {
-    tasksDir;
-    logger;
-    constructor(projectRoot, logger, tasksDir = '.rulebook/tasks') {
-        this.tasksDir = path.join(projectRoot, tasksDir);
-        this.logger = logger;
-    }
-    /**
-     * Generate PRD from rulebook tasks
-     */
-    async generatePRD(projectName) {
-        this.logger.info('Generating PRD from rulebook tasks...');
-        const tasks = await this.loadTasksFromDisk();
-        // Map returns Promise[] so we need Promise.all
-        const userStoriesPromises = tasks.map((task, index) => this.convertTaskToUserStory(task, index + 1));
-        const userStories = await Promise.all(userStoriesPromises);
-        // Generate branch name from project name
-        const branchName = `ralph/${projectName.toLowerCase().replace(/\s+/g, '-')}`;
-        const prd = {
-            project: projectName,
-            branchName,
-            description: `Ralph autonomous loop for ${projectName} - ${userStories.length} user stories`,
-            userStories,
-        };
-        this.logger.info(`Generated PRD with ${userStories.length} user stories`);
-        return prd;
-    }
-    /**
-     * Load tasks from rulebook/tasks directory
-     */
-    async loadTasksFromDisk() {
-        if (!existsSync(this.tasksDir)) {
-            this.logger.warn(`Tasks directory not found: ${this.tasksDir}`);
-            return [];
-        }
-        const tasks = [];
-        const entries = await readdir(this.tasksDir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isDirectory()) {
-                continue;
-            }
-            // Skip archive directory
-            if (entry.name === 'archive') {
-                continue;
-            }
-            const taskPath = path.join(this.tasksDir, entry.name);
-            const proposalPath = path.join(taskPath, 'proposal.md');
-            // Read proposal.md to extract task info
-            if (existsSync(proposalPath)) {
-                try {
-                    const proposal = await readFile(proposalPath, 'utf-8');
-                    const task = {
-                        id: entry.name,
-                        path: taskPath,
-                        proposal,
-                    };
-                    tasks.push(task);
-                }
-                catch (err) {
-                    this.logger.warn(`Failed to read task ${entry.name}: ${err}`);
-                }
-            }
-        }
-        return tasks;
-    }
-    /**
-     * Convert a rulebook task to Ralph user story format
-     * Uses the full rulebook task structure: proposal.md + tasks.md + specs/
-     */
-    async convertTaskToUserStory(task, priority) {
-        const title = this.extractTitle(task.proposal);
-        const description = this.extractDescription(task.proposal);
-        const tasksChecklist = await this.loadTasksChecklist(task.path);
-        const specCriteria = await this.loadSpecCriteria(task.path);
-        // Merge checklist items with SHALL/MUST requirements from specs
-        const allCriteria = [...tasksChecklist, ...specCriteria];
-        // Build notes: include spec file references for traceability
-        const specSources = await this.listSpecFiles(task.path);
-        const notes = specSources.length > 0 ? `Spec files: ${specSources.join(', ')}` : '';
-        return {
-            id: `US-${String(priority).padStart(3, '0')}`,
-            title: title || task.id,
-            description: description || 'Task extracted from rulebook proposal',
-            acceptanceCriteria: [
-                ...(allCriteria.length > 0 ? allCriteria.slice(0, 12) : ['Implementation complete']),
-                // v5.3.0 F-NEW-3: mandatory tail items
-                'Update or create documentation covering the implementation',
-                'Write tests covering the new behavior',
-                'Run tests and confirm they pass',
-            ],
-            priority,
-            passes: false,
-            notes,
-            sourceTaskId: task.id,
-        };
-    }
-    /**
-     * Load SHALL/MUST requirements from specs/*.md files as acceptance criteria.
-     */
-    async loadSpecCriteria(taskPath) {
-        const specsDir = path.join(taskPath, 'specs');
-        if (!existsSync(specsDir)) {
-            return [];
-        }
-        const criteria = [];
-        try {
-            const entries = await readdir(specsDir, { withFileTypes: true });
-            for (const entry of entries) {
-                const entryPath = path.join(specsDir, entry.name);
-                if (entry.isDirectory()) {
-                    // Recurse one level: specs/<module>/spec.md
-                    const subEntries = await readdir(entryPath, { withFileTypes: true });
-                    for (const sub of subEntries) {
-                        if (sub.isFile() && sub.name.endsWith('.md')) {
-                            const content = await readFile(path.join(entryPath, sub.name), 'utf-8');
-                            this.extractShallMust(content, criteria);
-                        }
-                    }
-                }
-                else if (entry.isFile() && entry.name.endsWith('.md')) {
-                    const content = await readFile(entryPath, 'utf-8');
-                    this.extractShallMust(content, criteria);
-                }
-            }
-        }
-        catch (err) {
-            this.logger.warn(`Failed to read spec files for task at ${taskPath}: ${err}`);
-        }
-        return criteria;
-    }
-    /**
-     * Extract SHALL/MUST statements from spec content as acceptance criteria.
-     */
-    extractShallMust(content, criteria) {
-        const lines = content.split('\n');
-        for (const line of lines) {
-            const trimmed = line.trim();
-            // Match lines with SHALL or MUST (requirement language)
-            if (/\b(SHALL|MUST)\b/.test(trimmed) && trimmed.length > 10 && trimmed.length < 300) {
-                // Clean up markdown: remove leading dashes, asterisks, backtick code
-                const cleaned = trimmed.replace(/^[-*]\s+/, '').replace(/`[^`]+`/g, (m) => m.slice(1, -1));
-                if (!criteria.includes(cleaned)) {
-                    criteria.push(cleaned);
-                }
-            }
-        }
-    }
-    /**
-     * List relative paths of spec files for notes/traceability.
-     */
-    async listSpecFiles(taskPath) {
-        const specsDir = path.join(taskPath, 'specs');
-        if (!existsSync(specsDir)) {
-            return [];
-        }
-        const files = [];
-        try {
-            const entries = await readdir(specsDir, { withFileTypes: true });
-            for (const entry of entries) {
-                if (entry.isDirectory()) {
-                    const subEntries = await readdir(path.join(specsDir, entry.name), {
-                        withFileTypes: true,
-                    });
-                    for (const sub of subEntries) {
-                        if (sub.isFile() && sub.name.endsWith('.md')) {
-                            files.push(`specs/${entry.name}/${sub.name}`);
-                        }
-                    }
-                }
-                else if (entry.isFile() && entry.name.endsWith('.md')) {
-                    files.push(`specs/${entry.name}`);
-                }
-            }
-        }
-        catch {
-            // ignore
-        }
-        return files;
-    }
-    /**
-     * Load tasks checklist from tasks.md
-     */
-    async loadTasksChecklist(taskPath) {
-        const tasksPath = path.join(taskPath, 'tasks.md');
-        const tasks = [];
-        if (!existsSync(tasksPath)) {
-            return tasks;
-        }
-        try {
-            const content = await readFile(tasksPath, 'utf-8');
-            const lines = content.split('\n');
-            for (const line of lines) {
-                // Match checkbox lines: "- [ ] Task description" or "- [x] Task description"
-                const match = line.match(/^-\s+\[[^\]]\]\s+(.+)$/);
-                if (match) {
-                    tasks.push(match[1].trim());
-                }
-            }
-        }
-        catch (err) {
-            this.logger.warn(`Failed to read tasks.md: ${err}`);
-        }
-        return tasks;
-    }
-    /**
-     * Extract title from proposal markdown
-     */
-    extractTitle(proposal) {
-        const titleMatch = proposal.match(/^#\s+(.+?)$/m);
-        return titleMatch ? titleMatch[1].trim() : '';
-    }
-    /**
-     * Extract description from proposal markdown
-     */
-    extractDescription(proposal) {
-        // Extract "What Changes" or first substantial paragraph
-        // eslint-disable-next-line no-useless-escape
-        const whatChangesMatch = proposal.match(/##\s+What Changes\n\n([\s\S]*?)(?=##|$)/);
-        if (whatChangesMatch) {
-            return whatChangesMatch[1].trim().substring(0, 500);
-        }
-        // Fall back to first paragraph
-        const lines = proposal.split('\n').filter((l) => l.trim() && !l.startsWith('#'));
-        return lines.slice(0, 3).join('\n').substring(0, 500);
-    }
-}
-//# sourceMappingURL=prd-generator.js.map

package/dist/core/prd-generator.js.map

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

package/dist/core/ralph-manager.d.ts

@@ -1,163 +0,0 @@
-import { Logger } from './logger.js';
-import { RalphLoopState, RalphIterationMetadata, IterationResult, PRDUserStory, PlanCheckpointConfig } from '../types.js';
-/** Minimal interface for memory integration — avoids hard dependency on MemoryManager */
-export interface RalphMemoryAdapter {
-    saveMemory(input: {
-        type: string;
-        title: string;
-        content: string;
-        tags: string[];
-    }): Promise<unknown>;
-}
-export interface RalphLockInfo {
-    pid: number;
-    startedAt: string;
-    tool: string;
-    currentTask?: string;
-    iteration?: number;
-}
-export declare class RalphManager {
-    private projectRoot;
-    private ralphDir;
-    private historyDir;
-    private lockPath;
-    private loopState;
-    private logger;
-    private memoryAdapter;
-    constructor(projectRoot: string, logger: Logger);
-    /**
-     * Attach a memory adapter for auto-saving iteration learnings.
-     * Call before running the loop. Safe to skip — all memory ops are fire-and-forget.
-     */
-    setMemoryAdapter(adapter: RalphMemoryAdapter): void;
-    /**
-     * Acquire an exclusive lock for Ralph execution.
-     * Returns true if lock was acquired, false if another process holds it.
-     */
-    acquireLock(tool: string): Promise<boolean>;
-    /**
-     * Release the Ralph execution lock.
-     */
-    releaseLock(): Promise<void>;
-    /**
-     * Update lock with current progress info.
-     */
-    updateLockProgress(iteration: number, currentTask?: string): Promise<void>;
-    /**
-     * Read current lock info. Returns null if no lock exists.
-     */
-    getLockInfo(): Promise<RalphLockInfo | null>;
-    /**
-     * Check if a Ralph loop is currently running (lock held by alive process).
-     */
-    isRunning(): Promise<boolean>;
-    /**
-     * Check if a PID is alive.
-     */
-    private isPidAlive;
-    /**
-     * Initialize Ralph loop state and directory structure
-     */
-    initialize(maxIterations: number, tool: 'claude' | 'amp' | 'gemini'): Promise<void>;
-    /**
-     * Load PRD from .rulebook/ralph/prd.json
-     */
-    loadPRD(): Promise<any | null>;
-    /**
-     * Get the next task to execute
-     * Returns a pending task or null if all tasks are completed
-     */
-    getNextTask(): Promise<any | null>;
-    /**
-     * Mark a user story as complete and sync tasks.md checkboxes
-     */
-    markStoryComplete(storyId: string): Promise<void>;
-    /**
-     * Mark matching checkboxes in tasks.md as completed
-     */
-    private syncTasksCheckboxes;
-    /**
-     * Record iteration result to history
-     */
-    recordIteration(result: IterationResult): Promise<void>;
-    /**
-     * Save iteration data to the memory system for cross-session learning.
-     * Runs fire-and-forget — failures are silently ignored.
-     */
-    private saveIterationToMemory;
-    /**
-     * Append iteration result to progress.txt log
-     */
-    private appendProgress;
-    /**
-     * Refresh total_tasks from PRD (call after PRD is saved)
-     */
-    refreshTaskCount(): Promise<void>;
-    /**
-     * Check if loop should continue
-     */
-    canContinue(): boolean;
-    /**
-     * Pause the loop
-     */
-    pause(): Promise<void>;
-    /**
-     * Resume the loop
-     */
-    resume(): Promise<void>;
-    /**
-     * Get current loop status
-     */
-    getStatus(): Promise<RalphLoopState | null>;
-    /**
-     * Get iteration history
-     */
-    getIterationHistory(limit?: number): Promise<RalphIterationMetadata[]>;
-    /**
-     * Save loop state to .rulebook/ralph/state.json
-     */
-    private saveLoopState;
-    /**
-     * Load loop state from .rulebook/ralph/state.json
-     */
-    private loadLoopState;
-    /**
-     * Get total completed and pending tasks
-     */
-    getTaskStats(): Promise<{
-        completed: number;
-        pending: number;
-        total: number;
-    }>;
-    /**
-     * Build parallel execution batches for pending stories.
-     *
-     * Uses dependency analysis and file-conflict detection to produce
-     * batches where each batch can be executed concurrently.
-     *
-     * @param maxWorkers - Maximum number of concurrent stories per batch
-     * @returns Array of batches (each batch is an array of stories)
-     */
-    getParallelBatches(maxWorkers: number): Promise<PRDUserStory[][]>;
-    /**
-     * Run a plan checkpoint for the given story.
-     *
-     * Generates an implementation plan via the AI CLI tool and requests
-     * interactive approval from the user. Returns whether to proceed with
-     * implementation and any feedback from the reviewer.
-     *
-     * @param story - The user story to plan for
-     * @param tool - AI CLI tool to use for plan generation
-     * @param checkpointConfig - Plan checkpoint configuration
-     * @returns Object with `proceed` (boolean) and optional `feedback` string
-     */
-    runCheckpoint(story: PRDUserStory, tool: 'claude' | 'amp' | 'gemini', checkpointConfig: PlanCheckpointConfig): Promise<{
-        proceed: boolean;
-        feedback?: string;
-    }>;
-    /**
-     * Helper to read file
-     */
-    private readFileAsync;
-}
-//# sourceMappingURL=ralph-manager.d.ts.map

package/dist/core/ralph-manager.d.ts.map

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