@pjmendonca/devflow 1.9.0

package/tooling/scripts/lib/checkpoint-integration.ps1

@@ -0,0 +1,245 @@
+<#
+.SYNOPSIS
+    Checkpoint Integration Library for Windows
+
+.DESCRIPTION
+    Functions to integrate context checkpointing into existing automation workflows.
+    PowerShell equivalent of checkpoint-integration.sh for Windows compatibility.
+
+.NOTES
+    Version: 1.0.0
+    Requires: PowerShell 5.1+, Python 3.9+
+#>
+
+#Requires -Version 5.1
+
+# Script paths
+$script:ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$script:ProjectRoot = (Get-Item "$script:ScriptDir\..\..\.." -ErrorAction SilentlyContinue).FullName
+if (-not $script:ProjectRoot) {
+    $script:ProjectRoot = (Get-Location).Path
+}
+$script:CheckpointScript = Join-Path $script:ProjectRoot "tooling\scripts\context_checkpoint.py"
+$script:CheckpointDir = Join-Path $script:ProjectRoot "tooling\.automation\checkpoints"
+
+#region Checkpoint Monitor Functions
+
+function Start-CheckpointMonitor {
+    <#
+    .SYNOPSIS
+        Start checkpoint monitor in background
+    #>
+    param(
+        [Parameter(Mandatory=$true)]
+        [string]$LogFile,
+
+        [string]$SessionId = "auto"
+    )
+
+    if (-not (Test-Path $script:CheckpointScript)) {
+        Write-Host "!! Checkpoint script not found, skipping monitoring" -ForegroundColor Yellow
+        return $null
+    }
+
+    Write-Host "[i] Starting context checkpoint monitor..." -ForegroundColor Blue
+    Write-Host "   Watching: $LogFile" -ForegroundColor Gray
+
+    # Start monitor as background job
+    $job = Start-Job -ScriptBlock {
+        param($script, $logFile, $sessionId)
+        python $script --watch-log $logFile --session-id $sessionId
+    } -ArgumentList $script:CheckpointScript, $LogFile, $SessionId
+
+    # Save PID to file
+    $pidFile = "$LogFile.checkpoint.pid"
+    $job.Id | Out-File -FilePath $pidFile -Force
+
+    Write-Host "[OK] Checkpoint monitor started (Job ID: $($job.Id))" -ForegroundColor Green
+    return $job.Id
+}
+
+function Stop-CheckpointMonitor {
+    <#
+    .SYNOPSIS
+        Stop checkpoint monitor by PID file
+    #>
+    param(
+        [Parameter(Mandatory=$true)]
+        [string]$LogFile
+    )
+
+    $pidFile = "$LogFile.checkpoint.pid"
+
+    if (Test-Path $pidFile) {
+        $jobId = Get-Content $pidFile -Raw
+        $jobId = $jobId.Trim()
+
+        $job = Get-Job -Id $jobId -ErrorAction SilentlyContinue
+        if ($job) {
+            Write-Host "[i] Stopping checkpoint monitor (Job ID: $jobId)" -ForegroundColor Blue
+            Stop-Job -Id $jobId -ErrorAction SilentlyContinue
+            Remove-Job -Id $jobId -Force -ErrorAction SilentlyContinue
+            Write-Host "[OK] Checkpoint monitor stopped" -ForegroundColor Green
+        }
+
+        Remove-Item $pidFile -Force -ErrorAction SilentlyContinue
+    }
+}
+
+#endregion
+
+#region Checkpoint Management Functions
+
+function New-StoryCheckpoint {
+    <#
+    .SYNOPSIS
+        Create manual checkpoint with context
+    #>
+    param(
+        [Parameter(Mandatory=$true)]
+        [string]$StoryKey,
+
+        [string]$Reason = "manual"
+    )
+
+    Write-Host "[i] Creating checkpoint for story: $StoryKey" -ForegroundColor Blue
+
+    $result = python $script:CheckpointScript --checkpoint --session-id $StoryKey 2>&1
+    Write-Host $result
+
+    return $LASTEXITCODE
+}
+
+function Test-HasCheckpoint {
+    <#
+    .SYNOPSIS
+        Check if checkpoint exists for story
+    #>
+    param(
+        [Parameter(Mandatory=$true)]
+        [string]$StoryKey
+    )
+
+    $checkpoints = Get-ChildItem -Path $script:CheckpointDir -Filter "*$StoryKey*.json" -ErrorAction SilentlyContinue
+
+    return ($null -ne $checkpoints -and $checkpoints.Count -gt 0)
+}
+
+function Get-LatestCheckpoint {
+    <#
+    .SYNOPSIS
+        Get latest checkpoint for story
+    #>
+    param(
+        [Parameter(Mandatory=$true)]
+        [string]$StoryKey
+    )
+
+    $checkpoints = Get-ChildItem -Path $script:CheckpointDir -Filter "*$StoryKey*.json" -ErrorAction SilentlyContinue |
+        Sort-Object LastWriteTime -Descending |
+        Select-Object -First 1
+
+    if ($checkpoints) {
+        return $checkpoints.FullName
+    }
+    return $null
+}
+
+function Resume-FromCheckpoint {
+    <#
+    .SYNOPSIS
+        Resume from latest checkpoint
+    #>
+    param(
+        [Parameter(Mandatory=$true)]
+        [string]$StoryKey
+    )
+
+    $checkpointFile = Get-LatestCheckpoint -StoryKey $StoryKey
+
+    if (-not $checkpointFile) {
+        Write-Host "X No checkpoint found for story: $StoryKey" -ForegroundColor Red
+        return 1
+    }
+
+    $checkpointId = [System.IO.Path]::GetFileNameWithoutExtension($checkpointFile)
+
+    Write-Host "[i] Resuming from checkpoint: $checkpointId" -ForegroundColor Blue
+
+    python $script:CheckpointScript --resume $checkpointId
+
+    return $LASTEXITCODE
+}
+
+function Remove-OldCheckpoints {
+    <#
+    .SYNOPSIS
+        Clean up old checkpoints (keep last N)
+    #>
+    param(
+        [int]$KeepCount = 10
+    )
+
+    Write-Host "[i] Cleaning up old checkpoints (keeping last $KeepCount)..." -ForegroundColor Blue
+
+    $checkpoints = Get-ChildItem -Path $script:CheckpointDir -Filter "checkpoint_*.json" -ErrorAction SilentlyContinue |
+        Sort-Object LastWriteTime -Descending
+
+    if (-not $checkpoints -or $checkpoints.Count -le $KeepCount) {
+        Write-Host "[OK] No cleanup needed ($($checkpoints.Count) checkpoints)" -ForegroundColor Green
+        return
+    }
+
+    $toDelete = $checkpoints | Select-Object -Skip $KeepCount
+    $deleteCount = $toDelete.Count
+
+    foreach ($file in $toDelete) {
+        $summaryFile = $file.FullName -replace '\.json$', '_summary.md'
+        Remove-Item $file.FullName -Force -ErrorAction SilentlyContinue
+        Remove-Item $summaryFile -Force -ErrorAction SilentlyContinue
+    }
+
+    Write-Host "[OK] Deleted $deleteCount old checkpoints" -ForegroundColor Green
+}
+
+#endregion
+
+#region Logging Functions
+
+function Write-CheckpointInfo {
+    <#
+    .SYNOPSIS
+        Add checkpoint info to log
+    #>
+    param(
+        [Parameter(Mandatory=$true)]
+        [string]$LogFile
+    )
+
+    $info = @"
+
+===============================================================
+  CONTEXT CHECKPOINT MONITORING ACTIVE
+===============================================================
+
+Thresholds:
+  * Warning:   75% - Log notification
+  !! Critical:  85% - Auto-checkpoint created
+  XX Emergency: 95% - Force checkpoint + alert
+
+Checkpoint directory: $script:CheckpointDir
+
+To manually checkpoint: python tooling\scripts\context_checkpoint.py --checkpoint
+To list checkpoints:    python tooling\scripts\context_checkpoint.py --list
+
+===============================================================
+
+"@
+
+    Add-Content -Path $LogFile -Value $info
+}
+
+#endregion
+
+# Export functions
+Export-ModuleMember -Function * -ErrorAction SilentlyContinue

