GoFrame v0.2.0-preview.3

Release Notes: v0.2.0-preview.3

Summary

v0.2.0-preview.3 is a hotfix preview after v0.2.0-preview.2.

It fixes stale toolchain self-reporting. v0.2.0-preview.2 installed from the
correct Go module tag, but the CLI self-reported:

goxc version 0.1.0

and goxc package wrote generated package metadata with:

"toolchainVersion": "0.1.0"

goxc version and generated goframe-package.json metadata now use the module
version recorded in Go build information for tagged module installs. Local
checkout builds report and write:

devel

What Changed

• goxc version no longer uses the hardcoded release constant for CLI
  self-reporting.
• goxc package writes toolchainVersion from the same build-info-derived
  value in generated goframe-package.json metadata.
• Tagged module installs such as @v0.2.0-preview.3 report and write
  v0.2.0-preview.3.
• Local checkout builds such as go run ./cmd/goxc version and
  go install ./cmd/goxc report devel, and local package metadata writes
  "toolchainVersion": "devel".

Compatibility

• No GoFrame runtime behavior changed.
• No GOX parser, codegen, or language behavior changed.
• No package workflow, layout, build, export, serve, clean, doctor, workspace,
  or manifest behavior changed.
• Package metadata now reports the build-info-derived toolchain version.
• No examples changed.
• No migration is required.

Validation

Release-gate validation for this hotfix should include:

• go test ./cmd/goxc;
• go test ./...;
• go vet ./...;
• node scripts/docs-check.mjs;
• scripts/artifact-check.sh;
• scripts/module-path-check.sh;
• scripts/size-budget.sh;
• scripts/browser-smoke.sh.

The release readiness check should also verify local checkout behavior:

go run ./cmd/goxc version
tmpbin="$(mktemp -d)"
GOBIN="$tmpbin" go install ./cmd/goxc
"$tmpbin/goxc" version

Both local commands should print goxc version devel on the first line.

It should also verify local package metadata:

go run ./cmd/goxc package ./examples/counter --compiler=go

The generated examples/counter/.goframe/package/standalone/goframe-package.json
should contain:

"toolchainVersion": "devel"

Install

After the tag is published, install the exact hotfix preview with:

go install github.com/graybuton/goframe/cmd/goxc@v0.2.0-preview.3

Verification

Run:

goxc version

Expected first line:

goxc version v0.2.0-preview.3

Generated goframe-package.json metadata should include:

"toolchainVersion": "v0.2.0-preview.3"

Non-Goals

This hotfix does not include:

• runtime changes;
• GOX parser, codegen, or language changes;
• package workflow or layout changes beyond the reported metadata value;
• goxc build/export/serve behavior changes;
• server/fullstack API changes;
• production readiness claims;
• route loader, JSON/data framework, or global cache changes;
• release tag creation in the release-notes PR.