- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
3.7 KiB
Executable File
3.7 KiB
Executable File
ADR 0007:Web Document / Endpoint / Resource(破坏性 · 代码即文档)
| Status | Accepted |
| Date | 2026-09-28 |
| Related | ext-web-artifact.md · ext-web.md · binding.md · ADR 0006 · layers.md · doc/next/007.md |
Context
ext/web/web.mq.md已膨胀为小型 Web Framework(Page God Object、configure垃圾抽屉、碎片 Table DSL、隐式路由),与 Marqdo「代码即文档」冲突。- doc/next/007.md 提出 Document / Endpoint / Resource 三原语与拆分
ext/web·ext/net·ext/data·ext/security。 - 现行 ext-web.md C1 禁止为 web 改核心;Document/Endpoint 装载识别需要 Language/Runtime 参与(复用 Artifact Metadata
type,不新增 CORE_CONSTRUCTS 标记)。 - Binding(ADR 0006)已提供文件级 Metadata;
type: prompt先例在扩展侧消费 metadata。
Decision
- 采纳 Document / Endpoint / Resource 为 Web 模型一等公民;正式规范见 ext-web-artifact.md。
- 修订 ext-web C1:允许核心在装载期识别
type: web|endpoint(及中文类型: 网页|端点)并暴露 artifact 分类;装配 / HTTP / DB 语义仍在 ext + plugin。单元格求值、import 句法、CORE_CONSTRUCTS 计数不变。 - 文件级 Artifact only:不在
##函数体嵌套---frontmatter(与 Binding Phase 1 / 解析器一致)。 - 破坏性重写作者面:删除
compose_*碎片 DSL、god# page变异堆、app.configure多参数抽屉、作者ensure_plugin;examples 与tests/ext/web*同步重写。 - 目录定稿(007 §三十五 + §四十):
ext/web/— page · route · component · dom · client · facadeext/net/— http · websocket · urlext/data/— db · cache · storageext/security/— auth · oidc · rbac
- 统一 View 表:
| type | slot | value | attrs | style |;Table = Data,禁止每函数私有方言。 - declared vs system routes:用户 route 须声明;
/_part·/_form等为 system,经web.inspect可见。 - import = capability:
import web:…由 facade 自动加载 native plugin;作者程序不写ensure_plugin/host_*。 - Metadata v1 锁定(原 007 未决项):
- 发现:
web.serve root=扫描root/**/*.mq.md,仅注册type/类型∈ {web,网页,endpoint,端点} 的文件;无 type 的库文件忽略。 - Data:仅 flat 键
data_source·data_order·data_where(text;where 为col=val逗号分隔)。嵌套 YAMLdata:推迟。 - Result:
{ok: bool, value: any, error: text|None}。 - Realtime 模块名:
ext/net/websocket.mq.md(ZH:实时.mq.md)。 - ZH metadata:
类型←type,路由←route,方法←method,路径←path,请求←request,响应←response,鉴权←auth,数据源←data_source,排序←data_order,条件←data_where。
- 发现:
Consequences
Positive
.mq.md同时是文档、路由、实现与鉴权声明。- 与 LLM/Agent Artifact Metadata 统一心智。
- 职责边界清晰,可独立演化 data/security/net。
Negative / Risks
- 破坏性:全部现有 web 作者程序与 smokes 必须改写。
- Endpoint 热路径仍经 plugin →
CallLibPath/ 文件装载回调;须保持 ABI 稳定演进。 - flat data 键表达力弱于嵌套 YAML;后续另 ADR。
Neutral
- 不新增 Markdown 核心标记;
${…}仍仅 Metadata。 - Go
plugins/web可分波删除死 compose ABI;作者面先断。