rbin-task-flow 1.30.1 → 1.30.3

package/.task-flow/guides/AI-PLATFORMS.md

@@ -59,7 +59,7 @@ Detalhes dos comandos: [README.md](../README.md).
 | `.claude/skills/` | ✅ (11 skills) | — | — |
 | `.cursor/skills/` | — | ✅ (espelho) | — |
 
-Por padrão, `.claude/`, `.cursor/`, `.task-flow/`, `CLAUDE.md` e `AGENTS.md` entram no **`.gitignore`** do projeto cliente. Para versionar skills/regras com o time, ajuste o ignore — veja a seção “Versionamento” em cada guia.
+Por padrão, **`.task-flow`** é acrescentado ao final do **`.gitignore`** do projeto cliente.
 
 ---
 

package/.task-flow/guides/CURSOR.md

@@ -13,7 +13,7 @@ Verify: `rg 'alwaysApply: true' .cursor/rules` → only the two files above.
 
 **Install profiles:** `rbin-task-flow init --profile minimal` → 2 always-on rules + skills only; `standard` (default) → all `.mdc` rules. Saved in `.task-flow/install-meta.json`.
 
-**Team git:** `init --share-ai-config` → `.cursor/skills/` and `.cursor/rules/` not gitignored (default ignores all `.cursor/`).
+**Team git:** `.task-flow` appended to `.gitignore`; other AI config files can be committed.
 
 ---
 

package/.task-flow/guides/platforms/cursor.md

@@ -248,20 +248,9 @@ O Agent executa o workflow (`task-flow: audit`, `task-flow: run`, etc.); o CLI p
 
 ---
 
-## 11. `.gitignore` discreto vs time
+## 11. `.gitignore` no projeto
 
-**Padrão:** `rbin-task-flow init` ignora `.cursor/` inteiro (skills e rules ficam locais).
-
-**Time:** `rbin-task-flow init --share-ai-config` — **não** ignora `.cursor/skills/` nem `.cursor/rules/`; ignora só `.cursor/settings.json` e `*.local.mdc`. O bloco no `.gitignore` explica o trade-off **tokens vs consistência do time**.
-
-| Estratégia | Comando | Prós | Contras |
-|------------|---------|------|---------|
-| Local (padrão) | `init` | Repo limpo; cada dev com setup próprio | Sem sync de rules/skills |
-| Time | `init --share-ai-config` | Mesmo Task Flow para todos | Mais arquivos de IA no git; tokens por dev ao usar rules |
-
-`reset` sem flag reaplica a opção salva em `.task-flow/install-meta.json` (`shareAiConfig`).
-
-Para open source: documente no README — contribuidores podem usar `--share-ai-config` ou `init` local.
+**Padrão:** `init` / `reset` acrescentam `.task-flow` ao final do `.gitignore`.
 
 ---
 

package/README.md

@@ -33,7 +33,7 @@
 <a id="português"></a>
 # 🇧🇷 Português
 
-> **v1.30.1** — `reset --keep-tasks`, sem comando `update`, subtarefas `manual` em `dev-logs/`. `npm install -g rbin-task-flow@1.30.1` e `rbin-task-flow reset --keep-tasks`. [CHANGELOG](CHANGELOG.md) · [Publicação](RELEASE-1.30.1.md).
+> **v1.30.3** — `.gitignore`: só `.task-flow` no final, sem comentários. `npm install -g rbin-task-flow@1.30.3` e `rbin-task-flow reset --keep-tasks`. [CHANGELOG](CHANGELOG.md) · [Publicação](RELEASE-1.30.3.md).
 
 ## O Que É Este Projeto?
 
@@ -102,7 +102,7 @@ Após inicializar, use estes comandos na IA (Cursor/Claude/Codex) para gerenciar
 
 **Perfil minimal:** `init --profile minimal` instala só as 2 regras always-on e as 11 skills; workflows via `@task-flow-*` (sem `task_work`, `coding_standards` glob, etc.). `standard` (padrão) copia todas as regras `.cursor/rules/`.
 
-**Compartilhar com o time:** `init --share-ai-config` não ignora `.cursor/skills/` nem `.cursor/rules/` no `.gitignore` (só `.cursor/settings.json` e overrides locais). Padrão: `.cursor/` inteiro ignorado — menos ruído no repo, config local por dev.
+**Compartilhar com o time:** `.cursor/`, `CLAUDE.md` e `AGENTS.md` já podem ir no git; só `.task-flow/` fica ignorado (tasks e progresso locais). Flag `--share-ai-config` grava preferência em `install-meta.json`.
 
 | Comando | Por Que Usar | Feature Principal |
 |---------|--------------|-------------------|
