@younndai/lyt-mesh 0.9.0

package/dist/flows/sync-watch.js

@@ -0,0 +1,217 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { existsSync } from "node:fs";
+import chokidar from "chokidar";
+import { backfillFigmentCaches, closeRegistry, listVaults, openRegistry, reconcileFigmentWrite, toVaultRelPosix, } from "@younndai/lyt-vault";
+import { syncFlow } from "./sync.js";
+export const DEFAULT_COMMIT_DEBOUNCE_MS = 30_000;
+const IGNORED_SEGMENTS = /(?:^|[\\/])(?:\.git|node_modules|\.lyt)(?:[\\/]|$)/;
+export const isIgnoredWatchPath = (path) => IGNORED_SEGMENTS.test(path);
+export async function syncWatchFlow(opts = {}) {
+    const commitDebounceMs = opts.commitDebounceMs ?? DEFAULT_COMMIT_DEBOUNCE_MS;
+    const watcherFactory = opts.watcherFactory ??
+        ((paths, ignored) => chokidar.watch(paths, {
+            ignored,
+            ignoreInitial: true,
+            persistent: true,
+            // C2 (Lane M Wave 0 v2.1) — never traverse a symlink out of the
+            // vault root, so a symlinked dir/file in `notes/` can't have its
+            // out-of-vault target indexed (info-disclosure). Paired with the
+            // lstat guard in reconcile-figment-write.ts:readFigmentBody.
+            followSymlinks: false,
+        }));
+    const db = await openRegistry();
+    let activeVaults;
+    try {
+        activeVaults = (await listVaults(db)).filter((v) => v.status === "active" && existsSync(v.path));
+    }
+    finally {
+        await closeRegistry(db);
+    }
+    const debounceTimers = new Map();
+    const watchedPaths = activeVaults.map((v) => v.path);
+    const watcher = watcherFactory(watchedPaths, isIgnoredWatchPath);
+    // Track every in-flight reconcile / backfill so whenIdle() can await the
+    // full set. A reconcile is non-fatal (the markdown is the SoT and is
+    // already on disk); we never let a reconcile rejection escape.
+    const pending = new Set();
+    const track = (p) => {
+        pending.add(p);
+        void p.finally(() => pending.delete(p));
+    };
+    // M1 (Lane M Wave 0 v2.1) — per-vault serialization. Two FTS writers can
+    // target the same vault concurrently: the per-event incremental reconcile
+    // (reconcileNotesEvent → reconcileFigmentWrite, delete+insert) and the
+    // debounced full-walk (runSyncForVault → syncFlow → upsertFtsCache, which
+    // truncates the whole table then bulk-inserts). Running them at once on
+    // the same DB risks a torn cache. We chain every per-vault DB operation
+    // through a promise tail so they run strictly one-at-a-time PER VAULT
+    // (different vaults stay parallel). QUEUE, never drop — an edit landing
+    // mid-sync still reconciles after the sync drains. The chain swallows
+    // rejections so one failed op never poisons the tail.
+    const vaultChains = new Map();
+    const serialize = (vaultName, fn) => {
+        const prev = vaultChains.get(vaultName) ?? Promise.resolve();
+        const next = prev.then(fn, fn);
+        // Keep the tail rejection-proof so the next queued op always runs.
+        const guarded = next.catch(() => undefined);
+        vaultChains.set(vaultName, guarded);
+        void guarded.finally(() => {
+            // Drop the chain entry only if no newer op has replaced it (avoids an
+            // unbounded map for long-lived watchers over many vaults).
+            if (vaultChains.get(vaultName) === guarded)
+                vaultChains.delete(vaultName);
+        });
+        return next;
+    };
+    const scheduleCommit = (vaultName) => {
+        const existing = debounceTimers.get(vaultName);
+        if (existing)
+            clearTimeout(existing);
+        const t = setTimeout(() => {
+            debounceTimers.delete(vaultName);
+            // M1 — the debounced full-sync (which runs the full-walk FTS reconcile
+            // inside syncFlow) goes through the SAME per-vault chain as the
+            // incremental reconcile, so the two never run concurrently for one
+            // vault. Tracked so whenIdle() awaits an in-flight sync.
+            track(serialize(vaultName, () => runSyncForVault(vaultName, opts)));
+        }, commitDebounceMs);
+        debounceTimers.set(vaultName, t);
+    };
+    const resolveVaultForPath = (changedPath) => {
+        // chokidar emits absolute paths on Windows + POSIX.
+        for (const v of activeVaults) {
+            if (changedPath === v.path ||
+                changedPath.startsWith(v.path + "/") ||
+                changedPath.startsWith(v.path + "\\")) {
+                return v;
+            }
+        }
+        return null;
+    };
+    // Lane M Wave 0 v2 — incremental FTS reconcile on a notes/** file event.
+    // CHEAP-SEARCH INVARIANT: fresh search is the cheap universal layer, so
+    // we reconcile the FTS cache ONLY (provenance:false). The reconcile is
+    // non-fatal: a failure logs + is swallowed (the markdown SoT is on disk;
+    // the cache heals on the next startup backfill / `lyt vault rebuild-fts`).
+    const reconcileNotesEvent = (vault, op, relPath) => {
+        // M1 — queue through the per-vault chain so this incremental reconcile
+        // never overlaps the debounced full-walk for the same vault.
+        const p = serialize(vault.name, async () => {
+            await reconcileFigmentWrite(vault.path, op, { relPath }, { provenance: false });
+            opts.onReconcile?.(vault.name, op, relPath);
+        }).catch((err) => {
+            // eslint-disable-next-line no-console
+            console.warn(`sync-watch: FTS reconcile failed for ${vault.name}:${relPath} (${op}); markdown SoT preserved, heals on next backfill/rebuild-fts`, err);
+        });
+        track(p);
+    };
+    watcher.on("all", (evt, changedPath) => {
+        const v = resolveVaultForPath(changedPath);
+        if (!v)
+            return;
+        // Commit-debounce fires for ANY change in the vault (unchanged behavior).
+        scheduleCommit(v.name);
+        // FTS reconcile is notes/**-ONLY (the figment_fts source set). Changes
+        // under work/, handoffs/, .lyt/, .git/ etc. are NOT part of the cheap
+        // search cache and are skipped here.
+        const relPath = toVaultRelPosix(changedPath, v.path);
+        if (!isNotesFigment(relPath))
+            return;
+        // Map the chokidar event → reconcile op. chokidar's default config does
+        // not emit rename as a single event (it surfaces unlink + add), so we
+        // only handle add/change (→ upsert) and unlink (→ delete). A rename is
+        // therefore an unlink of the old path + an add of the new path, each of
+        // which reconciles correctly on its own.
+        if (evt === "add" || evt === "change") {
+            reconcileNotesEvent(v, "upsert", relPath);
+        }
+        else if (evt === "unlink") {
+            reconcileNotesEvent(v, "delete", relPath);
+        }
+    });
+    // Lane M Wave 0 v2 — one-time startup backfill per watched vault so an
+    // existing stale/empty figment_fts heals the moment the watcher starts.
+    // Non-fatal: a backfill failure logs + is swallowed.
+    if (opts.skipStartupBackfill !== true) {
+        for (const v of activeVaults) {
+            const p = backfillFigmentCaches(v.path)
+                .then(() => undefined)
+                .catch((err) => {
+                // eslint-disable-next-line no-console
+                console.warn(`sync-watch: startup FTS backfill failed for ${v.name}`, err);
+            });
+            track(p);
+        }
+    }
+    let stopped = false;
+    const stop = async () => {
+        if (stopped)
+            return;
+        stopped = true;
+        for (const t of debounceTimers.values())
+            clearTimeout(t);
+        debounceTimers.clear();
+        await watcher.close();
+        // Let any in-flight reconciles settle so we don't close over a busy DB.
+        await whenIdle();
+        // Flush: run sync one last time so any pending changes get committed.
+        try {
+            await syncFlow({ resolveMeshContext: opts.resolveMeshContext === true });
+        }
+        catch {
+            // Best-effort flush.
+        }
+    };
+    const whenIdle = async () => {
+        // Drain the pending set until it stabilises (a settling reconcile can
+        // enqueue nothing further, but a backfill completing while events arrive
+        // means we re-check until empty).
+        while (pending.size > 0) {
+            await Promise.allSettled([...pending]);
+        }
+    };
+    if (opts.signal) {
+        opts.signal.addEventListener("abort", () => {
+            void stop();
+        });
+    }
+    const triggerChange = (vaultName) => {
+        scheduleCommit(vaultName);
+    };
+    return { stop, triggerChange, whenIdle };
+}
+// A figment lives under the vault's `notes/` tree (the figment_fts source
+// set per upsert-fts-cache.ts) and is a markdown file. Matches both
+// `notes/x.md` and nested `notes/sub/x.md`; excludes everything else.
+function isNotesFigment(relPath) {
+    return relPath.startsWith("notes/") && relPath.toLowerCase().endsWith(".md");
+}
+async function runSyncForVault(vaultName, opts) {
+    try {
+        const result = await syncFlow({
+            vaultNames: [vaultName],
+            resolveMeshContext: opts.resolveMeshContext === true,
+        });
+        if (opts.onTick && result.reports.length > 0) {
+            opts.onTick(result.reports[0]);
+        }
+    }
+    catch {
+        // Swallow — watcher must keep running.
+    }
+}
+//# sourceMappingURL=sync-watch.js.map

