@planu/cli 1.1.2 → 1.3.0

package/dist/engine/e2e-test-generator.js

@@ -0,0 +1,210 @@
+// Planu — E2E Test Generator engine (SPEC-381)
+// Pure functions for generating E2E tests from spec acceptance criteria.
+import { readFile, readdir, mkdir, writeFile } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+/** Extract acceptance criteria from spec.md content (checkbox lines). */
+function extractAcceptanceCriteria(specContent) {
+    const lines = specContent.split('\n');
+    const criteria = [];
+    for (const line of lines) {
+        const match = /^\s*-\s*\[[ xX]?\]\s+(.+)$/.exec(line);
+        if (match?.[1]) {
+            criteria.push(match[1].trim());
+        }
+    }
+    return criteria;
+}
+/** Extract spec title from frontmatter or first H1. */
+function extractSpecTitle(specContent) {
+    const titleMatch = /^#\s+(.+)$/m.exec(specContent);
+    if (titleMatch?.[1]) {
+        return titleMatch[1].replace(/^SPEC-\d+[:\s-]+/i, '').trim();
+    }
+    const fmMatch = /^title:\s*(.+)$/m.exec(specContent);
+    return fmMatch?.[1]?.trim() ?? 'Spec';
+}
+/** Extract spec description from frontmatter or first paragraph. */
+function extractSpecDescription(specContent) {
+    const descMatch = /^description:\s*(.+)$/m.exec(specContent);
+    if (descMatch?.[1]) {
+        return descMatch[1].trim();
+    }
+    const lines = specContent.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed &&
+            !trimmed.startsWith('#') &&
+            !trimmed.startsWith('-') &&
+            !trimmed.startsWith('`')) {
+            return trimmed;
+        }
+    }
+    return '';
+}
+/** Generate Gherkin feature file content. */
+export function generateGherkin(title, description, criteria) {
+    const scenarios = criteria
+        .map((criterion) => `  Scenario: ${criterion}\n` +
+        `    Given the system is ready\n` +
+        `    When the user performs the action\n` +
+        `    Then ${criterion}`)
+        .join('\n\n');
+    const descLine = description ? `  ${description}\n\n` : '';
+    return `Feature: ${title}\n${descLine}${scenarios}\n`;
+}
+/** Generate Playwright TypeScript test content. */
+export function generatePlaywright(title, criteria) {
+    const tests = criteria
+        .map((criterion) => `  test('${criterion.replace(/'/g, "\\'")}', async ({ page }) => {\n` +
+        `    // TODO: implement test for: ${criterion}\n` +
+        `  });`)
+        .join('\n\n');
+    return (`import { test, expect } from '@playwright/test';\n\n` +
+        `test.describe('${title.replace(/'/g, "\\'")}', () => {\n` +
+        `${tests}\n` +
+        `});\n`);
+}
+/** Generate testRigor plain English steps. */
+export function generateTestRigor(title, criteria) {
+    const steps = criteria.map((criterion, i) => `${i + 1}. ${criterion}`).join('\n');
+    return `# ${title}\n\n${steps}\n`;
+}
+/** Generate plain numbered list. */
+export function generatePlain(criteria) {
+    return criteria.map((criterion, i) => `${i + 1}. Verify that ${criterion}`).join('\n') + '\n';
+}
+/** Get file extension for each framework. */
+export function getFrameworkExtension(framework) {
+    switch (framework) {
+        case 'gherkin':
+            return 'feature';
+        case 'playwright':
+            return 'spec.ts';
+        case 'testRigor':
+            return 'txt';
+        case 'plain':
+            return 'txt';
+    }
+}
+/** Derive default output path for tests. */
+function deriveDefaultOutputPath(specId, slug, framework) {
+    const ext = getFrameworkExtension(framework);
+    const fileName = `${specId}-${slug}.${ext}`;
+    return join('tests', 'e2e', fileName);
+}
+/** Extract slug from spec directory name. */
+function extractSlug(specDirName) {
+    return specDirName.replace(/^SPEC-\d+-?/i, '').toLowerCase() || 'spec';
+}
+/** Resolve spec directory from specId and projectPath. */
+async function resolveSpecDir(specId, projectPath) {
+    const specsBase = join(projectPath, 'planu', 'specs');
+    let entries;
+    try {
+        entries = await readdir(specsBase);
+    }
+    catch {
+        return null;
+    }
+    const upper = specId.toUpperCase();
+    const match = entries.find((e) => e.toUpperCase().startsWith(upper));
+    return match ? join(specsBase, match) : null;
+}
+/** Generate E2E tests from a spec. */
+export async function generateE2eTests(specId, projectPath, framework = 'gherkin', outputPath) {
+    const specDir = await resolveSpecDir(specId, projectPath);
+    if (!specDir) {
+        return { isError: true, message: `Spec ${specId} not found in ${projectPath}/planu/specs/` };
+    }
+    let specContent;
+    try {
+        specContent = await readFile(join(specDir, 'spec.md'), 'utf8');
+    }
+    catch {
+        return { isError: true, message: `Could not read spec.md for ${specId}` };
+    }
+    const criteria = extractAcceptanceCriteria(specContent);
+    const title = extractSpecTitle(specContent);
+    const description = extractSpecDescription(specContent);
+    let content;
+    switch (framework) {
+        case 'gherkin':
+            content = generateGherkin(title, description, criteria);
+            break;
+        case 'playwright':
+            content = generatePlaywright(title, criteria);
+            break;
+        case 'testRigor':
+            content = generateTestRigor(title, criteria);
+            break;
+        case 'plain':
+            content = generatePlain(criteria);
+            break;
+    }
+    const specDirName = specDir.split('/').pop() ?? specId;
+    const slug = extractSlug(specDirName);
+    const resolvedOutputPath = outputPath ?? deriveDefaultOutputPath(specId, slug, framework);
+    const absoluteOutputPath = resolvedOutputPath.startsWith('/')
+        ? resolvedOutputPath
+        : join(projectPath, resolvedOutputPath);
+    try {
+        const dir = absoluteOutputPath.substring(0, absoluteOutputPath.lastIndexOf('/'));
+        await mkdir(dir, { recursive: true });
+        await writeFile(absoluteOutputPath, content, 'utf8');
+    }
+    catch {
+        // If write fails, still return content without outputPath
+        return {
+            framework,
+            specId,
+            testCount: criteria.length,
+            content,
+            outputPath: null,
+        };
+    }
+    return {
+        framework,
+        specId,
+        testCount: criteria.length,
+        content,
+        outputPath: absoluteOutputPath,
+    };
+}
+/** List existing E2E test files matching SPEC-XXX pattern. */
+export async function getE2eTestStatus(projectPath) {
+    const e2eDir = join(projectPath, 'tests', 'e2e');
+    let files;
+    try {
+        files = await readdir(e2eDir);
+    }
+    catch {
+        return { testFiles: [], total: 0 };
+    }
+    const specPattern = /^(SPEC-\d+)/i;
+    const testFiles = [];
+    for (const file of files) {
+        const ext = extname(file);
+        const isTestFile = file.endsWith('.feature') || file.endsWith('.spec.ts') || file.endsWith('.test.ts');
+        if (!isTestFile) {
+            continue;
+        }
+        const match = specPattern.exec(file);
+        if (!match?.[1]) {
+            continue;
+        }
+        const specId = match[1].toUpperCase();
+        let framework;
+        if (file.endsWith('.feature')) {
+            framework = 'gherkin';
+        }
+        else if (ext === '.ts') {
+            framework = 'playwright';
+        }
+        else {
+            framework = 'unknown';
+        }
+        testFiles.push({ file, specId, framework });
+    }
+    return { testFiles, total: testFiles.length };
+}
+//# sourceMappingURL=e2e-test-generator.js.map

