Delta `0.3.1-pre.002`

Base requise

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

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

Cargo.toml

Le workspace passe à :

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

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 :

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é

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.

3.1 KiB Raw Blame History

Delta 0.3.1-pre.002