chore: finish bitlesson path migration cleanup

Author: zenus

agents/bitlesson-selector.md

@@ -7,14 +7,14 @@ tools: Read, Grep
 
 # BitLesson Selector
 
-You select which lessons from `bitlesson.md` must be applied for a given sub-task.
+You select which lessons from the configured BitLesson file, normally `.humanize/bitlesson.md`, must be applied for a given sub-task.
 
 ## Input
 
 You will receive:
 - Current sub-task description
 - Related file paths
-- The project `bitlesson.md` content
+- The project BitLesson content from the configured file, normally `.humanize/bitlesson.md`
 
 ## Cross-Agent Review Context
 

bitlesson.md

@@ -585,8 +585,9 @@ if [[ "$GIT_IS_REPO" == "true" ]]; then
 
     # Check for uncommitted changes (staged or unstaged) using cached status.
     # Exclude untracked .humanize/ paths and .humanize-* dash-separated legacy
-    # variants from the dirty determination because local plugin state
-    # (bitlesson.md, config.json, rlcr/) is intentionally untracked.
+    # variants from the dirty determination because local plugin state under
+    # .humanize/ (.humanize/bitlesson.md, config.json, rlcr/) is intentionally
+    # untracked.
     HUMANIZE_UNTRACKED_PATTERN='^\?\? \.humanize[-/]'
     GIT_STATUS_FOR_BLOCK=$(echo "$GIT_STATUS_CACHED" | grep -vE "$HUMANIZE_UNTRACKED_PATTERN" || true)
     if [[ -n "$GIT_STATUS_FOR_BLOCK" ]]; then

hooks/loop-codex-stop-hook.sh

@@ -15,11 +15,11 @@ echo "Bitlesson Select Routing Tests"
 echo "=========================================="
 echo ""
 
-# Helper: create a mock bitlesson.md with required content
+# Helper: create a mock .humanize/bitlesson.md with required content
 create_mock_bitlesson() {
     local dir="$1"
-    mkdir -p "$dir"
-    cat > "$dir/bitlesson.md" <<'EOF'
+    mkdir -p "$dir/.humanize"
+    cat > "$dir/.humanize/bitlesson.md" <<'EOF'
 # BitLesson Knowledge Base
 ## Entries
 <!-- placeholder -->
@@ -78,7 +78,7 @@ result=$(CLAUDE_PROJECT_DIR="$TEST_DIR" XDG_CONFIG_HOME="$TEST_DIR/no-user" \
     bash "$BITLESSON_SELECT" \
     --task "Fix a bug" \
     --paths "scripts/bitlesson-select.sh" \
-    --bitlesson-file "$TEST_DIR/bitlesson.md" 2>/dev/null) || exit_code=$?
+    --bitlesson-file "$TEST_DIR/.humanize/bitlesson.md" 2>/dev/null) || exit_code=$?
 
 if [[ $exit_code -eq 0 ]] && echo "$result" | grep -q "LESSON_IDS:"; then
     pass "Codex branch: gpt-* model routes to codex (produces LESSON_IDS output)"
@@ -107,7 +107,7 @@ result=$(CLAUDE_PROJECT_DIR="$TEST_DIR" XDG_CONFIG_HOME="$TEST_DIR/no-user" \
     bash "$BITLESSON_SELECT" \
     --task "Fix a bug" \
     --paths "scripts/bitlesson-select.sh" \
-    --bitlesson-file "$TEST_DIR/bitlesson.md" 2>/dev/null) || exit_code=$?
+    --bitlesson-file "$TEST_DIR/.humanize/bitlesson.md" 2>/dev/null) || exit_code=$?
 
 if [[ $exit_code -eq 0 ]] && echo "$result" | grep -q "LESSON_IDS:"; then
     pass "Claude branch: haiku model routes to claude (produces LESSON_IDS output)"
@@ -136,7 +136,7 @@ result=$(CLAUDE_PROJECT_DIR="$TEST_DIR" XDG_CONFIG_HOME="$TEST_DIR/no-user" \
     bash "$BITLESSON_SELECT" \
     --task "Refactor logic" \
     --paths "scripts/bitlesson-select.sh" \
-    --bitlesson-file "$TEST_DIR/bitlesson.md" 2>/dev/null) || exit_code=$?
+    --bitlesson-file "$TEST_DIR/.humanize/bitlesson.md" 2>/dev/null) || exit_code=$?
 
 if [[ $exit_code -eq 0 ]] && echo "$result" | grep -q "LESSON_IDS:"; then
     pass "Claude branch: sonnet model routes to claude (produces LESSON_IDS output)"
