opencode-pilot 0.1.0

package/examples/config.yaml

@@ -0,0 +1,73 @@
+# Example config.yaml for opencode-pilot
+#
+# Copy to ~/.config/opencode-pilot/config.yaml and customize
+# Also create templates/ directory with prompt template files
+
+# =============================================================================
+# NOTIFICATIONS - ntfy settings for mobile notifications
+# =============================================================================
+notifications:
+  topic: your-secret-topic          # Required: ntfy topic name
+  server: https://ntfy.sh           # Optional: ntfy server URL
+  idle_delay_ms: 300000             # Optional: idle notification delay (5 min)
+  idle_notify: true                 # Optional: enable idle notifications
+  error_notify: true                # Optional: enable error notifications
+  error_debounce_ms: 60000          # Optional: error debounce window (1 min)
+  debug: false                      # Optional: enable debug logging
+
+# =============================================================================
+# TOOLS - Field mappings for MCP servers (normalize different APIs)
+# =============================================================================
+tools:
+  github:
+    mappings: {}                    # GitHub already uses standard field names
+
+  linear:
+    mappings:
+      body: title                         # Use title as body
+      number: "url:/([A-Z0-9]+-[0-9]+)/"  # Extract PROJ-123 from URL
+
+# =============================================================================
+# SOURCES - What to poll (generic MCP tool references)
+# =============================================================================
+sources:
+  # GitHub issues assigned to me - work in devcontainer
+  - name: my-issues
+    tool:
+      mcp: github
+      name: search_issues
+    args:
+      q: "is:issue assignee:@me state:open"
+    item:
+      id: "{html_url}"
+    prompt: devcontainer
+    agent: plan
+
+  # GitHub PRs needing review
+  - name: review-requests
+    tool:
+      mcp: github
+      name: search_issues
+    args:
+      q: "is:pr review-requested:@me state:open"
+    item:
+      id: "{html_url}"
+    prompt: review
+    agent: plan
+
+  # Linear issues - work in devcontainer
+  # NOTE: Replace teamId and assigneeId with your actual Linear UUIDs
+  # Find these via: linear_list_teams and check user IDs in team members
+  - name: linear-work
+    tool:
+      mcp: linear
+      name: list_issues
+    args:
+      teamId: "your-team-uuid"      # Replace with actual team UUID
+      assigneeId: "your-user-uuid"  # Replace with actual user UUID
+      status: "Todo"
+    item:
+      id: "linear:{id}"
+    working_dir: ~/code/myproject
+    prompt: devcontainer
+    agent: plan

package/examples/templates/default.md

@@ -0,0 +1,7 @@
+Work on this issue:
+
+{title}
+
+{body}
+
+Follow the project's coding standards and test your changes. Create a PR when the implementation is complete.

package/examples/templates/devcontainer.md

@@ -0,0 +1,7 @@
+Start a devcontainer for branch issue-{number} and work on this issue:
+
+{title}
+
+{body}
+
+Follow TDD: write failing tests first, then implement. Create a PR when complete.

package/examples/templates/review-feedback.md

@@ -0,0 +1,7 @@
+Address the review feedback on this PR:
+
+{title}
+
+{html_url}
+
+Focus only on unresolved review comments. Read each comment, make the requested changes, and respond to the reviewer. Skip any conversations that are already resolved.

package/examples/templates/review.md

@@ -0,0 +1,15 @@
+/review {html_url}
+
+Review this pull request:
+
+{title}
+
+{body}
+
+Check for:
+- Correctness and edge cases
+- Test coverage
+- Code quality and maintainability
+- Security considerations
+
+Provide actionable feedback. Approve if ready, or request changes with specific suggestions.

package/install.sh

