vibetree 1.0.1

package/README.md

@@ -0,0 +1,97 @@
+# Vibe-Flow
+
+Vibe-Flow is a local AI-enhanced Kanban board designed for seamless task management and code integration. It combines a modern React frontend with a robust Node.js backend, built with TypeScript for enhanced type safety and developer experience.
+
+## Quick Start with npx
+
+You can launch Vibe-Flow directly using `npx` without installation:
+
+```bash
+npx github:takecian/vibe-flow
+```
+
+The app will start and automatically open in your default browser at `http://localhost:3000`.
+
+## Features
+
+- **Kanban Board**: Manage tasks with Todo, In Progress, In Review, Done, and Cancelled statuses.
+- **Git Integration**:
+    - Select and manage local Git repositories.
+    - Create Git worktrees for each task automatically.
+    - View git status, diffs, and create commits/PRs directly from the UI.
+- **AI Assistant Integration**:
+    - Configure and use local CLI AI tools like **Claude**, **Codex**, and **Gemini**.
+    - Robust tool detection (checks PATH and configuration files).
+    - Integrated terminal for executing AI commands and scripts.
+- **Task Management**:
+    - Create tasks with titles and detailed descriptions.
+    - Track task progress and history.
+- **Native System Integration**:
+    - Native directory picker for selecting repositories.
+    - Terminal emulator (xterm.js) embedded in task details.
+- **Modern UI**:
+    - Built with React and Vite.
+    - Drag-and-drop interface (hello-pangea/dnd).
+    - Dark mode optimized.
+- **TypeScript**:
+    - Fully typed codebase for both client and server.
+    - Strict mode enabled for maximum type safety.
+
+## Prerequisites
+
+- **Node.js**: (v16+ recommended)
+- **Git**: Installed and configured.
+- **AI Tools** (Optional but recommended):
+    - `claude` (Claude CLI)
+    - `gemini` (Gemini CLI)
+    - `codex`
+    - Ensure these are installed and available in your PATH or configured in their default home directories (e.g., `~/.gemini`).
+
+## Installation
+
+1.  Clone the repository:
+    ```bash
+    git clone https://github.com/takecian/vibe-flow.git
+    cd vibe-flow
+    ```
+
+2.  Install dependencies:
+    ```bash
+    npm install
+    # This will install dependencies for both root, client, and server workspaces.
+    ```
+
+3.  Build the project (compiles TypeScript):
+    ```bash
+    npm run build
+    ```
+
+## Usage
+
+1.  Start the development server (runs both client and server concurrently):
+    ```bash
+    npm run dev
+    ```
+
+2.  Open your browser and navigate to `http://localhost:5173`.
+
+3.  **Setup**:
+    - Click the **Settings** (gear icon) in the top right.
+    - Select your target Git **Repository Path**.
+    - Select your preferred **AI Assistant**.
+
+4.  **Workflow**:
+    - Create a new task.
+    - Click "Setup Worktree" in the task detail view to create an isolated environment.
+    - Use the embedded terminal to run commands or interact with the AI assistant.
+    - Drag tasks across columns to update status.
+
+## Project Structure
+
+-   `client/`: React frontend (Vite) - TypeScript with `.tsx` components.
+-   `server/`: Express.js backend - TypeScript compiled to `dist/`.
+-   `bin/`: CLI entry point.
+
+## License
+
+ISC

