@tickernelz/paperclip-pro-adapter-utils 2026.1006.0 → 2026.1006.2

package/dist/workspace-manifest.js

@@ -0,0 +1,257 @@
+import { createHash } from "node:crypto";
+import { constants, promises as fs } from "node:fs";
+import nodeFs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { DatabaseSync } from "node:sqlite";
+// Limits apply to one record and to SQLite's page cache, never to the list.
+export const WORKSPACE_PATH_MAX_BYTES = 64 * 1024;
+export const WORKSPACE_STREAM_CHUNK_BYTES = 64 * 1024;
+const DISK_CHECK_INTERVAL_BYTES = 1024 * 1024;
+/** A capacity floor, not a total filename budget. Leave room for the host. */
+export function assertWorkspaceManifestDiskSpace(directory, requiredBytes = 0) {
+    const configured = Number(process.env.PAPERCLIP_WORKSPACE_MANIFEST_MIN_FREE_BYTES);
+    const minimum = Number.isSafeInteger(configured) && configured >= 64 * 1024 * 1024
+        ? configured : 256 * 1024 * 1024;
+    const stat = nodeFs.statfsSync(directory, { bigint: true });
+    if (stat.bavail * stat.bsize < BigInt(minimum) + BigInt(requiredBytes)) {
+        throw Object.assign(new Error("Workspace manifest storage is below its free-space reserve"), {
+            code: "workspace_git_scan_failed",
+        });
+    }
+    return Number(stat.bavail * stat.bsize - BigInt(minimum));
+}
+export function assertWorkspaceRelativePath(value) {
+    if (!value || value.includes("\0") || path.posix.isAbsolute(value) || path.win32.isAbsolute(value)
+        || value.split(/[\\/]/).some((part) => part === ".." || part === ".")
+        || Buffer.byteLength(value) > WORKSPACE_PATH_MAX_BYTES) {
+        throw new Error("Invalid workspace manifest path");
+    }
+}
+export function isPathManifest(value) {
+    return !Array.isArray(value);
+}
+function openDatabase(filePath, readOnly = true) {
+    const db = new DatabaseSync(filePath, { readOnly, allowExtension: false });
+    try {
+        db.exec("PRAGMA trusted_schema=OFF; PRAGMA cache_size=-1024; PRAGMA temp_store=FILE; PRAGMA mmap_size=0;");
+        return db;
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+}
+/** One private database, sealed before it is published. Consumers open read-only. */
+export class WorkspaceManifestWriter {
+    filePath;
+    db;
+    insert;
+    closed = false;
+    bytesSinceDiskCheck = 0;
+    constructor(filePath) {
+        this.filePath = filePath;
+        const availableBytes = assertWorkspaceManifestDiskSpace(path.dirname(filePath));
+        this.db = openDatabase(filePath, false);
+        try {
+            // Admission follows current storage capacity, not filename-list length.
+            // SQLite enforces this before allocating pages, including within a chunk.
+            const pageSize = Number(this.db.prepare("PRAGMA page_size").get().page_size);
+            const pageAllowance = Math.floor(availableBytes / 4 / pageSize);
+            if (pageAllowance < 2)
+                throw new Error("Insufficient workspace manifest disk allowance");
+            this.db.exec(`PRAGMA max_page_count=${Math.min(pageAllowance, 4_294_967_294)}`);
+            this.db.exec("PRAGMA journal_mode=DELETE; CREATE TABLE records(category TEXT, path TEXT, value TEXT NOT NULL, PRIMARY KEY(category,path)) WITHOUT ROWID;");
+            this.insert = this.db.prepare("INSERT OR REPLACE INTO records VALUES(?,?,?)");
+            this.db.exec("BEGIN");
+        }
+        catch (error) {
+            this.db.close();
+            throw error;
+        }
+    }
+    add(category, relative, value = "") {
+        assertWorkspaceRelativePath(relative);
+        if (Buffer.byteLength(value) > WORKSPACE_PATH_MAX_BYTES)
+            throw new Error("Workspace manifest value exceeds record limit");
+        this.bytesSinceDiskCheck += Buffer.byteLength(relative) + Buffer.byteLength(value);
+        if (this.bytesSinceDiskCheck >= DISK_CHECK_INTERVAL_BYTES) {
+            assertWorkspaceManifestDiskSpace(path.dirname(this.filePath));
+            this.bytesSinceDiskCheck = 0;
+        }
+        this.insert.run(category, relative, value);
+    }
+    batch(work) {
+        this.db.exec("SAVEPOINT chunk");
+        try {
+            work();
+            this.db.exec("RELEASE chunk");
+        }
+        catch (error) {
+            // SQLITE_FULL can roll back the transaction itself.
+            if (this.db.isTransaction)
+                this.db.exec("ROLLBACK TO chunk; RELEASE chunk");
+            throw error;
+        }
+    }
+    paths(category) {
+        const row = this.db.prepare("SELECT count(*) AS count FROM records WHERE category=?").get(category);
+        return { kind: "path_manifest", version: 1, filePath: this.filePath, category, count: Number(row.count) };
+    }
+    close(commit = true) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        try {
+            if (this.db.isTransaction)
+                this.db.exec(commit ? "COMMIT" : "ROLLBACK");
+        }
+        finally {
+            this.db.close();
+        }
+    }
+}
+export class WorkspaceManifestMap {
+    manifest;
+    parse;
+    db = null;
+    lookup = null;
+    constructor(manifest, parse) {
+        this.manifest = manifest;
+        this.parse = parse;
+    }
+    get size() { return this.manifest.count; }
+    get(relative) {
+        this.db ??= openDatabase(this.manifest.filePath);
+        this.lookup ??= this.db.prepare("SELECT value FROM records WHERE category=? AND path=?");
+        const row = this.lookup.get(this.manifest.category, relative);
+        return row ? this.parse(String(row.value)) : undefined;
+    }
+    has(relative) { return this.get(relative) !== undefined; }
+    *entries(reverse = false) {
+        for (const [relative, value] of readManifestRecords(this.manifest, reverse))
+            yield [relative, this.parse(value)];
+    }
+    [Symbol.iterator]() { return this.entries(); }
+    close() { this.db?.close(); this.db = null; this.lookup = null; }
+}
+export async function createWorkspaceManifest(prefix = "paperclip-workspace-manifest-") {
+    const directory = await fs.mkdtemp(path.join(os.tmpdir(), prefix));
+    try {
+        return new WorkspaceManifestWriter(path.join(directory, "paths.sqlite"));
+    }
+    catch (error) {
+        await fs.rm(directory, { recursive: true, force: true });
+        throw error;
+    }
+}
+export function* readManifestRecords(manifest, reverse = false) {
+    const db = openDatabase(manifest.filePath);
+    let count = 0;
+    try {
+        for (const row of db.prepare(`SELECT path,value FROM records WHERE category=? ORDER BY path ${reverse ? "DESC" : "ASC"}`).iterate(manifest.category)) {
+            const relative = String(row.path);
+            const value = String(row.value);
+            assertWorkspaceRelativePath(relative);
+            if (Buffer.byteLength(value) > WORKSPACE_PATH_MAX_BYTES)
+                throw new Error("Invalid workspace manifest record");
+            count++;
+            yield [relative, value];
+        }
+        if (count !== manifest.count)
+            throw new Error("Incomplete workspace manifest");
+    }
+    finally {
+        db.close();
+    }
+}
+export function* workspacePaths(paths) {
+    if (isPathManifest(paths)) {
+        for (const [relative] of readManifestRecords(paths))
+            yield relative;
+    }
+    else {
+        for (const relative of paths) {
+            assertWorkspaceRelativePath(relative);
+            yield relative;
+        }
+    }
+}
+/** Exact paths and their descendants; Git ignore output is literal, not a glob. */
+export function workspacePathMatcher(paths) {
+    const db = paths && isPathManifest(paths) ? openDatabase(paths.filePath) : null;
+    const lookup = db?.prepare("SELECT 1 FROM records WHERE category=? AND path=?");
+    return {
+        matches(relative) {
+            let current = relative;
+            while (current) {
+                if (lookup && paths && isPathManifest(paths)
+                    ? Boolean(lookup.get(paths.category, current))
+                    : paths?.includes(current))
+                    return true;
+                const slash = current.lastIndexOf("/");
+                if (slash < 0)
+                    break;
+                current = current.slice(0, slash);
+            }
+            return false;
+        },
+        close() { db?.close(); },
+    };
+}
+/** Incremental NUL parser: one bounded record, strict UTF-8, no partial success. */
+export class WorkspaceNulParser {
+    record;
+    pending = Buffer.alloc(WORKSPACE_PATH_MAX_BYTES);
+    length = 0;
+    decoder = new TextDecoder("utf-8", { fatal: true });
+    constructor(record) {
+        this.record = record;
+    }
+    write(chunk) {
+        let start = 0;
+        while (start < chunk.length) {
+            const end = chunk.indexOf(0, start);
+            const stop = end < 0 ? chunk.length : end;
+            const size = stop - start;
+            if (this.length + size > this.pending.length)
+                throw new Error("Workspace filename exceeds per-record limit");
+            chunk.copy(this.pending, this.length, start, stop);
+            this.length += size;
+            if (end < 0)
+                return;
+            if (!this.length)
+                throw new Error("Empty workspace filename record");
+            this.record(this.decoder.decode(this.pending.subarray(0, this.length)));
+            this.length = 0;
+            start = end + 1;
+        }
+    }
+    finish() { if (this.length)
+        throw new Error("Incomplete NUL-delimited workspace scan"); }
+}
+export async function writeWorkspacePaths(paths, target) {
+    const file = await fs.open(target, "wx", 0o600);
+    try {
+        for (const relative of workspacePaths(paths))
+            await file.writeFile(`${relative}\0`);
+    }
+    finally {
+        await file.close();
+    }
+}
+export async function manifestFileSha256(filePath) {
+    const file = await fs.open(filePath, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        if (!(await file.stat()).isFile())
+            throw new Error("Invalid workspace manifest file");
+        const digest = createHash("sha256");
+        for await (const chunk of file.createReadStream({ autoClose: false }))
+            digest.update(chunk);
+        return digest.digest("hex");
+    }
+    finally {
+        await file.close();
+    }
+}
+//# sourceMappingURL=workspace-manifest.js.map

