Agent-friendly documentation: .md companions, llms.txt, coding-agent guide (HF-154)

[marcin-kordas-hoc]

Context

HF-154 — make the HyperFormula docs friendlier to coding agents and LLMs. On top of the existing VuePress portal this adds:

• Per-page .md companions — every doc page is also served as clean, VuePress-stripped Markdown (a build-time md-companions plugin), plus an aggregate llms-full.txt. Both are also mirrored to the site root so /llms.txt and /llms-full.txt resolve on GitHub Pages (prod) and the Netlify preview.
• llms.txt — a top-level index pointing agents at the Markdown sources.
• Copy-Markdown-link button (CopyMarkdownButton.vue) — copies the page's .md URL for pasting into an agent.
• Coding-agent setup guide (docs/guide/setup-coding-agent.md) plus a CodingAgentWizard.vue helper.
• context7.json so agent doc-access tooling (Context7 / GitMCP) can discover the sources.

The Markdown stripper (md-companions/strip.js) is the fidelity-critical piece: it turns VuePress-flavoured Markdown (::: containers, <script>/Vue components, [[toc]], {{ }} bindings, Vue-bound <a :href>/<img :src>, live :::example demos, nested code fences) into clean Markdown.

How did you test your changes?

• Unit specs under test/docs/ (26 assertions, all passing): md-companions-strip.spec.js covers the stripper's transforms and edge cases; md-companions-generated.spec.js covers the generated() hook (per-page writes, root mirror, per-page error isolation, empty content, URL/base construction) with fs stubbed. Both are .js Jest specs (Karma globs only .spec.ts, so they stay out of the browser bundle).
• npm run lint clean (an ESLint override for **/test/**/*.spec.js allows the plain-Node specs).
• The full corpus was sanity-checked against the Netlify deploy-preview build (llms-full.txt populated, per-page .md clean, no leaked components).

Types of changes

• New feature or improvement (a non-breaking change that adds functionality)
• Change to the documentation

Related issues:

1. HF-154

Checklist:

• I have reviewed the guidelines about Contributing to HyperFormula and I confirm that my code follows the code style of this project.
• I described my changes in the CHANGELOG.md file.

Notes

• Supersedes Agent-friendly documentation: .md companions, llms.txt, coding-agent guide (HF-154) #1696 (moved to an upstream branch so CI can access the private hyperformula-tests repo). Current develop is merged in.
• The docs-portal Astro migration (Migrate documentation to Astro Starlight #1686) is a separate track. If it lands first it supersedes this VuePress plumbing (the md-companions plugin and .vue components are VuePress-specific); the agent-friendly outputs (.md companions, llms.txt, setup guide) would need re-homing in Astro.

---

Note

Low Risk
Docs-site and build-plugin work only; engine behavior is unchanged. Residual risk is limited to docs build output quality and deploy redirects, guarded by unit tests.

Overview
Adds LLM- and agent-oriented documentation outputs on top of the existing VuePress site: a build-time md-companions plugin strips VuePress/Vue syntax and emits a per-page .md companion beside each HTML page plus an aggregated llms-full.txt, with llms.txt as a top-level index and root mirroring/Netlify redirects so /llms.txt and /llms-full.txt resolve when docs live under /docs/.

The docs UI gains a fixed Copy Markdown link button and a new Set up your coding agent guide with an interactive CodingAgentWizard. context7.json documents indexing rules for external doc tools. Jest coverage targets the stripper and generated() hook; ESLint relaxes rules for test/**/*.spec.js.

No changes to the spreadsheet engine runtime or public npm API.

^{Reviewed by Cursor Bugbot for commit f68804a. Bugbot is set up for automated code reviews on this repo. Configure here.}

[qunabu]

Task linked: HF-154 Agent-friendly docs

[netlify]

✅ Deploy Preview for hyperformula-dev-docs ready!

Name	Link
🔨 Latest commit	f68804a
🔍 Latest deploy log	https://app.netlify.com/projects/hyperformula-dev-docs/deploys/6a54604467553900080e2ab9
😎 Deploy Preview	https://deploy-preview-1703--hyperformula-dev-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[github-actions]

Performance comparison of head (f68804a) vs base (033f8ac)

                                     testName |   base |   head | change
------------------------------------------------------------------------
                                      Sheet A | 509.36 | 513.87 | +0.89%
                                      Sheet B | 167.15 | 170.25 | +1.85%
                                      Sheet T | 146.66 | 145.39 | -0.87%
                                Column ranges | 531.53 | 535.82 | +0.81%
Sheet A:  change value, add/remove row/column |  17.61 |  18.95 | +7.61%
 Sheet B: change value, add/remove row/column | 151.01 | 156.14 | +3.40%
                   Column ranges - add column | 169.14 | 168.51 | -0.37%
                Column ranges - without batch | 517.24 | 521.32 | +0.79%
                        Column ranges - batch | 134.37 | 134.22 | -0.11%

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit ba78f3f. Configure here.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.15%. Comparing base (033f8ac) to head (f68804a).

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #1703   +/-   ##
========================================
  Coverage    97.15%   97.15%           
========================================
  Files          176      176           
  Lines        15404    15404           
  Branches      3409     3409           
========================================
  Hits         14966    14966           
  Misses         438      438           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.