dsh-brief-sidebar 0.3.1 → 0.4.0

package/README.md

@@ -11,8 +11,8 @@ DSH web 插件（`dsh-better-sidebar` 消费方），仓库/包名 **`dsh-brief-
 
 只读展示：不做编辑、不做写回、不做多会话聚合、不复制任何第三方渲染层。
 
-**兼容性范围（当前）**：只支持 **DSH 0.1.5+** —— `engines.dsh` 为 `>=0.1.5-rc.1 <0.2.0-0`，实测基线是 DSH 0.1.5-rc.2。
-0.1.2 及更早的宿主线**不在支持范围内**，npm 上也没有对应 dist-tag（本包只有 `latest` 与 `dsh-0.1.5`）。
+**兼容性范围（当前）**：只支持 **DSH 0.2.0 线** —— `engines.dsh` 为 `>=0.2.0-rc.1 <0.2.1-0`，实测基线是 DSH 0.2.0-rc.1（本分支 `compat/0.2.0`）；0.1.5 线由冻结的 `main`（≤0.3.1）继续服务。
+0.1.2 及更早的宿主线**不在支持范围内**，npm 上也没有对应 dist-tag（本包 0.2.0 线发布走 `dsh-0.2.0`）。
 
 ![brief-sidebar](assets/brief.png)
 
@@ -43,10 +43,10 @@ dock cell、`dsh-tool-todo` 属于 DSH 上游领域，沿用 `todo` 原词，不
 ## 安装
 
 ```powershell
-# 只支持 DSH 0.1.5+：npm 上只有 latest 与 dsh-0.1.5 两个 dist-tag（没有 0.1.2 线）
-dsh plugin --profile web add dsh-brief-sidebar@dsh-0.1.5
+# 0.2.0 线发布走 dsh-0.2.0 dist-tag（0.1.5 线由 main 上的旧版本继续服务）
+dsh plugin --profile web add dsh-brief-sidebar@dsh-0.2.0
 # 备选一：本地 tarball
