dsh-standards 0.0.2 → 1.0.0

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.

package/spec/levels.json

@@ -0,0 +1,371 @@
+{
+  "schema": "dsh-levels/1",
+  "version": "1.0.0-rc.1",
+  "status": "draft",
+  "updatedAt": "2026-11-01",
+  "nonOfficial": true,
+  "disclaimer": "Not an official DeepSeek standard, not a certification, not a security audit, and not a legal GB/GB-T/GB-Z instrument. The GB analogy is a communication aid only.",
+  "canonical": "https://github.com/PerryLink/dsh-standards",
+  "axes": {
+    "depth": [
+      "entry",
+      "flow",
+      "boost"
+    ],
+    "evidence": [
+      "not-run",
+      "recognized",
+      "static",
+      "runtime",
+      "measured",
+      "blocked",
+      "failed",
+      "stale"
+    ],
+    "rules": [
+      "Depth and evidence are independent; never collapse them into one score.",
+      "A skip is not a pass; not-run is not a pass; static is not runtime.",
+      "Certification grades A-D are orthogonal to these levels."
+    ]
+  },
+  "levels": [
+    {
+      "id": "entry",
+      "label": "DSH-ENTRY",
+      "analogy": "GB",
+      "question": "Can an existing plugin be recognized, installed, and booted without changing its code?",
+      "claim": "compatibility baseline",
+      "requiredForClaim": "G0-G5 at the recorded dsh/cordis versions; G4 is static, G5 is freshness",
+      "gates": [
+        {
+          "id": "G0",
+          "check": "dsh.bundle.patch parses",
+          "owner": "plugin"
+        },
+        {
+          "id": "G1",
+          "check": "base + sample compose; inserted row names resolve",
+          "owner": "plugin"
+        },
+        {
+          "id": "G2",
+          "check": "evaluatePluginCompatibility admits, or an explicit exact-version exemption applies",
+          "owner": "host"
+        },
+        {
+          "id": "G3",
+          "check": "real boot(): every target row is ACTIVE or disabled",
+          "owner": "plugin/host/fixture"
+        },
+        {
+          "id": "G4",
+          "check": "when dsh.client exists: exports['./client'] and a package-root row",
+          "owner": "plugin"
+        },
+        {
+          "id": "G5",
+          "check": "report carries runtime version/commit/artifact mtime; stale evidence is marked stale",
+          "owner": "process"
+        }
+      ],
+      "evidenceStates": [
+        "recognized",
+        "static",
+        "runtime",
+        "blocked",
+        "failed",
+        "not-run",
+        "stale"
+      ],
+      "notClaimed": [
+        "security",
+        "UI correctness",
+        "production readiness",
+        "official endorsement"
+      ],
+      "docs": [
+        "31-DSH-ENTRY入门规范.md",
+        "90-兼容运行时保证.md",
+        "92-兼容运行时实测.md"
+      ],
+      "machine": {
+        "checker": "40-checker/bin/dsh-plugin-verify.mjs --scope entry --entry-claim static|runtime",
+        "smoke": "40-checker/scripts/bundle-smoke.mjs",
+        "audit": "40-checker/scripts/level-audit.mjs",
+        "ci": ".github/workflows/entry18-runtime.yml"
+      }
+    },
+    {
+      "id": "flow",
+      "label": "DSH-FLOW",
+      "analogy": "GB/T",
+      "question": "Can a user install, configure, use, recover, upgrade, and uninstall the plugin without surprises?",
+      "claim": "recommended adoption",
+      "requiredForClaim": "J1-J8 with recorded evidence; manual journeys are allowed but must be marked manual",
+      "gates": [
+        {
+          "id": "J1",
+          "check": "install and remove: add -> dump-config -> remove; no hand-edited profile"
+        },
+        {
+          "id": "J2",
+          "check": "enable and disable: default on/off, stable id, dump diff is correct"
+        },
+        {
+          "id": "J3",
+          "check": "configuration: schema/defaults, invalid value fails loudly with a field path, volatile hot change"
+        },
+        {
+          "id": "J4",
+          "check": "first success: five-minute quickstart, readable error with three elements"
+        },
+        {
+          "id": "J5",
+          "check": "permissions and disclosure: capabilities/labels/commitments match README, forbidden words 0"
+        },
+        {
+          "id": "J6",
+          "check": "upgrade, rollback and uninstall: two versions, data preserved, rollback <=2 commands, no residue"
+        },
+        {
+          "id": "J7",
+          "check": "observability: start line name@version, diagnosable failure/pending, log path"
+        },
+        {
+          "id": "J8",
+          "check": "client/server shapes: headless/web/client-off work or are explicitly refused"
+        }
+      ],
+      "evidenceStates": [
+        "manual",
+        "runtime",
+        "not-run",
+        "failed",
+        "stale"
+      ],
+      "notClaimed": [
+        "certification",
+        "ranking",
+        "security review",
+        "every UI layout"
+      ],
+      "docs": [
+        "32-DSH-FLOW顺畅规范.md",
+        "94-开发建议-顺畅.md"
+      ],
+      "machine": {
+        "journey": "40-checker/scripts/journey.mjs",
+        "journeyRuntime": "40-checker/scripts/journey-runtime.mjs",
+        "audit": "40-checker/scripts/level-audit.mjs"
+      }
+    },
+    {
+      "id": "boost",
+      "label": "DSH-BOOST",
+      "analogy": "GB/Z",
+      "question": "Does the plugin use Cordis primitives (effect, inject, volatile, events, seams, jobs, bounded parallelism) to make development and use measurably cheaper?",
+      "claim": "guiding practice; evidence cards, no badge",
+      "requiredForClaim": "LEV-1..LEV-8 evidence cards with environment, input, command, negative control, result, version anchor, limitations",
+      "gates": [
+        {
+          "id": "LEV-1",
+          "check": "effects/timers/connections/watchers/subprocesses are registered as effects and return to baseline"
+        },
+        {
+          "id": "LEV-2",
+          "check": "required services are injected; optional ones use ctx.get; no polling"
+        },
+        {
+          "id": "LEV-3",
+          "check": "hot config uses volatile()/get(); config change does not remount"
+        },
+        {
+          "id": "LEV-4",
+          "check": "event modes match; waterfall observers call next(); notification listeners are isolated"
+        },
+        {
+          "id": "LEV-5",
+          "check": "seam/isolate/group used only when needed; per-agent ctx is honored"
+        },
+        {
+          "id": "LEV-6",
+          "check": "tool/prompt declarations are byte-stable; volatile data goes through systemPrompt.context"
+        },
+        {
+          "id": "LEV-7",
+          "check": "independent calls use bounded parallelism; long work uses jobs; cancellation propagates"
+        },
+        {
+          "id": "LEV-8",
+          "check": "bundle patch/preset expresses differences; every practice has an evidence card"
+        }
+      ],
+      "evidenceStates": [
+        "measured",
+        "not-measured",
+        "failed",
+        "stale"
+      ],
+      "notClaimed": [
+        "production benchmark",
+        "billing/cache-hit rate",
+        "total score",
+        "ranking"
+      ],
+      "docs": [
+        "33-DSH-BOOST加速实践.md",
+        "95-开发建议-加速.md",
+        "examples/boost/LEV-3-6.md"
+      ],
+      "machine": {
+        "lev3": "examples/boost/lev3-loader-bench.mjs",
+        "lev6": "examples/boost/lev6-capture-server.mjs",
+        "lev7": "examples/boost/lev7-bench.mjs",
+        "audit": "40-checker/scripts/level-audit.mjs"
+      }
+    }
+  ],
+  "crosswalk": {
+    "dsh-plugin-doctor": {
+      "repo": "https://github.com/PerryLink/dsh-plugin-doctor",
+      "entry": [
+        "R",
+        "K",
+        "D",
+        "X"
+      ],
+      "flow": "not-covered",
+      "boost": "not-covered",
+      "note": "Doctor maps its R/K/D/X results to an ENTRY status; it does not run J1-J8 or LEV benchmarks."
+    },
+    "dsh-plugin-certification": {
+      "repo": "https://github.com/PerryLink/dsh-plugin-certification",
+      "entry": [
+        "manifest",
+        "installSmoke",
+        "securityVeto"
+      ],
+      "flow": "not-covered",
+      "boost": "not-covered",
+      "note": "Grade A-D is orthogonal; certification evidence is necessary but not sufficient for ENTRY runtime."
+    },
+    "dsh-plugin-guide": {
+      "repo": "https://github.com/PerryLink/dsh-plugin-guide",
+      "entry": [
+        "guide/standards.md",
+        "SKILL.md"
+      ],
+      "flow": [
+        "guide/standards.md",
+        "plugin-dev-guide.md"
+      ],
+      "boost": [
+        "guide/standards.md",
+        "plugin-dev-guide.md"
+      ],
+      "note": "The guide teaches the levels and routes authors to the checker/audit; it does not certify."
+    },
+    "dsh-plugin-kit": {
+      "repo": "https://github.com/PerryLink/dsh-plugin-kit",
+      "entry": [
+        "data/peer-range.json",
+        "skeleton"
+      ],
+      "flow": "not-covered",
+      "boost": "not-covered",
+      "note": "Kit supplies the shared peer range and skeleton; it can carry level metadata in a future release."
+    },
+    "dsh-test-drive": {
+      "repo": "https://github.com/PerryLink/dsh-test-drive",
+      "entry": [
+        "install smoke"
+      ],
+      "flow": "not-covered",
+      "boost": "not-covered",
+      "note": "Test-drive is the install/load evidence source for ENTRY and certification dimension E."
+    },
+    "dsh-score": {
+      "repo": "https://github.com/PerryLink/dsh-score",
+      "entry": [
+        "consumes test-drive"
+      ],
+      "flow": "not-covered",
+      "boost": "not-covered",
+      "note": "Score is a quality summary; it must not label a plugin with a DSH level."
+    },
+    "dsh-plugin-portal": {
+      "repo": "https://github.com/PerryLink/dsh-plugin-portal",
+      "entry": "display-only",
+      "flow": "display-only",
+      "boost": "display-only",
+      "note": "A portal displays labels; it must not derive a level from stars or ratings."
+    },
+    "dsh-catalog": {
+      "repo": "https://github.com/PerryLink/dsh-catalog",
+      "entry": "display-only",
+      "flow": "display-only",
+      "boost": "display-only",
+      "note": "A market catalog may display evidence-backed labels; no label without a link."
+    },
+    "dsh-checkers": {
+      "repo": "https://github.com/PerryLink/dsh-checkers",
+      "entry": [
+        "static checks"
+      ],
+      "flow": "not-covered",
+      "boost": "not-covered",
+      "note": "A 53-checker bundle; it feeds ENTRY static, not runtime G0-G3."
+    },
+    "dsh-policy-ledger": {
+      "repo": "https://github.com/PerryLink/dsh-policy-ledger",
+      "entry": [
+        "install diagnosis"
+      ],
+      "flow": "not-covered",
+      "boost": "not-covered",
+      "note": "Install-only diagnosis; maps failures to G0/G2/G3 attribution."
+    },
+    "dsh-cert-mcp": {
+      "repo": "https://github.com/PerryLink/dsh-cert-mcp",
+      "entry": "not-applicable",
+      "flow": "not-applicable",
+      "boost": "not-applicable",
+      "note": "Read-only MCP over the certification registry; it does not assign levels."
+    }
+  },
+  "labels": {
+    "entry": {
+      "recognized": "dsh-entry:recognized",
+      "runtime": "dsh-entry:runtime",
+      "blocked": "dsh-entry:blocked",
+      "failed": "dsh-entry:failed"
+    },
+    "flow": {
+      "manual": "dsh-flow:manual",
+      "runtime": "dsh-flow:runtime",
+      "not-run": "dsh-flow:not-run"
+    },
+    "boost": {
+      "measured": "dsh-boost:measured",
+      "not-measured": "dsh-boost:not-measured"
+    }
+  },
+  "review": {
+    "provisionalWhileSolo": true,
+    "expiryDays": {
+      "entry": 90,
+      "flow": 180,
+      "boost": 365
+    },
+    "evidenceMustCarry": [
+      "level",
+      "levelVersion",
+      "dshVersion",
+      "cordisVersion",
+      "commit",
+      "generatedAt",
+      "scope",
+      "notClaimed"
+    ]
+  }
+}

