前台观察参考软件合同与结果

---
type: devlog
title: Lab L4第二项：前台运行观察的独立读界与固定五轮验收
date: 2026-10-17
status: partial
kind: plan
stage: P4
evidence: E2
metric: ios.process.startup.foreground_ready_ms
---

# 前台运行观察：单项交付合同

## 1. 已关门与本次目标

前项Process Observed Running已按[固定五轮](/devlog/p4-fixture-lab-l4-first-startup-observation-plan-2026-10-17)在179正常UI限定E4接受；main/GitHub `982a4c4`、网站8页核同，GitLab唯一推送被关闭、未重试。新设计留存2/66，历史非启动8/54（旧7未重验）。本次仅下一Registry `ios.process.startup.foreground_ready_ms`，不顺带接受Total或九阶段，不复用前项五轮计本项分母。

交付值是host启动请求→host首次观察到精确目标foregroundRunning严格true的时差，algorithm仍startup-observation.candidate.v2、scope process、unit ms、quality candidate；不叫业务可用、物理首帧或绝对进入前台时间。使用既有179和手机Lab90.21.8，不重签/升级/新环境或常驻服务。

## 2. 来源审计与独立参考缺口

当前主线adapters.py::_LifecyclePollStream从DeviceInfo.proclist精确目标行读取foregroundRunning is True；分析接受严格正时差、同generation的observed-foreground，或带foreground=True的running/rebound。原独立参考只保留pid/bundleIdentifier，未保留foregroundRunning；旧五轮虽有foregroundReady数值，却缺独立前台字段证据，故不外推为本指标验收。

参考增加目标专属foregroundRunning原字段、独立严格三态与完整读界：只有精确双查询+唯一应用/进程身份一致且字段type为bool才为foreground/background；缺失、None、0/1、字符串等为unknown。目标未见保持absent，不伪造background/false。其他App不增加前台信息或名字。旧identity输出、API参数、查询次数/频率及收尾策略保持；不改产品公式或默认配置。

## 3. 工具实现与软件门（先落盘后代码）

- ReferenceRead新增可选bool foreground（默认None兼容）；Ledger追加foreground状态计数和每生命首次看见前台的保守区间，身份切换/未见重置，unknown不充当阴性。旧firstSeen/identity计数不变。首次前台记录只作同服务观察，不升级metricAccepted/physicalBirthMeasured。
- DoubleLookupReader在既有列表内投影目标的原字段与严格派生状态；不新增RPC/并发/轮询。最多128读×4096行，有界O(行数)，O(128＋单读列表)内存；只做两次精确查询＋一次列表，interval≥0.5秒。CLI保留1秒收尾预留和未观察尾界、真实失败不重试。
- 固定负控：字段true/false/缺失/非bool、未见/错身份/代际跳变、重复目标、unknown夹层、生命切换/重用、foreground时间在读界内、公开摘要不含身份；旧66项软件回归全部保留。每组≤120秒，固定64/4096行mock前后各100读对比wall/p95/RSS，不能把主机mock当手机加速；不增加产品热路径开销。
- 已核测试工具窄提交main后，干净既有发布clone来源运行。新独占私有批次fixture-lab-foreground-observation-20261017-01，签名包/IPA/工具摘要冻结。首失败保留，不改旧L4工具/封存/Raw来造成功。

## 4. 资格与正式门（先资格后新五轮）

先8秒只读资格核通道/三态/资源；手机当前未运行时只证absent，不宣称已核true。随后一个全新正常UI资格：复用已验Lab下一生命0ms配方和保全脚本，精确旧生命SIGTERM后先至少两次未见，再正常UI Start/Stop各一次；实际capturePlan启用startup并含本ID，新生命与准备生命不同，Lab五回调及3件SHA、Session completed/durable。参考35秒、reserve1秒、RSS192MiB；工作90秒/外105秒，失败只做自有采集清理，不自动再Start或补轮。资格不计正式分母。

资格成立后冻结数值门与工具SHA，才启动五个新生命/Session：间隔15秒、每轮90/105秒、总420秒、串行1，首失败停、不补轮/重试，不并行构建/发布。

