Skip to content

[codex] Refresh agent context for 0.7 master - #23

Merged
JovaniPink merged 3 commits into
masterfrom
agent-context-post-0.7-docs
Jul 4, 2026
Merged

[codex] Refresh agent context for 0.7 master#23
JovaniPink merged 3 commits into
masterfrom
agent-context-post-0.7-docs

Conversation

@JovaniPink

Copy link
Copy Markdown
Owner

Summary

  • Refreshes AGENTS.md so the compact agent-facing context reflects the merged 0.7.0 release-readiness state on master.
  • Expands CLAUDE.md with current module coverage and removes stale framing that treated 0.7.0 features as branch-only or future backlog work.
  • Tightens roadmap, architectural-debt, API-boundary, and XState-alignment notes so future AI-agent sessions preserve the stable Machine(config, ...) JSON boundary and do not chase completed 0.7 work.

Why

The June 29/0.7.0 merge train moved query helpers, Mermaid export, choose(...), pure(...), schema typing, and context adapter work onto master, but parts of the agent-facing docs still described that state as branch work or as future 0.7 scope. That wording can mislead future Codex/Claude sessions into reopening completed milestones, proposing obsolete APIs like a parallel context_factory, or treating old v0.1/v0.4 migration notes as current guidance.

Notable updates

  • Marks 0.7.0 as release-ready on master while calling out that PyPI publication remains a release task.
  • Adds missing architecture-map entries for current modules such as guards.py, snapshot.py, mermaid.py, context.py, and setup_api.py.
  • Documents current capabilities: snapshot serialization, context adapters, state tags/meta, stateIn, choose/pure, and Mermaid export.
  • Reframes the 0.7 feature backlog into post-0.7 roadmap notes with completed work separated from remaining parity gaps.
  • Updates architectural-debt notes to reflect that HandlerAdapter, StateNodeConfigParser, TypedDict schemas, and ContextAdapter have already landed.
  • Replaces stale API guidance about v0.1/v0.4 with the stable Machine(config, actions=..., guards=..., delays=..., actors=...) contract.

Validation

  • git diff --check
  • Targeted rg scan for stale phrases such as 0.7.0 branch, branch in progress, feature backlog, v0.1.0 contract, and deep-research

No Python test suite run; this is docs-only.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the documentation in AGENTS.md and CLAUDE.md to reflect the release-readiness of version 0.7.0, including updated file maps, roadmap details, and development commands. The review feedback suggests expanding the file map in CLAUDE.md to include several missing core modules and changing the ruff formatting command from a check-only mode to an active formatting command to better assist AI agents.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread CLAUDE.md
Comment thread CLAUDE.md Outdated
@JovaniPink
JovaniPink marked this pull request as ready for review July 2, 2026 18:42
JovaniPink and others added 2 commits July 2, 2026 15:00
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

@JovaniPink JovaniPink left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checked.

@JovaniPink
JovaniPink merged commit ed8c0ce into master Jul 4, 2026
4 checks passed
@JovaniPink
JovaniPink deleted the agent-context-post-0.7-docs branch July 4, 2026 18:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants