PtcRunner.Lisp.Prelude.Bundle (PtcRunner v0.13.0)

Copy Markdown View Source

Deterministic source-level composition for selected capability preludes.

This is the selection-only helper for live prelude evolution. It does not introduce storage or version policy: callers pass source-bearing selection maps, the helper validates each component, rejects duplicate namespaces, concatenates the sources in selection order, and compiles the aggregate source once into the normal %PtcRunner.Lisp.Prelude{} artifact accepted by Lisp.run/2.

Summary

Types

component()
origin()
selection()

Functions

compile(selections)

Compiles selected prelude sources into one frozen prelude artifact.

Types

component()

@type component() :: %{
  id: String.t() | nil,
  version: pos_integer() | nil,
  checksum: String.t() | nil,
  source_hash: String.t(),
  namespaces: [String.t()],
  origin: String.t() | nil
}

origin()

@type origin() :: String.t() | atom() | {:file, Path.t()} | {:memory, term()} | nil

selection()

@type selection() ::
  %{
    :source => String.t(),
    optional(:id) => String.t(),
    optional(:version) => pos_integer(),
    optional(:checksum) => String.t(),
    optional(:origin) => origin()
  }
  | map()

Functions

compile(selections)

@spec compile([selection()]) ::
  {:ok, PtcRunner.Lisp.Prelude.t()}
  | {:error, PtcRunner.Lisp.Prelude.ValidationError.t()}

Compiles selected prelude sources into one frozen prelude artifact.

Source order is preserved. Duplicate namespace ids fail closed before the aggregate compile. Component provenance is stored in prelude.metadata and exposed by PtcRunner.Lisp.Prelude.trace_summary/1.