core/AGENTS.md
Alex Dunmow c7cbf69f63 refactor(abi): shed ABI contract + ninja CLI (WO-WZ-023)
The wasm-plugin ABI contract now lives in the cms (block/cms/abi/v1 + docs) and
the ninja CLI moved to its own repo (block/cli). Core keeps abi/ as the guest
SDK until WO-WZ-027. Removes cmd/ninja, the dead orchestrator registry client
(internal/api/orchestrator), the moved docs, and the now-unused ninja/orchclient
deps from go.mod/go.sum.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-04 22:37:24 +08:00

859 B

Core SDK

Go module git.dev.alexdunmow.com/block/core. Shared Go code between the CMS and the orchestrator — template engine, block registry, shared types, proto definitions.

Critical Rules

  • Core is NOT for plugins. Its only consumers are the CMS and the orchestrator; it exists purely to share code between those two. Plugins must not import block/core — in the wasm-plugin era they are standalone artifacts built against the wasm ABI, not this module. (Core was previously the plugin SDK; that role is gone.)
  • NEVER use replace directives in go.mod — not in this repo, not in any consumer. All module resolution goes through the Gitea module proxy. If you need to test local changes, tag and push a version.
  • All consumers are in-house — no backwards compatibility shims needed. Just change the API and update consumers.