@nlaprell/shipit 1.0.0

package/scripts/kill-intent.sh

@@ -0,0 +1,125 @@
+#!/bin/bash
+
+# Kill Intent Script
+# Marks an intent as killed and records rationale
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/intent.sh
+[ -f "$SCRIPT_DIR/lib/intent.sh" ] && source "$SCRIPT_DIR/lib/intent.sh"
+
+INTENT_ID="${1:-}"
+if [ -z "$INTENT_ID" ]; then
+    error_exit "Usage: ./scripts/kill-intent.sh <intent-id> [reason]" 1
+fi
+
+REASON="${2:-No reason provided}"
+INTENT_FILE="$(require_intent_file "$INTENT_ID")"
+DATE_UTC="$(date -u +"%Y-%m-%d")"
+
+TEMP_FILE="$(mktemp)"
+
+awk -v status_value="killed" '
+    BEGIN { in_status=0; replaced=0 }
+    /^## Status/ {
+        print;
+        in_status=1;
+        next;
+    }
+    in_status && /^## / {
+        if (!replaced) {
+            print status_value;
+            replaced=1;
+        }
+        in_status=0;
+        print;
+        next;
+    }
+    in_status {
+        if ($0 ~ /[^[:space:]]/ && !replaced) {
+            print status_value;
+            replaced=1;
+        }
+        next;
+    }
+    { print }
+    END {
+        if (in_status && !replaced) {
+            print status_value;
+        }
+    }
+' "$INTENT_FILE" > "$TEMP_FILE"
+
+mv "$TEMP_FILE" "$INTENT_FILE"
+
+# Handle Kill Rationale section - replace entire section if it exists, create if it doesn't
+TEMP_FILE2="$(mktemp)"
+awk -v reason="$REASON" -v date="$DATE_UTC" '
+    BEGIN { in_section=0; section_written=0 }
+    /^## Kill Rationale/ {
+        in_section=1;
+        section_written=1;
+        print "";
+        print "## Kill Rationale";
+        print "- Kill criterion: (unspecified)";
+        print "- Reason: " reason;
+        print "- Date: " date;
+        next;
+    }
+    in_section && /^## / {
+        # Hit next section, stop skipping
+        in_section=0;
+        print;
+        next;
+    }
+    in_section {
+        # Skip all lines in the Kill Rationale section (we already wrote the replacement)
+        next;
+    }
+    { print }
+    END {
+        if (!section_written) {
+            print "";
+            print "## Kill Rationale";
+            print "- Kill criterion: (unspecified)";
+            print "- Reason: " reason;
+            print "- Date: " date;
+        }
+    }
+' "$INTENT_FILE" > "$TEMP_FILE2"
+
+mv "$TEMP_FILE2" "$INTENT_FILE"
+
+# Remove intent from active list (flat active.md); support multi-intent layout
+ACTIVE_FILE="work/workflow-state/active.md"
+if [ -f "$ACTIVE_FILE" ]; then
+    ACTIVE_TEMP="$(mktemp)"
+    # 1) Drop lines in "## Active intents" that start with this intent_id
+    # 2) If **Intent ID:** is this intent, set to none and set Status/Phase to idle/none
+    awk -v id="$INTENT_ID" '
+        /^## Active intents/ { in_section=1; print; next }
+        in_section && /^[FBT]-[0-9]+[[:space:]]*\|/ {
+            if ($0 !~ "^" id "[[:space:]]*\\|") print
+            next
+        }
+        in_section { in_section=0 }
+        /^\*\*Intent ID:\*\* / {
+            if ($0 == "**Intent ID:** " id) { killed_single=1; print "**Intent ID:** none"; next }
+            print; next
+        }
+        killed_single && /^\*\*Status:\*\* / { print "**Status:** idle"; killed_single=0; next }
+        killed_single && /^\*\*Current Phase:\*\* / { print "**Current Phase:** none"; killed_single=0; next }
+        { print }
+    ' "$ACTIVE_FILE" > "$ACTIVE_TEMP"
+    # Legacy: if file had **Intent ID:** intent (no newline exact match), sed fallback
+    if grep -q "^\*\*Intent ID:\*\* $INTENT_ID" "$ACTIVE_FILE"; then
+        sed -e "s/^\*\*Intent ID:\*\* $INTENT_ID/**Intent ID:** none/" \
+            -e "s/^\*\*Status:\*\* .*/**Status:** idle/" \
+            -e "s/^\*\*Current Phase:\*\* .*/**Current Phase:** none/" \
+            "$ACTIVE_TEMP" > "${ACTIVE_TEMP}.2" && mv "${ACTIVE_TEMP}.2" "$ACTIVE_TEMP"
+    fi
+    mv "$ACTIVE_TEMP" "$ACTIVE_FILE"
+fi
+
+echo "✓ Marked $INTENT_ID as killed"

