@lmzhen/dsh-evolution-commands 0.6.1 → 0.8.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, 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_NAMESPACES, appendEvolutionEvent, assertSkillsRootAliasRetired, buildLearnPrompt, canonicalWriteId, clampedNumber, composePresetComposition, errorText, eventsFile, evolutionRoot, isDeprecatedParamId, isMissingPath, newSkillLibrary, 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";
@@ -833,18 +833,18 @@ function apply(ctx, rawConfig = {}) {
 					text
 				});
 				const invocationAgent = invocation.agent;
-				const agentMissing = (need) => invocationAgent === void 0 ? err(`E-305: this invocation carries no agent — \`${need}\` needs a session-backed call (run it from a session in the GUI or the CLI).`) : void 0;
+				const agentMissing = (need) => invocationAgent === void 0 ? err(errorText("e-305-this-invocation-carries-no", { a1: need })) : void 0;
 				const unreplayableWriteRefusal = (what) => {
 					if (approval === void 0) return void 0;
 					const session = invocationAgent?.session;
 					const sessionPolicy = effectiveSessionPolicy(ctx, session);
 					if (!(approval.isEnabled !== false && sessionPolicy !== "never" && approval.stageForeground !== false)) return void 0;
-					return err(`E-306: this deployment stages foreground writes, but \`/evolution ${what}\` is not replayable through the skill runner — there is nothing to stage. Run it from a session whose approval policy is 'never', or set \`stageForeground: false\` on the evolution-approval row, then repeat the command.`);
+					return err(errorText("e-306-this-deployment-stages-foreground", { a1: what }));
 				};
 				const approval = ctx.get("evolutionApproval");
 				const pendingMatch = /^pending(?: --detail)?$/.exec(input);
 				if (pendingMatch) {
-					if (!approval) return err("E-301: approval service not mounted — pending writes cannot be listed or replayed. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted.");
+					if (!approval) return err(errorText("e-301-approval-service-not-mounted"));
 					const listed = [...await approval.list("pending"), ...await approval.list("executing")];
 					const pending = [...new Map(listed.map((row) => [row.id, row])).values()];
 					if (pending.length === 0) return ok("No pending evolution writes.");
@@ -860,7 +860,7 @@ function apply(ctx, rawConfig = {}) {
 					const id = input.slice(8).trim();
 					const result = approval ? await approval.approve(id) : {
 						ok: false,
-						message: "E-301: approval service not mounted. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted."
+						message: errorText("e-301-approval-service-not-mounted-2")
 					};
 					return result.ok ? ok(result.message) : err(result.message);
 				}
@@ -868,27 +868,27 @@ function apply(ctx, rawConfig = {}) {
 					const id = input.slice(7).trim();
 					const result = approval ? await approval.reject(id) : {
 						ok: false,
-						message: "E-301: approval service not mounted. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted."
+						message: errorText("e-301-approval-service-not-mounted-2")
 					};
 					return result.ok ? ok(result.message) : err(result.message);
 				}
 				if (input.startsWith("release ")) {
 					const id = input.slice(8).trim();
-					if (!approval) return err("E-301: approval service not mounted. Next: the evolution-approval row ships with evolution-host/evolution-all — run /evolution doctor to see which services are mounted.");
-					if (!approval.release) return err("E-304: the mounted approval service predates the release capability — reject the record instead.");
+					if (!approval) return err(errorText("e-301-approval-service-not-mounted-2"));
+					if (!approval.release) return err(errorText("e-304-the-mounted-approval-service"));
 					const result = await approval.release(id);
 					return result.ok ? ok(result.message) : err(result.message);
 				}
 				if (input === "curator run") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 					const result = await curator.run({ ignoreGates: true });
 					if (result.skipped !== void 0) return ok(`Curator run skipped (${result.skipped}): no curation pass was executed.\nrunId=${result.report.runId}`);
 					return ok(`Curator run complete: ${result.stale.length} stale, ${result.archived.length} archived, ${result.errors.length} failed.\nrunId=${result.report.runId}${result.report.snapshotPath ? `\nsnapshot=${result.report.snapshotPath}` : ""}`);
 				}
 				if (input === "curator pause" || input === "curator resume") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 					const paused = input === "curator pause";
 					await curator.setPaused(paused);
 					const notPersisted = ctx.get("evolutionState") !== void 0 ? "" : "\nNOTE: no evolution state service is mounted — this setting is NOT persisted and will not survive this process.";
