@relipa/ai-flow-kit 0.0.6-beta.0 → 0.0.7-beta.0

package/README.md

@@ -23,11 +23,11 @@ Developers only need a single command to load ticket context → AI automaticall
 > [!TIP]
 > After running `aiflow init`, documentation files are automatically copied to `.aiflow/docs/` in your project for easy access.
 
-- **[Quick Start Guide](https://gitlab.relipa.vn/ai/ai-flow-kit/-/blob/main/docs/common/QUICK_START.md)** — Step-by-step instructions for developers.
-- **[Full Workflow (5 Gates)](https://gitlab.relipa.vn/ai/ai-flow-kit/-/blob/main/docs/common/AIFLOW.md)** — In-depth look at the Gate process.
-- **[Troubleshooting](https://gitlab.relipa.vn/ai/ai-flow-kit/-/blob/main/docs/common/troubleshooting.md)** — Common issues and fixes.
-- **[Integration Guide](https://gitlab.relipa.vn/ai/ai-flow-kit/-/blob/main/docs/common/ai-integration.md)** — Advanced tool setup (Claude, Cursor, Gemini).
-- **[Changelog](https://gitlab.relipa.vn/ai/ai-flow-kit/-/blob/main/docs/common/CHANGELOG.md)** — Version history and release notes.
+- **[Quick Start Guide](https://github.com/example/ai-flow-kit/blob/main/docs/common/QUICK_START.md)** — Step-by-step instructions for developers.
+- **[Full Workflow (5 Gates)](https://github.com/example/ai-flow-kit/blob/main/docs/common/AIFLOW.md)** — In-depth look at the Gate process.
+- **[Troubleshooting](https://github.com/example/ai-flow-kit/blob/main/docs/common/troubleshooting.md)** — Common issues and fixes.
+- **[Integration Guide](https://github.com/example/ai-flow-kit/blob/main/docs/common/ai-integration.md)** — Advanced tool setup (Claude, Cursor, Gemini).
+- **[Changelog](https://github.com/example/ai-flow-kit/blob/main/docs/common/CHANGELOG.md)** — Version history and release notes.
 
 ---
 
@@ -52,7 +52,7 @@ PM writes ticket on Backlog/Jira
         ▼
 ⛩️ GATE 3 — Code Generation (TDD)           [AI]
   AI writes tests first → implement → tests pass
-  Commit each small step
+  Verify implementation works
         │ Code done
         ▼
 ⛩️ GATE 4 — AI Self-Review                  [AI + DEV]
@@ -74,13 +74,13 @@ PM writes ticket on Backlog/Jira
 
 ```bash
 # Stable version
-npm install -g @relipa/ai-flow-kit
+npm install -g ai-flow-kit
 
 # Beta version (recommend for newest features)
-npm install -g @relipa/ai-flow-kit@beta
+npm install -g ai-flow-kit@beta
 
 # Uninstall
-npm uninstall -g @relipa/ai-flow-kit
+npm uninstall -g ai-flow-kit
 ```
 
 ---
@@ -93,6 +93,7 @@ npm uninstall -g @relipa/ai-flow-kit
 | `aiflow use <ticket>` | Load ticket context (Backlog/Jira). |
 | `aiflow task` | Manage multiple tasks — pause, switch, resume. |
 | `aiflow prompt` | Generate tool-optimized prompts (`--env cursor`). |
+| `aiflow sync-skills` | Manually synchronize AI Instruction files with local custom skills. |
 | `aiflow telemetry` | Manage telemetry tracking (enable/disable/status). |
 | `aiflow guide` | View integrated multi-AI integration guide. |
 
@@ -104,8 +105,10 @@ Initial setup for the project. Run once per project.
 # Single framework + adapter
 aiflow init --framework spring-boot --adapter backlog
 
-# Force enable RTK token compression
-aiflow init --with-rtk
+# Enable token savings tools
+aiflow init --with-rtk                     # RTK: compress bash outputs (60–90% reduction)
+# aiflow init --with-gitnexus               # GitNexus: code intelligence (waits for index)
+# aiflow init --with-gitnexus --no-wait     # GitNexus: index in background
 
 # Multiple frameworks and adapters
 aiflow init --framework spring-boot,reactjs --adapter backlog,jira
@@ -126,6 +129,21 @@ aiflow init --framework spring-boot,reactjs --adapter backlog,jira
 
 ---
 
+### `aiflow sync-skills`
+
+Synchronize AI instruction files (`CLAUDE.md`, `GEMINI.md`, etc.) and Skills without upgrading the package version. 
+
+```bash
+aiflow sync-skills
+```
+
+**Features:**
+- Intelligent marker-based updates (`<!-- aiflow-kit-start -->`)
+- Confirmation prompts before overwriting custom rules
+- English notifications and status reports
+
+---
+
 ### `aiflow use <ticket>`
 
 Load ticket context into `.aiflow/context/current.json`.
@@ -179,6 +197,8 @@ aiflow task switch PROJ-99          # pause current + switch to another task
 aiflow task resume PROJ-33          # resume a paused task (restores context + gate state)
 aiflow task reset  PROJ-33          # reset to Gate 1 (keeps ticket context, clears progress)
 aiflow task remove PROJ-33          # permanently delete all saved data for the task
+aiflow task next                    # approve current gate + prepare for fresh session
+aiflow task next --ticket PROJ-33   # same, but specify ticket explicitly
 ```
 
 **Use case — switching tasks mid-flow:**
@@ -337,7 +357,7 @@ ai-flow-kit/
 
 **Custom skill:** create `custom/skills/<name>/SKILL.md`
 
-Then run `aiflow update` to apply.
+Then run `aiflow update` or `aiflow sync-skills` to apply.
 
 ---
 
@@ -355,7 +375,7 @@ Then run `aiflow update` to apply.
 
 **`aiflow` not found:**
 ```bash
-npm install -g @relipa/ai-flow-kit
+npm install -g ai-flow-kit
 ```
 
 **Backlog load fails:**

package/bin/aiflow.js

@@ -16,6 +16,7 @@ const removeCommand   = require('../scripts/remove');
 const guideCommand    = require('../scripts/guide');
 const telemetryCommand= require('../scripts/telemetry/cli');
 const taskCommand     = require('../scripts/task');
+const checkpointCommand = require('../scripts/checkpoint');
 const { record }      = require('../scripts/telemetry/record');
 
 program
@@ -63,6 +64,8 @@ program
     .option('-e, --env <types>', 'AI environment(s)/tool(s), comma-separated (e.g. cursor,gemini,copilot)')
     .option('--with-rtk', 'force enable RTK token compression hook')
     .option('--no-rtk', 'skip RTK setup even if RTK is detected')
+    // .option('--with-gitnexus', 'enable GitNexus code intelligence (indexes in background)')
+    // .option('--wait', 'wait for GitNexus indexing to complete before exiting')
     .action((options) => {
         options.frameworks = options.framework
             ? options.framework.split(',').map(s => s.trim()).filter(Boolean)
@@ -162,6 +165,15 @@ taskCmd
     .description('Permanently delete all saved data for a task')
     .action((ticketId) => { record('command.invoked', { command: 'task.remove' }); taskCommand('remove', { taskId: ticketId }); });
 
+taskCmd
+    .command('next')
+    .description('Approve current gate and prepare next session (saves state for resume)')
+    .option('-t, --ticket <id>', 'ticket ID (defaults to active task)')
+    .action((opts) => {
+        record('command.invoked', { command: 'task.next' });
+        taskCommand('next', { taskId: opts.ticket });
+    });
+
 // ── context ───────────────────────────────────────────────────
 program
     .command('context [action]')
@@ -176,6 +188,19 @@ program
         contextCommand(action, options);
     });
 
+// ── checkpoint ────────────────────────────────────────────────
+program
+    .command('checkpoint')
+    .description('Record token usage checkpoint (called by AI during gate work)')
+    .requiredOption('--gate <n>', 'gate number (1–5)', parseInt)
+    .requiredOption('--step <name>', 'step name (e.g. "tests-written")')
+    .requiredOption('--tokens <n>', 'estimated token count', parseInt)
+    .option('-t, --ticket <id>', 'ticket ID (defaults to active task)')
+    .action((opts) => {
+        record('command.invoked', { command: 'checkpoint' });
+        checkpointCommand({ gate: opts.gate, step: opts.step, tokens: opts.tokens, ticket: opts.ticket });
+    });
+
 // ── validate ──────────────────────────────────────────────────
 program
     .command('validate <file>')
@@ -276,14 +301,45 @@ program
         updateCommand(options);
     });
 
+// ── sync-skills ───────────────────────────────────────────────
+program
+    .command('sync-skills')
+    .description('Manually synchronize AI Instruction files with local custom skills')
+    .action(async () => {
+        record('command.invoked', { command: 'sync-skills' });
+        const projectDir = process.cwd();
+        const { setupFramework, AI_TOOL_FILES, ensureAiflowGitignored } = require('../scripts/init');
+        const fs = require('fs-extra');
+        const path = require('path');
+        const chalk = require('chalk');
+
+        const stateFile = path.join(projectDir, '.aiflow', 'state.json');
+        if (!(await fs.pathExists(stateFile))) {
+            console.log(chalk.red('Project is not initialized. Please run `aiflow init` first.'));
+            return;
+        }
+
+        const state = await fs.readJson(stateFile);
+        const frameworks = state.frameworks || [];
+        const selectedTools = state.aiTools || Object.keys(AI_TOOL_FILES);
+
+        console.log(chalk.cyan('⟳ Syncing AI Instruction files...'));
+        for (const fw of frameworks) {
+            await setupFramework(projectDir, fw, frameworks.length > 1, selectedTools);
+        }
+        await ensureAiflowGitignored(projectDir);
+        console.log(chalk.green('✨ Sync completed!'));
+    });
+
 // ── doctor ────────────────────────────────────────────────────
 program
     .command('doctor')
     .description('Health check of AI Flow Kit setup')
+    .option('-t, --ticket <id>', 'show token breakdown for specific ticket')
     .option('-v, --verbose', 'detailed output')
-    .action(() => {
+    .action((opts) => {
         record('command.invoked', { command: 'doctor' });
-        doctorCommand();
+        doctorCommand({ ticket: opts.ticket, verbose: opts.verbose });
     });
 
 // ── telemetry ──────────────────────────────────────────────────

package/custom/mcp-presets/gitnexus.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "gitnexus": {
+      "command": "npx",
+      "args": ["-y", "gitnexus@latest", "mcp"]
+    }
+  }
+}