@bbyqtbean/taco-helper 0.1.2 → 0.2.0

package/dist/sqlite-store.d.ts

@@ -0,0 +1,77 @@
+/**
+ * SQLite-backed comment store — used by the daemon.
+ *
+ * Replaces the in-memory CommentStore for daemon mode.
+ * Comments persist across daemon restarts in ~/.taco/comments.db.
+ *
+ * See: daemon-mcp-strategy.md §Database Schema
+ */
+import { EventEmitter } from 'events';
+/** The Taco data directory */
+export declare const TACO_DIR: string;
+/** Path to the SQLite database */
+export declare const DB_PATH: string;
+export interface SqliteComment {
+    id: string;
+    url: string;
+    port: number;
+    selector: string;
+    text: string;
+    screenshot: string | null;
+    resolved: number;
+    created_at: string;
+}
+export declare class SqliteStore extends EventEmitter {
+    private db;
+    constructor(dbPath?: string);
+    /**
+     * Extract port from a URL string.
+     * e.g. "http://localhost:3000/dashboard" → 3000
+     */
+    private extractPort;
+    /**
+     * Add a comment to the store.
+     * If a comment with the same ID already exists, it is replaced.
+     */
+    addComment(comment: {
+        id: string;
+        url: string;
+        text: string;
+        selector: string;
+        screenshot?: string | null;
+    }): void;
+    /**
+     * Add multiple comments. Returns the number added.
+     */
+    addComments(comments: Array<{
+        id: string;
+        url: string;
+        text: string;
+        selector: string;
+        screenshot?: string | null;
+    }>): number;
+    /**
+     * Get comments, optionally filtered by port.
+     * By default returns only unresolved comments.
+     */
+    getComments(opts?: {
+        includeResolved?: boolean;
+        port?: number;
+    }): SqliteComment[];
+    /**
+     * Mark a comment as resolved by ID.
+     * Returns true if the comment was found and updated.
+     */
+    markResolved(id: string): boolean;
+    /**
+     * Mark a comment as actioned (in-progress) by ID.
+     * For now we track this as metadata — the resolved column stays 0.
+     * Emits comment-actioned event for SSE broadcast.
+     */
+    markActioned(id: string): boolean;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+}
+//# sourceMappingURL=sqlite-store.d.ts.map

package/dist/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../src/sqlite-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,8BAA8B;AAC9B,eAAO,MAAM,QAAQ,QAA2B,CAAC;AAEjD,kCAAkC;AAClC,eAAO,MAAM,OAAO,QAAgC,CAAC;AAErD,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAY,SAAQ,YAAY;IACzC,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,GAAE,MAAgB;IAgCpC;;;OAGG;IACH,OAAO,CAAC,WAAW;IASnB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,GAAG,IAAI;IAoBR;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC,GAAG,MAAM;IAUX;;;OAGG;IACH,WAAW,CAAC,IAAI,GAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,aAAa,EAAE;IAwBrF;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IASjC;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQjC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGhB"}

package/dist/sqlite-store.js

