From 4082b88010dcf7971dde8e749c6b68e7f9d15327 Mon Sep 17 00:00:00 2001 From: Dan Powers Date: Fri, 5 Jun 2026 12:36:13 -0500 Subject: [PATCH] docs: v1.0 stragglers (ROADMAP twelfth flip, programmatic.md backend count, spec/31 era) Three quick copy flips the post-v1.0 documentation staleness scan surfaced that didn't make it into the PR #334 /ship + /document-release sweep. All doc-only; no code, no tests, no version bump. - ROADMAP.md lines 8-17: section header reframed from "remaining backend protocols" to "backend protocols shipped"; "Eleven of twelve" flipped to "Twelve of twelve"; MCPServerRegistryBackend added to the list; table Status flipped from "Planned" to "Shipped (v1.0.0)"; footer reframed from future-tense to PyPI-install present-tense. - docs/deployment/programmatic.md lines 727-735: backend count flipped Eleven to Twelve; MCPServerRegistryBackend added to the parenthetical list; "one remains for v1.0" clause removed; numbered spec list extended to include spec/36. - docs/spec/31-llm-backend.md line 3: status line "as of v0.13 era" updated to "as of v1.0". CHANGELOG [Unreleased] gets a brief Documentation note pointing back to this sweep. These are the only stale references the audit found across 90+ markdown + 5 HTML/SVG explainer artifacts. All other v1.0-relevant docs were already updated in PR #334 (the v1.0 release PR) or by the document-release subagent during the v1.0 ship. Co-Authored-By: Claude Opus 4.7 --- CHANGELOG.md | 4 ++++ ROADMAP.md | 8 ++++---- docs/deployment/programmatic.md | 10 +++++----- docs/spec/31-llm-backend.md | 2 +- 4 files changed, 14 insertions(+), 10 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index b281146..e228aeb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -49,6 +49,10 @@ CHANGELOG entry. ## [Unreleased] +### Documentation + +- Post-v1.0 staleness sweep: `ROADMAP.md`, `docs/deployment/programmatic.md`, and `docs/spec/31-llm-backend.md` updated to reflect the v1.0 release (twelfth backend protocol shipped, MCPServerRegistryBackend added to lists, status copy flipped from future-tense to PyPI-install present-tense, spec/31 status line refreshed from "v0.13 era" to "v1.0"). Closes the three stragglers an audit found after the PR #334 v1.0 release sweep. + ## [1.0.0] - 2026-06-04 ### Added diff --git a/ROADMAP.md b/ROADMAP.md index a1a2d00..6f09478 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -6,15 +6,15 @@ For shipped work, see [CHANGELOG.md](CHANGELOG.md). For the framework's design s --- -## v1.0 — remaining backend protocols +## v1.0 — backend protocols shipped -The framework's protocol-pattern scaling story closes at v1.0. **Eleven of twelve** backend protocols have shipped: `MemoryBackend`, `LLMBackend`, `JudgeBackend`, `LockBackend`, `LogBackend`, `AgentProfileBackend`, `ToolRegistryBackend`, `MandateBackend`, `PolicyBackend`, `PersonaBackend`, `CorpusBackend`. One remains. +The framework's protocol-pattern scaling story closed at v1.0 on 2026-06-05. **Twelve of twelve** backend protocols have shipped: `MemoryBackend`, `LLMBackend`, `JudgeBackend`, `LockBackend`, `LogBackend`, `AgentProfileBackend`, `ToolRegistryBackend`, `MandateBackend`, `PolicyBackend`, `PersonaBackend`, `CorpusBackend`, `MCPServerRegistryBackend`. All twelve have locked specs, reference implementations, and parametrized conformance suites. | Issue | Backend | Status | What it unblocks | |-------|---------|--------|------------------| -| [#201](https://github.com/dep0we/atomic-agents-stack/issues/201) | `MCPServerRegistryBackend` | Planned | Catalog + install/audit for MCP servers (the MCP equivalent of the ToolRegistry pattern) | +| [#201](https://github.com/dep0we/atomic-agents-stack/issues/201) | `MCPServerRegistryBackend` | Shipped (v1.0.0) | Catalog + install/audit for MCP servers (the MCP equivalent of the ToolRegistry pattern) | -**v1.0 ships when the remaining backend lands + its conformance suite pins the contract.** Same agent definitions, same `agent.call()` flow, same audit trail — different backends registered. +**v1.0.0 is live on PyPI:** `pip install atomic-agents-stack`. Same agent definitions, same `agent.call()` flow, same audit trail; different backends registered. --- diff --git a/docs/deployment/programmatic.md b/docs/deployment/programmatic.md index e4fefbc..90809e4 100644 --- a/docs/deployment/programmatic.md +++ b/docs/deployment/programmatic.md @@ -724,15 +724,15 @@ public surface) is internal. Specifically: The protocol pattern from [`spec/20-memory-backend.md`](../spec/20-memory-backend.md) is the -template every backend follows. Eleven backend protocols have shipped -(`MemoryBackend`, `LLMBackend`, `JudgeBackend`, `LockBackend`, +template every backend follows. Twelve backend protocols have shipped +at v1.0 (`MemoryBackend`, `LLMBackend`, `JudgeBackend`, `LockBackend`, `LogBackend`, `AgentProfileBackend`, `ToolRegistryBackend`, -`MandateBackend`, `PolicyBackend`, `PersonaBackend`, `CorpusBackend`); -one remains for v1.0 (`MCPServerRegistryBackend`). Each ships with a +`MandateBackend`, `PolicyBackend`, `PersonaBackend`, `CorpusBackend`, +`MCPServerRegistryBackend`). Each ships with a filesystem reference impl, a conformance suite, an operator override env var + constructor kwarg, a `doctor.check_` coherence check, and a numbered spec doc (`spec/20`, `21`, `22`, `24`, `25`, -`28`, `29`, `31`, `32`, `33`, `34`). Future SaaS / Postgres / git adapters +`28`, `29`, `31`, `32`, `33`, `34`, `36`). Future SaaS / Postgres / git adapters register via the matching `register__backend()` entry point without forking core. diff --git a/docs/spec/31-llm-backend.md b/docs/spec/31-llm-backend.md index 87ec003..e034f73 100644 --- a/docs/spec/31-llm-backend.md +++ b/docs/spec/31-llm-backend.md @@ -1,6 +1,6 @@ # 31 — LLMBackend Protocol -**Status:** locked (spec matches implementation as of v0.13 era). +**Status:** locked (spec matches implementation as of v1.0). **Origin:** [#87](https://github.com/dep0we/atomic-agents-stack/issues/87). **Shipped across four PRs:** PR 1 (canonical types + Protocol contract + registry primitives), PR 2 (`AnthropicLLMBackend` + Claude dispatch routing), PR 2.5 (`agent.py` tool-dispatch refactor to canonical types), PR 3 (`OpenAICompatibleLLMBackend` + `MoonshotLLMBackend` + registry-only dispatch + `model.md` `provider:` parser).