@pecot/tools-mcp 0.0.0-stage → 1.0.0

package/cli/dist/node-runtime.js

@@ -0,0 +1,84 @@
+// 起動する Node.js の版判定。既知の脆弱性の修正を含まない版では CLI と MCP サーバを起動しない。
+// MCP サーバの stderr は利用者の目に入らないため、警告ではなく起動拒否にする。
+// 層構成（domain ← infra ← mcp）のどこにも属さない起動前の確認なので src 直下に置く。
+//
+// このファイルは Node.js 24 の型除去（type stripping）でそのまま実行できる構文だけで書く。
+// enum・namespace・パラメータプロパティを使わず、他モジュールを import しない。
+// ランチャーと hook が node から直接読み込んで checkNodeRuntime を呼ぶため。
+//
+// 判定は cli.ts の main() で行う。静的 import の評価後に動くため、import の段階で落ちる
+// 古い major（23 以前）では案内を出せないことがある。判定だけのエントリモジュールには分けない。
+/**
+系列（major）ごとの最低版。2026-10-21 の Node.js セキュリティリリース
+（Brotli 展開の RCE CVE-2026-111497 ほか）の修正版。25 系はサポート終了で修正版が無い。
+次のセキュリティリリースで上げるときは、現行の版を次のコマンドで列挙する。
+`grep -rn '24.22.1' plugins .githooks`（node_modules・アイコン SVG のヒットは除く）。
+ヒットした箇所を同じ変更で更新する。
+表・engines・フックの期待値・両プラグインの複製の一致は node-runtime.test.ts が検証する。
+*/
+export const MINIMUM_NODE_VERSIONS = {
+    24: '24.22.1',
+    26: '26.12.1',
+};
+function parseVersion(version) {
+    const withoutBuild = (version.split('+', 1)[0] ?? '').replace(/^v/, '');
+    const hyphen = withoutBuild.indexOf('-');
+    const core = hyphen === -1 ? withoutBuild : withoutBuild.slice(0, hyphen);
+    const parts = core.split('.');
+    if (parts.length !== 3 || parts.some(part => !/^\d+$/.test(part)))
+        return undefined;
+    const [major, minor, patch] = parts.map(Number);
+    return major === undefined || minor === undefined || patch === undefined ? undefined : { tuple: [major, minor, patch], prerelease: hyphen !== -1 };
+}
+// semver ではプレリリースは同じ major.minor.patch の release より前になる。
+function isAtLeast(actual, minimum) {
+    const [major, minor, patch] = actual.tuple;
+    const [minimumMajor, minimumMinor, minimumPatch] = minimum;
+    if (major !== minimumMajor)
+        return major > minimumMajor;
+    if (minor !== minimumMinor)
+        return minor > minimumMinor;
+    if (patch !== minimumPatch)
+        return patch > minimumPatch;
+    return !actual.prerelease;
+}
+function requiredVersionsText() {
+    return Object.entries(MINIMUM_NODE_VERSIONS)
+        .map(([major, minimum]) => `${major} 系は ${minimum} 以上`)
+        .join('、');
+}
+/**
+案内に載せる更新先の版。表の最小 major の最低版。
+*/
+export function suggestedNodeVersion() {
+    const majors = Object.keys(MINIMUM_NODE_VERSIONS).map(Number);
+    const lowest = MINIMUM_NODE_VERSIONS[Math.min(...majors)];
+    return lowest ?? '';
+}
+function guidance(version) {
+    return [
+        `Node.js ${version} は既知の脆弱性の修正を含まないため起動しません。`,
+        `  必要な版: ${requiredVersionsText()}`,
+        `  Node.js を更新して再実行してください（nvm の例: nvm install ${suggestedNodeVersion()}）。`,
+    ].join('\n');
+}
+/**
+起動してよい版なら undefined、止めるべき版なら利用者向けの案内文を返す。
+表に無い major は、表の最大 major より新しければ修正後のリリースとみなして許可し、
+それ以外（24 未満・サポート終了の 25 系）は止める。
+*/
+export function checkNodeRuntime(version) {
+    const actual = parseVersion(version);
+    if (actual === undefined)
+        return guidance(version);
+    const minimum = MINIMUM_NODE_VERSIONS[actual.tuple[0]];
+    if (minimum === undefined) {
+        const newest = Math.max(...Object.keys(MINIMUM_NODE_VERSIONS).map(Number));
+        return actual.tuple[0] > newest ? undefined : guidance(version);
+    }
+    const minimumVersion = parseVersion(minimum);
+    if (minimumVersion === undefined)
+        return guidance(version);
+    return isAtLeast(actual, minimumVersion.tuple) ? undefined : guidance(version);
+}
+//# sourceMappingURL=node-runtime.js.map

package/cli/dist/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/cli/dist/version.d.ts

