@lmzhen/dsh-evolution-core 0.19.0 → 0.19.1

package/lib/index.js

@@ -6100,8 +6100,27 @@ function newRunRegistry(options) {
 			};
 			let converged = 0;
 			let liveElsewhere = 0;
+			let healed = 0;
 			for (const record of parsed.records) {
-				if (records.some((item) => item.id === record.id)) continue;
+				const knownIndex = records.findIndex((item) => item.id === record.id);
+				if (knownIndex >= 0) {
+					const known = records[knownIndex];
+					if (!controllers.has(record.id) && !TERMINAL.has(known.state)) {
+						if (TERMINAL.has(record.state)) {
+							records[knownIndex] = record;
+							healed++;
+						} else if (record.pid === void 0 || !isProcessAlive(record.pid)) {
+							records[knownIndex] = {
+								...record,
+								state: "failed",
+								endedAt: now(),
+								failure: "no live owner process — the run was interrupted before it settled (orphan)"
+							};
+							converged++;
+						}
+					}
+					continue;
+				}
 				if (record.state !== "running") {
 					records.push(record);
 					continue;
@@ -6119,18 +6138,19 @@ function newRunRegistry(options) {
 					failure: "no live owner process — the run was interrupted before it settled (orphan)"
 				});
 			}
-			if (converged > 0) await persist();
+			if (converged > 0 || healed > 0) await persist();
 			const notes = [
 				parsed.note,
 				converged > 0 ? `${converged} run(s) with no live owner were recorded as failed(orphan)` : void 0,
-				liveElsewhere > 0 ? `${liveElsewhere} run(s) are in flight in another process sharing this home` : void 0
+				liveElsewhere > 0 ? `${liveElsewhere} run(s) are in flight in another process sharing this home` : void 0,
+				healed > 0 ? `${healed} run(s) settled by their owner were re-read from the index` : void 0
 			].filter((note) => note !== void 0);
 			return {
 				ok: true,
 				...notes.length > 0 ? { note: notes.join("; ") } : {}
 			};
 		},
-		begin(kind) {
+		async begin(kind) {
 			const id = randomUUID();
 			const startedAt = now();
 			const controller = new AbortController();
@@ -6142,7 +6162,7 @@ function newRunRegistry(options) {
 				startedAt,
 				pid: process.pid
 			});
-			persist();
+			await persist();
 			return {
 				id,
 				kind,

package/lib/types/run-registry.d.ts

@@ -65,13 +65,23 @@ export interface RunOutcome {
 }
 /** The registry surface the commands row drives. */
 export interface RunRegistry {
-    /** Converge the persisted index once at mount; see the module doc. */
+    /**
+     * Converge the persisted index; the commands row calls it before answering any read
+     * (0.19.1: it also re-reads a terminal state written by the run's OWNER — see the
+     * implementation note below).
+     */
     load(): Promise<{
         ok: boolean;
         note?: string;
     }>;
-    /** Register a new run, arm its cancellation, and return its handle. */
-    begin(kind: RunKind): RunHandle;
+    /**
+     * Register a new run, arm its cancellation, and return its handle.
+     *
+     * Resolves only once the row is in the shared index (0.19.1, review P2): the detached
+     * lifetime starts when the caller answers "started", so a plane that reads that answer
+     * must find the run. The cost is one local index write on the ack path (milliseconds).
+     */
+    begin(kind: RunKind): Promise<RunHandle>;
     /** Record a run's terminal state (first writer wins). */
     settle(id: string, outcome: RunOutcome): Promise<void>;
     /** The live run, when there is one (one kind today — see the implementation note). */

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.19.0",
+  "version": "0.19.1",
   "publishConfig": {
     "access": "public"
   },