Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,16 @@
Release notes for Arda. The design ledger (decisions, stage records and per-change detail)
lives in `docs/capstone/changelog.md` and `docs/capstone/changelog.d/`.

## Unreleased

**API (`/v1`, additive)**

- `GET /v1/npc/occupations` lists every key `POST /v1/npc/generate` takes: 96 jobs and 21 offices, each with its kind (`job` or `office`), a label, a job's female label and category, and the tiers it is accepted in with its `SocialRank` in each. New schema `OccupationList` (family `npc_format`, unchanged at 1). Stable, in the contract kit as `npc-occupations`.

**Content changes (flagged per the versioning policy)**

- `GET /v1/schema` lists `OccupationList`. No other body changes.

## 1.1.1 — 2026-11-14

Dependency security updates. No API, format or content change from 1.1.0, which was tagged but not published; 1.1.1 is the first published release with the dungeon and cave sites described under 1.1.0.
Expand Down
232 changes: 232 additions & 0 deletions bindings/schema/OccupationList.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,232 @@
{
"$defs": {
"JobCategory": {
"description": "Broad kind of work.",
"oneOf": [
{
"const": "agriculture",
"description": "Fields and herds.",
"type": "string"
},
{
"const": "craft",
"description": "Workshops and trades.",
"type": "string"
},
{
"const": "trade",
"description": "Buying and selling.",
"type": "string"
},
{
"const": "service",
"description": "Inns, kitchens and households.",
"type": "string"
},
{
"const": "religion",
"description": "Clergy.",
"type": "string"
},
{
"const": "military",
"description": "Soldiers and watch.",
"type": "string"
},
{
"const": "government",
"description": "Officials.",
"type": "string"
},
{
"const": "maritime",
"description": "Boats and docks.",
"type": "string"
},
{
"const": "extraction",
"description": "Mines and forests.",
"type": "string"
},
{
"const": "scholar",
"description": "Books and teaching.",
"type": "string"
},
{
"const": "labour",
"description": "Unskilled work.",
"type": "string"
},
{
"const": "nobility",
"description": "Nobles.",
"type": "string"
},
{
"const": "dependent",
"description": "Children and the retired.",
"type": "string"
}
]
},
"Occupation": {
"description": "One key of the catalogue. `(kind, key)` is unique; `reeve`, `elder`,\n`harbourmaster` and others are both a job and an office.",
"properties": {
"category": {
"anyOf": [
{
"$ref": "#/$defs/JobCategory"
},
{
"type": "null"
}
],
"description": "A job's category; `null` for an office."
},
"key": {
"description": "The key `POST /v1/npc/generate` takes.",
"type": "string"
},
"kind": {
"$ref": "#/$defs/OccupationKind",
"description": "Job or office."
},
"label": {
"description": "Display label: a job's title, an office's title without its place.",
"type": "string"
},
"label_female": {
"description": "A job's female title where it differs; otherwise `null`.",
"type": [
"string",
"null"
]
},
"tiers": {
"description": "Tiers the key is accepted in, smallest first, with its rank in\neach. A job outside them is refused (`bad_request`).",
"items": {
"$ref": "#/$defs/OccupationTier"
},
"type": "array"
}
},
"required": [
"key",
"kind",
"label",
"tiers"
],
"type": "object"
},
"OccupationKind": {
"description": "Whether a key is a `job` or an `office` of `GenerateNpcRequest`.",
"oneOf": [
{
"const": "job",
"description": "An occupation: `GenerateNpcRequest.job`, `Npc.job.key`.",
"type": "string"
},
{
"const": "office",
"description": "A society office: `GenerateNpcRequest.office`.",
"type": "string"
}
]
},
"OccupationTier": {
"description": "A tier a key is accepted in, and the rank it carries there.",
"properties": {
"rank": {
"$ref": "#/$defs/SocialRank",
"description": "A job's social rank in the tier; for an office, the lowest rank of\nits holder there (a holder ranks at the higher of job and office)."
},
"tier": {
"$ref": "#/$defs/Tier",
"description": "Settlement size class (`GenerateNpcRequest.tier`)."
}
},
"required": [
"tier",
"rank"
],
"type": "object"
},
"SocialRank": {
"description": "Standing in local society.",
"oneOf": [
{
"const": "dependent",
"description": "Children and dependants.",
"type": "string"
},
{
"const": "labourer",
"description": "Labourers, hands and servants.",
"type": "string"
},
{
"const": "tradesfolk",
"description": "Journeymen, clerks and small traders.",
"type": "string"
},
{
"const": "master",
"description": "Masters, owners and minor officials.",
"type": "string"
},
{
"const": "gentry",
"description": "Clergy leads, officers and magistrates.",
"type": "string"
},
{
"const": "noble",
"description": "Lords and ladies.",
"type": "string"
}
]
},
"Tier": {
"description": "Settlement size class.",
"oneOf": [
{
"const": "hamlet",
"description": "Hamlet.",
"type": "string"
},
{
"const": "village",
"description": "Village.",
"type": "string"
},
{
"const": "town",
"description": "Town.",
"type": "string"
},
{
"const": "city",
"description": "City.",
"type": "string"
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "Body of `GET /v1/npc/occupations`: every key `POST /v1/npc/generate`\ntakes as `job` or `office`. Every job, then every office, each in key\norder; the same on every world (bundled data).",
"properties": {
"occupations": {
"description": "The catalogue.",
"items": {
"$ref": "#/$defs/Occupation"
},
"type": "array"
}
},
"required": [
"occupations"
],
"title": "OccupationList",
"type": "object"
}
9 changes: 9 additions & 0 deletions bindings/schema/index.json
Original file line number Diff line number Diff line change
Expand Up @@ -180,6 +180,15 @@
"stability": "stable",
"url": "/v1/schema/NpcPage.json"
},
{
"family": "npc_format",
"name": "OccupationList",
"routes": [
"GET /v1/npc/occupations"
],
"stability": "stable",
"url": "/v1/schema/OccupationList.json"
},
{
"family": "contract_version",
"name": "PointSample",
Expand Down
35 changes: 35 additions & 0 deletions bindings/ts/arda/Occupation.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { JobCategory } from "./JobCategory";
import type { OccupationKind } from "./OccupationKind";
import type { OccupationTier } from "./OccupationTier";

/**
* One key of the catalogue. `(kind, key)` is unique; `reeve`, `elder`,
* `harbourmaster` and others are both a job and an office.
*/
export type Occupation = {
/**
* The key `POST /v1/npc/generate` takes.
*/
key: string,
/**
* Job or office.
*/
kind: OccupationKind,
/**
* Display label: a job's title, an office's title without its place.
*/
label: string,
/**
* A job's female title where it differs; otherwise `null`.
*/
label_female: string | null,
/**
* A job's category; `null` for an office.
*/
category: JobCategory | null,
/**
* Tiers the key is accepted in, smallest first, with its rank in
* each. A job outside them is refused (`bad_request`).
*/
tiers: Array<OccupationTier>, };
6 changes: 6 additions & 0 deletions bindings/ts/arda/OccupationKind.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.

/**
* Whether a key is a `job` or an `office` of `GenerateNpcRequest`.
*/
export type OccupationKind = "job" | "office";
13 changes: 13 additions & 0 deletions bindings/ts/arda/OccupationList.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { Occupation } from "./Occupation";

/**
* Body of `GET /v1/npc/occupations`: every key `POST /v1/npc/generate`
* takes as `job` or `office`. Every job, then every office, each in key
* order; the same on every world (bundled data).
*/
export type OccupationList = {
/**
* The catalogue.
*/
occupations: Array<Occupation>, };
17 changes: 17 additions & 0 deletions bindings/ts/arda/OccupationTier.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
import type { SocialRank } from "./SocialRank";
import type { Tier } from "./Tier";

/**
* A tier a key is accepted in, and the rank it carries there.
*/
export type OccupationTier = {
/**
* Settlement size class (`GenerateNpcRequest.tier`).
*/
tier: Tier,
/**
* A job's social rank in the tier; for an office, the lowest rank of
* its holder there (a holder ranks at the higher of job and office).
*/
rank: SocialRank, };
4 changes: 4 additions & 0 deletions bindings/ts/arda/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,10 @@ export type { NpcEntry } from "./NpcEntry";
export type { NpcId } from "./NpcId";
export type { NpcPage } from "./NpcPage";
export type { ObscurementDto } from "./ObscurementDto";
export type { Occupation } from "./Occupation";
export type { OccupationKind } from "./OccupationKind";
export type { OccupationList } from "./OccupationList";
export type { OccupationTier } from "./OccupationTier";
export type { Personality } from "./Personality";
export type { PlacementDto } from "./PlacementDto";
export type { PointSample } from "./PointSample";
Expand Down
4 changes: 2 additions & 2 deletions contract-kit/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,7 @@ a changed image and its 304, an unreachable server).

## Cases

54 cases over 41 of the 42 stable routes of `docs/capstone/versioning.md`, at MICRO-42 places
61 cases over 48 of the 49 stable routes of `docs/capstone/versioning.md`, at MICRO-42 places
picked from the fixture: village 10
(Ifyil, realm 3), its cell (479, 1245), building 10.2, commoner `10.2.1`, the open-sea cell
(5, 5); the scene cases read town 2's cell (732, 1081), where notables stand by day and by
Expand All @@ -143,7 +143,7 @@ night, so the kit exercises token shapes.
| Battle map | `tactical-cell`, `tactical-scene-day`, `tactical-scene-night`, `tactical-cell-png` (+ `-304`), `tactical-cell-tile`, `tactical-window` (2 × 1), `tactical-window-png`, `tactical-window-tile` |
| Warm, bake, library | `tactical-prefetch`, `tactical-bake`, `tactical-bake-delete`, `tactical-library` |
| Dungeon | `dungeon`, `dungeon-png`, `dungeon-scene` |
| People | `npc-notable`, `npc-commoner-ref`, `npc-commoner-id`, `npcs`, `npcs-realm-job`, `building-residents`, `building-workers`, `npc-population`, `npc-generate` |
| People | `npc-notable`, `npc-commoner-ref`, `npc-commoner-id`, `npcs`, `npcs-realm-job`, `building-residents`, `building-workers`, `npc-population`, `npc-generate`, `npc-occupations` |
| Shapes | `schema-index`, `schema-file` |
| Errors | `error-no-block`, `error-out-of-range`, `error-npc-not-found`, `error-bad-request`, `error-bake-not-found` |

Expand Down
1 change: 1 addition & 0 deletions contract-kit/golden/npc-occupations.json

Large diffs are not rendered by default.

9 changes: 9 additions & 0 deletions contract-kit/golden/schema-index.json
Original file line number Diff line number Diff line change
Expand Up @@ -180,6 +180,15 @@
"stability": "stable",
"url": "/v1/schema/NpcPage.json"
},
{
"family": "npc_format",
"name": "OccupationList",
"routes": [
"GET /v1/npc/occupations"
],
"stability": "stable",
"url": "/v1/schema/OccupationList.json"
},
{
"family": "contract_version",
"name": "PointSample",
Expand Down
Loading
Loading