@taiga-ai/mcp-server 0.25.0-dev.465 → 0.25.0-dev.466

package/dist/index.js

@@ -670,6 +670,29 @@ const POLICY_TYPE_BY_CONTROL_PREFIX = {
 	SCS: "policy_supply_chain",
 	CLD: "policy_cloud_governance"
 };
+/** The policy document a control id belongs to, or undefined for an unknown prefix. */
+function policyTypeForControl(controlId) {
+	return POLICY_TYPE_BY_CONTROL_PREFIX[controlId.split("-")[0] ?? ""];
+}
+/**
+* The policy a control id points a reader to (PRO-2809): its rightmost base
+* prefix. An overlay family names its host policy last: TEL-TIC-1.1 is a
+* telecom control in policy_tic, HC-FI-DATA-1.1 a Finnish healthcare control in
+* policy_data, ARC-AWS-5 an AWS preset in policy_architecture. A regulatory
+* family with no base prefix (GDPR, NIS2, AIACT) spans several policies and
+* names none.
+*
+* For saying where to read a control, not for deciding who holds it:
+* {@link policyTypeForControl} keeps an overlay control with the document it is
+* written in, whatever its id says.
+*/
+function policyNamedByControl(controlId) {
+	const prefixes = controlId.split("-").filter((part) => /^[A-Z]/.test(part));
+	for (let at = prefixes.length - 1; at >= 0; at -= 1) {
+		const owner = POLICY_TYPE_BY_CONTROL_PREFIX[prefixes[at]];
+		if (owner) return owner;
+	}
+}
 /**
 * The shape of a control id in a policy's control table: `SEC-3.4`, and the
 * overlay families too (`TEL-TIC-1.1`, `HC-FI-DATA-1.1`, `GDPR-1.1`). One
@@ -2663,17 +2686,6 @@ const sectionsInput = z.array(z.string().min(1).max(200)).max(50).optional().des
 /** The sections input of a company document, where a policy control id also names the sections that state it. */
 const policySectionsInput = sectionsInput.describe("Only these sections, by id, or a policy control id (SEC-5.1) for the sections that state it; [] for the outline (under outline: every section id and its size, no text); omit for the whole document");
 /**
-* The policy that states a control: the rightmost policy prefix in its id, so an overlay family's
-* TEL-TIC-1.1 is policy_tic and HC-FI-DATA-1.1 policy_data, as the overlays file them.
-*/
-function policyOfControl(id) {
-	const prefixes = id.split("-").filter((part) => /^[A-Z]/.test(part));
-	for (const prefix of prefixes.reverse()) {
-		const policy = POLICY_TYPE_BY_CONTROL_PREFIX[prefix];
-		if (policy) return policy;
-	}
-}
-/**
 * The sections that state each control id asked for (PRO-2800): policy
 * standing cites SEC-5.1, and the section holding it has an id of its own
 * (secretsManagement) an agent could only guess. A control id is found in
@@ -2699,7 +2711,7 @@ function withControls(outline, sections, policyType) {
 	return outline.map((entry) => {
 		const text = sectionContent(sections, entry.id) ?? "";
 		const ids = [...new Set([...text.matchAll(pattern)].filter((match) => !/^_?Reserved_?/i.test(match[2] ?? "")).map((match) => match[1]).filter((id) => {
-			const owner = POLICY_TYPE_BY_CONTROL_PREFIX[id.split("-")[0] ?? ""];
+			const owner = policyTypeForControl(id);
 			return owner === void 0 || owner === policyType;
 		}))];
 		return ids.length > 0 ? {
@@ -2727,7 +2739,7 @@ function sectionReadResult(doc, asked, label, options = {}) {
 	const known = ids.filter((id) => all.includes(id));
 	const found = Object.keys(controls).length > 0 ? { controls } : {};
 	const asControl = options.controlIds ? void 0 : unknownSections.find((id) => isControlId(id));
-	const policy = asControl ? policyOfControl(asControl) : void 0;
+	const policy = asControl ? policyNamedByControl(asControl) : void 0;
 	const controlNote = asControl ? { note: policy ? `${asControl} is a control of ${policy}: read it with taiga_get_document (type: ${policy}, sections: ["${asControl}"]).` : `${asControl} looks like a policy control id, which only a policy resolves: taiga_get_document without type lists them.` } : {};
 	if (known.length === 0) {
 		const { data: _data, ...meta } = cut.doc;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taiga-ai/mcp-server",
-  "version": "0.25.0-dev.465",
+  "version": "0.25.0-dev.466",
   "description": "MCP server for Taiga -- gives AI assistants access to documents and products",
   "type": "module",
   "main": "./dist/index.js",

package/src/tools/sections.ts

@@ -13,7 +13,7 @@
 
 import type { CallToolResult } from '@modelcontextprotocol/server';
 import { z } from 'zod';
-import { CONTROL_ID_SOURCE, isControlId, POLICY_TYPE_BY_CONTROL_PREFIX } from '@taiga/types';
+import { CONTROL_ID_SOURCE, isControlId, policyNamedByControl, policyTypeForControl } from '@taiga/types';
 import { toolError, toolResult } from './errors.js';
 
 /** A document's section map, keyed by section id: each value a `StoredSection` or (older rows) a bare string. */
@@ -177,19 +177,6 @@ export const policySectionsInput = sectionsInput.describe(
   'Only these sections, by id, or a policy control id (SEC-5.1) for the sections that state it; [] for the outline (under outline: every section id and its size, no text); omit for the whole document'
 );
 
-/**
- * The policy that states a control: the rightmost policy prefix in its id, so an overlay family's
- * TEL-TIC-1.1 is policy_tic and HC-FI-DATA-1.1 policy_data, as the overlays file them.
- */
-function policyOfControl(id: string): string | undefined {
-  const prefixes = id.split('-').filter((part) => /^[A-Z]/.test(part));
-  for (const prefix of prefixes.reverse()) {
-    const policy = POLICY_TYPE_BY_CONTROL_PREFIX[prefix];
-    if (policy) return policy;
-  }
-  return undefined;
-}
-
 /**
  * The sections that state each control id asked for (PRO-2800): policy
  * standing cites SEC-5.1, and the section holding it has an id of its own
@@ -231,7 +218,7 @@ function withControls(outline: { id: string; characters: number }[], sections: S
           // A base control belongs to the policy its prefix names: an SEC row in the data policy is a stale mention,
           // as heldControlMap reads it. An overlay prefix stays where it is written.
           .filter((id) => {
-            const owner = POLICY_TYPE_BY_CONTROL_PREFIX[id.split('-')[0] ?? ''];
+            const owner = policyTypeForControl(id);
             return owner === undefined || owner === policyType;
           })
       ),
@@ -267,7 +254,7 @@ export function sectionReadResult(
   const found = Object.keys(controls).length > 0 ? { controls } : {};
   // A control id asked of a document that does not state controls: name the policy that does.
   const asControl = options.controlIds ? undefined : unknownSections.find((id) => isControlId(id));
-  const policy = asControl ? policyOfControl(asControl) : undefined;
+  const policy = asControl ? policyNamedByControl(asControl) : undefined;
   const controlNote = asControl
     ? {
         note: policy