@saihm/shm 0.0.0-stage → 0.38.0

package/dist/entitlement/entitlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlement.d.ts","sourceRoot":"","sources":["../../src/entitlement/entitlement.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAwE,CAAC;AAE9H,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEpE;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,eAAe,GAAG,gBAAgB,GAAG,aAAa,GAAG,cAAc,CAAC;AAEnH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBACb,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAOtF;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,8BAA8B,QAAS,CAAC;AASrD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,EAAE,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,WAAW,CAAC,CAiDvI"}

package/dist/entitlement/entitlement.js

@@ -0,0 +1,78 @@
+export const PAID_SUBSCRIPTION_TIERS = Object.freeze(["PRO", "PRO_FAST", "ENTERPRISE", "ENTERPRISE_FAST"]);
+export function isPaidSubscriptionTier(tier) {
+    return typeof tier === "string" && PAID_SUBSCRIPTION_TIERS.includes(tier);
+}
+export class EntitlementError extends Error {
+    code;
+    tier;
+    cause;
+    constructor(code, message, tier, cause) {
+        super(message);
+        this.name = "EntitlementError";
+        this.code = code;
+        this.tier = tier;
+        if (cause !== undefined)
+            this.cause = cause;
+    }
+}
+export const DEFAULT_ENTITLEMENT_TIMEOUT_MS = 15_000;
+const PREFIX = "SHM requires a paid SAIHM subscription (" + PAID_SUBSCRIPTION_TIERS.join(", ") + ")";
+const TIMED_OUT = Symbol("timed out");
+function shown(tier) {
+    return JSON.stringify(tier.length > 40 ? `${tier.slice(0, 40)}…` : tier);
+}
+export async function checkEntitlement(source, opts = {}) {
+    const noSource = () => new EntitlementError("no-source", `${PREFIX}; no subscription source was given to confirm one. Pass your SAIHM client (or McpSaihmClient) as \`entitlement\`.`);
+    if (typeof source !== "object" || source === null)
+        throw noSource();
+    let status;
+    try {
+        status = source.status;
+    }
+    catch (e) {
+        throw new EntitlementError("status-failed", `${PREFIX}; the subscription source could not be read, so none could be confirmed.`, undefined, e);
+    }
+    if (typeof status !== "function")
+        throw noSource();
+    const call = status;
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_ENTITLEMENT_TIMEOUT_MS;
+    if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new RangeError(`checkEntitlement: timeoutMs must be a positive finite number of milliseconds, got ${String(timeoutMs)}`);
+    }
+    let timer;
+    let tier;
+    let reportedStatus;
+    try {
+        const reported = await Promise.race([
+            Promise.resolve().then(() => call.call(source)),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(TIMED_OUT), timeoutMs);
+            }),
+        ]);
+        if (typeof reported === "object" && reported !== null && !Array.isArray(reported))
+            reportedStatus = reported;
+        tier = reportedStatus !== undefined ? reportedStatus["tier"] : undefined;
+    }
+    catch (e) {
+        if (e === TIMED_OUT) {
+            throw new EntitlementError("status-timeout", `${PREFIX}; the SAIHM status call did not answer within ${timeoutMs} ms, so none could be confirmed. ` +
+                "A first start of the SAIHM MCP server after an install or upgrade can take longer while it downloads: start it once beforehand, or raise entitlementTimeoutMs.");
+        }
+        throw new EntitlementError("status-failed", `${PREFIX}; the SAIHM status call failed, so none could be confirmed.`, undefined, e);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+    if (isPaidSubscriptionTier(tier)) {
+        return Object.freeze({ tier, checkedAt: (opts.now ?? (() => new Date()))().toISOString(), ...(reportedStatus !== undefined ? { status: reportedStatus } : {}) });
+    }
+    if (tier === "FREE") {
+        throw new EntitlementError("unpaid-tier", `${PREFIX}; this account's tier is FREE.`, tier);
+    }
+    if (typeof tier === "string") {
+        throw new EntitlementError("unknown-tier", `${PREFIX}; SAIHM reported the tier ${shown(tier)}, which this release does not recognise as paid.`, tier);
+    }
+    throw new EntitlementError("unknown-tier", `${PREFIX}; the SAIHM status carried no tier, so none could be confirmed.`);
+}
+//# sourceMappingURL=entitlement.js.map

