@superblocksteam/workspace-sync 0.0.0-stage → 2.0.178-next.1

package/dist/sync-paths.js

@@ -0,0 +1,107 @@
+/**
+ * Path rules that decide what the DBFS sync uploads. Moved here from
+ * `vite-plugin-file-sync/src/file-system-helpers.ts`, which re-exports them.
+ */
+/**
+ * App-root names that hold private configuration (credentials, registry
+ * tokens, package-manager hooks). The native sandbox denies the agent access
+ * to them. Matched case-insensitively.
+ */
+export const PRIVATE_CONFIG_NAMES = [
+    ".aws",
+    ".env",
+    ".env.development",
+    ".env.development.local",
+    ".env.local",
+    ".env.production",
+    ".env.production.local",
+    ".env.test",
+    ".env.test.local",
+    ".netrc",
+    ".npmrc",
+    ".npmrc.default",
+    ".pnpmfile.cjs",
+    ".pnpmfile.mjs",
+    ".pnpmrc",
+    ".ssh",
+    ".superblocks",
+];
+export const PRIVATE_CONFIG_PREFIXES = [".env.", ".npmrc."];
+export function isPrivateConfigName(name) {
+    const lower = name.toLowerCase();
+    return (PRIVATE_CONFIG_NAMES.includes(lower) ||
+        PRIVATE_CONFIG_PREFIXES.some((prefix) => lower.startsWith(prefix)));
+}
+/**
+ * Names no upload snapshot includes. `pnpm-workspace.yaml` is read-only to
+ * native tools but still persisted, because it holds the app's pnpm overrides.
+ */
+export function isSnapshotExcludedName(name) {
+    return codeModeExcludedFiles.includes(name) || name === ".superblocks";
+}
+/** Native system skills are generated per pod and never synced. */
+export const NATIVE_SYSTEM_SKILLS_ROOT = "skills/system";
+export const CHECKLIST_PERSISTED_RELATIVE_PATH = ".superblocks/ai/checklist.json";
+const CHECKLIST_PERSISTED_DIR_PREFIX = ".superblocks/ai";
+/**
+ * Sentinel written at the end of the CLI-side brownfield migration that
+ * strips public-host `resolved` URLs from `package-lock.json` and repopulates
+ * them via `npm install` against the active private registry. Lives under
+ * `.superblocks/` (otherwise excluded from sync) but is explicitly persisted
+ * so the migration survives across pod cycles. Path is stable because both
+ * the CLI (writer) and the sync allowlist (reader) need to agree.
+ */
+export const PRIVATE_REGISTRY_MIGRATION_SENTINEL_RELATIVE_PATH = ".superblocks/private-registry-migrated";
+/**
+ * What the CLI's npm-to-pnpm app migration keeps so it can turn a converted
+ * app back into an npm app once pnpm is off for its org: the npm lockfile it
+ * replaced and what it changed. Persisted like the sentinel above, because the
+ * rollback happens on a later pod.
+ */
+export const NPM_TO_PNPM_STATE_RELATIVE_PATH = ".superblocks/npm-to-pnpm.json";
+/** The template ranges whose upgrade failed, so later pods don't retry them. */
+export const TEMPLATE_DEPENDENCIES_STATE_RELATIVE_PATH = ".superblocks/template-dependencies.json";
+export const codeModeExcludedFiles = [".env", ".npmrc"];
+/**
+ * Suffix of the incremental build-info cache files TypeScript writes in build
+ * mode (`tsc -b`). The prefix varies per project (e.g. `tsconfig.tsbuildinfo`,
+ * `tsconfig.client.tsbuildinfo`), so exclusion must be suffix-based rather than
+ * exact-name based.
+ */
+export const TSBUILDINFO_FILE_SUFFIX = ".tsbuildinfo";
+/**
+ * Whether a file (by basename) should be excluded from the dbfs sync. Covers
+ * the enumerated `codeModeExcludedFiles` plus any `*.tsbuildinfo` build cache
+ * emitted by `tsc -b`.
+ */
+export function isCodeModeExcludedFile(name) {
+    return (codeModeExcludedFiles.includes(name) ||
+        name.endsWith(TSBUILDINFO_FILE_SUFFIX));
+}
+function isPersistedChecklistPath(relativePath) {
+    return relativePath === CHECKLIST_PERSISTED_RELATIVE_PATH;
+}
+function isPrivateRegistryMigrationSentinelPath(relativePath) {
+    return relativePath === PRIVATE_REGISTRY_MIGRATION_SENTINEL_RELATIVE_PATH;
+}
+/**
+ * Allowlist for files that live under `.superblocks/` but must still round-
+ * trip through DBFS sync. The directory is otherwise excluded from upload
+ * (see `listLocalDirectory`); anything that needs to persist across pod
+ * cycles has to be enumerated here.
+ */
+export function isPersistedSuperblocksFile(relativePath) {
+    return (isPersistedChecklistPath(relativePath) ||
+        isPrivateRegistryMigrationSentinelPath(relativePath) ||
+        relativePath === NPM_TO_PNPM_STATE_RELATIVE_PATH ||
+        relativePath === TEMPLATE_DEPENDENCIES_STATE_RELATIVE_PATH);
+}
+function isPersistedChecklistAncestorPath(relativePath) {
+    return (relativePath === ".superblocks" ||
+        relativePath === CHECKLIST_PERSISTED_DIR_PREFIX);
+}
+export function isPersistedChecklistPathOrAncestor(relativePath) {
+    return (isPersistedChecklistPath(relativePath) ||
+        isPersistedChecklistAncestorPath(relativePath));
+}
+//# sourceMappingURL=sync-paths.js.map

