No description
  • TypeScript 92.2%
  • C++ 5.6%
  • Python 2.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Meta Vens 731ce08cfa Schema check: keys as the store relies on them, typed columns, per-table privileges
Soul pass 5, S5-1 and S5-2. checkSchema passed four databases the store
could not serve, and demanded privileges the store never uses.

Keys: every primary key and unique constraint, and each unique index the
schema creates by name, must stand as an immediate (not deferrable) unique
index whose key columns, counted by indnkeyatts and excluding INCLUDE
columns, are exactly the declared ones, with exactly the declared
predicate. A named index is checked by its name, so the partial attempt
index R21.1 depends on cannot be swapped for a plain or unpredicated one of
the same name. Predicates compare with case, parentheses and white space
removed, the form both the schema text and pg_get_expr reduce to.

Columns: each carries its declared type, compared as a type OID through
to_regtype.

Privileges: STORE_TABLE_PRIVILEGES in postgres.ts says what the store's
statements do to each table. audit_events needs INSERT only;
capability_grants and private_command_receipts need no UPDATE; nothing
needs DELETE. REQUIRED_TABLE_PRIVILEGES and REQUIRED_TABLES are gone.

The live block now proves the map both ways against a real Postgres: a
role granted exactly the map starts and runs every store operation (the
test checks it called every method), and for each privilege in the map,
a role granted all but that one is refused at startup and fails the same
workload with 42501. Each damage Soul found (a DEFERRABLE key, an INCLUDE
key, the attempt index replaced by a plain one of the same name, a retyped
column), plus an expression-widened key, an unpredicated or re-predicated
attempt index, is refused; a key index with extra INCLUDE columns starts.
Every refusal also proves its store left no connection open (tagged by
application_name), on the no-apply, apply and 42501 paths. Cases clone a
template database and the block has a 120 s budget, instead of building
the schema per case under the 5 s default that timed out.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 18:55:45 +02:00
.voidbot/state Seed Heimdall social interpretation biases 2026-05-24 20:39:24 +01:00
assets Add Heimdall profile avatar 2026-05-20 18:52:21 +01:00
deployment/idunn Pin the recipe's secret declarations, and declare every app secret file 2026-09-30 14:40:21 +02:00
docs Docs: secrets are _FILE names; drop the unread Spotiverse secret 2026-09-30 14:40:21 +02:00
notes Docs: secrets are _FILE names; drop the unread Spotiverse secret 2026-09-30 14:40:21 +02:00
plugins/gamecult.heimdall.access Resume browser sign-in by attempt id, not the completion code 2026-09-23 20:50:28 +02:00
schemas Bind auth completions to their attempt handles 2026-08-22 12:01:56 +02:00
src Schema check: keys as the store relies on them, typed columns, per-table privileges 2026-09-30 18:55:45 +02:00
state REC-114: delete completed emergency-compaction scratch 2026-09-13 14:15:37 +02:00
tests Schema check: keys as the store relies on them, typed columns, per-table privileges 2026-09-30 18:55:45 +02:00
tools Rename repo to Heimdall 2026-04-26 11:41:27 +01:00
vendor Bump vendored CultLib for the bounded fragment reassembly map 2026-09-10 11:50:49 +02:00
.env.example Docs: secrets are _FILE names; drop the unread Spotiverse secret 2026-09-30 14:40:21 +02:00
.gitignore Ignore local secret files 2026-04-29 12:23:45 +01:00
.gitmodules Vendor CultLib as a gitlink so Heimdall's source can be sealed 2026-09-06 00:42:45 +02:00
AGENTS.md Name the Linux deploy target for the auth authority 2026-09-08 12:23:44 +02:00
CLAUDE.md Drop the Codex framing from the doctrine import 2026-09-06 00:39:45 +02:00
LICENSE Add MIT license 2026-09-05 21:54:09 +02:00
package.json Follow CultLib's package rename and select workspaces by path 2026-09-07 22:26:24 +02:00
pnpm-lock.yaml Follow CultLib's package rename and select workspaces by path 2026-09-07 22:26:24 +02:00
README.md Record Odin-discovered access deployment 2026-08-22 04:08:36 +02:00
tsconfig.json Resume Heimdall auth from browser return witness 2026-08-22 11:42:28 +02:00
vitest.config.ts Limit Vitest to source test tree 2026-04-26 12:25:53 +01:00

