diff --git a/COMPATIBILITY.md b/COMPATIBILITY.md index c6fe281..310d532 100644 --- a/COMPATIBILITY.md +++ b/COMPATIBILITY.md @@ -78,7 +78,7 @@ portable/tested locally but the native platform lane has not run here; | Official stdlib public aliases (print de-magic; byte-identical output) | PASS | UNVERIFIED | UNVERIFIED | | Resource Provider v2 CLI (`--provider`/`--allow-provider`, worker helper) | PASS (linux/x86_64; real C sensor + helper) | **FAIL-CLOSED** (`ext.platform_unsupported`) | **UNSUPPORTED** | | Capability handler registry (`fs.read` handler, audit, unavailable) | PASS | UNVERIFIED | UNVERIFIED | -| External conformance repository (`marqdo-extension-conformance`, frozen CLI) | PASS (provisional development binary; release rerun pending) | UNVERIFIED | UNVERIFIED | +| External conformance repository (`marqdo-extension-conformance`, frozen CLI) | PASS (`--release` binary sha256 `28e3776d…`, fixture repo `e4b7352c…`; see `docs/evidence/extension/6a7bb983.../manifest.json`) | UNVERIFIED | UNVERIFIED | | Analysis v2 / Trace v2 + Python consumers | PASS | UNVERIFIED | UNVERIFIED | | Tool Protocol v1 + 3 independent consumers | PASS | UNVERIFIED | UNVERIFIED | | Native ABI (`plugin inspect`, trusted call) | PASS (C fixture) | UNVERIFIED (host-native fixture) | **UNSUPPORTED** | diff --git a/docs/STATUS.md b/docs/STATUS.md index 80ee12e..a68c38b 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -1,6 +1,7 @@ # Marqdo Implementation Status -Snapshot: **2026-11-21**, workspace version `0.1.0`, no release tag. +Snapshot: **2026-11-22**, workspace version `0.1.0`, no release tag. RFC-EXT-0001 +implementation evidence is bound to code SHA `6a7bb983c3b34fd0340afdcba9f197f7f50cba2a`. Current architecture overview: [`architecture/CURRENT.md`](architecture/CURRENT.md). Authoritative CI convergence plan: @@ -40,12 +41,15 @@ Implemented and tested in this tree (PR-00…PR-07; no release claim): | `marqdo.yaml.extensions` + lock v4 identity + `inspect --extensions`; CLI/manifest merge and conflicts | **IMPLEMENTED / TESTED** | `extension_selection` (13), `package_env`, package crate tests | | Capability handler registry; `fs.read` real handler; audit/unavailable | **IMPLEMENTED / TESTED** | `marqdo-host` `capability_handlers` (12) | | Official stdlib public aliases; print_override/AST scan/runtime branch removed | **IMPLEMENTED / TESTED** | `stdlib_alias_routing` (5), print/format/Trace goldens | -| Independent external repo + frozen-CLI suite (pure pinned Git, plugin, kernel, provider, tool) | **PASS against a development binary; release-binary rerun + SHA-bound manifest pending** | `/root/work/marqdo-extension-conformance` `tests/run_all.py`: all 7 categories PASS | +| Independent external repo + frozen-CLI suite (pure pinned Git, plugin, kernel, provider, tool) | **PASS on the frozen `--release` binary** | [`evidence/extension/6a7bb983.../manifest.json`](evidence/extension/6a7bb983c3b34fd0340afdcba9f197f7f50cba2a/manifest.json): all 7 required categories PASS; CLI sha256 `28e3776d…`, fixture repo `e4b7352c…` | -Evidence: [`evidence/2026-11-22-ext-implementation.md`](evidence/2026-11-22-ext-implementation.md) -and baseline [`evidence/ext-baseline-595279f.md`](evidence/ext-baseline-595279f.md). -The RFC-EXT-0001 release gate additionally requires a `--release` frozen-binary -rerun and `docs/evidence/extension//manifest.json` on the tagged commit. +Evidence: [`evidence/2026-11-22-ext-implementation.md`](evidence/2026-11-22-ext-implementation.md), +baseline [`evidence/ext-baseline-595279f.md`](evidence/ext-baseline-595279f.md), +and the frozen-binary manifest +[`evidence/extension/6a7bb983.../manifest.json`](evidence/extension/6a7bb983c3b34fd0340afdcba9f197f7f50cba2a/manifest.json). +The manifest is bound to code SHA `6a7bb98`; a tag on a later SHA must rerun +`tools/ci/verify_extension_contracts.py` on that SHA. Release decision remains +**DO NOT RELEASE** for the unchanged G3/G4/native reasons below. ## 0. Language migration completed (RFC-LANG-0002) diff --git a/docs/architecture/RFC-EXT-0001.md b/docs/architecture/RFC-EXT-0001.md index 7a6bcd3..1574fc3 100644 --- a/docs/architecture/RFC-EXT-0001.md +++ b/docs/architecture/RFC-EXT-0001.md @@ -1,6 +1,10 @@ # RFC-EXT-0001:Marqdo CLI 可扩展性闭环与第三方仓库彻底解耦实施规范 -> **状态:Proposed / 待实施。** 本文是下一阶段开发的**规范性任务书**,不是已实现能力说明。文中标注 `MUST` 的项目是必须达成的验收要求;`SHOULD` 为建议,偏离须写 ADR;`MAY` 为可选。本文同时给出架构、接口、程序顺序、负例、操作命令、交付物和退出条件。未明确授权修改仓库;实施者应以 PR 形式完成并保留全部证据。 +> **状态:Implemented(实现与证据已按本文件验收,见 §19)。** 本文同时保留为规范性任务书和验收记录;其中 `MUST` 项目已由 PR-00…PR-08 实现并测试。发布 tag 仍受仓库既有的 G3/G4/平台门禁与 Owner 批准约束,见 `docs/releasing.md`。 +> +> **实现基线:** `6a7bb98`(`feat/extensible-ecosystem`,2026-11-22,Linux x86_64)。实现与测试证据:`docs/evidence/2026-11-22-ext-implementation.md`;冻结 CLI 外部证据:`docs/evidence/extension/6a7bb983c3b34fd0340afdcba9f197f7f50cba2a/manifest.json`(CLI sha256 `28e3776d…`,fixture repo `e4b7352c…`,全部必需结果 PASS)。 +> +> **原始任务书文本保留如下。**文中标注 `MUST` 的项目是必须达成的验收要求;`SHOULD` 为建议,偏离须写 ADR;`MAY` 为可选。本文同时给出架构、接口、程序顺序、负例、操作命令、交付物和退出条件。未明确授权修改仓库;实施者应以 PR 形式完成并保留全部证据。 > > **固定审查基线**:`cflmy/marqdo-cli`,`master@595279fe38048b52b96d9ff1e7d57a867ec5c4c6`(2026-11-21 查验)。原仓库:https://github.com/cflmy/marqdo-cli 。如果开发开始时 HEAD 已移动,先按 §2 的盘点模板重新核对事实,不能把本文基线判断无条件套用到新 SHA。 > @@ -1163,3 +1167,28 @@ UNDECLARED ──(显式声明)──> DECLARED ──(校验签名/版本)─ **最终原则**:让外部库扩展的是**能力、算法、资源与可读知识制品**,而不是篡改 Marqdo 的唯一执行语义。以单一静态绑定与受控 Host 为中心,保证语言内核和独立生态在功能增加时不互相挟持。 --- + +## 19. Implementation record (2026-11-22) + +This section records the executed state. It does not tag a release or override +`docs/releasing.md`; the owner still decides tags/assets. + +| PR | State | Evidence | +|---|---|---| +| PR-00 baseline | done | `docs/evidence/ext-baseline-595279f.md` (fmt/clippy/test green at `595279f`) | +| PR-01/02 unique callable binding | done | `CallSiteKey`/`CallBindingTable`, one `bind_program_calls`, runtime dispatch by identity; `crates/cli/tests/callable_resolution.rs` 14 tests; `spec/callable-resolution.md`, ADR-0054 | +| PR-03 provider v2 CLI | done on linux/x86_64 | `crates/cli/tests/provider_cli.rs` 12 tests; `spec/resource-provider-v2.md`, ADR-0055; macOS/Windows FAIL-CLOSED | +| PR-04 extension selection/lock v4 | done | `extensions:` manifest block, lock v4 identity, `inspect --extensions`; `crates/cli/tests/extension_selection.rs` 13 tests; `spec/extension-selection.md`, ADR-0056 | +| PR-05 capability handlers | done | handler registry + real `fs.read`; `crates/marqdo-host/tests/capability_handlers.rs` 12 tests; ADR-0057 | +| PR-06 stdlib public aliases | done | verified `public_aliases`/`aliases_digest`; `print_override`/scan/runtime branch removed; `stdlib_alias_routing` 5 tests; ADR-0058 | +| PR-07 external consumers | done | separate repo `marqdo-extension-conformance` (pure pinned-Git lib, plugin, unknown kernel, provider v2, Analysis/Trace tool) + frozen-CLI suite | +| PR-08 release/docs convergence | implemented; release-tag rerun pending | workspace gate `599 passed / 67 targets`, fmt/clippy clean; evidence manifest bound to `6a7bb98`; the tag action itself requires owner approval and the unchanged G3/G4/native gates | + +Known deviations are recorded in `docs/evidence/2026-11-22-ext-implementation.md` +§4 (provider transport linux/x86_64 only; additive provider error codes; +analysis `calls[]` projection; no tag). + +**Do not treat this record as a release.** The release decision remains +`DO NOT RELEASE` until the remote G3 artifact and same-SHA mandatory lanes +exist; the external-extension manifest is an additional necessary gate, never a +substitute. diff --git a/docs/evidence/2026-11-22-ext-implementation.md b/docs/evidence/2026-11-22-ext-implementation.md index 79fbae3..a7fa3d0 100644 --- a/docs/evidence/2026-11-22-ext-implementation.md +++ b/docs/evidence/2026-11-22-ext-implementation.md @@ -195,10 +195,12 @@ against the frozen release binary after PR-04 lands. ## 4. Known gaps / deviations (not hidden) -1. **Frozen release evidence is not yet bound to a tagged SHA.** The external - suite PASSes against a `--release` build of this tree, but - `docs/evidence/extension//manifest.json` must be regenerated on the - final release commit and every mandatory result must be PASS there. +1. **Frozen release evidence is bound to code SHA `6a7bb98`, not to a tag yet.** + The external suite PASSes on the `--release` binaries + (`marqdo` sha256 `28e3776d…`) and the SHA-bound manifest exists at + `docs/evidence/extension/6a7bb983c3b34fd0340afdcba9f197f7f50cba2a/manifest.json` + (fixture repo `e4b7352c…`, all 7 categories PASS). A tag on a later SHA must + rerun the generator on that SHA; this document is not a release. 2. **Provider platform claims are Linux x86_64 only**; macOS/Windows are explicitly unsupported for the worker transport. The RFC's mac/Windows provider lanes are not claimed. diff --git a/docs/evidence/extension/6a7bb983c3b34fd0340afdcba9f197f7f50cba2a/manifest.json b/docs/evidence/extension/6a7bb983c3b34fd0340afdcba9f197f7f50cba2a/manifest.json new file mode 100644 index 0000000..91800f7 --- /dev/null +++ b/docs/evidence/extension/6a7bb983c3b34fd0340afdcba9f197f7f50cba2a/manifest.json @@ -0,0 +1,23 @@ +{ + "schema": "marqdo.extension-evidence", + "schema_version": 1, + "tested_sha": "6a7bb983c3b34fd0340afdcba9f197f7f50cba2a", + "cli_binary_sha256": "28e3776dd3d0ee9134323dd449edb9a7b5d2d8a5e6d3225845f54fc818397c74", + "fixture_repo_sha": "e4b7352c9213f8fa41bbab9f9da6aaf43eb8f929", + "os": "linux", + "arch": "x86_64", + "results": { + "callable_registry": "PASS", + "plugin_worker": "PASS", + "foreign_kernel": "PASS", + "resource_provider_cli": "PASS", + "package_pinned_git": "PASS", + "tool_analysis_consumer": "PASS", + "negative_security": "PASS" + }, + "commands": [ + "python3 /root/work/marqdo-extension-conformance/tests/run_all.py (cwd=/root/work/marqdo-extension-conformance)" + ], + "failures": [], + "unverified": [] +}