feat(agents): add first-use software recommendations

[python-rust]

Scope and rationale / 范围与原因

• 为确认属于全新安装的用户增加可跳过的两步软件推荐引导：询问办公、编程或混合用途，并从原生目录中投影精简推荐。
• 保持有效软件 deep link、目录扫描、配置入口与错误状态的既有边界；引导不执行安装、登录、模型修改或遥测。
• 补齐 Grok Build 的编程推荐，并保持目录名称与顺序来自原生 catalog。
• 按 Trellis 重新评审今天的跨层行为，修复普通 save_settings 可借旧兼容字段绕过专用完成命令的问题；两个首次引导字段现均由原生 owner 独占写入。
• 将推荐理由收紧为封闭 AgentCatalogId 的穷尽映射，并更新前后端 owner SPEC、错误矩阵、回归要求与证据边界。

明确不在范围内：自动安装/登录/模型选择、用途上传、数据库 schema、发行签名和物理全新安装验收。

Related work / 关联工作

Issue / planning context (if applicable):

• .trellis/tasks/archive/2026-09/09-15-first-use-software-guide
• .trellis/tasks/archive/2026-09/09-15-grok-guide-recommendation
• .trellis/tasks/archive/2026-09/09-15-review-todays-specs-and-merge

Evidence / 验证证据

• Local gate / 本地门禁: TRELLIS_CONTEXT_ID=fyagent-review-todays-specs mise run check:prearchive --exclude-active-task .trellis/tasks/09-15-review-todays-specs-and-merge — 退出码 0；188 个 Vitest 文件中 1680 项通过、1 项跳过；Rust 核心 3246 项通过、5 项按声明忽略，后续集成/辅助组件无失败。
• Focused checks / 聚焦检查: Renderer/端口 2 文件 47 项通过；Rust 普通设置双向防覆盖 1 项与首次状态模块 5 项通过。
• Browser/production / 浏览器与生产构建: mise run test:browser — route chunk 校验、生产启动 3 项、Chromium/WebKit 616 项全部通过；首次引导保持独立 lazy chunk。
• Trellis contracts / Trellis 合同: 归档前、归档后 mise run check:contracts 均通过，任务已归档且工作树干净。
• Native or remote evidence / 原生或远程证据: 本地 macOS arm64 自动化完成；GitHub PR 与 Merge Queue CI 由本 PR 提供远程证据。
• Not verified / 未验证: macOS/Windows 物理全新安装、安装器/签名、原生凭据存储 HIL；浏览器夹具不冒充这些证据。

Risk and rollback / 风险与回退

• 用户可见变化仅限确认的新安装第一次进入软件目录时的推荐引导；已有安装、显式 target 和读取失败继续进入原有页面。
• 持久化格式保持兼容：pending | dismissed 与旧确认字段仍可读取；普通整份设置保存不再拥有这两个字段的写权限。
• 风险集中在首次资格判定、完成持久化和目录推荐投影，均有 Rust、Renderer、生产构建与跨浏览器回归。
• 最小回退为回滚本 PR 的 feature/fix 提交；没有数据库迁移或不可逆用户数据转换。

Contract and provenance impact / 契约与来源影响

• Durable behavior changes update executable tests and maintained docs / 长期行为已更新可执行测试与维护中的 Trellis SPEC
• Upstream provenance is not applicable / 不涉及上游同步或来源变更
• CI/Release policy changes are not applicable / 不修改 CI 或 Release 政策

Screenshots / 截图

不适用：本次以既有设计实现首次引导并完成生产浏览器矩阵；没有需要人工对照的视觉基线变更。

Checklist / 检查清单

• 完整本地准入由 check:prearchive 通过，并在归档后复验 contracts
• 测试覆盖成功、读取失败、保存失败、防重入、跳过、恢复、隐藏路由和 stale settings 双向覆盖
• 用户可见文案沿用当前软件目录的产品语言与无障碍状态；未引入未维护的 locale 资源
• 未包含 secret、证书、个人配置、.venv 或用户数据
• 结论明确区分本地检查、浏览器夹具、GitHub CI 与未执行的物理 HIL