Asc Whats New Writer

asc What's New Writer

Generate engaging, localized release notes from flexible input. Optionally pair with promotional text updates.

Preconditions

• Metadata pulled locally into canonical files via asc metadata pull --app "APP_ID" --version "1.2.3" --dir "./metadata". OR: user provides keywords manually.
• Auth configured for upload (asc auth login or ASC_* env vars).
• The primary locale is en-US unless the user specifies otherwise.

Before You Start

1. Read references/release_notes_guidelines.md for tone, structure, and examples.
2. Identify the latest version directory under metadata/version/ (highest semver). Use this for all metadata reads.
3. Enumerate existing locales by listing the JSON files in that version directory.

Phase 1: Gather Input

Accept one of three input modes (auto-detect):

Git Log

Parse commits since the last tag:

# Find latest tag
git describe --tags --abbrev=0

# List commits since that tag
git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges

Filter out noise: merge commits, dependency bumps, CI changes, formatting-only commits. Extract user-facing changes.

Bullet Points