IdeA/.ideai/tickets/289/carnet.md

issueRef, version, updatedBy, updatedAt

issueRef	version	updatedBy	updatedAt
#289	4	kind agent_id agent a6c6ea12-bfc6-4bdc-8031-324102dfa34d	1788900709736

2026-09-08 — Main

Demande utilisateur : garantir que si une cible appelée via ask_agent se restart, le demandeur attend la fin du restart et reçoit le travail post-restart rattaché au même agent, aussi bien intra-projet qu'en cross-project.

Cadrage Architect :

• Identité stable par RuntimeAgentKey (projectId, agentId).
• Le conversation_id logique et le verrou de tour doivent survivre au restart.
• Un restart accepté est une activité de contrôle du rendez-vous : ne pas classifier la fermeture de l'ancienne session comme no-reply/timeout d'inactivité.
• Cross-project : conserver la corrélation demandeur (requesterProjectId, requesterAgentId, correlationId) jusqu'au résultat post-restart.
• Cancel pendant restart doit cascader et nettoyer rendez-vous/workstate/registre cross-project.
• Échec de restart => erreur explicite, pas silence.

Branche Git retenue : fix/289-ask-agent-during-target-restart depuis develop @ db91b00.

Prochaines étapes : DevBackend implémente le contrat backend et tests ; QA valide same-project, cross-project, watchdog, failure/cancel.

2026-09-08 — DevBackend

Correctif backend implémenté sur fix/289-ask-agent-during-target-restart.

Fichiers modifiés :

• crates/application/src/orchestrator/service.rs
• crates/application/src/orchestrator/mod.rs
• crates/application/src/lib.rs
• crates/application/tests/orchestrator_service.rs
• crates/backend/src/lib.rs

Comportement livré :

• coordination stable par RuntimeAgentKey (projectId, agentId) entre le rendez-vous applicatif et le scheduler de self-restart ;
• conservation du verrou de tour, du ticket logique et du conversation_id pendant le remplacement de la session concrète ;
• abandon du drain de l'ancienne session sans no-reply, puis capture du Final du tour de continuation sur la session relancée ;
• activité de contrôle restart intégrée au watchdog d'inactivité ;
• corrélation cross-project conservée jusqu'au résultat post-restart ;
• échec de restart remonté explicitement ; cancel pendant la fenêtre sans runtime réveille l'ask, nettoie la corrélation et empêche la relance de continuation ;
• le scheduler standalone conserve son comportement historique lorsque aucun ask n'est actif.

Tests exécutés :

• cargo test -p application --test orchestrator_service — 85 passés ;
• cargo test -p application --lib — 171 passés ;
• cargo test -p backend --lib — 89 passés, 7 ignorés (tests socket nécessitant une permission locale) ;
• cargo check -p backend — OK ;
• cargo fmt --all -- --check — OK.

Tests de régression ajoutés : same-project Final post-restart, cross-project + nettoyage corrélation, faux no-reply interdit, failure explicite, cancel pendant le gap de restart, watchdog réarmé par activité de contrôle.

Limites : pas de test E2E avec un vrai processus fournisseur/AppImage dans ce lot ; la validation est faite avec les ports/sessions structurés et le scheduler backend compilé. Aucun fichier frontend modifié. Aucun commit effectué par DevBackend.

2026-09-08 — QA

Verdict : VERT pour le ticket #289 sur fix/289-ask-agent-during-target-restart.

Tests QA ajoutés dans crates/application/tests/orchestrator_service.rs :

• ask_target_restart_cleans_busy_workstate_and_replaces_structured_registry_entry : succès same-project post-restart, cible revenue Idle, FIFO vide, live-state Done, ancienne session structurée absente, session de remplacement enregistrée sur le même agent logique.
• same_project_stop_during_restart_releases_ask_and_leaves_no_replacement_session : cancel/stop same-project pendant le gap de restart, ask réveillé en erreur explicite de cancel, busy/FIFO/live-state nettoyés, aucune session de remplacement enregistrée.

Commandes exécutées et sorties pertinentes :

git status --short --branch

## fix/289-ask-agent-during-target-restart
 M .ideai/tickets/counter.json
 M .ideai/tickets/index.json
 M crates/application/src/lib.rs
 M crates/application/src/orchestrator/mod.rs
 M crates/application/src/orchestrator/service.rs
 M crates/application/tests/orchestrator_service.rs
 M crates/backend/src/lib.rs
?? .ideai/tickets/289/
?? scripts/

cargo test -p application --test orchestrator_service ask_target_restart_keeps_logical_turn_and_returns_post_restart_final -- --nocapture

test ask_target_restart_keeps_logical_turn_and_returns_post_restart_final ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 84 filtered out; finished in 0.02s

cargo test -p application --test orchestrator_service cross_project_ask_preserves_correlation_across_target_restart -- --nocapture

test cross_project_ask_preserves_correlation_across_target_restart ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 84 filtered out; finished in 0.02s

cargo test -p application --test orchestrator_service ask_target_restart_failure_is_explicit_not_no_reply -- --nocapture

test ask_target_restart_failure_is_explicit_not_no_reply ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 84 filtered out; finished in 0.01s

cargo test -p application --test orchestrator_service cross_project_cancel_during_restart_releases_ask_and_correlation -- --nocapture

test cross_project_cancel_during_restart_releases_ask_and_correlation ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 84 filtered out; finished in 0.00s

cargo test -p application --lib restart_control_activity_rearms_inactivity_watchdog -- --nocapture

test orchestrator::service::tests::restart_control_activity_rearms_inactivity_watchdog ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 170 filtered out; finished in 0.05s

cargo test -p application --test orchestrator_service ask_target_restart_cleans_busy_workstate_and_replaces_structured_registry_entry -- --nocapture

test ask_target_restart_cleans_busy_workstate_and_replaces_structured_registry_entry ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 86 filtered out; finished in 0.02s

cargo test -p application --test orchestrator_service same_project_stop_during_restart_releases_ask_and_leaves_no_replacement_session -- --nocapture

test same_project_stop_during_restart_releases_ask_and_leaves_no_replacement_session ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 86 filtered out; finished in 0.00s

cargo fmt --all -- --check

OK (aucune sortie)

cargo test -p application --test orchestrator_service

running 87 tests
test result: ok. 87 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.09s

cargo test -p application --lib

running 171 tests
test result: ok. 171 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.15s

cargo test -p backend --lib

running 96 tests
test result: ok. 89 passed; 0 failed; 7 ignored; 0 measured; 0 filtered out; finished in 0.04s

cargo check -p backend

Finished `dev` profile [unoptimized + debuginfo] target(s) in 3.37s

Couverture validée :

• same-project : Final récupéré après restart et test QA de nettoyage busy/workstate/registre.
• cross-project : corrélation conservée jusqu'au Final post-restart puis supprimée.
• pas de faux no-reply/timeout pendant restart : failure restart reste PROCESS explicite, watchdog réarmé par activité de contrôle restart.
• failure restart : erreur explicite contenant la cause provider.
• cancel pendant restart : cross-project et same-project couverts.
• nettoyage busy/workstate/registry : FIFO vide, AgentBusyState::Idle, live-state Done, registre structuré remplacé après succès et non recréé après cancel.

Risques résiduels :

• Pas d'E2E AppImage / vrai provider relancé : la preuve porte sur les ports applicatifs, les sessions structurées de test et le câblage backend compilé.
• Les 7 tests backend ignorés demandent une permission de bind socket locale ; ils restent hors preuve dans cet environnement.