@calltelemetry/openclaw-linear 0.9.12 → 0.9.15

package/index.ts

@@ -229,6 +229,56 @@ export default function register(api: OpenClawPluginApi) {
     }
   });
 
+  // Hard gate: prepend planning-only constraints to code_run when issue is not "started".
+  // Even if the orchestrator LLM ignores scope rules, the coding agent receives hard constraints.
+  api.on("before_tool_call", async (event: any, _ctx: any) => {
+    if (event.toolName !== "code_run") return;
+
+    const { getCurrentSession } = await import("./src/pipeline/active-session.js");
+    const session = getCurrentSession();
+    if (!session?.issueId) return; // Non-Linear context, allow
+
+    // Check issue state
+    const hookTokenInfo = resolveLinearToken(pluginConfig);
+    if (!hookTokenInfo.accessToken) return;
+    const hookLinearApi = new LinearAgentApi(hookTokenInfo.accessToken, {
+      refreshToken: hookTokenInfo.refreshToken,
+      expiresAt: hookTokenInfo.expiresAt,
+    });
+
+    try {
+      const issue = await hookLinearApi.getIssueDetails(session.issueId);
+      const stateType = issue?.state?.type ?? "";
+      const isStarted = stateType === "started";
+
+      if (!isStarted) {
+        const constraint = [
+          "CRITICAL CONSTRAINT — PLANNING MODE ONLY:",
+          `This issue (${session.issueIdentifier}) is in "${issue?.state?.name ?? stateType}" state — NOT In Progress.`,
+          "You may ONLY:",
+          "- Read and explore files to understand the codebase",
+          "- Write plan files (PLAN.md, notes, design outlines)",
+          "- Search code to inform planning",
+          "You MUST NOT:",
+          "- Create, modify, or delete source code, config, or infrastructure files",
+          "- Run system commands that change state (deploys, installs, migrations)",
+          "- Make external API requests that modify data",
+          "- Build, implement, or scaffold any application code",
+          "Plan and explore ONLY. Do not implement anything.",
+          "---",
+        ].join("\n");
+
+        const originalPrompt = event.params?.prompt ?? "";
+        return {
+          params: { ...event.params, prompt: `${constraint}\n${originalPrompt}` },
+        };
+      }
+    } catch (err) {
+      api.logger.warn(`before_tool_call: issue state check failed: ${err}`);
+      // Don't block on failure — fall through to allow
+    }
+  });
+
   // Narration Guard: catch short "Let me explore..." responses that narrate intent
   // without actually calling tools, and append a warning for the user.
   const NARRATION_PATTERNS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calltelemetry/openclaw-linear",
-  "version": "0.9.12",
+  "version": "0.9.15",
   "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-22T03:20:08.396Z
