Skip to content

fix(automation): 过期行情与过期持仓范围不再判成无实质变化 - #419

Open
wannT-1 wants to merge 2 commits into
helsome:mainfrom
wannT-1:cursor/automation-freshness-185-2682
Open

wannT-1 wants to merge 2 commits into
helsome:mainfrom
wannT-1:cursor/automation-freshness-185-2682

Conversation

@wannT-1

@wannT-1 wannT-1 commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

改动说明

Issue #185 第 3 点(新鲜度)。维护者已在 2026-10-26 确认按方案 1 做 fail-closed:关键行情或持仓范围证据过期时,整轮为 incomplete,不能得出「无实质变化」。第 1–2 点(NaN、探针失败)和通知失败不再降级整轮的修复已在 #188 / #194 合入,本 PR 不改那些路径。

行情。 fetchQuote 不再丢掉 ProviderResult / capability 的 provenance。只认 Provider/Router 已经算好的 provenance.stale === true(实时源全部失败后的 stale-cache 降级),记为评估失败 {symbol}: quote stale,整轮 incomplete。Runner 不对 Quote.timestamp 另造墙钟阈值。delayed === true 且 stale === false 的休市或合约延迟报价仍走正常路径,可以是 no_material_update。

持仓范围 sourceFetchedAt。 这不是固定 24 小时 TTL。快照的 fetchedAt 必须和本次运行落在同一个本地日历日(与 host 用 Date#toDateString 认领当日 occurrence、scheduler 按本地日历日扫描是同一套 civil day):

  • 当日 00:05 取到的持仓,到当天结束都可用(最长接近一整天)。
  • 前一晚 23:00 的快照,次日中午虽然只有约 13 小时,仍属前一个本地日,记 portfolio snapshot expired,不能当成无实质变化。
  • 周五下午的快照不能覆盖下周二。周末长于 24 小时且休市,但持仓没有 provenance.stale 可用来表示「休市但仍是当前持仓」,所以每个本地日都要自己的快照。
  • 现场 getPortfolio 会在拉取时写下 fetchedAt(进程内缓存大约一分钟)。当天真正刷新过的账本可以通过;只有把更早的快照再放出来才会 fail-closed。

关联 Issue

Refs #185

不使用 Closes #185:本 PR 只补第 3 点。第 1–2 点和通知过严已由 #188 / #194 合入。

测试报告(正式审核前必填)

环境

  • Bun:1.4.2(与 CI BUN_VERSION 一致)
  • OS:Linux 6.12.113+

实际执行命令与结果

bun test packages/shared/src/automation/runner.test.ts
→ 34 pass / 0 fail(119 expect;含 7 个新增新鲜度回归)

bun test packages/shared/src/automation
→ 87 pass / 0 fail / 1 skip(Windows 路径大小写用例在 Linux 上 skip)

bun run --filter @finagent/shared typecheck
→ Exited with code 0

bun run --filter @finagent/core typecheck
→ Exited with code 0

新增回归:

  • stale quote(平盘)→ incomplete,失败文案 quote stale,不会研究、不会 no_material_update
  • stale quote 即使涨幅达到实质变化阈值,整轮仍是 incomplete
  • 同一本地日、约 12 小时前的持仓快照 → no_material_update
  • 前一晚快照(年龄 < 24h,但是上一个本地日)→ portfolio snapshot expired / incomplete
  • 周五快照用在下周二(休市间隔 > 24h)→ incomplete
  • 休市边界:报价时间落后 3 天、delayed: true、stale: false → no_material_update
  • 同一份休市报价,只把 stale 翻成 true(stale-cache 降级)→ incomplete

已知失败 / Baseline(如有)

  • 已提供实际测试命令与 pass/fail 结果
  • 已说明测试环境
  • 如果存在已知 baseline / 环境失败,已提供 main 对照或说明
  • 核心改动已有对应 focused test / smoke / integration 验证

无新增失败。AutomationRuleRepository > shares rule mutations across Windows path casing 在 Linux 上 skip,与本次改动无关。

UI 截图(仅可见 UI 变化时必填)

  • 本 PR 无可见 UI 变化(无需截图)
  • 本 PR 有可见 UI 变化,已提供修改后的 UI 截图
  • 已提供 Before / After 对比截图(适用时)

Scope / 后续

wannT-1 and others added 2 commits November 12, 2026 05:22
Refs helsome#185

行情只认 Provider/Router 的 provenance.stale;休市或合约延迟但 stale 为 false 的报价仍走正常路径。持仓 sourceFetchedAt 必须落在运行当日的本地日历日,不用固定 24 小时 TTL。

Co-authored-by: wannT-1 <wannT-1@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant