Skip to content

Module Map

The architecture of bijux-canon-agent becomes readable when its major module groups are treated as responsibilities instead of as folders. This page should help a reviewer move from a question about behavior to the part of the package most likely to answer it.

When this page is useful, code reading becomes targeted rather than exploratory.

Treat the architecture pages for bijux-canon-agent as a reviewer-facing map of structure and flow. They should shorten code reading, not try to replace it.

Visual Summary

flowchart RL
    page["Module Map<br/>clarifies: trace execution | spot dependency pressure | judge structural drift"]
    classDef page fill:#dbeafe,stroke:#1d4ed8,color:#1e3a8a,stroke-width:2px;
    classDef positive fill:#dcfce7,stroke:#16a34a,color:#14532d;
    classDef caution fill:#fee2e2,stroke:#dc2626,color:#7f1d1d;
    classDef anchor fill:#ede9fe,stroke:#7c3aed,color:#4c1d95;
    classDef action fill:#fef3c7,stroke:#d97706,color:#7c2d12;
    module1["workflow policy and graph logic"]
    module1 --> page
    module2["role-local behavior"]
    module2 --> page
    module3["execution flow orchestration"]
    module3 --> page
    code1["src/bijux_canon_agent/pipeline"]
    page --> code1
    code2["src/bijux_canon_agent/application"]
    page --> code2
    code3["src/bijux_canon_agent/agents"]
    page --> code3
    pressure1["tests/invariants for package promises that should not drift"]
    pressure1 -.tests whether this structure still holds.-> page
    pressure2["tests/unit for local behavior and utility coverage"]
    pressure2 -.tests whether this structure still holds.-> page
    pressure3["tests/integration and tests/e2e for end-to-end workflow behavior"]
    pressure3 -.tests whether this structure still holds.-> page
    class page page;
    class module1,module2,module3 positive;
    class code1,code2,code3 anchor;
    class pressure1,pressure2,pressure3 caution;

Major Modules

  • src/bijux_canon_agent/agents for role-local behavior
  • src/bijux_canon_agent/pipeline for execution flow orchestration
  • src/bijux_canon_agent/application for workflow policy and graph logic
  • src/bijux_canon_agent/llm for LLM runtime integration support
  • src/bijux_canon_agent/interfaces for CLI boundaries and operator helpers
  • src/bijux_canon_agent/traces for trace-facing models and persistence helpers

Concrete Anchors

  • src/bijux_canon_agent/agents for role-local behavior
  • src/bijux_canon_agent/pipeline for execution flow orchestration
  • src/bijux_canon_agent/application for workflow policy and graph logic

Use This Page When

  • you are tracing structure, execution flow, or dependency pressure
  • you need to understand how modules fit before refactoring
  • you are reviewing design drift rather than one isolated bug

Decision Rule

Use Module Map to decide whether a structural change makes bijux-canon-agent easier or harder to explain in terms of modules, dependency direction, and execution flow. If the change works only because the design becomes harder to read, the safer answer is redesign rather than acceptance.

What This Page Answers

  • how bijux-canon-agent is organized internally in terms a reviewer can follow
  • which modules carry the main execution and dependency story
  • where structural drift would show up before it becomes expensive

Reviewer Lens

  • trace the described execution path through the named modules instead of trusting the diagram alone
  • look for dependency direction or layering that now contradicts the documented seam
  • verify that the structural risks named here still match the current code shape

Honesty Boundary

This page describes the current structural model of bijux-canon-agent, but it does not guarantee that every import path or runtime path still obeys that model. Readers should treat it as a map that must stay aligned with code and tests, not as an authority above them.

Next Checks

  • move to interfaces when the review reaches a public or operator-facing seam
  • move to operations when the concern becomes repeatable runtime behavior
  • move to quality when you need proof that the documented structure is still protected

Purpose

This page provides a shortest-path code map for the package.

Stability

Keep it aligned with the actual source directories under packages/bijux-canon-agent.