Metadata-Version: 2.4
Name: kryptorious-devflow
Version: 1.1.0
Summary: Developer workflow automation CLI — scaffold, audit, fix, and ship projects with one tool.
Author: Kryptorious Quantum Biosciences, Inc.
License: Proprietary
Project-URL: Homepage, https://devflow.sh
Project-URL: Repository, https://github.com/kryptorious/devflow
Keywords: cli,developer-tools,productivity,scaffold,code-quality,automation
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: tomli>=2.0; python_version < "3.11"
Requires-Dist: gitpython>=3.1
Requires-Dist: packaging>=23.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: ruff>=0.1; extra == "dev"

# DevFlow — Developer Workflow Automation CLI

**One tool to scaffold, audit, fix, and ship any project.**

[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/license-Proprietary-red.svg)](LICENSE)
[![Version](https://img.shields.io/badge/version-1.0.0-green.svg)](https://devflow.sh)

---

## Stop Wasting Hours on Project Setup

Every developer knows the pain:

- Starting a new project means hours of boilerplate — config files, CI/CD, linting, testing, Docker
- Code reviews catch formatting and lint issues that should have been fixed automatically
- Shipping a release means bumping versions, updating changelogs, tagging, building — all manual and error-prone

**DevFlow replaces 10+ separate tools with 4 commands.**

---

## What DevFlow Does

### `devflow init` — Smart Project Scaffolding

Creates production-ready projects with best practices baked in:

- Python (CLI, API, library), Node.js, and full-stack templates
- Pre-configured linting (ruff), formatting (black), type checking (mypy), and testing (pytest)
- GitHub Actions CI/CD ready to go
- Docker config included
- Automatic git init and initial commit
- Sensible defaults you can override

```bash
$ devflow init my-api --template api --description "REST API for widget tracking"
$ devflow init my-cli --template cli
$ devflow init my-saas --template fullstack --description "My SaaS app"
```

### `devflow audit` — Codebase Health Check

Comprehensive project audit that checks:

- Project structure and conventions
- Linting violations (ruff)
- Code formatting (black)
- Import organization (isort/ruff)
- Test coverage and passing status
- Docstring coverage
- Security vulnerabilities (bandit)
- Hardcoded secrets
- Dependency freshness and known vulnerabilities

```bash
$ devflow audit
# 72/100 — 8 passed, 3 warnings, 1 error

$ devflow audit --format markdown --severity error
$ devflow audit --format json  # for CI integration
```

### `devflow fix` — Auto-Fix Everything

One command to fix all the issues audit found:

- Format code with black
- Sort imports with ruff/isort
- Fix lint violations
- Preview with `--dry-run` before applying

```bash
$ devflow fix --dry-run      # See what would change
$ devflow fix --apply        # Fix everything
$ devflow fix --scope format # Just fix formatting
```

### `devflow ship` — Release Automation

Ship a release in one command:

- Runs audit first (quality gate — blocks release on errors)
- Bumps version (patch/minor/major)
- Updates CHANGELOG.md
- Creates git tag
- Builds distribution packages
- Optionally pushes to remote

```bash
$ devflow ship --bump patch --message "Fix login bug"
$ devflow ship --bump minor --message "Add user dashboard" --push
$ devflow ship --bump major --dry-run  # Preview before shipping
```

---

## Why Developers Buy DevFlow

- **Save 2-4 hours per project setup.** Stop copy-pasting configs between projects.
- **Catch issues before code review.** Audit and fix in your editor, not in PR comments.
- **Ship with confidence.** Automated quality gates prevent broken releases.
- **One tool, not ten.** Replace black, isort, ruff, flake8, bandit, pip-audit, bumpversion, and manual changelogs.
- **CI-ready output.** JSON and markdown formats integrate with any pipeline.

---

## Installation

```bash
pip install kryptorious-devflow
```

Requires Python 3.9+.

---

## Quick Start

```bash
# Create a new project
devflow init my-project --template cli

# Check its health
cd my-project
devflow audit

# Fix any issues
devflow fix --apply

# Ship v0.1.0
devflow ship --bump patch --message "Initial release"
```

---

## What You Get

- **Full source code** — MIT-licensed, modifiable, extensible
- **6 project templates** — Python CLI, API, Library, Node.js, Full-stack, and Generic
- **Pre-configured tooling** — ruff, black, mypy, pytest, GitHub Actions CI
- **Docker support** — Dockerfile and docker-compose included for all templates
- **Lifetime updates** — All 1.x updates included

---

## Requirements

- Python 3.9 or later
- Git (for init and ship commands)
- Optional: black, ruff, bandit, pip-audit (devflow tells you what to install)

---

## License

Proprietary — single-user license. See [LICENSE](LICENSE) for terms.

---

## Support

Email: support@devflow.sh
Docs: https://devflow.sh/docs

---

*Built with DevFlow itself. Ship everything.*
