@mmnto/cli 1.34.3 → 1.36.0

package/dist/hook/schema.test.js

@@ -0,0 +1,233 @@
+import { describe, expect, it } from 'vitest';
+import { COMPILED_HOOKS_SCHEMA_VERSION, CompiledHooksManifestSchema, HookRuleSchema, HOOKS_YAML_SCHEMA_VERSION, HooksYamlSchema, } from './schema.js';
+describe('hook schema', () => {
+    describe('HookRuleSchema', () => {
+        it('accepts a minimal rule with required fields only', () => {
+            const minimal = {
+                id: 'gca-tag-xor-command',
+                trigger: { tool: 'bash', pattern: 'gh\\s+(pr|issue)\\s+comment.*' },
+                check: {
+                    pattern: '(?=.*@gemini-code-assist)(?=.*\\/gemini review)',
+                    type: 'reject-if-match',
+                },
+                message: 'GCA tag XOR — never both.',
+            };
+            const parsed = HookRuleSchema.parse(minimal);
+            expect(parsed.recoveryHint).toBeUndefined();
+            expect(parsed.verification_shadow).toBeUndefined();
+        });
+        it('accepts a rule with the optional recoveryHint field', () => {
+            const withHint = {
+                id: 'r1',
+                trigger: { tool: 'bash', pattern: '.*' },
+                check: { pattern: 'x', type: 'reject-if-match' },
+                message: 'm',
+                recoveryHint: 'try y instead',
+            };
+            const parsed = HookRuleSchema.parse(withHint);
+            expect(parsed.recoveryHint).toBe('try y instead');
+        });
+        it('accepts verification_shadow permissively (V1 warn-and-ignore at runtime)', () => {
+            const withShadow = {
+                id: 'r1',
+                trigger: { tool: 'bash', pattern: '.*' },
+                check: { pattern: 'x', type: 'reject-if-match' },
+                message: 'm',
+                verification_shadow: { rego: 'package x' },
+            };
+            // V1 contract: schema accepts the block so a future Spine-Rule
+            // promotion doesn't break the parser. Runtime drops/warns on it.
+            expect(() => HookRuleSchema.parse(withShadow)).not.toThrow();
+        });
+        it('rejects rules with empty required strings', () => {
+            const empty = {
+                id: '',
+                trigger: { tool: 'bash', pattern: '.*' },
+                check: { pattern: 'x', type: 'reject-if-match' },
+                message: 'm',
+            };
+            expect(() => HookRuleSchema.parse(empty)).toThrow();
+        });
+        it('rejects an unknown check.type value', () => {
+            const badType = {
+                id: 'r1',
+                trigger: { tool: 'bash', pattern: '.*' },
+                check: { pattern: 'x', type: 'maybe-reject' },
+                message: 'm',
+            };
+            expect(() => HookRuleSchema.parse(badType)).toThrow();
+        });
+        it('rejects rules whose trigger.pattern is not a valid regex (parse-time)', () => {
+            // Unterminated character class — `new RegExp('[')` throws SyntaxError.
+            // Schema must catch this before any `evaluateHook` invocation so a
+            // malformed pack rule surfaces at parse time rather than at first-fire.
+            const badRegex = {
+                id: 'r1',
+                trigger: { tool: 'bash', pattern: '[' },
+                check: { pattern: 'x', type: 'reject-if-match' },
+                message: 'm',
+            };
+            expect(() => HookRuleSchema.parse(badRegex)).toThrow();
+        });
+        it('rejects rules whose check.pattern is not a valid regex (parse-time)', () => {
+            const badRegex = {
+                id: 'r1',
+                trigger: { tool: 'bash', pattern: '.*' },
+                check: { pattern: '*invalid', type: 'reject-if-match' },
+                message: 'm',
+            };
+            expect(() => HookRuleSchema.parse(badRegex)).toThrow();
+        });
+        it('rejects rules whose check.pattern has ReDoS risk (parse-time)', () => {
+            // `(a+)+$` is the canonical exponential-backtracking ReDoS shape — runs
+            // exponentially in the input length on near-matches. Pack-supplied
+            // patterns get a parse-time safety check via safe-regex2 to keep the
+            // engine's availability guarantee independent of pack quality.
+            const redosRule = {
+                id: 'r1',
+                trigger: { tool: 'bash', pattern: '.*' },
+                check: { pattern: '(a+)+$', type: 'reject-if-match' },
+                message: 'm',
+            };
+            const result = HookRuleSchema.safeParse(redosRule);
+            expect(result.success).toBe(false);
+            if (!result.success) {
+                const issue = result.error.issues.find((i) => i.message.includes('catastrophic-backtracking'));
+                expect(issue).toBeDefined();
+            }
+        });
+        it('rejects rules whose pattern exceeds the length cap', () => {
+            const oversized = {
+                id: 'r1',
+                trigger: { tool: 'bash', pattern: 'a'.repeat(600) },
+                check: { pattern: 'x', type: 'reject-if-match' },
+                message: 'm',
+            };
+            const result = HookRuleSchema.safeParse(oversized);
+            expect(result.success).toBe(false);
+        });
+    });
+    describe('HooksYamlSchema', () => {
+        it('accepts a pack-level hooks.yaml with version 1 and an empty hooks array', () => {
+            const empty = { version: HOOKS_YAML_SCHEMA_VERSION, hooks: [] };
+            expect(() => HooksYamlSchema.parse(empty)).not.toThrow();
+        });
+        it('accepts version 2 — forward-compat path (runtime warn-and-skip per Decision 4)', () => {
+            // Schema accepts any positive integer version. The warn-and-skip on
+            // unknown-version is enforced at the load layer, not the schema layer,
+            // so a future bot-pack publishing version 2 doesn't crash the parser.
+            const future = { version: 2, hooks: [] };
+            expect(() => HooksYamlSchema.parse(future)).not.toThrow();
+        });
+        it('rejects non-positive version values', () => {
+            expect(() => HooksYamlSchema.parse({ version: 0, hooks: [] })).toThrow();
+            expect(() => HooksYamlSchema.parse({ version: -1, hooks: [] })).toThrow();
+        });
+        it('accepts hooks with distinct ids', () => {
+            const distinct = {
+                version: HOOKS_YAML_SCHEMA_VERSION,
+                hooks: [
+                    {
+                        id: 'r1',
+                        trigger: { tool: 'bash', pattern: '.*' },
+                        check: { pattern: 'x', type: 'reject-if-match' },
+                        message: 'm1',
+                    },
+                    {
+                        id: 'r2',
+                        trigger: { tool: 'bash', pattern: '.*' },
+                        check: { pattern: 'y', type: 'reject-if-match' },
+                        message: 'm2',
+                    },
+                ],
+            };
+            expect(() => HooksYamlSchema.parse(distinct)).not.toThrow();
+        });
+        it('rejects duplicate hook ids within a pack (provenance must stay deterministic)', () => {
+            // Two rules with the same id within one pack would make
+            // `<packId>/<ruleId>` rejection trails ambiguous (ADR-104 § Decision 1).
+            const dup = {
+                version: HOOKS_YAML_SCHEMA_VERSION,
+                hooks: [
+                    {
+                        id: 'r1',
+                        trigger: { tool: 'bash', pattern: '.*' },
+                        check: { pattern: 'x', type: 'reject-if-match' },
+                        message: 'first',
+                    },
+                    {
+                        id: 'r1',
+                        trigger: { tool: 'bash', pattern: '.*' },
+                        check: { pattern: 'y', type: 'reject-if-match' },
+                        message: 'second',
+                    },
+                ],
+            };
+            const result = HooksYamlSchema.safeParse(dup);
+            expect(result.success).toBe(false);
+            if (!result.success) {
+                const issue = result.error.issues.find((i) => i.message === 'Duplicate hook id within pack: r1');
+                expect(issue).toBeDefined();
+                expect(issue?.path).toEqual(['hooks', 1, 'id']);
+            }
+        });
+    });
+    describe('CompiledHooksManifestSchema', () => {
+        it('accepts a manifest with the required staleness metadata fields', () => {
+            const manifest = {
+                schemaVersion: COMPILED_HOOKS_SCHEMA_VERSION,
+                compiledAt: '2026-05-11T18:43:00Z',
+                sourcePackVersions: {
+                    '@mmnto/pack-bot-coderabbit': '1.0.0',
+                },
+                hooks: [],
+            };
+            expect(() => CompiledHooksManifestSchema.parse(manifest)).not.toThrow();
+        });
+        it('rejects a manifest missing sourcePackVersions (staleness check requires it)', () => {
+            const bad = {
+                schemaVersion: COMPILED_HOOKS_SCHEMA_VERSION,
+                compiledAt: '2026-05-11T18:43:00Z',
+                hooks: [],
+            };
+            expect(() => CompiledHooksManifestSchema.parse(bad)).toThrow();
+        });
+        it('rejects a non-ISO compiledAt string', () => {
+            const bad = {
+                schemaVersion: COMPILED_HOOKS_SCHEMA_VERSION,
+                compiledAt: 'yesterday',
+                sourcePackVersions: {},
+                hooks: [],
+            };
+            expect(() => CompiledHooksManifestSchema.parse(bad)).toThrow();
+        });
+        it('rejects a future schemaVersion (uses z.literal — caller must handle upgrades)', () => {
+            const future = {
+                schemaVersion: 2,
+                compiledAt: '2026-05-11T18:43:00Z',
+                sourcePackVersions: {},
+                hooks: [],
+            };
+            expect(() => CompiledHooksManifestSchema.parse(future)).toThrow();
+        });
+        it('preserves provenance via packId on each compiled rule', () => {
+            const manifest = {
+                schemaVersion: COMPILED_HOOKS_SCHEMA_VERSION,
+                compiledAt: '2026-05-11T18:43:00Z',
+                sourcePackVersions: { '@mmnto/pack-bot-coderabbit': '1.0.0' },
+                hooks: [
+                    {
+                        id: 'r1',
+                        packId: '@mmnto/pack-bot-coderabbit',
+                        trigger: { tool: 'bash', pattern: '.*' },
+                        check: { pattern: 'x', type: 'reject-if-match' },
+                        message: 'm',
+                    },
+                ],
+            };
+            const parsed = CompiledHooksManifestSchema.parse(manifest);
+            expect(parsed.hooks[0].packId).toBe('@mmnto/pack-bot-coderabbit');
+        });
+    });
+});
+//# sourceMappingURL=schema.test.js.map

