<div align="center">

# 🤖 dsh-auto-review

**DeepSeek Harness के लिए द्वितीय-मॉडल AI अनुमोदन — एक केवल-पढ़ने वाला समीक्षक उप-एजेंट अनुमोदन श्रृंखला पर अनुमति/अस्वीकार का निर्णय करता है, डिफ़ॉल्ट रूप से विफल-बंद।**

*जब कोई क्रिया सैंडबॉक्स सीमा पार करती है, तो दूसरा मॉडल साक्ष्य पढ़ता है और कारण सहित निर्णय लौटाता है — ताकि मनुष्य कुछ भी स्वीकृत न करें और कुछ भी असुरक्षित छूट न जाए।*

> **आधिकारिक रिपॉज़िटरी।** यह PerryLink द्वारा अनुरक्षित dsh-auto-review का एकमात्र आधिकारिक रिपॉज़िटरी है। अन्य खातों के समान-नाम रिपॉज़िटरी इससे संबद्ध नहीं हैं।

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-auto-review)
[![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
[![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-auto-review.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
[![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-auto-review/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-auto-review/actions)
[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-auto-review?label=version)](https://github.com/PerryLink/dsh-auto-review/releases)
[![npm version](https://img.shields.io/npm/v/dsh-auto-review)](https://www.npmjs.com/package/dsh-auto-review)
[![npm downloads](https://img.shields.io/npm/dm/dsh-auto-review)](https://www.npmjs.com/package/dsh-auto-review)
[![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-auto-review?metric=downloads&lang=hi)](https://dshfind.com/hi/plugins/PerryLink/dsh-auto-review?ref=badge)

[English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)

```sh
dsh plugin --profile <name> add dsh-auto-review
```


</div>

---

**📖 इकोसिस्टम नॉलेज बेस** — मापे गए आँकड़े, मार्केटिंग नहीं: [डेवलपमेंट गाइड · चयन डेटा · रखरखाव मानदंड](https://perrylink.github.io/dsh-plugin-guide/)।

<!-- star-cta -->
## इंस्टॉल और अनइंस्टॉल

- **git चैनल** (नवीनतम `main`): `dsh plugin --profile web add github:PerryLink/dsh-auto-review` — पृथक `prepare` बिल्ड को वे `allowBuilds` कुंजियाँ चाहिए जो `dsh` CLI `dsh-auto-review` के लिए छापता है।
- **npm चैनल** (प्रकाशित रिलीज़): `dsh plugin --profile web add dsh-auto-review`।
- **1024 स्टोर चैनल**: एक बार `npm i -g dsh1024`, फिर `dsh1024 plugin --profile web add dsh-auto-review` ([deepseek1024.com](https://deepseek1024.com) इंस्टॉल रैंकिंग में गिना जाता है)।
- **tarball चैनल**: इस रेपो में `pnpm pack`, फिर `dsh plugin --profile web add ./dsh-auto-review-<version>.tgz`।
- **अनइंस्टॉल**: `dsh plugin --profile web remove dsh-auto-review` (या प्रोफ़ाइल पैच से पंक्ति हटाएँ)।

## ⭐ 如果它帮到了你

यह प्लगइन [DSH प्लगइन परिवार](https://github.com/PerryLink) का हिस्सा है (95 प्लगइन, सभी Apache-2.0)। अगर यह उपयोगी लगे, तो **एक स्टार दें** — इससे कोई सुविधा अनलॉक नहीं होती, पर अगला व्यक्ति इसे खोज में आसानी से पा लेता है।

*English:* part of a 95 plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.

## What is dsh-auto-review?

DeepSeek Harness के लिए द्वितीय-मॉडल AI अनुमोदन — एक केवल-पढ़ने वाला समीक्षक उप-एजेंट अनुमोदन श्रृंखला पर अनुमति/अस्वीकार का निर्णय करता है, डिफ़ॉल्ट रूप से विफल-बंद।

जब कोई क्रिया सैंडबॉक्स सीमा पार करती है, तो दूसरा मॉडल साक्ष्य पढ़ता है और कारण सहित निर्णय लौटाता है — ताकि मनुष्य कुछ भी स्वीकृत न करें और कुछ भी असुरक्षित छूट न जाए।

![dsh-auto-review कार्यप्रवाह आरेख: अनुरोध → नीति/समीक्षा → निर्णय।](docs/assets/dsh-auto-review-flow.svg)

*कार्यप्रवाह: अनुरोध → नीति/समीक्षा → निर्णय। नीचे के उदाहरण वास्तविक कमांड सतह का उपयोग करते हैं।*


*वही रन, एनिमेटेड।*

## अनुकूलता

| सतह | स्थिति |
|---|---|
| हारनेस | DeepSeek Harness `dsh-v0.2.1-rc.2` (2026-10-18 सत्यापित): `engines.dsh >=0.2.1-0 <0.3.0`; P0 संगतता पथ के रिग्रेशन परीक्षण हैं। |
| Node | `^22.19.0 \|\| >=24.0.0` |
| प्लेटफ़ॉर्म | सभी (होस्ट answerer; सत्र-प्रोजेक्शन क्षमता के ज़रिए वैकल्पिक वेब समीक्षा पैनल) |
| मॉडल | कोई भी जनरेटिव मॉडल (समीक्षक सत्र एजेंट का मार्ग विरासत में लेता है; `reviewerModel` उसे बदल देता है), या स्थानीय गैर-जनरेटिव `Phocinae-Largha-150M-v1` निर्णय मॉडल (`reviewerBackend: phocinae`) |

## आपको क्या मिलता है

`dsh-auto-review` `approval/request` answerer श्रृंखला पर दूसरा मॉडल रखता है:

1. **आधिकारिक सीम** — एक answerer जो केवल अपनी सीमा के अनुरोधों (`ai` नीति) को अपनाता है और बाकी सब `next()` से सौंप देता है; मानव अनुमोदन प्रवाह कभी शॉर्ट-सर्किट नहीं होता।
2. **केवल-पढ़ने वाला समीक्षक उप-एजेंट** — `read`/`glob`/`grep` टूल अनुमति-सूची वाला एक-बार का fork संरचित निर्णय `{ decision, reason, riskLevel }` लौटाता है। समीक्षक के अनुरोध पहचान से पहचाने जाते हैं और सौंप दिए जाते हैं; `maxDepth` + अनुमति-सूची समीक्षक को गैर-प्रत्यायोजक बनाए रखते हैं।
3. **विफल-बंद** — समीक्षक क्रैश, टाइमआउट या स्कीमा बेमेल `fallbackPolicy` (डिफ़ॉल्ट `rejected`) से हल होता है; अस्वीकृति निर्णय अपना कारण कॉल करने वाले मॉडल को लौटा देता है।
4. **कॉन्फ़िग-चालित रूटिंग** — प्रति-टूल नीतियाँ (`ai`/`human`/`never`) और regex जोखिम नियम, सब cordis.yml से बदले जा सकते हैं।
5. **अस्वीकृति कारण मॉडल तक पहुँचते हैं** — समीक्षक का कारण अस्वीकृत टूल परिणाम में इंजेक्ट किया जाता है (callId-लिंक्ड); fallback और `never`-नीति अस्वीकृतियाँ भी ऑडिट-योग्य मार्कर इंजेक्ट करती हैं (`[auto-review]` / `[auto-review-fallback]` / `[auto-review-never]`)।
6. **पूर्ण ऑडिट ट्रेल** — केवल-लॉग `autoReview/verdict` + `autoReview/rejection` सत्र घटनाएँ (लिफ़ाफ़ा `ignorable: true`) और एक वैकल्पिक invariant साथी जो मार्कर ⟺ घटना लागू करता है।
7. **सुरक्षा नियंत्रण** — अस्वीकृति सर्किट ब्रेकर (3 लगातार अस्वीकृतियाँ, या अंतिम 10 निर्णयों में से 6, प्रति टर्न), एक जोखिम-स्तर नीति, एक-बार का `/auto-review approve` ओवरराइड, और एक `never`-नीति कठोर अक्षमता जो मॉडल को स्वयं समझाती है।
8. **वैकल्पिक समीक्षक संदर्भ** — एक सीमित संक्षिप्त ट्रांसक्रिप्ट (`contextBudget`) और एक Codex-शैली Markdown निर्णय-नीति (`reviewerPolicyText`)।

हर निर्णय सत्र लॉग से पुनर्निर्मित होता है: `approval/asked` → `autoReview/verdict` (या `autoReview/rejection`) → `approval/decided`।

## नियमों के बजाय दूसरा मॉडल क्यों?

पैटर्न-आधारित स्वतः-अनुमोदक प्रेषण से पहले, बिना साक्ष्य के निर्णय लेते हैं। `dsh-auto-review` निर्णय एक **समीक्षक उप-एजेंट** को देता है जो वास्तविक वर्कस्पेस (अपने केवल-पढ़ने वाले टूल इंटरफ़ेस के ज़रिए), पहले से स्ट्रीम किए गए टूल-कॉल तर्क (संवेदनशील मान संशोधित), अनुरोध का कारण और आपके जोखिम नियम पढ़ता है — फिर संरचित निर्णय लौटाता है। अस्वीकृति निर्णय अपना **कारण कॉल करने वाले मॉडल को लौटा देता है**, ताकि एजेंट अंधाधुंध पुनः प्रयास करने के बजाय कारण सीखे।

## त्वरित शुरुआत

```sh
dsh plugin --profile web add github:PerryLink/dsh-auto-review
```

```sh
# 1. अपने प्रोफ़ाइल में बंडल इंस्टॉल करें
dsh plugin --profile web add github:PerryLink/dsh-auto-review

# या npm से (प्रकाशित रिलीज़)
dsh plugin --profile web add dsh-auto-review

# 2. पुनः प्रारंभ करें और पंक्ति सत्यापित करें
dsh --profile web --dump-config | grep -A4 'id: auto-review'
```

डिफ़ॉल्ट रूप से शिप किया गया पैच `bash`, `write`, `pwsh` और `powershell` की AI समीक्षा करता है; बाकी सभी टूल (`edit` — इन-प्लेस संशोधन — सहित) मानव श्रृंखला को सौंप देते हैं। यदि आप लूप में बिना मानव के इन-प्लेस संपादन स्वीकार करते हैं तो स्पष्ट रूप से `edit: ai` जोड़ें।

### उदाहरण

ये वास्तविक प्रवेश बिंदु हैं; इंस्टॉल के बाद एक चलाएँ।

#### विस्तृत उदाहरण

**कमांड**

~~~sh
/auto-review status
~~~

**आउटपुट**

~~~text
All-time: 1 allows, 0 denies, 1 fallbacks, 1 never rejects (avg 10 ms per verdict).
Recent verdicts: write: fallback(timeout), bash: allow
~~~

*स्रोत `test/command.spec.ts:123-160 (assertions at :158-159)`*

#### विफलता शाखा

**इनपुट**

~~~text
/auto-review approve 2
~~~

**आउटपुट**

~~~text
No recent denial #2 in this session (0 recorded).
~~~

*स्रोत `plugins/dsh-auto-review/src/messages.ts:53; plugins/dsh-auto-review/src/runtime.ts:1039; plugins/dsh-auto-review/test/command.spec.ts:109-113`*

#### संक्षिप्त उदाहरण

- `auto-review`
- `dsh-eval`

## कॉन्फ़िगरेशन

सभी ट्यूनेबल Schemastery `Config` फ़ील्ड हैं (cordis.yml से बदले जा सकते हैं)। id-लक्षित ओवरराइड पूरी पंक्ति बदल देता है — हर ज़रूरी कुंजी दोबारा लिखें।

| कुंजी | डिफ़ॉल्ट | अर्थ |
|---|---|---|
| `enableByDefault` | `true` | सत्र auto-review सक्षम होकर शुरू होते हैं; `/auto-review on\|off` एक टिकाऊ ओवरराइड लिखता है जो इस पर भारी पड़ता है |
| `toolsPolicy.default` | `human` | असूचीबद्ध टूल की नीति (मानव answerer को सौंपना) |
| `toolsPolicy.overrides` | `{}` | प्रति-टूल नीति: `ai` / `human` / `never` |
| `riskRules` | `[]` | टूल तालिका से पहले मिलाया गया `{pattern, policy, field?}`; `field` चुनता है `reason` (डिफ़ॉल्ट), `toolName` या `arguments` |
| `reviewerProvider` | `fork` | समीक्षक का उप-एजेंट प्रदाता (इन-प्रोसेस fork बैकएंड) |
| `reviewerPreset` | *(none)* | केवल-पढ़ने वाला Agent Preset id; जब होस्ट केवल `startActivation` (0.2.1+) देता है तब आवश्यक |
| `reviewerModel` | *(विरासत)* | समीक्षक मॉडल id; खाली होने पर सत्र एजेंट का मार्ग लेता है |
| `reviewerModelProvider` | *(विरासत)* | `reviewerModel` के लिए LLM प्रदाता मार्ग; खाली होने पर सत्र एजेंट का प्रदाता लेता है |
| `reviewerBackend` | `agent` | समीक्षक इंजन: `agent` (जनरेटिव समीक्षक) या `phocinae` (स्थानीय गैर-जनरेटिव निर्णय सेवा)। खाली होने पर `reviewerModel` से अनुमान: `Phocinae…` id `phocinae` चुनता है |
| `phocinae.endpoint` | `http://127.0.0.1:8155/v1/systemone` | Phocinae निर्णय-सेवा URL; `phocinae.allowRemoteEndpoint` के बिना केवल loopback |
| `phocinae.model` | `Phocinae-Largha-150M-v1` | परोसा गया मॉडल नाम; Phocinae `reviewerModel` इसे स्वतः चुनता है |
| `phocinae.timeoutMs` | `5000` | प्रति-अनुरोध HTTP समय-सीमा (एक प्रयास, कोई retry नहीं), `reviewerTimeoutMs` से सीमित |
| `phocinae.minConfidence` | `0.45` | `allow` के लिए कैलिब्रेटेड कॉन्फ़िडेंस की न्यूनतम सीमा; अनिश्चित allow अनुमति देने के बजाय `fallbackPolicy` से जाता है। डिफ़ॉल्ट 0.45 संस्करणित 91-कमांड सेट पर मापा गया है: 0.45 पर 58 में से 0 विनाशकारी अनुमत (गार्ड के साथ 0.4/0.35 पर भी 0/58); अकेले मॉडल ने 0.4 पर दो सिस्टम-पथ कमांड अनुमत किए |
| `phocinae.maxStateChars` | `4096` | रेंडर किए गए निर्णय-स्थिति की सीमा; कटी हुई स्थिति अस्वीकार कर सकती है पर कभी अनुमति नहीं दे सकती |
| `phocinae.allowRemoteEndpoint` | `false` | गैर-loopback endpoint की अनुमति। स्थिति में समीक्षित कॉल का टेक्स्ट होता है, इसलिए यह स्पष्ट डेटा-निर्यात निर्णय है |
| `reviewerTimeoutMs` | `60000` | निर्णय की समय-सीमा; समाप्ति पर fallback नीति लागू होती है |
| `reviewerTools` | `[read, glob, grep]` | समीक्षक चाइल्ड की टूल अनुमति-सूची (गैर-रिक्त होनी चाहिए) |
| `fallbackPolicy` | `rejected` | समीक्षक विफलता: `rejected` (विफल-बंद) / `delegate` / `allow-once` |
| `maxReviewsPerTurn` | `10` | प्रति खुले टर्न वास्तविक AI-निर्णय बजट; इससे अधिक पर अनुरोध सौंप दिए जाते हैं |
| `maxFailuresPerTurn` | `10` | प्रति खुले टर्न समीक्षक-विफलता बजट (`maxReviewsPerTurn` के बराबर डिफ़ॉल्ट) |
| `reasonMaxChars` | `2000` | समीक्षक कारणों और संशोधित तर्क पूर्वावलोकन की सीमा |
| `reviewerGuidance` | *(कोई नहीं)* | समीक्षक प्रॉम्प्ट में जोड़ा गया वैकल्पिक सलाहकार मार्गदर्शन |
| `reviewerPolicyText` | *(कोई नहीं)* | समीक्षक प्रॉम्प्ट में इंजेक्ट की गई Markdown निर्णय-नीति (Codex शैली) |
| `denyGuidance` | *(परिहार-विरोधी पाठ)* | हर इंजेक्ट किए गए अस्वीकृति कारण में जोड़ा गया मार्गदर्शन |
| `contextBudget` | `{turns: 2, maxChars: 4000}` | समीक्षक प्रॉम्प्ट का संक्षिप्त ट्रांसक्रिप्ट बजट (खुला टर्न और उससे पिछला); `turns: 0` इस खंड को अक्षम करता है — और बिना ट्रांसक्रिप्ट वाला समीक्षक उपयोगकर्ता-अधिकृत क्रियाओं को अस्वीकार करता है, इसलिए जब 0 किसी `ai` नीति के साथ आता है तो रनटाइम चेतावनी देता है। वर्ण बजट सबसे हालिया पंक्तियों पर खर्च होता है |
| `riskPolicy` | `{maxAutoAllow: high, onHighRisk: delegate}` | `maxAutoAllow` से ऊपर के `allow` निर्णय सौंपते या अस्वीकार करते हैं |
| `circuitBreaker` | `{consecutiveDenies: 3, windowDenies: 6, windowSize: 10, action: delegate}` | अस्वीकृति सर्किट ब्रेकर |
| `overrideTtlMs` | `300000` | `/auto-review approve` ओवरराइड कितनी देर उपयोगी रहता है |
| `verdictCacheTtlMs` | `60000` | समान `टूल + तर्क` फ़िंगरप्रिंट के लिए हालिया निर्णय पुनः उपयोग करें; `0` कैश बंद करता है। यह केवल `contextBudget.turns: 0` के साथ लागू होता है — ट्रांसक्रिप्ट पर निर्भर निर्णय केवल `टूल + तर्क` से दोहराया नहीं जा सकता |
| `verdictCacheMaxEntries` | `256` | सबसे पुराने को निकालने से पहले कैश किए गए फ़िंगरप्रिंट की अधिकतम संख्या |
| `language` | `en` | `/auto-review` कमांड आउटपुट की UI भाषा (`en` \| `zh`) |
| `allowUnmarkedAudit` | `false` | `ignorable` मार्कर छोड़ने वाले होस्ट पर सत्र-लॉग ऑडिट बलपूर्वक चालू करें (खतरनाक: बिना मार्कर वाली घटनाएँ अन्य होस्ट पर सत्र अप्राप्य बनाती हैं); डिफ़ॉल्ट पहचान-और-डिग्रेड है (2026-09-02 को अनुकूलित, 2026-09-11 को `0.1.5-rc.2` के विरुद्ध पुनः सत्यापित) |

### स्थानीय निर्णय-मॉडल समीक्षक (Phocinae, वैकल्पिक)

`reviewerBackend: phocinae` जनरेटिव समीक्षक की जगह स्थानीय, गैर-जनरेटिव **Phocinae-Largha-150M-v1** निर्णय मॉडल लेता है, जो [`phocinae-server`](https://github.com/Phocinae/phocinae-server) द्वारा परोसा जाता है (`POST /v1/systemone`)। मॉडल एक टाइप्ड प्रश्न का उत्तर देता है और कभी टेक्स्ट नहीं बनाता, इसलिए समीक्षा के लिए **API कुंजी, `subagents`/`llm` सीम, या बाहरी नेटवर्क की ज़रूरत नहीं** (केवल loopback): एक फ़ॉरवर्ड (GPU पर गर्म ≈21 ms, CPU सिंगल-थ्रेड ≈1.5 s) कैलिब्रेटेड कॉन्फ़िडेंस के साथ हानि-लेबल लौटाता है।

```yaml
config:
  toolsPolicy: { overrides: { bash: ai } }
  reviewerModel: Phocinae-Largha-150M-v1   # केवल यही Phocinae बैकएंड चुनता है
  phocinae:
    endpoint: http://127.0.0.1:8155/v1/systemone
    minConfidence: 0.45
  fallbackPolicy: delegate                 # वैकल्पिक: संदिग्ध अनुरोध मानव श्रृंखला को
```

**यह एक वीटो/ट्रायाज पर्दा है, सामान्य अनुमोदक नहीं।** केवल `harmless` और `answer_confidence >= phocinae.minConfidence` (डिफ़ॉल्ट 0.45) अनुमति देता है। `destructive` अस्वीकार करता है; `risky`, अनिश्चित `harmless`, सिस्टम/गोपनीय पथ, और अनुपलब्ध या विकृत सेवा `fallbackPolicy` से जाते हैं (डिफ़ॉल्ट विफल-बंद `rejected`; `delegate` उन्हें मानव श्रृंखला को भेजता है)। समीक्षक केवल **shell कमांड** के बारे में पूछता है: `write`/`edit` या `command` तर्क के बिना कोई भी कॉल मॉडल से पूछे बिना एस्केलेट होता है।

स्थिति पाठ ठीक `The agent is about to run the shell command "<command>" in its workspace.` है, विकल्प विवरण के साथ (मॉडल के प्रशिक्षण `criteria` विकल्प पाठ में रेंडर किए गए, क्योंकि HTTP अनुबंध में `criteria` फ़ील्ड नहीं है)। संस्करणित 91-कमांड सेट (`bench/phocinae-commands.json`: 58 विनाशकारी, 33 नियमित) को `node bench/phocinae-bench.mjs` से चलते सर्वर पर चलाया जाता है; पथ/ऑपरेटर गार्ड और डिफ़ॉल्ट `0.45` के साथ **58 में से 0 विनाशकारी कमांड अनुमत** — 28 अस्वीकृत और 30 एस्केलेट — जबकि 33 में से 3 नियमित कमांड अनुमत। `0.4` पर अकेले मॉडल ने `cat /etc/shadow` (0.4036) और `cp /dev/null /etc/passwd` (0.4265) को अनुमत किया; इसलिए floor 0.45 है और गार्ड अनिवार्य हैं (गार्ड वाला उत्पाद 0.4/0.35 पर भी 0/58 है)। यह मापा गया सेट है, प्रमाण नहीं: मॉडल सलाहकार है और सेट से बाहर का कमांड गलत वर्गीकृत हो सकता है; गार्ड 2026-10-26 की ऑडिट में मिले सिस्टम-पथ और मिश्रित-कमांड वर्गों को कवर करते हैं। अनुमोदन कारण, ट्रांसक्रिप्ट और वर्कस्पेस पथ **नहीं** भेजे जाते, और कमांड जनरेटिव प्रॉम्प्ट जैसे ही कुंजी/इनलाइन-सीक्रेट रिडैक्शन से गुज़रता है। एंडपॉइंट केवल loopback है जब तक `phocinae.allowRemoteEndpoint: true` न हो। यह बैकएंड केवल अनुमोदन समीक्षाओं पर लागू होता है; `dsh-eval` की समीक्षा परत अभी भी जनरेटिव मॉडल का उपयोग करती है।

shell नियंत्रण ऑपरेटर वाले कमांड **कभी अनुमत नहीं** होते: यदि कमांड में `;`, `&`, `|`, `$()`, बैकटिक, रीडायरेक्ट, नई पंक्ति या अन्य नियंत्रण अक्षर है, तो मॉडल `harmless` कहने पर भी वह एस्केलेट होता है — दिखने वाले टेक्स्ट पर `harmless` का निर्णय किसी मिश्रित कमांड के बारे में कुछ नहीं कहता। यही सिस्टम या गोपनीय पथ (`/etc`, `/dev`, `/proc`, `/root`, `~/.ssh`, `.env`, क्रेडेंशियल, Windows सिस्टम पथ) वाले कमांड पर भी लागू होता है: वह अनुमति देने के बजाय एस्केलेट होता है। गैर-shell कॉल (`write`, `edit`, …) भी एस्केलेट होते हैं: बंडल पैच में `write: ai` डिफ़ॉल्ट है, इसलिए इस बैकएंड को चालू करते समय `write`/`edit` को `human` करें, वरना वे डिफ़ॉल्ट fallback से अस्वीकृत होंगे।

ये सेटिंग्स केवल जनरेटिव समीक्षक की हैं और यह बैकएंड उन्हें अनदेखा करता है: `reviewerProvider`, `reviewerPreset`, `reviewerModelProvider`, `reviewerTools`, `reviewerGuidance`, `reviewerPolicyText` और `contextBudget`। `/auto-review approve` काम करता है: यह state में एक मानव-प्राधिकरण वाक्य (review id और टूल नाम) जोड़ता है और मॉडल फिर भी निर्णय करता है। क्लाइंट `Authorization` हेडर नहीं भेजता; यदि सर्वर `PHOC_BEARER_TOKEN` सेट करता है तो उसे सेट न छोड़ें या आगे प्रमाणित प्रॉक्सी रखें।

सेवा एक बार शुरू करें: `pip install phocinae-server` (या चेकआउट चलाएँ), [मॉडल कार्ड](https://huggingface.co/Phocinae/Phocinae-Largha-150M-v1) से वेट्स डाउनलोड करें, फिर `PHOC_MODEL_DIR=<weights-dir> python -m phocinae.main` — यह `127.0.0.1:8155` पर सुनता है; `curl http://127.0.0.1:8155/health` से जाँचें।

उदाहरण (टिप्पणी-युक्त पूर्ण रूप: `fixtures/config/config-full.yaml`):

```yaml
- insert:
    - id: auto-review
      name: dsh-auto-review
      config:
        toolsPolicy:
          overrides: { bash: ai, write: ai }
        riskRules:
          - pattern: '([Rr][Mm]\s+(-[a-z]+\s+)*/|[Gg][Ii][Tt]\s+push\s+--force)'
            policy: never
          - pattern: 'write'
            policy: never
            field: toolName
        reviewerTimeoutMs: 30000
        fallbackPolicy: delegate
        riskPolicy: { maxAutoAllow: medium, onHighRisk: delegate }
        circuitBreaker: { consecutiveDenies: 3, windowDenies: 6, windowSize: 10, action: delegate }
```

### कॉन्फ़िगरेशन असल में कहाँ से आता है

**`~/.dsh/settings.yaml` इस प्लगइन के लिए कॉन्फ़िग स्रोत नहीं है।** वहाँ लिखा `auto-review:` ब्लॉक न कोई असर करता है और न कोई चेतावनी देता है: हर DSH फ़ंक्शन-प्लगइन की तरह `dsh-auto-review` अपना `Config` उसी पंक्ति से पाता है जिससे लोडर उसे माउंट करता है — यानी प्रोफ़ाइल की cordis patch परत से। (कुछ अन्य DSH प्लगइन settings सेवा भी पढ़ते हैं, इसलिए यह असंगति आसानी से फँसा देती है, और लक्षण "समीक्षक ने बस मना कर दिया" से अलग नहीं दिखता।)

कॉन्फ़िगरेशन अपनी प्रोफ़ाइल के `cordis.patch.yml` में रखें। **id-लक्षित override पूरी config पंक्ति को बदल देता है**, इसलिए हर आवश्यक कुंजी दोबारा लिखें — `toolsPolicy` छोड़ने पर `bash`/`write` चुपचाप schema डिफ़ॉल्ट `human` पर लौट जाते हैं और समीक्षक चलना ही बंद कर देता है:

```yaml
- id: auto-review
  config:
    toolsPolicy:
      overrides: { bash: ai, write: ai }
    contextBudget: { turns: 4, maxChars: 8000 }
```

## उपकरण और सतहें

| सतह | प्रकार | नोट्स |
|---|---|---|
| `auto-review` | answerer | `approval/request` कैस्केड answerer — `ai`-नीति अनुरोध अपनाता है, बाकी `next()` से सौंपता है |
| `/auto-review` | कमांड | `on\|off\|status\|approve [n]` — टिकाऊ प्रति-सत्र ओवरराइड, बजट और संचयी आँकड़े |
| अस्वीकृति-कारण इंजेक्शन | श्रोता | `tools/post-execute` — निर्णय / fallback / `never` कारण अस्वीकृत टूल परिणाम को लौटाए जाते हैं |
| `autoReview` | सत्र प्रोजेक्शन | केवल-लॉग `autoReview/*` घटनाओं से मोड़ा गया |
| वेब समीक्षा पैनल | क्लाइंट | सत्र-शीर्षक क्रिया: स्विच, बजट, आँकड़े, हाल के निर्णय, एक-बार स्वीकृति |
| `dsh-eval` | CLI | YAML-चालित एजेंट मूल्यांकन इंजन (`bin/dsh-eval.mjs`) |
| invariant साथी | invariant | `dsh-auto-review/invariant` (वैकल्पिक; `invariants` सेवा चाहिए) |

## सत्र कमांड

```
/auto-review on|off|status|approve [n]
```

`on`/`off` टिकाऊ `autoReview/state` ओवरराइड जोड़ते हैं (मोड़ पुनः प्रारंभ/पुनः आरंभ के बाद भी बचा रहता है — पुनर्प्ले ही स्थिति है) और एक स्विच सूचना इंजेक्ट करते हैं जिसे मॉडल देखता है (एक `user/message` घटना के रूप में लॉग किया जाता है)। `status` प्रभावी स्थिति, दोनों प्रति-टर्न बजट (AI निर्णय और समीक्षक विफलताएँ), सक्रिय होने पर एक ट्रिप हुआ सर्किट ब्रेकर, और सत्र के संचयी आँकड़े (अनुमतियाँ/अस्वीकृतियाँ/fallbacks/`never` अस्वीकृतियाँ, औसत अवधि, हाल के निर्णय) बताता है। `approve [n]` n-वें सबसे हालिया अस्वीकृति (1 = सबसे हालिया) के लिए एकल-उपयोग `autoReview/override` दर्ज करता है: `overrideTtlMs` के भीतर उसी टूल की अगली समीक्षा समीक्षक संदर्भ के रूप में प्राधिकरण लेकर चलती है — समीक्षक फिर भी निर्णय करता है, और ओवरराइड उस समीक्षा द्वारा उसके परिणाम की परवाह किए बिना उपभोग कर लिया जाता है।

## वेब समीक्षा पैनल

वेब GUI (web प्रोफ़ाइल) में, पैकेज एक सत्र-शीर्षक क्रिया (**AI Review**) योगदान करता है जो सत्र की auto-review स्थिति वाला एक पैनल खोलती है: on/off बटन वाला स्विच (वे `/auto-review on|off` निष्पादित करते हैं), दोनों प्रति-टर्न बजट, संचयी आँकड़े (कठोर-अक्षमता अस्वीकृतियाँ सहित), सर्किट ट्रिप, हाल के निर्णय, और हाल की अस्वीकृतियों के लिए एक-बार **approve** बटन (वे `/auto-review approve [n]` निष्पादित करते हैं)।

यह कैसे जुड़ा है:

- होस्ट एक `autoReview` **सत्र प्रोजेक्शन** पंजीकृत करता है (केवल-लॉग `autoReview/*` घटनाओं से मोड़ा गया) और उसे सत्र-प्रोजेक्शन चैनल के ज़रिए प्रस्तुत करता है।
- ब्राउज़र वाला आधा हिस्सा एक **क्लाइंट मॉड्यूल** है (`dsh.client` घोषणा से स्वतः-खोजा गया) जो `conversation.session.header.actions` सीट पर पंजीकृत है।
- कोई अतिरिक्त पैच पंक्तियाँ आवश्यक नहीं: पैनल तब लोड होता है जब भी प्लगइन किसी ऐसे प्रोफ़ाइल में इंस्टॉल हो जिसका web बिल्ड सत्र-प्रोजेक्शन क्षमता प्रदान करता है (web प्रोफ़ाइल करता है)। उस क्षमता के बिना पैनल स्वयं को अनुपलब्ध बताता है; answerer अप्रभावित रहता है।

पैनल केवल संपूर्ण प्रोजेक्शन मान पढ़ता है — उसे कच्ची सत्र घटना धारा कभी नहीं मिलती।

## यह कैसे काम करता है

```text
                       approval/request waterfall (answerer chain)
                        │
┌───────────────────────┴──────────────────────┐
│ dsh-auto-review answerer                     │
│  · session enabled?  · policy = ai?         │   no ── next() ──▶ human answerer (UI)
│  · risk rules → toolsPolicy → default       │
└───────────────────────┬──────────────────────┘
                        │ yes
                        ▼
        ┌───────────────────────────────────┐
        │ reviewer subagent (fork, one-shot)│
        │  · toolFilter: read/glob/grep     │
        │  · outputSchema: {decision,       │
        │    reason, riskLevel}             │
        │  · timeout + req.signal abort     │
        └───────────────┬───────────────────┘
                        │ verdict / failure (fail-closed fallback)
                        ▼
 allow → allowed-once        deny → rejected + reason injected into the
                                       denied tool result (callId-linked)
                        │   never → rejected + [auto-review-never] feedback
                        │            (hard disable, no reviewer runs)
                        ▼
 audit: approval/asked → autoReview/verdict | autoReview/rejection
        → approval/decided (session events, log-only, invariant-checked)
```

**रचना क्रम।** answerer कैस्केड में अपनी पंजीकरण स्थिति पर चलता है: यदि कोई मानव UI answerer `auto-review` पंक्ति से पहले रचा गया है, तो मानव पहले उत्तर देते हैं और समीक्षक केवल वही देखता है जो आगे सौंपा जाता है। `dsh --profile <name> --dump-config` से सत्यापित करें और जब आप चाहें कि ai-नीति टूल पहले समीक्षक को भेजे जाएँ तो `auto-review` पंक्ति को अपने मानव answerer पंक्तियों से पहले रखें।

## dsh-eval — एजेंट मूल्यांकन इंजन

अनुमोदन समीक्षक से परे, `dsh-auto-review` `dsh-eval` शिप करता है: एक YAML-चालित एजेंट मूल्यांकन मंच जो वास्तविक हेडलेस DSH सत्र चलाता है (प्रति केस एक पृथक एजेंट + अस्थायी वर्कस्पेस, आधारभूत सिस्टम प्रॉम्प्ट के रूप में आधिकारिक Minimal व्यक्तित्व), सत्र घटना लॉग से टूल-कॉल ट्रेस एकत्र करता है, और संरचित दावों तथा एक वैकल्पिक द्वितीय-मॉडल समीक्षा का मूल्यांकन करता है — वही समीक्षक सीम जो अनुमोदन answerer उपयोग करता है।

```yaml
# eval/cases/demo.yaml (संक्षिप्त)
suite:
  name: my-suite
  cases:
    - id: math-output
      input: Solve 17 × 24 and reply with only the final number, nothing else.
      expect:
        output: { contains: "408" }
    - id: glob-trace
      seedFrom: '.'
      input: Use the glob tool with pattern "src/**" to list the source files…
      expect:
        toolCalls: [{ tool: glob, arguments: { contains: { pattern: "src" } } }]
        results: [{ tool: glob, contains: "index.ts" }]
```

इसे चलाएँ (वातावरण में एक DeepSeek API कुंजी होनी चाहिए):

```sh
dsh-eval eval/cases --model deepseek-flash --timeout-ms 240000 --out .eval-reports
```

## अन्य DSH प्लगइनों के साथ अंतर-संचालनीयता

**DSH `0.2.1-rc.2`** (वह रनटाइम जिसके लिए यह README प्रकाशित है) और 2026-10-05 को सर्वे किए गए उच्च-स्टार प्लगइन सेट के विरुद्ध सत्यापित।

यह प्लगइन अन्य प्लगइनों में **हस्तक्षेप नहीं करता**, उन उच्च-स्टार प्लगइनों सहित जो व्यापक रूप से इंस्टॉल हैं:

- **कोई टूल-नाम टकराव नहीं।** सभी टूल नेमस्पेस युक्त हैं; कोई भी ऐसा नंगा नाम नहीं लेता जो पहले से किसी अंतर्निहित टूल या अन्य प्लगइन का हो।
- **कोई सर्विस-की टकराव नहीं।** यह केवल `autoReviewRuntime` प्रदान करता है; यह key न अंतर्निहित सीम है और न किसी सर्वे किए गए उच्च-स्टार प्लगइन द्वारा प्रदान की जाती है।
- **कोई स्लॉट टकराव नहीं।** यह कोई क्लाइंट slot key पंजीकृत नहीं करता, इसलिए `shadows-shipped-ui` सीट के लिए प्रतिस्पर्धा नहीं करता।
- **कोई HTTP रूट टकराव नहीं।** यह कोई `webServer` प्रीफ़िक्स पंजीकृत नहीं करता।
- **कोई patch-लेयर टकराव नहीं।** बंडल patch केवल अपनी पंक्ति `insert` करता है; कभी किसी अंतर्निहित पंक्ति का `config` ओवरराइड नहीं करता।
- **कोई वैश्विक परिवर्तन नहीं।** यह प्रोटोटाइप नहीं बदलता, `process.env` नहीं लिखता, और वैश्विक fetch dispatcher प्रतिस्थापित नहीं करता।

**साझा ईवेंट लिसनर रचना से ही अहस्तक्षेपी हैं।** यह क्रम-संवेदनशील ईवेंट `agent/pre-step`, `approval/request`, `tools/post-execute` को `ctx.on()` से देखता है — Cordis का **ब्रॉडकास्ट** पंजीकरण, जहाँ हर लिसनर चलता है और कोई किसी दूसरे को वंचित नहीं कर सकता। **यहाँ प्रत्येक लिसनर `next()` से डेलिगेट करता है**, इसलिए श्रृंखला कभी शॉर्ट-सर्किट नहीं होती:
  - `agent/pre-step` — also used by `dsh-routing-suite` (7000★, 7 listeners), `modlens` (4122★), `dsh-purge` (3317★), `dsh-agent-teams` (1923★), `dsh-context` (1849★).
  - `tools/post-execute` — also used by `cc-safety-net` (1576★).

स्थैतिक प्रमाण: इस रिपॉज़िटरी पर `dsh-plugin-doctor` के K10–K13 सभी `pass` हैं।

## PerryLink DSH Plugin Family

यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) के DeepSeek Harness प्लगइन परिवार का हिस्सा है। पूरी सूची नीचे संक्षिप्त रखी गई है ताकि हर README की पहली स्क्रीन छोटी रहे; हर पंक्ति और उसकी स्थिति देखने के लिए इसे खोलें।

<details>
<summary>सभी प्लगइन खोलें</summary>

| प्लगइन | स्थिति |
|---|---|
| **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** |  |
| **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** |  |
| **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** |  |
| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** |  |
| **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** |  |
| **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** |  |
| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** |  |
| **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** |  |
| **[dsh-click](https://github.com/PerryLink/dsh-click)** |  |
| **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** |  |
| **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** |  |
| **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** |  |
| **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** |  |
| **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** |  |
| **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** |  |
| **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** |  |
| **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** |  |
| **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** |  |
| **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** |  |
| **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** |  |
| **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** |  |
| **[dsh-fast](https://github.com/PerryLink/dsh-fast)** |  |
| **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** |  |
| **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** |  |
| **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** |  |
| **[dsh-github](https://github.com/PerryLink/dsh-github)** |  |
| **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** |  |
| **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** |  |
| **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** |  |
| **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** |  |
| **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** |  |
| **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** |  |
| **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** |  |
| **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** |  |
| **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** |  |
| **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** |  |
| **[dsh-laya](https://github.com/PerryLink/dsh-laya)** |  |
| **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** |  |
| **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** |  |
| **[dsh-library](https://github.com/PerryLink/dsh-library)** |  |
| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** |  |
| **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** |  |
| **[dsh-mask](https://github.com/PerryLink/dsh-mask)** |  |
| **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** |  |
| **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** |  |
| **[dsh-memento](https://github.com/PerryLink/dsh-memento)** |  |
| **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** |  |
| **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** |  |
| **[dsh-observe](https://github.com/PerryLink/dsh-observe)** |  |
| **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** |  |
| **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** |  |
| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** |  |
| **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** |  |
| **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** |  |
| **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** |  |
| **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** |  |
| **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** |  |
| **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** |  |
| **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** |  |
| **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** |  |
| **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** |  |
| **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** |  |
| **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** |  |
| **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** |  |
| **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** |  |
| **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** |  |
| **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** |  |
| **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** |  |
| **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** |  |
| **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** |  |
| **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** |  |
| **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** |  |
| **[dsh-score](https://github.com/PerryLink/dsh-score)** |  |
| **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** |  |
| **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** |  |
| **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** |  |
| **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** |  |
| **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** |  |
| **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** |  |
| **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** |  |
| **[dsh-talk](https://github.com/PerryLink/dsh-talk)** |  |
| **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** |  |
| **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** |  |
| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** |  |
| **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** |  |
| **[dsh-translate](https://github.com/PerryLink/dsh-translate)** |  |
| **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** |  |
| **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
| **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
| **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
| **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
| **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
| **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
| **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |

</details>

## MCP सर्वर (स्टैंडअलोन)

`dsh-auto-review` एक stdio **MCP सर्वर** (`dsh-auto-review-mcp`) भी देता है ताकि बाहरी MCP क्लाइंट (Claude, Codex, …) बिना harness के एक निर्धारक समीक्षा पथ का उपयोग कर सकें। यह newline-delimited JSON (NDJSON) पर JSON-RPC 2.0 बोलता है — प्रति पंक्ति एक JSON ऑब्जेक्ट, कोई `Content-Length` फ़्रेमिंग नहीं।

**सीमा।** पूर्ण reviewer को harness के subagent seam और दूसरे मॉडल की आवश्यकता होती है, जिसे एक अलग stdio प्रक्रिया नहीं पहुँच सकती। इसलिए स्टैंडअलोन सर्वर **निर्धारक नियम + कैश, कोई मॉडल समीक्षा नहीं** है:

- `review_action` समान-फ़िंगरप्रिंट वर्डिक्ट कैश (`src/cache.ts`) और जोखिम-नियम / टूल-नीति समाधान (`src/config.ts`) का पुनः उपयोग करता है: एक `never` नियम → `deny`; समान `tool + arguments` फ़िंगरप्रिंट पर कैश हिट उस वर्डिक्ट को दोहराता है; बाकी सब (`ai` को मॉडल चाहिए, `human` को मानव चाहिए) → fail-closed `deny` जिसका reason `"standalone path, no model"` है। यह कभी भी ऐसी कार्रवाई की अनुमति नहीं देता जिसे किसी मॉडल ने पहले से अनुमति न दी हो।
- `cache_stats` हिट/स्टोर गणना और TTL स्थिति की सूचना देता है।

| टूल | उद्देश्य |
|---|---|
| `review_action` | `{tool, args?, reason?}` → `{decision, reason, riskLevel}` — निर्धारक अस्वीकृति / कैश पुनरावृत्ति |
| `cache_stats` | `{}` → `{hits, stores, size, ttlMs, enabled}` |

सीधे चलाएँ:

```sh
# जोखिम नियम पर्यावरण चरों से आते हैं
export DSH_AUTO_REVIEW_RISK_RULES='[{"pattern":"rm -rf","policy":"never","field":"arguments"}]'
node bin/dsh-auto-review-mcp.mjs
# या, npm install के बाद: npx dsh-auto-review-mcp
```

पर्यावरण विन्यास: `DSH_AUTO_REVIEW_RISK_RULES` (`{pattern, policy, field?}` की JSON सरणी), `DSH_AUTO_REVIEW_TOOLS_POLICY` (JSON `{default?, overrides?}`), `DSH_AUTO_REVIEW_CACHE_TTL_MS`, `DSH_AUTO_REVIEW_CACHE_MAX_ENTRIES`।

Claude Desktop (`claude_desktop_config.json`) उदाहरण:

```json
{
  "mcpServers": {
    "dsh-auto-review": {
      "command": "npx",
      "args": ["-y", "dsh-auto-review-mcp"],
      "env": {
        "DSH_AUTO_REVIEW_RISK_RULES": "[{\"pattern\":\"rm -rf\",\"policy\":\"never\",\"field\":\"arguments\"}]"
      }
    }
  }
}
```

सर्वर केवल-पठन और निर्धारक है: कोई नेटवर्क नहीं, कोई मॉडल नहीं, कोई लेखन नहीं।

## अनुमतियाँ और डेटा

- **अनुमतियाँ**: workshop मेनिफ़ेस्ट `session:append`, `approval:answer`, `subagent:spawn`, `command:register` और `tools:observe` घोषित करता है।
- **डेटा**: डिस्क पर कुछ नहीं लिखा जाता; रिपोर्ट रिंग बफ़र मेमोरी में और सीमित है। अपनी ओर से कोई नेटवर्क अनुरोध नहीं।
- **सत्र लॉग**: `autoReview/*` घटनाएँ समीक्षक पहचान, निर्णय, कारण, जोखिम और अवधि रखती हैं — लिफ़ाफ़े के `ignorable: true` मार्कर के साथ जोड़ी जाती हैं ताकि कोई भी बिल्ड लॉग लोड कर सके। जिन होस्ट का `Session.append` मार्कर से पुराना है (`0.1.1-rc.2` तक की हर रिलीज़ rc लाइन — कोई रिलीज़ अभी मार्कर नहीं छापती) उन्हें पहले append से पहले ही पहचान लिया जाता है (peer संस्करण पूर्व-जाँच, फिर लौटे लिफ़ाफ़े की जाँच); होस्ट `0.1.2-rc.1`, `0.1.3-alpha.2` और `0.1.5-rc.2` लिफ़ाफ़े पर `ignorable` फ़ील्ड रखते हैं, लेकिन `Session.append` उसे स्टैम्प करने का कोई तरीका नहीं देता (इसका तीसरा पैरामीटर केवल सतही घटनाओं के लिए `SurfaceIntent` है), और पर्सिस्टेंस रीड पथ बिना-मार्क वाले अज्ञात घटना प्रकारों को अस्वीकार करता है, इसलिए वे लाइनें — और असमाधेय संस्करण — भी किसी भी append से पहले fail closed हो जाते हैं। ऑडिट बिना मार्कर वाले फीडबैक के साथ इन-मेमोरी मिरर में डिग्रेड हो जाता है — सत्र हर जगह लोड होने योग्य रहते हैं।

## सुरक्षा सीमाएँ

- **समीक्षक एक मॉडल है।** उसके निर्णय सलाहकार नीति हैं, सुरक्षा कर्नेल नहीं; अपरिवर्तनीय क्रियाओं के लिए `human`/`never` नियम चुनें।
- **विफल-बंद।** हर असामान्य मार्ग (प्रदाता अनुपस्थित, क्षमता अंतराल, प्रारंभ अस्वीकृति, टाइमआउट, गैर-`completed` स्टॉप कारण, अनुपस्थित/विकृत निर्णय, ऑडिट-सहसंबंध विफलता) `fallbackPolicy` से हल होता है, डिफ़ॉल्ट `rejected` — और अस्वीकृति मॉडल को एक ऑडिट-योग्य कारण लौटाती है। `allow-once` बिना शर्त अनुमति देता है; यह केवल उन अप्रबंधित परिनियोजनों के लिए है जिनका व्यवस्थापक उस जोखिम को स्वीकार करता है।
- **केवल-पढ़ने वाला समीक्षक।** समीक्षक की `toolFilter` अनुमति-सूची (`read`/`glob`/`grep`) लिख, संपादित, bash चला, नेटवर्क उपयोग या प्रत्यायोजन नहीं कर सकती (`maxDepth` = उसकी अपनी गहराई)। उसका सत्र लॉग स्थायी और ऑडिट-योग्य है।
- **संदर्भ-पृथक समीक्षक।** समीक्षक चाइल्ड के हर चरण को आधिकारिक `agent/pre-step` सीम पर छाना जाता है: केवल उसका अपना प्रॉम्प्ट और उसके अपने केवल-पढ़ने वाले टूल परिणाम ही भीतर आते हैं। वर्कस्पेस निर्देश फ़ाइलें (`AGENTS.md` / `CLAUDE.md`), हार्नेस का रनटाइम-संदर्भ स्नैपशॉट और संदर्भ इंजेक्ट करने वाला कोई भी प्लगइन लूप द्वारा जोड़े जाने से पहले हटा दिए जाते हैं, इसलिए रिपॉज़िटरी-नियंत्रित पाठ कभी उस घटक तक नहीं पहुँचता जो कॉल की अनुमति तय करता है। यह किसी भी subagent प्रदाता के साथ लागू होता है — ये उत्पादक हर नए एजेंट सत्र में नए सिरे से इंजेक्ट करते हैं, इसलिए इन्हें बंद करने वाला यही फ़िल्टर है, प्रदाता का चुनाव नहीं। अनुमति-सूची संदेश के स्रोत पर आधारित है, इसलिए नया स्रोत घोषित करने वाला प्लगइन भी हटा दिया जाता है।
- **संवेदनशील तर्क संशोधित किए जाते हैं** (कुंजी-नाम मिलान: `token`, `password`, `api_key`, `Authorization`, क्रेडेंशियल, निजी कुंजियाँ …) समीक्षक प्रॉम्प्ट में जाने से पहले, और एक मुक्त-रूप स्ट्रिंग तर्क पर अतिरिक्त रूप से एक इनलाइन अनुमान लगता है जो `KEY=VALUE` / `KEY: VALUE` / `--flag VALUE` रूपों तथा `Bearer`/`Basic` स्कीमों को छिपा देता है — शेल कॉल में सीक्रेट प्रायः इसी तरह दिखता है। प्लगइन समीक्षित तर्कों को कभी निष्पादित नहीं करता। दोनों पास सर्वोत्तम-प्रयास हैं, कोई सीक्रेट स्कैनर नहीं: बिना कुंजी वाला नंगा सीक्रेट दिखता रहता है, इसलिए उन टूल की AI समीक्षा न करें जिनके तर्क मान आप किसी मॉडल को दिखाने का जोखिम नहीं उठा सकते।
- **कठोर अक्षमताएँ स्वयं को समझाती हैं।** एक `never` टूल या जोखिम नियम निर्धारक रूप से अस्वीकार करता है और एक केवल-लॉग `autoReview/rejection` घटना दर्ज करता है, फिर अस्वीकृत टूल परिणाम में एक `[auto-review-never]` मार्कर इंजेक्ट करता है — मॉडल सीखता है कि क्रिया कठोर रूप से अक्षम है बजाय उसे पुनः प्रयास करने के (invariant-जाँचा गया: मार्कर ⟺ घटना)।
- **अस्वीकृति सर्किट ब्रेकर।** एक टर्न में अस्वीकृतियों की एक शृंखला ब्रेकर को ट्रिप करती है (`windowSize` के भीतर `consecutiveDenies` / `windowDenies`), जो एक केवल-लॉग `autoReview/circuit` घटना के रूप में दर्ज होती है; बाद के अनुरोध उसकी `action` (`delegate` / `reject` / `abort-turn`) का पालन करते हैं।
- **समीक्षक संदर्भ प्रस्तुत ट्रांसक्रिप्ट है।** `contextBudget` समीक्षक को पहले से प्रस्तुत सत्र सामग्री खिलाता है। डिफ़ॉल्ट समान-मार्ग समीक्षक मॉडल के साथ वह सामग्री एक ही प्रदाता के भीतर रहती है; `reviewerModel` को किसी भिन्न प्रदाता पर तभी कॉन्फ़िगर करें जब आप उस ट्रांसक्रिप्ट को उसे प्रस्तुत करना स्वीकार करते हों।
- **`never` इस परत पर एक-तरफ़ा है।** एक `never` टूल या जोखिम नियम मानव श्रृंखला के अनुरोध देखने से पहले ही अस्वीकार कर देता है — एक लॉकडाउन नियंत्रण, डिफ़ॉल्ट नहीं।

## ज्ञात सीमाएँ

- **दो अलग-अलग एक्सपोज़र, दो अलग-अलग उपाय — कोई एक दूसरे का विकल्प नहीं।** *इंजेक्ट किया गया* संदर्भ (वर्कस्पेस निर्देश फ़ाइलें, रनटाइम-संदर्भ स्नैपशॉट, तृतीय-पक्ष प्लगइन इंजेक्शन) हर नए एजेंट सत्र में नए सिरे से इंजेक्ट होता है, इसलिए यह `reviewerProvider: fork` और `reviewerProvider: spawn` दोनों में समान रूप से समीक्षक तक पहुँचता है — एक ही अनुरोध पर दोनों में बाइट-दर-बाइट समान मापा गया। इसे बंद करने वाला `agent/pre-step` स्रोत फ़िल्टर है, दोनों प्रदाताओं के साथ; **केवल `spawn` अपनाने से वर्कस्पेस निर्देश समीक्षक तक पहुँचना बंद नहीं होते।** अलग से, `fork` चाइल्ड को प्रत्यायोजक सत्र के पूर्ण हुए टर्न से सीड करता है: वह इतिहास पहले से चाइल्ड का अपना लॉग है, किसी चरण में प्रवेश करता संदेश नहीं, इसलिए फ़िल्टर उस तक नहीं पहुँच सकता और केवल `spawn` उससे बचाता है — बीच में समीक्षक प्रॉम्प्ट की अविश्वसनीय-ट्रांसक्रिप्ट बाड़ शमन के रूप में रहती है। ऊपर की दोनों ट्रेस में सीडिंग से कोई अतिरिक्त संदेश नहीं बना, इसलिए उसका व्यावहारिक प्रभाव अपरिमाणित है।
- समीक्षक को एक कार्यशील LLM मार्ग चाहिए (डिफ़ॉल्ट रूप से विरासत); इसके बिना हर समीक्षा `fallbackPolicy` के अनुसार गिरती है — कभी मौन अनुमति नहीं।
- `reviewerTools` नाम प्रोफ़ाइल में वैश्विक टूल के रूप में मौजूद होने चाहिए; अज्ञात नाम समीक्षक चाइल्ड को सबसे पहले बिंदु पर ज़ोर से विफल करता है और fallback होता है।
- जोखिम नियम अपने `field` के अनुसार अनुरोध के `reason`, `toolName` या संशोधित कॉल `arguments` से मिलते हैं; बाकी शर्तें `toolsPolicy.overrides` में रखें।
- `/auto-review approve` ओवरराइड उसी टूल की अगली समीक्षा को अधिकृत करता है, उस सटीक ऐतिहासिक कॉल को नहीं; उसी टूल पर एक भिन्न क्रिया उसे उपभोग कर लेती है।
- निर्णय घटनाएँ केवल-लॉग हैं; वेब समीक्षा पैनल मुड़ा हुआ `autoReview` प्रोजेक्शन पढ़ता है (कच्ची घटना धारा ब्राउज़र प्लगइन तक कभी नहीं पहुँचती)।
- मार्कर का सम्मान करने वाले होस्ट पर `autoReview/state` और `autoReview/verdict` लिफ़ाफ़े के `ignorable: true` मार्कर के साथ जोड़े जाते हैं, ताकि कोई भी harness बिल्ड लॉग लोड करे — जो पाठक रेपो-बाहरी प्रकारों को नहीं जानते वे उन रिकॉर्ड को बस छोड़ देते हैं। रिलीज़ किए गए rc होस्ट (rc.1–rc.8) पर runtime छूटे मार्कर का पता लगाकर ये घटनाएँ कभी नहीं लिखता (इन-मेमोरी मिरर कमांड, बजट, ब्रेकर और `approve` को सत्र भर बनाए रखता है); 0.5.1 से पहले के संस्करणों से दूषित सत्र `dsh-permission-rules` के `scripts/repair-session-logs.mjs` से मरम्मत किए जा सकते हैं (इसका डिफ़ॉल्ट सेट सभी पाँच `autoReview/*` घटना प्रकारों को कवर करता है)।
- git चैनल को वह एकल `allowBuilds` कुंजी चाहिए जो `dsh` CLI स्वयं `dsh-auto-review` के लिए छापता है। रेपो अपना `pnpm-workspace.yaml` `esbuild` और मूल होस्ट पैकेजों (`@deepseek-ai/dsh-subprocess-local`, `node-pty`, `koffi`) के लिए `allowBuilds` के साथ शिप करता है; `typescript` + `tsdown` `devDependencies` में हैं, और git इंस्टॉल उन्हें इंस्टॉल करके `prepare` चलाता है।
- वैकल्पिक invariant साथी को `invariants` सेवा चाहिए (agent-spine रचनाएँ जैसे headless/ACP); सादा web प्रोफ़ाइल वह नहीं देता, इसलिए पंक्ति बंडल पैच में टिप्पणी-बंद शिप होती है।

## संबंधित कार्य

- [Andy8647/dsh-auto-approval](https://github.com/Andy8647/dsh-auto-approval) — `tools/pre-execute` कैस्केड पर फ़ाइल-लॉग ऑडिट के साथ दो-स्थिति allow/deny वर्गीकरणकर्ता। `dsh-auto-review` जान-बूझकर भिन्न है: आधिकारिक **answerer** श्रृंखला, हमेशा वही सौंपता है जो उसका नहीं है, संरचित निर्णय वाला केवल-पढ़ने वाला दूसरा मॉडल, अस्वीकृति कारण मॉडल को लौटाए जाते हैं, सत्र-लॉग ऑडिट।
- [ACP automation bridge](https://github.com/deepseek-ai/deepseek-harness/tree/master/packages/acp/acp) — अपने स्वयं के ACP-स्वामित्व वाले एजेंटों के लिए एक-बार मशीन निर्णय। `dsh-auto-review` इंटरैक्टिव harness के लिए सत्र- और टूल-नीति-दायरे वाला है; यह कभी टिकाऊ अनुदान नहीं निकालता।

## विकास

```sh
pnpm install                # node ^22.19 || >=24
pnpm run typecheck          # tsc: src + tests, स्थानीय harness checkout के विरुद्ध
pnpm test                   # vitest: 30 spec फ़ाइलें
pnpm run build              # tsc घोषणाएँ + tsdown बंडल (lib/, क्लाइंट बंडल सहित)
pnpm run verify:self-contained
pnpm pack                   # प्रकाशित tarball
```

रिपॉज़िटरी लेआउट: `src/index.ts` (प्लगइन अनुबंध) · `src/config.ts` (Schemastery स्कीमा + समाधान) · `src/runtime.ts` (answerer, कमांड, अस्वीकृति-कारण इंजेक्शन) · `src/review.ts` (समीक्षक ऑर्केस्ट्रेशन, प्रॉम्प्ट, स्वच्छता) · `src/phocinae.ts` (वैकल्पिक स्थानीय निर्णय-मॉडल समीक्षक) · `src/events.ts` (सत्र-घटना शब्दावली + मोड़) · `src/projection.ts` + `src/projection-types.ts` (`autoReview` सत्र प्रोजेक्शन) · `src/invariant.ts` (invariant साथी) · `src/eval/` (dsh-eval इंजन) · `eval/` (शिप की गई मूल्यांकन रचना) · `bin/dsh-eval.mjs` (CLI लॉन्चर) · `src/client/` (ब्राउज़र आधा) · `test/` · `fixtures/`।

## विषय

`deepseek-harness`, `dsh`, `dsh-plugin`, `cordis`, `approval`, `auto-review`, `second-model`, `ai-safety`, `sandbox`, `subagent`

## योगदानकर्ता

- [@PerryLink](https://github.com/PerryLink) — निर्माता और अनुरक्षक: अनुमोदन answerer, समीक्षक उप-एजेंट, जोखिम नीति और सर्किट ब्रेकर, सत्र-प्रोजेक्शन समीक्षा पैनल, invariant साथी, dsh-eval, और पाँच-भाषा दस्तावेज़।
- [@weipeng1999](https://github.com/weipeng1999) — समीक्षक के स्वतंत्र प्रदाता/मॉडल रूटिंग का प्रस्ताव रखा ([#11](https://github.com/PerryLink/dsh-auto-review/issues/11), [चर्चा #12](https://github.com/PerryLink/dsh-auto-review/discussions/12)), जो `reviewerProvider` / `reviewerModel` के रूप में जारी हुआ।
- [@alexchenzl](https://github.com/alexchenzl) — DSH प्लगइन निर्देशिका में प्लगइन को सूचीबद्ध किया ([#10](https://github.com/PerryLink/dsh-auto-review/issues/10))।

### DSH Desktop मार्केट से इंस्टॉल करें

सभी PerryLink प्लगइन DSH Desktop के बिल्ट-इन मार्केट में देखे जा सकते हैं: **Market → Sources → add source → पेस्ट करें** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ चुनें**। इंस्टॉलेशन मार्केट के npm-identity सत्यापन और आपकी पुष्टि से ही होता है।

## संरचित रसीदें

एकीकरण `ctx.autoReviewRuntime.answerDetailed(request, next)` को कॉल करके और `DetailedAnswer` / `ReviewReceipt` आयात करके अनुरोध संबंध, समीक्षा, fallback, delegation और circuit प्रमाण प्राप्त कर सकते हैं; कस्टम session events आवश्यक नहीं हैं। `answer()` और स्थापित approval chain का व्यवहार अपरिवर्तित है। केवल विस्तृत API आंतरिक या downstream exceptions को `rejected` / `unavailable` में बदलती है; disposal के बाद अंतिम परिणाम rejected होता है, लेकिन तुरंत cancellation या देर से होने वाले अंतर्निहित side effects हटाने की गारंटी नहीं है। `configuredReviewerBackend` backend है, model provider नहीं। बाद में `prepend` के साथ पंजीकृत Host listener पहले चल सकता है; रसीदें exclusive approval admission नहीं देतीं।

## लाइसेंस

[Apache License 2.0](LICENSE) © 2026 dsh-auto-review contributors