rbin-task-flow 1.23.0 → 1.23.1

package/.cursor/rules/graphify-task-flow.mdc

@@ -8,7 +8,7 @@ alwaysApply: false
   - **Do not compete:** Task Flow rules (`task_work`, `task-flow-sync`, `rbin-git-policy`, etc.) always win for workflow, git, and status files.
 
 - **When to use Graphify:**
-  - **`task-flow: run` / `run next X`:** Before implementing a subtask in a non-trivial codebase, if `graphify-out/graph.json` exists, use `graphify query "<feature or module from subtask>"` or read `graphify-out/GRAPH_REPORT.md` god nodes — then implement. If no graph exists, proceed with normal search or suggest `graphify extract .`.
+  - **`task-flow: run` / `run next X`:** Before implementing a subtask in a non-trivial codebase, if `graphify-out/graph.json` exists, use `graphify query "<feature or module from subtask>"` or read `graphify-out/GRAPH_REPORT.md` god nodes — then implement. If no graph exists, proceed with normal search or suggest `graphify extract . --backend claude-cli` (or `rbin-task-flow init --graphify`).
   - **`task-flow: think`:** Optional `graphify query` for gap analysis on large repos.
   - **`task-flow: review X`:** Optional `graphify affected "<symbol>"` to verify impact surface.
   - **`task-flow: audit`:** Graphify is structural only; scoring uses [coding_standards.mdc](mdc:.cursor/rules/coding_standards.mdc) checklist. Deep dive: sections of [coding-standards-full.md](mdc:.task-flow/docs/coding-standards-full.md) only if user asks for depth.
@@ -23,7 +23,7 @@ alwaysApply: false
   - RBIN Task Flow init sets upstream `graphify.mdc` to `alwaysApply: false` to save context.
 
 - **CLI (project root):**
-  - Build graph: `graphify extract .` (re-run after large refactors).
+  - Build graph: `graphify extract . --backend claude-cli` or `rbin-task-flow init --graphify` (re-run after large refactors).
   - Query: `graphify query "question"` · `graphify affected "node"`.
   - Guide: [.task-flow/GRAPHIFY.md](mdc:.task-flow/GRAPHIFY.md)
 

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

