ai-sprint-kit 1.1.0

package/lib/scanner.js

@@ -0,0 +1,341 @@
+const fs = require('fs-extra');
+const path = require('path');
+const ora = require('ora');
+const chalk = require('chalk');
+const execa = require('execa');
+
+// Common source code directories to detect
+const SOURCE_DIRS = ['src', 'app', 'lib', 'pages', 'components', 'packages', 'modules'];
+const SOURCE_EXTENSIONS = ['.js', '.ts', '.jsx', '.tsx', '.py', '.go', '.rs', '.java', '.rb', '.php'];
+
+/**
+ * Check if target directory contains source code
+ * @param {string} targetDir - Directory to check
+ * @returns {Promise<boolean>} - True if source code detected
+ */
+async function detectSourceCode(targetDir) {
+  // Check for common source directories
+  for (const dir of SOURCE_DIRS) {
+    const dirPath = path.join(targetDir, dir);
+    if (await fs.pathExists(dirPath)) {
+      const stats = await fs.stat(dirPath);
+      if (stats.isDirectory()) {
+        return true;
+      }
+    }
+  }
+
+  // Check for source files in root
+  try {
+    const files = await fs.readdir(targetDir);
+    for (const file of files) {
+      const ext = path.extname(file).toLowerCase();
+      if (SOURCE_EXTENSIONS.includes(ext)) {
+        return true;
+      }
+    }
+  } catch (error) {
+    // Ignore read errors
+  }
+
+  return false;
+}
+
+/**
+ * Check if repomix is available
+ * @returns {Promise<{available: boolean, command: string}>}
+ */
+async function checkRepomix() {
+  // Check global installation
+  try {
+    await execa('repomix', ['--version']);
+    return { available: true, command: 'repomix' };
+  } catch (error) {
+    // Not globally installed, will use npx
+  }
+
+  // Check if npx is available
+  try {
+    await execa('npx', ['--version']);
+    return { available: true, command: 'npx repomix' };
+  } catch (error) {
+    return { available: false, command: null };
+  }
+}
+
+/**
+ * Run repomix scan on target directory
+ * @param {string} targetDir - Directory to scan
+ * @param {string} outputDir - Output directory for scan results
+ * @param {object} options - Scan options
+ * @returns {Promise<object>} - Scan results
+ */
+async function runRepomixScan(targetDir, outputDir, options = {}) {
+  const { useNpx = false } = options;
+
+  // Create output directory
+  await fs.ensureDir(outputDir);
+
+  const xmlOutput = path.join(outputDir, 'repomix-output.xml');
+  const mdOutput = path.join(outputDir, 'overview.md');
+
+  // Build base command
+  const baseCmd = useNpx ? 'npx' : 'repomix';
+  const baseArgs = useNpx ? ['repomix'] : [];
+
+  // Generate XML output (for AI consumption)
+  const xmlArgs = [
+    ...baseArgs,
+    '--compress',
+    '--style', 'xml',
+    '-o', xmlOutput
+  ];
+
+  await execa(baseCmd, xmlArgs, {
+    cwd: targetDir,
+    timeout: 300000 // 5 minute timeout
+  });
+
+  // Generate Markdown output (for human reading)
+  const mdArgs = [
+    ...baseArgs,
+    '--compress',
+    '--style', 'markdown',
+    '-o', mdOutput
+  ];
+
+  await execa(baseCmd, mdArgs, {
+    cwd: targetDir,
+    timeout: 300000
+  });
+
+  // Parse XML to get stats
+  let stats = {
+    totalFiles: 0,
+    totalTokens: 0,
+    compressedTokens: 0
+  };
+
+  try {
+    const xmlContent = await fs.readFile(xmlOutput, 'utf-8');
+    // Count file entries in XML
+    const fileMatches = xmlContent.match(/<file path="/g);
+    if (fileMatches) {
+      stats.totalFiles = fileMatches.length;
+    }
+  } catch (error) {
+    // Stats extraction failed, continue with defaults
+  }
+
+  return stats;
+}
+
+/**
+ * Generate directory structure file
+ * @param {string} targetDir - Directory to scan
+ * @param {string} outputDir - Output directory
+ */
+async function generateStructure(targetDir, outputDir) {
+  const structureFile = path.join(outputDir, 'structure.md');
+  let content = '# Project Structure\n\n```\n';
+
+  try {
+    // Try using tree command
+    const { stdout } = await execa('tree', [
+      '-I', 'node_modules|.git|.venv|__pycache__|dist|build|.next|coverage',
+      '-L', '4',
+      '--noreport'
+    ], {
+      cwd: targetDir,
+      timeout: 30000
+    });
+    content += stdout;
+  } catch (error) {
+    // Fallback: simple directory listing
+    content += await generateSimpleTree(targetDir, '', 0, 4);
+  }
+
+  content += '\n```\n';
+  await fs.writeFile(structureFile, content);
+}
+
+/**
+ * Simple tree generator fallback
+ */
+async function generateSimpleTree(dir, prefix, depth, maxDepth) {
+  if (depth >= maxDepth) return '';
+
+  const ignoreDirs = ['node_modules', '.git', '.venv', '__pycache__', 'dist', 'build', '.next', 'coverage'];
+  let result = '';
+
+  try {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const filtered = entries.filter(e => !ignoreDirs.includes(e.name) && !e.name.startsWith('.'));
+
+    for (let i = 0; i < filtered.length; i++) {
+      const entry = filtered[i];
+      const isLast = i === filtered.length - 1;
+      const connector = isLast ? '└── ' : '├── ';
+      const newPrefix = prefix + (isLast ? '    ' : '│   ');
+
+      result += prefix + connector + entry.name + '\n';
+
+      if (entry.isDirectory()) {
+        result += await generateSimpleTree(
+          path.join(dir, entry.name),
+          newPrefix,
+          depth + 1,
+          maxDepth
+        );
+      }
+    }
+  } catch (error) {
+    // Ignore errors
+  }
+
+  return result;
+}
+
+/**
+ * Create default .repomixignore file
+ * @param {string} outputDir - Output directory
+ */
+async function createRepomixIgnore(outputDir) {
+  const ignorePath = path.join(outputDir, '.repomixignore');
+
+  if (await fs.pathExists(ignorePath)) {
+    return; // Don't overwrite existing
+  }
+
+  const content = `# AI Sprint default ignore patterns
+node_modules/
+.git/
+dist/
+build/
+.next/
+.venv/
+__pycache__/
+*.pyc
+.env*
+*.log
+coverage/
+.nyc_output/
+*.min.js
+*.min.css
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+`;
+
+  await fs.writeFile(ignorePath, content);
+}
+
+/**
+ * Write scan metadata
+ * @param {string} outputDir - Output directory
+ * @param {object} stats - Scan statistics
+ */
+async function writeMetadata(outputDir, stats) {
+  const metadataPath = path.join(outputDir, 'scan-metadata.json');
+
+  const metadata = {
+    scanDate: new Date().toISOString(),
+    scanDuration: stats.duration || 0,
+    totalFiles: stats.totalFiles || 0,
+    totalTokens: stats.totalTokens || 0,
+    compressedTokens: stats.compressedTokens || 0,
+    compressionRatio: stats.totalTokens > 0
+      ? Math.round((1 - stats.compressedTokens / stats.totalTokens) * 100) / 100
+      : 0,
+    securityIssues: stats.securityIssues || 0
+  };
+
+  await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2));
+  return metadata;
+}
+
+/**
+ * Main entry point for codebase scanning
+ * @param {string} targetDir - Directory to scan
+ * @param {object} options - Scan options
+ * @returns {Promise<object>} - Scan results
+ */
+async function scanCodebase(targetDir, options = {}) {
+  const { silent = false } = options;
+  const outputDir = path.join(targetDir, 'ai_context', 'codebase');
+  const startTime = Date.now();
+
+  // Check for source code
+  const hasSource = await detectSourceCode(targetDir);
+  if (!hasSource) {
+    if (!silent) {
+      console.log(chalk.gray('   No source code detected. Skipping scan.'));
+    }
+    return { skipped: true, reason: 'no-source' };
+  }
+
+  // Check repomix availability
+  const { available, command } = await checkRepomix();
+  if (!available) {
+    if (!silent) {
+      console.log(chalk.yellow('   ⚠️  Repomix not available. Skipping scan.'));
+      console.log(chalk.gray('   Install with: npm install -g repomix'));
+    }
+    return { skipped: true, reason: 'no-repomix' };
+  }
+
+  const spinner = silent ? null : ora('Scanning codebase...').start();
+
+  try {
+    // Create output directory
+    await fs.ensureDir(outputDir);
+
+    // Create default ignore file
+    await createRepomixIgnore(outputDir);
+
+    // Run repomix scan
+    const useNpx = command.includes('npx');
+    const stats = await runRepomixScan(targetDir, outputDir, { useNpx });
+
+    // Generate structure
+    if (spinner) spinner.text = 'Generating structure...';
+    await generateStructure(targetDir, outputDir);
+
+    // Calculate duration
+    stats.duration = Math.round((Date.now() - startTime) / 1000 * 10) / 10;
+
+    // Write metadata
+    const metadata = await writeMetadata(outputDir, stats);
+
+    if (spinner) {
+      spinner.succeed(`Codebase scanned (${stats.totalFiles} files, ${stats.duration}s)`);
+    }
+
+    return {
+      success: true,
+      outputDir,
+      stats: metadata
+    };
+
+  } catch (error) {
+    if (spinner) {
+      spinner.fail('Codebase scan failed');
+    }
+
+    if (!silent) {
+      console.log(chalk.yellow(`   ⚠️  ${error.message}`));
+      console.log(chalk.gray('   Run /scan manually after fixing the issue.'));
+    }
+
+    return {
+      success: false,
+      error: error.message
+    };
+  }
+}
+
+module.exports = {
+  scanCodebase,
+  detectSourceCode,
+  checkRepomix
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "ai-sprint-kit",
+  "version": "1.1.0",
+  "description": "CLI installer for autonomous coding agent framework - security-first, production-grade Claude Code setup",
+  "main": "lib/installer.js",
+  "bin": {
+    "ai-sprint": "bin/cli.js"
+  },
+  "scripts": {
+    "test": "node bin/cli.js --help",
+    "link": "npm link",
+    "unlink": "npm unlink -g ai-sprint"
+  },
+  "keywords": [
+    "claude-code",
+    "autonomous-agents",
+    "ai-development",
+    "security",
+    "cli",
+    "devtools",
+    "code-generation",
+    "ai-sprint"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/ai-sprint.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yourusername/ai-sprint/issues"
+  },
+  "homepage": "https://github.com/yourusername/ai-sprint#readme",
+  "files": [
+    "bin/",
+    "lib/",
+    "templates/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "inquirer": "^8.2.6",
+    "fs-extra": "^11.2.0",
+    "execa": "^5.1.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/.claude/.env.example

@@ -0,0 +1,13 @@
+# AI Sprint Framework - Environment Variables
+
+# Security Scanning (Optional)
+# Get tokens from: https://snyk.io, https://semgrep.dev
+SNYK_TOKEN=
+SEMGREP_APP_TOKEN=
+
+# Claude API (Optional - only if using custom models)
+# Get from: https://console.anthropic.com
+ANTHROPIC_API_KEY=
+
+# Project Settings
+NODE_ENV=development