chore: repo hygiene for the wasm era (WO-WZ-015 fix round)

Replace the retired .so Makefile with the wasm/.bnp convention (build /
verify / archive-check / publish via ninja plugin build), gitignore *.so
and *.bnp artifacts, and refresh the stale [compatibility] block_core
constraint to the v0.15 era.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Alex Dunmow 2026-07-04 00:15:59 +08:00
parent 0e8a203680
commit 93001afe44
3 changed files with 47 additions and 14 deletions

1
.gitignore vendored
View File

@ -3,3 +3,4 @@
tmp/ tmp/
.idea/ .idea/
.vscode/ .vscode/
*.bnp

View File

@ -1,27 +1,59 @@
# Y2K — local build helpers (.so plugin workflow) # y2k — build & publish helpers (wasm .bnp workflow)
#
# The theme compiles to a wasip1 reactor-mode wasm module packed into a .bnp
# artifact (`ninja plugin build`). The legacy .so path is retired (WO-WZ-015):
# the CMS is wasm-native and can no longer load .so plugins. Distribution is
# publish-to-registry -> InstallFromRegistry (hot-load, no restart).
# #
# Usage: # Usage:
# make # build y2k.so locally (CGO + buildmode=plugin) # make build # compile wasm + pack y2k-<version>.bnp
# make clean # remove y2k.so # make verify # validate the built .bnp (layout/abi/name/size)
# make templ # regenerate *_templ.go via templ generate # make archive-check # prove a clean `git archive HEAD` compiles to wasm
# make publish # ninja plugin publish --bnp (to the active registry)
# make templ # regenerate templ Go files
# make clean # remove build artefacts
.PHONY: all clean templ help .PHONY: build verify archive-check publish templ clean help
PLUGIN_NAME := y2k PLUGIN_NAME := y2k
NINJA := ninja
BNP := $(PLUGIN_NAME)-$(shell grep '^version' plugin.mod | sed 's/.*"\(.*\)"/\1/').bnp
all: $(PLUGIN_NAME).so # Compile to wasm and pack the .bnp (GOOS=wasip1 GOARCH=wasm, DESCRIBE probe,
# tar.zst of plugin.wasm + plugin.mod + manifest.pb + schemas/ + assets/).
build:
$(NINJA) plugin build --dir .
$(PLUGIN_NAME).so: $(wildcard *.go) plugin.mod go.mod # Validate the built .bnp exactly as the registry/loader will.
CGO_ENABLED=1 go build -buildmode=plugin -ldflags="-s -w" -o $(PLUGIN_NAME).so . verify:
$(NINJA) plugin verify $(BNP)
clean: # Prove a clean `git archive HEAD` (what publish ships) compiles to wasm.
rm -f $(PLUGIN_NAME).so archive-check:
@T=$$(mktemp -d /tmp/archive-check-$(PLUGIN_NAME).XXXXXX) && \
trap 'rm -rf "$$T"' EXIT && \
git archive HEAD | tar -x -C "$$T" && \
cd "$$T" && GOOS=wasip1 GOARCH=wasm go build -buildmode=c-shared -o "$$T/check.wasm" . && \
echo "archive-check OK"
# Publish the prebuilt .bnp to the active registry.
# Pass --host https://my.localdev.blockninjacms.com for the dev orchestrator.
publish: build
$(NINJA) plugin publish --bnp $(BNP)
# Regenerate templ Go files locally.
templ: templ:
templ generate templ generate
# Remove build artefacts.
clean:
rm -f $(PLUGIN_NAME)-*.bnp $(PLUGIN_NAME).so plugin.wasm
help: help:
@echo "Targets:" @echo "Targets:"
@echo " all Build $(PLUGIN_NAME).so locally (default)" @echo " build Compile wasm + pack the .bnp"
@echo " clean Remove $(PLUGIN_NAME).so" @echo " verify Validate the built .bnp (loader-identical checks)"
@echo " templ Regenerate *_templ.go files" @echo " archive-check Prove a clean git archive HEAD compiles to wasm"
@echo " publish Publish the .bnp to the active registry"
@echo " templ Regenerate templ Go files"
@echo " clean Remove build artefacts"

View File

@ -9,4 +9,4 @@ categories = ["templates"]
tags = ["retro", "chrome", "vaporwave", "pastel", "music", "creator", "nostalgia", "web3"] tags = ["retro", "chrome", "vaporwave", "pastel", "music", "creator", "nostalgia", "web3"]
[compatibility] [compatibility]
block_core = ">=0.11.0 <0.12.0" block_core = ">=0.15.0 <0.16.0"