Record contract anarchy.fish/metric-record/v1

Schema, examples, and sources

One bounded JSON object can be explained locally. This contract accepts documentation examples only; it does not validate, receive, or publish live observations.

Required fields 9 exact keys

Every field has one job.

Field	Type	Meaning
`schemaVersion`	string	Exact schema identifier; this release accepts anarchy.fish/metric-record/v1 only.
`recordType`	string	Must be example in this local inspector; live observation claims are not accepted.
`metricId`	string	Stable metric identifier matching one definition in the published register.
`windowStart`	ISO 8601 string	Inclusive start of the illustrative aggregation window, including a time-zone offset.
`windowEnd`	ISO 8601 string	Exclusive end of the illustrative aggregation window, after windowStart.
`value`	number or bounded object	Illustrative schema value; never interpreted as a current server measurement.
`unit`	string	Unit declared by the selected metric definition and checked for an exact match.
`privacyClass`	string	Privacy class declared by the metric definition and checked for an exact match.
`sourceRef`	string	Provenance reference; the local inspector accepts bundled-example only.

Fail-closed boundary

Identifying fields are rejected.

The inspector walks nested keys as well as the top level. A matching field fails the whole object; it is not redacted and quietly accepted.

username
uuid
ipAddress
coordinates
chat
privateMessage
inventory
trajectory

Read why each class exists.

Bundled examples fictional documentation values

Examples are not measurements.

These objects exist only to show the schema shape and exercise the local inspector. They are not telemetry and make no claim about a server, a player count, or uptime.

Bundled example — tick-duration band

Fictional documentation values only. This record is not telemetry and says nothing about a server.

{
  "schemaVersion": "anarchy.fish/metric-record/v1",
  "recordType": "example",
  "metricId": "metric:tick-duration-band",
  "windowStart": "2026-07-18T18:00:00Z",
  "windowEnd": "2026-07-18T18:15:00Z",
  "value": {
    "lower": 18,
    "upper": 24
  },
  "unit": "milliseconds",
  "privacyClass": "aggregate-window",
  "sourceRef": "bundled-example"
}

Bundled example — protocol-family share

Fictional category values only. This record is not telemetry and says nothing about a server.

{
  "schemaVersion": "anarchy.fish/metric-record/v1",
  "recordType": "example",
  "metricId": "metric:protocol-family-share",
  "windowStart": "2026-07-18T18:00:00Z",
  "windowEnd": "2026-07-18T18:15:00Z",
  "value": {
    "exampleFamilyA": 0.75,
    "remainder": 0.25
  },
  "unit": "proportion",
  "privacyClass": "suppressed-breakdown",
  "sourceRef": "bundled-example"
}

Source ledger last modified 2026-07-18

Provenance stays attached.

anarchy.fish methodology — bounded aggregate records: Property-local method statement maintained with this register.; register-methodology · published · 2026-07-18
anarchy.fish privacy rules — public-record boundary: Property-local exclusions and publication rules maintained with this register.; privacy-rules · published · 2026-07-18
Bundled documentation example: Fictional values authored only to demonstrate the local record schema.; bundled-example · example · 2026-07-18