# Auto Object Rotation Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Add an automatic object rotation option that searches full 3D orientation space and minimizes passage cross-section projection area, preferring lower height when areas are close.

**Architecture:** Add a pure geometry optimizer under `src/Utils/CoordinateSystem` with deterministic candidate search and projection scoring. Wire it into `EditRotationWindow` through a small request/result context so the window stays reusable and writes the resulting host X/Y/Z correction into existing inputs.

**Tech Stack:** .NET Framework 4.8, C# 7.3, MSTest, `System.Numerics.Quaternion`.

---

### Task 1: Geometry Optimizer

**Files:**
- Create: `src/Utils/CoordinateSystem/ObjectPassageProjectionOptimizer.cs`
- Test: `UnitTests/CoordinateSystem/ObjectPassageProjectionOptimizerTests.cs`
- Modify: `TransportPlugin.csproj`
- Modify: `NavisworksTransport.UnitTests.csproj`

- [ ] Write failing tests for cross-section area scoring, height tie-break, deterministic output, and degenerate path directions.
- [ ] Run `./run-unit-tests.bat` and verify the new tests fail because the optimizer does not exist.
- [ ] Implement deterministic full-3D candidate search using quaternion candidates from axis permutations and Euler refinement.
- [ ] Run `./run-unit-tests.bat` and verify the new tests pass.

### Task 2: UI Context And Button

**Files:**
- Modify: `src/UI/WPF/Views/EditRotationWindow.xaml`
- Modify: `src/UI/WPF/Views/EditRotationWindow.xaml.cs`
- Modify: `src/UI/WPF/ViewModels/AnimationControlViewModel.cs`

- [ ] Add `ObjectPassageProjectionOptimizationRequest` construction in the ViewModel using current path start direction, object dimensions in model units, and `HostCoordinateAdapter`.
- [ ] Add an “自动调整” button in the adjustment window.
- [ ] On click, call the optimizer, update X/Y/Z text fields, and keep the dialog open for user review.
- [ ] Show a clear warning without changing values when optimization input is invalid.

### Task 3: Verification

**Files:**
- No new files.

- [ ] Run `./run-unit-tests.bat`.
- [ ] Run `./compile.bat`.
- [ ] Inspect `git diff` for unrelated changes and keep the change scoped.