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

package/scripts/doctor.js

@@ -1,48 +1,89 @@
-const fs = require('fs-extra');
-const path = require('path');
-const chalk = require('chalk');
-
-module.exports = async function doctor() {
-    const projectDir = process.cwd();
-    const errors = [];
-
-    console.log(chalk.blue('Running health check for AI Flow Kit...\n'));
-
-    // Check .claude directory
-    if (!(await fs.pathExists(path.join(projectDir, '.claude', 'skills')))) {
-        errors.push("Missing `.claude/skills` directory. Did you run `aiflow init`?");
-    } else {
-        console.log(chalk.green('✓ .claude/skills exists'));
-    }
-
-    // Check .rules directory
-    if (!(await fs.pathExists(path.join(projectDir, '.rules')))) {
-        errors.push("Missing `.rules` directory.");
-    } else {
-        console.log(chalk.green('✓ .rules exists'));
-    }
-
-    // Check CLAUDE.md template
-    if (!(await fs.pathExists(path.join(projectDir, 'CLAUDE.md')))) {
-        errors.push("Missing CLAUDE.md. Prompt AI Context is not set up.");
-    } else {
-        console.log(chalk.green('✓ CLAUDE.md exists'));
-    }
-
-    // Check .aiflow hidden state
-    const stateFile = path.join(projectDir, '.aiflow', 'state.json');
-    if (!(await fs.pathExists(stateFile))) {
-        errors.push("Missing `.aiflow/state.json`. Version tracking is broken.");
-    } else {
-        const state = await fs.readJson(stateFile);
-        console.log(chalk.green(`✓ Version tracking active (v${state.current_version})`));
-    }
-
-    if (errors.length > 0) {
-        console.log(chalk.red('\nIssues found:'));
-        errors.forEach(e => console.log(chalk.red(` - ${e}`)));
-        console.log(chalk.yellow('\nTry running `aiflow init` or `aiflow update` to fix these files.'));
-    } else {
-        console.log(chalk.green('\n✨ Everything looks healthy! You are ready to fly.'));
-    }
-};
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const { detectRtk, isRtkHookConfigured } = require('./init');
+
+module.exports = async function doctor() {
+    const projectDir = process.cwd();
+    const errors = [];
+    const warnings = [];
+
+    console.log(chalk.blue('Running health check for AI Flow Kit...\n'));
+
+    // ── Core setup ─────────────────────────────────────────────
+    if (!(await fs.pathExists(path.join(projectDir, '.claude', 'skills')))) {
+        errors.push('Missing `.claude/skills` directory. Did you run `aiflow init`?');
+    } else {
+        console.log(chalk.green('✓ .claude/skills exists'));
+    }
+
+    if (!(await fs.pathExists(path.join(projectDir, '.rules')))) {
+        errors.push('Missing `.rules` directory.');
+    } else {
+        console.log(chalk.green('✓ .rules exists'));
+    }
+
+    if (!(await fs.pathExists(path.join(projectDir, 'CLAUDE.md')))) {
+        errors.push('Missing CLAUDE.md. AI context prompt is not set up.');
+    } else {
+        console.log(chalk.green('✓ CLAUDE.md exists'));
+    }
+
+    // ── Version tracking ───────────────────────────────────────
+    const stateFile = path.join(projectDir, '.aiflow', 'state.json');
+    if (!(await fs.pathExists(stateFile))) {
+        errors.push('Missing `.aiflow/state.json`. Version tracking is broken.');
+    } else {
+        const state = await fs.readJson(stateFile);
+        console.log(chalk.green(`✓ Version tracking active (v${state.current_version})`));
+    }
+
+    // ── SessionStart hook ──────────────────────────────────────
+    const settingsPath = path.join(projectDir, '.claude', 'settings.json');
+    if (await fs.pathExists(settingsPath)) {
+        const settings = await fs.readJson(settingsPath).catch(() => ({}));
+        const hookList = settings?.hooks?.SessionStart || [];
+        const hasSessionHook = hookList.some(h =>
+            (h.hooks || []).some(e => typeof e.command === 'string' && e.command.includes('session-start'))
+        );
+        if (hasSessionHook) {
+            console.log(chalk.green('✓ SessionStart hook configured'));
+        } else {
+            warnings.push('SessionStart hook not found in .claude/settings.json — run `aiflow init` to set it up.');
+        }
+    } else {
+        warnings.push('Missing .claude/settings.json — run `aiflow init`.');
+    }
+
+    // ── RTK token compression ──────────────────────────────────
+    console.log('');
+    const rtk = await detectRtk();
+    if (rtk.installed) {
+        const hookOk = await isRtkHookConfigured(projectDir);
+        if (hookOk) {
+            console.log(chalk.green(`✓ RTK installed (${rtk.version}) — token compression active`));
+        } else {
+            console.log(chalk.green(`✓ RTK installed (${rtk.version})`));
+            warnings.push('RTK is installed but hook not configured. Run `aiflow init` to enable token compression.');
+        }
+    } else {
+        console.log(chalk.gray('○ RTK not installed (optional) — token compression inactive'));
+        console.log(chalk.gray('  Install: cargo install rtk  |  More: https://github.com/rtk-ai/rtk'));
+    }
+
+    // ── Summary ────────────────────────────────────────────────
+    console.log('');
+    if (warnings.length > 0) {
+        console.log(chalk.yellow('Warnings:'));
+        warnings.forEach(w => console.log(chalk.yellow(`  ⚠ ${w}`)));
+        console.log('');
+    }
+
+    if (errors.length > 0) {
+        console.log(chalk.red('Issues found:'));
+        errors.forEach(e => console.log(chalk.red(`  ✗ ${e}`)));
+        console.log(chalk.yellow('\nTry running `aiflow init` or `aiflow update` to fix these files.'));
+    } else {
+        console.log(chalk.green('✨ Everything looks healthy! You are ready to fly.'));
+    }
+};

