Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector'
This commit is contained in:
ruv
218
vendor/ruvector/examples/delta-behavior/CHANGELOG.md
vendored
Normal file
218
vendor/ruvector/examples/delta-behavior/CHANGELOG.md
vendored
Normal file
@@ -0,0 +1,218 @@
|
||||
# Changelog
|
||||
|
||||
All notable changes to Delta-Behavior will be documented in this file.
|
||||
|
||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
### Planned
|
||||
- WASM module for browser-based coherence enforcement
|
||||
- Async runtime integration (tokio, async-std)
|
||||
- Metric export for Prometheus/Grafana monitoring
|
||||
- Python bindings via PyO3
|
||||
|
||||
---
|
||||
|
||||
## [0.1.0] - 2026-01-28
|
||||
|
||||
### Added
|
||||
|
||||
#### Core Library
|
||||
- `Coherence` type with range validation (0.0-1.0)
|
||||
- `CoherenceBounds` for defining threshold parameters
|
||||
- `CoherenceState` for tracking coherence history and trends
|
||||
- `DeltaSystem` trait for implementing coherence-preserving systems
|
||||
- `DeltaConfig` with preset configurations (`default()`, `strict()`, `relaxed()`)
|
||||
- `DeltaEnforcer` implementing three-layer enforcement
|
||||
|
||||
#### Configuration Types
|
||||
- `EnergyConfig` for soft constraint layer parameters
|
||||
- `SchedulingConfig` for medium constraint layer parameters
|
||||
- `GatingConfig` for hard constraint layer parameters
|
||||
|
||||
#### Transition System
|
||||
- `Transition<T>` generic transition wrapper
|
||||
- `TransitionConstraint` for defining transition limits
|
||||
- `TransitionResult` enum (Applied, Blocked, Throttled, Modified)
|
||||
|
||||
#### Attractor Dynamics
|
||||
- `Attractor<S>` for representing stable states
|
||||
- `AttractorBasin<S>` for tracking basin membership
|
||||
- `GuidanceForce` for computing attractor-directed forces
|
||||
|
||||
#### Enforcement
|
||||
- Three-layer enforcement stack (Energy, Scheduling, Gating)
|
||||
- `EnforcementResult` enum (Allowed, Blocked, Throttled)
|
||||
- Recovery mode handling with configurable margin
|
||||
|
||||
#### Applications (feature-gated)
|
||||
- **01 Self-Limiting Reasoning** (`self-limiting`)
|
||||
- `SelfLimitingReasoner` with coherence-based depth limiting
|
||||
- Automatic activity reduction under uncertainty
|
||||
|
||||
- **02 Computational Event Horizons** (`event-horizon`)
|
||||
- `ComputationalHorizon` with asymptotic slowdown
|
||||
- No hard recursion limits
|
||||
|
||||
- **03 Artificial Homeostasis** (`homeostasis`)
|
||||
- `HomeostasisSystem` with multi-variable regulation
|
||||
- Coherence-based survival mechanism
|
||||
|
||||
- **04 Self-Stabilizing World Models** (`world-model`)
|
||||
- `StabilizingWorldModel` with belief coherence
|
||||
- Hallucination prevention via coherence gating
|
||||
|
||||
- **05 Coherence-Bounded Creativity** (`creativity`)
|
||||
- `CreativeEngine` with novelty/coherence balance
|
||||
- Bounded exploration in generative tasks
|
||||
|
||||
- **06 Anti-Cascade Financial Systems** (`financial`)
|
||||
- `AntiCascadeMarket` with coherence-based circuit breakers
|
||||
- Order rejection for cascade-inducing trades
|
||||
|
||||
- **07 Graceful Aging** (`aging`)
|
||||
- `AgingSystem` with complexity reduction
|
||||
- Function preservation under simplification
|
||||
|
||||
- **08 Swarm Intelligence** (`swarm`)
|
||||
- `CoherentSwarm` with global coherence enforcement
|
||||
- Action modification for coherence preservation
|
||||
|
||||
- **09 Graceful Shutdown** (`shutdown`)
|
||||
- `GracefulSystem` with shutdown as attractor
|
||||
- Automatic safe termination under degradation
|
||||
|
||||
- **10 Pre-AGI Containment** (`containment`)
|
||||
- `ContainmentSubstrate` with capability ceilings
|
||||
- Coherence-bounded intelligence growth
|
||||
|
||||
#### Documentation
|
||||
- Comprehensive rustdoc comments on all public APIs
|
||||
- Module-level documentation with examples
|
||||
- `WHITEPAPER.md` with executive summary and technical deep-dive
|
||||
- `docs/API.md` comprehensive API reference
|
||||
- ADR documents for all major design decisions
|
||||
- Mathematical foundations documentation
|
||||
|
||||
#### Testing
|
||||
- Unit tests for all core types
|
||||
- Integration tests for enforcement stack
|
||||
- Acceptance test demonstrating Delta-behavior under chaos
|
||||
- Per-application test suites
|
||||
|
||||
#### Architecture
|
||||
- Domain-Driven Design structure
|
||||
- Clean separation between core, applications, and infrastructure
|
||||
- Feature flags for minimal binary size
|
||||
|
||||
### Technical Details
|
||||
|
||||
#### Coherence Bounds (Defaults)
|
||||
| Parameter | Value | Purpose |
|
||||
|-----------|-------|---------|
|
||||
| `min_coherence` | 0.3 | Absolute floor (writes blocked below) |
|
||||
| `throttle_threshold` | 0.5 | Rate limiting begins |
|
||||
| `target_coherence` | 0.8 | System seeks this level |
|
||||
| `max_delta_drop` | 0.1 | Maximum per-transition drop |
|
||||
|
||||
#### Energy Cost Model
|
||||
```
|
||||
cost = base_cost * (1 + instability)^exponent
|
||||
```
|
||||
|
||||
Where:
|
||||
- `base_cost = 1.0`
|
||||
- `exponent = 2.0`
|
||||
- `max_cost = 100.0`
|
||||
- `budget_per_tick = 10.0`
|
||||
|
||||
#### Supported Platforms
|
||||
- Linux (x86_64, aarch64)
|
||||
- macOS (x86_64, aarch64)
|
||||
- Windows (x86_64)
|
||||
- WASM (wasm32-unknown-unknown)
|
||||
|
||||
#### Minimum Supported Rust Version (MSRV)
|
||||
- Rust 1.75.0
|
||||
|
||||
### Dependencies
|
||||
- No required runtime dependencies (no_std compatible with `alloc`)
|
||||
- Optional: `std` feature for full functionality
|
||||
|
||||
### Breaking Changes
|
||||
- Initial release - no breaking changes
|
||||
|
||||
### Migration Guide
|
||||
- Initial release - no migration required
|
||||
|
||||
---
|
||||
|
||||
## [0.0.1] - 2026-01-15
|
||||
|
||||
### Added
|
||||
- Initial project structure
|
||||
- Proof-of-concept implementation
|
||||
- Basic documentation
|
||||
|
||||
---
|
||||
|
||||
## Version History Summary
|
||||
|
||||
| Version | Date | Highlights |
|
||||
|---------|------|------------|
|
||||
| 0.1.0 | 2026-01-28 | First stable release with full API |
|
||||
| 0.0.1 | 2026-01-15 | Initial proof-of-concept |
|
||||
|
||||
---
|
||||
|
||||
## Upgrade Notes
|
||||
|
||||
### From 0.0.1 to 0.1.0
|
||||
|
||||
The 0.0.1 release was a proof-of-concept. Version 0.1.0 is a complete rewrite with:
|
||||
|
||||
1. **New API**: The `DeltaSystem` trait replaces the previous ad-hoc functions
|
||||
2. **Configuration**: Use `DeltaConfig` instead of individual parameters
|
||||
3. **Enforcement**: The `DeltaEnforcer` provides unified enforcement
|
||||
4. **Applications**: Enable specific applications via feature flags
|
||||
|
||||
Example migration:
|
||||
|
||||
```rust
|
||||
// 0.0.1 (proof-of-concept)
|
||||
let coherence = check_coherence(&state);
|
||||
if coherence > 0.3 {
|
||||
apply_transition(&mut state, &delta);
|
||||
}
|
||||
|
||||
// 0.1.0 (stable)
|
||||
use delta_behavior::{DeltaConfig, enforcement::DeltaEnforcer, Coherence};
|
||||
|
||||
let config = DeltaConfig::default();
|
||||
let mut enforcer = DeltaEnforcer::new(config);
|
||||
|
||||
let current = system.coherence();
|
||||
let predicted = system.predict_coherence(&transition);
|
||||
|
||||
match enforcer.check(current, predicted) {
|
||||
EnforcementResult::Allowed => system.step(&transition),
|
||||
EnforcementResult::Throttled(delay) => std::thread::sleep(delay),
|
||||
EnforcementResult::Blocked(reason) => eprintln!("Blocked: {}", reason),
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- [Documentation](https://docs.rs/delta-behavior)
|
||||
- [Repository](https://github.com/ruvnet/ruvector)
|
||||
- [Issue Tracker](https://github.com/ruvnet/ruvector/issues)
|
||||
- [Whitepaper](./WHITEPAPER.md)
|
||||
- [API Reference](./docs/API.md)
|
||||
|
||||
[Unreleased]: https://github.com/ruvnet/ruvector/compare/delta-behavior-v0.1.0...HEAD
|
||||
[0.1.0]: https://github.com/ruvnet/ruvector/releases/tag/delta-behavior-v0.1.0
|
||||
[0.0.1]: https://github.com/ruvnet/ruvector/releases/tag/delta-behavior-v0.0.1
|
||||
Reference in New Issue
Block a user