@madmatt112org/spec-workflow-mcp 3.0.0

package/dist/core/__tests__/git-utils.test.js

@@ -0,0 +1,179 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { execSync } from 'child_process';
+import { resolveGitRoot, resolveGitWorkspaceRoot, isGitWorktree, SPEC_WORKFLOW_SHARED_ROOT_ENV } from '../git-utils.js';
+// Mock child_process
+vi.mock('child_process', () => ({
+    execSync: vi.fn()
+}));
+const mockedExecSync = vi.mocked(execSync);
+describe('resolveGitRoot', () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        delete process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV];
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+    });
+    describe('explicit env var override', () => {
+        it('should use SPEC_WORKFLOW_SHARED_ROOT when set', () => {
+            process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV] = '/custom/root';
+            const result = resolveGitRoot('/some/project');
+            expect(result).toBe('/custom/root');
+            expect(mockedExecSync).not.toHaveBeenCalled();
+        });
+        it('should trim whitespace from env var', () => {
+            process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV] = '  /custom/root  ';
+            const result = resolveGitRoot('/some/project');
+            expect(result).toBe('/custom/root');
+        });
+        it('should ignore empty env var', () => {
+            process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV] = '';
+            mockedExecSync.mockReturnValue('.git');
+            const result = resolveGitRoot('/some/project');
+            expect(result).toBe('/some/project');
+            expect(mockedExecSync).toHaveBeenCalled();
+        });
+        it('should ignore whitespace-only env var', () => {
+            process.env[SPEC_WORKFLOW_SHARED_ROOT_ENV] = '   ';
+            mockedExecSync.mockReturnValue('.git');
+            const result = resolveGitRoot('/some/project');
+            expect(result).toBe('/some/project');
+            expect(mockedExecSync).toHaveBeenCalled();
+        });
+    });
+    describe('main git repository', () => {
+        it('should return original path when in main repo', () => {
+            mockedExecSync.mockReturnValue('.git');
+            const result = resolveGitRoot('/main/repo');
+            expect(result).toBe('/main/repo');
+        });
+        it('should return original path when git returns ".git" with newline', () => {
+            mockedExecSync.mockReturnValue('.git\n');
+            const result = resolveGitRoot('/main/repo');
+            expect(result).toBe('/main/repo');
+        });
+    });
+    describe('git worktree', () => {
+        it('should return main repo path when in worktree (Unix-style path)', () => {
+            mockedExecSync.mockReturnValue('/home/user/main-repo/.git');
+            const result = resolveGitRoot('/home/user/worktree');
+            expect(result).toBe('/home/user/main-repo');
+        });
+        it('should return main repo path when git returns worktree subfolder', () => {
+            mockedExecSync.mockReturnValue('/home/user/main-repo/.git/worktrees/feature-branch');
+            const result = resolveGitRoot('/home/user/worktree');
+            expect(result).toBe('/home/user/main-repo');
+        });
+        it('should handle Windows-style paths', () => {
+            mockedExecSync.mockReturnValue('C:/Users/dev/main-repo/.git');
+            const result = resolveGitRoot('C:/Users/dev/worktree');
+            expect(result).toBe('C:/Users/dev/main-repo');
+        });
+    });
+    describe('subdirectory with relative path', () => {
+        it('should resolve relative path when git returns relative .git path', () => {
+            // When running from a subdirectory, git returns relative paths like "../../.git"
+            mockedExecSync.mockReturnValue('../../.git');
+            const result = resolveGitRoot('/home/user/repo/src/core');
+            // Should resolve to the main repo path, not return "../.." which would fail path traversal check
+            expect(result).toBe('/home/user/repo');
+        });
+        it('should resolve deeply nested relative path', () => {
+            mockedExecSync.mockReturnValue('../../../.git');
+            const result = resolveGitRoot('/home/user/repo/src/lib/utils');
+            expect(result).toBe('/home/user/repo');
+        });
+        it('should resolve single level relative path', () => {
+            mockedExecSync.mockReturnValue('../.git');
+            const result = resolveGitRoot('/home/user/repo/src');
+            expect(result).toBe('/home/user/repo');
+        });
+    });
+    describe('error handling', () => {
+        it('should return original path when git command fails', () => {
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('not a git repository');
+            });
+            const result = resolveGitRoot('/not/a/git/repo');
+            expect(result).toBe('/not/a/git/repo');
+        });
+        it('should return original path when git is not installed', () => {
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('git: command not found');
+            });
+            const result = resolveGitRoot('/some/path');
+            expect(result).toBe('/some/path');
+        });
+        it('should return original path on timeout', () => {
+            mockedExecSync.mockImplementation(() => {
+                const error = new Error('timeout');
+                error.killed = true;
+                throw error;
+            });
+            const result = resolveGitRoot('/some/path');
+            expect(result).toBe('/some/path');
+        });
+    });
+    describe('execSync configuration', () => {
+        it('should call git with correct options', () => {
+            mockedExecSync.mockReturnValue('.git');
+            resolveGitRoot('/test/path');
+            expect(mockedExecSync).toHaveBeenCalledWith('git rev-parse --git-common-dir', expect.objectContaining({
+                cwd: '/test/path',
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 5000
+            }));
+        });
+    });
+});
+describe('resolveGitWorkspaceRoot', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should return workspace root from git when available', () => {
+        mockedExecSync.mockReturnValue('/home/user/repo\n');
+        const result = resolveGitWorkspaceRoot('/home/user/repo/src/components');
+        expect(result).toBe('/home/user/repo');
+        expect(mockedExecSync).toHaveBeenCalledWith('git rev-parse --show-toplevel', expect.objectContaining({
+            cwd: '/home/user/repo/src/components',
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 5000
+        }));
+    });
+    it('should return original path when git fails', () => {
+        mockedExecSync.mockImplementation(() => {
+            throw new Error('not a git repository');
+        });
+        const result = resolveGitWorkspaceRoot('/not/a/repo');
+        expect(result).toBe('/not/a/repo');
+    });
+});
+describe('isGitWorktree', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should return false when in main repo', () => {
+        mockedExecSync.mockReturnValue('.git');
+        expect(isGitWorktree('/main/repo')).toBe(false);
+    });
+    it('should return true when in worktree', () => {
+        mockedExecSync.mockReturnValue('/home/user/main-repo/.git');
+        expect(isGitWorktree('/home/user/worktree')).toBe(true);
+    });
+    it('should return false when not a git repo', () => {
+        mockedExecSync.mockImplementation(() => {
+            throw new Error('not a git repository');
+        });
+        expect(isGitWorktree('/not/a/repo')).toBe(false);
+    });
+    it('should return false when git is not available', () => {
+        mockedExecSync.mockImplementation(() => {
+            throw new Error('git: command not found');
+        });
+        expect(isGitWorktree('/some/path')).toBe(false);
+    });
+});
+//# sourceMappingURL=git-utils.test.js.map

