@nolrm/contextkit 0.13.4 → 0.13.7

package/lib/commands/install.js

@@ -1,9 +1,8 @@
 const chalk = require('chalk');
-const ora = require('ora');
 const inquirer = require('inquirer');
 const fs = require('fs-extra');
 const path = require('path');
-const axios = require('axios');
+const childProcess = require('child_process');
 
 const DownloadManager = require('../utils/download');
 const ProjectDetector = require('../utils/project-detector');
@@ -22,7 +21,7 @@ class InstallCommand {
 
   async install(options = {}) {
     // Migrate legacy .vibe-kit/ directory
-    if (await fs.pathExists('.vibe-kit') && !await fs.pathExists('.contextkit')) {
+    if ((await fs.pathExists('.vibe-kit')) && !(await fs.pathExists('.contextkit'))) {
       console.log(chalk.yellow('Found legacy .vibe-kit/ directory'));
       console.log(chalk.yellow('Renaming to .contextkit/...'));
       await fs.move('.vibe-kit', '.contextkit');
@@ -41,8 +40,12 @@ class InstallCommand {
     const hasGit = await this._findFileUpward('.git', 3);
     const hasPkg = await fs.pathExists('package.json');
     if (!hasGit && !hasPkg) {
-      console.log(chalk.yellow('⚠️  No project detected (no .git or package.json found in this directory).'));
-      console.log(chalk.yellow('   Make sure you are inside your project before running `ck install`.'));
+      console.log(
+        chalk.yellow('⚠️  No project detected (no .git or package.json found in this directory).')
+      );
+      console.log(
+        chalk.yellow('   Make sure you are inside your project before running `ck install`.')
+      );
       console.log('');
     }
 
@@ -87,7 +90,9 @@ class InstallCommand {
       const { shouldContinue } = await this.promptReinstall();
       if (!shouldContinue) {
         console.log(chalk.yellow('⏭️  Installation cancelled'));
-        console.log(chalk.dim('💡 To get the latest command and squad files, run: ') + chalk.cyan('ck update'));
+        console.log(
+          chalk.dim('💡 To get the latest command and squad files, run: ') + chalk.cyan('ck update')
+        );
         return;
       }
     }
@@ -114,6 +119,11 @@ class InstallCommand {
       await this.gitHooksManager.installHooks(packageManager, hookChoices);
     }
 
+    // Offer quality tooling scaffold for Node.js projects with pre-push enabled
+    if (hookChoices.prePush && !options.nonInteractive) {
+      await this.promptQualityTooling(packageManager, options);
+    }
+
     // Ask about GitHub Actions CI squad workflow
     let squadCi = false;
     if (!options.nonInteractive) {
@@ -151,7 +161,11 @@ class InstallCommand {
 
       if (!integration) {
         console.log(chalk.red(`❌ Unknown platform: ${platform}`));
-        console.log(chalk.yellow('💡 Available: claude, cursor, copilot, codex, opencode, gemini, aider, continue, windsurf'));
+        console.log(
+          chalk.yellow(
+            '💡 Available: claude, cursor, copilot, codex, opencode, gemini, aider, continue, windsurf'
+          )
+        );
         return;
       }
 
@@ -161,7 +175,6 @@ class InstallCommand {
       console.log(chalk.green(`🎉 ${integration.displayName} integration installed!`));
 
       integration.showUsage();
-
     } catch (error) {
       console.log(chalk.red(`❌ Failed to install ${platform} integration`));
       console.log(chalk.yellow(error.message));
@@ -186,30 +199,32 @@ class InstallCommand {
         type: 'confirm',
         name: 'shouldContinue',
         message: 'ContextKit is already installed. Do you want to reinstall?',
-        default: false
-      }
+        default: false,
+      },
     ]);
     return { shouldContinue };
   }
 
   async promptPlatformChoice() {
-    const { platform } = await inquirer.prompt([{
-      type: 'list',
-      name: 'platform',
-      message: 'Which AI tool are you using?',
-      choices: [
-        { name: 'Claude Code', value: 'claude' },
-        { name: 'Cursor', value: 'cursor' },
-        { name: 'Copilot (GitHub)', value: 'copilot' },
-        { name: 'Codex (OpenAI)', value: 'codex' },
-        { name: 'OpenCode', value: 'opencode' },
-        { name: 'Gemini', value: 'gemini' },
-        { name: 'Windsurf', value: 'windsurf' },
-        { name: 'Aider', value: 'aider' },
-        { name: 'Continue', value: 'continue' },
-        { name: 'Skip (base only)', value: null },
-      ]
-    }]);
+    const { platform } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'platform',
+        message: 'Which AI tool are you using?',
+        choices: [
+          { name: 'Claude Code', value: 'claude' },
+          { name: 'Cursor', value: 'cursor' },
+          { name: 'Copilot (GitHub)', value: 'copilot' },
+          { name: 'Codex (OpenAI)', value: 'codex' },
+          { name: 'OpenCode', value: 'opencode' },
+          { name: 'Gemini', value: 'gemini' },
+          { name: 'Windsurf', value: 'windsurf' },
+          { name: 'Aider', value: 'aider' },
+          { name: 'Continue', value: 'continue' },
+          { name: 'Skip (base only)', value: null },
+        ],
+      },
+    ]);
     return platform;
   }
 
@@ -257,7 +272,9 @@ class InstallCommand {
         `${this.repoUrl}/templates/github-actions/squad-issue.yml`,
         '.github/workflows/squad-issue.yml'
       );
-      console.log(chalk.green('✅ CI squad workflow installed → .github/workflows/squad-issue.yml'));
+      console.log(
+        chalk.green('✅ CI squad workflow installed → .github/workflows/squad-issue.yml')
+      );
     } catch (error) {
       console.log(chalk.yellow('⚠️  Could not install CI squad workflow:'), error.message);
     }