@@ -146,7 +146,7 @@ Repositório centralizado de configurações e regras de desenvolvimento que pod
 - **Instalação Global NPM** - Instale uma vez, use em qualquer lugar com `npm install -g rbin-task-flow`
 - **Gerenciamento Simples de Tarefas** - Defina tarefas em texto simples, a IA gera subtarefas detalhadas
 - **Múltiplos Modelos de IA** - Claude Code Sonnet configurado e pronto para uso
-- **.gitignore Discreto** - Configurações de IA ocultas com comentários genéricos
+- **.gitignore mínimo** - Só `.task-flow/` ignorado; `.cursor/` e instruções versionáveis no git
 - **Zero Configuração** - Pronto para usar imediatamente
 - **RBIN Task Flow** - Gerenciamento de tarefas alimentado por IA com interface de texto simples
 
@@ -248,23 +248,14 @@ Gerenciamento de tarefas simples e poderoso:
 - **Rastreamento Simples**: Gerenciamento de status baseado em JSON com comandos CLI fáceis
 - **Monitoramento de Progresso**: Feedback visual claro sobre a conclusão das tarefas
 
-## .gitignore Discreto
+## .gitignore
 
-O instalador adiciona estas entradas ao `.gitignore`:
+O instalador adiciona `.task-flow` ao final do `.gitignore`:
 
 ```gitignore
-.claude/
-.cursor/
-.task-flow/
-CLAUDE.md
+.task-flow
 ```
 
-**Por que discreto?**
-- Sem comentários explicando o que são
-- Sem menção a "IA", "Claude" ou "Anthropic"
-- Tudo relacionado ao RBIN Task Flow permanece local
-- Histórico git limpo sem arquivos de ferramentas de IA
-
 ## Atualizando Projetos
 
 Para atualizar configurações em um projeto existente:
@@ -343,9 +334,7 @@ Lista cada `.cursor/rules/*.mdc` (bytes, linhas, `alwaysApply`), soma always-on
 - ⚠️ Este é um **repositório template** - não use RBIN Task Flow aqui
 - ✅ Use RBIN Task Flow em **projetos que recebem** as configurações via instalação
 - 🔄 O instalador **sempre sobrescreve** configurações existentes
-- 🤫 As entradas do .gitignore são **discretas** (sem menções a IA)
-- 🎯 Funciona com **Claude Code CLI** ou **Cursor Pro**
-- 📦 O diretório Task Flow (`.task-flow/`) é **automaticamente gitignored**
+- 📦 Apenas `.task-flow/` é **gitignored** (tasks e progresso locais)
 - 📝 Defina tarefas em `.task-flow/tasks.input.txt` usando formato simples: `- Descrição da tarefa`
 - 🚀 **Instalação Global NPM**: `npm install -g rbin-task-flow`, depois use `rbin-task-flow init` em qualquer projeto
 - 🔒 **Chaves de API podem ser necessárias** - depende do seu provedor de IA (Claude Code ou Cursor Pro)
@@ -423,7 +412,7 @@ Para problemas ou perguntas:
 <a id="english"></a>
 # 🇬🇧 English
 
-> **v1.30.1** — `reset --keep-tasks`, no `update` CLI, `manual` subtasks in `dev-logs/`. `npm install -g rbin-task-flow@1.30.1` then `rbin-task-flow reset --keep-tasks`. [CHANGELOG](CHANGELOG.md) · [Release guide](RELEASE-1.30.1.md).
+> **v1.30.3** — `.gitignore`: append `.task-flow` only, no comments. `npm install -g rbin-task-flow@1.30.3` then `rbin-task-flow reset --keep-tasks`. [CHANGELOG](CHANGELOG.md) · [Release guide](RELEASE-1.30.3.md).
 
 ## What Is This Project?
 
@@ -492,7 +481,7 @@ After initializing, use these commands in your AI (Cursor/Claude/Codex) to autom
 
 **Minimal profile:** `init --profile minimal` copies only `task-flow-cursor.mdc` and `rbin-git-policy.mdc` plus skills; use `@task-flow-*` for workflows. `standard` (default) copies all rules under `.cursor/rules/`.
 
