feat: add hydration script for existing repos (#441)

## PR Checklist

- [x] Addresses an existing open issue: fixes #374 
- [x] That issue was marked as [`status: accepting
prs`](https://github.com/JoshuaKGoldberg/template-typescript-node-package/issues?q=is%3Aopen+is%3Aissue+label%3A%22status%3A+accepting+prs%22)
- [x] Steps in
[CONTRIBUTING.md](https://github.com/JoshuaKGoldberg/template-typescript-node-package/blob/main/.github/CONTRIBUTING.md)
were taken

## Overview

Adds the script as a `bin` command you can run with `npx
template-typescript-node-package`. Which bumps up a few dependencies
from `devDependency` to `dependency`.

This has the nice side effect of standardizing formatting for an
assortment of files. Hence the large _Files changed_ count outside of
the new `src/hydrate/` directory.

Things I've intentionally not done here, so they can be filed as
followup issues:

* Filling in unit test coverage
* Running
[`all-contributors-for-repository`](https://github.com/JoshuaKGoldberg/all-contributors-for-repository)
to fill in the `.all-contributorsrc`
* Removing existing image badges from the README.md
* Removing existing `CODE_OF_CONDUCT.md`
* Use the GitHub API to set up labels and other repo settings 
* Run `pnpm run lint --fix`
* CLI flag for hydration to just refresh files locally
* Getting hydration to the point where it doesn't make changes in this
repo _(is that possible?)_
* A copy&pastable script to run in a repo to update it to the latest
tooling (migrations?!)

Author: JoshuaKGoldberg

.eslintrc.cjs

@@ -79,9 +79,9 @@ module.exports = {
 			},
 		},
 		{
+			extends: ["plugin:yml/standard", "plugin:yml/prettier"],
 			files: ["**/*.{yml,yaml}"],
 			parser: "yaml-eslint-parser",
-			extends: ["plugin:yml/standard", "plugin:yml/prettier"],
 			rules: {
 				"yml/file-extension": ["error", { extension: "yml" }],
 				"yml/sort-keys": [

.github/CODE_OF_CONDUCT.md

@@ -60,7 +60,7 @@ representative at an online or offline event.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported to the community leaders responsible for enforcement at
-git@joshuakgoldberg.com.
+npm@joshuakgoldberg.com.
 All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the

.github/DEVELOPMENT.md

@@ -67,9 +67,38 @@ Calls to `console.log`, `console.warn`, and other console methods will cause a t
 This repository includes a [VS Code launch configuration](https://code.visualstudio.com/docs/editor/debugging) for debugging unit tests.
 To launch it, open a test file, then run _Debug Current Test File_ from the VS Code Debug panel (or press F5).
 
+## The Hydration Script
+
+This template's "hydration" script is located in `src/hydrate/`.
+It needs to be [built](#building) before it can be run.
+
+Be warned that running the hydration script in a repository -including this one- will modify that repository.
+To test out the script, you may want to create a new test repository to run on:
+
+```shell
+cd ..
+mkdir temp
+cd temp
+echo node_modules > .gitignore
+git init
+npm init --yes
+```
+
+Then, in that directory, you can directly call the hydration script:
+
+```shell
+node ../template-typescript-node-package -- description "Hooray, trying things out locally."
+```
+
+Along with the hydration script itself, end-to-end tests are removed on package setup.
+
+## The Setup Script
+
+This template's "setup" script is located in `script/`.
+
 ### Testing the Setup Script
 
-In addition to unit tests, this template also includes an "end-to-end" test for `script/setup.js`.
+This template source includes an "end-to-end" test for `script/setup.js`.
 You can run it locally on the command-line:
 
 ```shell
@@ -81,4 +110,4 @@ That end-to-end test executes `script/setup-test-e2e.js`, which:
 1. Runs the setup script using `--skip-api`
 2. Checks that the local repository's files were changed correctly (e.g. removed setup-only files)
 
-As with the setup script itself, end-to-end tests are removed on package setup.
+Along with the setup script itself, end-to-end tests are removed on package setup.

.github/actions/prepare/action.yml

@@ -1,6 +1,7 @@
 description: Prepares the repo for a typical CI job
 
 name: Prepare
+
 runs:
   steps:
     - uses: pnpm/action-setup@v2

.github/workflows/build.yml

@@ -11,7 +11,6 @@ name: Build
 
 on:
   pull_request: ~
-
   push:
     branches:
       - main

.github/workflows/compliance.yml

@@ -5,7 +5,7 @@ jobs:
       - uses: mtfoley/pr-compliance-action@main
         with:
           body-auto-close: false
-          ignore-authors: |
+          ignore-authors: |-
             allcontributors
             allcontributors[bot]
             renovate

.github/workflows/hydrate.yml

@@ -0,0 +1,17 @@
+jobs:
+  hydrate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: ./.github/actions/prepare
+      - run: pnpm run build
+      - run: pnpm run setup:test
+
+name: Test Hydrate Script
+
+on:
+  pull_request: ~
+
+  push:
+    branches:
+      - main

.github/workflows/knip.yml renamed to .github/workflows/lint-knip.yml

@@ -1,5 +1,5 @@
 jobs:
-  knip:
+  lint_knip:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
@@ -10,7 +10,6 @@ name: Lint Knip
 
 on:
   pull_request: ~
-
   push:
     branches:
       - main

.github/workflows/markdown.yml renamed to .github/workflows/lint-markdown.yml

@@ -1,5 +1,5 @@
 jobs:
-  markdown:
+  lint_markdown:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
@@ -10,7 +10,6 @@ name: Lint Markdown
 
 on:
   pull_request: ~
-
   push:
     branches:
       - main

.github/workflows/package.yml renamed to .github/workflows/lint-package.yml

@@ -1,5 +1,5 @@
 jobs:
-  package:
+  lint_package:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
@@ -10,7 +10,6 @@ name: Lint Package
 
 on:
   pull_request: ~
-
   push:
     branches:
       - main