@@ -270,7 +287,7 @@ class InstallCommand {
       return { prePush: false, commitMsg: false };
     }
 
-    if (!await fs.pathExists('.git')) {
+    if (!(await fs.pathExists('.git'))) {
       console.log(chalk.yellow('⚠️  Skipping Git hooks setup (not a git repository)'));
       return { prePush: false, commitMsg: false };
     }
@@ -291,8 +308,8 @@ class InstallCommand {
         type: 'confirm',
         name: 'prePush',
         message: 'Enable pre-push hook? (runs quality checks before push)',
-        default: false
-      }
+        default: false,
+      },
     ]);
 
     if (prePush) {
@@ -314,8 +331,8 @@ class InstallCommand {
         type: 'confirm',
         name: 'commitMsg',
         message: 'Enable commit-msg hook? (enforces conventional commit format)',
-        default: false
-      }
+        default: false,
+      },
     ]);
 
     if (commitMsg) {
@@ -336,7 +353,7 @@ class InstallCommand {
 
   async createDirectoryStructure() {
     console.log(chalk.blue('📁 Creating structure...'));
-    
+
     const directories = [
       '.contextkit/standards',
       '.contextkit/standards/code-style', // Granular code style files
@@ -350,7 +367,7 @@ class InstallCommand {
       '.contextkit/templates',
       '.contextkit/scripts',
       '.contextkit/integrations',
-      '.contextkit/policies' // Policy enforcement configs
+      '.contextkit/policies', // Policy enforcement configs
     ];
 
     for (const dir of directories) {
@@ -393,7 +410,7 @@ Use conditional loading tags:
 [TypeScript-specific content]
 \`\`\`
 `,
-      
+
       'standards/testing.md': `# Testing Standards
 
 <!-- Content will be generated by running: /analyze -->
@@ -428,7 +445,7 @@ describe("ComponentName", () => {
 - Consistent organization across all test files
 - Quick debugging and maintenance
 `,
-      
+
       'standards/architecture.md': `# Architecture
 
 ## Documentation Levels
@@ -476,7 +493,7 @@ Documentation for a single component or a small, cohesive set of components.
 Your architecture patterns will be documented based on your project structure and organization.
 
 Run \`/analyze\` to generate this content.`,
-      
+
       'standards/ai-guidelines.md': `# AI Guidelines
 
 <!-- Content will be generated by running: /analyze -->
@@ -484,14 +501,14 @@ Run \`/analyze\` to generate this content.`,
 Guidelines for AI assistance will be defined based on your project's needs and patterns.
 
 Run \`/analyze\` to generate this content.`,
-      
+
       'standards/workflows.md': `# Workflows
 
 <!-- Content will be generated by running: /analyze -->
 
 Development workflows and processes will be documented based on your project's practices.
 
-Run \`/analyze\` to generate this content.`
+Run \`/analyze\` to generate this content.`,
     };
 
     // Create granular code-style skeleton files
@@ -562,7 +579,7 @@ This file is loaded when HTML-related tasks are detected:
 <!-- when:html -->
 [HTML-specific content]
 \`\`\`
-`
+`,
     };
 
     for (const [relativePath, content] of Object.entries(skeletonFiles)) {
@@ -688,7 +705,7 @@ Main paths through this feature:
 ## Notes
 
 Any design decisions, trade-offs, or open questions to resolve before coding.
-`
+`,
     };
 
     for (const [relativePath, content] of Object.entries(skeletonFiles)) {
@@ -696,22 +713,22 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
     }
   }
 
-  async downloadFiles(projectType, options = {}) {
+  async downloadFiles(projectType, _options = {}) {
     try {
       // Create skeleton standards files (will be customized by analyze)
       console.log(chalk.blue('📝 Creating skeleton standards files...'));
       await this.createSkeletonStandards();
-      
+
       console.log(chalk.green('✅ Skeleton files created'));
       console.log(chalk.yellow('💡 Run: /analyze to generate content based on your codebase'));
       console.log('');
-      
+
       // Download base files
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/standards/README.md`,
         '.contextkit/standards/README.md'
       );
-      
+
       // Download the actual glossary (keep it as-is, universal across all projects)
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/standards/glossary.md`,
@@ -982,7 +999,7 @@ claude "read .contextkit/standards/README.md .contextkit/standards/glossary.md a
 claude "read .contextkit/product/mission-lite.md .contextkit/standards/code-style.md and create a feature"
 \`\`\`
 `;
-    
+
     await fs.writeFile('.contextkit/context.md', context);
     await fs.writeFile('.contextkit/CONTEXT.md', context); // Keep uppercase for backward compatibility
 
@@ -993,14 +1010,14 @@ claude "read .contextkit/product/mission-lite.md .contextkit/standards/code-styl
 
 CONTEXT_FILE=".contextkit/context.md"
 AI_TOOL="\${AI_TOOL:-aider}"
-PROMPT="\$@"
+PROMPT="$@"
 
 if [ ! -f "$CONTEXT_FILE" ]; then
   echo "❌ ContextKit not initialized. Run: contextkit install"
   exit 1
 fi
 
-CONTEXT=\$(cat "$CONTEXT_FILE")
+CONTEXT=$(cat "$CONTEXT_FILE")
 
 case "$AI_TOOL" in
   "aider")
@@ -1021,7 +1038,7 @@ esac
 
     await fs.writeFile('.contextkit/scripts/ai-cli.sh', cliScript);
     await fs.chmod('.contextkit/scripts/ai-cli.sh', '755');
-    
+
     console.log(chalk.green('✅ CLI helpers installed'));
   }
 
@@ -1046,7 +1063,7 @@ esac
         components: 'src/components',
         tests: 'src/__tests__',
         stories: 'src/stories',
-        docs: 'docs'
+        docs: 'docs',
       },
       commands: {
         analyze: '@.contextkit/commands/analyze.md',
@@ -1057,16 +1074,19 @@ esac
         add_docs: '@.contextkit/commands/add-documentation.md',
         quality_check: '@.contextkit/commands/quality-check.md',
         create_component: '@.contextkit/commands/create-component.md',
-        create_feature: '@.contextkit/commands/create-feature.md'
-      }
+        create_feature: '@.contextkit/commands/create-feature.md',
+      },
     };
 
     const now = new Date().toISOString();
