Updated version

Updated to Git Lint 10.0.0
link:https://alchemists.io/projects/git-lint/versions/10.0.0/[Details]. This only effects the development environment which is why this is a minor bump. Milestone: minor
2026-01-01 14:36:32 -07:00 · 2026-01-01 11:45:49 -07:00 · 2026-01-01 07:26:30 -07:00 · 2025-12-25 08:40:18 -07:00 · 2025-12-16 20:43:29 -07:00 · 2025-10-07 19:13:01 -06:00
43 changed files with 631 additions and 1111 deletions
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -8,24 +8,24 @@ jobs:
      - checkout

      - restore_cache:
-          name: Bundler Restore
+          name: Gems Restore
          keys:
            - gem-cache-{{.Branch}}-{{checksum "Gemfile"}}
            - gem-cache-

      - run:
-          name: Bundler Install
+          name: Gems Install
          command: |
            gem update --system
            bundle config set path "vendor/bundle"
            bundle install

      - save_cache:
-          name: Bundler Store
+          name: Gems Store
          key: gem-cache-{{.Branch}}-{{checksum "Gemfile"}}
          paths:
            - vendor/bundle

      - run:
-          name: Build
+          name: Rake
          command: bundle exec rake
--- a/.config/rubocop/config.yml
+++ b/.config/rubocop/config.yml
@@ -0,0 +1,2 @@
+inherit_gem:
+  caliber: config/all.yml
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@@ -0,0 +1 @@
+github: [bkuhlmann]
--- a/.github/ISSUE_TEMPLATE.md
+++ b/.github/ISSUE_TEMPLATE.md
@@ -1,11 +0,0 @@
-## Overview
-<!-- Required. Describe, briefly, the behavior experienced and desired. -->
-
-## Screenshots/Screencasts
-<!-- Optional. Attach screenshot(s) and/or screencast(s) that demo the behavior. -->
-
-## Steps to Recreate
-<!-- Required. List exact steps (numbered list) to reproduce errant behavior. -->
-
-## Environment
-<!-- Required. What is your operating system, software version(s), etc. -->
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.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.
--- a/.github/ISSUE_TEMPLATE/issue.md
+++ b/.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. -->
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.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. -->
--- a/.ruby-version
+++ b/.ruby-version
@@ -1 +1 @@
-3.1.0
+4.0.0
--- a/CHANGES.adoc
+++ b/CHANGES.adoc
@@ -1,279 +0,0 @@
-= Changes
-
-== 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.
--- a/CITATION.cff
+++ b/CITATION.cff
@@ -1,10 +1,10 @@
 cff-version: 1.2.0
 message: Please use the following metadata when citing this project in your work.
 title: macOS
-abstract: Provides a shell based framework for automating the setup of a macOS machine.
-version: 15.0.0
-license: Hippocratic-3.0
-date-released: 2021-12-27
+abstract: Shell scripts for automated macOS machine setup.
+version: 22.0.0
+license: Hippocratic-2.1
+date-released: 2026-01-01
 authors:
  - family-names: Kuhlmann
    given-names: Brooke
@@ -17,5 +17,6 @@ keywords:
 - automation
 - setup
 - recovery
-repository-code: https://www.alchemists.io/projects/mac_os
-repository-artifact: https://www.alchemists.io/projects/mac_os
+repository-code: https://github.com/bkuhlmann/mac_os
+repository-artifact: https://alchemists.io/projects/mac_os
+url: https://alchemists.io/projects/mac_os
--- a/CODE_OF_CONDUCT.adoc
+++ b/CODE_OF_CONDUCT.adoc
@@ -1,113 +0,0 @@
-= Contributor Covenant Code of Conduct
-
-== Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our community a
-harassment-free experience for everyone, regardless of age, body size, visible or invisible
-disability, ethnicity, sex characteristics, gender identity and expression, level of experience,
-education, socio-economic status, nationality, personal appearance, race, religion, or sexual
-identity and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and
-healthy community.
-
-== Our Standards
-
-Examples of behavior that contributes to a positive environment for our community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the
-  experience
-* Focusing on what is best not just for us as individuals, but for the overall community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email address, without their
-  explicit permission
-* Other conduct which could reasonably be considered inappropriate in a professional setting
-
-== Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior
-and will take appropriate and fair corrective action in response to any behavior that they deem
-inappropriate, threatening, offensive, or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject comments, commits,
-code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and
-will communicate reasons for moderation decisions when appropriate.
-
-== Scope
-
-This Code of Conduct applies within all community spaces, and also applies when an individual is
-officially representing the community in public spaces. Examples of representing our community
-include using an official e-mail address, posting via an official social media account, or acting as
-an appointed representative at an online or offline event.
-
-== Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community
-leaders responsible for enforcement at link:mailto:brooke@alchemists.io?subject=Conduct[Brooke Kuhlmann].
-
-All complaints will be reviewed and investigated promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the reporter of any
-incident.
-
-== Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining the consequences for
-any action they deem in violation of this Code of Conduct:
-
-=== 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or
-unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing clarity around the
-nature of the violation and an explanation of why the behavior was inappropriate. A public apology
-may be requested.
-
-=== 2. Warning
-
-**Community Impact**: A violation through a single incident or series of actions.
-
-**Consequence**: A warning with consequences for continued behavior. No interaction with the people
-involved, including unsolicited interaction with those enforcing the Code of Conduct, for a
-specified period of time. This includes avoiding interactions in community spaces as well as
-external channels like social media. Violating these terms may lead to a temporary or permanent ban.
-
-=== 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including sustained inappropriate
-behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public communication with the
-community for a specified period of time. No public or private interaction with the people involved,
-including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this
-period. Violating these terms may lead to a permanent ban.
-
-=== 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community standards, including
-sustained inappropriate behavior,  harassment of an individual, or aggression toward or
-disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within the community.
-
-== Attribution
-
-This Code of Conduct is adapted from the
-link:https://www.contributor-covenant.org/version/2/0/code_of_conduct.html[Contributor Covenant,
-Version 2.0].
-
-Community Impact Guidelines were inspired by link:https://github.com/mozilla/diversity[Mozilla's
-code of conduct enforcement ladder].
-
-For answers to common questions about this code of conduct, see the
-link:https://www.contributor-covenant.org/faq[FAQ]. Translations are available
-link:https://www.contributor-covenant.org/translations[here].
--- a/CONTRIBUTING.adoc
+++ b/CONTRIBUTING.adoc
@@ -1,22 +0,0 @@
-= Contributing
-
-Thanks for taking an interest in this open source project. Your involvement and support is greatly
-appreciated. The following details what you must know to contribute.
-
-== Code
-
-. Read the project link:README.adoc[README] before starting.
-. Fork, clone, and create a feature branch this repository for local development.
-. Ensure there are no setup, usage, and/or test issues.
-. Add tests for new functionality and ensure they pass.
-. Submit a pull request, follow the instructions provided, and ensure the build passes.
-
-== Issues
-
-Submit an issue via the GitHub Issues tab (assuming one does not already exist) and follow the
-instructions provided.
-
-== Feedback
-
-* Expect a response within one to three business days.
-* Changes, alternatives, and/or improvements may be suggested upon review.
--- a/8
+++ b/8
@@ -1,6 +1,10 @@
 # frozen_string_literal: true

+ruby file: ".ruby-version"
+
 source "https://rubygems.org"

