bzh.herve.atmot.defs

jeremy.herve.bzh

Documentation

dailyStats object

Aggregate statistics for one (lang, puzzleNumber), computed in the browser. Counts are read live from Constellation and never stored on any record.

Properties

averageGuesses integer Optional

Average winning guess count, scaled by 100 (integer to avoid float ambiguity); e.g. 412 means 4.12. Absent when there are no solvers.

lang string language Required

Language series.

players integer Required

Distinct DIDs that recorded a result for this puzzle.

minimum: 0
puzzleNumber integer Required

Per-language puzzle index.

minimum: 1
solvers integer Optional

How many of those players solved it.

minimum: 0
View raw schema
{
  "type": "object",
  "required": [
    "lang",
    "puzzleNumber",
    "players"
  ],
  "properties": {
    "lang": {
      "type": "string",
      "format": "language",
      "description": "Language series."
    },
    "players": {
      "type": "integer",
      "minimum": 0,
      "description": "Distinct DIDs that recorded a result for this puzzle."
    },
    "solvers": {
      "type": "integer",
      "minimum": 0,
      "description": "How many of those players solved it."
    },
    "puzzleNumber": {
      "type": "integer",
      "minimum": 1,
      "description": "Per-language puzzle index."
    },
    "averageGuesses": {
      "type": "integer",
      "description": "Average winning guess count, scaled by 100 (integer to avoid float ambiguity); e.g. 412 means 4.12. Absent when there are no solvers."
    },
    "guessDistribution": {
      "type": "array",
      "items": {
        "ref": "bzh.herve.atmot.stats#guessBucket",
        "type": "ref"
      },
      "maxLength": 6,
      "description": "Histogram of winning guess counts across all solvers."
    }
  },
  "description": "Aggregate statistics for one (lang, puzzleNumber), computed in the browser. Counts are read live from Constellation and never stored on any record."
}
leaderboardEntry object

One aggregated row of a daily leaderboard, computed in the browser from result records discovered via Constellation.

Properties

did string did Required

DID of the player.

guessCount integer Optional

Guesses used; present only when solved.

minimum: 1maximum: 6
handle string handle Optional

Resolved handle of the player, if available.

solved boolean Required

Whether the player solved the puzzle.

View raw schema
{
  "type": "object",
  "required": [
    "did",
    "solved"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "DID of the player."
    },
    "handle": {
      "type": "string",
      "format": "handle",
      "description": "Resolved handle of the player, if available."
    },
    "solved": {
      "type": "boolean",
      "description": "Whether the player solved the puzzle."
    },
    "guessCount": {
      "type": "integer",
      "maximum": 6,
      "minimum": 1,
      "description": "Guesses used; present only when solved."
    }
  },
  "description": "One aggregated row of a daily leaderboard, computed in the browser from result records discovered via Constellation."
}
resultView object

Client-side view of one player's result, assembled in the browser after reading records (there is no server implementing query lexicons in v1).

Properties

did string did Required

DID of the player who recorded this result.

guessCount integer Optional

Guesses used; present only when solved.

minimum: 1maximum: 6
handle string handle Optional

Resolved handle of the player, if available.

lang string language Required

Language series of the puzzle.

puzzleNumber integer Required

Per-language puzzle index.

minimum: 1
solved boolean Required

Whether the player solved the puzzle.

View raw schema
{
  "type": "object",
  "required": [
    "did",
    "lang",
    "puzzleNumber",
    "solved"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "DID of the player who recorded this result."
    },
    "lang": {
      "type": "string",
      "format": "language",
      "description": "Language series of the puzzle."
    },
    "handle": {
      "type": "string",
      "format": "handle",
      "description": "Resolved handle of the player, if available."
    },
    "solved": {
      "type": "boolean",
      "description": "Whether the player solved the puzzle."
    },
    "guessCount": {
      "type": "integer",
      "maximum": 6,
      "minimum": 1,
      "description": "Guesses used; present only when solved."
    },
    "puzzleNumber": {
      "type": "integer",
      "minimum": 1,
      "description": "Per-language puzzle index."
    }
  },
  "description": "Client-side view of one player's result, assembled in the browser after reading records (there is no server implementing query lexicons in v1)."
}

Lexicon Garden

@