import { describe, test, expect } from 'bun:test'; import { spawnSync } from 'child_process'; import * as path from 'path'; import * as fs from 'fs'; import * as os from 'os'; const ROOT = path.resolve(import.meta.dir, '..'); const SETUP_SCRIPT = path.join(ROOT, 'setup'); const SETUP_SRC = fs.readFileSync(SETUP_SCRIPT, 'utf-8'); // Slice out the _link_or_copy helper body via awk-style anchors so the test is // resilient to line-number drift. function extractHelper(): string { const start = SETUP_SRC.indexOf('_link_or_copy() {'); const end = SETUP_SRC.indexOf('\n}\n', start); if (start < 0 || end < 0) throw new Error('Could not locate _link_or_copy() in setup'); return SETUP_SRC.slice(start, end + 2); } describe('setup: _link_or_copy invariant (D7)', () => { test('helper function is defined near the top of setup', () => { expect(SETUP_SRC).toContain('_link_or_copy() {'); expect(SETUP_SRC).toContain('if [ "$IS_WINDOWS" -eq 1 ]; then'); }); test('zero raw `ln` calls outside the helper body and comments', () => { // Pull the helper body out of the source first so its internal `ln -snf` // (the Unix branch) is exempted from the invariant. const helper = extractHelper(); const withoutHelper = SETUP_SRC.replace(helper, ''); // Strip shell comments to allow prose mentions of `ln -snf` in docstrings. const lines = withoutHelper.split('\n'); const offending: { lineNo: number; line: string }[] = []; lines.forEach((line, idx) => { const trimmed = line.trim(); if (trimmed.startsWith('#')) return; // Match standalone `ln ` invocations (allow `ln` as a substring in // variable names like `linked`, `_LINK`). if (/(^|[\s;&|`])ln\s+-/.test(line)) { offending.push({ lineNo: idx + 1, line: line.trim() }); } }); expect(offending).toEqual([]); }); test('Windows junction/fallback note message exists in setup', () => { expect(SETUP_SRC).toContain('Windows install uses directory junctions when available'); expect(SETUP_SRC).toContain('_print_windows_copy_note_once'); }); test('Windows directory branch tries mklink junctions before copying', () => { const helper = extractHelper(); expect(helper).toContain('cmd.exe /c mklink /J'); expect(helper).toContain('cygpath -w "$src"'); expect(helper.indexOf('cmd.exe /c mklink /J')).toBeLessThan(helper.indexOf('cp -R "$src" "$dst"')); }); test('link_claude_skill_dirs calls the Windows note printer', () => { const fnStart = SETUP_SRC.indexOf('link_claude_skill_dirs() {'); const fnEnd = SETUP_SRC.indexOf('\n}\n', fnStart); const fnBody = SETUP_SRC.slice(fnStart, fnEnd); expect(fnBody).toContain('_print_windows_copy_note_once'); }); }); // Behavior matrix uses Unix `ln -snf` semantics in the IS_WINDOWS=0 cells. // On Windows-without-Developer-Mode (e.g. GitHub's free `windows-latest` // runner), `ln -snf` silently produces a file copy rather than a symlink — // that's literally the bug this helper exists to work around. Skip the whole // matrix on Windows; the static-invariant tests above already pin the helper // shape that the Windows install relies on. describe.skipIf(process.platform === 'win32')('setup: _link_or_copy helper — behavior matrix', () => { // Source the helper into a temp shell with IS_WINDOWS set and exercise // each cell of the file/dir × Windows/Unix matrix. function runHelper( isWindows: '0' | '1', srcKind: 'file' | 'dir', opts: { fakeJunction?: boolean } = {}, ): { ok: boolean; targetIsSymlink: boolean; targetExists: boolean; stderr: string } { const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'gstack-helper-')); try { const src = path.join(tmp, 'source'); const dst = path.join(tmp, 'dest'); const bindir = path.join(tmp, 'bin'); if (srcKind === 'file') { fs.writeFileSync(src, 'hello\n'); } else { fs.mkdirSync(src); fs.writeFileSync(path.join(src, 'inner.txt'), 'hello\n'); } let env = process.env; if (opts.fakeJunction) { fs.mkdirSync(bindir); const cygpath = `#!/bin/sh\nif [ "$1" = "-w" ]; then echo "$2"; exit 0; fi\nexit 1\n`; const cmd = `#!/bin/sh\nif [ "$1" = "/c" ] && [ "$2" = "mklink" ] && [ "$3" = "/J" ]; then\n ln -s "$5" "$4"\n exit 0\nfi\nexit 1\n`; fs.writeFileSync(path.join(bindir, 'cygpath'), cygpath); fs.writeFileSync(path.join(bindir, 'cmd.exe'), cmd); fs.chmodSync(path.join(bindir, 'cygpath'), 0o755); fs.chmodSync(path.join(bindir, 'cmd.exe'), 0o755); env = { ...process.env, PATH: `${bindir}:${process.env.PATH || ''}` }; } const helper = extractHelper(); // IS_WINDOWS must exist as a shell-readable var before sourcing. const script = `IS_WINDOWS=${isWindows}\n${helper}\n_link_or_copy "${src}" "${dst}"\n`; const result = spawnSync('bash', ['-c', script], { encoding: 'utf-8', timeout: 5000, env, }); const lst = fs.lstatSync(dst, { throwIfNoEntry: false }); return { ok: result.status === 0, targetIsSymlink: lst?.isSymbolicLink() ?? false, targetExists: lst !== undefined, stderr: result.stderr, }; } finally { fs.rmSync(tmp, { recursive: true, force: true }); } } test('IS_WINDOWS=0 + file → symlink (existing Unix behavior)', () => { const r = runHelper('0', 'file'); expect(r.ok).toBe(true); expect(r.targetExists).toBe(true); expect(r.targetIsSymlink).toBe(true); }); test('IS_WINDOWS=0 + dir → symlink', () => { const r = runHelper('0', 'dir'); expect(r.ok).toBe(true); expect(r.targetIsSymlink).toBe(true); }); test('IS_WINDOWS=1 + file → regular file copy (no symlink)', () => { const r = runHelper('1', 'file'); expect(r.ok).toBe(true); expect(r.targetExists).toBe(true); expect(r.targetIsSymlink).toBe(false); }); test('IS_WINDOWS=1 + dir → junction when cmd/cygpath succeed', () => { const r = runHelper('1', 'dir', { fakeJunction: true }); expect(r.ok).toBe(true); expect(r.targetExists).toBe(true); expect(r.targetIsSymlink).toBe(true); }); test('IS_WINDOWS=1 + dir → real directory copy when junction is unavailable', () => { const r = runHelper('1', 'dir'); expect(r.ok).toBe(true); expect(r.targetExists).toBe(true); expect(r.targetIsSymlink).toBe(false); }); });