@saluzi/saluzi-edu 0.2.7 → 0.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saluzi/saluzi-edu",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Saluzi CLI - interactive AI coding assistant in the terminal",
   "license": "MIT",
   "type": "module",
@@ -29,7 +29,6 @@
   "files": [
     "dist",
     "scripts/acp-link.mjs",
-    "scripts/postinstall.cjs",
     "scripts/run-parallel.mjs",
     "packages/remote-control-server/src",
     "packages/remote-control-server/web/dist",
@@ -58,7 +57,6 @@
     "check:bundle": "bun run scripts/check-bundle-integrity.ts",
     "check:unused": "knip-bun",
     "health": "bun run scripts/health-check.ts",
-    "postinstall": "node scripts/postinstall.cjs",
     "docs:dev": "npx mintlify dev",
     "typecheck": "tsc --noEmit",
     "precheck": "bun run typecheck && bun run check:fix && bun test --isolate",
@@ -91,7 +89,7 @@
     "@anthropic-ai/sandbox-runtime": "^0.0.44",
     "@anthropic-ai/sdk": "^0.81.0",
     "@anthropic-ai/vertex-sdk": "^0.16.0",
-    "@saluzi/sa-ink": "^0.1.10",
+    "@saluzi/sa-ink": "^0.1.11",
     "@aws-sdk/client-bedrock": "^3.1037.0",
     "@aws-sdk/client-bedrock-runtime": "^3.1037.0",
     "@aws-sdk/client-sts": "^3.1037.0",

package/scripts/postinstall.cjs

@@ -1,580 +0,0 @@
-#!/usr/bin/env node
-/**
- * Postinstall script — runs automatically after `bun install` or `npm install`.
- *
- * Downloads ripgrep binary (idempotent, skips if exists).
- * Works in dev mode (src/ exists), published mode (dist/ exists), with bun or node.
- *
- * Usage:
- *   node scripts/postinstall.js
- *   node scripts/postinstall.js --force
- *   bun run scripts/postinstall.js
- */
-
-const {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  renameSync,
-  rmSync,
-  statSync,
-  writeFileSync,
-  chmodSync,
-} = require('fs')
-const { spawnSync } = require('child_process')
-const { setDefaultResultOrder } = require('node:dns')
-const path = require('path')
-const os = require('os')
-
-// Prefer IPv4 first — Bun on Windows sometimes fails GitHub over broken IPv6 paths.
-try {
-  setDefaultResultOrder('ipv4first')
-} catch {
-  /* ignore */
-}
-
-// --- Config ---
-
-const RG_VERSION = '15.0.1'
-const DEFAULT_RELEASE_BASE = `https://github.com/microsoft/ripgrep-prebuilt/releases/download/v${RG_VERSION}`
-const MIRROR_RELEASE_BASE = `https://ghproxy.net/https://github.com/microsoft/ripgrep-prebuilt/releases/download/v${RG_VERSION}`
-const RELEASE_BASE = (
-  process.env.RIPGREP_DOWNLOAD_BASE ?? DEFAULT_RELEASE_BASE
-).replace(/\/$/, '')
-
-const scriptDir = path.dirname(__filename)
-const projectRoot = path.resolve(scriptDir, '..')
-
-// --- Platform mapping ---
-
-function getPlatformMapping() {
-  const arch = process.arch
-  const platform = process.platform
-
-  if (platform === 'darwin') {
-    if (arch === 'arm64')
-      return { target: 'aarch64-apple-darwin', ext: 'tar.gz' }
-    if (arch === 'x64') return { target: 'x86_64-apple-darwin', ext: 'tar.gz' }
-    throw new Error(`Unsupported macOS arch: ${arch}`)
-  }
-
-  if (platform === 'win32') {
-    if (arch === 'x64') return { target: 'x86_64-pc-windows-msvc', ext: 'zip' }
-    if (arch === 'arm64')
-      return { target: 'aarch64-pc-windows-msvc', ext: 'zip' }
-    throw new Error(`Unsupported Windows arch: ${arch}`)
-  }
-
-  if (platform === 'linux') {
-    const isMusl = detectMusl()
-    if (arch === 'x64') {
-      return { target: 'x86_64-unknown-linux-musl', ext: 'tar.gz' }
-    }
-    if (arch === 'arm64') {
-      return isMusl
-        ? { target: 'aarch64-unknown-linux-musl', ext: 'tar.gz' }
-        : { target: 'aarch64-unknown-linux-gnu', ext: 'tar.gz' }
-    }
-    throw new Error(`Unsupported Linux arch: ${arch}`)
-  }
-
-  throw new Error(`Unsupported platform: ${platform}`)
-}
-
-function detectMusl() {
-  const muslArch = process.arch === 'x64' ? 'x86_64' : 'aarch64'
-  try {
-    statSync(`/lib/libc.musl-${muslArch}.so.1`)
-    return true
-  } catch {
-    return false
-  }
-}
-
-// --- Paths ---
-
-function getVendorDir() {
-  if (existsSync(path.join(projectRoot, 'src'))) {
-    return path.resolve(projectRoot, 'src', 'utils', 'vendor', 'ripgrep')
-  }
-  return path.resolve(projectRoot, 'dist', 'vendor', 'ripgrep')
-}
-
-function getBinaryPath() {
-  const dir = getVendorDir()
-  const subdir = `${process.arch}-${process.platform}`
-  const binary = process.platform === 'win32' ? 'rg.exe' : 'rg'
-  return path.resolve(dir, subdir, binary)
-}
-
-// --- Download helpers ---
-
-function proxyEnvSet() {
-  const v = s => (s ?? '').trim()
-  return !!(
-    v(process.env.HTTPS_PROXY) ||
-    v(process.env.HTTP_PROXY) ||
-    v(process.env.ALL_PROXY) ||
-    v(process.env.https_proxy) ||
-    v(process.env.http_proxy)
-  )
-}
-
-function tryPowerShellDownload(url, dest) {
-  const u = url.replace(/'/g, "''")
-  const d = dest.replace(/'/g, "''")
-  const cmd = `Invoke-WebRequest -Uri '${u}' -OutFile '${d}' -UseBasicParsing`
-  const result = spawnSync(
-    'powershell.exe',
-    [
-      '-NoProfile',
-      '-NonInteractive',
-      '-ExecutionPolicy',
-      'Bypass',
-      '-Command',
-      cmd,
-    ],
-    { stdio: 'pipe', windowsHide: true },
-  )
-  return result.status === 0 && existsSync(dest) && statSync(dest).size > 0
-}
-
-function tryCurlDownload(url, dest) {
-  const curl = process.platform === 'win32' ? 'curl.exe' : 'curl'
-  const result = spawnSync(curl, ['-fsSL', '-L', '--fail', '-o', dest, url], {
-    stdio: 'pipe',
-    windowsHide: true,
-  })
-  return result.status === 0 && existsSync(dest) && statSync(dest).size > 0
-}
-
-async function fetchRelease(url) {
-  // Prefer undici when available (installed as optionalDep) — its
-  // EnvHttpProxyAgent honors HTTPS_PROXY/HTTP_PROXY/NO_PROXY, which Node's
-  // built-in fetch does NOT. On published installs where undici may be absent
-  // (--omit=optional, pnpm strict), fall back gracefully.
-  let undici
-  try {
-    undici = require('undici')
-  } catch {
-    // undici unavailable — fall through to global fetch + curl/PowerShell
-  }
-  if (proxyEnvSet() && undici) {
-    try {
-      return await undici.fetch(url, {
-        redirect: 'follow',
-        dispatcher: new undici.EnvHttpProxyAgent(),
-      })
-    } catch (e) {
-      // undici fetch failed — fall through to downloadUrlToBufferWithFallback
-      // which tries curl/PowerShell (those honor system proxy config).
-      const msg = e instanceof Error ? e.message : String(e)
-      console.warn(
-        `[postinstall] undici fetch failed (${msg}); trying curl/PowerShell fallback`,
-      )
-    }
-  }
-  // Node 18+ has global fetch, Bun has it too. NOTE: global fetch does NOT
-  // honor HTTPS_PROXY — proxy users without undici must rely on the
-  // curl/PowerShell fallback in downloadUrlToBufferWithFallback, which DOES
-  // honor system proxy config (curl on Linux/macOS, winhttp on Windows).
-  return await fetch(url, { redirect: 'follow' })
-}
-
-async function downloadUrlToBuffer(url) {
-  const response = await fetchRelease(url)
-  if (!response.ok) {
-    throw new Error(
-      `Download failed: ${response.status} ${response.statusText}`,
-    )
-  }
-  return Buffer.from(await response.arrayBuffer())
-}
-
-async function downloadUrlToBufferWithFallback(url) {
-  let firstError
-  try {
-    return await downloadUrlToBuffer(url)
-  } catch (e) {
-    firstError = e
-  }
-
-  const tmpRoot = path.join(
-    os.tmpdir(),
-    `ripgrep-dl-${process.pid}-${Date.now()}`,
-  )
-  const tmpFile = path.join(tmpRoot, 'archive')
-  mkdirSync(tmpRoot, { recursive: true })
-  try {
-    if (process.platform === 'win32' && tryPowerShellDownload(url, tmpFile)) {
-      return readFileSync(tmpFile)
-    }
-    if (tryCurlDownload(url, tmpFile)) {
-      return readFileSync(tmpFile)
-    }
-  } finally {
-    rmSync(tmpRoot, { recursive: true, force: true })
-  }
-
-  throw firstError
-}
-
-// --- Extract ---
-
-function findZipEntryKey(files, want) {
-  return Object.keys(files).find(k => {
-    const norm = k.replace(/\\/g, '/')
-    return norm === want || norm.endsWith(`/${want}`)
-  })
-}
-
-async function extractZip(buffer, binaryPath, extractedBinary) {
-  const binaryDir = path.dirname(binaryPath)
-  // Try fflate first (bundled dep)
-  let fflateError
-  try {
-    const { unzipSync } = require('fflate')
-    const unzipped = unzipSync(new Uint8Array(buffer))
-    const key = findZipEntryKey(unzipped, extractedBinary)
-    if (!key) {
-      throw new Error(`Binary ${extractedBinary} not found in zip`)
-    }
-    writeFileSync(binaryPath, Buffer.from(unzipped[key]))
-    return
-  } catch (e) {
-    fflateError = e
-  }
-
-  // Fallback: PowerShell Expand-Archive or unzip CLI
-  const tmpDir = path.join(binaryDir, '.tmp-download')
-  rmSync(tmpDir, { recursive: true, force: true })
-  mkdirSync(tmpDir, { recursive: true })
-  try {
-    const assetName = `archive.zip`
-    const archivePath = path.join(tmpDir, assetName)
-    writeFileSync(archivePath, buffer)
-
-    let extracted = false
-    if (process.platform === 'win32') {
-      const psCmd = `Expand-Archive -Path '${archivePath.replace(/'/g, "''")}' -DestinationPath '${tmpDir.replace(/'/g, "''")}' -Force`
-      const psResult = spawnSync(
-        'powershell.exe',
-        [
-          '-NoProfile',
-          '-NonInteractive',
-          '-ExecutionPolicy',
-          'Bypass',
-          '-Command',
-          psCmd,
-        ],
-        { stdio: 'pipe', windowsHide: true },
-      )
-      if (psResult.status === 0) {
-        extracted = true
-      }
-    }
-
-    if (!extracted) {
-      const result = spawnSync('unzip', ['-o', archivePath, '-d', tmpDir], {
-        stdio: 'pipe',
-      })
-      if (result.status !== 0) {
-        const unzipErr = result.stderr?.toString().trim() || 'command not found'
-        const fflateMsg =
-          fflateError instanceof Error
-            ? fflateError.message
-            : String(fflateError)
-        throw new Error(
-          `zip extraction failed (fflate: ${fflateMsg}; unzip: ${unzipErr})`,
-        )
-      }
-    }
-
-    const srcBinary = path.join(tmpDir, extractedBinary)
-    if (!existsSync(srcBinary)) {
-      throw new Error(`Binary not found at expected path: ${srcBinary}`)
-    }
-    renameSync(srcBinary, binaryPath)
-  } finally {
-    rmSync(tmpDir, { recursive: true, force: true })
-  }
-}
-
-async function extractTarGz(buffer, binaryPath, extractedBinary, assetName) {
-  const binaryDir = path.dirname(binaryPath)
-  const tmpDir = path.join(binaryDir, '.tmp-download')
-  rmSync(tmpDir, { recursive: true, force: true })
-  mkdirSync(tmpDir, { recursive: true })
-  try {
-    const archivePath = path.join(tmpDir, assetName)
-    writeFileSync(archivePath, buffer)
-    const result = spawnSync('tar', ['xzf', archivePath, '-C', tmpDir], {
-      stdio: 'pipe',
-    })
-    if (result.status !== 0) {
-      throw new Error(`tar extract failed: ${result.stderr?.toString()}`)
-    }
-    const srcBinary = path.join(tmpDir, extractedBinary)
-    if (!existsSync(srcBinary)) {
-      throw new Error(`Binary not found at expected path: ${srcBinary}`)
-    }
-    renameSync(srcBinary, binaryPath)
-  } finally {
-    rmSync(tmpDir, { recursive: true, force: true })
-  }
-}
-
-// --- Main ---
-
-async function downloadAndExtract() {
-  const { target, ext } = getPlatformMapping()
-  const assetName = `ripgrep-v${RG_VERSION}-${target}.${ext}`
-
-  const binaryPath = getBinaryPath()
-  const binaryDir = path.dirname(binaryPath)
-
-  const force = process.argv.includes('--force')
-  if (!force && existsSync(binaryPath)) {
-    const stat = statSync(binaryPath)
-    if (stat.size > 0) {
-      console.log(`[ripgrep] Binary already exists at ${binaryPath}, skipping.`)
-      return
-    }
-  }
-
-  console.log(`[ripgrep] Downloading v${RG_VERSION} for ${target}...`)
-
-  const extractedBinary = process.platform === 'win32' ? 'rg.exe' : 'rg'
-
-  const mirrors = [RELEASE_BASE]
-  if (RELEASE_BASE === DEFAULT_RELEASE_BASE.replace(/\/$/, '')) {
-    mirrors.push(MIRROR_RELEASE_BASE.replace(/\/$/, ''))
-  }
-
-  let buffer
-  let lastError
-  for (const base of mirrors) {
-    const url = `${base}/${assetName}`
-    try {
-      console.log(`[ripgrep] Trying ${url}`)
-      buffer = await downloadUrlToBufferWithFallback(url)
-      break
-    } catch (e) {
-      console.warn(
-        `[ripgrep] Download from ${base} failed: ${e instanceof Error ? e.message : e}`,
-      )
-      lastError = e
-    }
-  }
-  if (!buffer) {
-    throw lastError
-  }
-
-  try {
-    console.log(`[ripgrep] Downloaded ${Math.round(buffer.length / 1024)} KB`)
-
-    mkdirSync(binaryDir, { recursive: true })
-
-    if (ext === 'tar.gz') {
-      await extractTarGz(buffer, binaryPath, extractedBinary, assetName)
-    } else {
-      await extractZip(buffer, binaryPath, extractedBinary)
-    }
-
-    if (process.platform !== 'win32') {
-      chmodSync(binaryPath, 0o755)
-    }
-
-    console.log(`[ripgrep] Installed to ${binaryPath}`)
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e)
-    const hint =
-      'Check network or set HTTPS_PROXY. If GitHub is blocked, set RIPGREP_DOWNLOAD_BASE to a mirror (see script header).'
-    throw new Error(`${msg} ${hint}`)
-  }
-}
-
-async function main() {
-  await downloadAndExtract()
-  await setupCodegraph()
-}
-
-// --- Codegraph dist/ setup ---
-// The workspace package packages/codegraph/ is a stub (only package.json).
-// The published @saluzi/codegraph on npm has a complete dist/ with bun:sqlite
-// compatibility. This step downloads it so require('@saluzi/codegraph') works.
-
-const CODEGRAPH_PKG = '@saluzi/codegraph'
-const CODEGRAPH_METADATA_FILE = '.dist-metadata.json'
-
-function getCodegraphVersion() {
-  // Read from root package.json dependencies, strip semver range prefix (^~>=)
-  try {
-    const pkgPath = path.join(projectRoot, 'package.json')
-    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
-    const version = pkg.dependencies?.[CODEGRAPH_PKG]
-    if (version) {
-      return version.replace(/^[\^~>=<]+/, '')
-    }
-  } catch {
-    // fallback
-  }
-  return '0.1.0'
-}
-
-function getCodegraphDistIndex() {
-  return path.join(projectRoot, 'packages', 'codegraph', 'dist', 'index.js')
-}
-
-function getCodegraphMetadataPath() {
-  return path.join(
-    projectRoot,
-    'packages',
-    'codegraph',
-    CODEGRAPH_METADATA_FILE,
-  )
-}
-
-function readCodegraphMetadata() {
-  try {
-    const metaPath = getCodegraphMetadataPath()
-    if (existsSync(metaPath)) {
-      return JSON.parse(readFileSync(metaPath, 'utf8'))
-    }
-  } catch {
-    // corrupted or unreadable
-  }
-  return null
-}
-
-function writeCodegraphMetadata(metadata) {
-  const metaPath = getCodegraphMetadataPath()
-  writeFileSync(metaPath, JSON.stringify(metadata, null, 2) + '\n')
-}
-
-async function setupCodegraph() {
-  const distIndex = getCodegraphDistIndex()
-  const force = process.argv.includes('--force')
-  const requiredVersion = getCodegraphVersion()
-
-  // Check if dist/ exists
-  if (!force && existsSync(distIndex)) {
-    // Read metadata to check version
-    const metadata = readCodegraphMetadata()
-
-    // If no metadata, assume it's a local build — don't overwrite
-    if (!metadata) {
-      console.log(
-        `[codegraph] dist/ exists without metadata (local build?), skipping.`,
-      )
-      return
-    }
-
-    // If metadata indicates local build, don't overwrite
-    if (metadata.source === 'local') {
-      console.log(`[codegraph] dist/ is a local build, skipping.`)
-      return
-    }
-
-    // If version matches, skip
-    if (metadata.version === requiredVersion) {
-      console.log(`[codegraph] dist/ already at v${requiredVersion}, skipping.`)
-      return
-    }
-
-    // Version mismatch — need to update
-    console.log(
-      `[codegraph] dist/ version mismatch: installed ${metadata.version}, required ${requiredVersion}`,
-    )
-  }
-
-  console.log(
-    `[codegraph] Fetching ${CODEGRAPH_PKG}@${requiredVersion} from npm registry...`,
-  )
-
-  // 1. Resolve tarball URL from npm registry
-  const registryUrl = `https://registry.npmjs.org/${CODEGRAPH_PKG}/${requiredVersion}`
-  let tarballUrl
-  try {
-    const resp = await fetchRelease(registryUrl)
-    if (!resp.ok) {
-      throw new Error(`${resp.status} ${resp.statusText}`)
-    }
-    const meta = await resp.json()
-    tarballUrl = meta.dist?.tarball
-    if (!tarballUrl) {
-      throw new Error('no tarball URL in registry response')
-    }
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e)
-    console.warn(
-      `[codegraph] Failed to resolve tarball URL: ${msg} (non-fatal, codegraph graph features will be unavailable)`,
-    )
-    return
-  }
-
-  // 2. Download tarball
-  let buffer
-  try {
-    buffer = await downloadUrlToBufferWithFallback(tarballUrl)
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e)
-    console.warn(
-      `[codegraph] Download failed: ${msg} (non-fatal, codegraph graph features will be unavailable)`,
-    )
-    return
-  }
-
-  // 3. Extract package/dist/ → packages/codegraph/dist/
-  const tmpDir = path.join(os.tmpdir(), `codegraph-setup-${process.pid}`)
-  mkdirSync(tmpDir, { recursive: true })
-  try {
-    const tgzPath = path.join(tmpDir, 'package.tgz')
-    writeFileSync(tgzPath, buffer)
-    const result = spawnSync('tar', ['xzf', tgzPath, '-C', tmpDir], {
-      stdio: 'pipe',
-    })
-    if (result.status !== 0) {
-      throw new Error(
-        `tar extract failed: ${result.stderr?.toString() || 'unknown error'}`,
-      )
-    }
-
-    const extractedDist = path.join(tmpDir, 'package', 'dist')
-    if (!existsSync(extractedDist)) {
-      throw new Error('extracted package has no dist/ directory')
-    }
-
-    const targetDist = path.join(projectRoot, 'packages', 'codegraph', 'dist')
-    rmSync(targetDist, { recursive: true, force: true })
-    renameSync(extractedDist, targetDist)
-
-    // Write metadata to track installed version
-    writeCodegraphMetadata({
-      version: requiredVersion,
-      source: 'npm',
-      installedAt: new Date().toISOString(),
-    })
-
-    console.log(
-      `[codegraph] Installed dist/ to ${targetDist} (${CODEGRAPH_PKG}@${requiredVersion})`,
-    )
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e)
-    console.warn(
-      `[codegraph] Setup failed: ${msg} (non-fatal, codegraph graph features will be unavailable)`,
-    )
-  } finally {
-    rmSync(tmpDir, { recursive: true, force: true })
-  }
-}
-
-main().catch(error => {
-  const msg = error instanceof Error ? error.message : String(error)
-  console.error(`[postinstall] ripgrep download failed (non-fatal): ${msg}`)
-  console.error(
-    `[postinstall] You can install ripgrep manually: https://github.com/BurntSushi/ripgrep#installation`,
-  )
-  // Never exit with error code — postinstall must not break install
-  process.exit(0)
-})