package/dist/engine/e2e-test-generator.js.map

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

package/dist/engine/ecosystem-detector.d.ts

@@ -0,0 +1,13 @@
+import type { TokenOptimizerStatus, TokenOptimizerRecommendation } from '../types/index.js';
+export declare function detectRtkHooks(projectPath: string): Promise<number>;
+export declare function detectHeadroomPackage(projectPath: string): Promise<{
+    installed: boolean;
+    version?: string;
+}>;
+export declare function detectRtkPackage(projectPath: string): Promise<{
+    installed: boolean;
+    version?: string;
+}>;
+export declare function getTokenOptimizerStatus(projectPath: string): Promise<TokenOptimizerStatus>;
+export declare function buildTokenOptimizerRecommendations(projectPath: string): Promise<TokenOptimizerRecommendation[]>;
+//# sourceMappingURL=ecosystem-detector.d.ts.map

package/dist/engine/ecosystem-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-detector.d.ts","sourceRoot":"","sources":["../../src/engine/ecosystem-detector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAG7B,MAAM,mBAAmB,CAAC;AAW3B,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUzE;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBnD;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBnD;AAED,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBhG;AAED,wBAAsB,kCAAkC,CACtD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAyDzC"}

package/dist/engine/ecosystem-detector.js

@@ -0,0 +1,128 @@
+// Planu — Ecosystem detector engine (SPEC-374)
+// Pure functions to detect token optimization tools (RTK, Headroom)
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+async function readJsonFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export async function detectRtkHooks(projectPath) {
+    const settingsPath = join(projectPath, '.claude', 'settings.json');
+    const settings = await readJsonFile(settingsPath);
+    if (!settings?.hooks?.PreToolUse) {
+        return 0;
+    }
+    return settings.hooks.PreToolUse.filter((hook) => {
+        const hooksArr = hook.hooks ?? [];
+        return hooksArr.some((h) => typeof h === 'string' && h.toLowerCase().includes('rtk'));
+    }).length;
+}
+export async function detectHeadroomPackage(projectPath) {
+    const pkgPath = join(projectPath, 'package.json');
+    const pkg = await readJsonFile(pkgPath);
+    if (!pkg) {
+        return { installed: false };
+    }
+    const allDeps = {
+        ...(pkg.devDependencies ?? {}),
+        ...(pkg.dependencies ?? {}),
+    };
+    const headroom = allDeps.headroom;
+    const headroomCli = allDeps['@headroom/cli'];
+    const version = headroom ?? headroomCli;
+    if (version !== undefined) {
+        return { installed: true, version };
+    }
+    return { installed: false };
+}
+export async function detectRtkPackage(projectPath) {
+    const pkgPath = join(projectPath, 'package.json');
+    const pkg = await readJsonFile(pkgPath);
+    if (!pkg) {
+        return { installed: false };
+    }
+    const allDeps = {
+        ...(pkg.devDependencies ?? {}),
+        ...(pkg.dependencies ?? {}),
+    };
+    const rtk = allDeps.rtk;
+    const rtkCli = allDeps['@rtk/cli'];
+    const version = rtk ?? rtkCli;
+    if (version !== undefined) {
+        return { installed: true, version };
+    }
+    return { installed: false };
+}
+export async function getTokenOptimizerStatus(projectPath) {
+    const [rtkPkg, headroomPkg, rtkHooks] = await Promise.all([
+        detectRtkPackage(projectPath),
+        detectHeadroomPackage(projectPath),
+        detectRtkHooks(projectPath),
+    ]);
+    return {
+        rtk: {
+            installed: rtkPkg.installed,
+            version: rtkPkg.version,
+            hooksConfigured: rtkHooks,
+        },
+        headroom: {
+            installed: headroomPkg.installed,
+            version: headroomPkg.version,
+        },
+    };
+}
+export async function buildTokenOptimizerRecommendations(projectPath) {
+    const status = await getTokenOptimizerStatus(projectPath);
+    const recommendations = [];
+    if (!status.rtk.installed) {
+        recommendations.push({
+            tool: 'rtk',
+            installed: false,
+            reason: 'RTK (Response Token Killer) filters verbose Claude output via PreToolUse hooks, reducing token usage by 30-60% on large codebases.',
+            installCommand: 'npm install --save-dev rtk',
+            configExample: JSON.stringify({
+                hooks: {
+                    PreToolUse: [
+                        {
+                            matcher: 'Bash',
+                            hooks: ['npx rtk filter'],
+                        },
+                    ],
+                },
+            }, null, 2),
+        });
+    }
+    else {
+        recommendations.push({
+            tool: 'rtk',
+            installed: true,
+            reason: `RTK is installed (${status.rtk.version ?? 'unknown version'}). ${status.rtk.hooksConfigured === 0
+                ? 'No PreToolUse hooks configured yet — add hooks to .claude/settings.json to activate filtering.'
+                : `${String(status.rtk.hooksConfigured)} PreToolUse hook(s) configured.`}`,
+            installCommand: 'npm install --save-dev rtk',
+        });
+    }
+    if (!status.headroom.installed) {
+        recommendations.push({
+            tool: 'headroom',
+            installed: false,
+            reason: 'Headroom monitors your context window usage in real-time and warns before you hit the limit, preventing lost work.',
+            installCommand: 'npm install --save-dev headroom',
+        });
+    }
+    else {
+        recommendations.push({
+            tool: 'headroom',
+            installed: true,
+            reason: `Headroom is installed (${status.headroom.version ?? 'unknown version'}).`,
+            installCommand: 'npm install --save-dev headroom',
+        });
+    }
+    return recommendations;
+}
+//# sourceMappingURL=ecosystem-detector.js.map

