@superbee/core 0.1.0

package/dist/engine.js

@@ -0,0 +1,209 @@
+/**
+ * Runtime-neutral Superbee engine operations.
+ *
+ * Every operation receives its {@link StorageBackend} explicitly. Node filesystem defaults live
+ * only in the legacy root adapter (`bundle.ts`); Worker and browser consumers import this module.
+ */
+import { normalizeV01DocumentForWrite, normalizeV02DocumentForWrite, } from "./document-write-policy.js";
+import { InvalidInputError } from "./errors.js";
+import { isUsableTimestamp, MalformedDocumentError } from "./frontmatter-contract.js";
+import { parseLinksFromDoc } from "./links.js";
+import { assertSafeConceptId, isReservedFile, pathFromConceptId } from "./paths.js";
+import { parseLeadingFrontmatter } from "./portable-frontmatter.js";
+import { matchesFilter } from "./query-filter.js";
+export { MalformedDocumentError } from "./frontmatter-contract.js";
+/** Read the bundle-root OKF edition through an explicit backend. */
+export async function readBundleOkfVersion(backend) {
+    const index = await backend.readReserved("", "index.md");
+    if (!index)
+        return undefined;
+    const value = parseLeadingFrontmatter(index.content, "index.md").okf_version;
+    return typeof value === "string" && value.trim() !== "" ? value : undefined;
+}
+function assertWritableConceptDocument(doc) {
+    assertSafeConceptId(doc.id);
+    const rel = pathFromConceptId(doc.id);
+    if (isReservedFile(rel)) {
+        throw new InvalidInputError(`'${doc.id}' maps to a reserved file (${rel}); use the index/log accessors, not writeDoc.`);
+    }
+    const type = doc.frontmatter?.type;
+    if (typeof type !== "string" || type.trim() === "") {
+        throw new InvalidInputError(`OKF conformance: frontmatter.type is required and must be non-empty (concept '${doc.id}').`);
+    }
+    return type;
+}
+async function persistDocForEdition(backend, doc, type, okfVersion, options) {
+    let saved;
+    if (okfVersion === "0.1") {
+        const existingTimestamp = doc.frontmatter.timestamp;
+        const timestamp = isUsableTimestamp(existingTimestamp)
+            ? { preserveExisting: true, existingTimestamp }
+            : { preserveExisting: false, fallbackTimestamp: new Date().toISOString() };
+        saved = normalizeV01DocumentForWrite(doc, type, timestamp);
+    }
+    else {
+        saved = normalizeV02DocumentForWrite(doc, type);
+    }
+    const version = await backend.write(doc.id, saved, options);
+    return { doc: saved, version };
+}
+/** Validate, normalize for the backend's bundle edition, and atomically persist a document. */
+export async function writeDocVersioned(backend, doc, options) {
+    const type = assertWritableConceptDocument(doc);
+    const okfVersion = (await readBundleOkfVersion(backend)) ?? "0.1";
+    return persistDocForEdition(backend, doc, type, okfVersion, options);
+}
+/** Edition-pinned sibling for mutation policy after it has read the root once. */
+export async function writeDocVersionedForEdition(backend, doc, okfVersion, options) {
+    return persistDocForEdition(backend, doc, assertWritableConceptDocument(doc), okfVersion, options);
+}
+/** Persist a document while keeping the historical document-only result. */
+export async function writeDoc(backend, doc, options) {
+    return (await writeDocVersioned(backend, doc, options)).doc;
+}
+function assertReadableConceptId(id) {
+    assertSafeConceptId(id);
+    const rel = pathFromConceptId(id);
+    if (isReservedFile(rel)) {
+        throw new InvalidInputError(`'${id}' is a reserved file (index.md / log.md), not a concept document.`);
+    }
+}
+export async function readDocVersioned(backend, id) {
+    assertReadableConceptId(id);
+    return backend.read(id);
+}
+export async function readDoc(backend, id) {
+    return (await readDocVersioned(backend, id)).doc;
+}
+export async function existsDoc(backend, id) {
+    assertReadableConceptId(id);
+    return backend.exists(id);
+}
+export async function docVersions(backend, id) {
+    assertReadableConceptId(id);
+    return backend.versions(id);
+}
+export async function deleteDoc(backend, id, options) {
+    assertSafeConceptId(id);
+    const rel = pathFromConceptId(id);
+    if (isReservedFile(rel)) {
+        throw new InvalidInputError(`'${id}' is a reserved file (${rel}); reserved files cannot be deleted.`);
+    }
+    return backend.delete(id, options);
+}
+function isEnoent(err) {
+    return typeof err === "object" && err !== null && err.code === "ENOENT";
+}
+async function readManyExisting(backend, ids, onMalformed) {
+    try {
+        return await backend.readMany(ids);
+    }
+    catch (err) {
+        const malformed = err instanceof MalformedDocumentError;
+        if (!isEnoent(err) && !(malformed && onMalformed))
+            throw err;
+        const out = [];
+        for (const id of ids) {
+            try {
+                out.push(await backend.read(id));
+            }
+            catch (candidate) {
+                if (isEnoent(candidate))
+                    continue;
+                if (candidate instanceof MalformedDocumentError && onMalformed) {
+                    onMalformed({ id, reason: candidate.detail });
+                    continue;
+                }
+                throw candidate;
+            }
+        }
+        return out;
+    }
+}
+async function scanMatching(backend, filter, onSkip) {
+    const ids = await backend.list(filter.prefix);
+    const results = [];
+    for (const result of await readManyExisting(backend, ids, onSkip)) {
+        if (matchesFilter(result.doc, filter))
+            results.push(result);
+    }
+    results.sort((a, b) => a.doc.id.localeCompare(b.doc.id));
+    return results;
+}
+export async function query(backend, filter = {}, options = {}) {
+    return (await scanMatching(backend, filter, options.onSkip)).map((result) => result.doc);
+}
+export const list = query;
+export async function queryHeads(backend, filter = {}, options = {}) {
+    if (backend.queryHeads) {
+        const rows = (await backend.queryHeads(filter)).filter((row) => matchesFilter(row, filter));
+        rows.sort((a, b) => a.id.localeCompare(b.id));
+        return rows;
+    }
+    return (await scanMatching(backend, filter, options.onSkip)).map(({ doc, version }) => ({
+        id: doc.id,
+        frontmatter: doc.frontmatter,
+        version,
+    }));
+}
+export function parseLinks(doc) {
+    return parseLinksFromDoc(doc);
+}
+function normalizeEdgeSelector(raw) {
+    if (raw.endsWith("/")) {
+        const stem = raw.slice(0, -1);
+        assertSafeConceptId(stem);
+        return `${stem}/`;
+    }
+    assertSafeConceptId(raw);
+    return raw;
+}
+function matchesEdgeSelector(value, selectors) {
+    if (selectors === undefined)
+        return true;
+    return selectors.some((selector) => selector.endsWith("/") ? value.startsWith(selector) : value === selector);
+}
+function toSelectorList(value) {
+    if (value === undefined)
+        return undefined;
+    return Array.isArray(value) ? value : [value];
+}
+export async function queryEdges(backend, filter = {}) {
+    const fromSelectors = toSelectorList(filter.from)?.map(normalizeEdgeSelector);
+    const toSelectors = toSelectorList(filter.to)?.map(normalizeEdgeSelector);
+    const edges = [];
+    for (const doc of await query(backend)) {
+        for (const link of parseLinksFromDoc(doc)) {
+            if (!matchesEdgeSelector(link.from, fromSelectors))
+                continue;
+            if (!matchesEdgeSelector(link.to, toSelectors))
+                continue;
+            if (filter.text !== undefined && link.text !== filter.text)
+                continue;
+            edges.push(link);
+        }
+    }
+    edges.sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || a.text.localeCompare(b.text));
+    return edges;
+}
+export async function backlinks(backend, target) {
+    if (target.endsWith("/"))
+        return [];
+    return queryEdges(backend, { to: target });
+}
+export async function readBlob(backend, key) {
+    return backend.readBlob(key);
+}
+export async function writeBlob(backend, key, bytes, contentType, options) {
+    return backend.writeBlob(key, bytes, contentType, options);
+}
+export async function existsBlob(backend, key) {
+    return backend.existsBlob(key);
+}
+export async function listBlobs(backend, prefix) {
+    return backend.listBlobs(prefix);
+}
+export async function deleteBlob(backend, key, options) {
+    return backend.deleteBlob(key, options);
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Typed rejection for caller-supplied input the engine refuses: unsafe/reserved concept ids,
+ * invalid blob keys, missing/empty `frontmatter.type`, malformed option values, and (through
+ * {@link FilesystemIdentityAliasError}) an id whose spelling names an existing filesystem entry
+ * only by alias. Most rejections happen before storage is touched; the alias verdict needs one
+ * inspection of storage but is still "fix your input". Distinct from a runtime failure (I/O,
+ * transport, backend) so a consumer boundary — e.g. the CLI's `classifyBundleError` — can map
+ * "fix your input" (USAGE, exit 2) separately from "retry/report a bug" (RUNTIME, exit 1) without
+ * prose-matching messages.
+ */
+export declare class InvalidInputError extends Error {
+    constructor(message: string);
+}
+/**
+ * The requested bundle-relative path resolves, on a case- or normalization-insensitive
+ * filesystem, to a directory entry spelled differently at `segment`. Every operation refuses it
+ * so two distinct canonical ids can never read, compare-and-swap, or delete one physical file.
+ */
+export declare class FilesystemIdentityAliasError extends InvalidInputError {
+    readonly rel: string;
+    readonly segment: string;
+    constructor(rel: string, segment: string);
+}
+/**
+ * A filesystem operation could not bind its result to one stable on-disk entry: an observation
+ * saw replacement, or a Windows replacement sharing violation made the current write attempt
+ * unsafe to continue. A retryable runtime condition; the owning read/decide/CAS loop must restart
+ * the complete attempt rather than retrying the filesystem operation in place.
+ */
+export declare class ConcurrentReplacementError extends Error {
+    readonly rel: string;
+    /** Optional bounded backoff hint for a transient host condition; ordinary observation races use zero. */
+    readonly retryAfterMs: number;
+    constructor(rel: string, attempts: number, retryAfterMs?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,iBAAiB;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CASzC;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yGAAyG;IACzG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,SAAI;CAM5D"}

package/dist/errors.js

@@ -0,0 +1,50 @@
+/**
+ * Typed rejection for caller-supplied input the engine refuses: unsafe/reserved concept ids,
+ * invalid blob keys, missing/empty `frontmatter.type`, malformed option values, and (through
+ * {@link FilesystemIdentityAliasError}) an id whose spelling names an existing filesystem entry
+ * only by alias. Most rejections happen before storage is touched; the alias verdict needs one
+ * inspection of storage but is still "fix your input". Distinct from a runtime failure (I/O,
+ * transport, backend) so a consumer boundary — e.g. the CLI's `classifyBundleError` — can map
+ * "fix your input" (USAGE, exit 2) separately from "retry/report a bug" (RUNTIME, exit 1) without
+ * prose-matching messages.
+ */
+export class InvalidInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidInputError";
+    }
+}
+/**
+ * The requested bundle-relative path resolves, on a case- or normalization-insensitive
+ * filesystem, to a directory entry spelled differently at `segment`. Every operation refuses it
+ * so two distinct canonical ids can never read, compare-and-swap, or delete one physical file.
+ */
+export class FilesystemIdentityAliasError extends InvalidInputError {
+    rel;
+    segment;
+    constructor(rel, segment) {
+        super(`Path '${rel}' does not match the exact spelling of an existing filesystem entry at segment ` +
+            `'${segment}'; ids that differ only by case or Unicode normalization cannot share one file.`);
+        this.name = "FilesystemIdentityAliasError";
+        this.rel = rel;
+        this.segment = segment;
+    }
+}
+/**
+ * A filesystem operation could not bind its result to one stable on-disk entry: an observation
+ * saw replacement, or a Windows replacement sharing violation made the current write attempt
+ * unsafe to continue. A retryable runtime condition; the owning read/decide/CAS loop must restart
+ * the complete attempt rather than retrying the filesystem operation in place.
+ */
+export class ConcurrentReplacementError extends Error {
+    rel;
+    /** Optional bounded backoff hint for a transient host condition; ordinary observation races use zero. */
+    retryAfterMs;
+    constructor(rel, attempts, retryAfterMs = 0) {
+        super(`Path '${rel}' could not be bound to one stable entry during ${attempts} filesystem attempt(s); retry.`);
+        this.name = "ConcurrentReplacementError";
+        this.rel = rel;
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,4BAA6B,SAAQ,iBAAiB;IACxD,GAAG,CAAS;IACZ,OAAO,CAAS;IAEzB,YAAY,GAAW,EAAE,OAAe;QACtC,KAAK,CACH,SAAS,GAAG,iFAAiF;YAC3F,IAAI,OAAO,iFAAiF,CAC/F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,GAAG,CAAS;IACrB,yGAAyG;IAChG,YAAY,CAAS;IAE9B,YAAY,GAAW,EAAE,QAAgB,EAAE,YAAY,GAAG,CAAC;QACzD,KAAK,CAAC,SAAS,GAAG,mDAAmD,QAAQ,gCAAgC,CAAC,CAAC;QAC/G,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF"}

package/dist/filesystem-identity.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Exact filesystem identity for the filesystem adapter.
+ *
+ * A bundle-relative path `rel` names ONE physical entry only when every segment's on-disk
+ * spelling equals the requested spelling. On a case- or normalization-insensitive filesystem
+ * (case-insensitive APFS, NTFS, ext4 casefold, normalization-insensitive APFS) two distinct
+ * canonical ids would otherwise reach one file, so reads, compare-and-swap, and deletes would
+ * alias. This module is the single owner of that decision:
+ *
+ * - Observations record every `rel` segment's inode, verify each segment's spelling by listing
+ *   before and after use, confirm any would-be alias by probing the requested spelling against
+ *   the recorded inode, and hold the read handle open through the post-walk so the bytes stay
+ *   bound to a live inode. They hold no lock and write nothing, so an absent bundle root stays
+ *   absent. A symbolic link observed by any probe is refused; a link swapped in and out
+ *   entirely between two probes of one observation can be traversed by the operating system
+ *   during a listing or open, but its bytes can never be returned as EXACT, because the leaf
+ *   witness at the post-walk must match the entry the requested path reaches.
+ * - Mutations hold one cross-process lock keyed by a pure fold of the root and `rel`, decide
+ *   inside it, create directories one segment at a time with a spelling check, and publish a
+ *   first-created leaf with `link` so the host's own equivalence refuses a second spelling the
+ *   fold did not equate; a first-creation race cannot succeed with the wrong spelling and cannot
+ *   silently replace the winner.
+ *
+ * An observation's linearization point is the post-walk that validated the bytes: what it returns
+ * is a state of THIS identity at that instant, never a foreign one and never bytes straddling two
+ * states. A read concurrent with a legitimate same-spelling replacement may therefore return the
+ * old value or the new one, both real; a caller that needs one state across several reads uses
+ * versions and compare-and-swap, as mutations already do. Sustained interference is bounded
+ * rather than resolved: after MAX_RESTARTS the observation refuses with
+ * {@link ConcurrentReplacementError} instead of attributing bytes to a state it cannot name.
+ * This rests on published bytes being immutable per inode — every write publishes a complete temp
+ * file with `link` or `rename` and never edits a live one — since the bytes are read BEFORE the
+ * post-walk. A non-core writer editing a published file in place is the case it excludes.
+ *
+ * Exactness applies to `rel` segments only. The bundle root is the declared storage context:
+ * a root (tail) segment that already exists as a directory under any spelling is accepted,
+ * and the root's spelling is folded into the lock key rather than verified.
+ *
+ * Every filesystem call goes through a {@link FilesystemIdentityPort} passed to the protocol
+ * functions. Production binds {@link nodeFilesystemIdentityPort} once, as a module constant;
+ * nothing on a backend instance can substitute it. Normalizing stores that rewrite names on
+ * write (legacy HFS+) are unsupported: an id whose NFD form differs from its own form is written
+ * and then refused as an alias on every later observation, never silently aliased.
+ */
+import { InvalidInputError } from "./errors.js";
+export type EntryKind = "file" | "directory" | "symlink" | "other";
+/** The `(dev, ino)` pair that binds a name to a physical entry for one observation. */
+export interface EntryWitness {
+    dev: number;
+    ino: number;
+}
+export interface ProbeResult extends EntryWitness {
+    kind: EntryKind;
+}
+/** A listing entry: spelling and kind only. Listings never carry inodes; witnesses come from `probe`. */
+export interface ListedEntry {
+    name: string;
+    kind: EntryKind;
+}
+/** An opaque open-file token owned by the port; the protocol never inspects it. */
+export type PortHandle = object;
+export interface OpenedFile extends EntryWitness {
+    handle: PortHandle;
+}
+export interface IdentityDescriptor {
+    root: string;
+    rel: string;
+}
+/**
+ * The complete filesystem surface the protocol needs. `probe` is `lstat` and never follows a
+ * symlink; `mkdir` is deliberately NON-recursive: exact directory creation is decided one
+ * segment at a time against the parent listing.
+ */
+export interface FilesystemIdentityPort {
+    /** Host semantics used by the protocol for narrowly platform-specific filesystem recovery. */
+    readonly platform?: NodeJS.Platform;
+    /** `lstat`; `null` when nothing is at the path (ENOENT or ENOTDIR). */
+    probe(target: string): Promise<ProbeResult | null>;
+    /** Directory listing, names and kinds only; `null` when the directory is absent. */
+    entries(dir: string): Promise<ListedEntry[] | null>;
+    /** Open for reading and `fstat` the handle; throws the filesystem error otherwise. */
+    open(target: string): Promise<OpenedFile>;
+    readAll(handle: PortHandle): Promise<Buffer>;
+    close(handle: PortHandle): Promise<void>;
+    stat(target: string): Promise<{
+        mtime: Date;
+    }>;
+    mkdir(dir: string): Promise<"created" | "exists">;
+    writeTemp(dir: string, name: string, bytes: Uint8Array): Promise<void>;
+    /**
+     * Hard-link `from` to `to` without replacing anything: `exists` when ANY entry the host equates
+     * with `to` is present; `unsupported` when the filesystem has no hard links (EPERM, ENOTSUP,
+     * EOPNOTSUPP, EXDEV); other failures throw.
+     */
+    link(from: string, to: string): Promise<"linked" | "exists" | "unsupported">;
+    rename(from: string, to: string): Promise<void>;
+    unlink(target: string): Promise<void>;
+    claim(key: string, identity: IdentityDescriptor): Promise<() => Promise<void>>;
+}
+/**
+ * A symbolic link at a `rel` segment. The walk never follows links: a link's own inode is not the
+ * inode of what opening it would reach, so no exactness verdict is possible. Refused as caller
+ * input (the layout is unsupported) rather than reported as a runtime failure.
+ */
+export declare class FilesystemSymlinkEntryError extends InvalidInputError {
+    readonly rel: string;
+    readonly segment: string;
+    constructor(rel: string, segment: string);
+}
+/**
+ * A regular file where a directory is needed (or the reverse) at an exactly spelled segment.
+ * A runtime state of the bundle, not a caller-input error, so it is not an `InvalidInputError`.
+ */
+export declare class FilesystemShapeMismatchError extends Error {
+    readonly rel: string;
+    readonly segment: string;
+    constructor(rel: string, segment: string);
+}
+/**
+ * NFKD, then Unicode FULL case folding applied as lower-upper-lower (locale-independent). A plain
+ * lower-case fold misses the pairs a case-insensitive host equates through full case mapping
+ * (ß/ss, ẞ/SS, final sigma ς/σ, iota-subscript ᾈ/ἀι and its family): two such spellings would get
+ * different keys, both first-creation writers would realize ABSENT, and the second rename would
+ * silently replace the first document. The round trip through upper case expands every such
+ * pair to a common form, so the fold is a superset of every supported host's equivalence;
+ * over-folding (dotless ı with i) only adds serialization, never removes exclusion.
+ */
+export declare function foldSegment(segment: string): string;
+/**
+ * The lock key for one logical identity `(root, rel)`: a digest of the fully folded physical
+ * root path and the folded `rel`. The WHOLE existing ancestor chain is resolved and folded, so
+ * the key is identical whether it is computed before or after any part of the root is created,
+ * and identical for every case or normalization spelling of any segment. It depends on nothing
+ * else: not the environment, the clock, the process, or the host name.
+ */
+export declare function identityKey(root: string, rel: string): Promise<string>;
+export type ConfirmVerdict = "continue" | "absent" | "aliased" | "restart";
+/**
+ * The confirmed-witness rule for one `rel` segment: a fresh probe of the requested spelling is
+ * compared with the inode recorded for that segment earlier in the same observation, whether or
+ * not the exact spelling is present in the parent listing. A listing on its own is never a
+ * verdict: an entry can be REPLACED under its own spelling (a non-core actor swapping a whole
+ * directory) without the listing changing at all, and that must restart the observation rather
+ * than let records from two different states pass as one EXACT read (I6). ALIASED requires the
+ * probe to reach the recorded inode while the exact spelling is absent; a different inode is
+ * ambiguous (replaced under either spelling, or deleted and recreated) and restarts; a
+ * same-spelling replacement is NOT an alias.
+ */
+export declare function confirmAlias(listingHasExact: boolean, probe: ProbeResult | null, recorded: EntryWitness): ConfirmVerdict;
+export type LeafVerdict = "exact" | "replaced" | "aliased" | "absent";
+export interface LeafSnapshot {
+    /** The exact spelling is present in the fresh listing of the parent. */
+    listed: boolean;
+    /** `probe(parent/leaf)` taken after that listing. */
+    probe: ProbeResult | null;
+    /** The inode the observation is bound to: the open handle's, or the recorded leaf for handle-less observations. */
+    handle: EntryWitness;
+}
+/**
+ * Post-use verdict for the leaf, over the six cells of (listed, probe): the bytes came from the
+ * handle's inode, which must still be what the requested spelling reaches, under its own name.
+ */
+export declare function classifyLeaf(snapshot: LeafSnapshot): LeafVerdict;
+export type MkdirVerdict = "created" | "exact" | "aliased" | "shape-mismatch";
+/**
+ * Verdict for one non-recursive `mkdir` outcome against the parent listing. A `rel` segment
+ * that already exists is exact only under the requested spelling and only as a directory; a
+ * tail (root) segment that already exists as a directory is accepted under any spelling.
+ */
+export declare function classifyMkdir(outcome: "created" | "exists", listing: ListedEntry[], segment: string, isTail: boolean): MkdirVerdict;
+export type Observation<T> = {
+    state: "exact";
+    value: T;
+} | {
+    state: "absent";
+};
+/**
+ * Observe `(root, rel)` without a lock and without writing anything, reading through one open
+ * handle. Every segment is probed and recorded (O-PROBE), verified by listing with inode
+ * confirmation (O-VERIFY), opened and read, then re-verified with fresh listings while the handle
+ * is still open so its inode cannot be recycled (O-POSTVERIFY). Every ambiguous outcome restarts
+ * from O-PROBE, bounded; the handle is closed before any restart opens another.
+ */
+export declare function observeExact<T>(port: FilesystemIdentityPort, root: string, rel: string, read: (handle: PortHandle, target: string) => Promise<T | null>): Promise<Observation<T>>;
+/**
+ * Handle-less observation of presence: the same walks, with the recorded leaf inode standing in
+ * for an open handle. Yields the leaf's kind and witness as verified by the post-walk.
+ */
+export declare function probeExact(port: FilesystemIdentityPort, root: string, rel: string): Promise<Observation<ProbeResult>>;
+export interface MutationContext {
+    /** Realized state of the exact path while the identity lock is held. */
+    readonly state: "exact" | "absent";
+    /** Current bytes at the exact path, `null` when absent; the compare-and-swap basis. */
+    current(): Promise<Buffer | null>;
+    /** Create the missing directory segments exactly, then atomically replace the leaf. */
+    replace(bytes: Uint8Array): Promise<void>;
+    remove(): Promise<void>;
+}
+/**
+ * Mutate `(root, rel)` inside its identity lock: claim the key, realize the exact state, and let
+ * `body` decide (compare-and-swap, delete-of-absent) before anything is written. An alias at
+ * any segment, a conflict, or an early return leaves the bundle untouched; the bundle root and
+ * missing directories are created only by `replace`. The lock is released on every path.
+ */
+export declare function mutateExact<T>(port: FilesystemIdentityPort, root: string, rel: string, body: (context: MutationContext) => Promise<T>): Promise<T>;
+/** The one production binding: `node:fs`, the temp-file convention, and the identity lock. */
+export declare const nodeFilesystemIdentityPort: FilesystemIdentityPort;
+//# sourceMappingURL=filesystem-identity.d.ts.map

package/dist/filesystem-identity.d.ts.map

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