openvibe-shared v4.108.0 (was v4.107.4) (#195)

ddiff --git a/README.md b/README.md
iindex ae16682..bebb43c 100644
---- a/README.md
++++ b/README.md
@@@ -295,6 +295,6 @@ Part of the [OpenVibe network](https://openvibe.network). Built in the open by [
  <!-- versions:start -->
  - openvibe-contracts: v0.222.0
  - openvibe-sdk: v0.82.0
--- openvibe-shared: v4.107.4
++- openvibe-shared: v4.108.0
  - openvibe-publishing: v1.4.0
  <!-- versions:end -->
ddiff --git a/STATUS.json b/STATUS.json
iindex 16d6b3a..1df390f 100644
---- a/STATUS.json
++++ b/STATUS.json
@@@ -9,11 +9,11 @@
    "domain": "openvibe.quest",
    "contracts": "openvibe-contracts v0.222.0",
    "sdk": "openvibe-sdk v0.82.0",
--  "shared": "openvibe-shared v4.107.4",
++  "shared": "openvibe-shared v4.108.0",
    "packages": [
      "openvibe-contracts v0.222.0",
      "openvibe-sdk v0.82.0",
--    "openvibe-shared v4.107.4",
++    "openvibe-shared v4.108.0",
      "openvibe-publishing v1.4.0"
    ],
    "summary": "OpenVibe.Quest: one quest log across every OpenVibe site. OpenVibe.Events delivers the domain events the sites already emit to POST /internal/events (signed v2, once-only through the openvibe-sdk inbox), the person taken from the field each event's own schema defines, and a progress count, a completion and a badge move because of it. 12 first-party quests in code, grouped by the site whose events each counts. Rewards are badges and OpenCoins — credited through OpenVibe.Network's wallet, off by default (QUEST_COINS), with per-person and network-wide daily caps, failures recorded and retried. Public API and server-rendered pages, complete without JavaScript. OpenCoins are off until Network grants the two capabilities.",
ddiff --git a/package-lock.json b/package-lock.json
iindex 05cef26..b67e7af 100644
---- a/package-lock.json
++++ b/package-lock.json
@@@ -18,7 +18,7 @@
          "openvibe-contracts": "https://codeload.github.com/OpenVibers/OpenVibe.Contracts/tar.gz/refs/tags/v0.222.0",
          "openvibe-publishing": "https://codeload.github.com/OpenVibers/OpenVibe.Publishing/tar.gz/refs/tags/v1.4.0",
          "openvibe-sdk": "https://codeload.github.com/OpenVibers/OpenVibe.SDK/tar.gz/refs/tags/v0.82.0",
--        "openvibe-shared": "https://codeload.github.com/OpenVibers/OpenVibe.Shared/tar.gz/refs/tags/v4.107.4",
++        "openvibe-shared": "https://codeload.github.com/OpenVibers/OpenVibe.Shared/tar.gz/refs/tags/v4.108.0",
          "pg": "^8.23.0"
        },
        "devDependencies": {
@@@ -1209,9 +1209,9 @@
        }
      },
      "node_modules/openvibe-shared": {
--      "version": "4.107.4",
--      "resolved": "https://codeload.github.com/OpenVibers/OpenVibe.Shared/tar.gz/refs/tags/v4.107.4",
--      "integrity": "sha512-tThN0m3KMncEHVcBOvE+ysHjsZTlVIDLG1P+/i2Mulmxfc/AUpebAXhpWWrut50OChZ8o+HeePxsSrPI8mUQOQ==",
++      "version": "4.108.0",
++      "resolved": "https://codeload.github.com/OpenVibers/OpenVibe.Shared/tar.gz/refs/tags/v4.108.0",
++      "integrity": "sha512-NPzwjxpzGIpFpIm4uw3+VwHfsxbJ2+cD9yuhRzSwolSwqv2kCmwaVtHJ0DA9gKO3K8PCBfIP3UpKzpuSbYEJ+g==",
        "license": "MIT",
        "dependencies": {
          "jsonwebtoken": "^9.0.0",
ddiff --git a/package.json b/package.json
iindex 61e2bdb..c19e64b 100644
---- a/package.json
++++ b/package.json
@@@ -25,7 +25,7 @@
      "openvibe-contracts": "https://codeload.github.com/OpenVibers/OpenVibe.Contracts/tar.gz/refs/tags/v0.222.0",
      "openvibe-publishing": "https://codeload.github.com/OpenVibers/OpenVibe.Publishing/tar.gz/refs/tags/v1.4.0",
      "openvibe-sdk": "https://codeload.github.com/OpenVibers/OpenVibe.SDK/tar.gz/refs/tags/v0.82.0",
--    "openvibe-shared": "https://codeload.github.com/OpenVibers/OpenVibe.Shared/tar.gz/refs/tags/v4.107.4",
++    "openvibe-shared": "https://codeload.github.com/OpenVibers/OpenVibe.Shared/tar.gz/refs/tags/v4.108.0",
      "pg": "^8.23.0"
    },
    "engines": {
ddiff --git a/server/http/discovery.js b/server/http/discovery.js
iindex 0c23d12..e94363b 100644
---- a/server/http/discovery.js
++++ b/server/http/discovery.js
@@@ -72,25 +72,28 @@ function createDiscoveryRoutes(ctx) {
              name: SITE_NAME,
              summary: 'OpenVibe.Quest: Quests across the whole network.',
              details: 'Every page is server-rendered and readable without JavaScript.',
++            markdown: true,
++            base: site,
              sections: [
                  { title: 'Start here', links: [
                      { title: 'OpenVibe.Quest', url: abs('/'), note: 'Quests across the whole network.' },
                      { title: 'All quests', url: abs('/quests'), note: 'every quest, grouped by site' },
                      { title: 'How quests work', url: abs('/how-it-works'), note: 'what is counted, what is stored, and the rewards' },
--                    { title: 'The catalog (JSON)', url: abs('/api/v1/quests'), note: 'every quest, grouped by site' },
--                    { title: 'What shipped on OpenVibe.Quest', url: abs('/updates') },
                  ] },
                  { title: 'The quests', links: catalog.all().map((q) => ({ title: q.title, url: abs(`/quests/${q.id}`), note: `${(catalog.SITES[q.site] || {}).name || q.site} — reward: the ${q.reward.badge.name} badge${q.reward.item ? ` and the ${q.reward.item.name}` : ''}` })) },
--                { title: 'Machine-readable', links: [
--                    { title: 'Sitemap', url: abs('/sitemap.xml') },
--                    { title: 'Full text for language models', url: abs('/llms-full.txt') },
--                    { title: 'Release metadata (JSON)', url: abs('/release.json') },
--                ] },
--                { title: 'Elsewhere', links: [
--                    { title: 'OpenVibe.Network', url: 'https://openvibe.network', note: 'accounts, apps and grants' },
--                    { title: 'OpenVibe.Services', url: 'https://openvibe.services', note: 'apps, keys and capability grants' },
++                // A JSON API is what an agent came for, not something to skip (AGT-5 review).
++                { title: 'API', links: [
++                    { title: 'The catalog (JSON)', url: abs('/api/v1/quests'), note: 'every quest, grouped by site' },
                  ] },
              ],
++            optional: [
++                { title: 'Sitemap', url: abs('/sitemap.xml') },
++                { title: 'Full text for language models', url: abs('/llms-full.txt') },
++                { title: 'Release metadata (JSON)', url: abs('/release.json') },
++                { title: 'OpenVibe.Network', url: 'https://openvibe.network', note: 'accounts, apps and grants' },
++                { title: 'OpenVibe.Services', url: 'https://openvibe.services', note: 'apps, keys and capability grants' },
++                { title: 'What shipped on OpenVibe.Quest', url: abs('/updates') },
++            ],
          }));
      });
  
