Added version release notes

Necessary to point to the Alchemists site for all policy related
information in order to reduce the maintenance burden on this project.

.github/ISSUE_TEMPLATE.md

@@ -1,5 +1,5 @@
 ## Overview
-<!-- Required. Describe, briefly, the behavior experienced. -->
+<!-- Required. Describe, briefly, the behavior experienced and desired. -->
 
 ## Screenshots/Screencasts
 <!-- Optional. Attach screenshot(s) and/or screencast(s) that demo the behavior. -->
@@ -7,8 +7,5 @@
 ## Steps to Recreate
 <!-- Required. List exact steps (numbered list) to reproduce errant behavior. -->
 
-## Desired Behavior
-<!-- Required. Describe the behavior you'd like to see or your idea of a proposed solution. -->
-
 ## Environment
 <!-- Required. What is your operating system, software version(s), etc. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -6,6 +6,3 @@
 
 ## Details
 <!-- Optional. List the key features/highlights as bullet points. -->
-
-## Notes
-<!-- Optional. List additional notes/references as bullet points. -->

.ruby-version

@@ -1 +1 @@
-3.0.0
+3.1.0

CITATION.cff

@@ -0,0 +1,21 @@
+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.1
+license: Hippocratic-3.0
+date-released: 2022-01-01
+authors:
+  - family-names: Kuhlmann
+    given-names: Brooke
+    affiliation: Alchemists
+    orcid: https://orcid.org/0000-0002-5810-6268
+keywords:
+ - bash
+ - shell
+ - scripts
+ - automation
+ - setup
+ - recovery
+repository-code: https://www.alchemists.io/projects/mac_os
+repository-artifact: https://www.alchemists.io/projects/mac_os

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].

CONTRIBUTING.adoc

@@ -1,22 +0,0 @@
-= Contributing
-
-Thanks for taking an interest in this open source project. Your support and involvement is greatly
-appreciated. The following details what you need to know in order to contribute.
-
-== Code
-
-. Read the project link:README.adoc[README] before starting.
-. Fork and clone the `master` branch of this repository locally.
-. 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.

Gemfile

@@ -2,5 +2,5 @@
 
 source "https://rubygems.org"
 
+gem "git-lint", "~> 3.0"
 gem "rake", "~> 13.0"
-gem "git-lint", "~> 2.0"

LICENSE.adoc

@@ -1,162 +1,214 @@
-= Apache License
+= HIPPOCRATIC LICENSE
 
-Version 2.0, January 2004
+*Version 3.0, October 2021*
 
-http://www.apache.org/licenses
+https://firstdonoharm.dev
 
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+*TERMS AND CONDITIONS*
 
-== 1. Definitions
+TERMS AND CONDITIONS FOR USE, COPY, MODIFICATION, PREPARATION OF DERIVATIVE WORK, REPRODUCTION, AND DISTRIBUTION:
 
-"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by
+== 1. DEFINITIONS
-Sections 1 through 9 of this document.
 
-"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is
+_This section defines certain terms used throughout this license agreement._
-granting the License.
 
-"Legal Entity" shall mean the union of the acting entity and all other entities that control, are
+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).
-controlled by, or are under common control with that entity. For the purposes of this definition,
-"control" means (i) the power, direct or indirect, to cause the direction or management of such
-entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
-outstanding shares, or (iii) beneficial ownership of such entity.
 
-"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this
+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.
-License.
 
-"Source" form shall mean the preferred form for making modifications, including but not limited to
+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).
-software source code, documentation source, and configuration files.
 
-"Object" form shall mean any form resulting from mechanical transformation or translation of a
+1.4. "Software" means any copyrighted work, including but not limited to software code, authored by Licensor and made available under this License.
-Source form, including but not limited to compiled object code, generated documentation, and
-conversions to other media types.
 
-"Work" shall mean the work of authorship, whether in Source or Object form, made available under the
+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.
-License, as indicated by a copyright notice that is included in or attached to the work (an example
-is provided in the Appendix below).
 
-"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or
+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.
-derived from) the Work and for which the editorial revisions, annotations, elaborations, or other
-modifications represent, as a whole, an original work of authorship. For the purposes of this
-License, Derivative Works shall not include works that remain separable from, or merely link (or
-bind by name) to the interfaces of, the Work and Derivative Works thereof.
 
