dsh-plugin-guide 0.3.42 → 0.4.1

package/scripts/measure-mirror-references.mjs

@@ -1,117 +0,0 @@
-// Measure how much of the offline mirror is actually referenced.
-//
-// `references/mirror-scope-decision.md` records a rejected proposal: drop the
-// mirror content that no authored document references, to save ~80% of the
-// published package. This script is the evidence. Run it before reviving that
-// proposal — the answer depends on whether directory globs count as references,
-// and this repository declares several broad ones.
-//
-// Usage: node scripts/measure-mirror-references.mjs [--json]
-
-import { readdirSync, readFileSync, statSync } from 'node:fs'
-import { join } from 'node:path'
-
-const root = process.cwd()
-const mirrorRoot = join(root, 'references', 'official-docs')
-const json = process.argv.includes('--json')
-
-/** Documents that count as "the knowledge base" when looking for references. */
-function authoredFiles() {
-  const out = []
-  const add = (p) => {
-    try { if (statSync(p).isFile()) out.push(p) } catch { /* optional */ }
-  }
-  add(join(root, 'SKILL.md'))
-  add(join(root, 'llms.txt'))
-  for (const dir of ['guide', 'references']) {
-    try {
-      for (const f of readdirSync(join(root, dir))) add(join(root, dir, f))
-    } catch { /* optional */ }
-  }
-  for (const f of readdirSync(root)) if (/^README.*\.md$/.test(f)) add(join(root, f))
-  return out.filter((p) => !p.includes('official-docs') && !p.includes('mirror-scope'))
-}
-
-const authored = authoredFiles()
-const corpus = authored.map((p) => readFileSync(p, 'utf8'))
-
-// Everything the corpus names: full paths, bare basenames, and directory globs.
-const paths = new Set()
-const names = new Set()
-const globDirs = new Set()
-for (const text of corpus) {
-  for (const m of text.matchAll(/references\/official-docs\/([A-Za-z0-9._/-]+)/g)) paths.add(m[1])
-  for (const m of text.matchAll(/\bdocs\/[A-Za-z0-9._/-]+/g)) paths.add(m[0])
-  for (const m of text.matchAll(/([A-Za-z0-9._-]+)\.(md|json|ya?ml|png)\b/g)) names.add(`${m[1]}.${m[2]}`)
-  for (const m of text.matchAll(/([A-Za-z0-9._/-]+)\/\*\*/g)) globDirs.add(m[1])
-}
-
-function walk(dir, base = '') {
-  const out = []
-  for (const e of readdirSync(dir, { withFileTypes: true })) {
-    const rel = base ? `${base}/${e.name}` : e.name
-    if (e.isDirectory()) out.push(...walk(join(dir, e.name), rel))
-    else out.push(rel)
-  }
-  return out
-}
-
-/**
- * How the corpus reaches this mirror path.
- *
- * A glob only covers a path when the glob directory is a PREFIX of it:
- * `docs/persistence-changes/**` covers `docs/persistence-changes/x.json`, but a
- * bare `docs/**` does not imply everything under `docs/`. Matching a segment name
- * anywhere inflates the referenced count and produced a wrong "80% unreferenced"
- * figure in the original audit.
- */
-function referencedBy(rel) {
-  if (paths.has(rel) || paths.has(`docs/${rel}`)) return 'exact'
-  const parts = rel.split('/')
-  for (let i = 1; i <= parts.length; i++) {
-    if (globDirs.has(parts.slice(0, i).join('/'))) return 'dir-glob'
-  }
-  if (names.has(parts[parts.length - 1])) return 'basename'
-  return null
-}
-
-const SKIP = new Set(['README.md', 'SNAPSHOT.md', 'LICENSE', 'CLAUDE.md'])
-const buckets = { exact: [], 'dir-glob': [], basename: [], unreferenced: [] }
-for (const rel of walk(mirrorRoot).sort()) {
-  if (SKIP.has(rel)) continue
-  const size = statSync(join(mirrorRoot, rel)).size
-  buckets[referencedBy(rel) ?? 'unreferenced'].push({ rel, size })
-}
-
-const MB = (n) => (n / 1048576).toFixed(2) + ' MB'
-const sum = (a) => a.reduce((s, x) => s + x.size, 0)
-
-if (json) {
-  console.log(JSON.stringify({
-    authoredDocuments: authored.length,
-    buckets: Object.fromEntries(Object.entries(buckets).map(([k, v]) => [k, { files: v.length, bytes: sum(v) }])),
-  }, null, 2))
-} else {
-  console.log(`authored documents scanned: ${authored.length}`)
-  console.log('\nmirror files by reference strength:')
-  for (const k of ['exact', 'dir-glob', 'basename', 'unreferenced']) {
-    console.log(`  ${k.padEnd(14)} ${String(buckets[k].length).padStart(4)} files  ${MB(sum(buckets[k])).padStart(10)}`)
-  }
-  const unreferenced = buckets.unreferenced
-  console.log(`\ngenuinely unreferenced: ${unreferenced.length} files, ${MB(sum(unreferenced))}`)
-  for (const x of unreferenced) console.log(`  ${MB(x.size).padStart(10)}  ${x.rel}`)
-
-  const byExt = new Map()
-  for (const x of buckets['dir-glob']) {
-    const ext = x.rel.slice(x.rel.lastIndexOf('.'))
-    const g = byExt.get(ext) ?? { n: 0, b: 0 }
-    g.n++
-    g.b += x.size
-    byExt.set(ext, g)
-  }
-  console.log('\nreachable only through a declared directory glob, by extension:')
-  for (const [ext, g] of [...byExt].sort((a, b) => b[1].b - a[1].b)) {
-    console.log(`  ${ext.padEnd(12)} ${String(g.n).padStart(4)} files  ${MB(g.b).padStart(10)}`)
-  }
-  console.log('\nSee references/mirror-scope-decision.md before acting on these numbers.')
-}

