@peers-app/peers-ui 0.27.2 → 0.27.4

package/dist/screens/network-viewer/network-viewer-ipc.d.ts

@@ -1,4 +1,4 @@
-import { type INetworkControlConsumer, type INetworkDiagnosticsConsumer } from "@peers-app/peers-sdk";
+import { type INetworkControlConsumer, type INetworkDiagnosticsConsumer, type ISyncCheckConsumer } from "@peers-app/peers-sdk";
 /** Electron-only capabilities intentionally excluded from portable network contracts. */
 export type NetworkViewerPlatformApi = {
     downloadRemoteDatabase?: (groupId: string, deviceId: string) => Promise<unknown>;
@@ -8,5 +8,7 @@ export type NetworkViewerPlatformApi = {
 export declare function getNetworkDiagnosticsConsumer(): Promise<INetworkDiagnosticsConsumer>;
 /** Return a typed control consumer bound to the current local host transport. */
 export declare function getNetworkControlConsumer(): Promise<INetworkControlConsumer>;
+/** Return a typed System Sync Check consumer bound to the current local host transport. */
+export declare function getSyncCheckConsumer(): Promise<ISyncCheckConsumer>;
 /** Return the context-isolated desktop-only capability bridge, when available. */
 export declare function getNetworkViewerPlatformApi(): NetworkViewerPlatformApi | undefined;

package/dist/screens/network-viewer/network-viewer-ipc.js

@@ -2,10 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getNetworkDiagnosticsConsumer = getNetworkDiagnosticsConsumer;
 exports.getNetworkControlConsumer = getNetworkControlConsumer;
+exports.getSyncCheckConsumer = getSyncCheckConsumer;
 exports.getNetworkViewerPlatformApi = getNetworkViewerPlatformApi;
 const peers_sdk_1 = require("@peers-app/peers-sdk");
 const diagnostics = (0, peers_sdk_1.hostContractConsumer)((0, peers_sdk_1.getNetworkDiagnosticsContractDefinition)());
 const control = (0, peers_sdk_1.hostContractConsumer)((0, peers_sdk_1.getNetworkControlContractDefinition)());
+const syncCheck = (0, peers_sdk_1.hostContractConsumer)((0, peers_sdk_1.getSyncCheckContractDefinition)());
 /** Return a typed diagnostics consumer bound to the current local host transport. */
 async function getNetworkDiagnosticsConsumer() {
     return diagnostics.get();
@@ -14,6 +16,10 @@ async function getNetworkDiagnosticsConsumer() {
 async function getNetworkControlConsumer() {
     return control.get();
 }
+/** Return a typed System Sync Check consumer bound to the current local host transport. */
+async function getSyncCheckConsumer() {
+    return syncCheck.get();
+}
 /** Return the context-isolated desktop-only capability bridge, when available. */
 function getNetworkViewerPlatformApi() {
     return window.electronAPI?.networkViewer;

package/dist/screens/network-viewer/sync-recovery.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SyncRecoveryScreen = SyncRecoveryScreen;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const peers_sdk_1 = require("@peers-app/peers-sdk");
 const react_1 = require("react");
 const react_tiny_popover_1 = require("react-tiny-popover");
 const loading_indicator_1 = require("../../components/loading-indicator");
@@ -76,6 +77,107 @@ function RecoveryRows({ entry, busy, onRun, }) {
                                         : "This device has no row to keep", onClick: () => onRun(entry, "keepLocal"), children: "Keep this device's version" }), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-outline-danger", disabled: busy, onClick: () => onRun(entry, "deleteEverywhere"), children: "Delete everywhere" }), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-outline-secondary", disabled: busy, title: "Removes the entry on this device only. Other devices keep theirs.", onClick: () => onRun(entry, "ignoreLocal"), children: "Ignore on this device" })] }) })] }), (errorOpen || recordOpen) && ((0, jsx_runtime_1.jsx)("tr", { children: (0, jsx_runtime_1.jsxs)("td", { colSpan: 7, className: "bg-body-tertiary", children: [errorOpen && ((0, jsx_runtime_1.jsx)("pre", { className: "small mb-0 font-monospace", style: detailsBlockStyle, children: formatError(entry.latestError) })), recordOpen && ((0, jsx_runtime_1.jsxs)("div", { className: errorOpen ? "mt-3" : undefined, children: [entry.changeCreatedAt != null && ((0, jsx_runtime_1.jsxs)("p", { className: "small mb-2", children: ["Change written ", formatWhen(entry.changeCreatedAt)] })), entry.conflictingRecordId && ((0, jsx_runtime_1.jsxs)("p", { className: "small mb-2", children: ["Another record holds the same unique value:", " ", (0, jsx_runtime_1.jsx)("code", { children: entry.conflictingRecordId })] })), entry.tombstoneRecordId &&
                                     entry.tombstoneRecordId === entry.conflictingRecordId && ((0, jsx_runtime_1.jsxs)("p", { className: "small mb-2", children: ["Keep deletes ", (0, jsx_runtime_1.jsx)("code", { children: entry.tombstoneRecordId }), " on every device."] })), entry.tombstoneRecordId && entry.tombstoneRecordId === entry.recordId && ((0, jsx_runtime_1.jsx)("p", { className: "small mb-2", children: "Keep snapshots the other record and tombstones this queued id." })), entry.keptRecordPreview && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("p", { className: "small mb-1", children: "This device's version" }), (0, jsx_runtime_1.jsx)("pre", { className: "small mb-2 font-monospace", style: detailsBlockStyle, children: entry.keptRecordPreview })] })), entry.queuedRecordPreview && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("p", { className: "small mb-1", children: "Queued change" }), (0, jsx_runtime_1.jsx)("pre", { className: "small mb-0 font-monospace", style: detailsBlockStyle, children: entry.queuedRecordPreview })] })), !entry.keptRecordPreview && !entry.queuedRecordPreview && entry.recordPreview && ((0, jsx_runtime_1.jsx)("pre", { className: "small mb-0 font-monospace", style: detailsBlockStyle, children: entry.recordPreview })), !entry.keptRecordPreview && !entry.queuedRecordPreview && !entry.recordPreview && ((0, jsx_runtime_1.jsx)("p", { className: "small text-muted mb-0", children: "This device has no stored copy of the record. The latest error may still quote the rejected value." }))] }))] }) }))] }));
 }
