Public Release Checklist

이 checklist는 private repository history 없이 깨끗한 Ghost-ALICE OS public repository snapshot을 준비한다.

Contents

• Release Goal
• Include
• Exclude
• Pre-Export Checks
• License And Provenance Gates
• Sensitive String Scan
• GitHub Community File Check
• Clean Export Procedure
• GitHub Repository Setup
• Public Smoke Test

Release Goal

local state, secrets, private addons, tenant content, private development artifacts는 제외하고 core Ghost-ALICE OS governance layer, public installer, public skills, public docs, validation scripts를 포함한 public repository snapshot을 만든다.

Include

• README.md
• README_ko.md
• LICENSE
• NOTICE
• THIRD_PARTY_NOTICES.md
• CONTRIBUTING.md
• SECURITY.md
• CODE_OF_CONDUCT.md
• SUPPORT.md
• CHANGELOG.md
• AGENTS.md, CLAUDE.md
• install.sh, install.ps1, install.cmd
• installer_lib/
• _shared/
• public skill directories
• skill-catalog/
• scripts/
• platforms/
• .claude/commands/
• docs/
• official-docs/
• public images under imgs/
• .github/

Exclude

• private development repo의 .git/ history
• .tmp/
• .worktrees/
• local install logs and reports
• ~/.ghost-alice/ runtime state
• ~/.agents/, ~/.claude/, ~/.codex/ installed copies
• .claude/settings.local.json
• .claude/settings.json
• ~/.ghost-alice/secrets.env
• private addons and tenant skills
• customer, grant, company, credential files
• generated caches such as __pycache__/
• local editor state

Pre-Export Checks

clean export를 만들기 전에 private working repo에서 실행한다.

git status --short
python3 scripts/validate_public_surfaces.py
python3 scripts/check_skill_gate_contract.py
python3 -m unittest discover -s _shared -p 'test_*.py'
python3 -m unittest discover -s scripts/tests -p 'test_*.py'

installer-heavy release에서는 다음도 실행한다.

python3 scripts/run_installer_compat_tests.py
python3 scripts/validate_platform_adapters.py

License And Provenance Gates

• LICENSE가 수정되지 않은 Apache License, Version 2.0 text인지 확인한다.
• README.md, README_ko.md, NOTICE, THIRD_PARTY_NOTICES.md가 project license boundary에 대해 일치하는지 확인한다.
• bundled third-party reference material이 포함되는 경우 source URL, license, copyright notice, local path가 있는지 확인한다.
• copied upstream documentation snapshots를 publish하지 않는다. short citations와 source locators가 있는 original project commentary만 둔다.
• contributor-facing file이 maintainers가 실제로 enforce하지 않는 CLA, DCO, inbound license rule을 암시하지 않는지 확인한다.

Sensitive String Scan

export 전에 obvious private material을 scan한다.

rg -n --hidden --glob '!/.git/**' --glob '!/.tmp/**' \
  'api[_-]?key|token|password|secret|private[_-]?key|BEGIN [A-Z ]*PRIVATE KEY|secrets.env|company-info-files|customer|grant'

hit를 수동 review한다. policy text와 secret helper documentation에는 일부 expected hit가 있을 수 있다.

GitHub Community File Check

• README.md, README_ko.md, LICENSE, CODE_OF_CONDUCT.md, CONTRIBUTING.md, SECURITY.md, SUPPORT.md, issue templates, pull request template이 있는지 확인한다.
• .github/CODEOWNERS는 real maintainer 또는 team이 생기기 전까지 없거나, write access가 있는 real GitHub users/teams만 포함해야 한다.
• 같은 workflow에 대한 duplicate issue template pair가 없는지 확인한다.
• security reports는 public issues가 아니라 SECURITY.md 또는 GitHub private vulnerability reporting으로 안내한다.

Clean Export Procedure

1. private repo 밖에 fresh directory를 만든다.
2. included paths만 복사한다.
3. export 안에서 pre-export checks를 실행한다.
4. 새 Git repository를 initialize한다.
5. clean snapshot을 initial public commit으로 commit한다.
6. public repository에 push한다.
7. GitHub community profile status를 확인한다.
8. public repository에서 CI가 pass하는지 확인한다.
9. real maintainers 또는 teams가 생긴 뒤 branch protection과 CODEOWNERS review settings를 확인한다.

GitHub Repository Setup

Enable 또는 configure:

• Private vulnerability reporting, if available
• Branch protection for the default branch
• Required CI checks
• Dependabot or equivalent dependency update automation, when package manifests are introduced
• OpenSSF Scorecard workflow, once the public repository is stable

Public Smoke Test

publication 이후 clean clone을 test한다.

git clone <public-repo-url> ghost-alice-public-smoke
cd ghost-alice-public-smoke
python3 scripts/validate_public_surfaces.py
bash install.sh --status

smoke test가 disposable account 또는 machine에서 의도적으로 실행되는 것이 아니라면 main development environment를 mutate하는 install commands를 실행하지 않는다.