package/dist/entitlement/entitlement.js.map

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

package/dist/entitlement/index.d.ts

@@ -0,0 +1,2 @@
+export { PAID_SUBSCRIPTION_TIERS, isPaidSubscriptionTier, checkEntitlement, EntitlementError, DEFAULT_ENTITLEMENT_TIMEOUT_MS, type SubscriptionSource, type Entitlement, type EntitlementRefusal, type CheckEntitlementOptions, } from "./entitlement.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/entitlement/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entitlement/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,8BAA8B,EAC9B,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC"}

package/dist/entitlement/index.js

@@ -0,0 +1,2 @@
+export { PAID_SUBSCRIPTION_TIERS, isPaidSubscriptionTier, checkEntitlement, EntitlementError, DEFAULT_ENTITLEMENT_TIMEOUT_MS, } from "./entitlement.js";
+//# sourceMappingURL=index.js.map

package/dist/entitlement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entitlement/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,8BAA8B,GAK/B,MAAM,kBAAkB,CAAC"}

package/dist/erasure/bus.d.ts

@@ -0,0 +1,18 @@
+import type { IndexEntry, SaihmReadPort } from "../saihm_client/types.js";
+export type ErasureListener = (cellId: string) => void | Promise<void>;
+export declare class ErasureBus {
+    private readonly listeners;
+    subscribe(listener: ErasureListener): () => void;
+    get subscriberCount(): number;
+    publish(cellIds: readonly string[]): Promise<void>;
+}
+export declare class ErasureDetector {
+    private readonly port;
+    private readonly bus;
+    private liveBaseline;
+    private primed;
+    constructor(port: SaihmReadPort, bus: ErasureBus);
+    prime(entries: readonly IndexEntry[]): void;
+    checkOnce(): Promise<string[]>;
+}
+//# sourceMappingURL=bus.d.ts.map

package/dist/erasure/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/erasure/bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvE,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IAExD,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAOhD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAEK,OAAO,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAezD;AAED,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,MAAM,CAAS;gBAGJ,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,UAAU;IAGlC,KAAK,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI;IAKrC,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAYrC"}

package/dist/erasure/bus.js

@@ -0,0 +1,56 @@
+export class ErasureBus {
+    listeners = new Set();
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    get subscriberCount() {
+        return this.listeners.size;
+    }
+    async publish(cellIds) {
+        const failures = [];
+        for (const cellId of cellIds) {
+            const snapshot = [...this.listeners];
+            const results = await Promise.allSettled(snapshot.map((fn) => (async () => fn(cellId))()));
+            for (const r of results) {
+                if (r.status === "rejected")
+                    failures.push(r.reason);
+            }
+        }
+        if (failures.length > 0) {
+            throw new AggregateError(failures, `erasure fan-out: ${failures.length} listener(s) failed`);
+        }
+    }
+}
+export class ErasureDetector {
+    port;
+    bus;
+    liveBaseline = new Set();
+    primed = false;
+    constructor(port, bus) {
+        this.port = port;
+        this.bus = bus;
+    }
+    prime(entries) {
+        this.liveBaseline = new Set(entries.filter((e) => !e.forgotten).map((e) => e.cellId));
+        this.primed = true;
+    }
+    async checkOnce() {
+        if (!this.primed)
+            throw new Error("ErasureDetector.checkOnce() before prime() — fail-closed");
+        const entries = await this.port.readIndex();
+        const nowLive = new Set(entries.filter((e) => !e.forgotten).map((e) => e.cellId));
+        const erased = [];
+        for (const id of this.liveBaseline) {
+            if (!nowLive.has(id))
+                erased.push(id);
+        }
+        if (erased.length > 0)
+            await this.bus.publish(erased);
+        this.liveBaseline = nowLive;
+        return erased;
+    }
+}
+//# sourceMappingURL=bus.js.map

package/dist/erasure/bus.js.map

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

package/dist/erasure/changes_feed.d.ts

