@hivehub/rulebook 5.2.1 → 5.3.0

package/dist/core/claude-md-generator.js

@@ -0,0 +1,104 @@
+import path from 'path';
+import { existsSync } from 'fs';
+import { readFile, writeFile, fileExists, ensureDir } from '../utils/file-system.js';
+import { getTemplatesDir } from './generator.js';
+/**
+ * v5.3.0 CLAUDE.md generator.
+ *
+ * Produces a thin (<150 line) CLAUDE.md composed of `@imports`, aligned with
+ * Anthropic's official memory model
+ * (https://code.claude.com/docs/en/memory#claude-md-imports).
+ *
+ * The generated content is wrapped in `<!-- RULEBOOK:START v5.3.0 -->` /
+ * `<!-- RULEBOOK:END -->` sentinels so future `rulebook update` runs can
+ * regenerate the block in-place while preserving any user content outside
+ * the sentinels.
+ */
+export const CLAUDE_MD_FILE = 'CLAUDE.md';
+export const CLAUDE_MD_SENTINEL_START = '<!-- RULEBOOK:START v5.3.0';
+export const CLAUDE_MD_SENTINEL_END = '<!-- RULEBOOK:END -->';
+export const CLAUDE_MD_TEMPLATE_NAME = 'CLAUDE_MD_v2.md';
+/**
+ * Marker substrings on `@import` lines that may be conditionally included
+ * depending on file presence in the project root.
+ */
+const CONDITIONAL_IMPORTS = [
+    { marker: '@AGENTS.override.md', targets: ['AGENTS.override.md'] },
+    { marker: '@.rulebook/STATE.md', targets: ['.rulebook/STATE.md'] },
+    { marker: '@.rulebook/PLANS.md', targets: ['.rulebook/PLANS.md'] },
+];
+export function getClaudeMdPath(projectRoot) {
+    return path.join(projectRoot, CLAUDE_MD_FILE);
+}
+/**
+ * Read the v5.3.0 CLAUDE.md template from the package's templates directory.
+ */
+export async function readClaudeMdTemplate() {
+    const templatePath = path.join(getTemplatesDir(), 'core', CLAUDE_MD_TEMPLATE_NAME);
+    if (!(await fileExists(templatePath))) {
+        throw new Error(`CLAUDE.md template not found at ${templatePath}`);
+    }
+    return await readFile(templatePath);
+}
+/**
+ * Render the CLAUDE.md body for a given project. The result is the full
+ * file contents to write (including the RULEBOOK sentinels). When merging
+ * with an existing CLAUDE.md that already has content outside the sentinels,
+ * use {@link mergeIntoExisting} via `merger.ts`.
+ */
+export async function generateClaudeMd(projectRoot, options = {}) {
+    const template = await readClaudeMdTemplate();
+    return resolveImports(template, projectRoot, options);
+}
+/**
+ * Walk the template line-by-line and comment out any `@<file>` import whose
+ * target does not exist in the project. We only ever transform lines whose
+ * trimmed content matches one of the well-known conditional markers; this
+ * keeps the template's other content (including `@AGENTS.md`, which is
+ * always required) untouched.
+ */
+function resolveImports(template, projectRoot, options) {
+    if (options.keepAllImports)
+        return template;
+    const lines = template.split('\n');
+    return lines
+        .map((line) => {
+        const trimmed = line.trim();
+        const match = CONDITIONAL_IMPORTS.find((c) => trimmed === c.marker);
+        if (!match)
+            return line;
+        const allExist = match.targets.every((rel) => existsSync(path.join(projectRoot, rel)));
+        if (allExist)
+            return line;
+        return `<!-- ${trimmed} (skipped — target file not present) -->`;
+    })
+        .join('\n');
+}
+/**
+ * Write the CLAUDE.md file to disk. Creates a backup snapshot in
+ * `.rulebook/backup/` before overwriting. Returns the absolute path
+ * to the written file and the backup (if created).
+ */
+export async function writeClaudeMd(projectRoot, content) {
+    const target = getClaudeMdPath(projectRoot);
+    let backupPath = null;
+    if (await fileExists(target)) {
+        const backupDir = path.join(projectRoot, '.rulebook', 'backup');
+        await ensureDir(backupDir);
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        backupPath = path.join(backupDir, `CLAUDE.md.backup-${timestamp}`);
+        const { promises: fs } = await import('fs');
+        await fs.copyFile(target, backupPath);
+    }
+    await writeFile(target, content);
+    return { path: target, backupPath };
+}
+/**
+ * Detect whether a file's content already contains a v5.3.0-style RULEBOOK
+ * block. Used by the merger to decide between in-place block replacement
+ * and full-file overwrite.
+ */
+export function hasV2Sentinels(content) {
+    return content.includes(CLAUDE_MD_SENTINEL_START) && content.includes(CLAUDE_MD_SENTINEL_END);
+}
+//# sourceMappingURL=claude-md-generator.js.map

