@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

package/dist/record/storage.record-delivery.reconcile.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.record-delivery.reconcile.descriptor.js","sourceRoot":"","sources":["../../src/record/storage.record-delivery.reconcile.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,CAAC,MAAM,gCAAgC,GAAG,mCAAmC,CAAC;AAEpF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kCAAkC,GAAG,WAAW,CAAC;AAC9D,MAAM,CAAC,MAAM,mCAAmC,GAAG,MAAM,CAAC;AAE1D,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACR,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACxC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtC,oEAAoE;QACpE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,CAAC,CACF;CACD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oCAAoC,GAAG,kBAAkB,CAAC;IACtE,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,gCAAgC;IACpC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,uEAAuE;IACpF,sDAAsD;IACtD,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE,YAAqB;IAC/B,IAAI,EAAE,WAAoB;IAC1B,QAAQ,EAAE,kCAAkC;IAC5C,oDAAoD;IACpD,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,OAAgB,EAAE,KAAK,EAAE,CAAC,EAAE;IAChE,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,CAAC,UAAU,CAAU;IAC/B,OAAO,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,MAAM,EAAE,mCAAmC;KAC3C;IACD,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC;IAC1C,OAAO,EAAE,IAAI;CACb,CAAC,CAAC;AAEH,eAAe,oCAAoC,CAAC"}

package/dist/record/storage.record-delivery.reconcile.impl.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Record Delivery Reconcile Job Implementation (D-RC11)
+ *
+ * Thin: `requeuePendingDeliveries` holds the reconciliation. Runs on the
+ * runtime the Workers consumer constructed it with.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { JobDescriptor, JobExecutionContext, JobImplementation } from '@vibesdotdev/kernel/kinds';
+import type { RecordDeliveryReconcileOutput } from './storage.record-delivery.reconcile.descriptor.ts';
+export declare class RecordDeliveryReconcileJob implements JobImplementation<Record<string, never>, RecordDeliveryReconcileOutput> {
+    readonly id: string;
+    readonly descriptor: JobDescriptor;
+    readonly type: "scheduled";
+    readonly isolation: "inline";
+    private readonly runtime;
+    constructor(descriptor: JobDescriptor, context: {
+        runtime: VibesRuntime;
+    });
+    handle(_context: JobExecutionContext<Record<string, never>>): Promise<RecordDeliveryReconcileOutput>;
+}
+export default RecordDeliveryReconcileJob;
+//# sourceMappingURL=storage.record-delivery.reconcile.impl.d.ts.map

package/dist/record/storage.record-delivery.reconcile.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.record-delivery.reconcile.impl.d.ts","sourceRoot":"","sources":["../../src/record/storage.record-delivery.reconcile.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEvG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAYvG,qBAAa,0BAA2B,YAAW,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,6BAA6B,CAAC;IACzH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IACrC,QAAQ,CAAC,SAAS,EAAG,QAAQ,CAAU;IAEvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE;IAMnE,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAoB1G;AAED,eAAe,0BAA0B,CAAC"}

package/dist/record/storage.record-delivery.reconcile.impl.js

@@ -0,0 +1,52 @@
+/**
+ * Record Delivery Reconcile Job Implementation (D-RC11)
+ *
+ * Thin: `requeuePendingDeliveries` holds the reconciliation. Runs on the
+ * runtime the Workers consumer constructed it with.
+ */
+import { requeuePendingDeliveries } from "./delivery.js";
+/** A pass failure as the job output's one line: its value-free facts (class, code, reason), never thrown text. */
+function describeReconcileFailure(failure) {
+    const facts = [failure.name];
+    if (failure.code)
+        facts.push(failure.code);
+    if (failure.reason)
+        facts.push(failure.reason);
+    return facts.join(' ');
+}
+export class RecordDeliveryReconcileJob {
+    id;
+    descriptor;
+    type = 'scheduled';
+    isolation = 'inline';
+    runtime;
+    constructor(descriptor, context) {
+        this.id = descriptor.id;
+        this.descriptor = descriptor;
+        this.runtime = context.runtime;
+    }
+    async handle(_context) {
+        const reports = await requeuePendingDeliveries(this.runtime);
+        return {
+            records: reports.map((report) => {
+                const reconciled = {
+                    recordKind: report.recordKind,
+                    job: report.job,
+                    pending: report.pending,
+                    enqueued: report.enqueued,
+                    alreadyActive: report.alreadyActive,
+                    restarted: report.restarted,
+                    terminal: report.terminal.length,
+                    failed: report.failures.length
+                };
+                if (report.skipped)
+                    reconciled.skipped = { reason: report.skipped.reason, condition: report.skipped.condition };
+                if (report.error)
+                    reconciled.error = describeReconcileFailure(report.error);
+                return reconciled;
+            })
+        };
+    }
+}
+export default RecordDeliveryReconcileJob;
+//# sourceMappingURL=storage.record-delivery.reconcile.impl.js.map