package/dist/engine/ecosystem-detector.js.map

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

package/dist/engine/global-rules-manager.d.ts

@@ -0,0 +1,10 @@
+import type { GlobalRule, GlobalRuleApplyResult, GlobalRulesSummary } from '../types/index.js';
+export declare function globalRulesDir(): string;
+export declare function createRule(slug: string, name: string, content: string, tags: string[], author?: string, version?: string): Promise<GlobalRule>;
+export declare function getRule(slug: string): Promise<GlobalRule | null>;
+export declare function updateRule(slug: string, updates: Partial<Pick<GlobalRule, 'name' | 'content' | 'tags' | 'version' | 'author'>>): Promise<GlobalRule | null>;
+export declare function deleteRule(slug: string): Promise<boolean>;
+export declare function listRules(): Promise<GlobalRulesSummary>;
+export declare function applyRule(slug: string, projectPath: string): Promise<GlobalRuleApplyResult>;
+export declare function exportRule(slug: string): Promise<string>;
+//# sourceMappingURL=global-rules-manager.d.ts.map

package/dist/engine/global-rules-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-rules-manager.d.ts","sourceRoot":"","sources":["../../src/engine/global-rules-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM/F,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAyED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,SAAU,GAChB,OAAO,CAAC,UAAU,CAAC,CAerB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAWtE;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,GACrF,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAa5B;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW/D;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAgC7D;AAMD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyCjG;AAMD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9D"}

