@untangle-code/storage-local 0.0.0-stage → 0.1.0

package/dist/embedding-cache.js

@@ -0,0 +1,229 @@
+/**
+ * Persistent embedding cache under `cache/embeddings/` (architecture.md §12;
+ * spec.md §9.4: cache key `embedding_profile_id + SHA256(prepared_text)`,
+ * "Unveränderte vorbereitete Texte DÜRFEN NICHT erneut eingebettet werden,
+ * sofern der Cache gültig ist").
+ *
+ * Layout:
+ * - one entry file per cached vector, sharded two hex characters deep
+ *   (`<hash[0:2]>/<hash>.json`) so a large cache never puts thousands of
+ *   files in one directory;
+ * - one small `index.json` manifest tracking, per logical cache key, which
+ *   entry file holds it, its size, and its last-access time — the LRU
+ *   bookkeeping used for size-bounded eviction.
+ *
+ * Every mutation (`set`, and `get` on a hit, since a hit updates recency)
+ * rewrites the manifest via atomic temp+rename. This is O(entry count) per
+ * call, a documented, accepted simplification for an MVP-sized local cache
+ * (see README "Entscheidungen") — not the right shape for a cache with
+ * millions of entries, which would want a real embedded index instead of one
+ * JSON file.
+ *
+ * Reads degrade in a controlled way rather than throwing (docs/BUILD_PLAN.md
+ * WP-12 acceptance: "Cache-Löschung ist verlustfrei rekonstruierbar (Reads
+ * degradieren kontrolliert)"): a missing entry file, a corrupted entry, or a
+ * corrupted manifest are all treated as a cache miss (or an empty cache),
+ * self-healing the manifest where relevant — never a thrown error, because
+ * the cache is documented as disposable and reconstructible from source
+ * (architecture.md §12: "Lokale Caches sind löschbar und rekonstruierbar").
+ */
+import * as nodePath from "node:path";
+import { sha256Hex } from "@untangle-code/domain";
+import { assertNotAborted } from "./abort.js";
+import { isNotFoundError } from "./fs-errors.js";
+/** 512 MiB — an Untangle default, not spec-mandated (spec.md §9.4 leaves the
+ * limit open); callers pass their own `maxBytes` where config specifies one. */
+export const DEFAULT_EMBEDDING_CACHE_MAX_BYTES = 512 * 1024 * 1024;
+const MANIFEST_FILE_NAME = "index.json";
+function encode(text) {
+    return new TextEncoder().encode(text);
+}
+function signalOptions(options) {
+    return options?.signal ? { signal: options.signal } : undefined;
+}
+function totalBytesOf(manifest) {
+    let total = 0;
+    for (const entry of Object.values(manifest.entries)) {
+        total += entry.sizeBytes;
+    }
+    return total;
+}
+function pickEvictionCandidate(manifest, protectedKey) {
+    const keys = Object.keys(manifest.entries);
+    let best = null;
+    let bestAccess = Number.POSITIVE_INFINITY;
+    for (const key of keys) {
+        if (key === protectedKey && keys.length === 1) {
+            // The just-written entry is the sole entry left — evicting it would
+            // silently discard the very value `set()` was asked to store. A
+            // single entry larger than `maxBytes` is kept anyway (documented edge
+            // case, README "Entscheidungen") rather than making `set()` a no-op.
+            continue;
+        }
+        const entry = manifest.entries[key];
+        if (entry !== undefined && entry.lastAccessEpochMs < bestAccess) {
+            bestAccess = entry.lastAccessEpochMs;
+            best = key;
+        }
+    }
+    return best;
+}
+/**
+ * Cache key exactly per spec.md §9.4: `embedding_profile_id + SHA256(prepared_text)`.
+ * Exported so callers/tests can reason about identity without depending on
+ * this class's internal file sharding.
+ */
+export function buildEmbeddingCacheKey(embeddingProfileId, preparedText) {
+    return `${embeddingProfileId}${sha256Hex(preparedText)}`;
+}
+export class LocalEmbeddingCache {
+    fs;
+    dir;
+    clock;
+    random;
+    maxBytes;
+    manifest = null;
+    constructor(fs, dir, clock, random, options) {
+        this.fs = fs;
+        this.dir = dir;
+        this.clock = clock;
+        this.random = random;
+        this.maxBytes = options?.maxBytes ?? DEFAULT_EMBEDDING_CACHE_MAX_BYTES;
+    }
+    manifestPath() {
+        return nodePath.join(this.dir, MANIFEST_FILE_NAME);
+    }
+    entryFileName(logicalKey) {
+        const hash = sha256Hex(logicalKey);
+        return nodePath.join(hash.slice(0, 2), `${hash}.json`);
+    }
+    entryPath(fileName) {
+        return nodePath.join(this.dir, fileName);
+    }
+    async loadManifest(options) {
+        if (this.manifest !== null) {
+            return this.manifest;
+        }
+        let text;
+        try {
+            text = await this.fs.readTextFile(this.manifestPath(), options);
+        }
+        catch (error) {
+            if (isNotFoundError(error)) {
+                this.manifest = { version: 1, entries: {} };
+                return this.manifest;
+            }
+            throw error;
+        }
+        try {
+            const parsed = JSON.parse(text);
+            this.manifest =
+                parsed.entries !== undefined
+                    ? { version: 1, entries: parsed.entries }
+                    : { version: 1, entries: {} };
+        }
+        catch {
+            // Corrupted manifest — degrade to an empty cache (see file doc comment).
+            this.manifest = { version: 1, entries: {} };
+        }
+        return this.manifest;
+    }
+    async persistManifest(manifest, options) {
+        await this.fs.mkdir(this.dir, { recursive: true, ...signalOptions(options) });
+        const tempPath = `${this.manifestPath()}.${this.random.uuid()}.tmp`;
+        await this.fs.writeFile(tempPath, encode(JSON.stringify(manifest)), options);
+        await this.fs.rename(tempPath, this.manifestPath(), options);
+        this.manifest = manifest;
+    }
+    async get(embeddingProfileId, preparedText, options) {
+        assertNotAborted(options, "embedding_cache_get");
+        const logicalKey = buildEmbeddingCacheKey(embeddingProfileId, preparedText);
+        const manifest = await this.loadManifest(options);
+        const entry = manifest.entries[logicalKey];
+        if (entry === undefined) {
+            return null;
+        }
+        let text;
+        try {
+            text = await this.fs.readTextFile(this.entryPath(entry.fileName), options);
+        }
+        catch (error) {
+            if (!isNotFoundError(error)) {
+                throw error;
+            }
+            // Manifest references a file that is gone — self-heal and miss.
+            delete manifest.entries[logicalKey];
+            await this.persistManifest(manifest, options);
+            return null;
+        }
+        let stored;
+        try {
+            stored = JSON.parse(text);
+        }
+        catch {
+            delete manifest.entries[logicalKey];
+            await this.persistManifest(manifest, options);
+            return null;
+        }
+        entry.lastAccessEpochMs = this.clock.nowEpochMs();
+        await this.persistManifest(manifest, options);
+        return stored.vector;
+    }
+    async set(embeddingProfileId, preparedText, vector, options) {
+        assertNotAborted(options, "embedding_cache_set");
+        const logicalKey = buildEmbeddingCacheKey(embeddingProfileId, preparedText);
+        const fileName = this.entryFileName(logicalKey);
+        const entryPath = this.entryPath(fileName);
+        const stored = { profileId: embeddingProfileId, vector: Array.from(vector) };
+        const bytes = encode(JSON.stringify(stored));
+        await this.fs.mkdir(nodePath.dirname(entryPath), {
+            recursive: true,
+            ...signalOptions(options),
+        });
+        const tempPath = `${entryPath}.${this.random.uuid()}.tmp`;
+        await this.fs.writeFile(tempPath, bytes, options);
+        await this.fs.rename(tempPath, entryPath, options);
+        const manifest = await this.loadManifest(options);
+        manifest.entries[logicalKey] = {
+            fileName,
+            sizeBytes: bytes.length,
+            lastAccessEpochMs: this.clock.nowEpochMs(),
+        };
+        await this.evictUntilWithinLimit(manifest, logicalKey, options);
+        await this.persistManifest(manifest, options);
+    }
+    async evictUntilWithinLimit(manifest, justWrittenKey, options) {
+        let total = totalBytesOf(manifest);
+        while (total > this.maxBytes) {
+            const victim = pickEvictionCandidate(manifest, justWrittenKey);
+            if (victim === null) {
+                break;
+            }
+            const entry = manifest.entries[victim];
+            delete manifest.entries[victim];
+            if (entry !== undefined) {
+                total -= entry.sizeBytes;
+                try {
+                    await this.fs.remove(this.entryPath(entry.fileName), options);
+                }
+                catch {
+                    // Best-effort: the manifest entry is already gone either way, so a
+                    // future `get()` for this key will miss regardless.
+                }
+            }
+        }
+    }
+    async stats(options) {
+        assertNotAborted(options, "embedding_cache_stats");
+        const manifest = await this.loadManifest(options);
+        return { entryCount: Object.keys(manifest.entries).length, totalBytes: totalBytesOf(manifest) };
+    }
+    /** Explicit, whole-cache removal (the one "clear everything" operation this
+     * class exposes — always naming its exact target: this cache's own directory). */
+    async clear(options) {
+        assertNotAborted(options, "embedding_cache_clear");
+        await this.fs.remove(this.dir, { recursive: true, ...signalOptions(options) });
+        this.manifest = { version: 1, entries: {} };
+    }
+}
+//# sourceMappingURL=embedding-cache.js.map

