pumuki-ast-hooks 5.5.19 → 5.5.21

package/README.md

@@ -1065,6 +1065,21 @@ For coding standards, see [CODE_STANDARDS.md](./docs/CODE_STANDARDS.md).
 
 ## 📝 Recent Changes
 
+### Version 5.5.20 (2026-01-04)
+
+**🐛 Bug Fixes:**
+- Restored comprehensive session context report on IDE startup
+- Fixed evidence age calculation for ISO 8601 timestamps with timezone offsets
+- Removed `exec "$SHELL"` that caused infinite loop on macOS
+- Added Python-based timestamp parsing for reliable timezone conversion
+
+**🔧 Improvements:**
+- Session loader now displays branch, recent commits, session context, violations summary, and evidence freshness
+- Added quick commands section for user convenience
+- Violations summary now reads from `ast-summary.json` with severity breakdown
+
+---
+
 ### Version 5.5.16 (2026-01-04)
 
 **✨ New Features:**

package/bin/session-loader.sh

@@ -1,25 +1,123 @@
 #!/bin/bash
-# AST Session Loader
-# Runs on IDE startup to initialize AST hooks and check tokens
+# AST Session Loader v5.5.20
+# Runs on IDE startup to initialize AST hooks, show context and check tokens
 REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
 
-# Run token tracker to warn about approaching limits
+# Colors
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+MAGENTA='\033[0;35m'
+NC='\033[0m'
+
+# Files
+EVIDENCE_FILE="$REPO_ROOT/.AI_EVIDENCE.json"
+SESSION_FILE="$REPO_ROOT/.AI_SESSION_START.md"
+TOKEN_STATUS="$REPO_ROOT/.audit_tmp/token-status.txt"
+VIOLATIONS_REPORT="$REPO_ROOT/.audit_tmp/intelligent-report.txt"
+
+# Run token tracker first
 TOKEN_TRACKER="$REPO_ROOT/scripts/hooks-system/infrastructure/watchdog/token-tracker.sh"
 if [ -f "$TOKEN_TRACKER" ]; then
     bash "$TOKEN_TRACKER"
 fi
 
-# Display AST hooks status
-echo "🚀 AST Intelligence Hooks v5.5.18"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+# Banner
 echo ""
-echo "✅ AST Hooks loaded successfully"
-echo "📁 Repository: $REPO_ROOT"
-echo "🤖 AI Gate: Active"
-echo "🔍 Evidence Monitoring: Active"
+echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║         🤖 AST Intelligence Hooks v5.5.20                ║${NC}"
+echo -e "${BLUE}║         Workspace Opened - Loading Context...            ║${NC}"
+echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+# Current branch
+CURRENT_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
+echo -e "${CYAN}📍 Current Branch: ${MAGENTA}$CURRENT_BRANCH${NC}"
 echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Recent commits
+echo -e "${CYAN}📝 Recent Commits:${NC}"
+git log --oneline -3 2>/dev/null | sed 's/^/   /' || echo "   No commits yet"
 echo ""
