dsh-plugin-update 0.1.2 → 0.3.0

package/dist/service.js

@@ -7,7 +7,12 @@ const RECHECK_WINDOW_MS = 2e3;
 const MAX_METADATA_BYTES = 256 * 1024;
 const INTEGRITY_PATTERN = "^sha512-[A-Za-z0-9+/]{86}==$";
 function validRequestId(v) {
-  return typeof v === "string" && v.trim().length >= 1 && v.trim().length <= 128;
+  if (typeof v !== "string") return false;
+  const id = v.trim();
+  if (id.length < 1 || id.length > 128) return false;
+  if (!/^[A-Za-z0-9._~-]+$/.test(id)) return false;
+  if (/^(npm_|gh[pousr]_|github_pat_|sk-|bearer)/i.test(id)) return false;
+  return true;
 }
 function updateError(code) {
   return Object.assign(new Error(code), { code });
@@ -15,6 +20,37 @@ function updateError(code) {
 function validVersion(v) {
   return typeof v === "string" && /^\d+\.\d+\.\d+$/.test(v);
 }
+const RELEASE_CHANNELS = ["stable", "prerelease"];
+function validReleaseChannel(v) {
+  return v === "stable" || v === "prerelease";
+}
+function validPrereleaseIds(ids) {
+  if (typeof ids !== "string" || !ids) return false;
+  const parts = ids.split(".");
+  if (parts.length === 0) return false;
+  for (const p of parts) {
+    if (!p || !/^[0-9A-Za-z-]+$/.test(p)) return false;
+    if (/^\d+$/.test(p) && p.length > 1 && p.startsWith("0")) return false;
+  }
+  return true;
+}
+function validReleaseVersion(v) {
+  if (typeof v !== "string" || !v) return false;
+  const dash = v.indexOf("-");
+  if (dash < 0) return validVersion(v);
+  const core = v.slice(0, dash);
+  const ids = v.slice(dash + 1);
+  if (!validVersion(core) || !validPrereleaseIds(ids)) return false;
+  if (ids.includes("+")) return false;
+  return true;
+}
+function isPrereleaseVersion(v) {
+  return validReleaseVersion(v) && !validVersion(v);
+}
+function isVersionAllowedInChannel(version, channel = "stable") {
+  if (channel === "prerelease") return validReleaseVersion(version);
+  return validVersion(version);
+}
 function parseTriple(v) {
   const parts = String(v).split(".");
   if (parts.length > 3) return null;
@@ -38,6 +74,40 @@ function compareVersions(a, b) {
   }
   return 0;
 }
+function parseReleaseIds(ids) {
+  return ids.split(".").map((p) => /^\d+$/.test(p) ? Number(p) : p);
+}
+function compareReleaseVersions(a, b) {
+  if (!validReleaseVersion(a) || !validReleaseVersion(b)) throw updateError("invalid-release");
+  const dashA = String(a).indexOf("-");
+  const dashB = String(b).indexOf("-");
+  const coreA = dashA < 0 ? String(a) : String(a).slice(0, dashA);
+  const coreB = dashB < 0 ? String(b) : String(b).slice(0, dashB);
+  const order = compareVersions(coreA, coreB);
+  if (order !== 0) return order;
+  const preA = dashA < 0 ? null : parseReleaseIds(String(a).slice(dashA + 1));
+  const preB = dashB < 0 ? null : parseReleaseIds(String(b).slice(dashB + 1));
+  if (preA === null && preB === null) return 0;
+  if (preA === null) return 1;
+  if (preB === null) return -1;
+  const width = Math.max(preA.length, preB.length);
+  for (let i = 0; i < width; i++) {
+    const x = preA[i];
+    const y = preB[i];
+    if (x === void 0) return -1;
+    if (y === void 0) return 1;
+    if (typeof x === "number" && typeof y === "number") {
+      if (x < y) return -1;
+      if (x > y) return 1;
+      continue;
+    }
+    if (typeof x === "number") return -1;
+    if (typeof y === "number") return 1;
+    if (x < y) return -1;
+    if (x > y) return 1;
+  }
+  return 0;
+}
 function compareOne(node, op, target) {
   const order = compareTriple(node, target);
   if (op === "=" || op === "") return order === 0;
@@ -102,9 +172,20 @@ function timeoutSignal(ms) {
   }
   return void 0;
 }
+function httpStatusOf(response) {
+  const raw = response?.status;
+  return typeof raw === "number" && Number.isInteger(raw) && raw >= 100 && raw <= 599 ? raw : null;
+}
+function checkFailedWithStatus(response) {
+  const err = updateError("check-failed");
+  const status = httpStatusOf(response);
+  if (status !== null) err.httpStatus = status;
+  return err;
+}
 async function fetchNpmRelease(fetchImpl, timeoutMs = CHECK_TIMEOUT_MS, opts) {
   const targetName = opts?.targetPackageName ?? PACKAGE_NAME;
   const registry = opts?.registryUrl ?? NPM_REGISTRY;
+  const channel = opts?.releaseChannel === "prerelease" ? "prerelease" : "stable";
   let response = null;
   try {
     response = await fetchImpl(`${registry}${encodeURIComponent(targetName)}/latest`, {
@@ -116,13 +197,13 @@ async function fetchNpmRelease(fetchImpl, timeoutMs = CHECK_TIMEOUT_MS, opts) {
     throw updateError("check-failed");
   }
   try {
-    if (!response.ok) throw updateError("check-failed");
+    if (!response.ok) throw checkFailedWithStatus(response);
     const declared = Number(response.headers.get("content-length"));
     if (Number.isFinite(declared) && declared > MAX_METADATA_BYTES) throw updateError("invalid-release");
     const text = await response.text();
     if (byteLength(text) > MAX_METADATA_BYTES) throw updateError("invalid-release");
     const value = JSON.parse(text);
-    if (value.name !== targetName || !validVersion(value.version)) throw updateError("invalid-release");
+    if (value.name !== targetName || !isVersionAllowedInChannel(value.version, channel)) throw updateError("invalid-release");
     const version = value.version;
     const nodeRange = value.engines?.node;
     if (nodeRange !== void 0 && typeof nodeRange !== "string") throw updateError("invalid-release");
@@ -142,7 +223,7 @@ async function fetchNpmRelease(fetchImpl, timeoutMs = CHECK_TIMEOUT_MS, opts) {
     if (error?.code === "check-failed") throw error;
     if (error?.code === "invalid-release") throw error;
     if (response !== null && response.ok) throw updateError("invalid-release");
-    throw updateError("check-failed");
+    throw checkFailedWithStatus(response);
   }
 }
 function createUpdateCore(ports) {
@@ -150,8 +231,9 @@ function createUpdateCore(ports) {
   const confirmationTtlMs = ports.confirmationTtlMs ?? CONFIRMATION_TTL_MS;
   const targetPackageName = ports.targetPackageName ?? PACKAGE_NAME;
   const registryUrl = ports.registryUrl ?? NPM_REGISTRY;
+  const releaseChannel = ports.releaseChannel === "prerelease" ? "prerelease" : "stable";
   function fetchRelease() {
-    return fetchNpmRelease(ports.fetchImpl, checkTimeoutMs, { targetPackageName, registryUrl });
+    return fetchNpmRelease(ports.fetchImpl, checkTimeoutMs, { targetPackageName, registryUrl, releaseChannel });
   }
   let checked = null;
   let checking = null;
@@ -215,8 +297,14 @@ function createUpdateCore(ports) {
     const busy = job?.state === "installing" || job?.state === "verifying";
     const fresh = checked !== null && checked.checkId !== null && ports.now() < checked.expiresAt;
     const runningVersion = ports.readRunningVersion();
+    let newer = false;
+    try {
+      newer = isVersionAllowedInChannel(runningVersion, releaseChannel) && !!checked?.release && isVersionAllowedInChannel(checked.release.version, releaseChannel) && compareReleaseVersions(checked.release.version, runningVersion) === 1;
+    } catch {
+      newer = false;
+    }
     const canInstall = Boolean(
-      env.eligible && !blockedReason && !busy && fresh && checked?.installationKey === env.installationKey && validVersion(runningVersion) && checked?.release && compareVersions(checked.release.version, runningVersion) === 1
+      env.eligible && !blockedReason && !busy && fresh && checked?.installationKey === env.installationKey && newer
     );
     return {
       runningVersion,
@@ -353,11 +441,17 @@ export {
   NPM_REGISTRY,
   PACKAGE_NAME,
   RECHECK_WINDOW_MS,
+  RELEASE_CHANNELS,
+  compareReleaseVersions,
   compareVersions,
   createUpdateCore,
   fetchNpmRelease,
+  isPrereleaseVersion,
+  isVersionAllowedInChannel,
   satisfiesNodeRange,
   updateError,
+  validReleaseChannel,
+  validReleaseVersion,
   validRequestId,
   validVersion
 };

package/dist/store.d.ts

@@ -0,0 +1,229 @@
+/**
+ * src/store.ts —— 更新任务的落盘与执行跑腿。
+ *
+ * 由 src/host/updateStore.js 改写拎入：只跑腿不决策。相对旧实现的增量（规格 #591）：
+ * 1. 状态目录按插件标识派生（第 3 条）：join(家目录, 'updates', 插件标识, 使用范围短指纹），
+ *    三文件名保持 state.json、install.lock、before.json 不变。
+ * 2. 默认旧路径冻结（第 14 条）：插件标识取旧值 dsh-mattpocock-skills-deck 时路径与旧原文
+ *    一字不差——下面的旧字面是永久冻结特例，注释永不删除（动默认即破冰）。
+ * 3. 读走双读、写只写新（第 7 条）：先读新路径，没有再回退读旧路径；写只写新路径，
+ *    旧路径只读不写永久留作只读影子。旧文件不动，清理另票再议。
+ * 4. 三处注入默认现状（第 4 条）：目标包名、官方源、安装时限经零件注入，默认值等于现状。
+ * 5. 安装执行日志带必填插件标识（第 8、13 条）：update.install.exec 加完标识后 5 键为基线。
+ *
+ * 安装执行按核心给的配方跑三条路由之一（第三方 Desktop 走桌面服务、官方桌面版交给宿主
+ * 进程内的插件管理器、普通 DSH 自己起进程），
+ * 本文件不按操作系统分支，也不拼 shell。决策顺序全在更新核心。测试一律用假零件，
+ * 不真写盘真跑命令（经可选的文件读写函数注入，默认走真文件系统）。
+ */
+import { type BatchSession } from './batch.js';
+import { type UpdateQueueState } from './queue.js';
+import type { EnvironmentKind, UpdateJob } from './ports.js';
+export interface UpdatePaths {
+    directory: string;
+    state: string;
+    lock: string;
+    backup: string;
+}
+/**
+ * 状态目录：家目录下按插件标识派生，短指纹只做同一性判断，不记原文。
+ * 插件标识取旧值时与旧原文一字不差（旧默认路径冻结，验收项）。
+ */
+export declare function pathsForUpdate(homeDir: string, pluginId: string, profileDir: string): UpdatePaths | null;
+/** 旧只读影子目录（规格 #591 第 7 条）：只读不写，永久留作回退读取用。 */
+export declare function legacyPathsForUpdate(homeDir: string, profileDir: string): UpdatePaths | null;
+export interface DiskPortsDeps {
+    readFileImpl?: (filename: string, encoding: string) => Promise<string>;
+    statImpl?: (filename: string) => Promise<{
+        size: number;
+    }>;
+}
+/**
+ * 建任务存取与锁：调用方按当前插件标识建一份，转交核心当零件。
+ * 读走双读（先新后旧），写只写新（旧影子只读不写）。
+ */
+export declare function createUpdateDiskPorts(homeDir: string, pluginId: string, profileDir: string, deps?: DiskPortsDeps): {
+    paths: UpdatePaths | null;
+    legacyPaths: UpdatePaths | null;
+    readJob: () => Promise<UpdateJob | null>;
+    writeJob: (job: UpdateJob | null) => Promise<void>;
+    tryAcquireLock: (lockId: string) => Promise<boolean>;
+    releaseLock: (lockId: string) => Promise<void>;
+    backupJob: (job: UpdateJob) => Promise<void>;
+};
+/** 跨插件队列的共享落盘（#15，新增强制串行的归属与持久化，不碰按插件隔离的旧树）。
+ *
+ * 归属：按使用范围共享——同一 (homeDir, profileDir) 的全部插件共用同一目录，
+ * 不同使用范围各用各的、可并行。父目录取 `update-queue`（与 `updates` 平级），
+ * 任何插件标识都撞不上（插件标识只能决定 `updates` 下的子目录名）。
+ * 文件：`queue.json`（owner + waiting，快照式整写），`global.lock`（执行互斥，
+ * 抢到才许装，一次只装一个）。
+ */
+export declare const QUEUE_DIR_SEGMENT = "update-queue";
+export declare const QUEUE_FILE = "queue.json";
+export declare const QUEUE_LOCK_FILE = "global.lock";
+/** 全局锁陈旧回收默认口径：15 分钟（与安装时限同口径，调用方可按注入覆盖）。 */
+export declare const QUEUE_LOCK_STALE_MS: number;
+export interface UpdateQueuePaths {
+    directory: string;
+    file: string;
+    lock: string;
+}
+/**
+ * 队列共享目录：家目录下按使用范围短指纹派生（短指纹算法与按插件隔离的旧树同一套，
+ * 只做同一性判断，不记原文）。入参非法返回 null，调用方按“无队列可用”放行安装，
+ * 绝不因队列自身故障挡住更新。
+ */
+export declare function queuePathsForUpdate(homeDir: string, profileDir: string): UpdateQueuePaths | null;
+export interface QueuePortsDeps {
+    readFileImpl?: (filename: string, encoding: string) => Promise<string>;
+    statImpl?: (filename: string) => Promise<{
+        size: number;
+    }>;
+    nowImpl?: () => number;
+}
+/**
+ * 建跨插件队列存取与全局锁：调用方按当前使用范围建一份（与插件标识无关），转交宿主入口组合进安装锁。
+ * 读走单读（队列文件只此一份，没有旧影子）；写原子整写；锁走独占建文件，过期可回收一次。
+ */
+export declare function createUpdateQueuePorts(homeDir: string, profileDir: string, deps?: QueuePortsDeps): {
+    paths: UpdateQueuePaths | null;
+    readQueue: () => Promise<UpdateQueueState>;
+    writeQueue: (state: UpdateQueueState) => Promise<void>;
+    tryAcquireGlobalLock: (lockId: string, pluginId: string, opts?: {
+        timeoutMs?: number;
+    }) => Promise<boolean>;
+    releaseGlobalLock: (lockId: string) => Promise<void>;
+};
+/** 批量会话账本的共享落盘（#25，与队列同一目录：同一使用范围一份，跨插件共用）。
+ *
+ * 归属：按使用范围共享（与跨插件队列同一套目录派生：`update-queue/<使用范围短指纹>`），
+ * 不同使用范围各用各的。文件只有一份 `batch.json` —— 「这一轮批量更新走到哪了」是全范围唯一的一份，
+ * 与按插件隔离的 `updates/<插件标识>/...` 那棵树完全分开（父目录不同，任何插件标识都撞不上）。
+ * 纪律与队列同一套：读坏自愈为空会话（缺文件、超大、JSON 坏掉、读失败都回空，绝不因账本坏掉挡住更新）；
+ * 写走原子整写（临时文件 + rename，写完删临时件）；清空写一份空会话（不是删文件，避免与并发读打架）。
+ */
+export declare const BATCH_FILE = "batch.json";
+/** 账本读入上限：1 MiB，超了当坏账本（正常一份几百字节）。 */
+export declare const BATCH_FILE_MAX_BYTES: number;
+export interface UpdateBatchPaths {
+    directory: string;
+    file: string;
+}
+/**
+ * 批量账本路径：与队列同一目录（`update-queue/<短指纹>/batch.json`）。
+ * 入参非法返回 null，调用方按「账本不可落盘」处理（诚实说明，绝不猜目录）。
+ */
+export declare function batchPathsForUpdate(homeDir: string, profileDir: string): UpdateBatchPaths | null;
+export interface BatchPortsDeps {
+    readFileImpl?: (filename: string, encoding: string) => Promise<string>;
+    statImpl?: (filename: string) => Promise<{
+        size: number;
+    }>;
+}
+/**
+ * 建批量账本存取：调用方按当前使用范围建一份（与插件标识无关），转交批量宿主入口。
+ * 读走单读自愈为空会话；写原子整写；清空写空会话。路径算不出来时不抛错（读回空、写抛 batch-unavailable）。
+ */
+export declare function createBatchDiskPorts(homeDir: string, profileDir: string, deps?: BatchPortsDeps): {
+    paths: UpdateBatchPaths | null;
+    readBatch: () => Promise<BatchSession>;
+    writeBatch: (session: BatchSession) => Promise<void>;
+    clearBatch: () => Promise<void>;
+};
+/** 按插件 + 版本持久化的跳过记录（#16，与三冻结落盘名并存的第四文件，不碰旧树）。
+ *
+ * 键：跳过只按「插件标识 + 版本」记——目录已按插件标识隔离（pathsForUpdate），
+ * 文件内只记版本集合。新版本恒重新提醒（跳过是 dismissal 不是全局静音）。
+ * 重置入口（第一性原理结论，见 #16）：已跳过版本留在同一更新横幅行展示为
+ * 「已跳过 X.Y.Z · 恢复」，点恢复即清掉该版本的跳过并重查；不藏进设置页。
+ * 文件：`skipped.json`（`{ skipped: [{ version, skippedAt }] }`，快照式整写，上限 50 条）。
+ */
+export interface SkippedVersionEntry {
+    version: string;
+    skippedAt: number;
+}
+/** 跳过文件上限：只留最近 50 条，避免无界增长（老条目自然淘汰）。 */
+export declare const MAX_SKIPPED_ENTRIES = 50;
+/** 跳过展示键：面板行展示与去重用（`插件标识@版本`）。 */
+export declare function skipKey(pluginId: string, version: string): string;
+/** 跳过记录归一化：只收发行合法版（stable + 预发布），非法条目丢弃（自愈不抛错）。 */
+export declare function normalizeSkipped(raw: unknown): SkippedVersionEntry[];
+/** 该版本是否已被跳过（版本须发行合法，否则为 false）。 */
+export declare function isVersionSkipped(skipped: readonly SkippedVersionEntry[] | unknown, version: unknown): boolean;
+/** 记一次跳过：同版本幂等（刷新 skippedAt），新版本追加并按上限裁剪。 */
+export declare function addSkipped(skipped: readonly SkippedVersionEntry[] | unknown, version: string, now: number): SkippedVersionEntry[];
+/** 重置跳过：给了版本只清该版本（面板「恢复」走这条），不给清全部。 */
+export declare function clearSkipped(skipped: readonly SkippedVersionEntry[] | unknown, version?: string): SkippedVersionEntry[];
+export interface SkipPortsDeps {
+    readFileImpl?: (filename: string, encoding: string) => Promise<string>;
+    statImpl?: (filename: string) => Promise<{
+        size: number;
+    }>;
+}
+/**
+ * 建跳过存取：调用方按当前插件标识建一份（目录与任务落盘同一套，无旧影子）。
+ * 读坏自愈为空（缺文件、超大、JSON 坏掉都回 []，绝不因跳过文件挡住更新）；
+ * 写走原子整写。
+ */
+export declare function createSkipDiskPorts(homeDir: string, pluginId: string, profileDir: string, deps?: SkipPortsDeps): {
+    file: string | null;
+    readSkipped: () => Promise<SkippedVersionEntry[]>;
+    writeSkipped: (skipped: readonly SkippedVersionEntry[] | unknown) => Promise<void>;
+    clearSkippedVersion: (version?: string) => Promise<SkippedVersionEntry[]>;
+};
+/**
+ * 从正在运行的入口反查 CLI 的 JS 入口：逐级向上找名字为 @deepseek-ai/dsh 的包，
+ * 且该文件必须正好是包声明的可执行入口（bin.dsh 或 bin 字符串）。对不上就返回 null，
+ * 绝不用 PATH 上的 `dsh` 命令名——否则可能装到别的使用范围或用错版本。
+ * 第二参只给测试注入假清单读取器与假路径解析用（默认都走真文件系统）。
+ */
+export declare function resolveCliEntry(argv1: string, deps?: {
+    readManifest?: (directory: string) => Promise<Record<string, unknown> | null>;
+    realpath?: (path: string) => Promise<string>;
+}): Promise<string | null>;
+export interface ExecutorParts {
+    profileName?: string | null | (() => string | null);
+    environmentKind?: EnvironmentKind | (() => EnvironmentKind);
+    profileDir?: string | (() => string);
+    subprocess?: unknown | (() => unknown);
+    desktopPnpm?: unknown | (() => unknown);
+    desktopProfiles?: unknown | (() => unknown);
+    /** 官方桌面版进程内的插件管理器（现取，不缓存跨代服务）。 */
+    pluginManager?: unknown | (() => unknown);
+    runtimeExecutable?: string | (() => string | undefined);
+    runtimeExecArgs?: string[] | (() => string[] | undefined);
+    cliEntry?: string | (() => string | undefined);
+    targetPackageName?: string | (() => string);
+    registryUrl?: string | (() => string);
+    installTimeoutMs?: number | (() => number);
+    pluginId?: string | (() => string);
+    log?: (level: string, event: string, fields: Record<string, unknown>) => void;
+}
+/**
+ * 真执行器：按核心给的配方跑安装（测试一律注入假零件，不走这里）。
+ *
+ * 路由只有三条，都由核心的 installRecipe 决定，本文件不按操作系统分支：
+ *   - desktop-service：桌面宿主公开的 desktopPnpm.runPlugin(参数数组, 使用范围目录)；
+ *   - desktop-manager：官方桌面版进程内的 pluginManager.installBundle(精确版本规格, 选项)；
+ *   - cli-process：subprocess.spawn({ argv: [运行时, …运行时参数, CLI 入口, 'plugin', '--profile', 名, …参数] })。
+ * 起进程只经宿主注入的子进程能力，不经 shell、不用 PATH 上的 `dsh` 命令名。
+ */
+export declare function createUpdateExecutor(parts?: ExecutorParts): (args?: {
+    version?: string;
+    profileName?: string | null;
+    environmentKind?: EnvironmentKind;
+}) => Promise<void>;
+export declare const __executorInternals: {
+    INSTALL_STDIO: {
+        stdin: string;
+        stdout: {
+            maxBytes: number;
+        };
+        stderr: {
+            maxBytes: number;
+        };
+    };
+    TERMINATION_GRACE_MS: number;
+    CLI_PACKAGE_NAME: string;
+};