add scripts for claude actions

Author: paul-fracture

CLAUDE.md

@@ -35,8 +35,32 @@ Remember to update both:
 2. Version reference in README.md examples
 3. Create a git tag matching the version
 
+## Implementation Plan for Code Modification
+
+We're implementing several approaches for Claude to make code changes:
+
+1. **Suggested Changes Mode (Priority 1)**
+   - Claude generates code suggestions formatted as GitHub suggested changes
+   - Developers can review and apply with one click
+   - Safest approach but limited to smaller changes
+
+2. **Two-step Approval (Priority 2)**
+   - Claude proposes changes in a comment
+   - Developer must explicitly approve with a follow-up command
+   - Only then are changes committed and pushed
+   - Example: "claude-approve: [reference ID]"
+
+3. **Draft PR Approach (Priority 3)**
+   - Create a separate branch with Claude's changes
+   - Open a draft PR against the original PR branch
+   - Completely isolates changes for review
+
+4. **Special Command Prefix (Priority 4)**
+   - Regular comments: "claude: [question]" → just get a response
+   - For changes: "claude-fix: [request]" → makes and commits changes
+   - Clear differentiation of intent
+
 ## Future Features
 
-- Code change functionality (planned)
 - Additional modes for different types of Claude integration
 - Support for custom prompts and templates

README.md

@@ -1,37 +1,42 @@
 # Claude Code GitHub Action
 
-This GitHub Action integrates Claude Code in your GitHub workflows, enabling AI-assisted code reviews and responses to PR comments.
+This GitHub Action integrates Claude Code in your GitHub workflows, enabling AI-assisted code reviews, suggestions, and responses to PR comments.
 
 ## Features
 
-- Process PR comments prefixed with "claude:"
+- Process PR comments prefixed with "claude:" for general analysis
+- Process PR comments prefixed with "claude-suggest:" for clickable code suggestions
 - Provide rich context about the PR to Claude, including file diffs
 - Get AI-powered code analysis and suggestions
+- Create GitHub-compatible suggested changes that can be applied with one click
 - Simple setup with minimal configuration
 - Uses GitHub CLI and Claude Code CLI for reliability
 
 ## Usage
 
-Create a workflow file that responds to comments containing the "claude:" prefix:
+Create a workflow file (`.github/workflows/claude-code.yml`) that responds to comments with the appropriate prefixes:
 
 ```yaml
 name: Claude Code Integration
 
 on:
   issue_comment:
     types: [created]
-  pull_request_review_comment:
-    types: [created]
 
 jobs:
-  process-pr-comment:
+  process-pr-review:
     runs-on: ubuntu-latest
     if: ${{ github.event_name == 'issue_comment' && github.event.issue.pull_request && startsWith(github.event.comment.body, 'claude:') }}
     permissions:
       contents: read
       pull-requests: write
       issues: write
     steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
       - name: Get PR details
         id: pr
         run: |
@@ -43,60 +48,114 @@ jobs:
           echo "feedback=$FEEDBACK" >> $GITHUB_OUTPUT
       
       - name: Process with Claude Code
-        uses: fractureinc/claude-code-github-action@v0.1.7
+        uses: fractureinc/claude-code-github-action@v0.2.0
         with:
           mode: 'review'
           pr-number: ${{ steps.pr.outputs.number }}
           feedback: ${{ steps.pr.outputs.feedback }}
           anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
           github-token: ${{ secrets.GITHUB_TOKEN }}
+
+  process-pr-suggestions:
+    runs-on: ubuntu-latest
+    if: ${{ github.event_name == 'issue_comment' && github.event.issue.pull_request && startsWith(github.event.comment.body, 'claude-suggest:') }}
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Get PR details
+        id: pr
+        run: |
+          PR_NUMBER="${{ github.event.issue.number }}"
+          FEEDBACK="${{ github.event.comment.body }}"
+          # Remove the "claude-suggest:" prefix
+          FEEDBACK="${FEEDBACK#claude-suggest:}"
+          echo "number=$PR_NUMBER" >> $GITHUB_OUTPUT
+          echo "feedback=$FEEDBACK" >> $GITHUB_OUTPUT
+      
+      - name: Process with Claude Code Suggestions
+        uses: fractureinc/claude-code-github-action@v0.2.0
+        with:
+          mode: 'suggest'
+          pr-number: ${{ steps.pr.outputs.number }}
+          feedback: ${{ steps.pr.outputs.feedback }}
+          anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
 ```
 
 ## Configuration
 
 | Input | Description | Required | Default |
 |-------|-------------|----------|---------|
-| `mode` | Operation mode (review or direct) | Yes | `review` |
+| `mode` | Operation mode (review, suggest, direct) | Yes | `review` |
 | `pr-number` | Pull request number | Yes* | |
 | `feedback` | User query text | Yes | |
 | `anthropic-api-key` | Anthropic API key | Yes | |
 | `github-token` | GitHub token | Yes | |
 | `output-file` | Output file path (for direct mode) | No | `claude-code-output` |
 