+function MissingChangeRows({ gap }) {
+    const [open, setOpen] = (0, react_1.useState)(false);
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-link btn-sm p-0", "aria-label": open ? "Hide missing changes" : "Show missing changes", onClick: () => setOpen((current) => !current), children: open ? "Hide changes" : "Show changes" }), open && ((0, jsx_runtime_1.jsxs)("table", { className: "table table-sm small mb-0 mt-1", children: [(0, jsx_runtime_1.jsx)("thead", { children: (0, jsx_runtime_1.jsxs)("tr", { children: [(0, jsx_runtime_1.jsx)("th", { children: "Table" }), (0, jsx_runtime_1.jsx)("th", { children: "Record" }), (0, jsx_runtime_1.jsx)("th", { children: "Change" }), (0, jsx_runtime_1.jsx)("th", { children: "Written" })] }) }), (0, jsx_runtime_1.jsx)("tbody", { children: gap.missing.map((change) => ((0, jsx_runtime_1.jsxs)("tr", { children: [(0, jsx_runtime_1.jsx)("td", { children: change.tableName }), (0, jsx_runtime_1.jsx)("td", { children: (0, jsx_runtime_1.jsx)("code", { children: change.recordId }) }), (0, jsx_runtime_1.jsx)("td", { children: (0, jsx_runtime_1.jsxs)("code", { title: change.changeId, children: [change.op, " ", change.path] }) }), (0, jsx_runtime_1.jsx)("td", { className: "text-nowrap", children: formatWhen(change.createdAt) })] }, change.changeId))) })] })), open && gap.missingCount > gap.missing.length && ((0, jsx_runtime_1.jsxs)("div", { className: "small text-muted", children: ["Showing ", gap.missing.length, " of ", gap.missingCount, "."] }))] }));
+}
+/** What the daily sync gap check found missing on this device, with Check now and Repair. */
+function MissingChangesSection() {
+    const [gaps, setGaps] = (0, react_1.useState)([]);
+    const [availability, setAvailability] = (0, react_1.useState)("loading");
+    const loadGeneration = (0, react_1.useRef)(0);
+    const [busyKey, setBusyKey] = (0, react_1.useState)(null);
+    const [result, setResult] = (0, react_1.useState)(null);
+    const load = (0, react_1.useCallback)(async () => {
+        const generation = ++loadGeneration.current;
+        try {
+            const syncCheck = await (0, network_viewer_ipc_1.getSyncCheckConsumer)();
+            const { gaps } = await syncCheck.tools.getSyncGaps();
+            if (generation !== loadGeneration.current)
+                return;
+            setGaps(gaps);
+            setAvailability("ready");
+        }
+        catch (loadError) {
+            if (generation !== loadGeneration.current)
+                return;
+            setAvailability("unavailable");
+            setGaps([]);
+            setResult({
+                success: false,
+                message: loadError instanceof Error ? loadError.message : String(loadError),
+            });
+        }
+    }, []);
+    (0, react_1.useEffect)(() => {
+        let active = true;
+        let generation = 0;
+        let subscription;
+        const connect = () => {
+            const currentGeneration = ++generation;
+            subscription?.dispose();
+            subscription = undefined;
+            setAvailability("loading");
+            setGaps([]);
+            setResult(null);
+            void load();
+            void (0, network_viewer_ipc_1.getSyncCheckConsumer)()
+                .then((syncCheck) => {
+                if (active && generation === currentGeneration) {
+                    subscription = syncCheck.observables?.status.subscribe(() => void load());
+                }
+            })
+                .catch(() => {
+                // `load` shows the unavailable state, including hosts without System Sync Check.
+            });
+        };
+        connect();
+        const unsubscribe = (0, peers_sdk_1.subscribeHostContractTransport)((transport) => {
+            if (transport)
+                connect();
+            else {
+                generation++;
+                loadGeneration.current++;
+                subscription?.dispose();
+                subscription = undefined;
+                setAvailability("unavailable");
+                setGaps([]);
+            }
+        }, { emitCurrent: false });
+        return () => {
+            active = false;
+            loadGeneration.current++;
+            subscription?.dispose();
+            unsubscribe();
+        };
+    }, [load]);
+    const run = async (key, action) => {
+        setBusyKey(key);
+        setResult(null);
+        try {
+            setResult({ success: true, message: (await action()).message });
+        }
+        catch (actionError) {
+            setResult({
+                success: false,
+                message: actionError instanceof Error ? actionError.message : String(actionError),
+            });
+        }
+        finally {
+            setBusyKey(null);
+            await load();
+        }
+    };
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "card mb-3", children: [(0, jsx_runtime_1.jsxs)("div", { className: "card-header d-flex justify-content-between align-items-center", children: [(0, jsx_runtime_1.jsxs)("span", { children: ["Missing changes", (0, jsx_runtime_1.jsxs)(InfoTip, { label: "About missing changes", children: ["Once a day this device compares its changes with each connected device in every group. Listed here are changes another device has that this device should have received but doesn't. ", (0, jsx_runtime_1.jsx)("strong", { children: "Repair" }), " fetches them from that device and applies them the same way sync does. If changes keep going missing, that points to a sync problem worth reporting."] })] }), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-outline-primary", disabled: busyKey !== null || availability !== "ready", onClick: () => void run("check", async () => (await (0, network_viewer_ipc_1.getSyncCheckConsumer)()).tools.checkSyncGaps()), children: busyKey === "check" ? "Checking…" : "Check now" })] }), (0, jsx_runtime_1.jsxs)("div", { className: "card-body py-2", children: [result && ((0, jsx_runtime_1.jsx)("div", { className: `alert ${result.success ? "alert-info" : "alert-danger"} py-1 px-2 small mb-2`, children: result.message })), availability !== "ready" ? ((0, jsx_runtime_1.jsx)("div", { className: "small text-muted", children: availability === "loading"
+                            ? "Loading missing change check…"
+                            : "Missing change check is unavailable on this host." })) : gaps.length === 0 ? ((0, jsx_runtime_1.jsx)("div", { className: "small text-muted", children: "No missing changes found. Checks run once a day." })) : (gaps.map((gap) => {
+                        const key = `${gap.dataContextId}:${gap.deviceId}`;
+                        return ((0, jsx_runtime_1.jsxs)("div", { className: "border-bottom py-2", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex justify-content-between align-items-start gap-2", children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("strong", { children: gap.dataContextName }), ": ", gap.missingCount, gap.truncated ? "+" : "", " ", gap.missingCount === 1 ? "change" : "changes", " on", " ", (0, jsx_runtime_1.jsx)("span", { title: gap.deviceId, children: gap.deviceName || gap.deviceId }), " missing here", (0, jsx_runtime_1.jsxs)("div", { className: "small text-muted", children: ["Found ", formatWhen(gap.checkedAt)] })] }), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-warning text-nowrap", disabled: busyKey !== null, onClick: () => void run(key, async () => (await (0, network_viewer_ipc_1.getSyncCheckConsumer)()).tools.repairSyncGaps({
+                                                dataContextId: gap.dataContextId,
+                                                deviceId: gap.deviceId,
+                                            })), children: busyKey === key ? "Repairing…" : "Repair" })] }), (0, jsx_runtime_1.jsx)(MissingChangeRows, { gap: gap })] }, key));
+                    }))] })] }));
+}
 /** Lists recovery-queue entries and the actions that resolve them. */
 function SyncRecoveryScreen({ onBack }) {
     const [entries, setEntries] = (0, react_1.useState)([]);
@@ -178,5 +280,5 @@ function SyncRecoveryScreen({ onBack }) {
         group.push(entry);
         groups.set(entry.dataContextId, group);
     }
-    return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid p-4", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex justify-content-between align-items-center mb-3", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center gap-3", children: [(0, jsx_runtime_1.jsxs)("button", { type: "button", className: "btn btn-sm btn-outline-secondary", onClick: onBack, children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-arrow-left me-1" }), "Back"] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("h2", { className: "mb-1", children: "Sync recovery" }), (0, jsx_runtime_1.jsx)("p", { className: "text-muted small mb-0", children: "These records have change history, but this device could not write the row. Parked entries are not asked of other devices until you retry them." })] })] }), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-primary", onClick: () => void load(), children: "Refresh" })] }), error && (0, jsx_runtime_1.jsx)("div", { className: "alert alert-danger py-2 small", children: error }), entries.length === 0 ? ((0, jsx_runtime_1.jsx)("div", { className: "alert alert-success", children: "No records are waiting in the recovery queue." })) : ([...groups.entries()].map(([dataContextId, groupEntries]) => ((0, jsx_runtime_1.jsxs)("div", { className: "card mb-3", children: [(0, jsx_runtime_1.jsx)("div", { className: "card-header", children: groupEntries[0]?.dataContextName || dataContextId }), (0, jsx_runtime_1.jsx)("div", { className: "table-responsive", children: (0, jsx_runtime_1.jsxs)("table", { className: "table table-sm align-middle mb-0", children: [(0, jsx_runtime_1.jsx)("thead", { children: (0, jsx_runtime_1.jsxs)("tr", { children: [(0, jsx_runtime_1.jsx)("th", { children: "Table" }), (0, jsx_runtime_1.jsx)("th", { children: "Record" }), (0, jsx_runtime_1.jsx)("th", { children: "First failed" }), (0, jsx_runtime_1.jsx)("th", { children: "Attempts" }), (0, jsx_runtime_1.jsx)("th", { children: "Status" }), (0, jsx_runtime_1.jsx)("th", { children: "Latest error" }), (0, jsx_runtime_1.jsxs)("th", { children: ["Actions", (0, jsx_runtime_1.jsx)(InfoTip, { label: "About these actions", children: (0, jsx_runtime_1.jsxs)("ul", { className: "mb-0 ps-3", children: [(0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("strong", { children: "Retry" }), " writes the record again from this device's history, then asks another device once. If a schema or unique-key entry is still queued after that, it is parked again. Use it after an upgrade that might accept a row this device rejected before."] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("strong", { children: "Keep this device's version" }), " snapshots the row this device will keep. That is the queued row when it is already stored here, and otherwise the other row that holds the same unique value. When both rows are stored, the other record is deleted everywhere. When only the other row is stored, that row is kept and this queued id is tombstoned. Disabled when this device has no row to keep."] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("strong", { children: "Delete everywhere" }), " deletes this record on every device, including devices that already have it."] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("strong", { children: "Ignore on this device" }), " removes the entry here only. Other devices keep their own copy of the problem."] })] }) })] })] }) }), (0, jsx_runtime_1.jsx)("tbody", { children: groupEntries.map((entry) => ((0, jsx_runtime_1.jsx)(RecoveryRows, { entry: entry, busy: Boolean(busyKey?.startsWith(`${entry.dataContextId}:${entry.syncRecoveryId}:`)), onRun: (item, action) => void run(item, action) }, entry.syncRecoveryId))) })] }) })] }, dataContextId))))] }));
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid p-4", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex justify-content-between align-items-center mb-3", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center gap-3", children: [(0, jsx_runtime_1.jsxs)("button", { type: "button", className: "btn btn-sm btn-outline-secondary", onClick: onBack, children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-arrow-left me-1" }), "Back"] }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("h2", { className: "mb-1", children: "Sync recovery" }), (0, jsx_runtime_1.jsx)("p", { className: "text-muted small mb-0", children: "These records have change history, but this device could not write the row. Parked entries are not asked of other devices until you retry them." })] })] }), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-primary", onClick: () => void load(), children: "Refresh" })] }), error && (0, jsx_runtime_1.jsx)("div", { className: "alert alert-danger py-2 small", children: error }), (0, jsx_runtime_1.jsx)(MissingChangesSection, {}), entries.length === 0 ? ((0, jsx_runtime_1.jsx)("div", { className: "alert alert-success", children: "No records are waiting in the recovery queue." })) : ([...groups.entries()].map(([dataContextId, groupEntries]) => ((0, jsx_runtime_1.jsxs)("div", { className: "card mb-3", children: [(0, jsx_runtime_1.jsx)("div", { className: "card-header", children: groupEntries[0]?.dataContextName || dataContextId }), (0, jsx_runtime_1.jsx)("div", { className: "table-responsive", children: (0, jsx_runtime_1.jsxs)("table", { className: "table table-sm align-middle mb-0", children: [(0, jsx_runtime_1.jsx)("thead", { children: (0, jsx_runtime_1.jsxs)("tr", { children: [(0, jsx_runtime_1.jsx)("th", { children: "Table" }), (0, jsx_runtime_1.jsx)("th", { children: "Record" }), (0, jsx_runtime_1.jsx)("th", { children: "First failed" }), (0, jsx_runtime_1.jsx)("th", { children: "Attempts" }), (0, jsx_runtime_1.jsx)("th", { children: "Status" }), (0, jsx_runtime_1.jsx)("th", { children: "Latest error" }), (0, jsx_runtime_1.jsxs)("th", { children: ["Actions", (0, jsx_runtime_1.jsx)(InfoTip, { label: "About these actions", children: (0, jsx_runtime_1.jsxs)("ul", { className: "mb-0 ps-3", children: [(0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("strong", { children: "Retry" }), " writes the record again from this device's history, then asks another device once. If a schema or unique-key entry is still queued after that, it is parked again. Use it after an upgrade that might accept a row this device rejected before."] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("strong", { children: "Keep this device's version" }), " snapshots the row this device will keep. That is the queued row when it is already stored here, and otherwise the other row that holds the same unique value. When both rows are stored, the other record is deleted everywhere. When only the other row is stored, that row is kept and this queued id is tombstoned. Disabled when this device has no row to keep."] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("strong", { children: "Delete everywhere" }), " deletes this record on every device, including devices that already have it."] }), (0, jsx_runtime_1.jsxs)("li", { children: [(0, jsx_runtime_1.jsx)("strong", { children: "Ignore on this device" }), " removes the entry here only. Other devices keep their own copy of the problem."] })] }) })] })] }) }), (0, jsx_runtime_1.jsx)("tbody", { children: groupEntries.map((entry) => ((0, jsx_runtime_1.jsx)(RecoveryRows, { entry: entry, busy: Boolean(busyKey?.startsWith(`${entry.dataContextId}:${entry.syncRecoveryId}:`)), onRun: (item, action) => void run(item, action) }, entry.syncRecoveryId))) })] }) })] }, dataContextId))))] }));
 }

