[API Coherence] Report for 2026-03-19 — Re-Verification Pass (All ~20 API Families)

[github-actions[bot]]

Summary

This run performed a re-verification pass of all 16 open issues accumulated across 7 previous runs. No new C API additions were found since the last run (only one non-API bug-fix commit landed). All 16 issues remain unresolved.

• APIs analyzed so far: All ~20 major C API families (100% coverage)
• Total open issues: 16 (4 high, 9 medium, 4 low priority)
• Previously cached issues resolved: 0
• Languages checked: Java, .NET (C#), C++, Python, TypeScript/JS, OCaml, Go, Rust

---

Progress

• API families analyzed: ~20/~20 (100% of known families)
• Next steps: Monitor for new C API additions; focus on implementing fixes for high-priority issues

---

High Priority Issues

1. User Propagator API Missing in TypeScript/JS

What: The entire Z3_solver_propagate_* family (12 functions) is not exposed in TypeScript/JS.
Available in: Python (UserPropagatorBase in z3.py), Java (UserPropagator.java), .NET (UserPropagator.cs), Go (propagator.go — full implementation with UserPropagator struct)
Missing in: TypeScript/JS (src/api/js/src/high-level/ — no UserPropagator class), OCaml, Rust
Fix: Add a UserPropagator class to src/api/js/src/high-level/ mirroring Python's UserPropagatorBase. Bind via the existing Z3_solver_propagate_* C API bridge.
Verified: 2026-03-19 — grep -rn "UserPropagator" src/api/js/src/ returns nothing.

---

2. User Propagator API Missing in OCaml

What: None of the 12 Z3_solver_propagate_* functions have FFI bindings in z3native.ml.pre or high-level wrappers in z3.ml.
Available in: Python, Java, .NET, Go
Missing in: OCaml (src/api/ml/z3native.ml.pre — 0 matches for Z3_solver_propagate)
Fix: Add external solver_propagate_init, external solver_propagate_fixed, etc. to z3native.ml.pre; add a high-level UserPropagator module to z3.ml.
Verified: 2026-03-19 — grep -c "Z3_solver_propagate" src/api/ml/z3native.ml.pre returns 0.

---

3. User Propagator API Missing in Rust

What: The z3-sys crate has zero FFI bindings for Z3_solver_propagate_*, and the high-level z3 crate has no UserPropagator type.
Available in: Python, Java, .NET, Go
Missing in: Rust (/tmp/z3.rs/z3-sys/src/lib.rs — 0 matches for Z3_solver_propagate)
Fix: Add Z3_solver_propagate_init, Z3_solver_propagate_fixed, etc. to z3-sys/src/lib.rs; add a high-level UserPropagator<'ctx> wrapper in z3/src/. Note: requires the external repo prove-rs/z3.rs.
Verified: 2026-03-19 — grep -c "Z3_solver_propagate" /tmp/z3.rs/z3-sys/src/lib.rs returns 0.

---

4. OCaml RCF.inv Bug — Calls rcf_neg Instead of rcf_inv

What: src/api/ml/z3.ml line 2228 implements inv by calling Z3native.rcf_neg (negation) instead of Z3native.rcf_inv (multiplicative inverse). This is a copy-paste bug: inv silently returns the negation instead of the reciprocal.

(* z3.ml line 2227-2228 *)
let neg (ctx:context) (a:rcf_num) = Z3native.rcf_neg ctx a
let inv (ctx:context) (a:rcf_num) = Z3native.rcf_neg ctx a   (* BUG: should be rcf_inv *)

Fix: Change line 2228 to Z3native.rcf_inv ctx a.
Available correctly in: C API (Z3_rcf_inv), Java, .NET, C++, TypeScript
Verified: 2026-03-19 — grep -n "rcf_inv\|rcf_neg" src/api/ml/z3.ml confirms the bug.

---

Medium Priority Issues

5. Rust Missing Many Solver APIs

Missing from Rust z3 high-level crate (solver.rs):

• cube / Z3_solver_cube
• get_trail / Z3_solver_get_trail
• solve_for / Z3_solver_solve_for
• congruence_* / Z3_solver_congruence_*
• set_initial_value / Z3_solver_set_initial_value
• add_simplifier / Z3_solver_add_simplifier
• register_on_clause / Z3_solver_register_on_clause
• to_dimacs_string / Z3_solver_to_dimacs_string

Available in: Python, Java, .NET, C++, OCaml, Go, TypeScript
Verified: 2026-03-19

---

6. Rust Missing Sequence/String Operations

Missing from Rust z3/src/ast/ (seq.rs / string-related files):
extract (subsequence), replace, replace_all, replace_re, replace_re_all, is_prefix, is_suffix, index, last_index, map, mapi, foldl, foldli

z3-sys has the corresponding FFI bindings; only the high-level wrappers are absent.
Available in: Python, Java, .NET, C++, OCaml, Go, TypeScript
Verified: 2026-03-19

---

7. Rust Missing Algebraic Number Operations

Missing from Rust z3 high-level Algebraic type: le, ge (Z3_algebraic_le/ge in z3-sys), neq (Z3_algebraic_neq), roots (Z3_algebraic_roots), eval (Z3_algebraic_eval). Also get_poly and get_i are absent from z3-sys entirely.
Available in: Python (AlgebraicNumRef), C++ (expr class)
Verified: 2026-03-19

---

8. Go Missing Global Parameter API

What: Z3_global_param_set, Z3_global_param_get, Z3_global_param_reset_all are not wrapped in Go.
Available in: Python (set_param, get_param, reset_params), Java, .NET, TypeScript, OCaml, Rust (z3-sys)
Missing in: Go (src/api/go/z3.go and others — 0 matches)
Fix: Add SetGlobalParam(key, value string), GetGlobalParam(key string) (string, bool), ResetAllGlobalParams() to src/api/go/z3.go.
Verified: 2026-03-19

---

9. Incremental Parser Context API Missing in Most Languages

What: Z3_parser_context_new, Z3_parser_context_add_sort, Z3_parser_context_add_decl, Z3_parser_context_from_string allow incremental SMT-LIB2 parsing with pre-declared sorts and functions.
Available in: Python (ParserContext class in z3.py)
Missing in: Java, .NET, Go, TypeScript, Rust, OCaml (none expose a high-level ParserContext)
Fix: Add ParserContext class/struct to each binding.
Verified: 2026-03-19 — grep -n "parser_context\|ParserContext" src/api/java/Context.java returns nothing.

---

10. Go Missing Standalone ParseSmtlib2 (Returns ASTVector)

What: Go has Solver.FromString (asserts directly) but lacks the Z3_parse_smtlib2_string / Z3_parse_smtlib2_file API that returns an ASTVector of parsed assertions.
Available in: Python (parse_smt2_string), Java, .NET, TypeScript, OCaml, Rust z3-sys
Missing in: Go (high-level), Rust high-level
Verified: 2026-03-19

---

11. Rust Fixedpoint Missing Several APIs

Missing from Rust z3/src/fixedpoint.rs:

• get_rules / Z3_fixedpoint_get_rules
• get_param_descrs / Z3_fixedpoint_get_param_descrs
• set_predicate_representation / Z3_fixedpoint_set_predicate_representation

Available in: Python, Java, .NET, C++, OCaml, Go, TypeScript
Verified: 2026-03-19

---

12. Go Missing Entire RCF (Real Closed Field) API

What: None of the 37 Z3_rcf_* functions are wrapped in Go.
Available in: C, Java, .NET, C++, OCaml (full), TypeScript (partial), Rust z3-sys (23/37 functions)
Missing in: Go (entirely), Python (uses AlgebraicNumRef instead), Rust high-level (entirely)
Verified: 2026-03-19 — no rcf references in src/api/go/

---

13. Rust z3-sys Missing 14 RCF Functions

Missing from z3-sys/src/lib.rs (/tmp/z3.rs):
Z3_rcf_is_rational, Z3_rcf_is_algebraic, Z3_rcf_is_infinitesimal, Z3_rcf_is_transcendental, Z3_rcf_extension_index, Z3_rcf_transcendental_name, Z3_rcf_infinitesimal_name, Z3_rcf_num_coefficients, Z3_rcf_coefficient, Z3_rcf_interval, Z3_rcf_num_sign_conditions, Z3_rcf_sign_condition_sign, Z3_rcf_num_sign_condition_coefficients, Z3_rcf_sign_condition_coefficient

The high-level z3 crate has zero RCF wrappers regardless.
Available in: C (full), OCaml (full), Java/C#/TypeScript (partial)
Verified: 2026-03-19

---

Low Priority Issues

14. Advanced RCF Inspection APIs Missing in Java, .NET, C++, TypeScript

The following Z3_rcf_* inspection/introspection functions are only fully wrapped in OCaml:
extension_index, transcendental_name, infinitesimal_name, num_coefficients, coefficient, interval, num_sign_conditions, sign_condition_sign, num_sign_condition_coefficients, sign_condition_coefficient

Available in: OCaml (src/api/ml/z3.ml — RCF module)
Missing in: Java, .NET, C++, TypeScript
Verified: 2026-03-19

---

15. Rust BV Missing repeat Operation

What: Z3_mk_repeat is in z3-sys/src/lib.rs but z3/src/ast/bv.rs has no repeat method.
Available in: Python (RepeatRef), C++ (z3++.h), Java, .NET, OCaml, TypeScript, Go
Missing in: Rust high-level
Fix: Add pub fn repeat(&self, i: u32) -> BV<'ctx> to z3/src/ast/bv.rs.
Verified: 2026-03-19 — grep -n "repeat" /tmp/z3.rs/z3/src/ast/*.rs returns nothing.

---

16. OCaml Algebraic Number API Very Limited

What: OCaml Arithmetic.AlgebraicNumber only exposes to_upper/to_lower (bound queries). All arithmetic (add, sub, mul, div, root, power) and comparison (lt, gt, le, ge, eq, neq, roots, eval) operations from the C API are absent.
Available in: Python (AlgebraicNumRef — full), Rust (Algebraic — partial), C++ (expr class)
Missing in: OCaml
Verified: 2026-03-19

---

17. Rust Tactic Missing Parallel Combinators

Missing from Rust z3/src/tactic.rs:
par_or (parallel OR), par_and_then (parallel AND-THEN), fail_if_not_decided

Available in: Python, Java, .NET, C++, OCaml, Go, TypeScript
Verified: 2026-03-19

---

Prioritized Action Items

#	Priority	Issue	Effort
4	🔴 High	Fix OCaml RCF.inv bug (1-line fix: change rcf_neg → rcf_inv in z3.ml:2228)	Trivial
1–3	🔴 High	Add User Propagator API to TypeScript, OCaml, Rust	Large
15	🟡 Low	Add repeat to Rust BV	Trivial
8	🟠 Medium	Add SetGlobalParam/GetGlobalParam/ResetAllGlobalParams to Go	Small
5	🟠 Medium	Add missing Solver methods to Rust (cube, get_trail, etc.)	Medium
6	🟠 Medium	Add missing Seq/String methods to Rust	Medium
9	🟠 Medium	Add ParserContext to Java, .NET, Go, TypeScript, Rust, OCaml	Large
10	🟠 Medium	Add ParseSmtlib2String returning AST vector to Go and Rust	Small
11	🟠 Medium	Add missing Fixedpoint methods to Rust	Small
12–13	🟠 Medium	Add RCF API to Go; complete RCF in Rust z3-sys	Large

The single highest-leverage fix is Issue #4 (OCaml RCF.inv bug) — it's a one-character change that fixes silent wrong results.

AI generated by API Coherence Checker · history

• expires on Mar 26, 2026, 5:24 PM UTC

[github-actions[bot]]

This discussion has been marked as outdated by API Coherence Checker.

A newer discussion is available at Discussion #9060.