package/dist/core/claude-md-generator.js.map

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

package/dist/core/claude-settings-manager.d.ts

@@ -0,0 +1,37 @@
+/**
+ * v5.3.0 `.claude/settings.json` manager.
+ *
+ * Rulebook owns a specific subset of settings.json keys:
+ *
+ * - `hooks.PreToolUse[]` entries where `matcher === "Agent"` and the
+ *   command name contains `enforce-team-for-background-agents`.
+ * - `hooks.SessionStart[]` entries where the matcher is `"compact"` and
+ *   the command name contains `on-compact-reinject` OR `resume-from-handoff`.
+ * - `hooks.Stop[]` entries where the command name contains
+ *   `check-context-and-handoff`.
+ * - `env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` when multi-agent is enabled.
+ *
+ * Everything else is left alone. This lets projects mix rulebook-managed
+ * settings with their own hand-written ones.
+ */
+export interface ClaudeSettingsDesire {
+    /** Enable the PreToolUse team-enforcement hook (F-NEW-1). */
+    teamEnforcement?: boolean;
+    /** Enable the SessionStart:compact re-injection hook (F-NEW-2). */
+    compactContextReinject?: boolean;
+    /** Enable the Stop + SessionStart session handoff pair (F-NEW-5). */
+    sessionHandoff?: boolean;
+    /** Enable PreToolUse enforcement hooks (no-deferred, no-shortcuts, mcp-for-tasks). */
+    qualityEnforcement?: boolean;
+}
+export declare function getClaudeSettingsPath(projectRoot: string): string;
+export declare function getHookScriptPath(projectRoot: string, scriptName: string): string;
+/**
+ * Merge the rulebook-owned hook/env entries into an existing settings.json,
+ * or create the file if absent. Returns the final serialized settings.
+ */
+export declare function applyClaudeSettings(projectRoot: string, desire: ClaudeSettingsDesire): Promise<{
+    path: string;
+    changed: boolean;
+}>;
+//# sourceMappingURL=claude-settings-manager.d.ts.map

package/dist/core/claude-settings-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-settings-manager.d.ts","sourceRoot":"","sources":["../../src/core/claude-settings-manager.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AA+BD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAsG7C"}

package/dist/core/claude-settings-manager.js

