super-dsh 0.3.0-a → 0.3.0-c

package/bundles/manifest.json

@@ -2,9 +2,9 @@
   "companions": [
     {
       "name": "better-dsh",
-      "version": "0.3.0-a",
+      "version": "0.3.0-c",
       "tarball": "./better-dsh.tgz",
-      "sha256": "c3e2f2a40ffec8bd98816998107e9e041fff88016fa739a6462fed491ad24148"
+      "sha256": "a9287af10438fc48ca32a048392cf5192f5cef864fe152eb2b50c99e58061563"
     }
   ]
 }

package/node_modules/better-dsh/dsh-docs/baseline.md

@@ -0,0 +1,13 @@
+# DSH runtime compatibility
+
+Better Dash and Super Dash use the same DSH host APIs. The verified upstream source baseline for this alignment is `dsh-v0.2.1-alpha.1` (`5badb15009ae1756c3afe0ae0cef1faafc290ccc`). The pages in this directory include older official reference snapshots; check this baseline before using an API described by a snapshot.
+
+On `0.2.1-alpha.1`:
+
+- The runtime `dsh-invariants` plugin, `ctx.invariants`, and companion `./invariant` exports are removed. The archived invariant reference does not define an available extension API.
+- Plugin subpaths provide display text through `<specifier>/locale/en.json` and localized sibling exports, and icons through `<specifier>/icon`. Subpaths do not read a separate `package.json`.
+- Composer statistics use separate `activity` and `usage` entries.
+- The native Plugin Manager refreshes profile package resolution when bundles are installed, enabled, disabled or removed. Replacing installed package code still requires a restart.
+- Automation is part of the Web composition. Reminder tools depend on agent mode; they are absent in Minimal mode and subagents.
+
+See the [official release notes](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-alpha.1) and the actual host package exports for the complete interface contract.

package/node_modules/better-dsh/dsh-docs/subsystems/invariants.md

@@ -1,5 +1,8 @@
 # Runtime Invariants
 