@@ -0,0 +1,19 @@
+/**
+plugin ルート（`plugins/pecot-tools/`）を返す。
+
+`CLAUDE_PLUGIN_ROOT` が最優先。
+bin/pecot-tools は cli を実行用ミラー（`${データ置き場}/runtime/<hash>/cli/dist/`）から起動する。
+そのため source 相対で解決すると、plugin.json の無いミラー側を指す。wrapper が env を必ず渡す。
+
+env が無いとき（`node dist/cli.js` の直叩き・単体配布・テスト）は source 相対。本ファイルは
+src 直下 / dist 直下（tsconfig.build.json の rootDir: src で平坦化）/ 配布ツリーのいずれでも
+plugin ルートから 2 階層下に置かれる。
+src 直下から動かすとこの相対解決が成り立たなくなるため、階層は version.test.ts で固定する。
+*/
+export declare function pluginRoot(): string;
+/**
+plugin.json の version を返す。読めなければ開発用の既定値。
+*/
+export declare function readVersion(): string;
+export declare function loadVersionFromPluginJson(manifestPath: string): string | undefined;
+//# sourceMappingURL=version.d.ts.map

package/cli/dist/version.js

@@ -0,0 +1,44 @@
+// プラグイン版数の解決。cli.ts と今後の mcp の双方から参照するため、cli.ts から独立させている
+// （mcp → cli.ts の import は循環になる）。
+// 層構成は domain ← infra ← mcp。本ファイルはどの層にも属さない共通モジュールとして src 直下に置く。
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const DEFAULT_VERSION = '0.0.0+dev';
+/**
+plugin ルート（`plugins/pecot-tools/`）を返す。
+
+`CLAUDE_PLUGIN_ROOT` が最優先。
+bin/pecot-tools は cli を実行用ミラー（`${データ置き場}/runtime/<hash>/cli/dist/`）から起動する。
+そのため source 相対で解決すると、plugin.json の無いミラー側を指す。wrapper が env を必ず渡す。
+
+env が無いとき（`node dist/cli.js` の直叩き・単体配布・テスト）は source 相対。本ファイルは
+src 直下 / dist 直下（tsconfig.build.json の rootDir: src で平坦化）/ 配布ツリーのいずれでも
+plugin ルートから 2 階層下に置かれる。
+src 直下から動かすとこの相対解決が成り立たなくなるため、階層は version.test.ts で固定する。
+*/
+export function pluginRoot() {
+    const fromEnvironment = process.env['CLAUDE_PLUGIN_ROOT']?.trim();
+    return fromEnvironment === undefined || fromEnvironment === '' ? path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..') : fromEnvironment;
+}
+/**
+plugin.json の version を返す。読めなければ開発用の既定値。
+*/
+export function readVersion() {
+    /* v8 ignore next -- 同梱 plugin.json は常在。読めない場合は loadVersionFromPluginJson の単体テストで担保 */
+    return loadVersionFromPluginJson(path.join(pluginRoot(), '.claude-plugin/plugin.json')) ?? DEFAULT_VERSION;
+}
+export function loadVersionFromPluginJson(manifestPath) {
+    let parsed;
+    try {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- 環境変数か import.meta.url 由来のパス
+        parsed = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    // eslint-disable-next-line no-restricted-syntax -- 直後の typeof で narrowing する
+    const version = parsed?.version;
+    return typeof version === 'string' && version !== '' ? version : undefined;
+}
+//# sourceMappingURL=version.js.map

package/npm-shrinkwrap.json

@@ -0,0 +1,67 @@
+{
+  "name": "@pecot/tools-mcp",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@pecot/tools-mcp",
+      "version": "1.0.0",
+      "license": "MIT",
+      "dependencies": {
+        "@modelcontextprotocol/server": "^2.4.0",
+        "commander": "^14.0.3",
+        "zod": "^4.6.7"
+      },
+      "bin": {
+        "pecot-tools-mcp": "bin/pecot-tools-mcp.mjs"
+      },
+      "engines": {
+        "node": "^24.22.1 || >=26.12.1"
+      }
+    },
+    "node_modules/@modelcontextprotocol/core": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/core/-/core-2.4.0.tgz",
+      "integrity": "sha512-z8QBKqdfXLPzkLQuG4xp8hrVEMm1PZ1IgxMN2sMbJiFiAKOWXnAzogXn2W4aqIBlP1ea6U5yiqVquvUNM1Cj6Q==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "zod": "^4.2.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/@modelcontextprotocol/server": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/server/-/server-2.4.0.tgz",
+      "integrity": "sha512-rgR9yxSaAJ+bcsi/XroT/S2AfPiIWloXAnrdfYSCms9ivVju0ishu/wW0J21Ho6+ZOR1r7RyeRbjiRuF87ix5Q==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@modelcontextprotocol/core": "2.4.0",
+        "zod": "^4.2.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/commander": {
+      "version": "14.0.3",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-14.0.3.tgz",
+      "integrity": "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/zod": {
+      "version": "4.6.7",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.7.tgz",
+      "integrity": "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,23 @@
 {
   "name": "@pecot/tools-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "type": "module",
+  "description": "pecot-tools MCP server (standalone distribution)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pecotcraft/pecot.git",
+    "directory": "plugins/pecot-tools"
+  },
+  "bin": {
+    "pecot-tools-mcp": "bin/pecot-tools-mcp.mjs"
+  },
+  "engines": {
+    "node": "^24.22.1 || >=26.12.1"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.4.0",
+    "commander": "^14.0.3",
+    "zod": "^4.6.7"
+  }
+}