Metadata-Version: 2.4
Name: devmender
Version: 0.1.0a2
Summary: Opinionated developer environment doctor — detect, diagnose, recommend, safely fix.
Author: DevMender contributors
License: Apache-2.0
License-File: LICENSE
Keywords: cli,developer-environment,doctor,migration,npm,pnpm
Requires-Python: >=3.12
Requires-Dist: pydantic>=2.7
Requires-Dist: rich>=13.7
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# DevMender

Opinionated developer environment doctor — **detect → diagnose → recommend → safely fix**.

DevMender inspects your development environment and project, ranks the problems it finds by
impact, explains why each one matters, and can safely apply fixes. The habit: run
`devmender doctor` before you start working on any project.

```bash
devmender doctor        # diagnose environment + project, ranked findings
devmender doctor --json # machine-readable output (versioned envelope)
devmender migrate npm   # safely convert an npm project to pnpm
devmender context       # Explorer right-click integration (Windows)
```

v0.1 focuses on the Node.js ecosystem (node/npm/pnpm) with an architecture built to extend
into Python, Java, Rust, and Go.

- **Judgment is data.** Every finding is a `rule_id` + severity + evidence + explanation +
  recommended action + optional automated fix. Rules are versioned and community-extensible.
- **Read-only by default.** `doctor` never mutates your filesystem. Anything that changes a
  file requires an explicit `--fix` / `--yes` after a backup and dry-run.
- **Offline-first.** No telemetry, no network calls during diagnosis.

## Install

Requires Python 3.12+.

```bash
pipx install devmender
# or from source
uv sync
uv run devmender --help
```

## Documentation

- `docs/rules.md` — how to author doctor rules.
- Design docs and implementation plan live in the gstack project workspace.

## License

Apache-2.0.
