dsh-policy-ledger 0.2.0-alpha.8 → 0.2.0-alpha.9

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.2.0-alpha.9] — 2026-11-01
+
+### Changed
+
+- Documentation: five-language fixture/acceptance links now resolve on npm; added specific related-checker/tool links.
+- Marketplace metadata: taxonomy category, archetype, domains and status; docs page now shows the same.
+- Added a real terminal hero (and GIF for the active docs set) plus `TROUBLESHOOTING.md`.
+
 All notable changes to `dsh-policy-ledger` are documented here. The format follows Keep a Changelog; this project uses alpha versions.
 
 ## [0.2.0-alpha.8] — 2026-11-01

package/README-es.md

@@ -35,6 +35,10 @@ dsh plugin --profile <profile> add dsh-policy-ledger
 
 *Flujo: entrada local → plugin → salida local. No requiere llamada a un modelo.*
 
+![Real dsh-policy-ledger terminal output](docs/assets/dsh-policy-ledger-hero.png)
+
+*Ejecución local real; sin modelo ni red.*
+
 ## Instalación
 
 Instalar y verificar:
@@ -90,7 +94,7 @@ dsh --profile <profile> --dump-config | grep dsh-policy-ledger
 
 ### Ejemplo respaldado por fixture
 
-Entrada: [`ACCEPTANCE.csv`](ACCEPTANCE.csv)
+Entrada: [`ACCEPTANCE.csv`](https://github.com/PerryLink/dsh-policy-ledger/blob/main/ACCEPTANCE.csv)
 
 Comando: `pnpm test`
 
@@ -140,6 +144,9 @@ pnpm build && pnpm lint && pnpm typecheck && pnpm test
 
 Paquetes hermanos e índices de familia: [dsh-pim-lint](https://github.com/PerryLink/dsh-pim-lint) · [dsh-eval-pack](https://github.com/PerryLink/dsh-eval-pack)
 
+Herramientas relacionadas (tabla en inglés): [Related tools](README.md#related-tools).
+
+- [Solución de problemas (inglés)](TROUBLESHOOTING.md)
 - [Índice de dominio](https://perrylink.github.io/dsh-plugins/)
 - [Familia de checkers](https://perrylink.github.io/zh/checkers/)
 - [Familia principal](https://github.com/PerryLink/dsh-kit)

package/README-hi.md

@@ -35,6 +35,10 @@ dsh plugin --profile <profile> add dsh-policy-ledger
 
 *वर्कफ़्लो: स्थानीय इनपुट → प्लगइन → स्थानीय आउटपुट। मॉडल कॉल आवश्यक नहीं।*
 
+![Real dsh-policy-ledger terminal output](docs/assets/dsh-policy-ledger-hero.png)
+
+*वास्तविक स्थानीय परीक्षण; कोई मॉडल या नेटवर्क कॉल नहीं।*
+
 ## इंस्टॉल
 
 इंस्टॉल और सत्यापन:
@@ -90,7 +94,7 @@ dsh --profile <profile> --dump-config | grep dsh-policy-ledger
 
 ### fixture-आधारित उदाहरण
 
-इनपुट: [`ACCEPTANCE.csv`](ACCEPTANCE.csv)
+इनपुट: [`ACCEPTANCE.csv`](https://github.com/PerryLink/dsh-policy-ledger/blob/main/ACCEPTANCE.csv)
 
 कमांड: `pnpm test`
 
@@ -140,6 +144,9 @@ pnpm build && pnpm lint && pnpm typecheck && pnpm test
 
 सहोदर पैकेज और परिवार सूचकांक: [dsh-pim-lint](https://github.com/PerryLink/dsh-pim-lint) · [dsh-eval-pack](https://github.com/PerryLink/dsh-eval-pack)
 
+संबंधित टूल (अंग्रेज़ी तालिका): [Related tools](README.md#related-tools).
+
+- [समस्या निवारण (अंग्रेज़ी)](TROUBLESHOOTING.md)
 - [डोमेन सूचकांक](https://perrylink.github.io/dsh-plugins/)
 - [चेकर परिवार](https://perrylink.github.io/zh/checkers/)
 - [मुख्य परिवार](https://github.com/PerryLink/dsh-kit)

package/README-pt.md

@@ -35,6 +35,10 @@ dsh plugin --profile <profile> add dsh-policy-ledger
 
 *Fluxo: entrada local → plugin → saída local. Não exige chamada a modelo.*
 
+![Real dsh-policy-ledger terminal output](docs/assets/dsh-policy-ledger-hero.png)
+
+*Execução local real; sem modelo ou rede.*
+
 ## Instalação
 
 Instalar e verificar:
@@ -90,7 +94,7 @@ dsh --profile <profile> --dump-config | grep dsh-policy-ledger
 
 ### Exemplo com fixture
 
-Entrada: [`ACCEPTANCE.csv`](ACCEPTANCE.csv)
+Entrada: [`ACCEPTANCE.csv`](https://github.com/PerryLink/dsh-policy-ledger/blob/main/ACCEPTANCE.csv)
 
 Comando: `pnpm test`
 
@@ -140,6 +144,9 @@ pnpm build && pnpm lint && pnpm typecheck && pnpm test
 
 Pacotes irmãos e índices da família: [dsh-pim-lint](https://github.com/PerryLink/dsh-pim-lint) · [dsh-eval-pack](https://github.com/PerryLink/dsh-eval-pack)
 
+Ferramentas relacionadas (tabela em inglês): [Related tools](README.md#related-tools).
+
+- [Solução de problemas (inglês)](TROUBLESHOOTING.md)
 - [Índice de domínio](https://perrylink.github.io/dsh-plugins/)
 - [Família de checkers](https://perrylink.github.io/zh/checkers/)
 - [Família principal](https://github.com/PerryLink/dsh-kit)

package/README-zh.md

@@ -35,6 +35,10 @@ dsh plugin --profile <profile> add dsh-policy-ledger
 
 *工作流：本地输入 → 插件 → 本地输出；不需要调用模型。*
 
+![Real dsh-policy-ledger terminal output](docs/assets/dsh-policy-ledger-hero.png)
+
+*本地真实测试运行；不调用模型或网络。*
+
 ## 安装
 
 安装并验证：
@@ -90,7 +94,7 @@ dsh --profile <profile> --dump-config | grep dsh-policy-ledger
 
 ### fixture 支撑的示例
 
-输入: [`ACCEPTANCE.csv`](ACCEPTANCE.csv)
+输入: [`ACCEPTANCE.csv`](https://github.com/PerryLink/dsh-policy-ledger/blob/main/ACCEPTANCE.csv)
 
 命令: `pnpm test`
 
@@ -140,6 +144,9 @@ pnpm build && pnpm lint && pnpm typecheck && pnpm test
 
 兄弟包与家族索引： [dsh-pim-lint](https://github.com/PerryLink/dsh-pim-lint) · [dsh-eval-pack](https://github.com/PerryLink/dsh-eval-pack)
 
+相关工具（英文表）: [Related tools](README.md#related-tools).
+
+- [故障排查（英文）](TROUBLESHOOTING.md)
 - [领域索引](https://perrylink.github.io/dsh-plugins/)
 - [Checker 家族](https://perrylink.github.io/zh/checkers/)
 - [主线家族](https://github.com/PerryLink/dsh-kit)

package/README.md

@@ -35,6 +35,10 @@ dsh plugin --profile <profile> add dsh-policy-ledger
 
 *Workflow: local input → plugin → local output. No model call is required.*
 
+![Real dsh-policy-ledger terminal output](docs/assets/dsh-policy-ledger-hero.png)
+
+*Real local test run; no model or network call.*
+
 ## Install
 
 Install and verify:
@@ -90,7 +94,7 @@ dsh --profile <profile> --dump-config | grep dsh-policy-ledger
 
 ### Fixture-backed example
 
-Input: [`ACCEPTANCE.csv`](ACCEPTANCE.csv)
+Input: [`ACCEPTANCE.csv`](https://github.com/PerryLink/dsh-policy-ledger/blob/main/ACCEPTANCE.csv)
 
 Command: `pnpm test`
 
@@ -140,6 +144,17 @@ pnpm build && pnpm lint && pnpm typecheck && pnpm test
 
 Sibling packages and family indexes: [dsh-pim-lint](https://github.com/PerryLink/dsh-pim-lint) · [dsh-eval-pack](https://github.com/PerryLink/dsh-eval-pack)
 
+
+### Related tools
+
+Each entry is a separate package with its own tool surface and version; install only the ones you need.
+
+| Package | Why it is relevant |
+|---|---|
+| [`dsh-plugin-doctor`](https://github.com/PerryLink/dsh-plugin-doctor) | Package structure, Cordis wiring and sandbox smoke checks. |
+| [`dsh-plugin-kit`](https://github.com/PerryLink/dsh-plugin-kit) | Plugin authoring and scaffolding kit. |
+
+- [Troubleshooting](TROUBLESHOOTING.md)
 - [Domain index](https://perrylink.github.io/dsh-plugins/)
 - [Checker family](https://perrylink.github.io/zh/checkers/)
 - [Mainline family](https://github.com/PerryLink/dsh-kit)

package/TROUBLESHOOTING.md

@@ -0,0 +1,45 @@
+# Troubleshooting — dsh-policy-ledger
+
+## Install or activation fails
+
+- DSH must satisfy `>=0.2.1-rc.3 <0.3.0`; Node must be `>=24.9 <25`.
+- Run `dsh --version` and `node --version`, then retry with a fresh `DSH_HOME`:
+
+```sh
+export DSH_HOME="$(mktemp -d)"
+dsh plugin --profile <profile> add dsh-policy-ledger
+dsh --profile <profile> --dump-config | grep dsh-policy-ledger
+```
+
+## The tool cannot find an input
+
+- All paths are local. Use an absolute path, or a path relative to the process working directory.
+- The public samples under `fixtures/` are repository-only; they are not shipped in the npm tarball. Download them from the GitHub repository if needed.
+- Supported material: npm tarballs and install logs.
+
+## Parse or encoding failures
+
+- Text inputs must be UTF-8; CSV headers must match the README's documented column names.
+- Remove a UTF-8 BOM if the first header is reported as unknown.
+- This is a read-only install doctor, not a policy gate. Check that the tarball path is local and readable.
+
+## Permission or write failures
+
+- Tools marked `R1 local write` write under the configured DSH data directory.
+- For tests, point `DSH_HOME` at a temporary directory; do not write into a real profile.
+
+## The result looks wrong
+
+- Check the tool boundary in the README first. These are public/synthetic alpha tools, not a production or customer-validated determination.
+- Compare the reported row ids and input rows; the output is deliberately explicit about what it could not run.
+
+## Run the tests
+
+```sh
+pnpm install --frozen-lockfile
+pnpm test
+```
+
+## Report
+
+Open an issue on <https://github.com/PerryLink/dsh-policy-ledger/issues> with the package version, a minimal synthetic input, and the exact tool call. Do not attach customer data.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-policy-ledger",
-  "version": "0.2.0-alpha.8",
+  "version": "0.2.0-alpha.9",
   "description": "Read-only install doctor: capability snapshot, tarball assert and install diagnosis.",
   "type": "module",
   "main": "./lib/plugin/index.js",
@@ -32,6 +32,8 @@
     "CODE_OF_CONDUCT.md",
     "CONTRIBUTING.md",
     "CHANGELOG.md",
+    "TROUBLESHOOTING.md",
+    "screenshots.json",
     "icon.svg"
   ],
   "dsh": {

package/screenshots.json

@@ -0,0 +1,14 @@
+[
+  {
+    "path": "docs/assets/dsh-policy-ledger-hero.png",
+    "kind": "hero",
+    "alt": "dsh-policy-ledger terminal output",
+    "caption": "Real dsh-policy-ledger local test run; 3 tests passed."
+  },
+  {
+    "path": "docs/assets/dsh-policy-ledger-demo.gif",
+    "kind": "demo",
+    "alt": "Animated dsh-policy-ledger terminal session",
+    "caption": "The same run, assembled line by line."
+  }
+]