jfl 0.0.0

package/template/knowledge/VOICE_AND_TONE.md

@@ -0,0 +1,146 @@
+# Voice and Tone Guide
+
+> How your brand speaks. Copy to `knowledge/VOICE_AND_TONE.md` and customize.
+
+---
+
+## Voice (Consistent)
+
+Your voice is WHO you are. It stays consistent across all contexts.
+
+### Voice Attributes
+
+**We are:**
+- {attribute 1} - {what this means in practice}
+- {attribute 2} - {what this means in practice}
+- {attribute 3} - {what this means in practice}
+
+**We are NOT:**
+- {anti-attribute 1}
+- {anti-attribute 2}
+- {anti-attribute 3}
+
+### Voice Examples
+
+| Instead of | We say |
+|------------|--------|
+| "Leverage synergies" | {plain language version} |
+| "Click here" | {more engaging version} |
+| "Dear valued customer" | {your version} |
+
+---
+
+## Tone (Flexible)
+
+Tone is HOW you express your voice in different contexts. It shifts based on situation.
+
+### Tone Spectrum
+
+```
+Serious ←────────────────────────────→ Playful
+       Where do you sit by default?
+
+Formal ←────────────────────────────→ Casual
+       Where do you sit by default?
+
+Reserved ←────────────────────────────→ Enthusiastic
+       Where do you sit by default?
+```
+
+### Tone by Context
+
+| Context | Tone Adjustment |
+|---------|-----------------|
+| Error messages | More empathetic, helpful |
+| Success messages | More celebratory |
+| Documentation | More neutral, clear |
+| Marketing | More energetic |
+| Support | More patient, detailed |
+
+---
+
+## Copy Patterns
+
+### Headlines
+- {Pattern: question / statement / command}
+- {Case: lowercase / Title Case / UPPERCASE}
+- {Length: short punchy / descriptive}
+
+**Examples:**
+- Good: "{example}"
+- Avoid: "{anti-example}"
+
+### Body Copy
+- {Sentence length preference}
+- {Paragraph length}
+- {Use of contractions: yes/no}
+
+### CTAs (Calls to Action)
+- {Action verbs you prefer}
+- {Length: short / descriptive}
+
+**Examples:**
+- Good: "{example}"
+- Avoid: "{anti-example}"
+
+---
+
+## Formatting Conventions
+
+### Punctuation
+- **Periods in headlines:** {yes/no}
+- **Oxford comma:** {yes/no}
+- **Exclamation points:** {rarely/sometimes/often}
+
+### Capitalization
+- **Headings:** {lowercase / Title Case / Sentence case}
+- **Buttons:** {lowercase / Title Case / UPPERCASE}
+- **Product names:** {how to capitalize your product name}
+
+### Special Characters
+- **Emoji:** {never / sparingly / freely}
+- **Terminal characters:** {>, //, $, etc.}
+
+---
+
+## Word List
+
+### Words We Use
+| Word | Instead of | Why |
+|------|------------|-----|
+| {your word} | {common alternative} | {reason} |
+
+### Words We Avoid
+| Avoid | Because |
+|-------|---------|
+| {word} | {reason} |
+
+---
+
+## Sample Copy
+
+### Tagline
+> "{your tagline}"
+
+### Elevator Pitch (1 sentence)
+> "{one sentence description}"
+
+### Boilerplate (1 paragraph)
+> "{standard description paragraph}"
+
+### Error Message Example
+> "{example error in your voice}"
+
+### Success Message Example
+> "{example success in your voice}"
+
+---
+
+## Voice Checklist
+
+Before publishing, ask:
+- [ ] Does this sound like us?
+- [ ] Would we say this out loud?
+- [ ] Is it clear to our audience?
+- [ ] Does it match the context's tone?
+- [ ] Are we avoiding our "don't" words?

package/template/scripts/session/auto-commit.sh

@@ -0,0 +1,245 @@
+#!/bin/bash
+#
+# Auto-commit script for JFL projects
+# Runs in background, commits changes at specified interval
+#
+# Usage:
+#   ./scripts/session/auto-commit.sh start [INTERVAL]  # Start (default 120s)
+#   ./scripts/session/auto-commit.sh stop              # Stop background process
+#   ./scripts/session/auto-commit.sh status            # Check if running
+#   ./scripts/session/auto-commit.sh once              # Run once (for testing)
+#
+# Merges best of:
+# - Original JFL auto-commit (smart messages, author detection, pull first)
+# - Session protection (push after, product handling, faster interval)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Use current working directory (where script is called from), not script location
+REPO_DIR="$(pwd)"
+PID_FILE="$REPO_DIR/.jfl/auto-commit.pid"
+LOG_FILE="$REPO_DIR/.jfl/auto-commit.log"
+INTERVAL=${2:-120}  # Default 2 minutes (was 5 in original)
+
+mkdir -p "$REPO_DIR/.jfl"
+cd "$REPO_DIR" || exit 1
+
+# Critical paths to always include
+CRITICAL_PATHS=(
+    "knowledge/"
+    "previews/"
+    "content/"
+    "suggestions/"
+    "CLAUDE.md"
+    ".jfl/"
+)
+
+do_commit() {
+    # Pull latest first (sync with team) - from original
+    git pull --rebase --quiet 2>/dev/null || true
+
+    # Build paths string
+    local paths=""
+    for p in "${CRITICAL_PATHS[@]}"; do
+        if [ -e "$p" ]; then
+            paths="$paths $p"
+        fi
+    done
+
+    # Check for changes
+    if [[ -z $(git status --porcelain $paths 2>/dev/null) ]]; then
+        return 0  # Nothing to commit
+    fi
+
+    # Get list of changed files for commit message - from original
+    CHANGED=$(git status --porcelain $paths | head -5 | awk '{print $2}' | tr '\n' ', ' | sed 's/,$//')
+    CHANGE_COUNT=$(git status --porcelain $paths | wc -l | tr -d ' ')
+
+    # Try to identify who's working (check recent suggestions files) - from original
+    AUTHOR="auto"
+    RECENT_SUGGESTION=$(ls -t suggestions/*.md 2>/dev/null | head -1)
+    if [[ -n "$RECENT_SUGGESTION" ]]; then
+        AUTHOR=$(basename "$RECENT_SUGGESTION" .md)
+    fi
+
+    # Generate commit message - from original style
+    if [[ $CHANGE_COUNT -gt 5 ]]; then
+        MSG="$AUTHOR: auto-save ($CHANGE_COUNT files including $CHANGED...)"
+    else
+        MSG="$AUTHOR: auto-save ($CHANGED)"
+    fi
+
+    # Commit
+    git add $paths
+    git commit -m "$MSG" || return 0
+
+    # Push after commit - from ours
+    git push origin main 2>/dev/null || echo "[$(date '+%H:%M:%S')] Push failed - will retry"
+
+    echo "[$(date '+%H:%M:%S')] Committed: $MSG"
+}
+
+# Commit and push changes in ALL submodules with feature branches
+commit_submodules_if_changes() {
+    local submodules_dir="$REPO_DIR/.jfl/submodules"
+
+    # If no submodules directory, fall back to legacy product-only handling
+    if [[ ! -d "$submodules_dir" ]]; then
+        # Legacy: check for product-branch file
+        local product_branch_file="$REPO_DIR/.jfl/product-branch"
+        if [[ -f "$product_branch_file" ]]; then
+            commit_single_submodule "product" "$(cat "$product_branch_file")"
+        fi
+        return 0
+    fi
+
+    # Iterate through all submodule branch files (use find for nested paths like libs/mylib)
+    while IFS= read -r -d '' branch_file; do
+        if [[ -f "$branch_file" ]]; then
+            # Get submodule path by stripping the prefix directory
+            local submodule_path="${branch_file#$submodules_dir/}"
+            local target_branch=$(cat "$branch_file")
+            commit_single_submodule "$submodule_path" "$target_branch"
+        fi
+    done < <(find "$submodules_dir" -type f -print0 2>/dev/null)
+}
+
+# Commit changes in a single submodule
+commit_single_submodule() {
+    local submodule_path="$1"
+    local target_branch="$2"
+    local full_path="$REPO_DIR/$submodule_path"
+
+    # Resolve symlink if needed
+    if [[ -L "$full_path" ]]; then
+        full_path=$(cd "$full_path" 2>/dev/null && pwd) || return 0
+    fi
+
+    # Check if submodule has git
+    if [[ -d "$full_path/.git" ]] || [[ -f "$full_path/.git" ]]; then
+        cd "$full_path"
+
+        if [[ -n $(git status --porcelain 2>/dev/null) ]]; then
+            # Make sure we're on the right branch
+            local current_branch=$(git branch --show-current 2>/dev/null)
+            if [[ "$current_branch" != "$target_branch" ]] && [[ "$target_branch" != "main" ]]; then
+                git checkout "$target_branch" 2>/dev/null || true
+            fi
+
+            git add -A
+            git commit -m "auto: $submodule_path save ($(date '+%Y-%m-%d %H:%M'))" || true
+
+            # Push to feature branch (NOT main)
+            if [[ "$target_branch" != "main" ]]; then
+                git push origin "$target_branch" 2>/dev/null || true
+                echo "[$(date '+%H:%M:%S')] $submodule_path committed to branch: $target_branch"
+            else
+                # No feature branch - warn but don't push to main
+                echo "[$(date '+%H:%M:%S')] $submodule_path committed locally (no feature branch set)"
+            fi
+        fi
+
+        cd "$REPO_DIR"
+    fi
+}
+
+start_daemon() {
+    if [[ -f "$PID_FILE" ]]; then
+        local pid=$(cat "$PID_FILE")
+        if kill -0 "$pid" 2>/dev/null; then
+            echo "Auto-commit already running (PID: $pid)"
+            return 0
+        fi
+        rm -f "$PID_FILE"
+    fi
+
+    echo "Starting auto-commit daemon (interval: ${INTERVAL}s)..."
+
+    # Run in background (match original JFL pattern)
+    # Close inherited file descriptors so parent doesn't wait for us
+    (
+        exec </dev/null >/dev/null 2>&1
+        while true; do
+            {
+                echo "[$(date '+%H:%M:%S')] Checking for changes..."
+                do_commit
+                commit_submodules_if_changes
+            } >> "$LOG_FILE" 2>&1
+            sleep "$INTERVAL"
+        done
+    ) &
+
+    DAEMON_PID=$!
+    echo "$DAEMON_PID" > "$PID_FILE"
+    echo "Auto-commit started (PID: $DAEMON_PID)"
+    echo "Log: $LOG_FILE"
+}
+
+stop_daemon() {
+    if [[ -f "$PID_FILE" ]]; then
+        local pid=$(cat "$PID_FILE")
+        if kill -0 "$pid" 2>/dev/null; then
+            echo "Stopping auto-commit (PID: $pid)..."
+            kill "$pid" 2>/dev/null
+            rm -f "$PID_FILE"
+            echo "Stopped."
+        else
+            echo "Process not running (stale PID file)"
+            rm -f "$PID_FILE"
+        fi
+    else
+        echo "Auto-commit not running"
+    fi
+}
+
+show_status() {
+    if [[ -f "$PID_FILE" ]]; then
+        local pid=$(cat "$PID_FILE")
+        if kill -0 "$pid" 2>/dev/null; then
+            echo "Auto-commit running (PID: $pid)"
+            echo "Interval: ${INTERVAL}s"
+            echo "Log: $LOG_FILE"
+            echo ""
+            echo "Recent activity:"
+            tail -5 "$LOG_FILE" 2>/dev/null || echo "  (no log yet)"
+            return 0
+        fi
+    fi
+    echo "Auto-commit not running"
+    return 1
+}
+
+run_once() {
+    echo "Running single commit check..."
+    do_commit
+    commit_submodules_if_changes
+    echo "Done."
+}
+
+case "${1:-}" in
+    start)
+        start_daemon
+        ;;
+    stop)
+        stop_daemon
+        ;;
+    status)
+        show_status
+        ;;
+    once)
+        run_once
+        ;;
+    *)
+        echo "Auto-commit for JFL projects"
+        echo ""
+        echo "Usage:"
+        echo "  $0 start [INTERVAL]  Start daemon (default: 120s)"
+        echo "  $0 stop              Stop daemon"
+        echo "  $0 status            Show status"
+        echo "  $0 once              Run once"
+        echo ""
+        echo "Examples:"
+        echo "  $0 start 60          Start with 1-minute interval"
+        echo "  $0 start             Start with 2-minute interval"
+        exit 1
+        ;;
+esac