@calltelemetry/openclaw-linear 0.9.5 → 0.9.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calltelemetry/openclaw-linear",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "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

@@ -1,172 +1,248 @@
 /**
  * Recorded API responses from sub-issue decomposition smoke test.
- *
- * Initially seeded with placeholder data. Overwritten with real API responses
- * when the smoke test runs: npx vitest run src/__test__/smoke-linear-api.test.ts
- *
- * Last recorded: seed (placeholder)
+ * 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:01:43.760Z
  */
 
 export const RECORDED = {
-  teamStates: [
-    { id: "state-backlog", name: "Backlog", type: "backlog" },
-    { id: "state-started", name: "In Progress", type: "started" },
-    { id: "state-done", name: "Done", type: "completed" },
-    { id: "state-canceled", name: "Canceled", type: "canceled" },
-  ],
-  createParent: { id: "parent-001", identifier: "UAT-100" },
-  createSubIssue1: { id: "sub1-001", identifier: "UAT-101" },
-  createSubIssue2: { id: "sub2-001", identifier: "UAT-102" },
-  parentDetails: {
-    id: "parent-001",
-    identifier: "UAT-100",
-    title: "[SMOKE TEST] Sub-Issue Parent: Search Feature",
-    description:
-      "Auto-generated by smoke test to verify sub-issue decomposition.\n\n" +
-      "This parent issue should have two sub-issues created under it.",
-    estimate: null,
-    state: { name: "Backlog", type: "backlog" },
-    creator: { name: "Test User", email: null as string | null },
-    assignee: null as { name: string } | null,
-    labels: { nodes: [] as Array<{ id: string; name: string }> },
-    team: { id: "team-uat", name: "UAT", issueEstimationType: "notUsed" },
-    comments: {
-      nodes: [] as Array<{
-        body: string;
-        user: { name: string } | null;
-        createdAt: string;
-      }>,
-    },
-    project: null as { id: string; name: string } | null,
-    parent: null as { id: string; identifier: string } | null,
-    relations: {
-      nodes: [] as Array<{
-        type: string;
-        relatedIssue: { id: string; identifier: string; title: string };
-      }>,
+  "teamStates": [
+    {
+      "id": "cf937197-a76e-4f36-9938-5013442f2137",
+      "name": "Todo",
+      "type": "unstarted"
+    },
+    {
+      "id": "9e40430a-5404-4fed-be64-544417c7c46c",
+      "name": "Duplicate",
+      "type": "canceled"
+    },
+    {
+      "id": "9bf913d6-f32d-452f-af43-3139cc8e5f3f",
+      "name": "Canceled",
+      "type": "canceled"
+    },
+    {
+      "id": "7510263f-555b-42c4-98c3-f4196d755c4b",
+      "name": "In Progress",
+      "type": "started"
+    },
+    {
+      "id": "6bcb2601-dc7b-487e-a407-416521aa235e",
+      "name": "Backlog",
+      "type": "backlog"
     },
+    {
+      "id": "69c39ddf-d135-47f7-8dbe-3fc6a539d504",
+      "name": "Done",
+      "type": "completed"
+    },
+    {
+      "id": "2a4c7f41-80cd-4798-91e7-0aa6656d73ca",
+      "name": "In Review",
+      "type": "started"
+    }
+  ],
+  "createParent": {
+    "id": "7b5cc5d3-ec16-47e0-b0c4-caf8eea47609",
+    "identifier": "UAT-265"
+  },
+  "createSubIssue1": {
+    "id": "de6d1ea0-3358-406a-bcfd-1d19b1516442",
+    "identifier": "UAT-266"
   },
-  subIssue1Details: {
-    id: "sub1-001",
-    identifier: "UAT-101",
-    title: "[SMOKE TEST] Sub-Issue 1: Backend API",
-    description:
-      "Implement the backend search API endpoint.\n\n" +
-      "Given a search query, when the API is called, then matching results are returned.",
-    estimate: 2,
-    state: { name: "Backlog", type: "backlog" },
-    creator: { name: "Test User", email: null as string | null },
-    assignee: null as { name: string } | null,
-    labels: { nodes: [] as Array<{ id: string; name: string }> },
-    team: { id: "team-uat", name: "UAT", issueEstimationType: "notUsed" },
-    comments: {
-      nodes: [] as Array<{
-        body: string;
-        user: { name: string } | null;
-        createdAt: string;
-      }>,
-    },
-    project: null as { id: string; name: string } | null,
-    parent: { id: "parent-001", identifier: "UAT-100" },
-    relations: {
-      nodes: [] as Array<{
-        type: string;
-        relatedIssue: { id: string; identifier: string; title: string };
-      }>,
+  "createSubIssue2": {
+    "id": "7ca89fc7-b246-44b6-8400-0e2a4d169f47",
+    "identifier": "UAT-267"
+  },
+  "subIssue1Details": {
+    "id": "de6d1ea0-3358-406a-bcfd-1d19b1516442",
+    "identifier": "UAT-266",
+    "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,
+    "state": {
+      "name": "Backlog",
+      "type": "backlog"
+    },
+    "creator": {
+      "name": "jason.barbee@calltelemetry.com",
+      "email": "jason.barbee@calltelemetry.com"
     },
+    "assignee": null,
+    "labels": {
+      "nodes": []
+    },
+    "team": {
+      "id": "08cba264-d774-4afd-bc93-ee8213d12ef8",
+      "name": "UAT",
+      "issueEstimationType": "tShirt"
+    },
+    "comments": {
+      "nodes": []
+    },
+    "project": null,
+    "parent": {
+      "id": "7b5cc5d3-ec16-47e0-b0c4-caf8eea47609",
+      "identifier": "UAT-265"
+    },
+    "relations": {
+      "nodes": []
+    }
   },
-  subIssue2Details: {
-    id: "sub2-001",
-    identifier: "UAT-102",
-    title: "[SMOKE TEST] Sub-Issue 2: Frontend UI",
-    description:
-      "Build the frontend search UI component.\n\n" +
-      "Given the search page loads, when the user types a query, then results display in real-time.",
-    estimate: 3,
-    state: { name: "Backlog", type: "backlog" },
-    creator: { name: "Test User", email: null as string | null },
-    assignee: null as { name: string } | null,
-    labels: { nodes: [] as Array<{ id: string; name: string }> },
-    team: { id: "team-uat", name: "UAT", issueEstimationType: "notUsed" },
-    comments: {
-      nodes: [] as Array<{
-        body: string;
-        user: { name: string } | null;
-        createdAt: string;
-      }>,
-    },
-    project: null as { id: string; name: string } | null,
-    parent: { id: "parent-001", identifier: "UAT-100" },
-    relations: {
-      nodes: [] as Array<{
-        type: string;
-        relatedIssue: { id: string; identifier: string; title: string };
-      }>,
+  "subIssue2Details": {
+    "id": "7ca89fc7-b246-44b6-8400-0e2a4d169f47",
+    "identifier": "UAT-267",
+    "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,
+    "state": {
+      "name": "Backlog",
+      "type": "backlog"
+    },
+    "creator": {
+      "name": "jason.barbee@calltelemetry.com",
+      "email": "jason.barbee@calltelemetry.com"
+    },
+    "assignee": null,
+    "labels": {
+      "nodes": []
+    },
+    "team": {
+      "id": "08cba264-d774-4afd-bc93-ee8213d12ef8",
+      "name": "UAT",
+      "issueEstimationType": "tShirt"
+    },
+    "comments": {
+      "nodes": []
+    },
+    "project": null,
+    "parent": {
+      "id": "7b5cc5d3-ec16-47e0-b0c4-caf8eea47609",
+      "identifier": "UAT-265"
     },
+    "relations": {
+      "nodes": []
+    }
   },
-  createRelation: { id: "rel-001" },
-  subIssue1WithRelation: {
-    id: "sub1-001",
-    identifier: "UAT-101",
-    title: "[SMOKE TEST] Sub-Issue 1: Backend API",
-    description:
-      "Implement the backend search API endpoint.\n\n" +
-      "Given a search query, when the API is called, then matching results are returned.",
-    estimate: 2,
-    state: { name: "Backlog", type: "backlog" },
-    creator: { name: "Test User", email: null as string | null },
-    assignee: null as { name: string } | null,
-    labels: { nodes: [] as Array<{ id: string; name: string }> },
-    team: { id: "team-uat", name: "UAT", issueEstimationType: "notUsed" },
-    comments: {
-      nodes: [] as Array<{
-        body: string;
-        user: { name: string } | null;
-        createdAt: string;
-      }>,
-    },
-    project: null as { id: string; name: string } | null,
-    parent: { id: "parent-001", identifier: "UAT-100" },
-    relations: {
-      nodes: [
-        {
-          type: "blocks",
-          relatedIssue: {
-            id: "sub2-001",
-            identifier: "UAT-102",
-            title: "[SMOKE TEST] Sub-Issue 2: Frontend UI",
-          },
-        },
-      ],
+  "parentDetails": {
+    "id": "7b5cc5d3-ec16-47e0-b0c4-caf8eea47609",
+    "identifier": "UAT-265",
+    "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:01:42.469Z",
+    "estimate": null,
+    "state": {
+      "name": "Backlog",
+      "type": "backlog"
+    },
+    "creator": {
+      "name": "jason.barbee@calltelemetry.com",
+      "email": "jason.barbee@calltelemetry.com"
+    },
+    "assignee": null,
+    "labels": {
+      "nodes": []
+    },
+    "team": {
+      "id": "08cba264-d774-4afd-bc93-ee8213d12ef8",
+      "name": "UAT",
+      "issueEstimationType": "tShirt"
+    },
+    "comments": {
+      "nodes": []
     },
+    "project": null,
+    "parent": null,
+    "relations": {
+      "nodes": []
+    }
   },
-  subIssue2WithRelation: {
-    id: "sub2-001",
-    identifier: "UAT-102",
-    title: "[SMOKE TEST] Sub-Issue 2: Frontend UI",
-    description:
-      "Build the frontend search UI component.\n\n" +
-      "Given the search page loads, when the user types a query, then results display in real-time.",
-    estimate: 3,
-    state: { name: "Backlog", type: "backlog" },
-    creator: { name: "Test User", email: null as string | null },
-    assignee: null as { name: string } | null,
-    labels: { nodes: [] as Array<{ id: string; name: string }> },
-    team: { id: "team-uat", name: "UAT", issueEstimationType: "notUsed" },
-    comments: {
-      nodes: [] as Array<{
-        body: string;
-        user: { name: string } | null;
-        createdAt: string;
-      }>,
-    },
-    project: null as { id: string; name: string } | null,
-    parent: { id: "parent-001", identifier: "UAT-100" },
-    relations: {
-      nodes: [] as Array<{
-        type: string;
-        relatedIssue: { id: string; identifier: string; title: string };
-      }>,
+  "createRelation": {
+    "id": "4c97b0aa-563e-4aad-84aa-826078f012fd"
+  },
+  "subIssue1WithRelation": {
+    "id": "de6d1ea0-3358-406a-bcfd-1d19b1516442",
+    "identifier": "UAT-266",
+    "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,
+    "state": {
+      "name": "Backlog",
+      "type": "backlog"
+    },
+    "creator": {
+      "name": "jason.barbee@calltelemetry.com",
+      "email": "jason.barbee@calltelemetry.com"
+    },
+    "assignee": null,
+    "labels": {
+      "nodes": []
+    },
+    "team": {
+      "id": "08cba264-d774-4afd-bc93-ee8213d12ef8",
+      "name": "UAT",
+      "issueEstimationType": "tShirt"
+    },
+    "comments": {
+      "nodes": []
     },
+    "project": null,
+    "parent": {
+      "id": "7b5cc5d3-ec16-47e0-b0c4-caf8eea47609",
+      "identifier": "UAT-265"
+    },
+    "relations": {
+      "nodes": [
+        {
+          "type": "blocks",
+          "relatedIssue": {
+            "id": "7ca89fc7-b246-44b6-8400-0e2a4d169f47",
+            "identifier": "UAT-267",
+            "title": "[SMOKE TEST] Sub-Issue 2: Frontend UI"
+          }
+        }
+      ]
+    }
   },
+  "subIssue2WithRelation": {
+    "id": "7ca89fc7-b246-44b6-8400-0e2a4d169f47",
+    "identifier": "UAT-267",
+    "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,
+    "state": {
+      "name": "Backlog",
+      "type": "backlog"
+    },
+    "creator": {
+      "name": "jason.barbee@calltelemetry.com",
+      "email": "jason.barbee@calltelemetry.com"
+    },
+    "assignee": null,
+    "labels": {
+      "nodes": []
+    },
+    "team": {
+      "id": "08cba264-d774-4afd-bc93-ee8213d12ef8",
+      "name": "UAT",
+      "issueEstimationType": "tShirt"
+    },
+    "comments": {
+      "nodes": [
+        {
+          "body": "This thread is for an agent session with ctclaw.",
+          "user": null,
+          "createdAt": "2026-02-22T02:01:43.418Z"
+        }
+      ]
+    },
+    "project": null,
+    "parent": {
+      "id": "7b5cc5d3-ec16-47e0-b0c4-caf8eea47609",
+      "identifier": "UAT-265"
+    },
+    "relations": {
+      "nodes": []
+    }
+  }
 };

package/src/__test__/smoke-linear-api.test.ts

@@ -8,12 +8,15 @@
  *
  * Requires: ~/.openclaw/auth-profiles.json with a valid linear:api-key profile.
  */
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
+import { readFileSync, writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
 import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
 import { LinearAgentApi } from "../api/linear-api.js";
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
 // ── Setup ──────────────────────────────────────────────────────────
 
 const AUTH_PROFILES_PATH = join(
@@ -438,7 +441,7 @@ describe("Linear API smoke tests", () => {
       }
 
       expect(issue.id).toBe(sessionIssueId);
-    });
+    }, 20_000);
 
     it("Path B: createSessionOnIssue via OAuth (programmatic)", async () => {
       expect(sessionIssueId).toBeTruthy();
@@ -479,6 +482,208 @@ describe("Linear API smoke tests", () => {
     });
   });
 
+  describe("sub-issue decomposition", () => {
+    let parentIssueId: string | null = null;
+    let parentIssueIdentifier: string | null = null;
+    let subIssue1Id: string | null = null;
+    let subIssue1Identifier: string | null = null;
+    let subIssue2Id: string | null = null;
+    let subIssue2Identifier: string | null = null;
+    const recorded: Record<string, unknown> = {};
+
+    let teamStates: Array<{ id: string; name: string; type: string }>;
+
+    it("fetches team states for sub-issue tests", async () => {
+      teamStates = await api.getTeamStates(TEAM_ID);
+      expect(teamStates.length).toBeGreaterThan(0);
+      recorded.teamStates = teamStates;
+    });
+
+    it("creates a parent issue", async () => {
+      const backlogState = teamStates.find((s) => s.type === "backlog");
+      expect(backlogState).toBeTruthy();
+
+      const result = await api.createIssue({
+        teamId: TEAM_ID,
+        title: "[SMOKE TEST] Sub-Issue Parent: Search Feature",
+        description:
+          "Auto-generated by smoke test to verify sub-issue decomposition.\n\n" +
+          "This parent issue should have two sub-issues created under it.\n\n" +
+          `Created: ${new Date().toISOString()}`,
+        stateId: backlogState!.id,
+        priority: 4,
+      });
+
+      expect(result.id).toBeTruthy();
+      expect(result.identifier).toBeTruthy();
+      parentIssueId = result.id;
+      parentIssueIdentifier = result.identifier;
+      recorded.createParent = result;
+      console.log(`Created parent issue: ${result.identifier} (${result.id})`);
+    });
+
+    it("creates sub-issue 1 under parent (Backend API)", async () => {
+      expect(parentIssueId).toBeTruthy();
+      const backlogState = teamStates.find((s) => s.type === "backlog");
+
+      const result = await api.createIssue({
+        teamId: TEAM_ID,
+        title: "[SMOKE TEST] Sub-Issue 1: Backend API",
+        description:
+          "Implement the backend search API endpoint.\n\n" +
+          "Given a search query, when the API is called, then matching results are returned.",
+        stateId: backlogState!.id,
+        parentId: parentIssueId!,
+        priority: 3,
+        estimate: 2,
+      });
+
+      expect(result.id).toBeTruthy();
+      expect(result.identifier).toBeTruthy();
+      subIssue1Id = result.id;
+      subIssue1Identifier = result.identifier;
+      recorded.createSubIssue1 = result;
+      console.log(`Created sub-issue 1: ${result.identifier} (parentId=${parentIssueId})`);
+    });
+
+    it("creates sub-issue 2 under parent (Frontend UI)", async () => {
+      expect(parentIssueId).toBeTruthy();
+      const backlogState = teamStates.find((s) => s.type === "backlog");
+
+      const result = await api.createIssue({
+        teamId: TEAM_ID,
+        title: "[SMOKE TEST] Sub-Issue 2: Frontend UI",
+        description:
+          "Build the frontend search UI component.\n\n" +
+          "Given the search page loads, when the user types a query, then results display in real-time.",
+        stateId: backlogState!.id,
+        parentId: parentIssueId!,
+        priority: 3,
+        estimate: 3,
+      });
+
+      expect(result.id).toBeTruthy();
+      expect(result.identifier).toBeTruthy();
+      subIssue2Id = result.id;
+      subIssue2Identifier = result.identifier;
+      recorded.createSubIssue2 = result;
+      console.log(`Created sub-issue 2: ${result.identifier} (parentId=${parentIssueId})`);
+    });
+
+    it("sub-issue 1 has parent field pointing to parent", async () => {
+      expect(subIssue1Id).toBeTruthy();
+      const details = await api.getIssueDetails(subIssue1Id!);
+
+      expect(details.parent).not.toBeNull();
+      expect(details.parent!.id).toBe(parentIssueId);
+      expect(details.parent!.identifier).toBe(parentIssueIdentifier);
+      recorded.subIssue1Details = details;
+      console.log(`Sub-issue 1 parent: ${details.parent!.identifier}`);
+    });
+
+    it("sub-issue 2 has parent field pointing to parent", async () => {
+      expect(subIssue2Id).toBeTruthy();
+      const details = await api.getIssueDetails(subIssue2Id!);
+
+      expect(details.parent).not.toBeNull();
+      expect(details.parent!.id).toBe(parentIssueId);
+      expect(details.parent!.identifier).toBe(parentIssueIdentifier);
+      recorded.subIssue2Details = details;
+      console.log(`Sub-issue 2 parent: ${details.parent!.identifier}`);
+    });
+
+    it("parent issue has no parent (it is the root)", async () => {
+      expect(parentIssueId).toBeTruthy();
+      const details = await api.getIssueDetails(parentIssueId!);
+
+      expect(details.parent).toBeNull();
+      recorded.parentDetails = details;
+    });
+
+    it("creates blocks relation (sub-issue 1 blocks sub-issue 2)", async () => {
+      expect(subIssue1Id).toBeTruthy();
+      expect(subIssue2Id).toBeTruthy();
+
+      const result = await api.createIssueRelation({
+        issueId: subIssue1Id!,
+        relatedIssueId: subIssue2Id!,
+        type: "blocks",
+      });
+
+      expect(result.id).toBeTruthy();
+      recorded.createRelation = result;
+      console.log(`Created blocks relation: ${subIssue1Identifier} blocks ${subIssue2Identifier}`);
+    });
+
+    it("sub-issue 1 shows blocks relation to sub-issue 2", async () => {
+      expect(subIssue1Id).toBeTruthy();
+      const details = await api.getIssueDetails(subIssue1Id!);
+      const blocksRels = details.relations.nodes.filter(
+        (r) => r.type === "blocks",
+      );
+
+      expect(blocksRels.length).toBeGreaterThan(0);
+      expect(
+        blocksRels.some((r) => r.relatedIssue.id === subIssue2Id),
+      ).toBe(true);
+      recorded.subIssue1WithRelation = details;
+      console.log(`Sub-issue 1 blocks: ${blocksRels.map((r) => r.relatedIssue.identifier).join(", ")}`);
+    });
+
+    it("sub-issue 2 shows inverse relation", async () => {
+      expect(subIssue2Id).toBeTruthy();
+      const details = await api.getIssueDetails(subIssue2Id!);
+
+      // Linear may or may not populate an inverse "is_blocked_by" relation.
+      // Record whatever we get — the mock test replays it as-is.
+      recorded.subIssue2WithRelation = details;
+      const rels = details.relations.nodes;
+      console.log(
+        `Sub-issue 2 relations: ${rels.length > 0 ? rels.map((r) => `${r.type} ${r.relatedIssue.identifier}`).join(", ") : "(none — inverse may not be returned)"}`,
+      );
+    });
+
+    it("saves recorded API responses to fixture file", () => {
+      // Only write if we actually ran the full flow
+      if (!parentIssueId || !subIssue1Id || !subIssue2Id) {
+        console.log("Skipping fixture write — not all issues were created.");
+        return;
+      }
+
+      const fixturePath = join(
+        __dirname,
+        "fixtures",
+        "recorded-sub-issue-flow.ts",
+      );
+      const content =
+        `/**\n` +
+        ` * Recorded API responses from sub-issue decomposition smoke test.\n` +
+        ` * Auto-generated — do not edit manually.\n` +
+        ` * Re-generate by running: npx vitest run src/__test__/smoke-linear-api.test.ts\n` +
+        ` * Last recorded: ${new Date().toISOString()}\n` +
+        ` */\n\n` +
+        `export const RECORDED = ${JSON.stringify(recorded, null, 2)};\n`;
+
+      writeFileSync(fixturePath, content, "utf8");
+      console.log(`Recorded fixture written to: ${fixturePath}`);
+    });
+
+    it("cleans up: cancels parent and sub-issues", async () => {
+      const canceledState = teamStates?.find(
+        (s) => s.type === "canceled" || s.name.toLowerCase().includes("cancel"),
+      );
+
+      for (const id of [subIssue1Id, subIssue2Id, parentIssueId]) {
+        if (!id || !canceledState) continue;
+        try {
+          await api.updateIssue(id, { stateId: canceledState.id });
+        } catch {
+          // Best effort
+        }
+      }
+    });
+  });
+
   describe("cleanup", () => {
     it("cancels the smoke test issue", async () => {
       if (!smokeIssueId) return;

package/src/__test__/webhook-scenarios.test.ts

@@ -152,6 +152,11 @@ vi.mock("../pipeline/dag-dispatch.js", () => ({
   startProjectDispatch: vi.fn().mockResolvedValue(undefined),
 }));
 
+vi.mock("../infra/shared-profiles.js", async (importOriginal) => {
+  const actual = await importOriginal() as Record<string, unknown>;
+  return { ...actual, validateProfiles: vi.fn().mockReturnValue(null) };
+});
+
 // ── Imports (after mocks) ────────────────────────────────────────
 
 import { handleLinearWebhook, _resetForTesting } from "../pipeline/webhook.js";