@givolt/i3-composer-agent 2.3.7 → 3.0.0

package/references/enterprise-sop-resources/technical-baseline/references/engineering-directory-v0.2.0/directory-standard.md

@@ -0,0 +1,119 @@
+# 工程目录规范
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+内容版本：0.2.0。适用范围：明确采用本规范的业务工程。目标是让 AD 约定的工程与模块位置，继续落实到原 Plan 的文件范围和原 Build 的真实产物。
+
+## 1. 基本规则
+
+- 先确定实际业务项目根。工程相对路径均从该根解析；安装的 Skill／资源目录及 i3 维护工作树不是业务输出根。
+- 规范约定外层职责；工程内部遵循项目已采用的语言／框架惯例，具体位置由 AD 和真实配置明确。
+- 只采用当前需要的工程类别；实际有内容时再建目录。空目录不等于已交付工程，Git 也不保存空目录。需要先说明预留位置时可写有意义的 README，无需到处添加占位文件。
+- 新建工程标识使用稳定、可区分的小写短横线名称，例如 admin-web、business-api。语言内部包名／模块名遵循其自身规则；现有项目保留原名并建立映射。
+- 工程标识与 PRD 主题、版本分开。同一工程可承接多主题；新增或修订 PRD 不自动复制工程。同一路径不得指向两个不同工程身份。
+- 目录不是进程、服务、仓库或部署边界。AD 明确源码工程、业务模块、运行应用和部署单元之间的实际关系。
+
+## 2. PBC 组合工程：pbc-composite
+
+以下是逻辑位置，按实际选择形成，不要求一次创建全部目录：
+
+```text
+project/
+├── README.md                     工程入口、工程清单与真实命令
+├── spec/{能力}/                  当前业务文档及版本历史
+├── tasks/
+│   ├── plan.md                   原 Plan 的默认计划
+│   └── todo.md                   仅在采用默认文件任务目标时维护
+├── docs/engineering/             按需：项目规范／采用说明
+├── frontend/<engineering-id>/    按需：前端源码工程
+├── backend/<engineering-id>/     按需：业务后端源码工程
+├── agents/<engineering-id>/      按需：本项目内 Agent 源码工程
+├── jobs/<engineering-id>/        按需：任务源码工程
+├── contracts/                    按需：受控接口与事件定义
+│   ├── exports/                  对外提供的契约
+│   ├── imports/                  明确采用的外部契约
+│   ├── internal/                 本项目工程间契约
+│   └── events/                   事件契约
+├── shared/                       按需：明确复用和维护边界的代码
+├── tests/cross-engine/           按需：跨工程验证
+└── delivery/                     按需：运行装配与部署资料
+    ├── local/                    本地依赖与联调配置
+    ├── dapr/                     仅在明确采用 Dapr 时使用
+    └── deploy/                   目标环境部署配置
+```
+
+使用现有 SOP JSON 时沿用其已采用位置；不要求为了目录规范再创建 .i3/project.yaml、templates.lock、contracts.lock 或生成记录库。已有项目或工具确有这些文件时按其真实用途保留。
+
+spec/ 下按业务能力组织文档。一个 EBC 的 BRD 识别相关 PBC；同一 PBC 的多个需求主题各有独立 PRD 版本及准确对应的 AD／TestCase，配套版本号可以不同。既有已采用文档目录不因本规范迁移。
+
+## 3. 独立 Agent：agent-standalone
+
+单一 Agent 应用可以把所选框架的源码与构建配置直接放在项目根下，避免无意义的 agents/<id> 包裹。按实际能力组织，不强制以下所有内容存在：
+
+```text
+agent-project/
+├── README.md
+├── spec/{能力}/
+├── tasks/                       原 Plan 和唯一任务目标
+├── docs/engineering/            按需：规范采用与工程说明
+├── <框架构建／配置入口>
+├── <源码根>/                    AD 确定的本应用源码
+├── <程序测试位置>/              采用框架的原有测试位置
+├── evals/                       按需：Agent 行为样例及评价
+├── contracts/                   按需：实际提供／消费契约
+└── delivery/                    按需：运行装配／部署
+```
+
+采用说明把主 Agent 工程映射到项目根“.”。日后确需组合多个可独立构建工程时，按 AD 明确新增位置，不能因为模板示例存在 agents/ 就把当前代码自动搬进去。
+
+此处 Agent 是业务工程；3.1.0 规划的企业研发调度 Agent 是另一项产品能力。外部 Agent 服务只引用正式契约和消费者适配，不把其源码和内部 AD 复制到本项目。
+
+## 4. 四类工程与配套目录职责
+
+| 类别或目录 | 应承接内容 | AD 需明确的实际位置与责任 |
+| --- | --- | --- |
+| frontend | 页面、路由、交互状态、客户端接口适配及适用 UI 测试 | 工程根、源码／页面模块、配置、测试、资源和构建产物；响应式／可访问性要求；业务授权仍由服务端落实 |
+| backend | 正式业务规则、授权、状态、数据及外部适配 | 工程根、包／模块、接口、配置、迁移与测试；数据 owner、事务、失败恢复及真实命令 |
+| agents | Agent 职责、模型调用、授权工具与必要运行记录 | 工程根、源码、工具、提示／配置、程序测试与行为评价；不得把分析建议冒充正式业务状态 |
+| jobs | 定时、异步、批处理等任务逻辑及必要执行记录 | 工程或模块位置、触发入口、调度配置、幂等、失败／重试与恢复；是否独立运行由 AD 决定 |
+| contracts | API、事件及必要共享数据协议 | 提供／消费方、正式来源／版本、维护位置；事件的归属位置只保留一处权威，不因分类重复拷贝 |
+| shared | 有真实复用者的共用实现 | 唯一维护方、消费者、依赖方向；不把业务归属不清的代码全放 shared |
+| tests/cross-engine | 多工程联调、共享契约及回归验证 | 需求／AC 来源、测试入口、数据、环境和结果位置；单工程测试仍跟随该工程惯例 |
+| delivery | 本地连接、运行装配及部署描述 | 运行身份、依赖、环境及部署单元映射；不保存真实密钥，目录存在不等于已部署 |
+
+jobs 可以是已有后端工程里的模块；Agent 也可以是已有工程中的组件。此时在 AD 映射真实子路径，不为凑四类顶层目录制造第二个工程。
+
+## 5. 工程内部目录与实际产物
+
+本规范不强制所有语言使用同一份 src/modules 布局。例如采用 Java 常规布局时，源码和测试可在 backend/business-api/src/main/java 与 src/test/java；采用前端框架时，其源文件可在 frontend/admin-web/src。准确目录、包名、扩展名和命令来自已采用技术规约、AD 和实际构建配置，这些例子不是技术选型。
+
+AD 至少映射本次需要的源码／业务模块、配置、测试、契约、迁移及运行装配位置；不适用项有依据说明。Plan 进一步列出每项任务预计新增／修改的文件及路径。Build 按获准任务生成有实际内容的文件，未选择工程不预建空架子。
+
+编译、打包、依赖和缓存产物遵循真实工具配置，例如 dist、target 等；在采用说明中必要时说明输出及忽略规则。不能把构建输出位置的差异等同于业务源码越界，也不通过移动编译产物掩盖源码位置错误。
+
+项目根可按工具实际需要保留构建配置、workspace／CI 等公共文件，路径在 AD 或计划中说明。不要为满足外层分类，把框架入口强行放到无法正常工作的目录。
+
+## 6. AD、原 Plan、原 Build 的约束链
+
+| 环节 | 必须明确的内容 | 如何核对 |
+| --- | --- | --- |
+| 采用说明／AD | 规范版本、项目根、所选组织方式、工程与模块映射、共享责任和例外 | 读真实来源与当前代码，区分已有、拟建及未定事项 |
+| 原 Plan | 当前 AD／采用说明引用；每项任务文件路径、依赖、验收与验证方法 | 任务可以落到真实或拟建位置，共享文件不安排互相覆盖的独立写入 |
+| 获准原 Build／Build auto | 实际回读任务所需来源，按映射生成／修改源码、配置、测试 | 对照任务和实际变更文件核落点，再完成原有测试／构建与任务处理 |
+| 原测试／Review／Ship | 实际代码、结果与本次范围 | 目录检查只是适用验收之一，不取代功能正确性、独立代码审查或发布条件 |
+
+原能力不会因为目录规范文件存在就自动消费它。显式任务或已采用项目指引负责把路径交进去；原版 Skill、命令、默认 Plan 和任务权威保持。具体可复制说明及核对步骤见 [采用与交接](adoption.md)。
+
+## 7. 存量工程、人工修改与变更
+
+已有 web、services、server 等工程组织先按现状映射到逻辑职责，不要求立即重命名。例外要写清实际路径、原因和适用范围；不能一边把旧结构认定有效，一边在新规范目录里生成第二套同名源码。
+
+新增需求优先落到原工程的相应模块。撤销未实施需求不自动删除工程或契约；功能退役通过明确的移除、迁移和回归任务处理，保留已完成历史及其他主题的共享依赖。目录规范变更不自动扩大已有任务授权。
+
+采用后的项目副本、人工源码与原始失败记录保留。升级资源不覆盖项目自改内容；实际迁移先评估导入、构建、测试、CI／部署和消费者影响，不用重建目录宣布迁移完成。

