gabriel / musehub public
Open
aaronrene aaronrene · 19 days ago

musehub#129: rich OG repo preview cards

Summary

Implements dynamic Open Graph preview cards for public repo links (musehub#129).

  • GET /{owner}/{repo}/opengraph-image — 1200×630 PNG via Playwright HTML→PNG
  • Content-hash cache in BlobBackend (objects/sha256:{hash})
  • Repo pages emit og:image / twitter:card=summary_large_image with ?cb= cache bust
  • base.html renders og_meta tags (property for OG, name for Twitter)

Test plan

  • Local Docker: http://localhost:1337/aaronrene/musehub/opengraph-image → 200 PNG 1200×630
  • Local repo page meta tags include og:image + ?cb=
  • OG_01–OG_06 pytest (local harness DB auth issue — app path verified manually)
  • Facebook Sharing Debugger on https://staging.musehub.ai/gabriel/muse after merge (Phase 3b acceptance)

Notes

  • Dockerfile adds Chromium + libcairo (cairosvg for avatar rasterization)
  • Stars omitted from card stats (no star_count on repos yet)
  • Please self-assign reviewer if collaborator self-assign 403s

Closes musehub#129 (pending debugger screenshot post-deploy).

feat/opengraph-repo-cards dev branch
high risk
minor semver
0/2 approvals
merge type
sha256:6ad6d62107bbd6940c52d63327966b8a65c6391f4a3da6cd9e7548ba4b38bc48 from
sha256:fd35b52294fe17892f05804659f29fa44e583018c702ea23073b154375506648 to

Symbol Delta

177 symbols
143 added 34 modified
docs/issues/opengraph-repo-cards-design.md 33
+ musehub#129 — Open Graph repo cards (Phase 1 design)
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 1 — Rendering approach
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 1 — Rendering approach.Avatar embedding
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 1 — Rendering approach.Chosen: HTML template → headless Chromium screenshot (Playwright)
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 1 — Rendering approach.Chosen: HTML template → headless Chromium screenshot (Playwright).table
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 1 — Rendering approach.Font strategy (amended)
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 1 — Rendering approach.Runtime lifecycle (amended)
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 2 — Card layout
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 2 — Card layout.Fallbacks
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 2 — Card layout.Fallbacks.table
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 2 — Card layout.Fields and data sources
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 2 — Card layout.Fields and data sources.table
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 2 — Card layout.Wireframe (1200×630)
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 2 — Card layout.Wireframe (1200×630).code
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 3 — Caching
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 3 — Caching.Crawler cache busting (amended — Phase 3)
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 3 — Caching.Crawler cache busting (amended — Phase 3).code
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 3 — Caching.Strategy: content-hash key + BlobBackend persistence
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 3 — Caching.Strategy: content-hash key + BlobBackend persistence.code
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 3 — Caching.Strategy: content-hash key + BlobBackend persistence.code[json]
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 4 — Routing and wiring
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 4 — Routing and wiring.Endpoint
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 4 — Routing and wiring.New endpoint.code
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 4 — Routing and wiring.Phase 3 — base.html meta tags (amended)
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 4 — Routing and wiring.Phase 3 — base.html meta tags (amended).code[html]
+ musehub#129 — Open Graph repo cards (Phase 1 design).Decision 4 — Routing and wiring.Phase 3 — ui_repo.py
+ musehub#129 — Open Graph repo cards (Phase 1 design).Docker amendments
+ musehub#129 — Open Graph repo cards (Phase 1 design).Goal
+ musehub#129 — Open Graph repo cards (Phase 1 design).Problem (verified in code)
+ musehub#129 — Open Graph repo cards (Phase 1 design).Problem (verified in code).table
+ musehub#129 — Open Graph repo cards (Phase 1 design).Review checklist
+ musehub#129 — Open Graph repo cards (Phase 1 design).Test matrix
+ musehub#129 — Open Graph repo cards (Phase 1 design).Test matrix.table
musehub/api/routes/musehub/__init__.py 1
~ _DIRECT_REGISTERED
musehub/api/routes/musehub/_ui_helpers.py 1
~ _og_tags
musehub/api/routes/musehub/ui_opengraph.py 20
+ import::APIRouter
+ import::AsyncSession
+ import::Depends
+ import::OPENGRAPH_LIMIT
+ import::Request
+ import::Response
+ import::SlugParam
+ import::StarletteResponse
+ import::TokenClaims
+ import::annotations
+ import::collect_repo_card_context
+ import::get_db
+ import::get_or_create_repo_card_png
+ import::http_status
+ import::limiter
+ import::logging
+ import::optional_token
+ logger
+ repo_opengraph_image
+ router
musehub/api/routes/musehub/ui_repo.py 1
~ repo_page
musehub/config.py 1
~ Settings breaking
musehub/main.py 27
+ import::musehub_ui_opengraph_routes
~ import::musehub_discover_routes
~ import::musehub_domains_routes
~ import::musehub_sitemap_routes
~ import::musehub_ui_agents_routes
~ import::musehub_ui_blame_routes
~ import::musehub_ui_blob_routes
~ import::musehub_ui_commits_routes
~ import::musehub_ui_docs_routes
~ import::musehub_ui_domains_routes
~ import::musehub_ui_intel_routes
~ import::musehub_ui_issues_routes
~ import::musehub_ui_legal_routes
~ import::musehub_ui_mists_routes
~ import::musehub_ui_new_repo_routes
~ import::musehub_ui_profile_routes
~ import::musehub_ui_proposals_routes
~ import::musehub_ui_releases_routes
~ import::musehub_ui_repo_routes
~ import::musehub_ui_repo_settings_routes
~ import::musehub_ui_routes
~ import::musehub_ui_sessions_routes
~ import::musehub_ui_symbols_routes
~ import::musehub_ui_topics_routes
~ import::musehub_ui_tree_routes
~ import::musehub_user_routes
~ lifespan
musehub/rate_limits.py 1
+ OPENGRAPH_LIMIT
musehub/services/opengraph_cards.py 34
+ LAYOUT_VERSION
+ OpenGraphCardContext
+ _STUB_PNG
+ _rasterize_sigil_b64
+ _render_locks
+ build_card_context_from_repo_page
+ build_opengraph_image_url_from_request
+ cache_bust_token
+ cache_object_id
+ collect_repo_card_context
+ compute_content_hash
+ description_fallback
+ get_or_create_repo_card_png
+ hash_payload_from_context
+ import::AsyncSession
+ import::MSignContext
+ import::MusehubIdentity
+ import::MusehubIssue
+ import::annotations
+ import::asyncio
+ import::base64
+ import::dataclass
+ import::func
+ import::generate_sigil
+ import::get_backend
+ import::get_opengraph_renderer
+ import::hashlib
+ import::json
+ import::logging
+ import::musehub_repository
+ import::sa_select
+ logger
+ resolve_owner_avatar
+ shutdown_opengraph_renderer
musehub/services/opengraph_renderer.py 27
+ OpenGraphRenderer
+ OpenGraphRenderer.render
+ PlaywrightOpenGraphRenderer
+ PlaywrightOpenGraphRenderer.render
+ StubOpenGraphRenderer
+ StubOpenGraphRenderer.render
+ _STUB_PNG
+ _TEMPLATE_DIR
+ _browser
+ _get_sync_browser
+ _playwright_instance
+ _render_template
+ _renderer_instance
+ _screenshot_html_sync
+ get_opengraph_renderer
+ import::ABC
+ import::Path
+ import::TYPE_CHECKING
+ import::abstractmethod
+ import::annotations
+ import::asyncio
+ import::base64
+ import::logging
+ import::settings
+ logger
+ reset_renderer_for_tests
+ shutdown_renderer
musehub/templates/musehub/base.html 1
~ footer@46 breaking
musehub/templates/musehub/opengraph/repo_card.html 1
+ h1: {{ repo_title }}
pyproject.toml 2
~ project
~ project.dependencies
requirements.txt 1
~ AWS S3 for on-demand asset delivery (drum kits, soundfonts)
tests/test_opengraph_repo_cards.py 26
+ _PNG_MAGIC
+ _make_repo
+ _reset_og_renderer
+ import::AsyncClient
+ import::AsyncSession
+ import::MusehubRepo
+ import::StubOpenGraphRenderer
+ import::annotations
+ import::compute_content_hash
+ import::compute_identity_id
+ import::compute_repo_id
+ import::datetime
+ import::pytest
+ import::reset_renderer_for_tests
+ import::timezone
+ test_content_hash_changes_when_description_changes
+ test_og01_opengraph_image_returns_png
+ test_og01_private_repo_returns_404
+ test_og02_description_in_renderer_context
+ test_og02_empty_description_uses_fallback
+ test_og03_avatar_b64_present_for_unregistered_owner
+ test_og04_stats_in_renderer_context
+ test_og05_cache_hit_avoids_second_render
+ test_og06_repo_page_emits_og_image_meta
+ test_og06_twitter_large_image_card
+ test_og_security_invalid_slug_rejected

Files Changed

16 of 1,036
A docs/issues/opengraph-repo-cards-design.md
A musehub/api/routes/musehub/ui_opengraph.py
A musehub/services/opengraph_cards.py
A musehub/services/opengraph_renderer.py
A musehub/templates/musehub/opengraph/repo_card.html
A tests/test_opengraph_repo_cards.py
M Dockerfile
M musehub/api/routes/musehub/__init__.py
M musehub/api/routes/musehub/_ui_helpers.py
M musehub/api/routes/musehub/ui_repo.py
M musehub/config.py
M musehub/main.py
M musehub/rate_limits.py
M musehub/templates/musehub/base.html
M pyproject.toml
M requirements.txt

Commits

2
feat
feat(musehub#129): OG repo preview cards — endpoint, cache, meta wiring Phase 2–3:...
aaronrene · 19 days ago
minor sha256:6ad6d62107bb
docs
docs(musehub#129): freeze Phase 1 OG repo card design Rendering (Playwright...
aaronrene · 19 days ago
sha256:0521dce9aca2

Divergence Analysis

feat/opengraph-repo-cards → dev
0%
0% divergence
Very compatible — minimal differences

Review comments

0

No review comments yet

Be the first to leave a review comment on this merge proposal.

Muse CLI

Comment muse hub proposal comment create sha256:9c735192f00fe8ad15fe5c4fbf32b7af43966f93f8a44baea6eebfbdfa365822 --body "…"
Approve muse hub proposal review submit sha256:9c735192f00fe8ad15fe5c4fbf32b7af43966f93f8a44baea6eebfbdfa365822 --verdict approve
Request changes muse hub proposal review submit sha256:9c735192f00fe8ad15fe5c4fbf32b7af43966f93f8a44baea6eebfbdfa365822 --verdict request_changes --body "…"
Close muse hub proposal close sha256:9c735192f00fe8ad15fe5c4fbf32b7af43966f93f8a44baea6eebfbdfa365822
Merge — merge engine docs ↗
Merge muse hub proposal merge sha256:9c735192f00fe8ad15fe5c4fbf32b7af43966f93f8a44baea6eebfbdfa365822 --hub http://staging.musehub.ai