dsh-standards 0.0.3 → 1.0.1

package/package.json

@@ -1,20 +1,66 @@
 {
   "name": "dsh-standards",
-  "version": "0.0.3",
-  "description": "Name reservation; canonical draft at https://github.com/PerryLink/dsh-standard (private).",
-  "license": "MIT",
-  "private": false,
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/PerryLink/dsh-standard.git"
+  "version": "1.0.1",
+  "description": "DSH plugin standards and conformance checks: ENTRY/FLOW checks plus BOOST guidance. Non-official; no certification or ranking.",
+  "type": "module",
+  "main": "40-checker/src/index.mjs",
+  "exports": {
+    ".": "./40-checker/src/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "dsh-standards": "./bin/dsh-standards.mjs",
+    "dsh-levels": "./bin/dsh-levels.mjs"
+  },
+  "files": [
+    "bin",
+    "40-checker/bin",
+    "40-checker/src",
+    "40-checker/scripts",
+    "40-checker/samples",
+    "40-checker/fixtures",
+    "40-checker/test",
+    "40-checker/package.json",
+    "40-checker/README.md",
+    "spec",
+    "docs",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "LICENSE-APACHE",
+    "LICENSE-CC-BY",
+    "NOTICE.md",
+    "NOTICE"
+  ],
+  "scripts": {
+    "test": "node --test 40-checker/test/*.test.mjs",
+    "test:fixtures": "node bin/dsh-standards.mjs 40-checker/fixtures/good --scope entry --entry-claim static --format text"
+  },
+  "engines": {
+    "node": ">=24.9.0"
   },
-  "homepage": "https://github.com/PerryLink/dsh-standard",
   "keywords": [
     "dsh",
+    "dsh-plugin",
     "deepseek-harness",
-    "plugin"
+    "cordis",
+    "standards",
+    "checker",
+    "conformance",
+    "entry",
+    "flow",
+    "boost"
   ],
-  "files": [
-    "README.md"
-  ]
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PerryLink/dsh-standards.git"
+  },
+  "homepage": "https://github.com/PerryLink/dsh-standards#readme",
+  "bugs": {
+    "url": "https://github.com/PerryLink/dsh-standards/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/spec/README.md

@@ -0,0 +1,27 @@
+# dsh-standards specification tree
+
+One project, three adoption levels. Each level has its own maturity; they share
+the glossary, evidence anchor, and checker.
+
+| Level | Document | Maturity | Evidence |
+|---|---|---|---|
+| ENTRY | [../31-DSH-ENTRY入门规范.md](../31-DSH-ENTRY入门规范.md) | public-preview | 18/18 recognized; 10/18 base G3, 8 clean after gate; client 15/15 loaded |
+| FLOW | [../32-DSH-FLOW顺畅规范.md](../32-DSH-FLOW顺畅规范.md) | draft | J1/J2/J4/J6 runtime on fixture; 5 real packages; J3/J5/J7/J8 not-run |
+| BOOST | [../33-DSH-BOOST加速实践.md](../33-DSH-BOOST加速实践.md) | draft | LEV-1–8 8/8 measured at synthetic/loader/provider-capture level |
+
+Machine-readable:
+
+- [levels.json](levels.json) — levels, gates, evidence states, crosswalk.
+- [clauses.json](clauses.json) — stable clause IDs mapped to gates (`clause-map.mjs`).
+- [reference-suite.json](reference-suite.json) — versioned samples, anchors, change rules.
+- [schemas/evidence.schema.json](schemas/evidence.schema.json) — `dsh-levels/1` record.
+- [schemas/attestation.schema.json](schemas/attestation.schema.json) — `dsh-attestation/1` quality record.
+- [schemas/report.schema.json](schemas/report.schema.json) — `dsh-report/1` inspection report (no grade).
+- [../40-checker/scripts/level-audit.mjs](../40-checker/scripts/level-audit.mjs) — one-command audit.
+- [../publish/level-labels.example.json](../publish/level-labels.example.json) — market labels.
+
+Rules:
+
+- Levels depend on `common` only; do not import each other.
+- A level is not a certification, badge, grade, or score.
+- `dsh-standard` is an alias; `dsh-standards` is canonical.

package/spec/boost/README.md

@@ -0,0 +1,8 @@
+# BOOST
+
+Leverage surface: Cordis-native practices with evidence, not a grade.
+
+- Practice text: [../../33-DSH-BOOST加速实践.md](../../33-DSH-BOOST加速实践.md)
+- Deep research: [../../91-增效实践内核研究.md](../../91-增效实践内核研究.md)
+- Reference: `examples/boost/lev7-bounded-batch.mjs`; benchmark: `examples/boost/results/lev7.json`
+- Current: LEV-3 loader-level 0/20 vs 20/20 remount; LEV-6 provider-capture 100% vs 0% prompt reuse; LEV-7 8.24× synthetic. None is a production baseline.

package/spec/clauses.json

@@ -0,0 +1,253 @@
+{
+  "schema": "dsh-clauses/1",
+  "version": "1.0.0-rc.1",
+  "updatedAt": "2026-11-02",
+  "note": "Stable clause IDs mapped to the gates in spec/levels.json. The source anchor is a section, not a line number, so edits do not silently break the map.",
+  "clauses": [
+    {
+      "id": "ENTRY-RUNSET",
+      "level": "entry",
+      "title": "Run set and coverage",
+      "source": "31-DSH-ENTRY入门规范.md#21-run-set",
+      "gates": [
+        "G0",
+        "G1",
+        "G3"
+      ],
+      "normative": true
+    },
+    {
+      "id": "ENTRY-BLOCKING",
+      "level": "entry",
+      "title": "Blocking conditions",
+      "source": "31-DSH-ENTRY入门规范.md#22-blocking",
+      "gates": [
+        "G2"
+      ],
+      "normative": true
+    },
+    {
+      "id": "ENTRY-KIND",
+      "level": "entry",
+      "title": "Per-kind execution",
+      "source": "31-DSH-ENTRY入门规范.md#23-按-kind-的运行",
+      "gates": [
+        "G0",
+        "G1"
+      ],
+      "normative": true
+    },
+    {
+      "id": "ENTRY-STATUS",
+      "level": "entry",
+      "title": "Conclusion states",
+      "source": "31-DSH-ENTRY入门规范.md#24-结论状态",
+      "gates": [
+        "G3",
+        "G5"
+      ],
+      "normative": true
+    },
+    {
+      "id": "ENTRY-CLIENT",
+      "level": "entry",
+      "title": "Client static shape",
+      "source": "31-DSH-ENTRY入门规范.md#23-按-kind-的运行",
+      "gates": [
+        "G4"
+      ],
+      "normative": true
+    },
+    {
+      "id": "ENTRY-BOUNDARY",
+      "level": "entry",
+      "title": "Boundary and non-claims",
+      "source": "31-DSH-ENTRY入门规范.md#五边界",
+      "gates": [
+        "G5"
+      ],
+      "normative": true
+    },
+    {
+      "id": "FLOW-J1",
+      "level": "flow",
+      "title": "Install and remove",
+      "source": "32-DSH-FLOW顺畅规范.md#三j1j8-判定协议",
+      "gates": [
+        "J1"
+      ],
+      "normative": true
+    },
+    {
+      "id": "FLOW-J2",
+      "level": "flow",
+      "title": "Enable and disable",
+      "source": "32-DSH-FLOW顺畅规范.md#三j1j8-判定协议",
+      "gates": [
+        "J2"
+      ],
+      "normative": true
+    },
+    {
+      "id": "FLOW-J3",
+      "level": "flow",
+      "title": "Configuration",
+      "source": "32-DSH-FLOW顺畅规范.md#三j1j8-判定协议",
+      "gates": [
+        "J3"
+      ],
+      "normative": true
+    },
+    {
+      "id": "FLOW-J4",
+      "level": "flow",
+      "title": "First success",
+      "source": "32-DSH-FLOW顺畅规范.md#三j1j8-判定协议",
+      "gates": [
+        "J4"
+      ],
+      "normative": true
+    },
+    {
+      "id": "FLOW-J5",
+      "level": "flow",
+      "title": "Permissions and disclosure",
+      "source": "32-DSH-FLOW顺畅规范.md#43-权限文案",
+      "gates": [
+        "J5"
+      ],
+      "normative": true
+    },
+    {
+      "id": "FLOW-J6",
+      "level": "flow",
+      "title": "Upgrade, rollback, uninstall",
+      "source": "32-DSH-FLOW顺畅规范.md#三j1j8-判定协议",
+      "gates": [
+        "J6"
+      ],
+      "normative": true
+    },
+    {
+      "id": "FLOW-J7",
+      "level": "flow",
+      "title": "Observability and diagnostics",
+      "source": "32-DSH-FLOW顺畅规范.md#三j1j8-判定协议",
+      "gates": [
+        "J7"
+      ],
+      "normative": true
+    },
+    {
+      "id": "FLOW-J8",
+      "level": "flow",
+      "title": "Client/server shapes",
+      "source": "32-DSH-FLOW顺畅规范.md#三j1j8-判定协议",
+      "gates": [
+        "J8"
+      ],
+      "normative": true
+    },
+    {
+      "id": "BOOST-LEV1",
+      "level": "boost",
+      "title": "Reversible effects",
+      "source": "33-DSH-BOOST加速实践.md#二八条-lev",
+      "gates": [
+        "LEV-1"
+      ],
+      "normative": false
+    },
+    {
+      "id": "BOOST-LEV2",
+      "level": "boost",
+      "title": "Inject and wait",
+      "source": "33-DSH-BOOST加速实践.md#二八条-lev",
+      "gates": [
+        "LEV-2"
+      ],
+      "normative": false
+    },
+    {
+      "id": "BOOST-LEV3",
+      "level": "boost",
+      "title": "Volatile hot config",
+      "source": "33-DSH-BOOST加速实践.md#二八条-lev",
+      "gates": [
+        "LEV-3"
+      ],
+      "normative": false
+    },
+    {
+      "id": "BOOST-LEV4",
+      "level": "boost",
+      "title": "Event modes",
+      "source": "33-DSH-BOOST加速实践.md#二八条-lev",
+      "gates": [
+        "LEV-4"
+      ],
+      "normative": false
+    },
+    {
+      "id": "BOOST-LEV5",
+      "level": "boost",
+      "title": "Seam, isolate, group",
+      "source": "33-DSH-BOOST加速实践.md#二八条-lev",
+      "gates": [
+        "LEV-5"
+      ],
+      "normative": false
+    },
+    {
+      "id": "BOOST-LEV6",
+      "level": "boost",
+      "title": "Prefix and prompt stability",
+      "source": "33-DSH-BOOST加速实践.md#二八条-lev",
+      "gates": [
+        "LEV-6"
+      ],
+      "normative": false
+    },
+    {
+      "id": "BOOST-LEV7",
+      "level": "boost",
+      "title": "Bounded parallelism and jobs",
+      "source": "33-DSH-BOOST加速实践.md#二八条-lev",
+      "gates": [
+        "LEV-7"
+      ],
+      "normative": false
+    },
+    {
+      "id": "BOOST-LEV8",
+      "level": "boost",
+      "title": "Composition and evidence card",
+      "source": "33-DSH-BOOST加速实践.md#二八条-lev",
+      "gates": [
+        "LEV-8"
+      ],
+      "normative": false
+    },
+    {
+      "id": "BOOST-G10",
+      "level": "boost",
+      "title": "G-10 boundary",
+      "source": "33-DSH-BOOST加速实践.md#三g-10-的边界",
+      "gates": [
+        "LEV-8"
+      ],
+      "normative": false
+    },
+    {
+      "id": "BOOST-EVIDENCE",
+      "level": "boost",
+      "title": "Evidence card",
+      "source": "33-DSH-BOOST加速实践.md#四证据卡",
+      "gates": [
+        "LEV-8"
+      ],
+      "normative": false
+    }
+  ],
+  "normativeCount": 14
+}

package/spec/entry/README.md

@@ -0,0 +1,9 @@
+# ENTRY
+
+Compatibility surface: can an existing plugin be recognized/installed and at
+least run?
+
+- Normative text: [../../31-DSH-ENTRY入门规范.md](../../31-DSH-ENTRY入门规范.md)
+- External portrait: [../../99-DSH-ENTRY兼容性画像-对外版.md](../../99-DSH-ENTRY兼容性画像-对外版.md)
+- Checker: `node 40-checker/bin/dsh-plugin-verify.mjs <dir> --scope entry --entry-claim static|runtime`
+- Current: 18/18 recognized, 0 clean; 18/18 base-only runtime JSON; 10 G3 verified / 8 partial; after gate 8 clean + 2 reject + 8 partial; client 15/15 loaded in the web profile.

package/spec/flow/README.md

@@ -0,0 +1,8 @@
+# FLOW
+
+Usability surface: install, configure, first success, permissions, upgrade,
+uninstall, diagnostics, client/server states.
+
+- Normative text: [../../32-DSH-FLOW顺畅规范.md](../../32-DSH-FLOW顺畅规范.md)
+- Journeys: J1–J8; only J1 has a runtime harness (`40-checker/scripts/journey-runtime.mjs`).
+- Current: J1 6 PASS + 1 WARN; J2–J8 not-run.