@calltelemetry/openclaw-linear 0.9.4 → 0.9.6

package/package.json

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

@@ -0,0 +1,254 @@
+/**
+ * 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-22T01:35:48.289Z
+ */
+
+export const RECORDED = {
+  "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": "e49ed5fb-8068-41a8-9f4d-6d9b55a0c2b6",
+    "identifier": "UAT-235"
+  },
+  "createSubIssue1": {
+    "id": "2796434d-9c1e-4ee9-af70-6e0e14fe6109",
+    "identifier": "UAT-236"
+  },
+  "createSubIssue2": {
+    "id": "d1b939d0-33f1-4f6d-992a-95f2a3cb842a",
+    "identifier": "UAT-237"
+  },
+  "subIssue1Details": {
+    "id": "2796434d-9c1e-4ee9-af70-6e0e14fe6109",
+    "identifier": "UAT-236",
+    "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": "e49ed5fb-8068-41a8-9f4d-6d9b55a0c2b6",
+      "identifier": "UAT-235"
+    },
+    "relations": {
+      "nodes": []
+    }
+  },
+  "subIssue2Details": {
+    "id": "d1b939d0-33f1-4f6d-992a-95f2a3cb842a",
+    "identifier": "UAT-237",
+    "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": "e49ed5fb-8068-41a8-9f4d-6d9b55a0c2b6",
+      "identifier": "UAT-235"
+    },
+    "relations": {
+      "nodes": []
+    }
+  },
+  "parentDetails": {
+    "id": "e49ed5fb-8068-41a8-9f4d-6d9b55a0c2b6",
+    "identifier": "UAT-235",
+    "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-22T01:35:46.183Z",
+    "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": [
+        {
+          "body": "This thread is for an agent session with ctclaw.",
+          "user": null,
+          "createdAt": "2026-02-22T01:35:47.210Z"
+        }
+      ]
+    },
+    "project": null,
+    "parent": null,
+    "relations": {
+      "nodes": []
+    }
+  },
+  "createRelation": {
+    "id": "f2b33a57-b79a-4dcc-b973-a5453676a78f"
+  },
+  "subIssue1WithRelation": {
+    "id": "2796434d-9c1e-4ee9-af70-6e0e14fe6109",
+    "identifier": "UAT-236",
+    "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": [
+        {
+          "body": "This thread is for an agent session with ctclaw.",
+          "user": null,
+          "createdAt": "2026-02-22T01:35:47.302Z"
+        }
+      ]
+    },
+    "project": null,
+    "parent": {
+      "id": "e49ed5fb-8068-41a8-9f4d-6d9b55a0c2b6",
+      "identifier": "UAT-235"
+    },
+    "relations": {
+      "nodes": [
+        {
+          "type": "blocks",
+          "relatedIssue": {
+            "id": "d1b939d0-33f1-4f6d-992a-95f2a3cb842a",
+            "identifier": "UAT-237",
+            "title": "[SMOKE TEST] Sub-Issue 2: Frontend UI"
+          }
+        }
+      ]
+    }
+  },
+  "subIssue2WithRelation": {
+    "id": "d1b939d0-33f1-4f6d-992a-95f2a3cb842a",
+    "identifier": "UAT-237",
+    "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": "e49ed5fb-8068-41a8-9f4d-6d9b55a0c2b6",
+      "identifier": "UAT-235"
+    },
+    "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(
@@ -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/agent/watchdog.ts

@@ -7,6 +7,7 @@
  */
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
+import { homedir } from "node:os";
 
 // ---------------------------------------------------------------------------
 // Defaults (seconds — matches config units)