dsh-plugin-guide 0.3.38 → 0.3.40

package/scripts/install-skill.ps1

@@ -1,63 +1,63 @@
-# dsh-plugin-guide skill installer.
-# Purpose: copy the KB (excluding generated/local-only parts) into an agent skill directory and verify byte parity.
-# Usage:   pwsh -File scripts/install-skill.ps1 -Target <skill-dir> [-Source <kb-root>]
-# Scope:   SKILL.md, guide/, references/ (incl. official-docs), scripts/, README*.md, LICENSE, NOTICE.md, CONTRIBUTING.md, SECURITY.md.
-# Excluded: downloads/ (generated by scripts), .github/ (CI), .gitignore.
-# Target must be the skill directory itself (e.g. ~/.deepseek/skills/dsh-plugin-guide or <project>/.agents/skills/dsh-plugin-guide).
-param(
-  [Parameter(Mandatory=$true)][string]$Target,
-  [string]$Source = ''
-)
-$ErrorActionPreference = 'Stop'
-if (-not $Source) { $Source = Split-Path $PSScriptRoot -Parent }
-$src = (Resolve-Path $Source).Path
-$top = @('SKILL.md','LICENSE','NOTICE.md','CONTRIBUTING.md','SECURITY.md') + @(Get-ChildItem $src -Filter 'README*.md' -File | ForEach-Object { $_.Name })
-$dirs = @('guide','references','scripts')
-
-New-Item -ItemType Directory -Force -Path $Target | Out-Null
-
-foreach ($f in $top) { Copy-Item (Join-Path $src $f) (Join-Path $Target $f) -Force }
-foreach ($d in $dirs) {
-  # Copy-Item -Recurse into an existing directory would nest the source inside it; replace the owned dir instead.
-  $td = Join-Path $Target $d
-  if (Test-Path $td) { Remove-Item $td -Recurse -Force }
-  Copy-Item (Join-Path $src $d) $td -Recurse -Force
-}
-
-# Prune target files under the owned scope that no longer exist in the source (keeps reinstalls clean).
-foreach ($d in $dirs) {
-  $td = Join-Path $Target $d
-  if (Test-Path $td) {
-    $sd = Join-Path $src $d
-    $sRoot = (Resolve-Path $sd).Path
-    $tRoot = (Resolve-Path $td).Path
-    Get-ChildItem -Recurse -File $td | ForEach-Object {
-      $rel = $_.FullName.Substring($tRoot.Length + 1)
-      if (-not (Test-Path (Join-Path $sRoot $rel))) { Remove-Item $_.FullName -Force }
-    }
-  }
-}
-Get-ChildItem $Target -File -ErrorAction SilentlyContinue | ForEach-Object {
-  if (($_.Name -like 'README*.md' -or $top -contains $_.Name) -and -not (Test-Path (Join-Path $src $_.Name))) { Remove-Item $_.FullName -Force }
-}
-
-# Parity report: every scoped source file must exist in the target byte-for-byte.
-$checked = 0; $mismatch = 0
-foreach ($f in $top) {
-  $s = Join-Path $src $f; $t = Join-Path $Target $f
-  if (Test-Path $t) { $checked++; if ((Get-FileHash $s -Algorithm MD5).Hash -ne (Get-FileHash $t -Algorithm MD5).Hash) { $mismatch++; Write-Output "MISMATCH: $f" } }
-  else { $mismatch++; Write-Output "MISSING-TARGET: $f" }
-}
-foreach ($d in $dirs) {
-  $sd = Join-Path $src $d
-  $sRoot = (Resolve-Path $sd).Path
-  Get-ChildItem -Recurse -File $sd | ForEach-Object {
-    $rel = $_.FullName.Substring($sRoot.Length + 1)
-    $t = Join-Path (Join-Path $Target $d) $rel
-    if (Test-Path $t) { $checked++; if ((Get-FileHash $_.FullName -Algorithm MD5).Hash -ne (Get-FileHash $t -Algorithm MD5).Hash) { $mismatch++; Write-Output "MISMATCH: $d\$rel" } }
-    else { $mismatch++; Write-Output "MISSING-TARGET: $d\$rel" }
-  }
-}
-Write-Output "DONE: $checked scoped files verified, $mismatch mismatches -> $Target"
-if ($mismatch -gt 0) { exit 1 }
-exit 0
+# dsh-plugin-guide skill installer.
+# Purpose: copy the KB (excluding generated/local-only parts) into an agent skill directory and verify byte parity.
+# Usage:   pwsh -File scripts/install-skill.ps1 -Target <skill-dir> [-Source <kb-root>]
+# Scope:   SKILL.md, guide/, references/ (incl. official-docs), scripts/, README*.md, LICENSE, NOTICE.md, CONTRIBUTING.md, SECURITY.md.
+# Excluded: downloads/ (generated by scripts), .github/ (CI), .gitignore.
+# Target must be the skill directory itself (e.g. ~/.deepseek/skills/dsh-plugin-guide or <project>/.agents/skills/dsh-plugin-guide).
+param(
+  [Parameter(Mandatory=$true)][string]$Target,
+  [string]$Source = ''
+)
+$ErrorActionPreference = 'Stop'
+if (-not $Source) { $Source = Split-Path $PSScriptRoot -Parent }
+$src = (Resolve-Path $Source).Path
+$top = @('SKILL.md','LICENSE','NOTICE.md','CONTRIBUTING.md','SECURITY.md') + @(Get-ChildItem $src -Filter 'README*.md' -File | ForEach-Object { $_.Name })
+$dirs = @('guide','references','scripts')
+
+New-Item -ItemType Directory -Force -Path $Target | Out-Null
+
+foreach ($f in $top) { Copy-Item (Join-Path $src $f) (Join-Path $Target $f) -Force }
+foreach ($d in $dirs) {
+  # Copy-Item -Recurse into an existing directory would nest the source inside it; replace the owned dir instead.
+  $td = Join-Path $Target $d
+  if (Test-Path $td) { Remove-Item $td -Recurse -Force }
+  Copy-Item (Join-Path $src $d) $td -Recurse -Force
+}
+
+# Prune target files under the owned scope that no longer exist in the source (keeps reinstalls clean).
+foreach ($d in $dirs) {
+  $td = Join-Path $Target $d
+  if (Test-Path $td) {
+    $sd = Join-Path $src $d
+    $sRoot = (Resolve-Path $sd).Path
+    $tRoot = (Resolve-Path $td).Path
+    Get-ChildItem -Recurse -File $td | ForEach-Object {
+      $rel = $_.FullName.Substring($tRoot.Length + 1)
+      if (-not (Test-Path (Join-Path $sRoot $rel))) { Remove-Item $_.FullName -Force }
+    }
+  }
+}
+Get-ChildItem $Target -File -ErrorAction SilentlyContinue | ForEach-Object {
+  if (($_.Name -like 'README*.md' -or $top -contains $_.Name) -and -not (Test-Path (Join-Path $src $_.Name))) { Remove-Item $_.FullName -Force }
+}
+
+# Parity report: every scoped source file must exist in the target byte-for-byte.
+$checked = 0; $mismatch = 0
+foreach ($f in $top) {
+  $s = Join-Path $src $f; $t = Join-Path $Target $f
+  if (Test-Path $t) { $checked++; if ((Get-FileHash $s -Algorithm MD5).Hash -ne (Get-FileHash $t -Algorithm MD5).Hash) { $mismatch++; Write-Output "MISMATCH: $f" } }
+  else { $mismatch++; Write-Output "MISSING-TARGET: $f" }
+}
+foreach ($d in $dirs) {
+  $sd = Join-Path $src $d
+  $sRoot = (Resolve-Path $sd).Path
+  Get-ChildItem -Recurse -File $sd | ForEach-Object {
+    $rel = $_.FullName.Substring($sRoot.Length + 1)
+    $t = Join-Path (Join-Path $Target $d) $rel
+    if (Test-Path $t) { $checked++; if ((Get-FileHash $_.FullName -Algorithm MD5).Hash -ne (Get-FileHash $t -Algorithm MD5).Hash) { $mismatch++; Write-Output "MISMATCH: $d\$rel" } }
+    else { $mismatch++; Write-Output "MISSING-TARGET: $d\$rel" }
+  }
+}
+Write-Output "DONE: $checked scoped files verified, $mismatch mismatches -> $Target"
+if ($mismatch -gt 0) { exit 1 }
+exit 0

