dsh-plugin-guide 0.4.4 → 0.4.6

package/docs/assets/dsh-plugin-guide-flow-v3-light.svg

@@ -0,0 +1,82 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1100" height="660" viewBox="0 0 1100 660" role="img" aria-label="dsh-plugin-guide assembly and routing">
+<defs>
+  <linearGradient id="lineGrad" x1="0" y1="0" x2="1" y2="0">
+    <stop offset="0" stop-color="#4B67B4" stop-opacity=".15"/>
+    <stop offset=".5" stop-color="#4B67B4" stop-opacity=".9"/>
+    <stop offset="1" stop-color="#4B67B4" stop-opacity=".15"/>
+  </linearGradient>
+  <filter id="soft" x="-40%" y="-40%" width="180%" height="200%">
+    <feDropShadow dx="0" dy="9" stdDeviation="12" flood-color="#1b1735" flood-opacity="0.10"/>
+  </filter>
+  <pattern id="dots" width="28" height="28" patternUnits="userSpaceOnUse">
+    <circle cx="1.3" cy="1.3" r="1.3" fill="#f2f0f8"/>
+  </pattern>
+</defs>
+<rect width="1100" height="660" fill="#ffffff"/>
+<rect width="1100" height="660" fill="url(#dots)" opacity=".5"/>
+<text x="50" y="62" fill="#141419" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="32" font-weight="700">dsh-plugin-guide</text>
+<text x="50" y="90" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="16">assembly and routing · the guide asks, dsh-standards decides</text>
+<rect x="50" y="108" width="1000" height="1.6" rx="1" fill="#e6e3f0"/>
+<g filter="url(#soft)">
+  <rect x="50" y="190" width="176" height="118" rx="17" fill="#fcfcfe" stroke="#e6e3f0" stroke-width="1.3"/>
+</g>
+<circle cx="74" cy="214" r="12" fill="#ece7f9"/>
+<text x="74" y="219" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="11.5" font-weight="700">01</text>
+<text x="138.0" y="256" text-anchor="middle" fill="#141419" font-family="ui-monospace, monospace" font-size="15.5" font-weight="700">cordis.patch.yml</text>
+<text x="138.0" y="282" text-anchor="middle" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">one inserted row</text>
+<path d="M231 249.0 C241.0 249.0, 241.0 249.0, 251 249.0" stroke="url(#lineGrad)" stroke-width="2.2" fill="none"/>
+<path d="M241 244.0 l8 5 -8 5" fill="none" stroke="#4B67B4" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"/>
+<g filter="url(#soft)">
+  <rect x="256" y="190" width="176" height="118" rx="17" fill="#fcfcfe" stroke="#4B67B4" stroke-width="2.6"/>
+</g>
+<circle cx="280" cy="214" r="12" fill="#ece7f9"/>
+<text x="280" y="219" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="11.5" font-weight="700">02</text>
+<text x="344.0" y="256" text-anchor="middle" fill="#141419" font-family="ui-monospace, monospace" font-size="15.5" font-weight="700">index.js</text>
+<text x="344.0" y="282" text-anchor="middle" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">ctx.skills.register</text>
+<path d="M437 249.0 C447.0 249.0, 447.0 249.0, 457 249.0" stroke="url(#lineGrad)" stroke-width="2.2" fill="none"/>
+<path d="M447 244.0 l8 5 -8 5" fill="none" stroke="#4B67B4" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"/>
+<g filter="url(#soft)">
+  <rect x="462" y="190" width="176" height="118" rx="17" fill="#fcfcfe" stroke="#e6e3f0" stroke-width="1.3"/>
+</g>
+<circle cx="486" cy="214" r="12" fill="#ece7f9"/>
+<text x="486" y="219" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="11.5" font-weight="700">03</text>
+<text x="550.0" y="256" text-anchor="middle" fill="#141419" font-family="ui-monospace, monospace" font-size="15.5" font-weight="700">SKILL.md</text>
+<text x="550.0" y="282" text-anchor="middle" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">the skill body</text>
+<path d="M643 249.0 C653.0 249.0, 653.0 249.0, 663 249.0" stroke="url(#lineGrad)" stroke-width="2.2" fill="none"/>
+<path d="M653 244.0 l8 5 -8 5" fill="none" stroke="#4B67B4" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"/>
+<g filter="url(#soft)">
+  <rect x="668" y="190" width="176" height="118" rx="17" fill="#fcfcfe" stroke="#e6e3f0" stroke-width="1.3"/>
+</g>
+<circle cx="692" cy="214" r="12" fill="#ece7f9"/>
+<text x="692" y="219" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="11.5" font-weight="700">04</text>
+<text x="756.0" y="256" text-anchor="middle" fill="#141419" font-family="ui-monospace, monospace" font-size="15.5" font-weight="700">docs/levels.md</text>
+<text x="756.0" y="282" text-anchor="middle" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">ENTRY / FLOW / BOOST</text>
+<path d="M849 249.0 C859.0 249.0, 859.0 249.0, 869 249.0" stroke="url(#lineGrad)" stroke-width="2.2" fill="none"/>
+<path d="M859 244.0 l8 5 -8 5" fill="none" stroke="#4B67B4" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"/>
+<g filter="url(#soft)">
+  <rect x="874" y="190" width="176" height="118" rx="17" fill="#fcfcfe" stroke="#16a34a" stroke-width="2.6"/>
+</g>
+<circle cx="898" cy="214" r="12" fill="#ece7f9"/>
+<text x="898" y="219" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="11.5" font-weight="700">05</text>
+<text x="962.0" y="256" text-anchor="middle" fill="#141419" font-family="ui-monospace, monospace" font-size="15.5" font-weight="700">dsh-standards</text>
+<text x="962.0" y="282" text-anchor="middle" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">dsh-levels verdict</text>
+<g filter="url(#soft)">
+  <rect x="256" y="378" width="176" height="58" rx="15" fill="#ece7f9" stroke="#4B67B4" stroke-width="1.2"/>
+</g>
+<text x="344" y="404" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="13" font-weight="700">ENTRY</text>
+<text x="344" y="423" text-anchor="middle" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">installs</text>
+<g filter="url(#soft)">
+  <rect x="462" y="378" width="176" height="58" rx="15" fill="#ece7f9" stroke="#4B67B4" stroke-width="1.2"/>
+</g>
+<text x="550" y="404" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="13" font-weight="700">FLOW</text>
+<text x="550" y="423" text-anchor="middle" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">works daily</text>
+<g filter="url(#soft)">
+  <rect x="668" y="378" width="176" height="58" rx="15" fill="#ece7f9" stroke="#4B67B4" stroke-width="1.2"/>
+</g>
+<text x="756" y="404" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="13" font-weight="700">BOOST</text>
+<text x="756" y="423" text-anchor="middle" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">faster</text>
+<rect x="50" y="476" width="1000" height="58" rx="15" fill="#fcfcfe" stroke="#e6e3f0"/>
+<text x="74" y="502" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="13" font-weight="700">route / dsh-levels</text>
+<text x="74" y="522" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="13">the guide explains what to check; the verdict belongs to dsh-standards</text>
+<text x="50" y="596" fill="#4d5261" font-family="ui-monospace, monospace" font-size="13">Apache-2.0 · PerryLink DSH plugin family</text>
+</svg>

