Nix NPM Update

nix-npm-update: nix管理下のnpm依存更新スキル

このリポジトリにはnpm依存が3種類の形で存在する。常に全種別を対象として、差分があるものだけ更新する。

対象の分類

対象パッケージ:

• secretlint (種別A)
• vue-language-server (種別B)
• vue-typescript-plugin (種別B)
• claude-code (種別C)

手順

1. 現行と最新を確認する

差分が無いものはスキップ。

現行版:

• secretlint: npm pkg get devDependencies.secretlint
• vue-language-server: nix/pkgs/vue-language-server.nix の version 属性
• vue-typescript-plugin: nix/pkgs/vue-typescript-plugin.nix の version 属性
• claude-code: nix/pkgs/claude-code.nix の version 属性

最新版を並列で取得（種別Aだけ version のみ、種別B/C は手順3/4 で tgz情報も使うので最初からまとめて取る）:

npm view secretlint version & \
npm view @vue/language-server version dist.tarball dist.integrity --json > /tmp/vls.json & \
npm view @vue/typescript-plugin version dist.tarball dist.integrity --json > /tmp/vtp.json & \
npm view @anthropic-ai/claude-code version dist.tarball dist.integrity --json > /tmp/cc-main.json & \
wait

npm package名対応:

• vue-language-server → @vue/language-server
• vue-typescript-plugin → @vue/typescript-plugin
• claude-code (main) → @anthropic-ai/claude-code
• claude-code (native) → @anthropic-ai/claude-code-linux-x64

2. 種別A (secretlint) の更新

renovateで自動更新されるため、手動更新の前に open PR を gh pr list --search "secretlint" で確認する。renovate が止まっている等の正当理由がなければスキップ。package.json は固定バージョン記法なので --save-exact を維持する。

npm install --save-exact secretlint@latest @secretlint/secretlint-rule-preset-recommend@latest

3. 種別B (buildNpmPackage) の更新

PKG と NPM_PKG を切り替えて vue-language-server / vue-typescript-plugin の両方に同手順を適用する。

3.1. 手順1のJSONから値を取り出す

PKG=vue-language-server                  # または vue-typescript-plugin
NPM_PKG=@vue/language-server             # または @vue/typescript-plugin
JSON=/tmp/vls.json                       # または /tmp/vtp.json
NEW_VER=$(jq -r '.version' "$JSON")
TGZ_URL=$(jq -r '.dist.tarball' "$JSON")
SHA512=$(jq -r '.dist.integrity' "$JSON")

SHA512 は sha512-...= 形式でそのまま .nix に貼れる。

3.2. package-lock.json を再生成

nix/pkgs/${PKG}-lock.json を新バージョンで作り直す。dontNpmBuild = true; のため --ignore-scripts 必須。

REPO_ROOT="$(git rev-parse --show-toplevel)"
WORK=$(mktemp -d)
mkdir -p "$WORK/src"
curl -sL "$TGZ_URL" | tar xz -C "$WORK/src" --strip-components=1
( cd "$WORK/src" && rm -f package-lock.json && npm install --package-lock-only --ignore-scripts )
cp "$WORK/src/package-lock.json" "$REPO_ROOT/nix/pkgs/${PKG}-lock.json"

3.3. .nix の version/url/sha512 を更新

nix/pkgs/${PKG}.nix の version / url / sha512 を 3.1 の値に書き換える。npmDepsHash は次手順で更新する。

3.4. npmDepsHash を更新

prefetch-npm-deps で lockfile から直接計算する（フルビルド不要）:

nix run nixpkgs#prefetch-npm-deps -- ./nix/pkgs/${PKG}-lock.json

出力された sha256-...= を .nix の npmDepsHash に貼る。

4. 種別C (claude-code) の更新

main は手順1で取得済 (/tmp/cc-main.json)。native はバージョン依存なので、main の version 確定後に取得する。

NEW_VER=$(jq -r '.version' /tmp/cc-main.json)
MAIN_URL=$(jq -r '.dist.tarball' /tmp/cc-main.json)
MAIN_SHA=$(jq -r '.dist.integrity' /tmp/cc-main.json)
eval "$(npm view "@anthropic-ai/claude-code-linux-x64@$NEW_VER" dist.tarball dist.integrity --json \
  | jq -r '"NATIVE_URL=\(.dist.tarball)\nNATIVE_SHA=\(.dist.integrity)"')"

nix/pkgs/claude-code.nix の version, mainTgz.{url,sha512}, nativeTgz.{url,sha512} を書き換える。

native パッケージが新バージョンで未公開のケースがあるため、@anthropic-ai/claude-code-linux-x64@$NEW_VER の npm view がエラーになる場合は更新を中止し、ユーザーに報告する。

5. ビルド検証

種別B/C を更新した場合は home-manager のビルドで npmDepsHash / tgz hash を実評価する:

nix build --no-link ./nix#checks.x86_64-linux.home-manager-build

6. Post-Task Verification と報告

CLAUDE.md (project) の Post-Task Verification (nix run ./nix#lint && nix run ./nix#fmt && nix run ./nix#test) を実行する。

報告フォーマット（差分なしでスキップしたものも明記。コミット・プッシュは明示指示があるまでしない）:

更新対象:
  - <pkg名>: <old> -> <new>
  - <pkg名>: skip (no diff)
変更ファイル:
  - <path>
  - ...
ビルド: ok / fail
lint/fmt/test: ok / fail

注意

• renovateが種別Aを自動更新しているため、種別Aの手動更新はrenovateと競合する可能性がある。実行前に open PR を gh pr list --search "secretlint" で確認する。
• 種別Bのlockファイルは手書き再生成のため、上流の package-lock.json 仕様変更（lockfileVersion）に追随する必要があるケースがある。生成後にlockfileVersionを確認する。

Source: mikinovation/dotfiles — distributed by TomeVault.