khadhroony-solana-project/deltas/0.3.6/pre.003-fix.001.md

Delta 0.3.6-pre.003-fix.001 — visibilité du constructeur privé de séquence

Base requise

0.3.6-pre.003 appliquée
workspace.package.version = 0.3.6-pre.3

Le gate opérateur fourni pour pre.003 confirme :

cargo fmt --all                                      PASS
python3 scripts/audit_rust_workspace_rules.py        PASS / clean
python3 scripts/audit_markdown_tables.py ...         PASS / clean (264 tables / 144 fichiers)
cargo check --workspace                              PASS
cargo clippy --workspace --all-targets               FAIL / E0423
cargo test -p ksp-job-api                            FAIL / E0423
cargo tree -p ksp-job-api --edges normal             Core-only confirmé
cargo tree -p ksp-job-api -e features                aucune feature Job API

Objectif

Corriger exclusivement la compilation du helper de test qui construit la position terminale artificielle nécessaire à la canarie d'overflow de JobNotificationSequence, sans modifier le contrat public latest-value de pre.003.

Cause exacte

Le helper privé est défini dans crates/ksp-job-api/src/notification.rs, le module propriétaire du tuple struct :

#[cfg(test)]
fn exhausted_notification_sequence() -> crate::JobNotificationSequence {
    return crate::JobNotificationSequence(u64::MAX);
}

Le champ de JobNotificationSequence est volontairement privé afin d'empêcher la construction publique depuis un entier arbitraire. Le type est réexporté à la racine de crate, mais ce re-export ne rend pas son constructeur tuple visible. Le chemin crate::JobNotificationSequence(u64::MAX) déclenche donc E0423 sous les targets de test.

Le module notification possède déjà l'accès légitime au champ privé. Le correctif utilise directement le type local :

return JobNotificationSequence(u64::MAX);

Cette construction reste confinée au helper #[cfg(test)]; aucun constructeur arbitraire n'est ajouté à l'API publique.

Version

Le fix modifie un fichier Rust. Conformément à VER-ID-003, VER-ID-007 et VER-ID-010 :

workspace.package.version = 0.3.6-pre.3.fix.1
delivery = 0.3.6-pre.003-fix.001
commit = v0.3.6-pre.003-fix.001

Aucun tag prerelease.

Fichiers ajoutés

deltas/0.3.6/pre.003-fix.001.md

Fichiers modifiés

Cargo.toml
crates/ksp-job-api/src/notification.rs
docs/plans/027-V0_3_6_JOB_API_BACKFILL_PLAN.md
docs/validation/023-V0_3_6_JOB_API_BACKFILL.md

Fichiers supprimés

Aucun.

Décisions prises

• conserver le champ tuple de JobNotificationSequence privé ;
• ne pas ajouter de from_u64, constructeur caché public, feature de test ou autre contournement de l'invariant ;
• limiter la construction de u64::MAX au helper interne #[cfg(test)] déjà prévu par pre.003 ;
• ne modifier ni les treize tests unitaires attendus, ni les quatorze canaries d'intégration, ni leurs assertions ;
• ne rouvrir aucune dépendance, feature, surface Backfill/Worker/Transport/Store/Logging, README, USAGE, CHANGELOG, ROADMAP ou prompt.

Validations exécutées pour l'assemblage du fix

python3 scripts/audit_rust_workspace_rules.py
-> General Rust rule audit: clean
-> Rust export completeness audit: 0 candidate(s)
-> KSP workspace Rust rule audit: clean

python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.6
-> Markdown table audit: clean (264 tables / 145 fichiers)

Le diff par rapport à pre.003 est limité aux quatre fichiers modifiés ci-dessus et au présent delta.

Validations non exécutées

L'environnement d'assemblage ne fournit ni cargo ni rustfmt. Le gate Rust du fix n'est donc pas annoncé comme vert localement.

Aucun smoke réseau ou PostgreSQL n'est pertinent pour ce correctif de compilation Job API.

Gate opérateur demandé

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.6
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-job-api
cargo tree -p ksp-job-api --edges normal
cargo tree -p ksp-job-api -e features

Résultat attendu : treize tests unitaires et quatorze canaries d'intégration ksp-job-api verts, avec le graphe normal toujours limité à ksp-core-lib et aucune feature propre à Job API.

Questions ouvertes

Aucune. pre.004 reste interdit tant que ce gate de fix n'est pas intégralement vert.