feat: Linear webhook integration for auto-triggering workflows

.env.example

@@ -151,6 +151,15 @@ GITEA_ALLOWED_USERS=
 # If not set, falls back to BOT_DISPLAY_NAME then config.botName
 # GITEA_BOT_MENTION=archon
 
+# ============================================
+# Linear (PM Adapter)
+# ============================================
+# Triggers workflows when Linear issues assigned to the configured user
+# transition to "In Progress". Configure team→codebase mappings in
+# ~/.archon/config.yaml under linear.mappings.
+# LINEAR_API_KEY=lin_api_...
+# LINEAR_WEBHOOK_SECRET=
+
 # Server
 # PORT=3090  # Default: 3090. Uncomment to override — must match between server and Vite proxy.
 # HOST=0.0.0.0  # Bind address (default: 0.0.0.0). Set to 127.0.0.1 to restrict to localhost only.

Dockerfile

@@ -74,6 +74,8 @@ RUN apt-get update && apt-get install -y \
     postgresql-client \
     # Chromium for agent-browser E2E testing (drives browser via CDP)
     chromium \
+    # jq for bash-node scripts that parse JSON artifacts
+    jq \
     && rm -rf /var/lib/apt/lists/*
 
 # Install GitHub CLI

packages/adapters/package.json

@@ -7,18 +7,20 @@
   "exports": {
     ".": "./src/index.ts",
     "./*": "./src/*",
+    "./pm/linear": "./src/pm/linear/index.ts",
     "./community/forge/gitea": "./src/community/forge/gitea/index.ts",
     "./community/forge/gitlab": "./src/community/forge/gitlab/index.ts"
   },
   "scripts": {
-    "test": "bun test src/chat/ src/community/chat/ src/community/forge/gitlab/auth.test.ts src/forge/github/auth.test.ts src/utils/ && bun test src/forge/github/adapter.test.ts && bun test src/forge/github/context.test.ts && bun test src/community/forge/gitea/adapter.test.ts && bun test src/community/forge/gitlab/adapter.test.ts",
+    "test": "bun test src/chat/ src/community/chat/ src/community/forge/gitlab/auth.test.ts src/forge/github/auth.test.ts src/utils/ && bun test src/forge/github/adapter.test.ts && bun test src/forge/github/context.test.ts && bun test src/community/forge/gitea/adapter.test.ts && bun test src/community/forge/gitlab/adapter.test.ts && bun test src/pm/linear/adapter.test.ts",
     "type-check": "bun x tsc --noEmit"
   },
   "dependencies": {
     "@archon/core": "workspace:*",
     "@archon/git": "workspace:*",
     "@archon/isolation": "workspace:*",
     "@archon/paths": "workspace:*",
+    "@linear/sdk": "^34.0.0",
     "@octokit/rest": "^22.0.0",
     "@slack/bolt": "^4.6.0",
     "discord.js": "^14.16.0",

packages/adapters/src/index.ts

@@ -5,5 +5,8 @@ export { SlackAdapter } from './chat/slack';
 // Forge adapters
 export { GitHubAdapter } from './forge/github';
 
+// PM adapters
+export { LinearAdapter } from './pm/linear';
+
 // Community adapters
 export { DiscordAdapter } from './community/chat/discord';