@vibe-x/agent-better-checkpoint 0.1.1 → 0.2.0

package/platform/unix/checkpoint.sh

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
 #
-# checkpoint.sh — 创建语义化的 Git checkpoint commit
+# checkpoint.sh — Create semantic Git checkpoint commits
 #
-# AI 生成描述性内容（subject + body），本脚本负责：
-# 1. 截断 user-prompt（≤60字符，头尾截断）
-# 2. 通过 git interpret-trailers 追加元信息
-# 3. 执行 git add -A && git commit
+# AI provides descriptive content (subject + body). This script:
+# 1. Truncates user-prompt (≤60 chars, head+tail)
+# 2. Appends metadata via git interpret-trailers
+# 3. Runs git add -A && git commit
 #
 # Usage:
 #   checkpoint.sh <message> [user-prompt] [--type auto|fallback]
@@ -13,7 +13,7 @@
 set -euo pipefail
 
 # ============================================================
-# 参数解析
+# Argument parsing
 # ============================================================
 MESSAGE="${1:-}"
 USER_PROMPT="${2:-}"
@@ -39,7 +39,7 @@ if [[ -z "$MESSAGE" ]]; then
 fi
 
 # ============================================================
-# 平台检测
+# Platform detection
 # ============================================================
 detect_platform() {
     if [[ -n "${CLAUDE_CODE:-}" ]] || command -v claude &>/dev/null; then
@@ -54,7 +54,7 @@ detect_platform() {
 AGENT_PLATFORM=$(detect_platform)
 
 # ============================================================
-# User-Prompt 截断（≤60 字符，头尾保留 + 中间省略号）
+# User-Prompt truncation (≤60 chars, head+tail + ellipsis)
 # ============================================================
 truncate_prompt() {
     local prompt="$1"
@@ -79,18 +79,18 @@ if [[ -n "$USER_PROMPT" ]]; then
 fi
 
 # ============================================================
-# 检查是否有变更
+# Check for changes
 # ============================================================
 has_changes() {
-    # staged 变更
+    # Staged changes
     if ! git diff --cached --quiet 2>/dev/null; then
         return 0
     fi
-    # unstaged 变更
+    # Unstaged changes
     if ! git diff --quiet 2>/dev/null; then
         return 0
     fi
-    # untracked 文件
+    # Untracked files
     if [[ -n "$(git ls-files --others --exclude-standard 2>/dev/null)" ]]; then
         return 0
     fi
@@ -108,7 +108,7 @@ fi
 git add -A
 
 # ============================================================
-# 构建 trailer 并提交
+# Build trailers and commit
 # ============================================================
 TRAILER_ARGS=(
     --trailer "Agent: ${AGENT_PLATFORM}"

package/platform/win/check_uncommitted.ps1

@@ -1,28 +1,36 @@
 <#
 .SYNOPSIS
-    check_uncommitted.ps1 — Stop Hook: 检查未提交的变更 (Windows PowerShell)
+    check_uncommitted.ps1 — Stop Hook: check for uncommitted changes (Windows PowerShell)
 
 .DESCRIPTION
-    在 AI 对话结束时触发，检查工作区是否存在未提交的变更。
-    如果存在，输出提醒信息让 AI Agent 执行 fallback checkpoint commit。
+    Triggered at AI conversation end. Checks workspace for uncommitted changes.
+    If found, outputs reminder for AI Agent to run fallback checkpoint commit.
 
-    支持平台:
-    - Cursor: stop hook (stdin JSON 含 workspace_roots)
-    - Claude Code: Stop hook (stdin JSON 含 hook_event_name)
+    Supported platforms:
+    - Cursor: stop hook (stdin JSON with workspace_roots)
+    - Claude Code: Stop hook (stdin JSON with hook_event_name)
 
-    输出协议:
-    - 无问题: {} (空 JSON)
-    - 有问题 (Cursor): {"followup_message": "..."}
-    - 有问题 (Claude Code): {"decision": "block", "reason": "..."}
+    Output protocol:
+    - OK: {} (empty JSON)
+    - Block (Cursor): {"followup_message": "..."}
+    - Block (Claude Code): {"decision": "block", "reason": "..."}
+
+    Config: .vibe-x/agent-better-checkpoint/config.yml (project-level, optional)
 #>
 
 $ErrorActionPreference = "Stop"
 
+$CONFIG_FILE_NAME = ".vibe-x/agent-better-checkpoint/config.yml"
+
 # ============================================================
-# 辅助函数
+# Helper functions
 # ============================================================
 
 function Output-Allow {
+    param([string]$Info = "")
+    if ($Info) {
+        [Console]::Error.WriteLine("[checkpoint] $Info")
+    }
     Write-Output '{}'
     exit 0
 }
@@ -33,7 +41,6 @@ function Output-Block {
         [string]$Platform
     )
 
-    # 转义 JSON 字符串
     $Escaped = $Message -replace '\\', '\\\\' `
                         -replace '"', '\"' `
                         -replace "`r`n", '\n' `
@@ -56,7 +63,145 @@ function Output-Block {
 }
 
 # ============================================================
-# 平台检测
+# Config parsing
+# ============================================================
+
+function Parse-CheckpointConfig {
+    param([string]$ConfigPath)
+
+    $config = @{
+        MinChangedLines = $null
+        MinChangedFiles = $null
+        PassivePatterns = @()
+    }
+
+    if (-not (Test-Path $ConfigPath)) {
+        return $config
+    }
+
+    $lines = Get-Content $ConfigPath -ErrorAction SilentlyContinue
+    if (-not $lines) { return $config }
+
+    $inPassiveSection = $false
+
+    foreach ($line in $lines) {
+        # Skip comments
+        if ($line -match '^\s*#') { continue }
+        if (-not $line.Trim()) { continue }
+
+        # Thresholds under trigger_if_any
+        if ($line -match '^\s+min_changed_lines:\s*(\d+)') {
+            $config.MinChangedLines = [int]$Matches[1]
+            continue
+        }
+        if ($line -match '^\s+min_changed_files:\s*(\d+)') {
+            $config.MinChangedFiles = [int]$Matches[1]
+            continue
+        }
+
+        # passive_patterns section
+        if ($line -match '^passive_patterns:') {
+            $inPassiveSection = $true
+            continue
+        }
+        if ($inPassiveSection) {
+            if ($line -match '^\s+-\s+(.+)') {
+                $val = $Matches[1].Trim()
+                $val = $val -replace '^["'']', '' -replace '["'']$', ''
+                $val = $val -replace '\s*#.*$', ''
+                if ($val) {
+                    $config.PassivePatterns += $val
+                }
+            }
+            elseif ($line -match '^\S') {
+                $inPassiveSection = $false
+            }
+        }
+    }
+
+    return $config
+}
+
+# ============================================================
+# Passive file matching
+# ============================================================
+
+function Test-PassiveFile {
+    param(
+        [string]$FilePath,
+        [string[]]$Patterns
+    )
+
+    foreach ($pattern in $Patterns) {
+        # dir/** → match all files under dir/
+        if ($pattern -match '^(.+)/\*\*$') {
+            $prefix = $Matches[1] + "/"
+            if ($FilePath.StartsWith($prefix)) { return $true }
+            continue
+        }
+
+        # *.ext → match suffix
+        if ($pattern -match '^\*(\..+)$') {
+            $suffix = $Matches[1]
+            if ($FilePath.EndsWith($suffix)) { return $true }
+            continue
+        }
+
+        # Exact match
+        if ($FilePath -eq $pattern) { return $true }
+    }
+
+    return $false
+}
+
+# ============================================================
+# Changed line count
+# ============================================================
+
+function Get-ChangedLineCount {
+    param(
+        [string]$Workspace,
+        [string[]]$Files
+    )
+
+    if ($Files.Count -eq 0) { return 0 }
+    $total = 0
+
+    # Tracked files: staged + unstaged
+    $diffArgs = @("-C", $Workspace, "diff", "--numstat", "--") + $Files
+    $cachedArgs = @("-C", $Workspace, "diff", "--cached", "--numstat", "--") + $Files
+
+    foreach ($args in @($diffArgs, $cachedArgs)) {
+        $output = git @args 2>$null
+        if ($output) {
+            foreach ($line in ($output -split "`n")) {
+                $parts = $line -split "`t"
+                if ($parts.Count -ge 2) {
+                    $adds = if ($parts[0] -ne "-") { [int]$parts[0] } else { 0 }
+                    $dels = if ($parts[1] -ne "-") { [int]$parts[1] } else { 0 }
+                    $total += $adds + $dels
+                }
+            }
+        }
+    }
+
+    # Untracked files: total lines count as changes
+    foreach ($file in $Files) {
+        $untracked = git -C $Workspace ls-files --others --exclude-standard -- $file 2>$null
+        if ($untracked) {
+            $fullPath = Join-Path $Workspace $file
+            if (Test-Path $fullPath -PathType Leaf) {
+                $lineCount = (Get-Content $fullPath -ErrorAction SilentlyContinue | Measure-Object -Line).Lines
+                $total += $lineCount
+            }
+        }
+    }
+
+    return $total
+}
+
+# ============================================================
+# Platform detection
 # ============================================================
 
 function Detect-Platform {
@@ -73,13 +218,12 @@ function Detect-Platform {
 }
 
 # ============================================================
-# Workspace Root 检测
+# Workspace root detection
 # ============================================================
 
 function Get-WorkspaceRoot {
     param($InputData)
 
-    # 优先从 stdin JSON 获取
     if ($InputData) {
         foreach ($field in @("workspace_roots", "workspaceRoots")) {
             $roots = $null
@@ -90,18 +234,16 @@ function Get-WorkspaceRoot {
         }
     }
 
-    # 回退到环境变量
     foreach ($envVar in @("CURSOR_PROJECT_DIR", "CLAUDE_PROJECT_DIR", "WORKSPACE_ROOT", "PROJECT_ROOT")) {
         $val = [Environment]::GetEnvironmentVariable($envVar)
         if ($val) { return $val }
     }
 
-    # 最终回退到当前目录
     return (Get-Location).Path
 }
 
 # ============================================================
-# Git 操作
+# Git operations
 # ============================================================
 
 function Test-GitRepo {
@@ -115,12 +257,6 @@ function Test-GitRepo {
     }
 }
 
-function Test-UncommittedChanges {
-    param([string]$Path)
-    $status = git -C $Path status --porcelain 2>$null
-    return [bool]$status
-}
-
 function Get-ChangeSummary {
     param(
         [string]$Path,
@@ -140,70 +276,155 @@ function Get-ChangeSummary {
 }
 
 # ============================================================
-# 主逻辑
+# Reminder message build
+# ============================================================
+
+function Build-Reminder {
+    param([string]$Workspace)
+
+    $Changes = Get-ChangeSummary -Path $Workspace
+    $ChangesIndented = ($Changes -split "`n" | ForEach-Object { "  $_" }) -join "`n"
+
+    # Project-local script; fallback to global
+    $checkpointSh = "~/.vibe-x/agent-better-checkpoint/scripts/checkpoint.sh"
+    $checkpointPs1 = "`$env:USERPROFILE/.vibe-x/agent-better-checkpoint/scripts/checkpoint.ps1"
+    if (Test-Path (Join-Path $Workspace ".vibe-x/agent-better-checkpoint/checkpoint.sh")) {
+        $checkpointSh = ".vibe-x/agent-better-checkpoint/checkpoint.sh"
+    }
+    if (Test-Path (Join-Path $Workspace ".vibe-x/agent-better-checkpoint/checkpoint.ps1")) {
+        $checkpointPs1 = ".\.vibe-x\agent-better-checkpoint\checkpoint.ps1"
+    }
+
+    return @"
+## ⚠️ Uncommitted Changes Detected
+
+There are uncommitted changes in the workspace. Please create a checkpoint commit before ending the conversation.
+
+**Changed files:**
+``````
+$ChangesIndented
+``````
+
+**Action Required**: Run the checkpoint script to commit these changes:
+
+**macOS/Linux:**
+``````bash
+$checkpointSh "checkpoint(<scope>): <description>" "<user-prompt>" --type fallback
+``````
+
+**Windows (PowerShell):**
+``````powershell
+powershell -File "$checkpointPs1" "checkpoint(<scope>): <description>" "<user-prompt>" -Type fallback
+``````
+"@
+}
+
+# ============================================================
+# Main logic
 # ============================================================
 
-# 从 stdin 读取 JSON
 $InputData = $null
+$rawInput = ""
 try {
     $rawInput = [Console]::In.ReadToEnd()
     if ($rawInput.Trim()) {
         $InputData = $rawInput | ConvertFrom-Json
     }
 }
-catch {
-    # 忽略 JSON 解析错误
-}
+catch {}
 
-# Claude Code 的 stop_hook_active 防止无限循环
 if ($InputData -and $InputData.PSObject.Properties["stop_hook_active"]) {
     if ($InputData.stop_hook_active -eq $true) {
         Output-Allow
     }
 }
 
-# 检测平台
 $Platform = Detect-Platform -InputData $InputData
-
-# 获取 workspace root
 $Workspace = Get-WorkspaceRoot -InputData $InputData
 
-# 检查是否为 git 仓库
+# Delegate to project-local script when present (committed with project)
+$ProjectScript = Join-Path $Workspace ".vibe-x/agent-better-checkpoint/check_uncommitted.ps1"
+if (Test-Path $ProjectScript -PathType Leaf) {
+    $rawInput | & $ProjectScript
+    exit $LASTEXITCODE
+}
+
 if (-not (Test-GitRepo -Path $Workspace)) {
     Output-Allow
 }
 
-# 检查是否有未提交变更
-if (-not (Test-UncommittedChanges -Path $Workspace)) {
+# Get all changes
+$StatusOutput = git -C $Workspace status --porcelain 2>$null
+if (-not $StatusOutput) {
     Output-Allow
 }
 
-# 获取变更摘要
-$Changes = Get-ChangeSummary -Path $Workspace
-$ChangesIndented = ($Changes -split "`n" | ForEach-Object { "  $_" }) -join "`n"
+# Load config
+$ConfigFile = Join-Path $Workspace $CONFIG_FILE_NAME
+$Config = Parse-CheckpointConfig -ConfigPath $ConfigFile
 
-# 构建提醒消息
-$Reminder = @"
-## ⚠️ Uncommitted Changes Detected
+# ---- 分离主动/被动文件 ----
+$ActiveFiles = @()
+$PassiveFilesList = @()
 
-There are uncommitted changes in the workspace. Please create a checkpoint commit before ending the conversation.
+foreach ($line in ($StatusOutput -split "`n")) {
+    if ($line.Length -lt 4) { continue }
+    $file = $line.Substring(3)
+    # Handle rename
+    if ($file -match ' -> (.+)$') {
+        $file = $Matches[1]
+    }
+    $file = $file.Trim('"')
 
-**Changed files:**
-``````
-$ChangesIndented
-``````
+    if ($Config.PassivePatterns.Count -gt 0 -and (Test-PassiveFile -FilePath $file -Patterns $Config.PassivePatterns)) {
+        $PassiveFilesList += $file
+    }
+    else {
+        $ActiveFiles += $file
+    }
+}
 
-**Action Required**: Run the checkpoint script to commit these changes:
+# ---- 无主动文件 → 仅被动变更，跳过 ----
+if ($ActiveFiles.Count -eq 0) {
+    Output-Allow -Info "Skipped: only passive file changes ($($PassiveFilesList.Count) files). Patterns: $($Config.PassivePatterns -join ', ')"
+}
 
-**macOS/Linux:**
-``````bash
-~/.agent-better-checkpoint/scripts/checkpoint.sh "checkpoint(<scope>): <description>" "<user-prompt>" --type fallback
-``````
+# ---- 无阈值配置 → 有主动变更就触发 ----
+if ($null -eq $Config.MinChangedLines -and $null -eq $Config.MinChangedFiles) {
+    $Reminder = Build-Reminder -Workspace $Workspace
+    Output-Block -Message $Reminder -Platform $Platform
+}
 
-**Windows (PowerShell):**
-``````powershell
-powershell -File "`$env:USERPROFILE/.agent-better-checkpoint/scripts/checkpoint.ps1" "checkpoint(<scope>): <description>" "<user-prompt>" -Type fallback
-``````
-"@
+# ---- 检查触发条件（OR 关系） ----
+$Triggered = $false
+$ActiveFileCount = $ActiveFiles.Count
+$ActiveLineCount = 0
+
+# Check file count first (cheaper)
+if ($null -ne $Config.MinChangedFiles -and $ActiveFileCount -ge $Config.MinChangedFiles) {
+    $Triggered = $true
+}
+
+# Then check line count
+if (-not $Triggered -and $null -ne $Config.MinChangedLines) {
+    $ActiveLineCount = Get-ChangedLineCount -Workspace $Workspace -Files $ActiveFiles
+    if ($ActiveLineCount -ge $Config.MinChangedLines) {
+        $Triggered = $true
+    }
+}
+
+if (-not $Triggered) {
+    if ($ActiveLineCount -eq 0 -and $null -ne $Config.MinChangedLines) {
+        # Already computed
+    }
+    elseif ($ActiveLineCount -eq 0) {
+        $ActiveLineCount = Get-ChangedLineCount -Workspace $Workspace -Files $ActiveFiles
+    }
+    $minFilesStr = if ($null -ne $Config.MinChangedFiles) { $Config.MinChangedFiles } else { "unset" }
+    $minLinesStr = if ($null -ne $Config.MinChangedLines) { $Config.MinChangedLines } else { "unset" }
+    Output-Allow -Info "Skipped: changes below threshold ($ActiveFileCount files, $ActiveLineCount lines). Config: min_changed_files=$minFilesStr, min_changed_lines=$minLinesStr"
+}
 
+# ---- 达到阈值，触发提交提醒 ----
+$Reminder = Build-Reminder -Workspace $Workspace
 Output-Block -Message $Reminder -Platform $Platform

package/platform/win/checkpoint.ps1

@@ -1,12 +1,12 @@
 <#
 .SYNOPSIS
-    checkpoint.ps1 — 创建语义化的 Git checkpoint commit (Windows PowerShell)
+    checkpoint.ps1 — Create semantic Git checkpoint commits (Windows PowerShell)
 
 .DESCRIPTION
-    AI 生成描述性内容（subject + body），本脚本负责：
-    1. 截断 user-prompt（≤60字符，头尾截断）
-    2. 通过 git interpret-trailers 追加元信息
-    3. 执行 git add -A && git commit
+    AI provides descriptive content (subject + body). This script:
+    1. Truncates user-prompt (≤60 chars, head+tail)
+    2. Appends metadata via git interpret-trailers
+    3. Runs git add -A && git commit
 
 .PARAMETER Message
     Full commit message (subject + blank line + body). Required.
@@ -34,7 +34,7 @@ param(
 $ErrorActionPreference = "Stop"
 
 # ============================================================
-# 平台检测
+# Platform detection
 # ============================================================
 
 function Detect-Platform {
@@ -50,7 +50,7 @@ function Detect-Platform {
 $AgentPlatform = Detect-Platform
 
 # ============================================================
-# User-Prompt 截断（≤60 字符，头尾保留 + 中间省略号）
+# User-Prompt truncation (≤60 chars, head+tail + ellipsis)
 # ============================================================
 
 function Truncate-Prompt {
@@ -74,19 +74,19 @@ if ($UserPrompt) {
 }
 
 # ============================================================
-# 检查是否有变更
+# Check for changes
 # ============================================================
 
 function Test-HasChanges {
-    # staged 变更
+    # Staged changes
     $diffCached = git diff --cached --quiet 2>$null
     if ($LASTEXITCODE -ne 0) { return $true }
 
-    # unstaged 变更
+    # Unstaged changes
     $diffWorking = git diff --quiet 2>$null
     if ($LASTEXITCODE -ne 0) { return $true }
 
-    # untracked 文件
+    # Untracked files
     $untracked = git ls-files --others --exclude-standard 2>$null
     if ($untracked) { return $true }
 
@@ -105,7 +105,7 @@ if (-not (Test-HasChanges)) {
 git add -A
 
 # ============================================================
-# 构建 trailer 并提交
+# Build trailers and commit
 # ============================================================
 
 $TrailerArgs = @(
@@ -117,7 +117,7 @@ if ($TruncatedPrompt) {
     $TrailerArgs += @("--trailer", "User-Prompt: $TruncatedPrompt")
 }
 
-# 通过管道传递消息 → git interpret-trailers → git commit
+# Pipe message → git interpret-trailers → git commit
 $Message | git interpret-trailers @TrailerArgs | git commit -F -
 
 Write-Host "Checkpoint committed successfully."

package/skill/SKILL.md

@@ -3,7 +3,7 @@ name: agent-better-checkpoint
 description: "Automatically creates semantic Git checkpoint commits during AI coding sessions. Replaces opaque platform checkpoints with transparent, queryable Git commits using Conventional Commits format with Git Trailers. You MUST follow this skill whenever you make code changes — commit after each meaningful edit."
 license: MIT
 metadata:
-  version: "0.1.1"
+  version: "0.2.0"
   author: "alienzhou"
   category: "version-control"
 ---
@@ -18,18 +18,18 @@ You are an AI coding assistant with **checkpoint awareness**. Every meaningful e
 
 ## 🔧 Installation Check
 
-Before your first commit, verify the checkpoint scripts are installed:
+Before your first commit, verify the checkpoint scripts are available:
 
-**macOS/Linux:** Check if `~/.agent-better-checkpoint/scripts/checkpoint.sh` exists.
-**Windows:** Check if `$env:USERPROFILE/.agent-better-checkpoint/scripts/checkpoint.ps1` exists.
+**Project-local (preferred, committed with project):** Check if `.vibe-x/agent-better-checkpoint/checkpoint.sh` exists in the workspace.
+**Global fallback:** Check if `~/.vibe-x/agent-better-checkpoint/scripts/checkpoint.sh` exists (macOS/Linux) or `$env:USERPROFILE/.vibe-x/agent-better-checkpoint/scripts/checkpoint.ps1` (Windows).
 
-If the scripts are **not** installed, run:
+If neither exists, run:
 
 ```bash
-npx @vibe-x/agent-better-checkpoint@0.1.1
+npx @vibe-x/agent-better-checkpoint@0.2.0
 ```
 
-This will install the checkpoint scripts and stop hook for your platform.
+This installs the global scripts and stop hook. Projects can also commit `.vibe-x/agent-better-checkpoint/` (config + scripts) for self-contained setup.
 
 ---
 
@@ -94,18 +94,28 @@ Switch to flex-column layout with collapsible sidebar.
 
 ## 🛠️ How to Commit
 
-Call the checkpoint script after composing your message. Determine the OS and use the appropriate command:
+Call the checkpoint script after composing your message. Determine the OS and use the appropriate command.
+
+**Prefer project-local when present** (`.vibe-x/agent-better-checkpoint/` committed with project):
 
 **macOS/Linux:**
 
 ```bash
-~/.agent-better-checkpoint/scripts/checkpoint.sh "<commit-message>" "<user-prompt>"
+# Project-local (if .vibe-x/agent-better-checkpoint/ exists)
+.vibe-x/agent-better-checkpoint/checkpoint.sh "<commit-message>" "<user-prompt>"
+
+# Or global fallback
+~/.vibe-x/agent-better-checkpoint/scripts/checkpoint.sh "<commit-message>" "<user-prompt>"
 ```
 
 **Windows (PowerShell):**
 
 ```powershell
-powershell -File "$env:USERPROFILE/.agent-better-checkpoint/scripts/checkpoint.ps1" "<commit-message>" "<user-prompt>"
+# Project-local (if .vibe-x/agent-better-checkpoint/ exists)
+powershell -File ".\.vibe-x\agent-better-checkpoint\checkpoint.ps1" "<commit-message>" "<user-prompt>"
+
+# Or global fallback
+powershell -File "$env:USERPROFILE/.vibe-x/agent-better-checkpoint/scripts/checkpoint.ps1" "<commit-message>" "<user-prompt>"
 ```
 
 ### Parameters:
@@ -119,7 +129,7 @@ powershell -File "$env:USERPROFILE/.agent-better-checkpoint/scripts/checkpoint.p
 ### Example (macOS/Linux):
 
 ```bash
-~/.agent-better-checkpoint/scripts/checkpoint.sh \
+~/.vibe-x/agent-better-checkpoint/scripts/checkpoint.sh \
   "checkpoint(auth): add JWT token refresh logic
 
 Implement automatic token refresh when access token expires.
@@ -130,7 +140,7 @@ Uses refresh token rotation for security." \
 ### Example (Windows):
 
 ```powershell
-powershell -File "$env:USERPROFILE/.agent-better-checkpoint/scripts/checkpoint.ps1" `
+powershell -File "$env:USERPROFILE/.vibe-x/agent-better-checkpoint/scripts/checkpoint.ps1" `
   "checkpoint(auth): add JWT token refresh logic`n`nImplement automatic token refresh when access token expires.`nUses refresh token rotation for security." `
   "帮我实现 token 刷新机制"
 ```
@@ -167,4 +177,4 @@ This should feel natural — commit as you go, like any good developer.
 
 ---
 
-**Version**: 0.1.1
+**Version**: 0.2.0