chore: version management via /VERSION + Xcode Cloud post-clone hook

[torlando-tech]

Summary

Adds a single source of truth for the app version (/VERSION) and an Xcode Cloud post-clone script that rewrites the project's MARKETING_VERSION and CURRENT_PROJECT_VERSION on every build. Lets you bump the visible version (any of major/minor/patch) by editing one file, and gets unique TestFlight build numbers for free per push.

The first TestFlight upload after merge will be 0.0.2 — picking up from the existing 0.0.1 build.

How it works

What	Where it lives	When it changes
MARKETING_VERSION (CFBundleShortVersionString, what users see — 0.0.2)	/VERSION	You edit it manually
CURRENT_PROJECT_VERSION (CFBundleVersion / build number)	computed in CI	git rev-list --count HEAD on every Xcode Cloud build
Network extension version	Sources/ColumbaNetworkExtension/Info.plist via $(MARKETING_VERSION) / $(CURRENT_PROJECT_VERSION) substitution	Auto-follows host app (Apple requires this)

The CI script (ci_scripts/ci_post_clone.sh) is invoked automatically by Xcode Cloud after clone, before build. It uses sed to rewrite the four MARKETING_VERSION and four CURRENT_PROJECT_VERSION build settings in project.pbxproj.

Workflow

• Just iterating — push as normal. Build number auto-increments. TestFlight will see 0.0.2 (47), 0.0.2 (48), etc.
• Releasing a new version — edit /VERSION (e.g., 0.0.2 → 0.1.0) and push. Next upload becomes 0.1.0 (N).

Notes

• Sources/ColumbaNetworkExtension/Info.plist had hardcoded 1.0 / 1 for CFBundleShortVersionString / CFBundleVersion, which would have caused upload rejection once the host app version drifted away. Switched both to $(MARKETING_VERSION) / $(CURRENT_PROJECT_VERSION) to track the host automatically (matches how every other field in that file already used $(...) substitution).
• Local builds (e.g., columba-deploy) don't run the CI script and use whatever's in pbxproj at the time. The committed pbxproj has MARKETING_VERSION = 0.0.2 and CURRENT_PROJECT_VERSION = 1 so local builds produce a sensible version. CI overwrites both at build time.

Test plan

• Script runs cleanly locally and rewrites pbxproj correctly
• Release sim build embeds 0.0.2 / 204 (script-set count) in ColumbaApp.app/Info.plist
• Xcode Cloud build Cannot build - Swift dependencies seems not right #10 (or next) shows 0.0.2 (N) in TestFlight where N is current commit count
• Network extension .appex Info.plist resolves to 0.0.2 (N) — verify after first device-target archive

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR introduces a single source of truth for the app version via /VERSION and an Xcode Cloud post-clone hook that rewrites MARKETING_VERSION and CURRENT_PROJECT_VERSION in project.pbxproj at build time. It also fixes a latent App Store upload blocker by replacing hardcoded version strings in the network extension's Info.plist with $(MARKETING_VERSION)/$(CURRENT_PROJECT_VERSION) substitutions.

Confidence Score: 5/5

Safe to merge — no logic errors, security issues, or correctness problems found.

All four changed files are clean. The script has solid error handling (set -euo pipefail, explicit guards, semver validation), uses a hardcoded project path (avoids the prior pipefail/SIGPIPE concern), and macOS-compatible sed -i.bak. The pbxproj and plist changes are mechanical and correct. No P1 or P0 findings.

No files require special attention.

Important Files Changed

Filename	Overview
ci_scripts/ci_post_clone.sh	New Xcode Cloud post-clone hook that reads VERSION, validates semver format, computes build number from git commit count, and rewrites pbxproj build settings in-place via sed. Well-structured with proper set -euo pipefail, explicit guards, and hardcoded project path.
VERSION	New single-source-of-truth file for MARKETING_VERSION, containing 0.0.2.
Sources/ColumbaNetworkExtension/Info.plist	Replaced hardcoded 1.0/1 with $(MARKETING_VERSION)/$(CURRENT_PROJECT_VERSION) so the network extension tracks the host app version automatically, preventing App Store upload rejection on version drift.
Columba.xcodeproj/project.pbxproj	Updated four MARKETING_VERSION build settings from 1.0 to 0.0.2; CURRENT_PROJECT_VERSION remains 1 (to be overwritten at CI build time by the post-clone script).

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Xcode Cloud: repo cloned] --> B[ci_post_clone.sh invoked]
    B --> C{VERSION file exists?}
    C -- No --> D[exit 1: error]
    C -- Yes --> E[Read MARKETING_VERSION from /VERSION]
    E --> F{Matches MAJOR.MINOR.PATCH?}
    F -- No --> D
    F -- Yes --> G[BUILD_NUMBER = git rev-list --count HEAD]
    G --> H{project.pbxproj exists?}
    H -- No --> D
    H -- Yes --> I["sed: rewrite MARKETING_VERSION + CURRENT_PROJECT_VERSION in pbxproj"]
    I --> J[Remove .bak file]
    J --> K[Xcode build proceeds with updated versions]
    K --> L["TestFlight upload: 0.0.2 (N)"]

Loading

_{Reviews (2): Last reviewed commit: "fix: hardcode pbxproj path in CI script ..." | Re-trigger Greptile}