floq 1.5.0 → 1.7.0

package/README.ja.md

@@ -1,5 +1,9 @@
 # Floq
 
+[![npm version](https://img.shields.io/npm/v/floq.svg)](https://www.npmjs.com/package/floq)
+[![npm downloads](https://img.shields.io/npm/dm/floq.svg)](https://www.npmjs.com/package/floq)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 [English](./README.md)
 
 MS-DOSスタイルのテーマを備えたターミナルベースのGTD（Getting Things Done）タスクマネージャー。

package/README.md

@@ -1,5 +1,9 @@
 # Floq
 
+[![npm version](https://img.shields.io/npm/v/floq.svg)](https://www.npmjs.com/package/floq)
+[![npm downloads](https://img.shields.io/npm/dm/floq.svg)](https://www.npmjs.com/package/floq)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 [日本語](./README.ja.md)
 
 A terminal-based GTD (Getting Things Done) task manager with MS-DOS style themes.

package/dist/cli.js

@@ -7,7 +7,7 @@ import { listTasks, listProjects } from './commands/list.js';
 import { moveTask } from './commands/move.js';
 import { markDone } from './commands/done.js';
 import { addProject, listProjectsCommand, showProject, completeProject, } from './commands/project.js';
-import { showConfig, setLanguage, setDbPath, resetDbPath, setTheme, selectTheme, setViewModeCommand, selectMode, setTurso, disableTurso, enableTurso, clearTurso, syncCommand, resetDatabase, setSplashCommand, showSplash, showDateFormatCommand, setDateFormatCommand } from './commands/config.js';
+import { showConfig, setLanguage, setDbPath, resetDbPath, setTheme, selectTheme, setViewModeCommand, selectMode, setTurso, disableTurso, enableTurso, clearTurso, showTursoQr, syncCommand, resetDatabase, setSplashCommand, showSplash, showDateFormatCommand, setDateFormatCommand } from './commands/config.js';
 import { addComment, listComments } from './commands/comment.js';
 import { listContexts, addContextCommand, removeContextCommand } from './commands/context.js';
 import { showInsights } from './commands/insights.js';
@@ -153,8 +153,12 @@ configCmd
     .option('--disable', 'Temporarily disable Turso sync (preserves config)')
     .option('--enable', 'Re-enable Turso sync')
     .option('--clear', 'Remove Turso configuration completely')
+    .option('--qr', 'Display Turso config as QR code')
     .action(async (options) => {
-    if (options.clear) {
+    if (options.qr) {
+        await showTursoQr();
+    }
+    else if (options.clear) {
         await clearTurso();
     }
     else if (options.disable) {
@@ -196,6 +200,24 @@ configCmd
         await showDateFormatCommand();
     }
 });
+configCmd
+    .command('insights-weeks [weeks]')
+    .description('Set number of weeks for insights (default: 2)')
+    .action(async (weeks) => {
+    const { getInsightsWeeks, setInsightsWeeks } = await import('./config.js');
+    if (weeks !== undefined) {
+        const n = parseInt(weeks, 10);
+        if (isNaN(n) || n < 1) {
+            console.error('Weeks must be a positive integer');
+            process.exit(1);
+        }
+        setInsightsWeeks(n);
+        console.log(`Insights weeks set to ${n}`);
+    }
+    else {
+        console.log(`Insights weeks: ${getInsightsWeeks()}`);
+    }
+});
 configCmd
     .command('pomodoro')
     .description('Configure pomodoro settings')
@@ -216,9 +238,13 @@ configCmd
 program
     .command('insights')
     .description('Show task completion insights and statistics')
-    .option('-w, --weeks <n>', 'Number of weeks to analyze (default: 2)', '2')
+    .option('-w, --weeks <n>', 'Number of weeks to analyze (uses config default)')
     .action(async (options) => {
-    const weeks = Math.max(1, parseInt(options.weeks ?? '2', 10) || 2);
+    const { getInsightsWeeks } = await import('./config.js');
+    const defaultWeeks = getInsightsWeeks();
+    const weeks = options.weeks
+        ? Math.max(1, parseInt(options.weeks, 10) || defaultWeeks)
+        : defaultWeeks;
     await showInsights(weeks);
 });
 // Sync command
@@ -358,4 +384,12 @@ calendarCmd
     .action(async () => {
     await selectCalendar();
 });
+// MCP server command
+program
+    .command('mcp')
+    .description('Start MCP server for LLM integration')
+    .action(async () => {
+    const { startMcpServer } = await import('./mcp/server.js');
+    await startMcpServer();
+});
 export { program };

package/dist/commands/config.d.ts

@@ -7,6 +7,7 @@ export declare function selectTheme(): Promise<void>;
 export declare function showViewMode(): Promise<void>;
 export declare function setViewModeCommand(mode: string): Promise<void>;
 export declare function selectMode(): Promise<void>;
+export declare function showTursoQr(): Promise<void>;
 export declare function setTurso(url: string, token: string): Promise<void>;
 export declare function disableTurso(): Promise<void>;
 export declare function enableTurso(): Promise<void>;

package/dist/commands/config.js

@@ -3,7 +3,7 @@ import React from 'react';
 import { createInterface } from 'readline';
 import { unlinkSync, existsSync, readdirSync } from 'fs';
 import { dirname, basename, join } from 'path';
-import { loadConfig, saveConfig, getDbPath, getViewMode, setViewMode, isTursoEnabled, getTursoConfig, setTursoConfig, setTursoEnabled, getSplashDuration, setSplashDuration, getDateFormat, setDateFormat, getCalendarConfig, isCalendarEnabled } from '../config.js';
+import { loadConfig, saveConfig, getDbPath, getViewMode, setViewMode, isTursoEnabled, getTursoConfig, setTursoConfig, setTursoEnabled, getSplashDuration, setSplashDuration, getDateFormat, setDateFormat, getCalendarConfig, isCalendarEnabled, getInsightsWeeks } from '../config.js';
 import { CONFIG_FILE } from '../paths.js';
 import { ThemeSelector } from '../ui/ThemeSelector.js';
 import { ModeSelector } from '../ui/ModeSelector.js';
@@ -25,6 +25,7 @@ export async function showConfig() {
     console.log(`View Mode: ${config.viewMode || 'gtd'}`);
     console.log(`Date Format: ${dateFormat}`);
     console.log(`Splash: ${splashDuration === 0 ? 'disabled' : splashDuration === -1 ? 'wait for key' : `${splashDuration}ms`}`);
+    console.log(`Insights Weeks: ${getInsightsWeeks()}`);
     console.log(`Turso: ${isTursoEnabled() ? 'enabled' : 'disabled'}`);
     if (config.db_path) {
         console.log(`  (custom: ${config.db_path})`);
@@ -126,6 +127,22 @@ export async function selectMode() {
         }));
     });
 }
+export async function showTursoQr() {
+    const turso = getTursoConfig();
+    if (!turso || !turso.url || !turso.authToken) {
+        console.error('Turso is not configured.');
+        console.error('Use "floq config turso --url <url> --token <token>" to configure first.');
+        process.exit(1);
+    }
+    const qrcode = await import('qrcode');
+    const data = JSON.stringify({ url: turso.url, authToken: turso.authToken });
+    const qr = await qrcode.default.toString(data, { type: 'terminal', small: true });
+    console.log('');
+    console.log('Turso Configuration QR Code:');
+    console.log('');
+    console.log(qr);
+    console.log('⚠️  This QR code contains your auth token. Do not share publicly.');
+}
 export async function setTurso(url, token) {
     setTursoConfig({ url, authToken: token, enabled: true });
     console.log('Turso sync enabled');

package/dist/config.d.ts

@@ -43,6 +43,7 @@ export interface Config {
     pomodoroFocusMode?: boolean;
     dateFormat?: DateFormat;
     calendar?: CalendarConfig;
+    insightsWeeks?: number;
 }
 export declare function loadConfig(): Config;
 export declare function saveConfig(updates: Partial<Config>): void;
@@ -80,3 +81,5 @@ export declare function setGoogleOAuthClient(client: GoogleOAuthClient): void;
 export declare function getCalendarOAuthConfig(): CalendarOAuthConfig | undefined;
 export declare function setCalendarOAuthConfig(oauth: CalendarOAuthConfig | undefined): void;
 export declare function getCalendarType(): 'ical' | 'oauth' | undefined;
+export declare function getInsightsWeeks(): number;
+export declare function setInsightsWeeks(weeks: number): void;

package/dist/config.js

@@ -244,3 +244,14 @@ export function getCalendarType() {
         return undefined;
     return calendar.type || (calendar.url ? 'ical' : undefined);
 }
+const DEFAULT_INSIGHTS_WEEKS = 2;
+export function getInsightsWeeks() {
+    const weeks = loadConfig().insightsWeeks;
+    if (weeks === undefined || weeks < 1) {
+        return DEFAULT_INSIGHTS_WEEKS;
+    }
+    return weeks;
+}
+export function setInsightsWeeks(weeks) {
+    saveConfig({ insightsWeeks: Math.max(1, weeks) });
+}

package/dist/index.js

@@ -10,6 +10,7 @@ async function main() {
     const isConfigCommand = args[0] === 'config';
     const isSyncCommand = args[0] === 'sync';
     const isSetupCommand = args[0] === 'setup';
+    const isMcpCommand = args[0] === 'mcp';
     // 初回起動時（引数なし + config未作成）はウィザードを起動
     if (isTuiMode && isFirstRun()) {
         await runSetupWizard();
@@ -19,7 +20,7 @@ async function main() {
         return;
     }
     // config/syncコマンド以外でTursoモードの場合は接続先を表示
-    if (!isTuiMode && !isConfigCommand && !isSyncCommand && !isSetupCommand && isTursoEnabled()) {
+    if (!isTuiMode && !isConfigCommand && !isSyncCommand && !isSetupCommand && !isMcpCommand && isTursoEnabled()) {
         const turso = getTursoConfig();
         if (turso) {
             const host = new URL(turso.url).host;

package/dist/mcp/server.d.ts

@@ -0,0 +1 @@
+export declare function startMcpServer(): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,186 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { v4 as uuidv4 } from 'uuid';
+import { eq, like, ne, and } from 'drizzle-orm';
+import { getDb, schema } from '../db/index.js';
+import { VERSION } from '../version.js';
+export async function startMcpServer() {
+    const server = new McpServer({
+        name: 'floq',
+        version: VERSION,
+    });
+    // floq_add_task
+    server.tool('floq_add_task', 'Add a new task to Floq. By default, tasks are added to the inbox.', {
+        title: z.string().describe('Task title'),
+        description: z.string().optional().describe('Task description'),
+        status: z.enum(['inbox', 'next', 'waiting', 'someday']).optional().describe('Initial status (default: inbox)'),
+        context: z.string().optional().describe('Task context (e.g., work, home)'),
+    }, async ({ title, description, status, context }) => {
+        const db = getDb();
+        const now = new Date();
+        const id = uuidv4();
+        await db.insert(schema.tasks).values({
+            id,
+            title,
+            description: description ?? null,
+            status: status ?? 'inbox',
+            context: context?.toLowerCase().replace(/^@/, '') ?? null,
+            createdAt: now,
+            updatedAt: now,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ id, title, status: status ?? 'inbox' }),
+                }],
+        };
+    });
+    // floq_list_tasks
+    server.tool('floq_list_tasks', 'List tasks from Floq. Use status filter to narrow results. "all" returns all non-done tasks.', {
+        status: z.enum(['inbox', 'next', 'waiting', 'someday', 'done', 'all']).optional().describe('Filter by status (default: all, which excludes done)'),
+    }, async ({ status }) => {
+        const db = getDb();
+        const filter = status ?? 'all';
+        let tasks;
+        if (filter === 'all') {
+            tasks = await db
+                .select()
+                .from(schema.tasks)
+                .where(and(ne(schema.tasks.status, 'done'), eq(schema.tasks.isProject, false)));
+        }
+        else {
+            tasks = await db
+                .select()
+                .from(schema.tasks)
+                .where(and(eq(schema.tasks.status, filter), eq(schema.tasks.isProject, false)));
+        }
+        const result = tasks.map(task => ({
+            id: task.id,
+            shortId: task.id.slice(0, 8),
+            title: task.title,
+            description: task.description,
+            status: task.status,
+            context: task.context,
+            waitingFor: task.waitingFor,
+            dueDate: task.dueDate?.toISOString() ?? null,
+            createdAt: task.createdAt.toISOString(),
+        }));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result),
+                }],
+        };
+    });
+    // floq_complete_task
+    server.tool('floq_complete_task', 'Mark a task as done. Accepts full ID or ID prefix (first 8 chars).', {
+        taskId: z.string().describe('Task ID or ID prefix'),
+    }, async ({ taskId }) => {
+        const db = getDb();
+        const tasks = await db
+            .select()
+            .from(schema.tasks)
+            .where(like(schema.tasks.id, `${taskId}%`));
+        if (tasks.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: `No task found with ID prefix: ${taskId}` }),
+                    }],
+                isError: true,
+            };
+        }
+        if (tasks.length > 1) {
+            const matches = tasks.map(t => ({ id: t.id.slice(0, 8), title: t.title }));
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: 'Multiple tasks match this prefix', matches }),
+                    }],
+                isError: true,
+            };
+        }
+        const task = tasks[0];
+        if (task.status === 'done') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ id: task.id, title: task.title, status: 'done', message: 'Task is already done' }),
+                    }],
+            };
+        }
+        const previousStatus = task.status;
+        await db.update(schema.tasks)
+            .set({
+            status: 'done',
+            completedAt: new Date(),
+            updatedAt: new Date(),
+        })
+            .where(eq(schema.tasks.id, task.id));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ id: task.id, title: task.title, previousStatus, status: 'done' }),
+                }],
+        };
+    });
+    // floq_move_task
+    server.tool('floq_move_task', 'Move a task to a different status. Accepts full ID or ID prefix.', {
+        taskId: z.string().describe('Task ID or ID prefix'),
+        status: z.enum(['inbox', 'next', 'waiting', 'someday', 'done']).describe('Target status'),
+        waitingFor: z.string().optional().describe('Who/what the task is waiting for (required when status is "waiting")'),
+    }, async ({ taskId, status, waitingFor }) => {
+        const db = getDb();
+        if (status === 'waiting' && !waitingFor) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: 'waitingFor is required when status is "waiting"' }),
+                    }],
+                isError: true,
+            };
+        }
+        const tasks = await db
+            .select()
+            .from(schema.tasks)
+            .where(like(schema.tasks.id, `${taskId}%`));
+        if (tasks.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: `No task found with ID prefix: ${taskId}` }),
+                    }],
+                isError: true,
+            };
+        }
+        if (tasks.length > 1) {
+            const matches = tasks.map(t => ({ id: t.id.slice(0, 8), title: t.title }));
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: 'Multiple tasks match this prefix', matches }),
+                    }],
+                isError: true,
+            };
+        }
+        const task = tasks[0];
+        const previousStatus = task.status;
+        await db.update(schema.tasks)
+            .set({
+            status,
+            waitingFor: status === 'waiting' ? (waitingFor ?? null) : null,
+            completedAt: status === 'done' ? new Date() : null,
+            updatedAt: new Date(),
+        })
+            .where(eq(schema.tasks.id, task.id));
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ id: task.id, title: task.title, previousStatus, status }),
+                }],
+        };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}

