516 lines
47 KiB
Markdown
516 lines
47 KiB
Markdown
# 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.
|
|
|
|
### Step 12 Root Review Fix Round 1 — same-token target ambiguity
|
|
|
|
- finding: `resolveNodeTarget` returned one matching node set before computing
|
|
the direct numeric source-label candidates. A token such as `1` therefore
|
|
silently selected `NSET=1` even when node source label `1` was also a valid
|
|
interpretation.
|
|
- regression_scope: `RejectsUnsupportedAndInvalidPortfolio` now constructs an
|
|
`NSET` named `1` containing node `2` while node label `1` also exists, and
|
|
exercises the same token independently through both `*BOUNDARY` and
|
|
`*CLOAD`. It requires input-category `unresolved-reference` with exact
|
|
keyword, entity identity `1`, and original data-row file/line location.
|
|
- RED-build: `cmake --build .harness/build --config Debug --target fesa_tests`
|
|
exited 0 after registering the two regression paths.
|
|
- RED-test: `ctest --test-dir .harness/build -C Debug -R "InpDomainMapping.RejectsUnsupportedAndInvalidPortfolio" --output-on-failure`
|
|
exited 8. The test failed at `same-token-boundary`
|
|
because `result.hasValue()` was true instead of the required structured
|
|
failure.
|
|
- fix: target resolution computes both name-matched node sets and numeric
|
|
direct-node candidates before returning either. Multiple candidates within
|
|
an interpretation or one valid candidate from each interpretation use the
|
|
existing input/`unresolved-reference` ambiguity contract; unique set-only
|
|
and direct-only paths remain unchanged.
|
|
- GREEN: the targeted build exited 0 and `ctest --test-dir .harness/build -C Debug -R InpDomainMapping --output-on-failure`
|
|
exited 0 with 5/5 passed.
|
|
- VERIFY: approved explicit-dependency MSVC x64 configure and full Debug build
|
|
exited 0; discovery found 19 tests including all five mapper names; full
|
|
CTest passed 19/19. Backend/upward/core-upward/distributed-load/unapproved
|
|
`nu` scans were 0, exactly five mapper tests remained, `git diff --check`
|
|
exited 0, and reference diff/status were clean.
|
|
- deferred_scope: the separate known-but-misplaced keyword diagnostic Minor was
|
|
deliberately not changed in this fix round. No phase-index change and no
|
|
commit were made.
|
|
|
|
## Step 13 — analysis-model
|
|
|
|
- task_id: `TASK-13`
|
|
- status: `completed`
|
|
- changed_files: `include/fesa/analysis/analysis_model.hpp`,
|
|
`src/fesa/analysis/analysis_model.cpp`,
|
|
`tests/unit/analysis/analysis_model_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-13-report.md`
|
|
- requirement_ids: `FESA-REQ-LS3DEB-001`, `FESA-REQ-LS3DEB-021`,
|
|
`FESA-REQ-LS3DEB-034`
|
|
- test_ids: `T13-MODEL-001`, `T13-MODEL-002`, `T13-MODEL-003`
|
|
|
|
| stage | exact command | exit_code | expected_or_observed_result | evidence_tail |
|
|
| --- | --- | ---: | --- | --- |
|
|
| RED-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 1 | Exactly three planned tests were registered before production and the AnalysisModel API was absent | MSVC C1083 reported missing `fesa/analysis/analysis_model.hpp` from `analysis_model_test.cpp` |
|
|
| RED-test | `ctest --test-dir .harness/build -C Debug -R AnalysisModel --output-on-failure` | 0 | No focused test was runnable because the test executable could not rebuild | CTest reported `No tests were found` after the implementation-owned compile RED |
|
|
| GREEN-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 0 | Minimal non-owning active view and all three tests compile and link | `analysis_model.cpp`, `analysis_model_test.cpp`, `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 AnalysisModel --output-on-failure` | 0 | Active classification, address identity/immutability, and cardinality diagnostics pass | 3/3 exact `AnalysisModel` 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 explicit-dependency MSVC x64 build tree generates | 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 `/W4 /WX` |
|
|
| VERIFY-targeted | `ctest --test-dir .harness/build -C Debug -R AnalysisModel --output-on-failure` | 0 | Focused Step 13 suite remains green | 3/3 exact `AnalysisModel` tests passed |
|
|
| VERIFY-discovery | `ctest --test-dir .harness/build -C Debug --show-only=json-v1` | 0 | CTest discovers the accumulated suite and all three exact AnalysisModel names | 22 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 | 22/22 tests passed |
|
|
| VERIFY-dependency-direction | Backend public-header, upward-analysis dependency, DOF/numeric-state, exact-test-count, registration, and trailing-whitespace scans using fail-on-match `rg` wrappers | 0 | AnalysisModel stays backend-free and below later solver layers, with no DOF/state ownership | backend leaks 0; upward dependencies 0; DOF/numeric-state leaks 0; tests 3; CMake registrations 1/1; new-file trailing whitespace 0 |
|
|
| VERIFY-diff | `git diff --check` | 0 | Tracked 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 read-only and unchanged | Reference diff exit 0 and reference status empty |
|
|
|
|
- contract_checks: `AnalysisModel` stores one non-owning `const Domain*` plus
|
|
stable `EntityIndex` vectors only. All Domain elements are active in stable
|
|
internal order; reachable material and section IDs are deduplicated by an
|
|
ascending internal-index scan; boundary/load IDs are the sole step's vector
|
|
positions. `domain()` and `step()` preserve exact address identity, and the
|
|
tests verify semantic storage addresses and values remain unchanged. Missing
|
|
and multiple steps return categorized `invalid-model-cardinality` and
|
|
`unsupported-multiple-step` diagnostics. No equation numbering, constraint
|
|
propagation, multi-step activation, or numeric analysis state was added.
|
|
- 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: the exact AnalysisModel ledger API, sole-step reference, and stable
|
|
active element/material/section/boundary/load IDs are available to Step 14
|
|
`DofManager` without copying or mutating Domain entities.
|
|
|
|
## Step 14 — dof-manager
|
|
|
|
- task_id: `TASK-14`
|
|
- status: `completed`
|
|
- changed_files: `include/fesa/fem/dof_manager.hpp`,
|
|
`src/fesa/fem/dof_manager.cpp`, `tests/unit/fem/dof_manager_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-14-report.md`
|
|
- requirement_ids: `FESA-REQ-LS3DEB-003`, `FESA-REQ-LS3DEB-007`,
|
|
`FESA-REQ-LS3DEB-011`, `FESA-REQ-LS3DEB-022`,
|
|
`FESA-REQ-LS3DEB-034`
|
|
- test_ids: `T14-DOF-001`, `T14-DOF-002`, `T14-DOF-003`,
|
|
`T14-DOF-004`
|
|
|
|
| stage | exact command | exit_code | expected_or_observed_result | evidence_tail |
|
|
| --- | --- | ---: | --- | --- |
|
|
| RED-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 1 | Exactly four planned tests are registered before production and fail for the missing DofManager API | MSVC C1083 reported missing `fesa/fem/dof_manager.hpp` from `dof_manager_test.cpp` after successful CMake regeneration |
|
|
| RED-test | `ctest --test-dir .harness/build -C Debug -R DofManager --output-on-failure` | 0 | No focused test is runnable because the test executable cannot rebuild | CTest reported `No tests were found` after the implementation-owned compile RED |
|
|
| GREEN-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 0 | Minimal DofManager, its four tests, solver library, and unit executable compile and link | `dof_manager.cpp`, `dof_manager_test.cpp`, `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 DofManager --output-on-failure` | 0 | Numbering, constraints, scatter/pattern, and mapping-owned round-trip pass | 4/4 exact `DofManager` 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 explicit-dependency MSVC x64 build tree generates | 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 `/W4 /WX` |
|
|
| VERIFY-targeted | `ctest --test-dir .harness/build -C Debug -R DofManager --output-on-failure` | 0 | Focused Step 14 suite remains green | 4/4 exact `DofManager` 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 DofManager names | 26 tests discovered, including 4 `DofManager` tests, with feature/unit labels |
|
|
| VERIFY-full | `ctest --test-dir .harness/build -C Debug --output-on-failure` | 0 | Full accumulated C++ suite has zero failures | 26/26 tests passed |
|
|
| VERIFY-contract-scans | Backend public-header, upward-FEM dependency, model/analysis equation-state, out-of-scope feature, unledgered API, exact-test-count, and CMake-registration scans using fail-on-match `rg` wrappers | 0 | DofManager remains the sole equation/scatter/pattern owner and implements only the exact public ledger | backend leaks 0; upward dependencies 0; model/analysis equation state 0; penalty/MPC/RBE/numeric sparse storage 0; unledgered APIs 0; tests 4; registrations 1/1 |
|
|
| VERIFY-diff | `git diff --check` plus trailing-whitespace scan over the three new files | 0 | Tracked and untracked Step 14 files have no whitespace errors | Diff check exit 0; 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: full DOFs follow stable node index and exact component order
|
|
`[UX,UY,UZ,URX,URY,URZ]`; free equations and constrained DOFs are ascending
|
|
full-index mappings. Case-insensitive node-set and direct source-label targets
|
|
expand deterministically; equal overlap is retained once, while different
|
|
values return `conflicting-boundary-condition` at the conflicting row's
|
|
source location. `prescribedValues()` has the same size/order as
|
|
`constrainedDofs()` and preserves zero and nonzero values.
|
|
- contract_checks: each active B33 definition has one 12-entry scatter in
|
|
endpoint/component order. The full-space CSR pattern has 19 row offsets and
|
|
252 sorted-unique structural columns for the two-element chain fixture.
|
|
Stable free/constrained maps reconstruct the full vector without adding an
|
|
API absent from the exact ledger. Node and element records remain unchanged
|
|
and contain no equation IDs; no penalty, MPC, RBE, or sparse numeric storage
|
|
was added.
|
|
- generated_evidence: `.harness/build/src/fesa/Debug/fesa_solver.lib`,
|
|
`.harness/build/tests/Debug/fesa_unit_tests.exe`,
|
|
`.harness/build/step14-ctest-discovery.json`
|
|
- reference_diff: unchanged; `git diff --exit-code -- reference/` exit 0
|
|
- handoff: backend-free `DofComponent`, `SparsePattern`, and the exact
|
|
`DofManager` ledger API provide deterministic full/free/constrained maps,
|
|
prescribed `dc`, active-element scatter, and full structural CSR pattern to
|
|
Step 15 and later assembly/constraint tasks.
|
|
|
|
## Step 15 — analysis-state
|
|
|
|
- task_id: `TASK-15`
|
|
- status: `completed`
|
|
- changed_files: `include/fesa/results/result_records.hpp`,
|
|
`include/fesa/analysis/analysis_state.hpp`,
|
|
`src/fesa/analysis/analysis_state.cpp`,
|
|
`tests/unit/results/result_records_test.cpp`,
|
|
`tests/unit/analysis/analysis_state_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-15-report.md`
|
|
- requirement_ids: `FESA-REQ-LS3DEB-003`, `FESA-REQ-LS3DEB-023`,
|
|
`FESA-REQ-LS3DEB-031`, `FESA-REQ-LS3DEB-034`
|
|
- test_ids: `T15-STATE-001`, `T15-STATE-002`, `T15-STATE-003`
|
|
|
|
| stage | exact command | exit_code | expected_or_observed_result | evidence_tail |
|
|
| --- | --- | ---: | --- | --- |
|
|
| RED-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 1 | Exactly three planned tests were registered before production and the result-record/state API was absent | MSVC C1083 reported missing `fesa/analysis/analysis_state.hpp` from both new test translation units after successful CMake regeneration |
|
|
| RED-test | `ctest --test-dir .harness/build -C Debug -R AnalysisState --output-on-failure` | 0 | No focused test was runnable because the unit test executable could not rebuild | CTest reported `No tests were found` after the implementation-owned compile RED |
|
|
| GREEN-build | `cmake --build .harness/build --config Debug --target fesa_tests` | 0 | Minimal records/state implementation and all three tests compile and link | `analysis_state.cpp`, both 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 AnalysisState --output-on-failure` | 0 | Allocation, identity/order, and copy/move ownership tests pass | 3/3 exact `AnalysisState` 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 explicit-dependency MSVC x64 build tree generates | 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 `/W4 /WX` |
|
|
| VERIFY-targeted | `ctest --test-dir .harness/build -C Debug -R AnalysisState --output-on-failure` | 0 | Focused Step 15 suite remains green | 3/3 exact `AnalysisState` tests passed |
|
|
| VERIFY-discovery | `ctest --test-dir .harness/build -C Debug --show-only=json-v1` | 0 | CTest discovers the accumulated suite and all three exact AnalysisState names | 29 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 | 29/29 tests passed |
|
|
| VERIFY-contract-scans | Backend public-header, forbidden V0 state/API, Domain/AnalysisModel ownership, result-record upward dependency, exact-test-count, and CMake-registration scans using fail-on-match `rg` wrappers | 0 | State and row records implement only the exact backend-free V0 ledger | backend leaks 0; forbidden state/API 0; Domain/AnalysisModel ownership 0; result upward dependencies 0; tests 3; registrations 1/1/1 |
|
|
| VERIFY-diff | `git diff --check` plus trailing-whitespace scan over the five new files | 0 | Tracked and untracked Step 15 files have no whitespace errors | Diff check exit 0; 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: displacement, external force, internal force, residual, and
|
|
reaction are five independently owned `Vector` values sized to
|
|
`DofManager::fullDofCount()` and zero-initialized. Reaction remains in full
|
|
DOF index space even when only a subset is constrained, leaving free
|
|
components available for residual sanity checks. Mutable and const accessors
|
|
return the same owned vector storage.
|
|
- contract_checks: `StepFrameIdentity`, `EndpointResultRow`, `GaussResultRow`,
|
|
and `StressS11Row` match the public ledger field order. Owned endpoint,
|
|
Gauss, and stress vectors preserve append order and expose stable mutable and
|
|
const collections. Default copy/move operations follow the ledger: copies
|
|
deep-own vector/row storage, and moved-to state retains identity and values
|
|
without aliasing another live state.
|
|
- contract_checks: no velocity, acceleration, temperature, iteration history,
|
|
nonlinear element state, Domain copy/reference, equation numbering, HDF5,
|
|
MKL, or oneTBB API/storage was added.
|
|
- 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: the exact backend-free result records and `AnalysisState` ledger API
|
|
provide full-space mutable solution vectors, step/frame identity, and stable
|
|
recovery-row collections to Step 16 and later result recovery/output tasks.
|