Release 0.3.1

🚀 What's New in v0.3.1

Introducing the initial release of Simplicial Complex for Obsidian! This plugin replaces standard pairwise note-linking with higher-order structures—visualizing clusters of notes that belong together as a living, organic field. By leveraging mathematical simplicial complexes, the plugin shifts your vault's graph from basic connection to deep, contextual coherence.

✨ Key Features & Improvements

• Organic Blob Renderer - Visualizes multi-note clusters (simplices) as soft, overlapping fields using an advanced capsule-union metaball algorithm.
• Living Layout Engine - Employs a fluid, force-based simulation featuring natural kinetic breathing that drifts gently when idle and dynamically wakes during vault updates.
• Smart Centrality Analysis - Automatically evaluates your structure to identify exactly which core notes anchor the most clusters.
• Simplex-to-Note Promotion - Allows you to compress an entire multi-note cluster into a first-class, standalone vault note that retains its historical structural relationships.
• Lasso-Select Creation - Quickly click and drag a lasso selector directly on the canvas to cluster multiple nodes into a brand-new simplex instantly.
• Automatic Face Generation - Automatically generates all mathematical sub-faces (up to dimension 4) when a higher-order simplex is declared, keeping your model valid.

⚙️ Core Configuration & Settings

• Persistence Customization - Added options to save simplex definitions locally in each note's frontmatter (ideal for Obsidian Sync) or within a central _simplicial.md file.
• Dimension Filtering - Toggle independent visibility sliders for individual edges (1-simplices), clusters (2-simplices), and dense cores (3+ simplices).
• Performance Optimization - Integrated an automatic sleep threshold that pauses the physics simulation rendering loop when kinetic energy drops, ensuring zero idle CPU drain.
• Visual Precision Adjustments - Control granular layout parameters including noise breathing amount, label density thresholds, and custom dark/light mode toggles.

📝 How to Define Your Simplices

Simplices are parsed directly from your existing markdown vault files via two human-readable syntaxes:

1. Inline Shorthand

Simply type the delta symbol followed by space-separated note titles (or use the built-in Ctrl/Cmd + Shift + S shortcut to insert it):

△ startup capital talent

2. YAML Frontmatter

For granular control, attach metadata such as custom human-readable labels or cohesive force weights:

---
simplices:
  - nodes: [startup, capital, talent]
    label: "founding engine"
    weight: 0.9
---

🛠️ Installation & Requirements

1. Ensure your local installation of Obsidian is updated to the required desktop/mobile baseline.
2. For manual testing: Download and place main.js, manifest.json, and styles.css into your vault's .obsidian/plugins/simplicial-complex/ folder.
3. Reload plugins or restart Obsidian to initialize the Simplicial Complex view.

---

💖 Support the Project: If you find this topological approach to knowledge management useful, please consider starring the repository or opening an issue with your feedback!