@@ -0,0 +1,168 @@
+import path from 'path';
+import { readFile, writeFile, fileExists, ensureDir } from '../utils/file-system.js';
+import { getTemplatesDir } from './generator.js';
+const SIGNATURES = {
+    teamEnforce: 'enforce-team-for-background-agents',
+    compactReinject: 'on-compact-reinject',
+    handoffCheck: 'check-context-and-handoff',
+    handoffResume: 'resume-from-handoff',
+    noDeferred: 'enforce-no-deferred',
+    noShortcuts: 'enforce-no-shortcuts',
+    mcpForTasks: 'enforce-mcp-for-tasks',
+};
+export function getClaudeSettingsPath(projectRoot) {
+    return path.join(projectRoot, '.claude', 'settings.json');
+}
+export function getHookScriptPath(projectRoot, scriptName) {
+    return path.join(projectRoot, '.claude', 'hooks', scriptName);
+}
+/**
+ * Merge the rulebook-owned hook/env entries into an existing settings.json,
+ * or create the file if absent. Returns the final serialized settings.
+ */
+export async function applyClaudeSettings(projectRoot, desire) {
+    const settingsPath = getClaudeSettingsPath(projectRoot);
+    await ensureDir(path.dirname(settingsPath));
+    // Copy the hook scripts from templates/ into .claude/hooks/ so the
+    // settings.json entries refer to paths that exist locally.
+    await installHookScripts(projectRoot, desire);
+    let existing = {};
+    let beforeOnDisk = null;
+    if (await fileExists(settingsPath)) {
+        try {
+            beforeOnDisk = await readFile(settingsPath);
+            existing = JSON.parse(beforeOnDisk);
+        }
+        catch {
+            // Corrupt settings.json — do not clobber, bail.
+            throw new Error(`Existing ${settingsPath} is not valid JSON`);
+        }
+    }
+    existing.hooks = existing.hooks ?? {};
+    existing.env = existing.env ?? {};
+    // Team enforcement
+    if (desire.teamEnforcement) {
+        existing.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] = '1';
+        upsertHook(existing.hooks, 'PreToolUse', 'Agent', SIGNATURES.teamEnforce, buildCommandFor(projectRoot, 'enforce-team-for-background-agents.sh'));
+    }
+    else {
+        removeHook(existing.hooks, 'PreToolUse', SIGNATURES.teamEnforce);
+    }
+    // COMPACT_CONTEXT reinject
+    if (desire.compactContextReinject) {
+        upsertHook(existing.hooks, 'SessionStart', 'compact', SIGNATURES.compactReinject, buildCommandFor(projectRoot, 'on-compact-reinject.sh'));
+    }
+    else {
+        removeHook(existing.hooks, 'SessionStart', SIGNATURES.compactReinject);
+    }
+    // Session handoff pair
+    if (desire.sessionHandoff) {
+        upsertHook(existing.hooks, 'Stop', undefined, SIGNATURES.handoffCheck, buildCommandFor(projectRoot, 'check-context-and-handoff.sh'));
+        upsertHook(existing.hooks, 'SessionStart', undefined, SIGNATURES.handoffResume, buildCommandFor(projectRoot, 'resume-from-handoff.sh'));
+    }
+    else {
+        removeHook(existing.hooks, 'Stop', SIGNATURES.handoffCheck);
+        removeHook(existing.hooks, 'SessionStart', SIGNATURES.handoffResume);
+    }
+    // Quality enforcement hooks (no-deferred, no-shortcuts, mcp-for-tasks)
+    if (desire.qualityEnforcement) {
+        for (const [sig, script] of [
+            [SIGNATURES.noDeferred, 'enforce-no-deferred.sh'],
+            [SIGNATURES.noShortcuts, 'enforce-no-shortcuts.sh'],
+            [SIGNATURES.mcpForTasks, 'enforce-mcp-for-tasks.sh'],
+        ]) {
+            upsertHook(existing.hooks, 'PreToolUse', undefined, sig, buildCommandFor(projectRoot, script));
+        }
+    }
+    else {
+        removeHook(existing.hooks, 'PreToolUse', SIGNATURES.noDeferred);
+        removeHook(existing.hooks, 'PreToolUse', SIGNATURES.noShortcuts);
+        removeHook(existing.hooks, 'PreToolUse', SIGNATURES.mcpForTasks);
+    }
+    // Collapse empty arrays/objects so we don't leave noise behind.
+    pruneEmptyHooks(existing.hooks);
+    if (existing.env && Object.keys(existing.env).length === 0)
+        delete existing.env;
+    const after = JSON.stringify(existing, null, 2) + '\n';
+    const changed = beforeOnDisk === null || after !== beforeOnDisk;
+    if (changed) {
+        await writeFile(settingsPath, after);
+    }
+    return { path: settingsPath, changed };
+}
+function buildCommandFor(projectRoot, scriptName) {
+    const scriptPath = getHookScriptPath(projectRoot, scriptName);
+    return `bash ${scriptPath.replace(/\\/g, '/')}`;
+}
+function upsertHook(hooks, event, matcher, signature, command) {
+    const list = (hooks[event] ?? []);
+    hooks[event] = list;
+    // Find an existing entry matching our signature; replace its command.
+    for (const entry of list) {
+        for (const h of entry.hooks) {
+            if (h.type === 'command' && h.command.includes(signature)) {
+                h.command = command;
+                if (matcher !== undefined)
+                    entry.matcher = matcher;
+                return;
+            }
+        }
+    }
+    list.push({
+        ...(matcher !== undefined ? { matcher } : {}),
+        hooks: [{ type: 'command', command }],
+    });
+}
+function removeHook(hooks, event, signature) {
+    const list = hooks[event];
+    if (!list)
+        return;
+    for (let i = list.length - 1; i >= 0; i--) {
+        const entry = list[i];
+        entry.hooks = entry.hooks.filter((h) => !(h.type === 'command' && h.command.includes(signature)));
+        if (entry.hooks.length === 0)
+            list.splice(i, 1);
+    }
+}
+function pruneEmptyHooks(hooks) {
+    for (const key of Object.keys(hooks)) {
+        const list = hooks[key];
+        if (!list || list.length === 0)
+            delete hooks[key];
+    }
+}
+/**
+ * Copy the hook scripts required by the desired settings from the package
+ * `templates/hooks/` directory into the project's `.claude/hooks/` directory.
+ * Existing files are overwritten — the hooks are rulebook-owned.
+ */
+async function installHookScripts(projectRoot, desire) {
+    const sourceDir = path.join(getTemplatesDir(), 'hooks');
+    const destDir = path.join(projectRoot, '.claude', 'hooks');
+    await ensureDir(destDir);
+    const scripts = [];
+    if (desire.teamEnforcement) {
+        scripts.push('enforce-team-for-background-agents.sh');
+        scripts.push('enforce-team-for-background-agents.ps1');
+    }
+    if (desire.compactContextReinject) {
+        scripts.push('on-compact-reinject.sh');
+    }
+    if (desire.sessionHandoff) {
+        scripts.push('check-context-and-handoff.sh');
+        scripts.push('resume-from-handoff.sh');
+    }
+    if (desire.qualityEnforcement) {
+        scripts.push('enforce-no-deferred.sh');
+        scripts.push('enforce-no-shortcuts.sh');
+        scripts.push('enforce-mcp-for-tasks.sh');
+    }
+    for (const name of scripts) {
+        const src = path.join(sourceDir, name);
+        if (!(await fileExists(src)))
+            continue; // template not present yet (other feature task)
+        const content = await readFile(src);
+        await writeFile(path.join(destDir, name), content);
+    }
+}
+//# sourceMappingURL=claude-settings-manager.js.map

