@lmzhen/dsh-evolution-io 0.3.22 → 0.3.23

package/lib/types/index.d.ts

@@ -3,45 +3,24 @@
  * @module @lmzhen/dsh-evolution-io
  */
 import { Context, Service } from '@deepseek-ai/cordis';
-export interface EvolutionIo {
+import type { EvolutionIoLike } from '@lmzhen/dsh-evolution-core';
+/**
+ * The family's IO seam. Everything except `transact` is single-sourced from
+ * core `EvolutionIoLike` (0.3.23 G1.3, F-340): the seam no longer redeclares
+ * `size`/`isSymlink`/`mtime` or their `this: void` and null-vs-undefined
+ * contracts, so a drift between seam and core in those fields is impossible by
+ * construction. `name` stays seam-only and is added here.
+ *
+ * `transact` stays intentionally narrower than core: seam backends (e.g.
+ * `nodeEvolutionIo`) are uniformly async, so the task may return only a
+ * `Promise`. Core additionally allows a sync return (0.3.16 S1.14 X-1); the
+ * bidirectional-await-compatible consumers live in `transactIo` and the
+ * evolution IO adapter.
+ */
+export type EvolutionIo = Omit<EvolutionIoLike, 'transact'> & {
     readonly name: string;
-    readText(path: string): Promise<string | null>;
-    writeText(path: string, content: string): Promise<void>;
-    remove(path: string): Promise<void>;
-    list(path: string): Promise<string[]>;
-    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): 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>;
-    /**
-     * Optional mtime-generation probe (0.3.18, E-71): milliseconds since epoch
-     * of the path's mtime, or `null` when unknown (unsupported backend, missing
-     * path, stat failure). Consumers use it as a cheap invalidation stamp for a
-     * cached listing. Mirrors `EvolutionIoLike.mtime`.
-     */
-    mtime?(this: void, path: string): Promise<number | null>;
-}
+};
 declare module '@deepseek-ai/cordis' {
     interface Context {
         evolutionIo: EvolutionIoRegistry;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-io",
   "description": "IO seam for evolution providers (community build)",
-  "version": "0.3.22",
+  "version": "0.3.23",
   "publishConfig": {
     "access": "public"
   },
@@ -29,7 +29,9 @@
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
-  "dependencies": {},
+  "dependencies": {
+    "@lmzhen/dsh-evolution-core": "^0.3.23"
+  },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1"