-dsh plugin --profile web add <dsh-brief-sidebar-0.3.1.tgz>
+dsh plugin --profile web add <dsh-brief-sidebar-0.4.0.tgz>
 # 备选二：GitHub 直装（需自行构建）
 dsh plugin --profile web add github:drscrewdriver/dsh-brief-sidebar#main
 ```
@@ -182,7 +182,7 @@ npm pack            # 出 tarball（本目录有 pnpm-workspace.yaml 但无 pack
 
 ## 兼容性
 
-在 **DSH 0.1.5-rc.2 + dsh-better-sidebar 0.19.1** 上逐条实测（SlotCore 实现、官方 todo dock 注册点、
-投影面类型、`sessionProjections.register` 契约、`registerTab` 契约均已读源码取证）。
-`engines.dsh` 为 `>=0.1.5-rc.1 <0.2.0-0`，且 `package.json` 的 `engines.dsh`、`peerDependencies` 里的 DSH client 包范围、`dsh.plugin.json` 的 `engines.dsh` 三处**必须一致**（当前一致）。
-**0.1.2 及更早的宿主线不在支持范围内**：本插件遮蔽的官方 todo dock、依赖的 SlotCore 与投影面契约都按 0.1.5 线取证，旧线未做适配也未发布对应的 npm dist-tag。
+0.1.5 线的逐条实测记录见 `main` 分支 README（≤0.3.1）；本分支面向 **DSH 0.2.0 线**，实测基线为 **DSH 0.2.0-rc.1 + dsh-better-sidebar 0.19.1**。
+0.2.0-rc.1 对 0.1.7 的插件 API 完全兼容（manifest/settings/HMR/slot/会话 V4 未动），本插件消费面全部是 `ctx.get(...)` 的纯 caller（`slots` / `locale` / `betterSidebar` / `sidebarRight` / `sessions`，自带本地接口定义），对宿主契约无 override，故本线为零代码修改的纯元数据适配。
+`engines.dsh` 为 `>=0.2.0-rc.1 <0.2.1-0`，且 `package.json` 的 `engines.dsh`、`peerDependencies` 里的 DSH client 包范围、`dsh.plugin.json` 的 `engines.dsh` 三处**必须一致**（当前一致）。
+**0.2.1 起的宿主线不在本线覆盖范围内**：rc 窗口锁线纪律，0.2.1 起需重新评估适配（届时新开版本线）。

package/dsh.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "dsh-external/dsh-brief-sidebar",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "main": "./lib/index.mjs",
   "description": "会话简报侧栏页（brief）：把会话的 todo 列表（`todos` 投影的进展看板）与产物列表（`dshSummaryDeliverables` 投影的实时产出文件）一起渲染成右侧栏的一个「概要」tab，并遮蔽 DSH 官方那条 composer 上方的 todo 面板。只读展示，不做写回。",
   "engines": {
-    "dsh": ">=0.1.5-rc.1 <0.2.0-0"
+    "dsh": ">=0.2.0-rc.1 <0.2.1-0"
   },
   "contributes": {
     "tools": [],

package/lib/index.mjs

@@ -1,4 +1,4 @@
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/util.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/util.js
 function getEnumValues(entries) {
 	const numericValues = Object.values(entries).filter((v) => typeof v === "number");
 	return Object.entries(entries).filter(([k, _]) => numericValues.indexOf(+k) === -1).map(([_, v]) => v);
@@ -521,7 +521,7 @@ function constantCatch(value) {
 	return fn;
 }
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/core.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/core.js
 var _a$1;
 const _zodDesc = {
 	value: void 0,
@@ -627,7 +627,7 @@ function config(newConfig) {
 	return globalConfig;
 }
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/errors.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/errors.js
 function _getMessage() {
 	const internals = this._zod;
 	internals.message ?? (internals.message = JSON.stringify(internals.def, jsonStringifyReplacer, 2));
@@ -743,7 +743,7 @@ function formatError(error, mapper = (issue) => issue.message) {
 	return fieldErrors;
 }
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/parse.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/parse.js
 function finalizeParams(callee, params) {
 	return {
 		callee: params?.callee ?? callee,
@@ -946,7 +946,7 @@ const _safeDecodeAsync = (_Err) => async (schema, value, _ctx) => {
 	return _safeParseAsync(_Err)(schema, value, _ctx);
 };
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/regexes.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/regexes.js
 /**
 * @deprecated CUID v1 is deprecated by its authors due to information leakage
 * (timestamps embedded in the id). Use {@link cuid2} instead.
@@ -1017,7 +1017,7 @@ const number$1 = /^-?\d+(?:\.\d+)?$/;
 const lowercase = /^[^A-Z]*$/;
 const uppercase = /^[^a-z]*$/;
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/checks.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/checks.js
 const $ZodCheck = /*@__PURE__*/ $constructor("$ZodCheck", (inst, def) => {
 	var _a;
 	inst._zod ?? (inst._zod = {});
@@ -1313,7 +1313,7 @@ const $ZodCheckOverwrite = /*@__PURE__*/ $constructor("$ZodCheckOverwrite", (ins
 	};
 });
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/doc.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/doc.js
 var Doc = class {
 	constructor(args = [], closed = {}) {
 		this.content = [];
@@ -1347,14 +1347,14 @@ var Doc = class {
 	}
 };
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/versions.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/versions.js
 const version = {
 	major: 4,
 	minor: 6,
 	patch: 5
 };
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/schemas.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/schemas.js
 const $ZodType = /*@__PURE__*/ $constructor("$ZodType", (inst, def) => {
 	var _a;
 	inst ?? (inst = {});
@@ -2686,7 +2686,7 @@ function handleRefineResult(result, payload, input, inst) {
 	}
 }
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/memoizer.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/memoizer.js
 var $ZodCyclicError = class extends Error {
 	constructor() {
 		super(`Cannot parse a reference cycle that closes through a transform`);
@@ -2939,7 +2939,7 @@ function isBackEdge(ctx, value) {
 	return backEdges !== void 0 && isRef(value) && backEdges.has(value);
 }
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/locales/en.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/locales/en.js
 const error = () => {
 	const Sizable = {
 		string: {
@@ -3047,7 +3047,7 @@ function en_default() {
 	return { localeError: error() };
 }
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/registries.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/registries.js
 var _a;
 var $ZodRegistry = class {
 	constructor() {
@@ -3094,7 +3094,7 @@ function registry() {
 (_a = globalThis).__zod_globalRegistry ?? (_a.__zod_globalRegistry = registry());
 const globalRegistry = globalThis.__zod_globalRegistry;
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/api.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/api.js
 function snapshotChecks(def) {
 	if (def.checks) def.checks = [...def.checks];
 	return def;
@@ -3596,7 +3596,7 @@ function _check(fn, params) {
 	return ch;
 }
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/to-json-schema.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/to-json-schema.js
 function assignProps(target, ...sources) {
 	for (const source of sources) for (const key of Reflect.ownKeys(source)) if (Object.prototype.propertyIsEnumerable.call(source, key)) assignProp(target, key, source[key]);
 	return target;
@@ -4040,7 +4040,7 @@ const createStandardJSONSchemaMethod = (schema, io, processors = {}) => (params)
 	return finalize(ctx, schema);
 };
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/json-schema-processors.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/json-schema-processors.js
 const narrowMin = (agg, key, value) => {
 	if (agg[key] === void 0 || value > agg[key]) agg[key] = value;
 };
@@ -4459,7 +4459,7 @@ const optionalProcessor = (schema, ctx, _json, params) => {
 	seen.ref = def.innerType;
 };
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/errors.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/errors.js
 const _installedErrorProtos = /* @__PURE__ */ new WeakSet([Object.prototype, Error.prototype]);
 function _lazyMethod(proto, key, make) {
 	Object.defineProperty(proto, key, {
@@ -4509,7 +4509,7 @@ const initializer = (inst, issues) => {
 };
 const ZodRealError = /*@__PURE__*/ $constructor("ZodError", initializer, void 0, { Parent: Error });
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/parse.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/parse.js
 const parse = /* @__PURE__ */ _parse(ZodRealError);
 const parseAsync = /* @__PURE__ */ _parseAsync(ZodRealError);
 const safeParse = /* @__PURE__ */ _safeParse(ZodRealError);
@@ -4523,7 +4523,7 @@ const safeDecode = /* @__PURE__ */ _safeDecode(ZodRealError);
 const safeEncodeAsync = /* @__PURE__ */ _safeEncodeAsync(ZodRealError);
 const safeDecodeAsync = /* @__PURE__ */ _safeDecodeAsync(ZodRealError);
 //#endregion
-//#region ../../mine-dsh-plugins/dsh-brief-sidebar/node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/schemas.js
+//#region node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/schemas.js
 function _ensureDefaultLocale() {
 	if (!globalConfig.localeError) config(en_default());
 }