package/scripts/sync-official-docs.ps1

@@ -1,138 +0,0 @@
-# dsh-plugin-guide official-docs sync script.
-# Purpose: sync the deepseek-harness checkout's official docs into references/official-docs/ (verbatim copy).
-# Source is pinned to origin/master (HEAD fallback): untracked drafts and unpushed commits in the checkout never enter the KB.
-# Output: references/official-docs/SNAPSHOT.md (source ref/SHA, sync time, file counts - the freshness authority for READMEs).
-# Usage:  pwsh -File scripts/sync-official-docs.ps1 [-Checkout <path>] [-SkipGit]
-# Verify: pwsh -File scripts/verify-kit.ps1 -Checkout <path>   # drift report KB vs checkout (tracked files only)
-param(
-  [string]$Checkout = 'D:\deepseek-harness',
-  [switch]$SkipGit
-)
-$ErrorActionPreference = 'Stop'
-$kit  = Split-Path $PSScriptRoot -Parent
-$dest = Join-Path $kit 'references\official-docs'
-
-if (-not (Test-Path $Checkout)) { Write-Error "checkout not found: $Checkout"; exit 1 }
-
-$gitOk = $false
-if (-not $SkipGit) {
-  $gitOk = (& git -C $Checkout rev-parse --is-inside-work-tree 2>$null) -eq 'true'
-}
-
-$ref = 'filesystem'
-$sha = ''
-$pruned = 0
-$mdCount = 0
-$zhCount = 0
-
-# Sync scope: docs/, root AGENTS.md/BENCHMARK.md/CLAUDE.md/CONTRIBUTING.*/README.zh.md/README.i18n.yaml/THIRD_PARTY_NOTICES.md/LICENSE, packages/AGENTS.md, packages/README.md, vendor/README.md, website/docs.ts
-# Upstream root README.md is out of scope: official-docs/README.md is the KB-owned index (the upstream English README snapshot lives in downloads/github/harness/README.md).
-# Every pathspec uses the :(top) anchor so git's basename-wide matching cannot sweep in same-named symlinks (e.g. the various CLAUDE.md files).
-$paths = @(':(top)docs', ':(top)AGENTS.md', ':(top)BENCHMARK.md', ':(top)CONTRIBUTING.md', ':(top)CONTRIBUTING.zh.md', ':(top)CONTRIBUTING.i18n.yaml', ':(top)README.zh.md', ':(top)README.i18n.yaml', ':(top)THIRD_PARTY_NOTICES.md', ':(top)LICENSE', ':(top)packages/AGENTS.md', ':(top)packages/README.md', ':(top)vendor/README.md', ':(top)website/docs.ts')
-
-if ($gitOk) {
-  # Prefer origin/master, fall back to HEAD - never the working tree (may contain untracked/unpushed content).
-  if ((& git -C $Checkout rev-parse --verify -q origin/master 2>$null)) { $ref = 'origin/master' } else { $ref = 'HEAD' }
-  $sha = (& git -C $Checkout rev-parse $ref).Trim()
-
-  $tmp = Join-Path ([System.IO.Path]::GetTempPath()) ("dsh-official-docs-$sha.tar")
-  Remove-Item $tmp -Force -ErrorAction SilentlyContinue
-  & git -C $Checkout archive -o $tmp $ref -- $paths
-  if ($LASTEXITCODE -ne 0) { Write-Error "git archive failed (ref=$ref)"; exit 1 }
-
-  New-Item -ItemType Directory -Force -Path $dest | Out-Null
-  # Verbatim copy: clear the destination before extracting (keep only the KB-owned index README.md,
-  # which is unrelated to upstream), so structural residue from older snapshots (e.g. a top-level
-  # .agents/ directory from a previous tree) cannot interfere with the extraction.
-  Get-ChildItem -Force $dest | Where-Object { $_.Name -ne 'README.md' } | ForEach-Object {
-    Remove-Item $_.FullName -Recurse -Force; $pruned++
-  }
-  & tar -xf $tmp -C $dest
-  if ($LASTEXITCODE -ne 0) { Write-Error 'tar extraction failed'; exit 1 }
-  Remove-Item $tmp -Force
-
-  # CLAUDE.md is a symlink upstream (target AGENTS.md, mode 120000); Windows tar cannot extract
-  # symlinks, and the 'CLAUDE.md' pathspec would basename-match same-named symlinks deeper in the
-  # repo, so it stays out of $paths - after extraction its target text lands as a plain file
-  # (content = the upstream blob text).
-  $claudeTarget = (& git -C $Checkout cat-file -p "${ref}:CLAUDE.md" 2>$null | Select-Object -First 1)
-  if (-not $claudeTarget) { $claudeTarget = 'AGENTS.md' }
-  Set-Content -Path (Join-Path $dest 'CLAUDE.md') -Value $claudeTarget -Encoding UTF8
-
-  # website/docs.ts keeps its in-repo filename in the archive; move it to the KB's flat name.
-  if (Test-Path (Join-Path $dest 'website\docs.ts')) {
-    Copy-Item (Join-Path $dest 'website\docs.ts') (Join-Path $dest 'website-docs.ts') -Force
-    Remove-Item (Join-Path $dest 'website\docs.ts') -Force
-    Remove-Item (Join-Path $dest 'website') -Force -Recurse -ErrorAction SilentlyContinue
-  }
-
-  # Keep only in-scope entries at the destination root (drops stale extraction residue and
-  # upstream-deleted root files so the copy stays verbatim).
-  $rootKeep = @('docs','examples','packages','vendor','AGENTS.md','BENCHMARK.md','CLAUDE.md','CONTRIBUTING.md','CONTRIBUTING.zh.md','CONTRIBUTING.i18n.yaml','LICENSE','README.zh.md','README.i18n.yaml','THIRD_PARTY_NOTICES.md','SNAPSHOT.md','README.md','website-docs.ts')
-  Get-ChildItem -Force $dest | Where-Object { $rootKeep -notcontains $_.Name } | ForEach-Object {
-    Remove-Item $_.FullName -Recurse -Force; $pruned++
-  }
-  foreach ($sub in @('examples','packages','vendor')) {
-    $subDir = Join-Path $dest $sub
-    if (Test-Path $subDir) {
-      $subKeep = @()
-      if ($sub -eq 'examples') { $subKeep = @('AGENTS.md') }
-      if ($sub -eq 'packages') { $subKeep = @('AGENTS.md','README.md') }
-      if ($sub -eq 'vendor')   { $subKeep = @('README.md') }
-      Get-ChildItem -Force -Directory $subDir -ErrorAction SilentlyContinue | ForEach-Object {
-        Remove-Item $_.FullName -Recurse -Force; $pruned++
-      }
-      Get-ChildItem -Force -File $subDir -ErrorAction SilentlyContinue | Where-Object { $subKeep -notcontains $_.Name } | ForEach-Object {
-        Remove-Item $_.FullName -Force; $pruned++
-      }
-    }
-  }
-
-  # Prune docs/ files that no longer exist in the source ref (a verbatim copy does not keep upstream-deleted content).
-  $tracked = New-Object System.Collections.Generic.HashSet[string]
-  foreach ($t in (& git -C $Checkout ls-tree -r --name-only $ref -- docs)) { [void]$tracked.Add($t.Replace('\','/')) }
-  $docsDir = Join-Path $dest 'docs'
-  if (Test-Path $docsDir) {
-    $docsRoot = (Resolve-Path $docsDir).Path
-    Get-ChildItem -Recurse -File $docsDir | ForEach-Object {
-      $rel = 'docs/' + $_.FullName.Substring($docsRoot.Length + 1).Replace('\','/')
-      if (-not $tracked.Contains($rel)) { Remove-Item $_.FullName -Force; $pruned++ }
-    }
-  }
-} else {
-  Write-Output 'WARN: checkout is not a git repo (or -SkipGit) - copying the filesystem as-is; untracked files are not filtered and no pruning runs.'
-  foreach ($p in $paths) {
-    $rel = $p -replace '^:\(top\)',''   # strip the pathspec anchor to get the in-repo relative path
-    $srcFull = Join-Path $Checkout ($rel -replace '/','\')
-    if (-not (Test-Path $srcFull)) { Write-Output "SKIP(source missing): $rel"; continue }
-    $target = Join-Path $dest ($rel -replace '/','\')
-    $tdir = Split-Path $target -Parent
-    if ($tdir -and -not (Test-Path $tdir)) { New-Item -ItemType Directory -Force -Path $tdir | Out-Null }
-    Copy-Item $srcFull $target -Recurse -Force
-  }
-}
-
-$mdCount = (Get-ChildItem -Recurse -File (Join-Path $dest 'docs') -Filter *.md).Count
-$zhCount = (Get-ChildItem -Recurse -File (Join-Path $dest 'docs') -Filter *.zh.md).Count
-$utc = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ')
-$L = @(
-  '# official-docs snapshot (SNAPSHOT.md)',
-  '',
-  '> Generated by `scripts/sync-official-docs.ps1`. This file is the single authority for how `references/official-docs/` lines up with upstream deepseek-harness.',
-  '> The "last verified" dates and commit SHAs in README/guide must cite this file; do not hand-edit them.',
-  '',
-  '| Item | Value |',
-  '|---|---|',
-  "| Source checkout | ``$Checkout`` |",
-  "| Source ref | ``$ref`` |",
-  "| Source commit | ``$sha`` |",
-  "| Synced at (UTC) | $utc |",
-  '| Scope | tracked files at the ref: `docs/`, root `AGENTS.md`, `BENCHMARK.md`, `CLAUDE.md` (symlink target text), `CONTRIBUTING.md`/`.zh.md`/`.i18n.yaml`, `README.zh.md`/`.i18n.yaml` (the upstream English `README.md` is not in this dir; its snapshot lives in `downloads/github/harness/README.md`), `THIRD_PARTY_NOTICES.md`, `LICENSE`, `packages/AGENTS.md`, `packages/README.md`, `vendor/README.md`, `website/docs.ts` |',
-  "| File counts | docs/: $mdCount md files ($zhCount .zh.md pairs) |",
-  "| Pruned this run | $pruned out-of-scope/upstream-deleted entries |",
-  '',
-  'Drift check: `pwsh -File scripts/verify-kit.ps1 -Checkout <checkout>` (tracked files only).'
-)
-Set-Content -Path (Join-Path $dest 'SNAPSHOT.md') -Value ($L -join "`r`n") -Encoding UTF8
-
-Write-Output "DONE: ref=$ref sha=$sha pruned=$pruned -> $dest"

package/scripts/verify-artifacts.mjs

@@ -1,145 +0,0 @@
-// Artifact gate for the dsh-plugin-guide CLI. Runs after `pnpm run build` and
-// verifies the shipped surfaces without any network access:
-//   1. the built CLI, bin shim, and template trees exist;
-//   2. the CLI self-checks this repo (dogfood) and reports `ok: true`;
-//   3. the scaffolder produces TS and JS skeletons inside a mkdtemp sandbox
-//      (never touching a real home directory), which are then removed.
-import { spawnSync } from 'node:child_process'
-import { existsSync, mkdtempSync, readFileSync, rmSync, readdirSync } from 'node:fs'
-import { tmpdir } from 'node:os'
-import { dirname, join, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
-const failures = []
-
-function check(condition, message) {
-  if (condition) {
-    console.log(`ok - ${message}`)
-  } else {
-    failures.push(message)
-    console.error(`FAIL - ${message}`)
-  }
-}
-
-function runNode(args, options = {}) {
-  return spawnSync(process.execPath, args, { cwd: root, encoding: 'utf8', ...options })
-}
-
-// 1. Shipped surfaces.
-check(existsSync(join(root, 'dist', 'dsh-plugin-dev.js')), 'dist/dsh-plugin-dev.js exists (run pnpm run build first)')
-check(existsSync(join(root, 'bin', 'dsh-plugin-dev.js')), 'bin/dsh-plugin-dev.js exists')
-check(existsSync(join(root, 'templates', 'ts')), 'templates/ts exists')
-check(existsSync(join(root, 'templates', 'js')), 'templates/js exists')
-
-// Files a subcommand reads at RUNTIME but that nothing else asserts are shipped.
-// `data/seams/index.json` was missing from package.json `files[]` while the
-// `seams` command already depended on it: the command worked from the source
-// tree and would have failed for every installed user with "seam index not
-// found". Reading the file in-repo cannot catch that, so assert the manifest
-// declares it.
-{
-  const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
-  const declared = (p) => pkg.files.some((f) => f === p || f.startsWith(`${p}/`) || f === `${p}`)
-  const runtimeInputs = [
-    ['data', 'data/seams/index.json read by `seams`'],
-    ['data', 'data/facts.json read by check-facts'],
-    ['SKILL.md', 'SKILL.md registered as the agent skill'],
-  ]
-  for (const [entry, why] of runtimeInputs) {
-    check(declared(entry), `package.json files[] ships ${why}`)
-  }
-  const seamIndex = JSON.parse(readFileSync(join(root, 'data', 'seams', 'index.json'), 'utf8'))
-  check(Array.isArray(seamIndex.seams) && seamIndex.seams.length > 0, 'seam index parses and is non-empty')
-}
-
-// The `seams` command must resolve its data through the BUILT bundle, since that
-// is what ships; a source-tree-only path resolution works in tests and fails in
-// the published artifact.
-{
-  const seams = runNode(['dist/dsh-plugin-dev.js', 'seams', 'L3', '--json'], { stdio: ['ignore', 'pipe', 'pipe'] })
-  let parsed = null
-  try { parsed = JSON.parse(seams.stdout) } catch { parsed = null }
-  check(seams.status === 0 && parsed?.state === 'found', `bundled \`seams L3\` resolves its data (exit ${seams.status})`)
-
-  // The third state must survive bundling: an unmatched query reports unknown.
-  const unknown = runNode(['dist/dsh-plugin-dev.js', 'seams', 'zzz-nothing', '--json'], { stdio: ['ignore', 'pipe', 'pipe'] })
-  let u = null
-  try { u = JSON.parse(unknown.stdout) } catch { u = null }
-  check(unknown.status === 3 && u?.state === 'unknown', `bundled \`seams\` reports unknown with exit 3 (exit ${unknown.status})`)
-}
-
-// 2. Version + dogfood self-check.
-const version = runNode(['dist/dsh-plugin-dev.js', '--version'])
-check(version.status === 0 && /\d+\.\d+\.\d+/.test(version.stdout.trim()), `--version prints a semver (${version.stdout.trim()})`)
-
-const selfCheck = runNode(['dist/dsh-plugin-dev.js', 'check', '--json'], { stdio: ['ignore', 'pipe', 'pipe'] })
-let ok = false
-if (selfCheck.status === 0) {
-  try {
-    ok = JSON.parse(selfCheck.stdout).ok === true
-  } catch {
-    ok = false
-  }
-}
-check(selfCheck.status === 0 && ok, `self-check (dogfood) reports ok (exit ${selfCheck.status})`)
-
-// 3. Scaffold smoke in a mkdtemp sandbox.
-const sandbox = mkdtempSync(join(tmpdir(), 'dsh-pd-artifacts-'))
-try {
-  for (const lang of ['ts', 'js']) {
-    const target = join(sandbox, lang, 'demo-plugin')
-    const result = runNode(['dist/dsh-plugin-dev.js', 'new', 'demo-plugin', '--lang', lang, '--dir', target])
-    const hasEntry = lang === 'ts' ? existsSync(join(target, 'src', 'index.ts')) : existsSync(join(target, 'index.js'))
-    const hasPatch = existsSync(join(target, 'cordis.patch.yml'))
-    const readmeCount = readdirSync(target).filter((f) => /^README(-\w{2})?\.md$/.test(f)).length
-    check(result.status === 0 && hasEntry && hasPatch, `${lang} scaffold produces entry + cordis.patch.yml (exit ${result.status})`)
-    check(readmeCount === 5, `${lang} scaffold produces 5 README languages (${readmeCount})`)
-
-    // Round-trip the scaffolder through the checker. This is the assertion whose
-    // absence let `new --lang js` fail `check` for as long as it did: the
-    // scaffolder and the checker disagreed about whether a build-artifact
-    // directory is mandatory, and nothing ever ran one against the other. The
-    // golden path a user follows is exactly this pair, so it is the pair the
-    // artifact gate must exercise.
-    const scaffoldCheck = runNode(['dist/dsh-plugin-dev.js', 'check', '--cwd', target, '--json'], { stdio: ['ignore', 'pipe', 'pipe'] })
-    let scaffoldOk = false
-    let scaffoldDetail = ''
-    try {
-      const parsed = JSON.parse(scaffoldCheck.stdout)
-      scaffoldOk = parsed.ok === true
-      if (!scaffoldOk) {
-        scaffoldDetail = (parsed.checks ?? [])
-          .filter((c) => c.status === 'fail')
-          .map((c) => c.id)
-          .join(', ')
-      }
-    } catch {
-      scaffoldDetail = 'unparseable --json output'
-    }
-    check(
-      scaffoldCheck.status === 0 && scaffoldOk,
-      `${lang} scaffold passes the checker (exit ${scaffoldCheck.status}${scaffoldDetail ? `; failing: ${scaffoldDetail}` : ''})`,
-    )
-  }
-
-  // 3b. Extension contract for the TS scaffold. `platform: node` makes tsdown
-  // force `.mjs`/`.cjs` unless `fixedExtension` is disabled, while the scaffolded
-  // package.json declares `lib/index.js` + `lib/index.d.ts`. When those two
-  // disagree the build succeeds and `main` resolves to nothing, so the plugin
-  // installs and then silently never loads — with no error anywhere. Asserted
-  // offline (no install, no build) so the gate stays network-free.
-  const tsConfig = readFileSync(join(root, 'templates', 'ts', 'tsdown.config.mjs'), 'utf8')
-  check(
-    /fixedExtension\s*:\s*false/.test(tsConfig),
-    'ts template disables tsdown fixedExtension so the build emits the declared lib/index.js',
-  )
-} finally {
-  rmSync(sandbox, { recursive: true, force: true })
-}
-
-if (failures.length > 0) {
-  console.error(`\nverify:artifacts FAILED (${failures.length})`)
-  process.exit(1)
-}
-console.log('\nverify:artifacts OK')

package/scripts/verify-kit.ps1

@@ -1,197 +0,0 @@
-# dsh-plugin-guide 完整性检查器
-# 用法: pwsh -File scripts/verify-kit.ps1 -Root <路径>
-# 校验范围: 本知识库自有文档(SKILL/README/NOTICE/guide/references 顶层);
-# 官方文档副本(references/official-docs)是逐字副本,其内部链接指向 deepseek-harness checkout,不在校验范围。
-param([string]$Root = '', [string]$Checkout = '', [switch]$Strict)
-if ([string]::IsNullOrEmpty($Root)) { $Root = if ($PSScriptRoot) { Split-Path $PSScriptRoot -Parent } else { (Get-Location).Path } }
-$ErrorActionPreference = 'SilentlyContinue'
-$issues = New-Object System.Collections.Generic.List[string]
-$info = New-Object System.Collections.Generic.List[string]
-
-# ---- 1) 关键路径 ----
-$critical = @(
-  'SKILL.md','README.md','README-zh.md','README-es.md','README-pt.md','README-hi.md','LICENSE','NOTICE.md','.gitignore',
-  # 2026-10-13: 入口点与行尾策略。index.js/index.d.ts 曾是唯一无测试、也不受门禁保护的出厂代码，
-  # CRLF 缺陷就是从那里进的（见 tests/entry.test.ts 顶部注释）；.gitattributes 是那类缺陷的根治手段。
-  'index.js','index.d.ts','.gitattributes',
-  'CONTRIBUTING.md','SECURITY.md','.github/ISSUE_TEMPLATE/bug_report.yml','.github/ISSUE_TEMPLATE/feature_request.yml','.github/PULL_REQUEST_TEMPLATE.md',
-  'guide/plugin-dev-guide.md','guide/quick-reference.md','guide/links.md','guide/quick-reference.zh-CN.md','guide/quick-reference.es.md','guide/quick-reference.pt.md','guide/quick-reference.hi.md',
-  # 2026-10-13: 补齐 gated 文件——这些曾被漏掉，导致陈旧内容能存活到发布
-  'guide/version-matrix.md','guide/family-toolchain.md','guide/migration-0.2.md','guide/unfixed-issues.md',
-  'guide/release-engineering.md','guide/release-engineering.zh-CN.md',
-  'guide/when-to-retire-a-plugin.md','guide/when-to-retire-a-plugin.zh-CN.md',
-  'guide/choosing-a-plugin.md','guide/choosing-a-plugin.zh-CN.md',
-  'references/sources.md','references/harness-repo.md','references/website-pages.md',
-  'references/official-plugin-dev-skill.md','references/dev-resource-landscape.md',
-  'src/cli/skill-sections.ts','src/cli/templates.ts',
-  'references/upstream-cordis.md','references/cordis-paper-and-community.md',
-  'references/community-ecosystem.md','references/community-repo-deep-dive.md',
-  'references/official-docs/docs/cordis-primer.md',
-  'references/official-docs/docs/cordis-tutorial/index.md',
-  'references/official-docs/docs/cordis-tutorial/01-first-plugin.md',
-  'references/official-docs/docs/cordis-tutorial/02-lifecycle-and-effects.md',
-  'references/official-docs/docs/cordis-tutorial/03-services.md',
-  'references/official-docs/docs/cordis-tutorial/04-events.md',
-  'references/official-docs/docs/cordis-tutorial/05-config.md',
-  'references/official-docs/docs/cordis-tutorial/06-composition-and-hmr.md',
-  'references/official-docs/docs/cordis-tutorial/07-into-the-harness.md',
-  'references/official-docs/docs/architecture.md',
-  'references/official-docs/docs/cookbook/extension-cookbook.md',
-  'references/official-docs/docs/cookbook/adding-a-tool.md',
-  'references/official-docs/docs/event-producer-consumer.md',
-  'references/official-docs/docs/user/develop/basic/index.md',
-  'references/official-docs/docs/user/develop/basic/tool.md',
-  'references/official-docs/docs/user/develop/basic/config.md',
-  'references/official-docs/docs/user/develop/basic/publish.md',
-  'references/official-docs/docs/user/develop/framework/service.md',
-  'references/official-docs/docs/user/develop/framework/events.md',
-  'references/official-docs/docs/user/develop/practice/index.md',
-  'references/official-docs/docs/user/develop/practice/llm-adapter.md',
-  'references/official-docs/docs/subsystems/session.md',
-  'references/official-docs/docs/subsystems/tools.md',
-  'references/official-docs/docs/cordis-api/context.md',
-  'references/official-docs/AGENTS.md',
-  'references/official-docs/SNAPSHOT.md',
-  'references/official-docs/packages/AGENTS.md',
-  'references/official-docs/packages/README.md',
-  'references/official-docs/vendor/README.md',
-  'scripts/download-sources.ps1','scripts/download-community-repos.ps1','scripts/gen-topic-snapshot.ps1','scripts/sync-official-docs.ps1','scripts/install-skill.ps1','scripts/verify-kit.ps1','scripts/archive-discussions.ps1','scripts/download-community-articles.ps1'
-)
-foreach ($c in $critical) { if (-not (Test-Path (Join-Path $Root $c))) { $issues.Add("CRITICAL-MISSING: $c") } }
-$info.Add("critical: $($critical.Count) 项, 缺失 $((($issues | Where-Object { $_ -like 'CRITICAL-*' }) | Measure-Object).Count)")
-
-# ---- 1b) 归档内容断言(防止同名文件错位: 历史事故是 examples/AGENTS.md 被当成仓库根 AGENTS.md) ----
-function Assert-FirstLine([string]$rel, [string]$pattern, [string]$expect) {
-  $p = Join-Path $Root $rel
-  if (-not (Test-Path $p)) { return }
-  $first = Get-Content $p -Encoding UTF8 | Where-Object { $_.Trim() -ne '' } | Select-Object -First 1
-  if ($first -notlike $pattern) { $issues.Add("CONTENT-ASSERT-FAIL: $rel 首行应为 $expect, 实际: $first") }
-}
-Assert-FirstLine 'references/official-docs/AGENTS.md'           '# AGENTS.md'                     "仓库根 AGENTS.md 标题"
-Assert-FirstLine 'references/official-docs/packages/AGENTS.md' '# AGENTS.md*Harness Packages*'  "packages/AGENTS.md 标题"
-
-# ---- 2) 自有文档相对链接解析 ----
-# 只检查 markdown 链接目标(读者会点击的);代码块/行内码里的裸词不参与,
-# 避免把 name、ctx、- 等片段误判为路径。链接按"相对所在文件目录"解析;
-# downloads/ 引用允许,指向 checkout 的逃逸链接(../../、../packages/ 等)跳过。
-$scopeFiles = @((Join-Path $Root 'SKILL.md'), (Join-Path $Root 'README.md'), (Join-Path $Root 'NOTICE.md'))
-$scopeFiles += Get-ChildItem (Join-Path $Root 'guide') -Filter *.md -File
-$scopeFiles += Get-ChildItem (Join-Path $Root 'references') -Filter *.md -File   # 仅顶层,不含 official-docs 子树
-$missing = 0; $downloadsRefs = 0; $repoRelRefs = 0; $absRefs = 0
-
-function Is-PathToken([string]$t) {
-  # 纯 ASCII 相对路径:含斜杠(guide/links.md、../references/x.md)或带扩展名(README.md);
-  # 裸词、含空格/CJK 的引文片段不参与检查
-  return $t -match '^(\.\./)?(\./)?(([A-Za-z0-9][A-Za-z0-9_.\-]*/)+[A-Za-z0-9_.\-]+(\.[A-Za-z0-9]+)?|[A-Za-z0-9][A-Za-z0-9_.\-]+\.[A-Za-z0-9]+)(#[A-Za-z0-9_\-/]+)?$'
-}
-function Test-FileRel([string]$p, [string]$dir) {
-  $p = $p -replace '^\./',''
-  $p = $p -replace '[?#].*$',''
-  if ($p -match '[*]') { $d = Split-Path (Join-Path $dir $p) -Parent; return Test-Path $d }
-  return Test-Path (Join-Path $dir $p)
-}
-
-foreach ($f in $scopeFiles) {
-  if (-not (Test-Path $f.FullName)) { continue }
-  $relFile = $f.FullName.Substring($Root.Length + 1)
-  $fileDir = Split-Path $f.FullName -Parent
-  $text = Get-Content $f.FullName -Raw -Encoding UTF8
-  $tokens = New-Object System.Collections.Generic.HashSet[string]
-  foreach ($m in [regex]::Matches($text, '\[[^\]]*\]\(([^)\s]+)\)')) {
-    $t = $m.Groups[1].Value.Trim()
-    if ($t -match '^https?://' -or $t -match '^[A-Za-z]:[\\/]' -or $t -match '^(<|\$|#)') { continue }
-    if ($t -match '^[A-Za-z]:[\\/]') { $absRefs++; continue }
-    if (-not (Is-PathToken $t)) { continue }
-    [void]$tokens.Add($t)
-  }
-  foreach ($t in $tokens) {
-    if ($t -match '^(\.\./){2,}' -or $t -match '^\.\./packages/|^\.\./\.agents/') { $repoRelRefs++; continue }
-    if ($t -match '^(\./)?downloads/') { $downloadsRefs++; continue }
-    if (-not (Test-FileRel $t $fileDir)) { $missing++; $issues.Add("LINK-MISSING: [$relFile] -> $t") }
-  }
-}
-$info.Add("link-scan: $($scopeFiles.Count) 个自有文档; 缺失 $missing; downloads 引用 $downloadsRefs(允许); checkout 相对链接 $repoRelRefs(跳过); 绝对路径 $absRefs(信息)")
-
-# ---- 3) 功能文档中的本机绝对路径(设计内的回退/示例,仅信息) ----
-foreach ($f in @('SKILL.md','README.md','guide/plugin-dev-guide.md','guide/quick-reference.md','guide/links.md')) {
-  $hits = Select-String -Path (Join-Path $Root $f) -Pattern 'D:\\deepseek-harness' -AllMatches
-  foreach ($h in $hits) { $info.Add("ABS-PATH(设计内回退/示例): [$f] L$($h.LineNumber)") }
-}
-
-# ---- 4) 官方文档副本与 checkout 漂移校验(可选: -Checkout <deepseek-harness 路径>) ----
-# 把副本与 ref(origin/master, 回退 HEAD)的 git blob 逐一对比: 与工作树/本地未推送提交无关, 只回答"副本与上游是否一致"。
-if ($Checkout -and (Test-Path $Checkout)) {
-  $kbDocs = Join-Path $Root 'references\official-docs'
-  $driftCount = 0; $kbExtra = 0; $missingKb = 0; $checkedDrift = 0
-  $gitOk = (& git -C $Checkout rev-parse --is-inside-work-tree 2>$null) -eq 'true'
-  if (-not $gitOk) {
-    $info.Add("checkout-drift: $Checkout 不是 git 仓库, 跳过(使用 scripts/sync-official-docs.ps1 的非 git 模式同步)")
-  } else {
-    $ref = if ((& git -C $Checkout rev-parse --verify -q origin/master 2>$null)) { 'origin/master' } else { 'HEAD' }
-    $map = @{
-      'docs'                   = 'docs';
-      'AGENTS.md'              = 'AGENTS.md';
-      'BENCHMARK.md'           = 'BENCHMARK.md';
-      'CONTRIBUTING.md'        = 'CONTRIBUTING.md';
-      'CONTRIBUTING.zh.md'     = 'CONTRIBUTING.zh.md';
-      'CONTRIBUTING.i18n.yaml' = 'CONTRIBUTING.i18n.yaml';
-      'README-zh.md'           = 'README-zh.md';
-      'README.i18n.yaml'       = 'README.i18n.yaml';
-      'THIRD_PARTY_NOTICES.md' = 'THIRD_PARTY_NOTICES.md';
-      'LICENSE'                = 'LICENSE';
-      'packages/AGENTS.md'     = 'packages\AGENTS.md';
-      'packages/README.md'     = 'packages\README.md';
-      'vendor/README.md'       = 'vendor\README.md';
-      'website/docs.ts'        = 'website-docs.ts'
-    }
-    # CLAUDE.md 上游是 symlink(blob 为目标路径文本), 与 KB 普通文件 blob 必然不同——单独比对目标文本内容。
-    $claudeUpstream = (& git -C $Checkout cat-file -p "${ref}:CLAUDE.md" 2>$null | Select-Object -First 1)
-    if ($claudeUpstream) {
-      $claudeKb = Join-Path $kbDocs 'CLAUDE.md'
-      if (Test-Path $claudeKb) {
-        $claudeKbContent = (Get-Content $claudeKb -Raw -Encoding UTF8).Trim()
-        if ($claudeKbContent -ne $claudeUpstream.Trim()) { $issues.Add("CHECKOUT-DRIFT: CLAUDE.md symlink 目标文本与 $ref 不一致, 运行 sync-official-docs.ps1 同步") }
-      } else { $missingKb++; $issues.Add("CHECKOUT-DRIFT-MISSING-KB: CLAUDE.md -> 副本无此文件, 请运行 sync-official-docs.ps1") }
-    }
-    $keys = @($map.Keys)
-    foreach ($line in (& git -C $Checkout ls-tree -r $ref -- $keys)) {
-      if (-not $line) { continue }
-      $i = $line.IndexOf("`t")
-      if ($i -lt 0) { continue }
-      $path = $line.Substring($i + 1)
-      $sha = (($line.Substring(0, $i) -split '\s+')[2])
-      $checkedDrift++
-      $prefix = $null; $kbRel = $null
-      foreach ($k in $keys) { if ($path -eq $k -or $path.StartsWith("$k/")) { $prefix = $k; $kbRel = $map[$k]; break } }
-      if (-not $kbRel) { continue }
-      $suffix = if ($path -eq $prefix) { '' } else { $path.Substring($prefix.Length + 1) }
-      $kbPath = if ($suffix) { Join-Path (Join-Path $kbDocs $kbRel) ($suffix -replace '/','\') } else { Join-Path $kbDocs $kbRel }
-      if (-not (Test-Path $kbPath)) { $missingKb++; $issues.Add("CHECKOUT-DRIFT-MISSING-KB: $path -> 副本无此文件, 请运行 sync-official-docs.ps1"); continue }
-      $kbSha = (& git -C $Checkout hash-object $kbPath).Trim()
-      if ($kbSha -ne $sha) {
-        $driftCount++
-        if ($driftCount -le 10) { $issues.Add("CHECKOUT-DRIFT: $path 与 $ref 不一致(副本落后或超前于上游), 运行 sync-official-docs.ps1 同步") }
-      }
-    }
-    # KB 内多出、源 ref 已没有的文件(仅 docs/ 目录映射)
-    $docsDir = Join-Path $kbDocs 'docs'
-    if (Test-Path $docsDir) {
-      $docsRoot = (Resolve-Path $docsDir).Path
-      $treePaths = New-Object System.Collections.Generic.HashSet[string]
-      foreach ($line in (& git -C $Checkout ls-tree -r --name-only $ref -- docs)) { if ($line) { [void]$treePaths.Add($line) } }
-      Get-ChildItem -Recurse -File $docsDir | ForEach-Object {
-        $rel = 'docs/' + $_.FullName.Substring($docsRoot.Length + 1).Replace('\','/')
-        if (-not $treePaths.Contains($rel)) { $kbExtra++; $issues.Add("CHECKOUT-DRIFT-KB-EXTRA: 副本有、$ref 无: $rel (同步时会被清理)") }
-      }
-    }
-    $info.Add("checkout-drift: ref=$ref 比较 $checkedDrift 个 blob; 内容漂移 $driftCount, KB 缺失 $missingKb, KB 多余 $kbExtra")
-    if ($Strict -and ($driftCount -gt 0 -or $missingKb -gt 0 -or $kbExtra -gt 0)) { $issues.Add("CHECKOUT-DRIFT-STRICT: -Strict 下漂移视为失败") }
-  }
-} elseif ($Checkout) {
-  $issues.Add("CHECKOUT-MISSING: -Checkout 指定的路径不存在: $Checkout")
-}
-
-# ---- 输出 ----
-$info | ForEach-Object { Write-Output $_ }
-if ($issues.Count -gt 0) { $issues | ForEach-Object { Write-Output $_ }; Write-Output "ISSUES: $($issues.Count)"; exit 1 }
-Write-Output "VERIFY-OK"; exit 0

package/templates/js/LICENSE

@@ -1,15 +0,0 @@
-Apache License 2.0
-
-Copyright (c) {{year}} {{pkgName}} contributors
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.