role-os 2.3.1 → 2.5.0

package/README.hi.md

@@ -1,319 +1,319 @@
-<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="600">
-</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 भूमिकाओं को पैकेट सामग्री के विरुद्ध स्कोर करता है और एक गतिशील श्रृंखला बनाता है।
-
-यह सिस्टम कभी भी किसी गलत स्तर पर काम को लागू नहीं करता है। यह बताता है कि इसने प्रत्येक स्तर को क्यों चुना और वैकल्पिक विकल्प भी प्रदान करता है।
-
-**एक कमांड से सक्रिय निष्पादन:**
-
-```bash
-roleos run "fix the crash in save handler"
-# → Created run: run-1234
-# → Entry: MISSION (bugfix)
-# → Started step 0: Repo Researcher → diagnosis-report
-# → Guidance: Required sections: entrypoints, module-map, build-test-commands
-
-roleos next                    # Start the next step
-roleos complete diagnosis.md   # Complete the active step with artifact
-roleos explain                 # Show full run state and guidance
-roleos resume                  # Continue an interrupted run
-roleos report                  # Generate completion report
-roleos friction                # Measure operator touches
-```
-
-**जब चीजें गलत हो जाती हैं तो हस्तक्षेप:**
-
-```bash
-roleos retry 0                 # Retry a failed step
-roleos reroute 1 "Frontend Developer" "UI bug"  # Swap a role
-roleos escalate "Test Engineer" "Repo Researcher" "missed edge case" "re-diagnose"
-roleos block 2 "waiting for API spec"
-roleos reopen 0 "found issue in review"
-```
-
-यह सिस्टम डिस्क पर डेटा संग्रहीत करता है (`.claude/runs/`), इसलिए बाधित सत्र बिना किसी समस्या के फिर से शुरू हो जाते हैं। प्रत्येक चरण में ऑपरेटर के मार्गदर्शन शामिल हैं: क्या उत्पन्न करना है, आवश्यक अनुभाग और समाप्ति की शर्तें।
-
-**एक बार रूट होने के बाद:**
-
-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 run "fix the crash in save handler"
-# → Creates run, picks bugfix mission, starts first step with guidance
-
-# Step through:
-roleos next                    # Start next step
-roleos complete artifact.md    # Complete with artifact
-roleos explain                 # Show full state
-roleos report                  # Completion report
-
-# Or go manual:
-roleos start "fix the crash"   # Entry decision only (no run)
-roleos packet new feature
-roleos route .claude/packets/my-feature.md
-roleos review .claude/packets/my-feature.md accept
-
-# Explore missions and packs:
-roleos mission list
-roleos packs list
-```
-
-## रोल ओएस का उपयोग कब नहीं करना चाहिए
-
-- सिंगल-लाइन सुधार, टाइपो या स्पष्ट बग
-- कोई परिभाषित आउटपुट नहीं होने वाला अन्वेषी अनुसंधान
-- ऐसा कार्य जो 5 मिनट में एक व्यक्ति के दिमाग में आ जाए
-- आपातकालीन सुधार जो समीक्षा श्रृंखला पूरी होने से पहले जारी करने की आवश्यकता होती है
-- ऐसे प्रोजेक्ट जहां आप संरचना से अधिक गति को प्राथमिकता देते हैं
-
-## सबूत
-
-रोल ओएस को दो संरचनात्मक रूप से भिन्न रिपॉ में तीन परीक्षणों में सिद्ध किया गया है:
-
-**परीक्षण 001 — फीचर कार्य** (क्रू स्क्रीन, स्टार फ्रेट)
-- 7-भूमिका श्रृंखला, 45 परीक्षण परिदृश्य, 0 भूमिका टकराव।
-- फोर्क किए गए पूर्वज से संदूषण को रोका, इनलाइन आविष्कार को पकड़ा, ईमानदार अवरोधकों को उजागर किया।
-
-**परीक्षण 002 — एकीकरण कार्य** (कैंपेनस्टेट वायरिंग, स्टार फ्रेट)
-- 5-भूमिका श्रृंखला, आर्किटेक्चरल सीम को बिना किसी झूठे समाधान के हल किया।
-- एंटी-फॉलबैक परीक्षणों ने साबित किया कि लाइव पथ वास्तविक है, न कि केवल एक अस्थायी समाधान।
-
-**परीक्षण 003 — पहचान कार्य** (संदूषण हटाना, स्टार फ्रेट)
-- 6-भूमिका श्रृंखला, 51 परीक्षण परिदृश्य, जिसमें स्थायी CI संदूषण रक्षा शामिल है।
-- विरासत में मिली त्रुटियों को ठीक किया बिना व्यापक पुन: डिज़ाइन में जाने से बचाया।
-
-**पोर्टेबिलिटी परीक्षण** (पर्सोना स्थिरता, सेंसर-हास्य)
-- समान आधार संरचना, लेकिन अलग भाषा/डोमेन/स्टैक।
-- केवल संदर्भ में बदलाव के साथ अपनाया गया है - कोई भी मुख्य अनुबंध संशोधन नहीं।
-
-**पूर्ण उपचार FT-001** (portlight-desktop)
-- उपचार पैक भूमिकाओं के साथ 7-चरण वाला स्टाफ उपचार
-- शिपचेक गेटिंग सिद्ध, कोई भूमिका टकराव नहीं
-
-**पूर्ण उपचार FT-002** (studioflow)
-- समान उपचार पैक, संरचनात्मक रूप से अलग रिपॉजिटरी (रचनात्मक कार्यक्षेत्र बनाम गेम)
-- उपचार पैक पोर्टेबल - किसी अनुबंध संशोधन की आवश्यकता नहीं
-
-**"गोल्डन रन" पर विचार-मंथन** (एमसीपी सर्वर मार्केटप्लेस विषय)
-- 9 भूमिकाओं की श्रृंखला, 4 विश्लेषक समानांतर में, क्रॉस-परीक्षा + विवाद ग्राफ का खंडन
-- 4 चुनौतियां जारी की गईं, 3 दावों को संकुचित किया गया, 1 अनसुलझा — स्वस्थ दबाव, कोई गतिरोध नहीं
-- प्रस्तुत कलाकृतियों से 16+ ट्रेस लिंक "ट्रूथ-लेयर" परमाणुओं तक
-- पूरी श्रृंखला की प्रामाणिकता सिद्ध: सत्य → परमाणु → विवाद → संश्लेषण → विस्तार → न्यायाधीश → प्रस्तुत करना → ट्रेस
-
-## मुख्य विशेषताएं
-
-ये अपरिवर्तनीय हैं। यदि कोई बदलाव इनमें से किसी भी विशेषता को कमजोर करता है, तो उसे अस्वीकार कर दें।
-
-- भूमिका की सीमाएं बरकरार हैं।
-- समीक्षा प्रक्रिया प्रभावी है।
-- शिकायत प्रक्रिया ईमानदार है।
-- परीक्षण योग्य पैकेट बरकरार हैं।
-- पोर्टेबिलिटी के लिए संदर्भ के अनुकूलन की आवश्यकता होती है, न कि मुख्य संरचना में बदलाव की।
-
-## परियोजना संरचना
-
-```
-role-os/
-  bin/roleos.mjs               ← CLI entrypoint
-  src/
-    entry.mjs                  ← Unified entry: mission → pack → free routing
-    entry-cmd.mjs              ← `roleos start` CLI command
-    run.mjs                    ← Persistent run engine: create → step → pause → resume → report
-    run-cmd.mjs                ← `roleos run/resume/next/explain/complete/fail` + interventions
-    mission.mjs                ← 7 named mission types (feature, bugfix, treatment, docs, security, research, brainstorm)
-    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              ← 30 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
-    brainstorm.mjs             ← Evidence modes, request validation, finding/synthesis/judge schemas
-    brainstorm-roles.mjs       ← Role-native schemas, input partitioning, blindspot enforcement, cross-exam
-    brainstorm-render.mjs      ← Two-layer rendering: lexical bans, render schemas, debate transcript
-  test/                        ← 894 tests across 30 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` कमांड स्वचालित रूप से मिशन, पैकेट, या स्वतंत्र रूटिंग का चयन करता है। आत्मविश्वास स्कोर, विकल्पों, और संयुक्त पहचान के साथ एक वैकल्पिक प्रणाली। | ✓ जारी किया गया |
-| **Persistent runs** | `roleos run` डिस्क-आधारित निष्पादन बनाता है। `resume`, `next`, `explain`, `complete`, `fail`। हस्तक्षेप: पुनर्निर्देशित करें, बढ़ाएं, पुनः प्रयास करें, अवरुद्ध करें, फिर से खोलें। चरण-स्तरीय मार्गदर्शन। घर्षण माप। | ✓ जारी किया गया |
-| **Brainstorm** | दो-स्तरीय आर्किटेक्चर: सत्य (भूमिका-आधारित स्कीमा, उत्पत्ति परमाणु, क्रॉस-परीक्षा विवाद ग्राफ) + प्रस्तुत करना (5 अलग-अलग आवाजें, शब्द संबंधी प्रतिबंध, बहस का प्रतिलेख)। ट्रेस लिंक साबित करते हैं कि प्रत्येक प्रस्तुत दावा एक "ट्रूथ" परमाणु से मेल खाता है। "गोल्डन रन": 894 परीक्षण। | ✓ जारी किया गया |
-
-## 6 मिशन
-
-| मिशन | पैक | भूमिकाएं | कब उपयोग करें |
-|---------|------|-------|-------------|
-| `feature-ship` | फ़ीचर | 5 | पूर्ण फ़ीचर डिलीवरी: दायरा → विनिर्देश → कार्यान्वयन → परीक्षण → समीक्षा |
-| `bugfix` | बगफिक्स | 4 | मूल कारण का निदान, सुधार, परीक्षण, सत्यापन |
-| `treatment` | ट्रीटमेंट | 4 | शिपचेक + पॉलिश + दस्तावेज़ + CI सत्यापन + समीक्षा |
-| `docs-release` | दस्तावेज़ | 2 | दस्तावेज़ लिखें/अपडेट करें, रिलीज़ नोट्स |
-| `security-hardening` | सुरक्षा | 4 | खतरे का मॉडल, ऑडिट, कमजोरियों को ठीक करें, फिर से ऑडिट करें, सत्यापन |
-| `research-launch` | अनुसंधान | 4 | प्रश्न तैयार करें, अनुसंधान करें, निष्कर्षों को दस्तावेज़ करें, निर्णय लें |
-| `brainstorm` | विचार-मंथन | 9 | ट्रेस करने योग्य असहमति और निर्णय के साथ संरचित बहु-दृष्टिकोण जांच। |
-
-प्रत्येक मिशन में ईमानदार-आंशिक परिभाषाएँ शामिल हैं - जब कोई कार्य रुक जाता है, तो सिस्टम यह दस्तावेज़ करता है कि क्या पूरा हो गया है और क्या शेष है, बजाय इसके कि वह झूठा दावा करे कि कार्य पूरा हो गया है।
-
-### विचार-मंथन मिशन
-
-यह "एआई विचार-मंथन" नहीं है। विचार-मंथन मिशन **कानून के तहत विशिष्ट भूमिकाएं हैं, जिसमें ट्रेस करने योग्य असहमति और निर्णय-आधारित आउटपुट होता है।**
-
-```bash
-roleos run "explore product directions for a developer tool discovery platform"
-# → MISSION: Brainstorm (Structured Inquiry)
-#   Chain: 4 Analysts (parallel) → Normalize → Cross-Examine → Rebut → Synthesize → Expand → Judge
-```
-
-**यह क्या अलग बनाता है:**
-
-- **लेयर 1 (सत्य):** चार विश्लेषक भूमिका-आधारित स्कीमा (संदर्भ मानचित्र, उपयोगकर्ता मूल्य मानचित्र, यांत्रिकी मानचित्र, स्थिति मानचित्र) उत्पन्न करते हैं — कोई साझा पाठ नहीं। प्रत्येक भूमिका पर "ब्लाइंडस्पॉट" लागू किया जाता है: प्रतिबंधित वाक्यांश, प्रतिबंधित दावे के प्रकार, फ़िल्टर किए गए इनपुट विभाजन। परमाणु उत्पत्ति जानकारी रखते हैं। एक निर्देशित क्रॉस-परीक्षा ग्राफ लक्षित चुनौतियां उत्पन्न करता है। मूल विश्लेषक दबाव में बचाव करते हैं, संकुचित करते हैं या वापस लेते हैं।
-
-- **लेयर 2 (प्रस्तुत करना):** पांच अलग-अलग मानवीय आवाजें (सीमा ज्ञापन, क्षेत्र नोट्स, सिस्टम स्केच, दावा संक्षिप्त, क्रॉस-परीक्षा प्रतिलेख) हैं, जिनमें शब्द संबंधी प्रतिबंध हैं जो आवाजों के एक होने से रोकते हैं। संश्लेषण "सत्य" का उपयोग करता है, कभी भी प्रस्तुत पाठ का नहीं। दोनों परतें हमेशा उपलब्ध होती हैं।
-
-- **श्रृंखला की प्रामाणिकता:** प्रत्येक प्रस्तुत वाक्य एक "ट्रूथ-लेयर" परमाणु से जुड़ा होता है। संश्लेषण निर्देशों में परमाणुओं का उल्लेख होता है। क्रॉस-परीक्षा वास्तविक दावा आईडी को लक्षित करती है। विवाद ग्राफ उत्पाद है, पाठ नहीं।
-
-**सिद्ध:** v0.4 "गोल्डन रन" — 894 परीक्षण, पूरी श्रृंखला की प्रामाणिकता सत्यापित। पूर्ण कलाकृति श्रृंखला के लिए [`examples/golden-run.md`](examples/golden-run.md) देखें।
-
-## स्थिति
-
-- v0.1–v0.4: आधार — परीक्षण, अपनाना, उपचार पैकेज, शुरुआती पैकेज।
-- v1.0.0: 32 भूमिकाएँ, पूर्ण कमांड-लाइन इंटरफ़ेस (CLI), सिद्ध उपचार, मल्टी-रिपो पोर्टेबिलिटी।
-- v1.0.2: भूमिका ऑपरेटिंग सिस्टम (OS) लॉकिंग (बूटस्ट्रैप सत्य सुधार, 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` CLI। संरचनात्मक सुधारों पर ईमानदार वृद्धि। 398 परीक्षण।
-- v1.8.0: मिशन लाइब्रेरी (फेज S) — 6 नामित मिशन, रनर इंजन, पूर्णता रिपोर्ट। 6 वास्तविक परीक्षण रनों से सुरक्षित किया गया। 481 परीक्षण।
-- v1.9.0: एकीकृत प्रवेश पथ (फेज T) — `roleos start` स्वचालित रूप से मिशन बनाम पैकेज बनाम फ्री रूटिंग का निर्णय लेता है। फ़ॉलबैक सीढ़ी, समग्र पता लगाना, प्रवेश-पथ तुलना परीक्षण। 527 परीक्षण।
-- **v2.0.0**: ऑपरेटर घर्षण सुधार (फेज U) — `roleos run` स्थायी डिस्क-समर्थित रन बनाता है। फिर से शुरू करें, अगला, समझाएं, पूरा करें, विफल। हस्तक्षेप: पुनर्निर्देशित करें, बढ़ाएं, पुनः प्रयास करें, अवरुद्ध करें, पुनः खोलें। प्रत्येक चरण में चरण-स्थानीय मार्गदर्शन। घर्षण माप। 6 घर्षण परीक्षण। 613 परीक्षण।
-- **v2.0.1**: हैंडबुक ऑडिट, शुरुआती दस्तावेज़, परीक्षण गणना सुधार। 617 परीक्षण।
-- **v2.1.0**: ब्रेनस्टॉर्म मिशन (v0.4) — कानून के तहत विशिष्ट भूमिकाएँ, पता लगाने योग्य असहमति, निर्णय-वाहक आउटपुट। दो-स्तरीय आर्किटेक्चर (सत्य + रेंडर), क्रॉस-परीक्षा अनुमति मैट्रिक्स, विवाद ग्राफ, गोल्डन रन प्रमाण। 7 मिशन, 50 भूमिकाएँ, 8 पैकेज। 894 परीक्षण।
-
-## लाइसेंस
-
-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="600">
+</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 भूमिकाओं को पैकेट सामग्री के विरुद्ध स्कोर करता है और एक गतिशील श्रृंखला बनाता है।
+
+यह सिस्टम कभी भी किसी गलत स्तर पर काम को लागू नहीं करता है। यह बताता है कि इसने प्रत्येक स्तर को क्यों चुना और वैकल्पिक विकल्प भी प्रदान करता है।
+
+**एक कमांड से सक्रिय निष्पादन:**
+
+```bash
+roleos run "fix the crash in save handler"
+# → Created run: run-1234
+# → Entry: MISSION (bugfix)
+# → Started step 0: Repo Researcher → diagnosis-report
+# → Guidance: Required sections: entrypoints, module-map, build-test-commands
+
+roleos next                    # Start the next step
+roleos complete diagnosis.md   # Complete the active step with artifact
+roleos explain                 # Show full run state and guidance
+roleos resume                  # Continue an interrupted run
+roleos report                  # Generate completion report
+roleos friction                # Measure operator touches
+```
+
+**जब चीजें गलत हो जाती हैं तो हस्तक्षेप:**
+
+```bash
+roleos retry 0                 # Retry a failed step
+roleos reroute 1 "Frontend Developer" "UI bug"  # Swap a role
+roleos escalate "Test Engineer" "Repo Researcher" "missed edge case" "re-diagnose"
+roleos block 2 "waiting for API spec"
+roleos reopen 0 "found issue in review"
+```
+
+यह सिस्टम डिस्क पर डेटा संग्रहीत करता है (`.claude/runs/`), इसलिए बाधित सत्र बिना किसी समस्या के फिर से शुरू हो जाते हैं। प्रत्येक चरण में ऑपरेटर के मार्गदर्शन शामिल हैं: क्या उत्पन्न करना है, आवश्यक अनुभाग और समाप्ति की शर्तें।
+
+**एक बार रूट होने के बाद:**
+
+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 run "fix the crash in save handler"
+# → Creates run, picks bugfix mission, starts first step with guidance
+
+# Step through:
+roleos next                    # Start next step
+roleos complete artifact.md    # Complete with artifact
+roleos explain                 # Show full state
+roleos report                  # Completion report
+
+# Or go manual:
+roleos start "fix the crash"   # Entry decision only (no run)
+roleos packet new feature
+roleos route .claude/packets/my-feature.md
+roleos review .claude/packets/my-feature.md accept
+
+# Explore missions and packs:
+roleos mission list
+roleos packs list
+```
+
+## रोल ओएस का उपयोग कब नहीं करना चाहिए
+
+- सिंगल-लाइन सुधार, टाइपो या स्पष्ट बग
+- कोई परिभाषित आउटपुट नहीं होने वाला अन्वेषी अनुसंधान
+- ऐसा कार्य जो 5 मिनट में एक व्यक्ति के दिमाग में आ जाए
+- आपातकालीन सुधार जो समीक्षा श्रृंखला पूरी होने से पहले जारी करने की आवश्यकता होती है
+- ऐसे प्रोजेक्ट जहां आप संरचना से अधिक गति को प्राथमिकता देते हैं
+
+## सबूत
+
+रोल ओएस को दो संरचनात्मक रूप से भिन्न रिपॉ में तीन परीक्षणों में सिद्ध किया गया है:
+
+**परीक्षण 001 — फीचर कार्य** (क्रू स्क्रीन, स्टार फ्रेट)
+- 7-भूमिका श्रृंखला, 45 परीक्षण परिदृश्य, 0 भूमिका टकराव।
+- फोर्क किए गए पूर्वज से संदूषण को रोका, इनलाइन आविष्कार को पकड़ा, ईमानदार अवरोधकों को उजागर किया।
+
+**परीक्षण 002 — एकीकरण कार्य** (कैंपेनस्टेट वायरिंग, स्टार फ्रेट)
+- 5-भूमिका श्रृंखला, आर्किटेक्चरल सीम को बिना किसी झूठे समाधान के हल किया।
+- एंटी-फॉलबैक परीक्षणों ने साबित किया कि लाइव पथ वास्तविक है, न कि केवल एक अस्थायी समाधान।
+
+**परीक्षण 003 — पहचान कार्य** (संदूषण हटाना, स्टार फ्रेट)
+- 6-भूमिका श्रृंखला, 51 परीक्षण परिदृश्य, जिसमें स्थायी CI संदूषण रक्षा शामिल है।
+- विरासत में मिली त्रुटियों को ठीक किया बिना व्यापक पुन: डिज़ाइन में जाने से बचाया।
+
+**पोर्टेबिलिटी परीक्षण** (पर्सोना स्थिरता, सेंसर-हास्य)
+- समान आधार संरचना, लेकिन अलग भाषा/डोमेन/स्टैक।
+- केवल संदर्भ में बदलाव के साथ अपनाया गया है - कोई भी मुख्य अनुबंध संशोधन नहीं।
+
+**पूर्ण उपचार FT-001** (portlight-desktop)
+- उपचार पैक भूमिकाओं के साथ 7-चरण वाला स्टाफ उपचार
+- शिपचेक गेटिंग सिद्ध, कोई भूमिका टकराव नहीं
+
+**पूर्ण उपचार FT-002** (studioflow)
+- समान उपचार पैक, संरचनात्मक रूप से अलग रिपॉजिटरी (रचनात्मक कार्यक्षेत्र बनाम गेम)
+- उपचार पैक पोर्टेबल - किसी अनुबंध संशोधन की आवश्यकता नहीं
+
+**"गोल्डन रन" पर विचार-मंथन** (एमसीपी सर्वर मार्केटप्लेस विषय)
+- 9 भूमिकाओं की श्रृंखला, 4 विश्लेषक समानांतर में, क्रॉस-परीक्षा + विवाद ग्राफ का खंडन
+- 4 चुनौतियां जारी की गईं, 3 दावों को संकुचित किया गया, 1 अनसुलझा — स्वस्थ दबाव, कोई गतिरोध नहीं
+- प्रस्तुत कलाकृतियों से 16+ ट्रेस लिंक "ट्रूथ-लेयर" परमाणुओं तक
+- पूरी श्रृंखला की प्रामाणिकता सिद्ध: सत्य → परमाणु → विवाद → संश्लेषण → विस्तार → न्यायाधीश → प्रस्तुत करना → ट्रेस
+
+## मुख्य विशेषताएं
+
+ये अपरिवर्तनीय हैं। यदि कोई बदलाव इनमें से किसी भी विशेषता को कमजोर करता है, तो उसे अस्वीकार कर दें।
+
+- भूमिका की सीमाएं बरकरार हैं।
+- समीक्षा प्रक्रिया प्रभावी है।
+- शिकायत प्रक्रिया ईमानदार है।
+- परीक्षण योग्य पैकेट बरकरार हैं।
+- पोर्टेबिलिटी के लिए संदर्भ के अनुकूलन की आवश्यकता होती है, न कि मुख्य संरचना में बदलाव की।
+
+## परियोजना संरचना
+
+```
+role-os/
+  bin/roleos.mjs               ← CLI entrypoint
+  src/
+    entry.mjs                  ← Unified entry: mission → pack → free routing
+    entry-cmd.mjs              ← `roleos start` CLI command
+    run.mjs                    ← Persistent run engine: create → step → pause → resume → report
+    run-cmd.mjs                ← `roleos run/resume/next/explain/complete/fail` + interventions
+    mission.mjs                ← 7 named mission types (feature, bugfix, treatment, docs, security, research, brainstorm)
+    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              ← 30 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
+    brainstorm.mjs             ← Evidence modes, request validation, finding/synthesis/judge schemas
+    brainstorm-roles.mjs       ← Role-native schemas, input partitioning, blindspot enforcement, cross-exam
+    brainstorm-render.mjs      ← Two-layer rendering: lexical bans, render schemas, debate transcript
+  test/                        ← 894 tests across 30 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` कमांड स्वचालित रूप से मिशन, पैकेट, या स्वतंत्र रूटिंग का चयन करता है। आत्मविश्वास स्कोर, विकल्पों, और संयुक्त पहचान के साथ एक वैकल्पिक प्रणाली। | ✓ जारी किया गया |
+| **Persistent runs** | `roleos run` डिस्क-आधारित निष्पादन बनाता है। `resume`, `next`, `explain`, `complete`, `fail`। हस्तक्षेप: पुनर्निर्देशित करें, बढ़ाएं, पुनः प्रयास करें, अवरुद्ध करें, फिर से खोलें। चरण-स्तरीय मार्गदर्शन। घर्षण माप। | ✓ जारी किया गया |
+| **Brainstorm** | दो-स्तरीय आर्किटेक्चर: सत्य (भूमिका-आधारित स्कीमा, उत्पत्ति परमाणु, क्रॉस-परीक्षा विवाद ग्राफ) + प्रस्तुत करना (5 अलग-अलग आवाजें, शब्द संबंधी प्रतिबंध, बहस का प्रतिलेख)। ट्रेस लिंक साबित करते हैं कि प्रत्येक प्रस्तुत दावा एक "ट्रूथ" परमाणु से मेल खाता है। "गोल्डन रन": 894 परीक्षण। | ✓ जारी किया गया |
+
+## 6 मिशन
+
+| मिशन | पैक | भूमिकाएं | कब उपयोग करें |
+|---------|------|-------|-------------|
+| `feature-ship` | फ़ीचर | 5 | पूर्ण फ़ीचर डिलीवरी: दायरा → विनिर्देश → कार्यान्वयन → परीक्षण → समीक्षा |
+| `bugfix` | बगफिक्स | 4 | मूल कारण का निदान, सुधार, परीक्षण, सत्यापन |
+| `treatment` | ट्रीटमेंट | 4 | शिपचेक + पॉलिश + दस्तावेज़ + CI सत्यापन + समीक्षा |
+| `docs-release` | दस्तावेज़ | 2 | दस्तावेज़ लिखें/अपडेट करें, रिलीज़ नोट्स |
+| `security-hardening` | सुरक्षा | 4 | खतरे का मॉडल, ऑडिट, कमजोरियों को ठीक करें, फिर से ऑडिट करें, सत्यापन |
+| `research-launch` | अनुसंधान | 4 | प्रश्न तैयार करें, अनुसंधान करें, निष्कर्षों को दस्तावेज़ करें, निर्णय लें |
+| `brainstorm` | विचार-मंथन | 9 | ट्रेस करने योग्य असहमति और निर्णय के साथ संरचित बहु-दृष्टिकोण जांच। |
+
+प्रत्येक मिशन में ईमानदार-आंशिक परिभाषाएँ शामिल हैं - जब कोई कार्य रुक जाता है, तो सिस्टम यह दस्तावेज़ करता है कि क्या पूरा हो गया है और क्या शेष है, बजाय इसके कि वह झूठा दावा करे कि कार्य पूरा हो गया है।
+
+### विचार-मंथन मिशन
+
+यह "एआई विचार-मंथन" नहीं है। विचार-मंथन मिशन **कानून के तहत विशिष्ट भूमिकाएं हैं, जिसमें ट्रेस करने योग्य असहमति और निर्णय-आधारित आउटपुट होता है।**
+
+```bash
+roleos run "explore product directions for a developer tool discovery platform"
+# → MISSION: Brainstorm (Structured Inquiry)
+#   Chain: 4 Analysts (parallel) → Normalize → Cross-Examine → Rebut → Synthesize → Expand → Judge
+```
+
+**यह क्या अलग बनाता है:**
+
+- **लेयर 1 (सत्य):** चार विश्लेषक भूमिका-आधारित स्कीमा (संदर्भ मानचित्र, उपयोगकर्ता मूल्य मानचित्र, यांत्रिकी मानचित्र, स्थिति मानचित्र) उत्पन्न करते हैं — कोई साझा पाठ नहीं। प्रत्येक भूमिका पर "ब्लाइंडस्पॉट" लागू किया जाता है: प्रतिबंधित वाक्यांश, प्रतिबंधित दावे के प्रकार, फ़िल्टर किए गए इनपुट विभाजन। परमाणु उत्पत्ति जानकारी रखते हैं। एक निर्देशित क्रॉस-परीक्षा ग्राफ लक्षित चुनौतियां उत्पन्न करता है। मूल विश्लेषक दबाव में बचाव करते हैं, संकुचित करते हैं या वापस लेते हैं।
+
+- **लेयर 2 (प्रस्तुत करना):** पांच अलग-अलग मानवीय आवाजें (सीमा ज्ञापन, क्षेत्र नोट्स, सिस्टम स्केच, दावा संक्षिप्त, क्रॉस-परीक्षा प्रतिलेख) हैं, जिनमें शब्द संबंधी प्रतिबंध हैं जो आवाजों के एक होने से रोकते हैं। संश्लेषण "सत्य" का उपयोग करता है, कभी भी प्रस्तुत पाठ का नहीं। दोनों परतें हमेशा उपलब्ध होती हैं।
+
+- **श्रृंखला की प्रामाणिकता:** प्रत्येक प्रस्तुत वाक्य एक "ट्रूथ-लेयर" परमाणु से जुड़ा होता है। संश्लेषण निर्देशों में परमाणुओं का उल्लेख होता है। क्रॉस-परीक्षा वास्तविक दावा आईडी को लक्षित करती है। विवाद ग्राफ उत्पाद है, पाठ नहीं।
+
+**सिद्ध:** v0.4 "गोल्डन रन" — 894 परीक्षण, पूरी श्रृंखला की प्रामाणिकता सत्यापित। पूर्ण कलाकृति श्रृंखला के लिए [`examples/golden-run.md`](examples/golden-run.md) देखें।
+
+## स्थिति
+
+- v0.1–v0.4: आधार — परीक्षण, अपनाना, उपचार पैकेज, शुरुआती पैकेज।
+- v1.0.0: 32 भूमिकाएँ, पूर्ण कमांड-लाइन इंटरफ़ेस (CLI), सिद्ध उपचार, मल्टी-रिपो पोर्टेबिलिटी।
+- v1.0.2: भूमिका ऑपरेटिंग सिस्टम (OS) लॉकिंग (बूटस्ट्रैप सत्य सुधार, 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` CLI। संरचनात्मक सुधारों पर ईमानदार वृद्धि। 398 परीक्षण।
+- v1.8.0: मिशन लाइब्रेरी (फेज S) — 6 नामित मिशन, रनर इंजन, पूर्णता रिपोर्ट। 6 वास्तविक परीक्षण रनों से सुरक्षित किया गया। 481 परीक्षण।
+- v1.9.0: एकीकृत प्रवेश पथ (फेज T) — `roleos start` स्वचालित रूप से मिशन बनाम पैकेज बनाम फ्री रूटिंग का निर्णय लेता है। फ़ॉलबैक सीढ़ी, समग्र पता लगाना, प्रवेश-पथ तुलना परीक्षण। 527 परीक्षण।
+- **v2.0.0**: ऑपरेटर घर्षण सुधार (फेज U) — `roleos run` स्थायी डिस्क-समर्थित रन बनाता है। फिर से शुरू करें, अगला, समझाएं, पूरा करें, विफल। हस्तक्षेप: पुनर्निर्देशित करें, बढ़ाएं, पुनः प्रयास करें, अवरुद्ध करें, पुनः खोलें। प्रत्येक चरण में चरण-स्थानीय मार्गदर्शन। घर्षण माप। 6 घर्षण परीक्षण। 613 परीक्षण।
+- **v2.0.1**: हैंडबुक ऑडिट, शुरुआती दस्तावेज़, परीक्षण गणना सुधार। 617 परीक्षण।
+- **v2.1.0**: ब्रेनस्टॉर्म मिशन (v0.4) — कानून के तहत विशिष्ट भूमिकाएँ, पता लगाने योग्य असहमति, निर्णय-वाहक आउटपुट। दो-स्तरीय आर्किटेक्चर (सत्य + रेंडर), क्रॉस-परीक्षा अनुमति मैट्रिक्स, विवाद ग्राफ, गोल्डन रन प्रमाण। 7 मिशन, 50 भूमिकाएँ, 8 पैकेज। 894 परीक्षण।
+
+## लाइसेंस
+
+MIT
+
+---
+
+द्वारा निर्मित: <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a