opencode-pilot 0.1.0 → 0.2.0

package/.github/workflows/ci.yml

@@ -9,6 +9,7 @@ on:
 permissions:
   contents: write
   id-token: write  # Enable OIDC for npm trusted publishing
+  issues: write    # For semantic-release failure reporting
 
 jobs:
   test:
@@ -56,12 +57,18 @@ jobs:
         with:
           node-version: '22'
 
+      - name: Upgrade npm for trusted publishing
+        run: npm install -g npm@latest
+
+      - name: Configure npm registry
+        run: npm config set registry https://registry.npmjs.org/
+
       - name: Install Node.js dependencies
         run: npm install
 
       - name: Run semantic-release
         id: semantic
-        uses: cycjimmy/semantic-release-action@v4
+        run: npx semantic-release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_CONFIG_PROVENANCE: true

package/.releaserc.cjs

@@ -5,7 +5,16 @@ module.exports = {
   
   plugins: [
     // Analyze commits to determine release type
-    '@semantic-release/commit-analyzer',
+    // While in 0.x, breaking changes bump minor (not major) per semver spec
+    ['@semantic-release/commit-analyzer', {
+      releaseRules: [
+        { breaking: true, release: 'minor' },
+        { type: 'feat', release: 'minor' },
+        { type: 'fix', release: 'patch' },
+        { type: 'perf', release: 'patch' },
+        { type: 'refactor', release: 'patch' },
+      ]
+    }],
     
     // Generate release notes
     '@semantic-release/release-notes-generator',

package/AGENTS.md

@@ -7,7 +7,6 @@ Before committing changes, verify documentation is updated to reflect code chang
 1. **README.md** - Update if changes affect:
    - Configuration options (config.yaml keys)
    - CLI commands (`opencode-pilot <command>`)
-   - Notification types or behavior
    - Installation or setup steps
    - Service management
    - Sources or polling behavior
@@ -15,7 +14,6 @@ Before committing changes, verify documentation is updated to reflect code chang
 2. **CONTRIBUTING.md** - Update if changes affect:
    - Development setup or workflow
    - Test commands or patterns
-   - Plugin architecture
 
 ## Post-PR: Release and Upgrade Workflow
 
@@ -38,20 +36,16 @@ gh release list -R athal7/opencode-pilot -L 1
 npm view opencode-pilot version
 ```
 
-### 3. Restart OpenCode
+### 3. Restart Service
 
-OpenCode auto-updates npm plugins. Simply restart any running OpenCode sessions to get the latest version.
-
-### 4. Restart Service
-
-If the callback service is running, restart it:
+If the service is running, restart it:
 
 ```bash
 # Stop current service (Ctrl+C) and restart
 npx opencode-pilot start
 ```
 
-### 5. Verify Upgrade
+### 4. Verify Upgrade
 
 ```bash
 npx opencode-pilot status
@@ -61,10 +55,10 @@ npx opencode-pilot status
 
 Config file: `~/.config/opencode-pilot/config.yaml`
 
-Configuration has three sections:
-- `notifications` - ntfy settings (topic, server, callback, etc.)
-- `repos` - per-repository settings (use YAML anchors to share config)
+Configuration has these sections:
+- `tools` - field mappings for MCP servers
 - `sources` - polling sources with generic MCP tool references
+- `repos` - per-repository settings (use YAML anchors to share config)
 
 Template files: `~/.config/opencode-pilot/templates/*.md`
 

package/README.md

@@ -1,38 +1,42 @@
 # opencode-pilot
 
-Automation layer for [OpenCode](https://github.com/sst/opencode) - notifications and workflow orchestration.
+Automation daemon for [OpenCode](https://github.com/sst/opencode) - polls for work and spawns sessions.
 
 > **Note**: This is a community project and is not built by or affiliated with the OpenCode team.
 
 ## Features
 
-- **Idle notifications** - Get notified when OpenCode has been waiting for input
-- **Error alerts** - Stay informed when something needs attention
 - **Polling automation** - Automatically start sessions from GitHub issues, Linear tickets, etc.
+- **Readiness evaluation** - Check labels, dependencies, and priority before starting work
+- **Template-based prompts** - Customize prompts with placeholders for issue data
 
 ## Installation
 
-Add the plugin to your `~/.config/opencode/opencode.json`:
-
-```json
-{
-  "plugin": ["opencode-pilot"]
-}
+```bash
+npm install -g opencode-pilot
 ```
 
-OpenCode auto-installs npm plugins on startup.
-
 ## Quick Start
 
 1. **Create config** - Copy [examples/config.yaml](examples/config.yaml) to `~/.config/opencode-pilot/config.yaml` and customize
 
-2. **Start the service** (in a separate terminal):
+2. **Create templates** - Add prompt templates to `~/.config/opencode-pilot/templates/`
 
-   ```bash
-   npx opencode-pilot start
+3. **Enable the plugin** - Add to your `opencode.json`:
+
+   ```json
+   {
+     "plugin": ["opencode-pilot"]
+   }
    ```
 
-3. **Run OpenCode** - notifications will be sent to your ntfy topic!
+   The daemon will auto-start when OpenCode launches.
+
+   Or start manually:
+
+   ```bash
+   opencode-pilot start
+   ```
 
 ## Configuration
 
@@ -40,28 +44,30 @@ See [examples/config.yaml](examples/config.yaml) for a complete example with all
 
 ### Key Sections
 
-- **`notifications`** - ntfy settings (topic, server, idle/error settings)
-- **`repos`** - Repository paths and settings (use YAML anchors to share config)
 - **`sources`** - What to poll (GitHub issues, Linear tickets, etc.)
 - **`tools`** - Field mappings to normalize different MCP APIs
+- **`repos`** - Repository paths and settings (use YAML anchors to share config)
 
 ### Prompt Templates
 
 Create prompt templates as markdown files in `~/.config/opencode-pilot/templates/`. Templates support placeholders like `{title}`, `{body}`, `{number}`, `{html_url}`, etc.
 
-## Service Management
+## CLI Commands
 
 ```bash
-npx opencode-pilot start              # Start the service (foreground)
-npx opencode-pilot status             # Check status
-npx opencode-pilot test-source NAME   # Test a source
+opencode-pilot start              # Start the service (foreground)
+opencode-pilot status             # Check status
+opencode-pilot config             # Validate and show config
+opencode-pilot test-source NAME   # Test a source
+opencode-pilot test-mapping MCP   # Test field mappings
 ```
 
-## Troubleshooting
+## How It Works
 
-1. Check ntfy topic: `curl -d "test" ntfy.sh/your-topic`
-2. Verify config: `npx opencode-pilot config`
-3. Enable debug logging: set `notifications.debug: true` in config
+1. **Poll sources** - Periodically fetch items from configured MCP tools (GitHub, Linear, etc.)
+2. **Evaluate readiness** - Check labels, dependencies, and calculate priority
+3. **Spawn sessions** - Start `opencode run` with the appropriate prompt template
+4. **Track state** - Remember which items have been processed
 
 ## Related
 

package/bin/opencode-pilot

@@ -1,18 +1,22 @@
 #!/usr/bin/env node
 /**
- * opencode-pilot - CLI for opencode-pilot automation
+ * opencode-pilot - CLI for opencode-pilot automation daemon
  *
  * Commands:
- *   setup       Copy plugin files and configure OpenCode
- *   status      Show installation and service status
+ *   start       Start the polling service
+ *   status      Show service status
+ *   config      Validate and show configuration
+ *   test-source Test a polling source
+ *   test-mapping Test field mappings
  *   help        Show help
  */
 
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
-import { existsSync, readFileSync, writeFileSync, mkdirSync, cpSync, rmSync } from "fs";
+import { existsSync, readFileSync } from "fs";
 import { execSync } from "child_process";
 import os from "os";
+import YAML from "yaml";
 
 // Get script directory for relative imports
 const __filename = fileURLToPath(import.meta.url);
@@ -32,30 +36,34 @@ function findServiceDir() {
   return candidates[0];
 }
 
-// Find plugin directory
-function findPluginDir() {
-  const candidates = [
-    join(__dirname, "..", "plugin"),                        // Development
-    join(__dirname, "..", "lib", "opencode-pilot", "plugin"), // Homebrew
-  ];
-  for (const dir of candidates) {
-    if (existsSync(join(dir, "index.js"))) {
-      return dir;
-    }
-  }
-  return null;
-}
-
 const serviceDir = findServiceDir();
 
 // Paths
-const OPENCODE_CONFIG_DIR = join(os.homedir(), ".config/opencode");
-const PLUGIN_NAME = "opencode-pilot";
-const PLUGIN_DEST = join(OPENCODE_CONFIG_DIR, "plugins", PLUGIN_NAME);
-const OPENCODE_CONFIG_FILE = join(OPENCODE_CONFIG_DIR, "opencode.json");
 const PILOT_CONFIG_FILE = join(os.homedir(), ".config/opencode-pilot/config.yaml");
 const PILOT_TEMPLATES_DIR = join(os.homedir(), ".config/opencode-pilot/templates");
 
+// Default port
+const DEFAULT_PORT = 4097;
+
+/**
+ * Load port from config file
+ * @returns {number} Port number
+ */
+function getPortFromConfig() {
+  try {
+    if (existsSync(PILOT_CONFIG_FILE)) {
+      const content = readFileSync(PILOT_CONFIG_FILE, "utf8");
+      const config = YAML.parse(content);
+      if (config?.port && typeof config.port === "number") {
+        return config.port;
+      }
+    }
+  } catch {
+    // Ignore errors, use default
+  }
+  return DEFAULT_PORT;
+}
+
 // Parse command line arguments
 function parseArgs(args) {
   const result = {
@@ -99,27 +107,25 @@ function parseArgs(args) {
 
 // Help text
 function showHelp() {
-  console.log(`opencode-pilot - Automation layer for OpenCode
+  console.log(`opencode-pilot - Automation daemon for OpenCode
 
 Usage:
   opencode-pilot <command> [options]
 
 Commands:
-  start                Start the callback service (foreground)
-  setup                Copy plugin files and configure OpenCode
-  status               Show installation and service status
+  start                Start the polling service (foreground)
+  status               Show service status
   config               Validate and show configuration
   test-source NAME     Test a source by fetching items and showing mappings
   test-mapping MCP     Test field mappings with sample JSON input
   help                 Show this help message
 
 The service handles:
-- Notification callbacks from ntfy
 - Polling for GitHub/Linear issues to work on
+- Spawning OpenCode sessions for ready items
 
 Examples:
   opencode-pilot start                   # Start service (foreground)
-  opencode-pilot setup                   # Initial setup
   opencode-pilot status                  # Check status
   opencode-pilot config                  # Validate and show config
   opencode-pilot test-source my-issues   # Test a source
@@ -140,14 +146,13 @@ async function startCommand() {
     process.exit(1);
   }
 
-  console.log("[opencode-pilot] Starting callback service...");
+  console.log("[opencode-pilot] Starting polling service...");
   
   // Dynamic import of the service module
   const { startService, stopService } = await import(serverPath);
   
   const config = {
-    httpPort: parseInt(process.env.NTFY_CALLBACK_PORT || "4097", 10),
-    socketPath: process.env.NTFY_SOCKET_PATH || "/tmp/opencode-pilot.sock",
+    httpPort: getPortFromConfig(),
   };
   
   const service = await startService(config);
@@ -169,180 +174,34 @@ async function startCommand() {
   await new Promise(() => {});
 }
 
-// ============================================================================
-// Setup Command
-// ============================================================================
-
-async function setupCommand() {
-  console.log("Setting up opencode-pilot...");
-  console.log("");
-
-  const pluginSource = findPluginDir();
-  if (!pluginSource) {
-    console.error("ERROR: Could not find plugin source files");
-    console.error("Install via: brew install athal7/tap/opencode-pilot");
-    process.exit(1);
-  }
-
-  console.log(`Source: ${pluginSource}`);
-  console.log(`Destination: ${PLUGIN_DEST}`);
-  console.log("");
-
-  // Backup existing config
-  if (existsSync(OPENCODE_CONFIG_FILE)) {
-    const backupFile = `${OPENCODE_CONFIG_FILE}.backup.${Date.now()}`;
-    try {
-      cpSync(OPENCODE_CONFIG_FILE, backupFile);
-      console.log(`Backup created: ${backupFile}`);
-    } catch (err) {
-      console.error("ERROR: Failed to create backup of opencode.json");
-      process.exit(1);
-    }
-  }
-
-  // Copy plugin files
-  mkdirSync(join(OPENCODE_CONFIG_DIR, "plugins"), { recursive: true });
-  if (existsSync(PLUGIN_DEST)) {
-    rmSync(PLUGIN_DEST, { recursive: true });
-  }
-  cpSync(pluginSource, PLUGIN_DEST, { recursive: true });
-  console.log("Plugin files copied.");
-
-  // Update opencode.json
-  let config = {};
-  if (existsSync(OPENCODE_CONFIG_FILE)) {
-    try {
-      config = JSON.parse(readFileSync(OPENCODE_CONFIG_FILE, "utf8"));
-    } catch {
-      config = {};
-    }
-  }
-
-  config.plugin = config.plugin || [];
-  const alreadyRegistered = config.plugin.some(p => p.includes(`plugins/${PLUGIN_NAME}`));
-
-  if (alreadyRegistered) {
-    console.log("Plugin already in opencode.json");
-  } else {
-    config.plugin.push(PLUGIN_DEST);
-    const tempFile = `${OPENCODE_CONFIG_FILE}.tmp`;
-    writeFileSync(tempFile, JSON.stringify(config, null, 2) + "\n");
-    const { renameSync } = await import("fs");
-    renameSync(tempFile, OPENCODE_CONFIG_FILE);
-    console.log("Added plugin to opencode.json");
-  }
-
-  // Try to restart service
-  try {
-    execSync("brew services restart opencode-pilot", { stdio: "pipe" });
-    console.log("");
-    console.log("Service restarted.");
-  } catch {
-    // Not installed via brew or service not available
-  }
-
-  console.log("");
-  console.log("Setup complete!");
-  console.log("");
-  console.log("Next steps:");
-  console.log("  1. Edit ~/.config/opencode-pilot/config.yaml");
-  console.log("  2. Run: opencode-pilot start");
-}
-
 // ============================================================================
 // Status Command
 // ============================================================================
 
-function getConfigValue(envVar, configKey, defaultValue = "") {
-  // Check env var first
-  if (process.env[envVar]) {
-    return process.env[envVar];
-  }
-
-  // Check config file
-  if (existsSync(PILOT_CONFIG_FILE)) {
-    try {
-      const config = JSON.parse(readFileSync(PILOT_CONFIG_FILE, "utf8"));
-      if (config[configKey] !== undefined && config[configKey] !== "") {
-        return config[configKey];
-      }
-    } catch {
-      // Ignore
-    }
-  }
-
-  return defaultValue;
-}
-
 function statusCommand() {
   console.log("opencode-pilot status");
   console.log("=====================");
   console.log("");
 
-  // Plugin installed?
-  if (existsSync(PLUGIN_DEST)) {
-    console.log(`Plugin: installed at ${PLUGIN_DEST}`);
-  } else {
-    console.log("Plugin: NOT INSTALLED (run: opencode-pilot setup)");
-  }
-
-  // Config?
-  if (existsSync(OPENCODE_CONFIG_FILE)) {
-    try {
-      const config = JSON.parse(readFileSync(OPENCODE_CONFIG_FILE, "utf8"));
-      const registered = (config.plugin || []).some(p => p.includes(`plugins/${PLUGIN_NAME}`));
-      if (registered) {
-        console.log("Config: plugin registered in opencode.json");
-      } else {
-        console.log("Config: plugin NOT in opencode.json");
-      }
-    } catch {
-      console.log("Config: could not parse opencode.json");
-    }
-  } else {
-    console.log("Config: opencode.json not found");
-  }
-
-  // Service running? Check if socket exists and HTTP responds
-  const socketPath = "/tmp/opencode-pilot.sock";
-  const servicePort = getConfigValue("NTFY_CALLBACK_PORT", "callbackPort", "4097");
+  // Service running? Check if HTTP responds
+  const servicePort = getPortFromConfig();
   
-  if (existsSync(socketPath)) {
-    // Socket exists, try health check
-    try {
-      const res = execSync(`curl -s -o /dev/null -w "%{http_code}" http://localhost:${servicePort}/health`, { encoding: "utf8", timeout: 2000 });
-      if (res.trim() === "200") {
-        console.log("Service: running");
-      } else {
-        console.log("Service: socket exists but not responding (run: opencode-pilot start)");
-      }
-    } catch {
-      console.log("Service: socket exists but health check failed");
+  try {
+    const res = execSync(`curl -s -o /dev/null -w "%{http_code}" http://localhost:${servicePort}/health`, { encoding: "utf8", timeout: 2000 });
+    if (res.trim() === "200") {
+      console.log("Service: running");
+    } else {
+      console.log("Service: not responding (run: opencode-pilot start)");
     }
-  } else {
+  } catch {
     console.log("Service: not running (run: opencode-pilot start)");
   }
 
-  // Notification configuration
-  console.log("");
-  console.log("Notification Configuration:");
-
-  const topic = getConfigValue("NTFY_TOPIC", "topic", "");
-  const server = getConfigValue("NTFY_SERVER", "server", "https://ntfy.sh");
-  const callbackHost = getConfigValue("NTFY_CALLBACK_HOST", "callbackHost", "");
-  const callbackPort = getConfigValue("NTFY_CALLBACK_PORT", "callbackPort", "4097");
-
-  console.log(`  topic: ${topic || "<not set>"}`);
-  console.log(`  server: ${server}`);
-  console.log(`  callbackHost: ${callbackHost || "<not set>"}`);
-  console.log(`  callbackPort: ${callbackPort}`);
-
   // Polling configuration
   console.log("");
-  console.log("Polling Configuration:");
+  console.log("Configuration:");
   if (existsSync(PILOT_CONFIG_FILE)) {
     console.log(`  config.yaml: ${PILOT_CONFIG_FILE}`);
-    console.log("  polling: enabled (handled by service)");
   } else {
     console.log(`  config.yaml: not found at ${PILOT_CONFIG_FILE}`);
     console.log("  polling: disabled");
@@ -379,22 +238,6 @@ async function configCommand() {
     process.exit(1);
   }
 
-  // Validate notifications section
-  console.log("");
-  console.log("Notifications:");
-  const notifications = config.notifications || {};
-  if (notifications.topic) {
-    console.log(`  ✓ topic: ${notifications.topic.substring(0, 8)}...`);
-  } else {
-    console.log("  ✗ topic: not set (required for notifications)");
-  }
-  console.log(`  server: ${notifications.server || "https://ntfy.sh"}`);
-  if (notifications.callback_host) {
-    console.log(`  ✓ callback_host: ${notifications.callback_host}`);
-  } else {
-    console.log("  ⚠ callback_host: not set (interactive notifications disabled)");
-  }
-
   // Validate defaults section
   console.log("");
   console.log("Defaults:");
@@ -599,7 +442,6 @@ async function testSourceCommand(sourceName) {
     // Import poller
     const pollerPath = join(serviceDir, "poller.js");
     const { pollGenericSource, applyMappings } = await import(pollerPath);
-    const { getToolMappings } = await import(join(serviceDir, "repo-config.js"));
     
     // Fetch items with mappings applied
     const items = await pollGenericSource(source, { mappings });
@@ -763,7 +605,7 @@ async function testMappingCommand(mcpName) {
 
 async function main() {
   const args = process.argv.slice(2);
-  const { command, subcommand, flags } = parseArgs(args);
+  const { command, subcommand } = parseArgs(args);
 
   if (!command || command === "help") {
     showHelp();
@@ -775,10 +617,6 @@ async function main() {
       await startCommand();
       break;
 
-    case "setup":
-      await setupCommand();
-      break;
-
     case "status":
       statusCommand();
       break;

package/examples/config.yaml

@@ -4,16 +4,9 @@
 # Also create templates/ directory with prompt template files
 
 # =============================================================================
-# NOTIFICATIONS - ntfy settings for mobile notifications
+# SERVICE - Daemon configuration
 # =============================================================================
-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
+# port: 4097                        # HTTP port for health checks (default: 4097)
 
 # =============================================================================
 # TOOLS - Field mappings for MCP servers (normalize different APIs)

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "opencode-pilot",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
-  "description": "Automation layer for OpenCode - notifications, mobile UI, and workflow orchestration",
   "main": "plugin/index.js",
+  "description": "Automation daemon for OpenCode - polls for work and spawns sessions",
   "repository": {
     "type": "git",
     "url": "https://github.com/athal7/opencode-pilot.git"
@@ -14,10 +14,10 @@
   },
   "keywords": [
     "opencode",
-    "plugin",
-    "notifications",
     "automation",
-    "ntfy"
+    "polling",
+    "github",
+    "linear"
   ],
   "author": "Andrew Thal <467872+athal7@users.noreply.github.com>",
   "license": "MIT",
@@ -30,7 +30,7 @@
   "devDependencies": {
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^9.2.6",
-    "@semantic-release/npm": "^12.0.0",
+    "@semantic-release/npm": "^13.1.0",
     "semantic-release": "^25.0.2"
   },
   "dependencies": {