@enke.dev/bumper 0.0.1 → 0.0.3

package/README.md

@@ -84,9 +84,31 @@ bumper help                  # show help (also: bumper --help)
 bumper detect                # show context + applicable modules for the cwd
 bumper detect /path --json   # machine-readable detection
 bumper update                # run every applicable module, in order
-bumper update --dry-run      # print intended steps, change nothing
-bumper update --only node,pnpm
-bumper update --skip github-actions
+bumper update /path/to/repo  # target another repo (defaults to cwd)
+```
+
+### Flags
+
+All flags apply to `bumper update` (except `--json`, on `detect`). Repeatable flags can be given
+several times or comma-separated in one value.
+
+| Flag               | Repeatable | What it does                                                                                 |
+| ------------------ | :--------: | -------------------------------------------------------------------------------------------- |
+| `--dry-run`        |     no     | Print every intended step, change nothing on disk.                                           |
+| `--only <id>`      |    yes     | Run **only** the named module(s); everything else is skipped.                                |
+| `--skip <id>`      |    yes     | Run everything **except** the named module(s).                                               |
+| `--exclude <path>` |    yes     | Skip a repo-relative path this run only, without editing config (see [Excludes](#excludes)). |
+| `--json`           |     no     | `detect` only — emit machine-readable detection output.                                      |
+
+`--only` and `--skip` take module ids from the [Modules](#modules) table (`node`, `types-node`,
+`bun`, `npm`, `pnpm`, `docker`, `github-actions`).
+
+```sh
+bumper update --dry-run                    # preview, no writes
+bumper update --only node,pnpm             # just the Node runtime + pnpm modules
+bumper update --skip github-actions        # everything but the actions pinner
+bumper update --exclude examples           # skip a path this run, without editing config
+bumper update --exclude examples,fixtures  # repeat the flag or comma-separate several
 ```
 
 ## Modules
@@ -100,7 +122,7 @@ then the remaining file-rewriting features:
 | id               | kind            | detects                         | does                                                    |
 | ---------------- | --------------- | ------------------------------- | ------------------------------------------------------- |
 | `node`           | runtime         | node runtime / `.node-version`  | install latest LTS via fnm/asdf, write `.node-version`  |
-| `types-node`     | feature         | `@types/node` in any package    | pin spec to Node LTS major                              |
+| `types-node`     | feature         | `@types/node` in any package    | pin spec to exact latest in the Node LTS major line     |
 | `bun`            | package-manager | bun packageManager / lockfile   | self-upgrade, bump specs, pin `.bun-version`, reinstall |
 | `npm`            | package-manager | npm packageManager / lockfile   | bump specs to latest, clean reinstall                   |
 | `pnpm`           | package-manager | pnpm packageManager / lockfile  | self-update, bump specs to latest, clean reinstall      |
@@ -121,7 +143,7 @@ Path-scoped overrides. Running in an unknown repo auto-detects everything and pe
   "repos": {
     "/absolute/path/to/repository": {
       "mode": "auto", // auto = re-detect; manual = respect stored toggles
-      "exclude": ["packages/vendored-pkg"], // repo-relative dirs skipped in workspace ops
+      "exclude": ["packages/vendored-pkg"], // repo-relative paths skipped everywhere (see below)
       "modules": { "docker": false }, // explicit per-module on/off overrides, keyed by module id
     },
   },
@@ -135,3 +157,25 @@ bumper config set  /path/to/repo exclude packages/a,packages/b
 bumper config set  /path/to/repo modules.docker false
 bumper config set  /path/to/repo mode manual
 ```
