Skip to content

Add the user-properties property generator - #326

Merged
jar-ben merged 1 commit into
masterfrom
jaroslav/user-properties-generator
Nov 20, 2026
Merged

jar-ben merged 1 commit into
masterfrom
jaroslav/user-properties-generator

Conversation

@jar-ben

@jar-ben jar-ben commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator

Problem

A run's properties come from the native inference, a recorded property_set.json, or a
generator in another package. None of them takes properties a person wrote. A recorded set
cannot stand in: it carries the analysed system model, and its components must match the units
rebuilt from that model, which a person's list does not have.

Fix

composer/pipeline/user_properties.py adds the user-properties generator, registered in
pyproject.toml. AUTOPROVER_USER_PROPERTIES names a properties file, relative to the project
root; the run takes the suite that file defines:

  • properties: each property's id (its title), description, sort (default
    safety_property) and optional group;
  • groups: each group's name and optional description;
  • imports: other properties files, relative to the importing file. A suite holds its own
    properties and those of every file it imports, transitively.

No model is called. The generator builds a minimal system model, the main contract with one
component per group (or Properties for ungrouped properties), and a property set that matches
it. Loading fails on a cycle of imports, an id two files of the suite define, and a group two
files describe differently.

PROPERTY_FILE_SUFFIX (.properties.json) names the convention for properties files.
PROPERTY_GENERATORS.md documents the generator and the format.

Testing

New tests/test_user_properties.py:

  • groups become components, in order;
  • the set rebuilds units the driver matches (main_instance, lift_unharnessed, EVM.units,
    match_units);
  • duplicate ids and groups are rejected;
  • the import closure, where a file reached twice counts once;
  • cycles, an id defined twice, and conflicting group descriptions are errors;
  • the environment variable.

The non-expensive suite passes.

The generator takes a run's properties from a person's *.properties.json suite
(AUTOPROVER_USER_PROPERTIES): each property's id, description, sort and group,
and the files the suite imports. It builds a minimal system model with one
component per group, and calls no model.
@jar-ben
jar-ben merged commit 7539be1 into master Nov 20, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant