@younndai/lyt-mesh 0.9.0

package/dist/flows/pod-status.js

@@ -0,0 +1,269 @@
+/*
+ * 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, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { closeRegistry, getDefaultVaultsRoot, getFederationRepoDir, isProvisionalIdentity, listFederationStates, listVaults, openRegistry, readIdentityCache, readPodIdentity, runGit as defaultRunGit, } from "@younndai/lyt-vault";
+async function probeGitDrift(path, runGit, noFetch) {
+    const gitDir = await runGit(["rev-parse", "--git-dir"], { cwd: path, allowFailure: true });
+    if (gitDir.code !== 0) {
+        return { isRepo: false, hasRemote: false, hasUpstream: false, ahead: 0, dirty: 0 };
+    }
+    const origin = await runGit(["remote", "get-url", "origin"], { cwd: path, allowFailure: true });
+    const hasRemote = origin.code === 0;
+    const upstream = await runGit(["rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}"], {
+        cwd: path,
+        allowFailure: true,
+    });
+    const hasUpstream = upstream.code === 0;
+    if (hasUpstream && !noFetch) {
+        await runGit(["fetch", "--quiet"], { cwd: path, allowFailure: true });
+    }
+    let ahead = 0;
+    if (hasUpstream) {
+        const ab = await runGit(["rev-list", "--left-right", "--count", "HEAD...@{u}"], {
+            cwd: path,
+            allowFailure: true,
+        });
+        if (ab.code === 0)
+            ahead = Number(ab.stdout.trim().split(/\s+/)[0]) || 0;
+    }
+    else {
+        // No upstream — count local commits (everything is "ahead" of nothing).
+        const count = await runGit(["rev-list", "--count", "HEAD"], { cwd: path, allowFailure: true });
+        if (count.code === 0)
+            ahead = Number(count.stdout.trim()) || 0;
+    }
+    const status = await runGit(["status", "--porcelain"], { cwd: path, allowFailure: true });
+    const dirty = status.code === 0 ? status.stdout.split(/\r?\n/).filter((l) => l.trim().length > 0).length : 0;
+    return { isRepo: true, hasRemote, hasUpstream, ahead, dirty };
+}
+// Best-effort stale-index probe: a clean+pushed vault whose newest note is more
+// recent than its on-disk index db. Cheap mtime compare; if the index db isn't
+// found, returns false (NOT stale) — we never fabricate a stale signal.
+function isIndexStale(vaultPath) {
+    const dbCandidates = [join(vaultPath, ".lyt", "lyt.db"), join(vaultPath, ".lyt", "indexes")];
+    let dbMtime = 0;
+    for (const c of dbCandidates) {
+        if (existsSync(c)) {
+            try {
+                dbMtime = Math.max(dbMtime, statSync(c).mtimeMs);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    if (dbMtime === 0)
+        return false; // no index db located → cannot assert stale
+    const notesDir = join(vaultPath, "notes");
+    if (!existsSync(notesDir))
+        return false;
+    let newestNote = 0;
+    try {
+        for (const f of readdirSync(notesDir)) {
+            if (!f.endsWith(".md"))
+                continue;
+            newestNote = Math.max(newestNote, statSync(join(notesDir, f)).mtimeMs);
+        }
+    }
+    catch {
+        return false;
+    }
+    return newestNote > dbMtime;
+}
+function classifyVault(drift, vaultPath) {
+    if (!drift.isRepo)
+        return { status: "not-git-repo", detail: "no .git — run `lyt sync` to initialize + publish" };
+    if (!drift.hasRemote)
+        return {
+            status: "no-remote",
+            detail: "no remote configured — run `lyt sync` to create + publish",
+        };
+    if (drift.dirty > 0 || drift.ahead > 0) {
+        const parts = [];
+        if (drift.dirty > 0)
+            parts.push(`${drift.dirty} uncommitted`);
+        if (drift.ahead > 0)
+            parts.push(`${drift.ahead} unpushed commit(s)`);
+        return { status: "unpushed", detail: parts.join(", ") };
+    }
+    if (isIndexStale(vaultPath)) {
+        return { status: "stale-index", detail: "search index behind content — run `lyt sync`" };
+    }
+    return { status: "clean", detail: "published + up to date" };
+}
+export async function podStatusFlow(args = {}) {
+    const runGit = args.runGit ?? defaultRunGit;
+    const noFetch = args.noFetch === true;
+    const db = await openRegistry();
+    let vaults;
+    let handle;
+    try {
+        vaults = (await listVaults(db)).filter((v) => v.status !== "tombstoned");
+        const states = await listFederationStates(db);
+        handle = states.length === 1 ? states[0].handle : null;
+    }
+    finally {
+        await closeRegistry(db);
+    }
+    const vaultReports = [];
+    const registeredPaths = new Set();
+    for (const v of vaults) {
+        registeredPaths.add(v.path);
+        if (!existsSync(v.path)) {
+            vaultReports.push({
+                name: v.name,
+                path: v.path,
+                status: "missing",
+                ahead: 0,
+                dirtyCount: 0,
+                hasRemote: false,
+                detail: "registered path not found on disk",
+            });
+            continue;
+        }
+        const drift = await probeGitDrift(v.path, runGit, noFetch);
+        const { status, detail } = classifyVault(drift, v.path);
+        vaultReports.push({
+            name: v.name,
+            path: v.path,
+            status,
+            ahead: drift.ahead,
+            dirtyCount: drift.dirty,
+            hasRemote: drift.hasRemote,
+            detail,
+        });
+    }
+    // Pod drift.
+    let pod;
+    if (handle === null) {
+        pod = {
+            handle: null,
+            status: "no-pod",
+            ahead: 0,
+            dirtyCount: 0,
+            detail: "no pod forged yet — run `lyt init`",
+        };
+    }
+    else {
+        const podDir = getFederationRepoDir(handle);
+        if (!existsSync(podDir)) {
+            pod = { handle, status: "no-pod", ahead: 0, dirtyCount: 0, detail: "pod dir missing" };
+        }
+        else {
+            const d = await probeGitDrift(podDir, runGit, noFetch);
+            // D34 (OD-LOCALFIRST) — a PROVISIONAL identity means the pod is local-only
+            // (never connected). This takes precedence over the remote/drift checks:
+            // a local pod has no remote BY DESIGN, so report it honestly as "not
+            // connected" rather than the generic "no-remote".
+            const podIdentity = readPodIdentity(podDir) ?? readIdentityCache();
+            const localOnly = podIdentity !== null && isProvisionalIdentity(podIdentity);
+            if (localOnly) {
+                pod = {
+                    handle,
+                    status: "local-only",
+                    ahead: d.ahead,
+                    dirtyCount: d.dirty,
+                    detail: "local-only (not connected to GitHub) — run `lyt sync` to connect + back up",
+                };
+            }
+            else if (!d.isRepo || !d.hasRemote) {
+                pod = {
+                    handle,
+                    status: "no-remote",
+                    ahead: d.ahead,
+                    dirtyCount: d.dirty,
+                    detail: "pod has no remote — run `lyt sync`",
+                };
+            }
+            else if (d.ahead > 0 || d.dirty > 0) {
+                pod = {
+                    handle,
+                    status: "unpushed",
+                    ahead: d.ahead,
+                    dirtyCount: d.dirty,
+                    detail: "pod.yon not yet pushed — run `lyt sync`",
+                };
+            }
+            else {
+                pod = {
+                    handle,
+                    status: "clean",
+                    ahead: 0,
+                    dirtyCount: 0,
+                    detail: "published + up to date",
+                };
+            }
+        }
+    }
+    const unregistered = scanUnregistered(registeredPaths);
+    const needsPublish = vaultReports.filter((r) => r.status === "unpushed" || r.status === "no-remote" || r.status === "not-git-repo").length;
+    const clean = vaultReports.filter((r) => r.status === "clean").length;
+    const podClean = pod.status === "clean" || pod.status === "no-pod";
+    return {
+        pod,
+        vaults: vaultReports,
+        unregistered,
+        summary: { clean, needsPublish, total: vaultReports.length },
+        ok: podClean && needsPublish === 0 && vaultReports.every((r) => r.status !== "missing"),
+    };
+}
+// Bounded scan (depth 2: <root>/<mesh>/<vault>) for vault dirs carrying
+// `.lyt/vault.yon` that the registry doesn't know about. lyt-pod-map (the
+// generated pod-map vault) is excluded — it isn't a registered home vault.
+function scanUnregistered(registeredPaths) {
+    const root = getDefaultVaultsRoot();
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    const hasVaultYon = (dir) => existsSync(join(dir, ".lyt", "vault.yon"));
+    let level1;
+    try {
+        level1 = readdirSync(root, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    for (const name of level1) {
+        if (name === "lyt-pod-map")
+            continue;
+        const dir = join(root, name);
+        if (hasVaultYon(dir) && !registeredPaths.has(dir)) {
+            out.push(dir);
+            continue;
+        }
+        // Depth 2: <root>/<mesh>/<vault>.
+        let children;
+        try {
+            children = readdirSync(dir, { withFileTypes: true })
+                .filter((e) => e.isDirectory())
+                .map((e) => e.name);
+        }
+        catch {
+            continue;
+        }
+        for (const child of children) {
+            const childDir = join(dir, child);
+            if (hasVaultYon(childDir) && !registeredPaths.has(childDir)) {
+                out.push(childDir);
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=pod-status.js.map

package/dist/flows/pod-status.js.map

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

package/dist/flows/status.d.ts

@@ -0,0 +1,16 @@
+import { type VaultRow } from "@younndai/lyt-vault";
+import type { Client } from "@libsql/client";
+export interface StatusCluster {
+    rootRid: string;
+    members: string[];
+}
+export interface StatusOutcome {
+    vaults: VaultRow[];
+    roots: string[];
+    clusters: StatusCluster[];
+}
+export interface StatusOptions {
+    db?: Client;
+}
+export declare function statusFlow(opts?: StatusOptions): Promise<StatusOutcome>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/flows/status.ts"],"names":[],"mappings":"AAgBA,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAS7C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CA4BjF"}

package/dist/flows/status.js

@@ -0,0 +1,76 @@
+/*
+ * 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 { closeRegistry, listVaults, openRegistry, ridsEqual, } from "@younndai/lyt-vault";
+export async function statusFlow(opts = {}) {
+    const db = opts.db ?? (await openRegistry());
+    const ownDb = opts.db === undefined;
+    try {
+        const vaults = await listVaults(db);
+        // Children lookup: bytes-equal parent_vault → child membership.
+        const ridHexes = new Set(vaults.map((v) => v.ridHex));
+        const roots = [];
+        for (const v of vaults) {
+            const parentHex = v.parentVaultHex;
+            if (parentHex === null || !ridHexes.has(parentHex)) {
+                roots.push(v.ridHex);
+            }
+        }
+        const clusters = [];
+        for (const rootHex of roots) {
+            const members = collectSubtree(rootHex, vaults);
+            clusters.push({ rootRid: rootHex, members });
+        }
+        return { vaults, roots, clusters };
+    }
+    finally {
+        if (ownDb) {
+            await closeRegistry(db);
+        }
+    }
+}
+function collectSubtree(rootHex, vaults) {
+    const byRidHex = new Map(vaults.map((v) => [v.ridHex, v]));
+    const childrenOf = new Map();
+    for (const v of vaults) {
+        if (!v.parentVault)
+            continue;
+        const parent = vaults.find((p) => ridsEqual(p.rid, v.parentVault));
+        if (!parent)
+            continue;
+        const arr = childrenOf.get(parent.ridHex);
+        if (arr)
+            arr.push(v.ridHex);
+        else
+            childrenOf.set(parent.ridHex, [v.ridHex]);
+    }
+    const visited = new Set();
+    const out = [];
+    const stack = [rootHex];
+    while (stack.length > 0) {
+        const r = stack.pop();
+        if (visited.has(r))
+            continue;
+        if (!byRidHex.has(r))
+            continue;
+        visited.add(r);
+        out.push(r);
+        const kids = childrenOf.get(r) ?? [];
+        for (const k of kids)
+            stack.push(k);
+    }
+    return out;
+}
+//# sourceMappingURL=status.js.map

package/dist/flows/status.js.map

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

package/dist/flows/sync-check.d.ts

@@ -0,0 +1,38 @@
+import { type GitRunOptions, type GitRunResult } from "@younndai/lyt-vault";
+export type GitRunner = (args: readonly string[], opts: GitRunOptions) => Promise<GitRunResult>;
+export interface SyncCheckArgs {
+    vaultNames?: readonly string[];
+    runGit?: GitRunner;
+    now?: Date;
+    noFetch?: boolean;
+}
+export interface VaultCheckReport {
+    rid: string;
+    name: string;
+    path: string;
+    status: string;
+    ahead: number;
+    behind: number;
+    dirtyCount: number;
+    hasUpstream: boolean;
+    frozen: boolean;
+    frozenUntil: string | null;
+    remaining: string | null;
+    vaultStatus: string;
+}
+export interface SyncCheckResult {
+    reports: VaultCheckReport[];
+    summary: {
+        clean: number;
+        dirty: number;
+        ahead: number;
+        behind: number;
+        diverged: number;
+        frozen: number;
+        noUpstream: number;
+        skippedNonActive: number;
+    };
+    exitCode: number;
+}
+export declare function syncCheckFlow(args?: SyncCheckArgs): Promise<SyncCheckResult>;
+//# sourceMappingURL=sync-check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-check.d.ts","sourceRoot":"","sources":["../../src/flows/sync-check.ts"],"names":[],"mappings":"AAkBA,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,YAAY,EAElB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEhG,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC;IAEX,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8JtF"}

package/dist/flows/sync-check.js

@@ -0,0 +1,180 @@
+/*
+ * 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 { closeRegistry, listVaults, openRegistry, readFrozenLock, runGit as defaultRunGit, } from "@younndai/lyt-vault";
+import { classifyCheckStatus } from "./sync.js";
+export async function syncCheckFlow(args = {}) {
+    const runGit = args.runGit ?? defaultRunGit;
+    const now = args.now ?? new Date();
+    const db = await openRegistry();
+    let candidates;
+    try {
+        const all = await listVaults(db);
+        candidates =
+            args.vaultNames && args.vaultNames.length > 0
+                ? all.filter((v) => args.vaultNames.includes(v.name))
+                : all;
+    }
+    finally {
+        await closeRegistry(db);
+    }
+    const reports = [];
+    for (const v of candidates) {
+        if (v.status !== "active") {
+            reports.push({
+                rid: v.ridHex,
+                name: v.name,
+                path: v.path,
+                status: v.status,
+                ahead: 0,
+                behind: 0,
+                dirtyCount: 0,
+                hasUpstream: false,
+                frozen: false,
+                frozenUntil: null,
+                remaining: null,
+                vaultStatus: v.status,
+            });
+            continue;
+        }
+        if (!existsSync(v.path)) {
+            reports.push({
+                rid: v.ridHex,
+                name: v.name,
+                path: v.path,
+                status: "missing",
+                ahead: 0,
+                behind: 0,
+                dirtyCount: 0,
+                hasUpstream: false,
+                frozen: false,
+                frozenUntil: null,
+                remaining: null,
+                vaultStatus: v.status,
+            });
+            continue;
+        }
+        const frozen = readFrozenLock(v.path, now);
+        const isFrozen = frozen.frozen && !frozen.expired;
+        const gitDir = await runGit(["rev-parse", "--git-dir"], { cwd: v.path, allowFailure: true });
+        if (gitDir.code !== 0) {
+            reports.push({
+                rid: v.ridHex,
+                name: v.name,
+                path: v.path,
+                status: "not-git-repo",
+                ahead: 0,
+                behind: 0,
+                dirtyCount: 0,
+                hasUpstream: false,
+                frozen: isFrozen,
+                frozenUntil: frozen.frozenUntil,
+                remaining: frozen.remaining,
+                vaultStatus: v.status,
+            });
+            continue;
+        }
+        const upstream = await runGit(["rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}"], {
+            cwd: v.path,
+            allowFailure: true,
+        });
+        const hasUpstream = upstream.code === 0;
+        if (hasUpstream && args.noFetch !== true) {
+            await runGit(["fetch", "--quiet"], { cwd: v.path, allowFailure: true });
+        }
+        let ahead = 0;
+        let behind = 0;
+        if (hasUpstream) {
+            const ab = await runGit(["rev-list", "--left-right", "--count", "HEAD...@{u}"], {
+                cwd: v.path,
+                allowFailure: true,
+            });
+            if (ab.code === 0) {
+                const parts = ab.stdout.trim().split(/\s+/);
+                ahead = Number(parts[0]) || 0;
+                behind = Number(parts[1]) || 0;
+            }
+        }
+        const statusRes = await runGit(["status", "--porcelain"], {
+            cwd: v.path,
+            allowFailure: true,
+        });
+        const dirtyCount = statusRes.code === 0
+            ? statusRes.stdout
+                .split(/\r?\n/)
+                .map((l) => l.trim())
+                .filter((l) => l.length > 0).length
+            : 0;
+        reports.push({
+            rid: v.ridHex,
+            name: v.name,
+            path: v.path,
+            status: classifyCheckStatus({
+                ahead,
+                behind,
+                dirtyCount,
+                hasUpstream,
+                frozen: isFrozen,
+            }),
+            ahead,
+            behind,
+            dirtyCount,
+            hasUpstream,
+            frozen: isFrozen,
+            frozenUntil: frozen.frozenUntil,
+            remaining: frozen.remaining,
+            vaultStatus: v.status,
+        });
+    }
+    const summary = {
+        clean: 0,
+        dirty: 0,
+        ahead: 0,
+        behind: 0,
+        diverged: 0,
+        frozen: 0,
+        noUpstream: 0,
+        skippedNonActive: 0,
+    };
+    for (const r of reports) {
+        if (r.vaultStatus !== "active") {
+            summary.skippedNonActive += 1;
+            continue;
+        }
+        if (r.status === "clean")
+            summary.clean += 1;
+        else if (r.status === "dirty")
+            summary.dirty += 1;
+        else if (r.status.startsWith("ahead-"))
+            summary.ahead += 1;
+        else if (r.status.startsWith("behind-"))
+            summary.behind += 1;
+        else if (r.status === "diverged")
+            summary.diverged += 1;
+        else if (r.status === "frozen")
+            summary.frozen += 1;
+        else if (r.status === "no-upstream")
+            summary.noUpstream += 1;
+    }
+    const anyDirtyOrAheadOrBehind = summary.dirty > 0 || summary.ahead > 0 || summary.behind > 0 || summary.diverged > 0;
+    // Exit codes mirror `lyt doctor`: 0 all clean, 1 needs sync, 2 frozen-near-expiry (advisory).
+    let exitCode = 0;
+    if (anyDirtyOrAheadOrBehind)
+        exitCode = 1;
+    // Near-expiry detection happens in caller (we don't recompute it here to keep flow pure).
+    return { reports, summary, exitCode };
+}
+//# sourceMappingURL=sync-check.js.map

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

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

package/dist/flows/sync-watch.d.ts

@@ -0,0 +1,24 @@
+import { type FSWatcher } from "chokidar";
+import { type ReconcileFigmentOp } from "@younndai/lyt-vault";
+import { type VaultSyncReport } from "./sync.js";
+export interface SyncWatchOptions {
+    commitDebounceMs?: number;
+    pushDebounceMs?: number;
+    resolveMeshContext?: boolean;
+    watcherFactory?: (paths: readonly string[], ignored: IgnoredMatcher) => FSWatcher;
+    onTick?: (report: VaultSyncReport) => void;
+    skipStartupBackfill?: boolean;
+    onReconcile?: (vaultName: string, op: ReconcileFigmentOp, relPath: string) => void;
+    signal?: AbortSignal;
+}
+export interface SyncWatchHandle {
+    stop: () => Promise<void>;
+    triggerChange: (vaultName: string) => void;
+    whenIdle: () => Promise<void>;
+}
+export declare const DEFAULT_COMMIT_DEBOUNCE_MS = 30000;
+type IgnoredMatcher = (path: string) => boolean;
+export declare const isIgnoredWatchPath: IgnoredMatcher;
+export declare function syncWatchFlow(opts?: SyncWatchOptions): Promise<SyncWatchHandle>;
+export {};
+//# sourceMappingURL=sync-watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-watch.d.ts","sourceRoot":"","sources":["../../src/flows/sync-watch.ts"],"names":[],"mappings":"AAkBA,OAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EAOL,KAAK,kBAAkB,EAExB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAG7B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,KAAK,SAAS,CAAC;IAClF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAG3C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAG9B,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAE9B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAI3C,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAYjD,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAIhD,eAAO,MAAM,kBAAkB,EAAE,cAAsD,CAAC;AAExF,wBAAsB,aAAa,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8LzF"}