버전

공식 릴리스는 감사자 준비 PDF 및 기계 판독 가능 산출물과 함께 게시된 고정 스냅샷입니다.

버전 이력

버전	날짜	릴리스 노트	PDF (EN)	PDF (JA)	산출물	체크섬
v0.0.2	2026-02-02	변경로그	trust_package.pdf	trust_package.ja.pdf	ZIP	SHA256
v0.0.1	2026-02-02	변경로그	trust_package.pdf	trust_package.ja.pdf	ZIP	SHA256

!!! note "데이터 소스" 이 버전 테이블은 GitHub Releases와 동기화됩니다. 각 릴리스 태그(vX.Y.Z)는 사양의 고정 스냅샷에 해당합니다.

"latest"의 단일 정보원(SSOT)

"latest"의 권위 있는 정의는 GitHub Releases의 latest 태그(releases/latest)입니다. 사이트 경로 /latest/는 항상 해당 릴리스로 리디렉션됩니다. 별도의 "사이트 latest"는 없으며, 릴리스 워크플로우가 태그된 버전을 배포하고 한 단계로 latest 별칭을 설정합니다.

소스	역할
GitHub Release latest 태그	SSOT — "현재 릴리스"의 유일한 정의
버전 테이블 (이 페이지)	릴리스 워크플로우를 통해 릴리스와 동기화; 배포 전 태그와 일치해야 함
Changelog	규범적 변경 이력; 릴리스 노트가 참조
사이트 `/latest/`	GitHub Release latest와 동일한 버전으로 리디렉션

릴리스 프로세스 세부사항은 VERSIONING.md 및 릴리스 워크플로우를 참조하세요. 버전 테이블과 Changelog는 릴리스 준비의 일부로 업데이트되어 배포된 버전과 항상 일치합니다.

감사인용: 표준 URL 및 버전 고정

감사 보고서에서 특정 버전을 인용하고 재현 가능성을 보장하려면:

표준 URL: 해당 버전의 고정 문서 URL 사용, 예: https://standard.aimoaas.com/0.0.3/ (사용한 버전으로 0.0.3 교체).
버전 고정: GitHub Release 페이지의 릴리스 태그(예: v0.0.3) 및 선택적으로 커밋 해시를 기록합니다. 이를 통해 사양 스냅샷이 릴리스 자산(PDF, ZIP, 체크섬)과 일치함을 독립적으로 검증할 수 있습니다.
증거 정렬: 제출 시 evidence bundle이 정렬된 AIMO Standard 버전(예: v0.0.3)을 명시하고, 해당 릴리스에서 검증기와 스키마를 획득하세요.

버전 계층

AIMO Standard는 세 가지 버전 개념을 사용합니다. 현재 릴리스에서는 일치하며, 향후 릴리스에서는 독립적으로 버전 관리될 수 있습니다.

계층	설명	표시 위치
Standard 버전 (사이트/릴리스)	릴리스 태그 및 문서 스냅샷(예: `v0.0.3`).	버전 테이블, GitHub Releases, `/X.Y.Z/` URL.
Taxonomy 스키마 버전	코드 시스템 및 taxonomy/스키마 정의의 버전.	매니페스트의 `taxonomy_version`; 스키마 `$id` 또는 문서.
Dictionary 콘텐츠 버전	사전 항목(코드 및 정의)의 버전.	사전 메타데이터; 0.0.x에서는 taxonomy와 동일.

"AIMO Standard vX.Y.Z"를 인용할 때 Standard 버전이 표준 스냅샷을 정의합니다. Validator 및 Minimum Evidence Requirements는 해당 릴리스의 산출물과 스키마를 참조합니다.

검증 절차

감사자 및 구현자는 SHA-256 체크섬을 사용하여 다운로드 무결성을 확인해야 합니다:

1. 릴리스 자산 다운로드

=== "Linux / macOS"

```bash
# 특정 버전의 모든 자산 다운로드
VERSION=v0.0.1
BASE_URL="https://github.com/billyrise/aimo-standard/releases/download/${VERSION}"

curl -LO "${BASE_URL}/trust_package.pdf"
curl -LO "${BASE_URL}/trust_package.ja.pdf"
curl -LO "${BASE_URL}/aimo-standard-artifacts.zip"
curl -LO "${BASE_URL}/SHA256SUMS.txt"
```

=== "Windows (PowerShell)"