-"Contribution" shall mean any work of authorship, including the original version of the Work and any
+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.
-modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted
-to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity
-authorized to submit on behalf of the copyright owner. For the purposes of this definition,
-"submitted" means any form of electronic, verbal, or written communication sent to the Licensor or
-its representatives, including but not limited to communication on electronic mailing lists, source
-code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor
-for the purpose of discussing and improving the Work, but excluding communication that is
-conspicuously marked or otherwise designated in writing by the copyright owner as "Not a
-Contribution."
 
-"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a
+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.
-Contribution has been received by Licensor and subsequently incorporated within the Work.
 
-== 2. Grant of Copyright License
+== 2. INTELLECTUAL PROPERTY GRANTS
 
-Subject to the terms and conditions of this License, each Contributor hereby grants to You a
+_This section identifies intellectual property rights granted to a Licensee_.
-perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to
-reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and
-distribute the Work and such Derivative Works in Source or Object form.
 
-== 3. Grant of Patent License
+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.
 
-Subject to the terms and conditions of this License, each Contributor hereby grants to You a
+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.
-perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this
-section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer
-the Work, where such license applies only to those patent claims licensable by such Contributor that
-are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s)
-with the Work to which such Contribution(s) was submitted. If You institute patent litigation
-against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or
-a Contribution incorporated within the Work constitutes direct or contributory patent infringement,
-then any patent licenses granted to You under this License for that Work shall terminate as of the
-date such litigation is filed.
 
-== 4. Redistribution
+== 3. ETHICAL STANDARDS
 
-You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with
+_This section lists conditions the Licensee must comply with in order to have rights under this License._
-or without modifications, and in Source or Object form, provided that You meet the following
-conditions:
 
-. You must give any other recipients of the Work or Derivative Works a copy of this License; and
+The rights granted to the Licensee by this License are expressly made subject to the Licensee’s ongoing compliance with the following conditions:
 
-. You must cause any modified files to carry prominent notices stating that You changed the files;
+3.1. The Licensee SHALL NOT, whether directly or indirectly, through agents or assigns:
-  and
 
-. You must retain, in the Source form of any Derivative Works that You distribute, all copyright,
+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 +
-  patent, trademark, and attribution notices from the Source form of the Work, excluding those
+(See Article 3, _United Nations Universal Declaration of Human Rights_; Article 6, _International Covenant on Civil and Political Rights_)
-  notices that do not pertain to any part of the Derivative Works; and
 
-. If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works
+3.1.2. Hold any person in slavery, servitude, or forced labor +
-  that You distribute must include a readable copy of the attribution notices contained within such
+(See Article 4, _United Nations Universal Declaration of Human Rights_; Article 8, _International Covenant on Civil and Political Rights_);
-  NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in
-  at least one of the following places: within a NOTICE text file distributed as part of the
-  Derivative Works; within the Source form or documentation, if provided along with the Derivative
-  Works; or, within a display generated by the Derivative Works, if and wherever such third-party
-  notices normally appear. The contents of the NOTICE file are for informational purposes only and
-  do not modify the License. You may add Your own attribution notices within Derivative Works that
-  You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such
-  additional attribution notices cannot be construed as modifying the License.
 
-You may add Your own copyright statement to Your modifications and may provide additional or
+3.1.3. Contribute to the institution of slavery, slave trading, forced labor, or unlawful child labor +
-different license terms and conditions for use, reproduction, or distribution of Your modifications,
+(See Article 4, _United Nations Universal Declaration of Human Rights_; Article 8, _International Covenant on Civil and Political Rights_);
-or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of
-the Work otherwise complies with the conditions stated in this License.
 
-== 5. Submission of Contributions
+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_);
 
-Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the
+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 +
-Work by You to the Licensor shall be under the terms and conditions of this License, without any
+(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_);
-additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify
-the terms of any separate license agreement you may have executed with Licensor regarding such
-Contributions.
 
-== 6. Trademarks
+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_);
 
