workflow_interpretation_validation Namespace Reference

Functions
def	_load_end_to_end_trace_bundle
def	_load_json
def	_load_matrix_baseline_bundle
def	_load_unsupported_workflow_bundle
def	_load_workflow_contract
def	build_artifact_bundle (workflow_contract, end_to_end_trace_bundle, matrix_baseline_bundle, unsupported_workflow_bundle, optional_noise_bundle)
def	build_requirement_metadata (workflow_contract)
def	main ()
def	parse_args ()
def	run_validation
def	validate_artifact_bundle (bundle)
def	write_artifact_bundle

Variables
tuple	ARTIFACT_CORE_FIELDS
string	ARTIFACT_FILENAME = "workflow_interpretation_bundle.json"
	DEFAULT_OUTPUT_DIR = WORKFLOW_EVIDENCE_OUTPUT_DIR
	END_TO_END_TRACE_BUNDLE_PATH = DEFAULT_OUTPUT_DIR / END_TO_END_TRACE_ARTIFACT_FILENAME
	MATRIX_BASELINE_BUNDLE_PATH = DEFAULT_OUTPUT_DIR / MATRIX_BASELINE_ARTIFACT_FILENAME
tuple	OPTIONAL_NOISE_BUNDLE_PATH
	REPO_ROOT = Path(__file__).resolve().parents[3]
string	SUITE_NAME = "workflow_interpretation_validation"
tuple	UNSUPPORTED_WORKFLOW_BUNDLE_PATH
	WORKFLOW_CONTRACT_PATH = DEFAULT_OUTPUT_DIR / WORKFLOW_CONTRACT_ARTIFACT_FILENAME

Detailed Description

Validation: workflow interpretation guardrails.

Builds the workflow-interpretation layer from:
- the emitted workflow-contract bundle,
- the emitted end-to-end trace bundle,
- the emitted matrix baseline bundle,
- the emitted unsupported-workflow bundle,
- and the committed optional evidence bundle.

This layer is intentionally thin:
- it computes the main workflow claim only from mandatory complete supported
  evidence,
- it keeps optional evidence explicitly supplemental,
- it keeps unsupported/deferred evidence explicitly negative,
- and it treats missing mandatory evidence as incomplete rather than partial
  success.

Run with:
python benchmarks/density_matrix/workflow_evidence/workflow_interpretation_validation.py

Function Documentation

_load_end_to_end_trace_bundle()

def workflow_interpretation_validation._load_end_to_end_trace_bundle (   path )

private

Definition at line 106 of file workflow_interpretation_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

_load_json()

def workflow_interpretation_validation._load_json (   path )

private

Definition at line 93 of file workflow_interpretation_validation.py.

Here is the caller graph for this function:

_load_matrix_baseline_bundle()

def workflow_interpretation_validation._load_matrix_baseline_bundle (   path )

private

Definition at line 115 of file workflow_interpretation_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

_load_unsupported_workflow_bundle()

def workflow_interpretation_validation._load_unsupported_workflow_bundle (   path )

private

Definition at line 124 of file workflow_interpretation_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

_load_workflow_contract()

def workflow_interpretation_validation._load_workflow_contract (   path )

private

Definition at line 97 of file workflow_interpretation_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

build_artifact_bundle()

def workflow_interpretation_validation.build_artifact_bundle	(		workflow_contract,
			end_to_end_trace_bundle,
			matrix_baseline_bundle,
			unsupported_workflow_bundle,
			optional_noise_bundle
	)

Definition at line 163 of file workflow_interpretation_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

build_requirement_metadata()

def workflow_interpretation_validation.build_requirement_metadata

(

workflow_contract

)

Definition at line 133 of file workflow_interpretation_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

main()

def workflow_interpretation_validation.main

(

)

Definition at line 433 of file workflow_interpretation_validation.py.

Here is the call graph for this function:

parse_args()

def workflow_interpretation_validation.parse_args

(

)

Definition at line 387 of file workflow_interpretation_validation.py.

Here is the caller graph for this function:

run_validation()

def workflow_interpretation_validation.run_validation

(

workflow_contract_path

)

Definition at line 344 of file workflow_interpretation_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

validate_artifact_bundle()

def workflow_interpretation_validation.validate_artifact_bundle

(

bundle

)

Definition at line 307 of file workflow_interpretation_validation.py.

Here is the caller graph for this function:

write_artifact_bundle()

def workflow_interpretation_validation.write_artifact_bundle

(

output_path

)

Definition at line 334 of file workflow_interpretation_validation.py.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

ARTIFACT_CORE_FIELDS

tuple workflow_interpretation_validation.ARTIFACT_CORE_FIELDS

Initial value:

=  (
    "suite_name",
    "status",
    "workflow_id",
    "contract_version",
    "backend",
    "reference_backend",
    "requirements",
    "thresholds",
    "software",
    "provenance",
    "summary",
    "required_artifacts",
)

Definition at line 77 of file workflow_interpretation_validation.py.

ARTIFACT_FILENAME

string workflow_interpretation_validation.ARTIFACT_FILENAME = "workflow_interpretation_bundle.json"

Definition at line 61 of file workflow_interpretation_validation.py.

DEFAULT_OUTPUT_DIR

workflow_interpretation_validation.DEFAULT_OUTPUT_DIR = WORKFLOW_EVIDENCE_OUTPUT_DIR

Definition at line 62 of file workflow_interpretation_validation.py.

END_TO_END_TRACE_BUNDLE_PATH

workflow_interpretation_validation.END_TO_END_TRACE_BUNDLE_PATH = DEFAULT_OUTPUT_DIR / END_TO_END_TRACE_ARTIFACT_FILENAME

Definition at line 64 of file workflow_interpretation_validation.py.

MATRIX_BASELINE_BUNDLE_PATH

workflow_interpretation_validation.MATRIX_BASELINE_BUNDLE_PATH = DEFAULT_OUTPUT_DIR / MATRIX_BASELINE_ARTIFACT_FILENAME

Definition at line 65 of file workflow_interpretation_validation.py.

OPTIONAL_NOISE_BUNDLE_PATH

tuple workflow_interpretation_validation.OPTIONAL_NOISE_BUNDLE_PATH

Initial value:

=  (
    REPO_ROOT
    / "benchmarks"
    / "density_matrix"
    / "artifacts"
    / "noise_support"
    / "optional_noise_classification_bundle.json"
)

Definition at line 69 of file workflow_interpretation_validation.py.

REPO_ROOT

workflow_interpretation_validation.REPO_ROOT = Path(__file__).resolve().parents[3]

Definition at line 30 of file workflow_interpretation_validation.py.

SUITE_NAME

string workflow_interpretation_validation.SUITE_NAME = "workflow_interpretation_validation"

Definition at line 60 of file workflow_interpretation_validation.py.

UNSUPPORTED_WORKFLOW_BUNDLE_PATH

tuple workflow_interpretation_validation.UNSUPPORTED_WORKFLOW_BUNDLE_PATH

Initial value:

=  (
    DEFAULT_OUTPUT_DIR / UNSUPPORTED_WORKFLOW_ARTIFACT_FILENAME
)

Definition at line 66 of file workflow_interpretation_validation.py.

WORKFLOW_CONTRACT_PATH

workflow_interpretation_validation.WORKFLOW_CONTRACT_PATH = DEFAULT_OUTPUT_DIR / WORKFLOW_CONTRACT_ARTIFACT_FILENAME

Definition at line 63 of file workflow_interpretation_validation.py.