Updated version

Necessary to leverage the latest operating system version.

Milestone: major

.github/ISSUE_TEMPLATE.md

@@ -1,8 +0,0 @@
-## Why
-<!-- Required. Describe, briefly, why this issue is important. -->
-
-## How
-<!-- Optional. List exact steps (numbered) to implement or reproduce behavior. Screen shots/casts are welcome. -->
-
-## Notes
-<!-- Optional. Provide additional details (i.e operating system, software version(s), stack dump, etc.) -->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Community
+    url: https://alchemists.io/community
+    about: Please ask questions or discuss specifics here.
+  - name: Security
+    url: https://alchemists.io/policies/security
+    about: Please report security vulnerabilities here.

.github/ISSUE_TEMPLATE/issue.md

@@ -0,0 +1,18 @@
+---
+name: Issue
+title: "Add|Update|Fix|Remove|Refactor "
+about: Report an issue. Please use only one of the subject prefixes.
+---
+
+<!--
+Please focus on well written issues. Context: https://alchemists.io/articles/software_issues.
+-->
+
+## Why
+<!-- Required. Describe, briefly, why this issue is important. -->
+
+## How
+<!-- Optional. List exact steps to implement or reproduce behavior. Screen shots/casts are welcome! -->
+
+## Notes
+<!-- Optional. Provide additional details like operating system, software version(s), stack dump, logs, or anything else that would be helpful. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,8 +1,8 @@
 ## Overview
-<!-- Required. Why is this important/necessary and what is the overarching architecture. -->
+<!-- Required. Describe, briefly, why this is necessary and what the overarching architecture is. -->
 
 ## Screenshots/Screencasts
-<!-- Optional. Provide supporting image/video. -->
+<!-- Optional. Provide supporting screen shots/casts. -->
 
 ## Details
-<!-- Optional. List the key features/highlights as bullet points. -->
+<!-- Optional. As bullet points, list related issue(s); major highlights; team callouts; and/or other information that is helpful. -->

.ruby-version

@@ -1 +1 @@
-3.3.5
+3.4.6

CITATION.cff

@@ -2,9 +2,9 @@ cff-version: 1.2.0
 message: Please use the following metadata when citing this project in your work.
 title: macOS
 abstract: Shell scripts for automated macOS machine setup.
-version: 19.0.0
+version: 21.0.0
 license: Hippocratic-2.1
-date-released: 2024-09-19
+date-released: 2025-09-19
 authors:
   - family-names: Kuhlmann
     given-names: Brooke

Gemfile

@@ -4,7 +4,7 @@ ruby file: ".ruby-version"
 
 source "https://rubygems.org"
 
-gem "caliber", "~> 0.58"
+gem "caliber", "~> 0.82"
-gem "debug", "~> 1.9"
+gem "debug", "~> 1.11"
-gem "git-lint", "~> 8.0"
+gem "git-lint", "~> 9.0"
-gem "rake", "~> 13.2"
+gem "rake", "~> 13.3"

README.adoc

@@ -2,6 +2,8 @@
 :toclevels: 5
 :figure-caption!:
 
+:mac_os_defaults_link: link:https://macos-defaults.com[macOS Defaults]
+
 = macOS
 
 Shell scripts for automated macOS machine setup.
@@ -34,13 +36,13 @@ toc::[]
 * Installs link:https://nodejs.org[Node] link:https://www.npmjs.com[packages].
 * Installs link:https://www.ruby-lang.org[Ruby] link:https://rubygems.org[gems].
 * Installs link:https://www.rust-lang.org[Rust] link:https://crates.io[crates].
-* Applies basic default software settings.
+* Applies {mac_os_defaults_link}.
 * Configures installed software.
 * Supports restoration of machine backups.
 
 == Requirements
 
-. link:https://www.apple.com/macos/macos-sequoia[macOS 15.0.0 (Sequoia)]
+. link:https://www.apple.com/os/macos[macOS 26.0.0 (Tahoe)]
 . link:https://developer.apple.com/xcode[Xcode]
 
 == Setup
@@ -51,7 +53,7 @@ To install, run:
 ----
 git clone https://github.com/bkuhlmann/mac_os.git
 cd mac_os
