daily-deep-brief

Daily Deep Brief (08:00 HKT, weekday)

8 点这个时点：HK 开盘前 ~90 分钟，US 已收盘 ~4 小时。盘前是 deep think 最好的窗口 — 有完整夜间消息面，没有盘中执行压力。

Harness 架构（不可越权）

┌──────────────────────┐   ┌────────────────┐   ┌──────────────────────────┐
│ clawock brief preflight │──►│ LLM (你 / Rick) │──►│ clawock brief postflight  │
│   (确定性 + 幂等)      │   │ (只写判断/反方) │   │ 校验 → 渲染 → 投递        │
└──────────────────────┘   └────────────────┘   └──────────────────────────┘
   指标/因子/风险/evidence     查 packet summary     校验 plan+judgment，
   编译 typed packet           写 plan + judgment    brief_render 出 md+微信卡，
                               (纯文本，不写版式)    Pages 只读稳定 projection

为什么这样分：之前完全交给 LLM，模型可能漏快照、漏 HHI、漏 FX、漏 retrospective。 确定性步骤交给脚本（一定执行，无遗漏）；LLM 只做"分析综合"这个不能脚本化的部分。

🔒 Exec 铁律：退出码就是整回合的判据

每一条 exec 的退出码会被当成整个回合的成败。 一条中途的非零退出会让 cron 把 已经做完并已投递的一轮判成 error（真实案例：2026-08-18，简报全部产出、 wechat_sent: true、commit+push 都成了，运行时 trace.artifacts.finalStatus 也是 success，但 08:14 那条 exec 非零退出，整轮仍被记成红）。

2>/dev/null 只吞 stderr，不改退出码。 这是最容易踩的一条：

# ❌ 踩过的原文（2026-08-18）：末尾那个文件当天不存在 → head exit 1 → 整回合判红
ls -la memory/2026-08-17* 2>/dev/null; echo "---"; \
  head -c 2500 memory/2026-08-17-pre-open.md 2>/dev/null; echo "==="; \
  head -c 1500 memory/2026-08-17.md 2>/dev/null

# ✅ 读"可能不存在"的文件时，自己兜底退出码
ls -la memory/2026-08-17* 2>/dev/null || true; echo "---"; \
  head -c 2500 memory/2026-08-17-pre-open.md 2>/dev/null || true; echo "==="; \
  head -c 1500 memory/2026-08-17.md 2>/dev/null || true

三条硬规则：

1. 凡是读可选文件/通配符（日报、昨日 notes、.tmp/ 产物）都要 || true。 日期型文件天生可能缺（当天没写 notes、休市、上游没产出），缺失不是错误。
2. ; 串起来的复合命令，最后一条决定退出码 —— 前面成不成功都不算。 拿不准就在整条命令末尾补 ; true。
3. grep/test/head/ls 用作"看一眼"而不是"判定"时，一律兜底。 grep -q 找不到东西返回 1 是正常语义，不该让一轮简报变红。

配套的窄规则见 Step 5 的「送达确认铁律」（#558）：那条禁的是 postflight 之后 再去读 marker 确认送达；本节是它的一般形式 —— 别让"看一眼"的退出码决定一轮的成败。

6-step 流程（严格按顺序）

Step 1: 跑 preflight（一行命令搞定所有确定性活）

clawock brief preflight

这一步内部做了：

1. clawock analyze-us — US 价格刷新（7-route fallback + RSI/MA）
2. clawock analyze-hk — HK 价格刷新（Tencent 主源 + Eastmoney 全量独立对账/兜底 → stooq → yfinance + 恒指 + 信号）
3. clawock fx --json — USDHKD 实时汇率（Frankfurter → exchangerate.host → Yahoo）
4. cp portfolio.json memory/snapshots/{date}.json — 每日快照（longitudinal 基础设施）
   • 为什么：portfolio.json 是滚动覆盖的 ground truth，每次刷价就丢前一刻状态。 有 snapshot 历史才能做 Rolling P&L 曲线 / Alpha vs benchmark / Drawdown 分析 / Position 变化追溯。
   • ⚠️ 不可补做 — 每过一天少一份永远拿不回来的数据。
5. HHI / Top2 集中度算法（HK + US leg 分开）
6. SEC EDGAR fundamentals — 从当天 portfolio.json 动态筛选 shares > 0 的 US 持仓；跳过 is_leveraged_etf=true 或被名称启发式识别为杠杆 ETF 的标的，其余单股逐一跑 clawock filings
   • 杠杆 ETF 检测启发式（name 关键词）：'倍', 'Direxion', 'T-Rex', 'Defiance', 'ProShares', '2X Long', '3X Long', 'Daily Target'
   • 不在文档硬编码 ticker；实际名单以当天持仓和上述动态过滤结果为准
7. Retrospective：读 prior v2 plan，对每个 decision 按 strategy 检查 condition 是否触发、模拟 benefit 与 confidence calibration