claude-rules-doctor 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+Catch dead Claude rules before they silently do nothing.
+
+# 🩺 claude-rules-doctor
+
+CLI that verifies `.claude/rules/*.md` `paths:` globs actually match files in your project.
+
+## Quickstart
+
+```bash
+# One-off
+npx claude-rules-doctor check --root .
+
+# Or install globally
+npm install -g claude-rules-doctor
+rules-doctor check --root .
+```
+
+## Problem
+
+Claude rules with `paths:` frontmatter can silently fail if:
+- The glob pattern doesn't match any files
+- File paths changed after the rule was created
+- Typos in glob patterns
+
+This tool scans all your rules and tells you which ones are "dead" (not applying to any files).
+
+## Usage
+
+### Check current project
+
+```bash
+rules-doctor check
+```
+
+### CI mode (exit 1 if dead rules found)
+
+```bash
+rules-doctor check --ci
+```
+
+### JSON output
+
+```bash
+rules-doctor check --json
+```
+
+### Verbose mode (show matched files)
+
+```bash
+rules-doctor check --verbose
+```
+
+### Check specific directory
+
+```bash
+rules-doctor check --root /path/to/project
+```
+
+## Output
+
+- ✅ **OK** — Rule is global (no paths) or paths match files
+- ⚠️ **WARNING** — Paths match files, but there's a known platform bug
+- ❌ **DEAD** — Paths specified, but 0 files match
+
+## Example output (test-suite/6-mixed)
+
+```bash
+$ rules-doctor check
+
+🔍 Rules Doctor - Check Results
+
+✅ OK      <root>/.claude/rules/valid.md
+  Matches 1 file(s)
+
+✅ OK      <root>/.claude/rules/global.md
+  Global rule (no paths specified)
+
+❌ DEAD    <root>/.claude/rules/dead.md
+  No files match the specified paths
+
+Summary:
+  Total rules: 3
+  ✅ OK: 2
+  ⚠️  WARNING: 0
+  ❌ DEAD: 1
+
+⚠️  Found 1 dead rule(s). These rules won't apply to any files.
+```
+
+## CI (GitHub Actions)
+
+```yaml
+name: rules-doctor
+on: [push, pull_request]
+
+jobs:
+  rules:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npx claude-rules-doctor check --ci
+```
+
+## Why not cclint?
+
+cclint validates frontmatter schema. We validate reality: do your globs actually match files in your repo?
+
+## License
+
+MIT

package/dist/checker.d.ts

@@ -0,0 +1,4 @@
+import type { RuleFile, RuleCheckResult } from './types.js';
+export declare function checkRule(rule: RuleFile, rootDir: string): Promise<RuleCheckResult>;
+export declare function checkAllRules(rules: RuleFile[], rootDir: string): Promise<RuleCheckResult[]>;
+//# sourceMappingURL=checker.d.ts.map

package/dist/checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../src/checker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAc,MAAM,YAAY,CAAC;AAGxE,wBAAsB,SAAS,CAC7B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC,CAkF1B;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B"}

package/dist/checker.js

@@ -0,0 +1,81 @@
+import { glob } from 'glob';
+import { RuleStatus as Status } from './types.js';
+export async function checkRule(rule, rootDir) {
+    // Global rule (no paths specified)
+    if (!rule.frontmatter || !rule.frontmatter.paths) {
+        return {
+            rule,
+            status: Status.OK,
+            matchedFiles: [],
+            message: 'Global rule (no paths specified)',
+        };
+    }
+    const paths = rule.frontmatter.paths;
+    if (!Array.isArray(paths) || paths.length === 0) {
+        return {
+            rule,
+            status: Status.OK,
+            matchedFiles: [],
+            message: 'No valid paths array',
+        };
+    }
+    // Filter out non-string values and warn about them
+    const invalidPaths = [];
+    const validPaths = [];
+    for (const path of paths) {
+        if (typeof path === 'string') {
+            validPaths.push(path);
+        }
+        else {
+            invalidPaths.push(path);
+        }
+    }
+    // If there are non-string values, return WARNING
+    if (invalidPaths.length > 0) {
+        const invalidTypes = invalidPaths
+            .map(p => (p === null ? 'null' : typeof p))
+            .join(', ');
+        return {
+            rule,
+            status: Status.WARNING,
+            matchedFiles: [],
+            message: `Invalid types in paths array: ${invalidTypes}. Only strings are allowed.`,
+        };
+    }
+    // Check each glob pattern
+    const allMatches = new Set();
+    for (const pattern of validPaths) {
+        try {
+            const matches = await glob(pattern, {
+                cwd: rootDir,
+                nodir: true,
+                ignore: ['node_modules/**', '.git/**'],
+            });
+            matches.forEach(file => allMatches.add(file));
+        }
+        catch (error) {
+            // Invalid glob pattern - treat as no matches
+            continue;
+        }
+    }
+    const matchedFiles = Array.from(allMatches).sort();
+    if (matchedFiles.length === 0) {
+        return {
+            rule,
+            status: Status.DEAD,
+            matchedFiles: [],
+            message: 'No files match the specified paths',
+        };
+    }
+    // For now, we don't detect platform bugs, so just return OK
+    return {
+        rule,
+        status: Status.OK,
+        matchedFiles,
+        message: `Matches ${matchedFiles.length} file(s)`,
+    };
+}
+export async function checkAllRules(rules, rootDir) {
+    return Promise.all(rules.map(rule => checkRule(rule, rootDir)));
+}
+//# sourceMappingURL=checker.js.map

