Skip to content

Building AI agents, atomically

Update codebase map: retire sync_version.py, bump version refs, add hash manifest

Eigenwise58cb04229262
diff --git a/.claude/.codebase-info/.map-state.json b/.claude/.codebase-info/.map-state.json
index 2d058f0..4d85b42 100644
--- a/.claude/.codebase-info/.map-state.json
+++ b/.claude/.codebase-info/.map-state.json
@@ -1,8 +1,8 @@
{
"tool": "codebase-mapper",
- "version": "2.0.0",
- "mappedAt": "2026-07-05",
- "gitCommit": "28099f5aa6eccb491c66be4bcd22532f15bb407f",
+ "version": "2.8.0",
+ "mappedAt": "2026-07-18",
+ "gitCommit": "7e85456d9984483b29211bff1dd98820409e9635",
"documents": [
"architecture.md",
"tech-landscape.md",
@@ -14,5 +14,18 @@
"patterns.md",
"coding-style.md",
"onboarding.md"
- ]
+ ],
+ "hashes": {
+ "INDEX.md": "17eaa0ba82f159465e126597aac349c6e4429330887b58742636734e15854313",
+ "architecture.md": "7c908f047e6b0f08824ccd7c3f674ad47bd547dde234d0bd424a6d2784c0cbb6",
+ "tech-landscape.md": "a9052f4bba3742e79556a49c888424e6d9de424970e9def440c7124f45ec6a41",
+ "directory-structure.md": "ecf7e3357b41a83e7f31e760db41ef0bcb4fdbc6f1d61bbb4daf896f425d6657",
+ "entry-points.md": "6bd4ccae3d975196e03fc2c4e86007eba89f1f6427232fd8adce78ec97d6b432",
+ "modules.md": "1238c76664edb1c1667fda23f39507bcab5b760b57a3a3728d7104b2cf8032e7",
+ "communication.md": "49741a7455b0f162881e1cfb2d797dc8e3832cc8782796bbcb8a10529f2c5a0b",
+ "dependencies.md": "b445a920c121e27006fec824add6865d01cf71212a517e5ff8b2058d3999037a",
+ "patterns.md": "12b96c2d4f8bc7507bcae39b2b385b9db4d0dec95ef6a2049958663aff021705",
+ "coding-style.md": "2f939544333b927cf8731f5bb906ce03cb3a46afa50c9735011ff8f7e4caca9e",
+ "onboarding.md": "3d28c671dc095a2aadb297bd7ab200c677779a99c7534e03e55a3d64c935f07e"
+ }
}
diff --git a/.claude/.codebase-info/INDEX.md b/.claude/.codebase-info/INDEX.md
index 7274c31..b99e8ac 100644
--- a/.claude/.codebase-info/INDEX.md
+++ b/.claude/.codebase-info/INDEX.md
@@ -1,6 +1,6 @@
# Codebase Map — Atomic Agents
-*Last Updated: 2026-06-13*
+*Last Updated: 2026-07-18*
Atomic Agents is a lightweight, modular Python framework for building agentic AI applications as
composable, schema-driven building blocks (built on Instructor + Pydantic). This repository is a
@@ -8,7 +8,7 @@ composable, schema-driven building blocks (built on Instructor + Pydantic). This
**Stack:** Python ≥3.12 · Instructor · Pydantic v2 · LiteLLM · MCP · Textual · uv + Hatchling
**Shape:** Monorepo — `atomic-agents/` (core lib) · `atomic-assembler/` (CLI) · `atomic-forge/` (tools) · `atomic-examples/` (examples)
-**Package:** `atomic-agents` v2.8.1 on PyPI · core import package is `atomic_agents`
+**Package:** `atomic-agents` v2.9.1 on PyPI · core import package is `atomic_agents`
## Documents
diff --git a/.claude/.codebase-info/directory-structure.md b/.claude/.codebase-info/directory-structure.md
index 6a82c41..592fc54 100644
--- a/.claude/.codebase-info/directory-structure.md
+++ b/.claude/.codebase-info/directory-structure.md
@@ -1,6 +1,6 @@
# Directory Structure
-*Last Updated: 2026-07-05*
+*Last Updated: 2026-07-18*
## Root Layout
@@ -22,7 +22,7 @@ atomic-agents/ # repo root (uv workspace)
├── atomic-examples/ # 16 runnable example apps (each its own project)
├── docs/ # Sphinx + MyST documentation (api/, guides/, examples/)
├── guides/ # DEV_GUIDE.md and contributor guides
-├── scripts/ # sync_version.py, generate_llms_files.py
+├── scripts/ # generate_llms_files.py (llms-*.txt bundles for the docs site)
├── pyproject.toml # package metadata, deps, [tool.black], uv workspace
├── build_and_deploy.ps1 # version bump + uv build/publish
├── AGENTS.md # the project's own design philosophy (imported by CLAUDE.md)
diff --git a/.claude/.codebase-info/tech-landscape.md b/.claude/.codebase-info/tech-landscape.md
index ae9bddd..ecd868d 100644
--- a/.claude/.codebase-info/tech-landscape.md
+++ b/.claude/.codebase-info/tech-landscape.md
@@ -1,6 +1,6 @@
# Technology Landscape
-*Last Updated: 2026-06-13*
+*Last Updated: 2026-07-18*
## Source-of-Truth Files
@@ -38,8 +38,10 @@
- `code-quality.yml` — on push/PR to `main`/`v2.0`: `uv sync`, `black --check`, `flake8`, then
`pytest --cov=atomic_agents` across `atomic-agents`, `atomic-assembler`, `atomic-examples`,
`atomic-forge`.
- - `docs.yml` — on push to `main`: build Sphinx docs, run `scripts/sync_version.py` and
+ - `docs.yml` — on push to `main`: build Sphinx docs, run
`scripts/generate_llms_files.py` (produces `llms-*.txt`), deploy to GitHub Pages.
+ The docs version needs no sync step — `docs/conf.py` reads it from the root
+ `pyproject.toml` via `tomllib`.
- **Release:** `build_and_deploy.ps1 <major|minor|patch> [--dry]` bumps the version in
`pyproject.toml`, then `uv sync` → `uv build` → `uv publish` (requires a `PYPI_TOKEN`).
- **Distribution:** PyPI package `atomic-agents`; the `atomic` console script ships with it.