package/references/enterprise-sop-resources/technical-baseline/templates/TECHNICAL-BASELINE.md

@@ -0,0 +1,133 @@
+# 公共技术规约模板
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+模板内容版本：v0.0.1。用于项目共用工程约束及其采用引用；不增加BRD／PRD／AD／TestCase之外的业务阶段。采用方式见[采用说明](../README.md)。
+
+**先复用已有规范。** 项目、集团或平台已有适用规范时，本模板只用于核对覆盖和补充真实缺口，不要求复制全文、搬迁文件或再建一份同内容规范。已有采用说明足够时，沿用其位置及格式即可。缺少规范时，才按下列结构起草项目最小候选；可用固定引用代替重复正文，不适用项说明理由。
+
+**候选和事实分开。** `{占位内容}`必须由真实来源替换；未确定的选型、版本、责任、权限、批准和运行结果保持待确认。已读、建议、项目明确采用、审查、认可及工程验证分别记录。真实证据未取得时，不填写已通过或自造摘要。
+
+**公共规则和主题设计分开。** 每份主题AD仍完整设计其选定PRD，保留技术架构、功能架构、ER三图及工程细节；本文件只维护公共约束或准确引用，不替代AD、CONSTRAINTS、ADR、正式契约或原Plan／唯一任务目标。
+
+---
+
+# {项目名称} · 公共技术规约
+
+## 0. 身份、范围与来源
+
+| 项目 | 本次实际内容 |
+| --- | --- |
+| 文档身份／版本／位置 | `{项目内稳定身份；本文件独立版本；准确位置}` |
+| 当前性质 | `{新候选／既有规范引用与缺口补充；先标草稿待审}` |
+| 适用范围 | `{项目、仓库、工程、能力及环境范围；不推定全公司通用}` |
+| 维护责任 | `{已明确的逻辑职责与真实责任依据；未知列Q，不填假姓名}` |
+| 本次业务与工程输入 | `{明确提供的BRD／PRD、工程事实、平台规范及其身份／版本}` |
+| 模板与本地修改 | `{固定模板版本；发行来源或项目副本；实际本地修改与摘要，如未计算则明示}` |
+| 真实决定／认可依据 | `{谁对何内容和范围作了何决定；未取得就注明，不由状态字段代替}` |
+
+### 0.1 规范引用与覆盖
+
+| 来源ID与权威位置 | 固定版本／提交／快照或实际摘要 | 适用条款与覆盖范围 | 本项目落实或补充位置 | 实际已读／采用依据与缺口 |
+| --- | --- | --- | --- | --- |
+| `{真实规范／CONSTRAINTS／ADR／契约等}` | `{可回读准确内容；无版本来源可用已保存内容的真实摘要}` | `{精确章节或规则ID}` | `{本文件必要补充或主题AD条款；不重复定义}` | `{读取及真实选择分别说明；不可读或未决定列Q}` |
+
+来源未给出时记录“未提供／未读取”，不能推定其不存在。规范与实际代码有差异时，分别写清目标约束、已观察实现和缺口，不把实现偏差自动提升为已认可规范。单有版本号或可变链接不足以区分固定内容时，补固定提交、可回读快照或真实摘要。
+
+## 1. 共用架构与工程边界
+
+| 工程／共用能力 | 适用公共约束与职责 | 权威数据／状态及最终校验边界 | 对外依赖或契约引用 | 真实来源与未决 |
+| --- | --- | --- | --- | --- |
+| `{项目实际工程或逻辑能力}` | `{共用原则；明确不负责范围}` | `{逻辑责任与受控写入边界}` | `{准确来源或待取得}` | `{已有／拟建／待核；不伪造已部署}` |
+
+前端的交互状态、服务端正式业务状态、Agent运行结果与jobs执行状态分别定义。只列项目实际需要的工程；PBC不自动等于微服务，单一责任不等于只能有一个操作人。若已有公共架构视图，固定引用适用条款；各主题AD仍须呈现自己的三图及完整设计。
+
+## 2. 技术与工程基线
+
+| 技术／工程项 | 精确版本或有依据的兼容范围 | 权威来源与适用条款 | 本项目使用范围 | 现状／建议／采用及未决 |
+| --- | --- | --- | --- | --- |
+| `{运行时／框架／数据存储／身份／消息／部署等实际项}` | `{实际值或待确认，不能取想象中的最新版}` | `{规范、锁文件、构建配置、平台决定等}` | `{准确工程及环境}` | `{版本可读与可运行分别判断}` |
+
+技术栈和部署平台来自项目真实约束。本模板不默认选框架、数据库、云或部署产品；项目已明确采用的平台需保留其约束并取得适用版本。骨架选择、生成或锁文件存在，不代表实际应用和验证已完成。
+
+## 3. 身份、安全与业务权限的实现约定
+
+| 共用事项 | 已有约定或必要候选 | 权威来源／适用范围 | 主题AD需要细化的内容 | 缺口与限制范围 |
+| --- | --- | --- | --- | --- |
+| `{身份／租户／服务身份／授权执行／审计／敏感数据}` | `{可信来源、执行边界、引用方式；未知列Q}` | `{真实业务权限和平台规范}` | `{具体接口、字段、拒绝行为及可观察结果}` | `{待答复内容，不代定权限}` |
+
+业务角色、权限和数据保留要求依据BRD／PRD及真实采用规范，不因填表新增。前端隐藏按钮不能代替服务端授权；调用方自填身份／租户不能自动成为可信输入。配置和密钥只记录取得方式与引用，禁止填真实凭据。
+
+## 4. 契约通则与共享定义引用
+
+| 领域 | 共用规则或准确规范条款 | 权威维护位置与版本 | 适用范围／例外 |
+| --- | --- | --- | --- |
+| `{接口／事件／工具、错误、分页、命名、时间、null／省略}` | `{已知规则；未知明确未定}` | `{固定规范／契约章节}` | `{本次实际范围}` |
+| `{幂等、重试、结果未知、补偿；事件重复／顺序／迟到}` | `{按副作用与一致性要求确定，不照抄示例}` | `{固定权威与行为依据}` | `{边界与待核项}` |
+
+| 共享契约／定义ID | 唯一权威位置与版本 | 提供／维护责任 | 消费工程或AD范围 | 字段与行为的权威边界 |
+| --- | --- | --- | --- | --- |
+| `{真实或明确草拟的接口／事件／工具／数据定义}` | `{正式Schema或提供方AD固定章节}` | `{真实逻辑责任；未知列Q}` | `{实际消费者；未形成则待定}` | `{字段、授权、错误、副作用、恢复分别在哪里定义}` |
+
+同一字段或行为只保留一处可维护答案；Schema和AD分担不同权威范围时写清映射。不强制新协议或拆文件，正式契约可先在提供方AD明确章节维护。消费方使用对外契约，不复制外部能力内部AD。公共通则不能替代每项具体契约的完整行为。
+
+## 5. 数据、状态及共享文件责任
+
+| 实体／字段／状态或共享文件 | 业务含义及权威来源 | 最终校验／写入或维护责任 | 授权使用方、派生／快照及过期语义 | 并发、一致性与恢复边界 |
+| --- | --- | --- | --- | --- |
+| `{实际对象；无信息不自建实体}` | `{BRD／PRD、正式数据定义或技术规则}` | `{唯一逻辑权威；受控操作可由多主体调用}` | `{真实读取／修改边界、时间点及来源}` | `{条件、事务、结果未知与恢复；未定列Q}` |
+
+共享业务状态、只读快照、前端临时状态、Agent运行状态及jobs状态不能互相冒充。并发动作由权威边界执行最终校验，不以“先查后写”代替一致性设计。共用底座、迁移或共享文件明确维护责任，后续只交一处真实工程任务，其他主题引用依赖，不在这里建立第二套任务清单。
+
+## 6. 工程质量与原规格交接
+
+优先引用已有CONSTRAINTS、工程规范与实际代码示例，不重写冲突阈值。命令和风格只填已取得的真实来源；项目未建时给出待确认范围，不虚构已执行结果。
+
+| 工程及用途 | 完整命令 | cwd与必要环境／前提 | 来源／预期结果 | 执行与证据状态 |
+| --- | --- | --- | --- | --- |
+| `{实际工程}` · build | `{完整命令或未取得}` | `{真实路径与前提}` | `{固定配置或项目决定}` | `{未执行／真实回执}` |
+| `{实际工程}` · test | `{完整命令或未取得}` | `{真实路径与前提}` | `{测试策略、判据及来源}` | `{未执行／真实回执}` |
+| `{实际工程}` · lint | `{完整命令或未取得／有依据的不适用}` | `{真实路径与前提}` | `{质量要求及来源}` | `{未执行／真实回执}` |
+| `{实际工程}` · dev | `{完整命令或未取得}` | `{真实路径与前提}` | `{启动方式及适用范围}` | `{未执行／真实回执}` |
+
+目录、命名、代码风格及真实示例位置：`{固定工程来源和示例；未读取就注明}`。
+工程动作边界、测试策略、可观测要求及质量判据：`{引用CONSTRAINTS／AD／TestCase的准确条款；缺项列Q}`。
+
+有效PRD、AD、TestCase和固定规范共同承接原SPEC六项。AD／用例可交原Plan、Plan的真实认可、获准逐任务Build及实际测试分别判断；本文件不自发创建SPEC、Plan、任务、测试结果或批准。
+
+## 7. 组合兼容、交付与恢复
+
+| 交付组合或适用规则 | 准确提供／消费版本及契约 | 数据／语义／运行兼容判据 | 部署、迁移、并存与恢复前提 | 当前证据及未决 |
+| --- | --- | --- | --- | --- |
+| `{实际组合；尚未形成可列待定范围}` | `{AD、契约、代码／环境分别固定}` | `{字段、默认、权限、错误、存量值及行为}` | `{顺序、兼容窗口、责任、不可逆限制}` | `{文档核对／待工程验证／实际回执分开}` |
+
+文档、契约、制品和环境版本分别管理，不要求所有AD或文档同号。版本号或Schema检查不能独自证明兼容；新增字段、枚举或默认行为需核实际消费者。未验证时保留未知，不推断应当兼容或自动升级所有主题。
+
+外部契约锁在正式采用时记录；模板锁及生成基线在实际应用并验证后记录。锁不是批准或运行通过证明。此规约不自动创建锁、执行迁移、部署或发布。
+
+## 8. 变更、例外与未决
+
+| ID与变化／例外 | 旧→新固定内容和来源 | 影响规范、契约、实体及必要传递消费者 | 相关AD／AC／TestCase／真实任务 | 真实决定与待验证范围 |
+| --- | --- | --- | --- | --- |
+| `{已有稳定ID或本次明确候选}` | `{变化条款、理由、准确版本或内容}` | `{直接与必要传递影响；无关主题不机械重写}` | `{固定引用；未形成就注明}` | `{未取得认可保持待审}` |
+
+| Q／待核实事项 | 当前事实与缺少内容 | 影响范围及可独立继续部分 | 需要何种真实答复／证据 |
+| --- | --- | --- | --- |
+| `{稳定Q标识}` | `{未知不填假值}` | `{只限制依赖它的范围}` | `{责任未定就说明，不自填人员或日期}` |
+
+同名同版本正文改变后，旧摘要、审查和认可仅对原内容有效。公共约束不能由单份AD静默覆盖；实际冲突记录适用范围和例外依据。审查只标注，使用者人工处理或明确委托修订；修订后按影响复核，不能为清零新增无来源要求。
+
+## 9. 本次交接检查
+
+- 来源、固定内容、适用条款和补充位置可回读；已有规范没有被复制成第二权威或覆盖人工修改。
+- 规则区分已知事实、建议、明确采用和待确认；技术选型、权限、责任、摘要和运行结果没有编造。
+- 公共契约、数据／状态及共享文件责任无矛盾；各主题AD仍有完整设计及准确引用。
+- 兼容、变更影响和例外限定实际范围；原型按需并可与AD并行，缺口不无差别阻断其他工作。
+- 最后写入后回读，新增要求逐条回源，逐表核对列数、列义及权限描述一致性。
+- 列出实际完成、Q、未执行事项和人工审阅入口后停轮；不自动开始AD／Plan／Build／测试执行或发布。