package/scripts/lib/common.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+
+# Common script plumbing: error handling, colors, optional require_* helpers.
+# Source this from scripts that need consistent exit behavior and colors.
+# For intent resolution, source intent.sh instead (it sources this).
+# Caller script should already use set -euo pipefail.
+
+error_exit() {
+    echo "ERROR: $1" >&2
+    exit "${2:-1}"
+}
+
+# Colors (safe to use in echo -e)
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Optional: require a command to be present. Usage: require_cmd node jq git
+require_cmd() {
+    local cmd
+    for cmd in "$@"; do
+        if ! command -v "$cmd" >/dev/null 2>&1; then
+            error_exit "$cmd is required but not installed" 1
+        fi
+    done
+}

package/scripts/lib/intent.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+
+# Intent domain helpers: resolve intent file path, require intent file.
+# Sources common.sh. Use this in scripts that work with intent IDs (e.g. workflow-orchestrator, kill-intent).
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=common.sh
+[ -f "$SCRIPT_DIR/common.sh" ] && source "$SCRIPT_DIR/common.sh"
+
+INTENT_DIR="${INTENT_DIR:-work/intent}"
+
+# Resolve an intent ID (e.g. F-042) or path to the actual intent file path.
+# Outputs the path; returns 0 if found, 1 if not. Use with require_intent_file to exit on failure.
+resolve_intent_file() {
+    local intent_id="$1"
+
+    if [ -f "$intent_id" ]; then
+        echo "$intent_id"
+        return 0
+    fi
+
+    local candidates=(
+        "work/intent/$intent_id.md"
+        "work/intent/features/$intent_id.md"
+        "work/intent/bugs/$intent_id.md"
+        "work/intent/tech-debt/$intent_id.md"
+    )
+
+    local candidate
+    for candidate in "${candidates[@]}"; do
+        if [ -f "$candidate" ]; then
+            echo "$candidate"
+            return 0
+        fi
+    done
+
+    local matches=()
+    shopt -s nullglob
+    matches=( work/intent/*/"$intent_id".md )
+    shopt -u nullglob
+
+    if [ "${#matches[@]}" -eq 1 ]; then
+        echo "${matches[0]}"
+        return 0
+    fi
+
+    if [ "${#matches[@]}" -gt 1 ]; then
+        error_exit "Multiple intent files found for $intent_id: ${matches[*]}" 1
+    fi
+
+    return 1
+}
+
+# Resolve intent and exit with error if not found. Sets INTENT_FILE in caller.
+# Usage: INTENT_FILE="$(require_intent_file "$INTENT_ID")"
+require_intent_file() {
+    local intent_id="$1"
+    local path
+    path="$(resolve_intent_file "$intent_id")" || error_exit "Intent file not found for id '$intent_id' (looked under work/intent/ and work/intent/*/)" 1
+    echo "$path"
+}