package/dist/hook/schema.test.js.map

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

package/dist/hook/test-runner.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Hooks-surface fixture test runner (ADR-104 § Convergence).
+ *
+ * Walks fixtures with `surface: hooks` from `.totem/tests/`, looks up the
+ * matching compiled hook by id, and evaluates each fixture line against
+ * the hook. Failures are reported per-line so authors can iterate on
+ * specific examples.
+ *
+ * Fixture semantics for hooks (corpus-driven):
+ * - `corpus: fail` (or `## Should fail` block) — each line is a tool-call
+ *   payload that MUST cause the hook to reject; lines that allow are
+ *   `missedFails`.
+ * - `corpus: pass` (or `## Should pass` block) — each line is a tool-call
+ *   payload that MUST allow; lines that reject are `falsePositives`.
+ *
+ * Both blocks may appear in a single fixture (matches the rules-surface
+ * dual-section pattern). The corpus frontmatter field is informational
+ * for hooks fixtures — the section names carry the same intent and the
+ * runner exercises both.
+ *
+ * The tool for each payload is sourced from the matched hook's
+ * `trigger.tool`. Fixtures do not encode the tool explicitly; the hook
+ * declares which tool it gates, so the fixture body is just the args
+ * payload the hook would see at runtime.
+ *
+ * The runner is deterministic Node.js — no LLM calls — mirroring the
+ * `totem hook run` contract. Loader warnings and structured errors flow
+ * through to the summary so the CLI surface can echo them to stderr.
+ */
+export interface HookTestFailure {
+    line: string;
+    expected: 'allow' | 'reject';
+    actual: 'allow' | 'reject';
+}
+export interface HookTestResult {
+    hookId: string;
+    packId: string;
+    fixturePath: string;
+    failures: HookTestFailure[];
+    passed: boolean;
+}
+export interface HookTestSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    /** Fixtures referencing a hook id not present in the loaded manifest. */
+    unknownHooks: {
+        fixturePath: string;
+        hookId: string;
+    }[];
+    results: HookTestResult[];
+    loadWarnings: string[];
+    loadErrors: {
+        code: string;
+        message: string;
+    }[];
+}
+export interface RunHookTestsOptions {
+    manifestPath: string;
+    testsDir: string;
+    installedPackVersions: Record<string, string>;
+}
+export declare function runHookTests(options: RunHookTestsOptions): HookTestSummary;
+//# sourceMappingURL=test-runner.d.ts.map