package/dist/workspace-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manifest.js","sourceRoot":"","sources":["../src/workspace-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAE/D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,IAAI,CAAC;AAClD,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,CAAC;AACtD,MAAM,yBAAyB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,8EAA8E;AAC9E,MAAM,UAAU,gCAAgC,CAAC,SAAiB,EAAE,aAAa,GAAG,CAAC;IACnF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI;QAChF,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QACvE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,EAAE;YAC3F,IAAI,EAAE,2BAA2B;SAClC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5D,CAAC;AAUD,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;WAC7F,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC;WAClE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,wBAAwB,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,QAAQ,GAAG,IAAI;IACrD,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,iGAAiG,CAAC,CAAC;QAC3G,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;AAC9C,CAAC;AAED,qFAAqF;AACrF,MAAM,OAAO,uBAAuB;IAKb,QAAQ;IAJZ,EAAE,CAAe;IACjB,MAAM,CAAgB;IAC/B,MAAM,GAAG,KAAK,CAAC;IACf,mBAAmB,GAAG,CAAC,CAAC;IAChC,YAAqB,QAAgB;wBAAhB,QAAQ;QAC3B,MAAM,cAAc,GAAG,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,wEAAwE;YACxE,0EAA0E;YAC1E,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,GAAG,EAAG,CAAC,SAAS,CAAC,CAAC;YAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;YAChE,IAAI,aAAa,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACzF,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,yBAAyB,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;YAChF,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,4IAA4I,CAAC,CAAC;YAC3J,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;YAC9E,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;IACnD,CAAC;IACD,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAE,KAAK,GAAG,EAAE;QAChD,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,wBAAwB;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC1H,IAAI,CAAC,mBAAmB,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACnF,IAAI,IAAI,CAAC,mBAAmB,IAAI,yBAAyB,EAAE,CAAC;YAC1D,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,KAAK,CAAC,IAAgB;QACpB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChC,IAAI,CAAC;YAAC,IAAI,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAAC,CAAC;QAC9C,OAAO,KAAK,EAAE,CAAC;YACb,oDAAoD;YACpD,IAAI,IAAI,CAAC,EAAE,CAAC,aAAa;gBAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YAC5E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,KAAK,CAAC,QAAgB;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,wDAAwD,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;QACrG,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5G,CAAC;IACD,KAAK,CAAC,MAAM,GAAG,IAAI;QACjB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC;YAAC,IAAI,IAAI,CAAC,EAAE,CAAC,aAAa;gBAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;gBACxE,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,oBAAoB;IAGV,QAAQ;IAAiC,KAAK;IAF3D,EAAE,GAAwB,IAAI,CAAC;IAC/B,MAAM,GAAyB,IAAI,CAAC;IAC5C,YAAqB,QAAsB,EAAmB,KAA2B;wBAApE,QAAQ;qBAAiC,KAAK;IAAyB,CAAC;IAC7F,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,GAAG,CAAC,QAAgB;QAClB,IAAI,CAAC,EAAE,KAAK,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uDAAuD,CAAC,CAAC;QACzF,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9D,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IACD,GAAG,CAAC,QAAgB,IAAa,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IAC3E,CAAC,OAAO,CAAC,OAAO,GAAG,KAAK;QACtB,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;YAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACnH,CAAC;IACD,CAAC,MAAM,CAAC,QAAQ,CAAC,KAA6B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACtE,KAAK,KAAW,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CACxE;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAAM,GAAG,+BAA+B;IACpF,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC;QAAC,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;IAAC,CAAC;IACjF,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;AAC1F,CAAC;AAED,MAAM,SAAS,CAAC,CAAC,mBAAmB,CAAC,QAAsB,EAAE,OAAO,GAAG,KAAK;IAC1E,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,OAAO,CAAC,iEAAiE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrJ,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChC,2BAA2B,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,wBAAwB;gBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YAC9G,KAAK,EAAE,CAAC;YACR,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,KAAK,KAAK,QAAQ,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACjF,CAAC;YAAS,CAAC;QAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AAC3B,CAAC;AAED,MAAM,SAAS,CAAC,CAAC,cAAc,CAAC,KAAqB;IACnD,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,mBAAmB,CAAC,KAAK,CAAC;YAAE,MAAM,QAAQ,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC;YAAC,MAAM,QAAQ,CAAC;QAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAAC,KAAsB;IACzD,MAAM,EAAE,GAAG,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,MAAM,MAAM,GAAG,EAAE,EAAE,OAAO,CAAC,mDAAmD,CAAC,CAAC;IAChF,OAAO;QACL,OAAO,CAAC,QAAQ;YACd,IAAI,OAAO,GAAG,QAAQ,CAAC;YACvB,OAAO,OAAO,EAAE,CAAC;gBACf,IAAI,MAAM,IAAI,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC;oBAC1C,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBAC9C,CAAC,CAAE,KAAuC,EAAE,QAAQ,CAAC,OAAO,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBACvC,IAAI,KAAK,GAAG,CAAC;oBAAE,MAAM;gBACrB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,OAAO,kBAAkB;IAIA,MAAM;IAHlB,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1D,MAAM,GAAG,CAAC,CAAC;IACF,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,YAA6B,MAAkC;sBAAlC,MAAM;IAA+B,CAAC;IACnE,KAAK,CAAC,KAAa;QACjB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;YAC7G,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;YACpB,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO;YACpB,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACxE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAChB,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,MAAM,KAAW,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC,CAAC;CAChG;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAqB,EAAE,MAAc;IAC7E,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,KAAK,MAAM,QAAQ,IAAI,cAAc,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC;IACtF,CAAC;YAAS,CAAC;QAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAChF,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5F,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AACnC,CAAC"}

