"""bridge 版本号与能力清单。

所有版本演进记录与能力声明集中在此模块，供 app.py / routes/status.py 引用。
"""

# bridge 版本号
#
# bridge 是 WechatOnCloud 的 WeChat 4.x 自动化与数据访问桥接模块：
#   - 通过 xdotool UI 自动化驱动 Linux WeChat 4.x（发送文本/文件、朋友圈、
#     消息撤回/转发、备注修改、加好友等）
#   - 通过 SQLCipher 4 透明解密 WeChat 本地 DB，提供消息/联系人/朋友圈查询
#   - 通过 SSE 实时推送新消息，替代客户端轮询
#   - 模块化结构：models（数据模型）、db（DB 解密与读取）、ui（xdotool 驱动）、
#     messaging（发送队列与 SSE 推送）、routes（API 路由）
#
# 能力分两类：
#   - 稳定能力：text_send / db_decrypt / sse_push / moment_publish /
#     moment_share_article / message_search / message_by_session / moment_timeline
#   - experimental 能力（UI 自动化，坐标需实测调优）：message_revoke /
#     message_forward / contact_remark / friend_add / moment_like /
#     moment_comment / moment_delete / moment_publish_image
BRIDGE_VERSION = "1.0.1"

# bridge 能力清单（供客户端通过 /api/status 协商）。
# 当前已落地能力：text_send（文本发送真实可用）、db_decrypt（SQLCipher DB 解密）、
#   sse_push（SSE 实时消息推送）、moment_publish（纯文字朋友圈发表）、
#   moment_share_article（分享公众号文章到朋友圈）、
#   message_search（消息关键词搜索）、message_by_session（按会话拉取历史）、
#   moment_timeline（朋友圈时间线读取，依赖 DB schema 探测）。
# experimental 能力（UI 自动化，坐标需实测调优）：
#   - message_revoke：消息撤回（2 分钟时限）
#   - message_forward：消息转发
#   - contact_remark：修改好友备注
#   - friend_add：添加好友
#   - moment_like / moment_comment / moment_delete：朋友圈互动
#   - moment_publish_image：发表图片朋友圈
# 已落地能力（W-02 完成）：
#   - image_send：真实图片发送（系统文件选择器路径输入 + DB 校验）
#   - file_send：真实文件发送（系统文件选择器路径输入 + DB 校验）
# 待落地能力（占位声明，未真正实现）：
#   - long_poll：W-03 完成后追加（已被 sse_push 替代，保留兼容声明）
#   - avatar：W-04 完成后追加
#   - group_admin：W-06 完成后追加
BRIDGE_CAPABILITIES = [
    "text_send", "db_decrypt", "sse_push",
    "moment_publish", "moment_share_article",
    "message_search", "message_by_session", "moment_timeline",
    # experimental（UI 自动化，需实测调优）
    "message_revoke", "message_forward",
    "contact_remark", "friend_add",
    "moment_like", "moment_comment", "moment_delete", "moment_publish_image",
    # 媒体发送（W-02 已落地：真实文件/图片传输 + DB 校验）
    "image_send", "file_send",
    # 批量发送与消息导出（占位声明，待后续落地）
    "batch_send", "messages_export",
]

# 媒体发送是否已实现真实传输（W-02 已完成，改为 True）。
# 客户端据此决定是否调 /api/send/image 与 /api/send/file。
#
# **联动点**：W-02 完成时已同步修改三处：
#   1. 本常量 MEDIA_SUPPORTED = True
#   2. BRIDGE_CAPABILITIES 追加 "image_send" / "file_send"
#   3. _send_file 路由的 placeholder=True 改为 False（flow 路径）
MEDIA_SUPPORTED = True