@jaimevalasek/aioson 1.3.0 → 1.4.0

package/src/runtime-store.js

@@ -12,6 +12,7 @@ const {
 
 const RUNTIME_DIR = path.join('.aioson', 'runtime');
 const DB_FILE = 'aios.sqlite';
+const LOGS_DIR = 'aioson-logs';
 const SESSIONS_DIR = '.sessions';
 const VALID_STATUSES = new Set(['queued', 'running', 'completed', 'failed']);
 const VALID_TASK_STATUSES = new Set(['queued', 'running', 'completed', 'failed']);
@@ -32,7 +33,8 @@ function resolveRuntimePaths(targetDir) {
   const runtimeDir = path.join(targetDir, RUNTIME_DIR);
   return {
     runtimeDir,
-    dbPath: path.join(runtimeDir, DB_FILE)
+    dbPath: path.join(runtimeDir, DB_FILE),
+    logsDir: path.join(targetDir, LOGS_DIR)
   };
 }
 
@@ -42,7 +44,7 @@ async function runtimeStoreExists(targetDir) {
 }
 
 async function openRuntimeDb(targetDir, options = {}) {
-  const { runtimeDir, dbPath } = resolveRuntimePaths(targetDir);
+  const { runtimeDir, dbPath, logsDir } = resolveRuntimePaths(targetDir);
   const mustExist = Boolean(options.mustExist);
 
   if (mustExist && !(await exists(dbPath))) {
@@ -50,6 +52,7 @@ async function openRuntimeDb(targetDir, options = {}) {
   }
 
   await ensureDir(runtimeDir);
+  await ensureDir(logsDir);
 
   const db = new Database(dbPath);
   db.pragma('journal_mode = WAL');
@@ -125,8 +128,11 @@ async function openRuntimeDb(targetDir, options = {}) {
       task_key TEXT PRIMARY KEY,
       squad_slug TEXT,
       session_key TEXT,
+      task_kind TEXT,
+      parent_task_key TEXT,
       title TEXT NOT NULL,
       goal TEXT,
+      meta_json TEXT,
       status TEXT NOT NULL,
       created_by TEXT,
       created_at TEXT NOT NULL,
@@ -351,6 +357,145 @@ async function openRuntimeDb(targetDir, options = {}) {
 
     CREATE INDEX IF NOT EXISTS idx_artisan_squads_status ON artisan_squads(status, updated_at DESC);
     CREATE INDEX IF NOT EXISTS idx_artisan_messages_artisan ON artisan_messages(artisan_id, created_at ASC);
+
+    CREATE TABLE IF NOT EXISTS delivery_log (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      squad_slug TEXT NOT NULL,
+      content_key TEXT,
+      webhook_slug TEXT,
+      trigger_type TEXT NOT NULL,
+      url TEXT NOT NULL,
+      status_code INTEGER,
+      response_body TEXT,
+      error_message TEXT,
+      attempt INTEGER DEFAULT 1,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_delivery_log_squad ON delivery_log(squad_slug);
+    CREATE INDEX IF NOT EXISTS idx_delivery_log_content ON delivery_log(content_key);
+
+    CREATE TABLE IF NOT EXISTS backup_manifest (
+      record_key TEXT PRIMARY KEY,
+      record_type TEXT NOT NULL,
+      content_hash TEXT NOT NULL,
+      backed_up_at TEXT NOT NULL,
+      remote_key TEXT NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_backup_manifest_type ON backup_manifest(record_type, backed_up_at DESC);
+
+    CREATE TABLE IF NOT EXISTS squad_investigations (
+      investigation_slug TEXT PRIMARY KEY,
+      domain TEXT NOT NULL,
+      mode TEXT DEFAULT 'full',
+      dimensions_covered INTEGER DEFAULT 0,
+      total_dimensions INTEGER DEFAULT 7,
+      confidence REAL DEFAULT 0,
+      report_path TEXT,
+      linked_squad_slug TEXT,
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_squad_investigations_domain ON squad_investigations(domain);
+    CREATE INDEX IF NOT EXISTS idx_squad_investigations_squad ON squad_investigations(linked_squad_slug);
+
+    CREATE TABLE IF NOT EXISTS implementation_plans (
+      plan_id TEXT PRIMARY KEY,
+      project_name TEXT,
+      scope TEXT DEFAULT 'project',
+      feature_slug TEXT,
+      status TEXT DEFAULT 'draft',
+      classification TEXT,
+      phases_total INTEGER DEFAULT 0,
+      phases_completed INTEGER DEFAULT 0,
+      source_artifacts TEXT,
+      source_hash TEXT,
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS plan_phases (
+      plan_id TEXT NOT NULL,
+      phase_number INTEGER NOT NULL,
+      title TEXT NOT NULL,
+      status TEXT DEFAULT 'pending',
+      completed_at TEXT,
+      notes TEXT,
+      PRIMARY KEY (plan_id, phase_number),
+      FOREIGN KEY (plan_id) REFERENCES implementation_plans(plan_id)
+    );
+
+    CREATE TABLE IF NOT EXISTS squad_execution_plans (
+      plan_slug TEXT PRIMARY KEY,
+      squad_slug TEXT NOT NULL,
+      status TEXT DEFAULT 'draft',
+      rounds_total INTEGER DEFAULT 0,
+      rounds_completed INTEGER DEFAULT 0,
+      based_on_blueprint TEXT,
+      based_on_investigation TEXT,
+      source_hash TEXT,
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS squad_plan_rounds (
+      plan_slug TEXT NOT NULL,
+      round_number INTEGER NOT NULL,
+      executor_slug TEXT NOT NULL,
+      title TEXT NOT NULL,
+      status TEXT DEFAULT 'pending',
+      completed_at TEXT,
+      notes TEXT,
+      PRIMARY KEY (plan_slug, round_number),
+      FOREIGN KEY (plan_slug) REFERENCES squad_execution_plans(plan_slug)
+    );
+
+    CREATE TABLE IF NOT EXISTS squad_learnings (
+      learning_id TEXT PRIMARY KEY,
+      squad_slug TEXT NOT NULL,
+      type TEXT NOT NULL CHECK (type IN ('preference', 'process', 'domain', 'quality')),
+      title TEXT NOT NULL,
+      signal TEXT DEFAULT 'explicit' CHECK (signal IN ('explicit', 'implicit')),
+      confidence TEXT DEFAULT 'medium' CHECK (confidence IN ('high', 'medium', 'low')),
+      frequency INTEGER DEFAULT 1,
+      last_reinforced TEXT,
+      applies_to TEXT DEFAULT 'squad',
+      file_path TEXT,
+      promoted_to TEXT,
+      status TEXT DEFAULT 'active' CHECK (status IN ('active', 'stale', 'archived', 'promoted')),
+      source_session TEXT,
+      evidence TEXT,
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS project_learnings (
+      learning_id TEXT PRIMARY KEY,
+      project_name TEXT,
+      feature_slug TEXT,
+      type TEXT NOT NULL CHECK (type IN ('preference', 'process', 'domain', 'quality')),
+      title TEXT NOT NULL,
+      confidence TEXT DEFAULT 'medium',
+      frequency INTEGER DEFAULT 1,
+      last_reinforced TEXT,
+      applies_to TEXT DEFAULT 'project',
+      promoted_to TEXT,
+      status TEXT DEFAULT 'active' CHECK (status IN ('active', 'stale', 'archived', 'promoted')),
+      source_session TEXT,
+      evidence TEXT,
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_impl_plans_status ON implementation_plans(status);
+    CREATE INDEX IF NOT EXISTS idx_squad_exec_plans_squad ON squad_execution_plans(squad_slug);
+    CREATE INDEX IF NOT EXISTS idx_squad_exec_plans_status ON squad_execution_plans(status);
+    CREATE INDEX IF NOT EXISTS idx_squad_learnings_squad ON squad_learnings(squad_slug);
+    CREATE INDEX IF NOT EXISTS idx_squad_learnings_type ON squad_learnings(type);
+    CREATE INDEX IF NOT EXISTS idx_squad_learnings_status ON squad_learnings(status);
+    CREATE INDEX IF NOT EXISTS idx_project_learnings_type ON project_learnings(type);
+    CREATE INDEX IF NOT EXISTS idx_project_learnings_status ON project_learnings(status);
   `);
 
   ensureLegacyColumns(db);
@@ -381,6 +526,25 @@ function normalizeTaskStatus(value, fallback) {
 }
 
 function ensureLegacyColumns(db) {
+  const taskColumns = db.prepare('PRAGMA table_info(tasks)').all();
+  const taskColumnNames = new Set(taskColumns.map((column) => column.name));
+
+  if (!taskColumnNames.has('task_kind')) {
+    db.exec('ALTER TABLE tasks ADD COLUMN task_kind TEXT');
+  }
+
+  if (!taskColumnNames.has('parent_task_key')) {
+    db.exec('ALTER TABLE tasks ADD COLUMN parent_task_key TEXT');
+  }
+
+  if (!taskColumnNames.has('meta_json')) {
+    db.exec('ALTER TABLE tasks ADD COLUMN meta_json TEXT');
+  }
+
+  db.exec('CREATE INDEX IF NOT EXISTS idx_tasks_session ON tasks(session_key, updated_at DESC)');
+  db.exec('CREATE INDEX IF NOT EXISTS idx_tasks_parent ON tasks(parent_task_key, updated_at DESC)');
+  db.exec('CREATE INDEX IF NOT EXISTS idx_tasks_kind ON tasks(task_kind, updated_at DESC)');
+
   const agentRunColumns = db.prepare('PRAGMA table_info(agent_runs)').all();
   const agentRunColumnNames = new Set(agentRunColumns.map((column) => column.name));
 
@@ -498,56 +662,66 @@ function appendRunEvent(db, options) {
   const now = options.createdAt || nowIso();
   const payloadJson = options.payload ? JSON.stringify(options.payload) : null;
 
-  insertEvent(db, {
-    run_key: run.run_key,
-    event_type: String(options.eventType || 'update'),
-    message: String(options.message || ''),
-    payload_json: payloadJson,
-    created_at: now
-  });
+  const doInsert = db.transaction(() => {
+    insertEvent(db, {
+      run_key: run.run_key,
+      event_type: String(options.eventType || 'update'),
+      message: String(options.message || ''),
+      payload_json: payloadJson,
+      created_at: now
+    });
 
-  insertExecutionEvent(db, {
-    task_key: run.task_key,
-    run_key: run.run_key,
-    agent_name: run.agent_name,
-    agent_kind: run.agent_kind,
-    squad_slug: run.squad_slug,
-    session_key: run.session_key,
-    source: run.source,
-    workflow_id: run.workflow_id,
-    workflow_stage: run.workflow_stage,
-    parent_run_key: run.parent_run_key,
-    event_type: String(options.eventType || 'update'),
-    phase: options.phase ? String(options.phase).trim() : null,
-    status: options.status ? String(options.status).trim() : run.status || null,
-    tool_name: options.toolName ? String(options.toolName).trim() : null,
-    message: String(options.message || ''),
-    payload_json: payloadJson,
-    sequence_no: nextExecutionSequence(db, run.run_key),
-    parent_event_id: options.parentEventId || null,
-    created_at: now
+    insertExecutionEvent(db, {
+      task_key: run.task_key,
+      run_key: run.run_key,
+      agent_name: run.agent_name,
+      agent_kind: run.agent_kind,
+      squad_slug: run.squad_slug,
+      session_key: run.session_key,
+      source: run.source,
+      workflow_id: run.workflow_id,
+      workflow_stage: run.workflow_stage,
+      parent_run_key: run.parent_run_key,
+      event_type: String(options.eventType || 'update'),
+      phase: options.phase ? String(options.phase).trim() : null,
+      status: options.status ? String(options.status).trim() : run.status || null,
+      tool_name: options.toolName ? String(options.toolName).trim() : null,
+      message: String(options.message || ''),
+      payload_json: payloadJson,
+      sequence_no: nextExecutionSequence(db, run.run_key),
+      parent_event_id: options.parentEventId || null,
+      created_at: now
+    });
   });
+
+  doInsert();
 }
 
 function startTask(db, options) {
   const now = nowIso();
   const taskKey = String(options.taskKey || createTaskKey(options.title));
   const status = normalizeTaskStatus(options.status, 'running');
+  const metaJson = options.metaJson && typeof options.metaJson === 'object'
+    ? JSON.stringify(options.metaJson)
+    : (typeof options.metaJson === 'string' && options.metaJson.trim() ? options.metaJson.trim() : null);
 
   db.prepare(`
     INSERT INTO tasks (
-      task_key, squad_slug, session_key, title, goal, status, created_by,
-      created_at, updated_at, finished_at
+      task_key, squad_slug, session_key, task_kind, parent_task_key,
+      title, goal, meta_json, status, created_by, created_at, updated_at, finished_at
     ) VALUES (
-      @task_key, @squad_slug, @session_key, @title, @goal, @status, @created_by,
-      @created_at, @updated_at, @finished_at
+      @task_key, @squad_slug, @session_key, @task_kind, @parent_task_key,
+      @title, @goal, @meta_json, @status, @created_by, @created_at, @updated_at, @finished_at
     )
   `).run({
     task_key: taskKey,
     squad_slug: options.squadSlug ? String(options.squadSlug).trim() : null,
     session_key: options.sessionKey ? String(options.sessionKey).trim() : null,
+    task_kind: options.taskKind ? String(options.taskKind).trim() : null,
+    parent_task_key: options.parentTaskKey ? String(options.parentTaskKey).trim() : null,
     title: String(options.title).trim(),
     goal: options.goal ? String(options.goal).trim() : null,
+    meta_json: metaJson,
     status,
     created_by: options.createdBy ? String(options.createdBy).trim() : null,
     created_at: now,
@@ -566,12 +740,18 @@ function updateTask(db, options) {
 
   const now = nowIso();
   const nextStatus = normalizeTaskStatus(options.status, existing.status || 'running');
+  const metaJson = options.metaJson && typeof options.metaJson === 'object'
+    ? JSON.stringify(options.metaJson)
+    : (typeof options.metaJson === 'string' && options.metaJson.trim() ? options.metaJson.trim() : null);
 
   db.prepare(`
     UPDATE tasks
     SET
       status = @status,
       goal = COALESCE(@goal, goal),
+      task_kind = COALESCE(@task_kind, task_kind),
+      parent_task_key = COALESCE(@parent_task_key, parent_task_key),
+      meta_json = COALESCE(@meta_json, meta_json),
       updated_at = @updated_at,
       finished_at = CASE
         WHEN @status IN ('completed', 'failed') THEN @updated_at
@@ -582,6 +762,9 @@ function updateTask(db, options) {
     task_key: String(options.taskKey),
     status: nextStatus,
     goal: options.goal ? String(options.goal).trim() : null,
+    task_kind: options.taskKind ? String(options.taskKind).trim() : null,
+    parent_task_key: options.parentTaskKey ? String(options.parentTaskKey).trim() : null,
+    meta_json: metaJson,
     updated_at: now
   });
 
@@ -696,6 +879,52 @@ function parseJsonArray(value) {
   }
 }
 
+
+function parseJsonObject(value) {
+  if (!value) return null;
+  try {
+    const parsed = JSON.parse(value);
+    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+function getTaskPlanProgress(meta) {
+  const steps = Array.isArray(meta?.plan_steps) ? meta.plan_steps : [];
+  return {
+    plan_steps_done: steps.filter((step) => step && step.done).length,
+    plan_steps_total: steps.length
+  };
+}
+
+function decorateTaskSnapshotRow(row) {
+  const meta = parseJsonObject(row.meta_json);
+  const progress = getTaskPlanProgress(meta);
+  row.meta = meta;
+  row.plan_steps_done = progress.plan_steps_done;
+  row.plan_steps_total = progress.plan_steps_total;
+  row.is_live_session = row.task_kind === 'live_session';
+  row.is_micro_task = row.task_kind === 'micro_task';
+  return row;
+}
+
+function decorateRunSnapshotRow(row) {
+  row.used_skills = parseJsonArray(row.used_skills_json);
+  row.is_live = row.source === 'live';
+  row.is_handoff_child = Boolean(row.parent_run_key);
+  return row;
+}
+
+function decorateExecutionEventSnapshotRow(row) {
+  const payload = parseJsonObject(row.payload_json);
+  row.payload = payload;
+  row.is_handoff = row.event_type === 'handoff';
+  row.handoff_from = payload?.from || row.agent_name || null;
+  row.handoff_to = payload?.to || null;
+  return row;
+}
+
 function upsertSquadManifest(db, options) {
   const now = nowIso();
   const slug = String(options.slug).trim();
@@ -1110,7 +1339,7 @@ function startRun(db, options) {
 
   appendRunEvent(db, {
     runKey,
-    eventType: 'start',
+    eventType: String(options.eventType || 'start'),
     phase: options.phase || 'run',
     status,
     message: String(options.message || options.title || 'Agent started'),
@@ -1242,7 +1471,7 @@ function getStatusSnapshot(db) {
 
   const activeTasks = db.prepare(`
     SELECT
-      task_key, squad_slug, session_key, title, goal, status, created_by, created_at, updated_at,
+      task_key, squad_slug, session_key, task_kind, parent_task_key, title, goal, meta_json, status, created_by, created_at, updated_at,
       (
         SELECT COUNT(*)
         FROM agent_runs
@@ -1252,7 +1481,29 @@ function getStatusSnapshot(db) {
         SELECT COUNT(*)
         FROM artifacts
         WHERE artifacts.task_key = tasks.task_key
-      ) AS artifact_count
+      ) AS artifact_count,
+      (
+        SELECT agent_name
+        FROM agent_runs
+        WHERE agent_runs.task_key = tasks.task_key
+        ORDER BY CASE WHEN agent_runs.status IN ('queued', 'running') THEN 0 ELSE 1 END, updated_at DESC, started_at DESC
+        LIMIT 1
+      ) AS latest_agent_name,
+      (
+        SELECT COUNT(*)
+        FROM tasks AS child_tasks
+        WHERE child_tasks.parent_task_key = tasks.task_key
+      ) AS child_task_count,
+      (
+        SELECT COUNT(*)
+        FROM tasks AS child_tasks
+        WHERE child_tasks.parent_task_key = tasks.task_key AND child_tasks.status = 'completed'
+      ) AS completed_child_task_count,
+      (
+        SELECT COUNT(*)
+        FROM agent_runs AS handoff_runs
+        WHERE handoff_runs.task_key = tasks.task_key AND handoff_runs.parent_run_key IS NOT NULL
+      ) AS handoff_count
     FROM tasks
     WHERE status IN ('queued', 'running')
     ORDER BY updated_at DESC, created_at DESC
@@ -1260,7 +1511,7 @@ function getStatusSnapshot(db) {
 
   const recentTasks = db.prepare(`
     SELECT
-      task_key, squad_slug, session_key, title, goal, status, created_by, created_at, updated_at, finished_at,
+      task_key, squad_slug, session_key, task_kind, parent_task_key, title, goal, meta_json, status, created_by, created_at, updated_at, finished_at,
       (
         SELECT COUNT(*)
         FROM agent_runs
@@ -1270,7 +1521,29 @@ function getStatusSnapshot(db) {
         SELECT COUNT(*)
         FROM artifacts
         WHERE artifacts.task_key = tasks.task_key
-      ) AS artifact_count
+      ) AS artifact_count,
+      (
+        SELECT agent_name
+        FROM agent_runs
+        WHERE agent_runs.task_key = tasks.task_key
+        ORDER BY CASE WHEN agent_runs.status IN ('queued', 'running') THEN 0 ELSE 1 END, updated_at DESC, started_at DESC
+        LIMIT 1
+      ) AS latest_agent_name,
+      (
+        SELECT COUNT(*)
+        FROM tasks AS child_tasks
+        WHERE child_tasks.parent_task_key = tasks.task_key
+      ) AS child_task_count,
+      (
+        SELECT COUNT(*)
+        FROM tasks AS child_tasks
+        WHERE child_tasks.parent_task_key = tasks.task_key AND child_tasks.status = 'completed'
+      ) AS completed_child_task_count,
+      (
+        SELECT COUNT(*)
+        FROM agent_runs AS handoff_runs
+        WHERE handoff_runs.task_key = tasks.task_key AND handoff_runs.parent_run_key IS NOT NULL
+      ) AS handoff_count
     FROM tasks
     ORDER BY updated_at DESC, created_at DESC
     LIMIT 20
@@ -1303,17 +1576,35 @@ function getStatusSnapshot(db) {
   `).all();
 
   for (const row of activeRuns) {
-    row.used_skills = parseJsonArray(row.used_skills_json);
+    decorateRunSnapshotRow(row);
   }
 
   for (const row of recentRuns) {
-    row.used_skills = parseJsonArray(row.used_skills_json);
+    decorateRunSnapshotRow(row);
+  }
+
+  for (const row of activeTasks) {
+    decorateTaskSnapshotRow(row);
+  }
+
+  for (const row of recentTasks) {
+    decorateTaskSnapshotRow(row);
   }
 
   for (const row of recentContentItems) {
     row.used_skills = parseJsonArray(row.used_skills_json);
   }
 
+  for (const row of recentExecutionEvents) {
+    decorateExecutionEventSnapshotRow(row);
+  }
+
+  const activeLiveSessions = activeTasks.filter((task) => task.task_kind === 'live_session');
+  const activeMicroTasks = activeTasks.filter((task) => task.task_kind === 'micro_task');
+  const recentLiveSessions = recentTasks.filter((task) => task.task_kind === 'live_session');
+  const recentMicroTasks = recentTasks.filter((task) => task.task_kind === 'micro_task');
+  const recentHandoffs = recentExecutionEvents.filter((event) => event.event_type === 'handoff');
+
   return {
     taskCounts,
     counts,
@@ -1321,6 +1612,11 @@ function getStatusSnapshot(db) {
     recentTasks,
     activeRuns,
     recentRuns,
+    activeLiveSessions,
+    activeMicroTasks,
+    recentLiveSessions,
+    recentMicroTasks,
+    recentHandoffs,
     recentArtifacts,
     recentContentItems,
     recentExecutionEvents
@@ -1374,6 +1670,7 @@ async function clearAgentSession(runtimeDir, agentName) {
 async function logAgentEvent(db, runtimeDir, options) {
   const agentName = String(options.agentName || 'unknown').trim();
   const squadSlug = options.squadSlug ? String(options.squadSlug).trim() : null;
+  const sessionKey = options.sessionKey ? String(options.sessionKey).trim() : null;
   const isFinish = Boolean(options.finish);
   const now = nowIso();
 
@@ -1442,6 +1739,7 @@ async function logAgentEvent(db, runtimeDir, options) {
       taskKey = startTask(db, {
         title: taskTitle,
         squadSlug: null,
+        sessionKey,
         status: 'running',
         createdBy: agentName
       });
@@ -1450,10 +1748,11 @@ async function logAgentEvent(db, runtimeDir, options) {
         agentName,
         agentKind: 'official',
         squadSlug: null,
+        sessionKey,
         title: taskTitle,
         message: options.message || 'Iniciando'
       });
-      await writeAgentSession(runtimeDir, agentName, { runKey, taskKey, startedAt: now, finished: false });
+      await writeAgentSession(runtimeDir, agentName, { runKey, taskKey, sessionKey, startedAt: now, finished: false });
     } else {
       appendRunEvent(db, {
         runKey,
@@ -1487,6 +1786,405 @@ async function logAgentEvent(db, runtimeDir, options) {
   return { runKey, taskKey };
 }
 
+// --- Squad Investigations CRUD ---
+
+function insertInvestigation(db, options = {}) {
+  const slug = options.investigationSlug || `inv-${slugify(options.domain || 'unknown')}-${Date.now()}`;
+  const now = nowIso();
+  db.prepare(`
+    INSERT OR REPLACE INTO squad_investigations
+      (investigation_slug, domain, mode, dimensions_covered, total_dimensions,
+       confidence, report_path, linked_squad_slug, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    slug,
+    String(options.domain || ''),
+    String(options.mode || 'full'),
+    Number(options.dimensionsCovered) || 0,
+    Number(options.totalDimensions) || 7,
+    Number(options.confidence) || 0,
+    options.reportPath || null,
+    options.linkedSquadSlug || null,
+    now,
+    now
+  );
+  return slug;
+}
+
+function listInvestigations(db) {
+  return db.prepare(`
+    SELECT * FROM squad_investigations ORDER BY created_at DESC
+  `).all();
+}
+
+function getInvestigation(db, slug) {
+  return db.prepare(`
+    SELECT * FROM squad_investigations WHERE investigation_slug = ?
+  `).get(slug) || null;
+}
+
+function linkInvestigation(db, investigationSlug, squadSlug) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE squad_investigations
+    SET linked_squad_slug = ?, updated_at = ?
+    WHERE investigation_slug = ?
+  `).run(squadSlug, now, investigationSlug);
+  return result.changes > 0;
+}
+
+// --- Implementation Plans CRUD ---
+
+function upsertImplementationPlan(db, options = {}) {
+  const planId = options.planId || `plan-${slugify(options.projectName || 'proj')}-${Date.now()}`;
+  const now = nowIso();
+  db.prepare(`
+    INSERT OR REPLACE INTO implementation_plans
+      (plan_id, project_name, scope, feature_slug, status, classification,
+       phases_total, phases_completed, source_artifacts, source_hash, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    planId,
+    options.projectName || null,
+    options.scope || 'project',
+    options.featureSlug || null,
+    options.status || 'draft',
+    options.classification || null,
+    Number(options.phasesTotal) || 0,
+    Number(options.phasesCompleted) || 0,
+    options.sourceArtifacts ? JSON.stringify(options.sourceArtifacts) : null,
+    options.sourceHash || null,
+    now,
+    now
+  );
+  return planId;
+}
+
+function getImplementationPlan(db, planId) {
+  return db.prepare(`
+    SELECT * FROM implementation_plans WHERE plan_id = ?
+  `).get(planId) || null;
+}
+
+function listImplementationPlans(db) {
+  return db.prepare(`
+    SELECT * FROM implementation_plans ORDER BY created_at DESC
+  `).all();
+}
+
+function updateImplementationPlanStatus(db, planId, status) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE implementation_plans SET status = ?, updated_at = ? WHERE plan_id = ?
+  `).run(status, now, planId);
+  return result.changes > 0;
+}
+
+function upsertPlanPhase(db, planId, phaseNumber, title, status) {
+  db.prepare(`
+    INSERT OR REPLACE INTO plan_phases (plan_id, phase_number, title, status, completed_at)
+    VALUES (?, ?, ?, ?, ?)
+  `).run(
+    planId,
+    phaseNumber,
+    title,
+    status || 'pending',
+    status === 'completed' ? nowIso() : null
+  );
+}
+
+function updatePlanPhaseStatus(db, planId, phaseNumber, status, notes) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE plan_phases SET status = ?, completed_at = ?, notes = ?
+    WHERE plan_id = ? AND phase_number = ?
+  `).run(
+    status,
+    status === 'completed' ? now : null,
+    notes || null,
+    planId,
+    phaseNumber
+  );
+  if (result.changes > 0 && status === 'completed') {
+    db.prepare(`
+      UPDATE implementation_plans
+      SET phases_completed = (SELECT COUNT(*) FROM plan_phases WHERE plan_id = ? AND status = 'completed'),
+          updated_at = ?
+      WHERE plan_id = ?
+    `).run(planId, now, planId);
+  }
+  return result.changes > 0;
+}
+
+function getPlanPhases(db, planId) {
+  return db.prepare(`
+    SELECT * FROM plan_phases WHERE plan_id = ? ORDER BY phase_number
+  `).all(planId);
+}
+
+// --- Squad Execution Plans CRUD ---
+
+function upsertSquadExecutionPlan(db, options = {}) {
+  const planSlug = options.planSlug || `sqplan-${slugify(options.squadSlug || 'squad')}-${Date.now()}`;
+  const now = nowIso();
+  db.prepare(`
+    INSERT OR REPLACE INTO squad_execution_plans
+      (plan_slug, squad_slug, status, rounds_total, rounds_completed,
+       based_on_blueprint, based_on_investigation, source_hash, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    planSlug,
+    options.squadSlug || '',
+    options.status || 'draft',
+    Number(options.roundsTotal) || 0,
+    Number(options.roundsCompleted) || 0,
+    options.basedOnBlueprint || null,
+    options.basedOnInvestigation || null,
+    options.sourceHash || null,
+    now,
+    now
+  );
+  return planSlug;
+}
+
+function getSquadExecutionPlan(db, planSlug) {
+  return db.prepare(`
+    SELECT * FROM squad_execution_plans WHERE plan_slug = ?
+  `).get(planSlug) || null;
+}
+
+function getSquadExecutionPlanBySquad(db, squadSlug) {
+  return db.prepare(`
+    SELECT * FROM squad_execution_plans WHERE squad_slug = ? ORDER BY created_at DESC LIMIT 1
+  `).get(squadSlug) || null;
+}
+
+function listSquadExecutionPlans(db) {
+  return db.prepare(`
+    SELECT * FROM squad_execution_plans ORDER BY created_at DESC
+  `).all();
+}
+
+function updateSquadExecutionPlanStatus(db, planSlug, status) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE squad_execution_plans SET status = ?, updated_at = ? WHERE plan_slug = ?
+  `).run(status, now, planSlug);
+  return result.changes > 0;
+}
+
+function upsertSquadPlanRound(db, planSlug, roundNumber, executorSlug, title, status) {
+  db.prepare(`
+    INSERT OR REPLACE INTO squad_plan_rounds (plan_slug, round_number, executor_slug, title, status, completed_at)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `).run(
+    planSlug,
+    roundNumber,
+    executorSlug,
+    title,
+    status || 'pending',
+    status === 'completed' ? nowIso() : null
+  );
+}
+
+function updateSquadPlanRoundStatus(db, planSlug, roundNumber, status, notes) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE squad_plan_rounds SET status = ?, completed_at = ?, notes = ?
+    WHERE plan_slug = ? AND round_number = ?
+  `).run(
+    status,
+    status === 'completed' ? now : null,
+    notes || null,
+    planSlug,
+    roundNumber
+  );
+  if (result.changes > 0 && status === 'completed') {
+    db.prepare(`
+      UPDATE squad_execution_plans
+      SET rounds_completed = (SELECT COUNT(*) FROM squad_plan_rounds WHERE plan_slug = ? AND status = 'completed'),
+          updated_at = ?
+      WHERE plan_slug = ?
+    `).run(planSlug, now, planSlug);
+  }
+  return result.changes > 0;
+}
+
+function getSquadPlanRounds(db, planSlug) {
+  return db.prepare(`
+    SELECT * FROM squad_plan_rounds WHERE plan_slug = ? ORDER BY round_number
+  `).all(planSlug);
+}
+
+// --- Squad Learnings CRUD ---
+
+function insertSquadLearning(db, options = {}) {
+  const learningId = options.learningId || `sl-${slugify(options.squadSlug || 'squad')}-${Date.now()}`;
+  const now = nowIso();
+  db.prepare(`
+    INSERT OR REPLACE INTO squad_learnings
+      (learning_id, squad_slug, type, title, signal, confidence, frequency,
+       last_reinforced, applies_to, file_path, promoted_to, status,
+       source_session, evidence, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    learningId,
+    options.squadSlug || '',
+    options.type || 'preference',
+    options.title || '',
+    options.signal || 'explicit',
+    options.confidence || 'medium',
+    Number(options.frequency) || 1,
+    options.lastReinforced || now,
+    options.appliesTo || 'squad',
+    options.filePath || null,
+    options.promotedTo || null,
+    options.status || 'active',
+    options.sourceSession || null,
+    options.evidence || null,
+    now,
+    now
+  );
+  return learningId;
+}
+
+function listSquadLearnings(db, squadSlug, statusFilter) {
+  if (statusFilter) {
+    return db.prepare(`
+      SELECT * FROM squad_learnings WHERE squad_slug = ? AND status = ? ORDER BY created_at DESC
+    `).all(squadSlug, statusFilter);
+  }
+  return db.prepare(`
+    SELECT * FROM squad_learnings WHERE squad_slug = ? ORDER BY created_at DESC
+  `).all(squadSlug);
+}
+
+function getSquadLearning(db, learningId) {
+  return db.prepare(`
+    SELECT * FROM squad_learnings WHERE learning_id = ?
+  `).get(learningId) || null;
+}
+
+function updateSquadLearningStatus(db, learningId, status) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE squad_learnings SET status = ?, updated_at = ? WHERE learning_id = ?
+  `).run(status, now, learningId);
+  return result.changes > 0;
+}
+
+function reinforceSquadLearning(db, learningId) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE squad_learnings SET frequency = frequency + 1, last_reinforced = ?, updated_at = ? WHERE learning_id = ?
+  `).run(now, now, learningId);
+  return result.changes > 0;
+}
+
+function promoteSquadLearning(db, learningId, promotedTo) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE squad_learnings SET status = 'promoted', promoted_to = ?, updated_at = ? WHERE learning_id = ?
+  `).run(promotedTo, now, learningId);
+  return result.changes > 0;
+}
+
+function archiveStaleSquadLearnings(db, squadSlug, staleDays) {
+  const days = Number(staleDays) || 90;
+  const cutoff = new Date(Date.now() - days * 86400000).toISOString();
+  const result = db.prepare(`
+    UPDATE squad_learnings SET status = 'stale', updated_at = datetime('now')
+    WHERE squad_slug = ? AND status = 'active' AND last_reinforced < ?
+  `).run(squadSlug, cutoff);
+  return result.changes;
+}
+
+function getSquadLearningStats(db, squadSlug) {
+  return db.prepare(`
+    SELECT type, status, COUNT(*) as count FROM squad_learnings
+    WHERE squad_slug = ? GROUP BY type, status ORDER BY type, status
+  `).all(squadSlug);
+}
+
+// --- Project Learnings CRUD ---
+
+function insertProjectLearning(db, options = {}) {
+  const learningId = options.learningId || `pl-${slugify(options.projectName || 'proj')}-${Date.now()}`;
+  const now = nowIso();
+  db.prepare(`
+    INSERT OR REPLACE INTO project_learnings
+      (learning_id, project_name, feature_slug, type, title, confidence, frequency,
+       last_reinforced, applies_to, promoted_to, status,
+       source_session, evidence, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    learningId,
+    options.projectName || null,
+    options.featureSlug || null,
+    options.type || 'preference',
+    options.title || '',
+    options.confidence || 'medium',
+    Number(options.frequency) || 1,
+    options.lastReinforced || now,
+    options.appliesTo || 'project',
+    options.promotedTo || null,
+    options.status || 'active',
+    options.sourceSession || null,
+    options.evidence || null,
+    now,
+    now
+  );
+  return learningId;
+}
+
+function listProjectLearnings(db, statusFilter) {
+  if (statusFilter) {
+    return db.prepare(`
+      SELECT * FROM project_learnings WHERE status = ? ORDER BY created_at DESC
+    `).all(statusFilter);
+  }
+  return db.prepare(`
+    SELECT * FROM project_learnings ORDER BY created_at DESC
+  `).all();
+}
+
+function getProjectLearning(db, learningId) {
+  return db.prepare(`
+    SELECT * FROM project_learnings WHERE learning_id = ?
+  `).get(learningId) || null;
+}
+
+function updateProjectLearningStatus(db, learningId, status) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE project_learnings SET status = ?, updated_at = ? WHERE learning_id = ?
+  `).run(status, now, learningId);
+  return result.changes > 0;
+}
+
+function reinforceProjectLearning(db, learningId) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE project_learnings SET frequency = frequency + 1, last_reinforced = ?, updated_at = ? WHERE learning_id = ?
+  `).run(now, now, learningId);
+  return result.changes > 0;
+}
+
+function promoteProjectLearning(db, learningId, promotedTo) {
+  const now = nowIso();
+  const result = db.prepare(`
+    UPDATE project_learnings SET status = 'promoted', promoted_to = ?, updated_at = ? WHERE learning_id = ?
+  `).run(promotedTo, now, learningId);
+  return result.changes > 0;
+}
+
+function getProjectLearningStats(db) {
+  return db.prepare(`
+    SELECT type, status, COUNT(*) as count FROM project_learnings
+    GROUP BY type, status ORDER BY type, status
+  `).all();
+}
+
 module.exports = {
   resolveRuntimePaths,
   runtimeStoreExists,
@@ -1505,6 +2203,7 @@ module.exports = {
   appendRunEvent,
   logAgentEvent,
   readAgentSession,
+  writeAgentSession,
   clearAgentSession,
   // Pipeline CRUD
   upsertPipeline,
@@ -1523,5 +2222,44 @@ module.exports = {
   listArtisanSquads,
   deleteArtisanSquad,
   addArtisanMessage,
-  getArtisanMessages
+  getArtisanMessages,
+  // Investigation CRUD
+  insertInvestigation,
+  listInvestigations,
+  getInvestigation,
+  linkInvestigation,
+  // Implementation Plans CRUD
+  upsertImplementationPlan,
+  getImplementationPlan,
+  listImplementationPlans,
+  updateImplementationPlanStatus,
+  upsertPlanPhase,
+  updatePlanPhaseStatus,
+  getPlanPhases,
+  // Squad Execution Plans CRUD
+  upsertSquadExecutionPlan,
+  getSquadExecutionPlan,
+  getSquadExecutionPlanBySquad,
+  listSquadExecutionPlans,
+  updateSquadExecutionPlanStatus,
+  upsertSquadPlanRound,
+  updateSquadPlanRoundStatus,
+  getSquadPlanRounds,
+  // Squad Learnings CRUD
+  insertSquadLearning,
+  listSquadLearnings,
+  getSquadLearning,
+  updateSquadLearningStatus,
+  reinforceSquadLearning,
+  promoteSquadLearning,
+  archiveStaleSquadLearnings,
+  getSquadLearningStats,
+  // Project Learnings CRUD
+  insertProjectLearning,
+  listProjectLearnings,
+  getProjectLearning,
+  updateProjectLearningStatus,
+  reinforceProjectLearning,
+  promoteProjectLearning,
+  getProjectLearningStats
 };