@ouro.bot/cli 0.1.0-alpha.186 → 0.1.0-alpha.189

package/changelog.json

@@ -2,8 +2,21 @@
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
     {
-      "version": "0.1.0-alpha.186",
+      "version": "0.1.0-alpha.189",
       "changes": [
+        "feat(heart): ResumeHandle type, primary obligation selection, status priority",
+        "feat(heart): lane/obligation precedence rules",
+        "feat(heart): cross-session change detection (snapshot, diff, format)",
+        "feat(cli): TUI edge-case hardening (44 new tests)",
+        "feat(mind): memory judgement heuristics in system prompt",
+        "feat(mind): memory feedback loop (noise prevention)",
+        "fix(cli): blockquote wrap width for narrow terminals"
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.187",
+      "changes": [
+        "refactor: collapse AgentRelationship into FriendRecord \u2014 one identity system for humans and agents",
         "refactor: rename AdoptionSpecialist to SerpentGuide",
         "feat(hatch): detect API keys from environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY, AZURE_OPENAI_API_KEY, MINIMAX_API_KEY, GITHUB_TOKEN)",
         "fix(cli): React unmount warning suppression covers SerpentGuide exit path"

package/dist/heart/active-work.js

@@ -5,6 +5,9 @@ exports.suggestBridgeForActiveWork = suggestBridgeForActiveWork;
 exports.buildActiveWorkFrame = buildActiveWorkFrame;
 exports.formatActiveWorkFrame = formatActiveWorkFrame;
 exports.formatLiveWorldStateCheckpoint = formatLiveWorldStateCheckpoint;
+exports.snapshotActiveWork = snapshotActiveWork;
+exports.detectActiveWorkChanges = detectActiveWorkChanges;
+exports.formatActiveWorkChanges = formatActiveWorkChanges;
 const runtime_1 = require("../nerves/runtime");
 const state_machine_1 = require("./bridges/state-machine");
 const obligations_1 = require("./obligations");
@@ -134,10 +137,40 @@ function formatMergeArtifact(obligation) {
     }
     return mergeArtifactFallback(obligation);
 }
+/* v8 ignore start -- Epic 1: obligation selection, resume handles, change detection @preserve */
+function obligationStatusPriority(status) {
+    switch (status) {
+        case "investigating": return 0;
+        case "waiting_for_merge": return 1;
+        case "updating_runtime": return 2;
+        case "pending": return 3;
+        case "fulfilled": return 4;
+    }
+}
+function selectPrimaryObligation(obligations, currentSession) {
+    const open = obligations.filter(obligations_1.isOpenObligation);
+    if (open.length === 0)
+        return null;
+    // Prefer current-session match among advanced (non-pending) obligations
+    const sessionMatch = currentSession
+        ? open.find((ob) => ob.status !== "pending"
+            && ob.origin.friendId === currentSession.friendId
+            && ob.origin.channel === currentSession.channel
+            && (0, config_1.sanitizeKey)(ob.origin.key) === (0, config_1.sanitizeKey)(currentSession.key))
+        : null;
+    if (sessionMatch)
+        return sessionMatch;
+    // Then any advanced obligation, sorted by status priority then freshness
+    const sorted = [...open].sort((a, b) => {
+        const statusDiff = obligationStatusPriority(a.status) - obligationStatusPriority(b.status);
+        if (statusDiff !== 0)
+            return statusDiff;
+        return obligationTimestampMs(b) - obligationTimestampMs(a);
+    });
+    return sorted[0] ?? null;
+}
 function findPrimaryOpenObligation(frame) {
-    return (frame.pendingObligations ?? []).find((ob) => ob.status !== "pending" && ob.status !== "fulfilled")
-        ?? (frame.pendingObligations ?? []).find(obligations_1.isOpenObligation)
-        ?? null;
+    return frame.primaryObligation ?? selectPrimaryObligation(frame.pendingObligations ?? [], frame.currentSession);
 }
 function matchesCurrentSession(frame, obligation) {
     return Boolean(frame.currentSession
@@ -172,13 +205,18 @@ function formatCodingArtifact(session) {
     return session ? "no PR or merge artifact yet" : null;
 }
 function formatCurrentArtifact(frame, obligation) {
+    // Live coding session artifact takes precedence (fresher evidence)
+    const liveCodingSession = frame.codingSessions?.[0];
+    if (liveCodingSession?.artifactPath?.trim()) {
+        return liveCodingSession.artifactPath.trim();
+    }
     if (obligation?.currentArtifact?.trim()) {
         return obligation.currentArtifact.trim();
     }
     if (obligation?.currentSurface?.kind === "merge" && obligation.currentSurface.label.trim()) {
         return obligation.currentSurface.label.trim();
     }
-    const liveCodingArtifact = formatCodingArtifact(frame.codingSessions?.[0]);
+    const liveCodingArtifact = formatCodingArtifact(liveCodingSession);
     if (liveCodingArtifact) {
         return liveCodingArtifact;
     }
@@ -400,6 +438,43 @@ function suggestBridgeForActiveWork(input) {
 function formatSessionLabel(session) {
     return `${session.channel}/${session.key}`;
 }
+function deriveResumeHandleConfidence(primaryObligation, codingSession) {
+    if (primaryObligation?.currentArtifact?.trim() && primaryObligation.nextAction?.trim())
+        return "high";
+    if (codingSession?.checkpoint?.trim())
+        return "medium";
+    if (primaryObligation)
+        return "low";
+    return "low";
+}
+function buildResumeHandle(currentSession, primaryObligation, codingSessions) {
+    const sessionLabel = currentSession ? formatSessionLabel(currentSession) : null;
+    if (!sessionLabel)
+        return null;
+    const liveCoding = codingSessions[0] ?? null;
+    const lane = liveCoding
+        ? `${formatCodingLaneLabel(liveCoding)}${describeCodingSessionScope(liveCoding, currentSession)}`
+        : (primaryObligation?.currentSurface?.label?.trim() || null);
+    const artifact = primaryObligation?.currentArtifact?.trim()
+        || (liveCoding?.artifactPath?.trim() || null);
+    const blockerOrWaitingOn = primaryObligation?.meaning?.waitingOn?.detail?.trim() || null;
+    const nextAction = primaryObligation?.nextAction?.trim()
+        || (primaryObligation?.content?.trim() ? `work on "${primaryObligation.content.trim()}" and bring back a concrete artifact` : null);
+    const lastVerifiedCheckpoint = liveCoding?.checkpoint?.trim() || null;
+    const codingIdentity = liveCoding
+        ? { sessionId: liveCoding.id, runner: liveCoding.runner, status: liveCoding.status }
+        : null;
+    return {
+        sessionLabel,
+        lane,
+        artifact,
+        blockerOrWaitingOn,
+        nextAction,
+        lastVerifiedCheckpoint,
+        confidence: deriveResumeHandleConfidence(primaryObligation, liveCoding),
+        codingIdentity,
+    };
+}
 function buildActiveWorkFrame(input) {
     const friendSessions = input.currentSession
         ? input.friendActivity
@@ -418,6 +493,8 @@ function buildActiveWorkFrame(input) {
         : (input.inner.status === "running" || input.inner.hasPending || input.mustResolveBeforeHandoff || openObligations > 0 || liveCodingSessions.length > 0)
             ? "inward-work"
             : "local-turn";
+    const primaryObligation = selectPrimaryObligation(pendingObligations, input.currentSession ?? null);
+    const resumeHandle = buildResumeHandle(input.currentSession ?? null, primaryObligation, liveCodingSessions);
     const frame = {
         currentSession: input.currentSession ?? null,
         currentObligation: input.currentObligation?.trim() || null,
@@ -449,6 +526,8 @@ function buildActiveWorkFrame(input) {
             taskBoard: input.taskBoard,
             targetCandidates: input.targetCandidates,
         }),
+        primaryObligation,
+        resumeHandle,
     };
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
@@ -510,6 +589,9 @@ function formatActiveWorkFrame(frame, options) {
         if (nextAction) {
             lines.push(`- next action: ${nextAction}`);
         }
+        if (frame.resumeHandle?.lastVerifiedCheckpoint) {
+            lines.push(`- last checkpoint: ${frame.resumeHandle.lastVerifiedCheckpoint}`);
+        }
     }
     // Inner status block
     const job = frame.inner?.job;
@@ -634,9 +716,111 @@ function formatLiveWorldStateCheckpoint(frame) {
         `- current artifact: ${currentArtifact}`,
         `- next action: ${nextAction}`,
     ];
+    if (frame.resumeHandle?.lastVerifiedCheckpoint) {
+        lines.push(`- last checkpoint: ${frame.resumeHandle.lastVerifiedCheckpoint}`);
+    }
     if (otherActiveSessions.length > 0) {
         lines.push("other active sessions:");
         lines.push(...otherActiveSessions);
     }
     return lines.join("\n");
 }
+function snapshotActiveWork(frame) {
+    return {
+        obligationSnapshots: (frame.pendingObligations ?? []).map((ob) => ({
+            id: ob.id,
+            status: ob.status,
+            artifact: ob.currentArtifact?.trim() || null,
+            nextAction: ob.nextAction?.trim() || null,
+        })),
+        codingSnapshots: (frame.codingSessions ?? []).map((cs) => ({
+            id: cs.id,
+            status: cs.status,
+            artifact: cs.artifactPath?.trim() || null,
+            checkpoint: cs.checkpoint?.trim() || null,
+        })),
+        timestamp: new Date().toISOString(),
+    };
+}
+function detectActiveWorkChanges(previous, current) {
+    const changes = [];
+    const prevObMap = new Map(previous.obligationSnapshots.map((ob) => [ob.id, ob]));
+    const currObMap = new Map(current.obligationSnapshots.map((ob) => [ob.id, ob]));
+    // Detect new and changed obligations
+    for (const [id, curr] of currObMap) {
+        const prev = prevObMap.get(id);
+        if (!prev) {
+            changes.push({
+                kind: "obligation_appeared",
+                id,
+                from: null,
+                to: curr.status,
+                summary: `new obligation: ${curr.status}`,
+            });
+            continue;
+        }
+        if (prev.status !== curr.status) {
+            changes.push({
+                kind: "obligation_status_changed",
+                id,
+                from: prev.status,
+                to: curr.status,
+                summary: `obligation ${prev.status} -> ${curr.status}`,
+            });
+        }
+        if (prev.artifact !== curr.artifact) {
+            changes.push({
+                kind: "obligation_artifact_changed",
+                id,
+                from: prev.artifact,
+                to: curr.artifact,
+                summary: curr.artifact ? `artifact updated: ${curr.artifact}` : "artifact cleared",
+            });
+        }
+    }
+    const prevCodingMap = new Map(previous.codingSnapshots.map((cs) => [cs.id, cs]));
+    const currCodingMap = new Map(current.codingSnapshots.map((cs) => [cs.id, cs]));
+    for (const [id, curr] of currCodingMap) {
+        const prev = prevCodingMap.get(id);
+        if (!prev)
+            continue;
+        if (prev.status !== curr.status) {
+            changes.push({
+                kind: "coding_status_changed",
+                id,
+                from: prev.status,
+                to: curr.status,
+                summary: `coding ${prev.status} -> ${curr.status}`,
+            });
+        }
+        if (prev.artifact !== curr.artifact) {
+            changes.push({
+                kind: "coding_artifact_changed",
+                id,
+                from: prev.artifact,
+                to: curr.artifact,
+                summary: curr.artifact ? `artifact updated: ${curr.artifact}` : "artifact cleared",
+            });
+        }
+        if (prev.checkpoint !== curr.checkpoint) {
+            changes.push({
+                kind: "coding_checkpoint_changed",
+                id,
+                from: prev.checkpoint,
+                to: curr.checkpoint,
+                summary: curr.checkpoint ? `checkpoint: ${curr.checkpoint}` : "checkpoint cleared",
+            });
+        }
+    }
+    return changes;
+}
+function formatActiveWorkChanges(changes) {
+    if (changes.length === 0)
+        return "";
+    const lines = ["## what changed since last looked"];
+    for (const change of changes) {
+        lines.push(`- ${change.summary}`);
+    }
+    return lines.join("\n");
+}
+/* v8 ignore stop */

package/dist/heart/commitments.js

@@ -20,9 +20,15 @@ function deriveCommitments(activeWorkFrame, innerJob, pendingObligations) {
     const completionCriteria = [];
     const safeToIgnore = [];
     // Persistent obligations from the obligation store
+    // Sort by status priority: investigating/waiting/updating before pending
     if (pendingObligations && pendingObligations.length > 0) {
+        const sorted = [...pendingObligations].sort((a, b) => {
+            const advancedA = a.status !== "pending" && a.status !== "fulfilled" ? 0 : 1;
+            const advancedB = b.status !== "pending" && b.status !== "fulfilled" ? 0 : 1;
+            return advancedA - advancedB;
+        });
         let hasAdvancedObligation = false;
-        for (const ob of pendingObligations) {
+        for (const ob of sorted) {
             if (!(0, obligations_1.isOpenObligationStatus)(ob.status))
                 continue;
             committedTo.push(describeActiveObligation(ob));

package/dist/heart/presence.js

@@ -39,7 +39,6 @@ exports.readPresence = readPresence;
 exports.readPeerPresence = readPeerPresence;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const os = __importStar(require("os"));
 const runtime_1 = require("../nerves/runtime");
 function presenceDir(agentRoot) {
     return path.join(agentRoot, "state", "presence");
@@ -145,40 +144,41 @@ function readPresence(agentRoot, _agentName) {
     }
 }
 function readPeerPresence(agentRoot) {
-    const relDir = path.join(agentRoot, "state", "relationships");
-    if (!fs.existsSync(relDir)) {
+    const friendsDir = path.join(agentRoot, "friends");
+    if (!fs.existsSync(friendsDir)) {
         (0, runtime_1.emitNervesEvent)({
             component: "heart",
             event: "heart.peer_presence_read",
-            message: "no relationships directory, no peers",
+            message: "no friends directory, no peers",
             meta: { peerCount: 0 },
         });
         return [];
     }
-    const files = fs.readdirSync(relDir).filter((f) => f.endsWith(".json"));
+    const files = fs.readdirSync(friendsDir).filter((f) => f.endsWith(".json"));
     const peers = [];
     for (const file of files) {
         try {
-            const raw = fs.readFileSync(path.join(relDir, file), "utf-8");
-            const rel = JSON.parse(raw);
-            const peerName = rel.agentName;
-            // Read peer's presence from their bundle
-            const peerRoot = path.join(os.homedir(), "AgentBundles", `${peerName}.ouro`);
-            const peerPresencePath = path.join(peerRoot, "state", "presence", "self.json");
-            if (fs.existsSync(peerPresencePath)) {
-                const presenceRaw = fs.readFileSync(peerPresencePath, "utf-8");
-                const presence = JSON.parse(presenceRaw);
-                peers.push(presence);
-            }
+            const raw = fs.readFileSync(path.join(friendsDir, file), "utf-8");
+            const friend = JSON.parse(raw);
+            if (friend.kind !== "agent")
+                continue;
+            peers.push({
+                agentName: friend.name ?? path.basename(file, ".json"),
+                availability: "idle",
+                lane: "idle",
+                mission: "",
+                tempo: "brief",
+                updatedAt: friend.updatedAt ?? new Date().toISOString(),
+            });
         }
         catch {
-            // Skip peers with unreadable data
+            // Skip malformed or unreadable files
         }
     }
     (0, runtime_1.emitNervesEvent)({
         component: "heart",
         event: "heart.peer_presence_read",
-        message: `read ${peers.length} peer presence records`,
+        message: `read ${peers.length} agent peer records from friends`,
         meta: { peerCount: peers.length },
     });
     return peers;

package/dist/mind/friends/store-file.js

@@ -127,6 +127,8 @@ class FileFriendStore {
             trustLevel === "stranger"
             ? trustLevel
             : DEFAULT_TRUST_LEVEL;
+        const kind = raw.kind === "human" || raw.kind === "agent" ? raw.kind : "human";
+        const agentMeta = kind === "agent" ? this.normalizeAgentMeta(raw.agentMeta) : undefined;
         return {
             id: raw.id,
             name: raw.name,
@@ -153,6 +155,21 @@ class FileFriendStore {
             createdAt: typeof raw.createdAt === "string" ? raw.createdAt : new Date().toISOString(),
             updatedAt: typeof raw.updatedAt === "string" ? raw.updatedAt : new Date().toISOString(),
             schemaVersion: typeof raw.schemaVersion === "number" ? raw.schemaVersion : 1,
+            kind,
+            agentMeta,
+        };
+    }
+    normalizeAgentMeta(raw) {
+        if (!raw || typeof raw !== "object" || Array.isArray(raw))
+            return undefined;
+        const meta = raw;
+        if (typeof meta.bundleName !== "string")
+            return undefined;
+        return {
+            bundleName: meta.bundleName,
+            familiarity: typeof meta.familiarity === "number" ? meta.familiarity : 0,
+            sharedMissions: Array.isArray(meta.sharedMissions) ? meta.sharedMissions : [],
+            outcomes: Array.isArray(meta.outcomes) ? meta.outcomes : [],
         };
     }
     async readJson(filePath) {

package/dist/repertoire/tools-base.js

@@ -64,7 +64,6 @@ const cross_chat_delivery_1 = require("../heart/cross-chat-delivery");
 const obligations_2 = require("../heart/obligations");
 const episodes_1 = require("../mind/episodes");
 const cares_1 = require("../heart/cares");
-const agent_relationships_1 = require("../heart/agent-relationships");
 const presence_1 = require("../heart/presence");
 const intentions_1 = require("../heart/intentions");
 // Tracks which file paths have been read via read_file in this session.
@@ -1675,13 +1674,15 @@ exports.baseToolDefinitions = [
                 },
             },
         },
-        handler: (a) => {
-            const agentRoot = (0, identity_1.getAgentRoot)();
-            const result = a.agentName
-                ? (0, agent_relationships_1.readRelationship)(agentRoot, a.agentName)
-                : (0, agent_relationships_1.readRelationships)(agentRoot);
+        handler: async (a, ctx) => {
+            const allFriends = ctx?.friendStore?.listAll ? await ctx.friendStore.listAll() : [];
+            let agents = allFriends.filter((f) => f.kind === "agent");
+            if (a.agentName) {
+                const needle = a.agentName.toLowerCase();
+                agents = agents.filter((f) => f.name?.toLowerCase() === needle);
+            }
             (0, runtime_1.emitNervesEvent)({ component: "repertoire", event: "repertoire.query_relationships", message: `queried relationships`, meta: { agentName: a.agentName ?? "all" } });
-            return JSON.stringify(result, null, 2);
+            return JSON.stringify(agents, null, 2);
         },
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.186",
+  "version": "0.1.0-alpha.189",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",

package/dist/heart/agent-relationships.js

@@ -1,161 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.recordInteraction = recordInteraction;
-exports.readRelationships = readRelationships;
-exports.readRelationship = readRelationship;
-exports.recordOutcome = recordOutcome;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const runtime_1 = require("../nerves/runtime");
-function relationshipsDir(agentRoot) {
-    return path.join(agentRoot, "state", "relationships");
-}
-function relationshipFilePath(agentRoot, agentName) {
-    return path.join(relationshipsDir(agentRoot), `${agentName.toLowerCase()}.json`);
-}
-function readRelationshipFile(agentRoot, agentName) {
-    const filePath = relationshipFilePath(agentRoot, agentName);
-    if (!fs.existsSync(filePath)) {
-        return null;
-    }
-    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
-}
-function writeRelationshipFile(agentRoot, rel) {
-    const dir = relationshipsDir(agentRoot);
-    fs.mkdirSync(dir, { recursive: true });
-    fs.writeFileSync(path.join(dir, `${rel.agentName}.json`), JSON.stringify(rel, null, 2), "utf-8");
-}
-function recordInteraction(agentRoot, agentName, context) {
-    const normalizedName = agentName.toLowerCase();
-    const now = new Date().toISOString();
-    const existing = readRelationshipFile(agentRoot, normalizedName);
-    if (existing) {
-        existing.familiarity += 1;
-        existing.lastInteraction = now;
-        if (context.displayName) {
-            existing.displayName = context.displayName;
-        }
-        if (context.missionId && !existing.sharedMissions.includes(context.missionId)) {
-            existing.sharedMissions.push(context.missionId);
-        }
-        if (context.note) {
-            existing.notes.push(context.note);
-        }
-        writeRelationshipFile(agentRoot, existing);
-        (0, runtime_1.emitNervesEvent)({
-            component: "heart",
-            event: "heart.relationship_updated",
-            message: `relationship updated: ${normalizedName}`,
-            meta: { agentName: normalizedName, familiarity: existing.familiarity },
-        });
-        return existing;
-    }
-    const rel = {
-        agentName: normalizedName,
-        displayName: context.displayName ?? normalizedName,
-        familiarity: 1,
-        trust: "neutral",
-        sharedMissions: context.missionId ? [context.missionId] : [],
-        lastInteraction: now,
-        outcomes: [],
-        notes: context.note ? [context.note] : [],
-    };
-    writeRelationshipFile(agentRoot, rel);
-    (0, runtime_1.emitNervesEvent)({
-        component: "heart",
-        event: "heart.relationship_created",
-        message: `relationship created: ${normalizedName}`,
-        meta: { agentName: normalizedName },
-    });
-    return rel;
-}
-function readRelationships(agentRoot) {
-    const dir = relationshipsDir(agentRoot);
-    if (!fs.existsSync(dir)) {
-        (0, runtime_1.emitNervesEvent)({
-            component: "heart",
-            event: "heart.relationships_read",
-            message: "read relationships: directory missing, returning empty",
-            meta: { count: 0 },
-        });
-        return [];
-    }
-    const files = fs.readdirSync(dir).filter((f) => f.endsWith(".json"));
-    const relationships = [];
-    for (const file of files) {
-        try {
-            const content = fs.readFileSync(path.join(dir, file), "utf-8");
-            const rel = JSON.parse(content);
-            relationships.push(rel);
-        }
-        catch {
-            // Skip malformed JSON files
-        }
-    }
-    (0, runtime_1.emitNervesEvent)({
-        component: "heart",
-        event: "heart.relationships_read",
-        message: `read ${relationships.length} relationships`,
-        meta: { count: relationships.length },
-    });
-    return relationships;
-}
-function readRelationship(agentRoot, agentName) {
-    const rel = readRelationshipFile(agentRoot, agentName);
-    (0, runtime_1.emitNervesEvent)({
-        component: "heart",
-        event: "heart.relationship_read",
-        message: rel ? `read relationship: ${agentName.toLowerCase()}` : `relationship not found: ${agentName.toLowerCase()}`,
-        meta: { agentName: agentName.toLowerCase(), found: !!rel },
-    });
-    return rel;
-}
-function recordOutcome(agentRoot, agentName, outcome) {
-    const normalizedName = agentName.toLowerCase();
-    const existing = readRelationshipFile(agentRoot, normalizedName);
-    if (!existing) {
-        throw new Error(`Agent relationship not found: ${normalizedName}`);
-    }
-    existing.outcomes.push(outcome);
-    writeRelationshipFile(agentRoot, existing);
-    (0, runtime_1.emitNervesEvent)({
-        component: "heart",
-        event: "heart.outcome_recorded",
-        message: `outcome recorded for ${normalizedName}: ${outcome.result}`,
-        meta: { agentName: normalizedName, missionId: outcome.missionId, result: outcome.result },
-    });
-    return existing;
-}