FESA/phases/domain-and-input-skeleton/step2.md

Step 2: Abaqus Scoped Syntax Parser

읽어야 할 파일

• /AGENTS.md
• /docs/PRD.md
• /docs/ARCHITECTURE.md
• /docs/ADR.md
• /docs/superpowers/specs/2026-07-29-abaqus-assembly-reference-design.md
• /docs/superpowers/plans/2026-07-29-fesa-phase-1.md
• /include/fesa/core/source_location.hpp
• /include/fesa/core/diagnostic.hpp

작업

Abaqus keyword를 해석하지 않고 scope가 보존된 syntax tree로 읽는 parser를 만든다.

struct DeckRecord final {
    std::string keyword;
    std::map<std::string, std::string, std::less<>> parameters;
    std::vector<std::vector<std::string>> data;
    SourceLocation source;
};
struct ParsedPart final {
    std::string name;
    std::vector<DeckRecord> records;
    SourceLocation source;
};
struct ParsedInstance final {
    std::string name;
    std::string part_name;
    std::vector<std::vector<std::string>> transform_data;
    SourceLocation source;
};
struct ParsedAssembly final {
    std::string name;
    std::vector<ParsedInstance> instances;
    std::vector<DeckRecord> records;
    SourceLocation source;
};
struct ParsedDeck final {
    std::vector<DeckRecord> global_records;
    std::vector<ParsedPart> parts;
    std::optional<ParsedAssembly> assembly;
};
[[nodiscard]] ParseDeckResult parse_deck(const std::filesystem::path&);

• flat fixture와 단일 Part/Assembly/Instance fixture를 먼저 만든다.
• case-insensitive keyword, comment, blank line, comma field, UTF-8, source line, scope 종료 오류를 테스트한다.
• 이 step은 syntax만 파싱하며 active Part를 선택하지 않는다.

Acceptance Criteria

cmake --build --preset windows-debug
ctest --preset windows-debug -R "AbaqusParser|ScopedDeck" --output-on-failure
ctest --preset windows-debug --output-on-failure

검증 절차

1. parser test를 작성하고 실패를 확인한다.
2. io/abaqus에 lexer/parser만 최소 구현한다.
3. source location과 scope tree를 assertion한다.
4. 전체 테스트 후 index를 갱신한다.

금지사항

• Domain을 생성하지 마라. 이유: 다음 semantic normalization step의 책임이다.
• unknown keyword를 일반적으로 무시하지 마라. 이유: 명시적 입력 계약을 훼손한다.
• Instance 변환을 적용하지 마라. 이유: Phase 1에서 거부할 syntax 정보로 보존한다.