-    const isMonorepo = await fs.pathExists('packages') || await fs.pathExists('apps') || 
-                       (await fs.pathExists('package.json') && 
-                        (await fs.readJson('package.json').catch(() => ({}))).workspaces);
-    
-    await fs.writeFile('.contextkit/config.yml',
+    const isMonorepo =
+      (await fs.pathExists('packages')) ||
+      (await fs.pathExists('apps')) ||
+      ((await fs.pathExists('package.json')) &&
+        (await fs.readJson('package.json').catch(() => ({}))).workspaces);
+
+    await fs.writeFile(
+      '.contextkit/config.yml',
       `# ContextKit Configuration
 _source:
   tool: "@nolrm/contextkit"
@@ -1165,7 +1185,7 @@ https://www.npmjs.com/package/@nolrm/contextkit
       status.features.pre_push_hook = hookChoices.prePush;
       status.features.commit_msg_hook = hookChoices.commitMsg;
       status.features.squad_ci_workflow = squadCi;
-      
+
       await this.statusManager.saveStatus(status);
       console.log(chalk.green('✅ Status tracking initialized'));
     } catch (error) {
@@ -1175,7 +1195,7 @@ https://www.npmjs.com/package/@nolrm/contextkit
 
   async createProductContext() {
     console.log(chalk.blue('📦 Creating product context files...'));
-    
+
     const missionContent = `# Product Mission
 
 <!-- Content will be generated by running: ck analyze or manually fill this in -->
@@ -1373,13 +1393,13 @@ Unlike [COMPETITOR_OR_ALTERNATIVE], we provide [SPECIFIC_ADVANTAGE]. This result
     await fs.writeFile('.contextkit/product/roadmap.md', roadmapContent);
     await fs.writeFile('.contextkit/product/decisions.md', decisionsContent);
     await fs.writeFile('.contextkit/product/context.md', contextContent);
-    
+
     console.log(chalk.green('✅ Product context files created'));
   }
 
   async createCorrectionsLog() {
     console.log(chalk.blue('📝 Creating corrections log system...'));
-    
+
     const correctionsContent = `# ContextKit Corrections Log
 
 ## Description
@@ -1565,14 +1585,17 @@ Automatically track and log ContextKit performance issues during development ses
 `;
 
     await fs.writeFile('.contextkit/corrections.md', correctionsContent);
-    await fs.writeFile('.contextkit/instructions/core/auto-corrections-log.md', autoCorrectionsContent);
-    
+    await fs.writeFile(
+      '.contextkit/instructions/core/auto-corrections-log.md',
+      autoCorrectionsContent
+    );
+
     console.log(chalk.green('✅ Corrections log system created'));
   }
 
   async createMetaInstructions() {
     console.log(chalk.blue('📋 Creating meta instructions...'));
-    
+
     const preFlightContent = `---
 description: Common Pre-Flight Steps for ContextKit Instructions
 globs:
@@ -1646,13 +1669,13 @@ After completing any development session, automatically update the corrections l
 
     await fs.writeFile('.contextkit/instructions/meta/pre-flight.md', preFlightContent);
     await fs.writeFile('.contextkit/instructions/meta/post-flight.md', postFlightContent);
-    
+
     console.log(chalk.green('✅ Meta instructions created'));
   }
 
   async createPolicyFile() {
     console.log(chalk.blue('⚖️  Creating policy file...'));
-    
+
     const policyContent = `# ContextKit Policy Configuration
 
 ## Enforcement Levels
@@ -1676,11 +1699,11 @@ enforcement:
 `;
 
     await fs.writeFile('.contextkit/policies/policy.yml', policyContent);
-    
+
     console.log(chalk.green('✅ Policy file created'));
   }
 
-  showSuccessMessage(hookChoices, platform = null, projectType = '', packageManager = '') {
+  showSuccessMessage(hookChoices, platform = null, _projectType = '', _packageManager = '') {
     console.log('');
     console.log(chalk.green('🎉 ContextKit v1.0.0 successfully installed!'));
     console.log('');
@@ -1702,7 +1725,9 @@ enforcement:
     console.log(chalk.bold('📖 Quick Reference'));
     console.log(''.padEnd(48, '─'));
     console.log(`ck status    → Check installation & integrations`);
-    console.log(`ck <platform> → Add platform (claude, cursor, copilot, codex, opencode, gemini, aider, continue, windsurf)`);
+    console.log(
+      `ck <platform> → Add platform (claude, cursor, copilot, codex, opencode, gemini, aider, continue, windsurf)`
+    );
     console.log('');
     console.log(`Docs → ${chalk.blue('https://contextkit-docs.vercel.app')}`);
     console.log(`Issues → ${chalk.blue('https://github.com/nolrm/contextkit/issues')}`);
@@ -1747,7 +1772,11 @@ enforcement:
     }
 
     console.log(chalk.bold('In CLI'));
-    console.log(chalk.dim('Use your AI tool\'s slash command, e.g. /analyze or @.contextkit/commands/create-component.md'));
+    console.log(
+      chalk.dim(
+        "Use your AI tool's slash command, e.g. /analyze or @.contextkit/commands/create-component.md"
+      )
+    );
     console.log('');
 
     if (platform === 'claude' || platform === 'gemini') {
@@ -1761,6 +1790,179 @@ enforcement:
     console.log('');
   }
 
+  async promptQualityTooling(packageManager, _options = {}) {
+    // Only relevant for Node.js projects
+    if (!(await fs.pathExists('package.json'))) return;
+
+    // Skip in CI / non-interactive mode
+    if (process.env.CI === 'true' || process.env.NON_INTERACTIVE === 'true') return;
+
+    const pkg = await fs.readJson('package.json').catch(() => null);
+    if (!pkg) return;
+
+    const hasFormat = !!(pkg.scripts && pkg.scripts.format);
+    const hasLint = !!(pkg.scripts && pkg.scripts.lint);
+
+    // Both already present — nothing to do
+    if (hasFormat && hasLint) return;
+
+    console.log('');
+    console.log('──────────────────────────────────────────────');
+    console.log(chalk.blue('🛠️  Format + Lint Quality Gates'));
+    console.log('──────────────────────────────────────────────');
+    console.log(chalk.dim('The pre-push hook runs format and lint scripts automatically'));
+    console.log(chalk.dim('when present. Your project has none — add a minimal setup now?'));
+    console.log('');
+
+    const { scaffold } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'scaffold',
+        message: 'Add prettier + eslint setup? (adds scripts + config files)',
+        default: false,
+      },
+    ]);
+
+    if (scaffold) {
+      await this.scaffoldQualityTooling(pkg, packageManager);
+    } else {
+      console.log(chalk.dim('💡 Add format/lint scripts later to activate these quality gates'));
+    }
+    console.log('');
+  }
+
+  async scaffoldQualityTooling(pkg, packageManager) {
+    const pmInstallFlags = {
+      npm: 'install --save-dev',
+      yarn: 'add --dev',
+      pnpm: 'add -D',
+      bun: 'add -d',
+    };
+    const installFlag = pmInstallFlags[packageManager] || 'install --save-dev';
+    const pm = packageManager === 'none' ? 'npm' : packageManager;
+
+    try {
+      const created = [];
+
+      // 1. Add missing scripts to package.json
+      if (!pkg.scripts) pkg.scripts = {};
+      if (!pkg.scripts.format) {
+        pkg.scripts.format = 'prettier --write .';
+        created.push('format script');
+      }
+      if (!pkg.scripts.lint) {
+        pkg.scripts.lint = 'eslint .';
+        created.push('lint script');
+      }
+      await fs.writeFile('package.json', JSON.stringify(pkg, null, 2) + '\n');
+
+      // 2. Create .prettierrc if no existing config
+      if (!(await this._hasExistingPrettierConfig(pkg))) {
+        await fs.writeFile(
+          '.prettierrc',
+          JSON.stringify(
+            { singleQuote: true, semi: true, tabWidth: 2, printWidth: 100, trailingComma: 'es5' },
+            null,
+            2
+          ) + '\n'
+        );
+        created.push('.prettierrc');
+      }
+
+      // 3. Create .prettierignore if absent
+      if (!(await fs.pathExists('.prettierignore'))) {
+        await fs.writeFile('.prettierignore', 'node_modules/\ncoverage/\ndist/\nbuild/\n');
+        created.push('.prettierignore');
+      }
+
+      // 4. Create eslint.config.js if no existing config
+      if (!(await this._hasExistingEslintConfig(pkg))) {
+        await fs.writeFile(
+          'eslint.config.js',
+          `const js = require('@eslint/js');
+const globals = require('globals');
+
+module.exports = [
+  js.configs.recommended,
+  {
+    languageOptions: {
+      ecmaVersion: 2022,
+      globals: {
+        ...globals.node,
+      },
+    },
+    rules: {
+      'no-unused-vars': ['warn', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+    },
+  },
+  {
+    files: ['**/__tests__/**/*.js', '**/*.test.js'],
+    languageOptions: {
+      globals: {
+        ...globals.jest,
+      },
+    },
+  },
+];\n`
+        );
+        created.push('eslint.config.js');
+      }
+
+      // 5. Install devDependencies
+      console.log(chalk.blue(`\n📦 Installing prettier + eslint...`));
+      childProcess.execSync(`${pm} ${installFlag} prettier eslint @eslint/js globals`, {
+        stdio: 'inherit',
+      });
+
+      console.log('');
+      console.log(chalk.green('✅ Quality tooling ready:'));
+      created.forEach((item) => console.log(chalk.dim(`   • ${item}`)));
+      console.log(chalk.dim('   Run npm run format to apply formatting to existing files'));
+    } catch (error) {
+      console.log(chalk.yellow('⚠️  Could not complete quality tooling setup:'), error.message);
+      console.log(chalk.dim('   You can set this up manually later'));
+    }
+  }
+
+  async _hasExistingPrettierConfig(pkg) {
+    if (pkg.prettier) return true;
+    const configs = [
+      '.prettierrc',
+      '.prettierrc.json',
+      '.prettierrc.js',
+      '.prettierrc.mjs',
+      '.prettierrc.cjs',
+      '.prettierrc.yaml',
+      '.prettierrc.yml',
+      '.prettierrc.toml',
+      'prettier.config.js',
+      'prettier.config.mjs',
+      'prettier.config.cjs',
+    ];
+    for (const f of configs) {
+      if (await fs.pathExists(f)) return true;
+    }
+    return false;
+  }
+
+  async _hasExistingEslintConfig(pkg) {
+    if (pkg.eslintConfig) return true;
+    const configs = [
+      'eslint.config.js',
+      'eslint.config.mjs',
+      'eslint.config.cjs',
+      '.eslintrc',
+      '.eslintrc.js',
+      '.eslintrc.json',
+      '.eslintrc.yml',
+      '.eslintrc.yaml',
+    ];
+    for (const f of configs) {
+      if (await fs.pathExists(f)) return true;
+    }
+    return false;
+  }
+
   async _findFileUpward(name, maxLevels) {
     let dir = process.cwd();
     for (let i = 0; i <= maxLevels; i++) {
@@ -1779,3 +1981,4 @@ async function install(options) {
 }
 
 module.exports = install;
+module.exports.InstallCommand = InstallCommand;