@lmzhen/dsh-evolution-commands 0.8.0 → 0.10.0

package/lib/index.js

@@ -2,7 +2,7 @@ import { createRequire } from "node:module";
 import z from "@deepseek-ai/schemastery";
 import { effectiveSessionPolicy } from "@lmzhen/dsh-evolution-approval";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
-import { DEFAULT_SKILL_LIMITS, MAX_TIMER_DELAY_MS, PARAM_EXPOSURE, PARAM_NAMESPACES, appendEvolutionEvent, assertSkillsRootAliasRetired, buildLearnPrompt, canonicalWriteId, clampedNumber, composePresetComposition, errorText, eventsFile, evolutionRoot, isDeprecatedParamId, isMissingPath, newSkillLibrary, policyStageLimits, resolveParamId, resolveRootConfig, scopedProbeReport } from "@lmzhen/dsh-evolution-core";
+import { DEFAULT_SKILL_LIMITS, MAX_TIMER_DELAY_MS, PARAM_EXPOSURE, PARAM_GROUP_LABELS, PARAM_NAMESPACES, appendEvolutionEvent, assertSkillsRootAliasRetired, buildLearnPrompt, canonicalWriteId, clampedNumber, composePresetComposition, errorText, eventsFile, evolutionRoot, isDeprecatedParamId, isMissingPath, newSkillLibrary, orderVersions, policyStageLimits, resolveParamId, resolveRootConfig, scopedProbeReport } from "@lmzhen/dsh-evolution-core";
 import { buildEnrichment, buildMaintainFacts, runMaintain, snapshotFromLibrary } from "@lmzhen/dsh-evolution-maintenance";
 import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -643,15 +643,46 @@ function renderValue(value) {
 	if (typeof value === "string") return value;
 	return JSON.stringify(value);
 }
+const WIDE_CHAR = new RegExp("[" + [
+	"ᄀ-ᅟ",
+	"⺀-〾",
+	"ぁ-㏿",
+	"㐀-䶿",
+	"一-鿿",
+	"가-힣",
+	"豈-﫿",
+	"︰-﹯",
+	"＀-｠",
+	"￠-￦"
+].join("") + "]");
 /**
-* Render the rows as fixed-width text (one parameter per line, never truncated).
-* @param rows - rows from {@link paramSurfaceRows}.
-* @param options - whether the settings service answered at all.
-* @returns the command text.
+* Pad one cell to a display width, counting CJK characters as two columns.
+* @param text - the cell text.
+* @param columns - the target width in terminal columns.
+* @returns the text plus at least one space, so columns never touch.
 */
