DongHyeonkaandClaude Opus 5
bed1fd933f
겹침 검사기의 적용 범위를 적는다 — 판정에 쓰는 것은 <rect> 뿐이라 techviz 가 만든 SVG 에서만 유효하다. 손댄 SVG 는 배경 사각형이 안 따라 바뀌어 겹침이 있어도 없다고 답한다. 그리고 관문의 종료 코드를 셋으로 가른다. 「대상이 성립하지 않는다」를 exit 2 로 두어 오타 한 번에 관문이 조용히 무효가 되는 것을 막는다. __pycache__ 는 .gitignore 에 이미 있는데 이 .pyc 하나만 추적되고 있어 두 세션의 작업 트리를 계속 더럽혔다. 추적에서 뺀다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GksxvQvM6A85xy8viYtWk6
Terminal Evidence Renderer
실제 명령 출력 원문을 보존한 뒤, 그 원문을 terminal UI 형태의 SVG로 렌더링한다.
Evidence rule
SVG가 정본이 아니다. 실행한 명령의 raw output과 metadata가 정본이고 SVG는 문서에 넣기 위한 표현이다.
command execution
├── raw/<name>.txt # stdout/stderr 원문
├── meta/<name>.json # command, cwd, executedAt, exitCode, revision
└── terminal/<name>.svg # raw에서 생성
시각화 단계에서는 Authorization Bearer, Cookie, token/password/client_secret/API key 형태의 값을 [REDACTED]로 치환한다. 그래도 raw 파일에 secret이 들어간 채 보관하면 안 된다. 명령 자체를 secret이 출력되지 않도록 구성하고, raw 저장 전에도 검사한다.
Render
python3 /shared/Tech-Log-Document/tools/terminal-evidence/render_terminal.py \
evidence/raw/gradle-test.txt \
evidence/terminal/gradle-test.svg \
--command './gradlew test' \
--cwd '/shared/codebase/my-project' \
--exit-code 0 \
--executed-at '2026-08-28T15:00:00+09:00'
Capture pattern
Agent가 명령을 실제로 실행할 때 stdout/stderr, exit code, 실행 시간, cwd를 함께 기록한다. 실패 명령도 Evidence가 될 수 있으므로 exit code를 버리지 않는다.
예시 shell pattern:
set +e
executed_at=$(date --iso-8601=seconds)
pwd_value=$(pwd)
./gradlew test > evidence/raw/gradle-test.txt 2>&1
exit_code=$?
set -e
그 뒤 metadata JSON을 쓰고 renderer를 호출한다. command에 credential을 직접 넣지 않는다.
Tests
python3 -m unittest discover -s tests -v