traceability-generate

command
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 2, 2026 License: Apache-2.0 Imports: 10 Imported by: 0

README

Python test traceability generator

go run ./tools/traceability-generate expands the rules in test/conformance/traceability-rules.json into a deterministic entry for each frozen Python test function. Every go:, py:, or ts: evidence reference must resolve to a real repository test declaration.

The rules distinguish evidence deliberately assigned to one case from tests that only support a Python test file as a group:

  • supporting_evidence produces file-supporting entries and is not a parity claim.
  • cases produces explicit case-specific entries.
  • case_evidence is reserved for one-to-one templates containing {python_test}, such as retained host-adapter tests with identical names.

case_specific_evidence_minimum is a non-regression checkpoint and must equal the generated case-specific count. Raise it whenever new Python cases gain explicit evidence; do not lower it to make generation pass.

Use go run ./tools/traceability-generate -check to reject missing source tests, stale output, unknown rules, path traversal, and nonexistent evidence. The generated traceability.json is checked by go test as well as CI.

Documentation

Overview

Command traceability-generate expands the frozen Python test inventory into a case-by-case implementation evidence table. Evidence references are resolved against real test declarations before output is accepted.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL