Struct PackRegistry 

pub struct PackRegistry;

Registry of pack factories discovered via inventory at link time.

No instance is needed — all methods are associated functions that walk the globally-collected PackRegistration slice.

Implementations

impl PackRegistry

pub fn discovered_names() -> Vec<&'static str>

Names of all pack factories discovered via inventory.

pub fn register_packs( names: &[String], runtime: KhiveRuntime, builder: &mut VerbRegistryBuilder, ) -> Result<(), PackLoadError>

Register the named packs into builder using the supplied runtime.

Validates the explicit pack list against PackFactory::requires() — if any requested pack declares a dependency that is absent from names, registration fails (missing dependency is a boot error, not silently auto-added). Callers must include all required packs explicitly.

The VerbRegistryBuilder::build topo-sort enforces correct load order.

Returns Ok(()) when all names are recognised and all declared dependencies are satisfied; returns Err(PackLoadError) with a distinct variant for unknown pack vs missing dependency.

pub fn build_ingest_registry( runtime: &KhiveRuntime, audit_store: IngestAuditStore, ) -> Result<VerbRegistry, RuntimeError>

Build a VerbRegistry from runtime’s own configuration: gate, default namespace, visible namespaces, actor id, and the configured pack set, then install the registry’s aggregated edge rules back onto runtime. This is the wiring shared by every one-shot CLI ingest path (kkernel code-ingest, kkernel git-ingest) that needs a real registry to dispatch through outside of a live MCP server.

audit_store selects whether the registry gets the runtime’s event store; see IngestAuditStore for what each variant does.

This helper carries only the subset every ingest path duplicated verbatim. The MCP server’s own registry construction additionally wires channel-loop admission, config_id, embedder/entity-type/ note-mutation-hook registration, schema-plan application, and the WAL checkpoint pool handle — all server-only concerns a one-shot CLI pass has no use for, so KhiveMcpServer::with_packs keeps its own construction rather than calling this helper.

pub fn register_packs_with_runtimes( names: &[String], runtimes: &HashMap<String, KhiveRuntime>, default_runtime: &KhiveRuntime, builder: &mut VerbRegistryBuilder, ) -> Result<(), PackLoadError>

Register the named packs into builder, routing each pack to its own runtime.

runtimes maps pack name → KhiveRuntime (one per backend assignment). default_runtime is used for any pack whose name is not in runtimes. The validation logic (unknown pack, missing dependency) is identical to PackRegistry::register_packs.

This is the multi-backend boot path (ADR-028). Single-backend callers should continue using PackRegistry::register_packs.

pub fn register_packs_with_runtimes_with_extra_factories( extra_factories: &[&'static dyn PackFactory], names: &[String], runtimes: &HashMap<String, KhiveRuntime>, default_runtime: &KhiveRuntime, builder: &mut VerbRegistryBuilder, ) -> Result<(), PackLoadError>

Like Self::register_packs_with_runtimes, but resolves pack names against the link-time inventory registry plus extra_factories — pack factories the composition root supplies directly rather than discovers through inventory::iter::<PackRegistration> (ADR-191 D6, ADR-192 S4: “a pack compiled outside this repository … extends the web ontology without any change here” — a host binary that depends on a pinned khive revision plus an out-of-tree pack crate, or a composition root registering a credential-provider/request-hook consumer pack, has no inventory presence in this binary short of its own force-link anchor). An inventory-discovered factory always wins a name collision with an extra_factories entry — the linked set is the trusted default; an extra factory only fills a name inventory does not already answer.

This is the seam D6 describes as “kkernel exposes its server construction as a library entry point that accepts additional pack factories” — the kkernel library entry point itself lives in kkernel::compose, built on this function exactly as khive-mcp/src/serve.rs builds on Self::register_packs_with_runtimes.