@ouro.bot/cli 0.1.0-alpha.655 → 0.1.0-alpha.658

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 transcript).
+ * DRY: uses the same shared functions the agent's own tools use (Desk record 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.handleAgentSearchNotes = handleAgentSearchNotes;
+exports.handleAgentSearchFacts = handleAgentSearchFacts;
 exports.handleAgentGetTask = handleAgentGetTask;
 exports.handleAgentCheckScope = handleAgentCheckScope;
 exports.handleAgentRequestDecision = handleAgentRequestDecision;
@@ -57,9 +57,10 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const identity_1 = require("../identity");
 const diary_1 = require("../../mind/diary");
+const record_paths_1 = require("../../mind/record-paths");
 const runtime_1 = require("../../nerves/runtime");
 const socket_client_1 = require("./socket-client");
-/** Format diary hits the same way the search_notes tool does. */
+/** Format diary hits the same way the search_facts tool does. */
 function formatDiaryHits(hits) {
     return hits.map((f) => `[diary] ${f.text} (source=${f.source}, createdAt=${f.createdAt})`);
 }
@@ -72,7 +73,7 @@ function readAgentFile(agent, ...segments) {
 }
 /** Resolve the diary root for a specific agent. */
 function agentDiaryRoot(agent) {
-    return (0, diary_1.resolveDiaryRoot)(path.join((0, identity_1.getAgentRoot)(agent), "diary"));
+    return (0, record_paths_1.resolveRecordDiaryRoot)((0, identity_1.getAgentRoot)(agent));
 }
 /** Read inner dialog runtime status. */
 function readInnerDialogStatus(agent) {
@@ -339,12 +340,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 search_notes tool uses (substring fallback — no embedding provider in shim)
+    // Use the same searchDiaryEntries the search_facts 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 notes found for: ${question}`;
+        : `No relevant facts found for: ${question}`;
     emit("daemon.agent_service_end", "completed agent.ask", { agent: params.agent });
     return { ok: true, message: context };
 }
@@ -393,17 +394,17 @@ async function handleAgentGetContext(params) {
     const innerStatus = readInnerDialogStatus(params.agent);
     const sessions = enumerateSessions(params.agent);
     const taskFiles = listTaskFiles(params.agent);
-    let noteSummary = null;
+    let recordSummary = null;
     if (query) {
         const hits = await (0, diary_1.searchDiaryEntries)(query, facts);
-        noteSummary = hits.length > 0
+        recordSummary = hits.length > 0
             ? hits.slice(0, 10).map((f) => f.text).join("\n")
-            : `No relevant notes for: ${query}`;
+            : `No relevant facts for: ${query}`;
     }
     else {
         const recent = facts.slice(-10);
         if (recent.length > 0)
-            noteSummary = recent.map((f) => f.text).join("\n");
+            recordSummary = recent.map((f) => f.text).join("\n");
     }
     emit("daemon.agent_service_end", "completed agent.getContext", { agent: params.agent });
     return {
@@ -412,25 +413,25 @@ async function handleAgentGetContext(params) {
             agent: params.agent,
             hasDiaryEntries: facts.length > 0,
             factCount: facts.length,
-            noteSummary,
+            recordSummary,
             taskCount: taskFiles.length,
             sessionCount: sessions.length,
             innerStatus: innerStatus?.status ?? null,
         },
     };
 }
