tryassay 0.22.2 → 0.25.0

package/dist/lib/__tests__/gap-matcher.test.js

@@ -0,0 +1,291 @@
+import { describe, it, expect } from 'vitest';
+import { extractAnchors, simpleStem, extractTokens, tokensOverlap, matchGapToSuppression, } from '../gap-matcher.js';
+// ── extractAnchors ───────────────────────────────────────────────────
+describe('extractAnchors', () => {
+    it('extracts file paths', () => {
+        const anchors = extractAnchors('Missing src/routes/auth.ts implementation');
+        expect(anchors).toContain('src/routes/auth.ts');
+    });
+    it('extracts nested file paths', () => {
+        const anchors = extractAnchors('The file src/lib/gmail/handler.ts is referenced');
+        expect(anchors).toContain('src/lib/gmail/handler.ts');
+    });
+    it('extracts API route patterns', () => {
+        const anchors = extractAnchors('POST /api/users endpoint not found');
+        expect(anchors).toContain('/api/users');
+    });
+    it('extracts route-like paths without HTTP method', () => {
+        const anchors = extractAnchors('The /api/v2/auth/login route');
+        expect(anchors).toContain('/api/v2/auth/login');
+    });
+    it('extracts camelCase identifiers >= 6 chars', () => {
+        const anchors = extractAnchors('The handleAuth function is missing');
+        expect(anchors).toContain('handleauth');
+    });
+    it('extracts snake_case identifiers >= 6 chars', () => {
+        const anchors = extractAnchors('Missing user_profile_handler implementation');
+        expect(anchors).toContain('user_profile_handler');
+    });
+    it('ignores short identifiers', () => {
+        const anchors = extractAnchors('The foo_bar variable');
+        // foo_bar is 7 chars, should be included
+        expect(anchors).toContain('foo_bar');
+    });
+    it('returns empty array for empty input', () => {
+        expect(extractAnchors('')).toEqual([]);
+    });
+    it('returns empty array for text without anchors', () => {
+        const anchors = extractAnchors('This is a plain sentence');
+        expect(anchors).toEqual([]);
+    });
+});
+// ── simpleStem ───────────────────────────────────────────────────────
+describe('simpleStem', () => {
+    it('strips -ing suffix', () => {
+        expect(simpleStem('handling')).toBe('handl');
+    });
+    it('strips -tion suffix', () => {
+        // 'authentication' hits -ation first (longer match) → 'authentic'
+        expect(simpleStem('authentication')).toBe('authentic');
+        // 'production' hits -tion → 'produc'
+        expect(simpleStem('production')).toBe('produc');
+    });
+    it('strips -ation suffix', () => {
+        expect(simpleStem('validation')).toBe('valid');
+    });
+    it('strips -ed suffix', () => {
+        expect(simpleStem('configured')).toBe('configur');
+    });
+    it('strips trailing -s', () => {
+        expect(simpleStem('handlers')).toBe('handler');
+    });
+    it('does not strip -ss words', () => {
+        expect(simpleStem('process')).toBe('process');
+    });
+    it('protects short words (4 chars or less)', () => {
+        expect(simpleStem('auth')).toBe('auth');
+        expect(simpleStem('file')).toBe('file');
+        expect(simpleStem('code')).toBe('code');
+    });
+    it('lowercases input', () => {
+        expect(simpleStem('GMAIL')).toBe('gmail');
+    });
+    it('strips -ment suffix', () => {
+        expect(simpleStem('management')).toBe('manage');
+    });
+    it('strips -ness suffix', () => {
+        expect(simpleStem('completeness')).toBe('complete');
+    });
+});
+// ── extractTokens ────────────────────────────────────────────────────
+describe('extractTokens', () => {
+    it('removes general stop words', () => {
+        const tokens = extractTokens('the handler is not working for the user', []);
+        expect(tokens).not.toContain('the');
+        expect(tokens).not.toContain('is');
+        expect(tokens).not.toContain('not');
+        expect(tokens).not.toContain('for');
+    });
+    it('removes domain stop stems', () => {
+        const tokens = extractTokens('missing file implementation documented', []);
+        // "miss", "file", "implement", "document" are all domain stop stems
+        expect(tokens).toEqual([]);
+    });
+    it('excludes anchor strings from tokens', () => {
+        const anchors = ['src/routes/auth.ts'];
+        const tokens = extractTokens('The src/routes/auth.ts file has gmail logic', anchors);
+        // "auth" and "ts" should be excluded since they're part of the anchor path
+        // "gmail" should remain
+        expect(tokens).toContain('gmail');
+    });
+    it('returns stemmed tokens', () => {
+        const tokens = extractTokens('authentication handling validation', []);
+        expect(tokens).toContain('authentic');
+        expect(tokens).toContain('handl');
+        expect(tokens).toContain('valid');
+    });
+    it('returns empty for empty input', () => {
+        expect(extractTokens('', [])).toEqual([]);
+    });
+    it('deduplicates tokens', () => {
+        const tokens = extractTokens('gmail gmail gmail calendar', []);
+        const gmailCount = tokens.filter(t => t === 'gmail').length;
+        expect(gmailCount).toBe(1);
+    });
+});
+// ── tokensOverlap ────────────────────────────────────────────────────
+describe('tokensOverlap', () => {
+    it('finds exact matches', () => {
+        const overlap = tokensOverlap(['gmail', 'calendar'], ['gmail', 'webhook']);
+        expect(overlap).toContain('gmail');
+        expect(overlap).not.toContain('calendar');
+        expect(overlap).not.toContain('webhook');
+    });
+    it('finds prefix matches (4+ chars)', () => {
+        const overlap = tokensOverlap(['auth'], ['authent']);
+        expect(overlap).toContain('auth');
+    });
+    it('prefix matching works in both directions', () => {
+        const overlap = tokensOverlap(['authent'], ['auth']);
+        expect(overlap).toContain('auth');
+    });
+    it('rejects prefix matches shorter than 4 chars', () => {
+        const overlap = tokensOverlap(['foo'], ['foobar']);
+        expect(overlap).toEqual([]);
+    });
+    it('returns empty for no overlap', () => {
+        const overlap = tokensOverlap(['gmail', 'calendar'], ['webhook', 'cron']);
+        expect(overlap).toEqual([]);
+    });
+    it('handles empty inputs', () => {
+        expect(tokensOverlap([], ['gmail'])).toEqual([]);
+        expect(tokensOverlap(['gmail'], [])).toEqual([]);
+    });
+});
+// ── matchGapToSuppression ────────────────────────────────────────────
+describe('matchGapToSuppression', () => {
+    it('returns null on type mismatch', () => {
+        const gap = { type: 'missing-flow', description: 'No auth flow', gapId: 'abc123' };
+        const supp = {
+            gapId: 'abc123',
+            type: 'dead-code',
+            description: 'No auth flow',
+            reason: 'test',
+            suppressedAt: '',
+        };
+        expect(matchGapToSuppression(gap, supp)).toBeNull();
+    });
+    it('returns exact confidence on ID match', () => {
+        const gap = { type: 'missing-flow', description: 'anything', gapId: 'abc12345' };
+        const supp = {
+            gapId: 'abc12345',
+            type: 'missing-flow',
+            description: 'completely different text',
+            reason: 'test',
+            suppressedAt: '',
+        };
+        const result = matchGapToSuppression(gap, supp);
+        expect(result).not.toBeNull();
+        expect(result.confidence).toBe('exact');
+        expect(result.score).toBe(1.0);
+    });
+    it('matches Gmail gap rephrasing (real claudeclaw data)', () => {
+        // Run 1 suppressed gap
+        const supp = {
+            gapId: '870b77bf',
+            type: 'incomplete-flow',
+            description: 'Gmail and Calendar scripts referenced in .env.example but no corresponding implementation files found in source directory',
+            evidence: 'GMAIL_CREDENTIALS_PATH and GOOGLE_CALENDAR_ID referenced in .env.example but no gmail.ts or calendar.ts found in src/',
+            reason: 'User-installed skill dependencies, not core application code',
+            suppressedAt: '2026-03-07T14:20:00Z',
+        };
+        // Run 2 rephrased gap (different description, different gapId)
+        const gap = {
+            type: 'incomplete-flow',
+            gapId: '09fddfd4',
+            description: 'Gmail/Calendar integration scripts missing despite environment configuration referencing them',
+            evidence: '.env.example defines GMAIL_CREDENTIALS_PATH and GOOGLE_CALENDAR_ID but src/ contains no gmail or calendar implementation modules',
+        };
+        const result = matchGapToSuppression(gap, supp);
+        expect(result).not.toBeNull();
+        expect(result.confidence).toBe('medium');
+        expect(result.score).toBeGreaterThanOrEqual(0.55);
+    });
+    it('does not match different gaps about the same file', () => {
+        const supp = {
+            gapId: 'aaa11111',
+            type: 'incomplete-flow',
+            description: 'Error handling in src/routes/auth.ts is incomplete — no try-catch around token verification',
+            evidence: 'src/routes/auth.ts:45-60 has unprotected JWT verification call',
+            reason: 'Known, tracked separately',
+            suppressedAt: '',
+        };
+        const gap = {
+            type: 'incomplete-flow',
+            gapId: 'bbb22222',
+            description: 'Input validation missing in src/routes/auth.ts — no schema validation for login request body',
+            evidence: 'src/routes/auth.ts:20-30 accepts req.body without zod/joi validation',
+        };
+        // These share the file path anchor but describe different issues.
+        // The token content should be different enough to prevent matching.
+        const result = matchGapToSuppression(gap, supp);
+        // They might match on high anchor overlap alone if only 1 anchor each,
+        // but should not reach the threshold since tokens differ significantly
+        if (result !== null) {
+            // If it matches, the score should be below threshold or have too few shared items
+            // This test is defensive — we want no match ideally
+            expect(result.score).toBeLessThan(0.55);
+        }
+    });
+    it('does not match completely different gaps', () => {
+        const supp = {
+            gapId: 'xxx11111',
+            type: 'missing-flow',
+            description: 'No password reset flow exists for user accounts',
+            evidence: 'No reset endpoint or email sending logic found in auth module',
+            reason: 'Planned for v2',
+            suppressedAt: '',
+        };
+        const gap = {
+            type: 'missing-flow',
+            gapId: 'yyy22222',
+            description: 'WebSocket disconnection handling is absent from the chat module',
+            evidence: 'src/chat/websocket.ts has no onclose or reconnection logic',
+        };
+        expect(matchGapToSuppression(gap, supp)).toBeNull();
+    });
+    it('matches short descriptions with shared concept', () => {
+        const supp = {
+            gapId: 'short1',
+            type: 'incomplete-flow',
+            description: 'Gradium TTS provider lacks dedicated implementation file',
+            evidence: 'GRADIUM_API_KEY referenced in .env.example but no gradium.ts module',
+            reason: 'Consolidated in voice.ts',
+            suppressedAt: '',
+        };
+        const gap = {
+            type: 'incomplete-flow',
+            gapId: 'short2',
+            description: 'No dedicated Gradium TTS implementation module exists',
+            evidence: 'GRADIUM_API_KEY and GRADIUM_VOICE_ID in .env.example without corresponding gradium provider file',
+        };
+        const result = matchGapToSuppression(gap, supp);
+        expect(result).not.toBeNull();
+        expect(result.score).toBeGreaterThanOrEqual(0.55);
+    });
+    it('uses pre-computed matchAnchors and matchTokens', () => {
+        const supp = {
+            gapId: 'pre1',
+            type: 'incomplete-flow',
+            description: 'Gmail integration scripts missing',
+            evidence: 'src/gmail.ts not found',
+            reason: 'test',
+            suppressedAt: '',
+            matchAnchors: ['src/gmail.ts'],
+            matchTokens: ['gmail', 'integr', 'script'],
+        };
+        const gap = {
+            type: 'incomplete-flow',
+            gapId: 'pre2',
+            description: 'Gmail integration modules absent from source',
+            evidence: 'Expected src/gmail.ts but not present',
+        };
+        const result = matchGapToSuppression(gap, supp);
+        expect(result).not.toBeNull();
+    });
+    it('returns null when gap has no gapId and no text overlap', () => {
+        const supp = {
+            gapId: 'id1',
+            type: 'dead-code',
+            description: 'Unused helper function in utils',
+            reason: 'test',
+            suppressedAt: '',
+        };
+        const gap = {
+            type: 'dead-code',
+            description: 'Orphaned database migration script',
+        };
+        expect(matchGapToSuppression(gap, supp)).toBeNull();
+    });
+});
+//# sourceMappingURL=gap-matcher.test.js.map

