Archive OpenSpec change: upgrade-snell-v5

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

openspec/changes/archive/2026-04-29-upgrade-snell-v5/.openspec.yaml

@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-04-29

openspec/changes/archive/2026-04-29-upgrade-snell-v5/design.md

@@ -0,0 +1,18 @@
+## Context
+
+当前 Snell 默认版本为 v4.1.1。v5.0.1 已发布，需将默认值更新。
+
+## Goals / Non-Goals
+
+**Goals:**
+- 将默认版本号更新为 v5.0.1
+
+**Non-Goals:**
+- 不修改配置模板格式
+- 不修改下载 URL 结构（假设与 v4.x 一致）
+- 不引入新功能
+
+## Risks / Trade-offs
+
+- **[Risk]** v5.0.1 的配置格式可能与 v4.x 不兼容
+  - **Mitigation:** 部署前在测试环境验证，确认配置模板无需修改

openspec/changes/archive/2026-04-29-upgrade-snell-v5/proposal.md

@@ -0,0 +1,26 @@
+## Why
+
+Snell v5.0.1 已发布，包含协议改进和稳定性修复。当前项目默认使用 v4.1.1，需要升级以获取最新版本的安全性和性能改进。
+
+## What Changes
+
+- 更新 `roles/snell/defaults/main.yml` 中 `snell_version` 的默认值从 `v4.1.1` 到 `v5.0.1`
+- 验证 v5.0.1 的 GitHub Release 下载 URL 格式与 v4.x 一致
+- 验证 Snell v5.0.1 的配置文件格式与现有模板兼容
+- 测试 playbook 在已有 Snell 安装的服务器上执行升级流程
+
+## Capabilities
+
+### New Capabilities
+
+- 无新增能力
+
+### Modified Capabilities
+
+- 无 spec 级别行为变化（版本号已在 spec 中定义为可配置变量，本次仅为默认值更新）
+
+## Impact
+
+- `roles/snell/defaults/main.yml` 中的默认版本号变更
+- 现有已部署的服务器在 playbook 重新运行后会自动升级到 v5.0.1
+- 升级过程中 Snell 服务会短暂中断（由 handler 触发重启）

openspec/changes/archive/2026-04-29-upgrade-snell-v5/specs/README.md

@@ -0,0 +1,3 @@
+# Specs
+
+本次变更无 spec 级别行为变化。Snell 版本升级仅涉及默认变量值的更新（`v4.1.1` → `v5.0.1`），现有 `snell-service` spec 中已将版本定义为可配置变量，无需修改。

openspec/changes/archive/2026-04-29-upgrade-snell-v5/tasks.md

@@ -0,0 +1,13 @@
+## 1. Version Update
+
+- [x] 1.1 Update `snell_version` default in `roles/snell/defaults/main.yml` from `v4.1.1` to `v5.0.1`
+
+## 2. Validation
+
+- [x] 2.1 Verify Snell v5.0.1 release exists at the configured download URL
+- [x] 2.2 Confirm the configuration template format is compatible with v5.0.1
+- [x] 2.3 Run `ansible-playbook --syntax-check` to validate playbook integrity
+
+## 3. Documentation
+
+- [x] 3.1 Update README.md Snell version reference if present