@ouro.bot/cli 0.1.0-alpha.657 → 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";
@@ -7277,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") {
@@ -7286,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");
@@ -7295,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 {
@@ -7342,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).",

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

@@ -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>",
@@ -1000,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;
@@ -1583,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)

package/dist/heart/daemon/inner-status.js

@@ -24,7 +24,7 @@ function formatCadence(cadenceMs) {
     return `${minutes}m`;
 }
 function buildInnerStatusOutput(input) {
-    const { agentName, runtimeState, journalFiles, heartbeat, attentionCount, now } = input;
+    const { agentName, runtimeState, recordSummary, heartbeat, attentionCount, now } = input;
     const lines = [];
     lines.push(`inner dialog status: ${agentName}`);
     // Last turn
@@ -58,19 +58,7 @@ function buildInnerStatusOutput(input) {
     else {
         lines.push("  heartbeat: unknown");
     }
-    // Journal
-    if (journalFiles.length === 0) {
-        lines.push("  journal: (empty)");
-    }
-    else {
-        lines.push("  journal:");
-        const sorted = [...journalFiles].sort((a, b) => b.mtimeMs - a.mtimeMs);
-        for (const file of sorted) {
-            const elapsed = now - file.mtimeMs;
-            const relativeTime = formatRelativeTime(elapsed);
-            lines.push(`    - ${file.name} (${relativeTime})`);
-        }
-    }
+    lines.push(`  Desk record: ${recordSummary.diaryFactCount} diary facts, ${recordSummary.noteCount} notes`);
     // Attention
     const thoughtWord = attentionCount === 1 ? "thought" : "thoughts";
     lines.push(`  attention: ${attentionCount} held ${thoughtWord}`);
@@ -81,7 +69,8 @@ function buildInnerStatusOutput(input) {
         meta: {
             agentName,
             status: runtimeState?.status ?? "unknown",
-            journalCount: journalFiles.length,
+            diaryFactCount: recordSummary.diaryFactCount,
+            noteCount: recordSummary.noteCount,
             attentionCount,
         },
     });

package/dist/heart/habits/habit-parser.js

@@ -57,6 +57,53 @@ function parseToolsField(raw) {
     }
     return undefined;
 }