package/dist/lib/__tests__/gap-matcher.test.js.map

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

package/dist/lib/__tests__/gap-suppression.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/__tests__/gap-suppression.test.js

@@ -0,0 +1,168 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { mkdtemp, mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { generateGapId } from '../intent-extractor.js';
+import { addGapSuppression, buildSuppressedGapIdSet, loadOverrides, isGapSuppressed } from '../overrides.js';
+describe('generateGapId', () => {
+    it('produces deterministic 8-char hex', () => {
+        const id1 = generateGapId('missing-flow', 'No password reset flow');
+        const id2 = generateGapId('missing-flow', 'No password reset flow');
+        expect(id1).toBe(id2);
+        expect(id1).toMatch(/^[0-9a-f]{8}$/);
+    });
+    it('produces different IDs for different inputs', () => {
+        const id1 = generateGapId('missing-flow', 'No password reset');
+        const id2 = generateGapId('dead-code', 'Unused helper function');
+        expect(id1).not.toBe(id2);
+    });
+    it('produces different IDs when type differs but description is same', () => {
+        const id1 = generateGapId('missing-flow', 'same description');
+        const id2 = generateGapId('dead-code', 'same description');
+        expect(id1).not.toBe(id2);
+    });
+});
+describe('gap suppression storage', () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await mkdtemp(join(tmpdir(), 'assay-gap-test-'));
+        await mkdir(join(tempDir, '.assay'), { recursive: true });
+    });
+    it('adds a gap suppression to overrides', async () => {
+        await addGapSuppression(tempDir, {
+            gapId: 'abc12345',
+            type: 'missing-flow',
+            description: 'No password reset flow',
+            reason: 'Handled by external auth service',
+        });
+        const overrides = await loadOverrides(tempDir);
+        expect(overrides.gapSuppressions).toHaveLength(1);
+        expect(overrides.gapSuppressions[0].gapId).toBe('abc12345');
+        expect(overrides.gapSuppressions[0].reason).toBe('Handled by external auth service');
+    });
+    it('does not add duplicate gap suppressions', async () => {
+        await addGapSuppression(tempDir, {
+            gapId: 'abc12345',
+            type: 'missing-flow',
+            description: 'test',
+            reason: 'reason 1',
+        });
+        await addGapSuppression(tempDir, {
+            gapId: 'abc12345',
+            type: 'missing-flow',
+            description: 'test',
+            reason: 'reason 2',
+        });
+        const overrides = await loadOverrides(tempDir);
+        expect(overrides.gapSuppressions).toHaveLength(1);
+    });
+    it('preserves existing claim suppressions when adding gap suppression', async () => {
+        // Write existing overrides with claim suppressions
+        await writeFile(join(tempDir, '.assay', 'overrides.json'), JSON.stringify({
+            suppressions: [{
+                    claimId: 'claim001',
+                    file: 'a.ts',
+                    claim: 'test claim',
+                    reason: 'fp',
+                    suppressedAt: '2026-01-01T00:00:00Z',
+                    suppressedBy: 'manual',
+                }],
+        }));
+        await addGapSuppression(tempDir, {
+            gapId: 'gap001',
+            type: 'dead-code',
+            description: 'Unused helper',
+            reason: 'Intentional',
+        });
+        const overrides = await loadOverrides(tempDir);
+        expect(overrides.suppressions).toHaveLength(1);
+        expect(overrides.gapSuppressions).toHaveLength(1);
+    });
+});
+describe('buildSuppressedGapIdSet', () => {
+    it('returns empty set for empty overrides', () => {
+        const set = buildSuppressedGapIdSet({ suppressions: [] });
+        expect(set.size).toBe(0);
+    });
+    it('returns empty set when gapSuppressions is undefined (backward compat)', () => {
+        const set = buildSuppressedGapIdSet({ suppressions: [] });
+        expect(set.size).toBe(0);
+    });
+    it('returns set of suppressed gap IDs', () => {
+        const set = buildSuppressedGapIdSet({
+            suppressions: [],
+            gapSuppressions: [
+                { gapId: 'aaa', type: 'missing-flow', description: 'x', reason: 'y', suppressedAt: '' },
+                { gapId: 'bbb', type: 'dead-code', description: 'x', reason: 'y', suppressedAt: '' },
+            ],
+        });
+        expect(set.size).toBe(2);
+        expect(set.has('aaa')).toBe(true);
+        expect(set.has('bbb')).toBe(true);
+    });
+});
+describe('isGapSuppressed', () => {
+    it('returns exact match for matching gap ID', () => {
+        const result = isGapSuppressed({ type: 'missing-flow', description: 'test', gapId: 'abc123' }, {
+            suppressions: [],
+            gapSuppressions: [
+                { gapId: 'abc123', type: 'missing-flow', description: 'test', reason: 'r', suppressedAt: '' },
+            ],
+        });
+        expect(result).not.toBeNull();
+        expect(result.confidence).toBe('exact');
+    });
+    it('returns null when no suppressions exist', () => {
+        const result = isGapSuppressed({ type: 'missing-flow', description: 'test', gapId: 'abc123' }, { suppressions: [] });
+        expect(result).toBeNull();
+    });
+    it('backward compat: works with old suppressions missing matchAnchors/matchTokens', () => {
+        // Old-format suppression without matchAnchors, matchTokens, or evidence
+        const result = isGapSuppressed({
+            type: 'incomplete-flow',
+            gapId: 'new-id',
+            description: 'Gmail and Calendar scripts referenced in .env.example but no implementation files found',
+            evidence: 'GMAIL_CREDENTIALS_PATH and GOOGLE_CALENDAR_ID in .env.example',
+        }, {
+            suppressions: [],
+            gapSuppressions: [
+                {
+                    gapId: 'old-id',
+                    type: 'incomplete-flow',
+                    description: 'Gmail/Calendar integration scripts missing despite environment configuration',
+                    reason: 'User-installed skills',
+                    suppressedAt: '',
+                    // NO evidence, matchAnchors, or matchTokens — old format
+                },
+            ],
+        });
+        // Should still attempt pattern matching using lazy computation
+        // Whether it matches depends on token overlap — the key test is that it doesn't crash
+        expect(result === null || result.confidence === 'medium').toBe(true);
+    });
+    it('pattern-matches rephrased gap when exact ID fails', () => {
+        const result = isGapSuppressed({
+            type: 'incomplete-flow',
+            gapId: 'different-id',
+            description: 'Gradium TTS provider lacks dedicated implementation module',
+            evidence: 'GRADIUM_API_KEY and GRADIUM_VOICE_ID in .env.example without gradium.ts',
+        }, {
+            suppressions: [],
+            gapSuppressions: [
+                {
+                    gapId: 'original-id',
+                    type: 'incomplete-flow',
+                    description: 'No dedicated Gradium TTS implementation file exists',
+                    evidence: 'GRADIUM_API_KEY referenced in .env.example but no gradium.ts module found',
+                    reason: 'Consolidated in voice.ts',
+                    suppressedAt: '',
+                    matchAnchors: ['gradium.ts'],
+                    matchTokens: ['gradium', 'tts', 'provid', 'dedic', 'lack'],
+                },
+            ],
+        });
+        expect(result).not.toBeNull();
+        expect(result.confidence).toBe('medium');
+    });
+});
+//# sourceMappingURL=gap-suppression.test.js.map

