@calltelemetry/openclaw-linear 0.9.3 → 0.9.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calltelemetry/openclaw-linear",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "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,172 @@
+/**
+ * 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)
+ */
+
+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 };
+      }>,
+    },
+  },
+  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 };
+      }>,
+    },
+  },
+  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 };
+      }>,
+    },
+  },
+  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",
+          },
+        },
+      ],
+    },
+  },
+  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 };
+      }>,
+    },
+  },
+};

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

@@ -10,13 +10,14 @@
  */
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
+import { homedir } from "node:os";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
 import { LinearAgentApi } from "../api/linear-api.js";
 
 // ── Setup ──────────────────────────────────────────────────────────
 
 const AUTH_PROFILES_PATH = join(
-  process.env.HOME ?? "/home/claw",
+  homedir(),
   ".openclaw",
   "auth-profiles.json",
 );

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

@@ -87,6 +87,9 @@ vi.mock("../pipeline/pipeline.js", () => ({
 vi.mock("../pipeline/active-session.js", () => ({
   setActiveSession: mockSetActiveSession,
   clearActiveSession: mockClearActiveSession,
+  getIssueAffinity: vi.fn().mockReturnValue(null),
+  _configureAffinityTtl: vi.fn(),
+  _resetAffinityForTesting: vi.fn(),
 }));
 
 vi.mock("../infra/observability.js", () => ({

package/src/agent/agent.ts

@@ -1,6 +1,8 @@
 import { randomUUID } from "node:crypto";
-import { join } from "node:path";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
 import { mkdirSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import type { LinearAgentApi, ActivityContent } from "../api/linear-api.js";
 import { InactivityWatchdog, resolveWatchdogConfig } from "./watchdog.js";
@@ -15,7 +17,7 @@ interface AgentDirs {
 }
 
 function resolveAgentDirs(agentId: string, config: Record<string, any>): AgentDirs {
-  const home = process.env.HOME ?? "/home/claw";
+  const home = homedir();
   const agentList = config?.agents?.list as Array<Record<string, any>> | undefined;
   const agentEntry = agentList?.find((a) => a.id === agentId);
 
@@ -33,13 +35,13 @@ function resolveAgentDirs(agentId: string, config: Record<string, any>): AgentDi
 }
 
 // Import extensionAPI for embedded agent runner (internal, not in public SDK)
-let _extensionAPI: typeof import("/home/claw/.npm-global/lib/node_modules/openclaw/dist/extensionAPI.js") | null = null;
+let _extensionAPI: any | null = null;
 async function getExtensionAPI() {
   if (!_extensionAPI) {
-    // Dynamic import to avoid blocking module load if unavailable
-    _extensionAPI = await import(
-      "/home/claw/.npm-global/lib/node_modules/openclaw/dist/extensionAPI.js"
-    );
+    // Resolve the openclaw package location dynamically, then import extensionAPI
+    const _require = createRequire(import.meta.url);
+    const openclawDir = dirname(_require.resolve("openclaw/package.json"));
+    _extensionAPI = await import(join(openclawDir, "dist", "extensionAPI.js"));
   }
   return _extensionAPI;
 }

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)
@@ -129,7 +130,7 @@ interface AgentProfileWatchdog {
   toolTimeoutSec?: number;
 }
 
-const PROFILES_PATH = join(process.env.HOME ?? "/home/claw", ".openclaw", "agent-profiles.json");
+const PROFILES_PATH = join(homedir(), ".openclaw", "agent-profiles.json");
 
 function loadProfileWatchdog(agentId: string): AgentProfileWatchdog | null {
   try {

package/src/api/linear-api.ts

@@ -1,11 +1,12 @@
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { homedir } from "node:os";
 import { refreshLinearToken } from "./auth.js";
 import { withResilience } from "../infra/resilience.js";
 
 export const LINEAR_GRAPHQL_URL = "https://api.linear.app/graphql";
 export const AUTH_PROFILES_PATH = join(
-  process.env.HOME ?? "/home/claw",
+  homedir(),
   ".openclaw",
   "auth-profiles.json",
 );

package/src/api/oauth-callback.ts

@@ -2,10 +2,11 @@ import type { IncomingMessage, ServerResponse } from "node:http";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { writeFileSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { homedir } from "node:os";
 
 const LINEAR_OAUTH_TOKEN_URL = "https://api.linear.app/oauth/token";
 const AUTH_PROFILES_PATH = join(
-  process.env.HOME ?? "/home/claw",
+  homedir(),
   ".openclaw",
   "auth-profiles.json",
 );

package/src/infra/cli.ts

@@ -846,8 +846,8 @@ async function reposAction(
     console.log(`\n  No "repos" configured in plugin config.`);
     console.log(`  Add a repos map to openclaw.json → plugins.entries.openclaw-linear.config:`);
     console.log(`\n    "repos": {`);
-    console.log(`      "api": "/home/claw/repos/api",`);
-    console.log(`      "frontend": "/home/claw/repos/frontend"`);
+    console.log(`      "api": "~/repos/api",`);
+    console.log(`      "frontend": "~/repos/frontend"`);
     console.log(`    }\n`);
     return;
   }

package/src/infra/codex-worktree.ts

@@ -5,7 +5,7 @@ import path from "node:path";
 import { ensureGitignore } from "../pipeline/artifacts.js";
 import type { RepoConfig } from "./multi-repo.js";
 
-const DEFAULT_BASE_REPO = "/home/claw/ai-workspace";
+const DEFAULT_BASE_REPO = path.join(homedir(), "ai-workspace");
 const DEFAULT_WORKTREE_BASE_DIR = path.join(homedir(), ".openclaw", "worktrees");
 
 export interface WorktreeInfo {
@@ -22,7 +22,7 @@ export interface WorktreeStatus {
 }
 
 export interface WorktreeOptions {
-  /** Base git repo to create worktrees from. Default: /home/claw/ai-workspace */
+  /** Base git repo to create worktrees from. Default: ~/ai-workspace */
   baseRepo?: string;
   /** Directory under which worktrees are created. Default: ~/.openclaw/worktrees */
   baseDir?: string;

package/src/infra/config-paths.test.ts

@@ -33,6 +33,9 @@ vi.mock("../api/linear-api.js", () => ({
 vi.mock("../pipeline/active-session.js", () => ({
   setActiveSession: vi.fn(),
   clearActiveSession: vi.fn(),
+  getIssueAffinity: vi.fn().mockReturnValue(null),
+  _configureAffinityTtl: vi.fn(),
+  _resetAffinityForTesting: vi.fn(),
 }));
 
 vi.mock("../infra/observability.js", () => ({