@mcptoolshop/venvkit 0.2.5 → 1.0.0

package/README.it.md

@@ -1,74 +1,74 @@
-<p align="center">
-  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
-</p>
-
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.md">English</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
 <p align="center">
   <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/venvkit/readme.png" alt="venvkit" width="400">
 </p>
-
-# venvkit
-
-> Parte di [MCP Tool Shop](https://mcptoolshop.com)
-
+
+# venvkit
+
+> Parte di [MCP Tool Shop](https://mcptoolshop.com)
+
 <p align="center">
   <a href="https://github.com/mcp-tool-shop-org/venvkit/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/venvkit/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="License: MIT"></a>
   <a href="https://mcp-tool-shop-org.github.io/venvkit/"><img src="https://img.shields.io/badge/Landing_Page-live-blue?style=flat-square" alt="Landing Page"></a>
   <a href="https://www.npmjs.com/package/@mcptoolshop/venvkit"><img src="https://img.shields.io/npm/v/@mcptoolshop/venvkit?style=flat-square&color=cb3837" alt="npm version"></a>
 </p>
-
-**Kit di strumenti diagnostici per ambienti virtuali Python per i flussi di lavoro di Machine Learning su Windows.**
-
-Scansiona il sistema alla ricerca di ambienti Python, diagnostica problemi di salute (SSL, DLL, incompatibilità ABI, perdite di percorsi), tiene traccia della cronologia di esecuzione delle attività, rileva attività instabili e genera una mappa dell'ecosistema.
-
-## Guida rapida
-
+
+**Kit di strumenti diagnostici per ambienti virtuali Python per i flussi di lavoro di machine learning su Windows.**
+
+Scansiona il sistema alla ricerca di ambienti Python, diagnostica problemi di salute (SSL, DLL, incompatibilità ABI, perdite di percorsi), tiene traccia della cronologia di esecuzione delle attività, rileva attività instabili e genera una mappa dell'ecosistema.
+
+## Guida rapida
+
 ```bash
 git clone https://github.com/mcp-tool-shop-org/venvkit && cd venvkit
 npm install && npm run build
 node dist/map_cli.js --root C:\projects --httpsProbe
 # Open .venvkit/venv-map.html in your browser
 ```
-
-## Funzionalità
-
-- **doctorLite** - Controllo rapido dello stato di salute per qualsiasi interprete Python
-- Verifica SSL/TLS
-- Errori di caricamento delle DLL (comuni con PyTorch/CUDA)
-- Incompatibilità ABI (ARM vs x86)
-- Controlli di sanità di pip
-- Rilevamento di perdite di `user-site` e `PYTHONPATH`
-
-- **scanEnvPaths** - Scopri tutti gli ambienti Python presenti nel tuo sistema
-- Trova ambienti virtuali (venv), ambienti conda, versioni pyenv, interpreti di base
-- Profondità e filtri configurabili
-
-- **mapRender** - Visualizza l'ecosistema Python
-- Output in formato JSON per l'uso programmatico
-- Diagrammi Mermaid per la documentazione
-- Raggruppamento degli interpreti di base con analisi del raggio di impatto
-- Visualizzazione del routing delle attività
-
-- **runLog** - Tieni traccia della cronologia di esecuzione delle attività
-- Formato JSONL solo per l'aggiunta di dati
-- Registra quale ambiente ha eseguito quale attività
-- Cattura successo/fallimento con classificazione degli errori
-
-- **taskCluster** - Aggrega le esecuzioni delle attività in base alla firma
-- Rilevamento di attività instabili (passaggi/fallimenti inconsistenti)
-- Rilevamento di instabilità dipendente dall'ambiente
-- Identificazione dei punti critici di errore
-- Analisi della contaminazione (cause radice condivise)
-
-## Installazione
-
+
+## Funzionalità
+
+- **doctorLite** - Controllo rapido dello stato di salute per qualsiasi interprete Python
+- Verifica SSL/TLS
+- Errori di caricamento delle DLL (comuni con PyTorch/CUDA)
+- Incompatibilità ABI (ARM vs x86)
+- Controlli di sanità di pip
+- Rilevamento di perdite di user-site e PYTHONPATH
+
+- **scanEnvPaths** - Scopri tutti gli ambienti Python presenti nel tuo sistema
+- Trova venv, ambienti conda, versioni pyenv, interpreti di base
+- Profondità e filtri configurabili
+
+- **mapRender** - Visualizza il tuo ecosistema Python
+- Output JSON per l'uso programmatico
+- Diagrammi Mermaid per la documentazione
+- Raggruppamento degli interpreti di base con analisi del raggio di impatto
+- Visualizzazione del routing delle attività
+
+- **runLog** - Tieni traccia della cronologia di esecuzione delle attività
+- Formato JSONL solo per l'aggiunta
+- Registra quale ambiente ha eseguito quale attività
+- Cattura successo/fallimento con classificazione degli errori
+
+- **taskCluster** - Aggrega le esecuzioni delle attività per firma
+- Rilevamento di attività instabili (pass/fail inconsistenti)
+- Rilevamento di instabilità dipendente dall'ambiente
+- Identificazione dei punti critici di errore
+- Analisi della contaminazione (cause radice condivise)
+
+## Installazione
+
 ```bash
 npm install
 npm run build
 ```
-
-## Utilizzo della CLI
-
+
+## Utilizzo della CLI
+
 ```bash
 # Scan current directory and generate ecosystem map
 node dist/map_cli.js
@@ -82,33 +82,33 @@ node dist/map_cli.js --runlog .venvkit/runs.jsonl
 # Output options
 node dist/map_cli.js --out ./output --minScore 50 --strict --httpsProbe
 ```
-
-### Opzioni della CLI
-
-| Flag | Descrizione |
-| ------ | ------------- |
-| `--root, -r` | Directory da scansionare (è possibile specificarne più di una) |
-| `--out` | Directory di output (predefinito: `.venvkit`) |
-| `--maxDepth` | Profondità massima delle directory da scansionare (predefinito: 5) |
-| `--strict` | Abilita i controlli in modalità rigorosa |
-| `--httpsProbe` | Testa la connettività HTTPS |
-| `--minScore` | Filtra gli ambienti con un punteggio di salute inferiore a questo valore |
-| `--concurrency` | Controlli paralleli (predefinito: numero di core della CPU) |
-| `--runlog` | Percorso del file di registro delle esecuzioni delle attività (JSONL) |
-| `--no-tasks` | Salta la visualizzazione delle attività |
-
-### Output
-
-| File | Descrizione |
-| ------ | ------------- |
-| `venv-map.json` | Dati completi del grafico (nodi, archi, riepilogo) |
-| `venv-map.mmd` | Codice sorgente del diagramma Mermaid |
-| `venv-map.html` | Visualizzatore interattivo |
-| `reports.json` | Report raw di doctorLite |
-| `insights.json` | Raccomandazioni attuabili |
-
-## Utilizzo programmatico
-
+
+### Opzioni della CLI
+
+| Flag | Descrizione |
+|------|-------------|
+| `--root, -r` | Directory da scansionare (è possibile specificarne più di una) |
+| `--out` | Directory di output (predefinito: `.venvkit`) |
+| `--maxDepth` | Profondità massima della directory da scansionare (predefinito: 5) |
+| `--strict` | Abilita i controlli in modalità rigorosa |
+| `--httpsProbe` | Testa la connettività HTTPS |
+| `--minScore` | Filtra gli ambienti con un punteggio di salute inferiore a questo valore |
+| `--concurrency` | Controlli paralleli (predefinito: numero di core della CPU) |
+| `--runlog` | Percorso del file di log delle esecuzioni delle attività (JSONL) |
+| `--no-tasks` | Salta la visualizzazione delle attività |
+
+### Output
+
+| File | Descrizione |
+|------|-------------|
+| `venv-map.json` | Dati completi del grafico (nodi, archi, riepilogo) |
+| `venv-map.mmd` | Codice sorgente del diagramma Mermaid |
+| `venv-map.html` | Visualizzatore interattivo |
+| `reports.json` | Report dettagliati di doctorLite |
+| `insights.json` | Raccomandazioni attuabili |
+
+## Utilizzo programmatico
+
 ```typescript
 import { doctorLite, scanEnvPaths, mapRender, readRunLog } from 'venvkit';
 
@@ -143,11 +143,11 @@ const { graph, mermaid, insights } = mapRender(reports, runs, {
   includeHotEdgeLabels: true,
 });
 ```
-
-## Schema del registro delle attività
-
-Tieni traccia delle esecuzioni delle attività aggiungendo eventi a un file JSONL:
-
+
+## Schema del file di log
+
+Tieni traccia delle esecuzioni delle attività aggiungendo eventi a un file JSONL:
+
 ```typescript
 import { appendRunLog, newRunId } from 'venvkit';
 
@@ -172,11 +172,11 @@ await appendRunLog('.venvkit/runs.jsonl', {
   },
 });
 ```
-
-## Raggruppamento delle attività
-
-Quando si hanno molte esecuzioni di attività, venvkit le raggruppa in base alla firma:
-
+
+## Raggruppamento delle attività
+
+Quando si hanno molte esecuzioni di attività, venvkit le raggruppa per firma:
+
 ```typescript
 import { clusterRuns, isFlaky, getFailingEnvs } from 'venvkit';
 
@@ -192,11 +192,11 @@ for (const c of clusters) {
   }
 }
 ```
-
-## Schema del grafico
-
-L'output di `mapRender` segue uno schema JSON stabile:
-
+
+## Schema del grafico
+
+L'output di `mapRender` segue uno schema JSON stabile:
+
 ```typescript
 type GraphJSONv1 = {
   version: '1.0';
@@ -217,47 +217,58 @@ type GraphJSONv1 = {
   edges: GraphEdge[];
 };
 ```
-
-### Tipi di nodo
-
-| Type | Descrizione |
-| ------ | ------------- |
-| `base` | Interprete Python di base (ad esempio, `C:\Python311`) |
-| `venv` | Ambiente virtuale |
-| `task` | Firma dell'attività (esecuzioni raggruppate) |
-
-### Tipi di arco
-
-| Type | Descrizione |
-| ------ | ------------- |
-| `USES_BASE` | Relazione venv → base |
-| `ROUTES_TASK_TO` | Routing attività → ambiente |
-| `FAILED_RUN` | Errore attività → ambiente (tratteggiato nei diagrammi Mermaid) |
-
-## Codici di errore
-
-| Code | Gravità | Descrizione |
-| ------ | ---------- | ------------- |
-| `SSL_BROKEN` | bad | Impossibile importare il modulo SSL |
-| `CERT_STORE_FAIL` | warn | La verifica del certificato HTTPS non riesce |
-| `DLL_LOAD_FAIL` | bad | Impossibile caricare la DLL dell'estensione nativa |
-| `ABI_MISMATCH` | bad | Incompatibilità binaria (ARM/x86) |
-| `PIP_MISSING` | warn | pip non disponibile |
-| `PIP_CHECK_FAIL` | warn | Rilevati conflitti di dipendenze |
-| `USER_SITE_LEAK` | warn | I pacchetti utente sono abilitati nell'ambiente virtuale. |
-| `PYTHONPATH_INJECTED` | warn | Variabile d'ambiente PYTHONPATH impostata. |
-| `ARCH_MISMATCH` | bad | Versione a 32 bit di Python quando è richiesta la versione a 64 bit. |
-| `PYVENV_CFG_INVALID` | warn | File pyvenv.cfg corrotto o mancante. |
-
-## Sviluppo
-
+
+### Tipi di nodo
+
+| Tipo | Descrizione |
+|------|-------------|
+| `base` | Interprete Python di base (es. `C:\Python311`) |
+| `venv` | Ambiente virtuale |
+| `task` | Firma dell'attività (esecuzioni raggruppate) |
+
+### Tipi di arco
+
+| Tipo | Descrizione |
+|------|-------------|
+| `USES_BASE` | Relazione venv → interprete di base |
+| `ROUTES_TASK_TO` | Routing attività → ambiente |
+| `FAILED_RUN` | Errore attività → ambiente (tratteggiato in Mermaid) |
+
+## Codici di errore
+
+| Codice | Gravità | Descrizione |
+|------|----------|-------------|
+| `SSL_BROKEN` | bad | Il modulo SSL non riesce a essere importato |
+| `CERT_STORE_FAIL` | warn | La verifica del certificato HTTPS non riesce |
+| `DLL_LOAD_FAIL` | bad | Caricamento della DLL dell'estensione nativa non riesce |
+| `ABI_MISMATCH` | bad | Incompatibilità binaria (ARM/x86) |
+| `PIP_MISSING` | warn | pip non disponibile |
+| `PIP_CHECK_FAIL` | warn | Conflitti di dipendenze rilevati |
+| `USER_SITE_LEAK` | warn | user-site-packages abilitato nell'ambiente virtuale |
+| `PYTHONPATH_INJECTED` | warn | Variabile d'ambiente PYTHONPATH impostata |
+| `ARCH_MISMATCH` | bad | Python a 32 bit quando è richiesto a 64 bit |
+| `PYVENV_CFG_INVALID` | warn | pyvenv.cfg danneggiato o mancante |
+
+## Sviluppo
+
 ```bash
 npm install
 npm run typecheck  # Type check
 npm run test       # Run tests
 npm run build      # Build to dist/
 ```
-
-## Licenza
-
-MIT.
+
+## Sicurezza e ambito dei dati
+
+- **Scansolo in lettura:** I file eseguibili Python e il file pyvenv.cfg vengono letti, ma mai modificati.
+- **Sottoprocessi:** avvia `python` con argomenti controllati, senza l'esecuzione tramite shell.
+- **Rete:** l'opzione `--httpsProbe` (facoltativa) verifica i certificati SSL, ma non vengono effettuate altre richieste in uscita.
+- **Nessun dato di telemetria** viene raccolto o trasmesso; consultare il file [SECURITY.md](SECURITY.md) per la politica completa.
+
+## Licenza
+
+MIT
+
+---
+
+Creato da [MCP Tool Shop](https://mcp-tool-shop.github.io/)

package/README.ja.md

@@ -1,74 +1,74 @@
-<p align="center">
-  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
-</p>
-
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
 <p align="center">
   <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/venvkit/readme.png" alt="venvkit" width="400">
 </p>
-
-# venvkit
-
-> [MCP Tool Shop](https://mcptoolshop.com) の一部
-
+
+# venvkit
+
+> [MCP Tool Shop](https://mcptoolshop.com) の一部
+
 <p align="center">
   <a href="https://github.com/mcp-tool-shop-org/venvkit/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/venvkit/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="License: MIT"></a>
   <a href="https://mcp-tool-shop-org.github.io/venvkit/"><img src="https://img.shields.io/badge/Landing_Page-live-blue?style=flat-square" alt="Landing Page"></a>
   <a href="https://www.npmjs.com/package/@mcptoolshop/venvkit"><img src="https://img.shields.io/npm/v/@mcptoolshop/venvkit?style=flat-square&color=cb3837" alt="npm version"></a>
 </p>
-
-**Windows環境における機械学習ワークフロー向けのPython仮想環境診断ツールキット。**
-
-システム上のPython環境をスキャンし、問題箇所（SSL、DLL、ABIの不一致、パスの漏洩など）を診断し、タスクの実行履歴を追跡し、不安定なタスクを検出し、環境マップを表示します。
-
-## 30秒で始める
-
+
+**Windows環境における機械学習ワークフロー向けのPython仮想環境診断ツールキット。**
+
+システム上のPython環境をスキャンし、問題箇所（SSL、DLL、ABIの不整合、パスの漏洩など）を診断し、タスクの実行履歴を追跡し、不安定なタスクを検出し、環境マップを生成します。
+
+## 30秒で始める
+
 ```bash
 git clone https://github.com/mcp-tool-shop-org/venvkit && cd venvkit
 npm install && npm run build
 node dist/map_cli.js --root C:\projects --httpsProbe
 # Open .venvkit/venv-map.html in your browser
 ```
-
-## 機能
-
-- **doctorLite** - どのPythonインタプリタでも高速なヘルスチェック
-- SSL/TLSの検証
-- DLLのロード失敗（PyTorch/CUDAでよく発生）
-- ABIの不一致（ARM vs x86）
-- pipの健全性チェック
-- ユーザーサイトとPYTHONPATHの漏洩検出
-
-- **scanEnvPaths** - システム上のすべてのPython環境を検出
-- venv、conda環境、pyenvのバージョン、ベースインタプリタを検出
-- 設定可能な深度とフィルタリング
-
-- **mapRender** - Python環境を可視化
-- プログラムで使用するためのグラフJSON出力
-- ドキュメント用のMermaid図
-- ベースインタプリタのグループ化と影響範囲分析
-- タスクのルーティング可視化
-
-- **runLog** - タスクの実行履歴を追跡
-- 追記専用のJSONL形式
-- どの環境でどのタスクが実行されたかを記録
-- 成功/失敗を記録し、エラーを分類
-
-- **taskCluster** - シグネチャごとにタスクの実行をまとめる
-- 不安定なタスクの検出（一貫性のない成功/失敗）
-- 環境に依存する不安定なタスクの検出
-- 失敗のホットスポットの特定
-- 感染分析（共通の根本原因）
-
-## インストール
-
+
+## 機能
+
+- **doctorLite** - 任意のPythonインタプリタの高速ヘルスチェック
+- SSL/TLSの検証
+- DLLのロード失敗（PyTorch/CUDAでよく発生）
+- ABIの不整合（ARM vs x86）
+- pipの健全性チェック
+- ユーザーサイトとPYTHONPATHの漏洩検出
+
+- **scanEnvPaths** - システム上のすべてのPython環境を検出
+- venv、conda環境、pyenvのバージョン、ベースインタプリタを検出
+- 設定可能な深度とフィルタリング
+
+- **mapRender** - Python環境を可視化
+- プログラムでの利用を目的としたグラフのJSON出力
+- ドキュメント用のMermaid図
+- ベースインタプリタのグループ化と影響範囲分析
+- タスクのルーティング可視化
+
+- **runLog** - タスクの実行履歴を追跡
+- 追記専用のJSONL形式
+- どの環境でどのタスクが実行されたかを記録
+- 成功/失敗を記録し、エラーを分類
+
+- **taskCluster** - シグネチャごとにタスクの実行をまとめる
+- 不安定なタスクの検出（一貫性のない成功/失敗）
+- 環境に依存する不安定なタスクの検出
+- 失敗のホットスポットの特定
+- 感染分析（共通の根本原因）
+
+## インストール
+
 ```bash
 npm install
 npm run build
 ```
-
-## CLIの使用方法
-
+
+## CLIの使用方法
+
 ```bash
 # Scan current directory and generate ecosystem map
 node dist/map_cli.js
@@ -82,33 +82,33 @@ node dist/map_cli.js --runlog .venvkit/runs.jsonl
 # Output options
 node dist/map_cli.js --out ./output --minScore 50 --strict --httpsProbe
 ```
-
-### CLIオプション
-
-| Flag | 説明 |
-| ------ | ------------- |
-| `--root, -r` | スキャンするディレクトリ（複数指定可能） |
-| `--out` | 出力ディレクトリ（デフォルト：`.venvkit`） |
-| `--maxDepth` | スキャンする最大ディレクトリ深度（デフォルト：5） |
-| `--strict` | 厳格モードのチェックを有効にする |
-| `--httpsProbe` | HTTPS接続をテストする |
-| `--minScore` | このヘルススコア以下の環境をフィルタリングする |
-| `--concurrency` | 並列チェック（デフォルト：CPUコア数） |
-| `--runlog` | タスク実行ログ（JSONL）のパス |
-| `--no-tasks` | タスクの可視化をスキップする |
-
-### 出力
-
-| File | 説明 |
-| ------ | ------------- |
-| `venv-map.json` | 完全なグラフデータ（ノード、エッジ、概要） |
-| `venv-map.mmd` | Mermaid図のソース |
-| `venv-map.html` | インタラクティブビューア |
-| `reports.json` | 生のdoctorLiteレポート |
-| `insights.json` | 実行可能な推奨事項 |
-
-## プログラムによる使用方法
-
+
+### CLIオプション
+
+| フラグ | 説明 |
+|------|-------------|
+| `--root, -r` | スキャンするディレクトリ（複数指定可能） |
+| `--out` | 出力ディレクトリ（デフォルト：`.venvkit`） |
+| `--maxDepth` | スキャンする最大ディレクトリ深度（デフォルト：5） |
+| `--strict` | 厳格モードのチェックを有効にする |
+| `--httpsProbe` | HTTPS接続をテストする |
+| `--minScore` | このヘルススコア以下の環境をフィルタリングする |
+| `--concurrency` | 並列チェック（デフォルト：CPUコア数） |
+| `--runlog` | タスク実行ログ（JSONL）へのパス |
+| `--no-tasks` | タスクの可視化をスキップする |
+
+### 出力ファイル
+
+| ファイル | 説明 |
+|------|-------------|
+| `venv-map.json` | 完全なグラフデータ（ノード、エッジ、概要） |
+| `venv-map.mmd` | Mermaid図のソース |
+| `venv-map.html` | インタラクティブビューア |
+| `reports.json` | 生のdoctorLiteレポート |
+| `insights.json` | 実行可能な推奨事項 |
+
+## プログラムによる利用方法
+
 ```typescript
 import { doctorLite, scanEnvPaths, mapRender, readRunLog } from 'venvkit';
 
@@ -143,11 +143,11 @@ const { graph, mermaid, insights } = mapRender(reports, runs, {
   includeHotEdgeLabels: true,
 });
 ```
-
-## 実行ログのスキーマ
-
-タスクの実行を追跡するために、イベントをJSONLファイルに追加します。
-
+
+## 実行ログのスキーマ
+
+JSONLファイルにイベントを追記することで、タスクの実行を追跡します。
+
 ```typescript
 import { appendRunLog, newRunId } from 'venvkit';
 
@@ -172,11 +172,11 @@ await appendRunLog('.venvkit/runs.jsonl', {
   },
 });
 ```
-
-## タスクのクラスタリング
-
-タスクの実行が多い場合、venvkitはシグネチャごとにそれらをクラスタリングします。
-
+
+## タスクのクラスタリング
+
+タスクの実行が多い場合、venvkitはシグネチャごとにそれらをクラスタリングします。
+
 ```typescript
 import { clusterRuns, isFlaky, getFailingEnvs } from 'venvkit';
 
@@ -192,11 +192,11 @@ for (const c of clusters) {
   }
 }
 ```
-
-## グラフのスキーマ
-
-`mapRender`の出力は、安定したJSONスキーマに従います。
-
+
+## グラフのスキーマ
+
+`mapRender`の出力は、安定したJSONスキーマに従います。
+
 ```typescript
 type GraphJSONv1 = {
   version: '1.0';
@@ -217,47 +217,58 @@ type GraphJSONv1 = {
   edges: GraphEdge[];
 };
 ```
-
-### ノードの種類
-
-| Type | 説明 |
-| ------ | ------------- |
-| `base` | ベースのPythonインタプリタ（例：`C:\Python311`） |
-| `venv` | 仮想環境 |
-| `task` | タスクのシグネチャ（クラスタリングされた実行） |
-
-### エッジの種類
-
-| Type | 説明 |
-| ------ | ------------- |
-| `USES_BASE` | venvとベースの関係 |
-| `ROUTES_TASK_TO` | タスクと環境のルーティング |
-| `FAILED_RUN` | タスクと環境の失敗（Mermaidでは破線で表示） |
-
-## エラーコード
-
-| Code | 重要度 | 説明 |
-| ------ | ---------- | ------------- |
-| `SSL_BROKEN` | bad | SSLモジュールのインポートに失敗 |
-| `CERT_STORE_FAIL` | warn | HTTPS証明書の検証に失敗 |
-| `DLL_LOAD_FAIL` | bad | ネイティブ拡張DLLのロードに失敗 |
-| `ABI_MISMATCH` | bad | バイナリの互換性がない（ARM/x86） |
-| `PIP_MISSING` | warn | pipが利用できない |
-| `PIP_CHECK_FAIL` | warn | 依存関係の競合が検出された |
-| `USER_SITE_LEAK` | warn | venv環境において、サイトパッケージが有効になっています。 |
-| `PYTHONPATH_INJECTED` | warn | PYTHONPATH環境変数が設定されています。 |
-| `ARCH_MISMATCH` | bad | 64ビットのPythonが必要な場合に、32ビットのPythonが使用されています。 |
-| `PYVENV_CFG_INVALID` | warn | pyvenv.cfgファイルが破損しているか、存在しません。 |
-
-## 開発
-
+
+### ノードの種類
+
+| 種類 | 説明 |
+|------|-------------|
+| `base` | ベースのPythonインタプリタ（例：`C:\Python311`） |
+| `venv` | 仮想環境 |
+| `task` | タスクのシグネチャ（クラスタリングされた実行） |
+
+### エッジの種類
+
+| 種類 | 説明 |
+|------|-------------|
+| `USES_BASE` | venvとベースの関係 |
+| `ROUTES_TASK_TO` | タスクと環境のルーティング |
+| `FAILED_RUN` | タスクと環境の失敗（Mermaidでは破線で表示） |
+
+## エラーコード
+
+| コード | 深刻度 | 説明 |
+|------|----------|-------------|
+| `SSL_BROKEN` | bad | SSLモジュールのインポートに失敗 |
+| `CERT_STORE_FAIL` | warn | HTTPS証明書の検証に失敗 |
+| `DLL_LOAD_FAIL` | bad | ネイティブ拡張DLLのロードに失敗 |
+| `ABI_MISMATCH` | bad | バイナリの互換性がない（ARM/x86） |
+| `PIP_MISSING` | warn | pipが利用できない |
+| `PIP_CHECK_FAIL` | warn | 依存関係の競合が検出された |
+| `USER_SITE_LEAK` | warn | venvでユーザーサイトパッケージが有効になっている |
+| `PYTHONPATH_INJECTED` | warn | PYTHONPATH環境変数が設定されている |
+| `ARCH_MISMATCH` | bad | 64ビットが必要な場合に32ビットのPythonが使用されている |
+| `PYVENV_CFG_INVALID` | warn | 破損または紛失したpyvenv.cfg |
+
+## 開発
+
 ```bash
 npm install
 npm run typecheck  # Type check
 npm run test       # Run tests
 npm run build      # Build to dist/
 ```
-
-## ライセンス
-
-MITライセンス
+
+## セキュリティとデータ範囲
+
+- **読み取り専用スキャン:** Pythonの実行ファイルとpyvenv.cfgファイルは読み込まれますが、変更されることはありません。
+- **サブプロセス:** `python`を特定の引数で起動します。シェルによる実行は行われません。
+- **ネットワーク:** オプションの`--httpsProbe`を使用すると、SSL証明書をテストできます。それ以外の外部へのリクエストは行われません。
+- **テレメトリデータは収集も送信もされません。** 詳細については、[SECURITY.md](SECURITY.md) を参照してください。
+
+## ライセンス
+
+MIT
+
+---
+
+[MCP Tool Shop](https://mcp-tool-shop.github.io/) によって作成されました。