opencode-gitlab-plugin 3.0.1 → 3.1.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.1.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v3.0.1...v3.1.0) (2026-10-13)
+
+
+### ✨ Features
+
+* **orbit:** derive neighbors default rel_types from the schema ([567a114](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/567a114be061e6fc5e6d59984c497f8621a9a582))
+
 ## [3.0.1](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v3.0.0...v3.0.1) (2026-10-06)
 
 

package/dist/index.js

@@ -5450,6 +5450,65 @@ Examples:
 // src/tools/orbit.ts
 import { tool as tool18 } from "@opencode-ai/plugin";
 var z18 = tool18.schema;
+var MAX_REL_TYPES = 10;
+var SCHEMA_CACHE_TTL_MS = 10 * 60 * 1e3;
+var schemaCache = /* @__PURE__ */ new Map();
+var schemaInflight = /* @__PURE__ */ new Map();
+async function loadOrbitSchema(client) {
+  const key = process.env["GITLAB_INSTANCE_URL"] || "https://gitlab.com";
+  const cached = schemaCache.get(key);
+  if (cached && cached.expiresAt > Date.now()) {
+    return cached.schema;
+  }
+  const inflight = schemaInflight.get(key);
+  if (inflight) {
+    return inflight;
+  }
+  const request = (async () => {
+    try {
+      const schema = await client.fetch("GET", "/orbit/schema");
+      if (!schema || !Array.isArray(schema.edges)) {
+        return void 0;
+      }
+      schemaCache.set(key, { schema, expiresAt: Date.now() + SCHEMA_CACHE_TTL_MS });
+      return schema;
+    } catch {
+      return void 0;
+    }
+  })();
+  schemaInflight.set(key, request);
+  void request.finally(() => {
+    if (schemaInflight.get(key) === request) {
+      schemaInflight.delete(key);
+    }
+  });
+  return request;
+}
+function deriveRelTypes(schema, entityType, preferred) {
+  const touching = /* @__PURE__ */ new Set();
+  for (const edge of schema.edges ?? []) {
+    const touchesEntity = (edge.variants ?? []).some(
+      (variant) => variant.source_type === entityType || variant.target_type === entityType
+    );
+    if (touchesEntity) {
+      touching.add(edge.name);
+    }
+  }
+  const rank = (name) => {
+    const index = preferred.indexOf(name);
+    return index === -1 ? preferred.length : index;
+  };
+  return [...touching].sort((a, b) => rank(a) - rank(b) || a.localeCompare(b)).slice(0, MAX_REL_TYPES);
+}
+async function defaultRelTypes(client, entityType) {
+  const fallback = orbitRelTypes(entityType);
+  const schema = await loadOrbitSchema(client);
+  if (!schema) {
+    return fallback;
+  }
+  const derived = deriveRelTypes(schema, entityType, fallback);
+  return derived.length > 0 ? derived : fallback;
+}
 function orbitRelTypes(entityType) {
   switch (entityType) {
     case "MergeRequest":
@@ -5786,15 +5845,15 @@ then use that ID (e.g., 377844873). For epics, use the work_item_id.`,
       ),
       direction: z18.enum(["incoming", "outgoing", "both"]).optional().describe("Direction of relationships to traverse (default: both)"),
       rel_types: z18.array(z18.string()).optional().describe(
-        'Relationship types to follow. Required by the API to bound the lookup; if omitted, a sensible default set for the entity type is used. The API caps this at 10 per selector, so more than 10 entries are truncated to the first 10 and the response includes a "warnings" field. See gitlab_orbit_schema for valid edge types.'
+        'Relationship types to follow. Required by the API to bound the lookup; if omitted, up to 10 edge types that touch the entity type are taken from gitlab_orbit_schema (with a built-in default set as fallback if the schema is unavailable). The API caps this at 10 per selector, so more than 10 entries are truncated to the first 10 and the response includes a "warnings" field. See gitlab_orbit_schema for valid edge types.'
       ),
       limit: z18.number().optional().describe("Maximum number of neighbors to return (default: 30)")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
       const direction = args.direction || "both";
-      const requestedRelTypes = args.rel_types?.length ? args.rel_types : orbitRelTypes(args.entity_type);
-      const relTypes = requestedRelTypes.slice(0, 10);
+      const requestedRelTypes = args.rel_types?.length ? args.rel_types : await defaultRelTypes(client, args.entity_type);
+      const relTypes = requestedRelTypes.slice(0, MAX_REL_TYPES);
       const warnings = requestedRelTypes.length > relTypes.length ? [`rel_types truncated to 10 (got ${requestedRelTypes.length})`] : [];
       const queryObj = {
         query_type: "neighbors",