@usejarvis/brain 0.1.0

package/src/vault/awareness.ts

@@ -0,0 +1,341 @@
+/**
+ * Vault — Awareness CRUD
+ *
+ * Database operations for screen_captures, awareness_sessions, and awareness_suggestions tables.
+ * Follows the same patterns as observations.ts and commitments.ts.
+ */
+
+import { getDb, generateId } from './schema.ts';
+import type {
+  ScreenCaptureRow,
+  SessionRow,
+  SuggestionRow,
+  SuggestionType,
+  AppUsageStat,
+} from '../awareness/types.ts';
+
+// ── Screen Captures ──
+
+export function createCapture(data: {
+  timestamp: number;
+  sessionId?: string;
+  imagePath?: string;
+  thumbnailPath?: string;
+  pixelChangePct: number;
+  ocrText?: string;
+  appName?: string;
+  windowTitle?: string;
+  url?: string;
+  filePath?: string;
+  retentionTier?: 'full' | 'key_moment' | 'metadata_only';
+}): ScreenCaptureRow {
+  const db = getDb();
+  const id = generateId();
+  const now = Date.now();
+
+  db.prepare(`
+    INSERT INTO screen_captures
+      (id, timestamp, session_id, image_path, thumbnail_path, pixel_change_pct,
+       ocr_text, app_name, window_title, url, file_path, retention_tier, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    id,
+    data.timestamp,
+    data.sessionId ?? null,
+    data.imagePath ?? null,
+    data.thumbnailPath ?? null,
+    data.pixelChangePct,
+    data.ocrText ?? null,
+    data.appName ?? null,
+    data.windowTitle ?? null,
+    data.url ?? null,
+    data.filePath ?? null,
+    data.retentionTier ?? 'full',
+    now,
+  );
+
+  return {
+    id,
+    timestamp: data.timestamp,
+    session_id: data.sessionId ?? null,
+    image_path: data.imagePath ?? null,
+    thumbnail_path: data.thumbnailPath ?? null,
+    pixel_change_pct: data.pixelChangePct,
+    ocr_text: data.ocrText ?? null,
+    app_name: data.appName ?? null,
+    window_title: data.windowTitle ?? null,
+    url: data.url ?? null,
+    file_path: data.filePath ?? null,
+    retention_tier: data.retentionTier ?? 'full',
+    created_at: now,
+  };
+}
+
+export function getCapture(id: string): ScreenCaptureRow | null {
+  const db = getDb();
+  return db.prepare('SELECT * FROM screen_captures WHERE id = ?').get(id) as ScreenCaptureRow | null;
+}
+
+export function getRecentCaptures(limit: number = 50, appName?: string): ScreenCaptureRow[] {
+  const db = getDb();
+  if (appName) {
+    return db.prepare(
+      'SELECT * FROM screen_captures WHERE app_name = ? ORDER BY timestamp DESC LIMIT ?'
+    ).all(appName, limit) as ScreenCaptureRow[];
+  }
+  return db.prepare(
+    'SELECT * FROM screen_captures ORDER BY timestamp DESC LIMIT ?'
+  ).all(limit) as ScreenCaptureRow[];
+}
+
+export function getCapturesInRange(startTime: number, endTime: number): ScreenCaptureRow[] {
+  const db = getDb();
+  return db.prepare(
+    'SELECT * FROM screen_captures WHERE timestamp >= ? AND timestamp <= ? ORDER BY timestamp ASC'
+  ).all(startTime, endTime) as ScreenCaptureRow[];
+}
+
+export function getAppUsageStats(startTime: number, endTime: number): AppUsageStat[] {
+  const db = getDb();
+  const rows = db.prepare(`
+    SELECT app_name, COUNT(*) as capture_count
+    FROM screen_captures
+    WHERE timestamp >= ? AND timestamp <= ? AND app_name IS NOT NULL
+    GROUP BY app_name
+    ORDER BY capture_count DESC
+  `).all(startTime, endTime) as Array<{ app_name: string; capture_count: number }>;
+
+  const totalCaptures = rows.reduce((sum, r) => sum + r.capture_count, 0);
+
+  return rows.map(r => ({
+    app: r.app_name,
+    captureCount: r.capture_count,
+    minutes: Math.round((r.capture_count * 7) / 60),  // ~7s per capture
+    percentage: totalCaptures > 0 ? Math.round((r.capture_count / totalCaptures) * 100) : 0,
+  }));
+}
+
+export function getCaptureCountSince(timestamp: number): number {
+  const db = getDb();
+  const row = db.prepare(
+    'SELECT COUNT(*) as count FROM screen_captures WHERE timestamp >= ?'
+  ).get(timestamp) as { count: number };
+  return row.count;
+}
+
+export function updateCaptureRetention(id: string, tier: 'full' | 'key_moment' | 'metadata_only'): void {
+  const db = getDb();
+  db.prepare('UPDATE screen_captures SET retention_tier = ? WHERE id = ?').run(tier, id);
+}
+
+export function deleteCapturesBefore(timestamp: number, retentionTier: string): number {
+  const db = getDb();
+  const result = db.prepare(
+    'DELETE FROM screen_captures WHERE timestamp < ? AND retention_tier = ?'
+  ).run(timestamp, retentionTier);
+  return result.changes;
+}
+
+export function updateCaptureOcrText(id: string, ocrText: string): void {
+  const db = getDb();
+  db.prepare('UPDATE screen_captures SET ocr_text = ? WHERE id = ?').run(ocrText, id);
+}
+
+export function getCapturesForSession(sessionId: string, limit: number = 50): ScreenCaptureRow[] {
+  const db = getDb();
+  return db.prepare(
+    'SELECT * FROM screen_captures WHERE session_id = ? ORDER BY timestamp DESC LIMIT ?'
+  ).all(sessionId, limit) as ScreenCaptureRow[];
+}
+
+// ── Awareness Sessions ──
+
+export function createSession(data: {
+  startedAt: number;
+  apps?: string[];
+  projectContext?: string;
+}): SessionRow {
+  const db = getDb();
+  const id = generateId();
+  const now = Date.now();
+
+  db.prepare(`
+    INSERT INTO awareness_sessions
+      (id, started_at, ended_at, topic, apps, project_context, action_types, entity_links, summary, capture_count, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    id,
+    data.startedAt,
+    null,
+    null,
+    JSON.stringify(data.apps ?? []),
+    data.projectContext ?? null,
+    JSON.stringify([]),
+    JSON.stringify([]),
+    null,
+    0,
+    now,
+  );
+
+  return {
+    id,
+    started_at: data.startedAt,
+    ended_at: null,
+    topic: null,
+    apps: JSON.stringify(data.apps ?? []),
+    project_context: data.projectContext ?? null,
+    action_types: JSON.stringify([]),
+    entity_links: JSON.stringify([]),
+    summary: null,
+    capture_count: 0,
+    created_at: now,
+  };
+}
+
+export function getSession(id: string): SessionRow | null {
+  const db = getDb();
+  return db.prepare('SELECT * FROM awareness_sessions WHERE id = ?').get(id) as SessionRow | null;
+}
+
+export function updateSession(id: string, updates: Partial<{
+  ended_at: number | null;
+  topic: string | null;
+  apps: string[];
+  project_context: string | null;
+  action_types: string[];
+  entity_links: string[];
+  summary: string | null;
+  capture_count: number;
+}>): void {
+  const db = getDb();
+  const setClauses: string[] = [];
+  const params: unknown[] = [];
+
+  if (updates.ended_at !== undefined) { setClauses.push('ended_at = ?'); params.push(updates.ended_at); }
+  if (updates.topic !== undefined) { setClauses.push('topic = ?'); params.push(updates.topic); }
+  if (updates.apps !== undefined) { setClauses.push('apps = ?'); params.push(JSON.stringify(updates.apps)); }
+  if (updates.project_context !== undefined) { setClauses.push('project_context = ?'); params.push(updates.project_context); }
+  if (updates.action_types !== undefined) { setClauses.push('action_types = ?'); params.push(JSON.stringify(updates.action_types)); }
+  if (updates.entity_links !== undefined) { setClauses.push('entity_links = ?'); params.push(JSON.stringify(updates.entity_links)); }
+  if (updates.summary !== undefined) { setClauses.push('summary = ?'); params.push(updates.summary); }
+  if (updates.capture_count !== undefined) { setClauses.push('capture_count = ?'); params.push(updates.capture_count); }
+
+  if (setClauses.length === 0) return;
+
+  params.push(id);
+  db.prepare(`UPDATE awareness_sessions SET ${setClauses.join(', ')} WHERE id = ?`).run(...params as any[]);
+}
+
+export function endSession(id: string, summary?: string): void {
+  const db = getDb();
+  db.prepare(
+    'UPDATE awareness_sessions SET ended_at = ?, summary = ? WHERE id = ?'
+  ).run(Date.now(), summary ?? null, id);
+}
+
+export function getRecentSessions(limit: number = 20): SessionRow[] {
+  const db = getDb();
+  return db.prepare(
+    'SELECT * FROM awareness_sessions ORDER BY started_at DESC LIMIT ?'
+  ).all(limit) as SessionRow[];
+}
+
+export function incrementSessionCaptureCount(id: string): void {
+  const db = getDb();
+  db.prepare(
+    'UPDATE awareness_sessions SET capture_count = capture_count + 1 WHERE id = ?'
+  ).run(id);
+}
+
+// ── Awareness Suggestions ──
+
+export function createSuggestion(data: {
+  type: SuggestionType;
+  triggerCaptureId?: string;
+  title: string;
+  body: string;
+  context?: Record<string, unknown>;
+}): SuggestionRow {
+  const db = getDb();
+  const id = generateId();
+  const now = Date.now();
+
+  db.prepare(`
+    INSERT INTO awareness_suggestions
+      (id, type, trigger_capture_id, title, body, context, delivered, delivered_at, delivery_channel, dismissed, acted_on, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    id,
+    data.type,
+    data.triggerCaptureId ?? null,
+    data.title,
+    data.body,
+    data.context ? JSON.stringify(data.context) : null,
+    0, null, null, 0, 0,
+    now,
+  );
+
+  return {
+    id,
+    type: data.type,
+    trigger_capture_id: data.triggerCaptureId ?? null,
+    title: data.title,
+    body: data.body,
+    context: data.context ? JSON.stringify(data.context) : null,
+    delivered: 0,
+    delivered_at: null,
+    delivery_channel: null,
+    dismissed: 0,
+    acted_on: 0,
+    created_at: now,
+  };
+}
+
+export function markSuggestionDelivered(id: string, channel: string): void {
+  const db = getDb();
+  db.prepare(
+    'UPDATE awareness_suggestions SET delivered = 1, delivered_at = ?, delivery_channel = ? WHERE id = ?'
+  ).run(Date.now(), channel, id);
+}
+
+export function markSuggestionDismissed(id: string): void {
+  const db = getDb();
+  db.prepare('UPDATE awareness_suggestions SET dismissed = 1 WHERE id = ?').run(id);
+}
+
+export function markSuggestionActedOn(id: string): void {
+  const db = getDb();
+  db.prepare('UPDATE awareness_suggestions SET acted_on = 1 WHERE id = ?').run(id);
+}
+
+export function getRecentSuggestions(limit: number = 20, type?: SuggestionType): SuggestionRow[] {
+  const db = getDb();
+  if (type) {
+    return db.prepare(
+      'SELECT * FROM awareness_suggestions WHERE type = ? ORDER BY created_at DESC LIMIT ?'
+    ).all(type, limit) as SuggestionRow[];
+  }
+  return db.prepare(
+    'SELECT * FROM awareness_suggestions ORDER BY created_at DESC LIMIT ?'
+  ).all(limit) as SuggestionRow[];
+}
+
+export function getSuggestionCountSince(timestamp: number): number {
+  const db = getDb();
+  const row = db.prepare(
+    'SELECT COUNT(*) as count FROM awareness_suggestions WHERE created_at >= ?'
+  ).get(timestamp) as { count: number };
+  return row.count;
+}
+
+export function getSuggestionStats(startTime: number, endTime: number): { total: number; actedOn: number } {
+  const db = getDb();
+  const row = db.prepare(`
+    SELECT
+      COUNT(*) as total,
+      SUM(CASE WHEN acted_on = 1 THEN 1 ELSE 0 END) as acted_on
+    FROM awareness_suggestions
+    WHERE created_at >= ? AND created_at <= ?
+  `).get(startTime, endTime) as { total: number; acted_on: number };
+  return { total: row.total, actedOn: row.acted_on ?? 0 };
+}

package/src/vault/commitments.ts

@@ -0,0 +1,299 @@
+import { getDb, generateId } from './schema.ts';
+
+export type CommitmentPriority = 'low' | 'normal' | 'high' | 'critical';
+export type CommitmentStatus = 'pending' | 'active' | 'completed' | 'failed' | 'escalated';
+
+export type RetryPolicy = {
+  max_retries: number;
+  interval_ms: number;
+  escalate_after: number;
+};
+
+export type Commitment = {
+  id: string;
+  what: string;
+  when_due: number | null;
+  context: string | null;
+  priority: CommitmentPriority;
+  status: CommitmentStatus;
+  retry_policy: RetryPolicy | null;
+  created_from: string | null;
+  assigned_to: string | null;
+  created_at: number;
+  completed_at: number | null;
+  result: string | null;
+  sort_order: number;
+};
+
+type CommitmentRow = {
+  id: string;
+  what: string;
+  when_due: number | null;
+  context: string | null;
+  priority: CommitmentPriority;
+  status: CommitmentStatus;
+  retry_policy: string | null;
+  created_from: string | null;
+  assigned_to: string | null;
+  created_at: number;
+  completed_at: number | null;
+  result: string | null;
+  sort_order: number;
+};
+
+/**
+ * Parse commitment row from database, deserializing JSON fields
+ */
+function parseCommitment(row: CommitmentRow): Commitment {
+  return {
+    ...row,
+    retry_policy: row.retry_policy ? JSON.parse(row.retry_policy) : null,
+  };
+}
+
+/**
+ * Create a new commitment
+ */
+export function createCommitment(
+  what: string,
+  opts?: {
+    when_due?: number;
+    context?: string;
+    priority?: CommitmentPriority;
+    retry_policy?: RetryPolicy;
+    created_from?: string;
+    assigned_to?: string;
+  }
+): Commitment {
+  const db = getDb();
+  const id = generateId();
+  const now = Date.now();
+  const priority = opts?.priority ?? 'normal';
+
+  const stmt = db.prepare(
+    'INSERT INTO commitments (id, what, when_due, context, priority, status, retry_policy, created_from, assigned_to, created_at, completed_at, result) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)'
+  );
+
+  stmt.run(
+    id,
+    what,
+    opts?.when_due ?? null,
+    opts?.context ?? null,
+    priority,
+    'pending',
+    opts?.retry_policy ? JSON.stringify(opts.retry_policy) : null,
+    opts?.created_from ?? null,
+    opts?.assigned_to ?? null,
+    now,
+    null,
+    null
+  );
+
+  return {
+    id,
+    what,
+    when_due: opts?.when_due ?? null,
+    context: opts?.context ?? null,
+    priority,
+    status: 'pending',
+    retry_policy: opts?.retry_policy ?? null,
+    created_from: opts?.created_from ?? null,
+    assigned_to: opts?.assigned_to ?? null,
+    created_at: now,
+    completed_at: null,
+    result: null,
+    sort_order: 0,
+  };
+}
+
+/**
+ * Get a commitment by ID
+ */
+export function getCommitment(id: string): Commitment | null {
+  const db = getDb();
+  const stmt = db.prepare('SELECT * FROM commitments WHERE id = ?');
+  const row = stmt.get(id) as CommitmentRow | null;
+
+  if (!row) return null;
+
+  return parseCommitment(row);
+}
+
+/**
+ * Find commitments matching query criteria
+ */
+export function findCommitments(query: {
+  status?: CommitmentStatus;
+  priority?: CommitmentPriority;
+  assigned_to?: string;
+  overdue?: boolean;
+}): Commitment[] {
+  const db = getDb();
+  const conditions: string[] = [];
+  const params: unknown[] = [];
+
+  if (query.status) {
+    conditions.push('status = ?');
+    params.push(query.status);
+  }
+
+  if (query.priority) {
+    conditions.push('priority = ?');
+    params.push(query.priority);
+  }
+
+  if (query.assigned_to) {
+    conditions.push('assigned_to = ?');
+    params.push(query.assigned_to);
+  }
+
+  if (query.overdue) {
+    conditions.push('when_due IS NOT NULL AND when_due <= ?');
+    params.push(Date.now());
+    conditions.push("status IN ('pending', 'active')");
+  }
+
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+  const stmt = db.prepare(`SELECT * FROM commitments ${where} ORDER BY sort_order ASC, created_at DESC`);
+  const rows = stmt.all(...params as any[]) as CommitmentRow[];
+
+  return rows.map(parseCommitment);
+}
+
+/**
+ * Get upcoming commitments, ordered by due date
+ */
+export function getUpcoming(limit: number = 10): Commitment[] {
+  const db = getDb();
+  const stmt = db.prepare(
+    "SELECT * FROM commitments WHERE status IN ('pending', 'active') AND when_due IS NOT NULL ORDER BY when_due ASC LIMIT ?"
+  );
+  const rows = stmt.all(limit) as CommitmentRow[];
+
+  return rows.map(parseCommitment);
+}
+
+/**
+ * Mark a commitment as completed
+ */
+export function completeCommitment(id: string, result?: string): Commitment | null {
+  const db = getDb();
+  const commitment = getCommitment(id);
+  if (!commitment) return null;
+
+  const stmt = db.prepare(
+    'UPDATE commitments SET status = ?, completed_at = ?, result = ? WHERE id = ?'
+  );
+  stmt.run('completed', Date.now(), result ?? null, id);
+
+  return getCommitment(id);
+}
+
+/**
+ * Mark a commitment as failed
+ */
+export function failCommitment(id: string, reason?: string): Commitment | null {
+  const db = getDb();
+  const commitment = getCommitment(id);
+  if (!commitment) return null;
+
+  const stmt = db.prepare(
+    'UPDATE commitments SET status = ?, completed_at = ?, result = ? WHERE id = ?'
+  );
+  stmt.run('failed', Date.now(), reason ?? null, id);
+
+  return getCommitment(id);
+}
+
+/**
+ * Escalate a commitment
+ */
+export function escalateCommitment(id: string): Commitment | null {
+  const db = getDb();
+  const commitment = getCommitment(id);
+  if (!commitment) return null;
+
+  const stmt = db.prepare('UPDATE commitments SET status = ? WHERE id = ?');
+  stmt.run('escalated', id);
+
+  return getCommitment(id);
+}
+
+/**
+ * Get commitments that are currently due
+ */
+export function getDueCommitments(): Commitment[] {
+  const db = getDb();
+  const now = Date.now();
+  const stmt = db.prepare(
+    "SELECT * FROM commitments WHERE when_due IS NOT NULL AND when_due <= ? AND status IN ('pending', 'active') ORDER BY when_due ASC"
+  );
+  const rows = stmt.all(now) as CommitmentRow[];
+
+  return rows.map(parseCommitment);
+}
+
+/**
+ * Update a commitment's status to any valid status.
+ * Sets completed_at for terminal states (completed, failed).
+ */
+export function updateCommitmentStatus(
+  id: string,
+  status: CommitmentStatus,
+  result?: string
+): Commitment | null {
+  const db = getDb();
+  const commitment = getCommitment(id);
+  if (!commitment) return null;
+
+  const isTerminal = status === 'completed' || status === 'failed';
+  const completedAt = isTerminal ? Date.now() : null;
+
+  db.prepare(
+    'UPDATE commitments SET status = ?, completed_at = ?, result = ? WHERE id = ?'
+  ).run(status, completedAt, result ?? null, id);
+
+  return getCommitment(id);
+}
+
+/**
+ * Update a commitment's assigned_to field.
+ */
+export function updateCommitmentAssignee(id: string, assignedTo: string): Commitment | null {
+  const db = getDb();
+  const commitment = getCommitment(id);
+  if (!commitment) return null;
+
+  db.prepare('UPDATE commitments SET assigned_to = ? WHERE id = ?').run(assignedTo, id);
+  return getCommitment(id);
+}
+
+/**
+ * Update a commitment's due date.
+ */
+export function updateCommitmentDue(id: string, when_due: number | null): Commitment | null {
+  const db = getDb();
+  const commitment = getCommitment(id);
+  if (!commitment) return null;
+
+  db.prepare('UPDATE commitments SET when_due = ? WHERE id = ?').run(when_due, id);
+  return getCommitment(id);
+}
+
+/**
+ * Bulk update sort order for commitments (used by kanban drag & drop).
+ */
+export function reorderCommitments(
+  items: { id: string; sort_order: number }[]
+): void {
+  const db = getDb();
+  const stmt = db.prepare('UPDATE commitments SET sort_order = ? WHERE id = ?');
+
+  const transaction = db.transaction(() => {
+    for (const item of items) {
+      stmt.run(item.sort_order, item.id);
+    }
+  });
+
+  transaction();
+}