@hivehub/rulebook 5.5.2 → 5.7.0

package/dist/core/tasks/decision-manager.js

@@ -0,0 +1,183 @@
+import { existsSync, mkdirSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { readFile as readFileUtil, writeFile as writeFileUtil } from '../../utils/file-system.js';
+const DECISIONS_DIR = 'decisions';
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function pad(n) {
+    return String(n).padStart(3, '0');
+}
+export class DecisionManager {
+    decisionsPath;
+    constructor(projectRoot, rulebookDir = '.rulebook') {
+        this.decisionsPath = join(projectRoot, rulebookDir, DECISIONS_DIR);
+    }
+    ensureDir() {
+        if (!existsSync(this.decisionsPath)) {
+            mkdirSync(this.decisionsPath, { recursive: true });
+        }
+    }
+    async getNextId() {
+        this.ensureDir();
+        const files = readdirSync(this.decisionsPath).filter((f) => f.endsWith('.metadata.json'));
+        if (files.length === 0)
+            return 1;
+        const ids = files.map((f) => {
+            const match = f.match(/^(\d+)-/);
+            return match ? parseInt(match[1], 10) : 0;
+        });
+        return Math.max(...ids) + 1;
+    }
+    async create(title, options = {}) {
+        this.ensureDir();
+        const id = await this.getNextId();
+        const slug = slugify(title);
+        const date = new Date().toISOString().split('T')[0];
+        const status = options.status ?? 'proposed';
+        const entry = {
+            id,
+            slug,
+            title,
+            status,
+            date,
+            context: options.context ?? '',
+            decision: options.decision ?? '',
+            alternatives: options.alternatives ?? [],
+            consequences: options.consequences ?? '',
+            relatedTasks: options.relatedTasks,
+        };
+        const prefix = `${pad(id)}-${slug}`;
+        // Write markdown
+        const md = this.renderMarkdown(entry);
+        await writeFileUtil(join(this.decisionsPath, `${prefix}.md`), md);
+        // Write metadata
+        const metadata = {
+            id: entry.id,
+            slug: entry.slug,
+            title: entry.title,
+            status: entry.status,
+            date: entry.date,
+            relatedTasks: entry.relatedTasks ?? [],
+            supersededBy: null,
+        };
+        await writeFileUtil(join(this.decisionsPath, `${prefix}.metadata.json`), JSON.stringify(metadata, null, 2));
+        return entry;
+    }
+    async list(status) {
+        this.ensureDir();
+        const files = readdirSync(this.decisionsPath).filter((f) => f.endsWith('.metadata.json'));
+        const decisions = [];
+        for (const file of files) {
+            const raw = await readFileUtil(join(this.decisionsPath, file));
+            if (!raw)
+                continue;
+            try {
+                const meta = JSON.parse(raw);
+                if (status && meta.status !== status)
+                    continue;
+                decisions.push(meta);
+            }
+            catch {
+                // skip malformed
+            }
+        }
+        return decisions.sort((a, b) => a.id - b.id);
+    }
+    async show(id) {
+        this.ensureDir();
+        const files = readdirSync(this.decisionsPath).filter((f) => f.endsWith('.metadata.json'));
+        const metaFile = files.find((f) => {
+            const match = f.match(/^(\d+)-/);
+            return match ? parseInt(match[1], 10) === id : false;
+        });
+        if (!metaFile)
+            return null;
+        const raw = await readFileUtil(join(this.decisionsPath, metaFile));
+        if (!raw)
+            return null;
+        const meta = JSON.parse(raw);
+        const mdFile = metaFile.replace('.metadata.json', '.md');
+        const content = (await readFileUtil(join(this.decisionsPath, mdFile))) ?? '';
+        return { decision: meta, content };
+    }
+    async update(id, fields) {
+        const result = await this.show(id);
+        if (!result)
+            return null;
+        const { decision } = result;
+        const updated = { ...decision, ...fields };
+        const prefix = `${pad(id)}-${decision.slug}`;
+        await writeFileUtil(join(this.decisionsPath, `${prefix}.metadata.json`), JSON.stringify({
+            id: updated.id,
+            slug: updated.slug,
+            title: updated.title,
+            status: updated.status,
+            date: updated.date,
+            relatedTasks: updated.relatedTasks ?? [],
+            supersededBy: updated.supersededBy ?? null,
+        }, null, 2));
+        // Re-render markdown if content fields changed
+        if (fields.context || fields.decision || fields.consequences || fields.alternatives) {
+            const md = this.renderMarkdown(updated);
+            await writeFileUtil(join(this.decisionsPath, `${prefix}.md`), md);
+        }
+        return updated;
+    }
+    async supersede(oldId, newId) {
+        const oldResult = await this.show(oldId);
+        if (!oldResult)
+            return false;
+        const { decision: old } = oldResult;
+        const prefix = `${pad(oldId)}-${old.slug}`;
+        await writeFileUtil(join(this.decisionsPath, `${prefix}.metadata.json`), JSON.stringify({
+            id: old.id,
+            slug: old.slug,
+            title: old.title,
+            status: 'superseded',
+            date: old.date,
+            relatedTasks: old.relatedTasks ?? [],
+            supersededBy: newId,
+        }, null, 2));
+        return true;
+    }
+    async getForGenerator() {
+        const decisions = await this.list();
+        const active = decisions.filter((d) => d.status === 'accepted' || d.status === 'proposed');
+        if (active.length === 0)
+            return '';
+        const lines = [
+            '## Decision Records',
+            '',
+            'The following architectural decisions are active in this project:',
+            '',
+        ];
+        for (const d of active) {
+            const prefix = `${pad(d.id)}-${d.slug}`;
+            lines.push(`- **ADR-${pad(d.id)}: ${d.title}** (${d.status}) → [details](/.rulebook/decisions/${prefix}.md)`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+    renderMarkdown(d) {
+        const lines = [`# ${d.id}. ${d.title}`, '', `**Status**: ${d.status}`, `**Date**: ${d.date}`];
+        if (d.relatedTasks && d.relatedTasks.length > 0) {
+            lines.push(`**Related Tasks**: ${d.relatedTasks.join(', ')}`);
+        }
+        lines.push('', '## Context', '', d.context || '_No context provided._');
+        lines.push('', '## Decision', '', d.decision || '_No decision recorded._');
+        if (d.alternatives && d.alternatives.length > 0) {
+            lines.push('', '## Alternatives Considered', '');
+            for (const alt of d.alternatives) {
+                lines.push(`- ${alt}`);
+            }
+        }
+        lines.push('', '## Consequences', '', d.consequences || '_No consequences documented._');
+        lines.push('');
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=decision-manager.js.map

package/dist/core/tasks/decision-manager.js.map

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

package/dist/core/tasks/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/tasks/knowledge-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-manager.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/knowledge-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAiBvF,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/tasks/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/tasks/knowledge-manager.js.map

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

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

@@ -0,0 +1,27 @@
+import type { Learning, KnowledgeCategory } from '../../types.js';
+export declare class LearnManager {
+    private learningsPath;
+    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>;
+    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/tasks/learn-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn-manager.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/learn-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAalE,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAoB;IAOlE,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,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/tasks/learn-manager.js

@@ -0,0 +1,121 @@
+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;
+    decisionManager;
+    knowledgeManager;
+    constructor(projectRoot, rulebookDir = '.rulebook') {
+        const rbPath = join(projectRoot, rulebookDir);
+        this.learningsPath = join(rbPath, LEARNINGS_DIR);
+        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 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/tasks/learn-manager.js.map

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

package/dist/core/tasks/plans-manager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Plans Manager — PLANS.md Session Scratchpad
+ *
+ * Provides AI session continuity via a persistent scratchpad file.
+ * AI agents read PLANS.md at session start and update it during/after work.
+ */
+export interface PlansContent {
+    context: string;
+    currentTask: string;
+    history: string;
+    raw: string;
+}
+/**
+ * Get the path to PLANS.md inside the .rulebook directory.
+ */
+export declare function getPlansPath(projectRoot: string): string;
+/**
+ * Check if PLANS.md exists.
+ */
+export declare function plansExists(projectRoot: string): boolean;
+/**
+ * Read and parse PLANS.md sections.
+ * Returns null if file does not exist.
+ */
+export declare function readPlans(projectRoot: string): Promise<PlansContent | null>;
+/**
+ * Create PLANS.md from template if it does not exist.
+ */
+export declare function initPlans(projectRoot: string): Promise<boolean>;
+/**
+ * Update the Active Context section of PLANS.md.
+ */
+export declare function updatePlansContext(projectRoot: string, context: string): Promise<void>;
+/**
+ * Update the Current Task section of PLANS.md.
+ */
+export declare function updatePlansTask(projectRoot: string, task: string): Promise<void>;
+/**
+ * Append an entry to the Session History section of PLANS.md.
+ */
+export declare function appendPlansHistory(projectRoot: string, entry: string): Promise<void>;
+/**
+ * Reset PLANS.md to the template (clear context, task, and history).
+ */
+export declare function clearPlans(projectRoot: string): Promise<void>;
+//# sourceMappingURL=plans-manager.d.ts.map

package/dist/core/tasks/plans-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans-manager.d.ts","sourceRoot":"","sources":["../../../src/core/tasks/plans-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAcjF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUrE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5F;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnE"}