package/tooling/scripts/lib/checkpoint-integration.sh

@@ -0,0 +1,191 @@
+#!/usr/bin/env bash
+################################################################################
+# Checkpoint Integration Library
+#
+# Functions to integrate context checkpointing into existing automation workflows
+################################################################################
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CHECKPOINT_SCRIPT="$PROJECT_ROOT/tooling/scripts/context_checkpoint.py"
+CHECKPOINT_DIR="$PROJECT_ROOT/tooling/.automation/checkpoints"
+
+################################################################################
+# Start checkpoint monitor in background
+################################################################################
+start_checkpoint_monitor() {
+    local log_file="$1"
+    local session_id="${2:-auto}"
+
+    if [[ ! -f "$CHECKPOINT_SCRIPT" ]]; then
+        echo "⚠️  Checkpoint script not found, skipping monitoring"
+        return 1
+    fi
+
+    echo "🔍 Starting context checkpoint monitor..."
+    echo "   Watching: $log_file"
+
+    # Start monitor in background
+    python3 "$CHECKPOINT_SCRIPT" \
+        --watch-log "$log_file" \
+        --session-id "$session_id" \
+        2>&1 > /dev/null &
+
+    local monitor_pid=$!
+    echo "$monitor_pid" > "${log_file}.checkpoint.pid"
+
+    echo "✅ Checkpoint monitor started (PID: $monitor_pid)"
+    return 0
+}
+
+################################################################################
+# Stop checkpoint monitor
+################################################################################
+stop_checkpoint_monitor() {
+    local log_file="$1"
+    local pid_file="${log_file}.checkpoint.pid"
+
+    if [[ -f "$pid_file" ]]; then
+        local pid=$(cat "$pid_file")
+        if kill -0 "$pid" 2>/dev/null; then
+            echo "🛑 Stopping checkpoint monitor (PID: $pid)"
+            kill "$pid" 2>/dev/null || true
+            rm -f "$pid_file"
+            echo "✅ Checkpoint monitor stopped"
+        else
+            rm -f "$pid_file"
+        fi
+    fi
+}
+
+################################################################################
+# Create manual checkpoint with context
+################################################################################
+create_story_checkpoint() {
+    local story_key="$1"
+    local reason="${2:-manual}"
+
+    echo "💾 Creating checkpoint for story: $story_key"
+
+    python3 "$CHECKPOINT_SCRIPT" \
+        --checkpoint \
+        --session-id "$story_key" \
+        2>&1
+
+    return $?
+}
+
+################################################################################
+# Check if checkpoint exists for story
+################################################################################
+has_checkpoint() {
+    local story_key="$1"
+
+    local checkpoints=$(find "$CHECKPOINT_DIR" -name "*${story_key}*.json" 2>/dev/null)
+
+    if [[ -n "$checkpoints" ]]; then
+        return 0
+    else
+        return 1
+    fi
+}
+
+################################################################################
+# Get latest checkpoint for story
+################################################################################
+get_latest_checkpoint() {
+    local story_key="$1"
+
+    find "$CHECKPOINT_DIR" -name "*${story_key}*.json" 2>/dev/null | \
+        sort -r | \
+        head -1
+}
+
+################################################################################
+# Resume from latest checkpoint
+################################################################################
+resume_from_checkpoint() {
+    local story_key="$1"
+
+    local checkpoint_file=$(get_latest_checkpoint "$story_key")
+
+    if [[ -z "$checkpoint_file" ]]; then
+        echo "❌ No checkpoint found for story: $story_key"
+        return 1
+    fi
+
+    local checkpoint_id=$(basename "$checkpoint_file" .json)
+
+    echo "📂 Resuming from checkpoint: $checkpoint_id"
+
+    python3 "$CHECKPOINT_SCRIPT" \
+        --resume "$checkpoint_id"
+
+    return $?
+}
+
+################################################################################
+# Clean up old checkpoints (keep last N)
+################################################################################
+cleanup_old_checkpoints() {
+    local keep_count="${1:-10}"
+
+    echo "🧹 Cleaning up old checkpoints (keeping last $keep_count)..."
+
+    local checkpoints=$(find "$CHECKPOINT_DIR" -name "checkpoint_*.json" | sort -r)
+    local total=$(echo "$checkpoints" | wc -l | tr -d ' ')
+
+    if [[ $total -le $keep_count ]]; then
+        echo "✅ No cleanup needed ($total checkpoints)"
+        return 0
+    fi
+
+    local to_delete=$(echo "$checkpoints" | tail -n +$((keep_count + 1)))
+    local delete_count=$(echo "$to_delete" | wc -l | tr -d ' ')
+
+    echo "$to_delete" | while read -r file; do
+        local summary_file="${file%.json}_summary.md"
+        rm -f "$file" "$summary_file"
+    done
+
+    echo "✅ Deleted $delete_count old checkpoints"
+}
+
+################################################################################
+# Add checkpoint info to log
+################################################################################
+log_checkpoint_info() {
+    local log_file="$1"
+
+    cat >> "$log_file" <<EOF
+
+═══════════════════════════════════════════════════════════════
+  CONTEXT CHECKPOINT MONITORING ACTIVE
+═══════════════════════════════════════════════════════════════
+
+Thresholds:
+  ⚡ Warning:   75% - Log notification
+  ⚠️  Critical:  85% - Auto-checkpoint created
+  🚨 Emergency: 95% - Force checkpoint + alert
+
+Checkpoint directory: $CHECKPOINT_DIR
+
+To manually checkpoint: ./tooling/scripts/checkpoint --checkpoint
+To list checkpoints:    ./tooling/scripts/checkpoint --list
+
+═══════════════════════════════════════════════════════════════
+
+EOF
+}
+
+################################################################################
+# Export functions
+################################################################################
+export -f start_checkpoint_monitor
+export -f stop_checkpoint_monitor
+export -f create_story_checkpoint
+export -f has_checkpoint
+export -f get_latest_checkpoint
+export -f resume_from_checkpoint
+export -f cleanup_old_checkpoints
+export -f log_checkpoint_info