@redaksjon/protokoll 1.0.31-dev.20260317224752.adeddfd → 1.0.31-dev.20260320152728.3166fe3

package/dist/engineLogging.js

@@ -208,7 +208,7 @@ function isProtokolUri(uri) {
   return uri.startsWith(`${SCHEME}://`);
 }
 
-const VERSION = "1.0.31-dev.20260317224752.adeddfd (working/adeddfd  2026-03-17 15:46:49 -0700) linux arm64 v24.14.0";
+const VERSION = "1.0.31-dev.20260320152728.3166fe3 (working/3166fe3  2026-03-20 08:26:22 -0700) linux arm64 v24.14.0";
 const PROGRAM_NAME = "protokoll";
 const DATE_FORMAT_YEAR_MONTH_DAY_HOURS_MINUTES_SECONDS = "YYYY-M-D-HHmmss";
 const DEFAULT_AUDIO_EXTENSIONS = ["mp3", "mp4", "mpeg", "mpga", "m4a", "wav", "webm", "qta"];
@@ -2961,7 +2961,47 @@ async function readTranscriptsListResource(options) {
   };
 }
 
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function resolveCanonicalEntityId$1(id) {
+  const t = id.trim();
+  const colon = t.indexOf(":");
+  if (colon === -1) {
+    return t;
+  }
+  const rest = t.slice(colon + 1).trim();
+  if (UUID_RE.test(rest)) {
+    return rest;
+  }
+  return t;
+}
+function entityIdLookupOrder(id) {
+  const t = id.trim();
+  const canon = resolveCanonicalEntityId$1(t);
+  return canon === t ? [t] : [t, canon];
+}
+
 const logger$5 = Logging.getLogger("@redaksjon/protokoll-mcp").get("entity-resources");
