Expand description
mesofact — tri-mode web server library + proxy binary.
See .yah/docs/working/mesofact.md for the phased rollout plan.
@yah:ticket(R009-T1, “Add axum/tokio deps + binary scaffold + proxy module export”) @yah:at(2026-05-15T23:55:09Z) @yah:status(review) @yah:parent(R009)
Re-exports§
pub use cache_policy::CachePolicyTable;pub use manifest::CachePolicy;pub use manifest::ErrorRoutes;pub use manifest::Hydration;pub use manifest::Manifest;pub use manifest::Prerender;pub use manifest::Requires;pub use manifest::Route;pub use manifest::RouteMode;pub use manifest::StaticAsset;pub use manifest::MANIFEST_VERSION;pub use policy::check_manifest;pub use policy::PolicyCheckError;pub use policy::PolicyRefusal;pub use policy::PolicySupport;pub use policy::RoutePolicy;pub use proxy::cache::compose_key;pub use proxy::cache::CacheEntry;pub use proxy::cache::CacheState;pub use proxy::cache::KeyInputs;pub use proxy::cache::ResponseCache;pub use proxy::session::CookieSessionResolver;pub use proxy::session::SessionResolver;pub use proxy::session::User;pub use proxy::source_gen::Generations;pub use validate::validate;pub use validate::SourceCatalog;pub use validate::SourceScope;pub use validate::ValidationError;pub use validate::ValidationErrorKind;
Modules§
- cache_
policy - The one derivation of
cache_policy→ response headers (R749-T1, R749-B4). - manifest
- Manifest types — the single document the build emits and the proxy boots
from. Mirrors
packages/mesofact-runtime/src/manifest.ts. Schema spec lives in.yah/docs/architecture/mesofact.md§“Manifest schema”. - policy
- Declared-vs-enforced route policy (R749-T1) — the general form of the rule
crate::manifestfields keep re-learning one field at a time. - proxy
- axum proxy — boot, manifest reload, Mode 1 dispatch, worker pool, and the
P9 Mode 2 SSR slice (response cache + cache-key composition + session +
source generations). Mode 3 dispatch is stubbed (501) — wired up in P10.
See
.yah/docs/architecture/mesofact.md§“IPC protocol” and §“Components”. - validate
- Manifest validator — semantic rules over a parsed
Manifest. Mirrorspackages/mesofact-runtime/src/validate.ts. Used by the proxy on boot (refuse a malformed manifest, keep the old one live) and by the build to reject forbidden shapes before HTML hits R2.