+
+### Excludes
+
+`exclude` is a list of repo-relative paths (an exact dir/file or any descendant) that bumper
+leaves alone. It applies **uniformly**:
+
+- workspace members under an excluded path are dropped from every workspace operation, and
+- every file-discovering module (e.g. `docker`, which globs `**/Dockerfile*`) skips matches under
+  an excluded path — so vendored packages, fixtures, or example projects used for testing are
+  never rewritten.
+
+Persist it with `config set … exclude`, or pass `--exclude <path>` on a single `update` run to add
+paths for that run only (repeatable, comma-separated, merged with the stored list, not saved). The
+common case: a repo whose own `examples/` are self-applied test fixtures —
+
+```sh
+bumper config set /path/to/repo exclude examples   # always skip
+bumper update --exclude examples                    # skip just this run
+```
+
+> Modules that read a single fixed file at the repo root (`github-actions`, the package managers)
+> are unaffected — `exclude` targets subpaths, and the root is never excluded.

package/dist/cli.mjs

@@ -1993,17 +1993,11 @@ var configCommand = {
 };
 
 // src/commands/detect/detect.command.ts
-import { resolve as resolve2 } from "node:path";
-
-// src/context/context.ts
-import { relative as relative2 } from "node:path";
-
-// src/context/detectors/package-manager.detector.ts
-import { join as join3 } from "node:path";
+import { resolve as resolve3 } from "node:path";
 
 // src/utils/fs.utils.ts
 import { access, glob, readFile as readFile2, stat, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join2 } from "node:path";