package/dist/workspace-manifest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace-manifest.test.d.ts.map

package/dist/workspace-manifest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manifest.test.d.ts","sourceRoot":"","sources":["../src/workspace-manifest.test.ts"],"names":[],"mappings":""}

package/dist/workspace-manifest.test.js

@@ -0,0 +1,160 @@
+import fs from "node:fs/promises";
+import nodeFs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, expect, it, vi } from "vitest";
+import { createWorkspaceManifest, readManifestRecords, WorkspaceNulParser, WORKSPACE_PATH_MAX_BYTES, workspacePaths } from "./workspace-manifest.js";
+import { readGitWorkspaceSnapshot, disposeGitWorkspaceSnapshot, runLocalGit, setExpensiveWorkspaceGitExecutor } from "./git-workspace-sync.js";
+const cleanup = [];
+afterEach(async () => {
+    setExpensiveWorkspaceGitExecutor(null);
+    vi.restoreAllMocks();
+    vi.unstubAllEnvs();
+    for (const dir of cleanup.splice(0))
+        await fs.rm(dir, { recursive: true, force: true });
+});
+it("parses split UTF-8 and NUL records while rejecting truncation and oversized records", () => {
+    const names = [];
+    const parser = new WorkspaceNulParser((value) => names.push(value));
+    const bytes = Buffer.from(" 雪\n\t \0-option\0");
+    for (const byte of bytes)
+        parser.write(Buffer.from([byte]));
+    parser.finish();
+    expect(names).toEqual([" 雪\n\t ", "-option"]);
+    parser.write(Buffer.from("unfinished"));
+    expect(() => parser.finish()).toThrow("Incomplete");
+    expect(() => parser.write(Buffer.alloc(WORKSPACE_PATH_MAX_BYTES, 97))).toThrow("per-record");
+    expect(() => new WorkspaceNulParser(() => { }).write(Buffer.from([255, 0]))).toThrow();
+});
+it("deduplicates paths on disk and rejects incomplete manifest metadata", async () => {
+    const writer = await createWorkspaceManifest();
+    cleanup.push(path.dirname(writer.filePath));
+    writer.batch(() => { writer.add("overlay", "b"); writer.add("overlay", "a"); writer.add("overlay", "b"); });
+    const manifest = writer.paths("overlay");
+    writer.close();
+    expect([...workspacePaths(manifest)]).toEqual(["a", "b"]);
+    expect(() => [...readManifestRecords({ ...manifest, count: 3 })]).toThrow("Incomplete");
+    expect(() => [...workspacePaths(["../escape"])]).toThrow("Invalid");
+});
+it("refuses new manifests and fails ongoing writes when the disk reserve is exhausted", async () => {
+    const writer = await createWorkspaceManifest();
+    cleanup.push(path.dirname(writer.filePath));
+    const available = nodeFs.statfsSync(os.tmpdir(), { bigint: true });
+    vi.spyOn(nodeFs, "statfsSync").mockReturnValue({ ...available, bavail: 0n });
+    try {
+        for (let attempt = 0; attempt < 4; attempt++) {
+            await expect(createWorkspaceManifest()).rejects.toMatchObject({ code: "workspace_git_scan_failed" });
+        }
+        expect(() => {
+            for (let index = 0; index < 1024; index++)
+                writer.add("overlay", `${index}-${"x".repeat(2048)}`);
+        }).toThrow("free-space reserve");
+    }
+    finally {
+        writer.close(false);
+    }
+});
+it("admits each snapshot against current disk capacity and rejects growth at its page allowance", async () => {
+    const available = nodeFs.statfsSync(os.tmpdir(), { bigint: true });
+    const reserve = 256 * 1024 * 1024;
+    vi.stubEnv("PAPERCLIP_WORKSPACE_MANIFEST_MIN_FREE_BYTES", String(reserve));
+    const capacity = reserve + 128 * 1024;
+    vi.spyOn(nodeFs, "statfsSync").mockReturnValue({ ...available, bsize: 1n, bavail: BigInt(capacity) });
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const writer = await createWorkspaceManifest();
+        cleanup.push(path.dirname(writer.filePath));
+        try {
+            expect(() => writer.batch(() => {
+                for (let index = 0; index < 100; index++)
+                    writer.add("overlay", `${index}-${"x".repeat(2048)}`);
+            })).toThrow(/full/i);
+            expect((await fs.stat(writer.filePath)).size).toBeLessThanOrEqual(32 * 1024);
+        }
+        finally {
+            writer.close(false);
+        }
+    }
+});
+it("fails a real Git scan at its disk allowance and removes the incomplete manifest", async () => {
+    const repo = await fs.mkdtemp(path.join(os.tmpdir(), "paperclip-scan-quota-"));
+    cleanup.push(repo);
+    await runLocalGit(repo, ["init"]);
+    await runLocalGit(repo, ["commit", "--allow-empty", "-qm", "fixture"], {
+        env: { ...process.env, GIT_AUTHOR_NAME: "Test", GIT_COMMITTER_NAME: "Test", GIT_AUTHOR_EMAIL: "test@example.test", GIT_COMMITTER_EMAIL: "test@example.test" },
+    });
+    for (let index = 0; index < 500; index++)
+        await fs.writeFile(path.join(repo, `${index}-${"x".repeat(200)}`), "");
+    const available = nodeFs.statfsSync(os.tmpdir(), { bigint: true });
+    const reserve = 256 * 1024 * 1024;
+    vi.stubEnv("PAPERCLIP_WORKSPACE_MANIFEST_MIN_FREE_BYTES", String(reserve));
+    vi.spyOn(nodeFs, "statfsSync").mockReturnValue({ ...available, bsize: 1n, bavail: BigInt(reserve + 128 * 1024) });
+    const temporary = [];
+    const mkdtemp = fs.mkdtemp.bind(fs);
+    vi.spyOn(fs, "mkdtemp").mockImplementation(async (prefix, options) => {
+        const directory = await mkdtemp(prefix, options);
+        temporary.push(String(directory));
+        return directory;
+    });
+    await expect(readGitWorkspaceSnapshot(repo)).rejects.toMatchObject({ code: "workspace_git_scan_failed" });
+    expect(temporary).toHaveLength(1);
+    await expect(fs.stat(temporary[0])).rejects.toMatchObject({ code: "ENOENT" });
+});
+it("settles a late producer before removing shared storage after another scan fails", async () => {
+    const repo = await fs.mkdtemp(path.join(os.tmpdir(), "paperclip-scan-barrier-"));
+    cleanup.push(repo);
+    await runLocalGit(repo, ["init"]);
+    await runLocalGit(repo, ["-c", "user.name=Test", "-c", "user.email=test@example.test", "commit", "--allow-empty", "-qm", "fixture"], {
+        env: { ...process.env, GIT_AUTHOR_NAME: "Test", GIT_COMMITTER_NAME: "Test", GIT_AUTHOR_EMAIL: "test@example.test", GIT_COMMITTER_EMAIL: "test@example.test" },
+    });
+    let release;
+    const gate = new Promise((resolve) => { release = resolve; });
+    let lateFinished = false;
+    let settled = false;
+    const removed = [];
+    const originalRm = fs.rm.bind(fs);
+    vi.spyOn(fs, "rm").mockImplementation(async (target, options) => {
+        if (String(target).includes("paperclip-workspace-manifest-")) {
+            expect(lateFinished).toBe(true);
+            removed.push(String(target));
+        }
+        return originalRm(target, options);
+    });
+    const failure = Object.assign(new Error("scan failed"), { code: "workspace_git_scan_failed" });
+    setExpensiveWorkspaceGitExecutor(async (input) => {
+        if (input.operation.endsWith("ignored_files"))
+            throw failure;
+        if (input.operation.endsWith("untracked_files")) {
+            await gate;
+            await input.onStdout(Buffer.from("late-producer\0"));
+            lateFinished = true;
+        }
+        return { stdout: "", stderr: "" };
+    });
+    const result = readGitWorkspaceSnapshot(repo).catch((error) => { settled = true; return error; });
+    await new Promise((resolve) => setTimeout(resolve, 30));
+    expect(settled).toBe(false);
+    expect(removed).toEqual([]);
+    release();
+    expect(await result).toBe(failure);
+    expect(removed).toHaveLength(1);
+    await expect(fs.stat(removed[0])).rejects.toMatchObject({ code: "ENOENT" });
+});
+it("fails a malformed completed scan instead of publishing a partial snapshot", async () => {
+    const repo = await fs.mkdtemp(path.join(os.tmpdir(), "paperclip-truncated-scan-"));
+    cleanup.push(repo);
+    await runLocalGit(repo, ["init"]);
+    await runLocalGit(repo, ["-c", "user.name=Test", "-c", "user.email=test@example.test", "commit", "--allow-empty", "-qm", "fixture"], {
+        env: { ...process.env, GIT_AUTHOR_NAME: "Test", GIT_COMMITTER_NAME: "Test", GIT_AUTHOR_EMAIL: "test@example.test", GIT_COMMITTER_EMAIL: "test@example.test" },
+    });
+    setExpensiveWorkspaceGitExecutor(async (input) => {
+        if (input.operation.endsWith("untracked_files"))
+            await input.onStdout(Buffer.from("complete\0partial"));
+        return { stdout: "", stderr: "" };
+    });
+    await expect(readGitWorkspaceSnapshot(repo)).rejects.toThrow("Incomplete NUL");
+    setExpensiveWorkspaceGitExecutor(null);
+    const recovered = await readGitWorkspaceSnapshot(repo);
+    expect(recovered).not.toBeNull();
+    await disposeGitWorkspaceSnapshot(recovered);
+});
+//# sourceMappingURL=workspace-manifest.test.js.map

