jfl 0.0.0

package/template/scripts/session/session-end.sh

@@ -0,0 +1,194 @@
+#!/bin/bash
+# session-end.sh - Gracefully end a JFL session
+# Handles both worktree sessions (merge + cleanup) and main branch sessions
+#
+# Usage:
+#   ./scripts/session/session-end.sh              # Standard end
+#   ./scripts/session/session-end.sh --force      # Force end (even with uncommitted changes)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(pwd)"
+LOG_DIR="$PROJECT_ROOT/.jfl/logs"
+SESSION_FILE="$PROJECT_ROOT/.jfl/current-session.json"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+FORCE=false
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --force|-f)
+            FORCE=true
+            shift
+            ;;
+        *)
+            shift
+            ;;
+    esac
+done
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  JFL Session End"
+echo "  $(date '+%Y-%m-%d %H:%M:%S')"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+cd "$PROJECT_ROOT"
+
+# Check if this is a worktree session
+IS_WORKTREE=false
+SESSION_NAME=""
+WORKTREE_PATH=""
+
+if [ -f "$SESSION_FILE" ]; then
+    # Parse session info
+    if grep -q '"worktree": true' "$SESSION_FILE" 2>/dev/null; then
+        IS_WORKTREE=true
+        SESSION_NAME=$(grep -o '"session_name"[^,}]*' "$SESSION_FILE" | cut -d'"' -f4)
+        WORKTREE_PATH=$(grep -o '"worktree_path"[^,}]*' "$SESSION_FILE" | cut -d'"' -f4)
+    fi
+fi
+
+if $IS_WORKTREE && [ -n "$SESSION_NAME" ] && [ "$SESSION_NAME" != "main" ] && [ "$SESSION_NAME" != "null" ]; then
+    echo -e "${BLUE}→${NC} Ending worktree session: $SESSION_NAME"
+    echo ""
+
+    # Use worktree-session.sh to properly end (merge + cleanup)
+    if [ -f "$SCRIPT_DIR/worktree-session.sh" ]; then
+        "$SCRIPT_DIR/worktree-session.sh" end "$SESSION_NAME"
+    else
+        echo -e "${RED}✗${NC} worktree-session.sh not found!"
+        echo "  Manual cleanup needed:"
+        echo "  1. cd $WORKTREE_PATH && git add -A && git commit"
+        echo "  2. Merge branch $SESSION_NAME to main"
+        echo "  3. Remove worktree: git worktree remove $WORKTREE_PATH"
+        exit 1
+    fi
+
+    # Clean up session file
+    rm -f "$SESSION_FILE"
+
+else
+    # Main branch session - just commit and push
+    echo -e "${BLUE}→${NC} Ending main branch session..."
+
+    # Step 1: Stop auto-commit
+    echo -e "${BLUE}→${NC} Stopping auto-commit..."
+    "$SCRIPT_DIR/auto-commit.sh" stop 2>/dev/null || true
+
+    # Step 2: Take final snapshot (fast - skip large files)
+    echo -e "${BLUE}→${NC} Taking final snapshot..."
+    mkdir -p "$LOG_DIR"
+    SNAPSHOT_END="$LOG_DIR/snapshot-end-$(date +%Y%m%d-%H%M%S).txt"
+    CRITICAL_PATHS=("knowledge/" "previews/" "content/" "suggestions/" "CLAUDE.md")
+
+    # Skip .jfl/ for snapshots (contains large memory.db)
+    # Use stat instead of md5 for speed (size + mtime is enough for change detection)
+    for p in "${CRITICAL_PATHS[@]}"; do
+        if [ -e "$PROJECT_ROOT/$p" ]; then
+            find "$PROJECT_ROOT/$p" -type f -exec stat -f "%z %m %N" {} \; 2>/dev/null
+        fi
+    done | sort > "$SNAPSHOT_END"
+
+    # Step 3: Check for uncommitted changes
+    echo -e "${BLUE}→${NC} Checking for uncommitted changes..."
+    CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+
+    if [ "$CHANGES" -gt 0 ]; then
+        echo -e "${YELLOW}⚠${NC} Found $CHANGES uncommitted changes"
+        git status --short
+
+        echo ""
+        echo -e "${BLUE}→${NC} Committing all changes..."
+        git add -A
+
+        COMMIT_MSG="session: end $(date '+%Y-%m-%d %H:%M')"
+
+        if git commit -m "$COMMIT_MSG"; then
+            echo -e "${GREEN}✓${NC} Changes committed"
+        else
+            echo -e "${YELLOW}⚠${NC} Nothing to commit"
+        fi
+    else
+        echo -e "${GREEN}✓${NC} No uncommitted changes"
+    fi
+
+    # Step 4: Push to remote
+    echo -e "${BLUE}→${NC} Pushing to remote..."
+    CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+    if git push origin "$CURRENT_BRANCH" 2>/dev/null; then
+        echo -e "${GREEN}✓${NC} Pushed to origin/$CURRENT_BRANCH"
+    else
+        echo -e "${YELLOW}⚠${NC} Push failed (will retry on next session)"
+    fi
+
+    # Step 5: Sync product repo if symlink/submodule
+    PRODUCT_PATH="$PROJECT_ROOT/product"
+    if [ -L "$PRODUCT_PATH" ] || [ -d "$PRODUCT_PATH/.git" ]; then
+        echo ""
+        echo -e "${BLUE}→${NC} Syncing product repo..."
+
+        if [ -L "$PRODUCT_PATH" ]; then
+            TARGET=$(readlink "$PRODUCT_PATH")
+            if [[ "$TARGET" == ../* ]]; then
+                TARGET="$PROJECT_ROOT/$TARGET"
+            fi
+            TARGET=$(cd "$TARGET" 2>/dev/null && pwd)
+        else
+            TARGET="$PRODUCT_PATH"
+        fi
+
+        if [ -d "$TARGET/.git" ]; then
+            cd "$TARGET"
+            PRODUCT_CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+            if [ "$PRODUCT_CHANGES" -gt 0 ]; then
+                git add -A
+                git commit -m "session: end $(date '+%Y-%m-%d %H:%M')" || true
+                git push 2>/dev/null || echo -e "${YELLOW}⚠${NC} Product push failed"
+                echo -e "${GREEN}✓${NC} Product repo synced"
+            else
+                echo -e "${GREEN}✓${NC} Product repo clean"
+            fi
+            cd "$PROJECT_ROOT"
+        fi
+    fi
+
+    # Step 6: Compare snapshots
+    if [ -f "$SESSION_FILE" ]; then
+        SNAPSHOT_BEFORE=$(grep -o '"snapshot_before"[^,}]*' "$SESSION_FILE" | cut -d'"' -f4)
+
+        if [ -f "$SNAPSHOT_BEFORE" ]; then
+            echo ""
+            echo -e "${BLUE}→${NC} Session file changes:"
+            DIFF_OUTPUT=$(diff "$SNAPSHOT_BEFORE" "$SNAPSHOT_END" 2>/dev/null || true)
+
+            if [ -n "$DIFF_OUTPUT" ]; then
+                ADDED=$(echo "$DIFF_OUTPUT" | grep "^>" | wc -l | tr -d ' ')
+                REMOVED=$(echo "$DIFF_OUTPUT" | grep "^<" | wc -l | tr -d ' ')
+                echo "  Files added/modified: $ADDED"
+                echo "  Files removed: $REMOVED"
+                echo "$DIFF_OUTPUT" > "$LOG_DIR/session-diff-$(date +%Y%m%d-%H%M%S).txt"
+            else
+                echo "  No file changes this session"
+            fi
+        fi
+    fi
+
+    # Clean up session file
+    rm -f "$SESSION_FILE"
+
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "  ${GREEN}Session ended successfully!${NC}"
+    echo ""
+    echo "  All changes committed and pushed."
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+fi

package/template/scripts/session/session-init.sh

@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+#
+# session-init.sh - Initialize a JFL session properly
+#
+# Called by SessionStart hook. Does:
+# 1. Quick doctor check (warn only, don't block)
+# 2. Clean up stale sessions if > 5
+# 3. Create new worktree for this session
+# 4. Output path for Claude to cd into
+#
+# @purpose Session initialization with worktree creation
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_DIR="${JFL_REPO_DIR:-$(pwd)}"
+WORKTREES_DIR="$REPO_DIR/worktrees"
+
+cd "$REPO_DIR" || exit 1
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# ==============================================================================
+# Step 1: Quick health check (warn only)
+# ==============================================================================
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  JFL Session Init"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Count stale sessions (no PID or PID not running)
+stale_count=0
+active_count=0
+
+if [[ -d "$WORKTREES_DIR" ]]; then
+    for worktree in "$WORKTREES_DIR"/session-*; do
+        if [[ -d "$worktree" ]]; then
+            pid_file="$worktree/.jfl/auto-commit.pid"
+            if [[ -f "$pid_file" ]]; then
+                pid=$(cat "$pid_file" 2>/dev/null)
+                if [[ -n "$pid" ]] && kill -0 "$pid" 2>/dev/null; then
+                    active_count=$((active_count + 1))
+                    continue
+                fi
+            fi
+            stale_count=$((stale_count + 1))
+        fi
+    done
+fi
+
+# Report status
+if [[ $stale_count -gt 0 ]]; then
+    echo -e "${YELLOW}⚠${NC}  $stale_count stale sessions, $active_count active"
+else
+    echo -e "${GREEN}✓${NC}  $active_count active sessions"
+fi
+
+# ==============================================================================
+# Step 2: Auto-cleanup if too many stale sessions
+# ==============================================================================
+
+if [[ $stale_count -gt 5 ]]; then
+    echo -e "${YELLOW}→${NC}  Cleaning up stale sessions (> 5)..."
+    "$SCRIPT_DIR/jfl-doctor.sh" --fix 2>/dev/null | grep -E "^  (Cleaning|✓)" || true
+fi
+
+# ==============================================================================
+# Step 3: Create new worktree
+# ==============================================================================
+
+# Generate session name with collision protection
+user=$(git config user.name 2>/dev/null | tr ' ' '-' | tr '[:upper:]' '[:lower:]' | tr -cd 'a-z0-9-' || echo "user")
+# Truncate long usernames to prevent path issues
+user="${user:0:30}"
+date_str=$(date +%Y%m%d)
+time_str=$(date +%H%M)
+
+# Generate unique session name, retry if collision detected
+max_attempts=5
+attempt=0
+while [[ $attempt -lt $max_attempts ]]; do
+    random_id=$(openssl rand -hex 3 2>/dev/null || printf "%06x" $RANDOM$RANDOM)
+    session_name="session-${user}-${date_str}-${time_str}-${random_id}"
+
+    # Check for collision: journal file or worktree already exists
+    if [[ -f "$REPO_DIR/.jfl/journal/${session_name}.jsonl" ]] || [[ -d "$WORKTREES_DIR/$session_name" ]]; then
+        echo -e "${YELLOW}⚠${NC}  Session name collision, regenerating..."
+        attempt=$((attempt + 1))
+        sleep 0.1  # Brief pause before retry
+    else
+        break
+    fi
+done
+
+if [[ $attempt -ge $max_attempts ]]; then
+    echo -e "${RED}✗${NC}  Failed to generate unique session name after $max_attempts attempts"
+    exit 1
+fi
+
+worktree_path="$WORKTREES_DIR/$session_name"
+
+echo ""
+echo "Creating session: $session_name"
+
+# Create worktree
+if git worktree add "$worktree_path" -b "$session_name" 2>&1 | head -3; then
+    echo -e "${GREEN}✓${NC}  Worktree created"
+else
+    echo -e "${RED}✗${NC}  Failed to create worktree"
+    # Fall back to main branch
+    echo "main" > "$REPO_DIR/.jfl/current-worktree.txt"
+    echo "main" > "$REPO_DIR/.jfl/current-session-branch.txt"
+    exit 0
+fi
+
+# Initialize submodules in worktree (quick, no network)
+cd "$worktree_path"
+if [[ -f ".gitmodules" ]]; then
+    if [[ ! -d "product/.git" ]] && [[ ! -f "product/.git" ]]; then
+        echo "→  Initializing submodules..."
+        git submodule update --init --depth 1 product 2>/dev/null || true
+    fi
+fi
+
+# Create session directories
+mkdir -p .jfl/logs
+
+# CRITICAL: Symlink journal to main repo so entries persist after worktree cleanup
+# Without this, journal entries written in worktree are lost when worktree is removed!
+rm -rf .jfl/journal 2>/dev/null || true
+ln -sf "$REPO_DIR/.jfl/journal" .jfl/journal
+echo -e "${GREEN}✓${NC}  Journal symlinked to main repo"
+
+# Start auto-commit in background
+if [[ -x "$SCRIPT_DIR/auto-commit.sh" ]]; then
+    "$SCRIPT_DIR/auto-commit.sh" start >> .jfl/logs/auto-commit.log 2>&1 &
+    echo -e "${GREEN}✓${NC}  Auto-commit started"
+fi
+
+cd "$REPO_DIR"
+
+# ==============================================================================
+# Step 4: Save state and output instructions
+# ==============================================================================
+
+# Save paths
+echo "$worktree_path" > "$REPO_DIR/.jfl/current-worktree.txt"
+echo "$session_name" > "$REPO_DIR/.jfl/current-session-branch.txt"
+
+# Also save in worktree
+echo "$session_name" > "$worktree_path/.jfl/current-session-branch.txt"
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "  ${CYAN}CLAUDE: You MUST run:${NC} cd $worktree_path"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""

package/template/scripts/session/session-sync.sh

@@ -0,0 +1,167 @@
+#!/bin/bash
+# session-sync.sh - Run at session start to ensure all repos are synced
+# This prevents the "where did my files go" problem
+
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo "========================================"
+echo "JFL Session Sync"
+echo "========================================"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+GTM_ROOT="$(pwd)"
+
+# Track failures
+FAILURES=0
+
+# Function to sync a repo
+sync_repo() {
+    local repo_path="$1"
+    local repo_name="$2"
+
+    if [ ! -d "$repo_path" ]; then
+        echo -e "${RED}ERROR: $repo_name not found at $repo_path${NC}"
+        FAILURES=$((FAILURES + 1))
+        return 1
+    fi
+
+    echo ""
+    echo "--- Syncing $repo_name ---"
+    cd "$repo_path"
+
+    # Check if it's a git repo
+    if [ ! -d ".git" ]; then
+        echo -e "${YELLOW}WARNING: $repo_name is not a git repo${NC}"
+        return 0
+    fi
+
+    # Get current branch
+    CURRENT_BRANCH=$(git branch --show-current 2>/dev/null || echo "detached")
+
+    # Fetch latest
+    echo "Fetching from origin..."
+    git fetch origin 2>/dev/null || {
+        echo -e "${YELLOW}WARNING: Could not fetch $repo_name (no network?)${NC}"
+        return 0
+    }
+
+    # Check if behind
+    if [ "$CURRENT_BRANCH" != "detached" ] && [ "$CURRENT_BRANCH" != "" ]; then
+        LOCAL=$(git rev-parse HEAD)
+        REMOTE=$(git rev-parse "origin/$CURRENT_BRANCH" 2>/dev/null || echo "")
+
+        if [ -n "$REMOTE" ] && [ "$LOCAL" != "$REMOTE" ]; then
+            BEHIND=$(git rev-list --count HEAD.."origin/$CURRENT_BRANCH" 2>/dev/null || echo "0")
+            AHEAD=$(git rev-list --count "origin/$CURRENT_BRANCH"..HEAD 2>/dev/null || echo "0")
+
+            if [ "$BEHIND" -gt 0 ]; then
+                echo -e "${YELLOW}$repo_name is $BEHIND commits behind origin/$CURRENT_BRANCH${NC}"
+
+                # Check for uncommitted changes
+                if [ -n "$(git status --porcelain)" ]; then
+                    echo -e "${RED}ERROR: $repo_name has uncommitted changes AND is behind${NC}"
+                    echo "Please commit or stash changes, then pull"
+                    FAILURES=$((FAILURES + 1))
+                else
+                    echo "Pulling latest..."
+                    git pull origin "$CURRENT_BRANCH" || {
+                        echo -e "${RED}ERROR: Failed to pull $repo_name${NC}"
+                        FAILURES=$((FAILURES + 1))
+                    }
+                fi
+            fi
+
+            if [ "$AHEAD" -gt 0 ]; then
+                echo -e "${YELLOW}$repo_name is $AHEAD commits ahead (unpushed)${NC}"
+            fi
+        else
+            echo -e "${GREEN}$repo_name is up to date${NC}"
+        fi
+    else
+        echo -e "${YELLOW}$repo_name is in detached HEAD state${NC}"
+        # Try to checkout main and pull
+        echo "Attempting to checkout main and pull..."
+        git checkout main 2>/dev/null && git pull origin main 2>/dev/null || {
+            echo -e "${YELLOW}Could not auto-fix detached HEAD${NC}"
+        }
+    fi
+
+    # Show current state
+    echo "Current: $(git log --oneline -1)"
+}
+
+# Sync main GTM repo
+sync_repo "$GTM_ROOT" "jfl-gtm"
+
+# Check for product - submodule or symlink
+PRODUCT_PATH="$GTM_ROOT/product"
+if [ -d "$PRODUCT_PATH" ] && [ -f "$PRODUCT_PATH/.git" ]; then
+    # It's a submodule (submodules have .git as a FILE, not directory)
+    echo ""
+    echo "--- Updating product submodule ---"
+    cd "$GTM_ROOT"
+
+    # First, init if needed
+    git submodule init product 2>/dev/null || true
+
+    # Update to latest from remote
+    git submodule update --remote product || {
+        echo -e "${YELLOW}WARNING: Could not update product submodule${NC}"
+    }
+
+    # Show what commit we're on
+    cd "$PRODUCT_PATH"
+    echo -e "${GREEN}product submodule at: $(git log --oneline -1)${NC}"
+    cd "$GTM_ROOT"
+
+elif [ -L "$PRODUCT_PATH" ]; then
+    # It's a symlink - resolve and sync the target (legacy support)
+    echo -e "${YELLOW}WARNING: product/ is a symlink, not a submodule${NC}"
+    echo "Consider converting to submodule for better reliability"
+
+    TARGET=$(readlink "$PRODUCT_PATH")
+    if [[ "$TARGET" == ../* ]]; then
+        RESOLVED_TARGET="$GTM_ROOT/$TARGET"
+    else
+        RESOLVED_TARGET="$TARGET"
+    fi
+    RESOLVED_TARGET=$(cd "$RESOLVED_TARGET" 2>/dev/null && pwd)
+
+    if [ -n "$RESOLVED_TARGET" ]; then
+        sync_repo "$RESOLVED_TARGET" "jfl-platform (product symlink target)"
+    else
+        echo -e "${RED}ERROR: Could not resolve product symlink target${NC}"
+        FAILURES=$((FAILURES + 1))
+    fi
+elif [ ! -e "$PRODUCT_PATH" ]; then
+    # Product doesn't exist - try to init submodule
+    echo ""
+    echo "--- Initializing product submodule ---"
+    cd "$GTM_ROOT"
+    git submodule init product 2>/dev/null && git submodule update product || {
+        echo -e "${YELLOW}WARNING: Could not initialize product submodule${NC}"
+    }
+fi
+
+# Sync other submodules
+echo ""
+echo "--- Syncing submodules ---"
+cd "$GTM_ROOT"
+git submodule update --init --recursive 2>/dev/null || true
+
+# Final status
+echo ""
+echo "========================================"
+if [ $FAILURES -gt 0 ]; then
+    echo -e "${RED}Session sync completed with $FAILURES errors${NC}"
+    echo "Please fix the above issues before continuing"
+    exit 1
+else
+    echo -e "${GREEN}Session sync completed successfully${NC}"
+fi
+echo "========================================"

package/template/scripts/session/test-context-preservation.sh

@@ -0,0 +1,160 @@
+#!/bin/bash
+# test-context-preservation.sh - Verify that context files exist and are in sync
+# Run this to catch "missing files" issues before they become problems
+
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+echo "========================================"
+echo "Context Preservation Test"
+echo "========================================"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+GTM_ROOT="$(pwd)"
+
+FAILURES=0
+WARNINGS=0
+
+# Test 1: Critical GTM knowledge files exist
+echo ""
+echo "Test 1: Critical knowledge files"
+CRITICAL_FILES=(
+    "knowledge/VISION.md"
+    "knowledge/NARRATIVE.md"
+    "knowledge/ROADMAP.md"
+    "knowledge/BRAND_DECISIONS.md"
+    "knowledge/DESIGN_SYSTEM.md"
+    "knowledge/NAMING.md"
+    "knowledge/PRODUCT_SPEC_V2.md"
+)
+
+for file in "${CRITICAL_FILES[@]}"; do
+    if [ -f "$GTM_ROOT/$file" ]; then
+        SIZE=$(wc -c < "$GTM_ROOT/$file")
+        if [ "$SIZE" -lt 100 ]; then
+            echo -e "${YELLOW}  WARNING: $file exists but is very small ($SIZE bytes)${NC}"
+            WARNINGS=$((WARNINGS + 1))
+        else
+            echo -e "${GREEN}  ✓ $file ($SIZE bytes)${NC}"
+        fi
+    else
+        echo -e "${RED}  ✗ $file MISSING${NC}"
+        FAILURES=$((FAILURES + 1))
+    fi
+done
+
+# Test 2: Product platform specs exist
+echo ""
+echo "Test 2: Product platform specs"
+PRODUCT_PATH="$GTM_ROOT/product"
+if [ -L "$PRODUCT_PATH" ]; then
+    PRODUCT_PATH=$(cd "$PRODUCT_PATH" 2>/dev/null && pwd)
+fi
+
+PLATFORM_FILES=(
+    "PLATFORM_SPEC.md"
+    "TEMPLATE_SPEC.md"
+    "CONTEXT_GRAPH_SPEC.md"
+)
+
+for file in "${PLATFORM_FILES[@]}"; do
+    if [ -f "$PRODUCT_PATH/$file" ]; then
+        SIZE=$(wc -c < "$PRODUCT_PATH/$file")
+        echo -e "${GREEN}  ✓ product/$file ($SIZE bytes)${NC}"
+    else
+        echo -e "${RED}  ✗ product/$file MISSING${NC}"
+        FAILURES=$((FAILURES + 1))
+    fi
+done
+
+# Test 3: Git repos are in sync with remotes
+echo ""
+echo "Test 3: Git sync status"
+
+check_git_sync() {
+    local repo_path="$1"
+    local repo_name="$2"
+
+    cd "$repo_path" 2>/dev/null || return 1
+
+    git fetch origin 2>/dev/null || {
+        echo -e "${YELLOW}  WARNING: Could not fetch $repo_name${NC}"
+        WARNINGS=$((WARNINGS + 1))
+        return 0
+    }
+
+    BRANCH=$(git branch --show-current 2>/dev/null || echo "")
+    if [ -z "$BRANCH" ]; then
+        echo -e "${YELLOW}  WARNING: $repo_name is in detached HEAD${NC}"
+        WARNINGS=$((WARNINGS + 1))
+        return 0
+    fi
+
+    LOCAL=$(git rev-parse HEAD)
+    REMOTE=$(git rev-parse "origin/$BRANCH" 2>/dev/null || echo "")
+
+    if [ -z "$REMOTE" ]; then
+        echo -e "${YELLOW}  WARNING: $repo_name has no remote tracking${NC}"
+        WARNINGS=$((WARNINGS + 1))
+        return 0
+    fi
+
+    BEHIND=$(git rev-list --count HEAD.."origin/$BRANCH" 2>/dev/null || echo "0")
+
+    if [ "$BEHIND" -gt 0 ]; then
+        echo -e "${RED}  ✗ $repo_name is $BEHIND commits BEHIND origin${NC}"
+        FAILURES=$((FAILURES + 1))
+    else
+        echo -e "${GREEN}  ✓ $repo_name is in sync${NC}"
+    fi
+}
+
+check_git_sync "$GTM_ROOT" "jfl-gtm"
+
+# Check product target
+PRODUCT_LINK="$GTM_ROOT/product"
+if [ -L "$PRODUCT_LINK" ]; then
+    TARGET=$(readlink "$PRODUCT_LINK")
+    if [[ "$TARGET" == ../* ]]; then
+        RESOLVED="$GTM_ROOT/$TARGET"
+    else
+        RESOLVED="$TARGET"
+    fi
+    RESOLVED=$(cd "$RESOLVED" 2>/dev/null && pwd)
+    if [ -n "$RESOLVED" ]; then
+        check_git_sync "$RESOLVED" "jfl-platform"
+    fi
+fi
+
+# Test 4: No uncommitted critical changes
+echo ""
+echo "Test 4: Uncommitted changes check"
+cd "$GTM_ROOT"
+UNCOMMITTED=$(git status --porcelain knowledge/ 2>/dev/null | wc -l)
+if [ "$UNCOMMITTED" -gt 0 ]; then
+    echo -e "${YELLOW}  WARNING: $UNCOMMITTED uncommitted changes in knowledge/${NC}"
+    git status --porcelain knowledge/ | head -5
+    WARNINGS=$((WARNINGS + 1))
+else
+    echo -e "${GREEN}  ✓ No uncommitted knowledge changes${NC}"
+fi
+
+# Summary
+echo ""
+echo "========================================"
+if [ $FAILURES -gt 0 ]; then
+    echo -e "${RED}FAILED: $FAILURES critical issues found${NC}"
+    echo "Run: ./scripts/session-sync.sh to fix sync issues"
+    exit 1
+elif [ $WARNINGS -gt 0 ]; then
+    echo -e "${YELLOW}PASSED with $WARNINGS warnings${NC}"
+    exit 0
+else
+    echo -e "${GREEN}PASSED: All context preservation checks passed${NC}"
+    exit 0
+fi
+echo "========================================"