@indigoai-us/hq-cloud 6.15.95 → 6.15.97

package/dist/bin/sync-runner-watch-loop.d.ts

@@ -1,9 +1,14 @@
 import { type TreeChange, type TreeChangeBatch } from "../watcher.js";
 import { readJournal } from "../journal.js";
+import { type FeatureSwitch } from "../sync/feature-flags.js";
 import type { TelemetryClaims } from "../telemetry-events.js";
 import type { Direction, RunnerLoopDeps, RunnerPassOutcome } from "./sync-runner.js";
-/** Area storage is an explicit canary and only applies after durable cutover. */
-export declare function shouldUseAreaStorage(areaStorageEnabled: boolean, stateDir: string, journalSlug: string): boolean;
+/**
+ * Area storage is AUTO by default and only applies after durable cutover.
+ * Pass the env switch (`auto`/`on`/`off`) or a boolean force-on/force-off.
+ * `HQ_SYNC_AREA_STORAGE=off` is the kill switch.
+ */
+export declare function shouldUseAreaStorage(areaStorage: boolean | FeatureSwitch, stateDir: string, journalSlug: string): boolean;
 /**
  * Targeted-pass batch limit: an event batch touching more distinct paths than
  * this falls back to one full reconcile pass. The limit catches genuine

package/dist/bin/sync-runner-watch-loop.d.ts.map

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

package/dist/bin/sync-runner-watch-loop.js

@@ -5,7 +5,7 @@ import { performance } from "node:perf_hooks";
 import { inventoryManagedSnapshots } from "../backup-prune.js";
 import { VaultClient } from "../index.js";
 import { pickCanonicalPersonEntity } from "../vault-client.js";
-import { acquireOperationLock, withOperationLock, OperationLockedError, OPERATION_LOCKED_EXIT, } from "../operation-lock.js";
+import { acquireOperationLock, withOperationLock, withOperationLockSync, OperationLockedError, OPERATION_LOCKED_EXIT, } from "../operation-lock.js";
 import { describeError } from "../lib/describe-error.js";
 import { TRANSIENT_NETWORK_EXIT } from "../lib/net-errors.js";
 import { PARTIAL_SYNC_EXIT } from "../lib/exit-codes.js";
@@ -15,8 +15,10 @@ import { TreeWatcher, resolveEventDebounceConfig, systemClock, } from "../watche
 import { clearLocalDeleteIntent, getStateDir, markLocalDeleteIntent, PERSONAL_VAULT_JOURNAL_SLUG, openJournalStoreSession, openJournalStoreSessionAsync, listJournalSlugs, listJournals, maintainAreaJournalSlice, readJournal, writeJournal, } from "../journal.js";
 import { NoopPushReceiver, } from "../sync/push-receiver.js";
 import { resolveEventSync, startEventSync as defaultStartEventSync, } from "../sync/event-sync.js";
-import { resolveParallelSyncRollout } from "../sync/feature-flags.js";
+import { resolveAreaStorageEnabled, resolveEffectiveParallelSyncRollout, resolveParallelSyncRollout, } from "../sync/feature-flags.js";
 import { resolveAreaLayoutAuthority } from "../sync/area-ledger-migration.js";
+import { AREA_AUTO_MIGRATION_SOURCE, createAreaAutoMigrationScheduler, openPersonalVaultAreaMigration, readPersonalVaultLayoutPhase, } from "../sync/area-ledger-auto-migration.js";
+import { emitCloudTelemetry } from "../telemetry-events.js";
 import { DefaultParallelSyncCoordinator } from "../sync/parallel-sync-coordinator.js";
 import { RealtimeTelemetrySpan, writeRealtimeTelemetryToStderr } from "../sync/realtime-telemetry.js";
 import { InlineSyncWorkerAdapter, } from "../sync/sync-work.js";
@@ -24,9 +26,17 @@ import { buildRoutePullArgv, buildScopedPushArgv, buildScopedDrainPullArgv, buil
 import { resolveSkipCompanies } from "./sync-runner-planning.js";
 const FULL_RECONCILE_EVERY_TICKS = 10;
 const MAX_FULL_RECONCILE_REASONS = 7;
-/** Area storage is an explicit canary and only applies after durable cutover. */
-export function shouldUseAreaStorage(areaStorageEnabled, stateDir, journalSlug) {
-    return areaStorageEnabled && resolveAreaLayoutAuthority(stateDir, journalSlug) === "areas";
+/**
+ * Area storage is AUTO by default and only applies after durable cutover.
+ * Pass the env switch (`auto`/`on`/`off`) or a boolean force-on/force-off.
+ * `HQ_SYNC_AREA_STORAGE=off` is the kill switch.
+ */
+export function shouldUseAreaStorage(areaStorage, stateDir, journalSlug) {
+    const authority = resolveAreaLayoutAuthority(stateDir, journalSlug);
+    const enabled = typeof areaStorage === "boolean"
+        ? areaStorage
+        : resolveAreaStorageEnabled(areaStorage, authority);
+    return enabled && authority === "areas";
 }
 function emitFullReconcileDecision({ mode, reasons, triggers, pollTick, configuredIntervalMs, elapsedSinceLastCompletedFullReconcileMs, batchPathCount, }) {
     process.stderr.write(JSON.stringify({
@@ -799,15 +809,14 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
     };
     const runGuarded = (passArgvForRun, prepare, lane = "slow") => runGuardedTask(() => runPassWithLock(passArgvForRun, prepare, lane), lane);
     /*
-     * The bridge is intentionally opt-in.  The legacy guarded pass arrays stay
-     * exactly as they are until an outpost enables HQ_SYNC_PARALLEL_COORDINATOR.
-     * Once enabled, the coordinator owns admission and path fencing; the small
-     * inline adapters are only the compatibility execution seam while the
-     * runner's real slice executors are being moved into child workers.
+     * Area storage and the parallel coordinator default to AUTO. AUTO turns
+     * them on after durable personal-vault cutover; explicit off is the kill
+     * switch; explicit on keeps the previous force-enable meaning. The env
+     * parse stays pure; the phase-dependent decision uses the personal journal.
      */
     const parallelRollout = resolveParallelSyncRollout();
-    const areaStorageEnabled = parallelRollout.areaStorageEnabled;
-    const parallelCoordinatorEnabled = parallelRollout.parallelExecutionEnabled;
+    const refreshCoordinatorEnabled = () => resolveEffectiveParallelSyncRollout(resolveAreaLayoutAuthority(getStateDir(), PERSONAL_VAULT_JOURNAL_SLUG)).parallelExecutionEnabled;
+    let parallelCoordinatorEnabled = refreshCoordinatorEnabled();
     const coordinatorExecutions = new WeakMap();
     const coordinatorWorker = async (slice) => {
         const execution = coordinatorExecutions.get(slice.work);
@@ -842,25 +851,24 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
             })),
         };
     };
