lean_ctx/core/context_package/
loader.rs1use 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}