Historical documentation Bundle v0.2.8 Core v0.1.42 Distribution v0.3.7 Released 2026-07-26T00:00:00Z
Release history
Core v0.1.42 release notes Review the production Math Notation V1 release and its cross-platform validation hardening. v0.2.8 core current site-builderscore-developersintegratorsoperatorsmaintainersai-agents

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
ComponentRoleVersion
coreruntimev0.1.42
theme-shieldthemev0.1.15
starterreferencev0.1.3
docsreferencev0.1.4
distributiontoolingv0.3.7
restricted-component-1consumer-referencev0.1.22
restricted-component-2consumer-referencev1.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.1 or 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.

Static Pagefind search

Search Foundry documentation

Type at least two characters
Search the full documentation system

Results stay inside this build profile and can be filtered by version, component, audience, and lifecycle.

By LikeStyle
Site details
Site release
Foundry Documentation 1.3.9
Foundry bundle
v1.1.11
Foundry Core
v1.1.11
Credit
Powered by Foundry, a LikeStyle product.