FESADev/docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md

# Linear Static 3D Euler Beam Implementation Report

## Metadata

- feature_id: `linear-static-3d-euler-beam`
- source_plan: `docs/implementation-plans/linear-static-3d-euler-beam.md`
- source_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md`
- status: `in-progress`
- owner_agent: `implementation-agent`
- validation_environment: `Windows, MSVC 19.51.36252, Visual Studio 18 2026, x64 Debug`
- report_started: `2026-08-09`

## Step 7 — cmake-test-foundation

- task_id: `TASK-07`
- status: `completed`
- changed_files: `CMakeLists.txt`, `cmake/FesaDependencies.cmake`,
  `include/fesa/build_info.hpp`, `src/fesa/build_info.cpp`,
  `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
  `tests/unit/build_info_test.cpp`,
  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`
- requirement_ids: `FESA-REQ-LS3DEB-030`, `FESA-REQ-LS3DEB-034`
- test_ids: `T07-BUILD-001`, `T07-BUILD-002`

| stage | exact command | exit_code | expected_or_observed_result | evidence_tail |
| --- | --- | ---: | --- | --- |
| RED | Temporarily move `include/fesa/build_info.hpp` to `.harness/build_info.hpp.red-backup`; run `cmake --build .harness/build --config Debug --target fesa_unit_tests`; restore the header in `finally` | 1 | Build fails because the public API is unavailable | `build_info.cpp(1,10): error C1083: 'fesa/build_info.hpp': No such file or directory` |
| GREEN | `cmake --build .harness/build --config Debug --target fesa_tests`; `ctest --test-dir .harness/build -C Debug -R BuildInfo --output-on-failure` | 0 | Foundation target builds and both named BuildInfo tests pass | `BuildInfo.VersionIsStableAndNonEmpty` and `BuildInfo.PublicHeaderHasNoBackendDependency`: 2/2 passed |
| VERIFY-configure | `cmake -S . -B .harness/build -A x64 -DFESA_GTEST_SOURCE_DIR=C:/git/googletest "-DMKL_DIR=C:/Program Files (x86)/Intel/oneAPI/mkl/2026.1/lib/cmake/mkl" "-DTBB_DIR=C:/Program Files (x86)/Intel/oneAPI/tbb/2023.1/lib/cmake/tbb" "-DHDF5_DIR=C:/Program Files/HDF_Group/HDF5/2.1.1/cmake"` | 0 | MSVC x64 Debug build tree generated and dependencies resolved | Visual Studio 18 2026; MSVC 19.51.36252; MKL 2026.1; TBB and HDF5 CONFIG packages resolved |
| VERIFY-build | `cmake --build .harness/build --config Debug` | 0 | FESA and GoogleTest targets build without FESA warnings | `fesa_solver.lib` and `fesa_unit_tests.exe` built; no warning emitted under FESA `/W4 /WX` |
| VERIFY-discovery | `ctest --test-dir .harness/build -C Debug --show-only=json-v1` | 0 | CTest discovers at least one test | 2 tests discovered, both carrying `linear-static-3d-euler-beam` and `unit` labels |
| VERIFY-full | `ctest --test-dir .harness/build -C Debug --output-on-failure` | 0 | Full suite has zero failures | 2/2 tests passed |

- contract_checks: GoogleTest revision
  `04ee1b4f2aefdffb0135d7cf2a2c519fe50dabe4`; no default
  `C:/git/googletest` path in production CMake; `/W4 /WX` is private to
  `fesa_solver`; public BuildInfo header exposes only `std::string_view`.
- generated_evidence: `.harness/build/src/fesa/Debug/fesa_solver.lib`,
  `.harness/build/tests/Debug/fesa_unit_tests.exe`
- environment_note: Native Codex Windows workspace sandboxes stalled in the
  CMake compiler-id `cl.exe` child process. The identical approved configure,
  build, and CTest commands were therefore executed by the root session's
  authorized unrestricted shell; the same configure completed in 7.9 seconds.
- reference_diff: unchanged
- handoff: `fesa_solver`, `fesa_unit_tests`, `fesa_tests`, normalized
  `Fesa::MKL`, `Fesa::TBB`, `Fesa::HDF5`, and `solverVersion()` are available
  to Step 8.

## Step 8 — core-diagnostics

- task_id: `TASK-08`
- status: `completed`
- changed_files: `include/fesa/core/source_identity.hpp`,
  `include/fesa/core/diagnostic.hpp`, `include/fesa/core/status.hpp`,
  `src/fesa/core/diagnostic.cpp`, `src/fesa/core/status.cpp`,
  `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
  `tests/unit/core/source_identity_test.cpp`,
  `tests/unit/core/diagnostic_test.cpp`, `tests/unit/core/status_test.cpp`,
  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`
- requirement_ids: `FESA-REQ-LS3DEB-033`, `FESA-REQ-LS3DEB-034`
- test_ids: `T08-CORE-001`, `T08-CORE-002`, `T08-CORE-003`

| stage | exact command | exit_code | expected_or_observed_result | evidence_tail |
| --- | --- | ---: | --- | --- |
| RED | `cmake --build .harness/build --config Debug --target fesa_tests` | 1 | Tests are registered before production and fail for the three missing core headers | MSVC C1083 for `fesa/core/diagnostic.hpp`, `fesa/core/source_identity.hpp`, and `fesa/core/status.hpp` |
| GREEN-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 0 | Minimal core implementation and all test translation units build | `diagnostic.cpp`, `status.cpp`, and three core tests compile; `fesa_unit_tests.exe` links |
| GREEN-test | `ctest --test-dir .harness/build -C Debug -R CoreDiagnostics --output-on-failure` | 0 | Identity, deterministic ordering, and Result exclusivity pass | 3/3 `CoreDiagnostics` tests passed |
| VERIFY-configure | `cmake -S . -B .harness/build -A x64 -DFESA_GTEST_SOURCE_DIR=C:/git/googletest "-DMKL_DIR=C:/Program Files (x86)/Intel/oneAPI/mkl/2026.1/lib/cmake/mkl" "-DTBB_DIR=C:/Program Files (x86)/Intel/oneAPI/tbb/2023.1/lib/cmake/tbb" "-DHDF5_DIR=C:/Program Files/HDF_Group/HDF5/2.1.1/cmake"` | 0 | Approved MSVC x64 build tree regenerates with normalized dependencies | Configure and generate completed; MKL 2026.1 resolved |
| VERIFY-build | `cmake --build .harness/build --config Debug` | 0 | Full Debug build passes without a new FESA warning | `fesa_solver.lib` and `fesa_unit_tests.exe` built under `/W4 /WX` |
| VERIFY-targeted | `ctest --test-dir .harness/build -C Debug -R CoreDiagnostics --output-on-failure` | 0 | Focused Step 8 suite remains green | 3/3 tests passed |
| VERIFY-discovery | `ctest --test-dir .harness/build -C Debug --show-only=json-v1` | 0 | CTest discovers the existing and new named tests | 5 tests discovered with feature and unit labels |
| VERIFY-full | `ctest --test-dir .harness/build -C Debug --output-on-failure` | 0 | Full accumulated C++ suite has zero failures | 5/5 tests passed |
| VERIFY-harness | `uv run --with pytest python -m pytest -v -rs` | 0 | Harness regression suite remains green | 4/4 tests passed |

- contract_checks: `SourceEntityId` preserves numeric and raw label forms;
  `sortDiagnostics()` applies the fixed file/line/keyword/entity/code tuple with
  stable discovery-order ties; `Status` owns sorted diagnostics and optional
  failure category; `Result<T>` owns either a value or failed status and rejects
  both failed value access and construction from an OK status. Core public
  headers include only FESA core or C++ standard-library headers; no
  MKL/TBB/HDF5 names are present.
- generated_evidence: `.harness/build/src/fesa/Debug/fesa_solver.lib`,
  `.harness/build/tests/Debug/fesa_unit_tests.exe`
- reference_diff: unchanged
- handoff: `SourceLocation`, `SourceEntityId`, `Diagnostic`, deterministic
  diagnostic sorting, `FailureCategory`, `Status`, and `Result<T>` are available
  to Step 9 and later parser/model/solver tasks.

## Step 9 — dense-math-adapters

- task_id: `TASK-09`
- status: `completed`
- changed_files: `include/fesa/math/vector.hpp`,
  `include/fesa/math/matrix.hpp`, `src/fesa/math/vector.cpp`,
  `src/fesa/math/matrix.cpp`, `tests/unit/math/vector_test.cpp`,
  `tests/unit/math/matrix_test.cpp`, `src/fesa/CMakeLists.txt`,
  `tests/CMakeLists.txt`,
  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
  `phases/linear-static-3d-euler-beam/index.json`
- requirement_ids: `FESA-REQ-LS3DEB-025`, `FESA-REQ-LS3DEB-034`
- test_ids: `T09-DENSE-001`, `T09-DENSE-002`

| stage | exact command | exit_code | expected_or_observed_result | evidence_tail |
| --- | --- | ---: | --- | --- |
| RED | `cmake --build .harness/build --config Debug --target fesa_tests`; `ctest --test-dir .harness/build -C Debug -R DenseMath --output-on-failure` | 1 | Both planned tests are registered before production and the build fails for the missing dense-math API | MSVC C1083 for `fesa/math/matrix.hpp` and `fesa/math/vector.hpp`; DenseMath discovery is unavailable until the test executable builds |
| GREEN-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 0 | Minimal dense adapters, tests, and runtime staging compile, link, and complete GoogleTest discovery | `matrix.cpp`, `vector.cpp`, both math tests, `fesa_solver.lib`, and `fesa_unit_tests.exe` built; no FESA warning under `/W4 /WX` |
| GREEN-test | `ctest --test-dir .harness/build -C Debug -R DenseMath --output-on-failure` | 0 | Storage/ownership/checking and row-major BLAS contracts pass | 2/2 DenseMath tests passed |
| VERIFY-configure | `cmake -S . -B .harness/build -A x64 -DFESA_GTEST_SOURCE_DIR=C:/git/googletest "-DMKL_DIR=C:/Program Files (x86)/Intel/oneAPI/mkl/2026.1/lib/cmake/mkl" "-DTBB_DIR=C:/Program Files (x86)/Intel/oneAPI/tbb/2023.1/lib/cmake/tbb" "-DHDF5_DIR=C:/Program Files/HDF_Group/HDF5/2.1.1/cmake"` | 0 | Approved MSVC x64 build tree regenerates with explicit dependencies | Configure/generate completed; oneMKL 2026.1 dynamic ILP64 backend resolved |
| VERIFY-build | `cmake --build .harness/build --config Debug` | 0 | Full Debug build passes without a new FESA warning | `fesa_solver.lib` and `fesa_unit_tests.exe` built under `/W4 /WX` |
| VERIFY-targeted | `ctest --test-dir .harness/build -C Debug -R DenseMath --output-on-failure` | 0 | Focused dense-math suite remains green | 2/2 tests passed |
| VERIFY-discovery | `ctest --test-dir .harness/build -C Debug --show-only=json-v1` | 0 | CTest discovers the accumulated tests and both exact DenseMath names | 7 tests discovered with feature/unit labels |
| VERIFY-full | `ctest --test-dir .harness/build -C Debug --output-on-failure` | 0 | Full accumulated C++ suite has zero failures | 7/7 tests passed |
| VERIFY-public-header | `$leaks = rg -n "mkl\.h\|MKL_INT\|CBLAS_" include/fesa; if ($LASTEXITCODE -eq 0) { throw "MKL API leaked into public headers:`n$leaks" }; if ($LASTEXITCODE -ne 1) { throw 'Public-header dependency scan failed' }` | 0 | Public headers remain independent of oneMKL API and types | `rg` returned the required no-match exit 1; wrapper scan completed with zero leaks |

- contract_checks: `Vector` accepts zero size, owns contiguous doubles, deep-copies,
  leaves moved-from objects empty and usable, checks every index, and rejects dot/axpy
  mismatches; `Matrix` accepts zero dimensions, owns row-major contiguous doubles,
  deep-copies, leaves moved-from objects empty and usable, checks every index, and
  rejects GEMV/GEMM mismatches. Hand-derived nonsquare GEMV `[50,122]` and GEMM
  `[[58,64],[139,154]]` pass. All copy, dot, norm, scale, axpy, GEMV, and GEMM calls
  cross CBLAS only inside `.cpp` files. Windows tests stage the package-resolved
  oneMKL/OpenMP runtime before post-build discovery because the exact shell does not
  assume oneAPI in `PATH`.
- generated_evidence: `.harness/build/src/fesa/Debug/fesa_solver.lib`,
  `.harness/build/tests/Debug/fesa_unit_tests.exe`
- reference_diff: unchanged; `git diff --exit-code -- reference/` exit 0
- handoff: backend-free `fesa::Vector` and `fesa::Matrix` public APIs, with owning
  dense storage and checked BLAS operations, are available to Step 10 and later
  DOF/element/assembly tasks.

### Review Fix Round 1 — matrix-storage-size-overflow

- regression_test: `tests/unit/math/matrix_test.cpp` now constructs
  `Matrix{SIZE_MAX / 2 + 1, 2}` and requires `std::length_error`.
- RED: `cmake --build .harness/build --config Debug --target fesa_tests` exited 0;
  `ctest --test-dir .harness/build -C Debug -R DenseMath --output-on-failure`
  exited 8 with 1/2 failures because the wraparound constructor threw nothing.
- fix: `Matrix` computes its storage size through a checked helper before vector
  construction and rejects exactly `columns != 0 && rows > SIZE_MAX / columns`.
- GREEN: the same targeted build and DenseMath CTest commands exited 0; 2/2 passed.
- VERIFY: approved MSVC x64 configure and full Debug build exited 0; targeted
  DenseMath passed 2/2, discovery found 7 tests, and the full suite passed 7/7.
  The public-header MKL scan had zero matches, `git diff --check` exited 0, and
  `git diff --exit-code -- reference/` exited 0.
- scope: the deferred empty-dot review minor was not changed, reference artifacts
  remain untouched, and phase Step 9 status/timestamps were not modified.

## Step 10 — domain-model

- task_id: `TASK-10`
- status: `completed`
- changed_files: `include/fesa/model/model_types.hpp`,
  `include/fesa/model/domain.hpp`, `src/fesa/model/domain.cpp`,
  `tests/unit/model/model_types_test.cpp`, `tests/unit/model/domain_test.cpp`,
  `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
  `phases/linear-static-3d-euler-beam/index.json`,
  `.superpowers/sdd/linear-static-3d-euler-beam/task-10-report.md`
