[xiaoland]

目的与范围

修复 dogfood 中两起 Job 观测缺项，并让提交方退出后的持久提交事实清楚可读。

• Job 详情使用创建至结束时间前后各一小时作为可调整的初始查询范围。历史已结束 Job 可以查询早于当前日期 31 天的记录，长 Job 默认取靠近结束端的 31 天并提示覆盖范围。
• 支持任意历史绝对时间段，每次最多 31 天。显示实际范围和当前后端，手动窗口覆盖部分生命周期时提示可调整到更早或更晚阶段。结束时间更新会刷新查询，也可手动读取晚到诊断。
• “提交已保存”及当前状态、创建与起止时间来自信息库中的 Job 行。诊断列表与数量、耗时摘要依据实际返回记录计算。
• 成功提交先清理已保存草稿，再关闭弹窗。关闭请求使用 InkPopup 的受控 update:open 接口，保存失败与选择继续编辑时保留草稿。
• Core 导出单次查询宽度常量供 Web 复用，新增回归随 pnpm check 执行。

主要实现范围为 Web Job 详情、来源页提交弹窗、观测时间窗和 Core 查询约束导出。受影响发布项目为 @inkcre/core、@inkcre/web。

共同合同见 InKCre/docs#57，源码和共享引用分为独立提交。

下一步

请评审当前修复，并与父栈及共享合同协调合并。交付物为 draft PR，生产发布由后续交付流程处理。

验证证据

• pnpm check，包含格式、lint、全仓类型检查、Web/扩展构建、独立 SDK 检查和新增三条回归。
• 可控查询回归覆盖早于 DB 创建时间 82 毫秒的提交诊断、历史终态窗口、结束后新增记录的再次读取，以及长 Job 的早期绝对时间查询。
• 真实 useJobCreator 与 JobManager 在可控 PostgREST transport 下覆盖成功关闭、失败保草稿、取消时继续编辑、确认放弃，以及诊断传输失败时，同进程夹具内独立配置的读取方读回已保存的 Job 模型。
• canonical shared-ref pre-bump 和 pre-commit 检查通过，引用已推送的 5c5c254475ca8f4eb2ffe99b3275534338681b2e。
• 按用户约定，本地验证范围为构建及局部回归。浏览器行为复用 dogfood Job 11/13 与独立补丁候选的既有证据，个人信息库保持只读。

App checks 的 PR 触发分支过滤为 main，此 PR 的 stacked base 为 feat/app-peer-naming，云端检查按现有触发规则运行。

指定 Dogfood owner 已对正式 head f584867 完成四组复验。原 Job 11 的四条记录在详情与全局一致，实际 Cloud Loki 的 Job 13 显示持久事实与三条实存诊断。隔离库中的成功关闭、取消继续编辑和真实提交失败均通过。数据库刚可见 pending 行时硬停提交浏览器，Python 完成执行，另一 Web Peer 读回提交事实、finished 和三项时间。历史终态、46 天 Job、早晚绝对范围、超宽拒绝及终态/手动刷新通过。每组运行边界与证据见 正式复验回执。

交付影响

源码、组件说明和 changeset 随本 PR 交付，共享契约使用独立 gitlink 提交。

Stack

• Parent PR 为 ref(apps): 统一 Web 应用与 Peer 命名 #188，基准提交 167a4b1681a89a05b4ab758f6d1292cdbe2a67e7。
• 共享合同为 docs(observability): 明确持久 Job 事实与诊断查询窗口 docs#57。
• 当前已知同仓子 PR 为零。

风险与回退

一小时余量属于初始查询策略，使用者可选择更早或更晚的绝对范围。每次查询宽度与后端记录保留策略分别管理。诊断写入仍受进程生命周期及传输可用性影响，提交确认由信息库中的 Job 行提供。

主要回归面为时间范围选择与弹窗关闭顺序，回退可撤销本 PR 的源码提交。调查额外发现 job.submit 操作摘要缺少 Job 关联，已交给维护方作为后续发现项跟踪。