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

devflow_cli-2.9.0/.githooks/post-checkout

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+# Hook devflow — promotion automatique vers ~/.claude/ sur checkout develop.
+# Déclenché uniquement pour un checkout de branche (flag $3 = 1).
+
+set -u
+
+prev_ref=$1
+new_ref=$2
+branch_checkout=$3
+
+# Ignore les checkout de fichiers (ex: git checkout -- file)
+[ "$branch_checkout" = "1" ] || exit 0
+
+# Ignore si la HEAD n'a pas changé (no-op rebase steps)
+[ "$prev_ref" != "$new_ref" ] || exit 0
+
+branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
+[ "$branch" = "develop" ] || exit 0
+
+if ! command -v devflow >/dev/null 2>&1; then
+  echo "[devflow hooks] devflow CLI introuvable dans le PATH — promotion ignorée." >&2
+  exit 0
+fi
+
+echo "[devflow hooks] checkout develop → devflow init --here --force"
+devflow init --here --force

devflow_cli-2.9.0/.githooks/post-merge

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Hook devflow — promotion automatique vers ~/.claude/ sur merge develop.
+
+set -u
+
+branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
+[ "$branch" = "develop" ] || exit 0
+
+if ! command -v devflow >/dev/null 2>&1; then
+  echo "[devflow hooks] devflow CLI introuvable dans le PATH — promotion ignorée." >&2
+  exit 0
+fi
+
+echo "[devflow hooks] merge sur develop → devflow init --here --force"
+devflow init --here --force

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

@@ -32,5 +32,8 @@ jobs:
       - name: Run pytest
         run: uv run pytest tests/ -v
 
+      - name: Check generated documentation
+        run: uv run devflow docs-sync --check
+
       - name: Run bash tests
         run: ./tests/run-tests.sh

{devflow_cli-2.3.0 → devflow_cli-2.9.0}/.gitignore

@@ -12,3 +12,4 @@ venv/
 .DS_Store
 .coverage
 .devflow/
+.state.lock

devflow_cli-2.9.0/.idea/.gitignore

@@ -0,0 +1,10 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Ignored default folder with query files
+/queries/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

devflow_cli-2.9.0/.idea/devflow.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

devflow_cli-2.9.0/.idea/misc.xml

@@ -0,0 +1,5 @@
+<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" />
+  </component>
+</project>

devflow_cli-2.9.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/devflow.iml" filepath="$PROJECT_DIR$/.idea/devflow.iml" />
+    </modules>
+  </component>
+</project>

devflow_cli-2.9.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

devflow_cli-2.9.0/.idea/workspace.xml

@@ -0,0 +1,224 @@
+<?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="" />
+    <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="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>
+  <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>
+  </component>
+  <component name="GithubPullRequestsUISettings"><![CDATA[{
+  "selectedUrlAndAccountId": {
+    "url": "https://github.com/sopequenoteck/devflow.git",
+    "accountId": "8169ef0d-6593-43b8-9a77-2780a60dc5ac"
+  }
+}]]></component>
+  <component name="McpProjectServerCommands">
+    <commands />
+    <urls />
+  </component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 7,
+  "fromUser": 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": "develop",
+    "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" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+</project>

devflow_cli-2.9.0/.specify/specs/027-pipeline-auto-execution/checklists/requirements.md

@@ -0,0 +1,35 @@
+# Specification Quality Checklist: Pipeline Auto-Execution
+
+**Purpose**: Validate specification completeness and quality before proceeding to planning
+**Created**: 2026-03-24
+**Feature**: [spec.md](../spec.md)
+
+## Content Quality
+
+- [x] No implementation details (languages, frameworks, APIs)
+- [x] Focused on user value and business needs
+- [x] Written for non-technical stakeholders
+- [x] All mandatory sections completed
+
+## Requirement Completeness
+
+- [x] No [NEEDS CLARIFICATION] markers remain
+- [x] Requirements are testable and unambiguous
+- [x] Success criteria are measurable
+- [x] Success criteria are technology-agnostic (no implementation details)
+- [x] All acceptance scenarios are defined
+- [x] Edge cases are identified
+- [x] Scope is clearly bounded
+- [x] Dependencies and assumptions identified
+
+## Feature Readiness
+
+- [x] All functional requirements have clear acceptance criteria
+- [x] User scenarios cover primary flows
+- [x] Feature meets measurable outcomes defined in Success Criteria
+- [x] No implementation details leak into specification
+
+## Notes
+
+- All items pass validation. Spec is ready for `/speckit.clarify` or `/speckit.plan`.
+- La spec fait reference a des composants existants (fichiers, constantes) dans la section "Comportement existant" et "Impact sur l'existant" car c'est un projet brownfield — ceci est attendu pour documenter le delta, pas pour prescrire l'implementation.

devflow_cli-2.9.0/.specify/specs/027-pipeline-auto-execution/contracts/orchestrator-contract.md