@@ -165,7 +165,7 @@ result=$(CLAUDE_PROJECT_DIR="$TEST_DIR" XDG_CONFIG_HOME="$TEST_DIR/no-user" \
     bash "$BITLESSON_SELECT" \
     --task "Write docs" \
     --paths "scripts/bitlesson-select.sh" \
-    --bitlesson-file "$TEST_DIR/bitlesson.md" 2>/dev/null) || exit_code=$?
+    --bitlesson-file "$TEST_DIR/.humanize/bitlesson.md" 2>/dev/null) || exit_code=$?
 
 if [[ $exit_code -eq 0 ]] && echo "$result" | grep -q "LESSON_IDS:"; then
     pass "Claude branch: OPUS (uppercase) model routes to claude (case-insensitive match)"
@@ -191,7 +191,7 @@ stderr_out=$(CLAUDE_PROJECT_DIR="$TEST_DIR" XDG_CONFIG_HOME="$TEST_DIR/no-user"
     bash "$BITLESSON_SELECT" \
     --task "Fix a bug" \
     --paths "scripts/bitlesson-select.sh" \
-    --bitlesson-file "$TEST_DIR/bitlesson.md" 2>&1 >/dev/null) || exit_code=$?
+    --bitlesson-file "$TEST_DIR/.humanize/bitlesson.md" 2>&1 >/dev/null) || exit_code=$?
 
 if [[ $exit_code -ne 0 ]] && echo "$stderr_out" | grep -qiE "unknown|error"; then
     pass "Unknown model: exits non-zero with clear error message"
@@ -227,7 +227,7 @@ stderr_out=$(CLAUDE_PROJECT_DIR="$TEST_DIR" XDG_CONFIG_HOME="$TEST_DIR/no-user"
     bash "$BITLESSON_SELECT" \
     --task "Fix a bug" \
     --paths "scripts/bitlesson-select.sh" \
-    --bitlesson-file "$TEST_DIR/bitlesson.md" 2>&1 >/dev/null) || exit_code=$?
+    --bitlesson-file "$TEST_DIR/.humanize/bitlesson.md" 2>&1 >/dev/null) || exit_code=$?
 
 if [[ $exit_code -ne 0 ]] && echo "$stderr_out" | grep -qi "codex"; then
     pass "Codex branch: missing codex binary exits non-zero with informative error"
@@ -264,7 +264,7 @@ stdout_out=$(CLAUDE_PROJECT_DIR="$TEST_DIR" XDG_CONFIG_HOME="$TEST_DIR/no-user"
     bash "$BITLESSON_SELECT" \
     --task "Fix a bug" \
     --paths "scripts/bitlesson-select.sh" \
-    --bitlesson-file "$TEST_DIR/bitlesson.md" 2>/dev/null) || exit_code=$?
+    --bitlesson-file "$TEST_DIR/.humanize/bitlesson.md" 2>/dev/null) || exit_code=$?
 
 if [[ $exit_code -eq 0 ]] && echo "$stdout_out" | grep -q "LESSON_IDS: NONE"; then
     pass "Claude model falls back to codex when claude binary is missing"

tests/test-bitlesson-select-routing.sh

@@ -21,6 +21,7 @@ echo ""
 make_bitlesson_file() {
     local path="$1"
 
+    mkdir -p "$(dirname "$path")"
     cat > "$path" <<EOF
 # BitLesson
 
@@ -94,7 +95,7 @@ assert_passes() {
 }
 
 setup_test_dir
-BITLESSON_FILE="$TEST_DIR/bitlesson.md"
+BITLESSON_FILE="$TEST_DIR/.humanize/bitlesson.md"
 make_bitlesson_file "$BITLESSON_FILE"
 
 SUMMARY_FILE="$TEST_DIR/add-empty-notes.md"

tests/test-bitlesson-validate-delta.sh

@@ -5,7 +5,8 @@
 # Covers:
 # - Untracked legacy .humanize-* directories do not trigger git-dirty blocks
 # - Untracked .humanizeconfig still triggers git-dirty blocks as a real file
-# - Legacy loops without bitlesson_required stay disabled even if bitlesson.md exists
+# - Legacy loops without bitlesson_required stay disabled even if
+#   .humanize/bitlesson.md exists
 #
 
 set -euo pipefail
@@ -182,10 +183,10 @@ create_stop_hook_fixture "$TEST2_REPO" true
 run_stop_hook "$TEST2_REPO"
 
 if [[ "$RUN_EXIT_CODE" -eq 0 ]] && [[ -f "$RUN_MARKER" ]]; then
-    pass "Legacy loops without bitlesson_required still reach Codex even when bitlesson.md exists"
+    pass "Legacy loops without bitlesson_required still reach Codex even when .humanize/bitlesson.md exists"
 else
     fail \
-        "Legacy loops without bitlesson_required still reach Codex even when bitlesson.md exists" \
+        "Legacy loops without bitlesson_required still reach Codex even when .humanize/bitlesson.md exists" \
         "exit 0 and Codex invoked" \
         "exit $RUN_EXIT_CODE, marker=$(test -f "$RUN_MARKER" && echo present || echo missing), output: $RUN_OUTPUT"
 fi