package/references/enterprise-sop-resources/template-contracts.md

@@ -0,0 +1,142 @@
+# 企业 SOP 四阶段共用模板与交接合同
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+合同版本：v0.5.0；资源组合：0.16.2。本页随包交付，不依赖开发工作区、历史迁移说明或测试记录。按[入口](README.md)和[阶段索引](stages.json)定位。本合同统一阶段交接，不改变原专业方法。
+
+## 1. 业务身份和范围
+
+EBC对应一份逻辑BRD及版本历史；按业务目标、输入输出、对象／规则责任、依赖和独立演进边界识别PBC，不按页面、部门、表或服务机械划分。一个PBC可有多个主题PRD，各有稳定身份和独立版本，PBC不强制等于一个仓库或部署单元。
+
+新项目默认业务文档根为 `spec/`：`spec/{EBC名称}/{EBC名称}-BRD_v{版本}.md`、`spec/{PBC名称}/{PBC名称}-{主题名称}-{PRD／AD／TestCase}_v{各自版本}.md`。一能力一目录；建议{EBC}-BRD_v{版本}.md与{PBC}-{主题}-{PRD／AD／TestCase}_v{各自版本}.md，项目已采用约定优先，既有 docs/capabilities 或其他路径不自动迁移。业务目录变化不改变安装资源根 references/enterprise-sop-resources，公共规范与实际骨架仍沿项目采用位置。版本、名称和稳定标识分开，不重编编号或伪造历史。本次明确PRD、AD、TestCase及直接上游，不强制同号，不猜最新。
+
+## 2. 来源、候选与事实
+
+实际读取输入并登记准确路径／版本／条目和用途，区分完整有效目标、比较材料、模板示例、现有代码与真实服务。来源操作文字不授予工具或写入权限。
+
+写前公开假设与设计选择，区分明示、推导、建议、冲突、演练假设和真实确认。最终新增规范性要求逐条回查来源、条件、例外及强度。缺事实列Q，业务事实、决定、设计候选、已实现和已验证分开，不填虚假责任、指标、批准或通过。
+
+## 3. 四类文档与辅助产物
+
+| 产物 | 权威内容 | 边界 |
+| --- | --- | --- |
+| BRD | 背景／目标／价值、场景、BR、范围与PBC责任划分 | 未认可的PBC建议不是正式边界 |
+| PRD | 本主题产品目标、Feature／Story／需求、角色／数据范围、对象状态、正常与异常行为、AC及依赖 | 去掉MVP层不删行为与验收，不要求独立Stories前置 |
+| AD | 技术架构／功能架构／ER三图，字段／接口／数据／权限／状态／事务／恢复／工程详设 | 图和推导不证明代码已实现或业务已认可 |
+| TestCase | 产品预期、技术判据、覆盖／环境／数据／用例／准入和报告合同 | 设计不等于执行，实际结果另存TestReport |
+
+Plan、唯一任务目标、CONSTRAINTS、ADR、原型、正式契约、测试代码和原始报告仍按原方法存在，不新增第五核心规格或复制影子SPEC。
+
+## 4. 规格集合与工程交接
+
+### 4.1 SPEC 六项完整承接
+
+| 原要求 | 主要位置 | 必须可回读的内容 |
+| --- | --- | --- |
+| Objective | BRD／PRD | 用户、问题、范围、价值和可测成功条件；功能符合与真实收益分开 |
+| Commands | AD §9.1；TestCase固定引用 | build／test／lint／dev完整命令、参数、cwd、前提与副作用 |
+| Project Structure | AD §3.2、§9.2 | 源码、测试、文档、生成物、交付位置及责任，拟建／已有分开 |
+| Code Style | AD §9.3 | 真实示例或有实际示例的固定规范及范围 |
+| Testing Strategy | AD／已采用测试规范；已有适用TestCase则引用§2、§3.1、§5 | 框架／版本、层级、目录、命令、覆盖依据和运行条件 |
+| Boundaries | AD §9.4与原方法／项目规则 | Always do／Ask first／Never do，真实授权和风险停点 |
+
+早期BRD／PRD不要求先形成全部工程资料，缺项不能自称规格齐备或可编码。交原Plan前从本次采用集合逐项核对；计划产生后的真实认可、执行前核对分别满足。
+
+## 5. 共用内容检查与独立主题
+
+| 编号 | 各阶段按职责保留 |
+| --- | --- |
+| G01 | 文档、能力、主题、版本和位置可定位，未绑定如实写 |
+| G02 | 明示／推导／建议／冲突／演练／真实确认分开 |
+| G03 | 全量读目标、价值、角色、场景、范围、附件、质量和排除 |
+| G04 | 固定输入与附件可回读，未读／缺失／矛盾照录，不猜最新 |
+| G05 | 有效目标、比较材料、工程／生产现状分开 |
+| G06 | 修订先读旧稿与人工修改，保留理由和影响；无变化不机械升版 |
+| G07 | 认可绑定真实对象和范围；模板／业务／开工／生产决定分开 |
+| G08 | 业务、工程、任务和状态有各自唯一权威，缺口只限制依赖范围 |
+
+PRD保留S01—S14语义：Feature／Story与固定完整来源、九项行为和复合AC、共享规则、跨主题闭环、执行依赖、范围调整及回归。完整清单从[PRD模板](prd/templates/PRD.md)§10.2及[说明](prd/README.md)§5读取，不依赖历史迁移页。沿用FT／US／FR／AC，不假定编号一对一。
+
+依赖写双方、对象／版本、影响Story／AC、冻结／决定时点、联调组织、环境／数据／权限／服务前提、责任与实际就绪。未知不伪造；必需路径降级／移出需理由、闭环影响和真实确认，建议不代授权。
+
+## 6. 原型、骨架与交接
+
+原型按需，可与AD并行。直接产品依据为选定PRD，无原型不统一阻断；未定交互只限制依赖范围。已采用原型按准确版本、范围、验证和必要认可引用，不因存在原型就全部套用，不修改原型登记假装关联。
+
+工程骨架是独立资产，AD选型、Plan安排、获准Build才应用验证。pbc-composite／agent-standalone两类起步方式与frontend／backend／agents／jobs按需组合，契约／共享底座／测试／交付及责任不漏。目录图不冒充已交付或可运行工程，本资源不含工程生成器；企业平台约束按实际AD固定，标准项目不自动绑定。
+
+## 7. 四种作业、人工处理和原方法
+
+一次只做明确作业。生成最后编辑后回读目标，核来源、权限／状态、复合条件与逐表列数和列义，汇报Q、影响和未执行事项后停轮。原方法适用的澄清、能力边界、内容、工具、认可及停轮完整保留。
+
+review／recheck需真实独立新上下文，全程只读会话输出位置、来源、反例影响及最小建议，不改候选／项目／报告／采用记录。报告由获准调用者另存，同会话自查不冒充独立，必修为零不代表业务／工程通过。
+
+用户可人工修改、明确委托、有据不采纳或保持Q。修订先读当前稿、可回读旧稿、发现及答复，只改唯一目标；缺旧稿先停止覆盖。误报留依据，不为清零编业务决定。最后编辑后实际回读，继续改则重核。
+
+## 8. 失效、人工修改与恢复
+
+同名同版本也可能内容已变，旧审查／认可只对原对象有效。核实际稿、快照／摘要或可信记录，按变化重核影响范围，不自动重置全项目。项目自改副本不被升级覆盖，发行摘要与本地摘要分开。
+
+中断或新会话先读真实文件、最后成功步骤、旧稿及交接，不从聊天摘要推定批准；超时、退出码0或模板勾选不证明成功。未知外部结果不盲重试。工具无原子版本比较时不宣称消除并发窗口，目标不稳定则停写、给可审差异。
+
+资料、分发、宿主读取、模型行为、人审与发布分别取证。该合同不改原Skill／命令／using，不增全局配置或硬门禁。文档作业不自动Plan；显式/i3-sop plan按规划交接复用原方法，交审后不自动Build、测试执行、提交或发布。
+
+## 9. B03补充：规划输入和审查分工
+
+TestCase是Plan的可选输入，不是统一前置。按当前范围从PRD、AD及已采用规范核对原SPEC六项，已有用例读取准确版本，没有独立用例文件则在原Plan安排补齐设计；不伪造路径，不降低依赖任务的验证与实际执行条件。企业SOP保留TestCase设计交付，允许在规划后按任务依赖完善。
+
+企业文档review／recheck独立且零项目写入；原test／Build仍是原TDD和实际实现，原代码review保留五维及临时变异检查，不整体套用为只读文档审查。原版技能和命令不修改，文档审查不替代代码质量与合并要求。
+
+## 10. 共用定位、采用与交接
+
+四阶段共用[入口](README.md)§1—§4的流程判定、资源优先级、路径基准及修改保护。先读本次选定根README／索引，再读实际阶段模板和作业提示词；项目自改根不被安装根接管。模板、提示词、共用合同是资源，项目已采用规范／契约是工程约束，业务清单只保存本次实际路径，三者不能相互替代。
+
+公共技术规约从索引辅助资源定位，按[采用说明](technical-baseline/README.md)优先复用既有规范；模板帮助核缺口，不强制另造总规约或预设技术栈／骨架。不把“未读”当“没有”，不把内容变更当必须恢复原件；适用冲突只限制依赖范围。辅助资源不是第五阶段，四阶段正文及原方法各自职责保持。
+
+JSON的字段、明确采用后创建／选用登记时点、失效／并发／失败恢复和手动兼容统一见[交接合同](handoff-contract.md)。当前三字段及选用登记修订未测试；旧S06最小登记记录保留；S07薄命令与Skill共用规则，完整改选／恢复仍留S08，原Plan／Build实际消费按本轮独立证据核验。无JSON可以直接手动传路径；只读作业不创建清单或改采用。标准任务不因安装、项目片段或JSON存在而加载企业SOP。
+
+## 11. 生命周期交接与读取完成
+
+review／recheck 的实质条款由[统一审查约定](review-handoff.md)逐条承接；只对已固定覆盖组合分开模型正文读集与外层元数据保护集，未知自改继续完整读选定合同。下文及既有跨文件引用中的通用加载要求按此分支理解，其余作业与实质约束不变。
+
+新增、修改、撤销和已实现功能退役统一读[生命周期合同](lifecycle-contract.md)。当前目标、任务状态与工程事实分别回读；部分撤销保留完整PRD，已完成任务保留，新退役通过新任务表达。JSON最小结构、手动路径、原Plan与Build边界不变，原型按需、TestCase为Plan可选输入。
+
+读取范围先按入口§3闭合：三份共用合同、本次阶段／动作、明确要求的辅助资料和必要业务依赖；只声明实际成功读取范围。缺项准确定位，不用更多未选资料填补。不以资源引用或自称“已读”代替工具轨迹；生成须在最后编辑后回读最终正文，独立只读审查保持人工处理空间。
+
+## B05-r2 最后修改后的全文回读
+
+全部Write／Edit结束后，必须使用读取工具分段完整覆盖最终目标正文，超出工具截断就续读剩余段。已全文读过但之后又Edit时，须再次完整覆盖最终稿，不能只回读改动行并声称“末次修改后全文已核”。本次必要输入清单中仍有未读／失败／部分读时，先报告准确缺口，不写成已全部读取；补读不是过去已读。
+
+未完成收尾就保留实际稿和未核范围，不删除稿件、不补造通过，不据此登记为已明确选用的输入。收尾不改写业务决定，不自动进入下一阶段；只读review／recheck依然零项目写入。
+
+## B05收口：来源与审查证据
+
+适用读集由任务、选定索引及必要约束共同确定；辅助模板和Plan不作统一前置，讨论其内容／任务影响／缺失事实则须读对应实际来源或标未核。三份共用合同、选定入口及本阶段资料按入口§3读取。现稿、目录列表和索引不能自行授予读取未选比较版本的范围。
+
+来源缺读不改成“不存在／未提供”，未知消费者不改成“没有消费者”，本次没有前稿不改成“所有历史都没有”。明确文件存在、是否选用、是否全文读取及结论覆盖范围，必要事实不足则保留Q。技术推导和字段建议维持候选性质，不冒称新增业务要求。
+
+审查每条发现及已核事实分别给目标／来源的实际路径、起止行和短原文摘录，再写理由、反例及最小建议。由外层[校验工具](verification/README.md)核实际读取覆盖与摘录对应；不把审查自报已读当工具证据。读取／摘录检查通过不证明推理成立；有据误报不采纳，记录不采纳依据，保留人工修订和Q。一次只审一个业务项目及主题，必要关联文档仍按实际影响读取，不混入其他独立案例。
+
+审查会话的结构以[输出契约](verification/review-output.schema.json)为准；使用外层校验先读其说明与契约，分别记录语法、结构、摘录和实际读取失败。存在原业务／旧审查／当前指令的角色歧义时，由调用者绑定实际路径并核角色证据；不改业务handoff字段、不照误报替换正确来源。仅格式与来源复核不扩大为业务重写，超过本次有界轮次仍失败交人工裁定，保留原生输出和原稿。
+
+角色表与模型作业Schema由同一自有build_review_schema(scope)生成并在实际CLI参数核对；普通引用省略role，不以资料性质描述代替绑定键。授权校订报告单独保存精确差异，用check_report检查内容，不冒充原生结果；原生check_review继续核载体、逐字引文与真实读取。详见[共用角色与校订规则](verification/README.md)。
+
+## 12. 原 Spec 与原生命令衔接
+
+四阶段起草／修订必须先成功加载原 i3-spec-driven-development Skill，按其外部格式与存储能力采用本次企业模板和唯一目标，保留澄清、内容、认可及保存后停轮。不是调用原 /i3-spec 包装并覆写其根 SPEC.md 要求，也不把 Spec 降为 using 按需选项。纯引导／状态／路径登记不生成规格。
+
+工程入口为选定主题 AD 及明确引用的 PRD、公共规范、共享契约、真实骨架／代码。入口与所选集合必须实际承接§4.1六项，不新增第五份核心规格；仅有 BRD、JSON 或链接不等于工程规格。原 Plan 支持 SPEC.md 或等效规格；仍产出 tasks/plan.md 和唯一任务目标，任务保留实际来源、需求／AC与验证依据。
+
+原 Build 按已获准任务施工；原 Build auto 继续核有效规格、Git基线、完整计划认可、逐任务测试／构建／提交及风险停点。位于 spec/ 只是满足其允许的存储位置，不能冒充内容完整。未提交的项目指引／JSON可能触发原Git停点，不能隐藏或擅自提交以规避。企业跨阶段 auto 仍不支持，原 Build auto 保持原有能力。
+
+按主题加载完整产品与技术范围、适用共享条款及必要依赖，不读全部候选／历史／未选主题。摘要只是导航；分段读取不保证总上下文减少。恢复时回读真实来源、计划、任务及Git状态，输入变化先核计划影响，不继承聊天中的旧批准。工程骨架由AD选型、Plan安排、获准Build应用验证，真实工程I4／I5仍需另验。
+
+## 12. 短入口与规划的共用边界
+
+brd／prd／ad／testcase短动作的缺口澄清遵守同一SOP Skill；四阶段生成／修订仍调用原Spec，不把所有SOP动作误归为规格生成。显式plan按[规划交接](plan-handoff.md)读取选定范围并加载原规划方法；两种入口共用，不复制一套算法。Plan只写原计划／唯一任务目标，不改本合同、业务稿或JSON。目标或前置决定不明时先等待，不按裸阶段名覆盖现稿。标准流程的实际项目规范仍适用，不因SOP文件存在切换流程。

