@cyanheads/eur-lex-mcp-server 0.4.0 → 0.4.2

package/dist/services/cellar-sparql/relation-traversal.js

@@ -0,0 +1,103 @@
+/**
+ * @fileoverview Shared CELLAR CDM relation traversal, used by the
+ * eurlex_get_relations tool and the eurlex://document/{celex}/relations
+ * resource. Owns the relation-type → CDM predicate + direction model so both
+ * surfaces resolve relations identically.
+ * @module services/cellar-sparql/relation-traversal
+ */
+import { CellarSparqlService } from './cellar-sparql-service.js';
+/** The relation types this server exposes over the CDM graph. */
+export const RELATION_TYPES = [
+    'cites',
+    'amends',
+    'amended_by',
+    'legal_basis',
+    'consolidated_version',
+];
+/**
+ * Per-relation-type CDM traversal spec: the predicate to follow and the
+ * direction(s) relative to the source work.
+ *
+ * CELLAR models amendment and consolidation one-directionally, so two types are
+ * the INCOMING side of a predicate whose name reads the other way — the
+ * dedicated `…amended_by…` and `…has_consolidated_version…` predicates carry
+ * zero triples:
+ *  - `amended_by` is the incoming side of `…amends…` (`?amender amends <work>`).
+ *  - `consolidated_version` is the incoming side of
+ *    `…act_consolidated_consolidates…` (the consolidated act points back to the
+ *    base; there is no forward `…has_consolidated_version…` link).
+ *
+ * `amends` and `legal_basis` are outgoing-only — their incoming rows describe a
+ * different relation (what amends this / what is based on this) and belong under
+ * `amended_by` and another work's `legal_basis`, not here. `cites` is symmetric
+ * ("citation graph"), so both directions are surfaced and tagged via `?direction`.
+ */
+const RELATION_SPECS = {
+    cites: { predicate: 'cdm:work_cites_work', direction: 'both' },
+    amends: { predicate: 'cdm:resource_legal_amends_resource_legal', direction: 'outgoing' },
+    amended_by: { predicate: 'cdm:resource_legal_amends_resource_legal', direction: 'incoming' },
+    legal_basis: { predicate: 'cdm:resource_legal_based_on_resource_legal', direction: 'outgoing' },
+    consolidated_version: {
+        predicate: 'cdm:act_consolidated_consolidates_resource_legal',
+        direction: 'incoming',
+    },
+};
+/**
+ * Default per-type result cap. Each relation type is queried independently with
+ * its own LIMIT so a high-volume type (e.g. `cites`) can't starve rarer types
+ * under a single shared cap. The service caps further if MAX_SPARQL_RESULTS is
+ * lower than this.
+ */
+export const DEFAULT_PER_TYPE_LIMIT = 100;
+/** Build a single-relation-type SPARQL query for the given predicate + direction. */
+function buildRelationQuery(workUri, spec, limit) {
+    const outgoing = `{
+    <${workUri}> ${spec.predicate} ?relatedWork .
+    OPTIONAL { ?relatedWork cdm:resource_legal_id_celex ?relatedCelex . }
+    BIND("outgoing" AS ?direction)
+  }`;
+    const incoming = `{
+    ?relatedWork ${spec.predicate} <${workUri}> .
+    OPTIONAL { ?relatedWork cdm:resource_legal_id_celex ?relatedCelex . }
+    BIND("incoming" AS ?direction)
+  }`;
+    const body = spec.direction === 'outgoing'
+        ? outgoing
+        : spec.direction === 'incoming'
+            ? incoming
+            : `${outgoing} UNION ${incoming}`;
+    return `SELECT ?relatedWork ?relatedCelex ?direction WHERE {
+${body}
+} LIMIT ${limit}`;
+}
+/**
+ * Traverse the requested CDM relation types for a work — one query per type, run
+ * concurrently — and return de-duplicated relations tagged with their type and
+ * direction. Each type is resolved through its own query (and its own LIMIT) so
+ * the per-type caps are independent.
+ */
+export async function traverseRelations(svc, workUri, types, ctx, perTypeLimit = DEFAULT_PER_TYPE_LIMIT) {
+    const perType = await Promise.all(types.map(async (type) => ({
+        type,
+        bindings: await svc.query(buildRelationQuery(workUri, RELATION_SPECS[type], perTypeLimit), ctx),
+    })));
+    const seen = new Set();
+    const relations = [];
+    for (const { type, bindings } of perType) {
+        for (const b of bindings) {
+            const relatedWorkUri = CellarSparqlService.bindingValue(b, 'relatedWork') ?? '';
+            const direction = CellarSparqlService.bindingValue(b, 'direction') === 'incoming' ? 'incoming' : 'outgoing';
+            const key = `${type}|${direction}|${relatedWorkUri}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            const relation = { relationType: type, direction, relatedWorkUri };
+            const relatedCelex = CellarSparqlService.bindingValue(b, 'relatedCelex');
+            if (relatedCelex)
+                relation.relatedCelexNumber = relatedCelex;
+            relations.push(relation);
+        }
+    }
+    return relations;
+}
+//# sourceMappingURL=relation-traversal.js.map

package/dist/services/cellar-sparql/relation-traversal.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/eur-lex-mcp-server",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "mcpName": "io.github.cyanheads/eur-lex-mcp-server",
   "description": "Search EU legislation, CJEU case law, and treaties; traverse the CELLAR relationship graph; resolve EuroVoc concepts via MCP. STDIO or Streamable HTTP.",
   "type": "module",

package/server.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/cyanheads/eur-lex-mcp-server",
     "source": "github"
   },
-  "version": "0.4.0",
+  "version": "0.4.2",
   "remotes": [
     {
       "type": "streamable-http",
@@ -19,7 +19,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/eur-lex-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.4.0",
+      "version": "0.4.2",
       "packageArguments": [
         {
           "type": "positional",
@@ -76,7 +76,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/eur-lex-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.4.0",
+      "version": "0.4.2",
       "packageArguments": [
         {
           "type": "positional",