Metadata-Version: 2.5
Name: devflow-cli
Version: 3.0.0
Summary: Spec-Driven Development workflow CLI
Project-URL: Homepage, https://github.com/sopequenoteck/devflow
Project-URL: Repository, https://github.com/sopequenoteck/devflow
Author-email: sopequenoteck <sopequeno.tech@gmail.com>
License: MIT
License-File: LICENSE
Keywords: claude-code,cli,codex,development,spec-driven,workflow
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Requires-Dist: jsonschema>=4.23
Requires-Dist: pyyaml>=6
Requires-Dist: rich>=13
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: hatchling>=1.27; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# devflow

Devflow est un moteur de développement adaptatif pour Codex, Claude Code et
Cursor. Il choisit un niveau de rigueur à partir de signaux explicites, produit
des contrats d’activité portables et bloque les transitions tant que les
preuves attendues ne sont pas présentes.

## Profils

- `quick` : changement local, clair et peu risqué.
- `standard` : plusieurs composants ou risque modéré.
- `deep` : changement transversal, ambigu ou contractuel.
- `critical` : sécurité, données, migration ou risque élevé.

Les routes exactes et leurs preuves sont générées dans
[docs/pipeline-reference.generated.md](docs/pipeline-reference.generated.md).

## Installation

```bash
uv tool install devflow-cli
devflow init --ai codex
```

Python 3.11+ et Git sont requis. `--ai` accepte `codex`, `claude-code` ou
`cursor`.

## Parcours quotidien

```bash
devflow feature KS-123 --short-name user-auth
devflow assess KS-123 --scope multiple --ambiguity medium --risk medium
devflow adaptive start KS-123
devflow adaptive run KS-123 --agent codex
devflow adaptive status KS-123
```

`adaptive status --json` fournit un état exploitable par la CI. Les échecs
distinguent explicitement blocage métier, contrat invalide, panne agent,
validation échouée et conflit concurrent ; chaque refus affiche la commande de
reprise recommandée.

Chaque invocation de `adaptive run` traite une activité. La politique est dans
`assessment.json`; la progression et les preuves sont dans
`workflow-state.json`. Les résultats agent sont validés par schéma et les
preuves d’exécution sensibles sont produites localement par Devflow.

Les trois adaptateurs acceptent les mêmes contrats structurés :

```bash
devflow adaptive run KS-123 --agent codex
devflow adaptive run KS-123 --agent claude
devflow adaptive run KS-123 --agent cursor
```

## Migrer une ancienne feature

```bash
devflow migrate KS-123 --dry-run
devflow migrate KS-123 --profile deep
```

La migration conserve les artefacts, archive `state.json` sous
`legacy-state.json`, puis redémarre à la première activité vérifiable du profil.
Sans identifiant, `devflow migrate` traite toutes les anciennes features.
`devflow init` et `devflow upgrade` déplacent également les anciennes commandes
Claude connues vers `~/.claude/.devflow-legacy-backup/` sans toucher aux
commandes personnalisées.

## Documentation

- [Workflow adaptatif](docs/pipeline.md)
- [Référence CLI](docs/cli-reference.md)
- [Contrats d’activité](docs/activity-contracts.md)
- [Façade Claude Code](docs/commands-reference.md)
- [Guide Cursor](docs/cursor-guide.md)

## Développement

```bash
uv sync --extra dev
uv run pytest -q
./tests/run-tests.sh
uv run devflow docs-sync --check
```
