@lmzhen/dsh-evolution-merge-ui 0.0.0-stage → 0.28.0

package/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# @lmzhen/dsh-evolution-merge-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+技能合并的只读浏览器面板：三队列计数、行列表与刷新；动作只展示为命令文本，不在浏览器写技能。
+
+## 数据面
+
+读取 `/api/dsh-evolution/merge/view` 与 `/api/dsh-evolution/merge/rows`，走生成的路由表和 route-client。失败按四态显示，不伪造空成功。
+
+## 已知限制
+
+- 只读；approve/reject 等动作需复制命令执行。
+- 面板仅在 `evolution-merge` host 行与其 bundle 同时挂载时可用。

package/lib/client.js

@@ -0,0 +1,442 @@
+window.__ModuleLoader__.load({
+	id: "@lmzhen/dsh-evolution-merge-ui",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		//#region src/client/routes.generated.ts
+		/**
+		* Every family host path, generated from evolution-core's HOST_ROUTES (the ONE declaration).
+		* A browser half cannot import the host package at runtime (client bundles keep @deepseek-ai/*
+		* external), so the table is mirrored here mechanically; a rename in core regenerates all three
+		* client copies, and the generator's --check makes a stale copy red.
+		*/
+		const ROUTES = {
+			approval: {
+				pending: "/api/dsh-evolution/approval/pending",
+				preview: "/api/dsh-evolution/approval/preview",
+				approve: "/api/dsh-evolution/approval/approve",
+				reject: "/api/dsh-evolution/approval/reject"
+			},
+			"skill-history": {
+				skills: "/api/dsh-evolution/skill-history/skills",
+				versions: "/api/dsh-evolution/skill-history/versions",
+				diff: "/api/dsh-evolution/skill-history/versions/diff",
+				body: "/api/dsh-evolution/skill-history/versions/body",
+				undo: "/api/dsh-evolution/skill-history/undo",
+				health: "/api/dsh-evolution/skill-history/health"
+			},
+			"skill-health": { rows: "/api/dsh-evolution/skill-health/rows" },
+			merge: {
+				view: "/api/dsh-evolution/merge/view",
+				rows: "/api/dsh-evolution/merge/rows",
+				run: "/api/dsh-evolution/merge/run",
+				runs: "/api/dsh-evolution/merge/runs"
+			},
+			diagnostics: { view: "/api/dsh-evolution/diagnostics" }
+		};
+		//#endregion
+		//#region src/client/route-client.generated.ts
+		/** Classify a non-2xx status: 401/403/404 keep their own kind, everything else is a server answer. */
+		function classify(status) {
+			if (status === 401) return {
+				kind: "unauthenticated",
+				status: 401
+			};
+			if (status === 403) return {
+				kind: "forbidden",
+				status: 403
+			};
+			if (status === 404) return {
+				kind: "unmounted",
+				status: 404
+			};
+			return {
+				kind: "server",
+				status
+			};
+		}
+		/**
+		* One request, no retries and no body parsing for the platform's admission answers.
+		* @param doFetch - the fetch in use (the browser's, or a spec's stub).
+		* @param path - the exact route path from the generated ROUTES table.
+		* @param init - standard RequestInit.
+		* @returns the data, or the classified failure (network/parse failures read as 'server').
+		*/
+		async function requestJson(doFetch, path, init) {
+			let response;
+			try {
+				response = await doFetch(path, init);
+			} catch (error) {
+				return {
+					ok: false,
+					failure: {
+						kind: "server",
+						status: 0,
+						detail: error instanceof Error ? error.message : String(error)
+					}
+				};
+			}
+			if (!response.ok) return {
+				ok: false,
+				failure: classify(response.status)
+			};
+			let body;
+			try {
+				body = await response.json();
+			} catch {
+				return {
+					ok: false,
+					failure: {
+						kind: "server",
+						status: response.status
+					}
+				};
+			}
+			if (typeof body === "object" && body !== null) {
+				const record = body;
+				if (record.ok === true) return {
+					ok: true,
+					data: record.data
+				};
+				if (record.ok === false && typeof record.message === "string" && record.message !== "") return {
+					ok: false,
+					failure: {
+						kind: "refused",
+						code: typeof record.code === "string" && record.code !== "" ? record.code : "refused",
+						message: record.message
+					}
+				};
+			}
+			return {
+				ok: false,
+				failure: {
+					kind: "server",
+					status: response.status
+				}
+			};
+		}
+		//#endregion
+		//#region src/client/api.ts
+		/**
+		* The two read routes this panel uses, through the generated client route table and the
+		* shared route client. A refusal keeps the host's own sentence.
+		*/
+		const HOST_ROUTES = ROUTES.merge;
+		async function view() {
+			const answer = await requestJson(fetch, HOST_ROUTES.view, { headers: { accept: "application/json" } });
+			return answer.ok ? {
+				ok: true,
+				payload: answer.data
+			} : {
+				ok: false,
+				failure: answer.failure
+			};
+		}
+		async function rows(queue, cursor = 0) {
+			const url = HOST_ROUTES.rows + "?queue=" + encodeURIComponent(queue) + "&cursor=" + String(cursor);
+			const answer = await requestJson(fetch, url, { headers: { accept: "application/json" } });
+			return answer.ok ? {
+				ok: true,
+				payload: answer.data
+			} : {
+				ok: false,
+				failure: answer.failure
+			};
+		}
+		//#endregion
+		//#region src/client/seam.ts
+		const PANEL_ID = "merge";
+		//#endregion
+		//#region src/client/messages.ts
+		const NS = "evolution-merge";
+		const zh = {
+			"entry.label": "技能合并",
+			"hint": "手动触发；后台逐对判定。这里只读，不写技能。",
+			"tab.pending": "待批准",
+			"tab.retry": "待重跑",
+			"tab.skipped": "无需合并",
+			"empty.pending": "没有待批准的合并。",
+			"empty.retry": "没有待重跑的对。",
+			"empty.skipped": "没有标记为无需合并的对。",
+			"loading": "正在读取…",
+			"refresh": "刷新",
+			"failed": "读取失败，保留上次结果。",
+			"stage.decide": "判定",
+			"stage.author": "合并",
+			"stage.validate": "检查",
+			"stage.commit": "提交"
+		};
+		const en = {
+			"entry.label": "Skill merge",
+			"hint": "Manual only; pairs are judged in the background. Read-only here.",
+			"tab.pending": "Pending",
+			"tab.retry": "Retry",
+			"tab.skipped": "Skipped",
+			"empty.pending": "No pending merges.",
+			"empty.retry": "No pairs waiting to retry.",
+			"empty.skipped": "No pairs marked as not worth merging.",
+			"loading": "Loading…",
+			"refresh": "Refresh",
+			"failed": "Read failed; keeping the last result.",
+			"stage.decide": "Decide",
+			"stage.author": "Author",
+			"stage.validate": "Validate",
+			"stage.commit": "Commit"
+		};
+		//#endregion
+		//#region src/client/styles.ts
+		const CSS_TAG_ID = "evolution-merge-panel";
+		const CSS = [
+			".evolution-merge-panel { display:flex; flex-direction:column; gap:var(--evo-space-12); padding:var(--evo-space-16); }",
+			".evolution-merge-panel [data-role=\"hint\"] { margin:0; color:var(--dsw-alias-label-tertiary); font-size:var(--evo-type-xs); }",
+			".evolution-merge-panel [data-role=\"stats\"] { display:flex; gap:var(--evo-space-8); flex-wrap:wrap; }",
+			".evolution-merge-panel [data-role=\"stat\"] { border:var(--evo-hairline-width) solid var(--dsw-alias-border-l2); border-radius:var(--evo-radius-control); padding:var(--evo-space-6) var(--evo-space-10); min-width:calc(var(--evo-space-16) * 4); }",
+			".evolution-merge-panel [data-role=\"stat-value\"] { font-size:var(--evo-type-lg); font-weight:600; }",
+			".evolution-merge-panel [data-role=\"stat-label\"] { font-size:var(--evo-type-xs); color:var(--dsw-alias-label-tertiary); }",
+			".evolution-merge-panel [data-role=\"tabs\"] { display:flex; gap:var(--evo-space-6); border-bottom:var(--evo-hairline-width) solid var(--dsw-alias-border-l2); }",
+			".evolution-merge-panel [data-role=\"tab\"] { background:none; border:0; border-bottom:var(--evo-hairline-width) solid transparent; padding:var(--evo-space-6) var(--evo-space-8); cursor:pointer; color:inherit; }",
+			".evolution-merge-panel [data-role=\"tab\"][data-active=\"true\"] { border-bottom-color:var(--dsw-alias-brand-primary); }",
+			".evolution-merge-panel [data-role=\"rows\"] { display:flex; flex-direction:column; gap:var(--evo-space-6); }",
+			".evolution-merge-panel [data-role=\"row\"] { display:grid; grid-template-columns:1fr auto; gap:var(--evo-space-8); padding:var(--evo-space-8); border:var(--evo-hairline-width) solid var(--dsw-alias-border-l2); border-radius:var(--evo-radius-control); }",
+			".evolution-merge-panel [data-role=\"row-label\"] { font-weight:600; }",
+			".evolution-merge-panel [data-role=\"row-meta\"] { color:var(--dsw-alias-label-tertiary); font-size:var(--evo-type-xs); }",
+			".evolution-merge-panel [data-role=\"note\"] { color:var(--dsw-alias-label-tertiary); font-size:var(--evo-type-xs); }",
+			".evolution-merge-panel [data-role=\"refresh\"] { align-self:flex-start; }"
+		].join("\n");
+		//#endregion
+		//#region src/client/states.generated.ts
+		/** A neutral/ warn/ fail block; a fail block is role=alert so assistive tech announces it. */
+		function Block(props) {
+			const tone = props.tone ?? "neutral";
+			return (0, react.createElement)("div", {
+				"data-tone": tone,
+				...tone === "fail" ? { role: "alert" } : {}
+			}, props.title === void 0 ? null : (0, react.createElement)("div", { "data-tone-title": tone }, props.title), props.children);
+		}
+		/** One classified failure as a reader-facing sentence. */
+		function failureText(failure, t) {
+			switch (failure.kind) {
+				case "unauthenticated": return t("failureUnauthorized");
+				case "forbidden": return t("failureForbidden");
+				case "unmounted": return t("failureUnmounted");
+				case "server": return failure.status === 0 ? t("failureServer") : t("failureServer") + " (HTTP " + String(failure.status) + ")";
+				case "refused": return failure.message;
+			}
+		}
+		/** The failed-state block: sentence + (when the surface exists but is unreachable) the command fallback. */
+		function FailureBlock(props) {
+			const hint = props.fallback === void 0 ? null : (0, react.createElement)("div", { "data-tone-hint": "true" }, props.t("fallbackHint", { command: props.fallback.command }));
+			return Block({
+				tone: "fail",
+				title: failureText(props.failure, props.t),
+				children: hint
+			});
+		}
+		//#endregion
+		//#region src/client/fallbacks.generated.ts
+		/**
+		* The command-face fallback for every Host surface, generated from evolution-commands'
+		* COMMAND_FALLBACKS (the ONE home). When the platform's connection carrier is absent (E-325) the
+		* panels render this hint instead of a bare HTTP failure — same use case, command face.
+		*/
+		const FALLBACKS = {
+			approval: { command: "/evolution pending … /evolution approve <id> … /evolution reject <id> … /evolution release <id>" },
+			"skill-history": { command: "/evolution restore <name> [v]（查看：/evolution skills history <name>）" },
+			"skill-health": { command: "/evolution skills refresh（健康行：/evolution doctor）" },
+			merge: { command: "/evolution merge status / pending / approve <id> / report" },
+			diagnostics: {
+				command: "/evolution doctor",
+				platformCli: "dsh --json /evolution doctor"
+			}
+		};
+		//#endregion
+		//#region src/client/Panel.ts
+		/**
+		* The merge panel body: three queues, counts, and a read-only row list. Actions are
+		* intentionally copied commands, not buttons that write from the browser.
+		*/
+		const QUEUES = [
+			"pending",
+			"retry",
+			"skipped"
+		];
+		function failure(t, failure) {
+			return FailureBlock({
+				failure,
+				t,
+				fallback: FALLBACKS["merge"]
+			});
+		}
+		function MergePanel(face) {
+			const t = face.t;
+			const [view, setView] = (0, react.useState)(face.view);
+			const [tab, setTab] = (0, react.useState)("pending");
+			const [rows, setRows] = (0, react.useState)(face.rows);
+			const [loading, setLoading] = (0, react.useState)(false);
+			const [failed, setFailed] = (0, react.useState)(void 0);
+			const loadRows = (queue) => {
+				const load = face.loadRows;
+				if (load === void 0) return;
+				setLoading(true);
+				load(queue).then((outcome) => {
+					if (outcome.ok) {
+						setRows(outcome.payload.items);
+						setFailed(void 0);
+					} else setFailed(outcome.failure);
+				}).catch(() => {
+					setFailed({
+						kind: "server",
+						status: 0
+					});
+				}).finally(() => {
+					setLoading(false);
+				});
+			};
+			const loadView = () => {
+				const load = face.loadView;
+				if (load === void 0) return;
+				load().then((outcome) => {
+					if (outcome.ok) setView(outcome.payload);
+				}).catch(() => {});
+			};
+			(0, react.useEffect)(() => {
+				loadView();
+				loadRows("pending");
+			}, [face]);
+			(0, react.useEffect)(() => {
+				loadRows(tab);
+			}, [tab]);
+			const counts = view.counts;
+			const stats = (0, react.createElement)("div", { "data-role": "stats" }, QUEUES.map((queue) => (0, react.createElement)("div", {
+				key: queue,
+				"data-role": "stat",
+				"data-queue": queue
+			}, (0, react.createElement)("div", { "data-role": "stat-value" }, String(counts[queue])), (0, react.createElement)("div", { "data-role": "stat-label" }, t("tab." + queue)))));
+			const tabs = (0, react.createElement)("div", { "data-role": "tabs" }, QUEUES.map((queue) => (0, react.createElement)("button", {
+				key: queue,
+				type: "button",
+				"data-role": "tab",
+				"data-active": tab === queue ? "true" : "false",
+				onClick: () => {
+					setTab(queue);
+				}
+			}, t("tab." + queue) + " " + String(counts[queue]))));
+			const list = rows.length === 0 ? (0, react.createElement)("p", { "data-role": "note" }, t("empty." + tab)) : (0, react.createElement)("div", { "data-role": "rows" }, rows.map((row) => (0, react.createElement)("div", {
+				key: row.id,
+				"data-role": "row"
+			}, (0, react.createElement)("div", null, (0, react.createElement)("div", { "data-role": "row-label" }, row.label), (0, react.createElement)("div", { "data-role": "row-meta" }, row.state + (row.stage === null ? "" : " · " + t("stage." + row.stage)))), (0, react.createElement)("div", { "data-role": "row-meta" }, row.updatedAt))));
+			return (0, react.createElement)("section", { className: CSS_TAG_ID }, (0, react.createElement)("p", { "data-role": "hint" }, t("hint")), stats, tabs, loading ? (0, react.createElement)("p", { "data-role": "note" }, t("loading")) : null, failed === void 0 ? null : (0, react.createElement)("div", { "data-role": "note" }, failure(t, failed)), list, (0, react.createElement)("button", {
+				type: "button",
+				"data-role": "refresh",
+				onClick: () => {
+					loadView();
+					loadRows(tab);
+				}
+			}, t("refresh")));
+		}
+		//#endregion
+		//#region src/client/index.ts
+		const inject = ["slots", "locale"];
+		function PanelIcon(props = {}) {
+			const size = typeof props.size === "number" && props.size > 0 ? props.size : 16;
+			return (0, react.createElement)("svg", {
+				"aria-hidden": "true",
+				width: String(size),
+				height: String(size),
+				viewBox: "0 0 16 16",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: "1.5",
+				strokeLinecap: "round",
+				strokeLinejoin: "round"
+			}, (0, react.createElement)("path", { d: "M3 4h10M3 8h6M3 12h8" }));
+		}
+		function seedView() {
+			return {
+				counts: {
+					pending: 0,
+					retry: 0,
+					skipped: 0
+				},
+				tabs: [
+					{
+						queue: "pending",
+						count: 0
+					},
+					{
+						queue: "retry",
+						count: 0
+					},
+					{
+						queue: "skipped",
+						count: 0
+					}
+				],
+				commands: []
+			};
+		}
+		function apply(ctx) {
+			const seam = ctx;
+			let registered = false;
+			ctx.effect(() => {
+				try {
+					const dispose = seam.locale.register(NS, {
+						zh,
+						en
+					});
+					registered = true;
+					return dispose;
+				} catch (error) {
+					ctx.logger.warn("evolution-merge-ui: locale seat refused \"evolution-merge\" (" + String(error) + ")");
+					return () => {};
+				}
+			}, "evolution-merge-ui: locale");
+			ctx.effect(() => {
+				if (document.querySelector("style[data-plugin-css=\"evolution-merge-panel\"]") !== null) return () => {};
+				const tag = document.createElement("style");
+				tag.setAttribute("data-plugin-css", CSS_TAG_ID);
+				tag.textContent = CSS;
+				document.head.append(tag);
+				return () => {
+					tag.remove();
+				};
+			}, "evolution-merge-ui: styles");
+			const t = (key) => {
+				const fallback = zh[key] ?? key;
+				if (!registered) return fallback;
+				try {
+					return seam.locale.bind(NS)(key);
+				} catch {
+					return fallback;
+				}
+			};
+			const label = () => t("entry.label");
+			seam.slots.inject("sidebar.panellist", function* () {
+				yield seam.slots.register({
+					name: "sidebar.panellist",
+					id: PANEL_ID,
+					order: 45,
+					label
+				}, PanelIcon);
+				yield seam.slots.register({
+					name: "main",
+					key: PANEL_ID,
+					inject: () => ({
+						view: seedView(),
+						rows: [],
+						loadView: view,
+						loadRows: rows,
+						t
+					})
+				}, MergePanel);
+			});
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* Host half of the merge UI package: it registers nothing. The Loader discovers the
+* `dsh.client` manifest and serves `./client` to the page; this entry exists so the row
+* is a valid plugin.
+*/
+const name = "evolution-merge-ui";
+const inject = [];
+function apply() {}
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,15 @@
+/**
+ * The merge panel body: three queues, counts, and a read-only row list. Actions are
+ * intentionally copied commands, not buttons that write from the browser.
+ */
+import { type ReactNode } from 'react';
+import type { MergeOutcome, MergeQueue, MergeRowView, MergeViewPayload, QueuePage } from './api.ts';
+export interface MergeFace {
+    view: MergeViewPayload;
+    rows: MergeRowView[];
+    loadView?: () => Promise<MergeOutcome<MergeViewPayload>>;
+    loadRows?: (queue: MergeQueue, cursor?: number) => Promise<MergeOutcome<QueuePage>>;
+    t: (key: string) => string;
+}
+export declare function MergePanel(face: MergeFace): ReactNode;
+//# sourceMappingURL=Panel.d.ts.map

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

@@ -0,0 +1,47 @@
+import { type RouteFailure } from './route-client.generated.ts';
+export declare const HOST_ROUTES: {
+    readonly view: "/api/dsh-evolution/merge/view";
+    readonly rows: "/api/dsh-evolution/merge/rows";
+    readonly run: "/api/dsh-evolution/merge/run";
+    readonly runs: "/api/dsh-evolution/merge/runs";
+};
+export type MergeQueue = 'pending' | 'retry' | 'skipped';
+export interface MergeCounts {
+    pending: number;
+    retry: number;
+    skipped: number;
+}
+export interface MergeViewPayload {
+    counts: MergeCounts;
+    tabs: {
+        queue: MergeQueue;
+        count: number;
+    }[];
+    commands: string[];
+}
+export interface MergeRowView {
+    id: string;
+    pairKey: string;
+    a: string;
+    b: string;
+    state: string;
+    queue: MergeQueue;
+    stage: string | null;
+    label: string;
+    updatedAt: string;
+}
+export interface QueuePage {
+    queue: MergeQueue;
+    items: MergeRowView[];
+    nextCursor?: string;
+}
+export type MergeOutcome<T> = {
+    ok: true;
+    payload: T;
+} | {
+    ok: false;
+    failure: RouteFailure;
+};
+export declare function view(): Promise<MergeOutcome<MergeViewPayload>>;
+export declare function rows(queue: MergeQueue, cursor?: number): Promise<MergeOutcome<QueuePage>>;
+//# sourceMappingURL=api.d.ts.map

package/lib/types/client/contracts.generated.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Literal mirror of the frozen Host diagnostics contract (W1 §2.8 / core diagnostics.ts). The browser
+ * build keeps every @deepseek-ai/* specifier external, so the client CANNOT import the host type — the
+ * shape is mirrored mechanically here instead. The key unions are rendered from core diagnostics.ts by
+ * the generator, so a key change regenerates all three copies (a stale copy fails --check).
+ */
+export type DiagnosticsSchemaVersion = 2;
+export type DiagnosticsFactKey = 'platform-line' | 'family-version' | 'install-form' | 'preset-ids' | 'readonly-contract' | 'upgrade-order' | 'fallback-map';
+export type DiagnosticsRuntimeKey = 'subagent-channel' | 'restricted-preset' | 'host-surface' | 'session-fold' | 'platform-services' | 'runs' | 'platform-pairing' | 'install-form-detected';
+export type DiagnosticStatus = 'ok' | 'warn' | 'fail' | 'unknown';
+export interface DocFactRow {
+    readonly key: DiagnosticsFactKey;
+    readonly label: string;
+    readonly value: string;
+    readonly home: string;
+}
+export interface DiagnosticRow {
+    readonly key: DiagnosticsRuntimeKey;
+    readonly label: string;
+    readonly status: DiagnosticStatus;
+    readonly detail?: string;
+    readonly remedy?: string;
+}
+export interface DiagnosticsView {
+    readonly schemaVersion: DiagnosticsSchemaVersion;
+    readonly generatedAt: string;
+    readonly facts: readonly DocFactRow[];
+    readonly runtime: readonly DiagnosticRow[];
+}
+/** The installation form the doctor reports (W8 install-form-detected row). */
+export type InstallFormId = 'M1' | 'M2' | 'M3' | 'M4';
+/** One surface's command-face path(s) — the client `fallbacks.generated.ts` table's row type. */
+export interface FallbackHint {
+    readonly command: string;
+    readonly platformCli?: string;
+}
+//# sourceMappingURL=contracts.generated.d.ts.map

package/lib/types/client/fallbacks.generated.d.ts

@@ -0,0 +1,8 @@
+import type { FallbackHint } from './contracts.generated.ts';
+/**
+ * The command-face fallback for every Host surface, generated from evolution-commands'
+ * COMMAND_FALLBACKS (the ONE home). When the platform's connection carrier is absent (E-325) the
+ * panels render this hint instead of a bare HTTP failure — same use case, command face.
+ */
+export declare const FALLBACKS: Readonly<Record<'approval' | 'skill-history' | 'skill-health' | 'merge' | 'diagnostics', FallbackHint>>;
+//# sourceMappingURL=fallbacks.generated.d.ts.map

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

@@ -0,0 +1,8 @@
+/**
+ * Browser half: one sidebar row ("技能合并") and the read-only main body it opens.
+ * All facts arrive through the generated routes; the bundle holds no service and writes nothing.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+export declare const inject: string[];
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,4 @@
+export declare const NS = "evolution-merge";
+export declare const zh: Record<string, string>;
+export declare const en: Record<string, string>;
+//# sourceMappingURL=messages.d.ts.map

package/lib/types/client/route-client.generated.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The four-state transport classifier every family client shares (W7 §2). The platform owns
+ * admission (401/403/404 are its answers, not ours), so the client reads the STATUS only for those
+ * three and never tries to interpret a platform body. Everything the family route itself answers
+ * keeps its business envelope: 2xx + {ok:true,data} or 2xx + {ok:false,code,message}.
+ */
+export type RouteFailure = {
+    readonly kind: 'unauthenticated';
+    readonly status: 401;
+} | {
+    readonly kind: 'forbidden';
+    readonly status: 403;
+} | {
+    readonly kind: 'unmounted';
+    readonly status: 404;
+} | {
+    readonly kind: 'server';
+    readonly status: number;
+    readonly detail?: string;
+} | {
+    readonly kind: 'refused';
+    readonly code: string;
+    readonly message: string;
+};
+/** One route answer: the data, or the classified failure. */
+export type RouteAnswer<T> = {
+    readonly ok: true;
+    readonly data: T;
+} | {
+    readonly ok: false;
+    readonly failure: RouteFailure;
+};
+/** Classify a non-2xx status: 401/403/404 keep their own kind, everything else is a server answer. */
+export declare function classify(status: number): RouteFailure;
+/**
+ * One request, no retries and no body parsing for the platform's admission answers.
+ * @param doFetch - the fetch in use (the browser's, or a spec's stub).
+ * @param path - the exact route path from the generated ROUTES table.
+ * @param init - standard RequestInit.
+ * @returns the data, or the classified failure (network/parse failures read as 'server').
+ */
+export declare function requestJson<T>(doFetch: typeof fetch, path: string, init?: RequestInit): Promise<RouteAnswer<T>>;
+/** The one-sentence rendering legacy callers attach to a classified failure. */
+export declare function failureMessage(failure: RouteFailure): string;
+//# sourceMappingURL=route-client.generated.d.ts.map

package/lib/types/client/routes.generated.d.ts

@@ -0,0 +1,37 @@
+/** One host data-plane surface the browser half can call. */
+export type SurfaceId = 'approval' | 'skill-history' | 'skill-health' | 'merge' | 'diagnostics';
+/**
+ * Every family host path, generated from evolution-core's HOST_ROUTES (the ONE declaration).
+ * A browser half cannot import the host package at runtime (client bundles keep @deepseek-ai/*
+ * external), so the table is mirrored here mechanically; a rename in core regenerates all three
+ * client copies, and the generator's --check makes a stale copy red.
+ */
+export declare const ROUTES: {
+    readonly approval: {
+        readonly pending: "/api/dsh-evolution/approval/pending";
+        readonly preview: "/api/dsh-evolution/approval/preview";
+        readonly approve: "/api/dsh-evolution/approval/approve";
+        readonly reject: "/api/dsh-evolution/approval/reject";
+    };
+    readonly 'skill-history': {
+        readonly skills: "/api/dsh-evolution/skill-history/skills";
+        readonly versions: "/api/dsh-evolution/skill-history/versions";
+        readonly diff: "/api/dsh-evolution/skill-history/versions/diff";
+        readonly body: "/api/dsh-evolution/skill-history/versions/body";
+        readonly undo: "/api/dsh-evolution/skill-history/undo";
+        readonly health: "/api/dsh-evolution/skill-history/health";
+    };
+    readonly 'skill-health': {
+        readonly rows: "/api/dsh-evolution/skill-health/rows";
+    };
+    readonly merge: {
+        readonly view: "/api/dsh-evolution/merge/view";
+        readonly rows: "/api/dsh-evolution/merge/rows";
+        readonly run: "/api/dsh-evolution/merge/run";
+        readonly runs: "/api/dsh-evolution/merge/runs";
+    };
+    readonly diagnostics: {
+        readonly view: "/api/dsh-evolution/diagnostics";
+    };
+};
+//# sourceMappingURL=routes.generated.d.ts.map

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

@@ -0,0 +1,34 @@
+/**
+ * Structural view of the client seams this bundle consumes. The package ships outside the
+ * platform repository, so it declares the seats instead of importing platform client sources.
+ */
+import type { ReactNode } from 'react';
+export declare const PANEL_ID = "merge";
+export declare const PANEL_ORDER = 45;
+export interface PanelRowOptions {
+    name: 'sidebar.panellist';
+    id: string;
+    order: number;
+    label: () => string;
+}
+export interface PanelBodyOptions {
+    name: 'main';
+    key: string;
+    inject: () => unknown;
+}
+export interface LocaleSeat {
+    register(namespace: string, dictionaries: {
+        zh: Record<string, string>;
+        en: Record<string, string>;
+    }): () => void;
+    bind(namespace: string): (key: string) => string;
+}
+export interface SlotsSeat {
+    inject(name: string, body: () => Generator<() => void, void, void>): void;
+    register(options: PanelRowOptions | PanelBodyOptions, component: (props: never) => ReactNode): () => void;
+}
+export interface ClientSeam {
+    slots: SlotsSeat;
+    locale: LocaleSeat;
+}
+//# sourceMappingURL=seam.d.ts.map

package/lib/types/client/states.generated.d.ts

@@ -0,0 +1,43 @@
+import { type ReactNode } from 'react';
+import type { RouteAnswer, RouteFailure } from './route-client.generated.ts';
+import type { FallbackHint } from './contracts.generated.ts';
+/**
+ * The four-state base of every family card (W7 §2). Load states are read from the generated
+ * route-client's answer — a card owns no HTTP vocabulary and no second state machine.
+ */
+export type LoadState<T> = {
+    readonly phase: 'loading';
+} | {
+    readonly phase: 'ready';
+    readonly data: T;
+} | {
+    readonly phase: 'empty';
+} | {
+    readonly phase: 'failed';
+    readonly failure: RouteFailure;
+};
+/** Map one classified answer onto the card's four states. */
+export declare function loadStateOf<T>(answer: RouteAnswer<T>, isEmpty: (data: T) => boolean): LoadState<T>;
+/** The locale lookup every block calls (the platform's own `t`). */
+export interface Translate {
+    (key: string, values?: Readonly<Record<string, string | number>>): string;
+}
+export type BlockTone = 'neutral' | 'warn' | 'fail';
+export interface BlockProps {
+    readonly tone?: BlockTone;
+    readonly title?: string;
+    readonly children?: ReactNode;
+}
+/** A neutral/ warn/ fail block; a fail block is role=alert so assistive tech announces it. */
+export declare function Block(props: BlockProps): ReactNode;
+export interface FailureBlockProps {
+    readonly failure: RouteFailure;
+    readonly t: Translate;
+    /** The command-face fallback for this surface (rendered on unmounted/failed answers). */
+    readonly fallback?: FallbackHint | undefined;
+}
+/** One classified failure as a reader-facing sentence. */
+export declare function failureText(failure: RouteFailure, t: Translate): string;
+/** The failed-state block: sentence + (when the surface exists but is unreachable) the command fallback. */
+export declare function FailureBlock(props: FailureBlockProps): ReactNode;
+//# sourceMappingURL=states.generated.d.ts.map

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

@@ -0,0 +1,3 @@
+export declare const CSS_TAG_ID = "evolution-merge-panel";
+export declare const CSS: string;
+//# sourceMappingURL=styles.d.ts.map

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

@@ -0,0 +1,25 @@
+/**
+ * The family client scale - GENERATED from packages/scripts/client-tokens.json. Do not edit.
+ *
+ * Both browser halves of the family carry this file with identical bytes, because the scale is one
+ * fact: `verify-client-tokens.mjs` (a gate step) fails when either copy drifts from the source. The
+ * scale cannot be shared at runtime - a browser half may not import evolution-core, since every
+ * `@deepseek-ai/*` specifier stays external in the client build and the platform module table has no
+ * row for it - so the values are generated into each package instead.
+ *
+ * Usage: put `tokenVars(...)` for your root class in the package stylesheet, then read
+ * `var(--evo-group-name)` in its rules.
+ * Regenerate with: node packages/scripts/gen-client-tokens.mjs packages
+ * @module @deepseek-ai/dsh-evolution-client-scale
+ */
+/** Every custom property of the scale, in the source order. */
+export declare const TOKENS: Readonly<Record<string, string>>;
+/** The declarations, without a selector. */
+export declare const TOKEN_CSS: string;
+/**
+ * The scale, declared on one element so it never leaks into the host shell.
+ * @param scope - the selector the custom properties are declared on.
+ * @returns the declaration block to put in the stylesheet.
+ */
+export declare function tokenVars(scope: string): string;
+//# sourceMappingURL=tokens.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Host half of the merge UI package: it registers nothing. The Loader discovers the
+ * `dsh.client` manifest and serves `./client` to the page; this entry exists so the row
+ * is a valid plugin.
+ */
+export declare const name = "evolution-merge-ui";
+export declare const inject: string[];
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@lmzhen/dsh-evolution-merge-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "Web surface for skill merge: pending, retry and skipped queues (community build)",
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "version": "0.28.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lmzhen/dsh-evolution.git",
+    "directory": "packages/evolution-merge-ui"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/*.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "engines": {
+    "dsh": ">=0.2.1-rc.1 <0.2.2-0"
+  }
+}