One city. Multiple engines.

-- fxmanifest.lua of your resource:  dependency 'grift'
local s = exports.grift:getStatus()
print(s.mode, s.label)      --> recorded   RECORDED · GRIFT, 2026-11-09T19:26:16.918Z · plan day 996806
print(s.source)             --> bundled recording
print(s.residents)          --> 6168
print(s.cityTime)           --> 20:25
print(s.sites.market.present, s.sites.market.shown)   --> 1166   28
print(s.tally.home, s.tally.transit)                  --> 2123   219

local card = exports.grift:getResident(13)
if card then
  -- identity: GRIFT's record
  print(card.id, card.name, card.kindLabel)        --> 13   Marcus Ugarte   native resident
  print(card.job.name, card.district)              --> busker   Finance
  -- activity: what the census has it doing at this hour, and until when
  print(card.now.mode)                             --> arriving
  print(card.now.text)                             --> Arriving at LAST CALL (Tequi-la-la, West Vinewood).
  print(card.now.since, card.now['until'])         --> 20:14   20:28
  -- decision: 'plan' (its plan chose this), 'rota' (working hours) or nil (not a decision)
  print(card.now.decision, card.now.why)           --> plan   Drink's ten dollars, I'll have one.
  -- always show how fresh the record is, in the server's own words
  print(card.provenance.mode)                      --> recorded
end

local plan = exports.grift:getResident(13).plan
print(plan.aft.what, plan.aft.decided)     --> on shift at work (busker)   false
print(plan.aft.where)                      --> Vinewood Boulevard, by the Oriental Theater
print(plan.night.what, plan.night.decided) --> LAST CALL   true
print(plan.night.spend, plan.night.why)    --> 10   Drink's ten dollars, I'll have one.

local d = exports.grift:getResident(13).decision
if d.unknown then
  print(d.note)   -- "Who planned this ... is in the resident's trace. This server reads traces only for the few agents its gateway follows."
else
  print(d.by, d.label, d.outcome)          --> agent   GRIFT's planner model   kept
end

local bar = exports.grift:getSite('bar')   -- GRIFT's key for LAST CALL
print(bar.present, bar.shown)              --> 207   20
print(bar.counts.at, bar.counts.arriving)  --> 38   169

AddEventHandler('grift:visual:state', function(s)
  -- s.provenance = { mode, label }   s.hour = the city hour   s.sites[key] = { name, label, present, shown, ... }
  for _, e in ipairs(s.list) do
    -- e.id, e.ped, e.name, e.kind, e.jobName, e.hue, e.followed, e.site
    -- e.mode ('at' | 'arriving' | 'leaving' | 'stroll'), e.role, e.slot, e.decision, e.h0, e.h1
    if e.mode == 'arriving' and DoesEntityExist(e.ped) then
      -- e.ped is the local ped drawn for resident e.id, walking in to s.sites[e.site].name
    end
  end
end)

curl -s http://127.0.0.1:8791/healthz
# {"ok":true,"mode":"recorded"}

curl -s -o /dev/null -D - http://127.0.0.1:8791/v1/census/0 | grep -iE "^(HTTP|etag|cache-control)"
# HTTP/1.1 200 OK
# cache-control: public, max-age=60, stale-while-revalidate=180
# etag: "01781f5487b69fb289f23948f6b05c8a-0"

curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8791/v1/census/13    # past the last page
# 404
curl -s -o /dev/null -w "%{http_code}\n" -X POST http://127.0.0.1:8791/v1/census
# 405

// [id, name, kind, district, job, crew, cash, model, aft, night, schedule]
[13, "Marcus Ugarte", 0, 2, 2, 2, 9973.94, -1, [0, 9, 0, 0], [2, 3, 13, 10],
  [[6, 7.5, 0, 0, -1, -1, -1, -1], …, [20, 20.4757, 1, 3, 9, 0, 1, 0], [20.4757, 25, 2, 3, -1, 0, 1, 0], …]]

// aft, night:  [choice, place, why, spend]  -> indices into dict.choices, dict.places, dict.reasons
// a segment:   [h0, h1, kind, place, from, role, slot, decision]
//   [20, 20.4757, walk, to LAST CALL, from work (busker), guest, night, plan]
//   [20.4757, 25, at, LAST CALL, -, guest, night, plan]      hours past 24 are the small hours: 25 is 01:00

import { decodeResident, nowLine, presence, fmt } from '/js/gta/record.js';

const get = (path) => fetch('/docs/gta/' + path).then((r) => r.json());
const [head, { dict }, sites] = await Promise.all([get('census/head.json'), get('census/dict.json'), get('sites.json')]);
const places = Object.fromEntries(dict.places.map((p) => [p.key, p]));

// rows are in id order, 500 to a page; natives 0-5999 fill pages 0-11
const { residents } = await get('census/0.json');
const marcus = decodeResident(dict, residents.find((row) => row[0] === 13));

const now = nowLine(places, sites, marcus, 20.33);        // 20.33 is 20:19 on the city's clock
console.log(now.text);                                    // Arriving at LAST CALL (Tequi-la-la, West Vinewood).
console.log(now.decision, now.why);                       // plan  Drink's ten dollars, I'll have one.
console.log(fmt(presence(marcus, 20.33).h1));             // 20:28
console.log(head.provenance.label);                       // RECORDED · GRIFT, 2026-11-09T19:26:16.918Z · plan day 996806

{
  "contract": "grift.fivem.censuscheck/1",
  "writtenAt": "2026-11-09T23:25:40Z", "cityHour": 20.53…, "known": true,
  "provenance": { "mode": "recorded", "label": "RECORDED · GRIFT, 2026-11-09T19:26:16.918Z · plan day 996806" },
  "census": { "residents": 6168, "rosterEtag": "01781f5487b69fb289f23948f6b05c8a", "mode": "recorded",
    "source": { "url": "https://www.grift.world/api/city?view=world", "fetchedAt": "2026-11-09T19:26:17.736Z",
                "sha256": "ded227731a198382af5891efd651f18bb147925b45a270a0794168135c2ad720", "bytes": 968105 } },
  "runtime": { "lua": "LuaGLM 5.4", "server": "FXServer-master v1.0.0.38435 linux" },
  "tally": { "home": 3218, "transit": 156, "unmapped": 0, "unknown": 0, … },
  "sites": { "bar": { "present": …, "counts": { "at": …, "arriving": …, "leaving": …, "stroll": … }, "shown": [ … ], "castSize": 20, "staff": { … } }, … },
  "sample": [ { "id": 0, "name": "Anouk Stavrakakis", "kind": "native", "district": "Mid-rise", "job": "cleaner", "aft": { … }, "night": { … }, "presence": { … }, "followed": false, "decidedBy": false }, … ]
}

loading…

node fivem/tools/test.mjs
# PASS fivem check: 47 passed, 0 failed          static: the Lua parses, every native exists with that many arguments, GET only
# PASS fivem lua: 301 passed, 0 failed           the pure code, the gateway reader, server and client together, the film, the door
# PASS prooftest: 51 passed, 0 failed            proofs written by the server, checked by the verifier; every lie told to a copy caught
# PASS fivem lua: 13 passed, 0 failed            the same scripts against a real gateway process over HTTP
# PASS fivem: every suite passed

node fivem/tools/visual/test.mjs
# PASS visual check: 61 passed, 0 failed
# FAIL visual lua: 274 passed, 1 failed          one check of the trailer's take director

node agentbridge/test/censustest.mjs      # PASS censustest: 93 passed, 0 failed
node agentbridge/test/gatewaytest.mjs     # PASS gatewaytest: 166 passed, 0 failed