mirror of
https://github.com/allaunthefox/Research-Stack.git
synced 2026-07-31 03:05:21 +00:00
65 lines
1.6 KiB
Markdown
65 lines
1.6 KiB
Markdown
# Obsidian Integration
|
|
|
|
Status: local vault configured as an audit/shim surface.
|
|
|
|
## Local Vault
|
|
|
|
Default vault path:
|
|
|
|
```bash
|
|
/home/allaun/Documents/Research Stack/Obdisidan connector
|
|
```
|
|
|
|
The name reflects the existing local folder. It can be renamed later, but the current configuration preserves the working vault path instead of moving user data.
|
|
|
|
## Lake
|
|
|
|
Default JSON-L lake:
|
|
|
|
```bash
|
|
/home/allaun/Documents/Research Stack/data/obsidian_lake.jsonl
|
|
```
|
|
|
|
Obsidian notes are stored as `informational_bind` entries with path, title, tags, links, content hash, content preview, and full markdown content.
|
|
|
|
## Commands
|
|
|
|
Ingest local vault into the lake:
|
|
|
|
```bash
|
|
python3 scripts/obsidian_sync_shim.py ingest --backend local
|
|
```
|
|
|
|
Two-way local sync with Obsidian winning conflicts:
|
|
|
|
```bash
|
|
python3 scripts/obsidian_sync_shim.py sync --backend local
|
|
```
|
|
|
|
Export lake entries back to the vault without overwriting existing notes:
|
|
|
|
```bash
|
|
python3 scripts/obsidian_sync_shim.py export --backend local
|
|
```
|
|
|
|
Use the topological engine when it is online, otherwise fall back to the local vault:
|
|
|
|
```bash
|
|
python3 scripts/obsidian_sync_shim.py sync --backend auto
|
|
```
|
|
|
|
## Boundaries
|
|
|
|
- Obsidian is an audit and navigation surface.
|
|
- ENE/JSON-L remains the durable substrate for ingested notes.
|
|
- Notion and Linear remain tracker/publication surfaces.
|
|
- Lean remains the source of truth for formal math and invariants.
|
|
- No secrets belong in Obsidian notes.
|
|
|
|
## Related Surfaces
|
|
|
|
- `scripts/obsidian_sync_shim.py`
|
|
- `infra/topological_engine_client.py`
|
|
- `data/obsidian_lake.jsonl`
|
|
- `docs/MCP_NOTION_LINEAR_SETUP.md`
|
|
- `docs/AGENTS.md`
|