@cat-factory/kernel 0.120.0 → 0.121.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -12,9 +12,9 @@
12
12
  * - `binary_artifacts` — its rows are only half the story: the backing blob BYTES
13
13
  * (R2 / S3 / filesystem) must be deleted through the `BinaryBlobBackend` port at
14
14
  * the service layer, not by bare SQL. Deleting the metadata row here would strand
15
- * the bytes forever (the row is the only handle on the blob key). Reclaimed by the
16
- * workspace-delete blob purge instead. (Until that lands, these rows continue to
17
- * orphan exactly as before no regression from this list.)
15
+ * the bytes forever (the row is the only handle on the blob key). Reclaimed instead
16
+ * by `WorkspaceService.delete`, which purges rows + bytes together through the
17
+ * `BinaryArtifactStore.deleteByWorkspace` port BEFORE this cascade runs.
18
18
  * - Runtime-specific tables that only exist on one facade (e.g. the Cloudflare-only
19
19
  * `live_containers` Durable-Object tracking table) are appended by that facade.
20
20
  */
@@ -36,9 +36,9 @@
36
36
  * - `binary_artifacts` — its rows are only half the story: the backing blob BYTES
37
37
  * (R2 / S3 / filesystem) must be deleted through the `BinaryBlobBackend` port at
38
38
  * the service layer, not by bare SQL. Deleting the metadata row here would strand
39
- * the bytes forever (the row is the only handle on the blob key). Reclaimed by the
40
- * workspace-delete blob purge instead. (Until that lands, these rows continue to
41
- * orphan exactly as before no regression from this list.)
39
+ * the bytes forever (the row is the only handle on the blob key). Reclaimed instead
40
+ * by `WorkspaceService.delete`, which purges rows + bytes together through the
41
+ * `BinaryArtifactStore.deleteByWorkspace` port BEFORE this cascade runs.
42
42
  * - Runtime-specific tables that only exist on one facade (e.g. the Cloudflare-only
43
43
  * `live_containers` Durable-Object tracking table) are appended by that facade.
44
44
  */
@@ -65,6 +65,21 @@ export interface BinaryArtifactStore {
65
65
  * Drives the configurable per-workspace retention cleanup (default 14 days).
66
66
  */
67
67
  pruneOlderThan(workspaceId: string, olderThan: number): Promise<number>;
68
+ /**
69
+ * Board-delete reclaim: delete EVERY artifact in the workspace — BOTH the metadata rows
70
+ * AND their bytes — and return how many were removed. Called from the workspace-delete
71
+ * path (the retention sweeps only ever see LIVE workspaces via `listVisible`, so a deleted
72
+ * workspace's artifacts would otherwise leak the heavy blob bytes forever). Same fail-safe
73
+ * blobs-first ordering as {@link pruneOlderThan}: a blob whose delete throws keeps its
74
+ * metadata row (the only handle on the key) rather than orphaning the bytes.
75
+ *
76
+ * NOTE the asymmetry with {@link pruneOlderThan}'s retry story: the retention sweep revisits
77
+ * a LIVE workspace hourly, so a row it retains is genuinely retried; but a DELETED workspace
78
+ * never reappears in `listVisible`, so a row retained here is NOT auto-retried — it needs an
79
+ * out-of-band reclaim. The composed store therefore logs (via its injected logger) whenever a
80
+ * blob delete fails so the residual leak is surfaced rather than silent.
81
+ */
82
+ deleteByWorkspace(workspaceId: string): Promise<number>;
68
83
  }
69
84
  /** Per-runtime metadata persistence (D1 ⇄ Drizzle). Bytes live elsewhere. */