package/dist/checker.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { resolve, join } from 'path';
+import { existsSync } from 'fs';
+import { parseAllRules } from './parser.js';
+import { checkAllRules } from './checker.js';
+import { generateReport, printConsoleReport, printJsonReport } from './reporter.js';
+const program = new Command();
+program
+    .name('rules-doctor')
+    .description('CLI for checking .claude/rules/*.md files')
+    .version('1.0.0');
+program
+    .command('check')
+    .description('Check all rules in .claude/rules/')
+    .option('--root <path>', 'Root directory to check', process.cwd())
+    .option('--ci', 'Exit with code 1 if dead rules found', false)
+    .option('--json', 'Output results as JSON', false)
+    .option('--verbose', 'Show matched files for each rule', false)
+    .action(async (options) => {
+    try {
+        const rootDir = resolve(options.root);
+        const rulesDir = join(rootDir, '.claude', 'rules');
+        // Check if .claude/rules/ directory exists
+        if (!existsSync(rulesDir)) {
+            console.log('Directory .claude/rules/ does not exist');
+            process.exit(0);
+        }
+        // Parse all rules
+        const rules = await parseAllRules(rootDir);
+        if (rules.length === 0) {
+            console.log('No rules found in .claude/rules/ (directory is empty)');
+            process.exit(0);
+        }
+        // Check all rules
+        const results = await checkAllRules(rules, rootDir);
+        // Generate report
+        const report = generateReport(results);
+        // Output
+        if (options.json) {
+            printJsonReport(report);
+        }
+        else {
+            printConsoleReport(report, options.verbose);
+        }
+        // CI mode: exit 1 if dead rules found
+        if (options.ci && report.deadCount > 0) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEpF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CAAC,2CAA2C,CAAC;KACxD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CAAC,eAAe,EAAE,yBAAyB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACjE,MAAM,CAAC,MAAM,EAAE,sCAAsC,EAAE,KAAK,CAAC;KAC7D,MAAM,CAAC,QAAQ,EAAE,wBAAwB,EAAE,KAAK,CAAC;KACjD,MAAM,CAAC,WAAW,EAAE,kCAAkC,EAAE,KAAK,CAAC;KAC9D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAEnD,2CAA2C;QAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,kBAAkB;QAClB,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,kBAAkB;QAClB,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEpD,kBAAkB;QAClB,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QAEvC,SAAS;QACT,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QAED,sCAAsC;QACtC,IAAI,OAAO,CAAC,EAAE,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './parser.js';
+export * from './checker.js';
+export * from './reporter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './parser.js';
+export * from './checker.js';
+export * from './reporter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,5 @@
+import type { RuleFile } from './types.js';
+export declare function findRuleFiles(rootDir: string): Promise<string[]>;
+export declare function parseRuleFile(filePath: string): Promise<RuleFile>;
+export declare function parseAllRules(rootDir: string): Promise<RuleFile[]>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAI5D,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAItE;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQvE;AAiBD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMxE"}

package/dist/parser.js

@@ -0,0 +1,36 @@
+import { readFile } from 'fs/promises';
+import { glob } from 'glob';
+import { parse as parseYaml } from 'yaml';
+const FRONTMATTER_REGEX = /^\s*---\s*\n([\s\S]*?)\n---/;
+export async function findRuleFiles(rootDir) {
+    const pattern = `${rootDir}/.claude/rules/**/*.md`;
+    const files = await glob(pattern, { nodir: true });
+    return files;
+}
+export async function parseRuleFile(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    const frontmatter = extractFrontmatter(content);
+    return {
+        filePath,
+        frontmatter,
+    };
+}
+function extractFrontmatter(content) {
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        return null;
+    }
+    try {
+        const parsed = parseYaml(match[1]);
+        return parsed;
+    }
+    catch (error) {
+        return null;
+    }
+}
+export async function parseAllRules(rootDir) {
+    const filePaths = await findRuleFiles(rootDir);
+    const rules = await Promise.all(filePaths.map(filePath => parseRuleFile(filePath)));
+    return rules;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,MAAM,OAAO,GAAG,GAAG,OAAO,wBAAwB,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEhD,OAAO;QACL,QAAQ;QACR,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,OAAO,MAAyB,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CACnD,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/reporter.d.ts

@@ -0,0 +1,5 @@
+import type { RuleCheckResult, CheckReport } from './types.js';
+export declare function generateReport(results: RuleCheckResult[]): CheckReport;
+export declare function printConsoleReport(report: CheckReport, verbose: boolean): void;
+export declare function printJsonReport(report: CheckReport): void;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG/D,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,WAAW,CAwBtE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAwC9E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAEzD"}

package/dist/reporter.js

@@ -0,0 +1,79 @@
+import chalk from 'chalk';
+import { RuleStatus } from './types.js';
+export function generateReport(results) {
+    const report = {
+        totalRules: results.length,
+        okCount: 0,
+        warningCount: 0,
+        deadCount: 0,
+        results,
+    };
+    for (const result of results) {
+        switch (result.status) {
+            case RuleStatus.OK:
+                report.okCount++;
+                break;
+            case RuleStatus.WARNING:
+                report.warningCount++;
+                break;
+            case RuleStatus.DEAD:
+                report.deadCount++;
+                break;
+        }
+    }
+    return report;
+}
+export function printConsoleReport(report, verbose) {
+    console.log(chalk.bold('\n🔍 Rules Doctor - Check Results\n'));
+    for (const result of report.results) {
+        const statusIcon = getStatusIcon(result.status);
+        const statusColor = getStatusColor(result.status);
+        const relativePath = result.rule.filePath;
+        console.log(`${statusIcon} ${statusColor(result.status.padEnd(7))} ${chalk.gray(relativePath)}`);
+        console.log(`  ${chalk.dim(result.message)}`);
+        if (verbose && result.matchedFiles.length > 0) {
+            console.log(chalk.dim(`  Matched files (${result.matchedFiles.length}):`));
+            result.matchedFiles.slice(0, 10).forEach(file => {
+                console.log(chalk.dim(`    - ${file}`));
+            });
+            if (result.matchedFiles.length > 10) {
+                console.log(chalk.dim(`    ... and ${result.matchedFiles.length - 10} more`));
+            }
+        }
+        console.log();
+    }
+    console.log(chalk.bold('Summary:'));
+    console.log(`  Total rules: ${report.totalRules}`);
+    console.log(`  ${chalk.green('✅ OK')}: ${report.okCount}`);
+    console.log(`  ${chalk.yellow('⚠️  WARNING')}: ${report.warningCount}`);
+    console.log(`  ${chalk.red('❌ DEAD')}: ${report.deadCount}`);
+    console.log();
+    if (report.deadCount > 0) {
+        console.log(chalk.yellow(`⚠️  Found ${report.deadCount} dead rule(s). These rules won't apply to any files.`));
+        console.log();
+    }
+}
+export function printJsonReport(report) {
+    console.log(JSON.stringify(report, null, 2));
+}
+function getStatusIcon(status) {
+    switch (status) {
+        case RuleStatus.OK:
+            return chalk.green('✅');
+        case RuleStatus.WARNING:
+            return chalk.yellow('⚠️');
+        case RuleStatus.DEAD:
+            return chalk.red('❌');
+    }
+}
+function getStatusColor(status) {
+    switch (status) {
+        case RuleStatus.OK:
+            return chalk.green;
+        case RuleStatus.WARNING:
+            return chalk.yellow;
+        case RuleStatus.DEAD:
+            return chalk.red;
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+export interface RuleFrontmatter {
+    paths?: string[];
+    [key: string]: unknown;
+}
+export interface RuleFile {
+    filePath: string;
+    frontmatter: RuleFrontmatter | null;
+}
+export declare enum RuleStatus {
+    OK = "OK",
+    WARNING = "WARNING",
+    DEAD = "DEAD"
+}
+export interface RuleCheckResult {
+    rule: RuleFile;
+    status: RuleStatus;
+    matchedFiles: string[];
+    message: string;
+}
+export interface CheckOptions {
+    root: string;
+    ci: boolean;
+    json: boolean;
+    verbose: boolean;
+}
+export interface CheckReport {
+    totalRules: number;
+    okCount: number;
+    warningCount: number;
+    deadCount: number;
+    results: RuleCheckResult[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;CACrC;AAED,oBAAY,UAAU;IACpB,EAAE,OAAO;IACT,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}

package/dist/types.js

@@ -0,0 +1,7 @@
+export var RuleStatus;
+(function (RuleStatus) {
+    RuleStatus["OK"] = "OK";
+    RuleStatus["WARNING"] = "WARNING";
+    RuleStatus["DEAD"] = "DEAD";
+})(RuleStatus || (RuleStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAUA,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,uBAAS,CAAA;IACT,iCAAmB,CAAA;IACnB,2BAAa,CAAA;AACf,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "claude-rules-doctor",
+  "version": "0.1.1",
+  "description": "Your Claude Code rules silently fail. We catch them.",
+  "type": "module",
+  "bin": {
+    "rules-doctor": "dist/cli.js",
+    "claude-rules-doctor": "dist/cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nulone/claude-rules-doctor.git"
+  },
+  "homepage": "https://github.com/nulone/claude-rules-doctor#readme",
+  "bugs": {
+    "url": "https://github.com/nulone/claude-rules-doctor/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "rules",
+    "linter",
+    "cli",
+    "glob",
+    "validation",
+    "dead-rules"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "glob": "^10.3.10",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}