@lmzhen/dsh-evolution-commands 0.32.5 → 0.33.0

package/README.md

@@ -1,23 +1,11 @@
 # @lmzhen/dsh-evolution-commands
 
-> `/evolution` 命令入口。
+Host command surface for the `/evolution` namespace: diagnostics, pending approvals, curator operations, maintenance, skill history, parameters, merge dispatch, migration, and preset installation.
 
-## 你会看到
+The canonical user command reference is [docs/commands.md](../../docs/commands.md); the package map and preset-install spelling live in [packages/README.md](../README.md). Do not maintain a second command table here.
 
-`/evolution doctor`、`pending`、`curator`、`merge`、`skill history` 等。
+The command row ships with `all`, `host`, and `preset`. If the platform `commands` service is absent, the `/evolution` namespace is not registered.
 
-## 什么时候会用到
+Under a layered/variant installation, original-preset sessions still see the management commands even though they do not carry the family model rows. That accepted difference and the mutual-exclusion rules are single-sourced in [INSTALL.md](../INSTALL.md).
 
-日常管理和排障时。
-
-## 默认 / 前提
-
-随 all/host/preset 安装自动注册。
-
-## 边界
-
-没有 `commands` 服务时整条命令不存在。
-
-分层/variant 的命令面差异单源在 [INSTALL.md](../INSTALL.md)。
-
-> 旧的 consolidate 已从用户面退役；合并请用 `merge`。
+The old `consolidate` command is retired; use `merge` for skill merging.

package/lib/index.js

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { DEFAULT_SKILL_LIMITS, DIAGNOSTICS_FACT_KEYS, DIAGNOSTICS_RUNTIME_KEYS, DIAGNOSTICS_VIEW_SCHEMA_VERSION, EVOLUTION_PRESET_IDS, MAINTAINER_PRESET_ID, MAX_TIMER_DELAY_MS, PARAM_EXPOSURE, PARAM_GROUP_LABELS, PLATFORM_LINE, REVIEWER_PRESET_ID, absentHostServices, appendEvolutionEvent, applyNamespaceMigration, asRecord, assertSkillsRootAliasRetired, atomicWriteFiles, authorityFrom, buildExtractPlanFromLibrary, buildLearnPrompt, canonicalWriteId, clampedNumber, classifyNamespaceMigration, classifySessionEvent, createSubagentChannel, elapsedSince, errorText, eventsFile, evolutionHome, evolutionRoot, hostSurface, isDeprecatedParamId, isPresent, isRecord, isUnknown, liveBool, newRunRegistry, newSkillLibrary, ownerDecisionText, paramSettingsId, partitionVersions, planNamespaceMigration, policyStageLimits, probeMtime, probeText, proposalFromPlan, reportsSweepLockTarget, resolveParamId, resolveRootConfig, scopedPackageName, scopedProbeReport, sweepReports, transactIo, writeProposalReport } from "@lmzhen/dsh-evolution-core";
+import { DEFAULT_SKILL_LIMITS, DIAGNOSTICS_FACT_KEYS, DIAGNOSTICS_RUNTIME_KEYS, DIAGNOSTICS_VIEW_SCHEMA_VERSION, EVOLUTION_PRESET_IDS, MAINTAINER_PRESET_ID, MAX_TIMER_DELAY_MS, PARAM_EXPOSURE, PARAM_GROUP_LABELS, PARAM_NAMESPACES, PLATFORM_LINE, REVIEWER_PRESET_ID, absentHostServices, appendEvolutionEvent, applyNamespaceMigration, asRecord, assertSkillsRootAliasRetired, atomicWriteFiles, authorityFrom, buildExtractPlanFromLibrary, buildLearnPrompt, canonicalWriteId, clampedNumber, classifyNamespaceMigration, classifySessionEvent, createSubagentChannel, elapsedSince, errorText, eventsFile, evolutionHome, evolutionRoot, hostSurface, isDeprecatedParamId, isPresent, isRecord, isUnknown, liveBool, newRunRegistry, newSkillLibrary, ownerDecisionText, paramSettingsId, partitionVersions, planNamespaceMigration, policyStageLimits, probeMtime, probeText, proposalFromPlan, registerOwnerSettings, reportsSweepLockTarget, resolveParamId, resolveRootConfig, scopedPackageName, scopedProbeReport, sweepReports, transactIo, unwrapLive, writeProposalReport } from "@lmzhen/dsh-evolution-core";
 import { HOST_ROUTES, json, methodNotAllowed, registerHostRoutes } from "@lmzhen/dsh-evolution-core/http-routes";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -29,9 +29,10 @@ import { processScopeViolations } from "@lmzhen/dsh-evolution-state-storage";
 */
 const COMMAND_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-history": { command: "/evolution skill undo <name> [--to v<N>]（查看：/evolution skill history <name>）" },
 	"skill-health": { command: "/evolution skills refresh（健康行：/evolution doctor）" },
 	merge: { command: "/evolution merge status / pending / approve <id> / report" },