- requirement_ids: `FESA-REQ-LS3DEB-015`, `FESA-REQ-LS3DEB-016`,
  `FESA-REQ-LS3DEB-021`, `FESA-REQ-LS3DEB-030`,
  `FESA-REQ-LS3DEB-034`
- test_ids: `T10-DOM-001`, `T10-DOM-002`, `T10-DOM-003`

| stage | exact command | exit_code | expected_or_observed_result | evidence_tail |
| --- | --- | ---: | --- | --- |
| RED | `cmake --build .harness/build --config Debug --target fesa_tests` | 1 | Both planned test translation units are registered before production and fail for the missing model API | MSVC C1083 for `fesa/model/domain.hpp` and `fesa/model/model_types.hpp`; the subsequent `ctest --test-dir .harness/build -C Debug -R DomainModel --output-on-failure` exited 0 with `No tests were found` because the new test executable could not build |
| GREEN-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 0 | Minimal model records, immutable Domain ownership, and both tests compile and link | `domain.cpp`, `domain_test.cpp`, and `model_types_test.cpp` built; `fesa_solver.lib` and `fesa_unit_tests.exe` linked without a FESA warning under `/W4 /WX` |
| GREEN-test | `ctest --test-dir .harness/build -C Debug -R DomainModel --output-on-failure` | 0 | Source/internal identity, stable immutable ownership, and multiple-instance distinction pass | 3/3 exact `DomainModel` tests passed |
| VERIFY-configure | `cmake -S . -B .harness/build -A x64 -DFESA_GTEST_SOURCE_DIR=C:/git/googletest "-DMKL_DIR=C:/Program Files (x86)/Intel/oneAPI/mkl/2026.1/lib/cmake/mkl" "-DTBB_DIR=C:/Program Files (x86)/Intel/oneAPI/tbb/2023.1/lib/cmake/tbb" "-DHDF5_DIR=C:/Program Files/HDF_Group/HDF5/2.1.1/cmake"` | 0 | Approved MSVC x64 build tree regenerates with explicit dependencies | Configure and generate completed; oneMKL 2026.1 and the existing dependency targets resolved |
| VERIFY-build | `cmake --build .harness/build --config Debug` | 0 | Full Debug build passes without a new FESA warning | `fesa_solver.lib` and `fesa_unit_tests.exe` built under `/W4 /WX` |
| VERIFY-targeted | `ctest --test-dir .harness/build -C Debug -R DomainModel --output-on-failure` | 0 | Focused Step 10 suite remains green | 3/3 `DomainModel` tests passed |
| VERIFY-discovery | `ctest --test-dir .harness/build -C Debug --show-only=json-v1` | 0 | CTest discovers the accumulated suite and all exact DomainModel names | 10 tests discovered with `linear-static-3d-euler-beam` and `unit` labels |
| VERIFY-full | `ctest --test-dir .harness/build -C Debug --output-on-failure` | 0 | Full accumulated C++ suite has zero failures | 10/10 tests passed |
| VERIFY-dependency-direction | Backend scan over `include/fesa`; upward-include scan from `include/fesa/model`; core-to-model include scan from `include/fesa/core` using `rg -n` and fail-on-match wrappers | 0 | Public headers expose no MKL/PARDISO/TBB/HDF5 API and preserve `core -> model` dependency direction | backend leaks 0; model upward dependencies 0; core-to-model dependencies 0 |
| VERIFY-diff | `git diff --check` | 0 | Patch has no whitespace errors | Exit 0; only Git LF-to-CRLF working-copy notices were emitted |
| VERIFY-reference | `git diff --exit-code -- reference/` | 0 | Approved reference artifacts remain unchanged | Exit 0 and `git status --short -- reference/` produced no entries |

