Skip to content

Investigate cross-category merge (atoms + specs/proofs into one file) #3

@astefano

Description

@astefano

Context

The probe merge command currently enforces that all inputs belong to the same schema category (atoms, specs, or proofs). Mixing categories produces an error.

Question

Would it be useful to allow merging atoms with specs and/or proofs into a single file? Potential use cases:

  • A single "enriched" merged file containing the full call graph (atoms) alongside specification metadata (specs) and verification results (proofs) for the same code-names.
  • Simplifying downstream consumption by having one file instead of three separate merged files.

Considerations

  • The data dictionary values have different schemas per category (atoms have display-name, dependencies, etc.; specs have specified, has_requires, etc.; proofs have verified, status, etc.). Merging them into one dictionary would require either separate top-level keys ("atoms", "specs", "proofs") or a union schema per entry.
  • probe-lean/enriched-atoms already combines atoms with spec/proof data at the per-entry level. Cross-category merge might overlap with or duplicate that pattern.
  • The current same-category enforcement is a simple safety check that prevents accidental misconfiguration.

Decision needed

Decide whether cross-category merge should be supported and, if so, what the output schema should look like.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions