@lmzhen/dsh-evolution-skill-health 0.30.37 → 0.30.38

package/lib/client.js

@@ -288,10 +288,14 @@ window.__ModuleLoader__.load({
 			"title": "技能健康",
 			"hint": "体检引擎的结论，按规则聚合。未标定的阈值只报规则名、不报数字；读不到的技能按「不可读」列出，不当作没问题。",
 			"refresh": "刷新",
+			"readAt.unknown": "扫描时间未知",
+			"scan.complete": "扫描完成",
+			"scan.unavailable": "扫描不可用",
+			"protected": "受保护，写入被拒绝。",
 			"loading": "读取中…",
 			"group.byRule": "按规则",
 			"group.bySkill": "按技能",
-			"verdict.ok": "正常",
+			"verdict.healthy": "正常",
 			"verdict.warn": "警告",
 			"verdict.needs-restructure": "需重构",
 			"verdict.error": "错误",
@@ -304,7 +308,21 @@ window.__ModuleLoader__.load({
 			"proposal.outcome.owner-gap": "owner 缺口",
 			"proposal.owner.covered": "有覆盖 owner",
 			"proposal.owner.owner-gap": "无覆盖 owner",
+			"proposal.status.proposed": "状态：提议",
+			"proposal.status.previewed": "状态：已预览",
+			"proposal.status.stale": "状态：已过期",
+			"proposal.status.dismissed": "状态：已忽略",
+			"proposal.reusable": "可提取",
+			"proposal.kept": "保留正文",
+			"proposal.warnings": "警告",
+			"proposal.copy": "复制命令",
 			"counts": "{ok} 正常 · {warn} 警告 · {error} 错误 · {unreadable} 不可读",
+			"col.skill": "技能",
+			"col.findings": "证据",
+			"findings.none": "无规则命中",
+			"dims.body": "正文",
+			"dims.support": "支撑文件",
+			"dims.unknown": "未知",
 			"col.rule": "规则",
 			"col.skills": "涉及技能",
 			"col.count": "次数",
@@ -321,7 +339,11 @@ window.__ModuleLoader__.load({
 			"failure.forbidden": "平台拒绝了这个请求（身份不是 owner）。",
 			"failure.unmounted": "该功能没有挂载。",
 			"failure.server": "读取失败，可以重试。",
-			"fallback.hint": "可以改用命令：{command}"
+			"fallback.hint": "可以改用命令：{command}",
+			"action.history": "查看历史",
+			"action.copy": "复制命令",
+			"action.extract": "提取",
+			"action.extract.reason": "命令/预览面未就绪，暂不可用。"
 		};
 		/** English dictionary. */
 		const en = {
@@ -330,10 +352,14 @@ window.__ModuleLoader__.load({
 			"title": "Skill Health",
 			"hint": "What the health engine found, aggregated by rule. A rule whose threshold is not calibrated yet is named without a number; skills that cannot be read are listed as unreadable, never as fine.",
 			"refresh": "Refresh",
+			"readAt.unknown": "Scan time unknown",
+			"scan.complete": "Scan complete",
+			"scan.unavailable": "Scan unavailable",
+			"protected": "Protected; writes are refused.",
 			"loading": "Loading…",
 			"group.byRule": "By rule",
 			"group.bySkill": "By skill",
-			"verdict.ok": "OK",
+			"verdict.healthy": "OK",
 			"verdict.warn": "Warn",
 			"verdict.needs-restructure": "Needs restructure",
 			"verdict.error": "Error",
@@ -346,7 +372,21 @@ window.__ModuleLoader__.load({
 			"proposal.outcome.owner-gap": "owner-gap",
 			"proposal.owner.covered": "covered owner",
 			"proposal.owner.owner-gap": "no covering owner",
+			"proposal.status.proposed": "status: proposed",
+			"proposal.status.previewed": "status: previewed",
+			"proposal.status.stale": "status: stale",
+			"proposal.status.dismissed": "status: dismissed",
+			"proposal.reusable": "reusable",
+			"proposal.kept": "kept body",
+			"proposal.warnings": "warnings",
+			"proposal.copy": "Copy command",
 			"counts": "{ok} ok · {warn} warn · {error} error · {unreadable} unreadable",
+			"col.skill": "Skill",
+			"col.findings": "Evidence",
+			"findings.none": "No rule hit",
+			"dims.body": "Body",
+			"dims.support": "Support files",
+			"dims.unknown": "unknown",
 			"col.rule": "Rule",
 			"col.skills": "Skills",
 			"col.count": "Count",
@@ -362,7 +402,11 @@ window.__ModuleLoader__.load({
 			"failure.forbidden": "The platform refused this request (not the owner principal).",
 			"failure.unmounted": "This feature is not mounted.",
 			"failure.server": "The read failed; you can retry.",
-			"fallback.hint": "Command fallback: {command}"
+			"fallback.hint": "Command fallback: {command}",
+			"action.history": "History",
+			"action.copy": "Copy command",
+			"action.extract": "Extract",
+			"action.extract.reason": "The command/preview surface is not ready yet."
 		};
 		//#endregion
 		//#region src/client/styles.ts
@@ -435,7 +479,7 @@ window.__ModuleLoader__.load({
 		*/
 		/** Kinds in the order the summary reads them. */
 		const KINDS = [
-			"ok",
+			"healthy",
 			"warn",
 			"needs-restructure",
 			"error",
@@ -463,15 +507,31 @@ window.__ModuleLoader__.load({
 				"needs-restructure",
 				"warn",
 				"unreadable",
-				"ok"
+				"healthy"
 			];
-			let worst = "ok";
+			let worst = "healthy";
 			for (const row of face.rows) {
 				if (!skills.includes(row.name)) continue;
 				if (order.indexOf(row.verdict) < order.indexOf(worst)) worst = row.verdict;
 			}
 			return worst;
 		}
+		/** H4: the evidence queue by skill, before the by-rule summary. */
+		function skillQueue(face, t) {
+			const order = [
+				"error",
+				"needs-restructure",
+				"warn",
+				"unreadable",
+				"healthy"
+			];
+			const rows = [...face.rows].sort((a, b) => order.indexOf(a.verdict) - order.indexOf(b.verdict) || a.name.localeCompare(b.name));
+			return (0, react.createElement)("div", { "data-role": "skill-queue" }, (0, react.createElement)("h3", { "data-role": "group-title" }, t("group.bySkill")), ...rows.map((row) => (0, react.createElement)("div", {
+				key: row.name,
+				"data-role": "skill-row",
+				"data-tone": row.verdict
+			}, (0, react.createElement)("span", { "data-role": "skill-name" }, row.name), (0, react.createElement)("span", { "data-role": "skill-verdict" }, t("verdict." + row.verdict)), (0, react.createElement)("span", { "data-role": "skill-findings" }, row.findings.length === 0 ? t("findings.none") : row.findings.map((finding) => finding.rule).join(" / ")), (0, react.createElement)("span", { "data-role": "skill-dims" }, t("dims.body") + ": " + String(row.dims?.bodyChars ?? t("dims.unknown")) + " · " + t("dims.support") + ": " + String(row.dims?.supportFiles ?? t("dims.unknown"))))));
+		}
 		/** The rule table: a grid so counts line up, with a tone bar per row and skill pills. */
 		function ruleTable(face, t) {
 			const rows = byRule(face.rows);
@@ -492,6 +552,31 @@ window.__ModuleLoader__.load({
 				title: name
 			}, name))), cell("rule-count", entry.count === 0 ? t("count.notCalibrated") : String(entry.count)))));
 		}
+		/** Per-skill actions: open history, copy the CLI command, and the disabled extract entry. */
+		function skillActions(face, t) {
+			const names = [...new Set(face.rows.map((row) => row.name))];
+			const copy = (name) => {
+				const text = "/evolution skill history " + name;
+				if (typeof navigator !== "undefined" && navigator.clipboard !== void 0) navigator.clipboard.writeText(text).catch(() => {});
+			};
+			return (0, react.createElement)("div", { "data-role": "skill-actions" }, ...names.map((name) => (0, react.createElement)("div", {
+				key: name,
+				"data-role": "skill-action-row"
+			}, (0, react.createElement)("span", { "data-role": "skill-action-name" }, name), (0, react.createElement)("button", {
+				type: "button",
+				"data-role": "action-history",
+				disabled: face.openHistory === void 0,
+				onClick: () => {
+					face.openHistory?.(name);
+				}
+			}, t("action.history")), (0, react.createElement)("button", {
+				type: "button",
+				"data-role": "action-copy",
+				onClick: () => {
+					copy(name);
+				}
+			}, t("action.copy")))));
+		}
 		/**
 		* Render the panel.
 		* @param props - the face (`{ rows, truncated, openHistory? }`) and the locale seat's translator.
@@ -520,49 +605,97 @@ window.__ModuleLoader__.load({
 			const t = face.t;
 			const [view, setView] = (0, react.useState)(face);
 			const [failed, setFailed] = (0, react.useState)(void 0);
-			(0, react.useEffect)(() => {
-				const load = face.loadRows;
-				if (load === void 0) return;
+			const [loading, setLoading] = (0, react.useState)(face.loadRows !== void 0 && face.loaded !== true);
+			const [lastReadAt, setLastReadAt] = (0, react.useState)(face.readAt);
+			const [scan, setScan] = (0, react.useState)(face.scan);
+			/** One read trigger for first paint and the refresh button; the latest answer wins. */
+			const load = () => {
+				const read = face.loadRows;
+				if (read === void 0) return () => {};
 				let live = true;
-				load().then((outcome) => {
+				setLoading(true);
+				read().then((outcome) => {
 					if (!live) return;
-					if (outcome.ok) setView({
-						...face,
-						rows: outcome.payload.rows,
-						truncated: outcome.payload.truncated,
-						proposals: outcome.payload.proposals ?? [],
-						loaded: true,
-						...outcome.payload.proposalStatus === void 0 ? {} : { proposalStatus: outcome.payload.proposalStatus }
-					});
-					else setFailed(outcome.failure);
+					if (outcome.ok) {
+						const payload = outcome.payload;
+						setView({
+							...face,
+							rows: payload.rows,
+							truncated: payload.truncated,
+							proposals: payload.proposals ?? [],
+							loaded: true,
+							...payload.proposalStatus === void 0 ? {} : { proposalStatus: payload.proposalStatus }
+						});
+						setLastReadAt(payload.readAt);
+						setScan(payload.scan);
+					} else setFailed(outcome.failure);
 				}).catch(() => {
 					if (live) setFailed({
 						kind: "server",
 						status: 0
 					});
+				}).finally(() => {
+					if (live) setLoading(false);
 				});
 				return () => {
 					live = false;
 				};
-			}, [face]);
+			};
+			(0, react.useEffect)(() => load(), [face]);
 			const counts = new Map(KINDS.map((kind) => [kind, view.rows.filter((row) => row.verdict === kind).length]));
 			const stats = (0, react.createElement)("div", { "data-role": "stats" }, KINDS.map((kind) => (0, react.createElement)("div", {
 				key: kind,
 				"data-role": "stat",
 				"data-tone": kind
 			}, (0, react.createElement)("div", { "data-role": "stat-value" }, String(counts.get(kind) ?? 0)), (0, react.createElement)("div", { "data-role": "stat-label" }, t("verdict." + kind)))));
-			return (0, react.createElement)("section", { className: CSS_TAG_ID }, (0, react.createElement)("p", { "data-role": "hint" }, t("hint")), stats, view.truncated ? (0, react.createElement)("p", { "data-role": "note" }, t("scan.truncated")) : null, failed === void 0 ? null : (0, react.createElement)("div", { "data-role": "note" }, failureBlock(t, failed)), view.loaded === true && view.rows.length === 0 ? (0, react.createElement)("p", { "data-role": "note" }, t("empty.noneReported")) : null, view.proposalStatus === "unavailable" && (view.proposals ?? []).length === 0 ? (0, react.createElement)("p", { "data-role": "note" }, t("proposal.unavailable")) : null, (view.proposals ?? []).length > 0 ? (0, react.createElement)("div", { "data-role": "proposals" }, (0, react.createElement)("h3", { "data-role": "group-title" }, t("group.proposals")), ...(view.proposals ?? []).map((proposal) => (0, react.createElement)("p", {
-				key: proposal.id,
-				"data-role": "proposal"
-			}, proposal.source + " — " + t("proposal.outcome." + proposal.outcome) + " · " + (proposal.owner.mode === "covered" ? t("proposal.owner.covered") + (proposal.owner.name === void 0 ? "" : ": " + proposal.owner.name) : t("proposal.owner.owner-gap") + (proposal.owner.neededOwner === void 0 ? "" : ": " + proposal.owner.neededOwner))))) : null, (0, react.createElement)("h3", { "data-role": "group-title" }, t("group.byRule")), ruleTable(view, t), view.rows.filter((row) => row.verdict === "unreadable").map((row) => (0, react.createElement)("p", {
+			return (0, react.createElement)("section", { className: CSS_TAG_ID }, (0, react.createElement)("div", { "data-role": "header" }, (0, react.createElement)("span", { "data-role": "read-at" }, lastReadAt === void 0 ? t("readAt.unknown") : new Date(lastReadAt).toLocaleString()), (0, react.createElement)("span", { "data-role": "scan-status" }, t("scan." + (scan?.status ?? "unavailable"))), (0, react.createElement)("button", {
+				type: "button",
+				"data-role": "refresh",
+				disabled: loading,
+				onClick: () => {
+					load();
+				}
+			}, t("refresh"))), (0, react.createElement)("p", { "data-role": "hint" }, t("hint")), stats, loading ? (0, react.createElement)("p", { "data-role": "note" }, t("loading")) : null, view.truncated ? (0, react.createElement)("p", { "data-role": "note" }, t("scan.truncated")) : null, failed === void 0 ? null : (0, react.createElement)("div", { "data-role": "note" }, failureBlock(t, failed)), view.loaded === true && view.rows.length === 0 ? (0, react.createElement)("p", { "data-role": "note" }, t("empty.noneReported")) : null, view.proposalStatus === "unavailable" && (view.proposals ?? []).length === 0 ? (0, react.createElement)("p", { "data-role": "note" }, t("proposal.unavailable")) : null, (view.proposals ?? []).length > 0 ? (0, react.createElement)("div", { "data-role": "proposals" }, (0, react.createElement)("h3", { "data-role": "group-title" }, t("group.proposals")), ...(view.proposals ?? []).map((proposal) => {
+				const heading = proposal.parts?.[0]?.heading;
+				const target = proposal.owner.mode === "covered" ? proposal.owner.name : proposal.owner.neededOwner;
+				const command = heading === void 0 || target === void 0 ? void 0 : "/evolution extract " + proposal.source + " " + target + " \"" + heading + "\" --plan";
+				const copyCommand = () => {
+					if (command !== void 0 && typeof navigator !== "undefined" && navigator.clipboard !== void 0) navigator.clipboard.writeText(command).catch(() => {});
+				};
+				return (0, react.createElement)("div", {
+					key: proposal.id,
+					"data-role": "proposal"
+				}, (0, react.createElement)("p", { "data-role": "proposal-summary" }, proposal.source + " — " + t("proposal.outcome." + proposal.outcome) + " · " + (proposal.owner.mode === "covered" ? t("proposal.owner.covered") + (proposal.owner.name === void 0 ? "" : ": " + proposal.owner.name) : t("proposal.owner.owner-gap") + (proposal.owner.neededOwner === void 0 ? "" : ": " + proposal.owner.neededOwner))), (0, react.createElement)("p", { "data-role": "proposal-status" }, t("proposal.status." + proposal.status)), proposal.provenance === void 0 ? null : (0, react.createElement)("p", { "data-role": "proposal-provenance" }, proposal.provenance.promptVersion + (proposal.provenance.model === void 0 ? "" : " · " + proposal.provenance.model) + " · " + proposal.provenance.runId + " · " + new Date(proposal.provenance.at).toLocaleString() + (proposal.provenance.promptHash === void 0 ? "" : " · #" + proposal.provenance.promptHash.slice(0, 8))), proposal.residual === void 0 || proposal.residual.trim() === "" ? null : (0, react.createElement)("p", { "data-role": "proposal-kept" }, t("proposal.kept") + ": " + proposal.residual.trim().slice(0, 160)), (proposal.parts ?? []).length === 0 ? null : (0, react.createElement)("p", { "data-role": "proposal-reusable" }, t("proposal.reusable") + ": " + (proposal.parts ?? []).map((part) => part.heading).join("、")), (proposal.warnings ?? []).length === 0 ? null : (0, react.createElement)("p", { "data-role": "proposal-warnings" }, t("proposal.warnings") + ": " + (proposal.warnings ?? []).join("；")), command === void 0 ? null : (0, react.createElement)("p", { "data-role": "proposal-command" }, (0, react.createElement)("code", {}, command), (0, react.createElement)("button", {
+					type: "button",
+					"data-role": "proposal-copy",
+					onClick: copyCommand
+				}, t("proposal.copy"))));
+			})) : null, skillQueue(view, t), (0, react.createElement)("h3", { "data-role": "group-title" }, t("group.byRule")), ruleTable(view, t), skillActions(view, t), view.rows.filter((row) => row.verdict === "unreadable").map((row) => (0, react.createElement)("p", {
 				key: row.name + ":unreadable",
 				"data-role": "note"
-			}, row.name + " — " + t("unreadable.note"))));
+			}, row.name + " — " + t("unreadable.note"))), view.rows.filter((row) => row.protection !== void 0 && row.protection !== null).map((row) => (0, react.createElement)("p", {
+				key: row.name + ":protected",
+				"data-role": "note"
+			}, row.name + " — " + t("protected"))));
+		}
+		//#endregion
+		//#region src/client/seats.ts
+		/** Fail loud when the injected client seats are absent, instead of leaving a PENDING row. */
+		function requireHealthSeats(ctx) {
+			if (ctx.slots === void 0) throw new Error("skill-health: the client slots seat is not mounted");
+		}
+		/** The one place the panel crosses into the platform layout seat. */
+		function openSkillHistory(ctx) {
+			ctx.layout.selectPanel("skill-history");
 		}
 		//#endregion
 		//#region src/client/index.ts
 		/** Required client services: the slot registry and the locale seat. */
-		const inject = ["slots", "locale"];
+		const inject = [
+			"slots",
+			"locale",
+			"layout"
+		];
 		function PanelIcon(props = {}) {
 			const size = typeof props.size === "number" && props.size > 0 ? props.size : 16;
 			return (0, react.createElement)("svg", {
@@ -582,6 +715,7 @@ window.__ModuleLoader__.load({
 		* @param ctx - the client context; it must carry the two seats above.
 		*/
 		function apply(ctx) {
+			requireHealthSeats(ctx);
 			registerSidebarPanel(ctx, {
 				id: PANEL_ID,
 				order: 40,
@@ -603,6 +737,9 @@ window.__ModuleLoader__.load({
 					loaded: false,
 					proposalStatus: "unavailable",
 					loadRows: rows,
+					openHistory: () => {
+						openSkillHistory(ctx);
+					},
 					t
 				})
 			});

package/lib/index.js

@@ -32,6 +32,8 @@ function toRouteRows(rows) {
 			...finding.severity === void 0 ? {} : { severity: finding.severity },
 			...finding.message === void 0 ? {} : { message: finding.message }
 		})),
+		...row.protection === void 0 || row.protection === null ? {} : { protection: row.protection },
+		...row.hardCapHits === void 0 ? {} : { hardCapHits: row.hardCapHits },
 		...row.dims === void 0 || row.dims === null ? {} : { dims: {
 			bodyChars: row.dims.bodyChars ?? null,
 			bodyTokens: row.dims.bodyTokens ?? null,

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

@@ -32,9 +32,13 @@ export interface HealthDims {
 /** One skill row. `readable: false` is its own verdict — never folded into `ok`. */
 export interface HealthRow {
     name: string;
-    verdict: 'ok' | 'warn' | 'error' | 'unreadable' | 'needs-restructure';
+    verdict: 'healthy' | 'warn' | 'error' | 'unreadable' | 'needs-restructure';
     findings: HealthFinding[];
     dims?: HealthDims | null;
+    /** Non-null when a protection marker owns the skill. */
+    protection?: string | null;
+    /** Mechanical hard-cap hits; null = event log unreadable, never 0-as-unknown. */
+    hardCapHits?: number | null;
 }
 /** One semantic proposal as the health lane projects it; never generated by this panel. */
 export interface HealthProposal {
@@ -47,6 +51,18 @@ export interface HealthProposal {
         neededOwner?: string;
     };
     status: 'proposed' | 'previewed' | 'stale' | 'dismissed';
+    parts?: Array<{
+        heading: string;
+    }>;
+    residual?: string;
+    warnings?: string[];
+    provenance?: {
+        promptVersion: string;
+        promptHash?: string;
+        model?: string;
+        runId: string;
+        at: number;
+    };
 }
 /** What the sidebar hands the component. */
 export interface HealthFace {
@@ -63,6 +79,11 @@ export interface HealthFace {
     loaded?: boolean;
     /** Semantic proposals are a separate lane; unavailable must not read as "nothing to extract". */
     proposalStatus?: 'available' | 'unavailable' | 'stale';
+    /** Host scan time and status, when the route supplied them. */
+    readAt?: number;
+    scan?: {
+        status: 'complete' | 'unavailable' | 'truncated';
+    };
     /** The seat's translator for this bundle's dictionary — the panel never reaches for a service. */
     t: (key: string) => string;
 }

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

@@ -0,0 +1,6 @@
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/** Fail loud when the injected client seats are absent, instead of leaving a PENDING row. */
+export declare function requireHealthSeats(ctx: ClientContext): void;
+/** The one place the panel crosses into the platform layout seat. */
+export declare function openSkillHistory(ctx: ClientContext): void;
+//# sourceMappingURL=seats.d.ts.map

package/lib/types/routes.d.ts

@@ -25,12 +25,16 @@ export interface RouteDims {
     churnReads: number | null;
     stampDensityPerKb: number | null;
 }
-/** One row as the client sees it. `readable: false` becomes its own verdict, never `ok`. */
+/** One row as the client sees it. `readable: false` becomes its own verdict, never `healthy`. */
 export interface RouteRow {
     name: string;
     verdict: string;
     findings: RouteFinding[];
     dims?: RouteDims | null;
+    /** Non-null when a protection marker owns the skill; the panel marks the row. */
+    protection?: string | null;
+    /** Mechanical hard-cap-hit count; null when the event log was unreadable. */
+    hardCapHits?: number | null;
 }
 /**
  * Project the curator's health view into what the panel renders.
@@ -50,6 +54,8 @@ export declare function toRouteRows(rows: ReadonlyArray<{
     dims?: (Partial<RouteDims> & {
         readable?: boolean;
     }) | null;
+    protection?: string | null;
+    hardCapHits?: number | null;
 }>): RouteRow[];
 /**
  * Build the panel's route in the platform's exact FetchRoute shape.

package/package.json

@@ -11,7 +11,7 @@
       ]
     }
   },
-  "version": "0.30.37",
+  "version": "0.30.38",
   "publishConfig": {
     "access": "public"
   },
@@ -42,18 +42,18 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",
     "react": "^18.2.0",
-    "@lmzhen/dsh-evolution-core": "^0.30.37",
-    "@lmzhen/dsh-evolution-curator": "^0.30.37"
+    "@lmzhen/dsh-evolution-core": "^0.30.38",
+    "@lmzhen/dsh-evolution-curator": "^0.30.38"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@lmzhen/dsh-evolution-core": "^0.30.37",
-    "@lmzhen/dsh-evolution-curator": "^0.30.37"
+    "@lmzhen/dsh-evolution-core": "^0.30.38",
+    "@lmzhen/dsh-evolution-curator": "^0.30.38"
   },
   "dependencies": {
-    "@lmzhen/dsh-evolution-client-kit": "^0.30.37"
+    "@lmzhen/dsh-evolution-client-kit": "^0.30.38"
   },
   "engines": {
     "dsh": ">=0.2.1-rc.2 <0.2.2-0"