@@ -0,0 +1,125 @@
+import { type ResolveFeedPathInput } from "./feed_watcher.js";
+export declare const CHANGES_VERSION: 1;
+export declare const CHANGES_FILENAME = "changes.ndjson";
+export interface CellWrittenLine {
+    readonly v: 1;
+    readonly kind: "cell-written";
+    readonly cellId: string;
+    readonly agentIdHash: string;
+    readonly at: string;
+    readonly atMs: number;
+    readonly seq: string;
+    readonly commitment: string;
+    readonly source: string;
+}
+export interface ChangesMarkerLine {
+    readonly v: 1;
+    readonly kind: "position" | "gap";
+    readonly agentIdHash: string;
+    readonly at: string;
+    readonly atMs: number;
+    readonly cursor: string;
+    readonly reason?: string;
+}
+export type ChangesLine = CellWrittenLine | ChangesMarkerLine;
+export type ChangesFaultOutcome = "malformed" | "foreign" | "ignored";
+export type ChangesLineVerdict = {
+    readonly ok: true;
+    readonly line: ChangesLine;
+} | {
+    readonly ok: false;
+    readonly outcome: ChangesFaultOutcome;
+    readonly reason: string;
+};
+export declare function parseChangesLine(raw: string, expectIdentity?: string): ChangesLineVerdict;
+export declare function resolveChangesPath(i: ResolveFeedPathInput): string;
+export declare function compareSeq(a: string, b: string): number;
+export interface FeedPoint {
+    readonly ino: number;
+    readonly bytes: number;
+}
+export interface OwedRefetch {
+    readonly cellId: string;
+    readonly seq: string;
+    readonly commitment: string;
+}
+export interface ReconcileTicket {
+    readonly through: number;
+}
+export interface ChangesOwed {
+    readonly refetch: readonly OwedRefetch[];
+    readonly reconcile: ReconcileTicket | null;
+}
+export interface ChangesTrackerStatus {
+    readonly linesObserved: number;
+    readonly markersPending: number;
+    readonly escalatedToGap: number;
+    readonly unreadable: number;
+    readonly appliedCursor: string | null;
+}
+export declare class ChangesTracker {
+    private order;
+    private readonly writes;
+    private markers;
+    private consumed;
+    private applied;
+    private escalated;
+    private unreadableLines;
+    private readonly issued;
+    observe(line: ChangesLine, feedNow: FeedPoint | null): void;
+    observeUnreadable(): void;
+    appliedWrite(cellId: string, seq: string): void;
+    erased(cellId: string): void;
+    erasureFeedConsumed(point: FeedPoint): void;
+    reconciled(ticket: ReconcileTicket): void;
+    owed(): ChangesOwed;
+    appliedCursor(): string | null;
+    status(): ChangesTrackerStatus;
+    private track;
+    private escalate;
+    private advance;
+    private holds;
+}
+export interface HeldVersion {
+    readonly seq: string;
+    readonly commitment?: string;
+}
+export declare function heldCovers(line: {
+    readonly seq: string;
+    readonly commitment: string;
+}, held: HeldVersion | undefined): boolean;
+export type RefetchResult = {
+    readonly found: true;
+    readonly seq: string;
+} | {
+    readonly found: false;
+} | {
+    readonly failed: true;
+};
+export type RefetchOutcome = {
+    readonly kind: "applied";
+    readonly seq: string;
+} | {
+    readonly kind: "erased";
+} | {
+    readonly kind: "retry";
+    readonly reason: string;
+};
+export declare function decideRefetch(line: {
+    readonly seq: string;
+}, fetched: RefetchResult, erasureLineSeen: boolean): RefetchOutcome;
+export interface FeedHeartbeat {
+    readonly asOfMs: number | null;
+    readonly stopped: string | null;
+}
+export declare const DEFAULT_FEED_LIVENESS_MS = 60000;
+export type FeedLiveness = {
+    readonly live: true;
+    readonly ageMs: number;
+} | {
+    readonly live: false;
+    readonly why: "no-writer" | "unreadable" | "stopped" | "no-answer-yet" | "stale" | "clock";
+    readonly detail: string;
+};
+export declare function feedLiveness(heartbeat: FeedHeartbeat | "absent" | "unreadable", nowMs: number, maxAgeMs?: number): FeedLiveness;
+//# sourceMappingURL=changes_feed.d.ts.map

package/dist/erasure/changes_feed.d.ts.map

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

package/dist/erasure/changes_feed.js

