HMDesign Gitea 이전 전 최종 정합성 확인

RESULT: PARTIAL. 최근 구현·문서·Story·Guard의 정합성을 확인하고 현재 기준과 충돌하는 문서 설명을 최소 수정했다. 최종 타입 검사와 앱 build, 실행기 모의검사, 소스 무결성 확인은 PASS다. 기존 T03 생성·CSS 디자인 의도·개발 의존성 위험·실제 SR/터치와 공식 사내 환경의 미검증은 그대로 남긴다. 디자인 변경 없이 소스 이전 준비를 마쳤으며 공식 Gitea 이전은 2026-10-12 별도 작업이다.

TARGET: D:/디자인시스템/hmdesign. 범위는 기존 React Component/Pattern/Storybook/AI 계약의 정합성 확인이며 신규 업무 화면 구현은 없다. 시작 Local HEAD와 GitHub main은 모두 4fe549da01683c363b0715aedeb82a089717f685, branch main, working tree CLEAN이었다. 최종 문서 commit SHA와 원격 일치는 종료 보고 및 로컬 _local/finalization-20261011/release-manifest.json에 기록한다. 이전 보고서의 SHA를 최신으로 가정하지 않았다.

T03 실행기 원인과 보완

원본 근거는 독립 실험 codex-only-20261010-203444/t03-resume-20261011-001217/FINAL_REPORT.md, Medium item_3, High item_2 및 medium-stop-diagnosis.json이다. 원 생성 기준은 frozen f78cc206a5a9af6b61c42cfb989ed26fbe9da948이며 최신 HMDesign HEAD와 혼용하지 않는다.

대상	원인과 판정	이번 처리
Medium T03	Get-Content·Story 목록·브라우저 도구 검색 복합 명령. 실제 분리 결과 0/0/1, 마지막 stdout/stderr 빈 값. 기존 실행기의 좁은 예외 문법이 PROJECT_COMMAND_FAILURE로 중단	명령별 구조화 exit/stdout/stderr를 확인하는 V3 후보. 원문과 모든 step의 대응·출력/종료 일치 필수. 근거 없는 복합 exit1은 계속 STOP
High T03	사본에 `.storybook`이 없는데 검색 root에 포함. 후속 명령으로 wrapper exit0이어도 실제 rg 읽기 오류 발생	실제 경로 목록 기반 preflight. 대표 Story 소스·필수 문서/패키지/bootstrap은 필수, Storybook 실행을 요청하지 않은 `.storybook` 설정은 선택. 실제 읽기 오류는 계속 STOP

로컬 21/21 검사에서 실제 Medium 명령을 읽기 전용으로 재생해 0/0/1을 확인했다. High 원본 이벤트는 ACTUAL_RG_READ_ERROR_EVEN_IF_WRAPPER_EXIT_ZERO로 유지한다. 앞선 실패·stderr·exit2·누락/변조된 step·wrapper 불일치·파이프/치환/실행 옵션·중복 이벤트·실패 후 정지를 확인했다. 기존 22/22와 16/16 proof는 원래 controller SHA 70b35c127b14c2f97fd9df330783dd15b86f363f5238f743813995a3f27047f7 및 proof 해시가 같은 범위에서 REUSED PASS다.

수정 후보와 읽기 결과 수집기·preflight·테스트/proof는 독립 실험 finalization-20261011/runner/에 별도로 저장했다. active controller/launcher·과거 proof·승인·STOP·장부는 덮어쓰지 않았다. 실제 모델 launcher에 V3를 연결해 실행한 결과는 NOT VERIFIED다. 향후에는 별도 승인과 새 proof/입력/참조 manifest로 실행하거나, 구조화 결과가 없는 CLI에서는 읽기·각 검색을 별도 호출한다. 기존 승인 12/12 사용·잔여 0, NEW_MODEL_CALLS 0, T03_GENERATION/QUALITY NOT VERIFIED를 보존한다.

문서와 구현 정합성

