@yadsh/dsh-web-fetch-authenticated 0.2.0 → 0.3.1

package/README.md

@@ -1,5 +1,7 @@
 # @yadsh/dsh-web-fetch-authenticated
 
+[Русский гайд: настройка Jira и Confluence](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-web-fetch-authenticated/docs/JIRA-CONFLUENCE.ru.md)
+
 An authenticated, policy-gated [`WebFetchProvider`](../../docs/) for the
 DeepSeek Harness web capability seam (`ctx.web`). It lets the existing
 model-facing `web_fetch(url)` tool retrieve content from approved
@@ -11,6 +13,24 @@ prompts, or the browser UI**.
 > which credential may be used for it, how authentication is attached, and
 > whether redirects are safe. The model never supplies or receives secrets.
 
+## Installation
+
+Install the published npm package by name:
+
+```bash
+dsh plugin --profile web add @yadsh/dsh-web-fetch-authenticated
+```
+
+To remove the plugin:
+
+```bash
+dsh plugin --profile web remove @yadsh/dsh-web-fetch-authenticated
+```
+
+Then pin the provider in the profile patch (`fetchProvider: authenticated`) so
+the model-facing `web_fetch` tool routes through this plugin; without the pin
+the plugin stays inert.
+
 ## How it works
 
 ```text
@@ -24,6 +44,7 @@ web_fetch(url)
   -> request with DNS pinning
   -> per-hop redirect re-validation
   -> bounded body read
+  -> content adapter (optional: REST fetch + normalization, see below)
   -> WebFetchResult (existing dsh-tool-web HTML -> Markdown)
 ```
 
@@ -79,6 +100,11 @@ Secrets are stored through the DSH credential store (`$DSH_HOME` credential
 backend) under POSIX-style reference names (`JIRA_TOKEN`); configuration keeps
 only the reference. Use the UI (or `api.credentials.set`) to store the value.
 
+For an end-to-end corporate setup, including provider selection, credentials,
+private-network policy, Jira/Confluence Cloud and Server/Data Center examples,
+testing, and troubleshooting, see the
+[Russian Jira and Confluence guide](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-web-fetch-authenticated/docs/JIRA-CONFLUENCE.ru.md).
+
 ### Security defaults
 
 | Policy | Default |
@@ -95,6 +121,42 @@ answers are resolved, all candidates are classified, one denied answer denies
 the whole set (DNS-rebinding defense), and the socket is pinned to the
 approved addresses.
 
+## Content adapters (Jira / Confluence)
+
+Raw HTML from enterprise apps converts to Markdown with all the application
+chrome attached. A rule can instead select a **content adapter**: recognized
+URLs are re-fetched from the product's REST API through the same authenticated
+transport (same network policy, credentials, redirect policy, and limits) and
+normalized into compact Markdown text — issue fields, description, and optional
+comments/links for Jira; page metadata and the storage-format body for
+Confluence. Unrecognized URLs fall back to raw HTTP/HTML.
+
+- **Jira** — `/browse/ISSUE-KEY` at any deployment depth and `/issues/KEY`.
+  `jiraFlavor: server` (default) uses REST v2 and converts wiki-markup bodies;
+  `jiraFlavor: cloud` uses REST v3 and converts Atlassian Document Format.
+  `includeComments` and `includeLinks` add comments and issue links (off by
+  default).
+- **Confluence** — `/pages/<id>/…` (Server and Cloud, including `/wiki/…`
+  paths) fetch directly; `/display/<SPACE>/<Title>` resolves via the title
+  lookup. Storage-format XHTML becomes Markdown: headings, lists, tables,
+  links, entities, code/noformat/panel/expand macros (unknown macros leave a
+  visible placeholder instead of vanishing).
+
+Configured in the rule editor ("Content adapter") or declaratively:
+
+```yaml
+adapter:
+  type: jira
+  jiraFlavor: server
+  includeComments: true
+```
+
+Non-2xx REST responses stay results (the seam never throws for status codes):
+the model sees a short `[Jira]`/`[Confluence]` HTTP-status note. Malformed or
+non-JSON REST bodies fail with `AUTH_FETCH_ADAPTER_FAILED`. The generated text
+is capped by the rule's `maxBodyChars`, and the connection tester runs the
+adapter too, so Test shows the exact normalized text the model will get.
+
 ## Error codes
 
 `AUTH_FETCH_NO_MATCHING_RULE`, `AUTH_FETCH_AMBIGUOUS_MATCH`,
