core · Current reference
Core v0.1.42 release notes
Review the production Math Notation V1 release and its cross-platform validation hardening.
Applies to v0.2.8
Component pins for v0.2.8
| Component | Role | Version |
|---|---|---|
| core | runtime | v0.1.42 |
| theme-shield | theme | v0.1.15 |
| starter | reference | v0.1.3 |
| docs | reference | v0.1.4 |
| distribution | tooling | v0.3.7 |
| restricted-component-1 | consumer-reference | v0.1.22 |
| restricted-component-2 | consumer-reference | v1.1.21 |
Release date: 2026-07-26
This production patch makes the Math Notation V1 validation report’s source-path containment portable across macOS, Linux, and Windows.
Math Notation V1 was implemented in v0.1.40, and its documentation and
cross-product evidence were completed in v0.1.41. The syntax, capability
shape, report schema, renderer, and Hugo requirement remain unchanged in
v0.1.42.
Current Production Pin
Use v0.1.42 for new Core installations and production upgrades:
require github.com/jerrybroughton/likestyle-foundry-core v0.1.42
go install github.com/jerrybroughton/likestyle-foundry-core/cmd/foundry@v0.1.42
No content, configuration, database, dependency, or schema migration is required.
Cross-Platform Validation Fix
- Rejects rooted source paths written for a different operating-system path convention before attempting to relativize them.
- Prevents an out-of-site POSIX, drive-letter, or UNC path from being exposed as a repository-relative finding.
- Preserves native in-site path normalization and finding deduplication.
- Adds regression coverage for POSIX, Windows drive-letter, and UNC paths.
This is a privacy and portability hardening patch. It does not change accepted
math syntax or the closed foundry.math-validation.v1 JSON contract.
Stable Math Notation V1 Contract
- Inline math uses
\(...\). - Display math uses
\[...\]or$$...$$. - Single-dollar inline math remains unsupported.
- Hugo performs strict build-time transformation to semantic MathML.
- Published pages load no MathJax, KaTeX, browser math runtime, CDN, or remote math stylesheet.
- Hugo Extended
v0.160.1or newer remains required.
See Math Notation for the complete authoring, rendering, validation, migration, and rollback contract.
Foundry Control Handoff
Foundry Control should audit against exact Core v0.1.42 before enabling its
managed Math Notation rollout. The current
Control release audit prompt
keeps that work isolated in the Control repository and requires matching
runtime, contract, evidence, review, and publish identities.
Verification
The release uses the complete Release Checklist, including:
go test ./...
go run ./cmd/foundry validate compatibility-fixtures
go run ./cmd/foundry doctor --json
go run ./cmd/foundry release-check --json
go run ./cmd/foundry doctor --browser-smoke --require-browser --json
node scripts/foundry-doctor.js
node scripts/validate-preview-runtime.js
Release verification completed on 2026-07-26 across the local release matrix and the GitHub Actions macOS, Linux, and Windows lanes. The required Safari lane included all compatibility fixtures and 390-pixel MathML assertions.
See Foundry Core v0.1.41 for the documentation and cross-product evidence completion release, and Foundry Core v0.1.40 for the original implementation details.