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

package/scripts/hooks/session-start.js

@@ -1,141 +1,145 @@
-#!/usr/bin/env node
-/**
- * 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.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// This script lives at .claude/hooks/session-start.js
-// Project root is 3 levels up
-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');
-
-// ── 1. Load superpowers skill ──────────────────────────────────
-let skillContent = '';
-try {
-    skillContent = fs.readFileSync(skillPath, 'utf-8');
-} catch (_) {
-    // Skill file missing — continue without it
-}
-
-// ── 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) {
-            contextBlock = buildContextPrompt(ctx);
-        }
-    }
-} 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');
-
-// Escape for JSON string embedding
-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);
-
-// ── Helper ─────────────────────────────────────────────────────
-
-function buildContextPrompt(ctx) {
-    const taskType = ctx.taskType || 'feature';
-
-    const lines = [];
-    lines.push('<ACTIVE_TASK>');
-    lines.push(`**Active Ticket:** ${ctx.taskId} — ${ctx.title}`);
-    lines.push(`**Type:** ${taskType}`);
-    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}):**`);
-        // Include last 5 comments to keep context manageable
-        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('');
-    }
-
-    // ── 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 \`validate-ticket\` 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>');
-
-    return lines.join('\n');
-}
+#!/usr/bin/env node
+/**
+ * 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.
+ */
+
+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)
+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');
+
+// ── 1. Load superpowers skill ──────────────────────────────────
+let skillContent = '';
+try {
+    skillContent = fs.readFileSync(skillPath, 'utf-8');
+} catch (_) {
+    // Skill file missing — continue without it
+}
+
+// ── 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) {
+            contextBlock = buildContextPrompt(ctx);
+        }
+    }
+} 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');
+
+// Escape for JSON string embedding
+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);
+
+// ── Helper ─────────────────────────────────────────────────────
+
+function buildContextPrompt(ctx) {
+    const taskType = ctx.taskType || 'feature';
+
+    const lines = [];
+    lines.push('<ACTIVE_TASK>');
+    lines.push(`**Active Ticket:** ${ctx.taskId} — ${ctx.title}`);
+    lines.push(`**Type:** ${taskType}`);
+    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}):**`);
+        // Include last 5 comments to keep context manageable
+        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('');
+    }
+
+    // ── 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>');
+
+    return lines.join('\n');
+}

package/scripts/init.js

@@ -1,9 +1,12 @@
 const fs = require('fs-extra');
 const path = require('path');
+const os = require('os');
 const chalk = require('chalk');
-const { input } = require('@inquirer/prompts');
+const { input, select, confirm } = require('@inquirer/prompts');
 
 const PKG_DIR = path.join(__dirname, '..');
+const GLOBAL_AIFLOW_DIR = path.join(os.homedir(), '.aiflow');
+const GLOBAL_CREDENTIALS_PATH = path.join(GLOBAL_AIFLOW_DIR, 'credentials.json');
 const PKG_VERSION = require('../package.json').version;
 
 // Map framework → language family for picking the right rules
@@ -20,36 +23,73 @@ const AI_TOOL_FILES = {
     'cursor':   '.cursorrules',
     'gemini':   'GEMINI.md',
     'copilot':  '.github/copilot-instructions.md',
-    'generic':  'AI_INSTRUCTIONS.md'
+    'generic':  '.aiflow/AI_INSTRUCTIONS.md'
 };
 
 /**
- * Copy documentation files and the docs/ folder to the project
+ * Copy only docs/common/ to .aiflow/docs in the project.
+ * Internal aiflow docs (changelog, architecture…) are never copied out.
  */
 async function copyDocsToProject(projectDir) {
-    const aiflowDocsDir = path.join(projectDir, '.aiflow', 'docs');
-    const srcDocsDir = path.join(PKG_DIR, 'docs');
-
-    // 1. Copy the entire docs/ folder to .aiflow/docs
-    if (await fs.pathExists(srcDocsDir)) {
-        await fs.ensureDir(aiflowDocsDir);
-        await fs.copy(srcDocsDir, aiflowDocsDir, { overwrite: true });
-        console.log(chalk.green(`✓ Documentation folder copied to .aiflow/docs`));
-    }
+    const srcCommonDir = path.join(PKG_DIR, 'docs', 'common');
+    if (!(await fs.pathExists(srcCommonDir))) return;
 
-    // 2. Copy key markdown files to project root for easy access
-    const keyFiles = ['QUICK_START.md', 'AIFLOW.md'];
-    for (const file of keyFiles) {
-        const srcPath = path.join(srcDocsDir, file);
-        const destPath = path.join(projectDir, file);
-        if (await fs.pathExists(srcPath)) {
-            // We overwrite these to ensure they are up to date with the installed version
-            await fs.copy(srcPath, destPath, { overwrite: true });
-            console.log(chalk.gray(`  ✓ ${file} updated in project root`));
-        }
+    const destDir = path.join(projectDir, '.aiflow', 'docs');
+    await fs.ensureDir(destDir);
+    await fs.copy(srcCommonDir, destDir, { overwrite: true });
+    console.log(chalk.green(`✓ Documentation copied to .aiflow/docs`));
+}
+
+/**
+ * Scan the project directory to guess the framework.
+ * Returns a framework key or null if undetected.
+ */
+async function detectFramework(projectDir) {
+    // JS / TS — check package.json dependencies
+    const pkgPath = path.join(projectDir, 'package.json');
+    if (await fs.pathExists(pkgPath)) {
+        const pkg = await fs.readJson(pkgPath).catch(() => ({}));
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        if (deps['next'])          return 'nextjs';
+        if (deps['nuxt'])          return 'vue-nuxt';
+        if (deps['vue'])           return 'vue-nuxt';
+        if (deps['@nestjs/core'])  return 'nodejs-express';
+        if (deps['react'])         return 'reactjs';
+        if (deps['express'] || deps['fastify']) return 'nodejs-express';
+    }
+    // Java — pom.xml / Gradle
+    if (await fs.pathExists(path.join(projectDir, 'pom.xml')))            return 'spring-boot';
+    if (await fs.pathExists(path.join(projectDir, 'build.gradle')))       return 'spring-boot';
+    if (await fs.pathExists(path.join(projectDir, 'build.gradle.kts')))   return 'spring-boot';
+    // PHP — composer.json
+    const composerPath = path.join(projectDir, 'composer.json');
+    if (await fs.pathExists(composerPath)) {
+        const composer = await fs.readJson(composerPath).catch(() => ({}));
+        if ((composer.require || {})['laravel/framework']) return 'laravel';
+    }
+    // Python
+    if (await fs.pathExists(path.join(projectDir, 'manage.py'))) return 'python-django';
+    const reqPath = path.join(projectDir, 'requirements.txt');
+    if (await fs.pathExists(reqPath)) {
+        const reqs = (await fs.readFile(reqPath, 'utf-8').catch(() => '')).toLowerCase();
+        if (reqs.includes('fastapi')) return 'python-fastapi';
+        if (reqs.includes('django'))  return 'python-django';
     }
+    return null;
 }
 
+const FRAMEWORK_CHOICES = [
+    { name: 'Spring Boot (Java)',  value: 'spring-boot' },
+    { name: 'React',               value: 'reactjs' },
+    { name: 'Next.js',             value: 'nextjs' },
+    { name: 'Vue / Nuxt',          value: 'vue-nuxt' },
+    { name: 'Laravel (PHP)',        value: 'laravel' },
+    { name: 'Node.js / Express',   value: 'nodejs-express' },
+    { name: 'Python Django',       value: 'python-django' },
+    { name: 'Python FastAPI',      value: 'python-fastapi' },
+    { name: 'Skip (no framework)', value: null },
+];
+
 async function copyAssetsToVersion(versionDir, framework) {
     // ── Skills: merge upstream + custom ──────────────────────────────
     const upstreamSkills = path.join(PKG_DIR, 'upstream', 'skills');
@@ -210,6 +250,9 @@ async function setupFramework(projectDir, framework, multi = false, selectedTool
     const separator = `\n\n---\n\n`;
     const skillRegistry = await generateSkillRegistry(projectDir);
 
+    const written = [];
+    const skipped = [];
+
     for (const tool of selectedTools) {
         const targetPath = path.join(projectDir, AI_TOOL_FILES[tool]);
         if (!targetPath) continue;
@@ -233,18 +276,51 @@ async function setupFramework(projectDir, framework, multi = false, selectedTool
 
         finalContent += frameworkContent;
 
+        const fileExists = await fs.pathExists(targetPath);
+
         if (!multi) {
+            if (fileExists) {
+                const relPath = path.relative(projectDir, targetPath).replace(/\\/g, '/');
+                const overwrite = await confirm({
+                    message: `  ${relPath} already exists — overwrite with aiflow template?`,
+                    default: false
+                });
+
+                if (!overwrite) {
+                    // Save aiflow template to .aiflow/reference/ so dev can compare/merge manually
+                    const refPath = path.join(projectDir, '.aiflow', 'reference', path.basename(targetPath));
+                    await fs.ensureDir(path.dirname(refPath));
+                    await fs.writeFile(refPath, finalContent);
+                    const refRel = path.relative(projectDir, refPath).replace(/\\/g, '/');
+                    skipped.push(relPath);
+                    console.log(chalk.gray(`    aiflow template saved to ${refRel} for reference`));
+                    continue;
+                }
+
+                // Backup existing file before overwriting
+                const backupPath = path.join(projectDir, '.aiflow', 'backup', path.basename(targetPath));
+                await fs.ensureDir(path.dirname(backupPath));
+                await fs.copy(targetPath, backupPath, { overwrite: true });
+                console.log(chalk.gray(`    Backed up ${relPath} → .aiflow/backup/${path.basename(targetPath)}`));
+            }
             await fs.writeFile(targetPath, finalContent);
+            written.push(AI_TOOL_FILES[tool]);
         } else {
-            if (await fs.pathExists(targetPath)) {
+            if (fileExists) {
                 await fs.appendFile(targetPath, separator + frameworkContent);
             } else {
                 await fs.writeFile(targetPath, finalContent);
             }
+            written.push(AI_TOOL_FILES[tool]);
         }
     }
 
-    console.log(chalk.green(`✓ AI instruction files updated for framework: ${framework} (${selectedTools.join(', ')})`));
+    if (written.length) {
+        console.log(chalk.green(`✓ AI instruction files updated for framework: ${framework} (${written.join(', ')})`));
+    }
+    if (skipped.length) {
+        console.log(chalk.yellow(`  Skipped (kept existing): ${skipped.join(', ')}`));
+    }
 }
 
 async function setupAdapter(projectDir, adapter) {
@@ -259,10 +335,10 @@ async function setupAdapter(projectDir, adapter) {
     const serverKey    = Object.keys(mcpServers)[0];
     const serverConfig = mcpServers[serverKey];
 
-    const credsFile = path.join(projectDir, '.aiflow', 'credentials.json');
     let existingCreds = {};
-    if (await fs.pathExists(credsFile)) {
-        existingCreds = await fs.readJson(credsFile).catch(() => ({}));
+    if (await fs.pathExists(GLOBAL_CREDENTIALS_PATH)) {
+        const globalData = await fs.readJson(GLOBAL_CREDENTIALS_PATH).catch(() => ({}));
+        existingCreds = globalData.mcp || {};
     }
 
     console.log(chalk.cyan(`\nSetup MCP adapter for ${adapter}:`));
@@ -321,8 +397,13 @@ async function setupAdapter(projectDir, adapter) {
         { spaces: 2 }
     );
 
-    Object.assign(existingCreds, credentials);
-    await fs.writeJson(credsFile, existingCreds, { spaces: 2 });
+    await fs.ensureDir(GLOBAL_AIFLOW_DIR);
+    let globalData = {};
+    if (await fs.pathExists(GLOBAL_CREDENTIALS_PATH)) {
+        globalData = await fs.readJson(GLOBAL_CREDENTIALS_PATH).catch(() => ({}));
+    }
+    globalData.mcp = { ...(globalData.mcp || {}), ...credentials };
+    await fs.writeJson(GLOBAL_CREDENTIALS_PATH, globalData, { spaces: 2 });
     await ensureCredentialsGitignored(projectDir);
 
     console.log(chalk.green(`✓ MCP configuration saved (global + local + credentials).`));
@@ -428,16 +509,26 @@ function verifyFigma(credentials) {
 
 async function ensureCredentialsGitignored(projectDir) {
     const gitignorePath = path.join(projectDir, '.gitignore');
-    const entry = '.aiflow/credentials.json';
+    const entries = ['.aiflow/no-telemetry'];
     let content = '';
     if (await fs.pathExists(gitignorePath)) {
         content = await fs.readFile(gitignorePath, 'utf-8');
     }
     const lines = content.split('\n').map(l => l.trim());
-    if (lines.includes(entry)) return;
-    const separator = content.length > 0 && !content.endsWith('\n') ? '\n' : '';
-    await fs.appendFile(gitignorePath, `${separator}${entry}\n`);
-    console.log(chalk.yellow(`  ⚠ Added ${entry} to .gitignore (contains API keys)`));
+    let changed = false;
+    let separator = content.length > 0 && !content.endsWith('\n') ? '\n' : '';
+
+    for (const entry of entries) {
+        if (!lines.includes(entry)) {
+            content += `${separator}${entry}\n`;
+            separator = '';
+            changed = true;
+            console.log(chalk.yellow(`  ⚠ Added ${entry} to .gitignore`));
+        }
+    }
+    if (changed) {
+        await fs.writeFile(gitignorePath, content);
+    }
 }
 
 function maskSecret(value) {
@@ -448,13 +539,41 @@ function maskSecret(value) {
 async function init(options) {
     const projectDir = process.cwd();
     const aiflowDir  = path.join(projectDir, '.aiflow');
-    const frameworks = options.frameworks || (options.framework ? [options.framework] : []);
-    const adapters   = options.adapters   || (options.adapter   ? [options.adapter]   : []);
-    const primaryFramework = frameworks[0] || null;
-    const versionDir = path.join(aiflowDir, 'versions', PKG_VERSION);
+    let frameworks = options.frameworks || (options.framework ? [options.framework] : []);
+    const adapters = options.adapters   || (options.adapter   ? [options.adapter]   : []);
 
     try {
         console.log(chalk.blue(`Initializing ai-flow-kit (v${PKG_VERSION})...`));
+
+        // ── Auto-detect or prompt for framework if not supplied ──────
+        if (frameworks.length === 0) {
+            const detected = await detectFramework(projectDir);
+            if (detected) {
+                const label = FRAMEWORK_CHOICES.find(c => c.value === detected)?.name || detected;
+                console.log(chalk.cyan(`\n  Detected framework: ${chalk.bold(label)}`));
+                const useDetected = await confirm({ message: `Use "${label}"?`, default: true });
+                if (useDetected) {
+                    frameworks = [detected];
+                } else {
+                    const chosen = await select({
+                        message: 'Select framework:',
+                        choices: FRAMEWORK_CHOICES,
+                    });
+                    if (chosen) frameworks = [chosen];
+                }
+            } else {
+                console.log(chalk.gray('\n  No framework detected.'));
+                const chosen = await select({
+                    message: 'Select framework (or skip):',
+                    choices: FRAMEWORK_CHOICES,
+                });
+                if (chosen) frameworks = [chosen];
+            }
+        }
+
+        const primaryFramework = frameworks[0] || null;
+        const versionDir = path.join(aiflowDir, 'versions', PKG_VERSION);
+
         if (frameworks.length) console.log(chalk.gray(`  Frameworks: ${frameworks.join(', ')}`));
         if (adapters.length)   console.log(chalk.gray(`  Adapters:   ${adapters.join(', ')}`));
 
@@ -462,8 +581,6 @@ async function init(options) {
         await copyAssetsToVersion(versionDir, primaryFramework);
         await verifySuperpowersSkills(versionDir);
         await updateSymlinks(projectDir, versionDir);
-        
-        // --- Added: Copy docs to project ---
         await copyDocsToProject(projectDir);
 
         const selectedTools = options.aiTools || Object.keys(AI_TOOL_FILES);
@@ -486,11 +603,18 @@ async function init(options) {
         console.log(chalk.green('\n✨ Initialized AI Flow Kit successfully!'));
         console.log(chalk.blue('\n' + '─'.repeat(62)));
         console.log(chalk.bold.white('  Next steps:'));
-        console.log(`  ${chalk.green('aiflow use PROJ-33')}    ${chalk.gray('← load ticket context')}`);
-        console.log(`  ${chalk.green('claude')}                ${chalk.gray('← Use Claude Code CLI (recommended)')}`);
-        console.log(`  ${chalk.green('Cursor / Gemini')}       ${chalk.gray('← Instructions loaded in .cursorrules / GEMINI.md')}`);
+
+        if (adapters.length > 0) {
+            console.log(`  ${chalk.green('aiflow use PROJ-33')}    ${chalk.gray('← load ticket from ' + adapters.join('/'))} `);
+        } else {
+            console.log(`  ${chalk.green('aiflow use --manual')}   ${chalk.gray('← input ticket content in terminal')}`);
+            console.log(`  ${chalk.green('aiflow use --file req.md')} ${chalk.gray('← load from local file')}`);
+        }
+
+        console.log(`  ${chalk.green('claude')}                ${chalk.gray('← Claude Code CLI (recommended)')}`);
+        console.log(`  ${chalk.green('Cursor / Gemini')}       ${chalk.gray('← Instructions in .cursorrules / GEMINI.md')}`);
         console.log(chalk.blue('─'.repeat(62)));
-        console.log(chalk.gray(`  Full guide: ${chalk.green('aiflow guide')} | Command list: ${chalk.green('aiflow guide --commands')}`));
+        console.log(chalk.gray(`  Full guide: ${chalk.green('aiflow guide')} | Commands: ${chalk.green('aiflow guide --commands')}`));
         console.log(chalk.blue('─'.repeat(62)) + '\n');
     } catch (err) {
         console.error(chalk.red(`Error during initialization: ${err.message}`));