```powershell
# 특정 버전의 모든 자산 다운로드
$VERSION = "v0.0.1"
$BASE_URL = "https://github.com/billyrise/aimo-standard/releases/download/$VERSION"

Invoke-WebRequest -Uri "$BASE_URL/trust_package.pdf" -OutFile trust_package.pdf
Invoke-WebRequest -Uri "$BASE_URL/trust_package.ja.pdf" -OutFile trust_package.ja.pdf
Invoke-WebRequest -Uri "$BASE_URL/aimo-standard-artifacts.zip" -OutFile aimo-standard-artifacts.zip
Invoke-WebRequest -Uri "$BASE_URL/SHA256SUMS.txt" -OutFile SHA256SUMS.txt
```

2. 체크섬 확인

=== "Linux"

```bash
# 다운로드된 모든 파일을 체크섬과 비교하여 확인
sha256sum -c SHA256SUMS.txt

# 예상 출력 (모두 "OK" 표시):
# trust_package.pdf: OK
# trust_package.ja.pdf: OK
# aimo-standard-artifacts.zip: OK
```

=== "macOS"

```bash
# 다운로드된 모든 파일을 체크섬과 비교하여 확인
shasum -a 256 -c SHA256SUMS.txt

# 예상 출력 (모두 "OK" 표시):
# trust_package.pdf: OK
# trust_package.ja.pdf: OK
# aimo-standard-artifacts.zip: OK
```

=== "Windows (PowerShell)"

```powershell
# 각 파일 확인
Get-FileHash .\trust_package.pdf -Algorithm SHA256
Get-FileHash .\trust_package.ja.pdf -Algorithm SHA256
Get-FileHash .\aimo-standard-artifacts.zip -Algorithm SHA256

# 해시 출력을 SHA256SUMS.txt와 비교
Get-Content .\SHA256SUMS.txt
```

3. 수동 확인 (대안)

=== "Linux"

```bash
# 특정 파일의 해시 계산
sha256sum trust_package.pdf

# 출력을 SHA256SUMS.txt와 비교
cat SHA256SUMS.txt
```

=== "macOS"

```bash
# 특정 파일의 해시 계산
shasum -a 256 trust_package.pdf

# 출력을 SHA256SUMS.txt와 비교
cat SHA256SUMS.txt
```

=== "Windows (PowerShell)"

```powershell
# 특정 파일의 해시 계산
Get-FileHash .\trust_package.pdf -Algorithm SHA256

# 체크섬 파일 보기
Get-Content .\SHA256SUMS.txt
```

!!! tip "감사자용" 항상 제출 당사자가 아닌 공식 GitHub 릴리스에서 직접 체크섬 파일을 획득하세요. 이것은 독립적인 검증을 보장합니다.

4. 빌드 출처 확인 (증명)

모든 릴리스 자산에는 GitHub Actions에서 생성된 암호화 서명된 빌드 출처 증명이 포함됩니다. 이를 통해 자산이 변조 없이 공식 저장소에서 빌드되었는지 확인할 수 있습니다.

전제 조건: GitHub CLI (gh) 설치

# GitHub CLI를 사용하여 릴리스 자산 다운로드
VERSION=v0.0.1
gh release download "$VERSION" --repo billyrise/aimo-standard

# 각 자산에 대한 증명 확인
gh attestation verify trust_package.pdf --repo billyrise/aimo-standard
gh attestation verify trust_package.ja.pdf --repo billyrise/aimo-standard
gh attestation verify aimo-standard-artifacts.zip --repo billyrise/aimo-standard
gh attestation verify SHA256SUMS.txt --repo billyrise/aimo-standard

예상 출력 (성공):

Loaded digest sha256:abc123... for file trust_package.pdf
Loaded 1 attestation from GitHub API
✓ Verification succeeded!

오프라인 확인 (에어갭 환경):

# 먼저 신뢰할 수 있는 루트 다운로드 (한 번 네트워크 필요)
gh attestation trusted-root > trusted-root.jsonl

# 그런 다음 오프라인으로 확인
gh attestation verify trust_package.pdf \
  --repo billyrise/aimo-standard \
  --custom-trusted-root trusted-root.jsonl

!!! info "증명이 증명하는 것" 빌드 출처 증명은 릴리스 자산이 다음임을 암호화로 증명합니다:

