Skip to main content

Module promotion

Module promotion 

Source
Expand description

Background skill-promotion engine (#3305).

PromotionEngine scans a window of recent episodic messages for clustering patterns and promotes qualifying clusters to SKILL.md files on disk.

§C1 fix — session provenance

PromotionInput carries a conversation_id field that is absent from crate::facade::MemoryMatch. This allows the engine to enforce the min_sessions heuristic without touching the public recall API.

§Dependency inversion

To avoid a circular crate dependency (zeph-memoryzeph-skills), skill generation is delegated to SkillWriter, a trait that callers in zeph-core implement using zeph_skills::generator::SkillGenerator. This keeps zeph-memory free of a direct zeph-skills dependency.

Structs§

PromotionCandidate
A cluster of episodic messages that qualifies for promotion to a SKILL.md.
PromotionConfig
Configuration knobs for PromotionEngine.
PromotionEngine
Background engine that scans episodic memory and promotes recurring patterns to skills.
PromotionInput
A single episodic message prepared for the promotion scan.

Traits§

SkillWriter
Trait for writing a generated SKILL.md to disk.