English | 简体中文 | 한국어 | Español | Français | Deutsch | Português (Brasil) | Русский
DyroEngineeringFlow · dyro CLI est une plateforme local-first d'automatisation d'ingénierie et de contrôle de livraison pour les équipes multi-dépôts. Elle regroupe lignes de développement, Git worktrees, lanceurs d'agents, portes de tâches, revue indépendante et audit de fusion dans une configuration d'espace de travail versionnée.
Dyro est un moteur de physique de livraison local-first pour dépôts multiples : il décide ce qui peut devenir vrai, quand cette vérité se dégrade, et qui peut changer le monde.
dyro proof verify relie l'espace de travail courant. dyro proof verify-bundle ne vérifie que l'intégrité portable : l'appelant doit fournir chaque --git-dir contenant les objets épinglés (recherche en union, pas une carte de dépôts). Sans objets le résultat est inconclusive. Integrity live n'est pas merge.
Faire avancer l'ingénierie de la tâche à la livraison.
Chaque équipe fournit un Profile dyro.toml pour les dépôts, layouts, adaptateurs d'agent et politique de livraison ; les règles métier, le coût des modèles et les pratiques de release restent dans ce Profile.
- Une tâche appartient à exactement une ligne de développement—jamais un workspace feature/hotfix mélangé.
- Chaque tâche s'exécute dans son propre
git worktreesur la branchetask/<id>. - Les portes sont exécutées par l'orchestrateur ; l'auto-rapport d'un agent n'est pas une preuve de succès.
- La revue est liée au reçu d'exécution et aux HEAD exacts par dépôt ; une dérive du code l'invalide.
- Une revue indépendante est requise avant
done; merge et push exigent une confirmation explicite par défaut. - Une dépendance terminée ne libère l'aval qu'après intégration de ses HEAD de tâche exacts dans la ligne propriétaire.
- La configuration exécutable est des tableaux argv. Le noyau n'exécute jamais de chaînes shell issues du TOML.
Les diagrammes suivants s'affichent directement sur GitHub en Mermaid (pas de liens d'images). Le plan de contrôle sépare le Profile d'équipe de Dyro Core. L'état d'exécution est sous .dyro/. Les libellés des diagrammes sont en anglais (alignés CLI / clés de config).
flowchart TB
subgraph Profile["Project Profile (team-supplied)"]
P1["repositories / layout / bases"]
P2["Agent adapter argv"]
P3["gates / receipt templates / policy"]
end
subgraph Core["Dyro Core · dyro CLI (mechanism)"]
W["workspace<br/>anchors · lines · doctor"]
L["launch<br/>safe argv templates"]
D["dispatch<br/>DAG · claim · state machine"]
V["verify<br/>gates · ledger"]
M["merge<br/>preflight · recovery · push policy"]
end
subgraph Runtime["Workspace runtime .dyro/"]
R1["tasks / lines / changes"]
R2["evidence · review · ledger"]
end
Profile --> Core
Core --> Runtime
Human["Engineer / release owner"] --> Core
Agent["Local agent CLI"] --> L
Runner["Isolated runner (optional)"] -.->|"evidence ZIP"| D
flowchart TB
WS["workspace root<br/>dyro.toml"]
WS --> REPO["repositories/"]
WS --> DYRO[".dyro/"]
WS --> VER["versions/ or layout.lines"]
WS --> WT["worktrees/ or layout.tasks"]
REPO --> API["services/api · Git anchor"]
REPO --> WEB["services/web · Git anchor"]
DYRO --> LINES["lines/<id>.toml"]
DYRO --> TASKS["tasks/<id>/"]
DYRO --> CHG["changes/ · decisions · ledger"]
TASKS --> TT["task.toml · handoff.md"]
TASKS --> EV["evidence-imports/ · review.md"]
WT --> TAPI["task/API-101/services/api"]
WT --> TWEB["task/API-101/services/web"]
VER --> LAPI["release-…/services/api worktree"]
VER --> LWEB["release-…/services/web worktree"]
stateDiagram-v2
[*] --> backlog
backlog --> assigned: claim / next
assigned --> in_progress: run starts
in_progress --> waiting_answer: human answer needed
waiting_answer --> in_progress: task answer
in_progress --> review: gates pass · private evidence flow
in_progress --> failed: failure
failed --> assigned: re-claim
review --> review_pending_signoff: verified review · private flow
review --> done: independent review PASS · private flow
review_pending_signoff --> done: task signoff · private flow
done --> [*]: task merge into line
sequenceDiagram
actor Eng as Engineer
participant CLI as dyro CLI
participant FS as Workspace Git / .dyro
participant Agent as Agent adapter
Eng->>CLI: setup / doctor / line create
CLI->>FS: register line · create line worktrees
Eng->>CLI: task create · task next
CLI->>FS: write task.toml · allocate worktree
Eng->>CLI: task run / open --agent
CLI->>Agent: argv launch into task worktree
Agent-->>CLI: work finished (not gate evidence)
CLI->>CLI: run Profile gates
CLI->>FS: receipt · heads · attempt
Eng->>CLI: task review
CLI->>FS: receipt-bound review
Eng->>CLI: task merge --yes
CLI->>FS: merge into line · update ledger
sequenceDiagram
actor Ctrl as Control-plane operator
participant CLI as dyro control plane
participant Run as Isolated runner
participant Rev as Independent reviewer
Ctrl->>CLI: task claim --by runner-id
CLI-->>Run: claim active · conflict group held
Run->>Run: execute in isolation · declared gates
Run->>CLI: evidence build → ZIP
Ctrl->>CLI: evidence execution --bundle
CLI->>CLI: validate ZIP · heads · gates · signing policy
Rev->>CLI: evidence review / review-build
CLI->>CLI: bind receipt + task heads
opt require_external_signoff
Ctrl->>CLI: task signoff --by approver
end
Ctrl->>CLI: task merge --yes
flowchart LR
subgraph Nodes
T1["Task A"]
T2["Task B"]
T3["Task C"]
D1["Decision<br/>blocked_on"]
end
T1 -->|depends_on| T2
T2 -->|depends_on| T3
T3 --> D1
CG["conflict_group: db-migrate<br/>mutex within a wave"]
T1 -.-> CG
T2 -.-> CG
flowchart TB
Snap["Immutable schedule snapshot<br/>graph + state + claims"]
Ready["ready set<br/>deps integrated · decisions OK"]
Wave["current wave<br/>--parallel × conflict_group"]
Snap --> Ready --> Wave
flowchart LR
subgraph Actors
Dev["Developer"]
Lead["Release owner"]
Runner["Isolated runner"]
Reviewer["Independent reviewer"]
end
subgraph UC["Primary use cases"]
U1["Init workspace setup/init"]
U2["Create line / hotfix"]
U3["Create and schedule tasks"]
U4["Local run and gates"]
U5["Import external evidence"]
U6["Independent review and signoff"]
U7["Merge and Change Set verify"]
U8["Audit sync to Witness"]
end
Dev --> U1
Dev --> U3
Dev --> U4
Lead --> U2
Lead --> U7
Lead --> U8
Runner --> U5
Reviewer --> U6
Dev --> U6
flowchart TB
Host["Host agent<br/>current conversation"]
Disp["local_agent_dispatch<br/>contract · guards · leases"]
B1["Backend CLI A"]
B2["Backend CLI B"]
Board["Adversarial review board<br/>signed sections + final call"]
Dyro["Dyro control plane<br/>claim · gates · merge"]
Host -->|"TaskContract JSON"| Disp
Disp --> B1
Disp --> B2
B1 -->|"summary + evidence"| Host
B2 -->|"summary + evidence"| Host
Host --> Board
Board -.->|"advisory only"| Host
Host -->|"explicit dyro commands"| Dyro
Livré avec dyro (dyro dispatch …). Le dispatch est consultatif ; la livraison reste gates/merge Dyro.
sequenceDiagram
participant H as Host agent
participant S as DispatchSupervisor
participant W as Worker or backend
participant P as Review board file
H->>S: run --wait TaskContract
S->>S: validate files · secret guard · take slot
S->>W: self-contained prompt + allowlisted context
W-->>S: ResultEnvelope
S->>S: mark locator verified
S-->>H: run_id · summary · evidence
H->>P: write own signed section
Note over H,P: Do not edit others sections - source is authority
H->>H: optional code change / PR after final call
Note over H: Delivery still uses dyro task merge
Pour un usage quotidien du CLI, installez dyro depuis PyPI dans un environnement pipx isolé (Python 3.11 ou plus) :
python3 -m pip install --user --upgrade pipx
python3 -m pipx ensurepath
# Ouvrez un nouveau terminal après ensurepath, puis :
pipx install dyro
dyro --versionPour mettre à jour : pipx upgrade dyro. Si l'équipe gère Python avec pip :
python3 -m pip install --user --upgrade dyroLe dyro setup interactif peut installer le Skill du plan de contrôle. Après
une mise à jour du paquet, les Skills déjà gérés se synchronisent
automatiquement ; les lancements interactifs réparent aussi un Skill managed
obsolète. La première installation reste opt-in via setup ou
dyro integration install skill --yes (alias : codex).
Les lancements interactifs dyro, dyro home ou dyro start interrogent le point officiel PyPI au plus une fois par jour local. Un échec ne bloque jamais l’espace de travail et chaque mise à jour reste soumise à confirmation par défaut :
dyro update # vérifier, confirmer, puis installer (équivalent à dyro update now)
dyro update check # vérification seulement
dyro update now # alias de dyro update
dyro update auto on # active les mises à jour correctives automatiques
dyro update auto off
dyro update disable
dyro update enableLes mises à jour automatiques ne changent jamais de version mineure ou majeure et n’écrasent pas une installation éditable. DYRO_NO_UPDATE_CHECK=1 ignore le contrôle au démarrage. Voir les mises à jour sûres.
Pour développer Dyro lui-même, utilisez la chaîne d'outils verrouillée du dépôt et sa vraie entrée de tests ; les exemples de gates de projet ci-dessous ne sont pas les tests de Dyro.
uv sync --locked --all-extras --dev
uv run python -m unittest discover -s tests -t . -v
uv run ruff check src tests experimentsPour le premier lancement, placez-vous dans un répertoire qui contient des dépôts ou dans un projet Git existant, puis exécutez :
dyro setupLe guide affiche son plan avant toute écriture. Depuis la racine d'un projet Git, il propose un workspace Dyro voisin et clone depuis origin, sans écrire d'état de contrôle dans le projet d'origine. Il détecte des commandes d'Agent usuelles mais n'enregistre que les adaptateurs dont le contrat argv Core est audité. n ou une sortie ne crée rien. Exécutez ensuite :
dyro nextPour les scripts et la CI, conservez des options explicites :
dyro setup . --name my-workspace --line dev --yes --non-interactiveLes aperçus sûrs acceptent les deux formes :
dyro --dry-run setup . --name my-workspace --no-line
dyro setup . --name my-workspace --no-line --dry-runAjoutez un dépôt plus tard sans ouvrir dyro.toml :
dyro repo add repositories/services/payments
dyro repo listGérez la politique de livraison courante et les adaptateurs d'Agent sans ouvrir dyro.toml :
dyro config set policy.execution_mode external
dyro config get policy.execution_mode
dyro agent add ci-runner --preset noop
dyro agent test ci-runnerSi le Profile contient des remotes, les anchors manquants peuvent être créés en toute sécurité :
dyro --dry-run bootstrap
dyro bootstrap --yes
dyro doctorAprès la configuration, dyro next recommande la prochaine action sûre. Lorsque vous êtes prêt à choisir une ligne et un Agent configuré :
dyro startUtilisez des commandes explicites pour scripter ou piloter une release :
dyro doctor
dyro line create release-2026-10 --base origin/main --yes
# Ne remplacez la base vérifiée que pour les dépôts qui en ont besoin.
dyro line create release-2026-10 --base origin/main --repo-base web=v2026.10.0 --yes
dyro open release-2026-10 --agent codex
dyro task create API-101 --title "Implement API contract" --line release-2026-10 --repository api
dyro task graph check --line release-2026-10
dyro task graph --line release-2026-10 --format mermaid
dyro task explain API-101
dyro task next
dyro task next --run --yes
dyro task attempts API-101
dyro task binding API-101
dyro task review API-101
dyro task merge API-101 --yes
dyro changeset create release-2026-10-ready --line release-2026-10
dyro changeset verify release-2026-10-readyUn hotfix de production doit déclarer sa base de production vérifiée ; il n'hérite jamais implicitement d'une branche par défaut :
dyro hotfix create incident-123 --base v2026.09.7 --repos api,web --yesSi l'exécution et l'approbation sont gérées par un système de confiance séparé, définissez policy.execution_mode = "external" et policy.require_external_signoff = true. Dyro local n'autorise alors que la planification ; une revue liée au reçu et aux HEAD exacts doit être signée explicitement avant done :
dyro task claim API-101 --by isolated-runner-1 --key-id runner-2026 \
--output /secure-transfer/API-101.core-claim.json
# Un travail long doit renouveler son claim borné avant expiration.
dyro task claim-renew API-101 --by isolated-runner-1 --lease-seconds 3600
# Dans le runner isolé : exécutez les gates déclarées et empaquetez reçu, logs et HEAD exacts.
dyro task evidence build API-101 --workspace /runner/workspace --receipt /runner/out/receipt.md --output /runner/out/API-101.zip
# Sur le plan de contrôle : validez et importez le paquet portable unique.
dyro task evidence execution API-101 --bundle /runner/out/API-101.zip
dyro task evidence review API-101 --file /review/out/review.md
dyro task signoff API-101 --by release-manager
# Une affectation abandonnée peut être libérée explicitement.
dyro task claim-release API-101 --by isolated-runner-1Les nouveaux paquets de preuve doivent inclure provenance.json. Importer un paquet legacy sans provenance est une migration délibérée (--allow-legacy). Si le runner renvoie QUESTION, enregistrez la réponse avec dyro task answer API-101 --text "..." ; le claim est conservé et la tâche repasse en assigned.
Inspectez et conservez en sécurité les générations de preuves immuables :
dyro task evidence generations API-101
dyro --dry-run task evidence generations API-101 --prune --older-than-days 30 --keep 10
dyro task evidence generations API-101 --prune --older-than-days 30 --keep 10 --yesPour l'identité cryptographique du runner et de l'approbateur, générez les clés hors workspace et n'installez que les clés publiques dans des magasins de confiance séparés par usage :
dyro config set policy.execution_mode external
dyro config set policy.require_signed_execution true
dyro config set policy.require_signed_review true
dyro config set policy.require_external_signoff true
dyro config set policy.require_signed_signoff true
dyro key generate runner-2026 --private-key /secure/runner.pem --public-key /secure/runner.pub.pem
dyro key trust runner-2026 --purpose execution --public-key /secure/runner.pub.pem --not-after 2027-01-01T00:00:00+00:00
dyro task claim API-101 --by isolated-runner-1 --key-id runner-2026 \
--output /secure-transfer/API-101.core-claim.json
dyro task evidence build API-101 --workspace /runner/workspace --receipt /runner/out/receipt.md --output /runner/out/API-101.zip --claim /runner/in/claim.json --signing-key /secure/runner.pem --key-id runner-2026
dyro key generate reviewer-2026 --private-key /secure/reviewer.pem --public-key /secure/reviewer.pub.pem
dyro key trust reviewer-2026 --purpose review --public-key /secure/reviewer.pub.pem
dyro task evidence review-build API-101 --file /review/out/review.md --reviewer independent-reviewer --output /review/out/review.json --signing-key /secure/reviewer.pem --key-id reviewer-2026
dyro task evidence review API-101 --file /review/out/review.json
dyro key generate approver-2026 --private-key /secure/approver.pem --public-key /secure/approver.pub.pem
dyro key trust approver-2026 --purpose signoff --public-key /secure/approver.pub.pem
dyro task signoff API-101 --by release-manager --signing-key /secure/approver.pem --key-id approver-2026
dyro key list --purpose execution --show-status
dyro key revoke runner-2026 --purpose execution --reason "runner retired"
dyro key auditSynchronisez la chaîne d'audit de confiance locale vers un Witness indépendant :
dyro key generate audit-client-2026 --private-key /secure/audit-client.pem --public-key /secure/audit-client.pub.pem
# Installez audit-client.pub.pem sur le Witness via un canal sécurisé hors bande.
dyro key trust witness-2026 --purpose audit-receipt --public-key witness-2026.pub.pem
dyro key trust witness-recovery --purpose audit-recovery --public-key witness-recovery.pub.pem
DYRO_AUDIT_TOKEN=... dyro key audit-sync --witness primary --endpoint https://audit.example.com/v1/dyro/batches --signing-key /secure/audit-client.pem --key-id audit-client-2026 --witness-key-id witness-2026 --witness-recovery-key-id witness-recoveryMême sans nouvel événement, la commande envoie un checkpoint signé ; en cas de réponse perdue, le batch pending déjà persisté est rejoué tel quel. Le Witness doit recalculer la chaîne, rejeter les forks de séquence ou de tête, émettre un reçu vérifiable et écrire batches et reçus en stockage immuable avec rétention. Voir Audit Witness protocol.
Service Witness livré : dyro witness serve. Par défaut : bearer token + TLS ; le checkpoint n'avance qu'après records/<batch-sha256>.json. En production, séparez checkpoint mutable et archives records immuables. Voir Witness deployment.
L'obligation de signature est contrôlée par policy.require_signed_execution, policy.require_signed_review et policy.require_signed_signoff ; supprimer toutes les clés de confiance ne désactive pas une politique active. Les claims d'exécution signés lient claim_id, génération, runner et ID de clé. Messages et hashs de plan utilisent RFC 8785 JCS. Les relecteurs indépendants produisent une enveloppe JSON signée via dyro task evidence review-build. Rotation non disruptive : faire confiance au nouvel ID, conserver l'ancien pendant le chevauchement, puis révoquer.
Un signataire TypeScript de référence et un vecteur d'interop Python/Node se trouvent dans examples/typescript-runner/.
Toute opération d'écriture a un mode planification :
dyro --dry-run line create release-2026-10 --base origin/main
dyro --dry-run task run API-101| Commande | Rôle |
|---|---|
setup / init --discover / init --wizard / repo add/list / bootstrap / start |
Onboarding sans TOML, gestion des anchors, choix de ligne et d'agent. |
doctor / status |
Valider et afficher l'état du plan de contrôle. |
line create/list |
Créer, enregistrer et inspecter les lignes feature. |
hotfix create |
Créer une ligne hotfix depuis une base de production explicite. |
changeset create/list/verify |
Figer et vérifier les HEAD Git propres exacts d'une livraison multi-dépôts. |
config get/set / agent list/add/test / open |
Gérer politique et adaptateurs, valider un exécutable ou ouvrir un agent sur la bonne ligne. |
task create/list/board/status/next/graph/explain/attempts/binding |
Manifestes et état, graphe, planification, provenance et liaison de revue exacte. |
task run/answer/gates/review/signoff |
Exécuter, répondre, gates, revue indépendante et sign-off externe si requis. |
task claim --output / task evidence build/execution/review |
Claim unique avec fichier de transfert créé exclusivement, build/import de preuve portable et import de revue liée au reçu. |
task merge |
Fusionner la branche de tâche revue dans sa ligne propriétaire. |
task loop/daemon/stats/decisions |
Lots contrôlés, ordonnancement, ledger et portes de décision. |
dispatch |
Dispatch multi-agents local optionnel (L0–L4) ; consultatif — ne remplace pas gates/merge. |
Détail : architecture et Profile, diagrammes, migration, publication PyPI (mainteneurs).
Ce README est maintenu en anglais, chinois simplifié, coréen, espagnol, français, allemand, portugais brésilien et russe. Commandes, clés de configuration, noms de répertoires et règles de sécurité sont identiques dans toutes les traductions. Les messages CLI et guides techniques étendus sont surtout en chinois ; le README multilingue n'implique pas de bascule de langue runtime.
DyroEngineeringFlow fournit un flux local complet et des contrôles de politique pour les équipes en mode planification. Il ne crée pas de dépôts distants, n'embarque pas d'identifiants SaaS et ne provisionne aucun runner externe ; il conserve un contrat portable de paquet de preuves pour une exécution externe. Le dispatch local d'agents optionnel est livré sous experiments.local_agent_dispatch et s'utilise avec dyro dispatch … ; il est seulement consultatif et ne remplace jamais gates, review, signoff ni merge. Les merges multi-dépôts locaux sont prévolés et récupérés comme une opération ; les serveurs Git distants ne proposent pas de push atomique multi-dépôts, donc un échec partiel est enregistré. Le merge automatique exige l'autorisation du manifeste de tâche et de la politique locale. MIT License et dyro sur PyPI.