+> DSH `0.2.1-alpha.1` removes this plugin and all companion `./invariant` exports. This page is an older reference snapshot; use the [runtime compatibility baseline](../baseline.md) for the current host contract.
+
+
 English | [中文](invariants.zh.md)
 
 [dsh-invariants](../../packages/runtime-diagnostics/invariants) is the configurable registry service (`ctx.invariants`) for package-owned runtime invariant checks. It is one support-group package, not a three-package capability seam, and not part of the agent-loop spine: the registry owns selection, name reservation, child-fiber lifecycle, and package-attributed failure, while every workspace package publishes a `./invariant` companion plugin that registers checks under its exact npm package name. What a check may assert — authoritative event streams or mutable data, never service or method presence — is the runtime-invariants convention in [AGENTS.md](../../AGENTS.md#conventions); the registry design is owned by the [invariant-service Agent Note](../../.agents/notes/implemented/architecture/2026-07-19-package-owned-invariant-service.md).

package/node_modules/better-dsh/dsh-docs/subsystems/invariants.zh.md

@@ -1,5 +1,8 @@
 # 运行时不变式
 
+> DSH `0.2.1-alpha.1` 已移除此插件及所有配套 `./invariant` 导出。本页保留旧版参考快照；当前宿主契约见[运行时兼容基线](../baseline.md)。
+
+
 [English](invariants.md) | 中文
 
 [dsh-invariants](../../packages/runtime-diagnostics/invariants) 是面向包自有运行时不变式检查的可配置注册表服务（`ctx.invariants`）。它是一个 support 组的包，不是三包能力 seam，也不属于 agent loop（智能体循环）主干：注册表拥有选择逻辑、名称保留、子 fiber 生命周期和归因到包的失败，而每个工作区包发布一个 `./invariant` 配套插件，以自己确切的 npm 包名注册检查。检查可以断言什么（权威事件流或可变数据，绝不是服务或方法是否存在）是 [AGENTS.md](../../AGENTS.md#conventions) 中的运行时不变式约定；注册表设计由[不变式服务 Agent Note](../../.agents/notes/implemented/architecture/2026-07-19-package-owned-invariant-service.zh.md)规定。

package/node_modules/better-dsh/lib/bundle-delivery.d.ts

@@ -1,5 +1,5 @@
-import { Context } from "@deepseek-ai/cordis";
 import { ProfileContext } from "@deepseek-ai/dsh-app-boot";
+import { Context } from "@deepseek-ai/cordis";
 
 //#region src/bundle-delivery.d.ts
 declare const name = "dashr-bundle-delivery";

package/node_modules/better-dsh/lib/bundle-delivery.js

@@ -4,11 +4,14 @@ import { mkdir, readFile, realpath, rename, rm, writeFile } from "node:fs/promis
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { withFileLock, writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
+import * as AppBoot from "@deepseek-ai/dsh-app-boot";
 
 //#region src/bundle-delivery.ts
 const name = "dashr-bundle-delivery";
 const inject = ["profileContext", "appReady"];
 const hash = (bytes) => createHash("sha256").update(bytes).digest("hex");
+const nativePackages = AppBoot.PluginPackages?.prototype;
+const restartForPromotion = nativePackages !== void 0 && typeof Reflect.get(nativePackages, "refresh") === "function";
 const json = async (path$1) => JSON.parse(await readFile(path$1, "utf8"));
 async function optionalJson(path$1) {
 	try {
@@ -152,7 +155,7 @@ async function reconcileBundledDelivery(profile, signal) {
 				await writeFileAtomic(receiptPath, JSON.stringify(receipts) + "\n", { mode: 384 });
 				if (disposition === "companion-removed") continue;
 				result.installed.push(`${item.name}@${item.version}`);
-				result.restartRequired ||= priorSpec !== void 0;
+				result.restartRequired ||= priorSpec !== void 0 || restartForPromotion;
 			}
 		}
 		return result;

package/node_modules/better-dsh/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-dsh",
-  "version": "0.3.0-a",
+  "version": "0.3.0-c",
   "description": "Make your dsh ready for serious coding tasks. (Tools x Schemas)^REPL. `skill://`, `ctx://`, `agent://`, `dvc://`, `dsh://`, IPython REPL, Context as Variables, cross compactions recallable, full context revive. `hash-edit`, `dvc://browser`, subagent as function, workflow as function.",
   "type": "module",
   "main": "lib/index.js",
@@ -144,7 +144,6 @@
     "@deepseek-ai/dsh-fs-local": ">=0.1.5-0 <0.3.0-0",
     "@deepseek-ai/dsh-home-paths": ">=0.1.5-0 <0.3.0-0",
     "@deepseek-ai/dsh-host-webserver": ">=0.1.5-0 <0.3.0-0",
-    "@deepseek-ai/dsh-invariants": ">=0.1.5-0 <0.3.0-0",
     "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
     "@deepseek-ai/dsh-llm-retry": ">=0.1.5-0 <0.3.0-0",
     "@deepseek-ai/dsh-persona": ">=0.1.5-0 <0.3.0-0",
@@ -228,9 +227,6 @@
     "@deepseek-ai/dsh-home-paths": {
       "optional": true
     },
-    "@deepseek-ai/dsh-invariants": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-llm": {
       "optional": true
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-dsh",
-  "version": "0.3.0-a",
+  "version": "0.3.0-c",
   "description": "Super D for the DeepSeek Harness (DSH) — one dsh plugin that mounts the superd hub (runtime selector, roster, per-runtime agents) and joins local foreign-agent runtimes (OMP, Codex, Claude, Pi, Hermes, Antigravity) into the DSH Web UI. Each runtime keeps its native home and session store; the hub only bridges.",
   "type": "module",
   "license": "MIT",
@@ -83,7 +83,7 @@
     }
   },
   "dependencies": {
-    "better-dsh": "0.3.0-a",
+    "better-dsh": "0.3.0-c",
     "@earendil-works/pi-coding-agent": "0.84.2",
     "zod": "4.4.3",
     "@modelcontextprotocol/sdk": "^1.29.0"

package/superd-hub/dist/spawn-world.js

@@ -28,6 +28,7 @@ import { entryListSchema } from '@deepseek-ai/cordis-plugin-include';
 import { existsSync, writeFileSync, readFileSync, readdirSync, realpathSync } from 'node:fs';
 import { join } from 'node:path';
 import { superdTrustedHosts } from './world-mount.js';
+import { widenWorldResolution } from './world-resolution.js';
 /**
  * Republish the host's live resolution with THIS world added as a linked
  * root (spec §2.1, contract-legal form): `profilesDir`/`profileDir` are
@@ -97,11 +98,7 @@ async function publishWorldInHostResolutionTurn(packages, launcher, opts, worldP
     if (!publishedRoots.has(rootName)) {
         publishedRoots.set(rootName, { name: rootName, realPath: opts.home });
     }
-    packages.replace({
-        ...base,
-        entries: [...base.entries, ...publishedEntries.values()],
-        linkedRoots: [...base.linkedRoots, ...publishedRoots.values()],
-    });
+    packages.replace(widenWorldResolution(base, { installAnchor: launcher.installAnchor, home: launcher.home, profileDir: profile.dir }, publishedEntries.values(), publishedRoots.values()));
 }
 /** Bare package name of a module specifier (`@scope/pkg/sub` → `@scope/pkg`). */
 function barePackageNameOf(specifier) {

package/superd-hub/dist/world-resolution.d.ts

@@ -0,0 +1,6 @@
+import type { ProfileRuntimeResolution, RuntimeResolution } from '@deepseek-ai/dsh-app-boot';
+type ResolutionSource = ConstructorParameters<typeof ProfileRuntimeResolution>[0];
+type WorldEntry = RuntimeResolution['entries'][number];
+type WorldRoot = RuntimeResolution['linkedRoots'][number];
+export declare function widenWorldResolution(base: RuntimeResolution, source: ResolutionSource, entries: Iterable<WorldEntry>, linkedRoots: Iterable<WorldRoot>): RuntimeResolution;
+export {};

package/superd-hub/dist/world-resolution.js

@@ -0,0 +1,39 @@
+/** Preserve the host's native package refresh while retaining world import roots. */
+import * as AppBoot from '@deepseek-ai/dsh-app-boot';
+/** A native recomputable generation with the worlds' additional mappings. */
+const WorldRuntimeResolution = typeof AppBoot.ProfileRuntimeResolution === 'function'
+    ? class WorldRuntimeResolution extends AppBoot.ProfileRuntimeResolution {
+        // The parent freezes `this`; private slots still accept constructor values.
+        #source;
+        #worldEntries;
+        #worldRoots;
+        constructor(base, source, entries, roots) {
+            const names = new Set(base.entries.map((entry) => entry.name));
+            const rootNames = new Set(base.linkedRoots.map((root) => root.name));
+            super(source, {
+                ...base,
+                // A package now supplied by the native table owns its own mapping.
+                entries: Object.freeze([...base.entries, ...entries.filter((entry) => !names.has(entry.name))]),
+                linkedRoots: Object.freeze([...base.linkedRoots, ...roots.filter((root) => !rootNames.has(root.name))]),
+            });
+            this.#source = source;
+            this.#worldEntries = entries;
+            this.#worldRoots = roots;
+        }
+        async computeLatestResolution() {
+            // Recompute native mappings from disk, then widen the successor again.
+            // Keeping only world additions prevents removed native packages lingering.
+            return new WorldRuntimeResolution(await super.computeLatestResolution(), this.#source, this.#worldEntries, this.#worldRoots);
+        }
+    }
+    : undefined;
+export function widenWorldResolution(base, source, entries, linkedRoots) {
+    const worldEntries = Object.freeze([...entries]);
+    const worldRoots = Object.freeze([...linkedRoots]);
+    // Earlier supported hosts expose data generations and have no refresh API.
+    // Keep that contract without evaluating a class extending a missing export.
+    if (WorldRuntimeResolution === undefined) {
+        return { ...base, entries: [...base.entries, ...worldEntries], linkedRoots: [...base.linkedRoots, ...worldRoots] };
+    }
+    return new WorldRuntimeResolution(base, Object.freeze({ ...source }), worldEntries, worldRoots);
+}