feat: add generic queue and subscription retirement

docs/api/subscriptions.md

@@ -14,10 +14,11 @@
 | GET /v1/subscriptions?queue_id=... | events:read | ListSubscriptions |
 | GET /v1/subscriptions/{id} | events:read | GetSubscription |
 | POST /v1/subscriptions/{id}:configure | events:manage | ConfigureSubscription |
+| POST /v1/subscriptions/{id}:retire | events:manage | RetireSubscription |
 | GET /v1/subscriptions/{id}/deliveries | events:read | ListEventDeliveries |
 | GET /v1/subscriptions/{id}/deliveries/{delivery_id} | events:read | GetEventDelivery |
 | POST /v1/subscriptions/{id}/deliveries/{delivery_id}:retry | events:manage | RetryEventDelivery |
-| GET /v1/events/connect（WebSocket Upgrade） | events:consume | 连接 SDK 待交付，可按下文协议接入 |
+| GET /v1/events/connect（WebSocket Upgrade） | events:consume | ConnectEvents / NewEventConsumer |
 
 HTTP 使用统一 request_id + data/error 信封，响应带 X-Request-ID 和 Cache-Control: no-store。管理请求 8 秒服务端超时、JSON 最大 512 KiB。未知字段、大小写别名、重复 JSON 键、未知或重复查询参数均被拒绝。计数/版本以规范十进制字符串传输，不能带正号、前导零或小数。
 
@@ -76,7 +77,7 @@ POST /v1/subscriptions，Content-Type: application/json，Idempotency-Key: 调
 
 类型集合按固定顺序规范化。cursor_sequence 表示已经扫描并建立交付记录的位置，**不是确认水位**。pending_count 包含等待、租约中和次数耗尽记录。配置 revision 不随物化/ACK 用量变化。
 
-每命名空间最多 64 个订阅。from_sequence 不能超过已提交流头，也不能早于已清理的保留边界。现存日志从迁移 000013 启用，不补造此前的任务结果。
+每命名空间最多 64 个未退役订阅；暂停仍占名额，成功退役后释放名额。from_sequence 不能超过已提交流头，也不能早于已清理的保留边界。现存日志从迁移 000013 启用，不补造此前的任务结果。
 
 ## 3. 查询和控制订阅
 
@@ -291,7 +292,7 @@ snapshot 还可包含业务 result 和 current_attempt_id；result 用原始 JSO
 | NOT_FOUND | 404；订阅/交付不在凭据与父资源范围；连接内发生时关闭 |
 | STATE_CONFLICT | 409；版本、状态或累计预算不允许操作 |
 | IDEMPOTENCY_CONFLICT | 409；同键内容不同 |
-| SUBSCRIPTION_LIMIT | 409；命名空间订阅数达到 64 |
+| SUBSCRIPTION_LIMIT | 409；命名空间未退役订阅数达到 64 |
 | EVENT_HISTORY_EXPIRED | 410；WSS 领取发现历史缺口则报错并关闭，不静默跳到最新位置 |
 | DELIVERY_LEASE_LOST | WSS ACK 证明已替换或无效；连接保留，等待新交付或核对历史 |
 | PROTOCOL_REQUIRED | 升级前 426，必须指定 orbit.events.v1 |
@@ -325,3 +326,7 @@ return err
 [完整管理示例](../../examples/subscriptions/main.go) 的启动、输入输出、失败和保留规则见 [场景文档](../examples/subscriptions.md)。它演示管理与幂等，不启动结果消费者。正式 [事件连接 SDK 与自动消费器](../sdk/event-consumer.md) 已提供接收、ACK、心跳、重连与有界收尾；[完整协议示例](../examples/event-protocol.md) 验证跨连接重报原确认。[独立 MySQL Inbox 示例](../examples/result-inbox.md) 已实现并验证消费者进程退出后的去重。
 
 机器可读消息契约见 [events.schema.json](../../protocol/eventsv1/events.schema.json)，使用 Draft 2020-12，clientFrame/serverFrame 分方向约束。运行时额外拒绝重复 JSON 键、超范围 uint64 及非规范 base64url。Schema 不代替授权、状态机、租约及事务校验。
+
+## 退役与资源名额
+
+见[通用资源退役](resource-retirement.md)。退役保留订阅和交付历史，不支持重新启用；通过 `retired_at`、`retired_sequence` 区分暂停与退役。未确认、过期或尚未物化的匹配结果都会阻止退役。