@indigoai-us/hq-cloud 6.11.13 → 6.11.15

package/dist/qmd-reindex.js.map

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

package/dist/sync-progress.d.ts

@@ -0,0 +1,37 @@
+import type { SyncProgressEvent } from "./cli/sync.js";
+/** Absolute path of the shared progress snapshot. Exported for the watcher + tests. */
+export declare function syncProgressPath(): string;
+export interface SyncProgressSnapshot {
+    schema: 1;
+    /** PID of the writing sync — lets a watcher detect a dead/stale holder. */
+    pid: number;
+    /** Company slug being synced, or null for the personal vault. */
+    company: string | null;
+    /** Which leg is running. */
+    phase: "pull" | "push";
+    filesTotal: number;
+    filesDone: number;
+    conflicts: number;
+    /** Path of the file currently transferring, or null before the first one. */
+    currentFile: string | null;
+    startedAt: string;
+    updatedAt: string;
+    status: "syncing";
+}
+export interface SyncProgressRecorderOptions {
+    company?: string | null;
+    phase: "pull" | "push";
+}
+/**
+ * Build an event sink that accumulates a sync's progress and atomic-writes the
+ * shared snapshot on each meaningful event. Wrap the engine's `onEvent` with
+ * it: `const emit = (e) => { baseEmit(e); record(e); }`.
+ */
+export declare function createSyncProgressRecorder(opts: SyncProgressRecorderOptions): (event: SyncProgressEvent) => void;
+/**
+ * Read the current snapshot, or null if absent/unreadable. Consumers should
+ * additionally treat a snapshot whose `updatedAt` is older than a few seconds
+ * (or whose `pid` is dead) as idle.
+ */
+export declare function readSyncProgress(): SyncProgressSnapshot | null;
+//# sourceMappingURL=sync-progress.d.ts.map

package/dist/sync-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-progress.d.ts","sourceRoot":"","sources":["../src/sync-progress.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAOvD,uFAAuF;AACvF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,CAAC,CAAC;IACV,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,2BAA2B,GAChC,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAwDpC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,oBAAoB,GAAG,IAAI,CAQ9D"}

package/dist/sync-progress.js

