import { describe, test, expect } from 'bun:test'; import { spawnSync } from 'child_process'; import * as fs from 'fs'; import * as os from 'os'; import * as path from 'path'; const ROOT = path.resolve(import.meta.dir, '..'); const BIN = path.join(ROOT, 'bin', 'gstack-paths'); // Invoke via `bash` rather than executing the shebang-script directly. // On Windows, spawnSync(scriptPath, ...) goes through CreateProcess, which // doesn't parse `#!/usr/bin/env bash`. Production usage always sources the // helper from inside a bash block (`eval "$(~/.claude/skills/gstack/bin/gstack-paths)"`) // so bash is always the executor — this matches that contract. // // USERPROFILE: '' is a Windows-specific override. Git Bash auto-populates // HOME from USERPROFILE at shell startup if HOME is unset/empty, which // silently breaks the "HOME unset" test scenarios. Clearing USERPROFILE // alongside HOME prevents that auto-population on Windows runners. function run(env: Record, cwd?: string): Record { const result = spawnSync('bash', [BIN], { env: { PATH: process.env.PATH, USERPROFILE: '', ...env } as Record, encoding: 'utf-8', cwd, }); if (result.status !== 0) { throw new Error(`gstack-paths failed (status ${result.status}): ${result.stderr}`); } const out: Record = {}; for (const line of result.stdout.split('\n')) { const eq = line.indexOf('='); if (eq > 0) out[line.slice(0, eq)] = line.slice(eq + 1); } return out; } describe('gstack-paths', () => { test('GSTACK_HOME wins over CLAUDE_PLUGIN_DATA and HOME', () => { const got = run({ GSTACK_HOME: '/tmp/explicit-state', CLAUDE_PLUGIN_DATA: '/tmp/plugin-data', HOME: '/tmp/home', }); expect(got.GSTACK_STATE_ROOT).toBe('/tmp/explicit-state'); }); test('CLAUDE_PLUGIN_DATA ignored when CLAUDE_PLUGIN_ROOT is absent or non-gstack', () => { // Without CLAUDE_PLUGIN_ROOT, falls through to HOME path. const noRoot = run({ CLAUDE_PLUGIN_DATA: '/tmp/plugin-data', HOME: '/tmp/home' }); expect(noRoot.GSTACK_STATE_ROOT).toBe('/tmp/home/.gstack'); // With a CLAUDE_PLUGIN_ROOT that doesn't contain "gstack" (e.g. the codex plugin), // still falls through to HOME path — this is the cross-plugin contamination scenario. const wrongRoot = run({ CLAUDE_PLUGIN_DATA: '/tmp/codex-data', CLAUDE_PLUGIN_ROOT: '/tmp/openai-codex', HOME: '/tmp/home', }); expect(wrongRoot.GSTACK_STATE_ROOT).toBe('/tmp/home/.gstack'); }); test('CLAUDE_PLUGIN_DATA respected when CLAUDE_PLUGIN_ROOT identifies gstack', () => { const got = run({ CLAUDE_PLUGIN_DATA: '/tmp/gstack-plugin-data', CLAUDE_PLUGIN_ROOT: '/tmp/gstack-garrytan', HOME: '/tmp/home', }); expect(got.GSTACK_STATE_ROOT).toBe('/tmp/gstack-plugin-data'); }); test('HOME-derived state root when GSTACK_HOME and CLAUDE_PLUGIN_DATA unset', () => { const got = run({ HOME: '/tmp/myhome' }); expect(got.GSTACK_STATE_ROOT).toBe('/tmp/myhome/.gstack'); }); test('CWD fallback when HOME also unset (container env)', () => { // Skip on Windows: Git Bash auto-derives HOME from USERPROFILE, // HOMEDRIVE, and HOMEPATH at shell startup. Even with all three // cleared, bash falls back to /c/Users/. The container env // (HOME genuinely unset) is unreachable on Windows runners. The bash // script's CWD fallback IS correct — exercised on Linux/Mac CI. if (process.platform === 'win32') return; const got = run({ HOME: '' }); expect(got.GSTACK_STATE_ROOT).toBe('.gstack'); }); test('PLAN_ROOT chain: GSTACK_PLAN_DIR > CLAUDE_PLANS_DIR > HOME > CWD', () => { expect(run({ GSTACK_PLAN_DIR: '/tmp/explicit', HOME: '/h' }).PLAN_ROOT).toBe('/tmp/explicit'); expect(run({ CLAUDE_PLANS_DIR: '/tmp/claude', HOME: '/h' }).PLAN_ROOT).toBe('/tmp/claude'); expect(run({ HOME: '/tmp/myhome' }).PLAN_ROOT).toBe('/tmp/myhome/.claude/plans'); // CWD fallback only verifiable on POSIX — Git Bash auto-populates HOME. if (process.platform !== 'win32') { expect(run({ HOME: '' }).PLAN_ROOT).toBe('.claude/plans'); } }); test('TMP_ROOT chain: TMPDIR > TMP > .gstack/tmp', () => { expect(run({ TMPDIR: '/tmp/x', HOME: '/h' }).TMP_ROOT).toBe('/tmp/x'); expect(run({ TMP: '/tmp/y', HOME: '/h' }).TMP_ROOT).toBe('/tmp/y'); expect(run({ HOME: '' }).TMP_ROOT).toBe('.gstack/tmp'); }); test('emits all three exports on every invocation', () => { const got = run({ HOME: '/tmp/h' }); expect(got).toHaveProperty('GSTACK_STATE_ROOT'); expect(got).toHaveProperty('GSTACK_ARTIFACTS_ROOT'); expect(got).toHaveProperty('PLAN_ROOT'); expect(got).toHaveProperty('TMP_ROOT'); }); test('artifacts_root=repo writes skill artifacts under the current repo', () => { const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'gstack-artifacts-root-')); const home = path.join(tmp, 'home'); const repo = path.join(tmp, 'repo'); fs.mkdirSync(path.join(home, '.gstack'), { recursive: true }); fs.mkdirSync(repo, { recursive: true }); fs.writeFileSync(path.join(home, '.gstack', 'config.yaml'), 'artifacts_root: repo\n'); spawnSync('git', ['init'], { cwd: repo, encoding: 'utf-8' }); const got = run({ HOME: home }, repo); expect(got.GSTACK_STATE_ROOT).toBe(path.join(home, '.gstack')); expect(got.GSTACK_ARTIFACTS_ROOT).toBe(path.join(fs.realpathSync(repo), '.gstack')); }); test('SLUG_SETUP uses GSTACK_ARTIFACTS_ROOT instead of hardcoded ~/.gstack', async () => { const { generateSlugEval, generateSlugSetup } = await import('../scripts/resolvers/utility'); const ctx = { skillName: 'test-skill', tmplPath: 'test/SKILL.md.tmpl', host: 'claude', paths: { skillRoot: '~/.claude/skills/gstack', localSkillRoot: '.claude/skills/gstack', binDir: '~/.claude/skills/gstack/bin', browseDir: '~/.claude/skills/gstack/browse/dist', designDir: '~/.claude/skills/gstack/design/dist', makePdfDir: '~/.claude/skills/gstack/make-pdf/dist', }, } as const; const rendered = generateSlugSetup({ ...ctx, }); const evalRendered = generateSlugEval({ ...ctx }); expect(rendered).toContain('gstack-paths'); expect(rendered).toContain('"$GSTACK_ARTIFACTS_ROOT/projects/$SLUG"'); expect(evalRendered).toContain('gstack-paths'); expect(evalRendered).toContain('PROJECT_DIR="$GSTACK_ARTIFACTS_ROOT/projects/$SLUG"'); expect(rendered).not.toContain('~/.gstack/projects/$SLUG'); }); test('output is shell-evalable: only KEY=VALUE lines, no extra prose', () => { const result = spawnSync('bash', [BIN], { env: { PATH: process.env.PATH, USERPROFILE: '', HOME: '/tmp/h' } as Record, encoding: 'utf-8', }); const lines = result.stdout.split('\n').filter(Boolean); for (const line of lines) { expect(line).toMatch(/^[A-Z_]+=.*/); } }); });