Skip to content

feat: complete foundation tier (Patterns 01-03) with infrastructure and docs#7

Merged
ksopyla merged 7 commits into
mainfrom
dev
Apr 13, 2026
Merged

feat: complete foundation tier (Patterns 01-03) with infrastructure and docs#7
ksopyla merged 7 commits into
mainfrom
dev

Conversation

@ksopyla
Copy link
Copy Markdown
Owner

@ksopyla ksopyla commented Apr 13, 2026

Summary

Complete foundation tier (Patterns 01-03) with infrastructure, shared library, documentation, and CI/CD.

Patterns

  • Pattern 01 – Orchestrator Pipeline: restructured from 01-multi-agent-single-system into a clean 3-agent sequential pipeline (planner → scanner → compiler) with FastAPI, typed state, graceful degradation, and full test suite.
  • Pattern 02 – MCP Tool Integration: 5-agent parallel fan-out/fan-in graph with dual entry points (REST + MCP). CoinGecko + DuckDuckGo data sources, outcome-oriented MCP tool, and shared runtime config. Multiple architecture iterations landed on data-source ownership and LLM-based query extraction.
  • Pattern 03 – Checkpoint Recovery: PostgreSQL-backed checkpointer for durable execution, resume-after-failure semantics, human-in-the-loop interrupts, and thread continuity. New agent_common.persistence module in libs/common.

Infrastructure & Shared Library

  • libs/common (agent_common): standardized Settings, LLM provider selection, LangSmith tracing with per-example tags, and PostgreSQL persistence helpers.
  • Docker: shared base image (Dockerfile.agent), per-example docker-compose.yml.
  • CI: run_test_suite.py and run_mypy.py wrapper scripts to avoid cross-example conflicts. Pre-commit hooks with ruff, secrets detection, and conventional commit checks.

Documentation

  • Revised curriculum and vision: renamed P03 (Checkpoint Recovery) and P04 (Agent Memory), made P04 part of the main path.
  • Streamlined example READMEs with numbered implementation walkthroughs and "What You Have Learned" takeaways.
  • Added CHANGELOG, AGENTS.md, engineering reports, and new/updated skills (readme-writer, tester, scaffolder, advisor, runtime-verifier, etc.).

Test plan

  • uv run python scripts/testing/run_test_suite.py passes for all three examples
  • uv run python scripts/linting/run_mypy.py passes
  • uv run ruff check . and uv run ruff format --check . pass
  • docker compose up works for each example (01, 02, 03)
  • Pattern 03 POST /run returns a report with thread_id for resume
  • Pattern 02 MCP endpoint at :8001/sse responds to Claude Desktop

ksopyla added 6 commits April 13, 2026 17:53
…mory

Rename P03 from Persistent Memory to Checkpoint Recovery and P04 from
Memory Lifecycle to Agent Memory. Update the narrative flow so P04 is on
the main path instead of an optional branch off P03.
…entions

Replace Exercises and Trade-offs sections with What You Have Learned.
Add numbered implementation walkthrough structure and endpoints.http
mention. Skip When to Use and Verification sections by default.
Replace verbose code excerpts, exercises, and trade-off tables with
numbered walkthrough steps, file references, and What You Have Learned
takeaways. Update next-pattern links to point to checkpoint recovery.
Add persistence module with create_postgres_pool, setup_checkpointer,
and close_checkpointer. Add postgres_uri to Settings and export new
helpers from agent_common. Deps: langgraph-checkpoint-postgres,
psycopg[binary,pool].
Add Pattern 03 with PostgreSQL-backed checkpointer, resume-after-failure
semantics, human-in-the-loop interrupt/resume, and the same 5-agent
fan-out/fan-in graph from P02. Includes FastAPI service, MCP server,
Docker Compose with PostgreSQL, and full test suite.
…ocstring

P03 README claimed the graph was unchanged from P02 but it adds
project_verifier and project_selector nodes. Update the At a Glance
table, Mermaid diagram, and description paragraph. Add P03 CHANGELOG
entry. Remove stale plan reference from intelligence_compiler docstring
in both P02 and P03.
@ksopyla
Copy link
Copy Markdown
Owner Author

ksopyla commented Apr 13, 2026

Review complete. All three findings addressed in fd7965c: README graph description corrected (verifier/selector now shown), CHANGELOG P03 entry added, intelligence_compiler docstring fixed in P02 and P03. CI green (6/6). Ready to merge.

@ksopyla ksopyla merged commit eecfdf5 into main Apr 13, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant