@lmzhen/dsh-evolution-skill-history 0.13.2 → 0.13.3

package/README.md

@@ -33,13 +33,15 @@ The row is **inert without a web server** (`ctx.get('webServer')`, not a declare
 
 ## What the panel shows
 
-**The left column** lists the skills that recorded versions, one row per skill: its name, how many versions it has, its own one-line description (the listing already carried it) and the management state the marker probe reported. A **search box** filters that list by name or description — client state only, no route behind it.
+**The left column** lists the skills that recorded versions, one row per skill: its name, how many versions it has, its own one-line description, clipped with an ellipsis (the listing already carried it) and the management state the marker probe reported. A **search box** filters that list by name or description — client state only, no route behind it.
 
-**The right pane** shows the selected skill's versions as two groups: **Body versions** (restorable) and **File versions** (history only, because a restore rewrites `SKILL.md`). A body row reads like a sentence rather than a dump — `v3  targeted edit  2026-09-27 18:20 · 3 hours ago  (+1363 chars)` — with a *current* capsule on the live content, **Restore this version** (an inline two-click confirmation, with a **Cancel** beside it once it is armed) on the others, and **Diff** expanding that version against its predecessor (lines added and removed, plus the changed region, marked truncated when it is long). After a restore the rows are read again — the restore itself is a new version — while the curator's result sentence stays on screen. **Refresh** re-reads the skill list and the open skill.
+**The right pane** shows the selected skill's versions as two groups: **Body versions** (restorable) and **File versions** (history only, because a restore rewrites `SKILL.md`). A body row reads like a sentence rather than a dump — `v3  targeted edit  3 hours ago  (+1363 chars)`, where the absolute clock is the row's hover text — with a *current* capsule on the live content, **Restore this version** (an inline two-click confirmation, with a **Cancel** beside it once it is armed) on the others, and **Diff** expanding that version against its predecessor (lines added and removed, plus the changed region, marked truncated when it is long). After a restore the rows are read again — the restore itself is a new version — while the curator's result sentence stays on screen. **Refresh** re-reads the skill list and the open skill.
+
+While nothing is selected the pane says so — a line pointing at the left column, or the empty listing when no skill has a history yet.
 
 **The panel owns no rule and no arithmetic.** The host reports every row with its whole verdict — `undoable` (evolution-core's artifact classification against the live bytes), `actionKind` (a closed vocabulary key), `age` (a bucket plus a count), `charsDelta`, `summary` — and this half substitutes words from its locale dictionary and renders. The time, the action words and the sentences are therefore localized; the facts are computed once, host-side, so the panel and the slash commands cannot drift.
 
-**Appearance follows the platform's tokens, not its modules.** The panel carries its own stylesheet (`src/client/styles.ts`, injected once behind `data-plugin-css`) and copies its metrics from the platform's own components — the command card's `<pre>` for the diff block, the sidebar row's hover and focus ring for the controls, and the theme's semantic state pair (`--dsw-alias-state-success-primary` / `--dsw-alias-state-error-primary`) for the diff's added and removed lines — while every size is a `--dsh-content-font-size*` token or a `calc()` over one, so the panel follows the deployment's content size the way the platform's panels do. Importing the platform's control package is NOT possible from here without splitting this package's compiler faces: the specifier is path-mapped to source, and `tsc -b` then refuses the foreign project (host/client face split, `react` devDependencies and a CI graph change would all be needed). The roll call of what the panel deliberately does not do is in `## Known limitations and deferred work`.
+**Appearance follows the platform's tokens, not its modules.** The panel carries its own stylesheet (`src/client/styles.ts`, injected once behind `data-plugin-css`) and copies its metrics from the platform's own components — the command card's `<pre>` for the diff block, the sidebar row's hover and focus ring for the controls, and the theme's semantic state pair (`--dsw-alias-state-success-primary` / `--dsw-alias-state-error-primary`) for the diff's added and removed lines — while type follows the shell rather than the conversation: the panel declares no `font-size` of its own (the way the platform's own surfaces declare none) and steps with `calc(1em + 2px)` for the title and `calc(1em - 1px)` for a group label. Only the diff block takes the platform's code-block token — it renders content, not chrome. The setting behind `--dsh-content-font-size*` is documented as affecting conversation content only, so the panel deliberately does not follow it. Importing the platform's control package is NOT possible from here without splitting this package's compiler faces: the specifier is path-mapped to source, and `tsc -b` then refuses the foreign project (host/client face split, `react` devDependencies and a CI graph change would all be needed). The roll call of what the panel deliberately does not do is in `## Known limitations and deferred work`.
 
 ## Build
 

package/lib/client.js

@@ -76,6 +76,7 @@ window.__ModuleLoader__.load({
 			"group.support.note": "附带文件的字节与正文共用一份索引；回退不恢复它们。",
 			"empty.skills": "还没有技能留下过内容版本。",
 			"empty.versions": "这个技能还没有记录版本。",
+			"empty.pick": "从左栏选一个技能，看它记录过的版本。",
 			loading: "读取中…",
 			refresh: "刷新",
 			undo: "回退到此版",
@@ -104,8 +105,10 @@ window.__ModuleLoader__.load({
 			"action.patch": "定点修改",
 			"action.update": "整篇更新",
 			"action.restore": "回退",
-			"action.delete": "删除（存的是被删的正文）",
-			"action.archive": "归档（存的是被归档的正文）",
+			"action.delete": "删除",
+			"action.delete.note": "这一版存的是被删掉的正文",
+			"action.archive": "归档",
+			"action.archive.note": "这一版存的是被归档的正文",
 			"action.consolidate": "合并",
 			"action.restructure": "结构调整",
 			"action.support-write": "写入附带文件",
@@ -137,6 +140,7 @@ window.__ModuleLoader__.load({
 			"group.support.note": "Support-file bytes share this index with the body; restoring the body does not bring them back.",
 			"empty.skills": "No skill has recorded a content version yet.",
 			"empty.versions": "This skill has no recorded versions.",
+			"empty.pick": "Pick a skill on the left to see the versions it recorded.",
 			loading: "Loading…",
 			refresh: "Refresh",
 			undo: "Restore this version",
@@ -165,8 +169,10 @@ window.__ModuleLoader__.load({
 			"action.patch": "targeted edit",
 			"action.update": "whole-body update",
 			"action.restore": "restored",
-			"action.delete": "deleted (holds the removed body)",
-			"action.archive": "archived (holds the archived body)",
+			"action.delete": "deleted",
+			"action.delete.note": "this version holds the removed body",
+			"action.archive": "archived",
+			"action.archive.note": "this version holds the archived body",
 			"action.consolidate": "merged",
 			"action.restructure": "restructured",
 			"action.support-write": "support file written",
@@ -226,12 +232,12 @@ window.__ModuleLoader__.load({
 		const CSS_TAG_ID = "@lmzhen/dsh-evolution-skill-history/panel.css";
 		/** The stylesheet the panel injects once. */
 		const CSS = [
-			".evo-hist-root{display:flex;height:100%;min-height:0;min-width:0;font-size:var(--dsh-content-font-size-secondary,13px);color:var(--dsw-alias-label-primary)}",
+			".evo-hist-root{display:flex;height:100%;min-height:0;min-width:0;color:var(--dsw-alias-label-primary)}",
 			".evo-hist-aside{display:flex;flex-direction:column;flex:0 0 264px;width:264px;min-height:0;border-right:.5px solid var(--dsw-alias-border-l2)}",
-			".evo-hist-search{padding:10px 12px 4px}",
+			".evo-hist-search{padding:12px 12px 4px}",
 			".evo-hist-search input{width:100%;box-sizing:border-box;padding:6px 10px;border:.5px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font:inherit}",
 			".evo-hist-search input:focus-visible{outline:2px solid var(--dsw-alias-label-primary);outline-offset:-2px}",
-			".evo-hist-list{flex:1 1 auto;min-height:0;overflow-y:auto;padding:4px 6px 10px}",
+			".evo-hist-list{flex:1 1 auto;min-height:0;overflow-y:auto;padding:4px 12px 10px}",
 			".evo-hist-empty{padding:8px 12px;color:var(--dsw-alias-label-tertiary)}",
 			".evo-hist-skill{display:block;width:100%;box-sizing:border-box;padding:7px 8px;border:0;border-radius:8px;background:transparent;color:var(--dsw-alias-label-secondary);font:inherit;text-align:left;cursor:pointer}",
 			".evo-hist-skill:hover{background:var(--dsw-alias-interactive-bg-hover)}",
@@ -241,20 +247,22 @@ window.__ModuleLoader__.load({
 			".evo-hist-skill-name{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
 			".evo-hist-skill-count{flex:none;margin-left:auto;color:var(--dsw-alias-label-tertiary)}",
 			".evo-hist-skill-desc{display:block;margin-top:2px;color:var(--dsw-alias-label-tertiary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
-			".evo-hist-main{flex:1 1 auto;min-width:0;min-height:0;overflow-y:auto;padding:12px 14px}",
+			".evo-hist-main{flex:1 1 auto;min-width:0;min-height:0;overflow-y:auto;padding:12px 12px}",
 			".evo-hist-head{display:flex;align-items:center;gap:10px;margin:0 0 4px}",
-			".evo-hist-title{flex:1 1 auto;margin:0;font-size:inherit;font-weight:600}",
+			".evo-hist-title{flex:1 1 auto;margin:0;font-size:calc(1em + 2px);font-weight:600}",
 			".evo-hist-hint{margin:0 0 10px;color:var(--dsw-alias-label-secondary);line-height:1.5}",
+			".evo-hist-pane-empty{margin:2px 0 0;color:var(--dsw-alias-label-tertiary)}",
 			".evo-hist-note{margin:0 0 10px;color:var(--dsw-alias-label-secondary);line-height:1.5;white-space:pre-wrap}",
 			".evo-hist-note[data-error=\"true\"]{color:var(--dsw-alias-state-error-primary)}",
-			".evo-hist-group{margin:10px 0 2px;font-size:inherit;font-weight:600}",
-			".evo-hist-row{display:flex;align-items:flex-start;gap:8px;padding:8px 0;border-top:.5px solid var(--dsw-alias-border-l3)}",
+			".evo-hist-group{margin:10px 0 2px;font-size:calc(1em - 1px);font-weight:600;color:var(--dsw-alias-label-secondary)}",
+			".evo-hist-row{display:flex;align-items:flex-start;gap:8px;padding:8px 0;border-top:.5px solid var(--dsw-alias-border-l2)}",
+			".evo-hist-row:first-of-type{border-top:0}",
 			".evo-hist-row-body{flex:1 1 auto;min-width:0}",
 			".evo-hist-row-title{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap}",
 			".evo-hist-row-meta{color:var(--dsw-alias-label-tertiary)}",
 			".evo-hist-row-summary{margin-top:2px;color:var(--dsw-alias-label-secondary);line-height:1.5}",
 			".evo-hist-actions{display:flex;flex:none;align-items:center;gap:6px}",
-			".evo-hist-capsule{flex:none;padding:1px 6px;border:.5px solid var(--dsw-alias-border-l2);border-radius:999px;color:var(--dsw-alias-label-secondary)}",
+			".evo-hist-capsule{flex:none;padding:1px 8px;border:0;border-radius:999px;background:var(--dsw-alias-interactive-bg-active);color:var(--dsw-alias-label-secondary)}",
 			".evo-hist-button{flex:none;font:inherit;padding:3px 10px;border:.5px solid var(--dsw-alias-border-l2);border-radius:8px;background:transparent;color:inherit;cursor:pointer}",
 			".evo-hist-button:hover{background:var(--dsw-alias-interactive-bg-hover)}",
 			".evo-hist-button:focus-visible{outline:2px solid var(--dsw-alias-label-primary);outline-offset:-2px}",
@@ -299,6 +307,17 @@ window.__ModuleLoader__.load({
 			if (skill.protectedBy !== null) return "state.protected";
 			return skill.managed ? "state.managed" : "state.foreign";
 		}
+		/**
+		* The one clause an action word needs: what the recorded artifact IS. It rides the action word's
+		* `title` instead of widening the row (a parenthetical in the sentence pushed time and size aside).
+		* @param face - copy plus the data callbacks.
+		* @param row - the version row whose action is being named.
+		* @returns the clause, or undefined for the actions that need none.
+		*/
+		function actionNote(face, row) {
+			if (row.actionKind === "delete") return face.t("action.delete.note");
+			if (row.actionKind === "archive") return face.t("action.archive.note");
+		}
 		/** The relative-time sentence for one row's bucket. */
 		function ageText(face, age) {
 			if (age.unit === "now") return face.t("time.now");
@@ -337,11 +356,15 @@ window.__ModuleLoader__.load({
 					key: "v",
 					className: "evo-hist-row-meta"
 				}, "v" + String(row.v)),
-				(0, react.createElement)("span", { key: "action" }, face.t("action." + row.actionKind)),
+				(0, react.createElement)("span", {
+					key: "action",
+					title: actionNote(face, row)
+				}, face.t("action." + row.actionKind)),
 				(0, react.createElement)("span", {
 					key: "time",
-					className: "evo-hist-row-meta"
-				}, localTime(row.at) + " · " + ageText(face, row.age))
+					className: "evo-hist-row-meta",
+					title: localTime(row.at)
+				}, ageText(face, row.age))
 			];
 			const delta = deltaText(face, row);
 			if (delta !== null) parts.push((0, react.createElement)("span", {
@@ -539,7 +562,7 @@ window.__ModuleLoader__.load({
 				type: "button",
 				className: "evo-hist-button",
 				onClick: refresh
-			}, face.t("refresh"))), (0, react.createElement)("p", { className: "evo-hist-hint" }, face.t("hint")), noteText === void 0 ? null : (0, react.createElement)("p", {
+			}, face.t("refresh"))), (0, react.createElement)("p", { className: "evo-hist-hint" }, face.t("hint")), selected === void 0 ? (0, react.createElement)("p", { className: "evo-hist-pane-empty" }, face.t(skills.length === 0 ? "empty.skills" : "empty.pick")) : null, noteText === void 0 ? null : (0, react.createElement)("p", {
 				className: "evo-hist-note",
 				"data-error": noteError ? "true" : void 0
 			}, noteText), selected === void 0 ? null : loaded ? null : (0, react.createElement)("p", { className: "evo-hist-hint" }, face.t("loading")), loaded ? (0, react.createElement)("div", null, group(face, face.t("group.content"), payload.content, void 0, rowState), group(face, face.t("group.support"), payload.support, face.t("group.support.note"), rowState), payload.content.length === 0 && payload.support.length === 0 ? (0, react.createElement)("p", { className: "evo-hist-hint" }, face.t("empty.versions")) : null) : null));
@@ -564,24 +587,44 @@ window.__ModuleLoader__.load({
 		/** Row order inside the global panel list (beside the platform's own rows). */
 		const PANEL_ORDER = 35;
 		/**
-		* The row's icon: a platform-style line glyph, sized by the SIDEBAR's own contract.
+		* The row's icon: a platform-style line glyph, whose SIZE comes from the sidebar's contract and whose
+		* glyph BOX is the one the neighbouring rows draw at.
+		*
+		* Size: the platform hands every `sidebar.panellist` occupant `{ size, active }` (`SidebarRoot.tsx`
+		* `renderSlot('sidebar.panellist', { size: wide ? 16 : 18, active }, …)`), so the glyph takes its size
+		* from that prop; a glyph that sizes itself from CSS (`width: 100%`) resolves against an unsized flex
+		* box and fills the whole column.
 		*
-		* The platform hands every `sidebar.panellist` occupant `{ size, active }` (`SidebarRoot.tsx`
-		* `renderSlot('sidebar.panellist', { size: wide ? 16 : 18, active }, …)`) and its own icons render at
-		* that size (`IconGlobeOutline14 size={size}` in the sidebar's own spec). The neighbouring rows in a
-		* shipped GUI take the OTHER route — they inject their entry into the sidebar's DOM with their own
-		* `svg { width: 18px; height: 18px }` CSS — so 18px is the size a row glyph is expected to occupy.
-		* A glyph that sizes itself from CSS (`width: 100%`) resolves against an unsized flex box and fills
-		* the column: the size must come from the prop, with the neighbours' 18 as the fallback. The label
-		* carries the accessible name, so the glyph stays decoration.
+		* Box: the three rows above (task board / SSH / skill centre) are NOT slot occupants — they inject
+		* plain DOM into the sidebar with their own CSS (`.entry{padding:0 10px;gap:8px}` plus a 24px icon box
+		* holding an 18px glyph, `shared/client/sidebar-entry-core.ts`), so their glyph ink starts 13px into
+		* the column and their label 42px. Inside the platform panel row (8px padding, 8px gap) those two
+		* lines are reached by a 26px box: `8 + (26 - 16) / 2 = 13` and `8 + 26 + 8 = 42`.
+		* Matching the neighbours is a CHOICE (the platform's own rows below — the workspace folders — sit at
+		* 8px and 32px); it keeps the four plugin rows reading as one column. The label carries the accessible
+		* name, so the glyph stays decoration.
 		*/
+		/** The glyph box in px: the neighbours' 24px icon box, placed to land on their two content lines. */
+		const GLYPH_BOX = 26;
+		/** The glyph's own coordinate system: every path below is drawn inside 16 units. */
+		const GLYPH_UNITS = 16;
+		/**
+		* Trim a computed viewBox number: three decimals stay readable and are far below one pixel.
+		* @param value - the raw number.
+		* @returns the value rounded to three decimals.
+		*/
+		function round3(value) {
+			return Math.round(value * 1e3) / 1e3;
+		}
 		function PanelIcon(props = {}) {
 			const size = typeof props.size === "number" && props.size > 0 ? props.size : 18;
+			const units = round3(GLYPH_UNITS * GLYPH_BOX / size);
+			const inset = round3((units - GLYPH_UNITS) / 2);
 			return (0, react.createElement)("svg", {
 				"aria-hidden": "true",
-				width: String(size),
-				height: String(size),
-				viewBox: "0 0 16 16",
+				width: String(GLYPH_BOX),
+				height: String(GLYPH_BOX),
+				viewBox: String(-inset) + " " + String(-inset) + " " + String(units) + " " + String(units),
 				fill: "none",
 				stroke: "currentColor",
 				strokeWidth: "1.5",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-skill-history",
   "description": "Web surface for skill content history: loopback host routes plus the sidebar panel (community build)",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "publishConfig": {
     "access": "public"
   },
@@ -30,21 +30,21 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@lmzhen/dsh-evolution-core": "^0.13.2"
+    "@lmzhen/dsh-evolution-core": "^0.13.3"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
     "react": "^18.2.0",
-    "@lmzhen/dsh-evolution-curator": "^0.13.2"
+    "@lmzhen/dsh-evolution-curator": "^0.13.3"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.13.2",
-    "@lmzhen/dsh-evolution-curator": "^0.13.2",
-    "@lmzhen/dsh-evolution-io": "^0.13.2",
-    "@lmzhen/dsh-evolution-io-node": "^0.13.2"
+    "@lmzhen/dsh-evolution-core": "^0.13.3",
+    "@lmzhen/dsh-evolution-curator": "^0.13.3",
+    "@lmzhen/dsh-evolution-io": "^0.13.3",
+    "@lmzhen/dsh-evolution-io-node": "^0.13.3"
   },
   "dsh": {
     "client": {