package/dist/record/storage.record-delivery.reconcile.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.record-delivery.reconcile.impl.js","sourceRoot":"","sources":["../../src/record/storage.record-delivery.reconcile.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAKzD,kHAAkH;AAClH,SAAS,wBAAwB,CAAC,OAAyB;IAC1D,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,OAAO,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,OAAO,0BAA0B;IAC7B,EAAE,CAAS;IACX,UAAU,CAAgB;IAC1B,IAAI,GAAG,WAAoB,CAAC;IAC5B,SAAS,GAAG,QAAiB,CAAC;IAEtB,OAAO,CAAe;IAEvC,YAAY,UAAyB,EAAE,OAAkC;QACxE,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAoD;QAChE,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7D,OAAO;YACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC/B,MAAM,UAAU,GAAmB;oBAClC,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;oBAChC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;iBAC9B,CAAC;gBACF,IAAI,MAAM,CAAC,OAAO;oBAAE,UAAU,CAAC,OAAO,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAChH,IAAI,MAAM,CAAC,KAAK;oBAAE,UAAU,CAAC,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5E,OAAO,UAAU,CAAC;YACnB,CAAC,CAAC;SACF,CAAC;IACH,CAAC;CACD;AAED,eAAe,0BAA0B,CAAC"}

package/dist/resolver/storage-backed-resolver.d.ts

