- 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。
1.9 KiB
Executable File
markup, title, description
| markup | title | description |
|---|---|---|
| occlusion | AI-native loop (contracts + MLSP) | Progressive contracts, structured diagnostics, and the Marqdo Language Server for AI |
main
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | None; execute this page's documented steps in order and observe their output or stated effects |
Milestone (v1.1.0): the AI-native loop — so an AI can verify Marqdo, not just write it.
Three pieces. A core surface guard (doc/design/core-surface.md) pins the 19 core constructs, so a single-sided change (list / doc / golden sample) turns CI red. Progressive contracts are optional 参数 / 返回 / 字段 tables embedded in the narrative, checked at four boundaries: call argument, return, table bind, key access. MLSP for AI (marqdo mlsp) is a line-delimited JSON language service; the AI queries syntax on demand instead of memorizing the whole grammar.
Static contract check:
marqdo check tests/contracts/ok_contract.mq.md
Structured diagnostics — errors as data:
marqdo run tests/structure/hello.mq.md --json
Query syntax on demand (MLSP):
printf '%s\n' '{"id":1,"method":"syntax","params":{"query":"返回"}}' | marqdo mlsp
MLSP methods: locate (find a symbol / construct card), syntax (rule text + sample + doc anchor), validate (structured diagnostics), repair_targets (bounded span), repair_apply (bounded line edits, out-of-scope refused), schema (contract of one unit).
We now [Display this step's result](> print text="Contracts are optional: with no contract table, a file stays fully dynamic.").
We now [Display this step's result](> print text="Diagnostics carry code, severity, suggestion, doc_anchor and doc_quote.").
We now [Display this step's result](> print text="MLSP syntax cards embed the rule text and a sample, so AI need not pre-learn the grammar.").
See validation results: doc/roadmap/perf-validation-report-2026-09-23.md.