@serfab/cadre-core 0.12.0 → 1.0.0

package/dist/strand-membership-reconciler.js

@@ -0,0 +1,548 @@
+/**
+ * Strand membership reconciliation: the per-instance background loop that finishes a
+ * party's join at strand bring-up. Every machine of a party that runs a closed strand
+ * ends up with (1) the party's `Strand.Member` row seated — redeeming the
+ * formation-staged invitation if one is pending — and (2) its own durable
+ * machine→party binding (`Strand.MemberPeer`) written, which is what revocation
+ * enforcement and future admission control key on.
+ *
+ * ## Contract
+ *
+ * - **Never blocks or fails bring-up.** Armed by `StrandInstanceManager.buildStrandRuntime`
+ *   right after the strand database initializes (launch AND hibernation resume — the one
+ *   seam where a transport peer id and a live `Database` both exist), and every pass is
+ *   fully contained: a joiner at that instant has typically not synced the founder's rows
+ *   and may lack write quorum, so failure means "retry next tick", never a throw.
+ * - **Kicked the moment its database appears.** A joining machine's first pass runs while
+ *   the first-sync write gate still withholds `instance.database`, so it finds no database
+ *   and returns at once. `StrandInstanceManager.publishDatabase` calls `reconcile()` as it
+ *   hands the database to the app, which is what makes the join finish about a second after
+ *   the strand becomes writable rather than on the next timer.
+ * - **Retries fast while the join is unfinished, slowly while it is only waiting.** A pass
+ *   that leaves the join unfinished re-arms on a ladder starting at
+ *   {@link INITIAL_JOIN_RETRY_INTERVAL_MS} and doubling, capped at the configured poll
+ *   interval (default {@link DEFAULT_REVOCATION_POLL_INTERVAL_MS}; an embedder's
+ *   `revocationEnforcement.pollIntervalMs` is mirrored here by the instance manager). A pass
+ *   that finds no member row AND no staged invitation is not an unfinished join but a wait
+ *   for someone to admit this party — nothing this machine can do faster — so it re-arms on
+ *   the flat poll interval and resets the ladder. The loop stops on the done state.
+ * - **Done state**: the party's member row is visible locally AND this machine's own
+ *   binding is in place — the loop stops for good. A LATER revocation is the enforcer's
+ *   business, not this loop's; a resume rebuilds the reconciler and re-verifies from
+ *   scratch (every write is idempotent, so re-running is free).
+ *
+ * ## One pass
+ *
+ * 1. **Self-revocation check.** If the enforcer flags this node's own party as revoked,
+ *    stop rather than fight — re-admission arrives (if ever) via a fresh formation.
+ * 2. **Ensure membership.** Member row visible → done with this step; if a staged
+ *    invitation is still unspent, BURN it ({@link burnInvite} — the `ConsumedInvite` row
+ *    alone) so the bearer credential cannot be spent by anyone else, ignoring burn
+ *    failures beyond a log. Member row absent + staged invitation → {@link consumeInvite}
+ *    under the party's own key, retried across passes until the `Invite` row has
+ *    replicated here and the write commits. Absent with no invitation (founder rows not
+ *    yet synced, or a machine whose party never joined) → keep waiting, escalating to one
+ *    visible warning after {@link IDLE_PASSES_BEFORE_ESCALATION} passes, never throwing.
+ * 3. **Ensure the binding.** {@link registerMemberPeer} (insert-if-absent, restart-safe)
+ *    with this node's own strand transport peer id — only after step 2 sees the member
+ *    row locally (its deferred `MemberExists` reads the live local table).
+ *
+ * ## Terminal states (stop without done)
+ *
+ * - **Sealed strand**: `consumeInvite` rejected by `ConsumedInvite.NotSealed` — nobody
+ *   can ever be admitted, so retrying forever is noise. Terminal-with-log.
+ * - **Self-revoked** (step 1 above).
+ * - **Undecodable party key**: nothing can be signed; loud log, stop.
+ *
+ * A DEAD invitation that is not terminal for the loop — expired, cancelled, or already
+ * consumed by someone else (`ConsumedInvite`'s primary key) — is dropped with a log and
+ * the loop keeps idling: a fresh formation stages a new invitation, and a manager-side
+ * admission (`addMemberByManager`) seats the member row without one.
+ *
+ * ## Sharing the database with the app
+ *
+ * The strand `Database` this loop writes to is the one the app holds. Every write here
+ * passes `joinOpenTransaction: false`, so it runs as a transaction of its own and never
+ * joins one the app has open: the writer refuses with `StrandTransactionBusyError`, having
+ * written nothing, and the pass retries on the ladder. A busy refusal is never read as a
+ * dead invitation, and a busy burn leaves the invitation staged for the next pass.
+ *
+ * ## Half-committed join
+ *
+ * On a networked strand optimystic commits `Member` and `ConsumedInvite` as separate
+ * collections and can report that only some of them were saved (`CoordinatorPartialCommitError`,
+ * or the plugin's legacy `PartialCommitError`). When `ConsumedInvite` is saved and `Member` is
+ * not, the invitation is spent and the schema seats a `Member` through an invitation only in the
+ * same transaction as a fresh consumption, so this loop can never seat the party from it. Such a
+ * failure is recognised by TYPE before any message text is read (its message names the
+ * `ConsumedInvite` collection, which a text match once mistook for a dead invitation), reported
+ * with ONE `console.warn`, and the invitation is dropped. The loop keeps running like it does
+ * after a dead invitation: a manager admission, or a `Member` row that did land, is picked up by
+ * the next pass, which then writes the binding. Whether sereus should repair such a join itself
+ * is `blocked/strand-half-committed-join-recovery`.
+ */
+import debug from 'debug';
+import { CoordinatorPartialCommitError } from '@optimystic/db-core';
+import { PartialCommitError } from '@optimystic/quereus-plugin-optimystic';
+import { causeChain } from './control-retry.js';
+import { strandMemberKeyPair } from './strand-member-key.js';
+import { StrandTransactionBusyError, burnInvite, consumeInvite, isStrandMember, registerMemberPeer, } from './strand-membership-writer.js';
+import { DEFAULT_REVOCATION_POLL_INTERVAL_MS } from './strand-revocation-enforcer.js';
+import { defaultTimeoutScheduler } from './timeout-scheduler.js';
+const log = debug('sereus:cadre:strand-membership-reconciler');
+/**
+ * Idle passes (no member row, no staged invitation) before ONE `console.warn`
+ * escalation — at the default 30 s cadence, about five minutes of waiting. The loop
+ * keeps retrying quietly after it; the warning exists so a joiner stuck waiting on
+ * founder-row replication is visible without the debug namespace enabled.
+ */
+export const IDLE_PASSES_BEFORE_ESCALATION = 10;
+/**
+ * First retry delay, ms, for a pass that left the join UNFINISHED — a `consumeInvite`
+ * whose `Strand.Invite` row has not replicated to this machine yet, a cohort briefly
+ * unwritable, a database not yet published. Doubles per such pass up to the configured
+ * poll interval. Sized for what it retries: invite-row replication resolves in about a
+ * second over a direct connection and a few over a relay. The poll interval is NOT sized
+ * for that — it is the revocation enforcer's deny-set refresh cadence, mirrored here for
+ * the idle case (waiting to be admitted at all), which is why this ladder exists instead
+ * of a shorter interval.
+ */
+export const INITIAL_JOIN_RETRY_INTERVAL_MS = 1000;
+/** Every write this loop makes runs in a transaction of its own — see "Sharing the database with the app". */
+const OWN_TRANSACTION = { joinOpenTransaction: false };
+/**
+ * The `consumeInvite` rejection that means the strand is SEALED — `ConsumedInvite.NotSealed`
+ * fired, which Quereus renders `CHECK constraint failed: NotSealed (<its expression>)`.
+ * Terminal for a non-member: nobody can ever be admitted again.
+ */
+const SEALED_REJECTION = /CHECK constraint failed: NotSealed\b/;
+/**
+ * `consumeInvite` rejections that mean the INVITATION is dead but the loop should keep
+ * waiting for membership to arrive another way: expired (`CHECK constraint failed: NotExpired`),
+ * cancelled (`CHECK constraint failed: NotCancelled`), or already consumed by someone else
+ * (`UNIQUE constraint failed: ConsumedInvite.InviteKey`, the primary key).
+ *
+ * Anchored to the engine's full constraint-failure texts, not the bare names: other failures
+ * embed those names — a half-committed join's message names the `default/strand/ConsumedInvite`
+ * collection, which the bare `ConsumedInvite` this used to match read as a dead invitation. The
+ * texts are pinned against the real engine in `strand-membership-reconciler.spec.ts`, so a
+ * rewording in Quereus fails a spec instead of silently turning a dead invitation into an
+ * endless retry.
+ */
+const DEAD_INVITE_REJECTION = /CHECK constraint failed: (?:NotExpired|NotCancelled)\b|UNIQUE constraint failed: ConsumedInvite\.InviteKey\b/;
+/**
+ * Route a `consumeInvite` rejection. Typed checks run before any text check: a busy refusal
+ * (another transaction was open, so nothing ran) and a half-committed join are recognised by
+ * their error's type anywhere in the `cause` chain. The busy refusal carries Quereus's own
+ * refusal as its cause, and a half-committed join's message embeds collection names and the
+ * underlying failure's text, either of which a text matcher can misread. The sealed and
+ * dead-invitation checks then read the top-level message.
+ *
+ * A second loaded copy of `@optimystic/db-core` (or of the plugin) would fail `instanceof`; the
+ * half-commit then falls through the anchored texts to `retry`, and once the saved `ConsumedInvite`
+ * row is visible here a later attempt fails on its primary key and drops the invitation quietly —
+ * the old silent outcome, a few passes later, never a wrong write.
+ */
+export function classifyConsumeFailure(error) {
+    if (isTransactionBusy(error))
+        return { kind: 'busy' };
+    const halfCommitted = halfCommittedJoin(error);
+    if (halfCommitted)
+        return halfCommitted;
+    const message = errorMessage(error);
+    if (SEALED_REJECTION.test(message))
+        return { kind: 'sealed' };
+    if (DEAD_INVITE_REJECTION.test(message))
+        return { kind: 'dead-invite' };
+    return { kind: 'retry' };
+}
+/**
+ * The first partial-commit error in the `cause` chain, as the lists it reports.
+ *
+ * NOTE: `PartialCommitError` is imported from the plugin's root entry while strands register the
+ * plugin through its `/plugin` entry (`quereus-plugin-sereus`'s `compose-strand.ts`); the two are
+ * one class only because the plugin's build emits both entries over one shared chunk — the same
+ * dependency, and the same remedy if upstream ever bundles them apart, as the NOTE on
+ * `reportsPossiblyStoredWrite` in `control-write-retry.ts`.
+ */
+function halfCommittedJoin(error) {
+    for (const link of causeChain(error)) {
+        if (link instanceof CoordinatorPartialCommitError) {
+            return { kind: 'half-committed', saved: link.committedCollections, unsaved: link.failedCollections };
+        }
+        if (link instanceof PartialCommitError) {
+            return { kind: 'half-committed', saved: link.persisted, unsaved: link.unpersisted };
+        }
+    }
+    return undefined;
+}
+/** Whether a writer refused because another transaction was open (see "Sharing the database with the app"). */
+function isTransactionBusy(error) {
+    return causeChain(error).some((link) => link instanceof StrandTransactionBusyError);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * The per-strand membership reconciliation loop. Lifecycle mirrors
+ * `StrandRevocationEnforcer`: created in `StrandInstanceManager.buildStrandRuntime`
+ * (closed strands with a party key only), started right after the strand database
+ * initializes, stopped and dropped in `releaseRuntime` — so quiesce → resume rebuilds
+ * it and re-runs the (idempotent) ladder from scratch.
+ */
+export class StrandMembershipReconciler {
+    constructor(deps, config) {
+        this.deps = deps;
+        /** Tail of the pass chain — serializes passes (no two in flight). */
+        this.tail = Promise.resolve();
+        this.started = false;
+        this.stoppedFlag = false;
+        this.doneFlag = false;
+        this.idlePasses = 0;
+        this.idleEscalated = false;
+        /**
+         * Whether the pass that just ran found nothing to act on — no member row and no staged
+         * invitation. That is a wait to be admitted, not an unfinished join, so it re-arms on the
+         * flat poll interval; every other unfinished outcome climbs the ladder.
+         *
+         * NOTE: the ladder is therefore the DEFAULT for any outcome nobody classified — a new
+         * early return added to {@link doPass} inherits the fast retry unless it calls
+         * {@link noteIdlePass}. Right for every outcome that exists today (each is an unfinished
+         * join this machine can make progress on). If an early return is ever added for a
+         * condition retrying cannot resolve, classify it idle.
+         */
+        this.lastPassIdle = false;
+        this.scheduler = deps.scheduler ?? defaultTimeoutScheduler;
+        this.pollIntervalMs = config?.pollIntervalMs ?? DEFAULT_REVOCATION_POLL_INTERVAL_MS;
+    }
+    /** True once member row + own binding were both confirmed and the loop stopped. */
+    get done() {
+        return this.doneFlag;
+    }
+    /** True once the loop has stopped — done, terminal, or externally stopped. */
+    get stopped() {
+        return this.stoppedFlag;
+    }
+    /**
+     * Kick an immediate pass (not awaited — bring-up never blocks on it). Every later pass
+     * is armed only once the previous one settles — see the retry ladder in the module doc —
+     * so there is no repeating interval to arm here.
+     */
+    start() {
+        if (this.started || this.stoppedFlag)
+            return;
+        this.started = true;
+        void this.reconcile();
+        log('[%s] membership reconciler started (retry from %dms, idle poll %dms)', this.deps.label, Math.min(INITIAL_JOIN_RETRY_INTERVAL_MS, this.pollIntervalMs), this.pollIntervalMs);
+    }
+    /**
+     * Resolve once no pass is in flight. {@link stop} only disarms the retry TIMER — a pass
+     * already past its stopped check runs to completion, so a caller that must know the
+     * loop can no longer write (`StrandInstanceManager.clearOwnMemberPeerBinding`, which
+     * would otherwise have its removal undone by a racing `registerMemberPeer`) awaits
+     * this after stopping. Never rejects: the pass chain contains every failure.
+     */
+    async settle() {
+        await this.tail;
+    }
+    /** Disarm the retry timer; a pass already in flight completes but writes idempotently. */
+    stop() {
+        if (this.stoppedFlag)
+            return;
+        this.stoppedFlag = true;
+        this.clearTimer();
+        log('[%s] membership reconciler stopped%s', this.deps.label, this.doneFlag ? ' (done)' : '');
+    }
+    /**
+     * Run one pass now. Never rejects. Serialized: concurrent calls chain, so no two
+     * passes overlap and each explicit call gets a pass that STARTS after the call. On a
+     * started loop the pass re-arms the retry timer where it settles, so an explicit call —
+     * `StrandInstanceManager.publishDatabase`'s kick when a joiner's database is finally
+     * published — REPLACES the pending timer rather than running alongside it.
+     */
+    reconcile() {
+        // The catch is what keeps the chain alive. `doPass` contains its own failures, but its
+        // `finally` calls into the injected scheduler, and a throw from there would leave `tail`
+        // REJECTED — after which every later `reconcile()` short-circuits on it and the join
+        // stalls for good, silently. Swallowing it here makes the "never rejects" contract this
+        // method, {@link settle} and the two `void`-ed call sites all rely on structural rather
+        // than incidental.
+        const run = this.tail.then(() => this.doPass()).catch((error) => {
+            log('[%s] reconcile pass threw outside its own handler — the chain continues: %o', this.deps.label, error);
+        });
+        this.tail = run;
+        return run;
+    }
+    /** One serialized pass; contains every failure (contract: never rejects). */
+    async doPass() {
+        if (this.stoppedFlag || this.doneFlag)
+            return;
+        this.lastPassIdle = false;
+        try {
+            if (this.deps.isSelfRevoked?.() === true) {
+                // NOTE: "arrives via a fresh formation" is aspirational, not current behaviour.
+                // A fresh formation stages a new invitation (`adoptFormationMembershipInvite`)
+                // but does NOT re-arm this loop — `finish` latches `stoppedFlag` and `start()`
+                // early-returns on it, so only a strand relaunch (quiesce → resume, or a process
+                // restart) builds a reconciler that would redeem it. The same latch applies on the
+                // `done` path below, which is the case a REMOVED party actually hits: it finished
+                // its first join long before it was removed. Measured end to end in
+                // `strand-party-removal-via-formation-e2e.integration.ts` (test 2), tracked as
+                // `backlog/bug-removed-party-cannot-redeem-its-way-back`.
+                this.finish('this party is revoked from the strand — re-admission arrives (if ever) via a fresh formation');
+                return;
+            }
+            const keyPair = this.resolveKeyPair();
+            if (!keyPair)
+                return; // undecodable key already stopped the loop
+            const db = this.deps.getDatabase();
+            if (!db)
+                return; // no live database this instant (quiesce race) — next tick decides
+            if (!(await this.ensureMembership(db, keyPair)))
+                return;
+            // NOTE: the redemption (`Member` + `ConsumedInvite`) and the binding below are two
+            // SEPARATE commits — measured at 27 and 18 `/cluster` streams on 2026-09-17.
+            // One write batch could carry both (`MemberPeer.MemberExists`
+            // reads the LIVE `Member` table, and `MemberPeer.Authorized`'s add branch only verifies a
+            // self-signature over the new row), worth perhaps a third of that plus one commit
+            // round-trip. Left as two deliberately: the saving is unmeasured, and merging them merges
+            // their failure modes — today a redemption that lands but reports torn simply heals on the
+            // next pass, which sees the member row and proceeds to the binding. If a joiner's write
+            // cost ever shows up in a measurement, try the single transaction and measure against the
+            // 27 + 18 baseline.
+            await this.ensureBinding(db, keyPair);
+        }
+        catch (error) {
+            log('[%s] reconcile pass failed — retrying next tick: %o', this.deps.label, error);
+        }
+        finally {
+            this.scheduleNext();
+        }
+    }
+    /**
+     * Arm the next pass, now that this one has settled — so a slow pass never stacks ticks
+     * behind it. Only a STARTED loop schedules: a caller driving {@link reconcile} by hand
+     * (the unit tests, and the publish kick on a launch whose `start()` has not run yet) gets
+     * exactly the passes it asks for and no background timer.
+     */
+    scheduleNext() {
+        if (!this.started || this.stoppedFlag || this.doneFlag)
+            return;
+        this.clearTimer();
+        const delayMs = this.nextDelayMs();
+        this.timer = this.scheduler.setTimeout(() => {
+            this.timer = undefined;
+            void this.reconcile();
+        }, delayMs);
+    }
+    /**
+     * The delay before the next pass: the flat poll interval while the loop is merely idling
+     * (no member row, no staged invitation — {@link noteIdlePass}), otherwise the next rung
+     * of the doubling ladder from {@link INITIAL_JOIN_RETRY_INTERVAL_MS}, capped at the poll
+     * interval. A pass that lands idle resets the ladder, so a later unfinished join starts
+     * over at the bottom rung.
+     */
+    nextDelayMs() {
+        if (this.lastPassIdle) {
+            this.retryDelayMs = undefined;
+            return this.pollIntervalMs;
+        }
+        this.retryDelayMs = Math.min(this.retryDelayMs === undefined ? INITIAL_JOIN_RETRY_INTERVAL_MS : this.retryDelayMs * 2, this.pollIntervalMs);
+        return this.retryDelayMs;
+    }
+    clearTimer() {
+        if (this.timer !== undefined) {
+            this.scheduler.clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+    }
+    /**
+     * Step 2 of the pass: `true` iff the party's member row is visible locally by the
+     * time this returns (already present, or seated by redeeming the staged invitation).
+     */
+    async ensureMembership(db, keyPair) {
+        if (await isStrandMember(db, keyPair.publicKeyB64)) {
+            await this.burnLeftoverInvite(db, keyPair);
+            return true;
+        }
+        const invite = this.deps.pendingInvite?.get();
+        if (!invite) {
+            this.noteIdlePass();
+            return false;
+        }
+        try {
+            await consumeInvite(db, {
+                inviteKey: invite.inviteKey,
+                invitePrivateKey: invite.invitePrivateKey,
+                memberKey: keyPair.publicKeyB64,
+            }, OWN_TRANSACTION);
+        }
+        catch (error) {
+            this.handleConsumeFailure(error);
+            return false;
+        }
+        this.deps.pendingInvite?.clear();
+        log('[%s] redeemed the staged membership invitation — Member row seated under this party\'s key', this.deps.label);
+        return true;
+    }
+    /**
+     * The already-member arm: spend a still-staged invitation so nobody else can. Burn
+     * failures (already spent, cancelled, expired — or a racing seal) are logged and
+     * otherwise ignored, and the stage is cleared either way: with the member row
+     * present the invitation has no further local use, and keeping a possibly-dead
+     * credential staged would leave `getPendingMembershipInvite` lying. The one exception
+     * is a busy refusal (the app had a transaction open): nothing was tried, so the
+     * invitation stays staged and the next pass burns it.
+     *
+     * NOTE: accepted tradeoff — a burn that failed for a TRANSIENT reason is never
+     * retried, so that bearer credential stays spendable until it expires. Weighed and
+     * kept because it lands in the same state the strand already documents as normal
+     * ("removal does not cancel an unspent invitation", docs/strands.md) and retrying
+     * would mean keeping a dead-or-alive credential staged indefinitely. Revisit if
+     * unspent invitations ever become a real admission risk — which is when
+     * `feat-strand-member-allowlist-admission` lands.
+     */
+    async burnLeftoverInvite(db, keyPair) {
+        const pending = this.deps.pendingInvite;
+        const invite = pending?.get();
+        if (!pending || !invite)
+            return;
+        try {
+            await burnInvite(db, {
+                inviteKey: invite.inviteKey,
+                invitePrivateKey: invite.invitePrivateKey,
+                memberKey: keyPair.publicKeyB64,
+            }, OWN_TRANSACTION);
+            log('[%s] burned the leftover invitation (member row already present)', this.deps.label);
+        }
+        catch (error) {
+            if (isTransactionBusy(error)) {
+                log('[%s] burning the leftover invitation deferred — the app has a transaction open; it stays staged '
+                    + 'for the next pass', this.deps.label);
+                return;
+            }
+            log('[%s] burning the leftover invitation failed (already spent, cancelled, or expired) — dropping it: %o', this.deps.label, error);
+        }
+        pending.clear();
+    }
+    /**
+     * Step 3 of the pass: write this machine's own `MemberPeer` binding (insert-if-absent)
+     * and, on success, latch the done state and stop the loop. A missing transport peer id
+     * (a quiesce racing the pass) defers to the next tick; a write failure — a busy refusal
+     * included — is contained by the pass's outer catch and retried.
+     */
+    async ensureBinding(db, keyPair) {
+        const peerId = this.deps.getOwnPeerId();
+        if (!peerId) {
+            log('[%s] no live transport peer id this pass — binding deferred', this.deps.label);
+            return;
+        }
+        await registerMemberPeer(db, { memberKeyPair: keyPair, peerId }, OWN_TRANSACTION);
+        this.doneFlag = true;
+        this.finish('member row and own MemberPeer binding are both in place');
+    }
+    /**
+     * Act on a `consumeInvite` rejection as {@link classifyConsumeFailure} routes it: busy → keep
+     * the invitation and retry; half-committed → warn and drop; sealed → terminal; dead
+     * invitation → drop; anything else → retry.
+     */
+    handleConsumeFailure(error) {
+        const failure = classifyConsumeFailure(error);
+        switch (failure.kind) {
+            case 'busy':
+                log('[%s] redeeming the staged invitation deferred — the app has a transaction open on the strand '
+                    + 'database; retrying next tick', this.deps.label);
+                return;
+            case 'half-committed':
+                this.reportHalfCommittedJoin(failure, error);
+                return;
+            case 'sealed':
+                // The staged credential is dead with the seal; drop it so the cache stays honest.
+                this.deps.pendingInvite?.clear();
+                this.finish('the strand is sealed — nobody can ever be admitted, so the staged invitation is dead');
+                return;
+            case 'dead-invite':
+                // NOTE: accepted tradeoff — dropping a dead invitation does not mark the pass idle,
+                // so the next attempt is one ladder rung away rather than a full poll interval. Kept:
+                // the pass AFTER it finds no member row and no invitation, marks itself idle, and
+                // re-arms flat, so the cost is one extra read per dead credential. Revisit if a
+                // source of dead invitations ever repeats per pass.
+                log('[%s] the staged invitation is dead (expired, cancelled, or consumed elsewhere) — dropping it; '
+                    + 'a fresh formation stages a new one: %s', this.deps.label, errorMessage(error));
+                this.deps.pendingInvite?.clear();
+                return;
+            case 'retry':
+                log('[%s] consumeInvite failed — retrying next tick (Invite row not yet replicated here, or a transient '
+                    + 'write failure): %s', this.deps.label, errorMessage(error));
+                return;
+        }
+    }
+    /**
+     * A redemption only part of which was saved (see "Half-committed join" in the module doc):
+     * ONE visible warning naming both halves, and the staged invitation dropped. The pass is not
+     * marked idle, so the next one runs a ladder rung later and either finds a `Member` row (a
+     * saved one, or a manager's admission) and writes the binding, or idles flat.
+     *
+     * NOTE: the invitation is dropped whichever half was saved. In the observed shape
+     * (`ConsumedInvite` saved, `Member` not) it is spent and a retry could only fail on
+     * `ConsumedInvite`'s primary key. In the opposite shape (`Member` saved, `ConsumedInvite` not)
+     * keeping it would let the already-member arm burn it; dropping it leaves that bearer
+     * credential spendable until it expires — the state the burn arm's accepted tradeoff already
+     * lands in. Not branched on, because telling the shapes apart means parsing the lists, which
+     * are collection ids on the coordinator path but free-form tree labels on the plugin's legacy
+     * path. Revisit if a `Member`-saved half-commit is ever observed, or when
+     * `blocked/strand-half-committed-join-recovery` is decided.
+     */
+    reportHalfCommittedJoin(failure, error) {
+        console.warn(`[sereus] strand ${this.deps.label}: redeeming the staged membership invitation was only partly saved. `
+            + `Saved: [${failure.saved.join(', ')}]. Not saved: [${failure.unsaved.join(', ')}]. `
+            + 'The invitation is dropped: a saved ConsumedInvite row spends it, so it cannot be redeemed again. '
+            + 'If this party\'s Member row is not among the saved, the party is not a member of the strand and '
+            + 'cannot become one from this invitation — a manager must admit it directly (addMemberByManager). '
+            + 'The membership loop keeps checking and completes the join once a Member row for this party appears.');
+        log('[%s] half-committed redemption, full error: %o', this.deps.label, error);
+        this.deps.pendingInvite?.clear();
+        // The idle passes that follow are the wait this warning already explained; the escalation's
+        // "waiting on the founder rows to replicate" would be a second, misleading warning.
+        this.idleEscalated = true;
+    }
+    /** Decode the party key once; an undecodable key is terminal (nothing can be signed). */
+    resolveKeyPair() {
+        if (this.keyPair)
+            return this.keyPair;
+        try {
+            this.keyPair = strandMemberKeyPair(this.deps.partyMemberPrivateKey);
+        }
+        catch (error) {
+            this.finish(`the party membership key does not decode — nothing can be signed (${errorMessage(error)})`);
+            return undefined;
+        }
+        return this.keyPair;
+    }
+    /**
+     * Count a no-member/no-invitation pass; escalate to ONE visible warning at the bound.
+     *
+     * NOTE: an idling loop never gives up — a machine whose party is never admitted keeps
+     * polling for the life of the process, one `Strand.Member` scan per strand per
+     * interval (30 s by default). Negligible at the handful of strands a device runs and
+     * the handful of members a strand has; if a node ever runs strands by the hundred, or
+     * a strand's member set grows large, bound the idle phase (give up after N passes and
+     * surface it) rather than shortening the interval.
+     */
+    noteIdlePass() {
+        this.lastPassIdle = true;
+        this.idlePasses += 1;
+        if (this.idlePasses >= IDLE_PASSES_BEFORE_ESCALATION && !this.idleEscalated) {
+            this.idleEscalated = true;
+            console.warn(`[sereus] strand ${this.deps.label}: ${this.idlePasses} membership reconcile passes and still no `
+                + 'Member row for this party and no staged invitation — a joiner is waiting on the founder rows to '
+                + 'replicate (or on a manager admission). The loop keeps retrying quietly.');
+        }
+    }
+    /** Stop with a reason — the terminal and done paths' shared exit. */
+    finish(reason) {
+        log('[%s] membership reconciliation stopping: %s', this.deps.label, reason);
+        this.stop();
+    }
+}
+//# sourceMappingURL=strand-membership-reconciler.js.map

package/dist/strand-membership-reconciler.js.map

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