@hasna/recordings 0.1.6 → 0.1.8

package/dist/types/index.d.ts

@@ -12,6 +12,9 @@ export interface Recording {
     agent_id: string | null;
     project_id: string | null;
     session_id: string | null;
+    goal: string | null;
+    role: string | null;
+    task_list_id: string | null;
     metadata: Record<string, unknown>;
     created_at: string;
 }
@@ -29,6 +32,9 @@ export interface CreateRecordingInput {
     agent_id?: string;
     project_id?: string;
     session_id?: string;
+    goal?: string;
+    role?: string;
+    task_list_id?: string;
     metadata?: Record<string, unknown>;
 }
 export interface RecordingFilter {

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/recordings",
-  "version": "0.1.6",
+  "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/__tests__/config.test.ts

@@ -207,7 +207,7 @@ describe("getDataDir", () => {
   test("returns a string", () => {
     const dir = getDataDir();
     expect(typeof dir).toBe("string");
-    expect(dir).toContain(".recordings");
+    expect(dir).toContain("recordings");
   });
 });
 

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,
@@ -485,24 +485,27 @@ program
     const { existsSync: fileExists } = require("node:fs") as typeof import("node:fs");
     const home = getHome();
 
-    const appPath = pathJoin(home, ".recordings", "RecordingsHelper.app");
+    const appPath = pathJoin(home, ".hasna", "recordings", "RecordingsHelper.app");
+    const oldAppPath = pathJoin(home, ".recordings", "RecordingsHelper.app");
 
-    if (!fileExists(appPath)) {
+    if (!fileExists(appPath) && !fileExists(oldAppPath)) {
       console.error(chalk.red("RecordingsHelper.app not found. Run: recordings shortcut --install"));
       process.exit(1);
     }
 
+    const resolvedAppPath = fileExists(appPath) ? appPath : oldAppPath;
+
     // Kill existing instance
     try { execSync("pkill -f RecordingsHelper", { stdio: "pipe" }); } catch { /* not running */ }
 
     // Launch
-    execSync(`open "${appPath}"`, { stdio: "pipe" });
+    execSync(`open "${resolvedAppPath}"`, { stdio: "pipe" });
     console.log(chalk.green("Recordings helper launched — press F5 to record"));
 
     if (opts.login) {
       try {
         execSync(
-          `osascript -e 'tell application "System Events" to make login item at end with properties {path:"${appPath}", hidden:true}'`,
+          `osascript -e 'tell application "System Events" to make login item at end with properties {path:"${resolvedAppPath}", hidden:true}'`,
           { stdio: "pipe" }
         );
         console.log(chalk.green("Added to Login Items — will start on boot"));
@@ -688,7 +691,7 @@ program
     const { homedir: getHome } = require("node:os") as typeof import("node:os");
     const home = getHome();
 
-    const scriptDir = pathJoin(home, ".recordings");
+    const scriptDir = pathJoin(home, ".hasna", "recordings");
     mkdirSync(scriptDir, { recursive: true });
 
     const scriptPath = pathJoin(scriptDir, "record-toggle.sh");
@@ -747,7 +750,7 @@ fi
       // Install the native menu bar app — no config needed, just works with F5
       const { execSync: exec } = require("node:child_process") as typeof import("node:child_process");
 
-      const appPath = pathJoin(home, ".recordings", "RecordingsHelper.app");
+      const appPath = pathJoin(home, ".hasna", "recordings", "RecordingsHelper.app");
       const srcSwift = pathJoin(__dirname, "..", "native", "RecordingsHelper.swift");
       const distApp = pathJoin(__dirname, "..", "RecordingsHelper.app");
 
@@ -757,10 +760,10 @@ fi
       } else if (fileExists(srcSwift)) {
         // Compile from source
         console.log(chalk.blue("Compiling native helper app..."));
-        const appDir = pathJoin(home, ".recordings", "RecordingsHelper.app", "Contents", "MacOS");
+        const appDir = pathJoin(home, ".hasna", "recordings", "RecordingsHelper.app", "Contents", "MacOS");
         mkdirSync(appDir, { recursive: true });
 
-        const plistDir = pathJoin(home, ".recordings", "RecordingsHelper.app", "Contents");
+        const plistDir = pathJoin(home, ".hasna", "recordings", "RecordingsHelper.app", "Contents");
         const plist = `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0"><dict>
@@ -1091,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/lib/config.ts

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync } from "fs";
+import { existsSync, readFileSync, mkdirSync, cpSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 import type { RecordingsConfig } from "../types/index.js";
@@ -67,7 +67,9 @@ export function loadConfig(configPath?: string): RecordingsConfig {
   if (process.env.RECORDINGS_LANGUAGE) {
     config.language = process.env.RECORDINGS_LANGUAGE;
   }
-  if (process.env.RECORDINGS_DB_PATH) {
+  if (process.env.HASNA_RECORDINGS_DB_PATH) {
+    config.db_path = process.env.HASNA_RECORDINGS_DB_PATH;
+  } else if (process.env.RECORDINGS_DB_PATH) {
     config.db_path = process.env.RECORDINGS_DB_PATH;
   }
   if (process.env.RECORDINGS_AUDIO_DIR) {
@@ -115,7 +117,7 @@ function findConfigFile(): string | null {
 }
 
 export function getDataDir(): string {
-  // Check for .recordings in cwd hierarchy
+  // Check for .recordings in cwd hierarchy (project-local)
   let dir = process.cwd();
   const root = "/";
   while (dir !== root) {
@@ -125,8 +127,23 @@ export function getDataDir(): string {
     if (parent === dir) break;
     dir = parent;
   }
-  // Fall back to ~/.recordings
-  return join(homedir(), ".recordings");
+
+  // Global: ~/.hasna/recordings (with backward compat from ~/.recordings)
+  const home = homedir();
+  const newDir = join(home, ".hasna", "recordings");
+  const oldDir = join(home, ".recordings");
+
+  // Auto-migrate from old location if new dir doesn't exist yet
+  if (!existsSync(newDir) && existsSync(oldDir)) {
+    try {
+      mkdirSync(join(home, ".hasna"), { recursive: true });
+      cpSync(oldDir, newDir, { recursive: true });
+    } catch {
+      // Fall through to use new dir
+    }
+  }
+
+  return newDir;
 }
 
 function loadSecretKey(keyName: string): string {

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!");
   }
 );
 

package/src/native/Recordings/Recordings/RecordingEngine.swift

@@ -69,7 +69,7 @@ final class RecordingEngine: ObservableObject {
     private let fnMonitor = FnKeyMonitor()
 
     let home = FileManager.default.homeDirectoryForCurrentUser.path
-    private var audioDir: String { "\(home)/.recordings/audio" }
+    private var audioDir: String { "\(home)/.hasna/recordings/audio" }
 
     init() {
         try? FileManager.default.createDirectory(atPath: audioDir, withIntermediateDirectories: true)

package/src/native/Recordings/Recordings/VoiceShortcuts.swift

@@ -22,7 +22,7 @@ final class VoiceShortcuts: ObservableObject {
 
     private let storageURL: URL = {
         let home = FileManager.default.homeDirectoryForCurrentUser
-        return home.appendingPathComponent(".recordings/voice-shortcuts.json")
+        return home.appendingPathComponent(".hasna/recordings/voice-shortcuts.json")
     }()
 
     init() {

package/src/native/Recordings/build.sh

@@ -33,8 +33,8 @@ fi
 
 echo "✓ Built $APP_DIR"
 echo ""
-echo "To install to ~/.recordings/:"
-echo "  cp -r $APP_DIR ~/.recordings/Recordings.app"
+echo "To install to ~/.hasna/recordings/:"
+echo "  cp -r $APP_DIR ~/.hasna/recordings/Recordings.app"
 echo ""
 echo "To run:"
 echo "  open $APP_DIR"

package/src/native/RecordingsHelper.swift

@@ -18,12 +18,19 @@ class AppDelegate: NSObject, NSApplicationDelegate {
 
     let recordingsDir: String = {
         let home = FileManager.default.homeDirectoryForCurrentUser.path
-        return "\(home)/.recordings"
+        let newDir = "\(home)/.hasna/recordings"
+        let oldDir = "\(home)/.recordings"
+        // Auto-migrate from old location
+        if !FileManager.default.fileExists(atPath: newDir) && FileManager.default.fileExists(atPath: oldDir) {
+            try? FileManager.default.createDirectory(atPath: "\(home)/.hasna", withIntermediateDirectories: true)
+            try? FileManager.default.copyItem(atPath: oldDir, toPath: newDir)
+        }
+        return newDir
     }()
 
     let audioDir: String = {
         let home = FileManager.default.homeDirectoryForCurrentUser.path
-        return "\(home)/.recordings/audio"
+        return "\(home)/.hasna/recordings/audio"
     }()
 
     let recordingsBin: String = {