ArtifactProvenance

@forge/monorepo

---

@forge/monorepo / backend/src / ArtifactProvenance

Type Alias: ArtifactProvenance

ArtifactProvenance = object

Defined in: backend/src/persistence/index.ts:899

Where a version came from — AC-3.

Required on every version, not optional. A reader asking "where did this number come from" is the whole reason artifacts exist as first-class objects, and provenance that can be absent is provenance that will be, on the version someone eventually asks about.

Properties

inputs

readonly inputs: Readonly<Record<string, unknown>>

Defined in: backend/src/persistence/index.ts:911

The inputs it was produced from.

Stored as JSON, and deliberately the normalised input rather than the model's prose request: a regeneration that produced a different result should be explicable by comparing these, and free text does not compare.

---

producedBy

readonly producedBy: string

Defined in: backend/src/persistence/index.ts:903

The tool or agent that produced it, by name.

---

runId?

readonly optional runId?: RunId

Defined in: backend/src/persistence/index.ts:901

The run that produced it. Absent for an artifact a person created directly.

---

sourceFileIds?

readonly optional sourceFileIds?: readonly FileId[]

Defined in: backend/src/persistence/index.ts:913

Attachments the content was derived from, so a document's figures trace back to their source.