package/dist/embedding-cache.js.map

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

package/dist/fs-errors.d.ts

@@ -0,0 +1,4 @@
+/** Shared Node `fs` error-code checks used across this package's adapters. */
+export declare function isNotFoundError(error: unknown): boolean;
+export declare function isAlreadyExistsError(error: unknown): boolean;
+//# sourceMappingURL=fs-errors.d.ts.map

package/dist/fs-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-errors.d.ts","sourceRoot":"","sources":["../src/fs-errors.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOvD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAO5D"}

package/dist/fs-errors.js

@@ -0,0 +1,14 @@
+/** Shared Node `fs` error-code checks used across this package's adapters. */
+export function isNotFoundError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+export function isAlreadyExistsError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "EEXIST");
+}
+//# sourceMappingURL=fs-errors.js.map

package/dist/fs-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-errors.js","sourceRoot":"","sources":["../src/fs-errors.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACd,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACd,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAChD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @untangle-code/storage-local — local state under `.untangle/`
+ * (architecture.md §12, §21.1–§21.2; spec.md §11.2, §12.3, §24).
+ *
+ * This module is the ONLY public export of the package.
+ */
+export * from "./layout.js";
+export * from "./local-file-system.js";
+export * from "./lock-provider.js";
+export * from "./checkpoint-store.js";
+export * from "./embedding-cache.js";
+export * from "./analysis-cache.js";
+export * from "./search-journey-store.js";
+export * from "./storage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,wBAAwB,CAAC;AAGvC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * @untangle-code/storage-local — local state under `.untangle/`
+ * (architecture.md §12, §21.1–§21.2; spec.md §11.2, §12.3, §24).
+ *
+ * This module is the ONLY public export of the package.
+ */
+// `.untangle/` layout (architecture.md §12)
+export * from "./layout.js";
+// Path-sandboxed `FileSystemPort` adapter (architecture.md §2.1, §23.1)
+export * from "./local-file-system.js";
+// File-based `LockProvider` (architecture.md §21.1–§21.2)
+export * from "./lock-provider.js";
+// Atomic local checkpoint mirror (architecture.md §12, §13.3)
+export * from "./checkpoint-store.js";
+// Persistent, size-bounded embedding cache (spec.md §9.4)
+export * from "./embedding-cache.js";
+// Inhaltsadressierte Caches fuer Parse, Chunk und Komplexitaet (WP-100)
+export * from "./analysis-cache.js";
+// Explizit aktivierte, lokale Dynamic-Product-Complexity-Sessions (Welle 9)
+export * from "./search-journey-store.js";
+// Convenience wiring of the above
+export * from "./storage.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4CAA4C;AAC5C,cAAc,aAAa,CAAC;AAE5B,wEAAwE;AACxE,cAAc,wBAAwB,CAAC;AAEvC,0DAA0D;AAC1D,cAAc,oBAAoB,CAAC;AAEnC,8DAA8D;AAC9D,cAAc,uBAAuB,CAAC;AAEtC,0DAA0D;AAC1D,cAAc,sBAAsB,CAAC;AAErC,wEAAwE;AACxE,cAAc,qBAAqB,CAAC;AAEpC,4EAA4E;AAC5E,cAAc,2BAA2B,CAAC;AAE1C,kCAAkC;AAClC,cAAc,cAAc,CAAC"}

