patchwork-os 0.2.0-alpha.2 → 0.2.0-alpha.21

package/dist/tools/slackPostMessage.d.ts

@@ -0,0 +1,57 @@
+export declare function createSlackPostMessageTool(): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                channel: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+                text: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+                threadTs: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                ts: {
+                    type: string;
+                };
+                channel: {
+                    type: string;
+                };
+                slackConnected: {
+                    type: string;
+                };
+                error: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/slackPostMessage.js

@@ -0,0 +1,77 @@
+import { loadTokens, postMessage } from "../connectors/slack.js";
+import { optionalString, requireString, successStructured } from "./utils.js";
+export function createSlackPostMessageTool() {
+    return {
+        schema: {
+            name: "slackPostMessage",
+            description: "Post a message to a Slack channel. Use channel name (e.g. 'general') or channel ID. " +
+                "Optionally reply in a thread by providing threadTs.",
+            annotations: { readOnlyHint: false },
+            inputSchema: {
+                type: "object",
+                required: ["channel", "text"],
+                properties: {
+                    channel: {
+                        type: "string",
+                        description: "Channel name (e.g. 'general') or channel ID (e.g. 'C12345').",
+                        maxLength: 200,
+                    },
+                    text: {
+                        type: "string",
+                        description: "Message text (Markdown supported via mrkdwn).",
+                        maxLength: 40000,
+                    },
+                    threadTs: {
+                        type: "string",
+                        description: "Thread timestamp to reply in. Omit to post as a new message.",
+                        maxLength: 50,
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    ts: { type: "string" },
+                    channel: { type: "string" },
+                    slackConnected: { type: "boolean" },
+                    error: { type: "string" },
+                },
+                required: ["slackConnected"],
+            },
+        },
+        timeoutMs: 15_000,
+        async handler(args, signal) {
+            const tokens = loadTokens();
+            if (!tokens) {
+                return successStructured({
+                    ts: "",
+                    channel: "",
+                    slackConnected: false,
+                    error: "Slack not connected. GET /connections/slack/authorize first.",
+                });
+            }
+            const channel = requireString(args, "channel", 200);
+            const text = requireString(args, "text", 40000);
+            const threadTs = optionalString(args, "threadTs", 50);
+            try {
+                const result = await postMessage(channel, text, threadTs ?? undefined, signal);
+                return successStructured({
+                    ts: result.ts,
+                    channel: result.channel,
+                    slackConnected: true,
+                });
+            }
+            catch (err) {
+                const notConnected = err instanceof Error && err.message.includes("not connected");
+                return successStructured({
+                    ts: "",
+                    channel: "",
+                    slackConnected: !notConnected,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=slackPostMessage.js.map

package/dist/tools/slackPostMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slackPostMessage.js","sourceRoot":"","sources":["../../src/tools/slackPostMessage.ts"],"names":[],"mappings":"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"}

package/dist/tools/updateLinearIssue.d.ts

@@ -0,0 +1,89 @@
+export declare function createUpdateLinearIssueTool(): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                id: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+                title: {
+                    type: string;
+                    maxLength: number;
+                };
+                description: {
+                    type: string;
+                    maxLength: number;
+                };
+                priority: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                state: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+                assignee: {
+                    type: string;
+                    description: string;
+                    maxLength: number;
+                };
+                labelNames: {
+                    type: string;
+                    description: string;
+                    items: {
+                        type: string;
+                        maxLength: number;
+                    };
+                    maxItems: number;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: string;
+                };
+                identifier: {
+                    type: string;
+                };
+                title: {
+                    type: string;
+                };
+                url: {
+                    type: string;
+                };
+                state: {
+                    type: string;
+                };
+                linearConnected: {
+                    type: string;
+                };
+                error: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/updateLinearIssue.js

@@ -0,0 +1,117 @@
+import { loadTokens, updateIssue } from "../connectors/linear.js";
+import { requireString, successStructured } from "./utils.js";
+export function createUpdateLinearIssueTool() {
+    return {
+        schema: {
+            name: "updateLinearIssue",
+            description: "Update an existing Linear issue. Pass only the fields you want to change. Requires Linear connector connected.",
+            annotations: { readOnlyHint: false },
+            inputSchema: {
+                type: "object",
+                required: ["id"],
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "Issue identifier (e.g. 'ENG-42') or URL.",
+                        maxLength: 200,
+                    },
+                    title: { type: "string", maxLength: 500 },
+                    description: { type: "string", maxLength: 10000 },
+                    priority: {
+                        type: "integer",
+                        description: "0=no priority, 1=urgent, 2=high, 3=medium, 4=low.",
+                        minimum: 0,
+                        maximum: 4,
+                    },
+                    state: {
+                        type: "string",
+                        description: "Workflow state name (e.g. 'In Progress', 'Done').",
+                        maxLength: 100,
+                    },
+                    assignee: {
+                        type: "string",
+                        description: "Assignee name or email.",
+                        maxLength: 200,
+                    },
+                    labelNames: {
+                        type: "array",
+                        description: "Label names to set (replaces existing labels).",
+                        items: { type: "string", maxLength: 100 },
+                        maxItems: 10,
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    id: { type: "string" },
+                    identifier: { type: "string" },
+                    title: { type: "string" },
+                    url: { type: "string" },
+                    state: { type: "string" },
+                    linearConnected: { type: "boolean" },
+                    error: { type: "string" },
+                },
+                required: ["id", "identifier", "title", "url", "linearConnected"],
+            },
+        },
+        timeoutMs: 20_000,
+        async handler(args, signal) {
+            const tokens = loadTokens();
+            if (!tokens) {
+                return successStructured({
+                    id: "",
+                    identifier: "",
+                    title: "",
+                    url: "",
+                    linearConnected: false,
+                    error: "Linear not connected. GET /connections/linear/authorize first.",
+                });
+            }
+            const id = requireString(args, "id", 200);
+            const labelNames = Array.isArray(args.labelNames)
+                ? args.labelNames
+                    .filter((l) => typeof l === "string")
+                    .map(String)
+                : undefined;
+            try {
+                const issue = await updateIssue({
+                    id,
+                    ...(typeof args.title === "string" && { title: args.title }),
+                    ...(typeof args.description === "string" && {
+                        description: args.description,
+                    }),
+                    ...(typeof args.priority === "number" && {
+                        priority: args.priority,
+                    }),
+                    ...(typeof args.state === "string" && { state: args.state }),
+                    ...(typeof args.assignee === "string" && {
+                        assignee: args.assignee,
+                    }),
+                    ...(labelNames && labelNames.length > 0 && { labels: labelNames }),
+                }, signal);
+                return successStructured({
+                    id: issue.id,
+                    identifier: issue.identifier,
+                    title: issue.title,
+                    url: issue.url,
+                    state: issue.state?.name ?? "",
+                    linearConnected: true,
+                });
+            }
+            catch (err) {
+                const notConnected = err instanceof Error && err.message.includes("not connected");
+                return successStructured({
+                    id: "",
+                    identifier: "",
+                    title: "",
+                    url: "",
+                    linearConnected: !notConnected,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=updateLinearIssue.js.map

package/dist/tools/updateLinearIssue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateLinearIssue.js","sourceRoot":"","sources":["../../src/tools/updateLinearIssue.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "patchwork-os",
-  "version": "0.2.0-alpha.2",
-  "description": "Patchwork OS \u2014 proactive, multi-model AI teammate built on the Claude IDE Bridge. One agent, any model, works while you're away.",
+  "version": "0.2.0-alpha.21",
+  "description": "Patchwork OS — proactive, multi-model AI teammate built on the Claude IDE Bridge. One agent, any model, works while you're away.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -95,12 +95,14 @@
     "@opentelemetry/semantic-conventions": "^1.40.0",
     "ajv": "^8.18.0",
     "minimatch": "^10.0.0",
+    "node-cron": "^3.0.3",
     "ws": "^8.18.0",
     "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.10",
     "@types/node": "^22.0.0",
+    "@types/node-cron": "^3.0.11",
     "@types/ws": "^8.5.0",
     "@vitest/coverage-v8": "^3.0.0",
     "@vscode/ripgrep": "^1.17.1",

package/scripts/start-all.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
-# Full orchestrator for bridge + claude + remote-control.
-# Manages all three in tmux panes with health monitoring.
+# Full orchestrator for bridge + claude + remote-control + dashboard.
+# Manages all processes in tmux panes with health monitoring.
 #
 # Pane layout:
 #   0 — health monitor (orchestrator)
@@ -8,7 +8,8 @@
 #   2 — claude --ide (Claude Code CLI, connects to bridge for IDE tools)
 #   3 — claude remote-control --spawn=session (exposes the workspace to claude.ai;
 #         spawned sessions auto-discover the bridge via ~/.claude/ide/*.lock)
-#   4 — SSH reverse tunnel to VPS (optional, enabled with --vps <user@host:port>)
+#   4 — Patchwork dashboard (Next.js, http://localhost:3200)
+#   5 — SSH reverse tunnel to VPS (optional, enabled with --vps <user@host:port>)
 #         Forwards VPS_PORT on the remote host back to the local bridge port.
 #         Allows claude.ai integrations to use a static VPS URL instead of a
 #         rotating remote-control session URL.
@@ -20,6 +21,8 @@
 # Options:
 #   --workspace <path>    Directory to open in Claude (default: current directory)
 #   --full                Register all ~95 bridge tools (git, terminal, file ops, HTTP, GitHub).
+#   --no-dashboard        Skip starting the Patchwork dashboard (pane 4).
+#   --dashboard-port <N>  Dashboard port (default: 3200).
 #                         Default is slim mode (27 IDE-exclusive tools). Add --full if your
 #                         workflow requires git/terminal/file tools.
 #   --notify <topic>      Push notifications via ntfy.sh when remote-control connects or
@@ -48,6 +51,8 @@ NTFY_TOPIC=""
 IDE_NAME=""
 VPS=""
 FULL_MODE=""
+NO_DASHBOARD=""
+DASHBOARD_PORT="3200"
 AUTOMATION_POLICY=""
 CLAUDE_DRIVER="subprocess"
 BRIDGE_READY_TIMEOUT="${BRIDGE_READY_TIMEOUT:-30}"
@@ -64,6 +69,8 @@ while [[ $# -gt 0 ]]; do
     --ide)               IDE_NAME="$2"; shift 2 ;;
     --vps)               VPS="$2"; shift 2 ;;
     --full)              FULL_MODE="--full"; shift ;;
+    --no-dashboard)      NO_DASHBOARD=1; shift ;;
+    --dashboard-port)    DASHBOARD_PORT="$2"; shift 2 ;;
     --automation-policy) AUTOMATION_POLICY="$2"; shift 2 ;;
     --claude-driver)     CLAUDE_DRIVER="$2"; shift 2 ;;
     *)                   echo "Unknown option: $1" >&2; exit 1 ;;
@@ -90,23 +97,31 @@ fi
 
 # --- Bridge conflict check ---
 # Detect an already-running bridge instance and abort early with a clear message.
-# Iterates lock files safely (no xargs injection); filters to isBridge:true + live PID.
+# Validates: isBridge:true + live PID + process is actually a bridge (not Windsurf reusing PID)
+# by checking whether the lock file's port has an active listener.
 while IFS= read -r lock; do
   [[ -f "$lock" ]] || continue
-  bridge_pid=$(python3 -c "
+  lock_info=$(python3 -c "
 import json, sys
 try:
     d = json.load(open(sys.argv[1]))
     if d.get('isBridge') is True:
-        print(d.get('pid', ''))
+        print(d.get('pid', ''), d.get('port', ''))
 except Exception:
     pass
 " "$lock" 2>/dev/null || true)
+  bridge_pid="${lock_info%% *}"
+  bridge_port="${lock_info##* }"
   if [[ -n "$bridge_pid" ]] && kill -0 "$bridge_pid" 2>/dev/null; then
-    echo "Error: bridge already running (PID $bridge_pid, lock: $(basename "$lock"))." >&2
-    echo "       Stop it first: kill $bridge_pid" >&2
-    echo "       Or kill the tmux session: tmux kill-session -t claude-all" >&2
-    exit 1
+    # Cross-check: verify a process is actually listening on the lock's port.
+    # Windsurf may reuse PIDs from stale locks — if nothing listens on that port,
+    # the bridge is not actually running.
+    if [[ -n "$bridge_port" ]] && lsof -i ":${bridge_port}" 2>/dev/null | grep -q LISTEN; then
+      echo "Error: bridge already running (PID $bridge_pid, port $bridge_port, lock: $(basename "$lock"))." >&2
+      echo "       Stop it first: kill $bridge_pid" >&2
+      echo "       Or kill the tmux session: tmux kill-session -t claude-all" >&2
+      exit 1
+    fi
   fi
 done < <(ls ~/.claude/ide/*.lock 2>/dev/null)
 
@@ -141,6 +156,7 @@ echo "=== Claude IDE Bridge Full Orchestrator ==="
 echo "  Ctrl+C in any pane — stops that process"
 echo "  Ctrl+B then D (press Ctrl+B, release, then press D) — detach (keeps running)"
 echo "  tmux kill-session -t $SESSION — stop everything"
+[[ -z "$NO_DASHBOARD" ]] && echo "  Dashboard: http://localhost:${DASHBOARD_PORT}"
 [[ -n "$NTFY_TOPIC" ]] && echo "  Push notifications: ntfy.sh/$NTFY_TOPIC"
 if [[ -z "$FULL_MODE" ]]; then
   echo ""
@@ -276,11 +292,12 @@ while true; do
   sleep \$delay
 done'"
 
-# --- Create additional panes (pane 0 = orchestrator, 1 = bridge, 2 = claude, 3 = remote-control, 4 = ssh tunnel) ---
+# --- Create additional panes (pane 0 = orchestrator, 1 = bridge, 2 = claude, 3 = remote-control, 4 = dashboard, 5 = ssh tunnel) ---
 tmux split-window -v -t "$SESSION"    # pane 1 for bridge
 tmux split-window -v -t "$SESSION"    # pane 2 for claude --ide
 tmux split-window -v -t "$SESSION"    # pane 3 for claude remote-control
-[[ -n "$TUNNEL_CMD" ]] && tmux split-window -v -t "$SESSION"  # pane 4 for ssh tunnel (optional)
+[[ -z "$NO_DASHBOARD" ]] && tmux split-window -v -t "$SESSION"  # pane 4 for dashboard (optional)
+[[ -n "$TUNNEL_CMD" ]] && tmux split-window -v -t "$SESSION"    # pane 5 for ssh tunnel (optional)
 tmux select-layout -t "$SESSION" even-vertical
 
 # --- Helper: wait for a NEW lock file (ignores pre-existing ones) ---
@@ -359,10 +376,20 @@ sleep 3
 # Pane 3: Remote control with auto-restart loop
 tmux send-keys -t "${SESSION}:0.3" "$REMOTE_CMD" Enter
 
-# Pane 4: SSH reverse tunnel (only if --vps was set)
+# Pane 4: Dashboard (only if not --no-dashboard and dashboard dir exists)
+DASHBOARD_DIR="$BRIDGE_DIR/dashboard"
+if [[ -z "$NO_DASHBOARD" ]] && [[ -d "$DASHBOARD_DIR" ]]; then
+  BRIDGE_PORT=$(basename "$LOCK_FILE" .lock)
+  DASHBOARD_CMD="cd $(printf '%q' "$DASHBOARD_DIR") && PATCHWORK_BRIDGE_PORT=${BRIDGE_PORT} npm run dev"
+  notify "Starting dashboard on http://localhost:${DASHBOARD_PORT}"
+  tmux send-keys -t "${SESSION}:0.4" "$DASHBOARD_CMD" Enter
+fi
+
+# Pane 5: SSH reverse tunnel (only if --vps was set)
 if [[ -n "$TUNNEL_CMD" ]]; then
   notify "Starting SSH tunnel to ${VPS}..."
-  tmux send-keys -t "${SESSION}:0.4" "$TUNNEL_CMD" Enter
+  TUNNEL_PANE=$([[ -z "$NO_DASHBOARD" ]] && echo 5 || echo 4)
+  tmux send-keys -t "${SESSION}:0.${TUNNEL_PANE}" "$TUNNEL_CMD" Enter
 fi
 
 # --- Health monitor (runs in pane 0 — the orchestrator pane) ---
@@ -377,10 +404,12 @@ cleanup() {
   tmux send-keys -t "${SESSION}:0.1" C-c 2>/dev/null
   tmux send-keys -t "${SESSION}:0.2" C-c 2>/dev/null
   tmux send-keys -t "${SESSION}:0.3" C-c 2>/dev/null
-  [[ -n "$TUNNEL_CMD" ]] && tmux send-keys -t "${SESSION}:0.4" C-c 2>/dev/null
+  [[ -z "$NO_DASHBOARD" ]] && tmux send-keys -t "${SESSION}:0.4" C-c 2>/dev/null
+  [[ -n "$TUNNEL_CMD" ]] && tmux send-keys -t "${SESSION}:0.${TUNNEL_PANE:-4}" C-c 2>/dev/null
   # Wait up to 5s for panes to exit gracefully, then force-kill
   local panes=(1 2 3)
-  [[ -n "$TUNNEL_CMD" ]] && panes=(1 2 3 4)
+  [[ -z "$NO_DASHBOARD" ]] && panes=(1 2 3 4)
+  [[ -n "$TUNNEL_CMD" ]] && panes=("${panes[@]}" "${TUNNEL_PANE:-4}")
   for _ in $(seq 1 5); do
     sleep 1
     all_idle=true
@@ -396,7 +425,8 @@ cleanup() {
   done
   sleep 1
   local rpanes=(3 2 1)
-  [[ -n "$TUNNEL_CMD" ]] && rpanes=(4 3 2 1)
+  [[ -z "$NO_DASHBOARD" ]] && rpanes=(4 3 2 1)
+  [[ -n "$TUNNEL_CMD" ]] && rpanes=("${TUNNEL_PANE:-4}" "${rpanes[@]}")
   for pane in "${rpanes[@]}"; do
     tmux kill-pane -t "${SESSION}:0.${pane}" 2>/dev/null || true
   done
@@ -413,7 +443,8 @@ while true; do
     tmux send-keys -t "${SESSION}:0.1" C-c
     tmux send-keys -t "${SESSION}:0.2" C-c
     tmux send-keys -t "${SESSION}:0.3" C-c
-    [[ -n "$TUNNEL_CMD" ]] && tmux send-keys -t "${SESSION}:0.4" C-c
+    [[ -z "$NO_DASHBOARD" ]] && tmux send-keys -t "${SESSION}:0.4" C-c
+    [[ -n "$TUNNEL_CMD" ]] && tmux send-keys -t "${SESSION}:0.${TUNNEL_PANE:-4}" C-c
     # Wait for bridge (pane 1) and claude (pane 2) to actually stop
     for _ in $(seq 1 10); do
       pane1_cmd=$(tmux display-message -t "${SESSION}:0.1" -p '#{pane_current_command}' 2>/dev/null || echo "")
@@ -476,9 +507,15 @@ while true; do
     sleep 3
     # Restart remote-control
     tmux send-keys -t "${SESSION}:0.3" "$REMOTE_CMD" Enter
+    # Restart dashboard with updated bridge port
+    if [[ -z "$NO_DASHBOARD" ]] && [[ -d "$DASHBOARD_DIR" ]]; then
+      NEW_BRIDGE_PORT=$(basename "$LOCK_FILE" .lock)
+      DASHBOARD_CMD="cd $(printf '%q' "$DASHBOARD_DIR") && PATCHWORK_BRIDGE_PORT=${NEW_BRIDGE_PORT} npm run dev"
+      tmux send-keys -t "${SESSION}:0.4" "$DASHBOARD_CMD" Enter
+    fi
     # Restart SSH tunnel (port may have changed — tunnel cmd reads lock file dynamically)
     if [[ -n "$TUNNEL_CMD" ]]; then
-      tmux send-keys -t "${SESSION}:0.4" "$TUNNEL_CMD" Enter
+      tmux send-keys -t "${SESSION}:0.${TUNNEL_PANE:-4}" "$TUNNEL_CMD" Enter
     fi
     notify "All processes restarted"
   else

package/templates/co.patchwork-os.bridge.plist

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>co.patchwork-os.bridge</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>__BINARY_PATH__</string>
+    <string>--claude-driver</string>
+    <string>subprocess</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>__HOME__/Library/Logs/patchwork-os/bridge.log</string>
+  <key>StandardErrorPath</key>
+  <string>__HOME__/Library/Logs/patchwork-os/bridge.err</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>HOME</key>
+    <string>__HOME__</string>
+    <key>PATH</key>
+    <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
+  </dict>
+  <key>WorkingDirectory</key>
+  <string>__HOME__</string>
+  <key>ThrottleInterval</key>
+  <integer>30</integer>
+</dict>
+</plist>