floq 0.1.0 → 0.2.1

package/README.ja.md

@@ -7,12 +7,16 @@ MS-DOSスタイルのテーマを備えたターミナルベースのGTD（Getti
 ## 特徴
 
 - **TUIインターフェース**: Ink（CLI用React）で構築されたインタラクティブなターミナルUI
-- **GTDワークフロー**: Inbox、Next Actions、Waiting For、Someday/Maybe
-- **プロジェクト**: タスクをプロジェクトに整理
+- **GTDワークフロー**: Inbox、Next Actions、Waiting For、Someday/Maybe、Done
+- **カンバンモード**: 3カラムのカンバンボード表示（TODO、Doing、Done）
+- **プロジェクト**: タスクをプロジェクトに整理（進捗バー表示付き）
+- **タスク検索**: `/` キーで全タスクを素早く検索
+- **コメント**: タスクにメモやコメントを追加
 - **クラウド同期**: [Turso](https://turso.tech/)のembedded replicasによるオプションの同期機能
 - **テーマ**: MS-DOSノスタルジックスタイルを含む複数テーマ
 - **多言語対応**: 英語・日本語サポート
 - **Vimスタイルナビゲーション**: hjklまたは矢印キーで操作
+- **セットアップウィザード**: 初回起動時の簡単設定
 
 ## インストール
 
@@ -38,11 +42,11 @@ npm link
 floq
 ```
 
-### キーボードショートカット
+### キーボードショートカット（GTDモード）
 
 | キー | アクション |
 |------|-----------|
-| `1-5` | タブ切り替え |
+| `1-6` | タブ切り替え（Inbox/Next/Waiting/Someday/Projects/Done） |
 | `h/l` または `←/→` | 前/次のタブ |
 | `j/k` または `↑/↓` | タスク選択 |
 | `a` | タスク追加 |
@@ -50,14 +54,75 @@ floq
 | `n` | Next Actionsに移動 |
 | `s` | Someday/Maybeに移動 |
 | `i` | Inboxに移動 |
+| `w` | Waiting Forに移動（担当者入力） |
 | `p` | プロジェクトに変換 |
 | `P` | プロジェクトに紐付け |
-| `Enter` | プロジェクトを開く（Projectsタブ） |
-| `Esc/b` | プロジェクトから戻る |
+| `Enter` | タスク詳細を開く / プロジェクトを開く |
+| `Esc/b` | 戻る |
+| `/` | タスク検索 |
 | `r` | 更新 |
 | `?` | ヘルプ |
 | `q` | 終了 |
 
+#### プロジェクト詳細画面
+
+| キー | アクション |
+|------|-----------|
+| `j/k` | タスク選択 |
+| `a` | プロジェクトにタスク追加 |
+| `d` | タスクを完了にする |
+| `Enter` | タスク詳細を開く |
+| `Esc/b` | プロジェクト一覧に戻る |
+
+#### タスク詳細画面
+
+| キー | アクション |
+|------|-----------|
+| `i` | コメント追加 |
+| `d` | 選択中のコメントを削除 |
+| `P` | プロジェクトに紐付け |
+| `j/k` | コメント選択 |
+| `Esc/b` | 一覧 / プロジェクトに戻る |
+
+### キーボードショートカット（カンバンモード）
+
+| キー | アクション |
+|------|-----------|
+| `1-3` | カラム切り替え（TODO/Doing/Done） |
+| `h/l` または `←/→` | 前/次のカラム |
+| `j/k` または `↑/↓` | タスク選択 |
+| `a` | タスク追加 |
+| `d` | 完了にする |
+| `m` | タスクを右に移動（→） |
+| `Backspace` | タスクを左に移動（←） |
+| `Enter` | タスク詳細を開く |
+| `/` | タスク検索 |
+| `r` | 更新 |
+| `?` | ヘルプ |
+| `q` | 終了 |
+
+#### タスク詳細画面（カンバン）
+
+| キー | アクション |
+|------|-----------|
+| `i` | コメント追加 |
+| `d` | 選択中のコメントを削除 |
+| `j/k` | コメント選択 |
+| `Esc/b` | ボードに戻る |
+
+### セットアップウィザード
+
+初回起動時、Floqはインタラクティブなセットアップウィザードを起動します:
+- 言語（英語/日本語）
+- テーマ選択
+- 表示モード（GTD/カンバン）
+
+手動でウィザードを起動することもできます:
+
+```bash
+floq setup
+```
+
 ### CLIコマンド
 
 ```bash
@@ -86,6 +151,10 @@ floq project add "プロジェクト名"
 floq project list
 floq project show <id>
 floq project complete <id>
+
+# コメント
+floq comment <id> "コメント内容"  # コメント追加
+floq comment <id>                  # コメント一覧
 ```
 
 ## 設定
@@ -105,9 +174,20 @@ floq config theme
 floq config theme modern           # デフォルト
 floq config theme synthwave        # ネオン80sスタイル
 
+# 表示モード設定（インタラクティブセレクター）
+floq config mode
+
+# または直接指定
+floq config mode gtd               # GTDワークフロー（デフォルト）
+floq config mode kanban            # カンバンボード
+
 # データベースパス設定
 floq config db /path/to/custom.db
 floq config db                     # デフォルトに戻す
+
+# データベースリセット（全データ削除）
+floq db reset                      # 確認あり
+floq db reset --force              # 確認なし
 ```
 
 ## クラウド同期（Turso）
@@ -139,7 +219,7 @@ floq config turso --disable
 - **Embedded Replicas**: ローカルSQLiteデータベースがTursoクラウドと同期
 - **オフラインサポート**: オフラインでも動作し、接続時に同期
 - **自動同期**: オンライン時は60秒ごとにバックグラウンド同期
-- **データベース分離**: Tursoモードは`gtd-turso.db`を使用し、ローカルDBと競合しない
+- **データベース分離**: Tursoモードは`floq-turso.db`を使用し、ローカルDBと競合しない
 
 ### ステータス表示
 
@@ -173,8 +253,8 @@ floq config turso --disable
 
 ## データ保存場所
 
-- 設定: `~/.config/gtd-cli/config.json`
-- データベース: `~/.local/share/gtd-cli/gtd.db`
+- 設定: `~/.config/floq/config.json`
+- データベース: `~/.local/share/floq/floq.db`（Turso有効時は`floq-turso.db`）
 
 ## ライセンス
 

package/README.md

@@ -7,12 +7,16 @@ A terminal-based GTD (Getting Things Done) task manager with MS-DOS style themes
 ## Features
 
 - **TUI Interface**: Interactive terminal UI built with Ink (React for CLI)
-- **GTD Workflow**: Inbox, Next Actions, Waiting For, Someday/Maybe
-- **Projects**: Organize tasks into projects
+- **GTD Workflow**: Inbox, Next Actions, Waiting For, Someday/Maybe, Done
+- **Kanban Mode**: 3-column kanban board view (TODO, Doing, Done)
+- **Projects**: Organize tasks into projects with progress tracking
+- **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
 - **Themes**: Multiple themes including MS-DOS nostalgic styles
 - **i18n**: English and Japanese support
 - **Vim-style Navigation**: Use hjkl or arrow keys
+- **Setup Wizard**: First-run wizard for easy configuration
 
 ## Installation
 
@@ -38,11 +42,11 @@ npm link
 floq
 ```
 
-### Keyboard Shortcuts
+### Keyboard Shortcuts (GTD Mode)
 
 | Key | Action |
 |-----|--------|
-| `1-5` | Switch tabs |
+| `1-6` | Switch tabs (Inbox/Next/Waiting/Someday/Projects/Done) |
 | `h/l` or `←/→` | Previous/Next tab |
 | `j/k` or `↑/↓` | Navigate tasks |
 | `a` | Add task |
@@ -50,14 +54,75 @@ floq
 | `n` | Move to Next Actions |
 | `s` | Move to Someday/Maybe |
 | `i` | Move to Inbox |
+| `w` | Move to Waiting For (prompts for person) |
 | `p` | Convert to project |
 | `P` | Link to project |
-| `Enter` | Open project (on Projects tab) |
-| `Esc/b` | Back from project |
+| `Enter` | Open task detail / Open project |
+| `Esc/b` | Back |
+| `/` | Search tasks |
 | `r` | Refresh |
 | `?` | Help |
 | `q` | Quit |
 
+#### Project Detail View
+
+| Key | Action |
+|-----|--------|
+| `j/k` | Navigate tasks |
+| `a` | Add task to project |
+| `d` | Mark task as done |
+| `Enter` | Open task detail |
+| `Esc/b` | Back to projects list |
+
+#### Task Detail View
+
+| Key | Action |
+|-----|--------|
+| `i` | Add comment |
+| `d` | Delete selected comment |
+| `P` | Link to project |
+| `j/k` | Navigate comments |
+| `Esc/b` | Back to list / project |
+
+### Keyboard Shortcuts (Kanban Mode)
+
+| Key | Action |
+|-----|--------|
+| `1-3` | Switch columns (TODO/Doing/Done) |
+| `h/l` or `←/→` | Previous/Next column |
+| `j/k` or `↑/↓` | Navigate tasks |
+| `a` | Add task |
+| `d` | Mark as done |
+| `m` | Move task right (→) |
+| `Backspace` | Move task left (←) |
+| `Enter` | Open task detail |
+| `/` | Search tasks |
+| `r` | Refresh |
+| `?` | Help |
+| `q` | Quit |
+
+#### Task Detail View (Kanban)
+
+| Key | Action |
+|-----|--------|
+| `i` | Add comment |
+| `d` | Delete selected comment |
+| `j/k` | Navigate comments |
+| `Esc/b` | Back to board |
+
+### Setup Wizard
+
+On first run, Floq will launch an interactive setup wizard to configure:
+- Language (English/Japanese)
+- Theme selection
+- View mode (GTD/Kanban)
+
+You can also run the wizard manually:
+
+```bash
+floq setup
+```
+
 ### CLI Commands
 
 ```bash
@@ -86,6 +151,10 @@ floq project add "Project name"
 floq project list
 floq project show <id>
 floq project complete <id>
+
+# Comments
+floq comment <id> "Comment text"  # Add comment
+floq comment <id>                 # List comments
 ```
 
 ## Configuration
@@ -105,9 +174,20 @@ floq config theme
 floq config theme modern           # Default
 floq config theme synthwave        # Neon 80s aesthetic
 
+# Set view mode (interactive selector)
+floq config mode
+
+# Or specify directly
+floq config mode gtd               # GTD workflow (default)
+floq config mode kanban            # Kanban board
+
 # Set database path
 floq config db /path/to/custom.db
 floq config db                     # Reset to default
+
+# Reset database (delete all data)
+floq db reset                      # With confirmation
+floq db reset --force              # Skip confirmation
 ```
 
 ## Cloud Sync (Turso)
@@ -139,7 +219,7 @@ floq config turso --disable
 - **Embedded Replicas**: Local SQLite database syncs with Turso cloud
 - **Offline Support**: Works offline, syncs when connected
 - **Auto Sync**: Background sync every 60 seconds when online
-- **Separate Database**: Turso mode uses `gtd-turso.db` to avoid conflicts
+- **Separate Database**: Turso mode uses `floq-turso.db` to avoid conflicts
 
 ### Status Indicator
 
@@ -173,8 +253,8 @@ floq config turso --disable
 
 ## Data Storage
 
-- Config: `~/.config/gtd-cli/config.json`
-- Database: `~/.local/share/gtd-cli/gtd.db`
+- Config: `~/.config/floq/config.json`
+- Database: `~/.local/share/floq/floq.db` (or `floq-turso.db` with Turso enabled)
 
 ## License
 

package/dist/changelog.d.ts

@@ -0,0 +1,13 @@
+export interface ChangelogEntry {
+    version: string;
+    date: string;
+    sections: {
+        type: 'Added' | 'Changed' | 'Deprecated' | 'Removed' | 'Fixed' | 'Security';
+        items: string[];
+    }[];
+}
+export interface Changelog {
+    entries: ChangelogEntry[];
+}
+export declare function parseChangelog(): Changelog;
+export declare function getLatestVersion(): string;

package/dist/changelog.js

@@ -0,0 +1,95 @@
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+function findChangelogPath() {
+    // Get the directory of the current module
+    const currentFile = fileURLToPath(import.meta.url);
+    const currentDir = dirname(currentFile);
+    // Try to find CHANGELOG.md relative to the package root
+    // From dist/ or src/, go up one level
+    const possiblePaths = [
+        join(currentDir, '..', 'CHANGELOG.md'),
+        join(currentDir, '..', '..', 'CHANGELOG.md'),
+        join(process.cwd(), 'CHANGELOG.md'),
+    ];
+    for (const path of possiblePaths) {
+        try {
+            readFileSync(path, 'utf-8');
+            return path;
+        }
+        catch {
+            // continue to next path
+        }
+    }
+    return possiblePaths[0]; // Return first path as fallback
+}
+export function parseChangelog() {
+    const changelogPath = findChangelogPath();
+    let content;
+    try {
+        content = readFileSync(changelogPath, 'utf-8');
+    }
+    catch {
+        return { entries: [] };
+    }
+    const entries = [];
+    const lines = content.split('\n');
+    let currentEntry = null;
+    let currentSection = null;
+    for (const line of lines) {
+        // Match version header: ## [0.1.0] - 2025-01-29 or ## [Unreleased]
+        const versionMatch = line.match(/^## \[([^\]]+)\](?:\s*-\s*(.+))?$/);
+        if (versionMatch) {
+            if (currentEntry) {
+                if (currentSection && currentSection.items.length > 0) {
+                    currentEntry.sections.push(currentSection);
+                }
+                if (currentEntry.sections.length > 0 || currentEntry.version !== 'Unreleased') {
+                    entries.push(currentEntry);
+                }
+            }
+            currentEntry = {
+                version: versionMatch[1],
+                date: versionMatch[2]?.trim() || '',
+                sections: [],
+            };
+            currentSection = null;
+            continue;
+        }
+        // Match section header: ### Added, ### Changed, etc.
+        const sectionMatch = line.match(/^### (Added|Changed|Deprecated|Removed|Fixed|Security)$/);
+        if (sectionMatch && currentEntry) {
+            if (currentSection && currentSection.items.length > 0) {
+                currentEntry.sections.push(currentSection);
+            }
+            currentSection = {
+                type: sectionMatch[1],
+                items: [],
+            };
+            continue;
+        }
+        // Match list item: - Item description
+        const itemMatch = line.match(/^- (.+)$/);
+        if (itemMatch && currentSection) {
+            currentSection.items.push(itemMatch[1]);
+        }
+    }
+    // Add last entry
+    if (currentEntry) {
+        if (currentSection && currentSection.items.length > 0) {
+            currentEntry.sections.push(currentSection);
+        }
+        if (currentEntry.sections.length > 0) {
+            entries.push(currentEntry);
+        }
+    }
+    // Filter out Unreleased if it has no content
+    return {
+        entries: entries.filter(e => e.version !== 'Unreleased' || e.sections.length > 0),
+    };
+}
+export function getLatestVersion() {
+    const changelog = parseChangelog();
+    const released = changelog.entries.find(e => e.version !== 'Unreleased');
+    return released?.version || '0.0.0';
+}

package/dist/cli.js

@@ -7,7 +7,9 @@ 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, setTurso, disableTurso, syncCommand } from './commands/config.js';
+import { showConfig, setLanguage, setDbPath, resetDbPath, setTheme, selectTheme, setViewModeCommand, selectMode, setTurso, disableTurso, syncCommand, resetDatabase } from './commands/config.js';
+import { addComment, listComments } from './commands/comment.js';
+import { runSetupWizard } from './commands/setup.js';
 import { VERSION } from './version.js';
 const program = new Command();
 program
@@ -121,6 +123,17 @@ configCmd
         await selectTheme();
     }
 });
