@mcptoolshop/venvkit 0.2.5 → 1.0.0

package/README.hi.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.md">English</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) का एक हिस्सा है।
-
+
+# 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>
-
-विंडोज मशीन लर्निंग (एमएल) वर्कफ़्लो के लिए पायथन वर्चुअल एनवायरनमेंट डायग्नोस्टिक टूलकिट।
-
-यह आपके सिस्टम में मौजूद पाइथन वातावरण की जांच करता है, संभावित समस्याओं (जैसे एसएसएल, डीएलएल, एबीआई में असंगति, पाथ लीकेज) का पता लगाता है, कार्यों के निष्पादन इतिहास को ट्रैक करता है, अस्थिर कार्यों की पहचान करता है, और एक पारिस्थितिकी तंत्र का मानचित्र प्रदर्शित करता है।
-
-## 30 सेकंड में त्वरित शुरुआत।
-
+
+**विंडोज एमएल वर्कफ़्लो के लिए पायथन वर्चुअल एनवायरनमेंट डायग्नोस्टिक टूलकिट।**
+
+यह आपके सिस्टम में पायथन एनवायरनमेंट की जांच करता है, स्वास्थ्य संबंधी समस्याओं (एसएसएल, डीएलएल, एबीआई मिसमैच, पाथ लीकेज) का निदान करता है, टास्क निष्पादन इतिहास को ट्रैक करता है, अस्थिर टास्क का पता लगाता है, और एक इकोसिस्टम मैप प्रदर्शित करता है।
+
+## 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 प्रारूप में होता है।
-- यह रिकॉर्ड करता है कि किस वातावरण में कौन सा कार्य चलाया गया था।
-- यह सफलता/विफलता को त्रुटि वर्गीकरण के साथ दर्ज करता है।
-
-- **टास्कक्लस्टर:** हस्ताक्षर के आधार पर कार्यों के परिणामों का एकत्रीकरण।
-- अस्थिर कार्यों का पता लगाना (असंगत पास/विफल परिणाम)।
-- वातावरण पर निर्भर अस्थिरता का पता लगाना।
-- विफलता के मुख्य कारणों की पहचान।
-- संक्रामक विश्लेषण (साझा मूल कारण)।
-
-## स्थापना।
-
+
+## विशेषताएं
+
+- **doctorLite** - किसी भी पायथन इंटरप्रेटर के लिए त्वरित स्वास्थ्य जांच
+- एसएसएल/टीएलएस सत्यापन
+- डीएलएल लोड विफलता (पायटॉर्च/CUDA के साथ आम)
+- एबीआई मिसमैच (एआरएम बनाम x86)
+- पिप की जांच
+- यूजर-साइट और PYTHONPATH का पता लगाना
+
+- **scanEnvPaths** - आपके सिस्टम में सभी पायथन एनवायरनमेंट खोजें
+- वर्चुअल एनवायरनमेंट, कोंडा एनवायरनमेंट, पायएनव संस्करण, बेस इंटरप्रेटर खोजता है
+- कॉन्फ़िगर करने योग्य गहराई और फ़िल्टरिंग
+
+- **mapRender** - अपने पायथन इकोसिस्टम को विज़ुअलाइज करें
+- प्रोग्रामेटिक उपयोग के लिए ग्राफ JSON आउटपुट
+- दस्तावेज़ों के लिए मर्मेड आरेख
+- बेस इंटरप्रेटर का समूहीकरण और ब्लास्ट रेडियस विश्लेषण
+- टास्क रूटिंग विज़ुअलाइज़ेशन
+
+- **runLog** - टास्क निष्पादन इतिहास को ट्रैक करें
+- केवल अपेंड करने योग्य JSONL प्रारूप
+- रिकॉर्ड करता है कि कौन सा एनवायरनमेंट कौन सा टास्क चला रहा था
+- सफलता/विफलता को त्रुटि वर्गीकरण के साथ रिकॉर्ड करता है
+
+- **taskCluster** - हस्ताक्षर द्वारा टास्क रन को एकत्रित करें
+- अस्थिर टास्क का पता लगाना (असंगत पास/फेल)
+- एनवायरनमेंट-निर्भर अस्थिरता का पता लगाना
+- विफलता हॉटस्पॉट की पहचान
+- संचरण विश्लेषण (साझा मूल कारण)
+
+## स्थापना
+
 ```bash
 npm install
 npm run build
 ```
-
-## कमांड लाइन इंटरफेस (सीएलआई) का उपयोग
-
+
+## सीएलआई उपयोग
+
 ```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
 ```