ddiff --git a/test/discovery.test.js b/test/discovery.test.js
iindex 0d325b9..14212f7 100644
---- a/test/discovery.test.js
++++ b/test/discovery.test.js
@@@ -48,10 +48,12 @@ const PRIVATE = ['/auth/', '/api/'];
              assert.match(r.headers.get('content-type'), /^text\/plain/);
              assert.match(r.headers.get('cache-control') || '', /public, max-age=\d+/);
              assert.ok(r.text.startsWith('# OpenVibe.Quest'), 'no title');
--            assert.ok(r.text.includes('(https://openvibe.quest/updates)'), 'no updates link');
++            assert.ok(r.text.includes('(https://openvibe.quest/index.md)'), 'home link points at its Markdown twin');
++            assert.ok(r.text.includes('(https://openvibe.quest/updates.md)'), 'no updates link');
              assert.ok(r.text.includes('(https://openvibe.services)'), 'no pointer to the developer platform');
              assert.ok(r.text.includes('https://openvibe.quest/sitemap.xml'), 'sitemap not listed');
              assert.ok(r.text.includes('(https://openvibe.quest/llms-full.txt)'), 'llms-full.txt not listed');
++            assert.ok(r.text.includes('\n## Optional\n'), 'llms.txt has an Optional section');
              for (const p of ['/auth/']) assert.ok(!r.text.includes(`https://openvibe.quest${p}`), `private path in llms.txt: ${p}`);
          });
  
ddiff --git a/test/quests-api.test.js b/test/quests-api.test.js
iindex 3993615..84b9712 100644
---- a/test/quests-api.test.js
++++ b/test/quests-api.test.js
@@@ -211,7 +211,7 @@ const { render } = require('../server/render/html');
              const robots = await t.get('/robots.txt');
              assert.ok(robots.text.includes('Disallow: /me'), 'the private log is not crawled');
              const llms = await t.get('/llms.txt');
--            assert.ok(llms.text.includes('(https://openvibe.quest/quests/go-live)'), 'llms.txt lists the quests');
++            assert.ok(llms.text.includes('(https://openvibe.quest/quests/go-live.md)'), 'llms.txt lists the quests at the Markdown twin');
              const full = await t.get('/llms-full.txt');
              assert.ok(full.text.includes('https://openvibe.quest/quests/go-live'), 'llms-full.txt has every quest page');
          });