package/docs/assets/dsh-plugin-guide-flow-v4-dark.svg

@@ -0,0 +1,55 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1100" height="660" viewBox="0 0 1100 660" role="img" aria-label="dsh-plugin-guide three-level ladder ending in a routing arrow">
+<defs>
+  <filter id="soft" x="-40%" y="-40%" width="180%" height="200%">
+    <feDropShadow dx="0" dy="9" stdDeviation="12" flood-color="#1b1735" flood-opacity="0.55"/>
+  </filter>
+  <pattern id="dots" width="28" height="28" patternUnits="userSpaceOnUse">
+    <circle cx="1.3" cy="1.3" r="1.3" fill="#182031"/>
+  </pattern>
+  <marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+    <path d="M0 0 L10 5 L0 10 z" fill="#3fb950"/>
+  </marker>
+</defs>
+<rect width="1100" height="660" fill="#0d1117"/>
+<rect width="1100" height="660" fill="url(#dots)" opacity=".5"/>
+<text x="50" y="58" fill="#f0f3f9" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="32" font-weight="700">dsh-plugin-guide</text>
+<text x="50" y="86" fill="#a8b1c4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="16">three levels, deepening questions · the guide asks, dsh-standards decides</text>
+<text x="50" y="122" fill="#8496f5" font-family="ui-sans-serif, system-ui, sans-serif" font-size="14" font-weight="700" letter-spacing="1.5">ADOPTION DEPTH</text>
+<line x1="38" y1="150" x2="38" y2="482" stroke="#8496f5" stroke-width="2" stroke-dasharray="4 6" opacity=".6"/>
+
+<rect x="50" y="150" width="392" height="92" rx="18" fill="#161b26" stroke="#2a3142" stroke-width="1.3" filter="url(#soft)"/>
+<circle cx="82" cy="196" r="17" fill="#242d42"/>
+<text x="82" y="202" text-anchor="middle" fill="#8496f5" font-family="ui-monospace, monospace" font-size="14" font-weight="700">1</text>
+<text x="116" y="186" fill="#f0f3f9" font-family="ui-monospace, monospace" font-size="20" font-weight="700">ENTRY</text>
+<text x="116" y="210" fill="#a8b1c4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="15">入门 · 6 个问题</text>
+<text x="116" y="230" fill="#737b8d" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">能装上、能跑、不崩</text>
+<line x1="38" y1="196" x2="50" y2="196" stroke="#8496f5" stroke-width="1.6" opacity=".35"/>
+<rect x="84" y="268" width="392" height="92" rx="18" fill="#161b26" stroke="#2a3142" stroke-width="1.3" filter="url(#soft)"/>
+<circle cx="116" cy="314" r="17" fill="#242d42"/>
+<text x="116" y="320" text-anchor="middle" fill="#8496f5" font-family="ui-monospace, monospace" font-size="14" font-weight="700">2</text>
+<text x="150" y="304" fill="#f0f3f9" font-family="ui-monospace, monospace" font-size="20" font-weight="700">FLOW</text>
+<text x="150" y="328" fill="#a8b1c4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="15">顺畅 · 7 个问题</text>
+<text x="150" y="348" fill="#737b8d" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">日常任务顺、错误可恢复</text>
+<line x1="38" y1="314" x2="84" y2="314" stroke="#8496f5" stroke-width="1.6" opacity=".35"/>
+<rect x="118" y="386" width="392" height="92" rx="18" fill="#161b26" stroke="#8496f5" stroke-width="2.4" filter="url(#soft)"/>
+<circle cx="150" cy="432" r="17" fill="#242d42"/>
+<text x="150" y="438" text-anchor="middle" fill="#8496f5" font-family="ui-monospace, monospace" font-size="14" font-weight="700">3</text>
+<text x="184" y="422" fill="#f0f3f9" font-family="ui-monospace, monospace" font-size="20" font-weight="700">BOOST</text>
+<text x="184" y="446" fill="#a8b1c4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="15">加速 · 5 个问题</text>
+<text x="184" y="466" fill="#737b8d" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">提效证据可复现</text>
+<line x1="38" y1="432" x2="118" y2="432" stroke="#8496f5" stroke-width="1.6" opacity=".35"/>
+<path d="M510 432 L690 432" stroke="#3fb950" stroke-width="2.6" fill="none" marker-end="url(#arr)"/>
+<text x="512" y="418" fill="#3fb950" font-family="ui-sans-serif, system-ui, sans-serif" font-size="13">verdict to</text>
+<rect x="700" y="300" width="350" height="264" rx="20" fill="#161b26" stroke="#3fb950" stroke-width="2.4" filter="url(#soft)"/>
+<text x="726" y="334" fill="#3fb950" font-family="ui-monospace, monospace" font-size="13" font-weight="700">dsh-standards</text>
+<text x="726" y="366" fill="#f0f3f9" font-family="ui-sans-serif, system-ui, sans-serif" font-size="17">DSC-01...13 static checks</text>
+<text x="726" y="394" fill="#f0f3f9" font-family="ui-sans-serif, system-ui, sans-serif" font-size="17">L1-L3 runtime measurement</text>
+<text x="726" y="422" fill="#f0f3f9" font-family="ui-sans-serif, system-ui, sans-serif" font-size="17">dsh-levels verdict</text>
+<line x1="726" y1="444" x2="1024" y2="444" stroke="#182031" stroke-width="2"/>
+<text x="726" y="470" fill="#a8b1c4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="13">certification, scoring, ranking: none of them here</text>
+<text x="726" y="494" fill="#737b8d" font-family="ui-monospace, monospace" font-size="12">guide asks · standards decides</text>
+<text x="726" y="530" fill="#8496f5" font-family="ui-monospace, monospace" font-size="12">ENTRY / FLOW / BOOST</text>
+<rect x="50" y="560" width="1000" height="52" rx="14" fill="#121824" stroke="#2a3142"/>
+<text x="74" y="582" fill="#8496f5" font-family="ui-monospace, monospace" font-size="12.5" font-weight="700">route / dsh-levels</text>
+<text x="74" y="602" fill="#a8b1c4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="13">every question has an owner: the guide says what to check, the verdict belongs to the checker</text>
+</svg>

