@hivehub/rulebook 5.7.0 → 5.8.0

package/dist/core/multi-tool-generator.js

@@ -1,157 +0,0 @@
-/**
- * Multi-Tool Config Generator
- *
- * Generates IDE/AI-tool configuration files for detected tools:
- * - GEMINI.md for Gemini CLI
- * - .continue/rules/RULEBOOK.md for Continue.dev
- * - .windsurfrules for Windsurf IDE
- * - .github/copilot-instructions.md for GitHub Copilot
- *
- * Each generator is idempotent: if the file already contains the
- * RULEBOOK marker it gets updated; if it exists without the marker
- * (user-owned file) it is skipped.
- */
-import path from 'path';
-import { existsSync } from 'fs';
-import { readFile, writeFile, mkdir } from 'fs/promises';
-import { fileURLToPath } from 'url';
-import { dirname } from 'path';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-/** Marker used to identify rulebook-managed content in generated files. */
-const RULEBOOK_MARKER = '<!-- RULEBOOK:START -->';
-/**
- * Resolve the templates/ides/ directory relative to the compiled dist/ output.
- * Uses the same __dirname strategy as cursor-mdc-generator.ts.
- */
-function getTemplatesDir() {
-    return path.join(__dirname, '..', '..', 'templates', 'ides');
-}
-/**
- * Read a template file from templates/ides/.
- * Returns the template content or null if the template does not exist.
- */
-async function readTemplate(templateName) {
-    const templatePath = path.join(getTemplatesDir(), templateName);
-    if (!existsSync(templatePath)) {
-        return null;
-    }
-    return readFile(templatePath, 'utf-8');
-}
-/**
- * Write content to a destination file following the idempotent pattern:
- * - If the file does not exist, create it with the template content.
- * - If the file exists and contains the RULEBOOK marker, update it.
- * - If the file exists without the marker (user-owned), skip and return null.
- *
- * Returns the absolute path written, or null if skipped.
- */
-async function writeIdempotent(destPath, content) {
-    if (existsSync(destPath)) {
-        const existing = await readFile(destPath, 'utf-8');
-        if (!existing.includes(RULEBOOK_MARKER)) {
-            // User-owned file — do not overwrite
-            return null;
-        }
-    }
-    // Ensure the parent directory exists
-    const parentDir = path.dirname(destPath);
-    if (!existsSync(parentDir)) {
-        await mkdir(parentDir, { recursive: true });
-    }
-    await writeFile(destPath, content, 'utf-8');
-    return destPath;
-}
-/**
- * Generate GEMINI.md in the project root for Gemini CLI.
- *
- * @param projectRoot - Absolute path to the project root.
- * @returns The path written, or null if skipped.
- */
-export async function generateGeminiMd(projectRoot) {
-    const template = await readTemplate('GEMINI_RULES.md');
-    if (!template) {
-        return null;
-    }
-    const destPath = path.join(projectRoot, 'GEMINI.md');
-    return writeIdempotent(destPath, template);
-}
-/**
- * Generate .continue/rules/RULEBOOK.md for the Continue.dev IDE extension.
- *
- * @param projectRoot - Absolute path to the project root.
- * @returns The path written, or null if skipped.
- */
-export async function generateContinueRules(projectRoot) {
-    const template = await readTemplate('CONTINUE_RULES.md');
-    if (!template) {
-        return null;
-    }
-    const destPath = path.join(projectRoot, '.continue', 'rules', 'RULEBOOK.md');
-    return writeIdempotent(destPath, template);
-}
-/**
- * Generate .windsurfrules in the project root for Windsurf IDE.
- *
- * @param projectRoot - Absolute path to the project root.
- * @returns The path written, or null if skipped.
- */
-export async function generateWindsurfRules(projectRoot) {
-    const template = await readTemplate('WINDSURF_RULES.md');
-    if (!template) {
-        return null;
-    }
-    const destPath = path.join(projectRoot, '.windsurfrules');
-    return writeIdempotent(destPath, template);
-}
-/**
- * Generate .github/copilot-instructions.md for GitHub Copilot.
- *
- * @param projectRoot - Absolute path to the project root.
- * @returns The path written, or null if skipped.
- */
-export async function generateCopilotInstructions(projectRoot) {
-    const template = await readTemplate('COPILOT_INSTRUCTIONS.md');
-    if (!template) {
-        return null;
-    }
-    const destPath = path.join(projectRoot, '.github', 'copilot-instructions.md');
-    return writeIdempotent(destPath, template);
-}
-/**
- * Generate configuration files for all detected AI tools.
- * Only generates files for tools that are actually detected in the project.
- *
- * @param projectRoot - Absolute path to the project root.
- * @param detection - The project detection result containing tool detection flags.
- * @returns An object with paths of all generated files (undefined for skipped tools).
- */
-export async function generateMultiToolConfigs(projectRoot, detection) {
-    const result = {};
-    if (detection.geminiCli?.detected) {
-        const written = await generateGeminiMd(projectRoot);
-        if (written) {
-            result.geminiMd = written;
-        }
-    }
-    if (detection.continueDev?.detected) {
-        const written = await generateContinueRules(projectRoot);
-        if (written) {
-            result.continueRules = written;
-        }
-    }
-    if (detection.windsurf?.detected) {
-        const written = await generateWindsurfRules(projectRoot);
-        if (written) {
-            result.windsurfRules = written;
-        }
-    }
-    if (detection.githubCopilot?.detected) {
-        const written = await generateCopilotInstructions(projectRoot);
-        if (written) {
-            result.copilotInstructions = written;
-        }
-    }
-    return result;
-}
-//# sourceMappingURL=multi-tool-generator.js.map

