bzh.herve.atmot.result Documentation (EN)

main record

An immutable record of one completed AT Mot daily puzzle, written to the player's own PDS. Write-once: no field may change after creation. The record key is deterministic, formatted as `<lang>-<puzzleNumber>` (e.g. `en-412`, `fr-7`), so each puzzle can be recorded at most once per account per language and re-solving cannot overwrite or spam. Stores tile colours only — never the answer or guessed letters — so index/firehose watchers cannot harvest answers and old records never spoil replays.

Record Key any Any valid record key

Properties

createdAt string datetime Required

When the player finished the puzzle and the record was created.

grid array of ref #gridRow Optional

The board as tile colours only, one element per guess row. Each element is an object (not a bare string) so context can be added later without a schema V2.

maxLength: 6 items

guessCount integer Optional

Number of guesses used. Present only when solved; absent on a loss (optional so a loss is representable without a sentinel value).

minimum: 1maximum: 6

lang string language Required

BCP-47 language of the puzzle series (e.g. `en`, `fr`). Each language is an independent daily series.

puzzleDate string datetime Required

UTC midnight datetime of the puzzle's calendar day.

puzzleNumber integer Required

Per-language puzzle index = whole UTC days since the shared epoch (2026-06-23), +1. Launch day = 1.

minimum: 1

puzzleTarget string uri Required

The canonical per-(lang,day) permalink `https://atmot.herve.bzh/p/<lang>/<puzzleNumber>`. This is the link the Constellation backlink index aggregates to build the leaderboard. It is deliberately a synthetic web URL, NOT a com.atproto.repo.strongRef, because the puzzle is not itself a network record — this is intentional, and is exactly what lets Constellation index it as a backlink target. Format is frozen and compared literally; emit it only via the app's shared helper.

solved boolean Required

Whether the player guessed the word within the allowed attempts.

View raw schema

{
  "key": "any",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "lang",
      "puzzleNumber",
      "puzzleDate",
      "solved",
      "puzzleTarget",
      "createdAt"
    ],
    "properties": {
      "grid": {
        "type": "array",
        "items": {
          "ref": "#gridRow",
          "type": "ref"
        },
        "maxLength": 6,
        "description": "The board as tile colours only, one element per guess row. Each element is an object (not a bare string) so context can be added later without a schema V2."
      },
      "lang": {
        "type": "string",
        "format": "language",
        "description": "BCP-47 language of the puzzle series (e.g. `en`, `fr`). Each language is an independent daily series."
      },
      "solved": {
        "type": "boolean",
        "description": "Whether the player guessed the word within the allowed attempts."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "When the player finished the puzzle and the record was created."
      },
      "guessCount": {
        "type": "integer",
        "maximum": 6,
        "minimum": 1,
        "description": "Number of guesses used. Present only when solved; absent on a loss (optional so a loss is representable without a sentinel value)."
      },
      "puzzleDate": {
        "type": "string",
        "format": "datetime",
        "description": "UTC midnight datetime of the puzzle's calendar day."
      },
      "puzzleNumber": {
        "type": "integer",
        "minimum": 1,
        "description": "Per-language puzzle index = whole UTC days since the shared epoch (2026-06-23), +1. Launch day = 1."
      },
      "puzzleTarget": {
        "type": "string",
        "format": "uri",
        "description": "The canonical per-(lang,day) permalink `https://atmot.herve.bzh/p/<lang>/<puzzleNumber>`. This is the link the Constellation backlink index aggregates to build the leaderboard. It is deliberately a synthetic web URL, NOT a com.atproto.repo.strongRef, because the puzzle is not itself a network record — this is intentional, and is exactly what lets Constellation index it as a backlink target. Format is frozen and compared literally; emit it only via the app's shared helper."
      }
    }
  },
  "description": "An immutable record of one completed AT Mot daily puzzle, written to the player's own PDS. Write-once: no field may change after creation. The record key is deterministic, formatted as `<lang>-<puzzleNumber>` (e.g. `en-412`, `fr-7`), so each puzzle can be recorded at most once per account per language and re-solving cannot overwrite or spam. Stores tile colours only — never the answer or guessed letters — so index/firehose watchers cannot harvest answers and old records never spoil replays."
}

gridRow object

One guess row, encoded as tile-state codes only (never the letters).

Properties

row string Required

Exactly five tile-state codes, one per column: `G` = correct (right letter, right spot), `Y` = present (right letter, wrong spot), `B` = absent (not in the word). Example: `BGYBB`.

maxLength: 5 bytesminLength: 5 bytes

View raw schema

{
  "type": "object",
  "required": [
    "row"
  ],
  "properties": {
    "row": {
      "type": "string",
      "maxLength": 5,
      "minLength": 5,
      "description": "Exactly five tile-state codes, one per column: `G` = correct (right letter, right spot), `Y` = present (right letter, wrong spot), `B` = absent (not in the word). Example: `BGYBB`."
    }
  },
  "description": "One guess row, encoded as tile-state codes only (never the letters)."
}