singularity-forge/scripts/link-workspace-packages.cjs

#!/usr/bin/env node
/**
 * link-workspace-packages.cjs
 *
 * Creates node_modules/@gsd/* and node_modules/@gsd-build/* symlinks pointing
 * to shipped packages/* directories.
 *
 * During development, npm workspaces creates these automatically. But in the
 * published tarball, workspace packages are shipped under packages/ (via the
 * "files" field) and the @gsd/* imports in compiled code need node_modules/@gsd/*
 * to resolve. This script bridges the gap.
 *
 * Runs as part of postinstall (before any ESM code that imports @gsd/*).
 *
 * On Windows without Developer Mode or administrator rights, creating symlinks
 * (even NTFS junctions) can fail with EPERM. In that case we fall back to
 * cpSync (directory copy) which works universally.
 */
const { existsSync, mkdirSync, symlinkSync, cpSync, lstatSync, readlinkSync, unlinkSync } = require('fs')
const { resolve, join } = require('path')

const root = resolve(__dirname, '..')
const packagesDir = join(root, 'packages')
const scopeDirs = {
  '@gsd': join(root, 'node_modules', '@gsd'),
  '@gsd-build': join(root, 'node_modules', '@gsd-build'),
}

// Map directory names to scoped package names
const packageMap = {
  'native': { scope: '@gsd', name: 'native' },
  'pi-agent-core': { scope: '@gsd', name: 'pi-agent-core' },
  'pi-ai': { scope: '@gsd', name: 'pi-ai' },
  'pi-coding-agent': { scope: '@gsd', name: 'pi-coding-agent' },
  'pi-tui': { scope: '@gsd', name: 'pi-tui' },
  'rpc-client': { scope: '@gsd-build', name: 'rpc-client' },
}

for (const scopeDir of Object.values(scopeDirs)) {
  if (!existsSync(scopeDir)) {
    mkdirSync(scopeDir, { recursive: true })
  }
}

let linked = 0
let copied = 0
for (const [dir, pkg] of Object.entries(packageMap)) {
  const source = join(packagesDir, dir)
  const scopeDir = scopeDirs[pkg.scope]
  const target = join(scopeDir, pkg.name)

  if (!existsSync(source)) continue

  // Skip if already correctly linked or is a real directory (bundled)
  if (existsSync(target)) {
    try {
      const stat = lstatSync(target)
      if (stat.isSymbolicLink()) {
        const linkTarget = readlinkSync(target)
        if (resolve(join(scopeDir, linkTarget)) === source || linkTarget === source) {
          continue // Already correct
        }
        unlinkSync(target) // Wrong target, relink
      } else {
        continue // Real directory (e.g., copied or from bundleDependencies), don't touch
      }
    } catch {
      continue
    }
  }

  let symlinkOk = false
  try {
    symlinkSync(source, target, 'junction') // junction works on Windows too
    symlinkOk = true
    linked++
  } catch {
    // Symlink failed — common on Windows without Developer Mode or admin rights.
    // Fall back to a directory copy so the package is still resolvable.
  }

  if (!symlinkOk) {
    try {
      cpSync(source, target, { recursive: true })
      copied++
    } catch {
      // Non-fatal — loader.ts will emit a clearer error if resolution still fails
    }
  }
}

if (linked > 0) process.stderr.write(`  Linked ${linked} workspace package${linked !== 1 ? 's' : ''}\n`)
if (copied > 0) process.stderr.write(`  Copied ${copied} workspace package${copied !== 1 ? 's' : ''} (symlinks unavailable)\n`)