-**Share with team:** `init --share-ai-config` leaves `.cursor/skills/` and `.cursor/rules/` out of `.gitignore` (see comment block in `.gitignore` for token vs team trade-off). Default ignores all of `.cursor/`.
+**Share with team:** `.cursor/`, `CLAUDE.md`, and `AGENTS.md` can be committed; only `.task-flow/` is gitignored (local tasks and progress). `--share-ai-config` saves preference in `install-meta.json`.
 
 | Command | Why Use It | Key Feature |
 |---------|------------|-------------|
@@ -536,7 +525,7 @@ A centralized repository of development configurations and rules that can be ins
 - **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 configured and ready to use
-- **Discrete .gitignore** - AI configs hidden with generic comments
+- **Minimal .gitignore** - Only `.task-flow/` ignored; `.cursor/` and instruction files committable
 - **Zero Configuration** - Ready to use immediately
 - **RBIN Task Flow** - AI-powered task management with simple text interface
 
@@ -638,23 +627,14 @@ Simple yet powerful task management:
 - **Simple Tracking**: JSON-based status management with easy CLI commands
 - **Progress Monitoring**: Clear visual feedback on task completion
 
-## Discrete .gitignore
+## .gitignore
 
-The installer adds these entries to `.gitignore`:
+The installer appends `.task-flow` at the end of `.gitignore`:
 
 ```gitignore
-.claude/
-.cursor/
-.task-flow/
-CLAUDE.md
+.task-flow
 ```
 
-**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:
@@ -733,9 +713,7 @@ Prints each `.cursor/rules/*.mdc` (bytes, lines, `alwaysApply`), totals always-o
 - ⚠️ 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** or **Cursor Pro**
-- 📦 Task Flow directory (`.task-flow/`) is **automatically gitignored**
+- 📦 Only `.task-flow/` is **gitignored** (local tasks and progress)
 - 📝 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 or Cursor Pro)

package/bin/cli.js