-git checkout 19.0.0
+git checkout 21.0.0
 ----
 
 == Usage
@@ -139,14 +141,24 @@ macOS Boot Disk Recovery:
   4. Use the dialog options to launch Disk Utility, reinstall the system, etc.
 ....
 
+💡 You can ensure the right installer is downloaded and available for Boot Disk creation by running the following commands:
+
+[source,bash]
+----
+# Show which installers are available.
+softwareupdate --list-full-installers
+
+# Download desired version.
+sudo softwareupdate --fetch-full-installer --full-installer-version 26.0
+----
+
 === Customization
 
 All executable scripts can be found in the `bin` folder:
 
 * `bin/apply_basic_settings` (optional, customizable): Applies basic and initial settings for
   setting up a machine.
-* `bin/apply_default_settings` (optional, customizable): Applies bare minimum system and application
+* `bin/apply_default_settings` (optional, customizable): Applies {mac_os_defaults_link}.
-  defaults.
 * `bin/configure_software` (optional, customizable): Configures installed software as part of the
   post install process.
 * `bin/create_boot_disk` (optional): Creates a macOS boot disk.
@@ -202,6 +214,7 @@ link:https://alchemists.io/projects/mac_os-config[macOS Config] project for furt
 ** After seven seconds, hold down the Power button as well.
 ** Release all keys after another seven seconds.
 ** Turn on your Mac.
+** For more troubleshooting tips, check out The Eclectic Light Company's link:https://eclecticlight.co/mac-troubleshooting-summary/[Mac Troubleshooting Summary].
 
 == Development
 

VERSIONS.adoc