package/dist/core/multi-tool-generator.js.map

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

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

@@ -1,23 +0,0 @@
-/**
- * Get path to AGENTS.override.md in the project root.
- */
-export declare function getOverridePath(projectRoot: string): string;
-/**
- * Check if AGENTS.override.md exists.
- */
-export declare function overrideExists(projectRoot: string): boolean;
-/**
- * Read override content, stripping OVERRIDE:START/END markers.
- * Returns empty string if file does not exist or has no custom content.
- */
-export declare function readOverrideContent(projectRoot: string): Promise<string>;
-/**
- * Create AGENTS.override.md from template if it does not already exist.
- * Returns true if file was created, false if it already existed.
- */
-export declare function initOverride(projectRoot: string): Promise<boolean>;
-/**
- * Clear AGENTS.override.md back to the empty template.
- */
-export declare function clearOverride(projectRoot: string): Promise<void>;
-//# sourceMappingURL=override-manager.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"override-manager.d.ts","sourceRoot":"","sources":["../../src/core/override-manager.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB9E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BxE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYtE"}

package/dist/core/override-manager.js

@@ -1,82 +0,0 @@
-import { existsSync } from 'fs';
-import { readFile, writeFile } from 'fs/promises';
-import path from 'path';
-import { fileExists } from '../utils/file-system.js';
-const OVERRIDE_FILE = 'AGENTS.override.md';
-/**
- * Get path to AGENTS.override.md in the project root.
- */
-export function getOverridePath(projectRoot) {
-    return path.join(projectRoot, OVERRIDE_FILE);
-}
-/**
- * Check if AGENTS.override.md exists.
- */
-export function overrideExists(projectRoot) {
-    return existsSync(getOverridePath(projectRoot));
-}
-/**
- * Read override content, stripping OVERRIDE:START/END markers.
- * Returns empty string if file does not exist or has no custom content.
- */
-export async function readOverrideContent(projectRoot) {
-    const overridePath = getOverridePath(projectRoot);
-    if (!existsSync(overridePath))
-        return '';
-    const raw = await readFile(overridePath, 'utf-8');
-    // Strip marker comments — return only actual content between them
-    const match = raw.match(/<!-- OVERRIDE:START -->([\s\S]*?)<!-- OVERRIDE:END -->/);
-    if (!match)
-        return raw.trim();
-    const content = match[1].trim();
-    // If it still contains only the template placeholder text, treat as empty
-    if (content.includes('This file contains project-specific directives') &&
-        !content.split('\n').some((line) => line.startsWith('- ') && !line.includes('**Example'))) {
-        return '';
-    }
-    return content;
-}
-/**
- * Create AGENTS.override.md from template if it does not already exist.
- * Returns true if file was created, false if it already existed.
- */
-export async function initOverride(projectRoot) {
-    const overridePath = getOverridePath(projectRoot);
-    if (existsSync(overridePath))
-        return false;
-    const templatePath = path.join(path.dirname(path.dirname(new URL(import.meta.url).pathname)), 'templates', 'core', 'AGENTS_OVERRIDE.md');
-    let templateContent = '';
-    if (await fileExists(templatePath)) {
-        templateContent = await readFile(templatePath, 'utf-8');
-    }
-    else {
-        templateContent = [
-            '<!-- OVERRIDE:START -->',
-            '# Project-Specific Overrides',
-            '',
-            'Add your custom rules and team conventions here.',
-            'This file is never overwritten by `rulebook init` or `rulebook update`.',
-            '<!-- OVERRIDE:END -->',
-            '',
-        ].join('\n');
-    }
-    await writeFile(overridePath, templateContent);
-    return true;
-}
-/**
- * Clear AGENTS.override.md back to the empty template.
- */
-export async function clearOverride(projectRoot) {
-    const overridePath = getOverridePath(projectRoot);
-    const emptyContent = [
-        '<!-- OVERRIDE:START -->',
-        '# Project-Specific Overrides',
-        '',
-        'Add your custom rules and team conventions here.',
-        'This file is never overwritten by `rulebook init` or `rulebook update`.',
-        '<!-- OVERRIDE:END -->',
-        '',
-    ].join('\n');
-    await writeFile(overridePath, emptyContent);
-}
-//# sourceMappingURL=override-manager.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"override-manager.js","sourceRoot":"","sources":["../../src/core/override-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAE3C;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,OAAO,UAAU,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAElD,kEAAkE;IAClE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAClF,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IAE9B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhC,0EAA0E;IAC1E,IACE,OAAO,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAClE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EACzF,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAE3C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAC7D,WAAW,EACX,MAAM,EACN,oBAAoB,CACrB,CAAC;IAEF,IAAI,eAAe,GAAG,EAAE,CAAC;IACzB,IAAI,MAAM,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,eAAe,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,eAAe,GAAG;YAChB,yBAAyB;YACzB,8BAA8B;YAC9B,EAAE;YACF,kDAAkD;YAClD,yEAAyE;YACzE,uBAAuB;YACvB,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,SAAS,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG;QACnB,yBAAyB;QACzB,8BAA8B;QAC9B,EAAE;QACF,kDAAkD;QAClD,yEAAyE;QACzE,uBAAuB;QACvB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAC9C,CAAC"}

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

