@hivehub/rulebook 5.7.0 → 5.8.1

package/dist/core/iteration-tracker.d.ts

@@ -1,85 +0,0 @@
-import { Logger } from './logger.js';
-import { RalphIterationMetadata, IterationResult } from '../types.js';
-/** Minimal interface for memory search — avoids hard dependency on MemoryManager */
-export interface IterationMemoryAdapter {
-    searchMemory(input: {
-        query: string;
-        limit?: number;
-        mode?: 'bm25' | 'vector' | 'hybrid';
-    }): Promise<Array<{
-        title: string;
-        content: string;
-        tags?: string[];
-    }>>;
-}
-/**
- * Tracks iteration history, metrics, and learnings across autonomous runs
- */
-export declare class IterationTracker {
-    private ralphDir;
-    private historyDir;
-    private logger;
-    private memoryAdapter;
-    constructor(projectRoot: string, logger: Logger);
-    /**
-     * Attach a memory adapter for retrieving relevant past learnings.
-     * Optional — context compression still works without it.
-     */
-    setMemoryAdapter(adapter: IterationMemoryAdapter): void;
-    /**
-     * Initialize tracker directories
-     */
-    initialize(): Promise<void>;
-    /**
-     * Record a single iteration result
-     */
-    recordIteration(result: IterationResult): Promise<string>;
-    /**
-     * Get iteration history with optional filtering
-     */
-    getHistory(limit?: number, taskId?: string): Promise<RalphIterationMetadata[]>;
-    /**
-     * Get single iteration details
-     */
-    getIteration(iterationNum: number): Promise<RalphIterationMetadata | null>;
-    /**
-     * Calculate statistics from iteration history
-     */
-    getStatistics(): Promise<{
-        total_iterations: number;
-        successful_iterations: number;
-        failed_iterations: number;
-        average_duration_ms: number;
-        success_rate: number;
-        quality_breakdown: {
-            type_check: number;
-            lint: number;
-            tests: number;
-            coverage: number;
-        };
-    }>;
-    /**
-     * Get learnings and insights from history
-     */
-    getLearnings(): Promise<string[]>;
-    /**
-     * Get insights about task-specific patterns
-     */
-    getTaskInsights(taskId: string): Promise<{
-        total_iterations: number;
-        status_distribution: Record<string, number>;
-        average_duration_ms: number;
-        quality_trend: number[];
-    }>;
-    /**
-     * Build a compressed context string for injecting into iteration prompts.
-     * Recent iterations (default: last 3) appear in full detail.
-     * Older iterations are summarized to one line each.
-     *
-     * @param recentCount  How many recent iterations to show in full (default: 3)
-     * @param threshold    Minimum total iterations before compression applies (default: 5)
-     */
-    buildCompressedContext(recentCount?: number, threshold?: number): Promise<string>;
-    private formatFullHistory;
-}
-//# sourceMappingURL=iteration-tracker.d.ts.map

package/dist/core/iteration-tracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"iteration-tracker.d.ts","sourceRoot":"","sources":["../../src/core/iteration-tracker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,KAAK,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;KACrC,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC;CACzE;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAuC;gBAEhD,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM/C;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAIvD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB/D;;OAEG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAuCpF;;OAEG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAgBhF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;QACzB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE;YACjB,UAAU,EAAE,MAAM,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;IAoCF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA2CvC;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IA4CF;;;;;;;OAOG;IACG,sBAAsB,CAAC,WAAW,SAAI,EAAE,SAAS,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAgE7E,OAAO,CAAC,iBAAiB;CAe1B"}

package/dist/core/iteration-tracker.js