연결	실제 확인과 결과
AGENTS → AI 계약 → Reference	규칙 우선순위·공개 API·Pattern 우선·Label·Navigation·Runtime/스타일 판정 일치. AGENTS 자체 수정 없음. 독립 사본의 필수/선택 참조와 검색 결과 계약 보완
Component MD ↔ 구현 ↔ Story	최근 Combobox dialog popup, GNBUser/LNBProfile 이름+description과 명시 label 우선권이 일치. Label/Badge 및 관련 공개 API 예제도 누락 없음. 정상 Props/Variant/Size/State/API 수정 없음
Pattern MD ↔ 구현 ↔ Story	FilterBar `layout` 3종·draft/applied·부모 초기화·보호 상태·focus, DataTable ID 줄바꿈 예제, PageHeader/Tabs, Form composition, GNB/LNB 모바일, Dashboard 48px/960px 계약 확인
Theme/Token	실제 공개 CSS 선언 1,170개, source exports Component 222/Pattern 63, runtime exports UI 255/Theme 8/CENTER 25/Reference 10. JSON key와 CSS 선언 수를 혼용하지 않음
Guard ↔ 가이드	FULL_SCREEN/PARTIAL scope와 STORYBOOK profile, result의 Production 제한, CSS Intent·유한 동적 후보·외부 host 변수·위치별 Runtime 증거·원본 보존 계약을 구현과 대조
README	현재 실행 scripts/Node 조건/6024·workspace build·React bootstrap 확인. 최신 Guard/접근성/최종 준비 문서 연결
문서 링크	최종 수정·신규 문서와 직접 참조 문서의 내부 경로/heading을 선택 검사. 당시 과거 보고서는 편집하지 않음

확인된 수정은 다음과 같다. 실제 정상 구현을 오래된 문서에 맞추지 않았다.

Reference의 “현재 최신 포터블 ZIP” 안내를 현재 Git checkout 기준으로 정정하고 ZIP은 과거 스냅샷으로 구분.
Guard의 과거 46/63/11개를 현재 수처럼 안내한 문장을 당시 기록으로 명시. 현재 75/20/5로 구분.
Guard 앞부분의 계산된 Token 일괄 미검증·non-HM 변수 검사 제외 설명을 실제 유한 후보/외부 host 변수 검사와 일치시킴.
STORYBOOK은 profile이라는 CLI 계약, 독립 실험의 선택 .storybook과 명령별 결과 확인을 보강.
README의 최신 검증 근거 연결과 10월 12일 이전 준비·595개 전체 소스 목록 작성.

기존 구현 보존

이번 diff의 packages/, src/, .storybook/, themes/, scripts/, package/lock, AGENTS 변경은 0이다. 원본 추적 파일 592개 해시에서 기존 문서 4개만 수정했다. 실행기 수정은 독립 실험의 새 폴더에만 저장했다.

D-01/D-02 Tabs/대표 Fill·PageHeader 조합은 기존 퍼블리셔 기준과 동일하다. padding: 24px 0, Primary White alpha 0.8, Secondary/Legacy 보존. 퍼블리셔 Button/Table/Progress/Accordion/Sheet/Drawer/Navigation·Foundation·React C2~R3는 관련 구현/API·CSS의 변경 영향을 비교해 이전 PASS를 재사용한다. Sheet 최종 radius·색 의미 등 미확정 값은 확정하지 않았다.

Green LNB 2Depth와 오른쪽 LNB 예제는 기존 lnb.css의 Black 8%를 소비한다. Storybook 왼쪽 목차는 manager.css의 별도 rgba alpha .08이다. 선택 깊이의 Black 20%는 그룹 배경과 별개다. 이 mapping과 선택/Hover/Focus 소스는 미변경이다. 기존 292개 Story ID는 inventory와 최종 static index가 일치한다.

선택 회귀와 재사용