@@ -0,0 +1,252 @@
+import { dirname, join } from "node:path";
+import { FEED_MAX_LINE_BYTES, HEX64, ISO_UTC, resolveFeedPath } from "./feed_watcher.js";
+export const CHANGES_VERSION = 1;
+export const CHANGES_FILENAME = "changes.ndjson";
+const DECIMAL = /^\d+$/;
+const GAP_REASON = /^[a-z][a-z-]{0,63}$/;
+export function parseChangesLine(raw, expectIdentity) {
+    const bad = (reason) => ({ ok: false, outcome: "malformed", reason });
+    if (Buffer.byteLength(raw, "utf8") > FEED_MAX_LINE_BYTES)
+        return bad(`line exceeds ${FEED_MAX_LINE_BYTES} bytes`);
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return bad("not JSON");
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+        return bad("not a JSON object");
+    const r = parsed;
+    if (r["v"] !== CHANGES_VERSION)
+        return bad(`v is not ${CHANGES_VERSION}`);
+    const kindRaw = r["kind"];
+    if (typeof kindRaw !== "string" || kindRaw === "")
+        return bad("kind missing or empty");
+    const kind = kindRaw === "written" ? "cell-written" : kindRaw;
+    const agentIdHash = r["agentIdHash"];
+    if (typeof agentIdHash !== "string" || !HEX64.test(agentIdHash))
+        return bad("agentIdHash is not a 64-hex hash");
+    const at = r["at"];
+    if (typeof at !== "string" || !ISO_UTC.test(at))
+        return bad("at is not an ISO-8601 UTC timestamp ending in Z");
+    const atMs = Date.parse(at);
+    if (!Number.isFinite(atMs))
+        return bad("at does not parse as a date");
+    if (expectIdentity !== undefined && agentIdHash !== expectIdentity) {
+        return { ok: false, outcome: "foreign", reason: "the line carries another identity's agentIdHash — a foreign line in a per-identity feed is a wiring fault" };
+    }
+    if (kind !== "cell-written" && kind !== "position" && kind !== "gap") {
+        return { ok: false, outcome: "ignored", reason: "a kind this reader does not know: skipped and counted, never applied" };
+    }
+    if (kind === "cell-written") {
+        const cellId = r["cellId"];
+        if (typeof cellId !== "string" || cellId === "")
+            return bad("cellId missing or empty");
+        const seq = r["seq"];
+        if (typeof seq !== "string" || !DECIMAL.test(seq))
+            return bad("seq is not a decimal string");
+        const commitment = r["commitment"];
+        if (typeof commitment !== "string" || !HEX64.test(commitment))
+            return bad("commitment is not a 64-hex hash");
+        const source = r["source"];
+        if (typeof source !== "string" || source === "")
+            return bad("source missing or empty");
+        return { ok: true, line: { v: 1, kind, cellId, agentIdHash, at, atMs, seq, commitment, source } };
+    }
+    const cursor = r["cursor"];
+    if (typeof cursor !== "string" || cursor === "")
+        return bad("cursor missing or empty");
+    const reason = r["reason"];
+    if (kind === "gap" && typeof reason === "string" && GAP_REASON.test(reason)) {
+        return { ok: true, line: { v: 1, kind, agentIdHash, at, atMs, cursor, reason } };
+    }
+    return { ok: true, line: { v: 1, kind, agentIdHash, at, atMs, cursor } };
+}
+export function resolveChangesPath(i) {
+    return join(dirname(resolveFeedPath(i)), CHANGES_FILENAME);
+}
+export function compareSeq(a, b) {
+    const x = BigInt(a), y = BigInt(b);
+    return x < y ? -1 : x > y ? 1 : 0;
+}
+export class ChangesTracker {
+    order = 0;
+    writes = new Map();
+    markers = [];
+    consumed = null;
+    applied = null;
+    escalated = 0;
+    unreadableLines = 0;
+    issued = new WeakSet();
+    observe(line, feedNow) {
+        const order = ++this.order;
+        if (line.kind === "cell-written") {
+            const cur = this.writes.get(line.cellId);
+            if (cur !== undefined && compareSeq(cur.seq, line.seq) >= 0)
+                return;
+            this.writes.set(line.cellId, { seq: line.seq, commitment: line.commitment, order });
+            return;
+        }
+        const m = {
+            kind: line.kind,
+            cursor: line.cursor,
+            order,
+            feedAt: line.kind === "position" ? feedNow : null,
+            readerInoAtMarker: this.consumed?.ino ?? null,
+            seenFeedIno: false,
+            confirmed: false,
+            reconciled: false,
+        };
+        if (m.kind === "position") {
+            if (feedNow === null) {
+                if (this.consumed === null)
+                    m.confirmed = true;
+                else
+                    this.escalate(m);
+            }
+            else if (this.consumed !== null) {
+                this.track(m, this.consumed);
+            }
+        }
+        this.markers.push(m);
+        this.advance();
+    }
+    observeUnreadable() {
+        const order = ++this.order;
+        this.unreadableLines++;
+        this.markers.push({ kind: "gap", cursor: null, order, feedAt: null, readerInoAtMarker: null, seenFeedIno: false, confirmed: false, reconciled: false });
+        this.advance();
+    }
+    appliedWrite(cellId, seq) {
+        const cur = this.writes.get(cellId);
+        if (cur !== undefined && compareSeq(seq, cur.seq) >= 0)
+            this.writes.delete(cellId);
+        this.advance();
+    }
+    erased(cellId) {
+        this.writes.delete(cellId);
+        this.advance();
+    }
+    erasureFeedConsumed(point) {
+        this.consumed = point;
+        for (const m of this.markers)
+            if (m.kind === "position" && !m.confirmed)
+                this.track(m, point);
+        this.advance();
+    }
+    reconciled(ticket) {
+        if (!this.issued.has(ticket))
+            return;
+        for (const m of this.markers)
+            if (m.kind === "gap" && m.order <= ticket.through)
+                m.reconciled = true;
+        for (const [id, w] of this.writes)
+            if (w.order < ticket.through)
+                this.writes.delete(id);
+        this.advance();
+    }
+    owed() {
+        const refetch = [...this.writes.entries()]
+            .sort((a, b) => a[1].order - b[1].order)
+            .map(([cellId, w]) => ({ cellId, seq: w.seq, commitment: w.commitment }));
+        let through = -1;
+        for (const m of this.markers)
+            if (m.kind === "gap" && !m.reconciled)
+                through = m.order;
+        let reconcile = null;
+        if (through >= 0) {
+            reconcile = Object.freeze({ through });
+            this.issued.add(reconcile);
+        }
+        return { refetch, reconcile };
+    }
+    appliedCursor() {
+        return this.applied;
+    }
+    status() {
+        return { linesObserved: this.order, markersPending: this.markers.length, escalatedToGap: this.escalated, unreadable: this.unreadableLines, appliedCursor: this.applied };
+    }
+    track(m, point) {
+        const feed = m.feedAt;
+        if (point.ino === feed.ino) {
+            m.seenFeedIno = true;
+            if (point.bytes >= feed.bytes)
+                m.confirmed = true;
+            return;
+        }
+        if (m.seenFeedIno || point.ino !== m.readerInoAtMarker)
+            this.escalate(m);
+    }
+    escalate(m) {
+        m.kind = "gap";
+        this.escalated++;
+    }
+    advance() {
+        let lastOk = -1;
+        for (let i = 0; i < this.markers.length; i++) {
+            if (!this.holds(this.markers[i]))
+                break;
+            lastOk = i;
+        }
+        if (lastOk < 0)
+            return;
+        for (let i = lastOk; i >= 0; i--) {
+            const c = this.markers[i].cursor;
+            if (c !== null) {
+                this.applied = c;
+                break;
+            }
+        }
+        this.markers = this.markers.slice(lastOk + 1);
+    }
+    holds(m) {
+        for (const w of this.writes.values())
+            if (w.order < m.order)
+                return false;
+        return m.kind === "gap" ? m.reconciled : m.confirmed;
+    }
+}
+export function heldCovers(line, held) {
+    if (held === undefined || !DECIMAL.test(held.seq) || !DECIMAL.test(line.seq))
+        return false;
+    const c = compareSeq(held.seq, line.seq);
+    if (c > 0)
+        return true;
+    return c === 0 && held.commitment !== undefined && held.commitment === line.commitment;
+}
+export function decideRefetch(line, fetched, erasureLineSeen) {
+    if ("failed" in fetched)
+        return { kind: "retry", reason: "the fetch failed" };
+    if (!fetched.found) {
+        return erasureLineSeen ? { kind: "erased" } : { kind: "retry", reason: "not served and no erasure line names it: unavailable, not erased" };
+    }
+    if (!DECIMAL.test(fetched.seq) || !DECIMAL.test(line.seq))
+        return { kind: "retry", reason: "the fetched version carries no readable seq" };
+    if (compareSeq(fetched.seq, line.seq) < 0)
+        return { kind: "retry", reason: "an older version than announced: a lagging copy, never applied" };
+    return { kind: "applied", seq: fetched.seq };
+}
+export const DEFAULT_FEED_LIVENESS_MS = 60_000;
+const FUTURE_SLACK_MS = 1_000;
+export function feedLiveness(heartbeat, nowMs, maxAgeMs = DEFAULT_FEED_LIVENESS_MS) {
+    if (!Number.isFinite(nowMs))
+        throw new RangeError("feedLiveness: nowMs must be a finite number of milliseconds");
+    if (!Number.isFinite(maxAgeMs) || maxAgeMs <= 0)
+        throw new RangeError("feedLiveness: maxAgeMs must be a positive finite number of milliseconds");
+    if (heartbeat === "absent")
+        return { live: false, why: "no-writer", detail: "no share-states.json: no writer is running" };
+    if (heartbeat === "unreadable")
+        return { live: false, why: "unreadable", detail: "share-states.json could not be read" };
+    if (heartbeat.stopped !== null)
+        return { live: false, why: "stopped", detail: "the writer says it stopped following the feed" };
+    if (heartbeat.asOfMs === null || !Number.isFinite(heartbeat.asOfMs))
+        return { live: false, why: "no-answer-yet", detail: "the writer has no answer from the service yet" };
+    const ageMs = nowMs - heartbeat.asOfMs;
+    if (ageMs < -FUTURE_SLACK_MS)
+        return { live: false, why: "clock", detail: "the heartbeat is later than this clock: it proves nothing" };
+    if (ageMs > maxAgeMs)
+        return { live: false, why: "stale", detail: `no answer from the service for more than ${maxAgeMs} ms` };
+    return { live: true, ageMs: Math.max(0, ageMs) };
+}
+//# sourceMappingURL=changes_feed.js.map

