@sparkelf/dsh-patch-mobile-journal-generation 0.1.0-rc.26

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# 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 patches/npm/mobile-journal-generation/README.md
+README.md: 4d0f76dae4c3e4c833574c1d36d2c7f3840919b2
+README.zh.md: 79c24c9a0b91fa7a5a327dadbc58abd08103325b

package/README.md

@@ -0,0 +1,9 @@
+# @sparkelf/dsh-patch-mobile-journal-generation
+
+English | [中文](README.zh.md)
+
+This data-only package keeps a replaced Mobile Bridge journal generation closed until its opening snapshot arrives. Buffered live entries from the new carrier cannot replace the published Session window before that snapshot establishes the generation cursor.
+
+The target is exact official source revision `fb2c4b9e698e30edb738bca4cf0618587db7d203`. The payload changes the API Gateway journal stream and its existing Client test only; responsive layout, Sidebar, Composer, and Mobile Bridge transport remain in their current owners.
+
+Retire this package when official DSH ships the replacement-generation ordering behavior.

package/README.zh.md

@@ -0,0 +1,9 @@
+# @sparkelf/dsh-patch-mobile-journal-generation
+
+[English](README.md) | 中文
+
+该data-only package让被替换的Mobile Bridge journal generation保持关闭，直到opening snapshot到达。来自新carrier的buffered live entries不能在snapshot建立generation cursor之前替换已发布Session window。
+
+target是exact official source revision `fb2c4b9e698e30edb738bca4cf0618587db7d203`。payload只修改API Gateway journal stream及其既有Client test；responsive layout、Sidebar、Composer与Mobile Bridge transport仍由当前owner持有。
+
+official DSH发布replacement-generation ordering behavior后，retire本package。

package/package.json

@@ -0,0 +1,36 @@
+{
+  "description": "Wait for a replacement mobile journal generation opening snapshot before consuming its buffered live entries",
+  "dshPatch": {
+    "formatVersion": 1,
+    "variants": [
+      {
+        "dsh": ">=0.1.5-rc.2",
+        "file": "./patches/mobile-journal-generation.patch",
+        "id": "mobile-journal-opening-generation",
+        "target": {
+          "baseRevision": "fb2c4b9e698e30edb738bca4cf0618587db7d203",
+          "kind": "dsh-source",
+          "paths": [
+            "packages/api/gateway/src/client/",
+            "packages/api/gateway/tests/"
+          ]
+        }
+      }
+    ]
+  },
+  "files": [
+    "patches/*.patch"
+  ],
+  "license": "MIT",
+  "name": "@sparkelf/dsh-patch-mobile-journal-generation",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "directory": "patches/npm/mobile-journal-generation",
+    "type": "git",
+    "url": "git+https://github.com/SparkElf/deepseek-harness-plus.git"
+  },
+  "type": "module",
+  "version": "0.1.0-rc.26"
+}

package/patches/mobile-journal-generation.patch

@@ -0,0 +1,59 @@
+diff --git a/packages/api/gateway/src/client/journal-stream.ts b/packages/api/gateway/src/client/journal-stream.ts
+index ab013abdf3..25e415747e 100644
+--- a/packages/api/gateway/src/client/journal-stream.ts
++++ b/packages/api/gateway/src/client/journal-stream.ts
+@@ -241,6 +241,10 @@ export abstract class RemoteJournalStream<
+         if (next.done) return
+         const item = next.value
+         if (item.generation !== this.generation) {
++          // A replaced mobile carrier can surface buffered live entries before
++          // its opening snapshot. The snapshot subsumes them, so retain the
++          // published window and wait for that generation's opening cursor.
++          if (item.value.type !== 'opened') continue
+           this.replaceGeneration(item, true)
+           continue
+         }
+diff --git a/packages/api/gateway/tests/journal-stream.client.spec.ts b/packages/api/gateway/tests/journal-stream.client.spec.ts
+index 498f5a033b..226340fee9 100644
+--- a/packages/api/gateway/tests/journal-stream.client.spec.ts
++++ b/packages/api/gateway/tests/journal-stream.client.spec.ts
+@@ -788,7 +788,7 @@ describe('RemoteJournalStream', () => {
+     await fixture.journal.dispose()
+   })
+ 
+-  it('reports a resumed generation that emits an entry before its cursor', async () => {
++  it('drops resumed entries before the replacement opening cursor', async () => {
+     const finish = Promise.withResolvers<undefined>()
+     const fixture = journalFixture(
+       [
+@@ -797,17 +797,26 @@ describe('RemoteJournalStream', () => {
+           waitAfterFrames: finish.promise,
+           terminal: new RemoteStreamCarrierError('lost'),
+         },
+-        { frames: [{ type: 'entry', entry: { seq: 1 } }] },
++        {
++          frames: [
++            { type: 'entry', entry: { seq: 1 } },
++            opened(1, page('replacement', [0, 1])),
++          ],
++          hold: true,
++        },
+       ],
+       [],
+     )
+ 
+     await fixture.journal.open({})
+     finish.resolve(undefined)
+-    await vi.waitFor(() => { expect(fixture.failed).toHaveBeenCalledOnce() })
+-    expect(fixture.failed.mock.calls[0]?.[0]).toMatchObject({
+-      message: 'resumed fixture journal emitted an entry before its opening cursor',
++    await vi.waitFor(() => { expect(fixture.changes).toHaveLength(2) })
++    expect(fixture.changes.at(-1)).toMatchObject({
++      type: 'replace',
++      page: { marker: 'replacement' },
++      entries: [{ seq: 0 }, { seq: 1 }],
+     })
++    expect(fixture.failed).not.toHaveBeenCalled()
+     await fixture.journal.dispose()
+   })
+