rbin-task-flow 1.0.0

package/README.md

@@ -0,0 +1,381 @@
+# RBIN Task Flow
+
+<div align="center">
+
+![Claude](https://img.shields.io/badge/Claude-Sonnet%204.5-8A2BE2?style=for-the-badge&logo=anthropic&logoColor=white)
+![Gemini](https://img.shields.io/badge/Gemini-3%20Flash-4285F4?style=for-the-badge&logo=google&logoColor=white)
+![Cursor](https://img.shields.io/badge/Cursor-IDE-blue?style=for-the-badge&logo=visual-studio-code&logoColor=white)
+![Task Flow](https://img.shields.io/badge/Task%20Flow-AI%20Powered-green?style=for-the-badge)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)
+![npm](https://img.shields.io/npm/v/rbin-task-flow?style=for-the-badge)
+
+**One-command setup for Claude Code, Gemini, Cursor, and RBIN Task Flow in any project**
+
+</div>
+
+---
+
+## Overview
+
+A centralized repository of development configurations and rules that can be instantly installed in any project. Provides complete setup for Claude Code, Gemini, Cursor IDE, and RBIN Task Flow - a simple AI-powered task management system.
+
+### Key Features
+
+- **NPM Global Installation** - Install once, use everywhere with `npm install -g rbin-task-flow`
+- **Simple Task Management** - Define tasks in plain text, AI generates detailed subtasks
+- **Multiple AI Models** - Claude Code Sonnet and Gemini 3 Flash configured and ready to use
+- **Discrete .gitignore** - AI configs hidden with generic comments
+- **Zero Configuration** - Ready to use immediately
+- **RBIN Task Flow** - AI-powered task management with simple text interface
+
+## System Requirements
+
+- **Operating System:** macOS, Linux, or Windows (WSL)
+- **Tools:** Git, Bash, Node.js
+- **Required:** Claude Code CLI, Gemini API access, or Cursor IDE (with Pro subscription)
+
+## Installation
+
+### Quick Start (NPM Global)
+
+```bash
+# 1. Install globally via npm (one time only)
+npm install -g rbin-task-flow
+
+# 2. Go to any project and initialize
+cd /path/to/your/project
+rbin-task-flow init
+
+# 3. Use AI commands
+# Edit .task-flow/tasks.input.txt and use:
+# - task-flow: sync
+# - task-flow: run next X
+# - task-flow: run task X
+```
+
+**That's it!** RBIN Task Flow is now available globally on your system.
+
+### Alternative: Legacy Installation (Without NPM)
+
+If you prefer the old method without npm:
+
+```bash
+# 1. Clone this repository
+git clone https://github.com/rubensdeoliveira/rbin-task-flow.git ~/.rbin-task-flow
+
+# 2. Install in your project
+~/.rbin-task-flow/install.sh
+# Enter your project path when prompted
+```
+
+### What Gets Installed
+
+The script creates and configures:
+
+```
+your-project/
+├── .cursor/
+│   ├── rules/                    # All development rules
+│   │   ├── cursor_rules.mdc
+│   │   ├── self_improve.mdc
+│   │   ├── code_comments.mdc
+│   │   ├── commit_practices.mdc
+│   │   ├── git_control.mdc
+│   │   └── task_execution.mdc
+│   └── settings.json             # Cursor model settings
+│
+├── .claude/
+│   └── settings.json             # Claude Code settings
+│
+├── .gemini/
+│   └── settings.json             # Gemini settings
+│
+├── .task-flow/                   # RBIN Task Flow
+│   ├── tasks.input.txt           # Plain text task definitions (edit this!)
+│   ├── tasks.status.md           # ⚠️ Task status (auto-updated, DO NOT EDIT)
+│   └── .internal/                # ⚠️ Internal system files (ignore - auto-generated)
+│       ├── tasks.json            # Task definitions (auto)
+│       └── status.json           # Task status tracking (auto)
+│
+└── .gitignore                    # Updated with discrete entries
+```
+
+## Configuration
+
+No additional configuration required! Just make sure you have:
+- Claude Code CLI installed, OR
+- Gemini API access configured, OR
+- Cursor IDE with an active Pro subscription
+
+**You're ready!**
+
+## Usage
+
+### RBIN Task Flow Commands
+
+After installing globally, you can use these commands:
+
+```bash
+# Initialize in current directory
+rbin-task-flow init
+
+# Update configurations
+rbin-task-flow update
+
+# Check for model version updates
+rbin-task-flow version-check
+
+# Show help information
+rbin-task-flow info
+```
+
+### AI Commands
+
+Once initialized in a project, use these AI commands:
+- `task-flow: sync` - Sincronização completa: adiciona novas, remove removidas, atualiza modificadas, preserva status
+- `task-flow: think` - Analisa código e sugere novas tasks
+- `task-flow: run next X` - Trabalha nas próximas X subtasks sequenciais
+- `task-flow: run task X` - Executa todas as subtasks pendentes da task X (só executa se tasks anteriores estiverem completas - permite trabalho paralelo)
+- `task-flow: status` - Mostra status atual das tasks
+- `task-flow: review` - Revisa tasks concluídas
+- `task-flow: refactor` - Refatora código do commit atual
+
+**Complete workflow:**
+
+```bash
+# 1. Install globally (one time)
+npm install -g rbin-task-flow
+
+# 2. Initialize in your project
+cd /path/to/my-project
+rbin-task-flow init
+
+# 3. Use AI commands:
+#    - Edit .task-flow/tasks.input.txt and use 'task-flow: sync' to generate
+#    - Use 'task-flow: run next X' to work on next X subtasks
+#    - Use 'task-flow: run task X' to work on all subtasks of task X
+#    - Use 'task-flow: status' to view progress
+```
+
+**Key features:**
+- ✅ **.task-flow/** directory is automatically **gitignored**
+- ✅ Your task progress stays **local and private**
+- ✅ Team members can use their own tasks without conflicts
+- ✅ AI generates detailed, actionable subtasks from simple descriptions
+
+### Cursor Integration
+
+Cursor is pre-configured with:
+- Claude Sonnet 4.5 Pro as default model
+- Custom settings
+- RBIN Task Flow integration
+- Development best practices
+
+All rules are automatically active in Cursor. The IDE will:
+- Follow coding standards from `.cursor/rules/`
+- Integrate with RBIN Task Flow workflows
+- Follow commit and git practices
+
+### Claude Code Integration
+
+Claude Code is pre-configured with:
+- Custom settings
+- RBIN Task Flow integration
+- Development best practices
+
+### Gemini Integration
+
+Gemini is pre-configured with:
+- Custom settings
+- RBIN Task Flow integration
+- Development best practices
+
+## What's Configured
+
+### Development Rules
+
+Included rules for:
+- Cursor rule formatting
+- Self-improvement processes
+- Code commenting standards
+- Commit practices
+- Git command control
+- Task execution management
+
+### RBIN Task Flow
+
+Simple yet powerful task management:
+- **Plain Text Input**: Write tasks in `.task-flow/tasks.input.txt` using simple format
+- **AI-Powered Generation**: Transforms simple tasks into detailed, actionable subtasks
+- **Smart Instructions**: Each subtask includes context, objectives, implementation steps, and validation
+- **Simple Tracking**: JSON-based status management with easy CLI commands
+- **Progress Monitoring**: Clear visual feedback on task completion
+
+## Discrete .gitignore
+
+The installer adds these entries to `.gitignore`:
+
+```gitignore
+.claude/
+.gemini/
+.cursor/
+.task-flow/
+CLAUDE.md
+GEMINI.md
+```
+
+**Why discrete?**
+- No comments explaining what they are
+- No mention of "AI", "Claude", or "Anthropic"
+- Everything related to RBIN Task Flow stays local
+- Clean git history without AI tooling files
+
+## Updating Projects
+
+To update configs in an existing project:
+
+```bash
+# Using NPM (recommended)
+cd /path/to/your/project
+rbin-task-flow update
+
+# Or using legacy method
+~/.rbin-task-flow/install.sh
+# Enter the project path
+```
+
+The installer will:
+- ✅ Copy new rules (always overwrites)
+- ✅ **Overwrite config files** (settings.json) with latest versions
+- ✅ Update .gitignore if needed
+- ✅ Update Task Flow scripts (always overwrites)
+- ✅ **Preserve your data**: `.internal/tasks.json` and `.internal/status.json` are **NOT overwritten** (your tasks stay safe)
+
+**Note**: The installer automatically adds `.task-flow/` to `.gitignore`, keeping your task progress private and out of version control.
+
+## Project Structure
+
+This repository contains:
+
+```
+rbin-task-flow/
+├── .cursor/
+│   ├── settings.json             # Cursor model settings
+│   └── rules/                    # All development rules
+│
+├── .claude/
+│   └── settings.json             # Claude Code settings
+│
+├── .gemini/
+│   └── settings.json             # Gemini settings
+│
+├── .task-flow/
+│   ├── README.md                 # Quick commands reference
+│   ├── tasks.input.txt           # Task definitions template
+│   ├── tasks.status.md           # ⚠️ Task status template (DO NOT EDIT manually)
+│   └── .internal/                # ⚠️ Internal system files (ignore - auto-generated)
+│       ├── tasks.json            # Task definitions (auto)
+│       └── status.json           # Task status tracking (auto)
+│
+├── .gitignore                    # Template gitignore
+├── .model-versions.json          # Model version reference (update when new models are released)
+├── CLAUDE.md                     # Main Claude instructions
+├── GEMINI.md                     # Main Gemini instructions
+├── install.sh                    # Installation script
+└── README.md                     # This file
+```
+
+## Important Notes
+
+- ⚠️ This is a **template repository** - don't use RBIN Task Flow here
+- ✅ Use RBIN Task Flow in **projects that receive** the configs via installation
+- 🔄 Installer **always overwrites** existing configs
+- 🤫 .gitignore entries are **discrete** (no AI mentions)
+- 🎯 Works with **Claude Code CLI**, **Gemini API**, or **Cursor Pro**
+- 📦 Task Flow directory (`.task-flow/`) is **automatically gitignored**
+- 📝 Define tasks in `.task-flow/tasks.input.txt` using simple format: `- Task description`
+- 🚀 **NPM Global Install**: `npm install -g rbin-task-flow`, then use `rbin-task-flow init` in any project
+- 🔒 **API keys may be required** - depends on your AI provider (Claude Code, Gemini API, or Cursor Pro)
+- 🔔 **Model version checking** - Use `rbin-task-flow version-check` to check for newer model versions (fast, local check)
+
+## Updating Model Versions
+
+When new model versions are released, update `.model-versions.json` in this repository:
+
+```json
+{
+  "claude": {
+    "current": "claude-sonnet-4-5-20250929",
+    "latest": "NEW_VERSION_HERE",
+    "checkUrl": "https://docs.anthropic.com/claude/docs/models-overview"
+  },
+  "cursor": {
+    "current": "claude-sonnet-4-5-20250929",
+    "latest": "NEW_VERSION_HERE",
+    "checkUrl": "https://docs.cursor.com/models"
+  },
+  "gemini": {
+    "current": "gemini-3-flash",
+    "latest": "NEW_VERSION_HERE",
+    "checkUrl": "https://ai.google.dev/models/gemini"
+  }
+}
+```
+
+The installer will automatically check for newer model versions and **ask you individually** if you want to update each one (Claude, Cursor, Gemini). This check is **fast and local** - no API calls, no network requests, just a simple string comparison.
+
+**Interactive Updates:** When a newer version is available, the installer will:
+- Show current and latest versions
+- Ask: "Update [Model] to latest version? [y/N]"
+- Update only if you confirm with `y`
+- Skip if you press Enter or type `n`
+
+**Important:** Model version updates work differently:
+
+- **When installing in a target project** (passing a path):
+  - The installer **copies/replaces** files from the repository template to the target project
+  - **NO model update prompts** - just copies what's in the template
+  - Target project receives the current template versions
+
+- **When running installer in the repository itself** (rbin-task-flow):
+  - If new model versions are detected, you can choose to update them
+  - Updates are applied **only to the repository template** files
+  - After updating the template, run installer on projects to apply the new versions
+
+**Workflow:**
+1. Run installer on a project → copies current template files to project (no update prompts)
+2. To update repository template → run installer in the repository itself, choose to update
+3. Run installer again on projects → copies updated template files to projects
+
+You have full control - model updates only happen in the repository template, not in target projects.
+
+## Contributing
+
+Contributions welcome! To add new rules or improve templates:
+
+1. Fork this repository
+2. Create a feature branch
+3. Add your rules/templates following existing formats
+4. Test in a real project
+5. Submit a Pull Request
+
+## License
+
+MIT License - See LICENSE file for details
+
+## Support
+
+For issues or questions:
+- Open an issue on GitHub
+- Check existing issues for solutions
+- Refer to CHANGELOG.md for recent updates
+
+---
+
+<div align="center">
+
+**Made with ❤️ for developers who love simple, AI-powered workflows**
+
+[⬆ Back to top](#rbin-task-flow)
+
+</div>

package/bin/cli.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const path = require('path');
+const { installInProject } = require('../lib/install');
+const { checkVersionUpdates } = require('../lib/version');
+const chalk = require('chalk');
+
+program
+  .name('rbin-task-flow')
+  .description('AI-powered task management for Claude, Cursor, and Gemini')
+  .version(require('../package.json').version);
+
+program
+  .command('init')
+  .description('Initialize RBIN Task Flow in current directory')
+  .option('-p, --path <path>', 'Target directory (default: current directory)')
+  .action(async (options) => {
+    const targetPath = options.path || process.cwd();
+    await installInProject(targetPath);
+  });
+
+program
+  .command('update')
+  .description('Update RBIN Task Flow in current directory')
+  .option('-p, --path <path>', 'Target directory (default: current directory)')
+  .action(async (options) => {
+    const targetPath = options.path || process.cwd();
+    await installInProject(targetPath, { update: true });
+  });
+
+program
+  .command('version-check')
+  .description('Check for model version updates')
+  .action(async () => {
+    await checkVersionUpdates();
+  });
+
+program
+  .command('info')
+  .description('Show information about RBIN Task Flow')
+  .action(() => {
+    console.log('\n' + chalk.cyan('╔════════════════════════════════════════════════════════════════╗'));
+    console.log(chalk.cyan('║') + '        ' + chalk.magenta('✨ RBIN Task Flow ✨') + '                           ' + chalk.cyan('║'));
+    console.log(chalk.cyan('╚════════════════════════════════════════════════════════════════╝') + '\n');
+    console.log(chalk.blue('AI-powered task management for Claude, Cursor, and Gemini'));
+    console.log(chalk.yellow('\nVersion:'), require('../package.json').version);
+    console.log(chalk.yellow('Repository:'), 'https://github.com/rubensdeoliveira/rbin-task-flow');
+    console.log(chalk.yellow('\nCommands:'));
+    console.log(chalk.cyan('  rbin-task-flow init') + '         - Initialize in current directory');
+    console.log(chalk.cyan('  rbin-task-flow update') + '       - Update configurations');
+    console.log(chalk.cyan('  rbin-task-flow version-check') + ' - Check for model updates');
+    console.log(chalk.cyan('  rbin-task-flow info') + '         - Show this information\n');
+  });
+
+program.parse();