Auto-accumulated changelog for desktop releases

[m13v]

Summary

• Adds unreleased array to desktop/CHANGELOG.json for agents to append user-facing change descriptions as they work
• GitHub Actions workflow (desktop_auto_release.yml) now consolidates unreleased entries into a versioned release entry before creating the tag
• Falls back to "Bug fixes and improvements" if unreleased is empty
• Updated desktop/CLAUDE.md with changelog entry instructions for agents
• Updated release skill to reference auto-accumulated entries

How it works

1. Agents append one-liners to unreleased in CHANGELOG.json after completing desktop tasks
2. On merge to main, the auto-release workflow moves unreleased entries into releases[0] with version + date
3. Clears unreleased to [] and commits with [skip ci]
4. Creates and pushes the tag — Codemagic picks up releases[0] as before

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

Adds auto-accumulated changelog system for desktop releases and bundles in live 3D knowledge graph visualization during onboarding

Major Changes

• Changelog auto-accumulation: GitHub Actions workflow consolidates unreleased entries into versioned releases, agents append changes to desktop/CHANGELOG.json as they work
• Live knowledge graph during onboarding: Split-pane layout shows 3D graph building incrementally as AI discovers user information (MemoryGraphPage, OnboardingView, incremental graph updates)
• Onboarding improvements: Added "Why?" button for permissions, name confirmation step, comprehensive Omi feature descriptions in prompt, model switch from Opus to Sonnet
• Backend improvements: Auto-configures single_language_mode based on Deepgram multi-language support, WAL checkpoint before DB migration
• Developer tooling: New desktop/CLAUDE.md documentation, headless advice test runner, improved run scripts

Concerns

• Scope creep: PR title focuses on changelog but includes a major unrelated feature (knowledge graph) plus numerous other changes across 26 files (1057 insertions, 256 deletions)
• Workflow race condition: Concurrent merges could compute identical version numbers from the same base tag
• Missing error handling: Python script in workflow lacks error handling for malformed JSON

Confidence Score: 3/5

• Safe to merge with minor workflow robustness concerns, but PR scope exceeds stated purpose
• Score reflects scope creep (changelog + major knowledge graph feature bundled together), potential race condition in release workflow, and missing error handling in Python script. Individual code changes are well-implemented, but the PR bundles multiple unrelated features that should be separate.
• Pay close attention to .github/workflows/desktop_auto_release.yml (race condition, error handling) and verify the knowledge graph onboarding feature works correctly (major UX change)

Important Files Changed

Filename	Overview
.github/workflows/desktop_auto_release.yml	Adds Python script to consolidate unreleased changelog entries into versioned releases; potential race condition if multiple PRs merge simultaneously
desktop/CHANGELOG.json	Adds unreleased array with 3 entries for new onboarding features; also includes Unicode character normalization changes
desktop/CLAUDE.md	New comprehensive documentation file for desktop project with changelog entry instructions, build workflow, and debugging guides
desktop/.claude/skills/release/SKILL.md	Updated release skill to reference auto-accumulated changelog entries from unreleased array instead of manual entry creation
desktop/Desktop/Sources/Chat/ChatPrompts.swift	Major onboarding prompt overhaul: adds incremental knowledge graph building, "Why?" button for permissions, Omi features description, and privacy policy context
desktop/Desktop/Sources/MainWindow/Pages/MemoryGraph/MemoryGraphPage.swift	Adds addGraphFromStorage() method for incremental graph updates during onboarding with animated scene nodes and physics integration
desktop/Desktop/Sources/OnboardingView.swift	Adds split layout with live 3D knowledge graph pane alongside chat during onboarding; implements real-time graph updates
desktop/Backend-Rust/src/services/firestore.rs	Auto-configures single_language_mode based on Deepgram multi-language support when setting user language

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Agent completes desktop task] --> B{User-visible change?}
    B -->|Yes| C[Append to unreleased array in CHANGELOG.json]
    B -->|No| D[Skip changelog entry]
    C --> E[Commit changes]
    D --> E
    E --> F[Push to main branch]
    F --> G[GitHub Actions: desktop_auto_release.yml triggers]
    G --> H[Get latest v*-macos tag]
    H --> I[Compute next version<br/>increment patch]
    I --> J[Run Python script:<br/>consolidate changelog]
    J --> K{unreleased array empty?}
    K -->|Yes| L[Use default:<br/>Bug fixes and improvements]
    K -->|No| M[Use unreleased entries]
    L --> N[Create release entry with version + date]
    M --> N
    N --> O[Insert at releases start]
    O --> P[Clear unreleased to empty]
    P --> Q[Commit CHANGELOG.json<br/>with skip ci]
    Q --> R[Push to main]
    R --> S[Create and push git tag]
    S --> T[Codemagic builds release]

Loading

_{Last reviewed commit: 24208ae}

[greptile-apps]

_{26 files reviewed, 2 comments}

_{Edit Code Review Agent Settings | Greptile}

[greptile-apps]

Python script lacks error handling for malformed JSON or missing keys

Suggested change

	python3 -c "
	import json, sys
	with open('desktop/CHANGELOG.json', 'r') as f:
	data = json.load(f)
	unreleased = data.get('unreleased', [])
	if not unreleased:
	unreleased = ['Bug fixes and improvements']
	new_release = {
	'version': '$VERSION',
	'date': '$TODAY',
	'changes': unreleased
	}
	data.setdefault('releases', []).insert(0, new_release)
	data['unreleased'] = []
	with open('desktop/CHANGELOG.json', 'w') as f:
	json.dump(data, f, indent=2)
	f.write('\n')
	print(f'Consolidated {len(unreleased)} changelog entries for v$VERSION')
	"
	TODAY=$(date -u +%Y-%m-%d)
	python3 -c "
	import json, sys
	try:
	with open('desktop/CHANGELOG.json', 'r') as f:
	data = json.load(f)
	except (FileNotFoundError, json.JSONDecodeError) as e:
	print(f'Error reading CHANGELOG.json: {e}', file=sys.stderr)
	sys.exit(1)
	unreleased = data.get('unreleased', [])
	if not unreleased:
	unreleased = ['Bug fixes and improvements']
	new_release = {
	'version': '$VERSION',
	'date': '$TODAY',
	'changes': unreleased
	}
	data.setdefault('releases', []).insert(0, new_release)
	data['unreleased'] = []
	with open('desktop/CHANGELOG.json', 'w') as f:
	json.dump(data, f, indent=2)
	f.write('\n')
	print(f'Consolidated {len(unreleased)} changelog entries for v$VERSION')
	"

[greptile-apps]

Potential race condition: if two PRs merge simultaneously, both workflows compute the same next version from the same latest tag, leading to duplicate version numbers or tag conflicts