@the-bearded-bear/claude-craft 3.3.1 → 3.3.2-next.b3cf7c7

package/Dev/scripts/install-common-rules.sh

@@ -378,6 +378,7 @@ copy_directory() {
     local src_dir="$1"
     local dest_dir="$2"
     local pattern="${3:-*}"
+    local exclude="${4:-}"  # Optional: filename to exclude
 
     if [[ ! -d "$src_dir" ]]; then
         log_error "${MSG_ERR_DIR_NOT_FOUND} $src_dir"
@@ -387,6 +388,12 @@ copy_directory() {
 
     # Process files
     while IFS= read -r -d '' file; do
+        local filename
+        filename=$(basename "$file")
+        # Skip excluded files
+        if [[ -n "$exclude" && "$filename" == "$exclude" ]]; then
+            continue
+        fi
         local relative_path="${file#$src_dir/}"
         local dest_file="$dest_dir/$relative_path"
         copy_file "$file" "$dest_file"
@@ -447,7 +454,8 @@ install_commands() {
     local dest_commands="$target_dir/.claude/commands/common"
 
     if [[ -d "$src_commands" ]]; then
-        copy_directory "$src_commands" "$dest_commands" "*.md"
+        # Exclude add-technology.md (claude-craft internal command)
+        copy_directory "$src_commands" "$dest_commands" "*.md" "add-technology.md"
     else
         log_warning "${MSG_COMMANDS_NOT_FOUND} $src_commands"
     fi
@@ -544,6 +552,10 @@ install_claude_md() {
         while IFS= read -r cmd_file; do
             local cmd_name
             cmd_name=$(basename "$cmd_file" .md)
+            # Exclude add-technology (claude-craft internal command)
+            if [[ "$cmd_name" == "add-technology" ]]; then
+                continue
+            fi
             local cmd_desc
             cmd_desc=$(grep -m1 "^description:" "$cmd_file" 2>/dev/null | sed 's/^description:[[:space:]]*//' | tr -d '"' | head -c 60)
             if [[ -n "$cmd_desc" ]]; then

package/Tools/Ralph/lib/context-manager.sh

@@ -9,16 +9,17 @@
 
 # Configuration defaults
 CONTEXT_AUTO_COMPACT="${CONTEXT_AUTO_COMPACT:-true}"
-CONTEXT_MAX_COMPACTS="${CONTEXT_MAX_COMPACTS:-3}"
+CONTEXT_MAX_COMPACTS="${CONTEXT_MAX_COMPACTS:-5}"
 
 # Advanced context management (new features)
 CONTEXT_OVERFLOW_STRATEGY="${CONTEXT_OVERFLOW_STRATEGY:-new_session}"  # new_session, extend, fail
-CONTEXT_PREVENTIVE_THRESHOLD="${CONTEXT_PREVENTIVE_THRESHOLD:-90}"     # Fallback: Compact at 90% capacity
+CONTEXT_PREVENTIVE_THRESHOLD="${CONTEXT_PREVENTIVE_THRESHOLD:-95}"     # Fallback: Compact at 95% capacity
+CONTEXT_MIN_THRESHOLD="${CONTEXT_MIN_THRESHOLD:-50}"                   # Don't compact if below this %
 CONTEXT_SMART_RECONSTRUCTION="${CONTEXT_SMART_RECONSTRUCTION:-true}"   # Use intelligent reconstruction
 CONTEXT_MAX_CONTINUATION_SESSIONS="${CONTEXT_MAX_CONTINUATION_SESSIONS:-5}"  # Max chained sessions
 
 # Note: Strategic compacts (sprint start, task complete) are preferred over % threshold
-# The 90% threshold acts as a safety net if strategic compacts miss the window
+# The 95% threshold acts as a safety net if strategic compacts miss the window
 
 # External command (default to 'claude' if not set)
 CLAUDE_COMMAND="${CLAUDE_COMMAND:-claude}"
@@ -82,6 +83,9 @@ init_context_manager() {
 
         local max_continuations=$(yq e '.context.max_continuation_sessions // ""' "$CONFIG_FILE" 2>/dev/null)
         [[ -n "$max_continuations" ]] && CONTEXT_MAX_CONTINUATION_SESSIONS=$max_continuations
+
+        local min_threshold=$(yq e '.context.min_threshold // ""' "$CONFIG_FILE" 2>/dev/null)
+        [[ -n "$min_threshold" ]] && CONTEXT_MIN_THRESHOLD=$min_threshold
     fi
 
     # Initialize sprint progress module if available
@@ -94,6 +98,7 @@ init_context_manager() {
     print_verbose "  - Max compacts: $CONTEXT_MAX_COMPACTS"
     print_verbose "  - Overflow strategy: $CONTEXT_OVERFLOW_STRATEGY"
     print_verbose "  - Preventive threshold: $CONTEXT_PREVENTIVE_THRESHOLD%"
+    print_verbose "  - Min threshold: $CONTEXT_MIN_THRESHOLD%"
     print_verbose "  - Smart reconstruction: $CONTEXT_SMART_RECONSTRUCTION"
 }
 
@@ -111,6 +116,24 @@ run_auto_compact() {
         return 1
     fi
 
+    # Check if context is above minimum threshold before compacting
+    if [[ "$CONTEXT_MIN_THRESHOLD" -gt 0 ]]; then
+        local context_info
+        if command -v timeout &> /dev/null; then
+            context_info=$(timeout 10s $CLAUDE_COMMAND -p "/context" 2>/dev/null | head -5)
+        else
+            context_info=$($CLAUDE_COMMAND -p "/context" 2>/dev/null | head -5)
+        fi
+        local current_usage
+        current_usage=$(echo "$context_info" | grep -oP '\d+(?=%)' | head -1)
+
+        if [[ -n "$current_usage" && "$current_usage" -lt "$CONTEXT_MIN_THRESHOLD" ]]; then
+            log_session "$session_id" "INFO" "Context at ${current_usage}% - below minimum threshold (${CONTEXT_MIN_THRESHOLD}%), skipping compact"
+            print_verbose "Context at ${current_usage}% - below min threshold (${CONTEXT_MIN_THRESHOLD}%), skipping compact"
+            return 1
+        fi
+    fi
+
     # Check if we've exceeded max compacts
     if [[ $CONTEXT_COMPACT_COUNT -ge $CONTEXT_MAX_COMPACTS ]]; then
         log_session "$session_id" "WARN" "Maximum compacts reached ($CONTEXT_MAX_COMPACTS)"

package/Tools/Ralph/templates/ralph.yml.template

@@ -59,7 +59,8 @@ context:
   auto_compact: true
 
   # Maximum number of compacts per session (safety limit)
-  max_compacts: 3
+  # Increased to 5 to allow longer sprints without interruption
+  max_compacts: 5
 
   # Strategy when max_compacts is reached:
   # - "new_session": Create continuation session (recommended for long sprints)
@@ -69,8 +70,14 @@ context:
 
   # Preventive compaction threshold (percentage 0-100)
   # Acts as FALLBACK safety net - strategic compacts (see sprint section) are preferred
-  # Set to 90% so it only triggers if strategic compacts miss the window
-  preventive_threshold: 90
+  # Set to 95% so it only triggers close to the limit
+  preventive_threshold: 95
+
+  # Minimum context usage threshold (percentage 0-100)
+  # Don't trigger reactive compact if context is below this threshold
+  # This prevents unnecessary compacts when context is still low
+  # Set to 0 to disable this check
+  min_threshold: 50
 
   # Enable smart context reconstruction after compact
   # Rebuilds focused context from sprint-progress.md + git + tests

package/Tools/i18n/ralph/de.sh

@@ -80,6 +80,7 @@ MSG_CONTEXT_NEW_SESSION="Fortsetzungssitzung wird erstellt"
 MSG_CONTEXT_EXTEND="Compact-Limit erweitert"
 MSG_CONTEXT_OVERFLOW_FAIL="Kontextlimit uberschritten, wird gestoppt"
 MSG_CONTEXT_PREVENTIVE="Kontext bei {0}% - praventives Compact"
+MSG_CONTEXT_BELOW_MIN="Kontext bei {0}% - unter Mindestschwelle ({1}%), Compact ubersprungen"
 MSG_CONTEXT_CONTINUATION_CREATED="Fortsetzungssitzung erstellt"
 MSG_CONTEXT_MAX_CONTINUATIONS="Maximale Fortsetzungssitzungen erreicht"
 MSG_CONTEXT_RECONSTRUCTING="Kontext wird aus Fortschrittsdatei rekonstruiert"

package/Tools/i18n/ralph/en.sh

@@ -80,6 +80,7 @@ MSG_CONTEXT_NEW_SESSION="Creating continuation session"
 MSG_CONTEXT_EXTEND="Extended max compacts"
 MSG_CONTEXT_OVERFLOW_FAIL="Context limit exceeded, stopping"
 MSG_CONTEXT_PREVENTIVE="Context at {0}% - running preventive compact"
+MSG_CONTEXT_BELOW_MIN="Context at {0}% - below minimum threshold ({1}%), skipping compact"
 MSG_CONTEXT_CONTINUATION_CREATED="Continuation session created"
 MSG_CONTEXT_MAX_CONTINUATIONS="Maximum continuation sessions reached"
 MSG_CONTEXT_RECONSTRUCTING="Reconstructing context from progress file"

package/Tools/i18n/ralph/es.sh

@@ -80,6 +80,7 @@ MSG_CONTEXT_NEW_SESSION="Creando sesion de continuacion"
 MSG_CONTEXT_EXTEND="Extension del limite de compacts"
 MSG_CONTEXT_OVERFLOW_FAIL="Limite de contexto excedido, deteniendo"
 MSG_CONTEXT_PREVENTIVE="Contexto al {0}% - compact preventivo"
+MSG_CONTEXT_BELOW_MIN="Contexto al {0}% - bajo umbral minimo ({1}%), compact omitido"
 MSG_CONTEXT_CONTINUATION_CREATED="Sesion de continuacion creada"
 MSG_CONTEXT_MAX_CONTINUATIONS="Maximo de sesiones de continuacion alcanzado"
 MSG_CONTEXT_RECONSTRUCTING="Reconstruyendo contexto desde archivo de progreso"

package/Tools/i18n/ralph/fr.sh

@@ -80,6 +80,7 @@ MSG_CONTEXT_NEW_SESSION="Creation de session de continuation"
 MSG_CONTEXT_EXTEND="Extension de la limite de compacts"
 MSG_CONTEXT_OVERFLOW_FAIL="Limite de contexte depassee, arret"
 MSG_CONTEXT_PREVENTIVE="Contexte a {0}% - compact preventif"
+MSG_CONTEXT_BELOW_MIN="Contexte a {0}% - en dessous du seuil minimum ({1}%), compact ignore"
 MSG_CONTEXT_CONTINUATION_CREATED="Session de continuation creee"
 MSG_CONTEXT_MAX_CONTINUATIONS="Nombre maximum de sessions de continuation atteint"
 MSG_CONTEXT_RECONSTRUCTING="Reconstruction du contexte depuis le fichier de progres"

package/Tools/i18n/ralph/pt.sh

@@ -80,6 +80,7 @@ MSG_CONTEXT_NEW_SESSION="Criando sessao de continuacao"
 MSG_CONTEXT_EXTEND="Limite de compacts estendido"
 MSG_CONTEXT_OVERFLOW_FAIL="Limite de contexto excedido, parando"
 MSG_CONTEXT_PREVENTIVE="Contexto em {0}% - compact preventivo"
+MSG_CONTEXT_BELOW_MIN="Contexto em {0}% - abaixo do limite minimo ({1}%), compact ignorado"
 MSG_CONTEXT_CONTINUATION_CREATED="Sessao de continuacao criada"
 MSG_CONTEXT_MAX_CONTINUATIONS="Maximo de sessoes de continuacao atingido"
 MSG_CONTEXT_RECONSTRUCTING="Reconstruindo contexto do arquivo de progresso"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-bearded-bear/claude-craft",
-  "version": "3.3.1",
+  "version": "3.3.2-next.b3cf7c7",
   "description": "A comprehensive framework for AI-assisted development with Claude Code. Install standardized rules, agents, and commands for your projects.",
   "main": "cli/index.js",
   "bin": {