@lmzhen/dsh-evolution-state-storage 0.3.66 → 0.3.67

package/lib/index.js

@@ -95,6 +95,7 @@ function recordIssue(table, record) {
 	if (typeof value.kind !== "string" || !PENDING_KINDS.has(value.kind)) return "kind must be memory|skill|capability";
 	if (typeof value.summary !== "string") return "summary must be a string";
 	if (!Object.prototype.hasOwnProperty.call(value, "args")) return "args key is required (may be any cloneable value)";
+	if (value.args === void 0) return "args must be a cloneable value — `undefined` is dropped by the json medium and the record would be unreadable after a restart (pass {} instead)";
 	if (typeof value.createdAt !== "string") return "createdAt must be a string";
 	if (typeof value.status !== "string" || !PENDING_STATUSES.has(value.status)) return "status must be pending|executing|approved|rejected";
 	for (const field of [
@@ -157,6 +158,18 @@ const releasedStatus = (status) => status === "executing" ? "pending" : status;
 * The audit ARCHIVE sidecar that json maintains beyond the cap stays
 * json-specific (domain has no sidecar facility) — declared in both READMEs. */
 const PENDING_RESOLVED_CAP = 200;
+/**
+* V24-08 (v24): session rows in the review-state table, per session id. The
+* review pipeline saves on EVERY turn/end of EVERY session and nothing ever
+* deleted rows, so the file grew (and was fully rewritten) with the deploy's
+* whole session history — the same unbounded-growth class the pending cap
+* above already fixed for approvals. A review row is advisory cadence state:
+* evicting the least-recently-active session merely lets that session's next
+* review fire from a fresh counter, so a generous cap is loss-less in
+* practice. Enforced by BOTH providers inside their save path (no seam
+* interface change, no background sweeper).
+*/
+const REVIEW_STATE_SESSION_CAP = 500;
 var EvolutionStateStorageRegistry = class extends Service {
 	providers = /* @__PURE__ */ new Map();
 	/** C-7 (v18): per-name dispose, mirroring the evolution-io registry. */
@@ -203,4 +216,4 @@ var EvolutionStateStorageRegistry = class extends Service {
 	}
 };
 //#endregion
-export { CURATOR_STATE_FILE, CURATOR_STATE_KEY, CURATOR_STATE_TABLE, EvolutionStateStorageRegistry, EvolutionStateStorageRegistry as default, PENDING_ARCHIVE_BAK_FILE, PENDING_ARCHIVE_FILE, PENDING_LEGACY_FILE, PENDING_RESOLVED_CAP, PENDING_STATE_FILE, PENDING_TABLE, PROVIDER_DOMAIN, PROVIDER_JSON, REVIEW_STATE_FILE, REVIEW_STATE_TABLE, UNKNOWN_FIELD_POLICY, assertCloneable, canClaimPending, canResolvePending, cloneRecord, recordIssue, releasedStatus };
+export { CURATOR_STATE_FILE, CURATOR_STATE_KEY, CURATOR_STATE_TABLE, EvolutionStateStorageRegistry, EvolutionStateStorageRegistry as default, PENDING_ARCHIVE_BAK_FILE, PENDING_ARCHIVE_FILE, PENDING_LEGACY_FILE, PENDING_RESOLVED_CAP, PENDING_STATE_FILE, PENDING_TABLE, PROVIDER_DOMAIN, PROVIDER_JSON, REVIEW_STATE_FILE, REVIEW_STATE_SESSION_CAP, REVIEW_STATE_TABLE, UNKNOWN_FIELD_POLICY, assertCloneable, canClaimPending, canResolvePending, cloneRecord, recordIssue, releasedStatus };

package/lib/types/index.d.ts

@@ -48,6 +48,18 @@ export declare const releasedStatus: (status: PendingStatus) => PendingStatus;
  * The audit ARCHIVE sidecar that json maintains beyond the cap stays
  * json-specific (domain has no sidecar facility) — declared in both READMEs. */
 export declare const PENDING_RESOLVED_CAP = 200;
+/**
+ * V24-08 (v24): session rows in the review-state table, per session id. The
+ * review pipeline saves on EVERY turn/end of EVERY session and nothing ever
+ * deleted rows, so the file grew (and was fully rewritten) with the deploy's
+ * whole session history — the same unbounded-growth class the pending cap
+ * above already fixed for approvals. A review row is advisory cadence state:
+ * evicting the least-recently-active session merely lets that session's next
+ * review fire from a fresh counter, so a generous cap is loss-less in
+ * practice. Enforced by BOTH providers inside their save path (no seam
+ * interface change, no background sweeper).
+ */
+export declare const REVIEW_STATE_SESSION_CAP = 500;
 /**
  * Claim lifecycle (S3.3): pending →(claim)→ executing →(resolve)→ approved/rejected.
  * release() rolls executing back to pending (failure path). A crash between

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-state-storage",
   "description": "Provider registry seam for durable evolution state (community build)",
-  "version": "0.3.66",
+  "version": "0.3.67",
   "publishConfig": {
     "access": "public"
   },