docs: align task workspace milestones and preserve original context

HANDOVER.md

@@ -1,5 +1,13 @@
 # ShopSteward 当前开发交接
 
+<!-- md-alignment-2026-09-08 -->
+### 三阶段合并状态与旧文阅读规则（2026-09-08增补）
+
+[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)已合并第一阶段；[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)已于2026-09-08合并第二/三阶段及补齐项，提交 `1bbcad5`，与已测 `c7607ea` 文件树相同，[Windows CI](https://github.com/yhnapoleon/ShopSteward/actions/runs/34246514054)通过。工程事实统一从[组合交付说明](docs/reports/agent-workspace-delivery.md)进入。
+
+本次Markdown增补只明确当前状态与历史适用范围，原正文、测试数字和验证JSON不改写。下方“第二/三阶段尚未提交”“证据/试算未实现”等仍描述各报告形成时点；不能据此重复开发或重新认领已合并工作。语音、正文流、多任务并发、完整Agent验收和已知排队延迟仍是未完成项。
+<!-- /md-alignment-2026-09-08 -->
+
 ### Agent工作区组合交付（2026-09-08）
 
 第二、三阶段及原件下载/代码块复制已组成同一交付范围。[组合交付说明](docs/reports/agent-workspace-delivery.md)逐项说明业务目标、后端支撑边界、迁移要求与验证；[最终指纹](docs/reports/agent-workspace-delivery-verification.json)对应本轮组合源码。515项后端/Agent普通用例分批通过，2项真实浏览器通过，23项前端回归通过。四项文档运行时配置失败补齐环境后复验通过，未改变业务实现。

PROJECT_CONTEXT.md

@@ -1,5 +1,19 @@
 # ShopSteward 项目总说明与对话交接
 
+<!-- md-alignment-2026-09-08 -->
+### 三阶段任务交互已合并（2026-09-08增补）
+
+第一阶段建立同一Mission贯穿的任务卡、独立详情页、常驻Agent区和共享会话，通过[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)合并为 `c46e85c`。第二阶段增加真实工具生命周期与可恢复事件；第三阶段增加准确历史证据、结构化试算/修订成果，并补齐历史原件下载和逐代码块复制，通过[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并为 `1bbcad5`，文件树与已验证 `c7607ea` 一致。
+
+本次是前后端支撑能力交付：backend/agent_bridge、读取契约、事件/活动存储和就绪检查承接前端需求，组合代码需要 `0012_agent_progress`。规划、Mission、账本、审批执行、经营状态、业务调度和 `agent/` 主体源码未改。依据、作用条件与分批验证统一见[组合交付](docs/reports/agent-workspace-delivery.md)，运行接续见[HANDOVER](HANDOVER.md)。
+
+本机Mac mini模型保持关闭；先前Windows真实模型报告仍保留其原版本和环境，不能视为三阶段新增体验的模型验收。语音、正文流、多任务并发、完整A-01/L-01及远端Knowledge新一轮验收仍未完成。
+
+以下“最新”小节按各自阶段时点保留，包括PR #10创建时状态、早期接口数、迁移版本和运行进程。它们不替代本节与HANDOVER顶部的当前接续；知识服务交付、上云限制和原业务职责不因本次前端交付而被删除或判定完成。
+
+原Windows参考工程及仓库外资料链接保留来源环境；本机未能解析的旧路径不能当作当前可用入口，也不通过创建空文件或复制工程来补造来源。
+<!-- /md-alignment-2026-09-08 -->
+
 ### 最新实施与交付：知识检索及服务器交接（2026-09-08）
 
 本轮新增独立 `knowledge` 服务、解析/索引/重试与发布、PG有向关系、可选云embedding与重排接口、Agent只读证据工具及Compose/恢复/验证工具。已按用户要求本地提交并推送到YH，创建 [PR #10](https://github.com/yhnapoleon/ShopSteward/pull/10)（YH → main，更新时为OPEN，未合并）。功能提交 `96ee2a0`，同步main提交 `2406371`，完整手册提交 `e65e066`；未部署到开发服务或创建云资源。原K0冻结集与K1契约保留；新backend迁移 `0011_knowledge_delivery` 和独立knowledge迁移 `knowledge_0002` 已通过专用PG验收。

README.md

@@ -1,5 +1,15 @@
 # ShopSteward
 
+<!-- md-alignment-2026-09-08 -->
+## 当前实现入口（2026-09-08增补）
+
+任务工作区第一阶段已通过[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)合并；真实工具进度、历史证据、试算/修订成果及原件下载/代码块复制通过[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并为 `1bbcad5`。从[当前交接](HANDOVER.md)与[三阶段组合交付](docs/reports/agent-workspace-delivery.md)读取实际能力、迁移和验证边界。
+
+第二、三阶段包含必要的后端桥接、接口与持久记录改动，业务库要求 `0012_agent_progress`；没有改动既有规划、账本、审批执行、Mission、业务调度和Agent主体源码。模型启用情况按运行环境核对，合并不代表完整A-01/L-01或部署验收。
+
+下方“B0-01至B0-05”“下一步B0-06”“Agent后续接入”“21个操作”“空目录”等文字与目录示意保留初始搭建时点；不再作为当前进度或完整目录清单。模块职责和原有启动入口继续保留。
+<!-- /md-alignment-2026-09-08 -->
+
 [项目总说明与对话交接](PROJECT_CONTEXT.md)：新对话先读，包含架构、资料与参考项目索引，以及主干设计/实施状态。
 
 按团队职责划分的项目。backend已完成B0-01至B0-05：业务事实、Mission/规划、警报/看板/历史、审批采购与回执核对；显式推进的完整SC01已验证。下一步为B0-06周期调度。

agent/README.md

@@ -1,5 +1,9 @@
 # ShopSteward Agent
 
+<!-- md-alignment-2026-09-08 -->
+> **2026-09-08任务工作区接入增补：** [PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)在 `backend/app/agent_bridge` 增加真实工具生命周期、进度回放与历史证据/业务成果公开投影；本目录Agent主图、模型适配、记忆及技能主体源码没有本轮改动。工具结果仍走原受限协议，`revise_plan` 成功结果额外保留 `base_plan_id`；采购确认不交给模型。运行支撑依赖业务库 `0012_agent_progress`，模型是否启用仍由当前环境配置决定。具体需求、事务/权限条件及受控执行器验收边界见[组合交付](../docs/reports/agent-workspace-delivery.md)。下方原模型/知识实验继续保留各自版本和环境，不计作三阶段新增UI的真实模型验收。
+<!-- /md-alignment-2026-09-08 -->
+
 首版已实现为 Python 包，由 backend 的独立 Agent worker 装配。真实 LangGraph 主图、OpenAI 模型、PostgreSQL 检查点、Hermes 派生记忆策略、任务 Skill 和受限业务工具已经贯通。前端聊天现已通过官方 `gpt-5.6-luna` 真实浏览器验收，包含解释、试算、修订、澄清恢复、偏好和主动跟进。外部 Agent HTTP 服务、向量 RAG、真实预测模型仍属于后续接入。
 
 ```mermaid

backend/README.md

@@ -1,5 +1,15 @@
 # Backend B0-01 至 B0-07
 
+<!-- md-alignment-2026-09-08 -->
+## 任务工作区所需后端支撑（2026-09-08增补）
+
+[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)组合版本需要迁移至 `0012_agent_progress`：新增Run进度序号、`agent_run_events` 与 `agent_tool_activity`，就绪检查验证这些结构。继续使用本模块既有迁移/启动命令，先核对目标数据库；独立Knowledge库的迁移不替代业务库迁移。
+
+Agent桥接层提供真实工具开始/完成/失败/中断记录、事件回放/SSE、历史证据和结构化成果读取；修订结果增加原方案关联。业务目标、调用条件和验证见[组合交付](../docs/reports/agent-workspace-delivery.md)。规划、Mission、库存/现金账本、审批执行、业务调度和Agent主体源码未在此三阶段修改，不增加采购自主权限。
+
+下文B0接口数和旧阶段边界保留历史用途；当前公开字段/路径以[运行时契约及增补](../docs/api/README.md)为准，不把已有设计稿的planned标记当作运行时不可用证明。
+<!-- /md-alignment-2026-09-08 -->
+
 后续已实现 B2-A Agent 框架：会话/Run、受限工具、记忆与任务 Skill、方案试算与修订、独立 Agent worker 和持久跟进。启动与 API 接入见 [Agent README](../agent/README.md)。当前迁移 head 为 `0009_agent_scopes`；原业务 worker 仍是默认 profile，Agent 不在线时原业务链路仍可工作。
 
 已实现运行基础、业务状态/事件账本、Mission/规划、警报/看板/历史，以及B0-05精确审批、采购发送、资金预留、回执核对和到货入账。独立API/worker/simulator的显式完整SC01及重启回放已验证。B0-06已实现持久周期派发、Schedule配置、事件合并和持续新鲜度检查；自动SC01及三进程重启验收见 `docs/api/b0-06-periodic-smoke-result.json`。

backend/app/knowledge/README.md

@@ -1,5 +1,9 @@
 # Knowledge K1 backend
 
+<!-- md-alignment-2026-09-08 -->
+> **2026-09-08 integration update (PR #12):** This document retains the original K1 delivery and its test timestamps. The combined backend now requires `0012_agent_progress`; the `0010` readiness/head statements below describe K1's original checkpoint, not the current backend requirement. The separate Knowledge service migration is unchanged by this delivery. The Agent workspace can read an authorized historical excerpt from a committed tool result and download its exact original version through the existing version/content APIs. This does not add parsing/search controls to Document Center, change original-file ownership rules, or prove remote retrieval quality. See the [combined delivery](../../../docs/reports/agent-workspace-delivery.md) and [runtime API](../../../docs/api/README.md).
+<!-- /md-alignment-2026-09-08 -->
+
 Scope follows `docs/superpowers/plans/2026-09-07-k0-k1-execution.md`.
 K1 stores originals and metadata only. No index job, parsing, extraction, search,
 reindex or index activation is registered. Those belong to K2.

docs/api/README.md

@@ -1,5 +1,21 @@
 # Swagger / OpenAPI 契约使用说明
 
+<!-- md-alignment-2026-09-08 -->
+## 当前运行时契约增补（2026-09-08，PR #12）
+
+已核对 `1bbcad5` 的[运行时JSON](backend.runtime.openapi.json)：**50条路径、57个HTTP操作**，与当前已注册源码及前端生成类型/代理白名单一致。本文下方21/22/29/40/41等操作数及B2 planned文字属于各批设计/交付时点，原文保留；当前调用以runtime为准，不把设计草案直接当运行服务。
+
+| 三阶段新增/扩展 | 读取语义与条件 |
+|---|---|
+| GET `/api/v1/agent-runs/{run_id}` | 原Run增加progress_seq、activity和outcomes；先校验会话所有者及门店权限；只白名单投影真实成果 |
+| GET `/api/v1/agent-runs/{run_id}/events` | 按after_seq/limit回放，同一Run单调序号，超前游标拒绝 |
+| GET `/api/v1/agent-runs/{run_id}/events/stream` | 同源SSE与Last-Event-ID恢复，连接期间重验身份；不提供模型私有推理 |
+| GET `/api/v1/agent-runs/{run_id}/evidence` | 查询id/version_id/generation_id/chunk_id/metadata_revision/content_sha256，按持久记录读取准确历史片段并重新鉴权，未取到不换最新版 |
+| 既有documents版本与content接口 | 历史片段弹窗复用它们下载原件，前端核对原件版本、大小和hash；不是新增下载协议 |
+
+`revise_plan`内部工具成功结果增加base_plan_id供准确前后比较，未修改普通用户方案审批/修订请求契约。组合代码依赖业务库 `0012_agent_progress`，独立Knowledge服务迁移另行管理。完整字段、错误、身份约束由runtime与[交付说明](../reports/agent-workspace-delivery.md)承接。
+<!-- /md-alignment-2026-09-08 -->
+
 完整设计契约仍包含待实现业务；B0、首批前端查询和 B2-A Agent 已实现，当前源码导出40个已注册操作（36条路径）。Agent 的11个操作见 [agent-v1.openapi.json](agent-v1.openapi.json)，启动与对话流程见 [Agent README](../../agent/README.md)。开发 backend 已迁移至 0009 并切换至当前代码，Agent 仍关闭。启动见 [Backend说明](../../backend/README.md)，实施范围见 [实现清单](implementation-status.json)。
 
 2026-09-07 Simulator 控制台已实现：默认服务 9 个操作（含 ready），开启本地控制台后 19 个操作。可配置 SANDBOX 输入已同步到共享设计契约；运行契约见 [simulation runtime](simulation.runtime.openapi.json)、[console runtime](simulator-console.runtime.openapi.json)，验收见 [结果](simulator-console-acceptance-result.json)。

docs/architecture.md

@@ -1,5 +1,15 @@
 # 简化架构与分工
 
+<!-- md-alignment-2026-09-08 -->
+## 当前任务交互链路补充（2026-09-08）
+
+任务工作区三阶段已随[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)和[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并。一个Mission承接用户委托，Plan承接候选/修订，Action与批准承接实际采购；Conversation/Run承接对话和工具过程。前端共用同一任务/会话同步器，不为每张卡片复制任务或账目。
+
+模型选择工具并解释结果；backend业务模块决定真实方案/账目/审批状态，Agent桥接层记录运行与工具生命周期并公开经过筛选的进度、历史证据和成果。结果/完成记录与原业务事务一致；当前Agent没有审批采购工具。第一阶段以已有接口为主，第二/三阶段包含新增桥接接口和0012存储，不应统称纯前端改动。
+
+下方“Agent/RAG后接”的叙述、虚线和职责表保留原先分工阶段。Agent及Knowledge的已有实现见各模块说明；本次没有改动原主图、规划、账本、审批执行、业务调度或独立Knowledge服务架构。[组合交付](reports/agent-workspace-delivery.md)列明本轮已验与未验，不能将UI合并视为完整A-01/L-01或云部署完成。
+<!-- /md-alignment-2026-09-08 -->
+
 按交付模块划分，backend的B0-01至B0-07已完成；Mission、规划、警报、看板、审批采购、持续源同步及周期/事件调度可用。B0-07补齐组合故障与双worker进程验收，并修复两处锁竞争阻塞；范围与边界见[测试报告](reports/b0-07-test-report.md)。实际启动见 [Backend说明](../backend/README.md)。后端内部聚类与开发契约见 [Backend 开发与接口规范](backend-development.md)，接口预览见 [Swagger / OpenAPI](api/README.md)。以下按“先做 backend，Agent/RAG 后接”的最新安排更新职责。
 
 ## 模块职责

docs/backend-development.md

@@ -1,5 +1,9 @@
 # ShopSteward Backend 开发与接口规范
 
+<!-- md-alignment-2026-09-08 -->
+> **2026-09-08实现口径增补：** 本文保留B0/B2设计、经营规则和历史兼容讨论。当前Agent会话/工具已实现，任务工作区三阶段的公开进度、历史证据和成果字段以[实际运行时API说明](api/README.md)及[组合交付](reports/agent-workspace-delivery.md)为准；下文B2 planned/未注册的文字限定原设计阶段。PR #12仅补Agent桥接、事件/活动记录、读取契约与就绪检查，业务库需0012；没有修改本文核心采购计算、账本、审批执行、Mission或业务调度实现。原设计JSON继续作为设计依据保留，不用其历史状态替代runtime。
+<!-- /md-alignment-2026-09-08 -->
+
 版本：0.2.0-draft · 日期：2026-09-07 · 状态：整体为开发设计；B0-01至B0-07已完成；自动SC01、双worker故障恢复及全服务重启已验证
 
 本文面向后端、Nuxt 前端、模拟环境、预测模型和 Agent 的开发人员。目标是先完成不依赖 Agent/RAG 的确定性业务后端，再通过稳定契约接入智能能力。本文中的路径、端口、频率、状态和字段是本项目建议采用的约定；不表示当前仓库已经提供这些能力。

docs/data-and-frontend-boundaries.md

@@ -1,5 +1,11 @@
 # 数据存储与前端访问边界梳理
 
+<!-- md-alignment-2026-09-08 -->
+> **2026-09-08后续实现索引：** 本文以下是2026-09-07原范围分析，表内“尚未实现”、21张表及旧接口数按当时时点保留。现已具备真实前端、Agent会话/运行、知识资料管理，以及[PR #12组合交付](reports/agent-workspace-delivery.md)的持久工具进度、准确历史证据和试算/修订成果。新增数据边界见[数据字典增补](data-dictionary.md)，公开读取见[API增补](api/README.md)。这没有补齐通用报价持久产物、完整L-01或多任务经营范围；原分析中这些剩余问题仍保留。
+
+原文的仓库外产品建议资料路径在本机未找到，保留原链接供追溯；本次三阶段判断使用上方已核对的交付、数据字典和runtime，不把缺失旧副本当作现行实现依据。
+<!-- /md-alignment-2026-09-08 -->
+
 日期：2026-09-07。性质：依据现有需求与代码形成的**范围核对及契约建议**，不是已批准的新实现计划，也不表示下列拟议接口已经上线。本轮只读取资料、核对源码与生成文档，没有修改业务代码、数据库或飞书原文。
 
 后续进展：用户同意后，已据此完成[首批数据字典](data-dictionary.md)、[补充OpenAPI](api/frontend-data.openapi.json)及[实施计划](superpowers/plans/2026-09-07-frontend-data-implementation.md)，并实现7个只读GET；当前runtime为29操作/28路径，见[测试报告](reports/frontend-data-test-report.md)。以下保留实施前边界分析的依据；具体字段与查询规则以新字典和契约为准。

docs/data-dictionary.md

@@ -1,5 +1,21 @@
 # 首批前端数据字典 v1
 
+<!-- md-alignment-2026-09-08 -->
+## Agent过程、证据与成果的数据增补（2026-09-08）
+
+本字典原有业务字段与查询口径保留。三阶段新增的是可观察过程与只读成果，不能用模型文字或前端副本代替经营账本。当前字段来源见[运行时契约](api/backend.runtime.openapi.json)及[组合交付](reports/agent-workspace-delivery.md)。
+
+| 对象 | 持久来源 | 含义与约束 |
+|---|---|---|
+| Run进度序号 | agent_runs.progress_seq | 0012新增，Run内递增；作为快照/事件恢复水位 |
+| 运行事件 | agent_run_events | Run+seq唯一；记录排队、开始、补充输入、终态及工具生命周期，保留事件发生时点 |
+| 工具活动 | agent_tool_activity | Run+invocation唯一；状态、attempt、服务端起止与耗时，不暴露参数/租约凭据 |
+| 试算/修订成果 | 既有agent_tool_calls与plans | 白名单投影候选、约束和前后版本；修订调用保留base_plan_id，不另建影子方案/账本 |
+| 历史文档片段 | 既有工具结果、文档与原件版本 | 精确绑定document/version/generation/chunk/metadata revision/hash/locator；当前权限、归档及原件存在性仍须检查 |
+
+Plan、Run、工具调用和Action不是同一对象；仅试算不写经营事实，方案更新不代表已采购，采购受理不代表已到货。历史结果版本落后时显示历史口径；缺少明确关联不补造原方案。原字典内早期接口/表计数不涵盖此增补。
+<!-- /md-alignment-2026-09-08 -->
+
 日期：2026-09-07。**新增7个GET接口已实现**，runtime现为29个操作、28条路径；基础提交为`YH / da79cbd`，实现保留在工作区。需求依据见[来源与范围核对](data-and-frontend-boundaries.md)；字段约定和示例见[前端数据OpenAPI](api/frontend-data.openapi.json)，实际服务schema见[runtime](api/backend.runtime.openapi.json)；处理规则见[设计规格](superpowers/specs/2026-09-07-frontend-data-contract-design.md)，验证见[测试报告](reports/frontend-data-test-report.md)。
 
 状态含义：**已有**=当前代码保存/计算并可按接口访问；**新增查询**=本批已提供的7个只读接口；**后续范围**=本批不建立字段或表，不能返回伪造默认值。逻辑对象不必一一建表；派生展示字段不创建第二份权威事实。