devflow-cli 1.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,142 @@
1
+ Metadata-Version: 2.4
2
+ Name: devflow-cli
3
+ Version: 1.0.0
4
+ Summary: Spec-Driven Development workflow CLI
5
+ Project-URL: Homepage, https://github.com/sopequenoteck/devflow
6
+ Project-URL: Repository, https://github.com/sopequenoteck/devflow
7
+ Author-email: sopequenoteck <sopequeno.tech@gmail.com>
8
+ License: MIT
9
+ License-File: LICENSE
10
+ Keywords: claude-code,cli,development,spec-driven,workflow
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Environment :: Console
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Topic :: Software Development :: Quality Assurance
18
+ Requires-Python: >=3.11
19
+ Requires-Dist: httpx>=0.27
20
+ Requires-Dist: pyyaml>=6
21
+ Requires-Dist: rich>=13
22
+ Requires-Dist: typer>=0.12
23
+ Provides-Extra: dev
24
+ Requires-Dist: pytest-cov>=5; extra == 'dev'
25
+ Requires-Dist: pytest>=8; extra == 'dev'
26
+ Description-Content-Type: text/markdown
27
+
28
+ # devflow
29
+
30
+ [![CI](https://github.com/sopequenoteck/devflow/actions/workflows/ci.yml/badge.svg)](https://github.com/sopequenoteck/devflow/actions/workflows/ci.yml)
31
+ [![PyPI](https://img.shields.io/pypi/v/devflow-cli)](https://pypi.org/project/devflow-cli/)
32
+ [![License](https://img.shields.io/pypi/l/devflow-cli)](LICENSE)
33
+
34
+ Toolkit de **Spec-Driven Development** pour [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Chaque feature passe par un pipeline structuré avec gates de review avant d'atteindre le code.
35
+
36
+ Inspiré de [spec-kit](https://github.com/github/spec-kit).
37
+
38
+ ## Qu'est-ce que devflow ?
39
+
40
+ devflow impose un workflow séquentiel où chaque feature est spécifiée, planifiée et reviewée **avant** toute ligne de code. Le pipeline complet :
41
+
42
+ ```
43
+ constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done
44
+ ```
45
+
46
+ Les gates de review (`review-spec`, `review-tasks`, `review-impl`) sont bloquantes : aucune progression sans verdict PASS.
47
+
48
+ Deux interfaces complémentaires :
49
+ - **CLI Python** (`devflow`) — pour gérer les branches, le statut et l'installation
50
+ - **Commandes slash** (`/devflow.*`) — pour piloter le workflow dans Claude Code
51
+
52
+ ## Prérequis
53
+
54
+ - **Python 3.11+**
55
+ - **Claude Code** (CLI)
56
+ - **git**
57
+
58
+ ## Installation
59
+
60
+ ```bash
61
+ uv tool install devflow-cli
62
+ ```
63
+
64
+ Ou avec pip :
65
+
66
+ ```bash
67
+ pip install devflow-cli
68
+ ```
69
+
70
+ Pour vérifier l'installation :
71
+
72
+ ```bash
73
+ devflow check
74
+ ```
75
+
76
+ > Pour l'installation en mode développeur, voir [CONTRIBUTING.md](CONTRIBUTING.md).
77
+
78
+ ## Quick Start
79
+
80
+ ### 1. Initialiser devflow dans votre projet
81
+
82
+ ```bash
83
+ devflow init
84
+ ```
85
+
86
+ Cela copie les commandes, agents et templates dans votre configuration Claude Code.
87
+
88
+ ### 2. Créer une feature
89
+
90
+ ```bash
91
+ devflow feature KS-123 --short-name "user-auth"
92
+ ```
93
+
94
+ Crée la branche et le dossier de specs associé.
95
+
96
+ ### 3. Suivre le pipeline
97
+
98
+ Dans Claude Code, lancez les commandes slash dans l'ordre :
99
+
100
+ ```
101
+ /devflow.spec "Description de la feature"
102
+ /devflow.clarify
103
+ /devflow.plan
104
+ /devflow.tasks
105
+ /devflow.implement
106
+ ```
107
+
108
+ Chaque commande produit un artefact (`spec.md`, `plan.md`, `tasks.md`, etc.) et fait avancer la feature dans le pipeline.
109
+
110
+ ### 4. Suivre la progression
111
+
112
+ ```bash
113
+ devflow status
114
+ ```
115
+
116
+ ## Documentation
117
+
118
+ Consultez la [documentation complète](docs/index.md) pour :
119
+
120
+ - [Pipeline détaillé](docs/pipeline.md) — les 13 étapes expliquées
121
+ - [Commandes CLI](docs/cli-reference.md) — référence des 11 commandes terminal
122
+ - [Commandes slash](docs/commands-reference.md) — référence des 23 commandes Claude Code
123
+ - [Guides par type de projet](docs/index.md#guides-par-type-de-projet) — brownfield, greenfield, microservices
124
+
125
+ ## Contribuer
126
+
127
+ Les contributions sont les bienvenues. Consultez le [guide de contribution](CONTRIBUTING.md) pour les prérequis, l'installation dev et les conventions.
128
+
129
+ ## English Summary
130
+
131
+ **devflow** is a Spec-Driven Development toolkit for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It enforces a structured pipeline where every feature goes through specification, planning, and review gates before any code is written.
132
+
133
+ The full pipeline: `constitution → spec → clarify → review-spec → research → plan → contracts → tasks → review-tasks → implement → review-impl → docs → done`.
134
+
135
+ **Install:** `uv tool install devflow-cli` (or `pip install devflow-cli`). Requires Python 3.11+, Claude Code CLI, git.
136
+
137
+ **Quick start:**
138
+ 1. `devflow init` — set up devflow in your project
139
+ 2. `devflow feature KS-123` — create a feature branch
140
+ 3. `/devflow.spec "..."` → `/devflow.plan` → `/devflow.tasks` → `/devflow.implement` — follow the pipeline in Claude Code
141
+
142
+ For full documentation, see [docs/index.md](docs/index.md). To contribute, see [CONTRIBUTING.md](CONTRIBUTING.md).
@@ -0,0 +1,30 @@
1
+ devflow_cli/__init__.py,sha256=pdaWiv6opWxczLu9BcHNUQQqeeOVp702swwquzGZMKk,888
2
+ devflow_cli/cli.py,sha256=PaoxyJ7Fi-orfy_ZT5f7wtcFkllqSw4yP6aNI0W7aCI,1383
3
+ devflow_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
4
+ devflow_cli/commands/check.py,sha256=tPZiPRjxROk-pTrchXnSa_jVLMxIE-Rc520o7nPNLM8,4703
5
+ devflow_cli/commands/context.py,sha256=umZSPg9JJSn8wWINOlLbTpP0QBtVf6VkNPmNoepxJmE,5998
6
+ devflow_cli/commands/export_cmd.py,sha256=Mdvoh8oyainm0ulaaLd3pcx9m2s-Go--fFBeLS6i9Ts,4871
7
+ devflow_cli/commands/extension.py,sha256=gL33YS8EuBTADmqKGDqw_0gJXFwccwg1uJmCNtvexhE,4373
8
+ devflow_cli/commands/feature.py,sha256=33HGF_lFegtFW09ay6MwH5a98-LHKeYN2Tc6OIeZVSU,3669
9
+ devflow_cli/commands/init_cmd.py,sha256=AsUWxKPnMZgJBzVx83BfrTJOqXWJu_SJ1j23yJIzv3w,3694
10
+ devflow_cli/commands/migrate_cmd.py,sha256=Tp_AMuHbo9ENqvJWW6YlFcgrRLPyKOnTk9p4zAMKsXU,3358
11
+ devflow_cli/commands/regen.py,sha256=UyB7_0oBxDs_CqaAQ6yE2Yoz4IcpUr2bqkIEmm0e1iM,3198
12
+ devflow_cli/commands/status.py,sha256=4JJ8ZWVqAiS88G1I7HaGG7Mf0Z7cyGr2UzX-41cSHJ8,4065
13
+ devflow_cli/commands/upgrade_cmd.py,sha256=tc2h0RjyH4aMf_wCnbMU6k8slkf0kbmbMEbJ1ZJCjas,4878
14
+ devflow_cli/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
15
+ devflow_cli/core/catalog.py,sha256=oMBZRigOtpAQceu3slV8UpuKSZpkxQcr4xtjZXyFHYY,2949
16
+ devflow_cli/core/git.py,sha256=xvzo0y8b3xNVss_p1fmf5LaIRgkRJzjkoJBUsxxnKqw,2101
17
+ devflow_cli/core/hooks.py,sha256=EHIlpwmDYHshaDijiLCEoPDbnV9T7jDttOCnpRRx0HU,3025
18
+ devflow_cli/core/installer.py,sha256=ljnAOmvpu33EdP9O8QYSpmjUgR1sGZcikTA7SxuW2Ck,4435
19
+ devflow_cli/core/manifest.py,sha256=5hu2w6PPGo4raGbgKzx6qpAtt653SrzpRkbWngHM9qw,5770
20
+ devflow_cli/core/scanner.py,sha256=hHyw7YTYY_UCHFYNvzC_-_tvQcdWOSm90kmKiK_f8mM,4307
21
+ devflow_cli/core/staleness.py,sha256=NCW0adRNwMXlQHt-xS1K_0t83SjBMF7FR0fyuY8t6FM,4609
22
+ devflow_cli/core/state.py,sha256=Kzt1M1l2rn4UA-wS8MzdkJM6Jz-GhwMxqBhN_c3kkdw,1953
23
+ devflow_cli/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
24
+ devflow_cli/utils/console.py,sha256=t7cpyeEluWj4v_O_KFSI59iqXK4GiSXPuxlsr8q5zoQ,771
25
+ devflow_cli/utils/paths.py,sha256=iQH6TUd7s4CfKCS3EJ0Xd6b8iDMSq9RD1c8ieD85Hp4,4372
26
+ devflow_cli-1.0.0.dist-info/METADATA,sha256=WArcH2pilVT1TKbOtjvJquW4gDIl5BEJYp46Pz19pyI,4844
27
+ devflow_cli-1.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
28
+ devflow_cli-1.0.0.dist-info/entry_points.txt,sha256=GVJ6bMvFpqyO5589iC4nFKeGTpGIW8aKn_QPPpSZ6kU,48
29
+ devflow_cli-1.0.0.dist-info/licenses/LICENSE,sha256=v79PvnmqOdKhQiOa_QcWxng4q8GuGscLOwi7ygUpwpo,1070
30
+ devflow_cli-1.0.0.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.29.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ devflow = devflow_cli.cli:app
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 sopequenoteck
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.