@get-technology-inc/jamf-docs-mcp-server 5.5.0 → 5.7.0

package/dist/core/services/content-parser.js

@@ -32,22 +32,32 @@ turndown.addRule('stripScripts', {
     filter: ['script', 'style', 'noscript'],
     replacement: () => '',
 });
-// ─── HTML cleaning ──────────────────────────────────────────────
 /**
  * Clean HTML content: remove unwanted elements, fix relative URLs.
+ *
+ * Both the selector set and the link base are parameters with learn.jamf.com
+ * defaults rather than module constants, so a caller reading a different site
+ * gets that site's markup rules. Existing single-argument callers — the
+ * glossary path among them — are unaffected.
  */
-export function cleanHtml($) {
-    $(SELECTORS.REMOVE).remove();
+export function cleanHtml($, options) {
+    const selectors = options?.selectors ?? SELECTORS;
+    // Root-relative links resolve against the site they came from. Hard-coding
+    // learn.jamf.com here is what would point every internal link and image of
+    // a second source at the wrong host — silently, since both produce a valid
+    // absolute URL.
+    const linkBase = options?.linkBase ?? DOCS_BASE_URL;
+    $(selectors.REMOVE).remove();
     $('a[href^="/"]').each((_, el) => {
         const href = $(el).attr('href');
         if (href !== undefined && href !== '') {
-            $(el).attr('href', `${DOCS_BASE_URL}${href}`);
+            $(el).attr('href', `${linkBase}${href}`);
         }
     });
     $('img[src^="/"]').each((_, el) => {
         const src = $(el).attr('src');
         if (src !== undefined && src !== '') {
-            $(el).attr('src', `${DOCS_BASE_URL}${src}`);
+            $(el).attr('src', `${linkBase}${src}`);
         }
     });
 }
@@ -85,7 +95,11 @@ export function linkInternalSpans($, resolve) {
  */
 export function parseArticle(html, displayUrl, options) {
     const $ = cheerio.load(html);
-    cleanHtml($);
+    const selectors = options?.selectors ?? SELECTORS;
+    cleanHtml($, {
+        selectors,
+        ...(options?.linkBase !== undefined ? { linkBase: options.linkBase } : {}),
+    });
     // Before anything reads anchors: internal links are spans until this runs.
     const resolveInternalLink = options?.resolveInternalLink;
     if (resolveInternalLink !== undefined) {
@@ -99,7 +113,7 @@ export function parseArticle(html, displayUrl, options) {
     //    Checked before body wrappers because <article> is semantically broader
     //    and should take priority when both exist as siblings.
     if (contentHtml === '') {
-        contentHtml = $(SELECTORS.CONTENT).html() ?? '';
+        contentHtml = $(selectors.CONTENT).html() ?? '';
     }
     // 3. Common FT body wrappers (taskbody, conbody, refbody, etc.)
     if (contentHtml === '') {
@@ -113,19 +127,19 @@ export function parseArticle(html, displayUrl, options) {
     if (contentHtml === '') {
         contentHtml = html;
     }
-    const extractedTitle = $(SELECTORS.TITLE).first().text().trim();
+    const extractedTitle = $(selectors.TITLE).first().text().trim();
     const title = extractedTitle !== '' ? extractedTitle : 'Untitled';
     // Convert to Markdown and strip Turndown anchor artifacts from headings
     const content = turndown.turndown(contentHtml)
         .replace(/^(#{1,6}\s+)\[([^\]]*)\]\(#[^)]*\)/gm, '$1$2');
     // Extract breadcrumb
-    const breadcrumb = $(SELECTORS.BREADCRUMB)
+    const breadcrumb = $(selectors.BREADCRUMB)
         .map((_, el) => $(el).text().trim())
         .get()
         .filter(Boolean);
     // Extract related articles
     const relatedArticles = options?.includeRelated === true
-        ? $(SELECTORS.RELATED).map((_, el) => {
+        ? $(selectors.RELATED).map((_, el) => {
             const rawHref = $(el).attr('href') ?? '';
             if (rawHref === '' || rawHref.startsWith('#')) {
                 return { title: '', url: '' };

package/dist/core/services/content-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-parser.js","sourceRoot":"","sources":["../../../src/core/services/content-parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"content-parser.js","sourceRoot":"","sources":["../../../src/core/services/content-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,eAAe,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAA6B,MAAM,uBAAuB,CAAC;AAE1F,mEAAmE;AAEnE,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;IACnC,YAAY,EAAE,KAAK;IACnB,cAAc,EAAE,QAAQ;IACxB,gBAAgB,EAAE,GAAG;IACrB,WAAW,EAAE,GAAG;IAChB,eAAe,EAAE,IAAI;CACtB,CAAC,CAAC;AAEH,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE;IAC7B,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;QAC7B,MAAM,WAAW,GAAG,IAEnB,CAAC;QACF,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QACxE,OAAO,WAAW,QAAQ,KAAK,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5D,CAAC;CACF,CAAC,CAAC;AAEH,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE;IAC/B,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC;IACvC,WAAW,EAAE,GAAW,EAAE,CAAC,EAAE;CAC9B,CAAC,CAAC;AAYH;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,CAAqB,EAAE,OAA0B;IACzE,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,SAAS,CAAC;IAClD,2EAA2E;IAC3E,2EAA2E;IAC3E,2EAA2E;IAC3E,gBAAgB;IAChB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,aAAa,CAAC;IAEpD,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IAE7B,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACtC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;YACpC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,CAAqB,EACrB,OAA6B;IAE7B,CAAC,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC;AA+BD;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,UAAkB,EAClB,OAA6B;IAE7B,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,SAAS,CAAC;IAClD,SAAS,CAAC,CAAC,EAAE;QACX,SAAS;QACT,GAAG,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC,CAAC;IAEH,2EAA2E;IAC3E,MAAM,mBAAmB,GAAG,OAAO,EAAE,mBAAmB,CAAC;IACzD,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACtC,iBAAiB,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAC5C,CAAC;IAED,mEAAmE;IACnE,4CAA4C;IAE5C,+EAA+E;IAC/E,IAAI,WAAW,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAEzE,8EAA8E;IAC9E,4EAA4E;IAC5E,2DAA2D;IAC3D,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QACvB,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,gEAAgE;IAChE,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QACvB,WAAW,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,8EAA8E;IAC9E,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QACvB,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,qCAAqC;IACrC,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QACvB,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,MAAM,cAAc,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAChE,MAAM,KAAK,GAAG,cAAc,KAAK,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC;IAElE,wEAAwE;IACxE,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;SAC3C,OAAO,CAAC,sCAAsC,EAAE,MAAM,CAAC,CAAC;IAE3D,qBAAqB;IACrB,MAAM,UAAU,GAAG,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;SACnC,GAAG,EAAE;SACL,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,2BAA2B;IAC3B,MAAM,eAAe,GAAG,OAAO,EAAE,cAAc,KAAK,IAAI;QACtD,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;YAChC,CAAC;YACD,IAAI,WAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW,GAAG,OAAO,CAAC;YACxB,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;gBAC1B,GAAG,EAAE,WAAW;aACjB,CAAC;QACJ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;QACtD,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AACzD,CAAC;AAED,mEAAmE;AAEnE,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,YAAY,GAAG;IACnB,YAAY;IACZ,gCAAgC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,KAAa,EACb,OAAsB;IAEtB,2EAA2E;IAC3E,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,IAAI,IAAY,CAAC;IACjB,GAAG,CAAC;QACF,IAAI,GAAG,OAAO,CAAC;QACf,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC,QAAQ,OAAO,KAAK,IAAI,EAAE;IAE3B,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,uEAAuE;IACvE,oEAAoE;IACpE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE9C,IAAI,OAAO,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACxC,MAAM,aAAa,GACjB,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,OAAO,GAAG,KAAK,GAAG,aAAa,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/core/services/sitemap-service.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Table of contents for a static documentation source, built from its sitemap.
+ *
+ * A Fluid Topics publication ships a real TOC endpoint. A static site does
+ * not — but concepts.jamf.com publishes a sitemap whose paths already encode
+ * the hierarchy (`{locale}/guides/{category}/{article}`), so the tree can be
+ * derived from 990 URLs in one request instead of crawling 99 pages per
+ * locale and parsing each one's navigation.
+ */
+import type { StaticDocSource, StaticSection } from '../constants/sources.js';
+import type { ServerContext } from '../types/context.js';
+import type { FetchTocOptions, FetchTocResult, TocEntry } from '../types.js';
+/** One `<url>` of a sitemap, reduced to what a TOC needs. */
+export interface SitemapEntry {
+    /** Canonical absolute URL. */
+    url: string;
+    /** Path segments after the origin, e.g. `['en', 'guides', 'ai-governance']`. */
+    segments: string[];
+    /** `<lastmod>`, when present. */
+    lastModified?: string;
+}
+/**
+ * Extract every `<loc>` from a sitemap, with its `<lastmod>` when it has one.
+ *
+ * Deliberately a scan for `<url>` blocks rather than an XML parse: the
+ * document is a flat list, cheerio would have to be told to treat it as XML,
+ * and a sitemap that fails to parse should still yield the entries it does
+ * have.
+ */
+export declare function parseSitemap(xml: string): SitemapEntry[];
+/** Fetch and cache a source's sitemap. */
+export declare function loadSitemap(ctx: ServerContext, source: StaticDocSource): Promise<SitemapEntry[]>;
+/**
+ * Turn a slug into a heading: `ai-governance` → `AI Governance`.
+ *
+ * Checked against the fourteen real titles concepts.jamf.com's own guides
+ * index renders, which is the only place the site publishes them without a
+ * per-page request: eight of nine match exactly. The ninth is
+ * `infrastructure-as-code`, which the site titles "Infrastructure As Code"
+ * and this produces as "Infrastructure as Code" — standard title case
+ * lowercases "as", and matching one page's capitalisation is not worth a
+ * special case.
+ */
+export declare function titleFromSlug(slug: string): string;
+/**
+ * Build a TOC for one section of a static source, in one locale.
+ *
+ * @param locale the source's own locale code, e.g. `en` — not `en-US`
+ */
+export declare function buildStaticToc(ctx: ServerContext, source: StaticDocSource, section: StaticSection, locale: string): Promise<TocEntry[]>;
+/**
+ * A `FetchTocResult` for a static source's section.
+ *
+ * Pagination and token truncation are the same operations the Fluid Topics
+ * path performs, applied to entries that came from a sitemap instead of a
+ * map: a caller paging through a Concepts TOC must not get a different shape
+ * from one paging through Jamf Pro's.
+ */
+export declare function fetchStaticToc(ctx: ServerContext, source: StaticDocSource, section: StaticSection, sourceLocale: string, options?: FetchTocOptions): Promise<FetchTocResult>;
+//# sourceMappingURL=sitemap-service.d.ts.map

package/dist/core/services/sitemap-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/sitemap-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ7E,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAmBxD;AAED,0CAA0C;AAC1C,wBAAsB,WAAW,CAC/B,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CASzB;AA4BD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlD;AAsBD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,QAAQ,EAAE,CAAC,CAwBrB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAgCzB"}

package/dist/core/services/sitemap-service.js

@@ -0,0 +1,201 @@
+/**
+ * Table of contents for a static documentation source, built from its sitemap.
+ *
+ * A Fluid Topics publication ships a real TOC endpoint. A static site does
+ * not — but concepts.jamf.com publishes a sitemap whose paths already encode
+ * the hierarchy (`{locale}/guides/{category}/{article}`), so the tree can be
+ * derived from 990 URLs in one request instead of crawling 99 pages per
+ * locale and parsing each one's navigation.
+ */
+import { httpGetText } from '../http-client.js';
+import { cacheKey } from './cache-key.js';
+import { canonicalStaticUrl } from './static-article-service.js';
+import { PAGINATION_CONFIG, TOKEN_CONFIG } from '../constants.js';
+import { calculatePagination, truncateListByTokens, buildPaginationNote, } from './tokenizer.js';
+/**
+ * Extract every `<loc>` from a sitemap, with its `<lastmod>` when it has one.
+ *
+ * Deliberately a scan for `<url>` blocks rather than an XML parse: the
+ * document is a flat list, cheerio would have to be told to treat it as XML,
+ * and a sitemap that fails to parse should still yield the entries it does
+ * have.
+ */
+export function parseSitemap(xml) {
+    const out = [];
+    for (const block of xml.match(/<url\b[\s\S]*?<\/url>/g) ?? []) {
+        const loc = /<loc>\s*([^<\s]+)\s*<\/loc>/.exec(block)?.[1];
+        if (loc === undefined) {
+            continue;
+        }
+        const lastmod = /<lastmod>\s*([^<\s]+)\s*<\/lastmod>/.exec(block)?.[1];
+        let segments;
+        try {
+            segments = new URL(loc).pathname.split('/').filter(Boolean);
+        }
+        catch {
+            continue;
+        }
+        out.push({
+            url: canonicalStaticUrl(loc),
+            segments,
+            ...(lastmod !== undefined ? { lastModified: lastmod } : {}),
+        });
+    }
+    return out;
+}
+/** Fetch and cache a source's sitemap. */
+export async function loadSitemap(ctx, source) {
+    const key = cacheKey('static-sitemap', { source: source.id });
+    const cached = await ctx.cache.get(key);
+    if (cached !== null) {
+        return cached;
+    }
+    const xml = await httpGetText(`${source.baseUrl}/sitemap.xml`);
+    const entries = parseSitemap(xml);
+    await ctx.cache.set(key, entries, ctx.config.cacheTtl.products);
+    return entries;
+}
+/**
+ * Terms whose casing a naive capitalise gets wrong.
+ *
+ * The sitemap gives slugs, not titles, and fetching 99 pages per locale to
+ * read each `og:title` is not worth one heading apiece. Word-by-word
+ * capitalisation produces "Ai Governance", "Byod" and "Ios", which read as
+ * mistakes; this table is what the site's own index page shows those as.
+ * Keyed lowercase.
+ */
+const TITLE_CASE_TERMS = {
+    ai: 'AI', api: 'API', byod: 'BYOD', ddm: 'DDM', it: 'IT', mdm: 'MDM',
+    pki: 'PKI', ldap: 'LDAP', scep: 'SCEP', ztna: 'ZTNA', sso: 'SSO',
+    vpn: 'VPN', mfa: 'MFA', dns: 'DNS', ip: 'IP', tls: 'TLS', url: 'URL',
+    json: 'JSON', xml: 'XML', sdk: 'SDK', cli: 'CLI', ui: 'UI', ux: 'UX',
+    id: 'ID', edr: 'EDR', xdr: 'XDR', siem: 'SIEM', saas: 'SaaS',
+    macos: 'macOS', ios: 'iOS', ipados: 'iPadOS', tvos: 'tvOS',
+    watchos: 'watchOS', visionos: 'visionOS', jamf: 'Jamf', apple: 'Apple',
+    aws: 'AWS', okta: 'Okta', entra: 'Entra', jss: 'JSS',
+};
+/** Words that stay lowercase unless they open the title. */
+const TITLE_MINOR_WORDS = new Set([
+    'a', 'an', 'and', 'as', 'at', 'but', 'by', 'for', 'in', 'of', 'on', 'or',
+    'the', 'to', 'via', 'with',
+]);
+/**
+ * Turn a slug into a heading: `ai-governance` → `AI Governance`.
+ *
+ * Checked against the fourteen real titles concepts.jamf.com's own guides
+ * index renders, which is the only place the site publishes them without a
+ * per-page request: eight of nine match exactly. The ninth is
+ * `infrastructure-as-code`, which the site titles "Infrastructure As Code"
+ * and this produces as "Infrastructure as Code" — standard title case
+ * lowercases "as", and matching one page's capitalisation is not worth a
+ * special case.
+ */
+export function titleFromSlug(slug) {
+    const words = slug.split('-').filter(Boolean);
+    return words
+        .map((word, index) => {
+        const known = TITLE_CASE_TERMS[word.toLowerCase()];
+        if (known !== undefined) {
+            return known;
+        }
+        if (index > 0 && TITLE_MINOR_WORDS.has(word.toLowerCase())) {
+            return word.toLowerCase();
+        }
+        return word.charAt(0).toUpperCase() + word.slice(1);
+    })
+        .join(' ');
+}
+function toTocEntries(nodes, titles) {
+    return [...nodes]
+        .sort((a, b) => a.slug.localeCompare(b.slug))
+        .map(node => {
+        const children = toTocEntries(node.children.values(), titles);
+        const entry = {
+            title: titles.get(node.url ?? '') ?? titleFromSlug(node.slug),
+            url: node.url ?? '',
+        };
+        if (children.length > 0) {
+            entry.children = children;
+        }
+        return entry;
+    });
+}
+/**
+ * Build a TOC for one section of a static source, in one locale.
+ *
+ * @param locale the source's own locale code, e.g. `en` — not `en-US`
+ */
+export async function buildStaticToc(ctx, source, section, locale) {
+    const entries = await loadSitemap(ctx, source);
+    const root = new Map();
+    for (const entry of entries) {
+        const [entryLocale, entrySection, ...rest] = entry.segments;
+        if (entryLocale !== locale || entrySection !== section.path) {
+            continue;
+        }
+        // The section's own index page is the container, not a child of itself.
+        if (rest.length === 0) {
+            continue;
+        }
+        let level = root;
+        let node;
+        for (const slug of rest) {
+            node = level.get(slug);
+            if (node === undefined) {
+                node = { slug, children: new Map() };
+                level.set(slug, node);
+            }
+            level = node.children;
+        }
+        if (node !== undefined) {
+            node.url = entry.url;
+        }
+    }
+    return toTocEntries(root.values(), new Map());
+}
+/**
+ * A `FetchTocResult` for a static source's section.
+ *
+ * Pagination and token truncation are the same operations the Fluid Topics
+ * path performs, applied to entries that came from a sitemap instead of a
+ * map: a caller paging through a Concepts TOC must not get a different shape
+ * from one paging through Jamf Pro's.
+ */
+export async function fetchStaticToc(ctx, source, section, sourceLocale, options = {}) {
+    const page = options.page ?? PAGINATION_CONFIG.DEFAULT_PAGE;
+    const maxTokens = options.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS;
+    const allToc = await buildStaticToc(ctx, source, section, sourceLocale);
+    const totalItems = countTocEntries(allToc);
+    const paginationCalc = calculatePagination(allToc.length, page, PAGINATION_CONFIG.DEFAULT_PAGE_SIZE);
+    const paginated = allToc.slice(paginationCalc.startIndex, paginationCalc.endIndex);
+    const { items, tokenCount, truncated } = truncateListByTokens(paginated, maxTokens, tocEntryToString);
+    const paginationNote = buildPaginationNote(paginationCalc);
+    return {
+        toc: items,
+        pagination: {
+            page: paginationCalc.page,
+            pageSize: paginationCalc.pageSize,
+            totalPages: paginationCalc.totalPages,
+            totalItems,
+            hasNext: paginationCalc.hasNext,
+            hasPrev: paginationCalc.hasPrev,
+        },
+        tokenInfo: { tokenCount, truncated, maxTokens },
+        // The locale that answered is the one asked for: unlike Fluid Topics,
+        // where a family may exist in en-US only, a static section either
+        // publishes the locale or `resolveTocSource` refused before reaching here.
+        resolvedLocale: sourceLocale,
+        ...(paginationNote !== undefined ? { paginationNote } : {}),
+    };
+}
+/** Total entries including nested children. Mirrors toc-service's own count. */
+function countTocEntries(entries) {
+    return entries.reduce((count, entry) => count + 1 + (entry.children !== undefined ? countTocEntries(entry.children) : 0), 0);
+}
+/** Serialise one entry for token estimation. Mirrors toc-service's. */
+function tocEntryToString(entry, depth = 0) {
+    const indent = '  '.repeat(depth);
+    const childrenStr = entry.children?.map(c => tocEntryToString(c, depth + 1)).join('') ?? '';
+    return `${indent}- ${entry.title}\n${childrenStr}`;
+}
+//# sourceMappingURL=sitemap-service.js.map

package/dist/core/services/sitemap-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-service.js","sourceRoot":"","sources":["../../../src/core/services/sitemap-service.ts"],"names":[],"mappings":"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"}

package/dist/core/services/static-article-service.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Article retrieval for documentation sources outside Fluid Topics.
+ *
+ * The Fluid Topics path addresses a topic by `mapId` + `contentId` and gets
+ * an HTML fragment back. A static site has neither: the address is the URL,
+ * and the response is a whole page whose navigation has to be stripped before
+ * anything else. Everything downstream of that — sections, summaries,
+ * truncation — is shared with the FT path through
+ * {@link buildArticleView}, so the two cannot drift on what a caller sees.
+ */
+import type { StaticDocSource } from '../constants/sources.js';
+import type { ServerContext } from '../types/context.js';
+import type { FetchArticleOptions, FetchArticleResult } from '../types.js';
+/**
+ * Canonicalise a URL for a static site.
+ *
+ * concepts.jamf.com's sitemap emits paths without a trailing slash while the
+ * site itself redirects to the slashed form — all 990 entries, so fetching
+ * them as listed is 990 redirects. Adding the slash up front is one line here
+ * and saves a round trip per article. Paths that look like a file (`.html`,
+ * `.json`) are left alone, as is anything with a query or fragment.
+ */
+export declare function canonicalStaticUrl(urlStr: string): string;
+/**
+ * The page's own title, preferring Open Graph over `<title>`.
+ *
+ * `<title>` on these sites carries a site-name suffix ("API Utility | Jamf
+ * Concepts"); `og:title` is the same string without it, so it is tried first
+ * and the suffix trimmed only as a fallback.
+ */
+export declare function extractDocumentTitle(html: string): string | undefined;
+/**
+ * Fetch and parse one article from a static documentation source.
+ *
+ * @param source the registry row for the hostname in `url`
+ */
+export declare function fetchStaticArticle(ctx: ServerContext, source: StaticDocSource, url: string, options?: FetchArticleOptions): Promise<FetchArticleResult>;
+//# sourceMappingURL=static-article-service.d.ts.map

package/dist/core/services/static-article-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-article-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/static-article-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAU3E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWzD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASrE;AAYD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA2D7B"}

package/dist/core/services/static-article-service.js

@@ -0,0 +1,121 @@
+/**
+ * Article retrieval for documentation sources outside Fluid Topics.
+ *
+ * The Fluid Topics path addresses a topic by `mapId` + `contentId` and gets
+ * an HTML fragment back. A static site has neither: the address is the URL,
+ * and the response is a whole page whose navigation has to be stripped before
+ * anything else. Everything downstream of that — sections, summaries,
+ * truncation — is shared with the FT path through
+ * {@link buildArticleView}, so the two cannot drift on what a caller sees.
+ */
+import { httpGetText } from '../http-client.js';
+import { parseArticle } from './content-parser.js';
+import { buildArticleView } from './article-view.js';
+import { extractSections } from './tokenizer.js';
+import { cacheKey } from './cache-key.js';
+import { TOKEN_CONFIG } from '../constants.js';
+/**
+ * Canonicalise a URL for a static site.
+ *
+ * concepts.jamf.com's sitemap emits paths without a trailing slash while the
+ * site itself redirects to the slashed form — all 990 entries, so fetching
+ * them as listed is 990 redirects. Adding the slash up front is one line here
+ * and saves a round trip per article. Paths that look like a file (`.html`,
+ * `.json`) are left alone, as is anything with a query or fragment.
+ */
+export function canonicalStaticUrl(urlStr) {
+    try {
+        const url = new URL(urlStr);
+        const last = url.pathname.split('/').pop() ?? '';
+        if (!url.pathname.endsWith('/') && !last.includes('.')) {
+            url.pathname = `${url.pathname}/`;
+        }
+        return url.toString();
+    }
+    catch {
+        return urlStr;
+    }
+}
+/**
+ * The page's own title, preferring Open Graph over `<title>`.
+ *
+ * `<title>` on these sites carries a site-name suffix ("API Utility | Jamf
+ * Concepts"); `og:title` is the same string without it, so it is tried first
+ * and the suffix trimmed only as a fallback.
+ */
+export function extractDocumentTitle(html) {
+    const og = /<meta[^>]+property=["']og:title["'][^>]+content=["']([^"']+)["']/i.exec(html)
+        ?? /<meta[^>]+content=["']([^"']+)["'][^>]+property=["']og:title["']/i.exec(html);
+    if (og?.[1] !== undefined && og[1].trim() !== '') {
+        return decodeEntities(og[1].trim());
+    }
+    const title = /<title[^>]*>([^<]*)<\/title>/i.exec(html);
+    if (title?.[1] === undefined) {
+        return undefined;
+    }
+    const trimmed = title[1].split('|')[0]?.trim() ?? '';
+    return trimmed !== '' ? decodeEntities(trimmed) : undefined;
+}
+/** The handful of entities that survive into a title attribute. */
+function decodeEntities(text) {
+    return text
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#(?:39|x27);/g, "'");
+}
+/**
+ * Fetch and parse one article from a static documentation source.
+ *
+ * @param source the registry row for the hostname in `url`
+ */
+export async function fetchStaticArticle(ctx, source, url, options = {}) {
+    const maxTokens = options.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS;
+    const displayUrl = canonicalStaticUrl(url);
+    const key = cacheKey('static-article', { source: source.id, url: displayUrl });
+    let cached = await ctx.cache.get(key);
+    if (cached === null) {
+        const html = await httpGetText(displayUrl);
+        const documentTitle = extractDocumentTitle(html);
+        const parsed = parseArticle(html, displayUrl, {
+            // The source's own markup rules. Parsing a static page with Fluid
+            // Topics' selectors finds no content wrapper and falls through to
+            // <body>, which is the whole site chrome.
+            selectors: source.selectors,
+            // Root-relative links belong to this source, not learn.jamf.com.
+            linkBase: source.baseUrl,
+            ...(options.includeRelated !== undefined ? { includeRelated: options.includeRelated } : {}),
+        });
+        // `parseArticle` reads the first surviving <h1>. On a static site the
+        // page heading often lives in a hero section outside the content wrapper,
+        // and stripping the chrome takes it with it — concepts.jamf.com's tool
+        // pages put their only <h1> there, so every one of the 37 came back
+        // "Untitled". The document's own title is the reliable answer when the
+        // body has none of its own; Fluid Topics never needs this because its
+        // titles arrive as metadata.
+        const title = parsed.title !== 'Untitled' ? parsed.title : documentTitle ?? parsed.title;
+        cached = { title, parsed, displayUrl };
+        await ctx.cache.set(key, cached, ctx.config.cacheTtl.article);
+    }
+    const { title, parsed } = cached;
+    // Provenance is part of the content, not metadata: it has to survive
+    // section extraction and truncation, both of which slice `content`, and a
+    // reader who asked for one section still needs to know what they are
+    // reading.
+    const content = source.provenance !== undefined
+        ? `${parsed.content}\n\n---\n\n*${source.provenance}*\n`
+        : parsed.content;
+    const allSections = extractSections(content);
+    return buildArticleView({
+        title,
+        url: cached.displayUrl,
+        product: source.name,
+        breadcrumb: parsed.breadcrumb.length > 0 ? parsed.breadcrumb : undefined,
+        relatedArticles: options.includeRelated === true && parsed.relatedArticles.length > 0
+            ? parsed.relatedArticles
+            : undefined,
+        sections: allSections,
+    }, content, options, maxTokens, allSections);
+}
+//# sourceMappingURL=static-article-service.js.map

package/dist/core/services/static-article-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-article-service.js","sourceRoot":"","sources":["../../../src/core/services/static-article-service.ts"],"names":[],"mappings":"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"}

package/dist/core/tools/get-toc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-toc.d.ts","sourceRoot":"","sources":["../../../src/core/tools/get-toc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA8YzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CA0I9E"}
+{"version":3,"file":"get-toc.d.ts","sourceRoot":"","sources":["../../../src/core/tools/get-toc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAobzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAuJ9E"}

package/dist/core/tools/get-toc.js

@@ -6,8 +6,10 @@ import { appToolMeta } from '../apps/index.js';
 import { GetTocInputSchema } from '../schemas/index.js';
 import { reportProgress } from '../utils/progress.js';
 import { TocOutputSchema } from '../schemas/output.js';
-import { ResponseFormat, OutputMode, JAMF_PRODUCTS, PRODUCT_ID_LIST, TOKEN_CONFIG, PAGINATION_CONFIG } from '../constants.js';
+import { ResponseFormat, OutputMode, JAMF_PRODUCTS, PRODUCT_ID_LIST, TOKEN_CONFIG, PAGINATION_CONFIG, DEFAULT_LOCALE } from '../constants.js';
 import { fetchTableOfContents } from '../services/toc-service.js';
+import { fetchStaticToc } from '../services/sitemap-service.js';
+import { staticSectionById, } from '../constants/sources.js';
 import { getAvailableVersions } from '../services/metadata.js';
 import { sanitizeMarkdownText, sanitizeMarkdownUrl, getSafeErrorMessage } from '../utils/sanitize.js';
 /**
@@ -291,6 +293,26 @@ async function resolveTocSource(ctx, params, version) {
         };
     }
     const publication = params.publication ?? '';
+    // Static sources first: their sections are publications too, and they are
+    // not in the Fluid Topics maps registry, so asking it would report them as
+    // unknown and suggest something else.
+    const staticRow = staticSectionById(publication);
+    if (staticRow !== undefined) {
+        const locale = params.language ?? DEFAULT_LOCALE;
+        const sourceLocale = staticRow.source.locales[locale];
+        if (sourceLocale === undefined) {
+            return {
+                error: `${staticRow.source.name} does not publish in ${locale}. ` +
+                    `Available: ${Object.keys(staticRow.source.locales).join(', ')}.`,
+            };
+        }
+        return {
+            source: publication,
+            sourceLabel: staticRow.section.title,
+            availableVersions: [],
+            staticSection: { ...staticRow, sourceLocale },
+        };
+    }
     // Not an enum: there are 97 families and the set is upstream's to change,
     // so the check is a registry lookup and a miss carries suggestions rather
     // than a wall of every id.
@@ -358,11 +380,17 @@ export function registerGetTocTool(server, ctx) {
                 }
             }
             await reportProgress(extra, { progress: 0, total: 4, message: 'Fetching TOC...' });
-            const tocResult = await fetchTableOfContents(ctx, source, version, {
+            const tocOptions = {
                 ...(params.page !== undefined && { page: params.page }),
                 maxTokens: params.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS,
-                locale: params.language
-            });
+                locale: params.language,
+            };
+            // A static source has no map and no TOC endpoint; its tree comes from
+            // the sitemap. Pagination and truncation are shared so both kinds of
+            // TOC behave the same once the entries exist.
+            const tocResult = resolved.staticSection !== undefined
+                ? await fetchStaticToc(ctx, resolved.staticSection.source, resolved.staticSection.section, resolved.staticSection.sourceLocale, tocOptions)
+                : await fetchTableOfContents(ctx, source, version, tocOptions);
             await reportProgress(extra, { progress: 1, total: 4, message: 'Processing entries...' });
             const { toc, pagination, tokenInfo, paginationNote, mapId, resolvedLocale } = tocResult;
             // Build response