package/templates/js/README-es.md

@@ -37,6 +37,10 @@ pnpm install
 pnpm test
 ```
 
+## Standards
+
+El bloque `dsh.standards` de `package.json` es un marcador de posición, no una afirmación: todos los niveles empiezan en `not-run` (BOOST en `not-measured`). Ejecuta `level-audit` con la evidencia registrada y sustituye solo esos niveles; sin evidencia, déjalo en `not-run`: un nivel sin probar no es un aprobado.
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/README-hi.md

@@ -37,6 +37,10 @@ pnpm install
 pnpm test
 ```
 
+## Standards
+
+`package.json` में `dsh.standards` एक प्लेसहोल्डर है, कोई दावा नहीं: सभी स्तर `not-run` से शुरू होते हैं (BOOST `not-measured` से)। दर्ज प्रमाण के साथ `level-audit` चलाएँ और केवल उन्हीं स्तरों को बदलें; प्रमाण न हो तो `not-run` ही रखें — बिना परीक्षण किया गया स्तर पास नहीं होता।
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/README-pt.md

@@ -37,6 +37,10 @@ pnpm install
 pnpm test
 ```
 
+## Standards
+
+O bloco `dsh.standards` do `package.json` é um placeholder, não uma afirmação: todos os níveis começam como `not-run` (BOOST como `not-measured`). Rode o `level-audit` com a evidência registrada e substitua apenas esses níveis; sem evidência, mantenha `not-run` — um nível não testado não é uma aprovação.
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/README-zh.md

@@ -37,6 +37,10 @@ pnpm install
 pnpm test
 ```
 
