@amalgm/live 0.2.27 → 0.2.28

package/dist-cjs/detection/adapter-contract.js.map

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

package/dist-cjs/detection/batch.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Net-difference planning for one settled Watch batch.
+ *
+ * Identity reconciliation and type-specific capture happen before this seam.
+ * This seam makes cancellation, unsettled truth, lifecycle authority, coverage
+ * requests, and Watch settlement one total decision.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planDetectionBatch = planDetectionBatch;
+const types_js_1 = require("../entities/types.js");
+const record_proposal_js_1 = require("./record-proposal.js");
+const watch_boundary_js_1 = require("./watch-boundary.js");
+const newlyDirectoryGround = (transition) => transition.relPath !== ''
+    &&
+        types_js_1.CONTAINERS.has(transition.result.type)
+    && (transition.base === null || !types_js_1.CONTAINERS.has(transition.base.type));
+/** Plan the complete net difference. No partial proposals escape an unsettled batch. */
+function planDetectionBatch(batch, transitions) {
+    const unsettled = transitions.filter((transition) => transition.truth === 'unsettled');
+    if (unsettled.length > 0) {
+        return Object.freeze({
+            kind: 'retry',
+            reasons: Object.freeze(unsettled.map((transition) => transition.reason ?? 'truth is unsettled')),
+        });
+    }
+    const proposals = [];
+    const missing = [];
+    const createdDirectories = [];
+    for (const transition of transitions) {
+        if (transition.truth === 'present') {
+            const proposal = (0, record_proposal_js_1.detectedChangeProposal)(transition);
+            if (proposal)
+                proposals.push(proposal);
+            if (newlyDirectoryGround(transition)) {
+                createdDirectories.push(transition.relPath);
+            }
+            continue;
+        }
+        if (transition.truth !== 'absent') {
+            throw new Error('unsettled truth escaped the batch retry gate');
+        }
+        if (transition.base === null)
+            continue; // absent before and after: no entity existed
+        if (transition.base.status !== 'active')
+            continue;
+        if (transition.lifecycleAuthorization !== 'trash') {
+            missing.push(transition.base);
+            continue;
+        }
+        if (!transition.trashedResult) {
+            throw new Error('authorized Trash requires the entity law\'s exact trashed result');
+        }
+        const proposal = (0, record_proposal_js_1.detectedChangeProposal)({
+            base: transition.base,
+            result: transition.trashedResult,
+            replay: { kind: 'structure' },
+            lifecycleAuthorization: 'trash',
+        });
+        if (proposal)
+            proposals.push(proposal);
+    }
+    return Object.freeze({
+        kind: 'ready',
+        proposals: Object.freeze(proposals),
+        missing: Object.freeze(missing),
+        coverage: (0, watch_boundary_js_1.directoryCoverageRequests)(batch, createdDirectories),
+        settle: batch,
+    });
+}
+//# sourceMappingURL=batch.js.map

package/dist-cjs/detection/batch.js.map

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

