feat: publish the Sandwich Hime source preview

Signed-off-by: Cole Speelman <gamertan@noreply.localhost>
2026-08-11 20:15:06 -04:00
commit 9b29b3d7f8
100 changed files with 10989 additions and 0 deletions
@@ -0,0 +1,82 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+
+// Package version contains build identifiers shared by the compiler and CLI.
+package version
+
+import (
+	"regexp"
+	"runtime/debug"
+	"strings"
+)
+
+const developmentCompilerVersion = "0.1.0-dev"
+
+// Compiler may be replaced in release binaries with
+// `-X gamertan.com/sandwich-hime/internal/version.Compiler=vX.Y.Z`.
+// A versioned `go install module/package@vX.Y.Z` instead supplies the main
+// module version through Go build information; init adopts that version when
+// no explicit linker value was provided.
+var Compiler = developmentCompilerVersion
+
+var (
+	taggedCompilerVersionPattern = regexp.MustCompile(`^v(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$`)
+	pseudoVersionSuffixPattern   = regexp.MustCompile(`(?:^|[.-])(?:0\.)?[0-9]{14}-[0-9a-f]{12,}$`)
+)
+
+func init() {
+	if information, ok := debug.ReadBuildInfo(); ok {
+		Compiler = selectCompilerVersion(Compiler, information.Main.Version)
+	}
+}
+
+func selectCompilerVersion(linkerValue, moduleVersion string) string {
+	if linkerValue != developmentCompilerVersion {
+		return linkerValue
+	}
+	moduleVersion = strings.TrimSpace(moduleVersion)
+	if !isTaggedCompilerVersion(moduleVersion) {
+		return linkerValue
+	}
+	return moduleVersion
+}
+
+func isTaggedCompilerVersion(value string) bool {
+	matches := taggedCompilerVersionPattern.FindStringSubmatch(value)
+	if matches == nil {
+		// Build metadata is deliberately excluded. In particular, local VCS
+		// builds can carry +dirty and must remain development builds.
+		return false
+	}
+	prerelease := matches[1]
+	if pseudoVersionSuffixPattern.MatchString(prerelease) {
+		// Go synthesizes valid-semver pseudo-versions for local VCS builds. They
+		// identify source, but they are not signed/tagged Hime-san releases.
+		return false
+	}
+	for _, identifier := range strings.Split(prerelease, ".") {
+		if len(identifier) > 1 && identifier[0] == '0' && allDecimal(identifier) {
+			return false
+		}
+	}
+	return true
+}
+
+func allDecimal(value string) bool {
+	if value == "" {
+		return false
+	}
+	for _, character := range value {
+		if character < '0' || character > '9' {
+			return false
+		}
+	}
+	return true
+}
+
+const (
+	// RuntimeABI identifies the generated-code/runtime contract.
+	RuntimeABI = "sando.v1"
+
+	// ConfigSchema is the supported himesan.json schema version.
+	ConfigSchema = 1
+)
@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+
+package version
+
+import "testing"
+
+func TestSelectCompilerVersion(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name          string
+		linkerValue   string
+		moduleVersion string
+		want          string
+	}{
+		{name: "local build", linkerValue: developmentCompilerVersion, moduleVersion: "(devel)", want: developmentCompilerVersion},
+		{name: "missing build info", linkerValue: developmentCompilerVersion, moduleVersion: "", want: developmentCompilerVersion},
+		{name: "versioned go install", linkerValue: developmentCompilerVersion, moduleVersion: "v1.0.0", want: "v1.0.0"},
+		{name: "versioned prerelease install", linkerValue: developmentCompilerVersion, moduleVersion: "v1.0.0-rc.1", want: "v1.0.0-rc.1"},
+		{name: "hyphenated prerelease install", linkerValue: developmentCompilerVersion, moduleVersion: "v1.2.3-beta-2", want: "v1.2.3-beta-2"},
+		{name: "pseudo version", linkerValue: developmentCompilerVersion, moduleVersion: "v0.0.0-20260811120000-0123456789ab", want: developmentCompilerVersion},
+		{name: "pseudo version after release", linkerValue: developmentCompilerVersion, moduleVersion: "v1.2.4-0.20260811120000-0123456789ab", want: developmentCompilerVersion},
+		{name: "pseudo version after prerelease", linkerValue: developmentCompilerVersion, moduleVersion: "v1.2.3-rc.1.0.20260811120000-0123456789ab", want: developmentCompilerVersion},
+		{name: "dirty pseudo version", linkerValue: developmentCompilerVersion, moduleVersion: "v0.0.0-20260811123456-fedcba987654+dirty", want: developmentCompilerVersion},
+		{name: "dirty release checkout", linkerValue: developmentCompilerVersion, moduleVersion: "v1.0.0+dirty", want: developmentCompilerVersion},
+		{name: "build metadata", linkerValue: developmentCompilerVersion, moduleVersion: "v1.0.0+build.1", want: developmentCompilerVersion},
+		{name: "leading zero release", linkerValue: developmentCompilerVersion, moduleVersion: "v01.0.0", want: developmentCompilerVersion},
+		{name: "leading zero numeric prerelease", linkerValue: developmentCompilerVersion, moduleVersion: "v1.0.0-rc.01", want: developmentCompilerVersion},
+		{name: "linker override wins", linkerValue: "v1.0.0-rc.1", moduleVersion: "v1.0.0", want: "v1.0.0-rc.1"},
+	}
+	for _, test := range tests {
+		test := test
+		t.Run(test.name, func(t *testing.T) {
+			t.Parallel()
+			if got := selectCompilerVersion(test.linkerValue, test.moduleVersion); got != test.want {
+				t.Fatalf("selectCompilerVersion(%q, %q) = %q, want %q", test.linkerValue, test.moduleVersion, got, test.want)
+			}
+		})
+	}
+}