@lmzhen/dsh-evolution-state-json 0.3.71 → 0.3.73

package/lib/index.js

@@ -175,7 +175,7 @@ async function ensureCorruptCopy(ctx, io, root, file, bad) {
 	}
 	return wrote;
 }
-async function jsonTransact(ctx, io, root, file, task) {
+async function jsonTransact(ctx, io, root, file, task, options) {
 	await transactIo(io(), join(root, file), async (current) => {
 		let parsed = null;
 		if (current !== null) {
@@ -194,9 +194,14 @@ async function jsonTransact(ctx, io, root, file, task) {
 				for (const [id, record] of Object.entries(parsed)) if (failing.some(([failedId]) => failedId === id)) bad[id] = record;
 				else good[id] = record;
 				reportGateViolation(ctx, file, failing);
-				if (await ensureCorruptCopy(ctx, io, root, file, bad)) parsed = good;
-				else ctx.logger.warn(`evolution-state-json: keeping ${failing.length} malformed record(s) in ${file} — the quarantine copy could not be written, so rewriting the file without them would destroy the only copy`);
-			}
+				if (await ensureCorruptCopy(ctx, io, root, file, bad)) {
+					parsed = good;
+					options?.onGateDrop?.(file, failing.map(([id]) => id));
+				} else {
+					options?.onGateDrop?.(file, []);
+					ctx.logger.warn(`evolution-state-json: keeping ${failing.length} malformed record(s) in ${file} — the quarantine copy could not be written, so rewriting the file without them would destroy the only copy`);
+				}
+			} else options?.onGateDrop?.(file, []);
 		}
 		const next = await task(parsed);
 		if (next !== null && RECORD_MAP_FILES.has(file) && !isPlainRecord(next)) throw writeGateError(`evolution state file "${file}" task returned ${Array.isArray(next) ? "an array" : typeof next} (expected null or a plain JSON object map of records); not written.`);
@@ -212,6 +217,13 @@ function apply(ctx, rawConfig = {}) {
 	if (rawConfig.root !== void 0 && rawConfig.root.trim() !== "" && !isAbsolute(rawConfig.root)) ctx.logger.warn(`evolution-state-json: config.root "${rawConfig.root}" is a relative path and resolves against the process CWD ("${root}") — pass an absolute path to make the store location launch-independent`);
 	const io = () => ctx.evolutionIo.provider();
 	const pathOf = (file) => join(root, file);
+	const gateDroppedCurrent = /* @__PURE__ */ new Set();
+	const noteGateDrop = (file, ids) => {
+		if (file !== PENDING_STATE_FILE) return;
+		gateDroppedCurrent.clear();
+		for (const id of ids) gateDroppedCurrent.add(id);
+	};
+	let warnedPendingCapacity = false;
 	async function readJson(file) {
 		const raw = await io().readText(pathOf(file));
 		if (raw === null) return null;
@@ -232,8 +244,13 @@ function apply(ctx, rawConfig = {}) {
 			else good[id] = record;
 			reportGateViolation(ctx, file, failing);
 			await ensureCorruptCopy(ctx, io, root, file, bad);
+			if (file === PENDING_STATE_FILE) {
+				gateDroppedCurrent.clear();
+				for (const id of Object.keys(bad)) gateDroppedCurrent.add(id);
+			}
 			return good;
 		}
+		if (file === PENDING_STATE_FILE) gateDroppedCurrent.clear();
 		return parsed;
 	}
 	const mutate = makeSerialQueue();
@@ -265,6 +282,7 @@ function apply(ctx, rawConfig = {}) {
 		for (const [id, record] of Object.entries(legacy)) {
 			if (id in (current ?? {})) continue;
 			if (archivedIds.has(id)) continue;
+			if (gateDroppedCurrent.has(id)) continue;
 			retired[id] = record;
 		}
 		return retired;
@@ -279,11 +297,12 @@ function apply(ctx, rawConfig = {}) {
 				for (const [id, record] of Object.entries(legacy)) {
 					if (id in merged) continue;
 					if (archivedIds.has(id)) continue;
+					if (gateDroppedCurrent.has(id)) continue;
 					merged[id] = record;
 					retired[id] = record;
 				}
 				return merged;
-			});
+			}, { onGateDrop: noteGateDrop });
 			await io().rename(pathOf(PENDING_LEGACY_FILE), `${pathOf(PENDING_LEGACY_FILE)}.migrated`);
 			legacyMigrated = true;
 			return retired;
@@ -464,10 +483,17 @@ function apply(ctx, rawConfig = {}) {
 		async savePending(record) {
 			await mutate(async () => {
 				await jsonTransact(ctx, io, root, PENDING_STATE_FILE, async (current) => {
-					return {
+					const map = {
 						...await mergedWithFilteredLegacy(legacyMigrated ? null : await readJson(PENDING_LEGACY_FILE), current ?? {}),
 						[record.id]: record
 					};
+					const liveCount = Object.values(map).filter((entry) => entry.status === "pending" || entry.status === "executing").length;
+					if (liveCount > PENDING_RESOLVED_CAP$1 && !warnedPendingCapacity) {
+						warnedPendingCapacity = true;
+						ctx.logger.warn(`evolution-state-json: ${liveCount} pending/executing staged records exceed the resolved cap (${PENDING_RESOLVED_CAP$1}) — they are never trimmed by design; resolve or reject them (/evolution pending) or the file keeps growing`);
+					}
+					if (liveCount <= PENDING_RESOLVED_CAP$1) warnedPendingCapacity = false;
+					return map;
 				});
 			});
 		},

package/lib/types/index.d.ts

@@ -14,6 +14,8 @@ export interface Config {
     root?: string;
 }
 export declare const Config: z<Config>;
-export declare function jsonTransact<T>(ctx: Context, io: () => EvolutionIoLike, root: string, file: string, task: (current: T | null) => T | null | Promise<T | null>): Promise<void>;
+export declare function jsonTransact<T>(ctx: Context, io: () => EvolutionIoLike, root: string, file: string, task: (current: T | null) => T | null | Promise<T | null>, options?: {
+    onGateDrop?: (file: string, ids: string[]) => void;
+}): Promise<void>;
 export declare function apply(ctx: Context, rawConfig?: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-state-json",
   "description": "JSON-file evolution state provider over the IO seam (community build)",
-  "version": "0.3.71",
+  "version": "0.3.73",
   "publishConfig": {
     "access": "public"
   },
@@ -31,18 +31,18 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.71"
+    "@lmzhen/dsh-evolution-core": "^0.3.73"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
     "@deepseek-ai/cordis": "^4.0.1",
-    "@lmzhen/dsh-evolution-io": "^0.3.71",
-    "@lmzhen/dsh-evolution-state-storage": "^0.3.71"
+    "@lmzhen/dsh-evolution-io": "^0.3.73",
+    "@lmzhen/dsh-evolution-state-storage": "^0.3.73"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-io": "^0.3.71",
-    "@lmzhen/dsh-evolution-state-storage": "^0.3.71",
-    "@lmzhen/dsh-evolution-io-node": "^0.3.71"
+    "@lmzhen/dsh-evolution-io": "^0.3.73",
+    "@lmzhen/dsh-evolution-state-storage": "^0.3.73",
+    "@lmzhen/dsh-evolution-io-node": "^0.3.73"
   }
 }