hikoutei 0.8.38 → 0.8.40

package/dist/api/Hikoutei.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Hikoutei.d.ts","sourceRoot":"","sources":["../../src/api/Hikoutei.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAEL,cAAc,EACd,KAAK,gCAAgC,EACtC,MAAM,aAAa,CAAC;AAYrB,sDAAsD;AACtD,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA2CD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,+BAA+B,EACzC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,gCAAgC,CAAC,EAClE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAChC,QAAQ,CAEV;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAmBlF;AAED;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,QAAQ,CAAC,CAkBnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,QAAQ,CAAC,CA8BnB"}
+{"version":3,"file":"Hikoutei.d.ts","sourceRoot":"","sources":["../../src/api/Hikoutei.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAEL,cAAc,EACd,KAAK,gCAAgC,EACtC,MAAM,aAAa,CAAC;AAuBrB,sDAAsD;AACtD,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA+QD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,+BAA+B,EACzC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,gCAAgC,CAAC,EAClE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAChC,QAAQ,CAEV;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAmBlF;AAED;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,QAAQ,CAAC,CAkBnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,QAAQ,CAAC,CA8BnB"}

package/dist/api/Hikoutei.js

@@ -11,16 +11,36 @@ import { createEntityManager } from "./internalEntityManager.js";
 import { HIKOUTEI_ERROR_CODES, HikouteiError } from "./errors.js";
 import { getRegisteredEntityTokens, } from "./entity.js";
 import { resolveEntityDescriptors, } from "./internalEntityRegistry.js";
+import { describeErrorForInternalLog, getHikouteiInternalLogger, logHikouteiInternalEvent, } from "../shared/observability/internalLog.js";
+import { HIKOUTEI_LOG_COMPONENTS, HIKOUTEI_LOG_EVENTS, } from "../shared/observability/logEvents.js";
+import { AsyncLocalStorage } from "node:async_hooks";
 /** Environment variable that supplies the default SQLite path. */
 const HIKOUTEI_DB_PATH_ENV = "HIKOUTEI_DB_PATH";
 /** SQLite path used when neither `dbName` nor the env var is set. */
 const DEFAULT_DB_PATH = "./hikoutei.sqlite";
+const beforeCloseHookContext = new AsyncLocalStorage();
 class HikouteiImpl {
     provider;
     beforeClose;
     /** Root entity manager; call `fork()` before request or job-local work. */
     em;
-    closed = false;
+    closeState = "open";
+    /**
+     * The single in-flight close attempt. Concurrent close() calls OUTSIDE
+     * the active beforeClose hook await this same promise, so cleanup runs
+     * exactly once per attempt and every caller observes the same outcome
+     * (single-flight). The shared promise represents the FULL close +
+     * process-logger-drain operation and settles only AFTER the drain
+     * completes (final safe step), so a close() that lands while the first
+     * attempt is still draining — including one arriving after
+     * performClose() succeeded but before the drain finished — awaits the
+     * SAME attempt until the drain is done instead of resolving early on
+     * the terminal marker or starting a second cleanup. A close() called
+     * from WITHIN the hook resolves immediately instead (MEDIUM 5:
+     * awaiting the pending attempt from the hook would self-deadlock). A
+     * failed attempt leaves the runtime retryable after the slot release.
+     */
+    closeAttempt;
     constructor(provider, descriptors, beforeClose) {
         this.provider = provider;
         this.beforeClose = beforeClose;
@@ -28,27 +48,200 @@ class HikouteiImpl {
     }
     /** Stops internal service work, then releases the local SQLite connection. */
     async close() {
-        if (this.closed)
+        // Concurrent callers share the single in-flight attempt. This check
+        // comes BEFORE the terminal fast path so a caller that arrives after
+        // performClose() succeeded but while the final logger drain is still
+        // running awaits the SAME attempt (which settles only after drain)
+        // instead of resolving early on the closed marker — the shared
+        // promise represents the full close + drain operation.
+        if (this.closeAttempt !== undefined) {
+            // MEDIUM 5: a close awaited from within the ACTIVE beforeClose hook
+            // of THIS runtime must not await the pending attempt — the attempt
+            // cannot settle until the hook returns, so awaiting it would
+            // self-deadlock. The call resolves immediately: the close is already
+            // in progress and owned by the outer caller, so the hook must not
+            // rely on the reentrant promise for completion. The exemption is
+            // scoped to the OWNING runtime (runtime identity in the context) AND
+            // to the hook's execution window (`active`): a close() on a
+            // DIFFERENT runtime made from inside the hook, or a close() from a
+            // DETACHED callback (setImmediate/promise continuation) that runs
+            // AFTER the hook's execution window ended, is an ordinary concurrent
+            // call and shares that runtime's in-flight attempt, observing its
+            // exact outcome (Luna: the flag is cleared in `finally`, so the
+            // detached callback cannot bypass the close/drain attempt). Callers
+            // OUTSIDE any hook (no context store) keep sharing the attempt too.
+            const marker = beforeCloseHookContext.getStore();
+            if (marker !== undefined && marker.runtime === this && marker.active) {
+                return;
+            }
+            return this.closeAttempt;
+        }
+        // A successful close is terminal and idempotent: later calls resolve
+        // immediately without touching the provider again.
+        if (this.closeState === "closed")
             return;
-        this.closed = true;
-        let beforeCloseError;
+        let settleAttempt = () => { };
+        const attempt = new Promise((resolve, reject) => {
+            settleAttempt = (outcome) => {
+                if (outcome.ok)
+                    resolve();
+                else
+                    reject(outcome.error);
+            };
+        });
+        this.closeAttempt = attempt;
+        // The shared attempt is observed by concurrent callers outside the
+        // hook; when none exists, a failed attempt must not surface as an
+        // unhandled rejection. The no-op side handler marks the rejection
+        // handled for the runtime while those callers still receive the
+        // original rejection.
+        attempt.catch(() => undefined);
+        // The attempt's outcome is decided ONLY after the process logger
+        // drain completes (final safe step): the shared promise represents
+        // the full close + drain operation, so a concurrent caller awaiting
+        // it (including one that arrived while the drain was running) cannot
+        // proceed before every final event is on disk.
+        let failed = false;
+        let failure;
         try {
-            await this.beforeClose?.();
+            await this.performClose();
         }
         catch (error) {
-            beforeCloseError = error;
+            // Boolean flag, never `error !== undefined`: a hook or provider
+            // that throws `undefined` is still a FAILED attempt and the shared
+            // promise must reject, never resolve.
+            failed = true;
+            failure = error;
         }
         try {
-            await this.provider.close();
+            // The soak collector reads the log file immediately after close();
+            // drain the process logger queue so every final event (including
+            // RUNTIME_CLOSED and any close-failure line) is on disk before the
+            // attempt settles. Drain is fail-open by contract, and even a
+            // throwing drain must never mask the close outcome — it is
+            // swallowed, never propagated.
+            await getHikouteiInternalLogger().drain();
+        }
+        catch {
+            // Fail-open: the drain exists to flush diagnostics, so its failure
+            // must not change the close outcome decided above.
+        }
+        // Settle the shared attempt with the ORIGINAL outcome so every
+        // concurrent caller observes exactly the same success or failure.
+        if (failed) {
+            settleAttempt({ ok: false, error: failure });
         }
-        catch (providerError) {
-            if (beforeCloseError !== undefined) {
-                throw new AggregateError([beforeCloseError, providerError], "Hikoutei failed to stop internal work and close SQLite.");
+        else {
+            settleAttempt({ ok: true });
+        }
+        // Release the shared slot only after the attempt settled (final safe
+        // step). On success performClose() made the close terminal; on
+        // failure performClose() already returned the state to retryable
+        // "open", so the NEXT close() call after the slot release genuinely
+        // re-runs the cleanup. The original failure is rethrown unchanged to
+        // THIS caller after the slot release; concurrent callers already
+        // received it through the shared attempt.
+        this.closeAttempt = undefined;
+        if (failed)
+            throw failure;
+    }
+    /**
+     * Runs one full cleanup attempt (beforeClose + provider close).
+     *
+     * Marks the runtime terminally closed ONLY after the provider close
+     * succeeded. EVERY failure — a throwing beforeClose hook, a throwing
+     * provider close, or the aggregate of both — explicitly returns the
+     * state to retryable `open` before the original error is rethrown
+     * unchanged, so the next close() call genuinely re-runs the full
+     * cleanup instead of no-oping on a half-closed runtime.
+     */
+    async performClose() {
+        this.closeState = "closing";
+        try {
+            let beforeCloseFailed = false;
+            let beforeCloseError;
+            try {
+                const beforeClose = this.beforeClose;
+                if (beforeClose !== undefined) {
+                    // MEDIUM 5: the hook runs inside the marked async context so a
+                    // close() called from within it is recognized as reentrant for
+                    // THIS runtime (and never awaits its own pending attempt). The
+                    // stored runtime identity scopes the exemption: a cross-runtime
+                    // close() made from the hook is not reentrant.
+                    //
+                    // Luna: the exemption is scoped to the hook's EXECUTION WINDOW.
+                    // Detached setImmediate/promise callbacks scheduled by the hook
+                    // retain the AsyncLocalStorage store after run() returns, so the
+                    // active flag is cleared in `finally` once the hook's execution
+                    // has ended — those callbacks' close() then awaits the same
+                    // close/drain attempt instead of bypassing it. The flag is
+                    // cleared even when the hook throws.
+                    const marker = { runtime: this, active: true };
+                    try {
+                        await beforeCloseHookContext.run(marker, () => beforeClose());
+                    }
+                    finally {
+                        marker.active = false;
+                    }
+                }
             }
-            throw providerError;
+            catch (error) {
+                // Boolean flag, never `error !== undefined`: a hook that throws
+                // `undefined` is still a FAILED hook and must keep the attempt
+                // failed and retryable instead of being treated as success.
+                beforeCloseFailed = true;
+                beforeCloseError = error;
+            }
+            try {
+                await this.provider.close();
+            }
+            catch (providerError) {
+                logHikouteiInternalEvent({
+                    event: HIKOUTEI_LOG_EVENTS.RUNTIME_CLOSE_FAILED,
+                    level: "error",
+                    component: HIKOUTEI_LOG_COMPONENTS.RUNTIME,
+                    ...describeErrorForInternalLog(providerError),
+                });
+                if (beforeCloseFailed) {
+                    // Luna: the AggregateError preserves BOTH original failure
+                    // values as-thrown — including a hook that throws `undefined`
+                    // or `null`, which are legitimate thrown values. The errors
+                    // array must never replace the original hook failure with a
+                    // synthetic Error, so diagnostics can always inspect exactly
+                    // what each stage threw.
+                    throw new AggregateError([beforeCloseError, providerError], "Hikoutei failed to stop internal work and close SQLite.");
+                }
+                throw providerError;
+            }
+            if (beforeCloseFailed) {
+                logHikouteiInternalEvent({
+                    event: HIKOUTEI_LOG_EVENTS.RUNTIME_CLOSE_FAILED,
+                    level: "error",
+                    component: HIKOUTEI_LOG_COMPONENTS.RUNTIME,
+                    ...describeErrorForInternalLog(beforeCloseError),
+                });
+                // `throw beforeCloseError` is intentional: `undefined` is a
+                // legitimate thrown value and the rejection still marks the
+                // attempt failed (the caller's catch below returns the state to
+                // retryable open).
+                throw beforeCloseError;
+            }
+            this.closeState = "closed";
+            logHikouteiInternalEvent({
+                event: HIKOUTEI_LOG_EVENTS.RUNTIME_CLOSED,
+                level: "info",
+                component: HIKOUTEI_LOG_COMPONENTS.RUNTIME,
+            });
+        }
+        catch (error) {
+            // Explicit state transition for EVERY failure path (beforeClose or
+            // provider): the runtime returns to retryable `open` so the next
+            // close() re-runs the cleanup. The original error is rethrown
+            // unchanged; the shared-attempt slot was already released by the
+            // caller's finally block.
+            this.closeState = "open";
+            throw error;
         }
-        if (beforeCloseError !== undefined)
-            throw beforeCloseError;
     }
 }
 /**

package/dist/api/Hikoutei.js.map

@@ -1 +1 @@
-{"version":3,"file":"Hikoutei.js","sourceRoot":"","sources":["../../src/api/Hikoutei.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Hikoutei.js","sourceRoot":"","sources":["../../src/api/Hikoutei.ts"],"names":[],"mappings":"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"}

package/dist/application/sync/service/SyncServiceBootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SyncServiceBootstrap.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/service/SyncServiceBootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAoCH,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAChC,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,CA4G9B"}
+{"version":3,"file":"SyncServiceBootstrap.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/service/SyncServiceBootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAyCH,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAChC,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,CA4H9B"}

package/dist/application/sync/service/SyncServiceBootstrap.js

@@ -29,6 +29,7 @@ import { createRemoteProvider } from "./remoteProvider.js";
 import { createEffectSupervisor } from "./effectSupervisor.js";
 import { createPollingSupervisor } from "./pollingSupervisor.js";
 import { createStopHandler, expireRuntimeWriterLeases } from "./shutdown.js";
+import { registerSystemStateReadiness, unregisterSystemStateReadiness, } from "./systemStateReadiness.js";
 import { createWriterOptions, throwSyncResolutionError, validateServiceOptions, } from "./serviceOptions.js";
 /**
  * Opens, provisions, and starts one internal sync service.
@@ -94,7 +95,23 @@ export async function createInternalSyncService(options) {
             effectSupervisor,
         });
         const provider = new MikroOrmScalarPersistenceProvider(runtime.storage, generated.bindings, runtime.flushCoordinator);
-        const hikoutei = createInternalHikoutei(provider, descriptors, stop);
+        // The runtime object is the readiness key: the beforeClose hook runs
+        // only after this assignment, so the captured reference is always the
+        // fully constructed runtime. Unregistering happens BEFORE the stop
+        // handler runs, so a closing runtime reports ready (no outbox to drain)
+        // the moment its close begins.
+        let hikoutei;
+        const hikouteiClose = async () => {
+            unregisterSystemStateReadiness(hikoutei);
+            await stop();
+        };
+        hikoutei = createInternalHikoutei(provider, descriptors, hikouteiClose);
+        // Register the runtime's System_State readiness right after bootstrap so
+        // external convergence barriers can wait on the drain; the runtime is
+        // unregistered on close (see hikouteiClose). Never part of the public
+        // API — the registration is keyed to the internal/public runtime object
+        // and read only through this internal module.
+        registerSystemStateReadiness(hikoutei, runtime.storage);
         effectSupervisor.start();
         pollingSupervisor.start();
         return {

package/dist/application/sync/service/SyncServiceBootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"SyncServiceBootstrap.js","sourceRoot":"","sources":["../../../../src/application/sync/service/SyncServiceBootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SyncServiceBootstrap.js","sourceRoot":"","sources":["../../../../src/application/sync/service/SyncServiceBootstrap.ts"],"names":[],"mappings":"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"}

package/dist/application/sync/service/systemStateReadiness.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Internal System_State readiness controller for external convergence
+ * barriers.
+ *
+ * External tooling (for example the local multi-table soak runner's live
+ * convergence phase) needs to know when a runtime's System_State outbox
+ * drain has finished so its own batched sheet reads do not compete with
+ * the initial drain on the shared request limiter. The sync service
+ * registers every runtime it bootstraps here and unregisters it when the
+ * runtime closes; a runtime that was never registered (plain local-only
+ * mode, or an already-closed runtime) reports ready immediately.
+ *
+ * This module is deliberately internal: it is never re-exported from
+ * `src/index.ts`, and applications observe readiness only through the
+ * library's own behavior.
+ */
+import type { Hikoutei } from "../../../api/Hikoutei.js";
+import type { MikroOrmSqliteAdapter } from "../../../adapter/persistence/providers/mikro-orm/storage/MikroOrmSqliteAdapter.js";
+import { type SystemStateDrainReadiness } from "@hikoutei/ikisaki";
+/** Registers one bootstrapped runtime for readiness queries. */
+export declare function registerSystemStateReadiness(runtime: Hikoutei, storage: MikroOrmSqliteAdapter): void;
+/** Unregisters one runtime (called on close, before storage is released). */
+export declare function unregisterSystemStateReadiness(runtime: Hikoutei): void;
+/**
+ * Reports the CURRENT System_State drain readiness of one runtime.
+ *
+ * Only the System_State projection's claimable in-flight effects are
+ * considered — never the whole-outbox idle state. A pending follower behind
+ * a conflict/blocked_candidate/failed predecessor is not claimable drain
+ * work and never defers, so an open conflict cannot stall the barrier. A
+ * runtime without a registered sync service (local-only mode, or already
+ * closed) has no outbox to drain and is ready immediately.
+ */
+export declare function readRuntimeSystemStateReadiness(runtime: Hikoutei): Promise<SystemStateDrainReadiness>;
+//# sourceMappingURL=systemStateReadiness.d.ts.map

package/dist/application/sync/service/systemStateReadiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemStateReadiness.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/service/systemStateReadiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mFAAmF,CAAC;AAC/H,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,mBAAmB,CAAC;AAiB3B,gEAAgE;AAChE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAEN;AAED,6EAA6E;AAC7E,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAEtE;AAED;;;;;;;;;GASG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,yBAAyB,CAAC,CAIpC"}

package/dist/application/sync/service/systemStateReadiness.js

@@ -0,0 +1,51 @@
+/**
+ * Internal System_State readiness controller for external convergence
+ * barriers.
+ *
+ * External tooling (for example the local multi-table soak runner's live
+ * convergence phase) needs to know when a runtime's System_State outbox
+ * drain has finished so its own batched sheet reads do not compete with
+ * the initial drain on the shared request limiter. The sync service
+ * registers every runtime it bootstraps here and unregisters it when the
+ * runtime closes; a runtime that was never registered (plain local-only
+ * mode, or an already-closed runtime) reports ready immediately.
+ *
+ * This module is deliberately internal: it is never re-exported from
+ * `src/index.ts`, and applications observe readiness only through the
+ * library's own behavior.
+ */
+import { readSystemStateDrainReadinessWithAdapter, } from "@hikoutei/ikisaki";
+/**
+ * Registry of bootstrapped runtimes keyed by the runtime object itself.
+ *
+ * A WeakMap keeps the registry inert: a runtime that is garbage-collected
+ * without closing (or whose registration leaked) never pins its storage
+ * or SQLite file open, and the key is the exact public `Hikoutei` object
+ * the caller holds.
+ */
+const registeredRuntimes = new WeakMap();
+/** Registers one bootstrapped runtime for readiness queries. */
+export function registerSystemStateReadiness(runtime, storage) {
+    registeredRuntimes.set(runtime, { storage });
+}
+/** Unregisters one runtime (called on close, before storage is released). */
+export function unregisterSystemStateReadiness(runtime) {
+    registeredRuntimes.delete(runtime);
+}
+/**
+ * Reports the CURRENT System_State drain readiness of one runtime.
+ *
+ * Only the System_State projection's claimable in-flight effects are
+ * considered — never the whole-outbox idle state. A pending follower behind
+ * a conflict/blocked_candidate/failed predecessor is not claimable drain
+ * work and never defers, so an open conflict cannot stall the barrier. A
+ * runtime without a registered sync service (local-only mode, or already
+ * closed) has no outbox to drain and is ready immediately.
+ */
+export async function readRuntimeSystemStateReadiness(runtime) {
+    const entry = registeredRuntimes.get(runtime);
+    if (entry === undefined)
+        return { status: "ready" };
+    return readSystemStateDrainReadinessWithAdapter(entry.storage);
+}
+//# sourceMappingURL=systemStateReadiness.js.map

package/dist/application/sync/service/systemStateReadiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemStateReadiness.js","sourceRoot":"","sources":["../../../../src/application/sync/service/systemStateReadiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EACL,wCAAwC,GAEzC,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAA+B,CAAC;AAEtE,gEAAgE;AAChE,MAAM,UAAU,4BAA4B,CAC1C,OAAiB,EACjB,OAA8B;IAE9B,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,8BAA8B,CAAC,OAAiB;IAC9D,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAAiB;IAEjB,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACpD,OAAO,wCAAwC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACjE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hikoutei",
-  "version": "0.8.38",
+  "version": "0.8.40",
   "description": "Typed repository and safe write layer for Google Sheets-backed MVPs. SQLite-authoritative entity lifecycle with asynchronous Google Sheets projection.",
   "repository": {
     "type": "git",