@@ -26,7 +26,7 @@ function addInstallCommand(name, description, extra = {}) {
     )
     .option(
       '--share-ai-config',
-      'Do not gitignore .cursor/skills/ or .cursor/rules/ (team can commit shared AI config; see .gitignore comment)'
+      'Save team AI config preference in install-meta.json (appends .task-flow to .gitignore)'
     )
     .option(
       '--keep-tasks',

package/lib/gitignore.js

@@ -1,99 +1,68 @@
 const fs = require('fs-extra');
 const path = require('path');
 
-const MARKER_START = '# RBIN Task Flow (rbin-task-flow)';
-const MARKER_END = '# END RBIN Task Flow (rbin-task-flow)';
-
-const ENTRIES_DEFAULT = [
-  '.claude/',
-  '.cursor/',
-  '.task-flow/',
-  'CLAUDE.md',
-  'AGENTS.md',
-];
-
-const ENTRIES_SHARE_AI_CONFIG = [
-  '.claude/',
-  '.cursor/settings.json',
-  '.cursor/rules/*.local.mdc',
-  '.task-flow/',
-  'CLAUDE.md',
-  'AGENTS.md',
+const GITIGNORE_ENTRY = '.task-flow';
+
+const LEGACY_MARKER_START = '# RBIN Task Flow (rbin-task-flow)';
+const LEGACY_MARKER_END = '# END RBIN Task Flow (rbin-task-flow)';
+
+const STRIP_LINE_PATTERNS = [
+  /^\.task-flow\/?\s*$/m,
+  /^\.claude\/\s*$/m,
+  /^\.cursor\/\s*$/m,
+  /^CLAUDE\.md\s*$/m,
+  /^AGENTS\.md\s*$/m,
+  /^\.cursor\/settings\.json\s*$/m,
+  /^\.cursor\/rules\/\*\.local\.mdc\s*$/m,
+  /^graphify-out\/\s*$/m,
+  /^\.task-flow\/scripts\/tasks\.json\s*$/m,
+  /^\.task-flow\/scripts\/status\.json\s*$/m,
+  /^# RBIN Task Flow.*$/m,
+  /^# END RBIN Task Flow.*$/m,
+  /^# share-ai-config:.*$/m,
+  /^# Trade-off:.*$/m,
+  /^# Default \(no flag\):.*$/m,
+  /^# Only \.task-flow\/.*$/m,
+  /^# \.cursor\/.*$/m,
 ];
 
-const STRIP_PATTERNS = [
-  ...ENTRIES_DEFAULT,
-  ...ENTRIES_SHARE_AI_CONFIG,
-  MARKER_START,
-  MARKER_END,
-  '# share-ai-config:',
-  '# Trade-off:',
-  '# Default (no flag):',
-];
-
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function stripRbinGitignoreBlock(content) {
+function stripTaskFlowGitignoreLines(content) {
   let next = content;
 
   const blockRegex = new RegExp(
-    `\\n?${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}\\n?`,
+    `\\n?${LEGACY_MARKER_START.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${LEGACY_MARKER_END.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\n?`,
     'g'
   );
   next = next.replace(blockRegex, '\n');
 
-  for (const entry of STRIP_PATTERNS) {
-    const lineRegex = new RegExp(`^${escapeRegExp(entry)}\\s*$`, 'gm');
-    next = next.replace(lineRegex, '');
+  for (const pattern of STRIP_LINE_PATTERNS) {
+    next = next.replace(pattern, '');
   }
 
-  return next.replace(/\n{3,}/g, '\n\n');
+  return next.replace(/\n{3,}/g, '\n\n').replace(/\s+$/, '');
 }
 
-function buildRbinGitignoreBlock(shareAiConfig) {
-  const lines = ['', MARKER_START, ''];
-
-  if (shareAiConfig) {
-    lines.push(
-      '# share-ai-config: .cursor/skills/ and .cursor/rules/ are NOT ignored — commit them for team consistency.',
-      '# Trade-off: shared AI config improves workflow parity; each developer still pays token cost when the Agent loads rules/skills.',
-      '# Default (no flag): entire .cursor/ stays local and gitignored — lower repo noise, no team sync of rules.',
-      ''
-    );
-    lines.push(...ENTRIES_SHARE_AI_CONFIG);
-  } else {
-    lines.push(...ENTRIES_DEFAULT);
-  }
-
-  lines.push(MARKER_END, '');
-  return lines.join('\n');
+function appendTaskFlowEntry(content) {
+  const normalized = stripTaskFlowGitignoreLines(content);
+  const suffix = normalized.length > 0 ? '\n' : '';
+  return `${normalized}${suffix}${GITIGNORE_ENTRY}\n`;
 }
 
-async function updateGitignore(targetPath, { shareAiConfig = false } = {}) {
+async function updateGitignore(targetPath) {
   const gitignorePath = path.join(targetPath, '.gitignore');
 
   if (!fs.existsSync(gitignorePath)) {
-    await fs.writeFile(gitignorePath, '');
+    await fs.writeFile(gitignorePath, `${GITIGNORE_ENTRY}\n`);
+    return;
   }
 
-  let content = await fs.readFile(gitignorePath, 'utf8');
-  content = stripRbinGitignoreBlock(content);
-
-  if (!content.endsWith('\n')) {
-    content += '\n';
-  }
-
-  content += buildRbinGitignoreBlock(shareAiConfig);
-  await fs.writeFile(gitignorePath, content);
-
-  return { shareAiConfig };
+  const content = await fs.readFile(gitignorePath, 'utf8');
+  await fs.writeFile(gitignorePath, appendTaskFlowEntry(content));
 }
 
 module.exports = {
-  MARKER_START,
-  buildRbinGitignoreBlock,
-  stripRbinGitignoreBlock,
+  GITIGNORE_ENTRY,
+  stripTaskFlowGitignoreLines,
+  appendTaskFlowEntry,
   updateGitignore,
 };

package/lib/install.js

@@ -57,8 +57,8 @@ async function installInProject(targetPath, options = {}) {
   console.log(
     chalk.blue('🔗 Git:'),
     shareAiConfig
-      ? chalk.yellow('share-ai-config') + chalk.gray(' (.cursor/skills + .cursor/rules versionáveis)')
-      : chalk.gray('local .cursor/ gitignored (default)')
+      ? chalk.yellow('share-ai-config') + chalk.gray(' (flag saved in install-meta.json)')
+      : chalk.gray('appends .task-flow to .gitignore')
   );
   if (options.keepTasks) {
     console.log(
@@ -119,11 +119,9 @@ async function installInProject(targetPath, options = {}) {
 
     spinner.text = 'Updating .gitignore...';
 
-    await updateGitignore(targetPath, { shareAiConfig });
+    await updateGitignore(targetPath);
     showSuccess('.gitignore updated');
-    if (shareAiConfig) {
-      showInfo('Git: .cursor/skills/ and .cursor/rules/ can be committed (see .gitignore comment)');
-    }
+    showInfo('Git: appended .task-flow to .gitignore');
 
     spinner.text = 'Installing agent skills...';
     await copySkillsToProject(targetPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rbin-task-flow",
-  "version": "1.30.1",
+  "version": "1.30.3",
   "description": "AI-powered task management for Claude and Cursor",
   "main": "index.js",
   "bin": {