@lmzhen/dsh-evolution-maintenance 0.18.0 → 0.19.0

package/README.md

@@ -16,6 +16,7 @@ chain behind `/evolution maintain` (`evolution-core` `drift-signals`).
 ## Known limitations
 
 - Phase 1-2 expose no service beyond the command surface: the chain (scan → render → subagent → validate) is wired through `/evolution maintain`.
+- **The scan's lifetime is the RUN's, not the request's (0.19.0).** `/evolution maintain` starts a run through `evolution-core`'s run registry and answers with a pointer; `evolution-commands` writes the resulting plan to `<evolutionHome>/reports/maintain-<runId>.{json,md}` — this package persists no report of its own. Measured: 949.7 s end to end on the web plane, ~305 s of REQUEST lifetime on the desktop shell (which used to abort the scan; it no longer does). `maintainTimeoutMs` (default 600000) bounds the run, and a run that produced nothing is recorded as such rather than as an empty plan. The published inventory of long runs is `packages/README.md` §"Long-running work", rendered from `evolution-core/src/long-runs.ts`.
 - **Plan validation is instance-granular (§3 completeness).** Notes stay id-level: one mention explains away every instance of that id.
 - **A budget-capped dedup scan is reported, never silently shortened.**
 - `maintenance_probe` is readable by every session; maintenance subagents reach it through the orchestrate `toolFilter` allow-list.

package/lib/index.js

@@ -428,7 +428,7 @@ async function runMaintain(runtime, options = {}) {
 			return {
 				ok: true,
 				recommendationCount: 0,
-				runId: randomUUID(),
+				runId: options.runId ?? randomUUID(),
 				verdict: "no_issues",
 				text: "Maintenance scan: empty skill library. Nothing to do."
 			};
@@ -554,7 +554,7 @@ ${MAINTAIN_OUTPUT_INSTRUCTION}`;
 				recommendationCount: 0,
 				error: `Maintain plan rejected by validator: ${validated.errors.slice(0, 5).join("; ")}`
 			};
-			const runId = randomUUID();
+			const runId = options.runId ?? randomUUID();
 			return {
 				ok: true,
 				runId,

package/lib/tools.js

@@ -1,5 +1,5 @@
 import { a as snapshotFromLibrary, i as enrichmentSnapshotOptions, n as computeProbe, r as buildEnrichment, t as PROBE_SIGNALS } from "./probe-Bojb0piw.js";
-import { assertSkillsRootAliasRetired, newSkillLibrary, redactSecrets, resolveRootConfig } from "@lmzhen/dsh-evolution-core";
+import { DEFAULT_PROBE_TIMEOUT_MS, MAX_TIMER_DELAY_MS, assertSkillsRootAliasRetired, clampedNumber, newSkillLibrary, redactSecrets, resolveRootConfig } from "@lmzhen/dsh-evolution-core";
 import z from "@deepseek-ai/schemastery";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region lib/types/tools.js
@@ -16,15 +16,18 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 const name = "evolution-maintenance-tools";
 const Config = z.object({
 	root: z.string().default(""),
-	skillsRoot: z.string().default("")
+	skillsRoot: z.string().default(""),
+	probeTimeoutMs: z.number().min(1).max(MAX_TIMER_DELAY_MS).default(DEFAULT_PROBE_TIMEOUT_MS)
 });
 function apply(ctx, rawConfig = {}) {
 	assertSkillsRootAliasRetired(rawConfig);
 	const rootConfig = resolveRootConfig(rawConfig);
+	const probeTimeoutMs = clampedNumber(rawConfig.probeTimeoutMs, DEFAULT_PROBE_TIMEOUT_MS, { min: 1 });
 	ctx.inject(["tools"], (toolCtx) => {
 		const tools = toolCtx.get("tools");
 		toolCtx.effect(() => tools.register(defineTool({
 			name: "maintenance_probe",
+			timeoutMs: probeTimeoutMs,
 			description: "Read-only deep-dive into maintenance scan signals: library-level group/cluster membership or per-skill detail (line numbers, pointer gaps, narrow shapes, stamp samples). Machine-derived from the same calculators as the facts block — never introduces new evidence ids. Output is JSON detail.",
 			parameters: {
 				signal: {

package/lib/types/orchestrate.d.ts

@@ -86,6 +86,10 @@ export interface MaintainRuntime {
 }
 export interface MaintainOptions {
     timeoutMs?: number;
+    /** 0.19.0 (S2): the run id chosen by the run registry, so the registry record,
+     * the persisted event and the report file all name ONE run. Absent under the
+     * legacy synchronous call sites, which keep generating their own. */
+    runId?: string | undefined;
     /** E-6 (v18): external cancel signal (session/UI); combined with timeoutMs. */
     signal?: AbortSignal | undefined;
     maxDepth?: number;

package/lib/types/tools.d.ts

@@ -18,13 +18,19 @@ export interface Config {
     /** V27 G2.4 (M-08): RETIRED alias of `root`. Declared so the loader passes it
      * to the load-time gate (which rejects it loudly) instead of dropping it. */
     skillsRoot?: string | undefined;
+    /** Model-facing budget of one probe call (ms). A hang guard: see
+     * `DEFAULT_PROBE_TIMEOUT_MS` for the measurement behind the default and for
+     * the conditions that would reopen it. */
+    probeTimeoutMs?: number | undefined;
 }
 export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     root: z<string, string, "defined">;
     skillsRoot: z<string, string, "defined">;
+    probeTimeoutMs: z<number, number, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     root: z<string, string, "defined">;
     skillsRoot: z<string, string, "defined">;
+    probeTimeoutMs: z<number, number, "defined">;
 }>>, "plain">;
 export declare function apply(ctx: Context, rawConfig?: Config): void;
 //# sourceMappingURL=tools.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-maintenance",
   "description": "Deterministic maintenance-scan surface: skill-library snapshot assembly, drift signals and mechanical-facts rendering (design 011) (community build)",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "publishConfig": {
     "access": "public"
   },
@@ -31,7 +31,7 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.4",
-    "@lmzhen/dsh-evolution-core": "^0.18.0"
+    "@lmzhen/dsh-evolution-core": "^0.19.0"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-agent": "^0.2.0-rc.1",