dsh-m 0.9.23 → 0.9.25

package/lib/core/release-age.js

@@ -1,35 +1,34 @@
 /**
- * Desktop 供应链等待期（minimumReleaseAge）预检与失败翻译（0.9.19）。
+ * 供应链等待期（minimumReleaseAge）预检与失败翻译（0.9.19 立基，0.9.x 按治理语义收敛，ADR-0009）。
  *
- * pnpm 11.7 实机实证（2026-10-03，本机 desktop profile，官方管理器操作日志
- * operation-hNjgaN / operation-l5fXEd）：
- * 1. 显式安装「太新」目标：非严格模式放行，pnpm 自动向 pnpm-workspace.yaml 的
- *    `minimumReleaseAgeExclude` 追加一条「独立精确条目」（`pkg@ver` 形态）；
- * 2. 但后续任何包操作的锁文件级供应链校验（`Verifying lockfile against
- *    supply-chain policies (N entries)`）不认可 pnpm 自己追加的这种条目——
- *    任何一条未满期的 `pkg@ver` 都会拦死整个安装，且与本次目标无关（旁包能拦住
- *    所有升级，0.9.18 拦住 quota-watch 0.1.15 升级即实证）；
+ * 实证基准（2026-10-03，本机 desktop profile，pnpm 11.7.0，官方管理器操作日志
+ * operation-zsc4ei / operation-L8oq1z / operation-l5fXEd）：
+ * 1. 默认策略（未显式设置 age、未开 strict = 非严格）下，显式点名的「太新」目标
+ *    直接放行安装，pnpm 自动向 pnpm-workspace.yaml 的 `minimumReleaseAgeExclude`
+ *    追加 `pkg@ver` 条目（"Added 1 entry …"）；
+ * 2. pnpm 的 evaluateVersionPolicy **每包名只认第一条排除规则**，同名后续规则死亡
+ *    （dshmarket #732 实证，首条规则生效机理）——死规则会让等待期内全部包操作被
+ *    锁文件级校验拦死（0:15 quota-watch 连坐实录）；
  * 3. 校验失败前目标包可能已写入 node_modules，官方管理器只回滚 manifest/lockfile
- *    →「账实分裂」：界面实装新版 active，账本仍旧版，下次包操作静默回退。
+ *    →「账实分裂」，下次包操作静默回退。
  *
- * 对策（零文件级红线不破：只读 profile 文件，绝不写）：
- * ① 委派前预检（releaseAgePrecheck）：目标版本或锁内「不被校验认可的独立精确
- *    排除条目」任一未满等待期 → 结构化拒绝，不委派官方管理器；
+ * 职责（ADR-0009）：
+ * ① 委派前预检（releaseAgePrecheck）：仅「显式设置 age 或 strict 开启」时对窗口内
+ *    目标拒绝（附可重试时刻）；默认策略放行并返回陈述性 notice。锁内坏形态由
+ *    exclude-governance 的治理挂点处理，本模块不再预拒绝（0.9.19 ②腿退役）。
  * ② 失败翻译（describeReleaseAgeFailure）：解析全部违规条目，按「本次目标 vs
- *    锁内旁包」分别给出发布时刻与可重试时刻——不再把旁包名字冒充成本次目标被拦。
+ *    旁包」分述发布时刻与可重试时刻。
+ * ③ cachedPackumentTimes：预检与登记共用的带缓存 packument 探测。
  *
- * fail-open 纪律：发布时刻不可得 / 策略文件不可读 / profileDir 缺席 / 命中有效排除
- * 条目（包名级、`||` 复合、scoped 独立精确）→ 一律放行；pnpm 仍是最终执行者。
+ * fail-open 纪律：发布时刻不可得 / 策略文件不可读 / profileDir 缺席 / 命中任一
+ * 排除规则（首条规则口径）→ 一律放行；pnpm 仍是最终执行者。
  */
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { isMap, isScalar, isSeq, parseDocument } from 'yaml';
 import { fetchJsonLimited } from './httpx.js';
-import { isExactVersion } from './versions.js';
 /** pnpm 11.7 实机测得的策略窗口：24h（operation-l5fXEd 的 cutoff = 检查时刻 − 1440min）。 */
 export const DEFAULT_MINIMUM_RELEASE_AGE_MIN = 1440;
