task(T-304): add metadata and stop-latch contract

docs/tasks/T-304.md

@@ -15,12 +15,15 @@ write_paths:
   - client/src/cmbuyer_client/app.py
   - client/src/cmbuyer_client/polling/**
   - client/src/cmbuyer_client/ui/**
+  - client/src/cmbuyer_client/localstate/models.py
+  - client/src/cmbuyer_client/localstate/store.py
   - client/tests/test_app.py
   - client/tests/polling/**
   - client/tests/ui/**
+  - client/tests/localstate/test_store.py
 ---
 
-<!-- BEGIN VIKUNJA EXPORT id=37 synced=2026-08-04T15:18:59Z sha256=70cde8bfacd40b2c2a7132dc0f0390689682403c7934587efb25348b40796826 -->
+<!-- BEGIN VIKUNJA EXPORT id=37 synced=2026-08-04T17:17:29Z sha256=35713b7859798914f9d08bc7149d6ebafa02cfea6fc143d776a5d22aa8152cd1 -->
 ## 问题 / 背景
 
 T-006 已确认采购工具双 Tab 原型，T-303 将提供唯一的 HTTP、本地恢复、DPAPI 与单实例底座。T-304 把原型转换为可测试的原生 PySide6 主界面和定时轮询协调器，但在真实单趟执行器接入前不得领取真实任务，避免形成无人消费的 active claim。
@@ -57,6 +60,12 @@ T-006 已确认采购工具双 Tab 原型，T-303 将提供唯一的 HTTP、本
 - 应用独立启动、切换 Tab、Esc、查看记录与关闭窗口均产生零 claim、零 release、零 ADB；代码不导入 PDD 点击、数量、确认页、围栏、提交或付款能力。
 - client 全量 unittest、compileall、wheel metadata、根目录完整 init、Vikunja 导出、上下文校验与 diff-check 通过。
 
+### T-303 metadata-only 配置摘要与 Stop epoch 补充
+
+1. 允许精确扩展 localstate/models.py、store.py 与对应 test_store.py，只增加 metadata-only profile summary/settings 读取；不得调用 DPAPI 或返回 token/密文。
+2. Stop 必须提升 epoch/latch，使旧 timer dispatch 失效；飞行中结果先 durable commit，再按 CLAIMED/EMPTY/错误进入安全停止或恢复态。
+3. 存在 pending/active 时冻结全部非 token 配置，只允许同 device id 替换 token；关闭窗口不得 terminate 正在 I/O 的 QThread，须等待有界返回与落库。
+
 ## 执行记录
 
 ### 2026-08-04T13:35:53Z · ila
@@ -91,3 +100,10 @@ T-006 已确认采购工具双 Tab 原型，T-303 将提供唯一的 HTTP、本
   不停止轮询、不关闭窗口、不释放 claim、不改变服务端状态；返回后按稳定记录 ID 恢复选择、滚动和焦点。
 - 不导入或实现 PDD 页面判据、规格选择、数量、确认页、证据上传、事件、失败上报、提交围栏或结果接口；
   不编写或引用点击“提交订单”的代码，不编写支付、免密支付、先用后付或任何扣款控件代码。
+- T-303 的 `load_profile()` 会解密设备 token，配置页不得为了读取普通设置或“已保存”布尔状态调用它。
+  本任务只可在既有 localstate store 增加 metadata-only 的 profile summary/settings 只读 API：沿用同一
+  SQLite 表与事务，不调用 DPAPI、不返回密文或明文 token、不新增存储、mutex 或第二套状态源。
+- Stop 必须提升会话 epoch/latch，先取消 timer 并使已经排队的旧 epoch dispatch 失效。飞行中领取仍等待
+  HTTP 自身有界结果并由 T-303 完成 durable commit：成功领取转 `RECOVERY_REQUIRED`，EMPTY 转
+  `STOPPED`，结果不明、401、409、协议或本地错误保留原槽并停止；只有下一次显式 Start 才可同 key 恢复。
+  关闭窗口同样不得 terminate 正在 I/O 的 QThread，必须等待其有界返回与落库后再结束 worker。