# Catalogue fields and scope

Snapshot: November 1, 2026.

`catalog.json` contains source register, grouped records and source listings. `catalog.csv` is the title/resource table; `files.csv` retains individual listings. `classification.csv` records included and excluded Mega and N-Gage 2.0 metadata rows, plus the included older collection description entries.

## Counts

{
  "game_title_records": 128,
  "resource_records": 19,
  "source_listings": 697,
  "classic_game_records": 79,
  "ngage2_game_records": 49,
  "recoveries": 8,
  "listings_by_source": {
    "mega": 541,
    "dance": 85,
    "classic": 70,
    "myabandonware": 1
  }
}

## Units

- A record groups a title or resource for browsing. Generation is part of its identity.
- A source listing is one included source file, one numbered description entry, or the owner-confirmed Pocket Kingdom edition reference. It is not necessarily a unique game, build or byte sequence.
- `classic` and `ngage2` preserve catalogue generation scope. No package runtime was tested.
- `area` distinguishes game title records from collection-wide tools, installers and resources. Game-specific manuals and tools can remain with their game.

## File fields

- `path`: exact Archive file path, older collection description member name, or recorded Pocket Kingdom original filename.
- `kind`, `tags`: editorial browsing classification and original labels. They do not authenticate the contents or establish compatibility. Parenthesized Mega labels, source folders, and clearly identified classic description notes are preserved.
- `basis`: identifies the evidence used for that row. Classic member-description rows have no independently listed member size or checksum.
- `size_bytes`: size reported for the external package, or null when unavailable. No local game bytes were measured.
- `source_hashes`: Archive-reported MD5, SHA-1 and CRC32 when supplied. No package hash was independently computed here.
- `file_url`: external Archive file URL constructed from the exact metadata path. Null for description-only members and the My Abandonware edition. The catalogue does not fetch these URLs.
- `source_url`: collection or title page.
- `listed_member_count`: Archive-reported contained-file count when present; no contents were fetched.
- `owner_confirmed_source`: present on the Pocket Kingdom row. Wakka confirmed My Abandonware as the historical source on November 1, 2026. This does not establish a newly compared byte match.

## Grouping

Known name variants are normalized explicitly, while source filenames remain intact. Examples include SonicN / Sonic N; Pocket Kingdom / Own the World; punctuation in Shadowkey; and expanded names such as Xanadu Next. Polish Rayman 3 and SSX labels remain attached to their original member rows. N-Gage 2.0 fixes with a clear title are attached to that title; generic fixes remain collection resources. Versions, region/build codes, Retail, AARU, demos, trials, QA and development labels are never discarded from their file rows.

N-Gage and N-Gage 2.0 names are not merged. Unclear title relationships remain separate rather than claiming interchangeability. Language is not inferred from a generic English title.

## Source snapshots

The source register records retrieval scope and SHA-256 fingerprints of the downloaded metadata documents. These fingerprints identify the metadata snapshot, not game packages. Raw metadata with uploader contact fields is kept out of the public site.

## Scope exclusions

No original games, firmware, SDK payloads, source archives, game artwork, private bridge implementations or checkpoints are bundled. The site contains catalogue data and original site presentation only. Source-site prose is not reproduced as game descriptions. Third-party ownership, credits and notices remain with their respective materials. No blanket license is added.

## Website links

The public upload is flat: index.html, site assets and catalogue tables sit at the repository root. Each record has a native fragment URL such as `index.html#record-classic-ashen`. The views are in the HTML; JavaScript enhances filters and opens direct file-record links. Modern browsers with CSS :has support provide the view layout.