floq 0.0.1 → 0.2.0

package/README.ja.md

@@ -7,15 +7,28 @@ 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または矢印キーで操作
+- **セットアップウィザード**: 初回起動時の簡単設定
 
 ## インストール
 
 ```bash
+npm install -g floq
+```
+
+### ソースからインストール
+
+```bash
+git clone https://github.com/polidog/gtd-cli.git
+cd gtd-cli
 npm install
 npm run build
 npm link
@@ -29,11 +42,11 @@ npm link
 floq
 ```
 
-### キーボードショートカット
+### キーボードショートカット（GTDモード）
 
 | キー | アクション |
 |------|-----------|
-| `1-5` | タブ切り替え |
+| `1-6` | タブ切り替え（Inbox/Next/Waiting/Someday/Projects/Done） |
 | `h/l` または `←/→` | 前/次のタブ |
 | `j/k` または `↑/↓` | タスク選択 |
 | `a` | タスク追加 |
@@ -41,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
@@ -77,6 +151,10 @@ floq project add "プロジェクト名"
 floq project list
 floq project show <id>
 floq project complete <id>
+
+# コメント
+floq comment <id> "コメント内容"  # コメント追加
+floq comment <id>                  # コメント一覧
 ```
 
 ## 設定
@@ -89,44 +167,94 @@ floq config show
 floq config lang en    # 英語
 floq config lang ja    # 日本語
 
-# テーマ設定
+# テーマ設定（j/kで選択するインタラクティブセレクター）
+floq config theme
+
+# または直接指定
 floq config theme modern           # デフォルト
-floq config theme norton-commander # MS-DOSスタイル
-floq config theme dos-prompt       # 緑テキスト
-floq config theme turbo-pascal     # IDEスタイル
+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）
 
-### modern（デフォルト）
-シンプルでクリーンなスタイル。シングルボーダー。
+Floqは[Turso](https://turso.tech/)を使用したクラウド同期をサポートしています。Embedded replicasにより、データはクラウドに同期されつつ、オフラインでも利用可能です。
 
-### norton-commander
-- ダブルラインボーダー（╔═╗║╚═╝）
-- 大文字ヘッダー
-- 画面下部にファンクションキーバー
-- シアン/黄色のカラースキーム
+### セットアップ
 
-### dos-prompt
-- シングルラインボーダー
-- 緑テキスト（CRTモニター風）
-- シンプルな `>` 選択インジケータ
+1. [turso.tech](https://turso.tech/)でデータベースを作成
+2. データベースURLと認証トークンを取得
+3. Floqを設定:
 
-### turbo-pascal
-- ダブルラインボーダー
-- 黄色のアクセント
-- IDE風の外観
+```bash
+# Turso同期を有効化
+floq config turso --url libsql://your-db.turso.io --token your-auth-token
+
+# 設定確認
+floq config show
+
+# 手動同期
+floq sync
+
+# Turso同期を無効化
+floq config turso --disable
+```
+
+### 仕組み
+
+- **Embedded Replicas**: ローカルSQLiteデータベースがTursoクラウドと同期
+- **オフラインサポート**: オフラインでも動作し、接続時に同期
+- **自動同期**: オンライン時は60秒ごとにバックグラウンド同期
+- **データベース分離**: Tursoモードは`floq-turso.db`を使用し、ローカルDBと競合しない
+
+### ステータス表示
+
+- TUIヘッダーに接続状態を表示（Tursoはクラウドアイコン、ローカルはローカルアイコン）
+- CLIコマンド実行時、Turso有効時は`🔄 Turso sync: hostname`を表示
+
+## テーマ
 
-> **注意**: 背景色はターミナルの設定に依存します。完全なDOS体験のためには、ターミナルの背景色を青（#0000AA）に設定してください。
+16種類のテーマが利用可能。`floq config theme` でインタラクティブに選択（j/kで移動）。
+
+| テーマ | 説明 |
+|--------|------|
+| `modern` | シンプルでクリーン（デフォルト） |
+| `norton-commander` | MS-DOSファイルマネージャー風 |
+| `dos-prompt` | 緑のCRTモニター |
+| `turbo-pascal` | Borland IDE風 |
+| `classic-mac` | Macintosh System 7モノクロ |
+| `apple-ii` | Apple ][ グリーンモニター |
+| `commodore-64` | C64の青紫カラー |
+| `amiga-workbench` | Amigaのオレンジ＆ブルー |
+| `matrix` | デジタルレイン風グリーン |
+| `amber-crt` | 琥珀色モニター |
+| `phosphor` | CRT残光エフェクト |
+| `solarized-dark` | Solarizedダーク |
+| `solarized-light` | Solarizedライト |
+| `synthwave` | ネオン80sスタイル |
+| `paper` | 紙とインク風ライト |
+| `coffee` | 暖かみのある茶系 |
+
+> **注意**: 背景色はターミナルの設定に依存します。
 
 ## データ保存場所
 
-- 設定: `~/.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,15 +7,28 @@ 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
 
 ```bash
+npm install -g floq
+```
+
+### From Source
+
+```bash
+git clone https://github.com/polidog/gtd-cli.git
+cd gtd-cli
 npm install
 npm run build
 npm link
@@ -29,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 |
@@ -41,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
@@ -77,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
@@ -89,44 +167,94 @@ floq config show
 floq config lang en    # English
 floq config lang ja    # Japanese
 
-# Set theme
+# Set theme (interactive selector with j/k navigation)
+floq config theme
+
+# Or specify directly
 floq config theme modern           # Default
-floq config theme norton-commander # MS-DOS style
-floq config theme dos-prompt       # Green on black
-floq config theme turbo-pascal     # IDE style
+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
 ```
 