+## Standards
+
+`package.json` 里的 `dsh.standards` 是占位，不是结论：所有层级初始为 `not-run`（BOOST 为 `not-measured`）。拿到记录下来的证据后跑 `level-audit`，只替换有证据的层级；没有证据就保持 `not-run`——未测不等于通过。
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/README.md

@@ -37,6 +37,10 @@ pnpm install
 pnpm test
 ```
 
+## Standards
+
+The `dsh.standards` block in `package.json` is a placeholder, not a claim: every level starts as `not-run` (BOOST as `not-measured`). Run `level-audit` with recorded evidence and replace only those levels; with no evidence, keep `not-run` — an untested level is not a pass.
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/js/icon.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="{{name}}">
-  <rect width="64" height="64" rx="14" fill="#1f6feb" />
-  <path d="M20 22h24v6H20zM20 32h24v6H20zM20 42h14v4H20z" fill="#ffffff" />
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="{{name}}">
+  <rect width="64" height="64" rx="14" fill="#1f6feb" />
+  <path d="M20 22h24v6H20zM20 32h24v6H20zM20 42h14v4H20z" fill="#ffffff" />
+</svg>

package/templates/js/locale/en.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "{{name}}",
-    "description": "A DeepSeek Harness plugin scaffolded by dsh-plugin-dev."
-  }
-}
+{
+  "meta": {
+    "title": "{{name}}",
+    "description": "A DeepSeek Harness plugin scaffolded by dsh-plugin-dev."
+  }
+}

package/templates/js/locale/zh.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "{{name}}",
-    "description": "由 dsh-plugin-dev 脚手架生成的 DeepSeek Harness 插件。"
-  }
-}
+{
+  "meta": {
+    "title": "{{name}}",
+    "description": "由 dsh-plugin-dev 脚手架生成的 DeepSeek Harness 插件。"
+  }
+}

package/templates/js/package.json

@@ -1,43 +1,49 @@
-{
-  "name": "{{pkgName}}",
-  "version": "{{version}}",
-  "description": "A DeepSeek Harness (DSH) plugin scaffolded by dsh-plugin-dev.",
-  "type": "module",
-  "main": "index.js",
-  "exports": {
-    ".": "./index.js",
-    "./locale/*.json": "./locale/*.json",
-    "./icon": "./icon.svg"
-  },
-  "files": [
-    "index.js",
-    "cordis.patch.yml",
-    "locale/*.json",
-    "icon.svg"
-  ],
-  "scripts": {
-    "test": "vitest run"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": "{{dshPeerRange}}",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "vitest": "^3.2.7"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": "{{dshPeerRange}}",
-    "@deepseek-ai/schemastery": "^3.18.2"
-  },
-  "dsh": {
-    "manifestVersion": 1,
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0"
-  },
-  "packageManager": "pnpm@11.7.0",
-  "license": "Apache-2.0"
-}
+{
+  "name": "{{pkgName}}",
+  "version": "{{version}}",
+  "description": "A DeepSeek Harness (DSH) plugin scaffolded by dsh-plugin-dev.",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg"
+  ],
+  "scripts": {
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-tools": "{{dshPeerRange}}",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "vitest": "^3.2.7"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-tools": "{{dshPeerRange}}",
+    "@deepseek-ai/schemastery": "^3.18.2"
+  },
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "standards": {
+      "schema": "dsh-levels/1",
+      "entry": { "status": "not-run", "evidence": null },
+      "flow": { "status": "not-run", "evidence": null },
+      "boost": { "status": "not-measured", "evidence": null }
+    }
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "packageManager": "pnpm@11.7.0",
+  "license": "Apache-2.0"
+}

package/templates/ts/README-es.md

@@ -39,6 +39,10 @@ pnpm test
 pnpm run build
 ```
 