+configCmd
+    .command('mode [mode]')
+    .description('Set view mode (gtd, kanban) or select interactively')
+    .action(async (mode) => {
+    if (mode) {
+        await setViewModeCommand(mode);
+    }
+    else {
+        await selectMode();
+    }
+});
 configCmd
     .command('turso')
     .description('Configure Turso cloud sync')
@@ -147,4 +160,34 @@ program
     .action(async () => {
     await syncCommand();
 });
+// Database commands
+const dbCmd = program
+    .command('db')
+    .description('Database management commands');
+dbCmd
+    .command('reset')
+    .description('Reset the database (delete all data)')
+    .option('-f, --force', 'Skip confirmation')
+    .action(async (options) => {
+    await resetDatabase(options.force ?? false);
+});
+// Comment command
+program
+    .command('comment <taskId> [content]')
+    .description('Add or list comments for a task')
+    .action(async (taskId, content) => {
+    if (content) {
+        await addComment(taskId, content);
+    }
+    else {
+        await listComments(taskId);
+    }
+});
+// Setup wizard command
+program
+    .command('setup')
+    .description('Run the setup wizard')
+    .action(async () => {
+    await runSetupWizard();
+});
 export { program };

package/dist/commands/comment.d.ts

@@ -0,0 +1,2 @@
+export declare function addComment(taskId: string, content: string): Promise<void>;
+export declare function listComments(taskId: string): Promise<void>;