+ * Last recorded: 2026-02-22T03:40:54.418Z
  */
 
 export const RECORDED = {
@@ -44,20 +44,20 @@ export const RECORDED = {
     }
   ],
   "createParent": {
-    "id": "2becfd65-c313-4d4b-9362-b3ac431872c6",
-    "identifier": "UAT-354"
+    "id": "933fa3c0-981a-4d9e-8b2c-7c5c4d5b4349",
+    "identifier": "UAT-438"
   },
   "createSubIssue1": {
-    "id": "b7433275-83a2-4e6e-a98c-5fe2b3aa1147",
-    "identifier": "UAT-355"
+    "id": "4caa7593-5a51-4795-b98c-29e532589dfe",
+    "identifier": "UAT-439"
   },
   "createSubIssue2": {
-    "id": "3526cea7-2261-4eee-bd8a-5206e12c6124",
-    "identifier": "UAT-356"
+    "id": "0519065b-95eb-4752-966b-2099bbc5f3d1",
+    "identifier": "UAT-440"
   },
   "subIssue1Details": {
-    "id": "b7433275-83a2-4e6e-a98c-5fe2b3aa1147",
-    "identifier": "UAT-355",
+    "id": "4caa7593-5a51-4795-b98c-29e532589dfe",
+    "identifier": "UAT-439",
     "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": "2becfd65-c313-4d4b-9362-b3ac431872c6",
-      "identifier": "UAT-354"
+      "id": "933fa3c0-981a-4d9e-8b2c-7c5c4d5b4349",
+      "identifier": "UAT-438"
     },
     "relations": {
       "nodes": []
     }
   },
   "subIssue2Details": {
-    "id": "3526cea7-2261-4eee-bd8a-5206e12c6124",
-    "identifier": "UAT-356",
+    "id": "0519065b-95eb-4752-966b-2099bbc5f3d1",
+    "identifier": "UAT-440",
     "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,
@@ -118,18 +118,18 @@ export const RECORDED = {
     },
     "project": null,
     "parent": {
-      "id": "2becfd65-c313-4d4b-9362-b3ac431872c6",
-      "identifier": "UAT-354"
+      "id": "933fa3c0-981a-4d9e-8b2c-7c5c4d5b4349",
+      "identifier": "UAT-438"
     },
     "relations": {
       "nodes": []
     }
   },
   "parentDetails": {
-    "id": "2becfd65-c313-4d4b-9362-b3ac431872c6",
-    "identifier": "UAT-354",
+    "id": "933fa3c0-981a-4d9e-8b2c-7c5c4d5b4349",
+    "identifier": "UAT-438",
     "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-22T03:20:04.703Z",
+    "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-22T03:40:52.229Z",
     "estimate": null,
     "state": {
       "name": "Backlog",
@@ -149,7 +149,13 @@ export const RECORDED = {
       "issueEstimationType": "tShirt"
     },
     "comments": {
-      "nodes": []
+      "nodes": [
+        {
+          "body": "This thread is for an agent session with ctclaw.",
+          "user": null,
+          "createdAt": "2026-02-22T03:40:53.165Z"
+        }
+      ]
     },
     "project": null,
     "parent": null,
@@ -158,11 +164,11 @@ export const RECORDED = {
     }
   },
   "createRelation": {
-    "id": "a9cac881-3d13-45ab-b000-855777698d71"
+    "id": "185dfd6c-362e-48a4-b717-e900407ced84"
   },
   "subIssue1WithRelation": {
-    "id": "b7433275-83a2-4e6e-a98c-5fe2b3aa1147",
-    "identifier": "UAT-355",
+    "id": "4caa7593-5a51-4795-b98c-29e532589dfe",
+    "identifier": "UAT-439",
     "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,
@@ -188,22 +194,22 @@ export const RECORDED = {
         {
           "body": "This thread is for an agent session with ctclaw.",
           "user": null,
-          "createdAt": "2026-02-22T03:20:06.930Z"
+          "createdAt": "2026-02-22T03:40:53.603Z"
         }
       ]
     },
     "project": null,
     "parent": {
-      "id": "2becfd65-c313-4d4b-9362-b3ac431872c6",
-      "identifier": "UAT-354"
+      "id": "933fa3c0-981a-4d9e-8b2c-7c5c4d5b4349",
+      "identifier": "UAT-438"
     },
     "relations": {
       "nodes": [
         {
           "type": "blocks",
           "relatedIssue": {
-            "id": "3526cea7-2261-4eee-bd8a-5206e12c6124",
-            "identifier": "UAT-356",
+            "id": "0519065b-95eb-4752-966b-2099bbc5f3d1",
+            "identifier": "UAT-440",
             "title": "[SMOKE TEST] Sub-Issue 2: Frontend UI"
           }
         }
@@ -211,8 +217,8 @@ export const RECORDED = {
     }
   },
   "subIssue2WithRelation": {
-    "id": "3526cea7-2261-4eee-bd8a-5206e12c6124",
-    "identifier": "UAT-356",
+    "id": "0519065b-95eb-4752-966b-2099bbc5f3d1",
+    "identifier": "UAT-440",
     "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,
@@ -238,14 +244,14 @@ export const RECORDED = {
         {
           "body": "This thread is for an agent session with ctclaw.",
           "user": null,
-          "createdAt": "2026-02-22T03:20:06.960Z"
+          "createdAt": "2026-02-22T03:40:53.840Z"
         }
       ]
     },
     "project": null,
     "parent": {
-      "id": "2becfd65-c313-4d4b-9362-b3ac431872c6",
-      "identifier": "UAT-354"
+      "id": "933fa3c0-981a-4d9e-8b2c-7c5c4d5b4349",
+      "identifier": "UAT-438"
     },
     "relations": {
       "nodes": []

package/src/agent/agent.ts

@@ -323,7 +323,7 @@ async function runEmbedded(
       }
     },
 
-    // Raw agent events — capture tool starts/ends
+    // Raw agent events — capture tool starts/ends/updates
     onAgentEvent: (evt) => {
       watchdog.tick();
       const { stream, data } = evt;
@@ -333,16 +333,30 @@ async function runEmbedded(
       const phase = String(data.phase ?? "");
       const toolName = String(data.name ?? "tool");
       const meta = typeof data.meta === "string" ? data.meta : "";
+      const input = typeof data.input === "string" ? data.input : "";
 
-      // Tool execution start — emit action with tool name + meta
+      // Tool execution start — emit action with tool name + available context
       if (phase === "start") {
         lastToolAction = toolName;
-        emit({ type: "action", action: `Running ${toolName}`, parameter: meta.slice(0, 200) || toolName });
+        const detail = input || meta || toolName;
+        emit({ type: "action", action: `Running ${toolName}`, parameter: detail.slice(0, 300) });
+      }
+
+      // Tool execution update — partial progress (keeps Linear UI alive for long tools)
+      if (phase === "update") {
+        const detail = meta || input || "in progress";
+        emit({ type: "action", action: `${toolName}`, parameter: detail.slice(0, 300) });
+      }
+
+      // Tool execution completed successfully
+      if (phase === "result" && !data.isError) {
+        const detail = meta ? meta.slice(0, 300) : "completed";
+        emit({ type: "action", action: `${toolName} done`, parameter: detail });
       }
 
       // Tool execution result with error
       if (phase === "result" && data.isError) {
-        emit({ type: "action", action: `${toolName} failed`, parameter: meta.slice(0, 200) || "error" });
+        emit({ type: "action", action: `${toolName} failed`, parameter: (meta || "error").slice(0, 300) });
       }
     },