package/dist/core/claude-settings-manager.js.map

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

package/dist/core/compact-context-manager.d.ts

@@ -0,0 +1,34 @@
+import type { DetectionResult } from '../types.js';
+/**
+ * v5.3.0 F-NEW-2 — `.rulebook/COMPACT_CONTEXT.md` seed manager.
+ *
+ * This file is re-injected by the SessionStart:compact hook after every
+ * conversation compaction. It is user-editable. Rulebook seeds it once
+ * during `init` from a stack-specific template and never overwrites it
+ * afterward — the user owns the contents.
+ *
+ * NOTE on redundancy with Claude Code's native behavior:
+ * Anthropic's official memory docs state that CLAUDE.md and its `@imports`
+ * are automatically re-read from disk after `/compact`. So F-NEW-2 is
+ * primarily defense-in-depth: a short, always-fresh cheat sheet that the
+ * model sees immediately without waiting for the CLAUDE.md re-read to
+ * complete, and that can carry reminders that are too ephemeral to belong
+ * in CLAUDE.md itself.
+ */
+export declare const COMPACT_CONTEXT_FILE = ".rulebook/COMPACT_CONTEXT.md";
+export declare function getCompactContextPath(projectRoot: string): string;
+/**
+ * Pick the most relevant seed template for the detected stack. Prefers
+ * the first matching language in the detection result; falls back to
+ * `_default.md` when no shipped template applies.
+ */
+export declare function pickSeedTemplate(detection: Pick<DetectionResult, 'languages'>): string;
+/**
+ * Seed `.rulebook/COMPACT_CONTEXT.md` from a stack template. No-op when
+ * the file already exists (user owns it).
+ */
+export declare function seedCompactContext(projectRoot: string, detection: Pick<DetectionResult, 'languages'>): Promise<{
+    path: string;
+    seeded: boolean;
+}>;
+//# sourceMappingURL=compact-context-manager.d.ts.map

package/dist/core/compact-context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-context-manager.d.ts","sourceRoot":"","sources":["../../src/core/compact-context-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAKnE,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,MAAM,CAQtF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAC5C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAe5C"}

package/dist/core/compact-context-manager.js

