Skip to content

Refresh README architecture diagram#3

Merged
Yashasm18 merged 1 commit into
mainfrom
docs/readme-architecture-graph
Jul 14, 2026
Merged

Refresh README architecture diagram#3
Yashasm18 merged 1 commit into
mainfrom
docs/readme-architecture-graph

Conversation

@Yashasm18

Copy link
Copy Markdown
Owner

Summary

  • Replaced the old generic architecture diagram with a Mermaid diagram that reflects the actual monorepo: apps/web, the Express/WebSocket agent server, @torvaix/providers, @torvaix/mcp, @torvaix/memory's Qdrant/embedding fallback chain, the knowledge graph package, and the standalone Python intelligence service
  • Added a second Mermaid state diagram for the orchestrator's actual routing states (router/memory/knowledge/execution/repo_analysis/approval), matching nextNode values in orchestrator.ts
  • Marked the intelligence-layer → knowledge-graph edge as dashed since it isn't wired into the live memory write path today (only scripts/test-graph.ts calls it)

Test plan

  • Verified diagram content against packages/agent/src/orchestrator.ts (node names, approval flow) and package imports across the monorepo
  • Visual render check on GitHub after merge (Mermaid renders natively in GitHub's README view)

🤖 Generated with Claude Code

Replace the generic placeholder diagram with two Mermaid graphs
grounded in the actual code: a system diagram covering apps/web,
the Express/WebSocket agent server, @torvaix/providers, @torvaix/mcp,
@torvaix/memory (with its Qdrant/embedding fallback chain), the
knowledge graph package, and the standalone Python intelligence
service; and a state diagram of the orchestrator's router/memory/
knowledge/execution/repo_analysis/approval flow, matching the
nextNode values and approval handling in orchestrator.ts.

The intelligence-layer -> knowledge-graph edge is marked dashed since
it's not currently wired into the live memory write path (only
scripts/test-graph.ts exercises it today).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@Yashasm18
Yashasm18 merged commit ed4029f into main Jul 14, 2026
2 checks passed
@Yashasm18
Yashasm18 deleted the docs/readme-architecture-graph branch July 14, 2026 03:56
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