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

ddiff --git a/README.md b/README.md
iindex 6aee116..28c378d 100644
---- a/README.md
++++ b/README.md
@@@ -232,6 +232,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 9d0872a..1b2bd14 100644
---- a/STATUS.json
++++ b/STATUS.json
@@@ -9,11 +9,11 @@
    "domain": "inventory.openvibe.network",
    "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.Inventory — one inventory for an OpenVibe account (ADR-054). Item kinds (a contract plus a renderer per surface), definitions, instances, the equipped set and an append-only ledger in its own PostgreSQL database. Issuers (services, apps) grant only within their namespace; people see and equip what they own; every movement is a ledger row and an inventory.* event. Nothing is sold, bought, traded or converted. Live's name effects, particles, hats and voices are the first kinds (70 definitions seeded at boot), and scripts/import-live.js moves Live's unlocks and equipped slots here, row for row.",
ddiff --git a/package-lock.json b/package-lock.json
iindex e6eb8fd..e0cead5 100644
---- a/package-lock.json
++++ b/package-lock.json
@@@ -20,7 +20,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": {
@@@ -1222,9 +1222,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 d588c7a..83df499 100644
---- a/package.json
++++ b/package.json
@@@ -27,7 +27,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 d82307e..a155163 100644
---- a/server/http/discovery.js
++++ b/server/http/discovery.js
@@@ -95,6 +95,10 @@ function createDiscoveryRoutes(ctx) {
          const { kinds, defs, byKind } = await catalog(inv);
          res.type('text/plain').set('Cache-Control', TEXT).send(seo.llmsTxt({
              name: SITE_NAME,
++            // AGT-5: each of Inventory's own pages is linked at its Markdown twin (openvibe-shared 4.108.0; a kind's
++            // ?kind= filter twin is the same query with .md). /api/ paths and other sites' links keep their URL.
++            markdown: true,
++            base: site,
              summary: 'OpenVibe.Inventory: Your items, on every OpenVibe site.',
              details: 'One inventory for an OpenVibe account: items earned or given by sites, games and apps, worn in chat, on '
                  + 'stream overlays and on your profile. Nothing here is sold, bought, traded or converted. '
@@@ -116,14 +120,15 @@ function createDiscoveryRoutes(ctx) {
                      { title: 'GET /api/v1/equipped?subjects=…', url: API_DOC, note: 'up to 100 equipped sets in one call' },
                  ] },
                  { 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' },
--                ] },
++            ],
++            // llmstxt.org's "## Optional": what an agent may skip when it needs a shorter context.
++            optional: [
++                { title: 'Sitemap', url: abs('/sitemap.xml') },
++                { title: 'Full text for language models', url: abs('/llms-full.txt') },
++                { 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' },
              ],
          }));
      });
ddiff --git a/test/discovery.test.js b/test/discovery.test.js
iindex d48a33a..a9fd01f 100644
---- a/test/discovery.test.js
++++ b/test/discovery.test.js
@@@ -58,13 +58,16 @@ 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.Inventory'), 'no title');
--            assert.ok(r.text.includes('(https://inventory.openvibe.network/updates)'), 'no updates link');
++            // AGT-5: each of Inventory's own pages is linked at its Markdown twin, and the secondary links are Optional.
++            assert.ok(r.text.includes('(https://inventory.openvibe.network/index.md)'), 'the home link is not its twin');
++            assert.ok(r.text.includes('(https://inventory.openvibe.network/updates.md)'), 'no updates link');
++            assert.ok(r.text.includes('\n## Optional\n'), 'no ## Optional section');
              assert.ok(r.text.includes('(https://openvibe.services)'), 'no pointer to the developer platform');
              assert.ok(r.text.includes('https://inventory.openvibe.network/sitemap.xml'), 'sitemap not listed');
              assert.ok(r.text.includes('(https://inventory.openvibe.network/llms-full.txt)'), 'llms-full.txt not listed');
              // The catalog and the public read API are named for language models on purpose.
--            assert.ok(r.text.includes('(https://inventory.openvibe.network/items)'), 'no /items link');
--            assert.ok(r.text.includes('https://inventory.openvibe.network/items?kind=live.hat'), 'no kind link');
++            assert.ok(r.text.includes('(https://inventory.openvibe.network/items.md)'), 'no /items link');
++            assert.ok(r.text.includes('https://inventory.openvibe.network/items.md?kind=live.hat'), 'no kind link');
              assert.ok(r.text.includes('GET /api/v1/kinds'), 'the API section is missing');
              for (const p of ['/auth/']) assert.ok(!r.text.includes(`https://inventory.openvibe.network${p}`), `private path in llms.txt: ${p}`);
          });