-
-### कमांड लाइन विकल्प।
-
-| 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` | कार्यान्वयन योग्य सुझाव। |
-
-## प्रोग्रामेटिक उपयोग।
-
+
+### सीएलआई विकल्प
+
+| फ्लैग | विवरण |
+|------|-------------|
+| `--root, -r` | स्कैन करने के लिए डायरेक्टरी (एक से अधिक निर्दिष्ट कर सकते हैं) |
+| `--out` | आउटपुट डायरेक्टरी (डिफ़ॉल्ट: `.venvkit`) |
+| `--maxDepth` | स्कैन करने के लिए अधिकतम डायरेक्टरी गहराई (डिफ़ॉल्ट: 5) |
+| `--strict` | सख्त मोड जांच सक्षम करें |
+| `--httpsProbe` | एचटीटीपीएस कनेक्टिविटी का परीक्षण करें |
+| `--minScore` | इस स्वास्थ्य स्कोर से नीचे के एनवायरनमेंट को फ़िल्टर करें |
+| `--concurrency` | समानांतर जांच (डिफ़ॉल्ट: सीपीयू गणना) |
+| `--runlog` | टास्क रन लॉग (JSONL) का पथ |
+| `--no-tasks` | टास्क विज़ुअलाइज़ेशन को छोड़ें |
+
+### आउटपुट
+
+| फ़ाइल | विवरण |
+|------|-------------|
+| `venv-map.json` | पूरा ग्राफ डेटा (नोड्स, एज, सारांश) |
+| `venv-map.mmd` | मर्मेड आरेख स्रोत |
+| `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,51 +217,58 @@ type GraphJSONv1 = {
   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 फ़ाइल क्षतिग्रस्त है या गायब है। |
-
-## विकास।
-
+
+### नोड प्रकार
+
+| प्रकार | विवरण |
+|------|-------------|
+| `base` | बेस पायथन इंटरप्रेटर (जैसे, `C:\Python311`) |
+| `venv` | वर्चुअल एनवायरनमेंट |
+| `task` | टास्क हस्ताक्षर (समूहीकृत रन) |
+
+### एज प्रकार
+
+| प्रकार | विवरण |
+|------|-------------|
+| `USES_BASE` | venv → बेस संबंध |
+| `ROUTES_TASK_TO` | टास्क → एनवायरनमेंट रूटिंग |
+| `FAILED_RUN` | टास्क → एनवायरनमेंट विफलता (मर्मेड में डैश) |
+
+## खोज कोड
+
+| कोड | गंभीरता | विवरण |
+|------|----------|-------------|
+| `SSL_BROKEN` | खराब | एसएसएल मॉड्यूल आयात करने में विफल रहता है |
+| `CERT_STORE_FAIL` | चेतावनी | एचटीटीपीएस प्रमाणपत्र सत्यापन विफल रहता है |
+| `DLL_LOAD_FAIL` | खराब | नेटिव एक्सटेंशन डीएलएल लोड करने में विफल रहता है |
+| `ABI_MISMATCH` | खराब | बाइनरी असंगति (एआरएम/x86) |
+| `PIP_MISSING` | चेतावनी | पिप उपलब्ध नहीं है |
+| `PIP_CHECK_FAIL` | चेतावनी | निर्भरता संघर्ष का पता चला |
+| `USER_SITE_LEAK` | चेतावनी | वर्चुअल एनवायरनमेंट में यूजर-साइट पैकेज सक्षम हैं |
+| `PYTHONPATH_INJECTED` | चेतावनी | PYTHONPATH पर्यावरण चर सेट है |
+| `ARCH_MISMATCH` | खराब | 64-बिट की आवश्यकता होने पर 32-बिट पायथन |
+| `PYVENV_CFG_INVALID` | चेतावनी | टूटा हुआ या गुम pyvenv.cfg |
+
+## विकास
+
 ```bash
 npm install
 npm run typecheck  # Type check
 npm run test       # Run tests
 npm run build      # Build to dist/
 ```
-
-## लाइसेंस।
-
-एमआईटी।
+
+## सुरक्षा और डेटा स्कोप
+
+- **केवल पढ़ने की सुविधा वाला स्कैनिंग:** पायथन एग्जीक्यूटेबल फाइलें और pyvenv.cfg फाइलें पढ़ी जाती हैं, लेकिन उनमें कभी भी बदलाव नहीं किया जाता।
+- **उप-प्रक्रियाएं:** यह `python` को नियंत्रित तर्कों के साथ चलाता है — कोई भी शेल निष्पादन नहीं होता।
+- **नेटवर्क:** वैकल्पिक `--httpsProbe` विकल्प एसएसएल प्रमाणपत्रों का परीक्षण करता है — कोई अन्य आउटगोइंग अनुरोध नहीं होते।
+- कोई भी डेटा एकत्र या भेजा नहीं जाता — पूर्ण नीति के लिए [SECURITY.md](SECURITY.md) देखें।
+
+## लाइसेंस
+
+एमआईटी
+
+---
+
+[MCP Tool Shop](https://mcp-tool-shop.github.io/) द्वारा निर्मित।