package/dist/workspace-manifest.test.js.map

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

package/dist/workspace-restore-diagnostics.d.ts

@@ -0,0 +1,34 @@
+import type { RuntimeProgressSink } from "./runtime-progress.js";
+type RestorePhase = "workspace" | "asset";
+declare const RESTORE_STEPS: Set<"asset_restore" | "directory_merge" | "git_export" | "git_import" | "git_integration" | "git_ref_cleanup" | "index_reset" | "workspace_extract" | "workspace_transfer">;
+export type WorkspaceRestoreStep = typeof RESTORE_STEPS extends Set<infer T> ? T : never;
+declare const GIT_COMMANDS: Set<"commit_tree" | "log" | "merge_base" | "merge_tree" | "rev_parse" | "symbolic_ref" | "update_ref">;
+export type WorkspaceRestoreGitCommand = typeof GIT_COMMANDS extends Set<infer T> ? T : never;
+declare const GIT_FAILURE_KINDS: Set<"invalid_object" | "merge_conflict" | "permission_denied" | "ref_conflict" | "unknown">;
+type GitFailureKind = typeof GIT_FAILURE_KINDS extends Set<infer T> ? T : never;
+export interface WorkspaceRestoreDiagnostic {
+    phase: RestorePhase;
+    step?: WorkspaceRestoreStep;
+    errorCode: string;
+    httpStatus?: number;
+    exitCode?: number;
+    gitCommand?: WorkspaceRestoreGitCommand;
+    gitFailureKind?: GitFailureKind;
+}
+/** Keep each settlement's diagnostic receipt isolated across asynchronous work. */
+export declare function withWorkspaceRestoreDiagnosticCapture<T>(operation: () => Promise<T>): Promise<T>;
+/** Annotate the original thrown error in its restore scope; never change it. */
+export declare function withWorkspaceRestoreGitCommand<T>(command: WorkspaceRestoreGitCommand, operation: () => Promise<T>): Promise<T>;
+/** Retain bounded fields across an existing error wrapper, without a raw cause. */
+export declare function preserveWorkspaceRestoreErrorDiagnostic<T extends object>(wrapper: T, source: unknown): T;
+/** Decode persisted adapter metadata; never copy arbitrary properties or text. */
+export declare function sanitizeWorkspaceRestoreDiagnostic(value: unknown): WorkspaceRestoreDiagnostic | undefined;
+export declare function getWorkspaceRestoreDiagnostic(error: unknown): WorkspaceRestoreDiagnostic | undefined;
+/** Preserve the scheduler-selected task's snapshot when errors share identity. */
+export declare function recordWorkspaceRestoreDiagnostic(error: unknown, diagnostic: WorkspaceRestoreDiagnostic | undefined): void;
+/** Record only the failing step. Successful cleanup must not replace evidence. */
+export declare function withWorkspaceRestoreStep<T>(step: WorkspaceRestoreStep, operation: () => Promise<T>): Promise<T>;
+/** Add evidence without changing the thrown error, restore policy, or task ordering. */
+export declare function withWorkspaceRestoreDiagnostics<T>(phase: RestorePhase, operation: () => Promise<T>, onProgress?: RuntimeProgressSink, onDiagnostic?: (diagnostic: WorkspaceRestoreDiagnostic) => void): Promise<T>;
+export {};
+//# sourceMappingURL=workspace-restore-diagnostics.d.ts.map