-\* Required when mode is 'review'
+\* Required when mode is 'review' or 'suggest'
 
 ## Enhanced Context for Claude
 
-With version 0.1.7, Claude now receives complete context for your PRs, including:
+With version 0.2.0, Claude now receives complete context for your PRs, including:
 
 - PR metadata (title, description, branch info)
 - List of all files changed
 - Complete diff of all changes in the PR
 - Repository information
+- Full repository checkout for improved code understanding
 
-This allows Claude to provide much more accurate and helpful responses about your code changes.
+## Available Modes
+
+### Review Mode (`mode: 'review'`)
+
+Standard mode that provides Claude's analysis and feedback about your PR changes as a comment.
+
+### Suggest Mode (`mode: 'suggest'`)
+
+Creates GitHub-compatible suggested changes that can be applied with one click directly from the PR interface.
+
+### Direct Mode (`mode: 'direct'`)
+
+Sends a query directly to Claude and saves the response to a file without PR context.
 
 ## Example Queries
 
-Here are some example queries you can use with the claude: prefix:
+### Review Mode Examples (prefix: `claude:`)
 
 - `claude: Explain the changes in this PR`
 - `claude: Can you suggest improvements to the code?`
 - `claude: Are there any security issues in these changes?`
 - `claude: How would you refactor this to be more maintainable?`
 - `claude: What tests should be added for this code?`
 
+### Suggest Mode Examples (prefix: `claude-suggest:`)
+
+- `claude-suggest: Improve error handling in the API client`
+- `claude-suggest: Fix any potential memory leaks`
+- `claude-suggest: Optimize the database query on line 25`
+- `claude-suggest: Make this code more readable`
+
 ## How It Works
 
-1. The action is triggered when a comment starting with "claude:" is detected on a PR
+1. The action is triggered when a comment with the appropriate prefix is detected on a PR
 2. The action extracts the PR number and the user's query
-3. Using GitHub CLI, the action fetches comprehensive information about the PR including:
+3. The repository is checked out to provide full code context
+4. Using GitHub CLI, the action fetches comprehensive information about the PR including:
    - PR metadata
    - List of files changed  
    - Complete diff of all changes
-4. This rich context is provided to Claude along with the user's query
-5. Claude processes the information and provides a helpful response
-6. The response is posted as a comment on the PR
+5. This rich context is provided to Claude along with the user's query
+6. Claude processes the information and provides a helpful response
+7. For review mode: The response is posted as a comment on the PR
+8. For suggest mode: Claude formats responses as GitHub suggested changes that can be applied with one click
 
 ## Permissions
 

action.yml

@@ -6,7 +6,7 @@ branding:
 
 inputs:
   mode:
-    description: 'The mode to run the action in (review, pr-comment, comment, direct)'
+    description: 'The mode to run the action in (review, pr-comment, suggest, direct)'
     required: true
     default: 'review'
   pr-number:
@@ -29,6 +29,9 @@ inputs:
 runs:
   using: 'composite'
   steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      
     - name: Setup GitHub CLI
       shell: bash
       run: |
@@ -41,101 +44,23 @@ runs:
         # Install Claude Code CLI
         npm install -g @anthropic-ai/claude-code
         
-    - name: Process PR comment with Claude
+    - name: Process Review Request
       if: inputs.mode == 'review' || inputs.mode == 'pr-comment'
       shell: bash
       run: |
-        # Set Anthropic API key
-        export ANTHROPIC_API_KEY="${{ inputs.anthropic-api-key }}"
+        chmod +x ${{ github.action_path }}/scripts/review-mode.sh
+        ${{ github.action_path }}/scripts/review-mode.sh "${{ inputs.pr-number }}" "${{ inputs.feedback }}" "${{ inputs.anthropic-api-key }}" "${{ inputs.github-token }}"
         