package/dist-cjs/detection/classify.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Amalgm's file-type policy: which physical type a piece of file ground
+ * takes. Ratified by entity-model.md ("Formats live underneath the file
+ * types"; text versus binary is an adapter difference, never an
+ * identity difference).
+ *
+ * Classification is an INJECTED policy everywhere it is used — the
+ * registration boundary and its lenses refuse to construct without one
+ * — so it lives in its own file with no other job: one definition,
+ * replaceable whole.
+ *
+ * The rule is the oldest one there is: bytes holding a NUL are not
+ * text. What matters is WHERE that fact comes from. It is not read
+ * here. Detect's single read of a file produces its fingerprint and
+ * this report together, and this policy only names the type that report
+ * implies.
+ *
+ * That is the whole law: A FILE'S HASH AND ITS TYPE DESCRIBE THE SAME
+ * OBSERVED BYTES. A policy that opened the ground itself would be a
+ * second look — and a second look can meet different bytes, or none at
+ * all, leaving a record whose type contradicts the payload beside it.
+ * So this function takes evidence, never a path; it is total, and it
+ * cannot fail.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyFile = classifyFile;
+exports.classifyDirectory = classifyDirectory;
+exports.classifyRegisteredRoot = classifyRegisteredRoot;
+exports.isRepositoryMetadataEntry = isRepositoryMetadataEntry;
+function classifyFile({ binary }) {
+    return binary ? 'file.binary' : 'file.text';
+}
+function classifyDirectory({ repository }) {
+    return repository ? 'repo.git' : 'folder';
+}
+/** A deliberately registered external directory remains a tree root. A Git
+ * root wears `repo.git`; an ordinary root wears `workspace`. */
+function classifyRegisteredRoot({ repository }) {
+    return repository ? 'repo.git' : 'workspace';
+}
+/** `.git` is cargo of a repository entity, never one of its worktree
+ * children. Marker presence makes the parent a repository before this rule is
+ * asked, regardless of whether Git can currently consume that marker. */
+function isRepositoryMetadataEntry(parentType, name) {
+    return parentType === 'repo.git' && name === '.git';
+}
+//# sourceMappingURL=classify.js.map

package/dist-cjs/detection/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/detection/classify.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;AAWH,oCAEC;AASD,8CAEC;AAID,wDAEC;AAKD,8DAEC;AA1BD,SAAgB,YAAY,CAAC,EAAE,MAAM,EAAoB;IACvD,OAAO,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC;AAC9C,CAAC;AASD,SAAgB,iBAAiB,CAAC,EAAE,UAAU,EAAsB;IAClE,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC5C,CAAC;AAED;gEACgE;AAChE,SAAgB,sBAAsB,CAAC,EAAE,UAAU,EAAsB;IACvE,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;AAC/C,CAAC;AAED;;yEAEyE;AACzE,SAAgB,yBAAyB,CAAC,UAA8C,EAAE,IAAY;IACpG,OAAO,UAAU,KAAK,UAAU,IAAI,IAAI,KAAK,MAAM,CAAC;AACtD,CAAC"}

package/dist-cjs/detection/content.js

