kindling-service 0.3.0

In-process orchestration layer for kindling memory: capsules, observations, retrieval and pins.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! In-process kindling orchestration.
//!
//! [`KindlingService`] exposes capsule lifecycle, observation append,
//! retrieval, and pin management over the already-ported store, provider, and
//! filter crates. Consumed in-process by the daemon (`kindling-server`), by the
//! CLI, and directly by Rust integrators (e.g. anvil headless flows).
//!
//! Ports `KindlingService` from
//! `packages/kindling-core/src/service/kindling-service.ts`. Two deliberate
//! deviations from the TS service:
//!
//! 1. **Result-typed errors.** Every method returns [`ServiceResult`] instead
//!    of throwing; validation failures and lifecycle violations are structured
//!    [`ServiceError`] variants.
//! 2. **Service-boundary secret masking.** [`KindlingService::append_observation`]
//!    runs observation content through `kindling_filter::mask_secrets` before
//!    storing, so non-Rust consumers cannot bypass secret filtering. (Masking
//!    only — content truncation stays a hook-layer concern.)
//!
//! Export/import/bundle methods (deferred from PORT-006) are implemented here
//! by PORT-012; see [`export`]. They are byte-compatible with the TS bundle
//! format so exports round-trip across the two implementations.

mod context;
mod error;
mod export;
pub mod filter;
mod service;
mod validation;

pub use context::{PreCompactContext, ResolvedPin, SessionStartContext};
pub use error::{ServiceError, ServiceResult};
pub use export::{
    ExportBundle, ExportBundleOptions, ExportDataset, ExportStats, ImportOptions, ImportResult,
    BUNDLE_VERSION,
};
pub use service::{
    AppendObservationOptions, AppendOutcome, CloseCapsuleOptions, CreatePinOptions,
    KindlingService, OpenCapsuleOptions,
};