+function pad(text, columns) {
+	let used = 0;
+	for (const char of text) used += WIDE_CHAR.test(char) ? 2 : 1;
+	return text + " ".repeat(Math.max(1, columns - used));
+}
+/** Settings timing, in the operator's words. */
+const APPLIES_LABELS = Object.freeze({
+	live: "立即",
+	restart: "重启后",
+	none: "不生效"
+});
+/** Where a row's effective value comes from, in the operator's words. */
+const SOURCE_LABELS = Object.freeze({
+	user: "我改过",
+	deployment: "默认",
+	unregistered: "不可改"
+});
+/** What the E-tiers mean, so the count line reads without the docs. */
+const TIER_LEGEND = "档位：E0 固定／E1 只读／E2 安装时定／E3 你可改／E4 装完固化。";
 function renderParamRows(rows, options) {
-	const header = "PARAMETER".padEnd(36) + "GROUP".padEnd(12) + "TIER".padEnd(5) + "APPLIES".padEnd(9) + "SOURCE".padEnd(14) + "VALUE";
-	const body = rows.map((row) => row.id.padEnd(36) + row.group.padEnd(12) + row.tier.padEnd(5) + row.applies.padEnd(9) + row.source.padEnd(14) + renderValue(row.value));
+	const header = pad("参数", 36) + pad("分组", 12) + pad("档位", 6) + pad("生效", 8) + pad("来源", 10) + "当前值";
+	const body = rows.map((row) => pad(row.id, 36) + pad(PARAM_GROUP_LABELS[row.group], 12) + pad(row.tier, 6) + pad(APPLIES_LABELS[row.applies] ?? row.applies, 8) + pad(SOURCE_LABELS[row.source] ?? row.source, 10) + renderValue(row.value));
 	const tiers = [
 		"E0",
 		"E1",
@@ -660,13 +691,14 @@ function renderParamRows(rows, options) {
 		"E4"
 	].map((tier) => `${tier} ${rows.filter((row) => row.tier === tier).length}`).join(" / ");
 	const userRows = rows.filter((row) => row.source === "user").length;
-	const overrides = options.providerMounted ? `${userRows} overridden by the user.` : "overrides UNKNOWN (no settings provider).";
-	const note = options.providerMounted ? "SOURCE: user = you set it in settings; deployment = the row/policy value applies; unregistered = the owner publishes no user layer." : "settings provider not mounted — the user layer is unavailable, so every row shows its deployment face (this is NOT \"no overrides\").";
+	const counts = options.providerMounted ? `共 ${rows.length} 个参数：${tiers}；你改过的：${userRows} 项。` : `共 ${rows.length} 个参数：${tiers}；是否改过：未知（没有设置服务）。`;
+	const note = options.providerMounted ? "来源：我改过＝你在设置里改的；默认＝安装时的配置；不可改＝该功能不提供用户可改项。" : "设置服务未挂载——读不到你改过的值，所以每行显示的都是安装时的配置（这不等于「你没改过」）。";
 	return [
 		header,
 		...body,
 		"",
-		`${rows.length} parameter(s): ${tiers}; ${overrides}`,
+		counts,
+		TIER_LEGEND,
 		note
 	].join("\n");
 }
@@ -709,79 +741,87 @@ function renderParamJson(rows) {
 const COMMAND_ENTRIES = [
 	{
 		usage: "pending [--detail]",
-		summary: "list staged evolution writes (--detail shows staged args)"
+		summary: "列出暂存的写入（--detail 显示参数）"
 	},
 	{
 		usage: "approve <id>",
-		summary: "replay an approved staged write through its runner"
+		summary: "执行一条已批准的写入"
 	},
 	{
 		usage: "reject <id>",
-		summary: "drop a staged write without running it"
+		summary: "丢弃一条暂存写入，不执行"
 	},
 	{
 		usage: "release <id>",
-		summary: "return an orphaned EXECUTING write to the pending window (verify the effect first, then approve or reject)"
+		summary: "把卡在执行中的写入放回待批窗口（先确认效果再批准 or reject)"
 	},
 	{
 		usage: "doctor [--json]",
-		summary: "read-only self-check: install form, conflicts, env, services (--json feeds scripts)"
+		summary: "只读自检：安装形态、冲突、环境、服务（--json 供脚本用）"
 	},
 	{
 		usage: "curator run|pause|resume|status|report|scope",
-		summary: "run one curation pass, control or inspect automatic curation"
+		summary: "立即运行一次自动整理，或暂停／恢复／查看状态"
 	},
 	{
 		usage: "mutations",
-		summary: "list skill-mutation audit records"
+		summary: "列出技能改动记录"
 	},
 	{
 		usage: "restore",
-		summary: "restore skills from the latest snapshot"
+		summary: "从最近的快照恢复技能"
 	},
 	{
 		usage: "consolidate <target> <sources...> [--plan <runId>]",
-		summary: "merge source skills into a target umbrella skill"
+		summary: "把若干技能合并进一个总括技能"
 	},
 	{
 		usage: "skill restore <name>",
-		summary: "restore one archived skill by name"
+		summary: "按名字恢复一个已归档的技能"
+	},
+	{
+		usage: "skill history <name>",
+		summary: "列出某个技能的内容版本（含时间、动作、字符数、哈希前缀）"
+	},
+	{
+		usage: "skill undo <name> [--to v<N>]",
+		summary: "把某个技能的内容回退到某一版（默认上一版；只动内容，撤销本身也记为一版）"
 	},
 	{
 		usage: "skills health",
-		summary: "structure-health verdicts for the skill library"
+		summary: "技能库结构体检"
 	},
 	{
 		usage: "skills refresh",
-		summary: "drop the catalog caches and re-read the tree"
+		summary: "丢弃目录缓存并重新读取技能树"
 	},
 	{
 		usage: "learn [request]",
-		summary: "send a learning request to this session"
+		summary: "向本会话发一条学习请求"
 	},
 	{
 		usage: "maintain [--timeout=<ms> | --facts]",
-		summary: "run a maintenance scan (--facts: 0-token preview)"
+		summary: "运行一次维护扫描（--facts 为 0 token 预览）"
 	},
 	{
 		usage: "policy set <id> <value> [--expect <revision>]",
-		summary: "write one user-writable parameter through the settings service (E3 only; E1/E2 stay in cordis.yml)"
+		summary: "通过设置服务写入一个你可改的参数 (E3 only; E1/E2 stay in cordis.yml)"
 	},
 	{
 		usage: "params [--group <name>] [--json]",
-		summary: "list every registered parameter: group, tier, timing, source and value (--json feeds scripts)"
+		summary: "列出全部参数：分组、档位、生效时机、来源与当前值（--json feeds scripts)"
 	},
 	{
 		usage: "preset install [--base <name>[,<name>...]]",
-		summary: "generate one Evolution agent preset per named base into the user root (bases from the agent package's bases.json)"
+		summary: "按指定基础生成自进化 Agent 预设到用户 root (bases from the agent package's bases.json)"
 	},
 	{
 		usage: "restructure <name> \"<heading>\" <to_file> [--plan <runId>]",
-		summary: "move a body section into a references/ file"
+		summary: "把技能正文的一节移到 references 文件"
 	},
 	{
 		usage: "replay",
-		summary: "compare plan outcomes across sessions and restarts (backfilled from the activity store)"
+		summary: "比较不同会话与重启之间的计划结果（从活动记录回填）"
 	}
 ];
 /** The input-declaration hint (single line, ` | `-separated). */
@@ -818,7 +858,7 @@ function apply(ctx, rawConfig = {}) {
 		const commands = commandCtx.commands;
 		const evolutionCommand = {
 			name: "evolution",
-			description: "Self-evolution status and approval controls",
+			description: "自进化：状态与待批准写入",
 			recordInput: false,
 			input: { hint: renderHint() },
 			run: async (invocation) => {
@@ -989,6 +1029,32 @@ function apply(ctx, rawConfig = {}) {
 					};
 					return result.ok ? ok(result.message) : err(result.message);
 				}
+				if (input.startsWith("skill history ")) {
+					const name = input.slice(14).trim();
+					if (!name) return err("Usage: /evolution skill history <name>");
+					const curator = ctx.get("evolutionCurator");
+					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
+					const versions = await curator.history(name);
+					if (versions.length === 0) return ok(`No content versions are recorded for "${name}" yet — they appear after the next write through skill_manage.`);
+					const ordered = orderVersions(versions);
+					const rows = ordered.map((entry) => `v${entry.v}\t${entry.at}\t${entry.action}\t${entry.chars} chars\t${entry.hash.slice(0, 12)}`);
+					return ok([`Content versions for "${name}" (oldest first, ${ordered.length} of at most the retained count):`, ...rows].join("\n"));
+				}
+				if (input.startsWith("skill undo ")) {
+					const rest = input.slice(11).trim();
+					const toMatch = /--to\s+v?(\d+)\s*$/.exec(rest);
+					const name = (toMatch?.index === void 0 ? rest : rest.slice(0, toMatch.index)).trim();
+					if (!name) return err("Usage: /evolution skill undo <name> [--to v<N>]");
+					const skillUndoRefusal = unreplayableWriteRefusal("skill undo");
+					if (skillUndoRefusal) return skillUndoRefusal;
+					const curator = ctx.get("evolutionCurator");
+					const target = toMatch?.[1] === void 0 ? void 0 : Number(toMatch[1]);
+					const result = curator ? await (target === void 0 ? curator.undo(name) : curator.undo(name, target)) : {
+						ok: false,
+						message: errorText("e-302-curator-service-not-mounted")
+					};
+					return result.ok ? ok(result.message) : err(result.message);
+				}
 				if (input === "skills health") {
 					const curator = ctx.get("evolutionCurator");
 					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
@@ -1341,7 +1407,7 @@ function apply(ctx, rawConfig = {}) {
 					if (input === "doctor --json") return ok(JSON.stringify(report, null, 2));
 					return ok(renderDoctorText(report));
 				}
-				return ok(`Evolution: memory, skills, review, curator — self-evolution status, approval and maintenance.\n${renderHelpText()}`);
+				return ok(`自进化：记忆、技能、会话回顾、技能整理——状态、待批准写入与维护。\n${renderHelpText()}`);
 			},
 			handler: (invocation) => evolutionCommand.run(invocation).catch((error) => ({
 				kind: "error",

package/lib/types/params.d.ts

@@ -52,12 +52,6 @@ export declare function paramSurfaceRows(sections: ReadonlyMap<string, ParamSect
  * @returns distinct group names.
  */
 export declare function paramGroups(entries?: readonly ParamExposure[]): string[];
-/**
- * Render the rows as fixed-width text (one parameter per line, never truncated).
- * @param rows - rows from {@link paramSurfaceRows}.
- * @param options - whether the settings service answered at all.
- * @returns the command text.
- */
 export declare function renderParamRows(rows: readonly ParamSurfaceRow[], options: {
     providerMounted: boolean;
 }): string;

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.8.0",
+  "version": "0.10.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,12 +27,12 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-approval": "^0.8.0",
-    "@lmzhen/dsh-evolution-core": "^0.8.0",
-    "@lmzhen/dsh-evolution-maintenance": "^0.8.0"
+    "@lmzhen/dsh-evolution-approval": "^0.10.0",
+    "@lmzhen/dsh-evolution-core": "^0.10.0",
+    "@lmzhen/dsh-evolution-maintenance": "^0.10.0"
   },
   "optionalDependencies": {
-    "@lmzhen/dsh-evolution-agent-preset": "^0.8.0"
+    "@lmzhen/dsh-evolution-agent-preset": "^0.10.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",