light-plan 0.0.0-stage → 0.1.0

package/dist/remote/ledger.js

@@ -0,0 +1,148 @@
+/**
+ * The ledger — which remote owns which document, across every declared remote.
+ *
+ * A board may declare several remotes, and each keeps its own correspondence
+ * store (`.lpm/remotes/<name>/links.json`). Read one at a time they answer "is
+ * LP-12 on *this* tracker?"; nothing answered the question a person actually
+ * asks, which is **"where does LP-12 live?"** — and nothing stopped the same
+ * document being filed onto two trackers at once. Two twins of one story is not
+ * a mirror of a plan: a status moves on one side, the other keeps its own, and
+ * the next sync of each writes a different truth back onto the same document.
+ *
+ * So: **one document, one remote, at a time.** This module is the whole of that
+ * rule. It is deliberately a *derived* index rather than a file of its own —
+ * built by reading the stores that already exist, in the same spirit as the
+ * dependency inverses the engine derives at load. A committed `ledger.json`
+ * would be a second copy of a fact the link stores already hold, free to
+ * disagree with them after a merge, and needing its own repair pass to say
+ * which copy was right. There is nothing to repair here: the stores *are* the
+ * ledger.
+ *
+ * Where it is enforced, and what happens:
+ *
+ *   - `lpm remote push` — a document another remote owns is never created a
+ *     second time. It is reported in the plan's `skipped` list with the reason
+ *     `owned_elsewhere` and the key it already has, exactly as a decoupled
+ *     document is reported, so a whole-board push to a second remote is a
+ *     readable report rather than a refusal or a duplicate.
+ *   - `lpm remote link` — adopting a twin for a document that already has one
+ *     elsewhere is refused outright, because it is one explicit document and
+ *     the person is asking for the thing the rule forbids.
+ *
+ * Nothing here writes. The remedy — `lpm remote decouple <id>` on the remote
+ * that holds it — is the operator's, and is named in every message.
+ */
+import { remoteNamed, remoteNames } from '../core/config/lookup.js';
+import { BoardError } from '../core/errors.js';
+import { loadLinkStore } from './links.js';
+/**
+ * Build the ledger by reading every declared remote's link store.
+ *
+ * A remote whose store does not exist yet contributes nothing (the first sync
+ * creates it). A document that somehow appears in two stores — a hand-edited
+ * file, a merge that took both sides — is reported by `conflicts()` rather than
+ * silently resolved: this is a read, and picking a winner is not its call.
+ */
+export function buildLedger(paths, config) {
+    const byLocalId = new Map();
+    const byRemote = new Map();
+    for (const name of remoteNames(config)) {
+        const provider = remoteNamed(config, name)?.provider ?? name;
+        const store = loadLinkStore(paths, name);
+        const entries = [];
+        for (const [localId, link] of store.links) {
+            const entry = {
+                localId,
+                remote: name,
+                provider,
+                remoteId: link.remoteId,
+                remoteKey: link.remoteKey,
+                remoteUrl: link.remoteUrl,
+                syncedAt: link.syncedAt,
+            };
+            entries.push(entry);
+            // First writer wins the index; `conflicts` reports the rest, so a board
+            // in this state is told about it rather than quietly given an answer.
+            if (!byLocalId.has(localId))
+                byLocalId.set(localId, entry);
+        }
+        entries.sort((a, b) => a.localId.localeCompare(b.localId));
+        byRemote.set(name, entries);
+    }
+    return { byLocalId, byRemote };
+}
+/** Where one document is filed, or `undefined` when it has no twin anywhere. */
+export function ownerOf(ledger, localId) {
+    return ledger.byLocalId.get(localId);
+}
+/**
+ * The remote a document is filed on, when that is not `remoteName` — the one
+ * question every enforcement point asks. `undefined` means the document is free
+ * (no twin at all) or already belongs to this remote.
+ */
+export function otherOwner(ledger, localId, remoteName) {
+    const entry = ledger.byLocalId.get(localId);
+    return entry !== undefined && entry.remote !== remoteName ? entry : undefined;
+}
+/**
+ * Every document filed somewhere other than `remoteName`. The push planner
+ * takes this as the set it must not create a second twin for.
+ */
+export function idsOwnedElsewhere(ledger, remoteName) {
+    const out = new Map();
+    for (const [localId, entry] of ledger.byLocalId) {
+        if (entry.remote !== remoteName)
+            out.set(localId, entry);
+    }
+    return out;
+}
+/**
+ * Documents that appear in more than one remote's store — the state this rule
+ * exists to prevent, arrived at by a hand edit or a merge that took both sides.
+ * Reported by `lpm remote ledger`, never repaired here.
+ */
+export function conflicts(paths, config) {
+    const seen = new Map();
+    for (const name of remoteNames(config)) {
+        const provider = remoteNamed(config, name)?.provider ?? name;
+        const store = loadLinkStore(paths, name);
+        for (const [localId, link] of store.links) {
+            const entry = {
+                localId,
+                remote: name,
+                provider,
+                remoteId: link.remoteId,
+                remoteKey: link.remoteKey,
+                remoteUrl: link.remoteUrl,
+                syncedAt: link.syncedAt,
+            };
+            const group = seen.get(localId);
+            if (group)
+                group.push(entry);
+            else
+                seen.set(localId, [entry]);
+        }
+    }
+    return [...seen.values()]
+        .filter((group) => group.length > 1)
+        .sort((a, b) => a[0].localId.localeCompare(b[0].localId));
+}
+/**
+ * Refuse an operation that would give `localId` a second twin.
+ *
+ * Used where the request names one document explicitly (`lpm remote link`): the
+ * person asked for exactly the thing the rule forbids, so the answer is an
+ * error naming the holder and the one command that releases it. A bulk push
+ * reports instead — see the module comment.
+ */
+export function requireUnclaimed(ledger, localId, remoteName) {
+    const owner = otherOwner(ledger, localId, remoteName);
+    if (owner === undefined)
+        return;
+    throw new BoardError(`${localId} is already mirrored on remote "${owner.remote}" as ${owner.remoteKey}`, [
+        'A document is mirrored by one remote at a time, so its status and fields have one upstream.',
+        `Release it first:  lpm remote decouple ${localId}`,
+        `Then file it here: lpm remote push ${localId} --remote ${remoteName}`,
+    ]);
+}
+//# sourceMappingURL=ledger.js.map

