@mcptoolshop/research-os 0.1.0

package/README.hi.md

@@ -0,0 +1,164 @@
+<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/research-os/readme.png" alt="research-os" width="400">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/research-os/releases/tag/v0.1.0"><img src="https://img.shields.io/badge/version-0.1.0-blue" alt="version 0.1.0"></a>
+  <a href="https://github.com/mcp-tool-shop-org/research-os/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/research-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A520-brightgreen" alt="Node ≥20">
+  <a href="https://mcp-tool-shop-org.github.io/research-os/handbook/"><img src="https://img.shields.io/badge/handbook-live-purple" alt="Handbook"></a>
+</p>
+
+# अनुसंधान-ओएस (रिसर्च-ओएस)
+
+एक ऐसा स्थानीय-आधारित कमांड-लाइन इंटरफेस (CLI) जो किसी भी विषय को एक संरचित "अनुसंधान पैकेज" में बदल देता है। यह एक व्यवस्थित भंडार है जहाँ क्लाउड, कोवर्किंग टूल या एक समूह घंटों तक बिना किसी भ्रम या गलत जानकारी के गहन शोध कर सकता है।
+
+## यह क्या है।
+
+`research-os` एक नियंत्रण प्रणाली है जो "मैं X पर शोध करना चाहता हूं" और एक स्थिर, प्रमाण-आधारित डेटाबेस के बीच संबंध स्थापित करती है। यह खोज के शुरुआती चरणों को प्रमाणों को प्राप्त करने से, कच्चे डेटा निष्कर्षण को छांटे गए दावों से, विरोधाभासों का पता लगाने को विरोधाभासों के समाधान से, और समीक्षा निर्णयों को संश्लेषण निर्णयों से अलग करती है। प्रत्येक चरण में, जानकारी केवल जोड़ने के लिए लिखी जाती है; प्रत्येक निष्कर्ष केवल उन दर्ज की गई जानकारियों के आधार पर निकाला जाता है, न कि किसी धारणा के आधार पर।
+
+यह कोई रिपोर्ट जनरेटर नहीं है। यह कोई एलएलएम (LLM) प्रबंधन प्रणाली भी नहीं है। यह आपके लिए संश्लेषण (सिंथेसिस) नहीं लिखता है। यह उन शर्तों को लागू करता है जिनके तहत संश्लेषण शुरू किया जा सकता है।
+
+**v0.1 का उपयोग केवल एक बार किया गया है: अकेले, अपने आप में।** इस एक उपयोग में, `research-os` में सात त्रुटियाँ पाई गईं, जिन्हें इस संस्करण के जारी होने से पहले ठीक कर दिया गया था। इस परीक्षण प्रक्रिया से संबंधित जानकारी—सात सत्र, दो एकीकरण पैटर्न, 463 विटेस्ट परीक्षण मामले, और एक स्थिर पैकेज—[`docs/dogfood-proof.md`](docs/dogfood-proof.md) में उपलब्ध है। लाइव हैंडबुक: <https://mcp-tool-shop-org.github.io/research-os/handbook/>।
+
+## 16 भार-वाहक नियम।
+
+| # | कानून। |
+|---|-----|
+| 1 | किसी भी निष्कर्ष पर पहुंचने से पहले, मूल तथ्यों की जांच करना आवश्यक है। |
+| 2 | "डेटा प्राप्त करना सबूत है; डेटा का विश्लेषण करना उसकी व्याख्या है।" |
+| 3 | मॉडल, स्रोत पाठ के विशिष्ट हिस्सों की व्याख्या कर सकते हैं; हालांकि, वे स्वयं साक्ष्य वाले हिस्सों को नहीं बना सकते। |
+| 4 | निष्कर्षण प्रक्रिया में अत्यधिक उत्पादन हो सकता है; संश्लेषण प्रक्रिया में प्रचुरता का अभाव हो सकता है। |
+| 5 | विरोधाभासों की पहचान सतह पर तनाव को उजागर करती है; यह तनाव को कम नहीं करती, न ही विभिन्न दावों को मिलाकर एक समाधान प्रस्तुत करती है, और न ही यह तय करती है कि कौन सा दावा सही है। |
+| 6 | "गेट्स यह निर्धारित करते हैं कि कोई खंड संश्लेषण के लिए योग्य है या नहीं। वे संश्लेषण नहीं करते हैं और न ही विफलता को छिपाते हैं।" |
+| 7 | "विरोधात्मक समीक्षा अनुसंधान की निष्ठा का मूल्यांकन करती है। यह मूल जानकारी को संश्लेषित या पुनर्लेखित नहीं करती है।" |
+| 8 | इंडेक्सिंग (सूचकांकन) से शोध संबंधी जानकारी को खोजा जा सकता है। यह नई जानकारी का निर्माण नहीं करता है, और न ही यह किसी आधिकारिक रिकॉर्ड का स्रोत बनता है। |
+| 9 | "कोवर्किंग हैंडऑफ" अनुसंधान के आधार पर परिचालन संबंधी निर्देश प्रदान करता है। यह किसी भी तरह से सत्य का निर्माण नहीं करता है, और न ही किसी भी प्रक्रिया को बाईपास करता है। |
+| 10 | सिंथेसिस वर्कस्पेस, कोवर्किंग के लिए स्वीकृत शोध निष्कर्षों को व्यवस्थित करता है। यह संश्लेषण (सिंथेसिस) नहीं बनाता है, और न ही डेटा ट्रांसफर प्रक्रिया को बाईपास करता है। |
+| 11 | "पैक ऑडिट" मौजूदा शोध के निष्कर्षों को एक साथ लाता है। यह कोई नई जानकारी नहीं बनाता है, और न ही किसी विशेष खंड से संबंधित साक्ष्यों को छुपाता है। |
+| 12 | डिस्कवरी संभावित समाधानों का सुझाव देती है; केवल 'फच' (fetch) ही प्रमाण प्रदान करता है। |
+| 13 | एक समीक्षक पर तब तक भरोसा नहीं किया जाता, जब तक कि परीक्षणों में उसकी गलतियों को उजागर करके उसकी क्षमता का मूल्यांकन न कर लिया जाए। |
+| 14 | दावों की अधिकता अनुसंधान की गुणवत्ता को दर्शाती नहीं है। दावों का मूल्यांकन किया जाना चाहिए ताकि उन्हें संश्लेषण के लिए योग्य माना जा सके। |
+| 15 | "फ्रीज़" (Freeze) सुविधा पूर्ण रूप से समाप्त हो चुके शोध को सुरक्षित रखती है। यह अधूरे शोध को पूरा नहीं करती है, और न ही किसी त्रुटिपूर्ण स्थिति को प्रमाण के रूप में परिवर्तित करती है। |
+| 16 | "छूट (वेवर्स) स्रोतों पर लगी पाबंदियों को कम करती हैं; वे सबूत नहीं बना सकतीं।" |
+
+**नियम 3:** एलएलएम (LLM) कभी भी किसी प्रमाणिक पाठ का निर्माण नहीं करता है। "रिसर्च-ओएस" (research-os) एक निश्चित प्रकार की अंशों की सूची (लेजर) बनाता है, जिसमें स्थिर पहचान संख्याएँ होती हैं, जैसे कि `ex_<स्रोत_आईडी_हेक्स>_001`। एलएलएम इन अंशों की पहचान संख्याओं का चयन करता है, और "रिसर्च-ओएस" वास्तविक पाठ की प्रतिलिपि बनाता है। "पुन: वाक्यांश बनाकर उद्धरण" करने में विफलता की स्थिति संरचनात्मक रूप से असंभव है।
+
+**नियम 14:** निष्कर्षण और समीक्षा के बीच, `रिसर्च-ओएस (Research-OS) दावा वर्गीकरण` (claim triage) डुप्लिकेट प्रविष्टियों को हटाता है, प्रत्येक स्रोत से योगदान की सीमा निर्धारित करता है, और कम महत्व वाले उम्मीदवारों को अस्थायी रूप से रखता है। यह वर्गीकरण प्रक्रिया `claims.jsonl` फ़ाइल में कोई बदलाव नहीं करती है; अस्थायी रूप से रखे गए दावों को मूल रिकॉर्ड में ही रखा जाता है।
+
+## v0.1 संस्करण का कार्यप्रवाह श्रृंखला।
+
+```
+discover
+→ gather
+→ claim extract
+→ claim audit-density
+→ claim triage
+→ contradict map
+→ contradict resolve
+→ review
+→ review-promote
+→ gate
+→ section report
+→ audit
+→ index build
+→ cowork handoff
+→ synth workspace
+→ freeze
+```
+
+प्रत्येक चरण एक कमांड-लाइन इंटरफेस (CLI) कमांड है। प्रत्येक चरण केवल अपेंड (जोड़ना) करने वाले फ़ाइलों में लिखता है। कोई भी चरण संश्लेषण नहीं करता है, समाधान नहीं करता है, या नई जानकारी नहीं बनाता है - ये अपरिवर्तनीय नियम लागू किए जाते हैं, उन पर भरोसा नहीं किया जाता। समीक्षा प्रक्रिया में, दावे स्वीकार या अस्वीकार किए जाते हैं या सुधार का अनुरोध किया जाता है; गेट प्रक्रिया इन समीक्षा निर्णयों का उपयोग `synthesis_eligible` की गणना करने के लिए करती है; 'फ्रीज' अंतिम सुरक्षा लॉक है जो किसी भी पैकेज को 'पूर्ण' के रूप में चिह्नित करने से इनकार करता है, जब तक कि सभी स्तर सहमत न हों। `v0.1` के प्रमाण के लिए, जो दर्शाता है कि यह श्रृंखला अंत-से-अंत तक काम करती है, [docs/dogfood-proof.md](docs/dogfood-proof.md) देखें।
+
+यह *खोज → सारांश → सुंदर रिपोर्ट* का एक संरचनात्मक विकल्प है। यह श्रृंखला ही उत्पाद है।
+
+## स्थापना
+
+**आवश्यकताएँ:** Node.js ≥ 20।
+
+```bash
+# From source (v0.1.0 is not yet published to npm)
+git clone https://github.com/mcp-tool-shop-org/research-os.git
+cd research-os
+npm install
+npm run build
+npm link   # makes `research-os` available on your PATH
+```
+
+## शुरुआत
+
+```bash
+# Create a new research-pack
+research-os init "How should X be structured?"
+
+# Add a section
+research-os section add 01-landscape --purpose "Map the current landscape"
+
+# Discover and approve sources, then gather
+research-os discover run 01-landscape
+research-os discover approve 01-landscape --top 8
+research-os gather 01-landscape --approved
+
+# Run the per-section chain
+research-os claim extract 01-landscape
+research-os claim audit-density 01-landscape
+research-os claim triage 01-landscape
+research-os contradict map 01-landscape --triaged-only
+research-os review 01-landscape --triaged-only --preset hermes-two-pass --profile hermes-two-pass
+research-os review-promote 01-landscape --profile hermes-two-pass
+research-os gate 01-landscape
+research-os section report 01-landscape
+
+# Pack-level finish
+research-os audit
+research-os index build --all
+research-os cowork handoff
+research-os synth workspace   # only if handoff returned synthesis_ready
+research-os freeze
+```
+
+**एक वास्तविक उदाहरण के लिए**, `research-os-packs/research-os-spec/` पर मौजूद 'डॉगफूड' पैकेज देखें - प्रत्येक फ़ाइल, प्रत्येक रिकॉर्ड, प्रत्येक स्थिति, प्रत्येक 'फ्रीज' फ़िंगरप्रिंट, सभी केवल अपेंड करने योग्य लॉग फ़ाइलों में मौजूद हैं। इसी पैकेज ने `docs/dogfood-proof.md` बनाया है।
+
+**स्थानीय रूप से चलने वाले [ollama-intern-mcp](https://github.com/mcp-tool-shop-org/ollama-intern-mcp) की आवश्यकता है** एलएलएम (LLM) निष्कर्षण, वर्गीकरण, समीक्षा और खोज के लिए। डिफ़ॉल्ट मॉडल `hermes3:8b` है; `OLLAMA_INTERN_MODEL=<model>` के साथ इसे बदला जा सकता है। यदि ओलामा डिफ़ॉल्ट `localhost:11434` पर नहीं चल रहा है, तो `OLLAMA_HOST` सेट करें।
+
+## शब्दावली
+
+| पद | अर्थ |
+|------|---------|
+| `research-os` | नियंत्रण प्रणाली / कमांड-लाइन इंटरफेस / गेट / समन्वय नियम (यह रिपॉजिटरी) |
+| `research-pack` | एक शोध प्रयास के लिए उत्पन्न रिपॉजिटरी फ़ाइल |
+| `research section` | एक पैकेज के भीतर जांच का एक सीमित इकाई |
+| `research receipt` | यह दर्शाता है कि एक अनुभाग ने स्रोत/दावा/गेट जांच पास कर ली है |
+
+## सुरक्षा
+
+`research-os` एक स्थानीय-प्रथम कमांड-लाइन इंटरफेस है। यह उन शोध-पैकेज निर्देशिकाओं में फ़ाइलों को पढ़ता और लिखता है जिन्हें आप निर्दिष्ट करते हैं, और (जब `gather` का उपयोग किया जाता है) स्रोत यूआरएल प्राप्त करने के लिए बाहरी HTTP अनुरोध भेजता है जिन्हें आप प्रदान करते हैं। यह निम्नलिखित नहीं करता है: कोई सर्वर नहीं चलाता, इनकमिंग कनेक्शन स्वीकार नहीं करता, क्रेडेंशियल संग्रहीत नहीं करता, या टेलीमेट्री नहीं भेजता। किसी भी गुप्त जानकारी को पैकेज फ़ाइलों में नहीं लिखा जाता है। भेद्यता रिपोर्टिंग नीति के लिए [SECURITY.md](SECURITY.md) देखें।
+
+## स्थिति
+
+**v0.1.0** — 2026-05-08 को 'फ्रीज' किया गया। `research-os-packs/research-os-spec/` (संबंधित रिपॉजिटरी) पर मौजूद 'डॉगफूड' पैकेज में 8 अनुभागों में से 296 दावों को स्वीकार किया गया, 17 को स्थिति दी गई, 30 को ऑपरेटर द्वारा बदला गया, 0 सक्रिय सुधार अवरोधक हैं, कोई अनसुलझा विरोधाभास नहीं है, सभी गेट `synthesis_eligible=true` हैं। 463/463 'विटेस्ट' पास हो गए। कुल 16 महत्वपूर्ण नियम लागू हैं। 'फ्रीज' रसीद फ़िंगरप्रिंट और अन्य जानकारी के लिए [`docs/dogfood-proof.md`](docs/dogfood-proof.md) देखें।
+
+### v0.1 क्या नहीं है
+
+- बाहरी उपयोगकर्ताओं द्वारा परीक्षण नहीं किया गया है। एकल 'डॉगफूड' रन में सात बग पाए गए।
+- अभी npm पर उपलब्ध नहीं है। `npm publish` होने तक स्रोत कोड से स्थापित करें।
+- संश्लेषण लिखने वाला उपकरण नहीं है। `synth workspace` कमांड संरचित कार्यक्षेत्र बनाता है; स्वीकृत दावा आईडी के विरुद्ध मानव (या Cowork) द्वारा सामग्री लिखी जाती है।
+- semver के तहत एपीआई स्थिर नहीं है। v1.0.0 एक अर्जित स्थिति है, कोई कैलेंडर तिथि नहीं - अंतर को भरने वाले पांच प्रयोगों के लिए [`docs/roadmap.md`](docs/roadmap.md) देखें।
+
+### ज्ञात सीमाएँ
+
+- **एक्सट्रैक्टर की उत्पत्ति गेट सीम पर दिखाई नहीं देती है।** एक सेक्शन, कैलिब्रेटेड एक्सट्रैक्टर (कॉन्फ़िगर किए गए मॉडल के साथ ओलामा) अनुपलब्ध होने पर, अनुमानित-बैकअप दावों पर निर्भर करते हुए, स्वीकृत-दावा स्तर को पार कर सकता है। इसे एक ज्ञात कमजोरी के रूप में दर्ज किया गया है; भविष्य में, सुरक्षा बढ़ाने के लिए, एक्सट्रैक्टर द्वारा स्वीकृत दावों की रिपोर्ट की जाएगी और कैलिब्रेटेड पथ से स्वीकृत दावों की अपेक्षित संख्या की आवश्यकता होगी।
+- **कैलिब्रेटेड `hermes-two-pass` बेसलाइन से परे, समीक्षक मॉडल का चयन अभी भी अनसुलझा है।** "डॉगफूड" परीक्षण में एक समीक्षक कॉन्फ़िगरेशन को मान्य किया गया था; अन्य मॉडलों को विश्वसनीय होने से पहले, उन्हें अपने स्वयं के "सीडेड-विफलता" रिकॉल कैलिब्रेशन की आवश्यकता होगी।
+- **"डॉगफूड" पैकेज ने निष्कर्षण के लिए `mistral-nemo:12b` का उपयोग किया (मानक डिफ़ॉल्ट `hermes3:8b` है)।** खोज ने स्व-संदर्भित सेक्शन नामों के लिए गलत डोमेन परिणाम उत्पन्न किए - जिन्हें क्वेरी-सटीकता अनुशासन (देखें हैंडबुक) और अस्पष्ट विषयों के लिए ऑपरेटर द्वारा पहले से तैयार किए गए यूआरएल के माध्यम से ठीक किया गया।
+
+## v1.0 के लिए रोडमैप
+
+v1.0 एक अर्जित स्थिति है, कोई रिलीज की तारीख नहीं। v0.1 और v1.0 के बीच पांच खुले प्रयोग हैं - बाहरी दबाव के तहत एपीआई स्थिरता, एक गैर-स्व-संदर्भित "डॉगफूड" पैकेज, एक्सट्रैक्टर-उत्पत्ति अंतर को भरना, `hermes-two-pass` से परे समीक्षक कैलिब्रेशन को सामान्य बनाना, और `hermes3:8b` पर एक स्वच्छ बेसलाइन रन। पूर्ण योजना [`docs/roadmap.md`](docs/roadmap.md) में है। आर्किटेक्चर लॉक पूरे समय बना रहेगा; v1.0, v0.1 द्वारा सिद्ध किए गए पहलुओं को गहरा करता है, न कि उन्हें फिर से खोलता है।
+
+## लाइसेंस
+
+MIT

package/README.it.md

@@ -0,0 +1,164 @@
+<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.hi.md">हिन्दी</a> | <a href="README.md">English</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/research-os/readme.png" alt="research-os" width="400">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/research-os/releases/tag/v0.1.0"><img src="https://img.shields.io/badge/version-0.1.0-blue" alt="version 0.1.0"></a>
+  <a href="https://github.com/mcp-tool-shop-org/research-os/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/research-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A520-brightgreen" alt="Node ≥20">
+  <a href="https://mcp-tool-shop-org.github.io/research-os/handbook/"><img src="https://img.shields.io/badge/handbook-live-purple" alt="Handbook"></a>
+</p>
+
+# research-os
+
+Un'interfaccia a riga di comando (CLI) che trasforma un argomento aperto in un **pacchetto di ricerca strutturato** — un repository organizzato in cui Claude, Cowork o un sistema simile possono lavorare per ore senza generare informazioni errate o distorcere l'indagine.
+
+## Cos'è
+
+`research-os` è il sistema di controllo tra "Voglio fare ricerche su X" e una base di dati di prove consolidata e tracciabile. Separa le ipotesi iniziali dalla raccolta delle prove, l'estrazione dei dati dalla verifica delle affermazioni, il rilevamento delle contraddizioni dalla loro risoluzione e le decisioni di revisione dalle conclusioni. Ogni fase scrive su un registro immutabile; ogni valutazione di idoneità viene calcolata in base a tali registri, e non è una semplice affermazione.
+
+Non è un generatore di report. Non è un framework di orchestrazione di modelli linguistici di grandi dimensioni (LLM). Non scrive la sintesi per te. Impone le condizioni necessarie per l'inizio della sintesi.
+
+**La versione 0.1 è stata utilizzata una sola volta: da sola, su se stessa.** Questa singola iterazione ha rilevato sette errori in `research-os`, tutti corretti prima di questa versione. La documentazione del processo — sette sessioni, due modelli di integrazione implementati, 463 test unitari, un pacchetto consolidato — è disponibile in [`docs/dogfood-proof.md`](docs/dogfood-proof.md). Manuale online: <https://mcp-tool-shop-org.github.io/research-os/handbook/>.
+
+## Le 16 leggi fondamentali
+
+| # | Legge |
+|---|-----|
+| 1 | Nessuna sintesi prima della verifica delle fonti. |
+| 2 | La raccolta è una prova; l'estrazione è un'interpretazione. |
+| 3 | I modelli possono interpretare porzioni di testo originale; non possono creare porzioni di testo che costituiscono una prova. |
+| 4 | L'estrazione può produrre un eccesso di informazioni; la sintesi non può ereditare questa abbondanza. |
+| 5 | La mappatura delle contraddizioni evidenzia le discrepanze; non le risolve, non le sintetizza e non decide quale affermazione è corretta. |
+| 6 | I controlli determinano se una sezione è idonea per la sintesi. Non eseguono la sintesi né nascondono i fallimenti. |
+| 7 | La revisione critica valuta l'integrità della ricerca. Non esegue la sintesi né riscrive il testo originale. |
+| 8 | L'indicizzazione rende la ricerca di informazioni basata su prove possibile. Non crea nuove informazioni né diventa la fonte ufficiale. |
+| 9 | La funzione di trasferimento a Cowork genera istruzioni operative a partire dalle informazioni verificate. Non crea informazioni né aggira i controlli. |
+| 10 | L'ambiente di lavoro per la sintesi organizza le informazioni verificate per Cowork. Non esegue la sintesi né aggira la modalità di trasferimento. |
+| 11 | L'audit del pacchetto aggrega le informazioni verificate esistenti. Non crea nuove informazioni né nasconde le prove a livello di sezione. |
+| 12 | La fase di scoperta propone spunti; solo la raccolta produce prove. |
+| 13 | Un revisore non è considerato affidabile finché non vengono dimostrati dei fallimenti e la sua capacità di rilevarli. |
+| 14 | L'abbondanza di affermazioni non è sinonimo di qualità della ricerca. Le affermazioni devono essere verificate prima di poter essere considerate per la sintesi. |
+| 15 | La fase di consolidamento blocca le informazioni verificate. Non completa la ricerca incompleta né converte lo stato di riparazione in prove. |
+| 16 | Le eccezioni allentano i vincoli delle fonti; non possono creare prove. |
+
+**Legge 3** — il modello linguistico non crea mai il testo delle prove. `research-os` crea un registro di estratti deterministico (con ID stabili come `ex_<source_id_hex>_001`); il modello linguistico seleziona gli ID degli estratti; `research-os` copia il testo letterale. La classe di errore "parafrasi come citazione" è strutturalmente impossibile.
+
+**Legge 14** — tra l'estrazione e la revisione, `research-os claim triage` deduplica, limita il contributo per fonte e mette da parte i candidati meno promettenti. La fase di triage NON modifica `claims.jsonl`; le affermazioni messe da parte rimangono nel registro principale.
+
+## La sequenza di lavoro della versione 0.1
+
+```
+discover
+→ gather
+→ claim extract
+→ claim audit-density
+→ claim triage
+→ contradict map
+→ contradict resolve
+→ review
+→ review-promote
+→ gate
+→ section report
+→ audit
+→ index build
+→ cowork handoff
+→ synth workspace
+→ freeze
+```
+
+Ogni passaggio è un comando da riga di comando. Ogni passaggio scrive su artefatti che possono essere solo aggiunti, non modificati. Nessun passaggio sintetizza, risolve o crea nuove verità; questi vincoli sono applicati, non considerati come affidabili. La fase di revisione accetta, rifiuta o richiede modifiche alle proposte; la fase di "gate" utilizza queste decisioni per calcolare l'idoneità alla sintesi; la fase di "freeze" è il blocco finale di integrità che impedisce di considerare un pacchetto come completato a meno che tutti i livelli non siano d'accordo. Consultare il file [docs/dogfood-proof.md](docs/dogfood-proof.md) per la documentazione della versione 0.1 che dimostra la coerenza dell'intera catena.
+
+Questa è un'alternativa strutturale a *ricerca → riepilogo → report dettagliato*. La catena è il prodotto.
+
+## Installazione
+
+**Requisiti:** Node.js ≥ 20.
+
+```bash
+# From source (v0.1.0 is not yet published to npm)
+git clone https://github.com/mcp-tool-shop-org/research-os.git
+cd research-os
+npm install
+npm run build
+npm link   # makes `research-os` available on your PATH
+```
+
+## Guida rapida
+
+```bash
+# Create a new research-pack
+research-os init "How should X be structured?"
+
+# Add a section
+research-os section add 01-landscape --purpose "Map the current landscape"
+
+# Discover and approve sources, then gather
+research-os discover run 01-landscape
+research-os discover approve 01-landscape --top 8
+research-os gather 01-landscape --approved
+
+# Run the per-section chain
+research-os claim extract 01-landscape
+research-os claim audit-density 01-landscape
+research-os claim triage 01-landscape
+research-os contradict map 01-landscape --triaged-only
+research-os review 01-landscape --triaged-only --preset hermes-two-pass --profile hermes-two-pass
+research-os review-promote 01-landscape --profile hermes-two-pass
+research-os gate 01-landscape
+research-os section report 01-landscape
+
+# Pack-level finish
+research-os audit
+research-os index build --all
+research-os cowork handoff
+research-os synth workspace   # only if handoff returned synthesis_ready
+research-os freeze
+```
+
+**Per un esempio pratico**, consultare il pacchetto di test interno in `research-os-packs/research-os-spec/` — ogni artefatto, ogni ricevuta, ogni decisione, ogni "impronta" della fase di "freeze", tutto memorizzato su disco in registri che consentono solo l'aggiunta di dati. Questo pacchetto ha generato il file `docs/dogfood-proof.md`.
+
+**Richiede [ollama-intern-mcp](https://github.com/mcp-tool-shop-org/ollama-intern-mcp) in esecuzione localmente** per l'estrazione, la classificazione, la revisione e la scoperta tramite modelli linguistici di grandi dimensioni (LLM). Il modello predefinito è `hermes3:8b`; è possibile specificarne uno diverso con la variabile d'ambiente `OLLAMA_INTERN_MODEL=<modello>`. Impostare la variabile `OLLAMA_HOST` se Ollama non è in esecuzione sull'indirizzo predefinito `localhost:11434`.
+
+## Terminologia
+
+| Termine | Significato |
+|------|---------|
+| `research-os` | Il piano di controllo / la riga di comando / le fasi di controllo / la legge di orchestrazione (questo repository) |
+| `research-pack` | L'artefatto del repository generato per uno specifico progetto di ricerca |
+| `research section` | Un'unità di indagine delimitata all'interno di un pacchetto |
+| `research receipt` | Dimostra che una sezione ha superato i controlli di origine/affermazione/fase di controllo |
+
+## Sicurezza
+
+`research-os` è uno strumento da riga di comando che opera principalmente localmente. Legge e scrive file all'interno della directory del pacchetto di ricerca specificata e, quando si utilizza il comando `gather`, invia richieste HTTP in uscita per recuperare gli URL di origine forniti. Non esegue un server, non accetta connessioni in entrata, non memorizza credenziali e non invia dati di telemetria. Nessun segreto viene scritto negli artefatti del pacchetto. Consultare il file [SECURITY.md](SECURITY.md) per le informazioni sulla segnalazione di vulnerabilità.
+
+## Stato
+
+**v0.1.0** — bloccato il 2026-05-08. Il pacchetto di test interno in `research-os-packs/research-os-spec/` (repository correlato) ha raggiunto la fase di blocco con 296 affermazioni accettate in 8 sezioni, 17 considerate complete, 30 modificate dagli operatori, 0 blocchi di riparazione attivi, 0 contraddizioni irrisolte e tutti i controlli con `synthesis_eligible=true`. 463 test su 463 superati. Sedici regole fondamentali implementate. Consultare il file [`docs/dogfood-proof.md`](docs/dogfood-proof.md) per i sette risultati e le "impronte" delle ricevute della fase di blocco.
+
+### Cosa la versione 0.1 non è
+
+- Non è stata testata da utenti esterni. Il singolo test interno ha rilevato sette bug.
+- Non è ancora disponibile su npm. Installare dal codice sorgente fino a quando non verrà eseguita la pubblicazione su npm.
+- Non è uno strumento per la generazione automatica di codice. Il comando `synth workspace` genera l'ambiente di lavoro strutturato; gli utenti (o Cowork) scrivono il testo in base agli ID delle affermazioni accettate.
+- Non ha una stabilità dell'API conforme alla versione semantica. La versione 1.0.0 è uno stato da raggiungere, non una data specifica; consultare il file [`docs/roadmap.md`](docs/roadmap.md) per i cinque esperimenti che colmano questa lacuna.
+
+### Limitazioni note
+
+- **L'origine dell'estrazione non è visibile nella cucitura del gateway.** Una sezione può superare la soglia accettabile, facendo affidamento su meccanismi di fallback euristici, quando l'estrazione calibrata (Ollama con il modello configurato) non è disponibile. Questo è stato registrato come una vulnerabilità nota; le future implementazioni di sicurezza segnaleranno le richieste accettate dall'estrazione e richiederanno un numero di richieste accettate pari alla soglia, provenienti dal percorso calibrato.
+- **La selezione del modello di revisione, al di là della baseline calibrata `hermes-two-pass`, non è ancora risolta.** Il ciclo di test interno ha validato una configurazione di revisore; altri modelli devono essere sottoposti a una calibrazione specifica per scenari di errore simulati prima di poter essere considerati affidabili.
+- **Il pacchetto di test interno ha utilizzato `mistral-nemo:12b` per l'estrazione (l'impostazione predefinita standard è `hermes3:8b`).** Il sistema ha generato risultati errati per nomi di sezioni che facevano riferimento a domini non corretti; questo è stato corretto tramite una disciplina di precisione delle query (vedere il manuale) e tramite l'utilizzo di URL preconfigurati dagli operatori per argomenti ambigui.
+
+## Roadmap per la versione 1.0
+
+La versione 1.0 è uno stato da raggiungere, non una data di rilascio. Cinque esperimenti sono ancora in corso tra la versione 0.1 e la versione 1.0: stabilità dell'API sotto pressione esterna, un pacchetto di test interno che non faccia riferimento a se stesso, la risoluzione del problema della visibilità dell'origine dell'estrazione, la generalizzazione della calibrazione del revisore al di là di `hermes-two-pass` e un test di base pulito su `hermes3:8b`. Il piano completo è disponibile in [`docs/roadmap.md`](docs/roadmap.md). L'architettura rimane stabile; la versione 1.0 approfondisce ciò che la versione 0.1 ha dimostrato, piuttosto che riaprire vecchie problematiche.
+
+## Licenza
+
+MIT

package/README.ja.md

@@ -0,0 +1,160 @@
+<p align="center">
+  <a href="README.md">English</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/research-os/readme.png" alt="research-os" width="400">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/research-os/releases/tag/v0.1.0"><img src="https://img.shields.io/badge/version-0.1.0-blue" alt="version 0.1.0"></a>
+  <a href="https://github.com/mcp-tool-shop-org/research-os/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/research-os/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A520-brightgreen" alt="Node ≥20">
+  <a href="https://mcp-tool-shop-org.github.io/research-os/handbook/"><img src="https://img.shields.io/badge/handbook-live-purple" alt="Handbook"></a>
+</p>
+
+# research-os
+
+`research-os`は、オープンエンドなテーマを、構造化されたリポジトリである「**research-pack**」へと変換する、ローカルファーストのCLIツールです。このリポジトリでは、Claude、Cowork、または複数のエージェントが、誤った情報を生成したり、調査を単純化したりすることなく、何時間も作業することができます。
+
+## 概要
+
+`research-os`は、「Xについて調査したい」という意図と、検証可能な証拠に基づいた成果物との間の制御システムです。これは、調査のヒントと証拠の収集、生の抽出と検証済みの主張、矛盾の検出と解決、そしてレビューの判断と統合の準備状況を分離します。各ステップは、追記のみ可能なログに記録され、すべての準備完了の判断は、これらのログに基づいて計算され、断定的に主張されるものではありません。
+
+これはレポート生成ツールではありません。また、LLMのオーケストレーションのフレームワークでもありません。あなたの統合作業を自動化するものでもありません。`research-os`は、統合作業を開始するための条件を強制します。
+
+**v0.1は、これまでに一度だけ、自分自身に対して使用されました。** その単一の使用により、`research-os`の7つの問題点が発見され、今回の**リリース**前にすべて修正されました。その検証プロセス（7つのセッション、2つの統合パターン、463個のvitestテストケース、1つの固定されたリポジトリ）は、[`docs/dogfood-proof.md`](docs/dogfood-proof.md)に記録されています。詳細なドキュメントはこちら：<https://mcp-tool-shop-org.github.io/research-os/handbook/>。
+
+## 16の重要な原則
+
+| # | 原則 |
+|---|-----|
+| 1 | ソースの真実が確立される前に、統合作業は行われない。 |
+| 2 | 証拠の収集は事実の取得であり、抽出は解釈である。 |
+| 3 | モデルはソースの範囲を解釈できるが、証拠の範囲を生成することはできない。 |
+| 4 | 抽出は過剰な情報を生み出す可能性があるが、統合作業は必ずしもそのすべてを受け入れるわけではない。 |
+| 5 | 矛盾の検出は、対立を表面化させるだけであり、解決したり、統合したり、どの主張が正しいかを判断したりするものではない。 |
+| 6 | ゲートは、セクションが統合作業の対象となるかどうかを判断する。統合作業を行うわけでも、失敗を隠すわけでもない。 |
+| 7 | レビューは、研究の信頼性を評価する。統合作業を行うわけでも、ソースの真実を書き換えるわけでもない。 |
+| 8 | インデックスを作成することで、研究の真実を検索可能にする。新しい真実を作成するわけでも、公式記録となるわけでもない。 |
+| 9 | Coworkへの引き継ぎは、研究の真実に基づいて運用手順を提供する。真実を作成するわけでも、ゲートを回避するわけでもない。 |
+| 10 | 統合作業のワークスペースは、Coworkのために受け入れられた研究の真実を整理する。統合作業を行うわけでも、引き継ぎプロセスを回避するわけでもない。 |
+| 11 | リポジトリの監査は、既存の研究の真実をまとめる。新しい真実を作成するわけでも、セクションレベルの証拠を隠すわけでもない。 |
+| 12 | 調査は、可能性のあるヒントを提案する。証拠を生み出すのは、収集作業だけである。 |
+| 13 | レビュー担当者は、誤りを検出できるまで信頼されない。 |
+| 14 | 主張の数が多いからといって、それが研究の質が高いとは限らない。主張は、統合作業の対象となる前に、検証される必要がある。 |
+| 15 | 固定（Freeze）は、完了した研究の真実を保護する。未完了の研究を完了させるわけでも、修正状態を証拠として扱うわけでもない。 |
+| 16 | 制限の緩和は、ソースの制約を緩和するだけであり、証拠を捏造することはできない。 |
+
+**原則3**：LLMは、証拠となるテキストを生成しない。`research-os`は、決定論的な抽出ログ（`ex_<source_id_hex>_001`のような安定したID）を構築する。LLMは、抽出IDを選択するだけで、`research-os`が元のテキストをコピーする。したがって、「言い換えを引用として使用する」という誤りは、構造的に不可能な。
+
+**原則14**：抽出とレビューの間に、`research-os claim triage`は、重複を排除し、ソースごとの貢献量を制限し、重要度の低い候補を一時的に保留する。このトリエイジプロセスは、`claims.jsonl`を直接変更するものではなく、保留された主張は、元のログに保持される。
+
+## v0.1のワークフローの概要
+
+```
+discover
+→ gather
+→ claim extract
+→ claim audit-density
+→ claim triage
+→ contradict map
+→ contradict resolve
+→ review
+→ review-promote
+→ gate
+→ section report
+→ audit
+→ index build
+→ cowork handoff
+→ synth workspace
+→ freeze
+```
+
+各ステップはCLIコマンドです。各ステップは、追記のみ可能なファイルに書き込みます。どのステップも、新しい情報を生成したり、解決したり、作成したりすることはありません。これらの制約は、信頼するのではなく、強制されます。レビューでは、候補となる主張に対して、承認/拒否/修正依頼が行われます。そして、そのレビュー結果に基づいて、`synthesis_eligible`（合成可能かどうか）が計算されます。最後に、すべてのレイヤーが合意した場合にのみ、処理が完了とみなされる「freeze」（固定）という最終的な整合性チェックがあります。詳細については、[docs/dogfood-proof.md](docs/dogfood-proof.md) を参照してください。このドキュメントには、このプロセス全体が正常に機能することを示す検証結果が記載されています。
+
+これは、*検索 → 要約 → 報告書作成* という従来のプロセスに対する構造的な代替手段です。このプロセス全体が「チェーン」として機能し、その結果が製品となります。
+
+## インストール
+
+**必要条件:** Node.js ≥ 20
+
+```bash
+# From source (v0.1.0 is not yet published to npm)
+git clone https://github.com/mcp-tool-shop-org/research-os.git
+cd research-os
+npm install
+npm run build
+npm link   # makes `research-os` available on your PATH
+```
+
+## クイックスタート
+
+```bash
+# Create a new research-pack
+research-os init "How should X be structured?"
+
+# Add a section
+research-os section add 01-landscape --purpose "Map the current landscape"
+
+# Discover and approve sources, then gather
+research-os discover run 01-landscape
+research-os discover approve 01-landscape --top 8
+research-os gather 01-landscape --approved
+
+# Run the per-section chain
+research-os claim extract 01-landscape
+research-os claim audit-density 01-landscape
+research-os claim triage 01-landscape
+research-os contradict map 01-landscape --triaged-only
+research-os review 01-landscape --triaged-only --preset hermes-two-pass --profile hermes-two-pass
+research-os review-promote 01-landscape --profile hermes-two-pass
+research-os gate 01-landscape
+research-os section report 01-landscape
+
+# Pack-level finish
+research-os audit
+research-os index build --all
+research-os cowork handoff
+research-os synth workspace   # only if handoff returned synthesis_ready
+research-os freeze
+```
+
+**具体的な使用例**については、`research-os-packs/research-os-spec/` にある「dogfood」と呼ばれるパッケージを参照してください。このパッケージには、すべてのファイル、すべての記録、すべての処理結果、すべての固定状態のフィンガープリントなどが、追記のみ可能なファイルとして保存されています。このパッケージによって、`docs/dogfood-proof.md` が生成されました。
+
+**LLM（大規模言語モデル）の抽出、トリアージ、レビュー、および発見には、ローカルで実行されている [ollama-intern-mcp](https://github.com/mcp-tool-shop-org/ollama-intern-mcp) が必要です。** デフォルトのモデルは `hermes3:8b` です。別のモデルを使用する場合は、`OLLAMA_INTERN_MODEL=<モデル名>` で指定してください。Ollamaがデフォルトの `localhost:11434` 以外の場所で実行されている場合は、`OLLAMA_HOST` 環境変数を設定してください。
+
+## 用語集
+
+| 用語 | 意味 |
+|------|---------|
+| `research-os` | 制御システム / CLI / ゲート / 動作ルール (このリポジトリ) |
+| `research-pack` | 研究プロジェクトの結果として生成されるリポジトリのファイル |
+| `research section` | パッケージ内の調査対象となる範囲 |
+| `research receipt` | 特定のセクションが、ソースコード、主張、およびゲートのチェックを通過したことを示す証拠 |
+
+## セキュリティ
+
+`research-os` は、ローカル環境で動作するCLIです。このツールは、指定された研究パッケージのディレクトリ内のファイルを読み書きし、`gather` コマンドを使用する場合、提供されたソースコードのURLから情報を取得するために、HTTPリクエストを送信します。このツールは、サーバーを起動したり、外部からの接続を受け付けたり、認証情報を保存したり、テレメトリデータを送信したりすることはありません。また、機密情報はパッケージのファイルに書き込まれません。脆弱性に関する報告については、[SECURITY.md](SECURITY.md) を参照してください。
+
+## ステータス
+
+**v0.1.0** — 2026年5月8日に固定されました。`research-os-packs/research-os-spec/` (関連リポジトリ) にある「dogfood」パッケージでは、8つのセクションで296件の主張が承認され、17件が処理され、30件がオペレーターによって修正され、未解決の矛盾は0件、すべてのゲートで `synthesis_eligible=true` となりました。463件中463件のvitestテストが合格しました。16個の重要なルールが実装されています。詳細については、[docs/dogfood-proof.md](docs/dogfood-proof.md) を参照してください。このドキュメントには、7つの発見事項と、固定状態のフィンガープリントが記載されています。
+
+### v0.1の制限事項
+
+- 外部ユーザーによる十分なテストは行われていません。初期のテストで7つのバグが見つかりました。
+- まだnpmには登録されていません。`npm publish` が行われるまでは、ソースコードからインストールしてください。
+- 合成処理を行う機能はありません。`synth workspace` コマンドは、構造化された作業環境を生成しますが、承認された主張IDに基づいて、人間（または Cowork）が文章を作成します。
+- APIの安定性はありません（セマンティックバージョニングに準拠していません）。外部ユーザーによる検証が完了した後、v1.0.0 がリリースされます。
+
+### 既知の制限事項
+
+- **抽出器の信頼性情報が、ゲートの接合部分からは確認できません。** キャリブレーションされた抽出器（設定されたモデルを使用するOllama）が利用できない場合、システムはヒューリスティックに基づく代替的な方法で処理を進める可能性があります。これは既知の弱点として記録されており、今後の改善では、抽出器が提供する信頼性の高い情報と、キャリブレーションされた経路からの信頼性の高い情報の両方が必要になるように変更される予定です。
+- **キャリブレーションされた`hermes-two-pass`を基準とした、レビューモデルの選択に関する問題は未解決です。** 内部テストでは、特定のレビュー設定が検証されましたが、他のモデルについては、信頼できるようになる前に、意図的なエラーを再現するキャリブレーションが必要です。
+- **内部テストで使用されたパッケージは、抽出処理に`mistral-nemo:12b`を使用しました（標準設定は`hermes3:8b`です）。** システムは、自己参照的なセクション名に対して、誤ったドメインからの結果を生成する可能性がありましたが、クエリの精度を向上させるための対策（マニュアルを参照）と、曖昧なトピックに対するオペレーターによる事前準備されたURLを使用することで、この問題を修正しました。
+
+## ライセンス
+
+MIT