@lmzhen/dsh-evolution-maintenance 0.19.3 → 0.21.0

package/lib/index.js

@@ -379,14 +379,14 @@ function formatPlan(validated, runId) {
 		lines.push(...noteLines);
 		return lines.join("\n");
 	}
-	for (const item of plan.plan) {
+	for (const [index, item] of plan.plan.entries()) {
 		const flags = [
 			item.impact,
 			`rev=${item.reversibility}`,
 			`conf=${item.confidence.toFixed(2)}`,
 			item.needs_human ? "HUMAN" : ""
 		].filter(Boolean);
-		lines.push(`- [${item.kind}] ${item.names.join(", ")} · rule=${item.rule} · ${flags.join(" ")}`);
+		lines.push(`- [${index + 1}] [${item.kind}] ${item.names.join(", ")} · rule=${item.rule} · ${flags.join(" ")}`);
 		lines.push(`  finding: ${sanitizeField(item.finding)}`);
 		lines.push(`  action: ${sanitizeField(item.recommendation)}`);
 		if (item.undo_path && item.undo_path !== "n/a") lines.push(`  undo: ${sanitizeField(item.undo_path)}`);
@@ -560,6 +560,9 @@ ${MAINTAIN_OUTPUT_INSTRUCTION}`;
 				runId,
 				verdict: validated.plan.verdict,
 				forcedHuman: validated.forcedHuman,
+				items: validated.plan.plan,
+				notes: validated.plan.notes,
+				needsHumanCount: validated.plan.plan.filter((item) => item.needs_human).length,
 				recommendationCount: validated.plan.plan.length,
 				text: formatPlan(validated, runId)
 			};

package/lib/types/orchestrate.d.ts

@@ -8,6 +8,7 @@ import { type DriftReport, type DriftSkillSnapshot } from '@lmzhen/dsh-evolution
 import type { Agent } from '@deepseek-ai/dsh-agent';
 import { type SkillLibraryLike } from './drift-scan.ts';
 import { type Enrichment } from './enrichment.ts';
+import { type MaintainPlanItem } from './validate-plan.ts';
 /** I-5 (v37): the platform's `SubagentStartRequest` fields this orchestrator sends.
  * Typed locally (not imported) because the platform type lives behind the subagent row this
  * package does not depend on; the required `parent` and `signal` mirror the platform. */
@@ -109,6 +110,14 @@ export interface MaintainOutcome {
     verdict?: 'issues' | 'no_issues' | undefined;
     text?: string | undefined;
     forcedHuman?: string[] | undefined;
+    /** G1 (0.20.0): the VALIDATED plan entries in render order — the report's machine-readable
+     * ledger. `formatPlan` numbers this same array with stable `[n]` ids, and
+     * `needsHumanCount` below is derived from it here, so no reader re-derives either. */
+    items?: MaintainPlanItem[] | undefined;
+    /** The validated plan's notes, carried beside `items` so a reader never infers them. */
+    notes?: string[] | undefined;
+    /** How many entries need the operator's confirmation (`needs_human`, gate included). */
+    needsHumanCount?: number | 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

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.19.3",
+  "version": "0.21.0",
   "publishConfig": {
     "access": "public"
   },
@@ -31,7 +31,7 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.4",
-    "@lmzhen/dsh-evolution-core": "^0.19.3"
+    "@lmzhen/dsh-evolution-core": "^0.21.0"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-agent": "^0.2.0-rc.1",