Skip to content

Add per-command sequence diagrams for hery#7

Open
jnbdz wants to merge 11 commits into
masterfrom
docs/hery-command-diagrams
Open

Add per-command sequence diagrams for hery#7
jnbdz wants to merge 11 commits into
masterfrom
docs/hery-command-diagrams

Conversation

@jnbdz

@jnbdz jnbdz commented Jul 26, 2026

Copy link
Copy Markdown
Member

Adds the C4 dynamics level for hery: one sequence diagram per subcommand (entity dispatch, entity init/get/list/valid, query, compose, settings), embedded with prose on a new "hery Commands" page. Participants reuse the C3 component names so the diagrams zoom into the existing architecture view.

Spec-vs-code corrections applied while drawing (diagrams follow the code):

  • hery entity get writes only the on-disk entity cache, never SQLite.
  • No CLI command populates the SQLite entities table; hery query only reads it.
  • hery settings reads env/types.go from the cwd, so it fails outside the source tree.
  • The validate verb is valid; the diagram file keeps the validate basename.
  • entity/schema/ is constructed but never invoked at runtime, so it appears in no diagram.

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