package/spec/levels.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/PerryLink/dsh-standards/spec/levels.schema.json",
+  "title": "DSH levels (non-official)",
+  "type": "object",
+  "required": ["schema", "version", "nonOfficial", "levels"],
+  "properties": {
+    "schema": { "const": "dsh-levels/1" },
+    "version": { "type": "string" },
+    "status": { "enum": ["draft", "provisional", "stable", "stale"] },
+    "nonOfficial": { "const": true },
+    "disclaimer": { "type": "string" },
+    "axes": { "type": "object" },
+    "levels": {
+      "type": "array",
+      "minItems": 3,
+      "items": {
+        "type": "object",
+        "required": ["id", "label", "analogy", "question", "claim", "gates", "evidenceStates"],
+        "properties": {
+          "id": { "enum": ["entry", "flow", "boost"] },
+          "label": { "enum": ["DSH-ENTRY", "DSH-FLOW", "DSH-BOOST"] },
+          "analogy": { "enum": ["GB", "GB/T", "GB/Z"] },
+          "question": { "type": "string" },
+          "claim": { "type": "string" },
+          "gates": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["id", "check"],
+              "properties": { "id": { "type": "string" }, "check": { "type": "string" }, "owner": { "type": "string" } }
+            }
+          },
+          "evidenceStates": { "type": "array", "items": { "type": "string" } },
+          "notClaimed": { "type": "array", "items": { "type": "string" } }
+        },
+        "additionalProperties": true
+      }
+    },
+    "crosswalk": { "type": "object" },
+    "labels": { "type": "object" },
+    "review": { "type": "object" }
+  },
+  "additionalProperties": true
+}