package/dist/remote/ledger.js.map

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

package/dist/remote/lifecycle.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Link lifecycle — the state of each correspondence, and whether it still
+ * exists at all (LP-363).
+ *
+ * A link between a local document and a remote issue is not a boolean; it is a
+ * state.  The remote side can be deleted, moved, converted or hidden from view
+ * at any moment, and light-plan finds out on the next pull, after the fact.  So
+ * this file is the resolver that names the state: given the board, the link
+ * store and the remote issues that were fetched, it reports exactly one state
+ * per in-scope correspondence:
+ *
+ *   linked      both sides exist and correspond
+ *   local_only  an in-scope document that has never been pushed
+ *   remote_only an in-scope remote issue with no local document — adoptable
+ *   orphaned    a link one side of which is gone; `side` says which
+ *   decoupled   a human dropped the link on purpose; never re-filed
+ *   conflicted  two sides disagree about existence, and a human must choose
+ *
+ * ## Pure by construction
+ *
+ * The resolver is a pure function: board in, links in, remote issues in, states
+ * out.  It reads no disk and makes no request, so the whole state table is
+ * testable from literals and a dry-run is the same code path as a real sync.
+ *
+ * ## Derived, never stored — except `decoupled`
+ *
+ * Every state is derived from the three inputs, except `decoupled`.  Whether a
+ * human once said "forget the remote twin" is a fact, not a computation, so it
+ * lives in the link store as a tombstone (`links.ts`, written by LP-366; this
+ * resolver only reads it).  Deriving it would be guessing, and guessing re-files
+ * a document a human deliberately cut loose.
+ *
+ * ## The two directions of `orphaned`
+ *
+ * A link whose local document is gone is our own doing and safe to reason
+ * about: somebody deleted the document, and the remote twin is simply
+ * unanchored.  A link whose remote twin is absent from the fetched set is a
+ * different matter — it may be deleted, moved, archived, or hidden by a
+ * credential that lost scope — and LP-364 tells those apart: a remote-side
+ * orphan carries an `absence` of `deleted`, `unreachable` or `out_of_scope`,
+ * each with the `evidence` behind it, and a run that is unreachable as a whole
+ * sets `runUnreachable` so the caller writes nothing.  The resolver records
+ * both directions under one `orphaned` state with a `side` that keeps them
+ * distinct.
+ *
+ * ## Scope
+ *
+ * A document outside the remote's `scope:` subtree is not reported in any state
+ * — it is somebody else's board.  A linked document that moved out of scope is
+ * likewise silent here; LP-366 turns that into a tombstone with reason
+ * `out_of_scope`.  A fetched remote issue is "in scope" when its remote-parent
+ * chain anchors at a linked local document inside the subtree; that anchor walk
+ * mirrors `planPull`'s and must stay in step with it.
+ *
+ * ## Out of scope for this story
+ *
+ * Acting on a state is not this story's.  LP-365 resolves orphaned twins,
+ * LP-366 writes tombstones, LP-367 adopts `remote_only` issues, and LP-368
+ * reports shape divergence (a remote reparent or retype) — the other way a
+ * correspondence reaches `conflicted`.  The planners consume this report; this
+ * file only names states.
+ */
+import type { BoardView } from '../shared/plans/reading.js';
+import type { LinkStore } from './links.js';
+import type { RemoteSnapshot } from './plan.js';
+import type { ReachabilityResult, RemoteRecord } from './provider.js';
+/** The six lifecycle states a correspondence can be in. */
+export type LifecycleState = 'linked' | 'local_only' | 'remote_only' | 'orphaned' | 'decoupled' | 'conflicted';
+/** Which side of a broken link is gone. */
+export type OrphanedSide = 'local' | 'remote';
+/**
+ * Why a linked remote twin is absent from the fetched listing (LP-364). Three
+ * answers, and they are never conflated: `deleted` means the twin is genuinely
+ * gone; `unreachable` means the remote could not be seen (or the run declined
+ * to decide); `out_of_scope` means the twin exists but left the configured
+ * scope (moved project, closed milestone, transferred repo).
+ */
+export type RemoteAbsence = 'deleted' | 'unreachable' | 'out_of_scope';
+/**
+ * What a direct read of one absent twin saw — the caller already fetched this
+ * (the resolver itself makes no request). `not_found` is a 404/410; `found`
+ * means the twin exists but is not in the scoped listing, which is
+ * `out_of_scope`, never `deleted`; `error` means the read failed, which cannot
+ * prove a deletion. Each carries its own evidence, so a surprising
+ * classification can be argued with.
+ */
+export type TwinRead = {
+    kind: 'not_found';
+    evidence: string;
+} | {
+    kind: 'found';
+    evidence: string;
+} | {
+    kind: 'error';
+    evidence: string;
+};
+/**
+ * The bulk guard's default: a run where more than half the linked twins are
+ * missing at once is treated as unreachable. Real deletions arrive a few at a
+ * time; infrastructure failures arrive all at once. Set `bulk_guard` in the
+ * remote's config to move it (1 disables the guard — a fraction never exceeds 1).
+ */
+export declare const DEFAULT_BULK_GUARD = 0.5;
+/** One correspondence's state, as the resolver reports it. */
+export interface LifecycleEntry {
+    state: LifecycleState;
+    /** The local document id, when there is (or was) one. */
+    localId?: string;
+    /** The remote issue id, when there is (or was) one. */
+    remoteId?: string;
+    /** Human-readable remote key, carried from the link store when present. */
+    remoteKey?: string;
+    /** Full URL to the remote issue, carried from the link store when present. */
+    remoteUrl?: string;
+    /** Which side is missing; present only when `state` is `orphaned`. */
+    side?: OrphanedSide;
+    /**
+     * Why the remote twin is absent; present only when `state` is `orphaned` and
+     * `side` is `remote` (LP-364). `deleted`, `unreachable` or `out_of_scope`.
+     */
+    absence?: RemoteAbsence;
+    /** The evidence behind `absence` — the request and answer that produced it. */
+    evidence?: string;
+    /** Why the document was decoupled; present only when `state` is `decoupled`. */
+    reason?: string;
+}
+/** What `resolveLifecycle` returns: one entry per in-scope correspondence. */
+export interface LifecycleReport {
+    entries: LifecycleEntry[];
+    /**
+     * True when the run as a whole is unreachable — the remote's own probe failed
+     * or the bulk guard tripped — and therefore nothing may be written to either
+     * side. A caller that writes anyway would be turning an expired credential
+     * into a wave of deletions (LP-364).
+     */
+    runUnreachable: boolean;
+    /** Why the run is unreachable, when it is — the evidence behind the verdict. */
+    runUnreachableReason?: string;
+}
+/**
+ * The one seam the resolver needs beyond the board, links and remote issues:
+ * reading a record's remote parent id, for providers that hold a native
+ * hierarchy.  Omit it (or return undefined) for a flat remote, and unlinked
+ * remote issues with no remote parent are unanchored — which, for a scoped
+ * remote, means out of scope.
+ */
+export interface LifecycleOptions {
+    parentIdOf?: (record: RemoteRecord) => string | undefined;
+    /**
+     * The reachability probe's answer, when the caller ran it. A failed probe
+     * makes the whole run unreachable — no twin is classified `deleted`.
+     */
+    reachability?: ReachabilityResult;
+    /**
+     * A direct read of one absent twin, when the caller performed one. Absent
+     * means the run has no per-twin evidence, so a missing twin is classified
+     * conservatively (`unreachable`) rather than `deleted`.
+     */
+    readOf?: (remoteId: string) => TwinRead | undefined;
+    /**
+     * The bulk guard fraction: a run where more than this fraction of linked
+     * twins is missing at once is `unreachable` regardless of individual reads.
+     * Defaults to {@link DEFAULT_BULK_GUARD}.
+     */
+    bulkGuard?: number;
+}
+/**
+ * Classify every in-scope correspondence into exactly one lifecycle state.
+ *
+ * Pure: no disk, no network.  `remote.issues` is the listing the caller already
+ * fetched (remote id → raw record); for a `direction: push` remote nothing is
+ * fetched, so the remote side is not assessed — linked documents stay `linked`,
+ * and neither `remote_only` nor a remote-side `orphaned` is reported.
+ */
+export declare function resolveLifecycle(board: BoardView, links: LinkStore, remote: RemoteSnapshot, options?: LifecycleOptions): LifecycleReport;

