@cgh567/agent 2.4.2 → 2.4.3

package/lib/hbo-core-store.compiled.js

@@ -0,0 +1,834 @@
+/**
+ * hbo-core-store.compiled.js
+ * Pre-compiled CJS version of hbo-core-store.ts — no TypeScript runtime required.
+ *
+ * Generated from hbo-core-store.ts by stripping type annotations.
+ * This file ships in the npm tarball so the store loads on Node 16+ without
+ * jiti, ts-node, or --experimental-sqlite (uses better-sqlite3 as fallback).
+ * node:sqlite is used when available (Node >= 22.13 without flags, or
+ * Node >= 22.5 with --experimental-sqlite).
+ *
+ * DO NOT EDIT this file directly. Edit hbo-core-store.ts and regenerate.
+ * Regenerate with: node -e "require('./lib/hbo-core-store.js')" (uses native strip path)
+ */
+'use strict';
+
+const path = require('path');
+const os = require('os');
+const { mkdirSync } = require('fs');
+
+// ---------------------------------------------------------------------------
+// Engine detection — node:sqlite (Node 22+) preferred, better-sqlite3 fallback
+// ---------------------------------------------------------------------------
+
+let _engine = null;
+
+function _openDatabase(dbPath) {
+  // Attempt 1: node:sqlite built-in (Node >= 22.13 no flags needed; Node >= 22.5 with --experimental-sqlite)
+  try {
+    const { DatabaseSync } = require('node:sqlite');
+    const db = new DatabaseSync(dbPath);
+    _engine = 'node-sqlite';
+    return db;
+  } catch (_nodeSqliteErr) {
+    // node:sqlite unavailable (Node < 22.13 without flag, or Node < 22.5)
+  }
+
+  // Attempt 2: better-sqlite3 — synchronous, compiled native module, Node >= 16
+  try {
+    const BetterSqlite3 = require('better-sqlite3');
+    const db = new BetterSqlite3(dbPath);
+    _engine = 'better-sqlite3';
+    return db;
+  } catch (_betterSqliteErr) {
+    // better-sqlite3 unavailable (native build failed or not installed)
+  }
+
+  throw new Error(
+    '[hbo-core-store] No SQLite engine available. ' +
+    'Requires Node >= 22.13 (no flags) or Node >= 22.5 with --experimental-sqlite, ' +
+    'OR better-sqlite3 installed. Run: npm install better-sqlite3'
+  );
+}
+
+// ---------------------------------------------------------------------------
+// DB singleton
+// ---------------------------------------------------------------------------
+
+let _db = null;
+
+function getDb() {
+  if (_db) return _db;
+
+  const dbPath = path.join(
+    process.env.HELIOS_ROOT || path.join(os.homedir(), 'helios-agent'),
+    'data',
+    'hbo-core.db',
+  );
+
+  mkdirSync(path.join(dbPath, '..'), { recursive: true });
+
+  _db = _openDatabase(dbPath);
+
+  // WAL mode for concurrent readers + single writer.
+  // node:sqlite uses .exec('PRAGMA ...'); better-sqlite3 uses .pragma('...')
+  if (_engine === 'better-sqlite3') {
+    _db.pragma('journal_mode = WAL');
+    _db.pragma('foreign_keys = ON');
+  } else {
+    _db.exec('PRAGMA journal_mode = WAL');
+    _db.exec('PRAGMA foreign_keys = ON');
+  }
+
+  initSchema(_db);
+  return _db;
+}
+
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+
+function initSchema(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS tasks (
+      id                   TEXT    PRIMARY KEY,
+      company_id           TEXT    NOT NULL,
+      title                TEXT,
+      status               TEXT,
+      assignee_agent_id    TEXT,
+      goal_id              TEXT,
+      origin_kind          TEXT,
+      helios_issue_id      TEXT,
+      execution_locked_at  INTEGER,
+      created_at           INTEGER,
+      updated_at           INTEGER,
+      data_json            TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_tasks_company_status ON tasks(company_id, status);
+    CREATE INDEX IF NOT EXISTS idx_tasks_assignee       ON tasks(assignee_agent_id, company_id);
+
+    CREATE TABLE IF NOT EXISTS approvals (
+      id            TEXT    PRIMARY KEY,
+      company_id    TEXT    NOT NULL,
+      type          TEXT,
+      status        TEXT,
+      strategy_id   TEXT,
+      requested_by  TEXT,
+      created_at    INTEGER,
+      updated_at    INTEGER,
+      data_json     TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_approvals_company_status ON approvals(company_id, status);
+
+    CREATE TABLE IF NOT EXISTS budget_policies (
+      id            TEXT    PRIMARY KEY,
+      company_id    TEXT    NOT NULL,
+      agent_id      TEXT,
+      spent_cents   INTEGER DEFAULT 0,
+      percent_used  REAL    DEFAULT 0,
+      updated_at    INTEGER,
+      data_json     TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_budget_company_agent ON budget_policies(company_id, agent_id);
+
+    CREATE TABLE IF NOT EXISTS cost_events (
+      id          TEXT    PRIMARY KEY,
+      company_id  TEXT    NOT NULL,
+      agent_id    TEXT,
+      feature     TEXT,
+      model       TEXT,
+      amount_usd  REAL,
+      created_at  INTEGER,
+      data_json   TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_cost_company ON cost_events(company_id, created_at);
+
+    CREATE TABLE IF NOT EXISTS business_agents (
+      id               TEXT    PRIMARY KEY,
+      company_id       TEXT    NOT NULL,
+      role             TEXT,
+      status           TEXT,
+      current_task_id  TEXT,
+      skill            TEXT,
+      adapter          TEXT,
+      updated_at       INTEGER,
+      data_json        TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_agents_company_status ON business_agents(company_id, status);
+
+    CREATE TABLE IF NOT EXISTS okrs (
+      id          TEXT    PRIMARY KEY,
+      company_id  TEXT    NOT NULL,
+      type        TEXT,
+      status      TEXT,
+      title       TEXT,
+      updated_at  INTEGER,
+      data_json   TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_okrs_company_type ON okrs(company_id, type, status);
+
+    CREATE TABLE IF NOT EXISTS goals (
+      id          TEXT    PRIMARY KEY,
+      company_id  TEXT    NOT NULL,
+      title       TEXT,
+      description TEXT,
+      level       TEXT,
+      status      TEXT,
+      parent_id   TEXT,
+      created_at  INTEGER,
+      updated_at  INTEGER,
+      data_json   TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_goals_company_status ON goals(company_id, status);
+    CREATE INDEX IF NOT EXISTS idx_goals_parent ON goals(company_id, parent_id);
+
+    CREATE TABLE IF NOT EXISTS leads (
+      id          TEXT    PRIMARY KEY,
+      company_id  TEXT    NOT NULL,
+      status      TEXT,
+      email       TEXT,
+      name        TEXT,
+      updated_at  INTEGER,
+      data_json   TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_leads_company_status ON leads(company_id, status);
+
+    CREATE TABLE IF NOT EXISTS crm_contacts (
+      id          TEXT    PRIMARY KEY,
+      company_id  TEXT    NOT NULL,
+      email       TEXT,
+      name        TEXT,
+      updated_at  INTEGER,
+      data_json   TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_crm_company ON crm_contacts(company_id);
+
+    CREATE TABLE IF NOT EXISTS accounts (
+      id          TEXT    PRIMARY KEY,
+      company_id  TEXT    NOT NULL,
+      name        TEXT,
+      updated_at  INTEGER,
+      data_json   TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS opportunities (
+      id          TEXT    PRIMARY KEY,
+      company_id  TEXT    NOT NULL,
+      title       TEXT,
+      status      TEXT,
+      updated_at  INTEGER,
+      data_json   TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS helios_projects (
+      id          TEXT    PRIMARY KEY,
+      company_id  TEXT    NOT NULL,
+      name        TEXT,
+      pillar_id   TEXT,
+      goal_id     TEXT,
+      status      TEXT,
+      phase       TEXT,
+      created_at  INTEGER,
+      updated_at  INTEGER,
+      data_json   TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_helios_projects_company ON helios_projects(company_id, status);
+
+    CREATE TABLE IF NOT EXISTS project_documents (
+      id            TEXT    PRIMARY KEY,
+      project_id    TEXT    NOT NULL,
+      company_id    TEXT,
+      purpose       TEXT,
+      approach      TEXT,
+      intent_anchor TEXT,
+      success_criteria TEXT,
+      exclusions    TEXT,
+      content       TEXT,
+      version       INTEGER DEFAULT 1,
+      updated_at    INTEGER,
+      data_json     TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_project_docs_project ON project_documents(project_id);
+  `);
+
+  // H-7 migration: add created_at column to existing goals tables that predate this commit.
+  try { db.exec(`ALTER TABLE goals ADD COLUMN created_at INTEGER`); } catch (_) { /* column already exists */ }
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function _parseJson(value, fallback) {
+  if (!value) return fallback;
+  try { return JSON.parse(value); } catch { return fallback; }
+}
+
+const _SQLITE_COLUMN_KEYS = new Set([
+  'id', 'company_id', 'title', 'description', 'level', 'status', 'parent_id',
+  'created_at', 'updated_at', 'data_json',
+  // tasks
+  'assignee_agent_id', 'goal_id', 'origin_kind', 'helios_issue_id', 'execution_locked_at',
+  // approvals
+  'type', 'strategy_id', 'requested_by',
+  // cost_events
+  'agent_id', 'feature', 'model', 'amount_usd',
+  // business_agents
+  'role', 'last_heartbeat_at', 'pause_reason',
+  // okrs / leads / crm_contacts / accounts / opportunities
+  'email', 'name', 'amount',
+  // helios_projects
+  'pillar_id', 'phase',
+  // project_documents
+  'project_id', 'section', 'value', 'updated_by',
+  'intent_anchor', 'success_criteria', 'exclusions', 'content', 'purpose', 'approach', 'version',
+]);
+
+function _stripSqliteCols(obj) {
+  const result = {};
+  for (const key of Object.keys(obj)) {
+    if (!_SQLITE_COLUMN_KEYS.has(key)) result[key] = obj[key];
+  }
+  return result;
+}
+
+function _mergeRow(row) {
+  const base = _parseJson(row.data_json, {});
+  const merged = { ...base };
+  for (const key of Object.keys(row)) {
+    if (key !== 'data_json') merged[key] = row[key];
+  }
+  return merged;
+}
+
+function _statusParams(statuses) {
+  const placeholders = statuses.map(() => '?').join(', ');
+  return { placeholders, params: statuses };
+}
+
+// ---------------------------------------------------------------------------
+// Tasks
+// ---------------------------------------------------------------------------
+
+function createTask(task) {
+  const companyId = task.company_id || task.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] createTask: company_id is required (task id=${task.id})`);
+  const db = getDb();
+  const now = Date.now();
+  db.prepare(`
+    INSERT OR REPLACE INTO tasks
+      (id, company_id, title, status, assignee_agent_id, goal_id,
+       origin_kind, helios_issue_id, execution_locked_at, created_at, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    task.id,
+    companyId,
+    task.title || null,
+    task.status || null,
+    task.assignee_agent_id || task.assigneeAgentId || null,
+    task.goal_id || task.goalId || null,
+    task.origin_kind || task.originKind || null,
+    task.helios_issue_id || task.heliosIssueId || null,
+    task.execution_locked_at != null ? task.execution_locked_at : (task.executionLockedAt != null ? task.executionLockedAt : null),
+    task.created_at || task.createdAt || now,
+    task.updated_at || task.updatedAt || now,
+    JSON.stringify(task),
+  );
+}
+
+function getTask(id, companyId) {
+  const db = getDb();
+  const row = db.prepare('SELECT * FROM tasks WHERE id = ? AND company_id = ?').get(id, companyId);
+  return row ? _mergeRow(row) : null;
+}
+
+function updateTask(id, companyId, update) {
+  const existing = getTask(id, companyId) || { id, company_id: companyId };
+  const merged = { ...existing, ...update, id, company_id: companyId, updated_at: Date.now() };
+  createTask(merged);
+}
+
+function getTasksByCompanyStatus(companyId, status) {
+  const db = getDb();
+  const statuses = Array.isArray(status) ? status : [status];
+  const { placeholders, params } = _statusParams(statuses);
+  return db.prepare(
+    `SELECT * FROM tasks WHERE company_id = ? AND status IN (${placeholders})`
+  ).all(companyId, ...params).map(_mergeRow);
+}
+
+function deleteTask(id, companyId) {
+  const db = getDb();
+  db.prepare('DELETE FROM tasks WHERE id = ? AND company_id = ?').run(id, companyId);
+}
+
+// ---------------------------------------------------------------------------
+// Approvals
+// ---------------------------------------------------------------------------
+
+function createApproval(approval) {
+  const companyId = approval.company_id || approval.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] createApproval: company_id is required (approval id=${approval.id})`);
+  const db = getDb();
+  const now = Date.now();
+  db.prepare(`
+    INSERT OR REPLACE INTO approvals
+      (id, company_id, type, status, strategy_id, requested_by, created_at, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    approval.id,
+    companyId,
+    approval.type || null,
+    approval.status || null,
+    approval.strategy_id || approval.strategyId || null,
+    approval.requested_by || approval.requestedBy || null,
+    approval.created_at || approval.createdAt || now,
+    approval.updated_at || approval.updatedAt || now,
+    JSON.stringify(approval),
+  );
+}
+
+function getApproval(id, companyId) {
+  const db = getDb();
+  const row = db.prepare('SELECT * FROM approvals WHERE id = ? AND company_id = ?').get(id, companyId);
+  return row ? _mergeRow(row) : null;
+}
+
+function updateApproval(id, companyId, update) {
+  const existing = getApproval(id, companyId) || { id, company_id: companyId };
+  const merged = { ...existing, ...update, id, company_id: companyId, updated_at: Date.now() };
+  createApproval(merged);
+}
+
+function getApprovalsByCompanyStatus(companyId, status) {
+  const db = getDb();
+  const statuses = Array.isArray(status) ? status : [status];
+  const { placeholders, params } = _statusParams(statuses);
+  return db.prepare(
+    `SELECT * FROM approvals WHERE company_id = ? AND status IN (${placeholders})`
+  ).all(companyId, ...params).map(_mergeRow);
+}
+
+// ---------------------------------------------------------------------------
+// Budget Policies
+// ---------------------------------------------------------------------------
+
+function upsertBudgetPolicy(policy) {
+  const companyId = policy.company_id || policy.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] upsertBudgetPolicy: company_id is required`);
+  const db = getDb();
+  db.prepare(`
+    INSERT OR REPLACE INTO budget_policies
+      (id, company_id, agent_id, spent_cents, percent_used, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    policy.id,
+    companyId,
+    policy.agent_id || policy.agentId || null,
+    policy.spent_cents != null ? policy.spent_cents : (policy.spentCents != null ? policy.spentCents : 0),
+    policy.percent_used != null ? policy.percent_used : (policy.percentUsed != null ? policy.percentUsed : 0),
+    policy.updated_at || policy.updatedAt || Date.now(),
+    JSON.stringify(policy),
+  );
+}
+
+function getBudgetPolicy(id, companyId) {
+  const db = getDb();
+  const row = db.prepare('SELECT * FROM budget_policies WHERE id = ? AND company_id = ?').get(id, companyId);
+  return row ? _mergeRow(row) : null;
+}
+
+function getBudgetPoliciesByCompany(companyId) {
+  const db = getDb();
+  return db.prepare('SELECT * FROM budget_policies WHERE company_id = ?').all(companyId).map(_mergeRow);
+}
+
+// ---------------------------------------------------------------------------
+// Cost Events
+// ---------------------------------------------------------------------------
+
+function createCostEvent(event) {
+  const companyId = event.company_id || event.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] createCostEvent: company_id is required`);
+  const db = getDb();
+  const now = Date.now();
+  db.prepare(`
+    INSERT OR REPLACE INTO cost_events
+      (id, company_id, agent_id, feature, model, amount_usd, created_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    event.id,
+    companyId,
+    event.agent_id || event.agentId || null,
+    event.feature || null,
+    event.model || null,
+    event.amount_usd != null ? event.amount_usd : (event.amountUsd != null ? event.amountUsd : null),
+    event.created_at || event.createdAt || now,
+    JSON.stringify(event),
+  );
+}
+
+function getCostEventsByCompanyRange(companyId, startMs, endMs) {
+  const db = getDb();
+  return db.prepare(
+    'SELECT * FROM cost_events WHERE company_id = ? AND created_at >= ? AND created_at <= ? ORDER BY created_at ASC'
+  ).all(companyId, startMs, endMs).map(_mergeRow);
+}
+
+// ---------------------------------------------------------------------------
+// Business Agents
+// ---------------------------------------------------------------------------
+
+function upsertBusinessAgent(agent) {
+  const companyId = agent.company_id || agent.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] upsertBusinessAgent: company_id is required`);
+  const db = getDb();
+  db.prepare(`
+    INSERT OR REPLACE INTO business_agents
+      (id, company_id, role, status, current_task_id, skill, adapter, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    agent.id,
+    companyId,
+    agent.role || null,
+    agent.status || null,
+    agent.current_task_id || agent.currentTaskId || null,
+    agent.skill || null,
+    agent.adapter || null,
+    agent.updated_at || agent.updatedAt || Date.now(),
+    JSON.stringify(agent),
+  );
+}
+
+function getBusinessAgent(id, companyId) {
+  const db = getDb();
+  const row = db.prepare('SELECT * FROM business_agents WHERE id = ? AND company_id = ?').get(id, companyId);
+  return row ? _mergeRow(row) : null;
+}
+
+function getBusinessAgentsByCompany(companyId) {
+  const db = getDb();
+  return db.prepare('SELECT * FROM business_agents WHERE company_id = ?').all(companyId).map(_mergeRow);
+}
+
+// ---------------------------------------------------------------------------
+// OKRs
+// ---------------------------------------------------------------------------
+
+function upsertOKR(okr) {
+  const companyId = okr.company_id || okr.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] upsertOKR: company_id is required`);
+  const db = getDb();
+  db.prepare(`
+    INSERT OR REPLACE INTO okrs
+      (id, company_id, type, status, title, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    okr.id,
+    companyId,
+    okr.type || null,
+    okr.status || null,
+    okr.title || null,
+    okr.updated_at || okr.updatedAt || Date.now(),
+    JSON.stringify(okr),
+  );
+}
+
+function getOKRsByCompanyType(companyId, type, status) {
+  const db = getDb();
+  if (type !== undefined && status !== undefined) {
+    return db.prepare('SELECT * FROM okrs WHERE company_id = ? AND type = ? AND status = ?').all(companyId, type, status).map(_mergeRow);
+  }
+  if (type !== undefined) {
+    return db.prepare('SELECT * FROM okrs WHERE company_id = ? AND type = ?').all(companyId, type).map(_mergeRow);
+  }
+  if (status !== undefined) {
+    return db.prepare('SELECT * FROM okrs WHERE company_id = ? AND status = ?').all(companyId, status).map(_mergeRow);
+  }
+  return db.prepare('SELECT * FROM okrs WHERE company_id = ?').all(companyId).map(_mergeRow);
+}
+
+// ---------------------------------------------------------------------------
+// Goals
+// ---------------------------------------------------------------------------
+
+function createGoal(goal) {
+  const companyId = goal.company_id || goal.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] createGoal: company_id is required (goal id=${goal.id})`);
+  const db = getDb();
+  const now = Date.now();
+  db.prepare(`
+    INSERT OR REPLACE INTO goals
+      (id, company_id, title, description, level, status, parent_id, created_at, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    goal.id,
+    companyId,
+    goal.title || null,
+    goal.description || goal.desc || null,
+    goal.level || null,
+    goal.status || null,
+    goal.parent_id || goal.parentId || goal.parentGoalId || null,
+    goal.created_at || goal.createdAt || now,
+    goal.updated_at || goal.updatedAt || now,
+    JSON.stringify(goal),
+  );
+}
+
+function getGoal(id, companyId) {
+  const db = getDb();
+  const row = db.prepare('SELECT * FROM goals WHERE id = ? AND company_id = ?').get(id, companyId);
+  return row ? _mergeRow(row) : null;
+}
+
+function updateGoal(id, companyId, update) {
+  const existing = getGoal(id, companyId) || { id, company_id: companyId };
+  const cleanExisting = _stripSqliteCols(existing);
+  createGoal({ ...cleanExisting, ...update, id, company_id: companyId, updated_at: Date.now() });
+}
+
+function deleteGoal(id, companyId) {
+  const db = getDb();
+  db.prepare('DELETE FROM goals WHERE id = ? AND company_id = ?').run(id, companyId);
+}
+
+function getGoalsByCompany(companyId) {
+  const db = getDb();
+  return db.prepare('SELECT * FROM goals WHERE company_id = ?').all(companyId).map(_mergeRow);
+}
+
+// ---------------------------------------------------------------------------
+// HeliosProjects
+// ---------------------------------------------------------------------------
+
+function upsertProject(project) {
+  const companyId = project.company_id || project.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] upsertProject: company_id is required`);
+  const db = getDb();
+  const now = Date.now();
+  db.prepare(`
+    INSERT OR REPLACE INTO helios_projects
+      (id, company_id, name, pillar_id, goal_id, status, phase, created_at, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    project.id,
+    companyId,
+    project.name || null,
+    project.pillar_id || project.pillarId || null,
+    project.goal_id || project.goalId || null,
+    project.status || 'planning',
+    project.phase || 'planning',
+    project.created_at || project.createdAt || now,
+    project.updated_at || project.updatedAt || now,
+    JSON.stringify(project),
+  );
+}
+
+function getProject(id, companyId) {
+  const db = getDb();
+  const row = db.prepare('SELECT * FROM helios_projects WHERE id = ? AND company_id = ?').get(id, companyId);
+  return row ? _mergeRow(row) : null;
+}
+
+function getProjectsByCompany(companyId) {
+  const db = getDb();
+  return db.prepare('SELECT * FROM helios_projects WHERE company_id = ? ORDER BY created_at DESC LIMIT 100').all(companyId).map(_mergeRow);
+}
+
+function updateProject(id, companyId, update) {
+  const existing = getProject(id, companyId) || { id, company_id: companyId };
+  const cleanExisting = _stripSqliteCols(existing);
+  upsertProject({ ...cleanExisting, ...update, id, company_id: companyId, updated_at: Date.now() });
+}
+
+// ---------------------------------------------------------------------------
+// ProjectDocuments
+// ---------------------------------------------------------------------------
+
+function upsertProjectDocument(doc) {
+  const projectId = doc.project_id || doc.projectId;
+  if (!projectId) throw new Error(`[hbo-core-store] upsertProjectDocument: project_id is required`);
+  const db = getDb();
+  const id = doc.id || `pdoc:${projectId}:main`;
+  const now = Date.now();
+  db.prepare(`
+    INSERT OR REPLACE INTO project_documents
+      (id, project_id, company_id, purpose, approach, intent_anchor,
+       success_criteria, exclusions, content, version, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    id,
+    projectId,
+    doc.company_id || doc.companyId || null,
+    doc.purpose || null,
+    doc.approach || null,
+    doc.intent_anchor || doc.intentAnchor || null,
+    doc.success_criteria || doc.successCriteria || '[]',
+    doc.exclusions || '[]',
+    doc.content || null,
+    doc.version != null ? doc.version : 1,
+    doc.updated_at || doc.updatedAt || now,
+    JSON.stringify(doc),
+  );
+}
+
+function getProjectDocument(projectId) {
+  const db = getDb();
+  const row = db.prepare('SELECT * FROM project_documents WHERE project_id = ? ORDER BY updated_at DESC LIMIT 1').get(projectId);
+  return row ? _mergeRow(row) : null;
+}
+
+// ---------------------------------------------------------------------------
+// Leads
+// ---------------------------------------------------------------------------
+
+function upsertLead(lead) {
+  const companyId = lead.company_id || lead.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] upsertLead: company_id is required`);
+  const db = getDb();
+  db.prepare(`
+    INSERT OR REPLACE INTO leads
+      (id, company_id, status, email, name, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    lead.id,
+    companyId,
+    lead.status || null,
+    lead.email || null,
+    lead.name || null,
+    lead.updated_at || lead.updatedAt || Date.now(),
+    JSON.stringify(lead),
+  );
+}
+
+function getLeadsByCompanyStatus(companyId, statuses) {
+  const db = getDb();
+  const { placeholders, params } = _statusParams(statuses);
+  return db.prepare(
+    `SELECT * FROM leads WHERE company_id = ? AND status IN (${placeholders})`
+  ).all(companyId, ...params).map(_mergeRow);
+}
+
+// ---------------------------------------------------------------------------
+// CRM Contacts
+// ---------------------------------------------------------------------------
+
+function upsertCRMContact(contact) {
+  const companyId = contact.company_id || contact.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] upsertCRMContact: company_id is required`);
+  const db = getDb();
+  db.prepare(`
+    INSERT OR REPLACE INTO crm_contacts
+      (id, company_id, email, name, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `).run(
+    contact.id,
+    companyId,
+    contact.email || null,
+    contact.name || null,
+    contact.updated_at || contact.updatedAt || Date.now(),
+    JSON.stringify(contact),
+  );
+}
+
+function getCRMContactsByCompany(companyId) {
+  const db = getDb();
+  return db.prepare('SELECT * FROM crm_contacts WHERE company_id = ?').all(companyId).map(_mergeRow);
+}
+
+// ---------------------------------------------------------------------------
+// Accounts
+// ---------------------------------------------------------------------------
+
+function upsertAccount(account) {
+  const companyId = account.company_id || account.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] upsertAccount: company_id is required`);
+  const db = getDb();
+  db.prepare(`
+    INSERT OR REPLACE INTO accounts
+      (id, company_id, name, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?)
+  `).run(
+    account.id,
+    companyId,
+    account.name || null,
+    account.updated_at || account.updatedAt || Date.now(),
+    JSON.stringify(account),
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Opportunities
+// ---------------------------------------------------------------------------
+
+function upsertOpportunity(opp) {
+  const companyId = opp.company_id || opp.companyId;
+  if (!companyId) throw new Error(`[hbo-core-store] upsertOpportunity: company_id is required`);
+  const db = getDb();
+  db.prepare(`
+    INSERT OR REPLACE INTO opportunities
+      (id, company_id, title, status, updated_at, data_json)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `).run(
+    opp.id,
+    companyId,
+    opp.title || null,
+    opp.status || null,
+    opp.updated_at || opp.updatedAt || Date.now(),
+    JSON.stringify(opp),
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Test / lifecycle helpers
+// ---------------------------------------------------------------------------
+
+function resetHboCoreStore() {
+  try { if (_db) _db.close(); } catch (_) { /* ignore */ }
+  _db = null;
+  _engine = null;
+}
+
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+
+module.exports = {
+  createTask,
+  getTask,
+  updateTask,
+  getTasksByCompanyStatus,
+  deleteTask,
+  createApproval,
+  getApproval,
+  updateApproval,
+  getApprovalsByCompanyStatus,
+  upsertBudgetPolicy,
+  getBudgetPolicy,
+  getBudgetPoliciesByCompany,
+  createCostEvent,
+  getCostEventsByCompanyRange,
+  upsertBusinessAgent,
+  getBusinessAgent,
+  getBusinessAgentsByCompany,
+  upsertOKR,
+  getOKRsByCompanyType,
+  createGoal,
+  getGoal,
+  updateGoal,
+  deleteGoal,
+  getGoalsByCompany,
+  upsertProject,
+  getProject,
+  getProjectsByCompany,
+  updateProject,
+  upsertProjectDocument,
+  getProjectDocument,
+  upsertLead,
+  getLeadsByCompanyStatus,
+  upsertCRMContact,
+  getCRMContactsByCompany,
+  upsertAccount,
+  upsertOpportunity,
+  resetHboCoreStore,
+};