@@ -1,295 +0,0 @@
-import { mkdir, readdir, writeFile, readFile } from 'fs/promises';
-import { existsSync } from 'fs';
-import path from 'path';
-/**
- * Tracks iteration history, metrics, and learnings across autonomous runs
- */
-export class IterationTracker {
-    ralphDir;
-    historyDir;
-    logger;
-    memoryAdapter = null;
-    constructor(projectRoot, logger) {
-        this.logger = logger;
-        this.ralphDir = path.join(projectRoot, '.rulebook', 'ralph');
-        this.historyDir = path.join(this.ralphDir, 'history');
-    }
-    /**
-     * Attach a memory adapter for retrieving relevant past learnings.
-     * Optional — context compression still works without it.
-     */
-    setMemoryAdapter(adapter) {
-        this.memoryAdapter = adapter;
-    }
-    /**
-     * Initialize tracker directories
-     */
-    async initialize() {
-        await mkdir(this.ralphDir, { recursive: true });
-        await mkdir(this.historyDir, { recursive: true });
-    }
-    /**
-     * Record a single iteration result
-     */
-    async recordIteration(result) {
-        await this.initialize();
-        const metadata = {
-            iteration: result.iteration,
-            started_at: result.timestamp,
-            completed_at: new Date().toISOString(),
-            task_id: result.task_id,
-            task_title: result.task_title,
-            duration_ms: result.execution_time_ms,
-            status: result.status,
-            git_commit: result.git_commit,
-            quality_checks: result.quality_checks,
-        };
-        const filename = `iteration-${result.iteration}.json`;
-        const filepath = path.join(this.historyDir, filename);
-        await writeFile(filepath, JSON.stringify(metadata, null, 2));
-        this.logger.info(`Recorded iteration #${result.iteration}`);
-        return filepath;
-    }
-    /**
-     * Get iteration history with optional filtering
-     */
-    async getHistory(limit, taskId) {
-        if (!existsSync(this.historyDir)) {
-            return [];
-        }
-        const files = await readdir(this.historyDir);
-        const iterations = [];
-        // Sort by iteration number descending
-        const sorted = files
-            .filter((f) => f.startsWith('iteration-') && f.endsWith('.json'))
-            .sort((a, b) => {
-            const numA = parseInt(a.match(/\d+/)?.[0] || '0');
-            const numB = parseInt(b.match(/\d+/)?.[0] || '0');
-            return numB - numA;
-        });
-        for (const file of sorted) {
-            try {
-                const content = await readFile(path.join(this.historyDir, file), 'utf-8');
-                const metadata = JSON.parse(content);
-                if (taskId && metadata.task_id !== taskId) {
-                    continue;
-                }
-                iterations.push(metadata);
-                if (limit && iterations.length >= limit) {
-                    break;
-                }
-            }
-            catch (err) {
-                this.logger.warn(`Failed to read ${file}: ${err}`);
-            }
-        }
-        return iterations;
-    }
-    /**
-     * Get single iteration details
-     */
-    async getIteration(iterationNum) {
-        const filepath = path.join(this.historyDir, `iteration-${iterationNum}.json`);
-        if (!existsSync(filepath)) {
-            return null;
-        }
-        try {
-            const content = await readFile(filepath, 'utf-8');
-            return JSON.parse(content);
-        }
-        catch (err) {
-            this.logger.error(`Failed to read iteration ${iterationNum}: ${err}`);
-            return null;
-        }
-    }
-    /**
-     * Calculate statistics from iteration history
-     */
-    async getStatistics() {
-        const iterations = await this.getHistory();
-        if (iterations.length === 0) {
-            return {
-                total_iterations: 0,
-                successful_iterations: 0,
-                failed_iterations: 0,
-                average_duration_ms: 0,
-                success_rate: 0,
-                quality_breakdown: { type_check: 0, lint: 0, tests: 0, coverage: 0 },
-            };
-        }
-        const successful = iterations.filter((i) => i.status === 'success').length;
-        const failed = iterations.filter((i) => i.status === 'failed').length;
-        const totalDuration = iterations.reduce((sum, i) => sum + (i.duration_ms || 0), 0);
-        const avgDuration = Math.round(totalDuration / iterations.length);
-        const qualityBreakdown = {
-            type_check: iterations.filter((i) => i.quality_checks.type_check).length,
-            lint: iterations.filter((i) => i.quality_checks.lint).length,
-            tests: iterations.filter((i) => i.quality_checks.tests).length,
-            coverage: iterations.filter((i) => i.quality_checks.coverage_met).length,
-        };
-        return {
-            total_iterations: iterations.length,
-            successful_iterations: successful,
-            failed_iterations: failed,
-            average_duration_ms: avgDuration,
-            success_rate: successful / iterations.length,
-            quality_breakdown: qualityBreakdown,
-        };
-    }
-    /**
-     * Get learnings and insights from history
-     */
-    async getLearnings() {
-        const iterations = await this.getHistory();
-        const learnings = [];
-        for (const iter of iterations) {
-            // Analyze quality trends
-            const allPass = iter.quality_checks.type_check &&
-                iter.quality_checks.lint &&
-                iter.quality_checks.tests &&
-                iter.quality_checks.coverage_met;
-            if (allPass && iter.status === 'success') {
-                learnings.push(`✅ Iteration ${iter.iteration}: Full quality gate pass for "${iter.task_title}"`);
-            }
-            else if (iter.status === 'failed') {
-                const failures = [];
-                if (!iter.quality_checks.type_check)
-                    failures.push('type-check');
-                if (!iter.quality_checks.lint)
-                    failures.push('lint');
-                if (!iter.quality_checks.tests)
-                    failures.push('tests');
-                if (!iter.quality_checks.coverage_met)
-                    failures.push('coverage');
-                if (failures.length > 0) {
-                    learnings.push(`❌ Iteration ${iter.iteration}: Failed quality checks: ${failures.join(', ')}`);
-                }
-            }
-        }
-        // Add statistical insights
-        const stats = await this.getStatistics();
-        if (stats.total_iterations > 0) {
-            learnings.push(`📊 Success rate: ${(stats.success_rate * 100).toFixed(1)}% (${stats.successful_iterations}/${stats.total_iterations})`);
-            learnings.push(`⏱️ Average iteration time: ${stats.average_duration_ms}ms`);
-        }
-        return learnings;
-    }
-    /**
-     * Get insights about task-specific patterns
-     */
-    async getTaskInsights(taskId) {
-        const iterations = await this.getHistory(undefined, taskId);
-        if (iterations.length === 0) {
-            return {
-                total_iterations: 0,
-                status_distribution: {},
-                average_duration_ms: 0,
-                quality_trend: [],
-            };
-        }
-        // Status distribution
-        const statusDist = {};
-        for (const iter of iterations) {
-            statusDist[iter.status] = (statusDist[iter.status] || 0) + 1;
-        }
-        // Average duration
-        const avgDuration = Math.round(iterations.reduce((sum, i) => sum + (i.duration_ms || 0), 0) / iterations.length);
-        // Quality trend
-        const qualityTrend = iterations
-            .sort((a, b) => a.iteration - b.iteration)
-            .map((i) => {
-            const checks = [
-                i.quality_checks.type_check ? 1 : 0,
-                i.quality_checks.lint ? 1 : 0,
-                i.quality_checks.tests ? 1 : 0,
-                i.quality_checks.coverage_met ? 1 : 0,
-            ];
-            return (checks.reduce((a, b) => a + b, 0) / 4) * 100;
-        });
-        return {
-            total_iterations: iterations.length,
-            status_distribution: statusDist,
-            average_duration_ms: avgDuration,
-            quality_trend: qualityTrend,
-        };
-    }
-    /**
-     * Build a compressed context string for injecting into iteration prompts.
-     * Recent iterations (default: last 3) appear in full detail.
-     * Older iterations are summarized to one line each.
-     *
-     * @param recentCount  How many recent iterations to show in full (default: 3)
-     * @param threshold    Minimum total iterations before compression applies (default: 5)
-     */
-    async buildCompressedContext(recentCount = 3, threshold = 5) {
-        const iterations = await this.getHistory();
-        if (iterations.length === 0) {
-            return 'No iteration history available.';
-        }
-        // Sort ascending by iteration number
-        const sorted = [...iterations].sort((a, b) => a.iteration - b.iteration);
-        if (sorted.length < threshold) {
-            // Below threshold — return full history (not yet compressed)
-            return this.formatFullHistory(sorted);
-        }
-        const recent = sorted.slice(-recentCount);
-        const historical = sorted.slice(0, sorted.length - recentCount);
-        const lines = [];
-        // Memory-backed retrieval: search for relevant past learnings
-        if (this.memoryAdapter) {
-            try {
-                const currentTask = recent.at(-1)?.task_title ?? '';
-                const query = currentTask
-                    ? `Ralph iteration learnings ${currentTask}`
-                    : 'Ralph iteration learnings errors fixes';
-                const memories = await this.memoryAdapter.searchMemory({ query, limit: 3, mode: 'hybrid' });
-                if (memories.length > 0) {
-                    lines.push('## Relevant Past Learnings (from memory)');
-                    for (const mem of memories) {
-                        lines.push(`- **${mem.title}**: ${mem.content.slice(0, 200).replace(/\n/g, ' ')}`);
-                    }
-                    lines.push('');
-                }
-            }
-            catch {
-                // Memory retrieval is optional — skip on error
-            }
-        }
-        // Compressed historical summary
-        if (historical.length > 0) {
-            lines.push(`## Iteration History Summary (iterations 1–${historical.at(-1).iteration})`);
-            for (const iter of historical) {
-                const qualFlags = [
-                    iter.quality_checks.type_check ? '✓ts' : '✗ts',
-                    iter.quality_checks.lint ? '✓lint' : '✗lint',
-                    iter.quality_checks.tests ? '✓test' : '✗test',
-                    iter.quality_checks.coverage_met ? '✓cov' : '✗cov',
-                ].join(' ');
-                lines.push(`- Iter ${iter.iteration}: [${iter.status}] ${iter.task_title} | ${qualFlags}`);
-            }
-            lines.push('');
-        }
-        // Full detail for recent iterations
-        if (recent.length > 0) {
-            lines.push(`## Recent Iterations (last ${recent.length})`);
-            lines.push(this.formatFullHistory(recent));
-        }
-        return lines.join('\n');
-    }
-    formatFullHistory(iterations) {
-        return iterations
-            .map((iter) => {
-            const qc = iter.quality_checks;
-            return [
-                `### Iteration ${iter.iteration}: ${iter.task_title}`,
-                `Status: ${iter.status}`,
-                `Quality: type-check=${qc.type_check ? 'PASS' : 'FAIL'} lint=${qc.lint ? 'PASS' : 'FAIL'} tests=${qc.tests ? 'PASS' : 'FAIL'} coverage=${qc.coverage_met ? 'PASS' : 'FAIL'}`,
-                iter.git_commit ? `Commit: ${iter.git_commit}` : '',
-            ]
-                .filter(Boolean)
-                .join('\n');
-        })
-            .join('\n\n');
-    }
-}
-//# sourceMappingURL=iteration-tracker.js.map

