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

package/scripts/hooks/session-start.js

@@ -1,244 +1,244 @@
-#!/usr/bin/env node
-/**
- * SessionStart hook for ai-flow-kit
- * Injects:
- *   1. using-superpowers skill content
- *   2. Active ticket context + gate-aware workflow instruction
- */
-
-const fs = require('fs');
-const path = require('path');
-const { record } = require('../telemetry/record');
-
-record('session.start');
-
-// This script lives at .claude/hooks/session-start.js
-// 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 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 (_) {
-    process.stderr.write('[aiflow] WARNING: using-superpowers skill missing — run `aiflow update`\n');
-}
-
-// ── 2. Load active ticket context ──────────────────────────────
-let contextBlock = '';
-try {
-    if (fs.existsSync(contextPath)) {
-        const ctx = JSON.parse(fs.readFileSync(contextPath, 'utf-8'));
-        if (ctx.taskId && ctx.title) {
-            const taskState = loadTaskState(ctx.taskId);
-            contextBlock = buildContextPrompt(ctx, taskState);
-        }
-    }
-} catch (_) {
-    // Context missing or invalid — continue without it
-}
-
-// ── 3. Combine and output ──────────────────────────────────────
-const parts = [];
-
-if (skillContent) {
-    parts.push(`<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${skillContent}\n\n</EXTREMELY_IMPORTANT>`);
-}
-
-if (contextBlock) {
-    parts.push(contextBlock);
-}
-
-const combined = parts.join('\n\n');
-
-const escaped = combined
-    .replace(/\\/g, '\\\\')
-    .replace(/"/g, '\\"')
-    .replace(/\n/g, '\\n')
-    .replace(/\r/g, '\\r')
-    .replace(/\t/g, '\\t');
-
-process.stdout.write(JSON.stringify({
-    hookSpecificOutput: {
-        hookEventName: 'SessionStart',
-        additionalContext: escaped
-    }
-}));
-
-process.exit(0);
-
-// ── Helpers ────────────────────────────────────────────────────
-
-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:** ${ctx.taskType || 'feature'}`);
-    lines.push(`**Status:** ${ctx.status || 'Unknown'}`);
-    lines.push(`**Assignee:** ${ctx.assignee || 'Unknown'}`);
-    lines.push('');
-
-    if (ctx.description) {
-        lines.push('**Description:**');
-        lines.push(ctx.description.substring(0, 2000));
-        lines.push('');
-    }
-
-    if (ctx.acceptanceCriteria && ctx.acceptanceCriteria.length > 0) {
-        lines.push('**Acceptance Criteria:**');
-        for (const c of ctx.acceptanceCriteria) lines.push(`- ${c}`);
-        lines.push('');
-    }
-
-    if (ctx.comments && ctx.comments.length > 0) {
-        lines.push(`**Comments (${ctx.comments.length}):**`);
-        const recent = ctx.comments.slice(-5);
-        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}\``);
-        lines.push('');
-    }
-
-    lines.push('---');
-    lines.push('');
-
-    // ── 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') : '';
-}
+#!/usr/bin/env node
+/**
+ * SessionStart hook for ai-flow-kit
+ * Injects:
+ *   1. using-superpowers skill content
+ *   2. Active ticket context + gate-aware workflow instruction
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { record } = require('../telemetry/record');
+
+record('session.start');
+
+// This script lives at .claude/hooks/session-start.js
+// 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 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 (_) {
+    process.stderr.write('[aiflow] WARNING: using-superpowers skill missing — run `aiflow update`\n');
+}
+
+// ── 2. Load active ticket context ──────────────────────────────
+let contextBlock = '';
+try {
+    if (fs.existsSync(contextPath)) {
+        const ctx = JSON.parse(fs.readFileSync(contextPath, 'utf-8'));
+        if (ctx.taskId && ctx.title) {
+            const taskState = loadTaskState(ctx.taskId);
+            contextBlock = buildContextPrompt(ctx, taskState);
+        }
+    }
+} catch (_) {
+    // Context missing or invalid — continue without it
+}
+
+// ── 3. Combine and output ──────────────────────────────────────
+const parts = [];
+
+if (skillContent) {
+    parts.push(`<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${skillContent}\n\n</EXTREMELY_IMPORTANT>`);
+}
+
+if (contextBlock) {
+    parts.push(contextBlock);
+}
+
+const combined = parts.join('\n\n');
+
+const escaped = combined
+    .replace(/\\/g, '\\\\')
+    .replace(/"/g, '\\"')
+    .replace(/\n/g, '\\n')
+    .replace(/\r/g, '\\r')
+    .replace(/\t/g, '\\t');
+
+process.stdout.write(JSON.stringify({
+    hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        additionalContext: escaped
+    }
+}));
+
+process.exit(0);
+
+// ── Helpers ────────────────────────────────────────────────────
+
+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:** ${ctx.taskType || 'feature'}`);
+    lines.push(`**Status:** ${ctx.status || 'Unknown'}`);
+    lines.push(`**Assignee:** ${ctx.assignee || 'Unknown'}`);
+    lines.push('');
+
+    if (ctx.description) {
+        lines.push('**Description:**');
+        lines.push(ctx.description.substring(0, 2000));
+        lines.push('');
+    }
+
+    if (ctx.acceptanceCriteria && ctx.acceptanceCriteria.length > 0) {
+        lines.push('**Acceptance Criteria:**');
+        for (const c of ctx.acceptanceCriteria) lines.push(`- ${c}`);
+        lines.push('');
+    }
+
+    if (ctx.comments && ctx.comments.length > 0) {
+        lines.push(`**Comments (${ctx.comments.length}):**`);
+        const recent = ctx.comments.slice(-5);
+        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}\``);
+        lines.push('');
+    }
+
+    lines.push('---');
+    lines.push('');
+
+    // ── 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') : '';
+}