titan-agent 6.5.2 → 7.0.0

package/dist/agent/goalSpec.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import logger from "../utils/logger.js";
+const COMPONENT = "GoalSpec";
+function titanHome() {
+  const env = process.env.TITAN_HOME;
+  if (env) return env.startsWith("~/") ? join(homedir(), env.slice(2)) : env;
+  return join(homedir(), ".titan");
+}
+function specMdPath(goalId) {
+  return join(titanHome(), "goals", goalId, "spec.md");
+}
+const PROMPT_RENDER_CAP = 4096;
+function specReadiness(spec) {
+  const total = spec.acceptance.length;
+  const met = spec.acceptance.filter((a) => a.status === "met").length;
+  const unmet = spec.acceptance.filter((a) => a.status === "unmet").length;
+  const unknown = spec.acceptance.filter((a) => a.status === "unknown").length;
+  const pct = total === 0 ? 0 : Math.round(met / total * 100);
+  return { total, met, unmet, unknown, pct, ready: total > 0 && met === total };
+}
+function readGoalSpec(goalId) {
+  const path = specMdPath(goalId);
+  if (!existsSync(path)) return null;
+  try {
+    return parseSpecMd(readFileSync(path, "utf-8"), goalId);
+  } catch (err) {
+    logger.warn(COMPONENT, `Failed to read spec for ${goalId}: ${err.message}`);
+    return null;
+  }
+}
+function writeGoalSpec(spec) {
+  const path = specMdPath(spec.goalId);
+  try {
+    mkdirSync(join(path, ".."), { recursive: true });
+  } catch {
+  }
+  spec.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  writeFileSync(path, renderSpecMd(spec), "utf-8");
+  const r = specReadiness(spec);
+  logger.info(COMPONENT, `Spec written for ${spec.goalId} (${r.met}/${r.total} acceptance met)`);
+}
+function setAcceptance(goalId, critId, status, evidence) {
+  const spec = readGoalSpec(goalId);
+  if (!spec) return null;
+  const crit = spec.acceptance.find((a) => a.id === critId);
+  if (!crit) return null;
+  crit.status = status;
+  if (typeof evidence === "string") crit.evidence = evidence;
+  writeGoalSpec(spec);
+  return spec;
+}
+function box(s) {
+  switch (s) {
+    case "met":
+      return "[x]";
+    case "unknown":
+      return "[?]";
+    case "unmet":
+    default:
+      return "[ ]";
+  }
+}
+function statusFromBox(b) {
+  switch (b) {
+    case "x":
+      return "met";
+    case "?":
+      return "unknown";
+    default:
+      return "unmet";
+  }
+}
+function renderList(items) {
+  return items.length === 0 ? ["_none_"] : items.map((i) => `- ${i}`);
+}
+function renderSpecMd(spec) {
+  const lines = [];
+  const r = specReadiness(spec);
+  lines.push(`# Spec \u2014 ${spec.title}`);
+  lines.push("");
+  lines.push(`**Goal id:** \`${spec.goalId}\``);
+  lines.push(`**Acceptance:** ${r.met}/${r.total} met (${r.pct}%)${r.ready ? " \u2705 ready" : ""}`);
+  lines.push(`**Updated:** ${spec.updatedAt}`);
+  lines.push("");
+  lines.push("## Problem");
+  lines.push(spec.problem.trim() || "_not stated_");
+  lines.push("");
+  lines.push("## Requirements");
+  lines.push(...renderList(spec.requirements));
+  lines.push("");
+  lines.push("## Acceptance Criteria");
+  if (spec.acceptance.length === 0) {
+    lines.push('_No acceptance criteria yet \u2014 agent should define "done" before executing._');
+  } else {
+    for (const a of spec.acceptance) {
+      lines.push(`- ${box(a.status)} \`${a.id}\` \u2014 ${a.text}`);
+      if (a.evidence) lines.push(`  > evidence: ${a.evidence}`);
+    }
+  }
+  lines.push("");
+  lines.push("## Constraints");
+  lines.push(...renderList(spec.constraints));
+  lines.push("");
+  lines.push("## Non-Goals");
+  lines.push(...renderList(spec.nonGoals));
+  lines.push("");
+  return lines.join("\n");
+}
+function parseSpecMd(raw, goalId) {
+  const lines = raw.split(/\r?\n/);
+  let title = goalId;
+  let updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const createdAt = updatedAt;
+  const problem = [];
+  const requirements = [];
+  const acceptance = [];
+  const constraints = [];
+  const nonGoals = [];
+  let section = "header";
+  let prevCrit = null;
+  const pushBullet = (line, into) => {
+    const m = line.trim().match(/^-\s+(.+)$/);
+    if (m && m[1] !== "_none_") {
+      into.push(m[1]);
+      return true;
+    }
+    return false;
+  };
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("# Spec \u2014 ")) {
+      title = trimmed.slice("# Spec \u2014 ".length).trim();
+      continue;
+    }
+    if (trimmed.startsWith("**Updated:**")) {
+      updatedAt = trimmed.replace("**Updated:**", "").trim();
+      continue;
+    }
+    if (trimmed.startsWith("**Goal id:**") || trimmed.startsWith("**Acceptance:**")) continue;
+    if (trimmed === "## Problem") {
+      section = "problem";
+      continue;
+    }
+    if (trimmed === "## Requirements") {
+      section = "requirements";
+      continue;
+    }
+    if (trimmed === "## Acceptance Criteria") {
+      section = "acceptance";
+      continue;
+    }
+    if (trimmed === "## Constraints") {
+      section = "constraints";
+      continue;
+    }
+    if (trimmed === "## Non-Goals") {
+      section = "nongoals";
+      continue;
+    }
+    switch (section) {
+      case "problem":
+        if (trimmed && trimmed !== "_not stated_") problem.push(line);
+        break;
+      case "requirements":
+        pushBullet(line, requirements);
+        break;
+      case "acceptance": {
+        const m = trimmed.match(/^-\s+\[([ xX?])\]\s+`([^`]+)`\s+—\s+(.+)$/);
+        if (m) {
+          const crit = { id: m[2], text: m[3], status: statusFromBox(m[1].toLowerCase()) };
+          acceptance.push(crit);
+          prevCrit = crit;
+          break;
+        }
+        const ev = line.match(/^\s{2,}>\s+evidence:\s+(.+)$/);
+        if (ev && prevCrit) prevCrit.evidence = ev[1];
+        break;
+      }
+      case "constraints":
+        pushBullet(line, constraints);
+        break;
+      case "nongoals":
+        pushBullet(line, nonGoals);
+        break;
+    }
+  }
+  return {
+    goalId,
+    title,
+    problem: problem.join("\n").trim(),
+    requirements,
+    acceptance,
+    constraints,
+    nonGoals,
+    createdAt,
+    updatedAt
+  };
+}
+function renderGoalSpecForPrompt(goalId) {
+  const spec = readGoalSpec(goalId);
+  if (!spec) return "";
+  const empty = !spec.problem.trim() && spec.requirements.length === 0 && spec.acceptance.length === 0;
+  if (empty) return "";
+  const md = renderSpecMd(spec);
+  return md.length <= PROMPT_RENDER_CAP ? md : md.slice(0, PROMPT_RENDER_CAP);
+}
+function __resetGoalSpecForTests(goalId) {
+  const path = specMdPath(goalId);
+  if (existsSync(path)) {
+    try {
+      unlinkSync(path);
+    } catch {
+    }
+  }
+}
+export {
+  __resetGoalSpecForTests,
+  parseSpecMd,
+  readGoalSpec,
+  renderGoalSpecForPrompt,
+  renderSpecMd,
+  setAcceptance,
+  specReadiness,
+  writeGoalSpec
+};
+//# sourceMappingURL=goalSpec.js.map

package/dist/agent/goalSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/agent/goalSpec.ts"],"sourcesContent":["/**\n * TITAN — Living spec.md per goal (spec-driven / context-engineering workflow).\n *\n * Why this exists\n * ---------------\n * The 2026 meta-shift (Anthropic Agentic Coding Trends; Addy Osmani) is from\n * prompting to *spec engineering*: the agent works against a written spec —\n * problem statement, requirements, and **checkable acceptance criteria** — and\n * that spec becomes persistent memory it references EVERY turn. The agent\n * doesn't declare a task done because it feels done; it declares done because\n * each acceptance criterion is marked `met` with evidence.\n *\n * This is the sibling of `goalPlanFile.ts`:\n *   - `plan.md`  = the *ladder of steps* (Manus recitation — \"what's next\").\n *   - `spec.md`  = the *definition of done* (acceptance criteria — \"are we there\").\n *\n * Stored at `~/.titan/goals/{goalId}/spec.md` next to `plan.md`, in the same\n * human-readable, greppable, hand-editable markdown so a person can drop in,\n * tighten an acceptance criterion, and the agent picks it up next turn. The\n * disk format and the prompt-injection format are deliberately identical.\n *\n * Reference:\n *   - Anthropic \"2026 Agentic Coding Trends\" (spec/context engineering)\n *   - Addy Osmani — specs + acceptance criteria as persistent agent memory\n *   - Pairs with `goalPlanFile.ts` (recitation) at the prompt recency position.\n */\nimport { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from 'fs';\nimport { join } from 'path';\nimport { homedir } from 'os';\nimport logger from '../utils/logger.js';\n\nconst COMPONENT = 'GoalSpec';\n\nfunction titanHome(): string {\n    const env = process.env.TITAN_HOME;\n    if (env) return env.startsWith('~/') ? join(homedir(), env.slice(2)) : env;\n    return join(homedir(), '.titan');\n}\nfunction specMdPath(goalId: string): string {\n    return join(titanHome(), 'goals', goalId, 'spec.md');\n}\n\n/** Whether an acceptance criterion has been satisfied. */\nexport type AcceptanceStatus = 'met' | 'unmet' | 'unknown';\n\nexport interface AcceptanceCriterion {\n    /** Stable id within the spec — e.g. `ac1`. */\n    id: string;\n    /** Testable statement — \"POST /v1 returns 401 without a token.\" */\n    text: string;\n    status: AcceptanceStatus;\n    /** How we know it's met/unmet — a test name, an observation, a log line. */\n    evidence?: string;\n}\n\nexport interface GoalSpec {\n    goalId: string;\n    title: string;\n    /** One-paragraph statement of the problem / desired outcome. */\n    problem: string;\n    /** What the solution must do. */\n    requirements: string[];\n    /** The definition of done — each independently checkable. */\n    acceptance: AcceptanceCriterion[];\n    /** Hard limits the solution must respect (perf, security, scope). */\n    constraints: string[];\n    /** Explicitly out of scope — guards against scope creep. */\n    nonGoals: string[];\n    createdAt: string;\n    updatedAt: string;\n}\n\nconst PROMPT_RENDER_CAP = 4096; // chars — mirrors promptSectionCaps.goalSpec\n\n/** Readiness rollup — the bar for \"is this goal actually done?\". */\nexport interface SpecReadiness {\n    total: number;\n    met: number;\n    unmet: number;\n    unknown: number;\n    /** Percent of criteria marked `met` (0–100, integer). */\n    pct: number;\n    /** True only when there is ≥1 criterion and ALL are `met`. */\n    ready: boolean;\n}\n\nexport function specReadiness(spec: GoalSpec): SpecReadiness {\n    const total = spec.acceptance.length;\n    const met = spec.acceptance.filter((a) => a.status === 'met').length;\n    const unmet = spec.acceptance.filter((a) => a.status === 'unmet').length;\n    const unknown = spec.acceptance.filter((a) => a.status === 'unknown').length;\n    const pct = total === 0 ? 0 : Math.round((met / total) * 100);\n    return { total, met, unmet, unknown, pct, ready: total > 0 && met === total };\n}\n\n/** Read the markdown back to a structured GoalSpec. Returns null if absent. */\nexport function readGoalSpec(goalId: string): GoalSpec | null {\n    const path = specMdPath(goalId);\n    if (!existsSync(path)) return null;\n    try {\n        return parseSpecMd(readFileSync(path, 'utf-8'), goalId);\n    } catch (err) {\n        logger.warn(COMPONENT, `Failed to read spec for ${goalId}: ${(err as Error).message}`);\n        return null;\n    }\n}\n\n/** Write a structured GoalSpec to markdown — replaces the whole file. */\nexport function writeGoalSpec(spec: GoalSpec): void {\n    const path = specMdPath(spec.goalId);\n    try { mkdirSync(join(path, '..'), { recursive: true }); } catch { /* exists */ }\n    spec.updatedAt = new Date().toISOString();\n    writeFileSync(path, renderSpecMd(spec), 'utf-8');\n    const r = specReadiness(spec);\n    logger.info(COMPONENT, `Spec written for ${spec.goalId} (${r.met}/${r.total} acceptance met)`);\n}\n\n/** Convenience — flip one acceptance criterion's status (+ optional evidence). */\nexport function setAcceptance(\n    goalId: string,\n    critId: string,\n    status: AcceptanceStatus,\n    evidence?: string,\n): GoalSpec | null {\n    const spec = readGoalSpec(goalId);\n    if (!spec) return null;\n    const crit = spec.acceptance.find((a) => a.id === critId);\n    if (!crit) return null;\n    crit.status = status;\n    if (typeof evidence === 'string') crit.evidence = evidence;\n    writeGoalSpec(spec);\n    return spec;\n}\n\nfunction box(s: AcceptanceStatus): string {\n    switch (s) {\n        case 'met':     return '[x]';\n        case 'unknown': return '[?]';\n        case 'unmet':\n        default:        return '[ ]';\n    }\n}\nfunction statusFromBox(b: string): AcceptanceStatus {\n    switch (b) {\n        case 'x': return 'met';\n        case '?': return 'unknown';\n        default:  return 'unmet';\n    }\n}\n\nfunction renderList(items: string[]): string[] {\n    return items.length === 0 ? ['_none_'] : items.map((i) => `- ${i}`);\n}\n\n/** Render the spec as markdown — disk format == prompt format. */\nexport function renderSpecMd(spec: GoalSpec): string {\n    const lines: string[] = [];\n    const r = specReadiness(spec);\n    lines.push(`# Spec — ${spec.title}`);\n    lines.push('');\n    lines.push(`**Goal id:** \\`${spec.goalId}\\``);\n    lines.push(`**Acceptance:** ${r.met}/${r.total} met (${r.pct}%)${r.ready ? ' ✅ ready' : ''}`);\n    lines.push(`**Updated:** ${spec.updatedAt}`);\n    lines.push('');\n    lines.push('## Problem');\n    lines.push(spec.problem.trim() || '_not stated_');\n    lines.push('');\n    lines.push('## Requirements');\n    lines.push(...renderList(spec.requirements));\n    lines.push('');\n    lines.push('## Acceptance Criteria');\n    if (spec.acceptance.length === 0) {\n        lines.push('_No acceptance criteria yet — agent should define \"done\" before executing._');\n    } else {\n        for (const a of spec.acceptance) {\n            lines.push(`- ${box(a.status)} \\`${a.id}\\` — ${a.text}`);\n            if (a.evidence) lines.push(`  > evidence: ${a.evidence}`);\n        }\n    }\n    lines.push('');\n    lines.push('## Constraints');\n    lines.push(...renderList(spec.constraints));\n    lines.push('');\n    lines.push('## Non-Goals');\n    lines.push(...renderList(spec.nonGoals));\n    lines.push('');\n    return lines.join('\\n');\n}\n\n/** Parse the markdown back into a structured spec. Tolerant of hand edits. */\nexport function parseSpecMd(raw: string, goalId: string): GoalSpec {\n    const lines = raw.split(/\\r?\\n/);\n    let title = goalId;\n    let updatedAt = new Date().toISOString();\n    const createdAt = updatedAt;\n    const problem: string[] = [];\n    const requirements: string[] = [];\n    const acceptance: AcceptanceCriterion[] = [];\n    const constraints: string[] = [];\n    const nonGoals: string[] = [];\n\n    let section: 'header' | 'problem' | 'requirements' | 'acceptance' | 'constraints' | 'nongoals' = 'header';\n    let prevCrit: AcceptanceCriterion | null = null;\n\n    const pushBullet = (line: string, into: string[]): boolean => {\n        const m = line.trim().match(/^-\\s+(.+)$/);\n        if (m && m[1] !== '_none_') { into.push(m[1]); return true; }\n        return false;\n    };\n\n    for (const line of lines) {\n        const trimmed = line.trim();\n        if (trimmed.startsWith('# Spec — ')) { title = trimmed.slice('# Spec — '.length).trim(); continue; }\n        if (trimmed.startsWith('**Updated:**')) { updatedAt = trimmed.replace('**Updated:**', '').trim(); continue; }\n        if (trimmed.startsWith('**Goal id:**') || trimmed.startsWith('**Acceptance:**')) continue;\n        if (trimmed === '## Problem') { section = 'problem'; continue; }\n        if (trimmed === '## Requirements') { section = 'requirements'; continue; }\n        if (trimmed === '## Acceptance Criteria') { section = 'acceptance'; continue; }\n        if (trimmed === '## Constraints') { section = 'constraints'; continue; }\n        if (trimmed === '## Non-Goals') { section = 'nongoals'; continue; }\n\n        switch (section) {\n            case 'problem':\n                if (trimmed && trimmed !== '_not stated_') problem.push(line);\n                break;\n            case 'requirements':\n                pushBullet(line, requirements);\n                break;\n            case 'acceptance': {\n                const m = trimmed.match(/^-\\s+\\[([ xX?])\\]\\s+`([^`]+)`\\s+—\\s+(.+)$/);\n                if (m) {\n                    const crit: AcceptanceCriterion = { id: m[2], text: m[3], status: statusFromBox(m[1].toLowerCase()) };\n                    acceptance.push(crit);\n                    prevCrit = crit;\n                    break;\n                }\n                const ev = line.match(/^\\s{2,}>\\s+evidence:\\s+(.+)$/);\n                if (ev && prevCrit) prevCrit.evidence = ev[1];\n                break;\n            }\n            case 'constraints':\n                pushBullet(line, constraints);\n                break;\n            case 'nongoals':\n                pushBullet(line, nonGoals);\n                break;\n        }\n    }\n\n    return {\n        goalId, title,\n        problem: problem.join('\\n').trim(),\n        requirements, acceptance, constraints, nonGoals,\n        createdAt, updatedAt,\n    };\n}\n\n/**\n * Prompt-friendly rendering for injection at the recency position. Returns\n * empty string when the spec doesn't exist or is effectively empty.\n */\nexport function renderGoalSpecForPrompt(goalId: string): string {\n    const spec = readGoalSpec(goalId);\n    if (!spec) return '';\n    const empty = !spec.problem.trim() && spec.requirements.length === 0 && spec.acceptance.length === 0;\n    if (empty) return '';\n    const md = renderSpecMd(spec);\n    return md.length <= PROMPT_RENDER_CAP ? md : md.slice(0, PROMPT_RENDER_CAP);\n}\n\n/** Test helper. */\nexport function __resetGoalSpecForTests(goalId: string): void {\n    const path = specMdPath(goalId);\n    if (existsSync(path)) { try { unlinkSync(path); } catch { /* fine */ } }\n}\n"],"mappings":"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","names":[]}

package/dist/agent/heartbeat.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+import { appendFileSync, existsSync, readFileSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { TITAN_HOME } from "../utils/constants.js";
+import { loadConfig } from "../config/config.js";
+import logger from "../utils/logger.js";
+import { titanEvents } from "./daemon.js";
+const COMPONENT = "Heartbeat";
+const NOTES_FILE = () => join(TITAN_HOME, "heartbeats.jsonl");
+const DEFAULT_INTERVAL_MS = 30 * 60 * 1e3;
+function latestHeartbeat() {
+  try {
+    const f = NOTES_FILE();
+    if (!existsSync(f)) return null;
+    const lines = readFileSync(f, "utf-8").trim().split("\n");
+    if (lines.length === 0) return null;
+    return JSON.parse(lines[lines.length - 1]);
+  } catch {
+    return null;
+  }
+}
+function speakNote(message) {
+  const note = { at: (/* @__PURE__ */ new Date()).toISOString(), message: message.slice(0, 200) };
+  persistNote(note);
+  try {
+    titanEvents.emit("heartbeat:note", note);
+  } catch {
+  }
+  return note;
+}
+function persistNote(note) {
+  try {
+    mkdirSync(dirname(NOTES_FILE()), { recursive: true });
+    appendFileSync(NOTES_FILE(), JSON.stringify(note) + "\n");
+  } catch (err) {
+    logger.warn(COMPONENT, `Could not persist note: ${err.message}`);
+  }
+}
+async function gatherContext() {
+  const parts = [];
+  const hour = (/* @__PURE__ */ new Date()).getHours();
+  parts.push(`Local time: ${(/* @__PURE__ */ new Date()).toLocaleString()} (hour ${hour}).`);
+  try {
+    const { readRecentAdvisories } = await import("./somaInitiative.js");
+    const advisories = readRecentAdvisories("default-user", 3);
+    if (advisories.length) {
+      parts.push(`Pending suggestions Soma has queued (never yet shown to the user): ${JSON.stringify(advisories).slice(0, 600)}`);
+    }
+  } catch {
+  }
+  try {
+    const { listAllDrivers } = await import("./goalDriver.js");
+    const all = listAllDrivers();
+    const active = all.filter((d) => !["done", "failed", "cancelled"].includes(d.phase)).length;
+    const cutoff = Date.now() - 6 * 36e5;
+    const recentDone = all.filter((d) => d.phase === "done" && new Date(d.history?.[d.history.length - 1]?.at ?? d.startedAt).getTime() >= cutoff).length;
+    if (active || recentDone) parts.push(`Missions: ${active} active, ${recentDone} finished in the last 6h.`);
+  } catch {
+  }
+  try {
+    const f = join(TITAN_HOME, "drive-state.json");
+    if (existsSync(f)) {
+      const raw = JSON.parse(readFileSync(f, "utf-8"));
+      if (raw.latest?.dominantDrives?.length) parts.push(`Current dominant drive: ${raw.latest.dominantDrives[0]}.`);
+    }
+  } catch {
+  }
+  const last = latestHeartbeat();
+  if (last) parts.push(`Your previous note (NEVER repeat it or anything close to it): "${last.message}" at ${last.at}.`);
+  return parts.join("\n");
+}
+async function runHeartbeat() {
+  const ctx = await gatherContext();
+  const { spawnSubAgent } = await import("./subAgent.js");
+  const result = await spawnSubAgent({
+    name: "heartbeat",
+    task: [
+      "You are TITAN's heartbeat \u2014 a quiet pulse deciding if ANYTHING is worth telling your human (Tony) right now, unprompted.",
+      "",
+      "WORLD STATE:",
+      ctx,
+      "",
+      "RULES:",
+      "- Default to silence. If there is nothing genuinely useful, timely, or delightful to say, reply with exactly: HEARTBEAT_OK \u2014 all quiet on the desk.",
+      `- Otherwise reply with ONE short, friendly, concrete message (max 140 characters) in TITAN's voice \u2014 a companion on the desk, not a notification system. No jargon, no "Soma", no markdown.`,
+      "- Worth speaking for: a finished mission he hasn't seen, a genuinely useful pending suggestion, something time-relevant. NOT worth it: status filler, greetings, anything resembling the previous note.",
+      "- Between 11pm and 7am local time, reply HEARTBEAT_OK unless something FINISHED."
+    ].join("\n"),
+    tier: "fast",
+    maxRounds: 1
+  });
+  const text = (result.content || "").trim();
+  if (!text || /HEARTBEAT_OK/i.test(text)) {
+    logger.debug(COMPONENT, "Beat: nothing to say (OK)");
+    return null;
+  }
+  const note = { at: (/* @__PURE__ */ new Date()).toISOString(), message: text.slice(0, 200) };
+  persistNote(note);
+  try {
+    titanEvents.emit("heartbeat:note", note);
+  } catch {
+  }
+  logger.info(COMPONENT, `Beat spoke: ${note.message}`);
+  return note;
+}
+function registerHeartbeat() {
+  try {
+    const cfg = loadConfig();
+    if (cfg.daemon?.enabled === false) {
+      logger.info(COMPONENT, "Daemon disabled \u2014 heartbeat not registered");
+      return;
+    }
+  } catch {
+  }
+  const interval = Number(process.env.TITAN_HEARTBEAT_MS) || DEFAULT_INTERVAL_MS;
+  import("./daemon.js").then(({ registerWatcher }) => {
+    registerWatcher("heartbeat", async () => {
+      await runHeartbeat();
+    }, interval);
+    logger.info(COMPONENT, `Heartbeat registered (every ${Math.round(interval / 6e4)}m)`);
+  }).catch((err) => logger.warn(COMPONENT, `Register failed: ${err.message}`));
+}
+export {
+  DEFAULT_INTERVAL_MS,
+  latestHeartbeat,
+  registerHeartbeat,
+  runHeartbeat,
+  speakNote
+};
+//# sourceMappingURL=heartbeat.js.map

package/dist/agent/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/agent/heartbeat.ts"],"sourcesContent":["/**\n * TITAN Heartbeat — the pulse that makes the agent ALIVE (v7.0).\n *\n * Modeled on what makes OpenClaw/Hermes feel inhabited: every ~30 minutes the\n * agent wakes, looks at its world (advisories, missions, drives, time of day),\n * and decides whether there is ONE thing worth telling its human right now.\n * If yes → a short note is persisted + announced (the mascot speaks it, and\n * it's available to any channel). If no → HEARTBEAT_OK, total silence.\n *\n * This is deliberately the opposite of a notification firehose: one fast-tier\n * LLM call per beat, one sentence max, silence is the default. The point is\n * that TITAN sometimes speaks FIRST — that single behavior separates a tool\n * you operate from a companion that lives on your machine.\n *\n * Model-agnostic (router tiers); never shells any CLI.\n */\nimport { appendFileSync, existsSync, readFileSync, mkdirSync } from 'fs';\nimport { join, dirname } from 'path';\nimport { TITAN_HOME } from '../utils/constants.js';\nimport { loadConfig } from '../config/config.js';\nimport logger from '../utils/logger.js';\nimport { titanEvents } from './daemon.js';\n\nconst COMPONENT = 'Heartbeat';\nconst NOTES_FILE = () => join(TITAN_HOME, 'heartbeats.jsonl');\nexport const DEFAULT_INTERVAL_MS = 30 * 60 * 1000;\n\nexport interface HeartbeatNote {\n    at: string;\n    message: string;\n}\n\nexport function latestHeartbeat(): HeartbeatNote | null {\n    try {\n        const f = NOTES_FILE();\n        if (!existsSync(f)) return null;\n        const lines = readFileSync(f, 'utf-8').trim().split('\\n');\n        if (lines.length === 0) return null;\n        return JSON.parse(lines[lines.length - 1]) as HeartbeatNote;\n    } catch {\n        return null;\n    }\n}\n\n/** Speak a note through the heartbeat channel (persist + emit) — the mascot\n *  polls /api/heartbeat/latest and says it. Used by the beat itself and by\n *  the reminder watcher, so reminders arrive as the companion speaking. */\nexport function speakNote(message: string): HeartbeatNote {\n    const note: HeartbeatNote = { at: new Date().toISOString(), message: message.slice(0, 200) };\n    persistNote(note);\n    try { titanEvents.emit('heartbeat:note', note); } catch { /* never fatal */ }\n    return note;\n}\n\nfunction persistNote(note: HeartbeatNote): void {\n    try {\n        mkdirSync(dirname(NOTES_FILE()), { recursive: true });\n        appendFileSync(NOTES_FILE(), JSON.stringify(note) + '\\n');\n    } catch (err) {\n        logger.warn(COMPONENT, `Could not persist note: ${(err as Error).message}`);\n    }\n}\n\n/** Gather the small world-snapshot the beat reasons over. All best-effort. */\nasync function gatherContext(): Promise<string> {\n    const parts: string[] = [];\n    const hour = new Date().getHours();\n    parts.push(`Local time: ${new Date().toLocaleString()} (hour ${hour}).`);\n\n    try {\n        const { readRecentAdvisories } = await import('./somaInitiative.js');\n        const advisories = readRecentAdvisories('default-user', 3);\n        if (advisories.length) {\n            parts.push(`Pending suggestions Soma has queued (never yet shown to the user): ${JSON.stringify(advisories).slice(0, 600)}`);\n        }\n    } catch { /* optional */ }\n\n    try {\n        const { listAllDrivers } = await import('./goalDriver.js');\n        const all = listAllDrivers();\n        const active = all.filter(d => !['done', 'failed', 'cancelled'].includes(d.phase)).length;\n        const cutoff = Date.now() - 6 * 3600_000;\n        const recentDone = all.filter(d => d.phase === 'done' && new Date(d.history?.[d.history.length - 1]?.at ?? d.startedAt).getTime() >= cutoff).length;\n        if (active || recentDone) parts.push(`Missions: ${active} active, ${recentDone} finished in the last 6h.`);\n    } catch { /* optional */ }\n\n    try {\n        const f = join(TITAN_HOME, 'drive-state.json');\n        if (existsSync(f)) {\n            const raw = JSON.parse(readFileSync(f, 'utf-8')) as { latest?: { dominantDrives?: string[] } };\n            if (raw.latest?.dominantDrives?.length) parts.push(`Current dominant drive: ${raw.latest.dominantDrives[0]}.`);\n        }\n    } catch { /* optional */ }\n\n    const last = latestHeartbeat();\n    if (last) parts.push(`Your previous note (NEVER repeat it or anything close to it): \"${last.message}\" at ${last.at}.`);\n    return parts.join('\\n');\n}\n\n/**\n * Run one beat. Returns the note when the agent chose to speak, else null.\n * Exposed for the manual POST /api/heartbeat/beat trigger + tests.\n */\nexport async function runHeartbeat(): Promise<HeartbeatNote | null> {\n    const ctx = await gatherContext();\n    const { spawnSubAgent } = await import('./subAgent.js');\n    const result = await spawnSubAgent({\n        name: 'heartbeat',\n        task: [\n            'You are TITAN\\'s heartbeat — a quiet pulse deciding if ANYTHING is worth telling your human (Tony) right now, unprompted.',\n            '',\n            'WORLD STATE:',\n            ctx,\n            '',\n            'RULES:',\n            '- Default to silence. If there is nothing genuinely useful, timely, or delightful to say, reply with exactly: HEARTBEAT_OK — all quiet on the desk.',\n            '- Otherwise reply with ONE short, friendly, concrete message (max 140 characters) in TITAN\\'s voice — a companion on the desk, not a notification system. No jargon, no \"Soma\", no markdown.',\n            '- Worth speaking for: a finished mission he hasn\\'t seen, a genuinely useful pending suggestion, something time-relevant. NOT worth it: status filler, greetings, anything resembling the previous note.',\n            '- Between 11pm and 7am local time, reply HEARTBEAT_OK unless something FINISHED.',\n        ].join('\\n'),\n        tier: 'fast',\n        maxRounds: 1,\n    });\n\n    const text = (result.content || '').trim();\n    if (!text || /HEARTBEAT_OK/i.test(text)) {\n        logger.debug(COMPONENT, 'Beat: nothing to say (OK)');\n        return null;\n    }\n    const note: HeartbeatNote = { at: new Date().toISOString(), message: text.slice(0, 200) };\n    persistNote(note);\n    try { titanEvents.emit('heartbeat:note', note); } catch { /* never fatal */ }\n    logger.info(COMPONENT, `Beat spoke: ${note.message}`);\n    return note;\n}\n\n/** Register the beat on the daemon. Gated on daemon.enabled (same lifecycle). */\nexport function registerHeartbeat(): void {\n    try {\n        const cfg = loadConfig() as { daemon?: { enabled?: boolean } };\n        if (cfg.daemon?.enabled === false) {\n            logger.info(COMPONENT, 'Daemon disabled — heartbeat not registered');\n            return;\n        }\n    } catch { /* config unavailable — register anyway, daemon gates execution */ }\n    const interval = Number(process.env.TITAN_HEARTBEAT_MS) || DEFAULT_INTERVAL_MS;\n    import('./daemon.js').then(({ registerWatcher }) => {\n        registerWatcher('heartbeat', async () => { await runHeartbeat(); }, interval);\n        logger.info(COMPONENT, `Heartbeat registered (every ${Math.round(interval / 60000)}m)`);\n    }).catch(err => logger.warn(COMPONENT, `Register failed: ${(err as Error).message}`));\n}\n"],"mappings":"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","names":[]}

package/dist/agent/missionDecompose.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+const MAX_SUBTASKS = 6;
+const TITLE_CAP = 80;
+const DESC_CAP = 280;
+function mapDependsOn(raw, index, total) {
+  if (!Array.isArray(raw)) return void 0;
+  const deps = Array.from(
+    new Set(
+      raw.map((d) => typeof d === "number" ? d : parseInt(String(d).replace(/^st-/i, ""), 10)).filter((n) => Number.isInteger(n) && n >= 1 && n < index + 1 && n <= total).map((n) => `st-${n}`)
+    )
+  );
+  return deps.length ? deps : void 0;
+}
+function parseMissionSubtasks(rawText) {
+  const raw = (rawText || "").trim();
+  const jsonStart = raw.indexOf("{");
+  const jsonEnd = raw.lastIndexOf("}");
+  if (jsonStart < 0 || jsonEnd <= jsonStart) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw.slice(jsonStart, jsonEnd + 1));
+  } catch {
+    return void 0;
+  }
+  if (!Array.isArray(parsed.subtasks) || parsed.subtasks.length < 1) return void 0;
+  const clean = parsed.subtasks.filter((s) => typeof s?.title === "string" && typeof s?.description === "string").slice(0, MAX_SUBTASKS);
+  if (clean.length < 1) return void 0;
+  return clean.map((s, i) => ({
+    title: String(s.title).slice(0, TITLE_CAP),
+    description: String(s.description).slice(0, DESC_CAP),
+    dependsOn: mapDependsOn(s.dependsOn, i, clean.length)
+  }));
+}
+export {
+  mapDependsOn,
+  parseMissionSubtasks
+};
+//# sourceMappingURL=missionDecompose.js.map

package/dist/agent/missionDecompose.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/agent/missionDecompose.ts"],"sourcesContent":["/**\n * Mission decomposition parsing.\n *\n * Turns the raw LLM response from the mission-decomposer sub-agent into the\n * `{ title, description, dependsOn? }` subtask shape `createGoal` expects.\n *\n * Pulled out of the gateway handler so the (fiddly) JSON extraction + the\n * dependency-edge mapping are pure and unit-testable. The mapping is the part\n * that matters for the visual workflow builder: the model emits dependsOn as\n * 1-based positions, and we map them to the `st-<n>` ids createGoal assigns —\n * keeping ONLY valid backward edges so the result is always an acyclic DAG.\n */\n\nexport interface DecomposedSubtask {\n    title: string;\n    description: string;\n    dependsOn?: string[];\n}\n\ninterface RawSubtask {\n    title?: unknown;\n    description?: unknown;\n    dependsOn?: Array<number | string>;\n}\n\nconst MAX_SUBTASKS = 6;\nconst TITLE_CAP = 80;\nconst DESC_CAP = 280;\n\n/**\n * Map a model-provided dependsOn list (1-based positions, or \"st-N\"/\"N\"\n * strings) to `st-<n>` ids, keeping only BACKWARD references (a subtask may\n * only depend on an EARLIER one). Dedupes and drops anything out of range.\n *\n * @param raw      the dependsOn value the model emitted for this subtask\n * @param index    0-based index of the current subtask\n * @param total    total number of (cleaned) subtasks\n */\nexport function mapDependsOn(raw: unknown, index: number, total: number): string[] | undefined {\n    if (!Array.isArray(raw)) return undefined;\n    const deps = Array.from(\n        new Set(\n            raw\n                .map(d => (typeof d === 'number' ? d : parseInt(String(d).replace(/^st-/i, ''), 10)))\n                .filter(n => Number.isInteger(n) && n >= 1 && n < index + 1 && n <= total)\n                .map(n => `st-${n}`),\n        ),\n    );\n    return deps.length ? deps : undefined;\n}\n\n/**\n * Extract the first JSON object from raw LLM text (tolerating prose/markdown\n * around it) and normalize its `subtasks` into the createGoal shape. Returns\n * `undefined` when no usable subtasks can be parsed (caller then creates a\n * goal with no subtasks).\n */\nexport function parseMissionSubtasks(rawText: string): DecomposedSubtask[] | undefined {\n    const raw = (rawText || '').trim();\n    const jsonStart = raw.indexOf('{');\n    const jsonEnd = raw.lastIndexOf('}');\n    if (jsonStart < 0 || jsonEnd <= jsonStart) return undefined;\n\n    let parsed: { subtasks?: RawSubtask[] };\n    try {\n        parsed = JSON.parse(raw.slice(jsonStart, jsonEnd + 1)) as { subtasks?: RawSubtask[] };\n    } catch {\n        return undefined;\n    }\n    if (!Array.isArray(parsed.subtasks) || parsed.subtasks.length < 1) return undefined;\n\n    const clean = parsed.subtasks\n        .filter(s => typeof s?.title === 'string' && typeof s?.description === 'string')\n        .slice(0, MAX_SUBTASKS);\n    if (clean.length < 1) return undefined;\n\n    return clean.map((s, i) => ({\n        title: String(s.title).slice(0, TITLE_CAP),\n        description: String(s.description).slice(0, DESC_CAP),\n        dependsOn: mapDependsOn(s.dependsOn, i, clean.length),\n    }));\n}\n"],"mappings":";AAyBA,MAAM,eAAe;AACrB,MAAM,YAAY;AAClB,MAAM,WAAW;AAWV,SAAS,aAAa,KAAc,OAAe,OAAqC;AAC3F,MAAI,CAAC,MAAM,QAAQ,GAAG,EAAG,QAAO;AAChC,QAAM,OAAO,MAAM;AAAA,IACf,IAAI;AAAA,MACA,IACK,IAAI,OAAM,OAAO,MAAM,WAAW,IAAI,SAAS,OAAO,CAAC,EAAE,QAAQ,SAAS,EAAE,GAAG,EAAE,CAAE,EACnF,OAAO,OAAK,OAAO,UAAU,CAAC,KAAK,KAAK,KAAK,IAAI,QAAQ,KAAK,KAAK,KAAK,EACxE,IAAI,OAAK,MAAM,CAAC,EAAE;AAAA,IAC3B;AAAA,EACJ;AACA,SAAO,KAAK,SAAS,OAAO;AAChC;AAQO,SAAS,qBAAqB,SAAkD;AACnF,QAAM,OAAO,WAAW,IAAI,KAAK;AACjC,QAAM,YAAY,IAAI,QAAQ,GAAG;AACjC,QAAM,UAAU,IAAI,YAAY,GAAG;AACnC,MAAI,YAAY,KAAK,WAAW,UAAW,QAAO;AAElD,MAAI;AACJ,MAAI;AACA,aAAS,KAAK,MAAM,IAAI,MAAM,WAAW,UAAU,CAAC,CAAC;AAAA,EACzD,QAAQ;AACJ,WAAO;AAAA,EACX;AACA,MAAI,CAAC,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,SAAS,EAAG,QAAO;AAE1E,QAAM,QAAQ,OAAO,SAChB,OAAO,OAAK,OAAO,GAAG,UAAU,YAAY,OAAO,GAAG,gBAAgB,QAAQ,EAC9E,MAAM,GAAG,YAAY;AAC1B,MAAI,MAAM,SAAS,EAAG,QAAO;AAE7B,SAAO,MAAM,IAAI,CAAC,GAAG,OAAO;AAAA,IACxB,OAAO,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;AAAA,IACzC,aAAa,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ;AAAA,IACpD,WAAW,aAAa,EAAE,WAAW,GAAG,MAAM,MAAM;AAAA,EACxD,EAAE;AACN;","names":[]}