-/** 锁内「独立精确排除条目」旁包探测上限（防清单失控；超出部分放弃预判，交 pnpm 兜底）。 */
-export const MAX_EXCLUDE_PROBES = 8;
 function scalarNumber(value) {
     if (typeof value === 'number' && Number.isFinite(value))
         return value;
@@ -43,7 +42,7 @@ function scalarNumber(value) {
  * 调用方按默认窗口 + 无排除处理，绝不抛。
  */
 export function parseWorkspacePolicy(text) {
-    const empty = { minimumReleaseAgeMin: null, excludes: [] };
+    const empty = { explicitAge: false, minimumReleaseAgeMin: null, strict: false, excludes: [] };
     let document;
     try {
         document = parseDocument(text);
@@ -62,10 +61,17 @@ export function parseWorkspacePolicy(text) {
             }
         }
     }
-    // yaml 库的 Map.get() 对标量返回已解包的原始值（number/string），对集合返回节点——两种形态都兜住
+    // yaml 库的 Map.get() 对标量返回已解包的原始值（number/string/boolean），对集合返回节点——两种形态都兜住
     const rawAge = document.contents.get('minimumReleaseAge');
     const age = isScalar(rawAge) ? scalarNumber(rawAge.value) : scalarNumber(rawAge);
-    return { minimumReleaseAgeMin: age !== null && age > 0 ? age : null, excludes };
+    const rawStrict = document.contents.get('minimumReleaseAgeStrict');
+    const strict = rawStrict === true || (isScalar(rawStrict) && rawStrict.value === true);
+    return {
+        explicitAge: rawAge !== undefined && rawAge !== null,
+        minimumReleaseAgeMin: age !== null && age > 0 ? age : null,
+        strict,
+        excludes,
+    };
 }
 export function excludeMatch(selector, pkg, version) {
     const s = selector.trim();
@@ -73,7 +79,7 @@ export function excludeMatch(selector, pkg, version) {
         return 'no';
     if (s.includes('||')) {
         for (const part of s.split('||')) {
-            if (excludeMatch(part.trim(), pkg, version) !== 'no')
+            if (excludeMatch(part.trim(), pkg, version) === 'effective')
                 return 'effective';
         }
         return 'no';
@@ -83,30 +89,7 @@ export function excludeMatch(selector, pkg, version) {
         // 包名级（dshmarket）或裸版本号段（只应出现在复合条目内，顶层出现视为包名比较）
         return s === pkg || s === version ? 'effective' : 'no';
     }
-    const namePart = s.slice(0, at);
-    const verPart = s.slice(at + 1);
-    if (namePart !== pkg)
-        return 'no';
-    if (verPart === version) {
-        return pkg.startsWith('@') ? 'effective' : 'unreliable-unscoped-exact';
-    }
-    return 'no';
-}
-/** 从独立精确条目提取 (pkg, version)；复合/包名级/版本段非精确 semver → null。 */
-export function splitExactSelector(selector) {
-    const s = selector.trim();
-    if (s === '' || s.includes('||'))
-        return null;
-    const at = s.lastIndexOf('@');
-    if (at <= 0)
-        return null;
-    const pkg = s.slice(0, at);
-    const version = s.slice(at + 1);
-    if (!isExactVersion(version))
-        return null;
-    if (!/^@?[A-Za-z0-9-._~]+(\/[A-Za-z0-9-._~]+)?$/.test(pkg))
-        return null;
-    return { pkg, version, reliable: pkg.startsWith('@') };
+    return s.slice(0, at) === pkg && s.slice(at + 1) === version ? 'effective' : 'no';
 }
 const VIOLATION_RE = /(\S+@\S+) was published at ([^,]+), within the minimumReleaseAge cutoff \(([^)]+)\)/g;
 /** 解析 pnpm 诊断里的全部等待期违规条目（0.9.10 只取第一条是「报错报错包」的根因之一）。 */
@@ -196,72 +179,65 @@ export async function readWorkspacePolicy(profileDir) {
 }
 const packumentCache = new Map();
 const PACKUMENT_CACHE_TTL_MS = 5 * 60_000;
+/**
+ * 带进程内缓存的 packument time 探测（TTL 5min）：预检与登记（exclude-governance）
+ * 共用——同一操作里预检刚拉过的 packument 不二次拉取（8MiB 级全量）。
+ */
+export async function cachedPackumentTimes(pkg, timeoutMs = 12_000, signal) {
+    const hit = packumentCache.get(pkg);
+    if (hit && Date.now() - hit.at < PACKUMENT_CACHE_TTL_MS)
+        return hit.times;
+    const times = await npmPackumentTimes(pkg, timeoutMs, signal);
+    packumentCache.set(pkg, { at: Date.now(), times });
+    return times;
+}
 /** 测试钩子：清空 packument 进程内缓存。 */
 export function _resetReleaseAgeCachesForTests() {
     packumentCache.clear();
 }
 /**
- * 委派前预检：目标版本与锁内「不被校验认可的独立精确排除条目」逐个对发布时刻，
- * 任一未满等待期 → 结构化拒绝（blocked + 多行理由）。零写操作；不确定一律放行。
+ * 委派前预检（ADR-0009 收敛语义）：仅当策略显式设置 age 或开启 strict 时，对窗口内
+ * 且未被任一排除规则覆盖（首条规则口径）的目标结构化拒绝（附可重试时刻）；默认
+ * 策略（非严格）放行并返回陈述性 notice——官方管理器对显式点名的新版本会直接
+ * 安装并自动登记，锁内坏形态由 exclude-governance 的治理挂点处理。零写操作；
+ * fail-open：发布时刻不可得 / profileDir 缺席 / 命中排除规则 → 放行。
  */
 export async function releaseAgePrecheck(input) {
-    // profileDir 缺席 = 读不到操作员排除条目 → 不预判（避免误拦操作员显式 pin 的安装）
+    // profileDir 缺席 = 读不到操作员排除条目与策略 → 不预判
     if (!input.profileDir)
         return { blocked: false };
     const now = input.nowMs ?? Date.now();
     const policy = input.deps?.workspacePolicy
         ? await input.deps.workspacePolicy(input.profileDir)
         : await readWorkspacePolicy(input.profileDir);
-    const policyMin = policy?.minimumReleaseAgeMin ?? DEFAULT_MINIMUM_RELEASE_AGE_MIN;
+    const explicit = policy?.explicitAge ?? false;
+    const strict = policy?.strict ?? false;
+    const policyMin = explicit && policy?.minimumReleaseAgeMin != null ? policy.minimumReleaseAgeMin : DEFAULT_MINIMUM_RELEASE_AGE_MIN;
     const probe = async (pkg) => {
-        const hit = packumentCache.get(pkg);
-        if (hit && Date.now() - hit.at < PACKUMENT_CACHE_TTL_MS)
-            return hit.times;
-        const times = await (input.deps?.packumentTimes ?? npmPackumentTimes)(pkg, Math.min(input.timeoutMs ?? 20_000, 12_000), input.signal);
-        packumentCache.set(pkg, { at: Date.now(), times });
-        return times;
+        if (input.deps?.packumentTimes)
+            return input.deps.packumentTimes(pkg, Math.min(input.timeoutMs ?? 20_000, 12_000), input.signal);
+        return cachedPackumentTimes(pkg, 12_000, input.signal);
     };
-    const blockers = [];
-    // ① 本次目标版本的发布时刻（有效排除条目覆盖 → 放行）
     const times = await probe(input.pkg);
     const publishedAt = times ? Date.parse(times[input.version] ?? '') : NaN;
-    if (Number.isFinite(publishedAt)) {
-        const exempt = (policy?.excludes ?? []).some((sel) => excludeMatch(sel, input.pkg, input.version) === 'effective');
-        if (!exempt) {
-            const deadline = publishedAt + policyMin * 60_000;
-            if (now < deadline) {
-                blockers.push({ entry: `${input.pkg}@${input.version}`, role: 'target', publishedAt, deadline });
-            }
-        }
-    }
-    // ② 锁内「不被校验认可的独立精确排除条目」（非 scoped）——任何一条未满期都会拦死整次安装
-    const seen = new Set([`${input.pkg}@${input.version}`]);
-    const candidates = (policy?.excludes ?? [])
-        .map((sel) => splitExactSelector(sel))
-        .filter((x) => x !== null && !x.reliable);
-    for (const ex of candidates.slice(0, MAX_EXCLUDE_PROBES)) {
-        const entry = `${ex.pkg}@${ex.version}`;
-        if (seen.has(entry))
-            continue;
-        seen.add(entry);
-        const t2 = await probe(ex.pkg);
-        const pub = t2 ? Date.parse(t2[ex.version] ?? '') : NaN;
-        if (!Number.isFinite(pub))
-            continue;
-        const deadline = pub + policyMin * 60_000;
-        if (now < deadline) {
-            blockers.push({ entry, role: 'lockfile-exclude', publishedAt: pub, deadline });
-        }
-    }
-    if (blockers.length === 0)
+    if (!Number.isFinite(publishedAt))
         return { blocked: false };
-    const lines = ['官方管理器的供应链策略（minimumReleaseAge）将拦截本次安装，已提前拒绝（未触碰 profile 文件）：'];
-    for (const b of blockers) {
-        lines.push(b.role === 'target'
-            ? `· 目标 ${b.entry}：发布于 ${fmtLocal(b.publishedAt)}，预计 ${fmtLocal(b.deadline)} 后满等待期`
-            : `· 锁内排除条目 ${b.entry}：发布于 ${fmtLocal(b.publishedAt)}，预计 ${fmtLocal(b.deadline)} 后满等待期（pnpm 自动追加的独立精确条目不被锁文件校验认可，等待期内任何官方包操作都会被拦）`);
+    const exempt = (policy?.excludes ?? []).some((sel) => excludeMatch(sel, input.pkg, input.version) === 'effective');
+    const deadline = publishedAt + policyMin * 60_000;
+    if (exempt || now >= deadline)
+        return { blocked: false };
+    if (!explicit && !strict) {
+        return {
+            blocked: false,
+            notice: `目标 ${input.pkg}@${input.version} 发布于 ${fmtLocal(publishedAt)}（等待期内）：官方管理器将按显式点名安装，装好后 dsh-m 会登记豁免条目`,
+        };
     }
-    const maxDeadline = Math.max(...blockers.map((b) => b.deadline));
-    lines.push(`预计 ${fmtLocal(maxDeadline)} 后可重试；等待期内也可由操作员修正 pnpm-workspace.yaml 的排除条目形态（包名级/复合）解除拦截`);
-    return { blocked: true, message: lines.join('\n'), blockers };
+    const lines = ['官方管理器的供应链策略（minimumReleaseAge）将拦截本次安装，已提前拒绝（未触碰 profile 文件）：'];
+    lines.push(`· 目标 ${input.pkg}@${input.version}：发布于 ${fmtLocal(publishedAt)}，预计 ${fmtLocal(deadline)} 后满等待期`);
+    lines.push(`预计 ${fmtLocal(deadline)} 后可重试；等待期内也可由操作员修正 pnpm-workspace.yaml 的排除条目形态（包名级/复合）解除拦截`);
+    return {
+        blocked: true,
+        message: lines.join('\n'),
+        blockers: [{ entry: `${input.pkg}@${input.version}`, role: 'target', publishedAt, deadline }],
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-m",
-  "version": "0.9.23",
+  "version": "0.9.25",
   "description": "可自定义收录清单的 DSH 插件市场：收录、安装、卸载、升级一站完成，附 agent 工具与 dshm CLI。",
   "license": "MIT",
   "type": "module",

package/registry.json

@@ -99,10 +99,10 @@
     {
       "id": "dsh-copilot-auth",
       "name": "DSH Copilot Auth",
-      "description": "为内置 Copilot 提供方补登录/注销设置页与开箱路由；模型目录兜底不覆盖定制。适配 0.1.7-rc.2 与 0.2.0-rc.1，旧版用 1.1.x。",
+      "description": "内置 Copilot 登录注销页与开箱路由；目录兜底不覆盖定制，桌面版不支持目录刷新。已适配 0.1.7-rc.2 与 0.2.0-rc.1/rc.2。",
       "category": "self-dev",
       "tags": ["Copilot", "认证", "模型接入", "工具"],
-      "verified": ["0.1.7-rc.2", "0.2.0-rc.1"],
+      "verified": ["0.1.7-rc.2", "0.2.0-rc.1", "0.2.0-rc.2"],
       "source": "npm",
       "npm": "@inventec/dsh-copilot-auth",
       "github": "iasiv5/dsh-copilot-auth",
@@ -114,7 +114,7 @@
       "description": "GLM 与 Copilot 额度悬浮球：胶囊、详情面板与侧栏卡片，宿主解析凭据，适配 web 与 desktop。",
       "category": "self-dev",
       "tags": ["配额", "悬浮球", "GLM", "Copilot"],
-      "verified": ["0.1.7-rc.2", "0.1.0"],
+      "verified": ["0.1.7-rc.2", "0.2.0-rc.2"],
       "source": "npm",
       "npm": "@iasiv5/dsh-quota-watch",
       "github": "iasiv5/dsh-quota-watch",