1. Raw唯一请求，首个严格正时差合法前台事件同目标/代际/epoch/reconnect；host差分/1e6、live所有有值样本、CSV所有有值行与实际安装二进制独立副本startup报告的foregroundReadyMs一致（≤0.000001ms），全candidate，无正值后退缺值。原Session/Raw/封口原件保留。
2. 至少两次请求前未见；独立参考精确同生命、原foregroundRunning为严格true，端点处在相邻同生命且true的完整读保守界内，unknown不能当true或阴性。前台可能与running在同次读到，允许两个指标相同，但各自证据门独立。
3. 固定工程门沿用前项：0<耗时≤5000ms；参考完整读≤1500ms、实际起始间隔≤2000ms；产品前台端点相对参考首次完整true读结束的正向迟滞≤1500ms，且不早于最后明确未见/非前台读起点。这是状态与可用性迟滞门，不是行业物理精度标准，字段新鲜度unknown仍单列，不许50ms/20%跨端点比较。
4. App内scene-active回调只对顺序/来源辅助，不作为外部前台检测精确时刻；设备uptime与host monotonic不相减。没有原字段或只有running证据即资格未成立，不用业务画面/截图替代。
5. 每轮Session≤256MiB、参考/采集/派生子RSS≤192MiB、磁盘≥10GiB且≥预计增长2倍；每30分钟及批次前后检查，只清理有证可重建副本，不删Raw/失败/封存/回滚。报告仅在独立副本派生，不覆盖在线CoreProfile同名报告。

## 5. 独立复核与交付

五轮后独立重读原Session/副本、Raw/逐读原字段/严格身份/消费者/CSV/真实二进制副本报告及资源/封存，不用执行器自评代替。仅本项通过才新设计2/66→3/66，历史非启动数不变，下一Total另立计划；未通过保持2/66且不启动下一项。指标结论与GitLab/网站/正式分发门分列。

知识页仍唯一Startup Observation，及时沉淀三态与读界坑；同批更新devlog/时间线/总览/首页/进度与handoff，新增不可变HTML快照；窄main、GitHub/GitLab各批一次（GitLab失败不重试），干净来源构建0死链、发布并核线上字节、单次中文交付通知。179实际GUI与main较新官方启动GUI差异、公证暂缓/GPL、继承wall性能风险均保留，不把本项限定E4当整体分发完成。

## Implementation Update · 2026-10-17 · 前台参考软件控制（E2，未增加验收数）

已实现目标专属foregroundRunning原字段、严格bool/unknown与每生命读界，未增RPC/频率、未改产品源码。原66加新29共95个参考单测方法6.518秒通过；旧运行9加新前台11共20个便携判据方法0.014秒通过（含subTest，不把方法数冒充独立设备场景数）。新判据重算原始双查询/列表身份及前台字段，unknown不能构成相邻true读界；报告/live/CSV不符、资源/迟滞超限均拒绝。消费者正值后回缺值亦拒绝。原Running判据和历史五轮保留不改。

固定mock前后各64/4096行×100读，查询各200+列表各100不变：旧wall0.019556/1.189639秒、新0.020582/1.328592秒；p95旧0.407689/25.083753ms、新0.358957/26.925804ms；峰值RSS旧22315008 B、新22528000 B。大列表wall增加约11.7%、p95增加约7.3%，新增目标前台投影有小型有界开销，最差85.968307ms低于500ms最小读间隔；不是设备耗时、产品热路径或全机CPU校准。CPU/I/O未独立测量，不填0；手机原生服务成本仍须资格验证。总量O(n)，单读两查询＋一列表，无额外并发。前置空间约30GiB、原件与旧失败保留。

下一先将工具与合同窄提交main，再从既有干净来源8秒只读资格；正常UI新资格成立后固定五个新生命，不复用旧五轮。当前新设计仍2/66、正式前台0/5、历史非启动8/54不变。179/手机90.21.8不重签不重装、无公证新尝试、无新环境。共享其他WIP不随本批暂存。源码/提交/网站与通知以实际收据为准，不预写发布成功。

[本批软件合同快照](/archive/implementation/fixture-lab-foreground-reference-software-20261017.html)。