# Release Artifact Policy

**Document type:** Release / Artifact Policy  
**Version:** 0.1.0  
**Status:** Draft  
**Language:** English  
**Product:** Chanora  
**Repo path:** `docs/release/release-artifact-policy.md`

---

## 1. Purpose

This document defines the expected release artifact metadata before a release is approved.

## 2. Required Artifact Metadata

| Field | Required |
|---|---|
| Release version | Yes |
| Build number | Yes |
| Git commit SHA | Yes |
| Git tag | Yes |
| Build timestamp | Yes |
| Build environment | Yes |
| Platform | Yes |
| Artifact filename | Yes |
| SHA-256 hash | Yes |
| Signing status | Required for public/store release |
| Notarization status | Required for macOS public release |
| Store upload status | Required for store release |

## 3. Artifact Types

| Platform | Expected artifact |
|---|---|
| Windows | Installer or packaged app artifact |
| macOS | Signed/notarized app bundle or installer |
| Linux | AppImage, Flatpak, deb, rpm, or selected package |
| Android | AAB/APK |
| iOS / iPadOS | App Store Connect/TestFlight upload artifact |

## 4. Rule

Release artifacts shall not be treated as approved until the Release Readiness / Go-No-Go record is completed.

## 5. Change History

| Version | Date | Description |
|---|---|---|
| 0.1.0 | 2026-05-14 | Initial release artifact policy. |
