docs: v26.9 release notes + 07 doc v26.9 change section (en+zh)

Author: StarsailsClover

docs/en/07-mods-pack-structure.md

@@ -553,6 +553,18 @@ Extensions always load before mods. The Aprism core:
 4. Registers capabilities (`provides`).
 5. Only then begins the mod scan (Phase 2, Section 6.3).
 
+## 12.9 v26.9 changes
+
+- Optional root-level `aprismwarp.editor.json` is now part of the
+  packaging input. The catalog is declarative; Aprism runtime ignores it,
+  AprismWarp reads it without loading the extension jar. Legacy AEPs without
+  the catalog remain installable.
+- Extension manifest gains an optional `version` (SemVer) field used for
+  `depends` range matching. Omitting it preserves v26.8 behavior.
+- AprismPackagingExtension exposes `editorManifestFile`; AprismPackagingPlugin
+  wires it through to every `packageAep` task. See docs/release-notes/v26.9.md
+  for the full change set.
+
 ## 13. References
 
 - Document 1: Aprism Loader Overall Architecture Design

docs/release-notes/v26.9.md

@@ -0,0 +1,60 @@
+# v26.9 Release Notes
+
+> Aprism Loader v26.9 — AEP editor capability + extension version metadata
+> Author: BlockConnect@StarsailsClover
+> Status: DRAFT (v26.8-Alpha.8 in progress; final on v26.9 GA)
+
+## Overview
+
+The v26.9 line turns AprismWarp's read-only Node-side capability index
+into a backward-compatible, declarative AEP metadata field. The runtime
+AEP contract is unchanged: the editor catalog is optional, ignored by
+Aprism runtime, and safe to omit on any AEP produced before v26.9. The
+new metadata ships today in every Refract branch as part of the
+AEP-format-adaptation release (`fabric|neoforge|forge|quilt|liteloader/
+v26.9-Alpha.2`).
+
+## Alpha line
+
+### Alpha.1 — AprismWarp catalog opt-in (lives in Aprism v26.8-Alpha.8)
+
+- Optional root-level `aprismwarp.editor.json` accepted by the packaging
+  plugin. Schema: `aprismwarp.aep-editor/v1`. The catalog is a declaration
+  only; Aprism runtime ignores it, AprismWarp reads it without loading the
+  extension jar.
+- Extension manifests gain an optional `version` (SemVer) field, consumed
+  by Aprism runtime for extension dependency range matching. Omitted value
+  preserves v26.8 behavior.
+- AprismPackagingExtension exposes `editorManifestFile`; AprismPackagingPlugin
+  wires it through to every `packageAep` task. Legacy AEPs without the
+  catalog remain installable.
+- PackageAepTaskTest covers: root `aprism.extension.json` present, root
+  `aprismwarp.editor.json` present, embedded extension jar present.
+
+### Alpha.2 — Refract adoption (v26.9-Alpha.2)
+
+All five Refract branches emit the editor catalog in every variant and
+declare an extension self-version. Upstream SDK document updated with the
+catalog rules and the Gradle DSL configuration
+(`aprismPackaging.editorManifestFile`).
+
+- 32/32 AEP variants structurally validated (root manifest + root editor
+  catalog + one embedded jar).
+- Five workflow_dispatch runs published five Pre-Releases with cosign
+  keyless signatures and CycloneDX SBOMs.
+
+## Verification
+
+- Aprism TestKit: PackageAepTaskTest green.
+- AprismWarp: read-only Node ZIP inspector exercises the new protocol.
+- AprismRefract: 32/32 structural validation via JDK `jar tf`; all five
+  dispatch runs succeeded; one downloaded `Fabric-Support-...-26.2.aep`
+  contains the expected three root entries.
+
+## Known issues
+
+See docs/en/09-known-issues.md. Notable: editor catalog is purely
+declarative (no executable content); AprismWarp GUI palette integration and
+`.awp` lock consumption remain future work.
+
+<!-- GitHub@NDBlockConnect | BlockConnect@StarsailsClover -->

docs/zh/07-模组包结构.md

