role-os 1.9.0 → 2.0.0

package/README.hi.md

@@ -1,160 +1,250 @@
-<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/role-os/readme.png" alt="Role OS" width="400">
-</p>
-
-<p align="center">
-  <a href="https://github.com/mcp-tool-shop-org/role-os/actions"><img src="https://github.com/mcp-tool-shop-org/role-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-  <a href="https://www.npmjs.com/package/@mcptoolshop/role-os"><img src="https://img.shields.io/npm/v/@mcptoolshop/role-os" alt="npm"></a>
-  <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/role-os/"><img src="https://img.shields.io/badge/Landing_Page-live-brightgreen" alt="Landing Page"></a>
-</p>
-
-यह एक पोर्टेबल, रिपॉ-आधारित ऑपरेटिंग लेयर है जो रोल अनुबंधों, संरचित पैकेट्स, समीक्षा और एस्केलेशन के माध्यम से काम को निर्देशित करता है, ताकि टीमें बिना किसी विचलन, झूठे समापन या केवल धारणाओं पर आधारित प्रगति दावों के बिना, फीचर कार्य, एकीकरण कार्य, पहचान सुधार और संपूर्ण रिपॉ प्रबंधन कर सकें।
-
-## यह क्या करता है
-
-रोल ओएस उन विशिष्ट विफलताओं को रोकता है जो सामान्य एआई वर्कफ़्लो उत्पन्न करते हैं:
-
-- **विचलन (Drift)** — भूमिकाएं अपने दायरे में ही रहती हैं। उत्पाद का पुन: डिज़ाइन नहीं होता है। फ्रंटएंड दायरे को फिर से परिभाषित नहीं करता है। बैकएंड उत्पाद की दिशा का आविष्कार नहीं करता है।
-- **झूठा समापन (False completion)** — 'पूर्ण' की परिभाषा स्पष्ट होती है। वह काम जो कमियों को छिपाता है, सत्यापन को छोड़ देता है, या किसी अलग समस्या को हल करता है, उसे अस्वीकार कर दिया जाता है।
-- **संदूषण (Contamination)** — फोर्क किए गए या विरासत में मिले प्रोजेक्ट्स में पहचान के अवशेष रहते हैं। रोल ओएस शब्दावली, दृश्यों और मानसिक मॉडलों में क्रॉस-प्रोजेक्ट विचलन का पता लगाता है और उसे अस्वीकार करता है।
-- **धारणा-आधारित प्रगति (Vibes-based progress)** — प्रत्येक हैंडऑफ़ संरचित होता है। प्रत्येक निर्णय सबूत पर आधारित होता है। "यह पूरा हुआ हुआ लगता है" एक मान्य स्थिति नहीं है।
-
-## यह कैसे काम करता है
-
-1. **एक पैकेट बनाएं** — परिभाषित करें कि काम पूरा होने पर क्या मौजूद होना चाहिए।
-2. **एक श्रृंखला के माध्यम से रूट करें** — आवश्यक विशेषज्ञ भूमिकाओं का सबसे छोटा सेट।
-3. **प्रत्येक भूमिका एक हैंडऑफ़ उत्पन्न करती है** — संरचित आउटपुट जो अगली भूमिका के लिए अस्पष्टता को कम करता है।
-4. **समीक्षक अनुबंध के विरुद्ध समीक्षा करता है** — सबूत के आधार पर स्वीकार करता है, अस्वीकार करता है, या अवरुद्ध करता है, न कि केवल धारणा के आधार पर।
-
-## मेमोरी और निरंतरता
-
-रोल ओएस मेमोरी लेयर का स्वामित्व नहीं लेता है और न ही उसे दोहराता है। जहां क्लाउड प्रोजेक्ट मेमोरी मौजूद है, वह निरंतरता की आधिकारिक प्रणाली है — रिपॉ तथ्य, निर्णय, खुले मुद्दे और उपचार इतिहास वहां संग्रहीत होते हैं।
-
-रोल ओएस क्लाउड प्रोजेक्ट मेमोरी के साथ एकीकृत होता है। यह इसे प्रतिस्थापित नहीं करता है।
-
-## पूर्ण उपचार और शिपचेक
-
-पूर्ण उपचार एक आधिकारिक 7-चरण प्रोटोकॉल है जो क्लाउड प्रोजेक्ट मेमोरी (`memory/full-treatment.md`) में परिभाषित है। रोल ओएस रोल अनुबंधों, हैंडऑफ़ और समीक्षक गेटों का उपयोग करके उपचारों को रूट और समीक्षा करता है — यह प्रोटोकॉल को फिर से परिभाषित नहीं करता है।
-
-**शिपचेक** 31-आइटम गुणवत्ता गेट है जो पूर्ण उपचार से पहले चलता है। किसी भी उपचार को शुरू करने से पहले हार्ड गेट A-D पास होने चाहिए। आधिकारिक संदर्भ: `memory/shipcheck.md`।
-
-क्रम: शिपचेक पहले, फिर पूर्ण उपचार। बिना हार्ड गेट पास किए v1.0.0 नहीं।
-
-## 32 भूमिकाएँ, 8 पैकों में विभाजित
-
-| पैक | भूमिकाएँ |
-|------|-------|
-| **Core** (3) | ऑर्केस्ट्रेटर, उत्पाद रणनीतिकार, आलोचक समीक्षक |
-| **Engineering** (7) | फ्रंटएंड डेवलपर, बैकएंड इंजीनियर, टेस्ट इंजीनियर, रिफैक्टर इंजीनियर, परफॉर्मेंस इंजीनियर, डिपेंडेंसी ऑडिटर, सुरक्षा समीक्षक |
-| **Design** (2) | यूआई डिजाइनर, ब्रांड संरक्षक |
-| **Marketing** (1) | लॉन्च कॉपीराइटर |
-| **Treatment** (7) | रेपो रिसर्चर, रेपो ट्रांसलेटर, डॉक्स आर्किटेक्ट, मेटाडेटा क्यूरेटर, कवरेज ऑडिटर, डिप्लॉयमेंट वेरीफायर, रिलीज इंजीनियर |
-| **Product** (4) | फीडबैक सिंथेसाइज़र, रोडमैप प्रायोरिटाइज़र, स्पेसिफिकेशन राइटर, इंफॉर्मेशन आर्किटेक्ट |
-| **Research** (4) | यूएक्स रिसर्चर, प्रतिस्पर्धी विश्लेषक, ट्रेंड रिसर्चर, यूजर इंटरव्यू सिंथेसाइज़र |
-| **Growth** (4) | लॉन्च रणनीतिकार, कंटेंट रणनीतिकार, कम्युनिटी मैनेजर, सपोर्ट ट्राइएज लीड |
-
-प्रत्येक भूमिका के लिए एक विस्तृत अनुबंध है: मिशन, उपयोग कब करें, उपयोग कब न करें, अपेक्षित इनपुट, आवश्यक आउटपुट, गुणवत्ता मानक और एस्केलेशन ट्रिगर।
-
-## शुरुआत कैसे करें
-
-```bash
-npx @mcptoolshop/role-os init
-
-# Fill context/ files for your project, then:
-roleos packet new feature
-roleos route .claude/packets/my-feature.md
-roleos review .claude/packets/my-feature.md accept
-roleos status
-```
-
-## रोल ओएस का उपयोग कब नहीं करना चाहिए
-
-- एक पंक्ति में ठीक होने वाले सुधार, टाइपो या स्पष्ट त्रुटियाँ
-- बिना किसी परिभाषित आउटपुट के खोजपूर्ण अनुसंधान
-- ऐसा काम जो 5 मिनट में एक व्यक्ति के दिमाग में समा जाए
-- आपातकालीन सुधार जो समीक्षा प्रक्रिया पूरी होने से पहले जारी करने की आवश्यकता है
-- ऐसे प्रोजेक्ट जहाँ आप संरचना से अधिक गति को महत्व देते हैं
-
-## सबूत
-
-रोल ओएस को दो संरचनात्मक रूप से भिन्न रिपॉ में तीन परीक्षणों में सिद्ध किया गया है:
-
-**परीक्षण 001 — फीचर कार्य** (क्रू स्क्रीन, स्टार फ्रेट)
-- 7-भूमिका श्रृंखला, 45 परीक्षण परिदृश्य, 0 भूमिका टकराव।
-- फोर्क किए गए पूर्वज से संदूषण को रोका, इनलाइन आविष्कार को पकड़ा, ईमानदार अवरोधकों को उजागर किया।
-
-**परीक्षण 002 — एकीकरण कार्य** (कैंपेनस्टेट वायरिंग, स्टार फ्रेट)
-- 5-भूमिका श्रृंखला, आर्किटेक्चरल सीम को बिना किसी झूठे समाधान के हल किया।
-- एंटी-फॉलबैक परीक्षणों ने साबित किया कि लाइव पथ वास्तविक है, न कि केवल एक अस्थायी समाधान।
-
-**परीक्षण 003 — पहचान कार्य** (संदूषण हटाना, स्टार फ्रेट)
-- 6-भूमिका श्रृंखला, 51 परीक्षण परिदृश्य, जिसमें स्थायी CI संदूषण रक्षा शामिल है।
-- विरासत में मिली त्रुटियों को ठीक किया बिना व्यापक पुन: डिज़ाइन में जाने से बचाया।
-
-**पोर्टेबिलिटी परीक्षण** (पर्सोना स्थिरता, सेंसर-हास्य)
-- समान आधार संरचना, लेकिन अलग भाषा/डोमेन/स्टैक।
-- केवल संदर्भ में बदलाव के साथ अपनाया गया है - कोई भी मुख्य अनुबंध संशोधन नहीं।
-
-**पूर्ण उपचार एफटी-001** (पोर्टलाइट-डेस्कटॉप)
-- 7-चरणों वाला, स्टाफ द्वारा संचालित उपचार, जिसमें ट्रीटमेंट पैक की भूमिकाएँ शामिल हैं
-- शिपचेक गेटिंग सिद्ध, कोई भूमिका टकराव नहीं
-
-**पूर्ण उपचार एफटी-002** (स्टूडियोफ्लो)
-- समान उपचार पैक, लेकिन संरचनात्मक रूप से अलग रिपॉजिटरी (रचनात्मक कार्यक्षेत्र बनाम गेम)
-- उपचार पैक पोर्टेबल है - किसी भी अनुबंध संशोधन की आवश्यकता नहीं है
-
-## मुख्य विशेषताएं
-
-ये अपरिवर्तनीय हैं। यदि कोई बदलाव इनमें से किसी भी विशेषता को कमजोर करता है, तो उसे अस्वीकार कर दें।
-
-- भूमिका की सीमाएं बरकरार हैं।
-- समीक्षा प्रक्रिया प्रभावी है।
-- शिकायत प्रक्रिया ईमानदार है।
-- परीक्षण योग्य पैकेट बरकरार हैं।
-- पोर्टेबिलिटी के लिए संदर्भ के अनुकूलन की आवश्यकता होती है, न कि मुख्य संरचना में बदलाव की।
-
-## परियोजना संरचना
-
-```
-role-os/
-  README.md                    ← You are here
-  bin/roleos.mjs               ← CLI entrypoint
-  src/                         ← CLI implementation
-  starter-pack/
-    handbook.md                ← How Role OS works
-    context/                   ← Fill these for your repo
-    examples/                  ← Feature, integration, identity packets
-    agents/                    ← 32 role contracts across 8 packs
-    schemas/                   ← Packet, handoff, verdict formats
-    policy/                    ← Routing, permissions, escalation, done
-    workflows/                 ← Ship feature, fix bug, launch update, full treatment
-```
-
-## सुरक्षा
-
-रोल ओएस केवल **स्थानीय रूप से** काम करता है। यह मार्कडाउन टेम्पलेट्स की प्रतियां बनाता है और आपके रिपॉजिटरी के `.claude/` फ़ोल्डर में पैकेट/निर्णय फ़ाइलें लिखता है। यह नेटवर्क तक नहीं पहुंचता है, गोपनीय जानकारी को नहीं संभालता है, और न ही कोई डेटा एकत्र करता है। कोई भी खतरनाक ऑपरेशन नहीं किया जाता है - सभी फ़ाइल लिखने में डिफ़ॉल्ट रूप से "यदि मौजूद है तो छोड़ दें" का उपयोग किया जाता है। पूर्ण नीति के लिए [SECURITY.md](SECURITY.md) देखें।
-
-## स्थिति
-
-**v1.0.0 — व्यापक सतह, समान नियम**
-
-- v0.1: परिचालन - 3 परीक्षण, 3 स्वीकृत, 0 भूमिका टकराव
-- v0.2: अपनाना - मुख्य रिपॉजिटरी में डिफ़ॉल्ट वर्कफ़्लो, दूसरे रिपॉजिटरी में पोर्टेबल
-- v0.3: उत्पाद निर्माण - स्टार्टर पैक, बूटस्ट्रैप सीएलआई, प्रमाण सतह
-- v0.4: उपचार पैक - 8 उपचार/पहचान भूमिकाएँ, पूर्ण स्टाफ द्वारा संचालित उपचार, 2 रिपॉजिटरी में पोर्टेबल
-- v1.0.0: 8 पैकों में 32 भूमिकाएँ, पूर्ण सीएलआई, सिद्ध उपचार, मल्टी-रिपॉजिटरी पोर्टेबिलिटी
-
-## लाइसेंस
-
-MIT
-
----
-
-द्वारा निर्मित: <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a
+<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/role-os/readme.png" alt="Role OS" width="400">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/role-os/actions"><img src="https://github.com/mcp-tool-shop-org/role-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/role-os"><img src="https://img.shields.io/npm/v/role-os" alt="npm"></a>
+  <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/role-os/"><img src="https://img.shields.io/badge/Landing_Page-live-brightgreen" alt="Landing Page"></a>
+</p>
+
+एक मल्टी-क्लाउड ऑपरेटिंग सिस्टम जो 31 विशिष्ट भूमिकाओं के साथ काम को संचालित करता है, रूट करता है, सत्यापित करता है और निष्पादित करता है। यह कार्य पैकेट बनाता है, स्कोरिंग के आधार पर सही टीम को इकट्ठा करता है, निष्पादन से पहले संभावित समस्याओं का पता लगाता है, यदि काम अवरुद्ध या अस्वीकृत होता है तो स्वचालित रूप से पुनर्निर्देशन करता है, और प्रत्येक निर्णय में संरचित प्रमाण की आवश्यकता होती है।
+
+## यह क्या करता है
+
+रोल ओएस, मल्टी-क्लाउड का उपयोग करने का एक पेशेवर तरीका है। यह उन विशिष्ट विफलताओं को रोकता है जो सामान्य एआई वर्कफ़्लो उत्पन्न करते हैं:
+
+- **विचलन (Drift)** — भूमिकाएं अपने दायरे में ही रहती हैं। उत्पाद का पुन: डिज़ाइन नहीं होता है। फ्रंटएंड दायरे को फिर से परिभाषित नहीं करता है। बैकएंड उत्पाद की दिशा का आविष्कार नहीं करता है।
+- **झूठा समापन (False completion)** — 'पूर्ण' की परिभाषा स्पष्ट होती है। वह काम जो कमियों को छिपाता है, सत्यापन को छोड़ देता है, या किसी अलग समस्या को हल करता है, उसे अस्वीकार कर दिया जाता है।
+- **संदूषण (Contamination)** — फोर्क किए गए या विरासत में मिले प्रोजेक्ट्स में पहचान के अवशेष रहते हैं। रोल ओएस शब्दावली, दृश्यों और मानसिक मॉडलों में क्रॉस-प्रोजेक्ट विचलन का पता लगाता है और उसे अस्वीकार करता है।
+- **धारणा-आधारित प्रगति (Vibes-based progress)** — प्रत्येक हैंडऑफ़ संरचित होता है। प्रत्येक निर्णय सबूत पर आधारित होता है। "यह पूरा हुआ हुआ लगता है" एक मान्य स्थिति नहीं है।
+
+## यह कैसे काम करता है
+
+अपने कार्य का वर्णन करें। रोल ओएस स्वचालित रूप से उचित स्तर का समन्वय निर्धारित करता है।
+
+```bash
+roleos start "fix the crash in save handler"
+# → MISSION: Bugfix & Diagnosis (70% confidence)
+#   Chain: Repo Researcher → Backend Engineer → Test Engineer → Critic Reviewer
+
+roleos start "add a new export command"
+# → PACK: Feature Build (50% confidence)
+#   Roles: Orchestrator, Product Strategist, Spec Writer, Backend Engineer, Test Engineer, Critic Reviewer
+
+roleos start "something completely novel"
+# → FREE-ROUTING (10% confidence)
+#   Hint: Create a packet and run `roleos route` for role-level routing
+```
+
+**बैकअप प्रणाली:**
+
+1. **मिशन:** जब कार्य एक सिद्ध, दोहराए जाने वाले वर्कफ़्लो से मेल खाता है (जैसे, बग फिक्स, सुधार, नई सुविधा का लॉन्च, दस्तावेज़, सुरक्षा, अनुसंधान)। इसमें ज्ञात भूमिका श्रृंखला, कलाकृतियों का प्रवाह, समस्या निवारण शाखाएं और स्पष्ट परिभाषाएं शामिल हैं।
+2. **पैक:** जब कार्य एक ज्ञात श्रेणी का होता है लेकिन पूर्ण मिशन आकार का नहीं होता है। इसमें 7 कैलिब्रेटेड टीम पैक होते हैं जिनमें स्वचालित चयन और विसंगति सुरक्षा होती है।
+3. **मुक्त रूटिंग:** जब कार्य नया, मिश्रित या अनिश्चित होता है। यह सभी 31 भूमिकाओं को पैकेट सामग्री के विरुद्ध स्कोर करता है और एक गतिशील श्रृंखला बनाता है।
+
+यह सिस्टम कभी भी किसी गलत स्तर पर काम को लागू नहीं करता है। यह बताता है कि इसने प्रत्येक स्तर को क्यों चुना और वैकल्पिक विकल्प भी प्रदान करता है।
+
+**एक बार रूट होने के बाद:**
+
+1. **प्रत्येक भूमिका एक हैंडऑफ़ उत्पन्न करती है:** संरचित आउटपुट जिसमें ऐसे प्रमाण शामिल होते हैं जो अगले भूमिका के लिए अस्पष्टता को कम करते हैं।
+2. **क्रिटिक समीक्षा अनुबंध के अनुसार:** यह संरचित प्रमाणों के आधार पर स्वीकार, अस्वीकार या अवरुद्ध करता है, न कि केवल धारणा के आधार पर।
+3. **पुनर्निर्देशन स्वचालित रूप से होता है:** अवरुद्ध या अस्वीकृत काम को उचित समस्या निवारक को एक कारण, पुनर्प्राप्ति प्रकार और आवश्यक कलाकृतियों के साथ भेजा जाता है।
+
+## संगठन में रोलआउट की स्थिति
+
+संगठन-व्यापी रोलआउट की स्थिति (क्यू, निर्णय, ऑडिट रिकॉर्ड, प्रति-रिपॉजिटरी लॉक पैकेट) एक अलग निजी रिपॉजिटरी में मौजूद है: [`role-os-rollout`](https://github.com/mcp-tool-shop-org/role-os-rollout)। यह रिपॉजिटरी उत्पाद है; वह रिपॉजिटरी परिचालन स्थिति है।
+
+## मेमोरी और निरंतरता
+
+रोल ओएस मेमोरी लेयर का स्वामित्व नहीं लेता है और न ही उसे दोहराता है। जहां क्लाउड प्रोजेक्ट मेमोरी मौजूद है, वह निरंतरता की आधिकारिक प्रणाली है — रिपॉ तथ्य, निर्णय, खुले मुद्दे और उपचार इतिहास वहां संग्रहीत होते हैं।
+
+रोल ओएस क्लाउड प्रोजेक्ट मेमोरी के साथ एकीकृत होता है। यह इसे प्रतिस्थापित नहीं करता है।
+
+## पूर्ण उपचार और शिपचेक
+
+पूर्ण उपचार एक आधिकारिक 7-चरण प्रोटोकॉल है जो क्लाउड प्रोजेक्ट मेमोरी (`memory/full-treatment.md`) में परिभाषित है। रोल ओएस रोल अनुबंधों, हैंडऑफ़ और समीक्षक गेटों का उपयोग करके उपचारों को रूट और समीक्षा करता है — यह प्रोटोकॉल को फिर से परिभाषित नहीं करता है।
+
+**शिपचेक** 31-आइटम गुणवत्ता गेट है जो पूर्ण उपचार से पहले चलता है। किसी भी उपचार को शुरू करने से पहले हार्ड गेट A-D पास होने चाहिए। आधिकारिक संदर्भ: `memory/shipcheck.md`।
+
+क्रम: शिपचेक पहले, फिर पूर्ण उपचार। बिना हार्ड गेट पास किए v1.0.0 नहीं।
+
+## 8 पैकों में 31 भूमिकाएं
+
+| पैक | भूमिकाएं |
+|------|-------|
+| **Core** (3) | ऑर्केस्ट्रेटर, उत्पाद रणनीतिकार, क्रिटिक समीक्षक |
+| **Engineering** (7) | फ्रंटएंड डेवलपर, बैकएंड इंजीनियर, टेस्ट इंजीनियर, रिफैक्टर इंजीनियर, परफॉर्मेंस इंजीनियर, डिपेंडेंसी ऑडिटर, सुरक्षा समीक्षक |
+| **Design** (2) | यूआई डिजाइनर, ब्रांड गार्डियन |
+| **Marketing** (1) | लॉन्च कॉपीराइटर |
+| **Treatment** (7) | रिपॉजिटरी शोधकर्ता, रिपॉजिटरी अनुवादक, डॉक्स आर्किटेक्ट, मेटाडेटा क्यूरेटर, कवरेज ऑडिटर, डिप्लॉयमेंट सत्यापनकर्ता, रिलीज़ इंजीनियर |
+| **Product** (3) | फीडबैक सिंथेसाइज़र, रोडमैप प्राथमिकता देने वाला, स्पेसिफिकेशन लेखक |
+| **Research** (4) | यूएक्स शोधकर्ता, प्रतिस्पर्धी विश्लेषक, ट्रेंड शोधकर्ता, यूजर इंटरव्यू सिंथेसाइज़र |
+| **Growth** (4) | लॉन्च रणनीतिकार, कंटेंट रणनीतिकार, कम्युनिटी मैनेजर, सपोर्ट ट्राइएज लीड |
+
+प्रत्येक भूमिका के लिए एक पूर्ण अनुबंध है: मिशन, उपयोग कब करें, उपयोग कब न करें, अपेक्षित इनपुट, आवश्यक आउटपुट, गुणवत्ता मानक और समस्या निवारण ट्रिगर। प्रत्येक भूमिका को रूट किया जा सकता है - `roleos route` पैकेट सामग्री के आधार पर इनमें से किसी भी भूमिका की सिफारिश कर सकता है।
+
+## शुरुआत कैसे करें
+
+```bash
+npx role-os init
+
+# Describe what you need — Role OS picks the right level:
+roleos start "fix the crash in save handler"
+
+# Or go manual:
+roleos packet new feature
+roleos route .claude/packets/my-feature.md
+roleos review .claude/packets/my-feature.md accept
+roleos status
+
+# Explore missions and packs:
+roleos mission list
+roleos mission show bugfix
+roleos packs list
+roleos packs show feature
+```
+
+## रोल ओएस का उपयोग कब नहीं करना चाहिए
+
+- सिंगल-लाइन सुधार, टाइपो या स्पष्ट बग
+- कोई परिभाषित आउटपुट नहीं होने वाला अन्वेषी अनुसंधान
+- ऐसा कार्य जो 5 मिनट में एक व्यक्ति के दिमाग में आ जाए
+- आपातकालीन सुधार जो समीक्षा श्रृंखला पूरी होने से पहले जारी करने की आवश्यकता होती है
+- ऐसे प्रोजेक्ट जहां आप संरचना से अधिक गति को प्राथमिकता देते हैं
+
+## सबूत
+
+रोल ओएस को दो संरचनात्मक रूप से भिन्न रिपॉ में तीन परीक्षणों में सिद्ध किया गया है:
+
+**परीक्षण 001 — फीचर कार्य** (क्रू स्क्रीन, स्टार फ्रेट)
+- 7-भूमिका श्रृंखला, 45 परीक्षण परिदृश्य, 0 भूमिका टकराव।
+- फोर्क किए गए पूर्वज से संदूषण को रोका, इनलाइन आविष्कार को पकड़ा, ईमानदार अवरोधकों को उजागर किया।
+
+**परीक्षण 002 — एकीकरण कार्य** (कैंपेनस्टेट वायरिंग, स्टार फ्रेट)
+- 5-भूमिका श्रृंखला, आर्किटेक्चरल सीम को बिना किसी झूठे समाधान के हल किया।
+- एंटी-फॉलबैक परीक्षणों ने साबित किया कि लाइव पथ वास्तविक है, न कि केवल एक अस्थायी समाधान।
+
+**परीक्षण 003 — पहचान कार्य** (संदूषण हटाना, स्टार फ्रेट)
+- 6-भूमिका श्रृंखला, 51 परीक्षण परिदृश्य, जिसमें स्थायी CI संदूषण रक्षा शामिल है।
+- विरासत में मिली त्रुटियों को ठीक किया बिना व्यापक पुन: डिज़ाइन में जाने से बचाया।
+
+**पोर्टेबिलिटी परीक्षण** (पर्सोना स्थिरता, सेंसर-हास्य)
+- समान आधार संरचना, लेकिन अलग भाषा/डोमेन/स्टैक।
+- केवल संदर्भ में बदलाव के साथ अपनाया गया है - कोई भी मुख्य अनुबंध संशोधन नहीं।
+
+**पूर्ण उपचार FT-001** (portlight-desktop)
+- उपचार पैक भूमिकाओं के साथ 7-चरण वाला स्टाफ उपचार
+- शिपचेक गेटिंग सिद्ध, कोई भूमिका टकराव नहीं
+
+**पूर्ण उपचार FT-002** (studioflow)
+- समान उपचार पैक, संरचनात्मक रूप से अलग रिपॉजिटरी (रचनात्मक कार्यक्षेत्र बनाम गेम)
+- उपचार पैक पोर्टेबल - किसी अनुबंध संशोधन की आवश्यकता नहीं
+
+## मुख्य विशेषताएं
+
+ये अपरिवर्तनीय हैं। यदि कोई बदलाव इनमें से किसी भी विशेषता को कमजोर करता है, तो उसे अस्वीकार कर दें।
+
+- भूमिका की सीमाएं बरकरार हैं।
+- समीक्षा प्रक्रिया प्रभावी है।
+- शिकायत प्रक्रिया ईमानदार है।
+- परीक्षण योग्य पैकेट बरकरार हैं।
+- पोर्टेबिलिटी के लिए संदर्भ के अनुकूलन की आवश्यकता होती है, न कि मुख्य संरचना में बदलाव की।
+
+## परियोजना संरचना
+
+```
+role-os/
+  bin/roleos.mjs               ← CLI entrypoint
+  src/
+    entry.mjs                  ← Unified entry: mission → pack → free routing
+    entry-cmd.mjs              ← `roleos start` CLI command
+    mission.mjs                ← 6 named mission types (feature, bugfix, treatment, docs, security, research)
+    mission-run.mjs            ← Mission runner: create → step → complete → report
+    mission-cmd.mjs            ← `roleos mission` CLI commands
+    route.mjs                  ← 31-role routing + dynamic chain builder
+    packs.mjs                  ← 7 calibrated team packs + auto-selection
+    conflicts.mjs              ← 4-pass conflict detection
+    escalation.mjs             ← Auto-routing for blocked/rejected/split
+    evidence.mjs               ← Structured evidence + role-aware requirements
+    dispatch.mjs               ← Runtime dispatch manifests for multi-claude
+    artifacts.mjs              ← 20 per-role artifact contracts + 7 pack handoffs
+    decompose.mjs              ← Composite task detection + splitting
+    composite.mjs              ← Dependency-ordered execution + recovery
+    replan.mjs                 ← Mid-run adaptive replanning
+    calibration.mjs            ← Outcome recording + weight tuning
+    hooks.mjs                  ← 5 lifecycle hooks for runtime enforcement
+    session.mjs                ← Session scaffolding + doctor
+  test/                        ← 527 tests across 20 test files
+  starter-pack/                ← Drop-in role contracts, policies, schemas, workflows
+```
+
+## सुरक्षा
+
+रोल ओएस केवल **स्थानीय रूप से** काम करता है। यह मार्कडाउन टेम्पलेट्स की प्रतियां बनाता है और आपके रिपॉजिटरी के `.claude/` फ़ोल्डर में पैकेट/निर्णय फ़ाइलें लिखता है। यह नेटवर्क तक नहीं पहुंचता है, गोपनीय जानकारी को नहीं संभालता है, और न ही कोई डेटा एकत्र करता है। कोई भी खतरनाक ऑपरेशन नहीं किया जाता है - सभी फ़ाइल लिखने में डिफ़ॉल्ट रूप से "यदि मौजूद है तो छोड़ दें" का उपयोग किया जाता है। पूर्ण नीति के लिए [SECURITY.md](SECURITY.md) देखें।
+
+## ऑपरेटिंग सिस्टम
+
+| लेयर | यह क्या करता है | स्थिति |
+|-------|-------------|--------|
+| **Routing** | यह सभी 31 भूमिकाओं को पैकेट सामग्री के विरुद्ध स्कोर करता है, सिफारिशों को समझाता है, और आत्मविश्वास का आकलन करता है। | ✓ जारी किया गया |
+| **Chain builder** | क्रमिक रूप से व्यवस्थित श्रृंखलाएँ, जो स्कोर किए गए कार्यों पर आधारित हैं, लेकिन किसी टेम्पलेट से बंधी नहीं हैं। | ✓ जारी किया गया |
+| **Conflict detection** | 4-स्तरीय सत्यापन: गंभीर विरोधाभास, क्रम, अतिरेक, और कवरेज में अंतराल। सुधार के सुझाव। | ✓ जारी किया गया |
+| **Escalation** | अवरुद्ध/अस्वीकृत/विभाजित कार्यों को स्वचालित रूप से उचित समाधानकर्ता को भेजा जाता है, साथ में कारण और आवश्यक जानकारी। | ✓ जारी किया गया |
+| **Evidence** | निर्णयों में भूमिका-जागरूक संरचित प्रमाण। पर्याप्तता जांच। 12 प्रकार के प्रमाण। | ✓ जारी किया गया |
+| **Dispatch** | मल्टी-क्लाउड के लिए निष्पादन योजनाएँ उत्पन्न करता है। प्रत्येक भूमिका के लिए उपकरण प्रोफाइल, सिस्टम संकेत, और बजट। | ✓ जारी किया गया |
+| **Trials** | पूर्ण सूची सत्यापित: 30/30 स्वर्ण-कार्य + 5/5 नकारात्मक परीक्षण। 7 पैकेट परीक्षण पूरे। | ✓ पूर्ण |
+| **Team Packs** | 7 कैलिब्रेटेड पैकेट, स्वचालित चयन, बेमेल सुरक्षा, और स्वतंत्र रूटिंग विकल्प। | ✓ जारी किया गया |
+| **Outcome calibration** | निष्पादन परिणामों को रिकॉर्ड करता है, परिणामों के आधार पर पैकेट/भूमिका भार को समायोजित करता है, और आत्मविश्वास थ्रेसहोल्ड को समायोजित करता है। | ✓ जारी किया गया |
+| **Mixed-task decomposition** | संयुक्त कार्यों का पता लगाता है, उन्हें चाइल्ड पैकेट में विभाजित करता है, पैकेट आवंटित करता है, और निर्भरताओं को बनाए रखता है। | ✓ जारी किया गया |
+| **Composite execution** | निर्भरता क्रम में चाइल्ड पैकेट चलाता है, जानकारी पास करता है, शाखा पुनर्प्राप्ति करता है, और संश्लेषण करता है। | ✓ जारी किया गया |
+| **Adaptive replanning** | निष्पादन के दौरान होने वाले परिवर्तनों, निष्कर्षों, या नई आवश्यकताओं को योजना को पुनरारंभ किए बिना अपडेट किया जा सकता है। | ✓ जारी किया गया |
+| **Session spine** | `roleos init claude` कमांड `CLAUDE.md`, `/roleos-route`, `/roleos-review`, और `/roleos-status` फ़ाइलों को बनाता है। `roleos doctor` कमांड कनेक्शन की जांच करता है। रूट कार्ड, भागीदारी को प्रमाणित करते हैं। | ✓ जारी किया गया |
+| **Hook spine** | 5 लाइफसाइकिल हुक (SessionStart, PromptSubmit, PreToolUse, SubagentStart, Stop)। सलाहकार प्रवर्तन: रूट कार्ड अनुस्मारक, टूल उपयोग प्रतिबंध, सबएजेंट भूमिका इंजेक्शन, और पूर्णता ऑडिट। | ✓ जारी किया गया |
+| **Artifact spine** | 20 भूमिका-विशिष्ट कलाकृतियों के अनुबंध। 7 पैकेट हैंडऑफ़ अनुबंध। संरचनात्मक सत्यापन। श्रृंखला पूर्णता जांच। डाउनस्ट्रीम भूमिकाएँ कभी भी यह अनुमान नहीं लगाती हैं कि उन्हें क्या प्राप्त हुआ है। | ✓ जारी किया गया |
+| **Mission library** | 6 नामित मिशन (फ़ीचर-शिप, बगफिक्स, ट्रीटमेंट, डॉक्स-रिलीज़, सुरक्षा-हार्डनिंग, रिसर्च-लॉन्च)। प्रत्येक मिशन में पैकेट, भूमिका श्रृंखला, कलाकृति प्रवाह, एस्केलेशन शाखाएँ, और आंशिक परिभाषा शामिल है। सभी 6 मिशनों का परीक्षण किया गया है और उन्हें बेहतर बनाया गया है। | ✓ जारी किया गया |
+| **Mission runner** | रन बनाएं, ट्रैक की गई स्थिति के साथ चरणों से गुजरें, ईमानदारी से रिपोर्टिंग के साथ पूरा करें/विफल करें। अवरुद्ध चरणों का प्रसार, श्रृंखला से बाहर एस्केलेशन चेतावनियाँ, और अंतिम चरण को फिर से खोलने की सुविधा। | ✓ जारी किया गया |
+| **Unified entry** | `roleos start` कमांड स्वचालित रूप से मिशन, पैकेट, या स्वतंत्र रूटिंग का चयन करता है। आत्मविश्वास स्कोर, विकल्पों, और संयुक्त पहचान के साथ एक वैकल्पिक प्रणाली। | ✓ जारी किया गया |
+
+## 6 मिशन
+
+| मिशन | पैक | भूमिकाएं | कब उपयोग करें |
+|---------|------|-------|-------------|
+| `feature-ship` | फ़ीचर | 5 | पूर्ण फ़ीचर डिलीवरी: दायरा → विनिर्देश → कार्यान्वयन → परीक्षण → समीक्षा |
+| `bugfix` | बगफिक्स | 4 | मूल कारण का निदान, सुधार, परीक्षण, सत्यापन |
+| `treatment` | ट्रीटमेंट | 4 | शिपचेक + पॉलिश + दस्तावेज़ + CI सत्यापन + समीक्षा |
+| `docs-release` | दस्तावेज़ | 2 | दस्तावेज़ लिखें/अपडेट करें, रिलीज़ नोट्स |
+| `security-hardening` | सुरक्षा | 4 | खतरे का मॉडल, ऑडिट, कमजोरियों को ठीक करें, फिर से ऑडिट करें, सत्यापन |
+| `research-launch` | अनुसंधान | 4 | प्रश्न तैयार करें, अनुसंधान करें, निष्कर्षों को दस्तावेज़ करें, निर्णय लें |
+
+प्रत्येक मिशन में ईमानदार-आंशिक परिभाषाएँ शामिल हैं - जब कोई कार्य रुक जाता है, तो सिस्टम यह दस्तावेज़ करता है कि क्या पूरा हो गया है और क्या शेष है, बजाय इसके कि वह झूठा दावा करे कि कार्य पूरा हो गया है।
+
+## स्थिति
+
+- v0.1–v0.4: आधार – परीक्षण, अपनाना, उपचार पैकेज, शुरुआती पैकेज।
+- v1.0.0: 32 भूमिकाएँ, पूर्ण कमांड-लाइन इंटरफेस, सिद्ध उपचार, मल्टी-रिपो पोर्टेबिलिटी।
+- v1.0.2: भूमिका ऑपरेटिंग सिस्टम लॉकिंग (बूटस्ट्रैप सत्य सुधार, init --force)।
+- v1.1.0: 31 भूमिकाएँ, पूर्ण रूटिंग स्पाइन, संघर्ष का पता लगाना, वृद्धि, प्रमाण, डिस्पैच, 7 सिद्ध टीम पैकेज। 35 निष्पादन परीक्षण। 212 परीक्षण।
+- v1.2.0: कैलिब्रेटेड पैकेज डिफ़ॉल्ट विकल्प के रूप में प्रचारित। स्वचालित चयन, विसंगति का पता लगाना, वैकल्पिक सुझाव, फ्री-रूटिंग बैकअप। 246 परीक्षण।
+- v1.3.0: परिणाम कैलिब्रेशन, मिश्रित-कार्य विघटन, समग्र निष्पादन, अनुकूलन योजना। 317 परीक्षण।
+- v1.4.0: सेशन स्पाइन – `roleos init claude`, `roleos doctor`, रूट कार्ड, /roleos-route + /roleos-review + /roleos-status कमांड। 335 परीक्षण।
+- v1.5.0: हुक स्पाइन – रनटाइम प्रवर्तन के लिए 5 लाइफसाइकिल हुक। 358 परीक्षण।
+- v1.6.0: आर्टिफैक्ट स्पाइन – 20 प्रति-भूमिका आर्टिफैक्ट अनुबंध, 7 पैकेज हैंडऑफ अनुबंध, संरचनात्मक सत्यापन। 385 परीक्षण।
+- v1.7.0: पूर्णता का प्रमाण – वास्तविक कार्य पूरे स्टैक के माध्यम से चलाए जाते हैं। `roleos artifacts` कमांड-लाइन इंटरफेस। संरचनात्मक सुधारों पर ईमानदार वृद्धि। 398 परीक्षण।
+- v1.8.0: मिशन लाइब्रेरी (फेज एस) – 6 नामित मिशन, रनर इंजन, पूर्णता रिपोर्ट। 6 वास्तविक परीक्षण रनों से सुरक्षित किया गया। 481 परीक्षण।
+- **v1.9.0**: एकीकृत प्रवेश पथ (फेज टी) – `roleos start` स्वचालित रूप से मिशन, पैकेज या फ्री रूटिंग का निर्णय लेता है। बैकअप प्रणाली, समग्र पता लगाना, प्रवेश-पथ तुलना परीक्षण। 527 परीक्षण।
+
+## लाइसेंस
+
+MIT
+
+---
+
+द्वारा निर्मित: <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a