dsh-standards 1.2.1 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/40-checker/README.md +25 -3
  2. package/40-checker/bin/dsh-levels.mjs +7 -1
  3. package/40-checker/scripts/build-offline-kit.mjs +284 -0
  4. package/40-checker/scripts/build-sidecar.mjs +484 -0
  5. package/40-checker/scripts/flow-collect.mjs +147 -22
  6. package/40-checker/scripts/level-audit.mjs +57 -9
  7. package/40-checker/scripts/run-tests.mjs +17 -0
  8. package/40-checker/src/author-cli.mjs +139 -0
  9. package/40-checker/src/author-report.mjs +260 -0
  10. package/40-checker/src/cli.mjs +73 -8
  11. package/40-checker/src/flow-evidence.mjs +189 -3
  12. package/40-checker/src/index.mjs +3 -3
  13. package/40-checker/src/report.mjs +125 -24
  14. package/40-checker/src/sandbox-run.mjs +403 -0
  15. package/CHANGELOG.md +26 -0
  16. package/README.en.md +352 -0
  17. package/README.es.md +352 -0
  18. package/README.hi.md +352 -0
  19. package/README.md +300 -82
  20. package/README.pt.md +352 -0
  21. package/bin/dsh-standards.mjs +13 -2
  22. package/docs/assets/dsh-standards-flow-dark.svg +38 -0
  23. package/docs/assets/dsh-standards-flow-light.svg +38 -0
  24. package/docs/assets/dsh-standards-flow-v3-dark.svg +87 -0
  25. package/docs/assets/dsh-standards-flow-v3-light.svg +87 -0
  26. package/docs/assets/dsh-standards-flow-v4-dark.svg +79 -0
  27. package/docs/assets/dsh-standards-flow-v4-light.svg +79 -0
  28. package/docs/assets/dsh-standards-hero-en-dark.webp +0 -0
  29. package/docs/assets/dsh-standards-hero-en-light.webp +0 -0
  30. package/docs/assets/dsh-standards-hero-zh-dark.webp +0 -0
  31. package/docs/assets/dsh-standards-hero-zh-light.webp +0 -0
  32. package/package.json +2 -2
  33. package/spec/README.md +2 -0
  34. package/spec/flow/README.md +19 -6
  35. package/spec/flow-evidence.schema.json +76 -6
  36. package/spec/schemas/advice.schema.json +92 -0
