Releasing 1.0.8

.github/ISSUE_TEMPLATE/issue-report.md

@@ -8,7 +8,7 @@ assignees: ''
 ---
 
 Thank you for taking the time to report this issue!
-Before filling in this form, please read [How to report an issue](https://github.com/vrtmrz/obsidian-livesync/blob/main/docs/to_issue_reporting.md).
+Before filling in this form, please read: [How to report an issue](../docs/to_issue_reporting.md).
 
 Issues with sufficient information will be prioritised.
 
@@ -49,14 +49,13 @@ To get it: open the command palette → "Show debug info".
 </details>
 
 ### LiveSync version
-The full LiveSync report below includes version information. If you cannot provide the report, please fill in the version here.
+The hatch report (below) includes version information. If you cannot provide the report, please fill in the version here.
 
-- Self-hosted LiveSync version: <!-- Find it in Obsidian Settings → Community plugins. -->
+- Self-hosted LiveSync version: <!-- e.g. 0.23.0 — find it in Obsidian Settings → Community Plugins -->
 
 ### Report and Logs from LiveSync
-Run `Generate full report for opening the issue with debug info` and provide the generated report. It contains detailed information and up to 1,000 recent log lines. Review the complete output, and remove credentials, private remote details, Vault names, file paths, file contents, and other private information before sharing it.
-
-If the report is too large to paste here, upload the redacted report to [Gist](https://gist.github.com/) and share the link.
+Perform a `Generate full report for opening the issue with debug info` command and provide the generated report. This contains detailed information and recent 1000 log lines, which is very helpful for debugging. **PLEASE AMEND THE REPORT TO REMOVE ANY SENSITIVE INFORMATION BEFORE PASTING.**
+If too large to paste here, upload to [Gist](https://gist.github.com/) and share the link.
 
 <details>
 <summary>Report and Logs (primary)</summary>

aggregator.html

@@ -33,8 +33,7 @@
             const id = params.get('id');
             const total = parseInt(params.get('n') || '0');
             const index = parseInt(params.get('i') || '-1');
-            // Keep the chunk percent-encoded so URI delimiters remain part of the settings payload.
-            const data = hash.match(/(?:^|&)d=([^&]*)/)?.[1];
+            const data = params.get('d');
 
             const app = document.getElementById('app');
 

docs/adr/2026_08_fast_fetch_persistence_and_completion.md

@@ -42,20 +42,10 @@ probe. CouchDB's API documentation says that `limit=0` has the same effect as
 no result rows and leave the complete count in `pending`. Fast Fetch therefore
 uses an explicit one-row normal probe and includes no document bodies.
 
-Finite continuous-feed completion differs across supported CouchDB releases.
-CouchDB 3.5.0 was observed to close a heartbeat-enabled feed with a
-`{ "last_seq": ... }` line when its finite `limit` is met. CouchDB 3.2 instead
-continues to wait for database updates after the limit has been consumed. With
-a heartbeat configured, each wait emits another heartbeat and the page can
-remain open indefinitely, even after every requested row has arrived.
-
-On CouchDB 3.2, an explicit `timeout` without a heartbeat has different
-semantics from a total request deadline. Shard-result waits may emit blank
-keep-alive lines and continue processing. Once the currently available changes
-have been exhausted and the feed is waiting for another database update, the
-timeout stops that wait and returns the feed-level `last_seq`. The timeout can
-therefore terminate a finite page without limiting the duration of an active
-page transfer.
+A continuous feed with a heartbeat remains open at the current tail. It closes
+with a `{ "last_seq": ... }` line only after its finite `limit` has been met.
+Consequently, a limit larger than the workload already known to be available
+can leave initialisation waiting for future writes.
 
 The CouchDB sequence token is opaque and must be handled using CouchDB's
 sequence semantics, without parsing, ordering, or comparison. On clustered
@@ -83,16 +73,8 @@ request starts again from that same cursor.
 The number currently available is `results.length + pending`. If it is zero,
 Fast Fetch is caught up and completes without opening another stream. Otherwise,
 the next continuous request uses the smaller of that count and 10,000 as its
-finite `limit`.
-
-Each finite page omits `heartbeat` and sets `timeout=1000`. This lets CouchDB
-3.2 return the page's terminator one second after it exhausts the currently
-available changes, rather than keeping the request open for future writes. The
-client immediately reconnects from that terminator while another normal probe
-reports available work. This bounded cycle also preserves the intent of the
-earlier iOS and iPadOS heartbeat workaround: Fast Fetch no longer depends on a
-silent continuous request eventually closing at CouchDB's default 60-second
-timeout.
+finite `limit`. This prevents a heartbeat-enabled request from waiting for
+future changes merely to fill an oversized page.
 
 The probe and page are separate HTTP requests, not a transactional snapshot.
 New writes, replica selection, or administrative changes may alter the rows
@@ -270,8 +252,6 @@ writer. Verify that:
   `pending` is zero;
 - every probe uses `limit=1`, excludes document bodies, and is repeated from the
   previous page's opaque terminator;
-- each bounded page omits `heartbeat`, uses `timeout=1000`, and can complete
-  under CouchDB 3.2 after its current rows have been delivered;
 - deletion and document-less rows consume a page slot;
 - a row count cannot complete a page without its `last_seq` terminator;
 - a page terminator cannot advance the checkpoint before its batch is durable;
@@ -306,14 +286,11 @@ existing setup sequence and cleanup.
 
 Commonlib's CouchDB integration test remains responsible for the real HTTP
 changes feed, opaque sequence tokens, deletion rows, and local batch
-persistence. It should use the maintained CI CouchDB release, a two-shard
-database, and a data set large enough to cross a local batch boundary, and
-confirm that the final checkpoint can be passed back to CouchDB as `since` with
-no result rows or pending changes. The test must not compare that token's
-representation with a separately requested target or changes-row token. The
-focused regression test covers CouchDB 3.2's page-tail behaviour; compatibility
-with a real CouchDB 3.2 server can be confirmed manually without expanding the
-permanent CI matrix.
+persistence. It should use a two-shard database, include a data set large enough
+to cross a local batch boundary, and confirm that the final checkpoint can be
+passed back to CouchDB as `since` with no result rows or pending changes. The
+test must not compare that token's representation with a separately requested
+target or changes-row token.
 
 LiveSync's real Obsidian Setup URI workflow remains responsible for the actual
 Fast Fetch selection, E2EE passphrase, Vault reflection, ordinary file round
@@ -333,9 +310,6 @@ This follows [Real Obsidian E2E](2026_06_real_obsidian_e2e.md).
   or local persistence failures which cannot repair themselves.
 - Progress totals remain approximate and may grow when a later probe observes
   new work, without affecting correctness.
-- A completed page can spend up to one second waiting for its terminator before
-  Fast Fetch probes and reconnects. Active page transfer is not constrained to
-  one second.
 - The implementation requires coordinated changes in Commonlib and LiveSync.
   Commonlib remains the authoritative package for streaming and rebuilder
   behaviour; LiveSync consumes an immutable Commonlib release and owns its setup

docs/adr/2026_08_fast_fetch_transport_eligibility.md

@@ -1,78 +0,0 @@
-# Architectural Decision Record: Fast Fetch Transport Eligibility
-
-## Status
-
-Accepted
-
-## Context
-
-Fast Fetch accelerates Fast Setup (Simple Fetch) by reading bounded pages from
-CouchDB's continuous changes feed. It consumes each response incrementally,
-persists documents while the page is still arriving, and cancels the underlying
-request when the page completes or fails.
-
-The CouchDB setting `useRequestAPI`, labelled 'Use Internal API', routes ordinary
-replication through Obsidian's `requestUrl` API to avoid browser CORS
-restrictions. This API exposes a completed response as text, JSON, or an
-`ArrayBuffer`; it does not expose the network response progressively or accept
-the Fetch API's `AbortSignal`. Wrapping its result in a `Response` does not
-restore those transport properties.
-
-Custom headers can cause a browser preflight, and an authenticating proxy may
-reject that preflight before the requested header values are sent. Custom
-headers do not, however, make Fast Fetch intrinsically incompatible. A server
-with correctly configured CORS can accept the same headers through the ordinary
-Fetch API and retain streaming behaviour.
-
-Ordinary PouchDB replication has a different response contract. Standard Fetch
-uses finite batches, while LiveSync uses long-poll responses whose change
-payload is bounded by the replication batch size. Both can process each response
-after it has completed and do not depend on progressively reading a
-document-bearing continuous feed.
-
-## Decision
-
-Fast Fetch requires a Fetch-compatible transport which exposes the response
-body progressively and honours request cancellation.
-
-When `useRequestAPI` is enabled for a CouchDB remote, Fast Fetch falls back to
-Standard Fetch before entering the Fast Fetch activity or resetting the local
-database through the Fast Fetch path. The presence of custom headers alone does
-not disable Fast Fetch. Once Standard Fetch resets the local database, it
-invalidates any retained Fast Fetch checkpoint for that database.
-
-Commonlib's Rebuilder owns this eligibility decision because it owns both Fast
-Fetch and the existing Standard Fetch fallback. The streaming implementation
-does not receive Obsidian's buffered request adapter, and LiveSync does not add
-proxy-specific or Cloudflare-specific policy.
-
-## Consequences
-
-- Initial retrieval through Standard Fetch may be slower and issue more HTTP
-  requests because PouchDB uses the configured batch size, document retrieval,
-  and checkpoint operations. The decision does not assume that `requestUrl` is
-  faster; its benefit here is compatibility with connections which browser CORS
-  would otherwise reject.
-- LiveSync remains supported with `useRequestAPI`. Its HTTP adapter uses
-  long-poll responses whose change payload is bounded by the replication batch
-  size, rather than the document-bearing stream required by Fast Fetch.
-- A user whose server accepts the configured custom headers through correct
-  CORS handling can leave `useRequestAPI` disabled and continue to use Fast
-  Fetch.
-- The decision can be revisited if Obsidian provides a progressively readable,
-  cancellable internal request API, or if a separately designed buffered
-  transport establishes explicit payload bounds and equivalent cancellation
-  semantics.
-
-## Verification
-
-Commonlib unit tests verify that `useRequestAPI` selects only the existing
-Standard Fetch activity, does not invoke Streaming Fetch, and invalidates any
-retained Fast Fetch checkpoint after the local database is reset. Existing
-tests continue to verify that custom headers are passed to Fast Fetch when
-`useRequestAPI` is disabled.
-
-## References
-
-- [Fast Fetch Persistence and Completion Semantics](2026_08_fast_fetch_persistence_and_completion.md)
-- [Apache CouchDB changes-feed API](https://docs.couchdb.org/en/stable/api/database/changes.html)

docs/to_issue_reporting.md

@@ -1,65 +1,145 @@
 # How to report an issue
 
-Thank you for helping improve Self-hosted LiveSync. A concise report with the right evidence is more useful than trying several recovery operations before reporting the original symptom.
+Thank you for helping improve Self-hosted LiveSync!
 
-Use the [issue report template](https://github.com/vrtmrz/obsidian-livesync/issues/new?template=issue-report.md) for the report itself. Use [Troubleshooting](troubleshooting.md) to diagnose a symptom or choose a recovery action.
+This document explains how to collect the information needed for an issue report. Issues with sufficient information will be prioritised.
 
-## Preserve the original symptom
+---
 
-Do not reset a database, rebuild a remote, change transport, or enable P2P merely to see whether the problem disappears. These actions can change the evidence and may make the original cause harder to identify.
+## Filled example
 
-If the problem may involve data loss, corruption, or unexpected deletion, preserve a copy of every readable affected file and stop editing it on other devices before changing settings.
+Here is an example of a well-filled report for reference.
 
-Include when the problem began, whether it followed an update or restart, how often it occurs, and which device and remote type were involved.
+### Abstract
 
-## Required information
+The synchronisation hung up immediately after connecting.
 
-### Describe the behaviour
+### Expected behaviour
 
-Complete the issue template with:
+- Synchronisation ends with the message `Replication completed`
+- Everything synchronised
 
-- a one- or two-sentence summary;
-- the expected and actual behaviour;
-- repeatable steps, or the frequency and timing when reliable reproduction is not available; and
-- the role of each relevant device, such as the device where the change originated and the device where the failure appeared.
+### Actually happened
 
-### Obsidian debug information
+- Synchronisation was cancelled with the message `TypeError: Failed to fetch` (visible in the plug-in log around lines 10–12)
+- No files synchronised
 
-Open the command palette with `Ctrl`+`P` or `Command`+`P`, run `Show debug info`, and include its output for each relevant device. The device where the problem appeared is required. Information from the other participating devices is particularly useful for synchronisation problems.
+### Reproducing procedure
 
-### Full LiveSync report
+1. Configure LiveSync with the settings shown in the attached report.
+2. Click the sync button on the ribbon.
+3. Synchronisation begins.
+4. About two or three seconds later, the error `TypeError: Failed to fetch` appears.
+5. Replication stops. No files synchronised.
 
-Run `Generate full report for opening the issue with debug info` on the device where the problem appeared. For a synchronisation problem, also collect a report from another participating device when its settings or logs are relevant. The command copies the current LiveSync settings summary and up to 1,000 recent log lines. It collects verbose log lines even when `Verbose Log` is disabled, so you do not need to enable that setting before reproducing the problem.
+### Obsidian debug info (Device 1 — Windows desktop)
 
-The command automatically redacts known credential fields in the settings summary. It cannot guarantee that private text in log messages or unrecognised configuration fields is removed. Review the complete output before sharing it. Remove or replace:
+```
+SYSTEM INFO:
+	Obsidian version: v1.2.8
+	Installer version: v1.1.15
+	Operating system: Windows 10 Pro 10.0.19044
+	Login status: logged in
+	Catalyst license: supporter
+	Insider build toggle: off
+	Community theme: Minimal v6.1.11
+	Snippets enabled: 3
+	Restricted mode: off
+	Plugins installed: 35
+	Plugins enabled: 11
+		1: Self-hosted LiveSync v0.19.4
+		...
+```
 
-- usernames, passwords, passphrases, tokens, keys, and custom headers;
-- private server URLs, network addresses, database names, bucket names, room identifiers, and relay details;
-- Vault names, device names, and file paths; and
-- file contents or other private text which appears in a log message.
+### Report from LiveSync
 
-Document and chunk identifiers can also be private metadata, but they may be necessary for diagnosing file reconstruction and chunk availability. Decide deliberately whether to share them. If you remove them, state that the report was redacted and that this may limit the diagnosis.
+```
+----remote config----
+cors:
+  credentials: "true"
+  ...
+---- Plug-in config ---
+couchDB_URI: self-hosted
+couchDB_USER: 𝑅𝐸𝐷𝐴𝐶𝑇𝐸𝐷
+...
+```
 
-For a large report, you may share a GitHub Gist after reviewing and redacting it. Deleting a Gist later cannot undo information which has already been disclosed.
+### Plug-in log
 
-## Additional evidence when relevant
+```
+2023/5/24 10:50:33->HTTP:GET to:/ -> failed
+2023/5/24 10:50:33->TypeError:Failed to fetch
+2023/5/24 10:50:33->could not connect to https://example.com/ : your vault
+(TypeError:Failed to fetch)
+```
 
-### A problem involving one file
+---
 
-Run `Copy database information for the active file`, or use **Hatch** → **Copy database information for a file** to select another file.
+## How to collect each piece of information
 
-This report describes only the local database on that device. It includes the Vault-relative path, document and chunk identifiers, local revisions, conflicts, and local chunk availability. It does not query the remote or include file contents. Review paths and identifiers as private metadata before sharing them.
+### Obsidian debug info
 
-### A problem which crosses a restart
+Open the command palette (`Ctrl/Cmd + P`) and run **"Show debug info"**. Copy the output and paste it into the issue.
 
-Use `Write logs into the file` under **Hatch** only when the in-memory report cannot cover the restart. Persistent logging affects performance and can record private information. Disable it after reproducing the problem, review the log before sharing it, and remove the log file when it is no longer needed.
+If multiple devices are involved in the problem (e.g., sync between a phone and a desktop), please provide the debug info for each device. The device where the issue occurred is required; information from other devices is strongly recommended.
 
-### A connection, authentication, or CORS problem
+### Report from LiveSync (hatch report)
 
-Include network evidence only when the ordinary LiveSync log cannot show the rejected response. Follow [Inspect a network failure](troubleshooting.md#inspect-a-network-failure), and remove request paths, remote addresses, authority and authorisation values, cookies, credentials, payload identifiers, and response secrets before sharing screenshots or copied data.
+1. Open LiveSync settings.
+2. Go to the **Hatch** pane.
+3. Press the **Make report** button.
 
-## Sharing the report
+The report will be copied to your clipboard. It contains your LiveSync configuration and the remote server configuration, with credentials automatically redacted.
 
-Paste reports into the matching collapsible sections in the issue template, or provide a link to an already-redacted Gist. A separate plug-in log is normally unnecessary because the full LiveSync report already contains the recent verbose log history.
+**Tip:** For large reports, consider uploading to [GitHub Gist](https://gist.github.com/) and sharing the link instead of pasting directly into the issue. This makes it easier to manage, and if you accidentally leave sensitive data in, a Gist can be deleted.
 
-If a maintainer asks for a more specialised diagnostic, collect only that additional evidence and review it again before publishing it.
+If you paste directly, wrap it in a `<details>` tag to keep the issue readable:
+
+```
+<details>
+<summary>Report from hatch</summary>
+
+```
+----remote config----
+  :
+```
+</details>
+```
+
+### Plug-in log
+
+The plug-in log is volatile by default (not saved to disk) and shown only in the log dialogue, which can be opened by tapping the **document box icon** in the ribbon.
+
+#### Enable verbose log
+
+Before reproducing the issue, enable **Verbose Log** in LiveSync's **General Settings** pane. Without this, many diagnostic messages will be suppressed.
+
+#### Persist the log to a file (optional)
+
+If you need to capture a log across a restart, enable **"Write logs into the file"** in General Settings. Note that log files may contain sensitive information — use this option only for troubleshooting, and disable it afterwards.
+
+As with the hatch report, consider uploading large logs to [GitHub Gist](https://gist.github.com/).
+
+### Network log (for connection-related issues only)
+
+If the issue is related to network connectivity (e.g., cannot connect to the server, authentication errors), a network log captured from browser DevTools can be very helpful. You do not need to include this for non-connection issues.
+
+#### Opening DevTools
+
+| Platform | Shortcut |
+|----------|----------|
+| Windows / Linux | `Ctrl + Shift + I` |
+| macOS | `Cmd + Shift + I` |
+| Android | Use [Chrome remote debugging](https://developer.chrome.com/docs/devtools/remote-debugging/) |
+| iOS | Use [Safari Web Inspector](https://developer.apple.com/documentation/safari-developer-tools/inspecting-ios) on a Mac |
+
+#### What to capture
+
+1. Open the **Network** pane in DevTools.
+2. Reproduce the issue.
+3. Look for requests marked in red.
+4. Capture screenshots of the **Headers**, **Payload**, and **Response** tabs for those requests.
+
+**Important — redact before sharing:**
+- Headers: conceal the request URL path, Remote Address, `authority`, and `authorisation` values.
+- Payload / Response: the `_id` field contains your file paths — redact if needed.

docs/troubleshooting.md

@@ -117,8 +117,6 @@ Enable Obsidian's `Detect all file extensions`, then check LiveSync selectors, i
 
 ## Collect a report
 
-Follow [How to report an issue](to_issue_reporting.md) for the complete reporting checklist, including Obsidian debug information and the privacy review required before sharing evidence.
-
 Run `Generate full report for opening the issue with debug info` to copy the current settings summary and recent verbose log lines. Remove credentials, remote URLs, Vault names, file contents, and other private information before sharing it.
 
 When a problem concerns one file, run **Copy database information for the active file**, or use **Hatch** → **Copy database information for a file** to select another file. The report describes this device's local database view, including the Vault-relative path, document and chunk identifiers, local database revisions, conflicts, and local chunk availability. It does not query the remote server or include file contents. Treat paths and identifiers as private metadata before sharing.

manifest.json

@@ -1,7 +1,7 @@
 {
     "id": "obsidian-livesync",
     "name": "Self-hosted LiveSync",
-    "version": "1.0.11",
+    "version": "1.0.8",
     "minAppVersion": "1.7.2",
     "description": "Community implementation of self-hosted livesync. Reflect your vault changes to some other devices immediately. Please make sure to disable other synchronize solutions to avoid content corruption or duplication.",
     "author": "vorotamoroz",

package-lock.json

@@ -1,12 +1,12 @@
 {
     "name": "obsidian-livesync",
-    "version": "1.0.11",
+    "version": "1.0.8",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "obsidian-livesync",
-            "version": "1.0.11",
+            "version": "1.0.8",
             "license": "MIT",
             "workspaces": [
                 "src/apps/cli",
@@ -23,7 +23,7 @@
                 "@smithy/types": "^4.14.3",
                 "@smithy/util-retry": "^4.4.5",
                 "@vrtmrz/browser-ui-kit": "0.1.0",
-                "@vrtmrz/livesync-commonlib": "0.1.10",
+                "@vrtmrz/livesync-commonlib": "0.1.7",
                 "@vrtmrz/obsidian-plugin-kit": "0.1.3",
                 "@vrtmrz/ui-interactions": "0.1.2",
                 "diff-match-patch": "^1.0.5",
@@ -4775,9 +4775,9 @@
             }
         },
         "node_modules/@vrtmrz/livesync-commonlib": {
-            "version": "0.1.10",
-            "resolved": "https://registry.npmjs.org/@vrtmrz/livesync-commonlib/-/livesync-commonlib-0.1.10.tgz",
-            "integrity": "sha512-1t1e8EPM2fuIbC107jJQXbSivWXcspD7kR/3AOgT29O9E5UbGFZR6vj1f84D6vOe8BiHhv8Ng9GvrCV6U+gGXg==",
+            "version": "0.1.7",
+            "resolved": "https://registry.npmjs.org/@vrtmrz/livesync-commonlib/-/livesync-commonlib-0.1.7.tgz",
+            "integrity": "sha512-xwRXuPqYmPbWlSaVrQqeVacZz4X5km3fgoUee6Odl8/C3dNx+pFndxoHvXIDo3HmbMKcz/JA09JTKvfxVqBwQQ==",
             "license": "MIT",
             "dependencies": {
                 "@aws-sdk/client-s3": "^3.808.0",
@@ -15924,7 +15924,7 @@
         },
         "src/apps/cli": {
             "name": "self-hosted-livesync-cli",
-            "version": "1.0.11-cli",
+            "version": "1.0.8-cli",
             "dependencies": {
                 "chokidar": "^4.0.0",
                 "minimatch": "^10.2.5",
@@ -15949,7 +15949,7 @@
         },
         "src/apps/webapp": {
             "name": "livesync-webapp",
-            "version": "1.0.11-webapp",
+            "version": "1.0.8-webapp",
             "dependencies": {
                 "octagonal-wheels": "^0.1.52"
             },
@@ -15961,7 +15961,7 @@
             }
         },
         "src/apps/webpeer": {
-            "version": "1.0.11-webpeer",
+            "version": "1.0.8-webpeer",
             "dependencies": {
                 "octagonal-wheels": "^0.1.52"
             },

package.json

@@ -1,6 +1,6 @@
 {
     "name": "obsidian-livesync",
-    "version": "1.0.11",
+    "version": "1.0.8",
     "description": "Reflect your vault changes to some other devices immediately. Please make sure to disable other synchronize solutions to avoid content corruption or duplication.",
     "main": "main.js",
     "type": "module",
@@ -177,7 +177,7 @@
         "@smithy/types": "^4.14.3",
         "@smithy/util-retry": "^4.4.5",
         "@vrtmrz/browser-ui-kit": "0.1.0",
-        "@vrtmrz/livesync-commonlib": "0.1.10",
+        "@vrtmrz/livesync-commonlib": "0.1.7",
         "@vrtmrz/obsidian-plugin-kit": "0.1.3",
         "@vrtmrz/ui-interactions": "0.1.2",
         "diff-match-patch": "^1.0.5",

src/apps/cli/managers/CLIStorageEventManagerAdapter.ts

@@ -121,10 +121,8 @@ class CLIWatchAdapter implements IStorageEventWatchAdapter {
         return {
             path: path.relative(this.basePath, filePath).replace(/\\/g, "/") as FilePath,
             stat: {
-                // Floor to integer milliseconds; Linux fs.Stats.*Ms carry sub-millisecond
-                // precision, and timestamps are stored as integer ms everywhere else.
-                ctime: Math.floor(stats?.ctimeMs ?? Date.now()),
-                mtime: Math.floor(stats?.mtimeMs ?? Date.now()),
+                ctime: stats?.ctimeMs ?? Date.now(),
+                mtime: stats?.mtimeMs ?? Date.now(),
                 size: stats?.size ?? 0,
                 type: "file",
             },

src/apps/cli/managers/CLIStorageEventManagerAdapter.unit.spec.ts

@@ -84,27 +84,6 @@ describe("CLIStorageEventManagerAdapter", () => {
         expect(created.stat?.size).toBe(42);
     });
 
-    it("floors sub-millisecond stat timestamps so mobile clients do not receive floats", async () => {
-        const basePath = "/vault/base";
-        const adapter = new CLIStorageEventManagerAdapter(basePath, undefined, true);
-        const handlers = makeHandlers();
-
-        await adapter.watch.beginWatch(handlers);
-
-        const addCallback = mockWatcher.on.mock.calls.find(([event]) => event === "add")![1] as (
-            filePath: string,
-            stats: any
-        ) => void;
-
-        // Linux fs.Stats carry nanosecond-derived sub-millisecond precision.
-        const floatStats = { ctimeMs: 1778511180024.462, mtimeMs: 1778511180999.913, size: 7 };
-        addCallback(`${basePath}/note.md`, floatStats);
-
-        const created = (handlers.onCreate as ReturnType<typeof vi.fn>).mock.calls[0][0] as NodeFile;
-        expect(created.stat?.ctime).toBe(1778511180024);
-        expect(created.stat?.mtime).toBe(1778511180999);
-    });
-
     it("close() calls watcher.close()", async () => {
         const adapter = new CLIStorageEventManagerAdapter("/base", undefined, true);
         const handlers = makeHandlers();

src/apps/cli/package.json

@@ -1,7 +1,7 @@
 {
     "name": "self-hosted-livesync-cli",
     "private": true,
-    "version": "1.0.11-cli",
+    "version": "1.0.8-cli",
     "main": "dist/index.cjs",
     "type": "module",
     "scripts": {

src/apps/webapp/package.json

@@ -1,7 +1,7 @@
 {
     "name": "livesync-webapp",
     "private": true,
-    "version": "1.0.11-webapp",
+    "version": "1.0.8-webapp",
     "type": "module",
     "description": "Browser-based Self-hosted LiveSync using FileSystem API",
     "scripts": {

src/apps/webpeer/package.json

@@ -1,7 +1,7 @@
 {
     "name": "webpeer",
     "private": true,
-    "version": "1.0.11-webpeer",
+    "version": "1.0.8-webpeer",
     "type": "module",
     "scripts": {
         "dev": "vite",

src/serviceModules/FileSystemAdapters/ObsidianStorageAdapter.ts

@@ -2,7 +2,6 @@ import type { UXDataWriteOptions } from "@vrtmrz/livesync-commonlib/compat/commo
 import type { IStorageAdapter } from "@vrtmrz/livesync-commonlib/compat/serviceModules/adapters";
 import { toArrayBuffer } from "@vrtmrz/livesync-commonlib/compat/serviceModules/FileAccessBase";
 import type { Stat, App } from "obsidian";
-import { toIntegerTimestamps } from "./sanitizeWriteOptions";
 
 /**
  * Storage adapter implementation for Obsidian
@@ -41,15 +40,15 @@ export class ObsidianStorageAdapter implements IStorageAdapter<Stat> {
     }
 
     async write(path: string, data: string, options?: UXDataWriteOptions): Promise<void> {
-        return await this.app.vault.adapter.write(path, data, toIntegerTimestamps(options));
+        return await this.app.vault.adapter.write(path, data, options);
     }
 
     async writeBinary(path: string, data: ArrayBuffer, options?: UXDataWriteOptions): Promise<void> {
-        return await this.app.vault.adapter.writeBinary(path, toArrayBuffer(data), toIntegerTimestamps(options));
+        return await this.app.vault.adapter.writeBinary(path, toArrayBuffer(data), options);
     }
 
     async append(path: string, data: string, options?: UXDataWriteOptions): Promise<void> {
-        return await this.app.vault.adapter.append(path, data, toIntegerTimestamps(options));
+        return await this.app.vault.adapter.append(path, data, options);
     }
 
     list(basePath: string): Promise<{ files: string[]; folders: string[] }> {

src/serviceModules/FileSystemAdapters/ObsidianStorageAdapter.unit.spec.ts

@@ -1,32 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import type { App } from "obsidian";
-import { ObsidianStorageAdapter } from "./ObsidianStorageAdapter";
-
-describe("ObsidianStorageAdapter", () => {
-    it("floors write-option timestamps before calling Obsidian storage methods", async () => {
-        const write = vi.fn().mockResolvedValue(undefined);
-        const writeBinary = vi.fn().mockResolvedValue(undefined);
-        const append = vi.fn().mockResolvedValue(undefined);
-        const app = {
-            vault: {
-                adapter: {
-                    write,
-                    writeBinary,
-                    append,
-                },
-            },
-        } as unknown as App;
-        const adapter = new ObsidianStorageAdapter(app);
-        const options = { ctime: 1778511180024.462, mtime: 1778511180999.913 };
-        const expectedOptions = { ctime: 1778511180024, mtime: 1778511180999 };
-
-        await adapter.write("note.md", "text", options);
-        await adapter.writeBinary("image.bin", new ArrayBuffer(0), options);
-        await adapter.append("log.md", "text", options);
-
-        expect(write).toHaveBeenCalledWith("note.md", "text", expectedOptions);
-        expect(writeBinary).toHaveBeenCalledWith("image.bin", expect.any(ArrayBuffer), expectedOptions);
-        expect(append).toHaveBeenCalledWith("log.md", "text", expectedOptions);
-        expect(options).toEqual({ ctime: 1778511180024.462, mtime: 1778511180999.913 });
-    });
-});

src/serviceModules/FileSystemAdapters/ObsidianVaultAdapter.ts

@@ -2,7 +2,6 @@ import type { UXDataWriteOptions } from "@vrtmrz/livesync-commonlib/compat/commo
 import type { IVaultAdapter } from "@vrtmrz/livesync-commonlib/compat/serviceModules/adapters";
 import { toArrayBuffer } from "@vrtmrz/livesync-commonlib/compat/serviceModules/FileAccessBase";
 import type { TFile, App, TFolder } from "obsidian";
-import { toIntegerTimestamps } from "./sanitizeWriteOptions";
 
 /**
  * Vault adapter implementation for Obsidian
@@ -24,19 +23,19 @@ export class ObsidianVaultAdapter implements IVaultAdapter<TFile, TFolder> {
     }
 
     async modify(file: TFile, data: string, options?: UXDataWriteOptions): Promise<void> {
-        return await this.app.vault.modify(file, data, toIntegerTimestamps(options));
+        return await this.app.vault.modify(file, data, options);
     }
 
     async modifyBinary(file: TFile, data: ArrayBuffer, options?: UXDataWriteOptions): Promise<void> {
-        return await this.app.vault.modifyBinary(file, toArrayBuffer(data), toIntegerTimestamps(options));
+        return await this.app.vault.modifyBinary(file, toArrayBuffer(data), options);
     }
 
     async create(path: string, data: string, options?: UXDataWriteOptions): Promise<TFile> {
-        return await this.app.vault.create(path, data, toIntegerTimestamps(options));
+        return await this.app.vault.create(path, data, options);
     }
 
     async createBinary(path: string, data: ArrayBuffer, options?: UXDataWriteOptions): Promise<TFile> {
-        return await this.app.vault.createBinary(path, toArrayBuffer(data), toIntegerTimestamps(options));
+        return await this.app.vault.createBinary(path, toArrayBuffer(data), options);
     }
 
     async rename(file: TFile, newPath: string): Promise<void> {

src/serviceModules/FileSystemAdapters/ObsidianVaultAdapter.unit.spec.ts

@@ -2,7 +2,7 @@ import { describe, expect, it, vi } from "vitest";
 import type { App, TFile } from "obsidian";
 import { ObsidianVaultAdapter } from "./ObsidianVaultAdapter";
 
-describe("ObsidianVaultAdapter", () => {
+describe("ObsidianVaultAdapter.read", () => {
     it("preserves a UTF-8 BOM so the content size matches the file stat", async () => {
         const path = "Transcripts/字幕.md";
         const contentWithoutBom = "字幕の検証行です。\n";
@@ -34,34 +34,4 @@ describe("ObsidianVaultAdapter", () => {
         expect(adapterRead).toHaveBeenCalledWith(path);
         expect(read).not.toHaveBeenCalled();
     });
-
-    it("floors write-option timestamps before calling Obsidian vault methods", async () => {
-        const modify = vi.fn().mockResolvedValue(undefined);
-        const modifyBinary = vi.fn().mockResolvedValue(undefined);
-        const create = vi.fn().mockResolvedValue({});
-        const createBinary = vi.fn().mockResolvedValue({});
-        const app = {
-            vault: {
-                modify,
-                modifyBinary,
-                create,
-                createBinary,
-            },
-        } as unknown as App;
-        const file = { path: "note.md" } as TFile;
-        const adapter = new ObsidianVaultAdapter(app);
-        const options = { ctime: 1778511180024.462, mtime: 1778511180999.913 };
-        const expectedOptions = { ctime: 1778511180024, mtime: 1778511180999 };
-
-        await adapter.modify(file, "text", options);
-        await adapter.modifyBinary(file, new ArrayBuffer(0), options);
-        await adapter.create("created.md", "text", options);
-        await adapter.createBinary("created.bin", new ArrayBuffer(0), options);
-
-        expect(modify).toHaveBeenCalledWith(file, "text", expectedOptions);
-        expect(modifyBinary).toHaveBeenCalledWith(file, expect.any(ArrayBuffer), expectedOptions);
-        expect(create).toHaveBeenCalledWith("created.md", "text", expectedOptions);
-        expect(createBinary).toHaveBeenCalledWith("created.bin", expect.any(ArrayBuffer), expectedOptions);
-        expect(options).toEqual({ ctime: 1778511180024.462, mtime: 1778511180999.913 });
-    });
 });

src/serviceModules/FileSystemAdapters/sanitizeWriteOptions.ts

@@ -1,25 +0,0 @@
-import type { UXDataWriteOptions } from "@vrtmrz/livesync-commonlib/compat/common/types";
-
-/**
- * Coerce the timestamp fields of a write-options object to integer milliseconds.
- *
- * On mobile, Obsidian forwards `mtime`/`ctime` to Capacitor's
- * Filesystem.setTimes, whose native binding casts the value to a Java `Long`.
- * A non-integer (float) timestamp makes that cast throw
- * `ClassCastException: Double cannot be cast to Long`, which crashes the app on
- * launch as soon as such a document is replicated in. Float timestamps can
- * enter the database from any client that stores `fs.Stats.mtimeMs` without
- * flooring. Flooring at the storage boundary guarantees every Obsidian write
- * carries an integer, so a float timestamp already present in the mesh cannot
- * brick the app.
- *
- * Returns a shallow copy so the caller's options object is not mutated; passes
- * `undefined` through unchanged.
- */
-export function toIntegerTimestamps(options?: UXDataWriteOptions): UXDataWriteOptions | undefined {
-    if (!options) return options;
-    const sanitized: UXDataWriteOptions = { ...options };
-    if (typeof sanitized.mtime === "number") sanitized.mtime = Math.floor(sanitized.mtime);
-    if (typeof sanitized.ctime === "number") sanitized.ctime = Math.floor(sanitized.ctime);
-    return sanitized;
-}

test/browser-apps/pages/browser-smoke.test.ts

@@ -30,15 +30,12 @@ Deno.test({
             const aggregator = await browser.newPage();
             const assertNoAggregatorFailures = observePageFailures(aggregator);
             const assertNoAggregatorNetworkFailures = observeNetworkFailures(aggregator);
-            await aggregator.goto(new URL("aggregator.html#id=pages-smoke&n=2&i=0&d=before%2", server.baseUrl).href);
+            await aggregator.goto(new URL("aggregator.html#id=pages-smoke&n=2&i=0&d=first-", server.baseUrl).href);
             await aggregator.getByText("1 / 2 Loaded", { exact: true }).waitFor();
-            await aggregator.goto(
-                new URL("aggregator.html#id=pages-smoke&n=2&i=1&d=3after%26amp%2Bplus%25percent", server.baseUrl)
-                    .href
-            );
+            await aggregator.goto(new URL("aggregator.html#id=pages-smoke&n=2&i=1&d=second", server.baseUrl).href);
             assertEquals(
                 await aggregator.getByRole("link", { name: "Open Obsidian to complete setup" }).getAttribute("href"),
-                "obsidian://setuplivesync?settingsQR=before%23after%26amp%2Bplus%25percent"
+                "obsidian://setuplivesync?settingsQR=first-second"
             );
             assertNoAggregatorFailures();
             assertNoAggregatorNetworkFailures();

updates.md

@@ -12,53 +12,10 @@ Earlier releases remain available in the 0.25 release history and the legacy rel
 
 ## Unreleased
 
-## 1.0.11
-
-9th August, 2026
-
-### Setup and compatibility
-
-#### Fixed
-
-- Fast Setup now uses Standard Fetch when CouchDB's 'Use Internal API' setting is enabled, avoiding a streaming request path which Obsidian's buffered API cannot support (#1020).
-    - Custom headers alone continue to use Fast Fetch when browser CORS permits them; Standard Fetch clears any obsolete Fast Fetch checkpoint after resetting the local database.
-
-### Synchronisation and storage
-
-#### Fixed
-
-- Fractional file timestamps no longer cause affected mobile clients to crash after synchronisation (#1087, PR #1039). Thank you to @andrewleech for the contribution!
-    - Timestamps are now normalised in the command-line tool and before Obsidian's native file-system writes.
-
-## 1.0.10
-
-9th August, 2026
-
-### Setup and compatibility
-
-#### Fixed
-
-- Fast Setup now sends configured CouchDB custom headers with every changes-feed request, allowing reverse proxies such as Cloudflare Access to authenticate initial setup in the same way as ordinary synchronisation ([Commonlib PR #82](https://github.com/vrtmrz/livesync-commonlib/pull/82)). Thank you to @nimula for the contribution!
-
-## 1.0.9
-
-8th August, 2026
-
-For the first time in a while, I published a release that could not be promoted to a stable release. Sorry about that! I am glad that we caught it while it was still a pre-release.
-
-### Setup and compatibility
-
-#### Fixed
-
-- Multi-part settings QR codes now preserve special characters in passwords, passphrases, and other settings (PR #1083). Thank you to @calvinbui for the improvement!
-- Fast Setup now sizes each finite CouchDB changes page from a one-row status probe, counts the returned result together with `pending`, and resumes from the page's opaque `last_seq` without comparing token representations. Each page uses a one-second idle timeout instead of a heartbeat, allowing CouchDB 3.2 to return its terminator after the currently available rows have been persisted.
-
 ## 1.0.8
 
 8th August, 2026
 
-This version was published for pre-release validation only and was not promoted to a stable release.
-
 ### Setup and compatibility
 
 #### Fixed

versions.json

@@ -20,8 +20,5 @@
     "1.0.5": "1.7.2",
     "1.0.6": "1.7.2",
     "1.0.7": "1.7.2",
-    "1.0.8": "1.7.2",
-    "1.0.9": "1.7.2",
-    "1.0.10": "1.7.2",
-    "1.0.11": "1.7.2"
+    "1.0.8": "1.7.2"
 }