jfl 0.1.0 → 0.2.0

package/template/scripts/session/test-session-cleanup.sh

@@ -0,0 +1,268 @@
+#!/bin/bash
+#
+# Test Suite: Session Cleanup
+#
+# Tests session-cleanup.sh against critical safety requirements:
+# - NEVER loses uncommitted work
+# - NEVER loses conflicting changes
+# - ONLY auto-merges safe commits (auto-saves, journal entries)
+# - ALWAYS preserves journal entries
+# - Properly removes worktrees after successful merge
+# - Handles all exit scenarios (normal, Ctrl+C, crash, kill)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+TESTS_RUN=0
+TESTS_PASSED=0
+TESTS_FAILED=0
+
+print_test() {
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "TEST: $1"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+pass() {
+    echo -e "${GREEN}✓ PASS${NC}: $1"
+    TESTS_PASSED=$((TESTS_PASSED + 1))
+    TESTS_RUN=$((TESTS_RUN + 1))
+}
+
+fail() {
+    echo -e "${RED}✗ FAIL${NC}: $1"
+    TESTS_FAILED=$((TESTS_FAILED + 1))
+    TESTS_RUN=$((TESTS_RUN + 1))
+}
+
+anti_test() {
+    echo -e "${YELLOW}⚠ ANTI-TEST${NC}: $1 (should NOT happen)"
+}
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Safety Tests - CRITICAL: Must never lose work
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+print_test "SAFETY: Cleanup script exists and is executable"
+if [[ -f "$SCRIPT_DIR/session-cleanup.sh" ]]; then
+    pass "session-cleanup.sh exists"
+else
+    fail "session-cleanup.sh not found"
+fi
+
+if [[ -x "$SCRIPT_DIR/session-cleanup.sh" ]]; then
+    pass "session-cleanup.sh is executable"
+else
+    fail "session-cleanup.sh not executable"
+fi
+
+print_test "SAFETY: Script has auto-commit before merge"
+if grep -q "git add -A" "$SCRIPT_DIR/session-cleanup.sh" && \
+   grep -q "git commit" "$SCRIPT_DIR/session-cleanup.sh"; then
+    pass "Auto-commits before attempting merge"
+else
+    fail "Missing auto-commit before merge - WILL LOSE WORK"
+fi
+
+print_test "SAFETY: Script checks if on session branch"
+if grep -q 'if.*session-' "$SCRIPT_DIR/session-cleanup.sh"; then
+    pass "Checks for session branch before cleanup"
+else
+    fail "Doesn't check branch type - might cleanup non-session branches"
+fi
+
+print_test "SAFETY: Script aborts merge on conflicts"
+if grep -q "git merge --abort" "$SCRIPT_DIR/session-cleanup.sh"; then
+    pass "Aborts merge on conflicts (preserves work)"
+else
+    fail "Doesn't abort on conflicts - WILL LOSE CONFLICTING CHANGES"
+fi
+
+print_test "SAFETY: Script uses auto-resolve strategy for .jfl/ conflicts"
+if grep -q -- "-X ours" "$SCRIPT_DIR/session-cleanup.sh"; then
+    pass "Uses -X ours for auto-resolving .jfl/ conflicts"
+else
+    fail "Missing conflict resolution strategy - merges will fail unnecessarily"
+fi
+
+print_test "ANTI-TEST: Script doesn't use --force flags"
+anti_test "git push --force"
+if grep -q "push.*--force" "$SCRIPT_DIR/session-cleanup.sh"; then
+    fail "Uses --force push - DANGEROUS"
+else
+    pass "No --force push (safe)"
+fi
+
+anti_test "git clean -f"
+if grep -q "git clean" "$SCRIPT_DIR/session-cleanup.sh"; then
+    fail "Uses git clean - WILL LOSE UNTRACKED FILES"
+else
+    pass "No git clean (safe)"
+fi
+
+anti_test "git reset --hard"
+if grep -q "reset.*--hard" "$SCRIPT_DIR/session-cleanup.sh"; then
+    fail "Uses reset --hard - WILL LOSE UNCOMMITTED WORK"
+else
+    pass "No reset --hard (safe)"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Integration Tests - Works with existing infrastructure
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+print_test "INTEGRATION: Stop hook calls session-cleanup.sh"
+SETTINGS_FILE="$REPO_DIR/.claude/settings.json"
+if [[ -f "$SETTINGS_FILE" ]]; then
+    if grep -q "session-cleanup.sh" "$SETTINGS_FILE"; then
+        pass "Stop hook configured to run cleanup"
+    else
+        fail "Stop hook doesn't call session-cleanup.sh"
+    fi
+else
+    fail ".claude/settings.json not found"
+fi
+
+print_test "INTEGRATION: Signal handler calls session-cleanup.sh"
+AUTO_COMMIT_SCRIPT="$SCRIPT_DIR/auto-commit.sh"
+if [[ -f "$AUTO_COMMIT_SCRIPT" ]]; then
+    if grep -A 10 "graceful_shutdown" "$AUTO_COMMIT_SCRIPT" | grep -q "session-cleanup.sh"; then
+        pass "Signal handler calls cleanup on Ctrl+C/kill"
+    else
+        fail "Signal handler doesn't call session-cleanup.sh - branches pile up on Ctrl+C"
+    fi
+else
+    fail "auto-commit.sh not found"
+fi
+
+print_test "INTEGRATION: Signal traps are set"
+if grep -q "trap.*graceful_shutdown.*SIGINT.*SIGTERM" "$AUTO_COMMIT_SCRIPT"; then
+    pass "Signal traps set for SIGINT and SIGTERM"
+else
+    fail "Missing signal traps - Ctrl+C won't trigger cleanup"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Functional Tests - Script behavior
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+print_test "FUNCTIONAL: Script skips cleanup on non-session branches"
+CLEANUP_OUTPUT=$("$SCRIPT_DIR/session-cleanup.sh" 2>&1 || true)
+CURRENT_BRANCH=$(git branch --show-current)
+
+if [[ ! "$CURRENT_BRANCH" =~ ^session- ]]; then
+    if echo "$CLEANUP_OUTPUT" | grep -q "Not a session branch"; then
+        pass "Skips cleanup on non-session branch (main)"
+    else
+        fail "Doesn't skip non-session branches - might cleanup main!"
+    fi
+else
+    pass "Currently on session branch, skipping non-session test"
+fi
+
+print_test "FUNCTIONAL: Script switches to main before merge"
+if grep -q "git checkout main" "$SCRIPT_DIR/session-cleanup.sh"; then
+    pass "Switches to main before merging"
+else
+    fail "Doesn't checkout main - merge will fail"
+fi
+
+print_test "FUNCTIONAL: Script removes worktree after successful merge"
+if grep -q "git worktree.*remove" "$SCRIPT_DIR/session-cleanup.sh" || \
+   grep -q "rm -rf.*WORKTREE" "$SCRIPT_DIR/session-cleanup.sh"; then
+    pass "Removes worktree after merge"
+else
+    fail "Doesn't remove worktree - will pile up disk usage"
+fi
+
+print_test "FUNCTIONAL: Script deletes branch after successful merge"
+if grep -q "git branch -D" "$SCRIPT_DIR/session-cleanup.sh"; then
+    pass "Deletes branch after successful merge"
+else
+    fail "Doesn't delete branch - will pile up branches"
+fi
+
+print_test "FUNCTIONAL: Script handles missing worktree gracefully"
+if grep -q "\[ -n.*WORKTREE" "$SCRIPT_DIR/session-cleanup.sh" || \
+   grep -q "\[ -d.*WORKTREE" "$SCRIPT_DIR/session-cleanup.sh"; then
+    pass "Checks if worktree exists before removing"
+else
+    fail "Doesn't check worktree existence - might error on missing worktree"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Edge Cases
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+print_test "EDGE CASE: Script handles 'not on a branch' scenario"
+if grep -q 'if \[ -z.*BRANCH' "$SCRIPT_DIR/session-cleanup.sh"; then
+    pass "Checks if on a branch (handles detached HEAD)"
+else
+    fail "Doesn't check for detached HEAD - will fail in that state"
+fi
+
+print_test "EDGE CASE: Script exits cleanly on all paths"
+if tail -5 "$SCRIPT_DIR/session-cleanup.sh" | grep -q "exit 0"; then
+    pass "Script exits cleanly (exit 0)"
+else
+    fail "Script might exit with error code - will break hooks"
+fi
+
+print_test "EDGE CASE: Script doesn't fail entire hook chain"
+# Check that cleanup is called with || true in hooks
+if grep -q "session-cleanup.sh.*||" "$SETTINGS_FILE" 2>/dev/null; then
+    pass "Cleanup failure doesn't break hook chain"
+else
+    fail "Cleanup failure could break Stop hook - session won't end"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Performance Tests
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+print_test "PERFORMANCE: Cleanup redirects to log file"
+if grep -q "session-cleanup.sh.*>>" "$SETTINGS_FILE" 2>/dev/null; then
+    pass "Cleanup output goes to log file (doesn't spam user)"
+else
+    fail "Cleanup output not redirected - will spam terminal"
+fi
+
+print_test "PERFORMANCE: Cleanup runs in background/async"
+if grep -q "session-cleanup.sh.*2>&1" "$SETTINGS_FILE" 2>/dev/null; then
+    pass "Cleanup stderr redirected (clean output)"
+else
+    fail "Cleanup stderr not redirected - errors spam terminal"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Summary
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "TEST SUMMARY"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Total tests:  $TESTS_RUN"
+echo -e "${GREEN}Passed:${NC}       $TESTS_PASSED"
+echo -e "${RED}Failed:${NC}       $TESTS_FAILED"
+
+if [ $TESTS_FAILED -eq 0 ]; then
+    echo ""
+    echo -e "${GREEN}✓ All tests passed!${NC}"
+    echo "Session cleanup is safe and ready for production."
+    exit 0
+else
+    echo ""
+    echo -e "${RED}✗ $TESTS_FAILED test(s) failed!${NC}"
+    echo "Fix failing tests before deploying to ensure work is never lost."
+    exit 1
+fi

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

@@ -0,0 +1,320 @@
+#!/usr/bin/env bash
+#
+# Rigorous tests for session-sync.sh
+# Tests both positive cases AND anti-tests (what should NOT happen)
+#
+# @purpose Test session-sync.sh before committing (work-loss prevention)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TEST_DIR="/tmp/jfl-session-sync-test-$$"
+REPO_DIR="$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null || echo ".")"
+REPO_DIR="${REPO_DIR%/.git}"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+TESTS_PASSED=0
+TESTS_FAILED=0
+
+pass() {
+    echo -e "${GREEN}✓${NC} $1"
+    TESTS_PASSED=$((TESTS_PASSED + 1))
+}
+
+fail() {
+    echo -e "${RED}✗${NC} $1"
+    TESTS_FAILED=$((TESTS_FAILED + 1))
+}
+
+section() {
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${BLUE}$1${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+cleanup() {
+    rm -rf "$TEST_DIR" 2>/dev/null || true
+}
+
+trap cleanup EXIT
+
+# ==============================================================================
+# Test 1: Script Safety Checks
+# ==============================================================================
+
+test_safety_checks() {
+    section "Test 1: Safety Checks (prevent data loss)"
+
+    # Check for uncommitted changes protection
+    if grep -q "has uncommitted changes AND is behind" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Protects against pulling over uncommitted changes"
+    else
+        fail "No protection for uncommitted changes + pull"
+    fi
+
+    # Check that it uses 'set -e' for failure propagation
+    if head -10 "$SCRIPT_DIR/session-sync.sh" | grep -q "set -e"; then
+        pass "Uses 'set -e' for error propagation"
+    else
+        fail "Doesn't use 'set -e' - errors may be silent"
+    fi
+
+    # Check that it exits with error code on failure
+    if grep -q "exit 1" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Exits with error code on failure"
+    else
+        fail "Doesn't exit with error - CI/CD won't catch failures"
+    fi
+
+    # Anti-test: Verify it doesn't use --force flags
+    if grep -E "git pull.*--force|git reset --hard" "$SCRIPT_DIR/session-sync.sh" >/dev/null; then
+        fail "DANGER: Uses destructive git commands (--force, --hard)"
+    else
+        pass "Doesn't use destructive git commands"
+    fi
+
+    # Check for graceful network failure handling
+    if grep -q "Could not fetch.*no network" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Handles network failures gracefully"
+    else
+        fail "No graceful handling of network failures"
+    fi
+}
+
+# ==============================================================================
+# Test 2: Detached HEAD Handling
+# ==============================================================================
+
+test_detached_head() {
+    section "Test 2: Detached HEAD Handling (submodules)"
+
+    # Check if script detects detached HEAD
+    if grep -q "detached HEAD state" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Detects detached HEAD state"
+    else
+        fail "Doesn't detect detached HEAD"
+    fi
+
+    # Check if it attempts to fix detached HEAD
+    if grep -A5 "detached HEAD" "$SCRIPT_DIR/session-sync.sh" | grep -q "checkout main"; then
+        pass "Attempts to fix detached HEAD automatically"
+    else
+        fail "Doesn't auto-fix detached HEAD"
+    fi
+
+    # Anti-test: Verify it doesn't force checkout (would lose work)
+    if grep -E "git checkout.*-f|git checkout.*--force" "$SCRIPT_DIR/session-sync.sh" >/dev/null; then
+        fail "DANGER: Uses force checkout (loses uncommitted work)"
+    else
+        pass "Doesn't use force checkout"
+    fi
+}
+
+# ==============================================================================
+# Test 3: Submodule vs Symlink Detection
+# ==============================================================================
+
+test_product_detection() {
+    section "Test 3: Product Detection (submodule vs symlink)"
+
+    # Check for submodule detection (has .git FILE)
+    if grep -q "It's a submodule" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Detects submodules correctly (.git as file)"
+    else
+        fail "Doesn't detect submodules"
+    fi
+
+    # Check for symlink detection
+    if grep -q "\[ -L \"\$PRODUCT_PATH\" \]" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Detects symlinks correctly"
+    else
+        fail "Doesn't detect symlinks"
+    fi
+
+    # Check for missing product handling
+    if grep -q "Initializing product submodule" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Handles missing product gracefully"
+    else
+        fail "Doesn't handle missing product"
+    fi
+
+    # Check for symlink deprecation warning
+    if grep -q "product/ is a symlink, not a submodule" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Warns about legacy symlink usage"
+    else
+        fail "Doesn't warn about symlinks (legacy pattern)"
+    fi
+}
+
+# ==============================================================================
+# Test 4: Failure Tracking
+# ==============================================================================
+
+test_failure_tracking() {
+    section "Test 4: Failure Tracking (exit codes)"
+
+    # Check that failures are tracked
+    if grep -q "FAILURES=0" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Initializes failure counter"
+    else
+        fail "Doesn't track failures"
+    fi
+
+    # Check that failures increment counter
+    if grep -q "FAILURES=\$((FAILURES + 1))" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Increments failure counter on errors"
+    else
+        fail "Doesn't increment failure counter"
+    fi
+
+    # Check that exit code reflects failures
+    if grep -A5 "if.*FAILURES.*-gt 0" "$SCRIPT_DIR/session-sync.sh" | grep -q "exit 1"; then
+        pass "Exits with code 1 when failures occur"
+    else
+        fail "Doesn't exit with error code on failures"
+    fi
+}
+
+# ==============================================================================
+# Test 5: Integration with Current Repo
+# ==============================================================================
+
+test_current_repo_integration() {
+    section "Test 5: Integration with Current Repo"
+
+    cd "$REPO_DIR"
+
+    # Test that script runs without crashing
+    if "$SCRIPT_DIR/session-sync.sh" >/dev/null 2>&1; then
+        pass "Script runs successfully on current repo"
+    else
+        exit_code=$?
+        if [[ $exit_code -eq 1 ]]; then
+            # Check if failure was due to uncommitted changes (safe failure)
+            output=$("$SCRIPT_DIR/session-sync.sh" 2>&1 || true)
+            if echo "$output" | grep -q "uncommitted changes"; then
+                pass "Script correctly fails on uncommitted changes"
+            else
+                fail "Script failed for unknown reason (exit code 1)"
+            fi
+        else
+            fail "Script crashed with exit code $exit_code"
+        fi
+    fi
+
+    # Test that it doesn't modify uncommitted changes
+    before_status=$(git status --porcelain)
+    "$SCRIPT_DIR/session-sync.sh" >/dev/null 2>&1 || true
+    after_status=$(git status --porcelain)
+
+    if [[ "$before_status" == "$after_status" ]]; then
+        pass "Doesn't modify uncommitted changes"
+    else
+        fail "DANGER: Modified uncommitted changes!"
+    fi
+}
+
+# ==============================================================================
+# Test 6: Behind/Ahead Detection
+# ==============================================================================
+
+test_behind_ahead_detection() {
+    section "Test 6: Behind/Ahead Detection"
+
+    # Check for behind detection
+    if grep -q "commits behind origin" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Detects when repo is behind origin"
+    else
+        fail "Doesn't detect behind status"
+    fi
+
+    # Check for ahead detection
+    if grep -q "commits ahead" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Detects when repo is ahead (unpushed)"
+    else
+        fail "Doesn't detect ahead status"
+    fi
+
+    # Check for up-to-date message
+    if grep -q "is up to date" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Reports when repo is up to date"
+    else
+        fail "Doesn't report up-to-date status"
+    fi
+}
+
+# ==============================================================================
+# Test 7: Recursive Submodule Update
+# ==============================================================================
+
+test_recursive_submodules() {
+    section "Test 7: Recursive Submodule Handling"
+
+    # Check for recursive submodule update
+    if grep -q "submodule update.*--recursive" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Updates submodules recursively"
+    else
+        fail "Doesn't update nested submodules"
+    fi
+
+    # Check for --init flag (initializes new submodules)
+    if grep -q "submodule update --init" "$SCRIPT_DIR/session-sync.sh"; then
+        pass "Initializes new submodules automatically"
+    else
+        fail "Doesn't initialize new submodules"
+    fi
+}
+
+# ==============================================================================
+# Run All Tests
+# ==============================================================================
+
+main() {
+    echo ""
+    echo "╔══════════════════════════════════════════════════════════╗"
+    echo "║  session-sync.sh Rigorous Testing                       ║"
+    echo "║  Before Commit Verification                             ║"
+    echo "╚══════════════════════════════════════════════════════════╝"
+
+    test_safety_checks
+    test_detached_head
+    test_product_detection
+    test_failure_tracking
+    test_current_repo_integration
+    test_behind_ahead_detection
+    test_recursive_submodules
+
+    # Summary
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${BLUE}Test Results${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${GREEN}Passed:${NC} $TESTS_PASSED"
+    if [[ $TESTS_FAILED -gt 0 ]]; then
+        echo -e "${RED}Failed:${NC} $TESTS_FAILED"
+        echo ""
+        echo -e "${RED}session-sync.sh NOT READY TO COMMIT${NC}"
+        exit 1
+    else
+        echo ""
+        echo -e "${GREEN}✓ session-sync.sh ready to commit${NC}"
+        echo ""
+        echo "Safety verified:"
+        echo "  • Won't pull over uncommitted changes"
+        echo "  • Exits with error on failure"
+        echo "  • Handles network failures gracefully"
+        echo "  • No destructive operations"
+        echo "  • Detached HEAD auto-fix"
+        echo "  • Recursive submodule updates"
+        exit 0
+    fi
+}
+
+main "$@"

package/template/scripts/where-am-i.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+#
+# where-am-i.sh - Quick context check for git operations
+#
+# Shows:
+# - Current directory
+# - Which repo you're in (GTM or product submodule)
+# - Current branch
+# - Uncommitted changes
+#
+# Usage:
+#   ./scripts/where-am-i.sh
+
+set -e
+
+CWD=$(pwd)
+
+# Colors
+BLUE='\033[0;34m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+echo ""
+echo -e "${BLUE}📍 Current Location${NC}"
+echo "─────────────────────────────────────"
+echo ""
+
+# Show current directory
+echo -e "Directory: ${GREEN}$CWD${NC}"
+
+# Detect which repo context (check for submodules first, then GTM)
+REMOTE_URL=$(git remote get-url origin 2>/dev/null || echo "")
+
+if [[ "$CWD" == *"/product"* ]] || [[ "$REMOTE_URL" == *"jfl-platform"* ]]; then
+    echo -e "Context:   ${YELLOW}product submodule${NC} (jfl-platform)"
+    echo ""
+    echo "To commit here: ./scripts/commit-product.sh \"message\""
+elif [[ "$CWD" == *"/runner"* ]] || [[ "$REMOTE_URL" == *"jfl-runner"* ]]; then
+    echo -e "Context:   ${YELLOW}runner submodule${NC} (jfl-runner)"
+    echo ""
+    echo "To commit here: cd ../; git add runner && git commit -m \"Update runner submodule\""
+elif [[ "$REMOTE_URL" == *"JFL-GTM"* ]] || [[ -f ".jfl/config.json" ]]; then
+    echo -e "Context:   ${GREEN}GTM repo${NC} (main project)"
+    echo ""
+    echo "To commit here: ./scripts/commit-gtm.sh \"message\""
+else
+    # Check if we're in any submodule
+    if git rev-parse --show-superproject-working-tree &>/dev/null; then
+        SUBMODULE_NAME=$(basename "$CWD")
+        echo -e "Context:   ${YELLOW}${SUBMODULE_NAME} submodule${NC}"
+    else
+        echo -e "Context:   ${YELLOW}unknown${NC}"
+    fi
+fi
+
+echo ""
+
+# Show current branch
+BRANCH=$(git branch --show-current 2>/dev/null || echo "detached HEAD")
+if [[ "$BRANCH" == "detached HEAD" ]]; then
+    echo -e "Branch:    ${YELLOW}⚠️  detached HEAD${NC}"
+    echo "           (run: git checkout main)"
+else
+    echo -e "Branch:    ${GREEN}$BRANCH${NC}"
+fi
+
+# Show uncommitted changes
+CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+if [[ "$CHANGES" -gt 0 ]]; then
+    echo -e "Changes:   ${YELLOW}$CHANGES uncommitted${NC}"
+    echo ""
+    git status --short
+else
+    echo -e "Changes:   ${GREEN}none (clean)${NC}"
+fi
+
+echo ""