@lmzhen/dsh-evolution-io 0.1.0-rc.7 → 0.1.0-rc.71

package/lib/types/index.d.ts

@@ -12,6 +12,28 @@ export interface EvolutionIo {
     exists(path: string): Promise<boolean>;
     rename(path: string, destination: string): Promise<void>;
     copy(path: string, destination: string): Promise<void>;
+    /**
+     * Optional byte-size probe for the read guard. Return the file's size in
+     * bytes, or `null` when unknown (unsupported backend, missing file, stat
+     * failure). An implementation without this probe gets no read guard.
+     */
+    size?(path: string, signal?: AbortSignal): Promise<number | null>;
+    /**
+     * Optional atomic read-modify-write (rc.50 P2-2): the read and the write run
+     * inside a single cross-process lock so two processes sharing DSH_HOME
+     * cannot interleave their RMW sequences. Backends without it fall back to
+     * plain read+write and the consumer keeps its single-process chain as the
+     * second layer. Mirrors `EvolutionIoLike.transact` in core — providers that
+     * implement it (e.g. `nodeEvolutionIo`) expose it here, and consumers read
+     * it through `transactIo` / the evolution IO adapter.
+     */
+    transact?(this: void, path: string, task: (current: string | null) => Promise<string | null>): Promise<void>;
+    /**
+     * Optional symlink probe (G7). `true` = the path is a symlink, `false` = a
+     * real entry, `null` = guard not applicable. Consumers treat `null` as
+     * "let it through". Mirrors `EvolutionIoLike.isSymlink`.
+     */
+    isSymlink?(this: void, path: string): Promise<boolean | null>;
 }
 declare module '@deepseek-ai/cordis' {
     interface Context {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-io",
   "description": "IO seam for evolution providers (community build)",
-  "version": "0.1.0-rc.7",
+  "version": "0.1.0-rc.71",
   "publishConfig": {
     "access": "public"
   },
@@ -35,10 +35,10 @@
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6"
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2"
   }
 }