From be5f632cb5c8e02b99b03288acf2018efe496d80 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Sun, 7 Jun 2026 05:28:38 +0100 Subject: [PATCH] Add Gjallar cursor and panel minimization --- docs/architecture.md | 16 ++- src/Gjallar/Program.cs | 282 ++++++++++++++++++++++++++++++++++++++--- state/gjallar-state.md | 30 +++-- 3 files changed, 297 insertions(+), 31 deletions(-) diff --git a/docs/architecture.md b/docs/architecture.md index eb8229e..dc75083 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -10,19 +10,21 @@ regions may use different text resolutions. - Owner: Gjallar owns display composition, pane partitioning, per-pane virtual text grids, font-scale selection, framebuffer lowering, and future sparse - refresh output. + refresh output. Gjallar also owns local cursor state, title-bar hit testing, + and minimized/restored panel state. - Inputs: provider catalogs, provider-owned surface trees, display dimensions, - font assets, runtime flags, Odin's canonical marquee tape, and eventually - direct CultMesh subscriptions. + font assets, runtime flags, mouse input, Odin's canonical marquee tape, and + eventually direct CultMesh subscriptions. - Outputs: `gjallar.overview` composition state, visible framebuffer frames, - and renderer telemetry. + cursor presentation, minimized panel presentation, and renderer telemetry. - Derived state: pane weights, pixel rectangles, chosen font sizes, one-row gutter blocks, continuous readable marquee ribbon positions, dirty rectangles, - glyph runs, and compact agent-readable projections. + glyph runs, title-bar hit regions, local minimized-panel keys, and compact + agent-readable projections. - Forbidden writers: discovery systems do not decide Gjallar layout; providers do not tune themselves for Nightwing; framebuffer backends do not invent provider truth; Gjallar does not derive marquee content from provider status - summaries. + summaries; Odin and providers do not own Nightwing-local minimized state. - Shared paths: full-frame rendering, sparse refresh, future browser previews, and agent text capture should lower the same overview model. - Deletion line: any code that both discovers provider truth and decides final @@ -39,6 +41,8 @@ Odin provider catalog -> synthetic gjallar.overview surface -> EveNode panel extraction -> weighted AABB packing + -> local minimized-state application + -> title-bar hit-region emission -> one-row gutter cell plan -> continuous readable marquee ribbon path -> per-panel text pressure estimate diff --git a/src/Gjallar/Program.cs b/src/Gjallar/Program.cs index ae3524a..63e7524 100644 --- a/src/Gjallar/Program.cs +++ b/src/Gjallar/Program.cs @@ -23,7 +23,8 @@ internal sealed record GjallarConfig( int Frames, int Width, int Height, - string FontPath) + string FontPath, + string MousePath) { public static GjallarConfig Parse(IReadOnlyList args) => new( StringArg(args, "--fb", "/dev/fb0"), @@ -36,7 +37,8 @@ internal sealed record GjallarConfig( IntArg(args, "--frames", 0), IntArg(args, "--width", 0), IntArg(args, "--height", 0), - StringArg(args, "--font", "")); + StringArg(args, "--font", ""), + StringArg(args, "--mouse", "/dev/input/mice")); private static string StringArg(IReadOnlyList args, string name, string fallback) { @@ -77,6 +79,16 @@ internal sealed class GjallarRenderer : IDisposable private string lastProviderFetchUri = ""; private SceneCache? sceneCache; private FrameTimings lastTimings; + private readonly object interactionLock = new(); + private readonly HashSet minimizedPanels = new(StringComparer.Ordinal); + private IReadOnlyList latestTitleHits = []; + private int minimizedVersion; + private int cursorX; + private int cursorY; + private bool cursorActive; + private string cursorStatus = "not-started"; + private string cursorError = ""; + private string lastClick = ""; public GjallarRenderer(GjallarConfig config) { @@ -86,11 +98,14 @@ internal sealed class GjallarRenderer : IDisposable frameInterval = TimeSpan.FromSeconds(1.0 / Math.Max(1, config.RefreshHz)); timer = new PeriodicTimer(frameInterval); lastStatusTick = Stopwatch.GetTimestamp(); + cursorX = framebuffer.Width / 2; + cursorY = framebuffer.Height / 2; } public async Task RunAsync() { var receiveTask = Task.Run(() => ConnectReceiveLoopAsync(stopping.Token)); + var inputTask = Task.Run(() => MouseInputLoopAsync(stopping.Token)); var rendered = 0; while (config.Frames <= 0 || rendered < config.Frames) { @@ -121,6 +136,108 @@ internal sealed class GjallarRenderer : IDisposable catch (OperationCanceledException) when (stopping.IsCancellationRequested) { } + try + { + await inputTask.ConfigureAwait(false); + } + catch (OperationCanceledException) when (stopping.IsCancellationRequested) + { + } + } + + private async Task MouseInputLoopAsync(CancellationToken token) + { + if (string.IsNullOrWhiteSpace(config.MousePath)) + { + cursorStatus = "disabled"; + return; + } + + while (!token.IsCancellationRequested) + { + try + { + await using var stream = File.Open(config.MousePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite); + cursorStatus = $"connected:{config.MousePath}"; + cursorError = ""; + var packet = new byte[3]; + var leftDown = false; + while (!token.IsCancellationRequested) + { + await ReadExactlyAsync(stream, packet, token).ConfigureAwait(false); + var buttons = packet[0]; + var dx = unchecked((sbyte)packet[1]); + var dy = unchecked((sbyte)packet[2]); + var clicked = (buttons & 0x01) != 0 && !leftDown; + leftDown = (buttons & 0x01) != 0; + lock (interactionLock) + { + cursorActive = true; + cursorX = Math.Clamp(cursorX + dx, 0, Math.Max(0, framebuffer.Width - 1)); + cursorY = Math.Clamp(cursorY - dy, 0, Math.Max(0, framebuffer.Height - 1)); + } + + if (clicked) + { + TogglePanelAtCursor(); + } + } + } + catch (OperationCanceledException) when (token.IsCancellationRequested) + { + return; + } + catch (Exception error) when (!token.IsCancellationRequested) + { + cursorStatus = "input-error"; + cursorError = error.Message; + await Task.Delay(TimeSpan.FromSeconds(2), token).ConfigureAwait(false); + } + } + } + + private static async Task ReadExactlyAsync(Stream stream, byte[] buffer, CancellationToken token) + { + var offset = 0; + while (offset < buffer.Length) + { + var read = await stream.ReadAsync(buffer.AsMemory(offset, buffer.Length - offset), token).ConfigureAwait(false); + if (read == 0) + { + throw new EndOfStreamException("mouse input ended"); + } + offset += read; + } + } + + private void TogglePanelAtCursor() + { + TitleHitRegion? hit = null; + int x; + int y; + lock (interactionLock) + { + x = cursorX; + y = cursorY; + hit = latestTitleHits + .Where(region => region.Rect.Contains(x, y)) + .OrderByDescending(region => region.Depth) + .ThenBy(region => region.Rect.Width * region.Rect.Height) + .FirstOrDefault(); + if (hit is null) + { + lastClick = $"miss:{x},{y}"; + return; + } + + if (!minimizedPanels.Add(hit.Key)) + { + minimizedPanels.Remove(hit.Key); + } + minimizedVersion++; + sceneCache = null; + lastClick = $"{(minimizedPanels.Contains(hit.Key) ? "minimized" : "restored")}:{hit.Title}@{x},{y}"; + } } private static Uri ProviderUri(string url, string providerId) @@ -413,7 +530,21 @@ internal sealed class GjallarRenderer : IDisposable private FrameTimings RenderOnce() { var stateJson = Volatile.Read(ref latestStateJson); - var frame = new FrameDocument(framebuffer.Width, framebuffer.Height, fonts); + HashSet minimizedSnapshot; + int minimizedSnapshotVersion; + int drawCursorX; + int drawCursorY; + bool drawCursor; + lock (interactionLock) + { + minimizedSnapshot = new HashSet(minimizedPanels, StringComparer.Ordinal); + minimizedSnapshotVersion = minimizedVersion; + drawCursorX = cursorX; + drawCursorY = cursorY; + drawCursor = cursorActive; + } + + var frame = new FrameDocument(framebuffer.Width, framebuffer.Height, fonts, minimizedSnapshot); var copyMs = 0.0; var decorMs = 0.0; var gutterMs = 0.0; @@ -426,7 +557,7 @@ internal sealed class GjallarRenderer : IDisposable } else { - var scene = SceneFor(stateJson); + var scene = SceneFor(stateJson, minimizedSnapshot, minimizedSnapshotVersion); var step = Stopwatch.GetTimestamp(); frame.Clear(ColorBgra.Black); foreach (var panel in scene.Panels) @@ -443,6 +574,16 @@ internal sealed class GjallarRenderer : IDisposable gutterMs = ElapsedMilliseconds(step, Stopwatch.GetTimestamp()); } + if (drawCursor) + { + frame.DrawCursor(drawCursorX, drawCursorY, frameIndex); + } + + lock (interactionLock) + { + latestTitleHits = frame.TitleHitRegions.ToArray(); + } + var presentStarted = Stopwatch.GetTimestamp(); framebuffer.Present(frame.Pixels); presentMs = ElapsedMilliseconds(presentStarted, Stopwatch.GetTimestamp()); @@ -475,6 +616,28 @@ internal sealed class GjallarRenderer : IDisposable return; } + string[] minimizedTitles; + int minimizedCount; + int titleHitRegionCount; + int statusCursorX; + int statusCursorY; + bool statusCursorActive; + string statusCursorStatus; + string statusCursorError; + string statusLastClick; + lock (interactionLock) + { + minimizedTitles = minimizedPanels.Take(16).ToArray(); + minimizedCount = minimizedPanels.Count; + titleHitRegionCount = latestTitleHits.Count; + statusCursorX = cursorX; + statusCursorY = cursorY; + statusCursorActive = cursorActive; + statusCursorStatus = cursorStatus; + statusCursorError = cursorError; + statusLastClick = lastClick; + } + Directory.CreateDirectory(Path.GetDirectoryName(config.StatusPath) ?? "."); var visibleMarqueeRows = sceneCache is null ? [] @@ -505,6 +668,9 @@ internal sealed class GjallarRenderer : IDisposable scene = new { panels = sceneCache?.Panels.Count ?? 0, + minimizedPanels = minimizedCount, + minimizedTitles, + titleHitRegions = titleHitRegionCount, gutterCells = sceneCache?.GutterCells.Count ?? 0, gutterRows = sceneCache?.GutterCells.Select(static cell => cell.Row).Distinct().Count() ?? 0, gutterPolicy = "single-row-top-between-panels-bottom", @@ -514,6 +680,15 @@ internal sealed class GjallarRenderer : IDisposable visibleMarqueeRows, visibleMarqueeHasStonks = visibleMarqueeRows.Any(static row => row.Contains('$') || row.Contains("BITCOIN", StringComparison.OrdinalIgnoreCase) || row.Contains("DOGECOIN", StringComparison.OrdinalIgnoreCase) || row.Contains("ETHEREUM", StringComparison.OrdinalIgnoreCase)), }, + cursor = new + { + status = statusCursorStatus, + error = statusCursorError, + active = statusCursorActive, + x = statusCursorX, + y = statusCursorY, + lastClick = statusLastClick, + }, cultMathNative = Voronoi.NativeAvailable, paintMs = Math.Round(paintMs, 2), timings = new @@ -533,9 +708,9 @@ internal sealed class GjallarRenderer : IDisposable private static string Sample(string value, int maxLength) => value.Length <= maxLength ? value : value[..maxLength]; - private SceneCache SceneFor(byte[] stateJson) + private SceneCache SceneFor(byte[] stateJson, IReadOnlySet minimizedSnapshot, int minimizedSnapshotVersion) { - if (sceneCache is { } existing && ReferenceEquals(existing.StateJson, stateJson)) + if (sceneCache is { } existing && ReferenceEquals(existing.StateJson, stateJson) && existing.MinimizedVersion == minimizedSnapshotVersion) { return existing; } @@ -543,18 +718,39 @@ internal sealed class GjallarRenderer : IDisposable using var state = JsonDocument.Parse(stateJson); if (!EveNode.TryRoot(state.RootElement, out var root)) { - sceneCache = new SceneCache(stateJson, [], [], ""); + sceneCache = new SceneCache(stateJson, [], [], "", minimizedSnapshotVersion); return sceneCache; } var providers = root.PanelChildren().Where(node => !node.IsScaffoldOnly()).ToArray(); var gutter = GutterSize(fonts.Edge); var outerY = gutter; - var packed = AabbPacker.Pack(providers, new RectI(0, outerY, framebuffer.Width, framebuffer.Height - outerY * 2), gutter).ToArray(); - sceneCache = new SceneCache(stateJson, packed, FrameDocument.BuildGutterCells(framebuffer.Width, framebuffer.Height, fonts.Edge, packed, gutter), root.MarqueeText); + var minimizedProviders = providers.Where(node => minimizedSnapshot.Contains(node.StableKey())).ToArray(); + var activeProviders = providers.Where(node => !minimizedSnapshot.Contains(node.StableKey())).ToArray(); + var shelfHeight = minimizedProviders.Length == 0 ? 0 : Math.Max(fonts.Edge.LineHeight + 10, GutterSize(fonts.Edge)); + var activeRect = new RectI(0, outerY, framebuffer.Width, Math.Max(1, framebuffer.Height - outerY * 2 - shelfHeight)); + var packed = AabbPacker.Pack(activeProviders, activeRect, gutter).ToList(); + if (minimizedProviders.Length > 0) + { + packed.AddRange(MinimizedShelf(minimizedProviders, new RectI(0, framebuffer.Height - outerY - shelfHeight, framebuffer.Width, shelfHeight), gutter)); + } + var packedArray = packed.ToArray(); + sceneCache = new SceneCache(stateJson, packedArray, FrameDocument.BuildGutterCells(framebuffer.Width, framebuffer.Height, fonts.Edge, packedArray, gutter), root.MarqueeText, minimizedSnapshotVersion); return sceneCache; } + private static IEnumerable MinimizedShelf(IReadOnlyList nodes, RectI rect, int gap) + { + var count = Math.Max(1, nodes.Count); + var width = Math.Max(80, rect.Width / count); + for (var index = 0; index < nodes.Count; index++) + { + var x = rect.X + index * width; + var itemWidth = index == nodes.Count - 1 ? Math.Max(1, rect.X + rect.Width - x) : width; + yield return new PackedPanel(nodes[index], AabbPacker.Inset(new RectI(x, rect.Y, itemWidth, rect.Height), Math.Max(2, gap / 2)), AabbPacker.Weight(nodes[index]), nodes[index].StableKey(), true); + } + } + private static int GutterSize(PsfFont font) => Math.Max(28, Math.Max(font.LineHeight, font.Width) + 8); @@ -567,7 +763,7 @@ internal sealed class GjallarRenderer : IDisposable } } -internal sealed record SceneCache(byte[] StateJson, IReadOnlyList Panels, IReadOnlyList GutterCells, string MarqueeTape); +internal sealed record SceneCache(byte[] StateJson, IReadOnlyList Panels, IReadOnlyList GutterCells, string MarqueeTape, int MinimizedVersion); internal readonly record struct FrameTimings(double CopyMs, double DecorMs, double GutterMs, double PresentMs); internal sealed record ProviderCatalog(IReadOnlyList Providers, string? MarqueeText = null); internal sealed record ProviderCatalogEntry( @@ -621,12 +817,16 @@ internal sealed record ProviderFrame(ProviderCatalogEntry Provider, JsonElement } } +internal sealed record TitleHitRegion(string Key, string Title, RectI Rect, bool Minimized, int Depth); + internal sealed class FrameDocument { private readonly FontAtlas fonts; + private readonly IReadOnlySet minimizedPanels; public byte[] Pixels { get; } public int Width { get; } public int Height { get; } + public List TitleHitRegions { get; } = []; public int PanelCount { get; private set; } public int[] X { get; } public int[] Y { get; } @@ -635,11 +835,12 @@ internal sealed class FrameDocument public float[] Weight { get; } public int[] FontIndex { get; } - public FrameDocument(int width, int height, FontAtlas fonts, int panelCapacity = 256) + public FrameDocument(int width, int height, FontAtlas fonts, IReadOnlySet? minimizedPanels = null, int panelCapacity = 256) { Width = width; Height = height; this.fonts = fonts; + this.minimizedPanels = minimizedPanels ?? new HashSet(); Pixels = GC.AllocateUninitializedArray(width * height * 4); X = new int[panelCapacity]; Y = new int[panelCapacity]; @@ -663,6 +864,11 @@ internal sealed class FrameDocument public void CopyFrom(byte[] pixels) => Buffer.BlockCopy(pixels, 0, Pixels, 0, Math.Min(pixels.Length, Pixels.Length)); public void DrawPanel(PackedPanel panel, int frameIndex, int depth = 0) + { + DrawPanel(panel, frameIndex, string.IsNullOrWhiteSpace(panel.Key) ? panel.Node.StableKey() : panel.Key, depth); + } + + private void DrawPanel(PackedPanel panel, int frameIndex, string panelKey, int depth) { var rect = panel.Rect; var headerFont = fonts.HeaderFor(rect.Height); @@ -696,7 +902,9 @@ internal sealed class FrameDocument AddBorderCommands(rect, tones, fills); var title = panel.Node.Title; - texts.Add(new TextCommand(headerFont, rect.X + 8, headerTextY, title, Math.Max(1, rect.Width - 16), tones.Add(rect.X + 8, headerTextY, CultMathTone.Header, headerFont.Width))); + TitleHitRegions.Add(new TitleHitRegion(panelKey, title, new RectI(rect.X, rect.Y, rect.Width, headerBand), panel.Minimized, depth)); + var titleText = $"{(panel.Minimized ? "+ " : "- ")}{title}"; + texts.Add(new TextCommand(headerFont, rect.X + 8, headerTextY, titleText, Math.Max(1, rect.Width - 16), tones.Add(rect.X + 8, headerTextY, CultMathTone.Header, headerFont.Width))); var contentX = rect.X + 10; var colors = tones.Resolve(); @@ -710,6 +918,11 @@ internal sealed class FrameDocument DrawText(text.Font, text.X, text.Y, text.Text, colors[text.ColorIndex], text.MaxWidth); } + if (panel.Minimized) + { + return; + } + if (depth >= 4 || !panel.Node.ShouldRenderNestedPanels() || rect.Width < 96 || contentH < 42) { DrawPanelText(panel, frameIndex, textItems, rowStart, maxY, contentW, contentX); @@ -734,7 +947,8 @@ internal sealed class FrameDocument foreach (var child in packedChildren) { - DrawPanel(child, frameIndex, depth + 1); + var childKey = $"{panelKey}/{child.Key}"; + DrawPanel(child with { Key = childKey, Minimized = minimizedPanels.Contains(childKey) }, frameIndex, childKey, depth + 1); } } @@ -807,6 +1021,26 @@ internal sealed class FrameDocument public void DrawText(int fontIndex, int x, int y, string text, ColorBgra color) => DrawText(fonts[fontIndex], x, y, text, color, Width - x); + public void DrawCursor(int x, int y, int frameIndex) + { + var color = ToCursorColor(frameIndex); + FillRect(new RectI(x - 7, y, 15, 2), ColorBgra.Black); + FillRect(new RectI(x, y - 7, 2, 15), ColorBgra.Black); + FillRect(new RectI(x - 6, y, 13, 1), color); + FillRect(new RectI(x, y - 6, 1, 13), color); + } + + private static ColorBgra ToCursorColor(int frameIndex) + { + var phase = (frameIndex / 12) % 3; + return phase switch + { + 0 => new ColorBgra(80, 255, 255), + 1 => new ColorBgra(255, 255, 120), + _ => new ColorBgra(255, 120, 255), + }; + } + private void DrawText(PsfFont font, int x, int y, string text, ColorBgra color, int maxWidth) { var cursor = x; @@ -1185,7 +1419,7 @@ internal static class AabbPacker public static IReadOnlyList Pack(IReadOnlyList nodes, RectI rect, int gap) { var weighted = nodes - .Select(node => new PackedPanel(node, rect, Weight(node))) + .Select(node => new PackedPanel(node, rect, Weight(node), node.StableKey(), false)) .OrderByDescending(item => item.Weight) .ToArray(); var result = new List(); @@ -1387,13 +1621,13 @@ internal static class AabbPacker return max < preferredMin ? max : Math.Clamp(value, preferredMin, max); } - private static RectI Inset(RectI rect, int gap) + public static RectI Inset(RectI rect, int gap) { var inset = Math.Max(1, gap / 2); return new RectI(rect.X, rect.Y + inset, Math.Max(1, rect.Width), Math.Max(1, rect.Height - inset * 2)); } - private static float Weight(EveNode node) + public static float Weight(EveNode node) { var items = node.TextItems().Take(160).ToArray(); var requestedRows = 1.0f; @@ -1422,7 +1656,7 @@ internal static class AabbPacker private sealed record TreemapItem(PackedPanel Panel, float Area); } -internal sealed record PackedPanel(EveNode Node, RectI Rect, float Weight); +internal sealed record PackedPanel(EveNode Node, RectI Rect, float Weight, string Key, bool Minimized); internal readonly record struct RectI(int X, int Y, int Width, int Height) { public float CenterX => X + Width * 0.5f; @@ -1445,6 +1679,20 @@ internal sealed class EveNode public string MarqueeText { get; init; } = ""; public IReadOnlyList Children { get; init; } = []; + public string StableKey() => + StablePanelKey(string.IsNullOrWhiteSpace(ProviderId) ? $"{Kind}:{Title}" : $"{ProviderId}:{Kind}:{Title}"); + + private static string StablePanelKey(string value) + { + var builder = new StringBuilder(value.Length); + foreach (var ch in value.Trim().ToLowerInvariant()) + { + builder.Append(char.IsLetterOrDigit(ch) ? ch : '-'); + } + + return string.Join("-", builder.ToString().Split('-', StringSplitOptions.RemoveEmptyEntries)); + } + public static bool TryRoot(JsonElement element, out EveNode root) { root = new EveNode { Title = "root" }; diff --git a/state/gjallar-state.md b/state/gjallar-state.md index 76d3ed7..eb83da6 100644 --- a/state/gjallar-state.md +++ b/state/gjallar-state.md @@ -28,10 +28,11 @@ surface sources - Current deployment: Nightwing `gjallar.service` - Current feed: Odin provider catalog at `ws://192.168.1.66:8797/eve/deck` - Current status path on Nightwing: `/var/log/gjallar.status` +- Current cursor input: `/dev/input/mice`, rendered as a framebuffer crosshair. - Current marquee input: Odin's provider catalog `marqueeText`, built from the Stonks securities tape interwoven with ordered VoidBot poem lines. -Observed live status after marquee/gutter cut: +Observed live status after cursor/minimize cut: ```json { @@ -43,11 +44,19 @@ Observed live status after marquee/gutter cut: }, "scene": { "panels": 6, + "minimizedPanels": 0, + "titleHitRegions": 38, "gutterRows": 3, "gutterPolicy": "single-row-top-between-panels-bottom", "gutterFlow": "continuous-readable-ribbon", "marqueeChars": 3101, "visibleMarqueeRows": ["..."] + }, + "cursor": { + "status": "connected:/dev/input/mice", + "active": false, + "x": 960, + "y": 540 } } ``` @@ -56,22 +65,27 @@ Observed live status after marquee/gutter cut: - Owner: Gjallar owns display composition, pane partitioning, per-pane virtual grids, font-scale choice, gutter text continuity, frame/cell lowering, and - renderer telemetry. + renderer telemetry. It also owns local cursor position, title-bar hit testing, + and minimized/restored panel state. - Inputs: provider catalogs, provider-owned surface trees, display dimensions, - font assets, runtime flags, Odin's canonical marquee tape, and later native - CultMesh subscriptions. + font assets, runtime flags, mouse deltas/buttons, Odin's canonical marquee + tape, and later native CultMesh subscriptions. - Outputs: `gjallar.overview` composition state, framebuffer frames, sparse - refresh streams, and agent-readable panel captures. + refresh streams, cursor presentation, minimized panel presentation, and + agent-readable panel captures. - Derived state: pane weights, pixel rectangles, selected fonts, one-row gutter blocks, a continuous readable marquee ribbon path, dirty rectangles, glyph - runs, and compact text projections. + runs, title-bar hit regions, local minimized-panel keys, and compact text + projections. - Forbidden writers: discovery systems must not decide Gjallar layout; providers must not tune themselves for Nightwing; framebuffer backends must not invent provider truth; Gjallar must not synthesize status-noise marquee content from - provider summaries. + provider summaries. Odin and providers must not own Nightwing-local minimized + state. - Cut line: code that discovers what exists belongs upstream. Code that decides what the canonical marquee says belongs upstream. Code that decides how a - physical or virtual display shows it belongs in Gjallar. + physical or virtual display shows it, and what the local operator has + minimized, belongs in Gjallar. ## Product Thesis