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

ddiff --git a/README.md b/README.md
iindex 39d738a..70ae4f9 100644
---- a/README.md
++++ b/README.md
@@@ -260,5 +260,5 @@ Part of the [OpenVibe network](https://openvibe.network). Built in the open by
  <!-- versions:start -->
  - openvibe-contracts: v0.232.0
  - openvibe-sdk: v0.82.0
--- openvibe-shared: v4.107.4
++- openvibe-shared: v4.108.0
  <!-- versions:end -->
ddiff --git a/STATUS.json b/STATUS.json
iindex 103df1f..c07f64c 100644
---- a/STATUS.json
++++ b/STATUS.json
@@@ -10,11 +10,11 @@
    "domain": "openvibe.surf",
    "contracts": "openvibe-contracts v0.232.0",
    "sdk": "openvibe-sdk v0.82.0",
--  "shared": "openvibe-shared v4.107.4",
++  "shared": "openvibe-shared v4.108.0",
    "packages": [
      "openvibe-contracts v0.232.0",
      "openvibe-sdk v0.82.0",
--    "openvibe-shared v4.107.4"
++    "openvibe-shared v4.108.0"
    ],
    "summary": "openvibe.surf, the Surf room: Network sign-in as OAuth client `surf`; Ride (OpenVibe.Games' surf maps, cached 60 s, embedded); Watch (a lean-back TV over OpenVibe.Live's live streams, clips and AI moments, clips and moments playing in the page over HLS) plus watch together (in-memory SSE parties); Web (Surf with Vibe: one OpenVibe.Actor task made with the person's own Network token). No database.",
    "works": [
ddiff --git a/package-lock.json b/package-lock.json
iindex e17fdab..37f0a9d 100644
---- a/package-lock.json
++++ b/package-lock.json
@@@ -16,7 +16,7 @@
          "helmet": "^8.1.0",
          "openvibe-contracts": "https://codeload.github.com/OpenVibers/OpenVibe.Contracts/tar.gz/refs/tags/v0.232.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"
        },
        "engines": {
          "node": ">=22.0.0"
@@@ -1103,9 +1103,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 b0b1992..d68d4d6 100644
---- a/package.json
++++ b/package.json
@@@ -22,7 +22,7 @@
      "helmet": "^8.1.0",
      "openvibe-contracts": "https://codeload.github.com/OpenVibers/OpenVibe.Contracts/tar.gz/refs/tags/v0.232.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"
    },
    "engines": {
      "node": ">=22.0.0"
ddiff --git a/server/http/discovery.js b/server/http/discovery.js
iindex e83b959..467634e 100644
---- a/server/http/discovery.js
++++ b/server/http/discovery.js
@@@ -60,8 +60,11 @@ function createDiscoveryRoutes(ctx) {
      });
  
      // The site as llms.txt describes it, shared by /llms.txt and /llms-full.txt (SEO-33).
++    // AGT-5: each of Surf's own pages is linked at its Markdown twin (markdown: true, base: the site origin).
      const llmsSite = () => ({
              name: SITE_NAME,
++            markdown: true,
++            base: site,
              summary: DESCRIPTION,
              details: 'The pages here are server-rendered and readable without JavaScript. Ride is a proxy to OpenVibe.Games, Watch merges OpenVibe.Live’s live, clip and moment feeds, and Web creates one OpenVibe.Actor task with the signed-in person’s own Network token.',
              sections: [
@@@ -75,15 +78,17 @@ function createDiscoveryRoutes(ctx) {
                  { title: 'Machine-readable', links: [
                      { title: 'The Watch feed (JSON)', url: abs('/api/v1/watch/feed?topic=all'), note: 'public, cached 30 seconds' },
                      { title: 'The Ride maps (JSON)', url: abs('/api/v1/ride/maps'), note: 'public, cached 60 seconds' },
--                    { title: 'Sitemap', url: abs('/sitemap.xml') },
--                    { title: 'Release metadata (JSON)', url: abs('/release.json') },
--                ] },
--                { title: 'Elsewhere', links: [
--                    { title: 'OpenVibe.Live', url: 'https://openvibe.live', note: 'what Watch surfs' },
--                    { title: 'OpenVibe.Games', url: 'https://openvibe.games', note: 'what Ride plays' },
--                    { title: 'OpenVibe.Actor', url: 'https://openvibe.actor', note: 'who browses the web for Web' },
                  ] },
              ],
++            // llmstxt.org's "## Optional": what an agent may skip when it needs a shorter context.
++            optional: [
++                { title: 'Sitemap', url: abs('/sitemap.xml') },
++                { title: 'Release metadata (JSON)', url: abs('/release.json') },
++                { title: 'llms-full.txt', url: abs('/llms-full.txt'), note: 'the pages above in full, as plain text' },
++                { title: 'OpenVibe.Live', url: 'https://openvibe.live', note: 'what Watch surfs' },
++                { title: 'OpenVibe.Games', url: 'https://openvibe.games', note: 'what Ride plays' },
++                { title: 'OpenVibe.Actor', url: 'https://openvibe.actor', note: 'who browses the web for Web' },
++            ],
          });
      r.get('/llms.txt', async (_req, res) => {
          res.type('text/plain').set('Cache-Control', TEXT).send(seo.llmsTxt(llmsSite()));
ddiff --git a/test/discovery.test.js b/test/discovery.test.js
iindex 12d66c2..1129710 100644
---- a/test/discovery.test.js
++++ b/test/discovery.test.js
@@@ -46,6 +46,20 @@ const { boot, check, done } = require('./helpers/boot');
          assert.match(r.text, /https:\/\/openvibe\.live/);
          assert.match(r.text, /https:\/\/openvibe\.games/);
          assert.match(r.text, /https:\/\/openvibe\.actor/);
++        // AGT-5: each of its own pages at the Markdown twin, an Optional section last.
++        assert.match(r.text, /\[OpenVibe\.Surf\]\(https:\/\/openvibe\.surf\/index\.md\)/, 'the home is /index.md');
++        assert.match(r.text, /\[Ride\]\(https:\/\/openvibe\.surf\/ride\.md\)/, 'a page is its twin');
++        assert.match(r.text, /\[For developers\]\(https:\/\/openvibe\.surf\/developers\.md\)/);
++        assert.match(r.text, /\[The Watch feed \(JSON\)\]\(https:\/\/openvibe\.surf\/api\/v1\/watch\/feed\?topic=all\)/, 'an API URL keeps its URL');
++        assert.match(r.text, /\n## Optional\n/);
++        assert.match(r.text, /\n## Optional\n\n[\s\S]*\[Sitemap\]\(https:\/\/openvibe\.surf\/sitemap\.xml\)/);
++        assert.strictEqual(r.text.lastIndexOf('\n## '), r.text.indexOf('\n## Optional'), 'Optional is the last section');
++        const own = [...r.text.matchAll(/\]\((https:\/\/openvibe\.surf[^)\s]*)\)( \(HTML\))?/g)];
++        assert.ok(own.length > 8, String(own.length));
++        for (const [, url, html] of own) {
++            const p = new URL(url).pathname;
++            assert.ok(p.endsWith('.md') || /\.[a-z0-9]+$/.test(p) || p.startsWith('/api/') || html, `${url} is a twin, a file or marked (HTML)`);
++        }
      });
  
      await t.close();