-        # Create a temp file for Claude's response
-        RESPONSE_FILE=$(mktemp)
-        
-        # Get PR details using GitHub CLI
-        echo "Fetching PR details for PR #${{ inputs.pr-number }}"
-        PR_DETAILS=$(gh pr view ${{ inputs.pr-number }} --json title,body,baseRefName,headRefName,additions,deletions,changedFiles,state)
-        
-        PR_TITLE=$(echo "$PR_DETAILS" | jq -r '.title')
-        PR_BODY=$(echo "$PR_DETAILS" | jq -r '.body')
-        PR_BASE=$(echo "$PR_DETAILS" | jq -r '.baseRefName')
-        PR_HEAD=$(echo "$PR_DETAILS" | jq -r '.headRefName')
-        PR_STATE=$(echo "$PR_DETAILS" | jq -r '.state')
-        PR_ADDITIONS=$(echo "$PR_DETAILS" | jq -r '.additions')
-        PR_DELETIONS=$(echo "$PR_DETAILS" | jq -r '.deletions')
-        PR_CHANGED_FILES=$(echo "$PR_DETAILS" | jq -r '.changedFiles')
-        
-        # Get list of files changed
-        echo "Fetching files changed in the PR"
-        PR_FILES=$(gh pr view ${{ inputs.pr-number }} --json files)
-        
-        # Get file content diffs
-        echo "Fetching file content diffs"
-        PR_DIFF=$(gh pr diff ${{ inputs.pr-number }})
-        
-        # Get summary of files changed for the PR metadata
-        FILES_LIST=$(echo "$PR_FILES" | jq -r '.files[] | "- " + .path + " (" + .status + ", +" + (.additions | tostring) + "/-" + (.deletions | tostring) + ")"')
-        
-        # Get repo information
-        REPO_INFO=$(gh repo view --json name,description,defaultBranchRef,languages)
-        REPO_NAME=$(echo "$REPO_INFO" | jq -r '.name')
-        REPO_DESC=$(echo "$REPO_INFO" | jq -r '.description')
-        REPO_DEFAULT_BRANCH=$(echo "$REPO_INFO" | jq -r '.defaultBranchRef.name')
-        REPO_LANGUAGES=$(echo "$REPO_INFO" | jq -r '.languages[].name' | tr '\n' ', ' | sed 's/,$//')
-        
-        # Build the prompt with rich context
-        PROMPT=$(cat <<EOF
-        You are Claude, an AI assistant helping with code review in GitHub.
-        
-        Repository: $REPO_NAME
-        Repository Description: ${REPO_DESC:-No description provided}
-        Default Branch: $REPO_DEFAULT_BRANCH
-        Languages: ${REPO_LANGUAGES:-Unknown}
-        
-        Pull Request #${{ inputs.pr-number }}: $PR_TITLE
-        PR Description:
-        ${PR_BODY:-No description provided}
-        
-        PR Status: $PR_STATE
-        Branch: $PR_HEAD → $PR_BASE
-        Changes: +$PR_ADDITIONS/-$PR_DELETIONS in $PR_CHANGED_FILES files
-        
-        Files changed in this PR:
-        $FILES_LIST
-        
-        Diff of changes:
-        \`\`\`diff
-        $PR_DIFF
-        \`\`\`
-        
-        User query:
-        ${{ inputs.feedback }}
-        
-        Provide a helpful, clear and concise response to this query in the context of this PR. Focus on giving accurate, actionable advice or explanations based on the code changes shown in the diff. Include code examples when appropriate.
-        EOF
-        )
-        
-        # Run Claude CLI
-        echo "Sending request to Claude..."
-        echo "$PROMPT" | claude -p - > "$RESPONSE_FILE"
-        
-        # Post response as PR comment
-        echo "Posting Claude's response as PR comment"
-        gh pr comment ${{ inputs.pr-number }} --body-file "$RESPONSE_FILE"
-        
-        # Clean up
-        rm -f "$RESPONSE_FILE"
-        
-        echo "Claude's response posted successfully!"
+    - name: Process Suggested Changes
+      if: inputs.mode == 'suggest'
+      shell: bash
+      run: |
+        chmod +x ${{ github.action_path }}/scripts/suggest-mode.sh
+        ${{ github.action_path }}/scripts/suggest-mode.sh "${{ inputs.pr-number }}" "${{ inputs.feedback }}" "${{ inputs.anthropic-api-key }}" "${{ inputs.github-token }}"
         
-    - name: Process direct request with Claude
+    - name: Process Direct Request
       if: inputs.mode == 'direct'
       shell: bash
       run: |
-        # Set Anthropic API key
-        export ANTHROPIC_API_KEY="${{ inputs.anthropic-api-key }}"
-        
-        # Run Claude CLI and capture output
-        echo "Sending request to Claude..."
-        echo "${{ inputs.feedback }}" | claude -p - > "${{ inputs.output-file }}"
-        
-        echo "Claude's response written to ${{ inputs.output-file }}"
+        chmod +x ${{ github.action_path }}/scripts/direct-mode.sh
+        ${{ github.action_path }}/scripts/direct-mode.sh "${{ inputs.feedback }}" "${{ inputs.anthropic-api-key }}" "${{ inputs.output-file }}"

package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-code-github-action",
-  "version": "0.1.7",
-  "description": "GitHub action for Claude Code Integration in PR comments and reviews",
+  "version": "0.2.0",
+  "description": "GitHub action for Claude Code Integration in PR comments, reviews and code suggestions",
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -18,7 +18,8 @@
     "anthropic",
     "ai",
     "review",
-    "pull-request"
+    "pull-request",
+    "suggestions"
   ],
   "author": "Fracture Inc",
   "license": "MIT",

scripts/direct-mode.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+set -e
+
+# Get input parameters
+FEEDBACK=$1
+ANTHROPIC_API_KEY=$2
+OUTPUT_FILE=$3
+
+# Set Anthropic API key
+export ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY"
+
+# Run Claude CLI and capture output
+echo "Sending request to Claude..."
+echo "$FEEDBACK" | claude -p - > "$OUTPUT_FILE"
+
+echo "Claude's response written to $OUTPUT_FILE"