@cheongfish/bouncer 0.1.10 → 0.1.13

package/README.md

@@ -8,9 +8,12 @@ runtime과 같은 version이어야 합니다.
 선택하세요.
 
 ```bash
-npm install --global @cheongfish/bouncer@0.1.10
+npm install --global @cheongfish/bouncer@0.1.13
 ```
 
+전역 설치는 npm prefix의 실행 파일 디렉터리를 사용자 PATH에 등록합니다. 새
+터미널을 열어 변경 사항을 적용하세요.
+
 프로젝트 local 설치도 지원합니다. 일반 터미널은 `node_modules/.bin`의 shim을
 PATH에 추가할 수 있지만, plugin hook이 호스트 PATH를 상속하지 않는 환경에서는
 `BOUNCER_BIN`에 `node_modules/.bin/bouncer`의 절대 경로를 지정하세요.
@@ -18,7 +21,7 @@ PATH에 추가할 수 있지만, plugin hook이 호스트 PATH를 상속하지
 runtime을 다시 설치해야 shim이 생성됩니다.
 
 ```bash
-npm install --save-dev @cheongfish/bouncer@0.1.10
+npm install --save-dev @cheongfish/bouncer@0.1.13
 ```
 
 PowerShell은 local 설치의 `node_modules/.bin/bouncer.cmd`를, 전역 설치는 PATH에

package/bin/register-path.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const env = process.env;
+const isGlobal = /^(1|true)$/i.test(env.npm_config_global || env.NPM_CONFIG_GLOBAL || '')
+  || /^(global)$/i.test(env.npm_config_location || env.NPM_CONFIG_LOCATION || '');
+if (!isGlobal) process.exit(0);
+
+const prefix = env.npm_config_prefix || env.NPM_CONFIG_PREFIX;
+if (!prefix) process.exit(0);
+
+const binDir = process.platform === 'win32' ? path.resolve(prefix) : path.resolve(prefix, 'bin');
+const marker = '# bouncer npm global PATH';
+
+function addBlock(file, block) {
+  let content = '';
+  try { content = fs.readFileSync(file, 'utf8'); } catch (error) {
+    if (error.code !== 'ENOENT') throw error;
+  }
+  if (content.includes(marker)) return false;
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.appendFileSync(file, `${content && !content.endsWith('\n') ? '\n' : ''}${block}\n`, { mode: 0o600 });
+  return true;
+}
+
+function posix() {
+  const escaped = binDir.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\$/g, '\\$').replace(/`/g, '\\`');
+  const line = `${marker}\nexport PATH="${escaped}:$PATH"`;
+  const home = os.homedir();
+  const files = [path.join(home, '.profile')];
+  const shell = path.basename(env.SHELL || '');
+  if (shell === 'bash') files.push(path.join(home, '.bashrc'));
+  if (shell === 'zsh') files.push(path.join(home, '.zshrc'));
+  if (shell === 'fish') {
+    const fishLine = `${marker}\nfish_add_path --global ${JSON.stringify(binDir)}`;
+    files.push(path.join(home, '.config', 'fish', 'conf.d', 'bouncer-path.fish'));
+    fs.mkdirSync(path.dirname(files.at(-1)), { recursive: true });
+    fs.writeFileSync(files.at(-1), `${fishLine}\n`, { mode: 0o600 });
+    files.pop();
+  }
+  let changed = 0;
+  for (const file of files) if (addBlock(file, line)) changed++;
+  return changed;
+}
+
+function windows() {
+  const ps = [
+    '$p = [Environment]::GetEnvironmentVariable("Path", "User")',
+    `$d = ${JSON.stringify(binDir)}`,
+    '$parts = @($p -split ";" | Where-Object { $_ })',
+    'if (-not ($parts | Where-Object { $_.TrimEnd("\\") -ieq $d.TrimEnd("\\") })) {',
+    '  [Environment]::SetEnvironmentVariable("Path", (($parts + $d) -join ";"), "User")',
+    '  Write-Output "added"',
+    '}',
+  ].join('; ');
+  const result = spawnSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', ps], { encoding: 'utf8' });
+  if (result.status !== 0) throw new Error(result.stderr || 'Could not update the Windows user PATH');
+  return result.stdout.includes('added') ? 1 : 0;
+}
+
+try {
+  const changed = process.platform === 'win32' ? windows() : posix();
+  if (changed) process.stdout.write(`bouncer: 사용자 PATH에 ${binDir} 경로를 추가했습니다. 새 터미널에서 적용됩니다.\n`);
+} catch (error) {
+  process.stderr.write(`bouncer: npm 전역 경로를 PATH에 자동 등록하지 못했습니다: ${error.message}\n`);
+}

package/dist/.build-stamp