package/docs/assets/dsh-plugin-guide-flow-v4-light.svg

@@ -0,0 +1,55 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1100" height="660" viewBox="0 0 1100 660" role="img" aria-label="dsh-plugin-guide three-level ladder ending in a routing arrow">
+<defs>
+  <filter id="soft" x="-40%" y="-40%" width="180%" height="200%">
+    <feDropShadow dx="0" dy="9" stdDeviation="12" flood-color="#1b1735" flood-opacity="0.10"/>
+  </filter>
+  <pattern id="dots" width="28" height="28" patternUnits="userSpaceOnUse">
+    <circle cx="1.3" cy="1.3" r="1.3" fill="#f2f0f8"/>
+  </pattern>
+  <marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+    <path d="M0 0 L10 5 L0 10 z" fill="#16a34a"/>
+  </marker>
+</defs>
+<rect width="1100" height="660" fill="#ffffff"/>
+<rect width="1100" height="660" fill="url(#dots)" opacity=".5"/>
+<text x="50" y="58" fill="#141419" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="32" font-weight="700">dsh-plugin-guide</text>
+<text x="50" y="86" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="16">three levels, deepening questions · the guide asks, dsh-standards decides</text>
+<text x="50" y="122" fill="#4B67B4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="14" font-weight="700" letter-spacing="1.5">ADOPTION DEPTH</text>
+<line x1="38" y1="150" x2="38" y2="482" stroke="#4B67B4" stroke-width="2" stroke-dasharray="4 6" opacity=".6"/>
+
+<rect x="50" y="150" width="392" height="92" rx="18" fill="#ffffff" stroke="#e6e3f0" stroke-width="1.3" filter="url(#soft)"/>
+<circle cx="82" cy="196" r="17" fill="#ece7f9"/>
+<text x="82" y="202" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="14" font-weight="700">1</text>
+<text x="116" y="186" fill="#141419" font-family="ui-monospace, monospace" font-size="20" font-weight="700">ENTRY</text>
+<text x="116" y="210" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="15">入门 · 6 个问题</text>
+<text x="116" y="230" fill="#8f94a4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">能装上、能跑、不崩</text>
+<line x1="38" y1="196" x2="50" y2="196" stroke="#4B67B4" stroke-width="1.6" opacity=".35"/>
+<rect x="84" y="268" width="392" height="92" rx="18" fill="#ffffff" stroke="#e6e3f0" stroke-width="1.3" filter="url(#soft)"/>
+<circle cx="116" cy="314" r="17" fill="#ece7f9"/>
+<text x="116" y="320" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="14" font-weight="700">2</text>
+<text x="150" y="304" fill="#141419" font-family="ui-monospace, monospace" font-size="20" font-weight="700">FLOW</text>
+<text x="150" y="328" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="15">顺畅 · 7 个问题</text>
+<text x="150" y="348" fill="#8f94a4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">日常任务顺、错误可恢复</text>
+<line x1="38" y1="314" x2="84" y2="314" stroke="#4B67B4" stroke-width="1.6" opacity=".35"/>
+<rect x="118" y="386" width="392" height="92" rx="18" fill="#ffffff" stroke="#4B67B4" stroke-width="2.4" filter="url(#soft)"/>
+<circle cx="150" cy="432" r="17" fill="#ece7f9"/>
+<text x="150" y="438" text-anchor="middle" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="14" font-weight="700">3</text>
+<text x="184" y="422" fill="#141419" font-family="ui-monospace, monospace" font-size="20" font-weight="700">BOOST</text>
+<text x="184" y="446" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="15">加速 · 5 个问题</text>
+<text x="184" y="466" fill="#8f94a4" font-family="ui-sans-serif, system-ui, sans-serif" font-size="12.5">提效证据可复现</text>
+<line x1="38" y1="432" x2="118" y2="432" stroke="#4B67B4" stroke-width="1.6" opacity=".35"/>
+<path d="M510 432 L690 432" stroke="#16a34a" stroke-width="2.6" fill="none" marker-end="url(#arr)"/>
+<text x="512" y="418" fill="#16a34a" font-family="ui-sans-serif, system-ui, sans-serif" font-size="13">verdict to</text>
+<rect x="700" y="300" width="350" height="264" rx="20" fill="#ffffff" stroke="#16a34a" stroke-width="2.4" filter="url(#soft)"/>
+<text x="726" y="334" fill="#16a34a" font-family="ui-monospace, monospace" font-size="13" font-weight="700">dsh-standards</text>
+<text x="726" y="366" fill="#141419" font-family="ui-sans-serif, system-ui, sans-serif" font-size="17">DSC-01...13 static checks</text>
+<text x="726" y="394" fill="#141419" font-family="ui-sans-serif, system-ui, sans-serif" font-size="17">L1-L3 runtime measurement</text>
+<text x="726" y="422" fill="#141419" font-family="ui-sans-serif, system-ui, sans-serif" font-size="17">dsh-levels verdict</text>
+<line x1="726" y1="444" x2="1024" y2="444" stroke="#f2f0f8" stroke-width="2"/>
+<text x="726" y="470" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="13">certification, scoring, ranking: none of them here</text>
+<text x="726" y="494" fill="#8f94a4" font-family="ui-monospace, monospace" font-size="12">guide asks · standards decides</text>
+<text x="726" y="530" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="12">ENTRY / FLOW / BOOST</text>
+<rect x="50" y="560" width="1000" height="52" rx="14" fill="#f7f5fc" stroke="#e6e3f0"/>
+<text x="74" y="582" fill="#4B67B4" font-family="ui-monospace, monospace" font-size="12.5" font-weight="700">route / dsh-levels</text>
+<text x="74" y="602" fill="#4d5261" font-family="ui-sans-serif, system-ui, sans-serif" font-size="13">every question has an owner: the guide says what to check, the verdict belongs to the checker</text>
+</svg>

