compass-agent 2.0.7 → 2.0.9

package/.env.example

@@ -0,0 +1,3 @@
+SLACK_APP_TOKEN=xapp-1-...
+SLACK_BOT_TOKEN=xoxb-...
+ALLOWED_USERS=

package/.github/workflows/publish.yml

@@ -3,8 +3,7 @@ name: Publish to npm
 on:
   release:
     types: [published]
-  push:
-    branches: [main]
+  workflow_dispatch:
 
 jobs:
   publish:

package/README.md

@@ -6,7 +6,7 @@
 
 Bring workforce of Claude Codes to your Slack workspace. Every thread becomes an isolated coding session — with its own working directory, git worktree, and full access to your local filesystem. Claude runs on your machine, streams responses in real-time, and your whole team can use it simultaneously without conflicts.
 
-![Agentic task visualization with sub-agents](assets/sub-agent.png)
+![Agentic task visualization with sub-agents](docs/assets/sub-agent.png)
 
 ## Quick start
 
@@ -45,7 +45,7 @@ Set the working directory for Claude to read/write files.
 
 The picker remembers previously used directories. CWD is stored per-thread in SQLite.
 
-![Working directory set in channel](assets/streaming-feedback.png)
+![Working directory set in channel](docs/assets/streaming-feedback.png)
 
 ### `$teach` — Team knowledge base
 
@@ -77,7 +77,7 @@ Responses stream token-by-token using Slack's native `chatStream` API, with auto
 
 Tool calls are visualized as an agentic timeline — each invocation (file reads, edits, shell commands) appears as a step that progresses from in-progress to complete.
 
-![Streaming response with planning and sub-agents](assets/planning-streaming.png)
+![Streaming response with planning and sub-agents](docs/assets/planning-streaming.png)
 
 ### Git worktree isolation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compass-agent",
-  "version": "2.0.7",
+  "version": "2.0.9",
   "type": "module",
   "description": "Bring Claude Code to your Slack workspace — per-thread AI coding sessions with full local filesystem access",
   "bin": {

package/src/app.ts

@@ -33,6 +33,26 @@ if (envFileIdx !== -1 && process.argv[envFileIdx + 1]) {
 Object.assign(process.env, realEnv);
 // -----------------------------------------------------------------------------------------
 
+// --- Required env validation ---
+const requiredEnv = ["SLACK_BOT_TOKEN", "SLACK_APP_TOKEN"] as const;
+const missing = requiredEnv.filter((k) => !process.env[k]);
+if (missing.length > 0) {
+  console.error(`ERROR: Missing required environment variable(s): ${missing.join(", ")}`);
+  process.exit(1);
+}
+
+// Validate CLAUDE_PATH exists
+const claudePath = process.env.CLAUDE_PATH || "claude";
+if (path.isAbsolute(claudePath)) {
+  if (!fs.existsSync(claudePath)) {
+    console.error(`ERROR: CLAUDE_PATH not found: ${claudePath}`);
+    process.exit(1);
+  }
+} else if (!Bun.which(claudePath)) {
+  console.error(`ERROR: CLAUDE_PATH "${claudePath}" not found in PATH. Set CLAUDE_PATH in .env to the full path of the claude binary.`);
+  process.exit(1);
+}
+
 import { App } from "@slack/bolt";
 import { execFileSync } from "child_process";
 import {
@@ -219,8 +239,6 @@ app.command("/cwd", async ({ command, ack, client }: any) => {
   });
 });
 
-const CLAUDE_PATH = process.env.CLAUDE_PATH || "claude";
-
 // ── Modal submissions ───────────────────────────────────────
 
 app.view("cwd_modal", async ({ view, ack, client }: any) => {
@@ -647,25 +665,17 @@ async function processMessage({ channelId, threadTs, messageTs, userText, userId
 // ── Startup ─────────────────────────────────────────────────
 
 (async () => {
-  // Validate CLAUDE_PATH exists before starting
-  const claudePath = process.env.CLAUDE_PATH || "claude";
-  // Check if it's an absolute path that exists, or resolve via Bun.which
-  if (path.isAbsolute(claudePath)) {
-    if (!fs.existsSync(claudePath)) {
-      console.error(`ERROR: CLAUDE_PATH not found: ${claudePath}`);
-      process.exit(1);
-    }
-  } else if (!Bun.which(claudePath)) {
-    console.error(`ERROR: CLAUDE_PATH "${claudePath}" not found in PATH. Set CLAUDE_PATH in .env to the full path of the claude binary.`);
-    process.exit(1);
-  }
   log(null, `Claude CLI found: ${claudePath}`);
 
-  // Register MCP server (idempotent — overwrites if already exists)
+  // Register MCP server (remove first to ensure it points to latest)
   try {
     const mcpServerPath = path.join(import.meta.dir, "mcp", "server.ts");
     const mcpEnv: Record<string, string | undefined> = { ...process.env };
     delete mcpEnv.CLAUDECODE; // avoid nested-session check
+    const execOpts = { encoding: "utf-8" as const, timeout: 10000, env: mcpEnv as NodeJS.ProcessEnv, stdio: ["pipe", "pipe", "pipe"] as const };
+    try {
+      execFileSync(claudePath, ["mcp", "remove", "--scope", "user", "compass"], execOpts);
+    } catch {}
     execFileSync(claudePath, [
       "mcp", "add",
       "--transport", "stdio",
@@ -673,7 +683,7 @@ async function processMessage({ channelId, threadTs, messageTs, userText, userId
       "compass",
       "--",
       "bun", mcpServerPath,
-    ], { encoding: "utf-8", timeout: 10000, env: mcpEnv as NodeJS.ProcessEnv, stdio: ["pipe", "pipe", "pipe"] });
+    ], execOpts);
     log(null, `MCP server registered: compass -> ${mcpServerPath}`);
   } catch (err: any) {
     logErr(null, `Failed to register MCP server (non-fatal): ${err.message}`);