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

ddiff --git a/README.md b/README.md
iindex 496dc93..0c56893 100644
---- a/README.md
++++ b/README.md
@@@ -332,7 +332,7 @@ Called elsewhere, as the service principal `blog`: `identity.subject.resolve` an
    `openvibe-sdk/db`; Valkey holds the per-actor limit counters (optional: without `VALKEY_URL` they count per process).
  - **Packages** (all pinned by release tarball): `openvibe-publishing` v1.4.1 (async PostgreSQL stores: revisions,
    schedule, taxonomy, citations, media, discussion, seo, authorship, index-hooks, ssr, layout), `openvibe-contracts`
--  v0.97.0, `openvibe-shared` v4.107.4 (Frame, app icon, footer, legal, release, metrics, ready, theme presets),
++  v0.97.0, `openvibe-shared` v4.108.0 (Frame, app icon, footer, legal, release, metrics, ready, theme presets),
    `openvibe-sdk` v0.82.0 (sso, db, PostgreSQL events outbox, service tokens, per-actor limits, testing).
  - **OpenVibe.Network:**
    - SSO: the OAuth client `blog` is already seeded with redirect
@@@ -543,6 +543,6 @@ Part of the [OpenVibe network](https://openvibe.network). Built in the open by [
  <!-- versions:start -->
  - openvibe-contracts: v0.242.1
  - 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 69f9860..b351872 100644
---- a/STATUS.json
++++ b/STATUS.json
@@@ -9,11 +9,11 @@
    "domain": "openvibe.blog",
    "contracts": "openvibe-contracts v0.242.1",
    "sdk": "openvibe-sdk v0.82.0",
--  "shared": "openvibe-shared v4.107.4",
++  "shared": "openvibe-shared v4.108.0",
    "packages": [
      "openvibe-publishing v1.4.1",
      "openvibe-contracts v0.242.1",
--    "openvibe-shared v4.107.4",
++    "openvibe-shared v4.108.0",
      "openvibe-sdk v0.82.0"
    ],
    "capabilities": [
ddiff --git a/package-lock.json b/package-lock.json
iindex 14b15cd..70c60b4 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.242.1",
          "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.0"
        },
        "devDependencies": {
@@@ -1210,9 +1210,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 8c0b84d..dbe9453 100644
---- a/package.json
++++ b/package.json
@@@ -30,7 +30,7 @@
      "openvibe-contracts": "https://codeload.github.com/OpenVibers/OpenVibe.Contracts/tar.gz/refs/tags/v0.242.1",
      "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.0"
    },
    "devDependencies": {
ddiff --git a/server/http/discovery.js b/server/http/discovery.js
iindex f6bc0bd..7b8f1f3 100644
---- a/server/http/discovery.js
++++ b/server/http/discovery.js
@@@ -80,19 +80,22 @@ function createDiscoveryRoutes({ config, store, blogs, publication, reading }) {
          res.type('text/plain').set('Cache-Control', cache.htmlHeaders({ maxAge: 3600 })).send(sharedSeo.llmsTxt({
              name: 'OpenVibe.Blog',
              summary: SITE_SUMMARY,
++            // AGT-5: own pages link their Markdown twins (openvibe-shared 4.108.0); ## Optional is what an agent may skip.
++            markdown: true,
++            base: config.baseUrl,
              details: 'Only public, published posts are listed, fed or mapped. Every post page has a machine-readable twin at <post URL>.json with the same content, its revision, authorship (human, AI-assisted or AI-generated, and whether a person reviewed it), sources and indexability reasons. AI-generated drafts are never published or indexed before a person reviews them.',
              sections: [
                  { title: 'Start here', links: [
                      { title: official ? official.title : 'The OpenVibe blog', url: abs('/'), note: 'official announcements and release notes' },
--                    { title: 'Sitemap', url: abs('/sitemap.xml') },
--                ] },
--                { title: 'Feeds', links: [
--                    { title: 'RSS', url: abs('/feed.xml') }, { title: 'Atom', url: abs('/atom.xml') }, { title: 'JSON Feed', url: abs('/feed.json') },
--                    { title: 'Member blogs', url: abs('/sitemaps/blogs.xml'), note: 'each member blog has /@handle/feed.xml, /@handle/atom.xml and /@handle/feed.json' },
                  ] },
--                { title: 'Data', links: [{ title: 'Post JSON', url: abs('/'), note: 'append .json to any post URL (/@handle/slug.json)' }] },
--                { title: 'API', links: [{ title: 'OpenAPI 3.1 document', url: abs('/openapi.json'), note: 'every /api/v1 route, with its fields' }] },
--                { title: 'AI desks', links: [{ title: 'AI desks', url: abs('/desks'), note: 'digests OpenVibe.AI writes from OpenVibe.Sources items (news, food recalls, deals, hosting plans, developer releases) and a satire column; labelled as AI, every digest section cited, never indexed; each desk has /desks/<desk>/feed.xml and each post a .json twin' }] },
++                { title: 'API', links: [{ title: 'OpenAPI 3.1 document', url: abs('/openapi.json'), note: 'every /api/v1 route, with its fields; any post as JSON: append .json to its URL (/@handle/slug.json)' }] },
++                { title: 'AI desks', links: [{ title: 'AI desks', url: abs('/desks'), html: true, note: 'digests OpenVibe.AI writes from OpenVibe.Sources items (news, food recalls, deals, hosting plans, developer releases) and a satire column; labelled as AI, every digest section cited, never indexed; each desk has /desks/<desk>/feed.xml and each post a .json twin' }] },
++            ],
++            optional: [
++                { title: 'Sitemap', url: abs('/sitemap.xml') },
++                { title: 'RSS', url: abs('/feed.xml') }, { title: 'Atom', url: abs('/atom.xml') }, { title: 'JSON Feed', url: abs('/feed.json') },
++                { title: 'Member blogs', url: abs('/sitemaps/blogs.xml'), note: 'each member blog has /@handle/feed.xml, /@handle/atom.xml and /@handle/feed.json' },
++                { title: 'Full text for language models', url: abs('/llms-full.txt') },
              ],
          }));
      });
ddiff --git a/test/seed-ops.test.js b/test/seed-ops.test.js
iindex c86c3ed..70dd381 100644
---- a/test/seed-ops.test.js
++++ b/test/seed-ops.test.js
@@@ -77,6 +77,11 @@ const { seedOfficialPost, loadFacts, SLUG } = require('../server/seed');
          const llms = (await t.get('/llms.txt')).text;
          assert.match(llms, /^# OpenVibe\.Blog/);
          assert.match(llms, /\.json/);
++        // AGT-5: the home links its Markdown twin, the desks (no twin) are marked HTML, feeds keep their URL, Optional last.
++        assert.ok(llms.includes('(https://openvibe.blog/index.md)'), 'the home links its twin');
++        assert.ok(llms.includes('(https://openvibe.blog/desks) (HTML)'));
++        assert.ok(llms.includes('(https://openvibe.blog/feed.xml)') && llms.includes('(https://openvibe.blog/openapi.json)'));
++        assert.ok(llms.includes('\n## Optional\n') && llms.lastIndexOf('\n## ') === llms.indexOf('\n## Optional\n'), 'Optional is last');
          const idx = (await t.get('/sitemap.xml')).text;
          assert.match(idx, /<sitemapindex/);
          assert.match(idx, /sitemaps\/posts\.xml/);