1. 개발자의 로컬 머신이 아닌 GitHub Actions에서 빌드됨
2. 공식 `billyrise/aimo-standard` 저장소에서 빌드됨
3. 릴리스 태그와 연결된 정확한 커밋에서 빌드됨
4. 빌드 완료 후 수정되지 않음

호환성

AIMO 표준은 시맨틱 버전 관리 (SemVer)를 따릅니다:

변경 유형	버전 범프	영향
MAJOR	X.0.0	호환성 깨는 변경 — 마이그레이션 필요
MINOR	0.X.0	이전 호환 추가
PATCH	0.0.X	수정 및 명확화

완전한 버전 관리 정책은 VERSIONING.md를 참조하세요.

마이그레이션

호환성 깨는 변경이 있는 버전 간 업그레이드 시:

변경로그에서 호환성 깨는 변경 확인
특정 업그레이드 경로에 대해 마이그레이션 가이드 검토
새 스키마 요구사항에 맞게 증거 번들 업데이트
컴플라이언스 확인을 위해 검증기 재실행

!!! warning "호환성 깨는 변경" MAJOR 버전 업데이트는 기존 증거 번들에 대한 변경이 필요할 수 있습니다. 업그레이드 전에 항상 마이그레이션 가이드를 검토하세요.

버전화된 문서 스냅샷

각 릴리스는 다음에서 접근 가능한 고정 문서 스냅샷을 생성합니다:

프로덕션: https://standard.aimoaas.com/{version}/ (예: /0.0.1/)
GitHub Pages: https://billyrise.github.io/aimo-standard/{version}/

URL 유형 및 의미

URL 패턴	설명	감사 인용용?
`/X.Y.Z/` (예: `/0.0.1/`)	고정 릴리스 — 불변 스냅샷	예 (선호)
`/latest/`	별칭 — 가장 최근 릴리스로 리디렉션	예 (`/X.Y.Z/`로 해결)
`/dev/`	미리보기 — 릴리스되지 않은 main 브랜치 콘텐츠	아니요 (인용용 아님)

!!! warning "/latest/ vs /dev/ 이해" - /latest/는 가장 최근 릴리스된 버전으로의 별칭(리디렉션)입니다. 고정 스냅샷으로 해결되므로 인용에 안전합니다. - /dev/는 현재 main 브랜치를 반영하며 릴리스되지 않은 변경을 포함할 수 있습니다. 감사 보고서에서 /dev/를 절대 인용하지 마세요.

FAQ

??? question "왜 /latest/가 버전 번호가 아닌가요?" /latest/는 항상 가장 최근 안정 릴리스(예: /0.0.1/)로 리디렉션하는 편의 별칭입니다. 이를 통해 사용자는 자동으로 현재 버전을 받으면서 단일 URL을 북마크할 수 있습니다. 불변성이 필요한 공식 감사의 경우 대신 명시적 버전 URL을 인용하세요.

??? question "감사자는 어떤 URL을 인용해야 하나요?" - 공식 감사 (불변성 필요): /X.Y.Z/ 사용 (예: https://standard.aimoaas.com/0.0.1/standard/current/) - 일반 참조: /latest/는 현재 릴리스로 리디렉션되므로 허용 가능 - 절대 인용하지 마세요: /dev/ (릴리스되지 않음, 변경될 수 있음)

??? question "/latest/가 예상과 다른 콘텐츠를 표시하면?" 이것은 배포 버그입니다. /latest/가 가장 최근 GitHub 릴리스와 다르다고 의심되면 이슈를 보고해 주세요. /latest/ 별칭은 항상 가장 최근 태그된 릴리스로 리디렉션되어야 합니다.

리소스

릴리스 허브 — 제출 준비, 감사자 검증, 과대 주장 금지 선언
신뢰 패키지 — 감사자 준비 보증 자료
변경로그 (상세) — 폐기 추적이 있는 전체 변경 이력
VERSIONING.md — 완전한 버전 관리 정책

버전

최신 릴리스

버전 이력

"latest"의 단일 정보원(SSOT)

감사인용: 표준 URL 및 버전 고정

버전 계층

검증 절차

1. 릴리스 자산 다운로드

2. 체크섬 확인

3. 수동 확인 (대안)

4. 빌드 출처 확인 (증명)

호환성

마이그레이션

버전화된 문서 스냅샷

URL 유형 및 의미

FAQ

리소스