@dalmasonto/taskflow-mcp 1.0.0

package/dist/tools/notifications.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { errorResponse, successResponse, broadcastChange } from '../helpers.js';
+// ─── exported handler functions ───────────────────────────────────────
+export async function listNotifications(params) {
+    const db = getDb();
+    const limit = params.limit ?? 50;
+    let sql = 'SELECT * FROM notifications';
+    const values = [];
+    if (params.unread_only) {
+        sql += ' WHERE read = 0';
+    }
+    sql += ' ORDER BY created_at DESC LIMIT ?';
+    values.push(limit);
+    const rows = db.prepare(sql).all(...values);
+    return successResponse(rows);
+}
+export async function markNotificationRead(params) {
+    const db = getDb();
+    const result = db
+        .prepare('UPDATE notifications SET read = 1 WHERE id = ?')
+        .run(params.id);
+    if (result.changes === 0) {
+        return errorResponse('Notification not found', 'NOT_FOUND');
+    }
+    const row = db
+        .prepare('SELECT * FROM notifications WHERE id = ?')
+        .get(params.id);
+    const notification = row;
+    broadcastChange('notification', 'notification_updated', notification);
+    return successResponse(notification);
+}
+export async function markAllNotificationsRead() {
+    const db = getDb();
+    const result = db
+        .prepare('UPDATE notifications SET read = 1 WHERE read = 0')
+        .run();
+    broadcastChange('notification', 'notifications_all_read', {});
+    return successResponse({ updated: result.changes });
+}
+export async function clearNotifications() {
+    const db = getDb();
+    const countRow = db
+        .prepare('SELECT COUNT(*) AS count FROM notifications')
+        .get();
+    db.prepare('DELETE FROM notifications').run();
+    broadcastChange('notification', 'notifications_cleared', {});
+    return successResponse({ deleted: countRow.count, message: 'Notifications cleared' });
+}
+// ─── MCP registration ─────────────────────────────────────────────────
+export function registerNotificationTools(server) {
+    server.tool('list_notifications', 'List notifications. Check with unread_only=true at conversation start to surface important updates for the user.', {
+        limit: z.number().optional(),
+        unread_only: z.boolean().optional(),
+    }, async (params) => listNotifications(params));
+    server.tool('mark_notification_read', 'Mark a notification as read after surfacing it to the user.', { id: z.number() }, async (params) => markNotificationRead(params));
+    server.tool('mark_all_notifications_read', 'Mark all unread notifications as read. Call after the user has been briefed on pending notifications.', {}, async () => markAllNotificationsRead());
+    server.tool('clear_notifications', 'Delete all notifications. Use with caution — this is irreversible.', {}, async () => clearNotifications());
+}

package/dist/tools/projects.d.ts