@@ -0,0 +1,104 @@
+/**
+ * Cross-process sync progress.
+ *
+ * Every sync path — the menubar watch daemon (auto-sync), "Sync Now", and a
+ * CLI `hq sync` — runs through the same engine (`sync()` pull + `share()`
+ * push). Each writes one shared status snapshot here so a watcher (the menubar)
+ * can show LIVE progress for ANY sync, not just the one it spawned over stdout.
+ *
+ * Because syncs are serialized (the op-lock; the watch daemon coordinates with
+ * one-shots), there is at most one active sync, so this single file is
+ * unambiguous. Writes are atomic (temp + rename) — a torn read at worst shows
+ * slightly stale progress. There is intentionally no explicit "done": the
+ * engine simply stops writing when a sync ends, so a consumer treats the file
+ * as idle once `updatedAt` is older than a few seconds. Progress reporting must
+ * never break a sync, so every fs error here is swallowed.
+ */
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+/** Mirror operation-lock's stateDir so the file lands next to the journal/lock. */
+function stateDir() {
+    return process.env.HQ_STATE_DIR || path.join(os.homedir(), ".hq");
+}
+/** Absolute path of the shared progress snapshot. Exported for the watcher + tests. */
+export function syncProgressPath() {
+    return path.join(stateDir(), "sync-progress.json");
+}
+/**
+ * Build an event sink that accumulates a sync's progress and atomic-writes the
+ * shared snapshot on each meaningful event. Wrap the engine's `onEvent` with
+ * it: `const emit = (e) => { baseEmit(e); record(e); }`.
+ */
+export function createSyncProgressRecorder(opts) {
+    let filesTotal = 0;
+    let filesDone = 0;
+    let conflicts = 0;
+    let currentFile = null;
+    const startedAt = new Date().toISOString();
+    const file = syncProgressPath();
+    const flush = () => {
+        const snap = {
+            schema: 1,
+            pid: process.pid,
+            company: opts.company ?? null,
+            phase: opts.phase,
+            filesTotal,
+            filesDone,
+            conflicts,
+            currentFile,
+            startedAt,
+            updatedAt: new Date().toISOString(),
+            status: "syncing",
+        };
+        try {
+            fs.mkdirSync(path.dirname(file), { recursive: true });
+            const tmp = `${file}.${process.pid}.tmp`;
+            fs.writeFileSync(tmp, JSON.stringify(snap));
+            fs.renameSync(tmp, file);
+        }
+        catch {
+            // Progress reporting is best-effort and must never break a sync.
+        }
+    };
+    return (event) => {
+        switch (event.type) {
+            case "plan":
+                // Sum the work this leg will do. `plan` arrives once before any
+                // progress events for the leg.
+                filesTotal +=
+                    event.filesToDownload + event.filesToUpload + event.filesToDelete;
+                flush();
+                break;
+            case "progress":
+                filesDone += 1;
+                currentFile = event.path;
+                flush();
+                break;
+            case "conflict":
+                conflicts += 1;
+                flush();
+                break;
+            default:
+                // error / new-files / reconciled / delete-refused etc. don't move the
+                // bar — skip the write to keep the file churn-free.
+                break;
+        }
+    };
+}
+/**
+ * Read the current snapshot, or null if absent/unreadable. Consumers should
+ * additionally treat a snapshot whose `updatedAt` is older than a few seconds
+ * (or whose `pid` is dead) as idle.
+ */
+export function readSyncProgress() {
+    try {
+        const raw = fs.readFileSync(syncProgressPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        return parsed && parsed.schema === 1 ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=sync-progress.js.map

package/dist/sync-progress.js.map

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

package/dist/sync-progress.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sync-progress.test.d.ts.map

package/dist/sync-progress.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-progress.test.d.ts","sourceRoot":"","sources":["../src/sync-progress.test.ts"],"names":[],"mappings":""}

package/dist/sync-progress.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { createSyncProgressRecorder, readSyncProgress, } from "./sync-progress.js";
+const planEvent = (download, upload, del) => ({
+    type: "plan",
+    filesToDownload: download,
+    bytesToDownload: 0,
+    filesToUpload: upload,
+    bytesToUpload: 0,
+    filesToSkip: 0,
+    filesToConflict: 0,
+    filesToDelete: del,
+});
+describe("sync-progress", () => {
+    let stateDir;
+    beforeEach(() => {
+        stateDir = fs.mkdtempSync(path.join(os.tmpdir(), "hq-progress-test-"));
+        process.env.HQ_STATE_DIR = stateDir;
+    });
+    afterEach(() => {
+        delete process.env.HQ_STATE_DIR;
+        fs.rmSync(stateDir, { recursive: true, force: true });
+    });
+    it("returns null when no sync has written a snapshot", () => {
+        expect(readSyncProgress()).toBeNull();
+    });
+    it("accumulates plan totals, progress, and conflicts into the shared snapshot", () => {
+        const record = createSyncProgressRecorder({ company: "acme", phase: "pull" });
+        record(planEvent(3, 0, 1)); // 3 to download + 1 to delete = 4 total
+        record({ type: "progress", path: "a.md", bytes: 10 });
+        record({ type: "progress", path: "b.md", bytes: 10 });
+        record({
+            type: "conflict",
+            path: "c.md",
+            direction: "pull",
+            resolution: "keep",
+        });
+        const snap = readSyncProgress();
+        expect(snap).not.toBeNull();
+        expect(snap.company).toBe("acme");
+        expect(snap.phase).toBe("pull");
+        expect(snap.filesTotal).toBe(4);
+        expect(snap.filesDone).toBe(2);
+        expect(snap.conflicts).toBe(1);
+        expect(snap.currentFile).toBe("b.md");
+        expect(snap.status).toBe("syncing");
+        expect(snap.pid).toBe(process.pid);
+        expect(typeof snap.updatedAt).toBe("string");
+    });
+    it("records the push leg + personal scope (company null)", () => {
+        const record = createSyncProgressRecorder({ company: null, phase: "push" });
+        record(planEvent(0, 5, 0));
+        const snap = readSyncProgress();
+        expect(snap.phase).toBe("push");
+        expect(snap.company).toBeNull();
+        expect(snap.filesTotal).toBe(5);
+    });
+    it("ignores non-progress events (no churn from new-files/reconciled)", () => {
+        const record = createSyncProgressRecorder({ company: "acme", phase: "pull" });
+        record(planEvent(1, 0, 0));
+        record({ type: "new-files", files: [] });
+        record({ type: "reconciled", path: "x.md", direction: "pull" });
+        const snap = readSyncProgress();
+        expect(snap.filesDone).toBe(0);
+        expect(snap.filesTotal).toBe(1);
+    });
+});
+//# sourceMappingURL=sync-progress.test.js.map

package/dist/sync-progress.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cloud",
-  "version": "6.11.13",
+  "version": "6.11.15",
   "description": "HQ by Indigo cloud sync engine — bidirectional S3 sync for mobile access",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,6 +12,7 @@
     "build": "tsc",
     "typecheck": "tsc --noEmit",
     "test": "vitest run src/",
+    "coverage": "vitest run src/ --coverage --coverage.reporter=text-summary --coverage.reporter=json-summary",
     "test:e2e": "vitest run test/",
     "test:watch": "vitest",
     "clean": "rm -rf dist"
@@ -33,6 +34,7 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.0.0",
     "aws-sdk-client-mock": "^4.1.0",
+    "@vitest/coverage-v8": "3.2.4",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
   },

package/src/bin/sync-runner-telemetry.ts

@@ -1,8 +1,15 @@
 export async function emitTelemetry(options: {
   collectTelemetry?: () => Promise<void>;
   defaultCollectTelemetry: () => Promise<void>;
+  onError?: (err: unknown) => void;
 }): Promise<void> {
   const telemetryFn =
     options.collectTelemetry ?? options.defaultCollectTelemetry;
-  await telemetryFn().catch(() => undefined);
+  await telemetryFn().catch((err) => {
+    try {
+      options.onError?.(err);
+    } catch {
+      /* diagnostics must never affect sync */
+    }
+  });
 }

package/src/bin/sync-runner.ts

@@ -107,6 +107,7 @@ import { collectAndSendSkillTelemetry } from "../skill-telemetry.js";
 import { reindexAfterSync } from "../qmd-reindex.js";
 import { pruneConflictIndex } from "../lib/conflict-index.js";
 import { getOrCreateMachineId } from "../lib/machine-id.js";
+import { describeError } from "../lib/describe-error.js";
 import type { Clock, TreeChangeBatch } from "../watcher.js";
 import type { PushReceiver, SyncEngineFn } from "../sync/push-receiver.js";
 import {
@@ -404,6 +405,53 @@ export interface VaultClientSurface {
   listMyExplicitGrants?: (companyUid: string) => Promise<ExplicitGrant[]>;
 }
 
+interface RunnerDiagnostic {
+  component: string;
+  event: string;
+  message: string;
+  err?: unknown;
+  context?: Record<string, unknown>;
+}
+
+type RunnerDiagnosticReporter = (diagnostic: RunnerDiagnostic) => void;
+
+function errorDetails(err: unknown): Record<string, unknown> {
+  const details: Record<string, unknown> = { message: describeError(err) };
+  if (err instanceof Error) {
+    if (err.name) details.name = err.name;
+    const code = (err as NodeJS.ErrnoException).code;
+    if (code) details.code = code;
+  }
+  return details;
+}
+
+function createRunnerDiagnosticReporter(
+  stderr: { write: (chunk: string) => boolean | void },
+): RunnerDiagnosticReporter {
+  return (diagnostic) => {
+    try {
+      const payload: Record<string, unknown> = {
+        type: "error",
+        diagnostic: true,
+        component: diagnostic.component,
+        event: diagnostic.event,
+        path: `(${diagnostic.component})`,
+        message:
+          diagnostic.err === undefined
+            ? diagnostic.message
+            : `${diagnostic.message}: ${describeError(diagnostic.err)}`,
+        ...(diagnostic.context ?? {}),
+      };
+      if (diagnostic.err !== undefined) {
+        payload.err = errorDetails(diagnostic.err);
+      }
+      stderr.write(`${JSON.stringify(payload)}\n`);
+    } catch {
+      /* diagnostics must never affect runner control flow */
+    }
+  };
+}
+
 // `resolvePullScope`, `readPinnedPrefixes`, and the `PullScope` type now live
 // in `../sync/pull-scope.ts` so the menubar runner and `hq sync pull|now`
 // (hq-cli) share ONE scope resolver — the drift between them was the root
@@ -769,6 +817,7 @@ export async function defaultCollectTelemetry(
   client: VaultClientSurface,
   clientIsStub: boolean,
   hqRoot: string,
+  reportDiagnostic: RunnerDiagnosticReporter = () => undefined,
 ): Promise<void> {
   if (clientIsStub) return;
 
@@ -797,7 +846,14 @@ export async function defaultCollectTelemetry(
   try {
     const persons = await client.entity.listByType("person");
     if (pickCanonicalPersonEntity(persons) === null) return;
-  } catch {
+  } catch (err) {
+    reportDiagnostic({
+      component: "telemetry",
+      event: "runner.telemetry.person_probe_failed",
+      message: "telemetry person probe failed; continuing with telemetry",
+      err,
+      context: { hqRoot },
+    });
     // Probe failed — preserve prior behavior and let telemetry run.
   }
 
@@ -820,7 +876,14 @@ export async function defaultCollectTelemetry(
   try {
     machineId = getOrCreateMachineId(hqRoot);
     installerVersion = process.env.HQ_INSTALLER_VERSION ?? "hq-cloud";
-  } catch {
+  } catch (err) {
+    reportDiagnostic({
+      component: "telemetry",
+      event: "runner.telemetry.identity_failed",
+      message: "telemetry identity resolution failed; skipping telemetry",
+      err,
+      context: { hqRoot },
+    });
     return;
   }
 
@@ -836,8 +899,22 @@ export async function defaultCollectTelemetry(
       // manifest.yaml and stamp companyUid (US-002). Unmatched cwds stay
       // unattributed (field omitted).
       hqRoot,
+      log: (message) =>
+        reportDiagnostic({
+          component: "telemetry",
+          event: "runner.telemetry.usage_nonfatal",
+          message,
+          context: { hqRoot },
+        }),
+    });
+  } catch (err) {
+    reportDiagnostic({
+      component: "telemetry",
+      event: "runner.telemetry.usage_failed",
+      message: "usage telemetry collector threw",
+      err,
+      context: { hqRoot },
     });
-  } catch {
     // Fire-and-forget; nothing escapes the boundary.
   }
 
@@ -851,8 +928,22 @@ export async function defaultCollectTelemetry(
       // Scope skill capture to the HQ project — only invocations whose cwd is
       // the HQ root are emitted; skill usage in unrelated repos is excluded.
       hqRoot,
+      log: (message) =>
+        reportDiagnostic({
+          component: "telemetry",
+          event: "runner.telemetry.skill_nonfatal",
+          message,
+          context: { hqRoot },
+        }),
+    });
+  } catch (err) {
+    reportDiagnostic({
+      component: "telemetry",
+      event: "runner.telemetry.skill_failed",
+      message: "skill telemetry collector threw",
+      err,
+      context: { hqRoot },
     });
-  } catch {
     // Fire-and-forget; nothing escapes the boundary.
   }
 }
@@ -867,6 +958,7 @@ export async function runRunner(
 ): Promise<number> {
   const stdout = deps.stdout ?? process.stdout;
   const stderr = deps.stderr ?? process.stderr;
+  const reportDiagnostic = createRunnerDiagnosticReporter(stderr);
 
   // ---- emit ---------------------------------------------------------------
   // Error-class events go to stderr; everything else to stdout.
@@ -1068,7 +1160,16 @@ export async function runRunner(
         client,
         deps.createVaultClient !== undefined,
         parsed.hqRoot,
+        reportDiagnostic,
       ),
+    onError: (err) =>
+      reportDiagnostic({
+        component: "telemetry",
+        event: "runner.telemetry.collector_failed",
+        message: "telemetry collector failed",
+        err,
+        context: { hqRoot: parsed.hqRoot },
+      }),
   });
 
   emit({
@@ -1095,8 +1196,24 @@ export async function runRunner(
     process.env.HQ_QMD_REINDEX_ON_SYNC !== "0"
   ) {
     try {
-      reindexAfterSync(parsed.hqRoot);
-    } catch {
+      reindexAfterSync(parsed.hqRoot, {
+        log: ({ event, message, err, context }) =>
+          reportDiagnostic({
+            component: "qmd-reindex",
+            event,
+            message,
+            err,
+            context: { hqRoot: parsed.hqRoot, ...(context ?? {}) },
+          }),
+      });
+    } catch (err) {
+      reportDiagnostic({
+        component: "qmd-reindex",
+        event: "runner.qmd_reindex.failed",
+        message: "post-sync qmd reindex threw",
+        err,
+        context: { hqRoot: parsed.hqRoot },
+      });
       // Defensive: reindexAfterSync already swallows internally.
     }
   }
@@ -1113,7 +1230,14 @@ export async function runRunner(
   if (process.env.HQ_CONFLICT_PRUNE_ON_SYNC !== "0") {
     try {
       pruneConflictIndex(parsed.hqRoot);
-    } catch {
+    } catch (err) {
+      reportDiagnostic({
+        component: "conflict-index",
+        event: "runner.conflict_index.prune_failed",
+        message: "post-sync conflict index prune failed",
+        err,
+        context: { hqRoot: parsed.hqRoot },
+      });
       // Defensive: a prune failure must never affect the sync outcome.
     }
   }

package/src/cli/share.ts

@@ -10,6 +10,7 @@ import * as os from "os";
 import * as path from "path";
 import type { EntityContext, VaultServiceConfig, SyncJournal } from "../types.js";
 import { resolveEntityContext, isExpiringSoon, refreshEntityContext } from "../context.js";
+import { createSyncProgressRecorder } from "../sync-progress.js";
 import {
   uploadFile,
   uploadSymlink,
@@ -886,7 +887,7 @@ async function createPushRunContext(options: ShareOptions): Promise<PushRunConte
   const { paths, company, message, onConflict, vaultConfig, entityContext, hqRoot, skipUnchanged, propagateDeletes } = options;
   let propagateDeletePolicy: DeletePolicy =
     options.propagateDeletePolicy ?? "owned-only";
-  const emit = options.onEvent ?? defaultConsoleLogger;
+  const baseEmit = options.onEvent ?? defaultConsoleLogger;
 
   if (vaultConfig && entityContext) {
     throw new Error(
@@ -918,6 +919,21 @@ async function createPushRunContext(options: ShareOptions): Promise<PushRunConte
     propagateDeletePolicy = "currency-gated";
   }
 
+  // Mirror push progress into the shared cross-process snapshot (see sync.ts).
+  // Record the friendly company slug, or null for the personal vault so the
+  // menubar shows "Personal" — never the raw prs_/cmp_ UID.
+  const recordProgress = createSyncProgressRecorder({
+    company:
+      ctx.uid.startsWith("prs_") || options.personalMode === true
+        ? null
+        : ctx.slug,
+    phase: "push",
+  });
+  const emit: ShareEmit = (event) => {
+    baseEmit(event);
+    recordProgress(event);
+  };
+
   const syncRoot = options.personalMode === true
     ? hqRoot
     : path.join(hqRoot, "companies", ctx.slug);

package/src/cli/sync.test.ts

@@ -46,6 +46,7 @@ vi.mock("./reindex.js", () => ({
 import { sync, reportNewFilesToNotify } from "./sync.js";
 import * as s3Module from "../s3.js";
 import { reindex } from "./reindex.js";
+import { readSyncProgress } from "../sync-progress.js";
 
 const mockConfig: VaultServiceConfig = {
   apiUrl: "https://vault-api.test",
@@ -144,6 +145,22 @@ describe("sync", () => {
     expect(reindex).toHaveBeenCalledWith({ repoRoot: tmpDir, skipLock: true });
   });
 
+  it("records the company slug, not the input UID, in the shared progress snapshot", async () => {
+    // sync() is called with the company UID, but the menubar popover must show
+    // the friendly slug — so the producer records ctx.slug, never the raw UID.
+    vi.mocked(s3Module.listRemoteFiles).mockResolvedValueOnce([
+      { key: "docs/x.md", size: 10, lastModified: new Date(), etag: '"x"' },
+    ]);
+    await sync({
+      company: "cmp_01ABCDEF",
+      vaultConfig: mockConfig,
+      hqRoot: tmpDir,
+    });
+    const snap = readSyncProgress();
+    expect(snap).not.toBeNull();
+    expect(snap!.company).toBe("acme"); // ctx.slug, not "cmp_01ABCDEF"
+  });
+
   it("F15: public sync entrypoint refuses an already-held operation lock", async () => {
     process.env.HQ_OP_LOCK_TIMEOUT = "0";
     const lockPath = lockPathFor(tmpDir);

package/src/cli/sync.ts

@@ -14,6 +14,7 @@ import type {
 } from "../types.js";
 import type { SyncMode } from "../vault-client.js";
 import { resolveEntityContext, isExpiringSoon, refreshEntityContext } from "../context.js";
+import { createSyncProgressRecorder } from "../sync-progress.js";
 import {
   downloadFile,
   listRemoteFiles,
@@ -657,6 +658,23 @@ function logNotifyFailure(err: unknown): void {
   }
 }
 
+/** Log a non-fatal post-sync maintenance failure without changing sync state. */
+function logPostSyncMaintenanceFailure(
+  task: string,
+  hqRoot: string,
+  err: unknown,
+): void {
+  try {
+    console.error(
+      `[hq-sync] ${task} failed (non-fatal; hqRoot=${hqRoot}): ${
+        err instanceof Error ? err.message : String(err)
+      }`,
+    );
+  } catch {
+    // swallow — logging must never break sync
+  }
+}
+
 /**
  * Sync (pull) all allowed files from the entity vault.
  */
@@ -708,7 +726,7 @@ async function syncWithOperationLockHeld(
 
 async function buildPullContext(options: SyncOptions): Promise<PullRunContext> {
   const { company, vaultConfig, hqRoot } = options;
-  const emit = options.onEvent ?? defaultConsoleLogger;
+  const baseEmit = options.onEvent ?? defaultConsoleLogger;
 
   const companyRef = company ?? resolveActiveCompany(hqRoot);
   if (!companyRef) {
@@ -726,6 +744,20 @@ async function buildPullContext(options: SyncOptions): Promise<PullRunContext> {
   const journalSlug = options.journalSlug ?? ctx.slug;
   const startedAt = new Date().toISOString();
 
+  // Mirror every progress event into the shared cross-process snapshot so the
+  // menubar shows live progress for THIS sync regardless of who launched it
+  // (auto-sync / Sync Now / CLI). Record the friendly company slug (e.g.
+  // "indigo") — or null for the personal vault so the menubar shows "Personal"
+  // — never the raw prs_/cmp_ UID. Best-effort; never affects the sync.
+  const recordProgress = createSyncProgressRecorder({
+    company: options.personalMode === true ? null : ctx.slug,
+    phase: "pull",
+  });
+  const emit: SyncEventEmitter = (event) => {
+    baseEmit(event);
+    recordProgress(event);
+  };
+
   if (journalSlug === PERSONAL_VAULT_JOURNAL_SLUG) migratePersonalVaultJournal();
   const journal = migrateToV2(readJournal(journalSlug));
   gcTombstones(journal, Date.now());
@@ -1454,7 +1486,8 @@ function finalizePullRun(
   if (!run.options.skipReindex && changedOnDisk) {
     try {
       reindex({ repoRoot: run.hqRoot, skipLock: true });
-    } catch {
+    } catch (err) {
+      logPostSyncMaintenanceFailure("post-sync reindex", run.hqRoot, err);
       // best-effort: a post-sync refresh failure never fails the sync
     }
   }