package/dist/hook/test-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../src/hook/test-runner.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,YAAY,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxD,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,eAAe,CA+B1E"}

package/dist/hook/test-runner.js

@@ -0,0 +1,57 @@
+import { loadFixtures } from '@mmnto/totem';
+import { loadCompiledHooks } from './loader.js';
+import { evaluateHook } from './runtime.js';
+export function runHookTests(options) {
+    const { hooks, warnings, errors } = loadCompiledHooks({
+        manifestPath: options.manifestPath,
+        installedPackVersions: options.installedPackVersions,
+    });
+    const fixtures = loadFixtures(options.testsDir).filter((f) => f.surface === 'hooks');
+    const hooksById = new Map(hooks.map((h) => [h.id, h]));
+    const results = [];
+    const unknownHooks = [];
+    for (const fixture of fixtures) {
+        const hook = hooksById.get(fixture.ruleHash);
+        if (!hook) {
+            unknownHooks.push({ fixturePath: fixture.fixturePath, hookId: fixture.ruleHash });
+            continue;
+        }
+        results.push(testHook(hook, fixture));
+    }
+    const passed = results.filter((r) => r.passed).length;
+    return {
+        total: results.length,
+        passed,
+        failed: results.length - passed,
+        unknownHooks,
+        results,
+        loadWarnings: warnings,
+        loadErrors: errors.map((e) => ({ code: e.code, message: e.message })),
+    };
+}
+function testHook(hook, fixture) {
+    const failures = [];
+    const tool = hook.trigger.tool;
+    for (const args of fixture.failLines) {
+        const payload = { tool, args };
+        const decision = evaluateHook(hook, payload).decision;
+        if (decision !== 'reject') {
+            failures.push({ line: args, expected: 'reject', actual: decision });
+        }
+    }
+    for (const args of fixture.passLines) {
+        const payload = { tool, args };
+        const decision = evaluateHook(hook, payload).decision;
+        if (decision !== 'allow') {
+            failures.push({ line: args, expected: 'allow', actual: decision });
+        }
+    }
+    return {
+        hookId: hook.id,
+        packId: hook.packId,
+        fixturePath: fixture.fixturePath,
+        failures,
+        passed: failures.length === 0,
+    };
+}
+//# sourceMappingURL=test-runner.js.map

