Skip to main content

lean_ctx/core/context_package/
loader.rs

1use std::path::Path;
2
3use crate::core::knowledge::ProjectKnowledge;
4use crate::core::memory_policy::MemoryPolicy;
5use crate::core::property_graph::{CodeGraph, Edge, EdgeKind, Node, NodeKind};
6
7use super::content::{GraphLayer, KnowledgeLayer, PackageContent};
8use super::manifest::PackageManifest;
9
10#[derive(Debug, Clone, Default)]
11pub struct LoadReport {
12    pub package_name: String,
13    pub package_version: String,
14    pub knowledge_facts_merged: u32,
15    pub knowledge_facts_skipped: u32,
16    pub knowledge_patterns_merged: u32,
17    pub graph_nodes_imported: u32,
18    pub graph_edges_imported: u32,
19    pub gotchas_imported: u32,
20    pub warnings: Vec<String>,
21}
22
23impl std::fmt::Display for LoadReport {
24    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
25        writeln!(
26            f,
27            "Package: {} v{}",
28            self.package_name, self.package_version
29        )?;
30        if self.knowledge_facts_merged > 0 || self.knowledge_facts_skipped > 0 {
31            writeln!(
32                f,
33                "  Knowledge: {} facts merged, {} skipped (duplicates)",
34                self.knowledge_facts_merged, self.knowledge_facts_skipped
35            )?;
36        }
37        if self.knowledge_patterns_merged > 0 {
38            writeln!(
39                f,
40                "  Patterns:  {} imported",
41                self.knowledge_patterns_merged
42            )?;
43        }
44        if self.graph_nodes_imported > 0 || self.graph_edges_imported > 0 {
45            writeln!(
46                f,
47                "  Graph:     {} nodes, {} edges imported",
48                self.graph_nodes_imported, self.graph_edges_imported
49            )?;
50        }
51        if self.gotchas_imported > 0 {
52            writeln!(f, "  Gotchas:   {} imported", self.gotchas_imported)?;
53        }
54        for w in &self.warnings {
55            writeln!(f, "  WARNING: {w}")?;
56        }
57        Ok(())
58    }
59}
60
61pub fn load_package(
62    manifest: &PackageManifest,
63    content: &PackageContent,
64    project_root: &str,
65) -> Result<LoadReport, String> {
66    let mut report = LoadReport {
67        package_name: manifest.name.clone(),
68        package_version: manifest.version.clone(),
69        ..Default::default()
70    };
71
72    if let Some(ref kl) = content.knowledge {
73        merge_knowledge(kl, project_root, &mut report)?;
74    }
75
76    if let Some(ref gl) = content.graph {
77        import_graph(gl, project_root, &mut report)?;
78    }
79
80    if let Some(ref gotchas) = content.gotchas {
81        import_gotchas(gotchas, project_root, &mut report);
82    }
83
84    Ok(report)
85}
86
87fn merge_knowledge(
88    layer: &KnowledgeLayer,
89    project_root: &str,
90    report: &mut LoadReport,
91) -> Result<(), String> {
92    let mut knowledge = ProjectKnowledge::load_or_create(project_root);
93    let policy = MemoryPolicy::default();
94
95    for fact in &layer.facts {
96        let exists = knowledge
97            .facts
98            .iter()
99            .any(|f| f.category == fact.category && f.key == fact.key && f.value == fact.value);
100
101        if exists {
102            report.knowledge_facts_skipped += 1;
103            continue;
104        }
105
106        knowledge.remember(
107            &fact.category,
108            &fact.key,
109            &fact.value,
110            &fact.source_session,
111            fact.confidence.min(0.8),
112            &policy,
113        );
114        report.knowledge_facts_merged += 1;
115    }
116
117    for pattern in &layer.patterns {
118        let exists = knowledge.patterns.iter().any(|p| {
119            p.pattern_type == pattern.pattern_type && p.description == pattern.description
120        });
121
122        if !exists {
123            knowledge.patterns.push(pattern.clone());
124            report.knowledge_patterns_merged += 1;
125        }
126    }
127
128    knowledge.save()?;
129    Ok(())
130}
131
132fn import_graph(
133    layer: &GraphLayer,
134    project_root: &str,
135    report: &mut LoadReport,
136) -> Result<(), String> {
137    let project_path = Path::new(project_root);
138    let graph = CodeGraph::open(project_path).map_err(|e| format!("graph open: {e}"))?;
139
140    for node_export in &layer.nodes {
141        let node = Node {
142            id: None,
143            kind: NodeKind::parse(&node_export.kind),
144            name: node_export.name.clone(),
145            file_path: node_export.file_path.clone(),
146            line_start: node_export.line_start,
147            line_end: node_export.line_end,
148            metadata: node_export.metadata.clone(),
149        };
150
151        match graph.upsert_node(&node) {
152            Ok(_) => report.graph_nodes_imported += 1,
153            Err(e) => {
154                report
155                    .warnings
156                    .push(format!("node import failed ({}): {e}", node_export.name));
157            }
158        }
159    }
160
161    for edge_export in &layer.edges {
162        let source = graph
163            .get_node_by_path(&edge_export.source_path)
164            .map_err(|e| e.to_string())?;
165        let target = graph
166            .get_node_by_path(&edge_export.target_path)
167            .map_err(|e| e.to_string())?;
168
169        if let (Some(src), Some(tgt)) = (source, target) {
170            let edge = Edge {
171                id: None,
172                source_id: src.id.unwrap_or(0),
173                target_id: tgt.id.unwrap_or(0),
174                kind: EdgeKind::parse(&edge_export.kind),
175                metadata: edge_export.metadata.clone(),
176            };
177
178            match graph.upsert_edge(&edge) {
179                Ok(()) => report.graph_edges_imported += 1,
180                Err(e) => {
181                    report.warnings.push(format!(
182                        "edge import failed ({} -> {}): {e}",
183                        edge_export.source_name, edge_export.target_name
184                    ));
185                }
186            }
187        }
188    }
189
190    Ok(())
191}
192
193fn import_gotchas(
194    layer: &super::content::GotchasLayer,
195    project_root: &str,
196    report: &mut LoadReport,
197) {
198    use crate::core::gotcha_tracker::{
199        Gotcha, GotchaCategory, GotchaSeverity, GotchaSource, GotchaStore,
200    };
201
202    let mut store = GotchaStore::load(project_root);
203    let before = store.gotchas.len();
204
205    for g in &layer.gotchas {
206        let dup = store.gotchas.iter().any(|e| e.id == g.id);
207        if dup {
208            continue;
209        }
210
211        let category = GotchaCategory::from_str_loose(&g.category);
212        let severity = match g.severity.as_str() {
213            "critical" => GotchaSeverity::Critical,
214            "warning" => GotchaSeverity::Warning,
215            _ => GotchaSeverity::Info,
216        };
217
218        let mut gotcha = Gotcha::new(
219            category,
220            severity,
221            &g.trigger,
222            &g.resolution,
223            GotchaSource::AgentReported {
224                session_id: "package-import".into(),
225            },
226            "package-import",
227        );
228        g.id.clone_into(&mut gotcha.id);
229        g.file_patterns.clone_into(&mut gotcha.file_patterns);
230        gotcha.confidence = g.confidence.min(0.8);
231
232        store.gotchas.push(gotcha);
233    }
234
235    report.gotchas_imported = (store.gotchas.len() - before) as u32;
236    let _ = store.save(project_root);
237}