dsh-plugin-shop 0.8.5 → 0.8.6

package/lib/index.js

@@ -3,7 +3,7 @@ import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 import { loadOptionalPatches, readProfileManifest, resolveProfileDir } from "@deepseek-ai/dsh-app-boot";
 import { lt, minVersion, parse, satisfies, valid, validRange } from "semver";
 import { createHash, randomUUID } from "node:crypto";
-import { appendFileSync, chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { appendFileSync, chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync, writeSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { basename, delimiter, dirname, isAbsolute, join, posix, relative, resolve, sep, win32 } from "node:path";
 import { homedir } from "node:os";
@@ -16,7 +16,8 @@ import { isMap, isSeq, parseDocument } from "yaml";
 //#region src/own-version.ts
 /** The shop's own published version, read from the package.json that ships
 * next to this package — the RUNNING version, not the manifest's range
-* spec. This lives at the package root (not under src/host) on purpose:
+* spec — and the identity of the process running it (`bootId`). This lives
+* at the package root (not under src/host) on purpose:
 * both the source tree (tests) and the bundled `lib/index.js` sit exactly
 * one level below the package root, so the same relative URL resolves in
 * both. */
@@ -49,6 +50,17 @@ function versionAtLoad(read) {
 * evaluated — at boot, before any self-update could rewrite the file. */
 const runningVersion = versionAtLoad(() => ownManifest().version);
 /**
+* Which run of the code this is: drawn when the module is first evaluated,
+* fixed for the life of the process, and different in the next one.
+*
+* The version cannot answer that. A restart that installed no new shop keeps
+* it, and so does one that never happened — which is what a page reloaded
+* into the process it asked to restart could not tell apart from success,
+* and showed as a self-update that silently did not land (design §8,
+* 2026-10-06 amendment).
+*/
+const bootId = randomUUID();
+/**
 * The peer ranges this build declares — the input to the load-time harness
 * self-check. Read from the same shipped manifest as `runningVersion`, so the
 * ranges checked are the ones this build was actually published with, never
@@ -638,7 +650,8 @@ const entrySchema = z.object({
 	}).optional(),
 	dshPeers: z.record(z.string(), z.string()).optional(),
 	unpackedSize: z.number().int().nonnegative().optional(),
-	installSize: z.number().int().nonnegative().optional()
+	installSize: z.number().int().nonnegative().optional(),
+	archived: z.boolean().optional()
 }).superRefine((entry, ctx) => {
 	if (entry.source === "npm") {
 		if (!NPM_NAME.test(entry.name)) ctx.addIssue({
@@ -2661,29 +2674,43 @@ function restartCommand(options) {
 		args: [...argv]
 	};
 }
+/** One line of the handoff's own in the log, stamped in UTC ISO 8601 so a
+* reader can line it up against the new process's output and the browser's
+* clock. The helper stamps its line with `date -u` to the same shape, to the
+* second. */
+function stamped(text) {
+	return `${(/* @__PURE__ */ new Date()).toISOString()} dsh-plugin-shop: ${text}\n`;
+}
 function startRestart(options) {
 	const { command, args, parentPid, logFile, env } = options;
 	const logFd = openSync(logFile, "a");
 	try {
-		const helper = spawn("sh", [
-			"-c",
-			"while kill -0 \"$1\" 2>/dev/null; do sleep 0.2; done; shift; exec \"$@\"",
-			"sh",
-			String(parentPid),
-			command,
-			...args
-		], {
-			stdio: [
-				"ignore",
-				logFd,
-				logFd
-			],
-			env: env ?? process.env,
-			detached: true
-		});
+		writeSync(logFd, stamped(`restart committed; the new dsh starts once pid ${parentPid} exits: ${[command, ...args].join(" ")}`));
+		let helper;
+		try {
+			helper = spawn("sh", [
+				"-c",
+				"while kill -0 \"$1\" 2>/dev/null; do sleep 0.2; done; echo \"$(date -u +%Y-%m-%dT%H:%M:%SZ) dsh-plugin-shop: pid $1 exited; starting the new dsh\"; shift; exec \"$@\"",
+				"sh",
+				String(parentPid),
+				command,
+				...args
+			], {
+				stdio: [
+					"ignore",
+					logFd,
+					logFd
+				],
+				env: env ?? process.env,
+				detached: true
+			});
+		} catch (error) {
+			writeSync(logFd, stamped(`the restart helper could not start: ${error.message}`));
+			throw error;
+		}
 		helper.on("error", (error) => {
 			try {
-				appendFileSync(logFile, `dsh-plugin-shop: the restart helper could not start: ${error.message}\n`);
+				appendFileSync(logFile, stamped(`the restart helper could not start: ${error.message}`));
 			} catch {}
 		});
 		helper.unref();
@@ -5851,10 +5878,12 @@ let ShopGateway = (() => {
 				return present.length === 0 || present.every(([, enabled]) => enabled);
 			};
 			const installed = [];
+			const claimed = /* @__PURE__ */ new Set();
 			for (const entry of snapshot.entries) {
 				const spec = ownDependencySpec(dependencies, entry.name);
 				if (spec === void 0) continue;
 				if (!installedSpecMatches(entry, spec)) continue;
+				claimed.add(entry.name);
 				const identity = {
 					source: entry.source,
 					repo: entry.repo,
@@ -5879,6 +5908,25 @@ let ShopGateway = (() => {
 					enabled: enabledOf(entry.name)
 				});
 			}
+			for (const name of Object.keys(dependencies)) {
+				if (claimed.has(name)) continue;
+				const spec = ownDependencySpec(dependencies, name);
+				if (spec === void 0) continue;
+				const origin = parseSpec(spec);
+				if (origin?.kind !== "github") continue;
+				const pinPrefix = `github:${origin.repo}#`;
+				const pinKey = pins[pinPrefix] !== void 0 ? pinPrefix : Object.keys(pins).find((key) => key.startsWith(pinPrefix));
+				installed.push({
+					name,
+					source: "github",
+					repo: origin.repo,
+					installed: (pinKey === void 0 ? void 0 : pins[pinKey]) ?? pins[name] ?? spec,
+					latest: null,
+					outdated: false,
+					enabled: enabledOf(name),
+					shadowed: true
+				});
+			}
 			return installed;
 		}
 		/** Whether an installed dependency spec sits behind the catalog's version.
@@ -5908,11 +5956,17 @@ let ShopGateway = (() => {
 				detail: DESKTOP_PROFILE_DETAIL
 			};
 			const named = (await this.snapshotNow()).entries.filter((entry) => entry.name === args.name);
-			if (named.length === 0) return {
-				ok: false,
-				detail: `dsh-plugin-shop: ${args.name} is not in the catalog`
-			};
 			const spec = ownDependencySpec(readProfileManifest("dsh-plugin-shop", this.profileDirResolved()).dependencies ?? {}, args.name);
+			if (named.length === 0) {
+				if (spec === void 0) return {
+					ok: false,
+					detail: `dsh-plugin-shop: ${args.name} is not in the catalog`
+				};
+				if (parseSpec(spec)?.kind !== "github") return {
+					ok: false,
+					detail: `dsh-plugin-shop: ${args.name} is not in the catalog`
+				};
+			}
 			if (spec === void 0) return {
 				ok: false,
 				detail: `dsh-plugin-shop: ${args.name} is not installed`
@@ -5966,10 +6020,7 @@ let ShopGateway = (() => {
 		* response is out. The browser monitors the origin and refreshes when the
 		* new server answers. Refusals are issued before anything is torn down. */
 		async restart() {
-			if (this.committedRestart !== null) return {
-				ok: true,
-				logFile: this.committedRestart.logFile
-			};
+			if (this.committedRestart !== null) return this.committedRestart;
 			if (this.hasRunningCommand()) return {
 				ok: false,
 				detail: "dsh-plugin-shop: an install is still running in this profile; a restart now would boot the new dsh against a half-written profile. Wait for it to finish and try again."
@@ -6003,12 +6054,14 @@ let ShopGateway = (() => {
 					detail: `dsh-plugin-shop: restart could not be started: ${error.message}`
 				};
 			}
-			this.committedRestart = { logFile };
-			setTimeout(() => this.exit(0), this.restartExitDelayMs);
-			return {
+			this.committedRestart = {
 				ok: true,
-				logFile
+				logFile,
+				bootId,
+				pid: this.restartParentPid
 			};
+			setTimeout(() => this.exit(0), this.restartExitDelayMs);
+			return this.committedRestart;
 		}
 		/** The shop's own version and whether npm has a newer one (§7.3). The
 		* check is advisory: a registry that cannot answer leaves `latest` null
@@ -6022,7 +6075,8 @@ let ShopGateway = (() => {
 				latest,
 				outdated: latest !== null && lt(installed, latest),
 				restartBlocked: this.staticRestartBlock(),
-				pendingVersion: this.pendingVersion(installed)
+				pendingVersion: this.pendingVersion(installed),
+				bootId
 			};
 		}
 		/**

package/lib/typert.host.js

@@ -52,6 +52,7 @@ const dsh_plugin_shop_shop_catalog_result$schema = z.object({
   'dshPeers': z.union([z.undefined(), z.record(z.string(), z.string())]).optional(),
   'unpackedSize': z.union([z.undefined(), z.number()]).optional(),
   'installSize': z.union([z.undefined(), z.number()]).optional(),
+  'archived': z.union([z.undefined(), z.literal(false), z.literal(true)]).optional(),
 })),
   'denied': z.array(z.object({
   'name': z.string(),
@@ -83,9 +84,10 @@ const dsh_plugin_shop_shop_installed_result$schema = z.array(z.object({
   'repo': z.union([z.undefined(), z.string()]).optional(),
   'subdir': z.union([z.undefined(), z.string()]).optional(),
   'installed': z.string(),
-  'latest': z.string(),
+  'latest': z.union([z.literal(null), z.string()]),
   'outdated': z.boolean(),
   'enabled': z.boolean(),
+  'shadowed': z.union([z.undefined(), z.literal(true)]).optional(),
 }))
 const dsh_plugin_shop_shop_installedSpecs_result$schema = z.union([z.literal(null), z.record(z.string(), z.string())])
 const dsh_plugin_shop_shop_installStart_parameter_0$schema = z.object({
@@ -119,6 +121,8 @@ const dsh_plugin_shop_shop_installStatus_result$schema = z.object({
 const dsh_plugin_shop_shop_restart_result$schema = z.union([z.object({
   'ok': z.literal(true),
   'logFile': z.union([z.undefined(), z.string()]).optional(),
+  'bootId': z.union([z.undefined(), z.string()]).optional(),
+  'pid': z.union([z.undefined(), z.number()]).optional(),
 }), z.object({
   'ok': z.literal(false),
   'detail': z.string(),
@@ -161,6 +165,7 @@ const dsh_plugin_shop_shop_version_result$schema = z.object({
   'outdated': z.boolean(),
   'restartBlocked': z.union([z.literal(null), z.literal("desktop"), z.literal("windows"), z.literal("systemd"), z.literal("port-zero")]),
   'pendingVersion': z.union([z.undefined(), z.literal(null), z.string()]).optional(),
+  'bootId': z.union([z.undefined(), z.string()]).optional(),
 })
 
 export const TYPERT = {
@@ -195,7 +200,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_catalog_result$schema,
         create: () => dsh_plugin_shop_shop_catalog_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1253,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1272,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installed',
@@ -211,7 +216,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_installed_result$schema,
         create: () => dsh_plugin_shop_shop_installed_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1720,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1739,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installedSpecs',
@@ -227,7 +232,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_installedSpecs_result$schema,
         create: () => dsh_plugin_shop_shop_installedSpecs_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1711,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1730,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installStart',
@@ -255,7 +260,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_installStart_result$schema,
         create: () => dsh_plugin_shop_shop_installStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1379,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1398,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installStatus',
@@ -282,7 +287,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_installStatus_result$schema,
         create: () => dsh_plugin_shop_shop_installStatus_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1687,"column":3},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1706,"column":3},
     },
     {
       id: 'dsh-plugin-shop#shop/restart',
@@ -298,7 +303,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_restart_result$schema,
         create: () => dsh_plugin_shop_shop_restart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1916,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1990,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/setEnabled',
@@ -325,7 +330,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_setEnabled_result$schema,
         create: () => dsh_plugin_shop_shop_setEnabled_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":924,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":943,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/uninstallStart',
@@ -353,7 +358,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_uninstallStart_result$schema,
         create: () => dsh_plugin_shop_shop_uninstallStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1827,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1884,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/updateStart',
@@ -380,7 +385,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_updateStart_result$schema,
         create: () => dsh_plugin_shop_shop_updateStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2020,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2097,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/version',
@@ -396,7 +401,7 @@ export const TYPERT = {
         schema: dsh_plugin_shop_shop_version_result$schema,
         create: () => dsh_plugin_shop_shop_version_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1978,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2054,"column":9},
     },
   ],
   model: {
@@ -493,7 +498,7 @@ export const TYPERT = {
           },
           {
             "name": "CatalogEntry",
-            "declaration": "export interface CatalogEntry {\n    name: string;\n    version: string;\n    integrity: string | null;\n    publishedAt: string | null;\n    repository: string | null;\n    license: string | null;\n    tier: 'verified' | 'verified-stale' | 'community';\n    metadata: 'declared' | 'derived';\n    review?: { reviewedVersion?: string; reviewedCommit?: string; reviewedSha256?: string; repo?: string; reviewer: string; reviewCommit: string; notes: string; };\n    catalog?: CatalogSection;\n    source: 'npm' | 'github';\n    publisher?: string;\n    repo?: string;\n    subdir?: string;\n    tarball?: { url: string; sha256: string; };\n    added?: string;\n    peers?: string[];\n    compatibility?: { dsh?: string; profiles?: string[]; };\n    dshPeers?: Record<string, string>;\n    unpackedSize?: number;\n    installSize?: number;\n}"
+            "declaration": "export interface CatalogEntry {\n    name: string;\n    version: string;\n    integrity: string | null;\n    publishedAt: string | null;\n    repository: string | null;\n    license: string | null;\n    tier: 'verified' | 'verified-stale' | 'community';\n    metadata: 'declared' | 'derived';\n    review?: { reviewedVersion?: string; reviewedCommit?: string; reviewedSha256?: string; repo?: string; reviewer: string; reviewCommit: string; notes: string; };\n    catalog?: CatalogSection;\n    source: 'npm' | 'github';\n    publisher?: string;\n    repo?: string;\n    subdir?: string;\n    tarball?: { url: string; sha256: string; };\n    added?: string;\n    peers?: string[];\n    compatibility?: { dsh?: string; profiles?: string[]; };\n    dshPeers?: Record<string, string>;\n    unpackedSize?: number;\n    installSize?: number;\n    archived?: boolean;\n}"
           },
           {
             "name": "CatalogSection",
@@ -541,7 +546,7 @@ export const TYPERT = {
           },
           {
             "name": "RestartOutcome",
-            "declaration": "export type RestartOutcome = { ok: true; logFile?: string; } | { ok: false; detail: string; };"
+            "declaration": "export type RestartOutcome = { ok: true; logFile?: string; bootId?: string; pid?: number; } | { ok: false; detail: string; };"
           },
           {
             "name": "ShopCatalogResult",
@@ -549,7 +554,7 @@ export const TYPERT = {
           },
           {
             "name": "ShopInstalledEntry",
-            "declaration": "export interface ShopInstalledEntry {\n    name: string;\n    source: 'npm' | 'github';\n    repo?: string;\n    subdir?: string;\n    installed: string;\n    latest: string;\n    outdated: boolean;\n    enabled: boolean;\n}"
+            "declaration": "export interface ShopInstalledEntry {\n    name: string;\n    source: 'npm' | 'github';\n    repo?: string;\n    subdir?: string;\n    installed: string;\n    latest: string | null;\n    outdated: boolean;\n    enabled: boolean;\n    shadowed?: true;\n}"
           },
           {
             "name": "ShopInstallResult",
@@ -577,7 +582,7 @@ export const TYPERT = {
           },
           {
             "name": "ShopVersionResult",
-            "declaration": "export interface ShopVersionResult {\n    installed: string;\n    latest: string | null;\n    outdated: boolean;\n    restartBlocked: RestartBlockedReason | null;\n    pendingVersion?: string | null;\n}"
+            "declaration": "export interface ShopVersionResult {\n    installed: string;\n    latest: string | null;\n    outdated: boolean;\n    restartBlocked: RestartBlockedReason | null;\n    pendingVersion?: string | null;\n    bootId?: string;\n}"
           }
         ]
       }

package/lib/typert.remote-client.js

@@ -52,6 +52,7 @@ const dsh_plugin_shop_shop_catalog_result$schema = z.object({
   'dshPeers': z.union([z.undefined(), z.record(z.string(), z.string())]).optional(),
   'unpackedSize': z.union([z.undefined(), z.number()]).optional(),
   'installSize': z.union([z.undefined(), z.number()]).optional(),
+  'archived': z.union([z.undefined(), z.literal(false), z.literal(true)]).optional(),
 })),
   'denied': z.array(z.object({
   'name': z.string(),
@@ -83,9 +84,10 @@ const dsh_plugin_shop_shop_installed_result$schema = z.array(z.object({
   'repo': z.union([z.undefined(), z.string()]).optional(),
   'subdir': z.union([z.undefined(), z.string()]).optional(),
   'installed': z.string(),
-  'latest': z.string(),
+  'latest': z.union([z.literal(null), z.string()]),
   'outdated': z.boolean(),
   'enabled': z.boolean(),
+  'shadowed': z.union([z.undefined(), z.literal(true)]).optional(),
 }))
 const dsh_plugin_shop_shop_installedSpecs_result$schema = z.union([z.literal(null), z.record(z.string(), z.string())])
 const dsh_plugin_shop_shop_installStart_parameter_0$schema = z.object({
@@ -119,6 +121,8 @@ const dsh_plugin_shop_shop_installStatus_result$schema = z.object({
 const dsh_plugin_shop_shop_restart_result$schema = z.union([z.object({
   'ok': z.literal(true),
   'logFile': z.union([z.undefined(), z.string()]).optional(),
+  'bootId': z.union([z.undefined(), z.string()]).optional(),
+  'pid': z.union([z.undefined(), z.number()]).optional(),
 }), z.object({
   'ok': z.literal(false),
   'detail': z.string(),
@@ -161,6 +165,7 @@ const dsh_plugin_shop_shop_version_result$schema = z.object({
   'outdated': z.boolean(),
   'restartBlocked': z.union([z.literal(null), z.literal("desktop"), z.literal("windows"), z.literal("systemd"), z.literal("port-zero")]),
   'pendingVersion': z.union([z.undefined(), z.literal(null), z.string()]).optional(),
+  'bootId': z.union([z.undefined(), z.string()]).optional(),
 })
 
 export const TYPERT_REMOTE = {
@@ -192,7 +197,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_catalog_result$schema,
         create: () => dsh_plugin_shop_shop_catalog_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1253,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1272,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installed',
@@ -208,7 +213,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_installed_result$schema,
         create: () => dsh_plugin_shop_shop_installed_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1720,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1739,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installedSpecs',
@@ -224,7 +229,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_installedSpecs_result$schema,
         create: () => dsh_plugin_shop_shop_installedSpecs_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1711,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1730,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installStart',
@@ -252,7 +257,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_installStart_result$schema,
         create: () => dsh_plugin_shop_shop_installStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1379,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1398,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/installStatus',
@@ -279,7 +284,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_installStatus_result$schema,
         create: () => dsh_plugin_shop_shop_installStatus_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1687,"column":3},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1706,"column":3},
     },
     {
       id: 'dsh-plugin-shop#shop/restart',
@@ -295,7 +300,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_restart_result$schema,
         create: () => dsh_plugin_shop_shop_restart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1916,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1990,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/setEnabled',
@@ -322,7 +327,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_setEnabled_result$schema,
         create: () => dsh_plugin_shop_shop_setEnabled_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":924,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":943,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/uninstallStart',
@@ -350,7 +355,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_uninstallStart_result$schema,
         create: () => dsh_plugin_shop_shop_uninstallStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1827,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1884,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/updateStart',
@@ -377,7 +382,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_updateStart_result$schema,
         create: () => dsh_plugin_shop_shop_updateStart_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2020,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2097,"column":9},
     },
     {
       id: 'dsh-plugin-shop#shop/version',
@@ -393,7 +398,7 @@ export const TYPERT_REMOTE = {
         schema: dsh_plugin_shop_shop_version_result$schema,
         create: () => dsh_plugin_shop_shop_version_result$schema,
       },
-      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":1978,"column":9},
+      sourceLocation: {"file":"packages/dsh-plugin-shop/src/host/index.ts","line":2054,"column":9},
     },
   ],
 }

package/lib/types/client/ShopTab.d.ts

@@ -47,6 +47,12 @@ export interface ShopTabInjected {
     noteUninstalled?: (name: string) => void;
     restart: () => Promise<ShopRestartResult>;
     version: () => Promise<ShopVersionResult>;
+    /** Be told when the version answers start coming from another dsh process
+     * — dsh restarted under the page, which nothing reloads — with the first
+     * answer from it; returns the unsubscribe. The receipts a restart settles
+     * are the tab's to clear (design §8, 2026-10-06 amendment). Optional: a
+     * stub may not offer it. */
+    onRestarted?: (listener: (fresh: ShopVersionResult) => void) => () => void;
     updateStart: (args: {
         version: string;
     }) => Promise<ShopUpdateResult>;

package/lib/types/client/index.d.ts

@@ -13,6 +13,17 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         'settings.shop': ShopLocaleKey;
     }
 }
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        /** A connection generation was established: the first connect after
+         * plugin boot, and every reconnect. `@deepseek-ai/dsh-client-connection`
+         * declares it, in these words, from 0.1.5-rc.3 on, and dsh-api-gateway's
+         * client emits it there through 0.2.0-rc.2; the 0.1.1-rc.2 this package
+         * builds against predates the declaration. A harness that never emits
+         * it leaves the shop as it was before it listened. */
+        'connection/reset'(): void;
+    }
+}
 /** Dictionary namespace owned by this plugin. */
 export declare const NS = "settings.shop";
 /** How long a stashed catalog may satisfy a plain open. The host applies the

package/lib/types/client/locales.d.ts

@@ -11,6 +11,11 @@ export declare const zh: {
      * 2026-09-26-market-borrowings §4). */
     tabCrashed: string;
     search: string;
+    /** One subdued line under the search box when a Chinese query fired a
+     * dictionary intent (design 2026-10-08-search-query-expansion §4).
+     * `{terms}` is the comma-joined recall terms, without the `#` marker
+     * (boundary-only surface detail, not a reader's fact). */
+    zhExpansionNote: string;
     all: string;
     catalog: string;
     catalogStats: string;
@@ -27,6 +32,10 @@ export declare const zh: {
     tierVerified: string;
     tierVerifiedStale: string;
     tierCommunity: string;
+    /** The github repository GitHub reports as archived (design 2026-10-08 §1.3).
+     * Subdued register, like `tierCommunity`: nothing is wrong with the install
+     * itself; the owner has simply frozen the project. */
+    archivedBadge: string;
     capabilitiesNote: string;
     install: string;
     confirm: string;
@@ -108,6 +117,14 @@ export declare const zh: {
     nameTakenDetail: string;
     npmSource: string;
     githubSource: string;
+    /** The badge and the explanation for an installed github entry no catalog
+     * row claims (C10 MVP). The mechanism synthesizes a row for ANY github spec
+     * with no catalog row — shadowed by a same-named npm package, an unlisted
+     * fork, a removed listing, or a same-named conflict with a different repo —
+     * so the copy names the catalog fact and lists the causes, rather than
+     * claiming the npm-twin one. */
+    shadowedBadge: string;
+    shadowedDetail: string;
     updatableSection: string;
     installedVersion: string;
     latestVersion: string;
@@ -133,6 +150,9 @@ export declare const zh: {
      * that answered and then died. */
     restartFailedLogNotice: string;
     restartTransportFailed: string;
+    notRestartedNotice: string;
+    notRestartedPidNotice: string;
+    notRestartedLogNotice: string;
     restartBlockedDesktopNotice: string;
     restartBlockedWindowsNotice: string;
     restartBlockedSystemdNotice: string;
@@ -159,6 +179,9 @@ export declare const en: {
     retry: string;
     tabCrashed: string;
     search: string;
+    /** One subdued line under the search box when a Chinese query fired a
+     * dictionary intent (design 2026-10-08-search-query-expansion §4). */
+    zhExpansionNote: string;
     all: string;
     catalog: string;
     catalogStats: string;
@@ -173,6 +196,10 @@ export declare const en: {
     empty: string;
     emptySearch: string;
     tierVerified: string;
+    /** The github repository GitHub reports as archived (design 2026-10-08 §1.3).
+     * Subdued register: nothing is wrong with the install; the owner has simply
+     * frozen the project. */
+    archivedBadge: string;
     tierVerifiedStale: string;
     tierCommunity: string;
     capabilitiesNote: string;
@@ -232,6 +259,8 @@ export declare const en: {
     nameTakenDetail: string;
     npmSource: string;
     githubSource: string;
+    shadowedBadge: string;
+    shadowedDetail: string;
     updatableSection: string;
     installedVersion: string;
     latestVersion: string;
@@ -252,6 +281,9 @@ export declare const en: {
     restartFailedNotice: string;
     restartFailedLogNotice: string;
     restartTransportFailed: string;
+    notRestartedNotice: string;
+    notRestartedPidNotice: string;
+    notRestartedLogNotice: string;
     restartBlockedDesktopNotice: string;
     restartBlockedWindowsNotice: string;
     restartBlockedSystemdNotice: string;

package/lib/types/client/present.d.ts

@@ -5,7 +5,7 @@ export { isShopLike } from '../shared/shop-like.ts';
 export { identityKey, type EntryIdentity } from '../shared/identity.ts';
 import { type EntryIdentity } from '../shared/identity.ts';
 import type { ShopLocaleKey } from './locales.ts';
-import type { CatalogEntry, HarnessVerdict, HotRestartReason, InstallRejectionCode, RestartBlockedReason } from '../host/index.ts';
+import type { CatalogEntry, HarnessVerdict, HotRestartReason, InstallRejectionCode, RestartBlockedReason, ShopVersionResult } from '../host/index.ts';
 import type { Activation } from '../host/activation.ts';
 import { type InstallState } from '../shared/install-state.ts';
 export type { Activation };
@@ -287,6 +287,26 @@ export declare function restartMonitorVerdict(input: {
     elapsedMs: number;
     stableSinceMs: number | null;
 }): 'wait' | 'reload' | 'failed';
+/**
+ * Whether two `version()` answers came from different dsh processes — dsh
+ * restarted under the page between them (design §8, 2026-10-06 amendment).
+ *
+ * A process names itself by `bootId` for as long as it lives, so where either
+ * answer carries one, a difference decides: a host older than the field never
+ * starts naming itself, and a newer one never stops. Where neither does, only
+ * the code they run can differ — one process runs one version, read once at
+ * its boot — which still catches the first restart after a self-update from
+ * a host older than the field, the one that matters most.
+ */
+export declare function answeredByAnotherProcess(previous: ShopVersionResult, next: ShopVersionResult): boolean;
+/**
+ * Whether dsh restarting under the page settles this receipt: a change that
+ * landed and was waiting for exactly that. The tab clears these once the
+ * answers come from another process, and nothing else — a reload is still
+ * owed by a page nobody reloaded, a failure still happened, and a flow still
+ * running settles by its own poll.
+ */
+export declare function settledByRestart(view: InstallView): boolean;
 /** How long the check-update button reports "up to date" after a re-check
  * finds no newer release, before reverting to its idle label. */
 export declare const CHECK_UP_TO_DATE_MS = 3000;