xworkmate-app/Makefile

.DEFAULT_GOAL := help

SHELL := /bin/bash

FLUTTER ?= flutter
PNPM ?= pnpm
DART ?= dart
DEVICE ?= macos
APP_STORE_DART_DEFINE ?= --dart-define=XWORKMATE_APP_STORE=true
PUBSPEC_VERSION_LINE := $(shell sed -n 's/^version:[[:space:]]*//p' pubspec.yaml | head -n 1)
PUBSPEC_BUILD_DATE := $(shell sed -n 's/^build-date:[[:space:]]*//p' pubspec.yaml | head -n 1)
PUBSPEC_BUILD_ID := $(shell sed -n 's/^build-id:[[:space:]]*//p' pubspec.yaml | head -n 1)
APP_VERSION := $(firstword $(subst +, ,$(PUBSPEC_VERSION_LINE)))
APP_BUILD_NUMBER_RAW := $(word 2,$(subst +, ,$(PUBSPEC_VERSION_LINE)))
APP_BUILD_NUMBER := $(if $(APP_BUILD_NUMBER_RAW),$(APP_BUILD_NUMBER_RAW),1)
APP_BUILD_DATE := $(if $(PUBSPEC_BUILD_DATE),$(PUBSPEC_BUILD_DATE),unknown)
APP_BUILD_COMMIT := $(if $(PUBSPEC_BUILD_ID),$(PUBSPEC_BUILD_ID),unknown)
APP_DART_DEFINE_VERSION ?= --dart-define=XWORKMATE_DISPLAY_VERSION=$(APP_VERSION)
APP_DART_DEFINE_BUILD ?= --dart-define=XWORKMATE_BUILD_NUMBER=$(APP_BUILD_NUMBER)
APP_DART_DEFINE_BUILD_DATE ?= --dart-define=XWORKMATE_BUILD_DATE=$(APP_BUILD_DATE)
APP_DART_DEFINE_BUILD_COMMIT ?= --dart-define=XWORKMATE_BUILD_COMMIT=$(APP_BUILD_COMMIT)

.PHONY: help deps analyze test test-all test-flutter test-golden test-integration test-integration-macos test-patrol test-go test-ci check format run open-macos-xcode sync-version build-linux build-macos build-ios-sim ios-pods ios-pods-check build-ios-release-no-codesign verify-ios-release package-deb package-rpm package-linux package-mac install-mac clean render-release-docs docs-public-api check-export-compliance test-real-env-login-chain inspect-xworkmate-bridge-service test-api-contract test-api-scenario-contract check-api-external

help: ## Show available targets
	@grep -E '^[a-zA-Z0-9_.-]+:.*?## ' Makefile | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "%-18s %s\n", $$1, $$2}'

deps: ## Install Flutter dependencies
	$(FLUTTER) pub get

analyze: ## Run static analysis
	$(FLUTTER) analyze

test: ## Run Flutter tests
	$(FLUTTER) test

test-flutter: ## Run the full Flutter unit/widget test suite
	$(FLUTTER) test

test-golden: ## Run Flutter Golden tests
	$(FLUTTER) test test/golden

test-integration: ## Run Flutter integration tests
	$(FLUTTER) test integration_test

test-integration-macos: ## Run macOS integration tests serially for the desktop app
	$(FLUTTER) test integration_test/desktop_navigation_flow_test.dart -d macos
	$(FLUTTER) test integration_test/desktop_settings_flow_test.dart -d macos

test-real-env-login-chain: ## Run the real-env login/sync integration chain on macOS
	$(FLUTTER) test integration_test/login_flow_test.dart -d macos

inspect-xworkmate-bridge-service: ## Read-only SSH inspection for xworkmate-bridge.svc.plus service
	bash scripts/check-xworkmate-bridge-service.sh

test-api-contract: ## Run the API interface contract script against external services
	bash scripts/ci/verify_api_interface_contract.sh

test-api-scenario-contract: ## Run the scenario-oriented API script against external services
	bash scripts/ci/verify_api_scenario_contract.sh

check-api-external: test-api-contract test-api-scenario-contract ## Run both external API validation scripts

test-patrol: ## Run Patrol end-to-end tests
	dart pub global activate patrol_cli
	patrol test

test-go: ## Run xworkmate-bridge Go unit tests
	cd ../xworkmate-bridge && go test ./...

test-ci: test-flutter test-golden test-integration test-go ## Run the PR validation chain

test-all: test-ci test-patrol ## Run the full local validation chain

check: analyze test ## Run the standard validation suite

format: ## Format Dart sources
	$(DART) format lib test

