devflow-cli 2.9.0__tar.gz → 3.0.0__tar.gz

{devflow_cli-2.9.0 → devflow_cli-3.0.0}/.github/workflows/ci.yml

@@ -30,7 +30,10 @@ jobs:
           uv pip install -e ".[dev]"
 
       - name: Run pytest
-        run: uv run pytest tests/ -v
+        run: uv run pytest tests/ -v --ignore=tests/test_wheel_adaptive_acceptance.py
+
+      - name: Run installed-wheel adaptive acceptance
+        run: uv run pytest tests/test_wheel_adaptive_acceptance.py -v
 
       - name: Check generated documentation
         run: uv run devflow docs-sync --check

{devflow_cli-2.9.0 → devflow_cli-3.0.0}/.github/workflows/release.yml

@@ -24,7 +24,10 @@ jobs:
           uv pip install -e ".[dev]"
 
       - name: Run tests
-        run: uv run pytest tests/ -v
+        run: uv run pytest tests/ -v --ignore=tests/test_wheel_adaptive_acceptance.py
+
+      - name: Run installed-wheel adaptive acceptance
+        run: uv run pytest tests/test_wheel_adaptive_acceptance.py -v
 
   publish:
     needs: test

{devflow_cli-2.9.0 → devflow_cli-3.0.0}/.idea/workspace.xml

@@ -4,25 +4,28 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="4d5164b1-14ff-40b3-8f55-b6f2c3abff01" name="Changes" comment="" />
+    <list default="true" id="4d5164b1-14ff-40b3-8f55-b6f2c3abff01" name="Changes" comment="">
+      <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/devflow_cli/utils/paths.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/devflow_cli/utils/paths.py" afterDir="false" />
+    </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
     <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
     <option name="LAST_RESOLUTION" value="IGNORE" />
   </component>
   <component name="EmbeddingIndexingInfo">
-    <option name="cachedIndexableFilesCount" value="1409" />
+    <option name="cachedIndexableFilesCount" value="1457" />
     <option name="fileBasedEmbeddingIndicesEnabled" value="true" />
   </component>
   <component name="Git.Settings">
     <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
   </component>
