add uncommitted files

2026-07-29 23:32:26 +09:00
parent fb0f8f39a0
commit f5379472ce
80 changed files with 7461 additions and 1 deletions
@@ -0,0 +1,74 @@
+# 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를 만든다.
+
+```cpp
+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
+
+```powershell
+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 정보로 보존한다.