이 페이지는 영어 문서의 번역입니다. 명령, 식별자, 예제는 그대로입니다. 런타임 7.24.4 · SDK 2.6.7. 영어 원문

실행 증거

상태: 활성 범위: 현재 상태 최종 검토: 2026-08-25 담당: AX Code 런타임

모든 AX Code 세션은 실행되는 동안 기록됩니다. 이 페이지는 그 기록을 검토하고, 비교하고, 내보내고, 되돌리는 명령을 다룹니다.

에이전트가 끝난 뒤 무엇을 했는지, 얼마나 위험했는지, 다른 시도와 어떻게 달랐는지, 어떻게 되돌리는지를 답해야 할 때 사용합니다.

무엇이 기록되는가

실행 중에 AX Code는 서로 독립된 두 가지를 씁니다.

• 형식 있는 이벤트 로그 — 라우팅 결정, 모델 활동, 단계 경계, 도구 호출, 도구 결과입니다. graph, replay, compare, trace, audit의 원천입니다.
• 파일 스냅샷 — 저장소 밖, AX Code 데이터 디렉터리 아래의 Git 객체 저장소에 refs/snapshots/<hash>로 담깁니다. 작업 트리와 프로젝트의 .git/은 이것을 저장하려고 수정되지 않습니다.

둘 다 로컬입니다. 업로드되는 것은 없습니다.

실행을 다시 구성합니다

ax-code graph <sessionID>

세션을 실행 그래프로 다시 만듭니다. 지속 시간, 위험 요약, 토큰 수, 사용한 에이전트, 도구 호출과 시간이 있는 모든 단계입니다.

## Session ses_01H8XK

Duration: 9m 54s | Risk: HIGH (53/100) | Tokens: 167,650 in / 18,494 out
Agents: architect

### Step 1 (8s) | tokens: 12263/587

- read: api.ts → ok (5ms)
- grep: rateLimit → ok (12ms)

--format은 그래프를 다른 도구에서 보고 싶을 때 Mermaid와 위상 보기를 포함한 다른 출력을 고릅니다.

이것은 세션 실행 그래프입니다. 에이전트가 한 일입니다. 저장소 코드 그래프가 아닙니다. 코드 그래프는 ax-code index과 코드 인텔리전스 계층입니다.

두 실행을 비교합니다

ax-code session compare <sessionA> <sessionB>
ax-code session compare <sessionA> <sessionB> --deep

위험 차이, 바뀐 파일, 도구 실패 횟수, 각 실행이 택한 결정 경로, 이벤트 종류별 횟수를 보고합니다. --deep는 재생 비교를 통해 단계 수준의 분기 분석을 더합니다.

이것은 소스 코드가 아니라 실행을 비교합니다. “두 번째 시도의 점수가 더 나빴다. 어디서 갈라졌는가”에 답하며, “코드 diff를 보여 달라”에 답하지 않습니다.

같은 작업의 두 전략 중 고를 때의 전형적인 사용입니다.

  Risk Comparison
  ----------------------------------------
  Score: 53 → 93 (+40) ↑
  Level: HIGH → CRITICAL
  Files: 8 → 25
  Failures: 0 → 15

기록된 이벤트 로그를 살펴봅니다

ax-code session replay <sessionID> --mode summary
ax-code session replay <sessionID> --mode verify
ax-code session replay <sessionID> --mode reconstruct
ax-code session replay <sessionID> --mode export

verify은 기록된 로그의 일관성을 확인합니다. reconstruct은 이벤트에서 단계 스트림을 다시 만듭니다. export는 옮길 수 있는 재생 패키지를 씁니다.

재생은 다시 구성할 뿐, 다시 실행하지 않습니다. 모델을 다시 돌리거나, 도구를 다시 호출하거나, 외부 상태를 재현하지 않습니다. execute 모드는 원본과 프로그램으로 비교할 재구성 스트림을 준비하며, 작업을 다시 실행하는 것이 아니라 시험용입니다.

위험 신호를 읽습니다

ax-code risk <sessionID>
ax-code risk <sessionID> --explain
ax-code risk <sessionID> --json

점수는 기록된 신호에서 나온 결정적 휴리스틱입니다. 바뀐 파일 수, 변경이 여러 최상위 영역에 걸치는지, 실패한 도구 호출 수, 검증이 실행되었는지, diff 스냅샷이 있는지, 영향받은 API 표면의 크기, 실행이 어떻게 끝났는지(막힌 완료 관문이나 단계 한도/정체된 종료는 모두 가중치를 더함), 보안에 민감한 경로를 건드렸는지를 포함합니다. 기여하는 각 요인은 가중치와 제안된 완화와 함께 나열됩니다.