-This License does not grant permission to use the trade names, trademarks, service marks, or product
+3.1.7. Subject any person to arbitrary arrest, detention, or exile +
-names of the Licensor, except as required for reasonable and customary use in describing the origin
+(See Article 9, _United Nations Universal Declaration of Human Rights_; Article 9, _International Covenant on Civil and Political Rights_);
-of the Work and reproducing the content of the NOTICE file.
 
-== 7. Disclaimer of Warranty
+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_);
 
-Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each
+3.1.9. Arbitrarily deprive any person of his/her/their property +
-Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+(See Article 17, _United Nations Universal Declaration of Human Rights_);
-KIND, either express or implied, including, without limitation, any warranties or conditions of
-TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely
-responsible for determining the appropriateness of using or redistributing the Work and assume any
-risks associated with Your exercise of permissions under this License.
 
-== 8. Limitation of Liability
+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_);
 
-In no event and under no legal theory, whether in tort (including negligence), contract, or
+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;
-otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or
-agreed to in writing, shall any Contributor be liable to You for damages, including any direct,
-indirect, special, incidental, or consequential damages of any character arising as a result of this
-License or out of the use or inability to use the Work (including but not limited to damages for
-loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial
-damages or losses), even if such Contributor has been advised of the possibility of such damages.
 
-== 9. Accepting Warranty or Additional Liability
+3.1.12. Commit ecocide:
 
-While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee
+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;
-for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights
-consistent with this License. However, in accepting such obligations, You may act only on Your own
-behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You
-agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or
-claims asserted against, such Contributor by reason of your accepting any such warranty or
-additional liability.
 
-END OF TERMS AND CONDITIONS
+3.1.12.2 For the purpose of further defining ecocide and the terms contained in the previous paragraph:
 
-Copyright 2016 link:https://www.alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].
+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;
 
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in
+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;
-compliance with the License. You may obtain a link:https://www.apache.org/licenses/LICENSE-2.0[copy]
-of the License.
 
-Unless required by applicable law or agreed to in writing, software distributed under the License is
+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;
-distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+
-implied. See the License for the specific language governing permissions and limitations under the
+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
-License.
+
+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.

README.adoc

@@ -28,15 +28,17 @@ toc::[]
 * Provides a command line interface, written in Bash, with no additional dependencies for
   installation and management of a macOS machine.
 * Supports macOS boot disk creation for fresh install of operating system.
-* Downloads and installs link:https://developer.apple.com/xcode[Xcode Command Line Tools].
+* Installs link:https://developer.apple.com/xcode[Xcode Command Line Tools].
-* Downloads, installs, and configures link:http://brew.sh[Homebrew Formulas].
+* Installs link:http://brew.sh[Homebrew] formulas and casks.
-* Downloads, installs, and configures link:https://caskroom.github.io[Homebrew Casks].
+* Installs link:http://www.apple.com/macosx/whats-new/app-store.html[App Store] software.
-* Downloads, installs, and configures link:http://www.apple.com/macosx/whats-new/app-store.html[App
+* Installs non-App Store software applications.
-  Store] software.
+* Installs software application extensions.
-* Downloads, installs, and configures non-App Store software applications.
+* Installs dotfiles.
-* Downloads, installs, and configures software application extensions.
+* Installs link:https://nodejs.org[Node] link:https://www.npmjs.com[packages].
-* Applies basic and default software settings.
+* Installs link:https://www.ruby-lang.org[Ruby] link:https://rubygems.org[gems].
-* Sets up and configures installed software for use.
+* Installs link:https://www.rust-lang.org[Rust] link:https://crates.io[crates].
+* Applies basic default software settings.
+* Configures installed software.
 * Supports restoration of machine backups.
 
 == Screencast
@@ -46,7 +48,7 @@ image::https://www.alchemists.io/images/screencasts/mac_os/cover.svg[Screencast,
 
 == Requirements
 
-. link:https://www.apple.com/macos/big-sur[macOS Big Sur]
+. link:https://www.apple.com/macos/monterey[macOS Monterey]
 . link:https://developer.apple.com/xcode[Xcode]
 
 == Setup
@@ -57,7 +59,7 @@ To install, run:
 ----
 git clone https://github.com/bkuhlmann/mac_os.git
 cd mac_os