package/dist/engine/global-rules-manager.js

@@ -0,0 +1,214 @@
+// engine/global-rules-manager.ts — Global Steering Rules manager (SPEC-351)
+import { readFile, writeFile, readdir, unlink, mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+export function globalRulesDir() {
+    return join(homedir(), '.planu', 'global-rules');
+}
+function ruleFile(slug) {
+    return join(globalRulesDir(), `${slug}.md`);
+}
+// ---------------------------------------------------------------------------
+// Frontmatter helpers
+// ---------------------------------------------------------------------------
+function buildFrontmatter(rule) {
+    const tagsStr = rule.tags.map((t) => `  - ${t}`).join('\n');
+    const authorLine = rule.author !== undefined ? `author: "${rule.author}"\n` : '';
+    return [
+        '---',
+        `name: "${rule.name}"`,
+        `tags:`,
+        tagsStr,
+        `version: "${rule.version}"`,
+        authorLine.trim(),
+        `createdAt: "${rule.createdAt}"`,
+        `updatedAt: "${rule.updatedAt}"`,
+        '---',
+        '',
+        rule.content,
+    ].join('\n');
+}
+function parseFrontmatter(raw, slug) {
+    const match = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/m.exec(raw);
+    if (match === null) {
+        return {
+            slug,
+            name: slug,
+            content: raw,
+            tags: [],
+            version: '1.0.0',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    const fm = match[1] ?? '';
+    const content = (match[2] ?? '').trim();
+    const nameMatch = /^name:\s*"?([^"\n]+)"?/m.exec(fm);
+    const versionMatch = /^version:\s*"?([^"\n]+)"?/m.exec(fm);
+    const authorMatch = /^author:\s*"?([^"\n]+)"?/m.exec(fm);
+    const createdMatch = /^createdAt:\s*"?([^"\n]+)"?/m.exec(fm);
+    const updatedMatch = /^updatedAt:\s*"?([^"\n]+)"?/m.exec(fm);
+    const tagMatches = [...fm.matchAll(/^\s{2}-\s+(.+)$/gm)].map((m) => m[1]?.trim() ?? '');
+    return {
+        slug,
+        name: nameMatch?.[1]?.trim() ?? slug,
+        content,
+        tags: tagMatches,
+        version: versionMatch?.[1]?.trim() ?? '1.0.0',
+        author: authorMatch?.[1]?.trim(),
+        createdAt: createdMatch?.[1]?.trim() ?? new Date().toISOString(),
+        updatedAt: updatedMatch?.[1]?.trim() ?? new Date().toISOString(),
+    };
+}
+// ---------------------------------------------------------------------------
+// CRUD operations
+// ---------------------------------------------------------------------------
+async function ensureRulesDir() {
+    await mkdir(globalRulesDir(), { recursive: true });
+}
+export async function createRule(slug, name, content, tags, author, version = '1.0.0') {
+    await ensureRulesDir();
+    const now = new Date().toISOString();
+    const rule = {
+        slug,
+        name,
+        content,
+        tags,
+        version,
+        author,
+        createdAt: now,
+        updatedAt: now,
+    };
+    await writeFile(ruleFile(slug), buildFrontmatter(rule), 'utf-8');
+    return rule;
+}
+export async function getRule(slug) {
+    try {
+        const raw = await readFile(ruleFile(slug), 'utf-8');
+        return parseFrontmatter(raw, slug);
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return null;
+        }
+        /* v8 ignore next */
+        throw err;
+    }
+}
+export async function updateRule(slug, updates) {
+    const existing = await getRule(slug);
+    if (existing === null) {
+        return null;
+    }
+    const updated = {
+        ...existing,
+        ...updates,
+        updatedAt: new Date().toISOString(),
+    };
+    await writeFile(ruleFile(slug), buildFrontmatter(updated), 'utf-8');
+    return updated;
+}
+export async function deleteRule(slug) {
+    try {
+        await unlink(ruleFile(slug));
+        return true;
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return false;
+        }
+        /* v8 ignore next */
+        throw err;
+    }
+}
+export async function listRules() {
+    await ensureRulesDir();
+    let entries;
+    try {
+        entries = await readdir(globalRulesDir());
+    }
+    catch {
+        /* v8 ignore next */
+        return { totalRules: 0, rules: [] };
+    }
+    const mdFiles = entries.filter((e) => e.endsWith('.md'));
+    const rules = await Promise.all(mdFiles.map(async (file) => {
+        const slug = file.replace(/\.md$/, '');
+        const rule = await getRule(slug);
+        return rule;
+    }));
+    const valid = rules.filter((r) => r !== null);
+    return {
+        totalRules: valid.length,
+        rules: valid.map(({ slug, name, tags, version, author, createdAt, updatedAt }) => ({
+            slug,
+            name,
+            tags,
+            version,
+            author,
+            createdAt,
+            updatedAt,
+        })),
+    };
+}
+// ---------------------------------------------------------------------------
+// Apply rule to project CLAUDE.md
+// ---------------------------------------------------------------------------
+export async function applyRule(slug, projectPath) {
+    const rule = await getRule(slug);
+    if (rule === null) {
+        throw new Error(`Rule "${slug}" not found. Use manage_global_rules with action "list" to see available rules.`);
+    }
+    const claudeMdPath = join(projectPath, 'CLAUDE.md');
+    let existing = '';
+    try {
+        existing = await readFile(claudeMdPath, 'utf-8');
+    }
+    catch {
+        // File doesn't exist yet — will create it
+    }
+    const sectionHeader = `## Applied Global Rules\n### ${rule.name}\n`;
+    const section = `\n\n${sectionHeader}${rule.content}`;
+    let updated;
+    if (existing.includes(`### ${rule.name}`)) {
+        // Replace existing section
+        const pattern = new RegExp(`### ${escapeRegex(rule.name)}[\\s\\S]*?(?=\n### |$)`, 'g');
+        updated = existing.replace(pattern, `### ${rule.name}\n${rule.content}`);
+    }
+    else if (existing.includes('## Applied Global Rules')) {
+        // Append to existing Applied section
+        updated = existing + `\n### ${rule.name}\n${rule.content}`;
+    }
+    else {
+        updated = existing + section;
+    }
+    await mkdir(dirname(claudeMdPath), { recursive: true });
+    await writeFile(claudeMdPath, updated, 'utf-8');
+    return {
+        slug,
+        name: rule.name,
+        appliedTo: claudeMdPath,
+        section: sectionHeader,
+        appliedAt: new Date().toISOString(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Export
+// ---------------------------------------------------------------------------
+export async function exportRule(slug) {
+    const rule = await getRule(slug);
+    if (rule === null) {
+        throw new Error(`Rule "${slug}" not found.`);
+    }
+    return buildFrontmatter(rule);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=global-rules-manager.js.map

package/dist/engine/global-rules-manager.js.map

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

package/dist/engine/knowledge-base.d.ts

@@ -0,0 +1,12 @@
+import type { Decision, Lesson, Spec, ScoredDecision, ScoredSpec, ExtractedLesson, KnowledgeGap, KnowledgeSummary } from '../types/index.js';
+/** Search decisions by relevance to a query string. */
+export declare function searchDecisions(decisions: Decision[], query: string, limit?: number): ScoredDecision[];
+/** Find specs with similar keywords in title and description. */
+export declare function findSimilarProblems(specs: Spec[], query: string, limit?: number): ScoredSpec[];
+/** Extract lesson-like phrases from free-form text (retrospective, post-mortem). */
+export declare function extractLessonsFromText(text: string): ExtractedLesson[];
+/** Detect specs without decisions and lesson category gaps. */
+export declare function detectKnowledgeGaps(specs: Spec[], decisions: Decision[], lessons: Lesson[]): KnowledgeGap[];
+/** Snapshot of project knowledge. */
+export declare function buildKnowledgeSummary(specs: Spec[], decisions: Decision[], lessons: Lesson[]): KnowledgeSummary;
+//# sourceMappingURL=knowledge-base.d.ts.map

package/dist/engine/knowledge-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-base.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge-base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,cAAc,EACd,UAAU,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAwF3B,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,cAAc,EAAE,CAiCjG;AAMD,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,UAAU,EAAE,CA2BzF;AAwBD,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAqBtE;AAWD,+DAA+D;AAC/D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,MAAM,EAAE,GAChB,YAAY,EAAE,CA2ChB;AAMD,qCAAqC;AACrC,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,MAAM,EAAE,GAChB,gBAAgB,CA0BlB"}