hive-addon.lifecycle.schema — io.github.hive-agi/hive-addon 1.0.7

Malli value objects for the addon lifecycle: when an addon is mounted, when it is let go, and what stands in for it while it is not mounted.

Shapes are uncompiled malli DATA seeded into a LOCAL composite registry over hive-addon.mount.schema's; never installed as the global default.

Registered keys: :lifecycle/policy :lifecycle/decl :lifecycle/surface :lifecycle/use-state :lifecycle/sweep-plan :lifecycle/activation-report :lifecycle/eviction-report :lifecycle/boot-report.

ActivationReport clj/s

BootReport clj/s

EvictionReport clj/s

explain clj/s

(explain ?s x)

humanize-errors clj/s

(humanize-errors ?s x)

IdleMs clj/s

Milliseconds without use before a :lazy addon (or a part) is evictable.

KeepReason clj/s

Why a sweep left an addon mounted.

Lifecycle clj/s

A resolved lifecycle: every key present.

LifecycleDecl clj/s

What a manifest's :addon/lifecycle, or a host override, declares. Open.

Phase clj/s

Policy clj/s

:eager mounted at boot, evicted only on request. :lazy dormant until first use, evicted after :idle-ms without use. :pinned mounted at boot, never evicted; its parts still are.

registry clj/s

Surface clj/s

Everything a caller can reach an addon through, known WITHOUT mounting it. :tools top-level tool-defs. :commands {host-tool-name [command-name ...]} contributed into host tools. :commands may name the full dispatch token ("carto") or a leaf; the host decides how a stub routes.

SweepPlan clj/s

:evict is ordered dependents-first, so evicting in order never pulls an instance out from under a live dependent.

ToolDecl clj/s

A tool an addon contributes, as advertised: an MCP tool-def with no handler.

UseState clj/s

Per-addon runtime state the lifecycle keeps.

validate clj/s

(validate ?s x)

validate* clj/s

(validate* ?s x)

(validate* ?s x category)

(r/ok x) or (r/err category {:explanation ...}).