@@ -0,0 +1,77 @@
+# Contract: Orchestrateur /devflow
+
+**Feature**: 027-pipeline-auto-execution
+**Date**: 2026-03-25
+
+## Interface — commande `/devflow`
+
+### Arguments (mis a jour)
+
+```
+/devflow <ISSUE_ID> [STEP] [--step] [--recover]
+```
+
+| Argument | Type | Requis | Description |
+|----------|------|--------|-------------|
+| ISSUE_ID | string | oui | Identifiant de l'issue (ex: KS-123) |
+| STEP | string | non | Force la reprise a une etape specifique |
+| --step | flag | non | Mode une-etape-a-la-fois (desactive le chainage) |
+| --recover | flag | non | Reconstruit state.json depuis les artefacts |
+
+### Comportement par defaut (chainage)
+
+```
+ENTREE: ISSUE_ID
+SORTIE: Pipeline execute jusqu'a un point d'arret naturel
+
+1. Creer/checkout branche git (si necessaire)
+2. Lire state.json → currentStep
+3. BOUCLE (max 15 iterations):
+   a. Si currentStep == "done" → afficher resume, SORTIE
+   b. Si etape optionnelle:
+      - mode fast → skip automatique
+      - mode full → demander a l'utilisateur
+   c. Executer /devflow.{currentStep} ISSUE_ID
+   d. Relire state.json
+   e. Verifier progression (anti-boucle)
+   f. Si review gate:
+      - PASS → continuer
+      - WARNING → afficher, demander confirmation
+      - BLOQUANT → ARRET
+   g. Si --step → ARRET
+4. SORTIE
+```
+
+### Points d'arret du chainage
+
+| Condition | Action |
+|-----------|--------|
+| `currentStep == "done"` | Afficher resume final |
+| Review gate BLOQUANT | Arreter, afficher les blockers |
+| Review gate WARNING | Pause, demander confirmation |
+| Etape optionnelle (mode full) | Pause, demander skip/execute |
+| Flag `--step` | Arreter apres 1 etape |
+| Compteur >= 15 | Arreter avec avertissement de securite |
+| currentStep n'a pas progresse | Arreter avec erreur (anti-boucle) |
+
+## Interface — sync Linear (toutes commandes)
+
+### Protocole de non-regression
+
+```
+ENTREE: issue_id, statut_cible (depuis STEP_LINEAR_MAPPING)
+SORTIE: statut Linear mis a jour ou conserve
+
+1. get_issue(issue_id) → statut_actuel
+2. Si erreur (API down, issue inexistante) → warning, SORTIE sans modification
+3. index_actuel = STEP_LINEAR_ORDER.index(statut_actuel) ou -1 si inconnu
+4. index_cible = STEP_LINEAR_ORDER.index(statut_cible)
+5. Si index_actuel >= index_cible → log "conserve", SORTIE sans modification
+6. save_issue(issue_id, statut_cible)
+```
+
+### Cas limites
+
+- Statut Linear inconnu (custom/non-mappe) : traiter index comme -1 → toujours mettre a jour
+- API Linear indisponible : continuer sans sync, logger warning
+- Issue inexistante : continuer sans sync, logger warning

devflow_cli-2.9.0/.specify/specs/027-pipeline-auto-execution/data-model.md

@@ -0,0 +1,54 @@
+# Data Model: Pipeline Auto-Execution
+
+**Feature**: 027-pipeline-auto-execution
+**Date**: 2026-03-25
+
+## Entites existantes (inchangees)
+
+### FeatureState (state.json)
+
+Aucun changement de schema. Les champs existants suffisent :
+- `currentStep` : etape courante (utilise par la boucle de chainage)
+- `completedSteps` : etapes terminees (utilise pour detecter la progression)
+- `skippedSteps` : etapes sautees (utilise pour l'auto-skip)
+- `mode` : "full" ou "fast" (determine le comportement des etapes optionnelles)
+- `reviewIterations` : compteur par gate (utilise pour les verdicts)
+
+### STEP_LINEAR_MAPPING (existant)
+
+Inchange. Mapping complet etape → statut Linear.
+
+## Nouvelle constante
+
+### STEP_LINEAR_ORDER
+
+**Fichier**: `src/devflow_cli/__init__.py`
+
+Liste ordonnee des statuts Linear par progression croissante :
+
+```python
+STEP_LINEAR_ORDER = [
+    "Backlog",
+    "Spec",
+    "Research",
+    "Plan",
+    "Tasks",
+    "Review",
+    "In Progress",
+    "Doc",
+    "Done",
+]
+```
+
+**Usage**: Permet de comparer deux statuts Linear pour determiner si une mise a jour constituerait une regression.
+
+**Regle**: `statut_actuel_index >= statut_cible_index` → ne pas mettre a jour.
+
+**Coherence**: Doit etre maintenu en parallele avec `STEP_LINEAR_MAPPING`. Un assert de coherence sera ajoute (meme pattern que les asserts existants dans `__init__.py`).
+
+## Relations
+
+```
+STEP_LINEAR_MAPPING --mappe vers--> STEP_LINEAR_ORDER (statuts)
+FeatureState.currentStep --determine--> STEP_LINEAR_MAPPING[currentStep] --compare avec--> statut actuel Linear
+```