feat(build): add release workflow generator

pkg/build/workflow.go

@@ -0,0 +1,48 @@
+// Package build provides project type detection and cross-compilation for the Core build system.
+// This file handles generation of the release GitHub Actions workflow from the embedded template.
+package build
+
+import (
+	"embed"
+
+	"dappco.re/go/core/build/internal/ax"
+	io_interface "dappco.re/go/core/io"
+	coreerr "dappco.re/go/core/log"
+)
+
+//go:embed templates/release.yml
+var releaseWorkflowTemplate embed.FS
+
+// DefaultReleaseWorkflowPath is the conventional output path for the release workflow.
+//
+// path := build.DefaultReleaseWorkflowPath // ".github/workflows/release.yml"
+const DefaultReleaseWorkflowPath = ".github/workflows/release.yml"
+
+// WriteReleaseWorkflow writes the embedded release workflow template to path.
+// When path is empty, it writes to .github/workflows/release.yml.
+//
+// err := build.WriteReleaseWorkflow(io.Local, "")
+// err := build.WriteReleaseWorkflow(io.Local, "/tmp/repo/.github/workflows/release.yml")
+func WriteReleaseWorkflow(fs io_interface.Medium, path string) error {
+	if path == "" {
+		path = DefaultReleaseWorkflowPath
+	}
+
+	content, err := releaseWorkflowTemplate.ReadFile("templates/release.yml")
+	if err != nil {
+		return coreerr.E("build.WriteReleaseWorkflow", "failed to read embedded workflow template", err)
+	}
+
+	if err := fs.Write(path, string(content)); err != nil {
+		return coreerr.E("build.WriteReleaseWorkflow", "failed to write release workflow", err)
+	}
+
+	return nil
+}
+
+// ReleaseWorkflowPath joins a project directory with the conventional workflow path.
+//
+// path := build.ReleaseWorkflowPath("/home/user/project")
+func ReleaseWorkflowPath(projectDir string) string {
+	return ax.Join(projectDir, DefaultReleaseWorkflowPath)
+}

pkg/build/workflow_test.go

@@ -0,0 +1,44 @@
+package build
+
+import (
+	"testing"
+
+	"dappco.re/go/core/io"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestWorkflow_WriteReleaseWorkflow_Good(t *testing.T) {
+	t.Run("writes the embedded template to the default path", func(t *testing.T) {
+		fs := io.NewMockMedium()
+
+		err := WriteReleaseWorkflow(fs, "")
+		require.NoError(t, err)
+
+		content, err := fs.Read(DefaultReleaseWorkflowPath)
+		require.NoError(t, err)
+
+		template, err := releaseWorkflowTemplate.ReadFile("templates/release.yml")
+		require.NoError(t, err)
+
+		assert.Equal(t, string(template), content)
+		assert.Contains(t, content, "workflow_call:")
+		assert.Contains(t, content, "workflow_dispatch:")
+		assert.Contains(t, content, "core build --targets")
+	})
+
+	t.Run("writes to a custom path", func(t *testing.T) {
+		fs := io.NewMockMedium()
+
+		err := WriteReleaseWorkflow(fs, "custom/workflow.yml")
+		require.NoError(t, err)
+
+		content, err := fs.Read("custom/workflow.yml")
+		require.NoError(t, err)
+		assert.NotEmpty(t, content)
+	})
+}
+
+func TestWorkflow_ReleaseWorkflowPath_Good(t *testing.T) {
+	assert.Equal(t, "/tmp/project/.github/workflows/release.yml", ReleaseWorkflowPath("/tmp/project"))
+}