70
85
  export interface BinaryArtifactMetadataStore {
@@ -79,6 +94,10 @@ export interface BinaryArtifactMetadataStore {
79
94
  listOlderThan(workspaceId: string, olderThan: number): Promise<BinaryArtifactRecord[]>;
80
95
  /** Delete metadata rows in the workspace created before `olderThan`; returns the count. */
81
96
  deleteOlderThan(workspaceId: string, olderThan: number): Promise<number>;
97
+ /** Every record in the workspace — for the workspace-delete purge. */
98
+ listByWorkspace(workspaceId: string): Promise<BinaryArtifactRecord[]>;
99
+ /** Delete every metadata row in the workspace; returns the count. */
100
+ deleteByWorkspace(workspaceId: string): Promise<number>;
82
101
  }
83
102
  /**
84
103
  * The pluggable blob backend — the "custom adapter interface". Implement this to
@@ -115,5 +134,14 @@ export declare function createBinaryArtifactStore(deps: {
115
134
  blob: BinaryBlobBackend;
116
135
  idGenerator: IdGenerator;
117
136
  clock: Clock;
137
+ /**
138
+ * Optional structural logger for best-effort diagnostics. Used only to SURFACE a partial
139
+ * reclaim (one or more blob deletes failed, so their metadata rows are retained) — otherwise
140
+ * that residual leak would be silent. See {@link BinaryArtifactStore.deleteByWorkspace} for
141
+ * why the workspace-delete path in particular has no auto-retry to fall back on.
142
+ */
143
+ logger?: {
144
+ warn(obj: Record<string, unknown>, msg?: string): void;
145
+ };
118
146
  }): BinaryArtifactStore;
119
147
  //# sourceMappingURL=binary-artifacts.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"binary-artifacts.d.ts","sourceRoot":"","sources":["../../src/ports/binary-artifacts.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"binary-artifacts.d.ts","sourceRoot":"","sources":["../../src/ports/binary-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAuBtD,iFAAiF;AACjF,MAAM,MAAM,yBAAyB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,QAAQ,CAAA;AAE5E,+EAA+E;AAC/E,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,WAAW,CAAA;AAE3D,2FAA2F;AAC3F,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,kBAAkB,CAAA;IACxB,gFAAgF;IAChF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,OAAO,EAAE,yBAAyB,CAAA;IAClC,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,iFAAiF;AACjF,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,IAAI,CACR,oBAAoB,EACpB,aAAa,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAC5E,CAAA;IACD,IAAI,EAAE,UAAU,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACrE,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAClF,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IACpE;;;;;OAKG;IACH,mBAAmB,CACjB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;QAAE,MAAM,EAAE,oBAAoB,CAAC;QAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC7E,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IAC1F,0GAA0G;IAC1G,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3E;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IAClF,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvE;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACxD;AAED,6EAA6E;AAC7E,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAC1E,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IAC1F,4FAA4F;IAC5F,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3E,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IAClF,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,gGAAgG;IAChG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IACtF,2FAA2F;IAC3F,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACxE,sEAAsE;IACtE,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IACrE,qEAAqE;IACrE,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACxD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAA;IACxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAA;AAgCxC;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,2BAA2B,CAAA;IACrC,IAAI,EAAE,iBAAiB,CAAA;IACvB,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ;;;;;OAKG;IACH,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CACpE,GAAG,mBAAmB,CA0GtB"}