package/dist/core/iteration-tracker.js.map

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

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

@@ -1,24 +0,0 @@
-import type { KnowledgeEntry, KnowledgeType, KnowledgeCategory } from '../types.js';
-export declare class KnowledgeManager {
-    private knowledgePath;
-    constructor(projectRoot: string, rulebookDir?: string);
-    private ensureDir;
-    add(type: KnowledgeType, title: string, options: {
-        category: KnowledgeCategory;
-        description: string;
-        example?: string;
-        whenToUse?: string;
-        whenNotToUse?: string;
-        tags?: string[];
-        source?: KnowledgeEntry['source'];
-    }): Promise<KnowledgeEntry>;
-    list(type?: KnowledgeType, category?: KnowledgeCategory): Promise<KnowledgeEntry[]>;
-    show(id: string): Promise<{
-        entry: KnowledgeEntry;
-        content: string;
-    } | null>;
-    remove(id: string): Promise<boolean>;
-    getForGenerator(): Promise<string>;
-    private renderMarkdown;
-}
-//# sourceMappingURL=knowledge-manager.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-manager.d.ts","sourceRoot":"","sources":["../../src/core/knowledge-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAiBpF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAS;gBAElB,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAoB;IAIlE,OAAO,CAAC,SAAS;IAoBX,GAAG,CACP,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QACP,QAAQ,EAAE,iBAAiB,CAAC;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;KACnC,GACA,OAAO,CAAC,cAAc,CAAC;IA6BpB,IAAI,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAyBnF,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAiB5E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAepC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IA2BxC,OAAO,CAAC,cAAc;CAwBvB"}

