@lmzhen/dsh-evolution-skill-health 0.30.31 → 0.30.34

package/lib/client.js

@@ -257,7 +257,11 @@ window.__ModuleLoader__.load({
 				ok: true,
 				payload: {
 					rows: answer.data.rows,
-					truncated: answer.data.truncated
+					truncated: answer.data.truncated,
+					...answer.data.readAt === void 0 ? {} : { readAt: answer.data.readAt },
+					...answer.data.scan === void 0 ? {} : { scan: answer.data.scan },
+					...answer.data.proposals === void 0 ? {} : { proposals: answer.data.proposals },
+					...answer.data.proposalStatus === void 0 ? {} : { proposalStatus: answer.data.proposalStatus }
 				}
 			};
 		}
@@ -289,8 +293,17 @@ window.__ModuleLoader__.load({
 			"group.bySkill": "按技能",
 			"verdict.ok": "正常",
 			"verdict.warn": "警告",
+			"verdict.needs-restructure": "需重构",
 			"verdict.error": "错误",
 			"verdict.unreadable": "不可读",
+			"group.proposals": "语义提议",
+			"proposal.unavailable": "提议源未挂载；这不是「没有可拆项」。",
+			"proposal.outcome.keep": "保持",
+			"proposal.outcome.extract": "提取",
+			"proposal.outcome.mixed": "混合",
+			"proposal.outcome.owner-gap": "owner 缺口",
+			"proposal.owner.covered": "有覆盖 owner",
+			"proposal.owner.owner-gap": "无覆盖 owner",
 			"counts": "{ok} 正常 · {warn} 警告 · {error} 错误 · {unreadable} 不可读",
 			"col.rule": "规则",
 			"col.skills": "涉及技能",
@@ -301,6 +314,7 @@ window.__ModuleLoader__.load({
 			"line": "位置：{path}",
 			"line.unknown": "位置：未知",
 			"unreadable.note": "读不到内容，因此无法判断（不是「通过」）。",
+			"scan.truncated": "本次扫描不完整，计数是下界；请刷新后重试。",
 			"loading.failed": "读取失败——现在判断不了；点「刷新」重试。",
 			"read.failed": "这次没读到数据（下面一行是原始信息）：",
 			"failure.unauthorized": "需要登录：重新打开这个页面完成登录后再试。",
@@ -321,8 +335,17 @@ window.__ModuleLoader__.load({
 			"group.bySkill": "By skill",
 			"verdict.ok": "OK",
 			"verdict.warn": "Warn",
+			"verdict.needs-restructure": "Needs restructure",
 			"verdict.error": "Error",
 			"verdict.unreadable": "Unreadable",
+			"group.proposals": "Semantic proposals",
+			"proposal.unavailable": "No proposal source is mounted; this is not \"nothing to extract\".",
+			"proposal.outcome.keep": "keep",
+			"proposal.outcome.extract": "extract",
+			"proposal.outcome.mixed": "mixed",
+			"proposal.outcome.owner-gap": "owner-gap",
+			"proposal.owner.covered": "covered owner",
+			"proposal.owner.owner-gap": "no covering owner",
 			"counts": "{ok} ok · {warn} warn · {error} error · {unreadable} unreadable",
 			"col.rule": "Rule",
 			"col.skills": "Skills",
@@ -333,6 +356,7 @@ window.__ModuleLoader__.load({
 			"line": "line: {path}",
 			"line.unknown": "line: UNKNOWN",
 			"unreadable.note": "The content could not be read, so this cannot be judged (it is not a pass).",
+			"scan.truncated": "This scan is incomplete; the counts are a lower bound. Press Refresh to retry.",
 			"loading.failed": "Reading failed — this cannot be judged right now; press Refresh to retry.",
 			"failure.unauthorized": "Sign-in is required: reopen this page and sign in, then retry.",
 			"failure.forbidden": "The platform refused this request (not the owner principal).",
@@ -413,6 +437,7 @@ window.__ModuleLoader__.load({
 		const KINDS = [
 			"ok",
 			"warn",
+			"needs-restructure",
 			"error",
 			"unreadable"
 		];
@@ -435,6 +460,7 @@ window.__ModuleLoader__.load({
 		function worstVerdict(face, skills) {
 			const order = [
 				"error",
+				"needs-restructure",
 				"warn",
 				"unreadable",
 				"ok"
@@ -503,7 +529,10 @@ window.__ModuleLoader__.load({
 					if (outcome.ok) setView({
 						...face,
 						rows: outcome.payload.rows,
-						truncated: outcome.payload.truncated
+						truncated: outcome.payload.truncated,
+						proposals: outcome.payload.proposals ?? [],
+						loaded: true,
+						...outcome.payload.proposalStatus === void 0 ? {} : { proposalStatus: outcome.payload.proposalStatus }
 					});
 					else setFailed(outcome.failure);
 				}).catch(() => {
@@ -522,7 +551,10 @@ window.__ModuleLoader__.load({
 				"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("loading.failed")) : null, failed === void 0 ? null : (0, react.createElement)("div", { "data-role": "note" }, failureBlock(t, failed)), view.rows.length === 0 ? (0, react.createElement)("p", { "data-role": "note" }, t("empty.noneReported")) : 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)("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", {
 				key: row.name + ":unreadable",
 				"data-role": "note"
 			}, row.name + " — " + t("unreadable.note"))));
@@ -566,7 +598,10 @@ window.__ModuleLoader__.load({
 				component: SkillHealthPanel,
 				body: (t) => ({
 					rows: [],
+					proposals: [],
 					truncated: false,
+					loaded: false,
+					proposalStatus: "unavailable",
 					loadRows: rows,
 					t
 				})

package/lib/index.js

@@ -1,4 +1,5 @@
 import { HOST_ROUTES, json, methodNotAllowed, registerHostRoutes } from "@lmzhen/dsh-evolution-core/http-routes";
+import { readProposalReports } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/routes.js
 /**
 * The panel's ONE read-only route: the health rows the browser half renders.
@@ -27,8 +28,19 @@ function toRouteRows(rows) {
 			rule: finding.rule,
 			count: finding.count,
 			line: finding.line ?? null,
-			countIsMeaningful: !UNCALIBRATED_RULES.includes(finding.rule)
-		}))
+			countIsMeaningful: !UNCALIBRATED_RULES.includes(finding.rule),
+			...finding.severity === void 0 ? {} : { severity: finding.severity },
+			...finding.message === void 0 ? {} : { message: finding.message }
+		})),
+		...row.dims === void 0 || row.dims === null ? {} : { dims: {
+			bodyChars: row.dims.bodyChars ?? null,
+			bodyTokens: row.dims.bodyTokens ?? null,
+			supportGroups: row.dims.supportGroups ?? 0,
+			supportFiles: row.dims.supportFiles ?? null,
+			churnPatches: row.dims.churnPatches ?? null,
+			churnReads: row.dims.churnReads ?? null,
+			stampDensityPerKb: row.dims.stampDensityPerKb ?? null
+		} }
 	}));
 }
 /**
@@ -47,11 +59,17 @@ function makeSkillHealthRoutes(deps, _audit) {
 			if (request.method !== "GET") return methodNotAllowed(["GET"]);
 			const curator = deps.getCurator();
 			const view = curator?.healthView === void 0 ? void 0 : await curator.healthView();
+			const rows = Array.isArray(view) ? toRouteRows(view) : [];
+			const proposals = await deps.getProposals?.() ?? [];
 			return json(200, {
 				ok: true,
 				data: {
-					rows: Array.isArray(view) ? toRouteRows(view) : [],
-					truncated: view === void 0
+					rows,
+					truncated: view === void 0,
+					readAt: Date.now(),
+					scan: { status: view === void 0 ? "unavailable" : "complete" },
+					proposals,
+					proposalStatus: deps.getProposals === void 0 ? "unavailable" : "available"
 				}
 			});
 		}
@@ -66,7 +84,13 @@ const inject = [];
 * @param ctx - the host context; the connection and curator arrive through it.
 */
 function apply(ctx) {
-	registerHostRoutes(ctx, (audit) => makeSkillHealthRoutes({ getCurator: () => ctx.get("evolutionCurator") }, audit));
+	registerHostRoutes(ctx, (audit) => makeSkillHealthRoutes({
+		getCurator: () => ctx.get("evolutionCurator"),
+		getProposals: async () => {
+			const io = ctx.get("evolutionIo")?.provider();
+			return io === void 0 ? void 0 : readProposalReports(io);
+		}
+	}, audit));
 }
 //#endregion
 export { apply, inject };

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

@@ -16,22 +16,53 @@ export interface HealthFinding {
     line: string | null;
     /** False for a rule whose threshold is not calibrated: the rule is named, the count is not shown. */
     countIsMeaningful: boolean;
+    severity?: 'warn' | 'error';
+    message?: string;
+}
+/** Measured dimensions behind a row; absent when the scan could not read them. */
+export interface HealthDims {
+    bodyChars: number | null;
+    bodyTokens: number | null;
+    supportGroups: number;
+    supportFiles: number | null;
+    churnPatches: number | null;
+    churnReads: number | null;
+    stampDensityPerKb: number | null;
 }
 /** One skill row. `readable: false` is its own verdict — never folded into `ok`. */
 export interface HealthRow {
     name: string;
-    verdict: 'ok' | 'warn' | 'error' | 'unreadable';
+    verdict: 'ok' | 'warn' | 'error' | 'unreadable' | 'needs-restructure';
     findings: HealthFinding[];
+    dims?: HealthDims | null;
+}
+/** One semantic proposal as the health lane projects it; never generated by this panel. */
+export interface HealthProposal {
+    id: string;
+    source: string;
+    outcome: 'keep' | 'extract' | 'mixed' | 'owner-gap';
+    owner: {
+        mode: 'covered' | 'owner-gap';
+        name?: string;
+        neededOwner?: string;
+    };
+    status: 'proposed' | 'previewed' | 'stale' | 'dismissed';
 }
 /** What the sidebar hands the component. */
 export interface HealthFace {
     rows: HealthRow[];
+    /** Semantic proposals from the one proposer; empty means none were handed in. */
+    proposals?: HealthProposal[];
     /** True when the host could not finish the scan: the counts below are then a lower bound. */
     truncated: boolean;
     /** Opens the skill-history panel for one skill, when that panel is present. */
     openHistory?: (name: string) => void;
     /** Reads the scan result from the host route. Absent faces render their seeded rows unchanged. */
     loadRows?: () => Promise<HealthOutcome>;
+    /** Whether the host has answered at least once; the seed is not an empty result. */
+    loaded?: boolean;
+    /** Semantic proposals are a separate lane; unavailable must not read as "nothing to extract". */
+    proposalStatus?: 'available' | 'unavailable' | 'stale';
     /** The seat's translator for this bundle's dictionary — the panel never reaches for a service. */
     t: (key: string) => string;
 }

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

@@ -1,5 +1,5 @@
 import type { RouteFailure } from '@lmzhen/dsh-evolution-client-kit/generated/route-client';
-import type { HealthRow } from './Panel.ts';
+import type { HealthProposal, HealthRow } from './Panel.ts';
 /** Route paths: the generated mirror of the host's HOST_ROUTES (one declaration in core). */
 export declare const HOST_ROUTES: {
     readonly rows: "/api/dsh-evolution/skill-health/rows";
@@ -9,6 +9,12 @@ export interface HealthPayload {
     rows: HealthRow[];
     /** True when the host could not finish the scan: the counts below are then a lower bound. */
     truncated: boolean;
+    readAt?: number;
+    scan?: {
+        status: 'complete' | 'unavailable' | 'truncated';
+    };
+    proposals?: HealthProposal[];
+    proposalStatus?: 'available' | 'unavailable' | 'stale';
 }
 /** Either the payload or the classified four-state failure — never a thrown error the panel must guess at. */
 export type HealthOutcome = {

package/lib/types/routes.d.ts

@@ -1,4 +1,5 @@
 import type { ConnectionFetchRouteLike, DecisionAudit } from '@lmzhen/dsh-evolution-core/http-routes';
+import type { ProposalView } from '@lmzhen/dsh-evolution-core';
 /** Where the panel asks for its rows. The ONE declaration lives in core (W1). */
 export declare const ROUTES: {
     readonly rows: "/api/dsh-evolution/skill-health/rows";
@@ -11,12 +12,25 @@ export interface RouteFinding {
     count: number;
     line: string | null;
     countIsMeaningful: boolean;
+    severity?: 'warn' | 'error';
+    message?: string;
+}
+/** The measured dimensions behind a row, for evidence chips; absent when the scan could not read them. */
+export interface RouteDims {
+    bodyChars: number | null;
+    bodyTokens: number | null;
+    supportGroups: number;
+    supportFiles: number | null;
+    churnPatches: number | null;
+    churnReads: number | null;
+    stampDensityPerKb: number | null;
 }
 /** One row as the client sees it. `readable: false` becomes its own verdict, never `ok`. */
 export interface RouteRow {
     name: string;
     verdict: string;
     findings: RouteFinding[];
+    dims?: RouteDims | null;
 }
 /**
  * Project the curator's health view into what the panel renders.
@@ -30,10 +44,12 @@ export declare function toRouteRows(rows: ReadonlyArray<{
         rule: string;
         count: number;
         line?: string | null;
+        severity?: 'warn' | 'error';
+        message?: string;
     }>;
-    dims?: {
+    dims?: (Partial<RouteDims> & {
         readable?: boolean;
-    } | null;
+    }) | null;
 }>): RouteRow[];
 /**
  * Build the panel's route in the platform's exact FetchRoute shape.
@@ -46,5 +62,7 @@ export declare function makeSkillHealthRoutes(deps: {
     getCurator: () => {
         healthView?: () => Promise<unknown>;
     } | undefined;
+    /** The one proposer's read seam; absent means the panel must say unavailable. */
+    getProposals?: () => readonly ProposalView[] | undefined | Promise<readonly ProposalView[] | undefined>;
 }, _audit: DecisionAudit): ConnectionFetchRouteLike[];
 //# sourceMappingURL=routes.d.ts.map

package/package.json

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