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

ddiff --git a/README.md b/README.md
iindex aa5b95c..e94a43f 100644
---- a/README.md
++++ b/README.md
@@@ -161,6 +161,6 @@ section says so plainly when no store has cut a price yet.
  <!-- versions:start -->
  - openvibe-contracts: v0.273.0
  - openvibe-sdk: v0.82.0
--- openvibe-shared: v4.107.4
++- openvibe-shared: v4.108.0
  - openvibe-publishing: v1.4.1
  <!-- versions:end -->
ddiff --git a/STATUS.json b/STATUS.json
iindex 55a2bde..7350b25 100644
---- a/STATUS.json
++++ b/STATUS.json
@@@ -9,12 +9,12 @@
    "domain": "open.shoes",
    "contracts": "openvibe-contracts v0.273.0",
    "sdk": "openvibe-sdk v0.82.0",
--  "shared": "openvibe-shared v4.107.4",
++  "shared": "openvibe-shared v4.108.0",
    "packages": [
      "openvibe-contracts v0.273.0",
      "openvibe-publishing v1.4.1",
      "openvibe-sdk v0.82.0",
--    "openvibe-shared v4.107.4"
++    "openvibe-shared v4.108.0"
    ],
    "summary": "OpenVibe.Shoes is the network's shoe resource. It reads OpenVibe.Deals' public offers (and the official eBay Browse API when a key pair is set), keeps the footwear in its own catalogue, and shows one page per model with every store's all-in price, a price history from its own one-snapshot-per-offer-per-day record, the size-price curve where sizes are known, and specs/fit/release/care only from cited open sources. A signed-in person can ask Watch to tell them when the model drops below a price at their size, or paste any listing link and have Watch apply its own fetch rules. Official release dates come from the brands' and stores' own public release pages; a reminder goes on Today. Shoes never enters a raffle, never scrapes Marketplace and carries no affiliate links.",
    "works": [
ddiff --git a/package-lock.json b/package-lock.json
iindex ef305ad..fd4516c 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.273.0",
          "openvibe-publishing": "https://codeload.github.com/OpenVibers/OpenVibe.Publishing/tar.gz/refs/tags/v1.4.1",
          "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.1"
        },
        "devDependencies": {
@@@ -1213,9 +1213,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 bb9ba28..ee7f945 100644
---- a/package.json
++++ b/package.json
@@@ -26,7 +26,7 @@
      "openvibe-contracts": "https://codeload.github.com/OpenVibers/OpenVibe.Contracts/tar.gz/refs/tags/v0.273.0",
      "openvibe-publishing": "https://codeload.github.com/OpenVibers/OpenVibe.Publishing/tar.gz/refs/tags/v1.4.1",
      "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.1"
    },
    "engines": {
ddiff --git a/server/http/discovery.js b/server/http/discovery.js
iindex 0f63f3d..5326062 100644
---- a/server/http/discovery.js
++++ b/server/http/discovery.js
@@@ -90,6 +90,10 @@ function createDiscoveryRoutes(ctx) {
          res.type('text/plain').set('Cache-Control', cache.htmlHeaders({ maxAge: 600 }));
          res.send(seo.llmsTxt({
              name: SITE_NAME,
++            // Each of this site's own pages is linked at its Markdown twin (AGT-5; openvibe-shared 4.108.0 leaves
++            // files, /api/ and /.well-known/ paths and other sites' links as they are).
++            markdown: true,
++            base: base(),
              summary: DESCRIPTION,
              details: 'Public model pages, a public JSON API and an OpenAPI document. No sign-in is needed for the public reads; a price watch and a pasted listing link need a person.',
              sections: [
@@@ -101,6 +105,12 @@ function createDiscoveryRoutes(ctx) {
                      { title: 'OpenAPI', url: `${base()}/api/openapi.json` },
                  ] },
              ],
++            // llmstxt.org's "## Optional": what an agent may skip when it needs a shorter context.
++            optional: [
++                { title: 'Sitemap', url: `${base()}/sitemap.xml`, note: 'the public pages above, each model page included' },
++                { title: 'robots.txt', url: `${base()}/robots.txt` },
++                { title: 'llms-full.txt', url: `${base()}/llms-full.txt`, note: 'the pages above in full, as plain text' },
++            ],
          }));
      });
  
ddiff --git a/test/pages.test.js b/test/pages.test.js
iindex 59e7a56..e818536 100644
---- a/test/pages.test.js
++++ b/test/pages.test.js
@@@ -141,6 +141,13 @@ const { assert, equal } = require('./helpers/check');
              const llms = await t.get('/llms.txt');
              equal(llms.status, 200);
              assert(llms.text.includes('Open.Shoes'), 'the llms index');
++            // AGT-5: each page is linked at its Markdown twin, and an Optional section ends the file.
++            assert(llms.text.includes('[Open.Shoes home](https://open.shoes/index.md)'), 'the home is /index.md');
++            assert(llms.text.includes('[Every shoe](https://open.shoes/shoes.md)'), 'a page is its twin');
++            assert(llms.text.includes('(https://open.shoes/api/openapi.json)'), 'a file keeps its URL');
++            assert(/\n## Optional\n/.test(llms.text), 'no Optional section');
++            assert(/\n## Optional\n\n[\s\S]*\[Sitemap\]\(https:\/\/open\.shoes\/sitemap\.xml\)/.test(llms.text), 'sitemap in Optional');
++            equal(llms.text.lastIndexOf('\n## '), llms.text.indexOf('\n## Optional'), 'Optional is the last section');
              const full = await t.get('/llms-full.txt');
              equal(full.status, 200);
              assert(full.text.includes('Nike Air Max 90'), 'the full pages');