floq 1.3.3 → 1.4.0

package/README.ja.md

@@ -13,6 +13,8 @@ MS-DOSスタイルのテーマを備えたターミナルベースのGTD（Getti
 - **カンバンモード**: 3カラムのカンバンボード表示（TODO、Doing、Done）
 - **プロジェクト**: タスクをプロジェクトに整理（進捗バー表示付き）
 - **コンテキスト**: タスクにコンテキスト（@work、@homeなど）を設定してフィルタリング。タスク追加時は現在のフィルターを自動継承
+- **集中モード**: タスクに「今日やる」マーク（★）を付け、集中タスクだけに絞り込み表示
+- **作業量**: タスクに作業量（S/M/L）を設定し、空き時間に合ったタスクを選びやすく
 - **タスク検索**: `/` キーで全タスクを素早く検索
 - **コメント**: タスクにメモやコメントを追加
 - **クラウド同期**: [Turso](https://turso.tech/)のembedded replicasによるオプションの同期機能
@@ -64,6 +66,9 @@ floq
 | `P` | プロジェクトに紐付け |
 | `c` | コンテキスト設定 |
 | `@` | コンテキストでフィルター |
+| `g` | 選択タスクの集中マーク（★）ON/OFF |
+| `G` | 集中フィルター切替（集中タスクのみ表示） |
+| `E` | 作業量設定（S/M/L） |
 | `Enter` | タスク詳細を開く / プロジェクトを開く |
 | `Esc/b` | 戻る |
 | `/` | タスク検索 |
@@ -115,6 +120,9 @@ floq
 | `Backspace` | タスクを左に移動（←） |
 | `c` | コンテキスト設定 |
 | `@` | コンテキストでフィルター |
+| `g` | 選択タスクの集中マーク（★）ON/OFF |
+| `G` | 集中フィルター切替（集中タスクのみ表示） |
+| `E` | 作業量設定（S/M/L） |
 | `Enter` | タスク詳細を開く |
 | `/` | タスク検索 |
 | `r` | 更新 |

package/README.md

@@ -13,6 +13,8 @@ A terminal-based GTD (Getting Things Done) task manager with MS-DOS style themes
 - **Kanban Mode**: 3-column kanban board view (TODO, Doing, Done)
 - **Projects**: Organize tasks into projects with progress tracking
 - **Contexts**: Tag tasks with contexts (@work, @home, etc.) and filter by context. New tasks inherit the active context filter
+- **Focus Mode**: Mark tasks as "today's focus" (★) and filter to show only focused tasks
+- **Effort Size**: Tag tasks with effort size (S/M/L) to pick the right task for your available time
 - **Task Search**: Quick search across all tasks with `/`
 - **Comments**: Add notes and comments to tasks
 - **Cloud Sync**: Optional sync with [Turso](https://turso.tech/) using embedded replicas
@@ -64,6 +66,9 @@ floq
 | `P` | Link to project |
 | `c` | Set context |
 | `@` | Filter by context |
+| `g` | Toggle focus (★) on selected task |
+| `G` | Toggle focus filter (show only focused tasks) |
+| `E` | Set effort size (S/M/L) |
 | `Enter` | Open task detail / Open project |
 | `Esc/b` | Back |
 | `/` | Search tasks |
@@ -115,6 +120,9 @@ floq
 | `Backspace` | Move task left (←) |
 | `c` | Set context |
 | `@` | Filter by context |
+| `g` | Toggle focus (★) on selected task |
+| `G` | Toggle focus filter (show only focused tasks) |
+| `E` | Set effort size (S/M/L) |
 | `Enter` | Open task detail |
 | `/` | Search tasks |
 | `r` | Refresh |

package/dist/cli.js

@@ -10,6 +10,7 @@ import { addProject, listProjectsCommand, showProject, completeProject, } from '
 import { showConfig, setLanguage, setDbPath, resetDbPath, setTheme, selectTheme, setViewModeCommand, selectMode, setTurso, disableTurso, enableTurso, clearTurso, 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';
 import { runSetupWizard } from './commands/setup.js';
 import { addCalendar, removeCalendar, showCalendar, syncCalendar, enableCalendar, disableCalendar, configOAuthClient, loginCalendar, logoutCalendar, selectCalendar } from './commands/calendar.js';
 import { VERSION } from './version.js';
@@ -211,6 +212,15 @@ configCmd
         console.log(`Pomodoro focus mode: ${enabled ? 'on' : 'off'}`);
     }
 });