package/dist/commands/comment.js

@@ -0,0 +1,67 @@
+import { eq, like } from 'drizzle-orm';
+import { v4 as uuidv4 } from 'uuid';
+import { getDb, schema } from '../db/index.js';
+import { t, fmt } from '../i18n/index.js';
+export async function addComment(taskId, content) {
+    const db = getDb();
+    const i18n = t();
+    // Find task by ID prefix
+    const tasks = await db
+        .select()
+        .from(schema.tasks)
+        .where(like(schema.tasks.id, `${taskId}%`));
+    if (tasks.length === 0) {
+        console.error(fmt(i18n.commands.comment.notFound, { id: taskId }));
+        process.exit(1);
+    }
+    if (tasks.length > 1) {
+        console.error(fmt(i18n.commands.comment.multipleMatch, { id: taskId }));
+        for (const task of tasks) {
+            console.error(`  [${task.id.slice(0, 8)}] ${task.title}`);
+        }
+        process.exit(1);
+    }
+    const task = tasks[0];
+    await db.insert(schema.comments).values({
+        id: uuidv4(),
+        taskId: task.id,
+        content: content.trim(),
+        createdAt: new Date(),
+    });
+    console.log(fmt(i18n.commands.comment.added, { title: task.title }));
+}
+export async function listComments(taskId) {
+    const db = getDb();
+    const i18n = t();
+    // Find task by ID prefix
+    const tasks = await db
+        .select()
+        .from(schema.tasks)
+        .where(like(schema.tasks.id, `${taskId}%`));
+    if (tasks.length === 0) {
+        console.error(fmt(i18n.commands.comment.notFound, { id: taskId }));
+        process.exit(1);
+    }
+    if (tasks.length > 1) {
+        console.error(fmt(i18n.commands.comment.multipleMatch, { id: taskId }));
+        for (const task of tasks) {
+            console.error(`  [${task.id.slice(0, 8)}] ${task.title}`);
+        }
+        process.exit(1);
+    }
+    const task = tasks[0];
+    const comments = await db
+        .select()
+        .from(schema.comments)
+        .where(eq(schema.comments.taskId, task.id));
+    if (comments.length === 0) {
+        console.log(fmt(i18n.commands.comment.listHeader, { title: task.title }));
+        console.log(`  ${i18n.commands.comment.noComments}`);
+        return;
+    }
+    console.log(fmt(i18n.commands.comment.listHeader, { title: task.title }));
+    for (const comment of comments) {
+        const date = comment.createdAt.toLocaleString();
+        console.log(`  [${date}] ${comment.content}`);
+    }
+}

package/dist/commands/config.d.ts

@@ -4,6 +4,10 @@ export declare function setDbPath(dbPath: string): Promise<void>;
 export declare function resetDbPath(): Promise<void>;
 export declare function setTheme(theme: string): Promise<void>;
 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 setTurso(url: string, token: string): Promise<void>;
 export declare function disableTurso(): Promise<void>;
 export declare function syncCommand(): Promise<void>;
+export declare function resetDatabase(force: boolean): Promise<void>;