+import { join as join2, relative as relativePath, resolve as resolve2, sep } from "node:path";
 async function pathExists(path) {
   try {
     await access(path);
@@ -2022,6 +2016,14 @@ async function globFiles(cwd, pattern) {
   const files = await Promise.all(absolute.map(async (path) => (await stat(path)).isFile() ? path : null));
   return files.filter((path) => path !== null);
 }
+function isExcluded(cwd, path, exclude) {
+  const rel = relativePath(cwd, resolve2(cwd, path));
+  return exclude.some((entry) => rel === entry || rel.startsWith(`${entry}/`));
+}
+async function collectFiles(cwd, pattern, exclude = []) {
+  const matches = await globFiles(cwd, pattern);
+  return matches.filter((match) => !match.split(sep).includes("node_modules") && !isExcluded(cwd, match, exclude));
+}
 async function readPackageJson(dir) {
   try {
     return JSON.parse(await readFile2(join2(dir, "package.json"), "utf8"));
@@ -2043,6 +2045,7 @@ function allDependencies(pkg) {
 }
 
 // src/context/detectors/package-manager.detector.ts
+import { join as join3 } from "node:path";
 async function detectPackageManager(cwd) {
   const pkg = await readPackageJson(cwd);
   const field = pkg?.packageManager ?? "";
@@ -2088,7 +2091,7 @@ async function exec(cmd, opts = {}) {
   if (file === undefined) {
     throw new Error("exec called with an empty command");
   }
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     const proc = spawn(file, args, {
       ...opts.cwd ? { cwd: opts.cwd } : {},
       env: opts.env ? { ...process.env, ...opts.env } : process.env,
@@ -2098,8 +2101,8 @@ async function exec(cmd, opts = {}) {
     let stderr = "";
     proc.stdout.on("data", (chunk) => stdout += chunk);
     proc.stderr.on("data", (chunk) => stderr += chunk);
-    proc.on("error", (error) => resolve2({ exitCode: 1, stdout, stderr: String(error) }));
-    proc.on("close", (code) => resolve2({ exitCode: code ?? 0, stdout, stderr }));
+    proc.on("error", (error) => resolve3({ exitCode: 1, stdout, stderr: String(error) }));
+    proc.on("close", (code) => resolve3({ exitCode: code ?? 0, stdout, stderr }));
   });
 }
 async function execOk(cmd, opts = {}) {
@@ -2194,12 +2197,10 @@ async function detectWorkspaces(cwd, pm) {
 }
 
 // src/context/context.ts
-function isExcluded(cwd, dir, exclude) {
-  const rel = relative2(cwd, dir);
-  return exclude.some((entry) => rel === entry || rel.startsWith(`${entry}/`));
-}
 async function buildContext(cwd, options = {}) {
-  const { config, created } = await resolveForPath(cwd);
+  const { config: stored, created } = await resolveForPath(cwd);
+  const exclude = [...new Set([...stored.exclude, ...options.exclude ?? []])];
+  const config = { ...stored, exclude };
   const [runtime, packageManager] = await Promise.all([
     detectRuntime(cwd),
     detectPackageManager(cwd)
@@ -2211,7 +2212,7 @@ async function buildContext(cwd, options = {}) {
     runtime,
     packageManager,
     isMonorepo,
-    workspaces: workspaces.filter((dir) => !isExcluded(cwd, dir, config.exclude)),
+    workspaces: workspaces.filter((dir) => !isExcluded(cwd, dir, exclude)),
     versionManager,
     config,
     dryRun: options.dryRun ?? false
@@ -2249,7 +2250,7 @@ function planLine(text) {
 
 // src/modules/features/docker/docker.feature.ts
 import { readFile as readFile4, writeFile as writeFile3 } from "node:fs/promises";
-import { relative as relative3, sep } from "node:path";
+import { relative as relative2 } from "node:path";
 
 // src/utils/npm-registry.utils.ts
 async function curlJson(url, run2 = execOk) {
@@ -2306,9 +2307,8 @@ async function ensureNodeLts(ctx) {
 
 // src/modules/features/docker/docker.feature.ts
 var DOCKER_GLOB = "**/{Dockerfile*,docker-compose*.yaml,docker-compose*.yml,compose*.yaml,compose*.yml}";
-async function findDockerFiles(cwd) {
-  const matches = await globFiles(cwd, DOCKER_GLOB);
-  return matches.filter((match) => !match.split(sep).includes("node_modules"));
+function findDockerFiles(ctx) {
+  return collectFiles(ctx.cwd, DOCKER_GLOB, ctx.config.exclude);
 }
 var dockerFeature = {
   kind: "feature" /* Feature */,
@@ -2319,13 +2319,13 @@ var dockerFeature = {
     if (toggle !== undefined) {
       return toggle;
     }
-    return (await findDockerFiles(ctx.cwd)).length > 0;
+    return (await findDockerFiles(ctx)).length > 0;
   },
   async update(ctx) {
     const { version } = await ensureNodeLts(ctx);
-    const files = await findDockerFiles(ctx.cwd);
+    const files = await findDockerFiles(ctx);
     await Promise.all(files.map(async (file) => {
-      const label = relative3(ctx.cwd, file);
+      const label = relative2(ctx.cwd, file);
       if (ctx.dryRun) {
         planLine(`align node version → ${version} in ${label}`);
         return;
@@ -2368,7 +2368,7 @@ var githubActionsFeature = {
 };
 
 // src/modules/features/types-node/types-node.feature.ts
-import { relative as relative4 } from "node:path";
+import { relative as relative3 } from "node:path";
 
 // src/utils/spec.utils.ts
 var import_semver = __toESM(require_semver2(), 1);
@@ -2400,17 +2400,45 @@ async function dirsWithTypesNode(ctx) {
   }));
   return dirs.filter((dir) => dir !== null);
 }
-function pinTypesNode(pkg, major) {
+function pinTypesNode(pkg, version) {
   return BUCKETS.reduce((changed, bucket) => {
     const deps = pkg[bucket];
     const spec = deps?.[TYPES_NODE_PACKAGE];
     if (deps && spec && !isVersionRange(spec)) {
-      deps[TYPES_NODE_PACKAGE] = major;
-      return true;
+      const next = `${operatorOf(spec)}${version}`;
+      if (next !== spec) {
+        deps[TYPES_NODE_PACKAGE] = next;
+        return true;
+      }
     }
     return changed;
   }, false);
 }
+async function updateTypesNode(ctx, resolveInRange = latestVersionInRange) {
+  const { major } = await ensureNodeLts(ctx);
+  const majorSpec = String(major);
+  const dirs = await dirsWithTypesNode(ctx);
+  if (dirs.length === 0) {
+    return;
+  }
+  if (ctx.dryRun) {
+    dirs.forEach((dir) => {
+      const label = relative3(ctx.cwd, dir) || ".";
+      planLine(`pin ${TYPES_NODE_PACKAGE} to latest ${majorSpec}.x in ${label}`);
+    });
+    return;
+  }
+  const version = await resolveInRange(TYPES_NODE_PACKAGE, majorSpec, viewTool(ctx.packageManager), ctx.cwd);
+  if (!version) {
+    return;
+  }
+  await Promise.all(dirs.map(async (dir) => {
+    const pkg = await readPackageJson(dir);
+    if (pkg && pinTypesNode(pkg, version)) {
+      await writePackageJson(dir, pkg);
+    }
+  }));
+}
 var typesNodeFeature = {
   kind: "feature" /* Feature */,
   id: "types-node",
@@ -2421,22 +2449,7 @@ var typesNodeFeature = {
   async managedDependencies() {
     return [TYPES_NODE_PACKAGE];
   },
-  async update(ctx) {
-    const { major } = await ensureNodeLts(ctx);
-    const majorSpec = String(major);
-    const dirs = await dirsWithTypesNode(ctx);
-    await Promise.all(dirs.map(async (dir) => {
-      const label = relative4(ctx.cwd, dir) || ".";
-      if (ctx.dryRun) {
-        planLine(`pin ${TYPES_NODE_PACKAGE}@${majorSpec} in ${label}`);
-        return;
-      }
-      const pkg = await readPackageJson(dir);
-      if (pkg && pinTypesNode(pkg, majorSpec)) {
-        await writePackageJson(dir, pkg);
-      }
-    }));
-  }
+  update: updateTypesNode
 };
 
 // src/modules/package-managers/bun/bun.package-manager.ts
@@ -2745,7 +2758,7 @@ async function detectModules(ctx) {
 
 // src/commands/detect/detect.command.ts
 async function run2({ values, positionals }) {
-  const cwd = resolve2(positionals[0] ?? process.cwd());
+  const cwd = resolve3(positionals[0] ?? process.cwd());
   const json = values.json ?? false;
   const { ctx, configCreated } = await buildContext(cwd);
   const modules = await detectModules(ctx);
@@ -2843,11 +2856,12 @@ function commandHelp(stream = process.stdout) {
 }
 
 // src/commands/update/update.command.ts
-import { resolve as resolve3 } from "node:path";
+import { resolve as resolve4 } from "node:path";
 async function run4({ values, positionals }) {
-  const cwd = resolve3(positionals[0] ?? process.cwd());
+  const cwd = resolve4(positionals[0] ?? process.cwd());
   const dryRun = values["dry-run"] ?? false;
-  const { ctx, configCreated } = await buildContext(cwd, { dryRun });
+  const exclude = (values.exclude ?? []).flatMap((entry) => entry.split(",")).map((entry) => entry.trim()).filter(Boolean);
+  const { ctx, configCreated } = await buildContext(cwd, { dryRun, exclude });
   if (configCreated) {
     process.stdout.write(`${DIM}Discovered new repo, wrote entry to ${configPath()}${RESET}
 `);
@@ -2860,12 +2874,13 @@ var updateCommand = {
   name: "update",
   run: run4,
   help: () => ({
-    usage: ["bumper update [path] [--dry-run] [--only id]... [--skip id]..."],
+    usage: ["bumper update [path] [--dry-run] [--only id]... [--skip id]... [--exclude path]..."],
     summary: "Run every applicable module in order",
     options: [
       "--dry-run      Print intended steps without changing anything",
       "--only id      Module id to run exclusively (repeat for several)",
-      "--skip id      Module id to skip (repeat for several)"
+      "--skip id      Module id to skip (repeat for several)",
+      "--exclude path Repo-relative path skipped this run, not persisted (repeat or comma-separate)"
     ]
   })
 };
@@ -2882,6 +2897,7 @@ var cliOptions = {
   "dry-run": { type: "boolean" },
   only: { type: "string", multiple: true },
   skip: { type: "string", multiple: true },
+  exclude: { type: "string", multiple: true },
   help: { type: "boolean", short: "h" }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enke.dev/bumper",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",