검사	판정과 유효 범위
TYPECHECK	EXECUTED PASS, root/UI/CENTER. Theme default 확인·workspace build hook 포함
BUILD	EXECUTED PASS, 최종 root build. 이미 성공한 hook는 `--ignore-scripts`로 중복 생략. 500kB chunk 경고 유지
실행기	EXECUTED 21/21 PASS, 모델 호출 없음. 기존 22+16은 원래 V2 해시 범위에서 REUSED PASS
CSS_IMPORTS/EXPORTS	EXECUTED PASS, 추적 CSS import 73개·export artifact 16개 누락 0. 관련 8개 MD 공개 import 심볼 누락 0
Guard100	REUSED PASS, 8817135 이후 Guard/회귀 소스·package/lock 미변경 및 기존 final 로그 100/100 확인. 최신 선택 Story Guard source/contract 해시 일치
Component	REUSED PASS, 기존 C2~R3 및 FilterBar 검증의 소스/영향 대조. 최신 Combobox 1개·최종 GNB/LNB 2개 렌더 회귀를 각각 재사용
관련 Story/반응형	REUSED PASS, 최신 static 선택 6/6·pageerror 0, Combobox 390/768/1280/1440, 사용자 메뉴와 모바일 navigation 명명된 기존 검사. 미변경 대표/Theme 범위만 이전 결과 재사용
Storybook build	REUSED PASS, 최신 접근성 최종 build·source/환경 동일. index 292개 ID 일치. 전체 292 Runtime을 새로 수행한 것으로 집계하지 않음
Theme	REUSED PASS, JSON/Runtime/Designer·미변경 CSS의 기존 119/96·키보드 138/58 근거. 새 Theme/상태 전수 인증 없음
공통80	REUSED PASS 역사적 frozen f78cc206 한정. 원 log/exit 및 baseline 기록 유지. 최신 HEAD 전체 검증으로 확대하지 않음
기존 AI 화면	앱 source 및 당시 Guard/Runtime 연결이 같은 범위만 재사용. 옛 T01 contract는 최신 4fe와 달라 최신 결합 PASS로 승격하지 않음. T06 원본 FAIL과 수정 복제본 PASS 구분

기존 최종 선택 Story Guard는 원본 status/staticStatus NOT VERIFIED, FAIL 0이다. CSS styleEvidence는 STATIC PASS / RUNTIME NOT VERIFIED / DESIGN_INTENT NOT VERIFIED / FINAL NOT VERIFIED, styleVerification은 생성하지 않았다. 브라우저 동작 PASS를 스타일 승인으로 연결하지 않는다. T01 당시 112개 CSS 측정 PASS도 해당 source/옛 contract의 역사적 결과이며 사용자 디자인 의도는 계속 NOT VERIFIED다.

SKIPPED_DUPLICATES: 전체 292 Story Runtime, 정상 Component/Theme/Guard suite 재실행, 외부 모델·화면 재생성, 동일 반응형 재촬영, npm 재설치/audit, 정상 package hook 중복. 현재 수정이 문서와 독립 실행기 후보라 새 시각 영향을 만들지 않았다.

보안과 소스 이전 한계

과거 감사는 개발 High 7·Critical 0, 운영 0이다. package/lock은 감사 기준 이후 같다. shadcn → registry/ts-morph/common/fast-glob → micromatch → braces 전파를 유지하며 안전한 patch 미확인이다. 새로운 audit/레지스트리 조회/업데이트는 실행하지 않았다. STORYBOOK의 비신뢰 glob/config 제한을 유지한다. 운영 0은 과거 감사 기준이며 현재 인터넷 advisory의 갱신 부재를 인증하지 않는다.

추적 파일명/고신뢰 secret 패턴에서 개인 환경·key·생성 dist·실험/임시파일 후보는 발견되지 않았다. 비밀정보 부재의 전수 인증은 아니다. 제품 manifest의 로컬 절대경로 의존성은 없다. audit-quality-contracts.mjs의 역사 비교 BASE와 외부 증거 절대경로 2개는 이관 후 그대로 실행 가능한 필수 검증 도구가 아니며 준비 문서에 제외/대체 조건을 명시했다.

남은 상태는 T03 생성/품질, CSS 사용자 의도·미실행 동적 분기, 확정색 접근성 대비 FAIL/DEFERRED, 실제 SR·실기기 touch/drag·확대·모든 Theme/브라우저, 공식 Gitea 전용 파일/분기·회사 실행 환경 NOT VERIFIED다. 현재 발견은 디자인/정상 API를 변경할 근거로 확대하지 않는다.

이전 준비 문서는 공식 기존 이력을 보존한 추적 소스 비교·반영, 공식 전용 파일 보존, 설치/검증 명령, 이후 GitHub remote의 정확한 URL을 확인한 해제 순서를 제공한다. GitHub 일반 main push 결과는 작업 종료 보고에 기록한다. 공식 Gitea ACCESS/CLONE/COMMIT/PUSH/연결 전환, force/reset/clean/이력 삭제, GitHub 연결 해제, ZIP 배포 모두 NOT EXECUTED다.

로컬 상세 근거는 _local/finalization-20261011/의 baseline/evidence-inspection/integrity/preservation/reuse-ledger/doc-links/release-manifest/FINAL_REPORT와 로그에 보관한다. 이 문서는 최종 commit의 자기 SHA를 포함하지 않으며 로컬 최종 보고와 실제 HEAD 조회로 연결한다.

11 KiB Raw Blame History