@cfio/cohort-sync 0.3.0 → 0.4.1

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);
@@ -11728,7 +11728,7 @@ async function initSubscription(port, cfg, hooksToken, logger) {
   }
   state.unsubscribers = [...unsubscribers];
 }
-function initCommandSubscription(cfg, logger) {
+function initCommandSubscription(cfg, logger, resolveAgentName) {
   const c = getOrCreateClient();
   if (!c) {
     logger.warn("cohort-sync: no ConvexClient \u2014 command subscription skipped");
@@ -11760,7 +11760,8 @@ function initCommandSubscription(cfg, logger) {
               handleCronCommand(cmd.type, cmd.payload.jobId, logger);
               try {
                 const freshJobs = fetchCronJobs(logger);
-                await pushCronSnapshot(cfg.apiKey, freshJobs);
+                const resolvedJobs = resolveAgentName ? freshJobs.map((j) => ({ ...j, agentId: j.agentId ? resolveAgentName(j.agentId) : j.agentId })) : freshJobs;
+                await pushCronSnapshot(cfg.apiKey, resolvedJobs);
               } catch (snapErr) {
                 logger.warn(`cohort-sync: post-command snapshot push failed: ${String(snapErr)}`);
               }
@@ -12626,6 +12627,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";
@@ -12762,6 +12810,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;
@@ -12783,6 +12848,18 @@ function registerHooks(api, cfg) {
   setLogger(logger);
   restoreFromHotReload(logger);
   restoreRosterFromHotReload(getRosterHotState(), logger);
+  const identityNameMap = {};
+  const mainIdentity = parseIdentityFile(process.cwd());
+  if (mainIdentity?.name) {
+    identityNameMap["main"] = mainIdentity.name.toLowerCase();
+  }
+  for (const agent of config?.agents?.list ?? []) {
+    const identity = resolveIdentity(agent.identity, agent.workspace);
+    if (identity?.name) {
+      identityNameMap[agent.id] = identity.name.toLowerCase();
+    }
+  }
+  diag("IDENTITY_NAME_MAP", { identityNameMap });
   if (tracker.getAgentNames().length === 0) {
     loadSessionsFromDisk(tracker, logger);
     const restoredAgents = tracker.getAgentNames();
@@ -12799,7 +12876,7 @@ function registerHooks(api, cfg) {
     }
   }
   function resolveAgentName(agentId) {
-    return (nameMap?.[agentId] ?? agentId).toLowerCase();
+    return (nameMap?.[agentId] ?? identityNameMap[agentId] ?? agentId).toLowerCase();
   }
   function resolveAgentFromContext(ctx) {
     const allCtxKeys = Object.keys(ctx);
@@ -12968,6 +13045,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;
@@ -13077,7 +13168,7 @@ Do not attempt to make more comments until ${resetAt}.`
     ).catch((err) => {
       logger.error(`cohort-sync: subscription init failed: ${String(err)}`);
     });
-    initCommandSubscription(cfg, logger);
+    initCommandSubscription(cfg, logger, resolveAgentName);
     const allAgentIds = ["main", ...(config?.agents?.list ?? []).map((a) => a.id)];
     for (const agentId of allAgentIds) {
       const agentName = resolveAgentName(agentId);

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfio/cohort-sync",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "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.3.0",
+  "version": "0.4.1",
   "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"
   }
 }