@@ -27,7 +27,48 @@ async function sha256Hex(bytes) {
27
27
  * metadata row. Deleting removes the bytes best-effort then the metadata.
28
28
  */
29
29
  export function createBinaryArtifactStore(deps) {
30
- const { metadata, blob, idGenerator, clock } = deps;
30
+ const { metadata, blob, idGenerator, clock, logger } = deps;
31
+ // Shared fail-safe reclaim for a batch of records (drives both `pruneOlderThan` and
32
+ // `deleteByWorkspace`). Delete the BYTES first (best-effort per blob, so one stuck object
33
+ // doesn't strand the rest), then drop the metadata rows. The invariant in both directions:
34
+ // NEVER drop a metadata row whose blob is still present-but-failed-to-delete, because that
35
+ // would orphan the bytes forever (the metadata is the only handle on the key). So a blob
36
+ // delete that throws keeps its metadata row, leaving the pair intact — and the common
37
+ // all-succeeded path still collapses to a single bulk delete. We also never keep a metadata
38
+ // row pointing at already-deleted bytes.
39
+ //
40
+ // Whether the retained pair is genuinely retried depends on the caller: `pruneOlderThan` runs
41
+ // against a LIVE workspace the sweep revisits hourly (real retry), but `deleteByWorkspace`'s
42
+ // workspace never reappears in `listVisible` (no auto-retry — an out-of-band reclaim is
43
+ // needed). Either way a non-empty failure set is a leak worth surfacing, so we log it here
44
+ // rather than swallowing it silently at every call site.
45
+ async function reclaim(records, bulkDelete) {
46
+ const failed = new Set();
47
+ for (const record of records) {
48
+ try {
49
+ await blob.delete(record.storageKey);
50
+ }
51
+ catch {
52
+ // Tolerate a backend hiccup on a single object; retain its metadata so a later reclaim
53
+ // retries the blob delete instead of orphaning the bytes.
54
+ failed.add(record.id);
55
+ }
56
+ }
57
+ // Fast path: every blob went, so a single range delete reclaims all the metadata.
58
+ if (failed.size === 0)
59
+ return bulkDelete();
60
+ logger?.warn({ workspaceId: records[0]?.workspaceId, failed: failed.size, total: records.length }, 'binary-artifact reclaim: some blob deletes failed; their metadata rows are retained (bytes not yet reclaimed)');
61
+ // Otherwise delete only the rows whose bytes are confirmed gone, one at a time, leaving the
62
+ // failed pairs (row + blob) intact for a later reclaim.
63
+ let removed = 0;
64
+ for (const record of records) {
65
+ if (failed.has(record.id))
66
+ continue;
67
+ await metadata.delete(record.workspaceId, record.id);
68
+ removed += 1;
69
+ }
70
+ return removed;
71
+ }
31
72
  return {
32
73
  async store(input) {
33
74
  const id = idGenerator.next('art');
@@ -83,38 +124,12 @@ export function createBinaryArtifactStore(deps) {
83
124
  await metadata.delete(workspaceId, id);
84
125
  },
85
126
  async pruneOlderThan(workspaceId, olderThan) {
86
- // Delete the BYTES first (best-effort per blob, so one stuck object doesn't strand the
87
- // rest), then drop the metadata rows. The invariant in both directions: we NEVER drop a
88
- // metadata row whose blob is still present-but-failed-to-delete, because that would orphan
89
- // the bytes forever (the metadata is the only handle the next sweep has on the key). So a
90
- // blob delete that throws keeps its metadata row, leaving the pair intact for the next
91
- // sweep to retry — and the common all-succeeded path still collapses to a single bulk
92
- // delete. We also never keep a metadata row pointing at already-deleted bytes.
93
127
  const expired = await metadata.listOlderThan(workspaceId, olderThan);
94
- const failed = new Set();
95
- for (const record of expired) {
96
- try {
97
- await blob.delete(record.storageKey);
98
- }
99
- catch {
100
- // Tolerate a backend hiccup on a single object; retain its metadata so the next sweep
101
- // retries the blob delete instead of orphaning the bytes.
102
- failed.add(record.id);
103
- }
104
- }
105
- // Fast path: every blob went, so a single range delete reclaims all the metadata.
106
- if (failed.size === 0)
107
- return metadata.deleteOlderThan(workspaceId, olderThan);
108
- // Otherwise delete only the rows whose bytes are confirmed gone, one at a time, leaving
109
- // the failed pairs (row + blob) for the next sweep.
110
- let removed = 0;
111
- for (const record of expired) {
112
- if (failed.has(record.id))
113
- continue;
114
- await metadata.delete(workspaceId, record.id);
115
- removed += 1;
116
- }
117
- return removed;
128
+ return reclaim(expired, () => metadata.deleteOlderThan(workspaceId, olderThan));
129
+ },
130
+ async deleteByWorkspace(workspaceId) {
131
+ const all = await metadata.listByWorkspace(workspaceId);
132
+ return reclaim(all, () => metadata.deleteByWorkspace(workspaceId));
118
133
  },
119
134
  };
120
135
  }
@@ -1 +1 @@
1
- {"version":3,"file":"binary-artifacts.js","sourceRoot":"","sources":["../../src/ports/binary-artifacts.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"binary-artifacts.js","sourceRoot":"","sources":["../../src/ports/binary-artifacts.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cat-factory/kernel",
3
- "version": "0.120.0",
3
+ "version": "0.121.0",
4
4
  "description": "Shared vocabulary, pure logic, and port interfaces for the Agent Architecture Board.",
5
5
  "repository": {
6
6
  "type": "git",