package/dist/core/knowledge-manager.js

@@ -1,173 +0,0 @@
-import { existsSync, mkdirSync, readdirSync, rmSync } from 'fs';
-import { join } from 'path';
-import { readFile as readFileUtil, writeFile as writeFileUtil } from '../utils/file-system.js';
-const KNOWLEDGE_DIR = 'knowledge';
-const PATTERNS_DIR = 'patterns';
-const ANTI_PATTERNS_DIR = 'anti-patterns';
-function slugify(title) {
-    return title
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-|-$/g, '');
-}
-function subdir(type) {
-    return type === 'pattern' ? PATTERNS_DIR : ANTI_PATTERNS_DIR;
-}
-export class KnowledgeManager {
-    knowledgePath;
-    constructor(projectRoot, rulebookDir = '.rulebook') {
-        this.knowledgePath = join(projectRoot, rulebookDir, KNOWLEDGE_DIR);
-    }
-    ensureDir(type) {
-        if (!existsSync(this.knowledgePath)) {
-            mkdirSync(this.knowledgePath, { recursive: true });
-        }
-        if (type) {
-            const dir = join(this.knowledgePath, subdir(type));
-            if (!existsSync(dir)) {
-                mkdirSync(dir, { recursive: true });
-            }
-        }
-        else {
-            // Ensure both
-            for (const d of [PATTERNS_DIR, ANTI_PATTERNS_DIR]) {
-                const dir = join(this.knowledgePath, d);
-                if (!existsSync(dir)) {
-                    mkdirSync(dir, { recursive: true });
-                }
-            }
-        }
-    }
-    async add(type, title, options) {
-        this.ensureDir(type);
-        const id = slugify(title);
-        const dir = join(this.knowledgePath, subdir(type));
-        const entry = {
-            id,
-            type,
-            title,
-            category: options.category,
-            description: options.description,
-            example: options.example,
-            whenToUse: options.whenToUse,
-            whenNotToUse: options.whenNotToUse,
-            createdAt: new Date().toISOString(),
-            tags: options.tags ?? [],
-            source: options.source ?? 'manual',
-        };
-        // Write markdown
-        const md = this.renderMarkdown(entry);
-        await writeFileUtil(join(dir, `${id}.md`), md);
-        // Write metadata
-        await writeFileUtil(join(dir, `${id}.metadata.json`), JSON.stringify(entry, null, 2));
-        return entry;
-    }
-    async list(type, category) {
-        this.ensureDir();
-        const types = type ? [type] : ['pattern', 'anti-pattern'];
-        const entries = [];
-        for (const t of types) {
-            const dir = join(this.knowledgePath, subdir(t));
-            if (!existsSync(dir))
-                continue;
-            const files = readdirSync(dir).filter((f) => f.endsWith('.metadata.json'));
-            for (const file of files) {
-                const raw = await readFileUtil(join(dir, file));
-                if (!raw)
-                    continue;
-                try {
-                    const meta = JSON.parse(raw);
-                    if (category && meta.category !== category)
-                        continue;
-                    entries.push(meta);
-                }
-                catch {
-                    // skip malformed
-                }
-            }
-        }
-        return entries.sort((a, b) => a.title.localeCompare(b.title));
-    }
-    async show(id) {
-        this.ensureDir();
-        // Search both dirs
-        for (const t of ['pattern', 'anti-pattern']) {
-            const dir = join(this.knowledgePath, subdir(t));
-            if (!existsSync(dir))
-                continue;
-            const metaPath = join(dir, `${id}.metadata.json`);
-            if (!existsSync(metaPath))
-                continue;
-            const raw = await readFileUtil(metaPath);
-            if (!raw)
-                continue;
-            const entry = JSON.parse(raw);
-            const content = (await readFileUtil(join(dir, `${id}.md`))) ?? '';
-            return { entry, content };
-        }
-        return null;
-    }
-    async remove(id) {
-        this.ensureDir();
-        for (const t of ['pattern', 'anti-pattern']) {
-            const dir = join(this.knowledgePath, subdir(t));
-            if (!existsSync(dir))
-                continue;
-            const metaPath = join(dir, `${id}.metadata.json`);
-            if (!existsSync(metaPath))
-                continue;
-            const mdPath = join(dir, `${id}.md`);
-            if (existsSync(mdPath))
-                rmSync(mdPath);
-            rmSync(metaPath);
-            return true;
-        }
-        return false;
-    }
-    async getForGenerator() {
-        const patterns = await this.list('pattern');
-        const antiPatterns = await this.list('anti-pattern');
-        if (patterns.length === 0 && antiPatterns.length === 0)
-            return '';
-        const lines = ['## Project Knowledge', ''];
-        if (patterns.length > 0) {
-            lines.push('### Patterns', '', 'The following patterns are enforced in this project:', '');
-            for (const p of patterns) {
-                lines.push(`- **${p.title}** → [spec](/.rulebook/knowledge/patterns/${p.id}.md)`);
-            }
-            lines.push('');
-        }
-        if (antiPatterns.length > 0) {
-            lines.push('### Anti-Patterns to Avoid', '');
-            for (const a of antiPatterns) {
-                lines.push(`- **${a.title}** → [details](/.rulebook/knowledge/anti-patterns/${a.id}.md)`);
-            }
-            lines.push('');
-        }
-        return lines.join('\n');
-    }
-    renderMarkdown(e) {
-        const lines = [
-            `# ${e.title}`,
-            '',
-            `**Category**: ${e.category}`,
-            `**Tags**: ${e.tags.join(', ') || 'none'}`,
-            '',
-            '## Description',
-            '',
-            e.description,
-        ];
-        if (e.example) {
-            lines.push('', '## Example', '', e.example);
-        }
-        if (e.whenToUse) {
-            lines.push('', '## When to Use', '', e.whenToUse);
-        }
-        if (e.whenNotToUse) {
-            lines.push('', '## When NOT to Use', '', e.whenNotToUse);
-        }
-        lines.push('');
-        return lines.join('\n');
-    }
-}
-//# sourceMappingURL=knowledge-manager.js.map

