@claudiolabs/claudin 1.0.0 → 1.0.4

package/scripts/postinstall-warmup.mjs

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-/**
- * Pre-warm the V8 bytecode cache used by `bin/claudin`.
- *
- * Background: `bin/claudin` enables `module.enableCompileCache(~/.claudin/v8cache)`,
- * which saves ~250 ms on every WARM launch. But the very first launch after
- * `npm install -g @claudiolabs/claudin` has an empty cache, so the user pays
- * the full ~520 ms cold parse cost. This script runs `--version` and `--help`
- * once during the postinstall step, populating the cache transparently. The
- * user's first real invocation lands warm.
- *
- * Safety:
- *  - Only runs if dist/cli.mjs exists (skips dev installs that haven't built).
- *  - All errors are swallowed; postinstall must NEVER block npm install.
- *  - Honors npm's `--ignore-scripts` flag (npm short-circuits before this runs).
- *  - Opt-out: set CLAUDIN_NO_WARMUP=1 before install.
- *  - Bounded by a 15 s timeout per command — won't hang forever on a wedged
- *    spawn.
- *  - Sets CLAUDIN_NO_HEAP_BUMP=1 so the launcher's re-exec doesn't double the
- *    work (the heap bump isn't needed for --version/--help).
- *  - No network, no auth, no config writes outside ~/.claudin/v8cache/.
- *
- * Footprint: ~1–2 s added to `npm install`. v8cache directory grows by ~5 MB.
- */
-
-import { spawnSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-if (process.env.CLAUDIN_NO_WARMUP === '1') process.exit(0)
-
-const root = dirname(dirname(fileURLToPath(import.meta.url)))
-const dist = join(root, 'dist', 'cli.mjs')
-const launcher = join(root, 'bin', 'claudin')
-
-if (!existsSync(dist) || !existsSync(launcher)) {
-  // Dev install or unbuilt checkout — nothing to warm.
-  process.exit(0)
-}
-
-const env = {
-  ...process.env,
-  // Launcher re-execs itself to bump --max-old-space-size. That's pointless
-  // for a --version warmup and would double the work. The launcher's compile
-  // cache logic runs in EITHER the parent or the re-exec'd child (after the
-  // sentinel is set), so the cache is still populated.
-  CLAUDIN_NO_HEAP_BUMP: '1',
-  // Silence the cache GC pass — it's not relevant during warmup and may print
-  // diagnostic noise to install logs.
-  CLAUDIN_V8CACHE_GC: '0',
-}
-
-const opts = {
-  stdio: 'ignore',
-  timeout: 15000,
-  env,
-}
-
-// --version exits in ~80 ms; --help exits in ~520 ms cold. Run both so the
-// cache covers BOTH the version fast-path and the commander help graph,
-// which the user's first interactive launch will also need.
-try {
-  spawnSync(process.execPath, [launcher, '--version'], opts)
-  spawnSync(process.execPath, [launcher, '--help'], opts)
-} catch {
-  // Intentionally ignored — postinstall must never block install.
-}
-
-process.exit(0)

package/scripts/v8cache-gc.mjs

@@ -1,84 +0,0 @@
-// GC for ~/.claudin/v8cache/. Node's enableCompileCache writes one entry per
-// (file path, mtime) under a fingerprint subdir (e.g. v25.9.0-x64-<hash>-<uid>)
-// and never reclaims stale entries. After code-splitting, dist/chunks/[name]-[hash].mjs
-// produces hundreds of new files per build, so the cache grows unboundedly in
-// active dev. We sweep entries older than `ttlDays` and prune empty fingerprint
-// subdirs.
-//
-// Pure logic split out so it can be unit-tested without spawning the launcher.
-
-import { readdir, stat, unlink, rmdir } from 'fs/promises'
-import { join } from 'path'
-
-/**
- * @param {string} cacheDir absolute path to the v8cache root
- * @param {object} opts
- * @param {number} opts.ttlDays entries with mtime older than this are deleted
- * @param {number} [opts.now] epoch ms; defaults to Date.now() (injected for tests)
- * @returns {Promise<{ removedFiles: number, removedDirs: number, removedBytes: number, errors: number }>}
- */
-export async function gcV8Cache(cacheDir, { ttlDays, now = Date.now() }) {
-  const cutoff = now - ttlDays * 24 * 60 * 60 * 1000
-  const stats = { removedFiles: 0, removedDirs: 0, removedBytes: 0, errors: 0 }
-
-  let topEntries
-  try {
-    topEntries = await readdir(cacheDir, { withFileTypes: true })
-  } catch {
-    // Cache dir doesn't exist yet — nothing to GC.
-    return stats
-  }
-
-  for (const top of topEntries) {
-    const topPath = join(cacheDir, top.name)
-    if (!top.isDirectory()) {
-      // Stray file at root: respect TTL.
-      try {
-        const s = await stat(topPath)
-        if (s.mtimeMs < cutoff) {
-          await unlink(topPath)
-          stats.removedFiles++
-          stats.removedBytes += s.size
-        }
-      } catch {
-        stats.errors++
-      }
-      continue
-    }
-
-    let inner
-    try {
-      inner = await readdir(topPath, { withFileTypes: true })
-    } catch {
-      stats.errors++
-      continue
-    }
-
-    let remaining = inner.length
-    for (const entry of inner) {
-      const entryPath = join(topPath, entry.name)
-      try {
-        const s = await stat(entryPath)
-        if (s.mtimeMs < cutoff) {
-          await unlink(entryPath)
-          stats.removedFiles++
-          stats.removedBytes += s.size
-          remaining--
-        }
-      } catch {
-        stats.errors++
-      }
-    }
-
-    if (remaining === 0) {
-      try {
-        await rmdir(topPath)
-        stats.removedDirs++
-      } catch {
-        // Subdir may have re-populated between readdir and rmdir; benign.
-      }
-    }
-  }
-
-  return stats
-}