검토를 돕는 도구입니다. 확률도, 보정된 확신도, 코드가 안전하다는 진술도 아닙니다. 검증되지 않은 변경의 LOW 점수는 그 변경이 여전히 검증되지 않았다는 뜻입니다.

정확히 되돌립니다

파일 스냅샷은 Git이 설치되어 있고 snapshot가 켜져 있으면 Git 저장소와 일반 프로젝트 디렉터리에서 동작합니다. AX Code는 스냅샷 Git 저장소를 프로젝트 밖에 둡니다. 프로젝트 .git 디렉터리를 만들지 않습니다. 무시 규칙과 지원하지 않는 경로 제외는 계속 적용됩니다.

TUI Revert는 메시지와 캡처된 파일 변경을 되돌립니다. snapshot: false이 있거나, 기준선을 한 번도 캡처하지 않은 이전 턴에서는 메시지만 되돌릴 수 있습니다. 파일 편집은 디스크에 남습니다. 지금 스냅샷을 켜도 이전 파일 내용을 다시 구성할 수는 없습니다. 파일 변경이 없는 캡처된 턴도 복원할 것이 없습니다.

ax-code session rollback <sessionID> --list      # show recoverable points
ax-code session rollback <sessionID> --dry-run   # show what would change
ax-code session rollback <sessionID> --step 4    # restore one step
ax-code session rollback <sessionID>             # restore the whole session

--list은 지속되는 단계 이벤트와 실행 그래프 세부 정보를 합치므로, 실행 전체를 되돌리는 대신 특정 단계를 겨냥할 수 있습니다. --dry-run은 적용과 같은 롤백 계획기를 사용하며, 파일 원장이 결과에 기여하는 위임된 세션을 나열합니다.

롤백은 중첩된 자식 세션이 부모의 정확한 작업 디렉터리에 썼을 때 그 세션을 따라갑니다. 경계 이후의 파일 변경을 복원하고 대화 기록은 유지합니다. 다른 작업 트리나 디렉터리에서 실행 중인 후손은 제외되며, 포함된 세션이 아직 실행 중이면 롤백은 진행하지 않고 실패합니다.

의존하기 전에 알아 둘 경계: 롤백은 실행 중에 찍은 스냅샷에서 복원합니다. 세션 밖에서 바뀌었거나 복원 가능한 상태가 아니어서 스냅샷되지 않은 파일은 이 방법으로 복원할 수 없습니다. 중요한 것에는 먼저 --dry-run를 사용합니다.

다른 전략을 시도합니다

ax-code session branch <sessionID>
ax-code session branch <sessionID> --from <messageID>

세션의 저장된 상태를 갈라, 두 번째 시도가 처음부터가 아니라 고른 지점에서 시작하게 합니다.

이것은 세션 상태, 즉 메시지와 목표를 가릅니다. Git 브랜치도 작업 트리도 아닙니다. 격리된 Git 후보는 검증된 다중 모델 변경을 보십시오.

진단

ax-code session trace <sessionID>
ax-code session trace <sessionID> --logs

위험이 점수화된 타임라인이 있는, 재생에 기반한 진단입니다. --logs은 재생 이벤트 대신 이전 로그 파일 분석으로 바꿉니다. 변경을 검토하는 것이 아니라 운영 문제를 조사할 때 유용합니다.

증거를 내보냅니다

ax-code audit export --all --since 2026-08-01     # JSON Lines
ax-code audit export --all --risk HIGH            # filter by minimum risk
ax-code audit report <sessionID>                  # Markdown report
ax-code audit otlp <sessionID>                    # OpenTelemetry spans
ax-code audit prune --days 90                     # delete old events

JSONL과 OTLP는 실행 기록을 자신의 검토나 관측 파이프라인이 소비할 수 있게 합니다. Markdown 보고서는 사람이 PR이나 변경 기록에 증거를 붙일 때 씁니다.

둘러봅니다

ax-code run-report                 # latest session
ax-code run-report --index         # session index

로컬 실행 보고서를 브라우저에서 엽니다. 실행 요약, 타임라인, 변경, 검증 상태, 위험 세부 정보, 브랜치 정보, 롤백 지점이 있습니다. 서버는 루프백에만 바인딩됩니다.

관련 문서

• 목표 보증 — 긴 목표를 위한 실행 가능한 수용 검사와 소스 신선도
• AX Code를 쓰는 이유 — 이 증거 계층의 목적
• 검증된 다중 모델 변경 — 비교할 가치가 있는 후보 만들기
• 의미 계층 — 그래프와 LSP 답변의 출처 봉투
• 실행 보고서 — 작업 공간 수준의 보기와 세션별 보고서