+function objectRecord(raw) {
+    return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : null;
+}
+function stringField(record, key) {
+    const value = record[key];
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function booleanField(record, key, fallback) {
+    const value = record[key];
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        if (value === "true")
+            return true;
+        if (value === "false")
+            return false;
+    }
+    return fallback;
+}
+function parseStringArray(raw) {
+    if (typeof raw === "string" && raw.startsWith("[") && raw.endsWith("]")) {
+        const inner = raw.slice(1, -1);
+        if (!inner.trim())
+            return [];
+        return inner.split(",").map((item) => item.trim()).filter(Boolean);
+    }
+    return [];
+}
+function parseOrigin(raw) {
+    const record = objectRecord(raw);
+    if (!record)
+        return null;
+    const friendId = stringField(record, "friendId");
+    const channel = stringField(record, "channel");
+    const key = stringField(record, "key");
+    if (!friendId || !channel || !key)
+        return null;
+    return { friendId, channel, key };
+}
+function parseSurface(raw) {
+    const record = objectRecord(raw);
+    return {
+        family: record ? booleanField(record, "family", true) : true,
+        originator: record ? booleanField(record, "originator", true) : true,
+        extra: record ? parseStringArray(record.extra) : [],
+    };
+}
 function extractFrontmatterAndBody(content) {
     const lines = content.split(/\r?\n/);
     if (lines[0]?.trim() !== "---") {
@@ -88,6 +135,8 @@ function parseHabitFile(content, filePath) {
             lastRun: null,
             created: null,
             tools: undefined,
+            origin: null,
+            surface: { family: true, originator: true, extra: [] },
             body: content.trim(),
         };
     }
@@ -103,6 +152,8 @@ function parseHabitFile(content, filePath) {
     const rawCreated = frontmatter.created;
     const created = typeof rawCreated === "string" && rawCreated.length > 0 ? rawCreated : null;
     const tools = parseToolsField(frontmatter.tools);
+    const origin = parseOrigin(frontmatter.origin);
+    const surface = parseSurface(frontmatter.surface);
     return {
         name: stem,
         title,
@@ -111,6 +162,8 @@ function parseHabitFile(content, filePath) {
         lastRun,
         created,
         tools,
+        origin,
+        surface,
         body,
     };
 }
@@ -121,6 +174,16 @@ function formatFrontmatterValue(value) {
         return `[${value.join(", ")}]`;
     return String(value);
 }
+function renderFrontmatterLine(lines, key, value) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        lines.push(`${key}:`);
+        for (const [childKey, childValue] of Object.entries(value)) {
+            lines.push(`  ${childKey}: ${formatFrontmatterValue(childValue)}`);
+        }
+        return;
+    }
+    lines.push(`${key}: ${formatFrontmatterValue(value)}`);
+}
 function renderHabitFile(frontmatter, body) {
     (0, runtime_1.emitNervesEvent)({
         event: "daemon.habit_render",
@@ -130,7 +193,7 @@ function renderHabitFile(frontmatter, body) {
     });
     const lines = ["---"];
     for (const key of Object.keys(frontmatter)) {
-        lines.push(`${key}: ${formatFrontmatterValue(frontmatter[key])}`);
+        renderFrontmatterLine(lines, key, frontmatter[key]);
     }
     lines.push("---");
     lines.push("");

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

@@ -44,6 +44,8 @@ const runtime_1 = require("../../nerves/runtime");
 const auth_flow_1 = require("../auth/auth-flow");
 const provider_models_1 = require("../provider-models");
 const habit_parser_1 = require("../habits/habit-parser");
+const bundle_manifest_1 = require("../../mind/bundle-manifest");
+const record_paths_1 = require("../../mind/record-paths");
 const hatch_specialist_1 = require("./hatch-specialist");
 function requiredCredentialKeys(provider) {
     return identity_1.PROVIDER_CREDENTIALS[provider].required;
@@ -83,7 +85,7 @@ function writeHeartbeatHabit(bundleRoot, now) {
         cadence: "30m",
         status: "active",
         created: now.toISOString(),
-    }, "Run a lightweight heartbeat cycle. Review task board and inbox.\nCheck on pending obligations. Journal anything important.");
+    }, "Run a lightweight heartbeat cycle. Review task board and inbox.\nCheck on pending obligations. Write important durable outputs to Arc or Desk record.");
     fs.writeFileSync(filePath, content, "utf-8");
 }
 function writeFriendImprint(bundleRoot, humanName, now) {
@@ -115,12 +117,15 @@ function writeFriendImprint(bundleRoot, humanName, now) {
     };
     fs.writeFileSync(path.join(friendsDir, `${id}.json`), `${JSON.stringify(record, null, 2)}\n`, "utf-8");
 }
