core/

Package agent orchestrates Sahayak's core loop: turn a natural-language request into an inspectable Plan, gate every step behind human approval, run approved steps, and on failure run a diagnosis pass that can propose a follow-up — which re-enters the same gate.

Package cartridge defines the data model for Sahayak's tool cartridges and the generic runner that turns a command TEMPLATE + a user request into a grounded, ready-to-execute command — with no tool-specific code.

Package config resolves Sahayak's runtime settings from flags and environment.

Package curator is Sahayak's always-on background knowledge builder.

Package diagnose turns a failed command into structured signals — exit-code meanings and recognized error patterns from stdout/stderr — BEFORE the model is consulted.

Package embed turns text into vectors for retrieval and memory.

Package envfacts is Sahayak's environment-topology cache: the durable, slowly- changing facts about the operator's world (which namespaces exist, which deployments live where) so the agent can skip re-discovering them every run.

Package exec runs proposed commands safely and classifies their risk.

Package knowledge implements Sahayak's offline RAG: installable knowledge packs (e.g.

Package learn is Sahayak's self-learning layer — assisted authoring from DETERMINISTIC signals.

Package llm defines Sahayak's model-agnostic provider interface and the structured Plan schema the agent loop relies on.

Package memory gives Sahayak persistence across turns and sessions, mirroring LangGraph's two tiers without the framework: short-term checkpoints (resume / crash-safety) and long-term, namespaced memories with semantic recall.

Package playbook recognizes a small set of high-frequency, unambiguous DevOps intents and turns them into a DETERMINISTIC plan, so the agent does not have to rely on a small local model to plan AND to know when to stop.

Package redact scrubs secrets out of text before it is shown to the model or written to logs.

Package router is the data-driven, semantic half of Sahayak's intent routing.

Package slots is the tool-agnostic slot-extraction engine for the cartridge architecture (see CARTRIDGE-ARCHITECTURE.md).

Package tui provides Sahayak's rich terminal UI built on Bubble Tea.

Package ui renders Sahayak's terminal experience: a branded header, animated spinners while the model thinks, color-coded steps and risk, and a boxed conclusion.

Package vector provides the minimal, pure-Go vector math Sahayak needs for offline retrieval and memory recall: cosine similarity and brute-force top-K. Brute force is fine for the per-CLI doc packs we target (well under ~100k chunks); swapping in an ANN index later is a contained change.

Package version holds build identity, injected at release time via -ldflags.