wyvrnpm 2.10.2 → 2.12.2

package/src/commands/cache.js

@@ -1,189 +1,189 @@
-'use strict';
-
-// F12: source-build cache inspection + targeted pruning.
-//
-// `wyvrnpm cache list [pattern]` prints a human-readable table (or JSON
-// with --format json) of everything in the machine-wide source-build
-// cache at `%LOCALAPPDATA%\wyvrnpm\bc\`.
-//
-// `wyvrnpm cache prune` removes cache entries per a policy:
-//   --keep-last N      retain N most-recently-touched per (name,version)
-//   --older-than 30d   also remove entries older than the threshold
-//   --pattern <glob>   restrict to matching package names
-//   --dry-run          print what would go, remove nothing
-//
-// The existing `wyvrnpm clean --build-cache` nukes everything; this is
-// the targeted alternative for teams whose `--upload-built` cache has
-// ballooned.
-
-const {
-  listCacheEntries,
-  computePruneSet,
-  removeCacheEntries,
-  parseDurationToCutoff,
-  getBuildCacheRoot,
-} = require('../build/cache');
-const log = require('../logger');
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function formatBytes(n) {
-  if (n < 1024) return `${n} B`;
-  const units = ['KB', 'MB', 'GB', 'TB'];
-  let size = n / 1024, i = 0;
-  while (size >= 1024 && i < units.length - 1) { size /= 1024; i++; }
-  return `${size.toFixed(size >= 100 ? 0 : 1)} ${units[i]}`;
-}
-
-function formatMtime(ms) {
-  if (!ms) return '<unknown>';
-  return new Date(ms).toISOString().replace('T', ' ').slice(0, 16);
-}
-
-function globToRegExp(glob) {
-  const escaped = glob.replace(/[.+^${}()|[\]\\]/g, '\\$&');
-  return new RegExp(`^${escaped.replace(/\*/g, '.*').replace(/\?/g, '.')}$`);
-}
-
-function patternFor(argPattern, positional) {
-  const src = argPattern ?? positional ?? null;
-  return src ? globToRegExp(src) : null;
-}
-
-// ---------------------------------------------------------------------------
-// list
-// ---------------------------------------------------------------------------
-
-/**
- * wyvrnpm cache list [pattern] [--format json|text]
- *
- * @param {object} argv
- */
-function list(argv) {
-  const entries = listCacheEntries();
-  const regex   = patternFor(argv.pattern, argv._?.[1]);
-  const filtered = regex ? entries.filter((e) => regex.test(e.name)) : entries;
-
-  // Newest first — matches what `ls -lt` users expect.
-  filtered.sort((a, b) => b.mtimeMs - a.mtimeMs);
-
-  if (argv.format === 'json') {
-    process.stdout.write(JSON.stringify({
-      command:       'cache-list',
-      cacheRoot:     getBuildCacheRoot(),
-      totalEntries:  filtered.length,
-      totalBytes:    filtered.reduce((s, e) => s + e.sizeBytes, 0),
-      entries:       filtered.map((e) => ({
-        name:        e.name,
-        version:     e.version,
-        profileHash: e.profileHash,
-        sizeBytes:   e.sizeBytes,
-        mtime:       new Date(e.mtimeMs).toISOString(),
-        hasArtefact: e.hasArtefact,
-        uploadCount: e.uploads.length,
-      })),
-    }, null, 2) + '\n');
-    return;
-  }
-
-  log.info(`Cache root : ${getBuildCacheRoot()}`);
-  if (filtered.length === 0) {
-    log.info('  (empty)');
-    return;
-  }
-
-  const rows = filtered.map((e) => [
-    e.name,
-    e.version,
-    e.profileHash,
-    formatBytes(e.sizeBytes),
-    formatMtime(e.mtimeMs),
-    e.uploads.length > 0 ? `${e.uploads.length}` : '-',
-  ]);
-  const header = ['NAME', 'VERSION', 'PROFILE HASH', 'SIZE', 'MTIME', 'UPLOADS'];
-  const widths = header.map((h, i) =>
-    Math.max(h.length, ...rows.map((r) => String(r[i]).length)),
-  );
-
-  const format = (cells) => cells.map((c, i) => String(c).padEnd(widths[i])).join('  ');
-  console.log('');
-  console.log('  ' + format(header));
-  console.log('  ' + widths.map((w) => '-'.repeat(w)).join('  '));
-  for (const r of rows) console.log('  ' + format(r));
-  console.log('');
-
-  const totalBytes = filtered.reduce((s, e) => s + e.sizeBytes, 0);
-  log.info(`${filtered.length} entries, ${formatBytes(totalBytes)} total`);
-}
-
-// ---------------------------------------------------------------------------
-// prune
-// ---------------------------------------------------------------------------
-
-/**
- * wyvrnpm cache prune [--keep-last N] [--older-than 30d] [--pattern X] [--dry-run]
- *
- * Requires at least one of --keep-last / --older-than to avoid footgun
- * (use `wyvrnpm clean --build-cache` to wipe everything).
- *
- * @param {object} argv
- */
-function prune(argv) {
-  const hasKeep  = argv.keepLast !== undefined && argv.keepLast !== null;
-  const hasOlder = typeof argv.olderThan === 'string' && argv.olderThan.length > 0;
-
-  if (!hasKeep && !hasOlder) {
-    log.error(
-      'cache prune: specify --keep-last <N> and/or --older-than <duration>.\n' +
-      '  To wipe the entire build cache, use `wyvrnpm clean --build-cache`.',
-    );
-    process.exit(1);
-  }
-
-  const policy = {};
-  if (hasKeep) {
-    const n = Number(argv.keepLast);
-    if (!Number.isInteger(n) || n < 0) {
-      log.error(`--keep-last must be a non-negative integer, got ${argv.keepLast}`);
-      process.exit(1);
-    }
-    policy.keepLast = n;
-  }
-  if (hasOlder) {
-    try { policy.olderThanMs = parseDurationToCutoff(argv.olderThan); }
-    catch (err) { log.error(err.message); process.exit(1); }
-  }
-  if (argv.pattern) {
-    policy.patternRegex = globToRegExp(argv.pattern);
-  }
-
-  const entries  = listCacheEntries();
-  const pruneSet = computePruneSet(entries, policy);
-
-  if (pruneSet.length === 0) {
-    log.info('Nothing to prune under that policy.');
-    return;
-  }
-
-  const totalBytes = pruneSet.reduce((s, e) => s + e.sizeBytes, 0);
-  const verb = argv.dryRun ? 'Would remove' : 'Removing';
-  log.info(`${verb} ${pruneSet.length} cache entr${pruneSet.length === 1 ? 'y' : 'ies'}, ${formatBytes(totalBytes)}:`);
-  for (const e of pruneSet) {
-    console.log(`  - ${e.name}@${e.version} [${e.profileHash}]  ${formatBytes(e.sizeBytes)}  ${formatMtime(e.mtimeMs)}`);
-  }
-
-  if (argv.dryRun) {
-    log.info('(dry-run — nothing deleted)');
-    return;
-  }
-
-  const removed = removeCacheEntries(pruneSet);
-  log.info(`Removed ${removed.length} of ${pruneSet.length} cache entr${pruneSet.length === 1 ? 'y' : 'ies'}`);
-  if (removed.length < pruneSet.length) {
-    log.warn(`${pruneSet.length - removed.length} entr${pruneSet.length - removed.length === 1 ? 'y' : 'ies'} could not be removed (permissions or concurrent access)`);
-  }
-}
-
-module.exports = { list, prune };
+'use strict';
+
+// F12: source-build cache inspection + targeted pruning.
+//
+// `wyvrnpm cache list [pattern]` prints a human-readable table (or JSON
+// with --format json) of everything in the machine-wide source-build
+// cache at `%LOCALAPPDATA%\wyvrnpm\bc\`.
+//
+// `wyvrnpm cache prune` removes cache entries per a policy:
+//   --keep-last N      retain N most-recently-touched per (name,version)
+//   --older-than 30d   also remove entries older than the threshold
+//   --pattern <glob>   restrict to matching package names
+//   --dry-run          print what would go, remove nothing
+//
+// The existing `wyvrnpm clean --build-cache` nukes everything; this is
+// the targeted alternative for teams whose `--upload-built` cache has
+// ballooned.
+
+const {
+  listCacheEntries,
+  computePruneSet,
+  removeCacheEntries,
+  parseDurationToCutoff,
+  getBuildCacheRoot,
+} = require('../build/cache');
+const log = require('../logger');
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function formatBytes(n) {
+  if (n < 1024) return `${n} B`;
+  const units = ['KB', 'MB', 'GB', 'TB'];
+  let size = n / 1024, i = 0;
+  while (size >= 1024 && i < units.length - 1) { size /= 1024; i++; }
+  return `${size.toFixed(size >= 100 ? 0 : 1)} ${units[i]}`;
+}
+
+function formatMtime(ms) {
+  if (!ms) return '<unknown>';
+  return new Date(ms).toISOString().replace('T', ' ').slice(0, 16);
+}
+
+function globToRegExp(glob) {
+  const escaped = glob.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+  return new RegExp(`^${escaped.replace(/\*/g, '.*').replace(/\?/g, '.')}$`);
+}
+
+function patternFor(argPattern, positional) {
+  const src = argPattern ?? positional ?? null;
+  return src ? globToRegExp(src) : null;
+}
+
+// ---------------------------------------------------------------------------
+// list
+// ---------------------------------------------------------------------------
+
+/**
+ * wyvrnpm cache list [pattern] [--format json|text]
+ *
+ * @param {object} argv
+ */
+function list(argv) {
+  const entries = listCacheEntries();
+  const regex   = patternFor(argv.pattern, argv._?.[1]);
+  const filtered = regex ? entries.filter((e) => regex.test(e.name)) : entries;
+
+  // Newest first — matches what `ls -lt` users expect.
+  filtered.sort((a, b) => b.mtimeMs - a.mtimeMs);
+
+  if (argv.format === 'json') {
+    process.stdout.write(JSON.stringify({
+      command:       'cache-list',
+      cacheRoot:     getBuildCacheRoot(),
+      totalEntries:  filtered.length,
+      totalBytes:    filtered.reduce((s, e) => s + e.sizeBytes, 0),
+      entries:       filtered.map((e) => ({
+        name:        e.name,
+        version:     e.version,
+        profileHash: e.profileHash,
+        sizeBytes:   e.sizeBytes,
+        mtime:       new Date(e.mtimeMs).toISOString(),
+        hasArtefact: e.hasArtefact,
+        uploadCount: e.uploads.length,
+      })),
+    }, null, 2) + '\n');
+    return;
+  }
+
+  log.info(`Cache root : ${getBuildCacheRoot()}`);
+  if (filtered.length === 0) {
+    log.info('  (empty)');
+    return;
+  }
+
+  const rows = filtered.map((e) => [
+    e.name,
+    e.version,
+    e.profileHash,
+    formatBytes(e.sizeBytes),
+    formatMtime(e.mtimeMs),
+    e.uploads.length > 0 ? `${e.uploads.length}` : '-',
+  ]);
+  const header = ['NAME', 'VERSION', 'PROFILE HASH', 'SIZE', 'MTIME', 'UPLOADS'];
+  const widths = header.map((h, i) =>
+    Math.max(h.length, ...rows.map((r) => String(r[i]).length)),
+  );
+
+  const format = (cells) => cells.map((c, i) => String(c).padEnd(widths[i])).join('  ');
+  console.log('');
+  console.log('  ' + format(header));
+  console.log('  ' + widths.map((w) => '-'.repeat(w)).join('  '));
+  for (const r of rows) console.log('  ' + format(r));
+  console.log('');
+
+  const totalBytes = filtered.reduce((s, e) => s + e.sizeBytes, 0);
+  log.info(`${filtered.length} entries, ${formatBytes(totalBytes)} total`);
+}
+
+// ---------------------------------------------------------------------------
+// prune
+// ---------------------------------------------------------------------------
+
+/**
+ * wyvrnpm cache prune [--keep-last N] [--older-than 30d] [--pattern X] [--dry-run]
+ *
+ * Requires at least one of --keep-last / --older-than to avoid footgun
+ * (use `wyvrnpm clean --build-cache` to wipe everything).
+ *
+ * @param {object} argv
+ */
+function prune(argv) {
+  const hasKeep  = argv.keepLast !== undefined && argv.keepLast !== null;
+  const hasOlder = typeof argv.olderThan === 'string' && argv.olderThan.length > 0;
+
+  if (!hasKeep && !hasOlder) {
+    log.error(
+      'cache prune: specify --keep-last <N> and/or --older-than <duration>.\n' +
+      '  To wipe the entire build cache, use `wyvrnpm clean --build-cache`.',
+    );
+    process.exit(1);
+  }
+
+  const policy = {};
+  if (hasKeep) {
+    const n = Number(argv.keepLast);
+    if (!Number.isInteger(n) || n < 0) {
+      log.error(`--keep-last must be a non-negative integer, got ${argv.keepLast}`);
+      process.exit(1);
+    }
+    policy.keepLast = n;
+  }
+  if (hasOlder) {
+    try { policy.olderThanMs = parseDurationToCutoff(argv.olderThan); }
+    catch (err) { log.error(err.message); process.exit(1); }
+  }
+  if (argv.pattern) {
+    policy.patternRegex = globToRegExp(argv.pattern);
+  }
+
+  const entries  = listCacheEntries();
+  const pruneSet = computePruneSet(entries, policy);
+
+  if (pruneSet.length === 0) {
+    log.info('Nothing to prune under that policy.');
+    return;
+  }
+
+  const totalBytes = pruneSet.reduce((s, e) => s + e.sizeBytes, 0);
+  const verb = argv.dryRun ? 'Would remove' : 'Removing';
+  log.info(`${verb} ${pruneSet.length} cache entr${pruneSet.length === 1 ? 'y' : 'ies'}, ${formatBytes(totalBytes)}:`);
+  for (const e of pruneSet) {
+    console.log(`  - ${e.name}@${e.version} [${e.profileHash}]  ${formatBytes(e.sizeBytes)}  ${formatMtime(e.mtimeMs)}`);
+  }
+
+  if (argv.dryRun) {
+    log.info('(dry-run — nothing deleted)');
+    return;
+  }
+
+  const removed = removeCacheEntries(pruneSet);
+  log.info(`Removed ${removed.length} of ${pruneSet.length} cache entr${pruneSet.length === 1 ? 'y' : 'ies'}`);
+  if (removed.length < pruneSet.length) {
+    log.warn(`${pruneSet.length - removed.length} entr${pruneSet.length - removed.length === 1 ? 'y' : 'ies'} could not be removed (permissions or concurrent access)`);
+  }
+}
+
+module.exports = { list, prune };

