codeharness 0.26.4 → 0.27.0

package/ralph/bridge.sh

@@ -1,424 +0,0 @@
-#!/usr/bin/env bash
-# bridge.sh — BMAD→Ralph Task Bridge
-# Converts BMAD epics/stories to Ralph execution tasks with verification requirements.
-# Produces ralph/progress.json consumed by ralph.sh loop.
-#
-# Usage:
-#   ralph/bridge.sh --epics PATH --output PATH [--sprint-status PATH]
-#   ralph/bridge.sh --tasks PATH --output PATH   (standalone mode)
-
-set -e
-
-# ─── CLI Arguments ────────────────────────────────────────────────────────
-
-EPICS_FILE=""
-SPRINT_STATUS_FILE=""
-TASKS_FILE=""
-OUTPUT_FILE=""
-
-show_help() {
-    cat << 'HELPEOF'
-BMAD→Ralph Task Bridge — converts stories to execution tasks
-
-Usage:
-    ralph/bridge.sh --epics PATH --output PATH [OPTIONS]
-    ralph/bridge.sh --tasks PATH --output PATH   (standalone mode)
-
-BMAD Mode:
-    --epics PATH            Path to BMAD epics.md file
-    --sprint-status PATH    Path to sprint-status.yaml (optional, maps story states)
-    --output PATH           Output path for progress.json
-
-Standalone Mode:
-    --tasks PATH            Path to markdown checklist or plain text task list
-    --output PATH           Output path for progress.json
-
-Options:
-    -h, --help              Show this help message
-
-The bridge parses BMAD stories and produces ralph/progress.json with:
-  - Story ID, title, epic, description, acceptance criteria
-  - Verification requirements (proof path, observability)
-  - Task status mapped from sprint status (or default: pending)
-HELPEOF
-}
-
-# ─── Parse Arguments ──────────────────────────────────────────────────────
-
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        -h|--help)
-            show_help
-            exit 0
-            ;;
-        --epics)
-            EPICS_FILE="$2"
-            shift 2
-            ;;
-        --sprint-status)
-            SPRINT_STATUS_FILE="$2"
-            shift 2
-            ;;
-        --tasks)
-            TASKS_FILE="$2"
-            shift 2
-            ;;
-        --output)
-            OUTPUT_FILE="$2"
-            shift 2
-            ;;
-        *)
-            echo "Unknown option: $1" >&2
-            show_help
-            exit 1
-            ;;
-    esac
-done
-
-# ─── Validation ───────────────────────────────────────────────────────────
-
-if [[ -z "$OUTPUT_FILE" ]]; then
-    echo "Error: --output is required" >&2
-    exit 1
-fi
-
-if [[ -z "$EPICS_FILE" && -z "$TASKS_FILE" ]]; then
-    echo "Error: either --epics or --tasks is required" >&2
-    exit 1
-fi
-
-if [[ -n "$EPICS_FILE" && ! -f "$EPICS_FILE" ]]; then
-    echo "Error: epics file not found: $EPICS_FILE" >&2
-    exit 1
-fi
-
-if [[ -n "$TASKS_FILE" && ! -f "$TASKS_FILE" ]]; then
-    echo "Error: tasks file not found: $TASKS_FILE" >&2
-    exit 1
-fi
-
-# ─── Sprint Status Parsing ────────────────────────────────────────────────
-
-# Parse sprint status YAML into a newline-delimited key=value store
-# Maps story slug (e.g., "1-1-login-page") to status
-SPRINT_STATUSES=""
-
-parse_sprint_status() {
-    local file="$1"
-    if [[ ! -f "$file" ]]; then
-        return
-    fi
-
-    local in_dev_status=false
-    while IFS= read -r line; do
-        # Detect development_status section
-        if [[ "$line" =~ ^development_status: ]]; then
-            in_dev_status=true
-            continue
-        fi
-
-        # Exit section on non-indented line
-        if [[ "$in_dev_status" == "true" && -n "$line" && ! "$line" =~ ^[[:space:]] ]]; then
-            in_dev_status=false
-            continue
-        fi
-
-        if [[ "$in_dev_status" == "true" ]]; then
-            # Parse "  key: value" lines
-            local key value
-            key=$(echo "$line" | sed 's/^[[:space:]]*//' | cut -d: -f1 | sed 's/[[:space:]]*$//')
-            value=$(echo "$line" | cut -d: -f2- | sed 's/^[[:space:]]*//')
-
-            if [[ -n "$key" && -n "$value" ]]; then
-                # Extract story number from slug: "1-1-login-page" -> "1.1"
-                if [[ "$key" =~ ^([0-9]+)-([0-9]+) ]]; then
-                    local story_id="${BASH_REMATCH[1]}.${BASH_REMATCH[2]}"
-                    SPRINT_STATUSES="${SPRINT_STATUSES}${story_id}=${value}
-"
-                fi
-            fi
-        fi
-    done < "$file"
-}
-
-# Map BMAD status to Ralph task status
-map_status() {
-    local bmad_status="$1"
-    case "$bmad_status" in
-        done)         echo "complete" ;;
-        in-progress)  echo "in_progress" ;;
-        review)       echo "in_progress" ;;
-        ready-for-dev|backlog|"")  echo "pending" ;;
-        *)            echo "pending" ;;
-    esac
-}
-
-# ─── BMAD Epics Parsing ──────────────────────────────────────────────────
-
-parse_epics() {
-    local epics_file="$1"
-    local output_file="$2"
-
-    # Load sprint status if provided
-    if [[ -n "$SPRINT_STATUS_FILE" ]]; then
-        parse_sprint_status "$SPRINT_STATUS_FILE"
-    fi
-
-    local tasks_json="[]"
-    local current_epic=""
-    local current_story_id=""
-    local current_story_title=""
-    local current_description=""
-    local current_ac=""
-    local in_story=false
-    local in_ac=false
-    local in_description=false
-
-    # Flush the current story into tasks_json
-    flush_story() {
-        if [[ -z "$current_story_id" ]]; then
-            return
-        fi
-
-        # Determine status from sprint status or default to pending
-        local status="pending"
-        local _sprint_val
-        _sprint_val=$(echo "$SPRINT_STATUSES" | grep "^${current_story_id}=" | head -1 | cut -d= -f2-)
-        if [[ -n "$_sprint_val" ]]; then
-            status=$(map_status "$_sprint_val")
-        fi
-
-        # Clean up description
-        current_description=$(echo "$current_description" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-
-        # Build acceptance criteria array from collected lines
-        local ac_array="[]"
-        if [[ -n "$current_ac" ]]; then
-            ac_array=$(echo "$current_ac" | while IFS= read -r ac_line; do
-                ac_line=$(echo "$ac_line" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-                if [[ -n "$ac_line" ]]; then
-                    echo "$ac_line"
-                fi
-            done | jq -R '[inputs]' 2>/dev/null || echo '[]')
-            # Handle case where jq gets no input
-            if [[ -z "$ac_array" || "$ac_array" == "null" ]]; then
-                ac_array="[]"
-            fi
-        fi
-
-        # Build task JSON
-        local task
-        task=$(jq -n \
-            --arg id "$current_story_id" \
-            --arg title "$current_story_title" \
-            --arg epic "$current_epic" \
-            --arg description "$current_description" \
-            --arg status "$status" \
-            --argjson acceptance_criteria "$ac_array" \
-            --arg proof_path "verification/${current_story_id}-proof.md" \
-            '{
-                id: $id,
-                title: $title,
-                epic: $epic,
-                description: $description,
-                status: $status,
-                acceptance_criteria: $acceptance_criteria,
-                verification: {
-                    proof_path: $proof_path,
-                    observability: {
-                        query_logs: true,
-                        check_traces: true
-                    },
-                    showboat: {
-                        required: true,
-                        template: "templates/showboat-template.md"
-                    }
-                }
-            }')
-
-        tasks_json=$(echo "$tasks_json" | jq --argjson task "$task" '. += [$task]')
-
-        # Reset
-        current_story_id=""
-        current_story_title=""
-        current_description=""
-        current_ac=""
-        in_story=false
-        in_ac=false
-        in_description=false
-    }
-
-    while IFS= read -r line; do
-        # Detect epic headers: ## Epic N: Title
-        if [[ "$line" =~ ^##[[:space:]]+Epic[[:space:]]+([0-9]+):[[:space:]]*(.*) ]]; then
-            flush_story
-            current_epic="Epic ${BASH_REMATCH[1]}: ${BASH_REMATCH[2]}"
-            continue
-        fi
-
-        # Detect story headers: ### Story N.M: Title
-        if [[ "$line" =~ ^###[[:space:]]+Story[[:space:]]+([0-9]+\.[0-9]+):[[:space:]]*(.*) ]]; then
-            flush_story
-            current_story_id="${BASH_REMATCH[1]}"
-            current_story_title="${BASH_REMATCH[2]}"
-            in_story=true
-            in_description=true
-            in_ac=false
-            continue
-        fi
-
-        # Skip if not in a story
-        if [[ "$in_story" != "true" ]]; then
-            continue
-        fi
-
-        # Detect acceptance criteria section
-        if [[ "$line" =~ ^\*\*Acceptance[[:space:]]+Criteria ]]; then
-            in_description=false
-            in_ac=true
-            continue
-        fi
-
-        # Collect description (user story lines: As a / I want / So that)
-        if [[ "$in_description" == "true" ]]; then
-            if [[ "$line" =~ ^(As[[:space:]]a|I[[:space:]]want|So[[:space:]]that) ]]; then
-                if [[ -n "$current_description" ]]; then
-                    current_description+=" "
-                fi
-                current_description+="$line"
-            fi
-            continue
-        fi
-
-        # Collect acceptance criteria lines
-        if [[ "$in_ac" == "true" ]]; then
-            # **Given**, **When**, **Then**, **And** lines
-            if [[ "$line" =~ ^\*\*(Given|When|Then|And)\*\*[[:space:]]*(.*) ]]; then
-                local keyword="${BASH_REMATCH[1]}"
-                local rest="${BASH_REMATCH[2]}"
-                current_ac+="${keyword} ${rest}"$'\n'
-            fi
-            continue
-        fi
-    done < "$epics_file"
-
-    # Flush last story
-    flush_story
-
-    # Build final output
-    local generated_at
-    generated_at=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-    jq -n \
-        --arg generated_at "$generated_at" \
-        --arg source "$epics_file" \
-        --argjson tasks "$tasks_json" \
-        '{
-            generated_at: $generated_at,
-            source: $source,
-            tasks: $tasks
-        }' > "$output_file"
-}
-
-# ─── Standalone Tasks Parsing ─────────────────────────────────────────────
-
-parse_standalone_tasks() {
-    local tasks_file="$1"
-    local output_file="$2"
-
-    local tasks_json="[]"
-    local task_num=0
-
-    while IFS= read -r line; do
-        # Skip empty lines
-        [[ -z "$line" ]] && continue
-
-        # Parse markdown checklist: - [ ] or - [x]
-        if [[ "$line" =~ ^[[:space:]]*-[[:space:]]+\[([[:space:]xX])\][[:space:]]+(.*) ]]; then
-            task_num=$((task_num + 1))
-            local check="${BASH_REMATCH[1]}"
-            local title="${BASH_REMATCH[2]}"
-            local status="pending"
-            if [[ "$check" == "x" || "$check" == "X" ]]; then
-                status="complete"
-            fi
-
-            local task
-            task=$(jq -n \
-                --arg id "T-$(printf '%03d' $task_num)" \
-                --arg title "$title" \
-                --arg status "$status" \
-                '{
-                    id: $id,
-                    title: $title,
-                    epic: "Standalone",
-                    description: $title,
-                    status: $status,
-                    acceptance_criteria: [],
-                    verification: {
-                        proof_path: ("verification/" + $id + "-proof.md"),
-                        observability: { query_logs: true, check_traces: true },
-                        showboat: { required: true, template: "templates/showboat-template.md" }
-                    }
-                }')
-
-            tasks_json=$(echo "$tasks_json" | jq --argjson task "$task" '. += [$task]')
-            continue
-        fi
-
-        # Plain text: one task per non-empty line
-        if [[ ! "$line" =~ ^[[:space:]]*# ]]; then
-            task_num=$((task_num + 1))
-            local title
-            title=$(echo "$line" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-
-            if [[ -n "$title" ]]; then
-                local task
-                task=$(jq -n \
-                    --arg id "T-$(printf '%03d' $task_num)" \
-                    --arg title "$title" \
-                    --arg status "pending" \
-                    '{
-                        id: $id,
-                        title: $title,
-                        epic: "Standalone",
-                        description: $title,
-                        status: $status,
-                        acceptance_criteria: [],
-                        verification: {
-                            proof_path: ("verification/" + $id + "-proof.md"),
-                            observability: { query_logs: true, check_traces: true },
-                            showboat: { required: true, template: "templates/showboat-template.md" }
-                        }
-                    }')
-
-                tasks_json=$(echo "$tasks_json" | jq --argjson task "$task" '. += [$task]')
-            fi
-        fi
-    done < "$tasks_file"
-
-    local generated_at
-    generated_at=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-    jq -n \
-        --arg generated_at "$generated_at" \
-        --arg source "$tasks_file" \
-        --argjson tasks "$tasks_json" \
-        '{
-            generated_at: $generated_at,
-            source: $source,
-            tasks: $tasks
-        }' > "$output_file"
-}
-
-# ─── Main ─────────────────────────────────────────────────────────────────
-
-mkdir -p "$(dirname "$OUTPUT_FILE")"
-
-if [[ -n "$EPICS_FILE" ]]; then
-    parse_epics "$EPICS_FILE" "$OUTPUT_FILE"
-elif [[ -n "$TASKS_FILE" ]]; then
-    parse_standalone_tasks "$TASKS_FILE" "$OUTPUT_FILE"
-fi
-
-echo "[OK] Bridge: $(jq '.tasks | length' "$OUTPUT_FILE") tasks generated → $OUTPUT_FILE"

package/ralph/db_schema_gen.sh

@@ -1,109 +0,0 @@
-#!/usr/bin/env bash
-# db_schema_gen.sh — Generate docs/generated/db-schema.md from schema JSON
-# Schema JSON can come from DB MCP queries or be provided directly.
-#
-# Usage: ralph/db_schema_gen.sh --project-dir DIR --schema-file PATH
-
-set -e
-
-PROJECT_DIR=""
-SCHEMA_FILE=""
-
-show_help() {
-    cat << 'HELPEOF'
-DB Schema Generator — create db-schema.md from schema data
-
-Usage:
-    ralph/db_schema_gen.sh --project-dir DIR --schema-file PATH
-
-The schema file should be JSON with this structure:
-    {"tables": [{"name": "...", "columns": [{"name": "...", "type": "...", ...}]}]}
-
-Options:
-    --project-dir DIR     Project root directory
-    --schema-file PATH    Path to schema JSON file (from DB MCP or manual)
-    -h, --help            Show this help message
-HELPEOF
-}
-
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        -h|--help)
-            show_help
-            exit 0
-            ;;
-        --project-dir)
-            PROJECT_DIR="$2"
-            shift 2
-            ;;
-        --schema-file)
-            SCHEMA_FILE="$2"
-            shift 2
-            ;;
-        *)
-            echo "Unknown option: $1" >&2
-            exit 1
-            ;;
-    esac
-done
-
-if [[ -z "$PROJECT_DIR" ]]; then
-    echo "Error: --project-dir is required" >&2
-    exit 1
-fi
-
-if [[ -z "$SCHEMA_FILE" ]]; then
-    echo "Error: --schema-file is required" >&2
-    exit 1
-fi
-
-if [[ ! -f "$SCHEMA_FILE" ]]; then
-    echo "Error: schema file not found: $SCHEMA_FILE" >&2
-    exit 1
-fi
-
-# ─── Generate ─────────────────────────────────────────────────────────────
-
-OUTPUT_FILE="$PROJECT_DIR/docs/generated/db-schema.md"
-mkdir -p "$(dirname "$OUTPUT_FILE")"
-
-timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-table_count=$(jq '.tables | length' "$SCHEMA_FILE")
-
-{
-    echo "<!-- DO NOT EDIT MANUALLY — generated by db_schema_gen.sh -->"
-    echo ""
-    echo "# Database Schema"
-    echo ""
-    echo "**Generated:** $timestamp"
-    echo "**Tables:** $table_count"
-    echo ""
-
-    for ((i=0; i<table_count; i++)); do
-        table_name=$(jq -r ".tables[$i].name" "$SCHEMA_FILE")
-        echo "## $table_name"
-        echo ""
-        echo "| Column | Type | Nullable | Key | References |"
-        echo "|--------|------|----------|-----|------------|"
-
-        col_count=$(jq ".tables[$i].columns | length" "$SCHEMA_FILE")
-        for ((j=0; j<col_count; j++)); do
-            col_name=$(jq -r ".tables[$i].columns[$j].name" "$SCHEMA_FILE")
-            col_type=$(jq -r ".tables[$i].columns[$j].type" "$SCHEMA_FILE")
-            nullable=$(jq -r ".tables[$i].columns[$j].nullable // true" "$SCHEMA_FILE")
-            pk=$(jq -r ".tables[$i].columns[$j].primary_key // false" "$SCHEMA_FILE")
-            refs=$(jq -r ".tables[$i].columns[$j].references // \"-\"" "$SCHEMA_FILE")
-
-            nullable_text="YES"
-            [[ "$nullable" == "false" ]] && nullable_text="NO"
-
-            key_text="-"
-            [[ "$pk" == "true" ]] && key_text="PK"
-
-            echo "| $col_name | $col_type | $nullable_text | $key_text | $refs |"
-        done
-        echo ""
-    done
-} > "$OUTPUT_FILE"
-
-echo "[OK] DB schema: $table_count tables → $OUTPUT_FILE"

package/ralph/drivers/claude-code.sh

@@ -1,140 +0,0 @@
-#!/usr/bin/env bash
-# Claude Code driver for codeharness Ralph loop
-# Handles instance lifecycle: spawn, monitor, terminate
-# Each iteration gets a fresh Claude Code instance with the codeharness plugin
-
-# Driver identification
-driver_name() {
-    echo "claude-code"
-}
-
-driver_display_name() {
-    echo "Claude Code"
-}
-
-driver_cli_binary() {
-    echo "claude"
-}
-
-driver_min_version() {
-    echo "2.0.76"
-}
-
-# Check if the CLI binary is available
-driver_check_available() {
-    command -v "$(driver_cli_binary)" &>/dev/null
-}
-
-# Valid tool patterns for --allowedTools validation
-driver_valid_tools() {
-    VALID_TOOL_PATTERNS=(
-        "Write"
-        "Read"
-        "Edit"
-        "MultiEdit"
-        "Glob"
-        "Grep"
-        "Task"
-        "TodoWrite"
-        "WebFetch"
-        "WebSearch"
-        "Bash"
-        "Bash(git *)"
-        "Bash(npm *)"
-        "Bash(npx *)"
-        "Bash(bats *)"
-        "Bash(python *)"
-        "Bash(node *)"
-        "Bash(showboat *)"
-        "Bash(codeharness *)"
-        "NotebookEdit"
-        "Skill"
-        "Agent"
-        "ToolSearch"
-    )
-}
-
-# Build the CLI command arguments
-# Populates global CLAUDE_CMD_ARGS array
-# Parameters:
-#   $1 - prompt_file: path to the prompt file
-#   $2 - loop_context: context string for session continuity
-#   $3 - session_id: session ID for resume (empty for new session)
-#   $4 - plugin_dir: plugin directory (for --plugin-dir flag)
-driver_build_command() {
-    local prompt_file=$1
-    local loop_context=$2
-    local session_id=$3
-    local plugin_dir=${4:-""}
-
-    CLAUDE_CMD_ARGS=("$(driver_cli_binary)")
-
-    if [[ ! -f "$prompt_file" ]]; then
-        echo "ERROR: Prompt file not found: $prompt_file" >&2
-        return 1
-    fi
-
-    # Plugin directory
-    if [[ -n "$plugin_dir" ]]; then
-        CLAUDE_CMD_ARGS+=("--plugin-dir" "$plugin_dir")
-    fi
-
-    # Output format — always stream-json for real-time NDJSON output
-    CLAUDE_CMD_ARGS+=("--output-format" "stream-json" "--verbose" "--include-partial-messages")
-
-    # Allowed tools
-    if [[ -n "$CLAUDE_ALLOWED_TOOLS" ]]; then
-        CLAUDE_CMD_ARGS+=("--allowedTools")
-        local IFS=','
-        read -ra tools_array <<< "$CLAUDE_ALLOWED_TOOLS"
-        for tool in "${tools_array[@]}"; do
-            tool=$(echo "$tool" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-            if [[ -n "$tool" ]]; then
-                CLAUDE_CMD_ARGS+=("$tool")
-            fi
-        done
-    fi
-
-    # Session resume
-    if [[ "$CLAUDE_USE_CONTINUE" == "true" && -n "$session_id" ]]; then
-        CLAUDE_CMD_ARGS+=("--resume" "$session_id")
-    fi
-
-    # Loop context as system prompt
-    if [[ -n "$loop_context" ]]; then
-        CLAUDE_CMD_ARGS+=("--append-system-prompt" "$loop_context")
-    fi
-
-    # Prompt content
-    local prompt_content
-    prompt_content=$(cat "$prompt_file")
-    CLAUDE_CMD_ARGS+=("-p" "$prompt_content")
-}
-
-# Whether this driver supports session continuity
-driver_supports_sessions() {
-    return 0
-}
-
-# Claude Code supports stream-json live output
-driver_supports_live_output() {
-    return 0
-}
-
-# Stream filter for raw Claude stream-json events
-driver_stream_filter() {
-    echo '
-        if .type == "stream_event" then
-            if .event.type == "content_block_delta" and .event.delta.type == "text_delta" then
-                .event.delta.text
-            elif .event.type == "content_block_start" and .event.content_block.type == "tool_use" then
-                "\n\n⚡ [" + .event.content_block.name + "]\n"
-            elif .event.type == "content_block_stop" then
-                "\n"
-            else
-                empty
-            end
-        else
-            empty
-        end'
-}