opentasks 0.1.2 → 0.2.0

package/dist/daemon/methods/lifecycle.d.ts

@@ -5,6 +5,8 @@
  */
 import type { IPCServer } from '../ipc.js';
 import type { DaemonStatus } from '../types.js';
+import type { DaemonHealthSnapshot } from '../health-counters.js';
+import type { SyncerHealth } from '../../graph/git-graph-syncer.js';
 /**
  * Health check response
  */
@@ -17,6 +19,16 @@ export interface HealthResponse {
         rss: number;
     };
     version: string;
+    /**
+     * Counters for otherwise-silent watcher/reconcile failures + liveness
+     * timestamps (F10). Omitted if the daemon wasn't given a counters source.
+     */
+    counters?: DaemonHealthSnapshot;
+    /**
+     * Git sync health (last error/op/success + cumulative error count), or null
+     * when git sync is disabled. Omitted if no sync-health source was provided.
+     */
+    sync?: SyncerHealth | null;
 }
 /**
  * Status getter function
@@ -46,6 +58,10 @@ export interface LifecycleMethodsOptions {
     startedAt: Date;
     /** Optional health checker for multi-location awareness */
     checkHealth?: HealthChecker;
+    /** Optional source of watcher/reconcile failure counters (F10) */
+    getHealthCounters?: () => DaemonHealthSnapshot;
+    /** Optional source of git sync health (null when sync is disabled) (F10) */
+    getSyncHealth?: () => SyncerHealth | null;
 }
 /**
  * Register lifecycle method handlers on an IPC server

package/dist/daemon/methods/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/daemon/methods/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,MAAM,EAAE,SAAS,CAAC;IAElB,4CAA4C;IAC5C,SAAS,EAAE,YAAY,CAAC;IAExB,mCAAmC;IACnC,QAAQ,EAAE,eAAe,CAAC;IAE1B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAEhB,oCAAoC;IACpC,SAAS,EAAE,IAAI,CAAC;IAEhB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAuC/E"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/daemon/methods/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAMpE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAEhC;;;OAGG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,MAAM,EAAE,SAAS,CAAC;IAElB,4CAA4C;IAC5C,SAAS,EAAE,YAAY,CAAC;IAExB,mCAAmC;IACnC,QAAQ,EAAE,eAAe,CAAC;IAE1B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAEhB,oCAAoC;IACpC,SAAS,EAAE,IAAI,CAAC;IAEhB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,oBAAoB,CAAC;IAE/C,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;CAC3C;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CA0C/E"}

package/dist/daemon/methods/lifecycle.js

@@ -10,7 +10,7 @@
  * Register lifecycle method handlers on an IPC server
  */
 export function registerLifecycleMethods(options) {
-    const { server, getStatus, shutdown, version, startedAt, checkHealth } = options;
+    const { server, getStatus, shutdown, version, startedAt, checkHealth, getHealthCounters, getSyncHealth } = options;
     // ping - Simple health check
     server.handle('ping', async () => {
         return { pong: true };
@@ -28,6 +28,8 @@ export function registerLifecycleMethods(options) {
                 rss: memory.rss,
             },
             version,
+            ...(getHealthCounters ? { counters: getHealthCounters() } : {}),
+            ...(getSyncHealth ? { sync: getSyncHealth() } : {}),
         };
     });
     // status - Daemon status and stats

package/dist/daemon/methods/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/daemon/methods/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6DH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAgC;IACvE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEjF,6BAA6B;IAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;QAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,uCAAuC;IACvC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,IAA6B,EAAE;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAEhD,OAAO;YACL,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;YAC/C,MAAM;YACN,MAAM,EAAE;gBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;aAChB;YACD,OAAO;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,mCAAmC;IACnC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,IAA2B,EAAE;QACxD,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,+BAA+B;IAC/B,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;QACnC,2CAA2C;QAC3C,YAAY,CAAC,GAAG,EAAE;YAChB,KAAK,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/daemon/methods/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiFH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAgC;IACvE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,GACtG,OAAO,CAAC;IAEV,6BAA6B;IAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;QAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,uCAAuC;IACvC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,IAA6B,EAAE;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAEhD,OAAO;YACL,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;YAC/C,MAAM;YACN,MAAM,EAAE;gBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;aAChB;YACD,OAAO;YACP,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,mCAAmC;IACnC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,IAA2B,EAAE;QACxD,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,+BAA+B;IAC/B,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;QACnC,2CAA2C;QAC3C,YAAY,CAAC,GAAG,EAAE;YAChB,KAAK,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/daemon/methods/location.js.map

