Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions ai/memory-bank/tasks/issue-1-ccd.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
name: Continuous Collision Detection (CCD) Implementation
about: Implement CCD to prevent high-velocity tunneling.
title: 'Continuous Collision Detection (CCD) Implementation'
labels: 'enhancement, physics'
assignees: ''
---

## Description
Implement Continuous Collision Detection to prevent "tunneling" at high velocities. This involves calculating time of impact (TOI) between moving bodies.

## Acceptance Criteria
- 0% tunneling observed at velocities up to 1000m/s.
- CCD pipeline integrates with the existing collision detection system.
- Performance impact remains within acceptable bounds for high-speed simulations.

## Assigned Agency Role
Continuous Collision Detection (CCD) Implementation needs to be resolved/issued/tested by the Physics Engineer.

## Files to Create/Edit
- src/physics/ccd.rs
- src/physics/mod.rs
- src/physics/world.rs

## Reference
Tier 1 Projects - Continuous Collision Detection (CCD)
26 changes: 26 additions & 0 deletions ai/memory-bank/tasks/issue-2-dod.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
name: Data-Oriented Design (DOD) & ECS Refactoring
about: Refactor core engine structures to support Data-Oriented Design.
title: 'Data-Oriented Design (DOD) & ECS Refactoring'
labels: 'architecture, refactoring'
assignees: ''
---

## Description
Refactor core engine structures to support Data-Oriented Design, making it compatible with modern ECS architectures like Bevy and Flecs.

## Acceptance Criteria
- Memory layout is optimized for cache coherency.
- API allows integration with a standard ECS in under 2 hours.
- Core systems (e.g., rigid body updates) operate on flat arrays or similar DOD structures.

## Assigned Agency Role
Data-Oriented Design (DOD) & ECS Refactoring needs to be resolved/issued/tested by the Architecture Lead.

## Files to Create/Edit
- src/physics/rigid_body.rs
- src/physics/world.rs
- src/physics/components.rs

## Reference
Tier 1 Projects - Data-Oriented Design (DOD) & ECS Compatibility
26 changes: 26 additions & 0 deletions ai/memory-bank/tasks/issue-3-simd.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
name: Multithreading and SIMD Vectorization
about: Integrate rayon and wide for performance scaling.
title: 'Multithreading and SIMD Vectorization'
labels: 'performance, optimization'
assignees: ''
---

## Description
Integrate `rayon` for task-based parallelism and `wide` for vectorizing math operations in the physics pipeline.

## Acceptance Criteria
- Engine scales linearly up to 16 threads on supported hardware.
- Core math operations (vector additions, dot products, cross products) utilize SIMD instructions.
- Thread synchronization does not introduce unresolvable latency.

## Assigned Agency Role
Multithreading and SIMD Vectorization needs to be resolved/issued/tested by the Systems Engineer.

## Files to Create/Edit
- Cargo.toml
- src/geometry/vector.rs
- src/physics/world.rs

## Reference
Tier 1 Projects - Multithreading and SIMD Vectorization
26 changes: 26 additions & 0 deletions ai/memory-bank/tasks/issue-4-determinism.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
name: Cross-Platform Determinism Setup
about: Implement deterministic execution across architectures.
title: 'Cross-Platform Determinism Setup'
labels: 'determinism, ci'
assignees: ''
---

## Description
Implement strict floating-point math control and deterministic solver execution across multiple architectures.

## Acceptance Criteria
- Simulation yields identical results across different CPU architectures.
- CI testing pipeline includes deterministic behavior checks.
- Fallback mechanisms for non-deterministic math functions are implemented.

## Assigned Agency Role
Cross-Platform Determinism Setup needs to be resolved/issued/tested by the Systems Engineer.

## Files to Create/Edit
- src/physics/math.rs
- src/physics/constants.rs
- Tests related to cross-platform execution.

## Reference
Tier 2 Projects - Cross-Platform Determinism
26 changes: 26 additions & 0 deletions ai/memory-bank/tasks/issue-5-gpu.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
name: GPU Acceleration (Compute Shaders) Integration
about: Integrate WGPU for GPU-accelerated compute shaders.
title: 'GPU Acceleration (Compute Shaders) Integration'
labels: 'gpu, wgpu'
assignees: ''
---

## Description
Future-proof the engine by integrating WGPU for GPU-accelerated compute shaders, initially targeting massive scale simulations like soft-bodies or fluids.

## Acceptance Criteria
- Basic WGPU context is established and integrated into the build.
- A prototype compute shader runs and passes data back to the CPU physics pipeline.
- CPU pipeline remains stable during GPU execution.

## Assigned Agency Role
GPU Acceleration (Compute Shaders) Integration needs to be resolved/issued/tested by the Graphics Engineer.

## Files to Create/Edit
- Cargo.toml
- src/physics/gpu.rs
- shaders/compute.wgsl

## Reference
Tier 2 Projects - GPU Acceleration (Compute Shaders)
8 changes: 4 additions & 4 deletions ai/memory-bank/tasks/worm-engine-tasklist.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
- src/physics/world.rs

**Reference**: Issue Task 1 CCD
**Assignment**: Continuous Collision Detection (CCD) needs to be resolved/issued/tested by the Physics Engineer
**Assignment**: Continuous Collision Detection (CCD) Implementation needs to be resolved/issued/tested by the Physics Engineer

### [ ] Task 2: Data-Oriented Design (DOD) & ECS Refactoring (30-60 minutes)
**Description**: Refactor core engine structures to support Data-Oriented Design, making it compatible with modern ECS architectures like Bevy and Flecs.
Expand All @@ -35,7 +35,7 @@
- src/physics/components.rs

**Reference**: Issue Task 2 DOD
**Assignment**: Data-Oriented Design (DOD) & ECS Refactoring (30-60 minutes) needs to be resolved/issued/tested by the Architecture Lead
**Assignment**: Data-Oriented Design (DOD) & ECS Refactoring needs to be resolved/issued/tested by the Architecture Lead

### [ ] Task 3: Multithreading Implementation
**Description**: Integrate `rayon` for task-based parallelism. Refactor parallel iteration over large mutable SoA arrays in `World::step` to chain `.par_iter_mut().zip(...)` instead of passing tuples.
Expand All @@ -49,7 +49,7 @@
- src/physics/world.rs

**Reference**: Issue Task 3 SIMD (Part 1 - Rayon)
**Assignment**: Multithreading Implementation needs to be resolved/issued/tested by the Systems Engineer
**Assignment**: Multithreading and SIMD Vectorization needs to be resolved/issued/tested by the Systems Engineer

### [ ] Task 4: SIMD Vectorization Implementation
**Description**: Integrate `wide` for vectorizing math operations in the physics pipeline. Defer until DOD refactoring is complete to use a Structure of Arrays (SoA) approach. Avoid applying Array of Structures (AoS) SIMD to individual math primitives like `Vector3d`.
Expand All @@ -63,7 +63,7 @@
- src/physics/world.rs

**Reference**: Issue Task 3 SIMD (Part 2 - SIMD)
**Assignment**: SIMD Vectorization Implementation needs to be resolved/issued/tested by the Systems Engineer
**Assignment**: Multithreading and SIMD Vectorization needs to be resolved/issued/tested by the Systems Engineer

### [ ] Task 5: Cross-Platform Determinism Setup
**Description**: Implement strict floating-point math control and deterministic solver execution across multiple architectures using `libm`.
Expand Down