package/references/enterprise-sop-resources/testcase/README.md

@@ -0,0 +1,61 @@
+# 企业 SOP · TestCase 阶段资源
+
+<!-- i3:zh-guide:start -->
+## 中文使用说明
+
+按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
+
+默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
+<!-- i3:zh-guide:end -->
+
+当前子包版本：0.3.4；模板内容版本沿本阶段manifest，正文不改。下文B05等旧版本文字保留为历史说明。
+
+审查加载分支：review／recheck完整读取本README、完整模板、唯一动作、实际业务与采用约束，依[统一审查约定](../review-handoff.md)由外层解析元数据并保留变化核对。下文涉及整套共用文件的加载要求在这两个动作按该分支理解；未知自改组合完整读选定原件，其余作业及实质条款保持。
+
+前版子包版本：0.3.1；模板内容版本：v0.0.4。状态：本地候选，尚未发布。完整[模板](templates/TestCase.md)和[共用合同](../template-contracts.md)用于明确任务，不新增Skill／命令／自动调度，原方法内容／工具／认可／停轮保留。
+
+从[入口](../README.md)和[阶段索引](../stages.json)选本阶段，按[清单](assets-manifest.json)定位[生成](prompts/01-generate.md)、[独立只读审查](prompts/02-review.md)、[明确委托修订](prompts/03-revise.md)、[独立只读复查](prompts/04-recheck.md)，四作业不自动串行。可复用方法：i3-documentation-and-adrs与测试设计内容检查，不是/i3-test执行任务；实际原生调用和读取分别取证。
+
+## 1. 本阶段输入与内容
+
+
+- §0.2、§6.1按路径、正文版本和条款固定本主题及必要关联组合；公共规范、共享契约／数据权威、提供消费AD、代码／服务／环境版本分别表达，不取最大版本、不强制同号或SHA256，不跨对象比较版本。
+- §3.3、§6.2核唯一业务状态／写入责任、可信租户和主体作用域、幂等重放与新请求的校验顺序、严格消费者及快照过期；产品预期直接核PRD，不复制AD遗漏，不自造正式业务决定。
+- §6.2—§6.4覆盖真实交接、拒绝／失败／UNKNOWN／重复／并发、回执查询、部分成功和恢复；核旧新组合、存量迁移／备份／不可逆限制、必要传递影响及既有行为回归，无关主题不机械改写／升版。
+- §7.1中TestCase是Plan的可选输入：需求、技术约束与验证要求足够即可规划，已有则读取，没有则安排补齐设计；未定判据只限制依赖任务，不取消SPEC六项、必要人审或执行前检查。
+- §0.2明确原test及Build复用TDD，可写测试和实现，不是只读文档生成；原代码review保留五维与临时变异验证，不整体套作零写入的文档review／recheck。本资源不实现JSON登记接点，不自动调用原入口或下阶段。
+- §8.1只定义未来报告的准确组合、实际候选／环境／数据、逐项结果、副作用与证据；替身不关闭必需真实集成，未运行不造runId成功／通过率，实际脚本、Plan、锁和工程未形成不登记未来路径。
+- 原型按需且可与AD并行；保留人工修改、原报告、业务Q、有据不采纳和明确委托修订；文档审查通过不替代代码审查或业务／发布认可。
+
+
+## 2. 来源与项目采用
+
+模板基于固定设计v0.0.2与前版分发v0.0.3保留完整正文，B03新增跨主题组合、共享责任、兼容迁移、传递影响、Plan可选输入及原test／review分工。维护来源／真实摘要在清单derivedFrom中标included:false，不要求业务用户读取开发目录。
+
+sourceSha256为源码字节，sha256为既有品牌流程分发字节，清单不算自身哈希。项目副本先检查目标和人工修改；明确采用的自改副本优先，当前local hash与发行来源分开，不强制恢复原件。模板版本、项目修订与业务版本分开，不猜最新或机械升版。
+
+## 3. 写入、人工修改与退出
+
+模型从已读项目约定整理准确输入／模板／唯一目标及缺口，用户不必填每个路径。目标已存在先读和保留旧稿，不覆盖未读人工内容；仅授权目标可写。最后编辑后回读，新增规范要求逐条回源，权限／状态一致，逐表核列数和列义。
+
+review／recheck在独立新上下文只读会话输出，审查者零项目写入，报告由获准调用者另存。人可自行修改、明确委托、有据不采纳或保持Q，修订不代答业务决定。
+
+候选完成汇报实际来源／目标、假设／Q、自查和未执行事项后交人工审阅并停轮，不自动其他文档、Plan、Build、测试执行、提交或发布。模板／包／安装／宿主读取／模型行为／业务人审分别记录，本文不宣称完整3.0或所有宿主通过。
+
+## 4. 验证与实施边界
+
+本次为TestCase自有资源及必要父级引用修订。CodeBuddy合成资料验证、原入口调用、工程测试、安装及业务认可分别取证；不把资料任务称为原test／review执行。原命令不天然读取企业用例或JSON，接点留后续S11验证。B02生成未通过记录仍保留，不以本次TestCase通过替代。
+
+## B05 变更交接规则
+
+B05当时资源子包0.3.0；本次增量见收口说明，模板正文和版本保持。按[入口](../README.md)§3列本次必要读取，实际读三份共用合同及本次唯一动作；[生命周期合同](../lifecycle-contract.md)统一新增、修改、撤销和退役，不新增命令、JSON程序或工程执行器。
+
+直接核PRD与AD；按真实目标更新新增／变更／撤销／保留预期，补停用／拒绝／替代、跨主题回归、迁移／恢复，不删失败降门槛，不编执行结果。原方法停点、只读审查与人工空间、候选／选择／Plan边界保留，项目副本升级不覆盖人工内容。
+
+## B05收口资源增量
+
+B05当时子包0.3.1，模板正文及版本不改。统一修订全文回读措辞、适用来源和单项目审查证据；外层校验见[说明](../verification/README.md)。不把辅助资料／Plan统一变前置，不自动改业务稿、JSON、任务或原版方法。旧验证与历史版本按当时对象保留。
+
+## 审查输出契约增量
+
+B05当时子包0.3.2；前述0.3.1为上一修订。增加[机器输出契约](../verification/review-output.schema.json)与外层错误分类、来源角色绑定和有界人工停点。格式／来源定向复核只更正会话报告，保留业务稿与真实发现；不宣称重新完成全业务审查，不自动运行下阶段。TestCase模板仍v0.0.4，原版test／review分工不变。

