v0.3.10-pre.008
This commit is contained in:
109
deltas/0.3.10/pre.008-fix.001.md
Normal file
109
deltas/0.3.10/pre.008-fix.001.md
Normal file
@@ -0,0 +1,109 @@
|
||||
<!-- file: deltas/0.3.10/pre.008-fix.001.md -->
|
||||
<!-- version: 1 -->
|
||||
|
||||
# Delta `0.3.10-pre.008-fix.001` — fermeture de la nomenclature D1–D4
|
||||
|
||||
## 1. Base requise
|
||||
|
||||
```text
|
||||
0.3.10-pre.008
|
||||
workspace.package.version = 0.3.10-pre.8
|
||||
```
|
||||
|
||||
Le gate opérateur de `pre.008` est vert : format check, audits Rust/Markdown, `cargo check --workspace` et Clippy workspace/all-targets/all-features avec `-D warnings` passent sur cette baseline.
|
||||
|
||||
## 2. Objet
|
||||
|
||||
Corriger les dernières survivances actives de l'ancienne notation des couches de données découvertes pendant la préparation de `pre.009`, sans les absorber dans le couloir de publication.
|
||||
|
||||
`pre.008` a réservé :
|
||||
|
||||
```text
|
||||
N1–N4 = niveaux architecturaux de composants
|
||||
D1–D4 = couches durables Store/data
|
||||
|
||||
D1 RAW
|
||||
D2 STRUCTURAL
|
||||
D3 DECODED
|
||||
D4 DOMAIN
|
||||
```
|
||||
|
||||
La correction reste donc strictement dans la responsabilité de réconciliation documentaire de `pre.008`.
|
||||
|
||||
## 3. Version Cargo
|
||||
|
||||
Correction strictement documentaire :
|
||||
|
||||
```text
|
||||
workspace.package.version reste 0.3.10-pre.8
|
||||
Cargo.toml inchangé
|
||||
```
|
||||
|
||||
Aucun identifiant `fix` n'est reflété dans Cargo pour ce correctif documentaire.
|
||||
|
||||
## 4. Corrections
|
||||
|
||||
### `ROADMAP.md`
|
||||
|
||||
Les usages actifs qui désignaient encore les couches de données avec `N1`, `N2` ou `N3` deviennent :
|
||||
|
||||
```text
|
||||
N1 data/event-only -> D1
|
||||
« taxonomie N1 » -> « taxonomie D1 »
|
||||
« nouvelle famille N1 » -> « nouvelle famille D1 »
|
||||
« ouverture N2/N3 » -> « ouverture D2/D3 »
|
||||
« autres familles N1 » -> « autres familles D1 »
|
||||
```
|
||||
|
||||
Les occurrences où `N1–N4` désignent réellement les niveaux architecturaux restent inchangées.
|
||||
|
||||
### `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md`
|
||||
|
||||
La mention active « migration de données N1 » devient « migration de données D1 ».
|
||||
|
||||
Les anciennes traces historiques de releases, prompts, plans ou validations clôturés ne sont pas réécrites.
|
||||
|
||||
## 5. Hors périmètre
|
||||
|
||||
```text
|
||||
Cargo.toml
|
||||
CHANGELOG.md
|
||||
prompt 0.3.11
|
||||
code / tests / Config / schemas
|
||||
README / USAGE
|
||||
plans / validations
|
||||
autres corrections de publication
|
||||
```
|
||||
|
||||
`pre.009` reste la prochaine tranche et conservera uniquement CHANGELOG, ROADMAP, prompt suivant et fichiers mécaniques.
|
||||
|
||||
## 6. Fichiers modifiés
|
||||
|
||||
```text
|
||||
ROADMAP.md
|
||||
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
|
||||
```
|
||||
|
||||
## 7. Fichier ajouté
|
||||
|
||||
```text
|
||||
deltas/0.3.10/pre.008-fix.001.md
|
||||
```
|
||||
|
||||
## 8. Validation
|
||||
|
||||
```bash
|
||||
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
|
||||
```
|
||||
|
||||
Comme le correctif est exclusivement documentaire et ne touche pas Cargo, Rust, build, runtime ou Config, aucun replay du workspace complet n'est requis si ces audits restent verts.
|
||||
|
||||
## 9. Suite
|
||||
|
||||
Après application et audits documentaires verts :
|
||||
|
||||
```text
|
||||
0.3.10-pre.009 — préparation de publication + prompt 0.3.11
|
||||
0.3.10-rel.001 — publication stable mécanique
|
||||
```
|
||||
201
deltas/0.3.10/pre.008.md
Normal file
201
deltas/0.3.10/pre.008.md
Normal file
@@ -0,0 +1,201 @@
|
||||
<!-- file: deltas/0.3.10/pre.008.md -->
|
||||
<!-- version: 1 -->
|
||||
|
||||
# Delta `0.3.10-pre.008` — réconciliation documentaire finale RAW commune / cross-source
|
||||
|
||||
## 1. Base requise
|
||||
|
||||
```text
|
||||
0.3.10-pre.007 appliquée
|
||||
workspace.package.version = 0.3.10-pre.7
|
||||
```
|
||||
|
||||
Le rejeu opérateur communiqué le 8 septembre 2026 ferme entièrement le gate technique final de `pre.007` : audits Rust/Markdown, `cargo check --workspace`, Clippy workspace strict, `cargo test --workspace --all-targets --all-features`, suites ciblées common/Transport/Backfill et graphes Cargo demandés sont exécutés sans échec.
|
||||
|
||||
Les smokes live opt-in restent `ignored` par politique et ne sont pas revendiqués comme preuves réseau exécutées.
|
||||
|
||||
## 2. Objet
|
||||
|
||||
Effectuer exclusivement la réconciliation documentaire finale de `0.3.10` après fermeture technique de `pre.007`, sans nouveau développement fonctionnel.
|
||||
|
||||
Cette tranche :
|
||||
|
||||
```text
|
||||
réconcilie la nomenclature durable des couches de données Store ;
|
||||
synchronise la séquence fonctionnelle active avec le redécoupage 0.3.10 -> 0.3.16 ;
|
||||
réconcilie les règles et documents d'architecture actifs ;
|
||||
complète la documentation durable de ksp-raw-transaction-lib ;
|
||||
ne modifie aucun comportement Rust, API, dépendance, feature ou runtime.
|
||||
```
|
||||
|
||||
## 3. Version
|
||||
|
||||
Cette livraison est une prerelease non-fix :
|
||||
|
||||
```text
|
||||
workspace.package.version = 0.3.10-pre.8
|
||||
commit attendu = v0.3.10-pre.008
|
||||
aucun tag prerelease
|
||||
```
|
||||
|
||||
Aucune version npm/Tauri n'est modifiée.
|
||||
|
||||
## 4. Nomenclature canonique des couches de données
|
||||
|
||||
La progression durable du Store devient :
|
||||
|
||||
```text
|
||||
D1 RAW -> D2 STRUCTURAL -> D3 DECODED -> D4 DOMAIN
|
||||
```
|
||||
|
||||
Sémantique :
|
||||
|
||||
```text
|
||||
D1 RAW = matériau acquis et conservé avant décomposition métier ;
|
||||
D2 STRUCTURAL = décomposition Solana générique en structures unitaires exploitables ;
|
||||
D3 DECODED = décodage générique des structures selon les contrats de programmes ;
|
||||
D4 DOMAIN = matérialisation métier/spécialisée issue des données décodées.
|
||||
```
|
||||
|
||||
L'ancien nom de couche D2 `CORE` est abandonné. Il créait une ambiguïté avec `ksp-core-lib` et le domaine Core fondamental alors que cette couche Store représente une décomposition structurelle du RAW.
|
||||
|
||||
Cette normalisation ne renomme jamais :
|
||||
|
||||
```text
|
||||
ksp-core-lib ;
|
||||
le domaine Core architectural fondamental ;
|
||||
les noms propres comme « Solana Core Programs » ;
|
||||
les traces historiques clôturées qui documentent l'ancienne terminologie.
|
||||
```
|
||||
|
||||
Les niveaux architecturaux `N1–N4` de `docs/architecture/002-LAYERS_AND_DEPENDENCIES.md` restent réservés aux niveaux de composants. Les couches de données utilisent désormais `D1–D4` afin d'éviter toute collision de vocabulaire. Les plans Store historiques qui parlaient de N1–N4 data restent interprétables selon la correspondance ci-dessus mais ne sont pas réécrits en masse.
|
||||
|
||||
## 5. Conséquences STRUCTURAL
|
||||
|
||||
Les rôles actifs deviennent explicitement :
|
||||
|
||||
```text
|
||||
STRUCTURAL persistence
|
||||
RAW -> STRUCTURAL replay/backfill
|
||||
STRUCTURAL job
|
||||
STRUCTURAL worker
|
||||
STRUCTURAL inspection/control app lorsque pertinent
|
||||
```
|
||||
|
||||
Le `STRUCTURAL job` est borné et rejouable. Le `STRUCTURAL worker` traite continuellement le backlog RAW. Aucun des deux ne réalise le décodage Program : la frontière `STRUCTURAL -> DECODED` reste en aval.
|
||||
|
||||
## 6. Séquence fonctionnelle active
|
||||
|
||||
`docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md` est remis en cohérence avec la trajectoire réellement matérialisée :
|
||||
|
||||
```text
|
||||
0.3.1 ksp-store-api RAW
|
||||
0.3.2 Store runtime + backend PostgreSQL foundation
|
||||
0.3.3 persistence RawTransaction
|
||||
0.3.4 persistence RawAccountState
|
||||
0.3.5 Interface acquisition events
|
||||
0.3.6 ksp-job-api + RawTransaction Backfill
|
||||
0.3.7 ksp-app-backfill-desk
|
||||
0.3.8 ksp-app-store-desk RAW
|
||||
0.3.9 ksp-worker-api + audit acquisition RawTransaction
|
||||
0.3.10 common ksp-raw-transaction-lib + preuves cross-source
|
||||
0.3.11-0.3.14 Worker RAW ingest découpé par responsabilité
|
||||
0.3.15 ksp-app-raw-transaction-ingest-desk
|
||||
0.3.16 Backfill multi-source / multi-stratégie
|
||||
```
|
||||
|
||||
Le redécoupage ne change pas les frontières Job/Worker arrêtées précédemment et ne réintroduit aucun Worker concret dans `0.3.10`.
|
||||
|
||||
## 7. Documentation de `ksp-raw-transaction-lib`
|
||||
|
||||
La crate common RAW étant désormais une bibliothèque complétée de `0.3.10`, elle reçoit :
|
||||
|
||||
```text
|
||||
crates/ksp-raw-transaction-lib/README.md
|
||||
crates/ksp-raw-transaction-lib/USAGE.md
|
||||
```
|
||||
|
||||
Le `README.md` fixe son rôle, ses dépendances autorisées et ses frontières. Le `USAGE.md` reste volontairement version-neutre et montre uniquement l'utilisation durable de la surface publique de crate root : signatures, wire Solana, canonicalisation RAW et assemblage acquisition/observation.
|
||||
|
||||
La documentation rappelle explicitement que le résultat de cette crate reste D1 RAW et qu'elle n'implémente pas la transformation RAW -> STRUCTURAL.
|
||||
|
||||
## 8. ROADMAP et publication
|
||||
|
||||
`ROADMAP.md` est modifié uniquement pour éliminer l'ancien libellé actif `RAW/CORE/DECODE/SPECIALIZED` au profit de `RAW/STRUCTURAL/DECODED/DOMAIN`.
|
||||
|
||||
Les changements de statut de release, le CHANGELOG et la préparation du prompt `0.3.11` restent réservés à `pre.009`.
|
||||
|
||||
## 9. Traces historiques
|
||||
|
||||
Les prompts, deltas, plans et validations clôturés ne sont pas réécrits en masse. Une ancienne occurrence de `CORE` dans une trace historique peut donc rester légitime lorsqu'elle décrit l'état documentaire de sa livraison.
|
||||
|
||||
Cette tranche corrige les documents durables actifs, pas l'histoire du repository.
|
||||
|
||||
## 10. Fichiers modifiés
|
||||
|
||||
```text
|
||||
Cargo.toml
|
||||
ROADMAP.md
|
||||
docs/IDEAS.md
|
||||
docs/architecture/002-LAYERS_AND_DEPENDENCIES.md
|
||||
docs/architecture/003-COMPONENT_CONTRACTS.md
|
||||
docs/architecture/004-COMPONENT_INVENTORY.md
|
||||
docs/architecture/005-DEPENDENCY_GRAPH.md
|
||||
docs/architecture/006-WIRE_AND_PROGRAM.md
|
||||
docs/architecture/008-DATA_MATERIALIZATION_AND_STORE.md
|
||||
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md
|
||||
docs/architecture/010-APPS_SERVICES_SCENARIOS_AND_CONTROL.md
|
||||
docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
|
||||
docs/plans/031-V0_3_10_RAW_TRANSACTION_INGEST_PLAN.md
|
||||
docs/rules/RULES_DEPENDENCIES.md
|
||||
docs/rules/RULES_KSP.md
|
||||
docs/validation/027-V0_3_10_RAW_TRANSACTION_INGEST.md
|
||||
```
|
||||
|
||||
## 11. Fichiers ajoutés
|
||||
|
||||
```text
|
||||
crates/ksp-raw-transaction-lib/README.md
|
||||
crates/ksp-raw-transaction-lib/USAGE.md
|
||||
deltas/0.3.10/pre.008.md
|
||||
```
|
||||
|
||||
Aucun fichier Rust source, manifest de crate, Config, frontend ou dépendance n'est modifié.
|
||||
|
||||
## 12. Validation d'assemblage
|
||||
|
||||
À enregistrer avant livraison :
|
||||
|
||||
```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
|
||||
contrôle statique nomenclature D1-D4 / STRUCTURAL
|
||||
contrôle statique version/scope/headers
|
||||
contrôle exact de l'inventaire delta
|
||||
contrôle archive delta et reconstruction overlay
|
||||
```
|
||||
|
||||
Cargo/rustc/rustfmt ne sont pas disponibles dans l'environnement d'assemblage ; aucun gate Cargo de `pre.008` n'est déclaré PASS localement. Le gate technique complet de `pre.007` reste la baseline opérateur fermée ; `pre.008` ne modifie aucun code ni graphe de dépendances.
|
||||
|
||||
## 13. Rejeu opérateur `pre.008`
|
||||
|
||||
Comme cette tranche est documentaire hors incrément mécanique de version workspace, le rejeu minimal attendu est :
|
||||
|
||||
```bash
|
||||
cargo fmt --all -- --check
|
||||
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
|
||||
cargo check --workspace
|
||||
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||
```
|
||||
|
||||
Un échec ouvre `pre.008-fix.NNN`. Aucun nouveau test fonctionnel ou smoke live n'est requis par cette réconciliation documentaire seule.
|
||||
|
||||
## 14. Suite
|
||||
|
||||
Après retour opérateur vert sur `0.3.10-pre.8` :
|
||||
|
||||
```text
|
||||
pre.009 = préparation publication, CHANGELOG, statuts ROADMAP et prompt 0.3.11
|
||||
rel.001 = publication stable mécanique de 0.3.10
|
||||
```
|
||||
Reference in New Issue
Block a user