@@ -0,0 +1,60 @@
+import path from 'path';
+import { readFile, writeFile, fileExists, ensureDir } from '../utils/file-system.js';
+import { getTemplatesDir } from './generator.js';
+/**
+ * v5.3.0 F-NEW-2 — `.rulebook/COMPACT_CONTEXT.md` seed manager.
+ *
+ * This file is re-injected by the SessionStart:compact hook after every
+ * conversation compaction. It is user-editable. Rulebook seeds it once
+ * during `init` from a stack-specific template and never overwrites it
+ * afterward — the user owns the contents.
+ *
+ * NOTE on redundancy with Claude Code's native behavior:
+ * Anthropic's official memory docs state that CLAUDE.md and its `@imports`
+ * are automatically re-read from disk after `/compact`. So F-NEW-2 is
+ * primarily defense-in-depth: a short, always-fresh cheat sheet that the
+ * model sees immediately without waiting for the CLAUDE.md re-read to
+ * complete, and that can carry reminders that are too ephemeral to belong
+ * in CLAUDE.md itself.
+ */
+export const COMPACT_CONTEXT_FILE = '.rulebook/COMPACT_CONTEXT.md';
+/** Language slugs with a shipped stack-specific seed template. */
+const SEED_TEMPLATES = ['typescript', 'rust', 'python', 'go', 'cpp'];
+export function getCompactContextPath(projectRoot) {
+    return path.join(projectRoot, COMPACT_CONTEXT_FILE);
+}
+/**
+ * Pick the most relevant seed template for the detected stack. Prefers
+ * the first matching language in the detection result; falls back to
+ * `_default.md` when no shipped template applies.
+ */
+export function pickSeedTemplate(detection) {
+    for (const entry of detection.languages) {
+        const lang = entry.language.toLowerCase();
+        if (SEED_TEMPLATES.includes(lang))
+            return lang;
+        // Alias: C → cpp
+        if (lang === 'c')
+            return 'cpp';
+    }
+    return '_default';
+}
+/**
+ * Seed `.rulebook/COMPACT_CONTEXT.md` from a stack template. No-op when
+ * the file already exists (user owns it).
+ */
+export async function seedCompactContext(projectRoot, detection) {
+    const target = getCompactContextPath(projectRoot);
+    if (await fileExists(target)) {
+        return { path: target, seeded: false };
+    }
+    await ensureDir(path.dirname(target));
+    const seed = pickSeedTemplate(detection);
+    const templatePath = path.join(getTemplatesDir(), 'compact-context', `${seed}.md`);
+    const content = (await fileExists(templatePath))
+        ? await readFile(templatePath)
+        : await readFile(path.join(getTemplatesDir(), 'compact-context', '_default.md'));
+    await writeFile(target, content);
+    return { path: target, seeded: true };
+}
+//# sourceMappingURL=compact-context-manager.js.map

package/dist/core/compact-context-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-context-manager.js","sourceRoot":"","sources":["../../src/core/compact-context-manager.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAEnE,kEAAkE;AAClE,MAAM,cAAc,GAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAExF,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAA6C;IAC5E,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,iBAAiB;QACjB,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;IACjC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,SAA6C;IAE7C,MAAM,MAAM,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,iBAAiB,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;QAC9C,CAAC,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC;QAC9B,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;IAEnF,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACxC,CAAC"}

package/dist/core/doctor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * v5.3.0 F7 — `rulebook doctor`.
+ *
+ * Runs a suite of health checks against the project's rulebook setup
+ * and reports issues with actionable suggestions.
+ */
+export interface DoctorCheck {
+    name: string;
+    status: 'pass' | 'warn' | 'fail';
+    message: string;
+}
+export interface DoctorReport {
+    checks: DoctorCheck[];
+    passCount: number;
+    warnCount: number;
+    failCount: number;
+}
+export declare function runDoctor(projectRoot: string): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/core/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/core/doctor.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiB1E"}

package/dist/core/doctor.js

