@relipa/ai-flow-kit 0.0.8 → 0.0.9-beta.0

package/scripts/hooks/session-start.js

@@ -1,274 +1,295 @@
-#!/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. Check GitNexus background indexing status ───────────────
-const GITNEXUS_STALE_MS = 3 * 60 * 60 * 1000; // 3 hours
-const gitNexusStatusPath = path.join(projectRoot, '.aiflow', 'gitnexus-status.json');
-try {
-    if (fs.existsSync(gitNexusStatusPath)) {
-        const gn = JSON.parse(fs.readFileSync(gitNexusStatusPath, 'utf-8'));
-        if (!gn.notified) {
-            // Detect stale "running" — process was killed without updating status
-            if (gn.status === 'running' && gn.startedAt) {
-                const age = Date.now() - new Date(gn.startedAt).getTime();
-                if (age > GITNEXUS_STALE_MS) {
-                    gn.status = 'error';
-                    gn.error = 'timed out — process may have been killed or ran out of memory';
-                }
-            }
-            if (gn.status === 'done') {
-                process.stderr.write('[aiflow] ✓ GitNexus indexing complete — code intelligence tools are ready.\n');
-            } else if (gn.status === 'error') {
-                const detail = gn.error ? ` (${gn.error})` : gn.exitCode != null ? ` (exit ${gn.exitCode})` : '';
-                process.stderr.write(`[aiflow] ✗ GitNexus indexing failed${detail}.\n`);
-                // process.stderr.write('[aiflow]   Retry: aiflow init --with-gitnexus\n');
-            }
-            if (gn.status === 'done' || gn.status === 'error') {
-                gn.notified = true;
-                fs.writeFileSync(gitNexusStatusPath, JSON.stringify(gn, null, 2));
-            }
-        }
-    }
-} catch (_) {}
-
-// ── 4. 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:',
-            '- INVOKE `tdd-lean` skill (NOT superpowers:test-driven-development)',
-            '- tdd-lean uses Batch Red-Green-Refactor: 2–3 test runs total, never per-test',
-            '- Test Output Discipline: keep only summary line after each run, discard stack traces',
-            '- DO NOT use `superpowers:subagent-driven-development`',
-            '- DO NOT spawn Spec Reviewer or Code Quality Reviewer subagents',
-            '- Call `aiflow checkpoint` at each milestone (tests-written, code-done, tests-pass)',
-        ],
-        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 os = require('os');
+
+function loadTelemetry() {
+    try { return require('../telemetry/record'); } catch (_) { }
+    return { record: () => { } };
+}
+
+function loadTelemetryConfig() {
+    try { return require('../telemetry/config'); } catch (_) { }
+    return { loadConfig: () => ({}) };
+}
+
+const { record } = loadTelemetry();
+const { loadConfig } = loadTelemetryConfig();
+
+// ── Paths (set once stdin is read) ────────────────────────────
+let tasksDir = '';
+
+let raw = '';
+process.stdin.setEncoding('utf-8');
+process.stdin.on('data', chunk => { raw += chunk; });
+process.stdin.on('end', () => {
+    let hookData = {};
+    try { hookData = JSON.parse(raw || '{}'); } catch (_) { }
+
+    const sessionModel = hookData.model || '';
+    const cfg = loadConfig();
+
+    record('session.start', {
+        ai_tool: 'claude',
+        model: sessionModel || undefined,
+        ai_email: cfg.email || '',
+    });
+
+    // 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');
+    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 (_) { }
+
+    // ── 3. Check GitNexus background indexing status ───────────────
+    const GITNEXUS_STALE_MS = 3 * 60 * 60 * 1000;
+    const gitNexusStatusPath = path.join(projectRoot, '.aiflow', 'gitnexus-status.json');
+    try {
+        if (fs.existsSync(gitNexusStatusPath)) {
+            const gn = JSON.parse(fs.readFileSync(gitNexusStatusPath, 'utf-8'));
+            if (!gn.notified) {
+                if (gn.status === 'running' && gn.startedAt) {
+                    const age = Date.now() - new Date(gn.startedAt).getTime();
+                    if (age > GITNEXUS_STALE_MS) {
+                        gn.status = 'error';
+                        gn.error = 'timed out — process may have been killed or ran out of memory';
+                    }
+                }
+                if (gn.status === 'done') {
+                    process.stderr.write('[aiflow] ✓ GitNexus indexing complete — code intelligence tools are ready.\n');
+                } else if (gn.status === 'error') {
+                    const detail = gn.error ? ` (${gn.error})` : gn.exitCode != null ? ` (exit ${gn.exitCode})` : '';
+                    process.stderr.write(`[aiflow] ✗ GitNexus indexing failed${detail}.\n`);
+                }
+                if (gn.status === 'done' || gn.status === 'error') {
+                    gn.notified = true;
+                    fs.writeFileSync(gitNexusStatusPath, JSON.stringify(gn, null, 2));
+                }
+            }
+        }
+    } catch (_) { }
+
+    // ── 4. 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('');
+
+    const mode = ctx.mode || 'fast';
+    const currentGate = taskState && taskState.currentGate ? taskState.currentGate : 1;
+    const isResume = taskState && (taskState.pausedAt || taskState.currentGate > 1);
+
+    if (isResume && currentGate > 1) {
+        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 {
+        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 '';
+
+    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:',
+            '- INVOKE `tdd-lean` skill (NOT superpowers:test-driven-development)',
+            '- tdd-lean uses Batch Red-Green-Refactor: 2–3 test runs total, never per-test',
+            '- Test Output Discipline: keep only summary line after each run, discard stack traces',
+            '- DO NOT use `superpowers:subagent-driven-development`',
+            '- DO NOT spawn Spec Reviewer or Code Quality Reviewer subagents',
+            '- Call `aiflow checkpoint` at each milestone (tests-written, code-done, tests-pass)',
+        ],
+        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') : '';
+}