-  <component name="GitHubPullRequestSearchHistory"><![CDATA[{
-  "lastFilter": {
-    "state": "OPEN",
-    "assignee": "sopequenoteck"
+  <component name="GitHubPullRequestSearchHistory">{
+  &quot;lastFilter&quot;: {
+    &quot;state&quot;: &quot;OPEN&quot;,
+    &quot;assignee&quot;: &quot;sopequenoteck&quot;
   }
-}]]></component>
+}</component>
   <component name="GitToolBoxStore">
     <option name="branchesCleanupHistory">
       <BranchesCleanupHistory>
@@ -151,21 +154,44 @@
         </option>
       </BranchesCleanupHistory>
     </option>
+    <option name="recentBranches">
+      <RecentBranches>
+        <option name="branchesForRepo">
+          <list>
+            <RecentBranchesForRepo>
+              <option name="branches">
+                <list>
+                  <RecentBranch>
+                    <option name="branchName" value="main" />
+                    <option name="lastUsedInstant" value="1787262556" />
+                  </RecentBranch>
+                  <RecentBranch>
+                    <option name="branchName" value="develop" />
+                    <option name="lastUsedInstant" value="1787262555" />
+                  </RecentBranch>
+                </list>
+              </option>
+              <option name="repositoryRootUrl" value="file://$PROJECT_DIR$" />
+            </RecentBranchesForRepo>
+          </list>
+        </option>
+      </RecentBranches>
+    </option>
   </component>
-  <component name="GithubPullRequestsUISettings"><![CDATA[{
-  "selectedUrlAndAccountId": {
-    "url": "https://github.com/sopequenoteck/devflow.git",
-    "accountId": "8169ef0d-6593-43b8-9a77-2780a60dc5ac"
+  <component name="GithubPullRequestsUISettings">{
+  &quot;selectedUrlAndAccountId&quot;: {
+    &quot;url&quot;: &quot;https://github.com/sopequenoteck/devflow.git&quot;,
+    &quot;accountId&quot;: &quot;8169ef0d-6593-43b8-9a77-2780a60dc5ac&quot;
   }
-}]]></component>
+}</component>
   <component name="McpProjectServerCommands">
     <commands />
     <urls />
   </component>
-  <component name="ProjectColorInfo"><![CDATA[{
-  "associatedIndex": 7,
-  "fromUser": false
-}]]></component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 7,
+  &quot;fromUser&quot;: false
+}</component>
   <component name="ProjectId" id="3I2KWolJpZcPmEOGT7J0Rsp6K3n" />
   <component name="ProjectViewState">
     <option name="hideEmptyMiddlePackages" value="true" />
@@ -184,7 +210,7 @@
     "codeWithMe.voiceChat.enabledByDefault": "false",
     "com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true",
     "dart.analysis.tool.window.visible": "false",
-    "git-widget-placeholder": "develop",
+    "git-widget-placeholder": "main",
     "junie.onboarding.icon.badge.shown": "true",
     "kotlin-language-version-configured": "true",
     "last_opened_file_path": "/Users/kellysossoe/Code/Apps/devflow",
@@ -215,6 +241,7 @@
       <option name="presentableId" value="Default" />
       <updated>1786957258019</updated>
       <workItem from="1786957259143" duration="1286000" />
+      <workItem from="1787262300781" duration="880000" />
     </task>
     <servers />
   </component>

{devflow_cli-2.9.0 → devflow_cli-3.0.0}/CHANGELOG.md

@@ -5,6 +5,22 @@ Tous les changements notables de ce projet sont documentés dans ce fichier.
 Le format est basé sur [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/),
 et ce projet adhère au [Semantic Versioning](https://semver.org/lang/fr/).
 
+## [3.0.0] - 2026-08-25
+
+### Changed
+
+- Le moteur de workflow historique est remplacé par le workflow adaptatif, fondé sur des activités vérifiables, des contrats structurés et des preuves locales.
+- Le parcours quotidien passe par `devflow assess` puis `devflow adaptive start`, `run` et `status`.
+- Les adaptateurs Codex, Claude Code et Cursor utilisent désormais le même contrat d'activité portable.
+
+### Removed
+
+- Les commandes, états et artefacts du moteur de workflow historique sont supprimés.
+
+### Migration
+
+- Pour reprendre une feature existante, exécuter `devflow migrate <ISSUE_ID> --dry-run`, puis `devflow migrate <ISSUE_ID>` après vérification. L'ancien état est conservé sous `legacy-state.json`.
+
 ## [2.9.0] - 2026-08-20
 
 ### Added

devflow_cli-3.0.0/CLAUDE.md

@@ -0,0 +1,20 @@
+# Devflow
+
+Ce dépôt implémente exclusivement un workflow adaptatif. Les changements de
+politique passent par `assessment.json`; les transitions passent par la CLI et
+ne doivent jamais être réalisées en éditant les fichiers d’état.
+
+<!-- devflow:pipeline:start -->
+Workflow adaptatif à quatre profils, sélectionné par `devflow assess` : quick: assess → implement → verify → done; standard: assess → prepare → implement → verify → done; deep: assess → spec → plan → tasks → implement → verify → review → done; critical: assess → risk-assessment → spec → research → contracts → plan → tasks → implement → verify → review → rollback-check → done. `assessment.json` porte la politique et `workflow-state.json` porte uniquement la progression et les preuves.
+<!-- devflow:pipeline:end -->
+
+## Commandes de développement
+
+```bash
+uv run pytest -q
+./tests/run-tests.sh
+uv run devflow docs-sync --check
+```
+
+Pour un essai réel : `feature`, `assess`, `adaptive start`, puis une activité à
+la fois avec `adaptive run`.

{devflow_cli-2.9.0 → devflow_cli-3.0.0}/CONTRIBUTING.md

@@ -92,7 +92,7 @@ Les tests bash couvrent les scripts legacy (`devflow-cli.sh`, `setup-feature.sh`
 
 ## Développer une extension
 
-Voir le guide complet : [extensions/EXTENSION-DEVELOPMENT-GUIDE.md](./extensions/EXTENSION-DEVELOPMENT-GUIDE.md).
+Voir la référence : [extensions/EXTENSION-API-REFERENCE.md](./extensions/EXTENSION-API-REFERENCE.md).
 
 En résumé :
 1. Créer un manifest JSON suivant le schéma dans [EXTENSION-API-REFERENCE.md](./extensions/EXTENSION-API-REFERENCE.md)

devflow_cli-3.0.0/PKG-INFO

@@ -0,0 +1,113 @@
+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
+```

devflow_cli-3.0.0/README.md

@@ -0,0 +1,85 @@
+# 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
+```

{devflow_cli-2.9.0 → devflow_cli-3.0.0}/commands/devflow.init.md

@@ -1,6 +1,6 @@
 # /devflow.init
 
-Initialise devflow dans un projet : copie les commandes, agents, templates et scripts vers ~/.claude/ et prépare la structure projet.
+Initialise devflow dans un projet : copie la façade adaptative, les templates et les scripts vers ~/.claude/ et prépare la structure projet.
 
 ## Objectif
 
@@ -19,12 +19,10 @@ Installer ou réinstaller devflow de manière propre avec validation post-instal
 2. **Vérifier** que le projet cible est un dépôt git (sinon → erreur)
 3. **Créer `.specify/specs/`** dans le projet cible si absent
 4. **Copier les commandes** devflow vers `~/.claude/commands/`
-5. **Copier les agents** devflow vers `~/.claude/agents/`
-6. **Copier les templates** vers `~/.claude/templates/`
-7. **Copier les scripts** vers `~/.claude/scripts/` et ajouter +x
-8. Si `--with-constitution` : copier le template constitution vers `.specify/memory/constitution.md` du projet cible (ne pas écraser si existant, sauf --force)
-9. **Appeler `check-prerequisites.sh`** pour valider l'installation
-10. **Afficher le rapport** : X fichiers copiés, Y ignorés (existants)
+5. **Copier les templates** vers `~/.claude/templates/`
+6. **Copier les scripts** vers `~/.claude/scripts/` et ajouter +x
+7. Si `--with-constitution` : copier le template constitution vers `.specify/memory/constitution.md` du projet cible (ne pas écraser si existant, sauf --force)
+8. **Afficher le rapport** : X fichiers copiés, Y ignorés (existants)
 
 ## Contraintes
 

devflow_cli-3.0.0/commands/devflow.md

@@ -0,0 +1,25 @@
+---
+description: Pilote le workflow adaptatif Devflow depuis Claude Code
+argument-hint: ISSUE_ID [--agent claude|codex|cursor]
+allowed-tools: Bash(devflow:*)
+---
+
+# Devflow adaptatif
+
+Utiliser exclusivement la machine adaptative de la CLI. Ne jamais créer ni
+interpréter de `state.json`.
+
+1. Lire `$ARGUMENTS` et extraire l'identifiant de feature.
+2. Exécuter `devflow status ISSUE_ID`.
+3. Si la feature n'existe pas, demander à l'utilisateur de lancer
+   `devflow feature ISSUE_ID`.
+4. Si elle n'est pas évaluée, demander les signaux nécessaires puis lancer
+   `devflow assess ISSUE_ID` avec des options explicites.
+5. Si elle est évaluée mais non démarrée, lancer
+   `devflow adaptive start ISSUE_ID`.
+6. Lancer une seule activité avec
+   `devflow adaptive run ISSUE_ID --agent AGENT`.
+7. Afficher ensuite `devflow adaptive status ISSUE_ID`.
+
+Le contrat produit par Devflow est la seule autorité sur les actions,
+artefacts, validations et preuves de l'activité.

devflow_cli-3.0.0/commands/devflow.regen.md

@@ -0,0 +1,34 @@
+# /devflow.regen
+
+Détecte les artefacts désuets et rouvre la première activité concernée.
+
+## Objectif
+
+Revenir au premier artefact désuet afin que le workflow adaptatif régénère ensuite la chaîne sous contrôle de ses contrats.
+
+## Workflow
+
+1. **Detecter** les artefacts desuets :
+   ```bash
+   devflow stale --json
+   ```
+   Parse le JSON retourne. Si `stale` est vide, afficher "Tout est synchronise" et terminer.
+
+2. **Afficher la prévisualisation** :
+   - Lister chaque artefact stale avec sa raison
+   - Afficher la commande `adaptive reopen` du premier artefact désuet
+
+3. **Demander confirmation** a l'utilisateur.
+   - Si refuse → terminer sans action.
+
+4. **Exécuter uniquement la première commande** `adaptive reopen`.
+5. Afficher `devflow adaptive status ISSUE_ID` et proposer de reprendre avec
+   `devflow adaptive run ISSUE_ID --agent AGENT`.
+
+6. **Rapporter** l’activité rouverte et les artefacts qui seront régénérés.
+
+## Contraintes
+
+- Utiliser `devflow stale --json` pour la detection (ne pas reimplementer la logique mtime)
+- Ne jamais exécuter plusieurs `reopen` successifs
+- Ne jamais regenerer sans confirmation explicite

devflow_cli-3.0.0/commands/devflow.status.md

@@ -0,0 +1,11 @@
+---
+description: Affiche le statut adaptatif d'une feature Devflow
+argument-hint: ISSUE_ID
+allowed-tools: Bash(devflow status:*)
+---
+
+# Statut Devflow
+
+Exécuter `devflow status $ARGUMENTS` et restituer fidèlement le profil,
+l'activité courante, la progression et les preuves restantes. Cette commande
+est strictement en lecture seule.

{devflow_cli-2.9.0 → devflow_cli-3.0.0}/docs/activity-contracts.md

@@ -1,5 +1,27 @@
 # Contrats d'activités adaptatifs
 
+## Schémas publics versionnés
+
+Les quatre frontières centrales sont décrites par des JSON Schemas Draft
+2020-12 embarqués dans le wheel :
+
+- `assessment-v1.schema.json` pour la sélection de politique ;
+- `workflow-state-v2.schema.json` pour la progression et les preuves ;
+- `activity-contract-v1.schema.json` pour l'instruction portable envoyée à
+  l'adaptateur ;
+- `activity-result-v1.schema.json` pour la réponse structurée de l'agent.
+
+Le schéma vérifie la structure, les types, les champs obligatoires et refuse les
+champs inconnus. Les validations Python restent responsables des invariants
+métier qui dépendent du profil ou de l'activité : ordre de progression, source
+des preuves, traçabilité et gates de fin.
+
+Une version publiée est immuable. Comme les champs inconnus sont refusés,
+l'ajout, le retrait ou le changement de sens d'un champ exige une nouvelle
+version de schéma et, pour les formats persistés, une voie de migration
+explicite. Devflow ne réinterprète jamais silencieusement un contrat d'une
+version inconnue.
+
 Les contrats d'activités constituent la frontière entre le moteur devflow et
 les agents d'exécution. Ils ne contiennent aucune commande propre à Claude
 Code, Codex ou Cursor.
@@ -84,17 +106,21 @@ Le validateur refuse notamment :
 Cette validation est partagée par tous les futurs adaptateurs. Aucun backend
 ne pourra définir ses propres critères de réussite.
 
-## Exécution avec Codex
+## Exécution multi-agent
 
-Le premier adaptateur structuré est Codex :
+Les trois adaptateurs peuvent exécuter le même contrat :
 
 ```bash
 devflow adaptive run KS-123 --agent codex
+devflow adaptive run KS-123 --agent claude-code
+devflow adaptive run KS-123 --agent cursor
 ```
 
 Une invocation exécute uniquement l'activité courante. Devflow transmet le
-schéma avec l'option native de sortie structurée de Codex, récupère le dernier
-message dans un fichier temporaire, puis applique le validateur commun.
+schéma avec les options natives de Codex ou Claude Code. Cursor produit une
+enveloppe JSON dont le résultat est extrait puis validé localement contre le
+même schéma. Dans les trois cas, seul le payload normalisé est transmis au
+validateur commun.
 
 Pour `prepare`, toute mutation du working tree est refusée. Son résultat est
 ajouté aux entrées du contrat `implement` standard.

devflow_cli-3.0.0/docs/cli-reference.md

@@ -0,0 +1,105 @@
+# Référence CLI
+
+## Initialisation
+
+```bash
+devflow init --ai codex
+devflow feature ISSUE_ID [--short-name NAME]
+```
+
+## Évaluation
+
+```bash
+devflow assess ISSUE_ID \
+  --scope local|multiple|transversal \
+  --ambiguity low|medium|high \
+  --risk low|medium|high \
+  [--contract-change] [--data-security] \
+  [--profile quick|standard|deep|critical]
+```
+
+Un profil forcé peut augmenter mais jamais réduire la recommandation.
+
+## Exécution adaptative
+
+```bash
+devflow adaptive start ISSUE_ID
+devflow adaptive status ISSUE_ID [--json]
+devflow adaptive contract ISSUE_ID [--json|--prompt]
+devflow adaptive run ISSUE_ID --agent codex|claude|cursor
+devflow adaptive complete ISSUE_ID ACTIVITY
+devflow adaptive evidence ISSUE_ID EVIDENCE_ID --report TEXT
+devflow adaptive verify ISSUE_ID
+devflow adaptive reopen ISSUE_ID ACTIVITY --reason TEXT
+```
+
+`complete` et `evidence` restent utiles aux automatisations; le parcours normal
+utilise `run`, qui valide le contrat et les mutations observées.
+
+### Statut opérationnel et reprise
+
+`adaptive status` affiche la progression, chaque preuve avec sa provenance, les
+blocages, les risques restants, le dernier résultat et la prochaine commande à
+exécuter. `--json` expose les mêmes informations sous une forme stable pour les
+automatisations.
+
+Après un échec, `adaptive run` et `adaptive verify` impriment une reprise guidée :
+inspection du statut, diagnostic de l'agent, contrôle des changements partiels
+ou réouverture auditée de `implement`. Un workflow terminé affiche un résumé des
+activités, des preuves, des risques et le chemin du worklog.
+
+Les erreurs de contrat indiquent le fichier et le chemin JSON fautif. Un JSON
+mal formé indique également la ligne et la colonne.
+
+### Codes de sortie adaptatifs
+
+Les commandes sous `devflow adaptive` utilisent les codes stables suivants :
+
+| Code | Signification |
+|---:|---|
+| 0 | succès |
+| 2 | usage ou options incompatibles |
+| 3 | activité bloquée ou gate non satisfaite |
+| 4 | assessment, état ou contrat invalide |
+| 5 | échec ou indisponibilité de l'agent |
+| 6 | vérification locale échouée |
+| 7 | conflit de progression ou modification concurrente |
+
+Un code non nul ne signifie donc plus seulement « erreur » : la CI peut décider
+si elle doit demander une intervention fonctionnelle (`3`), réparer
+l'environnement agent (`5`) ou traiter une régression de validation (`6`).
+
+## Inspection et outils
+
+```bash
+devflow status [ISSUE_ID]
+devflow traceability ISSUE_ID
+devflow verify ISSUE_ID
+devflow stale ISSUE_ID
+devflow context ISSUE_ID
+devflow linear decision ACTIVITY CURRENT_STATUS
+```
+
+## Migration
+
+```bash
+devflow migrate [ISSUE_ID] [--profile deep] [--dry-run]
+```
+
+La migration archive l’ancien fichier sous `legacy-state.json`; elle ne tente
+pas de déclarer comme terminée une activité dont les preuves adaptatives
+n’existent pas.
+
+Lors d’un `init` ou d’un `upgrade`, les anciennes commandes Claude officielles
+sont retirées des dossiers actifs et sauvegardées dans
+`~/.claude/.devflow-legacy-backup/`.
+
+## Maintenance
+
+```bash
+devflow check --ai codex|claude-code|cursor
+devflow upgrade
+devflow docs-sync --check
+devflow extension list
+devflow hooks run EVENT
+```

devflow_cli-3.0.0/docs/commands-reference.md

@@ -0,0 +1,13 @@
+# Façade Claude Code
+
+L’installation Claude Code publie une façade adaptative minimale :
+
+- `/devflow ISSUE_ID [--agent ...]` inspecte la feature et exécute au plus une
+  activité via la CLI.
+- `/devflow.status ISSUE_ID` affiche le statut en lecture seule.
+- `/devflow.context`, `/devflow.init`, `/devflow.extension` et
+  `/devflow.regen` restent des utilitaires non séquentiels.
+
+Les anciennes commandes slash par étape n’existent plus. Le contrat généré par
+`devflow adaptive run` détermine désormais l’activité, les artefacts et les
+preuves, quel que soit l’agent choisi.