specweave 1.0.593 → 2.0.3

package/dist/src/core/doctor/checkers/git-checker.js

@@ -2,6 +2,11 @@
  * Git Checker - validates git repository status
  */
 import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { installGitHooks, needsHookRefresh, readInstalledHookVersion, PRE_COMMIT_HOOK_VERSION, } from '../../../cli/helpers/init/git-hooks-installer.js';
+import { findSourceDir } from '../../../cli/helpers/init/path-utils.js';
 import { calculateOverallStatus } from '../types.js';
 export class GitChecker {
     constructor() {
@@ -27,6 +32,9 @@ export class GitChecker {
         checks.push(this.checkWorkingDirectory(projectRoot));
         // Check for remote
         checks.push(this.checkRemote(projectRoot));
+        // Pre-commit hook freshness: a 1.x hook body blocks the 2.0 loop
+        // (it rejects ledger.jsonl / handoff.md at the increment root).
+        checks.push(this.checkPreCommitHook(projectRoot, options));
         // Skip branch checks in quick mode
         if (!options.quick) {
             checks.push(this.checkBranch(projectRoot));
@@ -50,6 +58,71 @@ export class GitChecker {
             return false;
         }
     }
+    /**
+     * A SpecWeave pre-commit hook installed by an older CLI still carries the 1.x
+     * "only 4 files at increment root" rule and the maxdepth-2 duplicate-ID scan,
+     * both of which reject a perfectly valid 2.0 increment. Detect and (with
+     * --fix) rewrite it.
+     */
+    checkPreCommitHook(projectRoot, options) {
+        const hookPath = path.join(projectRoot, '.git', 'hooks', 'pre-commit');
+        if (!fs.existsSync(hookPath)) {
+            return {
+                name: 'Pre-commit hook',
+                status: 'skip',
+                message: 'not installed',
+            };
+        }
+        let content = '';
+        try {
+            content = fs.readFileSync(hookPath, 'utf-8');
+        }
+        catch {
+            return { name: 'Pre-commit hook', status: 'warn', message: 'could not read hook' };
+        }
+        const installed = readInstalledHookVersion(content);
+        if (installed === null) {
+            return {
+                name: 'Pre-commit hook',
+                status: 'skip',
+                message: 'custom (not SpecWeave)',
+            };
+        }
+        if (!needsHookRefresh(content)) {
+            return {
+                name: 'Pre-commit hook',
+                status: 'pass',
+                message: `v${installed}`,
+            };
+        }
+        if (options.fix) {
+            try {
+                const here = path.dirname(fileURLToPath(import.meta.url));
+                const templatesDir = findSourceDir('templates', here);
+                fs.unlinkSync(hookPath);
+                installGitHooks(projectRoot, templatesDir);
+                return {
+                    name: 'Pre-commit hook',
+                    status: 'pass',
+                    message: `refreshed v${installed} → v${PRE_COMMIT_HOOK_VERSION}`,
+                };
+            }
+            catch {
+                // fall through to the warning below
+            }
+        }
+        // FAIL, not warn: this hook rejects `ledger.jsonl` at the increment root and
+        // reports a false duplicate id for any increment with a `reports/` folder,
+        // so the user's next commit is BLOCKED. A check whose failure stops work is
+        // not a warning, and `doctor` must exit non-zero so CI and the upgrade path
+        // notice it.
+        return {
+            name: 'Pre-commit hook',
+            status: 'fail',
+            message: `stale v${installed} — blocks commits in 2.0 increments (current v${PRE_COMMIT_HOOK_VERSION})`,
+            fixSuggestion: 'Run: specweave doctor --fix (or specweave update)',
+        };
+    }
     checkWorkingDirectory(projectRoot) {
         try {
             const status = execSync('git status --porcelain', {

package/dist/src/core/doctor/checkers/git-checker.js.map

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

package/dist/src/core/doctor/checkers/hooks-checker.d.ts

@@ -1,13 +1,21 @@
 /**
- * Hooks Checker - validates hook health (quick check, not full execution)
+ * Hooks Checker — dry-runs the SpecWeave 2.0 hook launcher for each of the
+ * four registered events with a sample stdin and validates the JSON output
+ * against the per-event Claude Code schema.
  */
 import type { HealthChecker, CategoryResult, DoctorOptions } from '../types.js';
+import { HOOK_EVENTS } from '../../hooks/handlers/types.js';
+/** Per-event launcher budget: a hook that needs longer than this is broken. */
+export declare const DRY_RUN_TIMEOUT_MS = 10000;
+/** Sample payloads that must never trigger a block or a side effect. */
+export declare const SAMPLE_HOOK_INPUT: Record<(typeof HOOK_EVENTS)[number], Record<string, unknown>>;
+/** The specweave package root: walk up from this file until package.json name === 'specweave'. */
+export declare function packageRoot(): string;
 export declare class HooksChecker implements HealthChecker {
     category: string;
     check(projectRoot: string, options: DoctorOptions): Promise<CategoryResult>;
-    private findHookLocations;
-    private checkHooksInLocation;
-    private checkHookSyntax;
-    private testHookExecution;
+    /** hooks.json uses a quoted node command string (Codex ignores separate args). */
+    private checkHooksJson;
+    private dryRun;
 }
 //# sourceMappingURL=hooks-checker.d.ts.map

package/dist/src/core/doctor/checkers/hooks-checker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-checker.d.ts","sourceRoot":"","sources":["../../../../../src/core/doctor/checkers/hooks-checker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAEd,aAAa,EACd,MAAM,aAAa,CAAC;AAGrB,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,SAAW;IAEb,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC;IAsD1B,OAAO,CAAC,iBAAiB;YAkBX,oBAAoB;IA+ClC,OAAO,CAAC,eAAe;YAgCT,iBAAiB;CAkChC"}
+{"version":3,"file":"hooks-checker.d.ts","sourceRoot":"","sources":["../../../../../src/core/doctor/checkers/hooks-checker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAe,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,WAAW,EAAsB,MAAM,+BAA+B,CAAC;AAEhF,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS3F,CAAC;AAEF,kGAAkG;AAClG,wBAAgB,WAAW,IAAI,MAAM,CAcpC;AAED,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,SAAW;IAEb,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA+BjF,kFAAkF;IAClF,OAAO,CAAC,cAAc;YAwBR,MAAM;CAoDrB"}

package/dist/src/core/doctor/checkers/hooks-checker.js

@@ -1,167 +1,143 @@
 /**
- * Hooks Checker - validates hook health (quick check, not full execution)
+ * Hooks Checker — dry-runs the SpecWeave 2.0 hook launcher for each of the
+ * four registered events with a sample stdin and validates the JSON output
+ * against the per-event Claude Code schema.
  */
 import * as fs from 'fs';
 import * as path from 'path';
-import { execSync } from 'child_process';
+import { execFile } from 'child_process';
+import { fileURLToPath } from 'url';
 import { calculateOverallStatus } from '../types.js';
+import { HOOK_EVENTS, validateHookOutput } from '../../hooks/handlers/types.js';
+/** Per-event launcher budget: a hook that needs longer than this is broken. */
+export const DRY_RUN_TIMEOUT_MS = 10000;
+/** Sample payloads that must never trigger a block or a side effect. */
+export const SAMPLE_HOOK_INPUT = {
+    'session-start': { hook_event_name: 'SessionStart', source: 'startup' },
+    'pre-tool-use': {
+        hook_event_name: 'PreToolUse',
+        tool_name: 'Edit',
+        tool_input: { file_path: 'C:\\proj\\.specweave\\increments\\0001-doctor\\tasks.md', old_string: 'a', new_string: 'b' },
+    },
+    'stop': { hook_event_name: 'Stop', stop_hook_active: false },
+    'pre-compact': { hook_event_name: 'PreCompact', trigger: 'auto' },
+};
+/** The specweave package root: walk up from this file until package.json name === 'specweave'. */
+export function packageRoot() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 8; i++) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
+            if (pkg.name === 'specweave')
+                return dir;
+        }
+        catch {
+            // keep walking
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '..', '..', '..');
+}
 export class HooksChecker {
     constructor() {
         this.category = 'Hooks';
     }
     async check(projectRoot, options) {
         const checks = [];
-        // Find hooks in .claude/hooks or plugin hooks
-        const hookLocations = this.findHookLocations(projectRoot);
-        if (hookLocations.length === 0) {
+        const pluginRoot = path.join(packageRoot(), 'plugins', 'specweave');
+        const runner = path.join(pluginRoot, 'hooks', 'run.mjs');
+        const hooksJson = path.join(pluginRoot, 'hooks', 'hooks.json');
+        if (!fs.existsSync(runner) || !fs.existsSync(hooksJson)) {
             checks.push({
-                name: 'Hooks',
-                status: 'skip',
-                message: 'no hooks configured',
-            });
-            return {
-                category: this.category,
-                status: 'skip',
-                checks,
-            };
-        }
-        // Check each hook location
-        for (const location of hookLocations) {
-            const hookChecks = await this.checkHooksInLocation(location, options.quick);
-            checks.push(...hookChecks);
-        }
-        // Summary check
-        const failedHooks = checks.filter((c) => c.status === 'fail').length;
-        const totalHooks = checks.filter((c) => c.status !== 'skip').length;
-        if (failedHooks > 0) {
-            checks.unshift({
-                name: 'Hooks summary',
+                name: 'Hook launcher',
                 status: 'fail',
-                message: `${failedHooks}/${totalHooks} hooks failing`,
-                fixSuggestion: 'Run: specweave hooks health',
-            });
-        }
-        else if (totalHooks > 0) {
-            checks.unshift({
-                name: 'Hooks summary',
-                status: 'pass',
-                message: `${totalHooks}/${totalHooks} hooks healthy`,
+                message: `missing ${fs.existsSync(runner) ? 'hooks.json' : 'hooks/run.mjs'} in ${pluginRoot}`,
+                fixSuggestion: 'Reinstall: npm i -g specweave && specweave refresh-plugins',
             });
+            return { category: this.category, status: 'fail', checks };
         }
-        return {
-            category: this.category,
-            status: calculateOverallStatus(checks),
-            checks,
-        };
-    }
-    findHookLocations(projectRoot) {
-        const locations = [];
-        // Check .claude/hooks
-        const claudeHooks = path.join(projectRoot, '.claude', 'hooks');
-        if (fs.existsSync(claudeHooks)) {
-            locations.push(claudeHooks);
-        }
-        // Check .specweave hooks (if any)
-        const specweaveHooks = path.join(projectRoot, '.specweave', 'hooks');
-        if (fs.existsSync(specweaveHooks)) {
-            locations.push(specweaveHooks);
-        }
-        return locations;
-    }
-    async checkHooksInLocation(location, quickMode) {
-        const checks = [];
-        try {
-            const files = fs.readdirSync(location);
-            const hookFiles = files.filter((f) => f.endsWith('.sh') || f.endsWith('.js'));
-            for (const hookFile of hookFiles) {
-                const hookPath = path.join(location, hookFile);
-                const hookName = hookFile.replace(/\.(sh|js)$/, '');
-                // Basic syntax check
-                const syntaxCheck = this.checkHookSyntax(hookPath, hookFile);
-                if (syntaxCheck.status === 'fail') {
-                    checks.push(syntaxCheck);
-                    continue;
-                }
-                // Skip execution test in quick mode
-                if (quickMode) {
-                    checks.push({
-                        name: hookName,
-                        status: 'skip',
-                        message: 'execution skipped (quick mode)',
-                    });
-                    continue;
-                }
-                // Quick execution test (with timeout)
-                checks.push(await this.testHookExecution(hookPath, hookName));
+        checks.push(this.checkHooksJson(hooksJson));
+        if (options.quick) {
+            for (const event of HOOK_EVENTS) {
+                checks.push({ name: `${event} dry-run`, status: 'skip', message: 'skipped (quick mode)' });
             }
         }
-        catch {
-            checks.push({
-                name: path.basename(location),
-                status: 'fail',
-                message: 'could not read hooks directory',
-            });
+        else {
+            // The four launches are independent — run them concurrently so `doctor`
+            // costs one hook round-trip, not four.
+            checks.push(...(await Promise.all(HOOK_EVENTS.map((event) => this.dryRun(runner, event, projectRoot)))));
         }
-        return checks;
+        return { category: this.category, status: calculateOverallStatus(checks), checks };
     }
-    checkHookSyntax(hookPath, fileName) {
-        const hookName = fileName.replace(/\.(sh|js)$/, '');
+    /** hooks.json uses a quoted node command string (Codex ignores separate args). */
+    checkHooksJson(hooksJson) {
         try {
-            const content = fs.readFileSync(hookPath, 'utf8');
-            if (fileName.endsWith('.sh')) {
-                // Basic bash syntax check
-                if (!content.includes('#!/')) {
-                    return {
-                        name: hookName,
-                        status: 'warn',
-                        message: 'missing shebang',
-                        fixSuggestion: 'Add #!/bin/bash at the start',
-                    };
+            const data = JSON.parse(fs.readFileSync(hooksJson, 'utf8'));
+            const problems = [];
+            for (const [event, groups] of Object.entries(data.hooks ?? {})) {
+                for (const group of groups) {
+                    for (const h of group.hooks ?? []) {
+                        if (!/^node \"\$\{CLAUDE_PLUGIN_ROOT\}\/hooks\/run\.mjs\" [a-z-]+$/.test(h.command ?? '') || h.args !== undefined) {
+                            problems.push(`${event}: expected quoted node hook command without separate args`);
+                        }
+                        if (typeof h.timeout === 'number' && h.timeout > 60)
+                            problems.push(`${event}: timeout ${h.timeout}s > 60s`);
+                    }
                 }
             }
-            return {
-                name: `${hookName} syntax`,
-                status: 'pass',
-                message: 'valid',
-            };
+            return problems.length === 0
+                ? { name: 'hooks.json', status: 'pass', message: 'portable node launcher, timeouts <= 60s' }
+                : { name: 'hooks.json', status: 'fail', message: problems.join('; ') };
         }
-        catch {
-            return {
-                name: `${hookName} syntax`,
-                status: 'fail',
-                message: 'could not read file',
-            };
+        catch (err) {
+            return { name: 'hooks.json', status: 'fail', message: `unreadable: ${err instanceof Error ? err.message : String(err)}` };
         }
     }
-    async testHookExecution(hookPath, hookName) {
+    async dryRun(runner, event, projectRoot) {
         const start = Date.now();
-        try {
-            // Dry-run test with minimal input
-            execSync(`bash "${hookPath}" --help 2>/dev/null || true`, {
+        const name = `${event} dry-run`;
+        const stdout = await new Promise((resolve, reject) => {
+            const child = execFile(process.execPath, [runner, event], {
+                cwd: projectRoot,
                 encoding: 'utf8',
-                timeout: 3000,
-                stdio: ['pipe', 'pipe', 'pipe'],
-                env: {
-                    ...process.env,
-                    SPECWEAVE_DOCTOR_DRY_RUN: '1',
-                },
-            });
+                timeout: DRY_RUN_TIMEOUT_MS,
+                env: { ...process.env, SPECWEAVE_HOME: packageRoot(), SPECWEAVE_HOOK_DRY_RUN: '1' },
+            }, (err, out) => (err ? reject(err) : resolve(out)));
+            child.stdin?.end(JSON.stringify({ ...SAMPLE_HOOK_INPUT[event], cwd: projectRoot }));
+        }).catch((err) => (err instanceof Error ? err : new Error(String(err))));
+        const durationMs = Date.now() - start;
+        if (stdout instanceof Error) {
             return {
-                name: `${hookName} execution`,
-                status: 'pass',
-                message: 'responds',
-                durationMs: Date.now() - start,
+                name,
+                status: 'fail',
+                message: `launcher failed: ${stdout.message.split('\n')[0]}`,
+                durationMs,
+                fixSuggestion: `node must be on PATH; run: node <plugin>/hooks/run.mjs ${event}`,
             };
         }
+        let parsed;
+        try {
+            parsed = JSON.parse(stdout.trim() || '{}');
+        }
         catch {
+            return { name, status: 'fail', message: `non-JSON output: ${stdout.trim().slice(0, 80)}`, durationMs };
+        }
+        const problem = validateHookOutput(event, parsed);
+        if (problem)
+            return { name, status: 'fail', message: problem, durationMs };
+        if (event === 'session-start' && JSON.stringify(parsed).includes('hooks inactive')) {
             return {
-                name: `${hookName} execution`,
+                name,
                 status: 'warn',
-                message: 'execution test failed',
-                durationMs: Date.now() - start,
-                fixSuggestion: 'Run: specweave hooks health for detailed analysis',
+                message: 'launcher could not locate the specweave CLI',
+                durationMs,
+                fixSuggestion: 'npm i -g specweave (or set SPECWEAVE_HOME)',
             };
         }
+        return { name, status: 'pass', message: `valid ${JSON.stringify(parsed).slice(0, 60)}`, durationMs };
     }
 }
 //# sourceMappingURL=hooks-checker.js.map

package/dist/src/core/doctor/checkers/hooks-checker.js.map

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

package/dist/src/core/doctor/checkers/hygiene-checker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Hygiene Checker — repository hygiene that has actually bitten users:
+ *
+ * 1. `.npmrc` with `ignore-scripts=true` — the confirmed supply-chain vector
+ *    was a dependency install script running in CI (warn, never fail).
+ * 2. Files under `.specweave/state/` tracked by git — machine-local state that
+ *    produces endless merge conflicts once committed.
+ * 3. Tracked files larger than 5 MB under `.specweave/increments/` — binary
+ *    evidence belongs in `reports/artifacts/` (gitignored).
+ */
+import type { HealthChecker, CategoryResult, DoctorOptions } from '../types.js';
+/** Tracked increment files above this size are flagged. */
+export declare const MAX_TRACKED_FILE_BYTES: number;
+export declare class HygieneChecker implements HealthChecker {
+    category: string;
+    check(projectRoot: string, _options: DoctorOptions): Promise<CategoryResult>;
+    private checkNpmrc;
+    private checkTrackedState;
+    private checkLargeIncrementFiles;
+}
+//# sourceMappingURL=hygiene-checker.d.ts.map

package/dist/src/core/doctor/checkers/hygiene-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hygiene-checker.d.ts","sourceRoot":"","sources":["../../../../../src/core/doctor/checkers/hygiene-checker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAe,aAAa,EAAE,MAAM,aAAa,CAAC;AAG7F,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAiBtD,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,SAAa;IAEf,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IASlF,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,wBAAwB;CA2BjC"}

package/dist/src/core/doctor/checkers/hygiene-checker.js

@@ -0,0 +1,110 @@
+/**
+ * Hygiene Checker — repository hygiene that has actually bitten users:
+ *
+ * 1. `.npmrc` with `ignore-scripts=true` — the confirmed supply-chain vector
+ *    was a dependency install script running in CI (warn, never fail).
+ * 2. Files under `.specweave/state/` tracked by git — machine-local state that
+ *    produces endless merge conflicts once committed.
+ * 3. Tracked files larger than 5 MB under `.specweave/increments/` — binary
+ *    evidence belongs in `reports/artifacts/` (gitignored).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { execFileSync } from 'child_process';
+import { calculateOverallStatus } from '../types.js';
+/** Tracked increment files above this size are flagged. */
+export const MAX_TRACKED_FILE_BYTES = 5 * 1024 * 1024;
+/** `git ls-files -z` under one pathspec, or null when git is unavailable. */
+function trackedFiles(projectRoot, pathspec) {
+    try {
+        const out = execFileSync('git', ['ls-files', '-z', '--', pathspec], {
+            cwd: projectRoot,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 15000,
+        });
+        return out.split('\0').filter(Boolean);
+    }
+    catch {
+        return null;
+    }
+}
+export class HygieneChecker {
+    constructor() {
+        this.category = 'Hygiene';
+    }
+    async check(projectRoot, _options) {
+        const checks = [
+            this.checkNpmrc(projectRoot),
+            this.checkTrackedState(projectRoot),
+            this.checkLargeIncrementFiles(projectRoot),
+        ];
+        return { category: this.category, status: calculateOverallStatus(checks), checks };
+    }
+    checkNpmrc(projectRoot) {
+        const npmrc = path.join(projectRoot, '.npmrc');
+        if (!fs.existsSync(npmrc)) {
+            return {
+                name: '.npmrc ignore-scripts',
+                status: 'warn',
+                message: 'no .npmrc in the repo',
+                fixSuggestion: "Add a committed .npmrc with 'ignore-scripts=true'",
+            };
+        }
+        const content = fs.readFileSync(npmrc, 'utf8');
+        const enabled = /^\s*ignore-scripts\s*=\s*true\s*$/m.test(content);
+        return enabled
+            ? { name: '.npmrc ignore-scripts', status: 'pass', message: 'ignore-scripts=true' }
+            : {
+                name: '.npmrc ignore-scripts',
+                status: 'warn',
+                message: 'ignore-scripts is not set to true',
+                fixSuggestion: "Add 'ignore-scripts=true' to .npmrc (dependency install scripts are a supply-chain vector)",
+            };
+    }
+    checkTrackedState(projectRoot) {
+        const files = trackedFiles(projectRoot, '.specweave/state');
+        if (files === null) {
+            return { name: 'Tracked state files', status: 'skip', message: 'not a git repository' };
+        }
+        if (files.length === 0) {
+            return { name: 'Tracked state files', status: 'pass', message: '.specweave/state is untracked' };
+        }
+        return {
+            name: 'Tracked state files',
+            status: 'warn',
+            message: `${files.length} file(s) under .specweave/state are tracked by git`,
+            details: files.slice(0, 5),
+            fixSuggestion: 'Run: git rm -r --cached .specweave/state (and keep it in .gitignore)',
+        };
+    }
+    checkLargeIncrementFiles(projectRoot) {
+        const files = trackedFiles(projectRoot, '.specweave/increments');
+        if (files === null) {
+            return { name: 'Large increment files', status: 'skip', message: 'not a git repository' };
+        }
+        const big = [];
+        for (const rel of files) {
+            try {
+                const { size } = fs.statSync(path.join(projectRoot, rel));
+                if (size > MAX_TRACKED_FILE_BYTES) {
+                    big.push(`${rel} (${(size / 1024 / 1024).toFixed(1)} MB)`);
+                }
+            }
+            catch {
+                // deleted-but-still-tracked file — nothing to measure
+            }
+        }
+        if (big.length === 0) {
+            return { name: 'Large increment files', status: 'pass', message: 'no tracked file over 5 MB' };
+        }
+        return {
+            name: 'Large increment files',
+            status: 'warn',
+            message: `${big.length} tracked file(s) over 5 MB under .specweave/increments`,
+            details: big.slice(0, 5),
+            fixSuggestion: 'Move binaries to <increment>/reports/artifacts/ (gitignored) and git rm --cached them',
+        };
+    }
+}
+//# sourceMappingURL=hygiene-checker.js.map

package/dist/src/core/doctor/checkers/hygiene-checker.js.map

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

package/dist/src/core/doctor/checkers/increments-checker.js

@@ -188,7 +188,7 @@ export class IncrementsChecker {
             status: 'warn',
             message: `${issues.length} desync(s)`,
             details: issues.slice(0, 3),
-            fixSuggestion: 'Run: specweave repair-status-desync',
+            fixSuggestion: 'Run: specweave doctor --fix-status',
         };
     }
 }