@vibesdotdev/storage 0.0.2 → 1.0.0-rc.3

package/dist/sync/sync-state.consumer.js

@@ -1,111 +1,185 @@
 /**
  * Storage Sync State Tracking (Consumer)
  *
- * Tracks per-manifest sync state: hashes, timestamps, and conflict status.
- * Stored in ~/.vibes/sync-state.json via direct JSON I/O (intentionally
- * bypasses StorageManifest to avoid circular dependency).
+ * Persists the per-manifest sync state in `{vibesHome}/sync-state.json` through
+ * the handed runtime's filesystem kind (`filesystem/adapter`), intentionally
+ * bypassing StorageManifest to avoid a circular dependency. State transitions
+ * live in the environment-agnostic `sync-state.core` (shared with the browser
+ * path); this module owns only the consumer-scoped persistence and the hash.
  *
- * Consumer-scoped: uses host fs for persistence.
+ * Path roots: the handed runtime's `paths/roots` vibesHome (same contract as
+ * StorageRecord global scope / #894) — never bare `homedir()/.vibes`, and never
+ * an ambient runtime.
+ *
+ * Session state (the entries each loaded state held when it was read, and the
+ * saves in flight per state file) lives on the root-owned
+ * `runtime/client#storage.sync-state` (`SyncStateClient`), resolved through
+ * `getVibesClient` — never a module-level store.
+ *
+ * A save is atomic, owner-only and merged. Saves of one state file run one at a
+ * time per runtime root; each re-reads the file, overlays only the entries its
+ * caller changed since its load (so concurrent pushes and CLI runs keep each
+ * other's entries), writes a same-directory temporary file with mode 0600 and
+ * renames it over the state, so a failed write leaves the prior file intact.
  */
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-import { createHash } from 'node:crypto';
-import { SyncStateSchema } from './schemas/sync-state.js';
-const SYNC_STATE_DIR = join(homedir(), '.vibes');
-const SYNC_STATE_PATH = join(SYNC_STATE_DIR, 'sync-state.json');
-function createDefaultState() {
-    return {
-        version: 1,
-        updatedAt: new Date().toISOString(),
-        manifests: {}
-    };
+import * as z from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema, rootIdentityOf } from '@vibesdotdev/kernel';
+import { resolveFileSystemAdapter } from '@vibesdotdev/filesystem/client/resolve-adapter';
+import { getPathRoots } from '@vibesdotdev/paths';
+import { sha256Hex } from '@vibesdotdev/shared/hashing';
+import { resolveVibesBaseDir } from "../path-policy.js";
+import { resolveSyncStateClient } from "./sync-state.client.js";
+import { SyncStateSchema } from "./schemas/sync-state.js";
+export { createDefaultState, createDefaultManifestState, getManifestSyncState, updateManifestSyncState, markSynced, markLocalAhead, markRemoteAhead, markConflict, markError, clearError, markAllPaused, mergeSyncStateSnapshots, HASH_VERSION, } from "./sync-state.core.js";
+import { createDefaultState, stableJsonStringify } from "./sync-state.core.js";
+/** The state file's name under the runtime's vibesHome. */
+const SYNC_STATE_FILENAME = 'sync-state.json';
+/** The state file is the owner's alone (it names every synced manifest). */
+const SYNC_STATE_MODE = 0o600;
+/** The longest one save may take, queue included, before it is refused `TIMEOUT`. */
+const SYNC_STATE_SAVE_TIMEOUT_MS = 30_000;
+/** The state file's bytes as the filesystem kind answers a `utf-8` read. */
+const SyncStateTextSchema = z.string();
+async function syncStateFile(runtime) {
+    const dir = resolveVibesBaseDir(getPathRoots(runtime));
+    // The state file is a host fact under the runtime's vibesHome, never workspace content.
+    const files = await resolveFileSystemAdapter(runtime, { binding: false });
+    return { files, dir, path: files.join(dir, SYNC_STATE_FILENAME) };
 }