package/dist/core/__tests__/git-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.test.js","sourceRoot":"","sources":["../../../src/core/__tests__/git-utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,6BAA6B,EAC9B,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;CAClB,CAAC,CAAC,CAAC;AAEJ,MAAM,cAAc,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAE3C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAEvC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,GAAG,cAAc,CAAC;YAE5D,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;YAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACpC,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,GAAG,kBAAkB,CAAC;YAEhE,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;YAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,GAAG,EAAE,CAAC;YAChD,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAEvC,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;YAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACrC,MAAM,CAAC,cAAc,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,GAAG,KAAK,CAAC;YACnD,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAEvC,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;YAE/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACrC,MAAM,CAAC,cAAc,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAEvC,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;YAE5C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;YAC1E,cAAc,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEzC,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;YAE5C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACzE,cAAc,CAAC,eAAe,CAAC,2BAA2B,CAAC,CAAC;YAE5D,MAAM,MAAM,GAAG,cAAc,CAAC,qBAAqB,CAAC,CAAC;YAErD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;YAC1E,cAAc,CAAC,eAAe,CAAC,oDAAoD,CAAC,CAAC;YAErF,MAAM,MAAM,GAAG,cAAc,CAAC,qBAAqB,CAAC,CAAC;YAErD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,cAAc,CAAC,eAAe,CAAC,6BAA6B,CAAC,CAAC;YAE9D,MAAM,MAAM,GAAG,cAAc,CAAC,uBAAuB,CAAC,CAAC;YAEvD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC/C,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;YAC1E,iFAAiF;YACjF,cAAc,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,cAAc,CAAC,0BAA0B,CAAC,CAAC;YAE1D,iGAAiG;YACjG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,cAAc,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAEhD,MAAM,MAAM,GAAG,cAAc,CAAC,+BAA+B,CAAC,CAAC;YAE/D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,cAAc,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAE1C,MAAM,MAAM,GAAG,cAAc,CAAC,qBAAqB,CAAC,CAAC;YAErD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,cAAc,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBACrC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;YAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,cAAc,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBACrC,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;YAE5C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,cAAc,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBACrC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;gBAClC,KAAa,CAAC,MAAM,GAAG,IAAI,CAAC;gBAC7B,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;YAE5C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAEvC,cAAc,CAAC,YAAY,CAAC,CAAC;YAE7B,MAAM,CAAC,cAAc,CAAC,CAAC,oBAAoB,CACzC,gCAAgC,EAChC,MAAM,CAAC,gBAAgB,CAAC;gBACtB,GAAG,EAAE,YAAY;gBACjB,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;gBAC/B,OAAO,EAAE,IAAI;aACd,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,cAAc,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAG,uBAAuB,CAAC,gCAAgC,CAAC,CAAC;QAEzE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,CAAC,oBAAoB,CACzC,+BAA+B,EAC/B,MAAM,CAAC,gBAAgB,CAAC;YACtB,GAAG,EAAE,gCAAgC;YACrC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO,EAAE,IAAI;SACd,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,cAAc,CAAC,kBAAkB,CAAC,GAAG,EAAE;YACrC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,uBAAuB,CAAC,aAAa,CAAC,CAAC;QAEtD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAEvC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,cAAc,CAAC,eAAe,CAAC,2BAA2B,CAAC,CAAC;QAE5D,MAAM,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,cAAc,CAAC,kBAAkB,CAAC,GAAG,EAAE;YACrC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,cAAc,CAAC,kBAAkB,CAAC,GAAG,EAAE;YACrC,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/__tests__/hygiene-signals.test.d.ts

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