@@ -0,0 +1,55 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createProject(params: {
+    name: string;
+    color?: string;
+    type?: string;
+    description?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function listProjects(): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function getProject(params: {
+    id: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function updateProject(params: {
+    id: number;
+    name?: string;
+    color?: string;
+    type?: string;
+    description?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function deleteProject(params: {
+    id: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function searchProjects(params: {
+    query: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function registerProjectTools(server: McpServer): void;

package/dist/tools/projects.js

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { logActivity, errorResponse, successResponse, now, broadcastChange } from '../helpers.js';
+import { ProjectType } from '../types.js';
+function parseTask(row) {
+    return {
+        ...row,
+        dependencies: JSON.parse(row.dependencies),
+        links: JSON.parse(row.links),
+        tags: JSON.parse(row.tags),
+    };
+}
+// ─── exported handler functions ───────────────────────────────────────
+export async function createProject(params) {
+    const db = getDb();
+    const { name, color = '#de8eff', type = 'active_project', description, } = params;
+    const ts = now();
+    const result = db.prepare(`INSERT INTO projects (name, color, type, description, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?)`).run(name, color, type, description ?? null, ts, ts);
+    const project = db.prepare('SELECT * FROM projects WHERE id = ?').get(result.lastInsertRowid);
+    logActivity('project_created', name, { entityType: 'project', entityId: project.id });
+    const createdProject = project;
+    broadcastChange('project', 'project_created', createdProject);
+    return successResponse(createdProject);
+}
+export async function listProjects() {
+    const db = getDb();
+    const rows = db.prepare(`SELECT projects.*, COUNT(tasks.id) AS task_count
+     FROM projects
+     LEFT JOIN tasks ON tasks.project_id = projects.id
+     GROUP BY projects.id`).all();
+    return successResponse(rows);
+}
+export async function getProject(params) {
+    const db = getDb();
+    const project = db.prepare('SELECT * FROM projects WHERE id = ?').get(params.id);
+    if (!project)
+        return errorResponse('Project not found', 'NOT_FOUND');
+    const tasks = db.prepare('SELECT * FROM tasks WHERE project_id = ?').all(params.id);
+    return successResponse({
+        ...project,
+        tasks: tasks.map(parseTask),
+    });
+}
+export async function updateProject(params) {
+    const db = getDb();
+    const existing = db.prepare('SELECT * FROM projects WHERE id = ?').get(params.id);
+    if (!existing)
+        return errorResponse('Project not found', 'NOT_FOUND');
+    const updates = {};
+    if (params.name !== undefined)
+        updates.name = params.name;
+    if (params.color !== undefined)
+        updates.color = params.color;
+    if (params.type !== undefined)
+        updates.type = params.type;
+    if (params.description !== undefined)
+        updates.description = params.description;
+    if (Object.keys(updates).length === 0) {
+        return successResponse(existing);
+    }
+    updates.updated_at = now();
+    const setClauses = Object.keys(updates).map(k => `${k} = ?`).join(', ');
+    const vals = Object.values(updates);
+    db.prepare(`UPDATE projects SET ${setClauses} WHERE id = ?`).run(...vals, params.id);
+    logActivity('project_updated', params.name ?? existing.name, { entityType: 'project', entityId: params.id });
+    const updated = db.prepare('SELECT * FROM projects WHERE id = ?').get(params.id);
+    const updatedProject = updated;
+    broadcastChange('project', 'project_updated', updatedProject);
+    return successResponse(updatedProject);
+}
+export async function deleteProject(params) {
+    const db = getDb();
+    const project = db.prepare('SELECT * FROM projects WHERE id = ?').get(params.id);
+    if (!project)
+        return errorResponse('Project not found', 'NOT_FOUND');
+    // FK ON DELETE SET NULL handles unlinking tasks automatically
+    db.prepare('DELETE FROM projects WHERE id = ?').run(params.id);
+    logActivity('project_deleted', project.name, { entityType: 'project', entityId: params.id });
+    broadcastChange('project', 'project_deleted', { id: params.id });
+    return successResponse({ deleted: true, id: params.id });
+}
+export async function searchProjects(params) {
+    const db = getDb();
+    const like = `%${params.query}%`;
+    const rows = db.prepare(`SELECT projects.*, COUNT(tasks.id) AS task_count
+     FROM projects
+     LEFT JOIN tasks ON tasks.project_id = projects.id
+     WHERE projects.name LIKE ? COLLATE NOCASE OR projects.description LIKE ? COLLATE NOCASE
+     GROUP BY projects.id`).all(like, like);
+    return successResponse(rows);
+}
+// ─── MCP registration ─────────────────────────────────────────────────
+export function registerProjectTools(server) {
+    server.tool('create_project', 'Create a new project. Projects group related tasks and track time across them.', {
+        name: z.string(),
+        color: z.string().optional(),
+        type: ProjectType.optional(),
+        description: z.string().optional(),
+    }, async (params) => createProject(params));
+    server.tool('list_projects', 'List all projects with task count. Call this at conversation start to understand the workspace.', {}, async () => listProjects());
+    server.tool('get_project', 'Get a project by ID with all its tasks. Use this to understand the full scope of a project before starting work.', { id: z.number() }, async (params) => getProject(params));
+    server.tool('update_project', 'Update project fields such as name, color, type, or description.', {
+        id: z.number(),
+        name: z.string().optional(),
+        color: z.string().optional(),
+        type: ProjectType.optional(),
+        description: z.string().optional(),
+    }, async (params) => updateProject(params));
+    server.tool('delete_project', 'Delete a project by ID. Tasks under this project will be unlinked (project_id set to NULL), not deleted.', { id: z.number() }, async (params) => deleteProject(params));
+    server.tool('search_projects', 'Search projects by name or description. Use this to find projects related to your current work.', { query: z.string() }, async (params) => searchProjects(params));
+}

package/dist/tools/settings.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function getSetting(params: {
+    key: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function updateSetting(params: {
+    key: string;
+    value: unknown;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function registerSettingsTools(server: McpServer): void;

package/dist/tools/settings.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { logActivity, successResponse, broadcastChange } from '../helpers.js';
+// ─── defaults ─────────────────────────────────────────────────────────
+const DEFAULT_SETTINGS = {
+    timerBarDisplayMode: 'carousel',
+    notificationInterval: 30,
+    browserNotificationsEnabled: true,
+    statusColors: {
+        not_started: '#484847',
+        in_progress: '#00fbfb',
+        paused: '#de8eff',
+        blocked: '#ff6e84',
+        partial_done: '#ffeb3b',
+        done: '#69fd5d',
+    },
+    glowIntensity: 50,
+    backdropBlur: 8,
+    shadowSpread: 4,
+    operatorName: 'operator',
+    systemName: 'SYSTEM',
+    terminalHistory: [],
+};
+// ─── exported handler functions ───────────────────────────────────────
+export async function getSetting(params) {
+    const db = getDb();
+    const row = db
+        .prepare('SELECT value FROM settings WHERE key = ?')
+        .get(params.key);
+    if (row) {
+        return successResponse({ key: params.key, value: JSON.parse(row.value) });
+    }
+    const defaultValue = Object.prototype.hasOwnProperty.call(DEFAULT_SETTINGS, params.key)
+        ? DEFAULT_SETTINGS[params.key]
+        : null;
+    return successResponse({ key: params.key, value: defaultValue });
+}
+export async function updateSetting(params) {
+    const db = getDb();
+    db.prepare('INSERT OR REPLACE INTO settings (key, value) VALUES (?, ?)').run(params.key, JSON.stringify(params.value));
+    logActivity('settings_saved', params.key, { detail: `Setting "${params.key}" updated` });
+    broadcastChange('setting', 'settings_saved', { key: params.key, value: params.value });
+    return successResponse({ key: params.key, value: params.value });
+}
+// ─── MCP registration ─────────────────────────────────────────────────
+export function registerSettingsTools(server) {
+    server.tool('get_setting', 'Get a setting value by key, returning the default if not set. Available keys: timerBarDisplayMode, notificationInterval, statusColors, operatorName, systemName, and more.', { key: z.string() }, async (params) => getSetting(params));
+    server.tool('update_setting', 'Update or create a setting value. Settings persist across sessions in the local SQLite database.', {
+        key: z.string(),
+        value: z.unknown(),
+    }, async (params) => updateSetting(params));
+}

package/dist/tools/tasks.d.ts

@@ -0,0 +1,103 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createTask(params: {
+    title: string;
+    description?: string;
+    status?: string;
+    priority?: string;
+    project_id?: number;
+    dependencies?: number[];
+    tags?: string[];
+    links?: Array<{
+        label: string;
+        url: string;
+    }>;
+    due_date?: string;
+    estimated_time?: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function listTasks(params: {
+    status?: string;
+    project_id?: number;
+    priority?: string;
+    tag?: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function getTask(params: {
+    id: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function updateTask(params: {
+    id: number;
+    title?: string;
+    description?: string;
+    status?: string;
+    priority?: string;
+    project_id?: number;
+    dependencies?: number[];
+    tags?: string[];
+    links?: Array<{
+        label: string;
+        url: string;
+    }>;
+    due_date?: string;
+    estimated_time?: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function updateTaskStatus(params: {
+    id: number;
+    status: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function deleteTask(params: {
+    id: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function bulkCreateTasks(params: {
+    tasks: Array<{
+        title: string;
+        description?: string;
+        priority?: string;
+        project_id?: number;
+        status?: string;
+        dependencies?: number[];
+        tags?: string[];
+    }>;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function searchTasks(params: {
+    query: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function registerTaskTools(server: McpServer): void;