diff --git a/.cursor/skills/marqdo/SKILL.md b/.cursor/skills/marqdo/SKILL.md index 77843c8..ac18502 100644 --- a/.cursor/skills/marqdo/SKILL.md +++ b/.cursor/skills/marqdo/SKILL.md @@ -55,24 +55,24 @@ Canonical design (repo): `doc/design/markdown-mapping.md`, `doc/design/keywords. | `**…**` | Return value — closing `**` touches last token, **no trailing space**; bare ids are variables | | `****` or `**` + spaces + `**` | Return `None` and end function body | | Lone `---` / `***` | Markdown thematic break (skip; not function end) | -| GFM table after empty RHS bind | Collection; get with `[key](coll)` (preferred) or legacy `` `m`[^key] `` | -| `- [item](coll)` | Foreach (unchanged) | +| GFM table after empty RHS bind | Collection; get with `access(coll, "key")` (legacy `` `m`[^key] `` remains available) | +| `- [item](遍历 coll 为 item)` | Foreach | | `` ```lang `` | Foreign code block (via `lib/foreign`) | | `` `"text"` `` | Quoted string (`\n` `\t` `\\` `\"`; `` `var` `` inside); bare tokens unescaped | | Unmarked prose | Comment | Entry: load file (often `index.mq.md`) → collect defs → run `# main`. -## Occlusion syntax (v2.0.0) +## Occlusion syntax (v2.1.0) -A file with frontmatter `markup: occlusion` (or `标记: 遮蔽`) reads `[x](y)` as **occlusion**, not index — in that file only (`MARQDO_MARKUP=occlusion` sets the process default; classic files are unchanged). +Occlusion is the default syntax. Shipped source declares `markup: occlusion` (or `标记: 遮蔽`) explicitly so imports stay deterministic. Legacy `[key](collection)` requires `markup: classic` or the one-cycle CLI flag `--legacy-markup`; `MARQDO_MARKUP` does not change parsing. - `[描述](实现)` — `[]` is prose (never executed); `()` is the **only** executed part. -- `[顾客留存率](0.42)` · `[总价](at(价目表, "苹果") * 数量)` · `[功能开发中]()` → `None` (stub; `label.empty_payload` warning). +- `[顾客留存率](0.42)` · `[总价](access(价目表, "苹果") * 数量)` · `[功能开发中]()` → `None` (stub; `label.empty_payload` warning). - Read maps/lists with `access(集合, 键)` (aliases `取` / `取值`): `[第二项](access(列, 2))`. - Foreach: `- [篮子里的每个果子](遍历 篮子 为 果)` (accepts `遍历`/`for` and `为`/`as`/`in`). - Calls inside `()`: `加(1)` / `加(1, 2)` / `加一 号(31)` / `txt.str_trim(" x ")` — `)` terminates, commas optional. -- Tooling: `marqdo labels pending` (stub ledger) · `marqdo labels --grep 词 --count` · `marqdo migrate labels . --write` · `marqdo check` reports `label.missing` / `label.empty_payload` / `label.ref_dangling`. +- Tooling: `marqdo labels pending` (stub ledger) · `marqdo labels --grep 词 --count` · `marqdo migrate labels . --mark --write` · `marqdo check` reports `label.missing` / `label.empty_payload` / `label.ref_dangling`. ## Minimal program diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index da2b5b1..2d1ca25 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -126,9 +126,9 @@ jobs: ## Marqdo ${{ github.ref_name }} ### 亮点 / Highlights - - **v2.0.0**:遮蔽语法——`[描述](实现)` 描述不执行 · `()` 内调用 · `access` 取元 · 遮蔽循环 · `labels` / `migrate labels` · view 桩徽章 - - **v2.0.0**: Occlusion syntax — `[label](payload)` inert prose, paren calls, `access`, occlusion loops, `labels` / `migrate labels`, view stub badges - - **v2.0.0 ext**:扩展包同步 2.0.0 / Ext pack 2.0.0 + - **v2.1.0**:文件级 Occlusion 默认语义——全仓迁移 · `migrate labels --mark` · `access` / `遍历` · 可执行知识语义投影 + - **v2.1.0**: File-scoped Occlusion by default — corpus migration, `migrate labels --mark`, `access` / `for`, executable-knowledge projections + - **v2.1.0 ext**:扩展包同步 2.1.0 / Ext pack 2.1.0 - **v1.5.2**:外联 v3 P0/P1——raw stdin + 每 cell 输入 · plan API · snapshot · `view capture` · Persist - **v1.5.2**: Foreign v3 P0/P1 — raw stdin + per-cell inputs, plan API, snapshot export/import/replay, `view capture`, Persist - **v1.5.2 ext**:扩展包同步 1.5.2 / Ext pack 1.5.2 diff --git a/CHANGELOG.md b/CHANGELOG.md index 0f74b79..45796f7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -41,7 +41,18 @@ marqdo ext add web # CDN → 2.0.0 - **语料迁移(M7)**:`public/` `ext/` `tests/` `examples/` `doc/` 等语料加 `markup: occlusion`,改写 **80 个语料文件 / 256 处取元 / 23 处循环**;新增 `tests/ratchet` 锁定标签债务。 - **文档**:遮蔽语法总纲 + M0–M10 变更记录、标签新鲜度 / 修复回路、函数作为值 6 篇评估、代码体量审计;`doc/design/code-volume-audit.md` 记 53k 行构成。 -## Unreleased +## v2.1.0 — 2026-10-23 + +### Highlights + +**文件级可执行知识语义**:标准库、扩展库、示例与公开文档全部采用显式 `markup: occlusion`;`[描述](实现)` 成为默认链接语义,`access` 与 `遍历` 承担原有取元与循环职责。迁移工具可离线证明语法形状等价,Tree 与 Bytecode 均完成全量回归。 + +```bash +git checkout v2.1.0 && cargo build --release +marqdo ext add web +``` + +**核心表面 Δ**:默认链接语义从 Classic 切换到 Occlusion。未迁移的旧 `[键](集合)` 仅可用 `markup: classic` 或一个版本周期内的 `marqdo run --legacy-markup` / `check --legacy-markup` 执行。 ### Added @@ -56,6 +67,8 @@ marqdo ext add web # CDN → 2.0.0 - 未标注源码默认采用 Occlusion。Classic 仅能通过明确的 frontmatter 或 `--legacy-markup` 进入,避免同一文档因进程配置而静默改变含义。 +## Unreleased + ## v1.5.2 — 2026-10-18 ### Highlights diff --git a/Cargo.lock b/Cargo.lock index 14cf5d8..d3164fe 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -572,7 +572,7 @@ checksum = "0ceec5bc11778974d1bcb055b18002eba7f4b3518b6a0081b3af5f21666da9ad" [[package]] name = "marqdo" -version = "2.0.0" +version = "2.1.0" dependencies = [ "anyhow", "assert_cmd", @@ -610,7 +610,7 @@ dependencies = [ [[package]] name = "marqdo-wasm" -version = "2.0.0" +version = "2.1.0" dependencies = [ "marqdo", "serde_json", diff --git a/Cargo.toml b/Cargo.toml index a89dfea..4139e34 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "marqdo" -version = "2.0.0" +version = "2.1.0" edition = "2021" license = "Apache-2.0" description = "Marqdo — Markdown markers as an interpreted programming language" diff --git a/README.md b/README.md index c37eef3..b70c522 100644 --- a/README.md +++ b/README.md @@ -34,14 +34,14 @@ Marqdo 把 Markdown **标记当作编程语法**:同一个 `.mq.md` 文件, | **表格即数据结构** | 程序的数据结构直接就是文档的数据结构:单列竖表 → `List`;横表(1 数据行)→ `Map`;横表(多数据行)→ `Map` of `List`(列向聚合);首列写 `@` / `行` / `row` → 行向记录 `List` of `Map`。取元使用 `access(集合, "键")`,链接 `[描述](表达式)` 只承载叙述与执行体。这是 literate programming 的下一步。 | | **语义干净** | **返回是架构,打印只是函数**:`*…*` 改变控制流,`print` 只是副作用函数;分支与循环长在 Markdown 结构上(`1.` `2.` 递增 = 分支,`-` = 循环),不是所有列表都被粗暴当成 if。 | | **AI 的可靠上下文与长期记忆** | 一个 `.mq.md` 同时是 documentation + schema + code + examples + knowledge + executable behavior;AI 不必再拼装 README + OpenAPI + JSON Schema + prompt。整个工程天然就是 AI 的**世界模型**——比 RAG 更接近 Executable RAG。 | -| **链接即调用**
Link as Call | 文档里的 `[描述](类.函数)` 不是装饰,是跨文档类调用;编译器解析类/函数并返回 **LinkInfo**,`view` 显示调用点,EKC 建边,`links.lock` 可选复现。**v2.1 设计目标**;v2.0.0 已具备本地表达式链接与 `import` + 实例调用。 | +| **链接即调用**
Link as Call | 文档里的 `[描述](类.函数)` 不是装饰,是跨文档类调用;编译器解析类/函数并返回 **LinkInfo**,`view` 显示调用点,EKC 建边,`links.lock` 可选复现。**v2.1 已实现可执行知识基础设施**。 | | **完整工程,不是玩具** | Rust 正经解释器(词法 / 语法 / 语义 / 树遍历 + 字节码后端)、stdlib、模块与对象、debugger、viewer、catalog、WASM、原生插件 ABI、VS Code 扩展、agent / LLM / MCP。 | --- ## 链接语法:链接即调用(v2.1 设计声明) -> **这是 v2.1 的设计目标,不是 v2.0.0 的全部现状。** +> **这是 v2.1 的可执行知识模型。** > `[]()` 不新增语法:`[]` 是 Markdown 链接的描述;`()` 是**已有代码**,与 `**代码**` 同权。 > `#` 是类,`##` 是函数;`类.函数` 是**类调用**。 > 链接只是给这次调用一个名字;`view` 显示调用信息,编译器返回 **LinkInfo**,EKC 建边。 @@ -91,7 +91,7 @@ Marqdo 把 Markdown **标记当作编程语法**:同一个 `.mq.md` 文件, ### 现状与目标 -| 能力 | v2.0.0 当前 | v2.1 目标 | +| 能力 | v2.0.0 | v2.1 | |------|-------------|-----------| | 本地表达式链接(遮蔽) | ✅ `markup: occlusion` | ✅ | | `()` 与 `**代码**` 同权 | ✅ 表达式/调用 | ✅ | @@ -113,7 +113,7 @@ Marqdo 把 Markdown **标记当作编程语法**:同一个 `.mq.md` 文件, > `# 李白 = > 诗人` 语法上是继承/特化,语义上是「李白是诗人」的知识个体; > 运行时实例仍是 `> 诗人` / `> 李白`。详见 [knowledge-layers.md](doc/design/knowledge-layers.md)。 -**当前可运行**的等价写法(v2.0.0):见 [examples/link-syntax/main.compat.mq.md](examples/link-syntax/main.compat.mq.md)。 +兼容迁移示例见 [examples/link-syntax/main.compat.mq.md](examples/link-syntax/main.compat.mq.md)。 设计宪法:[doc/design/link-syntax.md](doc/design/link-syntax.md) · 链接示例:[examples/link-syntax/](examples/link-syntax/) · 知识分层示例:[examples/knowledge-layers/](examples/knowledge-layers/) · 证据复核:[occlusion-vs-executable-knowledge-2026-10.md](doc/research/occlusion-vs-executable-knowledge-2026-10.md) @@ -222,7 +222,7 @@ Marqdo 允许你写出"还没接通"的代码——**只要写在描述里**。 `[]` 里是**自由描述**(不执行);`()` 里是**目标**(唯一执行)。这条语法叫**链接语法**: 目标是本地表达式时,就是**遮蔽**(把代码折叠在括号里);目标是 `类.函数` 时,就是**跨文档类调用**。 -v2.0.0 已实现前者;后者是 v2.1 目标(见 [link-syntax.md](doc/design/link-syntax.md))。 +v2.1 实现了文件级链接语义与可执行知识投影(见 [link-syntax.md](doc/design/link-syntax.md))。 **四条约定** @@ -281,9 +281,9 @@ marqdo catalog public -o .marqdo --- -## 现状(v2.0.0) +## 现状(v2.1.0) -- **链接语法(v2.0.0 本地表达式链接;v2.1 目标:`类.函数` 跨文档类调用)**:`[描述](目标)` 描述不执行 · `()` 与 `**代码**` 同权(`加(1)` / `加一 号(31)`)· `access` 取元与 `遍历` 链接循环 · `marqdo labels` 两级检索 / `--baseline` 债务棘轮 · `migrate labels` · 诊断 `label.*` · view 描述正文 + 代码片 + 桩徽章 · **设计声明 [link-syntax.md](doc/design/link-syntax.md)**(`类.函数` / LinkInfo / 链接图 / lock 为 v2.1 目标) · 扩展包同步 **2.0.0** +- **链接语法(v2.1.0)**:`[描述](目标)` 描述不执行 · `()` 与 `**代码**` 同权(`加(1)` / `加一 号(31)`)· `access` 取元与 `遍历` 链接循环 · `marqdo labels` 两级检索 / `--baseline` 债务棘轮 · `migrate labels --mark` · 诊断 `label.*` · view 描述正文 + 代码片 + 桩徽章 · **可执行知识 [link-syntax.md](doc/design/link-syntax.md)**(项目索引、LinkInfo、链接图与 lock) · 扩展包同步 **2.1.0** - **外联 v3 P0/P1(v1.5.2)**:raw stdin + 每 cell 独立输入 · plan API · snapshot export/import/replay · `view capture` · Persist 按钮 · 扩展包同步 **1.5.2** - **view 静态/动态统一 + 外联值传递(v1.5.1)**:静态导出与 live view 共用 `foreign_doc` 执行路径 · 构建时运行注入 stdout · `foreign.session` 值传递 · cell stdin;扩展包同步 **1.5.0** - **裸自增升参(v1.4.6)**:首次粗体赋值左值即声明;`**n = n + 1**` 无反引号也升为必选形参。扩展包仍为 **1.4.5** @@ -319,7 +319,7 @@ marqdo catalog public -o .marqdo - **浏览器 Marqdo(WASM)**:`marqdo wasm build` + 官方 bridge 自启(作者零业务 JS;桥内可含列表/路由/storage/ws/文件/Canvas/音频/Observer/拖放);`lib/browser` + GFM;`web.client_embed`;示例 [browser-hello](examples/browser-hello/) · [browser-app](examples/browser-app/) · [browser-media](examples/browser-media/) · [web-client-site](examples/web-client-site/)([ADR 0002](doc/adr/0002-browser-marqdo-wasm.md) · [D](doc/roadmap/browser-wasm-d.md) · [E](doc/roadmap/browser-wasm-e.md) · [F](doc/roadmap/browser-wasm-f.md)) - 选型:[ADR 0001 — Rust](doc/adr/0001-implementation-language.md) · [ADR 0002 — 浏览器 WASM](doc/adr/0002-browser-marqdo-wasm.md)(C0–C5 完结,见 [roadmap/browser-wasm.md](doc/roadmap/browser-wasm.md))· [ADR 0003 — 异步效应](doc/adr/0003-browser-async-effects.md) -### 如何使用最新 Marqdo(v2.0.0) +### 如何使用最新 Marqdo(v2.1.0) **安装解释器(任选其一)** @@ -334,7 +334,7 @@ marqdo catalog public -o .marqdo ```bash # 1) 源码安装(跟 tag 或 main) git clone https://github.com/cflmy/marqdo.git && cd marqdo -git checkout v2.0.0 # 或留在 main +git checkout v2.1.0 # 或留在 main cargo build --release export PATH="$PWD/target/release:$PATH" marqdo version @@ -373,7 +373,7 @@ marqdo wasm build # → dist/wasm/ … 见 examples/browser-hello/ # 6) Releases:Windows exe/zip/vsix;Linux CLI zip + native `.so` zip -# https://github.com/cflmy/marqdo/releases/tag/v2.0.0 +# https://github.com/cflmy/marqdo/releases/tag/v2.1.0 ``` 开发期也可用 `cargo run -- …` 代替已安装的 `marqdo`: diff --git a/crates/marqdo-wasm/Cargo.toml b/crates/marqdo-wasm/Cargo.toml index 14aa363..f9e84bb 100644 --- a/crates/marqdo-wasm/Cargo.toml +++ b/crates/marqdo-wasm/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "marqdo-wasm" -version = "2.0.0" +version = "2.1.0" edition = "2021" license = "Apache-2.0" description = "Marqdo interpreter as WebAssembly (browser host bridge)" @@ -12,4 +12,4 @@ crate-type = ["cdylib", "rlib"] [dependencies] marqdo = { path = "../..", default-features = false, features = ["wasm-core"] } -serde_json = "1" \ No newline at end of file +serde_json = "1" diff --git a/debian/changelog b/debian/changelog index f436d99..1685bbf 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,10 @@ +marqdo (2.1.0-1ppa1) noble; urgency=medium + + * Marqdo 2.1.0: file-scoped Occlusion is the default syntax; migrated + standard/extension libraries and executable-knowledge projections. + + -- cflmy Fri, 23 Oct 2026 12:00:00 +0000 + marqdo (2.0.0-1ppa1) noble; urgency=medium * Marqdo 2.0.0: Occlusion syntax — [description](payload), where the diff --git a/ext/VERSION b/ext/VERSION index 227cea2..7ec1d6d 100644 --- a/ext/VERSION +++ b/ext/VERSION @@ -1 +1 @@ -2.0.0 +2.1.0