メンテナンスについて

不要なコードの発見

利用されていないexportやファイルを発見するために Knip を利用する。

導入する場合は公式の初期化手順に従い、実行コマンドは対象リポジトリの package.json に定義する。 本ドキュメントサイト自体の品質ゲートは package.json の check / lint:text である。

Gitコマンドをトリガーにした処理

husky と lint-staged を使い、commit と push のタイミングでチェックを自動実行する。

フックの正本は .husky/ 配下である。 対象ファイルと実行コマンドは package.json の lint-staged とscriptsを参照する。

Commit時に発火させたい場合

コミット前は lint-staged でステージ済みファイルだけを整形する。 実装は .husky/pre-commit を正とする。

Push時に発火させたい場合

プッシュ前は npm run check を実行する。 実装は .husky/pre-push を正とする。 v1時代の _/husky.sh 読み込みは不要である。

Workers Buildsのプレビュー公開

本番ブランチ（release）への反映はGitHub Actionsの本番リリースが行う。 Cloudflare Workers Buildsがreleaseへのpushを受けて公開する。 手元で同じ成果物を確認する場合は npm run build のあと npx wrangler deploy を使う。 それ以外のブランチは、npm run buildのあとnpm run deploy:previewでWorker Previewを作成する。 deploy:previewはwrangler previewを使い、本番のルートやトラフィックは変更しない。

ブランチ名はWORKERS_CI_BRANCHを優先し、未指定なら現在のGitブランチを使う。 #や/など英数字とハイフン以外はハイフンへ置換し、63文字以内に収める。 wrangler.jsoncのpreviewsは空オブジェクトとし、本番のroutesは変更しない。