@lmzhen/dsh-evolution-state-storage 0.3.51 → 0.3.52

package/lib/index.js

@@ -1,4 +1,38 @@
 import { Service } from "@deepseek-ai/cordis";
+//#region lib/types/constants.js
+/**
+* Single source for the state-stack magic strings (audit v10 S-06).
+*
+* The singleton curator key, the on-disk state file names, the provider names
+* and the domain table names live here so the two providers (json/domain)
+* cannot drift a literal independently — a drifted literal is exactly the
+* E-10 divergence class both providers already guard against elsewhere.
+* These values are FORMAT-STABLE: the file names and the `'primary'` key are
+* on-disk contracts, the provider names are registry keys, and the table
+* names are domain-spec keys — renaming any of them orphans data or breaks
+* the seam, never rename casually.
+* @module @lmzhen/dsh-evolution-state-storage/src/constants
+*/
+/** Singleton curator-state record key in both providers (the json map key and
+* the domain table key). */
+const CURATOR_STATE_KEY = "primary";
+/** On-disk state file names (json provider, relative to its configured root). */
+const REVIEW_STATE_FILE = "review-state.json";
+const CURATOR_STATE_FILE = "curator-state.json";
+const PENDING_STATE_FILE = "pending-state.json";
+/** Pre-split approval store; read-only legacy, retired after the merge. */
+const PENDING_LEGACY_FILE = "pending.json";
+const PENDING_ARCHIVE_FILE = "pending-state-archive.json";
+/** Rotation sidecar of {@link PENDING_ARCHIVE_FILE} (V4-01). */
+const PENDING_ARCHIVE_BAK_FILE = "pending-state-archive.json.bak";
+/** Provider names as registered on the `evolutionStateStorage` seam. */
+const PROVIDER_JSON = "json";
+const PROVIDER_DOMAIN = "domain";
+/** Domain table names of the evolution storage-domain spec. */
+const REVIEW_STATE_TABLE = "review_state";
+const CURATOR_STATE_TABLE = "curator_state";
+const PENDING_TABLE = "pending";
+//#endregion
 //#region lib/types/index.js
 /**
 * Provider seam for durable evolution state.
@@ -28,6 +62,13 @@ var EvolutionStateStorageRegistry = class extends Service {
 			if (this.providers.get(provider.name) === provider) this.providers.delete(provider.name);
 		};
 	}
+	/** S-07: whether ANY provider is registered. Lets the state
+	* consumer precheck a pinned `provider` config at mount time (a typo fails
+	* at start with the registry's precise message) while staying lazy when no
+	* provider has registered yet (mount order not settled). */
+	hasProviders() {
+		return this.providers.size > 0;
+	}
 	provider(name) {
 		if (name) {
 			const provider = this.providers.get(name);
@@ -40,4 +81,4 @@ var EvolutionStateStorageRegistry = class extends Service {
 	}
 };
 //#endregion
-export { EvolutionStateStorageRegistry, EvolutionStateStorageRegistry as default, canClaimPending, canResolvePending, 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_STATE_FILE, PENDING_TABLE, PROVIDER_DOMAIN, PROVIDER_JSON, REVIEW_STATE_FILE, REVIEW_STATE_TABLE, canClaimPending, canResolvePending, releasedStatus };

package/lib/types/constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Single source for the state-stack magic strings (audit v10 S-06).
+ *
+ * The singleton curator key, the on-disk state file names, the provider names
+ * and the domain table names live here so the two providers (json/domain)
+ * cannot drift a literal independently — a drifted literal is exactly the
+ * E-10 divergence class both providers already guard against elsewhere.
+ * These values are FORMAT-STABLE: the file names and the `'primary'` key are
+ * on-disk contracts, the provider names are registry keys, and the table
+ * names are domain-spec keys — renaming any of them orphans data or breaks
+ * the seam, never rename casually.
+ * @module @lmzhen/dsh-evolution-state-storage/src/constants
+ */
+/** Singleton curator-state record key in both providers (the json map key and
+ * the domain table key). */
+export declare const CURATOR_STATE_KEY = "primary";
+/** On-disk state file names (json provider, relative to its configured root). */
+export declare const REVIEW_STATE_FILE = "review-state.json";
+export declare const CURATOR_STATE_FILE = "curator-state.json";
+export declare const PENDING_STATE_FILE = "pending-state.json";
+/** Pre-split approval store; read-only legacy, retired after the merge. */
+export declare const PENDING_LEGACY_FILE = "pending.json";
+export declare const PENDING_ARCHIVE_FILE = "pending-state-archive.json";
+/** Rotation sidecar of {@link PENDING_ARCHIVE_FILE} (V4-01). */
+export declare const PENDING_ARCHIVE_BAK_FILE = "pending-state-archive.json.bak";
+/** Provider names as registered on the `evolutionStateStorage` seam. */
+export declare const PROVIDER_JSON = "json";
+export declare const PROVIDER_DOMAIN = "domain";
+/** Domain table names of the evolution storage-domain spec. */
+export declare const REVIEW_STATE_TABLE = "review_state";
+export declare const CURATOR_STATE_TABLE = "curator_state";
+export declare const PENDING_TABLE = "pending";
+//# sourceMappingURL=constants.d.ts.map

package/lib/types/index.d.ts

@@ -7,6 +7,7 @@
  * @module @lmzhen/dsh-evolution-state-storage
  */
 import { Context, Service } from '@deepseek-ai/cordis';
+export * from './constants.ts';
 /** 0.3.17 (S3.5, D-4): 'skill_batch' removed — nothing ever created one
  * (dead enum member); the historic value, if it ever reached disk, is read as
  * an unknown kind by consumers rather than minted here. */
@@ -96,6 +97,11 @@ export declare class EvolutionStateStorageRegistry extends Service {
     private readonly providers;
     constructor(ctx: Context);
     registerProvider(provider: EvolutionStateStorage): () => void;
+    /** S-07: whether ANY provider is registered. Lets the state
+     * consumer precheck a pinned `provider` config at mount time (a typo fails
+     * at start with the registry's precise message) while staying lazy when no
+     * provider has registered yet (mount order not settled). */
+    hasProviders(): boolean;
     provider(name?: string): EvolutionStateStorage;
 }
 export default EvolutionStateStorageRegistry;

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@lmzhen/dsh-evolution-state-storage",
   "description": "Provider registry seam for durable evolution state (community build)",
-  "version": "0.3.51",
+  "version": "0.3.52",
   "publishConfig": {
     "access": "public"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lmzhen/dsh-evolution.git",
-    "directory": "packages/dsh-evolution-state-storage"
+    "directory": "packages/evolution-state-storage"
   },
   "type": "module",
   "main": "lib/index.js",