@s2j/global-npm 2.0.2 → 2.1.0

package/README.md

@@ -1,7 +1,7 @@
 # 📦 Global npm Package Setup
 
 Node.js の **グローバル npm パッケージ管理** を `package.json` で一元化する CLI です。
-macOS / Windows 11で同じ `global-npm check|update|install` フローを使えます。
+macOS / Windows 11で同じ `global-npm` フローを使えます。
 
 GitHub: [stein2nd/global-npm-setup](https://github.com/stein2nd/global-npm-setup)
 
@@ -11,9 +11,11 @@ GitHub: [stein2nd/global-npm-setup](https://github.com/stein2nd/global-npm-setup
 global-npm check    # グローバルパッケージの更新確認 (ncu)
 global-npm update   # package.json のバージョン範囲を更新 (ncu -u)
 global-npm install  # dependencies を列挙して npm install -g を実行
+global-npm sync     # upstream + user-deps → 物理的なアーカイブを再生成
+global-npm add      # user-deps.json にパッケージを追記
 ```
 
-定番フロー:
+定番フローは、下記の順番になるかと思います。なお、`install` 単体では ncu は実行しません。
 
 ```sh
 global-npm check
@@ -21,7 +23,22 @@ global-npm update
 global-npm install
 ```
 
-`install` 単体では ncu は実行しません。
+## しくみ (v2.1)
+
+| レイヤ | 場所 | 役割 |
+|--------|------|------|
+| Upstream 正本 | `@s2j/global-npm` 同梱 `package.json` | 公式 `dependencies` 一覧 |
+| ユーザー overlay | `$SETUP_DIR/user-deps.json` | 追加分、ピン留め |
+| 物理的なアーカイブ | `$SETUP_DIR/package.json` | ncu / install が読む実効マニフェスト |
+
+**setup ディレクトリ (`$SETUP_DIR`) のデフォルト**
+
+| OS | パス |
+|----|------|
+| macOS / Linux | `~/.config/global-npm` |
+| Windows 11 | `%APPDATA%\global-npm` |
+
+`GLOBAL_NPM_SETUP_DIR` 環境変数で上書きできます。詳細は [docs/layout.md](./docs/layout.md)。
 
 ## セットアップ
 
@@ -36,8 +53,9 @@ Homebrew、Node.js v18以降が未導入の場合は、先にインストール
 2. `node --version`、`npm --version` でバージョンを確認する。
 3. 移行する場合、`~/bin/global-npm` (Zsh ラッパー) が PATH に残っていないか確認する。残っている場合は削除する (npm グローバル bin の `global-npm` と競合する場合がある)。
 
-推奨配置: `~/dotfiles/global-npm-setup/`  
-npm グローバル bin: 通常 `$(npm prefix -g)/bin` (nvm 利用時はその Node に紐づく prefix)
+* 推奨配置 (開発): `~/dotfiles/global-npm-setup/`  
+* setup ディレクトリ: `~/.config/global-npm`  
+* npm グローバル bin: 通常 `$(npm prefix -g)/bin` (nvm 利用時はその Node に紐づく prefix)
 
 ### Windows での下準備
 
@@ -52,62 +70,93 @@ Node.js v18以上 (LTS 推奨) が未導入の場合は、先にインストー
 3. `node --version`、`npm --version` でバージョンを確認する。
 4. PowerShell を再起動後、`global-npm check` (導入後) で PATH を確認する。
 
-推奨配置: `%USERPROFILE%\dotfiles\global-npm-setup\`  
-npm グローバル bin: `%AppData%\npm` (通常 PATH に含まれる)
+* 推奨配置 (開発): `%USERPROFILE%\dotfiles\global-npm-setup\`  
+* setup ディレクトリ: `%APPDATA%\global-npm`  
+* npm グローバル bin: `%AppData%\npm` (通常 PATH に含まれる)
 
 ### npm パッケージの導入
 
-初回 publish 後:
-
 ```sh
-npm install -g @s2j/global-npm
-global-npm install
+npm install -g @s2j/global-npm   # CLI 本体の導入 (これは一度だけ)
+global-npm add @s2j/docs-linter@^1.0.16   # 任意: ユーザー追加分
+global-npm install               # 物理的なアーカイブ化 dependencies を global install
 ```
 
+初回の `global-npm install` で `~/.config/global-npm/` (Windows 11では `%APPDATA%\global-npm\`) に物理的なアーカイブ化 `package.json` が生成されます。
+`global-npm install` は、`@s2j/global-npm` 自身 (自己参照) も含め、`dependencies` のキーを列挙して `npm install -g` します。
+
 ### 開発 — リポジトリ clone
 
 ```sh
 git clone https://github.com/stein2nd/global-npm-setup.git
 cd global-npm-setup
 npm link
+GLOBAL_NPM_SETUP_DIR=.sandbox/setup global-npm sync
 global-npm install
 ```
 
-## package.json の役割
+## ユーザー追加分の管理
 
-同梱の `package.json` の `dependencies` が、グローバルインストール対象パッケージ一覧です。
-`check` / `update` / `install` はいずれもこの一覧を参照します。
+```sh
+# 追加分を登録 (range 省略時は npm view で ^x.y.z、失敗時は *)
+global-npm add typescript
+global-npm add eslint --dev
 
-一覧の変更はリポジトリ更新 → npm publish → `npm update -g @s2j/global-npm` で各環境に反映します。
+# マージ結果を確認 (書き込みなし)
+global-npm sync --dry-run
+```
 
-## 開発用 scripts
+* upstream (`npm update -g @s2j/global-npm`) 更新後も、ユーザー追加分は消えない。
+* upstream 管理パッケージのうち未 update 分は、次回 `check` 時の sync で新 range に追従する。
+* upstream パッケージをピン留めする場合は、`user-deps.json` の `dependencies` に同名で range を書く。
 
-CLI 実装のデバッグ用に、リポジトリ root から次の npm scripts も使えます。
+## 日常の更新サイクル
 
-```sh
-npm run ncu:check
-npm run ncu:update
+```mermaid
+flowchart LR
+  A["global-npm check"] --> B{"更新あり?"}
+  B -->|Yes| C["global-npm update"]
+  C --> D["global-npm install"]
+  B -->|No| E["終了"]
 ```
 
-## グローバルパッケージ一覧の初期取り込み (任意)
+* **check:** sync 後に ncu で更新候補を表示。ncu 自体は range を書き換えない。
+* **update:** 物理的なアーカイブ化 `dependencies` / `devDependencies` の range を更新。
+* **install:** 物理的なアーカイブ化 **dependencies** のみ global install。
+
+## 開発用 scripts
 
-手元のグローバル npm パッケージを `dependencies` に反映する作業です。CLI 実行には jq は不要ですが、この作業で jq を使う場合は任意です。
+CLI 実装のデバッグ用に、リポジトリ root から下記の npm scripts も使えます。
 
 ```sh
-npm ls -g --depth=0 --json > tmp.json
-jq '.dependencies | to_entries | map({ key: .key, value: ("^" + (.value.version | tostring)) }) | from_entries' tmp.json > deps.json
-jq '.dependencies = input' package.json deps.json > package.tmp.json && mv package.tmp.json package.json
-rm tmp.json deps.json
+npm run ncu:check
+npm run ncu:update
 ```
 
-## 移行 (v1→ v2)
+## 移行
+
+### v1→ v2
 
 | v1 | v2 |
 |----|-----|
 | `~/bin/global-npm` (Zsh) | 廃止 — `npm install -g @s2j/global-npm` |
 | `install-global.zsh` | 廃止 — `global-npm install` |
 | `ncu:install` (jq 列挙) | `global-npm install` (Node 列挙) |
-| SETUP_DIR = ラッパー配置 dir (`~/bin`) | package root (npm global install 先) を参照 |
+
+### v2.0.x → v2.1
+
+| v2.0.x | v2.1 |
+|--------|------|
+| setup = package root | setup = `~/.config/global-npm`。Windows は `%APPDATA%\global-npm` |
+| 同梱 `package.json` を直接 ncu | 物理的なアーカイブを ncu |
+| 3サブコマンド | 5サブコマンド (`sync` / `add` 追加) |
+
+移行手順は、下記のとおりです。
+
+1. `npm update -g @s2j/global-npm` で v2.1に上げる。
+2. 追加分を `global-npm add …` で登録する。
+3. `global-npm sync` で 物理的なアーカイブを生成する。
+4. `global-npm install` で global 環境を同期する。
 
 ## ライセンス
 

package/bin/global-npm.cjs

@@ -1,19 +1,27 @@
 #!/usr/bin/env node
 
 const { spawnSync } = require('child_process');
-const fs = require('fs');
 const path = require('path');
 
-const setupDir = path.resolve(__dirname, '..');
-const pkgPath = path.join(setupDir, 'package.json');
+const { toGlobalInstallSpec } = require('../lib/install-spec.cjs');
+const { ensureSetupDir, readDependencies, readUserDeps, writeJson } = require('../lib/pkg-io.cjs');
+const { resolveSetupContext } = require('../lib/paths.cjs');
+const { parseAddSpec, resolveDefaultRange } = require('../lib/resolve-range.cjs');
+const { formatReport, syncManifest } = require('../lib/sync-manifest.cjs');
+
+const packageRoot = path.resolve(__dirname, '..');
+const ctx = resolveSetupContext(packageRoot);
+const { pkgPath } = ctx;
 const shell = process.platform === 'win32';
 
 function usage() {
-  console.error(`Usage: global-npm <check|update|install>
+  console.error(`Usage: global-npm <check|update|install|sync|add>
 
   check    Check for available updates (ncu -g)
   update   Update version ranges in package.json (ncu -g -u)
-  install  Install dependencies globally (npm install -g <each>)`);
+  install  Install dependencies globally (npm install -g <name>@<range>…)
+  sync     Merge upstream + user-deps into materialized package.json
+  add      Add a package to user-deps.json (optional: --dev)`);
   process.exit(1);
 }
 
@@ -31,39 +39,101 @@ function run(command, args) {
   process.exit(result.status ?? 1);
 }
 
+function prepare() {
+  ensureSetupDir(ctx);
+  return syncManifest(ctx);
+}
+
+function handleSync(dryRun) {
+  ensureSetupDir(ctx);
+  const { changed, report } = syncManifest(ctx, { dryRun });
+
+  if (dryRun) {
+    const lines = formatReport(report);
+    if (lines.length === 0) {
+      console.error('No changes.');
+    } else {
+      for (const line of lines) {
+        console.error(line);
+      }
+    }
+    process.exit(0);
+  }
+
+  if (changed) {
+    console.error(`Synced materialized manifest: ${pkgPath}`);
+  }
+
+  process.exit(0);
+}
+
+function handleAdd(args) {
+  const isDev = args.includes('--dev');
+  const positional = args.filter((arg) => arg !== '--dev');
+
+  if (positional.length !== 1) {
+    console.error('Usage: global-npm add <pkg>[@range] [--dev]');
+    process.exit(1);
+  }
+
+  const { name, range: explicitRange } = parseAddSpec(positional[0]);
+  if (!name) {
+    console.error('Package name is required.');
+    process.exit(1);
+  }
+
+  const range =
+    explicitRange !== undefined ? explicitRange : resolveDefaultRange(name);
+
+  ensureSetupDir(ctx);
+  const userDeps = readUserDeps(ctx);
+  const section = isDev ? 'devDependencies' : 'dependencies';
+  userDeps[section][name] = range;
+  writeJson(ctx.userDepsPath, userDeps);
+
+  syncManifest(ctx);
+  console.error(`Added ${name}@${range} to user-deps.json (${section}).`);
+  process.exit(0);
+}
+
 const subcommand = process.argv[2];
+const restArgs = process.argv.slice(3);
 
 switch (subcommand) {
   case 'check':
+    prepare();
     run('ncu', ['-g', '--format', 'time', '--packageFile', pkgPath]);
     break;
 
   case 'update':
+    prepare();
     run('ncu', ['-g', '--format', 'time', '-u', '--packageFile', pkgPath]);
     break;
 
   case 'install': {
-    let dependencies;
-
-    try {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-      dependencies = pkg.dependencies ?? {};
-    } catch (err) {
-      console.error(`Failed to read ${pkgPath}: ${err.message}`);
-      process.exit(1);
-    }
+    prepare();
+    const dependencies = readDependencies(pkgPath);
+    const specs = Object.entries(dependencies).map(([name, versionRange]) =>
+      toGlobalInstallSpec(name, versionRange),
+    );
 
-    const names = Object.keys(dependencies);
-
-    if (names.length === 0) {
+    if (specs.length === 0) {
       console.error('No dependencies to install.');
       process.exit(1);
     }
 
-    run('npm', ['install', '-g', ...names]);
+    run('npm', ['install', '-g', ...specs]);
     break;
   }
 
+  case 'sync':
+    handleSync(restArgs.includes('--dry-run'));
+    break;
+
+  case 'add':
+    handleAdd(restArgs);
+    break;
+
   default:
     usage();
 }

package/lib/install-spec.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+function toGlobalInstallSpec(name, versionRange) {
+  if (typeof versionRange === 'string' && versionRange.trim() !== '') {
+    return `${name}@${versionRange}`;
+  }
+
+  return name;
+}
+
+module.exports = {
+  toGlobalInstallSpec,
+};

package/lib/paths.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+const os = require('os');
+const path = require('path');
+
+function defaultSetupDir() {
+  if (process.platform === 'win32') {
+    const appData =
+      process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming');
+    return path.join(appData, 'global-npm');
+  }
+
+  return path.join(os.homedir(), '.config', 'global-npm');
+}
+
+function resolveSetupContext(packageRoot) {
+  const setupDir = path.resolve(
+    process.env.GLOBAL_NPM_SETUP_DIR?.trim() || defaultSetupDir(),
+  );
+
+  return {
+    packageRoot,
+    setupDir,
+    upstreamPkgPath: path.join(packageRoot, 'package.json'),
+    pkgPath: path.join(setupDir, 'package.json'),
+    userDepsPath: path.join(setupDir, 'user-deps.json'),
+    metaPath: path.join(setupDir, '.upstream-meta.json'),
+  };
+}
+
+module.exports = {
+  defaultSetupDir,
+  resolveSetupContext,
+};

package/lib/pkg-io.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const EMPTY_USER_DEPS = {
+  dependencies: {},
+  devDependencies: {},
+};
+
+function readJson(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  const raw = fs.readFileSync(filePath, 'utf8');
+  return JSON.parse(raw);
+}
+
+function writeJson(filePath, data) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+}
+
+function ensureSetupDir(ctx) {
+  fs.mkdirSync(ctx.setupDir, { recursive: true });
+
+  if (!fs.existsSync(ctx.userDepsPath)) {
+    writeJson(ctx.userDepsPath, { ...EMPTY_USER_DEPS });
+  }
+}
+
+function readUserDeps(ctx) {
+  const data = readJson(ctx.userDepsPath);
+  return {
+    dependencies: { ...(data?.dependencies ?? {}) },
+    devDependencies: { ...(data?.devDependencies ?? {}) },
+  };
+}
+
+function readDependencies(pkgPath) {
+  const pkg = readJson(pkgPath);
+  if (!pkg) {
+    return {};
+  }
+
+  return pkg.dependencies ?? {};
+}
+
+module.exports = {
+  EMPTY_USER_DEPS,
+  readJson,
+  writeJson,
+  ensureSetupDir,
+  readUserDeps,
+  readDependencies,
+};

package/lib/resolve-range.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+const { spawnSync } = require('child_process');
+
+const shell = process.platform === 'win32';
+
+function resolveDefaultRange(pkgName, { spawn = spawnSync, log = console.error } = {}) {
+  const result = spawn('npm', ['view', pkgName, 'version', '--json'], {
+    encoding: 'utf8',
+    shell,
+  });
+
+  if (result.status === 0) {
+    try {
+      const version = JSON.parse(result.stdout.trim());
+      if (typeof version === 'string' && version) {
+        return `^${version}`;
+      }
+    } catch {
+      // fall through to wildcard fallback
+    }
+  }
+
+  log(`Warning: could not resolve latest version for ${pkgName}; using "*".`);
+  return '*';
+}
+
+function parseAddSpec(arg) {
+  if (!arg || typeof arg !== 'string') {
+    return { name: '', range: undefined };
+  }
+
+  if (!arg.startsWith('@')) {
+    const at = arg.lastIndexOf('@');
+    if (at > 0) {
+      return { name: arg.slice(0, at), range: arg.slice(at + 1) };
+    }
+    return { name: arg, range: undefined };
+  }
+
+  const slash = arg.indexOf('/');
+  const at = arg.lastIndexOf('@');
+  if (at > 0 && at > slash) {
+    return { name: arg.slice(0, at), range: arg.slice(at + 1) };
+  }
+
+  return { name: arg, range: undefined };
+}
+
+module.exports = {
+  resolveDefaultRange,
+  parseAddSpec,
+};

package/lib/sync-manifest.cjs

@@ -0,0 +1,221 @@
+'use strict';
+
+const { readJson, writeJson } = require('./pkg-io.cjs');
+
+const MATERIALIZED_NAME = 'global-npm-user-manifest';
+
+function mergeDependencies({ upstream, current, meta, userDeps }) {
+  const merged = {};
+  const upstreamDeps = upstream.dependencies ?? {};
+  const userDepOverrides = userDeps.dependencies ?? {};
+  const prevUpstream = meta?.dependencies ?? {};
+  const currentDeps = current?.dependencies ?? {};
+
+  for (const [name, upstreamRange] of Object.entries(upstreamDeps)) {
+    if (Object.hasOwn(userDepOverrides, name)) {
+      merged[name] = userDepOverrides[name];
+      continue;
+    }
+
+    const currentRange = currentDeps[name];
+    const prevRange = prevUpstream[name];
+
+    if (
+      currentRange !== undefined &&
+      prevRange !== undefined &&
+      currentRange !== prevRange
+    ) {
+      merged[name] = currentRange;
+    } else {
+      merged[name] = upstreamRange;
+    }
+  }
+
+  for (const [name, range] of Object.entries(userDepOverrides)) {
+    if (!Object.hasOwn(upstreamDeps, name)) {
+      merged[name] = range;
+    }
+  }
+
+  for (const [name, range] of Object.entries(currentDeps)) {
+    if (Object.hasOwn(merged, name)) {
+      continue;
+    }
+
+    const wasUpstream = Object.hasOwn(prevUpstream, name);
+    const stillUpstream = Object.hasOwn(upstreamDeps, name);
+
+    if (wasUpstream && !stillUpstream && !Object.hasOwn(userDepOverrides, name)) {
+      continue;
+    }
+
+    merged[name] = range;
+  }
+
+  return merged;
+}
+
+function mergeDevDependencies({ current, meta, userDeps }) {
+  const merged = {};
+  const userDevDeps = userDeps.devDependencies ?? {};
+  const prevUserDevDeps = meta?.userDeps?.devDependencies ?? {};
+  const currentDevDeps = current?.devDependencies ?? {};
+
+  for (const [name, userRange] of Object.entries(userDevDeps)) {
+    const currentRange = currentDevDeps[name];
+    const prevRange = prevUserDevDeps[name];
+
+    if (
+      currentRange !== undefined &&
+      prevRange !== undefined &&
+      currentRange !== prevRange
+    ) {
+      merged[name] = currentRange;
+    } else {
+      merged[name] = userRange;
+    }
+  }
+
+  for (const [name, range] of Object.entries(currentDevDeps)) {
+    if (Object.hasOwn(merged, name) || Object.hasOwn(userDevDeps, name)) {
+      continue;
+    }
+
+    if (Object.hasOwn(prevUserDevDeps, name)) {
+      continue;
+    }
+
+    merged[name] = range;
+  }
+
+  return merged;
+}
+
+function diffSections(before = {}, after = {}) {
+  const added = [];
+  const updated = [];
+  const removed = [];
+
+  for (const [name, range] of Object.entries(after)) {
+    if (!Object.hasOwn(before, name)) {
+      added.push({ name, range });
+    } else if (before[name] !== range) {
+      updated.push({ name, from: before[name], to: range });
+    }
+  }
+
+  for (const name of Object.keys(before)) {
+    if (!Object.hasOwn(after, name)) {
+      removed.push({ name, range: before[name] });
+    }
+  }
+
+  return { added, updated, removed };
+}
+
+function buildReport(beforePkg, afterPkg) {
+  return {
+    dependencies: diffSections(beforePkg?.dependencies, afterPkg.dependencies),
+    devDependencies: diffSections(
+      beforePkg?.devDependencies,
+      afterPkg.devDependencies,
+    ),
+  };
+}
+
+function hasReportChanges(report) {
+  for (const section of Object.values(report)) {
+    if (section.added.length > 0 || section.updated.length > 0 || section.removed.length > 0) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+function formatReport(report) {
+  const lines = [];
+
+  for (const [sectionName, section] of Object.entries(report)) {
+    for (const { name, range } of section.added) {
+      lines.push(`+ ${sectionName} ${name}@${range}`);
+    }
+    for (const { name, from, to } of section.updated) {
+      lines.push(`~ ${sectionName} ${name}: ${from} -> ${to}`);
+    }
+    for (const { name, range } of section.removed) {
+      lines.push(`- ${sectionName} ${name}@${range}`);
+    }
+  }
+
+  return lines;
+}
+
+function buildMaterializedPkg(merged) {
+  return {
+    name: MATERIALIZED_NAME,
+    private: true,
+    dependencies: merged.dependencies,
+    devDependencies: merged.devDependencies,
+  };
+}
+
+function syncManifest(ctx, { dryRun = false } = {}) {
+  const upstream = readJson(ctx.upstreamPkgPath);
+  if (!upstream) {
+    throw new Error(`Failed to read upstream package.json: ${ctx.upstreamPkgPath}`);
+  }
+
+  const userDeps = readJson(ctx.userDepsPath) ?? {
+    dependencies: {},
+    devDependencies: {},
+  };
+  const normalizedUserDeps = {
+    dependencies: { ...(userDeps.dependencies ?? {}) },
+    devDependencies: { ...(userDeps.devDependencies ?? {}) },
+  };
+
+  const current = readJson(ctx.pkgPath);
+  const meta = readJson(ctx.metaPath);
+
+  const merged = {
+    dependencies: mergeDependencies({
+      upstream,
+      current,
+      meta,
+      userDeps: normalizedUserDeps,
+    }),
+    devDependencies: mergeDevDependencies({
+      current,
+      meta,
+      userDeps: normalizedUserDeps,
+    }),
+  };
+
+  const nextPkg = buildMaterializedPkg(merged);
+  const report = buildReport(current, nextPkg);
+  const changed = hasReportChanges(report);
+
+  if (!dryRun) {
+    writeJson(ctx.pkgPath, nextPkg);
+    writeJson(ctx.metaPath, {
+      upstreamVersion: upstream.version,
+      dependencies: { ...(upstream.dependencies ?? {}) },
+      userDeps: {
+        dependencies: { ...normalizedUserDeps.dependencies },
+        devDependencies: { ...normalizedUserDeps.devDependencies },
+      },
+    });
+  }
+
+  return { changed, report, pkgPath: ctx.pkgPath, nextPkg };
+}
+
+module.exports = {
+  MATERIALIZED_NAME,
+  mergeDependencies,
+  mergeDevDependencies,
+  buildMaterializedPkg,
+  syncManifest,
+  formatReport,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s2j/global-npm",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "Manage globally installed npm packages via package.json with ncu.",
   "author": "Koutarou ISHIKAWA <stein2nd@gmail.com>",
   "type": "commonjs",
@@ -10,6 +10,7 @@
   },
   "files": [
     "bin/",
+    "lib/",
     "package.json",
     "LICENSE",
     "README.md"
@@ -34,14 +35,14 @@
     "node": ">=18"
   },
   "scripts": {
-    "test": "node --test test/spec-compliance.test.cjs",
+    "test": "node --test test/*.test.cjs",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "lint:docs": "s2j-docs-linter --profile base ./README.md ./docsMod/**/*.md ./.vscode/**/*.md",
+    "lint:docs": "s2j-docs-linter --profile base ./README.md ./CHANGELOG.md ./docs/**/*.md ./docsMod/status.md ./docsMod/modification.md ./docsMod/mod-overlay-manifest.md ./.vscode/**/*.md",
     "format": "prettier --write \"**/*.{cjs,js,mjs,json}\"",
     "format:check": "prettier --check \"**/*.{cjs,js,mjs,json}\"",
-    "pack": "npm pack --pack-destination artifacts",
-    "pack:dry-run": "npm pack --dry-run --pack-destination artifacts",
+    "pack": "mkdir -p artifacts && npm pack --pack-destination artifacts",
+    "pack:dry-run": "mkdir -p artifacts && npm pack --dry-run --pack-destination artifacts",
     "ncu:check": "ncu -g --format time --packageFile package.json",
     "ncu:update": "ncu -g --format time -u --packageFile package.json"
   },
@@ -55,7 +56,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@s2j/global-npm": "^2.0.1",
+    "@s2j/global-npm": "^2.0.2",
     "corepack": "^0.35.0",
     "editorconfig-cli": "^1.0.0",
     "envinfo": "^7.21.0",