package/dist/lib/__tests__/gap-suppression.test.js.map

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

package/dist/lib/__tests__/output-dir-migration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/__tests__/output-dir-migration.test.js

@@ -0,0 +1,33 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { mkdtemp, mkdir, writeFile, readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { migrateOutputDir } from '../output-dir.js';
+describe('migrateOutputDir', () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await mkdtemp(join(tmpdir(), 'assay-test-'));
+    });
+    it('migrates .assay-assessment/ to .assay/ when only old dir exists', async () => {
+        const oldDir = join(tempDir, '.assay-assessment');
+        await mkdir(oldDir, { recursive: true });
+        await writeFile(join(oldDir, 'assessment-summary.json'), '{"test":true}');
+        const result = await migrateOutputDir(tempDir);
+        expect(result.migrated).toBe(true);
+        const content = await readFile(join(tempDir, '.assay', 'assessment-summary.json'), 'utf-8');
+        expect(JSON.parse(content)).toEqual({ test: true });
+        await expect(stat(oldDir)).rejects.toThrow();
+    });
+    it('does nothing when .assay/ already exists', async () => {
+        const newDir = join(tempDir, '.assay');
+        await mkdir(newDir, { recursive: true });
+        await writeFile(join(newDir, 'data.json'), '{"existing":true}');
+        const result = await migrateOutputDir(tempDir);
+        expect(result.migrated).toBe(false);
+    });
+    it('does nothing when neither directory exists', async () => {
+        const result = await migrateOutputDir(tempDir);
+        expect(result.migrated).toBe(false);
+    });
+});
+//# sourceMappingURL=output-dir-migration.test.js.map

