aprender-contracts 0.34.0

Papers to Math to Contracts in Code — YAML contract parsing, validation, scaffold generation, and Kani harness codegen for provable Rust kernels
Documentation
    use super::*;
    use crate::schema::parse_contract_str;

    #[test]
    fn empty_kani_obligation_is_error() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "Empty kani obl"
  references:
    - "Paper"
equations:
  f:
    formula: "f(x) = x"
kani_harnesses:
  - id: KANI-001
    obligation: ""
    bound: 8
falsification_tests: []
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        assert!(violations.iter().any(|v| v.rule == "SCHEMA-011"));
    }

    #[test]
    fn kernel_contract_without_kani_is_error() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "Missing kani"
  references:
    - "Paper"
equations:
  f:
    formula: "f(x) = x"
proof_obligations:
  - type: invariant
    property: "output is finite"
falsification_tests:
  - id: FALSIFY-001
    rule: "finiteness"
    prediction: "finite"
    if_fails: "overflow"
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        assert!(
            violations.iter().any(|v| v.rule == "PROVABILITY-001"),
            "Kernel contract without kani_harnesses must fail PROVABILITY-001"
        );
    }

    #[test]
    fn registry_contract_without_kani_is_ok() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "Data registry"
  registry: true
  references:
    - "Internal"
equations:
  lookup:
    formula: "f(key) = table[key]"
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        assert!(
            !violations.iter().any(|v| v.rule == "PROVABILITY-001"),
            "Registry contract should be exempt from provability invariant"
        );
    }

    #[test]
    fn kernel_with_fewer_tests_than_obligations_is_error() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "Imbalanced"
  references:
    - "Paper"
equations:
  f:
    formula: "f(x) = x"
proof_obligations:
  - type: invariant
    property: "prop1"
  - type: bound
    property: "prop2"
falsification_tests:
  - id: FALSIFY-001
    rule: "test"
    prediction: "works"
    if_fails: "broken"
kani_harnesses:
  - id: KANI-001
    obligation: "prop1"
    bound: 8
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        assert!(
            violations
                .iter()
                .any(|v| v.rule == "PROVABILITY-001"
                    && v.message.contains("falsification_tests")),
            "Fewer falsification tests than obligations must fail PROVABILITY-001"
        );
    }

    #[test]
    fn no_qa_gate_is_warning() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "No qa gate"
  references:
    - "Paper"
equations:
  f:
    formula: "f(x) = x"
falsification_tests: []
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        assert!(violations.iter().any(|v| v.rule == "SCHEMA-013"));
    }

    #[test]
    fn requires_only_valid_on_postcondition() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "Bad requires"
  references: ["Paper"]
equations:
  f:
    formula: "f(x) = x"
proof_obligations:
  - type: invariant
    property: "test"
    requires: "PRE-001"
falsification_tests: []
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        assert!(violations.iter().any(|v| v.rule == "SCHEMA-014"));
    }

    #[test]
    fn applies_to_phase_only_valid_on_loop_types() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "Bad applies_to_phase"
  references: ["Paper"]
equations:
  f:
    formula: "f(x) = x"
proof_obligations:
  - type: bound
    property: "test"
    applies_to_phase: "find_max"
falsification_tests: []
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        assert!(violations.iter().any(|v| v.rule == "SCHEMA-015"));
    }

    #[test]
    fn parent_contract_only_valid_on_subcontract() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "Bad parent_contract"
  references: ["Paper"]
equations:
  f:
    formula: "f(x) = x"
proof_obligations:
  - type: equivalence
    property: "test"
    parent_contract: "parent-v1"
falsification_tests: []
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        assert!(violations.iter().any(|v| v.rule == "SCHEMA-016"));
    }

    #[test]
    fn parent_contract_must_be_in_depends_on() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "Missing depends_on"
  references: ["Paper"]
equations:
  f:
    formula: "f(x) = x"
proof_obligations:
  - type: subcontract
    property: "refines parent"
    parent_contract: "not-in-depends-on"
falsification_tests: []
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        assert!(violations.iter().any(|v| v.rule == "SCHEMA-017"));
    }

    #[test]
    fn valid_dbc_fields_pass_validation() {
        let yaml = r#"
metadata:
  version: "1.0.0"
  description: "Valid DbC"
  references: ["Meyer (1997)"]
  depends_on: ["parent-v1"]
equations:
  f:
    formula: "f(x) = x"
proof_obligations:
  - type: postcondition
    property: "output bounded"
    requires: "PRE-001"
  - type: loop_invariant
    property: "max tracks"
    applies_to_phase: "find_max"
  - type: subcontract
    property: "refines parent"
    parent_contract: "parent-v1"
falsification_tests:
  - id: F-001
    rule: "test"
    prediction: "test"
    if_fails: "test"
  - id: F-002
    rule: "test"
    prediction: "test"
    if_fails: "test"
  - id: F-003
    rule: "test"
    prediction: "test"
    if_fails: "test"
kani_harnesses:
  - id: K-001
    obligation: "O-001"
    bound: 8
qa_gate:
  id: QA-001
  name: "Test"
  pass_criteria: "all pass"
"#;
        let contract = parse_contract_str(yaml).unwrap();
        let violations = validate_contract(&contract);
        // Should have no SCHEMA-014/015/016/017 errors
        let dbc_errors: Vec<_> = violations
            .iter()
            .filter(|v| {
                v.rule == "SCHEMA-014"
                    || v.rule == "SCHEMA-015"
                    || v.rule == "SCHEMA-016"
                    || v.rule == "SCHEMA-017"
            })
            .collect();
        assert!(dbc_errors.is_empty(), "unexpected DbC errors: {dbc_errors:?}");
    }