devflow-cli 6.1.1__tar.gz → 6.2.0__tar.gz

devflow_cli-6.2.0/.github/workflows/release.yml

@@ -0,0 +1,155 @@
+name: Release
+
+# Chaque merge sur main publie la version portée par pyproject.toml.
+# Ordre garanti : concordance → tests → build et publication PyPI → tag vX.Y.Z.
+# Un tag implique donc que la version est sur PyPI. Le tag est créé ici, car un
+# tag poussé avec GITHUB_TOKEN ne déclenche aucun autre workflow.
+# Ne pas renommer ce fichier : le Trusted Publisher PyPI y est lié.
+
+on:
+  push:
+    branches: [main]
+
+# Sérialise les releases, sans jamais annuler une publication en cours.
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+# Moindre privilège par défaut ; publish et tag réhaussent ce qu'il leur faut.
+permissions:
+  contents: read
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.value }}
+      release: ${{ steps.decide.outputs.release }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Setup Python
+        run: uv python install 3.12
+
+      # Revérifié ici faute de protection de branche : version-check.yml ne
+      # peut pas empêcher le merge d'une PR aux fichiers discordants.
+      - name: Check version files
+        id: version
+        run: |
+          version="$(uv run --no-project --python 3.12 python scripts/check_release.py)"
+          echo "value=${version}" >> "$GITHUB_OUTPUT"
+
+      - name: Skip if already tagged or published
+        id: decide
+        env:
+          VERSION: ${{ steps.version.outputs.value }}
+        run: |
+          if git ls-remote --exit-code --tags origin "refs/tags/v${VERSION}" >/dev/null; then
+            echo "Tag v${VERSION} existe déjà : rien à publier."
+            echo "release=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          status="$(curl -sS -o /dev/null -w '%{http_code}' "https://pypi.org/pypi/devflow-cli/${VERSION}/json")"
+          case "${status}" in
+            200)
+              echo "devflow-cli ${VERSION} est déjà sur PyPI : rien à publier."
+              echo "release=false" >> "$GITHUB_OUTPUT"
+              ;;
+            404)
+              echo "release=true" >> "$GITHUB_OUTPUT"
+              ;;
+            *)
+              echo "Réponse PyPI inattendue (${status}) pour ${VERSION}."
+              exit 1
+              ;;
+          esac
+
+  test:
+    needs: check
+    if: needs.check.outputs.release == 'true'
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Setup Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Create venv and install dependencies
+        run: |
+          uv venv --python ${{ matrix.python-version }}
+          uv pip install -e ".[dev]"
+
+      - name: Run tests
+        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
+
+      - name: Run bash tests
+        run: ./tests/run-tests.sh
+
+  publish:
+    needs: [check, test]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Build package
+        run: uv build
+
+      # skip-existing : une relance après une publication réussie mais un tag
+      # échoué ne doit pas échouer sur une version déjà présente.
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+
+  tag:
+    needs: [check, publish]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create tag from version
+        env:
+          VERSION: ${{ needs.check.outputs.version }}
+        run: |
+          tag="v${VERSION}"
+          if git rev-parse "${tag}" >/dev/null 2>&1; then
+            echo "Tag ${tag} existe déjà, skip."
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a "${tag}" -m "Release ${tag}"
+          git push origin "${tag}"
+          echo "Tag ${tag} créé et poussé."

devflow_cli-6.2.0/.github/workflows/version-check.yml

@@ -0,0 +1,35 @@
+name: Version Check
+
+# Chaque PR vers main est une version : elle doit augmenter strictement la
+# version de main, et pyproject.toml, VERSION, uv.lock et CHANGELOG.md doivent
+# concorder. Sans protection de branche, ce contrôle reste un signal : release.yml
+# revérifie la concordance avant de publier.
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  check-version:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Setup Python
+        run: uv python install 3.12
+
+      - name: Check version bump and version files
+        run: |
+          git show origin/main:pyproject.toml > "$RUNNER_TEMP/main-pyproject.toml"
+          uv run --no-project --python 3.12 python scripts/check_release.py \
+            --main-pyproject "$RUNNER_TEMP/main-pyproject.toml"

