ijima-server 0.1.0

HTTP daemon and store backends for the Ijima centralized agentic memory backend
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

// Copyright (C) 2026 Industrial Algebra
// SPDX-License-Identifier: Apache-2.0

//! # ijima-server
//!
//! HTTP daemon and store backends for the
//! [Ijima](https://github.com/Industrial-Algebra/Ijima) centralized
//! agentic memory backend.
//!
//! This crate is the Rust successor to the pi-mempalace fork's
//! `pi-mempalace-server.ts` remote backend. It owns the store backends
//! (SurrealDB primary — see `docs/DESIGN.md` D6), the embedding/vector
//! index, the JSON-RPC-style HTTP surface that harnesses speak, and the
//! systemd-friendly daemon entry point.
//!
//! The transport-free type contract — including the [`ijima_core::Store`]
//! trait this crate implements — lives in [`ijima_core`]; the extraction
//! engine lives in [`ijima_miner`]; harness adapters live in
//! [`ijima_client`].
//!
//! ## Features
//!
//! - `std` (default): Standard library support.
//! - `http` (default): axum-based HTTP/JSON server + the `ijima` binary.
//!   Disable to embed the store as a library without spawning a server.
//! - `backend-surreal`: SurrealDB store backend (primary). Embedded
//!   `kv-mem` engine; server mode is a future addition.
//! - `backend-sqlite`: SQLite store backend — **migration only**. Reads
//!   the live pi-mempalace corpus once during import.
//! - `embeddings-candle`: candle (Hugging Face Rust ML) embedding backend.
//!   The IA-standard default, consistent with Quantizon. Builds candle
//!   on CPU; GPU/CUDA acceleration is a future opt-in.
//! - `server-auth`: Schubert proof-carrying capability tokens for both
//!   authentication and authorization on Gr(4,8). Loads
//!   [`policy/policy.toml`](https://github.com/Industrial-Algebra/Ijima).
//!   When off, the store runs unauthenticated (embedded/tests).
//!
//! ## Status
//!
//! Scaffolded — store backends, schema import, and HTTP routes are
//! filled in test-first. See `docs/HANDOFF.md` and `docs/DESIGN.md`.

#![deny(unsafe_code)]
#![cfg_attr(not(feature = "std"), no_std)]

#[cfg(feature = "backend-surreal")]
pub mod backend_surreal;

#[cfg(feature = "backend-surreal")]
pub use backend_surreal::SurrealStore;

/// One-time corpus migration from legacy SQLite stores. Behind
/// `backend-sqlite` (migration-only read path, DESIGN D6).
#[cfg(feature = "backend-sqlite")]
pub mod migration;

#[cfg(feature = "embeddings-candle")]
pub mod embeddings_candle;

#[cfg(feature = "server-auth")]
pub mod auth;

#[cfg(feature = "server-auth")]
pub mod key_store;

#[cfg(feature = "server-auth")]
pub use auth::{AuthenticatedPrincipal, IjimaAuth};

#[cfg(feature = "http")]
pub mod api;

#[cfg(all(feature = "http", feature = "server-auth"))]
pub mod extractor;

/// Schubert geometric rate limiting (Phase 3.4). Behind `rate-limit`.
#[cfg(feature = "rate-limit")]
pub mod rate_limit;

/// Redaction/scrub filter for the personal → shared promotion boundary (D9 §2).
pub mod redaction;

/// Doctrine seed-pack format parser + ingest client (D9).
pub mod doctrine;

/// Mining trigger orchestration (ADR M1/M3/M7). Behind `mining`.
#[cfg(feature = "mining")]
pub mod mining_pipeline;

#[cfg(feature = "http")]
pub mod server;