@@ -0,0 +1,246 @@
+#!/usr/bin/env bash
+#
+# Install opencode-ntfy plugin and callback service
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/athal7/opencode-ntfy/main/install.sh | bash
+#
+# Or from a local clone:
+#   ./install.sh
+#
+
+set -euo pipefail
+
+REPO="athal7/opencode-ntfy"
+PLUGIN_NAME="opencode-ntfy"
+PLUGIN_DIR="$HOME/.config/opencode/plugins/$PLUGIN_NAME"
+SERVICE_DIR="$HOME/.local/share/opencode-ntfy"
+CONFIG_FILE="$HOME/.config/opencode/opencode.json"
+PLIST_DIR="$HOME/Library/LaunchAgents"
+PLIST_NAME="io.opencode.ntfy.plist"
+PLUGIN_FILES="index.js notifier.js callback.js hostname.js nonces.js config.js service-client.js"
+SERVICE_FILES="server.js"
+
+echo "Installing $PLUGIN_NAME..."
+echo ""
+
+# Create directories
+mkdir -p "$PLUGIN_DIR"
+mkdir -p "$SERVICE_DIR"
+
+# Check if we're running from a local clone or need to download
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}" 2>/dev/null)" && pwd 2>/dev/null)" || SCRIPT_DIR=""
+
+if [[ -n "$SCRIPT_DIR" ]] && [[ -f "$SCRIPT_DIR/plugin/index.js" ]]; then
+  # Local install from clone
+  echo "Installing from local directory..."
+  
+  echo ""
+  echo "Plugin files:"
+  for file in $PLUGIN_FILES; do
+    if [[ -f "$SCRIPT_DIR/plugin/$file" ]]; then
+      cp "$SCRIPT_DIR/plugin/$file" "$PLUGIN_DIR/$file"
+      echo "  Installed: plugin/$file -> $PLUGIN_DIR/$file"
+    fi
+  done
+  
+  echo ""
+  echo "Service files:"
+  for file in $SERVICE_FILES; do
+    if [[ -f "$SCRIPT_DIR/service/$file" ]]; then
+      cp "$SCRIPT_DIR/service/$file" "$SERVICE_DIR/$file"
+      echo "  Installed: service/$file -> $SERVICE_DIR/$file"
+    fi
+  done
+else
+  # Remote install - download from GitHub
+  echo "Downloading plugin files from GitHub..."
+  
+  for file in $PLUGIN_FILES; do
+    echo "  Downloading: plugin/$file"
+    if curl -fsSL "https://raw.githubusercontent.com/$REPO/main/plugin/$file" -o "$PLUGIN_DIR/$file"; then
+      echo "  Installed: $file"
+    else
+      echo "  ERROR: Failed to download $file"
+      exit 1
+    fi
+  done
+  
+  echo ""
+  echo "Downloading service files from GitHub..."
+  
+  for file in $SERVICE_FILES; do
+    echo "  Downloading: service/$file"
+    if curl -fsSL "https://raw.githubusercontent.com/$REPO/main/service/$file" -o "$SERVICE_DIR/$file"; then
+      echo "  Installed: $file"
+    else
+      echo "  ERROR: Failed to download $file"
+      exit 1
+    fi
+  done
+fi
+
+echo ""
+echo "Plugin files installed to: $PLUGIN_DIR"
+echo "Service files installed to: $SERVICE_DIR"
+
+# Install LaunchAgent plist (macOS only)
+if [[ "$(uname)" == "Darwin" ]]; then
+  echo ""
+  echo "Installing LaunchAgent for callback service..."
+  
+  mkdir -p "$PLIST_DIR"
+  
+  # Find node path (handle both Intel and Apple Silicon Macs)
+  NODE_PATH=$(command -v node 2>/dev/null)
+  if [[ -z "$NODE_PATH" ]]; then
+    # Try Homebrew paths
+    if [[ -x "/opt/homebrew/bin/node" ]]; then
+      NODE_PATH="/opt/homebrew/bin/node"
+    elif [[ -x "/usr/local/bin/node" ]]; then
+      NODE_PATH="/usr/local/bin/node"
+    else
+      echo "  WARNING: node not found, please install Node.js"
+      NODE_PATH="/usr/local/bin/node"
+    fi
+  fi
+  
+  # Generate plist with correct paths
+  cat > "$PLIST_DIR/$PLIST_NAME" << EOF
+<?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>io.opencode.ntfy</string>
+    
+    <key>ProgramArguments</key>
+    <array>
+        <string>$NODE_PATH</string>
+        <string>$SERVICE_DIR/server.js</string>
+    </array>
+    
+    <key>RunAtLoad</key>
+    <true/>
+    
+    <key>KeepAlive</key>
+    <true/>
+    
+    <key>StandardOutPath</key>
+    <string>$HOME/.local/share/opencode-ntfy/opencode-ntfy.log</string>
+    
+    <key>StandardErrorPath</key>
+    <string>$HOME/.local/share/opencode-ntfy/opencode-ntfy.log</string>
+    
+    <key>WorkingDirectory</key>
+    <string>$SERVICE_DIR</string>
+</dict>
+</plist>
+EOF
+  
+  echo "  LaunchAgent installed to: $PLIST_DIR/$PLIST_NAME"
+  echo ""
+  echo "  To start the callback service:"
+  echo "    launchctl load $PLIST_DIR/$PLIST_NAME"
+  echo ""
+  echo "  To stop the callback service:"
+  echo "    launchctl unload $PLIST_DIR/$PLIST_NAME"
+fi
+
+# Configure opencode.json
+echo ""
+echo "Configuring OpenCode..."
+
+if [[ -f "$CONFIG_FILE" ]]; then
+  # Check if plugin already configured
+  if grep -q "$PLUGIN_DIR" "$CONFIG_FILE" 2>/dev/null; then
+    echo "  Plugin already configured in opencode.json"
+  else
+    echo ""
+    echo "  Would you like to add the plugin to opencode.json? [Y/n]"
+    read -r response </dev/tty || response="y"
+    if [[ "$response" != "n" && "$response" != "N" ]]; then
+      # Use node to update JSON safely
+      if command -v node >/dev/null 2>&1; then
+        node -e "
+          const fs = require('fs');
+          const configPath = '$CONFIG_FILE';
+          const pluginDir = '$PLUGIN_DIR';
+          
+          let config;
+          try {
+            config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+          } catch {
+            config = {};
+          }
+          
+          config.plugin = config.plugin || [];
+          if (!config.plugin.includes(pluginDir)) {
+            config.plugin.push(pluginDir);
+          }
+          
+          fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+        "
+        echo "  Plugin added to opencode.json"
+      else
+        echo "  WARNING: node not found, please manually add to opencode.json:"
+        echo ""
+        echo "    \"plugin\": [\"$PLUGIN_DIR\"]"
+      fi
+    else
+      echo "  Skipped. You can manually add the plugin path to opencode.json later."
+    fi
+  fi
+else
+  echo ""
+  echo "  No opencode.json found. Create one with the plugin configured? [Y/n]"
+  read -r response </dev/tty || response="y"
+  if [[ "$response" != "n" && "$response" != "N" ]]; then
+    mkdir -p "$(dirname "$CONFIG_FILE")"
+    cat > "$CONFIG_FILE" << EOF
+{
+  "plugin": ["$PLUGIN_DIR"]
+}
+EOF
+    echo "  Created $CONFIG_FILE"
+  else
+    echo "  Skipped. You can create opencode.json later with:"
+    echo ""
+    echo "    {\"plugin\": [\"$PLUGIN_DIR\"]}"
+  fi
+fi
+
+# Environment variable check and guidance
+echo ""
+echo "========================================"
+echo "  Installation complete!"
+echo "========================================"
+echo ""
+
+# Check if NTFY_TOPIC is set
+if [[ -n "${NTFY_TOPIC:-}" ]]; then
+  echo "NTFY_TOPIC is set: $NTFY_TOPIC"
+  echo ""
+  echo "The plugin is ready to use!"
+else
+  echo "REQUIRED: Set NTFY_TOPIC in your environment."
+  echo ""
+  echo "Add to ~/.env (if using direnv) or your shell profile:"
+  echo ""
+  echo "  export NTFY_TOPIC=your-secret-topic"
+fi
+
+echo ""
+echo "Optional configuration:"
+echo "  NTFY_SERVER=https://ntfy.sh        # ntfy server (default: ntfy.sh)"
+echo "  NTFY_TOKEN=tk_xxx                  # ntfy access token for protected topics"
+echo "  NTFY_CALLBACK_HOST=host.ts.net     # Callback host for interactive notifications"
+echo "  NTFY_CALLBACK_PORT=4097            # Callback server port"
+echo "  NTFY_IDLE_DELAY_MS=300000          # Idle notification delay (5 min)"
+
+echo ""
+echo "For interactive permissions:"
+echo "  1. Set NTFY_CALLBACK_HOST to your machine's hostname (e.g., via Tailscale)"
+echo "  2. Start the callback service: launchctl load ~/Library/LaunchAgents/$PLIST_NAME"
+echo "  3. Ensure your phone can reach the callback URL"
+echo ""

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "opencode-pilot",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Automation layer for OpenCode - notifications, mobile UI, and workflow orchestration",
+  "main": "plugin/index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/athal7/opencode-pilot.git"
+  },
+  "publishConfig": {
+    "provenance": true,
+    "access": "public"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "notifications",
+    "automation",
+    "ntfy"
+  ],
+  "author": "Andrew Thal <467872+athal7@users.noreply.github.com>",
+  "license": "MIT",
+  "bin": {
+    "opencode-pilot": "./bin/opencode-pilot"
+  },
+  "scripts": {
+    "test": "node --test test/unit/*.test.js"
+  },
+  "devDependencies": {
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^9.2.6",
+    "@semantic-release/npm": "^12.0.0",
+    "semantic-release": "^25.0.2"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "yaml": "^2.8.2"
+  }
+}