package/dist/screens/variables/variable-details.js

@@ -99,7 +99,8 @@ const CopyValueButton = (props) => {
     async function onCopy() {
         try {
             const userContext = await (0, peers_sdk_1.getUserContext)();
-            const groupId = userContext.currentlyActiveGroupId();
+            // Personal can be "" here; leave it out so the provider uses the personal context.
+            const groupId = userContext.currentlyActiveGroupId() || undefined;
             const tools = await (0, host_shell_consumer_1.hostShellTools)();
             const result = await tools.copyVariableToClipboard({
                 persistentVarId: pvar.persistentVarId,

package/dist/tabs-layout/network-status-indicator.js

@@ -37,13 +37,25 @@ function disconnectedLabelSuffix(disconnectedContextCount) {
 function connectedLabelSuffix(connectedContextCount) {
     return `; ${connectedContextCount} ${connectedContextCount === 1 ? "group" : "groups"} connected`;
 }
-function withStuckAttention(presentation, stuckRecoveryCount) {
-    if (stuckRecoveryCount <= 0) {
+function missingChangesLabel(missingChangeCount) {
+    return missingChangeCount === 1
+        ? "1 change missing from another device"
+        : `${missingChangeCount} changes missing from another device`;
+}
+function withStuckAttention(presentation, stuckRecoveryCount, missingChangeCount) {
+    if (stuckRecoveryCount <= 0 && missingChangeCount <= 0) {
         return presentation;
     }
-    const attention = stuckRecoveryCount === 1
-        ? "1 record needs attention"
-        : `${stuckRecoveryCount} records need attention`;
+    const attention = [
+        stuckRecoveryCount === 1
+            ? "1 record needs attention"
+            : stuckRecoveryCount > 1
+                ? `${stuckRecoveryCount} records need attention`
+                : "",
+        missingChangeCount > 0 ? missingChangesLabel(missingChangeCount) : "",
+    ]
+        .filter(Boolean)
+        .join("; ");
     const labeled = { ...presentation, label: `${presentation.label}; ${attention}` };
     if (presentation.colorClass === "text-danger") {
         return labeled;
@@ -79,6 +91,7 @@ function getNetworkStatusPresentation(viewState, opts) {
         };
     }
     const { connectedContextCount, connectionCount, disconnectedContextCount, errorCount, state, stuckRecoveryCount, syncingContextCount, } = viewState.status;
+    const missingChangeCount = viewState.missingChangeCount ?? 0;
     const disconnectedOverlay = disconnectedContextCount > 0 && state !== "offline"
         ? { count: disconnectedContextCount }
         : undefined;
@@ -95,7 +108,7 @@ function getNetworkStatusPresentation(viewState, opts) {
             mark: "solid",
             disconnectedGroupsOverlay: disconnectedOverlay,
             connectedGroupsOverlay: groupsOverlay,
-        }, stuckRecoveryCount);
+        }, stuckRecoveryCount, missingChangeCount);
     }
     if (state === "syncing" || opts?.holdSyncingVisual) {
         const longSync = state === "syncing" && opts?.syncingLongerThanGreenMs === true;
@@ -109,7 +122,7 @@ function getNetworkStatusPresentation(viewState, opts) {
             mark: longSync ? "indeterminate" : "pulse",
             disconnectedGroupsOverlay: disconnectedOverlay,
             connectedGroupsOverlay: groupsOverlay,
-        }, stuckRecoveryCount);
+        }, stuckRecoveryCount, missingChangeCount);
     }
     if (state === "offline") {
         return withStuckAttention({
@@ -117,7 +130,7 @@ function getNetworkStatusPresentation(viewState, opts) {
             shortLabel: "Offline",
             iconClass: "bi-cloud-slash-fill",
             colorClass: "text-secondary",
-        }, stuckRecoveryCount);
+        }, stuckRecoveryCount, missingChangeCount);
     }
     return withStuckAttention({
         label: `Network synced; ${connectionCount} active ${connectionCount === 1 ? "connection" : "connections"}${connectedSuffix}${disconnectedSuffix}`,
@@ -127,7 +140,7 @@ function getNetworkStatusPresentation(viewState, opts) {
         compactIcon: true,
         disconnectedGroupsOverlay: disconnectedOverlay,
         connectedGroupsOverlay: groupsOverlay,
-    }, stuckRecoveryCount);
+    }, stuckRecoveryCount, missingChangeCount);
 }
 /**
  * Add the app-update badge and label to a network status presentation. Applies in every
@@ -233,10 +246,11 @@ function StatusCountRow({ label, value, className, }) {
     const tone = className ? ` ${className}` : "";
     return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("dt", { className: `col-7${tone}`, children: label }), (0, jsx_runtime_1.jsx)("dd", { className: `col-5 text-end${tone}`, children: value })] }));
 }
-function NetworkStatusDetails({ detailsId, status, appUpdate, unavailable, connectionsLoadState, onUseInvite, onOpenIdentity, onOpenViewer, onOpenRecovery, }) {
+function NetworkStatusDetails({ detailsId, status, missingChangeCount, appUpdate, unavailable, connectionsLoadState, onUseInvite, onOpenIdentity, onOpenViewer, onOpenRecovery, }) {
+    const needsRecovery = !!status && (status.stuckRecoveryCount > 0 || missingChangeCount > 0);
     return ((0, jsx_runtime_1.jsx)("div", { id: detailsId, role: "dialog", "aria-label": "Network status details", className: "card shadow position-absolute end-0 mt-1", style: { top: "100%", width: "320px", zIndex: 1100 }, children: (0, jsx_runtime_1.jsxs)("div", { className: "card-body p-3", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex gap-2 mb-3", children: [(0, jsx_runtime_1.jsxs)("button", { type: "button", className: "btn btn-sm btn-outline-primary flex-fill", onClick: onUseInvite, children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-qr-code me-1", "aria-hidden": "true" }), "Use Invite"] }), (0, jsx_runtime_1.jsxs)("button", { type: "button", className: "btn btn-sm btn-outline-primary flex-fill", onClick: onOpenIdentity, children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-person-badge me-1", "aria-hidden": "true" }), "Identity"] })] }), (0, jsx_runtime_1.jsx)(app_update_controls_1.AppUpdatePopoverSection, { status: appUpdate }), (0, jsx_runtime_1.jsx)("h6", { className: "card-title mb-2", children: "Network status" }), unavailable || !status ? ((0, jsx_runtime_1.jsx)("p", { className: "small text-muted mb-3", children: "Network diagnostics are temporarily unavailable. The local host may still be starting or reconnecting." })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("dl", { className: "row small mb-2", children: [(0, jsx_runtime_1.jsx)(StatusCountRow, { label: "Connections", value: status.connectionCount }), (0, jsx_runtime_1.jsx)(StatusCountRow, { label: "Groups connected", value: status.connectedContextCount }), status.syncingContextCount > 0 && ((0, jsx_runtime_1.jsx)(StatusCountRow, { label: "Syncing contexts", value: status.syncingContextCount })), status.disconnectedContextCount > 0 && ((0, jsx_runtime_1.jsx)(StatusCountRow, { label: "Groups offline", value: status.disconnectedContextCount, className: "text-warning" })), status.errorCount > 0 && ((0, jsx_runtime_1.jsx)(StatusCountRow, { label: "Sync errors", value: status.errorCount })), status.lastSuccessfulSyncAt != null && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("dt", { className: "col-7", children: "Last sync" }), (0, jsx_runtime_1.jsx)("dd", { className: "col-5 text-end text-truncate", title: new Date(status.lastSuccessfulSyncAt).toLocaleString(), children: formatRelativeSyncTime(status.lastSuccessfulSyncAt) })] }))] }), status.errors.length > 0 && ((0, jsx_runtime_1.jsxs)("div", { className: "alert alert-danger py-2 px-2 small mb-2", children: [status.errors[0].message, status.errors.length > 1 && ` (+${status.errors.length - 1} more)`] })), status.stuckRecoveryCount > 0 && ((0, jsx_runtime_1.jsx)("div", { className: "alert alert-warning py-2 px-2 small mb-2", children: status.stuckRecoveryCount === 1
                                 ? "1 record needs attention"
-                                : `${status.stuckRecoveryCount} records need attention` })), (0, jsx_runtime_1.jsxs)("div", { className: "border-top pt-2 mt-1 mb-2", children: [(0, jsx_runtime_1.jsx)("div", { className: "small text-muted mb-1", children: "Connected Devices" }), (0, jsx_runtime_1.jsx)(ConnectedDevicesList, { loadState: connectionsLoadState })] })] })), (0, jsx_runtime_1.jsx)("button", { type: "button", className: `btn btn-sm btn-outline-primary w-100${status && status.stuckRecoveryCount > 0 ? " mb-2" : ""}`, onClick: onOpenViewer, children: "Open Network Viewer" }), status && status.stuckRecoveryCount > 0 && ((0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-warning w-100", onClick: onOpenRecovery, children: "Sync recovery" }))] }) }));
+                                : `${status.stuckRecoveryCount} records need attention` })), missingChangeCount > 0 && ((0, jsx_runtime_1.jsx)("div", { className: "alert alert-warning py-2 px-2 small mb-2", children: missingChangesLabel(missingChangeCount) })), (0, jsx_runtime_1.jsxs)("div", { className: "border-top pt-2 mt-1 mb-2", children: [(0, jsx_runtime_1.jsx)("div", { className: "small text-muted mb-1", children: "Connected Devices" }), (0, jsx_runtime_1.jsx)(ConnectedDevicesList, { loadState: connectionsLoadState })] })] })), (0, jsx_runtime_1.jsx)("button", { type: "button", className: `btn btn-sm btn-outline-primary w-100${needsRecovery ? " mb-2" : ""}`, onClick: onOpenViewer, children: "Open Network Viewer" }), needsRecovery && ((0, jsx_runtime_1.jsx)("button", { type: "button", className: "btn btn-sm btn-warning w-100", onClick: onOpenRecovery, children: "Sync recovery" }))] }) }));
 }
 /** Accessible reactive network status button and details popover. */
 function NetworkStatusIndicator({ compact = false }) {
@@ -363,7 +377,7 @@ function NetworkStatusIndicator({ compact = false }) {
                 .network-status-update-badge.bi::before {
                   vertical-align: 0;
                 }
-              ` })] }))] }), !compact && ((0, jsx_runtime_1.jsxs)("span", { className: "small", children: [viewState.status?.connectionCount ?? 0, (0, jsx_runtime_1.jsx)("span", { className: "visually-hidden", children: " connections" })] }))] }), open && ((0, jsx_runtime_1.jsx)(NetworkStatusDetails, { detailsId: detailsId, status: viewState.status, appUpdate: appUpdate, unavailable: viewState.availability !== "ready", connectionsLoadState: connectionsLoadState, onUseInvite: () => {
+              ` })] }))] }), !compact && ((0, jsx_runtime_1.jsxs)("span", { className: "small", children: [viewState.status?.connectionCount ?? 0, (0, jsx_runtime_1.jsx)("span", { className: "visually-hidden", children: " connections" })] }))] }), open && ((0, jsx_runtime_1.jsx)(NetworkStatusDetails, { detailsId: detailsId, status: viewState.status, missingChangeCount: viewState.missingChangeCount ?? 0, appUpdate: appUpdate, unavailable: viewState.availability !== "ready", connectionsLoadState: connectionsLoadState, onUseInvite: () => {
                     setOpen(false);
                     (0, tabs_state_1.goToTabPath)(identity_routes_1.IDENTITY_ACCEPT_PATH);
                 }, onOpenIdentity: () => {

package/dist/tabs-layout/use-network-status.d.ts

@@ -3,6 +3,11 @@ import { type INetworkStatusSummary } from "@peers-app/peers-sdk";
 export interface INetworkStatusViewState {
     availability: "loading" | "ready" | "unavailable";
     status?: INetworkStatusSummary;
+    /** Changes the daily sync gap check found on another device but not on this one. */
+    missingChangeCount?: number;
 }
-/** Subscribe to the current host's System Network Diagnostics status observable. */
+/**
+ * Subscribe to the current host's System Network Diagnostics status observable, and to System
+ * Sync Check's missing-change count.
+ */
 export declare function useNetworkStatus(): INetworkStatusViewState;

package/dist/tabs-layout/use-network-status.js

@@ -4,7 +4,10 @@ exports.useNetworkStatus = useNetworkStatus;
 const peers_sdk_1 = require("@peers-app/peers-sdk");
 const react_1 = require("react");
 const network_viewer_ipc_1 = require("../screens/network-viewer/network-viewer-ipc");
-/** Subscribe to the current host's System Network Diagnostics status observable. */
+/**
+ * Subscribe to the current host's System Network Diagnostics status observable, and to System
+ * Sync Check's missing-change count.
+ */
 function useNetworkStatus() {
     const [viewState, setViewState] = (0, react_1.useState)({
         availability: "loading",
@@ -13,12 +16,15 @@ function useNetworkStatus() {
         let active = true;
         let generation = 0;
         let statusSubscription;
+        let syncCheckSubscription;
         let hadTransport = false;
         const unsubscribeTransport = (0, peers_sdk_1.subscribeHostContractTransport)((transport) => {
             generation += 1;
             const currentGeneration = generation;
             statusSubscription?.dispose();
             statusSubscription = undefined;
+            syncCheckSubscription?.dispose();
+            syncCheckSubscription = undefined;
             if (!transport) {
                 setViewState({ availability: hadTransport ? "unavailable" : "loading" });
                 return;
@@ -30,13 +36,14 @@ function useNetworkStatus() {
                 if (!active || generation !== currentGeneration) {
                     return;
                 }
-                setViewState({
+                setViewState((current) => ({
+                    ...current,
                     availability: "ready",
                     status: diagnostics.observables.status(),
-                });
+                }));
                 statusSubscription = diagnostics.observables.status.subscribe((status) => {
                     if (active && generation === currentGeneration) {
-                        setViewState({ availability: "ready", status });
+                        setViewState((current) => ({ ...current, availability: "ready", status }));
                     }
                 });
             })
@@ -45,11 +52,27 @@ function useNetworkStatus() {
                     setViewState({ availability: "unavailable" });
                 }
             });
+            // A missing count only adds a warning; without it the indicator still works.
+            void (0, network_viewer_ipc_1.getSyncCheckConsumer)()
+                .then((syncCheck) => {
+                if (!active || generation !== currentGeneration) {
+                    return;
+                }
+                const update = ({ missingChangeCount }) => {
+                    if (active && generation === currentGeneration) {
+                        setViewState((current) => ({ ...current, missingChangeCount }));
+                    }
+                };
+                update(syncCheck.observables.status());
+                syncCheckSubscription = syncCheck.observables.status.subscribe(update);
+            })
+                .catch(() => { });
         });
         return () => {
             active = false;
             generation += 1;
             statusSubscription?.dispose();
+            syncCheckSubscription?.dispose();
             unsubscribeTransport();
         };
     }, []);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peers-app/peers-ui",
-  "version": "0.27.2",
+  "version": "0.27.4",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/peers-app/peers-ui.git"
@@ -9,6 +9,12 @@
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/__tests__",
+    "README.md"
+  ],
   "publishConfig": {
     "access": "public"
   },
@@ -30,7 +36,7 @@
     "lint:fix": "biome check --write ."
   },
   "peerDependencies": {
-    "@peers-app/peers-sdk": "^0.27.2",
+    "@peers-app/peers-sdk": "^0.27.4",
     "bootstrap": "^5.3.3",
     "react": "^18.0.0",
     "react-dom": "^18.0.0"
@@ -41,7 +47,7 @@
     "@babel/preset-react": "^7.24.1",
     "@babel/preset-typescript": "^7.27.1",
     "@biomejs/biome": "2.3.11",
-    "@peers-app/peers-sdk": "0.27.2",
+    "@peers-app/peers-sdk": "0.27.4",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",

package/.claude/settings.local.json

@@ -1,34 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(mkdir:*)",
-      "Bash(yarn add:*)",
-      "Bash(yarn test:*)",
-      "Bash(npm test)",
-      "Bash(yarn build)",
-      "Bash(yarn jest:*)",
-      "Bash(mv:*)",
-      "Bash(npm run build:*)",
-      "Bash(cd:*)",
-      "Bash(npm test:*)",
-      "Bash(npm run test:*)",
-      "Bash(yarn tsc:*)",
-      "WebFetch(domain:developer.mozilla.org)",
-      "Read(/Users/mark.archer/peers-device/src/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/src/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/dist/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/dist/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/dist/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/src/**)",
-      "Read(/Users/mark.archer/peers-packages/tasks/src/**)"
-    ],
-    "deny": [],
-    "additionalDirectories": [
-      "/Users/mark.archer/peers-packages/tasks/dist"
-    ]
-  }
-}