Heimdall

Heimdall is the shared auth authority taking shape for GameCult-hosted experiments.

The point is painfully simple:

  • stop rebuilding Discord/Patreon login glue in every app
  • keep provider OAuth, linked identities, grants, entitlements, and session issuance in one place
  • let app runtimes verify signed claims locally so "shared auth" does not become "everything phones home for every request"
  • keep app-domain data separate so "shared auth" does not become "shared swamp"

Current Shape

This repo now has a stateful first slice instead of a decorative skeleton.

Landed right now:

  • a TypeScript/Fastify service scaffold under src/
  • Ed25519 JWT signing plus /.well-known/jwks.json
  • file-backed signing-key loading/bootstrap so restart does not vaporize the service identity when you configure a real key path
  • signed OAuth start-state scaffolding for Discord, Patreon, GitHub, Twitch, YouTube, and Spotify
  • durable auth/control-plane storage with in-memory and Postgres backends
  • account, linked-identity, session, persistent OAuth attempt, grant, entitlement snapshot, and audit persistence
  • a real Discord OAuth callback path for the first Repixelizer access flow
  • direct backend callback handoff for same-host or Yggdrasil-reachable app backends
  • AES-256-GCM sealing for managed provider tokens at rest
  • a one-time browser completion exchange kept as fallback for opener postMessage handoff
  • app profile surfaces for Repixelizer, StreamPixels, and Spotiverse
  • signed claim issuance for app-local verification experiments
  • a local verifier helper in src/verifier.ts so app backends can validate Heimdall JWTs without phoning home on every guarded request
  • a read-only Odin/Eve provider advertisement export that names redacted CultCache witness document shapes and paths without touching live secrets
  • a daemon-owned CultCache boundary witness at GC_ACCESS_CULTCACHE_PATH containing the Heimdall provider advertisement, command boundary, transport profile, and Idunn daemon-health summary
  • optional Idunn daemon-health publication over cultnet.transport.rudp.v0 when GC_ACCESS_IDUNN_RUDP_HEALTH is configured
  • the gamecult.heimdall.access Eve plugin with executable describe, validate, and project operations plus a browser reference adapter
  • a loopback-only CultNet operation boundary on port 4101 for authenticated heimdall.auth.begin and heimdall.auth.complete; app payloads and completion claims are AES-256-GCM wrapped and HMAC-bound to expiry, nonce, operation, runtime, and idempotency identity
  • redacted provider, command-boundary, plugin, and transport records published through Odin under unique typed catalog keys; secret-bearing auth state never enters the catalog
  • the deployed Ghostlight Eve host consumes that discovered boundary and keeps routine app-session verification local

Remaining work:

  • the two-account and eight-account Ghostlight human canaries
  • refresh/revocation flows and admin surfaces
  • broader admin and inspection projections beyond the redacted access boundary

Canonical docs:

  • docs/architecture.md
  • docs/implementation-plan.md
  • docs/service-contract.md
  • docs/verse-service-contract.md
  • docs/app-profiles/repixelizer.md
  • docs/app-profiles/streampixels.md
  • docs/app-profiles/spotiverse.md
  • state/map.yaml
  • notes/fresh-workspace-handoff.md

Dev Commands

pnpm install
pnpm dev
pnpm test
pnpm build
pnpm export:provider-advertisement

Working Loop

  1. Rehydrate from canonical state.
  2. Keep identity authority central and app-domain data local.
  3. Prefer a Yggdrasil-hosted shared service over duplicated per-app provider stacks.
  4. Let app backends verify signed claims locally instead of begging Heimdall on every guarded route.
  5. Commit finished passes before the notes start breeding.