Skip to content

Artifacts

culsma run writes staged JSON artifacts into the output directory.

FileProducerMeaning
summary.jsonCLI summaryCounts and run status.
ast.jsonparser/frontendParsed source program.
ir.jsoncompilerCanonical IR.
validate.jsonsemantic validatorSemantic diagnostics.
typecheck.jsontypecheckerType and unit diagnostics.
plan.jsonplan loweringExecutable plan.
run.jsonruntimeRuntime state, events, diagnostics, and user result.
output.jsonCLI run outputMachine-readable returns plus derived report.
result.jsonreport projectionDerived lab_report_v1 report summary.

The exact content of these files is intended for inspection and reproducibility. Source language authoring uses .culs files, not generated IR or plan JSON.

output.json uses culsma_run_output_v1. Its top-level returns field is the protocol return value surface; its report field is the derived lab_report_v1 execution report.

Minimal Run Output

For examples/minimal/public_minimal.culs, the verified run reports:

FieldValue
headlineExperiment completed successfully with no runtime errors.
completed steps5
mutation steps1
final productTarget
final product volume5.0uL
primary componentBUF01
touched containersSource, Target

The terminal and output.json return the protocol output separately:

text
return:
  Target (tube)
    volume: 5 uL
    mass: 5 mg
    components:
      BUF01: 5

The result.json report is a derived projection over runtime state and events. It is not a replacement for the source protocol, the protocol return, or the execution plan.

Released under the Apache-2.0 license.