@@ -1,415 +0,0 @@
-= Versions
-
-== 19.0.0 (2024-09-19)
-
-* 🟢 Added version release notes - Brooke Kuhlmann
-* 🔼 Updated install root to use XDG binary path - Brooke Kuhlmann
-* 🔼 Updated to macOS 15.0.0 (Sequoia) - Brooke Kuhlmann
-
-== 18.3.2 (2024-09-03)
-
-* 🟢 Added README Developer Certificate of Origin documentation - Brooke Kuhlmann
-* 🔼 Updated to Ruby 3.3.5 - Brooke Kuhlmann
-
-== 18.3.1 (2024-08-17)
-
-* 🔼 Updated to Ruby 3.3.4 - Brooke Kuhlmann
-
-== 18.3.0 (2024-07-08)
-
-* 🔼 Updated to Caliber 0.58.0 - Brooke Kuhlmann
-* 🔼 Updated to Git Lint 8.0.0 - Brooke Kuhlmann
-* 🔼 Updated to Ruby 3.3.3 - Brooke Kuhlmann
-
-== 18.2.2 (2024-06-01)
-
-* 🔼 Updated citation URLs - Brooke Kuhlmann
-* 🔼 Updated to Ruby 3.3.2 - Brooke Kuhlmann
-
-== 18.2.1 (2024-05-02)
-
-* 🔼 Updated to Ruby 3.3.1 - Brooke Kuhlmann
-
-== 18.2.0 (2024-04-21)
-
-* 🔼 Updated RuboCop to use XDG local configuration - Brooke Kuhlmann
-* 🔼 Updated to Caliber 0.51.0 - Brooke Kuhlmann
-* 🔼 Updated to Git Lint 7.1.0 - Brooke Kuhlmann
-* 🔼 Updated to Git Lint 7.3.0 - Brooke Kuhlmann
-* 🔼 Updated to Rake 13.2.0 - Brooke Kuhlmann
-
-== 18.1.0 (2024-02-25)
-
-* 🔼 Updated to Caliber 0.50.0 - Brooke Kuhlmann
-* 🔁 Refactored bin script printing - Brooke Kuhlmann
-* 🔁 Refactored library functions - Brooke Kuhlmann
-
-== 18.0.0 (2024-01-06)
-
-* Added Rakefile quality task - Brooke Kuhlmann
-* Updated Circle CI step names - Brooke Kuhlmann
-* Updated GitHub issue template with simplified sections - Brooke Kuhlmann
-* Updated gem dependencies - Brooke Kuhlmann
-* Updated to Caliber 0.42.0 - Brooke Kuhlmann
-* Updated to Ruby 3.3.0 - Brooke Kuhlmann
-* Refactored Gemfile to use ruby file syntax - Brooke Kuhlmann
-
-== 17.0.0 (2023-09-28)
-
-* Added Debug gem - Brooke Kuhlmann
-* Updated to macOS Sonoma - Brooke Kuhlmann
-
-== 16.0.4 (2023-06-19)
-
-* Updated to Caliber 0.35.0 - Brooke Kuhlmann
-* Updated to Git Lint 6.0.0 - Brooke Kuhlmann
-* Updated to Refinements 11.0.0 - Brooke Kuhlmann
-
-== 16.0.3 (2023-05-18)
-
-* Updated to Caliber 0.30.0 - Brooke Kuhlmann
-
-== 16.0.2 (2023-04-02)
-
-* Fixed programs without extensions to install to user directory - Brooke Kuhlmann
-* Updated site URLs to use bare domain - Brooke Kuhlmann
-* Updated to Ruby 3.2.1 - Brooke Kuhlmann
-* Updated to Ruby 3.2.2 - Brooke Kuhlmann
-
-== 16.0.1 (2023-02-05)
-
-* Added Rake binstub - Brooke Kuhlmann
-* Updated to Caliber 0.21.0 - Brooke Kuhlmann
-* Updated to Caliber 0.25.0 - Brooke Kuhlmann
-* Updated to Git Lint 5.0.0 - Brooke Kuhlmann
-
-== 16.0.0 (2022-12-25)
-
-* Fixed Node installer to detect Node and version - Brooke Kuhlmann
-* Fixed Ruby installer to pass configuration options - Brooke Kuhlmann
-* Updated README sections - Brooke Kuhlmann
-* Updated installs for basic, default, and shell scripts - Brooke Kuhlmann
-* Updated run script to distinquish between applications and libraries - Brooke Kuhlmann
-* Updated to Caliber 0.11.0 - Brooke Kuhlmann
-* Updated to Caliber 0.16.0 - Brooke Kuhlmann
-* Updated to Ruby 3.1.3 - Brooke Kuhlmann
-* Updated to Ruby 3.2.0 - Brooke Kuhlmann
-* Updated to macOS Ventura - Brooke Kuhlmann
-* Removed configure software script - Brooke Kuhlmann
-* Removed mention of Intel CPUs from boot disk instructions - Brooke Kuhlmann
-* Removed system update from Ruby install - Brooke Kuhlmann
-* Removed uninstallers and reinstallers - Brooke Kuhlmann
-* Refactored download file function to use multi-line curl command - Brooke Kuhlmann
-
-== 15.0.5 (2022-05-07)
-
-* Updated to Caliber 0.6.0 - Brooke Kuhlmann
-* Updated to Caliber 0.7.0 - Brooke Kuhlmann
-* Updated to Caliber 0.8.0 - Brooke Kuhlmann
-
-== 15.0.4 (2022-04-17)
-
-* Added GitHub sponsorship configuration - Brooke Kuhlmann
-* Updated to Caliber 0.4.0 - Brooke Kuhlmann
-* Updated to Caliber 0.5.0 - Brooke Kuhlmann
-* Updated to Git Lint 4.0.0 - Brooke Kuhlmann
-* Updated to Ruby 3.1.2 - Brooke Kuhlmann
-
-== 15.0.3 (2022-03-16)
-
-* Fixed Homebrew install to initially default to ZSH - Brooke Kuhlmann
-
-== 15.0.2 (2022-03-03)
-
-* Fixed Hippocratic License to be 2.1.0 version - Brooke Kuhlmann
-* Added Caliber gem - Brooke Kuhlmann
-* Added Ruby version to Gemfile - Brooke Kuhlmann
-* Updated default Rake task to include Git Lint and Rubocop - Brooke Kuhlmann
-* Updated to Git Lint 3.2.0 - Brooke Kuhlmann
-* Updated to Ruby 3.1.1 - Brooke Kuhlmann
-* Removed README badges - Brooke Kuhlmann
-
-== 15.0.1 (2022-01-01)
-
-* Updated README policy section links - Brooke Kuhlmann
-* Updated changes as versions documentation - Brooke Kuhlmann
-* Updated to Git Lint 3.0.0 - Brooke Kuhlmann
-* Removed code of conduct and contributing files - Brooke Kuhlmann
-
-== 15.0.0 (2021-12-27)
-
-* Fixed Hippocratic license structure - Brooke Kuhlmann
-* Fixed README changes and credits sections - Brooke Kuhlmann
-* Fixed Rubocop Bundler/OrderedGems issue - Brooke Kuhlmann
-* Fixed contributing documentation - Brooke Kuhlmann
-* Added README community link - Brooke Kuhlmann
-* Added README troubleshooting guide for SMC reset - Brooke Kuhlmann
-* Added project citation information - Brooke Kuhlmann
-* Updated GitHub issue template - Brooke Kuhlmann
-* Updated to Hippocratic License 3.0.0 - Brooke Kuhlmann
-* Updated to Ruby 3.0.3 - Brooke Kuhlmann
-* Updated to Ruby 3.1.0 - Brooke Kuhlmann
-
-== 14.0.0 (2021-10-25)
-
-* Updated to macOS Monterey - Brooke Kuhlmann
-* Removed notes from pull request template - Brooke Kuhlmann
-
-== 13.0.0 (2021-08-01)
-
-* Added install Node function - Brooke Kuhlmann
-* Updated Node package install script to use NPM - Brooke Kuhlmann
-* Updated Ruby installer to use Frum - Brooke Kuhlmann
-* Updated shell option help text - Brooke Kuhlmann
-* Removed NPM install check function - Brooke Kuhlmann
-
-== 12.0.1 (2021-07-17)
-
-* Updated to Ruby 3.0.1 - Brooke Kuhlmann
-* Updated to Ruby 3.0.2 - Brooke Kuhlmann
-
-== 12.0.0 (2021-03-16)
-
-* Fixed environment configuration to source Bash resource - Brooke Kuhlmann
-* Added Homebrew installation to Homebrew sripts - Brooke Kuhlmann
-* Added Node packages script - Brooke Kuhlmann
-* Added Ruby gems script - Brooke Kuhlmann
-* Added Rust crates script - Brooke Kuhlmann
-* Added bare package installer - Brooke Kuhlmann
-* Added dotfiles script - Brooke Kuhlmann
-* Added mas check to App Store install script - Brooke Kuhlmann
-* Added version release notes - Brooke Kuhlmann
-* Updated dev tools installer to agree to Rosetta license - Brooke Kuhlmann
-* Updated install root detection to support Elm - Brooke Kuhlmann
-* Updated setup software as configure software script - Brooke Kuhlmann
-* Removed CPU detection in favor of architecture detection - Brooke Kuhlmann
-* Refactored install scripts to separate script paths - Brooke Kuhlmann
-
-== 11.2.0 (2021-02-27)
-
-* Added Apple Silicon instructions - Brooke Kuhlmann
-* Added CPU utility function - Brooke Kuhlmann
-* Added Homebrew install function - Brooke Kuhlmann
-* Added Homebrew utility path functions - Brooke Kuhlmann
-* Added Rosetta to development tools install script - Brooke Kuhlmann
-* Added environment configuration for scripts - Brooke Kuhlmann
-* Updated to Circle CI 2.1.0 - Brooke Kuhlmann
-* Updated to Docker Alpine Ruby image - Brooke Kuhlmann
-* Refactored installer functions to be alphabetically sorted - Brooke Kuhlmann
-* Refactored utility functions to be alphabetically sorted - Brooke Kuhlmann
-* Refactored verifier functions to be alphabetically sorted - Brooke Kuhlmann
-
-== 11.1.1 (2021-01-10)
-
-* Fixed brew formulae list error - Brooke Kuhlmann
-* Updated boot disk recovery documentation - Brooke Kuhlmann
-
-== 11.1.0 (2021-01-03)
-
-* Added caffeination to restore process - Brooke Kuhlmann
-* Updated boot disk instructions for main disk format - Brooke Kuhlmann
-* Updated troubleshooting documentation - Brooke Kuhlmann
-* Removed README Startup Security Utility documentation - Brooke Kuhlmann
-
-== 11.0.0 (2020-12-30)
-
-* Fixed Circle CI configuration for Bundler config path - Brooke Kuhlmann
-* Added Circle CI explicit Bundle install configuration - Brooke Kuhlmann
-* Updated to Git Lint 2.0.0 - Brooke Kuhlmann
-* Updated to Ruby 3.0.0 - Brooke Kuhlmann
-
-== 10.0.0 (2020-11-15)
-
-* Added macOS Big Sur support
-* Updated project documentation to conform to Rubysmith template
-* Updated to Git Lint 1.3.0
-* Updated to Ruby 2.7.2
-
-== 9.0.0 (2020-09-12)
-
-* Fixed Homebrew cask verifier deprecation warning
-* Removed Homebrew Mecurial formula verification check
-* Removed unnecessary verifier code comments
-* Refactored utility basename and extension utilities
-
-== 8.2.0 (2020-07-22)
-
-* Fixed project requirements
-* Fixed screencast image URL
-* Updated GitHub templates
-* Updated README credit URL
-* Updated README screencast URL
-* Updated README screencast cover to SVG format
-* Updated to Git Lint 1.0.0
-* Refactored Rakefile requirements
-
-== 8.1.0 (2020-04-01)
-
-* Added README production and development setup instructions
-* Updated Circle CI build label
-* Updated README screencast to use larger image
-* Updated documentation to ASCII Doc format
-* Updated to Code of Conduct 2.0.0
-* Updated to Git Cop 4.0.0
-* Updated to Ruby 2.7.1
-* Removed README images
-
-== 8.0.1 (2020-01-01)
-
-* Added Startup Security Utility to README.
-* Updated README screencast.
-* Updated to Ruby 2.7.0.
-* Refactored caffeinate machine function to process grep.
-
-== 8.0.0 (2019-10-12)
-
-* Updated to Rake 13.0.0.
-* Updated to Ruby 2.6.5.
-* Updated to macOS Catalina.
-
-== 7.2.1 (2019-09-01)
-
-* Updated README screencast tutorial.
-* Updated to Ruby 2.6.4.
-
-== 7.2.0 (2019-08-01)
-
-* Added file install function.
-
-== 7.1.2 (2019-06-01)
-
-* Updated contributing documentation.
-* Updated to Git Cop 3.5.0.
-
-== 7.1.1 (2019-05-01)
-
-* Added project icon to README.
-* Updated to Ruby 2.6.3.
-
-== 7.1.0 (2019-04-01)
-
-* Added XCode installer fix to troubleshooting section.
-* Updated to Ruby 2.6.1.
-* Updated to Ruby 2.6.2.
-
-== 7.0.0 (2019-01-01)
-
-* Fixed Circle CI cache for Ruby version.
-* Fixed installation of apps with no extension.
-* Fixed program installs.
-* Added Circle CI Bundler cache.
-* Added README boot disk documentation.
-* Added README troubleshooting section.
-* Updated to Git Cop 3.0.0.
-* Updated to Ruby 2.6.0.
-* Removed Java development tools from setup.
-* Removed download file function.
-
-== 6.1.0 (2018-11-01)
-
-* Updated to Java SE Development Kit 11.
-* Updated to Ruby 2.5.2.
-* Updated to Ruby 2.5.3.
-* Removed unnecessary source code comments.
-
-== 6.0.0 (2018-10-01)
-
-* Added XCode install tip.
-* Updated boot disk creation to macOS Mojave.
-* Updated to Contributor Covenant Code of Conduct 1.4.1.
-* Updated to Java SE Development Kit 10.
-
-== 5.0.0 (2018-08-01)
-
-* Fixed Markdown ordered list numbering.
-* Fixed verification of Homebrew formulas.
-* Added App Store application verification.
-* Added Homebrew cask application verifier.
-* Updated Git checkout to silence detached head warnings.
-* Updated README documentation.
-* Updated Semantic Versioning links to be HTTPS.
-* Updated boot disk format documentation.
-* Updated project changes to use semantic versions.
-* Removed Java install support.
-* Removed restorer functions.
-* Refactored function parameter documentation.
-* Refactored library function order.
-
-== 4.1.0 (2018-04-01)
-
-* Updated README license information.
-* Updated README screencast tutorial.
-* Updated to Circle CI 2.0.0 configuration.
-* Updated to Git Cop 2.2.0.
-* Updated to Ruby 2.5.1.
-* Removed Patreon badge from README.
-
-== 4.0.0 (2018-01-01)
-
-* Added Gemfile.lock to .gitignore.
-* Updated to Apache 2.0 license.
-* Updated to Ruby 2.4.3.
-* Updated to Ruby 2.5.0.
-
-== 3.1.0 (2017-11-26)
-
-* Updated Gemfile.lock file.
-* Updated boot disk documenation to mention APFS.
-* Updated to Bundler 1.16.0.
-* Updated to Git Cop 1.7.0.
-* Updated to Rake 12.3.0.
-* Updated to Rubocop 0.51.0.
-
-== 3.0.0 (2017-10-01)
-
-* Fixed table of contents.
-* Updated boot disk creation to use macOS High Sierra.
-* Updated gem dependencies.
-* Updated to Git Cop 1.6.0.
-* Updated to Ruby 2.4.2.
-
-== 2.2.0 (2017-07-16)
-
-* Added Git Cop support.
-* Updated CONTRIBUTING documentation.
-* Updated GitHub templates.
-* Updated README headers.
-* Updated gem dependencies.
-
-== 2.1.0 (2017-04-29)
-
-* Fixed Java SE Development Kit install.
-* Fixed install-all command
-
-== 2.0.0 (2017-04-09)
-
-* Added Homebrew Casks install script.
-* Updated README semantic versioning order.
-* Updated contributing documentation.
-* Refactored Homebrew software as Homebrew Formulas.
-
-== 1.3.1 (2017-01-08)
-
-* Fixed install of zip app downloads with sub-directories.
-
-== 1.3.0 (2017-01-01)
-
-* Updated README versioning documentation.
-* Removed CHANGELOG.md (use CHANGES.md instead).
-
-== 1.2.0 (2016-10-12)
-
-* Fixed reinstaller path issues with application and extension scripts.
-* Added screencast to README.
-
-== 1.1.0 (2016-10-11)
-
-* Fixed Bash script header to dynamically load correct environment.
-* Fixed verification of Homebrew application installs.
-* Added script hook for App Store software install.
-* Added script hooks for unfinished custom configurations.
-* Updated and clarified README documentation.
-
-== 1.0.0 (2016-10-05)
-
-* Initial version.