+	settings: { command: "/evolution policy set <id> <value>（查看：/evolution policy）" },
 	diagnostics: {
 		command: "/evolution doctor",
 		platformCli: "dsh --json /evolution doctor"
@@ -486,6 +487,150 @@ function makeDiagnosticsRoutes(getInputs) {
 	}];
 }
 //#endregion
+//#region lib/types/settings-route.js
+/**
+* Family settings data plane.
+*
+* The platform RPC only serves its own namespace allowlist, so the browser cannot
+* reach family namespaces through /api/settings.* even though the underlying
+* settings service has them registered. These exact routes reuse the SAME
+* provider (describe/mutate), so storage, schema validation, revision conflicts
+* and redaction stay platform-owned; only the transport is family-scoped.
+* @module @lmzhen/dsh-evolution-commands/settings-route
+*/
+const FAMILY_NAMESPACES = new Set(Object.keys(PARAM_NAMESPACES));
+function normaliseValue(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return value;
+	const out = {};
+	for (const [key, field] of Object.entries(value)) {
+		const live = unwrapLive(field);
+		out[key] = live === void 0 ? field : live;
+	}
+	return out;
+}
+function snapshotOf(provider, descriptor) {
+	if (descriptor === void 0) return {
+		status: "unavailable",
+		writable: false,
+		value: void 0,
+		user: void 0,
+		base: void 0,
+		revision: void 0,
+		reason: "not-served"
+	};
+	return {
+		status: "ready",
+		writable: provider.writable,
+		value: normaliseValue(descriptor.value),
+		user: descriptor.user,
+		base: descriptor.base,
+		revision: descriptor.revision
+	};
+}
+function providerOf(getProvider) {
+	return getProvider();
+}
+/**
+* @param getProvider - resolves the live platform settings provider per request.
+* @returns exact routes for family settings describe/mutate.
+*/
+function makeSettingsRoutes(getProvider) {
+	return [{
+		path: HOST_ROUTES.settings.describe,
+		methods: ["GET"],
+		requestBody: "buffered",
+		fetch: async (request) => {
+			if (request.method !== "GET") return methodNotAllowed(["GET"]);
+			const provider = providerOf(getProvider);
+			if (provider === void 0) return json(503, {
+				ok: false,
+				error: "settings-service-unavailable"
+			});
+			try {
+				const namespaces = provider.describe({ redactSecrets: true }).filter((item) => FAMILY_NAMESPACES.has(item.ns)).map((item) => ({
+					ns: item.ns,
+					...snapshotOf(provider, item)
+				}));
+				return json(200, {
+					ok: true,
+					data: {
+						writable: provider.writable,
+						namespaces
+					}
+				});
+			} catch (error) {
+				return json(500, {
+					ok: false,
+					error: error instanceof Error ? error.message : String(error)
+				});
+			}
+		}
+	}, {
+		path: HOST_ROUTES.settings.mutate,
+		methods: ["POST"],
+		requestBody: "buffered",
+		fetch: async (request) => {
+			if (request.method !== "POST") return methodNotAllowed(["POST"]);
+			const provider = providerOf(getProvider);
+			if (provider === void 0) return json(503, {
+				ok: false,
+				error: "settings-service-unavailable"
+			});
+			let body;
+			try {
+				body = await request.json();
+			} catch {
+				return json(400, {
+					ok: false,
+					error: "invalid-json"
+				});
+			}
+			if (typeof body !== "object" || body === null) return json(400, {
+				ok: false,
+				error: "invalid-body"
+			});
+			const { ns, ops, expectedRevision } = body;
+			if (typeof ns !== "string" || !FAMILY_NAMESPACES.has(ns)) return json(400, {
+				ok: false,
+				error: "namespace-not-allowed"
+			});
+			if (!Array.isArray(ops) || ops.length === 0) return json(400, {
+				ok: false,
+				error: "ops-required"
+			});
+			if (expectedRevision !== void 0 && typeof expectedRevision !== "number") return json(400, {
+				ok: false,
+				error: "invalid-revision"
+			});
+			try {
+				await provider.mutate(ns, ops, expectedRevision);
+				const descriptor = provider.describe({ redactSecrets: true }).find((item) => item.ns === ns);
+				return json(200, {
+					ok: true,
+					data: {
+						writable: provider.writable,
+						namespaces: [{
+							ns,
+							...snapshotOf(provider, descriptor)
+						}]
+					}
+				});
+			} catch (error) {
+				if (error?.code === "SETTINGS_CONFLICT") return json(409, {
+					ok: false,
+					error: "settings-conflict",
+					actual: error.actual,
+					expected: error.expected
+				});
+				return json(400, {
+					ok: false,
+					error: error instanceof Error ? error.message : String(error)
+				});
+			}
+		}
+	}];
+}
+//#endregion
 //#region lib/types/migration.js
 /**
 * G3 (caller half): find the legacy settings document and run the namespace migration.
@@ -2512,6 +2657,7 @@ async function readRunReport(io, record) {
 	}
 }
 function apply(ctx, rawConfig = {}) {
+	registerOwnerSettings(ctx, "evolution-commands", Config);
 	const config = rawConfig;
 	assertSkillsRootAliasRetired(rawConfig);
 	const skillsRootValue = resolveRootConfig(rawConfig).root;
@@ -3529,7 +3675,7 @@ function apply(ctx, rawConfig = {}) {
 	ctx.inject(["settings"], () => {
 		runMigrationOnce();
 	});
-	registerHostRoutes(ctx, () => makeDiagnosticsRoutes(() => assembleDoctorInputs(ctx, { runs: doctorRuns() })));
+	registerHostRoutes(ctx, () => [...makeDiagnosticsRoutes(() => assembleDoctorInputs(ctx, { runs: doctorRuns() })), ...makeSettingsRoutes(() => ctx.get("settings"))]);
 	(async () => {
 		const loader = ctx.root.loader;
 		try {

package/lib/types/command-fallback.d.ts

@@ -16,7 +16,7 @@ export interface CommandFallbackHint {
     readonly platformCli?: string;
 }
 /** The four Host surfaces (keyed exactly like the frozen `COMMAND_FALLBACK_SURFACES`). */