-echo "💡 Tip: Run 'ai-start' to initialize AI context for your current branch"
-echo "💡 Tip: Run 'bash scripts/hooks-system/infrastructure/shell/orchestrators/audit-orchestrator.sh' for full audit"
+
+# Session context from evidence
+if [[ -f "$EVIDENCE_FILE" ]]; then
+    CURRENT_SESSION_ID=$(jq -r '.session_id // empty' "$EVIDENCE_FILE" 2>/dev/null || echo "")
+    CURRENT_ACTION=$(jq -r '.action // empty' "$EVIDENCE_FILE" 2>/dev/null || echo "")
+    if [[ -n "$CURRENT_SESSION_ID" && "$CURRENT_SESSION_ID" != "null" ]]; then
+        echo -e "${CYAN}📖 Session Context:${NC}"
+        if [[ -n "$CURRENT_ACTION" && "$CURRENT_ACTION" != "null" ]]; then
+            echo "   Session: $CURRENT_SESSION_ID - $CURRENT_ACTION"
+        else
+            echo "   Session: $CURRENT_SESSION_ID"
+        fi
+        echo ""
+    fi
+fi
+
+# Top violations from last audit
+if [[ -f "$VIOLATIONS_REPORT" ]]; then
+    echo -e "${CYAN}🎯 Top Violations (last audit):${NC}"
+    grep -E "CRITICAL|HIGH|MEDIUM|LOW" "$VIOLATIONS_REPORT" 2>/dev/null | head -5 | sed 's/^/   /' || echo "   No violations found"
+    echo ""
+elif [[ -f "$REPO_ROOT/.audit_tmp/ast-summary.json" ]]; then
+    echo -e "${CYAN}🎯 Violations Summary:${NC}"
+    CRITICAL=$(jq -r '.levels.CRITICAL // 0' "$REPO_ROOT/.audit_tmp/ast-summary.json" 2>/dev/null || echo "0")
+    HIGH=$(jq -r '.levels.HIGH // 0' "$REPO_ROOT/.audit_tmp/ast-summary.json" 2>/dev/null || echo "0")
+    MEDIUM=$(jq -r '.levels.MEDIUM // 0' "$REPO_ROOT/.audit_tmp/ast-summary.json" 2>/dev/null || echo "0")
+    LOW=$(jq -r '.levels.LOW // 0' "$REPO_ROOT/.audit_tmp/ast-summary.json" 2>/dev/null || echo "0")
+    echo "   🔴 CRITICAL: $CRITICAL  🟠 HIGH: $HIGH  🟡 MEDIUM: $MEDIUM  🔵 LOW: $LOW"
+    echo ""
+fi
+
+# Evidence freshness check
+AGE=0
+if [[ -f "$EVIDENCE_FILE" ]]; then
+    EVIDENCE_TS=$(jq -r '.timestamp' "$EVIDENCE_FILE" 2>/dev/null || echo "")
+    if [[ -n "$EVIDENCE_TS" ]] && [[ "$EVIDENCE_TS" != "null" ]]; then
+        # Parse ISO 8601 with timezone (e.g., 2026-01-04T08:12:13.372+01:00)
+        # Remove milliseconds and convert to epoch
+        CLEAN_TS=$(echo "$EVIDENCE_TS" | sed -E 's/\.[0-9]+([+-][0-9]{2}:[0-9]{2}|Z)$/\1/')
+        
+        # Try parsing with timezone offset format
+        if [[ "$CLEAN_TS" =~ \+[0-9]{2}:[0-9]{2}$ ]] || [[ "$CLEAN_TS" =~ -[0-9]{2}:[0-9]{2}$ ]]; then
+            # Convert to UTC by using Python (more reliable for timezone parsing)
+            EVIDENCE_EPOCH=$(python3 -c "from datetime import datetime; import sys; dt = datetime.fromisoformat('$CLEAN_TS'); print(int(dt.timestamp()))" 2>/dev/null || echo "0")
+        elif [[ "$CLEAN_TS" =~ Z$ ]]; then
+            # UTC format
+            EVIDENCE_EPOCH=$(date -j -f "%Y-%m-%dT%H:%M:%SZ" "$CLEAN_TS" +%s 2>/dev/null || echo "0")
+        else
+            EVIDENCE_EPOCH=0
+        fi
+        
+        if [[ "$EVIDENCE_EPOCH" != "0" ]]; then
+            NOW_EPOCH=$(date +%s)
+            AGE=$((NOW_EPOCH - EVIDENCE_EPOCH))
+            
+            if [[ $AGE -gt 180 ]]; then
+                echo -e "${YELLOW}⚠️  Evidence is stale (${AGE}s old, max 3min)${NC}"
+                echo -e "${YELLOW}   Run: ai-start${NC}"
+            else
+                echo -e "${GREEN}✅ Evidence fresh (${AGE}s old)${NC}"
+            fi
+            echo ""
+        fi
+    fi
+fi
+
+# Quick commands
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${CYAN}🚀 Quick Commands:${NC}"
+echo "   ai-start                    → Update evidence & start work"
+echo "   bash scripts/hooks-system/infrastructure/shell/orchestrators/audit-orchestrator.sh → Full audit"
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+
+# Final status
+if [[ $AGE -gt 180 ]]; then
+    echo -e "${YELLOW}⚠️  Run 'ai-start' to refresh evidence before working${NC}"
+else
+    echo -e "${GREEN}✅ Session loaded - Ready to work!${NC}"
+fi
 echo ""