package/docs/flow.md

@@ -32,42 +32,114 @@ a rewrite is detectable.
   "schema": "dsh-flow-evidence/2",
   "evidenceId": "01JCM8Z6R4W1V2K3N4P5Q6R7S8",
   "generatedAt": "2026-11-06T12:00:00Z",
-  "producer": { "kind": "local", "runner": "flow-collect 0.1.0", "runUrl": null, "actor": "author" },
+  "producer": {
+    "command": [
+      "node",
+      "40-checker/bin/dsh-flow-collect.mjs",
+      "--package",
+      "."
+    ],
+    "at": "2026-11-06T12:00:00Z",
+    "kind": "local",
+    "runner": "flow-collect 0.1.0",
+    "actor": "author"
+  },
   "subject": {
-    "package": "@acme/dsh-hello",
+    "name": "@acme/dsh-hello",
     "version": "0.1.0",
     "source": "npm",
-    "integrity": "sha512-…",
-    "tarballSha256": "sha256:…",
+    "integrity": "sha512-47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=",
+    "tarballSha256": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
     "commit": "ce7073d51254c26cd63b22a60835b8f948deb447",
-    "treeSha256": "sha256:…"
+    "treeSha256": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "treeStable": true
+  },
+  "host": {
+    "dsh": "0.2.2-alpha.2",
+    "dshCommit": null,
+    "cordis": "4.0.6-alpha.1",
+    "node": "v24.11.0",
+    "platform": "linux-x64"
   },