-export type CommandFallbackSurface = 'approval' | 'skill-history' | 'skill-health' | 'merge' | 'diagnostics';
+export type CommandFallbackSurface = 'approval' | 'skill-history' | 'skill-health' | 'merge' | 'diagnostics' | 'settings';
 /**
  * One entry per Host surface. The command column names the same service methods the routes call,
  * so the answers (and refusal sentences) match the panel.

package/lib/types/settings-route.d.ts

@@ -0,0 +1,27 @@
+import type { ConnectionFetchRouteLike } from '@lmzhen/dsh-evolution-core/http-routes';
+interface SettingsDescriptorLike {
+    ns: string;
+    value?: unknown;
+    user?: Record<string, unknown>;
+    base?: unknown;
+    revision?: number;
+    applies?: 'live' | 'restart';
+}
+interface SettingsProviderLike {
+    readonly writable: boolean;
+    describe(options?: {
+        redactSecrets?: boolean;
+    }): SettingsDescriptorLike[];
+    mutate(ns: string, ops: readonly {
+        op: 'set' | 'unset';
+        path: readonly string[];
+        value?: unknown;
+    }[], expectedRevision?: number): Promise<void>;
+}
+/**
+ * @param getProvider - resolves the live platform settings provider per request.
+ * @returns exact routes for family settings describe/mutate.
+ */
+export declare function makeSettingsRoutes(getProvider: () => SettingsProviderLike | undefined): ConnectionFetchRouteLike[];
+export {};
+//# sourceMappingURL=settings-route.d.ts.map

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.32.5",
+  "version": "0.33.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,13 +27,13 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.5",
-    "@lmzhen/dsh-evolution-approval": "^0.32.5",
-    "@lmzhen/dsh-evolution-core": "^0.32.5",
-    "@lmzhen/dsh-evolution-maintenance": "^0.32.5",
-    "@lmzhen/dsh-evolution-state-storage": "^0.32.5"
+    "@lmzhen/dsh-evolution-approval": "^0.33.0",
+    "@lmzhen/dsh-evolution-core": "^0.33.0",
+    "@lmzhen/dsh-evolution-maintenance": "^0.33.0",
+    "@lmzhen/dsh-evolution-state-storage": "^0.33.0"
   },
   "optionalDependencies": {
-    "@lmzhen/dsh-evolution-agent-preset": "^0.32.5"
+    "@lmzhen/dsh-evolution-agent-preset": "^0.33.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",