Przejdź do treści

Signal Marker v1

Source schema: doc/schemas/signal-marker.v1.schema.json

Machine-readable schema for visible signal markers that disclose whether a user-facing artifact preserves raw signal or presents a transformed variant.

Governing Basis

Fields

Field Required Shape Description
schema/v yes const: 1 Schema version.
marker_id yes string Stable identifier of this visible signal marker.
applies_to_ref yes string Stable reference to the message, segment, bundle, or other artifact annotated by this marker.
mode yes enum: raw, structured, transformed, redacted User-visible signal mode presented at the interface boundary.
actor yes enum: ai, human, hybrid Who materially shaped the visible output variant.
requested_by no enum: user, user_policy, safety_policy, exception
basis_ref no string Reference to the prompt, policy, rule, exception, or other basis authorizing the visible signal mode.
operations no array
visible_to_user yes boolean Whether the marker is intentionally surfaced in the same interface as the annotated artifact.
transform_ref no string Optional reference to a SignalTransformEvent that explains how the output variant was produced.
created_at no string
policy_annotations no object

Definitions

Definition Shape Description
operation enum: structure_extraction, summarization, translation, tone_shift, formality_shift, style_polish, safety_redaction, privacy_redaction

Conditional Rules

Rule 1

When:

{
  "properties": {
    "mode": {
      "const": "raw"
    }
  },
  "required": [
    "mode"
  ]
}

Then:

{
  "properties": {
    "operations": {
      "maxItems": 0
    }
  }
}

Rule 2

When:

{
  "properties": {
    "mode": {
      "enum": [
        "structured",
        "transformed",
        "redacted"
      ]
    }
  },
  "required": [
    "mode"
  ]
}

Then:

{
  "required": [
    "requested_by",
    "basis_ref",
    "operations"
  ],
  "properties": {
    "operations": {
      "minItems": 1
    },
    "visible_to_user": {
      "const": true
    }
  }
}

Field Semantics

schema/v

  • Required: yes
  • Shape: const: 1

Schema version.

marker_id

  • Required: yes
  • Shape: string

Stable identifier of this visible signal marker.

applies_to_ref

  • Required: yes
  • Shape: string

Stable reference to the message, segment, bundle, or other artifact annotated by this marker.

mode

  • Required: yes
  • Shape: enum: raw, structured, transformed, redacted

User-visible signal mode presented at the interface boundary.

actor

  • Required: yes
  • Shape: enum: ai, human, hybrid

Who materially shaped the visible output variant.

requested_by

  • Required: no
  • Shape: enum: user, user_policy, safety_policy, exception

basis_ref

  • Required: no
  • Shape: string

Reference to the prompt, policy, rule, exception, or other basis authorizing the visible signal mode.

operations

  • Required: no
  • Shape: array

visible_to_user

  • Required: yes
  • Shape: boolean

Whether the marker is intentionally surfaced in the same interface as the annotated artifact.

transform_ref

  • Required: no
  • Shape: string

Optional reference to a SignalTransformEvent that explains how the output variant was produced.

created_at

  • Required: no
  • Shape: string

policy_annotations

  • Required: no
  • Shape: object

Definition Semantics

$defs.operation

  • Shape: enum: structure_extraction, summarization, translation, tone_shift, formality_shift, style_polish, safety_redaction, privacy_redaction