@calltelemetry/openclaw-linear 0.9.9 → 0.9.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calltelemetry/openclaw-linear",
-  "version": "0.9.9",
+  "version": "0.9.11",
   "description": "Linear Agent plugin for OpenClaw — webhook-driven AI pipeline with OAuth, multi-agent routing, and issue triage",
   "type": "module",
   "license": "MIT",

package/src/__test__/fixtures/recorded-sub-issue-flow.ts

@@ -2,7 +2,7 @@
  * Recorded API responses from sub-issue decomposition smoke test.
  * Auto-generated — do not edit manually.
  * Re-generate by running: npx vitest run src/__test__/smoke-linear-api.test.ts
- * Last recorded: 2026-02-22T02:27:42.743Z
+ * Last recorded: 2026-02-22T02:38:53.901Z
  */
 
 export const RECORDED = {
@@ -44,20 +44,20 @@ export const RECORDED = {
     }
   ],
   "createParent": {
-    "id": "fa2dd666-d1bc-4d53-bc18-db2d02caef96",
-    "identifier": "UAT-305"
+    "id": "953324f8-878f-40ba-b773-8d8815ee7987",
+    "identifier": "UAT-320"
   },
   "createSubIssue1": {
-    "id": "f342ec90-c5f1-483d-987b-9de406d65fac",
-    "identifier": "UAT-306"
+    "id": "69ce9a01-3bdb-4f4a-a882-e28e23d1b628",
+    "identifier": "UAT-321"
   },
   "createSubIssue2": {
-    "id": "210a5f52-a2bd-41a9-871f-b92563446d06",
-    "identifier": "UAT-307"
+    "id": "b39cc5eb-ec05-44aa-917b-562a290ecab6",
+    "identifier": "UAT-322"
   },
   "subIssue1Details": {
-    "id": "f342ec90-c5f1-483d-987b-9de406d65fac",
-    "identifier": "UAT-306",
+    "id": "69ce9a01-3bdb-4f4a-a882-e28e23d1b628",
+    "identifier": "UAT-321",
     "title": "[SMOKE TEST] Sub-Issue 1: Backend API",
     "description": "Implement the backend search API endpoint.\n\nGiven a search query, when the API is called, then matching results are returned.",
     "estimate": 2,
@@ -83,16 +83,16 @@ export const RECORDED = {
     },
     "project": null,
     "parent": {
-      "id": "fa2dd666-d1bc-4d53-bc18-db2d02caef96",
-      "identifier": "UAT-305"
+      "id": "953324f8-878f-40ba-b773-8d8815ee7987",
+      "identifier": "UAT-320"
     },
     "relations": {
       "nodes": []
     }
   },
   "subIssue2Details": {
-    "id": "210a5f52-a2bd-41a9-871f-b92563446d06",
-    "identifier": "UAT-307",
+    "id": "b39cc5eb-ec05-44aa-917b-562a290ecab6",
+    "identifier": "UAT-322",
     "title": "[SMOKE TEST] Sub-Issue 2: Frontend UI",
     "description": "Build the frontend search UI component.\n\nGiven the search page loads, when the user types a query, then results display in real-time.",
     "estimate": 3,
@@ -114,28 +114,22 @@ export const RECORDED = {
       "issueEstimationType": "tShirt"
     },
     "comments": {
-      "nodes": [
-        {
-          "body": "This thread is for an agent session with ctclaw.",
-          "user": null,
-          "createdAt": "2026-02-22T02:27:41.198Z"
-        }
-      ]
+      "nodes": []
     },
     "project": null,
     "parent": {
-      "id": "fa2dd666-d1bc-4d53-bc18-db2d02caef96",
-      "identifier": "UAT-305"
+      "id": "953324f8-878f-40ba-b773-8d8815ee7987",
+      "identifier": "UAT-320"
     },
     "relations": {
       "nodes": []
     }
   },
   "parentDetails": {
-    "id": "fa2dd666-d1bc-4d53-bc18-db2d02caef96",
-    "identifier": "UAT-305",
+    "id": "953324f8-878f-40ba-b773-8d8815ee7987",
+    "identifier": "UAT-320",
     "title": "[SMOKE TEST] Sub-Issue Parent: Search Feature",
-    "description": "Auto-generated by smoke test to verify sub-issue decomposition.\n\nThis parent issue should have two sub-issues created under it.\n\nCreated: 2026-02-22T02:27:39.194Z",
+    "description": "Auto-generated by smoke test to verify sub-issue decomposition.\n\nThis parent issue should have two sub-issues created under it.\n\nCreated: 2026-02-22T02:38:52.132Z",
     "estimate": null,
     "state": {
       "name": "Backlog",
@@ -155,13 +149,7 @@ export const RECORDED = {
       "issueEstimationType": "tShirt"
     },
     "comments": {
-      "nodes": [
-        {
-          "body": "This thread is for an agent session with ctclaw.",
-          "user": null,
-          "createdAt": "2026-02-22T02:27:39.821Z"
-        }
-      ]
+      "nodes": []
     },
     "project": null,
     "parent": null,
@@ -170,11 +158,11 @@ export const RECORDED = {
     }
   },
   "createRelation": {
-    "id": "b7040537-aa53-4e7d-a76d-fd220df3e527"
+    "id": "9207d26d-d65d-45a2-ac76-b9233acea181"
   },
   "subIssue1WithRelation": {
-    "id": "f342ec90-c5f1-483d-987b-9de406d65fac",
-    "identifier": "UAT-306",
+    "id": "69ce9a01-3bdb-4f4a-a882-e28e23d1b628",
+    "identifier": "UAT-321",
     "title": "[SMOKE TEST] Sub-Issue 1: Backend API",
     "description": "Implement the backend search API endpoint.\n\nGiven a search query, when the API is called, then matching results are returned.",
     "estimate": 2,
@@ -196,26 +184,20 @@ export const RECORDED = {
       "issueEstimationType": "tShirt"
     },
     "comments": {
-      "nodes": [
-        {
-          "body": "This thread is for an agent session with ctclaw.",
-          "user": null,
-          "createdAt": "2026-02-22T02:27:40.662Z"
-        }
-      ]
+      "nodes": []
     },
     "project": null,
     "parent": {
-      "id": "fa2dd666-d1bc-4d53-bc18-db2d02caef96",
-      "identifier": "UAT-305"
+      "id": "953324f8-878f-40ba-b773-8d8815ee7987",
+      "identifier": "UAT-320"
     },
     "relations": {
       "nodes": [
         {
           "type": "blocks",
           "relatedIssue": {
-            "id": "210a5f52-a2bd-41a9-871f-b92563446d06",
-            "identifier": "UAT-307",
+            "id": "b39cc5eb-ec05-44aa-917b-562a290ecab6",
+            "identifier": "UAT-322",
             "title": "[SMOKE TEST] Sub-Issue 2: Frontend UI"
           }
         }
@@ -223,8 +205,8 @@ export const RECORDED = {
     }
   },
   "subIssue2WithRelation": {
-    "id": "210a5f52-a2bd-41a9-871f-b92563446d06",
-    "identifier": "UAT-307",
+    "id": "b39cc5eb-ec05-44aa-917b-562a290ecab6",
+    "identifier": "UAT-322",
     "title": "[SMOKE TEST] Sub-Issue 2: Frontend UI",
     "description": "Build the frontend search UI component.\n\nGiven the search page loads, when the user types a query, then results display in real-time.",
     "estimate": 3,
@@ -250,14 +232,14 @@ export const RECORDED = {
         {
           "body": "This thread is for an agent session with ctclaw.",
           "user": null,
-          "createdAt": "2026-02-22T02:27:41.198Z"
+          "createdAt": "2026-02-22T02:38:53.699Z"
         }
       ]
     },
     "project": null,
     "parent": {
-      "id": "fa2dd666-d1bc-4d53-bc18-db2d02caef96",
-      "identifier": "UAT-305"
+      "id": "953324f8-878f-40ba-b773-8d8815ee7987",
+      "identifier": "UAT-320"
     },
     "relations": {
       "nodes": []

package/src/infra/shared-profiles.test.ts

@@ -4,12 +4,18 @@ import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
 // Mocks
 // ---------------------------------------------------------------------------
 
-const { mockReadFileSync } = vi.hoisted(() => ({
+const { mockReadFileSync, mockWriteFileSync, mockMkdirSync, mockExistsSync } = vi.hoisted(() => ({
   mockReadFileSync: vi.fn(),
+  mockWriteFileSync: vi.fn(),
+  mockMkdirSync: vi.fn(),
+  mockExistsSync: vi.fn().mockReturnValue(true),
 }));
 
 vi.mock("node:fs", () => ({
   readFileSync: mockReadFileSync,
+  writeFileSync: mockWriteFileSync,
+  mkdirSync: mockMkdirSync,
+  existsSync: mockExistsSync,
 }));
 
 // ---------------------------------------------------------------------------
@@ -21,6 +27,9 @@ import {
   buildMentionPattern,
   resolveAgentFromAlias,
   resolveDefaultAgent,
+  createAgentProfilesFile,
+  validateProfiles,
+  PROFILES_PATH,
   _resetProfilesCacheForTesting,
   type AgentProfile,
 } from "./shared-profiles.js";
@@ -61,6 +70,7 @@ beforeEach(() => {
   vi.clearAllMocks();
   _resetProfilesCacheForTesting();
   mockReadFileSync.mockReturnValue(PROFILES_JSON);
+  mockExistsSync.mockReturnValue(true);
 });
 
 afterEach(() => {
@@ -260,3 +270,115 @@ describe("resolveDefaultAgent", () => {
     expect(result).toBe("mal");
   });
 });
+
+// ---------------------------------------------------------------------------
+// createAgentProfilesFile
+// ---------------------------------------------------------------------------
+
+describe("createAgentProfilesFile", () => {
+  it("writes correct JSON structure to PROFILES_PATH", () => {
+    createAgentProfilesFile({
+      agentId: "bobbin",
+      label: "Bobbin",
+      mentionAliases: ["bobbin", "bob"],
+    });
+
+    expect(mockMkdirSync).toHaveBeenCalledTimes(1);
+    expect(mockWriteFileSync).toHaveBeenCalledTimes(1);
+
+    const [path, content] = mockWriteFileSync.mock.calls[0];
+    expect(path).toBe(PROFILES_PATH);
+
+    const parsed = JSON.parse(content);
+    expect(parsed.agents.bobbin).toEqual({
+      label: "Bobbin",
+      mission: "AI assistant for Linear issues",
+      isDefault: true,
+      mentionAliases: ["bobbin", "bob"],
+    });
+  });
+
+  it("uses custom mission when provided", () => {
+    createAgentProfilesFile({
+      agentId: "claw",
+      label: "The Claw",
+      mentionAliases: ["claw"],
+      mission: "Code review specialist",
+    });
+
+    const [, content] = mockWriteFileSync.mock.calls[0];
+    const parsed = JSON.parse(content);
+    expect(parsed.agents.claw.mission).toBe("Code review specialist");
+  });
+
+  it("creates parent directory recursively", () => {
+    createAgentProfilesFile({
+      agentId: "test",
+      label: "Test",
+      mentionAliases: ["test"],
+    });
+
+    expect(mockMkdirSync).toHaveBeenCalledWith(
+      expect.any(String),
+      { recursive: true },
+    );
+  });
+
+  it("busts the profile cache", () => {
+    // Load to populate cache
+    loadAgentProfiles();
+    expect(mockReadFileSync).toHaveBeenCalledTimes(1);
+
+    // Create a new profile — should bust cache
+    createAgentProfilesFile({
+      agentId: "fresh",
+      label: "Fresh",
+      mentionAliases: ["fresh"],
+    });
+
+    // Next load should re-read from disk (cache was busted)
+    loadAgentProfiles();
+    expect(mockReadFileSync).toHaveBeenCalledTimes(2);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// validateProfiles
+// ---------------------------------------------------------------------------
+
+describe("validateProfiles", () => {
+  it("returns error when file is missing", () => {
+    mockExistsSync.mockReturnValue(false);
+
+    const result = validateProfiles();
+    expect(result).not.toBeNull();
+    expect(result).toContain("not found");
+    expect(result).toContain("openclaw openclaw-linear setup");
+  });
+
+  it("returns null when file is valid with agents", () => {
+    mockExistsSync.mockReturnValue(true);
+    mockReadFileSync.mockReturnValue(PROFILES_JSON);
+
+    const result = validateProfiles();
+    expect(result).toBeNull();
+  });
+
+  it("returns error when JSON is invalid", () => {
+    mockExistsSync.mockReturnValue(true);
+    mockReadFileSync.mockImplementation(() => { throw new SyntaxError("Unexpected token"); });
+
+    const result = validateProfiles();
+    expect(result).not.toBeNull();
+    expect(result).toContain("could not be parsed");
+  });
+
+  it("returns error when agents object is empty", () => {
+    mockExistsSync.mockReturnValue(true);
+    mockReadFileSync.mockReturnValue(JSON.stringify({ agents: {} }));
+
+    const result = validateProfiles();
+    expect(result).not.toBeNull();
+    expect(result).toContain("no agents configured");
+  });
+});

package/src/pipeline/active-session.ts

@@ -42,9 +42,16 @@ let _affinityTtlMs = 30 * 60_000; // 30 minutes default
 /**
  * Register the active session for an issue. Idempotent — calling again
  * for the same issue just updates the session.
+ *
+ * Also eagerly records agent affinity so that follow-up webhooks arriving
+ * during or after the run resolve to the correct agent — even if the
+ * gateway restarts before clearActiveSession is called.
  */
 export function setActiveSession(session: ActiveSession): void {
   sessions.set(session.issueId, session);
+  if (session.agentId) {
+    recordIssueAffinity(session.issueId, session.agentId);
+  }
 }
 
 /**

package/src/pipeline/webhook.ts

@@ -484,10 +484,10 @@ export async function handleLinearWebhook(
     activeRuns.add(issue.id);
     void (async () => {
       const profiles = loadAgentProfiles();
-      const defaultProfile = Object.entries(profiles).find(([, p]) => p.isDefault);
-      const label = defaultProfile?.[1]?.label ?? profiles[agentId]?.label ?? agentId;
+      const label = profiles[agentId]?.label ?? agentId;
 
       // Register active session for tool resolution (code_run, etc.)
+      // Also eagerly records affinity so follow-ups route to the same agent.
       setActiveSession({
         agentSessionId: session.id,
         issueIdentifier: enrichedIssue?.identifier ?? issue.identifier ?? issue.id,
@@ -531,7 +531,7 @@ export async function handleLinearWebhook(
         }).then(() => true).catch(() => false);
 
         if (!emitted) {
-          const avatarUrl = defaultProfile?.[1]?.avatarUrl ?? profiles[agentId]?.avatarUrl;
+          const avatarUrl = profiles[agentId]?.avatarUrl;
           const agentOpts = avatarUrl
             ? { createAsUser: label, displayIconUrl: avatarUrl }
             : undefined;
@@ -648,8 +648,7 @@ export async function handleLinearWebhook(
     activeRuns.add(issue.id);
     void (async () => {
       const profiles = loadAgentProfiles();
-      const defaultProfile = Object.entries(profiles).find(([, p]) => p.isDefault);
-      const label = defaultProfile?.[1]?.label ?? profiles[agentId]?.label ?? agentId;
+      const label = profiles[agentId]?.label ?? agentId;
 
       // Fetch full issue details for context
       let enrichedIssue: any = issue;
@@ -764,7 +763,7 @@ export async function handleLinearWebhook(
         }).then(() => true).catch(() => false);
 
         if (!emitted) {
-          const avatarUrl = defaultProfile?.[1]?.avatarUrl ?? profiles[agentId]?.avatarUrl;
+          const avatarUrl = profiles[agentId]?.avatarUrl;
           const agentOpts = avatarUrl
             ? { createAsUser: label, displayIconUrl: avatarUrl }
             : undefined;
@@ -1150,9 +1149,8 @@ export async function handleLinearWebhook(
     // Dispatch triage (non-blocking)
     void (async () => {
       const profiles = loadAgentProfiles();
-      const defaultProfile = Object.entries(profiles).find(([, p]) => p.isDefault);
-      const label = defaultProfile?.[1]?.label ?? profiles[agentId]?.label ?? agentId;
-      const avatarUrl = defaultProfile?.[1]?.avatarUrl ?? profiles[agentId]?.avatarUrl;
+      const label = profiles[agentId]?.label ?? agentId;
+      const avatarUrl = profiles[agentId]?.avatarUrl;
       let agentSessionId: string | null = null;
 
       try {