-function createDefaultManifestState(manifestId) {
-    return {
-        manifestId,
-        localHash: null,
-        remoteHash: null,
-        lastLocalChange: null,
-        lastRemoteChange: null,
-        lastSyncAt: null,
-        lastSyncDirection: null,
-        syncStatus: 'never-synced',
-        errorMessage: null
-    };
+function corrupt(statePath, detail, cause) {
+    return new CapabilityError('The persisted sync state is corrupt.', 'INTERNAL', {
+        reason: 'data-corrupt',
+        retryable: false,
+        details: { path: statePath, detail },
+        cause
+    });
 }
-export async function loadSyncState() {
-    if (!existsSync(SYNC_STATE_PATH)) {
-        return createDefaultState();
-    }
+/** The persisted state, or `null` when no state file exists; an unreadable or invalid file is `data-corrupt`. */
+async function readPersisted(file) {
+    if (!(await file.files.exists(file.path)))
+        return null;
+    const text = SyncStateTextSchema.parse(await file.files.readFile(file.path, 'utf-8'));
+    let parsed;
     try {
-        const { readFile } = await import('node:fs/promises');
-        const raw = await readFile(SYNC_STATE_PATH, 'utf-8');
-        const parsed = JSON.parse(raw);
-        return SyncStateSchema.parse(parsed);
+        parsed = JSON.parse(text);
     }
-    catch {
-        return createDefaultState();
+    catch (error) {
+        throw corrupt(file.path, 'json', CaughtFailureSchema.parse(error));
     }
+    const result = SyncStateSchema.safeParse(parsed);
+    if (!result.success)
+        throw corrupt(file.path, 'schema', result.error);
+    return result.data;
 }
-export async function saveSyncState(state) {
-    state.updatedAt = new Date().toISOString();
-    if (!existsSync(SYNC_STATE_DIR)) {
-        const { mkdir } = await import('node:fs/promises');
-        await mkdir(SYNC_STATE_DIR, { recursive: true });
+/** `runtime`'s root as the kernel knows it; a runtime double names no root and is refused. */
+function rootOf(runtime) {
+    const identity = rootIdentityOf(runtime);
+    if (!identity) {
+        throw new CapabilityError('The sync state is saved per runtime root; this runtime names no root.', 'INVALID_INPUT', {
+            reason: 'sync-state-runtime-unidentified',
+            retryable: false
+        });
     }
-    const { writeFile } = await import('node:fs/promises');
-    await writeFile(SYNC_STATE_PATH, JSON.stringify(state, null, 2));
-}
-export function getManifestSyncState(state, manifestId) {
-    return state.manifests[manifestId] ?? createDefaultManifestState(manifestId);
+    return identity;
 }
-export function updateManifestSyncState(state, manifestId, update) {
-    const current = getManifestSyncState(state, manifestId);
-    state.manifests[manifestId] = { ...current, ...update, manifestId };
+/** This root's sync-state client: the kernel-owned home of its loaded snapshots and save turns. */
+async function clientOf(runtime) {
+    // A runtime double names no root and is refused before any resolution runs.
+    rootOf(runtime);
+    return resolveSyncStateClient(runtime);
 }
-export function markSynced(state, manifestId, hash, direction) {
-    const now = new Date().toISOString();
-    updateManifestSyncState(state, manifestId, {
-        localHash: hash,
-        remoteHash: hash,
-        lastSyncAt: now,
-        lastSyncDirection: direction,
-        syncStatus: 'in-sync',
-        errorMessage: null,
-        ...(direction === 'push' ? { lastLocalChange: now } : { lastRemoteChange: now })
-    });
-}
-export function markLocalAhead(state, manifestId, localHash) {
-    updateManifestSyncState(state, manifestId, {
-        localHash,
-        lastLocalChange: new Date().toISOString(),
-        syncStatus: 'local-ahead'
-    });
+/**
+ * The persisted sync state. An absent file is a fresh state; a file that cannot
+ * be read or parsed is a typed failure, never silently reset.
+ */
+export async function loadSyncState(runtime) {
+    const client = await clientOf(runtime);
+    const state = (await readPersisted(await syncStateFile(runtime))) ?? createDefaultState();
+    client.loadedEntries.set(state, structuredClone(state.manifests));
+    return state;
 }
-export function markRemoteAhead(state, manifestId, remoteHash) {
-    updateManifestSyncState(state, manifestId, {
-        remoteHash,
-        lastRemoteChange: new Date().toISOString(),
-        syncStatus: 'remote-ahead'
+/** Run `save` after every earlier save of `path` on `client`'s root has settled. */
+async function inTurn(client, path, save) {
+    const previous = client.saveTurns.get(path);
+    let release = () => undefined;
+    // A turn only ever resolves: each save's failure belongs to its own caller.
+    const turn = new Promise((resolve) => {
+        release = resolve;
     });
+    client.saveTurns.set(path, turn);
+    try {
+        if (previous)
+            await previous;
+        await save();
+    }
+    finally {
+        release();
+        if (client.saveTurns.get(path) === turn)
+            client.saveTurns.delete(path);
+    }
 }
-export function markConflict(state, manifestId, localHash, remoteHash) {
-    updateManifestSyncState(state, manifestId, {
-        localHash,
-        remoteHash,
-        syncStatus: 'conflict'
-    });
+/** The entries of `state` its caller changed since it was loaded (every entry of a state that was never loaded). */
+function changedEntries(client, state) {
+    const loaded = client.loadedEntries.get(state);
+    if (!loaded)
+        return state.manifests;
+    const changed = {};
+    for (const [key, entry] of Object.entries(state.manifests)) {
+        const before = loaded[key];
+        if (!before || stableJsonStringify(before) !== stableJsonStringify(entry))
+            changed[key] = entry;
+    }
+    return changed;
 }
-export function markError(state, manifestId, errorMessage) {
-    updateManifestSyncState(state, manifestId, { errorMessage });
+/** Remove the temporary file a failed write may have left. */
+async function removeIfPresent(files, path) {
+    if (await files.exists(path))
+        await files.remove(path);
 }
-export function markAllPaused(state) {
-    for (const manifestId of Object.keys(state.manifests)) {
-        updateManifestSyncState(state, manifestId, { syncStatus: 'paused' });
+/** Write `text` beside `path` with the owner-only mode, then rename it over `path`. */
+async function replaceAtomically(file, text) {
+    const temporary = `${file.path}.${crypto.randomUUID()}.tmp`;
+    try {
+        await file.files.writeFile(temporary, text, { encoding: 'utf-8', mode: SYNC_STATE_MODE });
+        await file.files.rename(temporary, file.path);
     }
+    catch (error) {
+        try {
+            await removeIfPresent(file.files, temporary);
+        }
+        catch (cleanup) {
+            throw new AggregateError([error, cleanup], 'Saving the sync state and removing its temporary file both failed', { cause: error });
+        }
+        throw error;
+    }
+}
+/**
+ * Persist the sync state, merged over what the file holds now: the entries this
+ * caller changed since its load win, every other persisted entry is kept. The
+ * runtime comes second so the browser sibling's `saveSyncState(state)`
+ * satisfies the same module shape.
+ */
+export async function saveSyncState(state, runtime) {
+    state.updatedAt = new Date().toISOString();
+    const file = await syncStateFile(runtime);
+    const client = await clientOf(runtime);
+    const changed = changedEntries(client, state);
+    await runtime.lifecycle.wait(() => inTurn(client, file.path, async () => {
+        await file.files.mkdir(file.dir, { recursive: true });
+        const persisted = (await readPersisted(file)) ?? createDefaultState();
+        const merged = {
+            ...state,
+            manifests: { ...persisted.manifests, ...changed }
+        };
+        await replaceAtomically(file, JSON.stringify(merged, null, 2));
+        state.manifests = { ...merged.manifests };
+        client.loadedEntries.set(state, structuredClone(merged.manifests));
+    }), { timeoutMs: SYNC_STATE_SAVE_TIMEOUT_MS, reason: 'storage-sync-state-save' });
 }
+/** The SHA-256 (hex) of the value's stable JSON form: the change-detection digest sync state persists. */
 export function computeHash(data) {
-    return createHash('sha256').update(JSON.stringify(data)).digest('hex');
+    return sha256Hex(stableJsonStringify(data));
 }
+/** Save-hook policy of this scoped substrate. */
+export const afterSaveOptions = { skipWorkerHosts: true, skipWhenInSync: false };
 //# sourceMappingURL=sync-state.consumer.js.map

package/dist/sync/sync-state.consumer.js.map

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

package/dist/sync/sync-state.core.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Storage Sync State — pure core.
+ *
+ * Environment-agnostic state transitions over the per-manifest sync state
+ * (hashes, timestamps, conflict status). No host/fs/crypto imports, so both
+ * the consumer (filesystem-kind backed, SHA-256 hash) and browser
+ * (localStorage-backed, JS hash) sync-state modules share the same transition
+ * logic — they differ only in persistence (`load`/`save`) and `computeHash`.
+ */
+import { type SyncState, type ManifestSyncState } from './schemas/sync-state.ts';
+export type { SyncState, SyncStatus, ManifestSyncState } from './schemas/sync-state.ts';
+/** Version of the serialization used to produce persisted sync hashes. */
+export declare const HASH_VERSION = 2;
+/**
+ * Serialize a value's JSON form (what `JSON.stringify` writes: `toJSON` applied,
+ * `undefined` fields dropped) with recursively sorted object keys, for sync
+ * hashing. A value with no JSON form serializes as `''`.
+ */
+export declare function stableJsonStringify<TValue>(value: TValue): string;
+export declare function createDefaultState(): SyncState;
+export declare function createDefaultManifestState(manifestId: string): ManifestSyncState;
+export declare function getManifestSyncState(state: SyncState, manifestId: string): ManifestSyncState;
+export declare function updateManifestSyncState(state: SyncState, manifestId: string, update: Partial<ManifestSyncState>): void;
+/**
+ * Merge a pre-operation snapshot with state persisted by nested sync bridges.
+ * Persisted state is the base (preserving keys added by concurrent writers);
+ * the in-memory snapshot overlays every key NOT owned by a bridge that ran in
+ * this invocation, so fresh manifest-level transitions survive while
+ * bridge-owned keys keep their newer on-disk values.
+ */
+export declare function mergeSyncStateSnapshots(snapshot: SyncState, persisted: SyncState, bridgeIds: Iterable<string>): SyncState;
+export declare function markSynced(state: SyncState, manifestId: string, hash: string, direction: 'push' | 'pull'): void;
+export declare function markLocalAhead(state: SyncState, manifestId: string, localHash: string): void;
+export declare function markRemoteAhead(state: SyncState, manifestId: string, remoteHash: string): void;
+export declare function markConflict(state: SyncState, manifestId: string, localHash: string, remoteHash: string): void;
+export declare function markError(state: SyncState, manifestId: string, errorMessage: string): void;
+/** Clear a prior error after a successful probe/skip/sync decision. */
+export declare function clearError(state: SyncState, manifestId: string): void;
+export declare function markAllPaused(state: SyncState): void;
+//# sourceMappingURL=sync-state.core.d.ts.map

package/dist/sync/sync-state.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-state.core.d.ts","sourceRoot":"","sources":["../../src/sync/sync-state.core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjF,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAExF,0EAA0E;AAC1E,eAAO,MAAM,YAAY,IAAI,CAAC;AAa9B;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED,wBAAgB,kBAAkB,IAAI,SAAS,CAM9C;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAYhF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAE5F;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAChC,IAAI,CAGN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,SAAS,EACnB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GACzB,SAAS,CASX;AAED,wBAAgB,UAAU,CACzB,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,MAAM,GACxB,IAAI,CAYN;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAO5F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAO9F;AAED,wBAAgB,YAAY,CAC3B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAChB,IAAI,CAON;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAE1F;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAIpD"}

package/dist/sync/sync-state.core.js

@@ -0,0 +1,130 @@
+/**
+ * Storage Sync State — pure core.
+ *
+ * Environment-agnostic state transitions over the per-manifest sync state
+ * (hashes, timestamps, conflict status). No host/fs/crypto imports, so both
+ * the consumer (filesystem-kind backed, SHA-256 hash) and browser
+ * (localStorage-backed, JS hash) sync-state modules share the same transition
+ * logic — they differ only in persistence (`load`/`save`) and `computeHash`.
+ */
+import { isJsonObject } from '@vibesdotdev/kernel/schemas/json';
+import {} from "./schemas/sync-state.js";
+/** Version of the serialization used to produce persisted sync hashes. */
+export const HASH_VERSION = 2;
+/** A JSON value with every object's keys in sorted order (own keys only, `__proto__` kept as data). */
+function sortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    if (!isJsonObject(value))
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+        .map(([key, field]) => [key, sortKeys(field)]));
+}
+/**
+ * Serialize a value's JSON form (what `JSON.stringify` writes: `toJSON` applied,
+ * `undefined` fields dropped) with recursively sorted object keys, for sync
+ * hashing. A value with no JSON form serializes as `''`.
+ */
+export function stableJsonStringify(value) {
+    const json = JSON.stringify(value);
+    if (json === undefined)
+        return '';
+    // JSON.parse of JSON.stringify's own output is a JSON value by construction.
+    const parsed = JSON.parse(json);
+    return JSON.stringify(sortKeys(parsed));
+}
+export function createDefaultState() {
+    return {
+        version: 1,
+        updatedAt: new Date().toISOString(),
+        manifests: {}
+    };
+}
+export function createDefaultManifestState(manifestId) {
+    return {
+        manifestId,
+        localHash: null,
+        remoteHash: null,
+        lastLocalChange: null,
+        lastRemoteChange: null,
+        lastSyncAt: null,
+        lastSyncDirection: null,
+        syncStatus: 'never-synced',
+        errorMessage: null
+    };
+}
+export function getManifestSyncState(state, manifestId) {
+    return state.manifests[manifestId] ?? createDefaultManifestState(manifestId);
+}
+export function updateManifestSyncState(state, manifestId, update) {
+    const current = getManifestSyncState(state, manifestId);
+    state.manifests[manifestId] = { ...current, ...update, manifestId };
+}
+/**
+ * Merge a pre-operation snapshot with state persisted by nested sync bridges.
+ * Persisted state is the base (preserving keys added by concurrent writers);
+ * the in-memory snapshot overlays every key NOT owned by a bridge that ran in
+ * this invocation, so fresh manifest-level transitions survive while
+ * bridge-owned keys keep their newer on-disk values.
+ */
+export function mergeSyncStateSnapshots(snapshot, persisted, bridgeIds) {
+    const bridgePrefixes = [...bridgeIds].map((id) => `${id}:`);
+    const manifests = { ...persisted.manifests };
+    for (const [key, state] of Object.entries(snapshot.manifests)) {
+        if (!bridgePrefixes.some((prefix) => key.startsWith(prefix))) {
+            manifests[key] = state;
+        }
+    }
+    return { ...snapshot, updatedAt: persisted.updatedAt, manifests };
+}
+export function markSynced(state, manifestId, hash, direction) {
+    const now = new Date().toISOString();
+    updateManifestSyncState(state, manifestId, {
+        localHash: hash,
+        remoteHash: hash,
+        hashVersion: HASH_VERSION,
+        lastSyncAt: now,
+        lastSyncDirection: direction,
+        syncStatus: 'in-sync',
+        errorMessage: null,
+        ...(direction === 'push' ? { lastLocalChange: now } : { lastRemoteChange: now })
+    });
+}
+export function markLocalAhead(state, manifestId, localHash) {
+    updateManifestSyncState(state, manifestId, {
+        localHash,
+        hashVersion: HASH_VERSION,
+        lastLocalChange: new Date().toISOString(),
+        syncStatus: 'local-ahead'
+    });
+}
+export function markRemoteAhead(state, manifestId, remoteHash) {
+    updateManifestSyncState(state, manifestId, {
+        remoteHash,
+        hashVersion: HASH_VERSION,
+        lastRemoteChange: new Date().toISOString(),
+        syncStatus: 'remote-ahead'
+    });
+}
+export function markConflict(state, manifestId, localHash, remoteHash) {
+    updateManifestSyncState(state, manifestId, {
+        localHash,
+        remoteHash,
+        hashVersion: HASH_VERSION,
+        syncStatus: 'conflict'
+    });
+}
+export function markError(state, manifestId, errorMessage) {
+    updateManifestSyncState(state, manifestId, { errorMessage });
+}
+/** Clear a prior error after a successful probe/skip/sync decision. */
+export function clearError(state, manifestId) {
+    updateManifestSyncState(state, manifestId, { errorMessage: null });
+}
+export function markAllPaused(state) {
+    for (const manifestId of Object.keys(state.manifests)) {
+        updateManifestSyncState(state, manifestId, { syncStatus: 'paused' });
+    }
+}
+//# sourceMappingURL=sync-state.core.js.map

package/dist/sync/sync-state.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-state.core.js","sourceRoot":"","sources":["../../src/sync/sync-state.core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAkB,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAA0C,MAAM,yBAAyB,CAAC;AAKjF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,uGAAuG;AACvG,SAAS,QAAQ,CAAC,KAAgB;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,MAAM,CAAC,WAAW,CACrB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SAChB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACrE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CACrD,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAS,KAAa;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,6EAA6E;IAC7E,MAAM,MAAM,GAAc,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB;IACjC,OAAO;QACN,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,EAAE;KACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,UAAkB;IAC5D,OAAO;QACN,UAAU;QACV,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,UAAU,EAAE,IAAI;QAChB,iBAAiB,EAAE,IAAI;QACvB,UAAU,EAAE,cAAc;QAC1B,YAAY,EAAE,IAAI;KAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAgB,EAAE,UAAkB;IACxE,OAAO,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,0BAA0B,CAAC,UAAU,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,KAAgB,EAChB,UAAkB,EAClB,MAAkC;IAElC,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACxD,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACtC,QAAmB,EACnB,SAAoB,EACpB,SAA2B;IAE3B,MAAM,cAAc,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,EAAE,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9D,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;IACF,CAAC;IACD,OAAO,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,UAAU,CACzB,KAAgB,EAChB,UAAkB,EAClB,IAAY,EACZ,SAA0B;IAE1B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE;QAC1C,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,YAAY;QACzB,UAAU,EAAE,GAAG;QACf,iBAAiB,EAAE,SAAS;QAC5B,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,IAAI;QAClB,GAAG,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC;KAChF,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAE,UAAkB,EAAE,SAAiB;IACrF,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE;QAC1C,SAAS;QACT,WAAW,EAAE,YAAY;QACzB,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACzC,UAAU,EAAE,aAAa;KACzB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,UAAkB,EAAE,UAAkB;IACvF,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE;QAC1C,UAAU;QACV,WAAW,EAAE,YAAY;QACzB,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC1C,UAAU,EAAE,cAAc;KAC1B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC3B,KAAgB,EAChB,UAAkB,EAClB,SAAiB,EACjB,UAAkB;IAElB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE;QAC1C,SAAS;QACT,UAAU;QACV,WAAW,EAAE,YAAY;QACzB,UAAU,EAAE,UAAU;KACtB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,UAAkB,EAAE,YAAoB;IACnF,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,UAAkB;IAC9D,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC7C,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACvD,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtE,CAAC;AACF,CAAC"}

package/dist/sync/sync-state.descriptor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Storage sync-state kind and descriptor.
+ *
+ * `storage/sync-state` resolves the per-manifest sync-state substrate for the
+ * resolving runtime: the browser substrate on browser surfaces, the consumer
+ * substrate everywhere else. Selection is scope matching on the loaders, never
+ * a surface switch in a caller.
+ */
+import { type RuntimeDescriptor } from '@vibesdotdev/kernel';
+export declare const STORAGE_SYNC_STATE_KIND = "storage/sync-state";
+export declare const STORAGE_SYNC_STATE_ID = "storage.sync-state";
+export declare const storageSyncStateKind: {
+    id: string;
+    descriptorSchema: import("zod/v4").ZodObject<{
+        id: import("zod/v4").ZodString;
+        kind: import("zod/v4").ZodString;
+        name: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+        description: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+        tags: import("zod/v4").ZodOptional<import("zod/v4").ZodArray<import("zod/v4").ZodString>>;
+        hardware: import("zod/v4").ZodOptional<import("zod/v4").ZodArray<import("zod/v4").ZodString>>;
+        enabled: import("zod/v4").ZodOptional<import("zod/v4").ZodBoolean>;
+        priority: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+        capabilityId: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+        requiredContext: import("zod/v4").ZodOptional<import("zod/v4").ZodArray<import("zod/v4").ZodString>>;
+        optionalContext: import("zod/v4").ZodOptional<import("zod/v4").ZodArray<import("zod/v4").ZodString>>;
+        config: import("zod/v4").ZodOptional<import("zod/v4").ZodUnknown>;
+        retention: import("zod/v4").ZodOptional<import("zod/v4").ZodUnion<readonly [import("zod/v4").ZodString, import("zod/v4").ZodObject<{
+            maxAgeDays: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+            maxEntries: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+            maxBytes: import("zod/v4").ZodOptional<import("zod/v4").ZodNumber>;
+            cascadeFrom: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+            ageField: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+            reason: import("zod/v4").ZodString;
+            enforcedBy: import("zod/v4").ZodOptional<import("zod/v4").ZodString>;
+        }, import("zod/v4/core").$strip>]>>;
+    }, import("zod/v4/core").$strip>;
+};
+export declare const storageSyncStateDescriptor: RuntimeDescriptor;
+//# sourceMappingURL=sync-state.descriptor.d.ts.map

package/dist/sync/sync-state.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-state.descriptor.d.ts","sourceRoot":"","sources":["../../src/sync/sync-state.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEtF,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAC5D,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;CAGhC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,iBAMxC,CAAC"}

package/dist/sync/sync-state.descriptor.js

@@ -0,0 +1,23 @@
+/**
+ * Storage sync-state kind and descriptor.
+ *
+ * `storage/sync-state` resolves the per-manifest sync-state substrate for the
+ * resolving runtime: the browser substrate on browser surfaces, the consumer
+ * substrate everywhere else. Selection is scope matching on the loaders, never
+ * a surface switch in a caller.
+ */
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel';
+export const STORAGE_SYNC_STATE_KIND = 'storage/sync-state';
+export const STORAGE_SYNC_STATE_ID = 'storage.sync-state';
+export const storageSyncStateKind = {
+    id: STORAGE_SYNC_STATE_KIND,
+    descriptorSchema: RuntimeDescriptorSchema
+};
+export const storageSyncStateDescriptor = {
+    id: STORAGE_SYNC_STATE_ID,
+    kind: STORAGE_SYNC_STATE_KIND,
+    name: 'Storage sync state',
+    description: 'Per-manifest sync state persistence for the active surface',
+    enabled: true
+};
+//# sourceMappingURL=sync-state.descriptor.js.map

package/dist/sync/sync-state.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-state.descriptor.js","sourceRoot":"","sources":["../../src/sync/sync-state.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,uBAAuB,EAA0B,MAAM,qBAAqB,CAAC;AAEtF,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IACnC,EAAE,EAAE,uBAAuB;IAC3B,gBAAgB,EAAE,uBAAuB;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IAC5D,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,4DAA4D;IACzE,OAAO,EAAE,IAAI;CACb,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Test-safe storage manifest implementation.
+ *
+ * Storage owns the manifest contract, so storage-specific test doubles live here
+ * rather than in the generic @vibesdotdev/testing substrate.
+ */
+import { StorageManifest } from './manifest/base.ts';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { StorageManifestDescriptor } from './schemas/manifest-descriptor.ts';
+import type { Unsubscribe } from './interfaces/document-store.ts';
+export declare class MockStorageManifest<T = unknown> extends StorageManifest<T> {
+    private _data;
+    private _updateQueue;
+    private readonly _subscribers;
+    /** The test host's runtime: a subscriber failure is reported to its Logging. */
+    private readonly handedRuntime;
+    constructor(descriptorOrId: StorageManifestDescriptor | string, context: KindContext);
+    load(): Promise<T | null>;
+    save(data: T): Promise<void>;
+    exists(): Promise<boolean>;
+    delete(): Promise<void>;
+    loadOrDefault(defaultValue: T): Promise<T>;
+    update(transform: (current: T | null) => T | Promise<T>): Promise<void>;
+    getCachedData(): T | undefined;
+    isCached(): boolean;
+    invalidateCache(): void;
+    subscribe(callback: (data: T | null) => void): Unsubscribe;
+    protected notifySubscribers(data: T | null): void;
+    reset(): void;
+}
+//# 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;;;;;GAKG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAYlE,qBAAa,mBAAmB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;gBAE3C,cAAc,EAAE,yBAAyB,GAAG,MAAM,EAAE,OAAO,EAAE,WAAW;IAKrE,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIzB,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,aAAa,CAAC,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1C,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7E,aAAa,IAAI,CAAC,GAAG,SAAS;IAI9B,QAAQ,IAAI,OAAO;IAInB,eAAe,IAAI,IAAI;IAIvB,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,GAAG,WAAW;cAOhD,iBAAiB,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAI1D,KAAK,IAAI,IAAI;CAKb"}