- contract_checks: every ledger record preserves `SourceLocation`; the static
  step retains all four timing values; `PartDefinition`, `InstanceDefinition`,
  and `SourceIndexMapping` retain source-to-internal identity; `ModelDefinition`
  retains source path/content identity, heading, warnings, and all semantic
  vectors. `Domain` owns the complete definition and returns const references;
  declaration-order vector positions remain stable internal indices. Node and
  beam definitions contain no equation-numbering state, and same-part identity
  instances retain distinct source identities and connectivity.
- generated_evidence: `.harness/build/src/fesa/Debug/fesa_solver.lib`,
  `.harness/build/tests/Debug/fesa_unit_tests.exe`
- reference_diff: unchanged; `git diff --exit-code -- reference/` exit 0
- handoff: backend-free `EntityIndex`, semantic model records,
  `ModelDefinition`, and immutable `Domain::create`/const accessors are
  available to Step 11 syntax parsing and Step 12 semantic mapping.

## Step 11 — inp-syntax-parser

- task_id: `TASK-11`
- status: `completed`
- changed_files: `include/fesa/io/abaqus/input_syntax.hpp`,
  `include/fesa/io/abaqus/input_reader.hpp`,
  `src/fesa/io/abaqus/input_reader.cpp`,
  `tests/unit/io/abaqus/input_syntax_test.cpp`,
  `tests/unit/io/abaqus/input_reader_test.cpp`, `src/fesa/CMakeLists.txt`,
  `tests/CMakeLists.txt`,
  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
  `phases/linear-static-3d-euler-beam/index.json`,
  `.superpowers/sdd/linear-static-3d-euler-beam/task-11-report.md`
