[alexander-yevsyukov]

Summary

./gradlew checkSamples — and CI's Check Code Embedding workflow — was passing while verifying nothing. Two problems compounded:

1. Stale config. Update project folder structure #71 moved the main (v1) documentation from content/docs/1 to the root content/docs, but docs/_settings/v1.embed-code.yml kept pointing at ../content/docs/1, which no longer exists.
2. Swallowed error. The committed embed-code binaries were v1.2.0, which logs argument errors like that missing path but exits with status 0. Upstream fixed this in SpineEventEngine/embed-code-go@9fa4244, first released in v1.2.3: every failure now exits with status 1.

This PR updates the binaries to v1.2.4 (the latest release) and points the config at the root docs, so checkSamples checks the real content again. It also adds the missing config step to the main-version switch in SPINE_RELEASE.md, so the next content move doesn't break the check silently. Finally, it picks up a config update that adds Gradle Wrapper validation.

An earlier revision of this PR worked around the swallowed error with a fail-closed guard in docs/_script/check-samples. With v1.2.4 the guard is redundant, so it was removed and the script is unchanged from master.

Changes

• docs/_bin — binaries updated from v1.2.0 to v1.2.4, plus the Windows binary for completeness. Each file matches the SHA-256 digest published with the release.

  Release asset	File in docs/_bin
  embed-code-linux	embed-code-ubuntu (used by CI)
  embed-code-macos-arm64.zip	embed-code-macos
  embed-code-macos-x64.zip	embed-code-macos-x86_64
  embed-code-windows.exe	embed-code-windows.exe (new; no script invokes it)

• docs/_settings/v1.embed-code.yml — docs-path now points at ../content/docs. The embed-mappings block was dropped: v1.2.3 renamed that key to embeddings, so v1.2.4 ignored it and read only the top-level paths.

• SPINE_RELEASE.md — the "Change the current main version" procedure gains a step: when the content moves, update docs-path in the embed-code config.

• docs/assets/js/docs/architecture-diagram.js — a comment now points at the architecture page's current path, /docs/introduction/architecture.md.

• config — submodule bumped 3210ca6 → 94a9e08 (6 commits), bringing in Keep Gradle Wrapper validation in Hugo-only repositories config#781 (keep Gradle Wrapper validation in Hugo-only repositories) and Point to the site for verifying published artifacts config#780 (point to the site for verifying published artifacts).

• .github/workflows/gradle-wrapper-validation.yml — new, distributed by that config update. It validates the Gradle Wrapper JAR with gradle/actions/wrapper-validation on pushes to master and on every PR. This repo keeps the wrapper only to run Hugo through Gradle, and none of its workflows uses setup-gradle (which would validate the wrapper itself), so nothing else checked that the JAR is genuine.

Verification

embed-code check mode, run locally with the macOS binaries:

Scenario	v1.2.0 (before)	v1.2.4 (after)
Config file missing	exit 0 ❌	exit 1 ✅
docs-path does not exist	exit 0 ❌	exit 1 ✅
Valid config, embeddings up to date	exit 0	exit 0
Stale embedding	exit 1 (raw panic)	exit 1 (clean error)
Missing code files	exit 1 (raw panic)	exit 1 (clean error)

With the final config and v1.2.4, through the Gradle tasks:

• ./gradlew :checkSamples passes: "The documentation files are up-to-date with code files."
• With one embedding deliberately made stale, ./gradlew :checkSamples fails with exit status 1: "Check failed: the documentation files are not up-to-date with code files."
• ./gradlew :embedCode finishes without changing any file, so no embeddings needed regenerating.

The Linux binary already ran on CI for this PR and failed correctly, with exit status 1, on the old missing path. The Windows binary was not run.

Notes for reviewers

• Keep the binaries in docs/_bin at v1.2.3 or later: older versions bring the silent pass back.

🤖 Generated with Claude Code