Repository navigation
Ripple Graph Filter 0.1.0-alpha.1
Pre-releaseRipple 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