@@ -1,18 +1,25 @@
-import type { RuntimeDescriptor } from '@vibesdotdev/runtime/schemas/descriptor';
-import type { RuntimeResolverDescriptor, RuntimeResolverFetchAllOptions, RuntimeResolverFetchOptions, RuntimeResolverInterface } from '@vibesdotdev/runtime/schemas/resolver';
-import type { KindContext } from '@vibesdotdev/runtime/schemas/kind';
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import type { RuntimeResolverDescriptor, RuntimeResolverFetchAllOptions, RuntimeResolverFetchOptions, RuntimeResolverInterface } from '@vibesdotdev/kernel/schemas/resolver';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
 export declare class StorageBackedResolver implements RuntimeResolverInterface {
     private context;
     private readonly manifestId;
     private readonly manifestKind;
     private readonly targetKind;
-    constructor(descriptor: RuntimeResolverDescriptor, context: KindContext);
+    /**
+     * The kernel instantiates `runtime/resolver` implementations with its
+     * genuine resolving runtime on `context.runtime` (`KindContext<VibesRuntime>`),
+     * whose asset and query API this resolver reads.
+     */
+    constructor(descriptor: RuntimeResolverDescriptor, context: KindContext<VibesRuntime>);
     fetch(id: string, options?: RuntimeResolverFetchOptions): Promise<RuntimeDescriptor | null>;
     fetchAll(options?: RuntimeResolverFetchAllOptions): Promise<RuntimeDescriptor[]>;
     private applyLimit;
     private loadItems;
+    private isAdapterOffered;
     private getManifestDescriptor;
-    private getOrderedAdapters;
+    private getAdapterLoadGroups;
     private loadFromAdapter;
     private patchDescriptorForAdapter;
     private mergeSourcedItems;

package/dist/resolver/storage-backed-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-backed-resolver.d.ts","sourceRoot":"","sources":["../../src/resolver/storage-backed-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,KAAK,EACX,yBAAyB,EACzB,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,EACxB,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAgBrE,qBAAa,qBAAsB,YAAW,wBAAwB;IAOpE,OAAO,CAAC,OAAO;IANhB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGnC,UAAU,EAAE,yBAAyB,EAC7B,OAAO,EAAE,WAAW;IAOvB,KAAK,CACV,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IA4B9B,QAAQ,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAwBtF,OAAO,CAAC,UAAU;YAQJ,SAAS;IAqBvB,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,kBAAkB;YAMZ,eAAe;IAa7B,OAAO,CAAC,yBAAyB;IAwCjC,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,eAAe;CAsBvB"}
+{"version":3,"file":"storage-backed-resolver.d.ts","sourceRoot":"","sources":["../../src/resolver/storage-backed-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EACX,yBAAyB,EACzB,8BAA8B,EAC9B,2BAA2B,EAC3B,wBAAwB,EACxB,MAAM,sCAAsC,CAAC;AAI9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAA0D,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAsChH,qBAAa,qBAAsB,YAAW,wBAAwB;IAYpE,OAAO,CAAC,OAAO;IAXhB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC;;;;OAIG;gBAEF,UAAU,EAAE,yBAAyB,EAC7B,OAAO,EAAE,WAAW,CAAC,YAAY,CAAC;IAOrC,KAAK,CACV,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IA4B9B,QAAQ,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAwBtF,OAAO,CAAC,UAAU;YAQJ,SAAS;IAmCvB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,oBAAoB;YAiBd,eAAe;IAkD7B,OAAO,CAAC,yBAAyB;IAqCjC,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,eAAe;CAiBvB"}

package/dist/resolver/storage-backed-resolver.js

@@ -1,10 +1,28 @@
-import { StorageManifest } from '../manifest/base.js';
-import { resolveAdapterOrderBySource, resolveScopeForSource, resolveSourceFromAdapter } from '../manifest/source-policy.js';
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { StorageManifest } from "../manifest/base.js";
+import { adapterSourcePolicy, resolveAdapterOrderForDefaultSource, resolveScopeForSource, resolveSourceFromAdapter } from "../manifest/source-policy.js";
+import { getLogger } from '@vibesdotdev/logging';
+import * as z from 'zod/v4';
+import { StorageKindBridgeConfigSchema } from "../bridge/storage-kind-bridge.js";
+import { failureOf, outcomeOf } from "../utils/failure-of.js";
+/** A manifest's stored document as one source loaded it (the bridge config's mapping parses its items). */
+const StoredDocumentSchema = z.unknown();
+/** A stored item that carries its own id (merged across sources by it). */
+const IdentifiedItemSchema = z.object({ id: z.string() }).loose();
+/** The composed `cache/store` read-through this resolver uses, when it offers one. */
+const ReadThroughCacheSchema = z.object({
+    getOrSet: z.custom((value) => value instanceof Function)
+});
 export class StorageBackedResolver {
     context;
     manifestId;
     manifestKind;
     targetKind;
+    /**
+     * The kernel instantiates `runtime/resolver` implementations with its
+     * genuine resolving runtime on `context.runtime` (`KindContext<VibesRuntime>`),
+     * whose asset and query API this resolver reads.
+     */
     constructor(descriptor, context) {
         this.context = context;
         this.manifestId = descriptor.manifestId;
@@ -71,74 +89,133 @@ export class StorageBackedResolver {
         const manifestDescriptor = this.getManifestDescriptor();
         if (!manifestDescriptor)
             return null;
-        const adapterIds = this.getOrderedAdapters(manifestDescriptor);
-        if (adapterIds.length === 0)
+        const adapterGroups = this.getAdapterLoadGroups(manifestDescriptor);
+        if (adapterGroups.length === 0)
             return null;
-        const sourceData = await Promise.all(adapterIds.map(async (adapterId) => ({
-            source: resolveSourceFromAdapter(adapterId),
-            data: await this.loadFromAdapter(manifestDescriptor, adapterId)
-        })));
-        const items = this.mergeSourcedItems(sourceData);
-        if (items.length === 0)
-            return null;
-        return items;
+        const hasOfferedPrimary = adapterGroups[0]?.some((adapterId) => this.isAdapterOffered(adapterId)) ?? false;
+        for (const [groupIndex, adapterIds] of adapterGroups.entries()) {
+            const bestEffortFallback = groupIndex > 0 && hasOfferedPrimary;
+            const sourceData = await Promise.all(adapterIds.map(async (adapterId) => {
+                const source = resolveSourceFromAdapter(this.context.runtime, adapterId);
+                if (!bestEffortFallback) {
+                    return { source, data: await this.loadFromAdapter(manifestDescriptor, adapterId) };
+                }
+                const outcome = await outcomeOf(() => this.loadFromAdapter(manifestDescriptor, adapterId));
+                if (outcome.ok)
+                    return { source, data: outcome.value };
+                getLogger('storage:resolver', this.context.runtime).warn('Storage resolver remote fallback unavailable; using empty local result', { manifestId: manifestDescriptor.id, adapterId, failure: outcome.failure });
+                return { source, data: null };
+            }));
+            const items = this.mergeSourcedItems(sourceData);
+            if (items.length > 0)
+                return items;
+        }
+        return null;
+    }
+    isAdapterOffered(adapterId) {
+        return this.context.runtime.hasKind('storage/adapter')
+            ? this.context.runtime.query('storage/adapter').withId(adapterId).enabled().descriptors({ requireImpl: true }).length > 0
+            : false;
     }
     getManifestDescriptor() {
         const runtime = this.context.runtime;
         if (!runtime.hasKind(this.manifestKind))
             return null;
-        const descriptor = runtime.assets(this.manifestKind).descriptor(this.manifestId);
-        if (!descriptor || typeof descriptor !== 'object')
-            return null;
-        return descriptor;
+        return runtime.query(this.manifestKind).withId(this.manifestId).descriptors()[0] ?? null;
     }
-    getOrderedAdapters(descriptor) {
-        return resolveAdapterOrderBySource(Array.isArray(descriptor.allowedAdapters) ? descriptor.allowedAdapters : []);
+    getAdapterLoadGroups(descriptor) {
+        const allowed = Array.isArray(descriptor.allowedAdapters) ? descriptor.allowedAdapters : [];
+        const primary = resolveAdapterOrderForDefaultSource(this.context.runtime, allowed, descriptor.defaultAdapter);
+        if (primary.length === 0)
+            return [];
+        const primarySet = new Set(primary);
+        const remoteFallback = allowed.filter((adapterId) => !primarySet.has(adapterId) && adapterSourcePolicy(this.context.runtime, adapterId)?.locality === 'remote');
+        if (remoteFallback.length === 0)
+            return [primary];
+        // Local-default manifests are authoritative when they have records. Remote
+        // adapters are only a fallback for runtimes that cannot load local/project
+        // data, such as a cloud executor resolving a consumer-declared descriptor.
+        return [primary, remoteFallback];
     }
     async loadFromAdapter(descriptor, adapterId) {
+        // The resolving runtime's Logging, never an ambient default.
+        const logger = getLogger('storage:resolver', this.context.runtime);
+        // Only an adapter this runtime does not offer is a source to skip (a
+        // cloud executor has no local adapter): asked as a declared fact, so a
+        // load failure from an offered adapter is never mistaken for absence.
+        if (!this.isAdapterOffered(adapterId))
+            return null;
         try {
             const patched = this.patchDescriptorForAdapter(descriptor, adapterId);
             const manifest = new StorageManifest(patched, this.context);
+            const cacheTtl = adapterSourcePolicy(this.context.runtime, adapterId)?.readThroughTtlSeconds;
+            if (cacheTtl !== undefined) {
+                const runtime = this.context.runtime;
+                if (runtime.hasKind('cache/store')) {
+                    let cached = null;
+                    let served = false;
+                    const cacheFailure = await failureOf(async () => {
+                        const cacheStore = ReadThroughCacheSchema.safeParse(await runtime.query('cache/store').first());
+                        if (!cacheStore.success)
+                            return;
+                        const cacheKey = `storage-resolver:${descriptor.id}:${adapterId}`;
+                        cached = await cacheStore.data.getOrSet(cacheKey, () => manifest.load(), { ttl: cacheTtl });
+                        served = true;
+                    });
+                    if (served)
+                        return cached;
+                    // The cache is a declared-optional read-through: say why, then load un-cached.
+                    if (cacheFailure) {
+                        logger.warn('Storage resolver cache read failed; loading un-cached', { manifestId: descriptor.id, adapterId, failure: cacheFailure });
+                    }
+                }
+            }
             return await manifest.load();
         }
-        catch {
-            return null;
+        catch (error) {
+            // A corrupt or unreachable source is carried, never answered as absence:
+            // falling through would serve the next source's data as if this one were empty.
+            const failure = CaughtFailureSchema.parse(error);
+            const typed = CapabilityError.from(failure);
+            throw new CapabilityError(`The resolver could not load '${descriptor.id}' from '${adapterId}'.`, typed.code, {
+                reason: 'storage-resolver-load-failed',
+                retryable: typed.retryable,
+                details: { manifestId: descriptor.id, adapterId, failure: { ...valueFreeFailure(failure) } },
+                cause: failure
+            });
         }
     }
     patchDescriptorForAdapter(descriptor, adapterId) {
-        const source = resolveSourceFromAdapter(adapterId);
+        const source = resolveSourceFromAdapter(this.context.runtime, adapterId);
         const allowedAdapters = [
             adapterId,
             ...(descriptor.allowedAdapters ?? []).filter((id) => id !== adapterId)
         ];
-        const adapterConfig = { ...descriptor.adapterConfig };
-        if (adapterId === 'storage.json') {
-            const jsonConfig = adapterConfig['storage.json'];
-            if (!jsonConfig || typeof jsonConfig !== 'object') {
-                adapterConfig['storage.json'] = { filename: `${descriptor.namespace}.json` };
-            }
-        }
+        const policy = adapterSourcePolicy(this.context.runtime, adapterId);
         const scopePaths = descriptor.scopePaths ? { ...descriptor.scopePaths } : undefined;
-        if (source === 'project-file' && adapterId === 'storage.json') {
-            const nextScopePaths = scopePaths ?? {};
-            nextScopePaths.project = '{workspace}';
-            nextScopePaths.local = '{workspace}';
+        const hasPersistentUserSource = this.context.runtime.hasKind('storage/adapter') && this.context.runtime
+            .query('storage/adapter')
+            .withIds(descriptor.allowedAdapters ?? [])
+            .enabled()
+            .filter((adapter) => adapter.persistent && adapter.sourcePolicy?.source === 'user-localdb')
+            .exists();
+        if (policy?.projectScopePaths && (hasPersistentUserSource || descriptor.scope !== 'global')) {
             return {
                 ...descriptor,
                 allowedAdapters,
                 defaultAdapter: adapterId,
-                scope: resolveScopeForSource(source, descriptor.scope),
-                scopePaths: nextScopePaths,
-                adapterConfig
+                scope: source ? resolveScopeForSource(source, descriptor.scope) : descriptor.scope,
+                scopePaths: { ...scopePaths, ...policy.projectScopePaths }
             };
         }
         return {
             ...descriptor,
             allowedAdapters,
             defaultAdapter: adapterId,
-            scope: source ? resolveScopeForSource(source, descriptor.scope) : descriptor.scope,
-            scopePaths,
-            adapterConfig
+            scope: source && (hasPersistentUserSource || source !== 'project-file')
+                ? resolveScopeForSource(source, descriptor.scope)
+                : descriptor.scope,
+            scopePaths
         };
     }
     mergeSourcedItems(values) {
@@ -148,10 +225,10 @@ export class StorageBackedResolver {
             if (entry.data === null || entry.data === undefined)
                 continue;
             for (const item of this.asItems(entry.data)) {
-                if (item && typeof item === 'object' && typeof item.id === 'string') {
-                    const id = item.id;
-                    if (!byId.has(id))
-                        byId.set(id, { item, source: entry.source });
+                const identified = IdentifiedItemSchema.safeParse(item);
+                if (identified.success) {
+                    if (!byId.has(identified.data.id))
+                        byId.set(identified.data.id, { item, source: entry.source });
                     continue;
                 }
                 loose.push({ item, source: entry.source });
@@ -164,24 +241,28 @@ export class StorageBackedResolver {
             return [];
         if (Array.isArray(data))
             return data;
-        if (typeof data === 'object' && data !== null && data.constructor === Object) {
+        if (data instanceof Object && data.constructor === Object)
             return Object.values(data);
-        }
         return [data];
     }
     withRuntimeSource(descriptor, source) {
         if (!source)
             return descriptor;
-        return Object.assign({}, descriptor, { runtimeSource: source });
+        const sourced = { ...descriptor, runtimeSource: source };
+        return sourced;
     }
     getBridgeConfig() {
         const runtime = this.context.runtime;
         if (!runtime.hasKind(this.manifestKind))
             return null;
-        const manifestDescriptor = runtime.assets(this.manifestKind).descriptor(this.manifestId);
-        if (!manifestDescriptor?.providesRuntimeKinds)
+        const declared = this.getManifestDescriptor()?.providesRuntimeKinds?.[this.targetKind];
+        if (declared === undefined)
             return null;
-        return (manifestDescriptor.providesRuntimeKinds[this.targetKind] ?? null);
+        const config = StorageKindBridgeConfigSchema.safeParse(declared);
+        if (!config.success) {
+            throw new CapabilityError(`Storage manifest '${this.manifestId}' declares an invalid providesRuntimeKinds entry for '${this.targetKind}'.`, 'INVALID_INPUT', { reason: 'storage-kind-bridge-config-invalid', retryable: false, details: { manifestId: this.manifestId, targetKind: this.targetKind } });
+        }
+        return config.data;
     }
 }
 //# sourceMappingURL=storage-backed-resolver.js.map

package/dist/resolver/storage-backed-resolver.js.map

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

package/dist/retention/capacity.d.ts

@@ -0,0 +1,37 @@
+import type { VolumeCapacity } from '../schemas/retention/results.ts';
+export type { VolumeCapacity } from '../schemas/retention/results.ts';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+/** Free bytes below which a volume is low, whatever its size. */
+export declare const LOW_CAPACITY_FREE_BYTES: number;
+/** Free fraction below which a volume is low, whatever its absolute free bytes. */
+export declare const LOW_CAPACITY_FREE_RATIO = 0.05;
+/** Debounce for the startup sweep while capacity is low. */
+export declare const LOW_CAPACITY_SWEEP_INTERVAL_MS: number;
+/** Headroom a full VACUUM must leave on the volume after its worst case. */
+export declare const VACUUM_HEADROOM_BYTES: number;
+/**
+ * Reads the capacity of the volume holding `path`: undefined when `path` is
+ * absent (the host reader asks first), or a rejection carrying the host's
+ * "no such entry" (a reader that does not ask).
+ */
+export type CapacityReader = (path: string) => Promise<VolumeCapacity | undefined>;
+/**
+ * The capacity reader of `runtime`'s host filesystem (`filesystem/adapter`
+ * `volumeCapacity`). A host whose adapter cannot read volume capacity refuses
+ * with the filesystem's typed `volume-capacity` capability refusal.
+ */
+export declare function hostCapacityReader(runtime: RuntimeRef): CapacityReader;
+/**
+ * Capacity of the volume holding `path`, or `undefined` when `path` does not
+ * exist (nothing under it to sweep or reclaim). Every other failure propagates.
+ */
+export declare function readCapacityIfPresent(path: string, reader: CapacityReader): Promise<VolumeCapacity | undefined>;
+export declare function isCapacityLow(capacity: VolumeCapacity): boolean;
+/**
+ * Whether a full VACUUM of a database occupying `databaseBytes` (main file plus
+ * WAL) fits: SQLite writes a rewritten copy, and in WAL mode the rewrite also
+ * lands in the WAL before a checkpoint, so the worst case is twice the
+ * database plus headroom.
+ */
+export declare function hasRoomToVacuum(capacity: VolumeCapacity, databaseBytes: number): boolean;
+//# sourceMappingURL=capacity.d.ts.map

package/dist/retention/capacity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacity.d.ts","sourceRoot":"","sources":["../../src/retention/capacity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAiBtE,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG3E,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,QAAyB,CAAC;AAE9D,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,4DAA4D;AAC5D,eAAO,MAAM,8BAA8B,QAAiB,CAAC;AAE7D,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;AAEnF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAQtE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CASrH;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAG/D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAExF"}

package/dist/retention/capacity.js

@@ -0,0 +1,71 @@
+/**
+ * Disk capacity gate for retention and reclamation (W2).
+ *
+ * Retention used to be purely time-debounced: a volume could run out while
+ * the stamp said "not due", and a full VACUUM could start on a database larger
+ * than the free space it needs. Both 2026 disk incidents ended at ENOSPC, so
+ * capacity is read before either pass, not inferred afterwards.
+ *
+ * - Low capacity shortens the startup sweep's debounce, so rows age out
+ *   out of cycle rather than six hours later.
+ * - A full VACUUM needs room for a rewritten copy plus the WAL frames it
+ *   writes; without that room it is refused with a stated reason instead of
+ *   being attempted.
+ */
+import { readVolumeCapacityChecked } from '@vibesdotdev/filesystem';
+import { CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { hostFileSystemOf } from "../host-files.js";
+/** Free bytes below which a volume is low, whatever its size. */
+export const LOW_CAPACITY_FREE_BYTES = 5 * 1024 * 1024 * 1024;
+/** Free fraction below which a volume is low, whatever its absolute free bytes. */
+export const LOW_CAPACITY_FREE_RATIO = 0.05;
+/** Debounce for the startup sweep while capacity is low. */
+export const LOW_CAPACITY_SWEEP_INTERVAL_MS = 15 * 60 * 1000;
+/** Headroom a full VACUUM must leave on the volume after its worst case. */
+export const VACUUM_HEADROOM_BYTES = 256 * 1024 * 1024;
+/**
+ * The capacity reader of `runtime`'s host filesystem (`filesystem/adapter`
+ * `volumeCapacity`). A host whose adapter cannot read volume capacity refuses
+ * with the filesystem's typed `volume-capacity` capability refusal.
+ */
+export function hostCapacityReader(runtime) {
+    return async (path) => {
+        const fs = await hostFileSystemOf(runtime, 'retention-filesystem-unavailable');
+        // Absence is asked as a fact (the host's capacity read projects a missing
+        // path as a typed `filesystem-capacity-failed`, not as absence).
+        if (!(await fs.exists(path)))
+            return undefined;
+        return readVolumeCapacityChecked(fs, path);
+    };
+}
+/**
+ * Capacity of the volume holding `path`, or `undefined` when `path` does not
+ * exist (nothing under it to sweep or reclaim). Every other failure propagates.
+ */
+export async function readCapacityIfPresent(path, reader) {
+    try {
+        return await reader(path);
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        // Only the host's "no such entry" is absence; any other failure propagates.
+        if (failure instanceof Error && 'code' in failure && failure.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+export function isCapacityLow(capacity) {
+    if (capacity.freeBytes < LOW_CAPACITY_FREE_BYTES)
+        return true;
+    return capacity.totalBytes > 0 && capacity.freeBytes / capacity.totalBytes < LOW_CAPACITY_FREE_RATIO;
+}
+/**
+ * Whether a full VACUUM of a database occupying `databaseBytes` (main file plus
+ * WAL) fits: SQLite writes a rewritten copy, and in WAL mode the rewrite also
+ * lands in the WAL before a checkpoint, so the worst case is twice the
+ * database plus headroom.
+ */
+export function hasRoomToVacuum(capacity, databaseBytes) {
+    return capacity.freeBytes >= 2 * databaseBytes + VACUUM_HEADROOM_BYTES;
+}
+//# sourceMappingURL=capacity.js.map

package/dist/retention/capacity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacity.js","sourceRoot":"","sources":["../../src/retention/capacity.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAmB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,iEAAiE;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9D,mFAAmF;AACnF,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AASvD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAmB;IACrD,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAC;QAC/E,0EAA0E;QAC1E,iEAAiE;QACjE,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAO,yBAAyB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAsB;IAC/E,IAAI,CAAC;QACJ,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,4EAA4E;QAC5E,IAAI,OAAO,YAAY,KAAK,IAAI,MAAM,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACjG,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAwB;IACrD,IAAI,QAAQ,CAAC,SAAS,GAAG,uBAAuB;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,QAAQ,CAAC,UAAU,GAAG,CAAC,IAAI,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,UAAU,GAAG,uBAAuB,CAAC;AACtG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAwB,EAAE,aAAqB;IAC9E,OAAO,QAAQ,CAAC,SAAS,IAAI,CAAC,GAAG,aAAa,GAAG,qBAAqB,CAAC;AACxE,CAAC"}

package/dist/retention/catalog-chunks.d.ts

@@ -0,0 +1,11 @@
+import type { CatalogChunkPruneResult } from '../schemas/retention/results.ts';
+export type { CatalogChunkPruneResult } from '../schemas/retention/results.ts';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+/** The runtime the prune resolves the catalog manifest and the host filesystem on. */
+export type CatalogChunkPruneRuntime = RuntimeRef;
+export declare function pruneCatalogChunksForRoot(runtime: CatalogChunkPruneRuntime, root: string): Promise<CatalogChunkPruneResult>;
+export declare function pruneCatalogChunks(runtime: CatalogChunkPruneRuntime, roots: readonly string[]): Promise<{
+    roots: CatalogChunkPruneResult[];
+    deleted: number;
+}>;
+//# sourceMappingURL=catalog-chunks.d.ts.map

package/dist/retention/catalog-chunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-chunks.d.ts","sourceRoot":"","sources":["../../src/retention/catalog-chunks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAiB/E,OAAO,EAA6D,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAWjH,sFAAsF;AACtF,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAQlD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,wBAAwB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAsBjI;AAED,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC;IAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAShE"}

package/dist/retention/catalog-chunks.js

@@ -0,0 +1,62 @@
+/**
+ * Prune unreferenced workspace catalog chunks.
+ *
+ * Catalog blobs live as one file per CID under `.vibes/catalog/chunks`. The
+ * catalog head (a storage manifest) is the live set; everything else is an
+ * orphan left behind when a fragment was replaced. `vibes gc` already
+ * classified this directory as cache — this is the collector that makes that
+ * classification true.
+ *
+ * Storage must not import `@vibesdotdev/workspace`. The catalog service is
+ * resolved through the runtime when the workspace plugin is loaded; if it
+ * isn't, we skip rather than guess which files are live. A skip names its
+ * value-free reason (class, code, reason), never a failure's text.
+ */
+import * as z from 'zod/v4';
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { hostEntryKind, hostFileSystemOf } from "../host-files.js";
+const WORKSPACE_CATALOG_MANIFEST_ID = 'dev.workspace.catalog';
+/** What the prune needs from the catalog's chunk store and service (read once, at the boundary). */
+const GcResultSchema = z.object({ scanned: z.number().int().nonnegative(), deleted: z.number().int().nonnegative() });
+const CatalogManifestSchema = z.object({
+    collectChunks: z.custom((value) => value instanceof Function)
+});
+/** A failure's value-free facts as one line (`Error ENOENT`, `CapabilityError NOT_FOUND storage-…`). */
+function skipReason(prefix, error) {
+    const facts = valueFreeFailure(error);
+    return [prefix, facts.name, facts.code, facts.reason].filter((part) => part !== undefined).join(' ');
+}
+export async function pruneCatalogChunksForRoot(runtime, root) {
+    const fs = await hostFileSystemOf(runtime, 'retention-filesystem-unavailable');
+    // No catalog directory (absent, or not a directory) means no chunks; any other failure surfaces.
+    if ((await hostEntryKind(fs, fs.join(root, 'catalog', 'chunks'))) !== 'directory') {
+        return { root, scanned: 0, deleted: 0, skipped: 'no catalog/chunks directory' };
+    }
+    let resolved;
+    try {
+        resolved = CatalogManifestSchema.parse(await runtime.query('storage/manifest').withId(WORKSPACE_CATALOG_MANIFEST_ID).resolve());
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        return { root, scanned: 0, deleted: 0, skipped: skipReason('catalog manifest unavailable:', failure), failure: valueFreeFailure(failure) };
+    }
+    try {
+        const result = GcResultSchema.parse(await resolved.collectChunks(fs.dirname(root)));
+        return { root, scanned: result.scanned, deleted: result.deleted };
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        return { root, scanned: 0, deleted: 0, skipped: skipReason('catalog prune failed:', failure), failure: valueFreeFailure(failure) };
+    }
+}
+export async function pruneCatalogChunks(runtime, roots) {
+    const results = [];
+    for (const root of roots) {
+        results.push(await pruneCatalogChunksForRoot(runtime, root));
+    }
+    return {
+        roots: results,
+        deleted: results.reduce((sum, result) => sum + result.deleted, 0)
+    };
+}
+//# sourceMappingURL=catalog-chunks.js.map