@lmzhen/dsh-evolution-commands 0.20.0 → 0.21.0

package/lib/index.js

@@ -380,8 +380,10 @@ function presetIssues(presets) {
 * build-time guards cannot. Three classes, each with its own move:
 *  - a user override (the effective value is no longer the deployment's),
 *  - a deprecated alias still written in a user section (writes refuse it),
-*  - a declared user-writable parameter whose owner publishes no user layer in
-*    this composition (the registry promises a face this deployment never mounts).
+*  - a declared user-writable parameter whose owner publishes no settings namespace AT ALL
+*    (a registry fact: writes answer E-315), and
+*  - a declared user-writable parameter whose owning row this runtime does not mount
+*    (the registry promises a face this composition never carries).
 * G5: the two layers and the live rows come from the platform (`configEditor.configuration()`,
 * `pluginManager.listPlugins()`); the registry side (which spellings are deprecated, which rows
 * declare an E3 parameter) stays the family's own table. A surface that is not mounted is
@@ -411,14 +413,20 @@ function paramDivergences(platform) {
 		return issues;
 	}
 	const live = liveRowTails(platform.plugins);
-	const unreachable = PARAM_EXPOSURE.filter((entry) => entry.tier === "E3").filter((entry) => {
+	const noUserLayer = [];
+	const unmounted = [];
+	for (const entry of PARAM_EXPOSURE) {
+		if (entry.tier !== "E3") continue;
 		const namespace = paramSettingsId(entry.owner);
-		return namespace === void 0 || !live.has(namespace);
-	}).map((entry) => entry.id);
-	if (unreachable.length > 0) {
-		const shown = unreachable.slice(0, 6).join(", ");
-		const more = unreachable.length > 6 ? ` (+${unreachable.length - 6} more)` : "";
-		issues.push(`declared user-writable but unreachable here: ${shown}${more} — the owning row is not mounted in this runtime`);
+		if (namespace === void 0) noUserLayer.push(entry.id);
+		else if (!live.has(namespace)) unmounted.push(entry.id);
+	}
+	for (const [ids, sentence] of [[noUserLayer, "declared user-writable but the owner publishes no settings namespace"], [unmounted, "declared user-writable but unreachable here"]]) {
+		if (ids.length === 0) continue;
+		const shown = ids.slice(0, 6).join(", ");
+		const more = ids.length > 6 ? ` (+${ids.length - 6} more)` : "";
+		const why = sentence.includes("no settings namespace") ? "those parameters have no user layer at all (writes answer E-315) — register the owner in PARAM_NAMESPACES or move its rows to E2" : "the owning row is not mounted in this runtime";
+		issues.push(`${sentence}: ${shown}${more} — ${why}`);
 	}
 	return issues;
 }
@@ -1318,6 +1326,14 @@ const COMMAND_ENTRIES = [
 		usage: "skill undo <name> [--to v<N>]",
 		summary: "把某个技能的内容回退到某一版（默认上一版；只动内容，撤销本身也记为一版）"
 	},
+	{
+		usage: "skill pin <name>",
+		summary: "钉住一个技能：免于删除、后台审查与生命周期整理（立即生效、随时可解钉；与 skill_manage 的 pin 动作同一语义，不走审批）"
+	},
+	{
+		usage: "skill unpin <name>",
+		summary: "解钉一个技能：撤销上面的冻结（立即生效、不走审批）"
+	},
 	{
 		usage: "skills health",
 		summary: "技能库结构体检"
@@ -1400,7 +1416,7 @@ const Config = z.object({
 	skillsRoot: z.string().default(""),
 	maintainCooldownMs: z.number().min(0).default(3e4),
 	maintainTimeoutMs: z.number().min(1).default(6e5),
-	maintainHandoffOnSettle: z.boolean().default(false),
+	maintainHandoffOnSettle: z.boolean().default(false).volatile(),
 	threatExemptLabels: z.array(z.string()).default([])
 });
 /** How one run reads in `maintain status` output. */
@@ -1549,10 +1565,29 @@ async function readRunReport(io, record) {
 		};
 	}
 }
+/**
+* Read a switch that may be a live settings reference.
+*
+* The loader hands a `.volatile()` field as `{ get() }` and the value is read at USE time; a
+* directly constructed plugin passes a plain boolean (the schema is the loader's face — the same
+* split the numeric knobs document as their second clamp layer). A single-form read is wrong
+* either way: `=== true` is never true for a reference, and `?.get()` ignores the plain value.
+* @param value - the configured switch, in either form, or undefined.
+* @returns the switch; undefined reads as off.
+*/
+function liveFlag(value) {
+	return typeof value === "boolean" ? value : value?.get() ?? false;
+}
 function apply(ctx, rawConfig = {}) {
 	const config = rawConfig;
 	assertSkillsRootAliasRetired(rawConfig);
 	const skillsRootValue = resolveRootConfig(rawConfig).root;
+	ctx.inject(["settings"], (scope) => {
+		const settings = scope.settings;
+		if (typeof settings?.configure !== "function") return;
+		const disposer = settings.configure({ auto: false }, ctx.fiber);
+		if (typeof disposer === "function") scope.effect(() => disposer, "evolution-commands: settings presentation");
+	});
 	let runs;
 	ctx.inject(["evolutionIo"], (ioCtx) => {
 		const ioRegistry = ioCtx.get("evolutionIo");
@@ -1782,6 +1817,23 @@ function apply(ctx, rawConfig = {}) {
 				};
 				return result.ok ? ok(result.message) : err(result.message);
 			}
+			if (input === "skill pin" || input.startsWith("skill pin ") || input === "skill unpin" || input.startsWith("skill unpin ")) {
+				const pinned = !input.startsWith("skill unpin");
+				const name = input.slice(pinned ? 10 : 12).trim();
+				if (!name) return err(`Usage: /evolution skill ${pinned ? "pin" : "unpin"} <name>`);
+				const ioRegistry = ctx.get("evolutionIo");
+				if (!ioRegistry) return err("Evolution IO registry not mounted — skill pinning unavailable.");
+				const result = await newSkillLibrary({
+					config: { root: skillsRootValue },
+					io: ioRegistry.provider(),
+					ctx,
+					limits: {
+						...DEFAULT_SKILL_LIMITS,
+						...policyStageLimits(ctx.get("evolutionPolicy")?.get?.())
+					}
+				}).setPinned(name, pinned);
+				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"));
@@ -1937,7 +1989,7 @@ function apply(ctx, rawConfig = {}) {
 							}).catch((error) => {
 								ctx.logger.warn(`evolution-commands: failed to record maintain event: ${String(error)}`);
 							});
-							if (config.maintainHandoffOnSettle === true && resultRef !== void 0 && runAgent !== void 0) try {
+							if (liveFlag(config.maintainHandoffOnSettle) && resultRef !== void 0 && runAgent !== void 0) try {
 								if (deliverHandoff(runAgent, createUserMessage({
 									content: [{
 										type: "text",

package/lib/types/index.d.ts

@@ -2,7 +2,7 @@
  * Human commands for the evolution family: /evolution learn|pending|curator|restore|consolidate|skills refresh.
  * @module @lmzhen/dsh-evolution-commands
  */
-import type { Context } from '@deepseek-ai/cordis';
+import type { Context, Volatile } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { ContextFormed } from '@deepseek-ai/dsh-llm';
 declare module '@deepseek-ai/dsh-llm' {
@@ -38,8 +38,13 @@ export interface Config {
     maintainTimeoutMs?: number | undefined;
     /** G2 (0.20.0): when a scan settles successfully, hand its report to the model
      * automatically (the same pointer+protocol injection `maintain handoff` performs).
-     * Default false: the injection wakes a turn, which costs a model call. */
-    maintainHandoffOnSettle?: boolean | undefined;
+     * Default false: the injection wakes a turn, which costs a model call.
+     *
+     * `.volatile()` (0.21.0, G3): the field carries a USER LAYER, so the loader hands the live
+     * reference and the switch is read at every settle — a settings write turns it on or off without
+     * a reload. A directly constructed plugin still passes a plain boolean (the schema's default is
+     * the loader's face), so the reader accepts both. */
+    maintainHandoffOnSettle?: boolean | Volatile<boolean> | undefined;
     /** Threat-scan exemption labels for WRITE-path skill mutations (P2-18).
      * Threaded into the SkillLibrary this package constructs for `restructure`
      * (its only write path); the core-side constructor option carries the same
@@ -55,14 +60,14 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     skillsRoot: z<string, string, "defined">;
     maintainCooldownMs: z<number, number, "defined">;
     maintainTimeoutMs: z<number, number, "defined">;
-    maintainHandoffOnSettle: z<boolean, boolean, "defined">;
+    maintainHandoffOnSettle: z<boolean, boolean, "volatile-defined">;
     threatExemptLabels: z<string[], string[], "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     root: z<string, string, "defined">;
     skillsRoot: z<string, string, "defined">;
     maintainCooldownMs: z<number, number, "defined">;
     maintainTimeoutMs: z<number, number, "defined">;
-    maintainHandoffOnSettle: z<boolean, boolean, "defined">;
+    maintainHandoffOnSettle: z<boolean, boolean, "volatile-defined">;
     threatExemptLabels: z<string[], string[], "defined">;
 }>>, "plain">;
 export declare function apply(ctx: Context, rawConfig?: Config): void;

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