-gem "git-lint", "~> 2.0"
-gem "rake", "~> 13.0"
+gem "caliber", "~> 0.82"
+gem "debug", "~> 1.11"
+gem "git-lint", "~> 10.0"
+gem "rake", "~> 13.3"
--- a/LICENSE.adoc
+++ b/LICENSE.adoc
@@ -1,214 +1,134 @@
-= HIPPOCRATIC LICENSE
-
-*Version 3.0, October 2021*
-
-https://firstdonoharm.dev
-
-*TERMS AND CONDITIONS*
-
-TERMS AND CONDITIONS FOR USE, COPY, MODIFICATION, PREPARATION OF DERIVATIVE WORK, REPRODUCTION, AND DISTRIBUTION:
-
-== 1. DEFINITIONS
-
-_This section defines certain terms used throughout this license agreement._
-
-1.1. "License" means the terms and conditions, as stated herein, for use, copy, modification, preparation of derivative work, reproduction, and distribution of Software (as defined below).
-
-1.2. "Licensor" means the copyright and/or patent owner or entity authorized by the copyright and/or patent owner that is granting the License.
-
-1.3. "Licensee" means the individual or entity exercising permissions granted by this License, including the use, copy, modification, preparation of derivative work, reproduction, and distribution of Software (as defined below).
-
-1.4. "Software" means any copyrighted work, including but not limited to software code, authored by Licensor and made available under this License.
-
-1.5. "Supply Chain" means the sequence of processes involved in the production and/or distribution of a commodity, good, or service offered by the Licensee.
-
-1.6. "Supply Chain Impacted Party" or "Supply Chain Impacted Parties" means any person(s) directly impacted by any of Licensee’s Supply Chain, including the practices of all persons or entities within the Supply Chain prior to a good or service reaching the Licensee.
-
-1.7. "Duty of Care" is defined by its use in tort law, delict law, and/or similar bodies of law closely related to tort and/or delict law, including without limitation, a requirement to act with the watchfulness, attention, caution, and prudence that a reasonable person in the same or similar circumstances would use towards any Supply Chain Impacted Party.
-
-1.8. "Worker" is defined to include any and all permanent, temporary, and agency workers, as well as piece-rate, salaried, hourly paid, legal young (minors), part-time, night, and migrant workers.
-
-== 2. INTELLECTUAL PROPERTY GRANTS
-
-_This section identifies intellectual property rights granted to a Licensee_.
-
-2.1. _Grant of Copyright License_: Subject to the terms and conditions of this License, Licensor hereby grants to Licensee a worldwide, non-exclusive, no-charge, royalty-free copyright license to use, copy, modify, prepare derivative work, reproduce, or distribute the Software, Licensor authored modified software, or other work derived from the Software.
-
-2.2 _Grant of Patent License_: Subject to the terms and conditions of this License, Licensor hereby grants Licensee a worldwide, non-exclusive, no-charge, royalty-free patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer Software.
-
-== 3. ETHICAL STANDARDS
-
-_This section lists conditions the Licensee must comply with in order to have rights under this License._
-
-The rights granted to the Licensee by this License are expressly made subject to the Licensee’s ongoing compliance with the following conditions:
-
-3.1. The Licensee SHALL NOT, whether directly or indirectly, through agents or assigns:
-
-3.1.1. Infringe upon any person’s right to life or security of person, engage in extrajudicial killings, or commit murder, without lawful cause +
-(See Article 3, _United Nations Universal Declaration of Human Rights_; Article 6, _International Covenant on Civil and Political Rights_)
-
-3.1.2. Hold any person in slavery, servitude, or forced labor +
-(See Article 4, _United Nations Universal Declaration of Human Rights_; Article 8, _International Covenant on Civil and Political Rights_);
-
-3.1.3. Contribute to the institution of slavery, slave trading, forced labor, or unlawful child labor +
-(See Article 4, _United Nations Universal Declaration of Human Rights_; Article 8, _International Covenant on Civil and Political Rights_);
-
-3.1.4. Torture or subject any person to cruel, inhumane, or degrading treatment or punishment +
-(See Article 5, _United Nations Universal Declaration of Human Rights_; Article 7, _International Covenant on Civil and Political Rights_);
-
-3.1.5. Discriminate on the basis of sex, gender, sexual orientation, race, ethnicity, nationality, religion, caste, age, medical disability or impairment, and/or any other like circumstances +
-(See Article 7, _United Nations Universal Declaration of Human Rights_; Article 2, _International Covenant on Economic, Social and Cultural Rights_; Article 26, _International Covenant on Civil and Political Rights_);
-
-3.1.6. Prevent any person from exercising his/her/their right to seek an effective remedy by a competent court or national tribunal (including domestic judicial systems, international courts, arbitration bodies, and other adjudicating bodies) for actions violating the fundamental rights granted to him/her/them by applicable constitutions, applicable laws, or by this License +
-(See Article 8, _United Nations Universal Declaration of Human Rights_; Articles 9 and 14, _International Covenant on Civil and Political Rights_);
-
-3.1.7. Subject any person to arbitrary arrest, detention, or exile +
-(See Article 9, _United Nations Universal Declaration of Human Rights_; Article 9, _International Covenant on Civil and Political Rights_);
-
-3.1.8. Subject any person to arbitrary interference with a person’s privacy, family, home, or correspondence without the express written consent of the person +
-(See Article 12, _United Nations Universal Declaration of Human Rights_; Article 17, _International Covenant on Civil and Political Rights_);
-
-3.1.9. Arbitrarily deprive any person of his/her/their property +
-(See Article 17, _United Nations Universal Declaration of Human Rights_);
-
-3.1.10. Forcibly remove indigenous peoples from their lands or territories or take any action with the aim or effect of dispossessing indigenous peoples from their lands, territories, or resources, including without limitation the intellectual property or traditional knowledge of indigenous peoples, without the free, prior, and informed consent of indigenous peoples concerned +
-(See Articles 8 and 10, _United Nations Declaration on the Rights of Indigenous Peoples_);
-
-3.1.11. Be an individual or entity, or a representative, agent, affiliate, successor, attorney, or assign of an individual or entity, on the FFI Solutions Carbon Underground 200 list;
-
-3.1.12. Commit ecocide:
-
-3.1.12.1 For the purpose of this section, "ecocide" means unlawful or wanton acts committed with knowledge that there is a substantial likelihood of severe and either widespread or long-term damage to the environment being caused by those acts;
-
-3.1.12.2 For the purpose of further defining ecocide and the terms contained in the previous paragraph:
-
-3.1.12.2.1. "Wanton" means with reckless disregard for damage which would be clearly excessive in relation to the social and economic benefits anticipated;
-
-3.1.12.2.2. "Severe" means damage which involves very serious adverse changes, disruption, or harm to any element of the environment, including grave impacts on human life or natural, cultural, or economic resources;
-
-3.1.12.2.3. "Widespread" means damage which extends beyond a limited geographic area, crosses state boundaries, or is suffered by an entire ecosystem or species or a large number of human beings;
-
-3.1.12.2.4. "Long-term" means damage which is irreversible or which cannot be redressed through natural recovery within a reasonable period of time; and
-
-3.1.12.2.5. "Environment" means the earth, its biosphere, cryosphere, lithosphere, hydrosphere, and atmosphere, as well as outer space
-
-(See Section II, _Independent Expert Panel for the Legal Definition of Ecocide_, Stop Ecocide Foundation and the Promise Institute for Human Rights at UCLA School of Law, June 2021);
-
-3.1.13. Be an individual or entity, or a representative, agent, affiliate, successor, attorney, or assign of an individual or entity, that engages in fossil fuel or mineral exploration, extraction, development, or sale;
-
-3.1.14. Be an individual or entity, or a representative, agent, affiliate, successor, attorney, or assign of an individual or entity, identified by the Boycott, Divestment, Sanctions ("BDS") movement on its website (https://bdsmovement.net/ and https://bdsmovement.net/get-involved/what-to-boycott) as a target for boycott;
-
-3.1.15. Be an individual or entity that:
-
-3.1.15.1. engages in any commercial transactions with the Taliban; or
-
-3.1.15.2. is a representative, agent, affiliate, successor, attorney, or assign of the Taliban;
-
-3.1.16. Be an individual or entity that:
-
-3.1.16.1. engages in any commercial transactions with the Myanmar/Burmese military junta; or
-
-3.1.16.2. is a representative, agent, affiliate, successor, attorney, or assign of the Myanmar/Burmese government;
-
-3.1.17. Be an individual or entity, or a representative, agent, affiliate, successor, attorney, or assign of any individual or entity, that does business in, purchases goods from, or otherwise benefits from goods produced in the Xinjiang Uygur Autonomous Region of China;
-
-3.1.18. Be an individual or entity:
-
-3.1.18.1. which U.S. Customs and Border Protection (CBP) has currently issued a Withhold Release Order (WRO) or finding against based on reasonable suspicion of forced labor; or
-
-3.1.18.2. that is a representative, agent, affiliate, successor, attorney, or assign of an individual or entity that does business with an individual or entity which currently has a WRO or finding from CBP issued against it based on reasonable suspicion of forced labor;
-
-3.1.19. Be a government agency or multinational corporation, or a representative, agent, affiliate, successor, attorney, or assign of a government or multinational corporation, which participates in mass surveillance programs;
-
-3.1.20. Be an entity or a representative, agent, affiliate, successor, attorney, or assign of an entity which conducts military activities;
-
-3.1.21. Be an individual or entity, or a or a representative, agent, affiliate, successor, attorney, or assign of an individual or entity, that provides good or services to, or otherwise enters into any commercial contracts with, any local, state, or federal law enforcement agency;
-
-3.1.22. Be an individual or entity, or a or a representative, agent, affiliate, successor, attorney, or assign of an individual or entity, that broadcasts messages promoting killing, torture, or other forms of extreme violence;
-
-3.1.23. Interfere with Workers’ free exercise of the right to organize and associate +
-(See Article 20, United Nations Universal Declaration of Human Rights; C087 - Freedom of Association and Protection of the Right to Organise Convention, 1948 (No. 87), International Labour Organization; Article 8, International Covenant on Economic, Social and Cultural Rights); and
-
-3.1.24. Harm the environment in a manner inconsistent with local, state, national, or international law.
-
-3.2. The Licensee SHALL:
-
-3.2.1. Only use social auditing mechanisms that adhere to Worker-Driven Social Responsibility Network’s Statement of Principles (https://wsr-network.org/what-is-wsr/statement-of-principles/) over traditional social auditing mechanisms, to the extent the Licensee uses any social auditing mechanisms at all;
-
-3.2.2. Ensure that if the Licensee has a Board of Directors, 30% of Licensee’s board seats are held by Workers paid no more than 200% of the compensation of the lowest paid Worker of the Licensee;
-
-3.2.3. Provide clear, accessible supply chain data to the public in accordance with the following conditions:
-
-3.2.3.1. All data will be on Licensee’s website and/or, to the extent Licensee is a representative, agent, affiliate, successor, attorney, subsidiary, or assign, on Licensee’s principal’s or parent’s website or some other online platform accessible to the public via an internet search on a common internet search engine; and
-
-3.2.3.2. Data published will include, where applicable, manufacturers, top tier suppliers, subcontractors, cooperatives, component parts producers, and farms;
-
-3.2.4. Provide equal pay for equal work where the performance of such work requires equal skill, effort, and responsibility, and which are performed under similar working conditions, except where such payment is made pursuant to:
-
-3.2.4.1. A seniority system;
-
-3.2.4.2. A merit system;
-
-3.2.4.3. A system which measures earnings by quantity or quality of production; or
-
-3.2.4.4. A differential based on any other factor other than sex, gender, sexual orientation, race, ethnicity, nationality, religion, caste, age, medical disability or impairment, and/or any other like circumstances +
-(See 29 U.S.C.A. § 206(d)(1); Article 23, _United Nations Universal Declaration of Human Rights_; Article 7, _International Covenant on Economic, Social and Cultural Rights_; Article 26, _International Covenant on Civil and Political Rights_); and
-
-3.2.5. Allow for reasonable limitation of working hours and periodic holidays with pay +
-(See Article 24, _United Nations Universal Declaration of Human Rights_; Article 7, _International Covenant on Economic, Social and Cultural Rights_).
-
-== 4. SUPPLY CHAIN IMPACTED PARTIES
-
-_This section identifies additional individuals or entities that a Licensee could harm as a result of violating the Ethical Standards section, the condition that the Licensee must voluntarily accept a Duty of Care for those individuals or entities, and the right to a private right of action that those individuals or entities possess as a result of violations of the Ethical Standards section._
-
-4.1. In addition to the above Ethical Standards, Licensee voluntarily accepts a Duty of Care for Supply Chain Impacted Parties of this License, including individuals and communities impacted by violations of the Ethical Standards. The Duty of Care is breached when a provision within the Ethical Standards section is violated by a Licensee, one of its successors or assigns, or by an individual or entity that exists within the Supply Chain prior to a good or service reaching the Licensee.
-
-4.2. Breaches of the Duty of Care, as stated within this section, shall create a private right of action, allowing any Supply Chain Impacted Party harmed by the Licensee to take legal action against the Licensee in accordance with applicable negligence laws, whether they be in tort law, delict law, and/or similar bodies of law closely related to tort and/or delict law, regardless if Licensee is directly responsible for the harms suffered by a Supply Chain Impacted Party. Nothing in this section shall be interpreted to include acts committed by individuals outside of the scope of his/her/their employment.
-
-== 5. NOTICE
-
-_This section explains when a Licensee must notify others of the License._
-
-5.1. _Distribution of Notice_: Licensee must ensure that everyone who receives a copy of or uses any part of Software from Licensee, with or without changes, also receives the License and the copyright notice included with Software (and if included by the Licensor, patent, trademark, and attribution notice). Licensee must ensure that License is prominently displayed so that any individual or entity seeking to download, copy, use, or otherwise receive any part of Software from Licensee is notified of this License and its terms and conditions. Licensee must cause any modified versions of the Software to carry prominent notices stating that Licensee changed the Software.
-
-5.2. _Modified Software_: Licensee is free to create modifications of the Software and distribute only the modified portion created by Licensee, however, any derivative work stemming from the Software or its code must be distributed pursuant to this License, including this Notice provision.
-
-5.3. _Recipients as Licensees_: Any individual or entity that uses, copies, modifies, reproduces, distributes, or prepares derivative work based upon the Software, all or part of the Software’s code, or a derivative work developed by using the Software, including a portion of its code, is a Licensee as defined above and is subject to the terms and conditions of this License.
-
-== 6. REPRESENTATIONS AND WARRANTIES
-
-6.1. _Disclaimer of Warranty_: TO THE FULL EXTENT ALLOWED BY LAW, THIS SOFTWARE COMES "AS IS," WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED, AND LICENSOR SHALL NOT BE LIABLE TO ANY PERSON OR ENTITY FOR ANY DAMAGES OR OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THIS LICENSE, UNDER ANY LEGAL CLAIM.
-
-6.2. _Limitation of Liability_: LICENSEE SHALL HOLD LICENSOR HARMLESS AGAINST ANY AND ALL CLAIMS, DEBTS, DUES, LIABILITIES, LIENS, CAUSES OF ACTION, DEMANDS, OBLIGATIONS, DISPUTES, DAMAGES, LOSSES, EXPENSES, ATTORNEYS’ FEES, COSTS, LIABILITIES, AND ALL OTHER CLAIMS OF EVERY KIND AND NATURE WHATSOEVER, WHETHER KNOWN OR UNKNOWN, ANTICIPATED OR UNANTICIPATED, FORESEEN OR UNFORESEEN, ACCRUED OR UNACCRUED, DISCLOSED OR UNDISCLOSED, ARISING OUT OF OR RELATING TO LICENSEE’S USE OF THE SOFTWARE. NOTHING IN THIS SECTION SHOULD BE INTERPRETED TO REQUIRE LICENSEE TO INDEMNIFY LICENSOR, NOR REQUIRE LICENSOR TO INDEMNIFY LICENSEE.
-
-== 7. TERMINATION
-
-7.1. _Violations of Ethical Standards or Breaching Duty of Care_: If Licensee violates the Ethical Standards section or Licensee, or any other person or entity within the Supply Chain prior to a good or service reaching the Licensee, breaches its Duty of Care to Supply Chain Impacted Parties, Licensee must remedy the violation or harm caused by Licensee within 30 days of being notified of the violation or harm. If Licensee fails to remedy the violation or harm within 30 days, all rights in the Software granted to Licensee by License will be null and void as between Licensor and Licensee.
-
-7.2. _Failure of Notice_: If any person or entity notifies Licensee in writing that Licensee has not complied with the Notice section of this License, Licensee can keep this License by taking all practical steps to comply within 30 days after the notice of noncompliance. If Licensee does not do so, Licensee’s License (and all rights licensed hereunder) will end immediately.
-
-7.3. _Judicial Findings_: In the event Licensee is found by a civil, criminal, administrative, or other court of competent jurisdiction, or some other adjudicating body with legal authority, to have committed actions which are in violation of the Ethical Standards or Supply Chain Impacted Party sections of this License, all rights granted to Licensee by this License will terminate immediately.
-
-7.4. _Patent Litigation_: If Licensee institutes patent litigation against any entity (including a cross-claim or counterclaim in a suit) alleging that the Software, all or part of the Software’s code, or a derivative work developed using the Software, including a portion of its code, constitutes direct or contributory patent infringement, then any patent license, along with all other rights, granted to Licensee under this License will terminate as of the date such litigation is filed.
-
-7.5. _Additional Remedies_: Termination of the License by failing to remedy harms in no way prevents Licensor or Supply Chain Impacted Party from seeking appropriate remedies at law or in equity.
-
-== 8. MISCELLANEOUS
-
-8.1. _Conditions_: Sections 3, 4.1, 5.1, 5.2, 7.1, 7.2, 7.3, and 7.4 are conditions of the rights granted to Licensee in the License.
-
-8.2. _Equitable Relief_: Licensor and any Supply Chain Impacted Party shall be entitled to equitable relief, including injunctive relief or specific performance of the terms hereof, in addition to any other remedy to which they are entitled at law or in equity.
-
-8.3. _Copyleft_: Modified software, source code, or other derivative work must be licensed, in its entirety, under the exact same conditions as this License.
-
-8.4. _Severability_: If any term or provision of this License is determined to be invalid, illegal, or unenforceable by a court of competent jurisdiction, any such determination of invalidity, illegality, or unenforceability shall not affect any other term or provision of this License or invalidate or render unenforceable such term or provision in any other jurisdiction. If the determination of invalidity, illegality, or unenforceability by a court of competent jurisdiction pertains to the terms or provisions contained in the Ethical Standards section of this License, all rights in the Software granted to Licensee shall be deemed null and void as between Licensor and Licensee.
-
-8.5. _Section Titles_: Section titles are solely written for organizational purposes and should not be used to interpret the language within each section.
-
-8.6. _Citations_: Citations are solely written to provide context for the source of the provisions in the Ethical Standards.
-
-8.7. _Section Summaries_: Some sections have a brief _italicized description_ which is provided for the sole purpose of briefly describing the section and should not be used to interpret the terms of the License.
-
-8.8. _Entire License_: This is the entire License between the Licensor and Licensee with respect to the claims released herein and that the consideration stated herein is the only consideration or compensation to be paid or exchanged between them for this License. This License cannot be modified or amended except in a writing signed by Licensor and Licensee.
-
-8.9. _Successors and Assigns_: This License shall be binding upon and inure to the benefit of the Licensor’s and Licensee’s respective heirs, successors, and assigns.
+= Hippocratic License
+
+Version: 2.1.0.
+
+Purpose. The purpose of this License is for the Licensor named above to
+permit the Licensee (as defined below) broad permission, if consistent
+with Human Rights Laws and Human Rights Principles (as each is defined
+below), to use and work with the Software (as defined below) within the
+full scope of Licensor’s copyright and patent rights, if any, in the
+Software, while ensuring attribution and protecting the Licensor from
+liability.
+
+Permission and Conditions. The Licensor grants permission by this
+license ("License"), free of charge, to the extent of Licensor’s
+rights under applicable copyright and patent law, to any person or
+entity (the "Licensee") obtaining a copy of this software and
+associated documentation files (the "Software"), to do everything with
+the Software that would otherwise infringe (i) the Licensor’s copyright
+in the Software or (ii) any patent claims to the Software that the
+Licensor can license or becomes able to license, subject to all of the
+following terms and conditions:
+
+* Acceptance. This License is automatically offered to every person and
+entity subject to its terms and conditions. Licensee accepts this
+License and agrees to its terms and conditions by taking any action with
+the Software that, absent this License, would infringe any intellectual
+property right held by Licensor.
+* Notice. Licensee must ensure that everyone who gets a copy of any part
+of this Software from Licensee, with or without changes, also receives
+the License and the above copyright notice (and if included by the
+Licensor, patent, trademark and attribution notice). Licensee must cause
+any modified versions of the Software to carry prominent notices stating
+that Licensee changed the Software. For clarity, although Licensee is
+free to create modifications of the Software and distribute only the
+modified portion created by Licensee with additional or different terms,
+the portion of the Software not modified must be distributed pursuant to
+this License. If anyone notifies Licensee in writing that Licensee has
+not complied with this Notice section, Licensee can keep this License by
+taking all practical steps to comply within 30 days after the notice. If
+Licensee does not do so, Licensee’s License (and all rights licensed
+hereunder) shall end immediately.
+* Compliance with Human Rights Principles and Human Rights Laws.
+[arabic]
+. Human Rights Principles.
+[loweralpha]
+.. Licensee is advised to consult the articles of the United Nations
+Universal Declaration of Human Rights and the United Nations Global
+Compact that define recognized principles of international human rights
+(the "Human Rights Principles"). Licensee shall use the Software in a
+manner consistent with Human Rights Principles.
+.. Unless the Licensor and Licensee agree otherwise, any dispute,
+controversy, or claim arising out of or relating to (i) Section 1(a)
+regarding Human Rights Principles, including the breach of Section 1(a),
+termination of this License for breach of the Human Rights Principles,
+or invalidity of Section 1(a) or (ii) a determination of whether any Law
+is consistent or in conflict with Human Rights Principles pursuant to
+Section 2, below, shall be settled by arbitration in accordance with the
+Hague Rules on Business and Human Rights Arbitration (the "Rules");
+provided, however, that Licensee may elect not to participate in such
+arbitration, in which event this License (and all rights licensed
+hereunder) shall end immediately. The number of arbitrators shall be one
+unless the Rules require otherwise.
+
+Unless both the Licensor and Licensee agree to the contrary: (1) All
+documents and information concerning the arbitration shall be public and
+may be disclosed by any party; (2) The repository referred to under
+Article 43 of the Rules shall make available to the public in a timely
+manner all documents concerning the arbitration which are communicated
+to it, including all submissions of the parties, all evidence admitted
+into the record of the proceedings, all transcripts or other recordings
+of hearings and all orders, decisions and awards of the arbitral
+tribunal, subject only to the arbitral tribunal’s powers to take such
+measures as may be necessary to safeguard the integrity of the arbitral
+process pursuant to Articles 18, 33, 41 and 42 of the Rules; and (3)
+Article 26(6) of the Rules shall not apply.
+. Human Rights Laws. The Software shall not be used by any person or
+entity for any systems, activities, or other uses that violate any Human
+Rights Laws. "Human Rights Laws" means any applicable laws,
+regulations, or rules (collectively, "Laws") that protect human,
+civil, labor, privacy, political, environmental, security, economic, due
+process, or similar rights; provided, however, that such Laws are
+consistent and not in conflict with Human Rights Principles (a dispute
+over the consistency or a conflict between Laws and Human Rights
+Principles shall be determined by arbitration as stated above). Where
+the Human Rights Laws of more than one jurisdiction are applicable or in
+conflict with respect to the use of the Software, the Human Rights Laws
+that are most protective of the individuals or groups harmed shall
+apply.
+. Indemnity. Licensee shall hold harmless and indemnify Licensor (and
+any other contributor) against all losses, damages, liabilities,
+deficiencies, claims, actions, judgments, settlements, interest, awards,
+penalties, fines, costs, or expenses of whatever kind, including
+Licensor’s reasonable attorneys’ fees, arising out of or relating to
+Licensee’s use of the Software in violation of Human Rights Laws or
+Human Rights Principles.
+* Failure to Comply. Any failure of Licensee to act according to the
+terms and conditions of this License is both a breach of the License and
+an infringement of the intellectual property rights of the Licensor
+(subject to exceptions under Laws, e.g., fair use). In the event of a
+breach or infringement, the terms and conditions of this License may be
+enforced by Licensor under the Laws of any jurisdiction to which
+Licensee is subject. Licensee also agrees that the Licensor may enforce
+the terms and conditions of this License against Licensee through
+specific performance (or similar remedy under Laws) to the extent
+permitted by Laws. For clarity, except in the event of a breach of this
+License, infringement, or as otherwise stated in this License, Licensor
+may not terminate this License with Licensee.
+* Enforceability and Interpretation. If any term or provision of this
+License is determined to be invalid, illegal, or unenforceable by a
+court of competent jurisdiction, then such invalidity, illegality, or
+unenforceability shall not affect any other term or provision of this
+License or invalidate or render unenforceable such term or provision in
+any other jurisdiction; provided, however, subject to a court
+modification pursuant to the immediately following sentence, if any term
+or provision of this License pertaining to Human Rights Laws or Human
+Rights Principles is deemed invalid, illegal, or unenforceable against
+Licensee by a court of competent jurisdiction, all rights in the
+Software granted to Licensee shall be deemed null and void as between
+Licensor and Licensee. Upon a determination that any term or provision
+is invalid, illegal, or unenforceable, to the extent permitted by Laws,
+the court may modify this License to affect the original purpose that
+the Software be used in compliance with Human Rights Principles and
+Human Rights Laws as closely as possible. The language in this License
+shall be interpreted as to its fair meaning and not strictly for or
+against any party.
+* Disclaimer. TO THE FULL EXTENT ALLOWED BY LAW, THIS SOFTWARE COMES
+"AS IS," WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED, AND LICENSOR AND
+ANY OTHER CONTRIBUTOR SHALL NOT BE LIABLE TO ANYONE FOR ANY DAMAGES OR
+OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE
+OR THIS LICENSE, UNDER ANY KIND OF LEGAL CLAIM.
+
+This Hippocratic License is an link:https://ethicalsource.dev[Ethical Source license] and is offered
+for use by licensors and licensees at their own risk, on an "AS IS" basis, and with no warranties
+express or implied, to the maximum extent permitted by Laws.
--- a/README.adoc
+++ b/README.adoc
@@ -2,22 +2,21 @@
 :toclevels: 5
 :figure-caption!:

-= macOS
+:mac_os_defaults_link: link:https://macos-defaults.com[macOS Defaults]

-[link=https://circleci.com/gh/bkuhlmann/mac_os]
-image::https://circleci.com/gh/bkuhlmann/mac_os.svg?style=svg[Circle CI Status]
+= macOS

 Shell scripts for automated macOS machine setup.

 This project is a framework for automating the setup of a macOS machine. In order to illustrate the
 potential of what this project can do, please see the companion
-link:https://www.alchemists.io/projects/mac_os-config[macOS Config] project for details. The _macOS
+link:https://alchemists.io/projects/mac_os-config[macOS Config] project for details. The _macOS
 Config_ project is an opinionated configuration which meets the needs of my development environment
 but is also meant to serve as an example and guide for building your own personalized setup. Here is
 how the two projects are meant to be used:

 * *macOS* (this project) - The foundational framework for building custom macOS machine setups.
-* *link:https://www.alchemists.io/projects/mac_os-config[macOS Configuration]* - The layer on top of
+* *link:https://alchemists.io/projects/mac_os-config[macOS Configuration]* - The layer on top of
  this _macOS_ project which defines a custom machine implementation. The project is meant to be
  forked for as many custom machine setups as needed.

@@ -37,18 +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.

-== Screencast
-
-[link=https://www.alchemists.io/screencasts/mac_os]
-image::https://www.alchemists.io/images/screencasts/mac_os/cover.svg[Screencast,600,240,role=focal_point]
-
 == Requirements

-. link:https://www.apple.com/macos/monterey[macOS Monterey]
+. link:https://www.apple.com/os/macos[macOS 26.0.0 (Tahoe)]
 . link:https://developer.apple.com/xcode[Xcode]

 == Setup
@@ -59,7 +53,7 @@ To install, run:
 ----
 git clone https://github.com/bkuhlmann/mac_os.git
 cd mac_os
-git checkout 15.0.0
+git checkout 22.0.0
 ----

 == Usage
@@ -124,35 +118,47 @@ When attempting to create a boot disk via `bin/run B`, you’ll be presented wit
 documentation (provided here for reference):

 ....
-macOS Boot Disk Tips
-  - Use a USB drive (8GB or higher).
-  - Use Disk Utility to format the USB drive as "Mac OS Extended (Journaled)".
-  - Use Disk Utility to label the USB drive as "Untitled".
+macOS Boot Disk Setup
+  1. Insert a USB drive (8GB or higher).
+  2. Use Disk Utility to format as "Mac OS Extended (Journaled)".
+  3. Use Disk Utility to set the schema, if available, as "GUID Partition Map".
+  4. Use Disk Utility to label as "Untitled".
+  5. Run this script to install the OS and create a bootable USB drive.

 macOS Boot Disk Usage:
-  1. Insert the USB boot disk into the machine to be upgraded.
+  1. Insert the USB drive, created above, into the machine to be upgraded.
  2. Reboot the machine.
-  3. Hold the POWER (Silicon) or OPTION (Intel) key before the Apple logo appears.
+  3. Press and hold the POWER key before the Apple logo appears.
  4. Select the USB boot disk from the menu.
  5. Use Disk Utility to delete and/or erase the hard drive including associated partitions.
-  6. Use Disk Utility to create a single "APFS" drive as a "GUID Partition Table".
+  6. Use Disk Utility to create a single "APFS" drive.
  7. Install the new operating system.

 macOS Boot Disk Recovery:
  1. Start/restart the machine.
-  2. Hold the POWER (Silicon) or COMMAND+R (Intel) keys before the Apple logo appears.
+  2. Press and hold the POWER key before the Apple logo appears.
  3. Wait for the macOS installer to load from the recovery partition.
  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
-  defaults.
+* `bin/apply_default_settings` (optional, customizable): Applies {mac_os_defaults_link}.
 * `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.
@@ -175,13 +181,13 @@ All executable scripts can be found in the `bin` folder:
 * `bin/run` (required): The main script and interface for macOS setup.

 The `lib` folder provides the base framework for installing, re-installing, and uninstalling
-software. Everything provided via the link:https://www.alchemists.io/projects/mac_os-config[macOS
+software. Everything provided via the link:https://alchemists.io/projects/mac_os-config[macOS
 Config] project is built upon the functions found in the `lib` folder. See the
-link:https://www.alchemists.io/projects/mac_os-config[macOS Config] project for further details.
+link:https://alchemists.io/projects/mac_os-config[macOS Config] project for further details.

 * `lib/settings.sh`: Defines global settings for software applications, extensions, etc.

-== Troubleshooting
+=== Troubleshooting

 * *Pi-hole*: When using link:https://pi-hole.net[Pi-hole], you might need to temporarily disable
  prior to upgrading as you might experience various errors with Apple not being able to detect an
@@ -208,6 +214,7 @@ link:https://www.alchemists.io/projects/mac_os-config[macOS Config] project for
 ** 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

@@ -219,36 +226,20 @@ git clone https://github.com/bkuhlmann/mac_os.git
 cd mac_os
 ----

-== Versioning
+== link:https://alchemists.io/policies/license[License]

-Read link:https://semver.org[Semantic Versioning] for details. Briefly, it means:
+== link:https://alchemists.io/policies/security[Security]

-* Major (X.y.z) - Incremented for any backwards incompatible public API changes.
-* Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.
-* Patch (x.y.Z) - Incremented for small, backwards compatible, bug fixes.
+== link:https://alchemists.io/policies/code_of_conduct[Code of Conduct]

-== Code of Conduct
+== link:https://alchemists.io/policies/contributions[Contributions]

-Please note that this project is released with a link:CODE_OF_CONDUCT.adoc[CODE OF CONDUCT]. By
-participating in this project you agree to abide by its terms.
+== link:https://alchemists.io/policies/developer_certificate_of_origin[Developer Certificate of Origin]

-== Contributions
+== link:https://alchemists.io/projects/mac_os/versions[Versions]

-Read link:CONTRIBUTING.adoc[CONTRIBUTING] for details.
-
-== Community
-
-Feel free to link:https://www.alchemists.io/community[join the commmunity] for discussions related
-to this project and much more.
-
-== License
-
-Read link:LICENSE.adoc[LICENSE] for details.
-
-== Changes
-
-Read link:CHANGES.adoc[CHANGES] for details.
+== link:https://alchemists.io/community[Community]

 == Credits

-Engineered by link:https://www.alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].
+Engineered by link:https://alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].
--- a/11
+++ b/11
@@ -1,5 +1,12 @@
 # frozen_string_literal: true

-require "git/lint/rake/setup"
+require "git/lint/rake/register"
+require "rubocop/rake_task"

-task default: :git_lint
+Git::Lint::Rake::Register.call
+RuboCop::RakeTask.new
+
+desc "Run code quality checks"
+task quality: %i[git_lint rubocop]
+
+task default: :quality
--- a/bin/apply_basic_settings
+++ b/bin/apply_basic_settings
@@ -1,16 +0,0 @@
-#! /usr/bin/env bash
-
-# Applies basic system settings.
-
-set -o nounset
-set -o errexit
-set -o pipefail
-IFS=$'\n\t'
-
-SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/apply_basic_settings"
-
-if [[ -x "$SCRIPT_PATH" ]]; then
-  "$SCRIPT_PATH"
-else
-  printf "WARNING: Basic settings script does not exist or is not executable.\n"
-fi
--- a/bin/apply_default_settings
+++ b/bin/apply_default_settings
@@ -1,16 +0,0 @@
-#! /usr/bin/env bash
-
-# Applies default settings.
-
-set -o nounset
-set -o errexit
-set -o pipefail
-IFS=$'\n\t'
-
-SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/apply_default_settings"
-
-if [[ -x "$SCRIPT_PATH" ]]; then
-  "$SCRIPT_PATH"
-else
-  printf "WARNING: Default settings script does not exist or is not executable.\n"
-fi
--- a/bin/configure_software
+++ b/bin/configure_software
@@ -1,16 +0,0 @@
-#! /usr/bin/env bash
-
-# Configures installed software.
-
-set -o nounset
-set -o errexit
-set -o pipefail
-IFS=$'\n\t'
-
-SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/configure_software"
-
-if [[ -x "$SCRIPT_PATH" ]]; then
-  "$SCRIPT_PATH"
-else
-  printf "WARNING: Configure software script does not exist or is not executable.\n"
-fi
--- a/bin/create_boot_disk
+++ b/bin/create_boot_disk
@@ -2,33 +2,35 @@

 # Creates macOS boot disk.

-printf "macOS Boot Disk Tips\n"
-printf "  - Use a USB drive (8GB or higher).\n"
-printf "  - Use Disk Utility to format the USB drive as \"Mac OS Extended (Journaled)\".\n"
-printf "  - Use Disk Utility to label the USB drive as \"Untitled\".\n"
-printf "\nmacOS Boot Disk Usage:\n"
-printf "  1. Insert the USB boot disk into the machine to be upgraded.\n"
-printf "  2. Reboot the machine.\n"
-printf "  3. Hold the POWER (Silicon) or OPTION (Intel) key before the Apple logo appears.\n"
-printf "  4. Select the USB boot disk from the menu.\n"
-printf "  5. Use Disk Utility to delete and/or erase the hard drive including associated partitions.\n"
-printf "  6. Use Disk Utility to create a single \"APFS\" drive as a \"GUID Partition Table\".\n"
-printf "  7. Install the new operating system.\n"
-printf "\nmacOS Boot Disk Recovery:\n"
-printf "  1. Start/restart the machine.\n"
-printf "  2. Hold the POWER (Silicon) or COMMAND+R (Intel) keys before the Apple logo appears.\n"
-printf "  3. Wait for the macOS installer to load from the recovery partition.\n"
-printf "  4. Use the dialog options to launch Disk Utility, reinstall the system, etc.\n"
+printf "%s\n" "macOS Boot Disk Setup"
+printf "%s\n" "  1. Insert a USB drive (8GB or higher)."
+printf "%s\n" "  2. Use Disk Utility to format as \"Mac OS Extended (Journaled)\"."
+printf "%s\n" "  3. Use Disk Utility to set the schema, if available, as \"GUID Partition Map\"."
+printf "%s\n" "  4. Use Disk Utility to label as \"Untitled\"."
+printf "%s\n" "  5. Run this script to install the OS and create a bootable USB drive."
+printf "\n%s\n" "macOS Boot Disk Usage:"
+printf "%s\n" "  1. Insert the USB drive, created above, into the machine to be upgraded."
+printf "%s\n" "  2. Reboot the machine."
+printf "%s\n" "  3. Press and hold the POWER key before the Apple logo appears."
+printf "%s\n" "  4. Select the USB boot disk from the menu."
+printf "%s\n" "  5. Use Disk Utility to delete and/or erase the hard drive including associated partitions."
+printf "%s\n" "  6. Use Disk Utility to create a single \"APFS\" drive."
+printf "%s\n" "  7. Install the new operating system."
+printf "\n%s\n" "macOS Boot Disk Recovery:"
+printf "%s\n" "  1. Start/restart the machine."
+printf "%s\n" "  2. Press and hold the POWER key before the Apple logo appears."
+printf "%s\n" "  3. Wait for the macOS installer to load from the recovery partition."
+printf "%s\n" "  4. Use the dialog options to launch Disk Utility, reinstall the system, etc."

-printf "\nCreating macOS boot disk...\n"
+printf "\n%s\n" "Creating macOS boot disk..."

 if [[ ! -e "$MAC_OS_BOOT_DISK_CREATOR" ]]; then
-  printf "ERROR: macOS installer does not exist: $MAC_OS_BOOT_DISK_CREATOR. Use System Preferences → Software Update to download.\n"
+  printf "%s\n" "ERROR: macOS installer does not exist: $MAC_OS_BOOT_DISK_CREATOR. Use System Preferences → Software Update to download."
  exit 1
 fi

 if [[ ! -d "$MAC_OS_BOOT_DISK_PATH" ]]; then
-  printf "ERROR: Boot disk must be mounted at: $MAC_OS_BOOT_DISK_PATH.\n"
+  printf "%s\n" "ERROR: Boot disk must be mounted at: $MAC_OS_BOOT_DISK_PATH."
  exit 1
 fi

--- a/bin/install_app_store
+++ b/bin/install_app_store
@@ -13,5 +13,5 @@ if [[ -x "$SCRIPT_PATH" ]]; then
  check_mas_install
  "$SCRIPT_PATH"
 else
-  printf "WARNING: App Store install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: App Store install script does not exist or is not executable."
 fi
--- a/bin/install_applications
+++ b/bin/install_applications
@@ -12,5 +12,5 @@ SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_applications"
 if [[ -x "$SCRIPT_PATH" ]]; then
  "$SCRIPT_PATH"
 else
-  printf "WARNING: Applications install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Applications install script does not exist or is not executable."
 fi
--- a/bin/install_basics
+++ b/bin/install_basics
@@ -0,0 +1,16 @@
+#! /usr/bin/env bash
+
+# Installs basic system settings.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_basics"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  "$SCRIPT_PATH"
+else
+  printf "%s\n" "WARNING: Basic settings script does not exist or is not executable."
+fi
--- a/bin/install_defaults
+++ b/bin/install_defaults
@@ -0,0 +1,16 @@
+#! /usr/bin/env bash
+
+# Installs system and application default settings.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_defaults"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  "$SCRIPT_PATH"
+else
+  printf "%s\n" "WARNING: Default settings script does not exist or is not executable."
+fi
--- a/bin/install_dev_tools
+++ b/bin/install_dev_tools
@@ -1,14 +1,14 @@
 #! /usr/bin/env bash

-Installs development tooling requirements.
+# Installs development tooling requirements.

-printf "Installing Xcode CLI tools...\n"
+printf "%s\n" "Installing Xcode CLI tools..."
 xcode-select --install

 printf "%s\n" "💡 ALT+TAB to view and accept Xcode license window."
 read -p "Have you completed the Xcode CLI tools install (y/n)? " xcode_response
 if [[ "$xcode_response" != "y" ]]; then
-  printf "ERROR: Xcode CLI tools must be installed before proceeding.\n"
+  printf "%s\n" "ERROR: Xcode CLI tools must be installed before proceeding."
  exit 1
 fi

--- a/bin/install_dotfiles
+++ b/bin/install_dotfiles
@@ -1,16 +0,0 @@
-#! /usr/bin/env bash
-
-# Installs dotfiles.
-
-set -o nounset
-set -o errexit
-set -o pipefail
-IFS=$'\n\t'
-
-SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_dotfiles"
-
-if [[ -x "$SCRIPT_PATH" ]]; then
-  "$SCRIPT_PATH"
-else
-  printf "WARNING: Dotfiles install script does not exist or is not executable.\n"
-fi
--- a/bin/install_extensions
+++ b/bin/install_extensions
@@ -12,5 +12,5 @@ SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_extensions"
 if [[ -x "$SCRIPT_PATH" ]]; then
  "$SCRIPT_PATH"
 else
-  printf "WARNING: Application extensions install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Application extensions install script does not exist or is not executable."
 fi
--- a/bin/install_homebrew_casks
+++ b/bin/install_homebrew_casks
@@ -13,5 +13,5 @@ if [[ -x "$SCRIPT_PATH" ]]; then
  install_homebrew
  "$SCRIPT_PATH"
 else
-  printf "WARNING: Homebrew Casks install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Homebrew Casks install script does not exist or is not executable."
 fi
--- a/bin/install_homebrew_formulas
+++ b/bin/install_homebrew_formulas
@@ -13,5 +13,5 @@ if [[ -x "$SCRIPT_PATH" ]]; then
  install_homebrew
  "$SCRIPT_PATH"
 else
-  printf "WARNING: Homebrew Formulas install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Homebrew Formulas install script does not exist or is not executable."
 fi
--- a/bin/install_node_packages
+++ b/bin/install_node_packages
@@ -13,5 +13,5 @@ if [[ -x "$SCRIPT_PATH" ]]; then
  install_node
  "$SCRIPT_PATH"
 else
-  printf "WARNING: Node packages install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Node packages install script does not exist or is not executable."
 fi
--- a/bin/install_ruby_gems
+++ b/bin/install_ruby_gems
@@ -13,5 +13,5 @@ if [[ -x "$SCRIPT_PATH" ]]; then
  install_ruby
  "$SCRIPT_PATH"
 else
-  printf "WARNING: Ruby gems install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Ruby gems install script does not exist or is not executable."
 fi
--- a/bin/install_rust_crates
+++ b/bin/install_rust_crates
@@ -13,5 +13,5 @@ if [[ -x "$SCRIPT_PATH" ]]; then
  install_rust
  "$SCRIPT_PATH"
 else
-  printf "WARNING: Rust crates install script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Rust crates install script does not exist or is not executable."
 fi
--- a/bin/install_shell
+++ b/bin/install_shell
@@ -0,0 +1,16 @@
+#! /usr/bin/env bash
+
+# Installs shell.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_shell"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  "$SCRIPT_PATH"
+else
+  printf "%s\n" "WARNING: Shell script does not exist or is not executable."
+fi
--- a/bin/rake
+++ b/bin/rake
@@ -0,0 +1,6 @@
+#! /usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+
+load Gem.bin_path "rake", "rake"
--- a/bin/restore_backup
+++ b/bin/restore_backup
@@ -12,5 +12,5 @@ SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/restore_backup"
 if [[ -x "$SCRIPT_PATH" ]]; then
  "$SCRIPT_PATH"
 else
-  printf "WARNING: Restore backup script does not exist or is not executable.\n"
+  printf "%s\n" "WARNING: Restore backup script does not exist or is not executable."
 fi
--- a/bin/run
+++ b/bin/run
@@ -4,22 +4,20 @@

 source lib/installers.sh
 source lib/options.sh
-source lib/reinstallers.sh
 source lib/settings.sh
-source lib/uninstallers.sh
 source lib/utilities.sh
 source lib/verifiers.sh

 if [[ -e "$MAC_OS_CONFIG_PATH" ]]; then
  source "$MAC_OS_CONFIG_PATH/lib/settings.sh"
 else
-  printf "ERROR: Unable to load macOS configuration: $MAC_OS_CONFIG_PATH.\n\n"
-  printf "Please check the following before continuing:\n"
-  printf "  • Download the default macOS configuration here: https://github.com/bkuhlmann/mac_os-config.\n"
-  printf "  • Customize as necessary for your setup or fork the project and make your own configuration.\n"
-  printf "  • When finished, your folder structure should look like this:\n"
-  printf "    • <root path>/mac_os:\n"
-  printf "    • <root path>/mac_os-config:\n"
+  printf "%s\n\n" "ERROR: Unable to load macOS configuration: $MAC_OS_CONFIG_PATH."
+  printf "%s\n" "Please check the following before continuing:"
+  printf "%s\n" "  • Download the default macOS configuration here: https://github.com/bkuhlmann/mac_os-config."
+  printf "%s\n" "  • Customize as necessary for your setup or fork the project and make your own configuration."
+  printf "%s\n" "  • When finished, your folder structure should look like this:"
+  printf "%s\n" "    • <root path>/mac_os:"
+  printf "%s\n" "    • <root path>/mac_os-config:"
  exit 1
 fi

@@ -27,41 +25,37 @@ configure_environment

 while true; do
  if [[ $# == 0 ]]; then
-    printf "\nUsage: run OPTION\n"
-    printf "\nOSX Options:\n"
-    printf "  Boot:\n"
-    printf "     B:  Create boot disk.\n"
-    printf "  Install:\n"
-    printf "     b:  Apply basic settings.\n"
-    printf "     t:  Install development tools.\n"
-    printf "    hf:  Install Homebrew Formulas.\n"
-    printf "    hc:  Install Homebrew Casks.\n"
-    printf "     m:  Install Mac App Store software.\n"
-    printf "     a:  Install application software.\n"
-    printf "     x:  Install application software extensions.\n"
-    printf "    df:  Install dotfiles.\n"
-    printf "    np:  Install Node packages.\n"
-    printf "    rg:  Install Ruby gems.\n"
-    printf "    rc:  Install Rust crates.\n"
-    printf "     d:  Apply default settings.\n"
-    printf "    cs:  Configure installed software.\n"
-    printf "     i:  Install all (i.e. executes all of the above steps in order listed).\n"
-    printf "  Restore:\n"
-    printf "     R:  Restore settings from backup.\n"
-    printf "  Manage:\n"
-    printf "     c:  Check status of managed software.\n"
-    printf "     C:  Caffeinate machine.\n"
-    printf "    ua:  Uninstall application software.\n"
-    printf "    ux:  Uninstall application software extension.\n"
-    printf "    ra:  Reinstall application software.\n"
-    printf "    rx:  Reinstall application software extension.\n"
-    printf "     w:  Clean work (temp) directory.\n"
-    printf "     q:  Quit/Exit.\n\n"
+    printf "\n%s\n" "Usage: run OPTION"
+    printf "\n%s\n" "OSX Options:"
+    printf "%s\n" "  Boot:"
+    printf "%s\n" "     B:  Create boot disk."
+    printf "%s\n" "  Install:"
+    printf "%s\n" "     b:  Install basics."
+    printf "%s\n" "     t:  Install development tools."
+    printf "%s\n" "    hf:  Install Homebrew Formulas."
+    printf "%s\n" "    hc:  Install Homebrew Casks."
+    printf "%s\n" "     m:  Install Mac App Store software."
+    printf "%s\n" "     a:  Install application software."
+    printf "%s\n" "     x:  Install application software extensions."
+    printf "%s\n" "     d:  Install defaults."
+    printf "%s\n" "     s:  Install shell."
+    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" "    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."
+    printf "%s\n" "     C:  Caffeinate machine."
+    printf "%s\n" "     w:  Clean work (temp) directory."
+    printf "%s\n\n" "     q:  Quit/Exit."
    read -p "Enter selection: " response
    printf "\n"
-    process_option $response
+    process_option "$response"
  else
-    process_option $1
+    process_option "$1"
  fi

  break
--- a/lib/installers.sh
+++ b/lib/installers.sh
@@ -2,8 +2,9 @@

 # Defines software installer functions.

-# Downloads remote file to local disk.
-# Parameters: $1 (required) - URL, $2 (required) - File name, $3 (optional) - HTTP header.
+# Label: Download File
+# Description: Download remote file to local disk.
+# Parameters: $1 (required): URL, $2 (required): File name, $3 (optional): HTTP header.
 download_file() {
  local url="$1"
  local file_name="$2"
@@ -11,43 +12,60 @@ download_file() {

  printf "%s\n" "Downloading $1..."
  clean_work_path
-  mkdir $MAC_OS_WORK_PATH
-  curl --header "$http_header" --location --retry 3 --retry-delay 5 --fail --silent --show-error "$url" >> "$MAC_OS_WORK_PATH/$file_name"
+  mkdir "$MAC_OS_WORK_PATH"
+
+  curl --header "$http_header" \
+       --location \
+       --retry 3 \
+       --retry-delay 5 \
+       --fail \
+       --silent \
+       --show-error \
+       "$url" >> "$MAC_OS_WORK_PATH/$file_name"
 }
 export -f download_file

-# Installs an application.
-# Parameters: $1 (required) - Application source path, $2 (required) - Application name.
+# Label: Install Application
+# Description: Install an application.
+# Parameters: $1 (required): Install path, $2 (required): Name.
 install_app() {
-  local install_root=$(get_install_root "$2")
-  local file_extension=$(get_extension "$2")
+  local install_path="$1"
+  local name="$2"
+  local install_root=""
+  local file_extension=""

-  printf "Installing: $install_root/$2...\n"
+  install_root=$(get_install_root "$name")
+  file_extension=$(get_extension "$name")
+
+  printf "%s\n" "Installing: $install_root/$name..."

  case $file_extension in
    '')
-      cp -a "$1/$2" "$install_root";;
+      cp -a "$install_path/$name" "$install_root";;
    'app')
-      cp -a "$1/$2" "$install_root";;
+      cp -a "$install_path/$name" "$install_root";;
    'prefPane')
-      sudo cp -pR "$1/$2" "$install_root";;
+      sudo cp -pR "$install_path/$name" "$install_root";;
    'qlgenerator')
-      sudo cp -pR "$1/$2" "$install_root" && qlmanage -r;;
+      sudo cp -pR "$install_path/$name" "$install_root" && qlmanage -r;;
    *)
-      printf "ERROR: Unknown file extension: $file_extension.\n"
+      printf "%s\n" "ERROR: Unknown file extension: $file_extension."
  esac
 }
 export -f install_app

-# Installs an application via a DMG file.
-# Parameters: $1 (required) - URL, $2 (required) - Mount path, $3 (required) - Application name.
+# Label: Install DMG Application
+# Description: Install DMG application.
+# Parameters: $1 (required): URL, $2 (required): Mount path, $3 (required): Application name.
 install_dmg_app() {
  local url="$1"
  local mount_point="/Volumes/$2"
  local app_name="$3"
-  local install_path=$(get_install_path "$app_name")
+  local install_path=""
  local work_file="download.dmg"

+  install_path=$(get_install_path "$app_name")
+
  if [[ ! -e "$install_path" ]]; then
    download_file "$url" "$work_file"
    mount_image "$MAC_OS_WORK_PATH/$work_file"
@@ -58,66 +76,76 @@ install_dmg_app() {
 }
 export -f install_dmg_app

-# Installs a package via a DMG file.
-# Parameters: $1 (required) - URL, $2 (required) - Mount path, $3 (required) - Application name.
+# Label: Install DMG Package
+# Description: Install DMG application via a package file.
+# Parameters: $1 (required): URL, $2 (required): Mount path, $3 (required): Application name.
 install_dmg_pkg() {
  local url="$1"
  local mount_point="/Volumes/$2"
  local app_name="$3"
-  local install_path=$(get_install_path "$app_name")
+  local install_path=""
  local work_file="download.dmg"

+  install_path=$(get_install_path "$app_name")
+
  if [[ ! -e "$install_path" ]]; then
    download_file "$url" "$work_file"
    mount_image "$MAC_OS_WORK_PATH/$work_file"
    install_pkg "$mount_point" "$app_name"
    unmount_image "$mount_point"
-    printf "Installed: $app_name.\n"
+    printf "%s\n" "Installed: $app_name."
    verify_application "$app_name"
  fi
 }
 export -f install_dmg_pkg

-# Installs a single file.
-# Parameters: $1 (required) - URL, $2 (required) - Install path.
+# Label: Install File
+# Description: Install a single file.
+# Parameters: $1 (required): URL, $2 (required): Install path.
 install_file() {
  local file_url="$1"
-  local file_name=$(get_basename "$1")
+  local file_name=""
  local install_path="$2"

+  file_name=$(get_basename "$1")
+
  if [[ ! -e "$install_path" ]]; then
    download_file "$file_url" "$file_name"
    mkdir -p $(dirname "$install_path")
    mv "$MAC_OS_WORK_PATH/$file_name" "$install_path"
-    printf "Installed: $file_name.\n"
+    printf "%s\n" "Installed: $file_name."
    verify_path "$install_path"
  fi
 }
 export -f install_file

-# Installs application code from a Git repository.
-# Parameters: $1 (required) - Repository URL, $2 (required) - Install path, $3 (optional) - Git clone options.
+# Label: Install Git Application
+# Description: Install application from a Git repository.
+# Parameters: $1 (required): URL, $2 (required): Install path, $3 (optional): Git clone options.
 install_git_app() {
-  local repository_url="$1"
-  local app_name=$(get_basename "$2")
+  local url="$1"
  local install_path="$2"
+  local app_name=""
  local options="--quiet"

+  app_name="$(get_basename "$2")"
+
  if [[ -n "$3" ]]; then
    local options="$options $3"
  fi

  if [[ ! -e "$install_path" ]]; then
-    printf "Installing: $install_path/$app_name...\n"
-    git clone $options "$repository_url" "$install_path"
-    printf "Installed: $app_name.\n"
+    printf "%s\n" "Installing: $install_path..."
+    git clone $options "$url" "$install_path"
+    printf "%s\n" "Installed: $app_name."
    verify_path "$install_path"
  fi
 }
 export -f install_git_app

-# Installs settings from a Git repository.
-# Parameters: $1 (required) - Repository URL, $2 (required) - Repository version, $3 (required) - Project directory, $4 (required) - Script to run (including any arguments).
+# Label: Install Git Project
+# Description: Install Git project.
+# Parameters: $1 (required): URL, $2 (required): Version, $3 (required): Project directory, $4 (required): Script to run (including any arguments).
 install_git_project() {
  local repo_url="$1"
  local repo_version="$2"
@@ -134,84 +162,105 @@ install_git_project() {
 }
 export -f install_git_project

-# Installs Homebrew.
-# Parameters: None.
+# Label: Install Homebrew
+# Description: Install and setup Homebrew.
 install_homebrew() {
  if ! command -v brew > /dev/null; then
    /bin/bash -c "$(curl --location --fail --silent --show-error https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+    echo "eval \"($(get_homebrew_bin_root)/brew shellenv)\"" > "$HOME/.zprofile"
+    eval "$($(get_homebrew_bin_root)/brew shellenv)"
  fi
 }
 export -f install_homebrew

-# Installs a package via a zip file.
-# Parameters: $1 (required) - URL, $2 (required) - Application name.
+# Label: Install Bare Package
+# Description: Install a bare package.
+# Parameters: $1 (required): URL, $2 (required): Application name.
 install_bare_pkg() {
  local url="$1"
  local app_name="$2"
-  local install_path=$(get_install_path "$app_name")
+  local install_path=""
  local work_file="$app_name.pkg"

+  install_path=$(get_install_path "$app_name")
+
  if [[ ! -e "$install_path" ]]; then
    download_file "$url" "$work_file"
    install_pkg "$MAC_OS_WORK_PATH" "$app_name"
-    printf "Installed: $app_name.\n"
+    printf "%s\n" "Installed: $app_name."
    verify_application "$app_name"
  fi
 }
 export -f install_bare_pkg

-# Installs a package.
-# Parameters: $1 (required) - Package source path, $2 (required) - Application name.
+# Label: Install Package
+# Description: Install local package.
+# Parameters: $1 (required): Package source path, $2 (required): Application name.
 install_pkg() {
-  local install_root=$(get_install_root "$2")
+  local source_path="$1"
+  local name="$2"
+  local install_root=""
+  local package=""

-  printf "Installing: $install_root/$2...\n"
-  local package=$(sudo find "$1" -maxdepth 1 -type f -name "*.pkg" -o -name "*.mpkg")
+  install_root=$(get_install_root "$name")
+  package=$(sudo find "$source_path" -maxdepth 1 -type f -name "*.pkg" -o -name "*.mpkg")
+
+  printf "%s\n" "Installing: $install_root/$name..."
  sudo installer -pkg "$package" -target /
 }
 export -f install_pkg

-# Installs program (single file).
-# Parameters: $1 (required) - URL, $2 (required) - Program name.
+# Label: Install Program
+# Description: Installs program without any packaging.
+# Parameters: $1 (required): URL, $2 (required): Name.
 install_program() {
  local url="$1"
  local program_name="$2"
-  local install_path=$(get_install_path "$program_name")
+  local install_root=""
+  local install_path=""
+
+  install_root=$(get_install_root "$program_name")
+  install_path=$(get_install_path "$program_name")

  if [[ ! -e "$install_path" ]]; then
    download_file "$url" "$program_name"
+    mkdir -p "$install_root"
    mv "$MAC_OS_WORK_PATH/$program_name" "$install_path"
    chmod 755 "$install_path"
-    printf "Installed: $program_name.\n"
+    printf "%s\n" "Installed: $program_name."
    verify_application "$program_name"
  fi
 }
 export -f install_program

-# Installs Node.
-# Parameters: None.
+# Label: Install Node
+# Description: Install and setup Node for local development.
 install_node() {
-  if ! command -v fnm > /dev/null; then
-    $(get_homebrew_bin_root)/fnm install --lts
+  if [[ ! -x "$(command -v node)" ]]; then
+    "$(get_homebrew_bin_root)/fnm" install --latest
  fi
 }
 export -f install_node

-# Installs Ruby.
-# Parameters: None.
+# Label: Install Ruby
+# Description: Install and setup Ruby for local development.
 install_ruby() {
-  local version="$(cat $HOME/.ruby-version | tr -d '\n')"
+  local version=""
+
+  version="$(cat $HOME/.ruby-version | tr -d '\n')"

  if [[ ! -x "$(command -v ruby)" && -n $(ruby --version | grep --quiet "$version") ]]; then
-    $(get_homebrew_bin_root)/frum install "$version"
-    $(get_homebrew_bin_root)/frum local "$version"
-    gem update --system && gem update
+    "$(get_homebrew_bin_root)"/frum install "$version" \
+                                            --with-openssl-dir="$(brew --prefix openssl)" \
+                                            --enable-shared \
+                                            --disable-silent-rules
+    "$(get_homebrew_bin_root)"/frum local "$version"
  fi
 }
 export -f install_ruby

-# Installs Rust.
-# Parameters: None.
+# Label: Install Rust
+# Description: Install and setup Rust for local development.
 install_rust() {
  if ! command -v cargo > /dev/null; then
    curl --proto "=https" --tlsv1.2 --fail --silent --show-error https://sh.rustup.rs | sh
@@ -219,15 +268,18 @@ install_rust() {
 }
 export -f install_rust

-# Installs an application via a tar file.
-# Parameters: $1 (required) - URL, $2 (required) - Application name, $3 (required) - Decompress options.
+# Label: Install Tar Application
+# Description: Install application from tar file.
+# Parameters: $1 (required): URL, $2 (required): Name, $3 (required): Decompress options.
 install_tar_app() {
  local url="$1"
  local app_name="$2"
  local options="$3"
-  local install_path=$(get_install_path "$app_name")
+  local install_path=""
  local work_file="download.tar"

+  install_path=$(get_install_path "$app_name")
+
  if [[ ! -e "$install_path" ]]; then
    download_file "$url" "$work_file"

@@ -238,20 +290,23 @@ install_tar_app() {
    )

    install_app "$MAC_OS_WORK_PATH" "$app_name"
-    printf "Installed: $app_name.\n"
+    printf "%s\n" "Installed: $app_name."
    verify_application "$app_name"
  fi
 }
 export -f install_tar_app

-# Installs an application via a zip file.
-# Parameters: $1 (required) - URL, $2 (required) - Application name.
+# Label: Install Zip Application
+# Description: Install application from zip file.
+# Parameters: $1 (required): URL, $2 (required): Name.
 install_zip_app() {
  local url="$1"
  local app_name="$2"
-  local install_path=$(get_install_path "$app_name")
+  local install_path=""
  local work_file="download.zip"

+  install_path=$(get_install_path "$app_name")
+
  if [[ ! -e "$install_path" ]]; then
    download_file "$url" "$work_file"

@@ -263,20 +318,23 @@ install_zip_app() {
    )

    install_app "$MAC_OS_WORK_PATH" "$app_name"
-    printf "Installed: $app_name.\n"
+    printf "%s\n" "Installed: $app_name."
    verify_application "$app_name"
  fi
 }
 export -f install_zip_app

-# Installs a package via a zip file.
-# Parameters: $1 (required) - URL, $2 (required) - Application name.
+# Label: Install Zip Package
+# Description: Install application from a package within a zip file.
+# Parameters: $1 (required): URL, $2 (required): Application name.
 install_zip_pkg() {
  local url="$1"
  local app_name="$2"
-  local install_path=$(get_install_path "$app_name")
+  local install_path=""
  local work_file="download.zip"

+  install_path=$(get_install_path "$app_name")
+
  if [[ ! -e "$install_path" ]]; then
    download_file "$url" "$work_file"

@@ -287,24 +345,26 @@ install_zip_pkg() {
    )

    install_pkg "$MAC_OS_WORK_PATH" "$app_name"
-    printf "Installed: $app_name.\n"
+    printf "%s\n" "Installed: $app_name."
    verify_application "$app_name"
  fi
 }
 export -f install_zip_pkg

-# Mounts a disk image.
-# Parameters: $1 (required) - Image path.
+# Label: Mount Image
+# Description: Mount disk image.
+# Parameters: $1 (required): Path.
 mount_image() {
-  printf "Mounting image...\n"
+  printf "%s\n" "Mounting image..."
  hdiutil attach -quiet -nobrowse -noautoopen "$1"
 }
 export -f mount_image

-# Unmounts a disk image.
-# Parameters: $1 (required) - Mount path.
+# Label: Unmount Image
+# Description: Unmount disk image.
+# Parameters: $1 (required): Path.
 unmount_image() {
-  printf "Unmounting image...\n"
+  printf "%s\n" "Unmounting image..."
  hdiutil detach -force "$1"
 }
 export -f unmount_image
--- a/lib/options.sh
+++ b/lib/options.sh
@@ -2,14 +2,16 @@

 # Defines command line prompt options.

-# Process option selection.
-# Parameters: $1 (required) - The option to process.
+
+# Label: Process Option
+# Description: Run script based on selection.
+# Parameters: $1 (required): The option to process.
 process_option() {
  case $1 in
    'B')
      bin/create_boot_disk;;
    'b')
-      bin/apply_basic_settings;;
+      bin/install_basics;;
    't')
      bin/install_dev_tools;;
    'hf')
@@ -22,38 +24,36 @@ process_option() {
      bin/install_applications;;
    'x')
      bin/install_extensions;;
-    'df')
-      bin/install_dotfiles;;
-    'np')
-      bin/install_node_packages;;
-    'rg')
-      bin/install_ruby_gems;;
-    'rc')
-      bin/install_rust_crates;;
    'd')
-      bin/apply_default_settings;;
-    'cs')
-      bin/configure_software;;
+      bin/install_defaults;;
+    's')
+      bin/install_shell;;
+    'r')
+      bin/restore_backup;;
    'i')
      caffeinate_machine
-      bin/apply_basic_settings
+      bin/install_basics
      bin/install_dev_tools
      bin/install_homebrew_formulas
      bin/install_homebrew_casks
      bin/install_app_store
      bin/install_applications
      bin/install_extensions
-      bin/install_dotfiles
-      bin/install_node_packages
-      bin/install_ruby_gems
-      bin/install_rust_crates
-      bin/apply_default_settings
-      bin/configure_software
+      bin/install_defaults
+      bin/install_shell
+      bin/restore_backup
      clean_work_path;;
-    'R')
-      caffeinate_machine
-      bin/restore_backup;;
-    'c')
+    'np')
+      bin/install_node_packages;;
+    'rg')
+      bin/install_ruby_gems;;
+    'rc')
+      bin/install_rust_crates;;
+    'l')
+      bin/install_rust_crates
+      bin/install_ruby_gems
+      bin/install_node_packages;;
+   'c')
      verify_homebrew_formulas
      verify_homebrew_casks
      verify_app_store_applications
@@ -64,14 +64,6 @@ process_option() {
      verify_rust_crates;;
    'C')
      caffeinate_machine;;
-    'ua')
-      uninstall_application;;
-    'ux')
-      uninstall_extension;;
-    'ra')
-      reinstall_application;;
-    'rx')
-      reinstall_extension;;
    'w')
      clean_work_path;;
    'q');;
--- a/lib/reinstallers.sh
+++ b/lib/reinstallers.sh
@@ -1,17 +0,0 @@
-#! /usr/bin/env bash
-
-# Defines reinstall functions.
-
-# Reinstall application.
-reinstall_application() {
-  uninstall_application
-  bin/install_applications
-}
-export -f reinstall_application
-
-# Reinstall extension.
-reinstall_extension() {
-  uninstall_extension
-  bin/install_extensions
-}
-export -f reinstall_extension
--- a/lib/settings.sh
+++ b/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 Monterey.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"
--- a/lib/uninstallers.sh
+++ b/lib/uninstallers.sh
@@ -1,52 +0,0 @@
-#! /usr/bin/env bash
-
-# Defines uninstall functions.
-
-# Uninstalls selected application.
-uninstall_application() {
-  # Only use environment keys that end with "APP_NAME".
-  local keys=($(set | awk -F "=" '{print $1}' | grep ".*APP_NAME"))
-
-  printf "Select application to uninstall:\n"
-  for ((index = 0; index < ${#keys[*]}; index++)); do
-    local app_file="${!keys[$index]}"
-    printf "  $index: ${app_file}\n"
-  done
-  printf "  q: Quit/Exit\n\n"
-
-  read -p "Enter selection: " response
-  printf "\n"
-
-  local regex="^[0-9]+$"
-  if [[ $response =~ $regex ]]; then
-    local app_file="${!keys[$response]}"
-    local app_path=$(get_install_path "${app_file}")
-    sudo rm -rf "$app_path"
-    printf "Uninstalled: ${app_path}\n"
-  fi
-}
-export -f uninstall_application
-
-# Uninstalls selected extension.
-uninstall_extension() {
-  # Only use environment keys that end with "EXTENSION_PATH".
-  local keys=($(set | awk -F "=" '{print $1}' | grep ".*EXTENSION_PATH"))
-
-  printf "Select extension to uninstall:\n"
-  for ((index = 0; index < ${#keys[*]}; index++)); do
-    local extension_path="${!keys[$index]}"
-    printf "  $index: ${extension_path}\n"
-  done
-  printf "  q: Quit/Exit\n\n"
-
-  read -p "Enter selection: " response
-  printf "\n"
-
-  local regex="^[0-9]+$"
-  if [[ $response =~ $regex ]]; then
-    local extension_path="${!keys[$response]}"
-    rm -rf "${extension_path}"
-    printf "Uninstalled: ${extension_path}\n"
-  fi
-}
-export -f uninstall_extension
--- a/lib/utilities.sh
+++ b/lib/utilities.sh
@@ -2,11 +2,10 @@

 # Defines general utility functions.

-# Caffeinate machine.
+# Label: Caffeinate Machine
+# Description: Keep machine running for a very long time.
 caffeinate_machine() {
-  local pid=$(pgrep -x caffeinate)
-
-  if [[ -n "$pid" ]]; then
+  if [[ -n "$(pgrep -x caffeinate)" ]]; then
    printf "Machine is already caffeinated!\n"
  else
    caffeinate -s -u -d -i -t 3153600000 > /dev/null &
@@ -15,35 +14,40 @@ caffeinate_machine() {
 }
 export -f caffeinate_machine

-# Cleans work path for temporary processing of installs.
+# Label: Clean Work Path
+# Description: Clean work path of artifacts.
 clean_work_path() {
  rm -rf "$MAC_OS_WORK_PATH"
 }
 export -f clean_work_path

-# Answers the file or directory basename.
-# Parameters: $1 (required) - The file path.
+# Label: Get Basename
+# Description: Answer file or directory basename.
+# Parameters: $1 (required): Path.
 get_basename() {
-  printf "${1##*/}" # Answers file or directory name.
+  printf "%s" "${1##*/}"
 }
 export -f get_basename

-# Answers the file extension.
-# Parameters: $1 (required) - The file name.
+# Label: Get Extension
+# Description: Answer file extension without dot prefix.
+# Parameters: $1 (required): Path.
 get_extension() {
-  local name=$(get_basename "$1")
-  local extension="${1##*.}" # Excludes dot.
+  local name=""
+  local extension="${1##*.}"
+
+  name=$(get_basename "$1")

  if [[ "$name" == "$extension" ]]; then
    printf ''
  else
-    printf "$extension"
+    printf "%s" "$extension"
  fi
 }
 export -f get_extension

-# Answers Homebrew root path.
-# Parameters: None.
+# Label: Get Homebrew Root
+# Description: Answer Homebrew root path.
 get_homebrew_root() {
  if [[ "$(/usr/bin/arch)" == "arm64" ]]; then
    printf "%s" "/opt/homebrew"
@@ -53,8 +57,8 @@ get_homebrew_root() {
 }
 export -f get_homebrew_root

-# Answers Homebrew binary root path.
-# Parameters: None.
+# Label: Get Homebrew Bin Root
+# Description: Answer Homebrew binary root path.
 get_homebrew_bin_root() {
  if [[ "$(/usr/bin/arch)" == "arm64" ]]; then
    printf "%s" "/opt/homebrew/bin"
@@ -64,31 +68,28 @@ get_homebrew_bin_root() {
 }
 export -f get_homebrew_bin_root

-# Answers the full install path (including file name) for file name.
-# Parameters: $1 (required) - The file name.
+# Label: Get Install Path
+# Description: Answer full install path (including file name).
+# Parameters: $1 (required): Path.
 get_install_path() {
  local file_name="$1"
-  local install_path=$(get_install_root "$file_name")
-  printf "$install_path/$file_name"
+  local install_path=""
+
+  install_path=$(get_install_root "$file_name")
+
+  printf "%s" "$install_path/$file_name"
 }
 export -f get_install_path

-# Answers the root install path for file name.
-# Parameters: $1 (required) - The file name.
+# Label: Get Install Root
+# Description: Answer root install path.
+# Parameters: $1 (required): Path.
 get_install_root() {
  local file_name="$1"
-  local file_extension=$(get_extension "$file_name")

-  # Special cases not supported by Homebrew.
-  if [[ "$file_name" == "elm" ]]; then
-    printf "/usr/local/bin"
-    return
-  fi
-
-  # Dynamically build the install path based on file extension.
-  case $file_extension in
+  case $(get_extension "$file_name") in
    '')
-      printf "$(get_homebrew_bin_root)";;
+      printf "%s" "$HOME/.local/bin";;
    'app')
      printf "/Applications";;
    'prefPane')
@@ -101,19 +102,19 @@ get_install_root() {
 }
 export -f get_install_root

-# Checks Mac App Store (mas) CLI has been installed and exits if otherwise.
-# Parameters: None.
+# Label: Check Mac App Store Install
+# Description: Check Mac App Store (mas) CLI has been installed.
 check_mas_install() {
  if ! command -v mas > /dev/null; then
    printf "%s\n" "ERROR: Mac App Store (mas) CLI can't be found."
-    printf "%s\n" "       Please ensure Homebrew and mas (i.e. brew install mas) have been installed."
+    printf "%s\n" "       Please ensure mas (i.e. brew install mas) is installed."
    exit 1
  fi
 }
 export -f check_mas_install

-# Configures shell for new machines and ensures PATH is properly configured for running scripts.
-# Parameters: None.
+# Label: Configure Environment
+# Description: Configure shell and ensure PATH is properly configured.
 configure_environment() {
  if [[ ! -s "$HOME/.bash_profile" ]]; then
    printf "%s\n" "if [ -f ~/.bashrc ]; then . ~/.bashrc; fi" > "$HOME/.bash_profile"
--- a/lib/verifiers.sh
+++ b/lib/verifiers.sh
@@ -2,57 +2,65 @@

 # Defines verification/validation functions.

-# Checks for missing App Store applications.
+# Label: Verify App Store Applications
+# Description: Check for missing App Store applications.
 verify_app_store_applications() {
-  printf "\nChecking App Store applications...\n"
+  local applications=""

-  local applications="$(mas list)"
+  printf "\n%s\n" "Checking App Store applications..."
+  applications="$(mas list)"

  while read line; do
    if [[ "$line" == "mas install"* ]]; then
-      local application=$(printf "$line" | awk '{print $3}')
+      application=$(printf "$line" | awk '{print $3}')
      verify_listed_application "$application" "${applications[*]}"
    fi
  done < "$MAC_OS_CONFIG_PATH/bin/install_app_store"

-  printf "App Store check complete.\n"
+  printf "%s\n" "App Store check complete."
 }
 export -f verify_app_store_applications

-# Verifies application exists.
-# Parameters: $1 (required) - The file name.
+# Label: Verify Application
+# Description: Verify application exists.
+# Parameters: $1 (required): File name.
 verify_application() {
  local file_name="$1"
-  local install_path=$(get_install_path "$file_name")

-  if [[ ! -e "$install_path" ]]; then
-    printf " - Missing: $file_name\n"
+  if [[ ! -e "$(get_install_path "$file_name")" ]]; then
+    printf "%s\n" " - Missing: $file_name"
  fi
 }
 export -f verify_application

-# Checks for missing applications suffixed by "APP_NAME" as defined in settings.sh.
+# Label: Verify Applications
+# Description: Check for missing applications suffixed by "APP_NAME" as defined in settings.
 verify_applications() {
-  printf "\nChecking application software...\n"
+  local file_names=""
+
+  printf "\n%s\n" "Checking application software..."

  # Only use environment keys that end with "APP_NAME".
-  local file_names=$(set | awk -F "=" '{print $1}' | grep ".*APP_NAME")
+  file_names=$(set | awk -F "=" '{print $1}' | grep ".*APP_NAME")

  # For each application name, check to see if the application is installed. Otherwise, skip.
  for name in $file_names; do
    verify_application "${!name}"
  done

-  printf "Application software check complete.\n"
+  printf "%s\n" "Application software check complete."
 }
 export -f verify_applications

-# Checks for missing extensions suffixed by "EXTENSION_PATH" as defined in settings.sh.
+# Label: Verify Extensions
+# Description: Check for missing extensions suffixed by "EXTENSION_PATH" as defined in settings.
 verify_extensions() {
-  printf "\nChecking application extensions...\n"
+  local extensions=""
+
+  printf "\n%s\n" "Checking application extensions..."

  # Only use environment keys that end with "EXTENSION_PATH".
-  local extensions=$(set | awk -F "=" '{print $1}' | grep ".*EXTENSION_PATH")
+  extensions=$(set | awk -F "=" '{print $1}' | grep ".*EXTENSION_PATH")

  # For each extension, check to see if the extension is installed. Otherwise, skip.
  for extension in $extensions; do
@@ -60,36 +68,42 @@ verify_extensions() {
    verify_path "${!extension}"
  done

-  printf "Application extension check complete.\n"
+  printf "%s\n" "Application extension check complete."
 }
 export -f verify_extensions

-# Checks for missing Homebrew casks.
+# Label: Verify Homebrew Casks
+# Description: Check for missing Homebrew casks.
 verify_homebrew_casks() {
+  local applications=""
+
  printf "\nChecking Homebrew casks...\n"

-  local applications="$(brew list --casks)"
+  applications="$(brew list --casks)"

  while read line; do
    if [[ "$line" == "brew cask install"* ]]; then
-      local application=$(printf "$line" | awk '{print $4}')
+      application=$(printf "%s" "$line" | awk '{print $4}')
      verify_listed_application "$application" "${applications[*]}"
    fi
  done < "$MAC_OS_CONFIG_PATH/bin/install_homebrew_casks"

-  printf "Homebrew cask check complete.\n"
+  printf "%s\n" "Homebrew cask check complete."
 }
 export -f verify_homebrew_casks

-# Checks for missing Homebrew formulas.
+# Label: Verify Homebrew Formulas
+# Description: Check for missing Homebrew formulas.
 verify_homebrew_formulas() {
+  local applications=""
+
  printf "Checking Homebrew formulas...\n"

-  local applications="$(brew list --formulae)"
+  applications="$(brew list --formulae)"

  while read line; do
    if [[ "$line" == "brew install"* ]]; then
-      local application=$(printf "$line" | awk '{print $3}')
+      application=$(printf "%s" "$line" | awk '{print $3}')

      # Exception: "gpg" is the binary but is listed as "gnugp".
      if [[ "$application" == "gpg" ]]; then
@@ -100,80 +114,89 @@ verify_homebrew_formulas() {
    fi
  done < "$MAC_OS_CONFIG_PATH/bin/install_homebrew_formulas"

-  printf "Homebrew formula check complete.\n"
+  printf "%s\n" "Homebrew formula check complete."
 }
 export -f verify_homebrew_formulas

-# Verifies listed application exists.
-# Parameters: $1 (required) - The current application, $2 (required) - The application list.
+# Label: Verify Listed Application
+# Description: Verify listed application exists.
+# Parameters: $1 (required): Current application, $2 (required): Application list.
 verify_listed_application() {
  local application="$1"
  local applications="$2"

  if [[ "${applications[*]}" != *"$application"* ]]; then
-    printf " - Missing: $application\n"
+    printf "%s\n" " - Missing: $application"
  fi
 }
 export -f verify_listed_application

-# Verifies path exists.
-# Parameters: $1 (required) - The path.
+# Label: Verify Path
+# Description: Verify path exists.
+# Parameters: $1 (required): Path.
 verify_path() {
  local path="$1"

  if [[ ! -e "$path" ]]; then
-    printf " - Missing: $path\n"
+    printf "%s\n" " - Missing: $path"
  fi
 }
 export -f verify_path

-# Checks for missing Node packages.
+# Label: Verify Node Packages
+# Description: Check for missing Node packages.
 verify_node_packages() {
-  printf "\nChecking Node packages...\n"
+  printf "\n%s\n" "Checking Node packages..."

  while read line; do
    if [[ "$line" == "npm "* ]]; then
-      local package=$(printf "$line" | awk '{print $4}')
-      local packages=($(npm list --global --depth=0 | grep "$package"))
+      package=$(printf "$line" | awk '{print $4}')
+      packages=($(npm list --global --depth=0 | grep "$package"))

      verify_listed_application "$package" "${packages[*]}"
    fi
  done < "$MAC_OS_CONFIG_PATH/bin/install_node_packages"

-  printf "Node packages check complete.\n"
+  printf "%s\n" "Node packages check complete."
 }
 export -f verify_node_packages

-# Checks for missing Ruby gems.
+# Label: Verify Ruby Gems
+# Description: Check for missing Ruby gems.
 verify_ruby_gems() {
-  local gems="$(gem list --no-versions)"
+  local gems=""

-  printf "\nChecking Ruby gems...\n"
+  printf "\n%s\n" "Checking Ruby gems..."
+
+  gems="$(gem list --no-versions)"

  while read line; do
    if [[ "$line" == "gem install"* ]]; then
-      local gem=$(printf "$line" | awk '{print $3}')
+      gem=$(printf "%s" "$line" | awk '{print $3}')
      verify_listed_application "$gem" "${gems[*]}"
    fi
  done < "$MAC_OS_CONFIG_PATH/bin/install_ruby_gems"

-  printf "Ruby gems check complete.\n"
+  printf "%s\n" "Ruby gems check complete."
 }
 export -f verify_ruby_gems

-# Checks for missing Rust crates.
+# Label: Verify Rust Crates
+# Description: Check for missing Rust crates.
 verify_rust_crates() {
-  printf "\nChecking Rust crates...\n"
+  local crates=""

-  local crates="$(ls -A1 $HOME/.cargo/bin)"
+  printf "\n%s\n" "Checking Rust crates..."
+
+  crates="$(ls -A1 $HOME/.cargo/bin)"

  while read line; do
    if [[ "$line" == "cargo install"* ]]; then
-      local crate=$(printf "$line" | awk '{print $3}')
+      crate=$(printf "%s" "$line" | awk '{print $3}')
      verify_listed_application "$crate" "${crates[*]}"
    fi
  done < "$MAC_OS_CONFIG_PATH/bin/install_rust_crates"

-  printf "Rust crates check complete.\n"
+  printf "%s\n" "Rust crates check complete."
 }
 export -f verify_rust_crates
@@ -1 +1 @@
 .1.0
 .0.0