@mcptoolshop/venvkit 0.2.0 → 0.2.5

package/README.hi.md

@@ -0,0 +1,267 @@
+<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">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/venvkit/readme.png" alt="venvkit" width="400">
+</p>
+
+# वीएनवीकिट (venvkit)
+
+यह [MCP टूल शॉप](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>
+
+विंडोज मशीन लर्निंग (एमएल) वर्कफ़्लो के लिए पायथन वर्चुअल एनवायरनमेंट डायग्नोस्टिक टूलकिट।
+
+यह आपके सिस्टम में मौजूद पाइथन वातावरण की जांच करता है, संभावित समस्याओं (जैसे एसएसएल, डीएलएल, एबीआई में असंगति, पाथ लीकेज) का पता लगाता है, कार्यों के निष्पादन इतिहास को ट्रैक करता है, अस्थिर कार्यों की पहचान करता है, और एक पारिस्थितिकी तंत्र का मानचित्र प्रदर्शित करता है।
+
+## 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
+```
+
+## विशेषताएं।
+
+- **डॉक्टरलाइट** - किसी भी पायथन इंटरप्रेटर के लिए त्वरित स्वास्थ्य जांच।
+- एसएसएल/टीएलएस सत्यापन।
+- डीएलएल लोड होने में विफलता (पायटॉर्च/CUDA के साथ आम)।
+- एबीआई (एप्लिकेशन बाइनरी इंटरफेस) में असंगति (एआरएम बनाम एक्स86)।
+- पिप की बुनियादी जांच।
+- उपयोगकर्ता साइट और PYTHONPATH से संबंधित समस्याओं का पता लगाना।
+
+- **scanEnvPaths** - आपके सिस्टम पर मौजूद सभी पाइथन वातावरणों की खोज करें।
+- यह वर्चुअल एनवायरनमेंट (venv), कोंडा एनवायरनमेंट, पायएनव संस्करण और बेस इंटरप्रेटर को ढूंढता है।
+- इसकी गहराई और फ़िल्टरिंग को अनुकूलित किया जा सकता है।
+
+- **मैप रेंडर (mapRender)** - अपने पाइथन इकोसिस्टम को दृश्यमान बनाएं।
+- प्रोग्रामेटिक उपयोग के लिए ग्राफ जेएसओएन आउटपुट।
+- दस्तावेज़ों के लिए मर्मेड आरेख।
+- बेस इंटरप्रेटर समूहों का वर्गीकरण और संभावित प्रभाव विश्लेषण।
+- कार्य रूटिंग का दृश्य प्रदर्शन।
+
+- **रन लॉग (runLog)** - कार्यों के निष्पादन इतिहास को ट्रैक करता है।
+- यह केवल डेटा जोड़ने की अनुमति देने वाले JSONL प्रारूप में होता है।
+- यह रिकॉर्ड करता है कि किस वातावरण में कौन सा कार्य चलाया गया था।
+- यह सफलता/विफलता को त्रुटि वर्गीकरण के साथ दर्ज करता है।
+
+- **टास्कक्लस्टर:** हस्ताक्षर के आधार पर कार्यों के परिणामों का एकत्रीकरण।
+- अस्थिर कार्यों का पता लगाना (असंगत पास/विफल परिणाम)।
+- वातावरण पर निर्भर अस्थिरता का पता लगाना।
+- विफलता के मुख्य कारणों की पहचान।
+- संक्रामक विश्लेषण (साझा मूल कारण)।
+
+## स्थापना।
+
+```bash
+npm install
+npm run build
+```
+
+## कमांड लाइन इंटरफेस (सीएलआई) का उपयोग
+
+```bash
+# Scan current directory and generate ecosystem map
+node dist/map_cli.js
+
+# Scan specific directories
+node dist/map_cli.js --root C:\projects --root D:\ml-experiments
+
+# Include task run history
+node dist/map_cli.js --runlog .venvkit/runs.jsonl
+
+# Output options
+node dist/map_cli.js --out ./output --minScore 50 --strict --httpsProbe
+```
+
+### कमांड लाइन विकल्प।
+
+| Flag | विवरण। |
+| "Please provide the English text you would like me to translate into Hindi." | कृपया वह अंग्रेजी पाठ प्रदान करें जिसका आप हिंदी में अनुवाद करवाना चाहते हैं। |
+| `--root, -r` | स्कैन करने के लिए फ़ोल्डर (आप एक से अधिक फ़ोल्डर भी निर्दिष्ट कर सकते हैं)। |
+| `--out` | आउटपुट डायरेक्टरी (डिफ़ॉल्ट: `.venvkit`) |
+| `--maxDepth` | स्कैन करने के लिए अधिकतम फ़ोल्डर की गहराई (डिफ़ॉल्ट: 5)। |
+| `--strict` | सख्त मोड की जांच सक्षम करें। |
+| `--httpsProbe` | एचटीटीपीएस कनेक्टिविटी का परीक्षण करें। |
+| `--minScore` | इस स्वास्थ्य स्कोर से नीचे के वातावरणों को फ़िल्टर करें। |
+| `--concurrency` | समानांतर जांच (डिफ़ॉल्ट: सीपीयू की संख्या)। |
+| `--runlog` | टास्क रन लॉग (JSONL) तक पहुंचने का रास्ता। |
+| `--no-tasks` | कार्य प्रदर्शन का दृश्य छोड़ें। |
+
+### परिणाम।
+
+| File | विवरण। |
+| "Please provide the English text you would like me to translate into Hindi." | कृपया वह अंग्रेजी पाठ प्रदान करें जिसका आप हिंदी में अनुवाद करवाना चाहते हैं। |
+| `venv-map.json` | पूरा ग्राफ डेटा (नोड, किनारे, सारांश)। |
+| `venv-map.mmd` | मर्मेड आरेख का स्रोत। |
+| `venv-map.html` | इंटरैक्टिव दर्शक। |
+| `reports.json` | अद्यतित डॉक्टरलाइट रिपोर्ट (बिना किसी प्रसंस्करण के)। |
+| `insights.json` | कार्यान्वयन योग्य सुझाव। |
+
+## प्रोग्रामेटिक उपयोग।
+
+```typescript
+import { doctorLite, scanEnvPaths, mapRender, readRunLog } from 'venvkit';
+
+// Check a specific Python
+const report = await doctorLite({
+  pythonPath: 'C:\\project\\.venv\\Scripts\\python.exe',
+  requiredModules: ['torch', 'transformers'],
+  httpsProbe: true,
+});
+
+console.log(report.status); // 'good' | 'warn' | 'bad'
+console.log(report.score);  // 0-100
+console.log(report.findings); // Array of issues
+
+// Scan for all Python environments
+const scan = await scanEnvPaths({
+  roots: ['C:\\projects'],
+  maxDepth: 5,
+});
+
+// Run doctorLite on all found environments
+const reports = await Promise.all(
+  scan.pythonPaths.map(p => doctorLite({ pythonPath: p }))
+);
+
+// Load task execution history
+const runs = await readRunLog('.venvkit/runs.jsonl');
+
+// Generate ecosystem visualization
+const { graph, mermaid, insights } = mapRender(reports, runs, {
+  taskMode: 'clustered', // 'none' | 'runs' | 'clustered'
+  includeHotEdgeLabels: true,
+});
+```
+
+## रन लॉग स्कीमा।
+
+कार्यों के निष्पादन को ट्रैक करने के लिए, घटनाओं को एक JSONL फ़ाइल में जोड़ें:
+
+```typescript
+import { appendRunLog, newRunId } from 'venvkit';
+
+await appendRunLog('.venvkit/runs.jsonl', {
+  version: '1.0',
+  runId: newRunId(),
+  at: new Date().toISOString(),
+  task: {
+    name: 'train',
+    command: 'python train.py --epochs 10',
+    requirements: { packages: ['torch', 'transformers'] },
+  },
+  selected: {
+    pythonPath: 'C:\\project\\.venv\\Scripts\\python.exe',
+    score: 95,
+    status: 'good',
+  },
+  outcome: {
+    ok: true,
+    exitCode: 0,
+    durationMs: 45000,
+  },
+});
+```
+
+## कार्य समूहीकरण।
+
+जब आपके पास कई कार्य (टास्क) चल रहे होते हैं, तो venvkit उन्हें उनके "सिग्नेचर" के आधार पर समूहीकृत करता है।
+
+```typescript
+import { clusterRuns, isFlaky, getFailingEnvs } from 'venvkit';
+
+const clusters = clusterRuns(runs);
+
+for (const c of clusters) {
+  console.log(`${c.sig.name}: ${c.ok}/${c.runs} (${(c.successRate * 100).toFixed(0)}%)`);
+
+  if (isFlaky(c)) {
+    console.log(`  WARNING: Flaky task!`);
+    const badEnvs = getFailingEnvs(c, 3);
+    console.log(`  Failing most on: ${badEnvs.map(e => e.pythonPath).join(', ')}`);
+  }
+}
+```
+
+## ग्राफ स्कीमा।
+
+`mapRender` का आउटपुट एक स्थिर JSON स्कीमा का पालन करता है:
+
+```typescript
+type GraphJSONv1 = {
+  version: '1.0';
+  generatedAt: string;
+  host: { os: string; arch: string; hostname: string };
+  summary: {
+    envCount: number;
+    baseCount: number;
+    taskCount: number;
+    healthy: number;
+    warning: number;
+    broken: number;
+    runsPassed: number;
+    runsFailed: number;
+    topIssues: Array<{ code: string; count: number; hint: string }>;
+  };
+  nodes: GraphNode[];
+  edges: GraphEdge[];
+};
+```
+
+### नोड के प्रकार।
+
+| Type | विवरण। |
+| "The quick brown fox jumps over the lazy dog."
+
+"तेज़ भूरी लोमड़ी आलसी कुत्ते के ऊपर से कूदती है।" | कृपया वह अंग्रेजी पाठ प्रदान करें जिसका आप हिंदी में अनुवाद करवाना चाहते हैं। मैं उसका सटीक और उचित अनुवाद करने के लिए तैयार हूं। |
+| `base` | पायथन इंटरप्रेटर का मूल संस्करण (उदाहरण के लिए, `C:\Python311`)। |
+| `venv` | वर्चुअल वातावरण। |
+| `task` | कार्य हस्ताक्षर (समूहीकृत रन)। |
+
+### किनारों के प्रकार।
+
+| Type | विवरण। |
+| "The quick brown fox jumps over the lazy dog."
+
+"तेज़ भूरी लोमड़ी आलसी कुत्ते के ऊपर से कूदती है।" | कृपया वह अंग्रेजी पाठ प्रदान करें जिसका आप हिंदी में अनुवाद करवाना चाहते हैं। |
+| `USES_BASE` | "venv" और "बेस" के बीच का संबंध। |
+| `ROUTES_TASK_TO` | कार्य → पर्यावरण रूटिंग |
+| `FAILED_RUN` | कार्य → पर्यावरण विफलता (मर्मेड आरेख में डैश के साथ दर्शाया गया) |
+
+## कोड्स खोजना।
+
+| Code | गंभीरता। | विवरण। |
+| "Please provide the English text you would like me to translate into Hindi." | ज़रूर, मैं आपकी मदद कर सकता हूँ। कृपया वह अंग्रेजी पाठ प्रदान करें जिसका आप हिंदी में अनुवाद करवाना चाहते हैं। | कृपया वह अंग्रेजी पाठ प्रदान करें जिसका आप हिंदी में अनुवाद करवाना चाहते हैं। |
+| `SSL_BROKEN` | bad | एसएसएल मॉड्यूल आयात करने में विफल हो रहा है। |
+| `CERT_STORE_FAIL` | warn | एचटीटीपीएस प्रमाणपत्र की जांच में त्रुटि हुई। |
+| `DLL_LOAD_FAIL` | bad | मूल एक्सटेंशन डीएलएल (DLL) को लोड करने में विफलता। |
+| `ABI_MISMATCH` | bad | बाइनरी असंगति (एआरएम/एक्स86) |
+| `PIP_MISSING` | warn | "पिप" उपलब्ध नहीं है। |
+| `PIP_CHECK_FAIL` | warn | निर्भरता संबंधी टकराव पाए गए। |
+| `USER_SITE_LEAK` | warn | उपयोगकर्ता साइट-पैकेजों को वर्चुअल एनवायरनमेंट में सक्षम किया गया है। |
+| `PYTHONPATH_INJECTED` | warn | PYTHONPATH पर्यावरण चर सेट है। |
+| `ARCH_MISMATCH` | bad | 64-बिट सिस्टम पर 32-बिट पाइथन का उपयोग किया जा रहा है, जबकि 64-बिट की आवश्यकता है। |
+| `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/
+```
+
+## लाइसेंस।
+
+एमआईटी।

package/README.it.md

@@ -0,0 +1,263 @@
+<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">
+  <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)
+
+<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
+
+```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
+
+```bash
+npm install
+npm run build
+```
+
+## Utilizzo della CLI
+
+```bash
+# Scan current directory and generate ecosystem map
+node dist/map_cli.js
+
+# Scan specific directories
+node dist/map_cli.js --root C:\projects --root D:\ml-experiments
+
+# Include task run history
+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
+
+```typescript
+import { doctorLite, scanEnvPaths, mapRender, readRunLog } from 'venvkit';
+
+// Check a specific Python
+const report = await doctorLite({
+  pythonPath: 'C:\\project\\.venv\\Scripts\\python.exe',
+  requiredModules: ['torch', 'transformers'],
+  httpsProbe: true,
+});
+
+console.log(report.status); // 'good' | 'warn' | 'bad'
+console.log(report.score);  // 0-100
+console.log(report.findings); // Array of issues
+
+// Scan for all Python environments
+const scan = await scanEnvPaths({
+  roots: ['C:\\projects'],
+  maxDepth: 5,
+});
+
+// Run doctorLite on all found environments
+const reports = await Promise.all(
+  scan.pythonPaths.map(p => doctorLite({ pythonPath: p }))
+);
+
+// Load task execution history
+const runs = await readRunLog('.venvkit/runs.jsonl');
+
+// Generate ecosystem visualization
+const { graph, mermaid, insights } = mapRender(reports, runs, {
+  taskMode: 'clustered', // 'none' | 'runs' | 'clustered'
+  includeHotEdgeLabels: true,
+});
+```
+
+## Schema del registro delle attività
+
+Tieni traccia delle esecuzioni delle attività aggiungendo eventi a un file JSONL:
+
+```typescript
+import { appendRunLog, newRunId } from 'venvkit';
+
+await appendRunLog('.venvkit/runs.jsonl', {
+  version: '1.0',
+  runId: newRunId(),
+  at: new Date().toISOString(),
+  task: {
+    name: 'train',
+    command: 'python train.py --epochs 10',
+    requirements: { packages: ['torch', 'transformers'] },
+  },
+  selected: {
+    pythonPath: 'C:\\project\\.venv\\Scripts\\python.exe',
+    score: 95,
+    status: 'good',
+  },
+  outcome: {
+    ok: true,
+    exitCode: 0,
+    durationMs: 45000,
+  },
+});
+```
+
+## Raggruppamento delle attività
+
+Quando si hanno molte esecuzioni di attività, venvkit le raggruppa in base alla firma:
+
+```typescript
+import { clusterRuns, isFlaky, getFailingEnvs } from 'venvkit';
+
+const clusters = clusterRuns(runs);
+
+for (const c of clusters) {
+  console.log(`${c.sig.name}: ${c.ok}/${c.runs} (${(c.successRate * 100).toFixed(0)}%)`);
+
+  if (isFlaky(c)) {
+    console.log(`  WARNING: Flaky task!`);
+    const badEnvs = getFailingEnvs(c, 3);
+    console.log(`  Failing most on: ${badEnvs.map(e => e.pythonPath).join(', ')}`);
+  }
+}
+```
+
+## Schema del grafico
+
+L'output di `mapRender` segue uno schema JSON stabile:
+
+```typescript
+type GraphJSONv1 = {
+  version: '1.0';
+  generatedAt: string;
+  host: { os: string; arch: string; hostname: string };
+  summary: {
+    envCount: number;
+    baseCount: number;
+    taskCount: number;
+    healthy: number;
+    warning: number;
+    broken: number;
+    runsPassed: number;
+    runsFailed: number;
+    topIssues: Array<{ code: string; count: number; hint: string }>;
+  };
+  nodes: GraphNode[];
+  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
+
+```bash
+npm install
+npm run typecheck  # Type check
+npm run test       # Run tests
+npm run build      # Build to dist/
+```
+
+## Licenza
+
+MIT.