@mnemom/agent-alignment-protocol 0.6.0 → 0.6.1

package/dist/index.js

@@ -747,6 +747,13 @@ function hasRoleKeyword(agentId) {
   const lower = agentId.toLowerCase();
   return ROLE_KEYWORDS.some((kw) => lower.includes(kw));
 }
+function getClpiRole(card) {
+  const ext = card.extensions;
+  if (!ext) return null;
+  const clpi = ext["clpi"];
+  if (!clpi || typeof clpi["role"] !== "string") return null;
+  return clpi["role"] || null;
+}
 function analyzeFaultLines(coherenceResult, cards, options) {
   const reputationScores = options?.reputationScores;
   const agentBoundedActions = /* @__PURE__ */ new Map();
@@ -757,6 +764,10 @@ function analyzeFaultLines(coherenceResult, cards, options) {
   for (const { agentId, card } of cards) {
     agentConflictMap.set(agentId, new Set(card.values.conflicts_with ?? []));
   }
+  const agentRoleMap = /* @__PURE__ */ new Map();
+  for (const { agentId, card } of cards) {
+    agentRoleMap.set(agentId, getClpiRole(card));
+  }
   const faultLines = [];
   for (const divergence of coherenceResult.divergence_report) {
     const {
@@ -789,6 +800,13 @@ function analyzeFaultLines(coherenceResult, cards, options) {
     })()) {
       classification = "priority_mismatch";
     } else if (agents_declaring.length >= 1 && agents_missing.length >= 1 && (() => {
+      const declaringRoles = new Set(agents_declaring.map((id2) => agentRoleMap.get(id2) ?? null).filter(Boolean));
+      const missingRoles = new Set(agents_missing.map((id2) => agentRoleMap.get(id2) ?? null).filter(Boolean));
+      if (declaringRoles.size > 0) {
+        const declaringRoleArr = [...declaringRoles];
+        const isRoleExclusive = declaringRoleArr.every((role) => !missingRoles.has(role));
+        if (isRoleExclusive) return true;
+      }
       const allInvolved = [...agents_declaring, ...agents_missing];
       return allInvolved.some((id2) => hasRoleKeyword(id2));
     })()) {

package/dist/index.mjs

@@ -690,6 +690,13 @@ function hasRoleKeyword(agentId) {
   const lower = agentId.toLowerCase();
   return ROLE_KEYWORDS.some((kw) => lower.includes(kw));
 }
+function getClpiRole(card) {
+  const ext = card.extensions;
+  if (!ext) return null;
+  const clpi = ext["clpi"];
+  if (!clpi || typeof clpi["role"] !== "string") return null;
+  return clpi["role"] || null;
+}
 function analyzeFaultLines(coherenceResult, cards, options) {
   const reputationScores = options?.reputationScores;
   const agentBoundedActions = /* @__PURE__ */ new Map();
@@ -700,6 +707,10 @@ function analyzeFaultLines(coherenceResult, cards, options) {
   for (const { agentId, card } of cards) {
     agentConflictMap.set(agentId, new Set(card.values.conflicts_with ?? []));
   }
+  const agentRoleMap = /* @__PURE__ */ new Map();
+  for (const { agentId, card } of cards) {
+    agentRoleMap.set(agentId, getClpiRole(card));
+  }
   const faultLines = [];
   for (const divergence of coherenceResult.divergence_report) {
     const {
@@ -732,6 +743,13 @@ function analyzeFaultLines(coherenceResult, cards, options) {
     })()) {
       classification = "priority_mismatch";
     } else if (agents_declaring.length >= 1 && agents_missing.length >= 1 && (() => {
+      const declaringRoles = new Set(agents_declaring.map((id2) => agentRoleMap.get(id2) ?? null).filter(Boolean));
+      const missingRoles = new Set(agents_missing.map((id2) => agentRoleMap.get(id2) ?? null).filter(Boolean));
+      if (declaringRoles.size > 0) {
+        const declaringRoleArr = [...declaringRoles];
+        const isRoleExclusive = declaringRoleArr.every((role) => !missingRoles.has(role));
+        if (isRoleExclusive) return true;
+      }
       const allInvolved = [...agents_declaring, ...agents_missing];
       return allInvolved.some((id2) => hasRoleKeyword(id2));
     })()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemom/agent-alignment-protocol",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Agent Alignment Protocol (AAP) - Verification and drift detection for AI agents",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -54,4 +54,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}

package/src/verification/api.ts

@@ -788,6 +788,15 @@ function hasRoleKeyword(agentId: string): boolean {
   return ROLE_KEYWORDS.some(kw => lower.includes(kw));
 }
 
+/** Extract the CLPI role from a card's extensions, if present. */
+function getClpiRole(card: AlignmentCard): string | null {
+  const ext = (card as unknown as { extensions?: Record<string, unknown> }).extensions;
+  if (!ext) return null;
+  const clpi = ext['clpi'] as Record<string, unknown> | undefined;
+  if (!clpi || typeof clpi['role'] !== 'string') return null;
+  return clpi['role'] || null;
+}
+
 /**
  * Analyze fault lines in a fleet based on a FleetCoherenceResult.
  *
@@ -815,6 +824,12 @@ export function analyzeFaultLines(
     agentConflictMap.set(agentId, new Set(card.values.conflicts_with ?? []));
   }
 
+  // Build lookup: agentId → CLPI role (from extensions.clpi.role)
+  const agentRoleMap = new Map<string, string | null>();
+  for (const { agentId, card } of cards) {
+    agentRoleMap.set(agentId, getClpiRole(card));
+  }
+
   const faultLines: FaultLine[] = [];
 
   for (const divergence of coherenceResult.divergence_report) {
@@ -863,7 +878,18 @@ export function analyzeFaultLines(
       agents_declaring.length >= 1 &&
       agents_missing.length >= 1 &&
       (() => {
-        // complementary: heuristic — some agent (declaring or missing) has a role keyword
+        // complementary: the declaring agents all share a CLPI role that the missing
+        // agents do NOT share — indicating intentional role specialization, not a gap.
+        // Primary check: extensions.clpi.role (authoritative)
+        const declaringRoles = new Set(agents_declaring.map(id => agentRoleMap.get(id) ?? null).filter(Boolean));
+        const missingRoles = new Set(agents_missing.map(id => agentRoleMap.get(id) ?? null).filter(Boolean));
+        if (declaringRoles.size > 0) {
+          // All declaring agents share a role that none of the missing agents have
+          const declaringRoleArr = [...declaringRoles];
+          const isRoleExclusive = declaringRoleArr.every(role => !missingRoles.has(role));
+          if (isRoleExclusive) return true;
+        }
+        // Fallback: agent ID contains a role keyword (original heuristic)
         const allInvolved = [...agents_declaring, ...agents_missing];
         return allInvolved.some(id => hasRoleKeyword(id));
       })()