@@ -548,6 +548,17 @@ Fabric-Support-A[26.0,27.0)-Fa[0.16,0.17)-JE-1.21.4.aep   (ZIP container)
 4. 注册能力（`provides`）。
 5. 然后才开始模组扫描（阶段 2，第 6.3 节）。
 
+## 12.9 v26.9 变更点
+
+- AEP 根级可选 `aprismwarp.editor.json` 已纳入打包输入。该目录为声明式；
+  Aprism 运行时忽略，AprismWarp 在不加载扩展 jar 的前提下读取。不带该目录
+  的旧版 AEP 仍然可安装。
+- 扩展清单新增可选 `version`（SemVer）字段，用于 `depends` 范围匹配。
+  缺省保留 v26.8 行为。
+- `AprismPackagingExtension` 暴露 `editorManifestFile`，由
+  `AprismPackagingPlugin` 透传到每个 `packageAep` 任务。完整变更见
+  docs/zh/release-notes/v26.9.md。
+
 ## 13. 参考资料
 
 - 文档 1：Aprism Loader 总体架构设计

docs/zh/release-notes/v26.9.md

@@ -0,0 +1,49 @@
+# v26.9 Release Notes
+
+> Aprism Loader v26.9 — AEP 编辑器能力目录 + 扩展版本元数据
+> 作者：BlockConnect@StarsailsClover
+> 状态：草稿（基于 v26.8-Alpha.8 路径，v26.9 GA 前可能修订）
+
+## 概述
+
+v26.9 线把 AprismWarp 的只读 Node 端能力索引，落地为一个向后兼容、声明式的 AEP 元数据字段。运行时 AEP 契约不变：编辑器目录是可选的，Aprism 运行时忽略它，v26.9 之前产出的任何 AEP 不带它也仍然可安装。新元数据今天已随 AEP 格式适配发布出现在所有 Refract 分支（`fabric|neoforge|forge|quilt|liteloader/v26.9-Alpha.2`）。
+
+## Alpha 线
+
+### Alpha.1 — AprismWarp 目录接入（存在于 Aprism v26.8-Alpha.8）
+
+- 打包插件接受根级可选的 `aprismwarp.editor.json`，schema 为
+  `aprismwarp.aep-editor/v1`。该目录只是声明：Aprism 运行时忽略，
+  AprismWarp 在不加载扩展 jar 的前提下读取它。
+- 扩展清单新增可选 `version`（SemVer）字段，由 Aprism 运行时用于
+  扩展依赖范围匹配。缺省保留 v26.8 行为。
+- `AprismPackagingExtension` 暴露 `editorManifestFile`，由
+  `AprismPackagingPlugin` 透传到每个 `packageAep` 任务。旧版无该目录
+  的 AEP 仍然可安装。
+- `PackageAepTaskTest` 覆盖：根 `aprism.extension.json` 存在、根
+  `aprismwarp.editor.json` 存在、内嵌扩展 jar 存在。
+
+### Alpha.2 — Refract 适配（v26.9-Alpha.2）
+
+所有五个 Refract 分支在每个变体里都附带编辑器目录，并声明扩展自身版本。
+上游 SDK 文档已补充目录规则与 Gradle DSL 配置
+（`aprismPackaging.editorManifestFile`）。
+
+- 32/32 个 AEP 变体通过结构校验（根清单 + 根编辑器目录 + 一个内嵌 jar）。
+- 五次 workflow_dispatch 全部成功，发布 5 个 Pre-Release，附带 cosign
+  keyless 签名与 CycloneDX SBOM。
+
+## 验证
+
+- Aprism TestKit：`PackageAepTaskTest` 通过。
+- AprismWarp：只读 Node 端 ZIP 检查器演练新协议。
+- AprismRefract：通过 JDK `jar tf` 完成 32/32 结构校验；五次 dispatch
+  运行全部成功；一份下载的 `Fabric-Support-...-26.2.aep` 含预期三
+  个根条目。
+
+## 已知问题
+
+详见 docs/en/09-known-issues.md。提示：编辑器目录是纯声明（无可执行内容）；
+AprismWarp GUI 面板集成与 `.awp` 锁定消费仍是未来工作。
+
+<!-- GitHub@NDBlockConnect | BlockConnect@StarsailsClover -->