package/dist/remote/lifecycle.js

@@ -0,0 +1,274 @@
+/**
+ * Link lifecycle — the state of each correspondence, and whether it still
+ * exists at all (LP-363).
+ *
+ * A link between a local document and a remote issue is not a boolean; it is a
+ * state.  The remote side can be deleted, moved, converted or hidden from view
+ * at any moment, and light-plan finds out on the next pull, after the fact.  So
+ * this file is the resolver that names the state: given the board, the link
+ * store and the remote issues that were fetched, it reports exactly one state
+ * per in-scope correspondence:
+ *
+ *   linked      both sides exist and correspond
+ *   local_only  an in-scope document that has never been pushed
+ *   remote_only an in-scope remote issue with no local document — adoptable
+ *   orphaned    a link one side of which is gone; `side` says which
+ *   decoupled   a human dropped the link on purpose; never re-filed
+ *   conflicted  two sides disagree about existence, and a human must choose
+ *
+ * ## Pure by construction
+ *
+ * The resolver is a pure function: board in, links in, remote issues in, states
+ * out.  It reads no disk and makes no request, so the whole state table is
+ * testable from literals and a dry-run is the same code path as a real sync.
+ *
+ * ## Derived, never stored — except `decoupled`
+ *
+ * Every state is derived from the three inputs, except `decoupled`.  Whether a
+ * human once said "forget the remote twin" is a fact, not a computation, so it
+ * lives in the link store as a tombstone (`links.ts`, written by LP-366; this
+ * resolver only reads it).  Deriving it would be guessing, and guessing re-files
+ * a document a human deliberately cut loose.
+ *
+ * ## The two directions of `orphaned`
+ *
+ * A link whose local document is gone is our own doing and safe to reason
+ * about: somebody deleted the document, and the remote twin is simply
+ * unanchored.  A link whose remote twin is absent from the fetched set is a
+ * different matter — it may be deleted, moved, archived, or hidden by a
+ * credential that lost scope — and LP-364 tells those apart: a remote-side
+ * orphan carries an `absence` of `deleted`, `unreachable` or `out_of_scope`,
+ * each with the `evidence` behind it, and a run that is unreachable as a whole
+ * sets `runUnreachable` so the caller writes nothing.  The resolver records
+ * both directions under one `orphaned` state with a `side` that keeps them
+ * distinct.
+ *
+ * ## Scope
+ *
+ * A document outside the remote's `scope:` subtree is not reported in any state
+ * — it is somebody else's board.  A linked document that moved out of scope is
+ * likewise silent here; LP-366 turns that into a tombstone with reason
+ * `out_of_scope`.  A fetched remote issue is "in scope" when its remote-parent
+ * chain anchors at a linked local document inside the subtree; that anchor walk
+ * mirrors `planPull`'s and must stay in step with it.
+ *
+ * ## Out of scope for this story
+ *
+ * Acting on a state is not this story's.  LP-365 resolves orphaned twins,
+ * LP-366 writes tombstones, LP-367 adopts `remote_only` issues, and LP-368
+ * reports shape divergence (a remote reparent or retype) — the other way a
+ * correspondence reaches `conflicted`.  The planners consume this report; this
+ * file only names states.
+ */
+import { subtreeIds } from '../shared/plans/reading.js';
+import { getTombstone } from './links.js';
+/**
+ * The bulk guard's default: a run where more than half the linked twins are
+ * missing at once is treated as unreachable. Real deletions arrive a few at a
+ * time; infrastructure failures arrive all at once. Set `bulk_guard` in the
+ * remote's config to move it (1 disables the guard — a fraction never exceeds 1).
+ */
+export const DEFAULT_BULK_GUARD = 0.5;
+/**
+ * Classify every in-scope correspondence into exactly one lifecycle state.
+ *
+ * Pure: no disk, no network.  `remote.issues` is the listing the caller already
+ * fetched (remote id → raw record); for a `direction: push` remote nothing is
+ * fetched, so the remote side is not assessed — linked documents stay `linked`,
+ * and neither `remote_only` nor a remote-side `orphaned` is reported.
+ */
+export function resolveLifecycle(board, links, remote, options = {}) {
+    const scopeSet = remote.scope ? new Set(subtreeIds(board, remote.scope)) : null;
+    // Absence is only evidence when the listing was exhaustive. A pull that
+    // fetched the two issues somebody named (`remote.partial`) says nothing
+    // about the other two hundred, so no twin is assessed against it — without
+    // this, a targeted pull on a mirrored board reads every other twin as
+    // deleted and the bulk guard (correctly) refuses the whole run.
+    const assessRemote = remote.direction !== 'push' && remote.partial !== true;
+    const entries = [];
+    // -- remote ids claimed by more than one live local document ---------------
+    // A one-to-many correspondence is an existence disagreement: two documents
+    // claim one twin, and neither classification is safe.  Marked `conflicted`;
+    // LP-367 refuses to create such a link, but a hand-edited or merge-mangled
+    // store can still hold one.  Only live documents count — a link whose local
+    // document is gone is an orphaned link, not a claimant.
+    const claimants = new Map();
+    for (const [localId, entry] of links.links) {
+        const node = board.nodes[localId];
+        if (node === undefined || node.kind !== 'issue')
+            continue;
+        const ids = claimants.get(entry.remoteId);
+        if (ids)
+            ids.push(localId);
+        else
+            claimants.set(entry.remoteId, [localId]);
+    }
+    const collided = new Set();
+    for (const ids of claimants.values()) {
+        if (ids.length > 1)
+            for (const id of ids)
+                collided.add(id);
+    }
+    // -- local documents in scope ----------------------------------------------
+    const localIssues = Object.values(board.nodes)
+        .filter((node) => node.kind === 'issue')
+        .filter((issue) => scopeSet === null || scopeSet.has(issue.id))
+        .sort((a, b) => a.id.localeCompare(b.id));
+    // -- LP-364: why a remote twin is absent -----------------------------------
+    // A linked twin absent from the fetched listing may be deleted, moved out of
+    // scope, or hidden by a credential that lost access.  Those three are never
+    // conflated: first the reachability probe (the whole remote cannot be seen),
+    // then the bulk guard (too many vanished at once to be deletions), then the
+    // per-twin read (a 404 proves deletion, a live twin proves out-of-scope).
+    const reachability = options.reachability;
+    const readOf = options.readOf;
+    const bulkGuard = options.bulkGuard ?? DEFAULT_BULK_GUARD;
+    // The denominator and numerator the bulk guard counts: live, in-scope,
+    // non-tombstoned, non-collided linked documents, and the subset whose twin
+    // is absent from the listing.
+    const missingIds = [];
+    let linkedTotal = 0;
+    if (assessRemote) {
+        for (const issue of localIssues) {
+            if (getTombstone(links, issue.id) !== undefined)
+                continue;
+            const link = links.links.get(issue.id);
+            if (link === undefined || collided.has(issue.id))
+                continue;
+            linkedTotal += 1;
+            if (!remote.issues.has(link.remoteId))
+                missingIds.push(issue.id);
+        }
+    }
+    let runUnreachable = false;
+    let runUnreachableReason;
+    if (assessRemote && reachability !== undefined && !reachability.reachable) {
+        runUnreachable = true;
+        runUnreachableReason = reachability.evidence;
+    }
+    else if (assessRemote && linkedTotal > 0 && missingIds.length / linkedTotal > bulkGuard) {
+        runUnreachable = true;
+        runUnreachableReason =
+            `bulk guard: ${missingIds.length} of ${linkedTotal} linked twins are missing ` +
+                `(threshold ${bulkGuard}) — declined to treat them as deletions`;
+    }
+    for (const issue of localIssues) {
+        const tombstone = getTombstone(links, issue.id);
+        if (tombstone !== undefined) {
+            // A human decision outranks everything else: never linked, never
+            // local_only, never re-filed, whatever either side now looks like.
+            entries.push({
+                state: 'decoupled',
+                localId: issue.id,
+                remoteKey: tombstone.remoteKey || undefined,
+                reason: tombstone.reason || undefined,
+            });
+            continue;
+        }
+        const link = links.links.get(issue.id);
+        if (link === undefined) {
+            entries.push({ state: 'local_only', localId: issue.id });
+            continue;
+        }
+        if (collided.has(issue.id)) {
+            entries.push(linkEntry('conflicted', issue.id, link));
+            continue;
+        }
+        if (!assessRemote || remote.issues.has(link.remoteId)) {
+            entries.push(linkEntry('linked', issue.id, link));
+        }
+        else {
+            entries.push(classifyAbsent(issue.id, link, runUnreachable, runUnreachableReason, readOf));
+        }
+    }
+    // -- links whose local document no longer exists ---------------------------
+    const orphanedLocal = [];
+    for (const [localId, link] of links.links) {
+        const node = board.nodes[localId];
+        if (node !== undefined && node.kind === 'issue')
+            continue; // handled above or out of scope
+        orphanedLocal.push({ ...linkEntry('orphaned', localId, link), side: 'local' });
+    }
+    orphanedLocal.sort((a, b) => a.localId.localeCompare(b.localId));
+    entries.push(...orphanedLocal);
+    // -- remote issues in scope with no local document -------------------------
+    if (assessRemote) {
+        // Anchor a remote issue in the local tree: its own twin when it has one,
+        // otherwise the anchor of its remote parent.  Mirrors `planPull`'s
+        // `anchorOf`; a change to one must follow the other.
+        const anchorMemo = new Map();
+        const anchorOf = (remoteId) => {
+            if (anchorMemo.has(remoteId))
+                return anchorMemo.get(remoteId);
+            anchorMemo.set(remoteId, undefined); // cycle guard
+            const linked = links.byRemote.get(remoteId);
+            if (linked !== undefined) {
+                anchorMemo.set(remoteId, linked);
+                return linked;
+            }
+            const record = remote.issues.get(remoteId);
+            const parentRemote = record && options.parentIdOf ? options.parentIdOf(record) : undefined;
+            if (parentRemote) {
+                const anchored = anchorOf(parentRemote);
+                anchorMemo.set(remoteId, anchored);
+                return anchored;
+            }
+            return undefined;
+        };
+        const inScopeRemote = (remoteId) => {
+            if (scopeSet === null)
+                return true;
+            const anchored = anchorOf(remoteId);
+            return anchored !== undefined && scopeSet.has(anchored);
+        };
+        const remoteOnly = [...remote.issues.keys()]
+            .filter((remoteId) => !links.byRemote.has(remoteId) && inScopeRemote(remoteId))
+            .sort((a, b) => a.localeCompare(b))
+            .map((remoteId) => ({ state: 'remote_only', remoteId }));
+        entries.push(...remoteOnly);
+    }
+    return {
+        entries,
+        runUnreachable,
+        ...(runUnreachableReason === undefined ? {} : { runUnreachableReason }),
+    };
+}
+/**
+ * Classify one linked, in-scope document whose twin is absent from the fetched
+ * listing.  A run already judged unreachable (probe or bulk) overrides every
+ * per-twin read; otherwise the direct read decides: a 404 is `deleted`, a live
+ * twin is `out_of_scope`, anything else is `unreachable`.
+ */
+function classifyAbsent(localId, link, runUnreachable, runUnreachableReason, readOf) {
+    const base = { ...linkEntry('orphaned', localId, link), side: 'remote' };
+    if (runUnreachable) {
+        return { ...base, absence: 'unreachable', evidence: runUnreachableReason };
+    }
+    const read = readOf ? readOf(link.remoteId) : undefined;
+    if (read === undefined) {
+        return {
+            ...base,
+            absence: 'unreachable',
+            evidence: 'no reachability signal and no direct read of the twin',
+        };
+    }
+    switch (read.kind) {
+        case 'not_found':
+            return { ...base, absence: 'deleted', evidence: read.evidence };
+        case 'found':
+            return { ...base, absence: 'out_of_scope', evidence: read.evidence };
+        case 'error':
+            return { ...base, absence: 'unreachable', evidence: read.evidence };
+    }
+}
+/** Build an entry that carries a link's remote identity. */
+function linkEntry(state, localId, link) {
+    return {
+        state,
+        localId,
+        remoteId: link.remoteId,
+        remoteKey: link.remoteKey || undefined,
+        remoteUrl: link.remoteUrl || undefined,
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/remote/lifecycle.js.map

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