-git checkout 11.2.0
+git checkout 15.0.1
 ----
 
 == Usage
@@ -83,9 +85,13 @@ Install:
    m:  Install Mac App Store software.
    a:  Install application software.
    x:  Install application software extensions.
+  df:  Install dotfiles.
+  np:  Install Node packages.
+  rg:  Install Ruby gems.
+  rc:  Install Rust crates.
    d:  Apply default settings.
-   s:  Setup installed software.
+  cs:  Configure installed software.
-   i:  Install everything (i.e. executes all install options).
+   i:  Install everything (i.e. executes all install options in order listed).
 Restore:
    R:  Restore settings from backup.
 Manage:
@@ -143,21 +149,30 @@ macOS Boot Disk Recovery:
 
 All executable scripts can be found in the `bin` folder:
 
-* `bin/apply_basic_settings`: Applies basic, initial, settings for setting up a machine. _Can be
+* `bin/apply_basic_settings` (optional, customizable): Applies basic and initial settings for
-  customized._
+  setting up a machine.
-* `bin/apply_default_settings`: Applies useful system and application defaults. _Can be customized._
+* `bin/apply_default_settings` (optional, customizable): Applies bare minimum system and application
-* `bin/create_boot_disk`: Creates macOS boot disk.
+  defaults.
-* `bin/install_app_store`: Installs macOS, GUI-based, App Store applications. _Can be customized._
+* `bin/configure_software` (optional, customizable): Configures installed software as part of the
-* `bin/install_applications`: Installs macOS, GUI-based, non-App Store applications. _Can be
+  post install process.
-  customized._
+* `bin/create_boot_disk` (optional): Creates a macOS boot disk.
-* `bin/install_dev_tools`: Installs macOS development tools required by Homebrew.
+* `bin/install_app_store` (optional, customizable): Installs macOS, GUI-based, App Store
-* `bin/install_extensions`: Installs macOS application extensions and add-ons. _Can be customized._
+  applications.
-* `bin/install_homebrew_casks`: Installs Homebrew Formulas. _Can be customized._
+* `bin/install_applications` (optional, customizable): Installs macOS, GUI-based, non-App Store
-* `bin/install_homebrew_formulas`: Installs Homebrew Casks. _Can be customized._
+  applications.
-* `bin/restore_backup`: Restores system/application settings from backup image. _Can be customized._
+* `bin/install_dev_tools` (required): Installs macOS development tools required by Homebrew.
-* `bin/run`: The main script and interface for macOS setup.
+* `bin/install_dotfiles` (optional, customizable): Installs personal dotfiles so the system is
-* `bin/setup_software`: Configures and launches (if necessary) installed software. _Can be
+  tailored to your workflow.
-  customized._
+* `bin/install_extensions` (optional, customizable): Installs macOS application extensions and
+  add-ons.
+* `bin/install_homebrew_casks` (optional, customizable): Installs Homebrew Formulas.
+* `bin/install_homebrew_formulas` (optional, customizable): Installs Homebrew Casks.
+* `bin/install_node_packages` (optional, customizable): Installs Node packages.
+* `bin/install_ruby_gems` (optional, customizable): Installs Ruby gems.
+* `bin/install_rust_crates` (optional, customizable): Installs Rust crates.
+* `bin/restore_backup` (optional, customizable): Restores system/application settings from backup
+  image.
+* `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
@@ -168,20 +183,31 @@ link:https://www.alchemists.io/projects/mac_os-config[macOS Config] project for
 
 == Troubleshooting
 
-* When using link:https://pi-hole.net[Pi-hole], you might need to temporarily disable prior to
+* *Pi-hole*: When using link:https://pi-hole.net[Pi-hole], you might need to temporarily disable
-  upgrading as you might experience various errors with Apple not being able to detect an internet
+  prior to upgrading as you might experience various errors with Apple not being able to detect an
-  connection which prevents the installer from working.
+  internet connection which prevents the installer from working.
-* When using the boot disk and the installer fails in some catestrophic manner, reboot the machine
+* *Recovery Mode*: When using the boot disk and the installer fails in some catastrophic manner,
-  into recovery mode -- `POWER` (Silicon) or `COMMAND + R` (Intel) buttons -- to download and
+  reboot the machine into recovery mode -- pass:[<kbd>POWER</kbd>] (Silicon) or
-  install the last operating system used. Alternatively, you can also use `COMMAND + OPTION + R`
+  pass:[<kbd>COMMAND</kbd>] + pass:[<kbd>r</kbd>] (Intel) buttons -- to download and install the
-  (Intel) to attemp to download the latest operating system.
+  last operating system used. Alternatively, you can also use pass:[<kbd>COMMAND</kbd>] +
-* When using the boot disk, you might experience a situation where you see a black screen with a
+  pass:[<kbd>OPTION</kbd>] + pass:[<kbd>r</kbd>] (Intel) to attempt to download the latest operating
-  white circle and diagonal line running through it. This means macOS lost or can’t find the boot
+  system.
-  disk for some reason. To correct this, shut down and boot up the system again while holding down
+* *NVRAM/PRAM Reset*: When using the boot disk, you might experience a situation where you see a
-  the `OPTION + COMMAND + R + P` (Intel) keys simultaneously. You might want to wait for the system
+  black screen with a white circle and diagonal line running through it. This means macOS lost or
-  boot sound to happen a few times before releasing the keys. This will clear the system NVRAM/PRAM.
+  can't find the boot disk for some reason. To correct this, shut down and boot up the system again
-  At this point you can shut down and restart the system following the boot disk instructions (the
+  while holding down pass:[<kbd>OPTION</kbd>] + pass:[<kbd>COMMAND</kbd>] + pass:[<kbd>r</kbd>] +
-  boot disk will be recognized now).
+  pass:[<kbd>p</kbd>] (Intel) keys simultaneously. You might want to wait for the system boot sound
+  to happen a few times before releasing the keys. This will clear the system NVRAM/PRAM. At this
+  point you can shut down and restart the system following the boot disk instructions (the boot disk
+  will be recognized now).
+* *System Management Controller (SMC) Reset*: Sometimes it can help to reset the SMC to improve
+  system speed. To fix, follow these steps:
+** Shut down your Mac.
+** Hold down pass:[<kbd>CONTROL</kbd>] + pass:[<kbd>OPTION</kbd>] on the left side of the keyboard
+   and pass:[<kbd>SHIFT</kbd>] on the right side of the keyboard.
+** After seven seconds, hold down the Power button as well.
+** Release all keys after another seven seconds.
+** Turn on your Mac.
 
 == Development
 
@@ -193,30 +219,17 @@ git clone https://github.com/bkuhlmann/mac_os.git
 cd mac_os
 ----
 
-== Versioning
+== link:https://www.alchemists.io/policies/license[License]
 
-Read link:https://semver.org[Semantic Versioning] for details. Briefly, it means:
+== link:https://www.alchemists.io/policies/security[Security]
 
-* Major (X.y.z) - Incremented for any backwards incompatible public API changes.
+== link:https://www.alchemists.io/policies/code_of_conduct[Code of Conduct]
-* Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.
-* Patch (x.y.Z) - Incremented for small, backwards compatible, bug fixes.
 
-== Code of Conduct
+== link:https://www.alchemists.io/policies/contributions[Contributions]
 
-Please note that this project is released with a link:CODE_OF_CONDUCT.adoc[CODE OF CONDUCT]. By
+== link:https://www.alchemists.io/projects/mac_os/versions[Versions]
-participating in this project you agree to abide by its terms.
 
-== Contributions
+== link:https://www.alchemists.io/community[Community]
-
-Read link:CONTRIBUTING.adoc[CONTRIBUTING] for details.
-
-== License
-
-Read link:LICENSE.adoc[LICENSE] for details.
-
-== History
-
-Read link:CHANGES.adoc[CHANGES] for details.
 
 == Credits
 

VERSIONS.adoc

@@ -1,4 +1,60 @@
-= Changes
+= Versions
+
+== 15.0.1 (2022-01-01)
+
+* Updated README policy section links - Brooke Kuhlmann
+* Updated changes as versions documentation - Brooke Kuhlmann
+* Updated to Git Lint 3.0.0 - Brooke Kuhlmann
+* Removed code of conduct and contributing files - Brooke Kuhlmann
+
+== 15.0.0 (2021-12-27)
+
+* Fixed Hippocratic license structure - Brooke Kuhlmann
+* Fixed README changes and credits sections - Brooke Kuhlmann
+* Fixed Rubocop Bundler/OrderedGems issue - Brooke Kuhlmann
+* Fixed contributing documentation - Brooke Kuhlmann
+* Added README community link - Brooke Kuhlmann
+* Added README troubleshooting guide for SMC reset - Brooke Kuhlmann
+* Added project citation information - Brooke Kuhlmann
+* Updated GitHub issue template - Brooke Kuhlmann
+* Updated to Hippocratic License 3.0.0 - Brooke Kuhlmann
+* Updated to Ruby 3.0.3 - Brooke Kuhlmann
+* Updated to Ruby 3.1.0 - Brooke Kuhlmann
+
+== 14.0.0 (2021-10-25)
+
+* Updated to macOS Monterey - Brooke Kuhlmann
+* Removed notes from pull request template - Brooke Kuhlmann
+
+== 13.0.0 (2021-08-01)
+
+* Added install Node function - Brooke Kuhlmann
+* Updated Node package install script to use NPM - Brooke Kuhlmann
+* Updated Ruby installer to use Frum - Brooke Kuhlmann
+* Updated shell option help text - Brooke Kuhlmann
+* Removed NPM install check function - Brooke Kuhlmann
+
+== 12.0.1 (2021-07-17)
+
+* Updated to Ruby 3.0.1 - Brooke Kuhlmann
+* Updated to Ruby 3.0.2 - Brooke Kuhlmann
+
+== 12.0.0 (2021-03-16)
+
+* Fixed environment configuration to source Bash resource - Brooke Kuhlmann
+* Added Homebrew installation to Homebrew sripts - Brooke Kuhlmann
+* Added Node packages script - Brooke Kuhlmann
+* Added Ruby gems script - Brooke Kuhlmann
+* Added Rust crates script - Brooke Kuhlmann
+* Added bare package installer - Brooke Kuhlmann
+* Added dotfiles script - Brooke Kuhlmann
+* Added mas check to App Store install script - Brooke Kuhlmann
+* Added version release notes - Brooke Kuhlmann
+* Updated dev tools installer to agree to Rosetta license - Brooke Kuhlmann
+* Updated install root detection to support Elm - Brooke Kuhlmann
+* Updated setup software as configure software script - Brooke Kuhlmann
+* Removed CPU detection in favor of architecture detection - Brooke Kuhlmann
+* Refactored install scripts to separate script paths - Brooke Kuhlmann
 
 == 11.2.0 (2021-02-27)
 

bin/apply_basic_settings

@@ -6,6 +6,7 @@ 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

bin/apply_default_settings

@@ -6,6 +6,7 @@ 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

bin/configure_software

@@ -0,0 +1,16 @@
+#! /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

bin/install_app_store

@@ -6,9 +6,11 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_app_store"
 
 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"

bin/install_applications

@@ -6,6 +6,7 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_applications"
 
 if [[ -x "$SCRIPT_PATH" ]]; then

bin/install_dev_tools

@@ -1,6 +1,6 @@
 #! /usr/bin/env bash
 
-# Installs development tooling requirements.
+Installs development tooling requirements.
 
 printf "Installing Xcode CLI tools...\n"
 xcode-select --install
@@ -12,6 +12,6 @@ if [[ "$xcode_response" != "y" ]]; then
   exit 1
 fi
 
-if [[ -n "$(get_cpu)" ]]; then
+if [[ "$(/usr/bin/arch)" == "arm64" ]]; then
-  softwareupdate --install-rosetta
+  softwareupdate --install-rosetta --agree-to-license
 fi

bin/install_dotfiles

@@ -0,0 +1,16 @@
+#! /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

bin/install_extensions

@@ -6,6 +6,7 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_extensions"
 
 if [[ -x "$SCRIPT_PATH" ]]; then

bin/install_homebrew_casks

@@ -6,9 +6,11 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_homebrew_casks"
 
 if [[ -x "$SCRIPT_PATH" ]]; then
+  install_homebrew
   "$SCRIPT_PATH"
 else
   printf "WARNING: Homebrew Casks install script does not exist or is not executable.\n"

bin/install_homebrew_formulas

@@ -6,9 +6,11 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_homebrew_formulas"
 
 if [[ -x "$SCRIPT_PATH" ]]; then
+  install_homebrew
   "$SCRIPT_PATH"
 else
   printf "WARNING: Homebrew Formulas install script does not exist or is not executable.\n"

bin/install_node_packages

@@ -0,0 +1,17 @@
+#! /usr/bin/env bash
+
+# Installs Node packages.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_node_packages"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  install_node
+  "$SCRIPT_PATH"
+else
+  printf "WARNING: Node packages install script does not exist or is not executable.\n"
+fi

bin/install_ruby_gems

@@ -0,0 +1,17 @@
+#! /usr/bin/env bash
+
+# Installs Ruby gems.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_ruby_gems"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  install_ruby
+  "$SCRIPT_PATH"
+else
+  printf "WARNING: Ruby gems install script does not exist or is not executable.\n"
+fi

bin/install_rust_crates

@@ -0,0 +1,17 @@
+#! /usr/bin/env bash
+
+# Installs Rust crates.
+
+set -o nounset
+set -o errexit
+set -o pipefail
+IFS=$'\n\t'
+
+SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/install_rust_crates"
+
+if [[ -x "$SCRIPT_PATH" ]]; then
+  install_rust
+  "$SCRIPT_PATH"
+else
+  printf "WARNING: Rust crates install script does not exist or is not executable.\n"
+fi

bin/restore_backup

@@ -6,6 +6,7 @@ set -o nounset
 set -o errexit
 set -o pipefail
 IFS=$'\n\t'
+
 SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/restore_backup"
 
 if [[ -x "$SCRIPT_PATH" ]]; then

bin/run

@@ -39,9 +39,13 @@ while true; do
     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 "     s:  Setup installed software.\n"
+    printf "    cs:  Configure installed software.\n"
-    printf "     i:  Install everything (i.e. executes all install options).\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"

bin/setup_software

@@ -1,15 +0,0 @@
-#! /usr/bin/env bash
-
-# Sets up and launches (if necessary) installed software.
-
-set -o nounset
-set -o errexit
-set -o pipefail
-IFS=$'\n\t'
-SCRIPT_PATH="$MAC_OS_CONFIG_PATH/bin/setup_software"
-
-if [[ -x "$SCRIPT_PATH" ]]; then
-  "$SCRIPT_PATH"
-else
-  printf "WARNING: Software setup script does not exist or is not executable.\n"
-fi

lib/installers.sh

@@ -143,6 +143,23 @@ install_homebrew() {
 }
 export -f install_homebrew
 
+# Installs a package via a zip file.
+# 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 work_file="$app_name.pkg"
+
+  if [[ ! -e "$install_path" ]]; then
+    download_file "$url" "$work_file"
+    install_pkg "$MAC_OS_WORK_PATH" "$app_name"
+    printf "Installed: $app_name.\n"
+    verify_application "$app_name"
+  fi
+}
+export -f install_bare_pkg
+
 # Installs a package.
 # Parameters: $1 (required) - Package source path, $2 (required) - Application name.
 install_pkg() {
@@ -171,6 +188,37 @@ install_program() {
 }
 export -f install_program
 
+# Installs Node.
+# Parameters: None.
+install_node() {
+  if ! command -v fnm > /dev/null; then
+    $(get_homebrew_bin_root)/fnm install --lts
+  fi
+}
+export -f install_node
+
+# Installs Ruby.
+# Parameters: None.
+install_ruby() {
+  local 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
+  fi
+}
+export -f install_ruby
+
+# Installs Rust.
+# Parameters: None.
+install_rust() {
+  if ! command -v cargo > /dev/null; then
+    curl --proto "=https" --tlsv1.2 --fail --silent --show-error https://sh.rustup.rs | sh
+  fi
+}
+export -f install_rust
+
 # Installs an application via a tar file.
 # Parameters: $1 (required) - URL, $2 (required) - Application name, $3 (required) - Decompress options.
 install_tar_app() {

lib/options.sh

@@ -22,10 +22,18 @@ 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;;
-    's')
+    'cs')
-      bin/setup_software;;
+      bin/configure_software;;
     'i')
       caffeinate_machine
       bin/apply_basic_settings
@@ -35,8 +43,12 @@ process_option() {
       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/setup_software
+      bin/configure_software
       clean_work_path;;
     'R')
       caffeinate_machine
@@ -46,7 +58,10 @@ process_option() {
       verify_homebrew_casks
       verify_app_store_applications
       verify_applications
-      verify_extensions;;
+      verify_extensions
+      verify_node_packages
+      verify_ruby_gems
+      verify_rust_crates;;
     'C')
       caffeinate_machine;;
     'ua')

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 Big Sur.app/Contents/Resources/createinstallmedia"
+export MAC_OS_BOOT_DISK_CREATOR="/Applications/Install macOS Monterey.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"

lib/utilities.sh

@@ -28,13 +28,6 @@ get_basename() {
 }
 export -f get_basename
 
-# Answers current CPU.
-# Parameters: None.
-get_cpu() {
-  printf "%s" "$(system_profiler SPHardwareDataType | awk '/Chip/ {print $3}')"
-}
-export -f get_cpu
-
 # Answers the file extension.
 # Parameters: $1 (required) - The file name.
 get_extension() {
@@ -52,7 +45,7 @@ export -f get_extension
 # Answers Homebrew root path.
 # Parameters: None.
 get_homebrew_root() {
-  if [[ -n "$(get_cpu)" ]]; then
+  if [[ "$(/usr/bin/arch)" == "arm64" ]]; then
     printf "%s" "/opt/homebrew"
   else
     printf "%s" "/usr/local/Homebrew"
@@ -63,7 +56,7 @@ export -f get_homebrew_root
 # Answers Homebrew binary root path.
 # Parameters: None.
 get_homebrew_bin_root() {
-  if [[ -n "$(get_cpu)" ]]; then
+  if [[ "$(/usr/bin/arch)" == "arm64" ]]; then
     printf "%s" "/opt/homebrew/bin"
   else
     printf "%s" "/usr/local/bin"
@@ -86,6 +79,12 @@ 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
     '')
@@ -102,6 +101,17 @@ get_install_root() {
 }
 export -f get_install_root
 
+# Checks Mac App Store (mas) CLI has been installed and exits if otherwise.
+# Parameters: None.
+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."
+    exit 1
+  fi
+}
+export -f check_mas_install
+
 # Configures shell for new machines and ensures PATH is properly configured for running scripts.
 # Parameters: None.
 configure_environment() {
@@ -111,8 +121,7 @@ configure_environment() {
 
   if [[ ! -s "$HOME/.bashrc" ]]; then
     printf "%s\n" 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"' > "$HOME/.bashrc"
+    source "$HOME/.bashrc"
   fi
-
-  export PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/opt/homebrew/sbin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
 }
 export -f configure_environment

lib/verifiers.sh

@@ -126,3 +126,54 @@ verify_path() {
   fi
 }
 export -f verify_path
+
+# Checks for missing Node packages.
+verify_node_packages() {
+  printf "\nChecking Node packages...\n"
+
+  while read line; do
+    if [[ "$line" == "npm "* ]]; then
+      local package=$(printf "$line" | awk '{print $4}')
+      local 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"
+}
+export -f verify_node_packages
+
+# Checks for missing Ruby gems.
+verify_ruby_gems() {
+  local gems="$(gem list --no-versions)"
+
+  printf "\nChecking Ruby gems...\n"
+
+  while read line; do
+    if [[ "$line" == "gem install"* ]]; then
+      local gem=$(printf "$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"
+}
+export -f verify_ruby_gems
+
+# Checks for missing Rust crates.
+verify_rust_crates() {
+  printf "\nChecking Rust crates...\n"
+
+  local crates="$(ls -A1 $HOME/.cargo/bin)"
+
+  while read line; do
+    if [[ "$line" == "cargo install"* ]]; then
+      local crate=$(printf "$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"
+}
+export -f verify_rust_crates