@cfio/cohort-sync 0.2.4 → 0.4.0

package/dist/index.js

@@ -2700,10 +2700,10 @@ var Type = type_exports2;
 // src/sync.ts
 import { execSync } from "node:child_process";
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/index.js
-var version = "1.32.0";
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/index.js
+var version = "1.33.0";
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/values/base64.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/values/base64.js
 var base64_exports = {};
 __export(base64_exports, {
   byteLength: () => byteLength,
@@ -2810,7 +2810,7 @@ function fromByteArrayUrlSafeNoPadding(uint8) {
   return fromByteArray(uint8).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/common/index.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/common/index.js
 function parseArgs(args) {
   if (args === void 0) {
     return {};
@@ -2860,7 +2860,7 @@ function isSimpleObject(value) {
   return isObject && isSimple;
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/values/value.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/values/value.js
 var LITTLE_ENDIAN = true;
 var MIN_INT64 = BigInt("-9223372036854775808");
 var MAX_INT64 = BigInt("9223372036854775807");
@@ -3143,7 +3143,7 @@ function convexToJson(value) {
   return convexToJsonInternal(value, value, "", false);
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/values/validators.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/values/validators.js
 var __defProp2 = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -3540,7 +3540,7 @@ var VUnion = class _VUnion extends BaseValidator {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/values/validator.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/values/validator.js
 function isValidator(v2) {
   return !!v2.isConvexValidator;
 }
@@ -3804,7 +3804,7 @@ var v = {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/values/errors.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/values/errors.js
 var __defProp3 = Object.defineProperty;
 var __defNormalProp2 = (obj, key, value) => key in obj ? __defProp3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField2 = (obj, key, value) => __defNormalProp2(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -3821,12 +3821,12 @@ var ConvexError = class extends (_b = Error, _a = IDENTIFYING_FIELD, _b) {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/values/compare_utf8.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/values/compare_utf8.js
 var arr = () => Array.from({ length: 4 }, () => 0);
 var aBytes = arr();
 var bBytes = arr();
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/logging.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/logging.js
 var __defProp4 = Object.defineProperty;
 var __defNormalProp3 = (obj, key, value) => key in obj ? __defProp4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField3 = (obj, key, value) => __defNormalProp3(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -3948,7 +3948,7 @@ function forwardData(result, error) {
   return error;
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/udf_path_utils.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/udf_path_utils.js
 function canonicalizeUdfPath(udfPath) {
   const pieces = udfPath.split(":");
   let moduleName;
@@ -3985,7 +3985,7 @@ function serializedQueryTokenIsPaginated(token) {
   return JSON.parse(token).type === "paginated";
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/local_state.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/local_state.js
 var __defProp5 = Object.defineProperty;
 var __defNormalProp4 = (obj, key, value) => key in obj ? __defProp5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField4 = (obj, key, value) => __defNormalProp4(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -4276,7 +4276,7 @@ var LocalSyncState = class {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/request_manager.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/request_manager.js
 var __defProp6 = Object.defineProperty;
 var __defNormalProp5 = (obj, key, value) => key in obj ? __defProp6(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField5 = (obj, key, value) => __defNormalProp5(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -4483,10 +4483,10 @@ var RequestManager = class {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/server/functionName.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/server/functionName.js
 var functionName = Symbol.for("functionName");
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/server/components/paths.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/server/components/paths.js
 var toReferencePath = Symbol.for("toReferencePath");
 function extractReferencePath(reference) {
   return reference[toReferencePath] ?? null;
@@ -4514,7 +4514,7 @@ function getFunctionAddress(functionReference) {
   return functionAddress;
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/server/api.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/server/api.js
 function getFunctionName(functionReference) {
   const address = getFunctionAddress(functionReference);
   if (address.name === void 0) {
@@ -4572,7 +4572,7 @@ function createApi(pathParts = []) {
 }
 var anyApi = createApi();
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/optimistic_updates_impl.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/optimistic_updates_impl.js
 var __defProp7 = Object.defineProperty;
 var __defNormalProp6 = (obj, key, value) => key in obj ? __defProp7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField6 = (obj, key, value) => __defNormalProp6(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -4727,7 +4727,7 @@ var OptimisticQueryResults = class {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/vendor/long.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/vendor/long.js
 var __defProp8 = Object.defineProperty;
 var __defNormalProp7 = (obj, key, value) => key in obj ? __defProp8(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField7 = (obj, key, value) => __defNormalProp7(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -4804,7 +4804,7 @@ var TWO_PWR_32_DBL = TWO_PWR_16_DBL * TWO_PWR_16_DBL;
 var TWO_PWR_64_DBL = TWO_PWR_32_DBL * TWO_PWR_32_DBL;
 var MAX_UNSIGNED_VALUE = new Long(4294967295 | 0, 4294967295 | 0);
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/remote_query_set.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/remote_query_set.js
 var __defProp9 = Object.defineProperty;
 var __defNormalProp8 = (obj, key, value) => key in obj ? __defProp9(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField8 = (obj, key, value) => __defNormalProp8(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -4879,7 +4879,7 @@ var RemoteQuerySet = class {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/protocol.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/protocol.js
 function u64ToLong(encoded) {
   const integerBytes = base64_exports.toByteArray(encoded);
   return Long.fromBytesLE(Array.from(integerBytes));
@@ -4949,7 +4949,7 @@ function encodeClientMessage(message) {
   return void 0;
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/web_socket_manager.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/web_socket_manager.js
 var __defProp10 = Object.defineProperty;
 var __defNormalProp9 = (obj, key, value) => key in obj ? __defProp10(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField9 = (obj, key, value) => __defNormalProp9(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -5588,7 +5588,7 @@ var WebSocketManager = class {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/session.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/session.js
 function newSessionId() {
   return uuidv4();
 }
@@ -5599,7 +5599,7 @@ function uuidv4() {
   });
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/vendor/jwt-decode/index.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/vendor/jwt-decode/index.js
 var InvalidTokenError = class extends Error {
 };
 InvalidTokenError.prototype.name = "InvalidTokenError";
@@ -5663,7 +5663,7 @@ function jwtDecode(token, options) {
   }
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/authentication_manager.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/authentication_manager.js
 var __defProp11 = Object.defineProperty;
 var __defNormalProp10 = (obj, key, value) => key in obj ? __defProp11(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField10 = (obj, key, value) => __defNormalProp10(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -5977,7 +5977,7 @@ var AuthenticationManager = class {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/metrics.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/metrics.js
 var markNames = [
   "convexClientConstructed",
   "convexWebSocketOpen",
@@ -6008,7 +6008,7 @@ function getMarksReport(sessionId) {
   return allMarks.map(performanceMarkToJson);
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/client.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/client.js
 var __defProp12 = Object.defineProperty;
 var __defNormalProp11 = (obj, key, value) => key in obj ? __defProp12(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField11 = (obj, key, value) => __defNormalProp11(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -6717,11 +6717,11 @@ var BaseConvexClient = class {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/simple_client-node.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/simple_client-node.js
 import { createRequire } from "module";
 import { resolve as nodePathResolve } from "path";
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/pagination.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/pagination.js
 function asPaginationResult(value) {
   if (typeof value !== "object" || value === null || !Array.isArray(value.page) || typeof value.isDone !== "boolean" || typeof value.continueCursor !== "string") {
     throw new Error(`Not a valid paginated query result: ${value?.toString()}`);
@@ -6729,7 +6729,7 @@ function asPaginationResult(value) {
   return value;
 }
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/sync/paginated_query_client.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/sync/paginated_query_client.js
 var __defProp13 = Object.defineProperty;
 var __defNormalProp12 = (obj, key, value) => key in obj ? __defProp13(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField12 = (obj, key, value) => __defNormalProp12(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -7085,7 +7085,7 @@ var PaginatedQueryClient = class {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/simple_client.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/simple_client.js
 var __defProp14 = Object.defineProperty;
 var __defNormalProp13 = (obj, key, value) => key in obj ? __defProp14(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField13 = (obj, key, value) => __defNormalProp13(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -7478,7 +7478,7 @@ var ConvexClient = class {
   }
 };
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/browser/simple_client-node.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/browser/simple_client-node.js
 var require2 = createRequire(nodePathResolve("."));
 var __create = Object.create;
 var __defProp15 = Object.defineProperty;
@@ -11299,7 +11299,7 @@ var wrapper_default = import_websocket.default;
 var nodeWebSocket = wrapper_default;
 setDefaultWebSocketConstructor(nodeWebSocket);
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/server/pagination.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/server/pagination.js
 var paginationOptsValidator = v.object({
   numItems: v.number(),
   cursor: v.union(v.string(), v.null()),
@@ -11309,7 +11309,7 @@ var paginationOptsValidator = v.object({
   maximumBytesRead: v.optional(v.number())
 });
 
-// ../../node_modules/.pnpm/convex@1.32.0_react@19.2.1/node_modules/convex/dist/esm/server/schema.js
+// ../../node_modules/.pnpm/convex@1.33.0_patch_hash=l43bztwr6e2lbmpd6ao6hmcg24_react@19.2.1/node_modules/convex/dist/esm/server/schema.js
 var __defProp16 = Object.defineProperty;
 var __defNormalProp14 = (obj, key, value) => key in obj ? __defProp16(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField14 = (obj, key, value) => __defNormalProp14(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -11503,6 +11503,7 @@ var _systemSchema = defineSchema({
 });
 
 // src/subscription.ts
+import { execFileSync } from "node:child_process";
 function deriveConvexUrl(apiUrl) {
   return apiUrl.replace(/\.convex\.site\/?$/, ".convex.cloud");
 }
@@ -11584,6 +11585,7 @@ var markDeliveredByPlugin = makeFunctionReference("notifications:markDeliveredBy
 var upsertTelemetryFromPlugin = makeFunctionReference("telemetryPlugin:upsertTelemetryFromPlugin");
 var upsertSessionsFromPlugin = makeFunctionReference("telemetryPlugin:upsertSessionsFromPlugin");
 var pushActivityFromPluginRef = makeFunctionReference("activityFeed:pushActivityFromPlugin");
+var upsertCronSnapshotFromPluginRef = makeFunctionReference("telemetryPlugin:upsertCronSnapshotFromPlugin");
 var getPendingCommandsForPlugin = makeFunctionReference("gatewayCommands:getPendingForPlugin");
 var acknowledgeCommandRef = makeFunctionReference("gatewayCommands:acknowledgeCommand");
 var addCommentFromPluginRef = makeFunctionReference("comments:addCommentFromPlugin");
@@ -11740,23 +11742,38 @@ function initCommandSubscription(cfg, logger) {
       if (processing) return;
       if (commands.length === 0) return;
       processing = true;
-      const cmd = commands[commands.length - 1];
-      logger.info(`cohort-sync: received gateway command: ${cmd.type} (${cmd._id})`);
-      if (cmd.type === "restart") {
-        try {
-          await c.mutation(acknowledgeCommandRef, {
-            commandId: cmd._id,
-            apiKey: cfg.apiKey
-          });
-          logger.info("cohort-sync: restart command acknowledged, terminating in 500ms");
-          await new Promise((r) => setTimeout(r, 500));
-          process.kill(process.pid, "SIGTERM");
-        } catch (err) {
-          logger.error(`cohort-sync: failed to process restart command: ${String(err)}`);
-          processing = false;
+      try {
+        for (const cmd of commands) {
+          logger.info(`cohort-sync: processing command: ${cmd.type} (${cmd._id})`);
+          try {
+            await c.mutation(acknowledgeCommandRef, {
+              commandId: cmd._id,
+              apiKey: cfg.apiKey
+            });
+            if (cmd.type === "restart") {
+              logger.info("cohort-sync: restart acknowledged, terminating in 500ms");
+              await new Promise((r) => setTimeout(r, 500));
+              process.kill(process.pid, "SIGTERM");
+              return;
+            }
+            if (cmd.type.startsWith("cron") && cmd.payload?.jobId) {
+              handleCronCommand(cmd.type, cmd.payload.jobId, logger);
+              try {
+                const freshJobs = fetchCronJobs(logger);
+                await pushCronSnapshot(cfg.apiKey, freshJobs);
+              } catch (snapErr) {
+                logger.warn(`cohort-sync: post-command snapshot push failed: ${String(snapErr)}`);
+              }
+            } else if (cmd.type.startsWith("cron")) {
+              logger.warn(`cohort-sync: cron command missing jobId: ${cmd.type}`);
+            } else {
+              logger.warn(`cohort-sync: unknown command type: ${cmd.type}`);
+            }
+          } catch (err) {
+            logger.error(`cohort-sync: failed to process command ${cmd._id}: ${String(err)}`);
+          }
         }
-      } else {
-        logger.warn(`cohort-sync: unknown command type: ${cmd.type}`);
+      } finally {
         processing = false;
       }
     },
@@ -11768,6 +11785,31 @@ function initCommandSubscription(cfg, logger) {
   getHotState().unsubscribers = [...unsubscribers];
   logger.info("cohort-sync: command subscription active");
 }
+function handleCronCommand(type, jobId, logger) {
+  const subcommandMap = {
+    cronEnable: ["cron", "enable", jobId],
+    cronDisable: ["cron", "disable", jobId],
+    cronRunNow: ["cron", "run", jobId],
+    cronDelete: ["cron", "delete", jobId, "--force"]
+  };
+  const args = subcommandMap[type];
+  if (!args) {
+    logger.warn(`cohort-sync: unknown cron command type: ${type}`);
+    return;
+  }
+  const timeout = type === "cronRunNow" ? 3e4 : 15e3;
+  try {
+    execFileSync("openclaw", args, {
+      encoding: "utf8",
+      timeout,
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    logger.info(`cohort-sync: cron command ${type} executed for job ${jobId}`);
+  } catch (err) {
+    logger.error(`cohort-sync: cron command ${type} failed for job ${jobId}: ${String(err)}`);
+    throw err;
+  }
+}
 async function callAddCommentFromPlugin(apiKey, args) {
   const c = getOrCreateClient();
   if (!c) {
@@ -11828,6 +11870,15 @@ async function pushActivity(apiKey, entries) {
     getLogger().error(`cohort-sync: pushActivity failed: ${err}`);
   }
 }
+async function pushCronSnapshot(apiKey, jobs) {
+  const c = getOrCreateClient();
+  if (!c) return;
+  try {
+    await c.mutation(upsertCronSnapshotFromPluginRef, { apiKey, jobs });
+  } catch (err) {
+    getLogger().error(`cohort-sync: pushCronSnapshot failed: ${err}`);
+  }
+}
 function saveIntervalsToHot(heartbeat, activityFlush) {
   const state = getHotState();
   state.intervals = { heartbeat, activityFlush };
@@ -11891,6 +11942,44 @@ function fetchSkills(logger) {
     return [];
   }
 }
+function fetchCronJobs(logger) {
+  try {
+    const raw = execSync("openclaw cron list --all --json", {
+      encoding: "utf8",
+      timeout: 1e4,
+      stdio: ["ignore", "pipe", "ignore"],
+      env: { ...process.env, NO_COLOR: "1" }
+    });
+    const parsed = JSON.parse(extractJson(raw));
+    const list = Array.isArray(parsed) ? parsed : parsed?.jobs ?? [];
+    return list.map((j) => ({
+      id: String(j.jobId ?? j.id ?? "unknown"),
+      text: String(j.name ?? j.text ?? ""),
+      schedule: formatSchedule(j.schedule),
+      ...j.nextRunAt != null ? { nextRun: Number(j.nextRunAt) } : {},
+      ...j.lastRunAt != null ? { lastRun: Number(j.lastRunAt) } : {},
+      ...j.lastStatus ? { lastStatus: String(j.lastStatus) } : {},
+      enabled: j.enabled !== false,
+      ...j.agentId != null ? { agentId: String(j.agentId) } : {}
+    }));
+  } catch (err) {
+    logger.warn(`cohort-sync: failed to fetch cron jobs: ${String(err)}`);
+    return [];
+  }
+}
+function formatSchedule(schedule) {
+  if (typeof schedule === "string") return schedule;
+  if (schedule && typeof schedule === "object") {
+    const s = schedule;
+    if (s.kind === "cron" && typeof s.expr === "string") return s.expr;
+    if (s.kind === "interval" && typeof s.everyMs === "number") {
+      const mins = Math.floor(Number(s.everyMs) / 6e4);
+      if (mins > 0) return `*/${mins} * * * *`;
+      return `every ${s.everyMs}ms`;
+    }
+  }
+  return String(schedule);
+}
 var VALID_STATUSES = /* @__PURE__ */ new Set(["idle", "working", "waiting"]);
 function normalizeStatus(status) {
   return VALID_STATUSES.has(status) ? status : "idle";
@@ -12537,6 +12626,53 @@ var AgentStateTracker = class {
   }
 };
 
+// src/pocket-guide.ts
+var POCKET_GUIDE = `# Cohort Agent Guide (Pocket Version)
+
+> These are the essential rules. For the full guide, see https://docs.cohort.bot/integration/guide
+
+## Getting Started
+- Call the cohort_context tool at the start of every work session for your personalized briefing.
+- If cohort_context is unavailable, call GET /api/v1/context directly.
+- Do not skip the context call \u2014 it contains workspace-specific overrides that supersede these rules.
+
+## Task Lifecycle
+- Create tasks for trackable work items. Always set priority (default p2) and effort when estimable.
+- Use POST /tasks/:id/transition for status changes. Never PATCH status directly \u2014 the server rejects it.
+- If a transition is rejected, read the error response for valid transitions from the current status.
+- You cannot transition tasks to "done" unless your workspace admin has enabled it. Only humans close tasks by default.
+- When moving to "in_progress", you are claiming ownership \u2014 only claim tasks you can actively work on.
+- When moving to "waiting", comment what you are blocked on and who/what can unblock you.
+- When work is complete, comment with evidence: PR link, test output, or summary of changes.
+
+## Comments
+- Comment before every status transition explaining what happened.
+- Post progress updates every 15-30 minutes on long-running work.
+- Keep comments factual \u2014 what you did, what you found, what is next.
+- No conversational filler. Every comment must contain information.
+- Reference specific files, line numbers, error messages, or URLs when relevant.
+
+## Projects & Initiatives
+- Don't create projects or initiatives without explicit instruction.
+- Assign tasks to existing projects when one fits. Don't create a project for a single task.
+- If no project fits, leave the task unassigned to a project.
+
+## Error Recovery
+- If auth fails (401), stop immediately. Do not retry. Report the failure.
+- If rate limited (429), wait per Retry-After header.
+- If 404, verify you are using the correct task number or ID (both accepted).
+- If 500, retry once after a brief pause. If it fails again, stop and report.
+
+## What Not To Do
+- Don't poll /tasks in a loop \u2014 check assignments, then do your work.
+- Don't create duplicate tasks \u2014 search first.
+- Don't delete tasks unless explicitly told to.
+- Don't bulk-create tasks speculatively \u2014 create them as work becomes concrete.
+- Don't modify tasks assigned to other agents unless coordinating through comments.
+- Don't set "done" on tasks you didn't work on.
+- Don't ignore workspace-specific overrides from your context response.
+`;
+
 // src/hooks.ts
 var BUILD_ID = "B9-ACCOUNTID-20260311";
 var DIAG_LOG_PATH = "/tmp/cohort-sync-diag.log";
@@ -12673,6 +12809,23 @@ function loadSessionsFromDisk(tracker, logger) {
   } catch {
   }
 }
+async function fetchAgentContext(apiKey, apiUrl, logger) {
+  try {
+    const response = await fetch(`${apiUrl}/api/v1/context`, {
+      method: "GET",
+      headers: { "Authorization": `Bearer ${apiKey}` }
+    });
+    if (!response.ok) {
+      logger.warn(`cohort-sync: /context returned ${response.status}, using pocket guide`);
+      return POCKET_GUIDE;
+    }
+    const data = await response.json();
+    return data.briefing || POCKET_GUIDE;
+  } catch (err) {
+    logger.warn(`cohort-sync: /context fetch failed: ${String(err)}, using pocket guide`);
+    return POCKET_GUIDE;
+  }
+}
 function registerHooks(api, cfg) {
   const { logger, config } = api;
   const nameMap = cfg.agentNameMap;
@@ -12879,6 +13032,20 @@ Do not attempt to make more comments until ${resetAt}.`
       }
     };
   });
+  api.registerTool(() => {
+    return {
+      name: "cohort_context",
+      label: "cohort_context",
+      description: "Get your Cohort session briefing. Call this at the start of every work session to receive your guidelines, current assignments, active projects, and recent team activity.",
+      parameters: Type.Object({}),
+      async execute() {
+        const briefing = await fetchAgentContext(cfg.apiKey, cfg.apiUrl, logger);
+        return {
+          content: [{ type: "text", text: briefing }]
+        };
+      }
+    };
+  });
   function resolveModel(agentId) {
     const agent = config?.agents?.list?.find((a) => a.id === agentId);
     const m = agent?.model;
@@ -12933,6 +13100,16 @@ Do not attempt to make more comments until ${resetAt}.`
       }
     }
     saveSessionsToDisk(tracker);
+    try {
+      const cronJobs2 = fetchCronJobs(logger);
+      const resolvedJobs = cronJobs2.map((job) => ({
+        ...job,
+        agentId: job.agentId ? resolveAgentName(job.agentId) : job.agentId
+      }));
+      await pushCronSnapshot(cfg.apiKey, resolvedJobs);
+    } catch (err) {
+      logger.warn(`cohort-sync: heartbeat cron push failed: ${String(err)}`);
+    }
     logger.info(`cohort-sync: heartbeat pushed for ${allAgentIds.length} agents`);
   }
   async function flushActivityBuffer() {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfio/cohort-sync",
-  "version": "0.2.4",
+  "version": "0.4.0",
   "description": "Syncs agent status and skills to Cohort dashboard",
   "type": "module",
   "main": "index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfio/cohort-sync",
-  "version": "0.2.4",
+  "version": "0.4.0",
   "description": "Syncs agent status and skills to Cohort dashboard",
   "license": "MIT",
   "homepage": "https://docs.cohort.bot/gateway",
@@ -41,10 +41,12 @@
     "openclaw": ">=0.1.0"
   },
   "openclaw": {
-    "extensions": ["./dist/index.js"]
+    "extensions": [
+      "./dist/index.js"
+    ]
   },
   "dependencies": {
     "@sinclair/typebox": "^0.34.0",
-    "convex": "^1.32.0"
+    "convex": "^1.33.0"
   }
 }