Skip to content

Release explain-codebase 0.2.1 #9

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
danyasync merged 1 commit into from
Aug 2, 2026
+911 −498
Merged

Release explain-codebase 0.2.1 #9

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),

## [Unreleased]

## [0.2.1] - 2026-08-02

### Changed

- Reworked the interactive dependency graph with a flat, minimal dark interface, compact controls, and a low-profile legend.
- Switched every graph view to deterministic, cached node positions with stable curved edges and lightweight selection styling.
- Reduced redraw work during search, filtering, hovering, zooming, and node selection.
- Added a restrained ambient node pulse and directional edge flow without changing node coordinates.
- Enabled manual node placement with bounded local collision resolution that moves only nearby overlapping nodes.

### Fixed

- Prevented nodes from drifting continuously or rearranging after clicks and pointer movement.
- Removed physics restarts, moving edge support nodes, and overlapping camera animations that could make the graph jump or lag.
- Kept search and filters from changing the coordinates of nodes that remain visible.
- Prevented small pointer movement during a click from shifting a node by restoring its exact starting position.

## [0.2.0] - 2026-08-02

### Added
Expand Down Expand Up @@ -72,7 +89,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),

- Published the initial command-line release with repository analysis, dependency graphs, JSON output, HTML reports, onboarding paths, and architecture checks.

[Unreleased]: https://github.com/danyasync/explain-codebase/compare/v0.2.0...HEAD
[Unreleased]: https://github.com/danyasync/explain-codebase/compare/v0.2.1...HEAD
[0.2.1]: https://github.com/danyasync/explain-codebase/compare/v0.2.0...v0.2.1
[0.2.0]: https://github.com/danyasync/explain-codebase/compare/63e1285083b2bdb06de2212aeddcdaebb18e2649...v0.2.0
[0.1.4]: https://pypi.org/project/explain-codebase/0.1.4/
[0.1.3]: https://pypi.org/project/explain-codebase/0.1.3/
Expand Down
4 changes: 4 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,10 @@ python -m pip install -e ".[dev]"

`--graph` writes `dependency_graph.html`. `--report` writes `codebase_report.html`. Both files are written to the current working directory.

The interactive graph starts from deterministic node positions with a restrained ambient pulse and directional edge flow. Selecting a node highlights its direct dependencies without restarting the layout, while search and filters keep the remaining nodes in place.

Nodes can be dragged into a more useful arrangement. When a dropped node overlaps another, a bounded local collision pass gently separates only the nearby nodes involved; it never restarts global layout physics. Tiny pointer movement during an ordinary click is ignored.

| Flag | View |
| --- | --- |
| `--architecture` | Architecture-level relationships; this is the default graph view |
Expand Down
Loading