@@ -70,7 +70,7 @@ Com o [Graphify](https://pypi.org/project/graphifyyy/) instalado (`rbin-install-
 - Regra **`.cursor/rules/graphify-task-flow.mdc`** — só quando `task-flow: run`, `think`, `review`, etc. precisam navegar o código (`alwaysApply: false`).
 - **`graphify-out/`** no `.gitignore`.
 - Rebaixa **`graphify.mdc`** upstream para `alwaysApply: false` se existir.
-- **`rbin-task-flow init --graphify`** — roda `graphify extract .` após o init.
+- **`rbin-task-flow init --graphify`** — roda `graphify extract . --backend claude-cli` após o init.
 
 Guia completo: [GRAPHIFY.md](GRAPHIFY.md).
 

package/.task-flow/GRAPHIFY.md

@@ -31,7 +31,7 @@ Graphify ([graphifyy](https://pypi.org/project/graphifyyy/)) cria um **grafo de
 1. Copia **`.cursor/rules/graphify-task-flow.mdc`** — `alwaysApply: false` (não compete com `task_work`, etc.).
 2. Adiciona **`graphify-out/`** ao `.gitignore`.
 3. Se existir **`.cursor/rules/graphify.mdc`** do `graphify cursor install` (upstream com `alwaysApply: true`), o instalador **desativa** `alwaysApply` para economizar contexto.
-4. Com **`--graphify`** em `init`, `update` ou **`reset`**, roda `graphify extract .` se o CLI estiver no PATH.
+4. Com **`--graphify`** em `init`, `update` ou **`reset`**, roda `graphify extract . --backend claude-cli` se o CLI estiver no PATH (usa assinatura Claude Code — sem API key separada).
 
 **Não** rodamos `graphify claude install` / `graphify cursor install` automaticamente — o install upstream força `graphify.mdc` always-on e incham `CLAUDE.md` / `AGENTS.md`.
 
@@ -87,9 +87,9 @@ task-flow: run next 2 — se graphify-out existir, graphify query "<módulo da s
 
 | Evento | Ação |
 |--------|------|
-| Primeiro setup | `graphify extract .` ou `rbin-task-flow init --graphify` |
+| Primeiro setup | `rbin-task-flow init --graphify` ou `graphify extract . --backend claude-cli` |
 | Reset completo (tasks + template + grafo) | `rbin-task-flow reset --graphify` |
-| Refactor grande após vários `run` | `graphify update .` ou `graphify extract .` |
+| Refactor grande após vários `run` | `graphify update .` ou `graphify extract . --backend claude-cli` |
 | `task-flow: update` | Reaplica `graphify-task-flow.mdc` e pode rebaixar `graphify.mdc` |
 
 ---
@@ -101,7 +101,8 @@ task-flow: run next 2 — se graphify-out existir, graphify query "<módulo da s
 | IA ignora `task-flow:` | Graphify não é a causa — verifique rules Task Flow |
 | Contexto cheio no Cursor | Confirme `graphify.mdc` não está `alwaysApply: true` |
 | `graphify: command not found` | Rode `rbin-install-dev` (módulo Graphify) |
-| Grafo desatualizado | `graphify extract .` de novo |
+| `no LLM API key found` ao rodar `graphify extract .` manual | Use `rbin-task-flow init --graphify` (roda `--backend claude-cli`) ou exporte uma API key / `--backend ollama` |
+| Grafo desatualizado | `graphify extract . --backend claude-cli` de novo |
 
 ---
 

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

@@ -259,7 +259,7 @@ Cursor também pode ler `AGENTS.md` em alguns fluxos; no RBIN ele é focado em *
 | `rbin-task-flow init` | Copia rules + task-flow |
 | `rbin-task-flow update` | Atualiza rules; preserva `.internal/` |
 | `rbin-task-flow reset` | Recria `.task-flow` do zero |
-| `rbin-task-flow reset --graphify` | Reset + `graphify extract .` |
+| `rbin-task-flow reset --graphify` | Reset + `graphify extract . --backend claude-cli` |
 | `rbin-task-flow audit` | Lista arquivos **unstaged** (não substitui `task-flow: improve changes`) |
 
 O Agent executa o workflow; o CLI prepara arquivos.

package/README.md

@@ -33,7 +33,7 @@
 <a id="português"></a>
 # 🇧🇷 Português
 
-> **v1.23.0** — Menos tokens no Cursor (2 regras always-on, checklist de standards, skills). De **1.22**: `npm install -g rbin-task-flow@1.23` e `rbin-task-flow update`. [CHANGELOG](CHANGELOG.md) · [Publicação](RELEASE-1.23.0.md).
+> **v1.23.1** — Graphify `--graphify` usa `claude-cli` por padrão (sem API key extra). De **1.23.0**: `npm install -g rbin-task-flow@1.23.1` e `rbin-task-flow update`. [CHANGELOG](CHANGELOG.md) · [Publicação](RELEASE-1.23.1.md).
 
 ## O Que É Este Projeto?
 
@@ -77,7 +77,7 @@ rbin-task-flow init --share-ai-config  # Versiona .cursor/skills/ e .cursor/rule
 rbin-task-flow update        # Atualiza configurações (mantém profile em install-meta.json)
 rbin-task-flow update --profile standard  # Passa a copiar todas as regras .mdc
 rbin-task-flow reset         # Reinstala o Task Flow do zero
-rbin-task-flow reset --graphify  # Reset + graphify extract (CLI Graphify no PATH)
+rbin-task-flow reset --graphify  # Reset + graphify extract --backend claude-cli (CLI Graphify no PATH)
 rbin-task-flow version-check # Verifica atualizações de modelos
 rbin-task-flow info          # Mostra informações
 rbin-task-flow check         # Roda lint/fix e build quando existirem
@@ -91,7 +91,7 @@ Após inicializar, use estes comandos na IA (Cursor/Claude/Codex) para gerenciar
 
 **Otimizar por plataforma:** [.task-flow/AI-PLATFORMS.md](.task-flow/AI-PLATFORMS.md) · [Claude](.task-flow/platforms/claude-code.md) · [Cursor](.task-flow/platforms/cursor.md) · [Codex](.task-flow/platforms/codex.md) · [Graphify](.task-flow/GRAPHIFY.md)
 
-**Graphify (opcional):** `rbin-task-flow init --graphify` configura coexistência e pode rodar `graphify extract` (CLI via `rbin-install-dev`).
+**Graphify (opcional):** `rbin-task-flow init --graphify` configura coexistência e roda `graphify extract . --backend claude-cli` (CLI via `rbin-install-dev`; usa assinatura Claude Code).
 
 **Claude Code / Cursor skills (v1.20+):** `init` copia 14 skills para `.claude/skills/` e `.cursor/skills/` — use `/task-flow-sync`, `/task-flow-run`, etc.
 
@@ -418,7 +418,7 @@ Para problemas ou perguntas:
 <a id="english"></a>
 # 🇬🇧 English
 
-> **v1.23.0** — Lower Cursor token use (2 always-on rules, standards checklist, skills). From **1.22**: `npm install -g rbin-task-flow@1.23` then `rbin-task-flow update`. [CHANGELOG](CHANGELOG.md) · [Release guide](RELEASE-1.23.0.md).
+> **v1.23.1** — Graphify `--graphify` defaults to `claude-cli` (no separate API key). From **1.23.0**: `npm install -g rbin-task-flow@1.23.1` then `rbin-task-flow update`. [CHANGELOG](CHANGELOG.md) · [Release guide](RELEASE-1.23.1.md).
 
 ## What Is This Project?
 
@@ -462,7 +462,7 @@ rbin-task-flow init --share-ai-config  # Commit .cursor/skills and rules with th
 rbin-task-flow update        # Update configs (keeps profile from .task-flow/install-meta.json)
 rbin-task-flow update --profile standard  # Install all .cursor/rules/*.mdc
 rbin-task-flow reset         # Reinstall Task Flow from scratch
-rbin-task-flow reset --graphify  # Reset + graphify extract (Graphify CLI on PATH)
+rbin-task-flow reset --graphify  # Reset + graphify extract --backend claude-cli (Graphify CLI on PATH)
 rbin-task-flow version-check # Check for model updates
 rbin-task-flow info          # Show information
 rbin-task-flow check         # Run lint/fix and build when available
@@ -476,7 +476,7 @@ After initializing, use these commands in your AI (Cursor/Claude/Codex) to autom
 
 **Per-platform optimization:** [index](.task-flow/AI-PLATFORMS.md) · [Claude](.task-flow/platforms/claude-code.md) · [Cursor](.task-flow/platforms/cursor.md) · [Codex](.task-flow/platforms/codex.md) · [Graphify](.task-flow/GRAPHIFY.md)
 
-**Graphify (optional):** `rbin-task-flow init --graphify` — cooperative setup + optional `graphify extract` (CLI from `rbin-install-dev`).
+**Graphify (optional):** `rbin-task-flow init --graphify` — cooperative setup + runs `graphify extract . --backend claude-cli` (CLI from `rbin-install-dev`; uses Claude Code subscription).
 
 **Claude / Cursor skills (v1.20+):** installs 14 skills — use `/task-flow-sync`, `/task-flow-run`, etc.
 

package/bin/cli.js

@@ -21,7 +21,7 @@ function addInstallCommand(name, description, extra = {}) {
     .command(name)
     .description(description)
     .option('-p, --path <path>', 'Target directory (default: current directory)')
-    .option('-g, --graphify', 'Run graphify extract after install (requires graphify CLI)')
+    .option('-g, --graphify', 'Run graphify extract . --backend claude-cli after install (requires graphify CLI)')
     .option(
       '--profile <profile>',
       'Cursor rules: minimal (2 always-on + skills) or standard (all rules); update without flag keeps .task-flow/install-meta.json'
@@ -112,10 +112,10 @@ program
     console.log(chalk.cyan('  rbin-task-flow init') + '         - Initialize in current directory');
     console.log(chalk.cyan('  rbin-task-flow init --profile minimal') + ' - Low-token install (2 always-on rules + skills)');
     console.log(chalk.cyan('  rbin-task-flow init --share-ai-config') + ' - Version .cursor/skills and rules in git');
-    console.log(chalk.cyan('  rbin-task-flow init --graphify') + ' - Init + graphify extract (if CLI installed)');
+    console.log(chalk.cyan('  rbin-task-flow init --graphify') + ' - Init + graphify extract --backend claude-cli (if CLI installed)');
     console.log(chalk.cyan('  rbin-task-flow update') + '       - Update configurations');
     console.log(chalk.cyan('  rbin-task-flow reset') + '        - Reset task flow files from scratch');
-    console.log(chalk.cyan('  rbin-task-flow reset --graphify') + ' - Reset + graphify extract (if CLI installed)');
+    console.log(chalk.cyan('  rbin-task-flow reset --graphify') + ' - Reset + graphify extract --backend claude-cli (if CLI installed)');
     console.log(chalk.cyan('  rbin-task-flow version-check') + ' - Check for model updates');
     console.log(chalk.cyan('  rbin-task-flow estimate <ids>') + ' - Estimate time (e.g., "1" or "1,2" or "all")');
     console.log(chalk.cyan('  rbin-task-flow report <ids>') + '  - Generate report (e.g., "1" or "1,2" or "all")');

package/lib/graphify.js

@@ -5,6 +5,8 @@ const { showSuccess, showWarning, showInfo } = require('./utils');
 
 const GRAPHIFY_OUT = 'graphify-out/';
 const UPSTREAM_GRAPHIFY_RULE = 'graphify.mdc';
+const GRAPHIFY_EXTRACT_CMD = 'graphify extract . --backend claude-cli';
+const GRAPHIFY_EXTRACT_ARGS = ['extract', '.', '--backend', 'claude-cli'];
 
 function graphifyCliAvailable() {
   const result = spawnSync('graphify', ['--help'], {
@@ -70,15 +72,15 @@ function runGraphifyExtract(targetPath) {
     return false;
   }
 
-  showInfo('Running graphify extract (may take a few minutes)...');
-  const result = spawnSync('graphify', ['extract', '.'], {
+  showInfo(`Running ${GRAPHIFY_EXTRACT_CMD} (may take a few minutes)...`);
+  const result = spawnSync('graphify', GRAPHIFY_EXTRACT_ARGS, {
     cwd: targetPath,
     encoding: 'utf8',
     stdio: 'inherit',
   });
 
   if (result.status !== 0) {
-    showWarning('graphify extract failed — you can run it later: graphify extract .');
+    showWarning(`graphify extract failed — you can run it later: ${GRAPHIFY_EXTRACT_CMD}`);
     return false;
   }
 
@@ -102,7 +104,7 @@ async function setupGraphifyIntegration(targetPath, options = {}) {
   } else if (graphifyCliAvailable()) {
     const graphJson = path.join(targetPath, 'graphify-out', 'graph.json');
     if (!fs.existsSync(graphJson)) {
-      showInfo('Graphify CLI detected — run: graphify extract .  (or: rbin-task-flow init --graphify)');
+      showInfo(`Graphify CLI detected — run: ${GRAPHIFY_EXTRACT_CMD}  (or: rbin-task-flow init --graphify)`);
     }
   }
 
@@ -115,4 +117,6 @@ module.exports = {
   ensureGraphifyGitignore,
   runGraphifyExtract,
   graphifyCliAvailable,
+  GRAPHIFY_EXTRACT_CMD,
+  GRAPHIFY_EXTRACT_ARGS,
 };

package/lib/utils.js

@@ -78,7 +78,7 @@ function showNextSteps(targetPath) {
   console.log(chalk.blue('  3.'), 'Run:', chalk.cyan('task-flow: run next X'), chalk.gray('· @task-flow-run'));
   console.log(chalk.blue('  4.'), 'Check status:', chalk.cyan('task-flow: status'));
   console.log(chalk.blue('  5.'), 'Codex:', chalk.gray('AGENTS.md + .task-flow/CODEX.md on demand'));
-  console.log(chalk.blue('  6.'), 'Optional Graphify:', chalk.yellow('graphify extract .'), chalk.gray('— .task-flow/GRAPHIFY.md'));
+  console.log(chalk.blue('  6.'), 'Optional Graphify:', chalk.yellow('rbin-task-flow init --graphify'), chalk.gray('— .task-flow/GRAPHIFY.md'));
   console.log(chalk.cyan('═'.repeat(60)));
   console.log(chalk.blue('\n  See'), chalk.yellow('.task-flow/README.md'), chalk.blue('for all available commands\n'));
 }

package/package.json

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