bump

### Fixed

- Now no chunk creation errors will be raised after switching `Compute revisions for chunks`.
- Some invisible file can be handled correctly (e.g., `writing-goals-history.csv`).
- Fetching configuration from the server is now saves the configuration immediately (if we are not in the wizard).

### Improved

- Mismatched configuration dialogue is now more informative, and rewritten to more user-friendly.
- Applying configuration mismatch is now without rebuilding (at our own risks).
- Now, rebuilding is decided more fine grained.

### Improved internally

- Translations can be nested. i.e., task:`Some procedure`, check: `%{task} checking`, checkfailed: `%{check} failed` produces `Some procedure checking failed`.

.eslintignore

@@ -1,11 +0,0 @@
-node_modules
-build
-.eslintrc.js.bak
-src/lib/src/patches/pouchdb-utils
-esbuild.config.mjs
-rollup.config.js
-src/lib/test
-src/lib/src/cli
-main.js
-src/lib/apps/webpeer/dist
-src/lib/apps/webpeer/svelte.config.js

.eslintrc

@@ -1,13 +1,34 @@
 {
     "root": true,
     "parser": "@typescript-eslint/parser",
-    "plugins": ["@typescript-eslint"],
-    "extends": ["eslint:recommended", "plugin:@typescript-eslint/eslint-recommended", "plugin:@typescript-eslint/recommended"],
+    "plugins": [
+        "@typescript-eslint",
+        "eslint-plugin-svelte",
+        "eslint-plugin-import"
+    ],
+    "extends": [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/eslint-recommended",
+        "plugin:@typescript-eslint/recommended"
+    ],
     "parserOptions": {
         "sourceType": "module",
-        "project": ["tsconfig.json"]
+        "project": [
+            "tsconfig.json"
+        ]
     },
-    "ignorePatterns": [],
+    "ignorePatterns": [
+        "**/node_modules/*",
+        "**/jest.config.js",
+        "src/lib/coverage",
+        "src/lib/browsertest",
+        "**/test.ts",
+        "**/tests.ts",
+        "**/**test.ts",
+        "**/**.test.ts",
+        "esbuild.*.mjs",
+        "terser.*.mjs"
+    ],
     "rules": {
         "no-unused-vars": "off",
         "@typescript-eslint/no-unused-vars": [
@@ -34,4 +55,4 @@
             }
         ]
     }
-}
+}

docs/troubleshooting.md

@@ -1,6 +1,6 @@
-<!-- 2024-02-15 -->
-# Tips and Troubleshooting
+<!-- 2025-02-18 -->
 
