@deepseek-ai/dsh-session-format 0.1.3-alpha.2 → 0.1.5-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/session/session-format/README.md
-README.md: d44a7091bc5840afcb5d1e73f594284c3d5c8206
-README.zh.md: f4b6acd8e0ba3c28a1b5088fc577e1b4289ca9a0
+README.md: 040d3383864d008b9df62378063a11223c1373be
+README.zh.md: 7c57123ac7315cfc15e7a20f6834e8ae48fad3ec

package/README.md

@@ -55,7 +55,7 @@ The recoverable decoder returns the accepted logical prefix. A codec may drop on
 <details>
 <summary>Implementation internals — click to expand</summary>
 
-The chain validates unique gap-free ordering at construction. The catalog composes one row decoder with stateful adjacent event transformers, retains only their bounded state and the final current events, and performs target validation at `finish()`; only the caller decides whether and how to publish that result.
+The chain validates unique gap-free ordering at construction. A source cut may be unknown until EOF; stages that require a header cut reject its absence, while marker-based stages derive it from emitted events. Each stage returns its exact target cut at finish, and any predeclared cut must agree. The catalog composes one row decoder with stateful adjacent event transformers, retains only their bounded state and the final current events, and performs target validation at `finish()`; only the caller decides whether and how to publish that result.
 
 | File | Role |
 |---|---|

package/README.zh.md

@@ -55,7 +55,7 @@ const eventRecords = current.events.map(catalog.encodeCurrentEvent)
 <details>
 <summary>实现细节——点击展开</summary>
 
-迁移链在构造时校验唯一且无缺口的顺序。Catalog 把一个行 decoder 与有状态的相邻事件 transformer 组合起来，只保留其有界状态与最终当前事件，并在 `finish()` 时执行目标校验；只有调用方决定是否发布该结果以及如何发布。
+迁移链在构造时校验唯一且无缺口的顺序。源切点可以在 EOF 前保持未知；依赖头部切点的 Stage 拒绝缺失值，而基于标记的 Stage 从已发出的事件推导切点。每个 Stage 在完成时返回精确的目标切点，且必须与预声明切点一致。Catalog 把一个行 decoder 与有状态的相邻事件 transformer 组合起来，只保留其有界状态与最终当前事件，并在 `finish()` 时执行目标校验；只有调用方决定是否发布该结果以及如何发布。
 
 | 文件 | 职责 |
 |---|---|

package/lib/index.js

@@ -136,7 +136,7 @@ var CompiledSessionFormatChain = class {
 	}
 	createStream(sourceHeader, sourceCut, output) {
 		let header = sourceHeader;
-		const validatedSourceCut = sessionFormatCount(sourceCut, "Session inherited event count");
+		const validatedSourceCut = sourceCut === void 0 ? void 0 : sessionFormatCount(sourceCut, "Session inherited event count");
 		let inheritedEventCount = validatedSourceCut;
 		const stages = [];
 		const plan = this.plan(header.version);
@@ -158,11 +158,7 @@ var CompiledSessionFormatChain = class {
 				migration,
 				stage
 			});
-			if (index + 1 < plan.length) {
-				const targetCut = stage.headerInheritedEventCount;
-				if (targetCut === void 0) throw new SessionFormatError(`${migration.name} must expose its inherited cut before the next migration`);
-				inheritedEventCount = targetCut;
-			}
+			inheritedEventCount = stage.headerInheritedEventCount;
 		}
 		return new CompiledSessionFormatMigrationStream(header, validatedSourceCut, stages, output);
 	}
@@ -249,7 +245,7 @@ var CompiledSessionFormatMigrationStream = class {
 	finish() {
 		let inheritedEventCount = this.sourceInheritedEventCount;
 		for (const stage of this.stages) inheritedEventCount = stage.finish();
-		return inheritedEventCount;
+		return sessionFormatCount(inheritedEventCount, "finished Session inherited event count");
 	}
 };
 function throwUnsupportedRefusal(migration, error, subject = "Session") {
@@ -358,7 +354,7 @@ function createSessionFormatCatalog(options) {
 		const sourceCut = decoder.headerInheritedEventCount;
 		if (storedVersion === chain.currentVersion) return new CurrentSessionFormatRestore(decoder, sourceCut, restoreOptions.validation === "current" ? options.restoreCurrent : identityArtifact, chain.currentVersion);
 		const collector = new SessionFormatEventCollector();
-		return new MigratingSessionFormatRestore(decoder, sourceCut, chain.createStream(decoder.header, requiredHistoricalCut(storedVersion, sourceCut), collector), collector, restoreOptions.validation === "current" ? options.restoreCurrent : options.restoreTransformedCurrent, restoreOptions.validation, storedVersion, chain.currentVersion);
+		return new MigratingSessionFormatRestore(decoder, sourceCut, chain.createStream(decoder.header, sourceCut, collector), collector, restoreOptions.validation === "current" ? options.restoreCurrent : options.restoreTransformedCurrent, restoreOptions.validation, storedVersion, chain.currentVersion);
 	}
 	return Object.freeze({
 		currentVersion: chain.currentVersion,
@@ -454,10 +450,6 @@ function restoreCurrentVersion(artifact, currentVersion) {
 function identityArtifact(artifact) {
 	return artifact;
 }
-function requiredHistoricalCut(version, cut) {
-	if (cut === void 0) throw new SessionFormatError(`format v${version} decoder must expose its inherited cut before migration`);
-	return cut;
-}
 function malformed(targetVersion, error, storedVersion) {
 	return Object.freeze({
 		status: "malformed",

package/lib/types/types.d.ts

@@ -50,8 +50,8 @@ export interface SessionFormatMigrationStageInput {
     readonly sourceHeader: SessionFormatHeader;
     /** Validated target metadata produced by this edge's header migration. */
     readonly targetHeader: SessionFormatHeader;
-    /** Exact inherited prefix length in source coordinates. */
-    readonly sourceInheritedEventCount: number;
+    /** Inherited prefix length in source coordinates, or undefined until body decoding completes. */
+    readonly sourceInheritedEventCount: number | undefined;
     /** Whether this edge consumes physical decode output or a prior migration's validated output. */
     readonly sourceKind: 'decoded' | 'transformed';
 }
@@ -66,7 +66,7 @@ export interface SessionFormatChainOptions {
 export interface SessionFormatChain {
     readonly currentVersion: number;
     /** Compile the complete migration stage chain for one decoded source artifact. */
-    createStream(header: SessionFormatHeader, inheritedEventCount: number, context: SessionFormatMigrationContext): SessionFormatMigrationStream;
+    createStream(header: SessionFormatHeader, inheritedEventCount: number | undefined, context: SessionFormatMigrationContext): SessionFormatMigrationStream;
     /** Convert only a supported header to the current logical representation. */
     migrateHeader(header: SessionFormatHeader): SessionFormatHeader;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-format",
   "description": "Streaming adjacent Session format migration machinery",
-  "version": "0.1.3-alpha.2",
+  "version": "0.1.5-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -27,7 +27,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-util-values": "^0.1.3-alpha.2"
+    "@deepseek-ai/dsh-util-values": "^0.1.5-alpha.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2"