From deeaae5d425335ecb42df050ae606efe6d69593c Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 28 Dec 2025 15:07:41 +0000 Subject: [PATCH] refactor(examples): Consolidate tier examples into unified folder Reorganized all application tier examples into a single `tiers/` folder with consistent prefixed naming: Tier 1 (Practical): - t1_anomaly_detection: Infrastructure anomaly detection - t1_edge_autonomy: Drone/vehicle autonomy - t1_medical_wearable: Medical monitoring Tier 2 (Transformative): - t2_self_optimizing: Self-stabilizing software - t2_swarm_intelligence: Distributed IoT coordination - t2_adaptive_simulation: Digital twins Tier 3 (Exotic): - t3_self_awareness: Machine self-sensing - t3_synthetic_nervous: Environment-as-organism - t3_bio_machine: Prosthetics integration Benefits: - Easier navigation with alphabetical tier grouping - Consistent naming convention (t1_, t2_, t3_ prefixes) - Single folder reduces directory clutter - Updated Cargo.toml and README.md to match --- crates/ruvector-nervous-system/Cargo.toml | 37 ++++++++++--------- .../examples/README.md | 26 +++++++------ .../t1_anomaly_detection.rs} | 0 .../t1_edge_autonomy.rs} | 0 .../t1_medical_wearable.rs} | 0 .../t2_adaptive_simulation.rs} | 0 .../t2_self_optimizing.rs} | 0 .../t2_swarm_intelligence.rs} | 0 .../t3_bio_machine.rs} | 0 .../t3_self_awareness.rs} | 0 .../t3_synthetic_nervous.rs} | 0 11 files changed, 33 insertions(+), 30 deletions(-) rename crates/ruvector-nervous-system/examples/{tier1/anomaly_detection.rs => tiers/t1_anomaly_detection.rs} (100%) rename crates/ruvector-nervous-system/examples/{tier1/edge_autonomy.rs => tiers/t1_edge_autonomy.rs} (100%) rename crates/ruvector-nervous-system/examples/{tier1/medical_wearable.rs => tiers/t1_medical_wearable.rs} (100%) rename crates/ruvector-nervous-system/examples/{tier2/adaptive_simulation.rs => tiers/t2_adaptive_simulation.rs} (100%) rename crates/ruvector-nervous-system/examples/{tier2/self_optimizing_systems.rs => tiers/t2_self_optimizing.rs} (100%) rename crates/ruvector-nervous-system/examples/{tier2/swarm_intelligence.rs => tiers/t2_swarm_intelligence.rs} (100%) rename crates/ruvector-nervous-system/examples/{tier3/bio_machine_interface.rs => tiers/t3_bio_machine.rs} (100%) rename crates/ruvector-nervous-system/examples/{tier3/machine_self_awareness.rs => tiers/t3_self_awareness.rs} (100%) rename crates/ruvector-nervous-system/examples/{tier3/synthetic_nervous_systems.rs => tiers/t3_synthetic_nervous.rs} (100%) diff --git a/crates/ruvector-nervous-system/Cargo.toml b/crates/ruvector-nervous-system/Cargo.toml index f69feb3f..e524ac36 100644 --- a/crates/ruvector-nervous-system/Cargo.toml +++ b/crates/ruvector-nervous-system/Cargo.toml @@ -57,41 +57,42 @@ harness = false name = "latency_benchmarks" harness = false +# Unified Tier Examples (in examples/tiers/) # Tier 1: Immediate Practical Applications [[example]] -name = "anomaly_detection" -path = "examples/tier1/anomaly_detection.rs" +name = "t1_anomaly_detection" +path = "examples/tiers/t1_anomaly_detection.rs" [[example]] -name = "edge_autonomy" -path = "examples/tier1/edge_autonomy.rs" +name = "t1_edge_autonomy" +path = "examples/tiers/t1_edge_autonomy.rs" [[example]] -name = "medical_wearable" -path = "examples/tier1/medical_wearable.rs" +name = "t1_medical_wearable" +path = "examples/tiers/t1_medical_wearable.rs" # Tier 2: Near-Term Transformative Applications [[example]] -name = "self_optimizing_systems" -path = "examples/tier2/self_optimizing_systems.rs" +name = "t2_self_optimizing" +path = "examples/tiers/t2_self_optimizing.rs" [[example]] -name = "swarm_intelligence" -path = "examples/tier2/swarm_intelligence.rs" +name = "t2_swarm_intelligence" +path = "examples/tiers/t2_swarm_intelligence.rs" [[example]] -name = "adaptive_simulation" -path = "examples/tier2/adaptive_simulation.rs" +name = "t2_adaptive_simulation" +path = "examples/tiers/t2_adaptive_simulation.rs" # Tier 3: Exotic But Real Applications [[example]] -name = "machine_self_awareness" -path = "examples/tier3/machine_self_awareness.rs" +name = "t3_self_awareness" +path = "examples/tiers/t3_self_awareness.rs" [[example]] -name = "synthetic_nervous_systems" -path = "examples/tier3/synthetic_nervous_systems.rs" +name = "t3_synthetic_nervous" +path = "examples/tiers/t3_synthetic_nervous.rs" [[example]] -name = "bio_machine_interface" -path = "examples/tier3/bio_machine_interface.rs" +name = "t3_bio_machine" +path = "examples/tiers/t3_bio_machine.rs" diff --git a/crates/ruvector-nervous-system/examples/README.md b/crates/ruvector-nervous-system/examples/README.md index 64b860d1..583e9fb3 100644 --- a/crates/ruvector-nervous-system/examples/README.md +++ b/crates/ruvector-nervous-system/examples/README.md @@ -10,6 +10,8 @@ Bio-inspired nervous system architecture examples demonstrating the transition f These examples show how nervous system thinking unlocks new products, markets, and research categories. The architecture enables systems that **age well** instead of breaking under complexity. +All tier examples are organized in the unified `tiers/` folder with prefixed names for easy navigation. + ## Application Tiers ### Tier 1: Immediate Practical Applications @@ -17,39 +19,39 @@ These examples show how nervous system thinking unlocks new products, markets, a | Example | Domain | Key Benefit | |---------|--------|-------------| -| [anomaly_detection](tier1/anomaly_detection.rs) | Infrastructure, Finance, Security | Detection before failure, microsecond response | -| [edge_autonomy](tier1/edge_autonomy.rs) | Drones, Vehicles, Robotics | Lower power, certified reflex paths | -| [medical_wearable](tier1/medical_wearable.rs) | Monitoring, Assistive Devices | Adapts to the person, always-on, private | +| [t1_anomaly_detection](tiers/t1_anomaly_detection.rs) | Infrastructure, Finance, Security | Detection before failure, microsecond response | +| [t1_edge_autonomy](tiers/t1_edge_autonomy.rs) | Drones, Vehicles, Robotics | Lower power, certified reflex paths | +| [t1_medical_wearable](tiers/t1_medical_wearable.rs) | Monitoring, Assistive Devices | Adapts to the person, always-on, private | ### Tier 2: Near-Term Transformative Applications *Possible once local learning and coherence routing mature* | Example | Domain | Key Benefit | |---------|--------|-------------| -| [self_optimizing_systems](tier2/self_optimizing_systems.rs) | Agents Monitoring Agents | Self-stabilizing software, structural witnesses | -| [swarm_intelligence](tier2/swarm_intelligence.rs) | IoT Fleets, Sensor Meshes | Scale without fragility, emergent intelligence | -| [adaptive_simulation](tier2/adaptive_simulation.rs) | Digital Twins, Logistics | Always-warm simulation, costs scale with relevance | +| [t2_self_optimizing](tiers/t2_self_optimizing.rs) | Agents Monitoring Agents | Self-stabilizing software, structural witnesses | +| [t2_swarm_intelligence](tiers/t2_swarm_intelligence.rs) | IoT Fleets, Sensor Meshes | Scale without fragility, emergent intelligence | +| [t2_adaptive_simulation](tiers/t2_adaptive_simulation.rs) | Digital Twins, Logistics | Always-warm simulation, costs scale with relevance | ### Tier 3: Exotic But Real Applications *Technically grounded, novel research directions* | Example | Domain | Key Benefit | |---------|--------|-------------| -| [machine_self_awareness](tier3/machine_self_awareness.rs) | Structural Self-Sensing | Systems say "I am becoming unstable" | -| [synthetic_nervous_systems](tier3/synthetic_nervous_systems.rs) | Buildings, Factories, Cities | Environments respond like organisms | -| [bio_machine_interface](tier3/bio_machine_interface.rs) | Prosthetics, Rehabilitation | Machines stop fighting biology | +| [t3_self_awareness](tiers/t3_self_awareness.rs) | Structural Self-Sensing | Systems say "I am becoming unstable" | +| [t3_synthetic_nervous](tiers/t3_synthetic_nervous.rs) | Buildings, Factories, Cities | Environments respond like organisms | +| [t3_bio_machine](tiers/t3_bio_machine.rs) | Prosthetics, Rehabilitation | Machines stop fighting biology | ## Quick Start ```bash # Run a Tier 1 example -cargo run --example anomaly_detection +cargo run --example t1_anomaly_detection # Run a Tier 2 example -cargo run --example swarm_intelligence +cargo run --example t2_swarm_intelligence # Run a Tier 3 example -cargo run --example machine_self_awareness +cargo run --example t3_self_awareness ``` ## Architecture Principles diff --git a/crates/ruvector-nervous-system/examples/tier1/anomaly_detection.rs b/crates/ruvector-nervous-system/examples/tiers/t1_anomaly_detection.rs similarity index 100% rename from crates/ruvector-nervous-system/examples/tier1/anomaly_detection.rs rename to crates/ruvector-nervous-system/examples/tiers/t1_anomaly_detection.rs diff --git a/crates/ruvector-nervous-system/examples/tier1/edge_autonomy.rs b/crates/ruvector-nervous-system/examples/tiers/t1_edge_autonomy.rs similarity index 100% rename from crates/ruvector-nervous-system/examples/tier1/edge_autonomy.rs rename to crates/ruvector-nervous-system/examples/tiers/t1_edge_autonomy.rs diff --git a/crates/ruvector-nervous-system/examples/tier1/medical_wearable.rs b/crates/ruvector-nervous-system/examples/tiers/t1_medical_wearable.rs similarity index 100% rename from crates/ruvector-nervous-system/examples/tier1/medical_wearable.rs rename to crates/ruvector-nervous-system/examples/tiers/t1_medical_wearable.rs diff --git a/crates/ruvector-nervous-system/examples/tier2/adaptive_simulation.rs b/crates/ruvector-nervous-system/examples/tiers/t2_adaptive_simulation.rs similarity index 100% rename from crates/ruvector-nervous-system/examples/tier2/adaptive_simulation.rs rename to crates/ruvector-nervous-system/examples/tiers/t2_adaptive_simulation.rs diff --git a/crates/ruvector-nervous-system/examples/tier2/self_optimizing_systems.rs b/crates/ruvector-nervous-system/examples/tiers/t2_self_optimizing.rs similarity index 100% rename from crates/ruvector-nervous-system/examples/tier2/self_optimizing_systems.rs rename to crates/ruvector-nervous-system/examples/tiers/t2_self_optimizing.rs diff --git a/crates/ruvector-nervous-system/examples/tier2/swarm_intelligence.rs b/crates/ruvector-nervous-system/examples/tiers/t2_swarm_intelligence.rs similarity index 100% rename from crates/ruvector-nervous-system/examples/tier2/swarm_intelligence.rs rename to crates/ruvector-nervous-system/examples/tiers/t2_swarm_intelligence.rs diff --git a/crates/ruvector-nervous-system/examples/tier3/bio_machine_interface.rs b/crates/ruvector-nervous-system/examples/tiers/t3_bio_machine.rs similarity index 100% rename from crates/ruvector-nervous-system/examples/tier3/bio_machine_interface.rs rename to crates/ruvector-nervous-system/examples/tiers/t3_bio_machine.rs diff --git a/crates/ruvector-nervous-system/examples/tier3/machine_self_awareness.rs b/crates/ruvector-nervous-system/examples/tiers/t3_self_awareness.rs similarity index 100% rename from crates/ruvector-nervous-system/examples/tier3/machine_self_awareness.rs rename to crates/ruvector-nervous-system/examples/tiers/t3_self_awareness.rs diff --git a/crates/ruvector-nervous-system/examples/tier3/synthetic_nervous_systems.rs b/crates/ruvector-nervous-system/examples/tiers/t3_synthetic_nervous.rs similarity index 100% rename from crates/ruvector-nervous-system/examples/tier3/synthetic_nervous_systems.rs rename to crates/ruvector-nervous-system/examples/tiers/t3_synthetic_nervous.rs