- requirement_ids: `FESA-REQ-LS3DEB-010`, `FESA-REQ-LS3DEB-034`,
  `FESA-REQ-LS3DEB-040`
- test_ids: `T11-SYN-001`, `T11-SYN-002`, `T11-SYN-003`, `T11-SYN-004`

| stage | exact command | exit_code | expected_or_observed_result | evidence_tail |
| --- | --- | ---: | --- | --- |
| RED | `cmake --build .harness/build --config Debug --target fesa_tests`; `ctest --test-dir .harness/build -C Debug -R InpSyntax --output-on-failure` | 1 | Both planned test files are registered before production and fail for the missing reader API | MSVC C1083 for `fesa/io/abaqus/input_reader.hpp` in both new test translation units; CTest subsequently reported `No tests were found` because the executable could not build |
| GREEN-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 0 | Minimal syntax records, binary reader, and four tests compile and link | `input_reader.cpp`, both parser test files, `fesa_solver.lib`, and `fesa_unit_tests.exe` built without a FESA warning under `/W4 /WX` |
| GREEN-test | `ctest --test-dir .harness/build -C Debug -R InpSyntax --output-on-failure` | 0 | All exact syntax parsing behaviors pass | 4/4 `InpSyntax` tests passed |
| VERIFY-configure | `cmake -S . -B .harness/build -A x64 -DFESA_GTEST_SOURCE_DIR=C:/git/googletest "-DMKL_DIR=C:/Program Files (x86)/Intel/oneAPI/mkl/2026.1/lib/cmake/mkl" "-DTBB_DIR=C:/Program Files (x86)/Intel/oneAPI/tbb/2023.1/lib/cmake/tbb" "-DHDF5_DIR=C:/Program Files/HDF_Group/HDF5/2.1.1/cmake"` | 0 | Approved MSVC x64 build tree regenerates with explicit dependencies | Visual Studio 18 2026/MSVC environment selected; configure and generate completed; oneMKL 2026.1 resolved |
| VERIFY-build | `cmake --build .harness/build --config Debug` | 0 | Full Debug build passes without a new FESA warning | `fesa_solver.lib` and `fesa_unit_tests.exe` built under `/W4 /WX` |
| VERIFY-targeted | `ctest --test-dir .harness/build -C Debug -R InpSyntax --output-on-failure` | 0 | Focused Step 11 suite remains green | 4/4 exact `InpSyntax` tests passed |
| VERIFY-discovery | `ctest --test-dir .harness/build -C Debug --show-only=json-v1` | 0 | CTest discovers the accumulated suite and all four exact syntax tests | 14 tests discovered with all four `InpSyntax` names and feature/unit labels |
| VERIFY-full | `ctest --test-dir .harness/build -C Debug --output-on-failure` | 0 | Full accumulated C++ suite has zero failures | 14/14 tests passed |
| VERIFY-dependency-direction | Backend, upward I/O, core-to-I/O, and semantic-policy scans over the Step 11 public/production files using `rg -n` fail-on-match wrappers | 0 | Public headers retain backend-free `core -> io/abaqus` direction and syntax parsing contains no Step 12 policy | backend leaks 0; upward I/O dependencies 0; core-to-I/O dependencies 0; semantic-policy matches 0; exactly four `InpSyntax` tests found |
| VERIFY-diff | `git diff --check` | 0 | Patch has no whitespace errors | Exit 0; only informational Git LF-to-CRLF working-copy notices were emitted |
| VERIFY-reference | `git diff --exit-code -- reference/`; `git status --short -- reference/` | 0 | Approved legacy reference artifacts remain unchanged | Diff exit 0 and reference status empty |