package/.github/README.md

@@ -1,52 +0,0 @@
-# GitHub Actions for @peers-app/peers-ui
-
-## Quick Start
-
-### 1. Configure npm Token
-
-Add your npm token as a GitHub Secret:
-
-1. Go to **Settings** → **Secrets and variables** → **Actions**
-2. Click **New repository secret**
-3. Name: `NPM_TOKEN`
-4. Value: Your npm automation token
-5. Click **Add secret**
-
-### 2. Create npm Token
-
-If you don't have one:
-
-1. Go to [npmjs.com](https://www.npmjs.com)
-2. **Account Settings** → **Access Tokens**
-3. **Generate New Token** → **Automation**
-4. Copy the token and add it to GitHub Secrets
-
-### 3. Release
-
-**IMPORTANT**: Ensure @peers-app/peers-sdk is published first!
-
-```bash
-# Update @peers-app/peers-sdk dependency if needed
-# Edit package.json: "@peers-app/peers-sdk": "^0.1.1"
-
-# Update version
-npm version patch  # 0.0.14 → 0.0.15
-
-# Push tag (triggers CI/CD)
-git push origin main
-git push origin --tags
-```
-
-## Workflow
-
-The `publish.yml` workflow:
-- Triggers on version tags (`v*.*.*`)
-- Runs tests
-- Builds the package
-- Publishes to npm
-- Creates GitHub release
-
-## Dependencies
-
-This package depends on:
-- **@peers-app/peers-sdk**: Ensure it's published before releasing

package/.github/workflows/delete-all-artifacts.yml

@@ -1,49 +0,0 @@
-name: Cleanup old artifacts
-on:
-  workflow_dispatch:    # manual trigger
-  schedule:
-    - cron: '0 0 * * 0' # every Sunday at midnight UTC
-
-jobs:
-  cleanup:
-    runs-on: ubuntu-latest
-    permissions:
-      actions: write    # needed to delete artifacts
-      contents: read
-    steps:
-      - name: Install jq
-        run: sudo apt-get install -y jq
-
-      - name: Log in to GitHub CLI
-        run: gh auth setup-git
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: List and delete artifacts
-        env:
-          REPO: ${{ github.repository }}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          echo "Fetching all artifacts for $REPO..."
-          gh api repos/$REPO/actions/artifacts --paginate > artifacts.json
-
-          count=$(jq '.artifacts | length' artifacts.json)
-          echo "Found $count artifacts."
-          echo
-
-          jq -c '.artifacts[]' artifacts.json | while read -r artifact; do
-            id=$(echo "$artifact" | jq -r '.id')
-            name=$(echo "$artifact" | jq -r '.name')
-            size=$(echo "$artifact" | jq -r '.size_in_bytes')
-            created=$(echo "$artifact" | jq -r '.created_at')
-            expired=$(echo "$artifact" | jq -r '.expired')
-
-            size_mb=$(echo "scale=2; $size/1024/1024" | bc)
-            echo "🗑️  Deleting artifact: \"$name\" ($size_mb MB, created $created, expired=$expired)"
-
-            gh api --method DELETE repos/$REPO/actions/artifacts/$id || \
-              echo "⚠️  Failed to delete artifact ID $id"
-          done
-
-          echo
-          echo "✅ Cleanup complete!"

package/.github/workflows/publish.yml

@@ -1,51 +0,0 @@
-name: Publish to npm
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-      - '*.*.*'
-  workflow_dispatch:
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
-
-      - name: Enforce release freeze
-        run: node release-guard.js
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v6
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Lint (Biome)
-        run: npm run lint
-
-      # - name: Run tests
-      #   run: npm test
-
-      - name: Build package
-        run: npm run build
-
-      - name: Publish to npm
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v3
-        if: startsWith(github.ref, 'refs/tags/')
-        with:
-          generate_release_notes: true
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/babel.config.js

@@ -1,7 +0,0 @@
-module.exports = {
-  presets: [
-    ["@babel/preset-env", { targets: { node: "current" } }],
-    ["@babel/preset-react", { runtime: "automatic" }],
-    "@babel/preset-typescript",
-  ],
-};