jnana 0.5.0

Jnana — the foundation of knowing. Unified knowledge system for AGNOS
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

//! Jnana — the foundation of knowing
//!
//! **Jnana** (Sanskrit: ज्ञान — knowledge, wisdom) is the unified knowledge
//! system for AGNOS. It distills human understanding into structured, tested,
//! queryable, offline-accessible data — drawing from AGNOS science crates
//! and curated external sources.
//!
//! # Philosophy
//!
//! Wikipedia is 50GB of prose. Jnana is 1-10GB of *proven, testable,
//! executable* knowledge. Every formula is verified by a test. Every
//! constant comes from an authoritative source. Every procedure works.
//!
//! # Knowledge Sources
//!
//! **Internal** (from AGNOS crates — distilled, tested):
//! - hisab: math formulas, linear algebra, calculus, geometry
//! - kimiya: periodic table, reactions, thermochemistry
//! - tanmatra: particle physics, nuclear data, spectral lines
//! - prakash: optics tables, spectral data, Fresnel equations
//! - pramana: probability distributions, statistical methods
//! - bodh: cognitive models, psychophysics laws
//! - vidya: programming best practices across languages
//! - ...every science crate's reference data
//!
//! **External** (curated, downloaded, verified):
//! - Medical references (WikiMed, field medicine guides)
//! - Survival procedures (shelter, water, food, navigation)
//! - Repair guides (iFixit, practical how-to)
//! - Agricultural science (FAO, permaculture, aquaponics)
//! - Construction (earthbag, timber, solar, plumbing)
//!
//! # Modules
//!
//! - [`domain`] — Knowledge domains and their entries
//! - [`entry`] — Core types: `Entry`, `Fact`, `Procedure`, `Constant`, `Table`
//! - [`registry`] — In-memory knowledge registry with lookup and search
//! - [`profile`] — Storage profiles (survival, homesteader, developer, educator, full)
//! - [`search`] — Cross-domain search
//! - [`source`] — External source management (download, verify, update)
//! - [`portal`] — Web portal generation from registry
//! - [`storage`] — Budget calculator, what-fits analysis
//! - [`error`] — Error types
//!
//! # Example
//!
//! ```rust
//! use jnana::{Registry, SearchQuery};
//!
//! let registry = Registry::new();
//! if let Some(entry) = registry.get("speed_of_light") {
//!     println!("{}: {}", entry.title, entry.summary);
//! }
//! let results = jnana::search::search(&registry, &SearchQuery::text("binding energy"));
//! ```

pub mod content;
pub mod domain;
pub mod entry;
pub mod error;
pub mod linker;
pub mod portal;
pub mod profile;
pub mod provider;
pub mod providers;
pub mod registry;
pub mod search;
pub mod source;
pub mod storage;

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

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

// ── Core types ─────────────────────────────────────────────────────────────
pub use domain::Domain;
pub use entry::{Constant, Entry, EntryKind, Fact, Procedure, Table};
pub use error::{JnanaError, Result};
pub use profile::Profile;
pub use provider::KnowledgeProvider;
pub use registry::Registry;
pub use search::{SearchQuery, SearchResult};
pub use source::Source;
pub use storage::StorageBudget;