- contract_checks: `ParsedInput` records the absolute lexically normalized
  source path and exact binary-byte FNV-1a identity formatted as
  `fnv1a64:` plus 16 lowercase hexadecimal digits. Keyword and parameter names
  alone become ASCII uppercase; parameter values, data label lexemes, empty
  and trailing data fields, and each keyword `originalLine` preserve source
  spelling. Comments and blanks remain excluded while physical 1-based file
  line accounting is retained. Unreadable file, empty keyword, and orphan data
  return categorized input diagnostics. No keyword allowlist, wrapper/nesting,
  numeric conversion, B31/B33, or output-request decision exists in this Step.
  The read-only legacy input parses as 30 keyword blocks with exact identity
  `fnv1a64:04543464cc970405`, unchanged bytes, and unchanged modification time.
- generated_evidence: `.harness/build/src/fesa/Debug/fesa_solver.lib`,
  `.harness/build/tests/Debug/fesa_unit_tests.exe`
- reference_diff: unchanged; `git diff --exit-code -- reference/` exit 0
- handoff: backend-free `KeywordParameter`, `DataLine`, `KeywordBlock`,
  `ParsedInput`, and `AbaqusInputReader::read` with syntax/source provenance are
  available to Step 12 semantic mapping.


## Step 12 — inp-domain-mapping

