<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/shipcheck/readme.jpg" alt="Shipcheck" width="400">
</p>
<p align="center">
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
<a href="https://mcp-tool-shop-org.github.io/shipcheck/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
</p>
<p align="center">
Product standards for MCP Tool Shop.<br>
Templates, contracts, and adoption guides that define what "done" means before anything ships.
</p>
---
## क्यों?
"डन" का पहले मतलब होता था कि कोड काम कर रहा है। लेकिन यह पर्याप्त नहीं है। एक उत्पाद में कोड के साथ-साथ सुरक्षा, त्रुटि प्रबंधन, दस्तावेज़, पहचान और वितरण प्रक्रिया की स्वच्छता भी शामिल होती है। "शिपचेक" इन सभी मानकों को निर्धारित करता है।
## यहां क्या है?
| मानक। | यह क्या शामिल करता है। |
|----------|----------------|
| [Ship Gate](templates/SHIP_GATE.md) | 27 "हार्ड-गेट" और 4 "सॉफ्ट-गेट" प्री-रिलीज़ चेकलिस्ट आइटम। |
| [Error Contract](contracts/error-contract.md) | दो-स्तरीय संरचित त्रुटि मानक, जिसमें कोड रजिस्ट्री शामिल है। |
| [Security Baseline](templates/SECURITY.md) | रिपोर्ट ईमेल, प्रतिक्रिया देने का समय, खतरे की सीमा। |
| [Handbook](templates/HANDBOOK.md) | जटिल उपकरणों के लिए परिचालन संबंधी उपयोगकर्ता पुस्तिका। |
| [Scorecard](templates/SCORECARD.md) | सुधार से पहले और बाद के प्रदर्शन का मूल्यांकन। |
| [Adoption Guide](ADOPTION.md) | "शिपचेक" को किसी भी रिपॉजिटरी पर 30 मिनट से कम समय में लागू करें। |
## शुरुआत कैसे करें।
1. [ADOPTION.md](ADOPTION.md) फ़ाइल पढ़ें।
2. `templates/SHIP_GATE.md` फ़ाइल को अपनी रिपॉजिटरी के रूट फ़ोल्डर में कॉपी करें।
3. लागू होने वाली चीज़ों पर टिक करें, और जो लागू नहीं होती हैं, उन्हें `SKIP:` लिखकर चिह्नित करें।
4. जब सभी आवश्यक जांच पूरी हो जाएं, तो इसे रिलीज़ करें।
## यह कैसे काम करता है।
**कठोर गेट्स** (ए से डी): ये रिलीज को रोकते हैं।
- **ए. सुरक्षा आधार:** SECURITY.md, खतरे का मॉडल, कोई गुप्त जानकारी नहीं, कोई डेटा संग्रह नहीं, डिफ़ॉल्ट सुरक्षा स्थिति।
- **बी. त्रुटि प्रबंधन:** संरचित त्रुटि प्रारूप (कोड/संदेश/संकेत/पुनः प्रयास योग्य), सुरक्षित आउटपुट, सुचारू रूप से कार्यक्षमता में कमी।
- **सी. ऑपरेटर दस्तावेज़:** README, CHANGELOG, LICENSE, उपकरण दस्तावेज़।
- **डी. वितरण संबंधी स्वच्छता:** स्क्रिप्ट का सत्यापन, संस्करण का मिलान, निर्भरता स्कैनिंग, लॉकफ़ाइल।
**सॉफ्ट गेट** (ई) अवरोधक नहीं है, बल्कि यह "संपूर्णता" को परिभाषित करता है।
- **ई. पहचान (Identity)** — लोगो, अनुवाद, लैंडिंग पृष्ठ, रिपॉ मेटाडेटा।
गेट यह बताता है कि **क्या** सत्य होना चाहिए, न कि इसे **कैसे** लागू किया जाए। "उपयोगिता" टैग (`[all]`, `[npm]`, `[mcp]`, `[cli]`, `[desktop]`, `[vsix]`, `[container]`) उन रिपॉजिटरी में "चेकबॉक्स शर्म" को रोकते हैं जहां कुछ चीजें लागू नहीं होती हैं।
## त्रुटि अनुबंध: एक संक्षिप्त विवरण।
**स्तर 1 - आकार (हर जगह अनिवार्य):**
```json
{
"code": "INPUT_TEXT_EMPTY",
"message": "Text must not be empty",
"hint": "Provide at least one character of text",
"retryable": false
}
```
**स्तर 2 - आधारभूत प्रकार + निकास कोड (कमांड लाइन इंटरफेस/मल्टी-प्रोटोकॉल सर्वर/डेस्कटॉप):**
| निकास कोड। | अर्थ। |
|-----------|---------|
| 0 | OK |
| 1 | उपयोगकर्ता की गलती (गलत इनपुट, कॉन्फ़िगरेशन की कमी)। |
| 2 | रनटाइम त्रुटि (क्रैश, बैकएंड में खराबी)। |
| 3 | आंशिक सफलता (कुछ चीजें सफल रहीं)। |
त्रुटि कोडों में नामस्थान वाले उपसर्गों का उपयोग किया जाता है: `IO_`, `CONFIG_`, `PERM_`, `DEP_`, `RUNTIME_`, `PARTIAL_`, `INPUT_`, `STATE_`. एक बार जारी होने के बाद, ये कोड स्थिर रहते हैं।
## संदर्भ कार्यान्वयन।
[mcp-voice-soundboard](https://github.com/mcp-tool-shop-org/mcp-voice-soundboard) यह पहला रिपॉजिटरी था जिसने "शिप गेट" की जांच पास की - सुधार के बाद इसे **46/50** अंक मिले।
## स्कोरकार्ड।
| श्रेणी। | स्कोर। | टिप्पणियाँ। |
|----------|-------|-------|
| अ. सुरक्षा। | 10/10 | सुरक्षा.md: इसमें कोई निष्पादन योग्य कोड नहीं है, और यह कोई डेटा संग्रह नहीं करता है। |
| बी. त्रुटि प्रबंधन। | लागू नहीं. | मानकों का भंडार - कोई भी त्रुटि नहीं। |
| सी. ऑपरेटर दस्तावेज़। | 10/10 | README, CHANGELOG, अपनाना, सभी टेम्पलेट्स का विवरण दिया गया है। |
| डी. शिपिंग स्वच्छता। | 8/10 | कोई भी कोड सत्यापन/परीक्षण के लिए उपलब्ध नहीं है, सभी मानकों को संस्करणों में विभाजित किया गया है। |
| ई. पहचान। | 10/10 | लोग, अनुवाद, लैंडिंग पेज, मेटाडेटा। |
| **Total** | **38/40** | बी: अप्रासंगिक (लागू नहीं)। |
## लाइसेंस।
[एमआईटी] (लाइसेंस)
---
<p align="center">
Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
</p>