@@ -0,0 +1,139 @@
+/**
+ * SQLite-backed comment store — used by the daemon.
+ *
+ * Replaces the in-memory CommentStore for daemon mode.
+ * Comments persist across daemon restarts in ~/.taco/comments.db.
+ *
+ * See: daemon-mcp-strategy.md §Database Schema
+ */
+import Database from 'better-sqlite3';
+import { EventEmitter } from 'events';
+import { mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+/** The Taco data directory */
+export const TACO_DIR = join(homedir(), '.taco');
+/** Path to the SQLite database */
+export const DB_PATH = join(TACO_DIR, 'comments.db');
+export class SqliteStore extends EventEmitter {
+    db;
+    constructor(dbPath = DB_PATH) {
+        super();
+        // Ensure ~/.taco/ exists
+        const dir = join(dbPath, '..');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(dbPath);
+        // Enable WAL mode for better concurrent read performance
+        this.db.pragma('journal_mode = WAL');
+        // Create schema
+        this.db.exec(`
+            CREATE TABLE IF NOT EXISTS comments (
+                id          TEXT PRIMARY KEY,
+                url         TEXT NOT NULL,
+                port        INTEGER NOT NULL,
+                selector    TEXT NOT NULL,
+                text        TEXT NOT NULL,
+                screenshot  TEXT,
+                resolved    INTEGER NOT NULL DEFAULT 0,
+                created_at  TEXT NOT NULL DEFAULT (datetime('now'))
+            );
+
+            CREATE INDEX IF NOT EXISTS idx_comments_port ON comments(port);
+            CREATE INDEX IF NOT EXISTS idx_comments_resolved ON comments(resolved);
+        `);
+    }
+    /**
+     * Extract port from a URL string.
+     * e.g. "http://localhost:3000/dashboard" → 3000
+     */
+    extractPort(url) {
+        try {
+            const parsed = new URL(url);
+            return parsed.port ? parseInt(parsed.port, 10) : (parsed.protocol === 'https:' ? 443 : 80);
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Add a comment to the store.
+     * If a comment with the same ID already exists, it is replaced.
+     */
+    addComment(comment) {
+        const port = this.extractPort(comment.url);
+        const stmt = this.db.prepare(`
+            INSERT OR REPLACE INTO comments (id, url, port, selector, text, screenshot, resolved, created_at)
+            VALUES (?, ?, ?, ?, ?, ?, 0, datetime('now'))
+        `);
+        stmt.run(comment.id, comment.url, port, comment.selector, comment.text, comment.screenshot ?? null);
+        this.emit('comment-received', { id: comment.id });
+    }
+    /**
+     * Add multiple comments. Returns the number added.
+     */
+    addComments(comments) {
+        const transaction = this.db.transaction(() => {
+            for (const c of comments) {
+                this.addComment(c);
+            }
+        });
+        transaction();
+        return comments.length;
+    }
+    /**
+     * Get comments, optionally filtered by port.
+     * By default returns only unresolved comments.
+     */
+    getComments(opts = {}) {
+        const { includeResolved = false, port } = opts;
+        let query = 'SELECT * FROM comments';
+        const conditions = [];
+        const params = [];
+        if (!includeResolved) {
+            conditions.push('resolved = 0');
+        }
+        if (port !== undefined) {
+            conditions.push('port = ?');
+            params.push(port);
+        }
+        if (conditions.length > 0) {
+            query += ' WHERE ' + conditions.join(' AND ');
+        }
+        query += ' ORDER BY created_at ASC';
+        return this.db.prepare(query).all(...params);
+    }
+    /**
+     * Mark a comment as resolved by ID.
+     * Returns true if the comment was found and updated.
+     */
+    markResolved(id) {
+        const result = this.db.prepare('UPDATE comments SET resolved = 1 WHERE id = ? AND resolved = 0').run(id);
+        if (result.changes > 0) {
+            this.emit('comment-resolved', { id });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Mark a comment as actioned (in-progress) by ID.
+     * For now we track this as metadata — the resolved column stays 0.
+     * Emits comment-actioned event for SSE broadcast.
+     */
+    markActioned(id) {
+        // Verify the comment exists
+        const comment = this.db.prepare('SELECT id FROM comments WHERE id = ?').get(id);
+        if (!comment)
+            return false;
+        this.emit('comment-actioned', { id });
+        return true;
+    }
+    /**
+     * Close the database connection.
+     */
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=sqlite-store.js.map

package/dist/sqlite-store.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bbyqtbean/taco-helper",
-    "version": "0.1.2",
+    "version": "0.2.0",
     "description": "MCP server + CLI for connecting the Taco Chrome extension to AI agents",
     "mcpName": "taco-helper",
     "type": "module",
@@ -21,9 +21,11 @@
     ],
     "license": "MIT",
     "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.26.0"
+        "@modelcontextprotocol/sdk": "^1.26.0",
+        "better-sqlite3": "^12.6.2"
     },
     "devDependencies": {
+        "@types/better-sqlite3": "^7.6.13",
         "@types/node": "^20.11.0",
         "typescript": "^5.3.3"
     },