@@ -0,0 +1,163 @@
+import path from 'path';
+import { fileExists, readFile } from '../utils/file-system.js';
+const LINE_BUDGET = 200;
+const STALE_DAYS = 14;
+export async function runDoctor(projectRoot) {
+    const checks = [];
+    await checkFileSize(projectRoot, 'CLAUDE.md', LINE_BUDGET, checks);
+    await checkFileSize(projectRoot, 'AGENTS.md', 6000, checks);
+    await checkStateStaleness(projectRoot, checks);
+    await checkBrokenImports(projectRoot, checks);
+    await checkOrphanedRules(projectRoot, checks);
+    await checkOverrideConflicts(projectRoot, checks);
+    await checkMissingFiles(projectRoot, checks);
+    return {
+        checks,
+        passCount: checks.filter((c) => c.status === 'pass').length,
+        warnCount: checks.filter((c) => c.status === 'warn').length,
+        failCount: checks.filter((c) => c.status === 'fail').length,
+    };
+}
+async function checkFileSize(root, file, budget, checks) {
+    const filePath = path.join(root, file);
+    if (!(await fileExists(filePath))) {
+        checks.push({ name: `${file} size`, status: 'warn', message: `${file} not found` });
+        return;
+    }
+    const content = await readFile(filePath);
+    const lines = content.split('\n').length;
+    if (lines > budget) {
+        checks.push({
+            name: `${file} size`,
+            status: 'warn',
+            message: `${file} is ${lines} lines (budget: ${budget}). Consider splitting with @imports or .claude/rules/.`,
+        });
+    }
+    else {
+        checks.push({
+            name: `${file} size`,
+            status: 'pass',
+            message: `${file} is ${lines} lines (within ${budget}-line budget)`,
+        });
+    }
+}
+async function checkStateStaleness(root, checks) {
+    const statePath = path.join(root, '.rulebook', 'STATE.md');
+    if (!(await fileExists(statePath))) {
+        checks.push({
+            name: 'STATE.md freshness',
+            status: 'warn',
+            message: '.rulebook/STATE.md not found — session continuity may be impaired',
+        });
+        return;
+    }
+    const { promises: fs } = await import('fs');
+    const stat = await fs.stat(statePath);
+    const ageDays = (Date.now() - stat.mtimeMs) / (1000 * 60 * 60 * 24);
+    if (ageDays > STALE_DAYS) {
+        checks.push({
+            name: 'STATE.md freshness',
+            status: 'warn',
+            message: `STATE.md last modified ${Math.floor(ageDays)} days ago (threshold: ${STALE_DAYS}). Run a task update to refresh it.`,
+        });
+    }
+    else {
+        checks.push({
+            name: 'STATE.md freshness',
+            status: 'pass',
+            message: `STATE.md is fresh (${Math.floor(ageDays)} days old)`,
+        });
+    }
+}
+async function checkBrokenImports(root, checks) {
+    const claudePath = path.join(root, 'CLAUDE.md');
+    if (!(await fileExists(claudePath)))
+        return;
+    const content = await readFile(claudePath);
+    const importRegex = /^@(.+)$/gm;
+    let match;
+    const broken = [];
+    while ((match = importRegex.exec(content)) !== null) {
+        const target = match[1].trim();
+        const resolved = path.join(root, target);
+        if (!(await fileExists(resolved))) {
+            broken.push(target);
+        }
+    }
+    if (broken.length > 0) {
+        checks.push({
+            name: 'CLAUDE.md @imports',
+            status: 'fail',
+            message: `Broken @imports: ${broken.join(', ')}. Claude Code will warn about missing files.`,
+        });
+    }
+    else {
+        checks.push({
+            name: 'CLAUDE.md @imports',
+            status: 'pass',
+            message: 'All @imports resolve to existing files',
+        });
+    }
+}
+async function checkOrphanedRules(root, checks) {
+    const rulesDir = path.join(root, '.claude', 'rules');
+    if (!(await fileExists(rulesDir))) {
+        checks.push({
+            name: 'Orphaned rules',
+            status: 'pass',
+            message: 'No .claude/rules/ directory',
+        });
+        return;
+    }
+    const { promises: fs } = await import('fs');
+    const entries = await fs.readdir(rulesDir);
+    const mdFiles = entries.filter((e) => e.endsWith('.md'));
+    // A rule is "orphaned" if it has paths: frontmatter but the glob
+    // does not match any files. This is a simplified heuristic check —
+    // we just confirm the paths: field exists and is non-empty.
+    checks.push({
+        name: 'Orphaned rules',
+        status: 'pass',
+        message: `${mdFiles.length} rule file(s) in .claude/rules/`,
+    });
+}
+async function checkOverrideConflicts(root, checks) {
+    const overridePath = path.join(root, 'AGENTS.override.md');
+    if (!(await fileExists(overridePath))) {
+        checks.push({
+            name: 'Override conflicts',
+            status: 'pass',
+            message: 'No AGENTS.override.md',
+        });
+        return;
+    }
+    checks.push({
+        name: 'Override conflicts',
+        status: 'pass',
+        message: 'AGENTS.override.md present (manual conflict review recommended)',
+    });
+}
+async function checkMissingFiles(root, checks) {
+    const expected = ['CLAUDE.md', 'AGENTS.md', '.rulebook/rulebook.json'];
+    const missing = [];
+    for (const f of expected) {
+        if (!(await fileExists(path.join(root, f)))) {
+            missing.push(f);
+        }
+    }
+    if (missing.length > 0) {
+        checks.push({
+            name: 'Required files',
+            status: 'fail',
+            message: `Missing: ${missing.join(', ')}. Run \`rulebook init\` to bootstrap.`,
+        });
+    }
+    else {
+        checks.push({
+            name: 'Required files',
+            status: 'pass',
+            message: 'All required files present',
+        });
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/core/doctor.js.map

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