package/dist/layout.d.ts

@@ -0,0 +1,50 @@
+import type { FileSystemPort, PortCallOptions } from "@untangle-code/domain";
+/**
+ * Die drei inhaltsadressierten Analyse-Caches (WP-100). Sie liegen unter
+ * `cache/analysis/`, getrennt nach Art, damit jeder seine eigene
+ * Groessengrenze und seine eigene Trefferquote hat.
+ */
+export interface StateAnalysisCacheLayout {
+    root: string;
+    parse: string;
+    chunk: string;
+    metrics: string;
+}
+export interface StateCacheLayout {
+    root: string;
+    embeddings: string;
+    analysis: StateAnalysisCacheLayout;
+    parser: string;
+    gitBlobs: string;
+}
+export interface StateArtifactsLayout {
+    root: string;
+    diffs: string;
+    visualizations: string;
+}
+/** The full `.untangle/` layout rooted at one absolute directory. */
+export interface StateDirLayout {
+    /** Absolute path to the state directory itself (e.g. `<workspace>/.untangle`). */
+    root: string;
+    cache: StateCacheLayout;
+    jobs: string;
+    locks: string;
+    productComplexity: {
+        root: string;
+        sessions: string;
+    };
+    artifacts: StateArtifactsLayout;
+    logs: string;
+}
+/** Builds the layout's paths under `root`. Pure; performs no I/O. */
+export declare function buildStateDirLayout(root: string): StateDirLayout;
+/** Every directory the layout declares, in an order safe for sequential `mkdir`. */
+export declare function listStateDirLayoutPaths(layout: StateDirLayout): string[];
+/**
+ * Creates every directory of the layout (idempotent — safe to call on every
+ * startup). Directories are created one at a time with `recursive: true` so
+ * a partially-created layout from a previous aborted run is completed
+ * without error.
+ */
+export declare function ensureStateDirLayout(fs: FileSystemPort, layout: StateDirLayout, options?: PortCallOptions): Promise<void>;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7E;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,oBAAoB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAgChE;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAoBxE;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/layout.js

