Release

.claude/commands/open-pr.md

@@ -0,0 +1,24 @@
+Open a pull request from the current branch changes.
+
+$ARGUMENTS is an optional mode. Use `draft` to open a draft pull request.
+
+Workflow:
+
+1. Collect context from git:
+   - Branch name.
+   - Commits ahead of `dev`.
+   - Changed files.
+2. Set base branch to `dev`.
+3. Summarise what changed, why, context, risks, and manual testing evidence.
+4. Produce a pull request body using this exact template and section order:
+   `.claude/commands/assets/pull-request-template.md`
+5. If any section details are unknown, write "N/A".
+6. Do not remove sections.
+7. Ensure the branch is pushed to origin.
+8. Decide draft mode from $ARGUMENTS:
+   - If `draft`, create a draft pull request.
+   - Otherwise, create a ready-for-review pull request.
+9. Verify `gh` is installed and authenticated.
+10. Open the pull request using `gh pr create` with explicit title and body,
+    always with `--base dev`. Use `--draft` only when mode is `draft`.
+11. Return only the created pull request URL.

.claude/commands/upgrade-deps.md

@@ -0,0 +1,36 @@
+Upgrade the provided dependencies.
+
+$ARGUMENTS is a list of package names to upgrade, one per line or
+comma-separated.
+
+Workflow:
+
+1. Read `pnpm-workspace.yaml`.
+2. Run `pnpm -r outdated` and keep only selected packages.
+3. For each selected package, fetch the changelog or release notes and extract
+   only relevant changes between current and target versions.
+4. Present the changelog summary in this exact format for every package:
+
+   ```
+   Package: <name> (<current> -> <target>)
+
+   - Changelog: <changelog or release-notes URL>
+   - Relevant fixes:
+     - <fix 1>
+   - Relevant features:
+     - <feature 1>
+   - Breaking changes:
+     - <none> | <breaking change details>
+   - Risk level: <low|medium|high> - <one-line rationale>
+   - Recommendation: <upgrade now|upgrade with caution|defer>
+   ```
+
+   If an item has no fixes or features, write `- <none>`.
+
+5. Ask for explicit confirmation before any file edit.
+6. Only if confirmed, update `pnpm-workspace.yaml` for the selected packages and
+   run `pnpm i`.
+7. Report bumped packages, changed files, and install warnings.
+
+Follow the dependency upgrade guidelines in
+`.github/instructions/dependency-upgrades.instructions.md`.

.claude/settings.json

@@ -0,0 +1,30 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "dir=\"$(dirname \"$CLAUDE_TOOL_INPUT_FILE_PATH\")\"; while [[ ! -f \"$dir/package.json\" ]] && [[ \"$dir\" != \"/\" ]]; do dir=\"$(dirname \"$dir\")\"; done; [[ -f \"$dir/package.json\" ]] && cd \"$dir\" && pnpm exec prettier --write --log-level warn \"$CLAUDE_TOOL_INPUT_FILE_PATH\""
+          },
+          {
+            "type": "command",
+            "command": "if [[ \"$CLAUDE_TOOL_INPUT_FILE_PATH\" =~ \\.(js|ts|tsx)$ ]]; then dir=\"$(dirname \"$CLAUDE_TOOL_INPUT_FILE_PATH\")\"; while [[ ! -f \"$dir/package.json\" ]] && [[ \"$dir\" != \"/\" ]]; do dir=\"$(dirname \"$dir\")\"; done; [[ -f \"$dir/package.json\" ]] && cd \"$dir\" && pnpm exec eslint --cache --cache-location ./node_modules/.cache/eslint --fix --max-warnings 0 \"$CLAUDE_TOOL_INPUT_FILE_PATH\"; fi"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if [[ \"$CLAUDE_TOOL_INPUT_FILE_PATH\" == *\".env\"* ]]; then echo 'Editing .env files is not allowed. Ask the user to update environment variables manually.' && exit 2; fi"
+          }
+        ]
+      }
+    ]
+  }
+}