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

{devflow_cli-2.8.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.8.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.8.0 → devflow_cli-3.0.0}/.idea/misc.xml

@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="corretto-21" project-jdk-type="JavaSDK">
     <output url="file://$PROJECT_DIR$/out" />

devflow_cli-3.0.0/.idea/workspace.xml

@@ -0,0 +1,251 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <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="1457" />
+    <option name="fileBasedEmbeddingIndicesEnabled" value="true" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="GitHubPullRequestSearchHistory">{
+  &quot;lastFilter&quot;: {
+    &quot;state&quot;: &quot;OPEN&quot;,
+    &quot;assignee&quot;: &quot;sopequenoteck&quot;
+  }
+}</component>
+  <component name="GitToolBoxStore">
+    <option name="branchesCleanupHistory">
+      <BranchesCleanupHistory>
+        <option name="history">
+          <list>
+            <BranchCleanupEntry>
+              <option name="deletions">
+                <list>
+                  <BranchDeletion>
+                    <option name="hash" value="861fc6362be269bb7f402d7760f3bf7b565d7460" />
+                    <option name="name" value="017-fix-robustness-issues" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="608c9bc52be63c110d9d2a9a5b4fe919f90c8154" />
+                    <option name="name" value="026-fix-command-ambiguities" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="c9d97356f42487cc635e82f35068c632449e7459" />
+                    <option name="name" value="016-harden-state-machine" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="f6ef9c69dcc416b37b0d7b15cc2bc418adb94445" />
+                    <option name="name" value="008-hardening-bugs" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="cf559e1c5ab82ad66ad5a6ba9ca8bf3c612a8dbe" />
+                    <option name="name" value="001-cli-init-options" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="9c9ac6ba6122577894e95900414ad21c94117675" />
+                    <option name="name" value="003-usecase-guides" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="7fbc2c734b62139eac11b05a5fc51f31bdb482e8" />
+                    <option name="name" value="007-project-documentation" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="a9402192387c3130a0550834b187d4cd022fc28d" />
+                    <option name="name" value="009-ci-pypi" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="babf269c6d664519da2db7d800ff964e24b29765" />
+                    <option name="name" value="022-fix-regen-command" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="1bc969c678242c64fbdd16339cb2569d555b48ea" />
+                    <option name="name" value="014-enforce-state-machine" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="cf559e1c5ab82ad66ad5a6ba9ca8bf3c612a8dbe" />
+                    <option name="name" value="002-cascade-regen" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="711a399e63592a4650e63f53299603b02b19a8e7" />
+                    <option name="name" value="020-migrate-speckit" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="f83a06b13183c09aa274c9713480da13ba690419" />
+                    <option name="name" value="010-flexible-pipeline" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="9ba410df0892ce61400945b739b28df87b2670d5" />
+                    <option name="name" value="004-specify-central-directory" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="b7141bc1dae8a40dbaf8d2440b2cbd7b7fe3650b" />
+                    <option name="name" value="006-template-upgrade" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="449d3673848e3ceabfe85596c7ce8ec7f69e35b5" />
+                    <option name="name" value="005-implement-subphases" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="bd6a5e9b3463a8330f1a4b033c32437498baa909" />
+                    <option name="name" value="027-pipeline-auto-execution" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="b79001ec8e632e99c5337f66fdd9ecfcdca38810" />
+                    <option name="name" value="021-review-iterations" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="e01363f1ba914e75a33565e598ea3c0c83654a6f" />
+                    <option name="name" value="019-quality-hardening" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="86a6c0fcca1d4c5eb6ed1591f5b43d8dc1fd2e46" />
+                    <option name="name" value="013-align-truth-sources" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="5a987e7e2f7f890c3206247b171fa1c36e2fd108" />
+                    <option name="name" value="018-fix-final-robustness" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="4d3bc84a3b655b019e7f3a55569b6fa2681a3e95" />
+                    <option name="name" value="015-fix-review-contradiction" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="661d72db714f24d86b4d8e8895198d3eabb2450e" />
+                    <option name="name" value="feature/git-hooks-auto-promote" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="db082c4529f8cee67b9f82e702e3928f8ba9adcc" />
+                    <option name="name" value="011-cursor-support" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="83a3817a3e6a87553b17065990c842702309c87b" />
+                    <option name="name" value="025-harden-tests" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="7bf297d86fcb2cd560e2a48e13e037c68f80197d" />
+                    <option name="name" value="012-fix-critical-bugs" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="573bfc9a8fb73e4211493a905fb2a5f3aede7ff5" />
+                    <option name="name" value="023-add-logging" />
+                  </BranchDeletion>
+                  <BranchDeletion>
+                    <option name="hash" value="5fc33e862e6736b67d94690db1117493528cbe85" />
+                    <option name="name" value="024-validate-constants" />
+                  </BranchDeletion>
+                </list>
+              </option>
+              <option name="timestamp" value="1787005388911" />
+            </BranchCleanupEntry>
+          </list>
+        </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">{
+  &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 name="McpProjectServerCommands">
+    <commands />
+    <urls />
+  </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" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ASKED_SHARE_PROJECT_CONFIGURATION_FILES": "true",
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.MCP Project settings loaded": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "SHARE_PROJECT_CONFIGURATION_FILES": "true",
+    "codeWithMe.voiceChat.enabledByDefault": "false",
+    "com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true",
+    "dart.analysis.tool.window.visible": "false",
+    "git-widget-placeholder": "main",
+    "junie.onboarding.icon.badge.shown": "true",
+    "kotlin-language-version-configured": "true",
+    "last_opened_file_path": "/Users/kellysossoe/Code/Apps/devflow",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "settings.editor.selected.configurable": "settings.sync",
+    "show.migrate.to.gradle.popup": "false",
+    "to.speed.mode.migration.done": "true",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-jdk-30f59d01ecdd-37e91769500f-intellij.indexing.shared.core-IU-261.26222.65" />
+        <option value="bundled-js-predefined-d6986cc7102b-31caf2ab9e3c-JavaScript-IU-261.26222.65" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="4d5164b1-14ff-40b3-8f55-b6f2c3abff01" name="Changes" comment="" />
+      <created>1786957258019</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1786957258019</updated>
+      <workItem from="1786957259143" duration="1286000" />
+      <workItem from="1787262300781" duration="880000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+</project>

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

@@ -5,6 +5,41 @@ 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
+
+- Workflows adaptatifs exécutables `quick`, `standard`, `deep` et `critical`, avec contrats d'activités structurés pour Codex.
+- Preuves automatiques, worklog régénérable, dérogations contrôlées et réouverture auditée des activités en remédiation.
+- Gates Critical distinctes pour sécurité/données, review indépendante et rollback, avec rejet des suites sensibles sans test réellement exécuté.
+- Cible officielle `devflow init --ai codex` et diagnostic `devflow check --ai codex` sans dépendance à `~/.claude/`.
+
+### Changed
+
+- Les validations nécessitant Docker ou un service externe sont exécutées par la gate locale `verify` plutôt que dans le sandbox de l'agent.
+- La review consomme les preuves Devflow actuelles et réserve ses propres commandes aux inspections compatibles avec la lecture seule.
+
+### Fixed
+
+- Conservation cumulative du périmètre de fichiers lors des reprises d'implémentation.
+- Rejet explicite des résultats Maven sensibles où tous les tests sont ignorés ou aucun bilan de test n'est détectable.
+
 ## [2.8.0] - 2026-08-17
 
 ### 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.8.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.8.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.