@@ -0,0 +1,99 @@
+/**
+ * `.untangle/` local state directory layout (architecture.md §12).
+ *
+ * ```text
+ * .untangle/
+ * ├─ cache/
+ * │  ├─ embeddings/
+ * │  ├─ analysis/        (WP-100: parse/, chunk/, metrics/)
+ * │  ├─ parser/
+ * │  └─ git-blobs/
+ * ├─ jobs/
+ * ├─ locks/
+ * ├─ product-complexity/
+ * │  └─ sessions/
+ * ├─ artifacts/
+ * │  ├─ diffs/
+ * │  └─ visualizations/
+ * └─ logs/
+ * ```
+ *
+ * Pure path arithmetic only — no I/O. `ensureStateDirLayout` is the one
+ * function that actually touches the filesystem, via an injected
+ * `FileSystemPort` (never `node:fs` directly), so layout construction stays
+ * testable without a real disk.
+ */
+import path from "node:path";
+import { assertNotAborted } from "./abort.js";
+/** Builds the layout's paths under `root`. Pure; performs no I/O. */
+export function buildStateDirLayout(root) {
+    const cacheRoot = path.join(root, "cache");
+    const analysisRoot = path.join(cacheRoot, "analysis");
+    const artifactsRoot = path.join(root, "artifacts");
+    const productComplexityRoot = path.join(root, "product-complexity");
+    return {
+        root,
+        cache: {
+            root: cacheRoot,
+            embeddings: path.join(cacheRoot, "embeddings"),
+            analysis: {
+                root: analysisRoot,
+                parse: path.join(analysisRoot, "parse"),
+                chunk: path.join(analysisRoot, "chunk"),
+                metrics: path.join(analysisRoot, "metrics"),
+            },
+            parser: path.join(cacheRoot, "parser"),
+            gitBlobs: path.join(cacheRoot, "git-blobs"),
+        },
+        jobs: path.join(root, "jobs"),
+        locks: path.join(root, "locks"),
+        productComplexity: {
+            root: productComplexityRoot,
+            sessions: path.join(productComplexityRoot, "sessions"),
+        },
+        artifacts: {
+            root: artifactsRoot,
+            diffs: path.join(artifactsRoot, "diffs"),
+            visualizations: path.join(artifactsRoot, "visualizations"),
+        },
+        logs: path.join(root, "logs"),
+    };
+}
+/** Every directory the layout declares, in an order safe for sequential `mkdir`. */
+export function listStateDirLayoutPaths(layout) {
+    return [
+        layout.root,
+        layout.cache.root,
+        layout.cache.embeddings,
+        layout.cache.analysis.root,
+        layout.cache.analysis.parse,
+        layout.cache.analysis.chunk,
+        layout.cache.analysis.metrics,
+        layout.cache.parser,
+        layout.cache.gitBlobs,
+        layout.jobs,
+        layout.locks,
+        layout.productComplexity.root,
+        layout.productComplexity.sessions,
+        layout.artifacts.root,
+        layout.artifacts.diffs,
+        layout.artifacts.visualizations,
+        layout.logs,
+    ];
+}
+/**
+ * Creates every directory of the layout (idempotent — safe to call on every
+ * startup). Directories are created one at a time with `recursive: true` so
+ * a partially-created layout from a previous aborted run is completed
+ * without error.
+ */
+export async function ensureStateDirLayout(fs, layout, options) {
+    for (const dir of listStateDirLayoutPaths(layout)) {
+        assertNotAborted(options, "ensure_state_dir_layout");
+        await fs.mkdir(dir, {
+            recursive: true,
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+    }
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

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

package/dist/local-file-system.d.ts

@@ -0,0 +1,37 @@
+import type { DirEntryV1, FileStatV1, FileSystemPort, FileWriteOptions, PortCallOptions } from "@untangle-code/domain";
+/**
+ * Node-backed, path-sandboxed `FileSystemPort`. Construct one per set of
+ * roots that should be reachable (typically just the `.untangle` state
+ * directory for this package's own callers).
+ */
+export declare class LocalFileSystem implements FileSystemPort {
+    private readonly roots;
+    constructor(roots: readonly string[]);
+    /**
+     * Lexical sandbox check (throws `PATH_OUTSIDE_WORKSPACE` on escape), plus a
+     * real-path re-check via {@link resolveAsFarAsPossible} on BOTH the
+     * candidate and the configured roots — needed on both sides: the candidate
+     * may not exist yet (`writeFile`/`mkdir` of a new entry) and a root itself
+     * may contain an unresolved symlink segment (e.g. macOS'
+     * `/var` → `/private/var`) that would otherwise make every path under it
+     * look like an escape. Recomputed per call rather than cached, since which
+     * prefix of a root already exists changes over the adapter's lifetime
+     * (the root itself usually does not exist yet on first use).
+     */
+    private guard;
+    stat(path: string, options?: PortCallOptions): Promise<FileStatV1 | null>;
+    lstat(path: string, options?: PortCallOptions): Promise<FileStatV1 | null>;
+    readFile(path: string, options?: PortCallOptions): Promise<Uint8Array>;
+    readTextFile(path: string, options?: PortCallOptions): Promise<string>;
+    readDir(path: string, options?: PortCallOptions): Promise<DirEntryV1[]>;
+    realPath(path: string, options?: PortCallOptions): Promise<string>;
+    writeFile(path: string, data: Uint8Array, options?: FileWriteOptions): Promise<void>;
+    mkdir(path: string, options?: PortCallOptions & {
+        recursive?: boolean;
+    }): Promise<void>;
+    rename(from: string, to: string, options?: PortCallOptions): Promise<void>;
+    remove(path: string, options?: PortCallOptions & {
+        recursive?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=local-file-system.d.ts.map

package/dist/local-file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-system.d.ts","sourceRoot":"","sources":["../src/local-file-system.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAwE/B;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAEvB,KAAK,EAAE,SAAS,MAAM,EAAE;IAS3C;;;;;;;;;;OAUG;YACW,KAAK;IAQN,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAczE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAc1E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAOtE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAMtE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAgBvE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlE,SAAS,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC;IAMH,KAAK,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAClD,OAAO,CAAC,IAAI,CAAC;IAMH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1E,MAAM,CACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAClD,OAAO,CAAC,IAAI,CAAC;CAKjB"}