@@ -102,7 +164,8 @@ approved addresses.
 `AUTH_FETCH_CREDENTIAL_INVALID`, `AUTH_FETCH_NETWORK_DENIED`,
 `AUTH_FETCH_DNS_POLICY_DENIED`, `AUTH_FETCH_REDIRECT_DENIED`,
 `AUTH_FETCH_RESPONSE_TOO_LARGE`, `AUTH_FETCH_UNSUPPORTED_CONTENT`,
-`AUTH_FETCH_TIMEOUT`, `AUTH_FETCH_INVALID_URL`, `AUTH_FETCH_PROVIDER_ERROR` —
+`AUTH_FETCH_TIMEOUT`, `AUTH_FETCH_INVALID_URL`, `AUTH_FETCH_PROVIDER_ERROR`,
+`AUTH_FETCH_ADAPTER_FAILED` —
 surfaced as `WebError` codes through the existing `web_fetch` error metadata.
 
 ## Development
@@ -115,8 +178,8 @@ pnpm --filter @yadsh/dsh-web-fetch-authenticated check   # lint + typecheck + te
 ```
 
 `INVESTIGATE.md` documents the exact DSH APIs and integration assumptions
-(SPEC phase 0). The v1 scope intentionally excludes cookies/OAuth/Jira-adapter
-features (see SPEC §29 phases 4–5).
+(SPEC phase 0). Cookies/OAuth and advanced auth remain excluded (SPEC §29
+phase 5); the Jira/Confluence content adapters (phase 4) are implemented.
 
 ## License
 

package/compatibility.json

@@ -1,9 +1,9 @@
 {
   "deepseekHarness": {
     "channel": "next",
-    "range": ">=0.1.1-rc.2 <0.2.0",
+    "range": ">=0.1.5-rc.2 <0.2.0",
     "testedReleases": [
-      "0.1.1-rc.2"
+      "0.1.5-rc.2"
     ],
     "requiredHostFeatures": [
       "web",

package/lib/adapters/confluence.js

@@ -0,0 +1,406 @@
+/**
+ * Confluence content adapter (SPEC §15.2/§16): recognize page URLs, fetch the
+ * page through the Confluence REST API with the SAME authenticated transport,
+ * and normalize the storage-format XHTML body into compact Markdown text —
+ * page metadata plus the readable content, without theme chrome or macros.
+ * Page-id URLs (`/pages/<id>`) fetch directly; `/display/<SPACE>/<Title>`
+ * URLs resolve the page by space key and title first.
+ * @module adapters/confluence
+ */
+import * as errors from '../errors.js';
+import { isElement, isText, parseMarkup, textContent } from './markup.js';
+/**
+ * Extract a page reference from a URL path. Recognizes:
+ * - `/**\/pages/<id>/**` (Server and Cloud; Cloud paths carry a `/wiki` prefix),
+ * - `/**\/display/<SPACE>/<Title+With+Plus>` (Server display URLs).
+ * Returns `undefined` for URLs the adapter cannot map.
+ */
+export function extractPageRef(pathname) {
+    const segments = pathname.split('/').filter(segment => segment.length > 0);
+    const pagesIndex = segments.lastIndexOf('pages');
+    if (pagesIndex >= 0) {
+        const id = segments[pagesIndex + 1];
+        if (id !== undefined && /^\d+$/u.test(id))
+            return { id };
+    }
+    const displayIndex = segments.lastIndexOf('display');
+    if (displayIndex >= 0) {
+        const spaceKey = segments[displayIndex + 1];
+        const title = segments.slice(displayIndex + 2).join('/');
+        if (spaceKey !== undefined && title.length > 0) {
+            return { spaceKey: spaceKey.toUpperCase(), title: decodeURIComponent(title).replace(/\+/gu, ' ') };
+        }
+    }
+    return undefined;
+}
+/**
+ * REST base path prefix: Cloud paths live under `/wiki` and so does its REST
+ * API; Server instances serve `/rest/api` at the origin root.
+ */
+export function restPrefix(pathname) {
+    return /^\/wiki(?:\/|$)/u.test(pathname) ? '/wiki/rest/api' : '/rest/api';
+}
+/** REST URL of one content item with the expansions the renderer needs. */
+export function contentApiUrl(origin, prefix, id) {
+    const url = new URL(`${prefix}/content/${id}`, origin);
+    url.searchParams.set('expand', 'body.storage,space,version');
+    return url;
+}
+/** REST URL of the space-key + title lookup used by `/display/` URLs. */
+export function contentLookupUrl(origin, prefix, spaceKey, title) {
+    const url = new URL(`${prefix}/content`, origin);
+    url.searchParams.set('spaceKey', spaceKey);
+    url.searchParams.set('title', title);
+    url.searchParams.set('expand', 'body.storage,space,version');
+    return url;
+}
+/** Fetch a Confluence page and normalize it into Markdown text. */
+export async function fetchPageMarkdown(requestUrl, adapter, fetchJson) {
+    const ref = extractPageRef(requestUrl.pathname);
+    if (ref === undefined)
+        throw errors.adapterFailed(`URL path "${requestUrl.pathname}" is not a recognizable Confluence page URL`);
+    const prefix = restPrefix(requestUrl.pathname);
+    let response;
+    if (ref.id !== undefined) {
+        response = await fetchJson(contentApiUrl(requestUrl.origin, prefix, ref.id));
+    }
+    else {
+        response = await fetchJson(contentLookupUrl(requestUrl.origin, prefix, ref.spaceKey ?? '', ref.title ?? ''));
+    }
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        // Non-2xx stays a RESULT (the seam contract), like the Jira adapter.
+        const target = ref.id !== undefined ? `page ${ref.id}` : `"${ref.title}" in space ${ref.spaceKey}`;
+        return {
+            statusCode: response.statusCode,
+            markdown: `[Confluence] The Confluence REST API returned HTTP ${response.statusCode} for ${target} at ${requestUrl.origin}${prefix}.`,
+        };
+    }
+    const page = asContent(response.data);
+    const markdown = renderPage(page);
+    return { statusCode: response.statusCode, markdown };
+}
+function asContent(data) {
+    // The title lookup returns a results envelope; direct fetches return the page.
+    const record = data;
+    if (Array.isArray(record.results)) {
+        const first = record.results[0];
+        if (typeof first !== 'object' || first === null) {
+            throw errors.adapterFailed('Confluence REST lookup returned no page for the requested title');
+        }
+        return first;
+    }
+    return record;
+}
+function renderPage(page) {
+    const lines = [];
+    const title = typeof page.title === 'string' && page.title.length > 0 ? page.title : 'Untitled page';
+    const space = typeof page.space?.name === 'string' ? page.space.name : typeof page.space?.key === 'string' ? page.space.key : undefined;
+    const updated = typeof page.version?.when === 'string' ? page.version.when.slice(0, 10) : undefined;
+    lines.push(`# ${title}`);
+    lines.push('');
+    const facts = [];
+    if (space !== undefined)
+        facts.push(`Space: ${space}`);
+    if (updated !== undefined)
+        facts.push(`Updated: ${updated}`);
+    if (facts.length > 0) {
+        for (const fact of facts)
+            lines.push(`- ${fact}`);
+        lines.push('');
+    }
+    const storage = page.body?.storage?.value;
+    if (typeof storage === 'string' && storage.trim().length > 0) {
+        lines.push(storageToMarkdown(storage));
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd();
+}
+// ---- Confluence storage-format XHTML → Markdown ----
+/** Convert a Confluence storage body (XHTML + `ac:` macros) into Markdown. */
+export function storageToMarkdown(storage) {
+    const nodes = parseMarkup(storage);
+    const blocks = renderBlocks(nodes);
+    return blocks.join('\n\n').replace(/\n{3,}/gu, '\n\n').trim();
+}
+/** Elements whose rendered content stays on the current block. */
+const INLINE_ELEMENTS = new Set([
+    'span', 'a', 'strong', 'b', 'em', 'i', 'u', 's', 'strike', 'code', 'sub', 'sup', 'tt',
+    'br', 'ac:link', 'ac:emoticon', 'ac:plain-text-link-body', 'ac:link-body', 'ac:image', 'ri:attachment', 'ri:page', 'ri:user', 'ac:placeholder',
+]);
+function renderBlocks(nodes) {
+    const out = [];
+    let inlineBuffer = [];
+    const flush = () => {
+        const text = inlineBuffer.join('').trim();
+        inlineBuffer = [];
+        if (text.length > 0)
+            out.push(text);
+    };
+    for (const node of nodes) {
+        if (isText(node)) {
+            inlineBuffer.push(collapseWhitespace(node.value));
+            continue;
+        }
+        if (INLINE_ELEMENTS.has(node.name)) {
+            inlineBuffer.push(renderInlineElement(node));
+            continue;
+        }
+        flush();
+        out.push(...renderBlockElement(node));
+    }
+    flush();
+    return out.filter(block => block.length > 0);
+}
+function renderBlockElement(node) {
+    switch (node.name) {
+        case 'p': {
+            const text = renderInline(node.children).replace(/\s+/gu, ' ').trim();
+            return text.length === 0 ? [] : [text];
+        }
+        case 'h1':
+        case 'h2':
+        case 'h3':
+        case 'h4':
+        case 'h5':
+        case 'h6': {
+            const text = renderInline(node.children).trim();
+            return text.length === 0 ? [] : [`${'#'.repeat(Number(node.name.slice(1)))} ${text}`];
+        }
+        case 'ul':
+        case 'ol':
+            return renderList(node, node.name === 'ol' ? 1 : 0, 0);
+        case 'blockquote': {
+            const inner = renderBlocks(node.children).join('\n\n');
+            return inner.length === 0 ? [] : [inner.split('\n').map(line => `> ${line}`).join('\n')];
+        }
+        case 'pre':
+            return ['```\n' + textContent(node.children).replace(/\n$/u, '') + '\n```'];
+        case 'table':
+            return renderTable(node);
+        case 'hr':
+            return ['---'];
+        case 'ac:structured-macro':
+            return [renderMacro(node)].filter(block => block.length > 0);
+        case 'ac:layout':
+        case 'ac:layout-section':
+        case 'ac:layout-cell':
+        case 'div':
+        case 'section':
+        case 'article':
+        case 'tbody':
+        case 'thead':
+        case 'tfoot':
+            return renderBlocks(node.children);
+        default:
+            // Unknown block elements: keep their text so content is never dropped.
+            return renderBlocks(node.children);
+    }
+}
+function renderInlineElement(node) {
+    switch (node.name) {
+        case 'br':
+            return '  \n';
+        case 'a': {
+            const href = node.attrs.href ?? '';
+            const text = renderInline(node.children).trim();
+            if (href.length === 0)
+                return text;
+            return `[${text.length > 0 ? text : href}](${href})`;
+        }
+        case 'strong':
+        case 'b': {
+            const text = renderInline(node.children).trim();
+            return text.length === 0 ? '' : `**${text}**`;
+        }
+        case 'em':
+        case 'i': {
+            const text = renderInline(node.children).trim();
+            return text.length === 0 ? '' : `*${text}*`;
+        }
+        case 's':
+        case 'strike': {
+            const text = renderInline(node.children).trim();
+            return text.length === 0 ? '' : `~~${text}~~`;
+        }
+        case 'code':
+        case 'tt': {
+            const text = textContent(node.children);
+            return text.length === 0 ? '' : '`' + text + '`';
+        }
+        case 'ac:emoticon':
+            return node.attrs['ac:name'] ?? '';
+        case 'ac:link':
+            return renderAcLink(node);
+        case 'ac:placeholder':
+            return '';
+        case 'ac:image':
+        case 'ri:attachment': {
+            const name = node.attrs['ri:filename'] ?? findDescendantAttr(node, 'ri:attachment', 'ri:filename') ?? 'attachment';
+            return `_[${name}]_`;
+        }
+        default:
+            return renderInline(node.children);
+    }
+}
+function renderAcLink(node) {
+    const body = node.children.find(child => isElement(child) && (child.name === 'ac:link-body' || child.name === 'ac:plain-text-link-body'));
+    let label;
+    if (isElement(body)) {
+        label = body.name === 'ac:plain-text-link-body'
+            ? textContent(body.children).trim()
+            : renderInline(body.children).trim();
+    }
+    const pageRef = findDescendantAttr(node, 'ri:page', 'ri:content-title');
+    const anchor = node.attrs['ac:anchor'];
+    if (label !== undefined && label.length > 0)
+        return label;
+    if (typeof pageRef === 'string' && pageRef.length > 0)
+        return pageRef;
+    if (typeof anchor === 'string' && anchor.length > 0)
+        return anchor;
+    return '';
+}
+function findDescendantAttr(node, name, attr) {
+    for (const child of node.children) {
+        if (!isElement(child))
+            continue;
+        if (child.name === name) {
+            const value = child.attrs[attr];
+            if (typeof value === 'string')
+                return value;
+        }
+        const found = findDescendantAttr(child, name, attr);
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+/** Render one `ac:structured-macro` to a Markdown block. */
+function renderMacro(node) {
+    const name = node.attrs['ac:name'] ?? 'macro';
+    const parameter = (parameterName) => {
+        for (const child of node.children) {
+            if (isElement(child) && child.name === 'ac:parameter' && child.attrs['ac:name'] === parameterName) {
+                return textContent(child.children).trim();
+            }
+        }
+        return undefined;
+    };
+    // Code macros are the ones the model actually needs verbatim.
+    if (name === 'code') {
+        const language = parameter('language') ?? parameter('syntaxhighlighter-parameter') ?? '';
+        const bodyElement = node.children.find(child => isElement(child) && child.name === 'ac:plain-text-body');
+        const body = bodyElement === undefined || !isElement(bodyElement) ? '' : textContent(bodyElement.children).replace(/\n$/u, '');
+        if (body.trim().length === 0)
+            return '';
+        return '```' + language + '\n' + body + '\n```';
+    }
+    if (name === 'noformat') {
+        const bodyElement = node.children.find(child => isElement(child) && child.name === 'ac:plain-text-body');
+        const body = bodyElement === undefined || !isElement(bodyElement) ? '' : textContent(bodyElement.children).replace(/\n$/u, '');
+        if (body.trim().length === 0)
+            return '';
+        return '```\n' + body + '\n```';
+    }
+    if (name === 'panel' || name === 'info' || name === 'note' || name === 'warning' || name === 'tip') {
+        const inner = renderBlocks(node.children).join('\n\n');
+        return inner.length === 0 ? '' : inner.split('\n').map(line => `> ${line}`).join('\n');
+    }
+    if (name === 'expand') {
+        const title = parameter('title');
+        const inner = renderBlocks(node.children).join('\n\n');
+        const header = title !== undefined && title.length > 0 ? `**${title}**` : '';
+        return [header, inner].filter(part => part.length > 0).join('\n\n');
+    }
+    if (name === 'toc' || name === 'toc-zone' || name === 'recently-updated' || name === 'children' || name === 'page-tree') {
+        return '';
+    }
+    // Every other macro: keep a visible placeholder so the model knows
+    // structured content existed here instead of silently dropping it.
+    const inline = renderInline(node.children).trim();
+    return `_[macro: ${name}${inline.length > 0 ? ` — ${inline}` : ''}]_`;
+}
+function renderList(node, ordered, depth) {
+    const out = [];
+    let index = 0;
+    for (const child of node.children) {
+        if (!isElement(child) || child.name !== 'li')
+            continue;
+        index += 1;
+        const marker = ordered === 0 ? '-' : `${ordered + index - 1}.`;
+        const inline = [];
+        const nested = [];
+        for (const part of child.children) {
+            if (!isElement(part)) {
+                const text = collapseWhitespace(part.value).trim();
+                if (text.length > 0)
+                    inline.push(text);
+                continue;
+            }
+            if (INLINE_ELEMENTS.has(part.name) || part.name === 'p')
+                inline.push(renderInlineElement(part));
+            else if (part.name === 'ul' || part.name === 'ol')
+                nested.push(...renderList(part, part.name === 'ol' ? 1 : 0, depth + 1));
+            else
+                nested.push(...renderBlockElement(part));
+        }
+        const text = inline.join('').trim();
+        out.push(`${'  '.repeat(depth)}${marker} ${text}`);
+        out.push(...nested);
+    }
+    return out;
+}
+function renderTable(node) {
+    const rows = [];
+    for (const child of node.children) {
+        if (!isElement(child) || child.name !== 'tr') {
+            if (isElement(child) && (child.name === 'thead' || child.name === 'tbody' || child.name === 'tfoot')) {
+                for (const row of child.children) {
+                    if (isElement(row) && row.name === 'tr')
+                        rows.push(rowCells(row));
+                }
+            }
+            continue;
+        }
+        rows.push(rowCells(child));
+    }
+    if (rows.length === 0)
+        return [];
+    const width = Math.max(...rows.map(row => row.length), 1);
+    const emit = (cells) => `| ${Array.from({ length: width }, (_, index) => (cells[index] ?? '').trim()).join(' | ')} |`;
+    const out = [emit(rows[0] ?? []), `| ${Array.from({ length: width }, () => '---').join(' | ')} |`];
+    for (const row of rows.slice(1))
+        out.push(emit(row));
+    return out;
+}
+function rowCells(row) {
+    const cells = [];
+    for (const child of row.children) {
+        if (isElement(child) && (child.name === 'td' || child.name === 'th'))
+            cells.push(child);
+    }
+    return cells.map(cell => {
+        const blocks = renderBlocks(cell.children);
+        return blocks.join(' ').replace(/\|/gu, '\\|').trim();
+    });
+}
+/** Render any inline run of nodes to text (paragraph bodies, headings). */
+function renderInline(nodes) {
+    let out = '';
+    for (const node of nodes) {
+        if (isText(node)) {
+            out += node.value;
+            continue;
+        }
+        if (INLINE_ELEMENTS.has(node.name)) {
+            out += renderInlineElement(node);
+            continue;
+        }
+        out += renderInline(node.children);
+    }
+    return out;
+}
+function collapseWhitespace(text) {
+    return text.replace(/[ \t\r\n]+/gu, ' ');
+}
+//# sourceMappingURL=confluence.js.map

package/lib/adapters/confluence.js.map

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

package/lib/adapters/index.js

@@ -0,0 +1,65 @@
+/**
+ * Content adapter application seam (SPEC §15.2/§16): one entry point the
+ * provider and the tester call after a rule matched. An adapter rewrites the
+ * recognized URL to the product's REST API and fetches it through the SAME
+ * `authenticatedFetch` transport — network policy, DNS pinning, credentials,
+ * redirects, and byte/char limits all apply to the REST hop unchanged; only
+ * the presentation differs. An adapter that cannot map the URL falls through
+ * (`undefined`), leaving the raw HTTP/HTML behavior untouched.
+ * @module adapters
+ */
+import { authenticatedFetch } from '../transport/fetch.js';
+import * as errors from '../errors.js';
+import { fetchIssueMarkdown } from './jira.js';
+import { fetchPageMarkdown } from './confluence.js';
+/**
+ * Apply the rule's content adapter to a validated request URL. Returns the
+ * normalized result, or `undefined` when the rule has no adapter or the URL
+ * is not one the adapter recognizes (callers fall through to raw transport).
+ */
+export async function applyAdapter(url, context, fetchImpl = (restUrl, restContext) => authenticatedFetch({ url: restUrl, ...restContext })) {
+    const adapter = context.rule.adapter;
+    if (adapter.type === 'none')
+        return undefined;
+    if (!adapterApplies(adapter, url))
+        return undefined;
+    const fetchJson = async (restUrl) => {
+        const result = await fetchImpl(restUrl, context);
+        if (!isJsonBody(result.body.kind)) {
+            throw errors.adapterFailed(`the REST endpoint ${restUrl.pathname} did not return JSON (content was ${result.body.kind})`);
+        }
+        try {
+            return { statusCode: result.statusCode, data: JSON.parse(result.body.content) };
+        }
+        catch (cause) {
+            throw errors.adapterFailed(`the REST endpoint ${restUrl.pathname} returned malformed JSON`, cause);
+        }
+    };
+    const { statusCode, markdown } = adapter.type === 'jira'
+        ? await fetchIssueMarkdown(url, adapter, fetchJson)
+        : await fetchPageMarkdown(url, adapter, fetchJson);
+    // The REST hop already passed through the transport's byte cap; cap the
+    // generated text by the same char limit so a huge issue stays bounded.
+    const maxChars = context.rule.limits.maxBodyChars;
+    const truncated = markdown.length > maxChars;
+    const content = truncated ? markdown.slice(0, maxChars) : markdown;
+    return {
+        url: url.toString(),
+        statusCode,
+        body: { kind: 'text', content },
+        truncated,
+    };
+}
+/** Whether the adapter recognizes this URL shape (unrecognized → fall through). */
+function adapterApplies(adapter, url) {
+    if (adapter.type === 'jira') {
+        // Jira: /browse/<KEY> at any deployment depth and /issues/<KEY>.
+        return /(?:^|\/)(?:browse|issues)\/[A-Z][A-Z0-9]*-\d+$/iu.test(url.pathname);
+    }
+    // Confluence: any `/pages/<digits>/...` or `/display/<SPACE>/<title>` path.
+    return /(?:^|\/)(?:pages\/\d+|display\/[^/]+\/\S)/iu.test(url.pathname);
+}
+function isJsonBody(kind) {
+    return kind === 'text';
+}
+//# sourceMappingURL=index.js.map

package/lib/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAcnD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAQ,EAAE,OAA8B,EAAE,SAAS,GAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;IACrL,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAA;IACpC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7C,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IAEnD,MAAM,SAAS,GAAG,KAAK,EAAE,OAAY,EAAkD,EAAE;QACvF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAChD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,CAAC,aAAa,CAAC,qBAAqB,OAAO,CAAC,QAAQ,qCAAqC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;QAC3H,CAAC;QACD,IAAI,CAAC;YACH,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAY,EAAE,CAAA;QAC5F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,aAAa,CAAC,qBAAqB,OAAO,CAAC,QAAQ,0BAA0B,EAAE,KAAK,CAAC,CAAA;QACpG,CAAC;IACH,CAAC,CAAA;IAED,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,KAAK,MAAM;QACtD,CAAC,CAAC,MAAM,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC;QACnD,CAAC,CAAC,MAAM,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IAEpD,wEAAwE;IACxE,uEAAuE;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAA;IACjD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAA;IAC5C,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;IAClE,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;QACnB,UAAU;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAC/B,SAAS;KACV,CAAA;AACH,CAAC;AAED,mFAAmF;AACnF,SAAS,cAAc,CAAC,OAAwB,EAAE,GAAQ;IACxD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,iEAAiE;QACjE,OAAO,kDAAkD,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC9E,CAAC;IACD,4EAA4E;IAC5E,OAAO,6CAA6C,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AACzE,CAAC;AAED,SAAS,UAAU,CAAC,IAAqB;IACvC,OAAO,IAAI,KAAK,MAAM,CAAA;AACxB,CAAC"}