126 lines
5.0 KiB
Markdown
126 lines
5.0 KiB
Markdown
<!-- file: deltas/0.3.7/pre.010.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.7-pre.010` — Cancel ciblé et races terminales Backfill Desk
|
|
|
|
## 1. Base requise
|
|
|
|
```text
|
|
0.3.7-pre.009-fix.002
|
|
workspace.package.version = 0.3.7-pre.9.fix.2
|
|
```
|
|
|
|
## 2. Objectif
|
|
|
|
Ouvrir le contrôle coopératif d'un run déjà admis sans modifier le contrat de campagne : Cancel ciblé par JobId backend, idempotence, protection contre les requêtes périmées, état cancelling observable et shutdown applicatif best-effort. Resume reste hors périmètre.
|
|
|
|
## 3. Cancel ciblé
|
|
|
|
La nouvelle commande `backfill_cancel(job_id)` accepte uniquement le JobId généré par le backend et déjà projeté par le monitoring. Le slot single-run vérifie l'identité avant d'appeler `BackfillJobHandle::cancel()`.
|
|
|
|
Cette cible évite qu'un Cancel IPC retardé destiné au run N puisse annuler le run N+1 après une terminaison rapide et un nouveau Start.
|
|
|
|
## 4. Idempotence et races
|
|
|
|
Règles appliquées :
|
|
|
|
- premier Cancel pré-terminal : `accepted=true` ;
|
|
- répétition sur le même run : `accepted=false`, sans effet supplémentaire ;
|
|
- terminal déjà gagné : `accepted=false` avec état terminal ;
|
|
- JobId différent du run actif ou du terminal retenu : erreur stable `backfill_desk/backfill_run_mismatch` ;
|
|
- absence de run actif/retenu correspondant : `backfill_desk/backfill_run_not_active` ;
|
|
- Start continue d'être refusé tant que le slot actif existe, y compris pendant cancelling.
|
|
|
|
Le DTO de réponse contient seulement `accepted`, `job_id` et `state`.
|
|
|
|
## 5. Shutdown coopératif
|
|
|
|
Le close de la fenêtre principale gagne d'abord le one-shot `begin_shutdown()`, ce qui bloque tout nouveau Start. Il demande ensuite best-effort l'annulation du run actif avant de poursuivre le shutdown Store/process.
|
|
|
|
Cette séquence ne promet pas le drain crash-safe du travail déjà soumis. La sémantique de drain coopératif reste celle de `ksp-job-backfill-lib` : arrêt des nouvelles admissions et traitement du travail déjà engagé avant terminal lorsque le process reste vivant.
|
|
|
|
## 6. Frontend
|
|
|
|
La carte latest-value ajoute **Annuler**. Le bouton n'est disponible que pour un statut actif, transmet uniquement `jobId`, affiche l'acceptation sûre puis resynchronise immédiatement via `backfill_status`.
|
|
|
|
Aucune adresse, signature, ancre, provider, endpoint, credential, checkpoint ou payload métier n'est envoyé ou journalisé par le chemin Cancel.
|
|
|
|
## 7. Version
|
|
|
|
```text
|
|
workspace.package.version = 0.3.7-pre.10
|
|
label = 0.3.7-pre.010
|
|
```
|
|
|
|
## 8. Fichiers ajoutés
|
|
|
|
```text
|
|
deltas/0.3.7/pre.010.md
|
|
```
|
|
|
|
## 9. Fichiers modifiés
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-app-backfill-desk/frontend/main.html
|
|
crates/ksp-app-backfill-desk/frontend/ts/main.ts
|
|
crates/ksp-app-backfill-desk/src/app_state.rs
|
|
crates/ksp-app-backfill-desk/src/backfill_run.rs
|
|
crates/ksp-app-backfill-desk/src/dto_backfill.rs
|
|
crates/ksp-app-backfill-desk/src/errors.rs
|
|
crates/ksp-app-backfill-desk/src/lib.rs
|
|
crates/ksp-app-backfill-desk/src/tauri.rs
|
|
crates/ksp-app-backfill-desk/tests/desktop_contract.rs
|
|
crates/ksp-app-backfill-desk/tests/desktop_security.rs
|
|
crates/ksp-app-backfill-desk/unit_tests/backfill_run.rs
|
|
crates/ksp-app-backfill-desk/unit_tests/dto_backfill.rs
|
|
docs/plans/028-V0_3_7_BACKFILL_DESK_PLAN.md
|
|
docs/validation/024-V0_3_7_BACKFILL_DESK.md
|
|
```
|
|
|
|
## 10. Fichiers supprimés
|
|
|
|
Aucun.
|
|
|
|
## 11. Gate précédent acquis
|
|
|
|
Le replay opérateur de `0.3.7-pre.009-fix.002` est intégralement propre : audits Rust/Markdown, `cargo check --workspace`, Clippy, 49 tests unitaires Job Backfill et toutes les suites Backfill Desk passent.
|
|
|
|
## 12. Validations exécutées dans l'environnement d'assemblage
|
|
|
|
```text
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.7
|
|
```
|
|
|
|
Contrôles ciblés :
|
|
|
|
- Cancel ciblé par JobId backend et protection stale-run ;
|
|
- répétition idempotente et terminal non réouvert ;
|
|
- shutdown : annulation demandée après `begin_shutdown()` et avant `exit` ;
|
|
- DTO Cancel limité aux métadonnées sûres ;
|
|
- frontend sans payload de campagne sur le chemin Cancel ;
|
|
- aucune dépendance/feature Cargo modifiée ;
|
|
- syntaxe TypeScript par transpilation locale ;
|
|
- contrôle différentiel des headers et reconstruction stricte par application du delta.
|
|
|
|
## 13. Validations non exécutées dans l'environnement d'assemblage
|
|
|
|
`cargo` et `rustfmt` ne sont pas disponibles dans l'environnement d'assemblage. Gate opérateur obligatoire avant `pre.011` :
|
|
|
|
```text
|
|
cargo fmt --all
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.7
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-job-backfill-lib
|
|
cargo test -p ksp-app-backfill-desk
|
|
```
|
|
|
|
Aucun `cargo tree` n'est requis pour cette tranche : dépendances et features Cargo sont inchangées.
|
|
|
|
## 14. Suite
|
|
|
|
`pre.011` ouvrira checkpoint/frontier et Resume in-session, sans durable checkpoint externe ni scheduler générique.
|