+// Insights command
+program
+    .command('insights')
+    .description('Show task completion insights and statistics')
+    .option('-w, --weeks <n>', 'Number of weeks to analyze (default: 2)', '2')
+    .action(async (options) => {
+    const weeks = Math.max(1, parseInt(options.weeks ?? '2', 10) || 2);
+    await showInsights(weeks);
+});
 // Sync command
 program
     .command('sync')

package/dist/commands/insights.d.ts

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

package/dist/commands/insights.js

@@ -0,0 +1,283 @@
+import { eq, and, gte } from 'drizzle-orm';
+import { getDb, schema } from '../db/index.js';
+import { t, fmt } from '../i18n/index.js';
+function getWeekStart(date) {
+    const d = new Date(date);
+    const day = d.getDay();
+    d.setDate(d.getDate() - day);
+    d.setHours(0, 0, 0, 0);
+    return d;
+}
+function formatDate(date) {
+    return date.toLocaleDateString();
+}
+function bar(count, max, width = 20) {
+    if (max === 0)
+        return '';
+    const filled = Math.round((count / max) * width);
+    return '█'.repeat(filled);
+}
+function stringWidth(str) {
+    let width = 0;
+    for (const char of str) {
+        const code = char.codePointAt(0) || 0;
+        // CJK characters and fullwidth forms take 2 columns
+        if ((code >= 0x1100 && code <= 0x115F) ||
+            (code >= 0x2E80 && code <= 0x303E) ||
+            (code >= 0x3040 && code <= 0x9FFF) ||
+            (code >= 0xAC00 && code <= 0xD7AF) ||
+            (code >= 0xF900 && code <= 0xFAFF) ||
+            (code >= 0xFE30 && code <= 0xFE6F) ||
+            (code >= 0xFF01 && code <= 0xFF60) ||
+            (code >= 0xFFE0 && code <= 0xFFE6) ||
+            (code >= 0x20000 && code <= 0x2FFFF)) {
+            width += 2;
+        }
+        else {
+            width += 1;
+        }
+    }
+    return width;
+}
+function padEnd(str, targetWidth) {
+    const currentWidth = stringWidth(str);
+    const padding = Math.max(0, targetWidth - currentWidth);
+    return str + ' '.repeat(padding);
+}
+function groupByWeek(tasks, weeks) {
+    const now = new Date();
+    const result = [];
+    for (let i = 0; i < weeks; i++) {
+        const weekStart = getWeekStart(now);
+        weekStart.setDate(weekStart.getDate() - i * 7);
+        const weekEnd = new Date(weekStart);
+        weekEnd.setDate(weekEnd.getDate() + 7);
+        const weekTasks = tasks.filter(task => {
+            const updated = task.updatedAt;
+            return updated >= weekStart && updated < weekEnd;
+        });
+        result.push({
+            weekStart,
+            weekLabel: formatDate(weekStart),
+            tasks: weekTasks,
+        });
+    }
+    return result;
+}
+function groupByDayOfWeek(tasks) {
+    const days = new Map();
+    for (let i = 0; i < 7; i++)
+        days.set(i, 0);
+    for (const task of tasks) {
+        const day = task.updatedAt.getDay();
+        days.set(day, (days.get(day) || 0) + 1);
+    }
+    return days;
+}
+function calculateDistribution(tasks, getter, noValueLabel) {
+    const map = new Map();
+    for (const task of tasks) {
+        const key = getter(task) || noValueLabel;
+        map.set(key, (map.get(key) || 0) + 1);
+    }
+    return Array.from(map.entries())
+        .map(([label, count]) => ({
+        label,
+        count,
+        percentage: Math.round((count / tasks.length) * 100),
+    }))
+        .sort((a, b) => b.count - a.count);
+}
+function calculateAverageCompletionDays(tasks) {
+    if (tasks.length === 0)
+        return null;
+    let totalMs = 0;
+    let validCount = 0;
+    for (const task of tasks) {
+        const created = task.createdAt.getTime();
+        const updated = task.updatedAt.getTime();
+        if (updated > created) {
+            totalMs += updated - created;
+            validCount++;
+        }
+    }
+    if (validCount === 0)
+        return null;
+    return totalMs / validCount / (1000 * 60 * 60 * 24);
+}
+export async function showInsights(weeks) {
+    const db = getDb();
+    const i18n = t();
+    const ins = i18n.commands.insights;
+    const isJa = ins?.title === 'タスクインサイト';
+    // Labels with fallbacks
+    const l = {
+        title: ins?.title || 'Task Insights',
+        period: ins?.period || 'Period',
+        weeklyCompletion: ins?.weeklyCompletion || 'Weekly Completion',
+        weekLabel: ins?.weekLabel || 'Week of {date}',
+        tasksCompleted: ins?.tasksCompleted || '{count} tasks completed',
+        dailyBreakdown: ins?.dailyBreakdown || 'Daily Breakdown',
+        currentStatus: ins?.currentStatus || 'Current Status',
+        byContext: ins?.byContext || 'By Context',
+        byEffort: ins?.byEffort || 'By Effort',
+        noContext: ins?.noContext || 'No context',
+        noEffort: ins?.noEffort || 'No effort set',
+        projectProgress: ins?.projectProgress || 'Project Progress',
+        activeProjects: ins?.activeProjects || 'Active Projects',
+        tasksRemaining: ins?.tasksRemaining || '{count} tasks remaining',
+        averageCompletion: ins?.averageCompletion || 'Average Completion Time',
+        daysAverage: ins?.daysAverage || '{days} days',
+        noData: ins?.noData || 'No completed tasks in this period',
+        total: ins?.total || 'Total',
+        andMore: ins?.andMore || '  ... and {count} more',
+    };
+    // Calculate date range
+    const now = new Date();
+    const startDate = getWeekStart(now);
+    startDate.setDate(startDate.getDate() - (weeks - 1) * 7);
+    const endDate = new Date(now);
+    endDate.setHours(23, 59, 59, 999);
+    // Query all completed tasks in the period
+    const completedTasks = await db
+        .select()
+        .from(schema.tasks)
+        .where(and(eq(schema.tasks.status, 'done'), gte(schema.tasks.updatedAt, startDate), eq(schema.tasks.isProject, false)));
+    // Header
+    console.log();
+    console.log(l.title);
+    console.log('═'.repeat(40));
+    console.log(`${l.period}: ${formatDate(startDate)} ~ ${formatDate(endDate)}`);
+    if (completedTasks.length === 0) {
+        console.log();
+        console.log(`  ${l.noData}`);
+        console.log();
+        return;
+    }
+    // Weekly Completion
+    console.log();
+    console.log(l.weeklyCompletion);
+    console.log('─'.repeat(40));
+    const weeklyStats = groupByWeek(completedTasks, weeks);
+    for (const week of weeklyStats) {
+        const weekLabel = fmt(l.weekLabel, { date: week.weekLabel });
+        const countLabel = fmt(l.tasksCompleted, { count: week.tasks.length });
+        console.log(`${weekLabel}: ${countLabel}`);
+        const maxShow = 10;
+        for (let i = 0; i < Math.min(week.tasks.length, maxShow); i++) {
+            const task = week.tasks[i];
+            const shortId = task.id.slice(0, 8);
+            console.log(`  [${shortId}] ${task.title}`);
+        }
+        if (week.tasks.length > maxShow) {
+            console.log(fmt(l.andMore, { count: week.tasks.length - maxShow }));
+        }
+    }
+    // Daily Breakdown
+    console.log();
+    console.log(l.dailyBreakdown);
+    console.log('─'.repeat(40));
+    const localeDayNames = isJa
+        ? ['日', '月', '火', '水', '木', '金', '土']
+        : ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+    const dailyStats = groupByDayOfWeek(completedTasks);
+    const maxDaily = Math.max(...dailyStats.values());
+    for (let i = 0; i < 7; i++) {
+        const count = dailyStats.get(i) || 0;
+        const dayName = padEnd(localeDayNames[i], 4);
+        const countStr = String(count).padStart(3);
+        console.log(`  ${dayName}${countStr} ${bar(count, maxDaily)}`);
+    }
+    // Current Status Distribution
+    console.log();
+    console.log(l.currentStatus);
+    console.log('─'.repeat(40));
+    const allTasks = await db
+        .select()
+        .from(schema.tasks)
+        .where(eq(schema.tasks.isProject, false));
+    const statusCounts = new Map();
+    for (const task of allTasks) {
+        statusCounts.set(task.status, (statusCounts.get(task.status) || 0) + 1);
+    }
+    const statusOrder = ['inbox', 'next', 'waiting', 'someday', 'done'];
+    const maxStatus = Math.max(...statusCounts.values());
+    for (const status of statusOrder) {
+        const count = statusCounts.get(status) || 0;
+        const label = padEnd(i18n.status[status] || status, 16);
+        const countStr = String(count).padStart(3);
+        console.log(`  ${label}${countStr} ${bar(count, maxStatus)}`);
+    }
+    // Context Distribution
+    console.log();
+    console.log(l.byContext);
+    console.log('─'.repeat(40));
+    const contextDist = calculateDistribution(completedTasks, t => t.context, l.noContext);
+    const maxContext = contextDist.length > 0 ? contextDist[0].count : 0;
+    for (const item of contextDist) {
+        const label = padEnd(item.label === l.noContext ? item.label : `@${item.label}`, 16);
+        const countStr = String(item.count).padStart(3);
+        console.log(`  ${label}${countStr} (${String(item.percentage).padStart(2)}%) ${bar(item.count, maxContext)}`);
+    }
+    // Effort Distribution
+    console.log();
+    console.log(l.byEffort);
+    console.log('─'.repeat(40));
+    const effortLabels = {
+        small: i18n.tui.effort?.small || 'Small',
+        medium: i18n.tui.effort?.medium || 'Medium',
+        large: i18n.tui.effort?.large || 'Large',
+    };
+    const effortDist = calculateDistribution(completedTasks, t => t.effort ? (effortLabels[t.effort] || t.effort) : null, l.noEffort);
+    const maxEffort = effortDist.length > 0 ? effortDist[0].count : 0;
+    for (const item of effortDist) {
+        const label = padEnd(item.label, 16);
+        const countStr = String(item.count).padStart(3);
+        console.log(`  ${label}${countStr} (${String(item.percentage).padStart(2)}%) ${bar(item.count, maxEffort)}`);
+    }
+    // Project Progress
+    console.log();
+    console.log(l.projectProgress);
+    console.log('─'.repeat(40));
+    const activeProjects = await db
+        .select()
+        .from(schema.tasks)
+        .where(and(eq(schema.tasks.isProject, true), eq(schema.tasks.status, 'next')));
+    if (activeProjects.length === 0) {
+        console.log(`  ${l.activeProjects}: 0`);
+    }
+    else {
+        console.log(`  ${l.activeProjects}: ${activeProjects.length}`);
+        for (const project of activeProjects) {
+            const children = await db
+                .select()
+                .from(schema.tasks)
+                .where(eq(schema.tasks.parentId, project.id));
+            const total = children.length;
+            const done = children.filter(c => c.status === 'done').length;
+            const remaining = total - done;
+            const pct = total > 0 ? Math.round((done / total) * 100) : 0;
+            const shortId = project.id.slice(0, 8);
+            console.log(`  [${shortId}] ${project.title} (${done}/${total}, ${pct}%)`);
+        }
+    }
+    // Average Completion Time
+    console.log();
+    console.log(l.averageCompletion);
+    console.log('─'.repeat(40));
+    const avgDays = calculateAverageCompletionDays(completedTasks);
+    if (avgDays !== null) {
+        if (avgDays < 1) {
+            const hours = Math.round(avgDays * 24);
+            const hoursLabel = isJa ? `${hours}時間` : `${hours}h`;
+            console.log(`  ${hoursLabel}`);
+        }
+        else {
+            console.log(`  ${fmt(l.daysAverage, { days: avgDays.toFixed(1) })}`);
+        }
+    }
+    // Total
+    console.log();
+    console.log(`${l.total}: ${fmt(l.tasksCompleted, { count: completedTasks.length })}`);
+    console.log();
+}