-async function handleAgentSearchNotes(params) {
-    emit("daemon.agent_service_start", "handling agent.searchNotes", { agent: params.agent });
+async function handleAgentSearchFacts(params) {
+    emit("daemon.agent_service_start", "handling agent.searchFacts", { agent: params.agent });
     const query = params.query;
     if (!query) {
-        emit("daemon.agent_service_error", "agent.searchNotes missing query", { agent: params.agent });
+        emit("daemon.agent_service_error", "agent.searchFacts missing query", { agent: params.agent });
         return { ok: false, error: "Missing required parameter: query" };
     }
-    // Same searchDiaryEntries as the search_notes tool
+    // Same searchDiaryEntries as the search_facts 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.searchNotes", { agent: params.agent, matchCount: hits.length });
+    emit("daemon.agent_service_end", "completed agent.searchFacts", { agent: params.agent, matchCount: hits.length });
     return {
         ok: true,
         message: hits.length > 0 ? `Found ${hits.length} matches` : "No matches found",
@@ -481,7 +482,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 search_notes tool
+    // Same searchDiaryEntries as the search_facts 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/cli-exec.js

@@ -365,6 +365,7 @@ function agentResolutionFailureMode(command) {
         case "attention.list":
         case "attention.show":
         case "attention.history":
+        case "work.card":
         case "inner.status":
         case "session.list":
             return "return-message";
@@ -2496,25 +2497,64 @@ function enableAgentSense(agent, sense, deps) {
         mail: senses.mail ?? { enabled: false },
         voice: senses.voice ?? { enabled: false },
         a2a: senses.a2a ?? { enabled: false },
+        workbench: senses.workbench ?? { enabled: false },
         [sense]: { ...existing, enabled: true },
     };
     fs.writeFileSync(configPath, `${JSON.stringify(raw, null, 2)}\n`, "utf-8");
 }
-const CONNECT_MENU_PROMPT = "Choose [1-8] or type a name: ";
+const CONNECT_MENU_PROMPT = "Choose [1-9] or type a name: ";
 function connectMenuIsTTY(deps) {
     return deps.isTTY ?? process.stdout.isTTY === true;
 }
 function readConnectBaySenseFlags(agent, deps) {
     const configPath = path.join(providerCliAgentRoot({ agent }, deps), "agent.json");
     const parsed = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    const workbenchCommand = parsed.mcpServers?.ouro_workbench?.command;
     return {
         teamsEnabled: parsed.senses?.teams?.enabled === true,
         blueBubblesEnabled: parsed.senses?.bluebubbles?.enabled === true,
         mailEnabled: parsed.senses?.mail?.enabled === true,
         voiceEnabled: parsed.senses?.voice?.enabled === true,
         a2aEnabled: parsed.senses?.a2a?.enabled === true,
+        workbenchEnabled: parsed.senses?.workbench?.enabled === true,
+        workbenchMcpCommand: typeof workbenchCommand === "string" && workbenchCommand.trim().length > 0
+            ? workbenchCommand
+            : null,
     };
 }
+function defaultWorkbenchMcpCandidates(deps) {
+    const homeDir = deps.homeDir ?? os.homedir();
+    return [
+        path.join(homeDir, "Applications", "Ouro Workbench.app", "Contents", "MacOS", "OuroWorkbenchMCP"),
+        path.join("/Applications", "Ouro Workbench.app", "Contents", "MacOS", "OuroWorkbenchMCP"),
+    ];
+}
+function cliPathExists(deps, filePath) {
+    return !!filePath && (deps.existsSync ?? fs.existsSync)(filePath);
+}
+function findInstalledWorkbenchMcp(deps, preferred) {
+    const candidates = [
+        ...(preferred ? [preferred] : []),
+        ...defaultWorkbenchMcpCandidates(deps),
+    ];
+    return candidates.find((candidate) => cliPathExists(deps, candidate)) ?? null;
+}
+function writeWorkbenchMcpRegistration(agent, executablePath, deps) {
+    const { configPath } = (0, auth_flow_1.readAgentConfigForAgent)(agent, deps.bundlesRoot);
+    enableAgentSense(agent, "workbench", deps);
+    const nextRaw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    const mcpServers = nextRaw.mcpServers && typeof nextRaw.mcpServers === "object" && !Array.isArray(nextRaw.mcpServers)
+        ? nextRaw.mcpServers
+        : {};
+    nextRaw.mcpServers = {
+        ...mcpServers,
+        ouro_workbench: {
+            command: executablePath,
+            args: [],
+        },
+    };
+    fs.writeFileSync(configPath, `${JSON.stringify(nextRaw, null, 2)}\n`, "utf-8");
+}
 async function buildConnectMenu(agent, deps, onProgress) {
     const bundlesRoot = path.dirname(providerCliAgentRoot({ agent }, deps));
     let providerHealth;
@@ -2542,7 +2582,7 @@ async function buildConnectMenu(agent, deps, onProgress) {
     const runtimeConfig = await (0, runtime_credentials_1.refreshRuntimeCredentialConfig)(agent, { preserveCachedOnFailure: true });
     onProgress?.("loading this machine's settings");
     const machineRuntime = await (0, runtime_credentials_1.refreshMachineRuntimeCredentialConfig)(agent, currentMachineId(deps), { preserveCachedOnFailure: true });
-    const { teamsEnabled, blueBubblesEnabled, mailEnabled, voiceEnabled, a2aEnabled } = readConnectBaySenseFlags(agent, deps);
+    const { teamsEnabled, blueBubblesEnabled, mailEnabled, voiceEnabled, a2aEnabled, workbenchEnabled, workbenchMcpCommand, } = readConnectBaySenseFlags(agent, deps);
     const perplexityApiKey = runtimeConfig.ok
         ? readRuntimeConfigString(runtimeConfig.config, "integrations.perplexityApiKey")
         : null;
@@ -2698,6 +2738,26 @@ async function buildConnectMenu(agent, deps, onProgress) {
             : "missing"
         : runtimeConfigReadStatus(runtimeConfig);
     const a2aStatus = a2aEnabled ? "ready" : "missing";
+    const installedWorkbenchMcp = findInstalledWorkbenchMcp(deps, workbenchMcpCommand);
+    const configuredWorkbenchMcpExists = cliPathExists(deps, workbenchMcpCommand);
+    const workbenchStatus = workbenchEnabled && configuredWorkbenchMcpExists
+        ? "ready"
+        : workbenchEnabled || workbenchMcpCommand
+            ? "needs attention"
+            : installedWorkbenchMcp
+                ? "not attached"
+                : "missing";
+    const workbenchDetailLines = [
+        workbenchEnabled ? "senses.workbench.enabled = true" : "senses.workbench.enabled is not enabled",
+        workbenchMcpCommand
+            ? configuredWorkbenchMcpExists
+                ? `MCP command registered: ${workbenchMcpCommand}`
+                : `registered MCP command is missing: ${workbenchMcpCommand}`
+            : "mcpServers.ouro_workbench is not registered",
+        installedWorkbenchMcp
+            ? `OuroWorkbenchMCP found: ${installedWorkbenchMcp}`
+            : "OuroWorkbenchMCP not found in ~/Applications or /Applications",
+    ];
     const entries = [
         {
             option: "1",
@@ -2826,6 +2886,20 @@ async function buildConnectMenu(agent, deps, onProgress) {
                 status: a2aStatus,
             }) ? `ouro connect a2a --agent ${agent}` : undefined,
         },
+        {
+            option: "9",
+            name: "Ouro Workbench",
+            section: "This machine",
+            status: workbenchStatus,
+            description: "Native terminal-agent control room and local MCP sense.",
+            detailLines: workbenchDetailLines,
+            nextAction: (0, connect_bay_1.connectEntryNeedsAttention)({
+                option: "9",
+                name: "Ouro Workbench",
+                section: "This machine",
+                status: workbenchStatus,
+            }) ? `ouro connect workbench --agent ${agent}` : undefined,
+        },
     ];
     const isTTY = connectMenuIsTTY(deps);
     return (0, connect_bay_1.renderConnectBay)(entries, {
@@ -4364,6 +4438,8 @@ function connectMenuTarget(answer) {
     /* v8 ignore next -- direct `ouro connect a2a` covers behavior; interactive menu requires broader provider/vault readiness work @preserve */
     if (normalized === "8" || normalized === "a2a" || normalized === "agent2agent" || normalized === "agent-to-agent")
         return "a2a";
+    if (normalized === "9" || normalized === "workbench" || normalized === "ouro-workbench" || normalized === "terminal-workbench")
+        return "workbench";
     return "cancel";
 }
 async function executeConnectVoice(agent, deps) {
@@ -4421,6 +4497,30 @@ async function executeConnectA2A(agent, deps) {
     deps.writeStdout(message);
     return message;
 }
+async function executeConnectWorkbench(agent, deps) {
+    const { workbenchMcpCommand } = readConnectBaySenseFlags(agent, deps);
+    const executablePath = findInstalledWorkbenchMcp(deps, workbenchMcpCommand);
+    if (!executablePath) {
+        throw new Error([
+            `Ouro Workbench is not installed for ${agent} on this machine.`,
+            "Expected the MCP executable at one of:",
+            ...defaultWorkbenchMcpCandidates(deps).map((candidate) => `  ${candidate}`),
+            "Install or copy Ouro Workbench.app there, then run:",
+            `  ouro connect workbench --agent ${agent}`,
+        ].join("\n"));
+    }
+    writeWorkbenchMcpRegistration(agent, executablePath, deps);
+    const syncSummary = pushAgentBundleAfterCliMutation(agent, deps);
+    const message = [
+        `Workbench connected for ${agent}`,
+        "agent.json: senses.workbench.enabled = true",
+        `agent.json: mcpServers.ouro_workbench.command = ${executablePath}`,
+        "Workbench is a local machine sense; provider secrets stay in the agent vault.",
+        ...(syncSummary ? [syncSummary] : []),
+    ].join("\n");
+    deps.writeStdout(message);
+    return message;
+}
 async function executeConnect(command, deps) {
     if (command.target === "providers")
         return executeConnectProviders(command.agent, deps);
@@ -4438,6 +4538,8 @@ async function executeConnect(command, deps) {
         return executeConnectVoice(command.agent, deps);
     if (command.target === "a2a")
         return executeConnectA2A(command.agent, deps);
+    if (command.target === "workbench")
+        return executeConnectWorkbench(command.agent, deps);
     const progress = createHumanCommandProgress(deps, "connect");
     let menu;
     try {
@@ -4449,7 +4551,7 @@ async function executeConnect(command, deps) {
     const promptInput = deps.promptInput;
     if (!promptInput) {
         const message = [
-            menu.replace(/\nChoose \[1-8\] or type a name: $/, ""),
+            menu.replace(/\nChoose \[1-9\] or type a name: $/, ""),
             "",
             `Run: ouro connect providers --agent ${command.agent}`,
             `Run: ouro connect perplexity --agent ${command.agent}`,
@@ -4459,6 +4561,7 @@ async function executeConnect(command, deps) {
             `Run: ouro connect mail --agent ${command.agent}`,
             `Run: ouro connect voice --agent ${command.agent}`,
             `Run: ouro connect a2a --agent ${command.agent}`,
+            `Run: ouro connect workbench --agent ${command.agent}`,
         ].join("\n");
         deps.writeStdout(message);
         return message;
@@ -4481,6 +4584,8 @@ async function executeConnect(command, deps) {
     /* v8 ignore next -- direct `ouro connect a2a` covers behavior; interactive menu requires broader provider/vault readiness work @preserve */
     if (answer === "a2a")
         return executeConnectA2A(command.agent, deps);
+    if (answer === "workbench")
+        return executeConnectWorkbench(command.agent, deps);
     const message = "connect cancelled.";
     deps.writeStdout(message);
     return message;
@@ -7173,6 +7278,18 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
         }
     }
     /* v8 ignore stop */
+    // ── work card (local, no daemon socket needed) ──
+    if (command.kind === "work.card") {
+        const { buildWorkCard, formatWorkCardText } = await Promise.resolve().then(() => __importStar(require("../work-card")));
+        if (!command.agent)
+            throw new Error("work card requires --agent <name>");
+        const bundlesRoot = deps.bundlesRoot ?? (0, identity_1.getAgentBundlesRoot)();
+        const agentRoot = deps.agentBundleRoot ?? path.join(bundlesRoot, `${command.agent}.ouro`);
+        const card = buildWorkCard(command.agent, agentRoot);
+        const message = command.format === "json" ? JSON.stringify(card, null, 2) : formatWorkCardText(card);
+        deps.writeStdout(message);
+        return message;
+    }
     // ── inner dialog status (local, no daemon socket needed) ──
     /* v8 ignore start -- inner status handler: requires real agent state on disk @preserve */
     if (command.kind === "inner.status") {
@@ -7182,6 +7299,7 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             const { parseCadenceToMs: parseCadenceMs, DEFAULT_CADENCE_MS } = await Promise.resolve().then(() => __importStar(require("./cadence")));
             const { parseFrontmatter } = await Promise.resolve().then(() => __importStar(require("../../util/frontmatter")));
             const { listActiveReturnObligations } = await Promise.resolve().then(() => __importStar(require("../../arc/obligations")));
+            const { resolveDeskRecordPaths } = await Promise.resolve().then(() => __importStar(require("../../mind/record-paths")));
             // Read runtime state
             const innerSessionPath = (0, thoughts_1.getInnerDialogSessionPath)(agentRoot);
             const runtimeJsonPath = path.join(path.dirname(innerSessionPath), "runtime.json");
@@ -7191,19 +7309,20 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
                 runtimeState = JSON.parse(raw);
             }
             catch { /* missing or corrupt — will show "unknown" */ }
-            // Read journal files
-            const journalDir = path.join(agentRoot, "journal");
-            let journalFiles = [];
+            // Read canonical Desk record summary
+            const recordPaths = resolveDeskRecordPaths(agentRoot);
+            const recordSummary = { diaryFactCount: 0, noteCount: 0 };
             try {
-                const journalEntries = fs.readdirSync(journalDir, { withFileTypes: true });
-                journalFiles = journalEntries
-                    .filter((e) => e.isFile() && !e.name.startsWith("."))
-                    .map((e) => {
-                    const stat = fs.statSync(path.join(journalDir, e.name));
-                    return { name: e.name, mtimeMs: stat.mtimeMs };
-                });
+                const rawFacts = fs.readFileSync(recordPaths.factsPath, "utf-8");
+                recordSummary.diaryFactCount = rawFacts.split(/\r?\n/).filter((line) => line.trim().length > 0).length;
+            }
+            catch { /* missing facts file — count stays zero */ }
+            try {
+                recordSummary.noteCount = fs.readdirSync(recordPaths.notesRoot, { withFileTypes: true })
+                    .filter((e) => e.isFile() && !e.name.startsWith(".") && e.name.endsWith(".md"))
+                    .length;
             }
-            catch { /* missing dir — will show (empty) */ }
+            catch { /* missing notes dir — count stays zero */ }
             // Read heartbeat cadence
             let heartbeat = null;
             try {
@@ -7238,7 +7357,7 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             const message = buildInnerStatusOutput({
                 agentName: command.agent,
                 runtimeState,
-                journalFiles,
+                recordSummary,
                 heartbeat,
                 attentionCount: activeObligations.length,
                 now: Date.now(),

package/dist/heart/daemon/cli-help.js

@@ -151,6 +151,20 @@ exports.COMMAND_REGISTRY = {
         example: "ouro task list",
         subcommands: ["list", "new", "done", "archive", "show"],
     },
+    work: {
+        category: "Tasks",
+        description: "Show the agent's durable Work Card compiled from arc records.",
+        usage: "ouro work card [--agent <name>] [--format text|json|--json]",
+        example: "ouro work card --agent slugger --format json",
+        subcommands: ["card"],
+    },
+    "work card": {
+        category: "Tasks",
+        description: "Show the agent's durable Work Card compiled from arc records.",
+        usage: "ouro work card [--agent <name>] [--format text|json|--json]",
+        example: "ouro work card --agent slugger --format json",
+        hidden: true,
+    },
     "migrate-to-desk": {
         category: "Tasks",
         description: "Migrate a legacy `tasks/` tree into the new `desk/` shape (copy semantics — source untouched).",
@@ -187,9 +201,9 @@ exports.COMMAND_REGISTRY = {
     connect: {
         category: "Auth",
         description: "Set up providers, portable integrations, and local senses from one guided screen",
-        usage: "ouro connect [providers|perplexity|embeddings|teams|bluebubbles|mail|voice|a2a] [--agent <name>]",
+        usage: "ouro connect [providers|perplexity|embeddings|teams|bluebubbles|mail|voice|a2a|workbench] [--agent <name>]",
         example: "ouro connect",
-        subcommands: ["providers", "perplexity", "embeddings", "teams", "bluebubbles", "mail", "voice", "a2a"],
+        subcommands: ["providers", "perplexity", "embeddings", "teams", "bluebubbles", "mail", "voice", "a2a", "workbench"],
     },
     a2a: {
         category: "Friends",
@@ -342,6 +356,11 @@ const SUBCOMMAND_HELP = {
         usage: "ouro connect a2a [--agent <name>]",
         example: "ouro connect a2a --agent <agent>",
     },
+    "connect workbench": {
+        description: "Attach native Ouro Workbench on this machine and register its MCP sense",
+        usage: "ouro connect workbench [--agent <name>]",
+        example: "ouro connect workbench --agent <agent>",
+    },
     "a2a card": {
         description: "Print this agent's A2A Agent Card",
         usage: "ouro a2a card [--agent <name>] [--base-url <url>] [--json]",

package/dist/heart/daemon/cli-parse.js

@@ -84,7 +84,7 @@ function usage() {
         "  ouro -v|--version",
         "  ouro auth [--agent <name>] [--provider <provider>]",
         "  ouro account ensure [--agent <name>] [--owner-email <email> --source <label>|--no-delegated-source] [--rotate-missing-mail-keys]",
-        "  ouro connect [providers|perplexity|embeddings|teams|bluebubbles|mail|voice|a2a] [--agent <name>] [--owner-email <email> --source <label>|--no-delegated-source] [--rotate-missing-mail-keys]",
+        "  ouro connect [providers|perplexity|embeddings|teams|bluebubbles|mail|voice|a2a|workbench] [--agent <name>] [--owner-email <email> --source <label>|--no-delegated-source] [--rotate-missing-mail-keys]",
         "  ouro mail import-mbox --file <path> [--owner-email <email>] [--source <label>] [--agent <name>] [--foreground]",
         "  ouro mail backfill-indexes [--agent <name>] [--foreground]",
         "  ouro auth verify [--agent <name>] [--provider <provider>]",
@@ -114,6 +114,7 @@ function usage() {
         "  ouro friend create --name <name> [--trust <level>] [--agent <name>]",
         "  ouro friend update <id> --trust <level> [--agent <name>]",
         "  ouro thoughts [--last <n>] [--json] [--follow] [--agent <name>]",
+        "  ouro work card [--agent <name>] [--format text|json|--json]",
         "  ouro inner [--agent <name>]",
         "  ouro friend link <agent> --friend <id> --provider <p> --external-id <eid>",
         "  ouro friend unlink <agent> --friend <id> --provider <p> --external-id <eid>",
@@ -744,7 +745,9 @@ function normalizeConnectTarget(value) {
         return "voice";
     if (value === "a2a" || value === "agent2agent" || value === "agent-to-agent")
         return "a2a";
-    throw new Error("Usage: ouro connect [providers|perplexity|embeddings|teams|bluebubbles|mail|voice|a2a] [--agent <name>]");
+    if (value === "workbench" || value === "ouro-workbench" || value === "terminal-workbench")
+        return "workbench";
+    throw new Error("Usage: ouro connect [providers|perplexity|embeddings|teams|bluebubbles|mail|voice|a2a|workbench] [--agent <name>]");
 }
 function extractMailSourceFlags(args, usageText) {
     const rest = [];
@@ -797,7 +800,7 @@ function extractMailSourceFlags(args, usageText) {
     };
 }
 function parseConnectCommand(args) {
-    const usageText = "Usage: ouro connect [providers|perplexity|embeddings|teams|bluebubbles|mail|voice|a2a] [--agent <name>] [--owner-email <email> --source <label>|--no-delegated-source] [--rotate-missing-mail-keys]";
+    const usageText = "Usage: ouro connect [providers|perplexity|embeddings|teams|bluebubbles|mail|voice|a2a|workbench] [--agent <name>] [--owner-email <email> --source <label>|--no-delegated-source] [--rotate-missing-mail-keys]";
     const { agent, rest: afterAgent } = extractAgentFlag(args);
     const mailFlags = extractMailSourceFlags(afterAgent, usageText);
     if (mailFlags.rest.length > 1)
@@ -998,6 +1001,29 @@ function parseAttentionCommand(args) {
     }
     return { kind: "attention.list", ...(agent ? { agent } : {}) };
 }
+function parseWorkCommand(args) {
+    const { agent, rest: cleaned } = extractAgentFlag(args);
+    const sub = cleaned[0];
+    if (sub !== "card")
+        throw new Error("Usage: ouro work card [--agent <name>] [--format text|json|--json]");
+    let format = "text";
+    for (let i = 1; i < cleaned.length; i += 1) {
+        if (cleaned[i] === "--json") {
+            format = "json";
+            continue;
+        }
+        if (cleaned[i] === "--format" && cleaned[i + 1]) {
+            const value = cleaned[++i];
+            if (value !== "text" && value !== "json") {
+                throw new Error("--format must be text or json");
+            }
+            format = value;
+            continue;
+        }
+        throw new Error("Usage: ouro work card [--agent <name>] [--format text|json|--json]");
+    }
+    return { kind: "work.card", ...(agent ? { agent } : {}), ...(format !== "text" ? { format } : {}) };
+}
 function parseThoughtsCommand(args) {
     const { agent, rest: cleaned } = extractAgentFlag(args);
     let last;
@@ -1581,6 +1607,8 @@ function parseOuroCommand(args) {
         return parseThoughtsCommand(args.slice(1));
     if (head === "attention")
         return parseAttentionCommand(args.slice(1));
+    if (head === "work")
+        return parseWorkCommand(args.slice(1));
     if (head === "inner") {
         const { agent } = extractAgentFlag(args.slice(1));
         return { kind: "inner.status", ...(agent ? { agent } : {}) };

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

@@ -366,7 +366,7 @@ void daemon.start().then(() => {
                 habitsDir,
                 osCronManager,
                 onHabitFire: (habitName) => {
-                    processManager.sendToAgent(agent, { type: "habit", habitName });
+                    processManager.sendToAgent(agent, { type: "habit", habitName, trigger: "overdue" });
                 },
                 deps: {
                     readdir: (dir) => fs.readdirSync(dir),

package/dist/heart/daemon/daemon.js

@@ -1205,8 +1205,8 @@ class OuroDaemon {
                 return (0, agent_service_1.handleAgentDelegate)(command);
             case "agent.getContext":
                 return (0, agent_service_1.handleAgentGetContext)(command);
-            case "agent.searchNotes":
-                return (0, agent_service_1.handleAgentSearchNotes)(command);
+            case "agent.searchFacts":
+                return (0, agent_service_1.handleAgentSearchFacts)(command);
             case "agent.getTask":
                 return (0, agent_service_1.handleAgentGetTask)(command);
             case "agent.checkScope":
@@ -1298,7 +1298,7 @@ class OuroDaemon {
                 };
             }
             case "habit.poke": {
-                this.processManager.sendToAgent?.(command.agent, { type: "habit", habitName: command.habitName });
+                this.processManager.sendToAgent?.(command.agent, { type: "habit", habitName: command.habitName, trigger: "poke" });
                 return {
                     ok: true,
                     message: `poked habit ${command.habitName} for ${command.agent}`,

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

@@ -37,10 +37,11 @@ exports.bundleMetaHook = bundleMetaHook;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const runtime_1 = require("../../../nerves/runtime");
+const record_paths_1 = require("../../../mind/record-paths");
 /**
  * Migrate bundle from schema 1 to schema 2:
  * - Move state/{episodes,obligations,cares,intentions}/* to arc/{name}/*
- * - Move the old psyche note store to diary/
+ * - Move legacy record stores into desk/_record/
  * Idempotent: skips missing sources; on collision, newer mtime wins.
  */
 function migrateToSchema2(agentRoot) {
@@ -56,7 +57,7 @@ function migrateToSchema2(agentRoot) {
         const dest = path.join(agentRoot, "arc", name);
         migrateDirectory(src, dest);
     }
-    // Migrate diary from the old pre-diary bundle layout.
+    // Stage legacy diary files for schema 3 to canonicalize into Desk record.
     const legacyDiarySrc = path.join(agentRoot, "psyche", "mem" + "ory");
     const diaryDest = path.join(agentRoot, "diary");
     migrateDirectory(legacyDiarySrc, diaryDest);
@@ -70,7 +71,7 @@ function migrateToSchema2(agentRoot) {
     });
 }
 /**
- * Ensure bundle .gitignore has state/ ignored and does NOT ignore arc/, diary/, journal/.
+ * Ensure bundle .gitignore has state/ ignored and does NOT ignore tracked record roots.
  */
 function updateBundleGitignore(agentRoot) {
     const gitignorePath = path.join(agentRoot, ".gitignore");
@@ -83,8 +84,8 @@ function updateBundleGitignore(agentRoot) {
     catch {
         // If we can't read, start fresh
     }
-    // Remove arc/, diary/, journal/ from ignore (they should be tracked)
-    const toRemove = new Set(["arc/", "diary/", "journal/"]);
+    // Remove tracked bundle roots from ignore.
+    const toRemove = new Set(["arc/", "desk/", "diary/", "journal/"]);
     lines = lines.filter((line) => !toRemove.has(line.trim()));
     // Ensure state/ is in the ignore list
     const hasState = lines.some((line) => line.trim() === "state/");
@@ -100,6 +101,10 @@ function updateBundleGitignore(agentRoot) {
         // Non-blocking: if we can't write .gitignore, migration still succeeds
     }
 }
+function migrateToSchema3(agentRoot) {
+    (0, record_paths_1.migrateLegacyRecordStores)(agentRoot);
+    updateBundleGitignore(agentRoot);
+}
 /**
  * Recursively copy files from src to dest.
  * Creates destination directories as needed. Skips if source doesn't exist.
@@ -165,14 +170,29 @@ async function bundleMetaHook(ctx) {
         // Malformed JSON -- treat as missing, will overwrite with fresh
         existing = undefined;
     }
-    // Run schema-2 migration if needed
+    // Run schema migrations if needed.
     const currentSchema = existing?.bundleSchemaVersion ?? 1;
-    if (currentSchema < 2) {
-        migrateToSchema2(ctx.agentRoot);
+    try {
+        if (currentSchema < 2) {
+            migrateToSchema2(ctx.agentRoot);
+        }
+        if (currentSchema < 3) {
+            migrateToSchema3(ctx.agentRoot);
+        }
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : /* v8 ignore next -- defensive: non-Error catch branch @preserve */ String(err);
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.bundle_meta_hook_error",
+            message: "bundle-meta hook migration failed",
+            meta: { agentRoot: ctx.agentRoot, error: errorMessage },
+        });
+        return { ok: false, error: errorMessage };
     }
     const updated = {
         runtimeVersion: ctx.currentVersion,
-        bundleSchemaVersion: currentSchema < 2 ? 2 : currentSchema,
+        bundleSchemaVersion: currentSchema < 3 ? 3 : currentSchema,
         lastUpdated: new Date().toISOString(),
     };
     // Save old runtimeVersion as previousRuntimeVersion (if there was one)