Przejdź do treści

Adapter Artifact v1

Source schema: doc/schemas/adapter-artifact.v1.schema.json

Machine-readable schema for adapter-first specialization artifacts and their deployment-facing provenance.

Governing Basis

Project Lineage

Requirements

Stories

Fields

Field Required Shape Description
schema/v yes const: 1 Schema version.
adapter/id yes string Stable identifier of the adapter artifact.
job/id yes string TrainingJob identifier that produced the adapter.
base-model/ref yes string Immutable base model on top of which the adapter applies.
adapter/hash yes string Hash or equivalent immutable content identifier of the adapter payload.
eval-report/ref yes string Reference to evaluation results that justify deployment or rejection.
deployment/scope yes enum: private, federation-local, public Intended deployment visibility of the adapter artifact.
rollback/ref yes string Reference to rollback path, previous adapter, or disable artifact.
creator/refs yes array Creators or contributors that should remain attributable in downstream use.
status no enum: validated, deployed, rejected, revoked Current artifact lifecycle status.
model-card/ref no string Reference to model card or equivalent manifest describing intended use and risks.
created-at no string Artifact creation timestamp.
policy_annotations no object Optional implementation-local annotations that do not change the core adapter semantics.

Conditional Rules

Rule 1

When:

{
  "properties": {
    "status": {
      "enum": [
        "deployed",
        "validated"
      ]
    }
  },
  "required": [
    "status"
  ]
}

Then:

{
  "required": [
    "model-card/ref",
    "created-at"
  ]
}

Field Semantics

schema/v

  • Required: yes
  • Shape: const: 1

Schema version.

adapter/id

  • Required: yes
  • Shape: string

Stable identifier of the adapter artifact.

job/id

  • Required: yes
  • Shape: string

TrainingJob identifier that produced the adapter.

base-model/ref

  • Required: yes
  • Shape: string

Immutable base model on top of which the adapter applies.

adapter/hash

  • Required: yes
  • Shape: string

Hash or equivalent immutable content identifier of the adapter payload.

eval-report/ref

  • Required: yes
  • Shape: string

Reference to evaluation results that justify deployment or rejection.

deployment/scope

  • Required: yes
  • Shape: enum: private, federation-local, public

Intended deployment visibility of the adapter artifact.

rollback/ref

  • Required: yes
  • Shape: string

Reference to rollback path, previous adapter, or disable artifact.

creator/refs

  • Required: yes
  • Shape: array

Creators or contributors that should remain attributable in downstream use.

status

  • Required: no
  • Shape: enum: validated, deployed, rejected, revoked

Current artifact lifecycle status.

model-card/ref

  • Required: no
  • Shape: string

Reference to model card or equivalent manifest describing intended use and risks.

created-at

  • Required: no
  • Shape: string

Artifact creation timestamp.

policy_annotations

  • Required: no
  • Shape: object

Optional implementation-local annotations that do not change the core adapter semantics.