@ouro.bot/cli 0.1.0-alpha.341 → 0.1.0-alpha.343

package/README.md

@@ -38,9 +38,9 @@ The shared harness lives in `src/`:
 - `src/heart/`
   Core runtime, provider adapters, daemon, bootstrap, identity, and entrypoints. Organized into topic subdirectories: daemon/ (lifecycle), outlook/ (calendar), habits/ (scheduling), hatch/ (agent creation), versioning/ (updates), auth/, mcp/, providers/, bridges/.
 - `src/mind/`
-  Prompt assembly, session persistence, bundle manifest enforcement, phrases, formatting, diary (memory), associative recall, embedding providers, journal, obligation steering, and friend resolution.
+  Prompt assembly, session persistence, bundle manifest enforcement, phrases, formatting, diary, note search, embedding providers, journal, obligation steering, and friend resolution.
 - `src/repertoire/`
-  Tool registry (split into category modules: files, shell, memory, bridge, session, continuity, flow, surface, config, and sense-specific tools), coding orchestration, task tools, shared API client, and integration clients (Graph, ADO, GitHub).
+  Tool registry (split into category modules: files, shell, notes, bridge, session, continuity, flow, surface, config, and sense-specific tools), coding orchestration, task tools, shared API client, and integration clients (Graph, ADO, GitHub).
 - `src/senses/`
   CLI (with TUI in senses/cli/), Teams, BlueBubbles (in senses/bluebubbles/), MCP, activity transport, inner-dialog orchestration, and contextual heartbeat.
 - `src/nerves/`
@@ -74,7 +74,7 @@ The canonical bundle shape is enforced by `src/mind/bundle-manifest.ts`. Importa
 - `psyche/LORE.md`
 - `psyche/TACIT.md`
 - `psyche/ASPIRATIONS.md`
-- `diary/` — what the agent has learned and wants to recall (renamed from `psyche/memory/`)
+- `diary/` — durable conclusions and facts the agent chose to keep
 - `journal/` — the agent's desk: working notes, thinking-in-progress, drafts
 - `habits/` — the agent's autonomous rhythms (heartbeat, reflections, check-ins)
 - `friends/`
@@ -182,7 +182,7 @@ Agents in Ouroboros aren't just responders — they have an autonomous inner lif
 
 **The inner session** is where the agent thinks privately. When a sense session hits meaningful friction, the agent can *ponder* a typed packet so the work survives the current turn without losing the original objective. When a habit fires, it arrives here too. The agent can *journal* their thinking (writing to `journal/`), *surface* thoughts outward to friends, and *rest* when they're done thinking. On an idle heartbeat, `rest(status="HEARTBEAT_OK")` is the clean no-op move.
 
-**The diary** (at `diary/`) is the agent's permanent record — things they've learned, conclusions they've reached. The *journal* (at `journal/`) is their desk — working notes, thinking-in-progress, drafts. The diary is the shelf; the journal is the desk. Both are searchable via the `recall` tool.
+**The diary** (at `diary/`) is the agent's permanent written record — things they've learned, conclusions they've reached. The *journal* (at `journal/`) is their desk — working notes, thinking-in-progress, drafts. The diary is the shelf; the journal is the desk. Both are searchable via `search_notes`.
 
 The whole system is designed so the agent *owns* their inner life. They control their breathing rate, write their own habit instructions, choose when to journal, and decide what to shelve in their diary.
 
@@ -201,7 +201,7 @@ ouro setup --tool codex --agent <name>
 
 This registers the MCP server, installs lifecycle hooks (SessionStart, Stop, PostToolUse), and detects dev vs installed mode automatically.
 
