ontocore-plugin 0.25.0

Plugin manifest discovery for OntoCore (v0.14 host foundation)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

use ontocore_catalog::OntologyCatalog;
use ontocore_core::Diagnostic;
use ontocore_docs::{ExportError, ExportOptions};
use serde::{Deserialize, Serialize};
use serde_json::Value;
use std::path::{Path, PathBuf};

pub trait ValidatorPlugin: Send + Sync {
    fn id(&self) -> &str;
    fn validate(&self, catalog: &OntologyCatalog, workspace: &Path) -> Vec<Diagnostic>;
}

pub trait ExporterPlugin: Send + Sync {
    fn id(&self) -> &str;
    fn export(
        &self,
        catalog: &OntologyCatalog,
        workspace: &Path,
        options: ExportOptions,
    ) -> Result<Vec<PathBuf>, ExportError>;
}

#[derive(Debug, Clone)]
pub struct WorkflowRequest {
    pub step: String,
    pub dry_run: bool,
}

#[derive(Debug, Clone)]
pub struct WorkflowResult {
    pub success: bool,
    pub logs: String,
    pub diagnostics: Vec<Diagnostic>,
}

pub trait WorkflowPlugin: Send + Sync {
    fn id(&self) -> &str;
    fn run(&self, workspace: &Path, request: WorkflowRequest) -> WorkflowResult;
}

/// Thin reasoner adapter (SDK 1.0) — emits unsatisfiable IRIs compatible with reasoner UIs.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct ReasonerProviderResult {
    pub profile: String,
    pub unsatisfiable: Vec<String>,
    #[serde(default)]
    pub logs: Option<String>,
}

pub trait ReasonerPlugin: Send + Sync {
    fn id(&self) -> &str;
    fn classify(&self, catalog: &OntologyCatalog, workspace: &Path) -> ReasonerProviderResult;
}

/// Thin query adapter — tabular rows for Query Workbench / CLI.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct QueryProviderResult {
    pub columns: Vec<String>,
    pub rows: Vec<Vec<String>>,
    #[serde(default)]
    pub truncated: bool,
}

pub trait QueryPlugin: Send + Sync {
    fn id(&self) -> &str;
    fn run(&self, catalog: &OntologyCatalog, workspace: &Path, query: &str) -> QueryProviderResult;
}

/// Thin refactor preview tip (does not apply edits).
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct RefactorProviderResult {
    pub affected_iris: Vec<String>,
    pub hints: Vec<String>,
}

pub trait RefactorPlugin: Send + Sync {
    fn id(&self) -> &str;
    fn preview(
        &self,
        catalog: &OntologyCatalog,
        workspace: &Path,
        focus_iri: Option<&str>,
    ) -> RefactorProviderResult;
}

/// Thin graph provider — optional graph_kind + IRI seeds / overlay payload.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct GraphProviderResult {
    pub graph_kind: String,
    pub root_iris: Vec<String>,
    #[serde(default)]
    pub result: Option<Value>,
}

pub trait GraphPlugin: Send + Sync {
    fn id(&self) -> &str;
    fn build(
        &self,
        catalog: &OntologyCatalog,
        workspace: &Path,
        root_iri: Option<&str>,
    ) -> GraphProviderResult;
}