package/dist/core/__tests__/hygiene-signals.test.d.ts.map

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

package/dist/core/__tests__/hygiene-signals.test.js

@@ -0,0 +1,200 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { performance } from 'perf_hooks';
+import { computeHygieneSignals } from '../hygiene-signals.js';
+describe('computeHygieneSignals', () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(join(tmpdir(), 'hygiene-signals-test-'));
+    });
+    afterEach(async () => {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    it('(a) returns one console signal and one todo signal with correct line numbers', async () => {
+        const file = join(tempDir, 'a.ts');
+        await fs.writeFile(file, [
+            'function foo() {',
+            "  console.log('hi');",
+            '  return 1;',
+            '  // TODO: refactor',
+            '}',
+        ].join('\n'));
+        const signals = await computeHygieneSignals([file]);
+        expect(signals).toHaveLength(2);
+        const consoleSig = signals.find(s => s.pattern === 'console');
+        const todoSig = signals.find(s => s.pattern === 'todo');
+        expect(consoleSig.line).toBe(2);
+        expect(consoleSig.file).toBe(file);
+        expect(todoSig.line).toBe(4);
+        expect(todoSig.file).toBe(file);
+    });
+    it('(b) returns a debugger signal', async () => {
+        const file = join(tempDir, 'b.ts');
+        await fs.writeFile(file, ['let x = 1;', 'debugger;', 'x++;'].join('\n'));
+        const signals = await computeHygieneSignals([file]);
+        expect(signals).toHaveLength(1);
+        expect(signals[0].pattern).toBe('debugger');
+        expect(signals[0].line).toBe(2);
+    });
+    it('(c) lowercase todo produces no signal (case sensitivity)', async () => {
+        const file = join(tempDir, 'c.ts');
+        await fs.writeFile(file, [
+            '// todo: not a real todo marker',
+            '// fixme: also lowercase, ignored',
+        ].join('\n'));
+        const signals = await computeHygieneSignals([file]);
+        expect(signals).toHaveLength(0);
+    });
+    it('(d) missing file path is skipped without throwing; remaining files still scanned', async () => {
+        const real = join(tempDir, 'real.ts');
+        await fs.writeFile(real, 'console.log("x");');
+        const missing = join(tempDir, 'does-not-exist.ts');
+        const signals = await computeHygieneSignals([missing, real]);
+        expect(signals).toHaveLength(1);
+        expect(signals[0].file).toBe(real);
+        expect(signals[0].pattern).toBe('console');
+    });
+    it('(e) oversize file is skipped without reading; other files still scanned', async () => {
+        const oversize = join(tempDir, 'big.ts');
+        const small = join(tempDir, 'small.ts');
+        await fs.writeFile(oversize, 'console.log("oversize");');
+        await fs.writeFile(small, 'console.log("small");');
+        // Test-local mock isolated to this case via vi.doMock + module reset.
+        // The ESM limitation in vitest prevents vi.spyOn on the 'fs/promises'
+        // namespace ("Cannot redefine property"), so we scope a fresh module
+        // instance with a stat stub and a readFile spy, and unmock afterward
+        // so other tests in this file use the real fs module.
+        vi.resetModules();
+        vi.doMock('fs/promises', async () => {
+            const actual = await vi.importActual('fs/promises');
+            return {
+                ...actual,
+                stat: vi.fn(async (p) => {
+                    if (String(p) === oversize)
+                        return { size: 1024 * 1024 + 1 };
+                    return actual.stat(p);
+                }),
+                readFile: vi.fn((...args) => actual.readFile(...args)),
+            };
+        });
+        try {
+            const { computeHygieneSignals: scoped } = await import('../hygiene-signals.js');
+            const fsp = await import('fs/promises');
+            const readFileSpy = vi.mocked(fsp.readFile);
+            readFileSpy.mockClear();
+            const signals = await scoped([oversize, small]);
+            const readFilePaths = readFileSpy.mock.calls.map(c => String(c[0]));
+            expect(readFilePaths).not.toContain(oversize);
+            expect(readFilePaths).toContain(small);
+            expect(signals).toHaveLength(1);
+            expect(signals[0].file).toBe(small);
+        }
+        finally {
+            vi.doUnmock('fs/promises');
+            vi.resetModules();
+        }
+    });
+    it('(f) signals are ordered within each file ascending by line number', async () => {
+        const file1 = join(tempDir, 'f1.ts');
+        const file2 = join(tempDir, 'f2.ts');
+        await fs.writeFile(file1, [
+            '// TODO: one',
+            'console.log(1);',
+            '// FIXME: three',
+            'debugger;',
+        ].join('\n'));
+        await fs.writeFile(file2, [
+            'debugger;',
+            '// TODO: two',
+        ].join('\n'));
+        const signals = await computeHygieneSignals([file1, file2]);
+        const f1Lines = signals.filter(s => s.file === file1).map(s => s.line);
+        const f2Lines = signals.filter(s => s.file === file2).map(s => s.line);
+        expect(f1Lines).toEqual([...f1Lines].sort((a, b) => a - b));
+        expect(f2Lines).toEqual([...f2Lines].sort((a, b) => a - b));
+        expect(f1Lines).toEqual([1, 2, 3, 4]);
+        expect(f2Lines).toEqual([1, 2]);
+    });
+    it('(g) a single line matching two patterns produces two signals on the same (file, line)', async () => {
+        const file = join(tempDir, 'double.ts');
+        await fs.writeFile(file, '// TODO: remove console.log(x)');
+        const signals = await computeHygieneSignals([file]);
+        expect(signals).toHaveLength(2);
+        expect(signals.every(s => s.file === file && s.line === 1)).toBe(true);
+        const patterns = signals.map(s => s.pattern).sort();
+        expect(patterns).toEqual(['console', 'todo']);
+    });
+    it('(i) denylisted files are not scanned and produce no signals', async () => {
+        const lockfile = join(tempDir, 'package-lock.json');
+        const envFile = join(tempDir, '.env');
+        const minified = join(tempDir, 'bundle.min.js');
+        const real = join(tempDir, 'real.ts');
+        await fs.writeFile(lockfile, '// TODO: lockfile content with marker');
+        await fs.writeFile(envFile, '// TODO: secret-bearing');
+        await fs.writeFile(minified, 'console.log("min");');
+        await fs.writeFile(real, 'console.log("real");');
+        vi.resetModules();
+        vi.doMock('fs/promises', async () => {
+            const actual = await vi.importActual('fs/promises');
+            return {
+                ...actual,
+                stat: vi.fn((...args) => actual.stat(...args)),
+                readFile: vi.fn((...args) => actual.readFile(...args)),
+            };
+        });
+        try {
+            const { computeHygieneSignals: scoped } = await import('../hygiene-signals.js');
+            const fsp = await import('fs/promises');
+            const readFileSpy = vi.mocked(fsp.readFile);
+            readFileSpy.mockClear();
+            const signals = await scoped([lockfile, envFile, minified, real]);
+            const readFilePaths = readFileSpy.mock.calls.map(c => String(c[0]));
+            expect(readFilePaths).not.toContain(lockfile);
+            expect(readFilePaths).not.toContain(envFile);
+            expect(readFilePaths).not.toContain(minified);
+            expect(readFilePaths).toContain(real);
+            expect(signals).toHaveLength(1);
+            expect(signals[0].file).toBe(real);
+        }
+        finally {
+            vi.doUnmock('fs/promises');
+            vi.resetModules();
+        }
+    });
+    it('(h) scans 50 files of 500 lines each in under 200ms', async () => {
+        const files = [];
+        let expectedTodos = 0;
+        let expectedConsole = 0;
+        for (let i = 0; i < 50; i++) {
+            const file = join(tempDir, `perf-${i}.ts`);
+            const lines = [];
+            for (let j = 0; j < 500; j++) {
+                if (j % 100 === 0) {
+                    lines.push(`// TODO: line ${j}`);
+                    expectedTodos++;
+                }
+                else if (j % 137 === 0) {
+                    lines.push(`console.log(${j});`);
+                    expectedConsole++;
+                }
+                else {
+                    lines.push(`const v${j} = ${j};`);
+                }
+            }
+            await fs.writeFile(file, lines.join('\n'));
+            files.push(file);
+        }
+        const start = performance.now();
+        const signals = await computeHygieneSignals(files);
+        const elapsed = performance.now() - start;
+        // Strong count assertion catches a regex regression that would otherwise
+        // pass a `> 0` check while silently dropping one of the patterns.
+        expect(signals).toHaveLength(expectedTodos + expectedConsole);
+        expect(signals.filter(s => s.pattern === 'todo')).toHaveLength(expectedTodos);
+        expect(signals.filter(s => s.pattern === 'console')).toHaveLength(expectedConsole);
+        expect(elapsed).toBeLessThan(200);
+    });
+});
+//# sourceMappingURL=hygiene-signals.test.js.map

