カレンダー

zunoser Project #3

購読

Google カレンダーに追加

Apple カレンダー / Outlook:

webcal://raw.githubusercontent.com/zunoser/calendar/main/ics/calendar.ics

その他:

https://raw.githubusercontent.com/zunoser/calendar/main/ics/calendar.ics

コマンド

pnpm zunocal view                # カレンダーをテーブル表示
pnpm zunocal check [--dry-run]   # 日付の整合性を検査し Date status を Error/Next に更新
pnpm zunocal close [--dry-run]   # 終了日が過去の open な Issue を close
pnpm zunocal remind <days> [--dry-run] # 開始日の<days>日前に担当者全員を Issue コメントでメンション
pnpm zunocal ics [--out <path>]  # iCalendar を書き出す (既定: ics/calendar.ics)
pnpm zunocal svg --month YYYY-MM --output <path> # 指定月のSVGを1枚書き出す
pnpm zunocal readme <path> --tag <tag> [--alt <text>] [--readme <path>] # READMEの画像参照を差し替え

svg は指定した1か月・1ファイルだけを書き出し、READMEには触れない。 どの月を書き出すか・ファイル名をどう付けるかは呼び出し側が決める(ランダムな名前を付けると画像URLの衝突とキャッシュを避けられる)。 readme はREADMEの <!-- zunocal:<tag>:start --> 〜 <!-- zunocal:<tag>:end --> 内の画像参照を1枚に差し替える。それ以外のことはしない。旧ファイルの掃除も呼び出し側の責務 (daily.yml は render 前にまとめて削除している):

path="assets/calendar-current-$(openssl rand -hex 6).svg"
pnpm zunocal svg --month 2026-08 --output "$path"
pnpm zunocal readme "$path" --tag calendar:current

開発

Nix を利用する場合は、direnv allow または nix develop で Node.js と Corepack 管理の pnpm が入った開発環境を利用できる。

npm run setup
pnpm install
pnpm test              # ユニットテスト (純粋ロジックのみ)
pnpm test:integration  # 実 API への Read 専用テスト (要 TOKEN)
pnpm typecheck
pnpm lint
pnpm fmt

リポジトリ基盤

infra/github では、バージョン固定した OpenTofu モジュール zunoser/tfmodule-gh-repo-kit を使ってこのリポジトリを管理している。 state は共有 R2 バックエンドの github/repositories/calendar/terraform.tfstate に保存し、リポジトリラベルは infra/github/labels.tf でモジュールとあわせて宣言している。

認証情報なしで静的検証できる:

tofu -chdir=infra/github init -backend=false
tofu -chdir=infra/github validate

実際の plan には、R2 バックエンドの認証情報と GitHub トークンも必要になる。

パッケージ構成

パッケージ	役割
packages/cli	コマンド定義と表示 (citty)
packages/core	設定 (parseConfig) とサービス (getGitHubCalendar)、純粋なイベント操作
packages/github	GitHub GraphQL の repository 層 (gql.tada + graphql-request)
packages/ics	iCalendar 生成 (ical-generator の薄いアダプタ)
packages/svg	月グリッドのカレンダー画像 (SVG) 生成
packages/utils	汎用ユーティリティ

GitHub の GraphQL スキーマは packages/github/schema.docs.graphql にベンダリングしている (公式の公開スキーマ をダウンロードしたもの)。 スキーマを更新したら型定義を再生成する:

curl -sL -o packages/github/schema.docs.graphql https://docs.github.com/public/fpt/schema.docs.graphql
pnpm --filter @zunoser/calendar-github exec gql-tada generate-output