package/dist/sync-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-paths.js","sourceRoot":"","sources":["../src/sync-paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,MAAM;IACN,MAAM;IACN,kBAAkB;IAClB,wBAAwB;IACxB,YAAY;IACZ,iBAAiB;IACjB,uBAAuB;IACvB,WAAW;IACX,iBAAiB;IACjB,QAAQ;IACR,QAAQ;IACR,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,SAAS;IACT,MAAM;IACN,cAAc;CACf,CAAC;AACF,MAAM,CAAC,MAAM,uBAAuB,GAAsB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAE/E,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,CACL,oBAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC;QACpC,uBAAuB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CACnE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,cAAc,CAAC;AACzE,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CAAC;AAEzD,MAAM,CAAC,MAAM,iCAAiC,GAC5C,gCAAgC,CAAC;AACnC,MAAM,8BAA8B,GAAG,iBAAiB,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAC5D,wCAAwC,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,+BAA+B,CAAC;AAE/E,gFAAgF;AAChF,MAAM,CAAC,MAAM,yCAAyC,GACpD,yCAAyC,CAAC;AAE5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,CACL,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,YAAoB;IACpD,OAAO,YAAY,KAAK,iCAAiC,CAAC;AAC5D,CAAC;AAED,SAAS,sCAAsC,CAAC,YAAoB;IAClE,OAAO,YAAY,KAAK,iDAAiD,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAAoB;IAC7D,OAAO,CACL,wBAAwB,CAAC,YAAY,CAAC;QACtC,sCAAsC,CAAC,YAAY,CAAC;QACpD,YAAY,KAAK,+BAA+B;QAChD,YAAY,KAAK,yCAAyC,CAC3D,CAAC;AACJ,CAAC;AAED,SAAS,gCAAgC,CAAC,YAAoB;IAC5D,OAAO,CACL,YAAY,KAAK,cAAc;QAC/B,YAAY,KAAK,8BAA8B,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,YAAoB;IAEpB,OAAO,CACL,wBAAwB,CAAC,YAAY,CAAC;QACtC,gCAAgC,CAAC,YAAY,CAAC,CAC/C,CAAC;AACJ,CAAC"}

package/dist/sync-telemetry.d.ts

