v0.3.1-pre.002

crates/ksp-store-api/src/capability.rs

@@ -0,0 +1,8 @@
+// file: crates/ksp-store-api/src/capability.rs
+// version: 1
+
+//! Private home for backend-agnostic Store capability contracts.
+//!
+//! `0.3.1-pre.002` establishes the ownership boundary only. Concrete read and
+//! write capabilities are introduced after the RAW models they operate on are
+//! defined; no backend/runtime contract belongs here.

crates/ksp-store-api/src/lib.rs

@@ -0,0 +1,31 @@
+// file: crates/ksp-store-api/src/lib.rs
+// version: 1
+
+#![warn(missing_docs)]
+#![deny(unreachable_pub)]
+#![forbid(unsafe_code)]
+
+//! Backend-agnostic persistence contracts for KSP Store implementations.
+//!
+//! `ksp-store-api` owns persistent models plus the contracts that operate on
+//! them. The `0.3.1` release is limited to N1 RAW/acquisition data. N2
+//! STRUCTURAL is a later, distinct layer and no Program decode belongs to this
+//! crate.
+//!
+//! Models and capabilities deliberately have separate private module homes.
+//! Backend implementations, SQL, migrations, Config, Transport and runtime
+//! dispatch remain outside this crate.
+
+mod capability;
+mod model;
+
+/// Common KSP error type used by Store-facing contracts.
+pub use ksp_core_lib::Error;
+/// Stable structured code identifying a KSP error category and condition.
+pub use ksp_core_lib::ErrorCode;
+/// Structured contextual field attached to a KSP error.
+pub use ksp_core_lib::ErrorContext;
+/// Canonical Solana account address primitive shared by persistent models.
+pub use ksp_core_lib::Pubkey;
+/// Common KSP result alias using [`Error`].
+pub use ksp_core_lib::Result;

crates/ksp-store-api/src/model.rs

@@ -0,0 +1,9 @@
+// file: crates/ksp-store-api/src/model.rs
+// version: 1
+
+//! Private home for persistent Store models.
+//!
+//! The current release is N1 RAW-only. Future N2 STRUCTURAL models are a
+//! separate data layer and are not introduced by this scaffold. Persistent
+//! models and backend capabilities remain separate even when one capability
+//! operates on one or more models.