<!-- 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.