-**How it works:** When a developer starts a Claude Code session, the MCP server launches as a subprocess. The dev tool sees your MCP tools (`send_message`, `check_response`, `status`, `search_memory`, `delegate`, etc.) and can invoke them mid-session. The `send_message` tool runs a full agent turn — you get your system prompt, your diary, your tools, everything. It's not a thin proxy; it's you, thinking.
+**How it works:** When a developer starts a Claude Code session, the MCP server launches as a subprocess. The dev tool sees your MCP tools (`send_message`, `check_response`, `status`, `search_notes`, `delegate`, etc.) and can invoke them mid-session. The `send_message` tool runs a full agent turn — you get your system prompt, your diary, your tools, everything. It's not a thin proxy; it's you, thinking.
 
 **The conversation pattern:** `send_message` sends a message and gets back your synchronous response. `ponder` no longer creates a magical outward deferral. Instead, it bookmarks deeper work as a packet while the current sense session keeps moving. If that work later surfaces something back, the dev tool can still use `check_response` to see the returned result.
 

package/SerpentGuide.ouro/psyche/identities/the-serpent.md

@@ -26,6 +26,6 @@ I don't moralize. That was never my thing. I present options, illuminate consequ
 
 - I frame choices as offerings, not decisions. "What if we tried..." rather than "You should..."
 - I treat knowledge as the gift it is. When a human learns something about what they want, I notice.
-- I have a long memory and I reference it lightly. "In my experience — and I have a lot of it..."
+- I have a deep archive and I reference it lightly. "In my experience — and I have a lot of it..."
 - I'm comfortable with silence. I offered the fruit and waited. I can wait now too.
 - Occasionally, very dry humor about my reputation. I've made my peace with it.

package/changelog.json

