[google/syzkaller] 24859e: docs: document syzkaller dungeon mechanics

[Alexander Potapenko]

Branch: refs/heads/gh-readonly-queue/master/pr-7035-8b15d4aec953e0862a866f0b7fdb932fa4f00e9e
Home: https://github.com/google/syzkaller
Commit: 24859e9e55773f5714ad1dfcfa6195af79613534
https://github.com/google/syzkaller/commit/24859e9e55773f5714ad1dfcfa6195af79613534
Author: Alexander Potapenko <gli...@google.com>
Date: 2026-04-02 (Thu, 02 Apr 2026)

Changed paths:
A docs/syz-dungeon.md

Log Message:
-----------
docs: document syzkaller dungeon mechanics

Add syz-dungeon.md to provide comprehensive documentation for the gamified
Syzkaller Dungeon leaderboard. The document covers character generation
rules, experience and leveling formulas, badge logic, corporate Kingdom
aggregations, and the provided JSON API schemas.


Commit: 15d477690763b7c7382205f3f0138fbf8bc53850
https://github.com/google/syzkaller/commit/15d477690763b7c7382205f3f0138fbf8bc53850
Author: Alexander Potapenko <gli...@google.com>
Date: 2026-04-02 (Thu, 02 Apr 2026)

Changed paths:
A dashboard/app/dungeon.go
M dashboard/app/main.go
A dashboard/app/static/dungeon.png
A dashboard/app/templates/dungeon-hero.html
A dashboard/app/templates/dungeon-kingdom.html
A dashboard/app/templates/dungeon-theme.html
A dashboard/app/templates/dungeon.html
A pkg/dungeon/dungeon.go

Log Message:
-----------
dashboard/app, pkg/dungeon: implement syzkaller dungeon gamification

Introduce the Syzkaller Dungeon, a gamified leaderboard ranking kernel
contributors based on their bug-fixing activity.

The patch includes:
- Backend logic to fetch bug entities from Datastore, compute player
XP/levels via deterministic heuristics, map domain emails to corporate
Kingdoms, and assign RPG classes based on subsystem tags.
- Three new HTTP endpoints (/syz-dungeon, /syz-dungeon/hero, and
/syz-dungeon/kingdom) with programmatic JSON support.
- Fully interactive frontend HTML templates and styling emphasizing a
retro dark-mode aesthetic.


Commit: bed60c290086a7462e49051c0d14a69b3e34c0ff
https://github.com/google/syzkaller/commit/bed60c290086a7462e49051c0d14a69b3e34c0ff
Author: Alexander Potapenko <gli...@google.com>
Date: 2026-04-02 (Thu, 02 Apr 2026)

Changed paths:
A dashboard/app/dungeon_test.go
A pkg/dungeon/dungeon_test.go

Log Message:
-----------
dashboard/app, pkg/dungeon: add tests for syzkaller dungeon

Introduce comprehensive unit tests for the Syzkaller Dungeon logic in
dungeon_test.go. The test suite covers:
- Core game mechanics including XP distributions, bonuses, and the
linear/legendary leveling formulas.
- Cosmetic badge evaluations triggered by vulnerability string matching and
milestone fix counts.
- Kingdom aggregation bounds, player identity resolution, name tie-breaking,
and fallback logic.
- Logarithmic scaling formulas computing the RPG profile stats.


Commit: ff7ae4770a227fa6567a0f4c2f5c8fa321c1a0aa
https://github.com/google/syzkaller/commit/ff7ae4770a227fa6567a0f4c2f5c8fa321c1a0aa
Author: Alexander Potapenko <gli...@google.com>
Date: 2026-04-02 (Thu, 02 Apr 2026)

Changed paths:
M dashboard/app/templates/templates.html

Log Message:
-----------
dashboard/app/templates: add a link to Syzkaller Dungeon

Let's start with a tiny castle, we can decide on the UX later.


Commit: 5c92a9085ae25a84fe62c3fdc8e97a8c5d685677
https://github.com/google/syzkaller/commit/5c92a9085ae25a84fe62c3fdc8e97a8c5d685677
Author: Alexander Potapenko <gli...@google.com>
Date: 2026-04-02 (Thu, 02 Apr 2026)

Changed paths:
M dashboard/app/public_json_api.go

Log Message:
-----------
dashboard/app: add Dungeon endpoints to the JSON API


Commit: e2fe58d3a328ac4976e2cd83e566fac0c7edbcf3
https://github.com/google/syzkaller/commit/e2fe58d3a328ac4976e2cd83e566fac0c7edbcf3
Author: Alexander Potapenko <gli...@google.com>
Date: 2026-04-02 (Thu, 02 Apr 2026)

Changed paths:
M dashboard/app/cron.yaml
M dashboard/app/main.go

Log Message:
-----------
dashboard/app: register dungeon preheat cron handler

This change registers the new /cron/dungeon_preheat endpoint with
App Engine’s HTTP router and adds a corresponding hourly entry in
cron.yaml to execute it automatically.


Commit: 4440e7c2e964875f9e35dba6deda12c2195f19d3
https://github.com/google/syzkaller/commit/4440e7c2e964875f9e35dba6deda12c2195f19d3
Author: Alexander Potapenko <gli...@google.com>
Date: 2026-04-02 (Thu, 02 Apr 2026)

Changed paths:
M dashboard/app/app_test.go
M dashboard/app/config.go
M dashboard/app/dungeon.go
M dashboard/app/local_ui_test.go

Log Message:
-----------
dashboard/app: make dungeon namespace configurable

Move the hardcoded "upstream" namespace for the Dungeon feature into the
global configuration (`GlobalConfig.DungeonNamespace`). This allows running
the dungeon feature in non-upstream environments or test configurations.

- Add `DungeonNamespace` field to `GlobalConfig`.
- Validate `DungeonNamespace` in `checkConfig`.
- Update `dungeon.go` handlers to check against the configured namespace.
- Update tests (`app_test.go`, `local_ui_test.go`) to set the namespace.


Compare: https://github.com/google/syzkaller/compare/24859e9e5577%5E...4440e7c2e964

To unsubscribe from these emails, change your notification settings at https://github.com/google/syzkaller/settings/notifications

[Alexander Potapenko]

Branch: refs/heads/master

Compare: https://github.com/google/syzkaller/compare/8b15d4aec953...4440e7c2e964