chore: release v0.3.2 (#412)

* chore: release v0.3.2

Critical fix for go install compatibility:
- Remove all replace directives from source code
- Update module version references to v0.3.2
- Update CHANGELOG with v0.3.2 release notes

This ensures go install github.com/finos/morphir/cmd/morphir@v0.3.2
works correctly without replace directive errors.

Development workflow now relies on go.work for local module resolution.

* fix: use v0.3.1 module versions until v0.3.2 is released

The CI was failing because go.mod files referenced v0.3.2 which doesn't
exist yet. We need to use the current released version (v0.3.1) until
v0.3.2 is actually released.

The release script will update these versions to v0.3.2 as part of the
release commit before creating tags.

* docs: document module version coordination for release PRs

Added critical documentation about why release PRs must use current
released versions in go.mod files instead of the version being released.

This ensures CI can pass before the new version exists, as CI needs to
download module dependencies that won't be available until after release.

* feat: add go.work automation to CI with external consumption test

- Created setup-workspace.sh/ps1 scripts for dynamic module discovery
- CI now automatically sets up go.work before all build/test jobs
- Added external consumption test for release PRs (without go.work)
- Updated morphir-developer skill with new workflow documentation

This ensures:
- Consistent behavior between local dev and CI
- Cross-module changes work seamlessly in all PRs
- Release PRs verify external consumption correctness
- No hardcoded module lists - fully dynamic

* docs: add comprehensive CI/Release workflow FAQ

Add CI_RELEASE_FAQ.md to help developers understand:
- How CI tests PR code (not old published versions)
- How go.work ensures CI uses local modules
- How multi-module PRs work
- How release workflow handles versioning
- Common troubleshooting scenarios

Update README.md and DEVELOPING.md to link to the new FAQ.

This addresses developer confidence questions about the
chicken-and-egg situation with module versions and ensures
all contributors understand our automated workspace setup.

* fix: make workspace setup script idempotent

Fix CI failure where go.work already exists by removing
existing go.work and go.work.sum files before initialization.

This makes the script idempotent - it can be run multiple times
safely without errors.

Updated both setup-workspace.sh and setup-workspace.ps1.

Author: DamianReeves

.claude/skills/morphir-developer.md

@@ -45,6 +45,9 @@ jobs:
       - name: Install just
         uses: extractions/setup-just@v3
 
+      - name: Set up Go workspace
+        run: bash ./scripts/setup-workspace.sh
+
       - name: Install golangci-lint from source
         run: |
           # Build golangci-lint from source to support Go 1.25.5
@@ -73,6 +76,10 @@ jobs:
       - name: Install just
         uses: extractions/setup-just@v3
 
+      - name: Set up Go workspace
+        shell: bash
+        run: bash ./scripts/setup-workspace.sh
+
       - name: Run tests
         run: just test
 
@@ -108,6 +115,10 @@ jobs:
       - name: Install just
         uses: extractions/setup-just@v3
 
+      - name: Set up Go workspace
+        shell: bash
+        run: bash ./scripts/setup-workspace.sh
+
       - name: Build binary (cross-platform)
         env:
           GOOS: ${{ matrix.os == 'ubuntu-latest' && 'linux' || matrix.os == 'macos-latest' && 'darwin' || 'windows' }}
@@ -135,5 +146,31 @@ jobs:
       - name: Install just
         uses: extractions/setup-just@v3
 
+      - name: Set up Go workspace
+        run: bash ./scripts/setup-workspace.sh
+
       - name: Verify modules build
         run: just verify
+
+  test-external-consumption:
+    name: Test External Consumption (Release PRs)
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' && (contains(github.event.pull_request.title, 'release') || contains(github.event.pull_request.labels.*.name, 'release'))
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Set up Go
+        uses: actions/setup-go@v6
+        with:
+          go-version: '1.25.5'
+          cache: true
+
+      - name: Test cmd/morphir builds without go.work
+        working-directory: cmd/morphir
+        run: |
+          echo "Testing external consumption (no go.work)..."
+          echo "This verifies that module versions in go.mod are correct."
+          go mod download
+          go build .
+          echo "✅ cmd/morphir builds successfully as external consumer would use it"

.github/workflows/ci.yml

@@ -7,6 +7,47 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.2] - 2026-01-05
+
+### Fixed
+- **CRITICAL**: Remove replace directives from source code for go install compatibility
+  - Removed all `replace` directives from cmd/morphir/go.mod
+  - Removed all `replace` directives from pkg/tooling/go.mod
+  - Removed all `replace` directives from tests/bdd/go.mod
+  - `go install github.com/finos/morphir/cmd/morphir@v0.3.2` now works correctly
+- Documented workflow trigger limitations for re-pushed tags
+
+### Added
+- **morphir-developer skill**: Comprehensive development workflow assistant
+  - go.work management and verification
+  - Branch/worktree setup with issue tracking
+  - Pre-commit checks and best practices
+  - Integration with beads and GitHub issues
+  - TDD/BDD workflow guidance
+- **Release automation script**: `scripts/release.sh` for automated releases
+  - Complete pre-flight checks
+  - Automated tag creation and pushing
+  - Workflow triggering and monitoring
+  - Post-release verification
+  - go install compatibility testing
+- **Workspace setup scripts**: Dynamic go.work configuration
+  - `scripts/setup-workspace.sh` for Linux/macOS
+  - `scripts/setup-workspace.ps1` for Windows
+  - Automatically discovers all Go modules
+  - Used by CI and local development
+- **CI enhancements**: go.work setup for all build/test jobs
+  - All CI jobs now use go.work for local module resolution
+  - External consumption test for release PRs
+  - Verifies module versions are correct before release
+
+### Changed
+- Development workflow: Use `go work` for local development instead of replace directives
+- Release process: Source code in tags no longer contains replace directives
+- Release process: Automated with `scripts/release.sh` for consistency
+- CI workflow: All jobs now set up go.work automatically
+  - Ensures consistent behavior between local dev and CI
+  - Release PRs get additional external consumption test
+
 ## [0.3.1] - 2026-01-05
 
 ### Fixed
@@ -114,7 +155,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - Duplicate help command registration in CLI
 
-[Unreleased]: https://github.com/finos/morphir/compare/v0.3.1...HEAD
+[Unreleased]: https://github.com/finos/morphir/compare/v0.3.2...HEAD
+[0.3.2]: https://github.com/finos/morphir/compare/v0.3.1...v0.3.2
 [0.3.1]: https://github.com/finos/morphir/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/finos/morphir/compare/v0.2.1...v0.3.0
 [0.1.0]: https://github.com/finos/morphir/releases/tag/v0.1.0