@hasna/recordings 0.1.7 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/recordings",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "description": "Speech-to-text recording tool with MCP and CLI — records, transcribes, and optionally enhances text using AI",
   "main": "dist/index.js",
@@ -27,6 +27,7 @@
     "dev:mcp": "bun run src/mcp/index.ts"
   },
   "dependencies": {
+    "@hasna/cloud": "^0.1.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",

package/src/cli/index.ts

@@ -2,7 +2,7 @@
 import { Command } from "commander";
 import chalk from "chalk";
 import { loadConfig, ensureDataDir } from "../lib/config.js";
-import { getDatabase } from "../db/database.js";
+import { getDatabase, getAdapter } from "../db/database.js";
 import {
   createRecording,
   getRecording,
@@ -1094,6 +1094,23 @@ program
     }
   });
 
+// ── Feedback ────────────────────────────────────────────────────────────────
+
+program
+  .command("feedback <message>")
+  .description("Send feedback")
+  .option("--email <email>", "Contact email")
+  .option("--category <category>", "Category: bug, feature, general")
+  .action((message: string, opts: { email?: string; category?: string }) => {
+    const adapter = getAdapter();
+    const pkg = require("../../package.json");
+    adapter.run(
+      "INSERT INTO feedback (message, email, category, version) VALUES (?, ?, ?, ?)",
+      message, opts.email || null, opts.category || "general", pkg.version
+    );
+    console.log(chalk.green("Feedback saved. Thank you!"));
+  });
+
 // ── Run ─────────────────────────────────────────────────────────────────────
 
 program.parse();

package/src/db/agents.ts

@@ -79,3 +79,26 @@ export function listAgents(db?: Database): Agent[] {
     .all() as Record<string, unknown>[];
   return rows.map(parseAgent);
 }
+
+export function heartbeatAgent(idOrName: string, db?: Database): Agent | null {
+  const d = db || getDatabase();
+  const agent = getAgent(idOrName, d);
+  if (!agent) return null;
+  d.query("UPDATE agents SET last_seen_at = ? WHERE id = ?").run(
+    new Date().toISOString(),
+    agent.id
+  );
+  return getAgent(agent.id, d);
+}
+
+export function setAgentFocus(idOrName: string, projectId: string | null, db?: Database): Agent | null {
+  const d = db || getDatabase();
+  const agent = getAgent(idOrName, d);
+  if (!agent) return null;
+  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(
+    projectId,
+    new Date().toISOString(),
+    agent.id
+  );
+  return getAgent(agent.id, d);
+}

package/src/db/database.ts

@@ -1,9 +1,11 @@
 import { Database } from "bun:sqlite";
+import { SqliteAdapter } from "@hasna/cloud";
 import { mkdirSync } from "fs";
 import { dirname } from "path";
 import { loadConfig } from "../lib/config.js";
 
 let _db: Database | null = null;