package/dist/erasure/changes_feed.js.map

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

package/dist/erasure/changes_reader.d.ts

@@ -0,0 +1,44 @@
+import { type ChangesLine, type ChangesTracker, type FeedPoint } from "./changes_feed.js";
+import { type FeedHead } from "./feed_watcher.js";
+export interface ChangesPosition {
+    readonly ino: number | null;
+    readonly offset: number;
+    readonly head?: FeedHead;
+}
+export type ChangesItem = {
+    readonly kind: "line";
+    readonly line: ChangesLine;
+} | {
+    readonly kind: "unreadable";
+    readonly outcome: "malformed" | "foreign" | "lost";
+    readonly reason: string;
+} | {
+    readonly kind: "ignored";
+};
+export interface ChangesRead {
+    readonly items: readonly ChangesItem[];
+    readonly position: ChangesPosition;
+}
+export interface ChangesReaderConfig {
+    readonly path: string;
+    readonly agentIdHash: string;
+    readonly start?: ChangesPosition | "end";
+}
+export declare class ChangesFileReader {
+    private readonly cfg;
+    private pos;
+    private pendingStart;
+    constructor(cfg: ChangesReaderConfig);
+    get position(): ChangesPosition;
+    read(): Promise<ChangesRead>;
+    private drainPredecessor;
+    private consume;
+    private headOf;
+    private headMatches;
+}
+export declare function applyChangesRead(tracker: ChangesTracker, read: ChangesRead, feedNow: FeedPoint | null): {
+    readonly lines: number;
+    readonly unreadable: number;
+    readonly ignored: number;
+};
+//# sourceMappingURL=changes_reader.d.ts.map

package/dist/erasure/changes_reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes_reader.d.ts","sourceRoot":"","sources":["../../src/erasure/changes_reader.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5G,OAAO,EAAiF,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEjI,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;CAC1B;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5G;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,KAAK,CAAC;CAC1C;AAID,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,YAAY,CAAsB;gBAEb,GAAG,EAAE,mBAAmB;IAMrD,IAAI,QAAQ,IAAI,eAAe,CAE9B;IAEK,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;YA4CpB,gBAAgB;YAkBhB,OAAO;YA4BP,MAAM;YAgBN,WAAW;CAc1B;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAczL"}