Initial release of cargo-crategeist

Author: arferreira

.editorconfig

@@ -0,0 +1,22 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+charset = utf-8
+
+[*.rs]
+indent_style = space
+indent_size = 4
+
+[*.toml]
+indent_style = space
+indent_size = 4
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  check:
+    name: Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo check
+
+  fmt:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo clippy -- -D warnings
+
+  build:
+    name: Build
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo build --release

.gitignore

@@ -0,0 +1,2 @@
+/target
+crategeist-report.html

CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## 0.1.0
+
+Initial release.
+
+- Security audit via RustSec advisory database
+- Per-crate compile time measurement
+- Dead dependency detection via source scanning
+- Critical path analysis through dependency graph
+- Most depended-on crates ranking
+- Terminal output with colored tables
+- Self-contained HTML report generation
+- Workspace support with per-member analysis
+- `-p`/`--package` flag for targeting specific workspace members
+- `--skip-timing` and `--skip-security` flags

CONTRIBUTING.md

@@ -0,0 +1,66 @@
+# Contributing to crategeist
+
+Thanks for wanting to contribute. Here's how to get started.
+
+## Development setup
+
+```sh
+git clone https://github.com/arferreira/crategeist.git
+cd crategeist
+cargo build
+```
+
+## Running locally
+
+```sh
+# Quick test (no build, no network)
+cargo run -- crategeist --skip-timing --skip-security
+
+# Full run on itself
+cargo run -- crategeist
+```
+
+## Before submitting a PR
+
+```sh
+cargo fmt --check
+cargo clippy -- -D warnings
+cargo build
+```
+
+Make sure there are no warnings.
+
+## What to work on
+
+Check the [issues](https://github.com/arferreira/crategeist/issues) for open tasks. If you want to work on something not listed, open an issue first to discuss the approach.
+
+Good first contributions:
+- Improving unused dependency detection accuracy
+- Adding output formats (JSON, markdown)
+- Better timing measurement strategies
+- Documentation improvements
+
+## Guidelines
+
+- Keep it simple. Don't over-engineer.
+- One PR per feature or fix.
+- Write clear commit messages.
+- No async — this is a sequential CLI tool (rayon for parallelism where needed).
+- Stable Rust only, no nightly features.
+- Test your changes by running crategeist on real projects.
+
+## Project structure
+
+```
+src/
+  main.rs               # CLI entry, orchestration
+  metadata.rs           # cargo_metadata wrapper, workspace support
+  analyze/
+    timing.rs           # cargo build JSON message parsing
+    security.rs         # rustsec advisory DB audit
+    unused.rs           # regex source scanning
+    critical_path.rs    # petgraph DAG longest-path
+  report/
+    terminal.rs         # comfy-table + colored output
+    html.rs             # maud single-file HTML report
+```