Repository navigation
Releases
Ripple 0.2.0 — Unified Graph Workspace
Ripple 0.2.0 — Unified Graph Workspace
Overview
Ripple moves from a bounded sidebar preview to an independent Obsidian graph
workspace. Four distinct rendering modes consume one Vault index, relevance
filter and selection state. No upstream graph plugin needs to be installed.
Highlights
- Immutable revisioned graph model and incremental metadata/link updates.
- Full workspace graph navigation, note opening and node inspection.
- Frontier, Dense, Cluster and actual 3D Galaxy views.
- Identical relevance eligibility and preserved selection across modes.
- Independent cameras, Frontier drag/pins and workspace-state restoration.
- Bounded opt-in local body indexing; no slider-triggered file reads.
- Self-contained production bundle, license inventory, reproducible build and
cross-platform CI.
View modes
Frontier uses a d3-force worker and Canvas navigation with draggable/pinnable
nodes. Dense uses a grid, batched points, viewport culling and label/edge LOD.
Cluster uses folder-seeded label propagation, visible convex hulls and
cross-community links; it is not Louvain or a crossing optimizer. Galaxy uses
Three.js, perspective xyz geometry, ray picking and OrbitControls, with a
deterministic spatial layout rather than 3D force simulation.
The modes share scoring and eligible nodes. Rendering budgets affect links,
labels and hulls only: Canvas modes draw up to 30,000 links and 120 labels;
Cluster draws up to 200 hulls; Galaxy draws up to 100,000 links, reduced to
5,000 above 10,000 visible nodes. Dense suppresses links below 0.3×.
Compatibility
Real integration was exercised on Windows 11 with Obsidian API/app 1.14.5
(desktop installer 1.13.7, Electron 43.3.0) in a newly created 32-note synthetic
vault and separate app profile. It covered loading, every mode, shared 65%
filtering, selection, real 3D rotation, independent cameras, note opening,
pins, themes, metadata updates, view restoration and plugin restart.
Other Obsidian versions, macOS/Linux host integration, mobile, other GPUs and
large real vaults are NOT TESTED. Linux/Windows CI and browser fixtures do
not substitute for those compatibility tests. Full evidence and synthetic
performance observations: VALIDATION.md.
Installation
Download main.js, manifest.json and styles.css into
<vault>/<configDir>/plugins/ripple-graph-filter/. Reload Obsidian, enable
Ripple Graph Workspace, then run Open graph workspace. Minimum app
version is 1.14.5. All runtime code, notices and worker source are bundled in
main.js; no extra asset chunks are required. Community directory submission
has not been made or approved.
Known limitations
The index supports up to 50,000 Markdown nodes and resolved links. Body indexing
is limited to 32,768 characters/note and 8 million total. Attachments,
unresolved targets and Canvas cards are not indexed. Keyboard node lookup
lists the first 200 visible notes. Narrow the query for others.
Large software-WebGL context creation can be slow; synthetic 50,000-node runs
recorded long context-initialization stalls. Frame samples include outliers
and are not FPS promises. Active Frontier physics moves unpinned nodes and can
take time to settle. Unpinned positions are reseeded on reload; cameras and
pinned positions restore. There is no automatic bridge retention, 3D physics,
AI extraction, remote model service or automatic link writing.
Privacy
Ripple initiates no network requests, telemetry or external service calls.
Indexes, body text, query and selection stay in memory. Mode, cameras and pins
are serialized by the official Workspace API. Original notes, frontmatter,
links, paths and other plugin settings are not written. Required runtime
libraries are bundled with their original MIT/ISC notices.
Checksums
The Release includes SHA256SUMS.txt covering main.js, manifest.json and
styles.css. Release assets are built from the final merged commit and compared
with CI bytes, then downloaded again and checked before delivery. The GitHub
Release body uses this document verbatim.
Upgrade notes
The plugin ID remains ripple-graph-filter and the existing command/view IDs
are preserved. The display name is now Ripple Graph Workspace. Existing 0.1
leaves load the new view; move an old sidebar leaf into a main tab if desired.
There are no persisted 0.1 query/settings files to migrate. Four-plugin
discovery is no longer the primary UI: the modes are owned by Ripple and have
no runtime requirement for those plugins. Historical alpha assets/tags remain
unchanged.
Ripple Graph Filter 0.1.0-alpha.1
Ripple Graph Filter 0.1.0-alpha.1
This is an explicitly incomplete alpha for manual installation, not a stable
four-plugin compatibility release.
Ripple now provides an independent sidebar graph with local, explainable
keyword scoring, a monotone 0–100% threshold, live counts, fixed preview
coordinates, score details, and clear/restore. Empty queries restore the original
visibility. Optional note-body reads are bounded and local. The plugin never
writes notes, links, frontmatter or other plugins' files/settings.
Adapter status
| Plugin | Source-audited version | Capability in this alpha |
|---|---|---|
| GraphFrontier | 0.8.6 / graphfrontier | Read-only visible snapshots via documented api.runTool with listViews/getState/getGraph. External filtering/restoration unsupported: the upstream subset is shared and saved with layouts. |
| Advanced Graph View | 0.10.1 / graph-insight | Detection only; no documented safe external filtering API. |
| Smart Cluster Graph | 1.2.0 / smart-cluster-graph | Detection only; nodes, hidden state and pins are private. |
| Galaxy View | 0.6.1 / galaxy-view | Detection only; no stable documented controller API. |
No real Obsidian integration test was performed. Source inspection, upstream
fixtures, unit/Mock tests and browser SDK fixtures do not establish full live
compatibility. GraphPro is outside scope. Exact audited commits and minimal
upstream API proposals are in ADAPTER_COMPATIBILITY.md.
Validation and limits
- 53 unit/Mock tests and 10 browser fixture checks passed.
- Formatting, lint, strict TypeScript, production esbuild, asset checks,
locked dependency license audit and npm vulnerability audit passed. - No known npm vulnerabilities at release audit time; no third-party runtime
code is bundled. License: MPL-2.0. - Linux/Windows CI, browser checks and build repeatability are release gates.
- Synthetic benchmarks include 50,000 nodes / 149,969 edges; they are core-only
observations, not Obsidian UI performance claims. - Desktop Obsidian 1.14.5+ only. Standalone indexing: 50,000 notes maximum;
optional body index: 32,768 characters/note and 8 million total. Diagram:
first 250 candidates / 600 links; list: first 100 visible results. Counts use
all candidates. No AI, remote models or automatic bridge retention.
Install
Download main.js, manifest.json and styles.css into
<vault>/<configDir>/plugins/ripple-graph-filter/, reload Obsidian and enable
Ripple Graph Filter. Open the graph filter command. SHA256SUMS.txt supplements
the required installation assets.
The tag matches manifest version exactly, without a v prefix. Current
Obsidian directory rules
accept numeric x.y.z versions; this alpha follows the requested prerelease
policy and is for manual installation. No community submission or approval is
claimed. A numeric stable release still needs safe upstream APIs and live
integration validation.
Release source: c4ff05431df0e8bd2889cabf6b10188d606a5714.
Validation: final default-branch CI,
PR #2 CI.
SHA-256
0e0b6e7cd8a464b35521ad71ce7d21a6e5c7b836114a7add246890d58735f750 main.js
f9761a30b1c2b701a22c4412f3ba5cec39dd3c0ca17fc0997f4a4bc275206bf3 manifest.json
5a7d24e1d67fc153ae1615f15ffdfae7e65e4aed8df3109182dc7aaff8d4fe1b styles.css