-## Themes
+## Cloud Sync (Turso)
 
-### modern (default)
-Clean, minimal style with single borders.
+Floq supports cloud synchronization using [Turso](https://turso.tech/), a SQLite-compatible database service. With embedded replicas, your data syncs to the cloud while remaining available offline.
 
-### norton-commander
-- Double-line borders (╔═╗║╚═╝)
-- Uppercase headers
-- Function key bar at bottom
-- Cyan/yellow color scheme
+### Setup
 
-### dos-prompt
-- Single-line borders
-- Green text (CRT monitor style)
-- Simple `>` selection indicator
+1. Create a Turso database at [turso.tech](https://turso.tech/)
+2. Get your database URL and auth token
+3. Configure Floq:
 
-### turbo-pascal
-- Double-line borders
-- Yellow accents
-- IDE-style appearance
+```bash
+# Enable Turso sync
+floq config turso --url libsql://your-db.turso.io --token your-auth-token
+
+# Check configuration
+floq config show
+
+# Manual sync
+floq sync
+
+# Disable Turso sync
+floq config turso --disable
+```
+
+### How It Works
+
+- **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 `floq-turso.db` to avoid conflicts
+
+### Status Indicator
+
+- TUI header shows connection status (cloud icon for Turso, local icon for local mode)
+- CLI commands display `🔄 Turso sync: hostname` when Turso is enabled
+
+## Themes
 
-> **Note**: Background colors depend on your terminal settings. For the full DOS experience, configure your terminal's background color to blue (#0000AA).
+16 themes available. Use `floq config theme` for interactive selection (j/k to navigate).
+
+| Theme | Description |
+|-------|-------------|
+| `modern` | Clean, minimal style (default) |
+| `norton-commander` | MS-DOS file manager style |
+| `dos-prompt` | Green CRT monitor |
+| `turbo-pascal` | Borland IDE style |
+| `classic-mac` | Macintosh System 7 monochrome |
+| `apple-ii` | Apple ][ green phosphor |
+| `commodore-64` | C64 blue/purple palette |
+| `amiga-workbench` | Amiga orange & blue |
+| `matrix` | Digital rain green |
+| `amber-crt` | Amber monitor |
+| `phosphor` | CRT phosphor glow |
+| `solarized-dark` | Solarized dark palette |
+| `solarized-light` | Solarized light palette |
+| `synthwave` | Neon 80s aesthetic |
+| `paper` | Light minimal theme |
+| `coffee` | Warm brown tones |
+
+> **Note**: Background colors depend on your terminal settings.
 
 ## 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 } 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,4 +123,71 @@ 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')
+    .option('--url <url>', 'Turso database URL (libsql://xxx.turso.io)')
+    .option('--token <token>', 'Turso auth token')
+    .option('--disable', 'Disable Turso sync')
+    .action(async (options) => {
+    if (options.disable) {
+        await disableTurso();
+    }
+    else if (options.url && options.token) {
+        await setTurso(options.url, options.token);
+    }
+    else {
+        console.error('Usage: floq config turso --url <url> --token <token>');
+        console.error('       floq config turso --disable');
+        process.exit(1);
+    }
+});
+// Sync command
+program
+    .command('sync')
+    .description('Sync with Turso cloud')
+    .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 };