← 전체 프로젝트
13

개발 도구 · 템플릿 실행

Source Materializer

Go로 템플릿 입력을 검사하고 생성 계획을 만든 뒤, 기존 파일을 덮어쓰지 않고 적용하는 도구입니다.

MAT-001/002 구현 · 경계 검토 진행
기간
2026 — 현재
역할
도구 개발

PROJECT / DECISION RECORD

문제에서 구현까지

  1. 01문제

    템플릿 작성 책임과 실제 파일 생성 실행 책임이 한 도구에 섞이면 안전한 적용이 어렵습니다.

  2. 02설계 선택

    템플릿 정의와 독립된 inspect → plan → apply 단계와 해시 기반 적용 계약을 사용합니다.

  3. 03구현·진행

    Go로 경로 검증, SHA-256 plan, 생성 전 확인, no-replace 쓰기와 부분 실패 영수증을 구현했습니다.

프로젝트 기록을 구조화한 요약 · 실제 서비스 화면이나 실행 검증 결과가 아닙니다.

문제

13

템플릿 작성 책임과 실제 파일 생성 실행 책임이 한 도구에 섞이면 안전한 적용이 어렵습니다.

Source Materializer / 파일 생성 처리

  1. 01 / 검사Inspect

    템플릿 경로와 입력 정의를 검증합니다.

  2. 02 / 계획Plan · SHA-256

    파일별 생성 계획과 해시를 고정합니다.

  3. 03 / 적용Apply · CREATE only

    재검증 후 기존 파일을 교체하지 않고 생성합니다.

MAT-001/002 소스 계약을 정리한 도식이며, 모든 파일시스템 경합의 해결을 의미하지 않습니다.

제약

  • 범위를 벗어난 경로, 기존 타깃 충돌, 입력 변경을 거절하며 프로젝트별 비즈니스 코드를 생성하지 않습니다.
  • 대상 경로 이탈, 중복 파일, 덮어쓰기 충돌이 있으면 적용하지 않습니다.
  • 적용 도중 실패했을 때의 처리 결과도 영수증으로 남겨야 합니다.

설계와 결정

  • 템플릿 정의와 독립된 inspect → plan → apply 단계와 해시 기반 적용 계약을 사용합니다.
  • 계획에 포함된 파일 내용의 SHA-256과 실제 입력이 맞는지 적용 직전에 다시 비교합니다.
  • 생성은 CREATE-only로 제한하고 원래 있던 파일을 교체하지 않습니다.

구현

  • Go로 경로 검증, SHA-256 plan, 생성 전 확인, no-replace 쓰기와 부분 실패 영수증을 구현했습니다.
  • apply 전 preflight에서 digest·source·target의 변경 여부를 검사합니다.
  • 임시 파일·해시 검증·fsync·권한 설정·no-replace 게시를 거쳐 적용하고, 부분 실패를 별도 상태로 기록합니다.

검증과 근거

소스 근거직접 확인

README의 MAT-001/002 구현 범위와 Go 1.25.12 모듈, plan/apply 계약을 확인했습니다.

결과와 현재 상태

MAT-001/002의 파일 생성·검증 기능을 구현했습니다. 파일시스템 경합 조건에 대한 추가 검토는 남아 있습니다.

현재 상태MAT-001/002 구현 · 경계 검토 진행

함께 보는 프로젝트