@@ -896,7 +896,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "curator status") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 					const state = await curator.status();
 					if (!state) return ok("No curator state yet: the first automatic pass is deferred until the interval elapses.");
 					const lastRun = typeof state.lastRunAt === "number" && Number.isFinite(state.lastRunAt) && state.lastRunAt > 0 ? new Date(state.lastRunAt).toISOString() : "unknown";
@@ -909,7 +909,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "mutations") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 					const records = await curator.skills.listMutations();
 					const usable = Array.isArray(records) ? records.filter((row) => typeof row === "object" && row !== null && typeof row.at === "string" && typeof row.skillName === "string" && typeof row.action === "string" && typeof row.summary === "string") : [];
 					if (usable.length === 0) return ok("No mutation records yet.");
@@ -918,7 +918,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "curator scope") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 					const view = await curator.scopeView();
 					const line = (label, names) => `${label}: ${names.length}${names.length === 0 ? "" : `\n  ${names.join(", ")}`}`;
 					return ok([
@@ -932,7 +932,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "curator report") {
 					const curator = ctx.get("evolutionCurator");
-					if (!curator) return err("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 					const report = await curator.latestReport();
 					if (!report) return ok("No curator report available.");
 					if (typeof report !== "object" || typeof report.runId !== "string" || typeof report.startedAt !== "string" || !Array.isArray(report.archived) || !Array.isArray(report.failed)) return err("Report file unreadable.");
@@ -958,7 +958,7 @@ function apply(ctx, rawConfig = {}) {
 					const curator = ctx.get("evolutionCurator");
 					const result = curator ? await curator.restoreSnapshot() : {
 						ok: false,
-						message: "E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor."
+						message: errorText("e-302-curator-service-not-mounted")
 					};
 					return result.ok ? ok(result.message) : err(result.message);
 				}
@@ -972,7 +972,7 @@ function apply(ctx, rawConfig = {}) {
 					const curator = ctx.get("evolutionCurator");
 					const result = curator ? await curator.consolidate(target, sources) : {
 						ok: false,
-						message: "E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor."
+						message: errorText("e-302-curator-service-not-mounted")
 					};
 					if (!result.ok) return err(result.message);
 					return ok(planRunId ? `${result.message}\n[audit] plan=${planRunId}` : result.message);
@@ -985,13 +985,13 @@ function apply(ctx, rawConfig = {}) {
 					const curator = ctx.get("evolutionCurator");
 					const result = curator ? await curator.restore(name) : {
 						ok: false,
-						message: "E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor."
+						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("E-302: curator service not mounted. Next: mount the evolution-curator row (evolution-host/evolution-all) and run /evolution doctor.");
+					if (!curator) return err(errorText("e-302-curator-service-not-mounted"));
 					const [rows, observed] = await Promise.all([curator.healthView(), curator.usageObserved()]);
 					const banner = observed ? "" : "Usage observation not yet established — churn (write-ghost) rows are suppressed.";
 					const line = (row) => `${row.verdict.padEnd(18)} ${row.name}${row.reasons.length > 0 ? ` — ${row.reasons.join("; ")}` : ""}`;
@@ -1024,7 +1024,7 @@ function apply(ctx, rawConfig = {}) {
 						agent.followup(message);
 						woke = true;
 					} else if (typeof agent.inject === "function") agent.inject(message);
-					else return err("E-305: the invocation agent exposes neither `followup` nor `inject` — this learn request has no delivery channel.");
+					else return err(errorText("e-305-the-invocation-agent-exposes"));
 					const eventIo = ctx.get("evolutionIo")?.provider();
 					if (eventIo) appendEvolutionEvent(eventIo, eventsFile(evolutionRoot()), {
 						type: "learn",
@@ -1203,7 +1203,7 @@ function apply(ctx, rawConfig = {}) {
 						const session = invocationAgent?.session;
 						const sessionPolicy = effectiveSessionPolicy(ctx, session);
 						const stagesForeground = approval.isEnabled !== false && sessionPolicy !== "never" && approval.stageForeground !== false;
-						if (stagesForeground && session === void 0) return err("E-306: this deployment stages foreground writes, but this invocation carries no agent session — `/evolution restructure` would stage a record with no session attribution. Run it from a session in the GUI or the CLI, or set `stageForeground: false` on the evolution-approval row, then repeat the command.");
+						if (stagesForeground && session === void 0) return err(errorText("e-306-this-deployment-stages-foreground-2"));
 						if (stagesForeground && !approval.hasRunner("skill")) return err("Restructure cannot be staged: no skill replay runner is registered — mount the tool-skill-manage row (evolution-agent preset, or evolution-all) or disable evolution-approval.");
 						const decision = await approval.request({
 							kind: "skill",
@@ -1248,7 +1248,7 @@ function apply(ctx, rawConfig = {}) {
 				}
 				if (input === "replay") {
 					const replay = ctx.get("evolutionReplay");
-					if (!replay) return err("E-303: replay service not mounted. Next: mount the evolution-replay row (evolution-host/evolution-all) and run /evolution doctor.");
+					if (!replay) return err(errorText("e-303-replay-service-not-mounted"));
 					return ok(replay.compare().report);
 				}
 				const paramsMatch = /^params(?: --group ([a-z-]+))?(?: --json)?$/.exec(input);
@@ -1264,52 +1264,68 @@ function apply(ctx, rawConfig = {}) {
 							sections.set(descriptor.ns, section);
 						}
 					} catch (error) {
-						return err(`E-307: the settings service could not report its sections (${error instanceof Error ? error.message : String(error)}). /evolution params needs the user layer to tell an override from a deployment value; run /evolution doctor to see which services are mounted.`);
+						return err(errorText("e-307-the-settings-service-could", { a1: error instanceof Error ? error.message : String(error) }));
 					}
 					const rows = paramSurfaceRows(sections, PARAM_EXPOSURE);
 					const group = paramsMatch[1];
 					const selected = group === void 0 ? rows : rows.filter((row) => row.group === group);
-					if (group !== void 0 && selected.length === 0) return err(`E-308: unknown parameter group "${group}" — known groups: ${paramGroups(PARAM_EXPOSURE).join(", ")}.`);
+					if (group !== void 0 && selected.length === 0) return err(errorText("e-308-unknown-parameter-group-group", {
+						a1: group,
+						a2: paramGroups(PARAM_EXPOSURE).join(", ")
+					}));
 					if (input.endsWith("--json")) return ok(renderParamJson(selected));
 					return ok(renderParamRows(selected, { providerMounted: provider !== void 0 }));
 				}
 				const policySetMatch = /^policy set ([A-Za-z][A-Za-z0-9.-]*) (.+?)(?: --expect (\d+))?$/.exec(input);
 				if (policySetMatch) {
 					const provider = ctx.get("settings");
-					if (provider?.update === void 0 || provider.describe === void 0) return err("E-311: no settings service is mounted, so there is no user layer to write. Mount the settings row (packages/settings/settings-file) and retry; this command never edits cordis.yml — a deployment value belongs to the deployment. /evolution doctor lists the mounted services.");
+					if (provider?.update === void 0 || provider.describe === void 0) return err(errorText("e-311-no-settings-service-is"));
 					const rawId = policySetMatch[1] ?? "";
 					const rawValue = policySetMatch[2] ?? "";
 					let id;
 					try {
 						id = canonicalWriteId(rawId);
 					} catch (error) {
-						return err(`E-312: ${error instanceof Error ? error.message : String(error)} — /evolution params lists the canonical ids.`);
+						return err(errorText("e-312-error-instanceof-Error-error", { a1: error instanceof Error ? error.message : String(error) }));
 					}
 					const entry = PARAM_EXPOSURE.find((candidate) => candidate.id === id);
-					if (entry === void 0) return err(`E-313: unknown parameter "${id}" — /evolution params lists every registered id with its tier and user layer.`);
-					if (entry.tier !== "E3") return err(`E-314: "${id}" is a deployment parameter (tier ${entry.tier}, owner ${entry.owner}) — it is written in cordis.yml on its plugin or policy row, not from a session. /evolution params shows who may write each row.`);
+					if (entry === void 0) return err(errorText("e-313-unknown-parameter-id-evolution", { a1: id }));
+					if (entry.tier !== "E3") return err(errorText("e-314-id-is-a-deployment", {
+						a1: id,
+						a2: entry.tier,
+						a3: entry.owner
+					}));
 					const namespace = PARAM_NAMESPACES[entry.owner];
-					if (namespace === void 0) return err(`E-315: "${id}" has no user layer — owner ${entry.owner} publishes no settings namespace, so the value stays with the deployment.`);
+					if (namespace === void 0) return err(errorText("e-315-id-has-no-user", {
+						a1: id,
+						a2: entry.owner
+					}));
 					let descriptor;
 					try {
 						descriptor = provider.describe({ redactSecrets: false }).find((candidate) => candidate.ns === namespace);
 					} catch (error) {
-						return err(`E-307: the settings service could not report its sections (${error instanceof Error ? error.message : String(error)}). /evolution policy set needs the current revision to write safely; run /evolution doctor to see which services are mounted.`);
+						return err(errorText("e-307-the-settings-service-could-2", { a1: error instanceof Error ? error.message : String(error) }));
 					}
-					if (descriptor === void 0) return err(`E-316: namespace "${namespace}" is not registered — owner ${entry.owner} is not mounted in this composition, so its parameters cannot be written from here. /evolution params marks those rows 'unregistered'.`);
+					if (descriptor === void 0) return err(errorText("e-316-namespace-namespace-is-not", {
+						a1: namespace,
+						a2: entry.owner
+					}));
 					const current = descriptor.value;
 					const resolved = typeof current === "object" && current !== null ? current : void 0;
 					const expectedRaw = policySetMatch[3];
 					const expected = expectedRaw === void 0 ? descriptor.revision : Number(expectedRaw);
-					if (expectedRaw !== void 0 && descriptor.revision !== void 0 && Number(expectedRaw) !== descriptor.revision) return err(`E-309: revision conflict — you sent ${expectedRaw}, the document stands at ${descriptor.revision}. Re-read with /evolution params --json and retry.`);
+					if (expectedRaw !== void 0 && descriptor.revision !== void 0 && Number(expectedRaw) !== descriptor.revision) return err(errorText("e-309-revision-conflict-you-sent", {
+						a1: expectedRaw,
+						a2: descriptor.revision
+					}));
 					const value = parseParamValue(rawValue);
 					try {
 						await provider.update(namespace, { [id]: value }, expected);
 					} catch (error) {
 						const code = error?.code;
 						const message = error instanceof Error ? error.message : String(error);
-						if (code === "SETTINGS_CONFLICT") return err(`E-309: revision conflict — ${message}. Re-read with /evolution params --json and retry.`);
-						return err(`E-310: the settings service refused the write: ${message} — the owning plugin's rule stands (a cross-field pair, or a cap that may only be tightened). /evolution params shows the current value.`);
+						if (code === "SETTINGS_CONFLICT") return err(errorText("e-309-revision-conflict-message-Re", { a1: message }));
+						return err(errorText("e-310-the-settings-service-refused", { a1: message }));
 					}
 					return ok(renderPolicySet({
 						id,

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