dsh-engram 0.3.6 → 0.4.0

package/scripts/gen-release-notes.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+/**
+ * dsh-engram release-note helper.
+ *
+ * Prints the required "DSH 版本支持" markdown stanza for a release note by
+ * reading the single source of truth in package.json (engines.dsh + the
+ * @deepseek-ai/dsh-* peers), so the declared compatibility can never drift
+ * from what the package.json actually claims.
+ *
+ * Usage:
+ *   node scripts/gen-release-notes.mjs            # print the stanza
+ *   node scripts/gen-release-notes.mjs --watch    # also echo engines + peers
+ */
+
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const pkg = JSON.parse(readFileSync(resolve(root, "package.json"), "utf8"));
+
+const engines = pkg.engines ?? {};
+const peers = pkg.peerDependencies ?? {};
+
+const DSH_PEER_PREFIX = "@deepseek-ai/dsh-";
+const dshPeers = Object.entries(peers)
+  .filter(([name]) => name.startsWith(DSH_PEER_PREFIX))
+  .sort(([a], [b]) => a.localeCompare(b));
+
+const range = engines.dsh;
+const legacyOld =
+  !range && dshPeers.every(([, r]) => r.includes("0.1.0-rc.7"));
+const supportLine = legacyOld
+  ? "仅旧版 —— `0.1.0-rc.7` / `0.1.0-rc.8` / `0.1.1-rc.1` / `0.1.1-rc.2`"
+  : range ?? "（package.json 未声明 engines.dsh —— 补注历史版本时按上一行规则填写）";
+
+const peerLine = dshPeers.length
+  ? dshPeers.map(([n, r]) => `  - \`${n}\`: \`${r}\``).join("\n")
+  : "  - （无 @deepseek-ai/dsh-* peer 声明）";
+
+const body = `## DSH 版本支持
+
+- **支持的 DSH 范围**：${supportLine}
+- **peer 声明**：
+${peerLine}
+${
+  legacyOld
+    ? "- ⚠️ DSH `>=0.1.2-alpha.2` 与本版本**不兼容**（settings/client API 族在该版本断裂：`@deepseek-ai/dsh-settings` 移除 `settingsNamespace`/`installSettingsSection`，改 `settings.installSection`；client 注入集换到 `dsh-api-remotes` 等；cordis `^4.0.2`、schemastery `^3.18.2`）。如需新版 DSH，请升级插件到 `master` 的下一个发布。"
+    : range
+      ? `- **验证版本**：<如 dsh-v0.1.5-alpha.1>（本地 deepseek-harness checkout）
+- **最后验证日期**：<YYYY-MM-DD>
+- **安装方式已验证**：<如 dsh plugin --profile web add dsh-engram>`
+      : ""
+}
+`;
+
+if (process.argv.includes("--watch")) {
+  console.log(`engines.dsh = ${range ?? "<未声明>"}`);
+  console.log(`engines.node = ${engines.node ?? "<未声明>"}`);
+  console.log(`@deepseek-ai/cordis peer = ${peers["@deepseek-ai/cordis"] ?? "<未声明>"}`);
+  console.log(`@deepseek-ai/schemastery peer = ${peers["@deepseek-ai/schemastery"] ?? "<未声明>"}`);
+  console.log("---");
+}
+process.stdout.write(body);

package/scripts/prepublish-check.mjs

@@ -23,10 +23,10 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const tmp = mkdtempSync(join(tmpdir(), "dsh-engram-pack-"));
 const PEERS = [
-  "@deepseek-ai/cordis@^4.0.1",
-  "@deepseek-ai/dsh-settings@^0.1.0-rc.7",
-  "@deepseek-ai/dsh-storage-domain@^0.1.0-rc.7",
-  "@deepseek-ai/schemastery@^3.18.1",
+  "@deepseek-ai/cordis@^4.0.2",
+  "@deepseek-ai/dsh-settings@>=0.1.2-alpha.2 <0.2.0-0",
+  "@deepseek-ai/dsh-storage-domain@>=0.1.2-alpha.2 <0.2.0-0",
+  "@deepseek-ai/schemastery@^3.18.2",
 ];
 
 function sh(cmd, args, cwd) {

package/scripts/setup-links.mjs

@@ -93,6 +93,11 @@ function findStoreZod(harness) {
 function buildPlan(harness) {
   const zodDir = findStoreZod(harness);
   const plan = [
+    {
+      label: "@deepseek-ai/cordis",
+      mount: join(SCOPE, "cordis"),
+      target: join(harness, "vendor", "cordis"),
+    },
     {
       label: "zod",
       mount: join(NODE_MODULES, "zod"),
@@ -141,7 +146,9 @@ function buildPlan(harness) {
 function isInstalled(mount, expected) {
   if (existsSync(mount)) {
     try {
-      if (resolve(readlinkSync(mount)) === resolve(expected)) return true;
+      // readlinkSync() returns a relative target for pnpm-created links; resolve
+      // it from the mount's parent, rather than from the process cwd.
+      return resolve(dirname(mount), readlinkSync(mount)) === resolve(expected);
     } catch {
       /* not a symlink — fall through */
     }
@@ -185,24 +192,27 @@ function ensureLink(item) {
       return;
     }
     // 允许替换：符号链接直接 unlink；pnpm 预建的空目录用 rmdir 清掉。
+    let removed = false;
     try {
       unlinkSync(mount);
       console.log(`  ~ ${label}: 替换旧链接`);
-      return;
+      removed = true;
     } catch {
       /* not a symlink */
     }
-    try {
-      if (readdirSync(mount).length === 0) {
-        rmdirSync(mount);
-        console.log(`  ~ ${label}: 移除空目录后重建`);
-      } else {
-        console.log(`  ! ${label}: ${mount} 是含文件的真实目录，无法自动替换，请手动清理后重试`);
+    if (!removed) {
+      try {
+        if (readdirSync(mount).length === 0) {
+          rmdirSync(mount);
+          console.log(`  ~ ${label}: 移除空目录后重建`);
+        } else {
+          console.log(`  ! ${label}: ${mount} 是含文件的真实目录，无法自动替换，请手动清理后重试`);
+          return;
+        }
+      } catch {
+        console.log(`  ! ${label}: ${mount} 无法自动替换，请手动清理后重试`);
         return;
       }
-    } catch {
-      console.log(`  ! ${label}: ${mount} 无法自动替换，请手动清理后重试`);
-      return;
     }
   }
   if (CHECK_ONLY) {