package/dist/ui/components/InsightsModal.js

@@ -4,6 +4,7 @@ import { Box, Text, useInput } from 'ink';
 import { eq, and } from 'drizzle-orm';
 import { getDb, schema } from '../../db/index.js';
 import { t, fmt } from '../../i18n/index.js';
+import { getInsightsWeeks } from '../../config.js';
 import { useTheme } from '../theme/index.js';
 const VISIBLE_LINES = 16;
 function stringWidth(str) {
@@ -75,7 +76,7 @@ export function InsightsModal({ onClose }) {
     useEffect(() => {
         const loadInsights = async () => {
             const db = getDb();
-            const weeks = 2;
+            const weeks = getInsightsWeeks();
             const lines = [];
             const now = new Date();
             const startDate = getWeekStart(now);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "floq",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Floq - Getting Things Done Task Manager with MS-DOS style themes",
   "type": "module",
   "main": "dist/index.js",
@@ -39,20 +39,23 @@
   "dependencies": {
     "@inkjs/ui": "^2.0.0",
     "@libsql/client": "^0.17.0",
+    "@modelcontextprotocol/sdk": "^1.27.0",
     "better-sqlite3": "^11.7.0",
     "commander": "^13.1.0",
     "drizzle-orm": "^0.39.1",
+    "googleapis": "^144.0.0",
+    "ical.js": "^2.1.0",
     "ink": "^5.1.0",
     "ink-text-input": "^6.0.0",
+    "open": "^10.1.0",
+    "qrcode": "^1.5.4",
     "react": "^18.3.1",
-    "uuid": "^11.0.5",
-    "ical.js": "^2.1.0",
-    "googleapis": "^144.0.0",
-    "open": "^10.1.0"
+    "uuid": "^11.0.5"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^22.10.7",
+    "@types/qrcode": "^1.5.6",
     "@types/react": "^18.3.18",
     "@types/uuid": "^10.0.0",
     "drizzle-kit": "^0.31.8",