+const PROJECT_PLAN_ARRAY_KEYS$1 = ["related_plans", "plans", "riotplan_plans"];
+function stripProjectPlanArraysForResource(entity) {
+  const base = entity && typeof entity === "object" && !Array.isArray(entity) ? { ...entity } : {};
+  let totalRows = 0;
+  for (const k of PROJECT_PLAN_ARRAY_KEYS$1) {
+    const v = base[k];
+    if (Array.isArray(v)) {
+      totalRows += v.length;
+    }
+  }
+  for (const k of PROJECT_PLAN_ARRAY_KEYS$1) {
+    const v = base[k];
+    if (Array.isArray(v) && v.length > 0) {
+      delete base[k];
+    }
+  }
+  if (totalRows > 0) {
+    base.related_plans_total = totalRows;
+  }
+  return base;
+}
 const ENTITY_DIRECTORY = {
   person: "people",
   project: "projects",
@@ -2973,14 +3013,18 @@ async function readEntityResource(entityType, entityId, contextDirectory) {
   if (entityType in ENTITY_DIRECTORY && isInitialized()) {
     const storageConfig = getStorageConfig();
     if (storageConfig.backend === "gcs") {
-      const gcsEntity = await findContextEntityInGcs(entityType, entityId);
-      if (gcsEntity) {
-        const yamlContent2 = yaml.dump(gcsEntity);
-        return {
-          uri: buildEntityUri(entityType, entityId),
-          mimeType: "application/yaml",
-          text: yamlContent2
-        };
+      for (const tryId of entityIdLookupOrder(entityId)) {
+        const gcsEntity = await findContextEntityInGcs(entityType, tryId);
+        if (gcsEntity) {
+          const idForUri = typeof gcsEntity.id === "string" ? String(gcsEntity.id).trim() : tryId;
+          const toDump = entityType === "project" ? stripProjectPlanArraysForResource(gcsEntity) : gcsEntity;
+          const yamlContent2 = yaml.dump(toDump);
+          return {
+            uri: buildEntityUri(entityType, idForUri),
+            mimeType: "application/yaml",
+            text: yamlContent2
+          };
+        }
       }
     }
   }
@@ -3009,41 +3053,49 @@ async function readEntityResource(entityType, entityId, contextDirectory) {
     });
     throw new Error(`No Protokoll context found. Expected .protokoll/ or context dirs in ${searchDir}`);
   }
-  const lookupEntity = (candidate) => {
+  const lookupEntityById = (candidate, forId) => {
     switch (entityType) {
       case "person":
-        return candidate.getPerson(entityId);
+        return candidate.getPerson(forId);
       case "project":
-        return candidate.getProject(entityId);
+        return candidate.getProject(forId);
       case "term":
-        return candidate.getTerm(entityId);
+        return candidate.getTerm(forId);
       case "company":
-        return candidate.getCompany(entityId);
+        return candidate.getCompany(forId);
       case "ignored":
-        return candidate.getIgnored(entityId);
+        return candidate.getIgnored(forId);
       default:
         throw new Error(`Unknown entity type: ${entityType}`);
     }
   };
-  let entity = lookupEntity(context);
-  if (!entity && isInitialized()) {
-    const serverContext = getContext();
+  const serverContext = isInitialized() ? getContext() : void 0;
+  if (serverContext?.hasContext() && serverContext !== context) {
+    try {
+      await serverContext.reload();
+    } catch (error) {
+      logger$5.debug("entity.read.server_context_reload_failed", {
+        entityType,
+        entityId,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  let entity;
+  for (const tryId of entityIdLookupOrder(entityId)) {
+    entity = lookupEntityById(context, tryId);
+    if (entity) {
+      break;
+    }
     if (serverContext?.hasContext() && serverContext !== context) {
-      try {
-        await serverContext.reload();
-      } catch (error) {
-        logger$5.debug("entity.read.server_context_reload_failed", {
-          entityType,
-          entityId,
-          error: error instanceof Error ? error.message : String(error)
-        });
-      }
-      entity = lookupEntity(serverContext);
+      entity = lookupEntityById(serverContext, tryId);
       if (entity) {
         logger$5.info("entity.read.server_context_fallback_hit", {
           entityType,
-          entityId
+          entityId,
+          tryId
         });
+        break;
       }
     }
   }
@@ -3056,13 +3108,16 @@ async function readEntityResource(entityType, entityId, contextDirectory) {
     });
     throw new Error(`${entityType} "${entityId}" not found`);
   }
+  const canonicalId = entity.id;
   logger$5.info("entity.read.found", {
     entityType,
-    entityId
+    entityId,
+    canonicalId: canonicalId !== entityId ? canonicalId : void 0
   });
-  const yamlContent = yaml.dump(entity);
+  const payload = entityType === "project" ? stripProjectPlanArraysForResource(entity) : entity;
+  const yamlContent = yaml.dump(payload);
   return {
-    uri: buildEntityUri(entityType, entityId),
+    uri: buildEntityUri(entityType, canonicalId),
     mimeType: "application/yaml",
     text: yamlContent
   };
@@ -4471,7 +4526,10 @@ async function getContextInstance(contextDirectory) {
   return createToolContext(contextDirectory);
 }
 function normalizeProjectId(value) {
-  return typeof value === "string" ? value.trim().toLowerCase() : "";
+  if (typeof value !== "string") {
+    return "";
+  }
+  return resolveCanonicalEntityId$1(value).trim().toLowerCase();
 }
 function createAllowedProjectSet(allowedProjectIds) {
   return new Set(
@@ -4485,6 +4543,25 @@ function isProjectInScope(projectId, allowedProjectIds) {
 function hasScopedProjectReference(projectIds, allowedProjectIds) {
   return (projectIds || []).some((projectId) => isProjectInScope(projectId, allowedProjectIds));
 }
+function dedupeByCanonicalEntityId(items) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const key = resolveCanonicalEntityId$1(item.id).toLowerCase();
+    const arr = groups.get(key) ?? [];
+    arr.push(item);
+    groups.set(key, arr);
+  }
+  const out = [];
+  for (const group of groups.values()) {
+    if (group.length === 1) {
+      out.push(group[0]);
+      continue;
+    }
+    const preferred = group.find((r) => r.id === resolveCanonicalEntityId$1(r.id)) ?? group[0];
+    out.push(preferred);
+  }
+  return out;
+}
 async function loadProjects(context) {
   const projects = context.getAllProjects();
   if (projects.length > 0) {
@@ -4828,7 +4905,7 @@ async function handleContextStatus(args) {
 async function handleListProjects(args) {
   const context = await getContextInstance(args.contextDirectory);
   const scope = await buildProjectScopeState(context, args.allowedProjectIds);
-  let projects = scope?.projects ?? await loadProjects(context);
+  let projects = dedupeByCanonicalEntityId(scope?.projects ?? await loadProjects(context));
   if (!args.includeInactive) {
     projects = projects.filter((p) => p.active !== false);
   }
@@ -4848,7 +4925,7 @@ async function handleListProjects(args) {
     offset,
     count: paginatedProjects.length,
     projects: paginatedProjects.map((p) => ({
-      id: p.id,
+      id: resolveCanonicalEntityId$1(p.id),
       name: p.name,
       active: p.active !== false,
       destination: p.routing?.destination,
@@ -4861,7 +4938,7 @@ async function handleListProjects(args) {
 async function handleListPeople(args) {
   const context = await getContextInstance(args.contextDirectory);
   const scope = await buildProjectScopeState(context, args.allowedProjectIds);
-  let people = await loadPeople(context);
+  let people = dedupeByCanonicalEntityId(await loadPeople(context));
   if (scope) {
     people = people.filter((person) => scope.associatedPeople.has(person.id));
   }
@@ -4881,7 +4958,7 @@ async function handleListPeople(args) {
     offset,
     count: paginatedPeople.length,
     people: paginatedPeople.map((p) => ({
-      id: p.id,
+      id: resolveCanonicalEntityId$1(p.id),
       name: p.name,
       company: p.company,
       role: p.role,
@@ -4892,7 +4969,7 @@ async function handleListPeople(args) {
 async function handleListTerms(args) {
   const context = await getContextInstance(args.contextDirectory);
   const scope = await buildProjectScopeState(context, args.allowedProjectIds);
-  let terms = await loadTerms(context);
+  let terms = dedupeByCanonicalEntityId(await loadTerms(context));
   if (scope) {
     terms = terms.filter((term) => hasScopedProjectReference(term.projects, scope.allowedProjectIds));
   }
@@ -4912,7 +4989,7 @@ async function handleListTerms(args) {
     offset,
     count: paginatedTerms.length,
     terms: paginatedTerms.map((t) => ({
-      id: t.id,
+      id: resolveCanonicalEntityId$1(t.id),
       name: t.name,
       expansion: t.expansion,
       domain: t.domain,
@@ -4923,7 +5000,7 @@ async function handleListTerms(args) {
 async function handleListCompanies(args) {
   const context = await getContextInstance(args.contextDirectory);
   const scope = await buildProjectScopeState(context, args.allowedProjectIds);
-  let companies = await loadCompanies(context);
+  let companies = dedupeByCanonicalEntityId(await loadCompanies(context));
   if (scope) {
     companies = companies.filter((company) => scope.associatedCompanies.has(company.id));
   }
@@ -4943,7 +5020,7 @@ async function handleListCompanies(args) {
     offset,
     count: paginatedCompanies.length,
     companies: paginatedCompanies.map((c) => ({
-      id: c.id,
+      id: resolveCanonicalEntityId$1(c.id),
       name: c.name,
       fullName: c.fullName,
       industry: c.industry,
@@ -4971,28 +5048,29 @@ async function handleSearchContext(args) {
 async function handleGetEntity(args) {
   const context = await getContextInstance(args.contextDirectory);
   const scope = await buildProjectScopeState(context, args.allowedProjectIds);
+  const entityId = resolveCanonicalEntityId$1(args.entityId.trim());
   let entity;
   switch (args.entityType) {
     case "project":
-      entity = findProjectResilient(context, args.entityId);
+      entity = findProjectResilient(context, entityId);
       break;
     case "person":
-      entity = findPersonResilient(context, args.entityId);
+      entity = findPersonResilient(context, entityId);
       break;
     case "term":
-      entity = findTermResilient(context, args.entityId);
+      entity = findTermResilient(context, entityId);
       break;
     case "company":
-      entity = findCompanyResilient(context, args.entityId);
+      entity = findCompanyResilient(context, entityId);
       break;
     case "ignored":
-      entity = findIgnoredResilient(context, args.entityId);
+      entity = findIgnoredResilient(context, entityId);
       break;
     default:
       throw new Error(`Unknown entity type: ${args.entityType}`);
   }
   if (scope && !isEntityVisibleInProjectScope(entity, scope)) {
-    throw new Error(`Project-scoped key cannot access ${args.entityType} "${args.entityId}".`);
+    throw new Error(`Project-scoped key cannot access ${args.entityType} "${entityId}".`);
   }
   const filePath = context.getEntityFilePath(entity);
   return {
@@ -5030,6 +5108,142 @@ async function handlePredictEntities(args) {
   });
   return { success: true, predictions };
 }
+const PROJECT_PLAN_ARRAY_KEYS = ["related_plans", "plans", "riotplan_plans"];
+function humanizePlanSlug(slug) {
+  const trimmed = slug.trim();
+  const withoutPrefix = trimmed.replace(/^[0-9a-f]{8}-/i, "");
+  const words = withoutPrefix.split(/[-_/]+/).filter(Boolean);
+  if (words.length === 0) {
+    return trimmed;
+  }
+  return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join(" ");
+}
+function pickString(obj, keys) {
+  for (const k of keys) {
+    const v = obj[k];
+    if (typeof v === "string" && v.trim().length > 0) {
+      return v.trim();
+    }
+  }
+  return "";
+}
+function pickCreatedMs(obj) {
+  const raw = pickString(obj, ["createdAt", "created_at", "created", "date", "startedAt", "started_at"]);
+  if (!raw) {
+    return NaN;
+  }
+  const t = Date.parse(raw);
+  return Number.isNaN(t) ? NaN : t;
+}
+function normalizePlanRow(raw, index) {
+  if (typeof raw === "string") {
+    const id = raw.trim();
+    return {
+      id: id || `row-${index}`,
+      title: humanizePlanSlug(id),
+      stage: "",
+      createdAt: null,
+      createdMs: NaN
+    };
+  }
+  if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+    const o = raw;
+    const id = pickString(o, ["id", "planId", "plan_id", "folder", "slug", "path", "name"]) || `row-${index}`;
+    const explicitTitle = pickString(o, ["title", "label", "displayName", "planTitle", "summary"]);
+    const title = explicitTitle.length > 0 ? explicitTitle : humanizePlanSlug(
+      pickString(o, ["folder", "slug", "path", "id", "planId", "plan_id"]) || id
+    );
+    const stage = pickString(o, ["stage", "status", "state", "phase", "category"]);
+    const createdRaw = pickString(o, ["createdAt", "created_at", "created", "date", "startedAt"]);
+    const createdMs = pickCreatedMs(o);
+    return {
+      id,
+      title,
+      stage,
+      createdAt: createdRaw || null,
+      createdMs
+    };
+  }
+  return {
+    id: `row-${index}`,
+    title: "",
+    stage: "",
+    createdAt: null,
+    createdMs: NaN
+  };
+}
+function collectPlanRowsFromProjectRecord(record) {
+  const rows = [];
+  for (const k of PROJECT_PLAN_ARRAY_KEYS) {
+    const v = record[k];
+    if (Array.isArray(v)) {
+      rows.push(...v);
+    }
+  }
+  return rows;
+}
+const listProjectPlansTool = {
+  name: "protokoll_list_project_plans",
+  description: "List plans associated with a project entity (from related_plans / plans / riotplan_plans on the project YAML). Supports limit/offset pagination. Used by clients instead of embedding full plan lists in the project resource.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      projectId: {
+        type: "string",
+        description: "Project entity UUID"
+      },
+      limit: {
+        type: "number",
+        description: "Page size (default 25, max 100)"
+      },
+      offset: {
+        type: "number",
+        description: "Number of plans to skip (default 0)"
+      },
+      contextDirectory: {
+        type: "string",
+        description: "Path to the .protokoll context directory"
+      }
+    },
+    required: ["projectId"]
+  }
+};
+async function handleListProjectPlans(args) {
+  const context = await getContextInstance(args.contextDirectory);
+  const scope = await buildProjectScopeState(context, args.allowedProjectIds);
+  const projectId = resolveCanonicalEntityId$1(args.projectId.trim());
+  const entity = findProjectResilient(context, projectId);
+  if (scope && !isEntityVisibleInProjectScope(entity, scope)) {
+    throw new Error(`Project-scoped key cannot access project "${projectId}".`);
+  }
+  const record = entity;
+  const allRows = collectPlanRowsFromProjectRecord(record);
+  const normalized = allRows.map((r, i) => normalizePlanRow(r, i));
+  normalized.sort((a, b) => {
+    const da = Number.isNaN(a.createdMs) ? -Infinity : a.createdMs;
+    const db = Number.isNaN(b.createdMs) ? -Infinity : b.createdMs;
+    if (db !== da) {
+      return db - da;
+    }
+    return a.title.localeCompare(b.title, void 0, { sensitivity: "base" });
+  });
+  const limit = Math.min(100, Math.max(1, args.limit ?? 25));
+  const offset = Math.max(0, args.offset ?? 0);
+  const page = normalized.slice(offset, offset + limit);
+  const plans = page.map((p) => ({
+    id: p.id,
+    title: p.title,
+    stage: p.stage,
+    createdAt: p.createdAt
+  }));
+  return {
+    total: normalized.length,
+    limit,
+    offset,
+    count: plans.length,
+    plans
+  };
+}
 
 function isValidUUID(str) {
   const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -5234,7 +5448,7 @@ const addProjectTool = {
 };
 const editProjectTool = {
   name: "protokoll_edit_project",
-  description: "Edit an existing project with manual modifications. Unlike protokoll_update_project (which regenerates from a source), this allows direct edits: adding specific sounds_like variants, changing routing, modifying classification, managing relationships, etc. For array fields (sounds_like, topics, explicit_phrases, associated_people, associated_companies, children, siblings, related_terms), use add_* to append or remove_* to delete specific values, or use the base field name to replace the entire array.",
+  description: "Edit an existing project with manual modifications. Unlike protokoll_update_project (which regenerates from a source), this allows direct edits: adding specific sounds_like variants, changing routing, modifying classification, managing relationships, etc. For array fields (sounds_like, urls, topics, explicit_phrases, associated_people, associated_companies, children, siblings, related_terms), use add_* to append or remove_* to delete specific values, or use the base field name to replace the entire array.",
   inputSchema: {
     type: "object",
     properties: {
@@ -5283,6 +5497,21 @@ const editProjectTool = {
         items: { type: "string" },
         description: "Remove these sounds_like variants"
       },
+      urls: {
+        type: "array",
+        items: { type: "string" },
+        description: "Replace all project URLs with this list (e.g. org homepage, documentation)"
+      },
+      add_urls: {
+        type: "array",
+        items: { type: "string" },
+        description: "Append these URLs to the project urls list"
+      },
+      remove_urls: {
+        type: "array",
+        items: { type: "string" },
+        description: "Remove these URLs from the project urls list"
+      },
       topics: {
         type: "array",
         items: { type: "string" },
@@ -5823,12 +6052,19 @@ async function handleEditProject(args) {
   const context = await createToolContext(args.contextDirectory);
   await assertContextAvailableForEntityEdit(context);
   const existingProject = findProjectResilient(context, args.id);
+  const existingProjectUrls = existingProject.urls;
   const updatedSoundsLike = mergeArray(
     existingProject.sounds_like,
     args.sounds_like,
     args.add_sounds_like,
     args.remove_sounds_like
   );
+  const updatedUrls = mergeArray(
+    existingProjectUrls,
+    args.urls,
+    args.add_urls,
+    args.remove_urls
+  );
   const updatedTopics = mergeArray(
     existingProject.classification?.topics,
     args.topics,
@@ -5916,6 +6152,11 @@ async function handleEditProject(args) {
   } else if (existingProject.sounds_like && (args.sounds_like !== void 0 || args.remove_sounds_like)) {
     delete updatedProject.sounds_like;
   }
+  if (updatedUrls !== void 0) {
+    updatedProject.urls = updatedUrls;
+  } else if (existingProjectUrls && (args.urls !== void 0 || args.remove_urls)) {
+    delete updatedProject.urls;
+  }
   if (updatedTopics !== void 0) {
     updatedProject.classification.topics = updatedTopics;
   } else if (existingProject.classification?.topics && (args.topics !== void 0 || args.remove_topics)) {
@@ -5964,6 +6205,9 @@ async function handleEditProject(args) {
   if (args.sounds_like !== void 0) changes.push(`sounds_like replaced with ${args.sounds_like.length} items`);
   if (args.add_sounds_like?.length) changes.push(`added ${args.add_sounds_like.length} sounds_like variants`);
   if (args.remove_sounds_like?.length) changes.push(`removed ${args.remove_sounds_like.length} sounds_like variants`);
+  if (args.urls !== void 0) changes.push(`urls replaced with ${args.urls.length} items`);
+  if (args.add_urls?.length) changes.push(`added ${args.add_urls.length} urls`);
+  if (args.remove_urls?.length) changes.push(`removed ${args.remove_urls.length} urls`);
   if (args.topics !== void 0) changes.push(`topics replaced with ${args.topics.length} items`);
   if (args.add_topics?.length) changes.push(`added ${args.add_topics.length} topics`);
   if (args.remove_topics?.length) changes.push(`removed ${args.remove_topics.length} topics`);
@@ -9935,6 +10179,7 @@ const tools = [
   // Context Management
   contextStatusTool,
   listProjectsTool,
+  listProjectPlansTool,
   listPeopleTool,
   listTermsTool,
   listCompaniesTool,
@@ -10019,6 +10264,10 @@ async function handleToolCall(name, args) {
       return handleContextStatus(args);
     case "protokoll_list_projects":
       return handleListProjects(args);
+    case "protokoll_list_project_plans":
+      return handleListProjectPlans(
+        args
+      );
     case "protokoll_list_people":
       return handleListPeople(args);
     case "protokoll_list_terms":