@@ -0,0 +1,12 @@
+import { type Counter, type Gauge, type Histogram, type Meter, type Span, type Tracer } from "@opentelemetry/api";
+export type CommitOutcome = "committed" | "unchanged" | "rejected" | "error";
+export interface SyncTelemetry {
+    tracer: Tracer;
+    commitDuration: Histogram;
+    rehydrateOutcome: Counter;
+    unsynced: Gauge;
+}
+export declare function createSyncTelemetry(tracer: Tracer | undefined, meter: Meter | undefined): SyncTelemetry;
+/** Runs `run` in an active span, recording a thrown error on it. */
+export declare function inSpan<T>(tracer: Tracer, name: string, run: (span: Span) => Promise<T>): Promise<T>;
+//# sourceMappingURL=sync-telemetry.d.ts.map

package/dist/sync-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-telemetry.d.ts","sourceRoot":"","sources":["../src/sync-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,KAAK,EAEV,KAAK,IAAI,EAGT,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAI5B,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,SAAS,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,KAAK,GAAG,SAAS,GACvB,aAAa,CAoBf;AAED,oEAAoE;AACpE,wBAAsB,MAAM,CAAC,CAAC,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CAYZ"}

package/dist/sync-telemetry.js

@@ -0,0 +1,33 @@
+import { metrics, SpanStatusCode, trace, } from "@opentelemetry/api";
+const SCOPE = "superblocks.workspace.sync";
+export function createSyncTelemetry(tracer, meter) {
+    const resolvedMeter = meter ?? metrics.getMeter(SCOPE);
+    return {
+        tracer: tracer ?? trace.getTracer(SCOPE),
+        commitDuration: resolvedMeter.createHistogram("workspace.sync.commit.duration", {
+            description: "Turn-end commit latency, from reconcile to state write.",
+            unit: "s",
+        }),
+        rehydrateOutcome: resolvedMeter.createCounter("workspace.sync.rehydrate.outcome", { description: "Workspace rehydrate results by outcome." }),
+        unsynced: resolvedMeter.createGauge("workspace.sync.unsynced", {
+            description: "1 while the workspace has changes DBFS has not committed, else 0.",
+        }),
+    };
+}
+/** Runs `run` in an active span, recording a thrown error on it. */
+export async function inSpan(tracer, name, run) {
+    return tracer.startActiveSpan(name, async (span) => {
+        try {
+            return await run(span);
+        }
+        catch (error) {
+            span.recordException(error);
+            span.setStatus({ code: SpanStatusCode.ERROR });
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+//# sourceMappingURL=sync-telemetry.js.map

package/dist/sync-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-telemetry.js","sourceRoot":"","sources":["../src/sync-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,OAAO,EAEP,cAAc,EACd,KAAK,GAEN,MAAM,oBAAoB,CAAC;AAE5B,MAAM,KAAK,GAAG,4BAA4B,CAAC;AAW3C,MAAM,UAAU,mBAAmB,CACjC,MAA0B,EAC1B,KAAwB;IAExB,MAAM,aAAa,GAAG,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO;QACL,MAAM,EAAE,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;QACxC,cAAc,EAAE,aAAa,CAAC,eAAe,CAC3C,gCAAgC,EAChC;YACE,WAAW,EAAE,yDAAyD;YACtE,IAAI,EAAE,GAAG;SACV,CACF;QACD,gBAAgB,EAAE,aAAa,CAAC,aAAa,CAC3C,kCAAkC,EAClC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAC3D;QACD,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,yBAAyB,EAAE;YAC7D,WAAW,EACT,mEAAmE;SACtE,CAAC;KACH,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAc,EACd,IAAY,EACZ,GAA+B;IAE/B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,eAAe,CAAC,KAAc,CAAC,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/C,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Test doubles for `@superblocksteam/workspace-sync`, published as the
+ * `@superblocksteam/workspace-sync/testing` subpath. Not for production use.
+ */
+import { type DirectoryEntry } from "@superblocksteam/shared";
+import type { DbfsFileRef, DbfsTransport, SetHashRequest, SetHashResult } from "./dbfs-transport.js";
+import type { PutManyItems } from "./snapshot/upload-snapshot.js";
+/** A file in a {@link FakeDbfs.seed} description. */
+export type FakeDbfsSeedEntry = string | Buffer | {
+    contents: string | Buffer;
+    executable?: boolean;
+} | {
+    symlink: string;
+};
+export interface FakeDbfsCalls {
+    /** Item count of each validateMany call. */
+    validateMany: number[];
+    /** Items of each putMany call. */
+    putMany: PutManyItems[];
+    setHash: SetHashRequest[];
+    setDraftState: boolean[];
+    getDirectory: number;
+    getContents: number;
+    getBlob: number;
+}
+/**
+ * An in-memory, content-addressed DBFS plus one branch's hash pointer. Like
+ * the server, `putMany` refuses a listing whose children are missing and
+ * `validateMany` refuses excluded directory names, so an upload that skips
+ * something it should have sent fails here too.
+ */
+export declare class FakeDbfs implements DbfsTransport {
+    readonly files: Map<string, Buffer<ArrayBufferLike>>;
+    readonly directories: Map<string, DirectoryEntry[]>;
+    serverHash: string | undefined;
+    readonly calls: FakeDbfsCalls;
+    private commits;
+    /** Total putMany items since the last {@link resetCalls}. */
+    get putItemCount(): number;
+    resetCalls(): void;
+    /**
+     * Stores a tree described by slash-separated paths and points the branch at
+     * it, as another writer would. Returns the tree's hash.
+     */
+    seed(tree: Record<string, FakeDbfsSeedEntry>): Promise<string>;
+    /** Stores a tree without moving the branch. Returns its hash. */
+    storeTree(tree: Record<string, FakeDbfsSeedEntry>): Promise<string>;
+    /** Every file and symlink in tree `hash`, by slash-separated path. */
+    readTree(hash?: string | undefined): Promise<Map<string, {
+        contents: Buffer;
+        executable: boolean;
+    } | {
+        symlink: string;
+    }>>;
+    validateMany(items: PutManyItems): Promise<void>;
+    putMany(items: PutManyItems): Promise<string[]>;
+    getDirectory(hash: string): Promise<DirectoryEntry[]>;
+    getContents(rootHash: string, files: DbfsFileRef[]): Promise<Buffer[]>;
+    getBlob(hash: string): Promise<Buffer>;
+    getServerHash(): Promise<string>;
+    setHash(request: SetHashRequest): Promise<SetHashResult>;
+    setDraftState(hasDraft: boolean): Promise<void>;
+    private directory;
+    private blob;
+}
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,MAAM,GACN;IAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kCAAkC;IAClC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,QAAS,YAAW,aAAa;IAC5C,QAAQ,CAAC,KAAK,uCAA6B;IAC3C,QAAQ,CAAC,WAAW,gCAAuC;IAC3D,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAQ3B;IACF,OAAO,CAAC,OAAO,CAAK;IAEpB,6DAA6D;IAC7D,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,UAAU,IAAI,IAAI,CAQjB;IAED;;;OAGG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAInE;IAED,iEAAiE;IAC3D,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCxE;IAED,sEAAsE;IAChE,QAAQ,CACZ,IAAI,qBAAkB,GACrB,OAAO,CACR,GAAG,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAC7E,CAqBA;IAEK,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAYrD;IAEK,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BpD;IAEK,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAG1D;IAEK,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAI3E;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3C;IAEK,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAIrC;IAEK,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAK7D;IAEK,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpD;IAED,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,IAAI;CAKb"}

package/dist/testing.js

@@ -0,0 +1,180 @@
+/**
+ * Test doubles for `@superblocksteam/workspace-sync`, published as the
+ * `@superblocksteam/workspace-sync/testing` subpath. Not for production use.
+ */
+import { codeModeDownloadExcludedDirectories, hashDirectoryContents, hashFileContents, } from "@superblocksteam/shared";
+/**
+ * An in-memory, content-addressed DBFS plus one branch's hash pointer. Like
+ * the server, `putMany` refuses a listing whose children are missing and
+ * `validateMany` refuses excluded directory names, so an upload that skips
+ * something it should have sent fails here too.
+ */
+export class FakeDbfs {
+    files = new Map();
+    directories = new Map();
+    serverHash;
+    calls = {
+        validateMany: [],
+        putMany: [],
+        setHash: [],
+        setDraftState: [],
+        getDirectory: 0,
+        getContents: 0,
+        getBlob: 0,
+    };
+    commits = 0;
+    /** Total putMany items since the last {@link resetCalls}. */
+    get putItemCount() {
+        return this.calls.putMany.reduce((total, items) => total + items.length, 0);
+    }
+    resetCalls() {
+        this.calls.validateMany.length = 0;
+        this.calls.putMany.length = 0;
+        this.calls.setHash.length = 0;
+        this.calls.setDraftState.length = 0;
+        this.calls.getDirectory = 0;
+        this.calls.getContents = 0;
+        this.calls.getBlob = 0;
+    }
+    /**
+     * Stores a tree described by slash-separated paths and points the branch at
+     * it, as another writer would. Returns the tree's hash.
+     */
+    async seed(tree) {
+        const hash = await this.storeTree(tree);
+        this.serverHash = hash;
+        return hash;
+    }
+    /** Stores a tree without moving the branch. Returns its hash. */
+    async storeTree(tree) {
+        const top = { files: new Map(), dirs: new Map() };
+        for (const [entryPath, entry] of Object.entries(tree)) {
+            const parts = entryPath.split("/");
+            let node = top;
+            for (const part of parts.slice(0, -1)) {
+                let next = node.dirs.get(part);
+                if (!next)
+                    node.dirs.set(part, (next = { files: new Map(), dirs: new Map() }));
+                node = next;
+            }
+            node.files.set(parts.at(-1), entry);
+        }
+        const store = async (node) => {
+            const contents = [];
+            for (const [name, child] of node.dirs)
+                contents.push({ type: "d", name, hash: await store(child) });
+            for (const [name, entry] of node.files) {
+                if (typeof entry === "object" && "symlink" in entry) {
+                    contents.push({ type: "l", name, target: entry.symlink });
+                    continue;
+                }
+                const { contents: raw, executable = false } = typeof entry === "string" || Buffer.isBuffer(entry)
+                    ? { contents: entry }
+                    : entry;
+                const bytes = Buffer.from(raw);
+                const hash = await hashFileContents(bytes);
+                this.files.set(hash, bytes);
+                contents.push({ type: "-", name, hash, executable });
+            }
+            const hash = await hashDirectoryContents(contents);
+            this.directories.set(hash, contents);
+            return hash;
+        };
+        return store(top);
+    }
+    /** Every file and symlink in tree `hash`, by slash-separated path. */
+    async readTree(hash = this.serverHash) {
+        if (hash === undefined)
+            throw new Error("FakeDbfs has no server hash");
+        const result = new Map();
+        const walk = (directoryHash, prefix) => {
+            for (const entry of this.directory(directoryHash)) {
+                const entryPath = prefix + entry.name;
+                if (entry.type === "d")
+                    walk(entry.hash, `${entryPath}/`);
+                else if (entry.type === "l")
+                    result.set(entryPath, { symlink: entry.target });
+                else
+                    result.set(entryPath, {
+                        contents: this.blob(entry.hash),
+                        executable: entry.executable,
+                    });
+            }
+        };
+        walk(hash, "");
+        return result;
+    }
+    async validateMany(items) {
+        this.calls.validateMany.push(items.length);
+        for (const item of items) {
+            if (item.type !== "directoryContents")
+                continue;
+            const excluded = item.contents.find((entry) => codeModeDownloadExcludedDirectories.includes(entry.name));
+            if (excluded)
+                throw new Error(`Excluded application path "${excluded.name}" cannot be uploaded`);
+        }
+    }
+    async putMany(items) {
+        this.calls.putMany.push(items);
+        const hashes = [];
+        for (const item of items) {
+            if (item.type === "fileContents") {
+                const bytes = Buffer.from(item.contents, "base64");
+                const hash = await hashFileContents(bytes);
+                this.files.set(hash, bytes);
+                hashes.push(hash);
+                continue;
+            }
+            for (const entry of item.contents) {
+                if (entry.type === "-" && !this.files.has(entry.hash))
+                    throw new Error(`putMany listing references missing file ${entry.name}`);
+                if (entry.type === "d" && !this.directories.has(entry.hash))
+                    throw new Error(`putMany listing references missing directory ${entry.name}`);
+            }
+            const hash = await hashDirectoryContents(item.contents);
+            this.directories.set(hash, item.contents);
+            hashes.push(hash);
+        }
+        return hashes;
+    }
+    async getDirectory(hash) {
+        this.calls.getDirectory++;
+        return this.directory(hash);
+    }
+    async getContents(rootHash, files) {
+        this.calls.getContents++;
+        this.directory(rootHash);
+        return files.map((file) => this.blob(file.hash));
+    }
+    async getBlob(hash) {
+        this.calls.getBlob++;
+        return this.blob(hash);
+    }
+    async getServerHash() {
+        if (this.serverHash === undefined)
+            throw new Error("No live edit hash found");
+        return this.serverHash;
+    }
+    async setHash(request) {
+        this.directory(request.hash);
+        this.calls.setHash.push(request);
+        this.serverHash = request.hash;
+        return { hash: request.hash, commitId: `commit-${++this.commits}` };
+    }
+    async setDraftState(hasDraft) {
+        this.calls.setDraftState.push(hasDraft);
+    }
+    directory(hash) {
+        const contents = this.directories.get(hash);
+        if (!contents)
+            throw new Error(`DBFS directory ${hash} not found`);
+        return contents;
+    }
+    blob(hash) {
+        const bytes = this.files.get(hash);
+        if (!bytes)
+            throw new Error(`DBFS file ${hash} not found`);
+        return Buffer.from(bytes);
+    }
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/dist/workspace-state-store.d.ts

@@ -0,0 +1,52 @@
+/** What a workspace remembers across restarts. */
+export interface WorkspaceState {
+    /** The last hash this workspace committed to, or loaded from, DBFS. */
+    dbfsHash: string;
+}
+/** A file in a local tree that differs from the server tree. */
+export type OrphanedEntry = {
+    path: string;
+    type: "-";
+    hash: string;
+    executable: boolean;
+} | {
+    path: string;
+    type: "l";
+    target: string;
+};
+/**
+ * Local changes a rehydrate could not commit because the server moved. File
+ * contents were put to DBFS first, so every hash here resolves.
+ */
+export interface OrphanedDiff {
+    createdAt: string;
+    serverHash: string;
+    storedHash: string | undefined;
+    localHash: string;
+    /** Added or changed entries. */
+    changed: OrphanedEntry[];
+    /** Paths the server tree has and the local tree does not. */
+    deleted: string[];
+}
+export interface WorkspaceStateStore {
+    read(): Promise<WorkspaceState | undefined>;
+    /** Replaces the state atomically. */
+    write(state: WorkspaceState): Promise<void>;
+    /** Keeps an orphaned diff; returns where it was written. */
+    writeOrphan(diff: OrphanedDiff): Promise<string>;
+}
+/**
+ * Keeps `state.json` and `orphaned/` in a session state directory (on the VM,
+ * `/mnt/builder-sessions/workspace`). Writes go through a temporary file,
+ * fsync and rename, so a kill leaves the old or the new state.
+ */
+export declare class FileWorkspaceStateStore implements WorkspaceStateStore {
+    readonly stateDir: string;
+    constructor(stateDir: string);
+    get file(): string;
+    get orphanedDir(): string;
+    read(): Promise<WorkspaceState | undefined>;
+    write(state: WorkspaceState): Promise<void>;
+    writeOrphan(diff: OrphanedDiff): Promise<string>;
+}
+//# sourceMappingURL=workspace-state-store.d.ts.map

package/dist/workspace-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-state-store.d.ts","sourceRoot":"","sources":["../src/workspace-state-store.ts"],"names":[],"mappings":"AAOA,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,gEAAgE;AAChE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC5C,qCAAqC;IACrC,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,4DAA4D;IAC5D,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD;AAID;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAArC,YAAqB,QAAQ,EAAE,MAAM,EAAI;IAEzC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAEK,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAShD;IAEK,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhD;IAEK,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAQrD;CACF"}

package/dist/workspace-state-store.js

@@ -0,0 +1,45 @@
+import * as fs from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { writeFileAtomic } from "./atomic-write.js";
+const stateSchema = z.object({ dbfsHash: z.string().min(1) });
+/**
+ * Keeps `state.json` and `orphaned/` in a session state directory (on the VM,
+ * `/mnt/builder-sessions/workspace`). Writes go through a temporary file,
+ * fsync and rename, so a kill leaves the old or the new state.
+ */
+export class FileWorkspaceStateStore {
+    stateDir;
+    constructor(stateDir) {
+        this.stateDir = stateDir;
+    }
+    get file() {
+        return path.join(this.stateDir, "state.json");
+    }
+    get orphanedDir() {
+        return path.join(this.stateDir, "orphaned");
+    }
+    async read() {
+        let contents;
+        try {
+            contents = await fs.readFile(this.file, "utf8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return undefined;
+            throw error;
+        }
+        return stateSchema.parse(JSON.parse(contents));
+    }
+    async write(state) {
+        await fs.mkdir(this.stateDir, { recursive: true, mode: 0o700 });
+        await writeFileAtomic(this.file, JSON.stringify(stateSchema.parse(state)));
+    }
+    async writeOrphan(diff) {
+        await fs.mkdir(this.orphanedDir, { recursive: true, mode: 0o700 });
+        const file = path.join(this.orphanedDir, `${Date.parse(diff.createdAt)}.json`);
+        await writeFileAtomic(file, JSON.stringify(diff));
+        return file;
+    }
+}
+//# sourceMappingURL=workspace-state-store.js.map

package/dist/workspace-state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-state-store.js","sourceRoot":"","sources":["../src/workspace-state-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAoCpD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IACb,QAAQ;IAA7B,YAAqB,QAAgB;wBAAhB,QAAQ;IAAW,CAAC;IAEzC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YACzE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAqB;QAC/B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAkB;QAClC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CACpB,IAAI,CAAC,WAAW,EAChB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CACrC,CAAC;QACF,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@superblocksteam/workspace-sync",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.0.178-next.1",
+  "description": "DBFS sync primitives for an app workspace: snapshot, upload, download and draft markers",
+  "license": "Superblocks Community Software License",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.1",
+    "@superblocksteam/shared": "0.9620.2",
+    "@superblocksteam/util": "2.0.178-next.1",
+    "diff": "^8.0.4",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@types/node": "^24.19.2",
+    "@vitest/eslint-plugin": "^1.6.28",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-config-turbo": "^2.9.16",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-unicorn": "^62.0.0",
+    "eslint-plugin-unused-imports": "^4.3.0",
+    "globals": "^17.13.0",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "typescript-eslint": "^8.72.0",
+    "vitest": "^4.1.12"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json",
+    "check": "pnpm lint && pnpm typecheck",
+    "clean": "premove dist *.tsbuildinfo",
+    "dev": "tsc --build tsconfig.build.json --watch --preserveWatchOutput",
+    "lint": "eslint --concurrency=auto",
+    "lint:fix": "eslint --fix --concurrency=auto",
+    "publish-package": "pnpm publish",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --build tsconfig.json"
+  }
 }