package/scripts/guide.js

@@ -113,17 +113,17 @@ function showWorkflow() {
 
     // Step 2: Load context
     console.log(chalk.bold.white('  Step 2 — Load context from ticket (per task)'));
-    console.log(chalk.green('    aiflow use PROJ-33 --with-comments'));
-    console.log(chalk.green('    aiflow prompt bug-fix'));
+    console.log(chalk.green('    aiflow use PROJ-33') + chalk.gray('           # Fast Mode (Default)'));
+    console.log(chalk.green('    aiflow use PROJ-33 --full') + chalk.gray('    # Full Mode (Optional)'));
     console.log(chalk.green('    claude'));
     console.log();
 
     // Gate workflow
     console.log(chalk.bold.white('  Step 3 — AI runs Strict Gate Workflow automatically'));
     console.log();
-    console.log(chalk.yellow('    ⛩️  GATE 1') + chalk.gray(' — AI checks ticket for all 4 required components'));
-    console.log(chalk.gray('                  If missing → ask one by one until complete'));
-    console.log(chalk.gray('                  Developer types "continue" → move to Gate 2'));
+    console.log(chalk.yellow('    ⛩️  GATE 1') + chalk.gray(' — AI checks requirement and solution approach'));
+    console.log(chalk.gray('                  Fast Mode (Default): Minimal Q&A, target < 5 min'));
+    console.log(chalk.gray('                  Developer reviews requirement.md → "APPROVED"'));
     console.log();
     console.log(chalk.yellow('    ⛩️  GATE 2') + chalk.gray(' — AI generates detailed spec + plan'));
     console.log(chalk.gray('                  Developer reviews each section'));
@@ -158,8 +158,12 @@ function showCommands() {
             group: 'Setup',
             items: [
                 ['aiflow init', '--framework <fw> --adapter <ad>', 'Initialize project'],
+                ['aiflow init', '--env <tools>', 'AI tools: cursor,gemini,copilot'],
+                ['aiflow init', '--with-rtk | --no-rtk', 'Enable/disable RTK compression'],
                 ['aiflow doctor', '', 'Check setup health'],
+                ['aiflow doctor', '--verbose', 'Detailed health check output'],
                 ['aiflow update', '', 'Update to the latest version'],
+                ['aiflow update', '--force', 'Force update even if already latest'],
                 ['aiflow remove', '', 'Remove ai-flow-kit from project'],
                 ['aiflow remove', '--version <ver>', 'Remove a cached version'],
                 ['aiflow remove', '--global', 'Uninstall global package'],
@@ -169,16 +173,33 @@ function showCommands() {
             group: 'Workflow (use per task)',
             items: [
                 ['aiflow use <TICKET-ID>', '', 'Load context from Backlog/Jira'],
+                ['aiflow use', '--fast', 'Fast Mode: minimal Q&A (Default)'],
+                ['aiflow use', '--full', 'Full Mode: deep analysis with Q&A'],
+                ['aiflow use', '--file <path>', 'Load from local text/json file'],
                 ['aiflow use', '--manual', 'Enter context manually'],
                 ['aiflow use', '--with-comments', 'Include all comments'],
                 ['aiflow use', '--comments-last <n>', 'Only get last N comments'],
+                ['aiflow use', '--comments-from <n>', 'Get comments from index N onward'],
                 ['aiflow prompt <type>', '', 'Generate AI prompt'],
                 ['aiflow prompt', '--list', 'View all prompt types'],
                 ['aiflow prompt', '--output <file>', 'Save prompt to file'],
                 ['aiflow prompt', '--lang vietnamese', 'Prompt in Vietnamese'],
+                ['aiflow prompt', '--detail <level>', 'Detail: minimal|standard|comprehensive'],
                 ['aiflow detect "<description>"', '', 'Auto-detect task type'],
             ]
         },
+        {
+            group: 'Task management',
+            items: [
+                ['aiflow task status', '', 'Show active and pending tasks'],
+                ['aiflow task list', '', 'List all saved tasks'],
+                ['aiflow task pause', '--note <text>', 'Pause current task and save progress'],
+                ['aiflow task switch <id>', '', 'Pause current and switch to another'],
+                ['aiflow task resume <id>', '', 'Resume a paused task'],
+                ['aiflow task reset <id>', '', 'Reset task to Gate 1 (keeps context)'],
+                ['aiflow task remove <id>', '', 'Permanently delete all task data'],
+            ]
+        },
         {
             group: 'Context management',
             items: [
@@ -206,6 +227,7 @@ function showCommands() {
             items: [
                 ['aiflow validate <file>', '', 'Validate code against team rules'],
                 ['aiflow validate <file>', '--fix', 'Auto-fix trailing whitespace'],
+                ['aiflow validate <file>', '--verbose', 'Detailed validation report'],
                 ['aiflow validate <file>', '-r lenient', 'Only report critical errors'],
                 ['aiflow validate <file>', '-r strict', 'Report all warnings'],
             ]
@@ -224,6 +246,7 @@ function showCommands() {
             items: [
                 ['aiflow gate <n> start', '--ticket <id>', 'Log gate N started (AI calls this)'],
                 ['aiflow gate <n> approved', '--ticket <id>', 'Log gate N approved (AI calls this)'],
+                ['aiflow gate <n> start', '--ai-tool <tool>', 'Specify AI tool name'],
             ]
         },
         {

package/scripts/hooks/session-start.js

@@ -3,29 +3,28 @@
  * SessionStart hook for ai-flow-kit
  * Injects:
  *   1. using-superpowers skill content
- *   2. Active ticket context + gate workflow (if context exists)
- * Cross-platform replacement for the bash session-start hook.
+ *   2. Active ticket context + gate-aware workflow instruction
  */
 
 const fs = require('fs');
 const path = require('path');
 const { record } = require('../telemetry/record');
 
-// Record session start telemetry
 record('session.start');
 
 // This script lives at .claude/hooks/session-start.js
-// Project root is 2 levels up from __dirname (.claude/hooks → .claude → project root)
+// Project root is 2 levels up: .claude/hooks → .claude → project root
 const projectRoot = path.resolve(__dirname, '..', '..');
-const skillPath = path.join(projectRoot, '.claude', 'skills', 'using-superpowers', 'SKILL.md');
+const skillPath   = path.join(projectRoot, '.claude', 'skills', 'using-superpowers', 'SKILL.md');
 const contextPath = path.join(projectRoot, '.aiflow', 'context', 'current.json');
+const tasksDir    = path.join(projectRoot, '.aiflow', 'tasks');
 
 // ── 1. Load superpowers skill ──────────────────────────────────
 let skillContent = '';
 try {
     skillContent = fs.readFileSync(skillPath, 'utf-8');
 } catch (_) {
-    // Skill file missing — continue without it
+    process.stderr.write('[aiflow] WARNING: using-superpowers skill missing — run `aiflow update`\n');
 }
 
 // ── 2. Load active ticket context ──────────────────────────────
@@ -34,7 +33,8 @@ try {
     if (fs.existsSync(contextPath)) {
         const ctx = JSON.parse(fs.readFileSync(contextPath, 'utf-8'));
         if (ctx.taskId && ctx.title) {
-            contextBlock = buildContextPrompt(ctx);
+            const taskState = loadTaskState(ctx.taskId);
+            contextBlock = buildContextPrompt(ctx, taskState);
         }
     }
 } catch (_) {
@@ -54,7 +54,6 @@ if (contextBlock) {
 
 const combined = parts.join('\n\n');
 
-// Escape for JSON string embedding
 const escaped = combined
     .replace(/\\/g, '\\\\')
     .replace(/"/g, '\\"')
@@ -71,15 +70,23 @@ process.stdout.write(JSON.stringify({
 
 process.exit(0);
 
-// ── Helper ─────────────────────────────────────────────────────
+// ── Helpers ────────────────────────────────────────────────────
 
-function buildContextPrompt(ctx) {
-    const taskType = ctx.taskType || 'feature';
+function loadTaskState(taskId) {
+    try {
+        const statePath = path.join(tasksDir, taskId, 'task-state.json');
+        if (fs.existsSync(statePath)) {
+            return JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+        }
+    } catch (_) {}
+    return null;
+}
 
+function buildContextPrompt(ctx, taskState) {
     const lines = [];
     lines.push('<ACTIVE_TASK>');
     lines.push(`**Active Ticket:** ${ctx.taskId} — ${ctx.title}`);
-    lines.push(`**Type:** ${taskType}`);
+    lines.push(`**Type:** ${ctx.taskType || 'feature'}`);
     lines.push(`**Status:** ${ctx.status || 'Unknown'}`);
     lines.push(`**Assignee:** ${ctx.assignee || 'Unknown'}`);
     lines.push('');
@@ -92,54 +99,146 @@ function buildContextPrompt(ctx) {
 
     if (ctx.acceptanceCriteria && ctx.acceptanceCriteria.length > 0) {
         lines.push('**Acceptance Criteria:**');
-        for (const c of ctx.acceptanceCriteria) {
-            lines.push(`- ${c}`);
-        }
+        for (const c of ctx.acceptanceCriteria) lines.push(`- ${c}`);
         lines.push('');
     }
 
     if (ctx.comments && ctx.comments.length > 0) {
         lines.push(`**Comments (${ctx.comments.length}):**`);
-        // Include last 5 comments to keep context manageable
         const recent = ctx.comments.slice(-5);
-        for (const c of recent) {
-            lines.push(c);
-            lines.push('');
-        }
+        for (const c of recent) { lines.push(c); lines.push(''); }
     }
 
     if (ctx.context && ctx.context.files && ctx.context.files.length > 0) {
         lines.push('**Related Files:**');
-        for (const f of ctx.context.files) {
-            lines.push(`- \`${f}\``);
-        }
+        for (const f of ctx.context.files) lines.push(`- \`${f}\``);
         lines.push('');
     }
 
-    // ── Gate workflow instruction ──
     lines.push('---');
     lines.push('');
-    lines.push('**AUTO-START GATE 1: You MUST begin analyzing this ticket immediately.**');
-    lines.push('');
-    lines.push(`INVOKE the \`read-study-requirement\` skill NOW for ticket ${ctx.taskId}.`);
-    lines.push('');
-    lines.push('Gate 1 process:');
-    lines.push('1. Read the ticket context above');
-    lines.push('2. Read CLAUDE.md — understand project architecture and conventions');
-    lines.push('3. Read source code — identify related files, data flow, patterns');
-    lines.push('4. If anything is unclear — ask ONE question at a time');
-    lines.push('5. Output plan/' + ctx.taskId + '/requirement.md with:');
-    lines.push('   - Requirements summary');
-    lines.push('   - Source code analysis');
-    lines.push('   - Proposed solution and approach');
-    lines.push('   - Impact analysis');
-    lines.push('   - Effort estimate');
-    lines.push('   - Testing plan');
-    lines.push('6. Display GATE 1 prompt and wait for APPROVED');
-    lines.push('');
-    lines.push('DO NOT wait for the developer to ask. START NOW.');
-    lines.push('If you have not started automatically, begin as soon as the developer types **"start"**.');
-    lines.push('</ACTIVE_TASK>');
 
+    // ── Gate-aware instruction ──────────────────────────────────
+    const mode = ctx.mode || 'fast';
+    const currentGate = taskState && taskState.currentGate ? taskState.currentGate : 1;
+    const isResume    = taskState && taskState.pausedAt;
+
+    if (isResume && currentGate > 1) {
+        // Resuming a paused task — inject resume context
+        const gateApprovals = taskState.gateApprovals || {};
+        lines.push(`**RESUMING TASK: ${ctx.taskId} — Gate ${currentGate}**`);
+        lines.push('');
+        lines.push('This task was previously paused and is now being resumed.');
+        lines.push('');
+        lines.push('**Gate Progress:**');
+        for (let g = 1; g < currentGate; g++) {
+            const approvedAt = gateApprovals[String(g)];
+            const stamp = approvedAt ? ` — approved ${approvedAt}` : ' — approved';
+            lines.push(`- Gate ${g}: ✅ APPROVED${stamp}`);
+        }
+        lines.push(`- Gate ${currentGate}: 🔄 IN PROGRESS`);
+        lines.push('');
+        lines.push(`**DO NOT restart from Gate 1.** Resume directly at Gate ${currentGate} (${gateLabel(currentGate)}).`);
+        lines.push('');
+
+        if (currentGate === 2) {
+            lines.push('Gate 1 is already APPROVED. The requirement document is at:');
+            lines.push(`  plan/${ctx.taskId}/requirement.md`);
+            lines.push('');
+            lines.push('Proceed to Gate 2: create the implementation plan.');
+            lines.push(buildModeInstruction(mode, 2));
+        } else if (currentGate === 3) {
+            lines.push('Gates 1 and 2 are already APPROVED. Plans are at:');
+            lines.push(`  plan/${ctx.taskId}/requirement.md`);
+            lines.push(`  plan/${ctx.taskId}/plan.md`);
+            lines.push('');
+            lines.push('Proceed to Gate 3: implement code following the plan (TDD).');
+            lines.push(buildModeInstruction(mode, 3));
+        } else if (currentGate === 4) {
+            lines.push('Gates 1–3 are APPROVED. Code has been implemented.');
+            lines.push('Proceed to Gate 4: run verification + impact-analysis + review checklist.');
+            lines.push(buildModeInstruction(mode, 4));
+        } else if (currentGate === 5) {
+            lines.push('Gates 1–4 are APPROVED. Self-review is done.');
+            lines.push('Proceed to Gate 5: guide the developer to create a Pull Request.');
+        }
+        if (taskState.notes) {
+            lines.push('');
+            lines.push(`**Note from developer:** ${taskState.notes}`);
+        }
+    } else {
+        // Fresh task — auto-start Gate 1
+        lines.push('**AUTO-START GATE 1: You MUST begin analyzing this ticket immediately.**');
+        lines.push('');
+        lines.push(`INVOKE the \`read-study-requirement\` skill NOW for ticket ${ctx.taskId}.`);
+        lines.push('');
+
+        if (mode === 'fast') {
+            lines.push('**MODE: fast** — Use the FAST TRACK path in the skill:');
+            lines.push('- Read ticket + identify changed files only (no deep source scan)');
+            lines.push('- Skip Q&A unless there is a critical blocking ambiguity');
+            lines.push('- Output a lite requirement doc (Sections 1, 3, 5 only)');
+            lines.push('- Target: Gate 1 complete in < 5 minutes');
+        } else {
+            lines.push('Gate 1 process:');
+            lines.push('1. Read the ticket context above');
+            lines.push('2. Read CLAUDE.md — understand project architecture and conventions');
+            lines.push('3. Read source code — identify related files, data flow, patterns');
+            lines.push('4. If anything is unclear — ask ONE question at a time');
+            lines.push('5. Output plan/' + ctx.taskId + '/requirement.md');
+            lines.push('6. Display GATE 1 prompt and wait for APPROVED');
+        }
+
+        lines.push('');
+        lines.push('DO NOT wait for the developer to ask. START NOW.');
+        lines.push('If you have not started automatically, begin as soon as the developer types **"start"**.');
+    }
+
+    lines.push('</ACTIVE_TASK>');
     return lines.join('\n');
 }
+
+function gateLabel(n) {
+    const labels = {
+        1: 'AI Analyze Requirement',
+        2: 'Implementation Plan',
+        3: 'Code Generation',
+        4: 'AI Self-Review',
+        5: 'Peer Review & PR',
+    };
+    return labels[n] || `Gate ${n}`;
+}
+
+function buildModeInstruction(mode, gate) {
+    if (mode !== 'fast') return ''; // full mode: không inject gì thêm, AI chạy đầy đủ các bước
+
+    const instructions = {
+        2: [
+            '**MODE: fast** — Gate 2 fast track:',
+            '- Create a simple task list (task-level, NOT step-level)',
+            '- DO NOT invoke `superpowers:writing-plans`',
+            '- Format: numbered list of tasks, each with file + action',
+            '- No code snippets, no step-by-step TDD breakdown required',
+        ],
+        3: [
+            '**MODE: fast** — Gate 3 fast track:',
+            '- DO NOT use `superpowers:subagent-driven-development`',
+            '- DO NOT spawn Spec Reviewer or Code Quality Reviewer subagents',
+            '- Implement ALL tasks directly in this session',
+            '- Write tests and implementation in the same pass per task',
+            '- Run the test suite ONCE at the end of all tasks (not after each step)',
+            '- If tests fail: fix inline, do not spawn a subagent',
+        ],
+        4: [
+            '**MODE: fast** — Gate 4 fast track:',
+            '- Run the full test suite — this is MANDATORY',
+            '- Impact Analysis: quick scan only — reason from git diff and changed files.',
+            '  DO NOT grep the entire codebase. List affected files and assess impact level.',
+            '- Review checklist (3 items only): tests pass ✅, no hardcoded secrets ✅, no SQL injection ✅',
+            '- summary.md: short format (Implementation table + Test result only)',
+        ],
+    };
+
+    const lines = instructions[gate];
+    return lines ? '\n' + lines.join('\n') : '';
+}