+let _adapter: SqliteAdapter | null = null;
 
 const MIGRATIONS = [
   // Migration 0: Initial schema
@@ -71,6 +73,24 @@ const MIGRATIONS = [
   ALTER TABLE recordings ADD COLUMN task_list_id TEXT;
   INSERT OR IGNORE INTO _migrations (id) VALUES (2);
   `,
+
+  // Migration 3: feedback table
+  `
+  CREATE TABLE IF NOT EXISTS feedback (
+    id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+    message TEXT NOT NULL,
+    email TEXT,
+    category TEXT DEFAULT 'general',
+    version TEXT,
+    machine_id TEXT,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  `,
+
+  // Migration 4: agent focus
+  `
+  ALTER TABLE agents ADD COLUMN active_project_id TEXT REFERENCES projects(id) ON DELETE SET NULL;
+  `,
 ];
 
 export function getDatabase(dbPath?: string): Database {
@@ -82,12 +102,11 @@ export function getDatabase(dbPath?: string): Database {
   const dir = dirname(path);
   mkdirSync(dir, { recursive: true });
 
-  _db = new Database(path, { create: true });
+  _adapter = new SqliteAdapter(path);
+  _db = _adapter.raw;
 
-  // Pragmas for production SQLite
-  _db.run("PRAGMA journal_mode = WAL");
+  // SqliteAdapter already sets WAL and foreign_keys; add busy_timeout
   _db.run("PRAGMA busy_timeout = 5000");
-  _db.run("PRAGMA foreign_keys = ON");
 
   runMigrations(_db);
   return _db;
@@ -118,11 +137,21 @@ export function closeDatabase(): void {
   if (_db) {
     _db.close();
     _db = null;
+    _adapter = null;
   }
 }
 
 export function resetDatabase(): void {
   _db = null;
+  _adapter = null;
+}
+
+/** Get the SqliteAdapter for direct SQL queries (e.g. feedback). */
+export function getAdapter(): SqliteAdapter {
+  if (!_adapter) {
+    getDatabase(); // force initialization
+  }
+  return _adapter!;
 }
 
 export function getDbPath(): string {

package/src/db/pg-migrations.ts

@@ -0,0 +1,82 @@
+/**
+ * PostgreSQL migrations for open-recordings cloud sync.
+ *
+ * Equivalent to the SQLite schema in database.ts, translated for PostgreSQL.
+ */
+
+export const PG_MIGRATIONS: string[] = [
+  // Migration 0: Initial schema — projects, agents, recordings, recording_tags
+  `CREATE TABLE IF NOT EXISTS projects (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    path TEXT UNIQUE NOT NULL,
+    description TEXT,
+    created_at TEXT NOT NULL DEFAULT NOW()::text,
+    updated_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS agents (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL UNIQUE,
+    description TEXT,
+    role TEXT DEFAULT 'agent',
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT NOW()::text,
+    last_seen_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS recordings (
+    id TEXT PRIMARY KEY,
+    audio_path TEXT,
+    raw_text TEXT NOT NULL,
+    processed_text TEXT,
+    processing_mode TEXT NOT NULL DEFAULT 'raw' CHECK(processing_mode IN ('raw', 'enhanced')),
+    model_used TEXT NOT NULL DEFAULT 'gpt-4o-mini-transcribe',
+    enhancement_model TEXT,
+    duration_ms INTEGER DEFAULT 0,
+    language TEXT,
+    tags TEXT DEFAULT '[]',
+    agent_id TEXT REFERENCES agents(id) ON DELETE SET NULL,
+    project_id TEXT REFERENCES projects(id) ON DELETE SET NULL,
+    session_id TEXT,
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS recording_tags (
+    recording_id TEXT NOT NULL REFERENCES recordings(id) ON DELETE CASCADE,
+    tag TEXT NOT NULL,
+    PRIMARY KEY (recording_id, tag)
+  )`,
+
+  `CREATE TABLE IF NOT EXISTS _migrations (
+    id INTEGER PRIMARY KEY,
+    applied_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+
+  `CREATE INDEX IF NOT EXISTS idx_recordings_agent ON recordings(agent_id)`,
+  `CREATE INDEX IF NOT EXISTS idx_recordings_project ON recordings(project_id)`,
+  `CREATE INDEX IF NOT EXISTS idx_recordings_session ON recordings(session_id)`,
+  `CREATE INDEX IF NOT EXISTS idx_recordings_created ON recordings(created_at)`,
+  `CREATE INDEX IF NOT EXISTS idx_recordings_mode ON recordings(processing_mode)`,
+  `CREATE INDEX IF NOT EXISTS idx_recording_tags_tag ON recording_tags(tag)`,
+
+  // Migration 2: session tagging attributes
+  `ALTER TABLE recordings ADD COLUMN IF NOT EXISTS goal TEXT`,
+  `ALTER TABLE recordings ADD COLUMN IF NOT EXISTS role TEXT`,
+  `ALTER TABLE recordings ADD COLUMN IF NOT EXISTS task_list_id TEXT`,
+
+  // Migration 3: feedback table
+  `CREATE TABLE IF NOT EXISTS feedback (
+    id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+    message TEXT NOT NULL,
+    email TEXT,
+    category TEXT DEFAULT 'general',
+    version TEXT,
+    machine_id TEXT,
+    created_at TEXT NOT NULL DEFAULT NOW()::text
+  )`,
+
+  // Migration 4: agent focus
+  `ALTER TABLE agents ADD COLUMN IF NOT EXISTS active_project_id TEXT REFERENCES projects(id) ON DELETE SET NULL`,
+];

package/src/mcp/index.ts

@@ -3,7 +3,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { loadConfig, ensureDataDir } from "../lib/config.js";
-import { getDatabase } from "../db/database.js";
+import { getDatabase, getAdapter } from "../db/database.js";
 import {
   createRecording,
   getRecording,
@@ -12,7 +12,7 @@ import {
   searchRecordings,
   getRecordingStats,
 } from "../db/recordings.js";
-import { registerAgent, getAgent, listAgents } from "../db/agents.js";
+import { registerAgent, getAgent, listAgents, heartbeatAgent, setAgentFocus } from "../db/agents.js";
 import {
   registerProject,
   getProject,
@@ -77,9 +77,11 @@ const toolDocs: Record<string, string> = {
   delete_recording: "Delete recording by ID.\nParams: id (string, required)",
   recording_stats: "Recording count, mode breakdown, duration.\nParams: none",
   detect_enhancement: "Check if text needs AI enhancement.\nParams: text (string, required)",
-  register_agent: "Register agent (idempotent).\nParams: name (string, required) | description (string) | role (string)",
+  register_agent: "Register agent (idempotent). Auto-updates last_seen_at on re-register.\nParams: name (string, required) | description (string) | role (string)",
   list_agents: "List registered agents.\nParams: none",
   get_agent: "Get agent by ID or name.\nParams: id (string, required)",
+  heartbeat: "Update last_seen_at to signal agent is active.\nParams: agent_id (string, required): agent ID or name",
+  set_focus: "Set active project context for this agent session.\nParams: agent_id (string, required) | project_id (string, nullable): project ID or null to clear",
   register_project: "Register project (idempotent).\nParams: name (string, required) | path (string, required): absolute path | description (string)",
   list_projects: "List registered projects.\nParams: none",
 };
@@ -405,46 +407,54 @@ server.tool(
   }
 );
 
-// ── Start Server ────────────────────────────────────────────────────────────
-
-
-const _agentReg = new Map<string, { id: string; name: string; last_seen_at: string }>();
+// ── Heartbeat & Focus ───────────────────────────────────────────────────────
 
 server.tool(
-  "register_agent",
-  "Register this agent session. Returns agent_id for use in heartbeat/set_focus.",
-  { name: z.string(), session_id: z.string().optional() },
-  async (a: { name: string; session_id?: string }) => {
-    const existing = [..._agentReg.values()].find(x => x.name === a.name);
-    if (existing) { existing.last_seen_at = new Date().toISOString(); return { content: [{ type: "text" as const, text: JSON.stringify(existing) }] }; }
-    const id = Math.random().toString(36).slice(2, 10);
-    const ag = { id, name: a.name, last_seen_at: new Date().toISOString() };
-    _agentReg.set(id, ag);
-    return { content: [{ type: "text" as const, text: JSON.stringify(ag) }] };
+  "heartbeat",
+  "Update last_seen_at to signal agent is active. Call periodically during long tasks.",
+  { agent_id: z.string().describe("Agent ID or name") },
+  async (args) => {
+    try {
+      const agent = heartbeatAgent(args.agent_id);
+      if (!agent) return text(`Agent not found: ${args.agent_id}`);
+      return text(`${agent.id} | ${agent.name} | last_seen: ${agent.last_seen_at}`);
+    } catch (e) {
+      return errorResult(e);
+    }
   }
 );
 
 server.tool(
-  "heartbeat",
-  "Update last_seen_at to signal agent is active.",
-  { agent_id: z.string() },
-  async (a: { agent_id: string }) => {
-    const ag = _agentReg.get(a.agent_id);
-    if (!ag) return { content: [{ type: "text" as const, text: `Agent not found: ${a.agent_id}` }], isError: true };
-    ag.last_seen_at = new Date().toISOString();
-    return { content: [{ type: "text" as const, text: `♥ ${ag.name} — active` }] };
+  "set_focus",
+  "Set active project context for this agent session.",
+  { agent_id: z.string().describe("Agent ID or name"), project_id: z.string().nullable().optional().describe("Project ID to focus on, or null to clear") },
+  async (args) => {
+    try {
+      const agent = setAgentFocus(args.agent_id, args.project_id ?? null);
+      if (!agent) return text(`Agent not found: ${args.agent_id}`);
+      return text(args.project_id ? `Focus set: ${args.project_id}` : "Focus cleared");
+    } catch (e) {
+      return errorResult(e);
+    }
   }
 );
 
 server.tool(
-  "set_focus",
-  "Set active project context for this agent session.",
-  { agent_id: z.string(), project_id: z.string().optional() },
-  async (a: { agent_id: string; project_id?: string }) => {
-    const ag = _agentReg.get(a.agent_id);
-    if (!ag) return { content: [{ type: "text" as const, text: `Agent not found: ${a.agent_id}` }], isError: true };
-    (ag as any).project_id = a.project_id;
-    return { content: [{ type: "text" as const, text: a.project_id ? `Focus: ${a.project_id}` : "Focus cleared" }] };
+  "send_feedback",
+  "Send feedback about this service",
+  {
+    message: z.string().describe("Feedback message"),
+    email: z.string().optional().describe("Contact email (optional)"),
+    category: z.enum(["bug", "feature", "general"]).optional().describe("Feedback category"),
+  },
+  async (params: { message: string; email?: string; category?: string }) => {
+    const adapter = getAdapter();
+    const pkg = require("../../package.json");
+    adapter.run(
+      "INSERT INTO feedback (message, email, category, version) VALUES (?, ?, ?, ?)",
+      params.message, params.email || null, params.category || "general", pkg.version
+    );
+    return text("Feedback saved. Thank you!");
   }
 );