Repository navigation
ToppleCat 0.1.0
ToppleCat 0.1.0 makes both sides of an agent handoff reviewable: read the executable contract before implementation starts, then verify fresh, AC-attributed evidence after the agent finishes. The delivery decision remains with the human.
Review the contract before handoff
toppleCatReview --spec ... produces a reviewer-only Spec Review that shows the selected Markdown Spec alongside the executable material bound to each Acceptance Condition: scenarios, public and reviewer-owned Typed Case Rows, properties, and public Acceptance Method source.
It is a reading surface for handoff preparation. It does not run verification or decide whether the upstream Spec is complete.
Verify a completed feature without weakening the full-project seal
toppleCatVerify remains the complete-contract command for CI. Reviewers can also select repeated Spec paths or AC IDs for focused feedback on recently completed work.
Scoped verification runs Public Acceptance, Hidden Tests, Property-Based Testing, and Mutation Testing for the selected ACs. The report makes the scope explicit and states that a scoped PASS is not a complete-contract result. Contract Integrity, toppleCatSeal, and toppleCatReseal always use the complete contract and policy.
Keep mutation evidence with the AC that earned it
Formal Mutation Testing uses ToppleCat’s managed PIT profile. Mutation Attribution matches the complete Acceptance Method identity, so every AC must detect the mutations attributed to its own public method. Project-wide mutation scores and percentage thresholds do not substitute for AC-level evidence.
When evidence is incomplete or a mutation is missed, the Verification Report shows what was assessed, detected, and undetected without exposing reviewer-only details to the implementation agent.
Start with the result, then inspect the details
Verification Report opens with each Acceptance Condition’s status, plain-language result, and safeguard outcomes. Failed cases show authored input plus expected-versus-actual differences before deeper technical evidence.
Property completion counts now require a complete lifecycle from the current run, matched to the sealed AC, full Java method identity, and source digest.
Read reports in English or Traditional Chinese
Spec Review and Verification Report support --language en and --language zh-TW. The option translates ToppleCat-owned interface text while preserving selected Markdown, test names, case data, AC IDs, Gate names, verdicts, PIT outcomes, producer text, and raw failures.
Keep public demonstrations separate from real deliveries
The public project page includes five synthetic checkout examples for Public Acceptance, Hidden Tests, Property-Based Testing, Mutation Testing, and Contract Integrity. These examples explain the product; they are not evidence or approval for an actual delivery.
Requirements
ToppleCat 0.1.0 requires Java 25 and a compatible Gradle version. Formal Verify manages PIT 1.25.5. Reviewer report bundles work offline and do not load external UI, fonts, analytics, syntax highlighting, or a Mermaid runtime.