morpharch 1.2.4

Monorepo architecture drift visualizer with animated TUI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

# Contributing to MorphArch

Thank you for your interest in contributing to MorphArch. This guide covers
everything you need to get started.

## Prerequisites

- **Rust 1.88 or later** (the project's MSRV)
- **A C compiler** (required by `rusqlite` bundled SQLite and tree-sitter grammars)
  - Linux: `gcc` or `clang` (install via your package manager)
  - macOS: Xcode Command Line Tools (`xcode-select --install`)
  - Windows: MSVC Build Tools (install via Visual Studio Installer)
- **Git**

## Getting Started

1. Fork the repository on GitHub.

2. Clone your fork:

   ```sh
   git clone https://github.com/<your-username>/morpharch.git
   cd morpharch
   ```

3. Build the project:

   ```sh
   cargo build
   ```

4. Run the test suite:

   ```sh
   cargo test
   ```

5. Create a branch for your work:

   ```sh
   git checkout -b your-branch-name
   ```

## Development Workflow

### Building

```sh
cargo build          # Debug build
cargo build --release # Optimized build
```

### Running

```sh
cargo run -- <arguments>
```

### Testing

```sh
cargo test           # Run all tests
cargo test <name>    # Run a specific test
```

### Formatting

The project uses `rustfmt` with the configuration in `.rustfmt.toml`. Format
your code before committing:

```sh
cargo fmt
```

CI will reject code that does not pass `cargo fmt --check`.

### Linting

```sh
cargo clippy --all-targets
```

CI treats all Clippy warnings as errors.

### Documentation

```sh
cargo doc --no-deps --open
```

## Pull Request Process

1. Ensure your changes compile on the MSRV (Rust 1.88).
2. Run `cargo fmt`, `cargo clippy`, and `cargo test` locally.
3. Write clear, descriptive commit messages.
4. Open a pull request against the `main` branch.
5. Fill out the pull request template.
6. Wait for CI to pass and a maintainer to review.

### Commit Messages

Use concise, imperative-mood commit messages:

- `feat: add Python import resolver`
- `fix: handle cyclic dependencies in graph walk`
- `refactor: extract scoring logic into separate module`
- `docs: update CONTRIBUTING with MSRV note`
- `test: add integration test for incremental scan`

## Code Style

- Maximum line width is 100 characters (enforced by rustfmt).
- Use `anyhow` for error propagation in application code.
- Prefer returning `Result` over panicking.
- Add doc comments (`///`) to all public items.
- Keep modules focused: one responsibility per module.

## Architecture Notes

MorphArch is a binary crate structured around these core areas:

- **Git scanning** -- repository traversal via `gix`
- **Parsing** -- tree-sitter grammars for multi-language import extraction
- **Graph** -- `petgraph`-based dependency graph with drift scoring
- **Storage** -- SQLite persistence via `rusqlite`
- **TUI** -- `ratatui` + `crossterm` animated graph renderer

When adding a new language parser, add the corresponding `tree-sitter-*` crate
to `Cargo.toml` and implement the import extraction logic following the patterns
in existing language modules.

## Reporting Issues

- Use the bug report template for bugs.
- Use the feature request template for new ideas.
- Check existing issues before opening a new one.

## License

By contributing, you agree that your contributions will be licensed under the
same terms as the project: MIT OR Apache-2.0.