dsh-primer 0.4.2 → 0.4.4

package/MIGRATION.md

@@ -4,8 +4,9 @@ This project was previously published as `dsh-plugin-guide`.
 
 - New package: `dsh-primer`
 - New repository: https://github.com/PerryLink/dsh-primer
-- Old repository: https://github.com/PerryLink/dsh-plugin-guide (kept as a pointer/backup)
-- Old npm package: deprecated, points here
+- Old repository: https://github.com/PerryLink/dsh-plugin-guide
+- Old npm package: `dsh-plugin-guide@0.3.x`, deprecated, points here
+- Legacy record: `LEGACY-0.3.42.md`
 
 Both CLI names work:
 
@@ -14,4 +15,16 @@ dsh-primer
 dsh-plugin-dev   # legacy alias
 ```
 
-New work happens in the new repository.
+## The old name was reused
+
+`dsh-plugin-guide` 0.4.0 is **not** a compatible update of the old agent skill.
+It is a different product: the prose guide and guide skill. The old code stays
+in this repository's history, and the old npm versions remain available for
+existing installs.
+
+The new guide is at:
+
+- Repository: https://github.com/PerryLink/dsh-plugin-guide
+- Package: `dsh-plugin-guide@0.4.0`
+
+New work on the old skill/CLI happens in `dsh-primer`.

package/README.md

@@ -22,13 +22,13 @@ Then just ask: *"Use the dsh-primer skill to build me a … plugin."*
 [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-primer?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-primer?ref=badge)
 [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-primer/badge)](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-primer)
 
-> **Official repository.** This is the only official repository of dsh-primer, maintained by PerryLink. Same-name repositories under other accounts are not affiliated.
+> **Canonical repository.** This is the repository dsh-primer is published from, maintained by PerryLink. Same-name repositories under other accounts are not affiliated.
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
 [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-primer.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
 [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-top-rated.svg)](https://dsh.market/)
-[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
+[![Node](https://img.shields.io/badge/node-%3E%3D24.9-brightgreen.svg)](#)
 [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-primer/verify.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-primer/actions)
 [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-primer?label=version)](https://github.com/PerryLink/dsh-primer/releases)
 [![npm version](https://img.shields.io/npm/v/dsh-primer)](https://www.npmjs.com/package/dsh-primer)
@@ -106,7 +106,7 @@ content counts as stated in the README (What you get)
 | Surface | Status |
 |---|---|
 | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.2` (`d743267388641bc76f17c45ce8b4c231aed1d32c`, the newest master tag **and** master HEAD, 2026-10-09); npm `latest` = `next` = `0.2.0-rc.2`, `alpha` = `0.2.1-alpha.2`. **There is no stable line** — all 31 npm versions and all 26 GitHub Releases are prereleases. The official-docs mirror is pinned to that same commit (429 md pages, re-synced 2026-10-13; see [references/official-docs/SNAPSHOT.md](references/official-docs/SNAPSHOT.md)). `guide/migration-0.2.md` covers `0.1.6-alpha.2` → `0.2.1-alpha.1` in §0–§12 and `0.2.1-alpha.1` → `0.2.1-alpha.2` as 19 citable seams in §13; the 20 breaking-change guides added since the previous baseline (19 under `v0.2.1-alpha.1` plus one backfilled into `v0.2.0-rc.2`) are all in the mirror. |
-| Node | `^22.19.0 || >=24.0.0` (DeepSeek Harness runtime) |
+| Node | `>=24.9.0` (DeepSeek Harness 0.2.2 runtime) |
 | Platforms | All (plain ESM bundle; no native code, no network) |
 | Model | Any (no model interaction) |
 
@@ -366,10 +366,10 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
 | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** |  |
 | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** |  |
 | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** |  |
-| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** |  |
+| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 FROZEN — see the repo README |
 | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** |  |
 | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** |  |
-| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** |  |
+| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 FROZEN — see the repo README |
 | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** |  |
 | **[dsh-click](https://github.com/PerryLink/dsh-click)** |  |
 | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** |  |

package/dist/dsh-plugin-dev.js

@@ -898,12 +898,13 @@ function checkManifestEngines(_root, pkg) {
 	};
 	const has22 = /\b22\b/.test(node);
 	const has24 = /\b24\b/.test(node);
-	if (!has22 || !has24) return {
+	const modernOnly = /^(>=\s*|\^|~)?\s*24(\.|$|\s)/.test(node.trim());
+	if (!has24 || !has22 && !modernOnly) return {
 		id: "manifest-engines",
 		severity: "error",
 		kind: "deterministic",
 		status: "fail",
-		message: `engines.node "${node}" should allow Node 22 and 24 (^22.19.0 || >=24.0.0)`,
+		message: `engines.node "${node}" must cover Node 24; drop Node 22 only with a range that starts at 24 (e.g. ">=24.9.0")`,
 		skillRef: ref
 	};
 	return {

package/guide/family-toolchain.md

@@ -70,7 +70,7 @@
 | `R3` | `cordis.patch.yml` 结构（启发式）：存在、解析为顶层 YAML **数组**；空数组合法；非空必须含 `- insert:` 与 ≥1 个 `id:`；每个 `name:` 等于或命名空间在包名之下 | skip · fail · pass | 否 |
 | `R4` | 入口契约：`main`/`exports` 入口存在且同时导出 `apply` 与 `name`；`inject` 是字符串字面量数组 | fail · warn · pass · skip | 否 |
 | `R5` | 依赖策略：① 任何位置不许裸 `cordis`/`schemastery`；② 导入的 `@deepseek-ai/cordis` 必须被声明；③ 它必须在 `peerDependencies` **和** `devDependencies`，**绝不** `dependencies`；④ `@deepseek-ai/dsh` 不得是直接 `dependencies` | fail · pass · skip | 否（`policy`） |
-| `R6` | `engines.node` 兼容 `^22.19.0 \|\| >=24.0.0`（只声明 Node 23 会失败） | fail · warn · pass | 否 |
+| `R6` | `engines.node` 覆盖 Node 24；`^22.19.0 \|\| >=24.0.0` 或（跟随 dsh 0.2.2-alpha.3 起）`>=24.9.0` 均可，只声明 Node 23 会失败 | fail · warn · pass | 否 |
 | `R7` | `files` 白名单已声明且覆盖入口 + patch；需要构建时入口不得指向源码 | fail · pass | 否 |
 | `R8` | 不得有指向已被取代的预发布线的陈旧 peer 范围（`0.1.0-rc.*`、`0.1.1-rc.*`、`0.1.2-alpha.*`、`0.1.3-alpha.*`），也不得有开顶 `>=` 范围 | skip · fail · warn · pass | 否（`policy`；"报告**陈旧**，不是**损坏**"） |
 

package/guide/migration-0.2.md

@@ -23,7 +23,7 @@
 | npm `alpha` / `next` | `alpha`=`0.2.1-alpha.2`、`next`=`0.2.0-rc.2` |
 | 是否存在稳定版 | **否**。全部 31 个 npm 版本都是 `-alpha.N`/`-rc.N`，全部 26 个 GitHub Release 都是 `prerelease: true` |
 | 区间内发布线（9 个） | `0.1.6-alpha.2`(09-17) → `0.1.7-alpha.1`(09-22) → `0.1.5-rc.3`(09-22) → `0.1.7-alpha.2`(09-22) → `0.1.7-rc.1`(09-23) → `0.1.7-rc.2`(09-24) → `0.2.0-rc.1`(09-28) → `0.2.0-rc.2`(09-29) → `0.2.1-alpha.1`(10-03) |
-| Node 门槛 | `^22.19.0 \|\| >=24.0.0`，**区间内未变**（无 `.nvmrc`/`.node-version` 文件） |
+| Node 门槛 | `^22.19.0 \|\| >=24.0.0`；跟随 dsh 0.2.2-alpha.3 的包可用 `>=24.9.0`（无 `.nvmrc`/`.node-version` 文件） |
 | `dsh.version` 字段 | **不存在**。DSH 的包清单只有 `dsh.bundle` / `dsh.profile` / `dsh.client` 三组键 |
 | 官方发布说明在哪 | 仓库里**没有 `CHANGELOG.md`**、也没有 `docs/persistence-changes/releases/*` 新条目，所以逐版本说明只在 GitHub **Releases** 的 body 里（`gh release view <tag>` 或 Releases API）。本文件的每一条都对照过 tag `dsh-v0.1.7-alpha.1` / `dsh-v0.2.0-rc.2` / `dsh-v0.2.1-alpha.1` 的发布说明 |
 

package/guide/standards.md

@@ -70,7 +70,7 @@ G0–G2 and G4 pass in static inspection, which supports `recognized`; `runtime`
 
 **What it does not claim.** Security, UI correctness, production readiness, full feature correctness, official endorsement, or that the plugin will work on an untested DSH line.
 
-**How to self-check.** Record `dsh --version`, the host commit, and the artifact mtime. Run `dsh-plugin-dev check --json` for the 16 local static checks (a subset of `dsh-plugin-doctor`'s 33 — see [family-toolchain.md](family-toolchain.md)), then the standards repo's entry checker (commands below). For bundles, also run `dsh --profile <name> --dump-config` and look for `patch: entry <id> not found`, then boot and read the row states. Write the claim as `DSH-ENTRY: runtime (dsh 0.2.1-rc.2, commit <sha>, 2026-11-01)`.
+**How to self-check.** Record `dsh --version`, the host commit, and the artifact mtime. Run `dsh-plugin-dev check --json` for the 16 local static checks (a subset of `dsh-plugin-doctor`'s 33 — see [family-toolchain.md](family-toolchain.md)), then the standards repo's entry checker (commands below). For bundles, also run `dsh --profile <name> --dump-config` and look for `patch: entry <id> not found`, then boot and read the row states. Write the claim as `DSH-ENTRY: runtime (dsh 0.2.2-alpha.3, commit <sha>, 2026-11-04); Node >=24.9`.
 
 ## DSH-FLOW: adoption experience
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-primer",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "DSH plugin development as an on-demand agent skill: official docs mirror, version-compatibility matrix, migration seams, measured pitfalls, plus a scaffolder, checker and pack verifier CLI.",
   "type": "module",
   "main": "index.js",
@@ -120,7 +120,7 @@
     }
   },
   "engines": {
-    "node": "^22.19.0 || >=24.0.0",
+    "node": ">=24.9.0",
     "dsh": ">=0.2.1-0 <0.3.0"
   },
   "packageManager": "pnpm@11.7.0",