render-release-docs: ## Render feature matrix, roadmap, release notes, and changelog docs
	$(DART) run tool/render_release_docs.dart

docs-public-api: ## Generate the public API inventory docs payload
	python3 scripts/docs/extract_public_api_inventory.py

sync-version: ## Sync Flutter/Xcode build metadata from pubspec.yaml
	$(FLUTTER) build macos --config-only --build-name=$(APP_VERSION) --build-number=$(APP_BUILD_NUMBER) $(APP_DART_DEFINE_VERSION) $(APP_DART_DEFINE_BUILD) $(APP_DART_DEFINE_BUILD_DATE) $(APP_DART_DEFINE_BUILD_COMMIT)
	@echo "version=$(APP_VERSION)"
	@echo "build=$(APP_BUILD_NUMBER)"
	@echo "build-date=$(PUBSPEC_BUILD_DATE)"
	@echo "build-id=$(PUBSPEC_BUILD_ID)"
	@sed -n 's/^FLUTTER_BUILD_NAME=/xcode-build-name=/p; s/^FLUTTER_BUILD_NUMBER=/xcode-build-number=/p' macos/Flutter/ephemeral/Flutter-Generated.xcconfig

run: ## Run the app on a device or desktop target (DEVICE=macos by default)
	$(FLUTTER) run -d $(DEVICE)

open-macos-xcode: ## Open the supported macOS Xcode workspace entrypoint
	open macos/Runner.xcworkspace

build-linux: ## Build the Linux app in release mode
	$(FLUTTER) build linux --release --build-name=$(APP_VERSION) --build-number=$(APP_BUILD_NUMBER) $(APP_DART_DEFINE_VERSION) $(APP_DART_DEFINE_BUILD) $(APP_DART_DEFINE_BUILD_DATE) $(APP_DART_DEFINE_BUILD_COMMIT)

build-macos: ## Build the macOS app in release mode
	$(FLUTTER) build macos --release $(APP_STORE_DART_DEFINE) --build-name=$(APP_VERSION) --build-number=$(APP_BUILD_NUMBER) $(APP_DART_DEFINE_VERSION) $(APP_DART_DEFINE_BUILD) $(APP_DART_DEFINE_BUILD_DATE) $(APP_DART_DEFINE_BUILD_COMMIT)
	bash scripts/check-apple-export-compliance.sh build/macos/Build/Products/Release/XWorkmate.app

build-ios-sim: ## Build the iOS app for the simulator
	$(FLUTTER) build ios --simulator $(APP_STORE_DART_DEFINE) --build-name=$(APP_VERSION) --build-number=$(APP_BUILD_NUMBER) $(APP_DART_DEFINE_VERSION) $(APP_DART_DEFINE_BUILD) $(APP_DART_DEFINE_BUILD_DATE) $(APP_DART_DEFINE_BUILD_COMMIT)
	bash scripts/check-apple-export-compliance.sh build/ios/iphonesimulator/Runner.app

ios-pods: ## Regenerate the iOS CocoaPods sandbox
	cd ios && pod install

ios-pods-check: ios-pods ## Verify Podfile.lock and Pods/Manifest.lock are in sync
	cmp -s ios/Podfile.lock ios/Pods/Manifest.lock

build-ios-release-no-codesign: ios-pods-check ## Build the iOS device app in release mode without codesigning
	$(FLUTTER) build ios --release --no-codesign $(APP_STORE_DART_DEFINE) --build-name=$(APP_VERSION) --build-number=$(APP_BUILD_NUMBER) $(APP_DART_DEFINE_VERSION) $(APP_DART_DEFINE_BUILD) $(APP_DART_DEFINE_BUILD_DATE) $(APP_DART_DEFINE_BUILD_COMMIT)

verify-ios-release: ios-pods-check build-ios-release-no-codesign analyze ## Regenerate pods, build iOS release without codesigning, and run static analysis

package-deb: ## Create the Linux .deb package
	bash scripts/package-linux-deb.sh

package-rpm: ## Create the Linux .rpm package
	bash scripts/package-linux-rpm.sh

package-linux: ## Create both Linux packages
	bash scripts/package-linux.sh

package-mac: ## Create the macOS .app and DMG
	XWORKMATE_APP_STORE=true bash scripts/package-flutter-mac-app.sh

install-mac: package-mac ## Package and install the macOS app into /Applications
	bash scripts/install-flutter-mac-dmg.sh

clean: ## Remove generated artifacts
	$(FLUTTER) clean
	rm -rf build dist

check-export-compliance: ## Verify source and built Apple plist export-compliance flags
	bash scripts/check-apple-export-compliance.sh