package/dist/config.d.ts

@@ -39,6 +39,7 @@ export interface Config {
     contexts?: string[];
     splashDuration?: number;
     contextFilter?: string | null;
+    focusFilter?: boolean;
     pomodoroFocusMode?: boolean;
     dateFormat?: DateFormat;
     calendar?: CalendarConfig;
@@ -64,6 +65,8 @@ export declare function getSplashDuration(): number;
 export declare function setSplashDuration(duration: number): void;
 export declare function getContextFilter(): string | null;
 export declare function setContextFilter(contextFilter: string | null): void;
+export declare function getFocusFilter(): boolean;
+export declare function setFocusFilter(enabled: boolean): void;
 export declare function getPomodoroFocusMode(): boolean;
 export declare function setPomodoroFocusMode(enabled: boolean): void;
 export declare function getDateFormat(): DateFormat;

package/dist/config.js

@@ -165,6 +165,12 @@ export function getContextFilter() {
 export function setContextFilter(contextFilter) {
     saveConfig({ contextFilter });
 }
+export function getFocusFilter() {
+    return loadConfig().focusFilter ?? false;
+}
+export function setFocusFilter(enabled) {
+    saveConfig({ focusFilter: enabled });
+}
 export function getPomodoroFocusMode() {
     return loadConfig().pomodoroFocusMode ?? true;
 }

package/dist/db/index.js

@@ -24,6 +24,8 @@ async function initializeRemoteSchema(tursoUrl, authToken) {
         const tableInfo = tableInfoResult.rows;
         const tableExists = tableInfo.length > 0;
         const hasContext = tableInfo.some(col => col.name === 'context');
+        const hasIsFocused = tableInfo.some(col => col.name === 'is_focused');
+        const hasEffort = tableInfo.some(col => col.name === 'effort');
         if (!tableExists) {
             // Fresh install: create new schema on remote
             await remoteClient.execute(`
@@ -36,6 +38,8 @@ async function initializeRemoteSchema(tursoUrl, authToken) {
           parent_id TEXT,
           waiting_for TEXT,
           context TEXT,
+          is_focused INTEGER NOT NULL DEFAULT 0,
+          effort TEXT,
           due_date INTEGER,
           created_at INTEGER NOT NULL,
           updated_at INTEGER NOT NULL
@@ -51,6 +55,14 @@ async function initializeRemoteSchema(tursoUrl, authToken) {
             await remoteClient.execute("ALTER TABLE tasks ADD COLUMN context TEXT");
             await remoteClient.execute("CREATE INDEX IF NOT EXISTS idx_tasks_context ON tasks(context)");
         }
+        // Migration: add is_focused column if missing
+        if (tableExists && !hasIsFocused) {
+            await remoteClient.execute("ALTER TABLE tasks ADD COLUMN is_focused INTEGER NOT NULL DEFAULT 0");
+        }
+        // Migration: add effort column if missing
+        if (tableExists && !hasEffort) {
+            await remoteClient.execute("ALTER TABLE tasks ADD COLUMN effort TEXT");
+        }
         // Create comments table
         await remoteClient.execute(`
       CREATE TABLE IF NOT EXISTS comments (
@@ -88,6 +100,8 @@ async function initializeLocalSchema() {
     const hasProjectId = tableInfo.some(col => col.name === 'project_id');
     const hasIsProject = tableInfo.some(col => col.name === 'is_project');
     const hasContext = tableInfo.some(col => col.name === 'context');
+    const hasIsFocused = tableInfo.some(col => col.name === 'is_focused');
+    const hasEffort = tableInfo.some(col => col.name === 'effort');
     const tableExists = tableInfo.length > 0;
     if (tableExists && hasProjectId && !hasIsProject) {
         // Migration: old schema -> new schema
@@ -119,6 +133,8 @@ async function initializeLocalSchema() {
         parent_id TEXT,
         waiting_for TEXT,
         context TEXT,
+        is_focused INTEGER NOT NULL DEFAULT 0,
+        effort TEXT,
         due_date INTEGER,
         created_at INTEGER NOT NULL,
         updated_at INTEGER NOT NULL
@@ -134,6 +150,14 @@ async function initializeLocalSchema() {
         await client.execute("ALTER TABLE tasks ADD COLUMN context TEXT");
         await client.execute("CREATE INDEX IF NOT EXISTS idx_tasks_context ON tasks(context)");
     }
+    // Migration: add is_focused column if missing
+    if (tableExists && !hasIsFocused) {
+        await client.execute("ALTER TABLE tasks ADD COLUMN is_focused INTEGER NOT NULL DEFAULT 0");
+    }
+    // Migration: add effort column if missing
+    if (tableExists && !hasEffort) {
+        await client.execute("ALTER TABLE tasks ADD COLUMN effort TEXT");
+    }
     // Create comments table
     await client.execute(`
     CREATE TABLE IF NOT EXISTS comments (

package/dist/db/schema.d.ts

@@ -152,6 +152,42 @@ export declare const tasks: import("drizzle-orm/sqlite-core").SQLiteTableWithCol
         }, {}, {
             length: number | undefined;
         }>;
+        isFocused: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "is_focused";
+            tableName: "tasks";
+            dataType: "boolean";
+            columnType: "SQLiteBoolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        effort: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "effort";
+            tableName: "tasks";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
         dueDate: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "due_date";
             tableName: "tasks";
@@ -209,6 +245,7 @@ export declare const tasks: import("drizzle-orm/sqlite-core").SQLiteTableWithCol
 export type Task = typeof tasks.$inferSelect;
 export type NewTask = typeof tasks.$inferInsert;
 export type TaskStatus = 'inbox' | 'next' | 'waiting' | 'someday' | 'done';
+export type EffortSize = 'small' | 'medium' | 'large';
 export declare const comments: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
     name: "comments";
     schema: undefined;

package/dist/db/schema.js

@@ -8,6 +8,8 @@ export const tasks = sqliteTable('tasks', {
     parentId: text('parent_id'),
     waitingFor: text('waiting_for'),
     context: text('context'),
+    isFocused: integer('is_focused', { mode: 'boolean' }).notNull().default(false),
+    effort: text('effort'),
     dueDate: integer('due_date', { mode: 'timestamp' }),
     createdAt: integer('created_at', { mode: 'timestamp' }).notNull(),
     updatedAt: integer('updated_at', { mode: 'timestamp' }).notNull(),