package/plugin/config.js

@@ -0,0 +1,76 @@
+// Configuration management for opencode-pilot
+// Reads from ~/.config/opencode-pilot/config.yaml
+//
+// Example config file (~/.config/opencode-pilot/config.yaml):
+// notifications:
+//   topic: my-secret-topic
+//   server: https://ntfy.sh
+//   idle_delay_ms: 300000
+//   debug: true
+
+import { readFileSync, existsSync } from 'fs'
+import { join } from 'path'
+import { homedir } from 'os'
+import YAML from 'yaml'
+
+const DEFAULT_CONFIG_PATH = join(homedir(), '.config', 'opencode-pilot', 'config.yaml')
+
+/**
+ * Load configuration from config file
+ * @param {string} [configPath] - Optional path to config file (for testing)
+ */
+export function loadConfig(configPath) {
+  const actualPath = configPath || DEFAULT_CONFIG_PATH
+  
+  // Load config.yaml if it exists
+  let fileConfig = {}
+  if (existsSync(actualPath)) {
+    try {
+      const content = readFileSync(actualPath, 'utf8')
+      const parsed = YAML.parse(content)
+      // Extract notifications section
+      fileConfig = parsed?.notifications || {}
+    } catch (err) {
+      // Silently ignore parse errors
+    }
+  }
+
+  // Helper to get value with default
+  const get = (key, defaultValue) => {
+    if (fileConfig[key] !== undefined && fileConfig[key] !== '') {
+      return fileConfig[key]
+    }
+    return defaultValue
+  }
+
+  // Helper to parse boolean
+  const getBool = (key, defaultValue) => {
+    const value = get(key, undefined)
+    if (value === undefined) return defaultValue
+    if (typeof value === 'boolean') return value
+    return String(value).toLowerCase() !== 'false' && String(value) !== '0'
+  }
+
+  // Helper to parse int
+  const getInt = (key, defaultValue) => {
+    const value = get(key, undefined)
+    if (value === undefined) return defaultValue
+    if (typeof value === 'number') return value
+    const parsed = parseInt(String(value), 10)
+    return isNaN(parsed) ? defaultValue : parsed
+  }
+
+  return {
+    topic: get('topic', null),
+    server: get('server', 'https://ntfy.sh'),
+    authToken: get('token', null),
+    idleDelayMs: getInt('idle_delay_ms', 300000),
+    errorNotify: getBool('error_notify', true),
+    errorDebounceMs: getInt('error_debounce_ms', 60000),
+    retryNotifyFirst: getBool('retry_notify_first', true),
+    retryNotifyAfter: getInt('retry_notify_after', 3),
+    idleNotify: getBool('idle_notify', true),
+    debug: getBool('debug', false),
+    debugPath: get('debug_path', null),
+  }
+}