Files
marqdo-cli/docs/adr/README.md
T
cflmy 89555382e0 feat(ext): extension selection + lock v4, inspect --extensions (RFC-EXT-0001 PR-04)
- marqdo.yaml.extensions accepts only ./path or @alias/path, resolves to a
  regular file inside its owning package, never grants
- lock_version 4 records plugin/kernel/provider manifest+artifact identity;
  v3 requires explicit 'marqdo lock' migration; sync/check/run compare identity
- check stays static; run re-verifies artifact bytes; pure/strict refuse
- inspect --extensions reports declared/locked identity, plugin descriptors and
  stdlib aliases with authorization 'not_granted'
- black-box extension_selection suite (13) + package-layer tests; specs/ADR-0056
- workspace gate: fmt/clippy clean, 599 passed across 67 targets
2026-11-22 00:43:18 +08:00

47 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Architecture Decision Records (ADRs)
These files record decisions **at the date they were made**. They are not a
description of current language behavior, implementation state or current
architecture; read them as decision history.
- **Status is not a current-language claim.** A status such as "Accepted" means
the decision was accepted then, not that its syntax or behavior is still
active. Superseded ADRs keep their original decision text and date; they are
not rewritten.
- **Syntax-role decisions are superseded by
[ADR-0052](0052-unified-markdown-semantics.md).** The earlier mapping —
`Strong` executes, `Emph` returns, ordered list is a branch, bullet list is a
loop, block quote is a call, plus the associated `markdown.inert_executable` /
`markdown.invalid_construct` role diagnostics — is retired. The current
language contract is
[RFC-LANG-0002](../architecture/RFC-LANG-0002-unified-semantics.md), with its
normative summaries [`spec/mapping.md`](../../spec/mapping.md) and
[`spec/expression.ebnf`](../../spec/expression.ebnf): `@exec`/`@knowledge`
heading modes, `Strong`/`Emph`/inline `Code` as interchangeable
one-statement payload carriers, and `if`/`else`/`while`/`end`/`return`/
`params` keywords. The implementation is green at `ffd1cc9`; see
[`docs/STATUS.md`](../STATUS.md).
- **Infrastructure ADRs** (crates, ABI, capabilities, CLI/JSON contract,
packaging, security isolation) remain current unless a later ADR supersedes
them. ADRs with a historical banner keep the banner scoped to the superseded
part.
- This index is not a spec. For current architecture see
[`docs/architecture/CURRENT.md`](../architecture/CURRENT.md); for executed
status see [`docs/STATUS.md`](../STATUS.md).
Files: `0001`–`0050`, plus:
* `0051-byte-exact-http-framing.md` — HTTP framing;
* `0052-unified-markdown-semantics.md` — current language mapping;
* `0053-strict-child-inspection-and-json-failure-contract.md` — strict CI/JSON
failure contract;
* `0054-callable-binding-single-source.md` — one registry/binding pass and
runtime dispatch by identity;
* `0055-resource-provider-cli-v2.md` — `provider.json` v2 through the normal
CLI, worker trust boundary;
* `0056-extension-selection-locking.md` — `marqdo.yaml.extensions` and lock v4;
* `0057-capability-handler-registration.md` — declared capability vs installed
handler vs audit;
* `0058-stdlib-public-alias.md` — verified stdlib `public_aliases` replace
print magic.