package/README.hi.md ADDED
@@ -0,0 +1,352 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-standards-hero-en-dark.webp">
5
+ <img src="docs/assets/dsh-standards-hero-en-light.webp" width="100%" alt="dsh-standards: DSC-01…13 static checks + L1–L3 runtime, reproducible reports">
6
+ </picture>
7
+
8
+ # dsh-standards
9
+
10
+ **एक ही कमांड में किसी DSH प्लगइन की अनुकूलता, उपयोग-सुविधा और दक्षता-साक्ष्य जानें — स्थिर कभी रनटाइम का रूप नहीं लेता, और `not-run` कभी PASS नहीं गिना जाता।**
11
+
12
+ DSH के तीन अपनाव-स्तरों (ENTRY / FLOW / BOOST) का निष्पादन-केंद्र: जाँचकर्ता, स्तर-ऑडिट और मानक पाठ यहीं रहते हैं; गद्य-मार्गदर्शिका [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) में है और निम्न-स्तरीय खंड-पाठ [dsh-plugin-spec](https://github.com/PerryLink/dsh-plugin-spec) में बना हुआ है।
13
+
14
+ [इंस्टॉल](#तीन-चरणों-में-शुरुआत) · [कॉन्फ़िगरेशन](#कॉन्फ़िगरेशन) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
+
16
+ [![License](https://img.shields.io/badge/license-Apache--2.0%20%2B%20CC--BY--4.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
17
+ [![npm](https://img.shields.io/npm/v/dsh-standards?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-standards)
18
+ [![Node](https://img.shields.io/badge/node-%3E%3D24.9.0-339933?style=flat-square&labelColor=2B3245)](#तीन-चरणों-में-शुरुआत)
19
+
20
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-standards?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-standards/stargazers)
21
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-standards?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-standards)
22
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-standards)
23
+
24
+ ```sh
25
+ npm i -g dsh-standards # ग्लोबल: dsh-standards + dsh-levels
26
+ npx dsh-standards <plugin-dir> --scope entry --entry-claim static # या बिना इंस्टॉल किए चलाएँ
27
+ ```
28
+
29
+ </div>
30
+
31
+ <sub>सामुदायिक परियोजना, DeepSeek से असंबद्ध: अनौपचारिक, प्रमाणन नहीं, सुरक्षा-ऑडिट नहीं, और कोई आधिकारिक समर्थन नहीं। `DeepSeek Harness` DeepSeek का ट्रेडमार्क है; यह परियोजना केवल `DSH` संक्षेप का उपयोग करती है। कैनोनिकल रिपॉज़िटरी: <https://github.com/PerryLink/dsh-standards> (Gitee एक मिरर है)।</sub>
32
+
33
+ ## यह क्या है
34
+
35
+ यह रिपॉज़िटरी प्लगइन नहीं बनाती। यह मापने की लकीर बनाती है, और फिर उससे मापती है।
36
+
37
+ DSH अपनाव की गहराई के तीन स्तर हैं, हर स्तर का अपना प्रश्न और साक्ष्य-शब्दावली है, और वे **कभी एक अंक में नहीं मिलाए जाते**:
38
+
39
+ | स्तर | मानक / अभ्यास | कौन-सा प्रश्न | वर्तमान स्थिति |
40
+ |---|---|---|---|
41
+ | 1 | **DSH-ENTRY, संगतता आधार** | क्या मौजूदा प्लगइन को कोड बदले बिना पहचाना, इंस्टॉल और बूट किया जा सकता है? | 18/18 `recognized`; base-only 10/18 के पास रनटाइम साक्ष्य (8 clean + 2 reject); वास्तविक web प्रोफ़ाइल 16/18 बिना चेतावनी और 2 host-gate reject (स्व-आकलन, स्वतंत्र समीक्षा नहीं); client 15/15 loaded; 18/18 clean अभी नहीं |
42
+ | 2 | **DSH-FLOW, उपयोग की सहजता** | क्या उपयोगकर्ता बिना किसी अप्रत्याशित बात के इंस्टॉल, कॉन्फ़िगर, उपयोग, रिकवर, अपग्रेड और अनइंस्टॉल कर सकता है? | draft; fixture पर J1/J2/J4/J6 **12 PASS**; J3/J7 fixture runtime; J5/J8 static preflight; 10 वास्तविक पैकेज **78 PASS / 4 FAIL / 2 blocked / 66 not-run** |
43
+ | 3 | **DSH-BOOST, त्वरण** | क्या प्लगइन Cordis के मूल तत्वों (effect, inject, volatile, इवेंट, seam, job, सीमित समानांतरता) से विकास और उपयोग को मापने योग्य रूप से सस्ता बनाता है? | draft; LEV-1–8 **8/8 measured** (loader / context / provider-capture / synthetic timer; उत्पादन आधार-रेखा नहीं) |
44
+
45
+ यहाँ तीन चीज़ें हैं: `40-checker/` (DS-C जाँचकर्ता और सभी साक्ष्य-स्क्रिप्ट), `bin/` (दो सार्वजनिक प्रवेश बिंदु, `dsh-standards` और `dsh-levels`), और `spec/` के साथ संख्यांकित `31`–`35` दस्तावेज़ों का मानक पाठ। उपकरण लक्ष्य पैकेज को केवल पढ़ते हैं, उसे बदलते नहीं; निर्णय केवल साक्ष्य स्वीकार करता है, इसलिए `not-run`, `NA` और `static` कभी PASS के रूप में नहीं लिखे जाते।
46
+
47
+ npm पर पुराना आरक्षण `dsh-standards@0.0.3` केवल नाम रखता था; यह 1.x श्रृंखला उसकी जगह लेती है (अभी `1.1.2`), और दोनों bin `dsh-standards` तथा `dsh-levels` हैं।
48
+
49
+ स्थिर एंकर, `spec/levels.json` और हर रिपोर्ट में दर्ज: `repo=deepseek-ai/deepseek-harness`, `commit=ce7073d51254`, `dsh=0.2.2-alpha.2`, `cordis=4.0.6-alpha.1`। अलग रनटाइम संस्करण दें तो रिपोर्ट लिख देती है कि आपने किस लकीर से मापा।
50
+
51
+ ### वर्तमान ठोस आँकड़े
52
+
53
+ - 18 पैकेज, entry static: **18/18 recognized, 0 clean**;
54
+ - 18 पैकेज, DS-C static: **0 PASS / 9 WARN / 9 FAIL**;
55
+ - 18 पैकेज, runtime base-only: **18/18 के पास कच्चा JSON; 10/18 G3 verified, 8 partial, 0 error**; host gate के बाद **8 clean + 2 reject + 8 partial**;
56
+ - client runtime: **15/15 `client-module-loaded`** (वास्तविक Chromium); web-app **4/4 loaded**;
57
+ - अनुपयोगी: **0 plugin code FAIL; 2 host-gate reject (telemetry/verification)**;
58
+ - जाँचकर्ता का स्व-परीक्षण: **128/128 tests** (स्थानीय रूप से `node --test 40-checker/test/*.test.mjs`; इसमें शासन, DCO, मूल्यांकन-रिकॉर्ड, घोषणा, सत्यापन, श्रृंखला और ड्रिफ़्ट परीक्षण शामिल हैं);
59
+ - J1: **6 PASS + 1 WARN**; LEV-3: volatile **0/20** बनाम control **20/20** remount; LEV-6: स्थिर prefix **100%** बनाम अस्थिर **0%**; LEV-7: **8.24×** (कृत्रिम, उत्पादन आधार-रेखा नहीं)।
60
+
61
+ ये आँकड़े स्व-आकलन और रिपॉज़िटरी की साक्ष्य-श्रृंखला हैं, तीसरे पक्ष की समीक्षा नहीं — रिपोर्ट का `notClaimed` फ़ील्ड ठीक-ठीक बताता है कि क्या दावा नहीं किया जा रहा (आधिकारिक मानक, प्रमाणन, सुरक्षा-ऑडिट, रैंकिंग, उत्पादन आधार-रेखा)।
62
+
63
+ <details>
64
+ <summary>रिपॉज़िटरी नक्शा (संख्यांकित 00–99 विनिर्देश चीनी में लिखे हैं)</summary>
65
+
66
+ - [START-HERE.md](START-HERE.md) — नए सत्र के लिए एक-पृष्ठ प्रवेश
67
+ - [docs/DEVELOPER-JOURNEY.md](docs/DEVELOPER-JOURNEY.md) — प्लगइन जीवनचक्र और उपकरण-श्रृंखला
68
+ - [spec/levels.json](spec/levels.json) — तीन स्तरों का मशीन-पठनीय सत्य-स्रोत
69
+ - [scheme/SCHEME-v1.md](scheme/SCHEME-v1.md) — A–E / A–D मूल्यांकन योजना और rubric
70
+ - [evidence/README.md](evidence/README.md) — केवल-जुड़ने वाली साक्ष्य-श्रृंखला और दोबारा चलाने के निर्देश
71
+ - [GOVERNANCE.md](GOVERNANCE.md) · [CONTRIBUTING.md](CONTRIBUTING.md) · [SECURITY.md](SECURITY.md) · [MODIFICATION-POLICY.md](MODIFICATION-POLICY.md)
72
+ - [RENAMES.md](RENAMES.md) — पुराने नाम से नई रिपॉज़िटरी का नक्शा
73
+ - [P0-P2-STATUS.md](P0-P2-STATUS.md) — मद-दर-मद DONE / PARTIAL / REPLACED
74
+
75
+ पूरा 51-दस्तावेज़ सूचकांक चीनी [README.md](README.md) में है।
76
+
77
+ </details>
78
+
79
+ <picture>
80
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-standards-flow-v4-dark.svg">
81
+ <img src="docs/assets/dsh-standards-flow-v4-light.svg" width="100%" alt="dsh-standards pipeline: plugin dir → DSC-01…13 → L1–L3 runtime → report → dsh-levels">
82
+ </picture>
83
+
84
+ ## तीन चरणों में शुरुआत
85
+
86
+ **1. इंस्टॉल** (दो में से कोई भी; Node `>=24.9.0`):
87
+
88
+ ```sh
89
+ # ग्लोबल इंस्टॉल: dsh-standards और dsh-levels दोनों PATH पर आ जाते हैं
90
+ npm i -g dsh-standards
91
+ # या बिना कुछ इंस्टॉल किए सीधे चलाएँ
92
+ npx dsh-standards --version
93
+ npx -p dsh-standards dsh-levels --help
94
+ ```
95
+
96
+ कोई build चरण नहीं है: `bin/` और `40-checker/` ही प्रकाशित कलाकृति हैं। दूसरी npx कमांड में `-p dsh-standards` लिखना ज़रूरी है, क्योंकि npm पर नंगे नाम `dsh-levels` और `dsh-plugin-verify` दूसरी परियोजनाओं के हैं।
97
+
98
+ **2. एक जाँच चलाएँ** (लक्ष्य वह पैकेज डायरेक्टरी है जिसमें `package.json` हो):
99
+
100
+ ```sh
101
+ # एंट्री अनुकूलता: स्थिर पहचान, रनटाइम का दावा नहीं
102
+ dsh-standards ./my-plugin --scope entry --entry-claim static
103
+
104
+ # पूरा DS-C (डिफ़ॉल्ट दायरा): JSON / SARIF 2.1.0 रिपोर्ट
105
+ dsh-standards ./my-plugin --format json --out report.json
106
+ dsh-standards ./my-plugin --format sarif --out report.sarif
107
+
108
+ # तीन-स्तरीय ऑडिट: ENTRY अपने आप चलता है; FLOW / BOOST साक्ष्य फ़ाइल के बिना not-run / not-measured रहते हैं
109
+ dsh-levels ./my-plugin --format json --out audit.json
110
+ ```
111
+
112
+ **3. निर्णय पढ़ें** — पहले exit code, फिर `status`:
113
+
114
+ ```text
115
+ 0 completed, no FAIL (PASS or WARN; WARN does not claim a clean PASS)
116
+ 1 completed, at least one FAIL
117
+ 2 incomplete: a mandatory check did not run, or the checker itself failed
118
+ 3 usage error
119
+ ```
120
+
121
+ इस रिपॉज़िटरी के fixture पर वास्तविक आउटपुट (छोटा किया गया):
122
+
123
+ ```text
124
+ scope=entry profile=package status=pass exit=0
125
+ level: DSH-ENTRY recognized
126
+ DSC-01 PASS C-1 L0
127
+ DSC-14 NA C-14 L1 entry static claim: no runtime evidence
128
+ coverage: mandatory=5 pass=5 warn=0 fail=0 na=0 notRun=0
129
+ ```
130
+
131
+ उसी fixture पर `dsh-levels` तीनों स्तरों की स्थिति बताता है — `entry.state=recognized`, `flow.state=not-run`, `boost.state=not-measured` — और तीन `nextActions` पंक्तियाँ जोड़ता है कि आगे कौन-सा साक्ष्य चाहिए।
132
+
133
+ ## मुख्य क्षमताएँ
134
+
135
+ - **स्थिर पक्ष (L0)**: लक्ष्य को चलाता नहीं; manifest, एंट्री, patch और स्रोत पढ़कर `DSC-01`–`DSC-03` और `DSC-10`–`DSC-13` तय करता है।
136
+ - **रनटाइम पक्ष (L1–L3)**: पैकेज को **पृथक चाइल्ड प्रोसेस** में Cordis रनटाइम पर लोड करता है और देखता है कि वह ACTIVE तक पहुँचता है या नहीं, घोषित `provide` वास्तव में रजिस्टर होता है या नहीं, effect टोपोलॉजी बनती है या नहीं, unload पर सब शून्य होता है या नहीं, और restart इडेम्पोटेंट है या नहीं। टाइमआउट का अर्थ है ज़बरदस्ती किल, और किल का अर्थ `not-run` है, कभी PASS नहीं।
137
+ - **रिपोर्ट पक्ष**: `text` / `json` / `sarif` (SARIF 2.1.0, GitHub code scanning के लिए तैयार); हर रिपोर्ट में `anchor` (harness commit, dsh और cordis संस्करण) होता है — संस्करण बदला तो लकीर भी बदल गई।
138
+ - **तीन-स्तरीय ऑडिट**: `dsh-levels` ENTRY के निर्णय को साक्ष्य-स्थिति में बदलता है और केवल J1–J8 (FLOW) तथा LEV-1–8 (BOOST) साक्ष्य फ़ाइलें पढ़ता है; साक्ष्य न हो तो `not-run` / `not-measured` बताता है।
139
+ - **केवल-पढ़ने वाला**: जाँचे जा रहे पैकेज को नहीं बदलता और लक्ष्य डायरेक्टरी में कुछ नहीं लिखता; रिपोर्ट stdout या `--out` पर जाती है।
140
+
141
+ ### जाँचें
142
+
143
+ | ID | खंड | परत | क्या जाँचता है |
144
+ |---|---|---|---|
145
+ | `DSC-01` | C-1 | L0 | `manifest`, `name`, `version`, `license`, एंट्री, `dsh.bundle.patch`, export का रूप |
146
+ | `DSC-02` | C-2 | L0 | `engines.dsh` या `@deepseek-ai/dsh*` peer, जो runtime से संतुष्ट हो |
147
+ | `DSC-03` | C-3 | L0 | इंस्टॉल spec, मार्केट इंडेक्स प्रविष्टि, सप्लाई-चेन पिनिंग |
148
+ | `DSC-04` | C-4 | L1 | ACTIVE तक लोड होना |
149
+ | `DSC-05` | C-5 | L1 | घोषित `provide` वास्तव में रजिस्टर होना |
150
+ | `DSC-06` | C-6 | L1+L2 | effect टोपोलॉजी, निजी रजिस्ट्रेशन सतह |
151
+ | `DSC-07` | C-7 | L2 | unload के बाद effect / store / registry का शून्य पर लौटना |
152
+ | `DSC-08` | C-8 | L3 | restart की इडेम्पोटेंसी और ठंडा restart |
153
+ | `DSC-09` | C-9 | L1 | घोषित बनाम मापा गया का मिलान |
154
+ | `DSC-10` | C-10 | L0 | import के समय के साइड-इफ़ेक्ट (advisory, कभी FAIL नहीं) |
155
+ | `DSC-11` | C-11 | L0 | `dsh.capabilities` और उच्च-संकेत ट्रिगर |
156
+ | `DSC-12` | C-12 | L0 | क्रेडेंशियल backing file, `listRecords`, वैश्विक seam; साथ में `dsh.commitments` और `dsh.disclosure` का रूप भी पढ़ता है |
157
+ | `DSC-13` | C-13 | L0 | `dsh.labels`, `upstream`, निषिद्ध शब्दावली |
158
+
159
+ `--scope mvp` केवल 8 ID कवर करता है (`DSC-03/10/11/12/13` MVP से बाहर हैं) और `subset: "MVP-13"` के साथ `level: null` लिखता है — वह DS-C पास **नहीं** है।
160
+
161
+ ### कौन-सा टूल, कब
162
+
163
+ | चरण | कमांड | टूल | आउटपुट |
164
+ |---|---|---|---|
165
+ | शुरुआत | `dsh-dev new` / `dsh-start new` | dsh-plugin-start | इंस्टॉल-योग्य ढाँचा |
166
+ | स्थिर पूर्व-जाँच | `dsh-dev check` / `dsh-ready` | dsh-plugin-ready | स्थिर रिपोर्ट (host `not-run`) |
167
+ | होस्ट अनुबंध | `dsh-clinic --only R,K,X` | dsh-plugin-doctor/clinic | होस्ट अनुबंध |
168
+ | पृथक इंस्टॉल | `dsh-test-drive` | dsh-test-drive | C3 साक्ष्य |
169
+ | मार्केट सबमिशन | `entry-validate --host-evidence` | इस रिपॉज़िटरी का `40-checker` | C1–C8 + C3 |
170
+ | टूल प्रबंधन | `dsh-tools list/doctor/install` | dsh-plugin-tools | संस्करण / इंस्टॉल मार्गदर्शन |
171
+
172
+ पूरा सफ़र [docs/DEVELOPER-JOURNEY.md](docs/DEVELOPER-JOURNEY.md) में, टूल परिवार [dsh-plugin-devtools](https://github.com/PerryLink/dsh-plugin-devtools) में, और पुराने नामों का नक्शा [RENAMES.md](RENAMES.md) में है।
173
+
174
+ ## कॉन्फ़िगरेशन
175
+
176
+ कोई कॉन्फ़िग फ़ाइल नहीं है — हर सेटिंग कमांड-लाइन फ़्लैग है। दोनों कमांड के अपने सेट हैं: `dsh-standards <package-dir>` DS-C जाँचकर्ता को भेजता है (`--help` पूरा उपयोग छापता है) और `dsh-levels <package-dir>` तीन-स्तरीय ऑडिट को भेजता है।
177
+
178
+ असल में काम आने वाले आठ:
179
+
180
+ | फ़्लैग | डिफ़ॉल्ट | अर्थ |
181
+ |---|---|---|
182
+ | `<package-dir>` | `.` | लक्ष्य पैकेज डायरेक्टरी जिसमें `package.json` हो; tarball समर्थित नहीं |
183
+ | `--scope` | `ds-c` | `mvp` = 8 MVP ID; `ds-c` = पूरी घोषणा; `entry` = अनुकूलता द्वार |
184
+ | `--format` | `text` | `text` / `json` / `sarif` (SARIF 2.1.0) |
185
+ | `--entry-claim` | `runtime` | `runtime` को DSC-14 रनटाइम साक्ष्य चाहिए; `static` केवल संरचनात्मक पहचान का दावा |
186
+ | `--host` | — | app-boot का `lib/index.js`; bundle के G0–G3 smoke के लिए अनिवार्य |
187
+ | `--profile` | `package` | `package` / `listing` / `both`; `--market-index` दिए जाने पर `listing` |
188
+ | `--no-exec` | `false` | L1–L3 पूरी तरह छोड़ें, `not-run` के रूप में दर्ज (कभी PASS नहीं) |
189
+ | `--out` | — | रिपोर्ट stdout के बजाय फ़ाइल में लिखें |
190
+
191
+ <details>
192
+ <summary>पूरी फ़्लैग सूची (dsh-standards के सभी स्विच)</summary>
193
+
194
+ | फ़्लैग | डिफ़ॉल्ट | अर्थ |
195
+ |---|---|---|
196
+ | `--format` | `text` | रिपोर्ट प्रारूप: `text` / `json` / `sarif` |
197
+ | `--scope` | `ds-c` | जाँच दायरा: `mvp` / `ds-c` / `entry` |
198
+ | `--profile` | `package` | मूल्यांकन प्रोफ़ाइल: `package` / `listing` / `both` |
199
+ | `--runtime` | — | बने हुए `@deepseek-ai/cordis` के `lib/index.js` का पथ; L1–L3 चालू करता है |
200
+ | `--runtime-version` | `0.2.2-alpha.2` | anchor में दर्ज dsh रनटाइम संस्करण, C-2 के लिए |
201
+ | `--cordis-version` | `4.0.6-alpha.1` | anchor में दर्ज cordis संस्करण |
202
+ | `--commit` | `ce7073d51254` | anchor में दर्ज harness commit |
203
+ | `--install-spec` | — | C-3 के लिए सुझाया गया इंस्टॉल spec |
204
+ | `--market-index` | — | फ़ॉर्मैट-1 मार्केट इंडेक्स JSON; listing मोड चालू करता है |
205
+ | `--plugin-name` | — | मार्केट इंडेक्स के भीतर प्लगइन का नाम |
206
+ | `--timeout` | `10000` | L1–L3 टाइमआउट मि.से. (100–120000) |
207
+ | `--no-exec` | `false` | L1–L3 पूरी तरह छोड़ें, `not-run` / `NA` के रूप में दर्ज |
208
+ | `--static-only` | `false` | M1 मोड: केवल C-1/C-2/C-3/C-11/C-12/C-13 दायरे में, C-4–C-9 बाहर |
209
+ | `--treat-as-plugin` | `false` | bundle के सर्वर एंट्री पर L1–L3 चलाएँ |
210
+ | `--entry-runtime` | `require` | entry द्वार: पूरा G0–G3 या `server-entry` प्रॉक्सी |
211
+ | `--entry-claim` | `runtime` | entry द्वार: रनटाइम साक्ष्य (DSC-14) या केवल स्थिर पहचान |
212
+ | `--host` | — | app-boot का `lib/index.js`; bundle का G0–G3 smoke चालू करता है |
213
+ | `--base` | — | bundle smoke के लिए आधार `cordis.patch.yml` |
214
+ | `--web` | — | bundle smoke के लिए web-app का `cordis.patch.yml` |
215
+ | `--bare` | — | host farm के लिए bare-module आधार डायरेक्टरी |
216
+ | `--out` | — | रिपोर्ट stdout के बजाय फ़ाइल में लिखें |
217
+ | `--help` / `--version` | — | उपयोग छापें / `dsh-standards <संस्करण> (checker 0.1.0)` छापें |
218
+
219
+ `dsh-levels` के फ़्लैग:
220
+
221
+ | फ़्लैग | डिफ़ॉल्ट | अर्थ |
222
+ |---|---|---|
223
+ | `<package-dir>` | अनिवार्य | लक्ष्य पैकेज डायरेक्टरी जिसमें `package.json` हो |
224
+ | `--host` | — | ENTRY के लिए वास्तविक G0–G3 बूट |
225
+ | `--base` | — | bundle smoke के लिए आधार patch |
226
+ | `--bare` | — | bundle smoke के लिए bare-module farm |
227
+ | `--no-runtime` | `false` | `--host` दिए होने पर भी ENTRY स्थिर ही रहे |
228
+ | `--flow-evidence` | — | J1–J8 साक्ष्य JSON; हर प्रविष्टि का `status` `pass` / `fail` / `not-run` |
229
+ | `--boost-evidence` | — | LEV साक्ष्य JSON; केवल status वाली और साक्ष्य-कार्ड रहित पंक्ति `not-measured` में बदल जाती है |
230
+ | `--timeout` | `150000` | जाँचकर्ता टाइमआउट मि.से. |
231
+ | `--format` | `text` | `text` / `json` |
232
+ | `--out` | — | परिणाम फ़ाइल में लिखें |
233
+
234
+ </details>
235
+
236
+ ## FAQ
237
+
238
+ <details>
239
+ <summary>क्या यह प्रमाणन या रैंकिंग है?</summary>
240
+
241
+ नहीं। परियोजना स्वयं को **अनौपचारिक, प्रमाणन नहीं, सुरक्षा-ऑडिट नहीं** कहती है और DeepSeek के समर्थन का प्रतिनिधित्व नहीं करती; कोई शुल्क नहीं, स्तर या रैंकिंग की बिक्री नहीं। `A–D` `scheme/` के गुणवत्ता ग्रेड हैं, जो `ENTRY` / `FLOW` / `BOOST` स्तरों से स्वतंत्र हैं — न रिपोर्ट और न दस्तावेज़ उन्हें एक अंक में मिलाते हैं। साक्ष्य चाहे कितना भी मज़बूत हो, वह स्व-आकलन और रिपॉज़िटरी की साक्ष्य-श्रृंखला है, और `notClaimed` फ़ील्ड हमेशा «आधिकारिक मानक / प्रमाणन / सुरक्षा-ऑडिट / रैंकिंग / उत्पादन आधार-रेखा» गिनाता है।
242
+
243
+ </details>
244
+
245
+ <details>
246
+ <summary>`18/18 recognized` और `18/18 clean` में क्या अंतर है?</summary>
247
+
248
+ `recognized` स्थिर पहचान का पास है (`--entry-claim static`, केवल संरचनात्मक घोषणा, रनटाइम का दावा नहीं)। `clean` को रनटाइम साक्ष्य चाहिए: base-only 10/18 के पास रनटाइम साक्ष्य (8 clean + 2 reject), वास्तविक web प्रोफ़ाइल 16/18 बिना चेतावनी और 2 host-gate reject, और यह सब स्व-आकलन है, स्वतंत्र समीक्षा नहीं — इसलिए **18/18 clean अभी भी हासिल नहीं** और कोई दस्तावेज़ इसके विपरीत नहीं कहता। इसी तरह, `client-module-loaded` न UI उपयोगिता है न प्रमाणन।
249
+
250
+ </details>
251
+
252
+ <details>
253
+ <summary>DSH रनटाइम न हो तो क्या होगा? क्या चुपचाप पास हो जाता है?</summary>
254
+
255
+ नहीं। L1–L3 को `--runtime` चाहिए (और bundle को `--host`); बिना उनके जाँचें `ERR` / `not-run` दर्ज होती हैं और कारण साथ लिखा जाता है (`no --runtime supplied; L1-L3 not run`), और package दायरे में निष्कर्ष `incomplete` होकर exit `2` देता है। `--scope entry --entry-claim static` अब भी `DSH-ENTRY recognized` देता है, पर वह स्थिर घोषणा है; रनटाइम निर्णय के लिए `--runtime` या `--host` दें।
256
+
257
+ </details>
258
+
259
+ <details>
260
+ <summary>क्या यह मेरे पैकेज को छूता है? क्या मेरा कोड टूट सकता है?</summary>
261
+
262
+ जाँचकर्ता लक्ष्य डायरेक्टरी को केवल पढ़ता है, उसे कभी नहीं बदलता। रनटाइम जाँच चलने पर लोडिंग एक **चाइल्ड प्रोसेस** में होती है और टाइमआउट पर ज़बरदस्ती किल होती है (डिफ़ॉल्ट 10 सेकंड, `--timeout` से बदलें); किल `not-run` दर्ज होती है, PASS नहीं, और चाइल्ड जाँचकर्ता का अपना environment नहीं पढ़ सकता। कुछ भी नहीं चलाना हो तो `--no-exec` जोड़ें, केवल स्थिर निर्णय चाहिए तो `--static-only`।
263
+
264
+ </details>
265
+
266
+ <details>
267
+ <summary>guide / doctor / cert / portal / catalog से इसका क्या संबंध है?</summary>
268
+
269
+ यह रिपॉज़िटरी मानक पाठ के साथ जाँचकर्ता और स्तर-ऑडिट है; गद्य-मार्गदर्शिका `dsh-plugin-guide` में है, होस्ट अनुबंध का मापन `dsh-plugin-doctor` (clinic) में, और मार्केट व पोर्टल उपकरण अलग हैं। भूमिकाओं का बँटवारा और योगदान के रास्ते चीनी दस्तावेज़ `39` में हैं, और ऊपर की चयन-तालिका संक्षेप में बताती है कि कब कौन-सा टूल लें।
270
+
271
+ </details>
272
+
273
+ ## ज्ञात सीमाएँ
274
+
275
+ - **न प्रमाणन, न सुरक्षा-ऑडिट।** रिपोर्ट गुणवत्ता का संकेत है, अनुपालन का प्रमाण नहीं; `A–D` गुणवत्ता ग्रेड हैं, `ENTRY` / `FLOW` / `BOOST` नहीं।
276
+ - **कोई शुल्क नहीं, स्तरों की बिक्री नहीं, रैंकिंग की बिक्री नहीं।**
277
+ - **स्थिर को कभी रनटाइम के रूप में नहीं लिखा जाता।**
278
+ - **10/18 base-only को कभी 18/18 web/उत्पादन के रूप में नहीं लिखा जाता, और `client-module-loaded` को कभी UI या प्रमाणन के रूप में नहीं।**
279
+ - **आधिकारिक सिफ़ारिश या अपनाव, प्रमाणन, मान्यता या सुरक्षा-ऑडिट का दावा कभी नहीं।**
280
+ - **MVP कवरेज की कमी**: `--scope mvp` केवल 8 ID कवर करता है (`DSC-03/10/11/12/13` बाहर हैं); उसका निर्णय `subset: "MVP-13"` और `level: null` है और उसे DS-C बैज की तरह उपयोग नहीं करना चाहिए।
281
+ - **केवल पैकेज डायरेक्टरी**: लक्ष्य में `package.json` होना चाहिए; tarball समर्थन MVP का हिस्सा नहीं।
282
+ - **रनटाइम निर्णय की पूर्व-शर्तें**: `--runtime` या `--host` के बिना L1–L3 केवल `not-run` हो सकते हैं, और `--entry-claim static` कभी रनटाइम निर्णय नहीं देता।
283
+ - **निर्णय संस्करणों से बंधे हैं**: `commit` / `dsh` / `cordis` बदलें तो लकीर बदल जाती है; पुरानी रिपोर्ट नए संस्करण का साक्ष्य नहीं है।
284
+ - **BOOST के आँकड़े उत्पादन आधार-रेखा नहीं हैं**: LEV के 8/8 measured loader / context / provider-capture / synthetic timer वातावरण से आते हैं, और LEV-7 का 8.24× भी।
285
+ - **पाठ में बदलाव की घोषणा ज़रूरी**: इस रिपॉज़िटरी का पाठ कॉपी या बदलने पर स्पष्ट Change Notice देना होगा (स्रोत commit, कौन-सा खंड, क्या बदला, क्यों, तिथि), देखें [`MODIFICATION-POLICY.md`](MODIFICATION-POLICY.md); चिह्न और बैज ऊपर की लाइसेंसों से लाइसेंस नहीं होते, देखें `governance/mark-policy.md`।
286
+
287
+ ## विकास
288
+
289
+ ```sh
290
+ git clone https://github.com/PerryLink/dsh-standards.git
291
+ cd dsh-standards
292
+
293
+ node --test 40-checker/test/*.test.mjs # 128/128
294
+ node bin/dsh-standards.mjs 40-checker/fixtures/good \
295
+ --scope entry --entry-claim static --format text # fixture smoke
296
+ node bin/dsh-levels.mjs 40-checker/fixtures/good --format json
297
+
298
+ # सोर्स चेकआउट से सीधे जाँचकर्ता तक
299
+ node 40-checker/bin/dsh-plugin-verify.mjs <plugin-dir> --scope entry --entry-claim static
300
+ node 40-checker/bin/dsh-plugin-verify.mjs <bundle-dir> --scope entry \
301
+ --host /path/to/@deepseek-ai/dsh-app-boot/lib/index.js
302
+
303
+ node 40-checker/scripts/journey-runtime.mjs --package <dir> --json # J1 इंस्टॉल/अनइंस्टॉल सफ़र
304
+ node 40-checker/scripts/governance-check.mjs # शासन खंड
305
+ node 40-checker/scripts/attestation-check.mjs # मूल्यांकन रिकॉर्ड
306
+ node 40-checker/scripts/claim-check.mjs # घोषणा की निरंतरता
307
+ node 40-checker/scripts/dco-check.mjs --range HEAD~1..HEAD # DCO
308
+ node publish/verify.mjs --id DSH-ATT-2026-001 # नमूना रिकॉर्ड सत्यापित करें
309
+
310
+ cd examples/boost && node lev7-bench.mjs 64 20 # LEV-7 सीमित-समानांतरता बेंचमार्क
311
+ ```
312
+
313
+ README की छवियाँ [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) से कार्यक्रम-रूप में बनती हैं (Python + Pillow, हल्का और गहरा SVG) और कभी भी दोबारा बनाई जा सकती हैं: `python scripts/gen-readme-assets.py`.
314
+
315
+ ### डायरेक्टरी संरचना
316
+
317
+ ```text
318
+ 00-99*.md मानक / शोध / प्रोफ़ाइल / संचार दस्तावेज़
319
+ bin/ दो सार्वजनिक प्रवेश बिंदु: dsh-standards, dsh-levels
320
+ 40-checker/ जाँचकर्ता, J1 सफ़र, bundle smoke, नमूने, परिणाम
321
+ governance/ भूमिकाएँ, योगदान शर्तें, चिह्न नीति, अपील, COI, निर्णय-लॉग
322
+ adoption/ official / market / developer अपनाव पैक
323
+ spec/ levels.json + clauses.json + schemas (evidence / report / attestation)
324
+ scheme/ A–E / A–D मूल्यांकन योजना और rubric
325
+ evidence/ केवल-जुड़ने वाली साक्ष्य-श्रृंखला और दोबारा चलाने के निर्देश
326
+ examples/boost/ LEV-7 संदर्भ कार्यान्वयन और बेंचमार्क
327
+ publish/ labels के उदाहरण + मूल्यांकन रिकॉर्ड JSON
328
+ docs/ DEVELOPER-JOURNEY जैसे दीर्घकालिक दस्तावेज़ और README की छवियाँ
329
+ ```
330
+
331
+ ### शासन और योगदान
332
+
333
+ - भूमिकाएँ और अनुमतियाँ: `governance/roles.json`; एक-पृष्ठ सारांश: [GOVERNANCE.md](GOVERNANCE.md)
334
+ - योगदान: DCO 1.1 + DCT v1 (`dsh-ct/1`, कॉपीराइट हस्तांतरण नहीं बल्कि लाइसेंस), देखें [CONTRIBUTING.md](CONTRIBUTING.md)
335
+ - चिह्न: `governance/mark-policy.md` (स्वतः प्रदान, रद्द करने योग्य, अस्वीकरण अनिवार्य)
336
+ - अपील: `governance/appeals.md`; AI केवल प्राप्ति, समय-गणना और समीक्षा करता है, अंतिम निर्णय मनुष्य का
337
+ - तीन अपनाव पैक: `adoption/{official,market,developer}/`
338
+
339
+ ## परिवार और आभार
340
+
341
+ यह परियोजना [PerryLink](https://github.com/PerryLink) द्वारा संचालित DSH पारिस्थितिकी का एक सदस्य है: यह शाखा लकीर की है — मानक पाठ, जाँचकर्ता और स्तर-ऑडिट — जबकि मार्गदर्शिका, स्कैफ़ोल्डिंग, सत्यापन और पोर्टल उपकरणों की अपनी रिपॉज़िटरी हैं। अगर इसने आपको कुछ मैनुअल जाँचों से बचाया, तो **एक स्टार दें** — इससे कोई सुविधा नहीं खुलती, पर अगली बार प्लगइन जाँचने वाले को यह रिपॉज़िटरी खोजने में मदद मिलती है।
342
+
343
+ पहले का प्रोजेक्ट `dsh-plugin-standard` (lanbaolu) उसी पारिस्थितिकी का है और इस परियोजना से संबद्ध नहीं है; कोई भी उल्लेख या तुलना स्रोत बताएगी।
344
+
345
+ ## लाइसेंस
346
+
347
+ - **पाठ / मानक / दस्तावेज़ / अनुवाद**: CC BY 4.0 ([`LICENSE-CC-BY`](LICENSE-CC-BY)); बदलावों के साथ [`MODIFICATION-POLICY.md`](MODIFICATION-POLICY.md) के अनुसार Change Notice अनिवार्य;
348
+ - **कोड / स्क्रिप्ट / schema**: Apache-2.0 ([`LICENSE-APACHE`](LICENSE-APACHE), पेटेंट अनुदान और रक्षात्मक समाप्ति सहित);
349
+ - **चिह्न / बैज**: अलग नियम `governance/mark-policy.md` में, ऊपर की लाइसेंसों से प्रदान नहीं;
350
+ - **योगदान**: DCO 1.1 + DCT v1, कॉपीराइट हस्तांतरण आवश्यक नहीं।
351
+
352
+ <p align="center"><sub>CC BY 4.0 (पाठ) · Apache-2.0 (कोड) · सामुदायिक परियोजना, DeepSeek से असंबद्ध।</sub></p>