@taiga-ai/mcp-server 0.10.0 → 0.11.0-dev.411

package/src/tools/markdown.ts

@@ -1,3 +1,6 @@
+import { fromMarkdown } from 'mdast-util-from-markdown';
+import { toMarkdown } from 'mdast-util-to-markdown';
+import type { Heading, Node, Parent, PhrasingContent } from 'mdast';
 import { isRecord, sectionContent, sectionsOf } from './sections.js';
 
 /**
@@ -29,7 +32,7 @@ export function renderDocument(doc: Record<string, unknown>): { mimeType: string
   for (const id of Object.keys(sections)) {
     const content = sectionContent(sections, id);
     if (content === null) continue;
-    lines.push('', `## ${sectionTitle(sections[id], id)}`, '', content.trim());
+    lines.push('', `## ${sectionTitle(sections[id], id)}`, '', nestHeadings(content.trim()));
   }
   const { sections: _sections, ...rest } = data;
   const other = Object.fromEntries(Object.entries(rest).filter(([, value]) => !isEmpty(value)));
@@ -57,6 +60,64 @@ const isEmpty = (value: unknown) =>
   (Array.isArray(value) && value.length === 0) ||
   (isRecord(value) && Object.keys(value).length === 0);
 
+/**
+ * A section body's own headings, one level down, so they sit under the
+ * section heading instead of beside it: a derived document writes each
+ * section with its own H2. A CommonMark parser says what is a heading, so
+ * fenced code, indented code, list items and block quotes are read as a
+ * reader's renderer reads them, and a heading-shaped line inside an HTML
+ * block is HTML, not a heading, and stays. Every heading lands at least one
+ * level under the section's H2, so an H1 and an H2 both become H3 and the
+ * rest move one down, H6 at most: an ATX heading (the # kind, an empty one
+ * included) takes the marks it needs; a setext heading (underlined)
+ * becomes the ATX heading of that depth, serialized from its parsed
+ * content (so a quote's prefix, a hard line break or a trailing # run are
+ * handled as Markdown, not as text). The edits go by the parser's
+ * character offsets, so no line counting of ours can disagree with its own.
+ */
+export function nestHeadings(body: string): string {
+  const edits: { start: number; end: number; text: string }[] = [];
+  // An explicit stack, and no spread into push: a body of thousands of
+  // nested quotes, or a list of very many items, must not overflow a walk.
+  const pending: Node[] = [fromMarkdown(body)];
+  while (pending.length > 0) {
+    const node = pending.pop()!;
+    if (
+      node.type === 'heading' &&
+      node.position?.start.offset !== undefined &&
+      node.position.end.offset !== undefined
+    ) {
+      const start = node.position.start.offset;
+      const end = node.position.end.offset;
+      const heading = node as Heading;
+      const target = nestedDepth(heading.depth);
+      const atx = /^#{1,6}(\s|$)/.test(body.slice(start, start + 7));
+      if (atx && target > heading.depth) edits.push({ start, end: start, text: '#'.repeat(target - heading.depth) });
+      else if (!atx) edits.push({ start, end, text: atxOf(target, heading.children) });
+    }
+    if ('children' in node) for (const child of (node as Parent).children) pending.push(child);
+  }
+  let out = body;
+  for (const edit of edits.sort((a, b) => b.start - a.start)) {
+    out = `${out.slice(0, edit.start)}${edit.text}${out.slice(edit.end)}`;
+  }
+  return out;
+}
+
+/** Under the section's H2: at least H3, one level down otherwise, H6 at most. */
+const nestedDepth = (depth: number): Heading['depth'] => Math.min(6, Math.max(3, depth + 1)) as Heading['depth'];
+
+/** An ATX heading of this depth from parsed content, its line breaks turned into spaces: an ATX heading is one line. */
+function atxOf(depth: Heading['depth'], children: PhrasingContent[]): string {
+  const oneLine = (nodes: PhrasingContent[]): PhrasingContent[] =>
+    nodes.map((child) => {
+      if (child.type === 'break') return { type: 'text', value: ' ' };
+      if (child.type === 'text') return { ...child, value: child.value.replace(/\r\n|\r|\n/g, ' ') };
+      return 'children' in child ? { ...child, children: oneLine(child.children as PhrasingContent[]) } : child;
+    });
+  return toMarkdown({ type: 'heading', depth, children: oneLine(children) }).trimEnd();
+}
+
 /** The section's title when it carries one, else its id. */
 function sectionTitle(section: unknown, id: string): string {
   return isRecord(section) && typeof section.title === 'string' && section.title.trim() ? section.title.trim() : id;

package/src/tools/prompts.ts

@@ -263,8 +263,11 @@ export function registerPrompts(server: McpServer, client: TaigaClient) {
 
 /** A part the key's capabilities do not cover; named in its place rather than fetched. */
 class NotGranted extends Error {
-  constructor(readonly capability: string) {
+  readonly capability: string;
+
+  constructor(capability: string) {
     super(`needs ${capability}`);
+    this.capability = capability;
   }
   line(what: string): string {
     return `(${what} need ${this.capability}, which this key lacks.)`;

package/tsconfig.json

@@ -11,6 +11,10 @@
     "resolveJsonModule": true,
     "types": ["node"],
 
+    // @tsconfig/strictest leaves these two out, so every package sets them.
+    "verbatimModuleSyntax": true,
+    "erasableSyntaxOnly": true,
+
     // Preset flags this package still fails (PRO-2509). Each line is deleted
     // by the issue named beside it; no new line is added here.
     "noPropertyAccessFromIndexSignature": false // PRO-2519