@@ -0,0 +1,122 @@
+"use strict";
+/** Type-sensitive content capture from Detection's one settled byte read. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.textSplice = textSplice;
+exports.captureTextChange = captureTextChange;
+exports.reproduceTextChange = reproduceTextChange;
+exports.captureBinaryChange = captureBinaryChange;
+exports.captureLinkChange = captureLinkChange;
+const content_js_1 = require("../contracts/content.js");
+const bytes_js_1 = require("../entities/bytes.js");
+const upload_js_1 = require("../transfer/upload.js");
+const capturedArtifact = (entityId, entityType, kind, input, sha256Hex) => {
+    const bytes = input.slice();
+    const artifact = {
+        entityId,
+        entityType,
+        kind,
+        contentHash: sha256Hex(bytes),
+    };
+    return Object.freeze({
+        artifact: Object.freeze(artifact),
+        bytes,
+        manifest: (0, upload_js_1.deriveUploadManifest)(artifact, bytes, sha256Hex),
+    });
+};
+/** The smallest single replacement span that transforms base bytes to result. */
+function textSplice(base, result) {
+    let prefix = 0;
+    const shared = Math.min(base.byteLength, result.byteLength);
+    while (prefix < shared && base[prefix] === result[prefix])
+        prefix += 1;
+    let suffix = 0;
+    while (suffix < shared - prefix
+        && base[base.byteLength - suffix - 1] === result[result.byteLength - suffix - 1]) {
+        suffix += 1;
+    }
+    return Object.freeze({
+        offset: prefix,
+        deleteBytes: base.byteLength - prefix - suffix,
+        insert: result.slice(prefix, result.byteLength - suffix),
+    });
+}
+/**
+ * Capture text as one verified byte splice when that instruction is smaller
+ * than the result bytes. The immutable snapshot is always sealed as repair and
+ * cold-materialization truth.
+ */
+function captureTextChange(entityId, base, result, sha256Hex) {
+    const cargo = capturedArtifact(entityId, 'file.text', 'file', result, sha256Hex);
+    const basePayloadVersion = base === null ? null : sha256Hex(base);
+    if (basePayloadVersion === cargo.artifact.contentHash)
+        return null;
+    const delta = base === null ? null : textSplice(base, result);
+    // Two numeric fields are fixed overhead on the wire. This conservative
+    // estimate keeps a replace-all operation on the snapshot path.
+    const useDelta = delta !== null && delta.insert.byteLength + 16 < result.byteLength;
+    return Object.freeze({
+        replay: Object.freeze({
+            kind: 'file.text',
+            mode: useDelta ? 'delta' : 'snapshot',
+            basePayloadVersion,
+            resultPayloadVersion: cargo.artifact.contentHash,
+            delta: useDelta ? delta : null,
+        }),
+        cargo,
+    });
+}
+/** Apply a text replay and verify its exact result, falling back to snapshot. */
+function reproduceTextChange(base, replay, snapshot, sha256Hex) {
+    const verifiedSnapshot = () => {
+        if (sha256Hex(snapshot) !== replay.resultPayloadVersion) {
+            throw new Error('text snapshot does not match its declared result');
+        }
+        return snapshot.slice();
+    };
+    if (replay.mode !== 'delta' || replay.delta === null || base === null
+        || sha256Hex(base) !== replay.basePayloadVersion) {
+        return verifiedSnapshot();
+    }
+    const { offset, deleteBytes, insert } = replay.delta;
+    if (!Number.isSafeInteger(offset) || !Number.isSafeInteger(deleteBytes)
+        || offset < 0 || deleteBytes < 0 || offset + deleteBytes > base.byteLength) {
+        return verifiedSnapshot();
+    }
+    const result = new Uint8Array(base.byteLength - deleteBytes + insert.byteLength);
+    result.set(base.subarray(0, offset), 0);
+    result.set(insert, offset);
+    result.set(base.subarray(offset + deleteBytes), offset + insert.byteLength);
+    return sha256Hex(result) === replay.resultPayloadVersion ? result : verifiedSnapshot();
+}
+/** Binary replay is the existing exact content manifest; Transfer moves gaps. */
+function captureBinaryChange(entityId, previous, result, sha256Hex) {
+    if (previous !== null && !(0, content_js_1.checkContentManifest)(previous).ok) {
+        throw new Error('previous binary content manifest is invalid');
+    }
+    const cargo = capturedArtifact(entityId, 'file.binary', 'file', result, sha256Hex);
+    if (previous?.contentHash === cargo.artifact.contentHash)
+        return null;
+    return Object.freeze({
+        replay: Object.freeze({
+            kind: 'file.binary',
+            resultPayloadVersion: cargo.artifact.contentHash,
+            manifest: cargo.manifest,
+        }),
+        cargo,
+    });
+}
+/** A symlink's portable content is the literal target text, never its target. */
+function captureLinkChange(entityId, previousTarget, target, sha256Hex) {
+    if (previousTarget === target)
+        return null;
+    const cargo = capturedArtifact(entityId, 'link', 'link', (0, bytes_js_1.utf8Encode)(target), sha256Hex);
+    return Object.freeze({
+        replay: Object.freeze({
+            kind: 'link',
+            resultPayloadVersion: cargo.artifact.contentHash,
+            target,
+        }),
+        cargo,
+    });
+}
+//# sourceMappingURL=content.js.map

package/dist-cjs/detection/content.js.map

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

