feat: Chunk ID namespace is now separated from the E2EE passphrase by introducing userHashSalt.

.github/ISSUE_TEMPLATE/issue-report.md

@@ -2,7 +2,7 @@
 name: Issue report
 about: Create a report to help us improve
 title: ''
-labels: 'uncategorised'
+labels: 'bug'
 assignees: ''
 
 ---
@@ -53,12 +53,11 @@ The hatch report (below) includes version information. If you cannot provide the
 
 - Self-hosted LiveSync version: <!-- e.g. 0.23.0 — find it in Obsidian Settings → Community Plugins -->
 
-### Report and Logs from LiveSync
-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.
+### Report from LiveSync
+Open the `Hatch` pane in LiveSync settings and press `Make report`. Paste here or upload to [Gist](https://gist.github.com/) and share the link.
 
 <details>
-<summary>Report and Logs (primary)</summary>
+<summary>Report from hatch (primary)</summary>
 
 ```
 <!-- paste here or link to Gist -->
@@ -66,7 +65,29 @@ If too large to paste here, upload to [Gist](https://gist.github.com/) and share
 </details>
 
 <details>
-<summary>Report and Logs (if applicable)</summary>
+<summary>Report from hatch (if applicable)</summary>
+
+```
+<!-- paste here or link to Gist -->
+```
+</details>
+
+
+### Plug-in log
+Enable `Verbose Log` in General Settings first, then reproduce the issue and copy the log (tap the document box icon in the ribbon).
+Paste here or upload to [Gist](https://gist.github.com/) and share the link.
+
+<details>
+<summary>Plug-in log (primary)</summary>
+
+```
+<!-- paste here or link to Gist -->
+```
+</details>
+
+
+<details>
+<summary>Plug-in log (if applicable)</summary>
 
 ```
 <!-- paste here or link to Gist -->

.github/workflows/cli-deno-tests.yml

@@ -1,95 +1,25 @@
 name: cli-deno-tests
 
 on:
-  push:
-    branches:
-      - main
-      - beta
-    paths:
-      - '.github/workflows/cli-deno-tests.yml'
-      - 'src/apps/cli/**'
-      - 'src/lib/src/API/processSetting.ts'
-      - 'package.json'
-      - 'package-lock.json'
-  pull_request:
-    paths:
-      - '.github/workflows/cli-deno-tests.yml'
-      - 'src/apps/cli/**'
-      - 'src/lib/src/API/processSetting.ts'
-      - 'package.json'
-      - 'package-lock.json'
   workflow_dispatch:
     inputs:
       test_task:
         description: 'Deno test task to run'
         type: choice
         options:
-          - test:ci
-          - test:p2p
-          - test:all
+          - test
           - test:local
           - test:e2e-matrix
-        default: test:ci
-      enable_debug:
-        description: 'Enable verbose and debug logging'
-        type: boolean
-        default: false
-      use_coturn:
-        description: 'Enable local coturn container for P2P tests'
-        type: boolean
-        default: false
+          - test:p2p-sync
+        default: test
 
 permissions:
   contents: read
 
 jobs:
-  prepare:
-    runs-on: ubuntu-latest
-    outputs:
-      task_matrix: ${{ steps.select.outputs.task_matrix }}
-    steps:
-      - name: Select task matrix
-        id: select
-        shell: bash
-        run: |
-          set -euo pipefail
-          SELECTED_TASK="${{ github.event_name == 'workflow_dispatch' && inputs.test_task || 'test:ci' }}"
-          echo "[INFO] Selected task set: $SELECTED_TASK"
-
-          case "$SELECTED_TASK" in
-            test:ci)
-              TASK_MATRIX='["test:setup-put-cat","test:mirror","test:daemon","test:push-pull","test:decoupled-vault","test:sync-two-local","test:sync-locked-remote","test:remote-commands","test:e2e-matrix:couchdb-enc0","test:e2e-matrix:couchdb-enc1","test:e2e-matrix:minio-enc0","test:e2e-matrix:minio-enc1"]'
-              ;;
-            test:p2p)
-              TASK_MATRIX='["test:p2p-host","test:p2p-peers","test:p2p-sync","test:p2p-three-nodes","test:p2p-upload-download"]'
-              ;;
-            test:all)
-              TASK_MATRIX='["test:setup-put-cat","test:mirror","test:daemon","test:push-pull","test:decoupled-vault","test:sync-two-local","test:sync-locked-remote","test:remote-commands","test:p2p-host","test:p2p-peers","test:p2p-sync","test:p2p-three-nodes","test:p2p-upload-download","test:e2e-matrix:couchdb-enc0","test:e2e-matrix:couchdb-enc1","test:e2e-matrix:minio-enc0","test:e2e-matrix:minio-enc1"]'
-              ;;
-            test:local)
-              TASK_MATRIX='["test:setup-put-cat","test:mirror","test:daemon"]'
-              ;;
-            test:e2e-matrix)
-              TASK_MATRIX='["test:e2e-matrix:couchdb-enc0","test:e2e-matrix:couchdb-enc1","test:e2e-matrix:minio-enc0","test:e2e-matrix:minio-enc1"]'
-              ;;
-            *)
-              echo "[ERROR] Unknown task set: $SELECTED_TASK" >&2
-              exit 1
-              ;;
-          esac
-
-          echo "task_matrix=$TASK_MATRIX" >> "$GITHUB_OUTPUT"
-
   test:
-    needs: prepare
     runs-on: ubuntu-latest
     timeout-minutes: 60
-    env:
-      DENO_DIR: ~/.cache/deno
-    strategy:
-      fail-fast: false
-      matrix:
-        task: ${{ fromJson(needs.prepare.outputs.task_matrix) }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -101,21 +31,12 @@ jobs:
         with:
           node-version: '24.x'
           cache: 'npm'
-          cache-dependency-path: package-lock.json
 
       - name: Setup Deno
         uses: denoland/setup-deno@v2
         with:
           deno-version: v2.x
 
-      - name: Cache Deno dependencies
-        uses: actions/cache@v4
-        with:
-          path: ~/.cache/deno
-          key: ${{ runner.os }}-deno-${{ hashFiles('src/apps/cli/testdeno/deno.lock', 'src/apps/cli/testdeno/deno.json') }}
-          restore-keys: |
-            ${{ runner.os }}-deno-
-
       - name: Install dependencies
         run: npm ci
 
@@ -142,16 +63,13 @@ jobs:
         env:
           LIVESYNC_DOCKER_MODE: native
           LIVESYNC_CLI_RETRY: 3
-          LIVESYNC_CLI_DEBUG: ${{ inputs.enable_debug == true && '1' || '0' }}
-          LIVESYNC_CLI_VERBOSE: ${{ inputs.enable_debug == true && '1' || '0' }}
-          LIVESYNC_USE_COTURN: ${{ inputs.use_coturn == true && '1' || '0' }}
         run: |
-          TASK="${{ matrix.task }}"
+          TASK="${{ github.event_name == 'workflow_dispatch' && inputs.test_task || 'test' }}"
           echo "[INFO] Running Deno task: $TASK"
           deno task "$TASK"
 
       - name: Stop leftover containers
         if: always()
         run: |
-          docker stop couchdb-test minio-test relay-test coturn-test >/dev/null 2>&1 || true
-          docker rm couchdb-test minio-test relay-test coturn-test >/dev/null 2>&1 || true
+          docker stop couchdb-test minio-test relay-test >/dev/null 2>&1 || true
+          docker rm couchdb-test minio-test relay-test >/dev/null 2>&1 || true

.github/workflows/cli-e2e.yml

@@ -12,6 +12,23 @@ on:
           - two-vaults-couchdb
           - two-vaults-minio
         default: two-vaults-matrix
+  push:
+    branches:
+      - main
+      - beta
+    paths:
+      - '.github/workflows/cli-e2e.yml'
+      - 'src/apps/cli/**'
+      - 'src/lib/src/API/processSetting.ts'
+      - 'package.json'
+      - 'package-lock.json'
+  pull_request:
+    paths:
+      - '.github/workflows/cli-e2e.yml'
+      - 'src/apps/cli/**'
+      - 'src/lib/src/API/processSetting.ts'
+      - 'package.json'
+      - 'package-lock.json'
 
 permissions:
   contents: read

.github/workflows/release.yml

@@ -9,10 +9,6 @@ on:
 jobs:
   build:
     runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      id-token: write
-      attestations: write
     steps:
     - uses: actions/checkout@v4
       with:
@@ -33,20 +29,68 @@ jobs:
       run: |
         npm ci
         npm run build --if-present
-    # Attest
-    - name: Attest Plugin Artifacts
-      uses: actions/attest-build-provenance@v4
-      with:
-          subject-path: |
-              main.js
-              manifest.json
-              styles.css
     # Package the required files into a zip
     - name: Package
       run: |
         mkdir ${{ github.event.repository.name }}
         cp main.js manifest.json styles.css README.md ${{ github.event.repository.name }}
         zip -r ${{ github.event.repository.name }}.zip ${{ github.event.repository.name }}
+    # Create the release on github
+    # - name: Create Release
+    #   id: create_release
+    #   uses: actions/create-release@v1
+    #   env:
+    #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    #     VERSION: ${{ steps.version.outputs.tag }}
+    #   with:
+    #     tag_name: ${{ steps.version.outputs.tag }}
+    #     release_name: ${{ steps.version.outputs.tag }}
+    #     draft: true
+    #     prerelease: false
+    # # Upload the packaged release file
+    # - name: Upload zip file
+    #   id: upload-zip
+    #   uses: actions/upload-release-asset@v1
+    #   env:
+    #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    #   with:
+    #     upload_url: ${{ steps.create_release.outputs.upload_url }}
+    #     asset_path: ./${{ github.event.repository.name }}.zip
+    #     asset_name: ${{ github.event.repository.name }}-${{ steps.version.outputs.tag }}.zip
+    #     asset_content_type: application/zip
+    # # Upload the main.js
+    # - name: Upload main.js
+    #   id: upload-main
+    #   uses: actions/upload-release-asset@v1
+    #   env:
+    #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    #   with:
+    #     upload_url: ${{ steps.create_release.outputs.upload_url }} 
+    #     asset_path: ./main.js
+    #     asset_name: main.js
+    #     asset_content_type: text/javascript
+    # # Upload the manifest.json
+    # - name: Upload manifest.json
+    #   id: upload-manifest
+    #   uses: actions/upload-release-asset@v1
+    #   env:
+    #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    #   with:
+    #     upload_url: ${{ steps.create_release.outputs.upload_url }} 
+    #     asset_path: ./manifest.json
+    #     asset_name: manifest.json
+    #     asset_content_type: application/json
+    # # Upload the style.css
+    # - name: Upload styles.css
+    #   id: upload-css
+    #   uses: actions/upload-release-asset@v1
+    #   env:
+    #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    #   with:
+    #     upload_url: ${{ steps.create_release.outputs.upload_url }} 
+    #     asset_path: ./styles.css
+    #     asset_name: styles.css
+    #     asset_content_type: text/css
     - name: Create Release and Upload Assets
       uses: softprops/action-gh-release@v2
       with:

.github/workflows/unit-ci.yml

@@ -10,18 +10,7 @@ on:
     paths:
       - 'src/**'
       - 'test/**'
-      - 'package.json'
-      - 'package-lock.json'
-      - 'tsconfig.json'
-      - 'vite.config.ts'
-      - 'vitest.config*.ts'
-      - 'esbuild.config.mjs'
-      - 'eslint.config.mjs'
-      - '.github/workflows/unit-ci.yml'
-  pull_request:
-    paths:
-      - 'src/**'
-      - 'test/**'
+      - 'lib/**'
       - 'package.json'
       - 'package-lock.json'
       - 'tsconfig.json'

.gitignore

@@ -28,7 +28,4 @@ data.json
 cov_profile/**
 
 coverage
-src/apps/cli/dist/*
-_testdata/**
-utils/bench/splitResults.csv
-.eslintcache
+src/apps/cli/dist/*

.prettierrc.mjs

@@ -13,7 +13,7 @@ const prettierConfig = {
     tabWidth: 4,
     printWidth: 120,
     semi: true,
-    endOfLine: "lf",
+    endOfLine: "cr",
     ...localPrettierConfig,
 };
 

AGENTS.md

@@ -1,65 +0,0 @@
-# AI Coding Assistant Instructions (AGENTS.md)
-
-When working on this repository (writing code, comments, documentation, or commits), you MUST follow these guidelines to maintain consistency.
-
-## Required Reference Files
-
-Before making changes to documentation, user-facing text, or settings:
-1. Read [docs/terms.md](file:///Users/vorotamoroz/dev/js/obsidian-livesync/docs/terms.md) for terminology, vocabulary conventions, and technical definitions.
-2. Read [docs/settings.md](file:///Users/vorotamoroz/dev/js/obsidian-livesync/docs/settings.md) (and [docs/settings_ja.md](file:///Users/vorotamoroz/dev/js/obsidian-livesync/docs/settings_ja.md)) for UI settings and setting key mappings.
-3. Read [docs/troubleshooting.md](file:///Users/vorotamoroz/dev/js/obsidian-livesync/docs/troubleshooting.md) for troubleshooting guidelines and common recovery steps (such as flag files and SCRAM state).
-4. Read [devs.md](file:///Users/vorotamoroz/dev/js/obsidian-livesync/devs.md) for development workflows, module architecture, and testing infrastructure.
-
----
-
-## Documentation and User-Facing Text Rules
-
-Always adhere to the following stylistic and spelling rules:
-
-1. **British English Spelling**:
-   - Write all documentation and user-facing messages in British English. If in doubt, the BBC News Styleguide may be useful as a reference.
-   - **Traditional Spelling (Trad-spelling)**: Use `-ise` and `-isation` suffixes instead of `-ize` and `-ization` (for example: 'initialisation', 'synchronisation', and 'organisation').
-   - **Oxford Comma**: Use the serial (Oxford) comma to separate items in lists of three or more (for example: 'settings, snippets, and themes' instead of 'settings, snippets and themes').
-   - **Logical Punctuation**: Place punctuation marks (such as commas and full stops) outside quotation marks unless they are part of the quoted text itself (for example: write 'dialogue', not 'dialogue,').
-
-2. **No Contractions**:
-   - Do not use contractions in general text or documentation (for example: write "do not" instead of "don't", "cannot" instead of "can't", and "is not" instead of "isn't").
-
-3. **Quotation Style**:
-   - Prefer single quotation marks (`'`) over double quotation marks (`"`) in general documentation text, unless the context requires double quotes (for example, inside JSON code blocks).
-
-4. **Specific Terminology and Spelling**:
-   - Use **'dialogue'** in documentation, user-facing messages, and general text. Use **'dialog'** only inside source code (e.g. class names, methods).
-   - Use the hyphenated form **'plug-in'** in user-facing text. Use **'plugin'** only in codebase files, configuration settings, or technical contexts.
-
----
-
-## Technical & Architecture Rules
-
-1. **Database Structure**:
-   - Remember that Self-hosted LiveSync splits files into **Metadata** (file properties, size, paths) and **Chunks** (actual content). Do not store raw content in the metadata document directly.
-2. **Setup and Recovery**:
-   - **Fast Setup (Simple Fetch)** is the preferred flow for initial replication on secondary devices. It utilises stream-based replication for high speed and delays local file reflection to suppress temporary synchronisation warnings.
-   - **Flag files** (such as `redflag.md`, `redflag2.md`, and `redflag3.md`) at the root of the vault control the boot-up sequence and trigger automated fetch/rebuild tasks.
-3. **Subrepositories**:
-   - The directory [src/lib](file:///Users/vorotamoroz/dev/js/obsidian-livesync/src/lib) is a subrepository (Git submodule) pointing to the shared library `livesync-commonlib`. Do not make modifications inside this directory without careful consideration, as changes affect the shared library.
-4. **Application Directories**:
-   - The directory [src/apps](file:///Users/vorotamoroz/dev/js/obsidian-livesync/src/apps) contains independent application modules:
-     - `cli`: A Command Line Interface application. Tests specifically for the CLI (both unit and End-to-End tests) are located and executed within [src/apps/cli](file:///Users/vorotamoroz/dev/js/obsidian-livesync/src/apps/cli) using its local `package.json` scripts.
-     - `webapp`: A Web-based application.
-     - `webpeer`: A Web-based peer utility.
-
----
-
-## Development & Verification Commands
-
-Before submitting code, you should run verification scripts locally to ensure correct syntax and function.
-
-1. **Lint and Type Checking**:
-   - Run `npm run check` to perform code verification. This runs type-checking (`tsc-check`), ESLint (`lint`), and Svelte checks (`svelte-check`).
-2. **Unit Tests**:
-   - Run `npm run test:unit` to execute fast local unit tests.
-   - Run `npm run test` or `npm run test:full` for full testing suites (including dockerised services).
-3. **Build**:
-   - Run `npm run build` to compile the production bundle (`main.js`).
-   - Run `npm run dev` for the development watch/build task.

README.md

@@ -4,7 +4,7 @@
 
 Self-hosted LiveSync is a community-developed synchronisation plug-in available on all Obsidian-compatible platforms. It leverages robust server solutions such as CouchDB or object storage systems (e.g., MinIO, S3, R2, etc.) to ensure reliable data synchronisation.
 
-Additionally, it supports peer-to-peer synchronisation using WebRTC, enabling you to synchronise your notes directly between devices without relying on a server. Documentation is available for [Peer-to-Peer Synchronisation](./docs/p2p_sync_updates_2026.md).
+Additionally, it supports peer-to-peer synchronisation using WebRTC now (experimental), enabling you to synchronise your notes directly between devices without relying on a server.
 
 ![obsidian_live_sync_demo](https://user-images.githubusercontent.com/45774780/137355323-f57a8b09-abf2-4501-836c-8cb7d2ff24a3.gif)
 
@@ -25,17 +25,17 @@ Additionally, it supports peer-to-peer synchronisation using WebRTC, enabling yo
   - Instead of keeping your device online as a stable peer, you can use two pseudo-peers:
     - [livesync-serverpeer](https://github.com/vrtmrz/livesync-serverpeer): A pseudo-client running on the server for receiving and sending data between devices.
     - [webpeer](https://github.com/vrtmrz/obsidian-livesync/tree/main/src/apps/webpeer): A pseudo-client for receiving and sending data between devices.
-    - A pre-built instance is available at [fancy-syncing.vrtmrz.net/webpeer](https://fancy-syncing.vrtmrz.net/webpeer/) (hosted on the vrtmrz's blog site). This is also peer-to-peer. Feel free to use it.
+    - A pre-built instance is available at [fancy-syncing.vrtmrz.net/webpeer](https://fancy-syncing.vrtmrz.net/webpeer/) (hosted on the vrtmrz blog site). This is also peer-to-peer. Feel free to use it.
   - For more information, refer to the [English explanatory article](https://fancy-syncing.vrtmrz.net/blog/0034-p2p-sync-en.html) or the [Japanese explanatory article](https://fancy-syncing.vrtmrz.net/blog/0034-p2p-sync).
 
 This plug-in may be particularly useful for researchers, engineers, and developers who need to keep their notes fully self-hosted for security reasons. It is also suitable for anyone seeking the peace of mind that comes with knowing their notes remain entirely private.
 
 >[!IMPORTANT]
 > - Before installing or upgrading this plug-in, please back up your vault.
-> - Do not enable this plug-in alongside another synchronisation solution (including iCloud and Obsidian Sync).
+> - Do not enable this plug-in alongside another synchronisation solution at the same time (including iCloud and Obsidian Sync).
 > - For backups, we also provide a plug-in called [Differential ZIP Backup](https://github.com/vrtmrz/diffzip).
 
-## How to Use
+## How to use
 
 ### 3-minute setup - CouchDB on fly.io
 
@@ -43,55 +43,54 @@ This plug-in may be particularly useful for researchers, engineers, and develope
 
 [![LiveSync Setup onto Fly.io SpeedRun 2024 using Google Colab](https://img.youtube.com/vi/7sa_I1832Xc/0.jpg)](https://www.youtube.com/watch?v=7sa_I1832Xc)
 
-1. [Set up CouchDB on fly.io](docs/setup_flyio.md)
+1. [Setup CouchDB on fly.io](docs/setup_flyio.md)
 2. Configure plug-in in [Quick Setup](docs/quick_setup.md)
 
-### Manual Setup
+### Manually Setup
 
-1. Set up the server
-   1. [Set up CouchDB on fly.io](docs/setup_flyio.md)
-   2. [Set up your CouchDB](docs/setup_own_server.md)
+1. Setup the server
+   1. [Setup CouchDB on fly.io](docs/setup_flyio.md)
+   2. [Setup your CouchDB](docs/setup_own_server.md)
 2. Configure plug-in in [Quick Setup](docs/quick_setup.md)
 > [!TIP]
-> Fly.io is no longer free. Fortunately, we can still use IBM Cloudant despite some limitations. Refer to [Set up IBM Cloudant](docs/setup_cloudant.md).
-> We can also use peer-to-peer synchronisation without a server. Alternatively, cheap object storage like Cloudflare R2 can be used for free.
-> However, most importantly, we can use a server that we trust. Therefore, please set up your own server.
-> CouchDB can also be run on a Raspberry Pi (please be mindful of your server's security).
+> Fly.io is no longer free. Fortunately, despite some issues, we can still use IBM Cloudant. Refer to [Setup IBM Cloudant](docs/setup_cloudant.md).
+> And also, we can use peer-to-peer synchronisation without a server. Or very cheap Object Storage -- Cloudflare R2 can be used for free.
+> HOWEVER, most importantly, we can use the server that we trust. Therefore, please set up your own server.
+> CouchDB can be run on a Raspberry Pi. (But please be careful about the security of your server).
 
 
-## Information in the Status Bar
+## Information in StatusBar
 
-Synchronisation status is shown in the status bar with the following icons.
+Synchronization status is shown in the status bar with the following icons.
 
 -   Activity Indicator
     -   📲 Network request
 -   Status
     -   ⏹️ Stopped
     -   💤 LiveSync enabled. Waiting for changes
-    -   ⚡️ Synchronisation in progress
+    -   ⚡️ Synchronization in progress
     -   ⚠ An error occurred
--   Statistical Indicators
+-   Statistical indicator
      -   ↑ Uploaded chunks and metadata
      -   ↓ Downloaded chunks and metadata
--   Progress Indicators
+-   Progress indicator
      -   📥 Unprocessed transferred items
      -   📄 Working database operation
      -   💾 Working write storage processes
      -   ⏳ Working read storage processes
      -   🛫 Pending read storage processes
      -   📬 Batched read storage processes
-     -   ⚙️ Working or pending storage processes for hidden files
+     -   ⚙️ Working or pending storage processes of hidden files
      -   🧩 Waiting chunks
-     -   🔌 Working customisation items (configuration, snippets, and plug-ins)
+     -   🔌 Working Customisation items (Configuration, snippets, and plug-ins)
 
-To prevent file and database corruption, please avoid closing Obsidian until all progress indicators have disappeared as much as possible (although the plug-in will attempt to resume if interrupted). This is especially important if you have deleted or renamed files.
+To prevent file and database corruption, please wait to stop Obsidian until all progress indicators have disappeared as possible (The plugin will also try to resume, though). Especially in case of if you have deleted or renamed files.
 
 ## Tips and Troubleshooting
-- If you want a faster and simpler initial replication when setting up subsequent devices, see the [Fast Setup Guide](docs/tips/fast-setup.md).
-- If you are having problems getting the plug-in working, see [Tips and Troubleshooting](docs/troubleshooting.md).
+If you are having problems getting the plugin working see: [Tips and Troubleshooting](docs/troubleshooting.md). 
 
 ## Acknowledgements
-The project has been in continual progress and harmony thanks to the following:  
+The project has been in continual progress and harmony thanks to:  
 - Many [Contributors](https://github.com/vrtmrz/obsidian-livesync/graphs/contributors).  
 - Many [GitHub Sponsors](https://github.com/sponsors/vrtmrz#sponsors).  
 - JetBrains Community Programs / Support for Open-Source Projects. <img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.png" alt="JetBrains logo" height="24">  
@@ -99,7 +98,7 @@ The project has been in continual progress and harmony thanks to the following:
 May those who have contributed be honoured and remembered for their kindness and generosity.
 
 ## Development Guide
-Please refer to the [Development Guide](devs.md) for development setup, testing infrastructure, code conventions, and more.
+Please refer to [Development Guide](devs.md) for development setup, testing infrastructure, code conventions, and more.
 
 ## License
 

README_ja.md

@@ -78,8 +78,7 @@ NDAや類似の契約や義務、倫理を守る必要のある、研究者、
 
 
 ## Tips and Troubleshooting
-- 2台目以降のセットアップ時に、初期同期をより迅速かつ簡単に行うには、[ファストセットアップガイド](docs/tips/fast-setup_ja.md)をご参照ください。
-- 何かこまったら、[Tips and Troubleshooting](docs/troubleshooting.md)をご参照ください。
+何かこまったら、[Tips and Troubleshooting](docs/troubleshooting.md)をご参照ください。
 
 ## License
 

devs.md

@@ -3,76 +3,6 @@
 
 Self-hosted LiveSync is an Obsidian plugin for synchronising vaults across devices using CouchDB, MinIO/S3, or peer-to-peer WebRTC. The codebase uses a modular architecture with TypeScript, Svelte, and PouchDB.
 
-## Build & Development Workflow
-
-### Environment Setup
-
-#### First-time Setup
-
-This repository uses submodules by convention. Therefore, you must use the `--recursive` flag when cloning it.
-```bash
-git clone --recursive https://github.com/vrtmrz/obsidian-livesync
-npm ci
-npm run build
-```
-
-Note: if you already cloned without submodules, run: `git submodule update --init --recursive`
-
-#### Branch switching
-When switching branches, please make sure to update submodules as well, since they may be updated in the new branch.
-```bash
-git checkout --recurse-submodules 0.25.70-patch1 # tag or branch name
-npm ci
-npm run build
-```
-
-### Commands
-
-```bash
-npm run test:unit    # Run unit tests with vitest (or `npm run test:unit:coverage` for coverage)
-npm run check        # TypeScript and svelte type checking
-npm run dev          # Development build with auto-rebuild (uses .env for test vault paths)
-npm run build        # Production build
-npm run buildDev     # Development build (one-time)
-npm run bakei18n     # Pre-build step: compile i18n resources (YAML → JSON → TS)
-npm run test:unit    # Run unit tests only (no Docker services required)
-npm test             # Run Harness based vitest tests (requires Docker services), not recommended, unstable.
-```
-
-### Tips
-
-We can use CLI's E2E test command instead of `npm test`.
-
-### Auto-copy to test vaults
-
-To facilitate development and testing, the build process can automatically copy the built plugin to specified test vault
-
-- Create `.env` file with `PATHS_TEST_INSTALL` pointing to test vault plug-in directories (`:` separated on Unix, `;` on Windows)
-- Development builds auto-copy to these paths on build whilst `npm run dev` is running (watch mode)
-
-### Testing Infrastructure
-
-- ~~**Deno Tests**: Unit tests for platform-independent code (e.g., `HashManager.test.ts`)~~
-    - This is now obsolete, migrated to vitest.
-- **Vitest** (`vitest.config.ts`): E2E test by Browser-based-harness using Playwright, unit tests.
-    - Unit tests should be `*.unit.spec.ts` and placed alongside the implementation file (e.g., `ChunkFetcher.unit.spec.ts`).
-
-- **Docker Services**: Tests require CouchDB, MinIO (S3), and P2P services:
-    ```bash
-    npm run test:docker-all:start  # Start all test services
-    npm run test:full              # Run tests with coverage
-    npm run test:docker-all:stop   # Stop services
-    ```
-    If some services are not needed, start only required ones (e.g., `test:docker-couchdb:start`)
-    Note that if services are already running, starting script will fail. Please stop them first.
-
-- **Test Structure**:
-    - `test/suite/` - Integration tests for sync operations
-    - `test/unit/` - Unit tests (via vitest, as harness is browser-based)
-    - `test/harness/` - Mock implementations (e.g., `obsidian-mock.ts`)
-
-
-
 ## Architecture
 
 ### Module System
@@ -87,7 +17,7 @@ The plugin uses a dynamic module system to reduce coupling and improve maintaina
     - `coreObsidian/` - Obsidian-specific core (e.g., `ModuleFileAccessObsidian`)
     - `essential/` - Required modules (e.g., `ModuleMigration`, `ModuleKeyValueDB`)
     - `features/` - Optional features (e.g., `ModuleLog`, `ModuleObsidianSettings`)
-    - `extras/` - Development/testing tools (e.g., `ModuleDev`, ~~`ModuleIntegratedTest`~~)
+    - `extras/` - Development/testing tools (e.g., `ModuleDev`, `ModuleIntegratedTest`)
 - **Services**: Core services (e.g., `database`, `replicator`, `storageAccess`) are registered in `ServiceHub` and accessed by modules. They provide an extension point for add new behaviour without modifying existing code.
     - For example, checks before the replication can be added to the `replication.onBeforeReplicate` handler, and the handlers can be return `false` to prevent replication-starting. `vault.isTargetFile` also can be used to prevent processing specific files.
 - **ServiceModule**: A new type of module that directly depends on services.
@@ -117,6 +47,45 @@ Hence, the new feature should be implemented as follows:
 - **Development code**: Use `.dev.ts` suffix (replaced with `.prod.ts` in production)
 - **Path aliases**: `@/*` maps to `src/*`, `@lib/*` maps to `src/lib/src/*`
 
+## Build & Development Workflow
+
+### Commands
+
+```bash
+npm run test:unit    # Run unit tests with vitest (or `npm run test:unit:coverage` for coverage)
+npm run check        # TypeScript and svelte type checking
+npm run dev          # Development build with auto-rebuild (uses .env for test vault paths)
+npm run build        # Production build
+npm run buildDev     # Development build (one-time)
+npm run bakei18n     # Pre-build step: compile i18n resources (YAML → JSON → TS)
+npm test             # Run vitest tests (requires Docker services)
+```
+
+### Environment Setup
+
+- Create `.env` file with `PATHS_TEST_INSTALL` pointing to test vault plug-in directories (`:` separated on Unix, `;` on Windows)
+- Development builds auto-copy to these paths on build
+
+### Testing Infrastructure
+
+- ~~**Deno Tests**: Unit tests for platform-independent code (e.g., `HashManager.test.ts`)~~
+    - This is now obsolete, migrated to vitest.
+- **Vitest** (`vitest.config.ts`): E2E test by Browser-based-harness using Playwright, unit tests.
+    - Unit tests should be `*.unit.spec.ts` and placed alongside the implementation file (e.g., `ChunkFetcher.unit.spec.ts`).
+
+- **Docker Services**: Tests require CouchDB, MinIO (S3), and P2P services:
+    ```bash
+    npm run test:docker-all:start  # Start all test services
+    npm run test:full              # Run tests with coverage
+    npm run test:docker-all:stop   # Stop services
+    ```
+    If some services are not needed, start only required ones (e.g., `test:docker-couchdb:start`)
+    Note that if services are already running, starting script will fail. Please stop them first.
+- **Test Structure**:
+    - `test/suite/` - Integration tests for sync operations
+    - `test/unit/` - Unit tests (via vitest, as harness is browser-based)
+    - `test/harness/` - Mock implementations (e.g., `obsidian-mock.ts`)
+
 ## Code Conventions
 
 ### Internationalisation (i18n)
@@ -184,17 +153,17 @@ export class ModuleExample extends AbstractObsidianModule {
 
 ## Beta Policy
 
-- Beta versions are denoted by appending `-patchedN` to the base version number.
+- Beta versions are denoted by appending `+patchedN` to the base version number.
     - `The base version` mostly corresponds to the stable release version.
-        - e.g., v0.25.41-patched1 is equivalent to v0.25.42-beta1.
+        - e.g., v0.25.41+patched1 is equivalent to v0.25.42-beta1.
     - This notation is due to SemVer incompatibility of Obsidian's plugin system.
-    - Hence, this release is `0.25.41-patched1`.
+    - Hence, this release is `0.25.41+patched1`.
 - Each beta version may include larger changes, but bug fixes will often not be included.
     - I think that in most cases, bug fixes will cause the stable releases.
     - They will not be released per branch or backported; they will simply be released.
     - Bug fixes for previous versions will be applied to the latest beta version.
-      This means, if xx.yy.02-patched1 exists and there is a defect in xx.yy.01, a fix is applied to xx.yy.02-patched1 and yields xx.yy.02-patched2.
-      If the fix is required immediately, it is released as xx.yy.02 (with xx.yy.01-patched1).
+      This means, if xx.yy.02+patched1 exists and there is a defect in xx.yy.01, a fix is applied to xx.yy.02+patched1 and yields xx.yy.02+patched2.
+      If the fix is required immediately, it is released as xx.yy.02 (with xx.yy.01+patched1).
     - This procedure remains unchanged from the current one.
 - At the very least, I am using the latest beta.
     - However, I will not be using a beta continuously for a week after it has been released. It is probably closer to an RC in nature.

docs/p2p_sync_updates_2026.md

@@ -1,59 +0,0 @@
-# User Guide: Peer-to-Peer Synchronisation (2026 Edition)
-
-Peer-to-Peer (P2P) synchronisation has evolved significantly. This guide covers the essential setup and the new features introduced in the 2026 updates.
-
-## 1. Core Concept: Server-less Freedom
-P2P synchronisation allows your devices to talk directly to each other using WebRTC. A central server is not required for data storage, ensuring maximum privacy and "freedom."
-
-## 2. Setting Up via P2P Status Pane
-You no longer need to navigate through complex menus. Simply open the **P2P Status** (via the ribbon icon or command palette) and click the **⚙ (Cog)** icon.
-
-This opens the **P2P Setup** dialogue where you can configure the essentials:
-- **Room ID:** A unique identifier for your synchronisation group.
-- **Passphrase:** Your encryption key. Ensure all your devices use the exact same passphrase. 
-- **Device Name:** A recognisable name for the current device (e.g., `iphone-16`).
-
-Once you have saved the settings, return to the **P2P Status Pane** and click the **Connect** button to join the network.
-
-*Tip: You can also toggle **Auto Connect** in the setup dialogue to automatically join the network whenever Obsidian starts.*
-
-## 3. Real-time Control
-The status pane in the right sidebar provides granular control over your synchronisation:
-
-- **Active P2P Remote (new):** P2P now has its own active remote selection, separate from the normal active remote for database replication. Use the combo box next to the cog icon to choose which P2P remote configuration is active for P2P features.
-- **Create P2P Remote (new):** Use the **+** button to open the P2P setup dialogue and create a dedicated P2P remote configuration. This is recommended when no P2P active remote has been selected yet.
-- **Selection required (new):** If no P2P active remote is selected, the pane asks for selection before P2P target-related changes are saved.
-
-- **Signalling Status:** Shows if you are connected to the relay (🟢 Online).
-- **Live-push (Broadcast):** Toggle "Broadcast changes" to notify other peers whenever you make an edit.
-- **Replicate now (🔄):** Start immediate bidirectional replication with a visible peer (Pull, then Push).
-- **Watch (🔔/🔕):** Enable "Watch" on specific peers to automatically pull changes when they broadcast. This creates a "LiveSync-like" experience.
-- **Sync target (🔗/⛓️‍💥):** Mark specific peers as **sync targets**. Peers marked here will be included when you run the **"P2P: Sync with targets"** command (see section 5). Click the button next to a peer to toggle it on (🔗, highlighted) or off (⛓️‍💥). This setting is persisted in your configuration.
-
-## 4. Replication Dialogue
-If you want to synchronise with a specific peer manually, use the **Replication** command or button. This opens the **Replication Dialogue** listing available devices.
-
-Inside the dialogue, the **Server Status** card at the top confirms you are still connected while performing the sync.
-The status card now shows a stable **Room ID suffix** above **Peer ID**. The Room ID suffix is better for identifying your P2P group, while Peer ID may change between connections.
-
-Two actions are available per peer:
-
-- **Sync** — Starts a bidirectional synchronisation (Pull then Push) and keeps the dialogue open so you can monitor progress or sync with additional peers.
-- **Start Sync & Close** — Starts the same bidirectional sync in the background and **immediately closes the dialogue**, so you can continue working without waiting.
-
-## 5. Syncing with Registered Targets via Command Palette
-
-You can now trigger a synchronisation with all your pre-registered target peers in one step, without opening any UI.
-
-1. Open the **Command Palette** (`Ctrl/Cmd + P`).
-2. Run **"P2P: Sync with targets"**.
-
-This command synchronises with every peer whose **SYNC** toggle is enabled in the **Detected Peers** list. If no targets are registered, or if the P2P server is not running, the command will notify you accordingly.
-
-*Tip: Pair this command with a hotkey for a quick, keyboard-driven sync workflow.*
-
-## 6. Technical Improvements in 2026
-- **Decoupled Architecture:** The UI is now strictly separated from the core logic, making the plug-in more stable across different platforms (Mobile, Desktop, and Web).
-- **Svelte 5 UI:** The interface has been rebuilt for better responsiveness and clearer status indicators.
-- **Security:** All data remains end-to-end encrypted. Even the signalling relay never sees your actual notes.
-

docs/quick_setup.md

@@ -2,7 +2,7 @@
 
 [Japanese docs](./quick_setup_ja.md) - [Chinese docs](./quick_setup_cn.md).
 
-The plug-in has so many configuration options to deal with different circumstances. However, only a few settings are required in the normal cases. Therefore, `The Setup wizard` has been implemented to simplify the setup.
+The plugin has so many configuration options to deal with different circumstances. However, only a few settings are required in the normal cases. Therefore, `The Setup wizard` has been implemented to simplify the setup.
 
 ![](../images/quick_setup_1.png)
 
@@ -10,7 +10,7 @@ There are three methods to set up Self-hosted LiveSync.
 
 1. [Using setup URIs](#1-using-setup-uris) *(Recommended)*
 2. [Minimal setup](#2-minimal-setup)
-3. [Fully manual setup and enabling on this dialogue](#3-manually-setup)
+3. [Full manually setup the and Enable on this dialogue](#3-manually-setup)
 
 ## At the first device
 
@@ -24,7 +24,7 @@ There are three methods to set up Self-hosted LiveSync.
 
 In this procedure, [this video](https://youtu.be/7sa_I1832Xc?t=146) may help us.
 
-1. Click the `Use` button (or launch the `Use the copied setup URI (Formerly Open setup URI)` command from the command palette).
+1. Click `Use` button (Or launch `Use the copied setup URI` from Command palette).
 2. Paste the Setup URI into the dialogue
 3. Type the passphrase of the Setup URI
 4. Answer `yes` for `Importing LiveSync's conf, OK?`.
@@ -107,27 +107,23 @@ Note: If you are going to use Object Storage, you cannot select `LiveSync`.
 
 Select any synchronisation methods we want to use and `Apply`. If database initialisation is required, it will be performed at this time. When `All done!` is displayed, we are ready to synchronise.
 
-The dialogue of `Copy current settings as a new setup URI` will open automatically. Please input a passphrase to encrypt the new `Setup URI`. (This passphrase is to encrypt the setup URI, not the vault).
+The dialogue of `Copy settings as a new setup URI` will be open automatically. Please input a passphrase to encrypt the new `Setup URI`. (This passphrase is to encrypt the setup URI, not the vault).
 
 ![](../images/quick_setup_10.png)
 
 The Setup URI will be copied to the clipboard, please make a note(Not in Obsidian) of this.
 
 >[!TIP]
-We can copy this at any time by running the "Copy settings as a new setup URI" command from the command palette (or clicking the "Copy the current settings to a Setup URI" button in the settings UI).
+We can copy this in any time by `Copy current settings as a new setup URI`.
 
 ### 3. Manually setup
 
 It is strongly recommended to perform a "minimal set-up" first and set up the other contents after making sure has been synchronised.
 
 However, if you have some specific reasons to configure it manually, please click the `Enable` button of `Enable LiveSync on this device as the set-up was completed manually`.
-And, please copy the setup URI by running the "Copy settings as a new setup URI" command (or using the "Copy the current settings to a Setup URI" button) and make a note(Not in Obsidian) of this.
+And, please copy the setup URI by `Copy current settings as a new setup URI` and make a note(Not in Obsidian) of this.
 
 ## At the subsequent device
 After installing Self-hosted LiveSync on the first device, we should have a setup URI. **The first choice is to use it**. Please share it with the device you want to setup.
 
 It is completely same as [Using setup URIs on the first device](#1-using-setup-uris). Please refer it.
-
-> [!TIP]
-> **Fast Setup (Simple Fetch)**
-> In recent versions, when you import a Setup URI or trigger a Fetch All, the plug-in boots in scheduled fetch mode and runs a simplified **Fast Setup** process. This allows you to choose your sync strategy with a single dialogue and performs initial synchronisation in one step. Refer to the [Fast Setup Guide](./tips/fast-setup.md) for more details.

docs/quick_setup_ja.md

@@ -1,6 +1,6 @@
 # Quick setup
 このプラグインには、いろいろな状況に対応するための非常に多くの設定オプションがあります。しかし、実際に使用する設定項目はそれほど多くはありません。そこで、初期設定を簡略化するために、「セットアップウィザード」を実装しています。  
-※なお、次のデバイスからは、`現在の設定をセットアップURIにコピー`と`セットアップURIで接続`を使ってセットアップしてください。
+※なお、次のデバイスからは、`Copy setup URI`と`Open setup URI`を使ってセットアップしてください。
 
 
 ## Wizardの使い方
@@ -71,8 +71,7 @@ Fixボタンがなくなり、すべてチェックマークになれば完了
 ![](../images/quick_setup_9_1.png)
 
 Presetsから、いずれかの同期方法を選び`Apply`を行うと、必要に応じてローカル・リモートのデータベースを初期化・構築します。  
-「All done!」（日本語環境では「完了！」）と表示されれば完了です。自動的に、「現在の設定をセットアップURIにコピー」のダイアログが開き、Setup URIを暗号化するためのパスフレーズを求められます（このパスフレーズはSetup URIを暗号化するためのもので、Vault自体の暗号化キーではありません）。  
-パスフレーズを入力すると、クリップボードにSetup URIが保存されますので、これを2台目以降のデバイスに何らかの方法で転送してください。
+All done! と表示されれば完了です。自動的に、`Copy setup URI`が開き、`Setup URI`を暗号化するパスフレーズを聞かれます。
 
 ![](../images/quick_setup_10.png)
 
@@ -80,14 +79,10 @@ Presetsから、いずれかの同期方法を選び`Apply`を行うと、必要
 クリップボードにSetup URIが保存されますので、これを2台目以降のデバイスに何らかの方法で転送してください。
 
 # 2台目以降の設定方法
-2台目の端末にSelf-hosted LiveSyncをインストールしたあと、コマンドパレットから`Use the copied setup URI (Formerly Open setup URI)`を選択し、転送したsetup URIを入力します。その後、パスフレーズを入力するとセットアップ用のウィザードが開きます。  
+2台目の端末にSelf-hosted LiveSyncをインストールしたあと、コマンドパレットから`Open setup URI`を選択し、転送したsetup URIを入力します。その後、パスフレーズを入力するとセットアップ用のウィザードが開きます。  
 下記のように答えてください。
 
 - `Importing LiveSync's conf, OK?` に `Yes`
 - `How would you like to set it up?` に `Set it up as secondary or subsequent device`
 
-これで設定が反映され、レプリケーションが開始されます。
-
-> [!TIP]
-> **ファストセットアップ (Fast Setup)**
-> 近年のバージョンでは、セットアップURIの読み込みやデータの全取得（Fetch All）を実行した際、より簡単に同期戦略を選択して即座に初期同期を完了できる **ファストセットアップ (Simple Fetch)** フローが利用できます。詳細は [ファストセットアップガイド](./tips/fast-setup_ja.md) をご参照ください。
+これで設定が反映され、レプリケーションが開始されます。

docs/settings.md

@@ -12,7 +12,7 @@ There are many settings in Self-hosted LiveSync. This document describes each se
 |  🛰️  | [3. Remote Configuration](#3-remote-configuration)                 |
 |  🔄  | [4. Sync Settings](#4-sync-settings)                               |
 |  🚦  | [5. Selector (Advanced)](#5-selector-advanced)                     |
-|  🔌  | [6. Customisation sync (Advanced)](#6-customisation-sync-advanced) |
+|  🔌  | [6. Customization sync (Advanced)](#6-customization-sync-advanced) |
 |  🧰  | [7. Hatch](#7-hatch)                                               |
 |  🔧  | [8. Advanced (Advanced)](#8-advanced-advanced)                     |
 |  💪  | [9. Power users (Power User)](#9-power-users-power-user)           |
@@ -68,7 +68,7 @@ Following panes will be shown when you enable this setting.
 | Icon | Description |
 | :--: | ------------------------------------------------------------------ |
 | 🚦 | [5. Selector (Advanced)](#5-selector-advanced) |
-| 🔌 | [6. Customisation sync (Advanced)](#6-customisation-sync-advanced) |
+| 🔌 | [6. Customization sync (Advanced)](#6-customization-sync-advanced) |
 | 🔧 | [8. Advanced (Advanced)](#8-advanced-advanced) |
 
 #### Enable poweruser features
@@ -120,18 +120,6 @@ Setting key: showStatusOnStatusbar
 
 We can show the status of synchronisation on the status bar. (Default: On)
 
-#### Show status icon instead of file warnings banner
-
-Setting key: hideFileWarningNotice
-
-If enabled, the ⛔ icon will be shown inside the status instead of the file warnings banner. No details will be shown.
-
-#### Network warning style
-
-Setting key: networkWarningStyle
-
-How to display network errors when the sync server is unreachable.
-
 ### 2. Logging
 
 #### Show only notifications
@@ -150,19 +138,11 @@ Show verbose log. Please enable when you report the logs
 
 ### 1. Remote Server
 
-Self-hosted LiveSync supports multiple remote connection profiles under **Remote Server** -> **Remote Databases**. This allows you to save and switch between multiple databases or bucket configurations in a single vault.
-
-- **➕ Add new connection**: Create a new connection profile by launching the setup dialogue.
-- **📥 Import connection**: Paste a connection string (e.g., `sls+https://...`, `sls+s3://...`, `sls+p2p://...`) to import a remote configuration profile.
-- **🔧 Configure**: Open the setup dialogue to edit settings for the selected connection profile.
-- **✅ Activate**: Select and activate this profile as the current active remote.
-- **🗑️ Delete**: Remove this connection profile from the list.
-
 #### Remote Type
 
 Setting key: remoteType
 
-The active remote server type. This is automatically projected to the legacy configuration when you activate a connection profile.
+Remote server type
 
 ### 2. Notification
 
@@ -192,14 +172,6 @@ Setting key: usePathObfuscation
 
 In default, the path of the file is not obfuscated to improve the performance. If you enable this, the path of the file will be obfuscated. This is useful when you want to hide the path of the file.
 
-#### Encryption Algorithm
-
-Setting key: E2EEAlgorithm
-
-The encryption algorithm version used for end-to-end encryption.
-- `v2` (V2: AES-256-GCM With HKDF): Recommended and default version.
-- `forceV1` or `""` (V1: Legacy): Older legacy encryption. Only use this if you have an existing vault encrypted in the legacy format.
-
 #### Use dynamic iteration count (Experimental)
 
 Setting key: useDynamicIterationCount
@@ -220,62 +192,30 @@ Fetch necessary settings from already configured remote server.
 
 ### 5. Minio,S3,R2
 
-These settings are configured within the S3/MinIO/R2 Setup dialogue when adding (`➕`) or editing (`🔧`) an Object Storage connection profile.
-
 #### Endpoint URL
 
 Setting key: endpoint
 
-The URL of the remote storage endpoint.
-Note: Only Secure (HTTPS) connections can be used on Obsidian Mobile.
-
 #### Access Key
 
 Setting key: accessKey
 
-The Access Key ID used for authentication.
-
 #### Secret Key
 
 Setting key: secretKey
 
-The Secret Access Key used for authentication.
-
 #### Region
 
 Setting key: region
 
-The storage region (e.g., `us-east-1`, or `auto` for Cloudflare R2).
-
 #### Bucket Name
 
 Setting key: bucket
 
-The name of the bucket to store synchronised files.
-
 #### Use Custom HTTP Handler
 
 Setting key: useCustomRequestHandler
-
-This option is labeled **Use internal API** in the setup dialogue. Enable this if your Object Storage does not support CORS. It uses Obsidian's internal API to communicate with the S3 server, which is not compliant with web standards but can bypass CORS restrictions. Note that this might break in future Obsidian versions.
-
-#### File prefix on the bucket
-
-Setting key: bucketPrefix
-
-This option is labeled **Folder Prefix** in the setup dialogue. Effectively a directory. Should end with `/`. e.g., `vault-name/`. Leave blank to store data at the root of the bucket.
-
-#### Enable forcePathStyle
-
-Setting key: forcePathStyle
-
-This option is labeled **Use Path-Style Access** in the setup dialogue. If enabled, the forcePathStyle option will be used for bucket operations.
-
-#### Custom Headers
-
-Setting key: bucketCustomHeaders
-
-Custom HTTP headers to include in every request sent to the Object Storage bucket. Specify them in the format `Header-Name: Value`, with each header on a new line.
+Enable this if your Object Storage doesn't support CORS
 
 #### Test Connection
 
@@ -283,82 +223,24 @@ Custom HTTP headers to include in every request sent to the Object Storage bucke
 
 ### 6. CouchDB
 
-These settings are configured within the CouchDB Setup dialogue when adding (`➕`) or editing (`🔧`) a CouchDB connection profile.
-
 #### Server URI
 
 Setting key: couchDB_URI
 
-The URI of the CouchDB server.
-Note: Only Secure (HTTPS) connections can be used on Obsidian Mobile. The URI must not end with a trailing slash.
-
 #### Username
 
 Setting key: couchDB_USER
-
-The username used to authenticate with CouchDB.
+username
 
 #### Password
 
 Setting key: couchDB_PASSWORD
-
-The password used to authenticate with CouchDB.
+password
 
 #### Database Name
 
 Setting key: couchDB_DBNAME
 
-The name of the database.
-Note: The database name cannot contain capital letters, spaces, or special characters other than `_$()+/-`, and cannot start with an underscore (`_`).
-
-#### Use Request API to avoid inevitable CORS problem
-
-Setting key: useRequestAPI
-
-This option is labeled **Use Internal API** in the setup dialogue. If enabled, Obsidian's internal request API will be used to bypass CORS restrictions. This is a workaround that may not be compliant with web standards and is less secure. Note that this might break in future Obsidian versions.
-
-#### Custom Headers
-
-Setting key: couchDB_CustomHeaders
-
-Custom HTTP headers to include in every request sent to the CouchDB server. Specify them in the format `Header-Name: Value`, with each header on a new line.
-
-#### Use JWT Authentication
-
-Setting key: useJWT
-
-Enable JSON Web Token (JWT) authentication for CouchDB. This is an experimental feature and has not been thoroughly verified.
-
-#### JWT Algorithm
-
-Setting key: jwtAlgorithm
-
-The algorithm used to sign the JWT. Supported algorithms: `HS256`, `HS512`, `ES256`, `ES512`.
-
-#### JWT Expiration Duration (minutes)
-
-Setting key: jwtExpDuration
-
-Token expiration duration in minutes. Set to 0 to disable expiration.
-
-#### JWT Key
-
-Setting key: jwtKey
-
-The secret key (for HS256/HS512) or the PKCS#8 PEM-formatted private key (for ES256/ES512) used to sign the JWT.
-
-#### JWT Key ID (kid)
-
-Setting key: jwtKid
-
-The Key ID (`kid`) header parameter included in the JWT.
-
-#### JWT Subject (sub)
-
-Setting key: jwtSub
-
-The subject (`sub`) claim of the JWT, which should match your CouchDB username.
-
 #### Test Database Connection
 
 Open database connection. If the remote database is not found and you have permission to create a database, the database will be created.
@@ -369,100 +251,26 @@ Checks and fixes any potential issues with the database config.
 
 #### Apply Settings
 
-### 7. Peer-to-Peer (P2P) Synchronisation
-
-#### Enable P2P Synchronisation
-
-Setting key: P2P_Enabled
-
-Enable direct peer-to-peer synchronisation via WebRTC.
-
-#### Relay URL
-
-Setting key: P2P_relays
-
-The WebSocket relay server URL(s) used for coordinating P2P connections via WebRTC. Multiple URLs can be separated by commas.
-
-#### Group ID
-
-Setting key: P2P_roomID
-
-The room ID or Group ID used to identify your group of synchronising devices. All devices you wish to synchronise must use the same Group ID. You can enter any custom string or generate a random Group ID.
-
-#### Passphrase
-
-Setting key: P2P_passphrase
-
-The password or passphrase used to authenticate and encrypt P2P communication. All devices must use the same passphrase.
-
-#### Device Peer ID
-
-Setting key: P2P_DevicePeerName
-
-The peer name or identifier of this device in the P2P network. This should be unique within your group of devices.
-
-#### Automatically start P2P connection on launch
-
-Setting key: P2P_AutoStart
-
-This option is labeled **Auto Start P2P Connection** in the setup dialogue. If enabled, the P2P connection will start automatically when the plug-in launches.
-
-#### Automatically broadcast changes to connected peers
-
-Setting key: P2P_AutoBroadcast
-
-This option is labeled **Auto Broadcast Changes** in the setup dialogue. If enabled, changes will be automatically broadcasted to connected peers, requesting them to fetch the changes.
-
-#### TURN Server URLs (comma-separated)
-
-Setting key: P2P_turnServers
-
-A comma-separated list of TURN/STUN server URLs. Used to relay P2P connections when direct WebRTC connection fails due to strict NAT or firewalls. In most cases, these can be left blank.
-
-#### TURN Username
-
-Setting key: P2P_turnUsername
-
-The username for authentication with the TURN server.
-
-#### TURN Credential
-
-Setting key: P2P_turnCredential
-
-The password or credential for authentication with the TURN server.
-
 ## 4. Sync Settings
 
-### 1. Synchronisation Preset
+### 1. Synchronization Preset
 
 #### Presets
 
 Setting key: preset
 Apply preset configuration
 
-### 2. Synchronisation Method
+### 2. Synchronization Method
 
 #### Sync Mode
 
 Setting key: syncMode
 
-The trigger mechanism for synchronisation.
-- **LiveSync** (`LIVESYNC`): Real-time, continuous, bidirectional synchronisation.
-  Note: This requires a CouchDB or WebRTC P2P remote server. It is not supported for S3-compatible Object Storage.
-- **Periodic Sync** (`PERIODIC`): Synchronisation is performed at regular intervals specified by the **Periodic Sync interval** setting.
-- **On Events** (`ONEVENTS`): Synchronisation is triggered by specific events (such as save, file open, or startup) configured via the toggles below.
-
 #### Periodic Sync interval
 
 Setting key: periodicReplicationInterval
 Interval (sec)
 
-#### Minimum interval for syncing
-
-Setting key: syncMinimumInterval
-
-The minimum interval for automatic synchronisation on event.
-
 #### Sync on Save
 
 Setting key: syncOnSave
@@ -515,7 +323,7 @@ Move remotely deleted files to the trash, instead of deleting.
 #### Keep empty folder
 
 Setting key: doNotDeleteFolder
-Should we keep folders that do not have any files inside?
+Should we keep folders that don't have any files inside?
 
 ### 5. Conflict resolution (Advanced)
 
@@ -552,7 +360,7 @@ Setting key: notifyAllSettingSyncFile
 
 ### 7. Hidden Files (Advanced)
 
-#### Hidden file synchronisation
+#### Hidden file synchronization
 
 #### Enable Hidden files sync
 
@@ -565,12 +373,6 @@ Setting key: syncInternalFilesBeforeReplication
 Setting key: syncInternalFilesInterval
 Seconds, 0 to disable
 
-#### Suppress notification of hidden files change
-
-Setting key: suppressNotifyHiddenFilesChange
-
-If enabled, the notification of hidden files change will be suppressed.
-
 ## 5. Selector (Advanced)
 
 ### 1. Normal Files
@@ -604,42 +406,42 @@ Comma separated `.gitignore, .dockerignore`
 
 #### Add default patterns
 
-## 6. Customisation sync (Advanced)
+## 6. Customization sync (Advanced)
 
-### 1. Customisation Sync
+### 1. Customization Sync
 
 #### Device name
 
 Setting key: deviceAndVaultName
-Unique name between all synchronised devices. To edit this setting, please disable customisation sync once.
+Unique name between all synchronized devices. To edit this setting, please disable customization sync once.
 
-#### Per-file-saved customisation sync
+#### Per-file-saved customization sync
 
 Setting key: usePluginSyncV2
-If enabled, per-file efficient customisation sync will be used. We need a small migration when enabling this. And all devices should be updated to v0.23.18. Once we enable this, we lose compatibility with old versions.
+If enabled per-filed efficient customization sync will be used. We need a small migration when enabling this. And all devices should be updated to v0.23.18. Once we enabled this, we lost a compatibility with old versions.
 
-#### Enable customisation sync
+#### Enable customization sync
 
 Setting key: usePluginSync
 
-#### Scan customisation automatically
+#### Scan customization automatically
 
 Setting key: autoSweepPlugins
-Scan customisation before replicating.
+Scan customization before replicating.
 
-#### Scan customisation periodically
+#### Scan customization periodically
 
 Setting key: autoSweepPluginsPeriodic
-Scan customisation every 1 minute.
+Scan customization every 1 minute.
 
-#### Notify customised
+#### Notify customized
 
 Setting key: notifyPluginOrSettingUpdated
-Notify when another device has newly customised.
+Notify when other device has newly customized.
 
 #### Open
 
-Open the dialogue
+Open the dialog
 
 ## 7. Hatch
 
@@ -654,18 +456,14 @@ Warning! This will have a serious impact on performance. And the logs will not b
 
 ### 2. Scram Switches
 
-Emergency controls to suspend synchronisation processes in order to prevent database corruption. If a critical mismatch or sync error occurs, the plug-in may automatically enter a Scram state and suspend operations.
-
 #### Suspend file watching
 
 Setting key: suspendFileWatching
-
-Stop watching for local file changes.
+Stop watching for file changes.
 
 #### Suspend database reflecting
 
 Setting key: suspendParseReplicationResult
-
 Stop reflecting database changes to storage files.
 
 ### 3. Recovery and Repair
@@ -688,7 +486,7 @@ Compare the content of files between on local database and storage. If not match
 
 #### Back to non-configured
 
-#### Delete all customisation sync data
+#### Delete all customization sync data
 
 ## 8. Advanced (Advanced)
 
@@ -709,12 +507,6 @@ Setting key: hashCacheMaxAmount
 
 Setting key: customChunkSize
 
-#### Chunk Splitter
-
-Setting key: chunkSplitterVersion
-
-Select the chunk splitter version; V3 is the most efficient. If you experience issues, please choose Default or Legacy.
-
 #### Use splitting-limit-capped chunk splitter
 
 Setting key: enableChunkSplitterV2
@@ -740,12 +532,6 @@ Setting key: concurrencyOfReadChunksOnline
 
 Setting key: minimumIntervalOfReadChunksOnline
 
-#### Maximum size of chunks to send in one request
-
-Setting key: sendChunksBulkMaxSize
-
-Limit the maximum size of chunks to send in a single bulk request (MB).
-
 ## 9. Power users (Power User)
 
 ### 1. Remote Database Tweak
@@ -853,7 +639,7 @@ If this enabled, All files are handled as case-Sensitive (Previous behaviour).
 
 ### 4. Compatibility (Internal API Usage)
 
-#### Scan changes on customisation sync
+#### Scan changes on customization sync
 
 Setting key: watchInternalFileChanges
 Do not use internal API
@@ -878,13 +664,7 @@ Setting key: doNotSuspendOnFetching
 #### Keep empty folder
 
 Setting key: doNotDeleteFolder
-Should we keep folders that do not have any files inside?
-
-#### Process files even if seems to be corrupted
-
-Setting key: processSizeMismatchedFiles
-
-Enable this setting to process files with size mismatches, which can sometimes be created by certain external APIs or integrations.
+Should we keep folders that don't have any files inside?
 
 ### 7. Edge case addressing (Processing)
 
@@ -904,25 +684,17 @@ If enabled, the file under 1kb will be processed in the UI thread.
 
 Setting key: disableCheckingConfigMismatch
 
-### 9. Remediation
-
-#### Maximum file modification time for reflected file events
-
-Setting key: maxMTimeForReflectEvents
-
-Files with modification times greater than this value (in seconds since the Unix epoch) will not have their events reflected. Set to 0 to disable this limit.
-
 ## 11. Maintenance
 
 ### 1. Scram!
 
 #### Lock Server
 
-Lock the remote server to prevent synchronisation with other devices.
+Lock the remote server to prevent synchronization with other devices.
 
 #### Emergency restart
 
-Disables all synchronisation and restart.
+Disables all synchronization and restart.
 
 ### 2. Syncing
 
@@ -940,13 +712,17 @@ Initialise journal sent history. On the next sync, every item except this device
 
 ### 3. Rebuilding Operations (Local)
 
-#### Reset Synchronisation on This Device
+#### Fetch from remote
 
 Restore or reconstruct local database from remote.
 
+#### Fetch rebuilt DB (Save local documents before)
+
+Restore or reconstruct local database from remote database but use local chunks.
+
 ### 4. Total Overhaul
 
-#### Overwrite Server Data with This Device's Files
+#### Rebuild everything
 
 Rebuild local and remote database with local files.
 
@@ -976,7 +752,7 @@ Delete all data on the remote server.
 
 #### Run database cleanup
 
-Attempt to shrink the database by deleting unused chunks. This may not work consistently. Use the 'Overwrite Server Data with This Device's Files' under Reset Synchronisation information.
+Attempt to shrink the database by deleting unused chunks. This may not work consistently. Use the 'Rebuild everything' under Total Overhaul.
 
 ### 7. Reset
 

docs/settings_ja.md

@@ -3,133 +3,23 @@
 # このプラグインの設定項目
 
 ## Remote Database Configurations
-同期先のデータベース設定（Remote Server）を行います。
+同期先のデータベース設定を行います。何らかの同期が有効になっている場合は編集できないため、同期を解除してから行ってください。
 
-現在のバージョンでは、複数のリモート接続設定（接続プロファイル）を登録・管理し、切り替えて使用することが可能です（「Remote Databases」リスト）。
+### URI
+CouchDBのURIを入力します。Cloudantの場合は「External Endpoint(preferred)」になります。  
+**スラッシュで終わってはいけません。**  
+こちらにデータベース名を含めてもかまいません。
 
-- **➕ 新規接続を追加 (Add new connection)**: 新しい接続設定を作成し、各セットアップダイアログを起動します。
-- **📥 接続をインポート (Import connection)**: 接続文字列（`sls+https://...`、`sls+s3://...`、`sls+p2p://...`など）を貼り付けてインポートします。
-- **🔧 設定 (Configure)**: セットアップダイアログを開き、選択した接続プロファイルの設定を編集します。
-- **✅ 有効化 (Activate)**: 選択したプロファイルをアクティブな同期先として有効化します。
-- **🗑️ 削除 (Delete)**: 接続プロファイルを一覧から削除します。
+### Username 
+ユーザー名を入力します。このユーザーは管理者権限があることが望ましいです。
 
-これらの接続プロファイルを追加・編集する際、選択したデータベースの種類（CouchDB、S3互換オブジェクトストレージ、P2Pなど）に応じたセットアップダイアログが開きます。
+### Password
+パスワードを入力します。
 
-何らかの同期が有効になっている場合は編集できないため、同期を解除してから行ってください。
-
-### CouchDB の設定
-CouchDBの各設定項目は、接続プロファイルを追加 (➕) または設定 (🔧) する際に開く **CouchDB セットアップダイアログ** 内で設定します。
-
-#### URI
-設定キー: couchDB_URI
-
-CouchDBの接続先URIです。ダイアログ内では **URL** と表記されます。Cloudantの場合は「External Endpoint (preferred)」になります。
-注意: Obsidian Mobileではセキュア接続 (HTTPS) のみが使用可能です。また、末尾にスラッシュ（`/`）を付けてはいけません。
-
-#### Username
-設定キー: couchDB_USER
-
-CouchDBのログインユーザー名です。ダイアログ内では **Username** と表記されます。このユーザーには管理者権限があることが望ましいです。
-
-#### Password
-設定キー: couchDB_PASSWORD
-
-CouchDBのログインパスワードです。ダイアログ内では **Password** と表記されます。
-
-#### Database Name
-設定キー: couchDB_DBNAME
-
-同期先のデータベース名です。ダイアログ内では **Database Name** と表記されます。
-注意: データベース名には大文字、スペース、および一部の特殊文字（`_$()+/-` 以外）は使用できません。また、アンダースコア（`_`）から始めることはできません。存在しない場合は、接続テスト時または設定適用時に自動作成されます（作成権限が必要です）。
-
-#### CORS回避のためにRequest APIを使用する
-設定キー: useRequestAPI
-
-この項目はセットアップダイアログ内では **Use Internal API** と表記されます。有効な場合、不可避なCORS問題を回避するためにObsidianの内部Request APIを使用します。これはWeb標準に準拠していない回避策であり、すべての環境での動作を保証するものではありません。安全性が低下する可能性がある点にご注意ください。将来のObsidianのアップデートによって動作しなくなる可能性があります。
-
-#### カスタムヘッダー
-設定キー: couchDB_CustomHeaders
-
-CouchDBサーバーに送信するすべてのリクエストに含めるカスタムHTTPヘッダーを設定します。ダイアログ内では **Custom Headers** と表記されます。`ヘッダー名: 値` の形式で、1行に1つずつ入力してください。
-
-#### JWT認証の使用 (実験的機能)
-設定キー: useJWT
-
-CouchDBでのJSON Web Token (JWT) 認証を有効にします。ダイアログ内では **Use JWT Authentication** と表記されます。十分に検証されていない実験的機能であるため、ご注意ください。
-
-#### JWTアルゴリズム
-設定キー: jwtAlgorithm
-
-JWTの署名に使用するアルゴリズムを選択します。ダイアログ内では **JWT Algorithm** と表記されます。対応アルゴリズム: `HS256`, `HS512`, `ES256`, `ES512`
-
-#### JWT有効期限 (分)
-設定キー: jwtExpDuration
-
-トークンの有効期限を分単位で指定します。ダイアログ内では **JWT Expiration Duration (minutes)** と表記されます。`0` を指定すると有効期限は無効になります。
-
-#### JWTキー
-設定キー: jwtKey
-
-JWTの署名に使用する秘密鍵またはプライベートキーを指定します。ダイアログ内では **JWT Key** と表記されます。`HS256/HS512` の場合は共通鍵を、`ES256/ES512` の場合は pkcs8 PEM形式の秘密鍵を入力してください。
-
-#### JWTキーID (kid)
-設定キー: jwtKid
-
-JWTヘッダーに含めるキーIDを指定します。ダイアログ内では **JWT Key ID (kid)** と表記されます。
-
-#### JWTサブジェクト (sub)
-設定キー: jwtSub
-
-JWTのサブジェクト (CouchDBユーザー名) を指定します。ダイアログ内では **JWT Subject (sub)** と表記されます。 
-
-### Object Storage (Minio, S3, R2) の設定
-Object Storageの各設定項目は、接続プロファイルを追加 (➕) または設定 (🔧) する際に開く **S3/MinIO/R2 セットアップダイアログ** 内で設定します。
-
-#### エンドポイントURL
-設定キー: endpoint
-
-S3互換ストレージのエンドポイントURLです。ダイアログ内では **Endpoint URL** と表記されます。
-注意: Obsidian Mobileではセキュア接続 (HTTPS) のみが使用可能です。
-
-#### アクセスキー ID
-設定キー: accessKey
-
-認証に使用するアクセスキーIDです。ダイアログ内では **Access Key ID** と表記されます。
-
-#### シークレットアクセスキー
-設定キー: secretKey
-
-認証に使用するシークレットアクセスキーです。ダイアログ内では **Secret Access Key** と表記されます。
-
-#### リージョン
-設定キー: region
-
-ストレージのリージョンを指定します（例: `us-east-1`、Cloudflare R2の場合は `auto`）。ダイアログ内では **Region** と表記されます。
-
-#### バケット名
-設定キー: bucket
-
-同期データを保存するバケット名です。ダイアログ内では **Bucket Name** と表記されます。
-
-#### カスタムHTTPハンドラーを使用する
-設定キー: useCustomRequestHandler
-
-この項目はセットアップダイアログ内では **Use internal API** と表記されます。オブジェクトストレージがCORSをサポートしていない場合に有効にします。Obsidianの内部APIを使用してS3サーバーと通信することでCORS制約を回避します。Web標準には準拠していないため、将来のObsidianのアップデートによって動作しなくなる可能性があります。
-
-#### バケット内のファイルプレフィックス
-設定キー: bucketPrefix
-
-この項目はセットアップダイアログ内では **Folder Prefix** と表記されます。実質的なディレクトリ指定です。末尾は `/` である必要があります（例：`vault-name/`）。バケットのルートに保存する場合は空欄のままにしてください。
-
-#### forcePathStyleを有効にする
-設定キー: forcePathStyle
-
-この項目はセットアップダイアログ内では **Use Path-Style Access** と表記されます。有効な場合、バケット操作でforcePathStyleオプションを使用します。
-
-#### カスタムヘッダー
-設定キー: bucketCustomHeaders
-
-オブジェクトストレージバケットに送信するすべてのリクエストに含めるカスタムHTTPヘッダーを設定します。ダイアログ内では **Custom Headers** と表記されます。`ヘッダー名: 値` の形式で、1行に1つずつ入力してください。
+### Database Name
+同期するデータベース名を入力します。  
+⚠️存在しない場合は、テストや接続を行った際、自動的に作成されます[^1]。
+[^1]:権限がない場合は自動作成には失敗します。 
 
 
 
@@ -140,18 +30,6 @@ S3互換ストレージのエンドポイントURLです。ダイアログ内で
 ### Passphrase
 暗号化を行う際に使用するパスフレーズです。充分に長いものを使用してください。
 
-### パスの難読化
-設定キー: usePathObfuscation
-
-ダイアログ内では **Obfuscate Properties** と表記されます。有効な場合、リモートサーバー上でのファイルパスやフォルダ名を難読化（暗号化）します。これによりプライバシーが向上しますが、パフォーマンスがわずかに低下する可能性があります。
-
-### 暗号化アルゴリズム
-設定キー: E2EEAlgorithm
-
-ダイアログ内では **Encryption Algorithm** と表記されます。エンドツーエンド暗号化に使用する暗号化アルゴリズムのバージョンを選択します。
-- `v2` (V2: AES-256-GCM With HKDF): 推奨されるデフォルトのバージョンです。
-- `forceV1` または `""` (V1: Legacy): レガシーな暗号化バージョンです。古いバージョンで暗号化された既存の保管庫（Vault）を同期する場合にのみ使用してください。
-
 ### Apply
 End to End 暗号化を行うに当たって、異なるパスフレーズで暗号化された同一の内容を入手されることは避けるべきです。また、Self-hosted LiveSyncはコンテンツのcrc32を重複回避に使用しているため、その点でも攻撃が有効になってしまいます。
 
@@ -175,66 +53,12 @@ End to End 暗号化を行うに当たって、異なるパスフレーズで暗
 どちらのオペレーションも、実行するとすべての同期設定が無効化されます。  
 
 
-
-
 ### Test Database connection
 上記の設定でデータベースに接続できるか確認します。
 
 ### Check database configuration
 ここから直接CouchDBの設定を確認・変更できます。
 
-### Peer-to-Peer (P2P) 同期の設定
-
-#### P2P同期を有効にする
-設定キー: P2P_Enabled
-
-WebRTCを介したデバイス間での直接的なP2P同期を有効にします。ダイアログ内では **Enabled** と表記されます。
-
-#### リレーサーバーのURL
-設定キー: P2P_relays
-
-WebRTCによるP2P接続を仲介・調整するためのWebSocketリレーサーバーのURLを指定します。ダイアログ内では **Relay URL** と表記されます。複数のURLを指定する場合はカンマで区切ります。ダイアログ内のボタンをクリックすると、デフォルトのリレーサーバーを設定できます。
-
-#### グループID
-設定キー: P2P_roomID
-
-同期するデバイス群を識別するためのルームIDまたはグループIDを指定します。ダイアログ内では **Group ID** と表記されます。同期させたいすべてのデバイスで同じグループIDを指定する必要があります。任意のカスタム文字列を入力するか、ランダム生成ボタンで生成できます。
-
-#### パスフレーズ
-設定キー: P2P_passphrase
-
-P2P通信の認証および暗号化に使用するパスワード（パスフレーズ）を指定します。ダイアログ内では **Passphrase** と表記されます。同期するすべてのデバイスで同じパスフレーズを指定する必要があります。
-
-#### デバイス名
-設定キー: P2P_DevicePeerName
-
-P2Pネットワーク上でこのデバイスを識別するための名前を指定します。ダイアログ内では **Device Peer ID** と表記されます。グループ内のデバイス間で重複しない一意の値を設定してください。
-
-#### 起動時のP2P自動接続開始
-設定キー: P2P_AutoStart
-
-有効な場合、プラグインの起動時に自動的にP2P接続を開始します。ダイアログ内では **Auto Start P2P Connection** と表記されます。
-
-#### 接続済みピアへの変更の自動ブロードキャスト
-設定キー: P2P_AutoBroadcast
-
-有効な場合、ローカルでの変更が接続済みのピアに自動的にブロードキャストされます。ダイアログ内では **Auto Broadcast Changes** と表記されます。通知されたピアは変更の取得を開始します。
-
-#### TURNサーバーのURL (カンマ区切り)
-設定キー: P2P_turnServers
-
-ダイアログ内では **TURN Server URLs (comma-separated)** と表記されます。厳しいNATやファイアウォールがある環境で、WebRTCの直接接続が確立できない場合にP2P接続を中継するためのTURN/STUNサーバーのURLをカンマ区切りで指定します。通常は空欄のままで問題ありません。
-
-#### TURNユーザー名
-設定キー: P2P_turnUsername
-
-TURNサーバーでの認証に使用するユーザー名を設定します。ダイアログ内では **TURN Username** と表記されます。
-
-#### TURNパスワード
-設定キー: P2P_turnCredential
-
-TURNサーバーでの認証に使用するパスワード（クレデンシャル）を設定します。ダイアログ内では **TURN Credential** と表記されます。
-
 ## Local Database Configurations
 端末内に作成されるデータベースの設定です。
 
@@ -247,8 +71,7 @@ TURNサーバーでの認証に使用するパスワード（クレデンシャ
 このオプションはLiveSyncと同時には使用できません。
 
 ### minimum chunk size と LongLine threshold
-チャンクの分割についての設定です。※現在これらの項目はUIから直接設定することはできません（デフォルト値で自動処理されます）。
-
+チャンクの分割についての設定です。  
 Self-hosted LiveSyncは一つのチャンクのサイズを最低minimum chunk size文字確保した上で、できるだけ効率的に同期できるよう、ノートを分割してチャンクを作成します。  
 これは、同期を行う際に、一定の文字数で分割した場合、先頭の方を編集すると、その後の分割位置がすべてずれ、結果としてほぼまるごとのファイルのファイル送受信を行うことになっていた問題を避けるために実装されました。  
 具体的には、先頭から順に直近の下記の箇所を検索し、一番長く切れたものを一つのチャンクとします。
@@ -265,11 +88,6 @@ Self-hosted LiveSyncは一つのチャンクのサイズを最低minimum chunk s
 改行文字と#を除き、すべて●に置換しても、アルゴリズムは有効に働きます。  
 デフォルトは20文字と、250文字です。
 
-### チャンクスプリッター
-設定キー: chunkSplitterVersion
-
-チャンク分割アルゴリズムを選択します。V3が最も効率的です。問題が発生した場合はDefaultまたはLegacyに設定してください。
-
 ## General Settings
 一般的な設定です。
 
@@ -279,35 +97,18 @@ Self-hosted LiveSyncは一つのチャンクのサイズを最低minimum chunk s
 ### Vervose log
 詳細なログをログに出力します。
 
-### ファイル警告バナーの代わりにステータスアイコンを表示
-設定キー: hideFileWarningNotice
-
-有効な場合、ファイル警告バナーの代わりにステータス表示内に ⛔ アイコンが表示されます（詳細情報は非表示になります）。
-
-### ネットワーク警告のスタイル
-設定キー: networkWarningStyle
-
-同期サーバーに接続できない場合のネットワークエラーの表示方法。
-
 ## Sync setting
 同期に関する設定です。
 
-### 同期モード (Sync Mode)
-設定キー: syncMode
+### LiveSync
+LiveSyncを行います。
+他の同期方法では、同期の順序が「バージョン確認を行い、ロックが行われていないか確認した後、リモートの変更を受信した後、デバイスの変更を送信する」という挙動になります。
 
-同期処理を実行するトリガーとなる条件を設定します。
-- **LiveSync** (`LIVESYNC`): リアルタイムかつ継続的な双方向同期を行います。
-  注意: このモードには CouchDB または WebRTC P2P リモートサーバーが必要です。S3互換オブジェクトストレージではサポートされていません。
-- **Periodic Sync** (`PERIODIC`): **Periodic Sync Interval** で指定した一定の間隔ごとに同期処理を実行します。
-- **On Events** (`ONEVENTS`): ファイルの保存、ファイルを開く、起動時など、特定のイベントが発生した際に同期をトリガーします（詳細は下部の設定スイッチで制御します）。
+### Periodic Sync
+定期的に同期を行います。
 
 ### Periodic Sync Interval
-定期的に同期を行う場合の間隔（秒単位）です。
-
-### 同期の最小間隔
-設定キー: syncMinimumInterval
-
-イベント時の自動同期の最小間隔（ミリ秒）。
+定期的に同期を行う場合の間隔です。
 
 ### Sync on Save
 ファイルが保存されたときに同期を行います。  
@@ -345,11 +146,6 @@ Self-hosted LiveSyncは通常、フォルダ内のファイルがすべて削除
 - Scan hidden files periodicaly.
 このオプションを有効にすると、n秒おきに隠しファイルをスキャンします。
 
-#### 非表示ファイルの変更通知を抑制
-設定キー: suppressNotifyHiddenFilesChange
-
-有効な場合、非表示ファイルの変更に関する通知を抑制します。
-
 隠しファイルは能動的に検出されないため、スキャンが必要です。
 スキャンでは、ファイルと共にファイルの変更時刻を保存します。もしファイルが消された場合は、その事実も保存します。このファイルを記録したエントリーがレプリケーションされた際、ストレージよりも新しい場合はストレージに反映されます。
 
@@ -380,45 +176,6 @@ Self-hosted LiveSyncはPouchDBを使用し、リモートと[このプロトコ
 ### Batch limit
 一度に処理するBatchの数です。デフォルトは40です。
 
-### 1回のリクエストで送信するチャンクの最大サイズ
-設定キー: sendChunksBulkMaxSize
-
-メガバイト（MB）単位で指定します。
-
-## Customisation Sync (カスタマイズ同期)
-プラグイン、ホットキー、テーマ、スニペットなどのObsidianのカスタマイズ設定を同期する機能です（以前は **Plugin Sync** と呼ばれていました）。
-
-### デバイス名 (Device name)
-設定キー: deviceAndVaultName
-
-同期するすべてのデバイス間で一意となるデバイス名です。この設定を編集するには、一度カスタマイズ同期を無効にする必要があります。
-
-### ファイル保存ごとのカスタマイズ同期 (Per-file-saved customisation sync)
-設定キー: usePluginSyncV2
-
-有効な場合、ファイルごとの効率的なカスタマイズ同期が使用されます。有効にする際には簡単な移行作業が必要であり、すべてのデバイスを v0.23.18 以降にアップデートする必要があります。この機能を有効にすると、古いバージョンとの互換性が失われます。
-
-### カスタマイズ同期を有効にする (Enable customisation sync)
-設定キー: usePluginSync
-
-テーマ、スニペット、ホットキー、プラグイン設定などの同期を有効にします。
-注意: 安全上の理由から、この機能を使用するにはエンドツーエンド暗号化（End-to-End Encryption）が有効になっている必要があります。
-
-### カスタマイズの自動スキャン (Scan customisation automatically)
-設定キー: autoSweepPlugins
-
-レプリケーション（同期処理）を実行する前に、カスタマイズ設定の変更をスキャンします。
-
-### 定期的なカスタマイズのスキャン (Scan customisation periodically)
-設定キー: autoSweepPluginsPeriodic
-
-1分ごとにカスタマイズ設定の変更を定期的にスキャンします。
-
-### カスタマイズ更新の通知 (Notify customised)
-設定キー: notifyPluginOrSettingUpdated
-
-他のデバイスで新しくカスタマイズ設定が更新されたときに通知を表示します。
-
 ## Miscellaneous
 その他の設定です
 ### Show status inside editor
@@ -438,8 +195,8 @@ Self-hosted LiveSyncはPouchDBを使用し、リモートと[このプロトコ
 ![CorruptedData](../images/lock_pattern1.png)  
 データベースがロックされていて、端末が「解決済み」とマークされていない場合、警告が表示されます。  
 他のデバイスで、End to End暗号化を有効にしたか、Drop Historyを行った等、他の端末がそのまま同期を行ってはいない状態に陥った場合表示されます。  
-暗号化を有効化した場合は、パスフレーズを設定して「このデバイスの同期状態をリセット」、または「このデバイスのファイルでサーバーデータを上書き」を行うと自動的に解除されます。  
-手動でこのロックを解除する場合は「I've made a backup, mark this device 'resolved'」をクリックしてください。
+暗号化を有効化した場合は、パスフレーズを設定してApply and recieve、Drop Historyを行った場合は、Drop and recieveを行うと自動的に解除されます。  
+手動でこのロックを解除する場合は「mark this device as resolved」をクリックしてください。
 
 - パターン２  
 ![CorruptedData](../images/lock_pattern2.png)  
@@ -450,52 +207,18 @@ Self-hosted LiveSyncはPouchDBを使用し、リモートと[このプロトコ
 ### Verify and repair all files
 Vault内のファイルを全て読み込み直し、もし差分があったり、データベースから正常に読み込めなかったものに関して、データベースに反映します。
 
-- このデバイスの同期状態をリセット (Reset Synchronisation on This Device)
-ローカルのデータベースを破棄し、リモートのデータから再構築します。
-- このデバイスのファイルでサーバーデータを上書き (Overwrite Server Data with This Device's Files)
-ローカルおよびリモートのデータベースをこのデバイス上のファイルで再構築（上書き）します。
+- Drop and send
+デバイスとリモートのデータベースを破棄し、ロックしてからデバイスのファイルでデータベースを構築後、リモートに上書きします。
+- Drop and receive
+デバイスのデータベースを破棄した後、リモートから、操作しているデバイスに関してロックを解除し、データを受信して再構築します。
 
 ### Lock remote database
 リモートのデータベースをロックし、他の端末で同期を行おうとしてもエラーとともに同期がキャンセルされるように設定します。これは、データベースの再構築を行った場合、自動的に設定されるものと同じものです。
 
 万が一同期に不具合が発生していて、使用しているデバイスのデータ＋サーバーのデータを保護する場合などに、緊急避難的に使用してください。
 
-### Scram スイッチ (Scram Switches)
-データベースの破損や予期しないデータ喪失を防ぐために、同期処理を緊急停止するためのスイッチです。重大な設定不一致や同期エラーが発生した場合、プラグインは自動的に Scram 状態に移行し、同期動作を一時停止することがあります。
-
-#### ファイルの更新監視を一時停止 (Suspend file watching)
-設定キー: suspendFileWatching
-
-ローカルファイル変更の監視と検知を停止します。
-
-#### データベース反映を一時停止 (Suspend database reflecting)
-設定キー: suspendParseReplicationResult
-
-データベースでの変更をストレージファイル（Vault内のファイル）へ書き戻す処理を停止します。
-
-### 互換性（メタデータ）(Compatibility (Metadata))
-
-#### 削除済みファイルのメタデータを保持しない (Do not keep metadata of deleted files.)
-設定キー: deleteMetadataOfDeletedFiles
-
-ファイルを削除した際に、そのファイルの同期履歴メタデータも即座にデータベースから削除し、保持しないようにします。
-
-#### 削除済みデータのメタデータをクリーンナップする (Delete old metadata of deleted files on start-up)
-設定キー: automaticallyDeleteMetadataOfDeletedFiles
-
-ファイルを削除した際のメタデータを保持する期間（日数）を設定します。指定した日数を経過した古い削除済みファイルのメタデータは、プラグイン起動時にデータベースから自動的に削除（クリーンナップ）されます。`0` を指定すると自動削除は無効になります。
-
-### 破損している可能性があるファイルも処理する
-設定キー: processSizeMismatchedFiles
-
-サイズ不一致のあるファイルを処理します。特定のAPIや外部連携によって作成されたファイルを同期する際に役立ちます。
-
-### Remediation
-
-#### イベント反映時の最大ファイル更新日時
-設定キー: maxMTimeForReflectEvents
-
-この値（Unixエポックからの秒数）より新しい更新日時を持つファイルについては、イベントの反映を無視します。0を指定すると制限が無効になります。
+### Suspend file watching
+ファイルの更新の監視を止めます。
 
 ### Corrupted data
 ![CorruptedData](../images/corrupted_data.png)

docs/setup_cloudant.md

@@ -13,7 +13,7 @@ In these instructions, create IBM Cloudant Instance for trial.
 1. You can choose "Lite plan" for free.  
    ![step 3](../instruction_images/cloudant_3.png)
 
-1. Select Multitenant (it is the default) and the region as you like.  
+1. Select Multitenant(it's the default) and the region as you like.  
    ![step 4](../instruction_images/cloudant_4.png)
 
 1. Be sure to select "IAM and Legacy credentials" for "Authentication Method".  
@@ -28,20 +28,20 @@ In these instructions, create IBM Cloudant Instance for trial.
 1. When all of the above steps have been done, open "Resource list" on the left pane. you can see the Cloudant instance in the "Service and software". Click it.  
    ![step 8](../instruction_images/cloudant_8.png)
 
-1. In resource details, there is information to connect from Self-hosted LiveSync.  
-   Copy the "External Endpoint (preferred)" address. <sup>(\*1)</sup>. We use this address later, with the database name.  
+1. In resource details, there's information to connect from Self-hosted LiveSync.  
+   Copy the "External Endpoint(preferred)" address. <sup>(\*1)</sup>. We use this address later, with the database name.  
    ![step 9](../instruction_images/cloudant_9.png)
 
 ## Database setup
 
 1.  Hit the "Launch Dashboard" button, Cloudant dashboard will be shown.  
-    Yes, it is almost CouchDB's fauxton.  
+    Yes, it's almost CouchDB's fauxton.  
     ![step 1](../instruction_images/couchdb_1.png)
 
 1.  First, you have to enable the CORS option.  
     Hit the Account menu and open the "CORS" tab.  
     Initially, "Origin Domains" is set to "Restrict to specific domains"., so set to "All domains(\*)"  
-    _NOTE: of course We want to set "app://obsidian.md" but it is not acceptable on Cloudant._
+    _NOTE: of course We want to set "app://obsidian.md" but it's not acceptable on Cloudant._
     ![step 2](../instruction_images/couchdb_2.png)
 
 1.  Next, Open the "Databases" tab and hit the "Create Database" button.  
@@ -55,10 +55,10 @@ In these instructions, create IBM Cloudant Instance for trial.
 
 ### Credentials Setup
 
-1.  Back into IBM Cloud, Open the "Service credentials". You will get an empty list, hit the "New credential" button.  
+1.  Back into IBM Cloud, Open the "Service credentials". You'll get an empty list, hit the "New credential" button.  
     ![step 1](../instruction_images/credentials_1.png)
 
-1.  The dialogue to create a credential will be shown.  
+1.  The dialog to create a credential will be shown.  
     type any name or leave it default, hit the "Add" button.  
     ![step 2](../instruction_images/credentials_2.png)  
     _NOTE: This "name" is not related to your username that uses in Self-hosted LiveSync._
@@ -68,14 +68,14 @@ In these instructions, create IBM Cloudant Instance for trial.
     ![step 3](../instruction_images/credentials_3.png)  
     The username and password pair is inside this JSON.  
     "username" and "password" are so.  
-    follow the figure, it is  
+    follow the figure, it's  
     "apikey-v2-2unu15184f7o8emr90xlqgkm2ncwhbltml6tgnjl9sd5"<sup>(\*3)</sup> and "c2c11651d75497fa3d3c486e4c8bdf27"<sup>(\*4)</sup>
 
 ## Self-hosted LiveSync settings
 
 ![Setting](../images/remote_db_setting.png)
 
-The settings should be as follows:
+The Setting should be as below:
 
 | Items         | Value | example                                                           |
 | ------------- | ----- | ----------------------------------------------------------------- |

docs/tech_info.md

@@ -1,8 +1,8 @@
 # Designed architecture
 
-## How does this plug-in synchronise.
+## How does this plugin synchronize.
 
-![Synchronisation](../images/1.png)
+![Synchronization](../images/1.png)
 
 1. When notes are created or modified, Obsidian raises some events. Self-hosted LiveSync catches these events and reflects changes into Local PouchDB.
 2. PouchDB automatically or manually replicates changes to remote CouchDB.

docs/tech_info_cn.md

@@ -2,7 +2,7 @@
 
 ## 这个插件是怎么实现同步的.
 
-![Synchronisation](../images/1.png)
+![Synchronization](../images/1.png)
 
 1. 当笔记创建或修改时，Obsidian会触发事件。Self-hosted LiveSync捕获这些事件，并将变更同步至本地PouchDB
 2. PouchDB通过自动或手动方式将变更同步至远程CouchDB

docs/tech_info_ja.md

@@ -2,7 +2,7 @@
 
 ## 同期
 
-![Synchronisation](../images/1.png)
+![Synchronization](../images/1.png)
 
 1. ノートが更新された際、Obsidianがイベントを発報します。Obsidian-LiveSyncはそれをハンドリングして、ローカルのPouchDBに変更を反映します。
 2. PouchDBは、リモートのCouchDBに差分をレプリケーションします。

docs/terms.md

@@ -2,102 +2,23 @@
 
 ## Spelling and Vocabulary conventions
 
-All guidelines and conventions listed below are disclosed and maintained solely for the sake of documentation `consistency`.
+1. Almost all of the english words are written in British English. For example, "organisation" instead of "organization", "synchronisation" instead of "synchronization", etc. This convention originated from the author's personal preference but is now maintained for consistency.
 
-1. Almost all of the English words are written in British English. This convention originated from the author's personal preference.
-   - **Traditional Spelling (Trad-spelling)**: We prefer traditional British English spellings. In particular, we use `-ise` and `-isation` suffixes rather than the Oxford spelling `-ize` and `-ization` (for example, 'initialisation', 'synchronisation', and 'organisation').
-   - **Oxford Comma**: We use the serial (Oxford) comma to separate items in lists of three or more (for example, 'settings, snippets, and themes' instead of 'settings, snippets and themes').
-   - **Logical Punctuation**: We place punctuation marks (such as commas and full stops) outside quotation marks, unless the punctuation mark is part of the quoted text itself. For example, we write 'dialogue', not 'dialogue,'.
-   - **BBC News Styleguide**: If in wonder, the BBC News Styleguide may be useful as a reference.
-
-2. Idiomatic terms, such as those used in HTML, CSS, and JavaScript, are usually aligned with the language used in the technology. For example, "color" instead of "colour", "program" instead of "programme", etc. Especially, terms which are used for attributes, properties, and methods are notable.
+2. Idiomatic terms, such as used in HTML, CSS, and JavaScript, are usually be aligned with the language used in the technology. For example, "color" instead of "colour", "program" instead of "programme", etc. Especially, terms which are used for attributes, properties, and methods are notable.
 
 3. We use `dialogue` in documentation for consistency. While `dialog` may appear in source code, particularly in class names, method names, and attributes (following technical conventions in No. 2), we consistently use `dialogue` for user-facing messages and general documentation text. This approach balances No. 1 with No. 2.
 
-4. Contractions are not used. For example, "do not" instead of "don't", "cannot" instead of "can't", etc., especially `'d`.
+4. Contractions are not used. For example, "do not" instead of "don't", "cannot" instead of "can't", etc. especially `'d`.
    - We may encounter difficulties with tenses.
 
 5. However, try using affirmative forms, `Discard` instead of `Do not keep`, `Continue` instead of `Do not stop`, etc.
     - Some languages, such as Japanese, have a different meaning for `yes` and `no` between affirmative and negative questions.
 
-6. Single quotation marks (`'`) are preferred over double quotation marks (`"`) in general documentation text, unless the context requires double quotes (for example, inside JSON code blocks).
+## Terminology
 
-### Terminology
-
-- Boot-up sequence (boot-sequence)
-    - The initialisation process of the plug-in when Obsidian starts. It starts with the loading of the plug-in, setting up core services, loading saved settings, and opening the local database. Once the layout is ready, the plug-in checks for the presence of flag files, runs configuration diagnostics, connects to the remote database, and begins file watching. The sequence finishes once the plug-in is fully ready and operational.
-- Broken files (Size mismatch)
-    - A state where a file's metadata and the actual content stored in its chunks do not match, causing file retrieval or synchronisation failures. These mismatches can be detected and resolved by running validation tools such as `Verify and repair all files` on the Hatch pane.
-- Chunk / Chunks
-    - Divided units of data stored in the database or object storage to facilitate efficient synchronisation.
-- Compaction
-    - A database maintenance procedure that discards old historical document revisions to shrink the remote database size.
-- Custom HTTP Handler / Use Internal API (CORS Bypass Settings)
-    - Settings used to bypass CORS restrictions by routing requests through Obsidian's native request APIs. There are two distinct settings under the hood depending on the remote server type:
-        - **For S3-compatible Object Storage (useCustomRequestHandler)**: Labeled as **"Use Custom HTTP Handler"** in the standard settings tab, **"Use internal API"** in the Svelte-based Setup Wizard dialogue, and represented as `useProxy` in the Setup URI's query parameters due to an unfortunate misunderstanding during development.
-        - **For CouchDB (useRequestAPI)**: Labeled as **"Use Request API to avoid `inevitable` CORS problem"** in the standard settings tab, **"Use Internal API"** in the Svelte-based Setup Wizard dialogue, and represented as `useRequestAPI` in the Setup URI's query parameters.
-- Customisation Sync
-    - The feature that synchronises settings, snippets, themes, and plug-ins. Write with an "s" in documentation (`Customisation`), though technical configurations and links may use `customization`.
-- Database Adapter (IDB vs. IndexedDB)
-    - The local database storage interface used by PouchDB. The `IDB` adapter is recommended since the older `IndexedDB` adapter is obsolete and known to cause memory leaks in `LiveSync` mode. Users can switch between these adapters without a full database rebuild, although a local data migration and an Obsidian restart are required.
-- Database Suffix (additionalSuffixOfDatabaseName)
-    - A unique suffix appended to the database name to allow synchronising multiple vaults with the same name on the same remote server.
-- E2EE Algorithm
-    - The cryptographic algorithm version used for end-to-end encryption. All devices in the synchronisation group must be configured with a compatible version (such as `V2` or `V1`).
-- Eden (Eden Chunks)
-    - A performance optimisation where newly created chunks are held within the document until they stabilise, before graduating to independent chunks.
-- Fast Setup (Simple Fetch)
-    - A simplified, automated initial synchronisation flow triggered when setting up subsequent devices or recovering a database. It bypasses the detailed step-by-step setup wizard dialogues, prompting the user with high-level data processing decisions and completing the initial download and local file scan in one continuous process.
-- Flag files (redflag.md, redflag2.md, redflag3.md)
-    - Special Markdown files (or directories) placed at the root of the vault to stop the boot-up sequence or trigger recovery tasks. For instance, `redflag.md` suspends all processes, while `redflag2.md` (`flag_rebuild.md`) triggers a full database rebuild and `redflag3.md` (`flag_fetch.md`) discards the local database to fetch it again from the remote.
-- Garbage Collection (GC)
-    - The process of identifying and purging unreferenced chunks (unused data) from local and remote databases to reclaim storage space.
-- Hatch (Hatch pane)
-    - A dedicated troubleshooting and maintenance section in the plug-in settings, typically hidden behind a warning-labeled collapsible panel to prevent accidental misconfiguration. It contains diagnostic utilities, database reset controls, status reports, and advanced edge-case patches.
-- Hidden File Sync
-    - The feature that synchronises files located in hidden directories (like `.obsidian`).
-- JWT Authentication
-    - An experimental authentication option for CouchDB allowing secure token-based authentication instead of standard credentials. It requires a configured private key/secret, algorithm, expiration duration, subject, and key ID.
-- LiveSync
-    - A very confusing term.
-        - As a shortened form of `Self-hosted LiveSync`.
-        - As the name of a synchronisation mode. This should be changed to `Continuous`, in contrast to `Periodic`.
-- livesync-serverpeer / webpeer
-    - Pseudo-clients that assist in WebRTC peer-to-peer communication.
-- Metadata (File metadata)
-    - A database document that stores properties of a file, including its filename, path, size, modification time, conflict history, and references (hashes) of the chunks that comprise the file's content. In Self-hosted LiveSync, metadata is stored separately from the actual file content to enable efficient synchronisation and versioning.
-- OneShot Sync
-    - A single, immediate bidirectional synchronisation (pull then push) triggered on demand or on specific events, as opposed to continuous (live) replication.
-- Overwrite Server Data with This Device's Files
-    - A maintenance operation (formerly known as `Rebuild everything`) that discards the remote database and reconstructs it by uploading all current local files as a fresh database, overwriting any remote changes.
-- Path Obfuscation
-    - A privacy option that encrypts file paths and folder names on the remote server.
-- plug-in
-    - We use the hyphenated form `plug-in` in user-facing messages and general documentation, while `plugin` may appear in codebase files, configuration settings, or technical contexts.
-- Relay Server (P2P relays)
-    - A WebSocket-based coordination server used to establish direct WebRTC peer-to-peer connections. The default relay is provided by the plug-in author.
-- Remediation (maxMTimeForReflectEvents)
-    - A recovery setting that restricts the propagation of changes from the database to local storage, ignoring any file events (such as accidental mass deletions) that occurred after a specified date and time.
-- Reset Synchronisation on This Device
-    - A maintenance operation (formerly known as `Fetch everything`) that discards the local database and reconstructs it by downloading all data from the remote server.
-- Scram (Scram Switches)
-    - Emergency controls in the settings that allow users to suspend file watching or database writes to prevent corruption.
-- Segmenter (Segmented-splitter)
-    - A chunking method that divides files on semantic boundaries (such as paragraphs or sections) rather than arbitrary byte boundaries.
 - Self-hosted LiveSync
-    - The name of this plug-in. `Self-hosted` is one word.
-- Setting Doctor (Config Doctor)
-    - A diagnostic utility that checks for mismatches or suboptimal configurations, presenting users with ideal values and recommendation reasons to easily resolve issues during migration, configuration import, or general troubleshooting.
-- Setup URI
-    - An encrypted representation of the plug-in's settings containing server configuration, which allows users to clone their configuration across devices securely using a passphrase.
-- Streaming replication (Stream-based replication)
-    - A data transfer method that downloads database documents as a continuous stream of events. It is significantly faster than traditional chunk-by-chunk HTTP requests and is used during Fast Setup to retrieve remote metadata quickly.
-- Sync Mode
-    - The replication trigger mechanism. Users can select from `On Events` (synchronising on local file changes), `Periodic and Events` (synchronising at fixed intervals as well as on events), or `LiveSync` (continuous, real-time synchronisation).
-- TURN Server (WebRTC P2P)
-    - A server type (Traversal Using Relays around NAT) used as a fallback to relay traffic when direct WebRTC peer-to-peer connection is blocked by strict NAT or firewalls.
-- Update Thinning (Batch database update)
-    - An optimisation that groups multiple local file edits together over a short delay before committing them to the local database, reducing the number of database write operations.
-- WebRTC P2P (Peer-to-Peer)
-    - A synchronisation method enabling direct communication between devices without a central server database.
-
+    - This plug-in name. `Self-hosted` is one word.
+- LiveSync
+    - Very confusing term.
+        - As shorten-form of `Self-hosted LiveSync`.
+        - As a name of synchronisation mode. This should be changed to `Continuos`, in contrast to `Periodic`.

docs/tips/fast-setup.md

@@ -1,65 +0,0 @@
-# Fast Setup (Simple Fetch)
-
-Fast Setup is a streamlined, user-friendly data retrieval and initialisation flow designed to simplify setting up secondary devices or recovering databases. 
-
-Instead of guiding the user through the detailed multi-step setup wizard dialogues, Fast Setup prompts the user with high-level sync decisions and automates database download and local storage scanning in one continuous process.
-
----
-
-## How It Works
-
-When you import a **Setup URI** on a secondary device, or when a **Fetch All** operation is triggered (such as by placing a `redflag3.md` / `flag_fetch.md` flag file at the root of the vault), the plug-in schedules remote data retrieval.
-
-On the next startup, the plug-in boots in scheduled fetch mode and opens a simplified dialogue: **"Data retrieval scheduled"**.
-
----
-
-## Technical Characteristics
-
-Fast Setup leverages several backend optimisations to make the retrieval fast, safe, and clean:
-
-1. **Stream-based Replication for Speed**
-   - It fetches all remote metadata via stream reception, which is significantly faster than traditional chunk-by-chunk retrieval.
-2. **Delayed File Reflection to Prevent Corrupted Warnings**
-   - By suspending file reflection during the download phase, it prevents the plug-in from raising temporary or false "corrupted data synchronisation" or "size mismatch" warnings that can occur during the chunk download process.
-3. **Time-Based Comparison is Generally Sufficient**
-   - Since the vault is entering a fresh synchronisation or recovery state, comparing files based on their modification timestamps (newer-wins) is highly reliable and sufficient to reconcile files without needing complex manual conflict resolution.
-
----
-
-## Step-by-Step Guide
-
-### Step 1: Choose Data Processing Method
-You will be prompted to choose how the retrieved remote data will interact with your existing local files:
-
-1. **Compare time and take newer (newer-wins)**
-   - Compares the modified time of files and accepts the newer version.
-   - **Recommended if:** You have been using Self-hosted LiveSync and have made changes on multiple devices that you want to merge.
-2. **Overwrite all with remote files (remote-wins)**
-   - Remote data is treated as the source of truth.
-   - **Recommended if:** You are setting up a brand new device with an empty or clean vault.
-   - *Warning: This will overwrite local files with remote files. Please ensure you have a backup of your local vault before proceeding.*
-3. **Use the detailed flow (legacy)**
-   - Switches back to the detailed, traditional setup wizard dialogues.
-   - **Recommended if:** You want full control over the step-by-step database setup options.
-
-### Step 2: Configure Conflict & Deletion Rules
-Depending on your choice in Step 1, you will configure how to handle mismatches:
-
-#### If you chose "Compare time and take newer":
-- **Delete local files if they were deleted on remote**
-  - Keeps your local vault clean by removing files that have already been deleted on other devices.
-- **Recreate remote files even if they were deleted on remote**
-  - Preserves local files and uploads them back to the remote database, even if they were deleted on other devices.
-
-#### If you chose "Overwrite all with remote files":
-- **Delete local files if not on remote**
-  - Removes local-only files so that your local vault matches the remote database exactly.
-- **Keep local files even if not on remote**
-  - Retains all existing local-only files, although this may result in duplicates that you will need to clean up manually after synchronisation.
-
-### Step 3: Automated Synchronisation
-Once you confirm your choices:
-1. The plug-in performs a fast download of the remote database (`fetchLocalDBFast`).
-2. It automatically runs a full scan (`synchroniseAllFilesBetweenDBandStorage`) in the foreground to reflect database changes in your local vault files immediately.
-3. The plug-in finalises the process and resumes normal operational status.

docs/tips/fast-setup_ja.md

@@ -1,66 +0,0 @@
-# ファストセットアップ (Fast Setup / Simple Fetch)
-
-ファストセットアップは、2台目以降のデバイスのセットアップやデータベース再構築時のデータ取得・初期化処理を、直感的かつ迅速に行うための簡略化された同期フローです。
-
-従来のセットアップウィザードにおける複数の詳細なステップを踏むことなく、同期の基本方針を選択するだけで、データベースのダウンロードとローカルファイルのスキャン・反映を一連のプロセスとして自動的に実行します。
-
----
-
-## 仕組み
-
-2台目以降のデバイスで **セットアップURI** をインポートした場合や、手動でデータの再フェッチ（Vaultルートに `redflag3.md` / `flag_fetch.md` を配置する等）が予約された場合、プラグインはリモートデータベースからのデータ取得スケジュールを設定します。
-
-その後の起動時、プラグインはデータフェッチ予約モードで立ち上がり、**「Data retrieval scheduled（データ取得のスケジュール）」** という簡略化されたダイアログを表示します。
-
----
-
-## 技術的な特徴
-
-ファストセットアップは、高速かつ安全でクリーンな処理を実現するために、以下の最適化を行っています。
-
-1. **高速なストリーム受信**
-   - 全データを取得しますが、ストリーム受信によるレプリケーションを使用するため、処理が非常に高速です。
-2. **ストレージ反映の遅延による不要な警告の抑制**
-   - データのダウンロード中にローカルファイル（ストレージ）への書き出し（反映）処理をあえて遅延させることで、同期途中で発生しがちな「破損データ同期」や「サイズ不一致」などの一時的なエラー警告を抑え込みます。
-   - すべてのデータダウンロードが完了した後に一括してストレージへ書き出すため、不必要な警告画面でユーザーを混乱させません。
-3. **時刻ベース比較の妥当性**
-   - 初期セットアップやリカバリーの段階（この状態に移行した直後）においては、概ねファイル更新時刻（タイムスタンプ）ベースでの単純比較を行うことで、十分かつ妥当な同期結果を得ることができます。これにより複雑な競合解決の手間を省きます。
-
----
-
-## 設定手順
-
-### ステップ 1: データの反映方法の選択
-取得したリモートデータを、既存のローカルファイルとどのように統合するかを選択します。
-
-1. **Compare time and take newer (newer-wins)**
-   - ファイルの更新日時を比較し、より新しい方を採用します。
-   - **推奨されるケース:** すでに Self-hosted LiveSync を使用しており、複数のデバイスで編集した変更内容をタイムスタンプに基づいて統合したい場合。
-2. **Overwrite all with remote files (remote-wins)**
-   - リモートデータベースの内容を正（Source of Truth）として扱います。
-   - **推奨されるケース:** まったく新しいデバイスをセットアップする場合（空のVaultなど）。
-   - *警告: ローカルにあるすべてのファイルがリモートの内容で上書きされます。重要なデータがある場合は、事前にバックアップを取得してください。*
-3. **Use the detailed flow (legacy)**
-   - 従来の詳細なセットアップウィザードダイアログに戻ります。
-   - **推奨されるケース:** データベースの構成オプションをステップバイステップで細かく制御・確認したい場合。
-
-### ステップ 2: 競合および削除ルールの構成
-ステップ 1 での選択内容に応じて、ローカルとリモートの不一致をどう処理するかを設定します。
-
-#### 「Compare time and take newer」を選択した場合:
-- **Delete local files if they were deleted on remote**
-  - 他のデバイスで削除済みのファイルをローカルからも削除し、Vaultを同期・クリーンな状態に保ちます。
-- **Recreate remote files even if they were deleted on remote**
-  - 他のデバイスで削除されたファイルであっても、ローカルファイルを維持し、リモートデータベースに再度アップロードします。
-
-#### 「Overwrite all with remote files」を選択した場合:
-- **Delete local files if not on remote**
-  - リモートに存在しないローカル専用ファイルを削除し、ローカルのVaultをリモートデータベースと完全に一致させます。
-- **Keep local files even if not on remote**
-  - リモートに存在しないローカルファイルをそのまま残します。ただし、同期後に重複ファイルが発生する可能性があるため、その場合は手動でクリーンアップを行ってください。
-
-### ステップ 3: 自動同期の実行
-選択を確定すると、以下の処理が順次実行されます。
-1. リモートデータベースの高速ダウンロードを実行します (`fetchLocalDBFast`)。
-2. ローカルファイルへの変更反映のため、フォアグラウンドでフルスキャン (`synchroniseAllFilesBetweenDBandStorage`) を自動的に実行します。
-3. 処理が完了すると、プラグインは通常の動作状態へ復帰します。

docs/troubleshooting.md

@@ -224,7 +224,7 @@ There are many cases where this is really unclear. One possibility is that the c
     - If you know when the files were deleted, set the time a bit before that.
     - If not, bisecting may help us.
 6. Delete `redflag.md`.
-7. Perform `Reset Synchronisation on This Device` on the `🎛️ Maintenance` pane.
+7. Perform `Reset synchronisation on This Device` on the `🎛️ Maintenance` pane.
 
 This mode is very fragile. Please be careful.
 
@@ -236,16 +236,16 @@ not been stable. The new adapter has better performance and has a new feature
 like purging. Therefore, we should use new adapters and current default is so.
 
 However, when switching from an old adapter to a new adapter, some converting or
-local database rebuilding is required, and it takes some time. It was a long
+local database rebuilding is required, and it takes a few time. It was a long
 time ago now, but we once inconvenienced everyone in a hurry when we changed the
 format of our database. For these reasons, this toggle is automatically on if we
 have upgraded from vault which using an old adapter.
 
-When you overwrite server data with this device's files or reset synchronisation on this device again, you will be asked to
+When you rebuild everything or fetch from the remote again, you will be asked to
 switch this.
 
 Therefore, experienced users (especially those stable enough not to have to
-overwrite server data) may have this toggle enabled in their Vault. Please
+rebuild the database) may have this toggle enabled in their Vault. Please
 disable it when you have enough time.
 
 ### ZIP (or any extensions) files were not synchronised. Why?
@@ -255,20 +255,14 @@ It depends on Obsidian detects. May toggling `Detect all extensions` of
 
 ### I hope to report the issue, but you said you needs `Report`. How to make it?
 
-We can copy the report to the clipboard, by performing 
-`Generate full report for opening the issue with debug info` command!
+We can copy the report to the clipboard, by pressing the `Make report` button on
+the `Hatch` pane. ![Screenshot](../images/hatch.png)
 
 ### Where can I check the log?
 
 We can launch the log pane by `Show log` on the command palette. And if you have
 troubled something, please enable the `Verbose Log` on the `General Setting`
 pane.
-`Generate full report for opening the issue with debug info` command also contains 
-the recent 1000 log lines, which is very helpful for debugging. Full-report is 
-already set to the verbose level, so it contains all the logs without enabling the 
-`Verbose Log` toggle.
-
-Let me note that please be sure to remove any sensitive information before sharing the report.
 
 However, the logs would not be kept so long and cleared when restarted. If you
 want to check the logs, please enable `Write logs into the file` temporarily.
@@ -303,9 +297,9 @@ happened on other devices. This means that conflicts will happen in the past,
 after the time we have synchronised. Hence we cannot collect and delete the
 unused chunks even though if we are not currently referenced.
 
-To shrink the database size, `Overwrite Server Data with This Device's Files` is the only reliable and effective way.
+To shrink the database size, `Rebuild everything` only reliably and effectively.
 But do not worry, if we have synchronised well. We have the actual and real
-files. Only it takes a bit of time and traffic.
+files. Only it takes a bit of time and traffics.
 
 ### How to launch the DevTools
 
@@ -373,64 +367,47 @@ without Obsidian.
 For example, if there is `redflag.md`, Self-hosted LiveSync suspends all database and storage
 processes.
 
-### Scram State and Flag Files (SCRAM Warning Loop)
+### Flag Files
 
-The plug-in uses a **Scram state** (emergency suspension of all synchronisation processes) to prevent database corruption when severe errors or conflicts are detected. This state is often triggered or persisted by **flag files** placed at the root of the vault.
+The flag file is a simple Markdown file designed to prevent storage events and database events in self-hosted LiveSync.
+Its very existence is significant; it may be left blank, or it may contain text; either is acceptable.
 
-If you encounter a warning saying **"Scram detected, all sync operations are suspended per SCRAM"** or get caught in an infinite loop where the warning persists even after clicking "Resume", it is likely due to a flag file in your vault.
+This file is in Markdown format so that it can be placed in the Vault externally, even if Obsidian fails to launch.
 
-#### Flag Files
+There are some options to use `redflag.md`.
 
-A flag file is a simple Markdown file located at the root of your vault. Its very existence is significant; it may be left blank or contain any text. These files are used so they can be easily placed or deleted from outside Obsidian (e.g., when Obsidian fails to launch).
+| Filename      | Human-Friendly Name | Description                                                                          |
+| ------------- | ------------------- | ------------------------------------------------------------------------------------ |
+| `redflag.md`  | -                   | Suspends all processes.                                                              |
+| `redflag2.md` | `flag_rebuild.md`   | Suspends all processes, and rebuild both local and remote databases by local files.  |
+| `redflag3.md` | `flag_fetch.md`     | Suspends all processes, discard the local database, and fetch from the remote again. |
 
-| Filename      | Human-Friendly Name | Description                                                                             |
-| ------------- | ------------------- | --------------------------------------------------------------------------------------- |
-| `redflag.md`  | -                   | Suspends all processes (activates Scram).                                               |
-| `redflag2.md` | `flag_rebuild.md`   | Suspends all processes, and overwrites server data with this device's files.           |
-| `redflag3.md` | `flag_fetch.md`     | Suspends all processes, discards the local database, and resets synchronisation on this device. |
+When fetching everything remotely or performing a rebuild, restarting Obsidian
+is performed once for safety reasons. At that time, Self-hosted LiveSync uses
+these files to determine whether the process should be carried out. (The use of
+normal markdown files is a trick to externally force cancellation in the event
+of faults in the rebuild or fetch function itself, especially on mobile
+devices). This mechanism is also used for set-up. And just for information,
+these files are also not subject to synchronisation.
 
-When resetting synchronisation on this device or overwriting server data, restarting Obsidian is performed once for safety reasons. At that time, Self-hosted LiveSync uses these files to determine whether the process should be carried out. (This mechanism is especially useful on mobile devices to force cancellation if the database rebuilding fails). These files are not subject to synchronisation.
-
-#### How to Resolve the Scram Loop
-
-If you cannot disable Scram, please follow these steps:
-1. Close Obsidian completely.
-2. Open your system's file manager and check the root directory of your vault.
-3. Locate and delete any flag files (such as `redflag.md`, `redflag2.md`, or `redflag3.md`).
-4. Launch Obsidian.
-5. Go to the settings dialogue -> **Hatch** -> **Scram Switches**, and manually toggle **Suspend file watching** and **Suspend database reflecting** to `false` (disabled) if they have not been reset automatically.
-
-> [!TIP]
-> This is the reason why flag files are standard `.md` files: it allows you to manage them externally. On mobile devices, you can use system file manager applications (such as the native **Files** app on iOS/iPadOS or **Files by Google** on Android) to find and delete these files to resolve a lock, or conversely, create/place a new `redflag.md` file (or directory) at the root of your vault to force-suspend synchronisation and stop Obsidian's boot-up sequence if you need to fix a database issue.
-
-### JWT Authentication Errors
-
-#### DataError when configuring JWT authentication
-
-If you encounter a `DataError:` with no additional information in the logs when configuring JWT authentication, this usually indicates a private key formatting issue.
-
-Self-hosted LiveSync requires the private key (for ES256/ES512 algorithms) to be in the **PKCS#8 PEM** format. Standard SEC1 EC private keys (which begin with `-----BEGIN EC PRIVATE KEY-----`) will trigger this error.
-
-To resolve this, convert your private key to PKCS#8 format using the following `openssl` command:
-```bash
-openssl pkcs8 -topk8 -inform PEM -nocrypt -in private.key -out pkcs8.key
-```
-Then paste the contents of `pkcs8.key` (which begins with `-----BEGIN PRIVATE KEY-----`) into the JWT Key field.
+However, occasionally the deletion of files may fail. This should generally work
+normally after restarting Obsidian. (As far as I can observe).
 
 ### Old tips
 
-- Rarely, a file in the database could be corrupted. The plug-in will not write
+- Rarely, a file in the database could be corrupted. The plugin will not write
   to local storage when a file looks corrupted. If a local version of the file
   is on your device, the corruption could be fixed by editing the local file and
-  synchronising it. But if the file does not exist on any of your devices, then
+  synchronizing it. But if the file does not exist on any of your devices, then
   it can not be rescued. In this case, you can delete these items from the
-  settings dialogue.
+  settings dialog.
 - To stop the boot-up sequence (eg. for fixing problems on databases), you can
   put a `redflag.md` file (or directory) at the root of your vault. Tip for iOS:
   a redflag directory can be created at the root of the vault using the File
   application.
-- Also, with `redflag2.md` placed, we can automatically overwrite server data with this device's files during the boot-up sequence. With `redflag3.md`, we
-  can discard only the local database and reset synchronisation on this device.
+- Also, with `redflag2.md` placed, we can automatically rebuild both the local
+  and the remote databases during the boot-up sequence. With `redflag3.md`, we
+  can discard only the local database and fetch from the remote again.
 - Q: The database is growing, how can I shrink it down? A: each of the docs is
   saved with their past 100 revisions for detecting and resolving conflicts.
   Picturing that one device has been offline for a while, and comes online
@@ -442,7 +419,7 @@ Then paste the contents of `pkcs8.key` (which begins with `-----BEGIN PRIVATE KE
   So, We have to make the database again like an enlarged git repo if you want
   to solve the root of the problem.
 - And more technical Information is in the [Technical Information](tech_info.md)
-- If you want to synchronise files without obsidian, you can use
+- If you want to synchronize files without obsidian, you can use
   [filesystem-livesync](https://github.com/vrtmrz/filesystem-livesync).
 - WebClipper is also available on Chrome Web
   Store:[obsidian-livesync-webclip](https://chrome.google.com/webstore/detail/obsidian-livesync-webclip/jfpaflmpckblieefkegjncjoceapakdf)

esbuild.config.mjs

@@ -2,6 +2,7 @@
 
 import esbuild from "esbuild";
 import process from "process";
+import builtins from "builtin-modules";
 import sveltePlugin from "esbuild-svelte";
 import { sveltePreprocess } from "svelte-preprocess";
 import fs from "node:fs";

eslint.config.mjs

@@ -1,134 +1,102 @@
+import typescriptEslint from "@typescript-eslint/eslint-plugin";
+import svelte from "eslint-plugin-svelte";
+import _import from "eslint-plugin-import";
+import { fixupPluginRules } from "@eslint/compat";
 import tsParser from "@typescript-eslint/parser";
-import obsidianmd from "eslint-plugin-obsidianmd";
-import globals from "globals";
-import { defineConfig, globalIgnores } from "eslint/config";
-import * as sveltePlugin from "eslint-plugin-svelte";
-import svelteParser from "svelte-eslint-parser";
-const warnWhileDev = "off"; // Change to "warn" to enable warnings for rules that are currently disabled.
-export default defineConfig([
-    globalIgnores([
-        // Build outputs and legacy files
-        "**/build",
-        "coverage",
-        "**/main.js",
-        "main_org.js",
-        "pouchdb-browser.js",
-        "version-bump.mjs",
-        "package.json",
-        "**/*.json",
-        "**/.eslintrc.js.bak",
-        // Files from linked dependencies (those files should not exist for most people).
-        "modules/octagonal-wheels/dist/**/*",
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import js from "@eslint/js";
+import { FlatCompat } from "@eslint/eslintrc";
 
-        // Sub-projects (Exclude from root linting as they have different environments)
-        "src/apps/**/*",
-        "utils/**/*",
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const compat = new FlatCompat({
+    baseDirectory: __dirname,
+    recommendedConfig: js.configs.recommended,
+    allConfig: js.configs.all,
+});
 
-        // Specific exclusions from common library (src/lib)
-        "src/lib/coverage",
-        "src/lib/browsertest",
-        "src/lib/test",
-        "src/lib/_tools",
-        "src/lib/src/patches/pouchdb-utils",
-        "src/lib/src/cli",
-        "src/lib/src/services/implements/browser/**",
-        "src/lib/src/services/implements/headless/**",
-        "src/lib/src/API",
-
-        // Config files and build scripts
-        "**/jest.config.js",
-        "**/rollup.config.js",
-        "**/esbuild.config.mjs",
-        "**/terser.*.mjs",
-        ".prettierrc.*.mjs",
-        ".prettierrc.mjs",
-        "*.config.mjs",
-        "vite.*",
-        "vitest.*",
-        // Testing files (Simplified patterns)
-        "test/**",
-        "**/*.test.ts",
-        "**/*.unit.spec.ts",
-        "**/test.ts",
-        "**/tests.ts",
-    ]),
-    ...sveltePlugin.configs["flat/base"],
-    ...obsidianmd.configs.recommended,
+export default [
     {
-        files: ["**/*.ts"],
-        // ignores:["src/lib/**/*.ts"], // Exclude library files from root linting (they have different environments and rules).
+        ignores: [
+            "**/node_modules/*",
+            "**/jest.config.js",
+            "src/lib/coverage",
+            "src/lib/browsertest",
+            "**/test.ts",
+            "**/tests.ts",
+            "**/**test.ts",
+            "**/**.test.ts",
+            "**/esbuild.*.mjs",
+            "**/terser.*.mjs",
+            "**/node_modules",
+            "**/build",
+            "**/.eslintrc.js.bak",
+            "src/lib/src/patches/pouchdb-utils",
+            "**/esbuild.config.mjs",
+            "**/rollup.config.js",
+            "modules/octagonal-wheels/rollup.config.js",
+            "modules/octagonal-wheels/dist/**/*",
+            "src/lib/test",
+            "src/lib/src/cli",
+            "**/main.js",
+            "src/apps/**/*",
+            ".prettierrc.*.mjs",
+            ".prettierrc.mjs",
+            "*.config.mjs"
+        ],
+    },
+    ...compat.extends(
+        "eslint:recommended",
+        "plugin:@typescript-eslint/eslint-recommended",
+        "plugin:@typescript-eslint/recommended"
+    ),
+    {
+        plugins: {
+            "@typescript-eslint": typescriptEslint,
+            svelte,
+            import: fixupPluginRules(_import),
+        },
+
         languageOptions: {
-            globals: { ...globals.browser, PouchDB: "readonly" },
             parser: tsParser,
+            ecmaVersion: 5,
+            sourceType: "module",
+
             parserOptions: {
-                project: "./tsconfig.json",
+                project: ["tsconfig.json"],
             },
         },
-        linterOptions:{
-            reportUnusedDisableDirectives: false,
-        },
+
         rules: {
-            // -- Base rules (turned off in favour of TS specific versions or explicitly disabled).
             "no-unused-vars": "off",
+
+            "@typescript-eslint/no-unused-vars": [
+                "error",
+                {
+                    args: "none",
+                },
+            ],
+
             "no-unused-labels": "off",
-            "no-prototype-builtins": "off",
-            "require-await": "off",
-            // -- TypeScript specific rules
-            //  @typescript-eslint/no-unsafe-* rules and @typescript-eslint/no-explicit-any:
-            //  This project contains a lot of library-sh code where the use of `any` is often necessary and justified.
-            //  Rules is now set to 'off' for a while.
-            "@typescript-eslint/no-explicit-any": "off",
-            "@typescript-eslint/no-unsafe-argument": "off",
-            "@typescript-eslint/no-unsafe-call": "off",
-            "@typescript-eslint/no-unsafe-member-access": "off",
-            "@typescript-eslint/no-unsafe-return": "off",
-            "@typescript-eslint/no-unsafe-assignment": "off",
-            // -- Reasonable rules.
-            "@typescript-eslint/no-deprecated": warnWhileDev,
-            "@typescript-eslint/no-unused-vars": ["error", { args: "none" }],
             "@typescript-eslint/ban-ts-comment": "off",
+            "no-prototype-builtins": "off",
             "@typescript-eslint/no-empty-function": "off",
-            "@typescript-eslint/require-await": "error",
-            "@typescript-eslint/no-misused-promises": "error",
-            "@typescript-eslint/no-floating-promises": "error",
+            "require-await": "error",
+            "@typescript-eslint/require-await": "warn",
+            "@typescript-eslint/no-misused-promises": "warn",
+            "@typescript-eslint/no-floating-promises": "warn",
+            "no-async-promise-executor": "warn",
+            "@typescript-eslint/no-explicit-any": "off",
             "@typescript-eslint/no-unnecessary-type-assertion": "error",
 
-            // -- Obsidian rules
-            // obsidianmd/no-unsupported-api: usually this project checks for API support at runtime, so this rule is not critical but can be helpful to catch potential issues.
-            "obsidianmd/no-unsupported-api": warnWhileDev,
-
-            // -- General rules
-            "no-async-promise-executor": warnWhileDev,
-            "no-constant-condition": ["error", { checkLoops: false }],
-            // -- Disabled rules
-            // no-undef: This option breaks the global declarations for the library files and is not worth the effort to fix at this time.
-            "no-undef": "off",
-
-            // -- Plugin specific overrides
-            "obsidianmd/rule-custom-message": "off",
-            "obsidianmd/ui/sentence-case": "off",
-            "obsidianmd/no-plugin-as-component": "off",
-
-            // -- Temporary overrides for migration
-            "obsidianmd/no-static-styles-assignment": "off",
+            "no-constant-condition": [
+                "error",
+                {
+                    checkLoops: false,
+                },
+            ],
         },
     },
-    {
-        files: ["**/*.svelte"],
-        languageOptions: {
-            parser: svelteParser,
-            parserOptions: {
-                parser: tsParser,
-                extraFileExtensions: [".svelte"],
-            },
-        },
-        rules: {
-            // no-unused-vars:
-            // Svelte template's declarations have a lot of false positives and the rule is not worth the effort to fix at this time.
-            // it may improve in the future with some options as like   ["error", { argsIgnorePattern: "^_", varsIgnorePattern: "^_" }],]
-            "no-unused-vars": "off",
-            "obsidianmd/no-plugin-as-component": "off",
-            "obsidianmd/ui/sentence-case": "off",
-        },
-    },
-]);
+];
+

manifest.json

@@ -1,8 +1,8 @@
 {
     "id": "obsidian-livesync",
     "name": "Self-hosted LiveSync",
-    "version": "0.25.74",
-    "minAppVersion": "1.7.2",
+    "version": "0.25.60",
+    "minAppVersion": "0.9.12",
     "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",
     "authorUrl": "https://github.com/vrtmrz",

package.json

@@ -1,6 +1,6 @@
 {
     "name": "obsidian-livesync",
-    "version": "0.25.74",
+    "version": "0.25.60",
     "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",
@@ -19,13 +19,13 @@
         "buildVite": "npx dotenv-cli -e .env  -- vite build --mode production",
         "buildViteOriginal": "npx dotenv-cli -e .env  -- vite build --mode original",
         "buildDev": "node esbuild.config.mjs dev",
-        "lint": "eslint --cache --concurrency auto src",
+        "lint": "eslint src",
         "svelte-check": "svelte-check --tsconfig ./tsconfig.json",
         "tsc-check": "tsc --noEmit",
         "pretty": "npm run prettyNoWrite -- --write --log-level error",
         "prettyCheck": "npm run prettyNoWrite -- --check",
         "prettyNoWrite": "prettier --config ./.prettierrc.mjs \"**/*.js\" \"**/*.ts\" \"**/*.json\" ",
-        "check": "npm run tsc-check && npm run lint && npm run svelte-check",
+        "check": "npm run lint && npm run svelte-check",
         "unittest": "deno test -A --no-check --coverage=cov_profile  --v8-flags=--expose-gc  --trace-leaks  ./src/",
         "test": "vitest run",
         "test:unit": "vitest run --config vitest.config.unit.ts",
@@ -54,21 +54,21 @@
         "test:docker-all:start": "npm run test:docker-all:up && sleep 5 && npm run test:docker-all:init",
         "test:docker-all:stop": "npm run test:docker-all:down",
         "test:full": "npm run test:docker-all:start && vitest run --coverage && npm run test:docker-all:stop",
-        "test:p2p": "bash test/suitep2p/run-p2p-tests.sh",
-        "version": "node version-bump.mjs && git add manifest.json versions.json"
+        "test:p2p": "bash test/suitep2p/run-p2p-tests.sh"
     },
     "keywords": [],
     "author": "vorotamoroz",
     "license": "MIT",
     "devDependencies": {
         "@chialab/esbuild-plugin-worker": "^0.19.0",
+        "@eslint/compat": "^2.0.2",
+        "@eslint/eslintrc": "^3.3.4",
         "@eslint/js": "^9.39.3",
         "@sveltejs/vite-plugin-svelte": "^6.2.4",
         "@tsconfig/svelte": "^5.0.8",
         "@types/deno": "^2.5.0",
         "@types/diff-match-patch": "^1.0.36",
         "@types/markdown-it": "^14.1.2",
-        "@types/micromatch": "^4.0.10",
         "@types/node": "^24.10.13",
         "@types/pouchdb": "^6.4.2",
         "@types/pouchdb-adapter-http": "^6.1.6",
@@ -80,18 +80,21 @@
         "@types/transform-pouch": "^1.0.6",
         "@typescript-eslint/eslint-plugin": "8.56.1",
         "@typescript-eslint/parser": "8.56.1",
-        "@vitest/browser": "^4.1.8",
-        "@vitest/browser-playwright": "^4.1.8",
-        "@vitest/coverage-v8": "^4.1.8",
+        "@vitest/browser": "^4.1.1",
+        "@vitest/browser-playwright": "^4.1.1",
+        "@vitest/coverage-v8": "^4.1.1",
+        "builtin-modules": "5.0.0",
+        "dotenv": "^17.3.1",
         "dotenv-cli": "^11.0.0",
         "esbuild": "0.25.0",
         "esbuild-plugin-inline-worker": "^0.1.1",
         "esbuild-svelte": "^0.9.4",
         "eslint": "^9.39.3",
-        "eslint-plugin-obsidianmd": "^0.3.0",
+        "eslint-plugin-import": "^2.32.0",
         "eslint-plugin-svelte": "^3.15.0",
         "events": "^3.3.0",
-        "globals": "^14.0.0",
+        "glob": "^13.0.6",
+        "obsidian": "^1.12.3",
         "playwright": "^1.58.2",
         "postcss": "^8.5.6",
         "postcss-load-config": "^6.0.1",
@@ -112,14 +115,13 @@
         "svelte-check": "^4.4.3",
         "svelte-preprocess": "^6.0.3",
         "terser": "^5.39.0",
-        "tinyglobby": "^0.2.15",
         "transform-pouch": "^2.0.0",
         "tslib": "^2.8.1",
         "tsx": "^4.21.0",
         "typescript": "5.9.3",
         "vite": "^7.3.1",
         "vite-plugin-istanbul": "^8.0.0",
-        "vitest": "^4.1.8",
+        "vitest": "^4.1.1",
         "webdriverio": "^9.27.0",
         "yaml": "^2.8.2"
     },
@@ -130,21 +132,17 @@
         "@smithy/middleware-apply-body-checksum": "^4.3.9",
         "@smithy/protocol-http": "^5.3.9",
         "@smithy/querystring-builder": "^4.2.9",
-        "@smithy/util-retry": "^4.4.5",
-        "@trystero-p2p/nostr": "^0.24.0",
-        "chokidar": "^4.0.0",
+        "@trystero-p2p/nostr": "^0.23.0",
         "commander": "^14.0.3",
         "diff-match-patch": "^1.0.5",
         "fflate": "^0.8.2",
         "idb": "^8.0.3",
         "markdown-it": "^14.1.1",
-        "micromatch": "^4.0.0",
         "minimatch": "^10.2.2",
-        "obsidian": "^1.12.3",
-        "octagonal-wheels": "^0.1.46",
+        "octagonal-wheels": "^0.1.45",
         "pouchdb-adapter-leveldb": "^9.0.0",
         "qrcode-generator": "^1.4.4",
-        "werift": "^0.23.0",
+        "werift": "^0.22.9",
         "xxhash-wasm-102": "npm:xxhash-wasm@^1.0.2"
     }
 }

src/LiveSyncBaseCore.ts

@@ -1,5 +1,4 @@
 import { LOG_LEVEL_INFO } from "octagonal-wheels/common/logger";
-import type PouchDB from "pouchdb-core";
 import type { SimpleStore } from "octagonal-wheels/databases/SimpleStoreBase";
 import type { HasSettings, ObsidianLiveSyncSettings, EntryDoc } from "./lib/src/common/types";
 import { __$checkInstanceBinding } from "./lib/src/dev/checks";
@@ -124,7 +123,7 @@ export class LiveSyncBaseCore<
         for (const module of this.modules) {
             if (module.constructor === constructor) return module as T;
         }
-        throw new Error(`Module ${constructor.name} not found or not loaded.`);
+        throw new Error(`Module ${constructor} not found or not loaded.`);
     }
 
     /**
@@ -161,10 +160,8 @@ export class LiveSyncBaseCore<
                 module.onBindFunction(this, this.services);
                 __$checkInstanceBinding(module); // Check if all functions are properly bound, and log warnings if not.
             } else {
-                // module should not be never.
-                const moduleName = (module as unknown)?.constructor?.name ?? "unknown";
                 this.services.API.addLog(
-                    `Module ${moduleName} does not have onBindFunction, skipping binding.`,
+                    `Module ${(module as any)?.constructor?.name ?? "unknown"} does not have onBindFunction, skipping binding.`,
                     LOG_LEVEL_INFO
                 );
             }

src/apps/cli/.gitignore

@@ -3,7 +3,4 @@ test/*
 !test/*.sh
 test/test-init.local.sh
 node_modules
-.*.json
-*.env
-!.test.env
-bench-results
+.*.json

src/apps/cli/Dockerfile

@@ -60,7 +60,7 @@ RUN apt-get update \
 WORKDIR /build
 
 # Install workspace dependencies first (layer-cache friendly)
-COPY package.json package-lock.json ./
+COPY package.json ./
 RUN npm install
 
 # Copy the full source tree and build the CLI bundle

src/apps/cli/README.md

@@ -61,9 +61,6 @@ livesync-cli [database-path] [command] [args...]
 
 - `database-path`: Path to the directory where `.livesync` folder and `settings.json` are (or will be) located.
     - Note: In previous versions, this was referred to as the "vault" path. Now it is clearly distinguished from the actual vault (the directory containing your `.md` files).
-- `--vault <path>` / `-V <path>`: (daemon/mirror only) Path to the vault directory containing `.md` files.
-    - Allows the PouchDB database directory and the actual vault directory to be different locations.
-    - For `mirror` command, the positional `[vault-path]` argument takes precedence over `--vault`.
 
 ### Commands
 
@@ -77,16 +74,6 @@ livesync-cli [database-path] [command] [args...]
 - `pull <src> <dst>`: Pull a file `<src>` from the database into local file `<dst>`.
 - `cat <src>`: Read a file from the database and write to stdout.
 - `put <dst>`: Read from stdin and write to the database path `<dst>`.
-- `remote-add <name> <connstr>`: Add a remote configuration from a connection string.
-- `remote-rm <remote-id>`: Remove a remote configuration by ID.
-- `remote-ls`: List remote configurations (`id`, `name`, `active/inactive`, redacted URI).
-- `remote-export <remote-id>`: Export the stored connection string by remote ID.
-- `remote-set <remote-id> <connstr>`: Replace the stored connection string by remote ID.
-- `remote-activate <remote-id>`: Activate a remote configuration by ID.
-- `mark-resolved [remote-id]`: Resolve remote synchronisation status.
-- `unlock-remote [remote-id]`: Unlock the remote database.
-- `lock-remote [remote-id]`: Lock the remote database.
-- `remote-status [remote-id]`: Show remote database status.
 - `init-settings [file]`: Create a default settings file.
 
 ### Examples
@@ -108,24 +95,13 @@ livesync-cli ./my-db pull folder/note.md ./note.md
 ### Build from source
 
 ```bash
-# Clone with submodules, because the shared core lives in src/lib
-git clone --recurse-submodules <repository-url>
-cd obsidian-livesync
-
-# If you already cloned without submodules, run this once instead
-git submodule update --init --recursive
-
-# Install dependencies from the repository root
+# Install dependencies (ensure you are in repository root directory, not src/apps/cli)
+# due to shared dependencies with webapp and main library
 npm install
-
-# Build the CLI from its package directory
-cd src/apps/cli
+# Build the project (ensure you are in `src/apps/cli` directory)
 npm run build
 ```
 
-If `src/lib` is missing, `npm run build` now stops early with a targeted message
-instead of a low-level Vite `ENOENT` error.
-
 Run the CLI:
 
 ```bash
@@ -265,20 +241,6 @@ livesync-cli /path/to/your-local-database --settings /path/to/settings.json rm /
 
 # Resolve conflict by keeping a specific revision
 livesync-cli /path/to/your-local-database --settings /path/to/settings.json resolve /vault/path/file.md 3-abcdef
-
-# Add, list, activate, and remove remote configurations
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json remote-add main "sls+https://user:pass@example.com/db"
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json remote-ls
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json remote-export remote-abc123
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json remote-set remote-abc123 "sls+p2p://room-abc?passphrase=secret"
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json remote-activate remote-abc123
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json remote-rm remote-abc123
-
-# Lock, unlock, resolve, and view status of remote database
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json remote-status remote-abc123
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json lock-remote remote-abc123
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json mark-resolved remote-abc123
-livesync-cli /path/to/your-local-database --settings /path/to/settings.json unlock-remote remote-abc123
 ```
 
 ### Configuration
@@ -324,12 +286,9 @@ Options:
   --force, -f             Overwrite existing file on init-settings
   --verbose, -v           Enable verbose logging
   --debug, -d             Enable debug logging (includes verbose)
-  --interval <N>, -i <N>  (daemon only) Poll CouchDB every N seconds instead of using the _changes feed
-  --vault <path>, -V <path>  (daemon/mirror) Path to vault directory, decoupled from database-path
-  --help, -h              Show this help message
+  --help, -h              Show help message
 
 Commands:
-  daemon                  (default) Run mirror scan then continuously sync CouchDB <-> local filesystem
   init-settings [path]    Create settings JSON from DEFAULT_SETTINGS
   sync                    Run one replication cycle and exit
   p2p-peers <timeout>     Show discovered peers as [peer]<TAB><peer-id><TAB><peer-name>
@@ -346,8 +305,7 @@ Commands:
   info <path>             Show file metadata including current and past revisions, conflicts, and chunk list
   rm <path>               Mark file as deleted in local database
   resolve <path> <rev>    Resolve conflict by keeping the specified revision
-  mirror [vaultPath]      Mirror database contents to the local file system
-                           (vaultPath positional arg > --vault flag > database-path)
+  mirror [vaultPath]      Mirror database contents to the local file system (vaultPath defaults to database-path)
 ```
 
 Run via npm script:
@@ -437,86 +395,6 @@ In other words, it performs the following actions:
 
 Note: `mirror` does not respect file deletions. If a file is deleted in storage, it will be restored on the next `mirror` run. To delete a file, use the `rm` command instead. This is a little inconvenient, but it is intentional behaviour (if we handle this automatically in `mirror`, we should be against a ton of edge cases).
 
-##### daemon
-
-`daemon` is the default command when no command is specified. It runs an initial mirror scan and then continuously syncs changes in both directions:
-
-- **CouchDB → local filesystem**: via the `_changes` feed (LiveSync mode, default) or periodic polling (`--interval N`).
-- **local filesystem → CouchDB**: via chokidar file watching. Any file created, modified, or deleted in the vault directory is pushed to CouchDB.
-
-In **LiveSync mode** the `_changes` feed delivers remote changes as they arrive, with sub-second latency. In **polling mode** (`--interval N`) the CLI polls CouchDB every N seconds. Use polling mode if your CouchDB instance does not support long-lived HTTP connections, or if you need predictable network usage.
-
-The daemon exits cleanly on `SIGINT` or `SIGTERM`.
-
-```bash
-# LiveSync mode (default — _changes feed, near-real-time)
-livesync-cli /path/to/vault
-
-# Polling mode — poll every 60 seconds
-livesync-cli /path/to/vault --interval 60
-```
-
-### .livesync/ignore
-
-Place a `.livesync/ignore` file in your vault root to exclude files from sync in both directions (local → CouchDB and CouchDB → local).
-
-**Format:**
-
-- Lines beginning with `#` are comments.
-- Blank lines are ignored.
-- All other lines are [minimatch](https://github.com/isaacs/minimatch) glob patterns, relative to the vault root.
-- The directive `import: .gitignore` (exactly this string) reads `.gitignore` from the vault root and merges its non-comment, non-blank lines into the ignore rules.
-- Negation patterns (lines starting with `!`) are not supported and will cause an error on load.
-
-**Example `.livesync/ignore`:**
-
-```
-# Ignore temporary files
-*.tmp
-*.swp
-
-# Ignore build output
-build/
-dist/
-
-# Merge patterns from .gitignore
-import: .gitignore
-```
-
-Patterns apply in both directions: the chokidar watcher will not emit events for matched files, and the `isTargetFile` filter will exclude them from CouchDB → local sync.
-
-Changes to this file require a daemon restart to take effect.
-
-### Systemd Installation
-
-The `deploy/` directory contains a systemd unit template and an install script.
-
-**Automated install (user service, recommended):**
-
-```bash
-bash src/apps/cli/deploy/install.sh --vault /path/to/vault
-```
-
-**With polling interval:**
-
-```bash
-bash src/apps/cli/deploy/install.sh --vault /path/to/vault --interval 60
-```
-
-**System-wide install** (requires root / sudo for `/etc/systemd/system/`):
-
-```bash
-bash src/apps/cli/deploy/install.sh --system --vault /path/to/vault
-```
-
-The script:
-1. Builds the CLI (`npm install` + `npm run build`).
-2. Installs the binary to `~/.local/bin/livesync-cli` (user) or `/usr/local/bin/livesync-cli` (system).
-3. Writes the unit file to `~/.config/systemd/user/livesync-cli.service` (user) or `/etc/systemd/system/livesync-cli.service` (system).
-4. Runs `systemctl [--user] daemon-reload && systemctl [--user] enable --now livesync-cli`.
-
-**Manual setup** — if you prefer to manage the unit yourself, copy `deploy/livesync-cli.service`, replace `LIVESYNC_BIN` and `LIVESYNC_VAULT_PATH` with the actual binary path and vault path, then install to the appropriate systemd directory.
-
 ### Planned options:
 
 - `--immediate`: Perform sync after the command (e.g. `push`, `pull`, `put`, `rm`).

src/apps/cli/adapters/NodeFileSystemAdapter.ts

@@ -39,6 +39,12 @@ export class NodeFileSystemAdapter implements IFileSystemAdapter<NodeFile, NodeF
 
     async getAbstractFileByPath(p: FilePath | string): Promise<NodeFile | null> {
         const pathStr = this.normalisePath(p);
+
+        const cached = this.fileCache.get(pathStr);
+        if (cached) {
+            return cached;
+        }
+
         return await this.refreshFile(pathStr);
     }
 
@@ -98,15 +104,14 @@ export class NodeFileSystemAdapter implements IFileSystemAdapter<NodeFile, NodeF
                 path: pathStr as FilePath,
                 stat: {
                     size: stat.size,
-                    mtime: Math.floor(stat.mtimeMs),
-                    ctime: Math.floor(stat.ctimeMs),
+                    mtime: stat.mtimeMs,
+                    ctime: stat.ctimeMs,
                     type: "file",
                 },
             };
             this.fileCache.set(pathStr, file);
             return file;
         } catch {
-            // Evict so a deleted file is not returned by subsequent cache scans.
             this.fileCache.delete(pathStr);
             return null;
         }
@@ -132,8 +137,8 @@ export class NodeFileSystemAdapter implements IFileSystemAdapter<NodeFile, NodeF
                         path: entryRelativePath as FilePath,
                         stat: {
                             size: stat.size,
-                            mtime: Math.floor(stat.mtimeMs),
-                            ctime: Math.floor(stat.ctimeMs),
+                            mtime: stat.mtimeMs,
+                            ctime: stat.ctimeMs,
                             type: "file",
                         },
                     };

src/apps/cli/adapters/NodeStorageAdapter.ts

@@ -28,8 +28,8 @@ export class NodeStorageAdapter implements IStorageAdapter<NodeStat> {
             const stat = await fs.stat(this.resolvePath(p));
             return {
                 size: stat.size,
-                mtime: Math.floor(stat.mtimeMs),
-                ctime: Math.floor(stat.ctimeMs),
+                mtime: stat.mtimeMs,
+                ctime: stat.ctimeMs,
                 type: stat.isDirectory() ? "folder" : "file",
             };
         } catch {

src/apps/cli/adapters/NodeVaultAdapter.ts

@@ -15,12 +15,7 @@ export class NodeVaultAdapter implements IVaultAdapter<NodeFile> {
     }
 
     async read(file: NodeFile): Promise<string> {
-        const content = await fs.readFile(this.resolvePath(file.path), "utf-8");
-        // Correct stale stat.size — chokidar stats may be from a poll before the final write.
-        // The downstream document integrity check compares stat.size to content length, so
-        // they must agree or other clients reject the file as corrupted.
-        file.stat.size = Buffer.byteLength(content, "utf-8");
-        return content;
+        return await fs.readFile(this.resolvePath(file.path), "utf-8");
     }
 
     async cachedRead(file: NodeFile): Promise<string> {
@@ -30,8 +25,6 @@ export class NodeVaultAdapter implements IVaultAdapter<NodeFile> {
 
     async readBinary(file: NodeFile): Promise<ArrayBuffer> {
         const buffer = await fs.readFile(this.resolvePath(file.path));
-        // Same correction as read() — ensure stat.size matches actual byte length.
-        file.stat.size = buffer.length;
         return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength) as ArrayBuffer;
     }
 
@@ -73,8 +66,8 @@ export class NodeVaultAdapter implements IVaultAdapter<NodeFile> {
             path: p as any,
             stat: {
                 size: stat.size,
-                mtime: Math.floor(stat.mtimeMs),
-                ctime: Math.floor(stat.ctimeMs),
+                mtime: stat.mtimeMs,
+                ctime: stat.ctimeMs,
                 type: "file",
             },
         };
@@ -96,8 +89,8 @@ export class NodeVaultAdapter implements IVaultAdapter<NodeFile> {
             path: p as any,
             stat: {
                 size: stat.size,
-                mtime: Math.floor(stat.mtimeMs),
-                ctime: Math.floor(stat.ctimeMs),
+                mtime: stat.mtimeMs,
+                ctime: stat.ctimeMs,
                 type: "file",
             },
         };

src/apps/cli/commands/daemonCommand.unit.spec.ts

@@ -1,312 +0,0 @@
-import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
-import { runCommand } from "./runCommand";
-import type { CLIOptions } from "./types";
-
-// Mock performFullScan so daemon tests don't require a real CouchDB connection.
-vi.mock("@lib/serviceFeatures/offlineScanner", () => ({
-    performFullScan: vi.fn(async () => true),
-}));
-
-// Mock UnresolvedErrorManager to avoid event-hub side effects.
-vi.mock("@lib/services/base/UnresolvedErrorManager", () => ({
-    UnresolvedErrorManager: class UnresolvedErrorManager {
-        showError() {}
-        clearError() {}
-        clearErrors() {}
-    },
-}));
-
-import * as offlineScanner from "@lib/serviceFeatures/offlineScanner";
-
-function createCoreMock() {
-    return {
-        services: {
-            control: {
-                activated: Promise.resolve(),
-                applySettings: vi.fn(async () => {}),
-            },
-            setting: {
-                applyPartial: vi.fn(async () => {}),
-                currentSettings: vi.fn(() => ({ liveSync: true, syncOnStart: false })),
-            },
-            replication: {
-                replicate: vi.fn(async () => true),
-            },
-            appLifecycle: {
-                onUnload: {
-                    addHandler: vi.fn(),
-                },
-            },
-        },
-        serviceModules: {
-            fileHandler: {
-                dbToStorage: vi.fn(async () => true),
-                storeFileToDB: vi.fn(async () => true),
-            },
-            storageAccess: {
-                readFileAuto: vi.fn(async () => ""),
-                writeFileAuto: vi.fn(async () => {}),
-            },
-            databaseFileAccess: {
-                fetch: vi.fn(async () => undefined),
-            },
-        },
-    } as any;
-}
-
-function makeDaemonOptions(interval?: number): CLIOptions {
-    return {
-        command: "daemon",
-        commandArgs: [],
-        databasePath: "/tmp/vault",
-        verbose: false,
-        force: false,
-        interval,
-    };
-}
-
-const baseContext = {
-    vaultPath: "/tmp/vault",
-    settingsPath: "/tmp/vault/.livesync/settings.json",
-    originalSyncSettings: {
-        liveSync: true,
-        syncOnStart: false,
-        periodicReplication: false,
-        syncOnSave: false,
-        syncOnEditorSave: false,
-        syncOnFileOpen: false,
-        syncAfterMerge: false,
-    },
-} as any;
-
-describe("daemon command", () => {
-    beforeEach(() => {
-        vi.restoreAllMocks();
-        vi.useFakeTimers();
-    });
-
-    afterEach(() => {
-        vi.useRealTimers();
-    });
-
-    it("calls performFullScan during startup", async () => {
-        const core = createCoreMock();
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
-
-        await runCommand(makeDaemonOptions(), { ...baseContext, core });
-
-        expect(offlineScanner.performFullScan).toHaveBeenCalledTimes(1);
-    });
-
-    it("returns false when performFullScan fails", async () => {
-        const core = createCoreMock();
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(false);
-
-        const result = await runCommand(makeDaemonOptions(), { ...baseContext, core });
-
-        expect(result).toBe(false);
-    });
-
-    it("polling mode: calls setTimeout when interval option is set", async () => {
-        const core = createCoreMock();
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
-        const setTimeoutSpy = vi.spyOn(globalThis, "setTimeout");
-
-        await runCommand(makeDaemonOptions(30), { ...baseContext, core });
-
-        expect(setTimeoutSpy).toHaveBeenCalledTimes(1);
-        // Interval should be in milliseconds (30s → 30000ms)
-        expect(setTimeoutSpy).toHaveBeenCalledWith(expect.any(Function), 30000);
-    });
-
-    it("polling mode: applies settings with suspendFileWatching=false before setting interval", async () => {
-        const core = createCoreMock();
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
-
-        await runCommand(makeDaemonOptions(10), { ...baseContext, core });
-
-        expect(core.services.setting.applyPartial).toHaveBeenCalledWith(
-            expect.objectContaining({ suspendFileWatching: false }),
-            true
-        );
-        expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
-    });
-
-    it("liveSync mode: calls applyPartial and applySettings", async () => {
-        const core = createCoreMock();
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
-
-        await runCommand(makeDaemonOptions(), { ...baseContext, core });
-
-        expect(core.services.setting.applyPartial).toHaveBeenCalledWith(
-            expect.objectContaining({
-                ...baseContext.originalSyncSettings,
-                suspendFileWatching: false,
-            }),
-            true
-        );
-        expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
-    });
-
-    it("liveSync mode: logs warning when both liveSync and syncOnStart are false", async () => {
-        const core = createCoreMock();
-        core.services.setting.currentSettings = vi.fn(() => ({
-            liveSync: false,
-            syncOnStart: false,
-        }));
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
-        const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => {});
-
-        const result = await runCommand(makeDaemonOptions(), { ...baseContext, core });
-
-        expect(result).toBe(true);
-        const warningCalls = consoleSpy.mock.calls.filter(
-            (args) => typeof args[0] === "string" && args[0].includes("liveSync and syncOnStart are both disabled")
-        );
-        expect(warningCalls.length).toBeGreaterThan(0);
-    });
-
-    it("liveSync mode: no warning when liveSync is true", async () => {
-        const core = createCoreMock();
-        core.services.setting.currentSettings = vi.fn(() => ({
-            liveSync: true,
-            syncOnStart: false,
-        }));
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
-        const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => {});
-
-        await runCommand(makeDaemonOptions(), { ...baseContext, core });
-
-        const warningCalls = consoleSpy.mock.calls.filter(
-            (args) => typeof args[0] === "string" && args[0].includes("liveSync and syncOnStart are both disabled")
-        );
-        expect(warningCalls.length).toBe(0);
-    });
-
-    it("calls replicate before performFullScan", async () => {
-        const core = createCoreMock();
-        const callOrder: string[] = [];
-        core.services.replication.replicate = vi.fn(async () => {
-            callOrder.push("replicate");
-            return true;
-        });
-        vi.mocked(offlineScanner.performFullScan).mockImplementation(async () => {
-            callOrder.push("performFullScan");
-            return true;
-        });
-
-        await runCommand(makeDaemonOptions(), { ...baseContext, core });
-
-        expect(callOrder).toEqual(["replicate", "performFullScan"]);
-    });
-
-    it("returns false when initial replication fails", async () => {
-        const core = createCoreMock();
-        core.services.replication.replicate = vi.fn(async () => false);
-        vi.mocked(offlineScanner.performFullScan).mockClear();
-
-        const result = await runCommand(makeDaemonOptions(), { ...baseContext, core });
-
-        expect(result).toBe(false);
-        // performFullScan should NOT have been called
-        expect(offlineScanner.performFullScan).not.toHaveBeenCalled();
-    });
-
-    it("polling mode: registers onUnload handler that clears timeout", async () => {
-        const core = createCoreMock();
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
-
-        await runCommand(makeDaemonOptions(10), { ...baseContext, core });
-
-        // onUnload handler should have been registered
-        expect(core.services.appLifecycle.onUnload.addHandler).toHaveBeenCalledTimes(1);
-        const handler = core.services.appLifecycle.onUnload.addHandler.mock.calls[0][0];
-
-        // Get the timeout ID that was created
-        const clearTimeoutSpy = vi.spyOn(globalThis, "clearTimeout");
-        await handler();
-        expect(clearTimeoutSpy).toHaveBeenCalledTimes(1);
-    });
-
-    it("polling backoff: interval escalates on failure, caps at 300000ms, then halves on recovery", async () => {
-        const core = createCoreMock();
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
-        vi.spyOn(console, "error").mockImplementation(() => {});
-
-        // startup replicate (call 1) succeeds; poll calls 2–7 fail; call 8 succeeds.
-        let callCount = 0;
-        core.services.replication.replicate = vi.fn(async () => {
-            callCount++;
-            if (callCount === 1) return true; // initial startup replicate
-            if (callCount <= 7) throw new Error("network failure");
-            return true; // recovery
-        });
-
-        const baseMs = 30 * 1000;
-        const setTimeoutSpy = vi.spyOn(globalThis, "setTimeout");
-
-        await runCommand(makeDaemonOptions(30), { ...baseContext, core });
-
-        // After runCommand returns the first setTimeout has been scheduled.
-        // setTimeoutSpy.mock.calls[0] is the initial schedule (baseMs).
-        expect(setTimeoutSpy.mock.calls[0][1]).toBe(baseMs);
-
-        // Advance through 6 failure polls. After each failure the next setTimeout
-        // should be scheduled with a larger (or capped) interval.
-        // formula: min(base * 2^n, 300000). base=30000ms.
-        // failure 1: 30000*2=60000, failure 2: 30000*4=120000,
-        // failure 3: 30000*8=240000, failure 4: 30000*16=480000→capped, 5→cap, 6→cap
-        const expectedIntervals = [
-            baseMs * 2, // after failure 1: 60000
-            baseMs * 4, // after failure 2: 120000
-            baseMs * 8, // after failure 3: 240000
-            300_000, // after failure 4 (would be 480000, capped)
-            300_000, // after failure 5 (cap)
-            300_000, // after failure 6 (cap)
-        ];
-
-        for (const expected of expectedIntervals) {
-            const prevCallCount = setTimeoutSpy.mock.calls.length;
-            await vi.advanceTimersByTimeAsync(setTimeoutSpy.mock.calls[prevCallCount - 1][1] as number);
-            const newCallCount = setTimeoutSpy.mock.calls.length;
-            expect(newCallCount).toBeGreaterThan(prevCallCount);
-            expect(setTimeoutSpy.mock.calls[newCallCount - 1][1]).toBe(expected);
-        }
-
-        // Now trigger the success poll — interval should halve each time toward base.
-        // After failure 6, consecutiveFailures=6, currentIntervalMs=300000.
-        // On success: consecutiveFailures=5, currentIntervalMs=150000.
-        const prevCallCount = setTimeoutSpy.mock.calls.length;
-        await vi.advanceTimersByTimeAsync(setTimeoutSpy.mock.calls[prevCallCount - 1][1] as number);
-        const afterSuccessCallCount = setTimeoutSpy.mock.calls.length;
-        expect(afterSuccessCallCount).toBeGreaterThan(prevCallCount);
-        // The interval after one success should be halved (300000 / 2 = 150000).
-        expect(setTimeoutSpy.mock.calls[afterSuccessCallCount - 1][1]).toBe(150_000);
-    });
-
-    it("polling error handling: replicate rejection is caught and console.error is called", async () => {
-        const core = createCoreMock();
-        vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
-        const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => {});
-
-        // Make replicate succeed on the initial call (startup), then fail on the poll.
-        let callCount = 0;
-        core.services.replication.replicate = vi.fn(async () => {
-            callCount++;
-            if (callCount === 1) return true; // startup replicate
-            throw new Error("network failure");
-        });
-
-        const intervalMs = 30 * 1000;
-        await runCommand(makeDaemonOptions(30), { ...baseContext, core });
-
-        // Advance time to trigger the first poll callback and flush its async work.
-        await vi.advanceTimersByTimeAsync(intervalMs);
-
-        // No unhandled rejection — the error was caught internally.
-        const errorCalls = consoleSpy.mock.calls.filter(
-            (args) => typeof args[0] === "string" && args[0].includes("Poll error")
-        );
-        expect(errorCalls.length).toBeGreaterThan(0);
-    });
-});

src/apps/cli/commands/p2p.ts

@@ -32,15 +32,10 @@ function validateP2PSettings(core: LiveSyncBaseCore<ServiceContext, any>) {
     settings.P2P_IsHeadless = true;
 }
 
-async function createReplicator(core: LiveSyncBaseCore<ServiceContext, any>): Promise<LiveSyncTrysteroReplicator> {
+function createReplicator(core: LiveSyncBaseCore<ServiceContext, any>): LiveSyncTrysteroReplicator {
     validateP2PSettings(core);
-    const replicator = await core.services.replicator.getNewReplicator();
-    if (!replicator) {
-        throw new Error("Failed to create replicator instance. Ensure P2P is enabled in settings.");
-    }
-    if (!(replicator instanceof LiveSyncTrysteroReplicator)) {
-        throw new Error("Unexpected replicator type. Expected LiveSyncTrysteroReplicator.");
-    }
+    const replicator = new LiveSyncTrysteroReplicator({ services: core.services });
+    addP2PEventHandlers(replicator);
     return replicator;
 }
 
@@ -54,7 +49,7 @@ export async function collectPeers(
     core: LiveSyncBaseCore<ServiceContext, any>,
     timeoutSec: number
 ): Promise<CLIP2PPeer[]> {
-    const replicator = await createReplicator(core);
+    const replicator = createReplicator(core);
     await replicator.open();
     try {
         await delay(timeoutSec * 1000);
@@ -84,7 +79,7 @@ export async function syncWithPeer(
     peerToken: string,
     timeoutSec: number
 ): Promise<CLIP2PPeer> {
-    const replicator = await createReplicator(core);
+    const replicator = createReplicator(core);
     await replicator.open();
     try {
         const timeoutMs = timeoutSec * 1000;
@@ -120,7 +115,7 @@ export async function syncWithPeer(
 }
 
 export async function openP2PHost(core: LiveSyncBaseCore<ServiceContext, any>): Promise<LiveSyncTrysteroReplicator> {
-    const replicator = await createReplicator(core);
+    const replicator = createReplicator(core);
     await replicator.open();
     return replicator;
 }

src/apps/cli/commands/runCommand.ts

@@ -2,16 +2,7 @@ import * as fs from "fs/promises";
 import * as path from "path";
 import { decodeSettingsFromSetupURI } from "@lib/API/processSetting";
 import { configURIBase } from "@lib/common/models/shared.const";
-import {
-    DEFAULT_SETTINGS,
-    MILESTONE_DOCID,
-    type FilePathWithPrefix,
-    type ObsidianLiveSyncSettings,
-    REMOTE_COUCHDB,
-    REMOTE_MINIO,
-} from "@lib/common/types";
-import { ConnectionStringParser } from "@lib/common/ConnectionString";
-import { activateRemoteConfiguration, createRemoteConfigurationId } from "@lib/serviceFeatures/remoteConfig";
+import { DEFAULT_SETTINGS, type FilePathWithPrefix, type ObsidianLiveSyncSettings } from "@lib/common/types";
 import { stripAllPrefixes } from "@lib/string_and_binary/path";
 import type { CLICommandContext, CLIOptions } from "./types";
 import { promptForPassphrase, readStdinAsUtf8, toArrayBuffer, toDatabaseRelativePath } from "./utils";
@@ -19,161 +10,11 @@ import { collectPeers, openP2PHost, parseTimeoutSeconds, syncWithPeer } from "./
 import { performFullScan } from "@lib/serviceFeatures/offlineScanner";
 import { UnresolvedErrorManager } from "@lib/services/base/UnresolvedErrorManager";
 
-function redactConnectionString(uri: string): string {
-    return uri.replace(/\/\/([^@/]+)@/u, "//***@");
-}
-
-async function verifyRemoteState(
-    core: CLICommandContext["core"],
-    settings: ObsidianLiveSyncSettings
-): Promise<boolean> {
-    const replicator = core.services.replicator.getActiveReplicator();
-    if (!replicator) {
-        process.stderr.write("[Verification] No active replicator found\n");
-        return false;
-    }
-
-    if (!replicator.nodeid) {
-        await replicator.initializeDatabaseForReplication();
-    }
-
-    try {
-        let milestone: any;
-        if (settings.remoteType === REMOTE_COUCHDB) {
-            const dbRet = await (replicator as any).connectRemoteCouchDBWithSetting(settings, false, true);
-            if (typeof dbRet === "string") {
-                process.stderr.write(`[Verification] Failed to connect to remote CouchDB: ${dbRet}\n`);
-                return false;
-            }
-            milestone = await dbRet.db.get(MILESTONE_DOCID);
-        } else if (settings.remoteType === REMOTE_MINIO) {
-            milestone = await (replicator as any).client.downloadJson("_00000000-milestone.json");
-        }
-
-        if (milestone) {
-            const isLocked = !!milestone.locked;
-            const isAccepted = !!milestone.accepted_nodes?.includes(replicator.nodeid);
-            process.stderr.write(`[Verification] Remote Database: ${isLocked ? "LOCKED" : "UNLOCKED"}\n`);
-            process.stderr.write(
-                `[Verification] Current Device Node ID (${replicator.nodeid}): ${isAccepted ? "ACCEPTED" : "NOT ACCEPTED"}\n`
-            );
-            return true;
-        } else {
-            process.stderr.write("[Verification] Milestone document not found on remote.\n");
-            return false;
-        }
-    } catch (e: any) {
-        process.stderr.write(`[Verification] Failed to fetch milestone document: ${e?.message || e}\n`);
-        return false;
-    }
-}
-
 export async function runCommand(options: CLIOptions, context: CLICommandContext): Promise<boolean> {
     const { databasePath, core, settingsPath } = context;
-    const vaultPath = context.vaultPath || databasePath;
 
     await core.services.control.activated;
     if (options.command === "daemon") {
-        const log = (msg: unknown) => console.error(`[Daemon] ${msg}`);
-
-        // Skip the config mismatch dialog — the daemon cannot resolve it interactively
-        // and the default "Dismiss" action would block replication. The daemon should
-        // accept whatever configuration the remote has.
-        await core.services.setting.applyPartial({ disableCheckingConfigMismatch: true }, true);
-
-        // 1. Replicate CouchDB → local PouchDB so the mirror scan has content to work with.
-        log("Replicating from CouchDB...");
-        const replResult = await core.services.replication.replicate(true);
-        if (!replResult) {
-            console.error("[Daemon] Initial CouchDB replication failed, cannot continue");
-            return false;
-        }
-        log("CouchDB replication complete");
-
-        // 2. Mirror scan to reconcile PouchDB ↔ local filesystem.
-        const errorManager = new UnresolvedErrorManager(core.services.appLifecycle);
-        log("Running mirror scan...");
-        const scanOk = await performFullScan(core as any, log, errorManager, false, true);
-        if (!scanOk) {
-            console.error("[Daemon] Mirror scan failed, cannot continue");
-            return false;
-        }
-        log("Mirror scan complete");
-
-        // 3. Re-enable sync.
-        const restoreSyncSettings = async () => {
-            await core.services.setting.applyPartial(
-                {
-                    ...context.originalSyncSettings,
-                    suspendFileWatching: false,
-                },
-                true
-            );
-            // applySettings fires the full lifecycle: onSuspending → onResumed.
-            // ModuleReplicatorCouchDB starts continuous replication on onResumed
-            // via fireAndForget.
-            await core.services.control.applySettings();
-            // Lifecycle events (onSuspending) may re-enable suspension flags.
-            // Clear them explicitly after the lifecycle completes. applyPartial
-            // with true is a direct store write — it does not re-trigger lifecycle.
-            await core.services.setting.applyPartial(
-                {
-                    suspendFileWatching: false,
-                    suspendParseReplicationResult: false,
-                },
-                true
-            );
-        };
-        if (options.interval) {
-            log(`Polling mode: syncing every ${options.interval}s`);
-            await restoreSyncSettings();
-            const baseIntervalMs = options.interval * 1000;
-            let currentIntervalMs = baseIntervalMs;
-            let consecutiveFailures = 0;
-            const maxIntervalMs = 5 * 60 * 1000; // 5 minutes cap
-
-            const poll = async () => {
-                try {
-                    await core.services.replication.replicate(true);
-                    if (consecutiveFailures > 0) {
-                        consecutiveFailures--;
-                        currentIntervalMs = Math.max(currentIntervalMs / 2, baseIntervalMs);
-                        log(`Replication recovered`);
-                    }
-                } catch (err) {
-                    consecutiveFailures++;
-                    currentIntervalMs = Math.min(baseIntervalMs * Math.pow(2, consecutiveFailures), maxIntervalMs);
-                    console.error(`[Daemon] Poll error (${consecutiveFailures} consecutive):`, err);
-                    if (consecutiveFailures >= 5) {
-                        console.error(
-                            `[Daemon] Warning: ${consecutiveFailures} consecutive failures, backing off to ${Math.round(currentIntervalMs / 1000)}s`
-                        );
-                    }
-                }
-                pollTimer = setTimeout(poll, currentIntervalMs);
-            };
-            let pollTimer: ReturnType<typeof setTimeout> = setTimeout(poll, currentIntervalMs);
-            core.services.appLifecycle.onUnload.addHandler(async () => {
-                clearTimeout(pollTimer);
-                return true;
-            });
-        } else {
-            log("LiveSync mode: restoring sync settings and starting _changes feed");
-            await restoreSyncSettings();
-            // The applySettings() lifecycle fires onResumed → ModuleReplicatorCouchDB which
-            // starts continuous replication via fireAndForget(openReplication). Don't call
-            // openReplication directly — it races with the handler and causes dedup/termination.
-            log("LiveSync active");
-            const currentSettings = core.services.setting.currentSettings();
-            if (!currentSettings.liveSync && !currentSettings.syncOnStart) {
-                console.error(
-                    "[Daemon] Warning: liveSync and syncOnStart are both disabled in settings. " +
-                        "No sync will occur. Set liveSync=true in your settings file for continuous sync, " +
-                        "or use --interval for polling mode."
-                );
-            }
-        }
-
         return true;
     }
 
@@ -236,14 +77,14 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
             throw new Error("push requires two arguments: <src> <dst>");
         }
         const sourcePath = path.resolve(options.commandArgs[0]);
-        const destinationDatabasePath = toDatabaseRelativePath(options.commandArgs[1], vaultPath);
+        const destinationDatabasePath = toDatabaseRelativePath(options.commandArgs[1], databasePath);
         const sourceData = await fs.readFile(sourcePath);
         const sourceStat = await fs.stat(sourcePath);
         console.log(`[Command] push ${sourcePath} -> ${destinationDatabasePath}`);
 
         await core.serviceModules.storageAccess.writeFileAuto(destinationDatabasePath, toArrayBuffer(sourceData), {
-            mtime: Math.floor(sourceStat.mtimeMs),
-            ctime: Math.floor(sourceStat.ctimeMs),
+            mtime: sourceStat.mtimeMs,
+            ctime: sourceStat.ctimeMs,
         });
         const destinationPathWithPrefix = destinationDatabasePath as FilePathWithPrefix;
         const stored = await core.serviceModules.fileHandler.storeFileToDB(destinationPathWithPrefix, true);
@@ -254,7 +95,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         if (options.commandArgs.length < 2) {
             throw new Error("pull requires two arguments: <src> <dst>");
         }
-        const sourceDatabasePath = toDatabaseRelativePath(options.commandArgs[0], vaultPath);
+        const sourceDatabasePath = toDatabaseRelativePath(options.commandArgs[0], databasePath);
         const destinationPath = path.resolve(options.commandArgs[1]);
         console.log(`[Command] pull ${sourceDatabasePath} -> ${destinationPath}`);
 
@@ -277,7 +118,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         if (options.commandArgs.length < 3) {
             throw new Error("pull-rev requires three arguments: <src> <dst> <rev>");
         }
-        const sourceDatabasePath = toDatabaseRelativePath(options.commandArgs[0], vaultPath);
+        const sourceDatabasePath = toDatabaseRelativePath(options.commandArgs[0], databasePath);
         const destinationPath = path.resolve(options.commandArgs[1]);
         const rev = options.commandArgs[2].trim();
         if (!rev) {
@@ -334,7 +175,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         if (options.commandArgs.length < 1) {
             throw new Error("put requires one argument: <dst>");
         }
-        const destinationDatabasePath = toDatabaseRelativePath(options.commandArgs[0], vaultPath);
+        const destinationDatabasePath = toDatabaseRelativePath(options.commandArgs[0], databasePath);
         const content = await readStdinAsUtf8();
         console.log(`[Command] put stdin -> ${destinationDatabasePath}`);
         return await core.serviceModules.databaseFileAccess.storeContent(
@@ -347,7 +188,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         if (options.commandArgs.length < 1) {
             throw new Error("cat requires one argument: <src>");
         }
-        const sourceDatabasePath = toDatabaseRelativePath(options.commandArgs[0], vaultPath);
+        const sourceDatabasePath = toDatabaseRelativePath(options.commandArgs[0], databasePath);
         console.error(`[Command] cat ${sourceDatabasePath}`);
         const source = await core.serviceModules.databaseFileAccess.fetch(
             sourceDatabasePath as FilePathWithPrefix,
@@ -371,7 +212,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         if (options.commandArgs.length < 2) {
             throw new Error("cat-rev requires two arguments: <src> <rev>");
         }
-        const sourceDatabasePath = toDatabaseRelativePath(options.commandArgs[0], vaultPath);
+        const sourceDatabasePath = toDatabaseRelativePath(options.commandArgs[0], databasePath);
         const rev = options.commandArgs[1].trim();
         if (!rev) {
             throw new Error("cat-rev requires a non-empty revision");
@@ -398,7 +239,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
     if (options.command === "ls") {
         const prefix =
             options.commandArgs.length > 0 && options.commandArgs[0].trim() !== ""
-                ? toDatabaseRelativePath(options.commandArgs[0], vaultPath)
+                ? toDatabaseRelativePath(options.commandArgs[0], databasePath)
                 : "";
         const rows: { path: string; line: string }[] = [];
 
@@ -430,7 +271,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         if (options.commandArgs.length < 1) {
             throw new Error("info requires one argument: <path>");
         }
-        const targetPath = toDatabaseRelativePath(options.commandArgs[0], vaultPath);
+        const targetPath = toDatabaseRelativePath(options.commandArgs[0], databasePath);
 
         for await (const doc of core.services.database.localDatabase.findAllNormalDocs({ conflicts: true })) {
             if (doc._deleted || doc.deleted) continue;
@@ -474,7 +315,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         if (options.commandArgs.length < 1) {
             throw new Error("rm requires one argument: <path>");
         }
-        const targetPath = toDatabaseRelativePath(options.commandArgs[0], vaultPath);
+        const targetPath = toDatabaseRelativePath(options.commandArgs[0], databasePath);
         console.error(`[Command] rm ${targetPath}`);
         return await core.serviceModules.databaseFileAccess.delete(targetPath as FilePathWithPrefix);
     }
@@ -483,7 +324,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         if (options.commandArgs.length < 2) {
             throw new Error("resolve requires two arguments: <path> <revision-to-keep>");
         }
-        const targetPath = toDatabaseRelativePath(options.commandArgs[0], vaultPath) as FilePathWithPrefix;
+        const targetPath = toDatabaseRelativePath(options.commandArgs[0], databasePath) as FilePathWithPrefix;
         const revisionToKeep = options.commandArgs[1].trim();
         if (revisionToKeep === "") {
             throw new Error("resolve requires a non-empty revision-to-keep");
@@ -528,326 +369,5 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         return await performFullScan(core as any, log, errorManager, false, true);
     }
 
-    if (options.command === "remote-add") {
-        if (options.commandArgs.length < 2) {
-            throw new Error("remote-add requires two arguments: <name> <connstr>");
-        }
-        const name = options.commandArgs[0].trim();
-        const connectionString = options.commandArgs[1].trim();
-        if (!name) {
-            throw new Error("remote-add requires a non-empty name");
-        }
-        if (!connectionString) {
-            throw new Error("remote-add requires a non-empty connection string");
-        }
-
-        const parsed = ConnectionStringParser.parse(connectionString);
-        const canonicalUri = ConnectionStringParser.serialize(parsed);
-        const id = createRemoteConfigurationId();
-        let activated = false;
-
-        await core.services.setting.updateSettings((currentSettings) => {
-            currentSettings.remoteConfigurations ||= {};
-            currentSettings.remoteConfigurations[id] = {
-                id,
-                name,
-                uri: canonicalUri,
-                isEncrypted: false,
-            };
-            if (!currentSettings.activeConfigurationId) {
-                currentSettings.activeConfigurationId = id;
-                const applied = activateRemoteConfiguration(currentSettings, id);
-                activated = applied !== false;
-            }
-            return currentSettings;
-        }, true);
-
-        if (activated) {
-            await core.services.control.applySettings();
-        }
-
-        process.stdout.write(`${id}\t${name}\t${redactConnectionString(canonicalUri)}\n`);
-        return true;
-    }
-
-    if (options.command === "remote-rm") {
-        if (options.commandArgs.length < 1) {
-            throw new Error("remote-rm requires one argument: <remote-id>");
-        }
-        const id = options.commandArgs[0].trim();
-        if (!id) {
-            throw new Error("remote-rm requires a non-empty remote-id");
-        }
-
-        const current = core.services.setting.currentSettings();
-        if (!current.remoteConfigurations?.[id]) {
-            process.stderr.write(`[Info] Remote configuration not found: ${id}\n`);
-            return false;
-        }
-
-        let switchedActive = false;
-        await core.services.setting.updateSettings((currentSettings) => {
-            const configs = currentSettings.remoteConfigurations || {};
-            delete configs[id];
-            currentSettings.remoteConfigurations = configs;
-
-            if (currentSettings.activeConfigurationId === id) {
-                const nextActiveId = Object.keys(configs)[0] || "";
-                currentSettings.activeConfigurationId = nextActiveId;
-                switchedActive = nextActiveId !== "";
-                if (nextActiveId !== "") {
-                    activateRemoteConfiguration(currentSettings, nextActiveId);
-                }
-            }
-
-            if (currentSettings.P2P_ActiveRemoteConfigurationId === id) {
-                currentSettings.P2P_ActiveRemoteConfigurationId = "";
-            }
-
-            return currentSettings;
-        }, true);
-
-        if (switchedActive) {
-            await core.services.control.applySettings();
-        }
-
-        console.error(`[Command] remote-rm ${id}`);
-        return true;
-    }
-
-    if (options.command === "remote-ls") {
-        const settings = core.services.setting.currentSettings();
-        const configs = Object.values(settings.remoteConfigurations || {});
-        configs.sort((a, b) => a.name.localeCompare(b.name));
-
-        if (configs.length === 0) {
-            process.stderr.write("[Info] No remote configurations found.\n");
-            return true;
-        }
-
-        const lines = configs.map((config) => {
-            const status = config.id === settings.activeConfigurationId ? "active" : "inactive";
-            return `${config.id}\t${config.name}\t${status}\t${redactConnectionString(config.uri)}`;
-        });
-        process.stdout.write(lines.join("\n") + "\n");
-        return true;
-    }
-
-    if (options.command === "remote-export") {
-        if (options.commandArgs.length < 1) {
-            throw new Error("remote-export requires one argument: <remote-id>");
-        }
-        const id = options.commandArgs[0].trim();
-        if (!id) {
-            throw new Error("remote-export requires a non-empty remote-id");
-        }
-
-        const config = core.services.setting.currentSettings().remoteConfigurations?.[id];
-        if (!config) {
-            process.stderr.write(`[Info] Remote configuration not found: ${id}\n`);
-            return false;
-        }
-
-        process.stdout.write(`${config.uri}\n`);
-        return true;
-    }
-
-    if (options.command === "remote-set") {
-        if (options.commandArgs.length < 2) {
-            throw new Error("remote-set requires two arguments: <remote-id> <connstr>");
-        }
-        const id = options.commandArgs[0].trim();
-        const connectionString = options.commandArgs[1].trim();
-        if (!id) {
-            throw new Error("remote-set requires a non-empty remote-id");
-        }
-        if (!connectionString) {
-            throw new Error("remote-set requires a non-empty connection string");
-        }
-
-        const parsed = ConnectionStringParser.parse(connectionString);
-        const canonicalUri = ConnectionStringParser.serialize(parsed);
-        let switchedActive = false;
-
-        await core.services.setting.updateSettings((currentSettings) => {
-            const config = currentSettings.remoteConfigurations?.[id];
-            if (!config) {
-                return currentSettings;
-            }
-            config.uri = canonicalUri;
-
-            if (currentSettings.activeConfigurationId === id) {
-                const activated = activateRemoteConfiguration(currentSettings, id);
-                switchedActive = activated !== false;
-                if (activated) {
-                    return activated;
-                }
-            }
-            return currentSettings;
-        }, true);
-
-        const updated = core.services.setting.currentSettings().remoteConfigurations?.[id];
-        if (!updated) {
-            process.stderr.write(`[Info] Remote configuration not found: ${id}\n`);
-            return false;
-        }
-
-        if (switchedActive) {
-            await core.services.control.applySettings();
-        }
-
-        console.error(`[Command] remote-set ${id}`);
-        return true;
-    }
-    if (options.command === "remote-activate") {
-        if (options.commandArgs.length < 1) {
-            throw new Error("remote-activate requires one argument: <remote-id>");
-        }
-        const id = options.commandArgs[0].trim();
-        if (!id) {
-            throw new Error("remote-activate requires a non-empty remote-id");
-        }
-
-        let switched = false;
-        await core.services.setting.updateSettings((currentSettings) => {
-            const activated = activateRemoteConfiguration(currentSettings, id);
-            if (activated) {
-                switched = true;
-                return activated;
-            }
-            return currentSettings;
-        }, true);
-
-        if (!switched) {
-            process.stderr.write(`[Info] Failed to activate remote configuration: ${id}\n`);
-            return false;
-        }
-
-        await core.services.control.applySettings();
-        console.error(`[Command] remote-activate ${id}`);
-        return true;
-    }
-
-    if (options.command === "mark-resolved") {
-        const id = options.commandArgs[0]?.trim();
-        if (id) {
-            let switched = false;
-            await core.services.setting.updateSettings((currentSettings) => {
-                const activated = activateRemoteConfiguration(currentSettings, id);
-                if (activated) {
-                    switched = true;
-                    return activated;
-                }
-                return currentSettings;
-            }, false);
-
-            if (!switched) {
-                process.stderr.write(`[Info] Failed to temporarily activate remote configuration: ${id}\n`);
-                return false;
-            }
-
-            await core.services.control.applySettings();
-        }
-
-        console.error(`[Command] mark-resolved${id ? ` ${id}` : ""}`);
-        await core.services.replication.markResolved();
-        const settings = core.services.setting.currentSettings();
-        await verifyRemoteState(core, settings);
-        return true;
-    }
-
-    if (options.command === "unlock-remote") {
-        const id = options.commandArgs[0]?.trim();
-        if (id) {
-            let switched = false;
-            await core.services.setting.updateSettings((currentSettings) => {
-                const activated = activateRemoteConfiguration(currentSettings, id);
-                if (activated) {
-                    switched = true;
-                    return activated;
-                }
-                return currentSettings;
-            }, false);
-
-            if (!switched) {
-                process.stderr.write(`[Info] Failed to temporarily activate remote configuration: ${id}\n`);
-                return false;
-            }
-
-            await core.services.control.applySettings();
-        }
-
-        console.error(`[Command] unlock-remote${id ? ` ${id}` : ""}`);
-        await core.services.replication.markUnlocked();
-        const settings = core.services.setting.currentSettings();
-        await verifyRemoteState(core, settings);
-        return true;
-    }
-
-    if (options.command === "lock-remote") {
-        const id = options.commandArgs[0]?.trim();
-        if (id) {
-            let switched = false;
-            await core.services.setting.updateSettings((currentSettings) => {
-                const activated = activateRemoteConfiguration(currentSettings, id);
-                if (activated) {
-                    switched = true;
-                    return activated;
-                }
-                return currentSettings;
-            }, false);
-
-            if (!switched) {
-                process.stderr.write(`[Info] Failed to temporarily activate remote configuration: ${id}\n`);
-                return false;
-            }
-
-            await core.services.control.applySettings();
-        }
-
-        console.error(`[Command] lock-remote${id ? ` ${id}` : ""}`);
-        await core.services.replication.markLocked();
-        const settings = core.services.setting.currentSettings();
-        await verifyRemoteState(core, settings);
-        return true;
-    }
-
-    if (options.command === "remote-status") {
-        const id = options.commandArgs[0]?.trim();
-        if (id) {
-            let switched = false;
-            await core.services.setting.updateSettings((currentSettings) => {
-                const activated = activateRemoteConfiguration(currentSettings, id);
-                if (activated) {
-                    switched = true;
-                    return activated;
-                }
-                return currentSettings;
-            }, false);
-
-            if (!switched) {
-                process.stderr.write(`[Info] Failed to temporarily activate remote configuration: ${id}\n`);
-                return false;
-            }
-
-            await core.services.control.applySettings();
-        }
-
-        console.error(`[Command] remote-status${id ? ` ${id}` : ""}`);
-        const replicator = core.services.replicator.getActiveReplicator();
-        if (!replicator) {
-            process.stderr.write("[Error] No active replicator found\n");
-            return false;
-        }
-        const settings = core.services.setting.currentSettings();
-        const status = await replicator.getRemoteStatus(settings);
-        if (status === false) {
-            process.stderr.write("[Error] Failed to fetch remote status\n");
-            return false;
-        }
-        process.stdout.write(JSON.stringify(status, null, 2) + "\n");
-        return true;
-    }
-
     throw new Error(`Unsupported command: ${options.command}`);
 }

src/apps/cli/commands/runCommand.unit.spec.ts

@@ -1,22 +1,12 @@
-import * as path from "path";
-import * as fs from "fs/promises";
-import * as os from "os";
 import * as processSetting from "@lib/API/processSetting";
-import { ConnectionStringParser } from "@lib/common/ConnectionString";
 import { configURIBase } from "@lib/common/models/shared.const";
-import { DEFAULT_SETTINGS, REMOTE_COUCHDB, REMOTE_MINIO, REMOTE_P2P } from "@lib/common/types";
+import { DEFAULT_SETTINGS } from "@lib/common/types";
 import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
 import { runCommand } from "./runCommand";
 import type { CLIOptions } from "./types";
 import * as commandUtils from "./utils";
 
 function createCoreMock() {
-    const liveSettings = {
-        ...DEFAULT_SETTINGS,
-        remoteConfigurations: {},
-        activeConfigurationId: "",
-        P2P_ActiveRemoteConfigurationId: "",
-    } as any;
     return {
         services: {
             control: {
@@ -26,38 +16,6 @@ function createCoreMock() {
             setting: {
                 applyExternalSettings: vi.fn(async () => {}),
                 applyPartial: vi.fn(async () => {}),
-                currentSettings: vi.fn(() => liveSettings),
-                updateSettings: vi.fn(async (updater: any) => {
-                    updater(liveSettings);
-                }),
-            },
-            replication: {
-                markResolved: vi.fn(async () => {}),
-                markUnlocked: vi.fn(async () => {}),
-                markLocked: vi.fn(async () => {}),
-            },
-            replicator: {
-                getActiveReplicator: vi.fn(() => ({
-                    nodeid: "test-node-id",
-                    initializeDatabaseForReplication: vi.fn(async () => {}),
-                    connectRemoteCouchDBWithSetting: vi.fn(async () => ({
-                        db: {
-                            get: vi.fn(async (id) => {
-                                if (id.includes("milestone")) {
-                                    return {
-                                        locked: false,
-                                        accepted_nodes: ["test-node-id"],
-                                    };
-                                }
-                                throw new Error("not found");
-                            }),
-                        },
-                    })),
-                    getRemoteStatus: vi.fn(async () => ({
-                        db_name: "test-db",
-                        doc_count: 42,
-                    })),
-                })),
             },
         },
         serviceModules: {
@@ -98,115 +56,6 @@ async function createSetupURI(passphrase: string): Promise<string> {
     return await processSetting.encodeSettingsToSetupURI(settings, passphrase);
 }
 
-function captureStdout() {
-    const writes: string[] = [];
-    const spy = vi.spyOn(process.stdout, "write").mockImplementation((chunk: any) => {
-        writes.push(typeof chunk === "string" ? chunk : String(chunk));
-        return true;
-    });
-    return {
-        spy,
-        lines: () =>
-            writes
-                .join("")
-                .split("\n")
-                .map((e) => e.trim())
-                .filter((e) => e.length > 0),
-    };
-}
-
-function parseAddedRemoteIdFromLines(lines: string[]): string {
-    // remote-add prints: <id>\t<name>\t<redacted-connstr>
-    const last = lines.length > 0 ? lines[lines.length - 1] : "";
-    return last.split("\t")[0] || "";
-}
-
-type ProtocolFixture = {
-    protocol: string;
-    connectionString: string;
-    assertProjectedFields: (settings: any) => void;
-};
-
-const protocolFixtures: ProtocolFixture[] = [
-    {
-        protocol: "couchdb",
-        connectionString: ConnectionStringParser.serialize({
-            type: "couchdb",
-            settings: {
-                couchDB_URI: "https://db.example.com:5984",
-                couchDB_USER: "user1",
-                couchDB_PASSWORD: "pass1",
-                couchDB_DBNAME: "vault1",
-                couchDB_CustomHeaders: "",
-                useJWT: false,
-                jwtAlgorithm: "",
-                jwtKey: "",
-                jwtKid: "",
-                jwtSub: "",
-                jwtExpDuration: 5,
-                useRequestAPI: false,
-            },
-        }),
-        assertProjectedFields: (settings) => {
-            expect(settings.remoteType).toBe(REMOTE_COUCHDB);
-            expect(settings.couchDB_URI).toBe("https://db.example.com:5984");
-            expect(settings.couchDB_USER).toBe("user1");
-            expect(settings.couchDB_PASSWORD).toBe("pass1");
-            expect(settings.couchDB_DBNAME).toBe("vault1");
-        },
-    },
-    {
-        protocol: "s3",
-        connectionString: ConnectionStringParser.serialize({
-            type: "s3",
-            settings: {
-                accessKey: "ak",
-                secretKey: "sk",
-                endpoint: "https://s3.example.com",
-                bucket: "bucket-1",
-                region: "ap-northeast-1",
-                bucketPrefix: "vault/",
-                useCustomRequestHandler: true,
-                bucketCustomHeaders: "x-test:1",
-                forcePathStyle: false,
-            },
-        }),
-        assertProjectedFields: (settings) => {
-            expect(settings.remoteType).toBe(REMOTE_MINIO);
-            expect(settings.accessKey).toBe("ak");
-            expect(settings.secretKey).toBe("sk");
-            expect(settings.endpoint).toBe("https://s3.example.com");
-            expect(settings.bucket).toBe("bucket-1");
-            expect(settings.region).toBe("ap-northeast-1");
-        },
-    },
-    {
-        protocol: "p2p",
-        connectionString: ConnectionStringParser.serialize({
-            type: "p2p",
-            settings: {
-                P2P_Enabled: false,
-                P2P_roomID: "room-abc",
-                P2P_passphrase: "pass-123",
-                P2P_relays: "wss://relay.example",
-                P2P_AppID: "self-hosted-livesync",
-                P2P_AutoStart: true,
-                P2P_AutoBroadcast: false,
-                P2P_turnServers: "turn:turn.example:3478",
-                P2P_turnUsername: "turn-user",
-                P2P_turnCredential: "turn-pass",
-            },
-        }),
-        assertProjectedFields: (settings) => {
-            expect(settings.remoteType).toBe(REMOTE_P2P);
-            expect(settings.P2P_roomID).toBe("room-abc");
-            expect(settings.P2P_passphrase).toBe("pass-123");
-            expect(settings.P2P_relays).toBe("wss://relay.example");
-            expect(settings.P2P_AppID).toBe("self-hosted-livesync");
-        },
-    },
-];
-
 describe("runCommand abnormal cases", () => {
     const context = {
         databasePath: "/tmp/vault",
@@ -353,428 +202,4 @@ describe("runCommand abnormal cases", () => {
         expect(core.services.setting.applyExternalSettings).not.toHaveBeenCalled();
         expect(core.services.control.applySettings).not.toHaveBeenCalled();
     });
-
-    it("remote-add stores canonical URI and prints the created id", async () => {
-        const core = createCoreMock();
-        const stdout = vi.spyOn(process.stdout, "write").mockImplementation(() => true);
-
-        const result = await runCommand(makeOptions("remote-add", ["my-remote", "sls+https://example.com/db"]), {
-            ...context,
-            core,
-        });
-
-        expect(result).toBe(true);
-        const settings = core.services.setting.currentSettings();
-        const ids = Object.keys(settings.remoteConfigurations);
-        expect(ids.length).toBe(1);
-        expect(settings.remoteConfigurations[ids[0]].name).toBe("my-remote");
-        expect(settings.remoteConfigurations[ids[0]].uri).toContain("sls+https://example.com/db");
-        expect(settings.activeConfigurationId).toBe(ids[0]);
-        expect(stdout).toHaveBeenCalled();
-    });
-
-    it("remote-activate switches active remote and applies settings", async () => {
-        const core = createCoreMock();
-        const settings = core.services.setting.currentSettings();
-        settings.remoteConfigurations.r1 = {
-            id: "r1",
-            name: "R1",
-            uri: "sls+https://example.com/db1",
-            isEncrypted: false,
-        };
-        settings.remoteConfigurations.r2 = {
-            id: "r2",
-            name: "R2",
-            uri: "sls+https://example.com/db2",
-            isEncrypted: false,
-        };
-        settings.activeConfigurationId = "r1";
-
-        const result = await runCommand(makeOptions("remote-activate", ["r2"]), {
-            ...context,
-            core,
-        });
-
-        expect(result).toBe(true);
-        expect(settings.activeConfigurationId).toBe("r2");
-        expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
-    });
-
-    it("remote-rm removes active remote and promotes first remaining", async () => {
-        const core = createCoreMock();
-        const settings = core.services.setting.currentSettings();
-        settings.remoteConfigurations.r1 = {
-            id: "r1",
-            name: "R1",
-            uri: "sls+https://example.com/db1",
-            isEncrypted: false,
-        };
-        settings.remoteConfigurations.r2 = {
-            id: "r2",
-            name: "R2",
-            uri: "sls+https://example.com/db2",
-            isEncrypted: false,
-        };
-        settings.activeConfigurationId = "r1";
-
-        const result = await runCommand(makeOptions("remote-rm", ["r1"]), {
-            ...context,
-            core,
-        });
-
-        expect(result).toBe(true);
-        expect(settings.remoteConfigurations.r1).toBeUndefined();
-        expect(settings.activeConfigurationId).toBe("r2");
-        expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
-    });
-
-    it("remote-export prints the exact stored connection string", async () => {
-        const core = createCoreMock();
-        const settings = core.services.setting.currentSettings();
-        settings.remoteConfigurations.r1 = {
-            id: "r1",
-            name: "R1",
-            uri: "sls+https://example.com/db?db=vault",
-            isEncrypted: false,
-        };
-        const stdout = captureStdout();
-
-        const result = await runCommand(makeOptions("remote-export", ["r1"]), {
-            ...context,
-            core,
-        });
-
-        expect(result).toBe(true);
-        const outLines = stdout.lines();
-        expect(outLines.length > 0 ? outLines[outLines.length - 1] : "").toBe("sls+https://example.com/db?db=vault");
-        expect(stdout.spy).toHaveBeenCalled();
-    });
-
-    it("remote-set updates URI and applies settings when target is active", async () => {
-        const core = createCoreMock();
-        const settings = core.services.setting.currentSettings();
-        settings.remoteConfigurations.r1 = {
-            id: "r1",
-            name: "R1",
-            uri: "sls+https://old.example/db",
-            isEncrypted: false,
-        };
-        settings.activeConfigurationId = "r1";
-
-        const result = await runCommand(makeOptions("remote-set", ["r1", "sls+https://new.example/db"]), {
-            ...context,
-            core,
-        });
-
-        expect(result).toBe(true);
-        expect(settings.remoteConfigurations.r1.uri).toContain("sls+https://new.example/db");
-        expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
-    });
-
-    it.each(protocolFixtures)(
-        "remote-activate projects effective settings for $protocol",
-        async ({ connectionString, assertProjectedFields }) => {
-            const core = createCoreMock();
-            const settings = core.services.setting.currentSettings();
-            settings.remoteConfigurations.r1 = {
-                id: "r1",
-                name: "R1",
-                uri: "sls+https://old.example/?db=old",
-                isEncrypted: false,
-            };
-            settings.remoteConfigurations.r2 = {
-                id: "r2",
-                name: "R2",
-                uri: connectionString,
-                isEncrypted: false,
-            };
-            settings.activeConfigurationId = "r1";
-
-            const result = await runCommand(makeOptions("remote-activate", ["r2"]), {
-                ...context,
-                core,
-            });
-
-            expect(result).toBe(true);
-            expect(settings.activeConfigurationId).toBe("r2");
-            assertProjectedFields(settings);
-        }
-    );
-
-    it.each(protocolFixtures)(
-        "remote-set projects effective settings for active remote ($protocol)",
-        async ({ connectionString, assertProjectedFields }) => {
-            const core = createCoreMock();
-            const settings = core.services.setting.currentSettings();
-            settings.remoteConfigurations.r1 = {
-                id: "r1",
-                name: "R1",
-                uri: "sls+https://old.example/?db=old",
-                isEncrypted: false,
-            };
-            settings.activeConfigurationId = "r1";
-
-            const result = await runCommand(makeOptions("remote-set", ["r1", connectionString]), {
-                ...context,
-                core,
-            });
-
-            expect(result).toBe(true);
-            assertProjectedFields(settings);
-        }
-    );
-
-    it.each(protocolFixtures)(
-        "remote-rm projects promoted active remote effective settings for $protocol",
-        async ({ connectionString, assertProjectedFields }) => {
-            const core = createCoreMock();
-            const settings = core.services.setting.currentSettings();
-            settings.remoteConfigurations.r1 = {
-                id: "r1",
-                name: "R1",
-                uri: "sls+https://old.example/?db=old",
-                isEncrypted: false,
-            };
-            settings.remoteConfigurations.r2 = {
-                id: "r2",
-                name: "R2",
-                uri: connectionString,
-                isEncrypted: false,
-            };
-            settings.activeConfigurationId = "r1";
-
-            const result = await runCommand(makeOptions("remote-rm", ["r1"]), {
-                ...context,
-                core,
-            });
-
-            expect(result).toBe(true);
-            expect(settings.activeConfigurationId).toBe("r2");
-            assertProjectedFields(settings);
-        }
-    );
-
-    it.each([
-        ["couchdb", "sls+https://user:pass@example.com:5984/?db=vault"] as const,
-        [
-            "s3",
-            "sls+s3://ak:sk@example.com/?endpoint=https%3A%2F%2Fs3.example.com&bucket=my-bucket&region=ap-northeast-1",
-        ] as const,
-        [
-            "p2p",
-            "sls+p2p://room-abc?passphrase=pass-123&relays=wss%3A%2F%2Frelay.example&appId=self-hosted-livesync",
-        ] as const,
-    ])("remote command round-trip works for %s", async (_protocol, initialConnStr) => {
-        const core = createCoreMock();
-
-        const addOut = captureStdout();
-        const addResult = await runCommand(makeOptions("remote-add", ["rt", initialConnStr]), {
-            ...context,
-            core,
-        });
-        expect(addResult).toBe(true);
-        const remoteId = parseAddedRemoteIdFromLines(addOut.lines());
-        expect(remoteId).not.toBe("");
-
-        const export1Out = captureStdout();
-        const export1Result = await runCommand(makeOptions("remote-export", [remoteId]), {
-            ...context,
-            core,
-        });
-        expect(export1Result).toBe(true);
-        const export1Lines = export1Out.lines();
-        const exported1 = export1Lines.length > 0 ? export1Lines[export1Lines.length - 1] : "";
-        expect(exported1).toBe(ConnectionStringParser.serialize(ConnectionStringParser.parse(initialConnStr)));
-
-        const roundTripInput = ConnectionStringParser.serialize(ConnectionStringParser.parse(exported1));
-        const setResult = await runCommand(makeOptions("remote-set", [remoteId, roundTripInput]), {
-            ...context,
-            core,
-        });
-        expect(setResult).toBe(true);
-
-        const export2Out = captureStdout();
-        const export2Result = await runCommand(makeOptions("remote-export", [remoteId]), {
-            ...context,
-            core,
-        });
-        expect(export2Result).toBe(true);
-        const export2Lines = export2Out.lines();
-        const exported2 = export2Lines.length > 0 ? export2Lines[export2Lines.length - 1] : "";
-        expect(exported2).toBe(roundTripInput);
-    });
-
-    describe("runCommand with decoupled vault path", () => {
-        it("push resolves target path relative to vaultPath, not databasePath", async () => {
-            const core = createCoreMock();
-            const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "livesync-test-"));
-            const localVaultPath = path.join(tempDir, "vault");
-            const localDatabasePath = path.join(tempDir, "db");
-            await fs.mkdir(localVaultPath);
-            await fs.mkdir(localDatabasePath);
-
-            const fileInVault = path.join(localVaultPath, "existing.md");
-            await fs.writeFile(fileInVault, "hello", "utf-8");
-
-            const decoupledContext = {
-                databasePath: localDatabasePath,
-                vaultPath: localVaultPath,
-                settingsPath: path.join(localDatabasePath, ".livesync/settings.json"),
-            } as any;
-
-            const options = {
-                command: "push" as const,
-                commandArgs: [fileInVault, fileInVault],
-                databasePath: localDatabasePath,
-                vaultPath: localVaultPath,
-            };
-
-            try {
-                const result = await runCommand(options, { ...decoupledContext, core });
-                expect(result).toBe(true);
-                expect(core.serviceModules.storageAccess.writeFileAuto).toHaveBeenCalledWith(
-                    "existing.md",
-                    expect.any(ArrayBuffer),
-                    expect.any(Object)
-                );
-            } finally {
-                await fs.rm(tempDir, { recursive: true, force: true });
-            }
-        });
-    });
-
-    describe("mark-resolved and unlock-remote commands", () => {
-        it("mark-resolved without args runs on active database", async () => {
-            const core = createCoreMock();
-            const result = await runCommand(makeOptions("mark-resolved", []), {
-                ...context,
-                core,
-            });
-            expect(result).toBe(true);
-            expect(core.services.replication.markResolved).toHaveBeenCalledTimes(1);
-            expect(core.services.control.applySettings).not.toHaveBeenCalled();
-        });
-
-        it("mark-resolved with remote-id temporarily activates it and runs markResolved", async () => {
-            const core = createCoreMock();
-            const settings = core.services.setting.currentSettings();
-            settings.remoteConfigurations.r1 = {
-                id: "r1",
-                name: "R1",
-                uri: "sls+https://example.com/db1",
-                isEncrypted: false,
-            };
-
-            const result = await runCommand(makeOptions("mark-resolved", ["r1"]), {
-                ...context,
-                core,
-            });
-            expect(result).toBe(true);
-            expect(core.services.replication.markResolved).toHaveBeenCalledTimes(1);
-            expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
-            expect(settings.activeConfigurationId).toBe("r1");
-            expect(core.services.setting.updateSettings).toHaveBeenCalledWith(expect.any(Function), false);
-        });
-
-        it("unlock-remote without args runs on active database", async () => {
-            const core = createCoreMock();
-            const result = await runCommand(makeOptions("unlock-remote", []), {
-                ...context,
-                core,
-            });
-            expect(result).toBe(true);
-            expect(core.services.replication.markUnlocked).toHaveBeenCalledTimes(1);
-            expect(core.services.control.applySettings).not.toHaveBeenCalled();
-        });
-
-        it("unlock-remote with remote-id temporarily activates it and runs markUnlocked", async () => {
-            const core = createCoreMock();
-            const settings = core.services.setting.currentSettings();
-            settings.remoteConfigurations.r1 = {
-                id: "r1",
-                name: "R1",
-                uri: "sls+https://example.com/db1",
-                isEncrypted: false,
-            };
-
-            const result = await runCommand(makeOptions("unlock-remote", ["r1"]), {
-                ...context,
-                core,
-            });
-            expect(result).toBe(true);
-            expect(core.services.replication.markUnlocked).toHaveBeenCalledTimes(1);
-            expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
-            expect(settings.activeConfigurationId).toBe("r1");
-            expect(core.services.setting.updateSettings).toHaveBeenCalledWith(expect.any(Function), false);
-        });
-
-        it("lock-remote without args runs on active database", async () => {
-            const core = createCoreMock();
-            const result = await runCommand(makeOptions("lock-remote", []), {
-                ...context,
-                core,
-            });
-            expect(result).toBe(true);
-            expect(core.services.replication.markLocked).toHaveBeenCalledTimes(1);
-            expect(core.services.control.applySettings).not.toHaveBeenCalled();
-        });
-
-        it("lock-remote with remote-id temporarily activates it and runs markLocked", async () => {
-            const core = createCoreMock();
-            const settings = core.services.setting.currentSettings();
-            settings.remoteConfigurations.r1 = {
-                id: "r1",
-                name: "R1",
-                uri: "sls+https://example.com/db1",
-                isEncrypted: false,
-            };
-
-            const result = await runCommand(makeOptions("lock-remote", ["r1"]), {
-                ...context,
-                core,
-            });
-            expect(result).toBe(true);
-            expect(core.services.replication.markLocked).toHaveBeenCalledTimes(1);
-            expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
-            expect(settings.activeConfigurationId).toBe("r1");
-            expect(core.services.setting.updateSettings).toHaveBeenCalledWith(expect.any(Function), false);
-        });
-
-        it("remote-status without args outputs status of active remote configuration", async () => {
-            const core = createCoreMock();
-            const stdout = captureStdout();
-            const result = await runCommand(makeOptions("remote-status", []), {
-                ...context,
-                core,
-            });
-            expect(result).toBe(true);
-            const fullOutput = stdout.spy.mock.calls.map((c) => c[0]).join("");
-            const parsedStatus = JSON.parse(fullOutput);
-            expect(parsedStatus.db_name).toBe("test-db");
-            expect(parsedStatus.doc_count).toBe(42);
-        });
-
-        it("remote-status with remote-id temporarily activates it and outputs status", async () => {
-            const core = createCoreMock();
-            const settings = core.services.setting.currentSettings();
-            settings.remoteConfigurations.r1 = {
-                id: "r1",
-                name: "R1",
-                uri: "sls+https://example.com/db1",
-                isEncrypted: false,
-            };
-            const stdout = captureStdout();
-            const result = await runCommand(makeOptions("remote-status", ["r1"]), {
-                ...context,
-                core,
-            });
-            expect(result).toBe(true);
-            const fullOutput = stdout.spy.mock.calls.map((c) => c[0]).join("");
-            const parsedStatus = JSON.parse(fullOutput);
-            expect(parsedStatus.db_name).toBe("test-db");
-            expect(parsedStatus.doc_count).toBe(42);
-            expect(settings.activeConfigurationId).toBe("r1");
-            expect(core.services.setting.updateSettings).toHaveBeenCalledWith(expect.any(Function), false);
-        });
-    });
 });

src/apps/cli/commands/types.ts

@@ -1,6 +1,5 @@
 import { LiveSyncBaseCore } from "../../../LiveSyncBaseCore";
 import { ServiceContext } from "@lib/services/base/ServiceBase";
-import type { ObsidianLiveSyncSettings } from "@lib/common/types";
 
 export type CLICommand =
     | "daemon"
@@ -20,49 +19,25 @@ export type CLICommand =
     | "rm"
     | "resolve"
     | "mirror"
-    | "remote-add"
-    | "remote-rm"
-    | "remote-ls"
-    | "remote-export"
-    | "remote-set"
-    | "remote-activate"
-    | "mark-resolved"
-    | "unlock-remote"
-    | "lock-remote"
-    | "remote-status"
     | "init-settings";
 
 export interface CLIOptions {
     databasePath?: string;
-    vaultPath?: string;
     settingsPath?: string;
     verbose?: boolean;
     debug?: boolean;
     force?: boolean;
     command: CLICommand;
     commandArgs: string[];
-    interval?: number;
 }
 
 export interface CLICommandContext {
     databasePath: string;
-    vaultPath: string;
     core: LiveSyncBaseCore<ServiceContext, any>;
     settingsPath: string;
-    originalSyncSettings: Pick<
-        ObsidianLiveSyncSettings,
-        | "liveSync"
-        | "syncOnStart"
-        | "periodicReplication"
-        | "syncOnSave"
-        | "syncOnEditorSave"
-        | "syncOnFileOpen"
-        | "syncAfterMerge"
-    >;
 }
 
 export const VALID_COMMANDS = new Set([
-    "daemon",
     "sync",
     "p2p-peers",
     "p2p-sync",
@@ -79,15 +54,5 @@ export const VALID_COMMANDS = new Set([
     "rm",
     "resolve",
     "mirror",
-    "remote-add",
-    "remote-rm",
-    "remote-ls",
-    "remote-export",
-    "remote-set",
-    "remote-activate",
-    "mark-resolved",
-    "unlock-remote",
-    "lock-remote",
-    "remote-status",
     "init-settings",
 ] as const);

src/apps/cli/deploy/install.sh

@@ -1,187 +0,0 @@
-#!/usr/bin/env bash
-# install.sh — install livesync-cli as a systemd service
-#
-# Usage:
-#   install.sh [--user] [--system] [--vault <path>] [--interval <N>]
-#
-# Defaults: user install, prompts for vault path if not supplied.
-set -euo pipefail
-
-SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd -- "$SCRIPT_DIR/../../.." && pwd)"
-CLI_DIR="$REPO_ROOT/src/apps/cli"
-SERVICE_TEMPLATE="$SCRIPT_DIR/livesync-cli.service"
-
-# ── Argument parsing ────────────────────────────────────────────────────────
-INSTALL_MODE="user"
-VAULT_PATH=""
-INTERVAL=""
-FORCE=0
-
-while [[ $# -gt 0 ]]; do
-    case "$1" in
-        --user)
-            INSTALL_MODE="user"
-            shift
-            ;;
-        --system)
-            INSTALL_MODE="system"
-            shift
-            ;;
-        --vault)
-            if [[ -z "${2:-}" ]]; then
-                echo "Error: --vault requires a path argument" >&2
-                exit 1
-            fi
-            VAULT_PATH="$2"
-            shift 2
-            ;;
-        --interval)
-            if [[ -z "${2:-}" ]]; then
-                echo "Error: --interval requires a numeric argument" >&2
-                exit 1
-            fi
-            INTERVAL="$2"
-            if ! [[ "$INTERVAL" =~ ^[1-9][0-9]*$ ]]; then
-                echo "Error: --interval requires a positive integer, got '$INTERVAL'" >&2
-                exit 1
-            fi
-            shift 2
-            ;;
-        --force|-f)
-            FORCE=1
-            shift
-            ;;
-        --help|-h)
-            cat <<EOF
-Usage: install.sh [--user|--system] [--vault <path>] [--interval <N>] [--force]
-
-  --user       Install as a user systemd service (default, ~/.config/systemd/user/)
-  --system     Install as a system systemd service (/etc/systemd/system/)
-  --vault      Path to the vault directory (prompted if omitted)
-  --interval   Poll CouchDB every N seconds instead of using the _changes feed
-  --force      Overwrite existing service unit without prompting
-EOF
-            exit 0
-            ;;
-        *)
-            echo "Error: Unknown argument: $1" >&2
-            exit 1
-            ;;
-    esac
-done
-
-# ── Vault path ──────────────────────────────────────────────────────────────
-if [[ -z "$VAULT_PATH" ]]; then
-    if [ ! -t 0 ]; then
-        echo "Error: --vault is required in non-interactive mode" >&2
-        exit 1
-    fi
-    printf 'Vault path: '
-    read -r VAULT_PATH
-fi
-
-_orig_vault="$VAULT_PATH"
-if ! VAULT_PATH="$(cd -- "$VAULT_PATH" 2>/dev/null && pwd)"; then
-    echo "Error: vault directory does not exist: $_orig_vault" >&2
-    exit 1
-fi
-
-echo "[INFO] Vault: $VAULT_PATH"
-echo "[INFO] Install mode: $INSTALL_MODE"
-
-# ── Build ────────────────────────────────────────────────────────────────────
-echo "[INFO] Building CLI from $REPO_ROOT..."
-(cd "$REPO_ROOT" && npm install --silent)
-(cd "$CLI_DIR" && npm run build)
-
-BUILT_CJS="$CLI_DIR/dist/index.cjs"
-if [[ ! -f "$BUILT_CJS" ]]; then
-    echo "Error: build output not found: $BUILT_CJS" >&2
-    exit 1
-fi
-
-# ── Install binary ───────────────────────────────────────────────────────────
-if [[ "$INSTALL_MODE" == "user" ]]; then
-    BIN_DIR="$HOME/.local/bin"
-    UNIT_DIR="$HOME/.config/systemd/user"
-    SYSTEMCTL_FLAGS="--user"
-else
-    BIN_DIR="/usr/local/bin"
-    UNIT_DIR="/etc/systemd/system"
-    SYSTEMCTL_FLAGS=""
-fi
-
-mkdir -p "$BIN_DIR"
-
-LIVESYNC_BIN="$BIN_DIR/livesync-cli"
-LIVESYNC_JS="$BIN_DIR/livesync-cli.js"
-
-# Copy the CJS bundle so the wrapper is self-contained and independent of the
-# build directory location.
-cp "$BUILT_CJS" "$LIVESYNC_JS"
-
-# Write a bash wrapper that invokes node on the installed bundle.
-cat > "$LIVESYNC_BIN" <<WRAPPER
-#!/usr/bin/env bash
-exec node "$LIVESYNC_JS" "\$@"
-WRAPPER
-chmod +x "$LIVESYNC_BIN"
-echo "[INFO] Installed bundle:  $LIVESYNC_JS"
-echo "[INFO] Installed binary: $LIVESYNC_BIN"
-
-# ── Write systemd unit ───────────────────────────────────────────────────────
-mkdir -p "$UNIT_DIR"
-UNIT_PATH="$UNIT_DIR/livesync-cli.service"
-
-EXEC_START="\"$LIVESYNC_BIN\" \"$VAULT_PATH\""
-if [[ -n "$INTERVAL" ]]; then
-    EXEC_START="\"$LIVESYNC_BIN\" \"$VAULT_PATH\" --interval $INTERVAL"
-fi
-
-# Check for existing service and offer to overwrite.
-if [[ -f "$UNIT_PATH" ]] && [[ "$FORCE" -eq 0 ]]; then
-    if [ ! -t 0 ]; then
-        echo "Error: service unit already exists at $UNIT_PATH; use --force to overwrite" >&2
-        exit 1
-    fi
-    printf 'Service unit already exists at %s. Overwrite? [y/N]: ' "$UNIT_PATH"
-    read -r CONFIRM
-    case "$CONFIRM" in
-        [yY]|[yY][eE][sS]) : ;;
-        *)
-            echo "[INFO] Aborted. Existing unit left in place."
-            exit 0
-            ;;
-    esac
-fi
-
-# In awk gsub(), '&' in the replacement means "matched text"; escape any literal '&'
-# in path variables before passing them as awk replacement strings.
-AWK_BIN="${LIVESYNC_BIN//&/\\&}"
-AWK_VAULT="${VAULT_PATH//&/\\&}"
-awk -v bin="$AWK_BIN" -v vault="$AWK_VAULT" -v exec_start="ExecStart=$EXEC_START" \
-    '/^ExecStart=/ { print exec_start; next } {gsub("LIVESYNC_BIN", bin); gsub("LIVESYNC_VAULT_PATH", vault); print}' \
-    "$SERVICE_TEMPLATE" > "$UNIT_PATH"
-
-echo "[INFO] Installed unit: $UNIT_PATH"
-
-# ── Enable service ───────────────────────────────────────────────────────────
-if ! command -v systemctl >/dev/null 2>&1; then
-    echo "[WARN] systemctl not found — skipping service activation"
-    echo "[INFO] To enable manually, copy $UNIT_PATH to the correct systemd directory and run:"
-    echo "         systemctl $SYSTEMCTL_FLAGS daemon-reload"
-    echo "         systemctl $SYSTEMCTL_FLAGS enable --now livesync-cli"
-    exit 0
-fi
-
-# shellcheck disable=SC2086
-systemctl $SYSTEMCTL_FLAGS daemon-reload
-# shellcheck disable=SC2086
-systemctl $SYSTEMCTL_FLAGS enable --now livesync-cli
-
-echo ""
-echo "[Done] livesync-cli service installed and started."
-echo ""
-# shellcheck disable=SC2086
-systemctl $SYSTEMCTL_FLAGS status livesync-cli --no-pager || true

src/apps/cli/deploy/livesync-cli.service

@@ -1,17 +0,0 @@
-[Unit]
-Description=Self-hosted LiveSync CLI Daemon
-After=network-online.target
-Wants=network-online.target
-
-[Service]
-Type=simple
-ExecStart=LIVESYNC_BIN LIVESYNC_VAULT_PATH
-Restart=on-failure
-RestartSec=10
-TimeoutStartSec=300
-StandardOutput=journal
-StandardError=journal
-LimitNOFILE=65536
-
-[Install]
-WantedBy=default.target

src/apps/cli/main.ts

@@ -8,6 +8,7 @@ import * as path from "path";
 import { NodeServiceContext, NodeServiceHub } from "./services/NodeServiceHub";
 import { configureNodeLocalStorage, ensureGlobalNodeLocalStorage } from "./services/NodeLocalStorage";
 import { LiveSyncBaseCore } from "../../LiveSyncBaseCore";
+import { ModuleReplicatorP2P } from "../../modules/core/ModuleReplicatorP2P";
 import { initialiseServiceModulesCLI } from "./serviceModules/CLIServiceModules";
 import { DEFAULT_SETTINGS, LOG_LEVEL_VERBOSE, type LOG_LEVEL, type ObsidianLiveSyncSettings } from "@lib/common/types";
 import type { InjectableServiceHub } from "@lib/services/implements/injectable/InjectableServiceHub";
@@ -25,8 +26,6 @@ import { VALID_COMMANDS } from "./commands/types";
 import type { CLICommand, CLIOptions } from "./commands/types";
 import { getPathFromUXFileInfo } from "@lib/common/typeUtils";
 import { stripAllPrefixes } from "@lib/string_and_binary/path";
-import { IgnoreRules } from "./serviceModules/IgnoreRules";
-import { useP2PReplicatorFeature } from "@/lib/src/replication/trystero/useP2PReplicatorFeature";
 
 const SETTINGS_FILE = ".livesync/settings.json";
 ensureGlobalNodeLocalStorage();
@@ -44,8 +43,7 @@ Arguments:
   database-path           Path to the local database directory
 
 Commands:
-    daemon                  (default) Run mirror scan then continuously sync CouchDB <-> local filesystem
-    sync                    Run one replication cycle and exit
+  sync                    Run one replication cycle and exit
     p2p-peers <timeout>     Show discovered peers as [peer]\t<peer-id>\t<peer-name>
     p2p-sync <peer> <timeout>
                             Sync with the specified peer-id or peer-name
@@ -61,61 +59,25 @@ Commands:
     info <path>             Show detailed metadata for a file (ID, revision, conflicts, chunks)
     rm <path>               Mark a file as deleted in local database
     resolve <path> <rev>    Resolve conflicts by keeping <rev> and deleting others
-    mirror [vault-path]     Mirror database contents to the local file system (vault-path takes precedence over --vault; defaults to vault from --vault / database-path)
-    remote-add <name> <connstr>
-                            Add a remote configuration from a connection string
-    remote-rm <remote-id>    Remove a remote configuration by ID
-    remote-ls                List stored remote configurations
-    remote-export <remote-id>
-                            Export a remote connection string by ID
-    remote-set <remote-id> <connstr>
-                            Replace a stored remote connection string by ID
-    remote-activate <remote-id>
-                            Activate a stored remote configuration by ID
-    mark-resolved [remote-id]
-                            Resolve remote synchronisation status
-    unlock-remote [remote-id]
-                            Unlock remote database
-    lock-remote [remote-id]
-                            Lock remote database
-    remote-status [remote-id]
-                            Show remote database status
-
-Options:
-  --vault <path>, -V <path>  (daemon/mirror) Path to the vault directory containing .md files
-                              (defaults to database-path; allows separate PouchDB and vault dirs)
-  --interval <N>, -i <N>  (daemon only) Poll CouchDB every N seconds instead of using the _changes feed
-
+    mirror [vault-path]     Mirror database contents to the local file system (vault-path defaults to database-path)
 Examples:
-    livesync-cli ./my-database                        Run daemon (LiveSync mode)
-    livesync-cli ./my-database --interval 30          Run daemon (polling every 30s)
-    livesync-cli ./my-database sync
-    livesync-cli ./my-database p2p-peers 5
-    livesync-cli ./my-database p2p-sync my-peer-name 15
-    livesync-cli ./my-database p2p-host
-    livesync-cli ./my-database --settings ./custom-settings.json push ./note.md folder/note.md
-    livesync-cli ./my-database pull folder/note.md ./exports/note.md
-    livesync-cli ./my-database pull-rev folder/note.md ./exports/note.old.md 3-abcdef
-    livesync-cli ./my-database setup "obsidian://setuplivesync?settings=..."
-    echo "Hello" | livesync-cli ./my-database put notes/hello.md
-    livesync-cli ./my-database cat notes/hello.md
-    livesync-cli ./my-database cat-rev notes/hello.md 3-abcdef
-    livesync-cli ./my-database ls notes/
-    livesync-cli ./my-database info notes/hello.md
-    livesync-cli ./my-database rm notes/hello.md
-    livesync-cli ./my-database resolve notes/hello.md 3-abcdef
-    livesync-cli ./my-database remote-add my-remote "sls+https://user:pass@example.com/db"
-    livesync-cli ./my-database remote-ls
-    livesync-cli ./my-database remote-export remote-abc123
-    livesync-cli ./my-database remote-set remote-abc123 "sls+s3://ak:sk@example.com/?endpoint=https%3A%2F%2Fs3.example.com&bucket=mybucket"
-    livesync-cli ./my-database remote-activate remote-abc123
-    livesync-cli ./my-database remote-rm remote-abc123
-    livesync-cli ./my-database mark-resolved remote-abc123
-    livesync-cli ./my-database unlock-remote remote-abc123
-    livesync-cli ./my-database lock-remote remote-abc123
-    livesync-cli ./my-database remote-status remote-abc123
-    livesync-cli init-settings ./data.json
-    livesync-cli ./my-database --verbose
+  livesync-cli ./my-database sync
+  livesync-cli ./my-database p2p-peers 5
+  livesync-cli ./my-database p2p-sync my-peer-name 15
+  livesync-cli ./my-database p2p-host
+  livesync-cli ./my-database --settings ./custom-settings.json push ./note.md folder/note.md
+  livesync-cli ./my-database pull folder/note.md ./exports/note.md
+  livesync-cli ./my-database pull-rev folder/note.md ./exports/note.old.md 3-abcdef
+  livesync-cli ./my-database setup "obsidian://setuplivesync?settings=..."
+  echo "Hello" | livesync-cli ./my-database put notes/hello.md
+  livesync-cli ./my-database cat notes/hello.md
+  livesync-cli ./my-database cat-rev notes/hello.md 3-abcdef
+  livesync-cli ./my-database ls notes/
+  livesync-cli ./my-database info notes/hello.md
+  livesync-cli ./my-database rm notes/hello.md
+  livesync-cli ./my-database resolve notes/hello.md 3-abcdef
+  livesync-cli init-settings ./data.json
+  livesync-cli ./my-database --verbose
         `);
 }
 
@@ -128,28 +90,16 @@ export function parseArgs(): CLIOptions {
     }
 
     let databasePath: string | undefined;
-    let vaultPath: string | undefined;
     let settingsPath: string | undefined;
     let verbose = false;
     let debug = false;
     let force = false;
-    let interval: number | undefined;
     let command: CLICommand = "daemon";
     const commandArgs: string[] = [];
 
     for (let i = 0; i < args.length; i++) {
         const token = args[i];
         switch (token) {
-            case "--vault":
-            case "-V": {
-                i++;
-                if (!args[i]) {
-                    console.error(`Error: Missing value for ${token}`);
-                    process.exit(1);
-                }
-                vaultPath = args[i];
-                break;
-            }
             case "--settings":
             case "-s": {
                 i++;
@@ -160,21 +110,6 @@ export function parseArgs(): CLIOptions {
                 settingsPath = args[i];
                 break;
             }
-            case "--interval":
-            case "-i": {
-                i++;
-                if (!args[i]) {
-                    console.error(`Error: Missing value for ${token}`);
-                    process.exit(1);
-                }
-                const n = parseInt(args[i], 10);
-                if (!Number.isInteger(n) || n <= 0) {
-                    console.error(`Error: --interval requires a positive integer, got '${args[i]}'`);
-                    process.exit(1);
-                }
-                interval = n;
-                break;
-            }
             case "--debug":
             case "-d":
                 // debugging automatically enables verbose logging, as it is intended for debugging issues.
@@ -223,14 +158,12 @@ export function parseArgs(): CLIOptions {
 
     return {
         databasePath,
-        vaultPath,
         settingsPath,
         verbose,
         debug,
         force,
         command,
         commandArgs,
-        interval,
     };
 }
 
@@ -264,24 +197,14 @@ async function createDefaultSettingsFile(options: CLIOptions) {
 
 export async function main() {
     const options = parseArgs();
-    if (options.interval && options.command !== "daemon") {
-        console.error(`Warning: --interval is only used in daemon mode, ignored for '${options.command}'`);
-    }
     const avoidStdoutNoise =
         options.command === "cat" ||
         options.command === "cat-rev" ||
         options.command === "ls" ||
-        options.command === "remote-add" ||
-        options.command === "remote-ls" ||
-        options.command === "remote-export" ||
         options.command === "p2p-peers" ||
         options.command === "info" ||
         options.command === "rm" ||
-        options.command === "resolve" ||
-        options.command === "mark-resolved" ||
-        options.command === "unlock-remote" ||
-        options.command === "lock-remote" ||
-        options.command === "remote-status";
+        options.command === "resolve";
     const infoLog = avoidStdoutNoise ? console.error : console.log;
     if (options.debug) {
         setGlobalLogFunction((msg, level) => {
@@ -320,40 +243,10 @@ export async function main() {
         : path.join(databasePath, SETTINGS_FILE);
     configureNodeLocalStorage(path.join(databasePath, ".livesync", "runtime", "local-storage.json"));
 
-    // Resolve vault path: mirror positional argument takes priority,
-    // then --vault flag, otherwise fall back to databasePath.
-    // For daemon mode, enable chokidar file watching so the _changes feed picks up events.
-    // mirror runs a single full scan and doesn't need continuous watching.
-    const watchEnabled = options.command === "daemon";
-    const vaultPath =
-        options.command === "mirror" && options.commandArgs[0]
-            ? path.resolve(options.commandArgs[0])
-            : options.vaultPath
-              ? path.resolve(options.vaultPath)
-              : databasePath!;
-
-    // Check if vault directory exists
-    try {
-        const stat = await fs.stat(vaultPath);
-        if (!stat.isDirectory()) {
-            console.error(`Error: Vault path ${vaultPath} is not a directory`);
-            process.exit(1);
-        }
-    } catch (error) {
-        console.error(`Error: Vault directory ${vaultPath} does not exist`);
-        process.exit(1);
-    }
-
     infoLog(`Self-hosted LiveSync CLI`);
     infoLog(`Database Path: ${databasePath}`);
-    infoLog(`Vault Path:    ${vaultPath}`);
     infoLog(`Settings: ${settingsPath}`);
     infoLog("");
-    let ignoreRules: IgnoreRules | undefined;
-    if (options.command === "daemon" || options.command === "mirror") {
-        ignoreRules = new IgnoreRules(vaultPath);
-        await ignoreRules.load();
-    }
 
     // Create service context and hub
     const context = new NodeServiceContext(databasePath);
@@ -385,14 +278,11 @@ export async function main() {
         }
         console.error(`${prefix} ${message}`);
     });
-    // Prevent replication result from being processed automatically in non-daemon commands.
-    // In daemon mode the default handler must run so changes are applied to the filesystem.
-    if (options.command !== "daemon") {
-        serviceHubInstance.replication.processSynchroniseResult.addHandler(async () => {
-            console.error(`[Info] Replication result received, but not processed automatically in CLI mode.`);
-            return await Promise.resolve(true);
-        }, -100);
-    }
+    // Prevent replication result to be processed automatically.
+    serviceHubInstance.replication.processSynchroniseResult.addHandler(async () => {
+        console.error(`[Info] Replication result received, but not processed automatically in CLI mode.`);
+        return await Promise.resolve(true);
+    }, -100);
 
     // Setup settings handlers
     const settingService = serviceHubInstance.setting;
@@ -434,13 +324,18 @@ export async function main() {
     const core = new LiveSyncBaseCore(
         serviceHubInstance,
         (core: LiveSyncBaseCore<NodeServiceContext, any>, serviceHub: InjectableServiceHub<NodeServiceContext>) => {
-            return initialiseServiceModulesCLI(vaultPath, core, serviceHub, ignoreRules, watchEnabled);
+            const mirrorVaultPath =
+                options.command === "mirror" && options.commandArgs[0]
+                    ? path.resolve(options.commandArgs[0])
+                    : databasePath;
+            return initialiseServiceModulesCLI(mirrorVaultPath, core, serviceHub);
         },
-        (core) => [],
+        (core) => [
+            // No modules need to be registered for P2P replication in CLI. Directly using Replicators in p2p.ts
+            // new ModuleReplicatorP2P(core),
+        ],
         () => [], // No add-ons
         (core) => {
-            // Register P2P replicator feature.
-            const _replicator = useP2PReplicatorFeature(core);
             // Add target filter to prevent internal files are handled
             core.services.vault.isTargetFile.addHandler(async (target) => {
                 const targetPath = stripAllPrefixes(getPathFromUXFileInfo(target));
@@ -449,25 +344,8 @@ export async function main() {
                 if (parts.some((part) => part.startsWith("."))) {
                     return await Promise.resolve(false);
                 }
-                // PouchDB LevelDB database directory lives in the vault directory.
-                if (parts[0]?.endsWith("-livesync-v2")) {
-                    return await Promise.resolve(false);
-                }
                 return await Promise.resolve(true);
             }, -1 /* highest priority */);
-
-            // Apply user-defined ignore rules for daemon mode (lower priority, runs after dotfile check).
-            if (ignoreRules) {
-                const rules = ignoreRules;
-                core.services.vault.isTargetFile.addHandler(async (target) => {
-                    const targetPath = stripAllPrefixes(getPathFromUXFileInfo(target));
-                    if (rules.shouldIgnore(targetPath)) {
-                        return false;
-                    }
-                    // undefined = pass through to next handler in chain
-                    return undefined;
-                }, 0);
-            }
         }
     );
 
@@ -488,25 +366,6 @@ export async function main() {
     process.on("SIGINT", () => shutdown("SIGINT"));
     process.on("SIGTERM", () => shutdown("SIGTERM"));
 
-    // Save the settings file before any lifecycle events can mutate and persist them.
-    // suspendAllSync and other lifecycle hooks clobber sync settings in memory, and
-    // various code paths persist the clobbered state to disk. We restore on shutdown.
-    const settingsBackup = await fs.readFile(settingsPath, "utf-8").catch(() => null!);
-
-    // Restore settings file on any exit to undo lifecycle mutations.
-    // Write to a temp path first so a crash mid-write doesn't leave a truncated file.
-    process.on("exit", () => {
-        if (settingsBackup) {
-            const tmpPath = settingsPath + ".tmp";
-            try {
-                require("fs").writeFileSync(tmpPath, settingsBackup, "utf-8");
-                require("fs").renameSync(tmpPath, settingsPath);
-            } catch (err) {
-                console.error("[Settings] Failed to restore settings on exit:", err);
-            }
-        }
-    });
-
     // Start the core
     try {
         infoLog(`[Starting] Initializing LiveSync...`);
@@ -516,18 +375,6 @@ export async function main() {
             console.error(`[Error] Failed to initialize LiveSync`);
             process.exit(1);
         }
-        // Capture sync settings before suspendAllSync() clobbers them.
-        // Used by daemon mode to restore the correct sync behaviour after the mirror scan.
-        const settingsBeforeSuspend = core.services.setting.currentSettings();
-        const originalSyncSettings = {
-            liveSync: settingsBeforeSuspend.liveSync,
-            syncOnStart: settingsBeforeSuspend.syncOnStart,
-            periodicReplication: settingsBeforeSuspend.periodicReplication,
-            syncOnSave: settingsBeforeSuspend.syncOnSave,
-            syncOnEditorSave: settingsBeforeSuspend.syncOnEditorSave,
-            syncOnFileOpen: settingsBeforeSuspend.syncOnFileOpen,
-            syncAfterMerge: settingsBeforeSuspend.syncAfterMerge,
-        };
         await core.services.setting.suspendAllSync();
         await core.services.control.onReady();
 
@@ -553,7 +400,7 @@ export async function main() {
             infoLog("");
         }
 
-        const result = await runCommand(options, { databasePath, vaultPath, core, settingsPath, originalSyncSettings });
+        const result = await runCommand(options, { databasePath, core, settingsPath });
         if (!result) {
             console.error(`[Error] Command '${options.command}' failed`);
             process.exitCode = 1;
@@ -561,7 +408,7 @@ export async function main() {
             infoLog(`[Done] Command '${options.command}' completed`);
         }
 
-        if (options.command === "daemon" && result) {
+        if (options.command === "daemon") {
             // Keep the process running
             await new Promise(() => {});
         } else {

src/apps/cli/main.unit.spec.ts

@@ -85,117 +85,4 @@ describe("CLI parseArgs", () => {
         expect(parsed.command).toBe("p2p-host");
         expect(parsed.commandArgs).toEqual([]);
     });
-
-    it("parses remote-add command", () => {
-        process.argv = [
-            "node",
-            "livesync-cli",
-            "./databasePath",
-            "remote-add",
-            "my-remote",
-            "sls+https://user:pass@example.com/db",
-        ];
-        const parsed = parseArgs();
-
-        expect(parsed.databasePath).toBe("./databasePath");
-        expect(parsed.command).toBe("remote-add");
-        expect(parsed.commandArgs).toEqual(["my-remote", "sls+https://user:pass@example.com/db"]);
-    });
-
-    it("parses remote-activate command", () => {
-        process.argv = ["node", "livesync-cli", "./databasePath", "remote-activate", "remote-abc"];
-        const parsed = parseArgs();
-
-        expect(parsed.databasePath).toBe("./databasePath");
-        expect(parsed.command).toBe("remote-activate");
-        expect(parsed.commandArgs).toEqual(["remote-abc"]);
-    });
-
-    it("parses remote-export command", () => {
-        process.argv = ["node", "livesync-cli", "./databasePath", "remote-export", "remote-abc"];
-        const parsed = parseArgs();
-
-        expect(parsed.databasePath).toBe("./databasePath");
-        expect(parsed.command).toBe("remote-export");
-        expect(parsed.commandArgs).toEqual(["remote-abc"]);
-    });
-
-    it("parses remote-set command", () => {
-        process.argv = [
-            "node",
-            "livesync-cli",
-            "./databasePath",
-            "remote-set",
-            "remote-abc",
-            "sls+p2p://room-1?passphrase=abc",
-        ];
-        const parsed = parseArgs();
-
-        expect(parsed.databasePath).toBe("./databasePath");
-        expect(parsed.command).toBe("remote-set");
-        expect(parsed.commandArgs).toEqual(["remote-abc", "sls+p2p://room-1?passphrase=abc"]);
-    });
-
-    it("parses --interval flag with valid integer", () => {
-        process.argv = ["node", "livesync-cli", "./vault", "--interval", "30"];
-        const parsed = parseArgs();
-        expect(parsed.command).toBe("daemon");
-        expect(parsed.interval).toBe(30);
-    });
-
-    it("parses -i shorthand for --interval", () => {
-        process.argv = ["node", "livesync-cli", "./vault", "-i", "10"];
-        const parsed = parseArgs();
-        expect(parsed.interval).toBe(10);
-    });
-
-    it("exits 1 when --interval has no value", () => {
-        process.argv = ["node", "livesync-cli", "./vault", "--interval"];
-        const exitMock = mockProcessExit();
-        vi.spyOn(console, "error").mockImplementation(() => {});
-        expect(() => parseArgs()).toThrowError("__EXIT__:1");
-        expect(exitMock).toHaveBeenCalledWith(1);
-    });
-
-    it("exits 1 when --interval is not a positive integer", () => {
-        process.argv = ["node", "livesync-cli", "./vault", "--interval", "0"];
-        const exitMock = mockProcessExit();
-        vi.spyOn(console, "error").mockImplementation(() => {});
-        expect(() => parseArgs()).toThrowError("__EXIT__:1");
-        expect(exitMock).toHaveBeenCalledWith(1);
-    });
-
-    it("exits 1 when --interval is negative", () => {
-        process.argv = ["node", "livesync-cli", "./vault", "--interval", "-5"];
-        const exitMock = mockProcessExit();
-        vi.spyOn(console, "error").mockImplementation(() => {});
-        expect(() => parseArgs()).toThrowError("__EXIT__:1");
-    });
-
-    it("exits 1 when --interval is not numeric", () => {
-        process.argv = ["node", "livesync-cli", "./vault", "--interval", "abc"];
-        const exitMock = mockProcessExit();
-        vi.spyOn(console, "error").mockImplementation(() => {});
-        expect(() => parseArgs()).toThrowError("__EXIT__:1");
-    });
-
-    it("parses explicit daemon command", () => {
-        process.argv = ["node", "livesync-cli", "./vault", "daemon"];
-        const parsed = parseArgs();
-        expect(parsed.command).toBe("daemon");
-        expect(parsed.databasePath).toBe("./vault");
-    });
-
-    it("defaults to daemon when no command specified", () => {
-        process.argv = ["node", "livesync-cli", "./vault"];
-        const parsed = parseArgs();
-        expect(parsed.command).toBe("daemon");
-    });
-
-    it("parses explicit daemon command with --interval", () => {
-        process.argv = ["node", "livesync-cli", "./vault", "daemon", "--interval", "30"];
-        const parsed = parseArgs();
-        expect(parsed.command).toBe("daemon");
-        expect(parsed.interval).toBe(30);
-    });
 });

src/apps/cli/managers/CLIStorageEventManagerAdapter.ts

@@ -11,11 +11,8 @@ import type {
 } from "@lib/managers/adapters";
 import type { FileEventItemSentinel } from "@lib/managers/StorageEventManager";
 import type { NodeFile, NodeFolder } from "../adapters/NodeTypes";
-import type { Stats } from "fs";
 import * as fs from "fs/promises";
 import * as path from "path";
-import { watch as chokidarWatch, type FSWatcher } from "chokidar";
-import type { IgnoreRules } from "../serviceModules/IgnoreRules";
 
 /**
  * CLI-specific type guard adapter
@@ -59,11 +56,22 @@ class CLIPersistenceAdapter implements IStorageEventPersistenceAdapter {
 }
 
 /**
- * CLI-specific status adapter (no-op — daemon uses journald for status)
+ * CLI-specific status adapter (console logging)
  */
 class CLIStatusAdapter implements IStorageEventStatusAdapter {
-    updateStatus(_status: { batched: number; processing: number; totalQueued: number }): void {
-        // intentional no-op
+    private lastUpdate = 0;
+    private updateInterval = 5000; // Update every 5 seconds
+
+    updateStatus(status: { batched: number; processing: number; totalQueued: number }): void {
+        const now = Date.now();
+        if (now - this.lastUpdate > this.updateInterval) {
+            if (status.totalQueued > 0 || status.processing > 0) {
+                // console.log(
+                //     `[StorageEventManager] Batched: ${status.batched}, Processing: ${status.processing}, Total Queued: ${status.totalQueued}`
+                // );
+            }
+            this.lastUpdate = now;
+        }
     }
 }
 
@@ -92,101 +100,15 @@ class CLIConverterAdapter implements IStorageEventConverterAdapter<NodeFile> {
 }
 
 /**
- * CLI-specific watch adapter using chokidar for real-time filesystem monitoring.
+ * CLI-specific watch adapter (optional file watching with chokidar)
  */
 class CLIWatchAdapter implements IStorageEventWatchAdapter {
-    private _watcher: FSWatcher | undefined;
-
-    constructor(
-        private basePath: string,
-        private ignoreRules?: IgnoreRules,
-        private watchEnabled: boolean = false
-    ) {}
-
-    private _toNodeFile(filePath: string, stats: Stats | undefined): NodeFile {
-        return {
-            path: path.relative(this.basePath, filePath).replace(/\\/g, "/") as FilePath,
-            stat: {
-                ctime: stats?.ctimeMs ?? Date.now(),
-                mtime: stats?.mtimeMs ?? Date.now(),
-                size: stats?.size ?? 0,
-                type: "file",
-            },
-        };
-    }
-
-    private _toNodeFolder(dirPath: string): NodeFolder {
-        return {
-            path: path.relative(this.basePath, dirPath).replace(/\\/g, "/") as FilePath,
-            isFolder: true,
-        };
-    }
+    constructor(private basePath: string) {}
 
     async beginWatch(handlers: IStorageEventWatchHandlers): Promise<void> {
-        if (!this.watchEnabled) return;
-        const baseIgnored: Array<RegExp | string | ((p: string) => boolean)> = [
-            /(^|[/\\])\./,
-            /(^|[/\\])[^/\\]*-livesync-v2([/\\]|$)/,
-        ];
-        // Bind rules to a local const before the closure — chokidar v4 requires a
-        // MatchFunction, not glob strings, for custom patterns.
-        const rules = this.ignoreRules;
-        const ignored = rules
-            ? [...baseIgnored, (p: string) => rules.shouldIgnore(path.relative(this.basePath, p))]
-            : baseIgnored;
-
-        const watcher = chokidarWatch(this.basePath, {
-            ignored,
-            ignoreInitial: true,
-            persistent: true,
-            awaitWriteFinish: {
-                stabilityThreshold: 500,
-                pollInterval: 100,
-            },
-        });
-
-        watcher.on("add", (filePath, stats) => {
-            const nodeFile = this._toNodeFile(filePath, stats);
-            handlers.onCreate(nodeFile);
-        });
-
-        watcher.on("change", (filePath, stats) => {
-            const nodeFile = this._toNodeFile(filePath, stats);
-            handlers.onChange(nodeFile);
-        });
-
-        watcher.on("unlink", (filePath) => {
-            const nodeFile = this._toNodeFile(filePath, undefined);
-            handlers.onDelete(nodeFile);
-        });
-
-        watcher.on("addDir", (dirPath) => {
-            const nodeFolder = this._toNodeFolder(dirPath);
-            handlers.onCreate(nodeFolder);
-        });
-
-        watcher.on("unlinkDir", (dirPath) => {
-            const nodeFolder = this._toNodeFolder(dirPath);
-            handlers.onDelete(nodeFolder);
-        });
-
-        watcher.on("error", (err) => {
-            console.error("[CLIWatchAdapter] Fatal watcher error — file watching stopped:", err);
-            console.error("[CLIWatchAdapter] Exiting for systemd restart.");
-            void watcher.close();
-            this._watcher = undefined;
-            // Use exit(1) rather than SIGTERM so systemd Restart=on-failure engages.
-            process.exit(1);
-        });
-
-        await new Promise<void>((resolve) => watcher.once("ready", resolve));
-        this._watcher = watcher;
-    }
-
-    close(): Promise<void> {
-        if (this._watcher) {
-            return this._watcher.close();
-        }
+        // File watching is not activated in the CLI.
+        // Because the CLI is designed for push/pull operations, not real-time sync.
+        // console.error("[CLIWatchAdapter] File watching is not enabled in CLI version");
         return Promise.resolve();
     }
 }
@@ -201,15 +123,11 @@ export class CLIStorageEventManagerAdapter implements IStorageEventManagerAdapte
     readonly status: CLIStatusAdapter;
     readonly converter: CLIConverterAdapter;
 
-    constructor(basePath: string, ignoreRules?: IgnoreRules, watchEnabled: boolean = false) {
+    constructor(basePath: string) {
         this.typeGuard = new CLITypeGuardAdapter();
         this.persistence = new CLIPersistenceAdapter(basePath);
-        this.watch = new CLIWatchAdapter(basePath, ignoreRules, watchEnabled);
+        this.watch = new CLIWatchAdapter(basePath);
         this.status = new CLIStatusAdapter();
         this.converter = new CLIConverterAdapter();
     }
-
-    close(): Promise<void> {
-        return this.watch.close();
-    }
 }

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

@@ -1,123 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from "vitest";
-import type { IStorageEventWatchHandlers } from "@lib/managers/adapters";
-import type { NodeFile } from "../adapters/NodeTypes";
-
-// ── chokidar mock ──────────────────────────────────────────────────────────────
-// Must be hoisted before imports that pull in chokidar.
-
-const mockWatcher = {
-    on: vi.fn().mockReturnThis(),
-    once: vi.fn((event: string, cb: () => void) => {
-        if (event === "ready") cb();
-        return mockWatcher;
-    }),
-    close: vi.fn(() => Promise.resolve()),
-};
-
-vi.mock("chokidar", () => ({
-    watch: vi.fn(() => mockWatcher),
-}));
-
-import * as chokidar from "chokidar";
-import { CLIStorageEventManagerAdapter } from "./CLIStorageEventManagerAdapter";
-
-// ── helpers ───────────────────────────────────────────────────────────────────
-
-function makeHandlers(): IStorageEventWatchHandlers {
-    return {
-        onCreate: vi.fn(),
-        onChange: vi.fn(),
-        onDelete: vi.fn(),
-        onRename: vi.fn(),
-    } as any;
-}
-
-// ── tests ─────────────────────────────────────────────────────────────────────
-
-describe("CLIStorageEventManagerAdapter", () => {
-    beforeEach(() => {
-        vi.clearAllMocks();
-        // Restore the default once() behaviour (ready fires synchronously).
-        mockWatcher.once.mockImplementation((event: string, cb: () => void) => {
-            if (event === "ready") cb();
-            return mockWatcher;
-        });
-    });
-
-    it("beginWatch is no-op when watchEnabled=false", async () => {
-        const adapter = new CLIStorageEventManagerAdapter("/base", undefined, false);
-        const handlers = makeHandlers();
-
-        await adapter.watch.beginWatch(handlers);
-
-        expect(chokidar.watch).not.toHaveBeenCalled();
-    });
-
-    it("beginWatch calls chokidar.watch when watchEnabled=true", async () => {
-        const adapter = new CLIStorageEventManagerAdapter("/base", undefined, true);
-        const handlers = makeHandlers();
-
-        await adapter.watch.beginWatch(handlers);
-
-        expect(chokidar.watch).toHaveBeenCalledTimes(1);
-        expect(chokidar.watch).toHaveBeenCalledWith("/base", expect.objectContaining({ ignoreInitial: true }));
-    });
-
-    it("add event produces NodeFile with correct relative path via onCreate", async () => {
-        const basePath = "/vault/base";
-        const adapter = new CLIStorageEventManagerAdapter(basePath, undefined, true);
-        const handlers = makeHandlers();
-
-        await adapter.watch.beginWatch(handlers);
-
-        // Find the callback registered for the "add" event.
-        const addCall = mockWatcher.on.mock.calls.find(([event]) => event === "add");
-        expect(addCall).toBeDefined();
-        const addCallback = addCall![1] as (filePath: string, stats: any) => void;
-
-        const fakeStats = { ctimeMs: 1000, mtimeMs: 2000, size: 42 };
-        addCallback(`${basePath}/subdir/note.md`, fakeStats);
-
-        expect(handlers.onCreate).toHaveBeenCalledTimes(1);
-        const created = (handlers.onCreate as ReturnType<typeof vi.fn>).mock.calls[0][0] as NodeFile;
-        expect(created.path).toBe("subdir/note.md");
-        expect(created.stat?.size).toBe(42);
-    });
-
-    it("close() calls watcher.close()", async () => {
-        const adapter = new CLIStorageEventManagerAdapter("/base", undefined, true);
-        const handlers = makeHandlers();
-
-        await adapter.watch.beginWatch(handlers);
-        await adapter.close();
-
-        expect(mockWatcher.close).toHaveBeenCalledTimes(1);
-    });
-
-    it("close() is safe when no watcher was started", async () => {
-        const adapter = new CLIStorageEventManagerAdapter("/base", undefined, false);
-
-        // Should not throw.
-        await expect(adapter.close()).resolves.toBeUndefined();
-        expect(mockWatcher.close).not.toHaveBeenCalled();
-    });
-
-    it("error event triggers process.exit(1)", async () => {
-        const adapter = new CLIStorageEventManagerAdapter("/base", undefined, true);
-        const handlers = makeHandlers();
-
-        await adapter.watch.beginWatch(handlers);
-
-        const processExitSpy = vi.spyOn(process, "exit").mockImplementation((() => {}) as any);
-
-        const errorCall = mockWatcher.on.mock.calls.find(([event]) => event === "error");
-        expect(errorCall).toBeDefined();
-        const errorCallback = errorCall![1] as (err: Error) => void;
-
-        errorCallback(new Error("disk failure"));
-
-        expect(processExitSpy).toHaveBeenCalledWith(1);
-
-        processExitSpy.mockRestore();
-    });
-});

src/apps/cli/managers/StorageEventManagerCLI.ts

@@ -2,7 +2,6 @@ import { StorageEventManagerBase, type StorageEventManagerBaseDependencies } fro
 import { CLIStorageEventManagerAdapter } from "./CLIStorageEventManagerAdapter";
 import type { IMinimumLiveSyncCommands, LiveSyncBaseCore } from "../../../LiveSyncBaseCore";
 import type { ServiceContext } from "@lib/services/base/ServiceBase";
-import type { IgnoreRules } from "../serviceModules/IgnoreRules";
 // import type { IMinimumLiveSyncCommands } from "@lib/services/base/IService";
 
 export class StorageEventManagerCLI extends StorageEventManagerBase<CLIStorageEventManagerAdapter> {
@@ -11,11 +10,9 @@ export class StorageEventManagerCLI extends StorageEventManagerBase<CLIStorageEv
     constructor(
         basePath: string,
         core: LiveSyncBaseCore<ServiceContext, IMinimumLiveSyncCommands>,
-        dependencies: StorageEventManagerBaseDependencies,
-        ignoreRules?: IgnoreRules,
-        watchEnabled?: boolean
+        dependencies: StorageEventManagerBaseDependencies
     ) {
-        const adapter = new CLIStorageEventManagerAdapter(basePath, ignoreRules, watchEnabled);
+        const adapter = new CLIStorageEventManagerAdapter(basePath);
         super(adapter, dependencies);
         this.core = core;
     }
@@ -28,11 +25,4 @@ export class StorageEventManagerCLI extends StorageEventManagerBase<CLIStorageEv
         // No-op in CLI version
         // Internal file handling is not needed
     }
-
-    /**
-     * Close the file watcher. Call this during graceful shutdown.
-     */
-    close(): Promise<void> {
-        return this.adapter.close();
-    }
 }

src/apps/cli/package.json

@@ -6,7 +6,6 @@
     "type": "module",
     "scripts": {
         "dev": "vite",
-        "prebuild": "node scripts/check-submodule.mjs",
         "build": "vite build",
         "preview": "vite preview",
         "cli": "node dist/index.cjs",
@@ -25,18 +24,16 @@
         "test:e2e:p2p-host": "bash test/test-p2p-host-linux.sh",
         "test:e2e:p2p-sync": "bash test/test-p2p-sync-linux.sh",
         "test:e2e:mirror": "bash test/test-mirror-linux.sh",
-        "test:e2e:remote-commands": "bash test/test-remote-commands-linux.sh",
         "pretest:e2e:all": "npm run build",
-        "test:e2e:all": " export RUN_BUILD=0 && npm run test:e2e:setup-put-cat && npm run test:e2e:push-pull && npm run test:e2e:sync-two-local && npm run test:e2e:p2p && npm run test:e2e:mirror && npm run test:e2e:two-vaults && npm run test:e2e:remote-commands",
+        "test:e2e:all": " export RUN_BUILD=0 && npm run test:e2e:setup-put-cat && npm run test:e2e:push-pull && npm run test:e2e:sync-two-local && npm run test:e2e:p2p && npm run test:e2e:mirror && npm run test:e2e:two-vaults && npm run test:e2e:p2p",
         "pretest:e2e:docker:all": "npm run build:docker",
         "test:e2e:docker:push-pull": "RUN_BUILD=0 LIVESYNC_TEST_DOCKER=1 bash test/test-push-pull-linux.sh",
         "test:e2e:docker:setup-put-cat": "RUN_BUILD=0 LIVESYNC_TEST_DOCKER=1 bash test/test-setup-put-cat-linux.sh",
         "test:e2e:docker:mirror": "RUN_BUILD=0 LIVESYNC_TEST_DOCKER=1 bash test/test-mirror-linux.sh",
-        "test:e2e:docker:remote-commands": "RUN_BUILD=0 LIVESYNC_TEST_DOCKER=1 bash test/test-remote-commands-linux.sh",
         "test:e2e:docker:sync-two-local": "RUN_BUILD=0 LIVESYNC_TEST_DOCKER=1 bash test/test-sync-two-local-databases-linux.sh",
         "test:e2e:docker:p2p": "RUN_BUILD=0 LIVESYNC_TEST_DOCKER=1 bash test/test-p2p-three-nodes-conflict-linux.sh",
         "test:e2e:docker:p2p-sync": "RUN_BUILD=0 LIVESYNC_TEST_DOCKER=1 bash test/test-p2p-sync-linux.sh",
-        "test:e2e:docker:all": "export RUN_BUILD=0 && npm run test:e2e:docker:setup-put-cat && npm run test:e2e:docker:push-pull && npm run test:e2e:docker:sync-two-local && npm run test:e2e:docker:mirror && npm run test:e2e:docker:remote-commands"
+        "test:e2e:docker:all": "export RUN_BUILD=0 && npm run test:e2e:docker:setup-put-cat && npm run test:e2e:docker:push-pull && npm run test:e2e:docker:sync-two-local && npm run test:e2e:docker:mirror"
     },
     "dependencies": {},
     "devDependencies": {}

src/apps/cli/runtime-package.json

@@ -4,7 +4,6 @@
     "version": "0.0.0",
     "description": "Runtime dependencies for Self-hosted LiveSync CLI Docker image",
     "dependencies": {
-        "chokidar": "^4.0.0",
         "commander": "^14.0.3",
         "werift": "^0.22.9",
         "pouchdb-adapter-http": "^9.0.0",

src/apps/cli/scripts/check-submodule.mjs

@@ -1,36 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-
-const cliDir = process.cwd();
-const repoRoot = path.resolve(cliDir, "../../..");
-const requiredFiles = [
-    path.join(repoRoot, "src/lib/src/common/types.ts"),
-];
-
-const missingFiles = requiredFiles.filter((filePath) => !fs.existsSync(filePath));
-
-if (missingFiles.length === 0) {
-    process.exit(0);
-}
-
-console.error("[CLI Build Error] Required shared sources were not found.");
-console.error("This repository uses Git submodules, and the CLI depends on src/lib.");
-console.error("");
-console.error("Missing file(s):");
-for (const filePath of missingFiles) {
-    console.error(`  - ${path.relative(repoRoot, filePath)}`);
-}
-console.error("");
-console.error("Initialize submodules, then retry the CLI build:");
-console.error("  git submodule update --init --recursive");
-console.error("");
-console.error("For a fresh clone, prefer:");
-console.error("  git clone --recurse-submodules <repository-url>");
-console.error("");
-console.error("Then run:");
-console.error("  npm install");
-console.error("  cd src/apps/cli");
-console.error("  npm run build");
-
-process.exit(1);

src/apps/cli/serviceModules/CLIServiceModules.ts

@@ -9,7 +9,6 @@ import { ServiceFileAccessCLI } from "./ServiceFileAccessImpl";
 import { ServiceDatabaseFileAccessCLI } from "./DatabaseFileAccess";
 import { StorageEventManagerCLI } from "../managers/StorageEventManagerCLI";
 import type { ServiceModules } from "@lib/interfaces/ServiceModule";
-import type { IgnoreRules } from "./IgnoreRules";
 
 /**
  * Initialize service modules for CLI version
@@ -23,9 +22,7 @@ import type { IgnoreRules } from "./IgnoreRules";
 export function initialiseServiceModulesCLI(
     basePath: string,
     core: LiveSyncBaseCore<ServiceContext, any>,
-    services: InjectableServiceHub<ServiceContext>,
-    ignoreRules?: IgnoreRules,
-    watchEnabled: boolean = false
+    services: InjectableServiceHub<ServiceContext>
 ): ServiceModules {
     const storageAccessManager = new StorageAccessManager();
 
@@ -39,24 +36,12 @@ export function initialiseServiceModulesCLI(
     });
 
     // CLI-specific storage event manager
-    const storageEventManager = new StorageEventManagerCLI(
-        basePath,
-        core,
-        {
-            fileProcessing: services.fileProcessing,
-            setting: services.setting,
-            vaultService: services.vault,
-            storageAccessManager: storageAccessManager,
-            APIService: services.API,
-        },
-        ignoreRules,
-        watchEnabled
-    );
-
-    // Close the file watcher during graceful shutdown so the process can exit cleanly.
-    services.appLifecycle.onUnload.addHandler(async () => {
-        await storageEventManager.close();
-        return true;
+    const storageEventManager = new StorageEventManagerCLI(basePath, core, {
+        fileProcessing: services.fileProcessing,
+        setting: services.setting,
+        vaultService: services.vault,
+        storageAccessManager: storageAccessManager,
+        APIService: services.API,
     });
 
     // Storage access using CLI file system adapter

src/apps/cli/serviceModules/IgnoreRules.ts

@@ -1,131 +0,0 @@
-import * as fs from "fs/promises";
-import * as path from "path";
-
-import { minimatch } from "minimatch";
-
-/**
- * Loads and evaluates ignore rules from `.livesync/ignore` inside the vault.
- *
- * File format:
- *   - Lines starting with `#` are comments.
- *   - Blank lines are ignored.
- *   - `import: .gitignore` (exactly) — merges patterns from the vault's `.gitignore`.
- *   - All other lines are minimatch glob patterns relative to the vault root.
- *
- * Negation patterns (lines starting with `!`) are not supported. Loading a
- * ruleset containing them throws an error — use separate include/exclude files
- * instead.
- *
- * Missing files (`.livesync/ignore` or `.gitignore`) are silently skipped.
- */
-export class IgnoreRules {
-    private patterns: string[] = [];
-
-    constructor(private vaultPath: string) {}
-
-    /**
-     * Reads `.livesync/ignore` (and optionally `.gitignore`) and populates the
-     * pattern list.  Safe to call multiple times — each call replaces the
-     * previous state.  Does not throw if files are absent.
-     *
-     * @throws if any pattern line begins with `!` (negation is unsupported).
-     */
-    async load(): Promise<void> {
-        this.patterns = [];
-        const ignorePath = path.join(this.vaultPath, ".livesync", "ignore");
-        let rawLines: string[];
-        try {
-            const content = await fs.readFile(ignorePath, "utf-8");
-            rawLines = content.split(/\r?\n/);
-        } catch {
-            // File absent or unreadable — treat as empty ruleset.
-            return;
-        }
-
-        for (const line of rawLines) {
-            const trimmed = line.trim();
-            if (!trimmed || trimmed.startsWith("#")) {
-                continue;
-            }
-            // NOTE: Only the exact string "import: .gitignore" is recognised.
-            // Any future generalisation of this directive must validate that
-            // the resolved path stays within the vault directory.
-            if (trimmed === "import: .gitignore") {
-                await this._importGitignore();
-                continue;
-            }
-            if (trimmed.startsWith("import:")) {
-                console.error(
-                    `[IgnoreRules] Warning: unrecognised directive '${trimmed}' — only 'import: .gitignore' is supported`
-                );
-                continue;
-            }
-            this._addPattern(trimmed);
-        }
-        if (this.patterns.length > 0) {
-            console.error(`[IgnoreRules] Loaded ${this.patterns.length} ignore patterns`);
-        }
-    }
-
-    // Normalises a single gitignore-style pattern:
-    //   - Patterns ending with `/` (directory patterns like `build/`) are
-    //     converted to `build/**` so they match all files inside that directory.
-    //   - Patterns without a `/` are prefixed with `**/` to give them matchBase
-    //     semantics (e.g. `*.tmp` → `**/*.tmp`), matching the basename in any
-    //     subdirectory as gitignore does.
-    //   - Patterns that already contain a `/` (but don't end with one) are
-    //     path-specific and used as-is.
-    private _normalisePattern(pattern: string): string {
-        if (pattern.endsWith("/")) {
-            return "**/" + pattern + "**";
-        } else if (!pattern.includes("/")) {
-            return "**/" + pattern;
-        }
-        return pattern;
-    }
-
-    private async _importGitignore(): Promise<void> {
-        const gitignorePath = path.join(this.vaultPath, ".gitignore");
-        let content: string;
-        try {
-            content = await fs.readFile(gitignorePath, "utf-8");
-        } catch {
-            return;
-        }
-        this._parseLines(content);
-    }
-
-    private _parseLines(content: string): void {
-        for (const line of content.split(/\r?\n/)) {
-            const trimmed = line.trim();
-            if (!trimmed || trimmed.startsWith("#")) continue;
-            this._addPattern(trimmed);
-        }
-    }
-
-    private _addPattern(raw: string): void {
-        if (raw.startsWith("!")) {
-            throw new Error(
-                `[IgnoreRules] Negation pattern '${raw}' is not supported. ` +
-                    `Remove it from .livesync/ignore or use a separate include/exclude file.`
-            );
-        }
-        this.patterns.push(this._normalisePattern(raw));
-    }
-
-    /**
-     * Returns `true` if the given vault-relative path matches any loaded
-     * ignore pattern.
-     *
-     * @param relativePath - Path relative to the vault root, using forward
-     *   slashes or the OS separator.
-     */
-    shouldIgnore(relativePath: string): boolean {
-        if (this.patterns.length === 0) {
-            return false;
-        }
-        // Normalise to forward slashes for minimatch.
-        const normalised = relativePath.replace(/\\/g, "/");
-        return this.patterns.some((p) => minimatch(normalised, p, { dot: true }));
-    }
-}

src/apps/cli/serviceModules/IgnoreRules.unit.spec.ts

@@ -1,169 +0,0 @@
-import * as fs from "node:fs/promises";
-import * as os from "node:os";
-import * as path from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { IgnoreRules } from "./IgnoreRules";
-
-describe("IgnoreRules", () => {
-    const tempDirs: string[] = [];
-
-    async function createVault(): Promise<string> {
-        const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "livesync-ignorerules-"));
-        tempDirs.push(tempDir);
-        return tempDir;
-    }
-
-    async function writeIgnoreFile(vaultPath: string, content: string): Promise<void> {
-        const ignoreDir = path.join(vaultPath, ".livesync");
-        await fs.mkdir(ignoreDir, { recursive: true });
-        await fs.writeFile(path.join(ignoreDir, "ignore"), content, "utf-8");
-    }
-
-    afterEach(async () => {
-        await Promise.all(tempDirs.splice(0).map((dir) => fs.rm(dir, { recursive: true, force: true })));
-    });
-
-    describe("pattern normalisation", () => {
-        it("adds **/ prefix to basename patterns (no slash)", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "*.tmp\n");
-            const rules = new IgnoreRules(vaultPath);
-            await rules.load();
-            expect(rules.shouldIgnore("notes/scratch.tmp")).toBe(true);
-            expect(rules.shouldIgnore("scratch.tmp")).toBe(true);
-            expect(rules.shouldIgnore("deep/nested/file.tmp")).toBe(true);
-        });
-
-        it("appends ** to directory patterns ending with / and prepends **/", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "build/\n");
-            const rules = new IgnoreRules(vaultPath);
-            await rules.load();
-            expect(rules.shouldIgnore("build/output.js")).toBe(true);
-            expect(rules.shouldIgnore("build/nested/file.js")).toBe(true);
-            expect(rules.shouldIgnore("subproject/build/output.js")).toBe(true);
-        });
-
-        it("leaves patterns containing / as-is", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "docs/private.md\n");
-            const rules = new IgnoreRules(vaultPath);
-            await rules.load();
-            expect(rules.shouldIgnore("docs/private.md")).toBe(true);
-            expect(rules.shouldIgnore("other/docs/private.md")).toBe(false);
-        });
-    });
-
-    describe("shouldIgnore", () => {
-        it("matches **/*.tmp against notes/scratch.tmp", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "*.tmp\n");
-            const rules = new IgnoreRules(vaultPath);
-            await rules.load();
-            expect(rules.shouldIgnore("notes/scratch.tmp")).toBe(true);
-        });
-
-        it("does not match notes/readme.md against **/*.tmp", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "*.tmp\n");
-            const rules = new IgnoreRules(vaultPath);
-            await rules.load();
-            expect(rules.shouldIgnore("notes/readme.md")).toBe(false);
-        });
-
-        it("returns false when no patterns are loaded", async () => {
-            const vaultPath = await createVault();
-            const rules = new IgnoreRules(vaultPath);
-            // No load() call — patterns are empty
-            expect(rules.shouldIgnore("anything.md")).toBe(false);
-        });
-    });
-
-    describe("negation patterns", () => {
-        it("throws when a negation pattern is encountered", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "*.tmp\n!important.tmp\n");
-            const rules = new IgnoreRules(vaultPath);
-            await expect(rules.load()).rejects.toThrow(/Negation pattern/);
-        });
-
-        it("throws when a .gitignore imported via directive contains negation", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "import: .gitignore\n");
-            await fs.writeFile(path.join(vaultPath, ".gitignore"), "*.log\n!keep.log\n", "utf-8");
-            const rules = new IgnoreRules(vaultPath);
-            await expect(rules.load()).rejects.toThrow(/Negation pattern/);
-        });
-    });
-
-    describe("unrecognised import: directives", () => {
-        it("warns and skips unrecognised import: forms (does not add as literal pattern)", async () => {
-            const vaultPath = await createVault();
-            // Typo: "import:.gitignore" instead of "import: .gitignore"
-            await writeIgnoreFile(vaultPath, "*.tmp\nimport:.gitignore\n");
-            const rules = new IgnoreRules(vaultPath);
-            await rules.load();
-            // *.tmp still loaded; import:.gitignore is skipped (not treated as a literal pattern)
-            expect(rules.shouldIgnore("scratch.tmp")).toBe(true);
-            expect(rules.shouldIgnore("import:.gitignore")).toBe(false);
-        });
-    });
-
-    describe("load() with missing file", () => {
-        it("returns without error when .livesync/ignore is absent", async () => {
-            const vaultPath = await createVault();
-            // No ignore file created
-            const rules = new IgnoreRules(vaultPath);
-            await expect(rules.load()).resolves.toBeUndefined();
-            expect(rules.shouldIgnore("anything.md")).toBe(false);
-        });
-    });
-
-    describe("load() with comments and blank lines", () => {
-        it("skips # comment lines and blank lines", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "# This is a comment\n\n  \n*.tmp\n# another comment\nbuild/\n");
-            const rules = new IgnoreRules(vaultPath);
-            await rules.load();
-            expect(rules.shouldIgnore("scratch.tmp")).toBe(true);
-            expect(rules.shouldIgnore("build/output.js")).toBe(true);
-            expect(rules.shouldIgnore("readme.md")).toBe(false);
-        });
-    });
-
-    describe("import: .gitignore directive", () => {
-        it("reads and normalises patterns from .gitignore", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "import: .gitignore\n");
-            await fs.writeFile(path.join(vaultPath, ".gitignore"), "*.log\nnode_modules/\n", "utf-8");
-            const rules = new IgnoreRules(vaultPath);
-            await rules.load();
-            expect(rules.shouldIgnore("app.log")).toBe(true);
-            expect(rules.shouldIgnore("node_modules/package.json")).toBe(true);
-            expect(rules.shouldIgnore("src/node_modules/package.json")).toBe(true);
-            expect(rules.shouldIgnore("src/index.ts")).toBe(false);
-        });
-
-        it("merges .gitignore patterns with other patterns", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "*.tmp\nimport: .gitignore\n");
-            await fs.writeFile(path.join(vaultPath, ".gitignore"), "*.log\n", "utf-8");
-            const rules = new IgnoreRules(vaultPath);
-            await rules.load();
-            expect(rules.shouldIgnore("scratch.tmp")).toBe(true);
-            expect(rules.shouldIgnore("error.log")).toBe(true);
-        });
-    });
-
-    describe("import: .gitignore with missing .gitignore", () => {
-        it("does not throw when .gitignore is absent", async () => {
-            const vaultPath = await createVault();
-            await writeIgnoreFile(vaultPath, "*.tmp\nimport: .gitignore\n");
-            // No .gitignore created
-            const rules = new IgnoreRules(vaultPath);
-            await expect(rules.load()).resolves.toBeUndefined();
-            // The *.tmp pattern from the ignore file still works
-            expect(rules.shouldIgnore("scratch.tmp")).toBe(true);
-        });
-    });
-});

src/apps/cli/test/test-daemon-linux.sh

@@ -1,166 +0,0 @@
-#!/usr/bin/env bash
-# Test: daemon-related ignore rules behaviour
-#
-# Tests that are runnable without a long-running daemon process are exercised
-# here using the `mirror` command, which calls the same `isTargetFile` handler
-# stack that the daemon uses.
-#
-# Covered cases:
-#   1. .livesync/ignore with *.tmp pattern  → ignored file is NOT synced to DB
-#   2. .livesync/ignore missing             → no error, normal sync continues
-#   3. import: .gitignore directive         → patterns from .gitignore are merged
-#
-set -euo pipefail
-
-SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
-CLI_DIR="$(cd -- "$SCRIPT_DIR/.." && pwd)"
-cd "$CLI_DIR"
-source "$SCRIPT_DIR/test-helpers.sh"
-display_test_info
-
-RUN_BUILD="${RUN_BUILD:-1}"
-cli_test_init_cli_cmd
-
-WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/livesync-cli-daemon-test.XXXXXX")"
-trap 'rm -rf "$WORK_DIR"' EXIT
-
-SETTINGS_FILE="$WORK_DIR/data.json"
-VAULT_DIR="$WORK_DIR/vault"
-mkdir -p "$VAULT_DIR/notes"
-
-if [[ "$RUN_BUILD" == "1" ]]; then
-    echo "[INFO] building CLI..."
-    npm run build
-fi
-
-echo "[INFO] generating settings -> $SETTINGS_FILE"
-cli_test_init_settings_file "$SETTINGS_FILE"
-cli_test_mark_settings_configured "$SETTINGS_FILE"
-
-PASS=0
-FAIL=0
-
-assert_pass() { echo "[PASS] $1"; PASS=$((PASS + 1)); }
-assert_fail() { echo "[FAIL] $1" >&2; FAIL=$((FAIL + 1)); }
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Case 1: .livesync/ignore with *.tmp → matched file should NOT appear in DB
-# ─────────────────────────────────────────────────────────────────────────────
-echo ""
-echo "=== Case 1: .livesync/ignore *.tmp → ignored file not synced to DB ==="
-
-mkdir -p "$VAULT_DIR/.livesync"
-printf '*.tmp\n' > "$VAULT_DIR/.livesync/ignore"
-
-# Also write a normal file so we can confirm mirror ran at all.
-printf 'normal content\n' > "$VAULT_DIR/notes/normal.md"
-# Write the file that should be ignored.
-printf 'tmp content\n' > "$VAULT_DIR/notes/scratch.tmp"
-
-run_cli "$VAULT_DIR" --settings "$SETTINGS_FILE" mirror
-
-# The normal file should be in the DB.
-RESULT_NORMAL="$WORK_DIR/case1-normal.txt"
-if run_cli "$VAULT_DIR" --settings "$SETTINGS_FILE" pull notes/normal.md "$RESULT_NORMAL" 2>/dev/null; then
-    if cmp -s "$VAULT_DIR/notes/normal.md" "$RESULT_NORMAL"; then
-        assert_pass "normal.md was synced to DB"
-    else
-        assert_fail "normal.md content mismatch after mirror"
-    fi
-else
-    assert_fail "normal.md was not found in DB after mirror"
-fi
-
-# The .tmp file should NOT be in the DB.
-DB_LIST="$WORK_DIR/case1-ls.txt"
-run_cli "$VAULT_DIR" --settings "$SETTINGS_FILE" ls > "$DB_LIST"
-if grep -q "scratch.tmp" "$DB_LIST"; then
-    assert_fail "scratch.tmp (ignored) was unexpectedly synced to DB"
-    echo "--- DB listing ---" >&2; cat "$DB_LIST" >&2
-else
-    assert_pass "scratch.tmp (*.tmp pattern) was NOT synced to DB"
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Case 2: .livesync/ignore absent → no error, normal sync continues
-# ─────────────────────────────────────────────────────────────────────────────
-echo ""
-echo "=== Case 2: .livesync/ignore absent → no error, sync continues ==="
-
-VAULT_DIR2="$WORK_DIR/vault2"
-mkdir -p "$VAULT_DIR2/notes"
-SETTINGS_FILE2="$WORK_DIR/data2.json"
-cli_test_init_settings_file "$SETTINGS_FILE2"
-cli_test_mark_settings_configured "$SETTINGS_FILE2"
-
-# No .livesync directory at all.
-printf 'hello\n' > "$VAULT_DIR2/notes/hello.md"
-
-# mirror should succeed without error.
-set +e
-MIRROR_OUTPUT="$WORK_DIR/case2-mirror.txt"
-run_cli "$VAULT_DIR2" --settings "$SETTINGS_FILE2" mirror >"$MIRROR_OUTPUT" 2>&1
-MIRROR_EXIT=$?
-set -e
-
-if [[ "$MIRROR_EXIT" -ne 0 ]]; then
-    assert_fail "mirror exited non-zero ($MIRROR_EXIT) when .livesync/ignore is absent"
-    cat "$MIRROR_OUTPUT" >&2
-else
-    assert_pass "mirror succeeded when .livesync/ignore is absent"
-fi
-
-# The normal file should have been synced.
-RESULT_HELLO="$WORK_DIR/case2-hello.txt"
-if run_cli "$VAULT_DIR2" --settings "$SETTINGS_FILE2" pull notes/hello.md "$RESULT_HELLO" 2>/dev/null; then
-    assert_pass "file synced normally when .livesync/ignore is absent"
-else
-    assert_fail "file was not synced when .livesync/ignore is absent"
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Case 3: import: .gitignore merges patterns
-# ─────────────────────────────────────────────────────────────────────────────
-echo ""
-echo "=== Case 3: import: .gitignore directive merges patterns ==="
-
-VAULT_DIR3="$WORK_DIR/vault3"
-mkdir -p "$VAULT_DIR3/notes"
-SETTINGS_FILE3="$WORK_DIR/data3.json"
-cli_test_init_settings_file "$SETTINGS_FILE3"
-cli_test_mark_settings_configured "$SETTINGS_FILE3"
-
-mkdir -p "$VAULT_DIR3/.livesync"
-printf 'import: .gitignore\n' > "$VAULT_DIR3/.livesync/ignore"
-printf '# gitignore comment\n*.log\nbuild/\n' > "$VAULT_DIR3/.gitignore"
-
-printf 'regular note\n' > "$VAULT_DIR3/notes/regular.md"
-printf 'log content\n' > "$VAULT_DIR3/notes/debug.log"
-
-run_cli "$VAULT_DIR3" --settings "$SETTINGS_FILE3" mirror
-
-DB_LIST3="$WORK_DIR/case3-ls.txt"
-run_cli "$VAULT_DIR3" --settings "$SETTINGS_FILE3" ls > "$DB_LIST3"
-
-if grep -q "debug.log" "$DB_LIST3"; then
-    assert_fail "debug.log (ignored via .gitignore import) was unexpectedly synced to DB"
-    echo "--- DB listing ---" >&2; cat "$DB_LIST3" >&2
-else
-    assert_pass "debug.log (*.log from imported .gitignore) was NOT synced to DB"
-fi
-
-# regular.md should still be present.
-if grep -q "regular.md" "$DB_LIST3"; then
-    assert_pass "regular.md was synced normally alongside .gitignore import rules"
-else
-    assert_fail "regular.md was NOT synced — .gitignore import may have been too broad"
-fi
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Summary
-# ─────────────────────────────────────────────────────────────────────────────
-echo ""
-echo "Results: PASS=$PASS FAIL=$FAIL"
-if [[ "$FAIL" -gt 0 ]]; then
-    exit 1
-fi

src/apps/cli/test/test-decoupled-vault-linux.sh

@@ -1,83 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
-CLI_DIR="$(cd -- "$SCRIPT_DIR/.." && pwd)"
-cd "$CLI_DIR"
-source "$SCRIPT_DIR/test-helpers.sh"
-display_test_info
-
-RUN_BUILD="${RUN_BUILD:-1}"
-REMOTE_PATH="${REMOTE_PATH:-test/push-pull-decoupled.txt}"
-cli_test_init_cli_cmd
-
-WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/livesync-cli-test.XXXXXX")"
-trap 'rm -rf "$WORK_DIR"' EXIT
-
-SETTINGS_FILE="${1:-$WORK_DIR/data.json}"
-
-if [[ "$RUN_BUILD" == "1" ]]; then
-    echo "[INFO] building CLI..."
-    npm run build
-fi
-
-echo "[INFO] generating settings from DEFAULT_SETTINGS -> $SETTINGS_FILE"
-cli_test_init_settings_file "$SETTINGS_FILE"
-
-if [[ -n "${COUCHDB_URI:-}" && -n "${COUCHDB_USER:-}" && -n "${COUCHDB_PASSWORD:-}" && -n "${COUCHDB_DBNAME:-}" ]]; then
-    echo "[INFO] applying CouchDB env vars to generated settings"
-    cli_test_apply_couchdb_settings "$SETTINGS_FILE" "$COUCHDB_URI" "$COUCHDB_USER" "$COUCHDB_PASSWORD" "$COUCHDB_DBNAME"
-else
-    echo "[WARN] CouchDB env vars are not fully set. push/pull may fail unless generated settings are updated."
-    cli_test_mark_settings_configured "$SETTINGS_FILE"
-fi
-
-VAULT_DIR="$WORK_DIR/vault"
-DB_DIR="$WORK_DIR/db"
-mkdir -p "$VAULT_DIR/test"
-mkdir -p "$DB_DIR"
-
-SRC_FILE="$WORK_DIR/push-source.txt"
-PULLED_FILE="$WORK_DIR/pull-result.txt"
-printf 'push-pull-decoupled-test %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$SRC_FILE"
-
-# 1. Test push command with decoupled vault directory
-echo "[INFO] push with decoupled vault -> $REMOTE_PATH"
-run_cli "$DB_DIR" --vault "$VAULT_DIR" --settings "$SETTINGS_FILE" push "$SRC_FILE" "$REMOTE_PATH"
-
-# 2. Test pull command with decoupled vault directory
-echo "[INFO] pull with decoupled vault <- $REMOTE_PATH"
-run_cli "$DB_DIR" --vault "$VAULT_DIR" --settings "$SETTINGS_FILE" pull "$REMOTE_PATH" "$PULLED_FILE"
-
-if cmp -s "$SRC_FILE" "$PULLED_FILE"; then
-    echo "[PASS] push/pull roundtrip with decoupled vault matched"
-else
-    echo "[FAIL] push/pull roundtrip with decoupled vault mismatch" >&2
-    echo "--- source ---" >&2
-    cat "$SRC_FILE" >&2
-    echo "--- pulled ---" >&2
-    cat "$PULLED_FILE" >&2
-    exit 1
-fi
-
-# 3. Clean up pulled file and vault test directory to verify mirror
-rm -f "$PULLED_FILE"
-rm -rf "$VAULT_DIR/test"
-
-# 4. Test mirror command with decoupled vault directory
-echo "[INFO] mirror with decoupled vault"
-run_cli "$DB_DIR" --vault "$VAULT_DIR" --settings "$SETTINGS_FILE" mirror
-
-RESTORED_FILE="$VAULT_DIR/$REMOTE_PATH"
-if cmp -s "$SRC_FILE" "$RESTORED_FILE"; then
-    echo "[PASS] mirror with decoupled vault matched"
-else
-    echo "[FAIL] mirror with decoupled vault mismatch" >&2
-    echo "--- source ---" >&2
-    cat "$SRC_FILE" >&2
-    echo "--- mirrored/restored ---" >&2
-    cat "$RESTORED_FILE" 2>/dev/null || echo "<none>" >&2
-    exit 1
-fi
-
-echo "[PASS] decoupled database/vault E2E tests successfully completed"

src/apps/cli/test/test-mirror-linux.sh

@@ -43,15 +43,6 @@ cli_test_init_settings_file "$SETTINGS_FILE"
 # isConfigured=true is required for mirror (canProceedScan checks this)
 cli_test_mark_settings_configured "$SETTINGS_FILE"
 
-# Enable writeDocumentsIfConflicted to resolve unsynced conflicts during mirror
-node -e '
-const fs = require("fs");
-const file = process.argv[1];
-const data = JSON.parse(fs.readFileSync(file, "utf-8"));
-data.writeDocumentsIfConflicted = true;
-fs.writeFileSync(file, JSON.stringify(data, null, 2));
-' "$SETTINGS_FILE"
-
 # Preparation: Sync settings and files logic
 DB_SETTINGS="$DB_DIR/settings.json"
 cp "$SETTINGS_FILE" "$DB_SETTINGS"

src/apps/cli/test/test-remote-commands-linux.sh

@@ -1,146 +0,0 @@
-#!/usr/bin/env bash
-# Test: CLI remote management commands: remote-status, unlock-remote, and mark-resolved.
-#
-# Scenario:
-#   1. Start CouchDB, create a test database, and perform an initial sync.
-#   2. Run remote-status and assert that the output contains the database name in JSON format.
-#   3. Lock the remote database milestone manually using curl, verify status, and run unlock-remote.
-#      Assert that the output of unlock-remote contains the unlocked verification status.
-#   4. Run mark-resolved and verify it succeeds.
-set -euo pipefail
-
-SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
-CLI_DIR="$(cd -- "$SCRIPT_DIR/.." && pwd)"
-cd "$CLI_DIR"
-source "$SCRIPT_DIR/test-helpers.sh"
-display_test_info
-
-RUN_BUILD="${RUN_BUILD:-1}"
-TEST_ENV_FILE="${TEST_ENV_FILE:-$CLI_DIR/.test.env}"
-cli_test_init_cli_cmd
-
-if [[ ! -f "$TEST_ENV_FILE" ]]; then
-    echo "[ERROR] test env file not found: $TEST_ENV_FILE" >&2
-    exit 1
-fi
-
-set -a
-source "$TEST_ENV_FILE"
-set +a
-
-DB_SUFFIX="$(date +%s)-$RANDOM"
-
-COUCHDB_URI="${hostname%/}"
-COUCHDB_DBNAME="${dbname}-remotes-${DB_SUFFIX}"
-COUCHDB_USER="${username:-}"
-COUCHDB_PASSWORD="${password:-}"
-
-if [[ -z "$COUCHDB_URI" || -z "$COUCHDB_USER" || -z "$COUCHDB_PASSWORD" ]]; then
-    echo "[ERROR] COUCHDB_URI, COUCHDB_USER, and COUCHDB_PASSWORD are required" >&2
-    exit 1
-fi
-
-WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/livesync-cli-remote-cmds.XXXXXX")"
-VAULT_DIR="$WORK_DIR/vault"
-SETTINGS_FILE="$WORK_DIR/settings.json"
-mkdir -p "$VAULT_DIR"
-
-cleanup() {
-    local exit_code=$?
-    cli_test_stop_couchdb
-    rm -rf "$WORK_DIR"
-    exit "$exit_code"
-}
-trap cleanup EXIT
-
-if [[ "$RUN_BUILD" == "1" ]]; then
-    echo "[INFO] building CLI"
-    npm run build
-fi
-
-echo "[INFO] starting CouchDB and creating test database: $COUCHDB_DBNAME"
-cli_test_start_couchdb "$COUCHDB_URI" "$COUCHDB_USER" "$COUCHDB_PASSWORD" "$COUCHDB_DBNAME"
-
-echo "[INFO] preparing settings"
-cli_test_init_settings_file "$SETTINGS_FILE"
-echo ".."
-cli_test_apply_couchdb_settings "$SETTINGS_FILE" "$COUCHDB_URI" "$COUCHDB_USER" "$COUCHDB_PASSWORD" "$COUCHDB_DBNAME" 1
-echo "..."
-
-echo "[INFO] initial sync to create milestone document"
-run_cli "$VAULT_DIR" --settings "$SETTINGS_FILE" sync >/dev/null
-
-MILESTONE_ID="_local/obsydian_livesync_milestone"
-MILESTONE_URL="${COUCHDB_URI}/${COUCHDB_DBNAME}/${MILESTONE_ID}"
-
-update_milestone() {
-    local locked="$1"
-    local accepted_nodes="$2"
-    local current
-    current="$(cli_test_curl_json --user "${COUCHDB_USER}:${COUCHDB_PASSWORD}" "$MILESTONE_URL")"
-    local updated
-    updated="$(node -e '
-const doc = JSON.parse(process.argv[1]);
-doc.locked = process.argv[2] === "true";
-doc.accepted_nodes = JSON.parse(process.argv[3]);
-process.stdout.write(JSON.stringify(doc));
-' "$current" "$locked" "$accepted_nodes")"
-    cli_test_curl_json -X PUT \
-        --user "${COUCHDB_USER}:${COUCHDB_PASSWORD}" \
-        -H "Content-Type: application/json" \
-        -d "$updated" \
-        "$MILESTONE_URL" >/dev/null
-}
-
-CMD_LOG="$WORK_DIR/cmd.log"
-
-echo "[CASE] remote-status outputs valid JSON with CouchDB details"
-run_cli "$VAULT_DIR" --settings "$SETTINGS_FILE" remote-status >"$CMD_LOG" 2>&1
-
-cli_test_assert_contains "$(cat "$CMD_LOG")" \
-    "\"db_name\": \"$COUCHDB_DBNAME\"" \
-    "remote-status should return JSON containing db_name"
-
-echo "[PASS] remote-status verified"
-
-echo "[CASE] lock-remote locks and verifies state"
-# Run lock-remote and verify output contains verification message
-run_cli "$VAULT_DIR" --settings "$SETTINGS_FILE" lock-remote >"$CMD_LOG" 2>&1
-
-cli_test_assert_contains "$(cat "$CMD_LOG")" \
-    "[Verification] Remote Database: LOCKED" \
-    "lock-remote output should show that the remote database is locked"
-
-echo "[PASS] lock-remote verified"
-
-echo "[CASE] unlock-remote unlocks and verifies state"
-# Manually lock milestone
-update_milestone "true" "[]"
-
-# Run unlock-remote and verify output contains verification message
-run_cli "$VAULT_DIR" --settings "$SETTINGS_FILE" unlock-remote >"$CMD_LOG" 2>&1
-
-cli_test_assert_contains "$(cat "$CMD_LOG")" \
-    "[Verification] Remote Database: UNLOCKED" \
-    "unlock-remote output should contain verification status"
-
-echo "[PASS] unlock-remote verified"
-
-echo "[CASE] mark-resolved resolves and verifies state"
-# Manually lock milestone
-update_milestone "true" "[]"
-
-# Run mark-resolved and verify output contains verification message
-run_cli "$VAULT_DIR" --settings "$SETTINGS_FILE" mark-resolved >"$CMD_LOG" 2>&1
-
-cli_test_assert_contains "$(cat "$CMD_LOG")" \
-    "[Verification] Remote Database: LOCKED" \
-    "mark-resolved output should show that the remote database remains locked"
-
-cli_test_assert_contains "$(cat "$CMD_LOG")" \
-    "ACCEPTED" \
-    "mark-resolved output should show that the current device node is accepted"
-
-echo "[PASS] mark-resolved verified"
-
-echo "[ALL PASS] All remote CLI commands verified successfully"

src/apps/cli/testdeno/.test.env

@@ -1,9 +0,0 @@
-hostname=http://127.0.0.1:5989/
-dbname=livesync-test-db-ci
-username=admin
-password=testpassword
-minioEndpoint=http://127.0.0.1:9000
-accessKey=minioadmin
-secretKey=minioadmin
-bucketName=livesync-test-bucket-ci
-LIVESYNC_TEST_TEE=1

src/apps/cli/testdeno/bench-couchdb.ts

@@ -1,312 +0,0 @@
-import { TempDir } from "./helpers/temp.ts";
-import { applyRemoteSyncSettings, initSettingsFile } from "./helpers/settings.ts";
-import { assertFilesEqual, runCliOrFail } from "./helpers/cli.ts";
-import { startCouchdb, stopCouchdb } from "./helpers/docker.ts";
-import { createDeterministicDataset, type DatasetEntry } from "./helpers/dataset.ts";
-
-type BenchmarkConfig = {
-    couchdbBackendUri: string;
-    couchdbProxyUri: string;
-    couchdbUser: string;
-    couchdbPassword: string;
-    couchdbDbname: string;
-    datasetDirName: string;
-    datasetSeed: string;
-    mdFileCount: number;
-    mdMinSizeBytes: number;
-    mdMaxSizeBytes: number;
-    binFileCount: number;
-    binSizeBytes: number;
-    syncTimeoutSeconds: number;
-    requestedRttMs: number;
-    passphrase: string;
-    encrypt: boolean;
-};
-
-function readEnvString(name: string, fallback: string): string {
-    const value = Deno.env.get(name)?.trim();
-    return value && value.length > 0 ? value : fallback;
-}
-
-function readEnvNumber(name: string, fallback: number): number {
-    const raw = Deno.env.get(name);
-    if (raw === undefined || raw.trim() === "") {
-        return fallback;
-    }
-
-    const parsed = Number(raw);
-    if (!Number.isFinite(parsed) || parsed <= 0) {
-        throw new Error(`${name} must be a positive number, got '${raw}'`);
-    }
-    return parsed;
-}
-
-function readEnvBool(name: string, fallback: boolean): boolean {
-    const raw = Deno.env.get(name);
-    if (raw === undefined || raw.trim() === "") {
-        return fallback;
-    }
-    return /^(1|true|yes|on)$/i.test(raw.trim());
-}
-
-function nowMs(): number {
-    return performance.now();
-}
-
-function formatMs(value: number): string {
-    return `${value.toFixed(1)} ms`;
-}
-
-function formatBytes(value: number): string {
-    if (value < 1024) {
-        return `${value} B`;
-    }
-    const kib = value / 1024;
-    if (kib < 1024) {
-        return `${kib.toFixed(1)} KiB`;
-    }
-    return `${(kib / 1024).toFixed(1)} MiB`;
-}
-
-function buildConfig(): BenchmarkConfig {
-    return {
-        couchdbBackendUri: readEnvString("BENCH_COUCHDB_BACKEND_URI", "http://127.0.0.1:5989"),
-        couchdbProxyUri: readEnvString("BENCH_COUCHDB_URI", "http://127.0.0.1:15989"),
-        couchdbUser: readEnvString("BENCH_COUCHDB_USER", readEnvString("username", "admin")),
-        couchdbPassword: readEnvString("BENCH_COUCHDB_PASSWORD", readEnvString("password", "password")),
-        couchdbDbname: readEnvString("BENCH_COUCHDB_DBNAME", `bench-couchdb-${Date.now()}`),
-        datasetDirName: readEnvString("BENCH_DATASET_DIR", "bench-dataset"),
-        datasetSeed: readEnvString("BENCH_SEED", "livesync-benchmark-seed"),
-        mdFileCount: Math.floor(readEnvNumber("BENCH_MD_FILE_COUNT", 1500)),
-        mdMinSizeBytes: Math.floor(readEnvNumber("BENCH_MD_MIN_SIZE_BYTES", 1024)),
-        mdMaxSizeBytes: Math.floor(readEnvNumber("BENCH_MD_MAX_SIZE_BYTES", 20 * 1024)),
-        binFileCount: Math.floor(readEnvNumber("BENCH_BIN_FILE_COUNT", 500)),
-        binSizeBytes: Math.floor(readEnvNumber("BENCH_BIN_SIZE_BYTES", 100 * 1024)),
-        syncTimeoutSeconds: readEnvNumber("BENCH_SYNC_TIMEOUT", 240),
-        requestedRttMs: Math.floor(readEnvNumber("BENCH_COUCHDB_RTT_MS", 50)),
-        passphrase: readEnvString("BENCH_PASSPHRASE", `bench-${Date.now()}`),
-        encrypt: readEnvBool("BENCH_ENCRYPT", true),
-    };
-}
-
-function readOptionalResultPath(): string | undefined {
-    const raw = Deno.env.get("BENCH_RESULT_JSON")?.trim();
-    if (!raw) {
-        return undefined;
-    }
-    return raw;
-}
-
-function pickSampleFiles(entries: DatasetEntry[]): DatasetEntry[] {
-    if (entries.length === 0) {
-        return [];
-    }
-    const md = entries.find((e) => e.kind === "md");
-    const bin = entries.find((e) => e.kind === "bin");
-    const middle = entries[Math.floor(entries.length / 2)];
-    const last = entries[entries.length - 1];
-    const unique = new Map<string, DatasetEntry>();
-    for (const entry of [md, bin, middle, last]) {
-        if (entry) {
-            unique.set(entry.relativePath, entry);
-        }
-    }
-    return [...unique.values()];
-}
-
-type ProxyHandle = {
-    stop: () => Promise<void>;
-    applied: boolean;
-    note: string;
-};
-
-function startCouchdbProxy(options: { backendUri: string; proxyUri: string; requestedRttMs: number }): ProxyHandle {
-    const backend = new URL(options.backendUri);
-    const proxy = new URL(options.proxyUri);
-    const halfDelayMs = Math.max(1, Math.floor(options.requestedRttMs / 2));
-    const controller = new AbortController();
-
-    const listener = Deno.serve(
-        {
-            hostname: proxy.hostname,
-            port: Number(proxy.port),
-            signal: controller.signal,
-            onError(error) {
-                console.error(`[Proxy] ${String(error)}`);
-                return new Response("proxy error", { status: 502 });
-            },
-        },
-        async (request) => {
-            await new Promise((resolve) => setTimeout(resolve, halfDelayMs));
-
-            const targetUrl = new URL(request.url);
-            targetUrl.protocol = backend.protocol;
-            targetUrl.host = backend.host;
-
-            const headers = new Headers(request.headers);
-            headers.delete("host");
-            headers.delete("content-length");
-
-            let requestBody: ArrayBuffer | undefined;
-            if (request.method !== "GET" && request.method !== "HEAD") {
-                try {
-                    requestBody = await request.arrayBuffer();
-                } catch {
-                    requestBody = undefined;
-                }
-            }
-
-            const upstream = await fetch(targetUrl, {
-                method: request.method,
-                headers,
-                body: requestBody,
-                redirect: "manual",
-            });
-
-            const responseHeaders = new Headers(upstream.headers);
-            responseHeaders.delete("content-length");
-            const responseBody = await upstream.arrayBuffer();
-
-            return new Response(responseBody, {
-                status: upstream.status,
-                statusText: upstream.statusText,
-                headers: responseHeaders,
-            });
-        }
-    );
-
-    return {
-        applied: true,
-        note: `local reverse proxy on ${proxy.origin} with ${halfDelayMs}ms pre-forward delay`,
-        stop: async () => {
-            controller.abort();
-            await listener.finished.catch(() => {});
-        },
-    };
-}
-
-async function main(): Promise<void> {
-    const config = buildConfig();
-    const resultPath = readOptionalResultPath();
-
-    await using workDir = await TempDir.create("livesync-cli-couchdb-bench");
-    const vaultA = workDir.join("vault-a");
-    const vaultB = workDir.join("vault-b");
-    const settingsA = workDir.join("settings-a.json");
-    const settingsB = workDir.join("settings-b.json");
-    await Deno.mkdir(vaultA, { recursive: true });
-    await Deno.mkdir(vaultB, { recursive: true });
-
-    await initSettingsFile(settingsA);
-    await initSettingsFile(settingsB);
-
-    await startCouchdb(config.couchdbBackendUri, config.couchdbUser, config.couchdbPassword, config.couchdbDbname);
-
-    const proxy = startCouchdbProxy({
-        backendUri: config.couchdbBackendUri,
-        proxyUri: config.couchdbProxyUri,
-        requestedRttMs: config.requestedRttMs,
-    });
-
-    try {
-        await Promise.all([
-            applyRemoteSyncSettings(settingsA, {
-                remoteType: "COUCHDB",
-                couchdbUri: config.couchdbProxyUri,
-                couchdbUser: config.couchdbUser,
-                couchdbPassword: config.couchdbPassword,
-                couchdbDbname: config.couchdbDbname,
-                encrypt: config.encrypt,
-                passphrase: config.passphrase,
-            }),
-            applyRemoteSyncSettings(settingsB, {
-                remoteType: "COUCHDB",
-                couchdbUri: config.couchdbProxyUri,
-                couchdbUser: config.couchdbUser,
-                couchdbPassword: config.couchdbPassword,
-                couchdbDbname: config.couchdbDbname,
-                encrypt: config.encrypt,
-                passphrase: config.passphrase,
-            }),
-        ]);
-
-        const seedFiles = await createDeterministicDataset({
-            rootDir: vaultA,
-            datasetDirName: config.datasetDirName,
-            seed: config.datasetSeed,
-            mdCount: config.mdFileCount,
-            mdMinSizeBytes: config.mdMinSizeBytes,
-            mdMaxSizeBytes: config.mdMaxSizeBytes,
-            binCount: config.binFileCount,
-            binSizeBytes: config.binSizeBytes,
-        });
-
-        const mirrorStart = nowMs();
-        await runCliOrFail(vaultA, "--settings", settingsA, "mirror");
-        const mirrorElapsed = nowMs() - mirrorStart;
-
-        const syncAStart = nowMs();
-        await runCliOrFail(vaultA, "--settings", settingsA, "sync");
-        const syncAElapsed = nowMs() - syncAStart;
-
-        const syncBStart = nowMs();
-        await runCliOrFail(vaultB, "--settings", settingsB, "sync");
-        const syncBElapsed = nowMs() - syncBStart;
-
-        const sampleFiles = pickSampleFiles(seedFiles.entries);
-        for (const sample of sampleFiles) {
-            const pulledPath = workDir.join(`pulled-${sample.relativePath.split("/").join("_")}`);
-            await runCliOrFail(vaultB, "--settings", settingsB, "pull", sample.relativePath, pulledPath);
-            await assertFilesEqual(
-                sample.absolutePath,
-                pulledPath,
-                `sample file mismatch after CouchDB sync: ${sample.relativePath}`
-            );
-        }
-
-        const result = {
-            mode: "couchdb-cli-benchmark",
-            couchdbBackendUri: config.couchdbBackendUri,
-            couchdbProxyUri: config.couchdbProxyUri,
-            couchdbDbname: config.couchdbDbname,
-            rttRequestedMs: config.requestedRttMs,
-            proxyApplied: proxy.applied,
-            proxyNote: proxy.note,
-            datasetSeed: config.datasetSeed,
-            datasetDirName: config.datasetDirName,
-            totalFiles: seedFiles.totalFiles,
-            totalBytes: seedFiles.totalBytes,
-            mdFileCount: seedFiles.mdCount,
-            binFileCount: seedFiles.binCount,
-            mirrorElapsedMs: Number(mirrorElapsed.toFixed(1)),
-            syncAElapsedMs: Number(syncAElapsed.toFixed(1)),
-            syncBElapsedMs: Number(syncBElapsed.toFixed(1)),
-            totalSyncElapsedMs: Number((syncAElapsed + syncBElapsed).toFixed(1)),
-            throughputBytesPerSec: Number((seedFiles.totalBytes / ((syncAElapsed + syncBElapsed) / 1000)).toFixed(2)),
-            throughputMiBPerSec: Number(
-                (seedFiles.totalBytes / ((syncAElapsed + syncBElapsed) / 1000) / 1024 / 1024).toFixed(4)
-            ),
-        };
-
-        if (resultPath) {
-            await Deno.writeTextFile(resultPath, JSON.stringify(result, null, 2));
-        }
-
-        console.log(JSON.stringify(result, null, 2));
-        console.error(
-            `[Benchmark] couchdb mirrored ${seedFiles.totalFiles} files (${formatBytes(seedFiles.totalBytes)}) in ${formatMs(
-                mirrorElapsed
-            )}, synced in ${formatMs(syncAElapsed + syncBElapsed)} (${result.throughputBytesPerSec} B/s, ${result.throughputMiBPerSec} MiB/s)`
-        );
-    } finally {
-        await proxy.stop();
-        await stopCouchdb().catch(() => {});
-    }
-}
-
-if (import.meta.main) {
-    main().catch((error) => {
-        console.error(`[Fatal Error]`, error);
-        Deno.exit(1);
-    });
-}

src/apps/cli/testdeno/bench-p2p.ts

@@ -1,223 +0,0 @@
-import { TempDir } from "./helpers/temp.ts";
-import { applyP2pSettings, applyP2pTestTweaks, initSettingsFile } from "./helpers/settings.ts";
-import { startCliInBackground } from "./helpers/backgroundCli.ts";
-import { discoverPeer, maybeStartLocalRelay, stopLocalRelayIfStarted } from "./helpers/p2p.ts";
-import { assertFilesEqual, runCliOrFail } from "./helpers/cli.ts";
-import { createDeterministicDataset, type DatasetEntry } from "./helpers/dataset.ts";
-
-type BenchmarkConfig = {
-    relay: string;
-    appId: string;
-    roomId: string;
-    passphrase: string;
-    datasetDirName: string;
-    datasetSeed: string;
-    mdFileCount: number;
-    mdMinSizeBytes: number;
-    mdMaxSizeBytes: number;
-    binFileCount: number;
-    binSizeBytes: number;
-    peersTimeoutSeconds: number;
-    syncTimeoutSeconds: number;
-};
-
-function readEnvString(name: string, fallback: string): string {
-    const value = Deno.env.get(name)?.trim();
-    return value && value.length > 0 ? value : fallback;
-}
-
-function readEnvNumber(name: string, fallback: number): number {
-    const raw = Deno.env.get(name);
-    if (raw === undefined || raw.trim() === "") {
-        return fallback;
-    }
-
-    const parsed = Number(raw);
-    if (!Number.isFinite(parsed) || parsed <= 0) {
-        throw new Error(`${name} must be a positive number, got '${raw}'`);
-    }
-    return parsed;
-}
-
-function nowMs(): number {
-    return performance.now();
-}
-
-function formatMs(value: number): string {
-    return `${value.toFixed(1)} ms`;
-}
-
-function formatBytes(value: number): string {
-    if (value < 1024) {
-        return `${value} B`;
-    }
-    const kib = value / 1024;
-    if (kib < 1024) {
-        return `${kib.toFixed(1)} KiB`;
-    }
-    const mib = kib / 1024;
-    return `${mib.toFixed(1)} MiB`;
-}
-
-function buildConfig(): BenchmarkConfig {
-    return {
-        relay: readEnvString("BENCH_RELAY", "ws://localhost:4000/"),
-        appId: readEnvString("BENCH_APP_ID", "self-hosted-livesync-cli-benchmark"),
-        roomId: readEnvString("BENCH_ROOM_ID", `bench-room-${Date.now()}`),
-        passphrase: readEnvString("BENCH_PASSPHRASE", `bench-${Date.now()}`),
-        datasetDirName: readEnvString("BENCH_DATASET_DIR", "bench-dataset"),
-        datasetSeed: readEnvString("BENCH_SEED", "livesync-benchmark-seed"),
-        mdFileCount: Math.floor(readEnvNumber("BENCH_MD_FILE_COUNT", 1500)),
-        mdMinSizeBytes: Math.floor(readEnvNumber("BENCH_MD_MIN_SIZE_BYTES", 1024)),
-        mdMaxSizeBytes: Math.floor(readEnvNumber("BENCH_MD_MAX_SIZE_BYTES", 20 * 1024)),
-        binFileCount: Math.floor(readEnvNumber("BENCH_BIN_FILE_COUNT", 500)),
-        binSizeBytes: Math.floor(readEnvNumber("BENCH_BIN_SIZE_BYTES", 100 * 1024)),
-        peersTimeoutSeconds: readEnvNumber("BENCH_PEERS_TIMEOUT", 20),
-        syncTimeoutSeconds: readEnvNumber("BENCH_SYNC_TIMEOUT", 240),
-    };
-}
-
-function readOptionalResultPath(): string | undefined {
-    const raw = Deno.env.get("BENCH_RESULT_JSON")?.trim();
-    if (!raw) {
-        return undefined;
-    }
-    return raw;
-}
-
-function pickSampleFiles(entries: DatasetEntry[]): DatasetEntry[] {
-    if (entries.length === 0) {
-        return [];
-    }
-    const md = entries.find((e) => e.kind === "md");
-    const bin = entries.find((e) => e.kind === "bin");
-    const middle = entries[Math.floor(entries.length / 2)];
-    const last = entries[entries.length - 1];
-    const unique = new Map<string, DatasetEntry>();
-    for (const entry of [md, bin, middle, last]) {
-        if (entry) {
-            unique.set(entry.relativePath, entry);
-        }
-    }
-    return [...unique.values()];
-}
-
-async function main(): Promise<void> {
-    const config = buildConfig();
-    const resultPath = readOptionalResultPath();
-
-    const relayStarted = await maybeStartLocalRelay(config.relay);
-    await using workDir = await TempDir.create("livesync-cli-p2p-bench");
-
-    const hostVault = workDir.join("vault-host");
-    const clientVault = workDir.join("vault-client");
-    const hostSettings = workDir.join("settings-host.json");
-    const clientSettings = workDir.join("settings-client.json");
-
-    await Promise.all([
-        Deno.mkdir(hostVault, { recursive: true }),
-        Deno.mkdir(clientVault, { recursive: true }),
-        initSettingsFile(hostSettings),
-        initSettingsFile(clientSettings),
-    ]);
-
-    await Promise.all([
-        applyP2pSettings(hostSettings, config.roomId, config.passphrase, config.appId, config.relay, "~.*"),
-        applyP2pSettings(clientSettings, config.roomId, config.passphrase, config.appId, config.relay, "~.*"),
-    ]);
-
-    await Promise.all([
-        applyP2pTestTweaks(hostSettings, "p2p-bench-host", config.passphrase),
-        applyP2pTestTweaks(clientSettings, "p2p-bench-client", config.passphrase),
-    ]);
-
-    const seedFiles = await createDeterministicDataset({
-        rootDir: hostVault,
-        datasetDirName: config.datasetDirName,
-        seed: config.datasetSeed,
-        mdCount: config.mdFileCount,
-        mdMinSizeBytes: config.mdMinSizeBytes,
-        mdMaxSizeBytes: config.mdMaxSizeBytes,
-        binCount: config.binFileCount,
-        binSizeBytes: config.binSizeBytes,
-    });
-
-    const mirrorStart = nowMs();
-    await runCliOrFail(hostVault, "--settings", hostSettings, "mirror");
-    const mirrorElapsed = nowMs() - mirrorStart;
-
-    const host = startCliInBackground(hostVault, "--settings", hostSettings, "p2p-host");
-    try {
-        const hostReadyStart = nowMs();
-        await host.waitUntilContains("P2P host is running", 20000);
-        const hostReadyElapsed = nowMs() - hostReadyStart;
-
-        const peerDiscoveryStart = nowMs();
-        const peer = await discoverPeer(clientVault, clientSettings, config.peersTimeoutSeconds);
-        const peerDiscoveryElapsed = nowMs() - peerDiscoveryStart;
-
-        const syncStart = nowMs();
-        await runCliOrFail(
-            clientVault,
-            "--settings",
-            clientSettings,
-            "p2p-sync",
-            peer.id,
-            String(config.syncTimeoutSeconds)
-        );
-        const syncElapsed = nowMs() - syncStart;
-
-        const sampleFiles = pickSampleFiles(seedFiles.entries);
-        for (const sample of sampleFiles) {
-            const pulledPath = workDir.join(`pulled-${sample.relativePath.replaceAll("/", "_")}`);
-            await runCliOrFail(clientVault, "--settings", clientSettings, "pull", sample.relativePath, pulledPath);
-            await assertFilesEqual(
-                sample.absolutePath,
-                pulledPath,
-                `sample file mismatch after sync: ${sample.relativePath}`
-            );
-        }
-
-        const result = {
-            mode: "p2p-cli-benchmark",
-            relay: config.relay,
-            appId: config.appId,
-            roomId: config.roomId,
-            datasetSeed: config.datasetSeed,
-            datasetDirName: config.datasetDirName,
-            peerId: peer.id,
-            peerName: peer.name,
-            totalFiles: seedFiles.totalFiles,
-            totalBytes: seedFiles.totalBytes,
-            mdFileCount: seedFiles.mdCount,
-            binFileCount: seedFiles.binCount,
-            mirrorElapsedMs: Number(mirrorElapsed.toFixed(1)),
-            hostReadyElapsedMs: Number(hostReadyElapsed.toFixed(1)),
-            peerDiscoveryElapsedMs: Number(peerDiscoveryElapsed.toFixed(1)),
-            syncElapsedMs: Number(syncElapsed.toFixed(1)),
-            throughputBytesPerSec: Number((seedFiles.totalBytes / (syncElapsed / 1000)).toFixed(2)),
-            throughputMiBPerSec: Number((seedFiles.totalBytes / (syncElapsed / 1000) / 1024 / 1024).toFixed(4)),
-        };
-
-        if (resultPath) {
-            await Deno.writeTextFile(resultPath, JSON.stringify(result, null, 2));
-        }
-
-        console.log(JSON.stringify(result, null, 2));
-        console.error(
-            `[Benchmark] mirrored ${seedFiles.totalFiles} files (${formatBytes(seedFiles.totalBytes)}) in ${formatMs(mirrorElapsed)}, ` +
-                `synced in ${formatMs(syncElapsed)} ` +
-                `(${result.throughputBytesPerSec} B/s, ${result.throughputMiBPerSec} MiB/s)`
-        );
-    } finally {
-        await host.stop();
-        await stopLocalRelayIfStarted(relayStarted);
-    }
-}
-
-if (import.meta.main) {
-    main().catch((error) => {
-        console.error(`[Fatal Error]`, error);
-        Deno.exit(1);
-    });
-}

src/apps/cli/testdeno/bench-run-item1.sh

@@ -1,45 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-RESULTS_ROOT="${SCRIPT_DIR}/bench-results"
-TIMESTAMP="$(date +%Y%m%d-%H%M%S)"
-OUT_DIR="${RESULTS_ROOT}/${TIMESTAMP}"
-
-mkdir -p "${OUT_DIR}"
-
-echo "[bench-wrapper] output directory: ${OUT_DIR}"
-
-echo "[bench-wrapper] running p2p benchmark"
-(
-  cd "${SCRIPT_DIR}"
-  BENCH_RESULT_JSON="${OUT_DIR}/p2p.json" deno task bench:p2p
-)
-
-echo "[bench-wrapper] running couchdb benchmark with RTT ${BENCH_COUCHDB_RTT_MS:-default} ms (emulating HTTP network latency)"
-(
-  cd "${SCRIPT_DIR}"
-  BENCH_RESULT_JSON="${OUT_DIR}/couchdb.json" deno task bench:couchdb
-)
-
-cat > "${OUT_DIR}/README.txt" <<EOF
-Bench wrapper result set
-
-Generated at: ${TIMESTAMP}
-Directory: ${OUT_DIR}
-
-Files:
-- p2p.json
-- couchdb.json
-EOF
-
-echo "[bench-wrapper] verify outputs by cat"
-echo "========== ${OUT_DIR}/README.txt =========="
-cat "${OUT_DIR}/README.txt"
-echo "========== ${OUT_DIR}/p2p.json =========="
-cat "${OUT_DIR}/p2p.json"
-echo "========== ${OUT_DIR}/couchdb.json =========="
-cat "${OUT_DIR}/couchdb.json"
-
-echo "[bench-wrapper] done"
-echo "[bench-wrapper] result directory: ${OUT_DIR}"

src/apps/cli/testdeno/deno.json

@@ -1,30 +1,19 @@
 {
     "tasks": {
-        "test": "deno test --env-file=.test.env -A --no-check test-*.ts",
-        "test:local": "deno test --env-file=.test.env -A --no-check test-setup-put-cat.ts test-mirror.ts test-daemon.ts",
-        "test:daemon": "deno test --env-file=.test.env -A --no-check test-daemon.ts",
-        "test:decoupled-vault": "deno test --env-file=.test.env -A --no-check test-decoupled-vault.ts",
-        "test:remote-commands": "deno test --env-file=.test.env -A --no-check test-remote-commands.ts",
-        "test:push-pull": "deno test --env-file=.test.env -A --no-check test-push-pull.ts",
-        "test:setup-put-cat": "deno test --env-file=.test.env -A --no-check test-setup-put-cat.ts",
-        "test:mirror": "deno test --env-file=.test.env -A --no-check test-mirror.ts",
-        "test:sync-two-local": "deno test --env-file=.test.env -A --no-check test-sync-two-local-databases.ts",
-        "test:sync-locked-remote": "deno test --env-file=.test.env -A --no-check test-sync-locked-remote.ts",
-        "test:p2p-host": "deno test --env-file=.test.env -A --no-check test-p2p-host.ts",
-        "test:p2p-peers": "deno test --env-file=.test.env -A --no-check test-p2p-peers-local-relay.ts",
-        "test:p2p-sync": "deno test --env-file=.test.env -A --no-check test-p2p-sync.ts",
-        "test:p2p-three-nodes": "deno test --env-file=.test.env -A --no-check test-p2p-three-nodes-conflict.ts",
-        "test:p2p-upload-download": "deno test --env-file=.test.env -A --no-check test-p2p-upload-download-repro.ts",
-        "bench:p2p": "deno run --env-file=.test.env -A --no-check bench-p2p.ts",
-        "bench:couchdb": "deno run --env-file=.test.env -A --no-check bench-couchdb.ts",
-        "bench:item1": "bash ./bench-run-item1.sh",
-        "bench:item1:full": "BENCH_MD_FILE_COUNT=1500 BENCH_MD_MIN_SIZE_BYTES=1024 BENCH_MD_MAX_SIZE_BYTES=20480 BENCH_BIN_FILE_COUNT=500 BENCH_BIN_SIZE_BYTES=102400 BENCH_COUCHDB_RTT_MS=50 bash ./bench-run-item1.sh",
-        "test:e2e-couchdb": "deno test --env-file=.test.env -A --no-check test-e2e-two-vaults-couchdb.ts",
-        "test:e2e-matrix": "deno test --env-file=.test.env -A --no-check test-e2e-two-vaults-matrix.ts",
-        "test:e2e-matrix:couchdb-enc0": "deno test --env-file=.test.env -A --no-check --filter='e2e matrix: COUCHDB-enc0' test-e2e-two-vaults-matrix.ts",
-        "test:e2e-matrix:couchdb-enc1": "deno test --env-file=.test.env -A --no-check --filter='e2e matrix: COUCHDB-enc1' test-e2e-two-vaults-matrix.ts",
-        "test:e2e-matrix:minio-enc0": "deno test --env-file=.test.env -A --no-check --filter='e2e matrix: MINIO-enc0' test-e2e-two-vaults-matrix.ts",
-        "test:e2e-matrix:minio-enc1": "deno test --env-file=.test.env -A --no-check --filter='e2e matrix: MINIO-enc1' test-e2e-two-vaults-matrix.ts"
+        "test": "deno test -A --no-check test-*.ts",
+        "test:local": "deno test -A --no-check test-setup-put-cat.ts test-mirror.ts",
+        "test:push-pull": "deno test -A --no-check test-push-pull.ts",
+        "test:setup-put-cat": "deno test -A --no-check test-setup-put-cat.ts",
+        "test:mirror": "deno test -A --no-check test-mirror.ts",
+        "test:sync-two-local": "deno test -A --no-check test-sync-two-local-databases.ts",
+        "test:sync-locked-remote": "deno test -A --no-check test-sync-locked-remote.ts",
+        "test:p2p-host": "deno test -A --no-check test-p2p-host.ts",
+        "test:p2p-peers": "deno test -A --no-check test-p2p-peers-local-relay.ts",
+        "test:p2p-sync": "deno test -A --no-check test-p2p-sync.ts",
+        "test:p2p-three-nodes": "deno test -A --no-check test-p2p-three-nodes-conflict.ts",
+        "test:p2p-upload-download": "deno test -A --no-check test-p2p-upload-download-repro.ts",
+        "test:e2e-couchdb": "deno test -A --no-check test-e2e-two-vaults-couchdb.ts",
+        "test:e2e-matrix": "deno test -A --no-check test-e2e-two-vaults-matrix.ts"
     },
     "imports": {
         "@std/assert": "jsr:@std/assert@^1.0.13",

src/apps/cli/testdeno/helpers/backgroundCli.ts

@@ -1,4 +1,4 @@
-import { CLI_DIR, TEE_ENABLED, formatTeeCommand, createLineTeeWriter } from "./cli.ts";
+import { CLI_DIR } from "./cli.ts";
 import { join } from "@std/path";
 
 const CLI_DIST = join(CLI_DIR, "dist", "index.cjs");
@@ -12,9 +12,10 @@ function decorateArgs(args: string[]): string[] {
 async function pump(
     stream: ReadableStream<Uint8Array>,
     sink: (text: string) => void,
-    teeTarget: { write: (chunk: Uint8Array) => void; close: () => void } | null
+    teeTarget: WritableStream<Uint8Array> | null
 ): Promise<void> {
     const reader = stream.getReader();
+    const writer = teeTarget?.getWriter();
     const dec = new TextDecoder();
     try {
         while (true) {
@@ -22,12 +23,12 @@ async function pump(
             if (done) break;
             if (!value) continue;
             sink(dec.decode(value, { stream: true }));
-            if (teeTarget) {
-                teeTarget.write(value);
+            if (writer) {
+                await writer.write(value);
             }
         }
     } finally {
-        if (teeTarget) teeTarget.close();
+        if (writer) writer.releaseLock();
         reader.releaseLock();
     }
 }
@@ -42,20 +43,19 @@ export class BackgroundCliProcess {
         readonly child: Deno.ChildProcess,
         readonly args: string[]
     ) {
-        const cliArgs = decorateArgs(args);
         this.#stdoutDone = pump(
             child.stdout,
             (text) => {
                 this.#stdout += text;
             },
-            TEE_ENABLED ? createLineTeeWriter(child.pid, "stdout", (chunk) => Deno.stdout.writeSync(chunk)) : null
+            null
         );
         this.#stderrDone = pump(
             child.stderr,
             (text) => {
                 this.#stderr += text;
             },
-            TEE_ENABLED ? createLineTeeWriter(child.pid, "stderr", (chunk) => Deno.stderr.writeSync(chunk)) : null
+            null
         );
     }
 
@@ -101,20 +101,12 @@ export class BackgroundCliProcess {
 }
 
 export function startCliInBackground(...args: string[]): BackgroundCliProcess {
-    const cliArgs = decorateArgs(args);
     const child = new Deno.Command("node", {
-        args: [CLI_DIST, ...cliArgs],
+        args: [CLI_DIST, ...decorateArgs(args)],
         cwd: CLI_DIR,
         stdin: "null",
         stdout: "piped",
         stderr: "piped",
     }).spawn();
-
-    if (TEE_ENABLED) {
-        Deno.stdout.writeSync(
-            new TextEncoder().encode(`[CLI tee pid=${child.pid}] process(bg): ${formatTeeCommand(cliArgs)}\n`)
-        );
-    }
-
     return new BackgroundCliProcess(child, args);
 }

src/apps/cli/testdeno/helpers/cli.ts

@@ -20,7 +20,7 @@ export interface CliResult {
     code: number;
 }
 
-export const TEE_ENABLED = Deno.env.get("LIVESYNC_TEST_TEE") === "1";
+const TEE_ENABLED = Deno.env.get("LIVESYNC_TEST_TEE") === "1";
 const VERBOSE_ENABLED = Deno.env.get("LIVESYNC_CLI_VERBOSE") === "1";
 const DEBUG_ENABLED = Deno.env.get("LIVESYNC_CLI_DEBUG") === "1";
 
@@ -39,73 +39,27 @@ function concatChunks(chunks: Uint8Array[]): Uint8Array {
     return out;
 }
 
-export function formatTeeCommand(args: string[]): string {
-    return ["node", CLI_DIST, ...args].map((part) => JSON.stringify(part)).join(" ");
-}
-
-export function createLineTeeWriter(
-    pid: number,
-    streamName: "stdout" | "stderr",
-    writer: (chunk: Uint8Array) => void
-): { write: (chunk: Uint8Array) => void; close: () => void } {
-    const enc = new TextEncoder();
-    const dec = new TextDecoder();
-    let pending = "";
-    let headerWritten = false;
-    const emitLine = (line: string) => {
-        if (!headerWritten) {
-            writer(enc.encode(`[CLI tee pid=${pid}:${streamName}]\n`));
-            headerWritten = true;
-        }
-        writer(enc.encode(`[CLI tee pid=${pid}:${streamName}] ${line}\n`));
-    };
-
-    const flush = (final = false) => {
-        let index = pending.indexOf("\n");
-        while (index >= 0) {
-            const line = pending.slice(0, index).replace(/\r$/, "");
-            pending = pending.slice(index + 1);
-            emitLine(line);
-            index = pending.indexOf("\n");
-        }
-        if (final && pending.length > 0) {
-            emitLine(pending.replace(/\r$/, ""));
-            pending = "";
-        }
-    };
-
-    return {
-        write(chunk: Uint8Array) {
-            pending += dec.decode(chunk, { stream: true });
-            flush(false);
-        },
-        close() {
-            pending += dec.decode();
-            flush(true);
-        },
-    };
-}
-
 async function collectStream(
     stream: ReadableStream<Uint8Array>,
-    teeTarget: { write: (chunk: Uint8Array) => void; close: () => void } | null
+    teeTarget: WritableStream<Uint8Array> | null
 ): Promise<Uint8Array> {
     const reader = stream.getReader();
     const chunks: Uint8Array[] = [];
+    const writer = teeTarget?.getWriter();
     try {
         while (true) {
             const { done, value } = await reader.read();
             if (done) break;
             if (value) {
                 chunks.push(value);
-                if (teeTarget) {
-                    teeTarget.write(value);
+                if (writer) {
+                    await writer.write(value);
                 }
             }
         }
     } finally {
-        if (teeTarget) {
-            teeTarget.close();
+        if (writer) {
+            writer.releaseLock();
         }
         reader.releaseLock();
     }
@@ -122,20 +76,8 @@ async function runNodeCommand(args: string[], stdinData?: Uint8Array): Promise<C
         stderr: "piped",
     }).spawn();
 
-    if (TEE_ENABLED) {
-        Deno.stdout.writeSync(
-            new TextEncoder().encode(`[CLI tee pid=${child.pid}] process: ${formatTeeCommand(cliArgs)}\n`)
-        );
-    }
-
-    const stdoutPromise = collectStream(
-        child.stdout,
-        TEE_ENABLED ? createLineTeeWriter(child.pid, "stdout", (chunk) => Deno.stdout.writeSync(chunk)) : null
-    );
-    const stderrPromise = collectStream(
-        child.stderr,
-        TEE_ENABLED ? createLineTeeWriter(child.pid, "stderr", (chunk) => Deno.stderr.writeSync(chunk)) : null
-    );
+    const stdoutPromise = collectStream(child.stdout, TEE_ENABLED ? Deno.stdout.writable : null);
+    const stderrPromise = collectStream(child.stderr, TEE_ENABLED ? Deno.stderr.writable : null);
 
     if (stdinData) {
         const w = child.stdin.getWriter();

src/apps/cli/testdeno/helpers/dataset.ts

@@ -1,123 +0,0 @@
-export type DeterministicDatasetConfig = {
-    rootDir: string;
-    datasetDirName: string;
-    seed: string;
-    mdCount: number;
-    mdMinSizeBytes: number;
-    mdMaxSizeBytes: number;
-    binCount: number;
-    binSizeBytes: number;
-};
-
-export type DatasetEntry = {
-    kind: "md" | "bin";
-    relativePath: string;
-    absolutePath: string;
-    size: number;
-};
-
-export type DeterministicDataset = {
-    rootDir: string;
-    datasetDirName: string;
-    seed: string;
-    entries: DatasetEntry[];
-    totalFiles: number;
-    totalBytes: number;
-    mdCount: number;
-    binCount: number;
-};
-
-function fnv1a32(input: string): number {
-    let hash = 0x811c9dc5;
-    for (let i = 0; i < input.length; i++) {
-        hash ^= input.charCodeAt(i) & 0xff;
-        hash = Math.imul(hash, 0x01000193);
-    }
-    return hash >>> 0;
-}
-
-function createXorshift32(seed: number): () => number {
-    let state = seed >>> 0;
-    if (state === 0) {
-        state = 0x9e3779b9;
-    }
-    return () => {
-        state ^= state << 13;
-        state ^= state >>> 17;
-        state ^= state << 5;
-        return state >>> 0;
-    };
-}
-
-function createTextBytes(size: number, fileIndex: number, seed: string): Uint8Array {
-    const template =
-        `# Bench file ${fileIndex}\n` +
-        `seed: ${seed}\n` +
-        "lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\n";
-
-    const templateBytes = new TextEncoder().encode(template);
-    const out = new Uint8Array(size);
-    for (let i = 0; i < size; i++) {
-        out[i] = templateBytes[i % templateBytes.length];
-    }
-    return out;
-}
-
-function toPath(rootDir: string, relativePath: string): string {
-    return `${rootDir}/${relativePath}`;
-}
-
-export async function createDeterministicDataset(config: DeterministicDatasetConfig): Promise<DeterministicDataset> {
-    if (config.mdCount < 0 || config.binCount < 0) {
-        throw new Error("mdCount and binCount must be non-negative");
-    }
-    if (config.mdMinSizeBytes <= 0 || config.mdMaxSizeBytes <= 0 || config.binSizeBytes <= 0) {
-        throw new Error("all size values must be positive");
-    }
-    if (config.mdMinSizeBytes > config.mdMaxSizeBytes) {
-        throw new Error("mdMinSizeBytes must be <= mdMaxSizeBytes");
-    }
-
-    const datasetRoot = toPath(config.rootDir, config.datasetDirName);
-    const mdDir = `${datasetRoot}/md`;
-    const binDir = `${datasetRoot}/bin`;
-    await Deno.mkdir(mdDir, { recursive: true });
-    await Deno.mkdir(binDir, { recursive: true });
-
-    const nextRandom = createXorshift32(fnv1a32(config.seed));
-    const mdRange = config.mdMaxSizeBytes - config.mdMinSizeBytes + 1;
-    const entries: DatasetEntry[] = [];
-
-    for (let index = 0; index < config.mdCount; index++) {
-        const size = config.mdMinSizeBytes + (nextRandom() % mdRange);
-        const relativePath = `${config.datasetDirName}/md/file-${String(index).padStart(4, "0")}.md`;
-        const absolutePath = toPath(config.rootDir, relativePath);
-        const body = createTextBytes(size, index, config.seed);
-        await Deno.writeFile(absolutePath, body);
-        entries.push({ kind: "md", relativePath, absolutePath, size });
-    }
-
-    for (let index = 0; index < config.binCount; index++) {
-        const size = config.binSizeBytes;
-        const relativePath = `${config.datasetDirName}/bin/file-${String(index).padStart(4, "0")}.bin`;
-        const absolutePath = toPath(config.rootDir, relativePath);
-        const body = new Uint8Array(size);
-        for (let i = 0; i < size; i++) {
-            body[i] = nextRandom() & 0xff;
-        }
-        await Deno.writeFile(absolutePath, body);
-        entries.push({ kind: "bin", relativePath, absolutePath, size });
-    }
-
-    const totalBytes = entries.reduce((sum, e) => sum + e.size, 0);
-    return {
-        rootDir: config.rootDir,
-        datasetDirName: config.datasetDirName,
-        seed: config.seed,
-        entries,
-        totalFiles: entries.length,
-        totalBytes,
-        mdCount: config.mdCount,
-        binCount: config.binCount,
-    };
-}

src/apps/cli/testdeno/helpers/docker.ts

@@ -14,11 +14,6 @@ type DockerInvoker = {
 
 let dockerInvokerPromise: Promise<DockerInvoker> | null = null;
 const DOCKER_TEE = Deno.env.get("LIVESYNC_DOCKER_TEE") === "1" || Deno.env.get("LIVESYNC_TEST_TEE") === "1";
-const trackedContainers = new Set<string>();
-const CLEANUP_SIGNALS: Deno.Signal[] = ["SIGINT", "SIGTERM"];
-let signalCleanupHandlersInstalled = false;
-let signalCleanupInProgress = false;
-const signalCleanupHandlers = new Map<Deno.Signal, () => void>();
 
 // ---------------------------------------------------------------------------
 // Low-level docker wrapper
@@ -32,53 +27,29 @@ function parseCommand(command: string): { bin: string; prefix: string[] } {
     return { bin: parts[0], prefix: parts.slice(1) };
 }
 
-async function collectStream(
-    stream: ReadableStream<Uint8Array>,
-    teeTarget: ((chunk: Uint8Array) => void) | null
-): Promise<Uint8Array> {
-    const reader = stream.getReader();
-    const chunks: Uint8Array[] = [];
-    try {
-        while (true) {
-            const { done, value } = await reader.read();
-            if (done) break;
-            if (!value) continue;
-            chunks.push(value);
-            if (teeTarget) {
-                teeTarget(value);
-            }
-        }
-    } finally {
-        reader.releaseLock();
-    }
-
-    const total = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
-    const out = new Uint8Array(total);
-    let offset = 0;
-    for (const chunk of chunks) {
-        out.set(chunk, offset);
-        offset += chunk.length;
-    }
-    return out;
-}
-
 async function runCommand(bin: string, args: string[]): Promise<{ code: number; stdout: string; stderr: string }> {
+    const cmd = new Deno.Command(bin, {
+        args,
+        stdin: "null",
+        stdout: "piped",
+        stderr: "piped",
+    });
     try {
-        const child = new Deno.Command(bin, {
-            args,
-            stdin: "null",
-            stdout: "piped",
-            stderr: "piped",
-        }).spawn();
-        const stdoutPromise = collectStream(child.stdout, DOCKER_TEE ? (chunk) => Deno.stdout.writeSync(chunk) : null);
-        const stderrPromise = collectStream(child.stderr, DOCKER_TEE ? (chunk) => Deno.stderr.writeSync(chunk) : null);
-        const [status, stdout, stderr] = await Promise.all([child.status, stdoutPromise, stderrPromise]);
+        const { code, stdout, stderr } = await cmd.output();
         const dec = new TextDecoder();
         const result = {
-            code: status.code,
+            code,
             stdout: dec.decode(stdout),
             stderr: dec.decode(stderr),
         };
+        if (DOCKER_TEE) {
+            if (result.stdout.trim().length > 0) {
+                console.log(`[docker:${bin}] ${result.stdout.trimEnd()}`);
+            }
+            if (result.stderr.trim().length > 0) {
+                console.error(`[docker:${bin}] ${result.stderr.trimEnd()}`);
+            }
+        }
         return result;
     } catch (err) {
         if (err instanceof Deno.errors.NotFound) {
@@ -188,73 +159,6 @@ async function dockerOrFail(...args: string[]): Promise<string> {
     return r.stdout;
 }
 
-async function stopAndRemoveContainer(container: string): Promise<void> {
-    await docker("stop", container).catch(() => {});
-    await docker("rm", container).catch(() => {});
-}
-
-async function cleanupTrackedContainers(reason: string): Promise<void> {
-    const names = [...trackedContainers];
-    if (names.length === 0) return;
-
-    console.warn(`[WARN] cleaning up tracked containers on ${reason}: ${names.join(", ")}`);
-    for (const container of names.reverse()) {
-        await stopAndRemoveContainer(container);
-        trackedContainers.delete(container);
-    }
-}
-
-async function handleSignalCleanup(signal: Deno.Signal): Promise<void> {
-    if (signalCleanupInProgress) return;
-    signalCleanupInProgress = true;
-    try {
-        await cleanupTrackedContainers(`signal ${signal}`);
-    } finally {
-        Deno.exit(signal === "SIGINT" ? 130 : 143);
-    }
-}
-
-function ensureSignalCleanupHandlers(): void {
-    if (signalCleanupHandlersInstalled) return;
-    signalCleanupHandlersInstalled = true;
-    for (const signal of CLEANUP_SIGNALS) {
-        const listener = () => {
-            void handleSignalCleanup(signal);
-        };
-        try {
-            Deno.addSignalListener(signal, listener);
-            signalCleanupHandlers.set(signal, listener);
-        } catch {
-            // Unsupported signal on this platform.
-        }
-    }
-}
-
-function removeSignalCleanupHandlers(): void {
-    if (!signalCleanupHandlersInstalled) return;
-    for (const [signal, listener] of signalCleanupHandlers) {
-        try {
-            Deno.removeSignalListener(signal, listener);
-        } catch {
-            // Ignore if already removed or unsupported.
-        }
-    }
-    signalCleanupHandlers.clear();
-    signalCleanupHandlersInstalled = false;
-}
-
-function trackContainer(container: string): void {
-    ensureSignalCleanupHandlers();
-    trackedContainers.add(container);
-}
-
-function untrackContainer(container: string): void {
-    trackedContainers.delete(container);
-    if (trackedContainers.size === 0) {
-        removeSignalCleanupHandlers();
-    }
-}
-
 function sleep(ms: number): Promise<void> {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -331,8 +235,8 @@ const MINIO_IMAGE = "minio/minio";
 const MINIO_MC_IMAGE = "minio/mc";
 
 export async function stopCouchdb(): Promise<void> {
-    await stopAndRemoveContainer(COUCHDB_CONTAINER);
-    untrackContainer(COUCHDB_CONTAINER);
+    await docker("stop", COUCHDB_CONTAINER);
+    await docker("rm", COUCHDB_CONTAINER);
 }
 
 /**
@@ -361,7 +265,6 @@ export async function startCouchdb(couchdbUri: string, user: string, password: s
         "COUCHDB_SINGLE_NODE=y",
         COUCHDB_IMAGE
     );
-    trackContainer(COUCHDB_CONTAINER);
 
     console.log("[INFO] initialising CouchDB");
     await initCouchdb(couchdbUri, user, password);
@@ -462,8 +365,8 @@ function shQuote(value: string): string {
 }
 
 export async function stopMinio(): Promise<void> {
-    await stopAndRemoveContainer(MINIO_CONTAINER);
-    untrackContainer(MINIO_CONTAINER);
+    await docker("stop", MINIO_CONTAINER);
+    await docker("rm", MINIO_CONTAINER);
 }
 
 async function initMinioBucket(
@@ -543,7 +446,6 @@ export async function startMinio(
         "--console-address",
         ":9001"
     );
-    trackContainer(MINIO_CONTAINER);
 
     console.log(`[INFO] initialising MinIO test bucket: ${bucket}`);
     let initialised = false;
@@ -591,8 +493,8 @@ EOF
 exec /app/strfry --config /tmp/strfry.conf relay`;
 
 export async function stopP2pRelay(): Promise<void> {
-    await stopAndRemoveContainer(P2P_RELAY_CONTAINER);
-    untrackContainer(P2P_RELAY_CONTAINER);
+    await docker("stop", P2P_RELAY_CONTAINER);
+    await docker("rm", P2P_RELAY_CONTAINER);
 }
 
 /**
@@ -621,51 +523,8 @@ export async function startP2pRelay(): Promise<void> {
         "-lc",
         STRFRY_BOOTSTRAP_SH
     );
-    trackContainer(P2P_RELAY_CONTAINER);
 }
 
 export function isLocalP2pRelay(relayUrl: string): boolean {
-    return relayUrl.includes("localhost") || relayUrl.includes("127.0.0.1") || relayUrl.includes("[::1]");
-}
-
-// ---------------------------------------------------------------------------
-// Coturn (STUN/TURN)
-// ---------------------------------------------------------------------------
-const COTURN_CONTAINER = "coturn-test";
-const COTURN_IMAGE = "coturn/coturn:latest";
-
-export async function stopCoturn(): Promise<void> {
-    await stopAndRemoveContainer(COTURN_CONTAINER);
-    untrackContainer(COTURN_CONTAINER);
-}
-
-export async function startCoturn(
-    port = 3478,
-    user = "testuser",
-    pass = "testpass",
-    realm = "livesync.test"
-): Promise<void> {
-    console.log("[INFO] stopping leftover Coturn container if present");
-    await stopCoturn().catch(() => {});
-
-    const { getOptimalLoopbackIp } = await import("./net.ts");
-    const externalIp = await getOptimalLoopbackIp();
-
-    console.log(`[INFO] starting local Coturn container with external-ip ${externalIp}`);
-    await dockerOrFail(
-        "run",
-        "-d",
-        "--name",
-        COTURN_CONTAINER,
-        "-p",
-        `${port}:${port}`,
-        "-p",
-        `${port}:${port}/udp`,
-        COTURN_IMAGE,
-        "--log-file=stdout",
-        `--external-ip=${externalIp}`,
-        `--user=${user}:${pass}`,
-        `--realm=${realm}`
-    );
-    trackContainer(COTURN_CONTAINER);
+    return relayUrl === "ws://localhost:4000" || relayUrl === "ws://localhost:4000/";
 }

src/apps/cli/testdeno/helpers/net.ts

@@ -1,68 +0,0 @@
-type WaitForPortOptions = {
-    timeoutMs?: number;
-    intervalMs?: number;
-    connectTimeoutMs?: number;
-};
-
-function sleep(ms: number): Promise<void> {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-async function connectWithTimeout(hostname: string, port: number, timeoutMs: number): Promise<void> {
-    let timer: number | undefined;
-    try {
-        const connPromise = Deno.connect({ hostname, port });
-        const timeoutPromise = new Promise<never>((_, reject) => {
-            timer = setTimeout(() => reject(new Error(`connect timeout after ${timeoutMs}ms`)), timeoutMs);
-        });
-        const conn = await Promise.race([connPromise, timeoutPromise]);
-        conn.close();
-    } finally {
-        if (timer !== undefined) {
-            clearTimeout(timer);
-        }
-    }
-}
-
-export async function waitForPort(hostname: string, port: number, options: WaitForPortOptions = {}): Promise<void> {
-    const timeoutMs = options.timeoutMs ?? 15000;
-    const intervalMs = options.intervalMs ?? 250;
-    const connectTimeoutMs = options.connectTimeoutMs ?? 1000;
-
-    const started = Date.now();
-    let lastError: unknown;
-
-    while (Date.now() - started < timeoutMs) {
-        try {
-            await connectWithTimeout(hostname, port, connectTimeoutMs);
-            return;
-        } catch (error) {
-            lastError = error;
-            await sleep(intervalMs);
-        }
-    }
-
-    throw new Error(
-        `Port ${hostname}:${port} did not become ready within ${timeoutMs}ms` +
-            (lastError ? ` (last error: ${String(lastError)})` : "")
-    );
-}
-
-export async function getOptimalLoopbackIp(): Promise<string> {
-    const ipv4 = "127.0.0.1";
-    const ipv6 = "::1";
-
-    try {
-        const l = Deno.listen({ hostname: ipv4, port: 0 });
-        l.close();
-        return ipv4;
-    } catch {
-        try {
-            const l = Deno.listen({ hostname: ipv6, port: 0 });
-            l.close();
-            return ipv6;
-        } catch {
-            return ipv4; // fallback to default
-        }
-    }
-}

src/apps/cli/testdeno/helpers/p2p.ts

@@ -1,26 +1,11 @@
 import { runCli } from "./cli.ts";
-import { isLocalP2pRelay, startP2pRelay, stopP2pRelay, startCoturn, stopCoturn } from "./docker.ts";
-import { waitForPort } from "./net.ts";
+import { isLocalP2pRelay, startP2pRelay, stopP2pRelay } from "./docker.ts";
 
 export type PeerEntry = {
     id: string;
     name: string;
 };
 
-function sleep(ms: number): Promise<void> {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-function parseRelayEndpoint(relay: string): { hostname: string; port: number } {
-    const url = new URL(relay);
-    const port = url.port ? Number(url.port) : url.protocol === "ws:" ? 80 : url.protocol === "wss:" ? 443 : NaN;
-    if (!Number.isFinite(port)) {
-        throw new Error(`Unsupported relay URL: ${relay}`);
-    }
-    const hostname = url.hostname === "localhost" ? "127.0.0.1" : url.hostname;
-    return { hostname, port };
-}
-
 export function parsePeerLines(output: string): PeerEntry[] {
     return output
         .split(/\r?\n/)
@@ -35,58 +20,28 @@ export async function discoverPeer(
     timeoutSeconds: number,
     targetPeer?: string
 ): Promise<PeerEntry> {
-    const retries = Math.max(0, Number(Deno.env.get("LIVESYNC_P2P_PEERS_RETRY") ?? "3"));
-    let lastCombined = "";
-
-    for (let attempt = 0; attempt <= retries; attempt++) {
-        const result = await runCli(vaultDir, "--settings", settingsFile, "p2p-peers", String(timeoutSeconds));
-        lastCombined = result.combined;
-
-        if (result.code === 0) {
-            const peers = parsePeerLines(result.stdout);
-            if (targetPeer) {
-                const matched = peers.find((peer) => peer.id === targetPeer || peer.name === targetPeer);
-                if (matched) return matched;
-            }
-            if (peers.length > 0) {
-                return peers[0];
-            }
-
-            const fallback = result.combined.match(/Advertisement from\s+([^\s]+)/);
-            if (fallback?.[1]) {
-                return { id: fallback[1], name: fallback[1] };
-            }
-        }
-
-        if (attempt < retries) {
-            const waitMs = 400 * (attempt + 1);
-            console.warn(
-                `[WARN] p2p-peers returned no usable peers, retrying (${attempt + 1}/${retries}) in ${waitMs}ms`
-            );
-            await sleep(waitMs);
-            continue;
-        }
-
-        throw new Error(
-            result.code !== 0 ? `p2p-peers failed\n${result.combined}` : `No peers discovered\n${result.combined}`
-        );
+    const result = await runCli(vaultDir, "--settings", settingsFile, "p2p-peers", String(timeoutSeconds));
+    if (result.code !== 0) {
+        throw new Error(`p2p-peers failed\n${result.combined}`);
     }
-
-    throw new Error(`No peers discovered\n${lastCombined}`);
+    const peers = parsePeerLines(result.stdout);
+    if (targetPeer) {
+        const matched = peers.find((peer) => peer.id === targetPeer || peer.name === targetPeer);
+        if (matched) return matched;
+    }
+    if (peers.length === 0) {
+        const fallback = result.combined.match(/Advertisement from\s+([^\s]+)/);
+        if (fallback?.[1]) {
+            return { id: fallback[1], name: fallback[1] };
+        }
+        throw new Error(`No peers discovered\n${result.combined}`);
+    }
+    return peers[0];
 }
 
 export async function maybeStartLocalRelay(relay: string): Promise<boolean> {
     if (!isLocalP2pRelay(relay)) return false;
     await startP2pRelay();
-    const endpoint = parseRelayEndpoint(relay);
-    await waitForPort(endpoint.hostname, endpoint.port, {
-        timeoutMs: Number(Deno.env.get("LIVESYNC_P2P_RELAY_READY_TIMEOUT_MS") ?? "15000"),
-        intervalMs: Number(Deno.env.get("LIVESYNC_P2P_RELAY_READY_INTERVAL_MS") ?? "250"),
-        connectTimeoutMs: Number(Deno.env.get("LIVESYNC_P2P_RELAY_CONNECT_TIMEOUT_MS") ?? "1000"),
-    });
-    // Docker proxy accepts TCP connections instantly before the container's internal process is fully ready.
-    // Wait an additional few seconds to ensure strfry is actually accepting WebSockets.
-    await sleep(3000);
     return true;
 }
 
@@ -95,17 +50,3 @@ export async function stopLocalRelayIfStarted(started: boolean): Promise<void> {
         await stopP2pRelay().catch(() => {});
     }
 }
-
-export async function maybeStartCoturn(turnServers: string): Promise<boolean> {
-    if (turnServers.includes("localhost") || turnServers.includes("127.0.0.1") || turnServers.includes("[::1]")) {
-        await startCoturn();
-        return true;
-    }
-    return false;
-}
-
-export async function stopCoturnIfStarted(started: boolean): Promise<void> {
-    if (started) {
-        await stopCoturn().catch(() => {});
-    }
-}

src/apps/cli/testdeno/helpers/settings.ts

@@ -172,8 +172,7 @@ export async function applyP2pSettings(
     passphrase: string,
     appId = "self-hosted-livesync-cli-tests",
     relays = "ws://localhost:4000/",
-    autoAccept = "~.*",
-    turnServers = "turn:127.0.0.1:3478"
+    autoAccept = "~.*"
 ): Promise<void> {
     const data = JSON.parse(await Deno.readTextFile(settingsFile));
     data.P2P_Enabled = true;
@@ -185,9 +184,6 @@ export async function applyP2pSettings(
     data.P2P_relays = relays;
     data.P2P_AutoAcceptingPeers = autoAccept;
     data.P2P_AutoDenyingPeers = "";
-    data.P2P_turnServers = turnServers;
-    data.P2P_turnUsername = "testuser";
-    data.P2P_turnCredential = "testpass";
     data.P2P_IsHeadless = true;
     data.isConfigured = true;
     await Deno.writeTextFile(settingsFile, JSON.stringify(data, null, 2));

src/apps/cli/testdeno/test-daemon.ts

@@ -1,116 +0,0 @@
-/**
- * Deno port of test-daemon-linux.sh
- *
- * Tests daemon-related ignore rules behaviour.
- *
- * Tests that are runnable without a long-running daemon process are exercised
- * here using the 'mirror' command, which calls the same 'isTargetFile' handler
- * stack that the daemon uses.
- *
- * Covered cases:
- *   1. .livesync/ignore with *.tmp pattern  → ignored file is not synced to database
- *   2. .livesync/ignore missing             → no error, and normal synchronisation continues
- *   3. import: .gitignore directive         → patterns from .gitignore are merged
- *
- * Run:
- *   deno test -A test-daemon.ts
- */
-
-import { join } from "@std/path";
-import { assertEquals } from "@std/assert";
-import { TempDir } from "./helpers/temp.ts";
-import { runCliOrFail, runCli, assertContains, assertNotContains } from "./helpers/cli.ts";
-import { initSettingsFile, markSettingsConfigured } from "./helpers/settings.ts";
-
-Deno.test("daemon: ignore rules behaviour", async (t) => {
-    // -------------------------------------------------------------------------
-    // Case 1: .livesync/ignore with *.tmp → ignored file not synced to database
-    // -------------------------------------------------------------------------
-    await t.step("case 1: .livesync/ignore *.tmp prevents sync", async () => {
-        await using workDir = await TempDir.create("livesync-cli-daemon-c1");
-        const settingsFile = workDir.join("data.json");
-        const vaultDir = workDir.join("vault");
-
-        await Deno.mkdir(join(vaultDir, ".livesync"), { recursive: true });
-        await Deno.mkdir(join(vaultDir, "notes"), { recursive: true });
-
-        await initSettingsFile(settingsFile);
-        await markSettingsConfigured(settingsFile);
-
-        await Deno.writeTextFile(join(vaultDir, ".livesync", "ignore"), "*.tmp\n");
-        await Deno.writeTextFile(join(vaultDir, "notes", "normal.md"), "normal content\n");
-        await Deno.writeTextFile(join(vaultDir, "notes", "scratch.tmp"), "tmp content\n");
-
-        console.log("[INFO] Running mirror for Case 1...");
-        await runCliOrFail(vaultDir, "--settings", settingsFile, "mirror");
-
-        // The normal file should be in the database.
-        const resultNormal = workDir.join("case1-normal.txt");
-        await runCliOrFail(vaultDir, "--settings", settingsFile, "pull", "notes/normal.md", resultNormal);
-        const normalContent = await Deno.readTextFile(resultNormal);
-        assertEquals(normalContent, "normal content\n", "normal.md content mismatch after mirror");
-
-        // The .tmp file should NOT be in the database.
-        const dbList = await runCliOrFail(vaultDir, "--settings", settingsFile, "ls");
-        assertNotContains(dbList, "scratch.tmp", "scratch.tmp (ignored) was unexpectedly synced to database");
-        assertContains(dbList, "normal.md", "normal.md was not found in database after mirror");
-        console.log("[PASS] Case 1 verified successfully");
-    });
-
-    // -------------------------------------------------------------------------
-    // Case 2: .livesync/ignore absent → no error, and normal synchronisation continues
-    // -------------------------------------------------------------------------
-    await t.step("case 2: .livesync/ignore absent does not cause failure", async () => {
-        await using workDir = await TempDir.create("livesync-cli-daemon-c2");
-        const settingsFile = workDir.join("data2.json");
-        const vaultDir = workDir.join("vault2");
-
-        await Deno.mkdir(join(vaultDir, "notes"), { recursive: true });
-
-        await initSettingsFile(settingsFile);
-        await markSettingsConfigured(settingsFile);
-
-        // No .livesync directory at all.
-        await Deno.writeTextFile(join(vaultDir, "notes", "hello.md"), "hello\n");
-
-        console.log("[INFO] Running mirror for Case 2...");
-        const result = await runCli(vaultDir, "--settings", settingsFile, "mirror");
-        assertEquals(result.code, 0, "mirror exited non-zero when .livesync/ignore is absent");
-
-        // The normal file should have been synced.
-        const resultHello = workDir.join("case2-hello.txt");
-        await runCliOrFail(vaultDir, "--settings", settingsFile, "pull", "notes/hello.md", resultHello);
-        const helloContent = await Deno.readTextFile(resultHello);
-        assertEquals(helloContent, "hello\n", "file content mismatch when .livesync/ignore is absent");
-        console.log("[PASS] Case 2 verified successfully");
-    });
-
-    // -------------------------------------------------------------------------
-    // Case 3: import: .gitignore merges patterns
-    // -------------------------------------------------------------------------
-    await t.step("case 3: import: .gitignore directive merges patterns", async () => {
-        await using workDir = await TempDir.create("livesync-cli-daemon-c3");
-        const settingsFile = workDir.join("data3.json");
-        const vaultDir = workDir.join("vault3");
-
-        await Deno.mkdir(join(vaultDir, ".livesync"), { recursive: true });
-        await Deno.mkdir(join(vaultDir, "notes"), { recursive: true });
-
-        await initSettingsFile(settingsFile);
-        await markSettingsConfigured(settingsFile);
-
-        await Deno.writeTextFile(join(vaultDir, ".livesync", "ignore"), "import: .gitignore\n");
-        await Deno.writeTextFile(join(vaultDir, ".gitignore"), "# gitignore comment\n*.log\nbuild/\n");
-
-        await Deno.writeTextFile(join(vaultDir, "notes", "regular.md"), "regular note\n");
-        await Deno.writeTextFile(join(vaultDir, "notes", "debug.log"), "log content\n");
-
-        console.log("[INFO] Running mirror for Case 3...");
-        await runCliOrFail(vaultDir, "--settings", settingsFile, "mirror");
-
-        const dbList = await runCliOrFail(vaultDir, "--settings", settingsFile, "ls");
-        assertNotContains(dbList, "debug.log", "debug.log (ignored via .gitignore import) was unexpectedly synced to database");
-        assertContains(dbList, "regular.md", "regular.md was not synced normally alongside .gitignore import rules");
-        console.log("[PASS] Case 3 verified successfully");
-    });
-});

src/apps/cli/testdeno/test-decoupled-vault.ts

@@ -1,114 +0,0 @@
-/**
- * Deno port of test-decoupled-vault-linux.sh
- *
- * Tests push, pull, and mirror command behaviour when the vault directory is
- * decoupled (separated) from the database directory.
- *
- * Run:
- *   deno test -A test-decoupled-vault.ts
- */
-
-import { join } from "@std/path";
-import { assertEquals } from "@std/assert";
-import { TempDir } from "./helpers/temp.ts";
-import { runCliOrFail } from "./helpers/cli.ts";
-import { applyCouchdbSettings, initSettingsFile, markSettingsConfigured } from "./helpers/settings.ts";
-import { startCouchdb, stopCouchdb } from "./helpers/docker.ts";
-
-const REMOTE_PATH = Deno.env.get("REMOTE_PATH") ?? "test/push-pull-decoupled.txt";
-
-Deno.test("decoupled database and vault", async () => {
-    await using workDir = await TempDir.create("livesync-cli-decoupled");
-
-    const settingsFile = workDir.join("data.json");
-    const vaultDir = workDir.join("vault");
-    const dbDir = workDir.join("db");
-
-    await Deno.mkdir(join(vaultDir, "test"), { recursive: true });
-    await Deno.mkdir(dbDir, { recursive: true });
-
-    const uri = Deno.env.get("COUCHDB_URI") ?? "http://127.0.0.1:5989/";
-    const user = Deno.env.get("COUCHDB_USER") ?? "admin";
-    const password = Deno.env.get("COUCHDB_PASSWORD") ?? "testpassword";
-    const dbname = Deno.env.get("COUCHDB_DBNAME") ?? `decoupled-${Date.now()}`;
-
-    const shouldStartDocker = Deno.env.get("LIVESYNC_START_DOCKER") !== "0";
-    const keepDocker = Deno.env.get("LIVESYNC_DEBUG_KEEP_DOCKER") === "1";
-
-    if (shouldStartDocker) {
-        await startCouchdb(uri, user, password, dbname);
-    }
-
-    try {
-        await initSettingsFile(settingsFile);
-
-        if (uri && user && password && dbname) {
-            console.log("[INFO] applying CouchDB environment variables to settings");
-            await applyCouchdbSettings(settingsFile, uri, user, password, dbname);
-        } else {
-            console.warn(
-                "[WARN] CouchDB environment variables are not fully set. Push and pull operations may fail."
-            );
-            await markSettingsConfigured(settingsFile);
-        }
-
-        const srcFile = workDir.join("push-source.txt");
-        const pulledFile = workDir.join("pull-result.txt");
-        const content = `push-pull-decoupled-test ${new Date().toISOString()}\n`;
-        await Deno.writeTextFile(srcFile, content);
-
-        // 1. Test push command with decoupled vault directory
-        console.log(`[INFO] push with decoupled vault -> ${REMOTE_PATH}`);
-        await runCliOrFail(
-            dbDir,
-            "--vault",
-            vaultDir,
-            "--settings",
-            settingsFile,
-            "push",
-            srcFile,
-            REMOTE_PATH
-        );
-
-        // 2. Test pull command with decoupled vault directory
-        console.log(`[INFO] pull with decoupled vault <- ${REMOTE_PATH}`);
-        await runCliOrFail(
-            dbDir,
-            "--vault",
-            vaultDir,
-            "--settings",
-            settingsFile,
-            "pull",
-            REMOTE_PATH,
-            pulledFile
-        );
-
-        const pulled = await Deno.readTextFile(pulledFile);
-        assertEquals(pulled, content, "push/pull roundtrip with decoupled vault content mismatch");
-        console.log("[PASS] push/pull roundtrip with decoupled vault matched");
-
-        // 3. Clean up pulled file and vault test directory to verify mirror
-        await Deno.remove(pulledFile).catch(() => {});
-        await Deno.remove(join(vaultDir, "test"), { recursive: true }).catch(() => {});
-
-        // 4. Test mirror command with decoupled vault directory
-        console.log("[INFO] mirror with decoupled vault");
-        await runCliOrFail(
-            dbDir,
-            "--vault",
-            vaultDir,
-            "--settings",
-            settingsFile,
-            "mirror"
-        );
-
-        const restoredFile = join(vaultDir, REMOTE_PATH);
-        const restored = await Deno.readTextFile(restoredFile);
-        assertEquals(restored, content, "mirror with decoupled vault content mismatch");
-        console.log("[PASS] mirror with decoupled vault matched");
-    } finally {
-        if (shouldStartDocker && !keepDocker) {
-            await stopCouchdb().catch(() => {});
-        }
-    }
-});

src/apps/cli/testdeno/test-e2e-two-vaults-couchdb.ts

@@ -1,5 +1,6 @@
 import { assert } from "@std/assert";
 import { TempDir } from "./helpers/temp.ts";
+import { loadEnvFile } from "./helpers/env.ts";
 import {
     runCli,
     runCliOrFail,
@@ -10,30 +11,31 @@ import {
 } from "./helpers/cli.ts";
 import { applyRemoteSyncSettings, initSettingsFile } from "./helpers/settings.ts";
 import { startCouchdb, startMinio, stopCouchdb, stopMinio } from "./helpers/docker.ts";
+import { join } from "@std/path";
+
+const TEST_ENV = join(import.meta.dirname!, "..", ".test.env");
 type RemoteType = "COUCHDB" | "MINIO";
 
-function requireEnv(...keys: string[]): string {
-    for (const key of keys) {
-        const value = Deno.env.get(key)?.trim();
-        if (value) return value;
-    }
-    throw new Error(`Required env var is missing: ${keys.join(" or ")}`);
+function requireEnv(env: Record<string, string>, key: string): string {
+    const value = env[key]?.trim();
+    if (!value) throw new Error(`Required env var is missing: ${key}`);
+    return value;
 }
 
 export async function runScenario(remoteType: RemoteType, encrypt: boolean): Promise<void> {
+    const env = await loadEnvFile(TEST_ENV);
     const dbSuffix = `${Date.now()}-${Math.floor(Math.random() * 100000)}`;
 
-    const couchdbUri = remoteType === "COUCHDB" ? requireEnv("COUCHDB_URI", "hostname").replace(/\/$/, "") : "";
-    const couchdbUser = remoteType === "COUCHDB" ? requireEnv("COUCHDB_USER", "username") : "";
-    const couchdbPassword = remoteType === "COUCHDB" ? requireEnv("COUCHDB_PASSWORD", "password") : "";
-    const dbPrefix = remoteType === "COUCHDB" ? requireEnv("COUCHDB_DBNAME", "dbname") : "";
+    const couchdbUri = remoteType === "COUCHDB" ? requireEnv(env, "hostname").replace(/\/$/, "") : "";
+    const couchdbUser = remoteType === "COUCHDB" ? requireEnv(env, "username") : "";
+    const couchdbPassword = remoteType === "COUCHDB" ? requireEnv(env, "password") : "";
+    const dbPrefix = remoteType === "COUCHDB" ? requireEnv(env, "dbname") : "";
     const dbname = remoteType === "COUCHDB" ? `${dbPrefix}-${dbSuffix}` : "";
 
-    const minioEndpoint =
-        remoteType === "MINIO" ? requireEnv("MINIO_ENDPOINT", "minioEndpoint").replace(/\/$/, "") : "";
-    const minioAccessKey = remoteType === "MINIO" ? requireEnv("MINIO_ACCESS_KEY", "accessKey") : "";
-    const minioSecretKey = remoteType === "MINIO" ? requireEnv("MINIO_SECRET_KEY", "secretKey") : "";
-    const minioBucketBase = remoteType === "MINIO" ? requireEnv("MINIO_BUCKET_NAME", "bucketName") : "";
+    const minioEndpoint = remoteType === "MINIO" ? requireEnv(env, "minioEndpoint").replace(/\/$/, "") : "";
+    const minioAccessKey = remoteType === "MINIO" ? requireEnv(env, "accessKey") : "";
+    const minioSecretKey = remoteType === "MINIO" ? requireEnv(env, "secretKey") : "";
+    const minioBucketBase = remoteType === "MINIO" ? requireEnv(env, "bucketName") : "";
     const minioBucket = remoteType === "MINIO" ? `${minioBucketBase}-${dbSuffix}` : "";
 
     const passphrase = "e2e-passphrase";

src/apps/cli/testdeno/test-mirror.ts

@@ -39,10 +39,6 @@ Deno.test("mirror: storage <-> DB synchronisation", async (t) => {
     // isConfigured=true is required for canProceedScan in the mirror command.
     await markSettingsConfigured(settingsFile);
 
-    const data = JSON.parse(await Deno.readTextFile(settingsFile));
-    data.writeDocumentsIfConflicted = true;
-    await Deno.writeTextFile(settingsFile, JSON.stringify(data, null, 2));
-
     // Copy settings to the DB directory (separated-path mode)
     const dbSettings = workDir.join("db", "settings.json");
     await Deno.copyFile(settingsFile, dbSettings);

src/apps/cli/testdeno/test-p2p-peers-local-relay.ts

@@ -2,28 +2,13 @@ import { assert } from "@std/assert";
 import { TempDir } from "./helpers/temp.ts";
 import { initSettingsFile, applyP2pSettings, applyP2pTestTweaks } from "./helpers/settings.ts";
 import { startCliInBackground } from "./helpers/backgroundCli.ts";
-import {
-    discoverPeer,
-    maybeStartLocalRelay,
-    stopLocalRelayIfStarted,
-    maybeStartCoturn,
-    stopCoturnIfStarted,
-} from "./helpers/p2p.ts";
-import { getOptimalLoopbackIp } from "./helpers/net.ts";
+import { discoverPeer, maybeStartLocalRelay, stopLocalRelayIfStarted } from "./helpers/p2p.ts";
 
 Deno.test("p2p-peers: discovers host through local relay", async () => {
-    const loopbackIp = await getOptimalLoopbackIp();
-    const loopbackHost = loopbackIp === "::1" ? "[::1]" : loopbackIp;
-    
-    const relay = Deno.env.get("RELAY") ?? `ws://${loopbackHost}:4000/`;
+    const relay = Deno.env.get("RELAY") ?? "ws://localhost:4000/";
     const roomId = Deno.env.get("ROOM_ID") ?? `room-${Date.now()}`;
     const passphrase = Deno.env.get("PASSPHRASE") ?? "test";
     const timeoutSeconds = Number(Deno.env.get("TIMEOUT_SECONDS") ?? "8");
-    const nonce = `${Date.now()}-${crypto.randomUUID().slice(0, 8)}`;
-    const hostPeerName = Deno.env.get("HOST_PEER_NAME") ?? `p2p-host-${nonce}`;
-    const clientPeerName = Deno.env.get("CLIENT_PEER_NAME") ?? `p2p-client-${nonce}`;
-    const useCoturn = Deno.env.get("LIVESYNC_USE_COTURN") !== "0";
-    const turnServers = Deno.env.get("TURN_SERVERS") ?? (useCoturn ? `turn:${loopbackHost}:3478` : "none");
 
     await using workDir = await TempDir.create("livesync-cli-p2p-peers-local-relay");
     const hostVault = workDir.join("vault-host");
@@ -34,43 +19,24 @@ Deno.test("p2p-peers: discovers host through local relay", async () => {
     await Deno.mkdir(clientVault, { recursive: true });
 
     const relayStarted = await maybeStartLocalRelay(relay);
-    const coturnStarted = await maybeStartCoturn(turnServers);
     try {
         await initSettingsFile(hostSettings);
         await initSettingsFile(clientSettings);
-        await applyP2pSettings(
-            hostSettings,
-            roomId,
-            passphrase,
-            "self-hosted-livesync-cli-tests",
-            relay,
-            "~.*",
-            turnServers
-        );
-        await applyP2pSettings(
-            clientSettings,
-            roomId,
-            passphrase,
-            "self-hosted-livesync-cli-tests",
-            relay,
-            "~.*",
-            turnServers
-        );
-        await applyP2pTestTweaks(hostSettings, hostPeerName, passphrase);
-        await applyP2pTestTweaks(clientSettings, clientPeerName, passphrase);
+        await applyP2pSettings(hostSettings, roomId, passphrase, "self-hosted-livesync-cli-tests", relay);
+        await applyP2pSettings(clientSettings, roomId, passphrase, "self-hosted-livesync-cli-tests", relay);
+        await applyP2pTestTweaks(hostSettings, "p2p-host", passphrase);
+        await applyP2pTestTweaks(clientSettings, "p2p-client", passphrase);
 
         const host = startCliInBackground(hostVault, "--settings", hostSettings, "p2p-host");
         try {
             await host.waitUntilContains("P2P host is running", 20000);
-            const peer = await discoverPeer(clientVault, clientSettings, timeoutSeconds, hostPeerName);
+            const peer = await discoverPeer(clientVault, clientSettings, timeoutSeconds);
             assert(peer.id.length > 0);
             assert(peer.name.length > 0);
-            assert(peer.name === hostPeerName, `expected peer '${hostPeerName}', got '${peer.name}'`);
         } finally {
             await host.stop();
         }
     } finally {
         await stopLocalRelayIfStarted(relayStarted);
-        await stopCoturnIfStarted(coturnStarted);
     }
 });

src/apps/cli/testdeno/test-p2p-sync.ts

@@ -2,30 +2,15 @@ import { assert } from "@std/assert";
 import { TempDir } from "./helpers/temp.ts";
 import { initSettingsFile, applyP2pSettings, applyP2pTestTweaks } from "./helpers/settings.ts";
 import { startCliInBackground } from "./helpers/backgroundCli.ts";
-import {
-    discoverPeer,
-    maybeStartLocalRelay,
-    stopLocalRelayIfStarted,
-    maybeStartCoturn,
-    stopCoturnIfStarted,
-} from "./helpers/p2p.ts";
+import { discoverPeer, maybeStartLocalRelay, stopLocalRelayIfStarted } from "./helpers/p2p.ts";
 import { runCli } from "./helpers/cli.ts";
-import { getOptimalLoopbackIp } from "./helpers/net.ts";
 
 Deno.test("p2p-sync: discovers peer and completes sync", async () => {
-    const loopbackIp = await getOptimalLoopbackIp();
-    const loopbackHost = loopbackIp === "::1" ? "[::1]" : loopbackIp;
-    
-    const relay = Deno.env.get("RELAY") ?? `ws://${loopbackHost}:4000/`;
+    const relay = Deno.env.get("RELAY") ?? "ws://localhost:4000/";
     const roomId = Deno.env.get("ROOM_ID") ?? `room-${Date.now()}`;
     const passphrase = Deno.env.get("PASSPHRASE") ?? "test";
     const peersTimeout = Number(Deno.env.get("PEERS_TIMEOUT") ?? "12");
     const syncTimeout = Number(Deno.env.get("SYNC_TIMEOUT") ?? "15");
-    const nonce = `${Date.now()}-${crypto.randomUUID().slice(0, 8)}`;
-    const hostPeerName = Deno.env.get("HOST_PEER_NAME") ?? `p2p-host-${nonce}`;
-    const clientPeerName = Deno.env.get("CLIENT_PEER_NAME") ?? `p2p-client-${nonce}`;
-    const useCoturn = Deno.env.get("LIVESYNC_USE_COTURN") !== "0";
-    const turnServers = Deno.env.get("TURN_SERVERS") ?? (useCoturn ? `turn:${loopbackHost}:3478` : "none");
 
     await using workDir = await TempDir.create("livesync-cli-p2p-sync");
     const hostVault = workDir.join("vault-host");
@@ -36,30 +21,13 @@ Deno.test("p2p-sync: discovers peer and completes sync", async () => {
     await Deno.mkdir(clientVault, { recursive: true });
 
     const relayStarted = await maybeStartLocalRelay(relay);
-    const coturnStarted = await maybeStartCoturn(turnServers);
     try {
         await initSettingsFile(hostSettings);
         await initSettingsFile(clientSettings);
-        await applyP2pSettings(
-            hostSettings,
-            roomId,
-            passphrase,
-            "self-hosted-livesync-cli-tests",
-            relay,
-            "~.*",
-            turnServers
-        );
-        await applyP2pSettings(
-            clientSettings,
-            roomId,
-            passphrase,
-            "self-hosted-livesync-cli-tests",
-            relay,
-            "~.*",
-            turnServers
-        );
-        await applyP2pTestTweaks(hostSettings, hostPeerName, passphrase);
-        await applyP2pTestTweaks(clientSettings, clientPeerName, passphrase);
+        await applyP2pSettings(hostSettings, roomId, passphrase, "self-hosted-livesync-cli-tests", relay);
+        await applyP2pSettings(clientSettings, roomId, passphrase, "self-hosted-livesync-cli-tests", relay);
+        await applyP2pTestTweaks(hostSettings, "p2p-host", passphrase);
+        await applyP2pTestTweaks(clientSettings, "p2p-client", passphrase);
 
         const host = startCliInBackground(hostVault, "--settings", hostSettings, "p2p-host");
         try {
@@ -68,7 +36,7 @@ Deno.test("p2p-sync: discovers peer and completes sync", async () => {
                 clientVault,
                 clientSettings,
                 peersTimeout,
-                Deno.env.get("TARGET_PEER") ?? hostPeerName
+                Deno.env.get("TARGET_PEER") ?? undefined
             );
             const syncResult = await runCli(
                 clientVault,
@@ -87,6 +55,5 @@ Deno.test("p2p-sync: discovers peer and completes sync", async () => {
         }
     } finally {
         await stopLocalRelayIfStarted(relayStarted);
-        await stopCoturnIfStarted(coturnStarted);
     }
 });

src/apps/cli/testdeno/test-p2p-three-nodes-conflict.ts

@@ -1,33 +1,17 @@
 import { assert } from "@std/assert";
 import { TempDir } from "./helpers/temp.ts";
-import { applyP2pSettings, applyP2pTestTweaks, initSettingsFile } from "./helpers/settings.ts";
+import { applyP2pSettings, initSettingsFile } from "./helpers/settings.ts";
 import { startCliInBackground } from "./helpers/backgroundCli.ts";
-import {
-    discoverPeer,
-    maybeStartLocalRelay,
-    stopLocalRelayIfStarted,
-    maybeStartCoturn,
-    stopCoturnIfStarted,
-} from "./helpers/p2p.ts";
+import { discoverPeer, maybeStartLocalRelay, stopLocalRelayIfStarted } from "./helpers/p2p.ts";
 import { jsonStringField, runCliOrFail, runCliWithInputOrFail, sanitiseCatStdout } from "./helpers/cli.ts";
-import { getOptimalLoopbackIp } from "./helpers/net.ts";
 
 Deno.test("p2p: three nodes detect and resolve conflicts", async () => {
-    const loopbackIp = await getOptimalLoopbackIp();
-    const loopbackHost = loopbackIp === "::1" ? "[::1]" : loopbackIp;
-    
-    const relay = Deno.env.get("RELAY") ?? `ws://${loopbackHost}:4000/`;
-    const roomId = Deno.env.get("ROOM_ID") ?? `room-${Date.now()}`;
-    const passphrase = Deno.env.get("PASSPHRASE") ?? "test";
-    const appId = "self-hosted-livesync-cli-tests";
+    const relay = Deno.env.get("RELAY") ?? "ws://localhost:4000/";
+    const roomId = `${Deno.env.get("ROOM_ID_PREFIX") ?? "p2p-room"}-${Date.now()}`;
+    const passphrase = `${Deno.env.get("PASSPHRASE_PREFIX") ?? "p2p-pass"}-${Date.now()}`;
+    const appId = Deno.env.get("APP_ID") ?? "self-hosted-livesync-cli-tests";
     const peersTimeout = Number(Deno.env.get("PEERS_TIMEOUT") ?? "10");
     const syncTimeout = Number(Deno.env.get("SYNC_TIMEOUT") ?? "15");
-    const nonce = `${Date.now()}-${crypto.randomUUID().slice(0, 8)}`;
-    const hostPeerName = Deno.env.get("HOST_PEER_NAME") ?? `p2p-host-${nonce}`;
-    const peerNameB = Deno.env.get("PEER_NAME_B") ?? `p2p-client-b-${nonce}`;
-    const peerNameC = Deno.env.get("PEER_NAME_C") ?? `p2p-client-c-${nonce}`;
-    const useCoturn = Deno.env.get("LIVESYNC_USE_COTURN") !== "0";
-    const turnServers = Deno.env.get("TURN_SERVERS") ?? (useCoturn ? `turn:${loopbackHost}:3478` : "none");
 
     await using workDir = await TempDir.create("livesync-cli-p2p-3nodes");
     const vaultA = workDir.join("vault-a");
@@ -41,23 +25,17 @@ Deno.test("p2p: three nodes detect and resolve conflicts", async () => {
     await Deno.mkdir(vaultC, { recursive: true });
 
     const relayStarted = await maybeStartLocalRelay(relay);
-    const coturnStarted = await maybeStartCoturn(turnServers);
     try {
-        await initSettingsFile(settingsA);
-        await initSettingsFile(settingsB);
-        await initSettingsFile(settingsC);
-        await applyP2pSettings(settingsA, roomId, passphrase, appId, relay, "~.*", turnServers);
-        await applyP2pSettings(settingsB, roomId, passphrase, appId, relay, "~.*", turnServers);
-        await applyP2pSettings(settingsC, roomId, passphrase, appId, relay, "~.*", turnServers);
-        await applyP2pTestTweaks(settingsA, hostPeerName, passphrase);
-        await applyP2pTestTweaks(settingsB, peerNameB, passphrase);
-        await applyP2pTestTweaks(settingsC, peerNameC, passphrase);
+        for (const settings of [settingsA, settingsB, settingsC]) {
+            await initSettingsFile(settings);
+            await applyP2pSettings(settings, roomId, passphrase, appId, relay);
+        }
 
         const host = startCliInBackground(vaultA, "--settings", settingsA, "p2p-host");
         try {
             await host.waitUntilContains("P2P host is running", 20000);
-            const peerFromB = await discoverPeer(vaultB, settingsB, peersTimeout, hostPeerName);
-            const peerFromC = await discoverPeer(vaultC, settingsC, peersTimeout, hostPeerName);
+            const peerFromB = await discoverPeer(vaultB, settingsB, peersTimeout);
+            const peerFromC = await discoverPeer(vaultC, settingsC, peersTimeout);
             const targetPath = "p2p/conflicted-from-two-clients.txt";
 
             await runCliWithInputOrFail("from-client-b-v1\n", vaultB, "--settings", settingsB, "put", targetPath);
@@ -136,6 +114,5 @@ Deno.test("p2p: three nodes detect and resolve conflicts", async () => {
         }
     } finally {
         await stopLocalRelayIfStarted(relayStarted);
-        await stopCoturnIfStarted(coturnStarted);
     }
 });

src/apps/cli/testdeno/test-remote-commands.ts

@@ -1,130 +0,0 @@
-/**
- * Deno port of test-remote-commands-linux.sh
- *
- * Tests remote management commands: remote-status, lock-remote, unlock-remote,
- * and mark-resolved.
- *
- * Scenario:
- *   1. Start CouchDB, create a test database, and perform an initial sync.
- *   2. Run remote-status and assert that the output contains the database name in JSON format.
- *   3. Run lock-remote and verify that the remote database is locked.
- *   4. Lock the remote database milestone manually, verify status, and run unlock-remote.
- *      Assert that the output of unlock-remote contains the unlocked verification status.
- *   5. Lock the remote database milestone manually, run mark-resolved, and verify that the
- *      current device is accepted.
- *
- * Run:
- *   deno test -A test-remote-commands.ts
- */
-
-import { join } from "@std/path";
-import { TempDir } from "./helpers/temp.ts";
-import { runCli, assertContains } from "./helpers/cli.ts";
-import { applyCouchdbSettings, initSettingsFile } from "./helpers/settings.ts";
-import { startCouchdb, stopCouchdb, updateCouchdbDoc } from "./helpers/docker.ts";
-
-async function runCliCombinedOrFail(...args: string[]): Promise<string> {
-    const res = await runCli(...args);
-    if (res.code !== 0) {
-        throw new Error(`CLI exited with code ${res.code}\nstdout: ${res.stdout}\nstderr: ${res.stderr}`);
-    }
-    return res.combined;
-}
-
-Deno.test("remote management commands", async () => {
-    await using workDir = await TempDir.create("livesync-cli-remote-cmds");
-
-    const settingsFile = workDir.join("settings.json");
-    const vaultDir = workDir.join("vault");
-    await Deno.mkdir(vaultDir, { recursive: true });
-
-    const uri = Deno.env.get("COUCHDB_URI") ?? "http://127.0.0.1:5989/";
-    const user = Deno.env.get("COUCHDB_USER") ?? "admin";
-    const password = Deno.env.get("COUCHDB_PASSWORD") ?? "testpassword";
-    const dbSuffix = `${Date.now()}-${Math.floor(Math.random() * 10000)}`;
-    const dbname = Deno.env.get("COUCHDB_DBNAME") ?? `remotes-${dbSuffix}`;
-
-    const shouldStartDocker = Deno.env.get("LIVESYNC_START_DOCKER") !== "0";
-    const keepDocker = Deno.env.get("LIVESYNC_DEBUG_KEEP_DOCKER") === "1";
-
-    if (shouldStartDocker) {
-        await startCouchdb(uri, user, password, dbname);
-    }
-
-    try {
-        await initSettingsFile(settingsFile);
-        await applyCouchdbSettings(settingsFile, uri, user, password, dbname, true);
-
-        console.log("[INFO] Performing initial sync to create milestone document...");
-        await runCliCombinedOrFail(vaultDir, "--settings", settingsFile, "sync");
-
-        // 1. remote-status outputs valid JSON with CouchDB details
-        console.log("[CASE] remote-status outputs valid JSON with CouchDB details");
-        const statusOutput = await runCliCombinedOrFail(vaultDir, "--settings", settingsFile, "remote-status");
-        assertContains(
-            statusOutput,
-            `"db_name": "${dbname}"`,
-            "remote-status should return JSON containing db_name"
-        );
-        console.log("[PASS] remote-status verified");
-
-        // 2. lock-remote locks and verifies state
-        console.log("[CASE] lock-remote locks and verifies state");
-        const lockOutput = await runCliCombinedOrFail(vaultDir, "--settings", settingsFile, "lock-remote");
-        assertContains(
-            lockOutput,
-            "[Verification] Remote Database: LOCKED",
-            "lock-remote output should show that the remote database is locked"
-        );
-        console.log("[PASS] lock-remote verified");
-
-        // 3. unlock-remote unlocks and verifies state
-        console.log("[CASE] unlock-remote unlocks and verifies state");
-        // Manually lock milestone
-        console.log("[INFO] Manually locking milestone...");
-        await updateCouchdbDoc(uri, user, password, `${dbname}/_local/obsydian_livesync_milestone`, (doc) => {
-            doc.locked = true;
-            doc.accepted_nodes = [];
-            return doc;
-        });
-
-        // Run unlock-remote and verify output contains verification message
-        const unlockOutput = await runCliCombinedOrFail(vaultDir, "--settings", settingsFile, "unlock-remote");
-        assertContains(
-            unlockOutput,
-            "[Verification] Remote Database: UNLOCKED",
-            "unlock-remote output should contain verification status"
-        );
-        console.log("[PASS] unlock-remote verified");
-
-        // 4. mark-resolved resolves and verifies state
-        console.log("[CASE] mark-resolved resolves and verifies state");
-        // Manually lock milestone
-        console.log("[INFO] Manually locking milestone...");
-        await updateCouchdbDoc(uri, user, password, `${dbname}/_local/obsydian_livesync_milestone`, (doc) => {
-            doc.locked = true;
-            doc.accepted_nodes = [];
-            return doc;
-        });
-
-        // Run mark-resolved and verify output contains verification messages
-        const resolvedOutput = await runCliCombinedOrFail(vaultDir, "--settings", settingsFile, "mark-resolved");
-        assertContains(
-            resolvedOutput,
-            "[Verification] Remote Database: LOCKED",
-            "mark-resolved output should show that the remote database remains locked"
-        );
-        assertContains(
-            resolvedOutput,
-            "ACCEPTED",
-            "mark-resolved output should show that the current device node is accepted"
-        );
-        console.log("[PASS] mark-resolved verified");
-
-        console.log("[ALL PASS] All remote CLI commands verified successfully");
-    } finally {
-        if (shouldStartDocker && !keepDocker) {
-            await stopCouchdb().catch(() => {});
-        }
-    }
-});

src/apps/cli/testdeno/test-sync-locked-remote.ts

@@ -6,26 +6,30 @@
  */
 
 import { assert, assertStringIncludes } from "@std/assert";
+import { join } from "@std/path";
+import { loadEnvFile } from "./helpers/env.ts";
 import { TempDir } from "./helpers/temp.ts";
 import { runCli } from "./helpers/cli.ts";
 import { applyCouchdbSettings, initSettingsFile } from "./helpers/settings.ts";
 import { createCouchdbDatabase, startCouchdb, stopCouchdb, updateCouchdbDoc } from "./helpers/docker.ts";
 
+const TEST_ENV = join(import.meta.dirname!, "..", ".test.env");
 const MILESTONE_DOC = "_local/obsydian_livesync_milestone";
 
-function requireEnv(...keys: string[]): string {
-    for (const key of keys) {
-        const value = Deno.env.get(key)?.trim();
-        if (value) return value;
+function requireEnv(env: Record<string, string>, key: string): string {
+    const value = env[key]?.trim();
+    if (!value) {
+        throw new Error(`Required env var is missing: ${key}`);
     }
-    throw new Error(`Required env var is missing: ${keys.join(" or ")}`);
+    return value;
 }
 
 Deno.test("sync: actionable error against locked remote DB", async () => {
-    const couchdbUri = requireEnv("COUCHDB_URI", "hostname").replace(/\/$/, "");
-    const couchdbUser = requireEnv("COUCHDB_USER", "username");
-    const couchdbPassword = requireEnv("COUCHDB_PASSWORD", "password");
-    const dbPrefix = requireEnv("COUCHDB_DBNAME", "dbname");
+    const env = await loadEnvFile(TEST_ENV);
+    const couchdbUri = requireEnv(env, "hostname").replace(/\/$/, "");
+    const couchdbUser = requireEnv(env, "username");
+    const couchdbPassword = requireEnv(env, "password");
+    const dbPrefix = requireEnv(env, "dbname");
     const dbname = `${dbPrefix}-locked-${Date.now()}-${Math.floor(Math.random() * 100000)}`;
 
     await using workDir = await TempDir.create("livesync-cli-locked-test");

src/apps/cli/testdeno/test-sync-two-local-databases.ts

@@ -23,11 +23,13 @@
  *   deno test -A test-sync-two-local-databases.ts
  */
 
+import { join } from "@std/path";
 import { assertEquals, assert } from "@std/assert";
 import { TempDir } from "./helpers/temp.ts";
-import { runCliOrFail, jsonFieldIsNa } from "./helpers/cli.ts";
+import { CLI_DIR, runCliOrFail, jsonFieldIsNa } from "./helpers/cli.ts";
 import { applyCouchdbSettings, initSettingsFile } from "./helpers/settings.ts";
 import { startCouchdb, stopCouchdb } from "./helpers/docker.ts";
+import { loadEnvFile } from "./helpers/env.ts";
 
 // ---------------------------------------------------------------------------
 // Load configuration
@@ -39,7 +41,20 @@ async function resolveConfig(): Promise<{
     password: string;
     baseDbname: string;
 } | null> {
-    const env = Deno.env.toObject();
+    let env: Record<string, string> = {};
+
+    // 1. Explicit environment variables take priority
+    if (Deno.env.get("COUCHDB_URI")) {
+        env = Object.fromEntries(Deno.env.toObject());
+    } else {
+        // 2. TEST_ENV_FILE env var
+        const envFile = Deno.env.get("TEST_ENV_FILE") ?? join(CLI_DIR, ".test.env");
+        try {
+            env = await loadEnvFile(envFile);
+        } catch {
+            return null; // no config available — skip
+        }
+    }
 
     const uri = (env["COUCHDB_URI"] ?? env["hostname"] ?? "").replace(/\/$/, "");
     const user = env["COUCHDB_USER"] ?? env["username"] ?? "";

src/apps/cli/testdeno/test_dev_deno.md

@@ -39,9 +39,6 @@ src/apps/cli/testdeno/
   test-mirror.ts
   test-sync-two-local-databases.ts
   test-sync-locked-remote.ts
-  test-daemon.ts
-  test-decoupled-vault.ts
-  test-remote-commands.ts
 ```
 
 ---
@@ -57,9 +54,6 @@ Main tasks:
 
 - `deno task test`
 - `deno task test:local`
-- `deno task test:daemon`
-- `deno task test:decoupled-vault`
-- `deno task test:remote-commands`
 - `deno task test:push-pull`
 - `deno task test:setup-put-cat`
 - `deno task test:mirror`
@@ -189,19 +183,6 @@ Both CouchDB and P2P relay flows are bash-independent.
   - `MINIO-enc0`
   - `MINIO-enc1`
 
-### `test-daemon.ts`
-
-- Verifies daemon-related ignore rules behaviour.
-- Exercises scenarios with `.livesync/ignore` wildcard rules, missing ignore rules, and imported `.gitignore` rules.
-
-### `test-decoupled-vault.ts`
-
-- Verifies push, pull, and mirror command behaviour when the vault directory is decoupled from the database directory.
-
-### `test-remote-commands.ts`
-
-- Verifies remote database management commands: `remote-status`, `lock-remote`, `unlock-remote`, and `mark-resolved`.
-
 ---
 
 ## Running tests (PowerShell)
@@ -217,14 +198,11 @@ deno task test:local
 # Individual tests
 deno task test:setup-put-cat
 deno task test:mirror
-deno task test:daemon
 deno task test:push-pull
 deno task test:sync-locked-remote
 
 # CouchDB-based tests
 deno task test:sync-two-local
-deno task test:decoupled-vault
-deno task test:remote-commands
 deno task test:e2e-couchdb
 
 # P2P-based tests
@@ -303,7 +281,7 @@ deno task test:sync-two-local
 
 ## Continuous Integration
 
-The GitHub Actions workflow `.github/workflows/cli-deno-tests.yml` runs automatically on pushes and pull requests affecting the CLI, executing the non-P2P test suite (`test:ci`). P2P tests (`test:p2p`) are excluded from automatic execution and must be run via manual dispatch (`workflow_dispatch`). You can optionally check the "Enable verbose and debug logging" checkbox during a manual dispatch to produce detailed trace logs for troubleshooting.
+The GitHub Actions workflow `.github/workflows/cli-deno-tests.yml` is used to run these tests automatically on push and pull requests affecting the CLI.
 
 ---
 

src/apps/cli/vite.config.ts

@@ -2,7 +2,6 @@ import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
 import path from "node:path";
 import { readFileSync } from "node:fs";
-const resolve = (...args: string[]) => path.resolve(...args).replace(/\\/g, "/");
 const packageJson = JSON.parse(readFileSync("../../../package.json", "utf-8"));
 const manifestJson = JSON.parse(readFileSync("../../../manifest.json", "utf-8"));
 // https://vite.dev/config/
@@ -12,66 +11,25 @@ const defaultExternal = [
     "crypto",
     "pouchdb-adapter-leveldb",
     "commander",
-    "chokidar",
     "punycode",
     "werift",
 ];
-// Polyfill FileReader at the very top of the CJS bundle. octagonal-wheels uses
-// FileReader for base64 conversion when Uint8Array.toBase64 (TC39 proposal) is
-// unavailable. Node.js has neither, so we inject a minimal FileReader shim before
-// any module-scope code evaluates.
-const fileReaderPolyfillBanner = `
-if (typeof globalThis.FileReader === "undefined") {
-    globalThis.FileReader = class FileReader {
-        constructor() { this.result = null; this.onload = null; this.onerror = null; }
-        readAsDataURL(blob) {
-            blob.arrayBuffer().then((buf) => {
-                var b64 = require("buffer").Buffer.from(buf).toString("base64");
-                this.result = "data:" + (blob.type || "application/octet-stream") + ";base64," + b64;
-                if (this.onload) this.onload({ target: this });
-            }).catch((err) => { if (this.onerror) this.onerror({ target: this, error: err }); });
-        }
-        readAsArrayBuffer() { throw new Error("FileReader.readAsArrayBuffer is not implemented in this polyfill"); }
-        readAsBinaryString() { throw new Error("FileReader.readAsBinaryString is not implemented in this polyfill"); }
-        readAsText() { throw new Error("FileReader.readAsText is not implemented in this polyfill"); }
-        abort() { throw new Error("FileReader.abort is not implemented in this polyfill"); }
-    };
-}
-`;
-
-function injectBanner(): import("vite").Plugin {
-    return {
-        name: "inject-banner",
-        generateBundle(_options, bundle) {
-            for (const chunk of Object.values(bundle)) {
-                if (chunk.type === "chunk" && chunk.fileName.startsWith("entrypoint")) {
-                    // Insert after the shebang line if present, otherwise at the top.
-                    if (chunk.code.startsWith("#!")) {
-                        const newline = chunk.code.indexOf("\n");
-                        chunk.code =
-                            chunk.code.slice(0, newline + 1) + fileReaderPolyfillBanner + chunk.code.slice(newline + 1);
-                    } else {
-                        chunk.code = fileReaderPolyfillBanner + chunk.code;
-                    }
-                }
-            }
-        },
-    };
-}
-
 export default defineConfig({
-    plugins: [svelte(), injectBanner()],
+    plugins: [svelte()],
     resolve: {
         alias: {
             "@lib/worker/bgWorker.ts": "../../lib/src/worker/bgWorker.mock.ts",
-            "@lib/pouchdb/pouchdb-browser.ts": resolve(__dirname, "lib/pouchdb-node.ts"),
+            "@lib/pouchdb/pouchdb-browser.ts": path.resolve(__dirname, "lib/pouchdb-node.ts"),
             // The CLI runs on Node.js; force AWS XML builder to its CJS Node entry
             // so Vite does not resolve the browser DOMParser-based XML parser.
-            "@aws-sdk/xml-builder": resolve(__dirname, "../../../node_modules/@aws-sdk/xml-builder/dist-cjs/index.js"),
+            "@aws-sdk/xml-builder": path.resolve(
+                __dirname,
+                "../../../node_modules/@aws-sdk/xml-builder/dist-cjs/index.js"
+            ),
             // Force fflate to the Node CJS entry; browser entry expects Web Worker globals.
-            fflate: resolve(__dirname, "../../../node_modules/fflate/lib/node.cjs"),
-            "@": resolve(__dirname, "../../"),
-            "@lib": resolve(__dirname, "../../lib/src"),
+            fflate: path.resolve(__dirname, "../../../node_modules/fflate/lib/node.cjs"),
+            "@": path.resolve(__dirname, "../../"),
+            "@lib": path.resolve(__dirname, "../../lib/src"),
             "../../src/worker/bgWorker.ts": "../../src/worker/bgWorker.mock.ts",
         },
     },
@@ -83,7 +41,7 @@ export default defineConfig({
         minify: false,
         rollupOptions: {
             input: {
-                index: resolve(__dirname, "entrypoint.ts"),
+                index: path.resolve(__dirname, "entrypoint.ts"),
             },
             external: (id) => {
                 if (defaultExternal.includes(id)) return true;
@@ -99,7 +57,7 @@ export default defineConfig({
             },
         },
         lib: {
-            entry: resolve(__dirname, "entrypoint.ts"),
+            entry: path.resolve(__dirname, "entrypoint.ts"),
             formats: ["cjs"],
             fileName: "index",
         },

src/apps/webapp/bootstrap.ts

@@ -41,7 +41,7 @@ async function renderHistoryList(): Promise<VaultHistoryItem[]> {
 
     const [items, lastUsedId] = await Promise.all([historyStore.getVaultHistory(), historyStore.getLastUsedVaultId()]);
 
-    listEl.replaceChildren();
+    listEl.innerHTML = "";
     emptyEl.classList.toggle("is-hidden", items.length > 0);
 
     for (const item of items) {

src/common/reportTool.ts

@@ -1,142 +0,0 @@
-import { REMOTE_COUCHDB, REMOTE_MINIO } from "@lib/common/models/setting.const";
-import type { ObsidianLiveSyncSettings } from "@lib/common/models/setting.type";
-import { generateCredentialObject } from "@lib/replication/httplib";
-import { parseHeaderValues } from "@lib/common/utils";
-import { requestToCouchDBWithCredentials } from "./utils";
-import { LOG_LEVEL_VERBOSE, Logger } from "@lib/common/logger";
-import { DEFAULT_SETTINGS } from "@lib/common/models/setting.const.defaults";
-import { isCloudantURI } from "@lib/pouchdb/utils_couchdb";
-import { compatGlobal } from "@lib/common/coreEnvFunctions";
-import { manifestVersion, packageVersion } from "@lib/common/coreEnvVars";
-import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore";
-function redactObject(obj: Record<string, any>, dotted: string, redactedValue = "REDACTED") {
-    const keys = dotted.split(".");
-    let current = obj;
-    for (let i = 0; i < keys.length - 1; i++) {
-        const key = keys[i];
-        if (!(key in current)) {
-            current[key] = {} as Record<string, any>;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        current = current[key];
-    }
-    const lastKey = keys[keys.length - 1];
-    if (lastKey in current) {
-        current[lastKey] = redactedValue;
-    }
-    return obj;
-}
-export async function generateReport(settings: ObsidianLiveSyncSettings, core: LiveSyncBaseCore) {
-    let responseConfig: Record<string, any> = {};
-    const REDACTED = "𝑅𝐸𝐷𝐴𝐶𝑇𝐸𝐷";
-    if (settings.remoteType == REMOTE_COUCHDB) {
-        try {
-            const credential = generateCredentialObject(settings);
-            const customHeaders = parseHeaderValues(settings.couchDB_CustomHeaders);
-            const r = await requestToCouchDBWithCredentials(
-                settings.couchDB_URI,
-                credential,
-                window.origin,
-                undefined,
-                undefined,
-                undefined,
-                customHeaders
-            );
-            responseConfig = r.json as Record<string, any>;
-            redactObject(responseConfig, "couch_httpd_auth.secret");
-            redactObject(responseConfig, "couch_httpd_auth.authentication_db");
-            redactObject(responseConfig, "couch_httpd_auth.authentication_redirect");
-            redactObject(responseConfig, "couchdb.uuid");
-            redactObject(responseConfig, "admins");
-            redactObject(responseConfig, "users");
-            redactObject(responseConfig, "chttpd_auth.secret");
-            delete responseConfig["jwt_keys"];
-        } catch (ex) {
-            Logger(ex, LOG_LEVEL_VERBOSE);
-            responseConfig = {
-                error: "Requesting information from the remote CouchDB has failed. If you are using IBM Cloudant, this is normal behaviour.",
-            };
-        }
-    } else if (settings.remoteType == REMOTE_MINIO) {
-        responseConfig = { error: "Object Storage Synchronisation" };
-        //
-    }
-    const defaultKeys = Object.keys(DEFAULT_SETTINGS) as (keyof ObsidianLiveSyncSettings)[];
-    const pluginConfig = JSON.parse(JSON.stringify(settings)) as ObsidianLiveSyncSettings;
-    const pluginKeys = Object.keys(pluginConfig);
-    for (const key of pluginKeys) {
-        if (defaultKeys.includes(key as keyof ObsidianLiveSyncSettings)) continue;
-        delete pluginConfig[key as keyof ObsidianLiveSyncSettings];
-    }
-
-    pluginConfig.couchDB_DBNAME = REDACTED;
-    pluginConfig.couchDB_PASSWORD = REDACTED;
-    const scheme = pluginConfig.couchDB_URI.startsWith("http:")
-        ? "(HTTP)"
-        : pluginConfig.couchDB_URI.startsWith("https:")
-          ? "(HTTPS)"
-          : "";
-    pluginConfig.couchDB_URI = isCloudantURI(pluginConfig.couchDB_URI) ? "cloudant" : `self-hosted${scheme}`;
-    pluginConfig.couchDB_USER = REDACTED;
-    pluginConfig.passphrase = REDACTED;
-    pluginConfig.encryptedPassphrase = REDACTED;
-    pluginConfig.encryptedCouchDBConnection = REDACTED;
-    pluginConfig.accessKey = REDACTED;
-    pluginConfig.secretKey = REDACTED;
-    const redact = (source: string) => `${REDACTED}(${source.length} letters)`;
-    const toSchemeOnly = (uri: string) => {
-        try {
-            return `${new URL(uri).protocol}//`;
-        } catch {
-            const matched = uri.match(/^[A-Za-z][A-Za-z0-9+.-]*:\/\//);
-            return matched?.[0] ?? REDACTED;
-        }
-    };
-    pluginConfig.remoteConfigurations = Object.fromEntries(
-        Object.entries(pluginConfig.remoteConfigurations || {}).map(([id, config]) => [
-            id,
-            {
-                ...config,
-                uri: toSchemeOnly(config.uri),
-            },
-        ])
-    );
-    pluginConfig.region = redact(pluginConfig.region);
-    pluginConfig.bucket = redact(pluginConfig.bucket);
-    pluginConfig.pluginSyncExtendedSetting = {};
-    pluginConfig.P2P_AppID = redact(pluginConfig.P2P_AppID);
-    pluginConfig.P2P_passphrase = redact(pluginConfig.P2P_passphrase);
-    pluginConfig.P2P_roomID = redact(pluginConfig.P2P_roomID);
-    pluginConfig.P2P_relays = redact(pluginConfig.P2P_relays);
-    pluginConfig.jwtKey = redact(pluginConfig.jwtKey);
-    pluginConfig.jwtSub = redact(pluginConfig.jwtSub);
-    pluginConfig.jwtKid = redact(pluginConfig.jwtKid);
-    pluginConfig.bucketCustomHeaders = redact(pluginConfig.bucketCustomHeaders);
-    pluginConfig.couchDB_CustomHeaders = redact(pluginConfig.couchDB_CustomHeaders);
-    pluginConfig.P2P_turnCredential = redact(pluginConfig.P2P_turnCredential);
-    pluginConfig.P2P_turnUsername = redact(pluginConfig.P2P_turnUsername);
-    pluginConfig.P2P_turnServers = `(${pluginConfig.P2P_turnServers.split(",").length} servers configured)`;
-    const endpoint = pluginConfig.endpoint;
-    if (endpoint == "") {
-        pluginConfig.endpoint = "Not configured or AWS";
-    } else {
-        const endpointScheme = pluginConfig.endpoint.startsWith("http:")
-            ? "(HTTP)"
-            : pluginConfig.endpoint.startsWith("https:")
-              ? "(HTTPS)"
-              : "";
-        pluginConfig.endpoint = `${endpoint.indexOf(".r2.cloudflarestorage.") !== -1 ? "R2" : "self-hosted?"}(${endpointScheme})`;
-    }
-    const obsidianInfo = {
-        navigator: compatGlobal.navigator.userAgent,
-        fileSystem: core.services.vault.isStorageInsensitive() ? "insensitive" : "sensitive",
-    };
-    const result = {
-        obsidianInfo,
-        responseConfig,
-        pluginConfig,
-        manifestVersion,
-        packageVersion,
-    };
-    return result;
-}

src/common/utils.ts

@@ -128,7 +128,7 @@ export const _requestToCouchDBFetch = async (
     username: string,
     password: string,
     path?: string,
-    body?: any,
+    body?: string | any,
     method?: string
 ) => {
     const utf8str = String.fromCharCode.apply(null, [...writeString(`${username}:${password}`)]);
@@ -146,7 +146,7 @@ export const _requestToCouchDBFetch = async (
         contentType: "application/json",
         body: JSON.stringify(body),
     };
-    return await _fetch(uri, requestParam);
+    return await fetch(uri, requestParam);
 };
 
 export const _requestToCouchDB = async (
@@ -214,7 +214,6 @@ import { BASE_IS_NEW, EVEN, TARGET_IS_NEW } from "@lib/common/models/shared.cons
 export { BASE_IS_NEW, EVEN, TARGET_IS_NEW };
 // Why 2000? : ZIP FILE Does not have enough resolution.
 import { compareMTime } from "@lib/common/utils.ts";
-import { _fetch } from "@/lib/src/common/coreEnvFunctions.ts";
 export { compareMTime };
 function getKey(file: AnyEntry | string | UXFileInfoStub) {
     const key = typeof file == "string" ? file : stripAllPrefixes(file.path);

src/features/ConfigSync/CmdConfigSync.ts

@@ -68,10 +68,9 @@ import { ConflictResolveModal } from "../../modules/features/InteractiveConflict
 import { Semaphore } from "octagonal-wheels/concurrency/semaphore";
 import { EVENT_REQUEST_OPEN_PLUGIN_SYNC_DIALOG, eventHub } from "../../common/events.ts";
 import { PluginDialogModal } from "./PluginDialogModal.ts";
-import { $msg } from "@/lib/src/common/i18n.ts";
+import { $msg } from "src/lib/src/common/i18n.ts";
 import type { InjectableServiceHub } from "../../lib/src/services/InjectableServices.ts";
 import type { LiveSyncCore } from "../../main.ts";
-import { LiveSyncError } from "@lib/common/LSError.ts";
 
 const d = "\u200b";
 const d2 = "\n";
@@ -565,7 +564,7 @@ export class ConfigSync extends LiveSyncCommands {
                 ...data,
                 documentPath: this.getPath(wx),
                 files: xFiles,
-            } satisfies PluginDataExDisplay;
+            } as PluginDataExDisplay;
         }
         return false;
     }
@@ -1070,10 +1069,10 @@ export class ConfigSync extends LiveSyncCommands {
         }
         const baseDir = this.configDir;
         try {
-            if (!data.documentPath) throw new LiveSyncError("InternalError: Document path not exist");
+            if (!data.documentPath) throw "InternalError: Document path not exist";
             const dx = await this.localDatabase.getDBEntry(data.documentPath);
             if (dx == false) {
-                throw new LiveSyncError("Not found on database");
+                throw "Not found on database";
             }
             const loadedData = deserialize(getDocDataAsArray(dx.data), {}) as PluginDataEx;
             for (const f of loadedData.files) {
@@ -1318,7 +1317,7 @@ export class ConfigSync extends LiveSyncCommands {
                     }
                     const docXDoc = await this.localDatabase.getDBEntryFromMeta(old, false, false);
                     if (docXDoc == false) {
-                        throw new LiveSyncError("Could not load the document");
+                        throw "Could not load the document";
                     }
                     const dataSrc = getDocData(docXDoc.data);
                     const dataStart = dataSrc.indexOf(DUMMY_END);

src/features/HiddenFileSync/CmdHiddenFileSync.ts

@@ -50,7 +50,6 @@ import { hiddenFilesEventCount, hiddenFilesProcessingCount } from "../../lib/src
 import { EVENT_SETTING_SAVED, eventHub } from "../../common/events.ts";
 import { Semaphore } from "octagonal-wheels/concurrency/semaphore";
 import type { LiveSyncCore } from "../../main.ts";
-import { tryGetFilePath } from "@lib/common/utils.doc.ts";
 type SyncDirection = "push" | "pull" | "safe" | "pullForce" | "pushForce";
 
 declare global {
@@ -318,7 +317,7 @@ export class HiddenFileSync extends LiveSyncCommands {
         this._fileInfoLastProcessed.set(file, key);
     }
 
-    async updateLastProcessedAsActualFile(file: FilePath, stat?: UXStat | null) {
+    async updateLastProcessedAsActualFile(file: FilePath, stat?: UXStat | null | undefined) {
         if (!stat) stat = await this.core.storageAccess.statHidden(file);
         this._fileInfoLastProcessed.set(file, this.statToKey(stat));
     }
@@ -412,7 +411,10 @@ export class HiddenFileSync extends LiveSyncCommands {
         }
     }
 
-    async updateLastProcessedAsActualDatabase(file: FilePath, doc?: MetaEntry | LoadedEntry | null | false) {
+    async updateLastProcessedAsActualDatabase(
+        file: FilePath,
+        doc?: MetaEntry | LoadedEntry | null | undefined | false
+    ) {
         const dbPath = addPrefix(file, ICHeader);
         if (!doc) doc = await this.localDatabase.getDBEntryMeta(dbPath);
         if (!doc) return;
@@ -1048,7 +1050,7 @@ Offline Changed files: ${processFiles.length}`;
                 }
                 notifyProgress();
             } catch (ex) {
-                this._log(`Failed to process storage change file:${tryGetFilePath(file)}`, logLevel);
+                this._log(`Failed to process storage change file:${file}`, logLevel);
                 this._log(ex, LOG_LEVEL_VERBOSE);
             }
         });
@@ -1160,7 +1162,7 @@ Offline Changed files: ${files.length}`;
                 await this.trackDatabaseFileModification(path, "[Scanning]", true, onlyNew, file);
                 notifyProgress();
             } catch (ex) {
-                this._log(`Failed to process database changes:${tryGetFilePath(file)}`);
+                this._log(`Failed to process database changes:${file}`);
                 this._log(ex, LOG_LEVEL_VERBOSE);
             }
             return;
@@ -1498,7 +1500,7 @@ Offline Changed files: ${files.length}`;
     }
 
     async storeInternalFileToDatabase(file: InternalFileInfo | UXFileInfo, forceWrite = false) {
-        const storeFilePath = stripAllPrefixes(file.path);
+        const storeFilePath = stripAllPrefixes(file.path as FilePath);
         const storageFilePath = file.path;
         if (await this.services.vault.isIgnoredByIgnoreFile(storageFilePath)) {
             return undefined;

src/features/LocalDatabaseMainte/CmdLocalDatabaseMainte.ts

@@ -16,8 +16,9 @@ import { serialized } from "octagonal-wheels/concurrency/lock_v2";
 import { arrayToChunkedArray } from "octagonal-wheels/collection";
 import { EVENT_ANALYSE_DB_USAGE, EVENT_REQUEST_PERFORM_GC_V3, eventHub } from "@/common/events";
 import type { LiveSyncCouchDBReplicator } from "@/lib/src/replication/couchdb/LiveSyncReplicator";
-import { delay } from "@/lib/src/common/utils";
-// import { _requestToCouchDB } from "@/common/utils";
+import { delay, parseHeaderValues } from "@/lib/src/common/utils";
+import { generateCredentialObject } from "@/lib/src/replication/httplib";
+import { _requestToCouchDB } from "@/common/utils";
 const DB_KEY_SEQ = "gc-seq";
 const DB_KEY_CHUNK_SET = "chunk-set";
 const DB_KEY_DOC_USAGE_MAP = "doc-usage-map";
@@ -390,7 +391,7 @@ Note: **Make sure to synchronise all devices before deletion.**
                             .map((revInfo) => db.get(doc._id, { rev: revInfo.rev }))
                     ).then((docs) => docs.filter((doc) => doc));
                     for (const oldDoc of oldDocs) {
-                        await processDoc(oldDoc, false);
+                        await processDoc(oldDoc as EntryDoc, false);
                     }
                 }
             } catch (ex) {
@@ -532,7 +533,7 @@ Success: ${successCount}, Errored: ${errored}`;
         const docMap = new Map<DocumentID, Set<DocumentInfo>>();
         const info = await db.info();
         // Total number of revisions to process (approximate)
-        const maxSeq = Number.parseInt(`${info.update_seq ?? 0}`, 10);
+        const maxSeq = new Number(info.update_seq);
         let processed = 0;
         let read = 0;
         let errored = 0;
@@ -559,7 +560,7 @@ Success: ${successCount}, Errored: ${errored}`;
                         });
                         docMap.set(id, set);
                     } else if (doc.type === EntryTypes.CHUNK) {
-                        const id = doc._id;
+                        const id = doc._id as DocumentID;
                         if (chunkMap.has(id)) {
                             return;
                         }
@@ -758,68 +759,68 @@ Success: ${successCount}, Errored: ${errored}`;
         }
     }
 
-    // /**
-    //  * Compact the database by temporarily setting the revision limit to 1.
-    //  * @returns
-    //  */
-    // async compactDatabaseWithRevLimit() {
-    //     // Temporarily set revs_limit to 1, perform compaction, and restore the original revs_limit.
-    //     // Very dangerous operation, so now suppressed.
-    //     return Promise.resolve(false);
-    //     const replicator = this.core.replicator as LiveSyncCouchDBReplicator;
-    //     const remote = await replicator.connectRemoteCouchDBWithSetting(this.settings, false, false, true);
-    //     if (!remote) {
-    //         this._notice("Failed to connect to remote for compaction.");
-    //         return;
-    //     }
-    //     if (typeof remote == "string") {
-    //         this._notice(`Failed to connect to remote for compaction. ${remote}`);
-    //         return;
-    //     }
-    //     const customHeaders = parseHeaderValues(this.settings.couchDB_CustomHeaders);
-    //     const credential = generateCredentialObject(this.settings);
-    //     const request = async (path: string, method: string = "GET", body: any = undefined) => {
-    //         const req = await _requestToCouchDB(
-    //             this.settings.couchDB_URI.replace(/\/+$/, "") +
-    //             (this.settings.couchDB_DBNAME ? `/${this.settings.couchDB_DBNAME}` : ""),
-    //             credential,
-    //             window.origin,
-    //             path,
-    //             body,
-    //             method,
-    //             customHeaders
-    //         );
-    //         return req;
-    //     };
-    //     let revsLimit = "";
-    //     const req = await request(`_revs_limit`, "GET");
-    //     if (req.status == 200) {
-    //         revsLimit = req.text.trim();
-    //         this._info(`Remote database _revs_limit: ${revsLimit}`);
-    //     } else {
-    //         this._notice(`Failed to get remote database _revs_limit. Status: ${req.status}`);
-    //         return;
-    //     }
-    //     const req2 = await request(`_revs_limit`, "PUT", 1);
-    //     if (req2.status == 200) {
-    //         this._info(`Set remote database _revs_limit to 1 for compaction.`);
-    //     }
-    //     try {
-    //         await this.compactDatabase();
-    //     } finally {
-    //         // Restore revs_limit
-    //         if (revsLimit) {
-    //             const req3 = await request(`_revs_limit`, "PUT", parseInt(revsLimit));
-    //             if (req3.status == 200) {
-    //                 this._info(`Restored remote database _revs_limit to ${revsLimit}.`);
-    //             } else {
-    //                 this._notice(
-    //                     `Failed to restore remote database _revs_limit. Status: ${req3.status} / ${req3.text}`
-    //                 );
-    //             }
-    //         }
-    //     }
-    // }
+    /**
+     * Compact the database by temporarily setting the revision limit to 1.
+     * @returns
+     */
+    async compactDatabaseWithRevLimit() {
+        // Temporarily set revs_limit to 1, perform compaction, and restore the original revs_limit.
+        // Very dangerous operation, so now suppressed.
+        return false;
+        const replicator = this.core.replicator as LiveSyncCouchDBReplicator;
+        const remote = await replicator.connectRemoteCouchDBWithSetting(this.settings, false, false, true);
+        if (!remote) {
+            this._notice("Failed to connect to remote for compaction.");
+            return;
+        }
+        if (typeof remote == "string") {
+            this._notice(`Failed to connect to remote for compaction. ${remote}`);
+            return;
+        }
+        const customHeaders = parseHeaderValues(this.settings.couchDB_CustomHeaders);
+        const credential = generateCredentialObject(this.settings);
+        const request = async (path: string, method: string = "GET", body: any = undefined) => {
+            const req = await _requestToCouchDB(
+                this.settings.couchDB_URI.replace(/\/+$/, "") +
+                    (this.settings.couchDB_DBNAME ? `/${this.settings.couchDB_DBNAME}` : ""),
+                credential,
+                window.origin,
+                path,
+                body,
+                method,
+                customHeaders
+            );
+            return req;
+        };
+        let revsLimit = "";
+        const req = await request(`_revs_limit`, "GET");
+        if (req.status == 200) {
+            revsLimit = req.text.trim();
+            this._info(`Remote database _revs_limit: ${revsLimit}`);
+        } else {
+            this._notice(`Failed to get remote database _revs_limit. Status: ${req.status}`);
+            return;
+        }
+        const req2 = await request(`_revs_limit`, "PUT", 1);
+        if (req2.status == 200) {
+            this._info(`Set remote database _revs_limit to 1 for compaction.`);
+        }
+        try {
+            await this.compactDatabase();
+        } finally {
+            // Restore revs_limit
+            if (revsLimit) {
+                const req3 = await request(`_revs_limit`, "PUT", parseInt(revsLimit));
+                if (req3.status == 200) {
+                    this._info(`Restored remote database _revs_limit to ${revsLimit}.`);
+                } else {
+                    this._notice(
+                        `Failed to restore remote database _revs_limit. Status: ${req3.status} / ${req3.text}`
+                    );
+                }
+            }
+        }
+    }
     async gcv3() {
         if (!this.isAvailable()) return;
         const replicator = this.core.replicator as LiveSyncCouchDBReplicator;
@@ -928,7 +929,7 @@ This may indicate that some devices have not completed synchronisation, which co
                     usedChunks.add(chunkId);
                 }
             } else if (doc.type === EntryTypes.CHUNK) {
-                allChunks.set(doc._id, doc._rev);
+                allChunks.set(doc._id as DocumentID, doc._rev);
             }
         }
         this._notice(

src/features/P2PSync/P2PReplicator/P2POpenReplicationModal.ts

@@ -1,80 +0,0 @@
-import { App, Modal } from "@/deps.ts";
-import P2POpenReplicationPane from "./P2POpenReplicationPane.svelte";
-import { mount, unmount } from "svelte";
-import type { LiveSyncTrysteroReplicator } from "@/lib/src/replication/trystero/LiveSyncTrysteroReplicator";
-
-export type P2POpenReplicationModalCallback = {
-    onSync: (peerId: string) => Promise<void>;
-    onSyncAndClose: (peerId: string) => Promise<void>;
-};
-
-export class P2POpenReplicationModal extends Modal {
-    liveSyncReplicator: LiveSyncTrysteroReplicator;
-    callback?: P2POpenReplicationModalCallback;
-    component?: ReturnType<typeof mount>;
-    showResult: boolean;
-    title: string;
-    onClosed?: () => void;
-    rebuildMode: boolean;
-
-    constructor(
-        app: App,
-        liveSyncReplicator: LiveSyncTrysteroReplicator,
-        callback?: P2POpenReplicationModalCallback,
-        showResult: boolean = false,
-        title: string = "P2P Replication",
-        onClosed?: () => void,
-        rebuildMode: boolean = false
-    ) {
-        super(app);
-        this.liveSyncReplicator = liveSyncReplicator;
-        this.callback = callback;
-        this.showResult = showResult;
-        this.title = title;
-        this.onClosed = onClosed;
-        this.rebuildMode = rebuildMode;
-    }
-
-    async onSync(peerId: string) {
-        if (this.callback?.onSync) {
-            await this.callback.onSync(peerId);
-        }
-    }
-
-    async onSyncAndClose(peerId: string) {
-        if (this.callback?.onSyncAndClose) {
-            await this.callback.onSyncAndClose(peerId);
-        }
-        this.close();
-    }
-
-    override onOpen() {
-        const { contentEl } = this;
-        this.titleEl.setText(this.title);
-        contentEl.empty();
-
-        if (this.component === undefined) {
-            this.component = mount(P2POpenReplicationPane, {
-                target: contentEl,
-                props: {
-                    liveSyncReplicator: this.liveSyncReplicator,
-                    onSync: (peerId: string) => this.onSync(peerId),
-                    onSyncAndClose: (peerId: string) => this.onSyncAndClose(peerId),
-                    onClose: () => this.close(),
-                    showResult: this.showResult,
-                    rebuildMode: this.rebuildMode,
-                },
-            });
-        }
-    }
-
-    override onClose() {
-        const { contentEl } = this;
-        contentEl.empty();
-        if (this.component !== undefined) {
-            void unmount(this.component);
-            this.component = undefined;
-        }
-        this.onClosed?.();
-    }
-}

src/features/P2PSync/P2PReplicator/P2POpenReplicationPane.svelte

@@ -1,313 +0,0 @@
-<script lang="ts">
-    import { onMount } from "svelte";
-    import { eventHub } from "@/common/events";
-    import {
-        EVENT_SERVER_STATUS,
-        EVENT_REQUEST_STATUS,
-        type P2PServerInfo,
-    } from "@lib/replication/trystero/TrysteroReplicatorP2PServer";
-    // import type { TrysteroReplicator } from "@lib/replication/trystero/TrysteroReplicator";
-    import { LOG_LEVEL_NOTICE, LOG_LEVEL_INFO } from "@lib/common/types";
-    import { Logger } from "@lib/common/logger";
-    import type { LiveSyncTrysteroReplicator } from "@/lib/src/replication/trystero/LiveSyncTrysteroReplicator";
-    import { delay, fireAndForget } from "octagonal-wheels/promises";
-    import P2PServerStatusCard from "./P2PServerStatusCard.svelte";
-
-    interface Props {
-        liveSyncReplicator: LiveSyncTrysteroReplicator;
-        onSync: (_peerId: string) => Promise<void>;
-        onSyncAndClose: (_peerId: string) => Promise<void>;
-        onClose: () => void;
-        showResult: boolean;
-        rebuildMode?: boolean;
-    }
-
-    let { onSync, onSyncAndClose, onClose, showResult, liveSyncReplicator, rebuildMode = false }: Props = $props();
-
-    let serverInfo = $state<P2PServerInfo | undefined>(undefined);
-    let syncingPeerId = $state<string | null>(null);
-
-    const logLevel = showResult ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO;
-    async function requestServerStatus() {
-        await liveSyncReplicator.requestStatus();
-        eventHub.emitEvent(EVENT_REQUEST_STATUS);
-    }
-    onMount(() => {
-        // ServerStatus
-        const unsubscribe = eventHub.onEvent(EVENT_SERVER_STATUS, (status) => {
-            serverInfo = status;
-        });
-        fireAndForget(async () => {
-            await delay(100);
-            await requestServerStatus();
-        });
-        return unsubscribe;
-    });
-
-    async function handleSync(peerId: string) {
-        try {
-            syncingPeerId = peerId;
-            Logger(`Starting sync with ${peerId}`, logLevel);
-            await onSync(peerId);
-            Logger(`Sync completed with ${peerId}`, logLevel);
-        } catch (e) {
-            Logger(`Error during sync: ${e instanceof Error ? e.message : String(e)}`, logLevel);
-        } finally {
-            syncingPeerId = null;
-        }
-    }
-    async function handleSyncThenClose(peerId: string) {
-        try {
-            syncingPeerId = peerId;
-            Logger(`Starting sync with ${peerId}`, logLevel);
-            await onSyncAndClose(peerId);
-            Logger(`Sync completed with ${peerId}`, logLevel);
-        } catch (e) {
-            Logger(`Error during sync: ${e instanceof Error ? e.message : String(e)}`, logLevel);
-        } finally {
-            syncingPeerId = null;
-        }
-    }
-
-    async function handleSyncAndClose(peerId: string) {
-        fireAndForget(async () => {
-            try {
-                Logger(`Starting sync with ${peerId}`, logLevel);
-                await onSync(peerId);
-                Logger(`Sync completed with ${peerId}`, logLevel);
-            } catch (e) {
-                Logger(`Error during sync: ${e instanceof Error ? e.message : String(e)}`, logLevel);
-            }
-        });
-        onClose();
-    }
-    async function disconnect() {
-        try {
-            await liveSyncReplicator.close();
-            Logger("Signalling connection closed.", logLevel);
-        } catch (e) {
-            Logger(`Failed to close signalling connection: ${e instanceof Error ? e.message : String(e)}`, logLevel);
-        }
-    }
-    async function onCloseAndDisconnect() {
-        await disconnect();
-        onClose();
-    }
-
-    function getAcceptanceStatus(peer: P2PServerInfo["knownAdvertisements"][number]) {
-        if (peer.isTemporaryAccepted === true) return "ACCEPTED (in session)";
-        if (peer.isAccepted === true) return "ACCEPTED";
-        if (peer.isTemporaryAccepted === false) return "DENIED (in session)";
-        if (peer.isAccepted === false) return "DENIED";
-        return "NEW";
-    }
-
-    function getAcceptanceStatusClass(peer: P2PServerInfo["knownAdvertisements"][number]) {
-        if (peer.isTemporaryAccepted === true || peer.isAccepted === true) return "accepted";
-        if (peer.isTemporaryAccepted === false || peer.isAccepted === false) return "denied";
-        return "unknown";
-    }
-</script>
-
-<div class="p2p-container">
-    <P2PServerStatusCard {liveSyncReplicator} showBroadcastToggle={false} />
-
-    <div class="peers-section">
-        <h3>Available Peers</h3>
-        {#if serverInfo && serverInfo.knownAdvertisements.length > 0}
-            <div class="peers-list">
-                {#each serverInfo.knownAdvertisements as peer (peer.peerId)}
-                    <div class="peer-item">
-                        <div class="peer-info">
-                            <div class="peer-name">{peer.name}</div>
-                            <div class="peer-meta">
-                                <span class="badge">{peer.platform}</span>
-                                <span class="peer-id-mini" title={peer.peerId}>
-                                    {peer.peerId.slice(0, 8)}
-                                </span>
-                                <span class="badge status-chip {getAcceptanceStatusClass(peer)}">
-                                    {getAcceptanceStatus(peer)}
-                                </span>
-                            </div>
-                        </div>
-                        <div class="peer-actions">
-                            {#if !rebuildMode}
-                                <button
-                                    class="btn btn-primary"
-                                    disabled={syncingPeerId !== null}
-                                    onclick={() => handleSync(peer.peerId)}
-                                >
-                                    {syncingPeerId === peer.peerId ? "Syncing..." : "Sync"}
-                                </button>
-                                <button
-                                    class="btn {rebuildMode ? 'btn-primary' : 'btn-secondary'}"
-                                    disabled={syncingPeerId !== null}
-                                    onclick={() => handleSyncAndClose(peer.peerId)}
-                                >
-                                    {syncingPeerId === peer.peerId ? "Syncing..." : "Start Sync & Close"}
-                                </button>
-                            {:else}
-                                <button
-                                    class="btn {rebuildMode ? 'btn-primary' : 'btn-secondary'}"
-                                    disabled={syncingPeerId !== null}
-                                    onclick={() => handleSyncThenClose(peer.peerId)}
-                                >
-                                    {syncingPeerId === peer.peerId ? "Syncing..." : "Sync"}
-                                </button>
-                            {/if}
-                        </div>
-                    </div>
-                {/each}
-            </div>
-        {:else if serverInfo}
-            <p class="no-peers">No devices available. Waiting for other devices to connect...</p>
-        {/if}
-    </div>
-
-    <div class="footer">
-        {#if rebuildMode}
-            <button class="btn btn-cancel" onclick={onClose} disabled={syncingPeerId !== null}>Skip and close</button>
-        {:else}
-            <button class="btn btn-cancel" onclick={onClose}>Close</button>
-            <button class="btn btn-cancel" onclick={onCloseAndDisconnect}>Close & Disconnect</button>
-        {/if}
-    </div>
-</div>
-
-<style>
-    .p2p-container {
-        display: flex;
-        flex-direction: column;
-        gap: 1rem;
-        padding: 1rem;
-        max-height: 70vh;
-        overflow-y: auto;
-    }
-
-    .peers-section {
-        border: 1px solid var(--divider-color);
-        border-radius: 0.5rem;
-        padding: 1rem;
-    }
-
-    h3 {
-        margin: 0 0 0.75rem 0;
-        font-weight: 600;
-        font-size: 1rem;
-    }
-
-    .peers-list {
-        display: flex;
-        flex-direction: column;
-        gap: 0.5rem;
-    }
-
-    .peer-item {
-        display: flex;
-        justify-content: space-between;
-        flex-wrap: wrap;
-        align-items: center;
-        padding: 0.75rem;
-        background-color: var(--background-secondary);
-        border: 1px solid var(--divider-color);
-        border-radius: 0.4rem;
-    }
-
-    .peer-info {
-        flex: 1;
-    }
-
-    .peer-name {
-        font-weight: 600;
-        margin-bottom: 0.25rem;
-    }
-
-    .peer-meta {
-        display: flex;
-        gap: 0.5rem;
-        font-size: 0.8rem;
-    }
-
-    .badge {
-        background-color: var(--background-tertiary);
-        padding: 0.1rem 0.4rem;
-        border-radius: 0.25rem;
-    }
-
-    .status-chip {
-        font-weight: 600;
-    }
-
-    .status-chip.accepted {
-        background-color: var(--background-modifier-success);
-        color: var(--text-normal);
-    }
-
-    .status-chip.denied {
-        background-color: var(--background-modifier-error);
-        color: var(--text-normal);
-    }
-
-    .status-chip.unknown {
-        background-color: var(--background-modifier-border);
-        color: var(--text-muted);
-    }
-
-    .peer-id-mini {
-        font-family: monospace;
-        color: var(--text-muted);
-    }
-
-    .peer-actions {
-        flex-wrap: wrap;
-        display: flex;
-        gap: 0.5rem;
-    }
-
-    .btn {
-        padding: 0.4rem 0.8rem;
-        border: 1px solid var(--divider-color);
-        border-radius: 0.3rem;
-        background-color: var(--interactive-normal);
-        color: var(--text-normal);
-        cursor: pointer;
-        font-size: 0.8rem;
-        font-weight: 500;
-        transition: background-color 0.2s;
-    }
-
-    .btn:hover:not(:disabled) {
-        background-color: var(--interactive-hover);
-    }
-
-    .btn:disabled {
-        opacity: 0.6;
-        cursor: not-allowed;
-    }
-
-    .btn-primary {
-        background-color: var(--interactive-accent);
-        color: var(--text-on-accent);
-    }
-
-    .btn-secondary {
-        background-color: var(--background-tertiary);
-    }
-
-    .btn-cancel {
-        width: 100%;
-        margin-top: 0.5rem;
-    }
-
-    .no-peers {
-        text-align: center;
-        color: var(--text-muted);
-        font-size: 0.9rem;
-        padding: 1rem;
-    }
-
-    .footer {
-        border-top: 1px solid var(--divider-color);
-        padding-top: 0.75rem;
-    }
-</style>

src/features/P2PSync/P2PReplicator/P2PReplicationUI.ts

@@ -1,131 +0,0 @@
-import { App } from "@/deps.ts";
-import { Logger } from "@lib/common/logger";
-import { LOG_LEVEL_NOTICE, LOG_LEVEL_INFO } from "@lib/common/types";
-import type { LiveSyncTrysteroReplicator } from "@lib/replication/trystero/LiveSyncTrysteroReplicator";
-import { P2POpenReplicationModal } from "./P2POpenReplicationModal";
-
-/**
- * Creates an openReplicationUI factory for Obsidian environments.
- * Returns a per-replicator closure that opens the P2P Replication modal
- * and performs bidirectional sync (pull then push on success).
- *
- * Usage:
- *   const factory = createOpenReplicationUI(app);
- *   useP2PReplicatorFeature(core, factory);
- */
-export function createOpenReplicationUI(
-    app: App
-): (replicator: LiveSyncTrysteroReplicator) => (showResult: boolean) => Promise<boolean | void> {
-    return (replicator: LiveSyncTrysteroReplicator) =>
-        (showResult: boolean): Promise<boolean | void> => {
-            const logLevel = showResult ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO;
-            return new Promise<boolean | void>((resolve) => {
-                const modal = new P2POpenReplicationModal(
-                    app,
-                    replicator,
-                    {
-                        onSync: async (peerId: string) => {
-                            try {
-                                // pull (replicateFrom) first; push only on success
-                                const pullResult = await replicator.replicateFrom(peerId, showResult);
-                                if (pullResult?.ok) {
-                                    const pushResult = await replicator.requestSynchroniseToPeer(peerId);
-                                    resolve(pushResult?.ok ?? true);
-                                } else {
-                                    resolve(false);
-                                }
-                            } catch (e) {
-                                Logger(
-                                    `Error in bidirectional sync with ${peerId}: ${e instanceof Error ? e.message : String(e)}`,
-                                    logLevel
-                                );
-                                resolve(false);
-                            }
-                        },
-                        onSyncAndClose: async (peerId: string) => {
-                            try {
-                                const pullResult = await replicator.replicateFrom(peerId, showResult);
-                                if (pullResult?.ok) {
-                                    const pushResult = await replicator.requestSynchroniseToPeer(peerId);
-                                    if (pushResult?.ok ?? true) {
-                                        await replicator.close();
-                                        resolve(true);
-                                    } else {
-                                        resolve(false);
-                                    }
-                                } else {
-                                    resolve(false);
-                                }
-                            } catch (e) {
-                                Logger(
-                                    `Error in bidirectional sync with ${peerId}: ${e instanceof Error ? e.message : String(e)}`,
-                                    logLevel
-                                );
-                                resolve(false);
-                            }
-                        },
-                    },
-                    showResult
-                );
-                modal.open();
-            });
-        };
-}
-
-/**
- * Creates an openRebuildUI factory for Obsidian environments.
- * Opens the P2P Replication modal in "rebuild" mode — one-way pull only,
- * with setOnSetup / clearOnSetup bracketing the replicateFrom call.
- *
- * Usage:
- *   const factory = createOpenRebuildUI(app);
- *   useP2PReplicatorFeature(core, createOpenReplicationUI(app), factory);
- */
-export function createOpenRebuildUI(
-    app: App
-): (replicator: LiveSyncTrysteroReplicator) => (showResult: boolean) => Promise<boolean | void> {
-    return (replicator: LiveSyncTrysteroReplicator) =>
-        (showResult: boolean): Promise<boolean | void> => {
-            const logLevel = showResult ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO;
-            return new Promise<boolean | void>((resolve) => {
-                let resolved = false;
-                const safeResolve = (val: boolean) => {
-                    if (!resolved) {
-                        resolved = true;
-                        resolve(val);
-                    }
-                };
-
-                const doRebuild = async (peerId: string) => {
-                    replicator.setOnSetup();
-                    try {
-                        Logger(`Rebuilding from peer ${peerId}`, logLevel);
-                        const result = await replicator.replicateFrom(peerId, showResult);
-                        safeResolve(result?.ok ?? false);
-                    } catch (e) {
-                        Logger(
-                            `Error in rebuild from ${peerId}: ${e instanceof Error ? e.message : String(e)}`,
-                            logLevel
-                        );
-                        safeResolve(false);
-                    } finally {
-                        replicator.clearOnSetup();
-                    }
-                };
-
-                const modal = new P2POpenReplicationModal(
-                    app,
-                    replicator,
-                    {
-                        onSync: doRebuild,
-                        onSyncAndClose: doRebuild,
-                    },
-                    showResult,
-                    "P2P Rebuild",
-                    () => safeResolve(false),
-                    true
-                );
-                modal.open();
-            });
-        };
-}

src/features/P2PSync/P2PReplicator/P2PReplicatorPane.svelte

@@ -5,21 +5,20 @@
         AcceptedStatus,
         ConnectionStatus,
         type PeerStatus,
-    } from "@lib/replication/trystero/P2PReplicatorPaneCommon";
-    import type { LiveSyncTrysteroReplicator } from "@lib/replication/trystero/LiveSyncTrysteroReplicator";
+    } from "../../../lib/src/replication/trystero/P2PReplicatorPaneCommon";
+    import type { LiveSyncTrysteroReplicator } from "../../../lib/src/replication/trystero/LiveSyncTrysteroReplicator";
     import PeerStatusRow from "../P2PReplicator/PeerStatusRow.svelte";
-    import { EVENT_LAYOUT_READY, eventHub } from "@/common/events";
+    import { EVENT_LAYOUT_READY, eventHub } from "../../../common/events";
     import {
         type PeerInfo,
         type P2PServerInfo,
         EVENT_SERVER_STATUS,
         EVENT_REQUEST_STATUS,
         EVENT_P2P_REPLICATOR_STATUS,
-    } from "@lib/replication/trystero/TrysteroReplicatorP2PServer";
-    import { type P2PReplicatorStatus } from "@lib/replication/trystero/TrysteroReplicator";
-    import { $msg as _msg } from "@lib/common/i18n";
-    import { SETTING_KEY_P2P_DEVICE_NAME } from "@lib/common/types";
-    import { generateP2PRoomId } from "@lib/common/utils";
+    } from "../../../lib/src/replication/trystero/TrysteroReplicatorP2PServer";
+    import { type P2PReplicatorStatus } from "../../../lib/src/replication/trystero/TrysteroReplicator";
+    import { $msg as _msg } from "../../../lib/src/common/i18n";
+    import { SETTING_KEY_P2P_DEVICE_NAME } from "../../../lib/src/common/types";
     import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore";
 
     interface Props {
@@ -149,7 +148,6 @@
         eventHub.emitEvent(EVENT_REQUEST_STATUS);
         return () => {
             r();
-            rx();
             r2();
             r3();
         };
@@ -218,8 +216,18 @@
     function useDefaultRelay() {
         eRelay = DEFAULT_SETTINGS.P2P_relays;
     }
+    function _generateRandom() {
+        return (Math.floor(Math.random() * 1000) + 1000).toString().substring(1);
+    }
+    function generateRandom(length: number) {
+        let buf = "";
+        while (buf.length < length) {
+            buf += "-" + _generateRandom();
+        }
+        return buf.substring(1, length);
+    }
     function chooseRandom() {
-        eRoomId = generateP2PRoomId();
+        eRoomId = generateRandom(12) + "-" + Math.random().toString(36).substring(2, 5);
     }
 
     async function openServer() {
@@ -243,7 +251,7 @@
                 setting?: boolean;
             };
             return initialDialogStatus;
-        } catch {
+        } catch (e) {
             return {};
         }
     };

src/features/P2PSync/P2PReplicator/P2PServerStatusCard.svelte

@@ -1,310 +0,0 @@
-<script lang="ts">
-    import { onMount } from "svelte";
-    import { eventHub } from "@/common/events";
-    import { delay, fireAndForget } from "octagonal-wheels/promises";
-    import type { P2PServerInfo } from "@lib/replication/trystero/TrysteroReplicatorP2PServer";
-    import {
-        EVENT_SERVER_STATUS,
-        EVENT_REQUEST_STATUS,
-        EVENT_P2P_REPLICATOR_STATUS,
-    } from "@lib/replication/trystero/TrysteroReplicatorP2PServer";
-    import { EVENT_SETTING_SAVED } from "@lib/events/coreEvents";
-    import type { LiveSyncTrysteroReplicator } from "@/lib/src/replication/trystero/LiveSyncTrysteroReplicator";
-    import type { P2PReplicatorStatus } from "@/lib/src/replication/trystero/TrysteroReplicator";
-    import { extractP2PRoomSuffix } from "@/lib/src/common/utils";
-    import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore";
-
-    interface Props {
-        liveSyncReplicator: LiveSyncTrysteroReplicator;
-        showBroadcastToggle?: boolean;
-        core?: LiveSyncBaseCore;
-    }
-
-    let { liveSyncReplicator, showBroadcastToggle = true, core }: Props = $props();
-    let serverInfo = $state<P2PServerInfo | undefined>(undefined);
-    let replicatorStatus = $state<P2PReplicatorStatus | undefined>(undefined);
-    let roomSuffix = $state<string>(extractP2PRoomSuffix(core?.services.setting.currentSettings()?.P2P_roomID ?? ""));
-    let useDiagRTC = $state<boolean>(core?.services.setting.currentSettings()?.P2P_useDiagRTC ?? false);
-
-    async function requestServerStatus() {
-        await Promise.resolve(liveSyncReplicator.requestStatus());
-        eventHub.emitEvent(EVENT_REQUEST_STATUS);
-    }
-
-    async function onOpenConnection() {
-        await liveSyncReplicator.makeSureOpened();
-        await requestServerStatus();
-    }
-
-    async function onDisconnect() {
-        await liveSyncReplicator.close();
-        await requestServerStatus();
-    }
-
-    function toggleBroadcast() {
-        if (replicatorStatus?.isBroadcasting) {
-            liveSyncReplicator.disableBroadcastChanges();
-        } else {
-            liveSyncReplicator.enableBroadcastChanges();
-        }
-    }
-
-    async function toggleDiagRTC() {
-        if (!core) {
-            return;
-        }
-        const next = !useDiagRTC;
-        await core.services.setting.updateSettings((settings) => {
-            settings.P2P_useDiagRTC = next;
-            return settings;
-        }, true);
-        useDiagRTC = next;
-    }
-
-    onMount(() => {
-        const unsubscribe = eventHub.onEvent(EVENT_SERVER_STATUS, (status) => {
-            serverInfo = status;
-            roomSuffix = extractP2PRoomSuffix(status?.roomId ?? "");
-        });
-        const unsubscribeStatus = eventHub.onEvent(EVENT_P2P_REPLICATOR_STATUS, (status) => {
-            replicatorStatus = status;
-        });
-        const unsubscribeSettings = eventHub.onEvent(EVENT_SETTING_SAVED, (settings) => {
-            roomSuffix = extractP2PRoomSuffix(settings?.P2P_roomID ?? "");
-            useDiagRTC = settings?.P2P_useDiagRTC ?? false;
-        });
-
-        fireAndForget(async () => {
-            await delay(100);
-            await requestServerStatus();
-        });
-
-        return () => {
-            unsubscribe();
-            unsubscribeStatus();
-            unsubscribeSettings();
-        };
-    });
-
-    const isConnected = $derived.by(() => serverInfo?.isConnected);
-    const isBroadcasting = $derived.by(() => replicatorStatus?.isBroadcasting ?? false);
-</script>
-
-<div class="server-status">
-    <h3>Signalling Status</h3>
-
-    <div class="status-item">
-        <span>Connection:</span>
-        <span class="status-value {isConnected ? 'connected' : 'disconnected'}">
-            {isConnected ? "🟢 Connected" : "🔴 Disconnected"}
-        </span>
-    </div>
-
-    <div class="status-item status-action">
-        {#if !isConnected}
-            <button onclick={onOpenConnection}>Open connection</button>
-        {:else}
-            <button onclick={onDisconnect}>Close connection</button>
-        {/if}
-    </div>
-
-    {#if serverInfo}
-        <div class="status-item">
-            <span>Room ID suffix:</span>
-            <span class="room-suffix-display" title={roomSuffix || "Not configured"}>
-                {roomSuffix || "-"}
-            </span>
-        </div>
-
-        <div class="status-item">
-            <span>Peer ID:</span>
-            <span class="peer-id-display" title={serverInfo.serverPeerId}>
-                {serverInfo.serverPeerId.slice(0, 12)}...
-            </span>
-        </div>
-
-        <div class="status-item">
-            <span>Devices:</span>
-            <span>{serverInfo.knownAdvertisements.length}</span>
-        </div>
-    {/if}
-
-    {#if showBroadcastToggle}
-    <div class="status-item status-action broadcast-row">
-        <!-- Live-push to peers: stream this device's changes to connected peers for LiveSync -->
-        <label class="broadcast-label" for="broadcast-toggle">
-            Live-push to peers
-        </label>
-        <button
-            id="broadcast-toggle"
-            class="broadcast-button {isBroadcasting ? 'is-on' : 'is-off'}"
-            onclick={toggleBroadcast}
-            title={isBroadcasting ? 'Pushing changes to peers — click to stop' : 'Start pushing changes to peers'}
-        >
-            {isBroadcasting ? '📡 On' : '📡 Off'}
-        </button>
-    </div>
-    {/if}
-
-    {#if core}
-    <div class="status-item status-action diag-toggle-row">
-        <label class="broadcast-label" for="diag-toggle">
-            🕵️ Diag
-        </label>
-        <button
-            id="diag-toggle"
-            class="broadcast-button {useDiagRTC ? 'is-on' : 'is-off'}"
-            onclick={toggleDiagRTC}
-            title={useDiagRTC
-                ? 'Diagnostic RTCPeerConnection is enabled'
-                : 'Use Diagnostic RTCPeerConnection for statistics'}
-        >
-            {useDiagRTC ? 'On' : 'Off'}
-        </button>
-    </div>
-    {/if}
-
-    {#if serverInfo}
-        <div class="diag-section">
-            <h4>Stats</h4>
-            <div class="diag-grid">
-                <div class="diag-item">
-                    <span>Incoming:</span>
-                    <span>{serverInfo.diag.totalNewConnections}</span>
-                </div>
-                <div class="diag-item">
-                    <span>Connected:</span>
-                    <span>{serverInfo.diag.totalSuccessfulConnections}</span>
-                </div>
-                <div class="diag-item">
-                    <span>Failed:</span>
-                    <span>{serverInfo.diag.totalFailedConnections}</span>
-                </div>
-                <div class="diag-item">
-                    <span>Closed:</span>
-                    <span>{serverInfo.diag.totalClosedConnections}</span>
-                </div>
-            </div>
-        </div>
-    {/if}
-</div>
-
-<style>
-    .server-status {
-        border: 1px solid var(--divider-color);
-        border-radius: 0.5rem;
-        padding: 1rem;
-    }
-
-    h3 {
-        margin: 0 0 0.75rem 0;
-        font-weight: 600;
-        font-size: 1rem;
-    }
-
-    .status-item {
-        display: flex;
-        justify-content: space-between;
-        flex-wrap: wrap;
-        font-size: 0.9rem;
-        margin-bottom: 0.5rem;
-    }
-
-    .status-action {
-        align-items: center;
-        gap: 0.5rem;
-    }
-
-    .status-value {
-        font-weight: 500;
-    }
-
-    .status-value.connected {
-        color: var(--text-success);
-    }
-
-    .status-value.disconnected {
-        color: var(--text-error);
-    }
-
-    .peer-id-display {
-        font-family: monospace;
-        font-size: 0.85rem;
-        max-width: 150px;
-        overflow: hidden;
-        text-overflow: ellipsis;
-    }
-
-    .room-suffix-display {
-        font-family: monospace;
-        font-size: 0.85rem;
-        font-weight: 600;
-    }
-
-    .broadcast-row {
-        align-items: center;
-        margin-top: 0.25rem;
-    }
-
-    .diag-toggle-row {
-        align-items: center;
-        margin-top: 0.25rem;
-    }
-
-    .broadcast-label {
-        font-size: 0.9rem;
-        color: var(--text-normal);
-        cursor: pointer;
-    }
-
-    .broadcast-button {
-        font-size: 0.8rem;
-        padding: 0.2rem 0.6rem;
-        border: 1px solid var(--divider-color);
-        border-radius: 0.4rem;
-        cursor: pointer;
-        font-weight: 600;
-        transition: background-color 0.15s;
-    }
-
-    .broadcast-button.is-on {
-        background-color: var(--interactive-accent);
-        color: var(--text-on-accent);
-        border-color: var(--interactive-accent);
-    }
-
-    .broadcast-button.is-off {
-        background-color: var(--interactive-normal);
-        color: var(--text-muted);
-    }
-
-    .broadcast-button.is-off:hover {
-        background-color: var(--interactive-hover);
-        color: var(--text-normal);
-    }
-
-    .diag-section {
-        border-top: 1px solid var(--divider-color);
-        margin-top: 0.75rem;
-        padding-top: 0.75rem;
-    }
-
-    .diag-section h4 {
-        margin: 0 0 0.5rem 0;
-        font-size: 0.9rem;
-        font-weight: 600;
-    }
-
-    .diag-grid {
-        display: grid;
-        grid-template-columns: repeat(auto-fit, minmax(130px, 1fr));
-        gap: 0.35rem 0.75rem;
-    }
-
-    .diag-item {
-        display: flex;
-        justify-content: space-between;
-        font-size: 0.85rem;
-        gap: 0.5rem;
-    }
-</style>

src/features/P2PSync/P2PReplicator/P2PServerStatusPane.svelte

@@ -1,891 +0,0 @@
-<script lang="ts">
-    import { onMount } from "svelte";
-    import { EVENT_LAYOUT_READY, EVENT_REQUEST_OPEN_P2P_SETTINGS, eventHub } from "@/common/events";
-    import {
-        EVENT_SERVER_STATUS,
-        EVENT_REQUEST_STATUS,
-        EVENT_P2P_REPLICATOR_STATUS,
-        EVENT_P2P_REPLICATOR_PROGRESS,
-        type P2PServerInfo,
-    } from "@lib/replication/trystero/TrysteroReplicatorP2PServer";
-    import type { LiveSyncTrysteroReplicator } from "@lib/replication/trystero/LiveSyncTrysteroReplicator";
-    import type { P2PReplicatorStatus, P2PReplicationReport } from "@lib/replication/trystero/TrysteroReplicator";
-    import { delay, fireAndForget } from "octagonal-wheels/promises";
-    import P2PServerStatusCard from "./P2PServerStatusCard.svelte";
-    import { EVENT_SETTING_SAVED } from "@lib/events/coreEvents";
-    import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore";
-    import { ConnectionStringParser } from "@lib/common/ConnectionString";
-    import type { P2PSyncSetting, RemoteConfiguration } from "@lib/common/models/setting.type";
-    import { activateP2PRemoteConfiguration, createRemoteConfigurationId } from "@lib/serviceFeatures/remoteConfig";
-    import { extractP2PRoomSuffix } from "@lib/common/utils";
-    import { SetupManager } from "@/modules/features/SetupManager";
-    import SetupRemoteP2P from "@/modules/features/SetupWizard/dialogs/SetupRemoteP2P.svelte";
-
-    interface Props {
-        liveSyncReplicator: LiveSyncTrysteroReplicator;
-        core: LiveSyncBaseCore;
-    }
-
-    let { liveSyncReplicator, core }: Props = $props();
-    let serverInfo = $state<P2PServerInfo | undefined>(undefined);
-    let replicatorInfo = $state<P2PReplicatorStatus | undefined>(undefined);
-    let decidingPeerId = $state<string | null>(null);
-    let replicatingPeerId = $state<string | null>(null);
-    let communicatingUntil = $state<Record<string, number>>({});
-    const COMMUNICATION_HOLD_MS = 2500;
-    let syncOnReplicationSetting = $state(core.services.setting.currentSettings()?.P2P_SyncOnReplication ?? "");
-    type P2PRemoteOption = {
-        id: string;
-        name: string;
-        roomSuffix: string;
-    };
-    let p2pRemoteOptions = $state<P2PRemoteOption[]>([]);
-    let selectedP2PRemoteConfigurationId = $state(
-        core.services.setting.currentSettings()?.P2P_ActiveRemoteConfigurationId ?? ""
-    );
-    let selectingP2PRemote = $state(false);
-
-    function addToList(item: string, list: string): string {
-        const items = list
-            .split(",")
-            .map((e) => e.trim())
-            .filter((e) => e);
-        if (!items.includes(item)) items.push(item);
-        return items.join(",");
-    }
-    function removeFromList(item: string, list: string): string {
-        return list
-            .split(",")
-            .map((e) => e.trim())
-            .filter((e) => e && e !== item)
-            .join(",");
-    }
-
-    function markCommunicating(peerId: string) {
-        const expiry = Date.now() + COMMUNICATION_HOLD_MS;
-        communicatingUntil = { ...communicatingUntil, [peerId]: expiry };
-        window.setTimeout(() => {
-            if ((communicatingUntil[peerId] ?? 0) <= Date.now()) {
-                const { [peerId]: _removed, ...rest } = communicatingUntil;
-                communicatingUntil = rest;
-            }
-        }, COMMUNICATION_HOLD_MS + 100);
-    }
-
-    function listP2PRemoteOptions(
-        remoteConfigurations: Record<string, RemoteConfiguration> | undefined
-    ): P2PRemoteOption[] {
-        return Object.values(remoteConfigurations ?? {})
-            .map((config) => {
-                try {
-                    const parsed = ConnectionStringParser.parse(config.uri);
-                    if (parsed.type !== "p2p") {
-                        return undefined;
-                    }
-                    return {
-                        id: config.id,
-                        name: config.name,
-                        roomSuffix: extractP2PRoomSuffix(parsed.settings.P2P_roomID ?? ""),
-                    } as P2PRemoteOption;
-                } catch {
-                    return undefined;
-                }
-            })
-            .filter((e): e is P2PRemoteOption => !!e);
-    }
-
-    function refreshP2PRemoteOptions() {
-        const settings = core.services.setting.currentSettings();
-        const options = listP2PRemoteOptions(settings.remoteConfigurations);
-        p2pRemoteOptions = options;
-        const currentSelected = settings.P2P_ActiveRemoteConfigurationId ?? "";
-        const isCurrentSelectedValid = options.some((option) => option.id === currentSelected);
-        if (options.length === 0) {
-            selectedP2PRemoteConfigurationId = "";
-            return;
-        }
-        if (currentSelected.trim() === "" || !isCurrentSelectedValid) {
-            const fallbackId = options[0].id;
-            selectedP2PRemoteConfigurationId = fallbackId;
-            if (currentSelected !== fallbackId) {
-                fireAndForget(() => applyP2PActiveRemoteSelection(fallbackId));
-            }
-            return;
-        }
-        selectedP2PRemoteConfigurationId = currentSelected;
-    }
-
-    function canEditP2PSettings() {
-        const selected = selectedP2PRemoteConfigurationId.trim();
-        if (selected === "") {
-            return false;
-        }
-        return p2pRemoteOptions.some((e) => e.id === selected);
-    }
-
-    async function requestServerStatus() {
-        await liveSyncReplicator.requestStatus();
-        eventHub.emitEvent(EVENT_REQUEST_STATUS);
-    }
-
-    onMount(() => {
-        const unsubscribe = eventHub.onEvent(EVENT_SERVER_STATUS, (status) => {
-            serverInfo = status;
-        });
-        const unsubscribeReplicatorStatus = eventHub.onEvent(EVENT_P2P_REPLICATOR_STATUS, (status) => {
-            replicatorInfo = status;
-            for (const peerId of status.replicatingFrom) {
-                markCommunicating(peerId);
-            }
-            for (const peerId of status.replicatingTo) {
-                markCommunicating(peerId);
-            }
-        });
-        const unsubscribeReplicatorProgress = eventHub.onEvent(EVENT_P2P_REPLICATOR_PROGRESS, (report) => {
-            const rep = report as P2PReplicationReport;
-            if (("fetching" in rep && rep.fetching?.isActive) || ("sending" in rep && rep.sending?.isActive)) {
-                markCommunicating(rep.peerId);
-            }
-        });
-
-        const unsubscribeSettings = eventHub.onEvent(EVENT_SETTING_SAVED, (settings) => {
-            syncOnReplicationSetting = settings?.P2P_SyncOnReplication ?? "";
-            refreshP2PRemoteOptions();
-        });
-        const unsubscribeLayoutReady = eventHub.onEvent(EVENT_LAYOUT_READY, () => {
-            refreshP2PRemoteOptions();
-            void requestServerStatus();
-        });
-
-        fireAndForget(async () => {
-            await delay(100);
-            refreshP2PRemoteOptions();
-            await requestServerStatus();
-        });
-
-        return () => {
-            unsubscribe();
-            unsubscribeReplicatorStatus();
-            unsubscribeReplicatorProgress();
-            unsubscribeSettings();
-            unsubscribeLayoutReady();
-        };
-    });
-
-    function getAcceptanceStatus(peer: P2PServerInfo["knownAdvertisements"][number]) {
-        if (peer.isTemporaryAccepted === true) return "ACCEPTED (in session)";
-        if (peer.isAccepted === true) return "ACCEPTED";
-        if (peer.isTemporaryAccepted === false) return "DENIED (in session)";
-        if (peer.isAccepted === false) return "DENIED";
-        return "NEW";
-    }
-
-    function getAcceptanceStatusClass(peer: P2PServerInfo["knownAdvertisements"][number]) {
-        if (peer.isTemporaryAccepted === true || peer.isAccepted === true) return "accepted";
-        if (peer.isTemporaryAccepted === false || peer.isAccepted === false) return "denied";
-        return "unknown";
-    }
-
-    function openConnectionSettings() {
-        eventHub.emitEvent(EVENT_REQUEST_OPEN_P2P_SETTINGS);
-    }
-
-    async function applyP2PActiveRemoteSelection(id: string) {
-        selectingP2PRemote = true;
-        try {
-            await core.services.setting.updateSettings((settings) => {
-                settings.P2P_ActiveRemoteConfigurationId = id;
-                if (id.trim() === "") {
-                    return settings;
-                }
-                const activated = activateP2PRemoteConfiguration(settings, id);
-                return activated || settings;
-            }, true);
-            const latest = core.services.setting.currentSettings();
-            syncOnReplicationSetting = latest.P2P_SyncOnReplication ?? "";
-            refreshP2PRemoteOptions();
-        } finally {
-            selectingP2PRemote = false;
-        }
-    }
-
-    async function onP2PRemoteSelected(event: Event) {
-        const target = event.currentTarget as HTMLSelectElement;
-        const id = target.value;
-        selectedP2PRemoteConfigurationId = id;
-        await applyP2PActiveRemoteSelection(id);
-    }
-
-    async function createAndSelectP2PRemote() {
-        const setupManager = core.getModule(SetupManager);
-        const dialogManager = setupManager.dialogManager;
-        const currentSettings = core.services.setting.currentSettings();
-        const p2pConf = await dialogManager.openWithExplicitCancel(SetupRemoteP2P, currentSettings);
-        if (p2pConf === "cancelled" || typeof p2pConf !== "object" || !p2pConf) {
-            return;
-        }
-        const p2pSettings = p2pConf as Partial<P2PSyncSetting>;
-        const id = createRemoteConfigurationId();
-        const roomSuffix = extractP2PRoomSuffix(p2pSettings.P2P_roomID ?? "");
-        const name = roomSuffix ? `P2P Remote (${roomSuffix})` : "P2P Remote";
-        await core.services.setting.updateSettings((settings) => {
-            const merged = {
-                ...settings,
-                ...p2pSettings,
-            };
-            const uri = ConnectionStringParser.serialize({ type: "p2p", settings: merged });
-            settings.remoteConfigurations = {
-                ...(settings.remoteConfigurations ?? {}),
-                [id]: {
-                    id,
-                    name,
-                    uri,
-                    isEncrypted: false,
-                },
-            };
-            settings.P2P_ActiveRemoteConfigurationId = id;
-            const activated = activateP2PRemoteConfiguration(settings, id);
-            return activated || settings;
-        }, true);
-        const latest = core.services.setting.currentSettings();
-        syncOnReplicationSetting = latest.P2P_SyncOnReplication ?? "";
-        refreshP2PRemoteOptions();
-    }
-
-    async function updateSelectedP2PRemote(partial: Partial<P2PSyncSetting>) {
-        const selectedId = core.services.setting.currentSettings().P2P_ActiveRemoteConfigurationId?.trim() ?? "";
-        if (selectedId === "") {
-            return;
-        }
-        await core.services.setting.updateSettings((settings) => {
-            const config = settings.remoteConfigurations?.[selectedId];
-            if (!config) {
-                return settings;
-            }
-            let parsed;
-            try {
-                parsed = ConnectionStringParser.parse(config.uri);
-            } catch {
-                return settings;
-            }
-            if (parsed.type !== "p2p") {
-                return settings;
-            }
-            const mergedP2P = {
-                ...parsed.settings,
-                ...partial,
-            };
-            const uri = ConnectionStringParser.serialize({
-                type: "p2p",
-                settings: {
-                    ...settings,
-                    ...mergedP2P,
-                },
-            });
-            settings.remoteConfigurations = {
-                ...(settings.remoteConfigurations ?? {}),
-                [selectedId]: {
-                    ...config,
-                    uri,
-                    isEncrypted: false,
-                },
-            };
-            Object.assign(settings, partial);
-            const activated = activateP2PRemoteConfiguration(settings, selectedId);
-            return activated || settings;
-        }, true);
-        syncOnReplicationSetting = core.services.setting.currentSettings()?.P2P_SyncOnReplication ?? "";
-    }
-
-    async function makeDecision(
-        peer: P2PServerInfo["knownAdvertisements"][number],
-        decision: boolean,
-        isTemporary: boolean
-    ) {
-        decidingPeerId = peer.peerId;
-        try {
-            await liveSyncReplicator.makeDecision({
-                peerId: peer.peerId,
-                name: peer.name,
-                decision,
-                isTemporary,
-            });
-            await requestServerStatus();
-        } finally {
-            decidingPeerId = null;
-        }
-    }
-
-    async function revokeDecision(peer: P2PServerInfo["knownAdvertisements"][number]) {
-        decidingPeerId = peer.peerId;
-        try {
-            await liveSyncReplicator.revokeDecision({
-                peerId: peer.peerId,
-                name: peer.name,
-            });
-            await requestServerStatus();
-        } finally {
-            decidingPeerId = null;
-        }
-    }
-
-    async function startReplication(peer: P2PServerInfo["knownAdvertisements"][number]) {
-        replicatingPeerId = peer.peerId;
-        try {
-            const pullResult = await liveSyncReplicator.replicateFrom(peer.peerId, true);
-            if (pullResult?.ok) {
-                await liveSyncReplicator.requestSynchroniseToPeer(peer.peerId);
-            }
-            await requestServerStatus();
-        } finally {
-            replicatingPeerId = null;
-        }
-    }
-
-    function isAccepted(peer: P2PServerInfo["knownAdvertisements"][number]) {
-        return peer.isTemporaryAccepted === true || peer.isAccepted === true;
-    }
-
-    function isWatching(peerId: string) {
-        return replicatorInfo?.watchingPeers?.includes(peerId) ?? false;
-    }
-
-    function toggleWatch(peerId: string) {
-        if (!canEditP2PSettings()) {
-            return;
-        }
-        if (isWatching(peerId)) {
-            liveSyncReplicator.unwatchPeer(peerId);
-        } else {
-            liveSyncReplicator.watchPeer(peerId);
-        }
-    }
-
-    function isCommunicating(peerId: string) {
-        const to = replicatorInfo?.replicatingTo ?? [];
-        const from = replicatorInfo?.replicatingFrom ?? [];
-        const isLiveCommunicating = to.includes(peerId) || from.includes(peerId);
-        const isHeldCommunicating = (communicatingUntil[peerId] ?? 0) > Date.now();
-        return isLiveCommunicating || isHeldCommunicating;
-    }
-
-    function isSyncTarget(peerName: string) {
-        return syncOnReplicationSetting
-            .split(",")
-            .map((e) => e.trim())
-            .filter((e) => e)
-            .includes(peerName);
-    }
-
-    async function toggleSyncTarget(peer: P2PServerInfo["knownAdvertisements"][number]) {
-        if (!canEditP2PSettings()) {
-            return;
-        }
-        const currentValue = core.services.setting.currentSettings()?.P2P_SyncOnReplication ?? "";
-        const newValue = isSyncTarget(peer.name)
-            ? removeFromList(peer.name, currentValue)
-            : addToList(peer.name, currentValue);
-        await updateSelectedP2PRemote({ P2P_SyncOnReplication: newValue });
-    }
-</script>
-
-<div class="p2p-container">
-    <div class="pane-header">
-        <h2>P2P Status</h2>
-        <div class="pane-header-actions">
-            <div class="remote-picker-wrap">
-                <select
-                    class="remote-picker"
-                    value={selectedP2PRemoteConfigurationId}
-                    onchange={onP2PRemoteSelected}
-                    disabled={selectingP2PRemote}
-                    aria-label="Select active P2P remote"
-                    title="Select active P2P remote"
-                >
-                    {#if p2pRemoteOptions.length === 0}
-                        <option value="">Select P2P remote...</option>
-                    {/if}
-                    {#each p2pRemoteOptions as option}
-                        <option value={option.id}>
-                            {option.name}{option.roomSuffix ? ` (${option.roomSuffix})` : ""}
-                        </option>
-                    {/each}
-                </select>
-                <button
-                    class="icon-button"
-                    onclick={() => createAndSelectP2PRemote()}
-                    title="Create P2P remote"
-                    aria-label="Create P2P remote"
-                >
-                    +
-                </button>
-            </div>
-            <button
-                class="icon-button"
-                onclick={openConnectionSettings}
-                title="Open P2P Setup..."
-                aria-label="Open P2P Setup..."
-            >
-                ⚙
-            </button>
-        </div>
-    </div>
-
-    {#if !canEditP2PSettings()}
-        <p class="warning-line">Please select an active P2P remote configuration to change P2P sync targets.</p>
-    {/if}
-
-    <P2PServerStatusCard {liveSyncReplicator} {core} />
-
-    <div class="peers-section">
-        <div class="peers-header">
-            <h3>Detected Peers</h3>
-            <button class="refresh" onclick={requestServerStatus}>Refresh</button>
-        </div>
-
-        {#if serverInfo && serverInfo.knownAdvertisements.length > 0}
-            <div class="peers-list">
-                {#each serverInfo.knownAdvertisements as peer (peer.peerId)}
-                    <div class="peer-item">
-                        <div class="peer-info">
-                            <div class="peer-name">
-                                {peer.name} :
-                                <span class="peer-id-mini" title={peer.peerId}>({peer.peerId.slice(0, 8)})</span>
-                                {#if isCommunicating(peer.peerId)}
-                                    <span class="comm-icon" title="Communicating" aria-label="Communicating">📡</span>
-                                {/if}
-                            </div>
-                            <div class="peer-meta">
-                                <span class="badge">{peer.platform}</span>
-                            </div>
-                        </div>
-                        <div class="peer-actions">
-                            {#if isAccepted(peer)}
-                                <div class="decision-row accepted-row">
-                                    <span class="badge status-chip {getAcceptanceStatusClass(peer)}">
-                                        {getAcceptanceStatus(peer)}
-                                    </span>
-                                    <button
-                                        class="emoji-button"
-                                        disabled={replicatingPeerId !== null}
-                                        title={replicatingPeerId === peer.peerId ? "Replicating..." : "Replicate now"}
-                                        aria-label={replicatingPeerId === peer.peerId ? "Replicating" : "Replicate now"}
-                                        onclick={() => startReplication(peer)}
-                                    >
-                                        {replicatingPeerId === peer.peerId ? "⏳" : "🔄"}
-                                    </button>
-                                    <button
-                                        class="action-button"
-                                        disabled={decidingPeerId !== null}
-                                        onclick={() => revokeDecision(peer)}
-                                    >
-                                        Revoke
-                                    </button>
-                                </div>
-                                <div class="decision-row watch-row">
-                                    <span class="decision-label">WATCH</span>
-                                    <button
-                                        class="emoji-button {isWatching(peer.peerId) ? 'is-watching' : ''}"
-                                        title={isWatching(peer.peerId)
-                                            ? "Watching this peer \u2014 click to stop"
-                                            : "Watch this peer's changes"}
-                                        aria-label={isWatching(peer.peerId) ? "Stop watching" : "Watch peer"}
-                                        disabled={!canEditP2PSettings()}
-                                        onclick={() => toggleWatch(peer.peerId)}
-                                    >
-                                        {isWatching(peer.peerId) ? "🔔" : "🔕"}
-                                    </button>
-                                </div>
-                                <div class="decision-row watch-row">
-                                    <span class="decision-label">SYNC</span>
-                                    <button
-                                        class="emoji-button {isSyncTarget(peer.name) ? 'is-watching' : ''}"
-                                        title={isSyncTarget(peer.name)
-                                            ? "Sync target \u2014 click to remove"
-                                            : "Set as sync target"}
-                                        aria-label={isSyncTarget(peer.name) ? "Remove sync target" : "Set sync target"}
-                                        disabled={!canEditP2PSettings()}
-                                        onclick={() => toggleSyncTarget(peer)}
-                                    >
-                                        {isSyncTarget(peer.name) ? "🔗" : "⛓️‍💥"}
-                                    </button>
-                                </div>
-                            {:else}
-                                <div class="decision-status">
-                                    <span class="badge status-chip {getAcceptanceStatusClass(peer)}">
-                                        {getAcceptanceStatus(peer)}
-                                    </span>
-                                </div>
-                                <div class="decision-row">
-                                    <span class="decision-label">PERMANENT</span>
-                                    <button
-                                        class="emoji-button"
-                                        title="Allow permanently"
-                                        aria-label="Allow permanently"
-                                        disabled={decidingPeerId !== null}
-                                        onclick={() => makeDecision(peer, true, false)}
-                                    >
-                                        ✅
-                                    </button>
-                                    <button
-                                        class="emoji-button mod-warning"
-                                        title="Deny permanently"
-                                        aria-label="Deny permanently"
-                                        disabled={decidingPeerId !== null}
-                                        onclick={() => makeDecision(peer, false, false)}
-                                    >
-                                        🚫
-                                    </button>
-                                </div>
-                                <div class="decision-row">
-                                    <span class="decision-label">SESSION</span>
-                                    <button
-                                        class="emoji-button"
-                                        title="Allow in session"
-                                        aria-label="Allow in session"
-                                        disabled={decidingPeerId !== null}
-                                        onclick={() => makeDecision(peer, true, true)}
-                                    >
-                                        ✅
-                                    </button>
-                                    <button
-                                        class="emoji-button mod-warning"
-                                        title="Deny in session"
-                                        aria-label="Deny in session"
-                                        disabled={decidingPeerId !== null}
-                                        onclick={() => makeDecision(peer, false, true)}
-                                    >
-                                        🚫
-                                    </button>
-                                </div>
-                            {/if}
-                            {#if !isAccepted(peer) && (peer.isAccepted !== undefined || peer.isTemporaryAccepted !== undefined)}
-                                <button
-                                    class="action-button revoke-inline"
-                                    disabled={decidingPeerId !== null}
-                                    onclick={() => revokeDecision(peer)}
-                                >
-                                    Revoke
-                                </button>
-                            {/if}
-                        </div>
-                    </div>
-                {/each}
-            </div>
-        {:else if serverInfo}
-            <p class="no-peers">No devices available. Waiting for other devices to connect...</p>
-        {:else}
-            <p class="no-peers">Fetching status...</p>
-        {/if}
-    </div>
-</div>
-
-<style>
-    .p2p-container {
-        display: flex;
-        flex-direction: column;
-        gap: 1rem;
-    }
-
-    .peers-section {
-        border: 1px solid var(--divider-color);
-        border-radius: 0.5rem;
-        padding: 1rem;
-    }
-
-    .pane-header {
-        display: flex;
-        justify-content: space-between;
-        align-items: center;
-        flex-wrap: wrap;
-        gap: 0.5rem;
-    }
-
-    .pane-header-actions {
-        display: flex;
-        align-items: center;
-        gap: 0.4rem;
-        min-width: 0;
-    }
-
-    .remote-picker-wrap {
-        display: inline-flex;
-        gap: 0.3rem;
-        align-items: center;
-        min-width: 0;
-    }
-
-    .remote-picker {
-        max-width: 10rem;
-        min-width: 1em;
-        flex-shrink: 1;
-        height: 1.9rem;
-        border: 1px solid var(--divider-color);
-        border-radius: 0.4rem;
-        background-color: var(--interactive-normal);
-        color: var(--text-normal);
-        padding: 0 0.45rem;
-    }
-
-    .warning-line {
-        margin: -0.2rem 0 0;
-        font-size: 0.82rem;
-        color: var(--text-warning);
-    }
-
-    .pane-header h2 {
-        margin: 0;
-        font-size: 1.1rem;
-        font-weight: 700;
-        white-space: nowrap;
-    }
-
-    .icon-button {
-        width: 1.9rem;
-        height: 1.9rem;
-        display: inline-flex;
-        align-items: center;
-        justify-content: center;
-        font-size: 1rem;
-        line-height: 1;
-        border: 1px solid var(--divider-color);
-        border-radius: 0.4rem;
-        background-color: var(--interactive-normal);
-        color: var(--text-normal);
-        cursor: pointer;
-        flex-shrink: 0;
-    }
-
-    .icon-button:hover {
-        background-color: var(--interactive-hover);
-    }
-
-    .peers-header {
-        display: flex;
-        flex-wrap: wrap;
-        justify-content: space-between;
-        align-items: center;
-        gap: 0.5rem;
-        margin-bottom: 0.75rem;
-    }
-
-    h3 {
-        margin: 0;
-        font-weight: 600;
-        font-size: 1rem;
-    }
-
-    .refresh {
-        font-size: 0.8rem;
-        padding: 0.2rem 0.5rem;
-        border: 1px solid var(--divider-color);
-        border-radius: 0.3rem;
-        background-color: var(--interactive-normal);
-        color: var(--text-normal);
-        cursor: pointer;
-    }
-
-    .refresh:hover {
-        background-color: var(--interactive-hover);
-    }
-
-    .peers-list {
-        display: flex;
-        flex-direction: column;
-        gap: 0.5rem;
-    }
-
-    .peer-item {
-        display: flex;
-        flex-direction: column;
-        align-items: stretch;
-        gap: 0.75rem;
-        padding: 0.75rem;
-        background-color: var(--background-secondary);
-        border: 1px solid var(--divider-color);
-        border-radius: 0.4rem;
-    }
-
-    .peer-info {
-        flex: 1;
-        min-width: 0;
-    }
-
-    .peer-name {
-        font-weight: 600;
-        margin-bottom: 0.25rem;
-        font-size: 0.9rem;
-        display: flex;
-        align-items: center;
-        gap: 0.35rem;
-    }
-
-    .peer-meta {
-        display: flex;
-        gap: 0.5rem;
-        font-size: 0.8rem;
-        flex-wrap: wrap;
-    }
-
-    .badge {
-        background-color: var(--background-tertiary);
-        padding: 0.1rem 0.4rem;
-        border-radius: 0.25rem;
-    }
-
-    .status-chip {
-        font-weight: 600;
-    }
-
-    .status-chip.accepted {
-        background-color: var(--background-modifier-success);
-        color: var(--text-normal);
-    }
-
-    .status-chip.denied {
-        background-color: var(--background-modifier-error);
-        color: var(--text-normal);
-    }
-
-    .status-chip.unknown {
-        background-color: var(--background-modifier-border);
-        color: var(--text-muted);
-    }
-
-    .peer-id-mini {
-        font-family: monospace;
-        color: var(--text-muted);
-        font-size: 0.75rem;
-    }
-
-    .comm-icon {
-        font-size: 0.8rem;
-        line-height: 1;
-        animation: pulse-comm 1.2s ease-in-out infinite;
-    }
-
-    @keyframes pulse-comm {
-        0% {
-            opacity: 0.55;
-            transform: scale(0.95);
-        }
-        50% {
-            opacity: 1;
-            transform: scale(1);
-        }
-        100% {
-            opacity: 0.55;
-            transform: scale(0.95);
-        }
-    }
-
-    .peer-actions {
-        display: flex;
-        flex-direction: column;
-        gap: 0.35rem;
-        width: 100%;
-        min-width: 0;
-    }
-
-    .decision-status {
-        display: flex;
-        justify-content: flex-start;
-    }
-
-    .decision-row {
-        display: grid;
-        grid-template-columns: 1fr auto auto;
-        align-items: center;
-        gap: 0.35rem;
-    }
-
-    .accepted-row {
-        grid-template-columns: 1fr auto auto;
-    }
-
-    .decision-label {
-        font-size: 0.7rem;
-        font-weight: 700;
-        color: var(--text-muted);
-        letter-spacing: 0.03em;
-    }
-
-    .action-button {
-        font-size: 0.75rem;
-        padding: 0.2rem 0.45rem;
-        border: 1px solid var(--divider-color);
-        border-radius: 0.3rem;
-        background-color: var(--interactive-normal);
-        color: var(--text-normal);
-        cursor: pointer;
-        width: auto;
-        white-space: nowrap;
-        overflow: hidden;
-        text-overflow: ellipsis;
-    }
-
-    .emoji-button {
-        width: 2rem;
-        height: 1.7rem;
-        display: inline-flex;
-        align-items: center;
-        justify-content: center;
-        border: 1px solid var(--divider-color);
-        border-radius: 0.3rem;
-        background-color: var(--interactive-normal);
-        cursor: pointer;
-        padding: 0;
-        line-height: 1;
-    }
-
-    .emoji-button.mod-warning {
-        background-color: var(--background-modifier-error);
-    }
-
-    .emoji-button.is-watching {
-        background-color: var(--interactive-accent);
-        color: var(--text-on-accent);
-        border-color: var(--interactive-accent);
-    }
-
-    .emoji-button:hover:not(:disabled) {
-        background-color: var(--interactive-hover);
-    }
-
-    .emoji-button.mod-warning:hover:not(:disabled) {
-        filter: brightness(0.95);
-    }
-
-    .watch-row {
-        margin-top: 0.25rem;
-    }
-
-    .action-button:hover:not(:disabled) {
-        background-color: var(--interactive-hover);
-    }
-
-    .action-button.mod-warning {
-        background-color: var(--background-modifier-error);
-    }
-
-    .action-button:disabled {
-        opacity: 0.6;
-        cursor: not-allowed;
-    }
-
-    .emoji-button:disabled {
-        opacity: 0.6;
-        cursor: not-allowed;
-    }
-
-    .revoke-inline {
-        justify-self: start;
-    }
-
-    .no-peers {
-        text-align: center;
-        color: var(--text-muted);
-        font-size: 0.9rem;
-        padding: 1rem;
-    }
-</style>

src/features/P2PSync/P2PReplicator/P2PServerStatusPaneView.ts

@@ -1,43 +0,0 @@
-import { WorkspaceLeaf } from "@/deps.ts";
-import { mount } from "svelte";
-import { SvelteItemView } from "@/common/SvelteItemView.ts";
-import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore.ts";
-import type { P2PPaneParams } from "@/lib/src/replication/trystero/UseP2PReplicatorResult";
-import P2PServerStatusPane from "./P2PServerStatusPane.svelte";
-
-export const VIEW_TYPE_P2P_SERVER_STATUS = "p2p-server-status";
-
-export class P2PServerStatusPaneView extends SvelteItemView {
-    core: LiveSyncBaseCore;
-    private _p2pResult: P2PPaneParams;
-    override icon = "waypoints";
-    override navigation = false;
-
-    constructor(leaf: WorkspaceLeaf, core: LiveSyncBaseCore, p2pResult: P2PPaneParams) {
-        super(leaf);
-        this.core = core;
-        this._p2pResult = p2pResult;
-    }
-
-    override getIcon(): string {
-        return "waypoints";
-    }
-
-    getViewType() {
-        return VIEW_TYPE_P2P_SERVER_STATUS;
-    }
-
-    getDisplayText() {
-        return "P2P Status";
-    }
-
-    instantiateComponent(target: HTMLElement) {
-        return mount(P2PServerStatusPane, {
-            target,
-            props: {
-                liveSyncReplicator: this._p2pResult.replicator,
-                core: this.core,
-            },
-        });
-    }
-}

src/main.ts

@@ -1,6 +1,5 @@
-import { getLanguage, Notice, Plugin, type App, type PluginManifest } from "./deps";
-import { setGetLanguage } from "./lib/src/common/coreEnvFunctions.ts";
-setGetLanguage(getLanguage);
+import { Notice, Plugin, type App, type PluginManifest } from "./deps";
+
 import { LiveSyncCommands } from "./features/LiveSyncCommands.ts";
 import { HiddenFileSync } from "./features/HiddenFileSync/CmdHiddenFileSync.ts";
 import { ConfigSync } from "./features/ConfigSync/CmdConfigSync.ts";
@@ -12,6 +11,8 @@ import { ModuleObsidianEvents } from "./modules/essentialObsidian/ModuleObsidian
 import { ModuleObsidianSettingDialogue } from "./modules/features/ModuleObsidianSettingTab.ts";
 import { ModuleObsidianDocumentHistory } from "./modules/features/ModuleObsidianDocumentHistory.ts";
 import { ModuleObsidianGlobalHistory } from "./modules/features/ModuleGlobalHistory.ts";
+import { ModuleIntegratedTest } from "./modules/extras/ModuleIntegratedTest.ts";
+import { ModuleReplicateTest } from "./modules/extras/ModuleReplicateTest.ts";
 import { LocalDatabaseMaintenance } from "./features/LocalDatabaseMainte/CmdLocalDatabaseMainte.ts";
 import type { InjectableServiceHub } from "@lib/services/implements/injectable/InjectableServiceHub.ts";
 import { ObsidianServiceHub } from "./modules/services/ObsidianServiceHub.ts";
@@ -42,7 +43,6 @@ import { useSetupManagerHandlersFeature } from "./serviceFeatures/setupObsidian/
 import { useP2PReplicatorFeature } from "@lib/replication/trystero/useP2PReplicatorFeature.ts";
 import { useP2PReplicatorCommands } from "@lib/replication/trystero/useP2PReplicatorCommands.ts";
 import { useP2PReplicatorUI } from "./serviceFeatures/useP2PReplicatorUI.ts";
-import { createOpenReplicationUI, createOpenRebuildUI } from "./features/P2PSync/P2PReplicator/P2PReplicationUI.ts";
 export type LiveSyncCore = LiveSyncBaseCore<ObsidianServiceContext, LiveSyncCommands>;
 export default class ObsidianLiveSyncPlugin extends Plugin {
     core: LiveSyncCore;
@@ -154,6 +154,8 @@ export default class ObsidianLiveSyncPlugin extends Plugin {
                     new ModuleInteractiveConflictResolver(this, core),
                     new ModuleObsidianGlobalHistory(this, core),
                     new ModuleDev(this, core),
+                    new ModuleReplicateTest(this, core),
+                    new ModuleIntegratedTest(this, core),
                     new SetupManager(core), // this should be moved to core?
                     new ModuleMigration(core),
                 ];
@@ -173,13 +175,7 @@ export default class ObsidianLiveSyncPlugin extends Plugin {
                 const curriedFeature = () => featuresInitialiser(core);
                 core.services.appLifecycle.onLayoutReady.addHandler(curriedFeature);
                 const setupManager = core.getModule(SetupManager);
-                const replicator = useP2PReplicatorFeature(
-                    core,
-                    createOpenReplicationUI(this.app),
-                    createOpenRebuildUI(this.app)
-                );
-                useP2PReplicatorCommands(core, replicator);
-                useP2PReplicatorUI(core, core, replicator);
+
                 useRemoteConfiguration(core);
 
                 useSetupProtocolFeature(core, setupManager);
@@ -193,6 +189,9 @@ export default class ObsidianLiveSyncPlugin extends Plugin {
                 //     VIEW_TYPE_P2P,
                 //     (leaf: any) => new P2PReplicatorPaneView(leaf, core, p2pReplicatorResult!),
                 // ]);
+                const replicator = useP2PReplicatorFeature(core);
+                useP2PReplicatorCommands(core, replicator);
+                useP2PReplicatorUI(core, core, replicator);
             }
         );
     }

src/modules/core/ModuleReplicator.ts

@@ -1,4 +1,3 @@
-import type PouchDB from "pouchdb-core";
 import { fireAndForget } from "octagonal-wheels/promises";
 import { AbstractModule } from "../AbstractModule";
 import { Logger, LOG_LEVEL_NOTICE, LOG_LEVEL_INFO } from "octagonal-wheels/common/logger";

src/modules/core/ModuleReplicatorP2P.ts

@@ -0,0 +1,25 @@
+import { REMOTE_P2P, type RemoteDBSettings } from "../../lib/src/common/types";
+import type { LiveSyncAbstractReplicator } from "../../lib/src/replication/LiveSyncAbstractReplicator";
+import { AbstractModule } from "../AbstractModule";
+import { LiveSyncTrysteroReplicator } from "../../lib/src/replication/trystero/LiveSyncTrysteroReplicator";
+import type { LiveSyncCore } from "../../main";
+
+// Note:
+// This module registers only the `getNewReplicator` handler for the P2P replicator.
+// `useP2PReplicator` (see P2PReplicatorCore.ts) already registers the same `getNewReplicator`
+// handler internally, so this module is redundant in environments that call `useP2PReplicator`.
+// Register this module only in environments that do NOT use `useP2PReplicator` (e.g. CLI).
+// In other words: just resolving `getNewReplicator` via this module is all that is needed
+// to satisfy what `useP2PReplicator` requires from the replicator service.
+export class ModuleReplicatorP2P extends AbstractModule {
+    _anyNewReplicator(settingOverride: Partial<RemoteDBSettings> = {}): Promise<LiveSyncAbstractReplicator | false> {
+        const settings = { ...this.settings, ...settingOverride };
+        if (settings.remoteType == REMOTE_P2P) {
+            return Promise.resolve(new LiveSyncTrysteroReplicator(this.core));
+        }
+        return Promise.resolve(false);
+    }
+    override onBindFunction(core: LiveSyncCore, services: typeof core.services): void {
+        services.replicator.getNewReplicator.addHandler(this._anyNewReplicator.bind(this));
+    }
+}

src/modules/coreFeatures/ModuleRedFlag.ts

@@ -0,0 +1,331 @@
+import { LOG_LEVEL_INFO, LOG_LEVEL_NOTICE, LOG_LEVEL_VERBOSE } from "octagonal-wheels/common/logger";
+import { normalizePath } from "../../deps.ts";
+import {
+    FlagFilesHumanReadable,
+    FlagFilesOriginal,
+    REMOTE_MINIO,
+    TweakValuesShouldMatchedTemplate,
+    type ObsidianLiveSyncSettings,
+} from "../../lib/src/common/types.ts";
+import { AbstractModule } from "../AbstractModule.ts";
+import type { LiveSyncCore } from "../../main.ts";
+import FetchEverything from "../features/SetupWizard/dialogs/FetchEverything.svelte";
+import RebuildEverything from "../features/SetupWizard/dialogs/RebuildEverything.svelte";
+import { extractObject } from "octagonal-wheels/object";
+import { SvelteDialogManagerBase } from "@lib/UI/svelteDialog.ts";
+import type { ServiceContext } from "@lib/services/base/ServiceBase.ts";
+
+export class ModuleRedFlag extends AbstractModule {
+    async isFlagFileExist(path: string) {
+        const redflag = await this.core.storageAccess.isExists(normalizePath(path));
+        if (redflag) {
+            return true;
+        }
+        return false;
+    }
+
+    async deleteFlagFile(path: string) {
+        try {
+            const isFlagged = await this.core.storageAccess.isExists(normalizePath(path));
+            if (isFlagged) {
+                await this.core.storageAccess.delete(path, true);
+            }
+        } catch (ex) {
+            this._log(`Could not delete ${path}`);
+            this._log(ex, LOG_LEVEL_VERBOSE);
+        }
+    }
+
+    isSuspendFlagActive = async () => await this.isFlagFileExist(FlagFilesOriginal.SUSPEND_ALL);
+    isRebuildFlagActive = async () =>
+        (await this.isFlagFileExist(FlagFilesOriginal.REBUILD_ALL)) ||
+        (await this.isFlagFileExist(FlagFilesHumanReadable.REBUILD_ALL));
+    isFetchAllFlagActive = async () =>
+        (await this.isFlagFileExist(FlagFilesOriginal.FETCH_ALL)) ||
+        (await this.isFlagFileExist(FlagFilesHumanReadable.FETCH_ALL));
+
+    async cleanupRebuildFlag() {
+        await this.deleteFlagFile(FlagFilesOriginal.REBUILD_ALL);
+        await this.deleteFlagFile(FlagFilesHumanReadable.REBUILD_ALL);
+    }
+
+    async cleanupFetchAllFlag() {
+        await this.deleteFlagFile(FlagFilesOriginal.FETCH_ALL);
+        await this.deleteFlagFile(FlagFilesHumanReadable.FETCH_ALL);
+    }
+    // dialogManager = new SvelteDialogManagerBase(this.core);
+    get dialogManager(): SvelteDialogManagerBase<ServiceContext> {
+        return this.core.services.UI.dialogManager;
+    }
+
+    /**
+     * Adjust setting to remote if needed.
+     * @param extra result of dialogues that may contain preventFetchingConfig flag (e.g, from FetchEverything or RebuildEverything)
+     * @param config current configuration to retrieve remote preferred config
+     */
+    async adjustSettingToRemoteIfNeeded(extra: { preventFetchingConfig: boolean }, config: ObsidianLiveSyncSettings) {
+        if (extra && extra.preventFetchingConfig) {
+            return;
+        }
+
+        // Remote configuration fetched and applied.
+        if (await this.adjustSettingToRemote(config)) {
+            config = this.core.settings;
+        } else {
+            this._log("Remote configuration not applied.", LOG_LEVEL_NOTICE);
+        }
+        console.debug(config);
+    }
+
+    /**
+     * Adjust setting to remote configuration.
+     * @param config current configuration to retrieve remote preferred config
+     * @returns updated configuration if applied, otherwise null.
+     */
+    async adjustSettingToRemote(config: ObsidianLiveSyncSettings) {
+        // Fetch remote configuration unless prevented.
+        const SKIP_FETCH = "Skip and proceed";
+        const RETRY_FETCH = "Retry (recommended)";
+        let canProceed = false;
+        do {
+            const remoteTweaks = await this.services.tweakValue.fetchRemotePreferred(config);
+            if (!remoteTweaks) {
+                const choice = await this.core.confirm.askSelectStringDialogue(
+                    "Could not fetch configuration from remote. If you are new to the Self-hosted LiveSync, this might be expected. If not, you should check your network or server settings.",
+                    [SKIP_FETCH, RETRY_FETCH] as const,
+                    {
+                        defaultAction: RETRY_FETCH,
+                        timeout: 0,
+                        title: "Fetch Remote Configuration Failed",
+                    }
+                );
+                if (choice === SKIP_FETCH) {
+                    canProceed = true;
+                }
+            } else {
+                const necessary = extractObject(TweakValuesShouldMatchedTemplate, remoteTweaks);
+                // Check if any necessary tweak value is different from current config.
+                const differentItems = Object.entries(necessary).filter(([key, value]) => {
+                    return (config as any)[key] !== value;
+                });
+                if (differentItems.length === 0) {
+                    this._log(
+                        "Remote configuration matches local configuration. No changes applied.",
+                        LOG_LEVEL_NOTICE
+                    );
+                } else {
+                    await this.core.confirm.askSelectStringDialogue(
+                        "Your settings differed slightly from the server's. The plug-in has supplemented the incompatible parts with the server settings!",
+                        ["OK"] as const,
+                        {
+                            defaultAction: "OK",
+                            timeout: 0,
+                        }
+                    );
+                }
+
+                config = {
+                    ...config,
+                    ...Object.fromEntries(differentItems),
+                } satisfies ObsidianLiveSyncSettings;
+                this.core.settings = config;
+                await this.core.services.setting.saveSettingData();
+                this._log("Remote configuration applied.", LOG_LEVEL_NOTICE);
+                canProceed = true;
+                return this.core.settings;
+            }
+        } while (!canProceed);
+    }
+
+    /**
+     * Process vault initialisation with suspending file watching and sync.
+     * @param proc process to be executed during initialisation, should return true if can be continued, false if app is unable to continue the process.
+     * @param keepSuspending  whether to keep suspending file watching after the process.
+     * @returns result of the process, or false if error occurs.
+     */
+    async processVaultInitialisation(proc: () => Promise<boolean>, keepSuspending = false) {
+        try {
+            // Disable batch saving and file watching during initialisation.
+            this.settings.batchSave = false;
+            await this.services.setting.suspendAllSync();
+            await this.services.setting.suspendExtraSync();
+            this.settings.suspendFileWatching = true;
+            await this.saveSettings();
+            try {
+                const result = await proc();
+                return result;
+            } catch (ex) {
+                this._log("Error during vault initialisation process.", LOG_LEVEL_NOTICE);
+                this._log(ex, LOG_LEVEL_VERBOSE);
+                return false;
+            }
+        } catch (ex) {
+            this._log("Error during vault initialisation.", LOG_LEVEL_NOTICE);
+            this._log(ex, LOG_LEVEL_VERBOSE);
+            return false;
+        } finally {
+            if (!keepSuspending) {
+                // Re-enable file watching after initialisation.
+                this.settings.suspendFileWatching = false;
+                await this.saveSettings();
+            }
+        }
+    }
+
+    /**
+     * Handle the rebuild everything scheduled operation.
+     * @returns true if can be continued, false if app restart is needed.
+     */
+    async onRebuildEverythingScheduled() {
+        const method = await this.dialogManager.openWithExplicitCancel(RebuildEverything);
+        if (method === "cancelled") {
+            // Clean up the flag file and restart the app.
+            this._log("Rebuild everything cancelled by user.", LOG_LEVEL_NOTICE);
+            await this.cleanupRebuildFlag();
+            this.services.appLifecycle.performRestart();
+            return false;
+        }
+        const { extra } = method;
+        await this.adjustSettingToRemoteIfNeeded(extra, this.settings);
+        return await this.processVaultInitialisation(async () => {
+            await this.core.rebuilder.$rebuildEverything();
+            await this.cleanupRebuildFlag();
+            this._log("Rebuild everything operation completed.", LOG_LEVEL_NOTICE);
+            return true;
+        });
+    }
+    /**
+     * Handle the fetch all scheduled operation.
+     * @returns true if can be continued, false if app restart is needed.
+     */
+    async onFetchAllScheduled() {
+        const method = await this.dialogManager.openWithExplicitCancel(FetchEverything);
+        if (method === "cancelled") {
+            this._log("Fetch everything cancelled by user.", LOG_LEVEL_NOTICE);
+            // Clean up the flag file and restart the app.
+            await this.cleanupFetchAllFlag();
+            this.services.appLifecycle.performRestart();
+            return false;
+        }
+        const { vault, extra } = method;
+        // If remote is MinIO, makeLocalChunkBeforeSync is not available. (because no-deduplication on sending).
+        const makeLocalChunkBeforeSyncAvailable = this.settings.remoteType !== REMOTE_MINIO;
+        const mapVaultStateToAction = {
+            identical: {
+                // If both are identical, no need to make local files/chunks before sync,
+                // Just for the efficiency, chunks should be made before sync.
+                makeLocalChunkBeforeSync: makeLocalChunkBeforeSyncAvailable,
+                makeLocalFilesBeforeSync: false,
+            },
+            independent: {
+                // If both are independent, nothing needs to be made before sync.
+                // Respect the remote state.
+                makeLocalChunkBeforeSync: false,
+                makeLocalFilesBeforeSync: false,
+            },
+            unbalanced: {
+                // If both are unbalanced, local files should be made before sync to avoid data loss.
+                // Then, chunks should be made before sync for the efficiency, but also the metadata made and should be detected as conflicting.
+                makeLocalChunkBeforeSync: false,
+                makeLocalFilesBeforeSync: true,
+            },
+            cancelled: {
+                // Cancelled case, not actually used.
+                makeLocalChunkBeforeSync: false,
+                makeLocalFilesBeforeSync: false,
+            },
+        } as const;
+
+        return await this.processVaultInitialisation(async () => {
+            await this.adjustSettingToRemoteIfNeeded(extra, this.settings);
+            // Okay, proceed to fetch everything.
+            const { makeLocalChunkBeforeSync, makeLocalFilesBeforeSync } = mapVaultStateToAction[vault];
+            this._log(
+                `Fetching everything with settings: makeLocalChunkBeforeSync=${makeLocalChunkBeforeSync}, makeLocalFilesBeforeSync=${makeLocalFilesBeforeSync}`,
+                LOG_LEVEL_INFO
+            );
+            await this.core.rebuilder.$fetchLocal(makeLocalChunkBeforeSync, !makeLocalFilesBeforeSync);
+            await this.cleanupFetchAllFlag();
+            this._log("Fetch everything operation completed. Vault files will be gradually synced.", LOG_LEVEL_NOTICE);
+            return true;
+        });
+    }
+
+    async onSuspendAllScheduled() {
+        this._log("SCRAM is detected. All operations are suspended.", LOG_LEVEL_NOTICE);
+        return await this.processVaultInitialisation(async () => {
+            this._log(
+                "All operations are suspended as per SCRAM.\nLogs will be written to the file. This might be a performance impact.",
+                LOG_LEVEL_NOTICE
+            );
+            this.settings.writeLogToTheFile = true;
+            await this.core.services.setting.saveSettingData();
+            return Promise.resolve(false);
+        }, true);
+    }
+
+    async verifyAndUnlockSuspension() {
+        if (!this.settings.suspendFileWatching) {
+            return true;
+        }
+        if (
+            (await this.core.confirm.askYesNoDialog(
+                "Do you want to resume file and database processing, and restart obsidian now?",
+                { defaultOption: "Yes", timeout: 15 }
+            )) != "yes"
+        ) {
+            // TODO: Confirm actually proceed to next process.
+            return true;
+        }
+        this.settings.suspendFileWatching = false;
+        await this.saveSettings();
+        this.services.appLifecycle.performRestart();
+        return false;
+    }
+
+    private async processFlagFilesOnStartup(): Promise<boolean> {
+        const isFlagSuspensionActive = await this.isSuspendFlagActive();
+        const isFlagRebuildActive = await this.isRebuildFlagActive();
+        const isFlagFetchAllActive = await this.isFetchAllFlagActive();
+        // TODO: Address the case when both flags are active (very unlikely though).
+        // if(isFlagFetchAllActive && isFlagRebuildActive) {
+        //     const message = "Rebuild everything and Fetch everything flags are both detected.";
+        //     await this.core.confirm.askSelectStringDialogue(
+        //         "Both Rebuild Everything and Fetch Everything flags are detected. Please remove one of them and restart the app.",
+        //         ["OK"] as const,)
+        if (isFlagFetchAllActive) {
+            const res = await this.onFetchAllScheduled();
+            if (res) {
+                return await this.verifyAndUnlockSuspension();
+            }
+            return false;
+        }
+        if (isFlagRebuildActive) {
+            const res = await this.onRebuildEverythingScheduled();
+            if (res) {
+                return await this.verifyAndUnlockSuspension();
+            }
+            return false;
+        }
+        if (isFlagSuspensionActive) {
+            const res = await this.onSuspendAllScheduled();
+            return res;
+        }
+        return true;
+    }
+
+    async _everyOnLayoutReady(): Promise<boolean> {
+        try {
+            const flagProcessResult = await this.processFlagFilesOnStartup();
+            return flagProcessResult;
+        } catch (ex) {
+            this._log("Something went wrong on FlagFile Handling", LOG_LEVEL_NOTICE);
+            this._log(ex, LOG_LEVEL_VERBOSE);
+        }
+        return true;
+    }
+    override onBindFunction(core: LiveSyncCore, services: typeof core.services): void {
+        super.onBindFunction(core, services);
+        services.appLifecycle.onLayoutReady.addHandler(this._everyOnLayoutReady.bind(this));
+    }
+}