-  "host": { "dsh": "0.2.2-alpha.2", "dshCommit": null, "cordis": "4.0.6-alpha.1", "node": "v24.11.0", "platform": "linux-x64" },
   "journeys": {
     "J1": {
       "status": "pass",
-      "kind": "observed",
+      "limitations": [],
       "checks": [
         {
           "id": "J1.install",
-          "status": "pass",
-          "command": ["dsh", "plugin", "add", "."],
+          "kind": "observed",
+          "command": [
+            "dsh",
+            "plugin",
+            "add",
+            "."
+          ],
           "exitCode": 0,
           "startedAt": "2026-11-06T11:00:01Z",
           "endedAt": "2026-11-06T11:00:09Z",
-          "stdout": { "path": "logs/J1.install.out", "sha256": "sha256:…" },
-          "assertions": [{ "claim": "row visible in dump", "observed": true }]
+          "stdout": {
+            "path": "logs/J1.install.out",
+            "sha256": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+          },
+          "assertions": [
+            {
+              "claim": "row visible in dump",
+              "observed": true
+            }
+          ],
+          "durationMs": 8000
         }
-      ],
-      "limitations": []
+      ]
+    },
+    "J2": {
+      "status": "not-run",
+      "reason": "not collected in this example",
+      "checks": []
+    },
+    "J3": {
+      "status": "not-run",
+      "reason": "not collected in this example",
+      "checks": []
+    },
+    "J4": {
+      "status": "not-run",
+      "reason": "not collected in this example",
+      "checks": []
+    },
+    "J5": {
+      "status": "not-run",
+      "reason": "not collected in this example",
+      "checks": []
     },