-    const coordinator = parallelCoordinatorEnabled
-        ? new DefaultParallelSyncCoordinator({
-            realtimeWorker: new InlineSyncWorkerAdapter(coordinatorWorker),
-            choreWorker: new InlineSyncWorkerAdapter(coordinatorWorker),
-            identifyPath: (canonicalPath) => {
-                const route = routeChangeToTarget(canonicalPath);
-                if (!route)
-                    throw new Error(`coordinator cannot route ${canonicalPath}`);
-                return route.kind === "company"
-                    ? { targetUid: `company:${route.slug}`, areaId: `company:${route.slug}` }
-                    : { targetUid: "personal", areaId: "personal" };
-            },
-            // Compatibility chores still use whole-vault/whole-route executors,
-            // which cannot yet name sound bounded mutation paths. Their execution
-            // therefore remains behind the runner's guarded operation queue until
-            // those executors can provide concrete scopes.
-            planChorePaths: () => [],
-        })
-        : null;
+    const createCoordinator = () => new DefaultParallelSyncCoordinator({
+        realtimeWorker: new InlineSyncWorkerAdapter(coordinatorWorker),
+        choreWorker: new InlineSyncWorkerAdapter(coordinatorWorker),
+        identifyPath: (canonicalPath) => {
+            const route = routeChangeToTarget(canonicalPath);
+            if (!route)
+                throw new Error(`coordinator cannot route ${canonicalPath}`);
+            return route.kind === "company"
+                ? { targetUid: `company:${route.slug}`, areaId: `company:${route.slug}` }
+                : { targetUid: "personal", areaId: "personal" };
+        },
+        // Compatibility chores still use whole-vault/whole-route executors,
+        // which cannot yet name sound bounded mutation paths. Their execution
+        // therefore remains behind the runner's guarded operation queue until
+        // those executors can provide concrete scopes.
+        planChorePaths: () => [],
+    });
+    let coordinator = parallelCoordinatorEnabled ? createCoordinator() : null;
     const runCoordinatorWork = async (work, task, options = {}) => {
         const telemetry = work.class === "realtime" && parallelCoordinatorEnabled
             ? new RealtimeTelemetrySpan(work.source, work.direction, work.paths.length, writeRealtimeTelemetryToStderr)
@@ -937,6 +945,67 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
             onSettled({ result: 1, accepted: false, coordinatorRefusedPaths: [] });
         });
     };