package/dist/core/__tests__/hygiene-signals.test.js.map

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

package/dist/core/__tests__/mdx-validator.test.d.ts

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

package/dist/core/__tests__/mdx-validator.test.d.ts.map

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

package/dist/core/__tests__/mdx-validator.test.js

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { validateMarkdownForMdx, formatMdxValidationIssues } from '../mdx-validator.js';
+describe('mdx-validator', () => {
+    it('returns invalid when mdx pre-render (compile) fails', async () => {
+        const content = `# Metrics\n\n- Threshold: <5%\n`;
+        const result = await validateMarkdownForMdx(content);
+        expect(result.valid).toBe(false);
+        expect(result.issues.length).toBeGreaterThan(0);
+        expect(result.issues.some((issue) => issue.ruleId === 'mdx-compile-error')).toBe(true);
+        expect(result.issues[0].message).toContain('Unexpected character');
+    });
+    it('ignores less-than inside inline code and fenced code blocks', async () => {
+        const content = [
+            '# Safe',
+            '',
+            '- Inline code: `<5%`',
+            '',
+            '```md',
+            '- Code block: <5%',
+            '```',
+            ''
+        ].join('\n');
+        const result = await validateMarkdownForMdx(content);
+        expect(result.valid).toBe(true);
+        expect(result.issues).toHaveLength(0);
+    });
+    it('formats issues with line and column', () => {
+        const formatted = formatMdxValidationIssues([
+            {
+                line: 12,
+                column: 18,
+                ruleId: 'mdx-compile-error',
+                message: 'Unexpected character',
+                severity: 'error'
+            }
+        ]);
+        expect(formatted).toEqual([
+            'Line 12:18 [mdx-compile-error] Unexpected character'
+        ]);
+    });
+});
+//# sourceMappingURL=mdx-validator.test.js.map

package/dist/core/__tests__/mdx-validator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-validator.test.js","sourceRoot":"","sources":["../../../src/core/__tests__/mdx-validator.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAExF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,OAAO,GAAG,iCAAiC,CAAC;QAElD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,OAAO,GAAG;YACd,QAAQ;YACR,EAAE;YACF,sBAAsB;YACtB,EAAE;YACF,OAAO;YACP,mBAAmB;YACnB,KAAK;YACL,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAErD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,SAAS,GAAG,yBAAyB,CAAC;YAC1C;gBACE,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,mBAAmB;gBAC3B,OAAO,EAAE,sBAAsB;gBAC/B,QAAQ,EAAE,OAAO;aAClB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;YACxB,qDAAqD;SACtD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/__tests__/path-denylist.test.d.ts

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

package/dist/core/__tests__/path-denylist.test.d.ts.map

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