pumuki-ast-hooks 5.5.20 → 5.5.22

package/README.md

@@ -1065,6 +1065,30 @@ For coding standards, see [CODE_STANDARDS.md](./docs/CODE_STANDARDS.md).
 
 ## 📝 Recent Changes
 
+### Version 5.5.21 (2026-01-04)
+
+**🐛 Bug Fixes:**
+- Fixed fork bomb caused by wrapper scripts being copied to incorrect location
+- Excluded wrapper scripts from bin/ copy to prevent recursive calls
+- Session loader now works correctly without causing resource exhaustion
+
+---
+
+### 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,5 +1,5 @@
 #!/bin/bash
-# AST Session Loader v5.5.20
+# AST Session Loader v5.5.22
 # Runs on IDE startup to initialize AST hooks, show context and check tokens
 REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
 
@@ -26,7 +26,7 @@ fi
 # Banner
 echo ""
 echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
-echo -e "${BLUE}║         🤖 AST Intelligence Hooks v5.5.20                ║${NC}"
+echo -e "${BLUE}║         🤖 AST Intelligence Hooks v5.5.22                ║${NC}"
 echo -e "${BLUE}║         Workspace Opened - Loading Context...            ║${NC}"
 echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
 echo ""

package/docs/RELEASE_NOTES.md

@@ -1,3 +1,98 @@
+# Release Notes - v5.5.21
+
+**Release Date**: January 4, 2026  
+**Type**: Patch Release  
+**Compatibility**: Fully backward compatible with 5.5.x
+
+---
+
+## 🎯 Overview
+
+This release fixes a critical fork bomb issue in the installer caused by wrapper scripts being copied to incorrect locations, preventing recursive calls that would exhaust system resources.
+
+---
+
+## 🐛 Bug Fixes
+
+### Fixed: Fork bomb in session-loader
+- **Issue**: Wrapper scripts (`session-loader.sh`, `cli.js`, `install.js`) were copied from `/bin/` to `scripts/hooks-system/bin/`, causing them to call themselves recursively
+- **Resolution**: Modified `FileSystemInstallerService` to exclude wrapper scripts when copying the `bin/` directory
+- **Impact**: Session loader now works correctly without causing fork resource exhaustion or infinite loops
+
+### Technical Details
+- Wrapper scripts in the library's `/bin/` directory are now excluded during installation
+- This prevents the wrapper from being copied to the location where it would call itself
+- Installation process is now safe and doesn't cause resource exhaustion
+
+---
+
+## 📦 Installation / Upgrade
+```bash
+npm install --save-dev pumuki-ast-hooks@5.5.21
+npm run install-hooks
+```
+
+---
+
+# 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.20",
+  "version": "5.5.22",
   "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);
                 }

package/scripts/hooks-system/bin/session-loader.sh

@@ -1,5 +1,107 @@
 #!/bin/bash
-# Script Wrapper
-# Redirects to the centralized implementation in scripts/hooks-system
+# AST Session Loader v5.5.22
+# Runs on IDE startup to initialize AST hooks, show context and check tokens
 REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
-bash "$REPO_ROOT/scripts/hooks-system/bin/session-loader.sh" "$@"
+
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+MAGENTA='\033[0;35m'
+NC='\033[0m'
+
+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"
+
+TOKEN_TRACKER="$REPO_ROOT/scripts/hooks-system/infrastructure/watchdog/token-tracker.sh"
+if [ -f "$TOKEN_TRACKER" ]; then
+    bash "$TOKEN_TRACKER"
+fi
+
+echo ""
+echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║         🤖 AST Intelligence Hooks v5.5.22                ║${NC}"
+echo -e "${BLUE}║         Workspace Opened - Loading Context...            ║${NC}"
+echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+CURRENT_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
+echo -e "${CYAN}📍 Current Branch: ${MAGENTA}$CURRENT_BRANCH${NC}"
+echo ""
+
+echo -e "${CYAN}📝 Recent Commits:${NC}"
+git log --oneline -3 2>/dev/null | sed 's/^/   /' || echo "   No commits yet"
+echo ""
+
+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
+
+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
+
+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
+        CLEAN_TS=$(echo "$EVIDENCE_TS" | sed -E 's/\.[0-9]+([+-][0-9]{2}:[0-9]{2}|Z)$/\1/')
+        
+        if [[ "$CLEAN_TS" =~ \+[0-9]{2}:[0-9]{2}$ ]] || [[ "$CLEAN_TS" =~ -[0-9]{2}:[0-9]{2}$ ]]; then
+            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
+            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
+
+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 ""
+
+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 ""