@lmzhen/dsh-evolution-commands 0.27.0 → 0.27.2

package/lib/index.js

@@ -50,30 +50,48 @@ const FACT_LABELS = {
 	"platform-line": "平台兼容线",
 	"family-version": "家族版本",
 	"install-form": "安装形态",
-	"preset-ids": "受限 preset id",
-	"readonly-contract": "只读契约",
+	"preset-ids": "受限预设",
+	"readonly-contract": "只读说明",
 	"upgrade-order": "升级顺序",
 	"fallback-map": "命令兜底"
 };
 const RUNTIME_LABELS = {
 	"subagent-channel": "子代理通道",
-	"restricted-preset": "受限 preset",
-	"host-surface": "Host 数据面",
-	"session-fold": "会话事件 fold 单入口",
-	"platform-services": "平台服务探测",
+	"restricted-preset": "受限预设",
+	"host-surface": "数据面连接",
+	"session-fold": "会话事件读取",
+	"platform-services": "平台服务",
 	runs: "运行登记",
-	"platform-pairing": "平台/家族配对",
+	"platform-pairing": "版本兼容",
 	"install-form-detected": "实际安装形态"
 };
+/**
+* The install form in reader-facing words. The M1..M4 ids stay internal (the runtime rows and
+* --json keep them); a settings reader sees what the deployment is FOR, not the code name.
+*/
+const FORM_WORDS = Object.freeze({
+	M1: "完整功能包",
+	M2: "后台自动化包",
+	M3: "会话预设包",
+	M4: "分层安装"
+});
+/**
+* Build the seven documentation facts. Values are READER-FACING prose: the CLI text, --json and
+* the settings card all print the same strings, so internal codes, raw evidence paths and
+* "declared/inferred" jargon stay out of the value (the runtime rows and the per-fact home carry
+* the technical half).
+* @param inputs - assembled doctor inputs.
+* @returns the ordered fact rows.
+*/
 function factsOf(inputs) {
 	const values = {
-		"platform-line": inputs.platformLine.version + "（floor " + inputs.platformLine.floor + "）",
+		"platform-line": inputs.platformLine.version + "（最低兼容 " + inputs.platformLine.floor + "）",
 		"family-version": inputs.familyVersion,
-		"install-form": inputs.form.id + "（" + inputs.form.confidence + "；证据：" + inputs.form.evidence.join("、") + "）",
-		"preset-ids": REVIEWER_PRESET_ID + " / " + MAINTAINER_PRESET_ID + "（家族 preset 集合：" + EVOLUTION_PRESET_IDS.join(", ") + "）",
-		"readonly-contract": REVIEWER_PRESET_ID + " 的工具集由 restrictor allow 集合决定；维护行同构（" + MAINTAINER_PRESET_ID + "）",
-		"upgrade-order": "先升平台 → 再升家族 → 最后发布（见 INSTALL runbook）",
-		"fallback-map": Object.keys(COMMAND_FALLBACKS).join("、") + "（每面的命令见 INSTALL 命令兜底表）"
+		"install-form": FORM_WORDS[inputs.form.id] + "（" + (inputs.form.confidence === "declared" ? "安装内容已声明" : "按已安装内容推断") + "）",
+		"preset-ids": "审阅 / 维护两个受限只读预设（" + REVIEWER_PRESET_ID + " / " + MAINTAINER_PRESET_ID + "）；另可选用 " + String(EVOLUTION_PRESET_IDS.length) + " 个基础预设",
+		"readonly-contract": "受限预设只读：可用工具由该预设声明的 allow 集合决定（审阅与维护同构）",
+		"upgrade-order": "先升平台，再升家族，最后发布（详见 INSTALL 的升级说明）",
+		"fallback-map": String(Object.keys(COMMAND_FALLBACKS).length) + " 个功能面板各有命令兜底（详见 INSTALL 命令兜底表）"
 	};
 	return DIAGNOSTICS_FACT_KEYS.map((key) => ({
 		key,
@@ -88,7 +106,7 @@ function channelRow(channels) {
 		key: "subagent-channel",
 		label: RUNTIME_LABELS["subagent-channel"] ?? "子代理通道",
 		status: "ok",
-		detail: "reviewer/maintainer 通道均可用（spawn provider + agentPreset 能力）"
+		detail: "审阅与维护两条子代理通道均可用。"
 	};
 	const reasons = unavailable.map((state) => state.code + ": " + state.reason);
 	return {
@@ -115,14 +133,14 @@ function presetRow(presets) {
 		label: RUNTIME_LABELS["restricted-preset"] ?? "受限 preset",
 		status: "fail",
 		detail: errorText("e-324-restricted-preset-unavailable", { a1: broken.map((entry) => entry.broken ?? "").join("；") }),
-		remedy: "重载插件行使 ensureRestrictedPreset 重新注册；运行 /evolution doctor 查看 preset id 与 allow 集合。"
+		remedy: "重新加载家族插件；若仍失败，运行 /evolution doctor 查看详情。"
 	};
 	if (missing.length > 0) return {
 		key: "restricted-preset",
 		label: RUNTIME_LABELS["restricted-preset"] ?? "受限 preset",
 		status: "warn",
-		detail: "受限 preset 尚未注册（首次显式子代理运行时创建）。",
-		remedy: "运行一次审阅/维护，或在挂载后运行 /evolution doctor。"
+		detail: "受限的只读模式尚未初始化（首次使用审阅或维护时自动创建）。",
+		remedy: "运行一次审阅或维护，或稍后重新检查。"
 	};
 	return {
 		key: "restricted-preset",
@@ -193,13 +211,13 @@ function runtimeOf(inputs) {
 			key: "session-fold",
 			label: RUNTIME_LABELS["session-fold"] ?? "会话事件 fold 单入口",
 			status: "ok",
-			detail: "classifySessionEvent/isIgnorableEvent 存在：model 消费，plugin-record/unknown 忽略。"
+			detail: "事件读取通道正常：对话内容会被读取，其余记录忽略。"
 		} : {
 			key: "session-fold",
 			label: RUNTIME_LABELS["session-fold"] ?? "会话事件 fold 单入口",
 			status: "fail",
-			detail: "分类器缺失，无法证明单一 fold 入口。",
-			remedy: "升级家族（classifySessionEvent 是 core 根导出）。"
+			detail: "事件读取组件缺失，无法确认读取通道正常。",
+			remedy: "重新安装完整功能包（evolution-all）。"
 		},
 		missing.length === 0 ? {
 			key: "platform-services",
@@ -230,12 +248,12 @@ function runtimeOf(inputs) {
 			key: "install-form-detected",
 			label: RUNTIME_LABELS["install-form-detected"] ?? "实际安装形态",
 			status: "ok",
-			detail: inputs.form.id + "（声明）"
+			detail: FORM_WORDS[inputs.form.id] + "（已声明）"
 		} : {
 			key: "install-form-detected",
 			label: RUNTIME_LABELS["install-form-detected"] ?? "实际安装形态",
 			status: "warn",
-			detail: inputs.form.id + "（推断：" + inputs.form.evidence.join("、") + "）",
+			detail: FORM_WORDS[inputs.form.id] + "（按已安装内容推断：" + inputs.form.evidence.join("、") + "）",
 			remedy: "在 profile 里显式声明安装行，核对 INSTALL 的形态表。"
 		}
 	].sort((a, b) => a.key.localeCompare(b.key));
@@ -1602,40 +1620,53 @@ function legacyLine(row) {
 	const more = row.pending.length > 6 ? ` (+${row.pending.length - 6} more)` : "";
 	return `legacy settings: ${row.pending.length} family value(s) still on ${row.source ?? "(unknown)"}: ${shown}${more} — /evolution migrate moves them`;
 }
+/**
+* W8-S7: the doctor's text face, VIEW-FIRST.
+*
+* The frozen DiagnosticsView (7 facts + 8 runtime rows) is the single text source for everything
+* it carries — install form, platform services, runs, channel/preset/host/pairing. The legacy
+* report now contributes only the facts the view does not represent yet: cross-profile bundles,
+* the family service inference, capability absence, the scoped-row probe, the legacy settings
+* document, pending/executing audit records, preset freshness, and the conflict/env/budget/
+* parameter/session-search findings + next steps. This is the W8-S7 rewrite branch: the text face
+* has real consumers (the `/evolution doctor` command, README/INSTALL, doctor.spec), so the legacy
+* rendering was rewritten instead of deleted — but every fact the view owns renders from the view
+* exactly once (the legacy install-form line is gone).
+* @param report - the assembled report (view + legacy findings).
+* @returns the text face.
+*/
 function renderDoctorText(report) {
-	const lines = [
-		`Evolution doctor — install form: ${report.installForm} (deployment: ${report.deploymentForm}; from ${report.formSource === "platform" ? "this runtime's bundle surface" : "the cross-profile aggregate"})`,
-		report.runtimeBundles === null ? "runtime bundles: unknown — the platform bundle surface (pluginManager.listBundles) is not mounted here" : `runtime bundles (this profile): ${report.runtimeBundles.length > 0 ? report.runtimeBundles.join(", ") : "(none)"}`,
-		report.dormantBundles.length === 0 ? null : `installed but not selected: ${report.dormantBundles.join(", ")} — the Plugins page lists them; this runtime mounts neither`,
-		`bundles (all profiles): ${report.bundles.length > 0 ? report.bundles.join(", ") : "(none)"}`,
-		`services: review=${report.services.review} (${report.serviceSource === "platform" ? "the live row, this runtime" : "inferred from bundles, all profiles"}) curator=${report.services.curator} approval=${report.services.approval} skillUsage=${report.services.skillUsage} io=${report.services.io}`,
-		report.capabilityAbsence.length === 0 ? null : `capability absence (${report.capabilityAbsence.length}): ${report.capabilityAbsence.map((entry) => `${entry.service} — ${entry.feature}`).join("; ")}`,
-		scopedProbeLine(report.scopedProbe),
-		legacyLine(report.legacy),
-		`pending: ${report.pendingCount === null ? "unknown" : report.pendingCount}`,
-		`executing: ${report.executingCount === null ? "unknown" : report.executingCount}`
-	];
+	const extras = [];
+	extras.push(report.runtimeBundles === null ? "runtime bundles: unknown — the platform bundle surface (pluginManager.listBundles) is not mounted here" : `runtime bundles (this profile): ${report.runtimeBundles.length > 0 ? report.runtimeBundles.join(", ") : "(none)"}`);
+	if (report.dormantBundles.length > 0) extras.push(`installed but not selected: ${report.dormantBundles.join(", ")} — the Plugins page lists them; this runtime mounts neither`);
+	extras.push(`bundles (all profiles): ${report.bundles.length > 0 ? report.bundles.join(", ") : "(none)"}`);
+	extras.push(`services: review=${report.services.review} (${report.serviceSource === "platform" ? "the live row, this runtime" : "inferred from bundles, all profiles"}) curator=${report.services.curator} approval=${report.services.approval} skillUsage=${report.services.skillUsage} io=${report.services.io}`);
+	if (report.capabilityAbsence.length > 0) extras.push(`capability absence (${report.capabilityAbsence.length}): ${report.capabilityAbsence.map((entry) => `${entry.service} — ${entry.feature}`).join("; ")}`);
+	extras.push(scopedProbeLine(report.scopedProbe));
+	extras.push(legacyLine(report.legacy));
+	extras.push(`pending: ${report.pendingCount === null ? "unknown" : report.pendingCount}`);
+	extras.push(`executing: ${report.executingCount === null ? "unknown" : report.executingCount}`);
 	for (const row of report.presetFreshness) {
 		if (row.status === "absent") continue;
 		const verdict = row.status === "fresh" ? "fresh — a fresh generation matches this file byte-for-byte" : row.status === "differs" ? "DIFFERS from a fresh generation — it is an install-time snapshot; re-run the installer (/evolution preset install) to regenerate" : `unknown — a fresh generation could not be recomputed (${row.detail ?? "reason not recorded"})`;
-		lines.push(`preset:   ${row.base} → ${row.destination}  ${verdict}`);
+		extras.push(`preset:   ${row.base} → ${row.destination}  ${verdict}`);
 	}
-	if (report.presetIssues.length > 0) lines.push("agent presets:", ...report.presetIssues.map((line) => `  ! ${line}`));
-	if (report.foreignProfiles.length > 0) lines.push("profiles-foreign: " + report.foreignProfiles.join(", ") + " — not part of this plane: /evolution preset install ignores them, while the bundles (all profiles) line above counts them");
-	if (report.conflicts.length > 0) lines.push("conflicts:", ...report.conflicts.map((line) => `  ! ${line}`));
-	if (report.envIssues.length > 0) lines.push("env:", ...report.envIssues.map((line) => `  ! ${line}`));
-	if (report.budgetIssues.length > 0) lines.push("memory budget:", ...report.budgetIssues.map((line) => `  ! ${line}`));
-	if (report.paramIssues.length > 0) lines.push("parameters:", ...report.paramIssues.map((line) => `  ! ${line}`));
-	if (report.queryIssues.length > 0) lines.push("session search:", ...report.queryIssues.map((line) => `  ! ${line}`));
-	if (report.actions.length > 0) lines.push("next steps:", ...report.actions.map((line) => `  → ${line}`));
-	return lines.filter((line) => line !== null).join("\n");
+	if (report.presetIssues.length > 0) extras.push("agent presets:", ...report.presetIssues.map((line) => `  ! ${line}`));
+	if (report.foreignProfiles.length > 0) extras.push("profiles-foreign: " + report.foreignProfiles.join(", ") + " — not part of this plane: /evolution preset install ignores them, while the bundles (all profiles) line above counts them");
+	if (report.conflicts.length > 0) extras.push("conflicts:", ...report.conflicts.map((line) => `  ! ${line}`));
+	if (report.envIssues.length > 0) extras.push("env:", ...report.envIssues.map((line) => `  ! ${line}`));
+	if (report.budgetIssues.length > 0) extras.push("memory budget:", ...report.budgetIssues.map((line) => `  ! ${line}`));
+	if (report.paramIssues.length > 0) extras.push("parameters:", ...report.paramIssues.map((line) => `  ! ${line}`));
+	if (report.queryIssues.length > 0) extras.push("session search:", ...report.queryIssues.map((line) => `  ! ${line}`));
+	if (report.actions.length > 0) extras.push("next steps:", ...report.actions.map((line) => `  → ${line}`));
+	return renderDiagnosticsText(report.view).trimEnd() + "\n\n补充检查（view 未覆盖的运行时事实）：\n" + extras.join("\n");
 }
 /**
 * G6/W8 tail: render the frozen DiagnosticsView as the doctor's diagnostics section.
 *
 * This is the ONE text face of the 7+8 rows: the same object `--json` and the diagnostics route
-* answer, so the three readers cannot disagree. Legacy install/conflict sections keep their own
-* renderer until the remaining W8-S7 rewrite lands.
+* answer, so the three readers cannot disagree. The legacy report only adds the facts this frozen
+* view does not carry yet (see renderDoctorText).
 * @param view - the assembled view.
 * @returns the section text (ends with a newline).
 */
@@ -3174,7 +3205,7 @@ function apply(ctx, rawConfig = {}) {
 					...mounted
 				});
 				if (input === "doctor --json") return ok(JSON.stringify(report.view, null, 2));
-				return ok(renderDoctorText(report) + "\n" + renderDiagnosticsText(report.view));
+				return ok(renderDoctorText(report));
 			}
 			if (input === "" || input === "help") return ok(`自进化：记忆、技能、会话回顾、技能整理——状态、待批准写入与维护。\n${renderHelpText()}`);
 			return err(`/evolution ${input} 不是本构建能应答的子命令（已知子命令但缺参数也会落到这里）。\n${renderHint()}`);

package/lib/types/doctor.d.ts

@@ -159,13 +159,28 @@ export declare function diagnose(ctx: {
     home?: string;
     mounted?: MountedProfile;
 }): Promise<DoctorReport>;
+/**
+ * W8-S7: the doctor's text face, VIEW-FIRST.
+ *
+ * The frozen DiagnosticsView (7 facts + 8 runtime rows) is the single text source for everything
+ * it carries — install form, platform services, runs, channel/preset/host/pairing. The legacy
+ * report now contributes only the facts the view does not represent yet: cross-profile bundles,
+ * the family service inference, capability absence, the scoped-row probe, the legacy settings
+ * document, pending/executing audit records, preset freshness, and the conflict/env/budget/
+ * parameter/session-search findings + next steps. This is the W8-S7 rewrite branch: the text face
+ * has real consumers (the `/evolution doctor` command, README/INSTALL, doctor.spec), so the legacy
+ * rendering was rewritten instead of deleted — but every fact the view owns renders from the view
+ * exactly once (the legacy install-form line is gone).
+ * @param report - the assembled report (view + legacy findings).
+ * @returns the text face.
+ */
 export declare function renderDoctorText(report: DoctorReport): string;
 /**
  * G6/W8 tail: render the frozen DiagnosticsView as the doctor's diagnostics section.
  *
  * This is the ONE text face of the 7+8 rows: the same object `--json` and the diagnostics route
- * answer, so the three readers cannot disagree. Legacy install/conflict sections keep their own
- * renderer until the remaining W8-S7 rewrite lands.
+ * answer, so the three readers cannot disagree. The legacy report only adds the facts this frozen
+ * view does not carry yet (see renderDoctorText).
  * @param view - the assembled view.
  * @returns the section text (ends with a newline).
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-commands",
   "description": "Human commands for the evolution family (/evolution pending|curator|maintain|doctor) (community build)",
-  "version": "0.27.0",
+  "version": "0.27.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,12 +27,12 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.5",
-    "@lmzhen/dsh-evolution-approval": "^0.27.0",
-    "@lmzhen/dsh-evolution-core": "^0.27.0",
-    "@lmzhen/dsh-evolution-maintenance": "^0.27.0"
+    "@lmzhen/dsh-evolution-approval": "^0.27.2",
+    "@lmzhen/dsh-evolution-core": "^0.27.2",
+    "@lmzhen/dsh-evolution-maintenance": "^0.27.2"
   },
   "optionalDependencies": {
-    "@lmzhen/dsh-evolution-agent-preset": "^0.27.0"
+    "@lmzhen/dsh-evolution-agent-preset": "^0.27.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",