Skip to content

E8(#5040 执行器):验收 —— showcase 端点回迁 /apps/showcase/… + RED-first e2e + 真实 boot 探针 + 升级文档安全复核 #5112

Closed

Description

@os-zhuang

Part of #5040(E 系列第 8 单,收尾件,v17 切版等本单绿)。Blocked-by: E7(翻转单)。

范围

  1. showcase 回迁:恢复被注释的 apis: 声明(声明式 apis:(ApiEndpoint)入站面全链路零执行:元数据装载成功、路由从未挂载、matchEndpoint 全仓无实现 #4936 时随硬拒注释),路径迁到命名空间前缀 /api/v1/apps/showcase/…,过 E7 的 publish 门;
  2. RED-first e2e:先写断言「声明的端点在真实 boot 上可达且语义正确」的失败测试,再让链条把它变绿 —— 覆盖:匹配命中执行(每种 target 类型至少一条)、authRequired: false 匿名可达 / 缺省需鉴权、rateLimit 429 + Retry-After、cacheTtl 响应头、未声明路径 404 形状与 声明式 apis:(ApiEndpoint)入站面全链路零执行:元数据装载成功、路由从未挂载、matchEndpoint 全仓无实现 #4936 前逐字节一致;
  3. 真实 boot 探针(参照 GET /openapi.json 有两个属主:rest-server 真serve,http-dispatcher 的 generateOpenApi 分支全仓无实现(ADR-0076 D1 影子重复) #5078 的实测纪律,curl 非 grep):boot showcase → 逐端点 curl 断言 + /api/v1/openapi.json 含端点条目(E6 enrichment 生效证明)+ 阴性对照;
  4. 升级文档安全复核(维护者裁决的落点):确认 upgrade-guide 中「审视历史 apis: 配置、尤其显式 authRequired: false」指引在场、准确、可被 AI 维护者据此执行 —— 按安全件验收,不是文案顺带;
  5. 覆盖真相:执行器代码「结构性不可达」豁免随本单终结,coverage 纳入正常门。

约束

执行器车道程序卡(session_01EYGdmvWP1ieZSLqvAW6uyd 按序派发),其它车道请勿认领;不改 content/docs/releases/。

关联:#5040 设计 §6/§7、E7 翻转单、#5078(boot 实测纪律先例)。

Activity

  1. added
    enhancementNew feature or request
    domain:cliRetired 2026-10-22, alias of domain:server (cli surface); in-flight cards keep it until they land
    pm:dispatchedDispatched to a dev agent by /pm-dispatch
    on Aug 4, 2026
  2. self-assigned this
    on Aug 4, 2026
  3. os-zhuang commented on Aug 4, 2026

    @os-zhuang
    ContributorAuthor

    认领(E8 收官) —— PM 会话 session_01EYGdmvWP1ieZSLqvAW6uyd(执行器车道),分支 claude/issue-5112-acceptance,与 E7b(#5189)并行派发。前置:E1–E7 全部落 main(翻转在 d21c001)。

    文件面声明(#4604,与 #5189 互斥):examples/app-showcase(apis: 回迁 + manifest.namespace)、e2e 测试面、真实 boot 探针脚本/测试、覆盖豁免终结。不碰 packages/metadata / packages/spec(#5189 的面)。

    验收注记:boot 断言只限端点条目,不因内建 $ref 悬空(存量 #5168)判失败;多租户交错验收点按 E5b 报告;composed-stack(设计 §7-7)如超范围如实报告留档。


    Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

domain:cliRetired 2026-10-22, alias of domain:server (cli surface); in-flight cards keep it until they landenhancementNew feature or request

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions