fix(cli): install complete systemd runtime

devs.md

@@ -129,36 +129,34 @@ Changes spanning both repositories must first produce a packed Commonlib artefac
 
 ## Architecture
 
-### Service composition and legacy modules
+### Module System
 
-The application is composed from Services, ServiceModules, serviceFeatures, and a legacy module layer:
+The plugin uses a dynamic module system to reduce coupling and improve maintainability:
 
-- **Service Hub**: the long-lived registry of service contracts. A simple extension, such as a check before replication, belongs in an existing Service handler.
-- **ServiceModule**: a host-created, long-lived stateful or resource-owning capability shared through the typed `ServiceModules` record. Current examples include storage access, file handling, and database rebuilding.
-- **serviceFeature**: a typed composition function which accepts only its declared Services and ServiceModules. It registers lifecycle handlers, commands, UI bindings, or other host glue, and may return a focused view. It is not a runtime registry entry.
-- **AbstractModule** and **AbstractObsidianModule**: the legacy application module layer. Existing modules are loaded by the application and bound after the Service graph has been composed; this broad core access is not the preferred dependency boundary for new orchestration.
+- **Service Hub**: Central registry for services using dependency injection
+    - Services are registered, and accessed via `this.services` (in most modules)
+- **Module Loading**: All modules extend `AbstractModule` or `AbstractObsidianModule` (which extends `AbstractModule`). These modules are loaded in main.ts and some modules.
+- **Module Categories** (by directory):
+    - `core/` - Platform-independent core functionality
+    - `coreObsidian/` - Obsidian-specific core (e.g., `ModuleFileAccessObsidian`)
+    - `essential/` - Required modules (e.g., `ModuleMigration`, `ModuleKeyValueDB`)
+    - `features/` - Optional features (e.g., `ModuleLog`, `ModuleObsidianSettings`)
+    - `extras/` - Development/testing tools (e.g., `ModuleDev`, ~~`ModuleIntegratedTest`~~)
+- **Services**: Core services (e.g., `database`, `replicator`, `storageAccess`) are registered in `ServiceHub` and accessed by modules. They provide an extension point for add new behaviour without modifying existing code.
+    - For example, checks before the replication can be added to the `replication.onBeforeReplicate` handler, and the handlers can be return `false` to prevent replication-starting. `vault.isTargetFile` also can be used to prevent processing specific files.
+- **ServiceModule**: A new type of module that directly depends on services.
 
-The normal composition order is the Service Hub, replicator-provider registration, ServiceModules, serviceFeatures, add-ons, and finally legacy module binding. A serviceFeature may therefore consume an already constructed ServiceModule. Preferring a serviceFeature for new composition is a dependency-boundary rule, not an initialisation-order rule.
+#### Note on Module vs Service
 
-Mutable state is permitted in a serviceFeature. State alone is not a reason to create a class, a ServiceModule, or retain an AbstractModule. Prefer one private context, with module-level functions which receive that context, when identity and polymorphism are not part of the contract. Separate the state, transitions, and invariants from the surrounding function which registers lifecycle handlers and connects downstream effects. Give the stateful boundary narrow collaborators rather than `LiveSyncBaseCore`.
+After v0.25.44 refactoring, the Service will henceforth, as a rule, cease to use setHandler, that is to say, simple lazy binding. - They will be implemented directly in the service. - However, not everything will be middlewarised. Modules that maintain state or make decisions based on the results of multiple handlers are permitted.
 
-Use a class when stable object identity, replaceable implementations, or an explicit external-resource lifecycle such as serialised ownership, `dispose()`, or `abort()` is part of the contract. Use a ServiceModule when that operational capability or resource lifecycle must also be shared explicitly by several consumers. Do not introduce a class merely to group dependencies or make private functions callable.
+Hence, the new feature should be implemented as follows:
 
-Several narrow views over one lifetime do not require several state owners or a public façade class. One private context may back all of those views, provided that the context remains private and each consumer receives only its declared contract. Keep actual resource owners separate when identity, serialised replacement, abort, retirement, or disposal order is part of their behaviour.
-
-When a core-owned serviceFeature returns a view needed by one host-specific consumer, pass that view through host composition instead of storing it as a public `LiveSyncBaseCore` property or promoting it to a ServiceModule. The receiving host should inject the view into the narrow command or application context which uses it.
-
-Commonlib's `targetFilter.ts` and `prepareDatabaseForUse.ts` demonstrate the intended split: focused factories or operations own their private state and behaviour, while the corresponding `use...` function composes dependencies and registers handlers. The P2P composition follows the same direction at a larger scale by separating durable policy and room-session ownership from host lifecycle and UI wiring. Existing modules do not apply this boundary consistently; improve the affected boundary when changing their behaviour rather than performing an unrelated mechanical conversion.
-
-Use interaction-based, London School unit tests for the composition boundary. Verify collaborator calls, ordering, failure short-circuiting, and handler registration, then test the focused state owner for its transitions and invariants. If a test needs a broad core fixture, a large class mock, deep mock chains, or unrelated Services, treat that friction as a design-review signal and consider a private context with narrower functions before adding more test machinery.
-
-Legacy modules remain grouped by directory:
-
-- `core/` contains platform-independent core behaviour;
-- `coreObsidian/` contains Obsidian-specific core behaviour;
-- `essential/` contains required modules;
-- `features/` contains optional features; and
-- `extras/` contains development and testing tools.
+- If it is a simple extension point (e.g., adding a check before replication), it should be implemented as a handler in the service (e.g., `replication.onBeforeReplicate`).
+- If it requires maintaining state or making decisions based on multiple handlers, it should be implemented as a serviceModule dependent on the relevant services explicitly.
+- If you have to implement a new feature without much modification, you can extent existing modules, but it is recommended to implement a new module or serviceModule for better maintainability.
+- Refactoring existing modules to services is also always welcome!
+- Please write tests for new features, you will notice that the simple handler approach is quite testable.
 
 ### Key Architectural Components
 
@@ -167,7 +165,7 @@ Legacy modules remain grouped by directory:
 - **Service Hub** (`src/modules/services/`): Central service registry using dependency injection
 - **Common Library** (`@vrtmrz/livesync-commonlib`): Platform-independent synchronisation logic, shared with the CLI, WebApp, WebPeer, and external tools
 
-Commonlib owns one stable `LiveSyncP2PService`, its `P2PRoomSessionOwner`, and the replaceable Trystero room session. Host commands, event handlers, and views consume the focused transport, connection-probe admission, directory, peer-admission, transfer, change-relay, configuration, and diagnostic views returned by the service feature. They must not retain the deprecated compatibility Replicator as an ordinary service locator, close Trystero-owned raw peers, or install another Trystero transport generation at the application root. The exact as-built ownership and shutdown boundaries are recorded in Commonlib's `docs/p2p-transport-lifecycle.md` design document.
+Commonlib owns the P2P replicator and Trystero transport lifecycle. Host commands, event handlers, and views must retain the Commonlib service-feature result and resolve its current `replicator` at the point of use. They must not snapshot an instance which can be replaced when settings or the local database change, close Trystero-owned raw peers, or install another Trystero transport generation at the application root.
 
 ### Conflict Merge Policy
 

docs/adr/2026_08_replicator_capabilities_01_core_contract.md

@@ -1,715 +0,0 @@
----
-date: 2026-08-27
-commonlib-version: "0.1.19"
-self-hosted-livesync-version: "1.0.21"
-status: proposed
-series: replicator-capabilities-and-lifecycle
-part: 1 of 3
----
-
-# Architectural Decision Record: Replicator Capabilities and Lifecycle Orchestration — Part 1: Core Contract
-
-Series navigation: this is Part 1 of 3. Continue with [Part 2: P2P service and
-session lifecycle](2026_08_replicator_capabilities_02_p2p_service_lifecycle.md),
-then [Part 3: migration plan and verification](2026_08_replicator_capabilities_03_migration_plan.md).
-
-## Status
-
-Proposed. This record defines the provider, capability, lifecycle, interaction,
-ownership, and probe boundaries required by current Self-hosted LiveSync
-consumers. It is the generic part of the series; the P2P-specific ownership
-rules live in Part 2, and implementation sequencing lives in Part 3.
-
-The accepted P2P room and transport lifecycle record remains authoritative for
-the current P2P implementation until Stage 3 in Part 3 is complete. The
-supersession boundary for that record is stated in Part 2 and is not repeated
-here.
-
-## Context
-
-Self-hosted LiveSync currently represents CouchDB, Object Storage, and P2P with
-one `LiveSyncAbstractReplicator` base class. That base class requires finite
-and continuous replication, full upload and download, remote creation and
-reset, lock administration, preferred-tweak Metadata, on-demand Chunk reads,
-remote status, integrity inspection, and connected-device inspection.
-
-These operations do not share one support boundary:
-
-- CouchDB supports unattended OneShot Sync, Continuous replication,
-  central-remote administration, and CouchDB-specific inspection and
-  maintenance.
-- Object Storage supports finite journal synchronisation, central reset and
-  lock Metadata, full upload and download, and storage-size inspection. It has
-  no continuous changes feed, CouchDB Chunk source, CouchDB integrity
-  inspection, or CouchDB device registry.
-- P2P supports peer-targeted finite transfer and an independently owned room,
-  signalling, watch, and broadcast lifecycle. It has no central database to
-  create, reset, lock, inspect for size, or upload during first-device setup.
-  It also has peer-driven AutoSync and AutoWatch paths when the room is open.
-  Those paths are detailed in Part 2.
-
-The abstract class makes absent capabilities look like operations. Current
-implementations express absence through thrown errors, `false`, empty arrays,
-zero counts, silent success, and a dummy all-zero Security Seed. Callers
-cannot tell whether an operation was performed, was inapplicable, or could not
-be performed.
-
-A neutral value is correct only when it is the documented identity for every
-caller. For example, Object Storage has no remote-Chunk role, whereas a
-supported CouchDB Chunk request may legitimately return an empty array. A
-zero integrity count cannot safely stand for an inspection which did not run.
-
-Issue 1140 exposes the lifecycle consequence. In version 1.0.21,
-`ModuleReplicatorCouchDB` owns the application resume callback and excludes
-Object Storage and P2P by `remoteType`. Object Storage accepts `syncOnStart`,
-but no journal synchronisation starts at resume. Periodic, event-driven, and
-manual calls later reach the active Replicator successfully.
-
-The construction boundary is also overloaded. `getNewReplicator()` is an
-order-dependent first-result handler which ignores false results and catches
-handler errors. It is used for active Replicator acquisition, trial settings,
-and temporary command instances. P2P construction can replace and close a
-service-owned current transport, so an apparently temporary request can
-disturb an active or adjunct transport.
-
-Fast Setup is a separate boundary. Streaming Fetch is a CouchDB-specific
-initial transfer which uses CouchDB HTTP settings and a Security Seed supplier;
-it does not need a full Replicator or an owned PouchDB connection. It must not
-be made a generic Replicator capability merely because the current code obtains
-one as a supplier.
-
-Finally, current operation results can hide failure. Object Storage can discard
-a failed or stopped journal result and report success. A headless P2P path can
-complete but return `undefined`, which the caller interprets as failure. Remote
-mutations can be caught or ignored before Rebuilder continuation, and an
-offline integrity inspection can be represented as zero. The contract must
-make those outcomes truthful.
-
-## Decision drivers
-
-The design must:
-
-1. cover every operation used by the plug-in, CLI, WebApp, WebPeer, Setup,
-   Rebuilder, and maintenance flows;
-2. keep lifecycle policy independent of provider class names;
-3. make an omitted support decision a compile-time error when a current
-   provider or capability is added;
-4. carry trigger and interaction policy through `ReplicationService`, so an
-   automatic trigger cannot open a dialogue;
-5. distinguish capability absence, unavailable observation, and an observed
-   empty value where that difference affects safety;
-6. retain simple neutral results where they are safe identities for every
-   caller;
-7. give active Replicator, flow-specific probe, and transport resources one
-   explicit owner and disposal boundary; and
-8. report replication, central-remote mutation, and maintenance outcomes
-   truthfully while preserving source compatibility during migration.
-
-## Decision
-
-### Use precise ownership terms
-
-- A **provider definition** is the host-composed, exhaustive declaration for
-  one current remote kind.
-- The **active Replicator** is the selected main-remote handle owned by
-  `ReplicatorService`.
-- A **probe** is a short-lived, flow-specific validation resource whose caller
-  owns disposal.
-- The **P2P service** is the stable Commonlib implementation which supplies
-  narrow P2P contract views. Its room-session ownership is defined in Part 2.
-- A **room session** and **session epoch** are P2P terms defined in Part 2; an
-  epoch is an internal fence, not a public capability or logical room name.
-
-An active Replicator is a handle, not necessarily the owner of every transport
-which it uses. In particular, the active P2P Replicator is a non-owning adapter
-over the P2P service. Its ownership consequences are specified once in Part 2.
-
-### Separate policy, provider selection, and the active Replicator
-
-Application lifecycle policy decides **when** synchronisation is requested.
-The selected provider and its active Replicator decide **how**, and whether,
-that request can be performed. A provider module must not subscribe to the
-application resume lifecycle merely because it can construct a transport.
-
-Self-hosted LiveSync will compose one LiveSync-owned serviceFeature as the
-replication scheduling boundary. The serviceFeature creates one private
-scheduling context and passes it to module-level transition functions. The
-context contains only scheduling state and narrow collaborators; the functions
-implement external-poller ownership, Continuous ownership of recurring work,
-the daemon's satisfied initial OneShot marker, resume coalescing, and
-periodic-timer reconciliation. They do not register handlers or acquire
-`LiveSyncBaseCore`.
-
-The context receives narrow collaborators for readiness and suspension queries,
-current settings, `ReplicationService`, periodic-timer control, and diagnostic
-logging. The surrounding serviceFeature owns the context lifetime, lifecycle
-registration, and adaptation from those Services. It returns a focused control
-view containing only the daemon operations to select external polling and mark
-the initial OneShot as satisfied. Core construction passes a frozen bundle of
-built-in feature views to host composition, without retaining those views as
-public `LiveSyncBaseCore` properties. The CLI injects the scheduling view into
-its command context; other hosts may ignore it. No host may expose the context's
-mutable state or recover it from a core-keyed global or `WeakMap`.
-
-This boundary is not a ServiceModule merely because it owns state. It neither
-owns a shared external resource nor supplies a general operational capability
-to several unrelated consumers. If a future consumer needs a stable shared
-scheduling capability beyond the focused CLI view, that ownership decision
-must be reviewed explicitly rather than widening the returned view implicitly.
-
-The scheduling functions use persisted settings, `ReplicationService`, and
-the active support declaration. They do not branch on `remoteType` or use
-`instanceof` as a capability test. Commonlib owns the trigger-aware replication
-contract; the host owns application lifecycle wiring.
-
-The existing `onResumed` event remains the eligible-resume boundary after
-initial readiness, settings application, and visibility recovery. It is not
-redefined as a once-per-process event. The context-backed functions coalesce
-duplicate work within one lifecycle generation and preserve readiness and
-suspension gates:
-
-- configured Continuous replication starts only through an active Continuous
-  role;
-- otherwise, configured `syncOnStart` runs through an unattended OneShot role
-  when that role is supported;
-- an unsupported configured policy produces an explicit unsupported or
-  not-implemented result; and
-- automatic start-up, periodic, file-event, and merge triggers never open a
-  dialogue. A target-requiring operation is available to an explicit user
-  action or to a flow with a configured target.
-
-`ReplicationService` remains responsible for readiness checks, bounded finite
-activity, failure processing, and replication timing. It exposes distinct
-user-initiated and unattended entry points, or a typed request which carries
-interaction authority. The scheduling functions never call a concrete
-Replicator's `openReplication()` directly.
-
-`P2P_AutoStart` remains a separate P2P room policy. It is not central
-Continuous replication and is not `syncOnStart`; its service lifecycle is
-specified in Part 2. Reopening after `EVENT_DATABASE_REBUILT` is a
-flow-authorised continuation requested by the Rebuilder, not evidence that
-AutoStart is enabled.
-
-Correctness must not depend on the registration order of equal-priority resume
-handlers. P2P AutoStart records persistent room demand, while an unattended P2P
-OneShot records finite room demand. `P2PRoomSessionOwner` serialises both and
-retains the room while either demand remains. Provider-specific P2P lifecycle
-wiring and host replication scheduling may therefore run in either order.
-Focused owner tests cover AutoStart-before-OneShot and OneShot-before-AutoStart;
-the host feature-binding test must not encode their current registration order
-as a scheduling prerequisite.
-
-The CLI daemon owns its initial finite convergence before its mirror scan.
-Restored settings mark that convergence as satisfied for the current lifecycle
-generation, so `syncOnStart` does not repeat it. In `--interval` mode, the
-daemon poller is the sole recurring remote-poll scheduler. In changes-feed mode,
-the scheduling functions start one configured Continuous session when
-supported; otherwise they may enable the configured generic periodic timer.
-Continuous has precedence when both are configured.
-
-The resume function starts work synchronously far enough to reserve
-Continuous ownership, then lets the lifecycle handler settle without awaiting
-network completion. Concurrent resume notifications share one internal
-operation. Periodic reconciliation therefore observes the reservation before
-it can enable a competing timer. A failed operation is logged and releases the
-coalescing slot so a later resume can retry.
-
-Coalescing applies only within one observed lifecycle generation. If the
-application suspends and resumes while an earlier operation is still settling,
-the context retains the newer generation and runs it after the earlier
-operation releases the slot. A result from the obsolete generation cannot
-change recurring-work ownership or initiate a OneShot fallback for the newer
-generation.
-
-Disabling an interval does not retract a callback which the runtime has already
-queued. Each Periodic callback therefore rechecks lifecycle eligibility,
-readiness, suspension, configuration, external-poller ownership, and
-Continuous ownership immediately before it requests replication.
-
-### Use a fixed current-provider definition
-
-Commonlib defines the canonical current remote kinds, provider contract,
-capability catalogue, support-decision type, and typed provider builder. Each
-host composition explicitly declares the provider kinds which it includes and
-supplies an exhaustive definition table for that set. The current catalogue is
-CouchDB, Object Storage, and P2P; it is not a public third-party registration
-API.
-
-CouchDB is part of every current host composition. Object Storage and P2P are
-compile-time composition choices and may be included or omitted without
-changing the generic scheduling feature. Adding another current provider
-requires a Commonlib kind and support declaration, host composition,
-Setup/profile schema handling, and provider-specific tests. It does not require
-a runtime plug-in registry or behaviour for unknown provider kinds.
-
-Each provider definition supplies:
-
-- canonical kind and diagnostic name;
-- active Replicator construction;
-- a configuration predicate and private configuration identity;
-- explicit user-initiated and unattended OneShot runners;
-- readiness requirements, an explicit Continuous support decision, and a
-  transfer-stop runner;
-- the exhaustive current remote-resource catalogue; and
-- an optional cohesive central-remote administration runner.
-
-The host composes CouchDB and Object Storage definitions directly. A module is
-retained only when it owns separate state or behaviour; a factory-registration-
-only module instance is not required. The stateful P2P service is composed
-independently and may be an adjunct beside a different selected main provider.
-
-The definition table uses `satisfies` against required record keys. Adding a
-current provider or catalogue entry without a support decision is a compile-time
-error. A typed builder correlates each `supported` decision with its required
-role and rejects a role for an absent capability.
-
-Support has three stable states:
-
-```typescript
-type CapabilitySupport =
-    | { readonly kind: "supported" }
-    | { readonly kind: "not-implemented"; readonly reason: CapabilityReason }
-    | { readonly kind: "not-applicable"; readonly reason: CapabilityReason };
-```
-
-`not-implemented` means that the provider model exists but the current
-implementation does not supply it. `not-applicable` means that the model does
-not exist for that provider, such as central database locking for P2P. Reasons
-are stable codes, not arbitrary user-facing strings.
-
-Historical empty `remoteType` is resolved explicitly as CouchDB at the
-persistence/profile boundary. Capability selection then uses that canonical
-kind; it never infers CouchDB by truthiness or by a negative test such as
-'neither Object Storage nor P2P'.
-
-The private configuration identity covers every effective setting which binds
-the active adapter. The active publication is retained only while both the
-provider and identity are unchanged. Every changed identity follows the same
-serialised replacement transition; there is no same-instance rebind branch.
-
-### Keep the active contract small and compose the differing roles
-
-The active object implements only the lifecycle and transport primitives which
-are real for CouchDB, Object Storage Journal, and P2P:
-
-```typescript
-interface ReplicatorInstance {
-    initializeDatabaseForReplication(): Promise<boolean>;
-    openReplication(
-        setting: RemoteDBSettings,
-        keepAlive: boolean,
-        showResult: boolean,
-        ignoreCleanLock: boolean
-    ): Promise<void | boolean>;
-    terminateSync(): void | Promise<void>;
-    closeReplication(): void | Promise<void>;
-}
-```
-
-Provider runners compose the differences in interaction authority, readiness,
-typed settlement, explicit Continuous support or inapplicability, and P2P room
-demand. Short-lived connection, preferred-tweak, Security Seed, and
-synchronisation-information operations remain caller-owned resources. Central
-administration remains one optional cohesive runner. None of those differences
-widens `ReplicatorInstance`.
-
-The LiveSync central-remote administration composition shares only local-identity
-preparation, mutation ordering, milestone interpretation, and result
-settlement. Its CouchDB and Object Storage adapters retain their own milestone
-readers and connection or client ownership. The fixed provider definition has
-already selected the adapter, so those readers validate only the additional
-operations which they use; they do not rediscover capability support through a
-concrete-class `instanceof` test.
-
-The central OneShot adapters likewise require only the local structural
-`openOneShotReplicationWithOutcome()` operation. Concrete constructors remain
-at the host-composition boundary, but constructor identity is not a capability
-test. A structurally incomplete active instance settles as a failed outcome
-rather than falling back to the legacy `openReplication()` operation.
-
-Directional Fetch and Rebuild, Streaming Fetch, CouchDB on-demand Chunk reads,
-remote-size inspection, compromised-Chunk inspection, Garbage Collection,
-compaction, and journal checkpoint maintenance are workflow or
-provider-specific concerns. They do not become exhaustive provider
-capabilities merely because an application flow branches by topology.
-
-Local node identity initialisation remains at the established Replicator and
-local-database initialisation boundary for this change. A later physical
-database-lifetime review may move it only after establishing a concrete owner
-and migration benefit. Replication statistics remain a `ReplicatorService`
-telemetry sink.
-
-### Make unattended work explicit and truthful
-
-User-initiated and unattended OneShot Sync are separate roles. Interaction
-authority is an upper bound on local interaction, not an instruction to display
-a dialogue. An operation may apply a stricter veto, but cannot request an
-interaction which its caller did not permit. Remote refusal and incoming-peer
-consent remain independent decisions.
-
-```typescript
-type UnattendedTrigger = "resume" | "periodic" | "database-event" | "editor-save" | "file-open" | "merge" | "daemon";
-
-interface InteractionPermissions {
-    readonly peerSelection: boolean;
-    readonly localPeerAdmission: boolean;
-    readonly configurationExchange: boolean;
-    readonly failureRecovery: boolean;
-}
-
-type PermittedInteractionPermissions =
-    | (InteractionPermissions & { readonly peerSelection: true })
-    | (InteractionPermissions & { readonly localPeerAdmission: true })
-    | (InteractionPermissions & { readonly configurationExchange: true })
-    | (InteractionPermissions & { readonly failureRecovery: true });
-
-type InteractionAuthority =
-    | typeof NO_INTERACTION
-    | { readonly kind: "permitted"; readonly permissions: PermittedInteractionPermissions };
-
-const NO_INTERACTION = { kind: "forbidden" } as const;
-
-interface UserInitiatedOneShotRequest {
-    readonly trigger: "manual";
-    readonly interaction: InteractionAuthority;
-}
-
-interface UserInitiatedOneShot {
-    run(request: UserInitiatedOneShotRequest): Promise<ReplicationOutcome>;
-}
-
-interface UnattendedOneShot {
-    run(request: {
-        readonly trigger: UnattendedTrigger;
-        readonly interaction: typeof NO_INTERACTION;
-    }): Promise<ReplicationOutcome>;
-}
-```
-
-`NO_INTERACTION` is the only all-false authority. Shared immutable authority
-values are reused by hosts, avoiding a permission allocation per operation.
-Operation-specific requests, including P2P configuration exchange, carry the
-same upper bound and expose only relevant permissions. An unattended path may
-use persisted or automatic acceptance policy, but cannot obtain local
-interaction authority implicitly.
-
-The same authority bounds presentation. An unattended P2P path may retain an
-informational diagnostic, but no-target, authentication, tweak-mismatch, and
-overlapping-transfer settlements must not promote themselves to a Notice.
-User-initiated paths retain their existing Notice-level presentation. This is
-a caller-authority rule, not a new process-wide presentation framework.
-
-Outcomes do not collapse failure into `void` or `boolean`:
-
-```typescript
-const REPLICATION_COMPLETED = { status: "completed" } as const;
-const REPLICATION_CANCELLED = { status: "cancelled" } as const;
-
-type ReplicationOutcome =
-    | typeof REPLICATION_COMPLETED
-    | typeof REPLICATION_CANCELLED
-    | { readonly status: "blocked"; readonly reason: ReplicationBlockReason }
-    | { readonly status: "partial"; readonly detail: PartialReplicationDetail }
-    | {
-          readonly status: "failed";
-          readonly error: unknown;
-          readonly recoveryHint?: CentralCompatibilityRecoveryHint;
-      };
-```
-
-Completed and cancelled values are shared singletons or literals. Blocked,
-partial, and failed results may carry diagnostic detail. Central provider
-initialisation, reset, lock, unlock, and resolution settle only after their
-defined remote write succeeds; a Rebuilder must not continue after an ignored
-mutation failure.
-
-CouchDB and Object Storage Journal record one immutable central-compatibility
-decision inside the finite attempt which owns the connection or borrowed
-client. Only a rejection from that exact attempt becomes a recovery hint. A
-transport failure before assessment, or after an accepted assessment, cannot
-reuse mutable mismatch or lock state from an earlier attempt. P2P produces no
-central-compatibility decision. The recovery field is already specific to this
-contract, so its value carries the stable rejection reason and any preferred
-tweak value without a redundant kind discriminator.
-
-`cancelled` means that the requested finite operation did not reach its normal
-completion boundary. It does not promise rollback. A provider may retain
-documents and checkpoints from batches which had already settled before the
-cancellation signal was observed, and a later operation resumes from that
-durable state.
-
-### Preserve uncertainty at the boundary which owns the decision
-
-Capability availability and operation results are separate. A supported
-operation may fail, while an inapplicable operation must not be called or
-reported as a network attempt. A workflow which legitimately has no step for
-its topology may complete that branch without claiming that a provider ran an
-operation.
-
-Keep uncertainty where it changes a safety decision. In particular, an Object
-Storage read distinguishes `available`, `not-found`, and `unavailable` before a
-caller decides whether creation is permitted. Only explicit `not-found` may
-create Journal synchronisation parameters; an unavailable read cannot be
-converted to a missing value or a new Security Seed.
-
-This principle does not require one generic `RemoteObservation<T>` type or an
-active-read catalogue. Existing provider-specific inspection and maintenance
-methods may retain their current compatibility surface until their real
-consumers are migrated. When a later bounded migration needs to distinguish an
-observed zero or empty result from an unavailable inspection, that consumer
-owns the smallest explicit result type required by the decision.
-
-### Give active ownership and probes explicit boundaries
-
-`ReplicatorService` is the sole owner of the active Replicator. Replacement and
-disposal use one explicit quiescing transition under its transition lock:
-
-```text
-active -> quiescing -> closed -> replacement published
-```
-
-The transition removes the old publication from `current`, rejects later
-admission, requests the provider's supported transfer cancellation, and drains
-work which was already admitted. Only then does it close the old Replicator and
-publish another active context. Acquisitions ordered after the
-transition receive only the replacement. A cancellation failure does not
-permit the physical close boundary to be skipped. If admitted work cannot
-settle, no replacement is published. If physical close fails, the quiescing
-publication remains fenced so a later transition can retry that close before
-constructing a replacement.
-
-The publication object itself is the private generation identity; no separate
-generation number or public lease is required. Its reservation count is not the
-service-wide bounded-activity count or finite-replication count: those counts
-remain status and quiescence signals and can include trials, local work, and an
-outer Rebuilder flow which itself initiates a lifecycle transition. A switch
-which waited for either global count could therefore wait for the operation
-which is awaiting that same switch.
-
-Production consumers cannot synchronously inspect an unreserved active
-context. They must acquire it or run work inside the admitted callback boundary.
-The synchronous `inspectActiveReplicatorContext()` view is protected and exists
-only for lifecycle diagnostics and focused tests.
-
-The minimum consumer surface is a callback boundary,
-`runWithActiveReplicatorContext(callback)`, rather than an exposed lease or
-release token. Admission is ordered with lifecycle transitions, the callback
-receives one exact context, and private release runs in `finally` without
-entering the transition queue.
-
-The callback must not initiate or await settings realisation, database reset or
-replacement, active Replicator retirement, or another operation which queues
-the same lifecycle transition. Such recovery or reconfiguration is staged
-after the reserved dispatch settles. A process-wide re-entrancy flag would
-both reject unrelated asynchronous work and miss re-entry after an `await`, so
-the contract is documented and tested at the owning workflows rather than
-claimed as a reliable runtime detector.
-
-Failure presentation and recovery start only after the finite reservation has
-settled. A later remote mutation re-enters through the callback boundary and
-requires reference equality with the failed context. It cannot apply the
-decision produced by one publication to its replacement.
-
-An edited-settings trial is different: it owns an independent Replicator and
-connection, never borrows the active publication, and disposes both resources.
-An owned Security Seed resource also forces a fresh provider read for its
-settings snapshot. Reusing a process-cached synchronisation parameter would
-turn an observation made for an earlier flow into current trial evidence.
-
-Application suspension is a reversible host pause, not an ownership
-transition. `ReplicatorService` orders the provider's transfer-stop request but
-retains the active publication, accepts later work, and does not drain or close
-the Replicator. Provider-specific transport lifecycle, including P2P room and
-relay handling, remains independently owned.
-
-Plug-in unload is terminal and reuses the same quiescing retirement as disposal;
-it does not add another public state or unload capability. The lifecycle handler
-fences admission, requests transfer cancellation, drains admitted work, and
-closes the Replicator before `ControlService` closes the local database. This
-ordering matters even when disabling the plug-in leaves the JavaScript process
-alive.
-
-The generic stop role is an idempotent request to stop a provider transfer after
-transport work begins. It does not promise cancellation of readiness checks,
-Security Seed acquisition, or external storage calls which do not consume a
-cancellation signal. P2P implements this role through its room-session owner:
-the request aborts the current finite-operation scopes without closing the room
-or disabling later transfers. Its RPC request, incoming `reqSync`, and
-replication batch loop consume the same effective signal. An already-started
-atomic database operation may settle before cancellation completes, but no new
-batch is started afterwards.
-
-`getNewReplicator()` is not a general temporary-instance API. CouchDB and
-Object Storage Setup and settings flows request narrow connection or
-preferred-tweak probes. A resource-returning factory returns an owned resource
-with idempotent asynchronous `dispose()`. Trial settings are passed to the
-probe itself and cannot silently read active settings. P2P Setup instead uses
-the stable service's connection-probe admission described in Part 2. Only its
-idle continuation constructs and disposes a short-lived raw signalling trial.
-Neither form can replace the active Replicator or the P2P service.
-
-Streaming Fetch receives an owned Security Seed resource bound to its settings
-snapshot. The current compatibility implementation may construct an
-unpublished Replicator internally, but the resource owns and disposes it and
-cannot replace the active publication.
-
-### Keep initialisation workflows explicit
-
-- Fetch, Rebuild, overwrite, and first-device setup remain application
-  workflows. Their direction, reset, lock, peer selection, local-database work,
-  and convergence passes are not one Replicator capability.
-- CouchDB and Object Storage use their established workflow-local directional
-  adapters and central administration where required.
-- A P2P first device prepares only its local state. An additional P2P device
-  selects a peer and uses the real finite download path; P2P does not emulate a
-  central reset, lock, milestone, or upload.
-- CouchDB Streaming Fetch remains a separate initial-transfer service and uses
-  only its owned Security Seed dependency.
-
-The `EVENT_DATABASE_REBUILT` continuation remains separately authorised and
-does not imply `syncOnStart` or P2P AutoStart. Complete Rebuilder and
-maintenance-facade migration is a later bounded change rather than a condition
-for the active Replicator core.
-
-## Target capability matrix for current providers
-
-`S` means supported, `NI` means not implemented, and `NA` means not applicable.
-Configuration and reachability are request preconditions or outcomes, not
-support states.
-
-| Active provider role                   | CouchDB | Object Storage | P2P |
-| -------------------------------------- | ------- | -------------- | --- |
-| User-initiated OneShot Sync            | S       | S              | S   |
-| Unattended OneShot Sync without UI     | S       | S              | S   |
-| Ordinary long-lived Continuous session | S       | NA             | NA  |
-| Request to stop active transfer        | S       | S              | S   |
-
-Every provider definition records the Continuous row explicitly. CouchDB
-supplies its runner, while Object Storage and P2P declare the role not
-applicable; omission is not a fourth support state.
-
-The current definition also declares the finite resources and the one optional
-central facility which have real consumers:
-
-| Provider-owned facility                       | CouchDB | Object Storage | P2P    |
-| --------------------------------------------- | ------- | -------------- | ------ |
-| Connection probe                              | S       | S              | NA     |
-| Preferred-tweak probe                         | S       | S              | NA     |
-| Security Seed resource                        | S       | S              | NA     |
-| Synchronisation-information resource          | S       | NA             | NA     |
-| Cohesive central-remote administration runner | S       | S              | absent |
-
-`remoteResources` is exhaustive over its four stable machine keys, so adding a
-resource requires an explicit decision from every composed provider. The
-central-remote administration field is optional because there is no corresponding
-P2P facility. Actions within that runner are the current central protocol, not
-an exhaustive capability table imposed on every Replicator.
-
-The public contract is named `CentralRemoteAdministration*` because every
-current action, observation, failure, and postcondition belongs to that central
-milestone protocol. Established CLI command names remain unchanged.
-
-The P2P Setup signalling check is not the P2P entry in the provider-owned
-connection-probe row. P2P has no central connection resource; its
-`P2PConnectionProbeAdmission` is a focused view of the independently composed
-P2P service. It compares requested relays with the binding held by the existing
-room-session owner as specified in Part 2; it adds neither a process-global
-lease nor a second owner.
-
-The following concerns deliberately stay outside this capability matrix:
-
-| Concern                                                          | Current owner                                                          |
-| ---------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| Directional Fetch and Rebuild                                    | Application workflow over provider-specific adapters                   |
-| Streaming Fetch                                                  | CouchDB initial-transfer workflow plus an owned Security Seed resource |
-| On-demand remote Chunks and compromised-Chunk inspection         | CouchDB compatibility or maintenance consumers                         |
-| Remote size, Garbage Collection, compaction, and device registry | Provider-specific inspection and maintenance flows                     |
-| P2P room, relay, peer selection, admission, watch, and broadcast | Stable P2P service and room-session owner in Part 2                    |
-
-P2P unattended OneShot means a role exists which uses configured target names
-without opening a dialogue. Peer-room, watch, acceptance, and broadcast roles
-are provider-specific facets, not the ordinary Continuous role; their trigger
-matrix and de-duplication rules are owned by Part 2.
-
-## Alternatives rejected
-
-### Move the resume handler and retain a `remoteType` switch
-
-This would fix issue 1140 narrowly, but would leave future providers and
-triggers subject to the same omission. It would not stop automatic P2P calls
-from reaching an interactive method, and capability semantics would remain
-implicit.
-
-### Use only optional methods or Boolean support flags
-
-Optional runtime roles are useful, but they do not force a support decision when
-a provider or catalogue entry is added. Exhaustive support metadata plus a
-typed builder keeps runtime interfaces small while requiring the decision at
-compile time.
-
-### Use only a provider-discriminated union
-
-A provider union is appropriate for provider-specific maintenance after
-explicit narrowing. It cannot model adjunct P2P beside another selected main
-provider and is not a generic feature test.
-
-### Tag every value and hot-path return
-
-Uniform wrappers would add allocation and noise to Chunk, document,
-changes-feed, and queue paths without improving semantics where an identity is
-safe. Tags remain for low-frequency observations and outcomes which affect
-control flow.
-
-### Retain `getNewReplicator()` as the trial and command factory
-
-The handler is order-dependent, can suppress construction errors, and can
-replace a feature-owned P2P transport. Flow-specific probes and the stable P2P
-service make ownership explicit.
-
-### Treat neutral compatibility results as supported operations
-
-Dummy zero counts, empty Security Seeds, false values, and silent mutations
-lose distinctions required for safety and recovery. A neutral value remains
-only when every caller proves it to be the operation's identity.
-
-## Consequences
-
-- `syncOnStart` becomes an application policy for every unattended finite
-  provider which supports it, rather than a CouchDB module behaviour.
-- Adding a current provider or capability requires an explicit compile-time
-  support decision.
-- Unsupported central operations are no longer represented as successful P2P
-  no-ops or transport errors.
-- Safe identities remain simple, while safety-sensitive observations are
-  explicit.
-- Setup and trial configuration cannot replace an active or adjunct transport.
-- Central mutations and integrity checks cannot silently turn failure or
-  unavailability into success.
-- P2P remains first-class without being mislabelled as central Continuous
-  replication.
-
-## Non-goals
-
-- Do not introduce third-party remote-provider registration.
-- Do not redesign every replication result or user-facing message in one
-  change.
-- Do not make Streaming Fetch a generic Replicator capability.
-- Do not make P2P pretend to own a central remote database.
-- Do not infer support from `remoteType`, constructor identity, a falsy result,
-  or a neutral value.
-- Do not redefine `syncOnStart` as a once-per-process setting.
-- Do not change established profile persistence or Setup flag-file restart
-  ordering as part of this capability split.
-
-## References
-
-- [Part 2: P2P service and session lifecycle](2026_08_replicator_capabilities_02_p2p_service_lifecycle.md)
-- [Part 3: migration plan and verification](2026_08_replicator_capabilities_03_migration_plan.md)
-- [Bounded Remote Activity](2026_07_bounded_remote_activity.md)
-- [Make Onboarding Profile-Aware](2026_07_multiple_remote_onboarding.md)
-- [P2P Room and Transport Lifecycle](2026_07_p2p_transport_lifecycle.md)
-- [P2P Transport Compatibility Controls](2026_08_p2p_transport_compatibility.md)
-- [CouchDB Remote Connection Ownership](2026_08_couchdb_remote_connection_ownership.md)
-- [Package the Common Library Behind Explicit Host Boundaries](2026_07_common_library_package_boundary.md)
-- [Self-hosted LiveSync issue 1140](https://github.com/vrtmrz/obsidian-livesync/issues/1140)
-- [Self-hosted LiveSync issue 1147](https://github.com/vrtmrz/obsidian-livesync/issues/1147)

docs/adr/2026_08_replicator_capabilities_02_p2p_service_lifecycle.md

@@ -1,384 +0,0 @@
----
-date: 2026-08-27
-commonlib-version: "0.1.19"
-self-hosted-livesync-version: "1.0.21"
-status: proposed
-series: replicator-capabilities-and-lifecycle
-part: 2 of 3
----
-
-# Architectural Decision Record: Replicator Capabilities and Lifecycle Orchestration — Part 2: P2P Service and Session Lifecycle
-
-Series navigation: this is Part 2 of 3. Read [Part 1: core contract](2026_08_replicator_capabilities_01_core_contract.md)
-first, then continue with [Part 3: migration plan and verification](2026_08_replicator_capabilities_03_migration_plan.md).
-
-## Status
-
-Proposed. This record defines the P2P service owner, room-session boundary,
-narrow contract views, automation demands, replacement fencing, and trigger
-semantics. Generic provider and capability rules are owned by Part 1; the
-implementation and verification order is owned by Part 3.
-
-The implemented state is recorded separately in Commonlib's
-`docs/p2p-transport-lifecycle.md` design document. It supersedes the
-replaceable LiveSync P2P Replicator and current-result ownership described by
-the accepted [P2P Room and Transport Lifecycle](2026_07_p2p_transport_lifecycle.md)
-record. The accepted record's decisions about serialised room operations,
-`room.leave()`, Trystero-owned physical peers, and relay reconnection remain in
-force. This ADR remains the decision and migration target; the Commonlib
-design document records the names and ownership boundaries which actually
-landed.
-
-## Scope and context
-
-The Commonlib P2P feature currently spans `TrysteroReplicatorP2PServer`,
-`TrysteroReplicator`, and the LiveSync-specific `LiveSyncTrysteroReplicator`.
-The current result resolves a replaceable Replicator while the room, signalling,
-watch, broadcast, diagnostics, platform-event subscriptions, and database
-feeds have longer-lived relationships. Installing that replaceable object as
-the active Replicator makes ordinary active-handle disposal capable of closing
-an adjunct or policy-owned room.
-
-The same room membership serves several independent behaviours:
-
-- P2P AutoStart opens the room and signalling service;
-- AutoSync reacts to an advertised and accepted peer with one finite transfer;
-- AutoWatch follows later changes broadcast by a selected peer;
-- AutoBroadcast publishes local database changes;
-- explicit commands pull, push, or synchronise against a selected peer;
-- incoming `reqSync` requests pull from an accepted peer; and
-- diagnostics and platform events observe the transport.
-
-These behaviours must share one room owner, but they must not share one
-implicit policy. A setting change may replace the room session while another
-provider remains the selected main remote. A setup probe must not close that
-session. A finite operation may need a room even when AutoStart is disabled.
-
-## Decision
-
-### One stable P2P service owns each room session
-
-The host composes one stable P2P service independently of the selected main
-provider. It may be present as an adjunct beside CouchDB or Object Storage, or
-its non-owning adapter may serve as the selected main P2P Replicator. The host
-owns the service lifetime; the service owns all LiveSync-specific room
-resources.
-
-A **P2P room session** is one active room membership and every resource whose
-validity depends on that membership:
-
-- the Trystero room, RPC actions, and `RpcRoom`;
-- its internal session epoch, session controller, and finite-operation
-  registry;
-- advertisement state and temporary peer decisions;
-- peer-bound RPC clients and remote database proxies;
-- connection, diagnostic, and platform-event subscriptions; and
-- RPC publication, the watch set, database and broadcast change feeds, and
-  in-flight finite-transfer de-duplication bound to the local database.
-
-A **session epoch** is the internal identity and fence of one room-session
-object. It is not a public capability, a persisted profile identifier, or a
-synonym for the logical room. Peer callbacks and finite-operation tokens carry
-that identity and cannot be routed into a replacement session.
-
-Closing or replacing a session fences its epoch, stops new operations, settles
-or fails in-flight work, closes RPC and client resources, and leaves the room
-in the transport-owned order. Persisted peer acceptance decisions survive;
-temporary decisions, advertisements, clients, listeners, and feeds do not.
-The underlying WebRTC peer remains under Trystero's shared-peer ownership as
-specified by the accepted lifecycle record.
-
-### Expose narrow contract views
-
-The service does not expose a room session, raw host, or concrete Replicator to
-ordinary consumers. It supplies these views over the same owner:
-
-1. `P2PTransportLifecycle` observes room state and accepts explicit,
-   user-owned connect or disconnect requests.
-2. `P2PConnectionProbeAdmission` arbitrates a complete Setup signalling check
-   against the current relay binding without exposing or replacing the room.
-3. `P2PPeerDirectory` supplies peer snapshots and peer arrival or departure.
-4. `P2PPeerAdmission` evaluates incoming peers and administers temporary or
-   persisted acceptance decisions.
-5. `P2PTargetedTransfer` performs pull, requested push, and bidirectional
-   finite synchronisation against an explicit peer, and executes the persisted
-   configured-target set without interactive peer selection.
-6. `P2PChangeRelay` administers peer watch and local-change broadcast.
-7. `P2PConfigurationExchange` performs peer configuration exchange under its
-   declared interaction authority.
-8. `P2PDiagnostics` supplies status and RTC diagnostics without exposing raw
-   room or peer connections.
-
-These are stable service-level contract views, not independent wrapper or state
-owners. One implementation may satisfy several views.
-Advertisement and admission state remain under one peer-access owner, while
-pull, push, and bidirectional transfer remain under one transfer owner. A
-consumer which needs more than one view receives those views explicitly; it
-does not receive a general P2P context or service locator.
-
-The views resolve the current published session at invocation. Finite transfer
-work which carries an old epoch is rejected or cancelled rather than dispatched
-into a replacement. A configuration or diagnostic request which was already
-admitted may settle against its originating session, while persisted peer
-admission decisions intentionally settle independently of room replacement.
-These operations are outside active-transfer cancellation and cannot publish
-the former session's peer callbacks or status into its replacement. The epoch
-remains internal. The active P2P Replicator is a non-owning adapter over the
-views, and its disposal cannot implicitly leave the service-owned room.
-
-### Make explicit disconnect a veto, not another policy demand
-
-`P2PTransportLifecycle` distinguishes user intent from automation:
-
-- explicit connect resumes relay reconnection and establishes a user-owned
-  room demand;
-- explicit disconnect is the sole force-close path, retires the current
-  session, invalidates all demands under the retirement contract, pauses relay
-  reconnection, and establishes a service-lifetime veto against AutoStart; and
-- only a later explicit connect clears that veto.
-
-Automated policies and finite operations acquire or release only their own
-demands. They cannot close a room held by another demand and cannot override an
-explicit disconnect veto. This is a lifecycle veto, not the opposite of
-`InteractionAuthority`: local interaction authority is the upper bound used by
-operations, as specified in Part 1. An operation may impose a stricter veto,
-but an unattended operation cannot gain permission to open a dialogue.
-
-`EVENT_DATABASE_REBUILT` is a separately authorised continuation of the owning
-Rebuilder workflow, not an AutoStart demand. After the replacement database is
-ready, that continuation may request a room independently of the AutoStart
-veto. It does not clear the veto for later automatic-start events.
-
-### Separate automation policy from room ownership
-
-P2P automation is a composed service feature. It owns `P2P_AutoStart`,
-AutoSync, AutoWatch, and AutoBroadcast policy, including delayed work and
-automatic-trigger coalescing. It consumes the transport, peer, admission,
-transfer, and change-relay views but does not own their mutable state.
-
-`P2PChangeRelay` owns the actual watch set and database changes feed.
-`P2PTargetedTransfer` owns explicit finite-transfer and configured-target
-execution. The stable automation coordinator owns baseline de-duplication
-shared by AutoSync and configured-target requests. Incoming-peer consent is
-distinct from a local caller's authority to select a peer or open a dialogue.
-Persisted or automatic acceptance may authorise an unattended path; it cannot
-create local interaction authority implicitly.
-
-Every finite operation which needs a room obtains an internal demand from the
-room-session owner. Once a session admits the operation, that session owns its
-operation controller and settlement. The operation consumes an effective
-signal composed from the room session, its operation controller, and any
-narrower caller or incoming-RPC signal. Neither the adapter nor the UI consumer
-owns this bookkeeping.
-
-Acquiring another demand does not open another session. Releasing it never
-closes a session still required by AutoStart, another finite operation, or
-another host consumer. A request to stop active transfer aborts the registered
-finite-operation controllers but does not abort the room-session controller;
-the room remains usable and later transfers obtain fresh operation controllers.
-Retiring the room session aborts its session controller, which cancels every
-remaining child operation. Demand and controller bookkeeping is internal to the
-service and is not a general consumer contract; it cannot turn a finite transfer
-into persistent transport policy.
-
-Cancellation is cooperative and does not roll back durable work. Pull,
-requested push, and bidirectional synchronisation propagate the effective
-signal through the initiating RPC, incoming `reqSync`, the reverse database RPC
-calls, and the replication batch loop. An atomic PouchDB read or write which has
-already begun may settle. If a batch write has begun, the operation processes
-its successful writes and records the batch checkpoint only after every
-required revision has settled successfully. Cancellation before the write does
-not advance that checkpoint. The operation then reports a cancelled result and
-does not start another batch. Session retirement awaits that settlement before
-releasing RPC and room resources.
-
-### Reconcile session settings atomically
-
-The effective P2P session binding is derived from the selected profile, all
-settings which affect transport or session-bound automation, and the current
-local database identity. It is not a new persisted profile identifier or a
-device-local override. The service reconciles this binding independently of
-the selected main provider, so an adjunct room can be replaced while CouchDB
-or Object Storage remains active.
-
-A change to any binding input retires the whole room session and opens a
-replacement when policy still requires one. Replacing a policy-only setting
-may cause a temporary disconnect, but it preserves one atomic listener and
-policy boundary: advertisements and temporary peer decisions are reacquired,
-while persisted peer decisions survive. AutoStart reconnects when it remains
-enabled and no explicit-disconnect veto is active. No old listener, credential,
-client, or policy demand remains reachable after replacement.
-
-The candidate captures its settings, device identity, and local database object
-when it is constructed. The owner re-reads the effective binding after the room
-has opened and publishes the candidate only when it still matches. A setting or
-database change during open therefore retires the stale candidate rather than
-making it current.
-
-Reconciliation is serialised with room lifecycle operations:
-
-1. fence new session work;
-2. abort the old session's finite-operation scopes and await their cooperative
-   settlement;
-3. close and leave the old room in transport-owned order;
-4. open and validate the candidate session; and
-5. publish the replacement only after it has opened successfully.
-
-The service never exposes a partly initialised candidate or treats a cancellation
-request as rollback. If bounded settlement or candidate opening fails,
-reconciliation reports the failure and publishes no mixed old and new session.
-A candidate-open failure leaves one observable disconnected state with policy
-demands unsatisfied; it does not revive the fenced session or start an unbounded
-retry loop. A later lifecycle trigger or explicit connect may retry.
-
-### Order local database replacement across both owners
-
-The database lifecycle transition owns ordering above `ReplicatorService` and
-the P2P service:
-
-1. fence acquisition of active Replicator and P2P room work;
-2. retire the active adapter;
-3. settle and retire P2P database-bound feeds and publication;
-4. publish the replacement local database identity only after both boundaries
-   have settled;
-5. rebind or replace the active provider;
-6. reconcile P2P against the new database identity; and
-7. let the Rebuilder request its separately authorised reopen.
-
-Each service serialises its own resources. The database transition owns the
-cross-service ordering rather than introducing one transport-wide lock. Reset
-preparation and explicit database close both await service-owned room
-retirement before database managers are torn down and the old physical handle
-is destroyed or closed. Explicit close settles every registered cleanup handler
-sequentially, even when an earlier cleanup fails; its aggregate result is
-diagnostic rather than a close veto.
-
-### De-duplicate by logical lifecycle, not by room epoch
-
-Completed AutoSync baselines are scoped by normalised peer name and application
-lifecycle generation. In-flight baseline promises are indexed by normalised
-peer name until they settle. Trigger provenance and session epoch are not part
-of either lookup, so a transport-only reconnect cannot repeat an in-flight or
-completed baseline transfer.
-
-Both the in-flight baseline promise and completed baseline history belong to
-the stable automation coordinator and survive transport-only or policy-only
-session replacement. The originating room session still owns cancellation and
-settlement of the actual transfer. A lifecycle or logical-identity change clears
-completed history, but does not clear an in-flight promise. A request for the
-same normalised peer name may therefore share that promise until it settles.
-Work from an older automation generation may settle, but cannot publish
-completion into the current generation. Only completed per-peer baselines are
-recorded; partial requests record completed peers only, while blocked,
-cancelled, failed, and incomplete peers remain eligible for a later bounded
-retry.
-
-The automation owner clears settled records when the logical peer namespace or
-local database identity changes. It retains them across transport-only and
-policy-only replacement. Watch may follow a later advertised change, but does
-not immediately repeat a completed baseline transfer.
-
-### Define the P2P trigger matrix
-
-| Trigger                 | Required preconditions                                                | Effect                                       |
-| ----------------------- | --------------------------------------------------------------------- | -------------------------------------------- |
-| `P2P_AutoStart`         | P2P enabled, active lifecycle generation, and no user disconnect veto | Open room; do not itself transfer files      |
-| `P2P_AutoSyncPeers`     | Open room, matching advertisement, and accepted peer policy           | Run one bidirectional finite synchronisation |
-| `P2P_AutoWatchPeers`    | Open room, matching accepted advertisement, and remote broadcasting   | Pull later announced updates                 |
-| `P2P_AutoBroadcast`     | Open room and local broadcasting enabled                              | Announce later local database changes        |
-| `P2P_SyncOnReplication` | Configured names and advertisements received within a bounded wait    | Run target-aware unattended OneShot Sync     |
-| Explicit peer command   | Supplied peer target and accepted connection                          | Run user-owned finite synchronisation        |
-| Incoming `reqSync`      | Accepted peer and ordinary readiness                                  | Pull from requesting peer                    |
-
-`P2P_AutoStart` is a transport policy, not central Continuous replication and
-not `syncOnStart`. AutoSync, AutoWatch, and accepted incoming requests remain
-unattended when their persisted policies permit them. A configured-target
-request waits for advertisement for a bounded period; it does not inspect a
-possibly stale snapshot immediately after opening. Missing, undiscovered,
-unaccepted, or partly successful targets are explicit operation results. An
-unknown peer never opens an acceptance dialogue on an unattended path.
-
-Delayed opens belong to the lifecycle generation which scheduled them.
-Suspension cancels them or makes them harmless, and the callback rechecks
-current settings and suspension state before opening. Ordinary automation uses
-the trigger-aware readiness policy rather than bypassing readiness, pending-file
-settlement, clean-up, or version gates. Fetch and Rebuild retain their
-separately authorised bypasses.
-
-### Arbitrate Setup signalling checks through the room owner
-
-The current Setup check establishes only whether its signalling transport can
-be opened. It does not validate peer discovery, room credentials against
-another device, or a TURN or WebRTC data path. The host therefore receives a
-`P2PConnectionProbeAdmission` view over the existing room-session owner instead
-of constructing an uncoordinated second transport.
-
-The admission receives the requested relay settings and a continuation which
-owns one short-lived raw signalling trial. The room owner serialises the whole
-decision on its existing lifecycle queue:
-
-- a serving room whose active relay set covers every requested relay returns
-  `observed-active` without entering the continuation;
-- a serving room which does not cover the requested relay set returns the
-  stable `active-p2p-relay-binding-conflict` decision code without entering the
-  continuation; and
-- an idle owner runs the continuation and does not settle admission until the
-  caller has disposed the raw Replicator and its temporary database.
-
-Relay admission uses the same split-and-trim projection as transport setup,
-then compares de-duplicated sets. It does not infer URI equivalence which the
-Trystero relay key does not implement. The continuation must not await another
-lifecycle transition on the same service while it holds this serialisation
-boundary.
-
-This view adds neither a second room owner nor a process-global relay lease.
-It does not change raw `TrysteroReplicator.dispose()` semantics, pause or close
-an active relay, or silently retire the active service to make an incompatible
-trial possible. A future check which genuinely needs peer-, room-, TURN-, or
-WebRTC-level evidence requires its own bounded contract rather than widening
-this signalling-only result implicitly.
-
-### Keep provider composition explicit
-
-The stable P2P service can be composed even when P2P is not the selected main
-provider, while the generic provider table in Part 1 can include or omit the
-P2P provider at compile time. No runtime unknown-provider registry is implied.
-When P2P is selected as main, its active adapter delegates to this same service
-and does not publish a second P2P lifecycle owner.
-
-## Consequences
-
-- P2P room, signalling-check admission, peer, watch, acceptance, transfer,
-  configuration, and diagnostics have one explicit owner and focused
-  contracts.
-- Disposing an active adapter cannot close a policy-owned or adjunct room.
-- Explicit user disconnect has a clear veto boundary and cannot be undone by
-  AutoStart or a finite operation.
-- Finite operations can request a room without changing persistent room policy.
-- Settings and local database replacement cannot publish mixed-session state.
-- Reconnects do not repeat completed baseline transfers merely because the room
-  epoch changed.
-- Setup can observe a compatible active signalling binding or run an idle
-  trial without mutating the active transport; an incompatible active binding
-  is reported explicitly.
-
-## Non-goals
-
-- Do not make the P2P service a general service locator.
-- Do not expose room, raw host, peer connection, or concrete Replicator state
-  to ordinary consumers.
-- Do not make P2P own a central remote database.
-- Do not reinterpret P2P AutoStart as `syncOnStart` or central Continuous
-  replication.
-- Do not replace the accepted Trystero physical-peer and relay ownership
-  decisions.
-- Do not add unbounded retry loops or pretend that a missing lower-level stop
-  operation is end-to-end cancellation.
-
-## References
-
-- [Part 1: core contract](2026_08_replicator_capabilities_01_core_contract.md)
-- [Part 3: migration plan and verification](2026_08_replicator_capabilities_03_migration_plan.md)
-- [P2P Room and Transport Lifecycle](2026_07_p2p_transport_lifecycle.md)
-- [P2P Transport Compatibility Controls](2026_08_p2p_transport_compatibility.md)
-- [Bounded Remote Activity](2026_07_bounded_remote_activity.md)

docs/adr/2026_08_replicator_capabilities_03_migration_plan.md

@@ -1,576 +0,0 @@
----
-date: 2026-08-27
-commonlib-version: "0.1.19"
-self-hosted-livesync-version: "1.0.21"
-status: proposed
-series: replicator-capabilities-and-lifecycle
-part: 3 of 3
----
-
-# Architectural Decision Record: Replicator Capabilities and Lifecycle Orchestration — Part 3: Migration Plan and Verification
-
-Series navigation: this is Part 3 of 3. Start with [Part 1: core contract](2026_08_replicator_capabilities_01_core_contract.md),
-then [Part 2: P2P service and session lifecycle](2026_08_replicator_capabilities_02_p2p_service_lifecycle.md).
-This part owns implementation sequencing and verification; it does not add
-another runtime contract.
-
-## Status
-
-Proposed. The stages below are an implementation and verification order, not
-independently releasable states. Commonlib and Self-hosted LiveSync must not
-publish temporary support boundaries described by an incomplete stage. A
-release follows only after the target matrix, ownership boundaries, and the
-contracted production-consumer migrations in Parts 1 and 2 are complete.
-
-## Migration rules
-
-Each Commonlib change first runs its focused unit and type-contract tests,
-builds and validates the packed artefact, installs that exact artefact in
-Self-hosted LiveSync, and runs focused downstream tests before either
-repository advances. Compatibility methods remain until every production
-consumer has migrated.
-
-The smallest vertical contract which fixes issue 1140 takes priority over
-unrelated probe, Fast Fetch, maintenance, integrity, and facade work. A stage
-must not claim completion when it only changes a type declaration while a
-production caller still uses the old ownership or interaction path.
-
-## Stage 1: reproduce the current boundary failures
-
-Add the smallest regression which configures an Object Storage active provider,
-enables `syncOnStart`, invokes the resume lifecycle after readiness, and
-expects one unattended finite synchronisation. Run it against 1.0.21 and
-confirm the expected failure: the CouchDB-owned lifecycle handler excludes
-Object Storage. Cover both an ordinary Object Storage profile and a migrated
-profile which retains `liveSync: true`; unsupported Continuous must not suppress
-the supported `syncOnStart` OneShot policy.
-
-Add passing characterisation tests which inventory automatic P2P periodic,
-database-save, editor-save, file-open, and merge triggers, together with P2P
-AutoSync, AutoWatch, incoming-request, and nested finite-activity paths. These
-tests record current ownership and dialogue behaviour so that later stages do
-not accidentally remove a valid automatic path.
-
-## Stage 2: fix issue 1140 through the minimum vertical contract
-
-Add the fixed provider definitions and the minimum user-initiated, unattended,
-and Continuous roles to Commonlib. Give `ReplicationService` typed entry points
-which carry trigger and interaction policy. Immediately before changing
-Object Storage handling, add a failing test in which a stopped or failed
-journal transfer must not produce a completed outcome; then propagate the
-actual journal result.
-
-Add the LiveSync-owned replication scheduling serviceFeature, remove the resume
-handler from `ModuleReplicatorCouchDB`, and route CouchDB Continuous and OneShot
-Sync plus Object Storage `syncOnStart` through `ReplicationService`. Its private
-context owns scheduling state, module-level functions implement transitions,
-and the serviceFeature owns lifecycle and settings-handler registration.
-Migrate every automatic caller to
-the unattended entry point in this stage, so periodic and event calls cannot
-fall back to an interactive P2P role. Migrate manual commands to the
-user-initiated entry point.
-
-Replace the factory-registration-only responsibilities of
-`ModuleReplicatorCouchDB` and `ModuleReplicatorMinIO` with composed provider
-definitions. Retain a module only for separately identified stateful
-behaviour; do not retain an instance merely to add a construction handler.
-
-Serialise active initialisation, replacement, and disposal. Publish the active
-provider and Replicator as one context after initialisation, clear that context
-before retiring the old adapter, and keep each typed dispatch on one context
-snapshot. This is the minimum publication fence for this stage. Waiting for
-in-flight adapter work and making acquisitions wait for replacement settlement
-remain part of the later active-construction migration.
-
-The scheduling context coalesces its network work internally, but an
-`onResumed` handler settles once that work has been scheduled. It does not hold
-later resume consumers until a OneShot transfer or Continuous start has
-settled. Pass one private context with narrow replication, settings, lifecycle,
-timer, and logging collaborators to module-level functions. Return only the
-daemon-facing control view, pass it to host composition, and inject it into the
-CLI command context. Do not retain the view as a public `LiveSyncBaseCore`
-property or retain scheduling state in a core-keyed `WeakMap`.
-
-At this boundary, existing P2P AutoSync, AutoWatch, and incoming-request
-entry points receive the same non-interactive readiness and accepted-peer gate.
-The no-interaction authority reaches counterpart RPC authorisation and
-broadcast progress notifications. An unknown peer is blocked rather than
-prompting.
-
-Add focused Commonlib owner tests which start an unattended finite room demand
-before AutoStart demand and after AutoStart demand. Both orders retain one room
-until every remaining demand has settled. The LiveSync feature-binding test
-must not rely on the current registration order of equal-priority resume
-handlers.
-
-Until Stage 4 supplies target-aware unattended P2P, each host composition
-declares generic `P2P_SyncOnReplication` as `not-implemented`. Its automatic
-request settles without UI with an explicit blocked result. Existing AutoSync,
-AutoWatch, and accepted incoming-request paths continue with the Stage 2 gate.
-This is a temporary migration state, not the target matrix in Part 1.
-
-Apply and test the CLI scheduling precedence defined in Part 1, so the daemon
-and scheduling context cannot schedule duplicate initial or recurring work.
-Replace `ModuleReplicationLifecycle` and the replication-specific
-`ModulePeriodicProcess` wiring only after equivalent context and feature-
-binding tests pass. Reuse the existing timer implementation behind a narrow
-timer port; changing other periodic feature owners is outside this stage.
-
-## Stage 3: make P2P transport ownership truthful
-
-Introduce the stable P2P service and its narrow contract views around the
-existing implementation while preserving transfer semantics and changing the
-necessary ownership and lifecycle behaviour. Make the active P2P Replicator a
-non-owning adapter. Give the service exclusive ownership of room sessions,
-session-epoch fencing, effective session binding, room open/close/replacement,
-and settings reconciliation. Consolidate overlapping resume and
-settings-event handlers.
-
-Migrate Obsidian panes and commands to lifecycle, peer, admission, transfer,
-change-relay, configuration-exchange, and diagnostic views as required. Migrate
-CLI and WebPeer away from concrete-class checks and raw host or room access.
-Preserve RTC diagnostics through `P2PDiagnostics`, rather than retaining
-`rawHost`. The compatibility facade may delegate during this stage, but new
-consumers cannot receive it.
-
-Separate active-adapter release, room-session leave, and the stop request.
-Implement the lower-level cooperative cancellation path before declaring the
-P2P stop role supported: caller abort through RPC request cancellation,
-incoming-handler signal propagation, signal-bound reverse database RPC calls,
-and safe batch-boundary termination in `replicateShim`. Add room-session and
-operation controllers beside internal session-demand ownership for finite
-operations and policy-held AutoStart, without exposing that bookkeeping as a
-general consumer API.
-
-Add ownership regressions immediately before implementation:
-
-- replacing or disposing the active main adapter does not close a policy-owned
-  or adjunct room;
-- a disposed session fences late callbacks and clients;
-- a P2P setting change replaces an adjunct room while another provider remains
-  the active main remote;
-- persisted peer decisions survive replacement, while temporary decisions and
-  advertisements do not;
-- local database replacement retires database-bound feeds and publication
-  before manager teardown;
-- explicit database close settles every dependent cleanup owner before closing
-  the physical handle, even when an earlier cleanup reports failure;
-- repeated replacement does not retain platform-event subscriptions;
-- an active-transfer stop aborts finite operations without closing the room,
-  while a later operation can use the same room;
-- room retirement aborts both locally initiated and incoming `reqSync` work,
-  waits for an already-started atomic database operation to settle, and starts
-  no later batch;
-- RPC cancellation, timeout, peer departure, and room close abort a
-  cancellation-aware handler rather than only discarding its eventual result;
-- the inbound request context exists before request admission begins, so a
-  cancellation received while admission waits cannot be lost;
-- cancellation retains already-settled documents and checkpoints and reports
-  `cancelled`, rather than claiming rollback or completion;
-- a per-document batch-write failure does not advance the replication
-  checkpoint past the failed revision;
-- explicit disconnect suppresses AutoStart and relay reconnection until
-  explicit connect, while a separately authorised rebuild continuation can
-  reopen the room without clearing that automatic-start veto;
-- a candidate whose settings, device identity, or database binding changes
-  while it opens is retired instead of published; and
-- database replacement fences both active-provider and P2P work before
-  publishing the new database identity, while a failed candidate leaves one
-  observable disconnected state without reviving the fenced session.
-
-When this stage lands, add a supersession note to the accepted P2P lifecycle
-record and update `devs.md` from the replaceable concrete Replicator getter to
-the stable contract views. Preserve the accepted Trystero peer and relay
-ownership rules rather than rewriting their historical verification.
-
-## Stage 4: add target-aware unattended P2P orchestration
-
-Before implementation, add failing regressions for the headless result-loss
-path, delayed advertisement, an unaccepted peer, overlapping configured-target
-and AutoSync requests, suspension before delayed open, and a finite-operation
-demand beside policy-owned AutoStart demand.
-
-Implement target-aware unattended P2P work without UI. Add bounded
-advertisement waiting, peer-acceptance outcomes, finite-operation demands beside
-policy demands, lifecycle-generation cancellation for delayed opens, and
-de-duplication across AutoSync and configured-target baseline requests. Keep
-AutoWatch as the relay for later changes rather than treating it as another
-baseline transfer.
-Route P2P automation through trigger-aware readiness without central-remote
-Security Seed preflight. Add the missing finite-activity boundary to direct
-shared-pane synchronisation.
-
-Keep the detailed wait, session-demand, de-duplication, and session-epoch state
-machine in Part 2 rather than expanding the generic provider contract. If
-implementation evidence requires a refinement, amend Part 2 before completing
-this stage. After Stage 3 is complete, Part 2 supersedes the
-replaceable-Replicator and current-result ownership portions of the accepted
-July 2026 record; its Trystero peer and relay decisions remain unchanged.
-
-Commonlib's `docs/p2p-transport-lifecycle.md` design document records the
-implemented Stage 3 and Stage 4 ownership, demand, automation, replacement,
-and shutdown behaviour. This document remains the migration and verification
-sequence rather than a second description of the implemented state.
-
-## Stage 5: separate active construction and flow-specific probes
-
-Make active creation a private, exhaustive `ReplicatorService` operation with
-one configuration identity and replacement policy. Migrate every non-active caller
-before restricting `getNewReplicator()`: CouchDB connection and passphrase
-checks, Object Storage connection and preferred-tweak trials, P2P Setup
-signalling trials, CLI commands, and other host compositions. Prove that every probe leaves
-the active main Replicator and adjunct P2P transport unchanged.
-
-Migrate Streaming Fetch to the owned CouchDB initial-transfer dependencies
-defined in Part 1. Add replacement-fence, late-settlement,
-configuration-identity, cache-invalidation, and probe-disposal tests before
-making active construction private.
-
-### Implementation position after Stage 5
-
-The provider-defined active-construction path is now private to
-`ReplicatorService`. The public `getNewReplicator` handler remains as a
-compatibility surface, but current Self-hosted LiveSync production code no
-longer calls it. Its removal belongs to Stage 7 after any external compatibility
-decision has been made.
-
-The current host composition has migrated CouchDB and Object Storage connection
-checks, passphrase inspection, preferred-tweak reads, CLI remote status and
-administration, P2P Setup, and Streaming Fetch Security Seed access away from
-active construction and towards owned resources or focused services. Active
-replacement is serialised, context acquisition waits for a queued replacement,
-late candidates are fenced, and short-lived resources are disposed.
-
-Stage 5 made the P2P Setup trial separately owned, but did not yet arbitrate it
-against the active relay binding held by the stable P2P service. The Stage 7
-review identified and completed that remaining owner boundary; it did not
-reopen the active-construction contract.
-
-This position completes the Stage 5 construction and probe boundary. It is not
-itself a release decision: the active-publication and truthful-attempt work in
-Stage 6 remains required. Complete retirement of the compatibility facade is
-not a prerequisite for issue 1140.
-
-## Stage 6: harden the active lifecycle and exact attempt outcome
-
-Replace the active dependency on `LiveSyncAbstractReplicator` with the small
-`ReplicatorInstance` contract. Retain a publication only while its provider and
-private configuration identity are unchanged. Every changed identity fences
-new admission, requests supported transfer cancellation, drains admitted work,
-closes the old instance, and only then constructs and publishes a replacement.
-
-Reserve the exact publication around typed finite dispatch and the currently
-required workflow-local directional attempts. Release before recovery or a
-dialogue. CouchDB and Journal record an immutable compatibility decision inside
-the attempt which owns the connection or borrowed client, and a later mutation
-must re-admit that failed context. Retry and Continuous paths reassess on each
-new CouchDB connection without adding another logical connection.
-
-Preserve Journal storage read states through `getSyncParameters()`. Only an
-explicit `not-found` result permits `SyncParamsHandler` to create and upload new
-synchronisation parameters. An unavailable read becomes a fetch failure and
-must not regenerate the shared Security Seed. This fixes issue 1147 within the
-owned-observation boundary rather than adding another Replicator capability.
-
-### Contracted Stage 6 implementation position
-
-The retained implementation is deliberately smaller than the earlier complete
-consumer-migration proposal:
-
-- `ReplicatorInstance` contains only initialisation, `openReplication`,
-  transfer termination, and close;
-- provider definitions retain user-initiated and unattended OneShot runners,
-  an explicit Continuous support decision, readiness, transfer stop, the four
-  owned remote resources, and one optional cohesive central-remote administration
-  runner;
-- every changed configuration identity replaces the active instance; there is
-  no same-instance rebind policy;
-- typed finite dispatch reserves the exact readiness-tested publication and
-  releases it before failure recovery;
-- CouchDB and Journal carry only a rejected attempt-local compatibility
-  decision into the failure outcome, so a transport failure cannot reuse old
-  mutable fields;
-- mismatch updates, unlock, and cleaned-remote reconciliation re-admit the
-  failed publication before remote mutation;
-- P2P uses a narrow non-owning active adapter, takes the same typed finite path,
-  supports its real download workflow, and exposes no central facility;
-- ordinary central preparation and Streaming Fetch use owned Security Seed
-  resources which dispose their unpublished compatibility instances;
-- CLI synchronisation diagnoses lock and clean rejection from the exact outcome.
-  Established successful output and exit behaviour are preserved. Typed
-  remote-administration verification failures return non-zero by default;
-  `--compat-remote-admin-exit-zero` restores the former zero result only for
-  returned verification failures, while thrown mutation failures remain
-  non-zero; and
-- Journal unavailable sync-parameter reads cannot enter the create-and-upload
-  branch required only by explicit absence.
-
-The active path no longer depends on the giant facade. Existing maintenance,
-remote-size, on-demand Chunk, migration-inspection, and compatibility consumers
-may still use focused structural checks or the legacy facade. Their complete
-migration, local-node-identity redesign, generic milestone extraction, and
-in-process local-database reset redesign are deferred unless a separate bounded
-change proves that they are required.
-
-Each production correction has a focused regression. The verification section
-distinguishes local source and packed-consumer evidence from registry,
-real-runtime, and release validation.
-
-### Active-publication quiescing boundary
-
-Commonlib implements the publication-scoped callback reservation defined in
-Part 1 for finite provider dispatch, central-remote administration, exact
-recovery mutation, and the workflow-local directional attempts which use the
-active instance. Invocation queues its admission decision in the same order as
-replacement and disposal. The publication object is its private generation
-identity. Once admitted, release is idempotent, private, and independent of
-that queue so quiescing cannot prevent the operation which allows its own drain
-to settle.
-
-Every switch follows the same order: fence admission, request supported
-transfer cancellation, drain admitted callbacks, close, then publish another
-context. An unchanged provider and configuration identity keeps the existing
-publication.
-
-The first implementation regressions cover:
-
-- replacement waiting for an admitted exact-context task while ignoring an
-  unrelated bounded activity;
-- context acquisition waiting for a queued replacement rather than returning a
-  stale or intermediate publication;
-- rejecting central-remote administration releasing its reservation before
-  replacement continues;
-- finite failure recovery starting only after publication release;
-- directional workflow retry releasing and then re-admitting the same context;
-  and
-- terminal unload draining admitted work before Replicator and local-database
-  close, while reversible suspension retains the publication.
-
-Keep readiness, failure presentation, dialogue, independently owned trial
-resources, P2P room-session demand, and Continuous replication outside this
-reservation. The callback TSDoc forbids awaiting a lifecycle transition which
-would wait for the same admission to settle.
-
-## Stage 7: perform a bounded structural review
-
-Confirm that the contracted core is minimum and robust before a commit or
-release decision. The active path must stay independent of
-`LiveSyncAbstractReplicator`, but complete migration of every compatibility
-consumer is separate work. Remove a dummy or abstract requirement only when
-its current callers have a truthful alternative; do not turn facade retirement
-into a condition for issue 1140.
-
-The retained compatibility surface includes the broad
-`LiveSyncBaseCore.replicator` view and concrete central adapters required by
-maintenance and migration code. It is explicitly a partial compatibility view,
-not the active provider contract. P2P's active adapter does not inherit it.
-
-CouchDB and Object Storage Journal both have a real central milestone document,
-but that fact alone does not justify a generic store. Extract a focused contract
-only when a second current caller demonstrates the same ownership and mutation
-semantics. P2P has no central milestone document and must not receive a stub or
-synthetic implementation.
-
-The final structural review retains the following minimum boundaries:
-
-- central provider definitions remain outside `LiveSyncBaseCore`; its thin
-  registration method remains as the construction-order composition boundary;
-- P2P registration remains with the feature which owns the stable P2P service;
-- `ReplicatorService` and `ReplicationService` remain cohesive services. Their
-  complex state and policy already reside in `ActiveReplicatorState`,
-  `TypedReplicationCoordinator`, the readiness evaluator,
-  `RemoteResourceResolver`, and `CentralRemoteAdministrationCoordinator`, so
-  another split would not improve the current test seams;
-- every provider explicitly declares Continuous support or inapplicability;
-- `IReplicatorService` exposes only acquired or admitted active-context access.
-  A protected synchronous inspector remains for focused lifecycle tests;
-- central-compatibility statuses, recorders, and projection helpers remain
-  package-internal. Only stable rejection reason codes and public recovery
-  value types remain package-index exports; and
-- redundant recovery-kind data, unused active-state identity matching, and the
-  externally visible legacy administration lookup helper are removed.
-
-LiveSync implements its optional central-remote administration facility through one
-shared protocol executor and provider-specific milestone readers. Provider
-composition selects the reader; a reader validates only the structural
-operations required for its CouchDB connection or Journal client before any
-remote mutation. It does not impose concrete-class identity on the generic
-runner contract.
-
-The unpublished public contract, provider field, coordinator, and service
-operation use the `CentralRemoteAdministration*` name because their complete
-protocol is central-milestone-specific. The central OneShot adapters use a
-separate local structural operation instead of concrete-class identity. Stable
-capability-kind comparisons use `CAPABILITY_SUPPORT_KINDS`, and unavailable
-capabilities settle once without a redundant post-narrowing check.
-
-Provider-specific configuration identities remain explicit projections of the
-settings which bind each adapter. They are not replaced with a generic identity
-builder: the current URL normalisation and setting lists are clearer at the
-provider boundary, and changing the shared header parser is separate work.
-
-The review records, but does not prejudge, whether maintained Rebuild and Fetch
-workflows still require an in-process local-database reset. Prefer a Flag File and restart
-boundary if it can preserve user intent, CLI behaviour, failure recovery, and
-the maintained test workflows without losing a supported continuation path.
-Until that evidence exists, retain the current reset contract and its explicit
-Replicator-retirement ordering rather than assuming that every workflow has
-already moved to a restart.
-
-It also records consumers which retain `LiveSyncLocalDB`, its physical PouchDB
-handle, or its managers. If broad retention still leaks ownership after the
-consumer migrations, keep the physical handle and teardown authority in
-`LiveSyncLocalDB`, and expose only the smallest read-only view or
-generation-bound operation contract required by each consumer. Do not cache a
-detached handle snapshot across reset. Preserve the current single active
-database contract, and add another abstraction only where the inventory shows
-a concrete lifetime or testability benefit. These recorded questions do not
-widen Stage 6 or make an anticipatory database abstraction part of this change.
-
-### Contracted Stage 7 review position
-
-The structural review retains the contracted service boundaries. The active
-path remains independent of `LiveSyncAbstractReplicator`; the partial
-compatibility facade, focused maintenance consumers, and in-process database
-reset remain bounded deferred work. `ReplicatorService` and
-`ReplicationService` continue to delegate their complex state and sequencing
-to the focused collaborators listed above, so another physical service split
-would add indirection without removing a current responsibility or improving a
-current test seam.
-
-The review did identify five bounded behavioural corrections inside existing
-owners:
-
-- Security Seed resources force a fresh provider read for their settings
-  snapshot instead of accepting process-cached synchronisation parameters as
-  current evidence;
-- local-database close, reset, failed-initialisation rollback, and
-  physical-database close clean-up share and await the existing
-  active-Replicator retirement for one physical database lifetime;
-- disposing an unused Journal resource does not report that replication
-  closed, while a Replicator lifecycle message is emitted only when a real
-  active publication is retired and no longer mislabels unload as database
-  reset;
-- unattended P2P no-target, authentication, tweak-mismatch, and
-  overlapping-transfer settlements retain informational diagnostics without
-  creating Notice-level presentation; and
-- P2P Setup receives the stable service's `P2PConnectionProbeAdmission` view.
-  Compatible active relay bindings are observed, an active binding which does
-  not cover the requested relay set is blocked with a stable decision code,
-  and only an idle owner runs and awaits the caller-owned raw trial.
-
-The last correction uses `P2PRoomSessionOwner`'s existing lifecycle queue and
-adds no room owner, global relay lease, reference count, or raw transport
-disposal policy. Every maintained production opening of the P2P Setup dialogue
-passes through one host-owned `SetupManager` seam, which injects the admission
-view explicitly. The decision code remains separate from the LiveSync-owned
-English presentation message.
-
-These corrections close ownership and presentation gaps found by the review;
-they do not add another generic capability, remote resource, probe framework,
-or provider role. The target matrices in Part 1 therefore remain unchanged.
-
-## Verification
-
-### Commonlib unit and type-contract tests
-
-Cover:
-
-- exhaustive host-composed definitions for CouchDB, Object Storage, and P2P;
-- the four-method active `ReplicatorInstance` contract and provider-owned
-  runtime roles;
-- user-initiated, unattended, blocked, partial, cancelled, and failed OneShot
-  outcomes;
-- truthful Object Storage stop or transfer failure and headless P2P outcomes;
-- active, quiescing, disposed, and replacement-published states, including
-  rejection of new work during retirement, acquisition waiting, and late
-  candidate settlement;
-- unchanged-identity retention, changed-identity replacement, idempotent
-  reservation release, and close ordering;
-- probes which cannot replace the active Replicator or P2P service, including
-  P2P Setup observation and blocking without trial construction, and idle
-  admission which awaits complete disposal of the caller-owned trial;
-- the deliberately narrow active-transfer stop request, including work it
-  does not claim to cancel;
-- CouchDB compatibility and transfer using the same owned OneShot connection;
-- Journal compatibility and transfer using one settings-bound borrowed client;
-- attempt-local accepted, rejected, and not-assessed decisions, including retry
-  and Continuous reassessment on newly opened CouchDB connections;
-- Journal synchronisation-parameter reads distinguishing explicit absence from
-  unavailability and never writing after the latter;
-- cohesive central administration and its truthful mutation settlement;
-- the narrow non-owning P2P active adapter, including download without a
-  synthetic upload or central facility;
-- local-database retirement sharing the active owner boundary across reset and
-  close paths; and
-- caller-authority preservation for unattended P2P presentation and truthful
-  Journal and active-lifecycle closure diagnostics.
-
-### Self-hosted LiveSync unit tests
-
-Cover:
-
-- Object Storage `syncOnStart` through resume, including a migrated profile
-  which retains `liveSync: true`;
-- existing CouchDB Continuous and OneShot paths;
-- same-generation resume coalescing, a fresh attempt after a later lifecycle
-  generation, and rejection of an obsolete generation's OneShot fallback;
-- a queued Periodic callback rechecking lifecycle and recurring-work ownership
-  after its interval has been disabled;
-- the daemon's satisfied initial OneShot marker being consumed even when a
-  Continuous start throws, so a later resume may retry normally;
-- periodic, database-save, editor-save, file-open, merge, and daemon triggers
-  remaining free of dialogues;
-- manual P2P and configured peer-targeted flows remaining available;
-- P2P AutoStart cancellation across suspension, bounded advertisement waiting,
-  accepted peers without unattended dialogues, remote-broadcast prerequisites,
-  session-demand reference counts, and overlapping peer policies;
-- the focused P2P service views sharing one room owner without exposing a raw
-  host, room, or concrete Replicator, including connection-probe admission;
-- session replacement fencing callbacks, clients, temporary decisions,
-  advertisements, and database-bound feeds while retaining persisted decisions;
-- counterpart RPC authorisation and broadcast progress preserving no-dialogue
-  authority;
-- Setup and settings validation through owned resources or owner-arbitrated
-  P2P admission;
-- exact failed-context mismatch, unlock, and cleaned-remote recovery, including
-  rejection after active replacement;
-- CLI lock diagnostics from the exact finite outcome rather than mutable fields
-  on a later active Replicator;
-- CLI process exit codes for successful administration, returned verification
-  failure with and without `--compat-remote-admin-exit-zero`, and thrown
-  mutation failure;
-- first-device and additional-device initialisation for each current provider;
-- P2P as the main remote and as an adjunct transport; and
-- CLI, WebApp, and WebPeer composition against the same contracts, including
-  daemon scheduling after settings restoration and P2P AutoStart reconciliation
-  after a settings change.
-
-### Focused integration and real-Obsidian verification
-
-Cover an Object Storage change arriving immediately after start-up without
-waiting for the periodic interval, ordinary CouchDB start-up, and P2P start-up
-without an unexpected selection dialogue or transport replacement. P2P
-validation also covers an accepted configured peer advertising after room open,
-a watched peer whose remote side broadcasts, and suspension before a delayed
-AutoStart callback. A focused P2P Setup check must also cover an active room
-with the same relay set, an attempted additional relay which is blocked without
-closing that room, and an idle trial which releases its short-lived resources.
-Object Storage validation must also confirm that a temporarily unavailable
-synchronisation-parameter read does not upload a new Security Seed.
-
-No temporary stage is a release candidate. Release readiness requires the
-target capability matrix, the contracted core and in-scope consumer migration,
-focused downstream checks with the exact packed Commonlib artefact, and the
-real-runtime checks appropriate to the changed boundary. Complete legacy-facade
-retirement remains a separately reviewed compatibility change.
-
-## References
-
-- [Part 1: core contract](2026_08_replicator_capabilities_01_core_contract.md)
-- [Part 2: P2P service and session lifecycle](2026_08_replicator_capabilities_02_p2p_service_lifecycle.md)
-- [P2P Room and Transport Lifecycle](2026_07_p2p_transport_lifecycle.md)
-- [P2P Transport Compatibility Controls](2026_08_p2p_transport_compatibility.md)
-- [Bounded Remote Activity](2026_07_bounded_remote_activity.md)
-- [Self-hosted LiveSync issue 1140](https://github.com/vrtmrz/obsidian-livesync/issues/1140)
-- [Self-hosted LiveSync issue 1147](https://github.com/vrtmrz/obsidian-livesync/issues/1147)

docs/settings.md

@@ -443,14 +443,6 @@ Setting key: P2P_relays
 
 The Nostr-compatible WebSocket relay URL or URLs used for peer discovery and WebRTC connection negotiation. Multiple URLs can be separated by commas. A signalling relay does not store or transfer Vault contents. See [How peer-to-peer synchronisation works](p2p.md).
 
-The P2P Setup connection test does not interrupt an active P2P room. When the
-active relay set already covers the requested URLs, the test observes that
-active signalling transport. If the test would add a relay while P2P is
-active, it asks you to use the active relay settings or disconnect P2P first.
-When P2P is idle, the test opens and disposes a short-lived signalling trial.
-This check does not prove peer discovery, room credentials against another
-device, or a TURN or WebRTC data path.
-
 #### Group ID
 
 Setting key: P2P_roomID

docs/tips/hidden-file-sync.md

@@ -20,7 +20,7 @@ Enabling Hidden File Sync requires an initialisation direction:
 ## Review the file selection
 
 1. Open Self-hosted LiveSync settings.
-2. Open `General Settings` → `Extra menus`, and enable `Advanced features`.
+2. Open `Setup`, find `Enable extra and advanced features`, and enable `Advanced features`.
 
    ![Advanced features enabled](../../images/hidden-file-sync/guide-hidden-file-advanced-features.png)
 

src/LiveSyncBaseCore.ts

@@ -1,11 +1,7 @@
 import { LOG_LEVEL_INFO } from "octagonal-wheels/common/logger";
 import type PouchDB from "pouchdb-core";
 import type { SimpleStore } from "octagonal-wheels/databases/SimpleStoreBase";
-import {
-    type HasSettings,
-    type ObsidianLiveSyncSettings,
-    type EntryDoc,
-} from "@vrtmrz/livesync-commonlib/compat/common/types";
+import type { HasSettings, ObsidianLiveSyncSettings, EntryDoc } from "@vrtmrz/livesync-commonlib/compat/common/types";
 import { __$checkInstanceBinding } from "@vrtmrz/livesync-commonlib/compat/dev/checks";
 import type { Confirm } from "@vrtmrz/livesync-commonlib/compat/interfaces/Confirm";
 import type { DatabaseFileAccess } from "@vrtmrz/livesync-commonlib/compat/interfaces/DatabaseFileAccess";
@@ -15,13 +11,17 @@ import type { StorageAccess } from "@vrtmrz/livesync-commonlib/compat/interfaces
 import type { LiveSyncLocalDBEnv } from "@vrtmrz/livesync-commonlib/compat/pouchdb/LiveSyncLocalDB";
 import type { LiveSyncCouchDBReplicatorEnv } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
 import type { CheckPointInfo } from "@vrtmrz/livesync-commonlib/compat/replication/journal/JournalSyncTypes";
-import type { LiveSyncAbstractReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/LiveSyncAbstractReplicator";
-import type { ReplicatorInstance } from "@vrtmrz/livesync-commonlib/replication";
+import type { LiveSyncJournalReplicatorEnv } from "@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicatorEnv";
+import type { LiveSyncReplicatorEnv } from "@vrtmrz/livesync-commonlib/compat/replication/LiveSyncAbstractReplicator";
 import { useTargetFilters } from "@vrtmrz/livesync-commonlib/compat/serviceFeatures/targetFilter";
 import { useRemoteConfigurationMigration } from "@vrtmrz/livesync-commonlib/compat/serviceFeatures/remoteConfig";
 import type { ServiceContext } from "@vrtmrz/livesync-commonlib/context";
 import type { InjectableServiceHub } from "@vrtmrz/livesync-commonlib/compat/services/implements/injectable/InjectableServiceHub";
 import { AbstractModule } from "./modules/AbstractModule";
+import { ModulePeriodicProcess } from "./modules/core/ModulePeriodicProcess";
+import { ModuleReplicator } from "./modules/core/ModuleReplicator";
+import { ModuleReplicatorCouchDB } from "./modules/core/ModuleReplicatorCouchDB";
+import { ModuleReplicatorMinIO } from "./modules/core/ModuleReplicatorMinIO";
 import { ModuleConflictChecker } from "./modules/coreFeatures/ModuleConflictChecker";
 import { ModuleConflictResolver } from "./modules/coreFeatures/ModuleConflictResolver";
 import { ModuleResolvingMismatchedTweaks } from "./modules/coreFeatures/ModuleResolveMismatchedTweaks";
@@ -30,16 +30,6 @@ import type { ServiceModules } from "@vrtmrz/livesync-commonlib/compat/interface
 import { ModuleBasicMenu } from "./modules/essential/ModuleBasicMenu";
 import { usePrepareDatabaseForUse } from "@vrtmrz/livesync-commonlib/compat/serviceFeatures/prepareDatabaseForUse";
 import type { Constructor } from "@vrtmrz/livesync-commonlib/compat/common/utils.type";
-import { useReplicationScheduling, type ReplicationSchedulingControl } from "./serviceFeatures/replicationScheduling";
-import { createCentralReplicatorProviderDefinitions } from "./common/replicatorProviders";
-import { useReplicationFeature } from "./serviceFeatures/replication";
-
-/** Focused views returned by serviceFeatures which the host may consume during composition. */
-export interface LiveSyncCoreFeatureViews {
-    readonly replicationScheduling: ReplicationSchedulingControl;
-}
-
-type CompatibilityReplicatorView = ReplicatorInstance & Partial<LiveSyncAbstractReplicator>;
 
 export class LiveSyncBaseCore<
     T extends ServiceContext = ServiceContext,
@@ -47,6 +37,8 @@ export class LiveSyncBaseCore<
 >
     implements
         LiveSyncLocalDBEnv,
+        LiveSyncReplicatorEnv,
+        LiveSyncJournalReplicatorEnv,
         LiveSyncCouchDBReplicatorEnv,
         HasSettings<ObsidianLiveSyncSettings>
 {
@@ -82,22 +74,18 @@ export class LiveSyncBaseCore<
         ) => ServiceModules,
         extraModuleInitialiser: (core: LiveSyncBaseCore<T, TCommands>) => AbstractModule[],
         addOnsInitialiser: (core: LiveSyncBaseCore<T, TCommands>) => TCommands[],
-        featuresInitialiser: (core: LiveSyncBaseCore<T, TCommands>, coreFeatureViews: LiveSyncCoreFeatureViews) => void
+        featuresInitialiser: (core: LiveSyncBaseCore<T, TCommands>) => void
     ) {
         this._services = serviceHub;
-        this.registerReplicatorProviders();
         this._serviceModules = serviceModuleInitialiser(this, serviceHub);
         const extraModules = extraModuleInitialiser(this);
         this.registerModules(extraModules);
-        const coreFeatureViews = this.initialiseServiceFeatures();
-        featuresInitialiser(this, coreFeatureViews);
+        this.initialiseServiceFeatures();
+        featuresInitialiser(this);
         const addOns = addOnsInitialiser(this);
         for (const addOn of addOns) {
             this._registerAddOn(addOn);
         }
-        // Preserve the former ModuleReplicator lifecycle-handler order:
-        // host features and add-ons first, then replication, then legacy modules.
-        useReplicationFeature(this);
         this.bindModuleFunctions();
     }
     /**
@@ -148,17 +136,14 @@ export class LiveSyncBaseCore<
         this.modules.push(module);
     }
 
-    /** Compose the current central providers before any lifecycle event can acquire one. */
-    private registerReplicatorProviders() {
-        this.services.replicator.registerReplicatorProviderDefinitions(
-            createCentralReplicatorProviderDefinitions(this)
-        );
-    }
-
     public registerModules(extraModules: AbstractModule[] = []) {
         this._registerModule(new ModuleLiveSyncMain(this));
         this._registerModule(new ModuleConflictChecker(this));
+        this._registerModule(new ModuleReplicatorMinIO(this));
+        this._registerModule(new ModuleReplicatorCouchDB(this));
+        this._registerModule(new ModuleReplicator(this));
         this._registerModule(new ModuleConflictResolver(this));
+        this._registerModule(new ModulePeriodicProcess(this));
         this._registerModule(new ModuleResolvingMismatchedTweaks(this));
         this._registerModule(new ModuleBasicMenu(this));
 
@@ -238,11 +223,10 @@ export class LiveSyncBaseCore<
     }
 
     /**
-     * @obsolete Use the provider context or a focused service operation instead.
-     * Provider-specific members on this compatibility view are optional.
+     * @obsolete Use services.replication.getActiveReplicator instead. Get the active replicator instance. Note that there can be multiple replicators, but only one can be active at a time.
      */
-    get replicator(): CompatibilityReplicatorView {
-        return this.services.replicator.getActiveReplicator() as CompatibilityReplicatorView;
+    get replicator() {
+        return this.services.replicator.getActiveReplicator()!;
     }
 
     /**
@@ -289,15 +273,12 @@ export class LiveSyncBaseCore<
      * Initialise ServiceFeatures.
      * (Please refer `serviceFeatures` for more details)
      */
-    initialiseServiceFeatures(): LiveSyncCoreFeatureViews {
+    initialiseServiceFeatures() {
         useTargetFilters(this);
         // enable target filter feature.
         usePrepareDatabaseForUse(this);
         // Migration to multiple remote configurations
         useRemoteConfigurationMigration(this);
-        return Object.freeze({
-            replicationScheduling: useReplicationScheduling(this),
-        });
     }
 }
 

src/apps/cli/README.md

@@ -71,9 +71,6 @@ livesync-cli [database-path] [command] [args...]
     - `init-settings` writes its target file. `setup`, `remote-add`, `remote-rm`, `remote-set`, and `remote-activate` write their settings changes without this option.
     - All remaining commands leave the settings file unchanged by default.
     - Temporary values used to suspend synchronisation or select a remote for one command are never written.
-- `--compat-remote-admin-exit-zero`: Preserve the former zero exit code when `mark-resolved`, `lock-remote`, or `unlock-remote` returns a provider verification failure.
-    - Without this option, those commands return a non-zero exit code when verification fails.
-    - Invalid arguments, unknown remote IDs, and errors thrown while activating or mutating the remote remain errors with or without this option.
 
 ### Commands
 
@@ -99,8 +96,6 @@ livesync-cli [database-path] [command] [args...]
 - `remote-status [remote-id]`: Show remote database status.
 - `init-settings [file]`: Create a default settings file.
 
-Remote-administration commands verify the resulting milestone state through the selected provider. The existing `[Verification]` lines remain suitable for scripts which inspect command output, while the default exit code now reflects whether that verification succeeded.
-
 ### Examples
 
 ```bash
@@ -343,8 +338,6 @@ Options:
   --interval <N>, -i <N>  (daemon only) Poll CouchDB every N seconds instead of using the _changes feed
   --vault <path>, -V <path>  (daemon/mirror) Path to vault directory, decoupled from database-path
   --write-settings         Write setting changes after a successful command
-  --compat-remote-admin-exit-zero
-                           Preserve the former zero exit code when remote-administration verification fails
   --help, -h              Show this help message
 
 Commands:
@@ -529,10 +522,12 @@ bash src/apps/cli/deploy/install.sh --system --vault /path/to/vault
 ```
 
 The script:
-1. Builds the CLI (`npm install` + `npm run build`).
-2. Installs the binary to `~/.local/bin/livesync-cli` (user) or `/usr/local/bin/livesync-cli` (system).
-3. Writes the unit file to `~/.config/systemd/user/livesync-cli.service` (user) or `/etc/systemd/system/livesync-cli.service` (system).
-4. Runs `systemctl [--user] daemon-reload && systemctl [--user] enable --now livesync-cli`.
+
+1. Installs the repository dependencies and builds the CLI.
+2. Installs the complete CLI bundle and its production dependencies under `~/.local/lib/livesync-cli` (user) or `/usr/local/lib/livesync-cli` (system), then checks that the installed CLI can start.
+3. Installs the command wrapper as `~/.local/bin/livesync-cli` (user) or `/usr/local/bin/livesync-cli` (system).
+4. Writes the unit file to `~/.config/systemd/user/livesync-cli.service` (user) or `/etc/systemd/system/livesync-cli.service` (system).
+5. Reloads systemd, enables and starts the service, and reports success only after confirming that the service remains active.
 
 **Manual setup** — if you prefer to manage the unit yourself, copy `deploy/livesync-cli.service`, replace `LIVESYNC_BIN` and `LIVESYNC_VAULT_PATH` with the actual binary path and vault path, then install to the appropriate systemd directory.
 

src/apps/cli/commands/centralRemoteAdministration.ts

@@ -1,125 +0,0 @@
-import type { StandardIo } from "@vrtmrz/livesync-commonlib/context";
-import {
-    CENTRAL_REMOTE_ADMINISTRATION_ACTIONS,
-    CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS,
-    CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS,
-    isCentralRemoteAdministrationVerified,
-    type CentralRemoteAdministrationAction,
-    type CentralRemoteAdministrationResult,
-} from "@vrtmrz/livesync-commonlib/replication";
-import { activateRemoteConfiguration } from "@vrtmrz/livesync-commonlib/remote-configurations";
-import { writeStderrLine } from "@/apps/cli/cliOutput";
-import type { CLICommand, CLICommandContext, CLIOptions } from "./types";
-
-const CENTRAL_REMOTE_ADMINISTRATION_ACTION_BY_COMMAND = Object.freeze({
-    "mark-resolved": CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.MARK_RESOLVED,
-    "lock-remote": CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.LOCK,
-    "unlock-remote": CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.UNLOCK,
-} as const satisfies Partial<Record<CLICommand, CentralRemoteAdministrationAction>>);
-
-export type CentralRemoteAdministrationCommand = keyof typeof CENTRAL_REMOTE_ADMINISTRATION_ACTION_BY_COMMAND;
-
-/** Return whether a CLI command belongs to the central-remote administration category. */
-export function isCentralRemoteAdministrationCommand(
-    command: CLICommand
-): command is CentralRemoteAdministrationCommand {
-    return Object.prototype.hasOwnProperty.call(CENTRAL_REMOTE_ADMINISTRATION_ACTION_BY_COMMAND, command);
-}
-
-function detailMessage(detail: unknown): string {
-    return detail instanceof Error ? detail.message : String(detail);
-}
-
-function reportMilestoneObservation(
-    standardIo: StandardIo,
-    observation: Extract<
-        CentralRemoteAdministrationResult["observation"],
-        { kind: typeof CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS.MILESTONE }
-    >
-): void {
-    standardIo.writeStderr(`[Verification] Remote Database: ${observation.locked ? "LOCKED" : "UNLOCKED"}\n`);
-    standardIo.writeStderr(
-        `[Verification] Current Device Node ID (${observation.nodeId}): ${observation.accepted ? "ACCEPTED" : "NOT ACCEPTED"}\n`
-    );
-}
-
-/** Map typed provider observations to the CLI's established verification output. */
-function reportCentralRemoteAdministrationResult(
-    standardIo: StandardIo,
-    result: CentralRemoteAdministrationResult
-): void {
-    if (result.observation?.kind === CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS.MILESTONE) {
-        reportMilestoneObservation(standardIo, result.observation);
-        return;
-    }
-    if (isCentralRemoteAdministrationVerified(result)) {
-        return;
-    }
-
-    switch (result.reason) {
-        case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.NO_ACTIVE_REPLICATOR:
-            standardIo.writeStderr("[Verification] No active replicator found\n");
-            return;
-        case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.CONNECTION_FAILED:
-            standardIo.writeStderr(
-                `[Verification] Failed to connect to the configured remote: ${detailMessage(result.detail)}\n`
-            );
-            return;
-        case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.MILESTONE_NOT_FOUND:
-            standardIo.writeStderr("[Verification] Milestone document not found on remote.\n");
-            return;
-        case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.MILESTONE_READ_FAILED:
-            standardIo.writeStderr(
-                `[Verification] Failed to fetch milestone document: ${detailMessage(result.detail)}\n`
-            );
-            return;
-        case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.LOCAL_IDENTITY_UNAVAILABLE:
-            standardIo.writeStderr("[Verification] Failed to initialise the current device identity.\n");
-            return;
-        case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.CAPABILITY_NOT_IMPLEMENTED:
-        case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.CAPABILITY_NOT_APPLICABLE:
-            standardIo.writeStderr("[Verification] Remote administration is unavailable for this provider.\n");
-            return;
-        case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.POSTCONDITION_MISMATCH:
-            standardIo.writeStderr("[Verification] The requested remote state was not observed.\n");
-            return;
-    }
-}
-
-/**
- * Apply one provider-owned mutation and map its typed verification to CLI exit policy.
- * Mutation exceptions deliberately escape this boundary.
- */
-export async function runCentralRemoteAdministrationCommand(
-    options: CLIOptions,
-    context: CLICommandContext,
-    command: CentralRemoteAdministrationCommand
-): Promise<boolean> {
-    const id = options.commandArgs[0]?.trim();
-    if (id) {
-        let switched = false;
-        await context.core.services.setting.updateSettings((currentSettings) => {
-            const activated = activateRemoteConfiguration(currentSettings, id);
-            if (activated) {
-                switched = true;
-                return activated;
-            }
-            return currentSettings;
-        }, false);
-
-        if (!switched) {
-            context.core.services.context.standardIo.writeStderr(
-                `[Info] Failed to temporarily activate remote configuration: ${id}\n`
-            );
-            return false;
-        }
-
-        await context.core.services.control.applySettings();
-    }
-
-    writeStderrLine(context.core.services.context.standardIo, `[Command] ${command}${id ? ` ${id}` : ""}`);
-    const action = CENTRAL_REMOTE_ADMINISTRATION_ACTION_BY_COMMAND[command];
-    const result = await context.core.services.replicator.runCentralRemoteAdministration({ action });
-    reportCentralRemoteAdministrationResult(context.core.services.context.standardIo, result);
-    return isCentralRemoteAdministrationVerified(result) || options.compatRemoteAdminExitZero === true;
-}

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

@@ -1,6 +1,5 @@
 import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
 import { createServiceContext } from "@vrtmrz/livesync-commonlib/context";
-import { NO_INTERACTION } from "@vrtmrz/livesync-commonlib/replication";
 import { runCommand } from "./runCommand";
 import type { CLIOptions } from "./types";
 
@@ -39,7 +38,7 @@ function createCoreMock() {
                 currentSettings: vi.fn(() => ({ liveSync: true, syncOnStart: false })),
             },
             replication: {
-                replicateUnattended: vi.fn(async () => ({ status: "completed" as const })),
+                replicate: vi.fn(async () => true),
             },
             appLifecycle: {
                 onUnload: {
@@ -88,17 +87,6 @@ const baseContext = {
     },
 } as any;
 
-function createDaemonContext(core: ReturnType<typeof createCoreMock>) {
-    return {
-        ...baseContext,
-        core,
-        replicationScheduling: {
-            setExternalPollingMode: vi.fn(),
-            markInitialOneShotSatisfied: vi.fn(),
-        },
-    } as any;
-}
-
 describe("daemon command", () => {
     beforeEach(() => {
         vi.restoreAllMocks();
@@ -113,7 +101,7 @@ describe("daemon command", () => {
         const core = createCoreMock();
         vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
 
-        await runCommand(makeDaemonOptions(), createDaemonContext(core));
+        await runCommand(makeDaemonOptions(), { ...baseContext, core });
 
         expect(offlineScanner.performFullScan).toHaveBeenCalledTimes(1);
     });
@@ -122,7 +110,7 @@ describe("daemon command", () => {
         const core = createCoreMock();
         vi.mocked(offlineScanner.performFullScan).mockResolvedValue(false);
 
-        const result = await runCommand(makeDaemonOptions(), createDaemonContext(core));
+        const result = await runCommand(makeDaemonOptions(), { ...baseContext, core });
 
         expect(result).toBe(false);
     });
@@ -132,11 +120,9 @@ describe("daemon command", () => {
         vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
         const setTimeoutSpy = vi.spyOn(globalThis, "setTimeout");
 
-        const context = createDaemonContext(core);
-        await runCommand(makeDaemonOptions(30), context);
+        await runCommand(makeDaemonOptions(30), { ...baseContext, core });
 
         expect(setTimeoutSpy).toHaveBeenCalledTimes(1);
-        expect(context.replicationScheduling.setExternalPollingMode).toHaveBeenCalledWith(true);
         // Interval should be in milliseconds (30s → 30000ms)
         expect(setTimeoutSpy).toHaveBeenCalledWith(expect.any(Function), 30000);
     });
@@ -145,7 +131,7 @@ describe("daemon command", () => {
         const core = createCoreMock();
         vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
 
-        await runCommand(makeDaemonOptions(10), createDaemonContext(core));
+        await runCommand(makeDaemonOptions(10), { ...baseContext, core });
 
         expect(core.services.setting.applyPartial).toHaveBeenCalledWith(
             expect.objectContaining({ suspendFileWatching: false }),
@@ -158,7 +144,7 @@ describe("daemon command", () => {
         const core = createCoreMock();
         vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
 
-        await runCommand(makeDaemonOptions(), createDaemonContext(core));
+        await runCommand(makeDaemonOptions(), { ...baseContext, core });
 
         expect(core.services.setting.applyPartial).toHaveBeenCalledWith(
             expect.objectContaining({
@@ -178,7 +164,7 @@ describe("daemon command", () => {
         }));
         vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
 
-        const result = await runCommand(makeDaemonOptions(), createDaemonContext(core));
+        const result = await runCommand(makeDaemonOptions(), { ...baseContext, core });
 
         expect(result).toBe(true);
         const warningCalls = core.services.context.standardIo.writeStderr.mock.calls.filter(
@@ -196,7 +182,7 @@ describe("daemon command", () => {
         }));
         vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
 
-        await runCommand(makeDaemonOptions(), createDaemonContext(core));
+        await runCommand(makeDaemonOptions(), { ...baseContext, core });
 
         const warningCalls = core.services.context.standardIo.writeStderr.mock.calls.filter(
             ([chunk]: [string | Uint8Array]) =>
@@ -208,50 +194,37 @@ describe("daemon command", () => {
     it("calls replicate before performFullScan", async () => {
         const core = createCoreMock();
         const callOrder: string[] = [];
-        core.services.replication.replicateUnattended = vi.fn(async () => {
+        core.services.replication.replicate = vi.fn(async () => {
             callOrder.push("replicate");
-            return { status: "completed" as const };
+            return true;
         });
         vi.mocked(offlineScanner.performFullScan).mockImplementation(async () => {
             callOrder.push("performFullScan");
             return true;
         });
 
-        const context = createDaemonContext(core);
-        await runCommand(makeDaemonOptions(), context);
+        await runCommand(makeDaemonOptions(), { ...baseContext, core });
 
         expect(callOrder).toEqual(["replicate", "performFullScan"]);
-        expect(core.services.replication.replicateUnattended).toHaveBeenCalledWith({
-            trigger: "daemon",
-            interaction: NO_INTERACTION,
-        });
-        expect(context.replicationScheduling.markInitialOneShotSatisfied).toHaveBeenCalledOnce();
     });
 
     it("returns false when initial replication fails", async () => {
         const core = createCoreMock();
-        core.services.replication.replicateUnattended = vi.fn(async () => ({
-            status: "failed" as const,
-            error: new Error("initial replication failed"),
-        }));
+        core.services.replication.replicate = vi.fn(async () => false);
         vi.mocked(offlineScanner.performFullScan).mockClear();
 
-        const result = await runCommand(makeDaemonOptions(), createDaemonContext(core));
+        const result = await runCommand(makeDaemonOptions(), { ...baseContext, core });
 
         expect(result).toBe(false);
         // performFullScan should NOT have been called
         expect(offlineScanner.performFullScan).not.toHaveBeenCalled();
-        expect(core.services.replication.replicateUnattended).toHaveBeenCalledWith({
-            trigger: "daemon",
-            interaction: NO_INTERACTION,
-        });
     });
 
     it("polling mode: registers onUnload handler that clears timeout", async () => {
         const core = createCoreMock();
         vi.mocked(offlineScanner.performFullScan).mockResolvedValue(true);
 
-        await runCommand(makeDaemonOptions(10), createDaemonContext(core));
+        await runCommand(makeDaemonOptions(10), { ...baseContext, core });
 
         // onUnload handler should have been registered
         expect(core.services.appLifecycle.onUnload.addHandler).toHaveBeenCalledTimes(1);
@@ -269,17 +242,17 @@ describe("daemon command", () => {
 
         // startup replicate (call 1) succeeds; poll calls 2–7 fail; call 8 succeeds.
         let callCount = 0;
-        core.services.replication.replicateUnattended = vi.fn(async () => {
+        core.services.replication.replicate = vi.fn(async () => {
             callCount++;
-            if (callCount === 1) return { status: "completed" as const }; // initial startup replicate
+            if (callCount === 1) return true; // initial startup replicate
             if (callCount <= 7) throw new Error("network failure");
-            return { status: "completed" as const }; // recovery
+            return true; // recovery
         });
 
         const baseMs = 30 * 1000;
         const setTimeoutSpy = vi.spyOn(globalThis, "setTimeout");
 
-        await runCommand(makeDaemonOptions(30), createDaemonContext(core));
+        await runCommand(makeDaemonOptions(30), { ...baseContext, core });
 
         // After runCommand returns the first setTimeout has been scheduled.
         // setTimeoutSpy.mock.calls[0] is the initial schedule (baseMs).
@@ -324,14 +297,14 @@ describe("daemon command", () => {
 
         // Make replicate succeed on the initial call (startup), then fail on the poll.
         let callCount = 0;
-        core.services.replication.replicateUnattended = vi.fn(async () => {
+        core.services.replication.replicate = vi.fn(async () => {
             callCount++;
-            if (callCount === 1) return { status: "completed" as const }; // startup replicate
+            if (callCount === 1) return true; // startup replicate
             throw new Error("network failure");
         });
 
         const intervalMs = 30 * 1000;
-        await runCommand(makeDaemonOptions(30), createDaemonContext(core));
+        await runCommand(makeDaemonOptions(30), { ...baseContext, core });
 
         // Advance time to trigger the first poll callback and flush its async work.
         await vi.advanceTimersByTimeAsync(intervalMs);

src/apps/cli/commands/p2p.ts

@@ -1,9 +1,10 @@
 import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore";
 import { P2P_DEFAULT_SETTINGS } from "@vrtmrz/livesync-commonlib/compat/common/types";
 import type { ServiceContext } from "@vrtmrz/livesync-commonlib/context";
+import { LiveSyncTrysteroReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/LiveSyncTrysteroReplicator";
 import { compatGlobal } from "@vrtmrz/livesync-commonlib/compat/common/coreEnvFunctions";
 import { LiveSyncError } from "@vrtmrz/livesync-commonlib/compat/common/LSError";
-import type { P2PPeerConnectionMetrics, P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
+import { getPeerConnectionStats } from "@vrtmrz/livesync-commonlib/compat/rpc/transports/DiagRTCPeerConnections.utils";
 import { fsPromises } from "@vrtmrz/livesync-commonlib/node";
 
 type CLIP2PPeer = {
@@ -11,7 +12,12 @@ type CLIP2PPeer = {
     name: string;
 };
 
-type CLIP2PService = Pick<P2PServiceViews, "transportLifecycle" | "peerDirectory" | "targetedTransfer" | "diagnostics">;
+type CandidateSummary = {
+    id: string;
+    candidateType: string;
+    protocol: string;
+    relayProtocol: string;
+};
 
 function delay(ms: number): Promise<void> {
     return new Promise((resolve) => compatGlobal.setTimeout(resolve, ms));
@@ -37,35 +43,35 @@ function validateP2PSettings(core: LiveSyncBaseCore<ServiceContext, never>) {
     settings.P2P_IsHeadless = true;
 }
 
-function requireP2PService(
-    core: LiveSyncBaseCore<ServiceContext, never>,
-    service: CLIP2PService | undefined
-): CLIP2PService {
+async function createReplicator(core: LiveSyncBaseCore<ServiceContext, never>): Promise<LiveSyncTrysteroReplicator> {
     validateP2PSettings(core);
-    if (!service) {
-        throw new Error("P2P service is not available. Ensure the P2P feature was composed for this CLI process.");
+    const replicator = await core.services.replicator.getNewReplicator();
+    if (!replicator) {
+        throw new Error("Failed to create replicator instance. Ensure P2P is enabled in settings.");
     }
-    return service;
+    if (!(replicator instanceof LiveSyncTrysteroReplicator)) {
+        throw new Error("Unexpected replicator type. Expected LiveSyncTrysteroReplicator.");
+    }
+    return replicator;
 }
 
-function getSortedPeers(service: Pick<P2PServiceViews, "peerDirectory">): CLIP2PPeer[] {
-    return [...service.peerDirectory.getPeers()]
+function getSortedPeers(replicator: LiveSyncTrysteroReplicator): CLIP2PPeer[] {
+    return [...replicator.knownAdvertisements]
         .map((peer) => ({ peerId: peer.peerId, name: peer.name }))
         .sort((a, b) => a.peerId.localeCompare(b.peerId));
 }
 
 export async function collectPeers(
     core: LiveSyncBaseCore<ServiceContext, never>,
-    p2pService: CLIP2PService | undefined,
     timeoutSec: number
 ): Promise<CLIP2PPeer[]> {
-    const service = requireP2PService(core, p2pService);
-    await service.transportLifecycle.connect();
+    const replicator = await createReplicator(core);
+    await replicator.open();
     try {
         await delay(timeoutSec * 1000);
-        return getSortedPeers(service);
+        return getSortedPeers(replicator);
     } finally {
-        await service.transportLifecycle.disconnect();
+        await replicator.close();
     }
 }
 
@@ -84,8 +90,32 @@ function resolvePeer(peers: CLIP2PPeer[], peerToken: string): CLIP2PPeer | undef
     return undefined;
 }
 
+function getReportValue<T extends string | number>(
+    report: Record<string, unknown> | undefined,
+    key: string
+): T | "unknown" {
+    const value = report?.[key];
+    return typeof value === "string" || typeof value === "number" ? (value as T) : "unknown";
+}
+
+function summariseCandidate(reports: unknown[], candidateId: string): CandidateSummary | undefined {
+    if (candidateId === "unknown") {
+        return undefined;
+    }
+    const report = reports.map((r) => r as Record<string, unknown>).find((r) => r.id === candidateId);
+    if (!report) {
+        return undefined;
+    }
+    return {
+        id: candidateId,
+        candidateType: getReportValue<string>(report, "candidateType"),
+        protocol: getReportValue<string>(report, "protocol"),
+        relayProtocol: getReportValue<string>(report, "relayProtocol"),
+    };
+}
+
 async function writePeerConnectionStatsIfRequested(
-    service: Pick<P2PServiceViews, "diagnostics">,
+    replicator: LiveSyncTrysteroReplicator,
     peer: CLIP2PPeer
 ): Promise<void> {
     const outputPath = process.env.LIVESYNC_P2P_STATS_JSONL?.trim();
@@ -93,30 +123,21 @@ async function writePeerConnectionStatsIfRequested(
         return;
     }
 
-    const stats = await service.diagnostics.getPeerConnectionMetrics(peer.peerId);
-    const payload = createPeerConnectionStatsPayload(peer, stats, new Date().toISOString());
-    await fsPromises.appendFile(outputPath, `${JSON.stringify(payload)}\n`, "utf8");
-}
-
-/** Build the stable JSONL record consumed by the P2P benchmark harnesses. */
-export function createPeerConnectionStatsPayload(
-    peer: CLIP2PPeer,
-    stats: P2PPeerConnectionMetrics | undefined,
-    generatedAt: string
-) {
-    const localCandidate = stats?.localCandidate;
-    const remoteCandidate = stats?.remoteCandidate;
+    const peerConnection = replicator.rawHost?.room?.getPeers()[peer.peerId];
+    const stats = peerConnection ? await getPeerConnectionStats(`cli-p2p-${peer.peerId}`, peerConnection) : undefined;
+    const localCandidate = summariseCandidate(stats?.reports ?? [], stats?.localCandidateId ?? "unknown");
+    const remoteCandidate = summariseCandidate(stats?.reports ?? [], stats?.remoteCandidateId ?? "unknown");
     const selectedPath =
         localCandidate && remoteCandidate
             ? `${localCandidate.candidateType}<->${remoteCandidate.candidateType}`
             : "unknown";
 
     const payload = {
-        generatedAt,
+        generatedAt: new Date().toISOString(),
         command: "p2p-sync",
         peerId: peer.peerId,
         peerName: peer.name,
-        candidatePathCollected: stats?.selectedPairPresent ?? false,
+        candidatePathCollected: !!stats?.selectedPair,
         selectedPath,
         selectedPair: stats
             ? {
@@ -134,24 +155,23 @@ export function createPeerConnectionStatsPayload(
         localCandidate,
         remoteCandidate,
     };
-    return payload;
+    await fsPromises.appendFile(outputPath, `${JSON.stringify(payload)}\n`, "utf8");
 }
 
 export async function syncWithPeer(
     core: LiveSyncBaseCore<ServiceContext, never>,
-    p2pService: CLIP2PService | undefined,
     peerToken: string,
     timeoutSec: number
 ): Promise<CLIP2PPeer> {
-    const service = requireP2PService(core, p2pService);
-    await service.transportLifecycle.connect();
+    const replicator = await createReplicator(core);
+    await replicator.open();
     try {
         const timeoutMs = timeoutSec * 1000;
         const start = Date.now();
         let targetPeer: CLIP2PPeer | undefined;
 
         while (Date.now() - start <= timeoutMs) {
-            const peers = getSortedPeers(service);
+            const peers = getSortedPeers(replicator);
             targetPeer = resolvePeer(peers, peerToken);
             if (targetPeer) {
                 break;
@@ -163,11 +183,11 @@ export async function syncWithPeer(
             throw new Error(`Peer '${peerToken}' was not found within ${timeoutSec} seconds`);
         }
 
-        const pullResult = await service.targetedTransfer.pullFromPeer(targetPeer.peerId, { showNotice: false });
+        const pullResult = await replicator.replicateFrom(targetPeer.peerId, false);
         if (pullResult && "error" in pullResult && pullResult.error) {
             throw pullResult.error instanceof Error ? pullResult.error : LiveSyncError.fromError(pullResult.error);
         }
-        const pushResult = await service.targetedTransfer.requestPushToPeer(targetPeer.peerId);
+        const pushResult = await replicator.requestSynchroniseToPeer(targetPeer.peerId);
         if (!pushResult || pushResult.ok !== true) {
             const err: unknown = pushResult && "error" in pushResult ? pushResult.error : undefined;
             throw err instanceof Error
@@ -175,18 +195,15 @@ export async function syncWithPeer(
                 : LiveSyncError.fromError(err ?? "P2P sync failed while requesting remote sync");
         }
 
-        await writePeerConnectionStatsIfRequested(service, targetPeer);
+        await writePeerConnectionStatsIfRequested(replicator, targetPeer);
         return targetPeer;
     } finally {
-        await service.transportLifecycle.disconnect();
+        await replicator.close();
     }
 }
 
-export async function openP2PHost(
-    core: LiveSyncBaseCore<ServiceContext, never>,
-    p2pService: CLIP2PService | undefined
-): Promise<CLIP2PService> {
-    const service = requireP2PService(core, p2pService);
-    await service.transportLifecycle.connect();
-    return service;
+export async function openP2PHost(core: LiveSyncBaseCore<ServiceContext, never>): Promise<LiveSyncTrysteroReplicator> {
+    const replicator = await createReplicator(core);
+    await replicator.open();
+    return replicator;
 }

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

@@ -1,40 +1,5 @@
-import { describe, expect, it, vi } from "vitest";
-import { collectPeers, createPeerConnectionStatsPayload, parseTimeoutSeconds, syncWithPeer } from "./p2p";
-
-function createCore() {
-    const settings = { P2P_Enabled: true, P2P_AppID: "app-id", P2P_IsHeadless: false };
-    return {
-        services: {
-            setting: { currentSettings: () => settings },
-            replicator: { getNewReplicator: vi.fn(() => Promise.reject(new Error("must not be called"))) },
-        },
-    } as never;
-}
-
-function createP2PService() {
-    const connect = vi.fn(async () => undefined);
-    const disconnect = vi.fn(async () => undefined);
-    const pullFromPeer = vi.fn(async () => ({ ok: true }));
-    const requestPushToPeer = vi.fn(async () => ({ ok: true }));
-    return {
-        service: {
-            transportLifecycle: { isConnected: false, connect, disconnect },
-            peerDirectory: {
-                getPeers: () => [{ peerId: "peer-a", name: "Peer A", platform: "test" }],
-            },
-            targetedTransfer: {
-                pullFromPeer,
-                requestPushToPeer,
-                synchroniseWithPeer: vi.fn(),
-            },
-            diagnostics: { requestStatus: vi.fn(), getPeerConnectionMetrics: vi.fn() },
-        },
-        connect,
-        disconnect,
-        pullFromPeer,
-        requestPushToPeer,
-    };
-}
+import { describe, expect, it } from "vitest";
+import { parseTimeoutSeconds } from "./p2p";
 
 describe("p2p command helpers", () => {
     it("accepts non-negative timeout", () => {
@@ -50,88 +15,4 @@ describe("p2p command helpers", () => {
             "p2p-sync requires a non-negative timeout in seconds"
         );
     });
-
-    it("collects peers through service views without acquiring a concrete replicator", async () => {
-        const { service, connect, disconnect } = createP2PService();
-
-        await expect(collectPeers(createCore(), service as never, 0)).resolves.toEqual([
-            { peerId: "peer-a", name: "Peer A" },
-        ]);
-        expect(connect).toHaveBeenCalledOnce();
-        expect(disconnect).toHaveBeenCalledOnce();
-    });
-
-    it("synchronises through the targeted-transfer view", async () => {
-        const { service, pullFromPeer, requestPushToPeer } = createP2PService();
-
-        await expect(syncWithPeer(createCore(), service as never, "peer-a", 0)).resolves.toEqual({
-            peerId: "peer-a",
-            name: "Peer A",
-        });
-        expect(pullFromPeer).toHaveBeenCalledWith("peer-a", { showNotice: false });
-        expect(requestPushToPeer).toHaveBeenCalledWith("peer-a");
-    });
-
-    it("preserves the benchmark diagnostics JSONL contract", () => {
-        expect(
-            createPeerConnectionStatsPayload(
-                { peerId: "peer-a", name: "Peer A" },
-                {
-                    selectedPairPresent: true,
-                    selectedPairId: "pair-1",
-                    state: "succeeded",
-                    currentRoundTripTime: 0.01,
-                    totalRoundTripTime: 0.1,
-                    requestsSent: 3,
-                    responsesReceived: 3,
-                    packetsDiscardedOnSend: 0,
-                    bytesSent: 100,
-                    bytesReceived: 200,
-                    localCandidate: {
-                        id: "local-1",
-                        candidateType: "host",
-                        protocol: "udp",
-                        relayProtocol: "unknown",
-                    },
-                    remoteCandidate: {
-                        id: "remote-1",
-                        candidateType: "relay",
-                        protocol: "udp",
-                        relayProtocol: "udp",
-                    },
-                },
-                "2026-08-27T00:00:00.000Z"
-            )
-        ).toEqual({
-            generatedAt: "2026-08-27T00:00:00.000Z",
-            command: "p2p-sync",
-            peerId: "peer-a",
-            peerName: "Peer A",
-            candidatePathCollected: true,
-            selectedPath: "host<->relay",
-            selectedPair: {
-                id: "pair-1",
-                state: "succeeded",
-                currentRoundTripTime: 0.01,
-                totalRoundTripTime: 0.1,
-                requestsSent: 3,
-                responsesReceived: 3,
-                packetsDiscardedOnSend: 0,
-                bytesSent: 100,
-                bytesReceived: 200,
-            },
-            localCandidate: {
-                id: "local-1",
-                candidateType: "host",
-                protocol: "udp",
-                relayProtocol: "unknown",
-            },
-            remoteCandidate: {
-                id: "remote-1",
-                candidateType: "relay",
-                protocol: "udp",
-                relayProtocol: "udp",
-            },
-        });
-    });
 });

src/apps/cli/commands/runCommand.ts

@@ -2,8 +2,12 @@ import { decodeSettingsFromSetupURI } from "@vrtmrz/livesync-commonlib/compat/AP
 import { configURIBase } from "@vrtmrz/livesync-commonlib/compat/common/models/shared.const";
 import {
     DEFAULT_SETTINGS,
+    MILESTONE_DOCID,
     type FilePathWithPrefix,
     type ObsidianLiveSyncSettings,
+    REMOTE_COUCHDB,
+    REMOTE_MINIO,
+    type EntryMilestoneInfo,
     type EntryDoc,
 } from "@vrtmrz/livesync-commonlib/compat/common/types";
 import { ConnectionStringParser } from "@vrtmrz/livesync-commonlib/compat/common/ConnectionString";
@@ -19,26 +23,71 @@ import { performFullScan } from "@vrtmrz/livesync-commonlib/compat/serviceFeatur
 import { UnresolvedErrorManager } from "@vrtmrz/livesync-commonlib/compat/services/base/UnresolvedErrorManager";
 import { compatGlobal } from "@vrtmrz/livesync-commonlib/compat/common/coreEnvFunctions";
 import { fsPromises as fs, path } from "@vrtmrz/livesync-commonlib/node";
+import type { LiveSyncCouchDBReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
+import type { LiveSyncJournalReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator";
 import { writeStderrLine, writeStdoutLine } from "@/apps/cli/cliOutput";
-import {
-    CENTRAL_COMPATIBILITY_REJECTION_REASONS,
-    isReplicationCompleted,
-    NO_INTERACTION,
-    REMOTE_RESOURCE_KINDS,
-    USER_INITIATED_REPLICATION_AUTHORITY,
-} from "@vrtmrz/livesync-commonlib/replication";
-import { withOwnedRemoteResource } from "@/common/ownedRemoteResource";
-import {
-    isCentralRemoteAdministrationCommand,
-    runCentralRemoteAdministrationCommand,
-} from "./centralRemoteAdministration";
 
 function redactConnectionString(uri: string): string {
     return uri.replace(/\/\/([^@/]+)@/u, "//***@");
 }
 
+async function verifyRemoteState(
+    core: CLICommandContext["core"],
+    settings: ObsidianLiveSyncSettings
+): Promise<boolean> {
+    const { standardIo } = core.services.context;
+    const replicator = core.services.replicator.getActiveReplicator();
+    if (!replicator) {
+        standardIo.writeStderr("[Verification] No active replicator found\n");
+        return false;
+    }
+
+    if (!replicator.nodeid) {
+        await replicator.initializeDatabaseForReplication();
+    }
+
+    try {
+        let milestone: EntryMilestoneInfo | false | undefined = undefined;
+        if (settings.remoteType === REMOTE_COUCHDB) {
+            const dbRet = await (replicator as LiveSyncCouchDBReplicator).connectRemoteCouchDBWithSetting(
+                settings,
+                false,
+                true
+            );
+            if (typeof dbRet === "string") {
+                standardIo.writeStderr(`[Verification] Failed to connect to remote CouchDB: ${dbRet}\n`);
+                return false;
+            }
+            try {
+                milestone = await dbRet.db.get(MILESTONE_DOCID);
+            } finally {
+                await dbRet.db.close();
+            }
+        } else if (settings.remoteType === REMOTE_MINIO) {
+            milestone = await (replicator as LiveSyncJournalReplicator).client.downloadJson("_00000000-milestone.json");
+        }
+
+        if (milestone) {
+            const isLocked = !!milestone.locked;
+            const isAccepted = !!milestone.accepted_nodes?.includes(replicator.nodeid);
+            standardIo.writeStderr(`[Verification] Remote Database: ${isLocked ? "LOCKED" : "UNLOCKED"}\n`);
+            standardIo.writeStderr(
+                `[Verification] Current Device Node ID (${replicator.nodeid}): ${isAccepted ? "ACCEPTED" : "NOT ACCEPTED"}\n`
+            );
+            return true;
+        } else {
+            standardIo.writeStderr("[Verification] Milestone document not found on remote.\n");
+            return false;
+        }
+    } catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        standardIo.writeStderr(`[Verification] Failed to fetch milestone document: ${message}\n`);
+        return false;
+    }
+}
+
 export async function runCommand(options: CLIOptions, context: CLICommandContext): Promise<boolean> {
-    const { databasePath, core, replicationScheduling, settingsPath } = context;
+    const { databasePath, core, settingsPath } = context;
     const { standardIo } = core.services.context;
     const vaultPath = context.vaultPath || databasePath;
 
@@ -46,28 +95,19 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
     if (options.command === "daemon") {
         const log = (msg: unknown) => writeStderrLine(standardIo, `[Daemon] ${String(msg)}`);
 
-        // The daemon owns its own recurring poller. Suppress the application
-        // resume starter and generic periodic timer before restoring settings.
-        replicationScheduling.setExternalPollingMode(!!options.interval);
-
         // Skip the config mismatch dialog — the daemon cannot resolve it interactively
         // and the default "Dismiss" action would block replication. The daemon should
         // accept whatever configuration the remote has.
         await core.services.setting.applyPartial({ disableCheckingConfigMismatch: true }, true);
 
-        // 1. Replicate the configured remote into the local database so the
-        // mirror scan has content to work with.
-        log("Replicating from remote...");
-        const replResult = await core.services.replication.replicateUnattended({
-            trigger: "daemon",
-            interaction: NO_INTERACTION,
-        });
-        if (!isReplicationCompleted(replResult)) {
-            writeStderrLine(standardIo, "[Daemon] Initial replication failed, cannot continue");
+        // 1. Replicate CouchDB → local PouchDB so the mirror scan has content to work with.
+        log("Replicating from CouchDB...");
+        const replResult = await core.services.replication.replicate(true);
+        if (!replResult) {
+            writeStderrLine(standardIo, "[Daemon] Initial CouchDB replication failed, cannot continue");
             return false;
         }
-        replicationScheduling.markInitialOneShotSatisfied();
-        log("Initial replication complete");
+        log("CouchDB replication complete");
 
         // 2. Mirror scan to reconcile PouchDB ↔ local filesystem.
         const errorManager = new UnresolvedErrorManager(core.services.appLifecycle, core.services.context.events);
@@ -89,9 +129,8 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
                 true
             );
             // applySettings fires the full lifecycle: onSuspending → onResumed.
-            // The provider-independent scheduling feature owns any eligible
-            // Continuous start; the daemon marker suppresses a duplicate
-            // sync-on-start OneShot.
+            // ModuleReplicatorCouchDB starts continuous replication on onResumed
+            // via fireAndForget.
             await core.services.control.applySettings();
             // Lifecycle events (onSuspending) may re-enable suspension flags.
             // Clear them explicitly after the lifecycle completes. applyPartial
@@ -114,13 +153,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
 
             const poll = async () => {
                 try {
-                    const result = await core.services.replication.replicateUnattended({
-                        trigger: "daemon",
-                        interaction: NO_INTERACTION,
-                    });
-                    if (!isReplicationCompleted(result)) {
-                        throw new Error(`Daemon polling replication did not complete (${result.status}).`);
-                    }
+                    await core.services.replication.replicate(true);
                     if (consecutiveFailures > 0) {
                         consecutiveFailures--;
                         currentIntervalMs = Math.max(currentIntervalMs / 2, baseIntervalMs);
@@ -149,11 +182,11 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
                 return true;
             });
         } else {
-            log("LiveSync mode: restoring sync settings and starting continuous synchronisation where supported");
+            log("LiveSync mode: restoring sync settings and starting _changes feed");
             await restoreSyncSettings();
-            // The applySettings() lifecycle fires onResumed → the provider-
-            // independent scheduling feature, which starts Continuous when
-            // supported. Do not call a concrete Replicator directly.
+            // The applySettings() lifecycle fires onResumed → ModuleReplicatorCouchDB which
+            // starts continuous replication via fireAndForget(openReplication). Don't call
+            // openReplication directly — it races with the handler and causes dedup/termination.
             log("LiveSync active");
             const currentSettings = core.services.setting.currentSettings();
             if (!currentSettings.liveSync && !currentSettings.syncOnStart) {
@@ -171,19 +204,13 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
 
     if (options.command === "sync") {
         writeStdoutLine(standardIo, "[Command] sync");
-        const result = await core.services.replication.replicateUserInitiated({
-            trigger: "manual",
-            interaction: USER_INITIATED_REPLICATION_AUTHORITY,
-        });
-        if (!isReplicationCompleted(result)) {
+        const result = await core.services.replication.replicate(true);
+        if (!result) {
             // TODO: Standardise the logic for identifying the cause of replication
             // failure so that every reason (locked DB, version mismatch, network
             // error, etc.) is surfaced with a CLI-specific actionable message.
-            const recoveryHint = result.status === "failed" ? result.recoveryHint : undefined;
-            if (
-                recoveryHint?.reason === CENTRAL_COMPATIBILITY_REJECTION_REASONS.NODE_LOCKED ||
-                recoveryHint?.reason === CENTRAL_COMPATIBILITY_REJECTION_REASONS.NODE_CLEANED
-            ) {
+            const replicator = core.services.replicator.getActiveReplicator();
+            if (replicator?.remoteLockedAndDeviceNotAccepted) {
                 writeStderrLine(
                     standardIo,
                     `[Error] The remote database is locked and this device is not yet accepted.\n` +
@@ -191,7 +218,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
                 );
             }
         }
-        return isReplicationCompleted(result);
+        return !!result;
     }
 
     if (options.command === "p2p-peers") {
@@ -200,7 +227,7 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         }
         const timeoutSec = parseTimeoutSeconds(options.commandArgs[0], "p2p-peers");
         writeStderrLine(standardIo, `[Command] p2p-peers timeout=${timeoutSec}s`);
-        const peers = await collectPeers(core, context.p2pReplicator, timeoutSec);
+        const peers = await collectPeers(core, timeoutSec);
         if (peers.length > 0) {
             standardIo.writeStdout(peers.map((peer) => `[peer]\t${peer.peerId}\t${peer.name}`).join("\n") + "\n");
         }
@@ -217,14 +244,14 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         }
         const timeoutSec = parseTimeoutSeconds(options.commandArgs[1], "p2p-sync");
         writeStderrLine(standardIo, `[Command] p2p-sync peer=${peerToken} timeout=${timeoutSec}s`);
-        const peer = await syncWithPeer(core, context.p2pReplicator, peerToken, timeoutSec);
+        const peer = await syncWithPeer(core, peerToken, timeoutSec);
         writeStderrLine(standardIo, `[Done] P2P sync completed with ${peer.name} (${peer.peerId})`);
         return true;
     }
 
     if (options.command === "p2p-host") {
         writeStderrLine(standardIo, "[Command] p2p-host");
-        await openP2PHost(core, context.p2pReplicator);
+        await openP2PHost(core);
         writeStderrLine(standardIo, "[Ready] P2P host is running. Press Ctrl+C to stop.");
         await new Promise(() => {});
         return true;
@@ -730,8 +757,88 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         return true;
     }
 
-    if (isCentralRemoteAdministrationCommand(options.command)) {
-        return await runCentralRemoteAdministrationCommand(options, context, options.command);
+    if (options.command === "mark-resolved") {
+        const id = options.commandArgs[0]?.trim();
+        if (id) {
+            let switched = false;
+            await core.services.setting.updateSettings((currentSettings) => {
+                const activated = activateRemoteConfiguration(currentSettings, id);
+                if (activated) {
+                    switched = true;
+                    return activated;
+                }
+                return currentSettings;
+            }, false);
+
+            if (!switched) {
+                standardIo.writeStderr(`[Info] Failed to temporarily activate remote configuration: ${id}\n`);
+                return false;
+            }
+
+            await core.services.control.applySettings();
+        }
+
+        writeStderrLine(standardIo, `[Command] mark-resolved${id ? ` ${id}` : ""}`);
+        await core.services.replication.markResolved();
+        const settings = core.services.setting.currentSettings();
+        await verifyRemoteState(core, settings);
+        return true;
+    }
+
+    if (options.command === "unlock-remote") {
+        const id = options.commandArgs[0]?.trim();
+        if (id) {
+            let switched = false;
+            await core.services.setting.updateSettings((currentSettings) => {
+                const activated = activateRemoteConfiguration(currentSettings, id);
+                if (activated) {
+                    switched = true;
+                    return activated;
+                }
+                return currentSettings;
+            }, false);
+
+            if (!switched) {
+                standardIo.writeStderr(`[Info] Failed to temporarily activate remote configuration: ${id}\n`);
+                return false;
+            }
+
+            await core.services.control.applySettings();
+        }
+
+        writeStderrLine(standardIo, `[Command] unlock-remote${id ? ` ${id}` : ""}`);
+        await core.services.replication.markUnlocked();
+        const settings = core.services.setting.currentSettings();
+        await verifyRemoteState(core, settings);
+        return true;
+    }
+
+    if (options.command === "lock-remote") {
+        const id = options.commandArgs[0]?.trim();
+        if (id) {
+            let switched = false;
+            await core.services.setting.updateSettings((currentSettings) => {
+                const activated = activateRemoteConfiguration(currentSettings, id);
+                if (activated) {
+                    switched = true;
+                    return activated;
+                }
+                return currentSettings;
+            }, false);
+
+            if (!switched) {
+                standardIo.writeStderr(`[Info] Failed to temporarily activate remote configuration: ${id}\n`);
+                return false;
+            }
+
+            await core.services.control.applySettings();
+        }
+
+        writeStderrLine(standardIo, `[Command] lock-remote${id ? ` ${id}` : ""}`);
+        await core.services.replication.markLocked();
+        const settings = core.services.setting.currentSettings();
+        await verifyRemoteState(core, settings);
+        return true;
     }
 
     if (options.command === "remote-status") {
@@ -756,16 +863,13 @@ export async function runCommand(options: CLIOptions, context: CLICommandContext
         }
 
         writeStderrLine(standardIo, `[Command] remote-status${id ? ` ${id}` : ""}`);
-        const settings = core.services.setting.currentSettings();
-        const resource = await core.services.replicator.createRemoteResource(
-            REMOTE_RESOURCE_KINDS.CONNECTION,
-            settings
-        );
-        if (!resource) {
-            standardIo.writeStderr("[Error] Remote status is unavailable for the current provider\n");
+        const replicator = core.services.replicator.getActiveReplicator();
+        if (!replicator) {
+            standardIo.writeStderr("[Error] No active replicator found\n");
             return false;
         }
-        const status = await withOwnedRemoteResource(resource, (ownedResource) => ownedResource.getStatus());
+        const settings = core.services.setting.currentSettings();
+        const status = await replicator.getRemoteStatus(settings);
         if (status === false) {
             standardIo.writeStderr("[Error] Failed to fetch remote status\n");
             return false;

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

@@ -2,25 +2,10 @@ import { fsPromises as fs, os, path } from "@vrtmrz/livesync-commonlib/node";
 import * as processSetting from "@vrtmrz/livesync-commonlib/compat/API/processSetting";
 import { ConnectionStringParser } from "@vrtmrz/livesync-commonlib/compat/common/ConnectionString";
 import { configURIBase } from "@vrtmrz/livesync-commonlib/compat/common/models/shared.const";
-import {
-    DEFAULT_SETTINGS,
-    REMOTE_COUCHDB,
-    REMOTE_MINIO,
-    REMOTE_P2P,
-} from "@vrtmrz/livesync-commonlib/compat/common/types";
+import { DEFAULT_SETTINGS, REMOTE_COUCHDB, REMOTE_MINIO, REMOTE_P2P } from "@vrtmrz/livesync-commonlib/compat/common/types";
 import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
 import { runCommand } from "./runCommand";
 import type { CLIOptions } from "./types";
-import {
-    CENTRAL_REMOTE_ADMINISTRATION_ACTIONS,
-    CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS,
-    CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS,
-    CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES,
-    REMOTE_RESOURCE_KINDS,
-    CENTRAL_COMPATIBILITY_REJECTION_REASONS,
-    REPLICATION_COMPLETED,
-    replicationFailed,
-} from "@vrtmrz/livesync-commonlib/replication";
 
 function createStandardIoMock() {
     return {
@@ -59,26 +44,8 @@ function createCoreMock() {
                 markResolved: vi.fn(async () => {}),
                 markUnlocked: vi.fn(async () => {}),
                 markLocked: vi.fn(async () => {}),
-                replicateUserInitiated: vi.fn(async () => REPLICATION_COMPLETED),
             },
             replicator: {
-                runCentralRemoteAdministration: vi.fn(async ({ action }) => ({
-                    status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFIED,
-                    observation: {
-                        kind: CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS.MILESTONE,
-                        locked: action === CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.LOCK,
-                        accepted: true,
-                        nodeId: "test-node-id",
-                    },
-                })),
-                createRemoteResource: vi.fn(async () => ({
-                    check: vi.fn(async () => ({ ok: true as const })),
-                    getStatus: vi.fn(async () => ({
-                        db_name: "test-db",
-                        doc_count: 42,
-                    })),
-                    dispose: vi.fn(async () => undefined),
-                })),
                 getActiveReplicator: vi.fn(() => ({
                     nodeid: "test-node-id",
                     initializeDatabaseForReplication: vi.fn(async () => {}),
@@ -126,7 +93,6 @@ function makeOptions(command: CLIOptions["command"], commandArgs: string[]): CLI
         databasePath: "/tmp/vault",
         verbose: false,
         force: false,
-        compatRemoteAdminExitZero: false,
     };
 }
 
@@ -265,27 +231,6 @@ describe("runCommand abnormal cases", () => {
         vi.restoreAllMocks();
     });
 
-    it("reports a lock from the exact sync outcome without inspecting a replacement Replicator", async () => {
-        const core = createCoreMock();
-        core.services.replication.replicateUserInitiated.mockResolvedValue(
-            replicationFailed(new Error("locked"), {
-                reason: CENTRAL_COMPATIBILITY_REJECTION_REASONS.NODE_LOCKED,
-            })
-        );
-
-        await expect(
-            runCommand(makeOptions("sync", []), {
-                ...context,
-                core,
-            })
-        ).resolves.toBe(false);
-
-        expect(core.services.context.standardIo.writeStderr).toHaveBeenCalledWith(
-            expect.stringContaining("remote database is locked")
-        );
-        expect(core.services.replicator.getActiveReplicator).not.toHaveBeenCalled();
-    });
-
     it("pull returns false for non-existing path", async () => {
         const core = createCoreMock();
         core.serviceModules.fileHandler.dbToStorage.mockResolvedValue(false);
@@ -761,135 +706,28 @@ describe("runCommand abnormal cases", () => {
     });
 
     describe("mark-resolved and unlock-remote commands", () => {
-        it("reports a connection failure without claiming that every central remote is CouchDB", async () => {
-            const core = createCoreMock();
-            core.services.replicator.runCentralRemoteAdministration.mockResolvedValueOnce({
-                status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFICATION_FAILED,
-                reason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.CONNECTION_FAILED,
-                detail: new Error("remote unavailable"),
-            });
-
-            const result = await runCommand(makeOptions("mark-resolved", []), {
-                ...context,
-                core,
-            });
-
-            expect(result).toBe(false);
-            const verificationOutput = core.services.context.standardIo.writeStderr.mock.calls
-                .map(([chunk]: [string | Uint8Array]) =>
-                    typeof chunk === "string" ? chunk : new TextDecoder().decode(chunk)
-                )
-                .join("");
-            expect(verificationOutput).toContain(
-                "[Verification] Failed to connect to the configured remote: remote unavailable\n"
-            );
-            expect(verificationOutput).not.toContain("CouchDB");
-        });
-
-        it("fails by default when remote administration cannot verify its postcondition", async () => {
-            const core = createCoreMock();
-            core.services.replicator.runCentralRemoteAdministration.mockResolvedValueOnce({
-                status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFICATION_FAILED,
-                reason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.NO_ACTIVE_REPLICATOR,
-            });
-
-            const result = await runCommand(makeOptions("mark-resolved", []), {
-                ...context,
-                core,
-            });
-
-            expect(result).toBe(false);
-        });
-
-        it("preserves the historical zero exit for returned verification failures only when requested", async () => {
-            const core = createCoreMock();
-            core.services.replicator.runCentralRemoteAdministration.mockResolvedValueOnce({
-                status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFICATION_FAILED,
-                reason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.NO_ACTIVE_REPLICATOR,
-            });
-
-            const result = await runCommand(
-                { ...makeOptions("mark-resolved", []), compatRemoteAdminExitZero: true },
-                {
-                    ...context,
-                    core,
-                }
-            );
-
-            expect(result).toBe(true);
-        });
-
-        it("does not hide a thrown remote mutation failure behind the compatibility option", async () => {
-            const core = createCoreMock();
-            const failure = new Error("mutation failed");
-            core.services.replicator.runCentralRemoteAdministration.mockRejectedValueOnce(failure);
-
-            await expect(
-                runCommand(
-                    { ...makeOptions("mark-resolved", []), compatRemoteAdminExitZero: true },
-                    {
-                        ...context,
-                        core,
-                    }
-                )
-            ).rejects.toBe(failure);
-        });
-
-        it("does not hide an unknown remote ID behind the compatibility option", async () => {
-            const core = createCoreMock();
-
-            const result = await runCommand(
-                { ...makeOptions("mark-resolved", ["missing-remote"]), compatRemoteAdminExitZero: true },
-                {
-                    ...context,
-                    core,
-                }
-            );
-
-            expect(result).toBe(false);
-            expect(core.services.replicator.runCentralRemoteAdministration).not.toHaveBeenCalled();
-        });
-
-        it("fails a lock command when the observed milestone remains unlocked", async () => {
-            const core = createCoreMock();
-            core.services.replicator.runCentralRemoteAdministration.mockResolvedValueOnce({
-                status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFICATION_FAILED,
-                reason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.POSTCONDITION_MISMATCH,
-                observation: {
-                    kind: CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS.MILESTONE,
-                    locked: false,
-                    accepted: true,
-                    nodeId: "test-node-id",
-                },
-            });
-
-            const result = await runCommand(makeOptions("lock-remote", []), {
-                ...context,
-                core,
-            });
-
-            expect(result).toBe(false);
-            const verificationOutput = core.services.context.standardIo.writeStderr.mock.calls
-                .map(([chunk]: [string | Uint8Array]) =>
-                    typeof chunk === "string" ? chunk : new TextDecoder().decode(chunk)
-                )
-                .join("");
-            expect(verificationOutput).toContain("[Verification] Remote Database: UNLOCKED\n");
-            expect(verificationOutput).toContain("[Verification] Current Device Node ID (test-node-id): ACCEPTED\n");
-        });
-
         it("mark-resolved without args runs on active database", async () => {
             const core = createCoreMock();
+            const remoteDatabase = {
+                close: vi.fn(async () => undefined),
+                get: vi.fn(async () => ({
+                    locked: false,
+                    accepted_nodes: ["test-node-id"],
+                })),
+            };
+            core.services.replicator.getActiveReplicator.mockReturnValueOnce({
+                nodeid: "test-node-id",
+                initializeDatabaseForReplication: vi.fn(async () => undefined),
+                connectRemoteCouchDBWithSetting: vi.fn(async () => ({ db: remoteDatabase })),
+            });
             const result = await runCommand(makeOptions("mark-resolved", []), {
                 ...context,
                 core,
             });
             expect(result).toBe(true);
-            expect(core.services.replicator.runCentralRemoteAdministration).toHaveBeenCalledWith({
-                action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.MARK_RESOLVED,
-            });
+            expect(core.services.replication.markResolved).toHaveBeenCalledTimes(1);
             expect(core.services.control.applySettings).not.toHaveBeenCalled();
-            expect(core.services.replication.markResolved).not.toHaveBeenCalled();
+            expect(remoteDatabase.close).toHaveBeenCalledOnce();
         });
 
         it("mark-resolved with remote-id temporarily activates it and runs markResolved", async () => {
@@ -907,9 +745,7 @@ describe("runCommand abnormal cases", () => {
                 core,
             });
             expect(result).toBe(true);
-            expect(core.services.replicator.runCentralRemoteAdministration).toHaveBeenCalledWith({
-                action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.MARK_RESOLVED,
-            });
+            expect(core.services.replication.markResolved).toHaveBeenCalledTimes(1);
             expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
             expect(settings.activeConfigurationId).toBe("r1");
             expect(core.services.setting.updateSettings).toHaveBeenCalledWith(expect.any(Function), false);
@@ -922,9 +758,7 @@ describe("runCommand abnormal cases", () => {
                 core,
             });
             expect(result).toBe(true);
-            expect(core.services.replicator.runCentralRemoteAdministration).toHaveBeenCalledWith({
-                action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.UNLOCK,
-            });
+            expect(core.services.replication.markUnlocked).toHaveBeenCalledTimes(1);
             expect(core.services.control.applySettings).not.toHaveBeenCalled();
         });
 
@@ -943,9 +777,7 @@ describe("runCommand abnormal cases", () => {
                 core,
             });
             expect(result).toBe(true);
-            expect(core.services.replicator.runCentralRemoteAdministration).toHaveBeenCalledWith({
-                action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.UNLOCK,
-            });
+            expect(core.services.replication.markUnlocked).toHaveBeenCalledTimes(1);
             expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
             expect(settings.activeConfigurationId).toBe("r1");
             expect(core.services.setting.updateSettings).toHaveBeenCalledWith(expect.any(Function), false);
@@ -958,9 +790,7 @@ describe("runCommand abnormal cases", () => {
                 core,
             });
             expect(result).toBe(true);
-            expect(core.services.replicator.runCentralRemoteAdministration).toHaveBeenCalledWith({
-                action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.LOCK,
-            });
+            expect(core.services.replication.markLocked).toHaveBeenCalledTimes(1);
             expect(core.services.control.applySettings).not.toHaveBeenCalled();
         });
 
@@ -979,9 +809,7 @@ describe("runCommand abnormal cases", () => {
                 core,
             });
             expect(result).toBe(true);
-            expect(core.services.replicator.runCentralRemoteAdministration).toHaveBeenCalledWith({
-                action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.LOCK,
-            });
+            expect(core.services.replication.markLocked).toHaveBeenCalledTimes(1);
             expect(core.services.control.applySettings).toHaveBeenCalledTimes(1);
             expect(settings.activeConfigurationId).toBe("r1");
             expect(core.services.setting.updateSettings).toHaveBeenCalledWith(expect.any(Function), false);
@@ -989,17 +817,6 @@ describe("runCommand abnormal cases", () => {
 
         it("remote-status without args outputs status of active remote configuration", async () => {
             const core = createCoreMock();
-            const getStatus = vi.fn(async () => ({
-                db_name: "test-db",
-                doc_count: 42,
-            }));
-            const dispose = vi.fn(async () => undefined);
-            const createRemoteResource = vi.fn(async () => ({
-                check: vi.fn(),
-                getStatus,
-                dispose,
-            }));
-            core.services.replicator.createRemoteResource = createRemoteResource;
             const stdout = captureStdout(core);
             const result = await runCommand(makeOptions("remote-status", []), {
                 ...context,
@@ -1010,13 +827,6 @@ describe("runCommand abnormal cases", () => {
             const parsedStatus = JSON.parse(fullOutput);
             expect(parsedStatus.db_name).toBe("test-db");
             expect(parsedStatus.doc_count).toBe(42);
-            expect(createRemoteResource).toHaveBeenCalledWith(
-                REMOTE_RESOURCE_KINDS.CONNECTION,
-                core.services.setting.currentSettings()
-            );
-            expect(getStatus).toHaveBeenCalledOnce();
-            expect(dispose).toHaveBeenCalledOnce();
-            expect(core.services.replicator.getActiveReplicator).not.toHaveBeenCalled();
         });
 
         it("remote-status with remote-id temporarily activates it and outputs status", async () => {

src/apps/cli/commands/types.ts

@@ -1,8 +1,7 @@
 import { LiveSyncBaseCore } from "@/LiveSyncBaseCore";
 import type { ObsidianLiveSyncSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
 import type { NodeServiceContext } from "@/apps/cli/services/NodeServiceContext";
-import type { UseP2PReplicatorResult } from "@vrtmrz/livesync-commonlib/p2p";
-import type { ReplicationSchedulingControl } from "@/serviceFeatures/replicationScheduling";
+import type { UseP2PReplicatorResult } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/UseP2PReplicatorResult";
 
 export type CLICommand =
     | "daemon"
@@ -42,8 +41,6 @@ export interface CLIOptions {
     debug?: boolean;
     force?: boolean;
     writeSettings?: boolean;
-    /** Restore the former zero exit code after a returned remote-administration verification failure. */
-    compatRemoteAdminExitZero?: boolean;
     command: CLICommand;
     commandArgs: string[];
     interval?: number;
@@ -53,8 +50,6 @@ export interface CLICommandContext {
     databasePath: string;
     vaultPath: string;
     core: LiveSyncBaseCore<NodeServiceContext, never>;
-    /** Host-composition view used only to coordinate daemon-owned recurring work. */
-    replicationScheduling: ReplicationSchedulingControl;
     /** Current-result contract owned by the P2P service feature. */
     p2pReplicator?: UseP2PReplicatorResult;
     settingsPath: string;

src/apps/cli/deploy/install.sh

@@ -8,7 +8,7 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd -- "$SCRIPT_DIR/../../.." && pwd)"
+REPO_ROOT="$(cd -- "$SCRIPT_DIR/../../../.." && pwd)"
 CLI_DIR="$REPO_ROOT/src/apps/cli"
 SERVICE_TEMPLATE="$SCRIPT_DIR/livesync-cli.service"
 
@@ -104,30 +104,70 @@ fi
 # ── Install binary ───────────────────────────────────────────────────────────
 if [[ "$INSTALL_MODE" == "user" ]]; then
     BIN_DIR="$HOME/.local/bin"
+    LIB_DIR="$HOME/.local/lib/livesync-cli"
     UNIT_DIR="$HOME/.config/systemd/user"
     SYSTEMCTL_FLAGS="--user"
 else
     BIN_DIR="/usr/local/bin"
+    LIB_DIR="/usr/local/lib/livesync-cli"
     UNIT_DIR="/etc/systemd/system"
     SYSTEMCTL_FLAGS=""
 fi
 
-mkdir -p "$BIN_DIR"
+LIB_PARENT="$(dirname -- "$LIB_DIR")"
+mkdir -p "$BIN_DIR" "$LIB_PARENT"
 
 LIVESYNC_BIN="$BIN_DIR/livesync-cli"
-LIVESYNC_JS="$BIN_DIR/livesync-cli.js"
+LIVESYNC_JS="$LIB_DIR/dist/index.cjs"
 
-# Copy the CJS bundle so the wrapper is self-contained and independent of the
-# build directory location.
-cp "$BUILT_CJS" "$LIVESYNC_JS"
+# Build a complete runtime payload before replacing any previous installation.
+# The Vite output contains hashed sibling chunks, while some Node dependencies
+# deliberately remain external and must be installed next to the bundle.
+PAYLOAD_STAGING="$(mktemp -d "$LIB_PARENT/.livesync-cli.install.XXXXXX")"
+cleanup_payload() {
+    if [[ -n "$PAYLOAD_STAGING" ]] && [[ -e "$PAYLOAD_STAGING" ]]; then
+        rm -rf -- "$PAYLOAD_STAGING"
+    fi
+}
+trap cleanup_payload EXIT
 
-# Write a bash wrapper that invokes node on the installed bundle.
+cp "$CLI_DIR/package.json" "$PAYLOAD_STAGING/package.json"
+npm install --omit=dev --no-audit --no-fund --prefix "$PAYLOAD_STAGING"
+cp -R "$CLI_DIR/dist" "$PAYLOAD_STAGING/dist"
+
+if ! node "$PAYLOAD_STAGING/dist/index.cjs" --help >/dev/null; then
+    echo "Error: installed CLI failed its start-up check" >&2
+    exit 1
+fi
+
+PAYLOAD_BACKUP=""
+if [[ -e "$LIB_DIR" ]] || [[ -L "$LIB_DIR" ]]; then
+    PAYLOAD_BACKUP="$(mktemp -d "$LIB_PARENT/.livesync-cli.backup.XXXXXX")"
+    rmdir "$PAYLOAD_BACKUP"
+    mv -- "$LIB_DIR" "$PAYLOAD_BACKUP"
+fi
+
+if ! mv -- "$PAYLOAD_STAGING" "$LIB_DIR"; then
+    if [[ -n "$PAYLOAD_BACKUP" ]]; then
+        mv -- "$PAYLOAD_BACKUP" "$LIB_DIR"
+    fi
+    echo "Error: failed to install the CLI files at $LIB_DIR" >&2
+    exit 1
+fi
+PAYLOAD_STAGING=""
+
+if [[ -n "$PAYLOAD_BACKUP" ]]; then
+    rm -rf -- "$PAYLOAD_BACKUP"
+fi
+trap - EXIT
+
+# Write a bash wrapper that invokes Node.js on the installed payload.
 cat > "$LIVESYNC_BIN" <<WRAPPER
 #!/usr/bin/env bash
 exec node "$LIVESYNC_JS" "\$@"
 WRAPPER
 chmod +x "$LIVESYNC_BIN"
-echo "[INFO] Installed bundle:  $LIVESYNC_JS"
+echo "[INFO] Installed CLI files: $LIB_DIR"
 echo "[INFO] Installed binary: $LIVESYNC_BIN"
 
 # ── Write systemd unit ───────────────────────────────────────────────────────
@@ -180,6 +220,15 @@ systemctl $SYSTEMCTL_FLAGS daemon-reload
 # shellcheck disable=SC2086
 systemctl $SYSTEMCTL_FLAGS enable --now livesync-cli
 
+sleep 1
+# shellcheck disable=SC2086
+if ! systemctl $SYSTEMCTL_FLAGS is-active --quiet livesync-cli; then
+    echo "Error: livesync-cli service did not remain active after startup." >&2
+    # shellcheck disable=SC2086
+    systemctl $SYSTEMCTL_FLAGS status livesync-cli --no-pager || true
+    exit 1
+fi
+
 echo ""
 echo "[Done] livesync-cli service installed and started."
 echo ""

src/apps/cli/deploy/install.unit.spec.ts

@@ -0,0 +1,192 @@
+import { spawnSync } from "node:child_process";
+import { chmod, copyFile, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { delimiter, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { afterEach, describe, expect, it } from "vitest";
+
+const deploySourceDirectory = dirname(fileURLToPath(import.meta.url));
+const temporaryDirectories: string[] = [];
+
+type InstallerFixture = {
+    cliDirectory: string;
+    environment: NodeJS.ProcessEnv;
+    homeDirectory: string;
+    installerPath: string;
+    npmCallLog: string;
+    repositoryRoot: string;
+    systemctlCallLog: string;
+    vaultDirectory: string;
+};
+
+async function writeExecutable(path: string, content: string): Promise<void> {
+    await writeFile(path, `${content}\n`, "utf8");
+    await chmod(path, 0o755);
+}
+
+async function createInstallerFixture(serviceActive: boolean): Promise<InstallerFixture> {
+    const temporaryDirectory = await mkdtemp(join(tmpdir(), "livesync-cli-installer-"));
+    temporaryDirectories.push(temporaryDirectory);
+
+    const repositoryRoot = join(temporaryDirectory, "repository");
+    const cliDirectory = join(repositoryRoot, "src", "apps", "cli");
+    const deployDirectory = join(cliDirectory, "deploy");
+    const distDirectory = join(cliDirectory, "dist");
+    const fakeBinDirectory = join(temporaryDirectory, "fake-bin");
+    const homeDirectory = join(temporaryDirectory, "home");
+    const vaultDirectory = join(temporaryDirectory, "vault");
+    const npmCallLog = join(temporaryDirectory, "npm-calls.log");
+    const systemctlCallLog = join(temporaryDirectory, "systemctl-calls.log");
+
+    await Promise.all([
+        mkdir(deployDirectory, { recursive: true }),
+        mkdir(distDirectory, { recursive: true }),
+        mkdir(fakeBinDirectory, { recursive: true }),
+        mkdir(homeDirectory, { recursive: true }),
+        mkdir(vaultDirectory, { recursive: true }),
+    ]);
+
+    await Promise.all([
+        copyFile(join(deploySourceDirectory, "install.sh"), join(deployDirectory, "install.sh")),
+        copyFile(join(deploySourceDirectory, "livesync-cli.service"), join(deployDirectory, "livesync-cli.service")),
+        writeFile(
+            join(repositoryRoot, "package.json"),
+            JSON.stringify({ private: true, workspaces: ["src/apps/*"] }),
+            "utf8"
+        ),
+        writeFile(
+            join(cliDirectory, "package.json"),
+            JSON.stringify({
+                name: "self-hosted-livesync-cli",
+                private: true,
+                version: "0.0.0",
+                dependencies: { "fixture-runtime-dependency": "1.0.0" },
+            }),
+            "utf8"
+        ),
+        writeFile(
+            join(distDirectory, "index.cjs"),
+            'const chunk = require("./chunk.cjs");\n' +
+                'const dependency = require("fixture-runtime-dependency");\n' +
+                "process.stdout.write(`${chunk}:${dependency}\\n`);\n",
+            "utf8"
+        ),
+        writeFile(join(distDirectory, "chunk.cjs"), 'module.exports = "chunk-ready";\n', "utf8"),
+    ]);
+
+    await writeExecutable(
+        join(fakeBinDirectory, "npm"),
+        [
+            "#!/usr/bin/env bash",
+            "set -euo pipefail",
+            'printf \'%s|%s\\n\' "$PWD" "$*" >> "$NPM_CALL_LOG"',
+            'prefix=""',
+            "expect_prefix=0",
+            'for argument in "$@"; do',
+            '    if [[ "$expect_prefix" -eq 1 ]]; then',
+            '        prefix="$argument"',
+            "        expect_prefix=0",
+            '    elif [[ "$argument" == "--prefix" ]]; then',
+            "        expect_prefix=1",
+            "    fi",
+            "done",
+            'if [[ -n "$prefix" ]]; then',
+            '    mkdir -p "$prefix/node_modules/fixture-runtime-dependency"',
+            "    printf '%s\\n' 'module.exports = \"dependency-ready\";' > \"$prefix/node_modules/fixture-runtime-dependency/index.js\"",
+            "fi",
+        ].join("\n")
+    );
+    await writeExecutable(
+        join(fakeBinDirectory, "systemctl"),
+        [
+            "#!/usr/bin/env bash",
+            "set -euo pipefail",
+            'printf \'%s\\n\' "$*" >> "$SYSTEMCTL_CALL_LOG"',
+            'if [[ " $* " == *" is-active "* ]]; then',
+            '    [[ "${FAKE_SYSTEMCTL_ACTIVE:-1}" == "1" ]]',
+            "    exit",
+            "fi",
+            'if [[ " $* " == *" status "* ]]; then',
+            "    printf '%s\\n' \"fixture service status\"",
+            "fi",
+        ].join("\n")
+    );
+    await writeExecutable(join(fakeBinDirectory, "sleep"), ["#!/usr/bin/env bash", "exit 0"].join("\n"));
+
+    return {
+        cliDirectory,
+        environment: {
+            ...process.env,
+            FAKE_SYSTEMCTL_ACTIVE: serviceActive ? "1" : "0",
+            HOME: homeDirectory,
+            NPM_CALL_LOG: npmCallLog,
+            PATH: `${fakeBinDirectory}${delimiter}${process.env.PATH ?? ""}`,
+            SYSTEMCTL_CALL_LOG: systemctlCallLog,
+        },
+        homeDirectory,
+        installerPath: join(deployDirectory, "install.sh"),
+        npmCallLog,
+        repositoryRoot,
+        systemctlCallLog,
+        vaultDirectory,
+    };
+}
+
+function runInstaller(fixture: InstallerFixture) {
+    return spawnSync("bash", [fixture.installerPath, "--vault", fixture.vaultDirectory], {
+        encoding: "utf8",
+        env: fixture.environment,
+    });
+}
+
+afterEach(async () => {
+    await Promise.all(
+        temporaryDirectories.splice(0).map((directory) => rm(directory, { recursive: true, force: true }))
+    );
+});
+
+describe.skipIf(process.platform === "win32")("CLI systemd installer", () => {
+    it("installs a runnable CLI independently of the source repository", async () => {
+        const fixture = await createInstallerFixture(true);
+
+        const installation = runInstaller(fixture);
+
+        expect(installation.error).toBeUndefined();
+        expect(installation.status, installation.stderr).toBe(0);
+        expect(installation.stdout).toContain("[Done] livesync-cli service installed and started.");
+
+        const installedCommand = join(fixture.homeDirectory, ".local", "bin", "livesync-cli");
+        const installedPayload = join(fixture.homeDirectory, ".local", "lib", "livesync-cli", "dist", "index.cjs");
+        const installedUnit = join(fixture.homeDirectory, ".config", "systemd", "user", "livesync-cli.service");
+        expect(await readFile(installedPayload, "utf8")).toContain('require("./chunk.cjs")');
+        expect(await readFile(installedUnit, "utf8")).toContain("Type=exec");
+
+        await rm(fixture.repositoryRoot, { recursive: true });
+
+        const command = spawnSync(installedCommand, [], { encoding: "utf8", env: fixture.environment });
+        expect(command.error).toBeUndefined();
+        expect(command.status, command.stderr).toBe(0);
+        expect(command.stdout).toBe("chunk-ready:dependency-ready\n");
+
+        const npmCalls = await readFile(fixture.npmCallLog, "utf8");
+        expect(npmCalls).toContain(`${fixture.repositoryRoot}|install --silent`);
+        expect(npmCalls).toContain(`${fixture.cliDirectory}|run build`);
+        expect(npmCalls).toMatch(/install .*--omit=dev|install --omit=dev/);
+
+        const systemctlCalls = await readFile(fixture.systemctlCallLog, "utf8");
+        expect(systemctlCalls).toContain("--user enable --now livesync-cli");
+        expect(systemctlCalls).toContain("--user is-active --quiet livesync-cli");
+    });
+
+    it("does not report success when the service fails to remain active", async () => {
+        const fixture = await createInstallerFixture(false);
+
+        const installation = runInstaller(fixture);
+        const combinedOutput = `${installation.stdout}\n${installation.stderr}`;
+
+        expect(installation.error).toBeUndefined();
+        expect(installation.status).not.toBe(0);
+        expect(combinedOutput).toContain("service did not remain active after startup");
+        expect(combinedOutput).not.toContain("[Done]");
+    });
+});

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

@@ -4,7 +4,7 @@ After=network-online.target
 Wants=network-online.target
 
 [Service]
-Type=simple
+Type=exec
 ExecStart=LIVESYNC_BIN LIVESYNC_VAULT_PATH
 Restart=on-failure
 RestartSec=10

src/apps/cli/main.ts

@@ -23,8 +23,8 @@ import type { CLICommand, CLICommandContext, CLIOptions } from "./commands/types
 import { getPathFromUXFileInfo } from "@vrtmrz/livesync-commonlib/compat/common/typeUtils";
 import { stripAllPrefixes } from "@vrtmrz/livesync-commonlib/compat/string_and_binary/path";
 import { IgnoreRules } from "./serviceModules/IgnoreRules";
-import { useP2PReplicatorFeature, type UseP2PReplicatorResult } from "@vrtmrz/livesync-commonlib/p2p";
-import type { ReplicationSchedulingControl } from "@/serviceFeatures/replicationScheduling";
+import { useP2PReplicatorFeature } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/useP2PReplicatorFeature";
+import type { UseP2PReplicatorResult } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/UseP2PReplicatorResult";
 import { createNodeStandardIo, fsPromises as fs, path } from "@vrtmrz/livesync-commonlib/node";
 import type { StandardIo } from "@vrtmrz/livesync-commonlib/context";
 import { writeStderrLine, writeStdoutLine } from "./cliOutput";
@@ -103,8 +103,6 @@ Options:
                               (defaults to database-path; allows separate PouchDB and vault dirs)
   --interval <N>, -i <N>  (daemon only) Poll CouchDB every N seconds instead of using the _changes feed
   --write-settings         Write setting changes after a successful command
-  --compat-remote-admin-exit-zero
-                           Preserve the former zero exit code when remote-administration verification fails
 
 Examples:
     livesync-cli ./my-database                        Run daemon (LiveSync mode)
@@ -155,7 +153,6 @@ export function parseArgs(standardIo: StandardIo = createNodeStandardIo()): CLIO
     let debug = false;
     let force = false;
     let writeSettings = false;
-    let compatRemoteAdminExitZero = false;
     let interval: number | undefined;
     let command: CLICommand = "daemon";
     const commandArgs: string[] = [];
@@ -215,9 +212,6 @@ export function parseArgs(standardIo: StandardIo = createNodeStandardIo()): CLIO
             case "--write-settings":
                 writeSettings = true;
                 break;
-            case "--compat-remote-admin-exit-zero":
-                compatRemoteAdminExitZero = true;
-                break;
             default: {
                 if (!databasePath) {
                     if (command === "daemon" && isCLICommand(token)) {
@@ -259,7 +253,6 @@ export function parseArgs(standardIo: StandardIo = createNodeStandardIo()): CLIO
         debug,
         force,
         writeSettings,
-        compatRemoteAdminExitZero,
         command,
         commandArgs,
         interval,
@@ -297,10 +290,7 @@ export async function main(
 ) {
     const options = parseArgs(standardIo);
     if (options.interval && options.command !== "daemon") {
-        writeStderrLine(
-            standardIo,
-            `Warning: --interval is only used in daemon mode, ignored for '${options.command}'`
-        );
+        writeStderrLine(standardIo, `Warning: --interval is only used in daemon mode, ignored for '${options.command}'`);
     }
     const avoidStdoutNoise =
         options.command === "cat" ||
@@ -430,10 +420,7 @@ export async function main(
     // In daemon mode the default handler must run so changes are applied to the filesystem.
     if (options.command !== "daemon") {
         serviceHubInstance.replication.processSynchroniseResult.addHandler(async () => {
-            writeStderrLine(
-                standardIo,
-                `[Info] Replication result received, but not processed automatically in CLI mode.`
-            );
+            writeStderrLine(standardIo, `[Info] Replication result received, but not processed automatically in CLI mode.`);
             return await Promise.resolve(true);
         }, -100);
     }
@@ -485,7 +472,6 @@ export async function main(
 
     // Create LiveSync core
     let p2pReplicator: UseP2PReplicatorResult | undefined;
-    let replicationScheduling: ReplicationSchedulingControl | undefined;
     const core = new LiveSyncBaseCore(
         serviceHubInstance,
         (core: LiveSyncBaseCore<NodeServiceContext, never>, serviceHub: InjectableServiceHub<NodeServiceContext>) => {
@@ -493,8 +479,7 @@ export async function main(
         },
         (core) => [],
         () => [], // No add-ons
-        (core, coreFeatureViews) => {
-            replicationScheduling = coreFeatureViews.replicationScheduling;
+        (core) => {
             // Register P2P replicator feature.
             p2pReplicator = useP2PReplicatorFeature(core);
             // Add target filter to prevent internal files are handled
@@ -526,9 +511,6 @@ export async function main(
             }
         }
     );
-    if (!replicationScheduling) {
-        throw new Error("Replication scheduling was not provided during core feature composition.");
-    }
 
     // Setup signal handlers for graceful shutdown
     const shutdown = async (signal: string) => {
@@ -635,7 +617,6 @@ export async function main(
                 databasePath,
                 vaultPath,
                 core,
-                replicationScheduling,
                 p2pReplicator,
                 settingsPath,
                 originalSyncSettings,

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

@@ -69,7 +69,6 @@ describe("CLI parseArgs", () => {
         const combined = standardIo.writeStdout.mock.calls.flat().join("");
         expect(combined).toContain("Usage:");
         expect(combined).toContain("livesync-cli <database-path> [options] <command> [command-args]");
-        expect(combined).toContain("--compat-remote-admin-exit-zero");
     });
 
     it("parses p2p-peers command and timeout", () => {
@@ -216,13 +215,4 @@ describe("CLI parseArgs", () => {
         expect(parsed.writeSettings).toBe(true);
         expect(parsed.commandArgs).toEqual([]);
     });
-
-    it("parses the remote-administration exit compatibility option globally", () => {
-        process.argv = ["node", "livesync-cli", "./vault", "--compat-remote-admin-exit-zero", "mark-resolved"];
-        const parsed = parseArgs();
-
-        expect(parsed.command).toBe("mark-resolved");
-        expect(parsed.compatRemoteAdminExitZero).toBe(true);
-        expect(parsed.commandArgs).toEqual([]);
-    });
 });

src/apps/cli/package.json

@@ -12,7 +12,7 @@
         "buildRun": "npm run build && npm run cli --",
         "build:docker": "docker build -f Dockerfile -t livesync-cli ../../..",
         "check": "tsc -p tsconfig.json",
-        "test:unit": "cd ../../.. && npx vitest run --config vitest.config.unit.ts src/apps/cli/main.unit.spec.ts src/apps/cli/settingsPersistence.unit.spec.ts src/apps/cli/commands/utils.unit.spec.ts src/apps/cli/commands/runCommand.unit.spec.ts src/apps/cli/commands/p2p.unit.spec.ts",
+        "test:unit": "cd ../../.. && npx vitest run --config vitest.config.unit.ts src/apps/cli/main.unit.spec.ts src/apps/cli/settingsPersistence.unit.spec.ts src/apps/cli/commands/utils.unit.spec.ts src/apps/cli/commands/runCommand.unit.spec.ts src/apps/cli/commands/p2p.unit.spec.ts src/apps/cli/deploy/install.unit.spec.ts",
         "test:e2e:two-vaults": "bash test/test-e2e-two-vaults-with-docker-linux.sh",
         "test:e2e:two-vaults:common": "bash test/test-e2e-two-vaults-common.sh",
         "test:e2e:two-vaults:matrix": "bash test/test-e2e-two-vaults-matrix.sh",

src/apps/cli/test-support/p2p-replicator-replacement.ts

@@ -1,6 +1,6 @@
 import type { FilePathWithPrefix } from "@vrtmrz/livesync-commonlib/compat/common/types";
+import { LiveSyncTrysteroReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/LiveSyncTrysteroReplicator";
 import { compatGlobal } from "@vrtmrz/livesync-commonlib/compat/common/coreEnvFunctions";
-import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
 import type { CLICommandContext } from "@/apps/cli/commands/types";
 import { openP2PHost } from "@/apps/cli/commands/p2p";
 
@@ -15,35 +15,32 @@ function describeError(value: unknown): string {
     return value instanceof Error ? (value.stack ?? value.message) : String(value);
 }
 
-type ProbeP2PService = Pick<P2PServiceViews, "transportLifecycle" | "peerDirectory" | "targetedTransfer">;
-
-async function waitForServing(service: ProbeP2PService, timeoutMs: number): Promise<void> {
+async function waitForServing(replicator: LiveSyncTrysteroReplicator, timeoutMs: number): Promise<void> {
     const started = Date.now();
     while (Date.now() - started <= timeoutMs) {
-        if (service.transportLifecycle.isConnected) return;
+        if (replicator.server?.isServing) return;
         await delay(200);
     }
-    throw new Error("The stable P2P service did not start serving within the timeout");
+    throw new Error("The replacement P2P replicator did not start serving within the timeout");
 }
 
 async function waitForPeer(
-    service: ProbeP2PService,
+    replicator: LiveSyncTrysteroReplicator,
     targetPeer: string,
     timeoutMs: number
 ): Promise<{ peerId: string; name: string }> {
     const started = Date.now();
     while (Date.now() - started <= timeoutMs) {
-        const peer = service.peerDirectory
-            .getPeers()
-            .find((candidate) => candidate.name === targetPeer || candidate.peerId === targetPeer);
+        const peer = replicator.knownAdvertisements.find(
+            (candidate) => candidate.name === targetPeer || candidate.peerId === targetPeer
+        );
         if (peer) return peer;
         await delay(200);
     }
-    const knownPeers = service.peerDirectory
-        .getPeers()
-        .map((peer) => `${peer.name} (${peer.peerId})`)
-        .join(", ");
-    throw new Error(`Peer '${targetPeer}' was not discovered within the timeout. Known peers: ${knownPeers || "none"}`);
+    const knownPeers = replicator.knownAdvertisements.map((peer) => `${peer.name} (${peer.peerId})`).join(", ");
+    throw new Error(
+        `Peer '${targetPeer}' was not discovered within the timeout. Known peers: ${knownPeers || "none"}`
+    );
 }
 
 function assertPullSucceeded(result: unknown): void {
@@ -53,17 +50,15 @@ function assertPullSucceeded(result: unknown): void {
 }
 
 async function communicateWithPeer(
-    service: ProbeP2PService,
+    replicator: LiveSyncTrysteroReplicator,
     targetPeer: string,
     timeoutMs: number
 ): Promise<{ peerId: string; name: string }> {
-    if (!service.transportLifecycle.isConnected) {
-        await service.transportLifecycle.connect();
-    }
-    await waitForServing(service, timeoutMs);
-    const peer = await waitForPeer(service, targetPeer, timeoutMs);
-    assertPullSucceeded(await service.targetedTransfer.pullFromPeer(peer.peerId, { showNotice: false }));
-    const pushResult = await service.targetedTransfer.requestPushToPeer(peer.peerId);
+    await replicator.open();
+    await waitForServing(replicator, timeoutMs);
+    const peer = await waitForPeer(replicator, targetPeer, timeoutMs);
+    assertPullSucceeded(await replicator.replicateFrom(peer.peerId, false));
+    const pushResult = await replicator.requestSynchroniseToPeer(peer.peerId);
     if (!pushResult || pushResult.ok !== true) {
         throw new Error(`P2P push failed: ${describeError(pushResult?.error)}`);
     }
@@ -83,39 +78,35 @@ export async function runP2PReplicatorReplacementProbe(
         throw new Error("The CLI did not expose its P2P service-feature result to the integration probe");
     }
 
-    const initialActiveReplicator = core.services.replicator.getActiveReplicator();
-    if (!initialActiveReplicator) {
-        throw new Error("The CLI did not activate the initial P2P Replicator adapter");
+    const firstReplicator = await openP2PHost(core);
+    if (p2pReplicator.replicator !== firstReplicator) {
+        throw new Error("The P2P service feature did not expose the newly created replicator");
     }
-    const compatibilityFacade = p2pReplicator.replicator;
-    const p2pService = await openP2PHost(core, p2pReplicator);
 
-    const firstPeer = await communicateWithPeer(p2pService, targetPeer, timeoutMs);
+    const firstPeer = await communicateWithPeer(firstReplicator, targetPeer, timeoutMs);
     const initialised = await core.services.databaseEvents.initialiseDatabase(false, true, false);
     if (!initialised) {
         throw new Error("Database reinitialisation failed during the P2P replacement probe");
     }
 
-    const replacementActiveReplicator = core.services.replicator.getActiveReplicator();
-    if (!replacementActiveReplicator) {
-        throw new Error("ReplicatorService did not activate a replacement P2P Replicator adapter");
+    const replacementReplicator = p2pReplicator.replicator;
+    if (core.services.replicator.getActiveReplicator() !== replacementReplicator) {
+        throw new Error("ReplicatorService did not activate the P2P service feature's replacement replicator");
     }
-    if (replacementActiveReplicator === initialActiveReplicator) {
-        throw new Error("Database reinitialisation retained the previous active P2P Replicator adapter");
+    if (replacementReplicator === firstReplicator) {
+        throw new Error("Database reinitialisation retained the previous P2P replicator instance");
     }
-    if (p2pReplicator.replicator !== compatibilityFacade) {
-        throw new Error("Database reinitialisation replaced the stable P2P service compatibility facade");
-    }
-    if (p2pService.transportLifecycle.isConnected) {
-        throw new Error("Database reinitialisation left the database-bound P2P room open");
+    if (firstReplicator.server !== undefined) {
+        throw new Error("The previous P2P replicator remained open after replacement");
     }
 
     const settings = core.services.setting.currentSettings();
     settings.P2P_AutoStart = true;
     await core.services.control.applySettings();
-    await waitForServing(p2pService, timeoutMs);
-    if (p2pReplicator.replicator !== compatibilityFacade) {
-        throw new Error("A setting event replaced the stable P2P service compatibility facade");
+    const resumedReplicator = p2pReplicator.replicator;
+    await waitForServing(resumedReplicator, timeoutMs);
+    if (firstReplicator.server !== undefined) {
+        throw new Error("A setting event reopened the previous P2P replicator");
     }
 
     const encoded = new TextEncoder().encode(noteContent);
@@ -127,7 +118,7 @@ export async function runP2PReplicatorReplacementProbe(
     });
     await core.serviceModules.fileHandler.storeFileToDB(notePath as FilePathWithPrefix, true);
 
-    const replacementPeer = await communicateWithPeer(p2pService, targetPeer, timeoutMs);
+    const replacementPeer = await communicateWithPeer(resumedReplicator, targetPeer, timeoutMs);
     if (replacementPeer.name !== firstPeer.name) {
         throw new Error(
             `The replacement replicator reached '${replacementPeer.name}' instead of the original peer '${firstPeer.name}'`
@@ -135,7 +126,7 @@ export async function runP2PReplicatorReplacementProbe(
     }
 
     core.services.context.standardIo.writeStdout(
-        `[Probe] The active P2P adapter was replaced, the stable service reopened, and ${notePath} was sent through it.\n`
+        `[Probe] P2P replicator replaced, old transport stayed closed, and ${notePath} was sent through the replacement.\n`
     );
     return true;
 }

src/apps/cli/testdeno/deno.json

@@ -8,7 +8,6 @@
         "test:decoupled-vault": "deno test --env-file=.test.env -A --no-check test-decoupled-vault.ts",
         "test:remote-commands": "deno test --env-file=.test.env -A --no-check test-remote-commands.ts",
         "test:settings-writeback": "deno test -A --no-check test-settings-writeback.ts",
-        "test:remote-administration-exit-codes": "deno test -A --no-check test-remote-administration-exit-codes.ts",
         "test:push-pull": "deno test --env-file=.test.env -A --no-check test-push-pull.ts",
         "test:setup-put-cat": "deno test --env-file=.test.env -A --no-check test-setup-put-cat.ts",
         "test:mirror": "deno test --env-file=.test.env -A --no-check test-mirror.ts",

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

@@ -143,12 +143,8 @@ export async function createCompressionBenchmarkDataset(options: {
     );
     await copyRepositoryFile("json", "package.json", "package.json");
     await copyRepositoryFile("json", "manifest.json", "manifest.json");
-    await copyRepositoryFile("ts", "src/serviceFeatures/replication/index.ts", "replicationFeature.ts");
-    await copyRepositoryFile(
-        "ts",
-        "src/serviceFeatures/replication/ReplicateResultProcessor.ts",
-        "ReplicateResultProcessor.ts"
-    );
+    await copyRepositoryFile("ts", "src/modules/core/ModuleReplicator.ts", "ModuleReplicator.ts");
+    await copyRepositoryFile("ts", "src/modules/core/ReplicateResultProcessor.ts", "ReplicateResultProcessor.ts");
 
     const markdownBytes = await Deno.readFile(join(repositoryRoot, "docs/settings.md"));
     const gzipPath = join(datasetRoot, "gz", "settings.md.gz");

src/apps/cli/testdeno/run-ci-suite.ts

@@ -1,6 +1,5 @@
 const TASKS = [
     "test:settings-writeback",
-    "test:remote-administration-exit-codes",
     "test:setup-put-cat",
     "test:mirror",
     "test:daemon",

src/apps/cli/testdeno/test-benchmark-contract.ts

@@ -79,6 +79,7 @@ Deno.test("benchmark cases record scope and limitations for paper use", () => {
         );
     }
 });
+
 Deno.test("CouchDB latency proxy applies half the requested RTT in each direction", async () => {
     const backendPort = getFreePort();
     const proxyPort = getFreePort();
@@ -155,8 +156,8 @@ Deno.test("compression benchmark dataset covers representative file kinds determ
         "images/quick-setup/guide-quick-setup-first-setup-uri.png",
         "package.json",
         "manifest.json",
-        "src/serviceFeatures/replication/index.ts",
-        "src/serviceFeatures/replication/ReplicateResultProcessor.ts",
+        "src/modules/core/ModuleReplicator.ts",
+        "src/modules/core/ReplicateResultProcessor.ts",
     ];
     try {
         for (const [index, relativePath] of repositoryFiles.entries()) {

src/apps/cli/testdeno/test-p2p-replicator-replacement.ts

@@ -39,7 +39,7 @@ async function runReplacementProbe(
     };
 }
 
-Deno.test("p2p lifecycle: active-adapter replacement keeps real CLI communication on the stable service", async () => {
+Deno.test("p2p lifecycle: replacement keeps real CLI communication on the current replicator", async () => {
     const relay = Deno.env.get("RELAY") ?? "ws://localhost:4000/";
     const peersTimeout = Number(Deno.env.get("PEERS_TIMEOUT") ?? "20");
     const syncTimeout = Number(Deno.env.get("SYNC_TIMEOUT") ?? "60");
@@ -82,8 +82,11 @@ Deno.test("p2p lifecycle: active-adapter replacement keeps real CLI communicatio
         try {
             await host.waitUntilContains("P2P host is running", 20000);
             const probe = await runReplacementProbe(probeVault, probeSettings, hostPeerName, probeTimeoutMs);
-            assert(probe.code === 0, `P2P replacement probe failed\nstdout: ${probe.stdout}\nstderr: ${probe.stderr}`);
-            assertStringIncludes(probe.stdout, "[Probe] The active P2P adapter was replaced");
+            assert(
+                probe.code === 0,
+                `P2P replacement probe failed\nstdout: ${probe.stdout}\nstderr: ${probe.stderr}`
+            );
+            assertStringIncludes(probe.stdout, "[Probe] P2P replicator replaced");
 
             const syncResult = await runCli(
                 verifierVault,

src/apps/cli/testdeno/test-remote-administration-exit-codes.ts

@@ -1,77 +0,0 @@
-import { assertEquals, assertStringIncludes } from "@std/assert";
-import { TempDir } from "./helpers/temp.ts";
-import { runCli } from "./helpers/cli.ts";
-import { applyCouchdbSettings, applyP2pSettings, applyP2pTestTweaks, initSettingsFile } from "./helpers/settings.ts";
-
-async function prepareFixture(prefix: string) {
-    const workDir = await TempDir.create(prefix);
-    const settingsFile = workDir.join("settings.json");
-    const databaseDir = workDir.join("database");
-    await Deno.mkdir(databaseDir, { recursive: true });
-    await initSettingsFile(settingsFile);
-    return { workDir, settingsFile, databaseDir };
-}
-
-Deno.test("remote administration process exit policy distinguishes returned verification failure", async () => {
-    const fixture = await prepareFixture("livesync-cli-remote-admin-exit");
-    await using workDir = fixture.workDir;
-    const { settingsFile, databaseDir } = fixture;
-
-    await applyP2pSettings(
-        settingsFile,
-        "remote-admin-exit-room",
-        "remote-admin-exit-passphrase",
-        "remote-admin-exit-tests",
-        "ws://127.0.0.1:1/",
-        "~.*",
-        "none"
-    );
-    await applyP2pTestTweaks(settingsFile, "remote-admin-exit-device", "remote-admin-exit-passphrase");
-
-    const defaultFailure = await runCli(databaseDir, "--settings", settingsFile, "mark-resolved");
-    assertEquals(defaultFailure.code, 1, defaultFailure.combined);
-    assertStringIncludes(
-        defaultFailure.combined,
-        "[Verification] Remote administration is unavailable for this provider."
-    );
-    assertStringIncludes(defaultFailure.combined, "[Error] Command 'mark-resolved' failed");
-
-    const compatibilitySuccess = await runCli(
-        databaseDir,
-        "--settings",
-        settingsFile,
-        "--compat-remote-admin-exit-zero",
-        "mark-resolved"
-    );
-    assertEquals(compatibilitySuccess.code, 0, compatibilitySuccess.combined);
-    assertStringIncludes(
-        compatibilitySuccess.combined,
-        "[Verification] Remote administration is unavailable for this provider."
-    );
-    assertStringIncludes(compatibilitySuccess.combined, "[Done] Command 'mark-resolved' completed");
-});
-
-Deno.test("remote administration compatibility does not hide a thrown mutation failure", async () => {
-    const fixture = await prepareFixture("livesync-cli-remote-admin-mutation");
-    await using workDir = fixture.workDir;
-    const { settingsFile, databaseDir } = fixture;
-
-    await applyCouchdbSettings(
-        settingsFile,
-        "http://127.0.0.1:1/",
-        "unreachable-user",
-        "unreachable-password",
-        "unreachable-database"
-    );
-
-    const mutationFailure = await runCli(
-        databaseDir,
-        "--settings",
-        settingsFile,
-        "--compat-remote-admin-exit-zero",
-        "mark-resolved"
-    );
-    assertEquals(mutationFailure.code, 1, mutationFailure.combined);
-    assertStringIncludes(mutationFailure.combined, "[Command] mark-resolved");
-    assertStringIncludes(mutationFailure.combined, "[Error] Failed to start:");
-});

src/apps/webpeer/src/P2PCheckSession.ts

@@ -53,7 +53,7 @@ export class P2PCheckSession {
 
         try {
             await runtime.start();
-            await runtime.p2p.transportLifecycle.connect();
+            await runtime.currentReplicator.makeSureOpened();
         } catch (error) {
             await this.stop();
             throw error;

src/apps/webpeer/src/WebPeerRuntime.ts

@@ -3,9 +3,10 @@ import { compatGlobal } from "@vrtmrz/livesync-commonlib/compat/common/coreEnvFu
 import { EVENT_LAYOUT_READY } from "@vrtmrz/livesync-commonlib/compat/events/coreEvents";
 import type { PeerStatus } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/P2PReplicatorPaneCommon";
 import { P2PLogCollector } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/P2PLogCollector";
+import type { LiveSyncTrysteroReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/LiveSyncTrysteroReplicator";
+import type { UseP2PReplicatorResult } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/UseP2PReplicatorResult";
 import { useP2PReplicatorFeature } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/useP2PReplicatorFeature";
 import { ServiceContext, type LiveSyncEventHub } from "@vrtmrz/livesync-commonlib/context";
-import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
 import { unique } from "octagonal-wheels/collection";
 import type { SimpleStore } from "octagonal-wheels/databases/SimpleStoreBase";
 
@@ -47,7 +48,7 @@ function removeFromList(item: string, list: string): string {
 export class WebPeerRuntime {
     readonly context: ServiceContext;
     readonly services: LiveSyncBrowserServiceHub<ServiceContext>;
-    readonly p2p: P2PServiceViews;
+    readonly p2p: UseP2PReplicatorResult;
     readonly p2pLogCollector: P2PLogCollector;
     readonly paneHost: P2PReplicatorPaneHost;
 
@@ -86,6 +87,10 @@ export class WebPeerRuntime {
         return this.context.events;
     }
 
+    get currentReplicator(): LiveSyncTrysteroReplicator {
+        return this.p2p.replicator;
+    }
+
     get settings(): P2PSyncSetting {
         return this.services.setting.currentSettings();
     }
@@ -114,7 +119,9 @@ export class WebPeerRuntime {
         }
         this.services.appLifecycle.markIsReady();
         this.events.emitEvent(EVENT_LAYOUT_READY);
-        await this.services.appLifecycle.onResumed();
+        if (this.settings.P2P_AutoStart && this.settings.P2P_Enabled) {
+            compatGlobal.setTimeout(() => void this.currentReplicator.open(), 100);
+        }
         return this;
     }
 
@@ -144,12 +151,12 @@ export class WebPeerRuntime {
         this.menu = new Menu()
             .addItem((item) =>
                 item.setTitle("📥 Only fetch").onClick(async () => {
-                    await this.p2p.targetedTransfer.pullFromPeer(peer.peerId);
+                    await this.currentReplicator.replicateFrom(peer.peerId);
                 })
             )
             .addItem((item) =>
                 item.setTitle("📤 Only send").onClick(async () => {
-                    await this.p2p.targetedTransfer.requestPushToPeer(peer.peerId);
+                    await this.currentReplicator.requestSynchroniseToPeer(peer.peerId);
                 })
             )
             .addSeparator()

src/common/centralRemoteAdministration.ts

@@ -1,252 +0,0 @@
-import {
-    MILESTONE_DOCID,
-    type EntryMilestoneInfo,
-    type RemoteDBSettings,
-} from "@vrtmrz/livesync-commonlib/compat/common/types";
-import type { LiveSyncCouchDBReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
-import type { LiveSyncJournalReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator";
-import {
-    CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS,
-    CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS,
-    applyCentralRemoteAdministrationMutation,
-    milestoneSatisfiesCentralRemoteAdministration,
-    centralRemoteAdministrationVerificationFailed,
-    centralRemoteAdministrationVerified,
-    supportedCapability,
-    type MilestoneCentralRemoteAdministrationObservation,
-    type CentralRemoteAdministrationFailureReason,
-    type CentralRemoteAdministrationRequest,
-    type CentralRemoteAdministrationReplicator,
-    type CentralRemoteAdministrationResult,
-    type CentralRemoteAdministrationRunner,
-    type ReplicatorInstance,
-    type SupportedCapability,
-} from "@vrtmrz/livesync-commonlib/replication";
-
-const JOURNAL_MILESTONE_PATH = "_00000000-milestone.json";
-
-type CentralMilestoneReadResult =
-    | { readonly milestone: EntryMilestoneInfo | false | undefined }
-    | { readonly failureReason: CentralRemoteAdministrationFailureReason; readonly detail?: unknown };
-
-type PreparedCentralMilestoneReader = () => Promise<CentralMilestoneReadResult>;
-
-type CentralMilestoneReaderPreparer = (
-    replicator: CentralRemoteAdministrationReplicator,
-    setting: RemoteDBSettings
-) => PreparedCentralMilestoneReader;
-
-type CouchDBAdministrationReplicator = CentralRemoteAdministrationReplicator &
-    Pick<LiveSyncCouchDBReplicator, "connectRemoteCouchDBWithSetting" | "isMobile">;
-
-type JournalAdministrationClient = Pick<LiveSyncJournalReplicator["client"], "downloadJson">;
-
-function isCentralRemoteAdministrationReplicator(
-    replicator: ReplicatorInstance
-): replicator is CentralRemoteAdministrationReplicator {
-    return (
-        "nodeid" in replicator &&
-        typeof replicator.nodeid === "string" &&
-        "markRemoteResolved" in replicator &&
-        typeof replicator.markRemoteResolved === "function" &&
-        "markRemoteLocked" in replicator &&
-        typeof replicator.markRemoteLocked === "function"
-    );
-}
-
-async function ensureLocalNodeIdentity(
-    replicator: CentralRemoteAdministrationReplicator
-): Promise<CentralRemoteAdministrationResult | undefined> {
-    if (replicator.nodeid) {
-        return undefined;
-    }
-    if ((await replicator.initializeDatabaseForReplication()) && replicator.nodeid) {
-        return undefined;
-    }
-    return centralRemoteAdministrationVerificationFailed(
-        CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.LOCAL_IDENTITY_UNAVAILABLE
-    );
-}
-
-function observeMilestone(
-    replicator: CentralRemoteAdministrationReplicator,
-    milestone: EntryMilestoneInfo
-): MilestoneCentralRemoteAdministrationObservation {
-    return {
-        kind: CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS.MILESTONE,
-        locked: !!milestone.locked,
-        accepted: !!milestone.accepted_nodes?.includes(replicator.nodeid),
-        nodeId: replicator.nodeid,
-    };
-}
-
-function resultFromMilestone(
-    replicator: CentralRemoteAdministrationReplicator,
-    request: CentralRemoteAdministrationRequest,
-    milestone: EntryMilestoneInfo | false | undefined
-): CentralRemoteAdministrationResult {
-    if (!milestone) {
-        return centralRemoteAdministrationVerificationFailed(
-            CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.MILESTONE_NOT_FOUND
-        );
-    }
-    const observation = observeMilestone(replicator, milestone);
-    return milestoneSatisfiesCentralRemoteAdministration(request.action, observation)
-        ? centralRemoteAdministrationVerified(observation)
-        : centralRemoteAdministrationVerificationFailed(
-              CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.POSTCONDITION_MISMATCH,
-              {
-                  observation,
-              }
-          );
-}
-
-/**
- * Apply and verify the central milestone protocol without selecting a provider.
- *
- * The provider definition has already selected the reader preparer. Preparing
- * it before mutation rejects incomplete composition before a remote write and
- * binds any provider-owned client which must be used for postcondition reading.
- */
-async function runCentralRemoteAdministration(
-    replicator: CentralRemoteAdministrationReplicator,
-    setting: RemoteDBSettings,
-    request: CentralRemoteAdministrationRequest,
-    prepareMilestoneReader: CentralMilestoneReaderPreparer
-): Promise<CentralRemoteAdministrationResult> {
-    const identityFailure = await ensureLocalNodeIdentity(replicator);
-    if (identityFailure) return identityFailure;
-
-    const readMilestone = prepareMilestoneReader(replicator, setting);
-    await applyCentralRemoteAdministrationMutation(replicator, setting, request.action);
-
-    const readResult = await readMilestone();
-    if ("failureReason" in readResult) {
-        return centralRemoteAdministrationVerificationFailed(readResult.failureReason, { detail: readResult.detail });
-    }
-    return resultFromMilestone(replicator, request, readResult.milestone);
-}
-
-function requireCouchDBAdministrationOperations(
-    replicator: CentralRemoteAdministrationReplicator
-): asserts replicator is CouchDBAdministrationReplicator {
-    if (
-        !("connectRemoteCouchDBWithSetting" in replicator) ||
-        typeof replicator.connectRemoteCouchDBWithSetting !== "function" ||
-        !("isMobile" in replicator) ||
-        typeof replicator.isMobile !== "function"
-    ) {
-        throw new Error("The configured CouchDB administration adapter does not provide milestone access.");
-    }
-}
-
-function prepareCouchDBMilestoneReader(
-    replicator: CentralRemoteAdministrationReplicator,
-    setting: RemoteDBSettings
-): PreparedCentralMilestoneReader {
-    requireCouchDBAdministrationOperations(replicator);
-
-    return async () => {
-        let connection: Awaited<ReturnType<CouchDBAdministrationReplicator["connectRemoteCouchDBWithSetting"]>>;
-        try {
-            connection = await replicator.connectRemoteCouchDBWithSetting(setting, replicator.isMobile(), true);
-        } catch (error) {
-            return { failureReason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.CONNECTION_FAILED, detail: error };
-        }
-        if (typeof connection === "string") {
-            return {
-                failureReason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.CONNECTION_FAILED,
-                detail: connection,
-            };
-        }
-
-        let milestone: EntryMilestoneInfo | undefined;
-        let observationError: unknown;
-        try {
-            milestone = await connection.db.get<EntryMilestoneInfo>(MILESTONE_DOCID);
-        } catch (error) {
-            observationError = error;
-        }
-        try {
-            await connection.close();
-        } catch (error) {
-            observationError ??= error;
-        }
-        if (observationError !== undefined) {
-            return {
-                failureReason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.MILESTONE_READ_FAILED,
-                detail: observationError,
-            };
-        }
-        return { milestone };
-    };
-}
-
-function isJournalAdministrationClient(client: unknown): client is JournalAdministrationClient {
-    return (
-        typeof client === "object" &&
-        client !== null &&
-        "downloadJson" in client &&
-        typeof client.downloadJson === "function"
-    );
-}
-
-function requireJournalAdministrationClient(
-    replicator: CentralRemoteAdministrationReplicator
-): JournalAdministrationClient {
-    if (!("client" in replicator) || !isJournalAdministrationClient(replicator.client)) {
-        throw new Error("The configured Object Storage administration adapter does not provide milestone access.");
-    }
-    return replicator.client;
-}
-
-function prepareObjectStorageMilestoneReader(
-    replicator: CentralRemoteAdministrationReplicator
-): PreparedCentralMilestoneReader {
-    const client = requireJournalAdministrationClient(replicator);
-
-    return async () => {
-        try {
-            return { milestone: await client.downloadJson<EntryMilestoneInfo>(JOURNAL_MILESTONE_PATH) };
-        } catch (error) {
-            return {
-                failureReason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.MILESTONE_READ_FAILED,
-                detail: error,
-            };
-        }
-    };
-}
-
-const runCouchDBCentralRemoteAdministration: CentralRemoteAdministrationRunner = async (
-    replicator,
-    setting,
-    request
-) => {
-    if (!isCentralRemoteAdministrationReplicator(replicator)) {
-        return centralRemoteAdministrationVerificationFailed(
-            CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.CAPABILITY_NOT_APPLICABLE
-        );
-    }
-    return await runCentralRemoteAdministration(replicator, setting, request, prepareCouchDBMilestoneReader);
-};
-
-const runObjectStorageCentralRemoteAdministration: CentralRemoteAdministrationRunner = async (
-    replicator,
-    setting,
-    request
-) => {
-    if (!isCentralRemoteAdministrationReplicator(replicator)) {
-        return centralRemoteAdministrationVerificationFailed(
-            CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.CAPABILITY_NOT_APPLICABLE
-        );
-    }
-    return await runCentralRemoteAdministration(replicator, setting, request, prepareObjectStorageMilestoneReader);
-};
-
-/** CouchDB mutation and milestone postcondition verification capability. */
-export const COUCHDB_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY: SupportedCapability<CentralRemoteAdministrationRunner> =
-    supportedCapability(runCouchDBCentralRemoteAdministration);
-
-/** Object Storage mutation and milestone postcondition verification capability. */
-export const OBJECT_STORAGE_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY: SupportedCapability<CentralRemoteAdministrationRunner> =
-    supportedCapability(runObjectStorageCentralRemoteAdministration);

src/common/centralRemoteAdministration.unit.spec.ts

@@ -1,199 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { DEFAULT_SETTINGS, REMOTE_COUCHDB, REMOTE_MINIO } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import {
-    CENTRAL_REMOTE_ADMINISTRATION_ACTIONS,
-    CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS,
-    CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS,
-    CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES,
-} from "@vrtmrz/livesync-commonlib/replication";
-import {
-    COUCHDB_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY,
-    OBJECT_STORAGE_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY,
-} from "./centralRemoteAdministration";
-
-describe("central remote administration capabilities", () => {
-    it("mutates CouchDB, verifies the requested postcondition, and closes only the owned connection", async () => {
-        const rawDatabaseClose = vi.fn(async () => undefined);
-        const close = vi.fn(async () => undefined);
-        const database = {
-            get: vi.fn(async () => ({ locked: true, accepted_nodes: ["node-1"] })),
-            close: rawDatabaseClose,
-        };
-        const replicator = {
-            nodeid: "node-1",
-            initializeDatabaseForReplication: vi.fn(async () => true),
-            isMobile: vi.fn(() => false),
-            markRemoteLocked: vi.fn(async () => undefined),
-            markRemoteResolved: vi.fn(async () => undefined),
-            connectRemoteCouchDBWithSetting: vi.fn(async () => ({ db: database, close })),
-        };
-        const setting = { ...DEFAULT_SETTINGS, remoteType: REMOTE_COUCHDB };
-        const capability = COUCHDB_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY;
-
-        await expect(
-            capability.run(replicator as never, setting, { action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.LOCK })
-        ).resolves.toEqual({
-            status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFIED,
-            observation: {
-                kind: CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS.MILESTONE,
-                locked: true,
-                accepted: true,
-                nodeId: "node-1",
-            },
-        });
-
-        expect(replicator.markRemoteLocked).toHaveBeenCalledWith(setting, true, false);
-        expect(close).toHaveBeenCalledOnce();
-        expect(rawDatabaseClose).not.toHaveBeenCalled();
-    });
-
-    it("returns a typed CouchDB failure when the observed milestone does not satisfy the action", async () => {
-        const close = vi.fn(async () => undefined);
-        const replicator = {
-            nodeid: "node-1",
-            initializeDatabaseForReplication: vi.fn(async () => true),
-            isMobile: vi.fn(() => false),
-            markRemoteLocked: vi.fn(async () => undefined),
-            markRemoteResolved: vi.fn(async () => undefined),
-            connectRemoteCouchDBWithSetting: vi.fn(async () => ({
-                db: { get: vi.fn(async () => ({ locked: false, accepted_nodes: ["node-1"] })) },
-                close,
-            })),
-        };
-        const capability = COUCHDB_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY;
-
-        const result = await capability.run(
-            replicator as never,
-            { ...DEFAULT_SETTINGS, remoteType: REMOTE_COUCHDB },
-            {
-                action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.LOCK,
-            }
-        );
-
-        expect(result).toMatchObject({
-            status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFICATION_FAILED,
-            reason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.POSTCONDITION_MISMATCH,
-            observation: { kind: CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS.MILESTONE, locked: false },
-        });
-        expect(close).toHaveBeenCalledOnce();
-    });
-
-    it("does not mutate when initialisation succeeds without publishing a local node identity", async () => {
-        const replicator = {
-            nodeid: "",
-            initializeDatabaseForReplication: vi.fn(async () => true),
-            isMobile: vi.fn(() => false),
-            markRemoteLocked: vi.fn(async () => undefined),
-            markRemoteResolved: vi.fn(async () => undefined),
-            connectRemoteCouchDBWithSetting: vi.fn(async () => "must not connect"),
-        };
-        const capability = COUCHDB_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY;
-
-        await expect(
-            capability.run(
-                replicator as never,
-                { ...DEFAULT_SETTINGS, remoteType: REMOTE_COUCHDB },
-                { action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.MARK_RESOLVED }
-            )
-        ).resolves.toEqual({
-            status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFICATION_FAILED,
-            reason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.LOCAL_IDENTITY_UNAVAILABLE,
-        });
-        expect(replicator.markRemoteResolved).not.toHaveBeenCalled();
-        expect(replicator.connectRemoteCouchDBWithSetting).not.toHaveBeenCalled();
-    });
-
-    it("allows a CouchDB mutation exception to reject before verification", async () => {
-        const failure = new Error("write failed");
-        const replicator = {
-            nodeid: "node-1",
-            initializeDatabaseForReplication: vi.fn(async () => true),
-            isMobile: vi.fn(() => false),
-            markRemoteLocked: vi.fn(async () => {
-                throw failure;
-            }),
-            markRemoteResolved: vi.fn(async () => undefined),
-            connectRemoteCouchDBWithSetting: vi.fn(),
-        };
-        const capability = COUCHDB_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY;
-
-        await expect(
-            capability.run(
-                replicator as never,
-                { ...DEFAULT_SETTINGS, remoteType: REMOTE_COUCHDB },
-                {
-                    action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.UNLOCK,
-                }
-            )
-        ).rejects.toBe(failure);
-        expect(replicator.connectRemoteCouchDBWithSetting).not.toHaveBeenCalled();
-    });
-
-    it("mutates Object Storage and verifies its milestone postcondition", async () => {
-        const downloadJson = vi.fn(async () => ({ locked: false, accepted_nodes: ["node-1"] }));
-        const replicator = {
-            nodeid: "node-1",
-            initializeDatabaseForReplication: vi.fn(async () => true),
-            markRemoteLocked: vi.fn(async () => undefined),
-            markRemoteResolved: vi.fn(async () => undefined),
-            client: { downloadJson },
-        };
-        const setting = { ...DEFAULT_SETTINGS, remoteType: REMOTE_MINIO };
-        const capability = OBJECT_STORAGE_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY;
-
-        await expect(
-            capability.run(replicator as never, setting, {
-                action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.MARK_RESOLVED,
-            })
-        ).resolves.toEqual({
-            status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFIED,
-            observation: {
-                kind: CENTRAL_REMOTE_ADMINISTRATION_OBSERVATION_KINDS.MILESTONE,
-                locked: false,
-                accepted: true,
-                nodeId: "node-1",
-            },
-        });
-        expect(replicator.markRemoteResolved).toHaveBeenCalledWith(setting);
-        expect(downloadJson).toHaveBeenCalledWith("_00000000-milestone.json");
-    });
-
-    it("rejects an incomplete CouchDB milestone adapter before mutation", async () => {
-        const markRemoteLocked = vi.fn(async () => undefined);
-        const replicator = {
-            nodeid: "node-1",
-            initializeDatabaseForReplication: vi.fn(async () => true),
-            markRemoteLocked,
-            markRemoteResolved: vi.fn(async () => undefined),
-        };
-
-        await expect(
-            COUCHDB_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY.run(
-                replicator as never,
-                { ...DEFAULT_SETTINGS, remoteType: REMOTE_COUCHDB },
-                { action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.LOCK }
-            )
-        ).rejects.toThrow("The configured CouchDB administration adapter does not provide milestone access.");
-        expect(markRemoteLocked).not.toHaveBeenCalled();
-    });
-
-    it("rejects an incomplete Object Storage milestone adapter before mutation", async () => {
-        const markRemoteResolved = vi.fn(async () => undefined);
-        const replicator = {
-            nodeid: "node-1",
-            initializeDatabaseForReplication: vi.fn(async () => true),
-            markRemoteLocked: vi.fn(async () => undefined),
-            markRemoteResolved,
-            client: {},
-        };
-
-        await expect(
-            OBJECT_STORAGE_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY.run(
-                replicator as never,
-                { ...DEFAULT_SETTINGS, remoteType: REMOTE_MINIO },
-                { action: CENTRAL_REMOTE_ADMINISTRATION_ACTIONS.MARK_RESOLVED }
-            )
-        ).rejects.toThrow("The configured Object Storage administration adapter does not provide milestone access.");
-        expect(markRemoteResolved).not.toHaveBeenCalled();
-    });
-});

src/common/databaseCompatibility.unit.spec.ts

@@ -177,7 +177,6 @@ describe("packaged Commonlib compatibility gate", () => {
             databaseService: {},
             fileProcessingService: { commitPendingFileEvents: vi.fn().mockResolvedValue(true) },
             replicatorService: {
-                acquireActiveReplicatorContext: vi.fn().mockResolvedValue(undefined),
                 getActiveReplicator: () => ({ openReplication }),
                 runFiniteReplicationActivity,
             },

src/common/messages/combinedMessages.prod.ts

@@ -9791,10 +9791,6 @@ export const allMessages: Readonly<Record<string, Readonly<Record<string, string
             zh: "仅供测试 - 通过同步文件的较新副本来解决文件冲突,这可能会覆盖修改过的文件。请注意 ",
             "zh-tw": "僅供測試 —— 透過同步較新的檔案版本解決衝突，這可能會覆寫已修改的檔案，請注意。",
         },
-    "The connection test cannot add a signalling relay while P2P is active. Use the active relay settings, or disconnect P2P before testing.":
-        {
-            def: "The connection test cannot add a signalling relay while P2P is active. Use the active relay settings, or disconnect P2P before testing.",
-        },
     "The connection to the server has been configured successfully. As the next step,": {
         def: "The connection to the server has been configured successfully. As the next step,",
         es: "La conexión con el servidor se ha configurado correctamente. Como paso siguiente,",

src/common/messagesJson/en.json

@@ -1062,7 +1062,6 @@
     "Target patterns": "Target patterns",
     "Test Settings and Continue": "Test Settings and Continue",
     "Testing only - Resolve file conflicts by syncing newer copies of the file, this can overwrite modified files. Be Warned.": "Testing only - Resolve file conflicts by syncing newer copies of the file, this can overwrite modified files. Be Warned.",
-    "The connection test cannot add a signalling relay while P2P is active. Use the active relay settings, or disconnect P2P before testing.": "The connection test cannot add a signalling relay while P2P is active. Use the active relay settings, or disconnect P2P before testing.",
     "The connection to the server has been configured successfully. As the next step,": "The connection to the server has been configured successfully. As the next step,",
     "The delay for consecutive on-demand fetches": "The delay for consecutive on-demand fetches",
     "The files in this Vault are almost identical to the server's.": "The files in this Vault are almost identical to the server's.",

src/common/messagesYAML/en.yaml

@@ -362,7 +362,6 @@ Export: Export
 "Failed to connect to the server: ${reason}": "Failed to connect to the server: ${reason}"
 Failed to connect to the server. Please check your settings.: Failed to connect to the server. Please check your settings.
 "Failed to connect to the signalling relay: ${reason}": "Failed to connect to the signalling relay: ${reason}"
-The connection test cannot add a signalling relay while P2P is active. Use the active relay settings, or disconnect P2P before testing.: The connection test cannot add a signalling relay while P2P is active. Use the active relay settings, or disconnect P2P before testing.
 Failed to create replicator instance.: Failed to create replicator instance.
 Failed to parse Setup-URI.: Failed to parse Setup-URI.
 "Failed:": "Failed:"

src/common/ownedRemoteResource.ts

@@ -1,18 +0,0 @@
-/**
- * Run a finite operation with a flow-owned remote resource and release it
- * after either success or failure.
- *
- * Resource implementations make `dispose()` idempotent. This helper makes the
- * caller's ownership boundary explicit and prevents finite flows from leaking
- * a provider-owned resource when their operation rejects.
- */
-export async function withOwnedRemoteResource<TResource extends { dispose(): Promise<void> }, TResult>(
-    resource: TResource,
-    operation: (ownedResource: TResource) => Promise<TResult>
-): Promise<TResult> {
-    try {
-        return await operation(resource);
-    } finally {
-        await resource.dispose();
-    }
-}

src/common/ownedRemoteResource.unit.spec.ts

@@ -1,28 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { withOwnedRemoteResource } from "./ownedRemoteResource";
-
-describe("flow-owned remote resources", () => {
-    it("disposes a resource after a successful finite operation", async () => {
-        const dispose = vi.fn(async () => undefined);
-        const resource = { dispose };
-
-        await expect(
-            withOwnedRemoteResource(resource, async (owned) => (owned === resource ? "done" : "wrong"))
-        ).resolves.toBe("done");
-
-        expect(dispose).toHaveBeenCalledOnce();
-    });
-
-    it("disposes a resource when the finite operation rejects", async () => {
-        const dispose = vi.fn(async () => undefined);
-        const error = new Error("resource operation failed");
-
-        await expect(
-            withOwnedRemoteResource({ dispose }, async () => {
-                throw error;
-            })
-        ).rejects.toBe(error);
-
-        expect(dispose).toHaveBeenCalledOnce();
-    });
-});

src/common/replicatorConfigurationIdentity.ts

@@ -1,91 +0,0 @@
-import type { RemoteDBSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
-
-type EndpointProjection = readonly [kind: "url" | "invalid-url", value: string];
-
-function projectEndpoint(value: string): EndpointProjection {
-    try {
-        const endpoint = new URL(value);
-        endpoint.hash = "";
-        endpoint.searchParams.sort();
-        while (endpoint.pathname.length > 1 && endpoint.pathname.endsWith("/")) {
-            endpoint.pathname = endpoint.pathname.slice(0, -1);
-        }
-        return ["url", endpoint.toString()];
-    } catch {
-        return ["invalid-url", value];
-    }
-}
-
-function projectHeaders(value: string): readonly (readonly [name: string, value: string])[] {
-    const headers = new Map<string, string>();
-    for (const line of value.split("\n")) {
-        const [name, headerValue] = line.split(":", 2).map((part) => part.trim());
-        if (name && headerValue) {
-            headers.set(name, headerValue);
-        }
-    }
-    return [...headers.entries()].sort(([leftName, leftValue], [rightName, rightValue]) => {
-        const nameOrder = leftName.localeCompare(rightName);
-        return nameOrder || leftValue.localeCompare(rightValue);
-    });
-}
-
-function projectRemoteSecurity(settings: RemoteDBSettings) {
-    return settings.encrypt
-        ? ([
-              "encrypted",
-              settings.passphrase,
-              settings.useDynamicIterationCount,
-              settings.E2EEAlgorithm,
-              settings.permitEmptyPassphrase,
-          ] as const)
-        : (["plain"] as const);
-}
-
-/**
- * Project the effective CouchDB connection settings to a private comparison identity.
- * The returned value can contain credentials and must not be logged, persisted, or displayed.
- */
-export function getCouchDBReplicatorConfigurationIdentity(settings: RemoteDBSettings): string {
-    const authentication = settings.useJWT
-        ? ([
-              "jwt",
-              settings.jwtAlgorithm,
-              settings.jwtKey,
-              settings.jwtKid,
-              settings.jwtSub,
-              settings.jwtExpDuration,
-          ] as const)
-        : (["basic", settings.couchDB_USER, settings.couchDB_PASSWORD] as const);
-    return JSON.stringify([
-        "couchdb",
-        projectEndpoint(settings.couchDB_URI),
-        settings.couchDB_DBNAME,
-        authentication,
-        projectHeaders(settings.couchDB_CustomHeaders),
-        settings.useRequestAPI,
-        settings.disableRequestURI,
-        projectRemoteSecurity(settings),
-        settings.enableCompression,
-    ]);
-}
-
-/**
- * Project the effective Object Storage connection settings to a private comparison identity.
- * The returned value can contain credentials and must not be logged, persisted, or displayed.
- */
-export function getObjectStorageReplicatorConfigurationIdentity(settings: RemoteDBSettings): string {
-    return JSON.stringify([
-        "s3",
-        projectEndpoint(settings.endpoint),
-        settings.bucket,
-        settings.bucketPrefix,
-        settings.region,
-        settings.accessKey,
-        settings.secretKey,
-        settings.forcePathStyle,
-        settings.useCustomRequestHandler,
-        projectHeaders(settings.bucketCustomHeaders),
-        projectRemoteSecurity(settings),
-    ]);
-}

src/common/replicatorConfigurationIdentity.unit.spec.ts

@@ -1,174 +0,0 @@
-import { describe, expect, it } from "vitest";
-import type { ObsidianLiveSyncSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import { createNewVaultSettings } from "@vrtmrz/livesync-commonlib/settings";
-import {
-    getCouchDBReplicatorConfigurationIdentity,
-    getObjectStorageReplicatorConfigurationIdentity,
-} from "./replicatorConfigurationIdentity";
-
-describe("active Replicator configuration identity", () => {
-    function configuredSettings(overrides: Partial<ObsidianLiveSyncSettings> = {}): ObsidianLiveSyncSettings {
-        return Object.assign(createNewVaultSettings(), {
-            activeConfigurationId: "profile-a",
-            couchDB_URI: "https://couch.example.test/base",
-            couchDB_USER: "alice",
-            couchDB_PASSWORD: "secret-a",
-            couchDB_DBNAME: "vault",
-            couchDB_CustomHeaders: "X-Second: two\nX-First: one",
-            endpoint: "https://objects.example.test/base",
-            accessKey: "alice",
-            secretKey: "secret-a",
-            bucket: "vault",
-            bucketPrefix: "notes/",
-            region: "auto",
-            bucketCustomHeaders: "X-Second: two\nX-First: one",
-            encrypt: true,
-            passphrase: "encryption-a",
-            useDynamicIterationCount: false,
-            permitEmptyPassphrase: false,
-            enableCompression: false,
-            ...overrides,
-        });
-    }
-
-    it.each([
-        ["couchDB_URI", "https://other.example.test/base"],
-        ["couchDB_DBNAME", "other-vault"],
-        ["couchDB_USER", "bob"],
-        ["couchDB_PASSWORD", "secret-b"],
-        ["couchDB_CustomHeaders", "X-First: changed"],
-        ["useRequestAPI", true],
-        ["disableRequestURI", true],
-        ["encrypt", false],
-        ["passphrase", "encryption-b"],
-        ["useDynamicIterationCount", true],
-        ["E2EEAlgorithm", ""],
-        ["permitEmptyPassphrase", true],
-        ["enableCompression", true],
-    ] satisfies Array<[keyof ObsidianLiveSyncSettings, ObsidianLiveSyncSettings[keyof ObsidianLiveSyncSettings]]>)(
-        "detects a CouchDB %s change",
-        (key, value) => {
-            const settings = configuredSettings();
-            expect(getCouchDBReplicatorConfigurationIdentity({ ...settings, [key]: value })).not.toBe(
-                getCouchDBReplicatorConfigurationIdentity(settings)
-            );
-        }
-    );
-
-    it("ignores persisted central profile identity when the effective connection settings match", () => {
-        const settings = configuredSettings({ activeConfigurationId: "profile-a" });
-        const otherProfile = { ...settings, activeConfigurationId: "profile-b" };
-
-        expect(getCouchDBReplicatorConfigurationIdentity(otherProfile)).toBe(
-            getCouchDBReplicatorConfigurationIdentity(settings)
-        );
-        expect(getObjectStorageReplicatorConfigurationIdentity(otherProfile)).toBe(
-            getObjectStorageReplicatorConfigurationIdentity(settings)
-        );
-    });
-
-    it("projects only the active CouchDB authentication mode", () => {
-        const basic = configuredSettings({ useJWT: false, jwtKey: "inactive-a" });
-        expect(getCouchDBReplicatorConfigurationIdentity({ ...basic, jwtKey: "inactive-b" })).toBe(
-            getCouchDBReplicatorConfigurationIdentity(basic)
-        );
-
-        const jwt = configuredSettings({
-            useJWT: true,
-            jwtAlgorithm: "HS256",
-            jwtKey: "jwt-a",
-            jwtKid: "kid-a",
-            jwtSub: "subject-a",
-            jwtExpDuration: 5,
-        });
-        expect(getCouchDBReplicatorConfigurationIdentity({ ...jwt, couchDB_PASSWORD: "inactive" })).toBe(
-            getCouchDBReplicatorConfigurationIdentity(jwt)
-        );
-        expect(getCouchDBReplicatorConfigurationIdentity({ ...jwt, jwtKey: "jwt-b" })).not.toBe(
-            getCouchDBReplicatorConfigurationIdentity(jwt)
-        );
-    });
-
-    it.each([
-        ["endpoint", "https://other.example.test/base"],
-        ["bucket", "other-vault"],
-        ["bucketPrefix", "archive/"],
-        ["region", "eu-west-1"],
-        ["accessKey", "bob"],
-        ["secretKey", "secret-b"],
-        ["forcePathStyle", false],
-        ["useCustomRequestHandler", true],
-        ["bucketCustomHeaders", "X-First: changed"],
-        ["encrypt", false],
-        ["passphrase", "encryption-b"],
-        ["useDynamicIterationCount", true],
-        ["E2EEAlgorithm", ""],
-        ["permitEmptyPassphrase", true],
-    ] satisfies Array<[keyof ObsidianLiveSyncSettings, ObsidianLiveSyncSettings[keyof ObsidianLiveSyncSettings]]>)(
-        "detects an Object Storage %s change",
-        (key, value) => {
-            const settings = configuredSettings();
-            expect(getObjectStorageReplicatorConfigurationIdentity({ ...settings, [key]: value })).not.toBe(
-                getObjectStorageReplicatorConfigurationIdentity(settings)
-            );
-        }
-    );
-
-    it("normalises endpoint and header representation without using the setup URI grammar", () => {
-        const settings = configuredSettings();
-        const couchIdentity = getCouchDBReplicatorConfigurationIdentity(settings);
-        const objectStorageIdentity = getObjectStorageReplicatorConfigurationIdentity(settings);
-
-        expect(
-            getCouchDBReplicatorConfigurationIdentity({
-                ...settings,
-                couchDB_URI: "https://couch.example.test:443/base/",
-                couchDB_CustomHeaders: "X-First: one\nX-Second: two",
-            })
-        ).toBe(couchIdentity);
-        expect(
-            getObjectStorageReplicatorConfigurationIdentity({
-                ...settings,
-                endpoint: "https://objects.example.test:443/base/",
-                bucketCustomHeaders: "X-First: one\nX-Second: two",
-            })
-        ).toBe(objectStorageIdentity);
-    });
-
-    it("ignores inactive remote-security credentials", () => {
-        const settings = configuredSettings({ encrypt: false, passphrase: "inactive-a" });
-
-        expect(
-            getCouchDBReplicatorConfigurationIdentity({
-                ...settings,
-                passphrase: "inactive-b",
-                useDynamicIterationCount: !settings.useDynamicIterationCount,
-                E2EEAlgorithm: "",
-                permitEmptyPassphrase: !settings.permitEmptyPassphrase,
-            })
-        ).toBe(getCouchDBReplicatorConfigurationIdentity(settings));
-        expect(
-            getObjectStorageReplicatorConfigurationIdentity({
-                ...settings,
-                passphrase: "inactive-b",
-                useDynamicIterationCount: !settings.useDynamicIterationCount,
-                E2EEAlgorithm: "",
-                permitEmptyPassphrase: !settings.permitEmptyPassphrase,
-            })
-        ).toBe(getObjectStorageReplicatorConfigurationIdentity(settings));
-    });
-
-    it("keeps malformed endpoints deterministic and scoped", () => {
-        const settings = configuredSettings({ couchDB_URI: "not a URL", endpoint: "also not a URL" });
-
-        expect(() => getCouchDBReplicatorConfigurationIdentity(settings)).not.toThrow();
-        expect(() => getObjectStorageReplicatorConfigurationIdentity(settings)).not.toThrow();
-        expect(
-            getCouchDBReplicatorConfigurationIdentity({ ...settings, couchDB_URI: "different invalid URL" })
-        ).not.toBe(getCouchDBReplicatorConfigurationIdentity(settings));
-        const unrelatedPluginChange = { ...settings, displayLanguage: "ja" };
-        expect(getObjectStorageReplicatorConfigurationIdentity(unrelatedPluginChange)).toBe(
-            getObjectStorageReplicatorConfigurationIdentity(settings)
-        );
-    });
-});

src/common/replicatorProviders.ts

@@ -1,154 +0,0 @@
-import { REMOTE_COUCHDB, REMOTE_MINIO, type RemoteDBSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import {
-    CAPABILITY_NOT_APPLICABLE,
-    CENTRAL_REMOTE_REPLICATION_READINESS,
-    NO_INTERACTION,
-    REMOTE_RESOURCE_KINDS,
-    defineReplicatorProviderDefinitions,
-    supportedOpenReplicationContinuous,
-    replicationBlocked,
-    replicationFailed,
-    supportedStopActiveTransfer,
-    supportedCapability,
-    type ReplicatorProviderDefinitionMap,
-    type ReplicationOutcome,
-    type ReplicatorInstance,
-    type UserInitiatedOneShotRunner,
-    type UnattendedOneShotRunner,
-} from "@vrtmrz/livesync-commonlib/replication";
-import {
-    LiveSyncCouchDBReplicator,
-    type LiveSyncCouchDBReplicatorEnv,
-} from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
-import { LiveSyncJournalReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator";
-import {
-    getCouchDBReplicatorConfigurationIdentity,
-    getObjectStorageReplicatorConfigurationIdentity,
-} from "./replicatorConfigurationIdentity";
-import {
-    createCouchDBConnectionProbeFactory,
-    createCouchDBPreferredTweakProbeFactory,
-    createCouchDBSecuritySeedResourceFactory,
-    createCouchDBSynchronisationInformationResourceFactory,
-    createObjectStorageConnectionProbeFactory,
-    createObjectStoragePreferredTweakProbeFactory,
-    createObjectStorageSecuritySeedResourceFactory,
-} from "./replicatorResources";
-import {
-    COUCHDB_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY,
-    OBJECT_STORAGE_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY,
-} from "./centralRemoteAdministration";
-
-/** Host environment sufficient to construct every current central provider. */
-export type CentralReplicatorProviderHost = LiveSyncCouchDBReplicatorEnv;
-
-/** Minimal operation required by both central one-shot adapters. */
-interface OneShotOutcomeReplicator extends ReplicatorInstance {
-    openOneShotReplicationWithOutcome(setting: RemoteDBSettings, showResult: boolean): Promise<ReplicationOutcome>;
-}
-
-function isOneShotOutcomeReplicator(instance: ReplicatorInstance): instance is OneShotOutcomeReplicator {
-    return (
-        "openOneShotReplicationWithOutcome" in instance &&
-        typeof instance.openOneShotReplicationWithOutcome === "function"
-    );
-}
-
-async function runOneShotWithOutcome(
-    instance: ReplicatorInstance,
-    setting: RemoteDBSettings,
-    showResult: boolean
-): Promise<ReplicationOutcome> {
-    if (!isOneShotOutcomeReplicator(instance)) {
-        return replicationFailed(new Error("The configured provider does not implement one-shot replication."));
-    }
-    return await instance.openOneShotReplicationWithOutcome(setting, showResult);
-}
-
-const couchDBUserInitiatedOneShot: UserInitiatedOneShotRunner = async (instance, setting, request) => {
-    return await runOneShotWithOutcome(
-        instance,
-        setting,
-        request.interaction.kind === "permitted" && request.interaction.permissions.failureRecovery
-    );
-};
-
-const couchDBUnattendedOneShot: UnattendedOneShotRunner = async (instance, setting, request) => {
-    if (request.interaction.kind !== NO_INTERACTION.kind) return replicationBlocked("interaction-required");
-    return await runOneShotWithOutcome(instance, setting, false);
-};
-
-const objectStorageUserInitiatedOneShot: UserInitiatedOneShotRunner = async (instance, setting, request) => {
-    return await runOneShotWithOutcome(
-        instance,
-        setting,
-        request.interaction.kind === "permitted" && request.interaction.permissions.failureRecovery
-    );
-};
-
-const objectStorageUnattendedOneShot: UnattendedOneShotRunner = async (instance, setting, request) => {
-    if (request.interaction.kind !== NO_INTERACTION.kind) return replicationBlocked("interaction-required");
-    return await runOneShotWithOutcome(instance, setting, false);
-};
-
-/** Build the complete central-remote provider policy for one LiveSync host. */
-export function createCentralReplicatorProviderDefinitions(
-    host: CentralReplicatorProviderHost
-): ReplicatorProviderDefinitionMap {
-    return defineReplicatorProviderDefinitions([REMOTE_COUCHDB, REMOTE_MINIO] as const, {
-        [REMOTE_COUCHDB]: {
-            kind: REMOTE_COUCHDB,
-            diagnosticName: "CouchDB",
-            readiness: CENTRAL_REMOTE_REPLICATION_READINESS,
-            isConfigured: (settings) =>
-                settings.remoteType === REMOTE_COUCHDB &&
-                !!settings.couchDB_URI?.trim() &&
-                !!settings.couchDB_DBNAME?.trim(),
-            configurationIdentity: getCouchDBReplicatorConfigurationIdentity,
-            create: () => Promise.resolve(new LiveSyncCouchDBReplicator(host)),
-            remoteResources: {
-                [REMOTE_RESOURCE_KINDS.CONNECTION]: supportedCapability(createCouchDBConnectionProbeFactory(host)),
-                [REMOTE_RESOURCE_KINDS.PREFERRED_TWEAK]: supportedCapability(
-                    createCouchDBPreferredTweakProbeFactory(host)
-                ),
-                [REMOTE_RESOURCE_KINDS.SECURITY_SEED]: supportedCapability(
-                    createCouchDBSecuritySeedResourceFactory(host)
-                ),
-                [REMOTE_RESOURCE_KINDS.SYNCHRONISATION_INFORMATION]: supportedCapability(
-                    createCouchDBSynchronisationInformationResourceFactory(host)
-                ),
-            },
-            centralRemoteAdministration: COUCHDB_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY,
-            userInitiatedOneShot: supportedCapability(couchDBUserInitiatedOneShot),
-            unattendedOneShot: supportedCapability(couchDBUnattendedOneShot),
-            continuous: supportedOpenReplicationContinuous(),
-            stopActiveTransfer: supportedStopActiveTransfer(),
-        },
-        [REMOTE_MINIO]: {
-            kind: REMOTE_MINIO,
-            diagnosticName: "Object Storage",
-            readiness: CENTRAL_REMOTE_REPLICATION_READINESS,
-            isConfigured: (settings) =>
-                settings.remoteType === REMOTE_MINIO && !!settings.endpoint?.trim() && !!settings.bucket?.trim(),
-            configurationIdentity: getObjectStorageReplicatorConfigurationIdentity,
-            create: () => Promise.resolve(new LiveSyncJournalReplicator(host)),
-            remoteResources: {
-                [REMOTE_RESOURCE_KINDS.CONNECTION]: supportedCapability(
-                    createObjectStorageConnectionProbeFactory(host)
-                ),
-                [REMOTE_RESOURCE_KINDS.PREFERRED_TWEAK]: supportedCapability(
-                    createObjectStoragePreferredTweakProbeFactory(host)
-                ),
-                [REMOTE_RESOURCE_KINDS.SECURITY_SEED]: supportedCapability(
-                    createObjectStorageSecuritySeedResourceFactory(host)
-                ),
-                [REMOTE_RESOURCE_KINDS.SYNCHRONISATION_INFORMATION]: CAPABILITY_NOT_APPLICABLE,
-            },
-            centralRemoteAdministration: OBJECT_STORAGE_CENTRAL_REMOTE_ADMINISTRATION_CAPABILITY,
-            userInitiatedOneShot: supportedCapability(objectStorageUserInitiatedOneShot),
-            unattendedOneShot: supportedCapability(objectStorageUnattendedOneShot),
-            continuous: CAPABILITY_NOT_APPLICABLE,
-            stopActiveTransfer: supportedStopActiveTransfer(),
-        },
-    });
-}

src/common/replicatorProviders.unit.spec.ts

@@ -1,210 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { REMOTE_COUCHDB, REMOTE_MINIO } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import { createNewVaultSettings } from "@vrtmrz/livesync-commonlib/settings";
-import {
-    CAPABILITY_SUPPORT_KINDS,
-    NO_INTERACTION,
-    REPLICATION_COMPLETED,
-    REMOTE_RESOURCE_KINDS,
-    USER_INITIATED_REPLICATION_AUTHORITY,
-} from "@vrtmrz/livesync-commonlib/replication";
-
-const constructorMocks = vi.hoisted(() => ({
-    couchDB: vi.fn(),
-    couchDBOneShot: vi.fn(async (..._args: unknown[]) => REPLICATION_COMPLETED),
-    objectStorage: vi.fn(),
-    objectStorageOneShot: vi.fn(async (..._args: unknown[]) => REPLICATION_COMPLETED),
-}));
-
-vi.mock("@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator", () => ({
-    LiveSyncCouchDBReplicator: class {
-        constructor(host: unknown) {
-            constructorMocks.couchDB(host);
-        }
-        openOneShotReplicationWithOutcome(...args: unknown[]) {
-            return constructorMocks.couchDBOneShot(...args);
-        }
-    },
-}));
-vi.mock("@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator", () => ({
-    LiveSyncJournalReplicator: class {
-        constructor(host: unknown) {
-            constructorMocks.objectStorage(host);
-        }
-        openOneShotReplicationWithOutcome(...args: unknown[]) {
-            return constructorMocks.objectStorageOneShot(...args);
-        }
-    },
-}));
-
-import { createCentralReplicatorProviderDefinitions } from "./replicatorProviders";
-
-describe("central Replicator provider definitions", () => {
-    it("keeps the retained remote-resource catalogue bounded", () => {
-        expect
-            .soft(Object.values(REMOTE_RESOURCE_KINDS).sort())
-            .toEqual(["connection", "preferred-tweak", "security-seed", "synchronisation-information"].sort());
-    });
-
-    it("composes CouchDB and Object Storage policies outside LiveSyncBaseCore", async () => {
-        const host = {} as Parameters<typeof createCentralReplicatorProviderDefinitions>[0];
-        const definitions = createCentralReplicatorProviderDefinitions(host);
-        const couchDB = definitions.get(REMOTE_COUCHDB)!;
-        const objectStorage = definitions.get(REMOTE_MINIO)!;
-
-        expect([...definitions.keys()]).toEqual([REMOTE_COUCHDB, REMOTE_MINIO]);
-        expect("sameKindReconciliation" in couchDB).toBe(false);
-        expect("sameKindReconciliation" in objectStorage).toBe(false);
-
-        expect(
-            couchDB.isConfigured(
-                Object.assign(createNewVaultSettings(), {
-                    remoteType: REMOTE_COUCHDB,
-                    couchDB_URI: "https://couch.example.test",
-                    couchDB_DBNAME: "vault",
-                })
-            )
-        ).toBe(true);
-        expect(
-            objectStorage.isConfigured(
-                Object.assign(createNewVaultSettings(), {
-                    remoteType: REMOTE_MINIO,
-                    endpoint: "https://objects.example.test",
-                    bucket: "vault",
-                })
-            )
-        ).toBe(true);
-
-        await couchDB.create(createNewVaultSettings());
-        await objectStorage.create(createNewVaultSettings());
-        expect(constructorMocks.couchDB).toHaveBeenCalledWith(host);
-        expect(constructorMocks.objectStorage).toHaveBeenCalledWith(host);
-    });
-
-    it("rejects incomplete and wrong-kind settings before construction", () => {
-        const definitions = createCentralReplicatorProviderDefinitions({} as never);
-        const couchDB = definitions.get(REMOTE_COUCHDB)!;
-        const objectStorage = definitions.get(REMOTE_MINIO)!;
-
-        expect(couchDB.isConfigured(Object.assign(createNewVaultSettings(), { remoteType: REMOTE_MINIO }))).toBe(false);
-        expect(
-            objectStorage.isConfigured(Object.assign(createNewVaultSettings(), { remoteType: REMOTE_COUCHDB }))
-        ).toBe(false);
-    });
-
-    it("declares the retained owned resources and cohesive optional administration", () => {
-        const definitions = createCentralReplicatorProviderDefinitions({} as never);
-        const couchResources = definitions.get(REMOTE_COUCHDB)?.remoteResources;
-        const objectResources = definitions.get(REMOTE_MINIO)?.remoteResources;
-        const couchAdministration = definitions.get(REMOTE_COUCHDB)?.centralRemoteAdministration;
-        const objectAdministration = definitions.get(REMOTE_MINIO)?.centralRemoteAdministration;
-
-        expect(Object.keys(couchResources ?? {}).sort()).toEqual(Object.values(REMOTE_RESOURCE_KINDS).sort());
-        expect(Object.keys(objectResources ?? {}).sort()).toEqual(Object.values(REMOTE_RESOURCE_KINDS).sort());
-        expect(couchResources?.[REMOTE_RESOURCE_KINDS.CONNECTION].kind).toBe(CAPABILITY_SUPPORT_KINDS.SUPPORTED);
-        expect(couchResources?.[REMOTE_RESOURCE_KINDS.PREFERRED_TWEAK].kind).toBe(CAPABILITY_SUPPORT_KINDS.SUPPORTED);
-        expect(couchResources?.[REMOTE_RESOURCE_KINDS.SECURITY_SEED].kind).toBe(CAPABILITY_SUPPORT_KINDS.SUPPORTED);
-        expect(couchResources?.[REMOTE_RESOURCE_KINDS.SYNCHRONISATION_INFORMATION].kind).toBe(
-            CAPABILITY_SUPPORT_KINDS.SUPPORTED
-        );
-        expect(objectResources?.[REMOTE_RESOURCE_KINDS.SECURITY_SEED].kind).toBe(CAPABILITY_SUPPORT_KINDS.SUPPORTED);
-        expect(objectResources?.[REMOTE_RESOURCE_KINDS.SYNCHRONISATION_INFORMATION].kind).toBe(
-            CAPABILITY_SUPPORT_KINDS.NOT_APPLICABLE
-        );
-        expect(couchAdministration?.kind).toBe(CAPABILITY_SUPPORT_KINDS.SUPPORTED);
-        expect(objectAdministration?.kind).toBe(CAPABILITY_SUPPORT_KINDS.SUPPORTED);
-        expect("activeRemoteReads" in definitions.get(REMOTE_COUCHDB)!).toBe(false);
-        expect("fullTransfers" in definitions.get(REMOTE_COUCHDB)!).toBe(false);
-    });
-
-    it("dispatches central finite work through provider-local attempt results", async () => {
-        const definitions = createCentralReplicatorProviderDefinitions({} as never);
-        const couchDB = definitions.get(REMOTE_COUCHDB)!;
-        const objectStorage = definitions.get(REMOTE_MINIO)!;
-        const setting = createNewVaultSettings();
-        const couchInstance = await couchDB.create(setting);
-        const objectInstance = await objectStorage.create(setting);
-        if (!couchInstance || !objectInstance) throw new Error("Provider construction failed");
-        if (couchDB.userInitiatedOneShot.kind !== CAPABILITY_SUPPORT_KINDS.SUPPORTED) {
-            throw new Error("CouchDB OneShot is unavailable");
-        }
-        if (objectStorage.unattendedOneShot.kind !== CAPABILITY_SUPPORT_KINDS.SUPPORTED) {
-            throw new Error("Object Storage OneShot is unavailable");
-        }
-
-        await expect(
-            couchDB.userInitiatedOneShot.run(couchInstance, setting, {
-                trigger: "manual",
-                interaction: USER_INITIATED_REPLICATION_AUTHORITY,
-            })
-        ).resolves.toBe(REPLICATION_COMPLETED);
-        await expect(
-            objectStorage.unattendedOneShot.run(objectInstance, setting, {
-                trigger: "resume",
-                interaction: NO_INTERACTION,
-            })
-        ).resolves.toBe(REPLICATION_COMPLETED);
-
-        expect(constructorMocks.couchDBOneShot).toHaveBeenCalledWith(setting, true);
-        expect(constructorMocks.objectStorageOneShot).toHaveBeenCalledWith(setting, false);
-    });
-
-    it("dispatches central finite work through the declared operation rather than constructor identity", async () => {
-        const definitions = createCentralReplicatorProviderDefinitions({} as never);
-        const couchDB = definitions.get(REMOTE_COUCHDB)!;
-        const objectStorage = definitions.get(REMOTE_MINIO)!;
-        const setting = createNewVaultSettings();
-        const createStructuralOneShotReplicator = () => ({
-            initializeDatabaseForReplication: vi.fn(async () => true),
-            openReplication: vi.fn(async () => true),
-            terminateSync: vi.fn(),
-            closeReplication: vi.fn(),
-            openOneShotReplicationWithOutcome: vi.fn(async () => REPLICATION_COMPLETED),
-        });
-        const couchInstance = createStructuralOneShotReplicator();
-        const objectStorageInstance = createStructuralOneShotReplicator();
-        if (couchDB.userInitiatedOneShot.kind !== CAPABILITY_SUPPORT_KINDS.SUPPORTED) {
-            throw new Error("CouchDB OneShot is unavailable");
-        }
-        if (objectStorage.unattendedOneShot.kind !== CAPABILITY_SUPPORT_KINDS.SUPPORTED) {
-            throw new Error("Object Storage OneShot is unavailable");
-        }
-
-        const couchOutcome = await couchDB.userInitiatedOneShot.run(couchInstance, setting, {
-            trigger: "manual",
-            interaction: USER_INITIATED_REPLICATION_AUTHORITY,
-        });
-        const objectStorageOutcome = await objectStorage.unattendedOneShot.run(objectStorageInstance, setting, {
-            trigger: "resume",
-            interaction: NO_INTERACTION,
-        });
-
-        expect.soft(couchOutcome).toBe(REPLICATION_COMPLETED);
-        expect.soft(objectStorageOutcome).toBe(REPLICATION_COMPLETED);
-        expect(couchInstance.openOneShotReplicationWithOutcome).toHaveBeenCalledWith(setting, true);
-        expect(objectStorageInstance.openOneShotReplicationWithOutcome).toHaveBeenCalledWith(setting, false);
-    });
-
-    it("rejects a one-shot adapter whose Replicator does not declare the required operation", async () => {
-        const definitions = createCentralReplicatorProviderDefinitions({} as never);
-        const couchDB = definitions.get(REMOTE_COUCHDB)!;
-        const setting = createNewVaultSettings();
-        const incompleteInstance = {
-            initializeDatabaseForReplication: vi.fn(async () => true),
-            openReplication: vi.fn(async () => true),
-            terminateSync: vi.fn(),
-            closeReplication: vi.fn(),
-        };
-        if (couchDB.userInitiatedOneShot.kind !== CAPABILITY_SUPPORT_KINDS.SUPPORTED) {
-            throw new Error("CouchDB OneShot is unavailable");
-        }
-
-        const outcome = await couchDB.userInitiatedOneShot.run(incompleteInstance, setting, {
-            trigger: "manual",
-            interaction: USER_INITIATED_REPLICATION_AUTHORITY,
-        });
-
-        expect(outcome.status).toBe("failed");
-        expect(incompleteInstance.openReplication).not.toHaveBeenCalled();
-    });
-});

src/common/replicatorResources.unit.spec.ts

@@ -1,271 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import { REMOTE_COUCHDB, REMOTE_MINIO } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import type { ObsidianLiveSyncSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import { createNewVaultSettings } from "@vrtmrz/livesync-commonlib/settings";
-
-const mocks = vi.hoisted(() => ({
-    couchDB: [] as Array<{
-        host: unknown;
-        isMobile: ReturnType<typeof vi.fn>;
-        connectRemoteCouchDBWithSetting: ReturnType<typeof vi.fn>;
-        getRemoteStatus: ReturnType<typeof vi.fn>;
-        getRemotePreferredTweakValues: ReturnType<typeof vi.fn>;
-        getReplicationPBKDF2Salt: ReturnType<typeof vi.fn>;
-        closeReplication: ReturnType<typeof vi.fn>;
-    }>,
-    objectStorage: [] as Array<{
-        host: unknown;
-        tryConnectRemote: ReturnType<typeof vi.fn>;
-        getRemoteStatus: ReturnType<typeof vi.fn>;
-        getRemotePreferredTweakValues: ReturnType<typeof vi.fn>;
-        getReplicationPBKDF2Salt: ReturnType<typeof vi.fn>;
-        closeReplication: ReturnType<typeof vi.fn>;
-    }>,
-    checkSyncInfo: vi.fn(async () => true),
-}));
-
-vi.mock("@vrtmrz/livesync-commonlib/compat/pouchdb/negotiation", () => ({
-    checkSyncInfo: mocks.checkSyncInfo,
-}));
-
-vi.mock("@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator", () => ({
-    LiveSyncCouchDBReplicator: class {
-        host: unknown;
-        isMobile = vi.fn(() => false);
-        connectRemoteCouchDBWithSetting = vi.fn();
-        getRemoteStatus = vi.fn();
-        getRemotePreferredTweakValues = vi.fn();
-        getReplicationPBKDF2Salt = vi.fn();
-        closeReplication = vi.fn();
-
-        constructor(host: unknown) {
-            this.host = host;
-            mocks.couchDB.push(this);
-        }
-    },
-}));
-
-vi.mock("@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator", () => ({
-    LiveSyncJournalReplicator: class {
-        host: unknown;
-        tryConnectRemote = vi.fn();
-        getRemoteStatus = vi.fn();
-        getRemotePreferredTweakValues = vi.fn();
-        getReplicationPBKDF2Salt = vi.fn();
-        closeReplication = vi.fn();
-
-        constructor(host: unknown) {
-            this.host = host;
-            mocks.objectStorage.push(this);
-        }
-    },
-}));
-
-import {
-    createCouchDBConnectionProbeFactory,
-    createCouchDBPreferredTweakProbeFactory,
-    createCouchDBSecuritySeedResourceFactory,
-    createCouchDBSynchronisationInformationResourceFactory,
-    createObjectStorageConnectionProbeFactory,
-    createObjectStoragePreferredTweakProbeFactory,
-    createObjectStorageSecuritySeedResourceFactory,
-} from "./replicatorResources";
-
-function createSettings(overrides: Partial<ObsidianLiveSyncSettings> = {}): ObsidianLiveSyncSettings {
-    return Object.assign(createNewVaultSettings(), {
-        remoteType: REMOTE_COUCHDB,
-        couchDB_URI: "https://couch.example.test",
-        couchDB_DBNAME: "vault",
-        endpoint: "https://objects.example.test",
-        bucket: "vault",
-        ...overrides,
-    });
-}
-
-describe("replicator probe factories", () => {
-    beforeEach(() => {
-        mocks.couchDB.length = 0;
-        mocks.objectStorage.length = 0;
-        mocks.checkSyncInfo.mockReset().mockResolvedValue(true);
-    });
-
-    it("binds a CouchDB connection probe to a shallow settings snapshot and closes its owned connection", async () => {
-        const host = { name: "host" };
-        const source = createSettings();
-        const snapshot = { ...source };
-        const probe = await createCouchDBConnectionProbeFactory(host as never)(source);
-        const replicator = mocks.couchDB[0];
-        const close = vi.fn(async () => undefined);
-        const databaseClose = vi.fn(async () => undefined);
-        replicator.isMobile.mockReturnValue(true);
-        replicator.connectRemoteCouchDBWithSetting.mockResolvedValue({
-            db: { close: databaseClose },
-            info: {},
-            close,
-        });
-
-        source.couchDB_URI = "https://changed.example.test";
-        expect(await probe.check({ createIfMissing: false, showResult: true })).toEqual({ ok: true });
-
-        expect(replicator.connectRemoteCouchDBWithSetting).toHaveBeenCalledWith(snapshot, true, false, false);
-        expect(replicator.connectRemoteCouchDBWithSetting.mock.calls[0][0]).not.toBe(source);
-        expect(close).toHaveBeenCalledOnce();
-        expect(databaseClose).not.toHaveBeenCalled();
-    });
-
-    it("maps a CouchDB connection error string and delegates status to the same snapshot", async () => {
-        const source = createSettings();
-        const snapshot = { ...source };
-        const probe = await createCouchDBConnectionProbeFactory({} as never)(source);
-        const replicator = mocks.couchDB[0];
-        replicator.connectRemoteCouchDBWithSetting.mockResolvedValue("connection failed");
-
-        expect(await probe.check()).toEqual({ ok: false, reason: "connection failed" });
-
-        const status = { estimatedSize: 12 };
-        replicator.getRemoteStatus.mockResolvedValue(status);
-        source.couchDB_DBNAME = "changed-vault";
-        expect(await probe.getStatus()).toBe(status);
-        expect(replicator.getRemoteStatus).toHaveBeenCalledWith(snapshot);
-    });
-
-    it("creates an unpublished Object Storage replicator for each probe and normalises connection results", async () => {
-        const host = { name: "host" };
-        const source = createSettings({ remoteType: REMOTE_MINIO });
-        const snapshot = { ...source };
-        const factory = createObjectStorageConnectionProbeFactory(host as never);
-        const firstProbe = await factory(source);
-        const secondProbe = await factory(source);
-        expect(mocks.objectStorage).toHaveLength(2);
-
-        const firstReplicator = mocks.objectStorage[0];
-        firstReplicator.tryConnectRemote.mockResolvedValue(true);
-        source.endpoint = "https://changed.example.test";
-        expect(await firstProbe.check()).toEqual({ ok: true });
-        expect(firstReplicator.tryConnectRemote).toHaveBeenCalledWith(snapshot, false);
-
-        const secondReplicator = mocks.objectStorage[1];
-        secondReplicator.tryConnectRemote.mockResolvedValue(false);
-        expect(await secondProbe.check({ showResult: true })).toEqual({ ok: false });
-        expect(secondReplicator.tryConnectRemote).toHaveBeenCalledWith(snapshot, true);
-
-        const error = new Error("storage offline");
-        secondReplicator.tryConnectRemote.mockRejectedValue(error);
-        expect(await secondProbe.check()).toEqual({ ok: false, reason: error });
-    });
-
-    it("delegates Object Storage status and preferred-tweak reads to the trial snapshot", async () => {
-        const source = createSettings({ remoteType: REMOTE_MINIO });
-        const snapshot = { ...source };
-        const connectionProbe = await createObjectStorageConnectionProbeFactory({} as never)(source);
-        const preferredProbe = await createObjectStoragePreferredTweakProbeFactory({} as never)(source);
-        const connectionReplicator = mocks.objectStorage[0];
-        const preferredReplicator = mocks.objectStorage[1];
-        const status = { estimatedSize: 42 };
-        const preferred = { status: "unsupported" } as const;
-        connectionReplicator.getRemoteStatus.mockResolvedValue(status);
-        preferredReplicator.getRemotePreferredTweakValues.mockResolvedValue(preferred);
-
-        source.bucket = "changed-vault";
-        expect(await connectionProbe.getStatus()).toBe(status);
-        expect(await preferredProbe.read()).toBe(preferred);
-        expect(connectionReplicator.getRemoteStatus).toHaveBeenCalledWith(snapshot);
-        expect(preferredReplicator.getRemotePreferredTweakValues).toHaveBeenCalledWith(snapshot);
-    });
-
-    it("shares one successful asynchronous disposal promise for every probe kind", async () => {
-        const couchProbe = await createCouchDBPreferredTweakProbeFactory({} as never)(createSettings());
-        const objectProbe = await createObjectStoragePreferredTweakProbeFactory({} as never)(
-            createSettings({ remoteType: REMOTE_MINIO })
-        );
-        const couchReplicator = mocks.couchDB[0];
-        const objectReplicator = mocks.objectStorage[0];
-
-        const couchDisposal = couchProbe.dispose();
-        expect(couchProbe.dispose()).toBe(couchDisposal);
-        const objectDisposal = objectProbe.dispose();
-        expect(objectProbe.dispose()).toBe(objectDisposal);
-        await Promise.all([couchDisposal, objectDisposal]);
-        expect(couchReplicator.closeReplication).toHaveBeenCalledOnce();
-        expect(objectReplicator.closeReplication).toHaveBeenCalledOnce();
-    });
-
-    it("shares a rejected disposal promise and never retries closeReplication", async () => {
-        const probe = await createObjectStorageConnectionProbeFactory({} as never)(
-            createSettings({ remoteType: REMOTE_MINIO })
-        );
-        const replicator = mocks.objectStorage[0];
-        const failure = new Error("close failed");
-        replicator.closeReplication.mockImplementation(() => {
-            throw failure;
-        });
-
-        const disposal = probe.dispose();
-        expect(probe.dispose()).toBe(disposal);
-        await expect(disposal).rejects.toBe(failure);
-        expect(replicator.closeReplication).toHaveBeenCalledOnce();
-    });
-
-    it("reads the Security Seed from a settings snapshot and disposes its private Replicator", async () => {
-        const couchSettings = createSettings();
-        const couchSnapshot = { ...couchSettings };
-        const objectSettings = createSettings({ remoteType: REMOTE_MINIO });
-        const objectSnapshot = { ...objectSettings };
-        const couchResource = await createCouchDBSecuritySeedResourceFactory({} as never)(couchSettings);
-        const objectResource = await createObjectStorageSecuritySeedResourceFactory({} as never)(objectSettings);
-        const couchReplicator = mocks.couchDB[0];
-        const objectReplicator = mocks.objectStorage[0];
-        const couchSeed = new Uint8Array([1]);
-        const objectSeed = new Uint8Array([2]);
-        couchReplicator.getReplicationPBKDF2Salt.mockResolvedValue(couchSeed);
-        objectReplicator.getReplicationPBKDF2Salt.mockResolvedValue(objectSeed);
-
-        couchSettings.couchDB_URI = "https://changed.example.test";
-        objectSettings.endpoint = "https://changed.example.test";
-        await expect(couchResource.read()).resolves.toBe(couchSeed);
-        await expect(objectResource.read()).resolves.toBe(objectSeed);
-        expect(couchReplicator.getReplicationPBKDF2Salt).toHaveBeenCalledWith(couchSnapshot, true);
-        expect(objectReplicator.getReplicationPBKDF2Salt).toHaveBeenCalledWith(objectSnapshot, true);
-
-        await Promise.all([couchResource.dispose(), objectResource.dispose()]);
-        expect(couchReplicator.closeReplication).toHaveBeenCalledOnce();
-        expect(objectReplicator.closeReplication).toHaveBeenCalledOnce();
-    });
-
-    it("checks synchronisation information through an owned connection and disposes the private Replicator", async () => {
-        const settings = createSettings();
-        const snapshot = { ...settings };
-        const resource = await createCouchDBSynchronisationInformationResourceFactory({} as never)(settings);
-        const replicator = mocks.couchDB[0];
-        const database = { close: vi.fn() };
-        const close = vi.fn(async () => undefined);
-        replicator.connectRemoteCouchDBWithSetting.mockResolvedValue({ db: database, close });
-
-        settings.couchDB_DBNAME = "changed-vault";
-        await expect(resource.check()).resolves.toBe(true);
-        expect(replicator.connectRemoteCouchDBWithSetting).toHaveBeenCalledWith(snapshot, false, true);
-        expect(mocks.checkSyncInfo).toHaveBeenCalledWith(database);
-        expect(close).toHaveBeenCalledOnce();
-        expect(database.close).not.toHaveBeenCalled();
-
-        await resource.dispose();
-        expect(replicator.closeReplication).toHaveBeenCalledOnce();
-    });
-
-    it("closes the owned connection when synchronisation-information verification rejects", async () => {
-        const resource = await createCouchDBSynchronisationInformationResourceFactory({} as never)(createSettings());
-        const replicator = mocks.couchDB[0];
-        const database = { close: vi.fn() };
-        const close = vi.fn(async () => undefined);
-        const failure = new Error("verification failed");
-        replicator.connectRemoteCouchDBWithSetting.mockResolvedValue({ db: database, close });
-        mocks.checkSyncInfo.mockRejectedValue(failure);
-
-        await expect(resource.check()).rejects.toBe(failure);
-        expect(close).toHaveBeenCalledOnce();
-        expect(database.close).not.toHaveBeenCalled();
-
-        await resource.dispose();
-        expect(replicator.closeReplication).toHaveBeenCalledOnce();
-    });
-});

src/common/replicatorResources/connection.ts

@@ -1,87 +0,0 @@
-import type { RemoteDBSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import type {
-    ConnectionProbeFactory,
-    RemoteConnectionProbe,
-    RemoteConnectionProbeOptions,
-} from "@vrtmrz/livesync-commonlib/replication";
-import {
-    LiveSyncCouchDBReplicator,
-    type LiveSyncCouchDBReplicatorEnv,
-} from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
-import { LiveSyncJournalReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator";
-import { createReplicatorDisposer, snapshotRemoteSettings } from "./shared";
-
-/** Host environment sufficient to construct either central connection probe. */
-export type ConnectionResourceHost = LiveSyncCouchDBReplicatorEnv;
-
-function createCouchDBConnectionProbe(
-    replicator: LiveSyncCouchDBReplicator,
-    snapshot: RemoteDBSettings
-): RemoteConnectionProbe {
-    const dispose = createReplicatorDisposer(replicator);
-    return {
-        check: async (options: RemoteConnectionProbeOptions = {}) => {
-            const connection = await replicator.connectRemoteCouchDBWithSetting(
-                snapshot,
-                replicator.isMobile(),
-                options.createIfMissing ?? true,
-                false
-            );
-            if (typeof connection === "string") {
-                return { ok: false, reason: connection };
-            }
-            try {
-                return { ok: true };
-            } finally {
-                await connection.close();
-            }
-        },
-        getStatus: () => replicator.getRemoteStatus(snapshot),
-        dispose,
-    };
-}
-
-function createObjectStorageConnectionProbe(
-    replicator: LiveSyncJournalReplicator,
-    snapshot: RemoteDBSettings
-): RemoteConnectionProbe {
-    const dispose = createReplicatorDisposer(replicator);
-    return {
-        check: async (options: RemoteConnectionProbeOptions = {}) => {
-            try {
-                const connected = await replicator.tryConnectRemote(snapshot, options.showResult ?? false);
-                return connected ? { ok: true } : { ok: false };
-            } catch (error) {
-                return { ok: false, reason: error };
-            }
-        },
-        getStatus: () => replicator.getRemoteStatus(snapshot),
-        dispose,
-    };
-}
-
-/**
- * Build an unpublished CouchDB connection probe for one host.
- *
- * The probe owns both its concrete Replicator and each connection it opens. It
- * never publishes that Replicator as the active provider instance.
- */
-export function createCouchDBConnectionProbeFactory(host: ConnectionResourceHost): ConnectionProbeFactory {
-    return (setting) => {
-        const snapshot = snapshotRemoteSettings(setting);
-        return Promise.resolve(createCouchDBConnectionProbe(new LiveSyncCouchDBReplicator(host), snapshot));
-    };
-}
-
-/**
- * Build an unpublished Object Storage connection probe for one host.
- *
- * The probe owns its concrete Replicator and never publishes or replaces the
- * active provider instance.
- */
-export function createObjectStorageConnectionProbeFactory(host: ConnectionResourceHost): ConnectionProbeFactory {
-    return (setting) => {
-        const snapshot = snapshotRemoteSettings(setting);
-        return Promise.resolve(createObjectStorageConnectionProbe(new LiveSyncJournalReplicator(host), snapshot));
-    };
-}

src/common/replicatorResources/index.ts

@@ -1,16 +0,0 @@
-export {
-    createCouchDBConnectionProbeFactory,
-    createObjectStorageConnectionProbeFactory,
-    type ConnectionResourceHost,
-} from "./connection";
-export {
-    createCouchDBPreferredTweakProbeFactory,
-    createObjectStoragePreferredTweakProbeFactory,
-    type PreferredTweakResourceHost,
-} from "./preferredTweak";
-export {
-    createCouchDBSecuritySeedResourceFactory,
-    createObjectStorageSecuritySeedResourceFactory,
-    type SecuritySeedResourceHost,
-} from "./securitySeed";
-export { createCouchDBSynchronisationInformationResourceFactory } from "./synchronisationInformation";

src/common/replicatorResources/preferredTweak.ts

@@ -1,43 +0,0 @@
-import type { RemoteDBSettings, RemotePreferredTweakResult } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import type { PreferredTweakProbe, PreferredTweakProbeFactory } from "@vrtmrz/livesync-commonlib/replication";
-import {
-    LiveSyncCouchDBReplicator,
-    type LiveSyncCouchDBReplicatorEnv,
-} from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
-import { LiveSyncJournalReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator";
-import { createReplicatorDisposer, snapshotRemoteSettings, type ResourceReplicator } from "./shared";
-
-/** Host environment sufficient to construct either preferred-tweak probe. */
-export type PreferredTweakResourceHost = LiveSyncCouchDBReplicatorEnv;
-
-interface PreferredTweakReplicator extends ResourceReplicator {
-    getRemotePreferredTweakValues(setting: RemoteDBSettings): Promise<RemotePreferredTweakResult>;
-}
-
-function createPreferredTweakProbe(
-    replicator: PreferredTweakReplicator,
-    snapshot: RemoteDBSettings
-): PreferredTweakProbe {
-    return {
-        read: () => replicator.getRemotePreferredTweakValues(snapshot),
-        dispose: createReplicatorDisposer(replicator),
-    };
-}
-
-/** Build an unpublished, independently disposed CouchDB preferred-tweak probe. */
-export function createCouchDBPreferredTweakProbeFactory(host: PreferredTweakResourceHost): PreferredTweakProbeFactory {
-    return (setting) => {
-        const snapshot = snapshotRemoteSettings(setting);
-        return Promise.resolve(createPreferredTweakProbe(new LiveSyncCouchDBReplicator(host), snapshot));
-    };
-}
-
-/** Build an unpublished, independently disposed Object Storage preferred-tweak probe. */
-export function createObjectStoragePreferredTweakProbeFactory(
-    host: PreferredTweakResourceHost
-): PreferredTweakProbeFactory {
-    return (setting) => {
-        const snapshot = snapshotRemoteSettings(setting);
-        return Promise.resolve(createPreferredTweakProbe(new LiveSyncJournalReplicator(host), snapshot));
-    };
-}

src/common/replicatorResources/securitySeed.ts

@@ -1,41 +0,0 @@
-import type { RemoteDBSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import type { SecuritySeedResourceFactory } from "@vrtmrz/livesync-commonlib/replication";
-import {
-    LiveSyncCouchDBReplicator,
-    type LiveSyncCouchDBReplicatorEnv,
-} from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
-import { LiveSyncJournalReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator";
-import { createReplicatorDisposer, snapshotRemoteSettings, type ResourceReplicator } from "./shared";
-
-/** Host environment sufficient to construct either Security Seed resource. */
-export type SecuritySeedResourceHost = LiveSyncCouchDBReplicatorEnv;
-
-/** Minimal private Replicator surface required by a Security Seed resource. */
-interface SecuritySeedReplicator extends ResourceReplicator {
-    getReplicationPBKDF2Salt(setting: RemoteDBSettings, refresh?: boolean): Promise<Uint8Array<ArrayBuffer>>;
-}
-
-function createSecuritySeedResourceFactory(
-    createReplicator: () => SecuritySeedReplicator
-): SecuritySeedResourceFactory {
-    return (setting) => {
-        const snapshot = snapshotRemoteSettings(setting);
-        const replicator = createReplicator();
-        return Promise.resolve({
-            read: () => replicator.getReplicationPBKDF2Salt(snapshot, true),
-            dispose: createReplicatorDisposer(replicator),
-        });
-    };
-}
-
-/** Build an unpublished, independently disposed CouchDB Security Seed resource. */
-export function createCouchDBSecuritySeedResourceFactory(host: SecuritySeedResourceHost): SecuritySeedResourceFactory {
-    return createSecuritySeedResourceFactory(() => new LiveSyncCouchDBReplicator(host));
-}
-
-/** Build an unpublished, independently disposed Object Storage Security Seed resource. */
-export function createObjectStorageSecuritySeedResourceFactory(
-    host: SecuritySeedResourceHost
-): SecuritySeedResourceFactory {
-    return createSecuritySeedResourceFactory(() => new LiveSyncJournalReplicator(host));
-}

src/common/replicatorResources/shared.ts

@@ -1,28 +0,0 @@
-import type { RemoteDBSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
-
-/**
- * Closeable surface of a concrete Replicator owned by one private resource.
- *
- * It deliberately exposes no active-provider controls: the resource may use
- * the helper for one bounded operation, then must dispose it without
- * publishing or replacing the active Replicator.
- */
-export interface ResourceReplicator {
-    closeReplication(): void | Promise<void>;
-}
-
-/** Create one idempotent asynchronous disposer for a private Replicator. */
-export function createReplicatorDisposer(replicator: ResourceReplicator): () => Promise<void> {
-    let disposal: Promise<void> | undefined;
-    return () => {
-        if (disposal === undefined) {
-            disposal = Promise.resolve().then(() => replicator.closeReplication());
-        }
-        return disposal;
-    };
-}
-
-/** Fence a finite resource from later edits to its source settings object. */
-export function snapshotRemoteSettings(setting: RemoteDBSettings): RemoteDBSettings {
-    return { ...setting };
-}

src/common/replicatorResources/synchronisationInformation.ts

@@ -1,40 +0,0 @@
-import type { SynchronisationInformationResourceFactory } from "@vrtmrz/livesync-commonlib/replication";
-import {
-    LiveSyncCouchDBReplicator,
-    type LiveSyncCouchDBReplicatorEnv,
-} from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
-import { checkSyncInfo } from "@vrtmrz/livesync-commonlib/compat/pouchdb/negotiation";
-import { createReplicatorDisposer, snapshotRemoteSettings } from "./shared";
-
-/**
- * Build an unpublished CouchDB synchronisation-information verifier.
- *
- * The resource owns its concrete Replicator and connection, and cannot replace
- * the active provider instance.
- */
-export function createCouchDBSynchronisationInformationResourceFactory(
-    host: LiveSyncCouchDBReplicatorEnv
-): SynchronisationInformationResourceFactory {
-    return (setting) => {
-        const snapshot = snapshotRemoteSettings(setting);
-        const replicator = new LiveSyncCouchDBReplicator(host);
-        return Promise.resolve({
-            check: async () => {
-                const connection = await replicator.connectRemoteCouchDBWithSetting(
-                    snapshot,
-                    replicator.isMobile(),
-                    true
-                );
-                if (typeof connection === "string") {
-                    return false;
-                }
-                try {
-                    return await checkSyncInfo(connection.db);
-                } finally {
-                    await connection.close();
-                }
-            },
-            dispose: createReplicatorDisposer(replicator),
-        });
-    };
-}

src/features/ConfigSync/PluginPane.svelte

@@ -24,7 +24,6 @@
     import { LOG_LEVEL_NOTICE, Logger } from "octagonal-wheels/common/logger";
     import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore.ts";
     import { $msg as translateMessage } from "@/common/translation";
-    import { USER_INITIATED_REPLICATION_AUTHORITY } from "@vrtmrz/livesync-commonlib/replication";
     export let plugin: ObsidianLiveSyncPlugin;
     export let core :LiveSyncBaseCore;
     // $: core = plugin.core;
@@ -105,10 +104,7 @@
         await requestUpdate();
     }
     async function replicate() {
-        await core.services.replication.replicateUserInitiated({
-            trigger: "manual",
-            interaction: USER_INITIATED_REPLICATION_AUTHORITY,
-        });
+        await core.services.replication.replicate(true);
     }
     function selectAllNewest(selectMode: boolean) {
         selectNewestPulse++;

src/features/LocalDatabaseMainte/CmdLocalDatabaseMainte.ts

@@ -17,7 +17,6 @@ import { serialized } from "octagonal-wheels/concurrency/lock_v2";
 import { arrayToChunkedArray } from "octagonal-wheels/collection";
 import { EVENT_ANALYSE_DB_USAGE, EVENT_REQUEST_PERFORM_GC_V3, eventHub } from "@/common/events";
 import type { LiveSyncCouchDBReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
-import type { ReplicatorInstance } from "@vrtmrz/livesync-commonlib/replication";
 import { delay } from "@vrtmrz/livesync-commonlib/compat/common/utils";
 import { isNotFoundError } from "@vrtmrz/livesync-commonlib/compat/common/utils.doc";
 import { ensureLocalDatabaseMaintenancePrerequisites } from "./maintenancePrerequisites";
@@ -30,31 +29,6 @@ type NoteDocumentID = DocumentID;
 type Rev = string;
 
 type ChunkUsageMap = Map<NoteDocumentID, Map<Rev, Set<ChunkID>>>;
-
-type CouchDBCompactionReplicator = ReplicatorInstance &
-    Pick<LiveSyncCouchDBReplicator, "connectRemoteCouchDBWithSetting">;
-
-type CouchDBGarbageCollectionReplicator = ReplicatorInstance &
-    Pick<LiveSyncCouchDBReplicator, "getConnectedDeviceList" | "openOneShotReplication">;
-
-function canCompactCouchDBRemote(replicator: ReplicatorInstance): replicator is CouchDBCompactionReplicator {
-    return (
-        "connectRemoteCouchDBWithSetting" in replicator &&
-        typeof replicator.connectRemoteCouchDBWithSetting === "function"
-    );
-}
-
-function canRunCouchDBGarbageCollection(
-    replicator: ReplicatorInstance
-): replicator is CouchDBGarbageCollectionReplicator {
-    return (
-        "getConnectedDeviceList" in replicator &&
-        typeof replicator.getConnectedDeviceList === "function" &&
-        "openOneShotReplication" in replicator &&
-        typeof replicator.openOneShotReplication === "function"
-    );
-}
-
 export class LocalDatabaseMaintenance extends LiveSyncCommands {
     onunload(): void {
         // NO OP.
@@ -763,8 +737,7 @@ Success: ${successCount}, Errored: ${errored}`;
     }
 
     async compactDatabase() {
-        const replicator = this.core.replicator;
-        if (!canCompactCouchDBRemote(replicator)) return;
+        const replicator = this.core.replicator as LiveSyncCouchDBReplicator;
         const remote = await replicator.connectRemoteCouchDBWithSetting(this.settings, false, false, true);
         if (!remote) {
             this._notice("Failed to connect to remote for compaction.", "gc-compact");
@@ -867,9 +840,8 @@ Success: ${successCount}, Errored: ${errored}`;
     //     }
     // }
     async gcv3() {
-        const replicator = this.core.replicator;
-        if (this.settings.remoteType !== REMOTE_COUCHDB || !canRunCouchDBGarbageCollection(replicator)) return;
         if (!(await this.ensureAvailable("Garbage Collection"))) return;
+        const replicator = this.core.replicator as LiveSyncCouchDBReplicator;
         // Start one-shot replication to ensure all changes are synced before GC.
         const r0 = await replicator.openOneShotReplication(this.settings, false, false, "sync");
         if (!r0) {
@@ -882,7 +854,7 @@ Success: ${successCount}, Errored: ${errored}`;
         // Delete the chunk, but first verify the following:
         // Fetch the list of accepted nodes from the replicator.
         const OPTION_CANCEL = "Cancel Garbage Collection";
-        const info = await replicator.getConnectedDeviceList();
+        const info = await this.core.replicator.getConnectedDeviceList();
         if (!info) {
             this._notice("No connected device information found. Cancelling Garbage Collection.");
             return;

src/features/P2PSync/P2PReplicator/P2POpenReplicationModal.ts

@@ -1,7 +1,7 @@
 import { App, Modal } from "@/deps.ts";
 import P2POpenReplicationPane from "./P2POpenReplicationPane.svelte";
 import { mount, unmount } from "svelte";
-import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
+import type { LiveSyncTrysteroReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/LiveSyncTrysteroReplicator";
 
 export type P2POpenReplicationModalCallback = {
     onSync: (peerId: string) => Promise<void>;
@@ -9,7 +9,7 @@ export type P2POpenReplicationModalCallback = {
 };
 
 export class P2POpenReplicationModal extends Modal {
-    p2p: P2PServiceViews;
+    liveSyncReplicator: LiveSyncTrysteroReplicator;
     callback?: P2POpenReplicationModalCallback;
     component?: ReturnType<typeof mount>;
     showResult: boolean;
@@ -19,7 +19,7 @@ export class P2POpenReplicationModal extends Modal {
 
     constructor(
         app: App,
-        p2p: P2PServiceViews,
+        liveSyncReplicator: LiveSyncTrysteroReplicator,
         callback?: P2POpenReplicationModalCallback,
         showResult: boolean = false,
         title: string = "P2P Replication",
@@ -27,7 +27,7 @@ export class P2POpenReplicationModal extends Modal {
         rebuildMode: boolean = false
     ) {
         super(app);
-        this.p2p = p2p;
+        this.liveSyncReplicator = liveSyncReplicator;
         this.callback = callback;
         this.showResult = showResult;
         this.title = title;
@@ -57,7 +57,7 @@ export class P2POpenReplicationModal extends Modal {
             this.component = mount(P2POpenReplicationPane, {
                 target: contentEl,
                 props: {
-                    p2p: this.p2p,
+                    liveSyncReplicator: this.liveSyncReplicator,
                     onSync: (peerId: string) => this.onSync(peerId),
                     onSyncAndClose: (peerId: string) => this.onSyncAndClose(peerId),
                     onClose: () => this.close(),

src/features/P2PSync/P2PReplicator/P2POpenReplicationPane.svelte

@@ -9,13 +9,13 @@
     // import type { TrysteroReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/TrysteroReplicator";
     import { LOG_LEVEL_NOTICE, LOG_LEVEL_INFO } from "@vrtmrz/livesync-commonlib/compat/common/types";
     import { Logger } from "@vrtmrz/livesync-commonlib/compat/common/logger";
-    import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
+    import type { LiveSyncTrysteroReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/LiveSyncTrysteroReplicator";
     import { delay, fireAndForget } from "octagonal-wheels/promises";
     import P2PServerStatusCard from "./P2PServerStatusCard.svelte";
     import { $msg as translateMessage } from "@/common/translation";
 
     interface Props {
-        p2p: P2PServiceViews;
+        liveSyncReplicator: LiveSyncTrysteroReplicator;
         onSync: (_peerId: string) => Promise<void>;
         onSyncAndClose: (_peerId: string) => Promise<void>;
         onClose: () => void;
@@ -23,14 +23,15 @@
         rebuildMode?: boolean;
     }
 
-    let { onSync, onSyncAndClose, onClose, showResult, p2p, rebuildMode = false }: Props = $props();
+    let { onSync, onSyncAndClose, onClose, showResult, liveSyncReplicator, rebuildMode = false }: Props = $props();
+    const getLiveSyncReplicator = () => liveSyncReplicator;
 
     let serverInfo = $state<P2PServerInfo | undefined>(undefined);
     let syncingPeerId = $state<string | null>(null);
 
     const logLevel = $derived(showResult ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO);
     async function requestServerStatus() {
-        p2p.diagnostics.requestStatus();
+        await liveSyncReplicator.requestStatus();
         eventHub.emitEvent(EVENT_REQUEST_STATUS);
     }
     onMount(() => {
@@ -72,7 +73,7 @@
 
     async function disconnect() {
         try {
-            await p2p.transportLifecycle.disconnect();
+            await liveSyncReplicator.close();
             Logger("Signalling connection closed.", logLevel);
         } catch (e) {
             Logger(`Failed to close signalling connection: ${e instanceof Error ? e.message : String(e)}`, logLevel);
@@ -99,7 +100,7 @@
 </script>
 
 <div class="p2p-container">
-    <P2PServerStatusCard {p2p} showBroadcastToggle={false} />
+    <P2PServerStatusCard {getLiveSyncReplicator} showBroadcastToggle={false} />
 
     <div class="peers-section">
         <h3>{translateMessage("Available Peers")}</h3>

src/features/P2PSync/P2PReplicator/P2PReplicationUI.ts

@@ -2,7 +2,6 @@ import type { App } from "@/deps.ts";
 import { Logger } from "@vrtmrz/livesync-commonlib/compat/common/logger";
 import { LOG_LEVEL_NOTICE, LOG_LEVEL_INFO } from "@vrtmrz/livesync-commonlib/compat/common/types";
 import type { LiveSyncTrysteroReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/LiveSyncTrysteroReplicator";
-import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
 import { P2POpenReplicationModal } from "./P2POpenReplicationModal";
 
 /**
@@ -16,8 +15,8 @@ import { P2POpenReplicationModal } from "./P2POpenReplicationModal";
  */
 export function createOpenReplicationUI(
     app: App
-): (replicator: LiveSyncTrysteroReplicator, p2p: P2PServiceViews) => (showResult: boolean) => Promise<boolean | void> {
-    return (replicator: LiveSyncTrysteroReplicator, p2p: P2PServiceViews) =>
+): (replicator: LiveSyncTrysteroReplicator) => (showResult: boolean) => Promise<boolean | void> {
+    return (replicator: LiveSyncTrysteroReplicator) =>
         (showResult: boolean): Promise<boolean | void> => {
             const logLevel = showResult ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO;
             return new Promise<boolean | void>((resolve) => {
@@ -58,7 +57,7 @@ export function createOpenReplicationUI(
                 };
                 const modal = new P2POpenReplicationModal(
                     app,
-                    p2p,
+                    replicator,
                     {
                         onSync: (peerId: string) => synchronise(peerId, false),
                         onSyncAndClose: (peerId: string) => synchronise(peerId, true),
@@ -86,8 +85,8 @@ export function createOpenReplicationUI(
  */
 export function createOpenRebuildUI(
     app: App
-): (replicator: LiveSyncTrysteroReplicator, p2p: P2PServiceViews) => (showResult: boolean) => Promise<boolean | void> {
-    return (replicator: LiveSyncTrysteroReplicator, p2p: P2PServiceViews) =>
+): (replicator: LiveSyncTrysteroReplicator) => (showResult: boolean) => Promise<boolean | void> {
+    return (replicator: LiveSyncTrysteroReplicator) =>
         (showResult: boolean): Promise<boolean | void> => {
             const logLevel = showResult ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO;
             return new Promise<boolean | void>((resolve) => {
@@ -133,7 +132,7 @@ export function createOpenRebuildUI(
 
                 const modal = new P2POpenReplicationModal(
                     app,
-                    p2p,
+                    replicator,
                     {
                         onSync: doRebuild,
                         onSyncAndClose: doRebuild,

src/features/P2PSync/P2PReplicator/P2PReplicationUI.unit.spec.ts

@@ -2,7 +2,6 @@ import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const modalState = vi.hoisted(() => ({
     instances: [] as Array<{
-        p2p: unknown;
         callback: {
             onSync: (peerId: string) => Promise<void>;
             onSyncAndClose: (peerId: string) => Promise<void>;
@@ -16,20 +15,18 @@ vi.mock("@/deps.ts", () => ({ App: class {} }));
 
 vi.mock("./P2POpenReplicationModal", () => ({
     P2POpenReplicationModal: class {
-        p2p;
         callback;
         onClosed;
         open = vi.fn();
 
         constructor(
             _app: unknown,
-            p2p: unknown,
+            _replicator: unknown,
             callback: (typeof modalState.instances)[number]["callback"],
             _showResult: boolean,
             _title?: string,
             onClosed?: () => void
         ) {
-            this.p2p = p2p;
             this.callback = callback;
             this.onClosed = onClosed;
             modalState.instances.push(this);
@@ -49,21 +46,15 @@ function createReplicator() {
     } as any;
 }
 
-function createP2PServiceViews() {
-    return { transportLifecycle: {}, diagnostics: {} } as any;
-}
-
 describe("createOpenReplicationUI", () => {
     beforeEach(() => {
         modalState.instances.length = 0;
     });
 
     it("settles a cancelled peer-selection session when the modal closes", async () => {
-        const p2p = createP2PServiceViews();
-        const session = createOpenReplicationUI({} as any)(createReplicator(), p2p)(true);
+        const session = createOpenReplicationUI({} as any)(createReplicator())(true);
         const modal = modalState.instances[0];
 
-        expect(modal.p2p).toBe(p2p);
         expect(modal.onClosed).toBeTypeOf("function");
         modal.onClosed?.();
 
@@ -72,7 +63,7 @@ describe("createOpenReplicationUI", () => {
 
     it("keeps repeated synchronisation inside the session boundary until the modal closes", async () => {
         const replicator = createReplicator();
-        const session = createOpenReplicationUI({} as any)(replicator, createP2PServiceViews())(true);
+        const session = createOpenReplicationUI({} as any)(replicator)(true);
         const modal = modalState.instances[0];
         let settled = false;
         void session.finally(() => {
@@ -100,7 +91,7 @@ describe("createOpenReplicationUI", () => {
                     finishPull = resolve;
                 })
         );
-        const session = createOpenReplicationUI({} as any)(replicator, createP2PServiceViews())(true);
+        const session = createOpenReplicationUI({} as any)(replicator)(true);
         const modal = modalState.instances[0];
         let settled = false;
         void session.finally(() => {
@@ -120,7 +111,7 @@ describe("createOpenReplicationUI", () => {
 
     it("closes the P2P connection after a successful sync-and-close action", async () => {
         const replicator = createReplicator();
-        const session = createOpenReplicationUI({} as any)(replicator, createP2PServiceViews())(true);
+        const session = createOpenReplicationUI({} as any)(replicator)(true);
         const modal = modalState.instances[0];
 
         await modal.callback.onSyncAndClose("peer-a");
@@ -152,7 +143,7 @@ describe("createOpenRebuildUI", () => {
                     finishPull = resolve;
                 })
         );
-        const session = createOpenRebuildUI({} as any)(replicator, createP2PServiceViews())(true);
+        const session = createOpenRebuildUI({} as any)(replicator)(true);
         const modal = modalState.instances[0];
         let settled = false;
         void session.finally(() => {
@@ -175,7 +166,7 @@ describe("createOpenRebuildUI", () => {
 
     it("does not complete Fetch when the rebuild dialogue closes without selecting a peer", async () => {
         const replicator = createReplicator();
-        const session = createOpenRebuildUI({} as any)(replicator, createP2PServiceViews())(true);
+        const session = createOpenRebuildUI({} as any)(replicator)(true);
         const modal = modalState.instances[0];
 
         modal.onClosed?.();

src/features/P2PSync/P2PReplicator/P2PReplicatorPane.svelte

@@ -13,6 +13,7 @@
         type PeerInfo,
         type P2PServerInfo,
         EVENT_SERVER_STATUS,
+        EVENT_REQUEST_STATUS,
         EVENT_P2P_REPLICATOR_STATUS,
     } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/TrysteroReplicatorP2PServer";
     import type { P2PReplicatorStatus } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/TrysteroReplicator";
@@ -28,6 +29,7 @@
     let services = $derived(host.services);
     let events = $derived(services.context.events);
     const currentSettings = () => services.setting.currentSettings() as P2PSyncSetting;
+    const currentReplicator = () => host.p2p.replicator;
     const initialSettings = { ...currentSettings() } as P2PSyncSetting;
 
     let settings = $state<P2PSyncSetting>(initialSettings);
@@ -144,7 +146,7 @@
             replicatorInfo = status;
         });
         applyLoadSettings(currentSettings(), true);
-        host.p2p.diagnostics.requestStatus();
+        events.emitEvent(EVENT_REQUEST_STATUS);
         return () => {
             r();
             rx();
@@ -221,16 +223,16 @@
     }
 
     async function openServer() {
-        await host.p2p.transportLifecycle.connect();
+        await currentReplicator().open();
     }
     async function closeServer() {
-        await host.p2p.transportLifecycle.disconnect();
+        await currentReplicator().close();
     }
     function startBroadcasting() {
-        host.p2p.changeRelay.enableBroadcastChanges();
+        currentReplicator().enableBroadcastChanges();
     }
     function stopBroadcasting() {
-        host.p2p.changeRelay.disableBroadcastChanges();
+        currentReplicator().disableBroadcastChanges();
     }
 
     const initialDialogStatusKey = `p2p-dialog-status`;

src/features/P2PSync/P2PReplicator/P2PReplicatorPaneHost.ts

@@ -1,20 +1,12 @@
 import type { RequiredServices } from "@vrtmrz/livesync-commonlib/compat/interfaces/ServiceModule";
-import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
 import type { PeerStatus } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/P2PReplicatorPaneCommon";
+import type { UseP2PReplicatorResult } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/UseP2PReplicatorResult";
 
-/**
- * The shared pane only needs the contracts which represent its visible
- * actions. In particular, it must not receive the compatibility Replicator
- * facade, whose lifecycle methods can bypass the stable P2P service owner.
- */
-export type P2PReplicatorPaneP2P = Pick<
-    P2PServiceViews,
-    "transportLifecycle" | "peerDirectory" | "peerAdmission" | "targetedTransfer" | "changeRelay" | "diagnostics"
->;
+export type P2PReplicatorHandle = Pick<UseP2PReplicatorResult, "replicator">;
 
 /** Host capabilities consumed by the shared P2P pane. */
 export interface P2PReplicatorPaneHost {
     readonly services: RequiredServices<"API" | "config" | "setting" | "vault">;
-    readonly p2p: P2PReplicatorPaneP2P;
+    readonly p2p: P2PReplicatorHandle;
     readonly showPeerMenu?: (peer: PeerStatus, event: MouseEvent) => void;
 }

src/features/P2PSync/P2PReplicator/P2PReplicatorPaneView.ts

@@ -8,7 +8,7 @@ import { LOG_LEVEL_NOTICE, REMOTE_P2P } from "@vrtmrz/livesync-commonlib/compat/
 import { Logger } from "@vrtmrz/livesync-commonlib/compat/common/logger";
 import type { PeerStatus } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/P2PReplicatorPaneCommon";
 import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore.ts";
-import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
+import type { P2PPaneParams } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/UseP2PReplicatorResult";
 export const VIEW_TYPE_P2P = "p2p-replicator";
 
 function addToList(item: string, list: string) {
@@ -31,7 +31,7 @@ function removeFromList(item: string, list: string) {
 
 export class P2PReplicatorPaneView extends SvelteItemView {
     core: LiveSyncBaseCore;
-    private _p2p: P2PServiceViews;
+    private _p2pResult: P2PPaneParams;
     override icon = "waypoints";
     title: string = "";
     override navigation = false;
@@ -39,18 +39,21 @@ export class P2PReplicatorPaneView extends SvelteItemView {
     override getIcon(): string {
         return "waypoints";
     }
+    get replicator() {
+        return this._p2pResult.replicator;
+    }
     async replicateFrom(peer: PeerStatus) {
-        await this._p2p.targetedTransfer.pullFromPeer(peer.peerId);
+        await this.replicator.replicateFrom(peer.peerId);
     }
     async replicateTo(peer: PeerStatus) {
-        await this._p2p.targetedTransfer.requestPushToPeer(peer.peerId);
+        await this.replicator.requestSynchroniseToPeer(peer.peerId);
     }
     async getRemoteConfig(peer: PeerStatus) {
         Logger(
             `Requesting remote config for ${peer.name}. Please input the passphrase on the remote device`,
             LOG_LEVEL_NOTICE
         );
-        const remoteConfig = await this._p2p.configurationExchange.getRemoteConfiguration(peer.peerId);
+        const remoteConfig = await this.replicator.getRemoteConfig(peer.peerId);
         if (remoteConfig) {
             Logger(`Remote config for ${peer.name} is retrieved successfully`);
             const DROP = "Yes, and drop local database";
@@ -119,10 +122,10 @@ And you can also drop the local database to rebuild from the remote device.`,
         await this.core.services.setting.applyPartial(currentSetting, true);
     }
     m?: Menu;
-    constructor(leaf: WorkspaceLeaf, core: LiveSyncBaseCore, p2p: P2PServiceViews) {
+    constructor(leaf: WorkspaceLeaf, core: LiveSyncBaseCore, p2pResult: P2PPaneParams) {
         super(leaf);
         this.core = core;
-        this._p2p = p2p;
+        this._p2pResult = p2pResult;
     }
 
     private showPeerMenu(peer: PeerStatus, event: MouseEvent): void {
@@ -184,7 +187,7 @@ And you can also drop the local database to rebuild from the remote device.`,
             props: {
                 host: {
                     services: this.core.services,
-                    p2p: this._p2p,
+                    p2p: this._p2pResult,
                     showPeerMenu: (peer: PeerStatus, event: MouseEvent) => this.showPeerMenu(peer, event),
                 },
             },

src/features/P2PSync/P2PReplicator/P2PServerStatusCard.svelte

@@ -9,19 +9,19 @@
         EVENT_P2P_REPLICATOR_STATUS,
     } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/TrysteroReplicatorP2PServer";
     import { EVENT_SETTING_SAVED } from "@vrtmrz/livesync-commonlib/compat/events/coreEvents";
-    import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
+    import type { LiveSyncTrysteroReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/LiveSyncTrysteroReplicator";
     import type { P2PReplicatorStatus } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/TrysteroReplicator";
     import { extractP2PRoomSuffix } from "@vrtmrz/livesync-commonlib/compat/common/utils";
     import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore";
     import { $msg as translateMessage } from "@/common/translation";
 
     interface Props {
-        p2p: P2PServiceViews;
+        getLiveSyncReplicator: () => LiveSyncTrysteroReplicator;
         showBroadcastToggle?: boolean;
         core?: LiveSyncBaseCore;
     }
 
-    let { p2p, showBroadcastToggle = true, core }: Props = $props();
+    let { getLiveSyncReplicator, showBroadcastToggle = true, core }: Props = $props();
     let serverInfo = $state<P2PServerInfo | undefined>(undefined);
     let replicatorStatus = $state<P2PReplicatorStatus | undefined>(undefined);
     // Later setting changes arrive through EVENT_SETTING_SAVED; these values only seed local state at mount time.
@@ -31,25 +31,25 @@
     let useDiagRTC = $state<boolean>(initialSettings?.P2P_useDiagRTC ?? false);
 
     async function requestServerStatus() {
-        p2p.diagnostics.requestStatus();
+        await Promise.resolve(getLiveSyncReplicator().requestStatus());
         eventHub.emitEvent(EVENT_REQUEST_STATUS);
     }
 
     async function onOpenConnection() {
-        await p2p.transportLifecycle.connect();
+        await getLiveSyncReplicator().makeSureOpened();
         await requestServerStatus();
     }
 
     async function onDisconnect() {
-        await p2p.transportLifecycle.disconnect();
+        await getLiveSyncReplicator().close();
         await requestServerStatus();
     }
 
     function toggleBroadcast() {
         if (replicatorStatus?.isBroadcasting) {
-            p2p.changeRelay.disableBroadcastChanges();
+            getLiveSyncReplicator().disableBroadcastChanges();
         } else {
-            p2p.changeRelay.enableBroadcastChanges();
+            getLiveSyncReplicator().enableBroadcastChanges();
         }
     }
 

src/features/P2PSync/P2PReplicator/P2PServerStatusPane.svelte

@@ -8,7 +8,7 @@
         EVENT_P2P_REPLICATOR_PROGRESS,
         type P2PServerInfo,
     } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/TrysteroReplicatorP2PServer";
-    import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
+    import type { LiveSyncTrysteroReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/LiveSyncTrysteroReplicator";
     import type { P2PReplicatorStatus, P2PReplicationReport } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/TrysteroReplicator";
     import { delay, fireAndForget } from "octagonal-wheels/promises";
     import P2PServerStatusCard from "./P2PServerStatusCard.svelte";
@@ -23,6 +23,7 @@
     } from "@vrtmrz/livesync-commonlib/remote-configurations";
     import { extractP2PRoomSuffix } from "@vrtmrz/livesync-commonlib/compat/common/utils";
     import { SetupManager } from "@/modules/features/SetupManager";
+    import SetupRemoteP2P from "@/modules/features/SetupWizard/dialogs/SetupRemoteP2P.svelte";
     import { Menu } from "@/deps";
     import { $msg as translateMessage } from "@/common/translation";
     import {
@@ -32,11 +33,11 @@
     } from "./p2pPeerSettings";
 
     interface Props {
-        p2p: P2PServiceViews;
+        getLiveSyncReplicator: () => LiveSyncTrysteroReplicator;
         core: LiveSyncBaseCore;
     }
 
-    let { p2p, core }: Props = $props();
+    let { getLiveSyncReplicator, core }: Props = $props();
     let serverInfo = $state<P2PServerInfo | undefined>(undefined);
     let replicatorInfo = $state<P2PReplicatorStatus | undefined>(undefined);
     let decidingPeerId = $state<string | null>(null);
@@ -120,7 +121,7 @@
     }
 
     async function requestServerStatus() {
-        p2p.diagnostics.requestStatus();
+        await getLiveSyncReplicator().requestStatus();
         eventHub.emitEvent(EVENT_REQUEST_STATUS);
     }
 
@@ -212,8 +213,9 @@
 
     async function createAndSelectP2PRemote() {
         const setupManager = core.getModule(SetupManager);
+        const dialogManager = setupManager.dialogManager;
         const currentSettings = core.services.setting.currentSettings();
-        const p2pConf = await setupManager.openP2PSetup(currentSettings);
+        const p2pConf = await dialogManager.openWithExplicitCancel(SetupRemoteP2P, currentSettings);
         if (p2pConf === "cancelled" || typeof p2pConf !== "object" || !p2pConf) {
             return;
         }
@@ -294,7 +296,7 @@
     ) {
         decidingPeerId = peer.peerId;
         try {
-            await p2p.peerAdmission.makeDecision({
+            await getLiveSyncReplicator().makeDecision({
                 peerId: peer.peerId,
                 name: peer.name,
                 decision,
@@ -309,7 +311,7 @@
     async function revokeDecision(peer: P2PServerInfo["knownAdvertisements"][number]) {
         decidingPeerId = peer.peerId;
         try {
-            await p2p.peerAdmission.revokeDecision({
+            await getLiveSyncReplicator().revokeDecision({
                 peerId: peer.peerId,
                 name: peer.name,
             });
@@ -322,7 +324,10 @@
     async function startReplication(peer: P2PServerInfo["knownAdvertisements"][number]) {
         replicatingPeerId = peer.peerId;
         try {
-            await p2p.targetedTransfer.synchroniseWithPeer(peer.peerId, true);
+            const pullResult = await getLiveSyncReplicator().replicateFrom(peer.peerId, true);
+            if (pullResult?.ok) {
+                await getLiveSyncReplicator().requestSynchroniseToPeer(peer.peerId);
+            }
             await requestServerStatus();
         } finally {
             replicatingPeerId = null;
@@ -342,9 +347,9 @@
             return;
         }
         if (isWatching(peerId)) {
-            p2p.changeRelay.unwatchPeer(peerId);
+            getLiveSyncReplicator().unwatchPeer(peerId);
         } else {
-            p2p.changeRelay.watchPeer(peerId);
+            getLiveSyncReplicator().watchPeer(peerId);
         }
     }
 
@@ -450,7 +455,7 @@
         </p>
     {/if}
 
-    <P2PServerStatusCard {p2p} {core} />
+    <P2PServerStatusCard {getLiveSyncReplicator} {core} />
 
     <div class="peers-section">
         <div class="peers-header">

src/features/P2PSync/P2PReplicator/P2PServerStatusPaneView.ts

@@ -2,21 +2,21 @@ import { WorkspaceLeaf } from "@/deps.ts";
 import { mount } from "svelte";
 import { SvelteItemView } from "@/common/SvelteItemView.ts";
 import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore.ts";
-import type { P2PServiceViews } from "@vrtmrz/livesync-commonlib/p2p";
+import type { P2PPaneParams } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/UseP2PReplicatorResult";
 import P2PServerStatusPane from "./P2PServerStatusPane.svelte";
 
 export const VIEW_TYPE_P2P_SERVER_STATUS = "p2p-server-status";
 
 export class P2PServerStatusPaneView extends SvelteItemView {
     core: LiveSyncBaseCore;
-    private readonly p2p: P2PServiceViews;
+    private _p2pResult: P2PPaneParams;
     override icon = "waypoints";
     override navigation = false;
 
-    constructor(leaf: WorkspaceLeaf, core: LiveSyncBaseCore, p2p: P2PServiceViews) {
+    constructor(leaf: WorkspaceLeaf, core: LiveSyncBaseCore, p2pResult: P2PPaneParams) {
         super(leaf);
         this.core = core;
-        this.p2p = p2p;
+        this._p2pResult = p2pResult;
     }
 
     override getIcon(): string {
@@ -35,7 +35,7 @@ export class P2PServerStatusPaneView extends SvelteItemView {
         return mount(P2PServerStatusPane, {
             target,
             props: {
-                p2p: this.p2p,
+                getLiveSyncReplicator: () => this._p2pResult.replicator,
                 core: this.core,
             },
         });

src/features/P2PSync/P2PReplicator/PeerStatusRow.svelte

@@ -1,16 +1,17 @@
 <script lang="ts">
     import { AcceptedStatus, type PeerStatus } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/P2PReplicatorPaneCommon";
-    import type { P2PReplicatorPaneP2P } from "./P2PReplicatorPaneHost";
+    import type { P2PReplicatorHandle } from "./P2PReplicatorPaneHost";
     import { $msg as translateMessage } from "@/common/translation";
 
     interface Props {
         peerStatus: PeerStatus;
-        p2p: P2PReplicatorPaneP2P;
+        p2p: P2PReplicatorHandle;
         showPeerMenu?: (peer: PeerStatus, event: MouseEvent) => void;
     }
 
     let { peerStatus, p2p, showPeerMenu }: Props = $props();
     let peer = $derived(peerStatus);
+    const currentReplicator = () => p2p.replicator;
 
     function select<T extends PropertyKey, U, V = undefined>(
         d: T,
@@ -71,7 +72,7 @@
     let isNew = $derived.by(() => peer.accepted === AcceptedStatus.UNKNOWN);
 
     function makeDecision(isAccepted: boolean, isTemporary: boolean) {
-        void p2p.peerAdmission.makeDecision({
+        currentReplicator().makeDecision({
             peerId: peer.peerId,
             name: peer.name,
             decision: isAccepted,
@@ -79,7 +80,7 @@
         });
     }
     function revokeDecision() {
-        void p2p.peerAdmission.revokeDecision({
+        currentReplicator().revokeDecision({
             peerId: peer.peerId,
             name: peer.name,
         });
@@ -98,14 +99,14 @@
         return attrs;
     });
     function startWatching() {
-        p2p.changeRelay.watchPeer(peer.peerId);
+        currentReplicator().watchPeer(peer.peerId);
     }
     function stopWatching() {
-        p2p.changeRelay.unwatchPeer(peer.peerId);
+        currentReplicator().unwatchPeer(peer.peerId);
     }
 
     function sync() {
-        void p2p.targetedTransfer.synchroniseWithPeer(peer.peerId, false);
+        void currentReplicator().sync(peer.peerId, false);
     }
 
     function moreMenu(evt: MouseEvent) {

src/main.ts

@@ -39,7 +39,8 @@ import { useSetupProtocolFeature } from "./serviceFeatures/setupObsidian/setupPr
 import { useSetupQRCodeFeature } from "@/serviceFeatures/setupObsidian/qrCode";
 import { useSetupURIFeature } from "@/serviceFeatures/setupObsidian/setupUri";
 import { useSetupManagerHandlersFeature } from "./serviceFeatures/setupObsidian/setupManagerHandlers.ts";
-import { useP2PReplicatorCommands, useP2PReplicatorFeature } from "@vrtmrz/livesync-commonlib/p2p";
+import { useP2PReplicatorFeature } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/useP2PReplicatorFeature";
+import { useP2PReplicatorCommands } from "@vrtmrz/livesync-commonlib/compat/replication/trystero/useP2PReplicatorCommands";
 import { useP2PReplicatorUI } from "./serviceFeatures/useP2PReplicatorUI.ts";
 import { useReviewHarness } from "./serviceFeatures/useReviewHarness.ts";
 import { createOpenReplicationUI, createOpenRebuildUI } from "./features/P2PSync/P2PReplicator/P2PReplicationUI.ts";
@@ -183,7 +184,6 @@ export default class ObsidianLiveSyncPlugin extends Plugin {
                     createOpenReplicationUI(this.app),
                     createOpenRebuildUI(this.app)
                 );
-                setupManager.registerP2PSetupConnectionProbe(replicator.connectionProbe);
                 useP2PReplicatorCommands(core, replicator);
                 useP2PReplicatorUI(core, core, replicator);
                 useRemoteConfiguration(core);
@@ -201,6 +201,10 @@ export default class ObsidianLiveSyncPlugin extends Plugin {
                 );
                 waitForCompatibilityReview = () => compatibilityReview.openReview();
                 useReviewHarness(core, this, replicator, compatibilityReview);
+                // p2pReplicatorResult = useP2PReplicator(core, [
+                //     VIEW_TYPE_P2P,
+                //     (leaf: any) => new P2PReplicatorPaneView(leaf, core, p2pReplicatorResult!),
+                // ]);
             }
         );
     }

src/modules/core/ModulePeriodicProcess.ts

@@ -0,0 +1,41 @@
+import { PeriodicProcessor } from "@/common/PeriodicProcessor";
+import type { LiveSyncCore } from "@/main";
+import { AbstractModule } from "@/modules/AbstractModule";
+
+export class ModulePeriodicProcess extends AbstractModule {
+    periodicSyncProcessor = new PeriodicProcessor(this.core, async () => await this.services.replication.replicate());
+
+    disablePeriodic() {
+        this.periodicSyncProcessor?.disable();
+        return Promise.resolve(true);
+    }
+    resumePeriodic() {
+        this.periodicSyncProcessor.enable(
+            this.settings.periodicReplication ? this.settings.periodicReplicationInterval * 1000 : 0
+        );
+        return Promise.resolve(true);
+    }
+    private _allOnUnload() {
+        return this.disablePeriodic();
+    }
+    private _everyBeforeRealizeSetting(): Promise<boolean> {
+        return this.disablePeriodic();
+    }
+    private _everyBeforeSuspendProcess(): Promise<boolean> {
+        return this.disablePeriodic();
+    }
+    private _everyAfterResumeProcess(): Promise<boolean> {
+        return this.resumePeriodic();
+    }
+    private _everyAfterRealizeSetting(): Promise<boolean> {
+        return this.resumePeriodic();
+    }
+
+    override onBindFunction(core: LiveSyncCore, services: typeof core.services): void {
+        services.appLifecycle.onUnload.addHandler(this._allOnUnload.bind(this));
+        services.setting.onBeforeRealiseSetting.addHandler(this._everyBeforeRealizeSetting.bind(this));
+        services.setting.onSettingRealised.addHandler(this._everyAfterRealizeSetting.bind(this));
+        services.appLifecycle.onSuspending.addHandler(this._everyBeforeSuspendProcess.bind(this));
+        services.appLifecycle.onResumed.addHandler(this._everyAfterResumeProcess.bind(this));
+    }
+}

src/modules/core/ModuleReplicator.ts

@@ -0,0 +1,353 @@
+import type PouchDB from "pouchdb-core";
+import { fireAndForget } from "octagonal-wheels/promises";
+import { AbstractModule } from "@/modules/AbstractModule";
+import { Logger, LOG_LEVEL_NOTICE, LOG_LEVEL_INFO } from "octagonal-wheels/common/logger";
+import { skipIfDuplicated } from "octagonal-wheels/concurrency/lock";
+import { balanceChunkPurgedDBs } from "@vrtmrz/livesync-commonlib/compat/pouchdb/chunks";
+import { purgeUnreferencedChunks } from "@vrtmrz/livesync-commonlib/compat/pouchdb/chunks";
+import { LiveSyncCouchDBReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
+import {
+    type EntryDoc,
+    type ObsidianLiveSyncSettings,
+    type RemoteType,
+} from "@vrtmrz/livesync-commonlib/compat/common/types";
+
+import { scheduleTask } from "octagonal-wheels/concurrency/task";
+import { EVENT_FILE_SAVED, EVENT_SETTING_SAVED, eventHub } from "@/common/events";
+
+import { $msg } from "@/common/translation";
+import type { LiveSyncCore } from "@/main";
+import { ReplicateResultProcessor } from "./ReplicateResultProcessor";
+import { UnresolvedErrorManager } from "@vrtmrz/livesync-commonlib/compat/services/base/UnresolvedErrorManager";
+import { clearHandlers } from "@vrtmrz/livesync-commonlib/compat/replication/SyncParamsHandler";
+import type { NecessaryServices } from "@vrtmrz/livesync-commonlib/compat/interfaces/ServiceModule";
+import { MARK_LOG_NETWORK_ERROR } from "@vrtmrz/livesync-commonlib/compat/services/lib/logUtils";
+import { usesLegacyIndexedDBAdapter } from "@/common/compatibilitySettings.ts";
+
+function isOnlineAndCanReplicate(
+    errorManager: UnresolvedErrorManager,
+    host: NecessaryServices<"API", never>,
+    showMessage: boolean
+): Promise<boolean> {
+    const errorMessage = "Network is offline";
+    if (!host.services.API.isOnline) {
+        errorManager.showError(errorMessage, showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO);
+        return Promise.resolve(false);
+    }
+    errorManager.clearError(errorMessage);
+    return Promise.resolve(true);
+}
+async function canReplicateWithPBKDF2(
+    errorManager: UnresolvedErrorManager,
+    host: NecessaryServices<"replicator" | "setting", never>,
+    showMessage: boolean
+): Promise<boolean> {
+    const currentSettings = host.services.setting.currentSettings();
+    // TODO: check using PBKDF2 salt?
+    const errorMessage = $msg("Replicator.Message.InitialiseFatalError");
+    const replicator = host.services.replicator.getActiveReplicator();
+    if (!replicator) {
+        errorManager.showError(errorMessage, showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO);
+        return false;
+    }
+    errorManager.clearError(errorMessage);
+    // Showing message is false: that because be shown here. (And it is a fatal error, no way to hide it).
+    // tagged as network error at beginning for error filtering with NetworkWarningStyles
+    const ensureMessage = `${MARK_LOG_NETWORK_ERROR}Failed to initialise the encryption key, preventing replication.`;
+    // A remote database rebuild replaces the Security Seed while this process may still hold the previous one.
+    const ensureResult = await replicator.ensurePBKDF2Salt(currentSettings, showMessage, false);
+    if (!ensureResult) {
+        errorManager.showError(ensureMessage, showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO);
+        return false;
+    }
+    errorManager.clearError(ensureMessage);
+    return ensureResult; // is true.
+}
+
+export class ModuleReplicator extends AbstractModule {
+    _replicatorType?: RemoteType;
+
+    processor: ReplicateResultProcessor = new ReplicateResultProcessor(this);
+    private _unresolvedErrorManager: UnresolvedErrorManager = new UnresolvedErrorManager(
+        this.core.services.appLifecycle,
+        this.core.services.context.events
+    );
+
+    clearErrors() {
+        this._unresolvedErrorManager.clearErrors();
+    }
+
+    private _normalFileReflectionFilterSignature: string | undefined;
+
+    private getNormalFileReflectionFilterSignature(
+        settings: Pick<
+            ObsidianLiveSyncSettings,
+            | "handleFilenameCaseSensitive"
+            | "ignoreFiles"
+            | "maxMTimeForReflectEvents"
+            | "syncIgnoreRegEx"
+            | "syncInternalFiles"
+            | "syncMaxSizeInMB"
+            | "syncOnlyRegEx"
+            | "useIgnoreFiles"
+        >
+    ): string {
+        return JSON.stringify({
+            handleFilenameCaseSensitive: settings.handleFilenameCaseSensitive ?? false,
+            ignoreFiles: settings.ignoreFiles ?? "",
+            maxMTimeForReflectEvents: settings.maxMTimeForReflectEvents ?? 0,
+            syncIgnoreRegEx: settings.syncIgnoreRegEx ?? "",
+            syncInternalFiles: settings.syncInternalFiles ?? false,
+            syncMaxSizeInMB: settings.syncMaxSizeInMB ?? 0,
+            syncOnlyRegEx: settings.syncOnlyRegEx ?? "",
+            useIgnoreFiles: settings.useIgnoreFiles ?? false,
+        });
+    }
+
+    private _everyOnloadAfterLoadSettings(): Promise<boolean> {
+        this._normalFileReflectionFilterSignature = this.getNormalFileReflectionFilterSignature(this.settings);
+        eventHub.onEvent(EVENT_FILE_SAVED, () => {
+            if (this.settings.syncOnSave && !this.core.services.appLifecycle.isSuspended()) {
+                scheduleTask("perform-replicate-after-save", 250, () => this.services.replication.replicateByEvent());
+            }
+        });
+        eventHub.onEvent(EVENT_SETTING_SAVED, (setting) => {
+            const previousReflectionFilter = this._normalFileReflectionFilterSignature;
+            const nextReflectionFilter = this.getNormalFileReflectionFilterSignature(setting);
+            this._normalFileReflectionFilterSignature = nextReflectionFilter;
+            if (this.core.settings.suspendParseReplicationResult) {
+                this.processor.suspend();
+            } else {
+                this.processor.resume();
+            }
+            if (previousReflectionFilter !== undefined && previousReflectionFilter !== nextReflectionFilter) {
+                fireAndForget(() => this.processor.reprocessStoredDocuments());
+            }
+        });
+
+        return Promise.resolve(true);
+    }
+
+    _onReplicatorInitialised(): Promise<boolean> {
+        // For now, we only need to clear the error related to replicator initialisation, but in the future, if there are more things to do when the replicator is initialised, we can add them here.
+        clearHandlers();
+        return Promise.resolve(true);
+    }
+
+    _everyOnDatabaseInitialized(showNotice: boolean): Promise<boolean> {
+        fireAndForget(() => this.processor.restoreFromSnapshotOnce());
+        return Promise.resolve(true);
+    }
+
+    async _everyBeforeReplicate(showMessage: boolean): Promise<boolean> {
+        await this.processor.restoreFromSnapshotOnce();
+        this.clearErrors();
+        return true;
+    }
+
+    /**
+     * Reconciles an IndexedDB-backed local database after replication reports that the remote was cleaned.
+     *
+     * The remote milestone remains a supported compatibility signal. The user can either fetch the remote
+     * database again, or purge unreferenced local chunks before accepting this device again.
+     *
+     * @param showMessage Whether to show the recovery choices as user-facing notices.
+     */
+    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) {
+                await this.services.replicator.runBoundedRemoteActivity(
+                    async () => {
+                        const replicator = this.services.replicator.getActiveReplicator();
+                        if (!(replicator instanceof LiveSyncCouchDBReplicator)) return;
+                        const remoteDB = await replicator.connectRemoteCouchDBWithSetting(
+                            this.settings,
+                            this.services.API.isMobile(),
+                            true
+                        );
+                        if (typeof remoteDB == "string") {
+                            Logger(remoteDB, LOG_LEVEL_NOTICE);
+                            return false;
+                        }
+
+                        try {
+                            await purgeUnreferencedChunks(this.localDatabase.localDatabase, false);
+                            this.localDatabase.clearCaches();
+                            // Perform the synchronisation once.
+                            const replicated = await this.services.replicator.runFiniteReplicationActivity(
+                                () => this.core.replicator.openReplication(this.settings, false, showMessage, true),
+                                { label: "replication" }
+                            );
+                            if (replicated) {
+                                await balanceChunkPurgedDBs(this.localDatabase.localDatabase, remoteDB.db);
+                                await purgeUnreferencedChunks(this.localDatabase.localDatabase, false);
+                                this.localDatabase.clearCaches();
+                                await this.services.replicator.getActiveReplicator()?.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
+                                );
+                            }
+                        } finally {
+                            await remoteDB.db.close();
+                        }
+                    },
+                    { label: "database-cleanup" }
+                );
+            }
+        });
+    }
+
+    private async onReplicationFailed(showMessage: boolean = false): Promise<boolean> {
+        const activeReplicator = this.services.replicator.getActiveReplicator();
+        if (!activeReplicator) {
+            Logger(`No active replicator found`, LOG_LEVEL_INFO);
+            return false;
+        }
+        if (activeReplicator.tweakSettingsMismatched && activeReplicator.preferredTweakValue) {
+            await this.services.tweakValue.askResolvingMismatched(activeReplicator.preferredTweakValue);
+        } else {
+            if (activeReplicator.remoteLockedAndDeviceNotAccepted) {
+                if (activeReplicator.remoteCleaned && usesLegacyIndexedDBAdapter(this.settings)) {
+                    await this.cleaned(showMessage);
+                } else {
+                    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_UNLOCK, CHOICE_DISMISS],
+                        {
+                            title: $msg("Replicator.Dialogue.Locked.Title"),
+                            defaultAction: CHOICE_DISMISS,
+                            timeout: 60,
+                        }
+                    );
+                    if (ret == CHOICE_FETCH) {
+                        this._log($msg("Replicator.Dialogue.Locked.Message.Fetch"), LOG_LEVEL_NOTICE);
+                        await this.core.rebuilder.scheduleFetch();
+                        this.services.appLifecycle.scheduleRestart();
+                        return false;
+                    } else if (ret == CHOICE_UNLOCK) {
+                        await activeReplicator.markRemoteResolved(this.settings);
+                        this._log($msg("Replicator.Dialogue.Locked.Message.Unlocked"), LOG_LEVEL_NOTICE);
+                        return false;
+                    }
+                }
+            }
+        }
+        // TODO: Check again and true/false return. This will be the result for performReplication.
+        return false;
+    }
+
+    // private async _replicateByEvent(): Promise<boolean | void> {
+    //     const least = this.settings.syncMinimumInterval;
+    //     if (least > 0) {
+    //         return rateLimitedSharedExecution(KEY_REPLICATION_ON_EVENT, least, async () => {
+    //             return await this.services.replication.replicate();
+    //         });
+    //     }
+    //     return await shareRunningResult(`replication`, () => this.services.replication.replicate());
+    // }
+
+    _parseReplicationResult(docs: Array<PouchDB.Core.ExistingDocument<EntryDoc>>): Promise<boolean> {
+        this.processor.enqueueAll(docs);
+        return Promise.resolve(true);
+    }
+
+    // _everyBeforeSuspendProcess(): Promise<boolean> {
+    //     this.core.replicator?.closeReplication();
+    //     return Promise.resolve(true);
+    // }
+
+    // private async _replicateAllToServer(
+    //     showingNotice: boolean = false,
+    //     sendChunksInBulkDisabled: boolean = false
+    // ): Promise<boolean> {
+    //     if (!this.services.appLifecycle.isReady()) return false;
+    //     if (!(await this.services.replication.onBeforeReplicate(showingNotice))) {
+    //         Logger($msg("Replicator.Message.SomeModuleFailed"), LOG_LEVEL_NOTICE);
+    //         return false;
+    //     }
+    //     if (!sendChunksInBulkDisabled) {
+    //         if (this.core.replicator instanceof LiveSyncCouchDBReplicator) {
+    //             if (
+    //                 (await this.core.confirm.askYesNoDialog("Do you want to send all chunks before replication?", {
+    //                     defaultOption: "No",
+    //                     timeout: 20,
+    //                 })) == "yes"
+    //             ) {
+    //                 await this.core.replicator.sendChunks(this.core.settings, undefined, true, 0);
+    //             }
+    //         }
+    //     }
+    //     const ret = await this.core.replicator.replicateAllToServer(this.settings, showingNotice);
+    //     if (ret) return true;
+    //     const checkResult = await this.services.replication.checkConnectionFailure();
+    //     if (checkResult == "CHECKAGAIN") return await this.services.remote.replicateAllToRemote(showingNotice);
+    //     return !checkResult;
+    // }
+    // async _replicateAllFromServer(showingNotice: boolean = false): Promise<boolean> {
+    //     if (!this.services.appLifecycle.isReady()) return false;
+    //     const ret = await this.core.replicator.replicateAllFromServer(this.settings, showingNotice);
+    //     if (ret) return true;
+    //     const checkResult = await this.services.replication.checkConnectionFailure();
+    //     if (checkResult == "CHECKAGAIN") return await this.services.remote.replicateAllFromRemote(showingNotice);
+    //     return !checkResult;
+    // }
+
+    override onBindFunction(core: LiveSyncCore, services: typeof core.services): void {
+        services.replicator.onReplicatorInitialised.addHandler(this._onReplicatorInitialised.bind(this));
+        services.databaseEvents.onDatabaseInitialised.addHandler(this._everyOnDatabaseInitialized.bind(this));
+        services.appLifecycle.onSettingLoaded.addHandler(this._everyOnloadAfterLoadSettings.bind(this));
+        services.replication.parseSynchroniseResult.addHandler(this._parseReplicationResult.bind(this));
+
+        // --> These handlers can be separated.
+        const isOnlineAndCanReplicateWithHost = isOnlineAndCanReplicate.bind(null, this._unresolvedErrorManager, {
+            services: {
+                context: services.context,
+                API: services.API,
+            },
+            serviceModules: {},
+        });
+        const canReplicateWithPBKDF2WithHost = canReplicateWithPBKDF2.bind(null, this._unresolvedErrorManager, {
+            services: {
+                context: services.context,
+                replicator: services.replicator,
+                setting: services.setting,
+            },
+            serviceModules: {},
+        });
+        services.replication.onBeforeReplicate.addHandler(isOnlineAndCanReplicateWithHost, 10);
+        services.replication.onBeforeReplicate.addHandler(canReplicateWithPBKDF2WithHost, 20);
+        // <-- End of handlers that can be separated.
+        services.replication.onBeforeReplicate.addHandler(this._everyBeforeReplicate.bind(this), 100);
+        services.replication.onReplicationFailed.addHandler(this.onReplicationFailed.bind(this));
+    }
+}

src/modules/core/ModuleReplicator.unit.spec.ts

@@ -0,0 +1,188 @@
+import { describe, expect, it, vi } from "vitest";
+import { createServiceContext } from "@vrtmrz/livesync-commonlib/context";
+import { EVENT_SETTING_SAVED, eventHub } from "@/common/events";
+import type { ObsidianLiveSyncSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
+
+const chunkMocks = vi.hoisted(() => ({
+    purgeUnreferencedChunks: vi.fn(async (_db: unknown, countOnly: boolean) => (countOnly ? 2 : 0)),
+    balanceChunkPurgedDBs: vi.fn(async () => undefined),
+}));
+
+vi.mock("@vrtmrz/livesync-commonlib/compat/pouchdb/chunks", () => chunkMocks);
+vi.mock("@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator", () => ({
+    LiveSyncCouchDBReplicator: class {},
+}));
+
+import { LiveSyncCouchDBReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
+import { ModuleReplicator } from "./ModuleReplicator";
+
+describe("ModuleReplicator", () => {
+    it("refreshes the remote Security Seed before replication", async () => {
+        const ensurePBKDF2Salt = vi.fn(async () => true);
+        let beforeReplicate: ((showMessage: boolean) => Promise<boolean>) | undefined;
+        const addHandler = vi.fn((handler: (showMessage: boolean) => Promise<boolean>, priority?: number) => {
+            if (priority === 20) {
+                beforeReplicate = handler;
+            }
+        });
+        const services = {
+            API: { isOnline: true },
+            replicator: {
+                onReplicatorInitialised: { addHandler: vi.fn() },
+                getActiveReplicator: () => ({ ensurePBKDF2Salt }),
+            },
+            setting: { currentSettings: () => ({}) },
+            databaseEvents: { onDatabaseInitialised: { addHandler: vi.fn() } },
+            appLifecycle: { onSettingLoaded: { addHandler: vi.fn() } },
+            replication: {
+                parseSynchroniseResult: { addHandler: vi.fn() },
+                onBeforeReplicate: { addHandler },
+                onReplicationFailed: { addHandler: vi.fn() },
+            },
+        };
+        const module = {
+            _unresolvedErrorManager: {
+                showError: vi.fn(),
+                clearError: vi.fn(),
+            },
+            _onReplicatorInitialised: vi.fn(),
+            _everyOnDatabaseInitialized: vi.fn(),
+            _everyOnloadAfterLoadSettings: vi.fn(),
+            _parseReplicationResult: vi.fn(),
+            _everyBeforeReplicate: vi.fn(),
+            onReplicationFailed: vi.fn(),
+        };
+
+        ModuleReplicator.prototype.onBindFunction.call(module, {} as never, services as never);
+        expect(beforeReplicate).toBeDefined();
+
+        await beforeReplicate!(false);
+
+        expect(ensurePBKDF2Salt).toHaveBeenCalledWith({}, false, false);
+    });
+
+    it("reprocesses stored documents when the normal-file target filters change", async () => {
+        eventHub.offAll();
+        const settings = {
+            handleFilenameCaseSensitive: false,
+            ignoreFiles: ".gitignore",
+            maxMTimeForReflectEvents: 0,
+            syncOnlyRegEx: "^E2E/allowed/.*",
+            syncIgnoreRegEx: "",
+            syncInternalFiles: false,
+            syncMaxSizeInMB: 0,
+            suspendParseReplicationResult: false,
+            useIgnoreFiles: false,
+        } as ObsidianLiveSyncSettings;
+        const services = {
+            context: createServiceContext(),
+            API: {
+                addLog: vi.fn(),
+                addCommand: vi.fn(),
+                registerWindow: vi.fn(),
+                addRibbonIcon: vi.fn(),
+                registerProtocolHandler: vi.fn(),
+            },
+            appLifecycle: {
+                getUnresolvedMessages: { addHandler: vi.fn() },
+                isSuspended: vi.fn(() => false),
+            },
+        };
+        const core = {
+            _services: services,
+            services,
+            settings,
+        } as any;
+        const module = new ModuleReplicator(core);
+        const reprocessStoredDocuments = vi.fn(async () => 1);
+        Object.assign(module.processor, { reprocessStoredDocuments });
+
+        try {
+            await (module as any)._everyOnloadAfterLoadSettings();
+            eventHub.emitEvent(EVENT_SETTING_SAVED, { ...settings });
+            await Promise.resolve();
+            expect(reprocessStoredDocuments).not.toHaveBeenCalled();
+
+            Object.assign(settings, { syncOnlyRegEx: "" });
+            eventHub.emitEvent(EVENT_SETTING_SAVED, { ...settings });
+            await vi.waitFor(() => expect(reprocessStoredDocuments).toHaveBeenCalledOnce());
+
+            settings.syncMaxSizeInMB = 10;
+            eventHub.emitEvent(EVENT_SETTING_SAVED, { ...settings });
+            await vi.waitFor(() => expect(reprocessStoredDocuments).toHaveBeenCalledTimes(2));
+        } finally {
+            eventHub.offAll();
+        }
+    });
+});
+
+describe("compatibility: cleaned-remote reconciliation for IndexedDB clients", () => {
+    it("keeps its finite replication and balancing work inside the shared activity boundary", async () => {
+        const activityFinished = vi.fn();
+        const runBoundedRemoteActivity = vi.fn(async (task: () => unknown) => {
+            try {
+                return await task();
+            } finally {
+                activityFinished();
+            }
+        });
+        const runFiniteReplicationActivity = vi.fn(async (task: () => unknown) => await task());
+        const openReplication = vi.fn(async () => true);
+        const remoteDatabase = {
+            close: vi.fn(async () => undefined),
+        };
+        const activeReplicator = Object.assign(new LiveSyncCouchDBReplicator({} as any), {
+            connectRemoteCouchDBWithSetting: vi.fn(async () => ({ db: remoteDatabase })),
+            markRemoteResolved: vi.fn(async () => undefined),
+        });
+        const services = {
+            context: createServiceContext(),
+            API: {
+                addLog: vi.fn(),
+                addCommand: vi.fn(),
+                registerWindow: vi.fn(),
+                addRibbonIcon: vi.fn(),
+                registerProtocolHandler: vi.fn(),
+                isMobile: vi.fn(() => false),
+            },
+            setting: { saveSettingData: vi.fn(async () => undefined) },
+            appLifecycle: {
+                getUnresolvedMessages: { addHandler: vi.fn() },
+            },
+            replicator: {
+                getActiveReplicator: vi.fn(() => activeReplicator),
+                runBoundedRemoteActivity,
+                runFiniteReplicationActivity,
+            },
+        };
+        const localDatabase = {
+            localDatabase: {},
+            clearCaches: vi.fn(),
+        };
+        const core = {
+            _services: services,
+            services,
+            settings: {},
+            localDatabase,
+            confirm: { confirmWithMessage: vi.fn(async () => "Cleanup") },
+            replicator: { openReplication },
+        } as any;
+        const module = new ModuleReplicator(core);
+
+        await module.cleaned(true);
+
+        expect(runBoundedRemoteActivity).toHaveBeenCalledWith(expect.any(Function), {
+            label: "database-cleanup",
+        });
+        expect(runFiniteReplicationActivity).toHaveBeenCalledWith(expect.any(Function), {
+            label: "replication",
+        });
+        expect(openReplication).toHaveBeenCalledOnce();
+        expect(openReplication.mock.invocationCallOrder[0]).toBeLessThan(activityFinished.mock.invocationCallOrder[0]);
+        expect(chunkMocks.balanceChunkPurgedDBs).toHaveBeenCalledOnce();
+        expect(remoteDatabase.close).toHaveBeenCalledOnce();
+        expect(remoteDatabase.close.mock.invocationCallOrder[0]).toBeLessThan(
+            activityFinished.mock.invocationCallOrder[0]
+        );
+    });
+});

src/modules/core/ModuleReplicatorCouchDB.ts

@@ -0,0 +1,50 @@
+import { fireAndForget } from "octagonal-wheels/promises";
+import { REMOTE_MINIO, REMOTE_P2P, type RemoteDBSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
+import { LiveSyncCouchDBReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
+import type { LiveSyncAbstractReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/LiveSyncAbstractReplicator";
+import { AbstractModule } from "@/modules/AbstractModule";
+import type { LiveSyncCore } from "@/main";
+
+export class ModuleReplicatorCouchDB extends AbstractModule {
+    _anyNewReplicator(settingOverride: Partial<RemoteDBSettings> = {}): Promise<LiveSyncAbstractReplicator | false> {
+        const settings = { ...this.settings, ...settingOverride };
+        // If new remote types were added, add them here. Do not use `REMOTE_COUCHDB` directly for the safety valve.
+        if (settings.remoteType == REMOTE_MINIO || settings.remoteType == REMOTE_P2P) {
+            return Promise.resolve(false);
+        }
+        return Promise.resolve(new LiveSyncCouchDBReplicator(this.core));
+    }
+    _everyAfterResumeProcess(): Promise<boolean> {
+        if (this.services.appLifecycle.isSuspended()) return Promise.resolve(true);
+        if (!this.services.appLifecycle.isReady()) return Promise.resolve(true);
+        if (this.settings.remoteType != REMOTE_MINIO && this.settings.remoteType != REMOTE_P2P) {
+            const LiveSyncEnabled = this.settings.liveSync;
+            const continuous = LiveSyncEnabled;
+            const eventualOnStart = !LiveSyncEnabled && this.settings.syncOnStart;
+            // If enabled LiveSync or on start, open replication
+            if (LiveSyncEnabled || eventualOnStart) {
+                // And note that we do not open the conflict detection dialogue directly during this process.
+                // This should be raised explicitly if needed.
+                fireAndForget(async () => {
+                    const canReplicate = await this.services.replication.isReplicationReady(false);
+                    if (!canReplicate) return;
+                    const openReplication = () =>
+                        this.core.replicator.openReplication(this.settings, continuous, false, false);
+                    if (continuous) {
+                        void openReplication();
+                    } else {
+                        await this.services.replicator.runFiniteReplicationActivity(openReplication, {
+                            label: "replication",
+                        });
+                    }
+                });
+            }
+        }
+
+        return Promise.resolve(true);
+    }
+    override onBindFunction(core: LiveSyncCore, services: typeof core.services): void {
+        services.replicator.getNewReplicator.addHandler(this._anyNewReplicator.bind(this));
+        services.appLifecycle.onResumed.addHandler(this._everyAfterResumeProcess.bind(this));
+    }
+}

src/modules/core/ModuleReplicatorCouchDB.unit.spec.ts

@@ -0,0 +1,89 @@
+import { describe, expect, it, vi } from "vitest";
+import { ModuleReplicatorCouchDB } from "./ModuleReplicatorCouchDB.ts";
+
+function createModule(settings: { liveSync: boolean; syncOnStart: boolean }, isReplicationReady = true) {
+    const openReplication = vi.fn(async () => true);
+    const runFiniteReplicationActivity = vi.fn(async (task: () => unknown) => await task());
+    const services = {
+        API: {
+            addLog: vi.fn(),
+            addCommand: vi.fn(),
+            registerWindow: vi.fn(),
+            addRibbonIcon: vi.fn(),
+            registerProtocolHandler: vi.fn(),
+        },
+        appLifecycle: {
+            isSuspended: vi.fn(() => false),
+            isReady: vi.fn(() => true),
+        },
+        replication: {
+            isReplicationReady: vi.fn(async () => isReplicationReady),
+        },
+        replicator: {
+            runFiniteReplicationActivity,
+        },
+        setting: {
+            saveSettingData: vi.fn(async () => undefined),
+        },
+    };
+    const core = {
+        _services: services,
+        services,
+        settings: {
+            remoteType: "",
+            ...settings,
+        },
+        replicator: { openReplication },
+    } as any;
+    return {
+        module: new ModuleReplicatorCouchDB(core),
+        openReplication,
+        runFiniteReplicationActivity,
+    };
+}
+
+describe("ModuleReplicatorCouchDB resume replication activity", () => {
+    it("exposes start-up one-shot replication as finite replication activity", async () => {
+        const { module, openReplication, runFiniteReplicationActivity } = createModule({
+            liveSync: false,
+            syncOnStart: true,
+        });
+
+        await module._everyAfterResumeProcess();
+
+        await vi.waitFor(() => expect(openReplication).toHaveBeenCalledOnce());
+        expect(runFiniteReplicationActivity).toHaveBeenCalledWith(expect.any(Function), {
+            label: "replication",
+        });
+        expect(openReplication).toHaveBeenCalledWith(expect.any(Object), false, false, false);
+    });
+
+    it("does not wrap the unbounded continuous channel in another finite activity", async () => {
+        const { module, openReplication, runFiniteReplicationActivity } = createModule({
+            liveSync: true,
+            syncOnStart: false,
+        });
+
+        await module._everyAfterResumeProcess();
+
+        await vi.waitFor(() => expect(openReplication).toHaveBeenCalledOnce());
+        expect(runFiniteReplicationActivity).not.toHaveBeenCalled();
+        expect(openReplication).toHaveBeenCalledWith(expect.any(Object), true, false, false);
+    });
+
+    it("does not start a one-shot activity when start-up readiness fails", async () => {
+        const { module, openReplication, runFiniteReplicationActivity } = createModule(
+            {
+                liveSync: false,
+                syncOnStart: true,
+            },
+            false
+        );
+
+        await module._everyAfterResumeProcess();
+        await new Promise((resolve) => setTimeout(resolve, 0));
+
+        expect(runFiniteReplicationActivity).not.toHaveBeenCalled();
+        expect(openReplication).not.toHaveBeenCalled();
+    });
+});

src/modules/core/ModuleReplicatorMinIO.ts

@@ -0,0 +1,18 @@
+import { REMOTE_MINIO, type RemoteDBSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
+import { LiveSyncJournalReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/journal/LiveSyncJournalReplicator";
+import type { LiveSyncAbstractReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/LiveSyncAbstractReplicator";
+import type { LiveSyncCore } from "@/main";
+import { AbstractModule } from "@/modules/AbstractModule";
+
+export class ModuleReplicatorMinIO extends AbstractModule {
+    _anyNewReplicator(settingOverride: Partial<RemoteDBSettings> = {}): Promise<LiveSyncAbstractReplicator | false> {
+        const settings = { ...this.settings, ...settingOverride };
+        if (settings.remoteType == REMOTE_MINIO) {
+            return Promise.resolve(new LiveSyncJournalReplicator(this.core));
+        }
+        return Promise.resolve(false);
+    }
+    override onBindFunction(core: LiveSyncCore, services: typeof core.services): void {
+        services.replicator.getNewReplicator.addHandler(this._anyNewReplicator.bind(this));
+    }
+}

src/modules/core/ReplicateResultProcessor.ts

@@ -6,8 +6,8 @@ import {
     type EntryLeaf,
     type LoadedEntry,
     type MetaEntry,
-    type ObsidianLiveSyncSettings,
 } from "@vrtmrz/livesync-commonlib/compat/common/types";
+import type { ModuleReplicator } from "./ModuleReplicator";
 import { isChunk } from "@vrtmrz/livesync-commonlib/compat/common/typeUtils";
 import {
     LOG_LEVEL_DEBUG,
@@ -28,39 +28,12 @@ import { promiseWithResolvers, type PromiseWithResolvers } from "octagonal-wheel
 
 const KV_KEY_REPLICATION_RESULT_PROCESSOR_SNAPSHOT = "replicationResultProcessorSnapshot";
 const REPROCESS_BATCH_SIZE = 100;
-type ReplicateResultProcessorSettings = Pick<
-    ObsidianLiveSyncSettings,
-    "maxMTimeForReflectEvents" | "suspendParseReplicationResult"
->;
-type ReplicateResultProcessorServices = Pick<
-    LiveSyncBaseCore["services"],
-    "appLifecycle" | "path" | "replication" | "vault"
->;
-
-/**
- * Narrow collaborators for applying replicated documents.
- *
- * `requestActiveReplicatorRetirement` starts the owner transition without
- * awaiting it. Result application can still be running inside work admitted by
- * that owner, so awaiting retirement here could make each side wait for the
- * other to finish.
- *
- * Runtime databases are deliberately obtained through operation-time
- * accessors. Feature composition precedes their initialisation, and database
- * reset may replace their backing instances, so retaining an earlier concrete
- * database would be invalid.
- */
-interface ReplicateResultProcessorContext {
-    readonly currentSettings: () => ReplicateResultProcessorSettings;
-    readonly getKeyValueDB: () => LiveSyncBaseCore["kvDB"];
-    readonly getLocalDatabase: () => LiveSyncBaseCore["localDatabase"];
-    readonly requestActiveReplicatorRetirement: () => void;
-    readonly runLocalApplicationActivity: <T>(
+type LocalApplicationActivityOwner = {
+    runBoundedLocalApplicationActivity<T>(
         task: () => T | PromiseLike<T>,
         options?: { label?: string }
-    ) => Promise<T>;
-    readonly services: ReplicateResultProcessorServices;
-}
+    ): Promise<T>;
+};
 type ReplicateResultProcessorState = {
     queued: PouchDB.Core.ExistingDocument<EntryDoc>[];
     processing: PouchDB.Core.ExistingDocument<EntryDoc>[];
@@ -79,13 +52,20 @@ export class ReplicateResultProcessor {
     private logError(e: unknown) {
         Logger(e, LOG_LEVEL_VERBOSE);
     }
-    constructor(private readonly context: ReplicateResultProcessorContext) {}
+    private replicator: ModuleReplicator;
 
-    private get localDatabase() {
-        return this.context.getLocalDatabase();
+    constructor(replicator: ModuleReplicator) {
+        this.replicator = replicator;
     }
-    private get services() {
-        return this.context.services;
+
+    get localDatabase() {
+        return this.replicator.core.localDatabase;
+    }
+    get services() {
+        return this.replicator.core.services;
+    }
+    get core(): LiveSyncBaseCore {
+        return this.replicator.core;
     }
 
     getPath(entry: AnyEntry): string {
@@ -109,9 +89,9 @@ export class ReplicateResultProcessor {
     public get isSuspended() {
         return (
             this._suspended ||
-            !this.services.appLifecycle.isReady ||
-            this.context.currentSettings().suspendParseReplicationResult ||
-            this.services.appLifecycle.isSuspended()
+            !this.core.services.appLifecycle.isReady ||
+            this.replicator.settings.suspendParseReplicationResult ||
+            this.core.services.appLifecycle.isSuspended()
         );
     }
 
@@ -124,7 +104,7 @@ export class ReplicateResultProcessor {
             queued: this._queuedChanges.slice(),
             processing: this._processingChanges.slice(),
         } satisfies ReplicateResultProcessorState;
-        await this.context.getKeyValueDB().set(KV_KEY_REPLICATION_RESULT_PROCESSOR_SNAPSHOT, snapshot);
+        await this.core.kvDB.set(KV_KEY_REPLICATION_RESULT_PROCESSOR_SNAPSHOT, snapshot);
         this.log(
             `Snapshot taken. Queued: ${snapshot.queued.length}, Processing: ${snapshot.processing.length}`,
             LOG_LEVEL_DEBUG
@@ -146,9 +126,9 @@ export class ReplicateResultProcessor {
      * Restore from snapshot.
      */
     public async restoreFromSnapshot() {
-        const snapshot = await this.context
-            .getKeyValueDB()
-            .get<ReplicateResultProcessorState>(KV_KEY_REPLICATION_RESULT_PROCESSOR_SNAPSHOT);
+        const snapshot = await this.core.kvDB.get<ReplicateResultProcessorState>(
+            KV_KEY_REPLICATION_RESULT_PROCESSOR_SNAPSHOT
+        );
         if (snapshot) {
             // Restoring the snapshot re-runs processing for both queued and processing items.
             const newQueue = [...snapshot.processing, ...snapshot.queued, ...this._queuedChanges];
@@ -251,8 +231,8 @@ export class ReplicateResultProcessor {
         if (change.type == "versioninfo") {
             this.log(`Version info document received: ${change._id}`, LOG_LEVEL_VERBOSE);
             if (change.version > VER) {
-                // Fence and retire the active publication through its owner.
-                this.context.requestActiveReplicatorRetirement();
+                // Incompatible version, stop replication.
+                this.core.replicator.closeReplication();
                 this.log(
                     `Remote database updated to incompatible version. update your Self-hosted LiveSync plugin.`,
                     LOG_LEVEL_NOTICE
@@ -297,10 +277,15 @@ export class ReplicateResultProcessor {
 
         const activityDone = promiseWithResolvers<void>();
         this._processingActivityDone = activityDone;
-        this._processingActivity = this.context
-            .runLocalApplicationActivity(() => activityDone.promise, {
-                label: "replicated-document-application",
-            })
+        const activityOwner = this.services.replicator as typeof this.services.replicator &
+            Partial<LocalApplicationActivityOwner>;
+        this._processingActivity = (
+            activityOwner.runBoundedLocalApplicationActivity
+                ? activityOwner.runBoundedLocalApplicationActivity(() => activityDone.promise, {
+                      label: "replicated-document-application",
+                  })
+                : activityDone.promise
+        )
             .catch((error) => this.logError(error))
             .finally(() => {
                 if (this._processingActivityDone === activityDone) this._processingActivityDone = undefined;
@@ -407,7 +392,7 @@ export class ReplicateResultProcessor {
         try {
             if (isAnyNote(change)) {
                 const docMtime = change.mtime ?? 0;
-                const maxMTime = this.context.currentSettings().maxMTimeForReflectEvents;
+                const maxMTime = this.replicator.settings.maxMTimeForReflectEvents;
                 if (maxMTime > 0 && docMtime > maxMTime) {
                     const docPath = this.getPath(change);
                     this.log(

src/modules/core/ReplicateResultProcessor.unit.spec.ts

@@ -1,7 +1,7 @@
 import { promiseWithResolvers } from "octagonal-wheels/promises";
 import { reactiveSource } from "octagonal-wheels/dataobject/reactive";
 import { describe, expect, it, vi } from "vitest";
-import { VER, type EntryDoc } from "@vrtmrz/livesync-commonlib/compat/common/types";
+import type { EntryDoc } from "@vrtmrz/livesync-commonlib/compat/common/types";
 import { ReplicateResultProcessor } from "./ReplicateResultProcessor";
 
 function note(id: string): PouchDB.Core.ExistingDocument<EntryDoc> {
@@ -28,7 +28,6 @@ function setup(options: SetupOptions = {}) {
     const processSynchroniseResult = vi.fn(options.processSynchroniseResult ?? (async () => undefined));
     const setSnapshot = vi.fn(options.setSnapshot ?? (async () => undefined));
     const runBoundedLocalApplicationActivity = vi.fn(async (task: () => Promise<void>) => await task());
-    const onCloseActiveReplication = vi.fn(async () => true);
     const core = {
         services: {
             appLifecycle: { isReady: true, isSuspended: () => false },
@@ -41,7 +40,7 @@ function setup(options: SetupOptions = {}) {
                 processOptionalSynchroniseResult: vi.fn(async () => false),
                 processSynchroniseResult,
             },
-            replicator: { onCloseActiveReplication, runBoundedLocalApplicationActivity },
+            replicator: { runBoundedLocalApplicationActivity },
             vault: {
                 isTargetFile: vi.fn(async () => true),
                 isFileSizeTooLarge: vi.fn(() => false),
@@ -53,40 +52,16 @@ function setup(options: SetupOptions = {}) {
             getRaw: vi.fn(async (id: string) => ({ _id: id, _rev: "1-test" })),
             getDBEntryFromMeta: vi.fn(async (entry: object) => ({ ...entry, data: "x" })),
         },
+        replicator: { closeReplication: vi.fn() },
     };
     const processor = new ReplicateResultProcessor({
-        currentSettings: () => ({ maxMTimeForReflectEvents: 0, suspendParseReplicationResult: false }),
-        getKeyValueDB: () => core.kvDB,
-        getLocalDatabase: () => core.localDatabase,
-        requestActiveReplicatorRetirement: () => {
-            void onCloseActiveReplication();
-        },
-        runLocalApplicationActivity: runBoundedLocalApplicationActivity,
-        services: core.services,
+        core,
+        settings: { maxMTimeForReflectEvents: 0, suspendParseReplicationResult: false },
     } as never);
-    return {
-        onCloseActiveReplication,
-        processor,
-        processSynchroniseResult,
-        runBoundedLocalApplicationActivity,
-    };
+    return { processor, processSynchroniseResult, runBoundedLocalApplicationActivity };
 }
 
 describe("ReplicateResultProcessor", () => {
-    it("retires active ownership when a newer remote version is observed", async () => {
-        const { onCloseActiveReplication, processor } = setup();
-        const versionInfo = {
-            _id: "versioninfo",
-            _rev: "1-test",
-            type: "versioninfo",
-            version: VER + 1,
-        } as unknown as PouchDB.Core.ExistingDocument<EntryDoc>;
-
-        processor.enqueueAll([versionInfo]);
-
-        await vi.waitFor(() => expect(onCloseActiveReplication).toHaveBeenCalledOnce());
-    });
-
     it("scans normal-file metadata without loading chunk documents and requeues it", async () => {
         const documents = [
             { _id: "first", _rev: "1-a", type: "plain", path: "first.md" },
@@ -95,16 +70,14 @@ describe("ReplicateResultProcessor", () => {
         const findAllNormalDocs = vi.fn(async function* () {
             yield* documents;
         });
-        const getLocalDatabase = vi.fn(() => ({ findAllNormalDocs }));
         const processor = new ReplicateResultProcessor({
-            getLocalDatabase,
+            core: { localDatabase: { findAllNormalDocs } },
         } as never);
         const enqueueAll = vi.spyOn(processor, "enqueueAll").mockImplementation(() => undefined);
 
         await expect(processor.reprocessStoredDocuments()).resolves.toBe(2);
 
         expect(findAllNormalDocs).toHaveBeenCalledOnce();
-        expect(getLocalDatabase).toHaveBeenCalledOnce();
         expect(enqueueAll).toHaveBeenCalledOnce();
         expect(enqueueAll).toHaveBeenCalledWith(documents);
     });

src/modules/coreFeatures/ModuleConflictResolver.ts

@@ -19,7 +19,6 @@ import { stripAllPrefixes, isPlainText } from "@vrtmrz/livesync-commonlib/compat
 import { EVENT_CONFLICT_CANCELLED, eventHub } from "@/common/events.ts";
 import type { InjectableServiceHub } from "@vrtmrz/livesync-commonlib/compat/services/implements/injectable/InjectableServiceHub";
 import type { LiveSyncCore } from "@/main.ts";
-import { NO_INTERACTION } from "@vrtmrz/livesync-commonlib/replication";
 
 export class ModuleConflictResolver extends AbstractModule {
     private async _resolveConflictByDeletingRev(
@@ -143,10 +142,7 @@ export class ModuleConflictResolver extends AbstractModule {
                 //auto resolved, but need check again;
                 if (this.settings.syncAfterMerge && !this.services.appLifecycle.isSuspended()) {
                     //Wait for the running replication, if not running replication, run it once.
-                    await this.services.replication.replicateUnattendedByEvent({
-                        trigger: "merge",
-                        interaction: NO_INTERACTION,
-                    });
+                    await this.services.replication.replicateByEvent();
                 }
                 this._log("[conflict] Automatically merged, but we have to check it again");
                 await this.services.conflict.queueCheckFor(filename);

src/modules/coreFeatures/ModuleConflictResolver.unit.spec.ts

@@ -37,7 +37,7 @@ function createModule(files: FilePathWithPrefix[] = []) {
                 isSuspended: vi.fn(() => false),
             },
             replication: {
-                replicateUnattendedByEvent: vi.fn(async () => ({ status: "completed" as const })),
+                replicateByEvent: vi.fn(async () => true),
             },
             vault: {
                 getActiveFilePath: vi.fn(() => undefined),

src/modules/coreFeatures/ModuleResolveMismatchedTweaks.ts

@@ -20,8 +20,6 @@ import { $msg, translateIfAvailable } from "@/common/translation";
 import type { InjectableServiceHub } from "@vrtmrz/livesync-commonlib/compat/services/implements/injectable/InjectableServiceHub";
 import type { LiveSyncCore } from "@/main.ts";
 import { REMOTE_P2P } from "@vrtmrz/livesync-commonlib/compat/common/models/setting.const";
-import { withOwnedRemoteResource } from "@/common/ownedRemoteResource";
-import { REMOTE_RESOURCE_KINDS } from "@vrtmrz/livesync-commonlib/replication";
 
 /**
  * Localised counterpart of Commonlib's `confName()`, which takes no translator.
@@ -232,24 +230,19 @@ export class ModuleResolvingMismatchedTweaks extends AbstractModule {
         return CHOICES[retKey];
     }
 
-    async _askResolvingMismatchedTweaks(
-        preferredSource: TweakValues,
-        updatePreferredRemote?: (setting: ObsidianLiveSyncSettings) => Promise<boolean>
-    ): Promise<"OK" | "CHECKAGAIN" | "IGNORE"> {
-        const [conf, rebuildRequired] =
-            await this.services.tweakValue.checkAndAskResolvingMismatched(preferredSource);
+    async _askResolvingMismatchedTweaks(): Promise<"OK" | "CHECKAGAIN" | "IGNORE"> {
+        if (!this.core.replicator.tweakSettingsMismatched) {
+            return "OK";
+        }
+        const tweaks = this.core.replicator.preferredTweakValue;
+        if (!tweaks) {
+            return "IGNORE";
+        }
+        const [conf, rebuildRequired] = await this.services.tweakValue.checkAndAskResolvingMismatched(tweaks);
         if (!conf) return "IGNORE";
 
-        const updateRemote = async () => {
-            if (updatePreferredRemote) return await updatePreferredRemote(this.settings);
-            const candidate = this.core.replicator;
-            if (typeof candidate.setPreferredRemoteTweakSettings !== "function") return false;
-            await candidate.setPreferredRemoteTweakSettings(this.settings);
-            return true;
-        };
-
         if (conf === true) {
-            if (!(await updateRemote())) return "IGNORE";
+            await this.core.replicator.setPreferredRemoteTweakSettings(this.settings);
             if (rebuildRequired) {
                 await this.core.rebuilder.$rebuildRemote();
             }
@@ -266,7 +259,7 @@ export class ModuleResolvingMismatchedTweaks extends AbstractModule {
                 // chunk-generation managers now so hash and splitter changes take effect before retrying.
                 await this.localDatabase.managers.reinitialise();
             }
-            if (!(await updateRemote())) return "IGNORE";
+            await this.core.replicator.setPreferredRemoteTweakSettings(this.settings);
             if (rebuildRequired) {
                 await this.core.rebuilder.$fetchLocal();
             }
@@ -278,15 +271,12 @@ export class ModuleResolvingMismatchedTweaks extends AbstractModule {
 
     async _fetchRemotePreferredTweakValues(trialSetting: RemoteDBSettings): Promise<RemotePreferredTweakResult> {
         try {
-            const probe = await this.services.replicator.createRemoteResource(
-                REMOTE_RESOURCE_KINDS.PREFERRED_TWEAK,
-                trialSetting
-            );
-            if (!probe) {
+            const replicator = await this.services.replicator.getNewReplicator(trialSetting);
+            if (!replicator) {
                 this._log("The remote type does not support preferred tweak values.", LOG_LEVEL_NOTICE);
                 return { status: RemotePreferredTweakStatuses.UNSUPPORTED };
             }
-            return await withOwnedRemoteResource(probe, (ownedProbe) => ownedProbe.read());
+            return await replicator.getRemotePreferredTweakValues(trialSetting);
         } catch (ex) {
             this._log("Failed to get the preferred tweak values from the remote.", LOG_LEVEL_NOTICE);
             return {

src/modules/coreFeatures/ModuleResolveMismatchedTweaks.unit.spec.ts

@@ -7,7 +7,6 @@ import {
 } from "@vrtmrz/livesync-commonlib/compat/common/types";
 import { ModuleResolvingMismatchedTweaks } from "./ModuleResolveMismatchedTweaks";
 import { setLang } from "@/common/translation";
-import { REMOTE_RESOURCE_KINDS } from "@vrtmrz/livesync-commonlib/replication";
 
 function createModule(settingsOverride: Partial<typeof DEFAULT_SETTINGS> = {}) {
     const askSelectStringDialogue = vi.fn(async (..._args: unknown[]): Promise<string | undefined> => undefined);
@@ -58,31 +57,27 @@ function createModule(settingsOverride: Partial<typeof DEFAULT_SETTINGS> = {}) {
 describe("ModuleResolvingMismatchedTweaks", () => {
     it("returns an unconfigured remote result without a separate connection preflight", async () => {
         const { module, core } = createModule();
-        const read = vi.fn(async () => ({
+        const tryConnectRemote = vi.fn(async () => true);
+        const getRemotePreferredTweakValues = vi.fn(async () => ({
             status: "not-configured" as const,
             reason: "milestone-missing" as const,
         }));
-        const dispose = vi.fn(async () => undefined);
-        const createRemoteResource = vi.fn(async () => ({ read, dispose }));
         core._services.replicator = {
-            createRemoteResource,
-            getNewReplicator: vi.fn(() => Promise.reject(new Error("must not borrow a Replicator"))),
+            getNewReplicator: vi.fn(async () => ({ tryConnectRemote, getRemotePreferredTweakValues })),
         };
 
         await expect(module._fetchRemotePreferredTweakValues(core.settings)).resolves.toEqual({
             status: "not-configured",
             reason: "milestone-missing",
         });
-        expect(createRemoteResource).toHaveBeenCalledWith(REMOTE_RESOURCE_KINDS.PREFERRED_TWEAK, core.settings);
-        expect(read).toHaveBeenCalledOnce();
-        expect(dispose).toHaveBeenCalledOnce();
-        expect(core._services.replicator.getNewReplicator).not.toHaveBeenCalled();
+        expect(getRemotePreferredTweakValues).toHaveBeenCalledOnce();
+        expect(tryConnectRemote).not.toHaveBeenCalled();
     });
 
     it("returns unsupported when no replicator implements the remote type", async () => {
         const { module, core } = createModule();
         core._services.replicator = {
-            createRemoteResource: vi.fn(async () => undefined),
+            getNewReplicator: vi.fn(async () => undefined),
         };
 
         await expect(module._fetchRemotePreferredTweakValues(core.settings)).resolves.toEqual({
@@ -90,26 +85,6 @@ describe("ModuleResolvingMismatchedTweaks", () => {
         });
     });
 
-    it("disposes the preferred-tweak probe when reading fails", async () => {
-        const { module, core } = createModule();
-        const error = new Error("remote unavailable");
-        const dispose = vi.fn(async () => undefined);
-        core._services.replicator = {
-            createRemoteResource: vi.fn(async () => ({
-                read: vi.fn(async () => {
-                    throw error;
-                }),
-                dispose,
-            })),
-        };
-
-        await expect(module._fetchRemotePreferredTweakValues(core.settings)).resolves.toEqual({
-            status: "unavailable",
-            error,
-        });
-        expect(dispose).toHaveBeenCalledOnce();
-    });
-
     it("should enable and auto-accept compatible mismatches when the preference is undefined", async () => {
         const { module, core, askSelectStringDialogue, applyPartial } = createModule({
             autoAcceptCompatibleTweak: undefined,
@@ -272,18 +247,13 @@ describe("ModuleResolvingMismatchedTweaks", () => {
         reinitialise.mockImplementation(async () => {
             calls.push("reinitialise");
         });
-        const updatePreferredRemote = vi.fn(async () => {
-            calls.push("set-preferred");
-            return true;
-        });
 
-        const result = await module._askResolvingMismatchedTweaks(preferred, updatePreferredRemote);
+        const result = await module._askResolvingMismatchedTweaks();
 
         expect(result).toBe("CHECKAGAIN");
         expect(core.settings).toBe(initialSettings);
         expect(core.settings.hashAlg).toBe("xxhash32");
         expect(calls).toEqual(["save", "reinitialise", "set-preferred"]);
-        expect(core.replicator.setPreferredRemoteTweakSettings).not.toHaveBeenCalled();
     });
 });
 

src/modules/essential/ModuleBasicMenu.ts

@@ -4,7 +4,6 @@ import { fireAndForget } from "octagonal-wheels/promises";
 import { AbstractModule } from "@/modules/AbstractModule";
 import { $msg } from "@/common/translation";
 import { copyFileDatabaseInfo } from "@/serviceFeatures/fileDatabaseInfo";
-import { USER_INITIATED_REPLICATION_AUTHORITY } from "@vrtmrz/livesync-commonlib/replication";
 // Separated Module for basic menu commands, which are not related to obsidian specific features. It is expected to be used in other platforms with minimal changes.
 // However, it is odd that it has here at all; it really ought to be in each respective feature. It will likely be moved eventually. Until now, addCommand pointed to Obsidian's version.
 export class ModuleBasicMenu extends AbstractModule {
@@ -13,10 +12,7 @@ export class ModuleBasicMenu extends AbstractModule {
             id: "livesync-replicate",
             name: $msg("Sync now"),
             callback: async () => {
-                await this.services.replication.replicateUserInitiated({
-                    trigger: "manual",
-                    interaction: USER_INITIATED_REPLICATION_AUTHORITY,
-                });
+                await this.services.replication.replicate();
             },
         });
         this.addCommand({
@@ -89,7 +85,7 @@ export class ModuleBasicMenu extends AbstractModule {
             checkCallback: (checking) => {
                 if (!this.settings.useAdvancedMode) return false;
                 if (!checking) {
-                    fireAndForget(() => this.services.replication.stopActiveTransfer());
+                    this.core.replicator.terminateSync();
                 }
                 return true;
             },

src/modules/essential/ModuleBasicMenu.unit.spec.ts

@@ -25,8 +25,7 @@ function createFixture() {
             registerProtocolHandler: vi.fn(),
         },
         replication: {
-            replicateUserInitiated: vi.fn(async () => ({ status: "completed" as const })),
-            stopActiveTransfer: vi.fn(async () => ({ status: "completed" as const })),
+            replicate: vi.fn(async () => undefined),
         },
         vault: {
             getActiveFilePath: vi.fn((): string | null => "note.md"),
@@ -137,19 +136,6 @@ describe("ModuleBasicMenu command palette", () => {
         expect(fixture.getCommand("livesync-abortsync").checkCallback?.(true)).toBe(true);
     });
 
-    it("routes an explicit stop through the active provider capability", async () => {
-        const fixture = createFixture();
-        fixture.settings.useAdvancedMode = true;
-
-        await fixture.module._everyOnloadStart();
-
-        expect(fixture.getCommand("livesync-abortsync").checkCallback?.(false)).toBe(true);
-        await vi.waitFor(() => {
-            expect(fixture.services.replication.stopActiveTransfer).toHaveBeenCalledOnce();
-        });
-        expect(fixture.core.replicator.terminateSync).not.toHaveBeenCalled();
-    });
-
     it("keeps active-file database information available and opens it in a copy dialogue", async () => {
         const fixture = createFixture();
 

src/modules/essential/ModuleMigration.ts

@@ -37,16 +37,6 @@ type ErrorInfo = {
 
 const INCOMPLETE_DOCUMENT_NOTICE_GROUP = "startup-integrity-check";
 
-interface CompromisedChunkCounter {
-    countCompromisedChunks(): Promise<number | boolean>;
-}
-
-function hasCompromisedChunkCounter(value: object | undefined): value is CompromisedChunkCounter {
-    return (
-        value !== undefined && "countCompromisedChunks" in value && typeof value.countCompromisedChunks === "function"
-    );
-}
-
 export class ModuleMigration extends AbstractModule<LiveSyncCore> {
     constructor(
         core: LiveSyncCore,
@@ -263,10 +253,7 @@ export class ModuleMigration extends AbstractModule<LiveSyncCore> {
         // Check local database for compromised chunks
         const localCompromised = await countCompromisedChunks(this.localDatabase.localDatabase);
         const remote = this.services.replicator.getActiveReplicator();
-        const remoteCompromised =
-            this.services.API.isOnline && hasCompromisedChunkCounter(remote)
-                ? await remote.countCompromisedChunks()
-                : 0;
+        const remoteCompromised = this.services.API.isOnline ? await remote?.countCompromisedChunks() : 0;
         if (localCompromised === false) {
             Logger(`Failed to count compromised chunks in local database`, LOG_LEVEL_NOTICE);
             return false;

src/modules/essentialObsidian/ModuleObsidianEvents.ts

@@ -14,7 +14,6 @@ import {
 } from "@vrtmrz/livesync-commonlib/compat/mock_and_interop/stores";
 import type { LiveSyncCore } from "@/main.ts";
 import { compatGlobal } from "@vrtmrz/livesync-commonlib/compat/common/coreEnvFunctions";
-import { NO_INTERACTION } from "@vrtmrz/livesync-commonlib/replication";
 
 type MutableCommandDefinition = {
     callback?: () => void;
@@ -72,12 +71,7 @@ export class ModuleObsidianEvents extends AbstractObsidianModule {
                     } else {
                         if (this.settings.syncOnEditorSave) {
                             this._log("Sync on Editor Save.", LOG_LEVEL_VERBOSE);
-                            fireAndForget(() =>
-                                this.services.replication.replicateUnattendedByEvent({
-                                    trigger: "editor-save",
-                                    interaction: NO_INTERACTION,
-                                })
-                            );
+                            fireAndForget(() => this.services.replication.replicateByEvent());
                         }
                     }
                 });
@@ -201,7 +195,11 @@ export class ModuleObsidianEvents extends AbstractObsidianModule {
 
     async watchWindowVisibilityAsync() {
         if (this.settings.suspendFileWatching) {
-            if (this.settings.isConfigured && this.services.appLifecycle.isReady() && this.hasBoundedActivity()) {
+            if (
+                this.settings.isConfigured &&
+                this.services.appLifecycle.isReady() &&
+                this.hasBoundedActivity()
+            ) {
                 const isHidden = activeWindow.document.hidden;
                 this.isLastHidden = isHidden;
                 this.deferredBoundedLifecycle = isHidden ? "suspend-if-hidden" : undefined;
@@ -292,10 +290,7 @@ export class ModuleObsidianEvents extends AbstractObsidianModule {
             return;
         }
         if (this.settings.syncOnFileOpen && !this.services.appLifecycle.isSuspended()) {
-            await this.services.replication.replicateUnattendedByEvent({
-                trigger: "file-open",
-                interaction: NO_INTERACTION,
-            });
+            await this.services.replication.replicateByEvent();
         }
         await this.services.conflict.queueCheckForIfOpen(file.path as FilePathWithPrefix);
     }

src/modules/essentialObsidian/ModuleObsidianMenu.ts

@@ -2,7 +2,6 @@ import { addIcon } from "@/deps.ts";
 import { $msg } from "@/common/translation";
 import type { LiveSyncCore } from "@/main.ts";
 import { AbstractModule } from "@/modules/AbstractModule.ts";
-import { USER_INITIATED_REPLICATION_AUTHORITY } from "@vrtmrz/livesync-commonlib/replication";
 // Obsidian specific menu commands.
 export class ModuleObsidianMenu extends AbstractModule {
     _everyOnloadStart(): Promise<boolean> {
@@ -18,10 +17,7 @@ export class ModuleObsidianMenu extends AbstractModule {
         );
 
         this.addRibbonIcon("replicate", $msg("moduleObsidianMenu.replicate"), async () => {
-            await this.services.replication.replicateUserInitiated({
-                trigger: "manual",
-                interaction: USER_INITIATED_REPLICATION_AUTHORITY,
-            });
+            await this.services.replication.replicate(true);
         }).addClass("livesync-ribbon-replicate");
 
         return Promise.resolve(true);

src/modules/features/ModuleInteractiveConflictResolver.ts

@@ -18,7 +18,6 @@ import type { LiveSyncCore } from "@/main.ts";
 import { EVENT_CONFLICT_CANCELLED, EVENT_ON_UNRESOLVED_ERROR, eventHub } from "@/common/events.ts";
 import { $msg } from "@/common/translation.ts";
 import type { Editor, MarkdownFileInfo, MarkdownView } from "@/deps.ts";
-import { NO_INTERACTION } from "@vrtmrz/livesync-commonlib/replication";
 
 export class ModuleInteractiveConflictResolver extends AbstractObsidianModule {
     private postponedConflictEpisodes = new Set<FilePathWithPrefix>();
@@ -183,10 +182,7 @@ export class ModuleInteractiveConflictResolver extends AbstractObsidianModule {
             // So we have to run replication if configured.
             // TODO: Make this is as a event request
             if (this.settings.syncAfterMerge && !this.services.appLifecycle.isSuspended()) {
-                await this.services.replication.replicateUnattendedByEvent({
-                    trigger: "merge",
-                    interaction: NO_INTERACTION,
-                });
+                await this.services.replication.replicateByEvent();
             }
             // And, check it again.
             await this.services.conflict.queueCheckFor(filename);

src/modules/features/ModuleInteractiveConflictResolver.unit.spec.ts

@@ -77,9 +77,7 @@ function createModule(conflictedRevisions: string[] = ["2-right"]) {
             queueCheckFor: vi.fn(async () => undefined),
             ensureAllProcessed: vi.fn(async () => true),
         },
-        replication: {
-            replicateUnattendedByEvent: vi.fn(async () => ({ status: "completed" as const })),
-        },
+        replication: { replicateByEvent: vi.fn(async () => true) },
         vault: { getActiveFilePath: vi.fn(() => path) },
         path: { getPath: vi.fn((entry: { path: FilePathWithPrefix }) => entry.path) },
     };

src/modules/features/SettingDialogue/ObsidianLiveSyncSettingTab.ts

@@ -13,10 +13,11 @@ import {
 } from "@vrtmrz/livesync-commonlib/compat/common/types";
 import { delay, isObjectDifferent, sizeToHumanReadable } from "@vrtmrz/livesync-commonlib/compat/common/utils";
 import { Logger } from "@vrtmrz/livesync-commonlib/compat/common/logger";
+import { checkSyncInfo } from "@vrtmrz/livesync-commonlib/compat/pouchdb/negotiation";
 import { testCrypt } from "octagonal-wheels/encryption/encryption";
 import ObsidianLiveSyncPlugin from "@/main.ts";
 import { scheduleTask } from "@/common/utils.ts";
-import { REMOTE_RESOURCE_KINDS } from "@vrtmrz/livesync-commonlib/replication";
+import { LiveSyncCouchDBReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
 import {
     type AllSettingItemKey,
     type AllStringItemKey,
@@ -77,7 +78,6 @@ import type {
 import { createExtraMenuSettingSpecGroup, createGeneralSettingSpecGroups } from "./GeneralSettingSpecs.ts";
 import { SetupManager } from "@/modules/features/SetupManager.ts";
 import { isP2PMainRemote } from "@/common/remoteConfiguration.ts";
-import { withOwnedRemoteResource } from "@/common/ownedRemoteResource.ts";
 
 // For creating a document
 // const toc = new Set<string>();
@@ -340,18 +340,15 @@ export class ObsidianLiveSyncSettingTab extends PluginSettingTab {
 
     async testConnection(settingOverride: Partial<ObsidianLiveSyncSettings> = {}): Promise<void> {
         const trialSetting = { ...this.editingSettings, ...settingOverride };
-        const probe = await this.services.replicator.createRemoteResource(
-            REMOTE_RESOURCE_KINDS.CONNECTION,
-            trialSetting
-        );
-        if (!probe) {
-            Logger("Connection testing is unavailable for the current settings.", LOG_LEVEL_NOTICE);
+        const replicator = await this.services.replicator.getNewReplicator(trialSetting);
+        if (!replicator) {
+            Logger("No replicator available for the current settings.", LOG_LEVEL_NOTICE);
             return;
         }
-        await withOwnedRemoteResource(probe, async (ownedProbe) => {
-            await ownedProbe.check({ createIfMissing: true, showResult: true });
-            const status = await ownedProbe.getStatus();
-            if (status && status.estimatedSize) {
+        await replicator.tryConnectRemote(trialSetting);
+        const status = await replicator.getRemoteStatus(trialSetting);
+        if (status) {
+            if (status.estimatedSize) {
                 Logger(
                     $msg("obsidianLiveSyncSettingTab.logEstimatedSize", {
                         size: sizeToHumanReadable(status.estimatedSize),
@@ -359,7 +356,7 @@ export class ObsidianLiveSyncSettingTab extends PluginSettingTab {
                     LOG_LEVEL_NOTICE
                 );
             }
-        });
+        }
     }
 
     closeSetting() {
@@ -957,23 +954,27 @@ export class ObsidianLiveSyncSettingTab extends PluginSettingTab {
             visibility:
                 this.isConfiguredAs("remoteType", REMOTE_COUCHDB) || this.isConfiguredAs("remoteType", REMOTE_MINIO),
         }) as OnUpdateResult;
-    /**
-     * Checks the edited CouchDB passphrase through an owned synchronisation-
-     * information resource. A missing document may be created by the check.
-     */
+    // E2EE Function
     checkWorkingPassphrase = async (): Promise<boolean> => {
         if (this.editingSettings.remoteType == REMOTE_MINIO) return true;
 
         const settingForCheck: RemoteDBSettings = {
             ...this.editingSettings,
         };
-        const resource = await this.services.replicator.createRemoteResource(
-            REMOTE_RESOURCE_KINDS.SYNCHRONISATION_INFORMATION,
-            settingForCheck
+        const replicator = this.services.replicator.getNewReplicator(settingForCheck);
+        if (!(replicator instanceof LiveSyncCouchDBReplicator)) return true;
+
+        const db = await replicator.connectRemoteCouchDBWithSetting(
+            settingForCheck,
+            this.services.API.isMobile(),
+            true
         );
-        if (!resource) return true;
+        if (typeof db === "string") {
+            Logger($msg("obsidianLiveSyncSettingTab.logCheckPassphraseFailed", { db }), LOG_LEVEL_NOTICE);
+            return false;
+        }
         try {
-            if (await resource.check()) {
+            if (await checkSyncInfo(db.db)) {
                 // Logger($msg("obsidianLiveSyncSettingTab.logDatabaseConnected"), LOG_LEVEL_NOTICE);
                 return true;
             } else {
@@ -981,7 +982,7 @@ export class ObsidianLiveSyncSettingTab extends PluginSettingTab {
                 return false;
             }
         } finally {
-            await resource.dispose();
+            await db.db.close();
         }
     };
     isPassphraseValid = async () => {

src/modules/features/SettingDialogue/ObsidianLiveSyncSettingTab.unit.spec.ts

@@ -1,7 +1,9 @@
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { DEFAULT_SETTINGS, REMOTE_COUCHDB } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import { REMOTE_RESOURCE_KINDS } from "@vrtmrz/livesync-commonlib/replication";
 
+const negotiationMocks = vi.hoisted(() => ({
+    checkSyncInfo: vi.fn(async () => true),
+}));
 const settingsInitialisationMocks = vi.hoisted(() => ({
     applySettingsWithInitialisationChoice: vi.fn(),
 }));
@@ -36,6 +38,10 @@ vi.mock("@/common/events.ts", () => ({
     eventHub: { emitEvent: vi.fn(), onEvent: vi.fn() },
 }));
 vi.mock("@/modules/features/SetupManager.ts", () => ({ SetupManager: class {} }));
+vi.mock("@vrtmrz/livesync-commonlib/compat/pouchdb/negotiation", () => negotiationMocks);
+vi.mock("@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator", () => ({
+    LiveSyncCouchDBReplicator: class {},
+}));
 vi.mock("./LiveSyncSetting.ts", () => ({ LiveSyncSetting: class {} }));
 vi.mock("./SettingPane.ts", () => ({
     enableOnly: vi.fn(() => vi.fn()),
@@ -57,6 +63,7 @@ vi.mock("./PanePowerUsers.ts", () => ({ panePowerUsers: vi.fn() }));
 vi.mock("./PanePatches.ts", () => ({ panePatches: vi.fn() }));
 vi.mock("./PaneMaintenance.ts", () => ({ paneMaintenance: vi.fn() }));
 
+import { LiveSyncCouchDBReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
 import { ObsidianLiveSyncSettingTab } from "./ObsidianLiveSyncSettingTab";
 
 beforeEach(() => {
@@ -64,15 +71,19 @@ beforeEach(() => {
 });
 
 describe("ObsidianLiveSyncSettingTab passphrase verification", () => {
-    it("awaits and disposes the owned synchronisation-information resource", async () => {
-        const check = vi.fn(async () => true);
-        const dispose = vi.fn(async () => undefined);
-        const createRemoteResource = vi.fn(async () => ({ check, dispose }));
+    it("closes the finite remote connection after checking synchronisation information", async () => {
+        const remoteDatabase = {
+            close: vi.fn(async () => undefined),
+        };
+        const replicator = Object.assign(new LiveSyncCouchDBReplicator({} as never), {
+            connectRemoteCouchDBWithSetting: vi.fn(async () => ({ db: remoteDatabase })),
+        });
         const plugin = {
             app: {},
             core: {
                 services: {
-                    replicator: { createRemoteResource },
+                    API: { isMobile: vi.fn(() => false) },
+                    replicator: { getNewReplicator: vi.fn(() => replicator) },
                 },
             },
         };
@@ -86,76 +97,8 @@ describe("ObsidianLiveSyncSettingTab passphrase verification", () => {
 
         await expect(tab.checkWorkingPassphrase()).resolves.toBe(true);
 
-        expect(createRemoteResource).toHaveBeenCalledWith(
-            REMOTE_RESOURCE_KINDS.SYNCHRONISATION_INFORMATION,
-            expect.objectContaining({ remoteType: REMOTE_COUCHDB })
-        );
-        expect(check).toHaveBeenCalledOnce();
-        expect(dispose).toHaveBeenCalledOnce();
-    });
-
-    it("does not use the general Replicator factory solely to verify synchronisation information", async () => {
-        const getNewReplicator = vi.fn(() => Promise.reject(new Error("must not construct a Replicator")));
-        const createRemoteResource = vi.fn(async () => ({
-            check: vi.fn(async () => true),
-            dispose: vi.fn(async () => undefined),
-        }));
-        const plugin = {
-            app: {},
-            core: {
-                services: {
-                    replicator: { createRemoteResource, getNewReplicator },
-                },
-            },
-        };
-        const tab = new ObsidianLiveSyncSettingTab({} as never, plugin as never);
-        Object.assign(tab, {
-            _editingSettings: {
-                ...DEFAULT_SETTINGS,
-                remoteType: REMOTE_COUCHDB,
-            },
-        });
-
-        await expect(tab.checkWorkingPassphrase()).resolves.toBe(true);
-
-        expect(getNewReplicator).not.toHaveBeenCalled();
-    });
-});
-
-describe("ObsidianLiveSyncSettingTab connection testing", () => {
-    it("uses and disposes the flow-specific connection probe without borrowing a Replicator", async () => {
-        const check = vi.fn(async () => ({ ok: true as const }));
-        const getStatus = vi.fn(async () => ({ estimatedSize: 1024 }));
-        const dispose = vi.fn(async () => undefined);
-        const createRemoteResource = vi.fn(async () => ({ check, getStatus, dispose }));
-        const getNewReplicator = vi.fn(() => Promise.reject(new Error("must not borrow a Replicator")));
-        const plugin = {
-            app: {},
-            core: {
-                services: {
-                    replicator: { createRemoteResource, getNewReplicator },
-                },
-            },
-        };
-        const tab = new ObsidianLiveSyncSettingTab({} as never, plugin as never);
-        Object.assign(tab, {
-            _editingSettings: {
-                ...DEFAULT_SETTINGS,
-                remoteType: REMOTE_COUCHDB,
-                couchDB_DBNAME: "saved",
-            },
-        });
-
-        await expect(tab.testConnection({ couchDB_DBNAME: "trial" })).resolves.toBeUndefined();
-
-        expect(createRemoteResource).toHaveBeenCalledWith(
-            REMOTE_RESOURCE_KINDS.CONNECTION,
-            expect.objectContaining({ remoteType: REMOTE_COUCHDB, couchDB_DBNAME: "trial" })
-        );
-        expect(check).toHaveBeenCalledWith({ createIfMissing: true, showResult: true });
-        expect(getStatus).toHaveBeenCalledOnce();
-        expect(dispose).toHaveBeenCalledOnce();
-        expect(getNewReplicator).not.toHaveBeenCalled();
+        expect(negotiationMocks.checkSyncInfo).toHaveBeenCalledWith(remoteDatabase);
+        expect(remoteDatabase.close).toHaveBeenCalledOnce();
     });
 });
 

src/modules/features/SettingDialogue/PaneMaintenance.ts

@@ -17,8 +17,8 @@ export function paneMaintenance(
     paneEl: HTMLElement,
     { addPanel }: PageFunctions
 ): void {
-    const isRemoteLockedAndDeviceNotAccepted = () => !!this.core?.replicator?.remoteLockedAndDeviceNotAccepted;
-    const isRemoteLocked = () => !!this.core?.replicator?.remoteLocked;
+    const isRemoteLockedAndDeviceNotAccepted = () => this.core?.replicator?.remoteLockedAndDeviceNotAccepted;
+    const isRemoteLocked = () => this.core?.replicator?.remoteLocked;
     // if (this.plugin?.replicator?.remoteLockedAndDeviceNotAccepted) {
     this.createEl(
         paneEl,

src/modules/features/SettingDialogue/PaneRemoteConfig.ts

@@ -33,6 +33,7 @@ import type { RemoteConfigurationResult } from "@vrtmrz/livesync-commonlib/compa
 import SetupRemote from "@/modules/features/SetupWizard/dialogs/SetupRemote.svelte";
 import SetupRemoteCouchDB from "@/modules/features/SetupWizard/dialogs/SetupRemoteCouchDB.svelte";
 import SetupRemoteBucket from "@/modules/features/SetupWizard/dialogs/SetupRemoteBucket.svelte";
+import SetupRemoteP2P from "@/modules/features/SetupWizard/dialogs/SetupRemoteP2P.svelte";
 import type {
     SetupRemoteCouchDBInitialData,
     SetupRemoteCouchDBResultType,
@@ -216,7 +217,7 @@ export function paneRemoteConfig(
                 }
 
                 if (targetRemoteType === REMOTE_P2P) {
-                    const p2pConf = await setupManager.openP2PSetup(baseSettings);
+                    const p2pConf = await dialogManager.openWithExplicitCancel(SetupRemoteP2P, baseSettings);
                     if (p2pConf === "cancelled" || typeof p2pConf !== "object") {
                         return false;
                     }

src/modules/features/SetupManager.ts

@@ -36,7 +36,6 @@ import type {
     SetupRemoteCouchDBResultType,
     SetupRemoteCouchDBInitialData,
     SetupRemoteE2EEResultType,
-    SetupRemoteP2PInitialData,
     SetupRemoteP2PResultType,
     SetupRemoteResultType,
     UseSetupURIResultType,
@@ -49,7 +48,6 @@ import {
     type SetupInitialisationMode,
 } from "@/serviceFeatures/setupObsidian/setupActivationLifecycle.ts";
 import { isP2PMainRemote } from "@/common/remoteConfiguration.ts";
-import type { P2PConnectionProbeAdmission } from "@vrtmrz/livesync-commonlib/p2p";
 
 function copySettingsForRemoteProfileUpdate(settings: ObsidianLiveSyncSettings): ObsidianLiveSyncSettings {
     return {
@@ -96,8 +94,6 @@ export type ApplySettingsWithInitialisationChoiceOptions = {
  * Setup Manager to handle onboarding and configuration setup
  */
 export class SetupManager extends AbstractModule {
-    private p2pSetupConnectionProbe?: P2PConnectionProbeAdmission;
-
     // /**
     //  * Dialog manager for handling Svelte dialogs
     //  */
@@ -106,26 +102,6 @@ export class SetupManager extends AbstractModule {
         return this.services.UI.dialogManager;
     }
 
-    /** Bind the stable P2P owner's probe view to host-owned Setup dialogues. */
-    registerP2PSetupConnectionProbe(connectionProbe: P2PConnectionProbeAdmission): void {
-        if (this.p2pSetupConnectionProbe && this.p2pSetupConnectionProbe !== connectionProbe) {
-            throw new Error("The P2P Setup connection probe has already been registered.");
-        }
-        this.p2pSetupConnectionProbe = connectionProbe;
-    }
-
-    /** Open P2P Setup with the owner-arbitrated connection-probe boundary. */
-    openP2PSetup(settings: P2PSyncSetting): Promise<SetupRemoteP2PResultType> {
-        const connectionProbe = this.p2pSetupConnectionProbe;
-        if (!connectionProbe) {
-            throw new Error("The P2P Setup connection probe is not available.");
-        }
-        return this.dialogManager.openWithExplicitCancel<SetupRemoteP2PResultType, SetupRemoteP2PInitialData>(
-            SetupRemoteP2P,
-            { settings, connectionProbe }
-        );
-    }
-
     /**
      * Ask which existing data should be authoritative for pending setting changes,
      * then reserve the matching next-start operation before applying them.
@@ -304,7 +280,10 @@ export class SetupManager extends AbstractModule {
         currentSetting: ObsidianLiveSyncSettings,
         activate = true
     ): Promise<boolean> {
-        const p2pConf = await this.openP2PSetup(currentSetting);
+        const p2pConf = await this.dialogManager.openWithExplicitCancel<SetupRemoteP2PResultType, P2PSyncSetting>(
+            SetupRemoteP2P,
+            currentSetting
+        );
         if (p2pConf === "cancelled") {
             this._log("Manual configuration cancelled.", LOG_LEVEL_NOTICE);
             return await this.onOnboard(userMode);

src/modules/features/SetupManager.unit.spec.ts

@@ -8,11 +8,6 @@ import {
 import { SettingService } from "@vrtmrz/livesync-commonlib/compat/services/base/SettingService";
 import { ServiceContext } from "@vrtmrz/livesync-commonlib/context";
 import { createNewVaultSettings } from "@vrtmrz/livesync-commonlib/settings";
-import type {
-    P2PConnectionProbeAdmission,
-    P2PConnectionProbeAdmissionResult,
-    P2PConnectionProbeSettings,
-} from "@vrtmrz/livesync-commonlib/p2p";
 
 vi.mock("./SetupWizard/dialogs/Intro.svelte", () => ({ default: {} }));
 vi.mock("./SetupWizard/dialogs/SelectMethodNewUser.svelte", () => ({ default: {} }));
@@ -129,23 +124,11 @@ function createSetupManager() {
         },
     });
 
-    const p2pSetupConnectionProbe: P2PConnectionProbeAdmission = {
-        async run<T>(
-            _settings: P2PConnectionProbeSettings,
-            runOwnedTrial: () => Promise<T>
-        ): Promise<P2PConnectionProbeAdmissionResult<T>> {
-            return { status: "trial", result: await runOwnedTrial() };
-        },
-    };
-    const manager = new SetupManager(core);
-    manager.registerP2PSetupConnectionProbe(p2pSetupConnectionProbe);
-
     return {
-        manager,
+        manager: new SetupManager(core),
         setting,
         dialogManager,
         core,
-        p2pSetupConnectionProbe,
     };
 }
 
@@ -155,19 +138,6 @@ describe("SetupManager", () => {
         vi.restoreAllMocks();
     });
 
-    it("opens P2P Setup with the registered owner admission", async () => {
-        const { manager, setting, dialogManager, p2pSetupConnectionProbe } = createSetupManager();
-        const settings = setting.currentSettings();
-        dialogManager.openWithExplicitCancel.mockResolvedValueOnce("cancelled");
-
-        await expect(manager.openP2PSetup(settings)).resolves.toBe("cancelled");
-
-        expect(dialogManager.openWithExplicitCancel).toHaveBeenCalledWith(
-            expect.anything(),
-            expect.objectContaining({ settings, connectionProbe: p2pSetupConnectionProbe })
-        );
-    });
-
     it("starts manual new-user setup from the recommended new-Vault settings", async () => {
         const { manager, dialogManager } = createSetupManager();
         dialogManager.openWithExplicitCancel.mockResolvedValueOnce("configure-manually");

src/modules/features/SetupWizard/dialogs/SetupRemoteBucket.svelte

@@ -20,8 +20,6 @@
     import { copyTo, pickBucketSyncSettings } from "@vrtmrz/livesync-commonlib/compat/common/utils";
     import { TYPE_CANCELLED, type SetupRemoteBucketResultType } from "./setupDialogTypes";
     import { $msg as translateMessage } from "@/common/translation";
-    import { withOwnedRemoteResource } from "@/common/ownedRemoteResource";
-    import { REMOTE_RESOURCE_KINDS } from "@vrtmrz/livesync-commonlib/replication";
 
     const default_setting = pickBucketSyncSettings(DEFAULT_SETTINGS);
 
@@ -83,18 +81,13 @@
         try {
             processing = true;
             const trialRemoteSetting = generateSetting();
-            const probe = await context.services.replicator.createRemoteResource(
-                REMOTE_RESOURCE_KINDS.CONNECTION,
-                trialRemoteSetting
-            );
-            if (!probe) {
-                return translateMessage("Failed to connect to the server. Please check your settings.");
+            const replicator = await context.services.replicator.getNewReplicator(trialRemoteSetting);
+            if (!replicator) {
+                return translateMessage("Failed to create replicator instance.");
             }
             try {
-                const result = await withOwnedRemoteResource(probe, (ownedProbe) =>
-                    ownedProbe.check({ createIfMissing: true, showResult: false })
-                );
-                if (result.ok) {
+                const result = await replicator.tryConnectRemote(trialRemoteSetting, false);
+                if (result) {
                     return "";
                 } else {
                     return translateMessage("Failed to connect to the server. Please check your settings.");

src/modules/features/SetupWizard/dialogs/SetupRemoteCouchDB.svelte

@@ -29,7 +29,6 @@
     } from "./setupDialogTypes";
     import { isValidCouchDBServerURL, probeCouchDBConnection } from "./couchDBConnectionProbe";
     import { $msg as translateMessage } from "@/common/translation";
-    import { REMOTE_RESOURCE_KINDS } from "@vrtmrz/livesync-commonlib/replication";
 
     const default_setting = pickCouchDBSyncSettings(DEFAULT_SETTINGS);
 
@@ -74,15 +73,16 @@
         try {
             processing = true;
             const trialRemoteSetting = generateSetting();
-            const probe = await context.services.replicator.createRemoteResource(
-                REMOTE_RESOURCE_KINDS.CONNECTION,
-                trialRemoteSetting
-            );
-            if (!probe) {
-                return translateMessage("Failed to connect to the server. Please check your settings.");
+            const replicator = await context.services.replicator.getNewReplicator(trialRemoteSetting);
+            if (!replicator) {
+                return translateMessage("Failed to create replicator instance.");
             }
             try {
-                const result = await probeCouchDBConnection(probe, setupMode === "create-or-connect");
+                const result = await probeCouchDBConnection(
+                    replicator,
+                    trialRemoteSetting,
+                    setupMode === "create-or-connect"
+                );
                 if (result.ok) {
                     return "";
                 } else {

src/modules/features/SetupWizard/dialogs/SetupRemoteP2P.svelte

@@ -36,14 +36,10 @@
     import { getDialogContext, type GuestDialogProps } from "@/modules/services/LiveSyncUI/svelteDialog";
     import { SETTING_KEY_P2P_DEVICE_NAME } from "@vrtmrz/livesync-commonlib/compat/common/types";
     import ExtraItems from "@/modules/services/LiveSyncUI/components/ExtraItems.svelte";
-    import {
-        TYPE_CANCELLED,
-        type SetupRemoteP2PInitialData,
-        type SetupRemoteP2PResultType,
-    } from "./setupDialogTypes";
+    import { TYPE_CANCELLED, type SetupRemoteP2PResultType } from "./setupDialogTypes";
     import { LOG_LEVEL_VERBOSE, Logger } from "octagonal-wheels/common/logger";
     import { $msg as translateMessage } from "@/common/translation";
-    import { coordinateP2PSetupConnectionProbe, probeP2PSetupConnection } from "./p2pSetupConnectionProbe";
+    import { probeP2PSetupConnection } from "./p2pSetupConnectionProbe";
 
     const default_setting = pickP2PSyncSettings(DEFAULT_SETTINGS);
     let syncSetting = $state<P2PConnectionInfo>({ ...default_setting });
@@ -52,18 +48,18 @@
     let error = $state("");
     let connectionPathResetNotice = $state(false);
     const hasValidTurnServer = $derived(hasValidP2PTurnServerUrl(syncSetting.P2P_turnServers ?? ""));
-    type Props = GuestDialogProps<SetupRemoteP2PResultType, SetupRemoteP2PInitialData>;
+    type Props = GuestDialogProps<SetupRemoteP2PResultType, P2PSyncSetting>;
 
     const { setResult, getInitialData }: Props = $props();
-    let connectionProbe: SetupRemoteP2PInitialData["connectionProbe"] | undefined;
     onMount(() => {
-        const initialData = getInitialData?.();
-        connectionProbe = initialData?.connectionProbe;
-        const initialSettings = initialData?.settings;
-        if (initialSettings) {
-            copyTo(initialSettings, syncSetting);
+        let initialData: P2PSyncSetting | undefined = undefined;
+        if (getInitialData) {
+            initialData = getInitialData();
+            if (initialData) {
+                copyTo(initialData, syncSetting);
+            }
         }
-        const initialPeerName = (initialSettings?.P2P_DevicePeerName ?? "").trim();
+        const initialPeerName = (initialData?.P2P_DevicePeerName ?? "").trim();
         if (initialPeerName !== "") {
             return;
         }
@@ -101,74 +97,58 @@
         try {
             processing = true;
             const trialRemoteSetting = generateSetting();
-            const admission = connectionProbe;
-            if (!admission) {
-                throw new Error("The P2P Setup connection probe is not available.");
-            }
-            const result = await coordinateP2PSetupConnectionProbe(admission, trialRemoteSetting, async () => {
-                const map = new Map<string, string>();
-                const store = {
-                    get: (key: string) => {
-                        return Promise.resolve(map.get(key) || null);
-                    },
-                    set: (key: string, value: any) => {
-                        map.set(key, value);
-                        return Promise.resolve();
-                    },
-                    delete: (key: string) => {
-                        map.delete(key);
-                        return Promise.resolve();
-                    },
-                    keys: () => {
-                        return Promise.resolve(Array.from(map.keys()));
-                    },
-                    get db() {
-                        return Promise.resolve(this);
-                    },
-                } as SimpleStore<any>;
+            const map = new Map<string, string>();
+            const store = {
+                get: (key: string) => {
+                    return Promise.resolve(map.get(key) || null);
+                },
+                set: (key: string, value: any) => {
+                    map.set(key, value);
+                    return Promise.resolve();
+                },
+                delete: (key: string) => {
+                    map.delete(key);
+                    return Promise.resolve();
+                },
+                keys: () => {
+                    return Promise.resolve(Array.from(map.keys()));
+                },
+                get db() {
+                    return Promise.resolve(this);
+                },
+            } as SimpleStore<any>;
 
-                const dummyPouch = new PouchDB<EntryDoc>("dummy");
-                let replicator: TrysteroReplicator | undefined;
+            const dummyPouch = new PouchDB<EntryDoc>("dummy");
+            const env: ReplicatorHostEnv = {
+                events: context.context.events,
+                translate: context.context.translate,
+                settings: trialRemoteSetting,
+                processReplicatedDocs: async (_docs: any[]) => {
+                    return;
+                },
+                confirm: context.services.confirm,
+                db: dummyPouch,
+                simpleStore: store,
+                deviceName: syncSetting.P2P_DevicePeerName || "unnamed-device",
+                platform: "setup-wizard",
+            };
+            const replicator = new TrysteroReplicator(env);
+            try {
+                const result = await probeP2PSetupConnection(replicator);
+                if (!result.ok) {
+                    return translateMessage("Failed to connect to the signalling relay: ${reason}", {
+                        reason: `${result.reason}`,
+                    });
+                }
+                return "";
+            } finally {
                 try {
-                    const env: ReplicatorHostEnv = {
-                        events: context.context.events,
-                        translate: context.context.translate,
-                        settings: trialRemoteSetting,
-                        processReplicatedDocs: async (_docs: any[]) => {
-                            return;
-                        },
-                        confirm: context.services.confirm,
-                        db: dummyPouch,
-                        simpleStore: store,
-                        deviceName: syncSetting.P2P_DevicePeerName || "unnamed-device",
-                        platform: "setup-wizard",
-                    };
-                    replicator = new TrysteroReplicator(env);
-                    return await probeP2PSetupConnection(replicator);
-                } finally {
-                    try {
-                        await replicator?.dispose();
-                    } catch (e) {
-                        Logger(e, LOG_LEVEL_VERBOSE, "setup-p2p-replicator-cleanup");
-                    }
-                    try {
-                        await dummyPouch.destroy();
-                    } catch (e) {
-                        Logger(e, LOG_LEVEL_VERBOSE, "setup-p2p-database-cleanup");
-                    }
+                    await replicator.close();
+                    await dummyPouch.destroy();
+                } catch (e) {
+                    Logger(e, LOG_LEVEL_VERBOSE, "setup-p2p-cleanup");
                 }
-            });
-            if (!result.ok) {
-                if ("kind" in result && result.kind === "blocked") {
-                    return translateMessage(
-                        "The connection test cannot add a signalling relay while P2P is active. Use the active relay settings, or disconnect P2P before testing."
-                    );
-                }
-                return translateMessage("Failed to connect to the signalling relay: ${reason}", {
-                    reason: `${result.reason}`,
-                });
             }
-            return "";
         } finally {
             processing = false;
         }

src/modules/features/SetupWizard/dialogs/couchDBConnectionProbe.ts

@@ -1,16 +1,62 @@
-import type { RemoteConnectionProbe, RemoteConnectionProbeResult } from "@vrtmrz/livesync-commonlib/replication";
-import { withOwnedRemoteResource } from "@/common/ownedRemoteResource";
+import type {
+    ObsidianLiveSyncSettings,
+    RemoteDBSettings,
+} from "@vrtmrz/livesync-commonlib/compat/common/models/setting.type";
 
-/** Run the selected CouchDB setup mode within one owned probe lifetime. */
-export async function probeCouchDBConnection(
-    probe: RemoteConnectionProbe,
-    createIfMissing: boolean
-): Promise<RemoteConnectionProbeResult> {
-    return await withOwnedRemoteResource(probe, (ownedProbe) =>
-        ownedProbe.check({ createIfMissing, showResult: false })
+export type CouchDBConnectionProbeResult = { ok: true } | { ok: false; reason: string };
+
+type CouchDBConnectionResult =
+    | string
+    | {
+          db: { close(): Promise<void> };
+          info: unknown;
+      };
+
+export interface CouchDBConnectionProbe {
+    isMobile(): boolean;
+    connectRemoteCouchDBWithSetting(
+        settings: RemoteDBSettings,
+        isMobile: boolean,
+        performSetup: boolean,
+        skipInfo: boolean
+    ): CouchDBConnectionResult | Promise<CouchDBConnectionResult>;
+}
+
+export function isCouchDBConnectionProbe(value: unknown): value is CouchDBConnectionProbe {
+    return (
+        typeof value === "object" &&
+        value !== null &&
+        "isMobile" in value &&
+        typeof value.isMobile === "function" &&
+        "connectRemoteCouchDBWithSetting" in value &&
+        typeof value.connectRemoteCouchDBWithSetting === "function"
     );
 }
 
+export async function probeCouchDBConnection(
+    replicator: unknown,
+    settings: ObsidianLiveSyncSettings,
+    createIfMissing: boolean
+): Promise<CouchDBConnectionProbeResult> {
+    if (!isCouchDBConnectionProbe(replicator)) {
+        return { ok: false, reason: "The CouchDB connection probe is unavailable." };
+    }
+    const result = await replicator.connectRemoteCouchDBWithSetting(
+        settings,
+        replicator.isMobile(),
+        createIfMissing,
+        false
+    );
+    if (typeof result === "string") {
+        return { ok: false, reason: result };
+    }
+    try {
+        return { ok: true };
+    } finally {
+        await result.db.close();
+    }
+}
+
 export function isValidCouchDBServerURL(value: string): boolean {
     try {
         const url = new URL(value);

src/modules/features/SetupWizard/dialogs/couchDBConnectionProbe.unit.spec.ts

@@ -1,34 +1,47 @@
 import { describe, expect, it, vi } from "vitest";
+import type { ObsidianLiveSyncSettings } from "@vrtmrz/livesync-commonlib/compat/common/models/setting.type";
 import { isValidCouchDBServerURL, probeCouchDBConnection } from "./couchDBConnectionProbe";
 
+const settings = {
+    couchDB_URI: "https://couch.example",
+    couchDB_DBNAME: "notes",
+} as ObsidianLiveSyncSettings;
+
 describe("CouchDB setup connection policy", () => {
     it.each([
         [false, "connect to an existing database"],
         [true, "create or connect to a database"],
-    ] as const)("%s can %s through an owned connection probe", async (createIfMissing, _description) => {
-        const check = vi.fn(async () => ({ ok: true as const }));
-        const dispose = vi.fn(async () => undefined);
-        const probe = { check, getStatus: vi.fn(), dispose };
+    ] as const)(
+        "%s can %s without changing the Commonlib connection contract",
+        async (createIfMissing, _description) => {
+            const close = vi.fn(async () => undefined);
+            const connectRemoteCouchDBWithSetting = vi.fn(async () => ({
+                db: { close },
+                info: { db_name: "notes" },
+            }));
+            const replicator = {
+                isMobile: vi.fn(() => false),
+                connectRemoteCouchDBWithSetting,
+                tryConnectRemote: vi.fn(),
+            };
 
-        await expect(probeCouchDBConnection(probe, createIfMissing)).resolves.toEqual({ ok: true });
+            await expect(probeCouchDBConnection(replicator, settings, createIfMissing)).resolves.toEqual({ ok: true });
+            expect(connectRemoteCouchDBWithSetting).toHaveBeenCalledWith(settings, false, createIfMissing, false);
+            expect(replicator.tryConnectRemote).not.toHaveBeenCalled();
+            expect(close).toHaveBeenCalledOnce();
+        }
+    );
 
-        expect(check).toHaveBeenCalledWith({ createIfMissing, showResult: false });
-        expect(dispose).toHaveBeenCalledOnce();
-    });
-
-    it("returns a connection error and still disposes the probe", async () => {
-        const dispose = vi.fn(async () => undefined);
-        const probe = {
-            check: vi.fn(async () => ({ ok: false as const, reason: "database does not exist" })),
-            getStatus: vi.fn(),
-            dispose,
+    it("returns the connection error without saving or creating through another path", async () => {
+        const replicator = {
+            isMobile: vi.fn(() => true),
+            connectRemoteCouchDBWithSetting: vi.fn(() => "database does not exist"),
         };
 
-        await expect(probeCouchDBConnection(probe, false)).resolves.toEqual({
+        await expect(probeCouchDBConnection(replicator, settings, false)).resolves.toEqual({
             ok: false,
             reason: "database does not exist",
         });
-        expect(dispose).toHaveBeenCalledOnce();
     });
 
     it.each([

src/modules/features/SetupWizard/dialogs/p2pSetupConnectionProbe.ts

@@ -1,17 +1,4 @@
-import {
-    ACTIVE_P2P_RELAY_BINDING_CONFLICT,
-    type P2PConnectionProbeAdmission,
-    type P2PConnectionProbeSettings,
-} from "@vrtmrz/livesync-commonlib/p2p";
-
-export type P2PSetupConnectionProbeResult =
-    | { readonly ok: true }
-    | { readonly ok: false; readonly reason: string }
-    | {
-          readonly ok: false;
-          readonly kind: "blocked";
-          readonly reason: typeof ACTIVE_P2P_RELAY_BINDING_CONFLICT;
-      };
+export type P2PSetupConnectionProbeResult = { ok: true } | { ok: false; reason: string };
 
 export interface P2PSetupConnectionProbe {
     setOnSetup(): void | Promise<void>;
@@ -19,25 +6,6 @@ export interface P2PSetupConnectionProbe {
     open(): Promise<void>;
 }
 
-/** Interpret the stable P2P owner's admission without constructing transport eagerly. */
-export async function coordinateP2PSetupConnectionProbe(
-    admission: P2PConnectionProbeAdmission,
-    trialSettings: P2PConnectionProbeSettings,
-    runOwnedTrial: () => Promise<P2PSetupConnectionProbeResult>
-): Promise<P2PSetupConnectionProbeResult> {
-    const settlement = await admission.run(trialSettings, runOwnedTrial);
-    if (settlement.status === "observed-active") return { ok: true };
-    if (settlement.status === "blocked") {
-        return {
-            ok: false,
-            kind: "blocked",
-            reason: settlement.reason,
-        };
-    }
-    return settlement.result;
-}
-
-/** Open one separately owned signalling connection and report its outcome. */
 export async function probeP2PSetupConnection(
     replicator: P2PSetupConnectionProbe
 ): Promise<P2PSetupConnectionProbeResult> {

src/modules/features/SetupWizard/dialogs/p2pSetupConnectionProbe.unit.spec.ts

@@ -1,69 +1,7 @@
 import { describe, expect, it, vi } from "vitest";
-import { ACTIVE_P2P_RELAY_BINDING_CONFLICT, type P2PConnectionProbeAdmission } from "@vrtmrz/livesync-commonlib/p2p";
-import {
-    coordinateP2PSetupConnectionProbe,
-    probeP2PSetupConnection,
-    type P2PSetupConnectionProbeResult,
-} from "./p2pSetupConnectionProbe";
+import { probeP2PSetupConnection } from "./p2pSetupConnectionProbe";
 
 describe("P2P setup connection probe", () => {
-    it("uses a compatible active signalling connection without constructing a trial", async () => {
-        const runOwnedTrial = vi.fn(async (): Promise<P2PSetupConnectionProbeResult> => ({ ok: true }));
-        const admission: P2PConnectionProbeAdmission = {
-            run: vi.fn(async () => ({ status: "observed-active" }) as const),
-        };
-
-        await expect(
-            coordinateP2PSetupConnectionProbe(admission, { P2P_relays: "wss://relay.example.com" }, runOwnedTrial)
-        ).resolves.toEqual({ ok: true });
-
-        expect(admission.run).toHaveBeenCalledOnce();
-        expect(runOwnedTrial).not.toHaveBeenCalled();
-    });
-
-    it("preserves the typed blocked reason without opening an incompatible trial", async () => {
-        const runOwnedTrial = vi.fn(async (): Promise<P2PSetupConnectionProbeResult> => ({ ok: true }));
-        const admission: P2PConnectionProbeAdmission = {
-            run: vi.fn(
-                async () =>
-                    ({
-                        status: "blocked",
-                        reason: ACTIVE_P2P_RELAY_BINDING_CONFLICT,
-                    }) as const
-            ),
-        };
-
-        await expect(
-            coordinateP2PSetupConnectionProbe(
-                admission,
-                { P2P_relays: "wss://another-relay.example.com" },
-                runOwnedTrial
-            )
-        ).resolves.toEqual({
-            ok: false,
-            kind: "blocked",
-            reason: ACTIVE_P2P_RELAY_BINDING_CONFLICT,
-        });
-
-        expect(admission.run).toHaveBeenCalledOnce();
-        expect(runOwnedTrial).not.toHaveBeenCalled();
-    });
-
-    it("runs and returns the complete owned trial continuation when no room is active", async () => {
-        const trialResult = { ok: false, reason: "relay unavailable" } as const;
-        const runOwnedTrial = vi.fn(async (): Promise<P2PSetupConnectionProbeResult> => trialResult);
-        const admission: P2PConnectionProbeAdmission = {
-            run: vi.fn(async (_settings, trial) => ({ status: "trial", result: await trial() }) as const),
-        };
-
-        await expect(
-            coordinateP2PSetupConnectionProbe(admission, { P2P_relays: "wss://relay.example.com" }, runOwnedTrial)
-        ).resolves.toEqual(trialResult);
-
-        expect(admission.run).toHaveBeenCalledOnce();
-        expect(runOwnedTrial).toHaveBeenCalledOnce();
-    });
-
     it("accepts an empty room after the signalling connection opens", async () => {
         const replicator = {
             knownAdvertisements: [],

src/modules/features/SetupWizard/dialogs/setupDialogTypes.ts

@@ -4,9 +4,7 @@ import type {
     EncryptionSettings,
     ObsidianLiveSyncSettings,
     P2PConnectionInfo,
-    P2PSyncSetting,
 } from "@vrtmrz/livesync-commonlib/compat/common/models/setting.type";
-import type { P2PConnectionProbeAdmission } from "@vrtmrz/livesync-commonlib/p2p";
 
 export const TYPE_IDENTICAL = "identical";
 export const TYPE_INDEPENDENT = "independent";
@@ -121,9 +119,5 @@ export type SetupRemoteCouchDBInitialData = {
 };
 
 export type SetupRemoteP2PResultType = typeof TYPE_CANCELLED | P2PConnectionInfo;
-export type SetupRemoteP2PInitialData = {
-    settings: P2PSyncSetting;
-    connectionProbe: P2PConnectionProbeAdmission;
-};
 
 export type ScanQRCodeResultType = typeof TYPE_CLOSE;

src/modules/services/ObsidianServices.unit.spec.ts

@@ -37,11 +37,7 @@ describe("ObsidianReplicatorService", () => {
                         allowSleepDuringSynchronisationOnDesktop: false,
                     }),
                 },
-                appLifecycleService: {
-                    onSuspending: handler(),
-                    onUnload: handler(),
-                    getUnresolvedMessages: handler(),
-                },
+                appLifecycleService: { onSuspending: handler(), getUnresolvedMessages: handler() },
                 databaseEventService: {
                     onResetDatabase: handler(),
                     onDatabaseInitialisation: handler(),
@@ -77,11 +73,7 @@ describe("ObsidianReplicatorService", () => {
                         allowSleepDuringSynchronisationOnDesktop: true,
                     }),
                 },
-                appLifecycleService: {
-                    onSuspending: handler(),
-                    onUnload: handler(),
-                    getUnresolvedMessages: handler(),
-                },
+                appLifecycleService: { onSuspending: handler(), getUnresolvedMessages: handler() },
                 databaseEventService: {
                     onResetDatabase: handler(),
                     onDatabaseInitialisation: handler(),

src/serviceFeatures/replication/automaticTriggers.ts

@@ -1,71 +0,0 @@
-import type { ObsidianLiveSyncSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import { fireAndForget } from "octagonal-wheels/promises";
-import { scheduleTask } from "octagonal-wheels/concurrency/task";
-import { EVENT_FILE_SAVED, EVENT_SETTING_SAVED, eventHub } from "@/common/events";
-
-type ReflectionFilterSettings = Pick<
-    ObsidianLiveSyncSettings,
-    | "handleFilenameCaseSensitive"
-    | "ignoreFiles"
-    | "maxMTimeForReflectEvents"
-    | "syncIgnoreRegEx"
-    | "syncInternalFiles"
-    | "syncMaxSizeInMB"
-    | "syncOnlyRegEx"
-    | "useIgnoreFiles"
->;
-
-interface AutomaticReplicationTriggerContext {
-    readonly currentSettings: () => ObsidianLiveSyncSettings;
-    readonly isSuspended: () => boolean;
-    readonly replicateDatabaseEvent: () => Promise<unknown>;
-    readonly reprocessStoredDocuments: () => Promise<number>;
-    readonly resumeResultApplication: () => void;
-    readonly suspendResultApplication: () => void;
-}
-
-function normalFileReflectionFilterSignature(settings: ReflectionFilterSettings): string {
-    return JSON.stringify({
-        handleFilenameCaseSensitive: settings.handleFilenameCaseSensitive ?? false,
-        ignoreFiles: settings.ignoreFiles ?? "",
-        maxMTimeForReflectEvents: settings.maxMTimeForReflectEvents ?? 0,
-        syncIgnoreRegEx: settings.syncIgnoreRegEx ?? "",
-        syncInternalFiles: settings.syncInternalFiles ?? false,
-        syncMaxSizeInMB: settings.syncMaxSizeInMB ?? 0,
-        syncOnlyRegEx: settings.syncOnlyRegEx ?? "",
-        useIgnoreFiles: settings.useIgnoreFiles ?? false,
-    });
-}
-
-/**
- * Create the settings-loaded handler which installs automatic replication and
- * result-application reactions. The returned closure owns the previous filter
- * signature; it is private composition state rather than a shared service.
- */
-export function createAutomaticReplicationTriggers(context: AutomaticReplicationTriggerContext) {
-    let reflectionFilterSignature: string | undefined;
-
-    return function initialiseAutomaticReplicationTriggers(): Promise<boolean> {
-        reflectionFilterSignature = normalFileReflectionFilterSignature(context.currentSettings());
-        eventHub.onEvent(EVENT_FILE_SAVED, () => {
-            if (context.currentSettings().syncOnSave && !context.isSuspended()) {
-                scheduleTask("perform-replicate-after-save", 250, () => context.replicateDatabaseEvent());
-            }
-        });
-        eventHub.onEvent(EVENT_SETTING_SAVED, (settings) => {
-            const previousReflectionFilter = reflectionFilterSignature;
-            const nextReflectionFilter = normalFileReflectionFilterSignature(settings);
-            reflectionFilterSignature = nextReflectionFilter;
-            if (settings.suspendParseReplicationResult) {
-                context.suspendResultApplication();
-            } else {
-                context.resumeResultApplication();
-            }
-            if (previousReflectionFilter !== undefined && previousReflectionFilter !== nextReflectionFilter) {
-                fireAndForget(() => context.reprocessStoredDocuments());
-            }
-        });
-
-        return Promise.resolve(true);
-    };
-}

src/serviceFeatures/replication/automaticTriggers.unit.spec.ts

@@ -1,328 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-import {
-    AUTO_MERGED,
-    DEFAULT_SETTINGS,
-    REMOTE_P2P,
-    type FilePathWithPrefix,
-    type ObsidianLiveSyncSettings,
-} from "@vrtmrz/livesync-commonlib/compat/common/types";
-import { NO_INTERACTION } from "@vrtmrz/livesync-commonlib/replication";
-import { EVENT_FILE_SAVED, EVENT_SETTING_SAVED, eventHub } from "@/common/events";
-
-const taskMocks = vi.hoisted(() => ({
-    scheduleTask: vi.fn((_key: string, _delay: number, task: () => unknown) => task()),
-}));
-
-vi.mock("octagonal-wheels/concurrency/task", () => taskMocks);
-
-import { ModuleConflictResolver } from "@/modules/coreFeatures/ModuleConflictResolver";
-import { ModuleObsidianEvents } from "@/modules/essentialObsidian/ModuleObsidianEvents";
-import {
-    createReplicationSchedulingContext,
-    realiseReplicationScheduling,
-    resumeReplicationScheduling,
-    runPeriodicReplication,
-} from "@/serviceFeatures/replicationScheduling";
-import { createAutomaticReplicationTriggers } from "./automaticTriggers";
-
-function createApi() {
-    return {
-        addLog: vi.fn(),
-        addCommand: vi.fn(),
-        registerWindow: vi.fn(),
-        addRibbonIcon: vi.fn(),
-        registerProtocolHandler: vi.fn(),
-        setInterval: vi.fn(),
-        clearInterval: vi.fn(),
-    };
-}
-
-function p2pSettings(overrides: Partial<typeof DEFAULT_SETTINGS> = {}) {
-    return {
-        ...DEFAULT_SETTINGS,
-        remoteType: REMOTE_P2P,
-        isConfigured: true,
-        ...overrides,
-    };
-}
-
-function createObsidianEventHarness(settings: Partial<typeof DEFAULT_SETTINGS>) {
-    const save = vi.fn();
-    const saveCommand = { callback: save };
-    const replicateUnattendedByEvent = vi.fn(async () => ({ status: "completed" as const }));
-    const queueCheckForIfOpen = vi.fn(async () => undefined);
-    const services = {
-        API: createApi(),
-        appLifecycle: {
-            isReady: vi.fn(() => true),
-            isSuspended: vi.fn(() => false),
-        },
-        conflict: { queueCheckForIfOpen },
-        control: { hasUnloaded: vi.fn(() => false) },
-        fileProcessing: { commitPendingFileEvents: vi.fn(async () => true) },
-        replication: { replicateUnattendedByEvent },
-    };
-    const core = {
-        _services: services,
-        services,
-        settings: p2pSettings(settings),
-    } as any;
-    const plugin = {
-        app: {
-            commands: {
-                commands: { "editor:save-file": saveCommand },
-                executeCommandById: vi.fn(),
-            },
-        },
-    } as any;
-
-    return {
-        module: new ModuleObsidianEvents(plugin, core),
-        queueCheckForIfOpen,
-        replicateUnattendedByEvent,
-        save,
-        saveCommand,
-        services,
-    };
-}
-
-describe("automatic replication triggers while P2P is active", () => {
-    afterEach(() => {
-        eventHub.offAll();
-        taskMocks.scheduleTask.mockClear();
-    });
-
-    it("keeps periodic synchronisation on the provider-independent replication boundary", async () => {
-        const replicateUnattended = vi.fn(async () => ({ status: "completed" as const }));
-        const services = {
-            API: createApi(),
-            control: { hasUnloaded: vi.fn(() => false) },
-            replication: { replicateUnattended },
-        };
-        const core = {
-            _services: services,
-            services,
-            settings: p2pSettings({ periodicReplication: true, syncOnStart: false }),
-        } as any;
-        const context = createReplicationSchedulingContext({
-            isReady: vi.fn(() => true),
-            isSuspended: vi.fn(() => false),
-            currentSettings: vi.fn(() => core.settings),
-            replicateUnattended,
-            startContinuous: vi.fn(async () => ({ status: "completed" as const })),
-            timer: { enable: vi.fn(), disable: vi.fn() },
-            log: vi.fn(),
-        });
-
-        resumeReplicationScheduling(context);
-        await runPeriodicReplication(context);
-
-        expect(replicateUnattended).toHaveBeenCalledOnce();
-        expect(replicateUnattended).toHaveBeenCalledWith({
-            trigger: "periodic",
-            interaction: NO_INTERACTION,
-        });
-    });
-
-    it("keeps database-save synchronisation on the event replication boundary", async () => {
-        const replicateUnattendedByEvent = vi.fn(async (_request: unknown) => ({ status: "completed" as const }));
-        const settings = p2pSettings({ syncOnSave: true });
-        const initialise = createAutomaticReplicationTriggers({
-            currentSettings: () => settings,
-            isSuspended: vi.fn(() => false),
-            replicateDatabaseEvent: () =>
-                replicateUnattendedByEvent({
-                    trigger: "database-event",
-                    interaction: NO_INTERACTION,
-                }),
-            reprocessStoredDocuments: vi.fn(async () => 0),
-            resumeResultApplication: vi.fn(),
-            suspendResultApplication: vi.fn(),
-        });
-
-        await initialise();
-        eventHub.emitEvent(EVENT_FILE_SAVED);
-
-        await vi.waitFor(() => expect(replicateUnattendedByEvent).toHaveBeenCalledOnce());
-        expect(replicateUnattendedByEvent).toHaveBeenCalledWith({
-            trigger: "database-event",
-            interaction: NO_INTERACTION,
-        });
-    });
-
-    it("reprocesses stored documents when normal-file target filters change", async () => {
-        const settings = {
-            ...DEFAULT_SETTINGS,
-            ignoreFiles: ".gitignore",
-            syncOnlyRegEx: "^E2E/allowed/.*",
-        } as ObsidianLiveSyncSettings;
-        const reprocessStoredDocuments = vi.fn(async () => 1);
-        const resumeResultApplication = vi.fn();
-        const suspendResultApplication = vi.fn();
-        const initialise = createAutomaticReplicationTriggers({
-            currentSettings: () => settings,
-            isSuspended: vi.fn(() => false),
-            replicateDatabaseEvent: vi.fn(async () => undefined),
-            reprocessStoredDocuments,
-            resumeResultApplication,
-            suspendResultApplication,
-        });
-
-        await initialise();
-        eventHub.emitEvent(EVENT_SETTING_SAVED, { ...settings });
-        await Promise.resolve();
-        expect(reprocessStoredDocuments).not.toHaveBeenCalled();
-        expect(resumeResultApplication).toHaveBeenCalledOnce();
-        expect(suspendResultApplication).not.toHaveBeenCalled();
-
-        eventHub.emitEvent(EVENT_SETTING_SAVED, { ...settings, suspendParseReplicationResult: true });
-        expect(suspendResultApplication).toHaveBeenCalledOnce();
-
-        Object.assign(settings, { syncOnlyRegEx: "" });
-        eventHub.emitEvent(EVENT_SETTING_SAVED, { ...settings });
-        await vi.waitFor(() => expect(reprocessStoredDocuments).toHaveBeenCalledOnce());
-
-        settings.syncMaxSizeInMB = 10;
-        eventHub.emitEvent(EVENT_SETTING_SAVED, { ...settings });
-        await vi.waitFor(() => expect(reprocessStoredDocuments).toHaveBeenCalledTimes(2));
-    });
-
-    it("keeps editor-save synchronisation on the event replication boundary", async () => {
-        const { module, replicateUnattendedByEvent, save, saveCommand } = createObsidianEventHarness({
-            syncOnEditorSave: true,
-        });
-
-        module.swapSaveCommand();
-        saveCommand.callback();
-
-        expect(save).toHaveBeenCalledOnce();
-        await vi.waitFor(() => expect(replicateUnattendedByEvent).toHaveBeenCalledOnce());
-        expect(replicateUnattendedByEvent).toHaveBeenCalledWith({
-            trigger: "editor-save",
-            interaction: NO_INTERACTION,
-        });
-    });
-
-    it("keeps file-open synchronisation on the event replication boundary", async () => {
-        const { module, queueCheckForIfOpen, replicateUnattendedByEvent, services } = createObsidianEventHarness({
-            syncOnFileOpen: true,
-        });
-        const file = { path: "opened.md" } as never;
-
-        await module.watchWorkspaceOpenAsync(file);
-
-        expect(services.fileProcessing.commitPendingFileEvents).toHaveBeenCalledOnce();
-        expect(replicateUnattendedByEvent).toHaveBeenCalledOnce();
-        expect(replicateUnattendedByEvent).toHaveBeenCalledWith({
-            trigger: "file-open",
-            interaction: NO_INTERACTION,
-        });
-        expect(queueCheckForIfOpen).toHaveBeenCalledWith("opened.md");
-    });
-
-    it("keeps post-merge synchronisation on the event replication boundary", async () => {
-        const replicateUnattendedByEvent = vi.fn(async () => ({ status: "completed" as const }));
-        const queueCheckFor = vi.fn(async () => undefined);
-        const path = "merged.md" as FilePathWithPrefix;
-        const module = {
-            settings: p2pSettings({ syncAfterMerge: true }),
-            services: {
-                appLifecycle: { isSuspended: vi.fn(() => false) },
-                conflict: { queueCheckFor },
-                replication: { replicateUnattendedByEvent },
-            },
-            checkConflictAndPerformAutoMerge: vi.fn(async () => AUTO_MERGED),
-            _log: vi.fn(),
-        };
-
-        await (ModuleConflictResolver.prototype as any)._resolveConflict.call(module, path);
-
-        expect(replicateUnattendedByEvent).toHaveBeenCalledOnce();
-        expect(replicateUnattendedByEvent).toHaveBeenCalledWith({
-            trigger: "merge",
-            interaction: NO_INTERACTION,
-        });
-        expect(queueCheckFor).toHaveBeenCalledWith(path);
-    });
-});
-
-describe("recurring replication scheduling precedence", () => {
-    afterEach(() => {
-        eventHub.offAll();
-    });
-
-    function createRecurringSchedulingHarness() {
-        let resolveContinuous!: (
-            outcome: { status: "completed" } | { status: "blocked"; reason: "capability-not-applicable" }
-        ) => void;
-        const startContinuous = vi.fn(
-            () =>
-                new Promise<{ status: "completed" } | { status: "blocked"; reason: "capability-not-applicable" }>(
-                    (resolve) => {
-                        resolveContinuous = resolve;
-                    }
-                )
-        );
-        const API = createApi();
-        const settings = {
-            ...DEFAULT_SETTINGS,
-            isConfigured: true,
-            liveSync: true,
-            syncOnStart: true,
-            periodicReplication: true,
-            periodicReplicationInterval: 60,
-        };
-        const context = createReplicationSchedulingContext({
-            isReady: vi.fn(() => true),
-            isSuspended: vi.fn(() => false),
-            currentSettings: vi.fn(() => settings),
-            startContinuous,
-            replicateUnattended: vi.fn(async () => ({ status: "completed" as const })),
-            timer: {
-                enable: (interval) => {
-                    API.setInterval(vi.fn(), interval);
-                },
-                disable: () => {
-                    API.clearInterval(0);
-                },
-            },
-            log: vi.fn(),
-        });
-
-        return {
-            API,
-            resolveContinuous: (
-                outcome: { status: "completed" } | { status: "blocked"; reason: "capability-not-applicable" }
-            ) => resolveContinuous(outcome),
-            resume: async () => {
-                resumeReplicationScheduling(context);
-                await Promise.resolve();
-            },
-            realiseSettings: async () => {
-                realiseReplicationScheduling(context);
-                await Promise.resolve();
-            },
-        };
-    }
-
-    it("does not enable the generic periodic timer while Continuous owns recurring synchronisation", async () => {
-        const harness = createRecurringSchedulingHarness();
-
-        await harness.resume();
-        await harness.realiseSettings();
-
-        expect(harness.API.setInterval).not.toHaveBeenCalled();
-        harness.resolveContinuous({ status: "completed" });
-        await vi.waitFor(() => expect(harness.API.setInterval).not.toHaveBeenCalled());
-    });
-
-    it("restores the generic periodic timer when Continuous is not applicable", async () => {
-        const harness = createRecurringSchedulingHarness();
-
-        await harness.resume();
-        await harness.realiseSettings();
-        harness.resolveContinuous({ status: "blocked", reason: "capability-not-applicable" });
-
-        await vi.waitFor(() => expect(harness.API.setInterval).toHaveBeenCalledOnce());
-    });
-});

src/serviceFeatures/replication/centralCompatibilityRecovery.ts

@@ -1,211 +0,0 @@
-import type { ObsidianLiveSyncSettings } from "@vrtmrz/livesync-commonlib/compat/common/types";
-import { LOG_LEVEL_INFO, LOG_LEVEL_NOTICE, Logger } from "octagonal-wheels/common/logger";
-import { skipIfDuplicated } from "octagonal-wheels/concurrency/lock";
-import { balanceChunkPurgedDBs, purgeUnreferencedChunks } from "@vrtmrz/livesync-commonlib/compat/pouchdb/chunks";
-import { LiveSyncCouchDBReplicator } from "@vrtmrz/livesync-commonlib/compat/replication/couchdb/LiveSyncReplicator";
-import {
-    CENTRAL_COMPATIBILITY_REJECTION_REASONS,
-    type ReplicatorInstance,
-    type ReplicationFailureRequest,
-} from "@vrtmrz/livesync-commonlib/replication";
-import { $msg } from "@/common/translation";
-import { usesLegacyIndexedDBAdapter } from "@/common/compatibilitySettings";
-import type { LiveSyncBaseCore } from "@/LiveSyncBaseCore";
-
-type CentralCompatibilityRecoveryServices = Pick<
-    LiveSyncBaseCore["services"],
-    "API" | "appLifecycle" | "replicator" | "tweakValue"
->;
-
-/** Collaborators for applying a compatibility decision to its failed publication. */
-interface CentralCompatibilityRecoveryContext {
-    readonly confirm: LiveSyncBaseCore["confirm"];
-    /** Obtain the database only when recovery runs, after initialisation or reset. */
-    readonly getLocalDatabase: () => LiveSyncBaseCore["localDatabase"];
-    readonly rebuilder: LiveSyncBaseCore["rebuilder"];
-    readonly services: CentralCompatibilityRecoveryServices;
-}
-
-interface PreferredRemoteTweakWriter extends ReplicatorInstance {
-    setPreferredRemoteTweakSettings(setting: ObsidianLiveSyncSettings): Promise<void>;
-}
-
-interface ResolvedRemoteWriter extends ReplicatorInstance {
-    markRemoteResolved(setting: ObsidianLiveSyncSettings): Promise<void>;
-}
-
-function canSetPreferredRemoteTweakSettings(replicator: ReplicatorInstance): replicator is PreferredRemoteTweakWriter {
-    return (
-        "setPreferredRemoteTweakSettings" in replicator &&
-        typeof replicator.setPreferredRemoteTweakSettings === "function"
-    );
-}
-
-function canMarkRemoteResolved(replicator: ReplicatorInstance): replicator is ResolvedRemoteWriter {
-    return "markRemoteResolved" in replicator && typeof replicator.markRemoteResolved === "function";
-}
-
-/**
- * Compose central compatibility recovery around the exact failed publication.
- * Remote mutations re-admit that publication and become no-ops after a
- * replacement; the failure result is never re-read from the current instance.
- */
-export function createCentralCompatibilityRecovery(context: CentralCompatibilityRecoveryContext) {
-    async function reconcileCleanedRemote(
-        showMessage: boolean,
-        setting: ObsidianLiveSyncSettings,
-        expectedContext: ReplicationFailureRequest["context"]
-    ) {
-        Logger("The remote database has been cleaned.", showMessage ? LOG_LEVEL_NOTICE : LOG_LEVEL_INFO);
-        await skipIfDuplicated("cleanup", async () => {
-            const count = await purgeUnreferencedChunks(context.getLocalDatabase().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 selected = await context.confirm.confirmWithMessage(
-                "Cleaned",
-                message,
-                [CHOICE_FETCH, CHOICE_CLEAN, CHOICE_DISMISS],
-                CHOICE_DISMISS,
-                30
-            );
-            if (selected == CHOICE_FETCH) {
-                await context.rebuilder.$performRebuildDB("localOnly");
-            }
-            if (selected != CHOICE_CLEAN) return;
-
-            await context.services.replicator.runBoundedRemoteActivity(
-                () =>
-                    context.services.replicator.runWithActiveReplicatorContext(async (activeContext) => {
-                        if (activeContext !== expectedContext) return;
-                        const replicator = activeContext.replicator;
-                        if (!(replicator instanceof LiveSyncCouchDBReplicator)) return;
-                        const localDatabase = context.getLocalDatabase();
-                        const remoteDatabase = await replicator.connectRemoteCouchDBWithSetting(
-                            setting,
-                            context.services.API.isMobile(),
-                            true
-                        );
-                        if (typeof remoteDatabase == "string") {
-                            Logger(remoteDatabase, LOG_LEVEL_NOTICE);
-                            return false;
-                        }
-
-                        try {
-                            await purgeUnreferencedChunks(localDatabase.localDatabase, false);
-                            localDatabase.clearCaches();
-                            const replicated = await context.services.replicator.runFiniteReplicationActivity(
-                                () => replicator.openOneShotReplication(setting, showMessage, false, "sync", true),
-                                { label: "replication" }
-                            );
-                            if (replicated) {
-                                await balanceChunkPurgedDBs(localDatabase.localDatabase, remoteDatabase.db);
-                                await purgeUnreferencedChunks(localDatabase.localDatabase, false);
-                                localDatabase.clearCaches();
-                                await replicator.markRemoteResolved(setting);
-                                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
-                                );
-                            }
-                        } finally {
-                            await remoteDatabase.close();
-                        }
-                    }),
-                { label: "database-cleanup" }
-            );
-        });
-    }
-
-    async function handleReplicationFailure(request: ReplicationFailureRequest): Promise<boolean> {
-        const { context: failedContext, interaction, outcome, setting, showMessage } = request;
-        if (!showMessage) {
-            // Automatic requests may report the failure, but must not enter
-            // tweak, lock, fetch, unlock, or cleanup dialogues.
-            Logger("Replication failed on an unattended path.", LOG_LEVEL_INFO);
-            return false;
-        }
-        if (interaction.kind !== "permitted" || !interaction.permissions.failureRecovery) return false;
-        const recovery = outcome.recoveryHint;
-        if (!recovery) return false;
-
-        if (
-            recovery.reason === CENTRAL_COMPATIBILITY_REJECTION_REASONS.TWEAK_MISMATCH &&
-            recovery.preferredTweakValue
-        ) {
-            await context.services.tweakValue.askResolvingMismatched(
-                recovery.preferredTweakValue,
-                async (effectiveSetting) => {
-                    let updated = false;
-                    await context.services.replicator.runWithActiveReplicatorContext(async (activeContext) => {
-                        if (activeContext !== failedContext) return;
-                        if (!canSetPreferredRemoteTweakSettings(activeContext.replicator)) return;
-                        await activeContext.replicator.setPreferredRemoteTweakSettings({ ...effectiveSetting });
-                        updated = true;
-                    });
-                    return updated;
-                }
-            );
-            return false;
-        }
-
-        if (
-            recovery.reason !== CENTRAL_COMPATIBILITY_REJECTION_REASONS.NODE_LOCKED &&
-            recovery.reason !== CENTRAL_COMPATIBILITY_REJECTION_REASONS.NODE_CLEANED
-        ) {
-            return false;
-        }
-        if (
-            recovery.reason === CENTRAL_COMPATIBILITY_REJECTION_REASONS.NODE_CLEANED &&
-            usesLegacyIndexedDBAdapter(setting)
-        ) {
-            await reconcileCleanedRemote(showMessage, setting, failedContext);
-            return false;
-        }
-
-        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 selected = await context.confirm.askSelectStringDialogue(
-            message,
-            [CHOICE_FETCH, CHOICE_UNLOCK, CHOICE_DISMISS],
-            {
-                title: $msg("Replicator.Dialogue.Locked.Title"),
-                defaultAction: CHOICE_DISMISS,
-                timeout: 60,
-            }
-        );
-        if (selected == CHOICE_FETCH) {
-            Logger($msg("Replicator.Dialogue.Locked.Message.Fetch"), LOG_LEVEL_NOTICE);
-            await context.rebuilder.scheduleFetch();
-            context.services.appLifecycle.scheduleRestart();
-            return false;
-        }
-        if (selected != CHOICE_UNLOCK) return false;
-
-        let unlocked = false;
-        await context.services.replicator.runWithActiveReplicatorContext(async (activeContext) => {
-            if (activeContext !== failedContext) return;
-            if (!canMarkRemoteResolved(activeContext.replicator)) return;
-            await activeContext.replicator.markRemoteResolved(setting);
-            unlocked = true;
-        });
-        if (unlocked) {
-            Logger($msg("Replicator.Dialogue.Locked.Message.Unlocked"), LOG_LEVEL_NOTICE);
-        }
-        return false;
-    }
-
-    return Object.freeze({ handleReplicationFailure, reconcileCleanedRemote });
-}