Struct CodeArtifact 

pub struct CodeArtifact {
    pub id: String,
    pub language: String,
    pub repo_url: Option<String>,
    pub git_commit: Option<String>,
    pub path: String,
    pub line_range: Option<(u32, u32)>,
    pub content_hash: String,
    pub entry_point: Option<String>,
    pub created: String,
}

v0.33: CodeArtifact as a first-class kernel object.

A CodeArtifact is a content-addressed pointer at a specific region of source code (a function, a notebook cell, a script, a pipeline step) at a specific git commit. Before v0.33, code was captured as a string in Evidence.method — “we ran a logistic regression” — with no way for a reader to verify which code produced the result, or to re-run it.

vc_<id> is content-addressed over `repo_url + git_commit + path

• line_range + content_hash`. The same code at two commits gets two records (the relevant historical fact); the same code in two paths in the same repo also gets two records (location matters for re-execution).

Fields

id: String

vc_<16hex>, content-addressed; see CodeArtifact::content_address.

language: String

Source language: python / r / julia / rust / bash, etc. Not validated against a closed allow-list — code provenance should accept whatever language the analysis was actually in.

repo_url: Option<String>

Repository URL (e.g. https://github.com/vela-science/vela).

git_commit: Option<String>

Specific git commit (40-char SHA preferred). Required for reproducibility; None means “unpinned” and weakens the substrate claim.

path: String

Path within the repository (e.g. crates/vela-scientist/src/notes.rs).

line_range: Option<(u32, u32)>

Optional line range as (start, end), both inclusive.

content_hash: String

SHA-256 of the snippet body. Decouples the artifact from the repository’s external state — even if a repo is deleted, the content_hash remains anchored.

entry_point: Option<String>

Optional entry point: function name, notebook cell id, or __main__. Used by re-execution tooling.

created: String

RFC 3339 creation timestamp.

Implementations

impl CodeArtifact

pub fn content_address( repo_url: Option<&str>, git_commit: Option<&str>, path: &str, line_range: Option<(u32, u32)>, content_hash: &str, ) -> String

Compute the content-addressed ID per v0.33 spec: SHA-256(repo_url | git_commit | path | line_range | content_hash). Returns first 16 hex chars prefixed with “vc_”.

pub fn new( language: impl Into<String>, repo_url: Option<String>, git_commit: Option<String>, path: impl Into<String>, line_range: Option<(u32, u32)>, content_hash: impl Into<String>, entry_point: Option<String>, ) -> Self

Construct a new CodeArtifact with a freshly-derived id and created timestamp.

Trait Implementations

impl Clone for CodeArtifact

fn clone(&self) -> CodeArtifact

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CodeArtifact

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CodeArtifact

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CodeArtifact

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.