@@ -1 +1 @@
-{"version":3,"file":"location.js","sourceRoot":"","sources":["../../../src/daemon/methods/location.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,mBAAmB,EAAwB,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAsB,MAAM,wBAAwB,CAAC;AA6BlG,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA+B;IACrE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAE3D,6CAA6C;IAC7C,MAAM,CAAC,MAAM,CAAwC,eAAe,EAAE,KAAK,IAAI,EAAE;QAC/E,OAAO,gBAAgB,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,0DAA0D;IAC1D,MAAM,CAAC,MAAM,CAAuC,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxF,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,8BAA8B;QAC9B,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa;QACzC,CAAC;QAED,wBAAwB;QACxB,MAAM,KAAK,GAAkB,MAAM,mBAAmB,CACpD,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,IAAI,EACX,KAAK,CACN,CAAC;QAEF,oBAAoB;QACpB,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAE5B,kBAAkB;QAClB,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE5B,4CAA4C;QAC5C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAkB;oBAC3B,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;oBAC3D,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,IAAI,EAAE,QAAQ;iBACf,CAAC;gBACF,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;YAC3E,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,8CAA8C;IAC9C,MAAM,CAAC,MAAM,CAAyC,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5F,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,uBAAuB;QACvB,MAAM,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE3C,6CAA6C;QAC7C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;YAC3E,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../../src/daemon/methods/location.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAsB,MAAM,wBAAwB,CAAC;AA6BlG,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA+B;IACrE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAE3D,6CAA6C;IAC7C,MAAM,CAAC,MAAM,CAAwC,eAAe,EAAE,KAAK,IAAI,EAAE;QAC/E,OAAO,gBAAgB,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,0DAA0D;IAC1D,MAAM,CAAC,MAAM,CAAuC,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxF,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,8BAA8B;QAC9B,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa;QACzC,CAAC;QAED,wBAAwB;QACxB,MAAM,KAAK,GAAkB,MAAM,mBAAmB,CACpD,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,IAAI,EACX,KAAK,CACN,CAAC;QAEF,oBAAoB;QACpB,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAE5B,kBAAkB;QAClB,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE5B,4CAA4C;QAC5C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAkB;oBAC3B,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;oBAC3D,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,IAAI,EAAE,QAAQ;iBACf,CAAC;gBACF,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;YAC3E,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,8CAA8C;IAC9C,MAAM,CAAC,MAAM,CAAyC,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5F,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,uBAAuB;QACvB,MAAM,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE3C,6CAA6C;QAC7C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;YAC3E,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/daemon/methods/sync.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Git Sync Method Handlers
+ *
+ * JSON-RPC method handlers for manual git sync operations + status inspection.
+ * The daemon runs auto-sync in the background when `sync.git.autoCommit` or
+ * `sync.git.autoPush` are enabled in config; these methods expose the same
+ * operations for on-demand triggers (e.g., from an external signal like a
+ * MAP `context.updated` event telling us a peer pushed changes we should pull).
+ */
+import type { IPCServer } from '../ipc.js';
+import type { LocationResolver, LocationState } from '../location-state.js';
+import type { GitGraphSyncer, SyncCycleResult, PullResult, SyncerHealth } from '../../graph/git-graph-syncer.js';
+export interface SyncMethodsOptions {
+    /** IPC server to register handlers on */
+    server: IPCServer;
+    /** Resolver for the active syncer — returns null when no git sync is configured */
+    getSyncer(): GitGraphSyncer | null;
+    /** Static snapshot of the sync config + recent health (for sync.status) */
+    getSyncStatus(): {
+        enabled: boolean;
+        remote?: string;
+        autoCommit: boolean;
+        autoPush: boolean;
+        pullOnStartup: boolean;
+        autoSyncRunning: boolean;
+        /**
+         * Recent success/failure snapshot. Absent when git sync is disabled
+         * or the syncer hasn't been built yet; present otherwise.
+         */
+        health?: SyncerHealth;
+    };
+    /**
+     * Reload the syncer from the current on-disk config. Called from `sync.reload`
+     * when an external writer (e.g., OpenHive's PATCH /resources/:id/git-sync
+     * endpoint) has rewritten `.opentasks/config.json` and we need the running
+     * daemon to pick up the new settings without a restart.
+     *
+     * Returns the new status snapshot after the swap. When `config.json` can't
+     * be read or `sync.git.enabled` is false, the syncer is torn down and
+     * subsequent `sync.now` / `sync.pull` calls return `ran: false`.
+     */
+    reloadSyncer(): Promise<ReturnType<SyncMethodsOptions['getSyncStatus']>>;
+    /**
+     * The daemon flush manager. When present, `sync.now`/`sync.pull` drain and
+     * freeze the debounced SQLite→JSONL flush around the git op so a pending
+     * flush can't fire mid-pull and overwrite the freshly-pulled `graph.jsonl`
+     * (the F2 data-loss race). Optional — when absent, sync runs uncoordinated.
+     */
+    flushManager?: {
+        flush(): Promise<void>;
+        pause(): void;
+        resume(): void;
+    };
+    /**
+     * Re-sync SQLite from the (possibly merged) JSONL after a pull brought
+     * changes. Called only when a pull actually changed the file.
+     */
+    reloadStore?: () => Promise<void>;
+}
+export interface SyncNowResult {
+    /** Whether the syncer is available */
+    ran: boolean;
+    /** Present when ran=true */
+    result?: SyncCycleResult;
+    /** Present when ran=false */
+    reason?: string;
+}
+export interface SyncPullOnlyResult {
+    ran: boolean;
+    result?: PullResult;
+    reason?: string;
+}
+export interface SyncReloadResult {
+    /** Whether a reload was actually applied (config file read + syncer rebuilt). */
+    reloaded: boolean;
+    /** New post-reload status. Mirrors `sync.status`. */
+    status: ReturnType<SyncMethodsOptions['getSyncStatus']>;
+    /** Populated on failure (e.g., config.json missing or unreadable). */
+    error?: string;
+}
+/**
+ * Register sync.now / sync.pull / sync.status method handlers on an IPC server.
+ *
+ * sync.now      — runs the full cycle (commitIfDirty → pull → push)
+ * sync.pull     — pulls only; used when the hub signals "peer pushed, catch up"
+ * sync.status   — inspection; returns the active config + autoSync state
+ */
+export declare function registerSyncMethods(options: SyncMethodsOptions): void;
+/** Sync status snapshot shape (shared with single-location `getSyncStatus`). */
+export type SyncStatusSnapshot = ReturnType<SyncMethodsOptions['getSyncStatus']>;
+export interface MultiLocationSyncMethodsOptions {
+    /** IPC server to register handlers on */
+    server: IPCServer;
+    /** Resolves a `location` param to its LocationState */
+    locationResolver: LocationResolver;
+    /**
+     * Rebuild a location's git syncer from its on-disk config (for `sync.reload`).
+     * Mutates `state.graphSyncer` / `state.gitSyncConfig` in place. Wired by the
+     * daemon to the location-state syncer builder.
+     */
+    reloadLocationSyncer(state: LocationState): Promise<void>;
+}
+/**
+ * Register location-aware sync.now / sync.pull / sync.status / sync.reload.
+ *
+ * Each handler takes an optional `location` param (the worktree hash). The git
+ * op runs through the SAME coordinated flush-freeze-reload as single-location,
+ * but resolved per location — so a debounced flush on one worktree can't clobber
+ * that worktree's freshly-pulled graph.jsonl (the F2 race), and pulls reload
+ * that location's SQLite.
+ */
+export declare function registerMultiLocationSyncMethods(options: MultiLocationSyncMethodsOptions): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/daemon/methods/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/daemon/methods/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAkDjH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,MAAM,EAAE,SAAS,CAAC;IAElB,mFAAmF;IACnF,SAAS,IAAI,cAAc,GAAG,IAAI,CAAC;IAEnC,2EAA2E;IAC3E,aAAa,IAAI;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,OAAO,CAAC;QACvB,eAAe,EAAE,OAAO,CAAC;QACzB;;;WAGG;QACH,MAAM,CAAC,EAAE,YAAY,CAAC;KACvB,CAAC;IAEF;;;;;;;;;OASG;IACH,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,YAAY,CAAC,EAAE;QAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,KAAK,IAAI,IAAI,CAAC;QAAC,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;IAEzE;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,GAAG,EAAE,OAAO,CAAC;IAEb,4BAA4B;IAC5B,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAElB,qDAAqD;IACrD,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC;IAExD,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAuDrE;AAMD,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC;AAEjF,MAAM,WAAW,+BAA+B;IAC9C,yCAAyC;IACzC,MAAM,EAAE,SAAS,CAAC;IAElB,uDAAuD;IACvD,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,+BAA+B,GAAG,IAAI,CAsD/F"}

package/dist/daemon/methods/sync.js

@@ -0,0 +1,158 @@
+/**
+ * Git Sync Method Handlers
+ *
+ * JSON-RPC method handlers for manual git sync operations + status inspection.
+ * The daemon runs auto-sync in the background when `sync.git.autoCommit` or
+ * `sync.git.autoPush` are enabled in config; these methods expose the same
+ * operations for on-demand triggers (e.g., from an external signal like a
+ * MAP `context.updated` event telling us a peer pushed changes we should pull).
+ */
+/**
+ * Serialize a git sync/pull with the debounced SQLite→JSONL flush:
+ *   drain pending flush (so local writes are in JSONL for the commit/merge)
+ *   → freeze the flush (so it can't fire mid-pull and clobber the pulled file)
+ *   → run the git op
+ *   → reload SQLite from the merged JSONL (only when a pull changed it)
+ *   → resume the flush.
+ * Without a flushManager this is a passthrough (legacy / uncoordinated behavior).
+ */
+async function runCoordinated(flushManager, reloadStore, run, pulledChanges) {
+    if (flushManager) {
+        await flushManager.flush();
+        flushManager.pause();
+    }
+    try {
+        const result = await run();
+        if (reloadStore && pulledChanges(result)) {
+            try {
+                await reloadStore();
+            }
+            catch {
+                /* best-effort: a reload hiccup shouldn't fail the sync */
+            }
+        }
+        return result;
+    }
+    finally {
+        flushManager?.resume();
+    }
+}
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Register sync.now / sync.pull / sync.status method handlers on an IPC server.
+ *
+ * sync.now      — runs the full cycle (commitIfDirty → pull → push)
+ * sync.pull     — pulls only; used when the hub signals "peer pushed, catch up"
+ * sync.status   — inspection; returns the active config + autoSync state
+ */
+export function registerSyncMethods(options) {
+    const { server, getSyncer, getSyncStatus, reloadSyncer, flushManager, reloadStore } = options;
+    const coordinated = (run, pulledChanges) => runCoordinated(flushManager, reloadStore, run, pulledChanges);
+    server.handle('sync.now', async () => {
+        const syncer = getSyncer();
+        if (!syncer) {
+            return { ran: false, reason: 'git sync is not enabled for this daemon' };
+        }
+        const result = await coordinated(() => syncer.sync(), (r) => r.pull.pulled && r.pull.hasChanges);
+        return { ran: true, result };
+    });
+    server.handle('sync.pull', async () => {
+        const syncer = getSyncer();
+        if (!syncer) {
+            return { ran: false, reason: 'git sync is not enabled for this daemon' };
+        }
+        // Commit any (now-flushed) local changes before pulling so the merge
+        // driver merges local + remote instead of git refusing the pull over
+        // uncommitted changes — and so un-flushed local work isn't lost on reload.
+        // This still does not push, preserving sync.pull's "pull, don't push" intent.
+        const result = await coordinated(async () => {
+            await syncer.commitIfDirty();
+            return syncer.pull();
+        }, (r) => r.pulled && r.hasChanges);
+        return { ran: true, result };
+    });
+    server.handle('sync.status', async () => {
+        return getSyncStatus();
+    });
+    server.handle('sync.reload', async () => {
+        try {
+            const status = await reloadSyncer();
+            return { reloaded: true, status };
+        }
+        catch (err) {
+            return {
+                reloaded: false,
+                status: getSyncStatus(),
+                error: err.message,
+            };
+        }
+    });
+}
+/** Build a sync.status snapshot for one location from its state. */
+function locationSyncStatus(state) {
+    const cfg = state.gitSyncConfig;
+    const syncer = state.graphSyncer;
+    return {
+        enabled: cfg?.enabled ?? false,
+        remote: cfg?.remote,
+        autoCommit: cfg?.autoCommit ?? false,
+        autoPush: cfg?.autoPush ?? false,
+        pullOnStartup: cfg?.pullOnStartup ?? false,
+        autoSyncRunning: syncer?.isAutoSyncRunning() ?? false,
+        health: syncer?.getHealth(),
+    };
+}
+/**
+ * Register location-aware sync.now / sync.pull / sync.status / sync.reload.
+ *
+ * Each handler takes an optional `location` param (the worktree hash). The git
+ * op runs through the SAME coordinated flush-freeze-reload as single-location,
+ * but resolved per location — so a debounced flush on one worktree can't clobber
+ * that worktree's freshly-pulled graph.jsonl (the F2 race), and pulls reload
+ * that location's SQLite.
+ */
+export function registerMultiLocationSyncMethods(options) {
+    const { server, locationResolver, reloadLocationSyncer } = options;
+    server.handle('sync.now', async (params) => {
+        const state = locationResolver.resolve(params?.location);
+        const syncer = state.graphSyncer;
+        if (!syncer) {
+            return { ran: false, reason: 'git sync is not enabled for this location' };
+        }
+        const result = await runCoordinated(state.flushManager, () => state.store.reload(), () => syncer.sync(), (r) => r.pull.pulled && r.pull.hasChanges);
+        return { ran: true, result };
+    });
+    server.handle('sync.pull', async (params) => {
+        const state = locationResolver.resolve(params?.location);
+        const syncer = state.graphSyncer;
+        if (!syncer) {
+            return { ran: false, reason: 'git sync is not enabled for this location' };
+        }
+        const result = await runCoordinated(state.flushManager, () => state.store.reload(), async () => {
+            await syncer.commitIfDirty();
+            return syncer.pull();
+        }, (r) => r.pulled && r.hasChanges);
+        return { ran: true, result };
+    });
+    server.handle('sync.status', async (params) => {
+        const state = locationResolver.resolve(params?.location);
+        return locationSyncStatus(state);
+    });
+    server.handle('sync.reload', async (params) => {
+        const state = locationResolver.resolve(params?.location);
+        try {
+            await reloadLocationSyncer(state);
+            return { reloaded: true, status: locationSyncStatus(state) };
+        }
+        catch (err) {
+            return {
+                reloaded: false,
+                status: locationSyncStatus(state),
+                error: err.message,
+            };
+        }
+    });
+}
+//# sourceMappingURL=sync.js.map

package/dist/daemon/methods/sync.js.map

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

package/dist/daemon/methods/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/daemon/methods/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAe7D,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,iCAAiC,CAAC;AAM/F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,MAAM,EAAE,SAAS,CAAC;IAElB,qDAAqD;IACrD,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAmBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAsJvE"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/daemon/methods/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAe7D,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,iCAAiC,CAAC;AAM/F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,MAAM,EAAE,SAAS,CAAC;IAElB,qDAAqD;IACrD,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAmBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAwLvE"}

package/dist/daemon/methods/tools.js

@@ -18,7 +18,7 @@ import { task } from '../../tools/task.js';
 /**
  * Check if an ID is a local node ID (not a provider URI)
  */
-const LOCAL_ID_PATTERN = /^[ctfex]-[a-z0-9]+$/;
+const LOCAL_ID_PATTERN = /^[ctfexa]-[a-z0-9]+$/;
 function isLocalId(id) {
     return LOCAL_ID_PATTERN.test(id);
 }
@@ -99,15 +99,49 @@ export function registerToolsMethods(options) {
             return { success: false, error: 'Provider store not available' };
         }
         const result = await task(state.providerStore, taskParams);
-        // Mark nodes dirty and schedule flush for mutations
+        // Persist mutations with two durability tiers. Coordination-critical
+        // writes — claims/leases and terminal transitions — flush to JSONL
+        // *before* the RPC returns so a crash can't lose a claim or a terminal
+        // outcome. Ordinary edits (assign, non-terminal transitions) keep the
+        // debounced flush.
         if (result.success && result.data) {
-            if (result.data.type === 'transition' && isLocalId(result.data.node.id)) {
-                state.flushManager.markDirty(result.data.node.id);
-                state.flushManager.schedule();
+            const d = result.data;
+            let dirtyId;
+            let durable = false;
+            if (d.type === 'transition' && isLocalId(d.node.id)) {
+                dirtyId = d.node.id;
+                durable =
+                    d.action === 'complete' ||
+                        d.action === 'close' ||
+                        d.action === 'fail' ||
+                        d.action === 'abandon';
             }
-            if (result.data.type === 'assign' && isLocalId(result.data.node.id)) {
-                state.flushManager.markDirty(result.data.node.id);
-                state.flushManager.schedule();
+            else if (d.type === 'assign' && isLocalId(d.node.id)) {
+                dirtyId = d.node.id;
+            }
+            else if (
+            // Coordination mutations carry a nodeId when they touched a task.
+            // claimNext with nothing to claim has no nodeId and is skipped.
+            (d.type === 'claim' ||
+                d.type === 'renew' ||
+                d.type === 'claimNext' ||
+                d.type === 'release') &&
+                d.nodeId &&
+                isLocalId(d.nodeId)) {
+                dirtyId = d.nodeId;
+                durable = true; // claims/leases are coordination-critical
+            }
+            if (dirtyId) {
+                state.flushManager.markDirty(dirtyId);
+                if (durable) {
+                    // Durable tier: persist before returning. flush() is a no-op while
+                    // a git sync has the flush paused — the node stays dirty and is
+                    // flushed when sync resumes.
+                    await state.flushManager.flush();
+                }
+                else {
+                    state.flushManager.schedule();
+                }
             }
         }
         return result;

package/dist/daemon/methods/tools.js.map

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

package/dist/daemon/methods/watch.d.ts

@@ -10,11 +10,35 @@
  */
 import type { IPCServer } from '../ipc.js';
 import type { LocationResolver } from '../location-state.js';
+import type { EventManager } from '../events.js';
 export interface WatchMethodsOptions {
     /** IPC server to register handlers on */
     server: IPCServer;
     /** Location resolver for routing to correct store */
     locationResolver: LocationResolver;
+    /**
+     * Optional event manager. When present, each broadcast `watch.event` is
+     * stamped with a monotonic `seq` + per-process `epoch` and buffered for
+     * replay (P3 M2), so a reconnecting subscriber can backfill via `events.since`.
+     * Without it, events broadcast unstamped (the M1 fire-and-forget behavior).
+     */
+    eventManager?: EventManager;
+    /**
+     * Optional callback invoked when a diff cycle throws and is swallowed, so the
+     * daemon can surface otherwise-silent watcher failures via `health` (F10).
+     */
+    onWatcherError?: () => void;
+}
+/**
+ * Subscription filter (coarse). Omitted → the subscriber receives all events.
+ * `types` matches the provider node type carried on the event (tasks are emitted
+ * as `'issue'`, contexts as `'spec'`); `statuses` matches `node.status`;
+ * `locations` matches the originating worktree's location hash (multi-location).
+ */
+export interface WatchFilter {
+    types?: string[];
+    statuses?: string[];
+    locations?: string[];
 }
 /**
  * Register watch subscription method handlers on an IPC server

package/dist/daemon/methods/watch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/daemon/methods/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,MAAM,EAAE,SAAS,CAAC;IAElB,qDAAqD;IACrD,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAuED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAwJvE"}
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/daemon/methods/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAG5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,MAAM,EAAE,SAAS,CAAC;IAElB,qDAAqD;IACrD,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAgID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAuMvE"}