Skip to content

docs: update ARCHITECTURE.md with agent-driven close session flow#18

Merged
George-iam merged 4 commits intomainfrom
feat/architecture-docs-20260406
Apr 6, 2026
Merged

docs: update ARCHITECTURE.md with agent-driven close session flow#18
George-iam merged 4 commits intomainfrom
feat/architecture-docs-20260406

Conversation

@George-iam
Copy link
Copy Markdown
Contributor

Summary

  • Add begin_close + finalize_close + questions tools to tool table
  • Document two auditor modes: verify-only vs full extraction
  • Document agent-driven session close flow
  • Document storage consistency (all writes via MCP server)
  • Document session recovery (ownerPpid refresh + stale adoption)
  • Update hooks: no matcher, fires on all tools
  • Update storage layout and session lifecycle

Test plan

  • Review for accuracy against current codebase

- Add begin_close + finalize_close tools to tool table
- Add questions tools (ask/answer/list)
- Document two auditor modes: verify-only (agentClosed) vs full extraction
- Document session close flow: begin_close -> extract -> finalize_close
- Document storage consistency: all writes via MCP server, not directly by LLM
- Document session recovery: ownerPpid refresh + stale adoption
- Document hooks fire on ALL tools (no matcher)
- Update storage layout: worklog.md, versioned handoffs, config.yaml
- Update session lifecycle with explicit close step
Full system architecture diagram showing:
- MCP Server with tool handlers
- Hooks (hard safety enforcement, session tracking)
- Detached Auditor (full vs verify-only modes)
- .axme-code/ storage layout
- Agent-driven session close flow (begin_close -> finalize_close)
- Session recovery (ownerPpid, stale adoption)
@George-iam George-iam merged commit d2081b4 into main Apr 6, 2026
@George-iam George-iam deleted the feat/architecture-docs-20260406 branch April 7, 2026 08:01
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.

1 participant