devflow_cli-6.2.0/.specify/specs/029-kks-413/.gitignore

@@ -0,0 +1,2 @@
+# Traces brutes d'agent : elles peuvent contenir le contenu des fichiers lus.
+*.raw.txt

devflow_cli-6.2.0/.specify/specs/029-kks-413/activity-contract.json

@@ -0,0 +1,161 @@
+{
+  "schemaVersion": 3,
+  "contractId": "KKS-413:standard:implement:v3",
+  "issueId": "KKS-413",
+  "profile": "standard",
+  "activity": "implement",
+  "objective": "Publier sur PyPI et taguer automatiquement au merge sur main (chaque PR = une version)",
+  "featurePath": ".specify/specs/029-kks-413",
+  "inputs": [
+    ".specify/specs/029-kks-413/need.md",
+    ".specify/specs/029-kks-413/assessment.json",
+    ".specify/specs/029-kks-413/workflow-state.json",
+    ".specify/specs/029-kks-413/preflight-evidence.md",
+    ".specify/specs/029-kks-413/prepare-result.json"
+  ],
+  "allowedActions": [
+    "read",
+    "write",
+    "execute"
+  ],
+  "constraints": [
+    "Respecter strictement l'objectif et le perimetre du contrat.",
+    "Le besoin de reference est .specify/specs/029-kks-413/need.md ; en cas d'ecart avec objective, il fait foi.",
+    "Preserver les changements utilisateur sans rapport avec cette activite.",
+    "Ne pas modifier state.json, workflow-state.json ou assessment.json.",
+    "Ne pas creer de commit et ne pas changer de branche.",
+    "Signaler tout blocage au lieu de contourner une validation.",
+    "Dans checks, status vaut passed si et seulement si exitCode vaut 0. Une commande dont l'absence de resultat constitue le succes attendu doit etre declaree failed, ou remplacee par une commande qui renvoie 0 en cas de succes.",
+    "Donner un id stable a chaque objectif de check. Si un check echoue puis est corrige et relance pour le meme objectif, reutiliser cet id : seule la derniere tentative fait foi ; signaler dans remainingRisks toute instabilite encore pertinente.",
+    "Limiter les modifications source au changement demande.",
+    "Suivre les conventions et les tests existants du depot.",
+    "Les preuves de gate sont produites par l'activite locale verify, pas par implement.",
+    "Ne pas retourner blocked uniquement parce qu'une validation d'integration exige un service externe inaccessible depuis le sandbox de l'agent (Docker, base de donnees ou reseau) : executer les autres controles, declarer le check echoue et le risque restant, puis retourner completed si le code est coherent et verifiable par verify.",
+    "Prendre en compte la preuve de pre-vol archivee et ne pas la presenter comme absente."
+  ],
+  "completionCriteria": [
+    "Le changement demande est implemente dans le depot.",
+    "Les fichiers modifies sont listes dans le resultat.",
+    "Les risques ou blocages restants sont explicites."
+  ],
+  "requiredEvidence": [],
+  "expectedOutput": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://devflow.dev/schemas/activity-result/v1",
+    "title": "Devflow Activity Result v1",
+    "type": "object",
+    "required": [
+      "schemaVersion",
+      "contractId",
+      "status",
+      "summary",
+      "changedFiles",
+      "checks",
+      "evidence",
+      "remainingRisks",
+      "blockers"
+    ],
+    "properties": {
+      "schemaVersion": {
+        "type": "integer",
+        "const": 1
+      },
+      "contractId": {
+        "type": "string",
+        "minLength": 1
+      },
+      "status": {
+        "type": "string",
+        "enum": [
+          "completed",
+          "blocked"
+        ]
+      },
+      "summary": {
+        "type": "string",
+        "minLength": 1
+      },
+      "changedFiles": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "checks": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "command",
+            "exitCode",
+            "status"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "command": {
+              "type": "string",
+              "minLength": 1
+            },
+            "exitCode": {
+              "type": "integer"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "passed",
+                "failed"
+              ]
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "evidence": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "id",
+            "outcome",
+            "report"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "outcome": {
+              "type": "string",
+              "enum": [
+                "passed",
+                "failed"
+              ]
+            },
+            "report": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "remainingRisks": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "blockers": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "additionalProperties": false
+  }
+}

