FESADev/phases/cpp-object-oriented-modular-refactoring/step21.md

Step 21: Domain Mapper Modules

담당 역할과 필수 스킬

• 담당 역할: implementation-agent
• 필수 스킬: harness, fesa-cpp-msvc-tdd
• 이 Step만 RED -> observed failure -> minimal GREEN -> focused/full VERIFY로 수행한다.

읽어야 할 파일

• /AGENTS.md
• /docs/CODINGSTYLE.md
• /docs/ARCHITECTURE.md
• /docs/ADR.md
• /docs/linear-static-3d-euler-beam/io.md
• /docs/linear-static-mitc4-shell/io.md
• /docs/cpp-object-oriented-modular-refactoring/implementation-plan.md
• Step 11 SourceTargetResolver
• Step 12–14 semantic hierarchy/Domain files
• Step 18–19 Load and BoundaryCondition files
• /include/fesa/io/abaqus/domain_mapper.h
• /src/fesa/io/abaqus/domain_mapper.cpp
• /tests/unit/io/abaqus/domain_mapper_test.cpp
• /src/fesa/CMakeLists.txt, /tests/CMakeLists.txt
• /phases/cpp-object-oriented-modular-refactoring/index.json
• /phases/cpp-object-oriented-modular-refactoring/step21.md

작업

Requirement R-MODULE-001의 mapper split을 구현한다.

1. /tests/unit/io/abaqus/domain_mapping_components_test.cpp를 먼저 추가한다. C-MODULE-001 exercises component seams with valid and invalid syntax records and verifies topology, material/property, step/load/BC candidate content plus exact stable diagnostic order.
2. Missing private component headers causes RED compile failure.
3. Keep public facade Result<Domain> AbaqusDomainMapper::Map(const ParsedInput& input) const in domain_mapper.h. Candidate private modules under /src/fesa/io/abaqus/:

domain_mapping_context.h        shared candidate state, source locations and diagnostics
topology_mapper.h/.cpp          nodes, elements, sets, identity instances
material_property_mapper.h/.cpp current isotropic material and beam/shell section assignments
step_definition_mapper.h/.cpp   one STATIC step, concentrated loads, prescribed displacement
domain_builder.h/.cpp           final cross-reference validation and atomic Domain construction

4. Private methods consume syntax/semantic candidate references and return Status; no component commits to public Domain before final validation.
5. Preserve allowlist warnings, B31 rejection, S4/S4R common FESA-MITC4 mapping, set namespace, source identity, declaration order and every existing diagnostic code/message/source location.
6. Reduce domain_mapper.cpp to orchestration. Do not add a registry or public parser plugin API.

Acceptance Criteria

cmake --build .harness/build --config Debug --target fesa_unit_tests
ctest --test-dir .harness/build -C Debug `
  -R "InpDomainMapping|DomainMappingComponents|SourceTargetResolver" --output-on-failure
$componentFiles = @(
  "src/fesa/io/abaqus/domain_mapping_context.h",
  "src/fesa/io/abaqus/topology_mapper.cpp",
  "src/fesa/io/abaqus/material_property_mapper.cpp",
  "src/fesa/io/abaqus/step_definition_mapper.cpp",
  "src/fesa/io/abaqus/domain_builder.cpp"
)
foreach ($componentFile in $componentFiles) {
  if (-not (Test-Path -LiteralPath $componentFile -PathType Leaf)) {
    throw "Missing mapper component: $componentFile"
  }
}
rg -n "TopologyMapper|MaterialPropertyMapper|StepDefinitionMapper|DomainBuilder" `
  src/fesa/io/abaqus/domain_mapper.cpp
& "C:/Program Files/LLVM/bin/clang-format.exe" --dry-run --Werror `
  (rg --files src/fesa/io/abaqus -g "*.h" -g "*.cpp") `
  tests/unit/io/abaqus/domain_mapper_test.cpp `
  tests/unit/io/abaqus/domain_mapping_components_test.cpp
cmake --build .harness/build --config Debug
ctest --test-dir .harness/build -C Debug --show-only=json-v1
ctest --test-dir .harness/build -C Debug --output-on-failure

검증 및 상태 갱신

• RED missing components, component/facade diagnostics, facade wiring and full CTest를 summary에 기록한다.
• Diagnostic/order/semantic mapping regression is error.
• 성공 시 현재 Step만 completed로 갱신한다.
• timestamp, retry, commit, advancement는 Executor 소유다.

금지사항

• Abaqus keyword subset or unsupported behavior를 넓히지 마라.
• Failed candidate를 partial Domain에 commit하지 마라.
• Reference input을 mapper refactor에 맞춰 변경하지 마라.
• 직접 commit하거나 hook script를 수동 실행하지 마라.