+# Tips and Troubleshooting
 
 - [Tips and Troubleshooting](#tips-and-troubleshooting)
   - [Notable bugs and fixes](#notable-bugs-and-fixes)
@@ -25,14 +25,16 @@
 
 <!-- - -->
 
-
 ## Notable bugs and fixes
+
 ### Binary files get bigger on iOS
+
 - Reported at: v0.20.x
 - Fixed at: v0.21.2 (Fixed but not reviewed)
 - Required action: larger files will not be fixed automatically, please perform `Verify and repair all files`. If our local database and storage are not matched, we will be asked to apply which one.
 
 ### Some setting name has been changed
+
 - Fixed at: v0.22.6
 
 | Previous name                | New name                                 |
@@ -58,13 +60,16 @@ Therefore, experienced users (especially those stable enough not to have to rebu
 Please disable it when you have enough time.
 
 ### ZIP (or any extensions) files were not synchronised. Why?
+
 It depends on Obsidian detects. May toggling `Detect all extensions` of `File and links` (setting of Obsidian) will help us.
 
 ### 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 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.
 
@@ -73,16 +78,20 @@ However, the logs would not be kept so long and cleared when restarted. If you w
 ![ScreenShot](../images/write_logs_into_the_file.png)
 
 > [!IMPORTANT]
+>
 > - Writing logs into the file will impact the performance.
 > - Please make sure that you have erased all your confidential information before reporting issue.
 
 ### Why are the logs volatile and ephemeral?
+
 To avoid unexpected exposure to our confidential things.
 
 ### Some network logs are not written into the file.
+
 Especially the CORS error will be reported as a general error to the plug-in for security reasons. So we cannot detect and log it. We are only able to investigate them by [Checking the network log](#checking-the-network-log).
 
 ### If a file were deleted or trimmed, the capacity of the database should be reduced, right?
+
 No, even though if files were deleted, chunks were not deleted.
 Self-hosted LiveSync splits the files into multiple chunks and transfers only newly created. This behaviour enables us to less traffic. And, the chunks will be shared between the files to reduce the total usage of the database.
 
@@ -93,24 +102,42 @@ To shrink the database size, `Rebuild everything` only reliably and effectively.
 ### How can I use the DevTools?
 
 #### Checking the network log
+
 1. Open the network pane.
 2. Find the requests marked in red.  
-![Errored](../images/devtools1.png)
+   ![Errored](../images/devtools1.png)
 3. Capture the `Headers`, `Payload`, and, `Response`. **Please be sure to keep important information confidential**. If the `Response` contains secrets, you can omitted that.
-Note: Headers contains a some credentials. **The path of the request URL, Remote Address, authority, and authorization must be concealed.**  
-![Concealed sample](../images/devtools2.png)
+   Note: Headers contains a some credentials. **The path of the request URL, Remote Address, authority, and authorization must be concealed.**  
+   ![Concealed sample](../images/devtools2.png)
 
 ## Troubleshooting
+
 <!-- Add here -->
 
 ### On the mobile device, cannot synchronise on the local network!
+
 Obsidian mobile is not able to connect to the non-secure end-point, such as starting with `http://`. Make sure your URI of CouchDB. Also not able to use a self-signed certificate.
 
 ### I think that something bad happening on the vault...
+
 Place `redflag.md` on top of the vault, and restart Obsidian. The most simple way is to create a new note and rename it to `redflag`. Of course, we can put it without Obsidian.
 
 If there is `redflag.md`, Self-hosted LiveSync suspends all database and storage processes.
 
+There are some options to use `redflag.md`.
+
+| 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. |
+
+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.
+
+However, occasionally the deletion of files may fail. This should generally work normally after restarting Obsidian. (As far as I can observe).
+
 ## Tips
 
 ### How to resolve `Tweaks Mismatched of Changed`
@@ -125,7 +152,7 @@ Following dialogue will be shown:
 
 - If we want to propagate the setting of the device, we should choose `Update with mine`.
 - On other devices, we should choose `Use configured` to accept and use the configured configuration.
-- `Dismiss` can postpone a decision. However, we cannot synchronise until we have decided. 
+- `Dismiss` can postpone a decision. However, we cannot synchronise until we have decided.
 
 Rest assured that in most cases we can choose `Use configured`. (Unless you are certain that you have not changed the configuration).
 
@@ -133,16 +160,16 @@ If we see it for the first time, it reflects the settings of the device that has
 
 <!-- Add here -->
 
-
 ### Old tips
--   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 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 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 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 again. The device has to compare its notes with the remotely saved ones. If there exists a historic revision in which the note used to be identical, it could be updated safely (like git fast-forward). Even if that is not in revision histories, we only have to check the differences after the revision that both devices commonly have. This is like git's conflict-resolving method. 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 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)
+
+- 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 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 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 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 again. The device has to compare its notes with the remotely saved ones. If there exists a historic revision in which the note used to be identical, it could be updated safely (like git fast-forward). Even if that is not in revision histories, we only have to check the differences after the revision that both devices commonly have. This is like git's conflict-resolving method. 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 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)
 
 Repo is here: [obsidian-livesync-webclip](https://github.com/vrtmrz/obsidian-livesync-webclip). (Docs are a work in progress.)

esbuild.config.mjs

@@ -4,7 +4,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 { sveltePreprocess } from "svelte-preprocess";
 import fs from "node:fs";
 // import terser from "terser";
 import { minify } from "terser";

eslint.config.mjs

@@ -0,0 +1,100 @@
+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 path from "node:path";
+import { fileURLToPath } from "node:url";
+import js from "@eslint/js";
+import { FlatCompat } from "@eslint/eslintrc";
+
+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,
+});
+
+export default [
+    {
+        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/lib/apps/webpeer/dist",
+            "src/lib/apps/webpeer/svelte.config.js",
+        ],
+    },
+    ...compat.extends(
+        "eslint:recommended",
+        "plugin:@typescript-eslint/eslint-recommended",
+        "plugin:@typescript-eslint/recommended"
+    ),
+    {
+        plugins: {
+            "@typescript-eslint": typescriptEslint,
+            svelte,
+            import: fixupPluginRules(_import),
+        },
+
+        languageOptions: {
+            parser: tsParser,
+            ecmaVersion: 5,
+            sourceType: "module",
+
+            parserOptions: {
+                project: ["tsconfig.json"],
+            },
+        },
+
+        rules: {
+            "no-unused-vars": "off",
+
+            "@typescript-eslint/no-unused-vars": [
+                "error",
+                {
+                    args: "none",
+                },
+            ],
+
+            "no-unused-labels": "off",
+            "@typescript-eslint/ban-ts-comment": "off",
+            "no-prototype-builtins": "off",
+            "@typescript-eslint/no-empty-function": "off",
+            "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",
+
+            "no-constant-condition": [
+                "error",
+                {
+                    checkLoops: false,
+                },
+            ],
+        },
+    },
+];
+

manifest.json

@@ -1,7 +1,7 @@
 {
     "id": "obsidian-livesync",
     "name": "Self-hosted LiveSync",
-    "version": "0.24.13",
+    "version": "0.24.18",
     "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",

package.json

@@ -1,6 +1,6 @@
 {
     "name": "obsidian-livesync",
-    "version": "0.24.13",
+    "version": "0.24.18",
     "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",
@@ -22,6 +22,9 @@
     "license": "MIT",
     "devDependencies": {
         "@chialab/esbuild-plugin-worker": "^0.18.1",
+        "@eslint/compat": "^1.2.6",
+        "@eslint/eslintrc": "^3.2.0",
+        "@eslint/js": "^9.20.0",
         "@tsconfig/svelte": "^5.0.4",
         "@types/diff-match-patch": "^1.0.36",
         "@types/node": "^22.5.4",
@@ -33,17 +36,17 @@
         "@types/pouchdb-mapreduce": "^6.1.10",
         "@types/pouchdb-replication": "^6.4.7",
         "@types/transform-pouch": "^1.0.6",
-        "@typescript-eslint/eslint-plugin": "^8.23.0",
-        "@typescript-eslint/parser": "^8.23.0",
+        "@typescript-eslint/eslint-plugin": "^8.24.1",
+        "@typescript-eslint/parser": "^8.24.1",
         "builtin-modules": "^4.0.0",
         "esbuild": "0.24.2",
         "esbuild-svelte": "^0.9.0",
-        "eslint": "^8.57.0",
-        "eslint-config-airbnb-base": "^15.0.0",
+        "eslint": "^9.20.1",
         "eslint-plugin-import": "^2.31.0",
+        "eslint-plugin-svelte": "^2.46.1",
         "events": "^3.3.0",
         "obsidian": "^1.7.2",
-        "postcss": "^8.5.1",
+        "postcss": "^8.5.2",
         "postcss-load-config": "^6.0.1",
         "pouchdb-adapter-http": "^9.0.0",
         "pouchdb-adapter-idb": "^9.0.0",
@@ -55,10 +58,10 @@
         "pouchdb-merge": "^9.0.0",
         "pouchdb-replication": "^9.0.0",
         "pouchdb-utils": "^9.0.0",
-        "prettier": "^3.4.2",
-        "svelte": "^5.19.7",
+        "prettier": "^3.5.1",
+        "svelte": "^5.20.1",
         "svelte-preprocess": "^6.0.3",
-        "terser": "^5.37.0",
+        "terser": "^5.39.0",
         "transform-pouch": "^2.0.0",
         "tslib": "^2.8.1",
         "tsx": "^4.19.2",
@@ -74,9 +77,9 @@
         "fflate": "^0.8.2",
         "idb": "^8.0.2",
         "minimatch": "^10.0.1",
-        "octagonal-wheels": "^0.1.23",
+        "octagonal-wheels": "^0.1.24",
         "svelte-check": "^4.1.4",
-        "trystero": "^0.20.0",
+        "trystero": "^0.20.1",
         "xxhash-wasm-102": "npm:xxhash-wasm@^1.0.2"
     }
 }

src/common/events.ts

@@ -18,6 +18,8 @@ export const EVENT_REQUEST_OPEN_PLUGIN_SYNC_DIALOG = "request-open-plugin-sync-d
 export const EVENT_REQUEST_OPEN_P2P = "request-open-p2p";
 export const EVENT_REQUEST_CLOSE_P2P = "request-close-p2p";
 
+export const EVENT_REQUEST_RUN_DOCTOR = "request-run-doctor";
+
 // export const EVENT_FILE_CHANGED = "file-changed";
 
 declare global {
@@ -33,6 +35,7 @@ declare global {
         [EVENT_REQUEST_OPEN_P2P]: undefined;
         [EVENT_REQUEST_OPEN_SETUP_URI]: undefined;
         [EVENT_REQUEST_COPY_SETUP_URI]: undefined;
+        [EVENT_REQUEST_RUN_DOCTOR]: string;
     }
 }
 

src/common/utils.ts

@@ -30,6 +30,7 @@ import { sameChangePairs } from "./stores.ts";
 import type { KeyValueDatabase } from "./KeyValueDB.ts";
 import { scheduleTask } from "octagonal-wheels/concurrency/task";
 import { EVENT_PLUGIN_UNLOADED, eventHub } from "./events.ts";
+import { promiseWithResolver, type PromiseWithResolvers } from "octagonal-wheels/promises";
 
 export { scheduleTask, cancelTask, cancelAllTasks } from "../lib/src/concurrency/task.ts";
 
@@ -493,3 +494,47 @@ export function onlyInNTimes(n: number, proc: (progress: number) => any) {
         }
     };
 }
+
+const waitingTasks = {} as Record<string, { task?: PromiseWithResolvers<any>; previous: number; leastNext: number }>;
+
+export function rateLimitedSharedExecution<T>(key: string, interval: number, proc: () => Promise<T>): Promise<T> {
+    if (!(key in waitingTasks)) {
+        waitingTasks[key] = { task: undefined, previous: 0, leastNext: 0 };
+    }
+    if (waitingTasks[key].task) {
+        // Extend the previous execution time.
+        waitingTasks[key].leastNext = Date.now() + interval;
+        return waitingTasks[key].task.promise;
+    }
+
+    const previous = waitingTasks[key].previous;
+
+    const delay = previous == 0 ? 0 : Math.max(interval - (Date.now() - previous), 0);
+
+    const task = promiseWithResolver<T>();
+    void task.promise.finally(() => {
+        if (waitingTasks[key].task === task) {
+            waitingTasks[key].task = undefined;
+            waitingTasks[key].previous = Math.max(Date.now(), waitingTasks[key].leastNext);
+        }
+    });
+    waitingTasks[key] = {
+        task,
+        previous: Date.now(),
+        leastNext: Date.now() + interval,
+    };
+    void scheduleTask("thin-out-" + key, delay, async () => {
+        try {
+            task.resolve(await proc());
+        } catch (ex) {
+            task.reject(ex);
+        }
+    });
+    return task.promise;
+}
+export function updatePreviousExecutionTime(key: string, timeDelta: number = 0) {
+    if (!(key in waitingTasks)) {
+        waitingTasks[key] = { task: undefined, previous: 0, leastNext: 0 };
+    }
+    waitingTasks[key].leastNext = Math.max(Date.now() + timeDelta, waitingTasks[key].leastNext);
+}

src/features/HiddenFileCommon/JsonResolveModal.ts

@@ -2,13 +2,14 @@ import { App, Modal } from "../../deps.ts";
 import { type FilePath, type LoadedEntry } from "../../lib/src/common/types.ts";
 import JsonResolvePane from "./JsonResolvePane.svelte";
 import { waitForSignal } from "../../lib/src/common/utils.ts";
+import { mount, unmount } from "svelte";
 
 export class JsonResolveModal extends Modal {
     // result: Array<[number, string]>;
     filename: FilePath;
     callback?: (keepRev?: string, mergedStr?: string) => Promise<void>;
     docs: LoadedEntry[];
-    component?: JsonResolvePane;
+    component?: ReturnType<typeof mount>;
     nameA: string;
     nameB: string;
     defaultSelect: string;
@@ -55,7 +56,7 @@ export class JsonResolveModal extends Modal {
         contentEl.empty();
 
         if (this.component == undefined) {
-            this.component = new JsonResolvePane({
+            this.component = mount(JsonResolvePane, {
                 target: contentEl,
                 props: {
                     docs: this.docs,
@@ -81,7 +82,7 @@ export class JsonResolveModal extends Modal {
             void this.callback(undefined);
         }
         if (this.component != undefined) {
-            this.component.$destroy();
+            void unmount(this.component);
             this.component = undefined;
         }
     }

src/features/HiddenFileCommon/JsonResolvePane.svelte

@@ -2,29 +2,64 @@
     import { type Diff, DIFF_DELETE, DIFF_INSERT, diff_match_patch } from "../../deps.ts";
     import type { FilePath, LoadedEntry } from "../../lib/src/common/types.ts";
     import { decodeBinary, readString } from "../../lib/src/string_and_binary/convert.ts";
-    import { getDocData, mergeObject } from "../../lib/src/common/utils.ts";
+    import { getDocData, isObjectDifferent, mergeObject } from "../../lib/src/common/utils.ts";
 
-    export let docs: LoadedEntry[] = [];
-    export let callback: (keepRev?: string, mergedStr?: string) => Promise<void> = async (_, __) => {
-        Promise.resolve();
-    };
-    export let filename: FilePath = "" as FilePath;
-    export let nameA: string = "A";
-    export let nameB: string = "B";
-    export let defaultSelect: string = "";
-    export let keepOrder = false;
-    export let hideLocal: boolean = false;
-    let docA: LoadedEntry;
-    let docB: LoadedEntry;
-    let docAContent = "";
-    let docBContent = "";
-    let objA: any = {};
-    let objB: any = {};
-    let objAB: any = {};
-    let objBA: any = {};
-    let diffs: Diff[];
+    interface Props {
+        docs?: LoadedEntry[];
+        callback?: (keepRev?: string, mergedStr?: string) => Promise<void>;
+        filename?: FilePath;
+        nameA?: string;
+        nameB?: string;
+        defaultSelect?: string;
+        keepOrder?: boolean;
+        hideLocal?: boolean;
+    }
+
+    let {
+        docs = $bindable([]),
+        callback = $bindable((async (_, __) => {
+            Promise.resolve();
+        }) as (keepRev?: string, mergedStr?: string) => Promise<void>),
+        filename = $bindable("" as FilePath),
+        nameA = $bindable("A"),
+        nameB = $bindable("B"),
+        defaultSelect = $bindable("" as string),
+        keepOrder = $bindable(false),
+        hideLocal = $bindable(false),
+    }: Props = $props();
+    type JSONData = Record<string | number | symbol, any> | [any];
+
+    const docsArray = $derived.by(() => {
+        if (docs && docs.length >= 1) {
+            if (keepOrder || docs[0].mtime < docs[1].mtime) {
+                return { a: docs[0], b: docs[1] } as const;
+            } else {
+                return { a: docs[1], b: docs[0] } as const;
+            }
+        }
+        return { a: false, b: false } as const;
+    });
+    const docA = $derived(docsArray.a);
+    const docB = $derived(docsArray.b);
+    const docAContent = $derived(docA && docToString(docA));
+    const docBContent = $derived(docB && docToString(docB));
+
+    function parseJson(json: string | false) {
+        if (json === false) return false;
+        try {
+            return JSON.parse(json) as JSONData;
+        } catch (ex) {
+            return false;
+        }
+    }
+    const objA = $derived(parseJson(docAContent) || {});
+    const objB = $derived(parseJson(docBContent) || {});
+    const objAB = $derived(mergeObject(objA, objB));
+    const objBAw = $derived(mergeObject(objB, objA));
+    const objBA = $derived(isObjectDifferent(objBAw, objAB) ? objBAw : false);
+    let diffs: Diff[] = $derived.by(() => (objA && selectedObj ? getJsonDiff(objA, selectedObj) : []));
     type SelectModes = "" | "A" | "B" | "AB" | "BA";
-    let mode: SelectModes = defaultSelect as SelectModes;
+    let mode: SelectModes = $state(defaultSelect as SelectModes);
 
     function docToString(doc: LoadedEntry) {
         return doc.datatype == "plain" ? getDocData(doc.data) : readString(new Uint8Array(decodeBinary(doc.data)));
@@ -45,6 +80,7 @@
         return getDiff(JSON.stringify(a, null, 2), JSON.stringify(b, null, 2));
     }
     function apply() {
+        if (!docA || !docB) return;
         if (docA._id == docB._id) {
             if (mode == "A") return callback(docA._rev!, undefined);
             if (mode == "B") return callback(docB._rev!, undefined);
@@ -59,50 +95,23 @@
     function cancel() {
         callback(undefined, undefined);
     }
-    $: {
-        if (docs && docs.length >= 1) {
-            if (keepOrder || docs[0].mtime < docs[1].mtime) {
-                docA = docs[0];
-                docB = docs[1];
-            } else {
-                docA = docs[1];
-                docB = docs[0];
-            }
-            docAContent = docToString(docA);
-            docBContent = docToString(docB);
+    const mergedObjs = $derived.by(
+        () =>
+            ({
+                "": false,
+                A: objA,
+                B: objB,
+                AB: objAB,
+                BA: objBA,
+            }) as Record<SelectModes, JSONData | false>
+    );
 
-            try {
-                objA = false;
-                objB = false;
-                objA = JSON.parse(docAContent);
-                objB = JSON.parse(docBContent);
-                objAB = mergeObject(objA, objB);
-                objBA = mergeObject(objB, objA);
-                if (JSON.stringify(objAB) == JSON.stringify(objBA)) {
-                    objBA = false;
-                }
-            } catch (ex) {
-                objBA = false;
-                objAB = false;
-            }
-        }
-    }
-    $: mergedObjs = {
-        "": false,
-        A: objA,
-        B: objB,
-        AB: objAB,
-        BA: objBA,
-    };
+    let selectedObj = $derived(mode in mergedObjs ? mergedObjs[mode] : {});
 
-    $: selectedObj = mode in mergedObjs ? mergedObjs[mode] : {};
-    $: {
-        diffs = getJsonDiff(objA, selectedObj);
-    }
+    let modesSrc = $state([] as ["" | "A" | "B" | "AB" | "BA", string][]);
 
-    let modes = [] as ["" | "A" | "B" | "AB" | "BA", string][];
-    $: {
-        let newModes = [] as typeof modes;
+    const modes = $derived.by(() => {
+        let newModes = [] as typeof modesSrc;
 
         if (!hideLocal) {
             newModes.push(["", "Not now"]);
@@ -111,15 +120,15 @@
         newModes.push(["B", nameB || "B"]);
         newModes.push(["AB", `${nameA || "A"} + ${nameB || "B"}`]);
         newModes.push(["BA", `${nameB || "B"} + ${nameA || "A"}`]);
-        modes = newModes;
-    }
+        return newModes;
+    });
 </script>
 
 <h2>{filename}</h2>
 {#if !docA || !docB}
     <div class="message">Just for a minute, please!</div>
     <div class="buttons">
-        <button on:click={apply}>Dismiss</button>
+        <button onclick={apply}>Dismiss</button>
     </div>
 {:else}
     <div class="options">
@@ -148,39 +157,39 @@
     <div class="infos">
         <table>
             <tbody>
-            <tr>
-                <th>{nameA}</th>
-                <td
-                    >{#if docA._id == docB._id}
-                        Rev:{revStringToRevNumber(docA._rev)}
-                    {/if}
-                    {new Date(docA.mtime).toLocaleString()}</td
-                >
-                <td>
-                    {docAContent.length} letters
-                </td>
-            </tr>
-            <tr>
-                <th>{nameB}</th>
-                <td
-                    >{#if docA._id == docB._id}
-                        Rev:{revStringToRevNumber(docB._rev)}
-                    {/if}
-                    {new Date(docB.mtime).toLocaleString()}</td
-                >
-                <td>
-                    {docBContent.length} letters
-                </td>
-            </tr>
+                <tr>
+                    <th>{nameA}</th>
+                    <td
+                        >{#if docA._id == docB._id}
+                            Rev:{revStringToRevNumber(docA._rev)}
+                        {/if}
+                        {new Date(docA.mtime).toLocaleString()}</td
+                    >
+                    <td>
+                        {docAContent && docAContent.length} letters
+                    </td>
+                </tr>
+                <tr>
+                    <th>{nameB}</th>
+                    <td
+                        >{#if docA._id == docB._id}
+                            Rev:{revStringToRevNumber(docB._rev)}
+                        {/if}
+                        {new Date(docB.mtime).toLocaleString()}</td
+                    >
+                    <td>
+                        {docBContent && docBContent.length} letters
+                    </td>
+                </tr>
             </tbody>
         </table>
     </div>
 
     <div class="buttons">
         {#if hideLocal}
-            <button on:click={cancel}>Cancel</button>
+            <button onclick={cancel}>Cancel</button>
         {/if}
-        <button on:click={apply}>Apply</button>
+        <button onclick={apply}>Apply</button>
     </div>
 {/if}
 

src/features/HiddenFileSync/CmdHiddenFileSync.ts

@@ -701,7 +701,7 @@ Offline Changed files: ${processFiles.length}`;
                             ?.filter((e) => e.status == "available" && Number(e.rev.split("-")[0]) < conflictedRevNo)
                             .first()?.rev ?? "";
                     const result = await this.plugin.localDatabase.mergeObject(
-                        path,
+                        doc.path,
                         commonBase,
                         doc._rev,
                         conflictedRev

src/features/P2PSync/CmdP2PReplicator.ts

@@ -23,6 +23,7 @@ import { reactiveSource } from "octagonal-wheels/dataobject/reactive_v2";
 import type { Confirm } from "../../lib/src/interfaces/Confirm.ts";
 import type ObsidianLiveSyncPlugin from "../../main.ts";
 import type { SimpleStore } from "octagonal-wheels/databases/SimpleStoreBase";
+import { getPlatformName } from "../../lib/src/PlatformAPIs/obsidian/Environment.ts";
 
 class P2PReplicatorCommandBase extends LiveSyncCommands implements P2PReplicatorBase {
     storeP2PStatusLine = reactiveSource("");
@@ -79,6 +80,9 @@ export class P2PReplicator
         }
         return undefined!;
     }
+    override getPlatform(): string {
+        return getPlatformName();
+    }
 
     override onunload(): void {
         removeP2PReplicatorInstance();

src/features/P2PSync/P2PReplicator/P2PReplicatorPane.svelte

@@ -299,6 +299,8 @@
                                 placeholder="anything-you-like"
                                 bind:value={eRoomId}
                                 autocomplete="off"
+                                spellcheck="false"
+                                autocorrect="off"
                             />
                             <button onclick={() => chooseRandom()}> Use Random Number </button>
                         </label>
@@ -327,6 +329,12 @@
                         <label class={{ "is-dirty": isDeviceNameModified }}>
                             <input type="text" placeholder="iphone-16" bind:value={eDeviceName} autocomplete="off" />
                         </label>
+                        <span>
+                            <small>
+                                Device name to identify the device. Please use shorter one for the stable peer
+                                detection, i.e., "iphone-16" or "macbook-2021".
+                            </small>
+                        </span>
                     </td>
                 </tr>
                 <tr>

src/main.ts

@@ -570,6 +570,9 @@ export default class ObsidianLiveSyncPlugin
     $$replicate(showMessage: boolean = false): Promise<boolean | void> {
         throwShouldBeOverridden();
     }
+    $$replicateByEvent(showMessage: boolean = false): Promise<boolean | void> {
+        throwShouldBeOverridden();
+    }
 
     $everyOnDatabaseInitialized(showingNotice: boolean): Promise<boolean> {
         throwShouldBeOverridden();
@@ -636,10 +639,6 @@ export default class ObsidianLiveSyncPlugin
         throwShouldBeOverridden();
     }
 
-    $$waitForReplicationOnce(): Promise<boolean | void> {
-        throwShouldBeOverridden();
-    }
-
     $$resetLocalDatabase(): Promise<void> {
         throwShouldBeOverridden();
     }

src/modules/core/ModuleFileHandler.ts

@@ -297,7 +297,7 @@ export class ModuleFileHandler extends AbstractModule implements ICoreModule {
         }
         await this.storage.ensureDir(path);
         const ret = await this.storage.writeFileAuto(path, docData, { ctime: docRead.ctime, mtime: docRead.mtime });
-        this.storage.touched(path);
+        await this.storage.touched(path);
         this.storage.triggerFileEvent(mode, path);
         return ret;
     }

src/modules/core/ModuleReplicator.ts

@@ -18,17 +18,27 @@ import {
     type MetaEntry,
 } from "../../lib/src/common/types";
 import { QueueProcessor } from "octagonal-wheels/concurrency/processor";
-import { getPath, isChunk, isValidPath, scheduleTask } from "../../common/utils";
+import {
+    getPath,
+    isChunk,
+    isValidPath,
+    rateLimitedSharedExecution,
+    scheduleTask,
+    updatePreviousExecutionTime,
+} from "../../common/utils";
 import { isAnyNote } from "../../lib/src/common/utils";
 import { EVENT_FILE_SAVED, eventHub } from "../../common/events";
 import type { LiveSyncAbstractReplicator } from "../../lib/src/replication/LiveSyncAbstractReplicator";
 import { globalSlipBoard } from "../../lib/src/bureau/bureau";
+import { $msg } from "../../lib/src/common/i18n";
 
+const KEY_REPLICATION_ON_EVENT = "replicationOnEvent";
+const REPLICATION_ON_EVENT_FORECASTED_TIME = 5000;
 export class ModuleReplicator extends AbstractModule implements ICoreModule {
     $everyOnloadAfterLoadSettings(): Promise<boolean> {
         eventHub.onEvent(EVENT_FILE_SAVED, () => {
             if (this.settings.syncOnSave && !this.core.$$isSuspended()) {
-                scheduleTask("perform-replicate-after-save", 250, () => this.core.$$waitForReplicationOnce());
+                scheduleTask("perform-replicate-after-save", 250, () => this.core.$$replicateByEvent());
             }
         });
         return Promise.resolve(true);
@@ -37,7 +47,7 @@ export class ModuleReplicator extends AbstractModule implements ICoreModule {
     async setReplicator() {
         const replicator = await this.core.$anyNewReplicator();
         if (!replicator) {
-            this._log("No replicator is available, this is the fatal error.", LOG_LEVEL_NOTICE);
+            this._log($msg("Replicator.Message.InitialiseFatalError"), LOG_LEVEL_NOTICE);
             return false;
         }
         this.core.replicator = replicator;
@@ -61,23 +71,91 @@ export class ModuleReplicator extends AbstractModule implements ICoreModule {
         await this.loadQueuedFiles();
         return true;
     }
+
     async $$replicate(showMessage: boolean = false): Promise<boolean | void> {
+        try {
+            updatePreviousExecutionTime(KEY_REPLICATION_ON_EVENT, REPLICATION_ON_EVENT_FORECASTED_TIME);
+            return await this.$$_replicate(showMessage);
+        } finally {
+            updatePreviousExecutionTime(KEY_REPLICATION_ON_EVENT);
+        }
+    }
+
+    /**
+     * obsolete method. No longer maintained and will be removed in the future.
+     * @deprecated v0.24.17
+     * @param showMessage If true, show message to the user.
+     */
+    async cleaned(showMessage: boolean) {
+        Logger(`The remote database has been cleaned.`, showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO);
+        await skipIfDuplicated("cleanup", async () => {
+            const count = await purgeUnreferencedChunks(this.localDatabase.localDatabase, true);
+            const message = `The remote database has been cleaned up.
+To synchronize, this device must be also cleaned up. ${count} chunk(s) will be erased from this device.
+However, If there are many chunks to be deleted, maybe fetching again is faster.
+We will lose the history of this device if we fetch the remote database again.
+Even if you choose to clean up, you will see this option again if you exit Obsidian and then synchronise again.`;
+            const CHOICE_FETCH = "Fetch again";
+            const CHOICE_CLEAN = "Cleanup";
+            const CHOICE_DISMISS = "Dismiss";
+            const ret = await this.core.confirm.confirmWithMessage(
+                "Cleaned",
+                message,
+                [CHOICE_FETCH, CHOICE_CLEAN, CHOICE_DISMISS],
+                CHOICE_DISMISS,
+                30
+            );
+            if (ret == CHOICE_FETCH) {
+                await this.core.rebuilder.$performRebuildDB("localOnly");
+            }
+            if (ret == CHOICE_CLEAN) {
+                const replicator = this.core.$$getReplicator();
+                if (!(replicator instanceof LiveSyncCouchDBReplicator)) return;
+                const remoteDB = await replicator.connectRemoteCouchDBWithSetting(
+                    this.settings,
+                    this.core.$$isMobile(),
+                    true
+                );
+                if (typeof remoteDB == "string") {
+                    Logger(remoteDB, LOG_LEVEL_NOTICE);
+                    return false;
+                }
+
+                await purgeUnreferencedChunks(this.localDatabase.localDatabase, false);
+                this.localDatabase.hashCaches.clear();
+                // Perform the synchronisation once.
+                if (await this.core.replicator.openReplication(this.settings, false, showMessage, true)) {
+                    await balanceChunkPurgedDBs(this.localDatabase.localDatabase, remoteDB.db);
+                    await purgeUnreferencedChunks(this.localDatabase.localDatabase, false);
+                    this.localDatabase.hashCaches.clear();
+                    await this.core.$$getReplicator().markRemoteResolved(this.settings);
+                    Logger("The local database has been cleaned up.", showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO);
+                } else {
+                    Logger(
+                        "Replication has been cancelled. Please try it again.",
+                        showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO
+                    );
+                }
+            }
+        });
+    }
+    async $$_replicate(showMessage: boolean = false): Promise<boolean | void> {
         //--?
         if (!this.core.$$isReady()) return;
         if (isLockAcquired("cleanup")) {
-            Logger("Database cleaning up is in process. replication has been cancelled", LOG_LEVEL_NOTICE);
+            Logger($msg("Replicator.Message.Cleaned"), LOG_LEVEL_NOTICE);
             return;
         }
         if (this.settings.versionUpFlash != "") {
-            Logger("Open settings and check message, please. replication has been cancelled.", LOG_LEVEL_NOTICE);
+            Logger($msg("Replicator.Message.VersionUpFlash"), LOG_LEVEL_NOTICE);
             return;
         }
         if (!(await this.core.$everyCommitPendingFileEvent())) {
-            Logger("Some file events are pending. Replication has been cancelled.", LOG_LEVEL_NOTICE);
+            Logger($msg("Replicator.Message.Pending"), LOG_LEVEL_NOTICE);
             return false;
         }
         if (!(await this.core.$everyBeforeReplicate(showMessage))) {
-            Logger(`Replication has been cancelled by some module failure`, LOG_LEVEL_NOTICE);
+            Logger($msg("Replicator.Message.SomeModuleFailed"), LOG_LEVEL_NOTICE);
             return false;
         }
 
@@ -89,109 +167,47 @@ export class ModuleReplicator extends AbstractModule implements ICoreModule {
             } else {
                 if (this.core.replicator?.remoteLockedAndDeviceNotAccepted) {
                     if (this.core.replicator.remoteCleaned && this.settings.useIndexedDBAdapter) {
-                        Logger(
-                            `The remote database has been cleaned.`,
-                            showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO
-                        );
-                        await skipIfDuplicated("cleanup", async () => {
-                            const count = await purgeUnreferencedChunks(this.localDatabase.localDatabase, true);
-                            const message = `The remote database has been cleaned up.
-To synchronize, this device must be also cleaned up. ${count} chunk(s) will be erased from this device.
-However, If there are many chunks to be deleted, maybe fetching again is faster.
-We will lose the history of this device if we fetch the remote database again.
-Even if you choose to clean up, you will see this option again if you exit Obsidian and then synchronise again.`;
-                            const CHOICE_FETCH = "Fetch again";
-                            const CHOICE_CLEAN = "Cleanup";
-                            const CHOICE_DISMISS = "Dismiss";
-                            const ret = await this.core.confirm.confirmWithMessage(
-                                "Cleaned",
-                                message,
-                                [CHOICE_FETCH, CHOICE_CLEAN, CHOICE_DISMISS],
-                                CHOICE_DISMISS,
-                                30
-                            );
-                            if (ret == CHOICE_FETCH) {
-                                await this.core.rebuilder.$performRebuildDB("localOnly");
-                            }
-                            if (ret == CHOICE_CLEAN) {
-                                const replicator = this.core.$$getReplicator();
-                                if (!(replicator instanceof LiveSyncCouchDBReplicator)) return;
-                                const remoteDB = await replicator.connectRemoteCouchDBWithSetting(
-                                    this.settings,
-                                    this.core.$$isMobile(),
-                                    true
-                                );
-                                if (typeof remoteDB == "string") {
-                                    Logger(remoteDB, LOG_LEVEL_NOTICE);
-                                    return false;
-                                }
-
-                                await purgeUnreferencedChunks(this.localDatabase.localDatabase, false);
-                                this.localDatabase.hashCaches.clear();
-                                // Perform the synchronisation once.
-                                if (
-                                    await this.core.replicator.openReplication(this.settings, false, showMessage, true)
-                                ) {
-                                    await balanceChunkPurgedDBs(this.localDatabase.localDatabase, remoteDB.db);
-                                    await purgeUnreferencedChunks(this.localDatabase.localDatabase, false);
-                                    this.localDatabase.hashCaches.clear();
-                                    await this.core.$$getReplicator().markRemoteResolved(this.settings);
-                                    Logger(
-                                        "The local database has been cleaned up.",
-                                        showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO
-                                    );
-                                } else {
-                                    Logger(
-                                        "Replication has been cancelled. Please try it again.",
-                                        showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO
-                                    );
-                                }
-                            }
-                        });
+                        await this.cleaned(showMessage);
                     } else {
-                        const message = `
-The remote database has been rebuilt.
-To synchronize, this device must fetch everything again once.
-Or if you are sure know what had been happened, we can unlock the database from the setting dialog.
-                    `;
-                        const CHOICE_FETCH = "Fetch again";
-                        const CHOICE_DISMISS = "Dismiss";
-                        const ret = await this.core.confirm.confirmWithMessage(
-                            "Locked",
+                        const message = $msg("Replicator.Dialogue.Locked.Message");
+                        const CHOICE_FETCH = $msg("Replicator.Dialogue.Locked.Action.Fetch");
+                        const CHOICE_DISMISS = $msg("Replicator.Dialogue.Locked.Action.Dismiss");
+                        const CHOICE_UNLOCK = $msg("Replicator.Dialogue.Locked.Action.Unlock");
+                        const ret = await this.core.confirm.askSelectStringDialogue(
                             message,
-                            [CHOICE_FETCH, CHOICE_DISMISS],
-                            CHOICE_DISMISS,
-                            10
+                            [CHOICE_FETCH, CHOICE_UNLOCK, CHOICE_DISMISS],
+                            {
+                                title: $msg("Replicator.Dialogue.Locked.Title"),
+                                defaultAction: CHOICE_DISMISS,
+                                timeout: 60,
+                            }
                         );
                         if (ret == CHOICE_FETCH) {
-                            const CHOICE_RESTART = "Restart";
-                            const CHOICE_WITHOUT_RESTART = "Without restart";
-                            if (
-                                (await this.core.confirm.askSelectStringDialogue(
-                                    "Self-hosted LiveSync restarts Obsidian to fetch everything safely. However, you can do it without restarting. Please choose one.",
-                                    [CHOICE_RESTART, CHOICE_WITHOUT_RESTART],
-                                    {
-                                        title: "Fetch again",
-                                        defaultAction: CHOICE_RESTART,
-                                        timeout: 30,
-                                    }
-                                )) == CHOICE_RESTART
-                            ) {
-                                await this.core.rebuilder.scheduleFetch();
-                                // await this.core.$$scheduleAppReload();
-                                return;
-                            } else {
-                                await this.core.rebuilder.$performRebuildDB("localOnly");
-                            }
+                            this._log($msg("Replicator.Dialogue.Locked.Message.Fetch"), LOG_LEVEL_NOTICE);
+                            await this.core.rebuilder.scheduleFetch();
+                            this.core.$$scheduleAppReload();
+                            return;
+                        } else if (ret == CHOICE_UNLOCK) {
+                            await this.core.replicator.markRemoteResolved(this.settings);
+                            this._log($msg("Replicator.Dialogue.Locked.Message.Unlocked"), LOG_LEVEL_NOTICE);
+                            return;
                         }
                     }
                 }
             }
         }
-
         return ret;
     }
 
+    async $$replicateByEvent(): Promise<boolean | void> {
+        const least = this.settings.syncMinimumInterval;
+        if (least > 0) {
+            return rateLimitedSharedExecution(KEY_REPLICATION_ON_EVENT, least, async () => {
+                return await this.$$replicate();
+            });
+        }
+        return await shareRunningResult(`replication`, () => this.core.$$replicate());
+    }
     $$parseReplicationResult(docs: Array<PouchDB.Core.ExistingDocument<EntryDoc>>): void {
         if (this.settings.suspendParseReplicationResult && !this.replicationResultProcessor.isSuspended) {
             this.replicationResultProcessor.suspend();
@@ -387,7 +403,7 @@ Or if you are sure know what had been happened, we can unlock the database from
     ): Promise<boolean> {
         if (!this.core.$$isReady()) return false;
         if (!(await this.core.$everyBeforeReplicate(showingNotice))) {
-            Logger(`Replication has been cancelled by some module failure`, LOG_LEVEL_NOTICE);
+            Logger($msg("Replicator.Message.SomeModuleFailed"), LOG_LEVEL_NOTICE);
             return false;
         }
         if (!sendChunksInBulkDisabled) {
@@ -416,8 +432,4 @@ Or if you are sure know what had been happened, we can unlock the database from
         if (checkResult == "CHECKAGAIN") return await this.core.$$replicateAllFromServer(showingNotice);
         return !checkResult;
     }
-
-    async $$waitForReplicationOnce(): Promise<boolean | void> {
-        return await shareRunningResult(`replication`, () => this.core.$$replicate());
-    }
 }

src/modules/coreFeatures/ModuleConflictResolver.ts

@@ -140,7 +140,7 @@ export class ModuleConflictResolver extends AbstractModule implements ICoreModul
                 //auto resolved, but need check again;
                 if (this.settings.syncAfterMerge && !this.core.$$isSuspended()) {
                     //Wait for the running replication, if not running replication, run it once.
-                    await this.core.$$waitForReplicationOnce();
+                    await this.core.$$replicateByEvent();
                 }
                 this._log("[conflict] Automatically merged, but we have to check it again");
                 await this.core.$$queueConflictCheck(filename);

src/modules/coreFeatures/ModuleResolveMismatchedTweaks.ts

@@ -2,14 +2,17 @@ import { Logger, LOG_LEVEL_NOTICE } from "octagonal-wheels/common/logger";
 import { extractObject } from "octagonal-wheels/object";
 import {
     TweakValuesShouldMatchedTemplate,
-    CompatibilityBreakingTweakValues,
+    IncompatibleChanges,
     confName,
     type TweakValues,
     type RemoteDBSettings,
+    IncompatibleChangesInSpecificPattern,
+    CompatibleButLossyChanges,
 } from "../../lib/src/common/types.ts";
 import { escapeMarkdownValue } from "../../lib/src/common/utils.ts";
 import { AbstractModule } from "../AbstractModule.ts";
 import type { ICoreModule } from "../ModuleTypes.ts";
+import { $msg } from "../../lib/src/common/i18n.ts";
 
 export class ModuleResolvingMismatchedTweaks extends AbstractModule implements ICoreModule {
     async $anyAfterConnectCheckFailed(): Promise<boolean | "CHECKAGAIN" | undefined> {
@@ -28,65 +31,100 @@ export class ModuleResolvingMismatchedTweaks extends AbstractModule implements I
         const mine = extractObject(TweakValuesShouldMatchedTemplate, this.settings);
         const items = Object.entries(TweakValuesShouldMatchedTemplate);
         let rebuildRequired = false;
-
+        let rebuildRecommended = false;
         // Making tables:
-        let table = `| Value name | This device | Configured | \n` + `|: --- |: --- :|: ---- :| \n`;
-
+        // let table = `| Value name | This device | Configured | \n` + `|: --- |: --- :|: ---- :| \n`;
+        const tableRows = [];
         // const items = [mine,preferred]
         for (const v of items) {
             const key = v[0] as keyof typeof TweakValuesShouldMatchedTemplate;
             const valueMine = escapeMarkdownValue(mine[key]);
             const valuePreferred = escapeMarkdownValue(preferred[key]);
             if (valueMine == valuePreferred) continue;
-            if (CompatibilityBreakingTweakValues.indexOf(key) !== -1) {
+            if (IncompatibleChanges.indexOf(key) !== -1) {
                 rebuildRequired = true;
             }
-            table += `| ${confName(key)} | ${valueMine} | ${valuePreferred} | \n`;
+            for (const pattern of IncompatibleChangesInSpecificPattern) {
+                if (pattern.key !== key) continue;
+                // if from value supplied, check if current value have been violated : in other words, if the current value is the same as the from value, it should require a rebuild.
+                const isFromConditionMet = "from" in pattern ? pattern.from === mine[key] : false;
+                // and, if to value supplied, same as above.
+                const isToConditionMet = "to" in pattern ? pattern.to === preferred[key] : false;
+                // if either of them is true, it should require a rebuild, if the pattern is not a recommendation.
+                if (isFromConditionMet || isToConditionMet) {
+                    if (pattern.isRecommendation) {
+                        rebuildRecommended = true;
+                    } else {
+                        rebuildRequired = true;
+                    }
+                }
+            }
+            if (CompatibleButLossyChanges.indexOf(key) !== -1) {
+                rebuildRecommended = true;
+            }
+
+            // table += `| ${confName(key)} | ${valueMine} | ${valuePreferred} | \n`;
+            tableRows.push(
+                $msg("TweakMismatchResolve.Table.Row", {
+                    name: confName(key),
+                    self: valueMine,
+                    remote: valuePreferred,
+                })
+            );
         }
 
-        const additionalMessage = rebuildRequired
-            ? `
+        const additionalMessage =
+            rebuildRequired && this.core.settings.isConfigured
+                ? $msg("TweakMismatchResolve.Message.WarningIncompatibleRebuildRequired")
+                : "";
+        const additionalMessage2 =
+            rebuildRecommended && this.core.settings.isConfigured
+                ? $msg("TweakMismatchResolve.Message.WarningIncompatibleRebuildRecommended")
+                : "";
 
-**Note**: We have detected that some of the values are different to make incompatible the local database with the remote database.
-If you choose to use the configured values, the local database will be rebuilt, and if you choose to use the values of this device, the remote database will be rebuilt. 
-Both of them takes a few minutes. Please choose after considering the situation.`
-            : "";
+        const table = $msg("TweakMismatchResolve.Table", { rows: tableRows.join("\n") });
 
-        const message = `
-Your configuration has not been matched with the one on the remote server.
-(Which you had decided once before, or set by initially synchronised device).
+        const message = $msg("TweakMismatchResolve.Message.MainTweakResolving", {
+            table: table,
+            additionalMessage: [additionalMessage, additionalMessage2].filter((v) => v).join("\n"),
+        });
 
-Configured values:
+        const CHOICE_USE_REMOTE = $msg("TweakMismatchResolve.Action.UseRemote");
+        const CHOICE_USE_REMOTE_WITH_REBUILD = $msg("TweakMismatchResolve.Action.UseRemoteWithRebuild");
+        const CHOICE_USE_REMOTE_PREVENT_REBUILD = $msg("TweakMismatchResolve.Action.UseRemoteAcceptIncompatible");
+        const CHOICE_USE_MINE = $msg("TweakMismatchResolve.Action.UseMine");
+        const CHOICE_USE_MINE_WITH_REBUILD = $msg("TweakMismatchResolve.Action.UseMineWithRebuild");
+        const CHOICE_USE_MINE_PREVENT_REBUILD = $msg("TweakMismatchResolve.Action.UseMineAcceptIncompatible");
+        const CHOICE_DISMISS = $msg("TweakMismatchResolve.Action.Dismiss");
 
-${table}
+        const CHOICE_AND_VALUES = [] as [string, [result: TweakValues | boolean, rebuild: boolean]][];
 
-Please select which one you want to use.
-
-- Use configured: Update settings of this device by configured one on the remote server.
-  You should select this if you have changed the settings on ** another device **.
-- Update with mine: Update settings on the remote server by the settings of this device.
-  You should select this if you have changed the settings on ** this device **.
-- Dismiss: Ignore this message and keep the current settings.
-  You cannot synchronise until you resolve this issue without enabling \`Do not check configuration mismatch before replication\`.${additionalMessage}`;
-
-        const CHOICE_USE_REMOTE = "Use configured";
-        const CHOICE_USR_MINE = "Update with mine";
-        const CHOICE_DISMISS = "Dismiss";
-        const CHOICE_AND_VALUES = [
-            [CHOICE_USE_REMOTE, preferred],
-            [CHOICE_USR_MINE, true],
-            [CHOICE_DISMISS, false],
-        ];
-        const CHOICES = Object.fromEntries(CHOICE_AND_VALUES) as Record<string, TweakValues | boolean>;
-        const retKey = await this.core.confirm.confirmWithMessage(
-            "Tweaks Mismatched or Changed",
-            message,
-            Object.keys(CHOICES),
-            CHOICE_DISMISS,
-            60
-        );
+        if (rebuildRequired) {
+            CHOICE_AND_VALUES.push([CHOICE_USE_REMOTE_WITH_REBUILD, [preferred, true]]);
+            CHOICE_AND_VALUES.push([CHOICE_USE_MINE_WITH_REBUILD, [true, true]]);
+            CHOICE_AND_VALUES.push([CHOICE_USE_REMOTE_PREVENT_REBUILD, [preferred, false]]);
+            CHOICE_AND_VALUES.push([CHOICE_USE_MINE_PREVENT_REBUILD, [true, false]]);
+        } else if (rebuildRecommended) {
+            CHOICE_AND_VALUES.push([CHOICE_USE_REMOTE, [preferred, false]]);
+            CHOICE_AND_VALUES.push([CHOICE_USE_MINE, [true, false]]);
+            CHOICE_AND_VALUES.push([CHOICE_USE_REMOTE_WITH_REBUILD, [true, true]]);
+            CHOICE_AND_VALUES.push([CHOICE_USE_MINE_WITH_REBUILD, [true, true]]);
+        } else {
+            CHOICE_AND_VALUES.push([CHOICE_USE_REMOTE, [preferred, false]]);
+            CHOICE_AND_VALUES.push([CHOICE_USE_MINE, [true, false]]);
+        }
+        CHOICE_AND_VALUES.push([CHOICE_DISMISS, [false, false]]);
+        const CHOICES = Object.fromEntries(CHOICE_AND_VALUES) as Record<
+            string,
+            [TweakValues | boolean, performRebuild: boolean]
+        >;
+        const retKey = await this.core.confirm.askSelectStringDialogue(message, Object.keys(CHOICES), {
+            title: $msg("TweakMismatchResolve.Title.TweakResolving"),
+            timeout: 60,
+            defaultAction: CHOICE_DISMISS,
+        });
         if (!retKey) return [false, false];
-        return [CHOICES[retKey], rebuildRequired];
+        return CHOICES[retKey];
     }
 
     async $$askResolvingMismatchedTweaks(): Promise<"OK" | "CHECKAGAIN" | "IGNORE"> {
@@ -143,28 +181,56 @@ Please select which one you want to use.
             return { result: false, requireFetch: false };
         }
     }
+
     async $$askUseRemoteConfiguration(
         trialSetting: RemoteDBSettings,
         preferred: TweakValues
     ): Promise<{ result: false | TweakValues; requireFetch: boolean }> {
         const items = Object.entries(TweakValuesShouldMatchedTemplate);
         let rebuildRequired = false;
+        let rebuildRecommended = false;
         // Making tables:
-        let table = `| Value name | This device | Stored | \n` + `|: --- |: ---- :|: ---- :| \n`;
+        // let table = `| Value name | This device | On Remote | \n` + `|: --- |: ---- :|: ---- :| \n`;
         let differenceCount = 0;
+        const tableRows = [] as string[];
         // const items = [mine,preferred]
         for (const v of items) {
             const key = v[0] as keyof typeof TweakValuesShouldMatchedTemplate;
-            const valuePreferred = escapeMarkdownValue(preferred[key]);
-            const currentDisp = `${escapeMarkdownValue((trialSetting as TweakValues)?.[key])} |`;
+            const remoteValueForDisplay = escapeMarkdownValue(preferred[key]);
+            const currentValueForDisplay = `${escapeMarkdownValue((trialSetting as TweakValues)?.[key])}`;
             if ((trialSetting as TweakValues)?.[key] !== preferred[key]) {
-                if (CompatibilityBreakingTweakValues.indexOf(key) !== -1) {
+                if (IncompatibleChanges.indexOf(key) !== -1) {
                     rebuildRequired = true;
                 }
+                for (const pattern of IncompatibleChangesInSpecificPattern) {
+                    if (pattern.key !== key) continue;
+                    // if from value supplied, check if current value have been violated : in other words, if the current value is the same as the from value, it should require a rebuild.
+                    const isFromConditionMet =
+                        "from" in pattern ? pattern.from === (trialSetting as TweakValues)?.[key] : false;
+                    // and, if to value supplied, same as above.
+                    const isToConditionMet = "to" in pattern ? pattern.to === preferred[key] : false;
+                    // if either of them is true, it should require a rebuild, if the pattern is not a recommendation.
+                    if (isFromConditionMet || isToConditionMet) {
+                        if (pattern.isRecommendation) {
+                            rebuildRecommended = true;
+                        } else {
+                            rebuildRequired = true;
+                        }
+                    }
+                }
+                if (CompatibleButLossyChanges.indexOf(key) !== -1) {
+                    rebuildRecommended = true;
+                }
             } else {
                 continue;
             }
-            table += `| ${confName(key)} | ${currentDisp} ${valuePreferred} | \n`;
+            tableRows.push(
+                $msg("TweakMismatchResolve.Table.Row", {
+                    name: confName(key),
+                    self: currentValueForDisplay,
+                    remote: remoteValueForDisplay,
+                })
+            );
             differenceCount++;
         }
 
@@ -174,33 +240,28 @@ Please select which one you want to use.
         }
         const additionalMessage =
             rebuildRequired && this.core.settings.isConfigured
-                ? `
-
->[!WARNING]
-> Some remote configurations are not compatible with the local database of this device. Rebuilding the local database will be required.
-***Please ensure that you have time and are connected to a stable network to apply!***`
+                ? $msg("TweakMismatchResolve.Message.UseRemote.WarningRebuildRequired")
+                : "";
+        const additionalMessage2 =
+            rebuildRecommended && this.core.settings.isConfigured
+                ? $msg("TweakMismatchResolve.Message.UseRemote.WarningRebuildRecommended")
                 : "";
 
-        const message = `
-The settings in the remote database are as follows.
-If you want to use these settings, please select "Use configured".
-If you want to keep the settings of this device, please select "Dismiss".
+        const table = $msg("TweakMismatchResolve.Table", { rows: tableRows.join("\n") });
 
-${table}
+        const message = $msg("TweakMismatchResolve.Message.Main", {
+            table: table,
+            additionalMessage: [additionalMessage, additionalMessage2].filter((v) => v).join("\n"),
+        });
 
->[!TIP]
-> If you want to synchronise all settings, please use \`Sync settings via markdown\` after applying minimal configuration with this feature.
-
-${additionalMessage}`;
-
-        const CHOICE_USE_REMOTE = "Use configured";
-        const CHOICE_DISMISS = "Dismiss";
+        const CHOICE_USE_REMOTE = $msg("TweakMismatchResolve.Action.UseConfigured");
+        const CHOICE_DISMISS = $msg("TweakMismatchResolve.Action.Dismiss");
         // const CHOICE_AND_VALUES = [
         //     [CHOICE_USE_REMOTE, preferred],
         //     [CHOICE_DISMISS, false]]
         const CHOICES = [CHOICE_USE_REMOTE, CHOICE_DISMISS];
         const retKey = await this.core.confirm.askSelectStringDialogue(message, CHOICES, {
-            title: "Use Remote Configuration",
+            title: $msg("TweakMismatchResolve.Title.UseRemoteConfig"),
             timeout: 0,
             defaultAction: CHOICE_DISMISS,
         });

src/modules/coreObsidian/ModuleFileAccessObsidian.ts

@@ -1,4 +1,4 @@
-import { normalizePath, TFile, TFolder, type ListedFiles } from "obsidian";
+import { TFile, TFolder, type ListedFiles } from "obsidian";
 import { SerializedFileAccess } from "./storageLib/SerializedFileAccess";
 import { AbstractObsidianModule, type IObsidianModule } from "../AbstractObsidianModule.ts";
 import { LOG_LEVEL_INFO, LOG_LEVEL_VERBOSE } from "octagonal-wheels/common/logger";
@@ -60,7 +60,23 @@ export class ModuleFileAccessObsidian extends AbstractObsidianModule implements
         if (file instanceof TFile) {
             return this.vaultAccess.vaultModify(file, data, opt);
         } else if (file === null) {
-            return (await this.vaultAccess.vaultCreate(path, data, opt)) instanceof TFile;
+            if (!path.endsWith(".md")) {
+                // Very rare case, we encountered this case with `writing-goals-history.csv` file.
+                // Indeed, that file not appears in the File Explorer, but it exists in the vault.
+                // Hence, we cannot retrieve the file from the vault by getAbstractFileByPath, and we cannot write it via vaultModify.
+                // It makes `File already exists` error.
+                // Therefore, we need to write it via adapterWrite.
+                // Maybe there are others like this, so I will write it via adapterWrite.
+                // This is a workaround for the issue, but I don't know if this is the right solution.
+                // (So limits to non-md files).
+                // Has Obsidian been patched?, anyway, writing directly might be a safer approach.
+                // However, does changes of that file trigger file-change event?
+                await this.vaultAccess.adapterWrite(path, data, opt);
+                // For safety, check existence
+                return await this.vaultAccess.adapterExists(path);
+            } else {
+                return (await this.vaultAccess.vaultCreate(path, data, opt)) instanceof TFile;
+            }
         } else {
             this._log(`Could not write file (Possibly already exists as a folder): ${path}`, LOG_LEVEL_VERBOSE);
             return false;
@@ -158,8 +174,9 @@ export class ModuleFileAccessObsidian extends AbstractObsidianModule implements
         }
     }
     triggerFileEvent(event: string, path: string): void {
-        // this.app.vault.trigger("file-change", path);
-        this.vaultAccess.trigger(event, this.vaultAccess.getAbstractFileByPath(normalizePath(path)));
+        const file = this.vaultAccess.getAbstractFileByPath(path);
+        if (file === null) return;
+        this.vaultAccess.trigger(event, file);
     }
     async triggerHiddenFile(path: string): Promise<void> {
         //@ts-ignore internal function
@@ -258,9 +275,9 @@ export class ModuleFileAccessObsidian extends AbstractObsidianModule implements
         }
         return files as FilePath[];
     }
-    touched(file: UXFileInfoStub | FilePathWithPrefix): void {
+    async touched(file: UXFileInfoStub | FilePathWithPrefix): Promise<void> {
         const path = typeof file === "string" ? file : file.path;
-        this.vaultAccess.touch(path as FilePath);
+        await this.vaultAccess.touch(path as FilePath);
     }
     recentlyTouched(file: UXFileInfoStub | FilePathWithPrefix): boolean {
         const xFile = typeof file === "string" ? (this.vaultAccess.getAbstractFileByPath(file) as TFile) : file;

src/modules/coreObsidian/storageLib/SerializedFileAccess.ts

@@ -199,9 +199,15 @@ export class SerializedFileAccess {
 
     touchedFiles: string[] = [];
 
-    touch(file: TFile | FilePath) {
-        const f = file instanceof TFile ? file : (this.getAbstractFileByPath(file) as TFile);
-        const key = `${f.path}-${f.stat.mtime}-${f.stat.size}`;
+    _statInternal(file: FilePath) {
+        return this.app.vault.adapter.stat(file);
+    }
+
+    async touch(file: TFile | FilePath) {
+        const path = file instanceof TFile ? (file.path as FilePath) : file;
+        const statOrg = file instanceof TFile ? file.stat : await this._statInternal(path);
+        const stat = statOrg || { mtime: 0, size: 0 };
+        const key = `${path}-${stat.mtime}-${stat.size}`;
         this.touchedFiles.unshift(key);
         this.touchedFiles = this.touchedFiles.slice(0, 100);
     }

src/modules/essential/ModuleMigration.ts

@@ -1,17 +1,144 @@
 import { LOG_LEVEL_INFO, LOG_LEVEL_NOTICE, LOG_LEVEL_VERBOSE } from "octagonal-wheels/common/logger.js";
-import { SETTING_VERSION_SUPPORT_CASE_INSENSITIVE } from "../../lib/src/common/types.js";
+import { type ObsidianLiveSyncSettings } from "../../lib/src/common/types.js";
 import {
     EVENT_REQUEST_OPEN_P2P,
     EVENT_REQUEST_OPEN_SETTING_WIZARD,
     EVENT_REQUEST_OPEN_SETTINGS,
     EVENT_REQUEST_OPEN_SETUP_URI,
+    EVENT_REQUEST_RUN_DOCTOR,
     eventHub,
 } from "../../common/events.ts";
 import { AbstractModule } from "../AbstractModule.ts";
 import type { ICoreModule } from "../ModuleTypes.ts";
 import { $msg } from "src/lib/src/common/i18n.ts";
+import { checkUnsuitableValues, RuleLevel, type RuleForType } from "../../lib/src/common/configForDoc.ts";
+import { getConfName, type AllSettingItemKey } from "../features/SettingDialogue/settingConstants.ts";
 
 export class ModuleMigration extends AbstractModule implements ICoreModule {
+    async migrateUsingDoctor(skipRebuild: boolean = false, activateReason = "updated", forceRescan = false) {
+        const r = checkUnsuitableValues(this.core.settings);
+        if (!forceRescan && r.version == this.settings.doctorProcessedVersion) {
+            const isIssueFound = Object.keys(r.rules).length > 0;
+            const msg = isIssueFound ? "Issues found" : "No issues found";
+            this._log(`${msg} but marked as to be silent`, LOG_LEVEL_VERBOSE);
+            return;
+        }
+        const issues = Object.entries(r.rules);
+        if (issues.length == 0) {
+            this._log(
+                $msg("Doctor.Message.NoIssues"),
+                activateReason !== "updated" ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO
+            );
+            return;
+        } else {
+            const OPT_YES = `${$msg("Doctor.Button.Yes")}` as const;
+            const OPT_NO = `${$msg("Doctor.Button.No")}` as const;
+            const OPT_DISMISS = `${$msg("Doctor.Button.DismissThisVersion")}` as const;
+            // this._log(`Issues found in ${key}`, LOG_LEVEL_VERBOSE);
+            const issues = Object.keys(r.rules)
+                .map((key) => `- ${getConfName(key as AllSettingItemKey)}`)
+                .join("\n");
+            const msg = await this.core.confirm.askSelectStringDialogue(
+                $msg("Doctor.Dialogue.Main", { activateReason, issues }),
+                [OPT_YES, OPT_NO, OPT_DISMISS],
+                {
+                    title: $msg("Doctor.Dialogue.Title"),
+                    defaultAction: OPT_YES,
+                }
+            );
+            if (msg == OPT_DISMISS) {
+                this.settings.doctorProcessedVersion = r.version;
+                await this.core.saveSettings();
+                this._log("Marked as to be silent", LOG_LEVEL_VERBOSE);
+                return;
+            }
+            if (msg != OPT_YES) return;
+            let shouldRebuild = false;
+            let shouldRebuildLocal = false;
+            const issueItems = Object.entries(r.rules) as [keyof ObsidianLiveSyncSettings, RuleForType<any>][];
+            this._log(`${issueItems.length} Issue(s) found `, LOG_LEVEL_VERBOSE);
+            let idx = 0;
+            const applySettings = {} as Partial<ObsidianLiveSyncSettings>;
+            const OPT_FIX = `${$msg("Doctor.Button.Fix")}` as const;
+            const OPT_SKIP = `${$msg("Doctor.Button.Skip")}` as const;
+            const OPT_FIXBUTNOREBUILD = `${$msg("Doctor.Button.FixButNoRebuild")}` as const;
+            let skipped = 0;
+            for (const [key, value] of issueItems) {
+                const levelMap = {
+                    [RuleLevel.Necessary]: $msg("Doctor.Level.Necessary"),
+                    [RuleLevel.Recommended]: $msg("Doctor.Level.Recommended"),
+                    [RuleLevel.Optional]: $msg("Doctor.Level.Optional"),
+                    [RuleLevel.Must]: $msg("Doctor.Level.Must"),
+                };
+                const level = value.level ? levelMap[value.level] : "Unknown";
+                const options = [OPT_FIX] as [typeof OPT_FIX | typeof OPT_SKIP | typeof OPT_FIXBUTNOREBUILD];
+                if ((!skipRebuild && value.requireRebuild) || value.requireRebuildLocal) {
+                    options.push(OPT_FIXBUTNOREBUILD);
+                }
+                options.push(OPT_SKIP);
+                const note = skipRebuild
+                    ? ""
+                    : `${value.requireRebuild ? $msg("Doctor.Message.RebuildRequired") : ""}${value.requireRebuildLocal ? $msg("Doctor.Message.RebuildLocalRequired") : ""}`;
+
+                const ret = await this.core.confirm.askSelectStringDialogue(
+                    $msg("Doctor.Dialogue.MainFix", {
+                        name: getConfName(key as AllSettingItemKey),
+                        current: `${this.settings[key]}`,
+                        reason: value.reason ?? " N/A ",
+                        ideal: `${value.value}`,
+                        level: `${level}`,
+                        note: note,
+                    }),
+                    options,
+                    {
+                        title: $msg("Doctor.Dialogue.TitleFix", { current: `${++idx}`, total: `${issueItems.length}` }),
+                        defaultAction: OPT_FIX,
+                    }
+                );
+
+                if (ret == OPT_FIX || ret == OPT_FIXBUTNOREBUILD) {
+                    //@ts-ignore
+                    applySettings[key] = value.value;
+                    if (ret == OPT_FIX) {
+                        shouldRebuild = shouldRebuild || value.requireRebuild || false;
+                        shouldRebuildLocal = shouldRebuildLocal || value.requireRebuildLocal || false;
+                    }
+                } else {
+                    skipped++;
+                }
+            }
+            if (Object.keys(applySettings).length > 0) {
+                this.settings = {
+                    ...this.settings,
+                    ...applySettings,
+                };
+            }
+            if (skipped == 0) {
+                this.settings.doctorProcessedVersion = r.version;
+            } else {
+                if (
+                    (await this.core.confirm.askYesNoDialog($msg("Doctor.Message.SomeSkipped"), {
+                        title: $msg("Doctor.Dialogue.TitleAlmostDone"),
+                        defaultOption: "No",
+                    })) == "no"
+                ) {
+                    // Some skipped, and user wants
+                    this.settings.doctorProcessedVersion = r.version;
+                }
+            }
+            await this.core.saveSettings();
+            if (!skipRebuild) {
+                if (shouldRebuild) {
+                    await this.core.rebuilder.scheduleRebuild();
+                    await this.core.$$performRestart();
+                } else if (shouldRebuildLocal) {
+                    await this.core.rebuilder.scheduleFetch();
+                    await this.core.$$performRestart();
+                }
+            }
+        }
+    }
+
     async migrateDisableBulkSend() {
         if (this.settings.sendChunksBulk) {
             this._log($msg("moduleMigration.logBulkSendCorrupted"), LOG_LEVEL_NOTICE);
@@ -20,157 +147,157 @@ export class ModuleMigration extends AbstractModule implements ICoreModule {
             await this.saveSettings();
         }
     }
-    async migrationCheck() {
-        const old = this.settings.settingVersion;
-        const current = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
-        // Check each migrations(old -> current)
-        if (!(await this.migrateToCaseInsensitive(old, current))) {
-            this._log(
-                $msg("moduleMigration.logMigrationFailed", {
-                    old: old.toString(),
-                    current: current.toString(),
-                }),
-                LOG_LEVEL_NOTICE
-            );
-            return;
-        }
-    }
-    async migrateToCaseInsensitive(old: number, current: number) {
-        if (
-            this.settings.handleFilenameCaseSensitive !== undefined &&
-            this.settings.doNotUseFixedRevisionForChunks !== undefined
-        ) {
-            if (current < SETTING_VERSION_SUPPORT_CASE_INSENSITIVE) {
-                this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
-                await this.saveSettings();
-            }
-            return true;
-        }
-        if (
-            old >= SETTING_VERSION_SUPPORT_CASE_INSENSITIVE &&
-            this.settings.handleFilenameCaseSensitive !== undefined &&
-            this.settings.doNotUseFixedRevisionForChunks !== undefined
-        ) {
-            return true;
-        }
+    // async migrationCheck() {
+    //     const old = this.settings.settingVersion;
+    //     const current = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
+    //     // Check each migrations(old -> current)
+    //     if (!(await this.migrateToCaseInsensitive(old, current))) {
+    //         this._log(
+    //             $msg("moduleMigration.logMigrationFailed", {
+    //                 old: old.toString(),
+    //                 current: current.toString(),
+    //             }),
+    //             LOG_LEVEL_NOTICE
+    //         );
+    //         return;
+    //     }
+    // }
+    // async migrateToCaseInsensitive(old: number, current: number) {
+    //     if (
+    //         this.settings.handleFilenameCaseSensitive !== undefined &&
+    //         this.settings.doNotUseFixedRevisionForChunks !== undefined
+    //     ) {
+    //         if (current < SETTING_VERSION_SUPPORT_CASE_INSENSITIVE) {
+    //             this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
+    //             await this.saveSettings();
+    //         }
+    //         return true;
+    //     }
+    //     if (
+    //         old >= SETTING_VERSION_SUPPORT_CASE_INSENSITIVE &&
+    //         this.settings.handleFilenameCaseSensitive !== undefined &&
+    //         this.settings.doNotUseFixedRevisionForChunks !== undefined
+    //     ) {
+    //         return true;
+    //     }
 
-        let remoteHandleFilenameCaseSensitive: undefined | boolean = undefined;
-        let remoteDoNotUseFixedRevisionForChunks: undefined | boolean = undefined;
-        let remoteChecked = false;
-        try {
-            const remoteInfo = await this.core.replicator.getRemotePreferredTweakValues(this.settings);
-            if (remoteInfo) {
-                remoteHandleFilenameCaseSensitive =
-                    "handleFilenameCaseSensitive" in remoteInfo ? remoteInfo.handleFilenameCaseSensitive : false;
-                remoteDoNotUseFixedRevisionForChunks =
-                    "doNotUseFixedRevisionForChunks" in remoteInfo ? remoteInfo.doNotUseFixedRevisionForChunks : false;
-                if (
-                    remoteHandleFilenameCaseSensitive !== undefined ||
-                    remoteDoNotUseFixedRevisionForChunks !== undefined
-                ) {
-                    remoteChecked = true;
-                }
-            } else {
-                this._log($msg("moduleMigration.logFetchRemoteTweakFailed"), LOG_LEVEL_INFO);
-            }
-        } catch (ex) {
-            this._log($msg("moduleMigration.logRemoteTweakUnavailable"), LOG_LEVEL_INFO);
-            this._log(ex, LOG_LEVEL_VERBOSE);
-        }
+    //     let remoteHandleFilenameCaseSensitive: undefined | boolean = undefined;
+    //     let remoteDoNotUseFixedRevisionForChunks: undefined | boolean = undefined;
+    //     let remoteChecked = false;
+    //     try {
+    //         const remoteInfo = await this.core.replicator.getRemotePreferredTweakValues(this.settings);
+    //         if (remoteInfo) {
+    //             remoteHandleFilenameCaseSensitive =
+    //                 "handleFilenameCaseSensitive" in remoteInfo ? remoteInfo.handleFilenameCaseSensitive : false;
+    //             remoteDoNotUseFixedRevisionForChunks =
+    //                 "doNotUseFixedRevisionForChunks" in remoteInfo ? remoteInfo.doNotUseFixedRevisionForChunks : false;
+    //             if (
+    //                 remoteHandleFilenameCaseSensitive !== undefined ||
+    //                 remoteDoNotUseFixedRevisionForChunks !== undefined
+    //             ) {
+    //                 remoteChecked = true;
+    //             }
+    //         } else {
+    //             this._log($msg("moduleMigration.logFetchRemoteTweakFailed"), LOG_LEVEL_INFO);
+    //         }
+    //     } catch (ex) {
+    //         this._log($msg("moduleMigration.logRemoteTweakUnavailable"), LOG_LEVEL_INFO);
+    //         this._log(ex, LOG_LEVEL_VERBOSE);
+    //     }
 
-        if (remoteChecked) {
-            // The case that the remote could be checked.
-            if (remoteHandleFilenameCaseSensitive && remoteDoNotUseFixedRevisionForChunks) {
-                // Migrated, but configured as same as old behaviour.
-                this.settings.handleFilenameCaseSensitive = true;
-                this.settings.doNotUseFixedRevisionForChunks = true;
-                this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
-                this._log(
-                    $msg("moduleMigration.logMigratedSameBehaviour", {
-                        current: current.toString(),
-                    }),
-                    LOG_LEVEL_INFO
-                );
-                await this.saveSettings();
-                return true;
-            }
-            const message = $msg("moduleMigration.msgFetchRemoteAgain");
-            const OPTION_FETCH = $msg("moduleMigration.optionYesFetchAgain");
-            const DISMISS = $msg("moduleMigration.optionNoAskAgain");
-            const options = [OPTION_FETCH, DISMISS];
-            const ret = await this.core.confirm.confirmWithMessage(
-                $msg("moduleMigration.titleCaseSensitivity"),
-                message,
-                options,
-                DISMISS,
-                40
-            );
-            if (ret == OPTION_FETCH) {
-                this.settings.handleFilenameCaseSensitive = remoteHandleFilenameCaseSensitive || false;
-                this.settings.doNotUseFixedRevisionForChunks = remoteDoNotUseFixedRevisionForChunks || false;
-                this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
-                await this.saveSettings();
-                try {
-                    await this.core.rebuilder.scheduleFetch();
-                    return;
-                } catch (ex) {
-                    this._log($msg("moduleMigration.logRedflag2CreationFail"), LOG_LEVEL_VERBOSE);
-                    this._log(ex, LOG_LEVEL_VERBOSE);
-                }
-                return false;
-            } else {
-                return false;
-            }
-        }
+    //     if (remoteChecked) {
+    //         // The case that the remote could be checked.
+    //         if (remoteHandleFilenameCaseSensitive && remoteDoNotUseFixedRevisionForChunks) {
+    //             // Migrated, but configured as same as old behaviour.
+    //             this.settings.handleFilenameCaseSensitive = true;
+    //             this.settings.doNotUseFixedRevisionForChunks = true;
+    //             this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
+    //             this._log(
+    //                 $msg("moduleMigration.logMigratedSameBehaviour", {
+    //                     current: current.toString(),
+    //                 }),
+    //                 LOG_LEVEL_INFO
+    //             );
+    //             await this.saveSettings();
+    //             return true;
+    //         }
+    //         const message = $msg("moduleMigration.msgFetchRemoteAgain");
+    //         const OPTION_FETCH = $msg("moduleMigration.optionYesFetchAgain");
+    //         const DISMISS = $msg("moduleMigration.optionNoAskAgain");
+    //         const options = [OPTION_FETCH, DISMISS];
+    //         const ret = await this.core.confirm.confirmWithMessage(
+    //             $msg("moduleMigration.titleCaseSensitivity"),
+    //             message,
+    //             options,
+    //             DISMISS,
+    //             40
+    //         );
+    //         if (ret == OPTION_FETCH) {
+    //             this.settings.handleFilenameCaseSensitive = remoteHandleFilenameCaseSensitive || false;
+    //             this.settings.doNotUseFixedRevisionForChunks = remoteDoNotUseFixedRevisionForChunks || false;
+    //             this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
+    //             await this.saveSettings();
+    //             try {
+    //                 await this.core.rebuilder.scheduleFetch();
+    //                 return;
+    //             } catch (ex) {
+    //                 this._log($msg("moduleMigration.logRedflag2CreationFail"), LOG_LEVEL_VERBOSE);
+    //                 this._log(ex, LOG_LEVEL_VERBOSE);
+    //             }
+    //             return false;
+    //         } else {
+    //             return false;
+    //         }
+    //     }
 
-        const ENABLE_BOTH = $msg("moduleMigration.optionEnableBoth");
-        const ENABLE_FILENAME_CASE_INSENSITIVE = $msg("moduleMigration.optionEnableFilenameCaseInsensitive");
-        const ENABLE_FIXED_REVISION_FOR_CHUNKS = $msg("moduleMigration.optionEnableFixedRevisionForChunks");
-        const ADJUST_TO_REMOTE = $msg("moduleMigration.optionAdjustRemote");
-        const KEEP = $msg("moduleMigration.optionKeepPreviousBehaviour");
-        const DISMISS = $msg("moduleMigration.optionDecideLater");
-        const message = $msg("moduleMigration.msgSinceV02321");
-        const options = [ENABLE_BOTH, ENABLE_FILENAME_CASE_INSENSITIVE, ENABLE_FIXED_REVISION_FOR_CHUNKS];
-        if (remoteChecked) {
-            options.push(ADJUST_TO_REMOTE);
-        }
-        options.push(KEEP, DISMISS);
-        const ret = await this.core.confirm.confirmWithMessage(
-            $msg("moduleMigration.titleCaseSensitivity"),
-            message,
-            options,
-            DISMISS,
-            40
-        );
-        console.dir(ret);
-        switch (ret) {
-            case ENABLE_BOTH:
-                this.settings.handleFilenameCaseSensitive = false;
-                this.settings.doNotUseFixedRevisionForChunks = false;
-                break;
-            case ENABLE_FILENAME_CASE_INSENSITIVE:
-                this.settings.handleFilenameCaseSensitive = false;
-                this.settings.doNotUseFixedRevisionForChunks = true;
-                break;
-            case ENABLE_FIXED_REVISION_FOR_CHUNKS:
-                this.settings.doNotUseFixedRevisionForChunks = false;
-                this.settings.handleFilenameCaseSensitive = true;
-                break;
-            case KEEP:
-                this.settings.handleFilenameCaseSensitive = true;
-                this.settings.doNotUseFixedRevisionForChunks = true;
-                this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
-                await this.saveSettings();
-                return true;
-            case DISMISS:
-            default:
-                return false;
-        }
-        this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
-        await this.saveSettings();
-        await this.core.rebuilder.scheduleRebuild();
-        await this.core.$$performRestart();
-    }
+    //     const ENABLE_BOTH = $msg("moduleMigration.optionEnableBoth");
+    //     const ENABLE_FILENAME_CASE_INSENSITIVE = $msg("moduleMigration.optionEnableFilenameCaseInsensitive");
+    //     const ENABLE_FIXED_REVISION_FOR_CHUNKS = $msg("moduleMigration.optionEnableFixedRevisionForChunks");
+    //     const ADJUST_TO_REMOTE = $msg("moduleMigration.optionAdjustRemote");
+    //     const KEEP = $msg("moduleMigration.optionKeepPreviousBehaviour");
+    //     const DISMISS = $msg("moduleMigration.optionDecideLater");
+    //     const message = $msg("moduleMigration.msgSinceV02321");
+    //     const options = [ENABLE_BOTH, ENABLE_FILENAME_CASE_INSENSITIVE, ENABLE_FIXED_REVISION_FOR_CHUNKS];
+    //     if (remoteChecked) {
+    //         options.push(ADJUST_TO_REMOTE);
+    //     }
+    //     options.push(KEEP, DISMISS);
+    //     const ret = await this.core.confirm.confirmWithMessage(
+    //         $msg("moduleMigration.titleCaseSensitivity"),
+    //         message,
+    //         options,
+    //         DISMISS,
+    //         40
+    //     );
+    //     console.dir(ret);
+    //     switch (ret) {
+    //         case ENABLE_BOTH:
+    //             this.settings.handleFilenameCaseSensitive = false;
+    //             this.settings.doNotUseFixedRevisionForChunks = false;
+    //             break;
+    //         case ENABLE_FILENAME_CASE_INSENSITIVE:
+    //             this.settings.handleFilenameCaseSensitive = false;
+    //             this.settings.doNotUseFixedRevisionForChunks = true;
+    //             break;
+    //         case ENABLE_FIXED_REVISION_FOR_CHUNKS:
+    //             this.settings.doNotUseFixedRevisionForChunks = false;
+    //             this.settings.handleFilenameCaseSensitive = true;
+    //             break;
+    //         case KEEP:
+    //             this.settings.handleFilenameCaseSensitive = true;
+    //             this.settings.doNotUseFixedRevisionForChunks = true;
+    //             this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
+    //             await this.saveSettings();
+    //             return true;
+    //         case DISMISS:
+    //         default:
+    //             return false;
+    //     }
+    //     this.settings.settingVersion = SETTING_VERSION_SUPPORT_CASE_INSENSITIVE;
+    //     await this.saveSettings();
+    //     await this.core.rebuilder.scheduleRebuild();
+    //     await this.core.$$performRestart();
+    // }
 
     async initialMessage() {
         const message = $msg("moduleMigration.msgInitialSetup", {
@@ -226,7 +353,8 @@ export class ModuleMigration extends AbstractModule implements ICoreModule {
             return false;
         }
         if (this.settings.isConfigured) {
-            await this.migrationCheck();
+            await this.migrateUsingDoctor(false);
+            // await this.migrationCheck();
             await this.migrateDisableBulkSend();
         }
         if (!this.settings.isConfigured) {
@@ -235,7 +363,14 @@ export class ModuleMigration extends AbstractModule implements ICoreModule {
                 this._log($msg("moduleMigration.logSetupCancelled"), LOG_LEVEL_NOTICE);
                 return false;
             }
+            await this.migrateUsingDoctor(true);
         }
         return true;
     }
+    $everyOnLayoutReady(): Promise<boolean> {
+        eventHub.onEvent(EVENT_REQUEST_RUN_DOCTOR, async (reason) => {
+            await this.migrateUsingDoctor(false, reason, true);
+        });
+        return Promise.resolve(true);
+    }
 }

src/modules/essentialObsidian/ModuleObsidianEvents.ts

@@ -56,7 +56,7 @@ export class ModuleObsidianEvents extends AbstractObsidianModule implements IObs
                     } else {
                         if (this.settings.syncOnEditorSave) {
                             this._log("Sync on Editor Save.", LOG_LEVEL_VERBOSE);
-                            fireAndForget(() => this.core.$$replicate());
+                            fireAndForget(() => this.core.$$replicateByEvent());
                         }
                     }
                 });
@@ -155,7 +155,7 @@ export class ModuleObsidianEvents extends AbstractObsidianModule implements IObs
             return;
         }
         if (this.settings.syncOnFileOpen && !this.core.$$isSuspended()) {
-            await this.core.$$replicate();
+            await this.core.$$replicateByEvent();
         }
         await this.core.$$queueConflictCheckIfOpen(file.path as FilePathWithPrefix);
     }

src/modules/essentialObsidian/ModuleObsidianMenu.ts

@@ -106,7 +106,6 @@ export class ModuleObsidianMenu extends AbstractObsidianModule implements IObsid
     }
     $everyOnload(): Promise<boolean> {
         this.app.workspace.onLayoutReady(this.core.$$onLiveSyncReady.bind(this.core));
-        // eslint-disable-next-line no-unused-labels
         return Promise.resolve(true);
     }
 

src/modules/extras/ModuleDev.ts

@@ -36,7 +36,6 @@ export class ModuleDev extends AbstractObsidianModule implements IObsidianModule
 
     $everyOnloadAfterLoadSettings(): Promise<boolean> {
         if (!this.settings.enableDebugTools) return Promise.resolve(true);
-        // eslint-disable-next-line no-unused-labels
         this.onMissingTranslation = this.onMissingTranslation.bind(this);
         __onMissingTranslation((key) => {
             void this.onMissingTranslation(key);

src/modules/extras/devUtil/TestPaneView.ts

@@ -30,7 +30,6 @@ export class TestPaneView extends ItemView {
         return "Self-hosted LiveSync Test and Results";
     }
 
-    // eslint-disable-next-line require-await
     async onOpen() {
         this.component = new TestPaneComponent({
             target: this.contentEl,
@@ -42,7 +41,6 @@ export class TestPaneView extends ItemView {
         await Promise.resolve();
     }
 
-    // eslint-disable-next-line require-await
     async onClose() {
         this.component?.$destroy();
         await Promise.resolve();

src/modules/features/ModuleInteractiveConflictResolver.ts

@@ -90,7 +90,7 @@ export class ModuleInteractiveConflictResolver extends AbstractObsidianModule im
         // So we have to run replication if configured.
         // TODO: Make this is as a event request
         if (this.settings.syncAfterMerge && !this.core.$$isSuspended()) {
-            await this.core.$$waitForReplicationOnce();
+            await this.core.$$replicateByEvent();
         }
         // And, check it again.
         await this.core.$$queueConflictCheck(filename);

src/modules/features/SettingDialogue/ObsidianLiveSyncSettingTab.ts

@@ -71,6 +71,7 @@ import {
     EVENT_REQUEST_OPEN_PLUGIN_SYNC_DIALOG,
     EVENT_REQUEST_OPEN_SETUP_URI,
     EVENT_REQUEST_RELOAD_SETTING_TAB,
+    EVENT_REQUEST_RUN_DOCTOR,
     eventHub,
 } from "../../../common/events.ts";
 import { skipIfDuplicated } from "octagonal-wheels/concurrency/lock";
@@ -1613,8 +1614,33 @@ The pane also can be launched by \`P2P Replicator\` command from the Command Pal
                                     const newTweaks =
                                         await this.plugin.$$checkAndAskUseRemoteConfiguration(trialSetting);
                                     if (newTweaks.result !== false) {
-                                        this.editingSettings = { ...this.editingSettings, ...newTweaks.result };
-                                        this.requestUpdate();
+                                        if (this.inWizard) {
+                                            this.editingSettings = { ...this.editingSettings, ...newTweaks.result };
+                                            this.requestUpdate();
+                                            return;
+                                        } else {
+                                            this.closeSetting();
+                                            this.plugin.settings = { ...this.plugin.settings, ...newTweaks.result };
+                                            if (newTweaks.requireFetch) {
+                                                if (
+                                                    (await this.plugin.confirm.askYesNoDialog(
+                                                        $msg("SettingTab.Message.AskRebuild"),
+                                                        {
+                                                            defaultOption: "Yes",
+                                                        }
+                                                    )) == "no"
+                                                ) {
+                                                    await this.plugin.$$saveSettingData();
+                                                    return;
+                                                }
+                                                await this.plugin.$$saveSettingData();
+                                                await this.plugin.rebuilder.scheduleFetch();
+                                                await this.plugin.$$scheduleAppReload();
+                                                return;
+                                            } else {
+                                                await this.plugin.$$saveSettingData();
+                                            }
+                                        }
                                     }
                                 })
                         );
@@ -1890,6 +1916,9 @@ The pane also can be launched by \`P2P Replicator\` command from the Command Pal
                         })
                         .setClass("wizardHidden");
 
+                    new Setting(paneEl).autoWireNumeric("syncMinimumInterval", {
+                        onUpdate: onlyOnNonLiveSync,
+                    });
                     new Setting(paneEl)
                         .setClass("wizardHidden")
                         .autoWireToggle("syncOnSave", { onUpdate: onlyOnNonLiveSync });
@@ -2226,10 +2255,23 @@ The pane also can be launched by \`P2P Replicator\` command from the Command Pal
         void addPane(containerEl, "Hatch", "🧰", 50, true).then((paneEl) => {
             // const hatchWarn = this.createEl(paneEl, "div", { text: `To stop the boot up sequence for fixing problems on databases, you can put redflag.md on top of your vault (Rebooting obsidian is required).` });
             // hatchWarn.addClass("op-warn-info");
-            void addPanel(paneEl, "Reporting Issue").then((paneEl) => {
-                new Setting(paneEl).setName("Make report to inform the issue").addButton((button) =>
+            void addPanel(paneEl, $msg("Setting.TroubleShooting")).then((paneEl) => {
+                new Setting(paneEl)
+                    .setName($msg("Setting.TroubleShooting.Doctor"))
+                    .setDesc($msg("Setting.TroubleShooting.Doctor.Desc"))
+                    .addButton((button) =>
+                        button
+                            .setButtonText("Run Doctor")
+                            .setCta()
+                            .setDisabled(false)
+                            .onClick(() => {
+                                this.closeSetting();
+                                eventHub.emitEvent(EVENT_REQUEST_RUN_DOCTOR, "you wanted(Thank you)!");
+                            })
+                    );
+                new Setting(paneEl).setName("Prepare the 'report' to create an issue").addButton((button) =>
                     button
-                        .setButtonText("Make report")
+                        .setButtonText("Copy Report to clipboard")
                         .setCta()
                         .setDisabled(false)
                         .onClick(async () => {
@@ -2310,7 +2352,10 @@ version:${manifestVersion}
 ${stringifyYaml(pluginConfig)}`;
                             console.log(msgConfig);
                             await navigator.clipboard.writeText(msgConfig);
-                            Logger(`Information has been copied to clipboard`, LOG_LEVEL_NOTICE);
+                            Logger(
+                                `Generated report has been copied to clipboard. Please report the issue with this! Thank you for your cooperation!`,
+                                LOG_LEVEL_NOTICE
+                            );
                         })
                 );
                 new Setting(paneEl).autoWireToggle("writeLogToTheFile");

src/modules/features/SettingDialogue/settingConstants.ts

@@ -346,8 +346,8 @@ export const SettingInformation: Partial<Record<keyof AllSettings, Configuration
         desc: "If this enabled, All files are handled as case-Sensitive (Previous behaviour).",
     },
     doNotUseFixedRevisionForChunks: {
-        name: "Compute revisions for chunks (Previous behaviour)",
-        desc: "If this enabled, all chunks will be stored with the revision made from its content. (Previous behaviour)",
+        name: "Compute revisions for chunks",
+        desc: "If this enabled, all chunks will be stored with the revision made from its content.",
     },
     sendChunksBulkMaxSize: {
         name: "Maximum size of chunks to send in one request",
@@ -373,6 +373,10 @@ export const SettingInformation: Partial<Record<keyof AllSettings, Configuration
         name: "Suppress notification of hidden files change",
         desc: "If enabled, the notification of hidden files change will be suppressed.",
     },
+    syncMinimumInterval: {
+        name: "Minimum interval for syncing",
+        desc: "The minimum interval for automatic synchronisation on event.",
+    },
 };
 function translateInfo(infoSrc: ConfigurationItem | undefined | false) {
     if (!infoSrc) return false;

src/modules/interfaces/StorageAccess.ts

@@ -38,7 +38,7 @@ export interface StorageAccess {
     getFiles(): UXFileInfoStub[];
     getFileNames(): FilePathWithPrefix[];
 
-    touched(file: UXFileInfoStub | FilePathWithPrefix): void;
+    touched(file: UXFileInfoStub | FilePathWithPrefix): Promise<void>;
     recentlyTouched(file: UXFileInfoStub | FilePathWithPrefix): boolean;
     clearTouched(): void;
 

updates.md

@@ -10,6 +10,85 @@ Nevertheless, that being said, to be more honest, I still have not decided what
 
 Note: Already you have noticed this, but let me mention it again, this is a significantly large update. If you have noticed anything, please let me know. I will try to fix it as soon as possible (Some address is on my [profile](https://github.com/vrtmrz)).
 
+## 0.24.18
+
+### Fixed
+
+- Now no chunk creation errors will be raised after switching `Compute revisions for chunks`.
+- Some invisible file can be handled correctly (e.g., `writing-goals-history.csv`).
+- Fetching configuration from the server is now saves the configuration immediately (if we are not in the wizard).
+
+### Improved
+
+- Mismatched configuration dialogue is now more informative, and rewritten to more user-friendly.
+- Applying configuration mismatch is now without rebuilding (at our own risks).
+- Now, rebuilding is decided more fine grained.
+
+### Improved internally
+
+- Translations can be nested. i.e., task:`Some procedure`, check: `%{task} checking`, checkfailed: `%{check} failed` produces `Some procedure checking failed`.
+    - Max to 10 levels of nesting
+
+
+## 0.24.17
+
+Confession. I got the default values wrong. So scary and sorry.
+
+### Behaviour and default changed
+
+- **NOW INDEED AND ACTUALLY** `Compute revisions for chunks` are backed into enabled again. it is necessary for garbage collection of chunks.
+    - As far as existing users are concerned, this will not automatically change, but the Doctor will inform us.
+
+## 0.24.16
+
+### Improved
+
+#### Peer-to-Peer
+
+- Now peer-to-peer synchronisation checks the settings are compatible with each other.
+    - No longer unexpected database broken, phew.
+- Peer-to-peer synchronisation now handles the platform and detects pseudo-clients.
+    - Pseudo clients will not decrypt/encrypt anything, just relay the data. Hence, always settings are not compatible. Therefore, we have to accept the incompatibility for pseudo clients.
+
+#### General
+
+- New migration method has been implemented, that called `Doctor`.
+
+    - `Doctor` checks the difference between the ideal and actual values and encourages corrective action. To facilitate our decision, the reasons for this and the recommendations are also presented.
+    - This can be used not only during migration. We can invoke the doctor from the settings for trouble-shooting.
+
+- The minimum interval for replication to be caused when an event occurs can now be configurable.
+- Some detail note has been added and change nuance about the `Report` in the setting dialogue, which had less informative.
+
+### Behaviour and default changed
+
+- `Compute revisions for chunks` are backed into enabled again. it is necessary for garbage collection of chunks.
+    - As far as existing users are concerned, this will not automatically change, but the Doctor will inform us.
+
+### Refactored
+
+- Platform specific codes are more separated. No longer `node` modules were used in the browser and Obsidian.
+
+## 0.24.15
+
+### Fixed
+
+- Now, even without WeakRef, Polyfill is used and the whole thing works without error. However, if you can switch WebView Engine, it is recommended to switch to a WebView Engine that supports WeakRef.
+
+## 0.24.14
+
+### Fixed
+
+- Resolving conflicts of JSON files (and sensibly merging them) is now working fine, again!
+    - And, failure logs are more informative.
+- More robust to release the event listeners on unwatching the local database.
+
+### Refactored
+
+- JSON file conflict resolution dialogue has been rewritten into svelte v5.
+- Upgrade eslint.
+- Remove unnecessary pragma comments for eslint.
+
 ## 0.24.13
 
 Sorry for the lack of replies. The ones that were not good are popping up, so I am just going to go ahead and get this one... However, they realised that refactoring and restructuring is about clarifying the problem. Your patience and understanding is much appreciated.
@@ -91,46 +170,4 @@ And, this is just a single web page, without any server-side code. It is a stati
 - Terser optimisation has slightly improved.
 - During the build, analysis meta-file of the bundled codes will be generated.
 
-## 0.24.10
-
-### Fixed
-
-- Fixed the issue which the filename is shown as `undefined`.
-- Fixed the issue where files transferred at short intervals were not reflected.
-
-### Improved
-
-- Add more translations: `ja-JP` (Japanese) by @kohki-shikata (Thank you so much)!
-
-### Internal
-
-- Some files have been prettified.
-
-## 0.24.9
-
-Skipped.
-
-## 0.24.8
-
-### Fixed
-
-- Some parallel-processing tasks are now performed more safely.
-- Some error messages has been fixed.
-
-### Improved
-
-- Synchronisation is now more efficient and faster.
-- Saving chunks is a bit more robust.
-
-### New Feature
-
-- We can remove orphaned chunks again, now!
-    - Without rebuilding the database!
-    - Note: Please synchronise devices completely before removing orphaned chunks.
-    - Note2: Deleted files are using chunks, if you want to remove them, please commit the deletion first. (`Commit File Deletion`)
-    - Note3: If you lost some chunks, do not worry. They will be resurrected if not so much time has passed. Try `Resurrect deleted chunks`.
-    - Note4: This feature is still beta. Please report any issues you encounter.
-    - Note5: Please disable `On demand chunk fetching`, and enable `Compute revisions for each chunk` before using this feature.
-        - These settings is going to be default in the future.
-
 Older notes are in [updates_old.md](https://github.com/vrtmrz/obsidian-livesync/blob/main/updates_old.md).

updates_old.md

@@ -14,6 +14,48 @@ Thank you, and I hope your troubles will be resolved!
 
 ---
 
+## 0.24.10
+
+### Fixed
+
+- Fixed the issue which the filename is shown as `undefined`.
+- Fixed the issue where files transferred at short intervals were not reflected.
+
+### Improved
+
+- Add more translations: `ja-JP` (Japanese) by @kohki-shikata (Thank you so much)!
+
+### Internal
+
+- Some files have been prettified.
+
+## 0.24.9
+
+Skipped.
+
+## 0.24.8
+
+### Fixed
+
+- Some parallel-processing tasks are now performed more safely.
+- Some error messages has been fixed.
+
+### Improved
+
+- Synchronisation is now more efficient and faster.
+- Saving chunks is a bit more robust.
+
+### New Feature
+
+- We can remove orphaned chunks again, now!
+    - Without rebuilding the database!
+    - Note: Please synchronise devices completely before removing orphaned chunks.
+    - Note2: Deleted files are using chunks, if you want to remove them, please commit the deletion first. (`Commit File Deletion`)
+    - Note3: If you lost some chunks, do not worry. They will be resurrected if not so much time has passed. Try `Resurrect deleted chunks`.
+    - Note4: This feature is still beta. Please report any issues you encounter.
+    - Note5: Please disable `On demand chunk fetching`, and enable `Compute revisions for each chunk` before using this feature.
+        - These settings is going to be default in the future.
+
 ## 0.24.7
 
 ### Fixed (Security)