rickub
nandi/gleanpublic⑂ Fork 0
⑂ 12e3cec
Branches
claude/modal-container-min-76527a main View all branches → View all tags →
Commits
⬇ Clone ▾
git clone https://git.rickub.com/nandi/glean.git
git clone ssh://git@rickub.com/nandi/glean.git

Host key fingerprint (ed25519): SHA256:iycHnxEyq0Q7uyVpB7JlznP0G7JrTPXLYRcAU5CSLhc — verify it before your first connect.

Update docsUnverified

Julien Robert committed 2026-04-23T21:54:18+02:00 Browse files
12e3cec parent: 3de68f1
modified .env.example +1 -0
@@ -6,6 +6,7 @@ GLEAN_SYNC_INTERVAL=10m
66 GLEAN_CLUSTER_INTERVAL=15m
77 GLEAN_FETCH_INTERVAL=5m
88 GLEAN_COLLECTION_DIR_URL=https://lightrail.microcosm.blue/xrpc/com.atproto.sync.listReposByCollection?collection=at.glean.subscription
9+GLEAN_BACKFILL_CONCURRENCY=5
910 # Leave empty for localhost OAuth (development)
1011 # GLEAN_OAUTH_CLIENT_ID=https://glean.at/oauth/client-metadata
1112 # GLEAN_OAUTH_REDIRECT_URL=https://glean.at/auth/callback
@@ -6,6 +6,7 @@ GLEAN_SYNC_INTERVAL=10m
6 GLEAN_CLUSTER_INTERVAL=15m6 GLEAN_CLUSTER_INTERVAL=15m
7 GLEAN_FETCH_INTERVAL=5m7 GLEAN_FETCH_INTERVAL=5m
8 GLEAN_COLLECTION_DIR_URL=https://lightrail.microcosm.blue/xrpc/com.atproto.sync.listReposByCollection?collection=at.glean.subscription8 GLEAN_COLLECTION_DIR_URL=https://lightrail.microcosm.blue/xrpc/com.atproto.sync.listReposByCollection?collection=at.glean.subscription
9+GLEAN_BACKFILL_CONCURRENCY=5
9 # Leave empty for localhost OAuth (development)10 # Leave empty for localhost OAuth (development)
10 # GLEAN_OAUTH_CLIENT_ID=https://glean.at/oauth/client-metadata11 # GLEAN_OAUTH_CLIENT_ID=https://glean.at/oauth/client-metadata
11 # GLEAN_OAUTH_REDIRECT_URL=https://glean.at/auth/callback12 # GLEAN_OAUTH_REDIRECT_URL=https://glean.at/auth/callback
modified docs/design.md +11 -11
@@ -158,15 +158,15 @@ All custom colors live under the `spot` namespace in `tailwind.config.js`. CSS v
158158
159159 ## 8. Page Structure
160160
161-| Page | Layout | Key Features |
162-| --------------- | ---------------------- | ---------------------------------------------- |
163-| Index (landing) | Full-width, no sidebar | Hero with mockup, feature cols, dark band, CTA |
164-| Login | Centered card | Bluesky + Atmosphere sign-in buttons |
165-| Dashboard | 2/3 + 1/3 grid | Articles + trending/recommendations sidebar |
166-| Articles | Full-width list | Keyboard nav (j/k/o/m), mark-all-read |
167-| Article Detail | `max-w-3xl` centered | Content, like/share/read buttons, annotations |
161+| Page | Layout | Key Features |
162+| --------------- | ---------------------- | -------------------------------------------------------------- |
163+| Index (landing) | Full-width, no sidebar | Hero with mockup, feature cols, dark band, CTA |
164+| Login | Centered card | Bluesky + Atmosphere sign-in buttons |
165+| Dashboard | 2/3 + 1/3 grid | Articles + trending/recommendations sidebar |
166+| Articles | Full-width list | Keyboard nav (j/k/o/m), mark-all-read |
167+| Article Detail | `max-w-3xl` centered | Content, like/share/read buttons, annotations |
168168 | Feeds | 2/3 + 1/3 grid | Feed list with categories + add/import sidebar, refresh button |
169-| Trending | Full-width list | Like/annotation counts on each article |
170-| Discover | Mixed grid | Recommendations + people + browse all |
171-| Annotations | Full-width list | Filter by article URL, load more |
172-| Profile | `max-w-2xl` centered | Avatar, stats, feeds, annotations |
169+| Trending | Full-width list | Like/annotation counts on each article |
170+| Discover | Mixed grid | Recommendations + people + browse all |
171+| Annotations | Full-width list | Filter by article URL, load more |
172+| Profile | `max-w-2xl` centered | Avatar, stats, feeds, annotations |
@@ -158,15 +158,15 @@ All custom colors live under the `spot` namespace in `tailwind.config.js`. CSS v
158 158
159 ## 8. Page Structure159 ## 8. Page Structure
160 160
161-| Page | Layout | Key Features |161+| Page | Layout | Key Features |
162-| --------------- | ---------------------- | ---------------------------------------------- |162+| --------------- | ---------------------- | -------------------------------------------------------------- |
163-| Index (landing) | Full-width, no sidebar | Hero with mockup, feature cols, dark band, CTA |163+| Index (landing) | Full-width, no sidebar | Hero with mockup, feature cols, dark band, CTA |
164-| Login | Centered card | Bluesky + Atmosphere sign-in buttons |164+| Login | Centered card | Bluesky + Atmosphere sign-in buttons |
165-| Dashboard | 2/3 + 1/3 grid | Articles + trending/recommendations sidebar |165+| Dashboard | 2/3 + 1/3 grid | Articles + trending/recommendations sidebar |
166-| Articles | Full-width list | Keyboard nav (j/k/o/m), mark-all-read |166+| Articles | Full-width list | Keyboard nav (j/k/o/m), mark-all-read |
167-| Article Detail | `max-w-3xl` centered | Content, like/share/read buttons, annotations |167+| Article Detail | `max-w-3xl` centered | Content, like/share/read buttons, annotations |
168 | Feeds | 2/3 + 1/3 grid | Feed list with categories + add/import sidebar, refresh button |168 | Feeds | 2/3 + 1/3 grid | Feed list with categories + add/import sidebar, refresh button |
169-| Trending | Full-width list | Like/annotation counts on each article |169+| Trending | Full-width list | Like/annotation counts on each article |
170-| Discover | Mixed grid | Recommendations + people + browse all |170+| Discover | Mixed grid | Recommendations + people + browse all |
171-| Annotations | Full-width list | Filter by article URL, load more |171+| Annotations | Full-width list | Filter by article URL, load more |
172-| Profile | `max-w-2xl` centered | Avatar, stats, feeds, annotations |172+| Profile | `max-w-2xl` centered | Avatar, stats, feeds, annotations |
modified docs/specs.md +56 -45
@@ -13,7 +13,7 @@ The core idea: your RSS subscriptions are a strong signal about your interests.
1313 | Layer | Technology |
1414 | ---------------- | --------------------------------------------------------------- |
1515 | Backend | Go |
16-| Database | SQLite (3 files: users, articles, recs via `mattn/go-sqlite3`) |
16+| Database | SQLite (3 files: users, articles, recs via `mattn/go-sqlite3`) |
1717 | Frontend | htmx + TailwindCSS |
1818 | Auth | AT Protocol OAuth / DID resolution (configurable PLC directory) |
1919 | AT Protocol role | AppView for `at.glean.*` lexicons |
@@ -374,7 +374,7 @@ Glean stores article content locally so the reading experience is fast and consi
374374 ```sql
375375 CREATE TABLE articles (
376376 id INTEGER PRIMARY KEY AUTOINCREMENT,
377- feed_url TEXT NOT NULL REFERENCES feeds(feed_url),
377+ feed_url TEXT NOT NULL,
378378 guid TEXT NOT NULL,
379379 title TEXT NOT NULL DEFAULT '',
380380 url TEXT,
@@ -400,8 +400,8 @@ Read/unread state is tracked per user per article:
400400
401401 ```sql
402402 CREATE TABLE read_state (
403- user_did TEXT NOT NULL REFERENCES users(did),
404- article_id INTEGER NOT NULL REFERENCES articles(id),
403+ user_did TEXT NOT NULL,
404+ article_id INTEGER NOT NULL,
405405 is_read BOOLEAN NOT NULL DEFAULT 0,
406406 read_at DATETIME,
407407 PRIMARY KEY (user_did, article_id)
@@ -477,24 +477,23 @@ Glean runs as a single Go binary that fills three roles: **AppView** (indexing `
477477
478478 Glean uses three separate SQLite database files to reduce write-lock contention. Each is opened with its own connection pool:
479479
480-| File | Contents | ATTACH alias |
481-|------|----------|-------------|
482-| `<base>_users` | Users, follows, OAuth | `main` (primary) |
483-| `<base>_articles` | Feeds, subscriptions, articles, read state, likes, annotations | `articles` |
484-| `<base>_recs` | Similarity scores, impressions, dismissals, signal weights | `recs` |
480+| File | Contents | ATTACH alias |
481+| ----------------- | -------------------------------------------------------------- | ---------------- |
482+| `<base>_users` | Users, follows, OAuth | `main` (primary) |
483+| `<base>_articles` | Feeds, subscriptions, articles, read state, likes, annotations | `articles` |
484+| `<base>_recs` | Similarity scores, impressions, dismissals, signal weights | `recs` |
485485
486486 The users connection pool uses a custom SQLite driver with a `ConnectHook` that ATTACHes the articles and recs databases on every new connection. This allows the cluster engine to run cross-database queries using schema prefixes (`articles.subscriptions`, `recs.user_similarity`, `main.follows`).
487487
488-The articles and recs connections are independent pools used by the service layer for single-database operations.
488+Foreign key constraints are not used because SQLite does not support foreign keys across ATTACHed databases. Referential integrity is enforced by the application layer.
489489
490490 ### 6.1 Users (`<base>_users`)
491491
492+Profile data (handle, display name, avatar) is resolved on-the-fly via AT Protocol identity resolution rather than stored locally.
493+
492494 ```sql
493495 CREATE TABLE users (
494496 did TEXT PRIMARY KEY,
495- handle TEXT NOT NULL,
496- display_name TEXT,
497- avatar_url TEXT,
498497 indexed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
499498 updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
500499 );
@@ -507,7 +506,7 @@ Indexed from `at.glean.subscription` records on user PDS.
507506 ```sql
508507 CREATE TABLE subscriptions (
509508 id INTEGER PRIMARY KEY AUTOINCREMENT,
510- user_did TEXT NOT NULL REFERENCES users(did),
509+ user_did TEXT NOT NULL,
511510 feed_url TEXT NOT NULL,
512511 title TEXT,
513512 category TEXT,
@@ -537,8 +536,6 @@ CREATE TABLE feeds (
537536 subscriber_count INTEGER NOT NULL DEFAULT 0,
538537 etag TEXT,
539538 last_modified TEXT,
540- fetch_interval_minutes INTEGER NOT NULL DEFAULT 30,
541- next_fetch_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
542539 consecutive_empty_fetches INTEGER NOT NULL DEFAULT 0,
543540 error_count INTEGER NOT NULL DEFAULT 0,
544541 favicon_url TEXT
@@ -552,13 +549,14 @@ Fetched from RSS feeds. Only fetched for feeds that have local subscribers.
552549 ```sql
553550 CREATE TABLE articles (
554551 id INTEGER PRIMARY KEY AUTOINCREMENT,
555- feed_url TEXT NOT NULL REFERENCES feeds(feed_url),
552+ feed_url TEXT NOT NULL,
556553 guid TEXT NOT NULL,
557554 title TEXT NOT NULL DEFAULT '',
558555 url TEXT,
559556 author TEXT,
560557 summary TEXT,
561558 content TEXT,
559+ full_content TEXT,
562560 published DATETIME,
563561 updated DATETIME,
564562 fetched_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
@@ -573,8 +571,8 @@ CREATE INDEX idx_articles_published ON articles(published DESC);
573571
574572 ```sql
575573 CREATE TABLE read_state (
576- user_did TEXT NOT NULL REFERENCES users(did),
577- article_id INTEGER NOT NULL REFERENCES articles(id),
574+ user_did TEXT NOT NULL,
575+ article_id INTEGER NOT NULL,
578576 is_read BOOLEAN NOT NULL DEFAULT 0,
579577 read_at DATETIME,
580578 PRIMARY KEY (user_did, article_id)
@@ -591,7 +589,7 @@ Local mirror of AT Protocol lexicon records for fast querying.
591589 CREATE TABLE annotations (
592590 id INTEGER PRIMARY KEY AUTOINCREMENT,
593591 uri TEXT NOT NULL UNIQUE,
594- author_did TEXT NOT NULL REFERENCES users(did),
592+ author_did TEXT NOT NULL,
595593 feed_url TEXT NOT NULL,
596594 article_url TEXT NOT NULL,
597595 quote TEXT,
@@ -605,7 +603,7 @@ CREATE TABLE annotations (
605603 CREATE TABLE likes (
606604 id INTEGER PRIMARY KEY AUTOINCREMENT,
607605 uri TEXT NOT NULL UNIQUE,
608- author_did TEXT NOT NULL REFERENCES users(did),
606+ author_did TEXT NOT NULL,
609607 feed_url TEXT NOT NULL,
610608 article_url TEXT NOT NULL,
611609 created_at DATETIME NOT NULL,
@@ -620,8 +618,8 @@ Stores precomputed similarity data to avoid recalculating on every request.
620618
621619 ```sql
622620 CREATE TABLE feed_similarity (
623- feed_a TEXT NOT NULL REFERENCES feeds(feed_url),
624- feed_b TEXT NOT NULL REFERENCES feeds(feed_url),
621+ feed_a TEXT NOT NULL,
622+ feed_b TEXT NOT NULL,
625623 jaccard REAL NOT NULL,
626624 computed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
627625 PRIMARY KEY (feed_a, feed_b),
@@ -629,10 +627,12 @@ CREATE TABLE feed_similarity (
629627 );
630628
631629 CREATE TABLE user_similarity (
632- user_a TEXT NOT NULL REFERENCES users(did),
633- user_b TEXT NOT NULL REFERENCES users(did),
630+ user_a TEXT NOT NULL,
631+ user_b TEXT NOT NULL,
634632 jaccard REAL NOT NULL,
635633 common_feeds INTEGER NOT NULL,
634+ common_likes INTEGER NOT NULL DEFAULT 0,
635+ common_tags INTEGER NOT NULL DEFAULT 0,
636636 computed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
637637 PRIMARY KEY (user_a, user_b),
638638 CHECK(user_a < user_b)
@@ -645,7 +645,7 @@ Tracks follow relationships between users (from `app.bsky.graph.follow` and `sh.
645645
646646 ```sql
647647 CREATE TABLE follows (
648- user_did TEXT NOT NULL REFERENCES users(did),
648+ user_did TEXT NOT NULL,
649649 target_did TEXT NOT NULL,
650650 uri TEXT,
651651 cid TEXT,
@@ -673,18 +673,20 @@ CREATE TABLE oauth_sessions (
673673 );
674674 ```
675675
676+## 7. Recommendations
677+
676678 Glean uses a multi-signal recommendation system that combines subscription overlap, like patterns, social graph distance, and user behavior feedback.
677679
678680 ### 7.1 Signals
679681
680-| Signal | Source | Weight (default) | Description |
681-|--------|--------|-------------------|-------------|
682-| Subscription | `subscriptions` | 1.0 | Jaccard over subscriber sets between similar users |
683-| Like | `likes` | 0.5 | Time-decayed like co-occurrence (30-day half-life) |
684-| Tag | `annotations.tags` | 0.3 | Jaccard over annotation tag sets |
685-| Social | `follow_distances` | 0.7 | Follow distance: 1-hop=1.0, 2-hop=0.3 |
686-| Popularity | `feeds.subscriber_count` | 0.2 | `log(1 + subscribers) / log(1 + max)` |
687-| Category | `subscriptions.category` | 0.4 | Boost feeds matching user's existing categories |
682+| Signal | Source | Weight (default) | Description |
683+| ------------ | ------------------------ | ---------------- | -------------------------------------------------- |
684+| Subscription | `subscriptions` | 1.0 | Jaccard over subscriber sets between similar users |
685+| Like | `likes` | 0.5 | Time-decayed like co-occurrence (30-day half-life) |
686+| Tag | `annotations.tags` | 0.3 | Jaccard over annotation tag sets |
687+| Social | `follow_distances` | 0.7 | Follow distance: 1-hop=1.0, 2-hop=0.3 |
688+| Popularity | `feeds.subscriber_count` | 0.2 | `log(1 + subscribers) / log(1 + max)` |
689+| Category | `subscriptions.category` | 0.4 | Boost feeds matching user's existing categories |
688690
689691 ### 7.2 Feed Co-occurrence (Jaccard Similarity)
690692
@@ -721,6 +723,7 @@ score = sub_signal * w_sub
721723 ```
722724
723725 Where:
726+
724727 - `sub_signal = SUM(jaccard(target, U))` for similar users U subscribed to feed
725728 - `like_signal = SUM(jaccard(target, U) * time_decay)` for likes in that feed by similar users
726729 - `social_signal = SUM(distance_weight)` from follow_distances
@@ -794,11 +797,11 @@ A background goroutine runs on a configurable schedule (`GLEAN_CLUSTER_INTERVAL`
794797
795798 Jetstream ingestion and record indexing happen in a separate persistent goroutine (the Jetstream consumer), not in the cron.
796799
797-### 7.11 New Database Tables
800+### 7.11 Recommendation Tables (`<base>_recs`)
798801
799802 ```sql
800803 CREATE TABLE dismissed_recommendations (
801- user_did TEXT NOT NULL REFERENCES users(did),
804+ user_did TEXT NOT NULL,
802805 target_type TEXT NOT NULL CHECK(target_type IN ('feed', 'article')),
803806 target_id TEXT NOT NULL,
804807 reason TEXT,
@@ -807,7 +810,7 @@ CREATE TABLE dismissed_recommendations (
807810 );
808811
809812 CREATE TABLE recommendation_impressions (
810- user_did TEXT NOT NULL REFERENCES users(did),
813+ user_did TEXT NOT NULL,
811814 target_type TEXT NOT NULL CHECK(target_type IN ('feed', 'article')),
812815 target_id TEXT NOT NULL,
813816 first_shown_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
@@ -825,7 +828,7 @@ CREATE TABLE follow_distances (
825828 );
826829
827830 CREATE TABLE user_signal_weights (
828- user_did TEXT PRIMARY KEY REFERENCES users(did),
831+ user_did TEXT PRIMARY KEY,
829832 w_sub REAL NOT NULL DEFAULT 1.0,
830833 w_like REAL NOT NULL DEFAULT 0.5,
831834 w_tag REAL NOT NULL DEFAULT 0.3,
@@ -836,7 +839,7 @@ CREATE TABLE user_signal_weights (
836839 );
837840
838841 CREATE TABLE user_signal_profiles (
839- user_did TEXT PRIMARY KEY REFERENCES users(did),
842+ user_did TEXT PRIMARY KEY,
840843 total_likes INTEGER NOT NULL DEFAULT 0,
841844 total_tags INTEGER NOT NULL DEFAULT 0,
842845 top_categories TEXT,
@@ -861,17 +864,19 @@ The server renders HTML fragments that htmx swaps into the page. No JSON API nee
861864 | `/feeds/add` | POST | Add a single feed URL |
862865 | `/feeds/remove` | DELETE | Remove a feed |
863866 | `/feeds/refresh` | POST | Refresh all subscribed feeds |
864-| `/feeds/clear` | POST | Clear all subscriptions |
865-| `/feeds/dismiss` | POST | Dismiss a feed recommendation |
867+| `/feeds/retry` | POST | Retry a failed feed |
868+| `/feeds/clear` | POST | Clear all subscriptions |
869+| `/feeds/dismiss` | POST | Dismiss a feed recommendation |
866870 | `/articles` | GET | Read articles (paginated, filterable by feed) |
871+| `/articles/new-count` | GET | Get count of new articles (for badge updates) |
867872 | `/articles/{id}` | GET | Article detail view |
868873 | `/articles/{id}/read` | POST | Mark article as read |
869874 | `/articles/{id}/unread` | POST | Mark article as unread |
870875 | `/articles/{id}/like` | POST | Like an article |
871876 | `/articles/{id}/fetch-content` | POST | Fetch full article content from original URL |
872-| `/articles/mark-all-read` | POST | Mark all articles as read |
873-| `/articles/dismiss` | POST | Dismiss an article recommendation |
874-| `/trending` | GET | Community feed: articles ranked by likes |
877+| `/articles/mark-all-read` | POST | Mark all articles as read |
878+| `/articles/dismiss` | POST | Dismiss an article recommendation |
879+| `/trending` | GET | Community feed: articles ranked by likes |
875880 | `/library` | GET | Liked articles and annotations |
876881 | `/library/create` | POST | Create annotation on an article |
877882 | `/library/{id}/delete` | POST | Delete an annotation |
@@ -926,6 +931,8 @@ glean/
926931 │ │ ├── fetcher.go # Scheduler with dedup + Fetcher
927932 │ │ ├── discover.go # Feed auto-discovery from URLs
928933 │ │ └── opml.go # OPML import/export
934+│ ├── httpclient/
935+│ │ └── httpclient.go # Shared HTTP transport, retry logic, User-Agent
929936 │ ├── scraper/
930937 │ │ └── scraper.go # Full article content scraper
931938 │ ├── metrics/
@@ -965,6 +972,7 @@ glean/
965972 │ ├── trending.html # Trending articles
966973 │ ├── library.html # Liked articles + annotations
967974 │ ├── profile.html # User profile
975+│ ├── error.html # Error page
968976 │ ├── 404.html # Not found page
969977 │ └── partials/ # Reusable template fragments
970978 ├── static/
@@ -1051,13 +1059,16 @@ Browser ──GET /discover/feeds──► Server
10511059
10521060 Glean exposes a `/metrics` endpoint for monitoring. Key metrics:
10531061
1054-- **`glean_feeds_fetched_total`** — Feed fetch attempts labeled by status (`success`, `error`, `not_modified`)
1062+- **`glean_feeds_fetched_total`** — Total feed fetch attempts (counter)
1063+- **`glean_feeds_fetched_last_timestamp_seconds`** — Unix timestamp of last feed fetch (gauge)
10551064 - **`glean_feed_fetch_duration_seconds`** — Histogram of feed fetch latency
10561065 - **`glean_articles_upserted_total`** — Counter of articles stored from feeds
10571066 - **`glean_jetstream_events_total`** — Jetstream events labeled by collection and action
10581067 - **`glean_jetstream_errors_total`** — Jetstream handler errors
10591068 - **`glean_jetstream_reconnects_total`** — Jetstream reconnection count
10601069 - **`glean_http_requests_total`** — HTTP request counts labeled by method, path, and status
1070+- **`glean_http_request_duration_seconds`** — HTTP request duration labeled by method and path
1071+- **`glean_users_active_total`** — Number of users with active sessions
10611072 - **`glean_pds_sync_runs_total`** / **`glean_pds_sync_errors_total`** — PDS sync runs and errors
10621073 - **`glean_cluster_runs_total`** / **`glean_cluster_duration_seconds`** — Recommendation engine runs and timing
10631074
@@ -13,7 +13,7 @@ The core idea: your RSS subscriptions are a strong signal about your interests.
13 | Layer | Technology |13 | Layer | Technology |
14 | ---------------- | --------------------------------------------------------------- |14 | ---------------- | --------------------------------------------------------------- |
15 | Backend | Go |15 | Backend | Go |
16-| Database | SQLite (3 files: users, articles, recs via `mattn/go-sqlite3`) |16+| Database | SQLite (3 files: users, articles, recs via `mattn/go-sqlite3`) |
17 | Frontend | htmx + TailwindCSS |17 | Frontend | htmx + TailwindCSS |
18 | Auth | AT Protocol OAuth / DID resolution (configurable PLC directory) |18 | Auth | AT Protocol OAuth / DID resolution (configurable PLC directory) |
19 | AT Protocol role | AppView for `at.glean.*` lexicons |19 | AT Protocol role | AppView for `at.glean.*` lexicons |
@@ -374,7 +374,7 @@ Glean stores article content locally so the reading experience is fast and consi
374 ```sql374 ```sql
375 CREATE TABLE articles (375 CREATE TABLE articles (
376 id INTEGER PRIMARY KEY AUTOINCREMENT,376 id INTEGER PRIMARY KEY AUTOINCREMENT,
377- feed_url TEXT NOT NULL REFERENCES feeds(feed_url),377+ feed_url TEXT NOT NULL,
378 guid TEXT NOT NULL,378 guid TEXT NOT NULL,
379 title TEXT NOT NULL DEFAULT '',379 title TEXT NOT NULL DEFAULT '',
380 url TEXT,380 url TEXT,
@@ -400,8 +400,8 @@ Read/unread state is tracked per user per article:
400 400
401 ```sql401 ```sql
402 CREATE TABLE read_state (402 CREATE TABLE read_state (
403- user_did TEXT NOT NULL REFERENCES users(did),403+ user_did TEXT NOT NULL,
404- article_id INTEGER NOT NULL REFERENCES articles(id),404+ article_id INTEGER NOT NULL,
405 is_read BOOLEAN NOT NULL DEFAULT 0,405 is_read BOOLEAN NOT NULL DEFAULT 0,
406 read_at DATETIME,406 read_at DATETIME,
407 PRIMARY KEY (user_did, article_id)407 PRIMARY KEY (user_did, article_id)
@@ -477,24 +477,23 @@ Glean runs as a single Go binary that fills three roles: **AppView** (indexing `
477 477
478 Glean uses three separate SQLite database files to reduce write-lock contention. Each is opened with its own connection pool:478 Glean uses three separate SQLite database files to reduce write-lock contention. Each is opened with its own connection pool:
479 479
480-| File | Contents | ATTACH alias |480+| File | Contents | ATTACH alias |
481-|------|----------|-------------|481+| ----------------- | -------------------------------------------------------------- | ---------------- |
482-| `<base>_users` | Users, follows, OAuth | `main` (primary) |482+| `<base>_users` | Users, follows, OAuth | `main` (primary) |
483-| `<base>_articles` | Feeds, subscriptions, articles, read state, likes, annotations | `articles` |483+| `<base>_articles` | Feeds, subscriptions, articles, read state, likes, annotations | `articles` |
484-| `<base>_recs` | Similarity scores, impressions, dismissals, signal weights | `recs` |484+| `<base>_recs` | Similarity scores, impressions, dismissals, signal weights | `recs` |
485 485
486 The users connection pool uses a custom SQLite driver with a `ConnectHook` that ATTACHes the articles and recs databases on every new connection. This allows the cluster engine to run cross-database queries using schema prefixes (`articles.subscriptions`, `recs.user_similarity`, `main.follows`).486 The users connection pool uses a custom SQLite driver with a `ConnectHook` that ATTACHes the articles and recs databases on every new connection. This allows the cluster engine to run cross-database queries using schema prefixes (`articles.subscriptions`, `recs.user_similarity`, `main.follows`).
487 487
488-The articles and recs connections are independent pools used by the service layer for single-database operations.488+Foreign key constraints are not used because SQLite does not support foreign keys across ATTACHed databases. Referential integrity is enforced by the application layer.
489 489
490 ### 6.1 Users (`<base>_users`)490 ### 6.1 Users (`<base>_users`)
491 491
492+Profile data (handle, display name, avatar) is resolved on-the-fly via AT Protocol identity resolution rather than stored locally.
493+
492 ```sql494 ```sql
493 CREATE TABLE users (495 CREATE TABLE users (
494 did TEXT PRIMARY KEY,496 did TEXT PRIMARY KEY,
495- handle TEXT NOT NULL,
496- display_name TEXT,
497- avatar_url TEXT,
498 indexed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,497 indexed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
499 updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP498 updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
500 );499 );
@@ -507,7 +506,7 @@ Indexed from `at.glean.subscription` records on user PDS.
507 ```sql506 ```sql
508 CREATE TABLE subscriptions (507 CREATE TABLE subscriptions (
509 id INTEGER PRIMARY KEY AUTOINCREMENT,508 id INTEGER PRIMARY KEY AUTOINCREMENT,
510- user_did TEXT NOT NULL REFERENCES users(did),509+ user_did TEXT NOT NULL,
511 feed_url TEXT NOT NULL,510 feed_url TEXT NOT NULL,
512 title TEXT,511 title TEXT,
513 category TEXT,512 category TEXT,
@@ -537,8 +536,6 @@ CREATE TABLE feeds (
537 subscriber_count INTEGER NOT NULL DEFAULT 0,536 subscriber_count INTEGER NOT NULL DEFAULT 0,
538 etag TEXT,537 etag TEXT,
539 last_modified TEXT,538 last_modified TEXT,
540- fetch_interval_minutes INTEGER NOT NULL DEFAULT 30,
541- next_fetch_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
542 consecutive_empty_fetches INTEGER NOT NULL DEFAULT 0,539 consecutive_empty_fetches INTEGER NOT NULL DEFAULT 0,
543 error_count INTEGER NOT NULL DEFAULT 0,540 error_count INTEGER NOT NULL DEFAULT 0,
544 favicon_url TEXT541 favicon_url TEXT
@@ -552,13 +549,14 @@ Fetched from RSS feeds. Only fetched for feeds that have local subscribers.
552 ```sql549 ```sql
553 CREATE TABLE articles (550 CREATE TABLE articles (
554 id INTEGER PRIMARY KEY AUTOINCREMENT,551 id INTEGER PRIMARY KEY AUTOINCREMENT,
555- feed_url TEXT NOT NULL REFERENCES feeds(feed_url),552+ feed_url TEXT NOT NULL,
556 guid TEXT NOT NULL,553 guid TEXT NOT NULL,
557 title TEXT NOT NULL DEFAULT '',554 title TEXT NOT NULL DEFAULT '',
558 url TEXT,555 url TEXT,
559 author TEXT,556 author TEXT,
560 summary TEXT,557 summary TEXT,
561 content TEXT,558 content TEXT,
559+ full_content TEXT,
562 published DATETIME,560 published DATETIME,
563 updated DATETIME,561 updated DATETIME,
564 fetched_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,562 fetched_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
@@ -573,8 +571,8 @@ CREATE INDEX idx_articles_published ON articles(published DESC);
573 571
574 ```sql572 ```sql
575 CREATE TABLE read_state (573 CREATE TABLE read_state (
576- user_did TEXT NOT NULL REFERENCES users(did),574+ user_did TEXT NOT NULL,
577- article_id INTEGER NOT NULL REFERENCES articles(id),575+ article_id INTEGER NOT NULL,
578 is_read BOOLEAN NOT NULL DEFAULT 0,576 is_read BOOLEAN NOT NULL DEFAULT 0,
579 read_at DATETIME,577 read_at DATETIME,
580 PRIMARY KEY (user_did, article_id)578 PRIMARY KEY (user_did, article_id)
@@ -591,7 +589,7 @@ Local mirror of AT Protocol lexicon records for fast querying.
591 CREATE TABLE annotations (589 CREATE TABLE annotations (
592 id INTEGER PRIMARY KEY AUTOINCREMENT,590 id INTEGER PRIMARY KEY AUTOINCREMENT,
593 uri TEXT NOT NULL UNIQUE,591 uri TEXT NOT NULL UNIQUE,
594- author_did TEXT NOT NULL REFERENCES users(did),592+ author_did TEXT NOT NULL,
595 feed_url TEXT NOT NULL,593 feed_url TEXT NOT NULL,
596 article_url TEXT NOT NULL,594 article_url TEXT NOT NULL,
597 quote TEXT,595 quote TEXT,
@@ -605,7 +603,7 @@ CREATE TABLE annotations (
605 CREATE TABLE likes (603 CREATE TABLE likes (
606 id INTEGER PRIMARY KEY AUTOINCREMENT,604 id INTEGER PRIMARY KEY AUTOINCREMENT,
607 uri TEXT NOT NULL UNIQUE,605 uri TEXT NOT NULL UNIQUE,
608- author_did TEXT NOT NULL REFERENCES users(did),606+ author_did TEXT NOT NULL,
609 feed_url TEXT NOT NULL,607 feed_url TEXT NOT NULL,
610 article_url TEXT NOT NULL,608 article_url TEXT NOT NULL,
611 created_at DATETIME NOT NULL,609 created_at DATETIME NOT NULL,
@@ -620,8 +618,8 @@ Stores precomputed similarity data to avoid recalculating on every request.
620 618
621 ```sql619 ```sql
622 CREATE TABLE feed_similarity (620 CREATE TABLE feed_similarity (
623- feed_a TEXT NOT NULL REFERENCES feeds(feed_url),621+ feed_a TEXT NOT NULL,
624- feed_b TEXT NOT NULL REFERENCES feeds(feed_url),622+ feed_b TEXT NOT NULL,
625 jaccard REAL NOT NULL,623 jaccard REAL NOT NULL,
626 computed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,624 computed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
627 PRIMARY KEY (feed_a, feed_b),625 PRIMARY KEY (feed_a, feed_b),
@@ -629,10 +627,12 @@ CREATE TABLE feed_similarity (
629 );627 );
630 628
631 CREATE TABLE user_similarity (629 CREATE TABLE user_similarity (
632- user_a TEXT NOT NULL REFERENCES users(did),630+ user_a TEXT NOT NULL,
633- user_b TEXT NOT NULL REFERENCES users(did),631+ user_b TEXT NOT NULL,
634 jaccard REAL NOT NULL,632 jaccard REAL NOT NULL,
635 common_feeds INTEGER NOT NULL,633 common_feeds INTEGER NOT NULL,
634+ common_likes INTEGER NOT NULL DEFAULT 0,
635+ common_tags INTEGER NOT NULL DEFAULT 0,
636 computed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,636 computed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
637 PRIMARY KEY (user_a, user_b),637 PRIMARY KEY (user_a, user_b),
638 CHECK(user_a < user_b)638 CHECK(user_a < user_b)
@@ -645,7 +645,7 @@ Tracks follow relationships between users (from `app.bsky.graph.follow` and `sh.
645 645
646 ```sql646 ```sql
647 CREATE TABLE follows (647 CREATE TABLE follows (
648- user_did TEXT NOT NULL REFERENCES users(did),648+ user_did TEXT NOT NULL,
649 target_did TEXT NOT NULL,649 target_did TEXT NOT NULL,
650 uri TEXT,650 uri TEXT,
651 cid TEXT,651 cid TEXT,
@@ -673,18 +673,20 @@ CREATE TABLE oauth_sessions (
673 );673 );
674 ```674 ```
675 675
676+## 7. Recommendations
677+
676 Glean uses a multi-signal recommendation system that combines subscription overlap, like patterns, social graph distance, and user behavior feedback.678 Glean uses a multi-signal recommendation system that combines subscription overlap, like patterns, social graph distance, and user behavior feedback.
677 679
678 ### 7.1 Signals680 ### 7.1 Signals
679 681
680-| Signal | Source | Weight (default) | Description |682+| Signal | Source | Weight (default) | Description |
681-|--------|--------|-------------------|-------------|683+| ------------ | ------------------------ | ---------------- | -------------------------------------------------- |
682-| Subscription | `subscriptions` | 1.0 | Jaccard over subscriber sets between similar users |684+| Subscription | `subscriptions` | 1.0 | Jaccard over subscriber sets between similar users |
683-| Like | `likes` | 0.5 | Time-decayed like co-occurrence (30-day half-life) |685+| Like | `likes` | 0.5 | Time-decayed like co-occurrence (30-day half-life) |
684-| Tag | `annotations.tags` | 0.3 | Jaccard over annotation tag sets |686+| Tag | `annotations.tags` | 0.3 | Jaccard over annotation tag sets |
685-| Social | `follow_distances` | 0.7 | Follow distance: 1-hop=1.0, 2-hop=0.3 |687+| Social | `follow_distances` | 0.7 | Follow distance: 1-hop=1.0, 2-hop=0.3 |
686-| Popularity | `feeds.subscriber_count` | 0.2 | `log(1 + subscribers) / log(1 + max)` |688+| Popularity | `feeds.subscriber_count` | 0.2 | `log(1 + subscribers) / log(1 + max)` |
687-| Category | `subscriptions.category` | 0.4 | Boost feeds matching user's existing categories |689+| Category | `subscriptions.category` | 0.4 | Boost feeds matching user's existing categories |
688 690
689 ### 7.2 Feed Co-occurrence (Jaccard Similarity)691 ### 7.2 Feed Co-occurrence (Jaccard Similarity)
690 692
@@ -721,6 +723,7 @@ score = sub_signal * w_sub
721 ```723 ```
722 724
723 Where:725 Where:
726+
724 - `sub_signal = SUM(jaccard(target, U))` for similar users U subscribed to feed727 - `sub_signal = SUM(jaccard(target, U))` for similar users U subscribed to feed
725 - `like_signal = SUM(jaccard(target, U) * time_decay)` for likes in that feed by similar users728 - `like_signal = SUM(jaccard(target, U) * time_decay)` for likes in that feed by similar users
726 - `social_signal = SUM(distance_weight)` from follow_distances729 - `social_signal = SUM(distance_weight)` from follow_distances
@@ -794,11 +797,11 @@ A background goroutine runs on a configurable schedule (`GLEAN_CLUSTER_INTERVAL`
794 797
795 Jetstream ingestion and record indexing happen in a separate persistent goroutine (the Jetstream consumer), not in the cron.798 Jetstream ingestion and record indexing happen in a separate persistent goroutine (the Jetstream consumer), not in the cron.
796 799
797-### 7.11 New Database Tables800+### 7.11 Recommendation Tables (`<base>_recs`)
798 801
799 ```sql802 ```sql
800 CREATE TABLE dismissed_recommendations (803 CREATE TABLE dismissed_recommendations (
801- user_did TEXT NOT NULL REFERENCES users(did),804+ user_did TEXT NOT NULL,
802 target_type TEXT NOT NULL CHECK(target_type IN ('feed', 'article')),805 target_type TEXT NOT NULL CHECK(target_type IN ('feed', 'article')),
803 target_id TEXT NOT NULL,806 target_id TEXT NOT NULL,
804 reason TEXT,807 reason TEXT,
@@ -807,7 +810,7 @@ CREATE TABLE dismissed_recommendations (
807 );810 );
808 811
809 CREATE TABLE recommendation_impressions (812 CREATE TABLE recommendation_impressions (
810- user_did TEXT NOT NULL REFERENCES users(did),813+ user_did TEXT NOT NULL,
811 target_type TEXT NOT NULL CHECK(target_type IN ('feed', 'article')),814 target_type TEXT NOT NULL CHECK(target_type IN ('feed', 'article')),
812 target_id TEXT NOT NULL,815 target_id TEXT NOT NULL,
813 first_shown_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,816 first_shown_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
@@ -825,7 +828,7 @@ CREATE TABLE follow_distances (
825 );828 );
826 829
827 CREATE TABLE user_signal_weights (830 CREATE TABLE user_signal_weights (
828- user_did TEXT PRIMARY KEY REFERENCES users(did),831+ user_did TEXT PRIMARY KEY,
829 w_sub REAL NOT NULL DEFAULT 1.0,832 w_sub REAL NOT NULL DEFAULT 1.0,
830 w_like REAL NOT NULL DEFAULT 0.5,833 w_like REAL NOT NULL DEFAULT 0.5,
831 w_tag REAL NOT NULL DEFAULT 0.3,834 w_tag REAL NOT NULL DEFAULT 0.3,
@@ -836,7 +839,7 @@ CREATE TABLE user_signal_weights (
836 );839 );
837 840
838 CREATE TABLE user_signal_profiles (841 CREATE TABLE user_signal_profiles (
839- user_did TEXT PRIMARY KEY REFERENCES users(did),842+ user_did TEXT PRIMARY KEY,
840 total_likes INTEGER NOT NULL DEFAULT 0,843 total_likes INTEGER NOT NULL DEFAULT 0,
841 total_tags INTEGER NOT NULL DEFAULT 0,844 total_tags INTEGER NOT NULL DEFAULT 0,
842 top_categories TEXT,845 top_categories TEXT,
@@ -861,17 +864,19 @@ The server renders HTML fragments that htmx swaps into the page. No JSON API nee
861 | `/feeds/add` | POST | Add a single feed URL |864 | `/feeds/add` | POST | Add a single feed URL |
862 | `/feeds/remove` | DELETE | Remove a feed |865 | `/feeds/remove` | DELETE | Remove a feed |
863 | `/feeds/refresh` | POST | Refresh all subscribed feeds |866 | `/feeds/refresh` | POST | Refresh all subscribed feeds |
864-| `/feeds/clear` | POST | Clear all subscriptions |867+| `/feeds/retry` | POST | Retry a failed feed |
865-| `/feeds/dismiss` | POST | Dismiss a feed recommendation |868+| `/feeds/clear` | POST | Clear all subscriptions |
869+| `/feeds/dismiss` | POST | Dismiss a feed recommendation |
866 | `/articles` | GET | Read articles (paginated, filterable by feed) |870 | `/articles` | GET | Read articles (paginated, filterable by feed) |
871+| `/articles/new-count` | GET | Get count of new articles (for badge updates) |
867 | `/articles/{id}` | GET | Article detail view |872 | `/articles/{id}` | GET | Article detail view |
868 | `/articles/{id}/read` | POST | Mark article as read |873 | `/articles/{id}/read` | POST | Mark article as read |
869 | `/articles/{id}/unread` | POST | Mark article as unread |874 | `/articles/{id}/unread` | POST | Mark article as unread |
870 | `/articles/{id}/like` | POST | Like an article |875 | `/articles/{id}/like` | POST | Like an article |
871 | `/articles/{id}/fetch-content` | POST | Fetch full article content from original URL |876 | `/articles/{id}/fetch-content` | POST | Fetch full article content from original URL |
872-| `/articles/mark-all-read` | POST | Mark all articles as read |877+| `/articles/mark-all-read` | POST | Mark all articles as read |
873-| `/articles/dismiss` | POST | Dismiss an article recommendation |878+| `/articles/dismiss` | POST | Dismiss an article recommendation |
874-| `/trending` | GET | Community feed: articles ranked by likes |879+| `/trending` | GET | Community feed: articles ranked by likes |
875 | `/library` | GET | Liked articles and annotations |880 | `/library` | GET | Liked articles and annotations |
876 | `/library/create` | POST | Create annotation on an article |881 | `/library/create` | POST | Create annotation on an article |
877 | `/library/{id}/delete` | POST | Delete an annotation |882 | `/library/{id}/delete` | POST | Delete an annotation |
@@ -926,6 +931,8 @@ glean/
926 │ │ ├── fetcher.go # Scheduler with dedup + Fetcher931 │ │ ├── fetcher.go # Scheduler with dedup + Fetcher
927 │ │ ├── discover.go # Feed auto-discovery from URLs932 │ │ ├── discover.go # Feed auto-discovery from URLs
928 │ │ └── opml.go # OPML import/export933 │ │ └── opml.go # OPML import/export
934+│ ├── httpclient/
935+│ │ └── httpclient.go # Shared HTTP transport, retry logic, User-Agent
929 │ ├── scraper/936 │ ├── scraper/
930 │ │ └── scraper.go # Full article content scraper937 │ │ └── scraper.go # Full article content scraper
931 │ ├── metrics/938 │ ├── metrics/
@@ -965,6 +972,7 @@ glean/
965 │ ├── trending.html # Trending articles972 │ ├── trending.html # Trending articles
966 │ ├── library.html # Liked articles + annotations973 │ ├── library.html # Liked articles + annotations
967 │ ├── profile.html # User profile974 │ ├── profile.html # User profile
975+│ ├── error.html # Error page
968 │ ├── 404.html # Not found page976 │ ├── 404.html # Not found page
969 │ └── partials/ # Reusable template fragments977 │ └── partials/ # Reusable template fragments
970 ├── static/978 ├── static/
@@ -1051,13 +1059,16 @@ Browser ──GET /discover/feeds──► Server
1051 1059
1052 Glean exposes a `/metrics` endpoint for monitoring. Key metrics:1060 Glean exposes a `/metrics` endpoint for monitoring. Key metrics:
1053 1061
1054-- **`glean_feeds_fetched_total`** — Feed fetch attempts labeled by status (`success`, `error`, `not_modified`)1062+- **`glean_feeds_fetched_total`** — Total feed fetch attempts (counter)
1063+- **`glean_feeds_fetched_last_timestamp_seconds`** — Unix timestamp of last feed fetch (gauge)
1055 - **`glean_feed_fetch_duration_seconds`** — Histogram of feed fetch latency1064 - **`glean_feed_fetch_duration_seconds`** — Histogram of feed fetch latency
1056 - **`glean_articles_upserted_total`** — Counter of articles stored from feeds1065 - **`glean_articles_upserted_total`** — Counter of articles stored from feeds
1057 - **`glean_jetstream_events_total`** — Jetstream events labeled by collection and action1066 - **`glean_jetstream_events_total`** — Jetstream events labeled by collection and action
1058 - **`glean_jetstream_errors_total`** — Jetstream handler errors1067 - **`glean_jetstream_errors_total`** — Jetstream handler errors
1059 - **`glean_jetstream_reconnects_total`** — Jetstream reconnection count1068 - **`glean_jetstream_reconnects_total`** — Jetstream reconnection count
1060 - **`glean_http_requests_total`** — HTTP request counts labeled by method, path, and status1069 - **`glean_http_requests_total`** — HTTP request counts labeled by method, path, and status
1070+- **`glean_http_request_duration_seconds`** — HTTP request duration labeled by method and path
1071+- **`glean_users_active_total`** — Number of users with active sessions
1061 - **`glean_pds_sync_runs_total`** / **`glean_pds_sync_errors_total`** — PDS sync runs and errors1072 - **`glean_pds_sync_runs_total`** / **`glean_pds_sync_errors_total`** — PDS sync runs and errors
1062 - **`glean_cluster_runs_total`** / **`glean_cluster_duration_seconds`** — Recommendation engine runs and timing1073 - **`glean_cluster_runs_total`** / **`glean_cluster_duration_seconds`** — Recommendation engine runs and timing
1063 1074
modified readme.md +1 -0
@@ -46,6 +46,7 @@ Then open `http://localhost:8080`.
4646 | `GLEAN_CLUSTER_INTERVAL` | `10m` | Cluster recomputation interval (Go duration) |
4747 | `GLEAN_FETCH_INTERVAL` | `5m` | Feed fetch scheduler tick interval (Go duration) |
4848 | `GLEAN_COLLECTION_DIR_URL` | _(empty)_ | Collection directory URL for startup backfill |
49+| `GLEAN_BACKFILL_CONCURRENCY` | `5` | Max concurrent backfill workers |
4950 | `GLEAN_PLC_URL` | `https://didplc.glean.at` | PLC directory URL for DID resolution |
5051 | `GLEAN_OAUTH_CLIENT_ID` | _(empty)_ | OAuth client metadata URL (leave empty for localhost dev) |
5152 | `GLEAN_OAUTH_REDIRECT_URL` | _(empty)_ | OAuth redirect URL (leave empty for localhost dev) |
@@ -46,6 +46,7 @@ Then open `http://localhost:8080`.
46 | `GLEAN_CLUSTER_INTERVAL` | `10m` | Cluster recomputation interval (Go duration) |46 | `GLEAN_CLUSTER_INTERVAL` | `10m` | Cluster recomputation interval (Go duration) |
47 | `GLEAN_FETCH_INTERVAL` | `5m` | Feed fetch scheduler tick interval (Go duration) |47 | `GLEAN_FETCH_INTERVAL` | `5m` | Feed fetch scheduler tick interval (Go duration) |
48 | `GLEAN_COLLECTION_DIR_URL` | _(empty)_ | Collection directory URL for startup backfill |48 | `GLEAN_COLLECTION_DIR_URL` | _(empty)_ | Collection directory URL for startup backfill |
49+| `GLEAN_BACKFILL_CONCURRENCY` | `5` | Max concurrent backfill workers |
49 | `GLEAN_PLC_URL` | `https://didplc.glean.at` | PLC directory URL for DID resolution |50 | `GLEAN_PLC_URL` | `https://didplc.glean.at` | PLC directory URL for DID resolution |
50 | `GLEAN_OAUTH_CLIENT_ID` | _(empty)_ | OAuth client metadata URL (leave empty for localhost dev) |51 | `GLEAN_OAUTH_CLIENT_ID` | _(empty)_ | OAuth client metadata URL (leave empty for localhost dev) |
51 | `GLEAN_OAUTH_REDIRECT_URL` | _(empty)_ | OAuth redirect URL (leave empty for localhost dev) |52 | `GLEAN_OAUTH_REDIRECT_URL` | _(empty)_ | OAuth redirect URL (leave empty for localhost dev) |