Step 1: core-primitives

읽어야 할 파일

먼저 아래 파일들을 읽고 프로젝트의 아키텍처와 이전 step 산출물을 파악하라:

/AGENTS.md
/docs/PRD.md
/docs/ARCHITECTURE.md
/docs/ADR.md
/CMakeLists.txt
/tests/unit/CMakeLists.txt

이전 step에서 만들어진 CMake/CTest 구성을 꼼꼼히 읽고, 새 unit test가 자동 등록되는 방식과 일관성을 유지하라.

작업

solver skeleton의 공통 primitive를 /src/fesa/core/ 아래 header-only로 구현한다.

필수 파일:

/src/fesa/core/ids.hpp
/src/fesa/core/diagnostic.hpp
/src/fesa/core/status.hpp
/tests/unit/core_primitives_test.cpp

필수 interface:

namespace fesa::core {

struct NodeId { int value; };
struct ElementId { int value; };
struct MaterialId { int value; };
struct PropertyId { int value; };
struct StepId { int value; };

enum class Severity { info, warning, error };

struct Diagnostic {
    Severity severity;
    std::string code;
    std::string message;
};

class Status {
public:
    static Status ok();
    static Status failure(Diagnostic diagnostic);

    bool is_ok() const;
    const std::vector<Diagnostic>& diagnostics() const;
    void add(Diagnostic diagnostic);
};

} // namespace fesa::core

구현 규칙:

모든 ID type은 strong typedef 역할을 하며 서로 암시적으로 대체되지 않아야 한다.
ID에는 equation id 또는 DOF numbering 정보를 넣지 않는다.
Status::ok()는 diagnostics가 비어 있고 is_ok() == true여야 한다.
Status::failure(...)는 최소 하나의 diagnostic을 포함하고 is_ok() == false여야 한다.
외부 라이브러리에 의존하지 않는다.

Tests To Write First

/tests/unit/core_primitives_test.cpp
- NodeId{1}과 ElementId{1}이 서로 다른 타입임을 compile-time으로 확인한다.
- Status::ok().is_ok()가 true임을 확인한다.
- Status::failure(...)가 false이고 diagnostic code/message를 보존함을 확인한다.
- Status::add(...)로 warning을 추가해도 diagnostic 순서가 보존됨을 확인한다.

RED 확인:

테스트 파일을 먼저 작성한다.
python scripts/validate_workspace.py 또는 targeted CTest를 실행해 fesa/core/ids.hpp 등 missing include로 실패함을 확인한다.
그 뒤 production header를 작성한다.

Acceptance Criteria

python -m unittest discover -s scripts -p "test_*.py"
python scripts/validate_workspace.py
ctest --test-dir build/msvc-debug --output-on-failure -C Debug -R core_primitives_test

검증 절차

위 AC 커맨드를 실행한다.
아키텍처 체크리스트를 확인한다:
- core가 외부 라이브러리에 의존하지 않는가?
- ID type에 equation numbering을 저장하지 않는가?
- C++ production header 변경에 대응하는 test file이 있는가?
결과에 따라 phases/solver-core-skeleton/index.json의 step 1을 업데이트한다:
- 성공: "status": "completed", "summary": "Core ID, diagnostic, and status primitives added with tests"
- 3회 수정 시도 후 실패: "status": "error", "error_message": "구체적 에러 내용"
- 사용자 개입 필요: "status": "blocked", "blocked_reason": "구체적 사유" 후 중단

금지사항

Node, Element, Domain 같은 model class를 이 step에서 만들지 마라.
MKL, TBB, HDF5 API를 include하지 마라.
JavaScript/TypeScript/npm fallback을 추가하지 마라.

3.4 KiB Raw Permalink Blame History