package/dist-cjs/detection/continuity.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Root continuity verdicts: what a root's WITNESSED physical identity
+ * is, whether its recorded address still holds its ground, and whether
+ * a piece of ground rescues a moved root. Ratified by entity-model.md
+ * ("Ground that moves is rescued by continuity" — the directory law
+ * lifted to roots; "the follow rides witnessed continuity, never
+ * clairvoyance").
+ *
+ * Pure verdicts over injected answers — the host supplies the one look
+ * at an address (`statAt`) and the store's witnessed channel row
+ * (`channelIdentity`); the ACTIONS a verdict triggers (rebind, presence
+ * transitions, the undecided-address decision) stay in the host's
+ * wiring, because they re-aim watchers and scans.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContinuity = createContinuity;
+function createContinuity({ statAt, channelIdentity }) {
+    /**
+     * A root's WITNESSED physical identity, for continuity rescue.
+     * Directory roots carry their own device:inode (nothing replaces a
+     * directory's inode in place). A single-ground root's identity lives
+     * in its one channel row. Ground that changed inodes inside a
+     * still-open settle window is unwitnessed — no evidence, no claim.
+     */
+    function rootIdentity(root) {
+        if (root.kind !== 'file') {
+            const { device, inode } = root;
+            return device == null || inode == null ? null : { device, inode };
+        }
+        return channelIdentity(root.rootId);
+    }
+    /** Orphaned means the recorded address no longer holds this ground. */
+    function orphanedAtAddress(root) {
+        const identity = rootIdentity(root);
+        if (!identity)
+            return false;
+        const stat = statAt(root.path);
+        if (!stat)
+            return true;
+        return stat.device !== identity.device || stat.inode !== identity.inode;
+    }
+    /**
+     * Continuity claims a root exactly like it claims the directories
+     * inside one: unique device:inode match, exactly one candidate, and
+     * only for a path-orphan — a root whose recorded address still holds
+     * its ground is never stolen by a lookalike.
+     */
+    function findMovedRoot(stat, roots) {
+        const wantDir = stat.kind === 'dir';
+        const matches = roots.filter((root) => {
+            if (wantDir !== (root.kind !== 'file'))
+                return false;
+            const identity = rootIdentity(root);
+            return identity !== null && identity.device === stat.device && identity.inode === stat.inode;
+        });
+        const only = matches.length === 1 ? matches[0] : null;
+        return only && orphanedAtAddress(only) ? only : null;
+    }
+    /**
+     * A scan's evidence horizon is the root's ground; the root's own
+     * address is the horizon's edge. Ground missing there — or a
+     * directory root's address wearing a different physical identity — is
+     * UNDECIDABLE from here: moved away, deleted, or replaced by a
+     * lookalike all present the same address, and concluding "deleted"
+     * would end every channel a rescue could have saved. So the scan
+     * concludes nothing: beliefs freeze, the referee convicts the
+     * divergence, and the next enrollment moment decides — naming the new
+     * address rescues, re-naming this one adopts, and explicit removal is
+     * the only deletion (an external filesystem change is never
+     * permission to end identity). A single-ground root's address
+     * lawfully churns inodes (atomic saves, retargets), so only absence —
+     * or foreign directory ground — freezes it; presence is the file
+     * laws' business.
+     */
+    function addressUndecided(root) {
+        const stat = statAt(root.path);
+        if (!stat)
+            return true;
+        if (root.kind === 'file')
+            return stat.kind !== 'file' && stat.kind !== 'link';
+        if (stat.kind !== 'dir')
+            return true;
+        return root.device != null && (stat.device !== root.device || stat.inode !== root.inode);
+    }
+    return { rootIdentity, findMovedRoot, addressUndecided };
+}
+//# sourceMappingURL=continuity.js.map

package/dist-cjs/detection/continuity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuity.js","sourceRoot":"","sources":["../../src/detection/continuity.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AA8CH,4CAmEC;AAnED,SAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,eAAe,EAAmB;IAC3E;;;;;;OAMG;IACH,SAAS,YAAY,CAAC,IAAoB;QACxC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;YAC/B,OAAO,MAAM,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACpE,CAAC;QACD,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,uEAAuE;IACvE,SAAS,iBAAiB,CAAC,IAAoB;QAC7C,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAC;IAC1E,CAAC;IAED;;;;;OAKG;IACH,SAAS,aAAa,CAAC,IAAgB,EAAE,KAAgC;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACpC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC;QAC/F,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACvD,OAAO,IAAI,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,SAAS,gBAAgB,CAAC,IAAoB;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;QAC9E,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;AAC3D,CAAC"}

package/dist-cjs/detection/diff.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * The compare core of detection: rows (store memory) + entries (disk
+ * truth) in, actions out. Pure — the walk that produces entries and the
+ * hashing that settles `checks` are the host's; only the identity
+ * verdicts live here. Ratified by entity-model.md ("Address and
+ * physical continuity are the two identity witnesses, never content").
+ *
+ * Three kinds of channel, three orderings of the same two witnesses:
+ *
+ *  - Files: path claims first; the inode rescues path-orphans. An
+ *    atomic save replaces a file's inode in place, so the address must
+ *    absorb that churn.
+ *  - Directories: physical continuity claims first; the address claims
+ *    what no inode claims. Nothing replaces a directory's inode in
+ *    place, so a known inode at a new address IS the directory, moved.
+ *  - Links: the FILE rules, for the file reason — retarget is unlink +
+ *    recreate, so the inode churns exactly like an atomic save.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchByInode = matchByInode;
+exports.diffDirState = diffDirState;
+exports.diffLinkState = diffLinkState;
+exports.diffRootState = diffRootState;
+/**
+ * Physical continuity, shared by every compare function: a row and an
+ * entry sharing one device:inode, exactly one match on both sides → the
+ * same physical thing. Anything else is never guessed. For files this
+ * rescues path-orphans (rule 2); for directories it IS rule 1.
+ */
+function matchByInode(rows, entries) {
+    const one = (map, key, value) => map.set(key, map.has(key) ? 'many' : value);
+    const rowsByInode = new Map();
+    for (const row of rows)
+        one(rowsByInode, `${row.device}:${row.inode}`, row);
+    const entriesByInode = new Map();
+    for (const entry of entries)
+        one(entriesByInode, `${entry.device}:${entry.inode}`, entry);
+    const matched = [];
+    for (const [key, entry] of entriesByInode) {
+        const row = rowsByInode.get(key);
+        if (entry === 'many' || !row || row === 'many')
+            continue;
+        matched.push({ row, entry });
+    }
+    return matched;
+}
+/**
+ * The compare function for directory channels — the file identity rules
+ * in the OPPOSITE order, for the mirror reason. A file's inode is
+ * replaced in place on every atomic save, so for files the path must
+ * absorb that churn (path claims first). Nothing replaces a directory's
+ * inode in place: a known inode at a new address IS the directory,
+ * moved — even when its old address was reoccupied in the same interval
+ * (two directories exchanging names cross by inode, exactly like the
+ * files inside them). So:
+ *  1. Physical continuity claims the channel: unique device:inode,
+ *     whole sets, same path = continued, new path = rename.
+ *  2. The address claims what no inode claims — recreation under an old
+ *     name is the same channel wearing a never-seen inode (`retags`,
+ *     silent).
+ *  3. Leftover entries are creates; leftover rows are deletes.
+ * No content: a directory's membership is derived state upstream, so
+ * there is nothing to hash or check.
+ */
+function diffDirState(rows, entries) {
+    const matched = matchByInode(rows, entries);
+    const matchedRowIds = new Set(matched.map((pair) => pair.row.dirId));
+    const matchedEntries = new Set(matched.map((pair) => pair.entry));
+    const rowsByPath = new Map(rows.filter((row) => !matchedRowIds.has(row.dirId))
+        .map((row) => [row.relPath, row]));
+    const retags = [];
+    const creates = [];
+    for (const entry of entries) {
+        if (matchedEntries.has(entry))
+            continue;
+        const row = rowsByPath.get(entry.relPath);
+        if (row) {
+            rowsByPath.delete(entry.relPath);
+            retags.push({ row, entry });
+        }
+        else {
+            creates.push(entry);
+        }
+    }
+    return {
+        renames: matched.filter((pair) => pair.row.relPath !== pair.entry.relPath),
+        retags,
+        creates,
+        deletes: [...rowsByPath.values()],
+    };
+}
+/**
+ * The compare function for link channels — the FILE identity rules, for
+ * the file reason: a symlink cannot be retargeted in place (retarget is
+ * unlink + recreate, so the inode churns exactly like an atomic save),
+ * so the path absorbs that churn and claims first; the inode rescues
+ * path-orphans (`mv` preserves a symlink's inode). The payload is the
+ * target string, already read at walk time. A consequence worth naming:
+ * two links exchanging names read as two retargets (path-first),
+ * because a link's meaning IS its written address.
+ *  1. Path claims the channel: same target = continued (a new inode
+ *     under an old name with an old target is silent recreation),
+ *     different target = changed.
+ *  2. Inode rescues path-orphans: renames.
+ *  3. Leftover entries are creates; leftover rows are deletes.
+ */
+function diffLinkState(rows, entries) {
+    const changes = [];
+    const retags = [];
+    const rowsByPath = new Map(rows.map((row) => [row.relPath, row]));
+    const claimedRowIds = new Set();
+    const orphanEntries = [];
+    for (const entry of entries) {
+        const row = rowsByPath.get(entry.relPath);
+        if (!row) {
+            orphanEntries.push(entry);
+            continue;
+        }
+        claimedRowIds.add(row.linkId);
+        if (row.target !== entry.target)
+            changes.push({ row, entry });
+        else if (row.device !== entry.device || row.inode !== entry.inode)
+            retags.push({ row, entry });
+    }
+    const orphanRows = rows.filter((row) => !claimedRowIds.has(row.linkId));
+    const renames = matchByInode(orphanRows, orphanEntries);
+    const renamedRowIds = new Set(renames.map((pair) => pair.row.linkId));
+    const renamedEntries = new Set(renames.map((pair) => pair.entry));
+    return {
+        changes,
+        retags,
+        renames,
+        creates: orphanEntries.filter((entry) => !renamedEntries.has(entry)),
+        deletes: orphanRows.filter((row) => !renamedRowIds.has(row.linkId)),
+    };
+}
+/**
+ * The compare function for file channels — doorbells and rescans both
+ * end here. Hashing is deferred — `checks` name the files whose content
+ * must be read before an event may be claimed.
+ *
+ * Identity rules, in order:
+ *  1. Path claims the channel. Same rel_path = same file_id, even when
+ *     the inode changed (atomic saves replace the inode on every
+ *     write).
+ *  2. Inode rescues path-orphans (matchByInode above).
+ *  3. Leftover entries are creates; leftover rows are deletes.
+ *
+ * The single stat-shortcut this layer allows itself: a (size, mtime,
+ * inode) triple identical to the stored one is skipped as unchanged —
+ * but only when the mtime is strictly older than the moment we last
+ * read the bytes (git's "racily clean" rule), and only when nothing
+ * pointed at the file. A path named in `mustCheck` (the doorbell said
+ * so) is always hashed: timestamps can lie, a delivered watcher event
+ * cannot be un-delivered.
+ */
+function diffRootState(rows, entries, mustCheck = null) {
+    const checks = [];
+    let unchanged = 0;
+    const rowsByPath = new Map(rows.map((row) => [row.relPath, row]));
+    const claimedRowIds = new Set();
+    const orphanEntries = [];
+    for (const entry of entries) {
+        const row = rowsByPath.get(entry.relPath);
+        if (!row) {
+            orphanEntries.push(entry);
+            continue;
+        }
+        claimedRowIds.add(row.fileId);
+        const statsMatch = row.size === entry.size && row.mtimeMs === entry.mtimeMs && row.inode === entry.inode;
+        const provablyBeforeLastRead = typeof row.hashedAtMs === 'number' && entry.mtimeMs < row.hashedAtMs;
+        const named = mustCheck !== null && mustCheck.has(entry.relPath);
+        if (statsMatch && provablyBeforeLastRead && !named) {
+            unchanged += 1;
+        }
+        else {
+            checks.push({ row, entry });
+        }
+    }
+    const orphanRows = rows.filter((row) => !claimedRowIds.has(row.fileId));
+    const renames = matchByInode(orphanRows, orphanEntries);
+    const renamedRowIds = new Set(renames.map((pair) => pair.row.fileId));
+    const renamedEntries = new Set(renames.map((pair) => pair.entry));
+    return {
+        checks,
+        renames,
+        creates: orphanEntries.filter((entry) => !renamedEntries.has(entry)),
+        deletes: orphanRows.filter((row) => !renamedRowIds.has(row.fileId)),
+        unchanged,
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist-cjs/detection/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/detection/diff.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAyDH,oCAiBC;AA2BD,oCAwBC;AAyBD,sCA2BC;AA+BD,sCAwCC;AArMD;;;;;GAKG;AACH,SAAgB,YAAY,CAC1B,IAAoB,EACpB,OAAyB;IAEzB,MAAM,GAAG,GAAG,CAAQ,GAAgC,EAAE,GAAW,EAAE,KAAY,EAAE,EAAE,CACjF,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAwB,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,GAAG,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,cAAc,GAAG,IAAI,GAAG,EAA0B,CAAC;IACzD,KAAK,MAAM,KAAK,IAAI,OAAO;QAAE,GAAG,CAAC,cAAc,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1F,MAAM,OAAO,GAA6B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,MAAM;YAAE,SAAS;QACzD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AASD;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,YAAY,CAAC,IAAuB,EAAE,OAA4B;IAChF,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;SAC3E,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACxC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,GAAG,EAAE,CAAC;YACR,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAC1E,MAAM;QACN,OAAO;QACP,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAUD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,aAAa,CAAC,IAAwB,EAAE,OAA6B;IACnF,MAAM,OAAO,GAAqC,EAAE,CAAC;IACrD,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,MAAM,aAAa,GAAgB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;aACzD,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,OAAO;QACL,OAAO;QACP,MAAM;QACN,OAAO;QACP,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpE,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;KACpE,CAAC;AACJ,CAAC;AAWD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,aAAa,CAC3B,IAAwB,EACxB,OAA6B,EAC7B,YAAwC,IAAI;IAE5C,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,MAAM,aAAa,GAAgB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC;QACzG,MAAM,sBAAsB,GAAG,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC;QACpG,MAAM,KAAK,GAAG,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,UAAU,IAAI,sBAAsB,IAAI,CAAC,KAAK,EAAE,CAAC;YACnD,SAAS,IAAI,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAElE,OAAO;QACL,MAAM;QACN,OAAO;QACP,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpE,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnE,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist-cjs/detection/echo.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Echo judgment after incoming Apply.
+ *
+ * Apply never suppresses watcher rings. It verifies the incoming result and
+ * advances the notebook. The retained suspicion then uses this ordinary
+ * equality judgment: exact expected truth is silence; different truth is a
+ * real local change; unreadable truth is retried.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.echoDecision = echoDecision;
+function echoDecision(notebook, observed) {
+    if (observed.truth === 'unsettled') {
+        return observed.reason === undefined
+            ? { kind: 'retry' }
+            : { kind: 'retry', reason: observed.reason };
+    }
+    if (notebook.status === 'active') {
+        return observed.truth === 'present' && observed.version === notebook.version
+            ? { kind: 'silence' }
+            : { kind: 'detect' };
+    }
+    return observed.truth === 'absent' ? { kind: 'silence' } : { kind: 'detect' };
+}
+//# sourceMappingURL=echo.js.map

package/dist-cjs/detection/echo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.js","sourceRoot":"","sources":["../../src/detection/echo.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAUH,oCAeC;AAfD,SAAgB,YAAY,CAC1B,QAAuD,EACvD,QAAsB;IAEtB,IAAI,QAAQ,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC,MAAM,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE;YACnB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACjD,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;YAC1E,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;YACrB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAChF,CAAC"}