import test from 'node:test'; import assert from 'node:assert/strict'; import fs from 'node:fs/promises'; import os from 'node:os'; import path from 'node:path'; import { execFile } from 'node:child_process'; import { promisify } from 'node:util'; const execFileAsync = promisify(execFile); const scriptPath = path.resolve('skills/beadboard-driver/scripts/resolve-bb.mjs'); async function createRepoEntrypoint(repo: string): Promise { await fs.mkdir(path.join(repo, 'tools'), { recursive: true }); if (process.platform === 'win32') { const bbPath = path.join(repo, 'bb.ps1'); await fs.writeFile(bbPath, 'echo ok', 'utf8'); return bbPath; } const bbPath = path.join(repo, 'bin', 'beadboard.js'); await fs.mkdir(path.dirname(bbPath), { recursive: true }); await fs.writeFile(bbPath, '#!/usr/bin/env node\nconsole.log("ok");\n', 'utf8'); await fs.chmod(bbPath, 0o755); return bbPath; } async function runResolve(env: Record = {}) { const { stdout } = await execFileAsync(process.execPath, [scriptPath], { env: { ...process.env, ...env }, }); return JSON.parse(stdout); } async function withTempDir(run: (root: string) => Promise) { const root = await fs.mkdtemp(path.join(os.tmpdir(), 'bb-skill-resolve-')); try { await run(root); } finally { await fs.rm(root, { recursive: true, force: true }); } } test('resolve-bb uses BB_REPO and returns env source', async () => { await withTempDir(async (root) => { const repo = path.join(root, 'beadboard'); const expectedPath = await createRepoEntrypoint(repo); const result = await runResolve({ BB_REPO: repo, BB_SKILL_HOME: path.join(root, 'home'), PATH: '', }); assert.equal(result.ok, true); assert.equal(result.source, 'env'); assert.equal(result.resolved_path, expectedPath); }); }); test('resolve-bb fails with remediation when BB_REPO is invalid', async () => { await withTempDir(async (root) => { const result = await runResolve({ BB_REPO: path.join(root, 'missing'), BB_SKILL_HOME: path.join(root, 'home'), PATH: '', }); assert.equal(result.ok, false); assert.equal(result.source, 'env'); assert.match(result.reason, /BB_REPO/i); assert.match(result.remediation, /Set BB_REPO/i); assert.match(result.remediation, /npm i -g beadboard/i); if (process.platform === 'win32') { assert.match(result.remediation, /install\.ps1/i); } else { assert.match(result.remediation, /install\.sh/i); } }); }); test('resolve-bb uses cache when env and global are unavailable', async () => { await withTempDir(async (root) => { const repo = path.join(root, 'beadboard'); const home = path.join(root, 'home'); const expectedPath = await createRepoEntrypoint(repo); await fs.mkdir(path.join(home, '.beadboard'), { recursive: true }); await fs.writeFile( path.join(home, '.beadboard', 'skill-config.json'), JSON.stringify({ bb_path: expectedPath }, null, 2), 'utf8', ); const result = await runResolve({ BB_SKILL_HOME: home, PATH: '', }); assert.equal(result.ok, true); assert.equal(result.source, 'cache'); }); }); test('resolve-bb discovers repo and self-updates cache', async () => { await withTempDir(async (root) => { const repo = path.join(root, 'workspace', 'beadboard'); const home = path.join(root, 'home'); const expectedPath = await createRepoEntrypoint(repo); const result = await runResolve({ BB_SKILL_HOME: home, BB_SEARCH_ROOTS: path.join(root, 'workspace'), PATH: '', }); assert.equal(result.ok, true); assert.equal(result.source, 'discovery'); const cacheRaw = await fs.readFile(path.join(home, '.beadboard', 'skill-config.json'), 'utf8'); const cache = JSON.parse(cacheRaw); assert.equal(cache.bb_path, expectedPath); }); }); test('resolve-bb uses BB_REPO over cache and rewrites stale cache', async () => { await withTempDir(async (root) => { const repoA = path.join(root, 'repo-a'); const repoB = path.join(root, 'repo-b'); const home = path.join(root, 'home'); const repoAPath = await createRepoEntrypoint(repoA); const repoBPath = await createRepoEntrypoint(repoB); await fs.mkdir(path.join(home, '.beadboard'), { recursive: true }); await fs.writeFile( path.join(home, '.beadboard', 'skill-config.json'), JSON.stringify({ bb_path: repoAPath }, null, 2), 'utf8', ); const result = await runResolve({ BB_REPO: repoB, BB_SKILL_HOME: home, PATH: '', }); assert.equal(result.ok, true); assert.equal(result.source, 'env'); assert.match(result.reason, /cache mismatch/i); const cacheRaw = await fs.readFile(path.join(home, '.beadboard', 'skill-config.json'), 'utf8'); const cache = JSON.parse(cacheRaw); assert.equal(cache.bb_path, repoBPath); }); });