What's in ToppleCat 0.2.2¶
If ToppleCat is new to you, start with What is ToppleCat?. This page is for people preparing an adoption or upgrade: it lists the current capabilities, environment requirements, and limits.
For the full historical record, use the repository's 0.2.1 release notes.
Current release line¶
Put each acceptance projection exactly where the business Spec says¶
Previously, a selected Markdown document coupled a visible heading to a generic
marker. Now one exact standalone marker, for example
<!-- topplecat:acceptance:AC-CHECKOUT-001 -->, is both the AC identity and
the Spec Review insertion point. A heading may use any wording or level, and
ordinary AC mentions stay prose. This removes accidental scope changes when a
team edits its business-document structure.
Each selected AC marker must be unique across the supplied repository-relative
--spec paths. Check reports every duplicate or malformed selected directive,
and Review inserts one complete checked projection per valid marker in source
order. Markers may be consecutive or appear before or after related prose.
Upgrade¶
Projects using the 0.2.1 selected-Spec contract must replace every generic
<!-- topplecat:acceptance --> marker with an exact ID-bearing marker. Do not
depend on headings, marker proximity, ordinary references, or .feature files
to select scope. Pass the same exact relative --spec paths to Check, Review,
and scoped Verify.
Requirements and limits¶
ToppleCat runs on JDK 21 or 25; consumer source may target Java 17, 21, or 25
when Gradle runs on a supported execution JDK. This release line is not yet in
Maven Central, so build it locally with ./gradlew publishToMavenLocal and put
mavenLocal() before mavenCentral() until a maintainer completes that
separate publication.
Spec Review and Verification Report remain reviewer-only HTML surfaces. A
scoped PASS covers only its selected ACs; it does not prove the business Spec
is complete or grant organizational approval.
Documentation surface¶
The English and Traditional-Chinese documentation, samples, and acceptance skill describe the same marker contract and local-Maven adoption boundary.
To adopt the current release line, build 0.2.2 locally and add mavenLocal().