package/dist/hook/test-runner.js.map

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

package/dist/hook/test-runner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-runner.test.d.ts.map

package/dist/hook/test-runner.test.d.ts.map

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

package/dist/hook/test-runner.test.js

@@ -0,0 +1,237 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { applyFilter } from '../commands/hook-test.js';
+import { runHookTests } from './test-runner.js';
+let workDir;
+let testsDir;
+let manifestPath;
+beforeEach(() => {
+    workDir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-hook-test-runner-'));
+    testsDir = path.join(workDir, 'tests');
+    fs.mkdirSync(testsDir);
+    manifestPath = path.join(workDir, 'compiled-hooks.json');
+});
+afterEach(() => {
+    fs.rmSync(workDir, { recursive: true, force: true });
+});
+const xorHook = {
+    id: 'gca-tag-xor-command',
+    packId: '@mmnto/pack-bot-gemini-code-assist',
+    trigger: { tool: 'bash', pattern: 'gh\\s+(pr|issue)\\s+comment' },
+    check: {
+        pattern: '(?=.*@gemini-code-assist)(?=.*\\/gemini review)',
+        type: 'reject-if-match',
+    },
+    message: 'GCA tag XOR command — never both; doubling wastes GCA quota.',
+};
+function writeManifest(hooks = [xorHook]) {
+    fs.writeFileSync(manifestPath, JSON.stringify({
+        schemaVersion: 1,
+        compiledAt: '2026-05-11T18:43:00Z',
+        sourcePackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+        hooks,
+    }), 'utf8');
+}
+function writeFixture(filename, content) {
+    fs.writeFileSync(path.join(testsDir, filename), content, 'utf8');
+}
+describe('runHookTests', () => {
+    it('returns empty results when no fixtures exist', () => {
+        writeManifest();
+        const summary = runHookTests({
+            manifestPath,
+            testsDir,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+        });
+        expect(summary.total).toBe(0);
+        expect(summary.results).toEqual([]);
+        expect(summary.unknownHooks).toEqual([]);
+    });
+    it('skips fixtures whose surface defaults to rules (backwards-compat)', () => {
+        writeManifest();
+        writeFixture('rule-fixture.md', `---
+rule: some-rule-hash
+file: src/app.ts
+---
+
+## Should fail
+
+\`\`\`ts
+unsafe_pattern
+\`\`\`
+`);
+        const summary = runHookTests({
+            manifestPath,
+            testsDir,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+        });
+        expect(summary.total).toBe(0);
+    });
+    it('reports passed=true when every fail-section line rejects', () => {
+        writeManifest();
+        writeFixture('xor-fail.md', `---
+rule: gca-tag-xor-command
+file: hook-fixtures/gca-fail.txt
+surface: hooks
+corpus: fail
+---
+
+## Should fail
+
+\`\`\`text
+gh pr comment 1 -b "@gemini-code-assist /gemini review please"
+gh issue comment 2 -b "@gemini-code-assist /gemini review now"
+\`\`\`
+`);
+        const summary = runHookTests({
+            manifestPath,
+            testsDir,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+        });
+        expect(summary.total).toBe(1);
+        expect(summary.passed).toBe(1);
+        expect(summary.failed).toBe(0);
+        expect(summary.results[0].failures).toEqual([]);
+    });
+    it('reports failed when a fail-section line does not reject (missed reject)', () => {
+        writeManifest();
+        writeFixture('xor-fail.md', `---
+rule: gca-tag-xor-command
+file: hook-fixtures/gca-fail.txt
+surface: hooks
+corpus: fail
+---
+
+## Should fail
+
+\`\`\`text
+gh pr comment 1 -b "@gemini-code-assist take a look"
+\`\`\`
+`);
+        const summary = runHookTests({
+            manifestPath,
+            testsDir,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+        });
+        expect(summary.failed).toBe(1);
+        expect(summary.results[0].failures.length).toBe(1);
+        expect(summary.results[0].failures[0]).toMatchObject({
+            expected: 'reject',
+            actual: 'allow',
+        });
+    });
+    it('reports failed when a pass-section line rejects (false positive)', () => {
+        writeManifest();
+        writeFixture('xor-pass.md', `---
+rule: gca-tag-xor-command
+file: hook-fixtures/gca-pass.txt
+surface: hooks
+corpus: pass
+---
+
+## Should pass
+
+\`\`\`text
+gh pr comment 1 -b "@gemini-code-assist /gemini review please"
+\`\`\`
+`);
+        const summary = runHookTests({
+            manifestPath,
+            testsDir,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+        });
+        expect(summary.failed).toBe(1);
+        expect(summary.results[0].failures[0]).toMatchObject({
+            expected: 'allow',
+            actual: 'reject',
+        });
+    });
+    it('flags fixtures referencing a hook id absent from the manifest under unknownHooks', () => {
+        writeManifest();
+        writeFixture('orphan.md', `---
+rule: does-not-exist
+file: hook-fixtures/orphan.txt
+surface: hooks
+corpus: fail
+---
+
+## Should fail
+
+\`\`\`text
+git push --force origin main
+\`\`\`
+`);
+        const summary = runHookTests({
+            manifestPath,
+            testsDir,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+        });
+        expect(summary.total).toBe(0);
+        expect(summary.unknownHooks).toEqual([expect.objectContaining({ hookId: 'does-not-exist' })]);
+    });
+    it('surfaces loadWarnings and loadErrors from the manifest loader', () => {
+        fs.writeFileSync(manifestPath, '{ not valid json', 'utf8');
+        const summary = runHookTests({
+            manifestPath,
+            testsDir,
+            installedPackVersions: {},
+        });
+        expect(summary.loadErrors.length).toBe(1);
+        expect(summary.loadErrors[0].code).toBe('HOOKS_LOAD_FAILED');
+    });
+});
+describe('applyFilter (hookTestCommand --filter contract)', () => {
+    function fakeResult(hookId, passed = true) {
+        return {
+            hookId,
+            packId: '@mmnto/pack-bot-coderabbit',
+            fixturePath: `tests/${hookId}.md`,
+            failures: [],
+            passed,
+        };
+    }
+    function fakeSummary(overrides = {}) {
+        const results = [
+            fakeResult('alpha'),
+            fakeResult('beta'),
+            fakeResult('gamma'),
+        ];
+        return {
+            total: results.length,
+            passed: results.length,
+            failed: 0,
+            unknownHooks: [],
+            results,
+            loadWarnings: [],
+            loadErrors: [],
+            ...overrides,
+        };
+    }
+    it('returns all results when filter is undefined', () => {
+        const summary = fakeSummary();
+        expect(applyFilter(summary, undefined).map((r) => r.hookId)).toEqual([
+            'alpha',
+            'beta',
+            'gamma',
+        ]);
+    });
+    it('returns only matching results when filter matches a substring', () => {
+        const summary = fakeSummary();
+        expect(applyFilter(summary, 'eta').map((r) => r.hookId)).toEqual(['beta']);
+    });
+    it('matches case-insensitively', () => {
+        const summary = fakeSummary();
+        expect(applyFilter(summary, 'ALPHA').map((r) => r.hookId)).toEqual(['alpha']);
+    });
+    it('throws TEST_FAILED when --filter matches nothing AND fixtures exist (typoed filter guard)', () => {
+        const summary = fakeSummary();
+        expect(() => applyFilter(summary, 'no-such-hook')).toThrow(/No hook tests matched/);
+    });
+    it('does NOT throw when filter is set but no fixtures exist (the placeholder branch handles that)', () => {
+        const summary = fakeSummary({ total: 0, results: [] });
+        expect(applyFilter(summary, 'anything')).toEqual([]);
+    });
+});
+//# sourceMappingURL=test-runner.test.js.map

package/dist/hook/test-runner.test.js.map

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