@s2j/global-npm 2.0.2 → 2.0.3

package/README.md

@@ -60,10 +60,12 @@ npm グローバル bin: `%AppData%\npm` (通常 PATH に含まれる)
 初回 publish 後:
 
 ```sh
-npm install -g @s2j/global-npm
-global-npm install
+npm install -g @s2j/global-npm  # CLI 本体の導入（これは一度だけ）
+global-npm install  # dependencies 一覧をすべて global install
 ```
 
+`global-npm install` は、`@s2j/global-npm` 自身 (自己参照 `^2.0.1`) も含め、`dependencies` のキーを列挙して `npm install -g` します。
+
 ### 開発 — リポジトリ clone
 
 ```sh
@@ -80,6 +82,23 @@ global-npm install
 
 一覧の変更はリポジトリ更新 → npm publish → `npm update -g @s2j/global-npm` で各環境に反映します。
 
+
+## 日常の更新サイクル
+
+```mermaid
+flowchart LR
+  A["global-npm check"] --> B{"更新あり?"}
+  B -->|Yes| C["global-npm update"]
+  C --> D["global-npm install"]
+  B -->|No| E["終了"]
+```
+
+* **check** … 読み取り専用。何が新しいか (公開日時付き) を見るだけ
+* **update** … `@s2j/global-npm` 同梱の `package.json` の `dependencies` バージョン範囲を更新
+* **install** … その一覧に従って実際にグローバルパッケージを入れ直す/更新する
+
+`global-npm install` は、`@s2j/global-npm` 自身 (自己参照 `^2.0.1`) も含め、`dependencies` のキーを列挙して `npm install -g` します。
+
 ## 開発用 scripts
 
 CLI 実装のデバッグ用に、リポジトリ root から次の npm scripts も使えます。

package/bin/global-npm.cjs

@@ -13,7 +13,7 @@ function usage() {
 
   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>…)`);
   process.exit(1);
 }
 
@@ -31,6 +31,24 @@ function run(command, args) {
   process.exit(result.status ?? 1);
 }
 
+function toGlobalInstallSpec(name, versionRange) {
+  if (typeof versionRange === 'string' && versionRange.trim() !== '') {
+    return `${name}@${versionRange}`;
+  }
+
+  return name;
+}
+
+function readDependencies() {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    return pkg.dependencies ?? {};
+  } catch (err) {
+    console.error(`Failed to read ${pkgPath}: ${err.message}`);
+    process.exit(1);
+  }
+}
+
 const subcommand = process.argv[2];
 
 switch (subcommand) {
@@ -43,24 +61,17 @@ switch (subcommand) {
     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);
-    }
-
-    const names = Object.keys(dependencies);
+    const dependencies = readDependencies();
+    const specs = Object.entries(dependencies).map(([name, range]) =>
+      toGlobalInstallSpec(name, range),
+    );
 
-    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;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s2j/global-npm",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "Manage globally installed npm packages via package.json with ncu.",
   "author": "Koutarou ISHIKAWA <stein2nd@gmail.com>",
   "type": "commonjs",
@@ -37,11 +37,11 @@
     "test": "node --test test/spec-compliance.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 ./docs/**/*.md ./docsMod/status.md ./docsMod/modification.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 +55,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",