@lmzhen/dsh-evolution-merge 0.30.15 → 0.30.17

package/lib/index.js

@@ -246,6 +246,14 @@ function parseLedger(raw) {
 		};
 	}
 	const body = parsed;
+	if (typeof body.schemaVersion === "number" && body.schemaVersion > 2) return {
+		ok: false,
+		ledger: {
+			schemaVersion: 2,
+			rows: []
+		},
+		note: "merge-state-forward-only"
+	};
 	if (!Array.isArray(body.rows)) return {
 		ok: false,
 		ledger: {
@@ -300,7 +308,8 @@ function parseState(raw) {
 	const parsed = parseLedger(raw);
 	if (!parsed.ok) return {
 		ok: false,
-		rows: []
+		rows: [],
+		...parsed.note === void 0 ? {} : { note: parsed.note }
 	};
 	return {
 		ok: true,
@@ -336,7 +345,9 @@ async function loadMergeState(io, home) {
 async function mutateMergeState(io, home, now, fn) {
 	let result;
 	await transactIo(io, mergeStatePath(home), (current) => {
-		const out = fn(parseState(current).rows);
+		const parsed = parseState(current);
+		if (!parsed.ok || parsed.note === "merge-state-forward-only") throw new Error(parsed.note ?? "merge-state-invalid");
+		const out = fn(parsed.rows);
 		result = out.result;
 		return JSON.stringify({
 			schemaVersion: 2,
@@ -1551,8 +1562,13 @@ function mergeUsage() {
 //#region lib/types/read-commands.js
 async function handleReadOnlyMergeCommand(command, io, home, cards) {
 	const withNote = (text, note) => note === void 0 ? text : "note: " + note + "\n" + text;
+	const load = async () => {
+		const result = await loadMergeState(io, home);
+		if (result.note === "merge-state-forward-only") throw new Error("merge-state-forward-only");
+		return result;
+	};
 	if (command.verb === "status") {
-		const loaded = await loadMergeState(io, home);
+		const loaded = await load();
 		if (command.id !== void 0) {
 			const row = loaded.state.rows.find((item) => item.id === command.id);
 			return withNote(row === void 0 ? "merge row not found: " + command.id : formatStatus([row]), loaded.note);
@@ -1560,17 +1576,17 @@ async function handleReadOnlyMergeCommand(command, io, home, cards) {
 		return withNote(formatStatus(loaded.state.rows), loaded.note);
 	}
 	if (command.verb === "pending") {
-		const loaded = await loadMergeState(io, home);
+		const loaded = await load();
 		const rows = command.expired === true ? loaded.state.rows.filter((row) => row.expired !== void 0) : loaded.state.rows;
 		const live = cards === void 0 ? rows : rows.filter((row) => cards.some((card) => card.name === row.a) && cards.some((card) => card.name === row.b));
 		return withNote(command.expired === true ? formatStatus(live) : formatQueue(live, "pending"), loaded.note);
 	}
 	if (command.verb === "candidates") {
-		const loaded = await loadMergeState(io, home);
+		const loaded = await load();
 		return withNote(formatQueue(command.retry === true ? loaded.state.rows.filter((row) => row.state === "approved") : loaded.state.rows, command.retry === true ? "fuse" : "verify"), loaded.note);
 	}
 	if (command.verb === "skipped") {
-		const loaded = await loadMergeState(io, home);
+		const loaded = await load();
 		return withNote(formatQueue(loaded.state.rows, "skipped"), loaded.note);
 	}
 	return null;
@@ -1747,6 +1763,7 @@ async function runScan(options) {
 	const stage = options.stage ?? (async () => {});
 	const candidates = await options.ports.screening(options.signal);
 	const before = await loadMergeState(options.io, options.home);
+	if (!before.ok) throw new Error(before.note ?? "merge-state-invalid");
 	const queueBefore = {
 		verify: 0,
 		pending: 0,

package/lib/types/domain/ledger.js

@@ -17,6 +17,9 @@ export function parseLedger(raw) {
         return { ok: false, ledger: { schemaVersion: 2, rows: [] }, note: 'invalid json' };
     }
     const body = parsed;
+    if (typeof body.schemaVersion === 'number' && body.schemaVersion > 2) {
+        return { ok: false, ledger: { schemaVersion: 2, rows: [] }, note: 'merge-state-forward-only' };
+    }
     if (!Array.isArray(body.rows))
         return { ok: false, ledger: { schemaVersion: 2, rows: [] }, note: 'rows missing' };
     const rows = [];

package/lib/types/read-commands.js

@@ -3,8 +3,14 @@ import { formatQueue, formatStatus } from "./status.js";
 import { mergeUsage } from "./commands.js";
 export async function handleReadOnlyMergeCommand(command, io, home, cards) {
     const withNote = (text, note) => note === undefined ? text : 'note: ' + note + '\n' + text;
+    const load = async () => {
+        const result = await loadMergeState(io, home);
+        if (result.note === 'merge-state-forward-only')
+            throw new Error('merge-state-forward-only');
+        return result;
+    };
     if (command.verb === 'status') {
-        const loaded = await loadMergeState(io, home);
+        const loaded = await load();
         if (command.id !== undefined) {
             const row = loaded.state.rows.find(item => item.id === command.id);
             return withNote(row === undefined ? 'merge row not found: ' + command.id : formatStatus([row]), loaded.note);
@@ -12,18 +18,18 @@ export async function handleReadOnlyMergeCommand(command, io, home, cards) {
         return withNote(formatStatus(loaded.state.rows), loaded.note);
     }
     if (command.verb === 'pending') {
-        const loaded = await loadMergeState(io, home);
+        const loaded = await load();
         const rows = command.expired === true ? loaded.state.rows.filter(row => row.expired !== undefined) : loaded.state.rows;
         const live = cards === undefined ? rows : rows.filter(row => cards.some(card => card.name === row.a) && cards.some(card => card.name === row.b));
         return withNote(command.expired === true ? formatStatus(live) : formatQueue(live, 'pending'), loaded.note);
     }
     if (command.verb === 'candidates') {
-        const loaded = await loadMergeState(io, home);
+        const loaded = await load();
         const rows = command.retry === true ? loaded.state.rows.filter(row => row.state === 'approved') : loaded.state.rows;
         return withNote(formatQueue(rows, command.retry === true ? 'fuse' : 'verify'), loaded.note);
     }
     if (command.verb === 'skipped') {
-        const loaded = await loadMergeState(io, home);
+        const loaded = await load();
         return withNote(formatQueue(loaded.state.rows, 'skipped'), loaded.note);
     }
     return null;

package/lib/types/scan-run.js

@@ -37,6 +37,8 @@ export async function runScan(options) {
     const stage = options.stage ?? (async () => { });
     const candidates = await options.ports.screening(options.signal);
     const before = await loadMergeState(options.io, options.home);
+    if (!before.ok)
+        throw new Error(before.note ?? 'merge-state-invalid');
     const queueBefore = { verify: 0, pending: 0, fuse: 0, skipped: 0 };
     for (const row of before.state.rows)
         queueBefore[row.queue] += 1;

package/lib/types/state.js

@@ -16,7 +16,7 @@ export function mergeStatePath(home) {
 function parseState(raw) {
     const parsed = parseLedger(raw);
     if (!parsed.ok)
-        return { ok: false, rows: [] };
+        return { ok: false, rows: [], ...(parsed.note === undefined ? {} : { note: parsed.note }) };
     return {
         ok: true,
         rows: parsed.ledger.rows,
@@ -46,6 +46,8 @@ export async function mutateMergeState(io, home, now, fn) {
     await transactIo(io, mergeStatePath(home), (current) => {
         ran = true;
         const parsed = parseState(current);
+        if (!parsed.ok || parsed.note === 'merge-state-forward-only')
+            throw new Error(parsed.note ?? 'merge-state-invalid');
         const out = fn(parsed.rows);
         result = out.result;
         return JSON.stringify({ schemaVersion: MERGE_STATE_VERSION, rows: out.rows }, null, 2);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-merge",
   "description": "Skill auto-merge domain: screening, two-round authoring, queues and commit orchestration (community build)",
-  "version": "0.30.15",
+  "version": "0.30.17",
   "publishConfig": {
     "access": "public"
   },
@@ -27,8 +27,8 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.5",
-    "@lmzhen/dsh-evolution-core": "^0.30.15",
-    "@lmzhen/dsh-evolution-merge-engine": "^0.30.15"
+    "@lmzhen/dsh-evolution-core": "^0.30.17",
+    "@lmzhen/dsh-evolution-merge-engine": "^0.30.17"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5"