package/src/commands/clean.js

@@ -1,80 +1,80 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const {
-  clearBuildCache,
-  getBuildCacheRoot,
-  clearUploadSidecars,
-} = require('../build/cache');
-const log = require('../logger');
-
-/**
- * Removes the project's `wyvrn_internal/` package cache and `wyvrn.lock` file.
- * With `--build-cache`, also clears the machine-wide source-build cache
- * under `%LOCALAPPDATA%\wyvrnpm\bc\` (shared across projects).
- *
- * `--uploaded-built` wipes just the consumer's local RECORD of what they
- * have uploaded via `wyvrnpm install --build=missing --upload-built` (the
- * `.uploaded-to.json` sidecars under the build cache). It does NOT touch
- * the registry, the artefact zips, or the source clones. Privacy / local
- * audit cleanup only.
- *
- * @param {object}  argv
- * @param {string}  argv.root             Project root directory.
- * @param {string}  argv.manifest         Path to the manifest file (used to locate wyvrn.lock).
- * @param {boolean} [argv.buildCache]     When true, also nukes the source-build cache.
- * @param {boolean} [argv.uploadedBuilt]  When true, wipes upload sidecars only.
- * @returns {Promise<void>}
- */
-async function clean(argv) {
-  const rootDir  = path.resolve(argv.root);
-  const razerDir = path.join(rootDir, 'wyvrn_internal');
-  const lockPath = path.join(path.dirname(path.resolve(argv.manifest)), 'wyvrn.lock');
-
-  // --uploaded-built is a targeted cleanup mode. When passed on its own,
-  // skip the default wyvrn_internal/ + wyvrn.lock scrub so a user can
-  // "forget uploads" without also wiping their project-local install.
-  const targetedOnly = argv.uploadedBuilt && !argv.buildCache;
-
-  let removedAnything = false;
-
-  if (!targetedOnly) {
-    if (fs.existsSync(razerDir)) {
-      fs.rmSync(razerDir, { recursive: true, force: true });
-      log.info(`Removed ${razerDir}`);
-      removedAnything = true;
-    } else {
-      log.info(`Nothing to clean at ${razerDir}`);
-    }
-
-    if (fs.existsSync(lockPath)) {
-      fs.unlinkSync(lockPath);
-      log.info(`Removed ${lockPath}`);
-      removedAnything = true;
-    }
-  }
-
-  if (argv.buildCache) {
-    const removed = clearBuildCache();
-    if (removed) {
-      log.info(`Removed source-build cache ${removed}`);
-      removedAnything = true;
-    } else {
-      log.info(`No source-build cache at ${getBuildCacheRoot()}`);
-    }
-  } else if (argv.uploadedBuilt) {
-    // clearBuildCache() would have nuked the sidecars as a side-effect, so
-    // only bother with the sidecar sweep when the cache itself is surviving.
-    const removed = clearUploadSidecars();
-    log.info(`Removed ${removed} upload record${removed === 1 ? '' : 's'} from the build cache`);
-    if (removed > 0) removedAnything = true;
-  }
-
-  if (!removedAnything) {
-    log.info('Nothing to clean.');
-  }
-}
-
-module.exports = clean;
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const {
+  clearBuildCache,
+  getBuildCacheRoot,
+  clearUploadSidecars,
+} = require('../build/cache');
+const log = require('../logger');
+
+/**
+ * Removes the project's `wyvrn_internal/` package cache and `wyvrn.lock` file.
+ * With `--build-cache`, also clears the machine-wide source-build cache
+ * under `%LOCALAPPDATA%\wyvrnpm\bc\` (shared across projects).
+ *
+ * `--uploaded-built` wipes just the consumer's local RECORD of what they
+ * have uploaded via `wyvrnpm install --build=missing --upload-built` (the
+ * `.uploaded-to.json` sidecars under the build cache). It does NOT touch
+ * the registry, the artefact zips, or the source clones. Privacy / local
+ * audit cleanup only.
+ *
+ * @param {object}  argv
+ * @param {string}  argv.root             Project root directory.
+ * @param {string}  argv.manifest         Path to the manifest file (used to locate wyvrn.lock).
+ * @param {boolean} [argv.buildCache]     When true, also nukes the source-build cache.
+ * @param {boolean} [argv.uploadedBuilt]  When true, wipes upload sidecars only.
+ * @returns {Promise<void>}
+ */
+async function clean(argv) {
+  const rootDir  = path.resolve(argv.root);
+  const razerDir = path.join(rootDir, 'wyvrn_internal');
+  const lockPath = path.join(path.dirname(path.resolve(argv.manifest)), 'wyvrn.lock');
+
+  // --uploaded-built is a targeted cleanup mode. When passed on its own,
+  // skip the default wyvrn_internal/ + wyvrn.lock scrub so a user can
+  // "forget uploads" without also wiping their project-local install.
+  const targetedOnly = argv.uploadedBuilt && !argv.buildCache;
+
+  let removedAnything = false;
+
+  if (!targetedOnly) {
+    if (fs.existsSync(razerDir)) {
+      fs.rmSync(razerDir, { recursive: true, force: true });
+      log.info(`Removed ${razerDir}`);
+      removedAnything = true;
+    } else {
+      log.info(`Nothing to clean at ${razerDir}`);
+    }
+
+    if (fs.existsSync(lockPath)) {
+      fs.unlinkSync(lockPath);
+      log.info(`Removed ${lockPath}`);
+      removedAnything = true;
+    }
+  }
+
+  if (argv.buildCache) {
+    const removed = clearBuildCache();
+    if (removed) {
+      log.info(`Removed source-build cache ${removed}`);
+      removedAnything = true;
+    } else {
+      log.info(`No source-build cache at ${getBuildCacheRoot()}`);
+    }
+  } else if (argv.uploadedBuilt) {
+    // clearBuildCache() would have nuked the sidecars as a side-effect, so
+    // only bother with the sidecar sweep when the cache itself is surviving.
+    const removed = clearUploadSidecars();
+    log.info(`Removed ${removed} upload record${removed === 1 ? '' : 's'} from the build cache`);
+    if (removed > 0) removedAnything = true;
+  }
+
+  if (!removedAnything) {
+    log.info('Nothing to clean.');
+  }
+}
+
+module.exports = clean;