package/dist/flows/sync-watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-watch.js","sourceRoot":"","sources":["../../src/flows/sync-watch.ts"],"names":[],"mappings":"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"}

package/dist/flows/sync.d.ts

@@ -0,0 +1,45 @@
+import { type GitRunOptions, type GitRunResult } from "@younndai/lyt-vault";
+export type VaultSyncStatus = "clean" | "committed" | "pushed" | "pulled" | "diverged-synced" | "conflict" | "skipped-frozen" | "skipped-tombstoned" | "skipped-disconnected" | "skipped-missing" | "no-upstream" | "not-git-repo" | "error";
+export interface VaultSyncReport {
+    name: string;
+    path: string;
+    status: VaultSyncStatus;
+    message: string;
+    ahead?: number;
+    behind?: number;
+    dirtyCount?: number;
+    meshContextResolved?: boolean;
+    errorOutput?: string;
+    subscribed?: boolean;
+    indexCorrupt?: boolean;
+}
+export interface SyncFrictionHint {
+    vaultName: string;
+    vaultStatus: VaultSyncStatus;
+    category: "sync.failed" | "sync.conflict";
+    message: string;
+}
+export interface SyncFlowResult {
+    reports: VaultSyncReport[];
+    ok: boolean;
+    frictionHints: SyncFrictionHint[];
+}
+export type GitRunner = (args: readonly string[], opts: GitRunOptions) => Promise<GitRunResult>;
+export interface SyncFlowArgs {
+    vaultNames?: readonly string[];
+    resolveMeshContext?: boolean;
+    runGit?: GitRunner;
+    now?: Date;
+    message?: string;
+}
+export declare function syncFlow(args?: SyncFlowArgs): Promise<SyncFlowResult>;
+declare function parsePorcelainPath(line: string): string | null;
+export declare function classifyCheckStatus(args: {
+    ahead: number;
+    behind: number;
+    dirtyCount: number;
+    hasUpstream: boolean;
+    frozen: boolean;
+}): string;
+export { parsePorcelainPath as _parsePorcelainPath };
+//# sourceMappingURL=sync.d.ts.map

package/dist/flows/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/flows/sync.ts"],"names":[],"mappings":"AAmBA,OAAO,EAuBL,KAAK,aAAa,EAClB,KAAK,YAAY,EAElB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,iBAAiB,GACjB,UAAU,GACV,gBAAgB,GAChB,oBAAoB,GACpB,sBAAsB,GACtB,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IAOrB,UAAU,CAAC,EAAE,OAAO,CAAC;IAQrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,EAAE,aAAa,GAAG,eAAe,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEhG,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC;IAKX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAsB,QAAQ,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoE/E;AAiWD,iBAAS,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASvD;AA0ED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,MAAM,CAQT;AAGD,OAAO,EAAE,kBAAkB,IAAI,mBAAmB,EAAE,CAAC"}