package/dist/lib/__tests__/output-dir-migration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-dir-migration.test.js","sourceRoot":"","sources":["../../../src/lib/__tests__/output-dir-migration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAAE,eAAe,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,yBAAyB,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5F,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvC,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,mBAAmB,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/__tests__/overrides.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/__tests__/overrides.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { mkdtemp, mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { loadOverrides, addSuppression } from '../overrides.js';
+describe('overrides', () => {
+    let tempDir;
+    let assayDir;
+    beforeEach(async () => {
+        tempDir = await mkdtemp(join(tmpdir(), 'assay-test-'));
+        assayDir = join(tempDir, '.assay');
+        await mkdir(assayDir, { recursive: true });
+    });
+    it('returns empty suppressions when no overrides file exists', async () => {
+        const overrides = await loadOverrides(tempDir);
+        expect(overrides.suppressions).toEqual([]);
+    });
+    it('loads existing overrides file', async () => {
+        const data = {
+            suppressions: [
+                {
+                    claimId: 'abc12345',
+                    file: 'a.ts',
+                    claim: 'test',
+                    reason: 'false positive',
+                    suppressedAt: '2026-01-01T00:00:00Z',
+                    suppressedBy: 'manual',
+                },
+            ],
+        };
+        await writeFile(join(assayDir, 'overrides.json'), JSON.stringify(data));
+        const overrides = await loadOverrides(tempDir);
+        expect(overrides.suppressions).toHaveLength(1);
+        expect(overrides.suppressions[0].claimId).toBe('abc12345');
+    });
+    it('adds a suppression and saves', async () => {
+        await addSuppression(tempDir, {
+            claimId: 'def67890',
+            file: 'src/route.ts',
+            claim: 'Route requires auth',
+            reason: 'Intentionally public',
+        });
+        const overrides = await loadOverrides(tempDir);
+        expect(overrides.suppressions).toHaveLength(1);
+        expect(overrides.suppressions[0].claimId).toBe('def67890');
+        expect(overrides.suppressions[0].suppressedBy).toBe('manual');
+    });
+    it('does not add duplicate suppressions', async () => {
+        await addSuppression(tempDir, { claimId: 'aaa11111', file: 'a.ts', claim: 'x', reason: 'y' });
+        await addSuppression(tempDir, { claimId: 'aaa11111', file: 'a.ts', claim: 'x', reason: 'z' });
+        const overrides = await loadOverrides(tempDir);
+        expect(overrides.suppressions).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=overrides.test.js.map

package/dist/lib/__tests__/overrides.test.js.map

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

package/dist/lib/assessment-reporter.js

@@ -3,6 +3,7 @@ import { resolve } from 'node:path';
 import { randomUUID } from 'node:crypto';
 import { MODEL } from './anthropic.js';
 import { getProvider } from './llm-provider.js';
+import { generateClaimId } from './claim-id.js';
 // ── Severity ordering for sort ──────────────────────────────────────
 const SEVERITY_ORDER = {
     critical: 0,
@@ -38,6 +39,7 @@ function collectBugEntries(routeResults, severityMap) {
             entries.push({
                 bug,
                 severity: getBugSeverity(bug, severityMap),
+                flowId: route.requirement.id,
                 route: route.requirement.route,
                 domain: route.requirement.domain,
                 category: claim?.category ?? 'functionality',
@@ -79,10 +81,11 @@ function generateBugReport(entries, repoName, bugCounts) {
         for (const entry of sevEntries) {
             bugNumber++;
             const bugId = `BUG-${String(bugNumber).padStart(3, '0')}`;
+            const claimId = generateClaimId(entry.flowId, entry.bug.claim, entry.bug.evidence[0]?.file ?? '');
             const evidenceLines = entry.bug.evidence.length > 0
                 ? entry.bug.evidence.map((e) => `  - \`${e.file}${e.lineNumber ? ':' + e.lineNumber : ''}\` -- ${e.snippet}`)
                 : ['  - No specific file evidence'];
-            lines.push(`### ${bugId}: ${entry.bug.claim}`, `- **Route:** ${entry.route}`, `- **Domain:** ${entry.domain}`, `- **Category:** ${entry.category}`, `- **Verdict:** ${entry.bug.verdict}`, `- **Evidence:**`, ...evidenceLines, `- **Reasoning:** ${entry.bug.reasoning}`, ``);
+            lines.push(`### ${bugId} [ID: ${claimId}]: ${entry.bug.claim}`, `- **Route:** ${entry.route}`, `- **Domain:** ${entry.domain}`, `- **Category:** ${entry.category}`, `- **Verdict:** ${entry.bug.verdict}`, `- **Suppress:** \`npx tryassay suppress ${claimId}\``, `- **Evidence:**`, ...evidenceLines, `- **Reasoning:** ${entry.bug.reasoning}`, ``);
         }
     }
     if (entries.length === 0) {