+## Standards
+
+El bloque `dsh.standards` de `package.json` es un marcador de posición, no una afirmación: todos los niveles empiezan en `not-run` (BOOST en `not-measured`). Ejecuta `level-audit` con la evidencia registrada y sustituye solo esos niveles; sin evidencia, déjalo en `not-run`: un nivel sin probar no es un aprobado.
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/ts/README-hi.md

@@ -39,6 +39,10 @@ pnpm test
 pnpm run build
 ```
 
+## Standards
+
+`package.json` में `dsh.standards` एक प्लेसहोल्डर है, कोई दावा नहीं: सभी स्तर `not-run` से शुरू होते हैं (BOOST `not-measured` से)। दर्ज प्रमाण के साथ `level-audit` चलाएँ और केवल उन्हीं स्तरों को बदलें; प्रमाण न हो तो `not-run` ही रखें — बिना परीक्षण किया गया स्तर पास नहीं होता।
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/ts/README-pt.md

@@ -39,6 +39,10 @@ pnpm test
 pnpm run build
 ```
 
+## Standards
+
+O bloco `dsh.standards` do `package.json` é um placeholder, não uma afirmação: todos os níveis começam como `not-run` (BOOST como `not-measured`). Rode o `level-audit` com a evidência registrada e substitua apenas esses níveis; sem evidência, mantenha `not-run` — um nível não testado não é uma aprovação.
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/ts/README-zh.md

@@ -39,6 +39,10 @@ pnpm test
 pnpm run build
 ```
 
+## Standards
+
+`package.json` 里的 `dsh.standards` 是占位，不是结论：所有层级初始为 `not-run`（BOOST 为 `not-measured`）。拿到记录下来的证据后跑 `level-audit`，只替换有证据的层级；没有证据就保持 `not-run`——未测不等于通过。
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/ts/README.md

@@ -39,6 +39,10 @@ pnpm test
 pnpm run build
 ```
 
+## Standards
+
+The `dsh.standards` block in `package.json` is a placeholder, not a claim: every level starts as `not-run` (BOOST as `not-measured`). Run `level-audit` with recorded evidence and replace only those levels; with no evidence, keep `not-run` — an untested level is not a pass.
+
 ## License
 
 [Apache License 2.0](LICENSE) © {{year}} {{pkgName}} contributors.

package/templates/ts/icon.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="{{name}}">
-  <rect width="64" height="64" rx="14" fill="#1f6feb" />
-  <path d="M20 22h24v6H20zM20 32h24v6H20zM20 42h14v4H20z" fill="#ffffff" />
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="{{name}}">
+  <rect width="64" height="64" rx="14" fill="#1f6feb" />
+  <path d="M20 22h24v6H20zM20 32h24v6H20zM20 42h14v4H20z" fill="#ffffff" />
+</svg>

package/templates/ts/locale/en.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "{{name}}",
-    "description": "A DeepSeek Harness plugin scaffolded by dsh-plugin-dev."
-  }
-}
+{
+  "meta": {
+    "title": "{{name}}",
+    "description": "A DeepSeek Harness plugin scaffolded by dsh-plugin-dev."
+  }
+}

