Skip to content

Commit 96e6a54

Browse files
ruvnetclaude
andcommitted
docs(mincut): Major README improvements + SEO optimization
Examples README (examples/mincut/): - New title: "Networks That Think For Themselves" - Added compelling intros with analogies for all 6 examples - Added "Core Insight" section with visual network comparison - Added "Why This Changes Everything" performance comparison - Fixed run commands to use -p ruvector-mincut format - Added badges linking to crates.io, docs.rs, GitHub, ruv.io Crate README (crates/ruvector-mincut/): - Added "Self-Organizing Network Examples" section with table - Links to GitHub examples guide Cargo.toml SEO: - Improved description for discoverability - Added keywords: graph, minimum-cut, network-analysis, self-healing, dynamic-graph - Added categories: algorithms, data-structures, science, mathematics, simulation - Added homepage (ruv.io) and documentation links - Registered all 7 examples in crate Version bump: 0.1.25 → 0.1.26 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 4f23716 commit 96e6a54

5 files changed

Lines changed: 4175 additions & 112 deletions

File tree

Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ members = [
4545
resolver = "2"
4646

4747
[workspace.package]
48-
version = "0.1.25"
48+
version = "0.1.26"
4949
edition = "2021"
5050
rust-version = "1.77"
5151
license = "MIT"

crates/ruvector-mincut/Cargo.toml

Lines changed: 28 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,11 @@ license.workspace = true
77
authors.workspace = true
88
repository.workspace = true
99
readme = "README.md"
10-
description = "Subpolynomial-time dynamic minimum cut algorithm with real-time graph monitoring"
10+
description = "World's first subpolynomial dynamic min-cut: self-healing networks, AI optimization, real-time graph analysis"
11+
keywords = ["graph", "minimum-cut", "network-analysis", "self-healing", "dynamic-graph"]
12+
categories = ["algorithms", "data-structures", "science", "mathematics", "simulation"]
13+
homepage = "https://ruv.io"
14+
documentation = "https://docs.rs/ruvector-mincut"
1115

1216
[dependencies]
1317
# RuVector dependencies
@@ -72,16 +76,36 @@ name = "snn_bench"
7276
harness = false
7377

7478
[[example]]
75-
name = "mincut_neural_optimizer"
76-
path = "../../examples/mincut/neural_optimizer/main.rs"
79+
name = "temporal_attractors"
80+
path = "../../examples/mincut/temporal_attractors/src/main.rs"
81+
required-features = ["exact"]
82+
83+
[[example]]
84+
name = "strange_loop"
85+
path = "../../examples/mincut/strange_loop/main.rs"
7786
required-features = ["exact"]
7887

7988
[[example]]
80-
name = "mincut_causal_discovery"
89+
name = "causal_discovery"
8190
path = "../../examples/mincut/causal_discovery/main.rs"
8291
required-features = ["exact"]
8392

93+
[[example]]
94+
name = "time_crystal"
95+
path = "../../examples/mincut/time_crystal/main.rs"
96+
required-features = ["exact"]
97+
8498
[[example]]
8599
name = "morphogenetic"
86100
path = "../../examples/mincut/morphogenetic/main.rs"
87101
required-features = ["exact"]
102+
103+
[[example]]
104+
name = "neural_optimizer"
105+
path = "../../examples/mincut/neural_optimizer/main.rs"
106+
required-features = ["exact"]
107+
108+
[[example]]
109+
name = "benchmarks"
110+
path = "../../examples/mincut/benchmarks/main.rs"
111+
required-features = ["exact"]

crates/ruvector-mincut/README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -228,6 +228,23 @@ let current_cut = mincut.min_cut_value();
228228

229229
---
230230

231+
## 🧪 Self-Organizing Network Examples
232+
233+
Learn to build networks that think for themselves. These examples demonstrate self-healing, self-optimizing, and self-aware systems:
234+
235+
| Example | Description | Run Command |
236+
|---------|-------------|-------------|
237+
| **Temporal Attractors** | Networks that evolve toward stable states | `cargo run -p ruvector-mincut --release --example temporal_attractors` |
238+
| **Strange Loop** | Self-aware systems that monitor and repair themselves | `cargo run -p ruvector-mincut --release --example strange_loop` |
239+
| **Causal Discovery** | Trace cause-and-effect chains in failures | `cargo run -p ruvector-mincut --release --example causal_discovery` |
240+
| **Time Crystal** | Self-sustaining periodic coordination patterns | `cargo run -p ruvector-mincut --release --example time_crystal` |
241+
| **Morphogenetic** | Networks that grow like biological organisms | `cargo run -p ruvector-mincut --release --example morphogenetic` |
242+
| **Neural Optimizer** | ML that learns optimal graph configurations | `cargo run -p ruvector-mincut --release --example neural_optimizer` |
243+
244+
See the full [Examples Guide](https://github.com/ruvnet/ruvector/tree/main/examples/mincut) for detailed explanations and real-world applications.
245+
246+
---
247+
231248
## 💡 Key Features & Benefits
232249

233250
### Core Features

0 commit comments

Comments
 (0)