package/dist/workspace-restore-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-restore-diagnostics.d.ts","sourceRoot":"","sources":["../src/workspace-restore-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,KAAK,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;AAC1C,QAAA,MAAM,aAAa,6KAGR,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,OAAO,aAAa,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACzF,QAAA,MAAM,YAAY,wGAEP,CAAC;AACZ,MAAM,MAAM,0BAA0B,GAAG,OAAO,YAAY,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAC9F,QAAA,MAAM,iBAAiB,6FAEZ,CAAC;AACZ,KAAK,cAAc,GAAG,OAAO,iBAAiB,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAChF,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,0BAA0B,CAAC;IACxC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAuBD,mFAAmF;AACnF,wBAAgB,qCAAqC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhG;AAmCD,gFAAgF;AAChF,wBAAsB,8BAA8B,CAAC,CAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAcpI;AA6BD,mFAAmF;AACnF,wBAAgB,uCAAuC,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAMxG;AAED,kFAAkF;AAClF,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CA0BzG;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CAGpG;AAED,kFAAkF;AAClF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,0BAA0B,GAAG,SAAS,GAAG,IAAI,CAezH;AAED,kFAAkF;AAClF,wBAAsB,wBAAwB,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAmBrH;AAED,wFAAwF;AACxF,wBAAsB,+BAA+B,CAAC,CAAC,EACrD,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,CAAC,EAAE,mBAAmB,EAChC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,0BAA0B,KAAK,IAAI,GAC9D,OAAO,CAAC,CAAC,CAAC,CAgCZ"}