feat: add create flow and unify bin with --mode

[JoshuaKGoldberg]

PR Checklist

• Addresses an existing open issue: fixes 🚀 Feature: Be able to initialize a new repository on the CLI (like create-* apps) #670
• That issue was marked as status: accepting prs
• Steps in CONTRIBUTING.md were taken

Overview

Changes the bin script to be the main launching point for the app. It can take in or prompt for a --mode set to either "create", "initialize", or "migrate".

This comes with a few cleanups:

• Simplified runOrRestore so that it just runs or logs - leaving parsing logic to the functions that call it
• Removed a lot of the terminal logs so that the remaining output is cleaner
• Cleaned up input parsing to have fewer different code paths / types

Tracking my todo items:

• Add a new create flow alongside initialize and migrate
• Manually test a bunch
• Refactor their code to streamline the flow of logic
• Fix unit tests
• Fix existing end-to-end tests
• Overhaul documentation
• Add a new end-to-end test
• Manually test some more

[github-actions]

PR Compliance Checks Passed!

[codecov]

Codecov Report

Merging #681 (842741a) into main (556ea3a) will increase coverage by 6.71%.
Report is 1 commits behind head on main.
The diff coverage is 44.75%.

@@            Coverage Diff             @@
##             main     #681      +/-   ##
==========================================
+ Coverage   56.32%   63.03%   +6.71%     
==========================================
  Files          64       77      +13     
  Lines         403      487      +84     
  Branches       77       83       +6     
==========================================
+ Hits          227      307      +80     
- Misses        165      169       +4     
  Partials       11       11              

Flag	Coverage Δ
create	94.11% <100.00%> (?)
initialize	94.11% <100.00%> (∅)
migrate	100.00% <100.00%> (ø)
unit	59.40% <43.50%> (+3.51%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files Changed	Coverage Δ
src/create/createWithValues.ts	0.00% <0.00%> (ø)
src/create/index.ts	0.00% <0.00%> (ø)
src/initialize/index.ts	0.00% <0.00%> (ø)
src/initialize/initializeWithValues.ts	0.00% <0.00%> (ø)
src/migrate/index.ts	0.00% <0.00%> (ø)
src/migrate/migrateWithValues.ts	0.00% <0.00%> (ø)
src/migrate/values/readAuthorIfExists.ts	100.00% <ø> (ø)
src/migrate/values/readEmailIfExists.ts	100.00% <ø> (ø)
src/shared/args.ts	0.00% <0.00%> (ø)
src/shared/augmentValuesWithNpmInfo.ts	0.00% <0.00%> (ø)
... and 54 more

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[github-actions]

🎉 This is included in version v1.29.1 🎉

The release is available on:

• GitHub releases
• npm package (@latest dist-tag)

Cheers! 📦🚀