-function writeDiaryScaffold(bundleRoot) {
-    const diaryRoot = path.join(bundleRoot, "diary");
-    fs.mkdirSync(path.join(diaryRoot, "daily"), { recursive: true });
-    fs.mkdirSync(path.join(diaryRoot, "archive"), { recursive: true });
-    fs.writeFileSync(path.join(diaryRoot, "facts.jsonl"), "", "utf-8");
-    fs.writeFileSync(path.join(diaryRoot, "entities.json"), "{}\n", "utf-8");
+function writeRecordScaffold(bundleRoot) {
+    const recordPaths = (0, record_paths_1.resolveDeskRecordPaths)(bundleRoot);
+    fs.mkdirSync(recordPaths.diaryDailyDir, { recursive: true });
+    fs.mkdirSync(recordPaths.notesRoot, { recursive: true });
+    fs.writeFileSync(recordPaths.factsPath, "", "utf-8");
+    fs.writeFileSync(recordPaths.entitiesPath, "{}\n", "utf-8");
+    fs.mkdirSync(path.join(bundleRoot, "arc", "flight-recorder", "events"), { recursive: true });
+    fs.mkdirSync(path.join(bundleRoot, "arc", "flight-recorder", "habit-receipts"), { recursive: true });
+    fs.mkdirSync(path.join(bundleRoot, "arc", "claims"), { recursive: true });
 }
 function writeHatchlingAgentConfig(bundleRoot, input) {
     const template = (0, identity_1.buildDefaultAgentTemplate)(input.agentName);
@@ -156,7 +161,9 @@ 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 have learned and chosen to keep.");
+    writeReadme(path.join(bundleRoot, "arc"), "Live continuity, claims, obligations, and resume state.");
+    writeReadme(path.join(bundleRoot, "desk"), "Durable work and maintained record.");
+    writeReadme(path.join(bundleRoot, "desk", "_record"), "Desk record: diary facts and maintained reference 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.");
@@ -166,8 +173,9 @@ async function runHatchFlow(input, deps = {}) {
     writeReadme(path.join(bundleRoot, "senses"), "Sense-specific config.");
     writeReadme(path.join(bundleRoot, "senses", "teams"), "Teams sense config.");
     writeHatchlingAgentConfig(bundleRoot, input);
+    fs.writeFileSync(path.join(bundleRoot, "bundle-meta.json"), `${JSON.stringify((0, bundle_manifest_1.createBundleMeta)(), null, 2)}\n`, "utf-8");
     const credentialPath = await storeHatchlingProviderCredentials(input.agentName, input.provider, input.credentials);
-    writeDiaryScaffold(bundleRoot);
+    writeRecordScaffold(bundleRoot);
     writeFriendImprint(bundleRoot, input.humanName, now);
     writeHeartbeatHabit(bundleRoot, now);
     (0, runtime_1.emitNervesEvent)({

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

@@ -41,6 +41,7 @@ const tools_base_1 = require("../../repertoire/tools-base");
 const hatch_flow_1 = require("./hatch-flow");
 const hatch_animation_1 = require("./hatch-animation");
 const bundle_manifest_1 = require("../../mind/bundle-manifest");
+const record_paths_1 = require("../../mind/record-paths");
 const identity_1 = require("../identity");
 const runtime_1 = require("../../nerves/runtime");
 const vault_setup_1 = require("../../repertoire/vault-setup");
@@ -107,9 +108,10 @@ function writeReadme(dir, purpose) {
     }
 }
 function scaffoldBundle(bundleRoot) {
-    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, "arc"), "Live continuity, claims, obligations, and resume state.");
+    writeReadme(path.join(bundleRoot, "arc", "flight-recorder"), "Flight recorder resume and event receipts.");
+    writeReadme(path.join(bundleRoot, "desk"), "Durable work and maintained record.");
+    writeReadme(path.join(bundleRoot, "desk", "_record"), "Desk record: diary facts and maintained reference 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.");
@@ -118,16 +120,18 @@ 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.");
-    // Notes scaffold files
-    const notesRoot = path.join(bundleRoot, "notes");
-    const factsPath = path.join(notesRoot, "facts.jsonl");
-    const entitiesPath = path.join(notesRoot, "entities.json");
+    const recordPaths = (0, record_paths_1.resolveDeskRecordPaths)(bundleRoot);
+    fs.mkdirSync(recordPaths.diaryDailyDir, { recursive: true });
+    fs.mkdirSync(recordPaths.notesRoot, { recursive: true });
     /* v8 ignore next -- defensive: guard against re-scaffold on existing bundle @preserve */
-    if (!fs.existsSync(factsPath))
-        fs.writeFileSync(factsPath, "", "utf-8");
+    if (!fs.existsSync(recordPaths.factsPath))
+        fs.writeFileSync(recordPaths.factsPath, "", "utf-8");
     /* v8 ignore next -- defensive: guard against re-scaffold on existing bundle @preserve */
-    if (!fs.existsSync(entitiesPath))
-        fs.writeFileSync(entitiesPath, "{}\n", "utf-8");
+    if (!fs.existsSync(recordPaths.entitiesPath))
+        fs.writeFileSync(recordPaths.entitiesPath, "{}\n", "utf-8");
+    fs.mkdirSync(path.join(bundleRoot, "arc", "flight-recorder", "events"), { recursive: true });
+    fs.mkdirSync(path.join(bundleRoot, "arc", "flight-recorder", "habit-receipts"), { recursive: true });
+    fs.mkdirSync(path.join(bundleRoot, "arc", "claims"), { recursive: true });
     // bundle-meta.json
     const meta = (0, bundle_manifest_1.createBundleMeta)();
     fs.writeFileSync(path.join(bundleRoot, "bundle-meta.json"), JSON.stringify(meta, null, 2) + "\n", "utf-8");