@lmzhen/dsh-evolution-maintenance 0.3.51 → 0.3.52

package/README.md

@@ -18,7 +18,11 @@ package owns assembly and rendering only.
   `evolution-maintenance-tools`) is available to maintenance subagents only
   through the orchestrate `toolFilter` allow-list; it is globally visible to
   every session as a read-only query (same exposure tier as the `skill`
-  tool — never a write path).
-- The model-visible template (`MAINTAIN_PROMPT`) ships in `evolution-core`
+  tool — never a write path). V10 (F-02): orchestrate soft-probes the tools
+  registry before spawning and degrades the filter to `skill`-only (declared
+  in the subagent prompt) when the tool row is not mounted, instead of failing
+  the spawn; an explicit `toolAllow` option bypasses the probe.
+- The model-visible template (`MAINTAIN_PROMPT`) and the subagent output
+  instruction (`MAINTAIN_OUTPUT_INSTRUCTION`, V10 F-16) ship in `evolution-core`
   `PROMPT_BUNDLE`; the joint-signature mismatch protocol is honored by
   `renderFacts` callers, not by this package alone.

package/lib/{enrichment-Di8Y4kev.js → enrichment-B7tEHkM5.js}

@@ -132,7 +132,7 @@ async function buildEnrichment(ctx, library) {
 	for (const entry of await library.list()) {
 		if (entry.protectedBy) protectedMap.set(entry.name, entry.protectedBy);
 		const body = await library.read(entry.name);
-		if (body === null) continue;
+		if (body === void 0 || body === null) continue;
 		const parsed = parseFrontmatter(body);
 		if (frontmatterYamlUnsafeValues(body).length > 0) catalogInvalid.set(entry.name, true);
 		const description = parsed?.frontmatter.description;

package/lib/index.js

@@ -1,5 +1,5 @@
-import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-Di8Y4kev.js";
-import { AUTHORING_DESCRIPTION_BAR, DEFAULT_HEALTH_THRESHOLDS, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, LOW_QUALITY_THRESHOLD, MAINTAIN_PROMPT, MIN_STAMP_BODY_CHARS, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, computeDriftSignals, findDriftSignal, redactSecrets, verifyPromptBundle } from "@lmzhen/dsh-evolution-core";
+import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-B7tEHkM5.js";
+import { AUTHORING_DESCRIPTION_BAR, DEFAULT_HEALTH_THRESHOLDS, DRIFT_MAX_LINE_CHARS, DRIFT_SIGNALS_VERSION, DRIFT_SIGNAL_NOUNS, LOW_QUALITY_THRESHOLD, MAINTAIN_OUTPUT_INSTRUCTION, MAINTAIN_PROMPT, MIN_STAMP_BODY_CHARS, PROMPT_BUNDLE, PROMPT_BUNDLE_ID, computeDriftSignals, findDriftSignal, redactSecrets, verifyPromptBundle } from "@lmzhen/dsh-evolution-core";
 import { createHash, randomUUID } from "node:crypto";
 //#region lib/types/render-facts.js
 /**
@@ -321,9 +321,12 @@ function buildMaintainFacts(snapshots, usageObserved, redact) {
 	};
 }
 /** V6-38 (0.3.36): a field value carrying its own standalone `Notes:` line is
-* indistinguishable from the plan's section header in the RENDERED text —
-* `beforeNotesHeader` cuts at the first standalone `Notes:` and undercounts
-* recommendations. Mark such lines so they can never read as the header. */
+* indistinguishable from the plan's section header in the RENDERED text, which
+* made the rendered plan read as if it ended early. Mark such lines so they
+* can never read as the header. (The former text-based recommendation counter
+* that motivated this marker is gone — V10-09/F-05 moved the count into
+* `MaintainOutcome.recommendationCount` — but the rendered text stays
+* unambiguous for the human reader.) */
 function sanitizeField(value) {
 	return value.split("\n").map((line) => line === "Notes:" ? "> Notes: (inside the field above)" : line).join("\n");
 }
@@ -361,6 +364,7 @@ async function runMaintain(runtime, options = {}) {
 	try {
 		if (!verifyPromptBundle(PROMPT_BUNDLE)) return {
 			ok: false,
+			recommendationCount: 0,
 			error: "dsh-evolution prompt bundle integrity check failed; refusing to run maintain"
 		};
 		const usageObserved = options.usageObserved ? options.usageObserved() : void 0;
@@ -374,18 +378,23 @@ async function runMaintain(runtime, options = {}) {
 		});
 		if (snapshots.length === 0) return {
 			ok: true,
+			recommendationCount: 0,
 			runId: randomUUID(),
 			verdict: "no_issues",
 			text: "Maintenance scan: empty skill library. Nothing to do."
 		};
 		const { facts, report, signalsVersion, signature } = buildMaintainFacts(snapshots, usageObserved, options.redact);
 		const template = renderMaintainTemplate(MAINTAIN_PROMPT, PROMPT_BUNDLE_ID, signalsVersion, signature);
-		const prompt = `${facts}
+		const probeRegistered = runtime.tools?.get("maintenance_probe") != null;
+		const probeDegraded = options.toolAllow === void 0 && !probeRegistered;
+		const toolAllow = options.toolAllow ?? (probeRegistered ? ["skill", "maintenance_probe"] : ["skill"]);
+		const prompt = `${facts}${probeDegraded ? "\n\n[tools] maintenance_probe is not registered in this session — the scan degrades to the `skill` tool only; the facts block above remains the complete evidence base. Do not call maintenance_probe." : ""}
 
-按模板契约输出 JSON 维护计划（verdict/plan/notes）；除 skill 工具与维护模板外你无其他工具。`;
+${MAINTAIN_OUTPUT_INSTRUCTION}`;
 		const timeoutMs = options.timeoutMs ?? 6e5;
 		if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 4294967295) return {
 			ok: false,
+			recommendationCount: 0,
 			error: `maintain: --timeout must be a positive integer in ms, at most 4294967295; got ${String(timeoutMs)}`
 		};
 		const signal = AbortSignal.timeout(timeoutMs);
@@ -403,7 +412,7 @@ async function runMaintain(runtime, options = {}) {
 			maxDepth: typeof options.maxDepth === "number" && Number.isFinite(options.maxDepth) && options.maxDepth >= 1 ? options.maxDepth : 1,
 			agentOptions,
 			persona: template,
-			toolFilter: { allow: [...options.toolAllow ?? ["skill", "maintenance_probe"]] },
+			toolFilter: { allow: [...toolAllow] },
 			outputSchema: {
 				type: "object",
 				additionalProperties: false,
@@ -481,16 +490,19 @@ async function runMaintain(runtime, options = {}) {
 			if (raw === void 0) {
 				if (runResult?.stopReason === "aborted") return {
 					ok: false,
+					recommendationCount: 0,
 					error: "Maintenance scan was aborted (the run was cancelled before the subagent produced a plan) — retry when the session is idle; concurrent re-submission cancels the previous scan."
 				};
 				return {
 					ok: false,
+					recommendationCount: 0,
 					error: "Maintain subagent returned no structured plan (the model did not emit the structured plan, or the run ended without one) — retry; if it repeats, raise --timeout or check the model output shape."
 				};
 			}
 			const validated = validateAndNormalizeMaintainPlan(raw, report, existingSignalIds(report));
 			if (!validated.ok) return {
 				ok: false,
+				recommendationCount: 0,
 				error: `Maintain plan rejected by validator: ${validated.errors.slice(0, 5).join("; ")}`
 			};
 			const runId = randomUUID();
@@ -499,6 +511,7 @@ async function runMaintain(runtime, options = {}) {
 				runId,
 				verdict: validated.plan.verdict,
 				forcedHuman: validated.forcedHuman,
+				recommendationCount: validated.plan.plan.length,
 				text: formatPlan(validated, runId)
 			};
 		} finally {
@@ -513,6 +526,7 @@ async function runMaintain(runtime, options = {}) {
 		const message = error instanceof Error ? error.message : String(error);
 		return {
 			ok: false,
+			recommendationCount: 0,
 			error: abortSignal?.aborted === true || name === "AbortError" || message === "This operation was aborted" ? "Maintenance scan was aborted (cancellation or timeout) before a plan was produced — retry, or raise the timeout (evolution-commands maintainTimeoutMs) on a slow/large library." : `Maintenance scan failed: ${message}`
 		};
 	}

package/lib/tools.js

@@ -1,4 +1,4 @@
-import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-Di8Y4kev.js";
+import { i as snapshotFromLibrary, n as PROBE_SIGNALS, r as computeProbe, t as buildEnrichment } from "./enrichment-B7tEHkM5.js";
 import { SkillLibrary, redactSecrets, resolveSkillsRoot } from "@lmzhen/dsh-evolution-core";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region lib/types/tools.js

package/lib/types/orchestrate.d.ts

@@ -34,6 +34,13 @@ export interface MaintainRuntime {
             curatorModel?: string | undefined;
         } | undefined;
     } | undefined;
+    /** F-02: tools-registry soft probe, wired from the host context
+     * (`ctx.get('tools')`) with the platform's `get(name)` accessor shape.
+     * Optional — an absent accessor means the tools service is not mounted at
+     * all, so no tool beyond `skill` can be assumed registered. */
+    tools?: {
+        get(name: string): unknown;
+    } | undefined;
 }
 export interface MaintainOptions {
     timeoutMs?: number;
@@ -56,6 +63,11 @@ export interface MaintainOutcome {
     verdict?: 'issues' | 'no_issues' | undefined;
     text?: string | undefined;
     forcedHuman?: string[] | undefined;
+    /** V10-09 (F-05): structured count of recommendations in the VALIDATED plan
+     * (plan entries, never notes). Consumers must read this field instead of
+     * parsing the rendered `text` — the text is display-only. 0 on every
+     * non-success outcome. */
+    recommendationCount: number;
 }
 /** Render template-M placeholders from the signal vocabulary (011 single-source rule). */
 export declare function renderMaintainTemplate(template: string, bundleVersion: string, signalsVersion: string, signature: string): string;

package/package.json

@@ -1,14 +1,14 @@
 {
   "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.3.51",
+  "version": "0.3.52",
   "publishConfig": {
     "access": "public"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lmzhen/dsh-evolution.git",
-    "directory": "packages/dsh-evolution-maintenance"
+    "directory": "packages/evolution-maintenance"
   },
   "type": "module",
   "main": "lib/index.js",
@@ -34,7 +34,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@lmzhen/dsh-evolution-core": "^0.3.51"
+    "@lmzhen/dsh-evolution-core": "^0.3.52"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",