package/dist/core/knowledge-manager.js.map

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

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

@@ -1,29 +0,0 @@
-import type { Learning, KnowledgeCategory } from '../types.js';
-export declare class LearnManager {
-    private learningsPath;
-    private ralphHistoryPath;
-    private decisionManager;
-    private knowledgeManager;
-    constructor(projectRoot: string, rulebookDir?: string);
-    private ensureDir;
-    capture(title: string, content: string, options?: {
-        source?: Learning['source'];
-        relatedTask?: string;
-        relatedDecision?: number;
-        tags?: string[];
-    }): Promise<Learning>;
-    fromRalph(): Promise<Learning[]>;
-    list(limit?: number): Promise<Learning[]>;
-    show(id: string): Promise<{
-        learning: Learning;
-        content: string;
-    } | null>;
-    promote(id: string, target: 'knowledge' | 'decision', options?: {
-        title?: string;
-        category?: KnowledgeCategory;
-    }): Promise<{
-        type: 'knowledge' | 'decision';
-        id: string;
-    } | null>;
-}
-//# sourceMappingURL=learn-manager.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"learn-manager.d.ts","sourceRoot":"","sources":["../../src/core/learn-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAa/D,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAoB;IAQlE,OAAO,CAAC,SAAS;IAMX,OAAO,CACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACZ,GACL,OAAO,CAAC,QAAQ,CAAC;IA0Cd,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAyChC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAoBzC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAazE,OAAO,CACX,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GAAG,UAAU,EAChC,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,iBAAiB,CAAC;KACzB,GACL,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAkClE"}