devflow_cli-6.2.0/.specify/specs/029-kks-413/agent-execution.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "runId": "3969de1a-59b3-4e1c-82b5-73e1a627947e",
+  "agent": "claude",
+  "activity": "implement",
+  "returnCode": 0,
+  "durationSeconds": 184.311,
+  "finalOutputStatus": "present",
+  "finalOutputBytes": 4818,
+  "finalOutputDiagnostic": "validated",
+  "sessionId": null,
+  "timedOut": false,
+  "worktreeChanged": true,
+  "worktreeChangedFileCount": 11
+}

devflow_cli-6.2.0/.specify/specs/029-kks-413/assessment.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 3,
+  "issueId": "KKS-413",
+  "recommendedProfile": "standard",
+  "selectedProfile": "standard",
+  "confidence": "medium",
+  "signals": {
+    "scope": "multiple",
+    "ambiguity": "low",
+    "risk": "medium",
+    "contractChange": false,
+    "dataOrSecurity": false
+  },
+  "reasons": [
+    "plusieurs composants sont affectes",
+    "le risque d'impact est modere"
+  ],
+  "activities": [
+    "assess",
+    "prepare",
+    "preflight-evidence",
+    "implement",
+    "verify",
+    "done"
+  ],
+  "requiredEvidence": [
+    "targeted-tests",
+    "regression-check",
+    "diff-inspection"
+  ],
+  "assessedAt": "2026-09-28T19:53:43Z",
+  "summary": "Publier sur PyPI et taguer automatiquement au merge sur main (chaque PR = une version)"
+}

devflow_cli-6.2.0/.specify/specs/029-kks-413/evidence/diff-inspection.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": 1,
+  "id": "diff-inspection",
+  "outcome": "passed",
+  "generatedAt": "2026-09-28T22:03:19Z",
+  "changedFiles": [
+    ".github/workflows/release.yml",
+    ".github/workflows/version-check.yml",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "README.md",
+    "docs/releases/6.2.0.md",
+    "pyproject.toml",
+    "scripts/check_release.py",
+    "src/devflow_cli/__init__.py",
+    "tests/test_release.py",
+    "uv.lock"
+  ],
+  "findings": [],
+  "gitDiffCheck": {
+    "id": "AUTO-DIFF",
+    "command": [
+      "git",
+      "diff",
+      "--check"
+    ],
+    "blocking": true,
+    "returncode": 0,
+    "succeeded": true,
+    "timedOut": false,
+    "workingDirectory": ".",
+    "stdout": "",
+    "stderr": ""
+  }
+}

devflow_cli-6.2.0/.specify/specs/029-kks-413/evidence/regression-check.json

@@ -0,0 +1,185 @@
+{
+  "schemaVersion": 1,
+  "id": "regression-check",
+  "outcome": "passed",
+  "startedAt": "2026-09-28T22:02:38Z",
+  "completedAt": "2026-09-28T22:03:19Z",
+  "commands": [
+    {
+      "id": "AUTO-REGRESSION-PYTHON",
+      "command": [
+        "python",
+        "-m",
+        "compileall",
+        "-q",
+        "src"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-release-tests",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_release.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": ".............................                                            [100%]\n29 passed in 0.15s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-full-suite",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "........................................................................ [  9%]\n........................................................................ [ 18%]\n........................................................................ [ 27%]\n........................................................................ [ 36%]\n........................................................................ [ 45%]\n........................................................................ [ 55%]\n........................................................................ [ 64%]\n........................................................................ [ 73%]\n........................................................................ [ 82%]\n........................................................................ [ 91%]\n.................................................................        [100%]\n785 passed in 38.98s\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-release-script-py312",
+      "command": [
+        "uv",
+        "run",
+        "--no-project",
+        "--python",
+        "3.12",
+        "python",
+        "-m",
+        "pytest",
+        "-q",
+        "tests/test_release.py"
+      ],
+      "blocking": false,
+      "returncode": 1,
+      "succeeded": false,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "",
+      "stderr": "/Users/kellysossoe/.local/share/uv/python/cpython-3.12.12-macos-aarch64-none/bin/python3.12: No module named pytest\n"
+    },
+    {
+      "id": "PREP-docs-sync",
+      "command": [
+        "uv",
+        "run",
+        "devflow",
+        "docs-sync",
+        "--check"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "[OK]   Documentation déjà synchronisée.\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-no-tag-trigger",
+      "command": [
+        "rg",
+        "-n",
+        "branches:",
+        "-g",
+        "release.yml",
+        ".github/workflows"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": ".github/workflows/release.yml:11:    branches: [main]\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-publish-skip-existing",
+      "command": [
+        "rg",
+        "-n",
+        "skip-existing",
+        "-g",
+        "release.yml",
+        ".github/workflows"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": ".github/workflows/release.yml:125:      # skip-existing : une relance après une publication réussie mais un tag\n.github/workflows/release.yml:130:          skip-existing: true\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-version-check-present",
+      "command": [
+        "rg",
+        "--files",
+        "-g",
+        "version-check.yml",
+        ".github/workflows"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": ".github/workflows/version-check.yml\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-install-pinned-doc",
+      "command": [
+        "rg",
+        "-n",
+        "devflow-cli==",
+        "README.md",
+        "CONTRIBUTING.md"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": "README.md:21:uv tool install devflow-cli==X.Y.Z   # version publiée, voir CHANGELOG.md\nCONTRIBUTING.md:127:(`uv tool install devflow-cli==X.Y.Z`).\n",
+      "stderr": ""
+    },
+    {
+      "id": "PREP-diff-inspection",
+      "command": [
+        "git",
+        "diff",
+        "--stat"
+      ],
+      "blocking": false,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": " .github/workflows/release.yml |  97 +++++++++++++++++++++----\n CHANGELOG.md                  |  14 ++++\n CONTRIBUTING.md               |  19 +++++\n README.md                     |   6 +-\n pyproject.toml                |   2 +-\n scripts/check_release.py      |  61 ++++++++++------\n src/devflow_cli/__init__.py   |   2 +-\n tests/test_release.py         | 163 ++++++++++++++++++++++++++++++++----------\n uv.lock                       |   2 +-\n 9 files changed, 291 insertions(+), 75 deletions(-)\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}

devflow_cli-6.2.0/.specify/specs/029-kks-413/evidence/targeted-tests.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "id": "targeted-tests",
+  "outcome": "passed",
+  "startedAt": "2026-09-28T22:02:38Z",
+  "completedAt": "2026-09-28T22:03:19Z",
+  "commands": [
+    {
+      "id": "AUTO-PYTHON",
+      "command": [
+        "uv",
+        "run",
+        "pytest",
+        "-q",
+        "tests/test_release.py"
+      ],
+      "blocking": true,
+      "returncode": 0,
+      "succeeded": true,
+      "timedOut": false,
+      "workingDirectory": ".",
+      "stdout": ".............................                                            [100%]\n29 passed in 0.14s\n",
+      "stderr": ""
+    }
+  ],
+  "worktreeMutations": [],
+  "waiversApplied": []
+}