package/templates/ts/locale/zh.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "{{name}}",
-    "description": "由 dsh-plugin-dev 脚手架生成的 DeepSeek Harness 插件。"
-  }
-}
+{
+  "meta": {
+    "title": "{{name}}",
+    "description": "由 dsh-plugin-dev 脚手架生成的 DeepSeek Harness 插件。"
+  }
+}

package/templates/ts/package.json

@@ -1,52 +1,58 @@
-{
-  "name": "{{pkgName}}",
-  "version": "{{version}}",
-  "description": "A DeepSeek Harness (DSH) plugin scaffolded by dsh-plugin-dev.",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": "./lib/index.js",
-    "./locale/*.json": "./locale/*.json",
-    "./icon": "./icon.svg"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "locale/*.json",
-    "icon.svg"
-  ],
-  "scripts": {
-    "build": "tsdown",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "prepare": "tsdown"
-  },
-  "dependencies": {
-    "tsdown": "^0.22.14",
-    "typescript": "^5.9.3"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": "{{dshPeerRange}}",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@types/node": "^22.20.1",
-    "vitest": "^3.2.7"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": "{{dshPeerRange}}",
-    "@deepseek-ai/schemastery": "^3.18.2"
-  },
-  "dsh": {
-    "manifestVersion": 1,
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0"
-  },
-  "packageManager": "pnpm@11.7.0",
-  "license": "Apache-2.0"
-}
+{
+  "name": "{{pkgName}}",
+  "version": "{{version}}",
+  "description": "A DeepSeek Harness (DSH) plugin scaffolded by dsh-plugin-dev.",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": "./lib/index.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepare": "tsdown"
+  },
+  "dependencies": {
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-tools": "{{dshPeerRange}}",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@types/node": "^22.20.1",
+    "vitest": "^3.2.7"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-tools": "{{dshPeerRange}}",
+    "@deepseek-ai/schemastery": "^3.18.2"
+  },
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "standards": {
+      "schema": "dsh-levels/1",
+      "entry": { "status": "not-run", "evidence": null },
+      "flow": { "status": "not-run", "evidence": null },
+      "boost": { "status": "not-measured", "evidence": null }
+    }
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "packageManager": "pnpm@11.7.0",
+  "license": "Apache-2.0"
+}

package/templates/ts/tsdown.config.mjs

@@ -1,21 +1,21 @@
-import { defineConfig } from 'tsdown'
-
-// tsdown bundles src/index.ts into lib/index.js (ESM) and emits lib/index.d.ts.
-// It is also the self-contained `prepare` script for git installs: no project
-// references, no type checking (see guide §7.1 "build-script catch").
-export default defineConfig({
-  entry: { index: 'src/index.ts' },
-  format: ['esm'],
-  platform: 'node',
-  target: 'node22',
-  dts: true,
-  clean: true,
-  sourcemap: false,
-  outDir: 'lib',
-  // With `platform: node` tsdown forces `.mjs`/`.cjs`; disable that so ESM output
-  // follows the package `"type": "module"` and emits `lib/index.js` +
-  // `lib/index.d.ts` — the paths this template's package.json declares. Without
-  // this flag the build emits `lib/index.mjs`/`lib/index.d.mts`, `main` resolves
-  // to nothing, and the plugin silently never loads.
-  fixedExtension: false,
-})
+import { defineConfig } from 'tsdown'
+
+// tsdown bundles src/index.ts into lib/index.js (ESM) and emits lib/index.d.ts.
+// It is also the self-contained `prepare` script for git installs: no project
+// references, no type checking (see guide §7.1 "build-script catch").
+export default defineConfig({
+  entry: { index: 'src/index.ts' },
+  format: ['esm'],
+  platform: 'node',
+  target: 'node22',
+  dts: true,
+  clean: true,
+  sourcemap: false,
+  outDir: 'lib',
+  // With `platform: node` tsdown forces `.mjs`/`.cjs`; disable that so ESM output
+  // follows the package `"type": "module"` and emits `lib/index.js` +
+  // `lib/index.d.ts` — the paths this template's package.json declares. Without
+  // this flag the build emits `lib/index.mjs`/`lib/index.d.mts`, `main` resolves
+  // to nothing, and the plugin silently never loads.
+  fixedExtension: false,
+})