Development¶
Use Go 1.27.1 or later. The root uses the toolkit errors module and the private prepared JSON Schema compiler
github.com/santhosh-tekuri/jsonschema/v6 v6.0.3, with golang.org/x/text v0.40.0 indirectly.
TestDependencyFootprint runs go list -deps . to reject protocol SDKs,
Cobra, HTTP/gRPC, controls and service frameworks in the root graph.
The optional server package now hosts compact/direct tools and resources through SDK 1.7.0.
Its remaining interaction/Apps work is recorded in the server reference.
The cobra adapter is still planned.
| Command | Check |
|---|---|
just tidy |
Resolve module metadata |
just test |
Unit tests and runnable examples with coverage |
just test-race |
Race detection, including concurrent reads and accessor mutation |
just lint |
Estate golangci-lint v2 rules |
just docs |
Strict Zensical documentation build |
just ci |
Tidy, tests, race, lint and docs |
just coverage |
Local HTML coverage view |
just bench |
1,000-operation registry construction and search benchmarks |
just vuln |
govulncheck against the current vulnerability database |
just deadcode |
Dead-code inspection; exported library APIs require consumer-aware interpretation |
CI uses released phpboyscout/cicd v0.46.0 library components for lint, tests, security, Colophon release
orchestration and Zensical Pages. Renovate extends the shared Go and library presets. These files configure
future pipelines; a local test run is not evidence of GitLab runner execution or a deployed docs site.
The value layer is pure library logic and uses public API tests. CLI workflows will gain behavior scenarios with the Cobra implementation. Native Linux, macOS and Windows subprocess acceptance remains a release gate; cross-compilation alone cannot prove process cleanup.
Follow the wiki implementation plan.
The current workspace has a read-only placeholder .git entry; use a real isolated checkout for later git operations.
Run the JSON gateway fuzz target with go test -run '^$' -fuzz FuzzInvocationJSONNeverPanics -fuzztime 5s.
The benchmark fixture is synthetic and records allocations as well as latency. Relevance on real GTB queries,
resident/peak memory, SDK transport overhead and consumer workloads still need integration evidence.
Run just test-sdk-compat for the pinned compact/direct SDK 1.4.1/1.6.0/1.7.0 stdio/HTTP fixture matrix.
It builds disposable local executables and starts a loopback HTTP listener; it needs Python 3 and the declared Go toolchain.