package/scripts/lib/progress.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+
+# Progress Indicator Library
+# Provides functions to display progress for long-running operations
+
+set -euo pipefail
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Show phase progress
+# Usage: show_phase_progress phase_num total_phases phase_name status
+# Status: "running", "complete", "pending"
+show_phase_progress() {
+    local phase_num="$1"
+    local total_phases="$2"
+    local phase_name="$3"
+    local status="${4:-running}"
+    
+    case "$status" in
+        complete)
+            echo -e "[Phase $phase_num/$total_phases] $phase_name... ${GREEN}✓${NC}"
+            ;;
+        running)
+            echo -e "[Phase $phase_num/$total_phases] $phase_name... ${YELLOW}⏳${NC}"
+            ;;
+        pending)
+            echo -e "[Phase $phase_num/$total_phases] $phase_name... ${CYAN}○${NC}"
+            ;;
+    esac
+}
+
+# Show subtask progress
+# Usage: show_subtask task_num total_tasks task_name
+show_subtask_progress() {
+    local task_num="$1"
+    local total_tasks="$2"
+    local task_name="$3"
+    
+    echo -e "  ${BLUE}→${NC} [$task_num/$total_tasks] $task_name"
+}
+
+# Update progress in place (overwrite same line)
+# Usage: update_progress_line "message"
+update_progress_line() {
+    local message="$1"
+    echo -ne "\r\033[K$message"
+}
+
+# Complete progress line (move to next line)
+complete_progress_line() {
+    echo ""
+}

package/scripts/lib/suggest-next.sh

