René's URL Explorer Experiment


Title: Plugin metadata: let plugins declare name, description, and required config (export const meta) · Issue #615 · JavaScriptSolidServer/JavaScriptSolidServer · GitHub

Open Graph Title: Plugin metadata: let plugins declare name, description, and required config (export const meta) · Issue #615 · JavaScriptSolidServer/JavaScriptSolidServer

X Title: Plugin metadata: let plugins declare name, description, and required config (export const meta) · Issue #615 · JavaScriptSolidServer/JavaScriptSolidServer

Description: Composability testing across the plugins collection (33 plugins) surfaced a pattern: the loader knows almost nothing about a plugin until activate() is already running, so every mismatch is discovered by crashing. Observed while trial-co...

Open Graph Description: Composability testing across the plugins collection (33 plugins) surfaced a pattern: the loader knows almost nothing about a plugin until activate() is already running, so every mismatch is discove...

X Description: Composability testing across the plugins collection (33 plugins) surfaced a pattern: the loader knows almost nothing about a plugin until activate() is already running, so every mismatch is discove...

Opengraph URL: https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615

X: @github

direct link

Domain: github.com

IPv4 address: 140.82.112.3


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Plugin metadata: let plugins declare name, description, and required config (export const meta)","articleBody":"Composability testing across the plugins collection (33 plugins) surfaced a pattern: the loader knows almost nothing about a plugin until `activate()` is already running, so every mismatch is discovered by crashing.\n\nObserved while trial-composing on one server:\n\n- **20 of 33 plugins hard-require config** (18 need `config.baseUrl`; `terminal` correctly refuses to boot an open shell without auth config). The only way to discover this is to boot and read the throw — and boot is fail-closed, so one missing config key = no server. It took four boot attempts to find a 13-plugin set that co-loads (which then ran conflict-free — isolation is in good shape; discoverability is the gap).\n- **Identity is inferred, not declared** — #614: the id comes from path heuristics, which the `pod/plugin.js` app-repo layout defeats.\n- The roster (`api.plugins`) carries only `{ id, prefix, module }`, so meta-plugins like `admin`/`dashboard` can enumerate siblings but can't describe them.\n\n**Proposal: an optional exported `meta` object** that plugins declare and the loader reads before calling `activate()`:\n\n```js\nexport const meta = {\n  name: 'gamestr',                     // stable id — solves #614 explicitly, no path heuristics\n  description: 'Points system: bump / day aggregation / stream over hour files',\n  version: '0.1.0',\n  jss: '>=0.0.219',                    // engine compat range\n  config: {                            // declared config surface\n    baseUrl: { required: true,  description: 'Public origin for absolute URLs in feeds/JRDs' },\n    token:   { required: false, description: 'Shared secret for privileged routes' },\n  },\n}\n```\n\nLoader behavior, all backwards-compatible (no `meta` = exactly today's behavior):\n\n1. **Pre-activate validation** — required config missing produces one precise boot error naming the plugin, the key, and its description (instead of whatever the plugin's own throw says), or a skip-with-warning if a lenient mode ever exists.\n2. **`meta.name` wins over path derivation** for the id — fixes #614 without guessing at generic directory names.\n3. **Roster enrichment** — `api.plugins` entries carry `description`/`version`, so `admin` and `dashboard` can render a real catalog.\n4. **Downstream, not now:** a declared-metadata convention is the enabler for an install story (`jspod install \u003crepo>` reading the meta before mounting) and compat checks — WordPress's plugin header (`Plugin Name: … Requires at least: …`) is the 20-year precedent: that one convention made its directory, installer, and compatibility matrix possible.\n\nAlternatives considered: a WordPress-style comment header (parseable without importing the module — nice for registries, but the loader imports anyway) or a `plugin.json` sidecar (keeps metadata out of code, but splits the plugin across two files). The exported object is the most natural fit for ESM and is trivially optional.\n\nDeliberately filed as a marker/discussion, not a mandate — plugin conventions are still in an experimentation phase and this should be shaped by more plugin-building experience.\n","author":{"url":"https://github.com/melvincarvalho","@type":"Person","name":"melvincarvalho"},"datePublished":"2026-07-12T01:07:59Z","url":"https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615"}

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format)
route-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:370d05a3-7eeb-a26b-4fe0-57eda51ab3de
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-id8350:C707B:E127A8:11DFC66:6B037D44
html-safe-nonceeeaebc83dea9b62285074b736960322ff270fb600effc3e8e20bbdeafe19258d
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4MzUwOkM3MDdCOkUxMjdBODoxMURGQzY2OjZCMDM3RDQ0IiwidmlzaXRvcl9pZCI6IjY2NjU5NzY0NzE0MDE3NTgwMjAiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac5f94f674ede5bb6baa3d3d365d1253a6ca9505b02cfcb1be9cfb58592a880541
hovercard-subject-tagissue:4864873214
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/JavaScriptSolidServer/JavaScriptSolidServer/615/issue_layout
twitter:imagehttps://opengraph.githubassets.com/59b472a72037a1ceac4fe848072a2008b62284869b3aa492f9e574db999a6d27/JavaScriptSolidServer/JavaScriptSolidServer/issues/615
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/59b472a72037a1ceac4fe848072a2008b62284869b3aa492f9e574db999a6d27/JavaScriptSolidServer/JavaScriptSolidServer/issues/615
og:image:altComposability testing across the plugins collection (33 plugins) surfaced a pattern: the loader knows almost nothing about a plugin until activate() is already running, so every mismatch is discove...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamemelvincarvalho
hostnamegithub.com
expected-hostnamegithub.com
None87e774ee7c6b3bee0490394e4d3e57ec9dbc956f74b87ea685dc8996c1676456
turbo-cache-controlno-preview
go-importgithub.com/JavaScriptSolidServer/JavaScriptSolidServer git https://github.com/JavaScriptSolidServer/JavaScriptSolidServer.git
octolytics-dimension-user_id205442424
octolytics-dimension-user_loginJavaScriptSolidServer
octolytics-dimension-repository_id958025407
octolytics-dimension-repository_nwoJavaScriptSolidServer/JavaScriptSolidServer
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id958025407
octolytics-dimension-repository_network_root_nwoJavaScriptSolidServer/JavaScriptSolidServer
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release423dbb54c5e7bfecc838eb387c1435eb3d0e760d
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FJavaScriptSolidServer%2FJavaScriptSolidServer%2Fissues%2F615
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FJavaScriptSolidServer%2FJavaScriptSolidServer%2Fissues%2F615
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=JavaScriptSolidServer%2FJavaScriptSolidServer
Reloadhttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615
Reloadhttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615
Reloadhttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615
JavaScriptSolidServerhttps://github.com/JavaScriptSolidServer
JavaScriptSolidServerhttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer
Codehttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer
Issues165 (165)https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues
Pull requests14 (14)https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/pulls
Actionshttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer/actions
Projectshttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer/projects
Security and qualityhttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer/security
Insightshttps://github.com/JavaScriptSolidServer/JavaScriptSolidServer/insights
https://github.com/JavaScriptSolidServer/JavaScriptSolidServer
New issuehttps://github.com/login?return_to=https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615
New issuehttps://github.com/login?return_to=https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615
Plugin metadata: let plugins declare name, description, and required config (export const meta)https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615#top
pluginCould be implemented as a plugin (#206); core/plugin line defined in #564https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues?q=state%3Aopen%20label%3A%22plugin%22
https://github.com/melvincarvalho
melvincarvalhohttps://github.com/melvincarvalho
on Jul 12, 2026https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615#issue-4864873214
Plugin id derivation defeats the pod/plugin.js convention — every app derives id "pod" #614https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/614
Plugin id derivation defeats the pod/plugin.js convention — every app derives id "pod" #614https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/614
melvincarvalhohttps://github.com/melvincarvalho
pluginCould be implemented as a plugin (#206); core/plugin line defined in #564https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues?q=state%3Aopen%20label%3A%22plugin%22
on Jul 12, 2026https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615#event-27864575107
Sign up for freehttps://github.com/signup?return_to=https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615
Sign in to commenthttps://github.com/login?return_to=https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues/615
pluginCould be implemented as a plugin (#206); core/plugin line defined in #564https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/issues?q=state%3Aopen%20label%3A%22plugin%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Response headers:
Servergithub.com
Content-Typetext/html; charset=utf-8
Cache-Controlmax-age=0, private, must-revalidate

Viewport: width=device-width


URLs of crawlers that visited me.