@hivehub/rulebook 4.3.1 → 4.4.1

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

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-manager.d.ts","sourceRoot":"","sources":["../../src/core/knowledge-manager.ts"],"names":[],"mappings":"AAMA,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;IA+BxC,OAAO,CAAC,cAAc;CAwBvB"}

package/dist/core/knowledge-manager.js

@@ -0,0 +1,173 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,29 @@
+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

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

package/dist/core/learn-manager.js

@@ -0,0 +1,159 @@
+import { existsSync, mkdirSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { readFile as readFileUtil, writeFile as writeFileUtil, } from '../utils/file-system.js';
+import { DecisionManager } from './decision-manager.js';
+import { KnowledgeManager } from './knowledge-manager.js';
+const LEARNINGS_DIR = 'learnings';
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+export class LearnManager {
+    learningsPath;
+    ralphHistoryPath;
+    decisionManager;
+    knowledgeManager;
+    constructor(projectRoot, rulebookDir = '.rulebook') {
+        const rbPath = join(projectRoot, rulebookDir);
+        this.learningsPath = join(rbPath, LEARNINGS_DIR);
+        this.ralphHistoryPath = join(rbPath, 'ralph', 'history');
+        this.decisionManager = new DecisionManager(projectRoot, rulebookDir);
+        this.knowledgeManager = new KnowledgeManager(projectRoot, rulebookDir);
+    }
+    ensureDir() {
+        if (!existsSync(this.learningsPath)) {
+            mkdirSync(this.learningsPath, { recursive: true });
+        }
+    }
+    async capture(title, content, options = {}) {
+        this.ensureDir();
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+        const slug = slugify(title);
+        const id = `${timestamp}-${slug}`;
+        const learning = {
+            id,
+            title,
+            content,
+            source: options.source ?? 'manual',
+            relatedTask: options.relatedTask,
+            relatedDecision: options.relatedDecision,
+            tags: options.tags ?? [],
+            createdAt: new Date().toISOString(),
+        };
+        // Write markdown
+        const md = [
+            `# ${title}`,
+            '',
+            `**Source**: ${learning.source}`,
+            `**Date**: ${learning.createdAt.split('T')[0]}`,
+            learning.relatedTask ? `**Related Task**: ${learning.relatedTask}` : '',
+            learning.tags.length > 0 ? `**Tags**: ${learning.tags.join(', ')}` : '',
+            '',
+            content,
+            '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+        await writeFileUtil(join(this.learningsPath, `${id}.md`), md);
+        await writeFileUtil(join(this.learningsPath, `${id}.metadata.json`), JSON.stringify(learning, null, 2));
+        return learning;
+    }
+    async fromRalph() {
+        this.ensureDir();
+        if (!existsSync(this.ralphHistoryPath))
+            return [];
+        const files = readdirSync(this.ralphHistoryPath).filter((f) => f.startsWith('iteration-') && f.endsWith('.json'));
+        // Load existing learning titles for dedup
+        const existing = await this.list();
+        const existingTitles = new Set(existing.map((l) => l.title));
+        const newLearnings = [];
+        for (const file of files) {
+            const raw = await readFileUtil(join(this.ralphHistoryPath, file));
+            if (!raw)
+                continue;
+            try {
+                const iteration = JSON.parse(raw);
+                const learnings = iteration.learnings ?? [];
+                for (const text of learnings) {
+                    // Use first line or first 60 chars as title
+                    const title = text.split('\n')[0].slice(0, 80);
+                    if (existingTitles.has(title))
+                        continue;
+                    existingTitles.add(title);
+                    const learning = await this.capture(title, text, {
+                        source: 'ralph',
+                        relatedTask: iteration.task_id,
+                        tags: ['ralph', `iteration-${iteration.iteration}`],
+                    });
+                    newLearnings.push(learning);
+                }
+            }
+            catch {
+                // skip malformed
+            }
+        }
+        return newLearnings;
+    }
+    async list(limit) {
+        this.ensureDir();
+        const files = readdirSync(this.learningsPath).filter((f) => f.endsWith('.metadata.json'));
+        const learnings = [];
+        for (const file of files) {
+            const raw = await readFileUtil(join(this.learningsPath, file));
+            if (!raw)
+                continue;
+            try {
+                learnings.push(JSON.parse(raw));
+            }
+            catch {
+                // skip malformed
+            }
+        }
+        // Sort newest first
+        learnings.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+        return limit ? learnings.slice(0, limit) : learnings;
+    }
+    async show(id) {
+        this.ensureDir();
+        const metaPath = join(this.learningsPath, `${id}.metadata.json`);
+        if (!existsSync(metaPath))
+            return null;
+        const raw = await readFileUtil(metaPath);
+        if (!raw)
+            return null;
+        const learning = JSON.parse(raw);
+        const content = (await readFileUtil(join(this.learningsPath, `${id}.md`))) ?? '';
+        return { learning, content };
+    }
+    async promote(id, target, options = {}) {
+        const result = await this.show(id);
+        if (!result)
+            return null;
+        const { learning } = result;
+        const title = options.title ?? learning.title;
+        let targetId;
+        if (target === 'knowledge') {
+            const entry = await this.knowledgeManager.add('pattern', title, {
+                category: options.category ?? 'code',
+                description: learning.content,
+                tags: learning.tags,
+                source: 'learn',
+            });
+            targetId = entry.id;
+        }
+        else {
+            const decision = await this.decisionManager.create(title, {
+                context: learning.content,
+                relatedTasks: learning.relatedTask ? [learning.relatedTask] : undefined,
+            });
+            targetId = String(decision.id);
+        }
+        // Mark as promoted
+        learning.promotedTo = { type: target, id: targetId };
+        await writeFileUtil(join(this.learningsPath, `${id}.metadata.json`), JSON.stringify(learning, null, 2));
+        return { type: target, id: targetId };
+    }
+}
+//# sourceMappingURL=learn-manager.js.map

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

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

package/dist/core/workspace/project-worker.d.ts

@@ -7,6 +7,9 @@
 import { TaskManager } from '../task-manager.js';
 import { ConfigManager } from '../config-manager.js';
 import { SkillsManager } from '../skills-manager.js';
+import { DecisionManager } from '../decision-manager.js';
+import { KnowledgeManager } from '../knowledge-manager.js';
+import { LearnManager } from '../learn-manager.js';
 import type { RulebookConfig } from '../../types.js';
 export declare class ProjectWorker {
     readonly projectId: string;
@@ -14,6 +17,9 @@ export declare class ProjectWorker {
     private taskManager;
     private configManager;
     private skillsManager;
+    private decisionManager;
+    private knowledgeManager;
+    private learnManager;
     private memoryManager;
     private bgIndexer;
     private _lastAccessedAt;
@@ -43,6 +49,9 @@ export declare class ProjectWorker {
     getSkillsManager(): SkillsManager;
     /** Returns the ConfigManager for this project. Throws if not initialized. */
     getConfigManager(): ConfigManager;
+    getDecisionManager(): DecisionManager;
+    getKnowledgeManager(): KnowledgeManager;
+    getLearnManager(): LearnManager;
     /** Returns the loaded RulebookConfig, or null if not initialized. */
     getRulebookConfig(): RulebookConfig | null;
 }

package/dist/core/workspace/project-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-worker.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/project-worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAA2B,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAEL;IAChB,OAAO,CAAC,SAAS,CAAiC;IAElD,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAA+B;gBAE1C,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKlD,uDAAuD;IACvD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6DAA6D;IAC7D,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,iDAAiD;IACjD,KAAK,IAAI,IAAI;IAIb,wEAAwE;IACxE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BjC,+DAA+D;IACzD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,2EAA2E;IAC3E,cAAc,IAAI,WAAW;IAM7B,gEAAgE;IAChE,gBAAgB,IAAI,OAAO,IAAI,CAAC,aAAa;IAK7C,6EAA6E;IAC7E,gBAAgB,IAAI,aAAa;IAMjC,6EAA6E;IAC7E,gBAAgB,IAAI,aAAa;IAMjC,qEAAqE;IACrE,iBAAiB,IAAI,cAAc,GAAG,IAAI;CAG3C"}
+{"version":3,"file":"project-worker.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/project-worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAA2B,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,aAAa,CAEL;IAChB,OAAO,CAAC,SAAS,CAAiC;IAElD,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAA+B;gBAE1C,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKlD,uDAAuD;IACvD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6DAA6D;IAC7D,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,iDAAiD;IACjD,KAAK,IAAI,IAAI;IAIb,wEAAwE;IACxE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC,+DAA+D;IACzD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,2EAA2E;IAC3E,cAAc,IAAI,WAAW;IAM7B,gEAAgE;IAChE,gBAAgB,IAAI,OAAO,IAAI,CAAC,aAAa;IAK7C,6EAA6E;IAC7E,gBAAgB,IAAI,aAAa;IAMjC,6EAA6E;IAC7E,gBAAgB,IAAI,aAAa;IAMjC,kBAAkB,IAAI,eAAe;IAMrC,mBAAmB,IAAI,gBAAgB;IAMvC,eAAe,IAAI,YAAY;IAM/B,qEAAqE;IACrE,iBAAiB,IAAI,cAAc,GAAG,IAAI;CAG3C"}

package/dist/core/workspace/project-worker.js

@@ -8,12 +8,18 @@ import { join } from 'node:path';
 import { TaskManager } from '../task-manager.js';
 import { ConfigManager } from '../config-manager.js';
 import { SkillsManager, getDefaultTemplatesPath } from '../skills-manager.js';
+import { DecisionManager } from '../decision-manager.js';
+import { KnowledgeManager } from '../knowledge-manager.js';
+import { LearnManager } from '../learn-manager.js';
 export class ProjectWorker {
     projectId;
     projectRoot;
     taskManager = null;
     configManager = null;
     skillsManager = null;
+    decisionManager = null;
+    knowledgeManager = null;
+    learnManager = null;
     memoryManager = null;
     bgIndexer = null;
     _lastAccessedAt = Date.now();
@@ -50,6 +56,9 @@ export class ProjectWorker {
         this._rulebookConfig = await this.configManager.loadConfig();
         this.taskManager = new TaskManager(this.projectRoot, '.rulebook');
         this.skillsManager = new SkillsManager(getDefaultTemplatesPath(), this.projectRoot);
+        this.decisionManager = new DecisionManager(this.projectRoot, '.rulebook');
+        this.knowledgeManager = new KnowledgeManager(this.projectRoot, '.rulebook');
+        this.learnManager = new LearnManager(this.projectRoot, '.rulebook');
         // Lazy-load memory if enabled in project config
         if (this._rulebookConfig.memory?.enabled) {
             try {
@@ -103,6 +112,24 @@ export class ProjectWorker {
             throw new Error(`Worker ${this.projectId} not initialized`);
         return this.configManager;
     }
+    getDecisionManager() {
+        this.touch();
+        if (!this.decisionManager)
+            throw new Error(`Worker ${this.projectId} not initialized`);
+        return this.decisionManager;
+    }
+    getKnowledgeManager() {
+        this.touch();
+        if (!this.knowledgeManager)
+            throw new Error(`Worker ${this.projectId} not initialized`);
+        return this.knowledgeManager;
+    }
+    getLearnManager() {
+        this.touch();
+        if (!this.learnManager)
+            throw new Error(`Worker ${this.projectId} not initialized`);
+        return this.learnManager;
+    }
     /** Returns the loaded RulebookConfig, or null if not initialized. */
     getRulebookConfig() {
         return this._rulebookConfig;

package/dist/core/workspace/project-worker.js.map

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

package/dist/index.js

@@ -16,7 +16,9 @@ reviewCommand,
 // Setup commands
 setupClaudeCodePlugin, migrateMemoryDirectory, 
 // Workspace commands (v4.2)
-workspaceInitCommand, workspaceAddCommand, workspaceRemoveCommand, workspaceListCommand, workspaceStatusCommand, } from './cli/commands.js';
+workspaceInitCommand, workspaceAddCommand, workspaceRemoveCommand, workspaceListCommand, workspaceStatusCommand, 
+// Context Intelligence commands (v4.4)
+decisionCreateCommand, decisionListCommand, decisionShowCommand, decisionSupersedeCommand, knowledgeAddCommand, knowledgeListCommand, knowledgeShowCommand, knowledgeRemoveCommand, learnCaptureCommand, learnFromRalphCommand, learnListCommand, learnPromoteCommand, } from './cli/commands.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import path from 'path';
@@ -393,5 +395,70 @@ workspaceCommand
     .command('status')
     .description('Show detailed workspace status (workers, tasks, memory)')
     .action(() => workspaceStatusCommand());
+// Context Intelligence commands (v4.4)
+const decisionCommand = program.command('decision').description('Manage Architecture Decision Records');
+decisionCommand
+    .command('create <title>')
+    .description('Create a new decision record')
+    .option('--context <context>', 'Decision context')
+    .option('--related-task <taskId>', 'Related task ID')
+    .action((title, options) => decisionCreateCommand(title, options));
+decisionCommand
+    .command('list')
+    .description('List all decisions')
+    .option('--status <status>', 'Filter by status: proposed, accepted, superseded, deprecated')
+    .action((options) => decisionListCommand(options));
+decisionCommand
+    .command('show <id>')
+    .description('Show decision details')
+    .action((id) => decisionShowCommand(id));
+decisionCommand
+    .command('supersede <oldId> <newId>')
+    .description('Mark a decision as superseded by another')
+    .action((oldId, newId) => decisionSupersedeCommand(oldId, newId));
+const knowledgeCommand = program.command('knowledge').description('Manage project knowledge base');
+knowledgeCommand
+    .command('add <type> <title>')
+    .description('Add a pattern or anti-pattern')
+    .option('--category <category>', 'Category: architecture, code, testing, security, performance, devops', 'code')
+    .option('--description <desc>', 'Description of the pattern')
+    .action((type, title, options) => knowledgeAddCommand(type, title, options));
+knowledgeCommand
+    .command('list')
+    .description('List knowledge entries')
+    .option('--type <type>', 'Filter by type: pattern, anti-pattern')
+    .option('--category <category>', 'Filter by category')
+    .action((options) => knowledgeListCommand(options));
+knowledgeCommand
+    .command('show <id>')
+    .description('Show knowledge entry details')
+    .action((id) => knowledgeShowCommand(id));
+knowledgeCommand
+    .command('remove <id>')
+    .description('Remove a knowledge entry')
+    .action((id) => knowledgeRemoveCommand(id));
+const learnCommand = program.command('learn').description('Capture and promote learnings');
+learnCommand
+    .command('capture')
+    .description('Capture a learning')
+    .option('--title <title>', 'Learning title')
+    .option('--content <content>', 'Learning content')
+    .option('--related-task <taskId>', 'Related task ID')
+    .option('--tags <tags>', 'Comma-separated tags')
+    .action((options) => learnCaptureCommand(options));
+learnCommand
+    .command('from-ralph')
+    .description('Extract learnings from Ralph iteration history')
+    .action(() => learnFromRalphCommand());
+learnCommand
+    .command('list')
+    .description('List learnings')
+    .option('--limit <n>', 'Max results', '20')
+    .action((options) => learnListCommand(options));
+learnCommand
+    .command('promote <id> <target>')
+    .description('Promote learning to knowledge entry or decision')
+    .option('--title <title>', 'Override title for the promoted entry')
+    .action((id, target, options) => learnPromoteCommand(id, target, options));
 program.parse(process.argv);
 //# sourceMappingURL=index.js.map