package/bin/vibe-flow.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const { spawn, spawnSync } = require('child_process');
+const yargs = require('yargs/yargs');
+const { hideBin } = require('yargs/helpers');
+const prompts = require('prompts');
+// const open = require('open'); // Moved to dynamic import
+
+const argv = yargs(hideBin(process.argv))
+    .option('repo', {
+        alias: 'r',
+        type: 'string',
+        description: 'Path to target repository',
+    })
+    .option('ai', {
+        alias: 'a',
+        type: 'string',
+        choices: ['claude', 'codex', 'gemini'],
+        description: 'AI tool to use',
+    })
+    .argv;
+
+(async () => {
+    // 1. Resolve Repo Path
+    let repoPath = argv.repo ? path.resolve(argv.repo) : process.cwd();
+
+    if (!fs.existsSync(repoPath) || !fs.statSync(repoPath).isDirectory()) {
+        console.error(`Error: Repository path does not exist: ${repoPath}`);
+        process.exit(1);
+    }
+
+    // 2. Resolve AI Tool
+    const configPath = path.join(repoPath, '.vibe-flow', 'config.json');
+    let config = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        } catch (e) { }
+    }
+
+    let aiTool = argv.ai || config.aiTool;
+
+    if (!aiTool) {
+        const response = await prompts({
+            type: 'select',
+            name: 'aiTool',
+            message: 'Select AI tool to use:',
+            choices: [
+                { title: 'Claude', value: 'claude' },
+                { title: 'Codex (OpenAI)', value: 'codex' },
+                { title: 'Gemini', value: 'gemini' },
+            ],
+        });
+        aiTool = response.aiTool;
+
+        // Save preference
+        const vibeDir = path.join(repoPath, '.vibe-flow');
+        if (!fs.existsSync(vibeDir)) fs.mkdirSync(vibeDir, { recursive: true });
+        fs.writeFileSync(path.join(vibeDir, 'config.json'), JSON.stringify({ aiTool }, null, 2));
+    }
+
+    console.log(`Starting Vibe-Flow...`);
+    console.log(`Repository: ${repoPath}`);
+    console.log(`AI Tool: ${aiTool}`);
+
+    // 3. Start Server
+    const pkgRoot = path.join(__dirname, '..');
+    const serverPath = path.join(pkgRoot, 'server', 'dist', 'index.js');
+    const clientPath = path.join(pkgRoot, 'client', 'dist');
+    const env = {
+        ...process.env,
+        REPO_PATH: repoPath,
+        AI_TOOL: aiTool,
+        VIBE_FLOW_PORT: process.env.VIBE_FLOW_PORT || 3000,
+    };
+
+    if (!fs.existsSync(serverPath)) {
+        console.log('Building server (first run or npx)...');
+        const build = spawnSync('npm', ['run', 'build', '-w', 'server'], {
+            cwd: pkgRoot,
+            stdio: 'inherit',
+            shell: true,
+        });
+        if (build.status !== 0) {
+            console.error('Server build failed.');
+            process.exit(build.status || 1);
+        }
+    }
+
+    if (!fs.existsSync(clientPath)) {
+        console.log('Building client dashboard (first run or npx)...');
+        const build = spawnSync('npm', ['run', 'build', '-w', 'client'], {
+            cwd: pkgRoot,
+            stdio: 'inherit',
+            shell: true,
+        });
+        if (build.status !== 0) {
+            console.error('Client build failed.');
+            process.exit(build.status || 1);
+        }
+    }
+
+    console.log('Launching server...');
+    const serverProcess = spawn('node', [serverPath], { env, stdio: 'inherit', cwd: pkgRoot });
+
+    serverProcess.on('error', (err) => {
+        console.error('Failed to start server:', err);
+    });
+
+    // Open Browser
+    const { default: open } = await import('open');
+    const port = process.env.VIBE_FLOW_PORT || 3000;
+    setTimeout(() => {
+        console.log(`Opening dashboard at http://localhost:${port}...`);
+        open(`http://localhost:${port}`);
+    }, 2000);
+
+})();

package/client/.eslintrc.cjs

@@ -0,0 +1,21 @@
+module.exports = {
+  root: true,
+  env: { browser: true, es2020: true },
+  extends: [
+    'eslint:recommended',
+    'plugin:react/recommended',
+    'plugin:react/jsx-runtime',
+    'plugin:react-hooks/recommended',
+  ],
+  ignorePatterns: ['dist', '.eslintrc.cjs'],
+  parserOptions: { ecmaVersion: 'latest', sourceType: 'module' },
+  settings: { react: { version: '18.2' } },
+  plugins: ['react-refresh'],
+  rules: {
+    'react/jsx-no-target-blank': 'off',
+    'react-refresh/only-export-components': [
+      'warn',
+      { allowConstantExport: true },
+    ],
+  },
+}