AlgorithmAndLeetCode · pull · Feb 9, 2026 · Feb 9, 2026 · Feb 9, 2026 · Feb 9, 2026
diff --git a/.agents/skills/git-commit/SKILL.md b/.agents/skills/git-commit/SKILL.md
@@ -0,0 +1,125 @@
+---
+name: git-commit
+description: 'Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping'
+license: MIT
+allowed-tools: Bash
+---
+
+# Git Commit with Conventional Commits
+
+## Overview
+
+Create standardized, semantic git commits using the Conventional Commits specification. Analyze the actual diff to determine appropriate type, scope, and message.
+
+## Conventional Commit Format
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+## Commit Types
+
+| Type       | Purpose                        |
+| ---------- | ------------------------------ |
+| `feat`     | New feature                    |
+| `fix`      | Bug fix                        |
+| `docs`     | Documentation only             |
+| `style`    | Formatting/style (no logic)    |
+| `refactor` | Code refactor (no feature/fix) |
+| `perf`     | Performance improvement        |
+| `test`     | Add/update tests               |
+| `build`    | Build system/dependencies      |
+| `ci`       | CI/config changes              |
+| `chore`    | Maintenance/misc               |
+| `revert`   | Revert commit                  |
+
+## Breaking Changes
+
+```
+# Exclamation mark after type/scope
+feat!: remove deprecated endpoint
+
+# BREAKING CHANGE footer
+feat: allow config to extend other configs
+
+BREAKING CHANGE: `extends` key behavior changed
+```
+
+## Workflow
+
+### 1. Analyze Diff
+
+```bash
+# If files are staged, use staged diff
+git diff --staged
+
+# If nothing staged, use working tree diff
+git diff
+
+# Also check status
+git status --porcelain
+```
+
+### 2. Stage Files (if needed)
+
+If nothing is staged or you want to group changes differently:
+
+```bash
+# Stage specific files
+git add path/to/file1 path/to/file2
+
+# Stage by pattern
+git add *.test.*
+git add src/components/*
+
+# Interactive staging
+git add -p
+```
+
+**Never commit secrets** (.env, credentials.json, private keys).
+
+### 3. Generate Commit Message
+
+Analyze the diff to determine:
+
+- **Type**: What kind of change is this?
+- **Scope**: What area/module is affected?
+- **Description**: One-line summary of what changed (present tense, imperative mood, <72 chars)
+
+### 4. Execute Commit
+
+```bash
+# Single line
+git commit -m "<type>[scope]: <description>"
+
+# Multi-line with body/footer
+git commit -m "$(cat <<'EOF'
+<type>[scope]: <description>
+
+<optional body>
+
+<optional footer>
+EOF
+)"
+```
+
+## Best Practices
+
+- One logical change per commit
+- Present tense: "add" not "added"
+- Imperative mood: "fix bug" not "fixes bug"
+- Reference issues: `Closes #123`, `Refs #456`
+- Keep description under 72 characters
+- **Always use English for commit messages.** Never use other languages.
+
+## Git Safety Protocol
+
+- NEVER update git config
+- NEVER run destructive commands (--force, hard reset) without explicit request
+- NEVER skip hooks (--no-verify) unless user asks
+- NEVER force push to main/master
+- If commit fails due to hooks, fix and create NEW commit (don't amend)
diff --git a/.github/workflows/black-lint.yml b/.github/workflows/black-lint.yml
@@ -20,7 +20,7 @@ on:
       - lcci/**
       - basic/**
 
-concurrency: 
+concurrency:
   group: ${{github.workflow}} - ${{github.ref}}
   cancel-in-progress: true
 
@@ -30,6 +30,6 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
-    - uses: jpetrucciani/black-check@24.2.0
+    - uses: jpetrucciani/black-check@master
       with:
         black_flags: '-S'
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -15,72 +15,116 @@ on:
       - basic/**
 
 concurrency:
-  group: ${{github.workflow}} - ${{github.ref}}
+  group: ${{ github.workflow }} - ${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/checkout@v4
+      - name: Checkout main branch
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Checkout docs branch
+        uses: actions/checkout@v4
         with:
           ref: docs
           path: mkdocs
-      - run: |
-          mv -f mkdocs/* .
+          fetch-depth: 0
+
+      - name: Sync docs branch content
+        run: |
+          rsync -a --remove-source-files --exclude='.git' mkdocs/ ./
+          rm -rf mkdocs
           mv solution/CONTEST_README.md docs/contest.md
           mv solution/CONTEST_README_EN.md docs-en/contest.md
+
       - name: Configure Git Credentials
         run: |
-          git config user.name github-actions[bot]
-          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+          git config --global user.name github-actions[bot]
+          git config --global user.email 41898282+github-actions[bot]@users.noreply.github.com
 
-      - uses: actions/setup-python@v5
+      - name: Setup Python
+        uses: actions/setup-python@v5
         with:
           python-version: 3.x
 
-      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - name: Restore pip cache
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
 
-      - uses: actions/cache@v4
+      - name: Restore mkdocs-material cache
+        uses: actions/cache@v4
         with:
-          key: mkdocs-material-${{ env.cache_id }}
           path: .cache
+          key: mkdocs-material-${{ env.cache_id }}
           restore-keys: |
             mkdocs-material-
-            
+
       - name: Install dependencies
         run: |
           python3 -m pip install --upgrade pip
           python3 -m pip install -r requirements.txt
           python3 -m pip install "mkdocs-material[imaging]"
-          sudo apt-get install pngquant
-          
-      - name: Set MKDOCS_API_KEYS environment variable
+          sudo apt-get install -y pngquant
+
+      - name: Set MKDOCS_API_KEYS
         run: echo "MKDOCS_API_KEYS=${{ secrets.MKDOCS_API_KEYS }}" >> $GITHUB_ENV
 
-      - run: |
+      - name: Build site
+        run: |
           python3 main.py
           mkdocs build -f mkdocs.yml
           mkdocs build -f mkdocs-en.yml
 
-      - name: Generate CNAME file
+      - name: Generate CNAME
         run: echo "leetcode.doocs.org" > ./site/CNAME
 
-      - name: Upload artifact
+      - name: Commit committer cache to docs branch
+        if: github.ref == 'refs/heads/main'
+        env:
+          GH_REPO: ${{ github.repository }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          CACHE_FILE=".git-committers-cache.json"
+          if [[ ! -f "$CACHE_FILE" ]]; then
+            echo "Cache file not found; skip commit."
+            exit 0
+          fi
+
+          echo "Cloning docs branch ..."
+          git clone --depth 1 --branch docs "https://x-access-token:${GH_TOKEN}@github.com/${GH_REPO}.git" docs-cache
+          cp "$CACHE_FILE" docs-cache/
+
+          cd docs-cache
+
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+          git add .git-committers-cache.json
+          git commit -m "chore: update committer cache [skip ci]" || echo "No changes to commit"
+          git push origin docs
+
+      - name: Upload to GitHub Pages
         uses: actions/upload-pages-artifact@v3
         with:
-          path: ./site
+          path: site
 
   deploy:
     needs: build
+    runs-on: ubuntu-latest
     permissions:
       pages: write
       id-token: write
     environment:
       name: github_pages
       url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
     steps:
       - name: Deploy to GitHub Pages
         id: deployment

diff --git a/.github/workflows/prettier.yml b/.github/workflows/prettier.yml
@@ -10,6 +10,12 @@ concurrency:
 
 jobs:
   format:
+    # ---------------------------------------------------------
+    # SAFETY CHECK:
+    # Only run for PRs from the SAME repository.
+    # Fork PRs are skipped entirely to prevent RCE via pnpm install.
+    # ---------------------------------------------------------
+    if: ${{ github.event.pull_request.head.repo.fork == false }}
     permissions:
       contents: write
     runs-on: ubuntu-latest
@@ -24,15 +30,19 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 18
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.25.0
       - name: Install Dependencies
-        run: npm install
+        run: pnpm install
       - name: Run prettier
         run: |
           git config --global core.quotepath off
           changed_files=$(git diff --name-only "${{ github.event.pull_request.base.sha }}" | grep -E '\.js$|\.ts$|\.php$|\.sql$|\.md$' || true)
           if [ -n "$changed_files" ]; then
             echo "Running prettier on the changed files"
-            echo "$changed_files" | xargs -d '\n' npx prettier --write
+            echo "$changed_files" | xargs -d '\n' pnpm exec prettier --write
           else
             echo "No matching files to run prettier on."
           fi

diff --git a/.gitignore b/.gitignore
@@ -3,10 +3,21 @@
 .vscode
 .temp
 .vitepress
-.cache
 *.iml
 __pycache__
 /node_modules
-/solution/result.json
+package-lock.json
 /solution/__pycache__
 /solution/.env
+.cache
+!.cache/plugin/
+!.cache/plugin/git-committers/
+!.cache/plugin/git-committers/page-authors.json
+
+# Claude
+.claude/settings.local.json
+
+# pnpm
+pnpm-lock.yaml
+.pnpm-store/
+.pnpm-debug.log
diff --git a/.husky/_/husky.sh b/.husky/_/husky.sh
diff --git a/.husky/commit-msg b/.husky/commit-msg
@@ -1,3 +1,2 @@
-#!/bin/sh
-
-npx --no -- commitlint --edit $1
+#!/usr/bin/env sh
+pnpm exec commitlint --edit $1
diff --git a/.husky/pre-commit b/.husky/pre-commit
@@ -1,3 +1,2 @@
-#!/bin/sh
-
-npx lint-staged --allow-empty $1
+#!/usr/bin/env sh
+pnpm exec lint-staged --allow-empty $1
diff --git a/AGENTS.md b/AGENTS.md
@@ -0,0 +1 @@
+@CLAUDE.md