devflow-kit 0.1.0

package/src/claude/commands/devflow/pre-pr.md

@@ -0,0 +1,286 @@
+---
+description: Comprehensive branch review using specialized sub-agents for PR readiness
+allowed-tools: Task, Bash, Read, Write, Grep, Glob
+---
+
+## Your Task
+
+Perform a comprehensive review of this entire feature branch by orchestrating multiple specialized sub-agents in parallel. This is designed for thorough analysis before creating pull requests or merging branches.
+
+### Step 1: Analyze Branch Changes
+
+First, determine the branch and base for comparison:
+
+```bash
+# Get current branch
+CURRENT_BRANCH=$(git branch --show-current)
+if [ -z "$CURRENT_BRANCH" ]; then
+    echo "❌ Not on a branch (detached HEAD). Checkout a feature branch first."
+    exit 1
+fi
+
+# Determine base branch (main, master, or develop)
+BASE_BRANCH=""
+for branch in main master develop; do
+    if git show-ref --verify --quiet refs/heads/$branch; then
+        BASE_BRANCH=$branch
+        break
+    fi
+done
+
+if [ -z "$BASE_BRANCH" ]; then
+    echo "❌ Could not find base branch (main/master/develop). Specify manually."
+    exit 1
+fi
+
+echo "=== BRANCH REVIEW SCOPE ==="
+echo "Current branch: $CURRENT_BRANCH"
+echo "Base branch: $BASE_BRANCH"
+echo ""
+
+# Check if there are changes to review
+if git diff --quiet $BASE_BRANCH...HEAD; then
+    echo "No changes between $BASE_BRANCH and $CURRENT_BRANCH"
+    exit 0
+fi
+
+# Show comprehensive change summary
+echo "=== CHANGES TO REVIEW ==="
+git diff --stat $BASE_BRANCH...HEAD
+echo ""
+echo "=== COMMIT HISTORY ==="
+git log --oneline $BASE_BRANCH..HEAD
+echo ""
+```
+
+### Step 2: Launch Specialized Sub-Agents in Parallel
+
+Launch these sub-agents in parallel:
+
+1. audit-security sub-agent
+2. audit-performance sub-agent
+3. audit-architecture sub-agent
+4. audit-tests sub-agent
+5. audit-complexity sub-agent
+6. audit-dependencies sub-agent
+
+### Step 3: Synthesize Comprehensive Review
+
+After all sub-agents complete their analysis:
+
+1. **Collect Results**: Gather findings from all 6 specialized sub-agents
+2. **Cross-Reference Issues**: Identify overlapping concerns between domains
+3. **Prioritize for PR**: Focus on merge-blocking vs nice-to-have improvements
+4. **Create PR-Ready Review**: Structure for easy consumption by human reviewers
+
+### Step 4: Save Comprehensive Review Document
+
+Create a detailed review document at `.docs/reviews/branch-{BRANCH_NAME}-{YYYY-MM-DD_HHMM}.md`:
+
+```markdown
+# Branch Review - {BRANCH_NAME}
+**Date**: {current_date}
+**Time**: {current_time}
+**Type**: Branch Review (PR Readiness Assessment)
+**Branch**: {CURRENT_BRANCH}
+**Base**: {BASE_BRANCH}
+**Reviewer**: AI Sub-Agent Orchestra
+
+---
+
+## 📊 Branch Overview
+
+**Commits**: {commit_count} commits
+**Files Changed**: {files_changed}
+**Lines Added**: {lines_added}
+**Lines Removed**: {lines_removed}
+**Review Duration**: {duration}
+
+### Change Categories
+- 🎯 **Features**: {feature_changes}
+- 🐛 **Bug Fixes**: {bug_fixes}
+- 🔧 **Refactoring**: {refactoring}
+- 📚 **Documentation**: {doc_changes}
+- 🧪 **Tests**: {test_changes}
+
+---
+
+## 🎯 PR Readiness Assessment
+
+### 🚦 MERGE RECOMMENDATION
+**Status**: {✅ READY TO MERGE | ⚠️ ISSUES TO ADDRESS | 🚫 NOT READY}
+
+**Confidence Level**: {High/Medium/Low}
+
+### Blocking Issues (Must Fix Before Merge)
+- 🔴 {critical_issue_1} in {file:line}
+- 🔴 {critical_issue_2} in {file:line}
+
+### High Priority (Should Fix Before Merge)
+- 🟠 {high_issue_1} in {file:line}
+- 🟠 {high_issue_2} in {file:line}
+
+---
+
+## 🔍 Detailed Sub-Agent Analysis
+
+### 🔒 Security Analysis (audit-security)
+**Risk Level**: {Low/Medium/High/Critical}
+
+#### Security Issues Found
+{detailed security findings with file:line references}
+
+#### Security Recommendations
+{specific security improvements needed}
+
+### ⚡ Performance Analysis (audit-performance)
+**Performance Impact**: {Positive/Neutral/Negative}
+
+#### Performance Issues Found
+{detailed performance findings with optimizations}
+
+#### Performance Recommendations
+{specific performance improvements}
+
+### 🏗️ Architecture Analysis (audit-architecture)
+**Architecture Quality**: {Excellent/Good/Acceptable/Poor}
+
+#### Architectural Issues Found
+{detailed architecture findings and design concerns}
+
+#### Architecture Recommendations
+{specific architectural improvements}
+
+### 🧪 Test Coverage Analysis (audit-tests)
+**Coverage Assessment**: {Excellent/Good/Adequate/Insufficient}
+
+#### Testing Issues Found
+{detailed test coverage gaps and quality issues}
+
+#### Testing Recommendations
+{specific tests that should be added}
+
+### 🧠 Complexity Analysis (audit-complexity)
+**Maintainability Score**: {Excellent/Good/Acceptable/Poor}
+
+#### Complexity Issues Found
+{detailed complexity and maintainability concerns}
+
+#### Complexity Recommendations
+{specific refactoring suggestions}
+
+### 📦 Dependency Analysis (audit-dependencies)
+**Dependency Health**: {Excellent/Good/Acceptable/Poor}
+
+#### Dependency Issues Found
+{detailed dependency concerns and security issues}
+
+#### Dependency Recommendations
+{specific dependency management improvements}
+
+---
+
+## 🎯 Action Plan
+
+### Pre-Merge Checklist (Blocking)
+- [ ] {blocking_action_1} - {estimated_effort}
+- [ ] {blocking_action_2} - {estimated_effort}
+- [ ] {blocking_action_3} - {estimated_effort}
+
+### Post-Merge Improvements (Non-Blocking)
+- [ ] {improvement_1} - {estimated_effort}
+- [ ] {improvement_2} - {estimated_effort}
+- [ ] {improvement_3} - {estimated_effort}
+
+### Follow-Up Tasks
+- [ ] {followup_1}
+- [ ] {followup_2}
+
+---
+
+## 📈 Quality Metrics
+
+### Code Quality Score: {score}/10
+
+**Breakdown**:
+- Security: {score}/10
+- Performance: {score}/10
+- Architecture: {score}/10
+- Test Coverage: {score}/10
+- Maintainability: {score}/10
+- Dependencies: {score}/10
+
+### Comparison to {BASE_BRANCH}
+- Quality Trend: {Improving/Stable/Declining}
+- Technical Debt: {Reduced/Neutral/Increased}
+- Test Coverage: {Increased/Maintained/Decreased}
+
+---
+
+## 🔗 Related Resources
+
+### Files Requiring Attention
+- {file1} - {reason}
+- {file2} - {reason}
+- {file3} - {reason}
+
+### Similar Issues in Codebase
+- {related_issue_1} in {location}
+- {related_issue_2} in {location}
+
+### Documentation Updates Needed
+- {doc_update_1}
+- {doc_update_2}
+
+---
+
+## 💡 Reviewer Notes
+
+### Human Review Focus Areas
+Based on sub-agent analysis, human reviewers should focus on:
+1. {focus_area_1} - {reason}
+2. {focus_area_2} - {reason}
+3. {focus_area_3} - {reason}
+
+### Discussion Points
+- {discussion_point_1}
+- {discussion_point_2}
+- {discussion_point_3}
+
+---
+
+*Comprehensive review generated by DevFlow sub-agent orchestration*
+*Next: Address blocking issues, then create PR with this review as reference*
+```
+
+### Step 5: Provide Executive Summary
+
+Give the developer a clear, actionable summary:
+
+```
+🔍 BRANCH REVIEW COMPLETE: {BRANCH_NAME}
+
+📊 ANALYSIS SUMMARY:
+- Files analyzed: {X} files, {Y} commits
+- Issues found: {Critical} critical, {High} high, {Medium} medium, {Low} low
+- Review confidence: {High/Medium/Low}
+
+🚦 PR READINESS: {✅ READY | ⚠️ ISSUES TO ADDRESS | 🚫 NOT READY}
+
+🎯 CRITICAL ACTIONS BEFORE MERGE:
+1. {Most critical blocking issue}
+2. {Second most critical blocking issue}
+3. {Third most critical blocking issue}
+
+⚡ QUICK WINS:
+- {Easy fix 1} ({estimated time})
+- {Easy fix 2} ({estimated time})
+
+📄 Full review: .docs/reviews/branch-{branch}-{timestamp}.md
+
+🔄 NEXT STEPS:
+1. Address blocking issues above
+2. Run `/pre-commit` after fixes to verify
+3. Create PR using this review as reference
+4. Share review with team for human review focus
+```