-    "J8": { "status": "na", "reason": "no dsh.client" }
+    "J6": {
+      "status": "not-run",
+      "reason": "not collected in this example",
+      "checks": []
+    },
+    "J7": {
+      "status": "not-run",
+      "reason": "not collected in this example",
+      "checks": []
+    },
+    "J8": {
+      "status": "na",
+      "reason": "no dsh.client",
+      "checks": []
+    }
+  },
+  "claims": {
+    "claimLevel": "self-attested",
+    "notClaimed": [
+      "certification",
+      "security audit"
+    ],
+    "method": "structural example: one observed J1 run; J2-J8 not collected"
   },
-  "totals": { "pass": 7, "na": 1, "fail": 0 },
-  "conclusion": "flow-pass",
-  "claims": { "claimLevel": "self-attested", "notClaimed": ["certification", "security audit"] },
-  "chain": { "seq": 12, "prev": "sha256:…", "entrySha256": "sha256:…" },
-  "signature": null
+  "conclusion": "flow-warn",
+  "chain": {
+    "evidenceHash": "sha256:ee0364bfd26362dca8265c04b7609f6d489c100826c4778e46a1f9f56f3aa138"
+  }
 }
 ```
 
@@ -93,40 +165,22 @@ Honesty rules for the file itself:
   Put the limitation in `limitations[]` instead of dropping the row.
 
 <a id="what-the-checker-reads"></a>
-### What reads this file today
-
-`dsh-levels --flow-evidence` does **not** read the nested v2 shape yet. Its
-reader wants a flat map and only reads `status`:
-
-```json
-{
-  "J1": { "status": "pass", "evidence": "add → dump → remove; logs/J1.*.out" },
-  "J2": { "status": "pass", "evidence": "same row id disable/enable; two dumps" }
-}
-```
-
-- Accepted values are `pass`, `fail`, `not-run`, `manual`. Anything else,
-  including `na` and `warn`, is silently downgraded to `not-run`.
-- FLOW becomes `runtime` only at **8/8 pass**. One `na` gives `7/8` and
-  `not-run` — which is the honest answer for a package with no client, but it
-  is not a pass.
-- The flat map has no binding, no hash, and no host. A hand-written 8-pass file
-  passes. That is why the v2 file above exists: keep the flat map as the
-  projection, and keep the v2 file plus logs as the thing you can defend.
-
-Project the v2 file to the flat map before running the audit:
-
-```sh
-node -e '
-const fs = require("node:fs");
-const evidence = require("./flow-evidence.json");
-const flat = {};
-for (const [id, journey] of Object.entries(evidence.journeys)) {
-  flat[id] = { status: journey.status, evidence: journey.reason ?? journey.checks?.[0]?.id ?? null };
-}
-fs.writeFileSync("flow-flat.json", JSON.stringify(flat, null, 2));
-'
-```
+### What reads this file
+
+`dsh-levels --flow-evidence` reads this nested shape directly since
+`dsh-standards` 1.3.0. The flat `{ "J1": { "status": "pass" } }` map and the
+older `dsh-flow-journey/1` / `dsh-flow-runtime/1` files are `deprecated` and
+never count as a pass.
+
+- Every journey claimed as `pass` needs at least one `checks[]` entry with
+  `exitCode: 0`, an observed (non-`static`) kind, and a log hash.
+- `na` is a skip with a reason, not a pass. A package with no client ends at
+  7/8 and `not-run` — that is the honest answer.
+- `runtime` is reserved for `sandbox-attested` evidence (`producer.kind =
+  "sandbox"` or `claims.claimLevel = "sandbox-attested"`). Self-attested or CI
+  evidence keeps its pass count but lands on `not-run`.
+- The file binds subject, host, and a recomputable `chain.evidenceHash`; a
+  hand-written flat 8-pass file no longer passes.
 
 <a id="minimum-evidence-per-journey"></a>
 ## Minimum evidence per journey
@@ -186,7 +240,7 @@ the audit is
 The three-layer audit reads FLOW evidence through `--flow-evidence`:
 
 ```sh