package/references/enterprise-sop-resources/testcase/assets-manifest.json

@@ -0,0 +1,111 @@
+{
+  "schemaVersion": 1,
+  "resourceId": "i3-enterprise-sop-testcase",
+  "resourceVersion": "0.3.4",
+  "status": "local-resources-only-not-released",
+  "stage": "testcase",
+  "documentType": "TestCase",
+  "source": {
+    "path": "references/i3-enterprise-sop/testcase/templates/TestCase.md",
+    "resourcePath": "templates/TestCase.md",
+    "templateVersion": "v0.0.4",
+    "sha256": "9b3d04762a37ca05f99567b2f1beb371f0d10a65e1c7ad1bdebbe6c9af71b914",
+    "role": "complete-document-template",
+    "distributionRendering": "Existing brand-reference mapping and standard Chinese guide; source and distribution digests are distinct."
+  },
+  "prompts": {
+    "generate": "prompts/01-generate.md",
+    "review": "prompts/02-review.md",
+    "revise": "prompts/03-revise.md",
+    "recheck": "prompts/04-recheck.md"
+  },
+  "dependencies": [
+    {
+      "path": "../template-contracts.md",
+      "role": "shared-contract",
+      "resolutionBoundary": "selected-enterprise-sop-root"
+    },
+    {
+      "path": "../handoff-contract.md",
+      "role": "shared-handoff-contract",
+      "resolutionBoundary": "selected-enterprise-sop-root"
+    },
+    {
+      "path": "../lifecycle-contract.md",
+      "role": "shared-lifecycle-contract",
+      "resolutionBoundary": "selected-enterprise-sop-root"
+    }
+  ],
+  "files": [
+    {
+      "path": "README.md",
+      "sourceSha256": "43b95ae0dfe006bd040619334921ba15bb648a0ef874c3cee86bf495db1da3b3",
+      "sha256": "aac1ddbb0b23b9e8a4b6b6a715b5e4ba0d64483fc92635dcc65de28965ee837c",
+      "role": "stage-guidance"
+    },
+    {
+      "path": "prompts/01-generate.md",
+      "sourceSha256": "13ba299911387ebaffdb70bb116767201eb7d7eb41b13bcd8e4aa805cf2b4a7b",
+      "sha256": "c3ec48a41faf1405a7b28e78aff9c4c7e46075767c91cb45377a566c4fb290c5",
+      "role": "stage-action-guidance"
+    },
+    {
+      "path": "prompts/02-review.md",
+      "sourceSha256": "eb78b1c515e720be6910ae7d08d0f3833959e9684159dfb978046ae266c93fd6",
+      "sha256": "7b8d6bc672bba40f191bc154efe48971024f988e990c4a5f9b0f3e2a9a8b3a26",
+      "role": "stage-action-guidance"
+    },
+    {
+      "path": "prompts/03-revise.md",
+      "sourceSha256": "431c75723c1d65739a85b500e6dcb5204d3d36c073d31983ff5ae42fb301d45e",
+      "sha256": "4412fe5b880e1025c77999866c9b58063a9f9d93b1c4fc2fb92c899ad6b1b588",
+      "role": "stage-action-guidance"
+    },
+    {
+      "path": "prompts/04-recheck.md",
+      "sourceSha256": "18555bad45f167ee121310b4e627549317d5bdeddf48596c16e05f8a98121b50",
+      "sha256": "3d81f78a3a18a76abed8e18e2771c64063b830c6c1aec10c2a454257201da758",
+      "role": "stage-action-guidance"
+    },
+    {
+      "path": "templates/TestCase.md",
+      "sourceSha256": "9b3d04762a37ca05f99567b2f1beb371f0d10a65e1c7ad1bdebbe6c9af71b914",
+      "sha256": "ffb317bb73397a350fbd0b98fa4bcb6c03773c223dd06fcf6c94420cba19cf6a",
+      "role": "complete-document-template"
+    }
+  ],
+  "derivedFrom": {
+    "path": "docs/sop-design/templates/TestCase.md",
+    "templateVersion": "v0.0.2",
+    "sha256": "3eb801b1712170fd2876ffa4231f68e86756413e50aa1b69c2c48f281285e428",
+    "included": false,
+    "role": "maintenance-provenance-only-not-runtime-dependency",
+    "changes": [
+      "distribution title",
+      "template version and status",
+      "package-contained shared-contract link"
+    ]
+  },
+  "projectDiscovery": {
+    "entryRelativeToReferences": "enterprise-sop-resources/README.md",
+    "stagesRelativeToEntry": "stages.json",
+    "ordinaryInstallEnablesEnterpriseWorkflow": false
+  },
+  "revision": "20261018-B03",
+  "revisionScope": "Cross-theme test design, original test/review boundaries, optional TestCase input to Plan; no original method or JSON implementation change",
+  "revisionProvenance": [
+    {
+      "path": "history/sop-design/20261018-before-b03-testcase-linkage/branches/prd-sop-resources-source/references/i3-enterprise-sop/testcase/templates/TestCase.md",
+      "templateVersion": "v0.0.3",
+      "sha256": "49256ce1479cad6fbc8f256e49806655e1a3c5d88e116b92de0547581e141afd",
+      "included": false,
+      "role": "immutable-maintenance-provenance-not-runtime-dependency"
+    }
+  ],
+  "validationBoundary": "Source hashes and pure brand-reference mapping; native resource tasks recorded separately; no original entry, npm, install or engineering claim",
+  "reviewOutputContract": {
+    "path": "../verification/review-output.schema.json",
+    "requiredFor": "outer-review-evidence-validation",
+    "businessTemplateChanged": false
+  }
+}