@kitelev/exocortex-cli 15.100.1 → 15.102.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +40 -0
- package/dist/index.js +191 -187
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -106,6 +106,46 @@ exocortex sparql query "SELECT ?task WHERE { ?task exo:Instance_class ems:Task }
|
|
|
106
106
|
└────────────────────────────────────────────────────────────┘
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
+
### RDF Convert (Vault Dump)
|
|
110
|
+
|
|
111
|
+
Dump the entire vault graph as Turtle, N-Triples, or JSON-LD for backup,
|
|
112
|
+
offline analysis, or feeding external SHACL/RDF validators.
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
exocortex convert --format turtle --out vault.ttl --vault ~/vault
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
**Options:**
|
|
119
|
+
|
|
120
|
+
- `--format <type>` — Serialization format: `turtle` (default), `ntriples`, `jsonld`
|
|
121
|
+
- `--out <path>` — Write to file (omit to print to stdout)
|
|
122
|
+
- `--filter <class>` — Keep only instances of a class (e.g. `ems__Task`, `ems:Task`, or full IRI)
|
|
123
|
+
- `--vault <path>` — Path to Obsidian vault (default: current directory)
|
|
124
|
+
|
|
125
|
+
**Examples:**
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
# Dump full vault as Turtle
|
|
129
|
+
exocortex convert --format turtle --out vault.ttl --vault ~/vault
|
|
130
|
+
|
|
131
|
+
# Dump to stdout, pipe through external tool
|
|
132
|
+
exocortex convert --format ntriples --vault ~/vault | wc -l
|
|
133
|
+
|
|
134
|
+
# JSON-LD with @context for known namespaces
|
|
135
|
+
exocortex convert --format jsonld --out vault.jsonld --vault ~/vault
|
|
136
|
+
|
|
137
|
+
# Subset: only ems__Task instances
|
|
138
|
+
exocortex convert --format turtle --filter ems__Task --out tasks.ttl --vault ~/vault
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
**Use cases:**
|
|
142
|
+
|
|
143
|
+
- Backup / snapshot of the vault graph at a point in time.
|
|
144
|
+
- Offline analysis with Apache Jena, Protégé, or other RDF tooling.
|
|
145
|
+
- Feeding external SHACL engines (e.g. `shacl-engine`, `rdf-validate-shacl`)
|
|
146
|
+
for validation outside the plugin.
|
|
147
|
+
- Diffing two `.ttl` snapshots to surface graph drift between runs.
|
|
148
|
+
|
|
109
149
|
### Universal Asset Creation
|
|
110
150
|
|
|
111
151
|
Create any vault asset with a single command. Auto-generates UUID, timestamp, frontmatter, resolves class names, and validates wikilinks.
|