+    const personalJournalInScope = (companiesMode || personalMode) && !watchRouteSelection.skipPersonal;
+    const areaAutoMigration = personalJournalInScope
+        ? createAreaAutoMigrationScheduler({
+            now: () => Date.now(),
+            hasActiveRealtimeSession: () => eventSync !== null && eventSyncLive,
+            areaStorageSwitch: () => parallelRollout.areaStorage,
+            readPhase: () => readPersonalVaultLayoutPhase(getStateDir(), PERSONAL_VAULT_JOURNAL_SLUG),
+            hasLegacyJournal: () => {
+                const slugs = listJournalSlugs();
+                return slugs.includes(PERSONAL_VAULT_JOURNAL_SLUG) || slugs.includes("personal");
+            },
+            createMigration: () => {
+                const opened = openPersonalVaultAreaMigration(hqRoot, getStateDir(), PERSONAL_VAULT_JOURNAL_SLUG);
+                return {
+                    copyAndCatchUp: () => opened.migration.copyAndCatchUp(),
+                    verifyParity: (legacy) => opened.migration.verifyParity(legacy),
+                    cutOver: () => opened.migration.cutOver(),
+                    readLegacyJournal: opened.readLegacyJournal,
+                };
+            },
+            withExclusiveLock: (fn) => withOperationLockSync(hqRoot, "area-ledger-migration", fn, {
+                mode: "exclusive",
+                timeoutSec: 5,
+                onWaitStart: () => undefined,
+            }),
+            enqueueChore: (run) => {
+                enqueueChore("migration", async () => {
+                    run();
+                    return 0;
+                }, (execution) => {
+                    if (!execution.accepted || passExitCode(execution.result) !== 0) {
+                        process.stderr.write("hq-sync-runner: area-ledger auto-migration chore failed; will retry\n");
+                    }
+                }, { wholeMutation: false });
+            },
+            log: (message) => process.stderr.write(`hq-sync-runner: ${message}\n`),
+            emitTelemetry: (eventName) => {
+                const getAccessToken = deps.getAccessToken ?? runtime.defaultGetAccessToken;
+                const getClaims = deps.getIdTokenClaims ?? runtime.defaultGetIdTokenClaims;
+                const client = new VaultClient({
+                    apiUrl: runtime.apiUrl,
+                    authToken: getAccessToken,
+                    region: runtime.region,
+                });
+                void emitCloudTelemetry(client, {
+                    eventName,
+                    source: AREA_AUTO_MIGRATION_SOURCE,
+                    properties: { trigger: "realtime_auto" },
+                }, {
+                    claims: getClaims(),
+                    log: (message) => process.stderr.write(`hq-sync-runner: ${message}\n`),
+                });
+            },
+            onCutOver: () => {
+                parallelCoordinatorEnabled = refreshCoordinatorEnabled();
+                if (parallelCoordinatorEnabled && coordinator === null) {
+                    coordinator = createCoordinator();
+                }
+            },
+        })
+        : { onTick() { } };
     let watcher = null;
     let eventPushSurfacesActivated = false;
     let watcherUnavailableWarned = false;
@@ -2316,6 +2385,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
             if (coordinatorAuthRequired)
                 return 0;
             pollTick++;
+            areaAutoMigration.onTick();
             const pending = takePendingWatcherChange();
             // The quarantine is scoped to the delete episode it refused, and only
             // the roots already refused when this batch was taken belong to it.
@@ -2550,7 +2620,7 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
                     }, { wholeMutation: true });
                     const epoch = new Date().toISOString().slice(0, 10);
                     for (const slug of listJournalSlugs()) {
-                        if (!shouldUseAreaStorage(areaStorageEnabled, getStateDir(), slug))
+                        if (!shouldUseAreaStorage(parallelRollout.areaStorage, getStateDir(), slug))
                             continue;
                         enqueueChore("rotation", () => runGuardedTask(async () => {
                             const maintenance = maintainAreaJournalSlice(slug, epoch);
@@ -2571,10 +2641,10 @@ export async function runWatchLoop(argv, parsed, deps, runtime) {
                 catch (error) {
                     process.stderr.write(`hq-sync-runner: backup retention dry-run failed — ${error instanceof Error ? error.message : String(error)}\n`);
                 }
-                if (areaStorageEnabled) {
+                {
                     const epoch = new Date().toISOString().slice(0, 10);
                     for (const slug of listJournalSlugs()) {
-                        if (!shouldUseAreaStorage(true, getStateDir(), slug))
+                        if (!shouldUseAreaStorage(parallelRollout.areaStorage, getStateDir(), slug))
                             continue;
                         await runGuardedTask(async () => {
                             const maintenance = maintainAreaJournalSlice(slug, epoch);