@@ -1 +1 @@
-sha256:7abe62097bbb29562f470a8e2eb46654e2dbf1cba03f5a19b9e01199371e2826
+sha256:21c4cc141801913f284cfe283152673350e5dec5c2b00201e499bfad00b4d402

package/dist/coordinate-next.js

@@ -145,7 +145,7 @@ function attachCard(result, readCard) {
             return {
                 ...fail('coordinator-card-missing'),
                 cause: error.message,
-                next: 'Install the matching npm runtime version or repair BOUNCER_HOME to the matching plugin install.',
+                next: 'Install a compatible npm runtime version or repair BOUNCER_HOME to a compatible plugin install.',
             };
         }
         return fail('coordinator-card-missing');

package/dist/plugin-root.js

@@ -59,7 +59,11 @@ function readCandidate(host, root) {
                 const metadata = JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.join(absolute, metadataFile), 'utf8'));
                 const version = parseVersion(metadata.version);
                 if ((metadata.name === 'bouncer' || metadata.name === '@cheongfish/bouncer') && version) {
-                    return { host, path: absolute, version };
+                    return {
+                        host, path: absolute, version,
+                        ...(typeof metadata.runtimeCompatibility === 'string'
+                            ? { runtimeCompatibility: metadata.runtimeCompatibility } : {}),
+                    };
                 }
             }
             catch {
@@ -169,13 +173,41 @@ function resolvePluginRoot(options = {}, host) {
  * @returns {void} 일치하면 반환하고, 다르면 식별 가능한 Error를 던진다
  */
 function assertPluginVersion(candidate, runtimeVersion = readRuntimeVersion()) {
-    if (candidate.version === runtimeVersion)
+    const range = candidate.runtimeCompatibility;
+    const supported = range === undefined
+        ? candidate.version === runtimeVersion
+        : isRuntimeCompatible(runtimeVersion, range);
+    if (supported)
         return;
-    const error = new Error(`Bouncer plugin version ${candidate.version} does not match runtime version ${runtimeVersion}; `
-        + 'install the matching npm runtime version or repair BOUNCER_HOME to the matching plugin install');
+    const error = new Error(`Bouncer plugin version ${candidate.version} is incompatible with runtime version ${runtimeVersion}`
+        + `${range === undefined ? '' : ` (supported: ${range})`}; `
+        + 'install a compatible npm runtime version or repair BOUNCER_HOME to a compatible plugin install');
     error.code = 'BOUNCER_PLUGIN_VERSION_MISMATCH';
     throw error;
 }
+function isRuntimeCompatible(version, range) {
+    // Deliberately accept only explicit comparator sets to keep manifest parsing predictable.
+    const clauses = range.trim().split(/\s+/);
+    if (clauses.length === 0 || clauses.some((clause) => !/^(>=|>|<=|<|=)\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(clause))) {
+        return false;
+    }
+    return clauses.every((clause) => {
+        const match = /^(>=|>|<=|<|=)(.+)$/.exec(clause);
+        if (!match || !parseVersion(match[2]))
+            return false;
+        const order = compareSemverDesc(version, match[2]);
+        // compareSemverDesc returns positive when version sorts before the bound.
+        if (match[1] === '>=')
+            return order <= 0;
+        if (match[1] === '>')
+            return order < 0;
+        if (match[1] === '<=')
+            return order >= 0;
+        if (match[1] === '<')
+            return order > 0;
+        return order === 0;
+    });
+}
 /**
  * 설치된 CLI package.json의 버전을 읽는다. 자산 manifest와 runtime의 비교 기준은
  * 실제 실행 중인 npm package에 고정해 배포본 간 불일치를 선택 직후 드러낸다.
@@ -192,7 +224,8 @@ function readRuntimeVersion() {
 /**
  * 플러그인 자산(`agents/`, `references/coordinator-cards/`)을 읽을 검증된 루트를 돌려준다.
  * 순서는 `BOUNCER_HOME` → strict-semver가 가장 높은 host 후보이며, 선택된 설치의
- * version은 runtime package version과 일치해야 한다. runtime tree는 자산 설치 여부를
+ * `runtimeCompatibility`가 있으면 runtime version이 범위에 포함되어야 한다. 오래된
+ * manifest는 plugin version과 runtime version이 일치해야 한다. runtime tree는 자산 설치 여부를
  * 증명하지 않으므로 후보로 추론하지 않는다.
  *
  * @param {AssetRootOptions} [options] - `env`, `homeDir`, resolver 테스트용 `runtimeVersion`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cheongfish/bouncer",
-  "version": "0.1.10",
+  "version": "0.1.13",
   "license": "Apache-2.0",
   "description": "Deterministic runtime for the Bouncer plugin",
   "repository": {
@@ -28,6 +28,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json && node bin/build-stamp.js --write",
+    "postinstall": "node bin/register-path.js",
     "prepack": "npm run build"
   }
 }