@@ -0,0 +1,131 @@
+#!/bin/bash
+
+# Next-Step Suggestion Library
+# Provides context-aware suggestions for next commands based on project state
+
+set -euo pipefail
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+INTENT_DIR="${INTENT_DIR:-work/intent}"
+WORKFLOW_DIR="${WORKFLOW_DIR:-workflow-state}"
+
+# Analyze current project state
+analyze_state() {
+    local state=""
+    
+    # Count intents by status
+    local planned=0
+    local active=0
+    local shipped=0
+    
+    if [ -d "$INTENT_DIR" ]; then
+        intent_files=()
+        while IFS= read -r file; do
+            intent_files+=("$file")
+        done < <(find "$INTENT_DIR" -type f -name "*.md" ! -name "_TEMPLATE.md" 2>/dev/null)
+
+        for file in "${intent_files[@]+"${intent_files[@]}"}"; do
+            [ -f "$file" ] || continue
+            
+            local status=$(awk '
+                $0 ~ /^## Status/ {found=1; next}
+                found && $0 ~ /^## / {exit}
+                found && $0 ~ /[^[:space:]]/ {gsub(/^[[:space:]]+|[[:space:]]+$/, "", $0); print tolower($0); exit}
+            ' "$file" 2>/dev/null || echo "planned")
+            
+            case "$status" in
+                planned) planned=$((planned + 1)) ;;
+                active) active=$((active + 1)) ;;
+                shipped) shipped=$((shipped + 1)) ;;
+            esac
+        done
+    fi
+    
+    # Check for active workflow
+    local has_active_workflow=false
+    if [ -f "$WORKFLOW_DIR/active.md" ]; then
+        local active_status=$(grep -E "^\\*\\*Status:\\*\\*" "$WORKFLOW_DIR/active.md" 2>/dev/null | sed 's/.*\*\*Status:\*\* //' | tr -d ' ' || echo "")
+        if [ "$active_status" = "active" ]; then
+            has_active_workflow=true
+        fi
+    fi
+    
+    # Check for release plan
+    local has_release_plan=false
+    if [ -f "work/release/plan.md" ]; then
+        has_release_plan=true
+    fi
+    
+    echo "$planned|$active|$shipped|$has_active_workflow|$has_release_plan"
+}
+
+# Generate suggestions based on state
+suggest_commands() {
+    local state="$1"
+    local planned=$(echo "$state" | cut -d'|' -f1)
+    local active=$(echo "$state" | cut -d'|' -f2)
+    local shipped=$(echo "$state" | cut -d'|' -f3)
+    local has_active_workflow=$(echo "$state" | cut -d'|' -f4)
+    local has_release_plan=$(echo "$state" | cut -d'|' -f5)
+    
+    local suggestions=()
+    
+    # Logic for suggestions
+    if [ "$planned" -eq 0 ] && [ "$active" -eq 0 ]; then
+        # No intents yet
+        suggestions+=("Run /scope-project to break down your project")
+        suggestions+=("Run /new_intent to create your first intent")
+    elif [ "$active" -gt 0 ]; then
+        # Active workflow
+        suggestions+=("Continue workflow for active intent")
+        suggestions+=("Run /status to see current phase")
+    elif [ "$planned" -gt 0 ] && [ "$has_release_plan" = "true" ]; then
+        # Planned intents with release plan
+        # Get first planned intent (more specific pattern to avoid false matches)
+        local first_intent=$(find "$INTENT_DIR" -name "*.md" ! -name "_TEMPLATE.md" -exec awk '
+            $0 ~ /^## Status/ {found=1; next}
+            found && $0 ~ /^## / {exit}
+            found && $0 ~ /^[[:space:]]*planned[[:space:]]*$/ {print FILENAME; exit}
+        ' {} \; 2>/dev/null | head -1)
+        if [ -n "$first_intent" ]; then
+            local intent_id=$(basename "$first_intent" .md)
+            suggestions+=("Run /ship $intent_id to start implementing")
+        fi
+        suggestions+=("Run /new_intent to create another intent")
+        suggestions+=("Edit intents or review release plan")
+    elif [ "$planned" -gt 0 ]; then
+        # Planned intents but no release plan
+        suggestions+=("Run /generate-release-plan to create release plan")
+        suggestions+=("Run /ship <intent-id> to start implementing")
+    elif [ "$has_release_plan" = "true" ]; then
+        # Release plan exists
+        suggestions+=("Run /ship <intent-id> to start implementing")
+        suggestions+=("Run /generate-roadmap to update roadmap")
+    else
+        # Default suggestions
+        suggestions+=("Run /scope-project to break down your project")
+        suggestions+=("Run /new_intent to create an intent")
+    fi
+    
+    # Print suggestions
+    for suggestion in "${suggestions[@]}"; do
+        echo "  💡 $suggestion"
+    done
+}
+
+# Display suggestions after command completion
+display_suggestions() {
+    local context="${1:-}"
+    local state=$(analyze_state)
+    
+    echo ""
+    echo -e "${CYAN}Next steps:${NC}"
+    suggest_commands "$state"
+    echo ""
+}

package/scripts/lib/validate-intents.sh

@@ -0,0 +1,240 @@
+#!/bin/bash
+
+# Intent Validation Library
+# Provides functions to validate intent files for common issues
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+INTENT_DIR="${INTENT_DIR:-work/intent}"
+
+# Parse intent file and return structured data
+parse_intent() {
+    local intent_file="$1"
+    local id=$(basename "$intent_file" .md)
+    
+    # Extract release target
+    local release_target=$(awk '
+        /^## Release Target/ {
+            found=1
+            # Check inline format "## Release Target: R1"
+            if (match($0, /R[0-9]+/)) {
+                print substr($0, RSTART, RLENGTH)
+                exit
+            }
+            next
+        }
+        found && /^## / { exit }
+        found && /R[0-9]+/ {
+            # Skip template lines like "R1 | R2 | R3"
+            if (!/\|/) {
+                match($0, /R[0-9]+/)
+                if (RSTART > 0) {
+                    print substr($0, RSTART, RLENGTH)
+                    exit
+                }
+            }
+        }
+    ' "$intent_file" | head -1)
+    
+    # Extract dependencies (normalize to uppercase, remove whitespace issues)
+    local deps=$(awk '
+        /^## Dependencies/ { found=1; next }
+        found && /^## / { exit }
+        found && /^- / {
+            line=$0
+            sub(/^[[:space:]]*-[[:space:]]*/, "", line)
+            gsub(/^[[:space:]]+|[[:space:]]+$/, "", line)
+            # Skip empty, "(none)", "None", or placeholder brackets
+            if (line == "" || line == "(none)" || tolower(line) ~ /^none/ || line ~ /^\[.*\]$/) next
+            # Extract intent ID (F-001, B-002, etc.)
+            if (match(line, /^[A-Z]-[0-9]+/)) {
+                print toupper(substr(line, RSTART, RLENGTH))
+            }
+        }
+    ' "$intent_file")
+    
+    echo "$id|$release_target|$deps"
+}
+
+# Check dependency ordering conflicts
+# Returns: issue_type|intent_id|message|fix_suggestion
+check_dependency_ordering() {
+    local intent_file="$1"
+    local intent_data=$(parse_intent "$intent_file")
+    local intent_id=$(echo "$intent_data" | cut -d'|' -f1)
+    local release_target=$(echo "$intent_data" | cut -d'|' -f2)
+    local deps=$(echo "$intent_data" | cut -d'|' -f3- | tr ' ' '\n' | grep -v '^$')
+    
+    if [ -z "$release_target" ] || [ -z "$deps" ]; then
+        return 0  # No issue if no release target or dependencies
+    fi
+    
+    # Extract numeric release number, validate format
+    local release_num=$(echo "$release_target" | sed 's/R//')
+    if [ -z "$release_num" ] || ! [[ "$release_num" =~ ^[0-9]+$ ]]; then
+        return 0  # Invalid release format, skip check
+    fi
+    
+    while IFS= read -r dep; do
+        [ -z "$dep" ] && continue
+        
+        local dep_file=$(find "$INTENT_DIR" -type f -name "${dep}.md" -print -quit 2>/dev/null)
+        if [ -z "$dep_file" ] || [ ! -f "$dep_file" ]; then
+            continue  # Missing deps handled separately
+        fi
+        
+        local dep_data=$(parse_intent "$dep_file")
+        local dep_release=$(echo "$dep_data" | cut -d'|' -f2)
+        
+        if [ -z "$dep_release" ]; then
+            continue  # Dependency has no release target
+        fi
+        
+        local dep_release_num=$(echo "$dep_release" | sed 's/R//')
+        if [ -z "$dep_release_num" ] || ! [[ "$dep_release_num" =~ ^[0-9]+$ ]]; then
+            continue  # Invalid release format, skip
+        fi
+        
+        # Issue: dependency is in later release than dependent
+        if [ "$dep_release_num" -gt "$release_num" ]; then
+            echo "dependency_ordering|$intent_id|$intent_id depends on $dep, but $dep is in $dep_release while $intent_id is in $release_target|Move $dep to $release_target or earlier, or move $intent_id to $dep_release or later"
+            return 1
+        fi
+    done <<< "$deps"
+    
+    return 0
+}
+
+# Check whitespace formatting in dependencies
+check_whitespace() {
+    local intent_file="$1"
+    local intent_data=$(parse_intent "$intent_file")
+    local intent_id=$(echo "$intent_data" | cut -d'|' -f1)
+    
+    # Check if dependency lines have leading whitespace
+    if awk '
+        /^## Dependencies/ { found=1; next }
+        found && /^## / { exit }
+        found && /^[[:space:]]+- / {
+            # Line has leading whitespace before "- "
+            exit 1
+        }
+    ' "$intent_file"; then
+        return 0  # No whitespace issues
+    else
+        echo "whitespace|$intent_id|Dependency lines have leading whitespace|Normalize dependency lines to start at column 0"
+        return 1
+    fi
+}
+
+# Check for missing dependencies
+check_missing_dependencies() {
+    local intent_file="$1"
+    local intent_data=$(parse_intent "$intent_file")
+    local intent_id=$(echo "$intent_data" | cut -d'|' -f1)
+    local deps=$(echo "$intent_data" | cut -d'|' -f3- | tr ' ' '\n' | grep -v '^$')
+    
+    local missing=()
+    while IFS= read -r dep; do
+        [ -z "$dep" ] && continue
+        
+        local dep_file=$(find "$INTENT_DIR" -type f -name "${dep}.md" -print -quit 2>/dev/null)
+        if [ -z "$dep_file" ] || [ ! -f "$dep_file" ]; then
+            missing+=("$dep")
+        fi
+    done <<< "$deps"
+    
+    if [ ${#missing[@]} -gt 0 ]; then
+        local missing_list=$(IFS=','; echo "${missing[*]}")
+        echo "missing_dependency|$intent_id|Missing dependencies: $missing_list|Create intent files for missing dependencies or remove from dependency list"
+        return 1
+    fi
+    
+    return 0
+}
+
+# Check for circular dependencies (simple check - direct cycles only)
+check_circular_dependencies() {
+    local intent_file="$1"
+    local intent_data=$(parse_intent "$intent_file")
+    local intent_id=$(echo "$intent_data" | cut -d'|' -f1)
+    local deps=$(echo "$intent_data" | cut -d'|' -f3- | tr ' ' '\n' | grep -v '^$')
+    
+    while IFS= read -r dep; do
+        [ -z "$dep" ] && continue
+        
+        local dep_file=$(find "$INTENT_DIR" -type f -name "${dep}.md" -print -quit 2>/dev/null)
+        if [ -z "$dep_file" ] || [ ! -f "$dep_file" ]; then
+            continue
+        fi
+        
+        local dep_data=$(parse_intent "$dep_file")
+        local dep_deps=$(echo "$dep_data" | cut -d'|' -f3- | tr ' ' '\n' | grep -v '^$')
+        
+        # Check if dependency depends back on this intent
+        if echo "$dep_deps" | grep -q "^$intent_id$"; then
+            echo "circular|$intent_id|Circular dependency detected: $intent_id <-> $dep|Remove circular dependency from either $intent_id or $dep"
+            return 1
+        fi
+    done <<< "$deps"
+    
+    return 0
+}
+
+# Run all validations on an intent file
+# Returns: list of issues (one per line) in format: issue_type|intent_id|message|fix_suggestion
+validate_intent() {
+    local intent_file="$1"
+    local issues=()
+    
+    # Run all checks
+    local ordering_issue=$(check_dependency_ordering "$intent_file" || true)
+    local whitespace_issue=$(check_whitespace "$intent_file" || true)
+    local missing_issue=$(check_missing_dependencies "$intent_file" || true)
+    local circular_issue=$(check_circular_dependencies "$intent_file" || true)
+    
+    # Collect all issues
+    [ -n "$ordering_issue" ] && issues+=("$ordering_issue")
+    [ -n "$whitespace_issue" ] && issues+=("$whitespace_issue")
+    [ -n "$missing_issue" ] && issues+=("$missing_issue")
+    [ -n "$circular_issue" ] && issues+=("$circular_issue")
+    
+    # Print all issues (one per line)
+    for issue in "${issues[@]}"; do
+        echo "$issue"
+    done
+    
+    return ${#issues[@]}  # Return number of issues
+}
+
+# Validate all intents
+validate_all_intents() {
+    local total_issues=0
+    local intent_files=()
+    
+    # Find all intent files recursively
+    intent_files=()
+    while IFS= read -r file; do
+        intent_files+=("$file")
+    done < <(find "$INTENT_DIR" -type f -name "*.md" ! -name "_TEMPLATE.md" 2>/dev/null)
+    
+    if [ ${#intent_files[@]} -eq 0 ]; then
+        return 0
+    fi
+    
+    # Validate each intent
+    for intent_file in "${intent_files[@]}"; do
+        validate_intent "$intent_file" || {
+            local count=$?
+            total_issues=$((total_issues + count))
+        }
+    done
+    
+    return $total_issues
+}