package/docs/RELEASE_NOTES.md

@@ -1,3 +1,62 @@
+# Release Notes - v5.5.20
+
+**Release Date**: January 4, 2026  
+**Type**: Patch Release  
+**Compatibility**: Fully backward compatible with 5.5.x
+
+---
+
+## 🎯 Overview
+
+This release restores the comprehensive session context report on IDE startup and fixes critical bugs in the session loader, including infinite loop prevention and correct timestamp parsing for evidence freshness checks.
+
+---
+
+## 🐛 Bug Fixes
+
+### Fixed: Session loader infinite loop on macOS
+- **Issue**: `exec "$SHELL"` at the end of session-loader.sh caused fork resource exhaustion
+- **Resolution**: Removed shell exec, script now completes without forking
+- **Impact**: IDE startup no longer hangs or creates zombie processes
+
+### Fixed: Evidence age calculation showing incorrect values
+- **Issue**: ISO 8601 timestamps with timezone offsets (e.g., `2026-01-04T08:12:13.372+01:00`) were parsed incorrectly, showing millions of seconds
+- **Resolution**: Added Python-based timestamp parsing using `datetime.fromisoformat()` for reliable timezone conversion
+- **Impact**: Evidence freshness check now displays correct age in seconds
+
+### Fixed: Session loader showing minimal context
+- **Issue**: Session loader was simplified to basic status only, losing branch info, commits, violations summary
+- **Resolution**: Restored full context report with branch, recent commits, session context, violations summary, and evidence freshness
+- **Impact**: Users now see complete project context on IDE startup
+
+---
+
+## 🔧 Improvements
+
+### Enhanced Session Loader Output
+- Displays current branch with color coding
+- Shows last 3 commits with one-line format
+- Reads session context from `.AI_EVIDENCE.json`
+- Shows violations summary from `ast-summary.json` with severity breakdown (CRITICAL/HIGH/MEDIUM/LOW)
+- Displays evidence freshness with correct age calculation
+- Added quick commands section for common actions
+
+### Technical Details
+- Evidence timestamps with timezone offsets now correctly parsed
+- Session loader no longer forks shell process
+- All session information displayed in a single, organized banner
+- Violations summary reads from JSON report for accurate counts
+
+---
+
+## 📦 Installation / Upgrade
+```bash
+npm install --save-dev pumuki-ast-hooks@5.5.20
+npm run install-hooks
+```
+
+---
+
 # Release Notes - v5.3.15
 
 **Release Date**: December 30, 2025  

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "5.5.19",
+  "version": "5.5.21",
   "description": "Enterprise-grade AST Intelligence System with multi-platform support (iOS, Android, Backend, Frontend) and Feature-First + DDD + Clean Architecture enforcement. Includes dynamic violations API for intelligent querying.",
   "main": "index.js",
   "bin": {

package/scripts/hooks-system/application/services/installation/FileSystemInstallerService.js

@@ -54,6 +54,9 @@ class FileSystemInstallerService {
             if (fs.existsSync(source)) {
                 if (item === 'infrastructure/') {
                     this.copyRecursiveExcluding(source, dest, ['scripts']);
+                } else if (item === 'bin/') {
+                    // Exclude wrapper scripts that would cause fork bombs
+                    this.copyRecursiveExcluding(source, dest, ['session-loader.sh', 'cli.js', 'install.js']);
                 } else {
                     this.copyRecursive(source, dest);
                 }