@lmzhen/dsh-evolution-core 0.1.0-rc.69 → 0.1.0-rc.70

package/lib/index.js

@@ -100,7 +100,7 @@ function nodeEvolutionIo() {
 			}
 			await new Promise((resolve) => setTimeout(resolve, 50));
 		}
-		throw new Error(`could not acquire write lock for ${path} after 10 attempts`);
+		throw new Error(`could not acquire write lock for ${path} after 40 attempts`);
 	};
 	return {
 		async readText(path) {
@@ -742,6 +742,11 @@ function isEventRecord(event) {
 * Parse an event log body. A missing file, a whitespace-only file (rc.69:
 * rebuildable, NOT malformed) or a corrupt one reads as empty; corrupt content
 * is still refused on append, never overwritten.
+*
+* Per-entry normalization (rc.70 F-1): entries without a numeric `seq` are
+* skipped here and dropped at the next append — valid entries survive, the
+* damaged record is the only loss (self-heal semantics, matching the usage
+* sidecar's per-field normalization on read).
 */
 function parseEvolutionEvents(raw) {
 	if (raw === null || raw.trim() === "") return [];
@@ -795,7 +800,7 @@ async function readEvolutionEvents(io, path) {
 		const parsed = JSON.parse(raw);
 		if (!Array.isArray(parsed.events)) return {
 			events: [],
-			malformed: true
+			malformed: false
 		};
 		return {
 			events: parsed.events.filter(isEventRecord),

package/lib/types/evolution-events.d.ts

@@ -30,6 +30,11 @@ export declare function eventsFile(home: string): string;
  * Parse an event log body. A missing file, a whitespace-only file (rc.69:
  * rebuildable, NOT malformed) or a corrupt one reads as empty; corrupt content
  * is still refused on append, never overwritten.
+ *
+ * Per-entry normalization (rc.70 F-1): entries without a numeric `seq` are
+ * skipped here and dropped at the next append — valid entries survive, the
+ * damaged record is the only loss (self-heal semantics, matching the usage
+ * sidecar's per-field normalization on read).
  */
 export declare function parseEvolutionEvents(raw: string | null): EvolutionEvent[];
 /**
@@ -41,7 +46,10 @@ export declare function parseEvolutionEvents(raw: string | null): EvolutionEvent
 export declare function appendEvolutionEvent(io: EvolutionIoLike, path: string, event: Omit<EvolutionEvent, 'seq' | 'at'>): Promise<number>;
 export interface EventLogRead {
     events: EvolutionEvent[];
-    /** True when the file existed but could not be parsed (loss case; never overwritten). */
+    /** True when the body is not valid JSON (syntax-level damage): refused on
+     * append, bytes untouched. Well-formed JSON with a damaged `events` field
+     * is REPLACEABLE garbage — reads as empty and is rewritten at the next
+     * append (rc.70 F-1: read and append agree on the same boundary). */
     malformed: boolean;
 }
 /** Read the event log; a missing/whitespace-only file reads as empty,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-core",
   "description": "Shared stores, prompts, signals and lifecycle logic for the dsh-evolution plugin family (community build)",
-  "version": "0.1.0-rc.69",
+  "version": "0.1.0-rc.70",
   "publishConfig": {
     "access": "public"
   },