@@ -1,46 +0,0 @@
-/**
- * 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/plans-manager.d.ts.map

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

package/dist/core/plans-manager.js

@@ -1,158 +0,0 @@
-/**
- * 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.
- */
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { existsSync } from 'fs';
-import { readFile, writeFile, mkdir } from 'fs/promises';
-const PLANS_FILE = 'PLANS.md';
-const CONTEXT_START = '<!-- PLANS:CONTEXT:START -->';
-const CONTEXT_END = '<!-- PLANS:CONTEXT:END -->';
-const TASK_START = '<!-- PLANS:TASK:START -->';
-const TASK_END = '<!-- PLANS:TASK:END -->';
-const HISTORY_START = '<!-- PLANS:HISTORY:START -->';
-const HISTORY_END = '<!-- PLANS:HISTORY:END -->';
-/**
- * Get the path to PLANS.md inside the .rulebook directory.
- */
-export function getPlansPath(projectRoot) {
-    return join(projectRoot, '.rulebook', PLANS_FILE);
-}
-/**
- * Check if PLANS.md exists.
- */
-export function plansExists(projectRoot) {
-    return existsSync(getPlansPath(projectRoot));
-}
-/**
- * Read and parse PLANS.md sections.
- * Returns null if file does not exist.
- */
-export async function readPlans(projectRoot) {
-    const plansPath = getPlansPath(projectRoot);
-    if (!existsSync(plansPath)) {
-        return null;
-    }
-    const raw = await readFile(plansPath, 'utf-8');
-    return {
-        context: extractSection(raw, CONTEXT_START, CONTEXT_END),
-        currentTask: extractSection(raw, TASK_START, TASK_END),
-        history: extractSection(raw, HISTORY_START, HISTORY_END),
-        raw,
-    };
-}
-/**
- * Create PLANS.md from template if it does not exist.
- */
-export async function initPlans(projectRoot) {
-    const plansPath = getPlansPath(projectRoot);
-    if (existsSync(plansPath)) {
-        return false; // Already exists
-    }
-    await mkdir(join(projectRoot, '.rulebook'), { recursive: true });
-    const template = await loadTemplate();
-    await writeFile(plansPath, template, 'utf-8');
-    return true;
-}
-/**
- * Update the Active Context section of PLANS.md.
- */
-export async function updatePlansContext(projectRoot, context) {
-    const plansPath = getPlansPath(projectRoot);
-    await mkdir(join(projectRoot, '.rulebook'), { recursive: true });
-    let content = existsSync(plansPath) ? await readFile(plansPath, 'utf-8') : await loadTemplate();
-    content = replaceSection(content, CONTEXT_START, CONTEXT_END, context);
-    await writeFile(plansPath, content, 'utf-8');
-}
-/**
- * Update the Current Task section of PLANS.md.
- */
-export async function updatePlansTask(projectRoot, task) {
-    const plansPath = getPlansPath(projectRoot);
-    await mkdir(join(projectRoot, '.rulebook'), { recursive: true });
-    let content = existsSync(plansPath) ? await readFile(plansPath, 'utf-8') : await loadTemplate();
-    content = replaceSection(content, TASK_START, TASK_END, task);
-    await writeFile(plansPath, content, 'utf-8');
-}
-/**
- * Append an entry to the Session History section of PLANS.md.
- */
-export async function appendPlansHistory(projectRoot, entry) {
-    const plansPath = getPlansPath(projectRoot);
-    await mkdir(join(projectRoot, '.rulebook'), { recursive: true });
-    let content = existsSync(plansPath) ? await readFile(plansPath, 'utf-8') : await loadTemplate();
-    const existing = extractSection(content, HISTORY_START, HISTORY_END);
-    const timestamp = new Date().toISOString().replace('T', ' ').substring(0, 16);
-    const newEntry = `\n### ${timestamp}\n${entry}`;
-    const updated = existing.trim() ? existing + '\n' + newEntry : newEntry;
-    content = replaceSection(content, HISTORY_START, HISTORY_END, updated);
-    await writeFile(plansPath, content, 'utf-8');
-}
-/**
- * Reset PLANS.md to the template (clear context, task, and history).
- */
-export async function clearPlans(projectRoot) {
-    const plansPath = getPlansPath(projectRoot);
-    const template = await loadTemplate();
-    await mkdir(join(projectRoot, '.rulebook'), { recursive: true });
-    await writeFile(plansPath, template, 'utf-8');
-}
-// ─── Helpers ───────────────────────────────────────────────────────────────
-function extractSection(content, startMarker, endMarker) {
-    const startIdx = content.indexOf(startMarker);
-    const endIdx = content.indexOf(endMarker);
-    if (startIdx === -1 || endIdx === -1)
-        return '';
-    return content.slice(startIdx + startMarker.length, endIdx).trim();
-}
-function replaceSection(content, startMarker, endMarker, newValue) {
-    const startIdx = content.indexOf(startMarker);
-    const endIdx = content.indexOf(endMarker);
-    if (startIdx === -1 || endIdx === -1)
-        return content;
-    const before = content.slice(0, startIdx + startMarker.length);
-    const after = content.slice(endIdx);
-    return `${before}\n${newValue}\n${after}`;
-}
-async function loadTemplate() {
-    // Try to load from bundled templates
-    try {
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = dirname(__filename);
-        const templatePath = join(__dirname, '..', '..', 'templates', 'core', 'PLANS.md');
-        if (existsSync(templatePath)) {
-            return readFile(templatePath, 'utf-8');
-        }
-    }
-    catch {
-        // Fall through to inline template
-    }
-    // Inline fallback template
-    return `<!-- PLANS:START -->
-# Project Plans & Session Context
-
-This file is a **persistent session scratchpad** maintained by AI agents.
-It provides continuity across sessions without relying on conversation history.
-
-## Active Context
-
-<!-- PLANS:CONTEXT:START -->
-_No active context. Start a session to populate this section._
-<!-- PLANS:CONTEXT:END -->
-
-## Current Task
-
-<!-- PLANS:TASK:START -->
-_No task in progress._
-<!-- PLANS:TASK:END -->
-
-## Session History
-
-<!-- PLANS:HISTORY:START -->
-<!-- PLANS:HISTORY:END -->
-`;
-}
-//# sourceMappingURL=plans-manager.js.map

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

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

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"}