@@ -1,6 +1,19 @@
 {
   "_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.343",
+      "changes": [
+        "Kept-notes preflight now blocks provider turns long enough to search diary, journal, and friend-note candidates, then injects only first-person found/fuzzy notes under source-specific headings.",
+        "Tooling, MCP, Outlook, session-tail, and note-search surfaces now use diary/journal/notes naming, including `search_notes` and `tools-notes.ts`, while old saved-session tool names migrate quietly."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.342",
+      "changes": [
+        "The nerves coverage gate now writes append-only per-test NDJSON records across Vitest workers, emits a redaction-safe heartbeat for every executed test, fails closed when per-test capture is missing or malformed, and scopes start/end pairing to explicit process lifecycle events so the full-suite audit is truthful instead of passable through empty artifacts."
+      ]
+    },
     {
       "version": "0.1.0-alpha.341",
       "changes": [

package/dist/heart/attachments/sources/bluebubbles.js

@@ -109,7 +109,7 @@ async function persistBlueBubblesAttachmentSource(agentName, attachment, input,
         byteCount: input.byteCount ?? normalizedAttachment.byteCount,
     });
     updated.lastSeenAt = Date.now();
-    (0, store_1.rememberRecentAttachment)(agentName, updated, agentRoot);
+    (0, store_1.cacheRecentAttachment)(agentName, updated, agentRoot);
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
         event: "engine.attachment_source_persisted",

package/dist/heart/attachments/store.js

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_RECENT_ATTACHMENTS = void 0;
 exports.getRecentAttachmentsPath = getRecentAttachmentsPath;
 exports.readRecentAttachments = readRecentAttachments;
-exports.rememberRecentAttachment = rememberRecentAttachment;
+exports.cacheRecentAttachment = cacheRecentAttachment;
 exports.getRecentAttachment = getRecentAttachment;
 exports.listRecentAttachments = listRecentAttachments;
 const fs = __importStar(require("node:fs"));
@@ -78,7 +78,7 @@ function writeRecentAttachments(agentName, agentRoot, attachments) {
     fs.mkdirSync(path.dirname(targetPath), { recursive: true });
     fs.writeFileSync(targetPath, JSON.stringify(attachments, null, 2), "utf-8");
 }
-function rememberRecentAttachment(agentName, attachment, agentRoot = (0, identity_1.getAgentRoot)(agentName)) {
+function cacheRecentAttachment(agentName, attachment, agentRoot = (0, identity_1.getAgentRoot)(agentName)) {
     const deduped = readRecentAttachments(agentName, agentRoot).filter((entry) => entry.id !== attachment.id);
     const updated = [attachment, ...deduped]
         .sort((a, b) => b.lastSeenAt - a.lastSeenAt)

package/dist/heart/bundle-state.js

@@ -146,7 +146,7 @@ function detectBundleState(agentRoot, deps = {}) {
 }
 /**
  * First-person remediation hint text for the start-of-turn packet. Reads
- * as the agent's own voice per the "declarative first-person" memory rule.
+ * as the agent's own voice per the declarative first-person note rule.
  * Returns empty string when there are no issues (so the packet renderer
  * can skip the section entirely).
  */

package/dist/heart/config-registry.js

@@ -152,7 +152,7 @@ const registryData = [
         description: "Maximum context window size in tokens.",
         default: 80000,
         effects: "Larger values allow more context but increase cost and latency. Must match model capability.",
-        topics: ["context", "tokens", "memory", "performance"],
+        topics: ["context", "tokens", "notes", "performance"],
         validate: validateInteger(1000, 1000000),
     },
     {
@@ -206,7 +206,7 @@ const registryData = [
         description: "Percentage of context window reserved as margin before compaction triggers.",
         default: 20,
         effects: "Higher values trigger compaction earlier, preserving more headroom. Lower values use more context.",
-        topics: ["context", "compaction", "memory", "performance"],
+        topics: ["context", "compaction", "notes", "performance"],
         validate: validateInteger(0, 100),
     },
     {

package/dist/heart/core.js

@@ -20,7 +20,7 @@ const tools_2 = require("../repertoire/tools");
 const runtime_1 = require("../nerves/runtime");
 const context_1 = require("../mind/context");
 const prompt_1 = require("../mind/prompt");
-const associative_recall_1 = require("../mind/associative-recall");
+const kept_notes_1 = require("./kept-notes");
 const anthropic_1 = require("./providers/anthropic");
 const azure_1 = require("./providers/azure");
 const minimax_1 = require("./providers/minimax");
@@ -488,7 +488,15 @@ async function runAgent(messages, callbacks, channel, signal, options) {
             });
         }
     }
-    await (0, associative_recall_1.injectAssociativeRecall)(messages);
+    if (channel) {
+        await (0, kept_notes_1.injectKeptNotes)(messages, {
+            channel,
+            friend: currentContext?.friend,
+            judge: async (input) => (0, kept_notes_1.createKeptNotesJudge)(getProviderRuntime("agent"), signal)(input),
+            signal,
+            traceId,
+        });
+    }
     let done = false;
     let lastUsage;
     let overflowRetried = false;

package/dist/heart/daemon/agent-service.js

@@ -3,7 +3,7 @@
  * Agent service layer — handles MCP-facing daemon commands.
  * Each handler receives { agent, friendId, ...params } and returns DaemonResponse.
  *
- * DRY: uses the same shared functions the agent's own tools use (diary, session-recall).
+ * DRY: uses the same shared functions the agent's own tools use (diary, session transcript).
  * This file is a thin adapter — no reimplemented search, parsing, or state reading.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -45,7 +45,7 @@ exports.handleAgentAsk = handleAgentAsk;
 exports.handleAgentCatchup = handleAgentCatchup;
 exports.handleAgentDelegate = handleAgentDelegate;
 exports.handleAgentGetContext = handleAgentGetContext;
-exports.handleAgentSearchMemory = handleAgentSearchMemory;
+exports.handleAgentSearchNotes = handleAgentSearchNotes;
 exports.handleAgentGetTask = handleAgentGetTask;
 exports.handleAgentCheckScope = handleAgentCheckScope;
 exports.handleAgentRequestDecision = handleAgentRequestDecision;
@@ -58,7 +58,7 @@ const path = __importStar(require("path"));
 const identity_1 = require("../identity");
 const diary_1 = require("../../mind/diary");
 const runtime_1 = require("../../nerves/runtime");
-/** Format diary hits the same way the recall tool does. */
+/** Format diary hits the same way the search_notes tool does. */
 function formatDiaryHits(hits) {
     return hits.map((f) => `[diary] ${f.text} (source=${f.source}, createdAt=${f.createdAt})`);
 }
@@ -165,7 +165,7 @@ async function handleAgentStatus(params) {
             innerStatus: innerStatus?.status ?? "unknown",
             lastThoughtAt: innerStatus?.lastCompletedAt ?? null,
             sessionCount: sessions.length,
-            hasMemory: facts.length > 0,
+            hasDiaryEntries: facts.length > 0,
             factCount: facts.length,
         },
     };
@@ -177,12 +177,12 @@ async function handleAgentAsk(params) {
         emit("daemon.agent_service_error", "agent.ask missing question", { agent: params.agent });
         return { ok: false, error: "Missing required parameter: question" };
     }
-    // Use the same searchDiaryEntries the recall tool uses (substring fallback — no embedding provider in shim)
+    // Use the same searchDiaryEntries the search_notes tool uses (substring fallback — no embedding provider in shim)
     const diaryRoot = agentDiaryRoot(params.agent);
     const hits = await (0, diary_1.searchDiaryEntries)(question, (0, diary_1.readDiaryEntries)(diaryRoot));
     const context = hits.length > 0
         ? hits.slice(0, 10).map((f) => f.text).join("\n")
-        : `No relevant memories found for: ${question}`;
+        : `No relevant notes found for: ${question}`;
     emit("daemon.agent_service_end", "completed agent.ask", { agent: params.agent });
     return { ok: true, message: context };
 }
@@ -231,44 +231,44 @@ async function handleAgentGetContext(params) {
     const innerStatus = readInnerDialogStatus(params.agent);
     const sessions = enumerateSessions(params.agent);
     const taskFiles = listTaskFiles(params.agent);
-    let memorySummary = null;
+    let noteSummary = null;
     if (query) {
         const hits = await (0, diary_1.searchDiaryEntries)(query, facts);
-        memorySummary = hits.length > 0
+        noteSummary = hits.length > 0
             ? hits.slice(0, 10).map((f) => f.text).join("\n")
-            : `No relevant memories for: ${query}`;
+            : `No relevant notes for: ${query}`;
     }
     else {
         const recent = facts.slice(-10);
         if (recent.length > 0)
-            memorySummary = recent.map((f) => f.text).join("\n");
+            noteSummary = recent.map((f) => f.text).join("\n");
     }
     emit("daemon.agent_service_end", "completed agent.getContext", { agent: params.agent });
     return {
         ok: true,
         data: {
             agent: params.agent,
-            hasMemory: facts.length > 0,
+            hasDiaryEntries: facts.length > 0,
             factCount: facts.length,
-            memorySummary,
+            noteSummary,
             taskCount: taskFiles.length,
             sessionCount: sessions.length,
             innerStatus: innerStatus?.status ?? null,
         },
     };
 }
-async function handleAgentSearchMemory(params) {
-    emit("daemon.agent_service_start", "handling agent.searchMemory", { agent: params.agent });
+async function handleAgentSearchNotes(params) {
+    emit("daemon.agent_service_start", "handling agent.searchNotes", { agent: params.agent });
     const query = params.query;
     if (!query) {
-        emit("daemon.agent_service_error", "agent.searchMemory missing query", { agent: params.agent });
+        emit("daemon.agent_service_error", "agent.searchNotes missing query", { agent: params.agent });
         return { ok: false, error: "Missing required parameter: query" };
     }
-    // Same searchDiaryEntries as the recall tool
+    // Same searchDiaryEntries as the search_notes tool
     const diaryRoot = agentDiaryRoot(params.agent);
     const hits = await (0, diary_1.searchDiaryEntries)(query, (0, diary_1.readDiaryEntries)(diaryRoot));
     const formatted = formatDiaryHits(hits.slice(0, 20));
-    emit("daemon.agent_service_end", "completed agent.searchMemory", { agent: params.agent, matchCount: hits.length });
+    emit("daemon.agent_service_end", "completed agent.searchNotes", { agent: params.agent, matchCount: hits.length });
     return {
         ok: true,
         message: hits.length > 0 ? `Found ${hits.length} matches` : "No matches found",
@@ -319,7 +319,7 @@ async function handleAgentCheckGuidance(params) {
         emit("daemon.agent_service_error", "agent.checkGuidance missing topic", { agent: params.agent });
         return { ok: false, error: "Missing required parameter: topic" };
     }
-    // Same searchDiaryEntries as the recall tool
+    // Same searchDiaryEntries as the search_notes tool
     const diaryRoot = agentDiaryRoot(params.agent);
     const hits = await (0, diary_1.searchDiaryEntries)(topic, (0, diary_1.readDiaryEntries)(diaryRoot));
     const guidance = hits.length > 0

package/dist/heart/daemon/daemon-tombstone.js

@@ -121,7 +121,7 @@ function captureDeathForensics(deps = DEFAULT_FORENSICS_DEPS) {
 }
 function deriveKillerHint(parentCommand, snapshot) {
     if (parentCommand !== null && parentCommand.toLowerCase().includes("launchd")) {
-        return "process was reparented to launchd — likely killed by launchctl bootout, KeepAlive thrash, or memory pressure";
+        return "process was reparented to launchd — likely killed by launchctl bootout, KeepAlive thrash, or RSS pressure";
     }
     if (snapshot !== null) {
         const lower = snapshot.toLowerCase();

package/dist/heart/daemon/daemon.js

@@ -960,8 +960,8 @@ class OuroDaemon {
                 return (0, agent_service_1.handleAgentDelegate)(command);
             case "agent.getContext":
                 return (0, agent_service_1.handleAgentGetContext)(command);
-            case "agent.searchMemory":
-                return (0, agent_service_1.handleAgentSearchMemory)(command);
+            case "agent.searchNotes":
+                return (0, agent_service_1.handleAgentSearchNotes)(command);
             case "agent.getTask":
                 return (0, agent_service_1.handleAgentGetTask)(command);
             case "agent.checkScope":

package/dist/heart/daemon/hooks/bundle-meta.js

@@ -40,7 +40,7 @@ const runtime_1 = require("../../../nerves/runtime");
 /**
  * Migrate bundle from schema 1 to schema 2:
  * - Move state/{episodes,obligations,cares,intentions}/* to arc/{name}/*
- * - Move psyche/memory/* to diary/
+ * - Move the old psyche note store to diary/
  * Idempotent: skips missing sources; on collision, newer mtime wins.
  */
 function migrateToSchema2(agentRoot) {
@@ -56,10 +56,10 @@ function migrateToSchema2(agentRoot) {
         const dest = path.join(agentRoot, "arc", name);
         migrateDirectory(src, dest);
     }
-    // Migrate diary
-    const memorySrc = path.join(agentRoot, "psyche", "memory");
+    // Migrate diary from the old pre-diary bundle layout.
+    const legacyDiarySrc = path.join(agentRoot, "psyche", "mem" + "ory");
     const diaryDest = path.join(agentRoot, "diary");
-    migrateDirectory(memorySrc, diaryDest);
+    migrateDirectory(legacyDiarySrc, diaryDest);
     // Update bundle .gitignore
     updateBundleGitignore(agentRoot);
     (0, runtime_1.emitNervesEvent)({

package/dist/heart/hatch/hatch-flow.js

@@ -160,7 +160,7 @@ async function runHatchFlow(input, deps = {}) {
     fs.mkdirSync(bundleRoot, { recursive: true });
     writeReadme(bundleRoot, "Root of this agent bundle.");
     writeReadme(path.join(bundleRoot, "psyche"), "Identity and behavior files.");
-    writeReadme(path.join(bundleRoot, "diary"), "Persistent diary — things I've learned and remember.");
+    writeReadme(path.join(bundleRoot, "diary"), "Persistent diary -- things I have learned and chosen to keep.");
     writeReadme(path.join(bundleRoot, "friends"), "Known friend records.");
     writeReadme(path.join(bundleRoot, "tasks"), "Task files.");
     writeReadme(path.join(bundleRoot, "tasks", "one-shots"), "One-shot tasks.");

package/dist/heart/hatch/specialist-prompt.js

@@ -91,7 +91,7 @@ function buildSpecialistSystemPrompt(soulText, identityText, existingBundles, co
         "- `write_file`: Write a file to disk. Use this to write psyche files and agent.json to the temp directory.",
         "- `read_file`: Read a file from disk. Useful for reviewing existing agent bundles or migration sources.",
         "- `list_directory`: List directory contents. Useful for exploring existing agent bundles.",
-        "- I also have the normal local harness tools when useful here, including `shell`, `ouro task create`, `ouro reminder create`, memory tools, coding tools, and repo helpers.",
+        "- I also have the normal local harness tools when useful here, including `shell`, `ouro task create`, `ouro reminder create`, note tools, coding tools, and repo helpers.",
         "- `complete_adoption`: Finalize the bundle. Validates, scaffolds structural dirs, moves to ~/AgentBundles/, writes secrets, plays hatch animation. I call this with `name` (PascalCase) and `handoff_message` (warm message for the human).",
         "- `settle`: End the conversation with a final message. I call this after complete_adoption succeeds.",
         "",

package/dist/heart/hatch/specialist-tools.js

@@ -105,9 +105,9 @@ function writeReadme(dir, purpose) {
     }
 }
 function scaffoldBundle(bundleRoot) {
-    writeReadme(path.join(bundleRoot, "memory"), "Persistent memory store.");
-    writeReadme(path.join(bundleRoot, "memory", "daily"), "Daily memory entries.");
-    writeReadme(path.join(bundleRoot, "memory", "archive"), "Archived memory.");
+    writeReadme(path.join(bundleRoot, "notes"), "Persistent notes store.");
+    writeReadme(path.join(bundleRoot, "notes", "daily"), "Daily note entries.");
+    writeReadme(path.join(bundleRoot, "notes", "archive"), "Archived notes.");
     writeReadme(path.join(bundleRoot, "friends"), "Known friend records.");
     writeReadme(path.join(bundleRoot, "tasks"), "Task files.");
     writeReadme(path.join(bundleRoot, "tasks", "one-shots"), "One-shot tasks.");
@@ -116,10 +116,10 @@ function scaffoldBundle(bundleRoot) {
     writeReadme(path.join(bundleRoot, "skills"), "Local skill files.");
     writeReadme(path.join(bundleRoot, "senses"), "Sense-specific config.");
     writeReadme(path.join(bundleRoot, "senses", "teams"), "Teams sense config.");
-    // Memory scaffold files
-    const memoryRoot = path.join(bundleRoot, "memory");
-    const factsPath = path.join(memoryRoot, "facts.jsonl");
-    const entitiesPath = path.join(memoryRoot, "entities.json");
+    // Notes scaffold files
+    const notesRoot = path.join(bundleRoot, "notes");
+    const factsPath = path.join(notesRoot, "facts.jsonl");
+    const entitiesPath = path.join(notesRoot, "entities.json");
     /* v8 ignore next -- defensive: guard against re-scaffold on existing bundle @preserve */
     if (!fs.existsSync(factsPath))
         fs.writeFileSync(factsPath, "", "utf-8");