bin/run

@@ -42,9 +42,9 @@ while true; do
     printf "%s\n" "     r:  Restore backups."
     printf "%s\n" "     i:  Install all (i.e. executes all of the above steps in order listed)."
     printf "%s\n" "  Libraries:"
-    printf "%s\n" "    np:  Install Node packages."
-    printf "%s\n" "    rg:  Install Ruby gems."
     printf "%s\n" "    rc:  Install Rust crates."
+    printf "%s\n" "    rg:  Install Ruby gems."
+    printf "%s\n" "    np:  Install Node packages."
     printf "%s\n" "     l:  Install libraries (i.e. executes all of the above steps in order listed)."
     printf "%s\n" "  Manage:"
     printf "%s\n" "     c:  Check status of managed software."

lib/options.sh

@@ -50,9 +50,9 @@ process_option() {
     'rc')
       bin/install_rust_crates;;
     'l')
-      bin/install_node_packages
+      bin/install_rust_crates
       bin/install_ruby_gems
-      bin/install_rust_crates;;
+      bin/install_node_packages;;
    'c')
       verify_homebrew_formulas
       verify_homebrew_casks

lib/settings.sh

@@ -5,7 +5,7 @@ set -o errexit
 set -o pipefail
 IFS=$'\n\t'
 
-export MAC_OS_BOOT_DISK_CREATOR="/Applications/Install macOS Sequoia.app/Contents/Resources/createinstallmedia"
+export MAC_OS_BOOT_DISK_CREATOR="/Applications/Install macOS Tahoe.app/Contents/Resources/createinstallmedia"
 export MAC_OS_BOOT_DISK_PATH="/Volumes/Untitled"
 export MAC_OS_WORK_PATH=/tmp/downloads
 export MAC_OS_CONFIG_PATH="../mac_os-config"