@sebastienrousseau/dotfiles 0.2.511 → 0.2.513

package/scripts/version-sync.sh

@@ -24,6 +24,7 @@ EXCLUDE_FILES=(
   "docs/reference/FONTS.md"
   "docs/archive/LEGACY_ROADMAP.md"
   "docs/archive/PLAN.md"
+  "ROADMAP.md"
 
   # Roadmap + audit narratives — describe per-version work; refs to
   # prior versions are intentional and historical.
@@ -86,7 +87,7 @@ EXCLUDE_FILES=(
   "docs/operations/ARCHITECTURE_ROADMAP.md"
 
   # Dated release write-ups: each article records the release it
-  # shipped in (e.g. "shipped in v0.2.510" + a link to that release
+  # shipped in (e.g. "shipped in vX.Y.Z" + a link to that release
   # tag). Those refs are historical fact, not current-version claims —
   # bumping them would falsify the history.
   "docs/articles/2026-07-05-fish-startup-abbr.md"
@@ -156,7 +157,11 @@ get_package_version() {
   fi
 
   local version
-  version=$(jq -r '.version' "$package_file" 2>/dev/null)
+  if command -v jq &>/dev/null; then
+    version=$(jq -r '.version' "$package_file" 2>/dev/null)
+  else
+    version=$(sed -nE 's/^[[:space:]]*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/p' "$package_file" | head -n 1)
+  fi
   if [[ "$version" == "null" || -z "$version" ]]; then
     log_error "Could not extract version from package.json"
     exit 1
@@ -186,22 +191,32 @@ find_version_files() {
   # the paths match the EXCLUDE_FILES entries (which have no "./"),
   # otherwise excluded historical docs get rewritten.
   cd "$PROJECT_ROOT"
-  rg -l "v?$VERSION_PATTERN" --type md . 2>/dev/null | sed 's|^\./||' >"$temp_file" || true
+  if command -v rg &>/dev/null; then
+    rg -l "v?$VERSION_PATTERN" --type md . 2>/dev/null | sed 's|^\./||' >"$temp_file" || true
+  else
+    {
+      while IFS= read -r file; do
+        if grep -Eq "v?$VERSION_PATTERN" "$file" 2>/dev/null; then
+          printf '%s\n' "${file#./}"
+        fi
+      done < <(find . -type f -name '*.md' -print)
+    } >"$temp_file"
+  fi
 
   # Add known files that should be checked even if they don't have versions yet
-  echo "README.md" >>"$temp_file"
-  echo "docs/reference/FEATURES.md" >>"$temp_file"
-  echo "docs/COPYRIGHT" >>"$temp_file"
-
   # Non-markdown and hidden-directory surfaces rg's `--type md` scan above
   # cannot reach: a shell script, and READMEs under the dotfile-hidden
   # `.chezmoitemplates/` tree (rg skips dot-dirs without --hidden). These
   # carry "current version" stamps that check-version-consistency.sh and
   # the test_version_consistency unit test enforce, so keep them in sync.
-  echo "scripts/git-hooks/pre-commit-audit.sh" >>"$temp_file"
-  echo "defaults/.chezmoitemplates/README.md" >>"$temp_file"
-  echo "defaults/.chezmoitemplates/functions/README.md" >>"$temp_file"
-  echo "defaults/.chezmoitemplates/aliases/README.md" >>"$temp_file"
+  printf '%s\n' \
+    "README.md" \
+    "docs/reference/FEATURES.md" \
+    "docs/COPYRIGHT" \
+    "scripts/git-hooks/pre-commit-audit.sh" \
+    "defaults/.chezmoitemplates/README.md" \
+    "defaults/.chezmoitemplates/functions/README.md" \
+    "defaults/.chezmoitemplates/aliases/README.md" >>"$temp_file"
 
   # Remove duplicates and filter existing files
   sort -u "$temp_file" | while IFS= read -r file; do
@@ -268,6 +283,7 @@ update_version_references() {
       log_warning "File not found: $file"
       continue
     fi
+    files_processed=$((files_processed + 1))
 
     # Skip milestone and other historical files
     if [[ "$(basename "$file")" == MILESTONE_* ]]; then
@@ -300,6 +316,10 @@ update_version_references() {
         sed_in_place "$temp_file" \
           -e "s|v$SED_VERSION_PATTERN standards maintained|v$target_version standards maintained|g"
         ;;
+      "docs/manual/00-introduction.md")
+        sed_in_place "$temp_file" \
+          -e "s|\.dotfiles\` v$SED_VERSION_PATTERN|.dotfiles\` v$target_version|g"
+        ;;
       *)
         # Update explicit markdown version labels, backticks, and parentheses.
         # Skip lines containing MILESTONE.
@@ -328,6 +348,7 @@ update_version_references() {
         cat "$temp_file" >"$file"
         log_success "Updated: $file"
       fi
+      rm -f "$temp_file"
       changes_made=$((changes_made + 1))
     else
       log_info "No changes needed: $file"
@@ -367,26 +388,49 @@ verify_version_consistency() {
 
     # Extract only dotfiles-targeted version references (ignore unrelated tool versions).
     local versions_in_file=()
-    while IFS= read -r match; do
-      while IFS= read -r version; do
-        versions_in_file+=("$version")
-      done < <(printf "%s\n" "$match" | rg -o "v?$VERSION_PATTERN" || true)
-    done < <(
-      rg -v "MILESTONE" "$file" 2>/dev/null | rg -o \
-        -e "Version-v$VERSION_PATTERN" \
-        -e "/releases/tag/v$VERSION_PATTERN" \
-        -e "/dotfiles/v$VERSION_PATTERN/" \
-        -e "\\*\\*Version\\*\\*:[[:space:]]*v?$VERSION_PATTERN" \
-        -e "\\*\\*Dotfiles Version\\*\\*:[[:space:]]*v?$VERSION_PATTERN" \
-        -e "(^|[[:space:]])Version:[[:space:]]*v?$VERSION_PATTERN" \
-        -e "(^|[[:space:]])Dotfiles Version:[[:space:]]*v?$VERSION_PATTERN" \
-        -e "Version[[:space:]]*\`v?$VERSION_PATTERN\`" \
-        -e "\\(v$VERSION_PATTERN\\)" \
-        -e "/v$VERSION_PATTERN/" \
-        -e "v$VERSION_PATTERN\\b" \
-        -e "dotfiles:v?$VERSION_PATTERN" \
-        -e "notes — v$VERSION_PATTERN" || true
-    )
+    if command -v rg &>/dev/null; then
+      while IFS= read -r match; do
+        while IFS= read -r version; do
+          versions_in_file+=("$version")
+        done < <(printf "%s\n" "$match" | rg -o "v?$VERSION_PATTERN" || true)
+      done < <(
+        rg -v "MILESTONE" "$file" 2>/dev/null | rg -o \
+          -e "Version-v$VERSION_PATTERN" \
+          -e "/releases/tag/v$VERSION_PATTERN" \
+          -e "/dotfiles/v$VERSION_PATTERN/" \
+          -e "\\*\\*Version\\*\\*:[[:space:]]*v?$VERSION_PATTERN" \
+          -e "\\*\\*Dotfiles Version\\*\\*:[[:space:]]*v?$VERSION_PATTERN" \
+          -e "(^|[[:space:]])Version:[[:space:]]*v?$VERSION_PATTERN" \
+          -e "(^|[[:space:]])Dotfiles Version:[[:space:]]*v?$VERSION_PATTERN" \
+          -e "Version[[:space:]]*\`v?$VERSION_PATTERN\`" \
+          -e "\\(v$VERSION_PATTERN\\)" \
+          -e "/v$VERSION_PATTERN/" \
+          -e "v$VERSION_PATTERN\\b" \
+          -e "dotfiles:v?$VERSION_PATTERN" \
+          -e "notes — v$VERSION_PATTERN" || true
+      )
+    else
+      while IFS= read -r match; do
+        while IFS= read -r version; do
+          versions_in_file+=("$version")
+        done < <(printf "%s\n" "$match" | grep -Eo "v?$VERSION_PATTERN" || true)
+      done < <(
+        grep -Ev "MILESTONE" "$file" 2>/dev/null | grep -Eo \
+          -e "Version-v$VERSION_PATTERN" \
+          -e "/releases/tag/v$VERSION_PATTERN" \
+          -e "/dotfiles/v$VERSION_PATTERN/" \
+          -e "\\*\\*Version\\*\\*:[[:space:]]*v?$VERSION_PATTERN" \
+          -e "\\*\\*Dotfiles Version\\*\\*:[[:space:]]*v?$VERSION_PATTERN" \
+          -e "(^|[[:space:]])Version:[[:space:]]*v?$VERSION_PATTERN" \
+          -e "(^|[[:space:]])Dotfiles Version:[[:space:]]*v?$VERSION_PATTERN" \
+          -e "Version[[:space:]]*\`v?$VERSION_PATTERN\`" \
+          -e "\\(v$VERSION_PATTERN\\)" \
+          -e "/v$VERSION_PATTERN/" \
+          -e "v$VERSION_PATTERN([^0-9.]|$)" \
+          -e "dotfiles:v?$VERSION_PATTERN" \
+          -e "notes — v$VERSION_PATTERN" || true
+      )
+    fi
 
     if [[ ${#versions_in_file[@]} -eq 0 ]]; then
       continue
@@ -457,6 +501,12 @@ main() {
     esac
   done
 
+  if [[ -n "${DOTFILES_COV_TMPDIR:-}" && "${DOTFILES_ALLOW_COVERAGE_WRITES:-0}" != "1" ]]; then
+    dry_run="true"
+    create_backup_flag="false"
+    log_info "Coverage sandbox detected; forcing --dry-run"
+  fi
+
   # Change to project root
   cd "$PROJECT_ROOT"
 
@@ -470,8 +520,11 @@ main() {
   fi
 
   # Find files with version references
-  local version_files
-  readarray -t version_files < <(find_version_files)
+  local version_files=()
+  local version_file
+  while IFS= read -r version_file; do
+    version_files+=("$version_file")
+  done < <(find_version_files)
 
   if [[ ${#version_files[@]} -eq 0 ]]; then
     log_warning "No files with version references found"
@@ -509,11 +562,33 @@ main() {
     fi
   fi
 
+  # package.json is the release-tooling source used when VERSION is omitted.
+  # A caller-supplied target must update it atomically before downstream
+  # verification, otherwise the repository immediately contains two versions.
+  local package_json="$PROJECT_ROOT/package.json"
+  if [[ "$dry_run" == "true" ]]; then
+    log_info "Would update package.json: version = \"$target_version\""
+  else
+    local package_tmp
+    package_tmp=$(umask 077 && mktemp)
+    if command -v jq >/dev/null 2>&1; then
+      jq --arg version "$target_version" '.version = $version' "$package_json" >"$package_tmp"
+    else
+      cp "$package_json" "$package_tmp"
+      sed_in_place "$package_tmp" "s|\"version\": \"$SED_VERSION_PATTERN\"|\"version\": \"$target_version\"|"
+    fi
+    cat "$package_tmp" >"$package_json"
+    rm -f "$package_tmp"
+    log_success "Updated package.json"
+  fi
+
   # Sync non-template script files that embed the version
   local script_files=(
     "bin/dot"
     "dot_local/bin/executable_tour"
     "install.sh"
+    "lib/dot/bento.sh"
+    "share/man/man1/dot.1"
   )
   for script_file in "${script_files[@]}"; do
     local full_path="$PROJECT_ROOT/$script_file"
@@ -574,16 +649,5 @@ EOF
   fi
 }
 
-# Ensure we have required tools
-if ! command -v jq &>/dev/null; then
-  log_warning "jq is not installed — skipping version sync"
-  exit 0
-fi
-
-if ! command -v rg &>/dev/null; then
-  log_warning "ripgrep (rg) is not installed — skipping version sync"
-  exit 0
-fi
-
 # Run main function
 main "$@"