@hivehub/rulebook 5.7.0 → 5.8.0

package/dist/core/review-manager.js

@@ -1,371 +0,0 @@
-import { exec } from 'child_process';
-import { promisify } from 'util';
-import chalk from 'chalk';
-import { fileExists, readFile } from '../utils/file-system.js';
-import path from 'path';
-const execAsync = promisify(exec);
-/** Maximum diff length sent to the AI tool to avoid token limits. */
-const MAX_DIFF_LENGTH = 10_000;
-/** Maximum length of AGENTS.md context included in the prompt. */
-const MAX_AGENTS_CONTEXT_LENGTH = 2_000;
-// ─── Diff retrieval ─────────────────────────────────────────────────────────
-/**
- * Retrieve the git diff between the current HEAD and a base branch.
- *
- * Returns an empty string when:
- * - The working directory is not a git repo.
- * - There is no diff between the branches.
- * - An error occurs during execution.
- *
- * The returned string is truncated to {@link MAX_DIFF_LENGTH} characters.
- */
-export async function getDiffContext(projectRoot, baseBranch = 'main') {
-    try {
-        const [statResult, diffResult] = await Promise.all([
-            execAsync(`git diff ${baseBranch}...HEAD --stat`, {
-                cwd: projectRoot,
-                timeout: 15_000,
-            }).catch(() => ({ stdout: '' })),
-            execAsync(`git diff ${baseBranch}...HEAD`, {
-                cwd: projectRoot,
-                timeout: 15_000,
-            }).catch(() => ({ stdout: '' })),
-        ]);
-        const stat = (statResult.stdout ?? '').trim();
-        const diff = (diffResult.stdout ?? '').trim();
-        if (!stat && !diff) {
-            return '';
-        }
-        const combined = `${stat}\n\n${diff}`;
-        if (combined.length > MAX_DIFF_LENGTH) {
-            return combined.slice(0, MAX_DIFF_LENGTH) + '\n\n[... diff truncated]';
-        }
-        return combined;
-    }
-    catch {
-        return '';
-    }
-}
-// ─── Prompt construction ────────────────────────────────────────────────────
-/**
- * Build a structured review prompt suitable for an AI code reviewer.
- */
-export function buildReviewPrompt(diff, context) {
-    const projectLine = context.projectName
-        ? `Project: ${context.projectName}`
-        : 'Project: (unknown)';
-    const guidelinesBlock = context.agentsMdContent
-        ? context.agentsMdContent.slice(0, MAX_AGENTS_CONTEXT_LENGTH)
-        : '(no project guidelines available)';
-    return [
-        'You are a code reviewer. Review the following git diff for issues.',
-        '',
-        projectLine,
-        '',
-        'Guidelines:',
-        guidelinesBlock,
-        '',
-        'Git Diff:',
-        diff,
-        '',
-        'Provide your review in this exact format:',
-        '',
-        '## Summary',
-        '<one paragraph summary>',
-        '',
-        '## Issues',
-        'For each issue, use this format:',
-        '- [CRITICAL|MAJOR|MINOR|SUGGESTION] <file>:<line> — <message>',
-        '',
-        '## Suggestions',
-        '- <suggestion 1>',
-        '- <suggestion 2>',
-    ].join('\n');
-}
-// ─── Output parsing ─────────────────────────────────────────────────────────
-const SEVERITY_MAP = {
-    CRITICAL: 'critical',
-    MAJOR: 'major',
-    MINOR: 'minor',
-    SUGGESTION: 'suggestion',
-};
-/**
- * Parse the raw AI output into a structured {@link ReviewResult}.
- *
- * Handles missing sections gracefully — every field has a sensible default.
- */
-export function parseReviewOutput(output) {
-    const summary = extractSection(output, 'Summary');
-    const issuesRaw = extractSection(output, 'Issues');
-    const suggestionsRaw = extractSection(output, 'Suggestions');
-    const issues = parseIssues(issuesRaw);
-    const suggestions = parseBulletList(suggestionsRaw);
-    const approved = !issues.some((i) => i.severity === 'critical' || i.severity === 'major');
-    return { summary, issues, suggestions, approved };
-}
-/**
- * Extract the text content under a `## <heading>` section.
- *
- * Returns everything between the given heading and either the next `##` heading
- * or the end of the string.
- */
-function extractSection(text, heading) {
-    const pattern = new RegExp(`##\\s+${heading}\\s*\\n([\\s\\S]*?)(?=\\n##\\s|$)`, 'i');
-    const match = pattern.exec(text);
-    return match ? match[1].trim() : '';
-}
-/**
- * Parse issue lines from the Issues section.
- *
- * Expected line format:
- *   `- [SEVERITY] file.ts:42 — Some message`
- * or
- *   `- [SEVERITY] Some message without file reference`
- */
-function parseIssues(raw) {
-    if (!raw)
-        return [];
-    const issues = [];
-    const lines = raw.split('\n');
-    const issuePattern = /^[-*]\s*\[(CRITICAL|MAJOR|MINOR|SUGGESTION)]\s*(.*)/i;
-    for (const line of lines) {
-        const match = issuePattern.exec(line.trim());
-        if (!match)
-            continue;
-        const severity = SEVERITY_MAP[match[1].toUpperCase()];
-        if (!severity)
-            continue;
-        const rest = match[2].trim();
-        const issue = { severity, message: rest };
-        // Try to extract file:line — pattern:  filename.ext:123 — message
-        const fileLinePattern = /^(\S+?):(\d+)\s*[—-]\s*(.*)/;
-        const fileLineMatch = fileLinePattern.exec(rest);
-        if (fileLineMatch) {
-            issue.file = fileLineMatch[1];
-            issue.line = parseInt(fileLineMatch[2], 10);
-            issue.message = fileLineMatch[3].trim();
-        }
-        else {
-            // Try file without line number — filename.ext — message
-            const fileOnlyPattern = /^(\S+?\.\w+)\s*[—-]\s*(.*)/;
-            const fileOnlyMatch = fileOnlyPattern.exec(rest);
-            if (fileOnlyMatch) {
-                issue.file = fileOnlyMatch[1];
-                issue.message = fileOnlyMatch[2].trim();
-            }
-        }
-        issues.push(issue);
-    }
-    return issues;
-}
-/**
- * Parse a markdown bullet list into an array of strings.
- */
-function parseBulletList(raw) {
-    if (!raw)
-        return [];
-    return raw
-        .split('\n')
-        .map((line) => line.replace(/^[-*]\s*/, '').trim())
-        .filter((line) => line.length > 0);
-}
-// ─── AI tool execution ──────────────────────────────────────────────────────
-/**
- * Run the specified AI CLI tool with the given prompt.
- *
- * Returns the tool's stdout. On any error (timeout, missing tool, etc.)
- * returns an empty string.
- */
-export async function runAIReview(prompt, tool = 'claude') {
-    const commands = {
-        claude: 'claude',
-        gemini: 'gemini',
-        amp: 'amp',
-    };
-    const binary = commands[tool];
-    const flag = tool === 'gemini' ? '' : '-p';
-    // Build the command — pipe prompt via stdin for safety (avoids shell escaping)
-    const escapedPrompt = prompt.replace(/'/g, "'\\''");
-    const command = flag
-        ? `echo '${escapedPrompt}' | ${binary} ${flag} -`
-        : `${binary} '${escapedPrompt}'`;
-    try {
-        const { stdout } = await execAsync(command, { timeout: 60_000 });
-        return stdout.trim();
-    }
-    catch {
-        return '';
-    }
-}
-// ─── Terminal formatting ────────────────────────────────────────────────────
-const SEVERITY_COLORS = {
-    critical: chalk.red,
-    major: chalk.yellow,
-    minor: chalk.blue,
-    suggestion: chalk.gray,
-};
-const SEVERITY_LABELS = {
-    critical: 'CRITICAL',
-    major: 'MAJOR',
-    minor: 'MINOR',
-    suggestion: 'SUGGESTION',
-};
-/**
- * Format a {@link ReviewResult} as a chalk-colored terminal string.
- */
-export function formatReviewTerminal(result) {
-    const lines = [];
-    // Header
-    if (result.approved) {
-        lines.push(chalk.green.bold('\n  Review Result: APPROVED'));
-    }
-    else {
-        lines.push(chalk.red.bold('\n  Review Result: REJECTED'));
-    }
-    // Issue counts
-    const counts = countBySeverity(result.issues);
-    const countLine = [
-        counts.critical > 0 ? chalk.red(`${counts.critical} critical`) : null,
-        counts.major > 0 ? chalk.yellow(`${counts.major} major`) : null,
-        counts.minor > 0 ? chalk.blue(`${counts.minor} minor`) : null,
-        counts.suggestion > 0 ? chalk.gray(`${counts.suggestion} suggestion`) : null,
-    ]
-        .filter(Boolean)
-        .join(', ');
-    if (countLine) {
-        lines.push(`  Issues: ${countLine}`);
-    }
-    else {
-        lines.push(chalk.green('  No issues found'));
-    }
-    lines.push('');
-    // Summary
-    if (result.summary) {
-        lines.push(chalk.bold('  Summary'));
-        lines.push(`  ${result.summary}`);
-        lines.push('');
-    }
-    // Issues
-    if (result.issues.length > 0) {
-        lines.push(chalk.bold('  Issues'));
-        for (const issue of result.issues) {
-            const colorFn = SEVERITY_COLORS[issue.severity];
-            const label = SEVERITY_LABELS[issue.severity];
-            const location = issue.file ? (issue.line ? `${issue.file}:${issue.line}` : issue.file) : '';
-            const locationStr = location ? ` ${chalk.gray(location)}` : '';
-            lines.push(`  ${colorFn(`[${label}]`)}${locationStr} ${issue.message}`);
-        }
-        lines.push('');
-    }
-    // Suggestions
-    if (result.suggestions.length > 0) {
-        lines.push(chalk.bold('  Suggestions'));
-        for (const suggestion of result.suggestions) {
-            lines.push(`  ${chalk.gray('-')} ${suggestion}`);
-        }
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-/**
- * Count issues grouped by severity.
- */
-function countBySeverity(issues) {
-    const counts = {
-        critical: 0,
-        major: 0,
-        minor: 0,
-        suggestion: 0,
-    };
-    for (const issue of issues) {
-        counts[issue.severity]++;
-    }
-    return counts;
-}
-// ─── GitHub comment posting ─────────────────────────────────────────────────
-/**
- * Format a {@link ReviewResult} as a GitHub-flavored markdown comment.
- */
-export function formatReviewMarkdown(result) {
-    const lines = [];
-    const statusIcon = result.approved ? ':white_check_mark:' : ':x:';
-    lines.push(`## ${statusIcon} Rulebook AI Review`);
-    lines.push('');
-    if (result.summary) {
-        lines.push(`**Summary:** ${result.summary}`);
-        lines.push('');
-    }
-    if (result.issues.length > 0) {
-        lines.push('### Issues');
-        lines.push('');
-        for (const issue of result.issues) {
-            const label = issue.severity.toUpperCase();
-            const location = issue.file
-                ? issue.line
-                    ? `\`${issue.file}:${issue.line}\``
-                    : `\`${issue.file}\``
-                : '';
-            const locationStr = location ? ` ${location}` : '';
-            lines.push(`- **[${label}]**${locationStr} ${issue.message}`);
-        }
-        lines.push('');
-    }
-    if (result.suggestions.length > 0) {
-        lines.push('### Suggestions');
-        lines.push('');
-        for (const suggestion of result.suggestions) {
-            lines.push(`- ${suggestion}`);
-        }
-        lines.push('');
-    }
-    lines.push('---');
-    lines.push('*Generated by [@hivehub/rulebook](https://github.com/hivellm/rulebook) AI Review*');
-    return lines.join('\n');
-}
-/**
- * Post a review result as a PR comment using the `gh` CLI.
- *
- * When `prNumber` is omitted the `gh` CLI auto-detects the current PR
- * from the branch.
- */
-export async function postGitHubComment(result, prNumber) {
-    const markdown = formatReviewMarkdown(result);
-    const prArg = prNumber ? ` ${prNumber}` : '';
-    const escapedBody = markdown.replace(/'/g, "'\\''");
-    const command = `gh pr comment${prArg} --body '${escapedBody}'`;
-    try {
-        await execAsync(command, { timeout: 15_000 });
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to post GitHub comment: ${message}`);
-    }
-}
-// ─── Severity threshold check ───────────────────────────────────────────────
-const SEVERITY_RANK = {
-    critical: 3,
-    major: 2,
-    minor: 1,
-    suggestion: 0,
-};
-/**
- * Check whether any issue meets or exceeds the given severity threshold.
- *
- * Returns `true` when at least one issue is at the threshold level or higher.
- */
-export function hasFailingIssues(issues, failOn) {
-    const threshold = SEVERITY_RANK[failOn];
-    return issues.some((i) => SEVERITY_RANK[i.severity] >= threshold);
-}
-// ─── Convenience: read project AGENTS.md ────────────────────────────────────
-/**
- * Read AGENTS.md from the given project root, if it exists.
- */
-export async function readAgentsMd(projectRoot) {
-    const agentsPath = path.join(projectRoot, 'AGENTS.md');
-    if (await fileExists(agentsPath)) {
-        return readFile(agentsPath);
-    }
-    return undefined;
-}
-//# sourceMappingURL=review-manager.js.map

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

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

package/dist/core/rules-generator.d.ts

@@ -1,73 +0,0 @@
-import type { DetectionResult } from '../types.js';
-/**
- * v5.3.0 `.claude/rules/` generator.
- *
- * For every detected language that rulebook ships a template for, emit
- * `.claude/rules/<language>.md` with YAML `paths:` frontmatter. These are
- * Anthropic's path-scoped rules (loaded only when Claude reads a file
- * matching the glob), so they cost zero context budget outside of the
- * relevant file types.
- *
- * Files generated by rulebook carry a sentinel comment immediately after
- * the frontmatter. On `rulebook update`, any `.claude/rules/*.md` without
- * the sentinel is treated as user-authored and left alone. This lets users
- * adopt a generated rule file as their own by simply deleting the sentinel
- * comment line.
- */
-export declare const RULES_DIR = ".claude/rules";
-export declare const GENERATED_SENTINEL = "Generated by @hivehub/rulebook v5.3.0";
-/**
- * Languages with shipped rule templates. Adding a new entry here requires a
- * matching `templates/rules/<slug>.md` file.
- */
-export declare const SUPPORTED_RULE_LANGUAGES: readonly ["typescript", "javascript", "rust", "python", "go", "cpp", "java", "csharp"];
-/**
- * Generic (non-language) rules shipped by rulebook v5.3.0.
- * These are always emitted regardless of detection result.
- */
-export declare const ALWAYS_ON_RULES: readonly ["full-task-no-questions", "multi-agent-teams", "consult-analysis-before-implementing", "respect-handoff-trigger", "diagnostic-first", "fail-twice-escalate"];
-export type SupportedRuleLanguage = (typeof SUPPORTED_RULE_LANGUAGES)[number];
-export interface RulesGenerationResult {
-    /** Paths of rule files written (new or overwritten). */
-    written: string[];
-    /** Paths of rule files skipped because they lack the generated sentinel. */
-    preserved: string[];
-    /** Languages detected but not shipped as rule templates. */
-    unsupported: string[];
-}
-export declare function getRulesDir(projectRoot: string): string;
-export declare function getRulePath(projectRoot: string, language: SupportedRuleLanguage): string;
-/**
- * Normalize a detected language string to a supported rule template slug.
- * Returns null if rulebook does not ship a template for it.
- */
-export declare function resolveRuleLanguage(detected: string): SupportedRuleLanguage | null;
-/**
- * Read a language rule template from the package's `templates/rules/`
- * directory.
- */
-export declare function readRuleTemplate(language: SupportedRuleLanguage): Promise<string>;
-/**
- * Check whether an existing rule file was generated by rulebook. Returns
- * true only if the canonical sentinel comment is present. User files that
- * the user "adopted" by deleting the sentinel return false and are
- * preserved across updates.
- */
-export declare function hasGeneratedSentinel(content: string): boolean;
-/**
- * Generate `.claude/rules/<language>.md` for every detected language that
- * has a shipped template. User-authored rules (no sentinel) are preserved.
- */
-export declare function generateRules(projectRoot: string, detection: Pick<DetectionResult, 'languages'>): Promise<RulesGenerationResult>;
-/**
- * List all rule files currently present in `.claude/rules/`, classifying
- * each by origin (generated by rulebook vs user-authored).
- */
-export interface ListedRule {
-    name: string;
-    path: string;
-    source: 'generated' | 'user';
-    paths: string[] | null;
-}
-export declare function listRulesWithSource(projectRoot: string): Promise<ListedRule[]>;
-//# sourceMappingURL=rules-generator.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"rules-generator.d.ts","sourceRoot":"","sources":["../../src/core/rules-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,SAAS,kBAAkB,CAAC;AACzC,eAAO,MAAM,kBAAkB,0CAA0C,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,wBAAwB,wFAS3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,eAAe,wKAOlB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAkB9E,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAExF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAMlF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAMvF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAC5C,OAAO,CAAC,qBAAqB,CAAC,CA2DhC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACxB;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAuBpF"}

package/dist/core/rules-generator.js

@@ -1,202 +0,0 @@
-import path from 'path';
-import { readFile, writeFile, fileExists, ensureDir } from '../utils/file-system.js';
-import { getTemplatesDir } from './generator.js';
-/**
- * v5.3.0 `.claude/rules/` generator.
- *
- * For every detected language that rulebook ships a template for, emit
- * `.claude/rules/<language>.md` with YAML `paths:` frontmatter. These are
- * Anthropic's path-scoped rules (loaded only when Claude reads a file
- * matching the glob), so they cost zero context budget outside of the
- * relevant file types.
- *
- * Files generated by rulebook carry a sentinel comment immediately after
- * the frontmatter. On `rulebook update`, any `.claude/rules/*.md` without
- * the sentinel is treated as user-authored and left alone. This lets users
- * adopt a generated rule file as their own by simply deleting the sentinel
- * comment line.
- */
-export const RULES_DIR = '.claude/rules';
-export const GENERATED_SENTINEL = 'Generated by @hivehub/rulebook v5.3.0';
-/**
- * Languages with shipped rule templates. Adding a new entry here requires a
- * matching `templates/rules/<slug>.md` file.
- */
-export const SUPPORTED_RULE_LANGUAGES = [
-    'typescript',
-    'javascript',
-    'rust',
-    'python',
-    'go',
-    'cpp',
-    'java',
-    'csharp',
-];
-/**
- * Generic (non-language) rules shipped by rulebook v5.3.0.
- * These are always emitted regardless of detection result.
- */
-export const ALWAYS_ON_RULES = [
-    'full-task-no-questions',
-    'multi-agent-teams',
-    'consult-analysis-before-implementing',
-    'respect-handoff-trigger',
-    'diagnostic-first',
-    'fail-twice-escalate',
-];
-/**
- * Detected languages from the `detector.ts` pipeline may use aliases
- * (e.g. `"c"` — which rulebook treats as C/C++ and routes to the `cpp`
- * template). Map them here.
- */
-const LANGUAGE_ALIASES = {
-    c: 'cpp',
-    'c++': 'cpp',
-    cs: 'csharp',
-    'c#': 'csharp',
-    ts: 'typescript',
-    js: 'javascript',
-    py: 'python',
-    rs: 'rust',
-};
-export function getRulesDir(projectRoot) {
-    return path.join(projectRoot, RULES_DIR);
-}
-export function getRulePath(projectRoot, language) {
-    return path.join(getRulesDir(projectRoot), `${language}.md`);
-}
-/**
- * Normalize a detected language string to a supported rule template slug.
- * Returns null if rulebook does not ship a template for it.
- */
-export function resolveRuleLanguage(detected) {
-    const lower = detected.toLowerCase().trim();
-    if (SUPPORTED_RULE_LANGUAGES.includes(lower)) {
-        return lower;
-    }
-    return LANGUAGE_ALIASES[lower] ?? null;
-}
-/**
- * Read a language rule template from the package's `templates/rules/`
- * directory.
- */
-export async function readRuleTemplate(language) {
-    const templatePath = path.join(getTemplatesDir(), 'rules', `${language}.md`);
-    if (!(await fileExists(templatePath))) {
-        throw new Error(`Rule template not found at ${templatePath}`);
-    }
-    return await readFile(templatePath);
-}
-/**
- * Check whether an existing rule file was generated by rulebook. Returns
- * true only if the canonical sentinel comment is present. User files that
- * the user "adopted" by deleting the sentinel return false and are
- * preserved across updates.
- */
-export function hasGeneratedSentinel(content) {
-    return content.includes(GENERATED_SENTINEL);
-}
-/**
- * Generate `.claude/rules/<language>.md` for every detected language that
- * has a shipped template. User-authored rules (no sentinel) are preserved.
- */
-export async function generateRules(projectRoot, detection) {
-    const rulesDir = getRulesDir(projectRoot);
-    await ensureDir(rulesDir);
-    const result = {
-        written: [],
-        preserved: [],
-        unsupported: [],
-    };
-    // Deduplicate: a project might detect both "typescript" and "javascript";
-    // we emit both rules since both apply. But if two detection entries map
-    // to the same template slug, only write once.
-    const seen = new Set();
-    for (const entry of detection.languages) {
-        const slug = resolveRuleLanguage(entry.language);
-        if (!slug) {
-            result.unsupported.push(entry.language);
-            continue;
-        }
-        if (seen.has(slug))
-            continue;
-        seen.add(slug);
-        const targetPath = getRulePath(projectRoot, slug);
-        if (await fileExists(targetPath)) {
-            const existing = await readFile(targetPath);
-            if (!hasGeneratedSentinel(existing)) {
-                // User-owned file — never touch it.
-                result.preserved.push(targetPath);
-                continue;
-            }
-        }
-        const template = await readRuleTemplate(slug);
-        await writeFile(targetPath, template);
-        result.written.push(targetPath);
-    }
-    // Always-on rules (not language-scoped) — emit if sentinel-based skip allows
-    for (const ruleName of ALWAYS_ON_RULES) {
-        const targetPath = path.join(rulesDir, `${ruleName}.md`);
-        if (await fileExists(targetPath)) {
-            const existing = await readFile(targetPath);
-            if (!hasGeneratedSentinel(existing)) {
-                result.preserved.push(targetPath);
-                continue;
-            }
-        }
-        const templatePath = path.join(getTemplatesDir(), 'rules', `${ruleName}.md`);
-        if (await fileExists(templatePath)) {
-            const template = await readFile(templatePath);
-            await writeFile(targetPath, template);
-            result.written.push(targetPath);
-        }
-    }
-    return result;
-}
-export async function listRulesWithSource(projectRoot) {
-    const rulesDir = getRulesDir(projectRoot);
-    if (!(await fileExists(rulesDir)))
-        return [];
-    const { promises: fs } = await import('fs');
-    const entries = await fs.readdir(rulesDir, { withFileTypes: true });
-    const results = [];
-    for (const entry of entries) {
-        if (!entry.isFile() || !entry.name.endsWith('.md'))
-            continue;
-        const filePath = path.join(rulesDir, entry.name);
-        const content = await readFile(filePath);
-        const source = hasGeneratedSentinel(content) ? 'generated' : 'user';
-        results.push({
-            name: entry.name.replace(/\.md$/, ''),
-            path: filePath,
-            source,
-            paths: extractPathsFrontmatter(content),
-        });
-    }
-    results.sort((a, b) => a.name.localeCompare(b.name));
-    return results;
-}
-/**
- * Extract the `paths:` field from a YAML frontmatter block at the top of a
- * markdown file. Returns null if no frontmatter or no `paths:` field.
- * Intentionally simple — handles the exact shape the shipped templates use,
- * not arbitrary YAML. Callers that need full YAML support should use a real
- * parser.
- */
-function extractPathsFrontmatter(content) {
-    // Handle both LF and CRLF line endings (Windows writes CRLF)
-    const normalized = content.replace(/\r\n/g, '\n');
-    const match = normalized.match(/^---\n([\s\S]*?)\n---/);
-    if (!match)
-        return null;
-    const frontmatter = match[1];
-    const pathsMatch = frontmatter.match(/^paths:\s*\n((?:\s*-\s+.+\n?)+)/m);
-    if (!pathsMatch)
-        return null;
-    const lines = pathsMatch[1].split('\n').filter((l) => l.trim().startsWith('-'));
-    return lines.map((l) => l
-        .replace(/^\s*-\s+/, '')
-        .replace(/^["']|["']$/g, '')
-        .trim());
-}
-//# sourceMappingURL=rules-generator.js.map