-npx -p dsh-standards dsh-levels ./my-plugin --flow-evidence flow-flat.json --format json
+npx -p dsh-standards dsh-levels ./my-plugin --flow-evidence flow-evidence.json --format json
 ```
 
 ## Author checklist

package/docs/rules.md

@@ -22,8 +22,8 @@ incomplete/not-run, `3` usage error. `WARN` is not a clean pass and
 The JSON report also carries a sibling `advice[]` array: one entry per live
 detail, with `title`, `why`, `fix`, `docsUrl`, `severity`, and `evidence`. It is
 additive and never changes the verdict (turn it off with `--no-advice`). The
-`docsUrl` is built from a release-pinned base (`v0.4.3` in the current rule
-table); if it points at an older page, this table is the current mapping.
+`docsUrl` follows the checker's `DOCS_BASE` (currently `v0.4.4`); if it points
+at an older page, this table is the current mapping.
 
 <a id="scope-matrix"></a>
 ## Which checks run in which scope

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-guide",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "A practical guide to DSH plugin quality: ENTRY checks, FLOW checks, and BOOST guidance. Community guide; not official, not a certification, not a ranking.",
   "type": "module",
   "main": "index.js",

package/README-zh.md

@@ -1,82 +0,0 @@
-<div align="center">
-
-# dsh-plugin-guide
-
-**DSH 插件质量指南：ENTRY、FLOW、BOOST。**
-
-社区指南，不是官方标准、不是认证、不是排名。
-
-[![npm](https://img.shields.io/npm/v/dsh-plugin-guide)](https://www.npmjs.com/package/dsh-plugin-guide)
-[![CI](https://github.com/PerryLink/dsh-plugin-guide/actions/workflows/verify.yml/badge.svg)](https://github.com/PerryLink/dsh-plugin-guide/actions/workflows/verify.yml)
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-
-[English](README.md) · [简体中文](README-zh.md)
-
-</div>
-
----
-
-## 这是什么
-
-`dsh-plugin-guide` 是 DSH 插件的**指南层**：解释要检查什么、为什么重要，以及
-判定应该由哪个工具负责。它不做认证、不打分、不排名。
-
-| 包 | 角色 |
-|---|---|
-| **`dsh-plugin-guide`** | 本包：文字指南、三层地图、agent skill |
-| **`dsh-standards`** | 执行总包：ENTRY/FLOW 检查、三层审计、规范文件 |
-| **`dsh-plugin-spec`** | 底层规则文本与条款来源 |
-| **`dsh-primer`** | 旧的构建/脚手架技能和 CLI（原 `dsh-plugin-guide` 0.3.x） |
-
-## 三层
-
-| 层 | 回答 | 能否判定 |
-|---|---|---|
-| **ENTRY** | 能不能被识别、安装、启动 | 能：recognized / runtime / failed / incomplete / unavailable |
-| **FLOW** | 用户能不能装、配、用、升级、卸载 | 有 runtime 证据时能；否则 `not-run` |
-| **BOOST** | 有没有用好 Cordis | 不给插件级判定；按实践登记证据 |
-
-三条轨道，不是三个等级；它们相加不等于分数或证书。
-
-先读一页地图：[docs/levels.md](docs/levels.md)。
-
-## 安装
-
-```sh
-dsh plugin --profile web add dsh-plugin-guide
-```
-
-然后在审查插件时让 agent 使用 `dsh-plugin-guide` 技能。它会将检查交给
-`dsh-standards`，将构建/脚手架工作指向 `dsh-primer`。
-
-## 检查插件
-
-```sh
-# 只做 ENTRY 识别（不声明 runtime）
-npx dsh-standards ./my-plugin --scope entry --entry-claim static
-
-# 三层审计；没跑的层保持 not-run / not-measured
-npx -p dsh-standards dsh-levels ./my-plugin --format json
-```
-
-`recognized` 不是通过，`static` 不是通过，`not-run` 也不是通过。
-
-## 0.4.0 改了什么
-
-- 旧的 agent skill 和 `dsh-plugin-dev` CLI 已迁到
-  [`dsh-primer`](https://github.com/PerryLink/dsh-primer)。
-- 本包现在是**指南层**：三层地图、检查路由、证据规则。
-- 旧 0.3.x npm 版本已标记 deprecated，已有安装仍可用；0.4.0 是产品切换，
-  锁在 `^0.3` 的用户不会自动升级。
-- 检查在 [`dsh-standards`](https://github.com/PerryLink/dsh-standards)，不在本包。
-
-## 边界
-
-- 不做官方背书、认证、认可或安全审计。
-- 不做评分、排名或市场门禁。
-- 不伪造 runtime 证据：`static` ≠ `runtime`，`not-run` ≠ `pass`。
-- BOOST 是建议和证据，不是插件等级。
-
-## 许可
-
-Apache-2.0。见 [LICENSE](LICENSE) 与 [NOTICE.md](NOTICE.md)。