awesome-slash 2.4.4 → 2.5.1

package/scripts/install/opencode.sh

@@ -4,8 +4,18 @@
 
 set -e
 
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PLUGIN_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+# Detect plugin root - works whether run directly or via bash -c
+if [ -n "${BASH_SOURCE[0]}" ] && [ -f "${BASH_SOURCE[0]}" ]; then
+  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  PLUGIN_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+elif [ -f "scripts/install/opencode.sh" ]; then
+  PLUGIN_ROOT="$(pwd)"
+elif [ -f "package.json" ] && grep -q "awesome-slash" package.json 2>/dev/null; then
+  PLUGIN_ROOT="$(pwd)"
+else
+  echo "Error: Cannot detect plugin root. Run from the awesome-slash directory."
+  exit 1
+fi
 
 echo "Installing awesome-slash for OpenCode..."
 echo "Plugin root: $PLUGIN_ROOT"
@@ -38,24 +48,33 @@ if [ -f "$CONFIG_FILE" ]; then
   echo "Backed up existing config to $CONFIG_FILE.backup"
 fi
 
+# Convert Git Bash path to Windows path
+# /c/Users/... -> C:/Users/...
+if [[ "$PLUGIN_ROOT" == /[a-z]/* ]]; then
+  DRIVE_LETTER=$(echo "$PLUGIN_ROOT" | cut -c2 | tr '[:lower:]' '[:upper:]')
+  PLUGIN_ROOT_WIN="${DRIVE_LETTER}:${PLUGIN_ROOT:2}"
+else
+  PLUGIN_ROOT_WIN="$PLUGIN_ROOT"
+fi
+
 # Check if jq is available for JSON manipulation
 if command -v jq &> /dev/null; then
   if [ -f "$CONFIG_FILE.backup" ]; then
     # Merge with existing config
-    jq --arg root "$PLUGIN_ROOT" '.mcp["awesome-slash"] = {
+    jq --arg root "$PLUGIN_ROOT_WIN" '.mcp["awesome-slash"] = {
       "type": "local",
       "command": ["node", ($root + "/mcp-server/index.js")],
-      "environment": {"PLUGIN_ROOT": $root},
+      "environment": {"PLUGIN_ROOT": $root, "AI_STATE_DIR": ".opencode"},
       "enabled": true
     }' "$CONFIG_FILE.backup" > "$CONFIG_FILE"
   else
     # Create new config
-    jq -n --arg root "$PLUGIN_ROOT" '{
+    jq -n --arg root "$PLUGIN_ROOT_WIN" '{
       "mcp": {
         "awesome-slash": {
           "type": "local",
           "command": ["node", ($root + "/mcp-server/index.js")],
-          "environment": {"PLUGIN_ROOT": $root},
+          "environment": {"PLUGIN_ROOT": $root, "AI_STATE_DIR": ".opencode"},
           "enabled": true
         }
       }
@@ -68,9 +87,10 @@ else
   "mcp": {
     "awesome-slash": {
       "type": "local",
-      "command": ["node", "$PLUGIN_ROOT/mcp-server/index.js"],
+      "command": ["node", "$PLUGIN_ROOT_WIN/mcp-server/index.js"],
       "environment": {
-        "PLUGIN_ROOT": "$PLUGIN_ROOT"
+        "PLUGIN_ROOT": "$PLUGIN_ROOT_WIN",
+        "AI_STATE_DIR": ".opencode"
       },
       "enabled": true
     }
@@ -79,17 +99,168 @@ else
 EOF
 fi
 
-# Create agent definitions
-AGENT_DIR="$OPENCODE_CONFIG/agent"
-mkdir -p "$AGENT_DIR"
+# Create commands directory (for slash commands)
+COMMANDS_DIR="$OPENCODE_CONFIG/commands"
+mkdir -p "$COMMANDS_DIR"
+
+echo "Installing slash commands..."
+
+# /next-task command
+cat > "$COMMANDS_DIR/next-task.md" << 'EOF'
+---
+description: Start the next-task workflow for task-to-production automation
+agent: workflow
+---
+
+# Next Task Workflow
+
+Start or resume the awesome-slash next-task workflow.
+
+## CRITICAL: Always Ask User First
+
+**DO NOT auto-select options.** You MUST ask the user before proceeding:
+
+1. First, use `workflow_status` MCP tool to check for existing workflow
+2. If resumable workflow exists, ASK user: "Resume existing workflow or start fresh?"
+3. For new workflows, ASK user to choose:
+   - **Task Source**: GitHub Issues, GitLab, Local files (TASKS.md), or Custom?
+   - **Priority Filter**: Bugs, Security, Features, or All?
+   - **Stopping Point**: PR created, Merged, or Deployed?
+
+## Available MCP Tools
+
+- `workflow_status` - Check current workflow state
+- `workflow_start` - Start new workflow (params: taskSource, priorityFilter, stoppingPoint)
+- `workflow_resume` - Resume from checkpoint
+- `workflow_abort` - Cancel and cleanup
+- `task_discover` - Find tasks (params: source, filter, limit)
+
+## Task Sources (ask user to pick)
+
+- `gh-issues` - GitHub Issues
+- `glab-issues` - GitLab Issues
+- `tasks-md` - Local TASKS.md/PLAN.md/TODO.md
+- `custom` - Custom CLI tool or file
+
+## Stopping Points (ask user to pick)
+
+- `pr-created` - Stop after PR creation
+- `merged` - Stop after merge
+- `deployed` - Stop after deployment
+
+## State Directory
+
+State is stored in `.opencode/` directory (flow.json, tasks.json).
+
+$ARGUMENTS
+EOF
+
+# /ship command
+cat > "$COMMANDS_DIR/ship.md" << 'EOF'
+---
+description: Ship code from commit to production with full validation
+agent: ship
+---
+
+# Ship Workflow
+
+Complete PR workflow from commit to production.
+
+## Instructions
+
+1. Check `workflow_status` for current state
+2. Stage and commit changes with a clear message
+3. Create PR using `gh pr create`
+4. Run `review_code` MCP tool for multi-agent review
+5. Monitor CI status and fix any failures
+6. Merge when approved
+
+## MCP Tools
+
+- `workflow_status` - Check current state
+- `review_code` - Run multi-agent code review on changed files
+
+## Platforms Supported
+
+- CI: GitHub Actions, GitLab CI, CircleCI, Jenkins
+- Deploy: Railway, Vercel, Netlify, Fly.io
+
+$ARGUMENTS
+EOF
+
+# /review command
+cat > "$COMMANDS_DIR/review.md" << 'EOF'
+---
+description: Run multi-agent code review on changes
+agent: review
+---
+
+# Code Review
+
+Run comprehensive multi-agent code review.
+
+## Instructions
+
+Use the `review_code` MCP tool to analyze changed files.
+
+The review checks for:
+- Console debugging statements
+- TODO/FIXME comments
+- Commented-out code
+- Debugger statements
+- Empty catch blocks
+- TypeScript `any` types
+- Hardcoded secrets
+
+## Usage
+
+Call `review_code` with optional parameters:
+- `files` - Array of specific files to review (defaults to git diff)
+- `maxIterations` - Maximum review iterations (default: 3)
+
+$ARGUMENTS
+EOF
+
+# /deslop command
+cat > "$COMMANDS_DIR/deslop.md" << 'EOF'
+---
+description: Clean AI slop from codebase - debug statements, TODOs, placeholder text
+agent: general
+---
+
+# Deslop - AI Slop Cleanup
+
+Remove debugging code, old TODOs, and AI-generated slop from the codebase.
+
+## Detection Patterns
+
+- Console debugging (console.log, print, dbg!)
+- Placeholder text (TODO, FIXME, lorem ipsum)
+- Empty catch blocks
+- Commented-out code
+- Magic numbers
+- Disabled linters
+
+## Instructions
+
+1. Use the `review_code` MCP tool to detect issues
+2. Review the findings by severity (error, warning, info)
+3. Fix critical and high severity issues
+4. Report medium and low severity for manual review
+
+$ARGUMENTS
+EOF
+
+# Create agents directory (for agent definitions)
+AGENTS_DIR="$OPENCODE_CONFIG/agents"
+mkdir -p "$AGENTS_DIR"
 
 echo "Installing agent configurations..."
 
-# Workflow orchestrator agent (primary)
-cat > "$AGENT_DIR/workflow.md" << 'EOF'
+# Workflow orchestrator agent
+cat > "$AGENTS_DIR/workflow.md" << 'EOF'
 ---
 description: Master workflow orchestrator for task-to-production automation with MCP tools
-mode: primary
 tools:
   read: true
   write: true
@@ -129,10 +300,9 @@ When starting, check for existing workflow with `workflow_status` first.
 EOF
 
 # Review agent (subagent)
-cat > "$AGENT_DIR/review.md" << 'EOF'
+cat > "$AGENTS_DIR/review.md" << 'EOF'
 ---
 description: Multi-agent code reviewer for quality analysis
-mode: subagent
 tools:
   read: true
   write: false
@@ -162,10 +332,9 @@ Run comprehensive code review using the awesome-slash `review_code` MCP tool.
 EOF
 
 # Ship agent (subagent)
-cat > "$AGENT_DIR/ship.md" << 'EOF'
+cat > "$AGENTS_DIR/ship.md" << 'EOF'
 ---
 description: Complete PR workflow from commit to production
-mode: subagent
 tools:
   read: true
   write: true
@@ -201,11 +370,18 @@ EOF
 echo ""
 echo "✓ Installation complete!"
 echo ""
+echo "Installed:"
+echo "  - MCP server: awesome-slash"
+echo "  - Commands: /next-task, /ship, /review, /deslop"
+echo "  - Agents: workflow, review, ship"
+echo ""
 echo "Usage:"
 echo "  1. Start OpenCode: opencode"
-echo "  2. Switch agents with Tab: workflow, review, ship"
-echo "  3. MCP tools: workflow_status, workflow_start, task_discover, etc."
+echo "  2. Use slash commands: /next-task, /ship, /review, /deslop"
+echo "  3. Switch agents with Tab: workflow, review, ship"
+echo "  4. MCP tools available in prompts: workflow_status, task_discover, etc."
 echo ""
 echo "To verify installation:"
 echo "  opencode mcp list"
-echo "  ls ~/.config/opencode/agent/"
+echo "  ls ~/.config/opencode/commands/"
+echo "  ls ~/.config/opencode/agents/"

package/lib/state/workflow-state.schema.json

@@ -1,282 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "workflow-state.schema.json",
-  "title": "Workflow State",
-  "description": "Schema for next-task workflow orchestration state",
-  "type": "object",
-  "required": ["version", "workflow"],
-  "properties": {
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Schema version for migrations"
-    },
-    "workflow": {
-      "type": "object",
-      "required": ["id", "type", "status", "startedAt"],
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^workflow-\\d{8}-\\d{6}-[a-z0-9]+$",
-          "description": "Unique workflow identifier"
-        },
-        "type": {
-          "type": "string",
-          "enum": ["next-task", "ship", "manual"],
-          "description": "Workflow type"
-        },
-        "status": {
-          "type": "string",
-          "enum": ["pending", "in_progress", "paused", "completed", "failed", "aborted"],
-          "description": "Current workflow status"
-        },
-        "startedAt": {
-          "type": "string",
-          "format": "date-time",
-          "description": "Workflow start timestamp"
-        },
-        "lastUpdatedAt": {
-          "type": "string",
-          "format": "date-time",
-          "description": "Last state update timestamp"
-        },
-        "completedAt": {
-          "type": ["string", "null"],
-          "format": "date-time",
-          "description": "Workflow completion timestamp"
-        }
-      }
-    },
-    "policy": {
-      "type": "object",
-      "properties": {
-        "taskSource": {
-          "type": "string",
-          "enum": ["defaults", "gh-issues", "linear", "tasks-md", "custom"],
-          "default": "gh-issues"
-        },
-        "priorityFilter": {
-          "type": "string",
-          "enum": ["continue", "bugs", "security", "features", "all"],
-          "default": "continue"
-        },
-        "platform": {
-          "type": "string",
-          "enum": ["detected", "manual"],
-          "default": "detected"
-        },
-        "stoppingPoint": {
-          "type": "string",
-          "enum": ["implemented", "pr-created", "all-green", "merged", "deployed", "production"],
-          "default": "merged"
-        },
-        "mergeStrategy": {
-          "type": "string",
-          "enum": ["squash", "merge", "rebase"],
-          "default": "squash"
-        },
-        "autoFix": {
-          "type": "boolean",
-          "default": true
-        },
-        "maxReviewIterations": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 10,
-          "default": 3
-        }
-      }
-    },
-    "task": {
-      "type": ["object", "null"],
-      "properties": {
-        "id": {
-          "type": "string",
-          "description": "Task identifier (issue number, Linear ID, etc.)"
-        },
-        "source": {
-          "type": "string",
-          "enum": ["github", "linear", "tasks-md", "manual"]
-        },
-        "title": {
-          "type": "string"
-        },
-        "description": {
-          "type": "string"
-        },
-        "labels": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
-        "url": {
-          "type": ["string", "null"],
-          "format": "uri"
-        },
-        "linearId": {
-          "type": ["string", "null"]
-        }
-      }
-    },
-    "git": {
-      "type": ["object", "null"],
-      "properties": {
-        "originalBranch": {
-          "type": "string",
-          "description": "Branch before workflow started"
-        },
-        "workingBranch": {
-          "type": "string",
-          "description": "Feature branch for this task"
-        },
-        "worktreePath": {
-          "type": ["string", "null"],
-          "description": "Path to worktree if using isolated development"
-        },
-        "baseSha": {
-          "type": "string",
-          "description": "Base commit SHA when branched"
-        },
-        "currentSha": {
-          "type": "string",
-          "description": "Current HEAD commit SHA"
-        },
-        "isWorktree": {
-          "type": "boolean",
-          "default": false
-        }
-      }
-    },
-    "pr": {
-      "type": ["object", "null"],
-      "properties": {
-        "number": {
-          "type": "integer"
-        },
-        "url": {
-          "type": "string",
-          "format": "uri"
-        },
-        "state": {
-          "type": "string",
-          "enum": ["draft", "open", "merged", "closed"]
-        },
-        "ciStatus": {
-          "type": "string",
-          "enum": ["pending", "running", "success", "failure", "unknown"]
-        },
-        "reviewState": {
-          "type": "string",
-          "enum": ["pending", "changes_requested", "approved", "dismissed"]
-        },
-        "lastCheckedAt": {
-          "type": "string",
-          "format": "date-time"
-        },
-        "checksWaitingCount": {
-          "type": "integer",
-          "default": 0
-        }
-      }
-    },
-    "phases": {
-      "type": "object",
-      "properties": {
-        "current": {
-          "type": "string",
-          "enum": [
-            "policy-selection",
-            "task-discovery",
-            "worktree-setup",
-            "exploration",
-            "planning",
-            "user-approval",
-            "implementation",
-            "review-loop",
-            "delivery-approval",
-            "ship-prep",
-            "create-pr",
-            "ci-wait",
-            "comment-fix",
-            "merge",
-            "production-ci",
-            "deploy",
-            "production-release",
-            "complete"
-          ]
-        },
-        "currentIteration": {
-          "type": "integer",
-          "minimum": 0,
-          "default": 0
-        },
-        "history": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["phase", "status", "startedAt"],
-            "properties": {
-              "phase": { "type": "string" },
-              "status": {
-                "type": "string",
-                "enum": ["pending", "in_progress", "completed", "failed", "skipped"]
-              },
-              "startedAt": { "type": "string", "format": "date-time" },
-              "completedAt": { "type": ["string", "null"], "format": "date-time" },
-              "duration": { "type": "integer", "description": "Duration in milliseconds" },
-              "iteration": { "type": "integer" },
-              "result": { "type": "object" }
-            }
-          }
-        }
-      }
-    },
-    "agents": {
-      "type": ["object", "null"],
-      "properties": {
-        "lastRun": {
-          "type": "object",
-          "additionalProperties": {
-            "type": "object",
-            "properties": {
-              "status": { "type": "string", "enum": ["pending", "running", "completed", "failed"] },
-              "issues": { "type": "integer" },
-              "critical": { "type": "integer" },
-              "high": { "type": "integer" }
-            }
-          }
-        },
-        "totalIterations": { "type": "integer", "default": 0 },
-        "totalIssuesFound": { "type": "integer", "default": 0 },
-        "totalIssuesFixed": { "type": "integer", "default": 0 }
-      }
-    },
-    "checkpoints": {
-      "type": "object",
-      "properties": {
-        "canResume": {
-          "type": "boolean",
-          "default": true
-        },
-        "resumeFrom": {
-          "type": ["string", "null"],
-          "description": "Phase to resume from"
-        },
-        "resumeContext": {
-          "type": ["object", "null"],
-          "description": "Additional context needed for resume"
-        }
-      }
-    },
-    "metrics": {
-      "type": ["object", "null"],
-      "properties": {
-        "totalDuration": { "type": "integer", "description": "Total duration in milliseconds" },
-        "tokensUsed": { "type": "integer" },
-        "toolCalls": { "type": "integer" },
-        "filesModified": { "type": "integer" },
-        "linesAdded": { "type": "integer" },
-        "linesRemoved": { "type": "integer" }
-      }
-    }
-  }
-}