# Step 6: backend-neutral-tangent-solver

> 과거 개발 계획이다. 아래 작업·상태·예시는 현재 실행 지시가 아니다.
> 현재 구현과 검증 한계는 [기능 요약](../../docs/nonlinear-static-newton-raphson/README.md)을 따른다.

## 읽어야 할 파일

- `AGENTS.md`
- `../../docs/solver-core/README.md`
- `../../docs/solver-core/README.md`
- `../../docs/nonlinear-static-newton-raphson/formulation.md`
- `../../docs/nonlinear-static-newton-raphson/README.md`
- `include/fesa/solvers/linear/linear_solver.h`
- `include/fesa/solvers/linear/mkl_pardiso_solver.h`
- `src/fesa/solvers/linear/mkl_pardiso_solver.cpp`
- `tests/unit/solvers/linear/linear_solver_test.cpp`
- `tests/unit/solvers/linear/mkl_pardiso_solver_test.cpp`
- Step 4 files: `include/fesa/elements/nonlinear_mitc4_shell.h`

## 이전 Step 전제

Step 4 defines generally nonsymmetric nonlinear tangent matrices. Current SPD `MklPardisoSolver` must remain unchanged.

## 소유 파일

- Create: `include/fesa/solvers/linear/tangent_solver.h`
- Create: `include/fesa/solvers/linear/mkl_pardiso_tangent_solver.h`
- Create: `src/fesa/solvers/linear/mkl_pardiso_tangent_solver.cpp`
- Create: `tests/unit/solvers/linear/tangent_solver_test.cpp`
- Test: `tests/unit/solvers/linear/mkl_pardiso_solver_test.cpp`
- Modify: `src/fesa/CMakeLists.txt`
- Modify: `tests/CMakeLists.txt`

## 인터페이스

```cpp
namespace fesa {

class TangentSolver {
 public:
  virtual ~TangentSolver() = default;
  virtual Status FactorizeFresh(const SparseMatrix& matrix) = 0;
  virtual Status SolveCorrection(const Vector& rhs,
                                 Vector& correction) const = 0;
};

class MklPardisoTangentSolver final : public TangentSolver {
 public:
  MklPardisoTangentSolver();
  ~MklPardisoTangentSolver() override;
  Status FactorizeFresh(const SparseMatrix& matrix) override;
  Status SolveCorrection(const Vector& rhs, Vector& correction) const override;
};

}  // namespace fesa
```

The MKL tangent adapter uses unsymmetric PARDISO full CSR with `mtype=11`. Existing `MklPardisoSolver` keeps `mtype=2`, SPD symmetry validation, and upper-triangle copy unchanged.

## RED

Add tests first.

- `NSNR-SOLVER-001`: nonsymmetric 2x2 matrix factorizes and solves a known correction.
- `NSNR-SOLVER-002`: `0x0` matrix factorize/solve succeeds with zero-size vectors.
- `NSNR-SOLVER-003`: nonfinite matrix or RHS values fail without modifying output correction.
- `NSNR-SOLVER-004`: singular/factorization failure maps to deterministic solver diagnostic.
- `NSNR-SOLVER-005`: solve before successful factorization fails with solver diagnostic.
- `NSNR-SOLVER-006`: existing SPD `MklPardisoSolver` still rejects nonsymmetric public CSR and passes prior tests.

Run:

```powershell
cmake --build --preset windows-msvc-ninja-debug
ctest --preset windows-msvc-ninja-debug -R "TangentSolver|MklPardiso" --output-on-failure
```

Expected: new tests fail. Unexpected pass stops.

## GREEN

Implement backend-neutral tangent solver boundary and MKL full-CSR adapter. Factorization is fresh per call, releases previous backend state, validates dimensions and finite values, and translates PARDISO errors to FESA `Status`.

## VERIFY

```powershell
cmake --preset windows-msvc-ninja-debug
cmake --build --preset windows-msvc-ninja-debug
ctest --preset windows-msvc-ninja-debug -R "TangentSolver|MklPardiso" --output-on-failure
ctest --preset windows-msvc-ninja-debug --show-only=json-v1
ctest --preset windows-msvc-ninja-debug --output-on-failure
```

Use the ignored 과거 검증 자료(정리됨) preset contract. The Harness process must inherit VsDevCmd x64 and `FESA_GTEST_SOURCE_DIR`, `MKL_DIR`, `TBB_DIR`, and `HDF5_DIR` from its parent launch environment.

## 상태 기록

Update only Step 6 status and one-line payload. Executor owns timestamps, commits, retry, and advancement.

## 금지사항

- Do not modify SPD `MklPardisoSolver` behavior except tests proving it is unchanged. 이유: existing linear solver contract must remain stable.
- Do not symmetrize or regularize tangent matrices. 이유: approved tangent may be nonsymmetric and failures must surface.
- Do not expose MKL types in public headers. 이유: backend types remain behind solver boundaries.