106 lines
3.1 KiB
Markdown
106 lines
3.1 KiB
Markdown
<!-- file: deltas/0.3.1/pre.002.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.1-pre.002`
|
|
|
|
## Base requise
|
|
|
|
```text
|
|
0.3.1-pre.001-fix.003
|
|
```
|
|
|
|
## Objectif
|
|
|
|
Créer uniquement le scaffold de `ksp-store-api` et matérialiser la frontière de dépendances validée par `pre.001`, sans introduire encore les primitives RAW de `pre.003` ni aucun backend/runtime Store.
|
|
|
|
## Fichiers ajoutés
|
|
|
|
```text
|
|
crates/ksp-store-api/Cargo.toml
|
|
crates/ksp-store-api/src/capability.rs
|
|
crates/ksp-store-api/src/lib.rs
|
|
crates/ksp-store-api/src/model.rs
|
|
crates/ksp-store-api/tests/dependency_boundary.rs
|
|
crates/ksp-store-api/tests/public_api.rs
|
|
deltas/0.3.1/pre.002.md
|
|
```
|
|
|
|
## Fichiers modifiés
|
|
|
|
```text
|
|
Cargo.toml
|
|
```
|
|
|
|
Le workspace passe à :
|
|
|
|
```text
|
|
0.3.1-pre.2
|
|
```
|
|
|
|
et enregistre `crates/ksp-store-api` comme membre.
|
|
|
|
## Décisions matérialisées
|
|
|
|
- `ksp-store-api` dépend uniquement de `ksp-core-lib`.
|
|
- les modules `model` et `capability` sont privés et distincts ; aucune arborescence de module interne n'est une API publique.
|
|
- la façade crate-root réexporte seulement les primitives Core réellement communes nécessaires aux futurs contrats Store : `Error`, `ErrorCode`, `ErrorContext`, `Pubkey` et `Result`.
|
|
- `0.3.1` reste N1 RAW-only ; STRUCTURAL reste une couche ultérieure distincte et aucun type N2 n'est créé dans cette tranche.
|
|
- aucune dépendance Interface, Transport, Program, Materializer, Config, Logging, async runtime, serde, codec ou backend n'est introduite.
|
|
- aucun marker trait ou enum Store artificiel n'est créé avant qu'une opération/modèle réel ne le justifie.
|
|
- `RawTransaction`, provenance, payload, observation et idempotence restent réservés à `pre.003`.
|
|
|
|
## Tests ajoutés
|
|
|
|
`dependency_boundary.rs` vérifie :
|
|
|
|
- la dépendance runtime exacte Core-only ;
|
|
- l'absence des crates backend/runtime/transport/program/config ;
|
|
- l'absence de chemins SQL/PostgreSQL/async/env/filesystem dans la façade.
|
|
|
|
`public_api.rs` vérifie :
|
|
|
|
- la consommation externe des réexports Core depuis le crate-root ;
|
|
- l'absence de `pub mod` ;
|
|
- l'absence de concepts backend et de modèles RAW introduits prématurément.
|
|
|
|
## Validations exécutées dans l'environnement de génération
|
|
|
|
```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.1
|
|
```
|
|
|
|
## Validations non exécutées dans l'environnement de génération
|
|
|
|
`cargo`/`rustfmt` ne sont pas disponibles dans l'environnement de génération. L'opérateur doit donc exécuter :
|
|
|
|
```text
|
|
cargo fmt --all
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-store-api
|
|
```
|
|
|
|
Une commande non exécutée n'est pas déclarée PASS.
|
|
|
|
## Hors scope confirmé
|
|
|
|
```text
|
|
RawTransaction concret
|
|
RawAccountState
|
|
TransactionStatusObservation
|
|
capabilities read/write
|
|
queries/outcomes
|
|
retention/tombstone concret
|
|
ksp-store-lib
|
|
ksp-store-postgres-lib
|
|
PostgreSQL/tokio-postgres
|
|
Config std.store
|
|
N2 STRUCTURAL
|
|
N3/N4
|
|
```
|
|
|
|
## Suite
|
|
|
|
`0.3.1-pre.003` introduit les primitives RAW communes puis `RawTransaction` et son observation, sans faire sortir les logs inclus de la transaction vers un modèle `RawLog` distinct.
|