package/src/claude/scripts/statusline.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# Claude Code Status Line Script
+# Receives JSON input via stdin with session context
+
+# Read JSON input
+INPUT=$(cat)
+
+# Parse values using jq (with fallbacks if jq is not available or fields are missing)
+if command -v jq &> /dev/null; then
+    MODEL=$(echo "$INPUT" | jq -r '.model.display_name // .model.id // "claude"' 2>/dev/null)
+    CWD=$(echo "$INPUT" | jq -r '.cwd // "~"' 2>/dev/null)
+    TOTAL_COST=$(echo "$INPUT" | jq -r '.cost.total_cost_usd // 0' 2>/dev/null)
+    LINES_ADDED=$(echo "$INPUT" | jq -r '.cost.total_lines_added // 0' 2>/dev/null)
+    LINES_REMOVED=$(echo "$INPUT" | jq -r '.cost.total_lines_removed // 0' 2>/dev/null)
+    TOTAL_DURATION_MS=$(echo "$INPUT" | jq -r '.cost.total_duration_ms // 0' 2>/dev/null)
+    API_DURATION_MS=$(echo "$INPUT" | jq -r '.cost.total_api_duration_ms // 0' 2>/dev/null)
+    EXCEEDS_200K=$(echo "$INPUT" | jq -r '.exceeds_200k_tokens // false' 2>/dev/null)
+    VERSION=$(echo "$INPUT" | jq -r '.version // ""' 2>/dev/null)
+    OUTPUT_STYLE=$(echo "$INPUT" | jq -r '.output_style.name // ""' 2>/dev/null)
+else
+    MODEL="claude"
+    CWD=$(pwd)
+    TOTAL_COST="0.00"
+    LINES_ADDED="0"
+    LINES_REMOVED="0"
+    TOTAL_DURATION_MS="0"
+    API_DURATION_MS="0"
+    EXCEEDS_200K="false"
+    VERSION=""
+    OUTPUT_STYLE=""
+fi
+
+# Get current directory name
+DIR_NAME=$(basename "$CWD")
+
+# Get git branch and last commit if in a git repo
+GIT_BRANCH=$(cd "$CWD" 2>/dev/null && git branch --show-current 2>/dev/null || echo "")
+if [ -z "$GIT_BRANCH" ]; then
+    GIT_INFO=""
+else
+    # Get last commit message (first line, truncated to 50 chars)
+    LAST_COMMIT_MSG=$(cd "$CWD" 2>/dev/null && git log -1 --pretty=format:"%s" 2>/dev/null | cut -c1-50 || echo "")
+
+    # Check if there are uncommitted changes
+    if [ -n "$(cd "$CWD" 2>/dev/null && git status --porcelain 2>/dev/null)" ]; then
+        GIT_INFO=" / \033[1;33m$GIT_BRANCH*\033[0m"
+    else
+        GIT_INFO=" / \033[1;32m$GIT_BRANCH\033[0m"
+    fi
+
+    # Add commit message if available
+    if [ -n "$LAST_COMMIT_MSG" ]; then
+        GIT_INFO="$GIT_INFO \033[1;90m($LAST_COMMIT_MSG)\033[0m"
+    fi
+fi
+
+# Format cost with 2 decimal places
+COST_FORMATTED=$(printf "%.2f" "$TOTAL_COST" 2>/dev/null || echo "0.00")
+
+# Format session duration from milliseconds to human readable
+format_duration() {
+    local ms=$1
+    local seconds=$((ms / 1000))
+    local minutes=$((seconds / 60))
+    local hours=$((minutes / 60))
+    local remaining_minutes=$((minutes % 60))
+
+    if [ "$hours" -gt 0 ]; then
+        echo "${hours}h${remaining_minutes}m"
+    elif [ "$minutes" -gt 0 ]; then
+        echo "${minutes}m"
+    else
+        echo "${seconds}s"
+    fi
+}
+
+SESSION_DURATION=$(format_duration "$TOTAL_DURATION_MS")
+API_DURATION=$(format_duration "$API_DURATION_MS")
+
+# Calculate API efficiency percentage
+if [ "$TOTAL_DURATION_MS" -gt 0 ]; then
+    API_EFFICIENCY=$(echo "$API_DURATION_MS $TOTAL_DURATION_MS" | awk '{printf "%.0f", ($1/$2)*100}')
+else
+    API_EFFICIENCY="0"
+fi
+
+# Build status line with colors - show components conditionally
+STATUS_LINE="\033[1;34m$DIR_NAME\033[0m$GIT_INFO"
+
+# Add session duration if meaningful
+# if [ "$TOTAL_DURATION_MS" -gt 60000 ]; then  # > 1 minute
+#     STATUS_LINE="$STATUS_LINE \033[1;33m$SESSION_DURATION\033[0m"
+# fi
+
+# Add API efficiency if session is long enough and efficiency is notable
+if [ "$TOTAL_DURATION_MS" -gt 300000 ] && [ "$API_EFFICIENCY" -gt 10 ]; then  # > 5 min and >10% API time
+    STATUS_LINE="$STATUS_LINE \033[1;91mapi:${API_EFFICIENCY}%\033[0m"
+fi
+
+# Add large context warning
+if [ "$EXCEEDS_200K" = "true" ]; then
+    STATUS_LINE="$STATUS_LINE \033[1;93m⚠️large\033[0m"
+fi
+
+# Add cost if non-zero and meaningful (> $0.01)
+COST_CENTS=$(echo "$TOTAL_COST" | awk '{printf "%.0f", $1*100}')
+if [ "$COST_CENTS" -gt 1 ]; then
+    STATUS_LINE="$STATUS_LINE \033[1;32m\$$COST_FORMATTED\033[0m"
+fi
+
+# Add model at the end
+# STATUS_LINE="$STATUS_LINE \033[1;36m$MODEL\033[0m"
+
+echo -e "$STATUS_LINE"

package/src/claude/settings.json

@@ -0,0 +1,6 @@
+{
+  "statusLine": {
+    "type": "command",
+    "command": "~/.devflow/scripts/statusline.sh"
+  }
+}