@hivehub/rulebook 3.4.2 → 4.0.0

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

@@ -0,0 +1,157 @@
+/**
+ * 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

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

@@ -0,0 +1,23 @@
+/**
+ * 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

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

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

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

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

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

@@ -0,0 +1,158 @@
+/**
+ * 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

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

@@ -20,6 +20,18 @@ export declare class PRDGenerator {
      * 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
      */

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

@@ -1 +1 @@
-{"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;IAkBpC;;OAEG;YACW,kBAAkB;IA0BhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAY3B"}
+{"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;IA0BpC;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;YACW,aAAa;IA6B3B;;OAEG;YACW,kBAAkB;IA0BhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAY3B"}

package/dist/core/prd-generator.js

@@ -77,17 +77,106 @@ export class PRDGenerator {
         const title = this.extractTitle(task.proposal);
         const description = this.extractDescription(task.proposal);
         const tasksChecklist = await this.loadTasksChecklist(task.path);
+        const specCriteria = await this.loadSpecCriteria(task.path);
+        // Merge checklist items with SHALL/MUST requirements from specs
+        const allCriteria = [...tasksChecklist, ...specCriteria];
+        // Build notes: include spec file references for traceability
+        const specSources = await this.listSpecFiles(task.path);
+        const notes = specSources.length > 0 ? `Spec files: ${specSources.join(', ')}` : '';
         return {
             id: `US-${String(priority).padStart(3, '0')}`,
             title: title || task.id,
             description: description || 'Task extracted from rulebook proposal',
-            acceptanceCriteria: tasksChecklist.length > 0 ? tasksChecklist.slice(0, 10) : ['Implementation complete'],
+            acceptanceCriteria: allCriteria.length > 0 ? allCriteria.slice(0, 15) : ['Implementation complete'],
             priority,
             passes: false,
-            notes: '',
+            notes,
             sourceTaskId: task.id,
         };
     }
+    /**
+     * Load SHALL/MUST requirements from specs/*.md files as acceptance criteria.
+     */
+    async loadSpecCriteria(taskPath) {
+        const specsDir = path.join(taskPath, 'specs');
+        if (!existsSync(specsDir)) {
+            return [];
+        }
+        const criteria = [];
+        try {
+            const entries = await readdir(specsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const entryPath = path.join(specsDir, entry.name);
+                if (entry.isDirectory()) {
+                    // Recurse one level: specs/<module>/spec.md
+                    const subEntries = await readdir(entryPath, { withFileTypes: true });
+                    for (const sub of subEntries) {
+                        if (sub.isFile() && sub.name.endsWith('.md')) {
+                            const content = await readFile(path.join(entryPath, sub.name), 'utf-8');
+                            this.extractShallMust(content, criteria);
+                        }
+                    }
+                }
+                else if (entry.isFile() && entry.name.endsWith('.md')) {
+                    const content = await readFile(entryPath, 'utf-8');
+                    this.extractShallMust(content, criteria);
+                }
+            }
+        }
+        catch (err) {
+            this.logger.warn(`Failed to read spec files for task at ${taskPath}: ${err}`);
+        }
+        return criteria;
+    }
+    /**
+     * Extract SHALL/MUST statements from spec content as acceptance criteria.
+     */
+    extractShallMust(content, criteria) {
+        const lines = content.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Match lines with SHALL or MUST (requirement language)
+            if (/\b(SHALL|MUST)\b/.test(trimmed) && trimmed.length > 10 && trimmed.length < 300) {
+                // Clean up markdown: remove leading dashes, asterisks, backtick code
+                const cleaned = trimmed.replace(/^[-*]\s+/, '').replace(/`[^`]+`/g, (m) => m.slice(1, -1));
+                if (!criteria.includes(cleaned)) {
+                    criteria.push(cleaned);
+                }
+            }
+        }
+    }
+    /**
+     * List relative paths of spec files for notes/traceability.
+     */
+    async listSpecFiles(taskPath) {
+        const specsDir = path.join(taskPath, 'specs');
+        if (!existsSync(specsDir)) {
+            return [];
+        }
+        const files = [];
+        try {
+            const entries = await readdir(specsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const subEntries = await readdir(path.join(specsDir, entry.name), {
+                        withFileTypes: true,
+                    });
+                    for (const sub of subEntries) {
+                        if (sub.isFile() && sub.name.endsWith('.md')) {
+                            files.push(`specs/${entry.name}/${sub.name}`);
+                        }
+                    }
+                }
+                else if (entry.isFile() && entry.name.endsWith('.md')) {
+                    files.push(`specs/${entry.name}`);
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+        return files;
+    }
     /**
      * Load tasks checklist from tasks.md
      */