- task_id: `TASK-12`
- status: `completed`
- changed_files: `include/fesa/io/abaqus/domain_mapper.hpp`,
  `src/fesa/io/abaqus/domain_mapper.cpp`,
  `tests/unit/io/abaqus/domain_mapper_test.cpp`,
  `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
  `phases/linear-static-3d-euler-beam/index.json`,
  `.superpowers/sdd/linear-static-3d-euler-beam/task-12-report.md`
- requirement_ids: `FESA-REQ-LS3DEB-001`, `FESA-REQ-LS3DEB-002`,
  `FESA-REQ-LS3DEB-005` through `FESA-REQ-LS3DEB-020`,
  `FESA-REQ-LS3DEB-034`, `FESA-REQ-LS3DEB-044`
- test_ids: `T12-MAP-001`, `T12-MAP-002`, `T12-MAP-003`,
  `T12-MAP-004`, `T12-MAP-005`

| stage | exact command | exit_code | expected_or_observed_result | evidence_tail |
| --- | --- | ---: | --- | --- |
| RED | `cmake --build .harness/build --config Debug --target fesa_tests`; `ctest --test-dir .harness/build -C Debug -R InpDomainMapping --output-on-failure` | 1 | All five planned tests were registered before production and the implementation-owned mapper API was absent | MSVC C1083 reported missing `fesa/io/abaqus/domain_mapper.hpp`; CTest then found no runnable mapper tests because the executable did not build |
| GREEN-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 0 | The mapper, five semantic tests, solver library, and unit executable compile and link | `domain_mapper.cpp` and `domain_mapper_test.cpp` built without a FESA warning under `/W4 /WX` |
| GREEN-test | `ctest --test-dir .harness/build -C Debug -R InpDomainMapping --output-on-failure` | 0 | Exact supported inventory, deterministic expansion, no-op policy, negative portfolio, and DLOAD exclusion pass | 5/5 exact `InpDomainMapping` tests passed |
| VERIFY-configure | `cmake -S . -B .harness/build -A x64 -DFESA_GTEST_SOURCE_DIR=C:/git/googletest "-DMKL_DIR=C:/Program Files (x86)/Intel/oneAPI/mkl/2026.1/lib/cmake/mkl" "-DTBB_DIR=C:/Program Files (x86)/Intel/oneAPI/tbb/2023.1/lib/cmake/tbb" "-DHDF5_DIR=C:/Program Files/HDF_Group/HDF5/2.1.1/cmake"` | 0 | Approved MSVC x64 build tree regenerates with explicit dependencies | Windows SDK and oneMKL 2026.1 resolved; configure and generate completed |
| VERIFY-build | `cmake --build .harness/build --config Debug` | 0 | Full Debug build passes without a new FESA warning | `fesa_solver.lib` and `fesa_unit_tests.exe` built under the existing `/W4 /WX` policy |
| VERIFY-targeted | `ctest --test-dir .harness/build -C Debug -R InpDomainMapping --output-on-failure` | 0 | Focused Step 12 suite remains green after review corrections | 5/5 `InpDomainMapping` tests passed |
| VERIFY-discovery | `ctest --test-dir .harness/build -C Debug --show-only=json-v1` | 0 | CTest discovers the accumulated suite and all five exact mapper tests | 19 tests discovered with all five planned `InpDomainMapping` names and feature/unit labels |
| VERIFY-full | `ctest --test-dir .harness/build -C Debug --output-on-failure` | 0 | Full accumulated C++ suite has zero failures | 19/19 tests passed |
| VERIFY-dependency-direction | Backend, upward-I/O, core-upward, distributed-load-object, unapproved-`nu`-gate, and exact-test-count scans over Step 12 files | 0 | Public dependencies and approved scope remain intact | backend leaks 0; upward dependencies 0; core upward dependencies 0; distributed-load objects 0; unapproved `nu` gates 0; mapper tests 5 |
| VERIFY-diff | `git diff --check` plus trailing-whitespace scan over the three new files | 0 | Tracked and untracked Step 12 files have no whitespace errors | Git reported informational LF-to-CRLF notices only; new-file trailing whitespace matches 0 |
| VERIFY-reference | `git diff --exit-code -- reference/`; `git status --short -- reference/` | 0 | Approved legacy reference artifacts remain read-only and unchanged | Reference diff exit 0 and reference status empty |

- contract_checks: the mapper consumes syntax-only `ParsedInput` and returns
  one complete immutable `Domain` or a categorized diagnostic. It enforces the
  monotonic top-level/part/assembly/step grammar, B33 only, identity instances
  only, exact inclusive set generation, case-insensitive references, stable
  declaration/instance-order internal IDs, and `SourceEntityId
  {instance_name, source_label}`. Direct node labels, part and assembly sets,
  ambiguous multi-instance labels/sets, and direct-versus-set constraint
  overlap are resolved before Domain success.
- contract_checks: material and section mapping uses exact `E,nu`,
  `G=E/(2*(1+nu))`, `A,I11,I12,I22,J`, exact `I12=0`,
  `Iy=I11`, `Iz=I22`, and `n1 -> local y`. It requires positive
  `E,G,A,I11,I22,J` without adding a `nu < 0.5` gate. Nonfinite material,
  section, and guide data are model failures. Overflow-safe scaled norms apply
  the exact length and guide-vector inequalities; equality fails, values above
  pass, and valid finite geometry near `1e308` is accepted without a fallback
  axis.
- contract_checks: model-level and step-level boundaries and sole-step CLOAD
  targets are validated, conflicting expanded node/DOF prescriptions fail, the
  exact four positive finite `*STATIC` fields are retained, and the sole
  canonical result identity is `Step-1`, frame 0. The exact warning no-op
  allowlist produces stable `ignored-input-keyword` diagnostics without
  changing semantic objects. B31, transforms, nested/dependent assembly
  semantics, second step, NLGEOM, unknown keywords, and `*DLOAD` fail; no
  distributed-load Domain object, B31 alias, multi-step path, or transform
  fallback exists.
- generated_evidence: `.harness/build/src/fesa/Debug/fesa_solver.lib`,
  `.harness/build/tests/Debug/fesa_unit_tests.exe`
- reference_diff: unchanged; the legacy cantilever input maps successfully
  while exact bytes and modification time remain unchanged, and
  `git diff --exit-code -- reference/` exits 0
- handoff: `AbaqusDomainMapper::map(const ParsedInput&)`, complete immutable
  Domain objects, stable expanded node/element/set identities, validated
  material/section indices, and the sole `StaticStepDefinition` are available
  to Step 13 `AnalysisModel`.

### Step 12 Review Corrections

- A duplicate-`*ELASTIC` regression test first failed because a second
  consecutive elasticity record lost the owning-material state. Preserving the
  immediate material eligibility produced the exact `duplicate-entity`
  diagnostic and restored targeted 5/5.
- Ten monotonic-order regressions first failed at the accepted late-`*PART`
  case. Explicit phase state now rejects late model data, assembly sets before
  or followed by instances, element-before-node, incomplete block closure, and
  pre-`*STATIC` or out-of-order history data with
  `invalid-keyword-location`.
- Review edge tests then failed for valid `1e308` geometry and for nonfinite
  elasticity being classified as input. Context-specific model parsing,
  overflow-safe scaled geometry comparisons, active beam-section context,
  exact GENERATE landing, direct/ambiguous target resolution, and exact
  threshold cases were added. The corrected focused suite passes 5/5 and the
  full accumulated suite passes 19/19.
- Focused re-review returned Critical 0 and Important 0. Its sole remaining
  minor requested an explicit negative transverse-shear context assertion;
  that table case was added and passes without a production change.