prjct-cli 0.4.0

package/core/author-detector.js

@@ -0,0 +1,218 @@
+const { promisify } = require('util')
+const { exec: execCallback } = require('child_process')
+const exec = promisify(execCallback)
+
+/**
+ * AuthorDetector - Detects author information from multiple sources
+ *
+ * Detection priority:
+ * 1. GitHub CLI (gh api user) - Most reliable for GitHub username
+ * 2. Git config (user.name and user.email)
+ * 3. Manual prompt (fallback)
+ *
+ * @version 0.2.0
+ */
+class AuthorDetector {
+  /**
+   * Execute a shell command safely
+   *
+   * @param {string} command - Command to execute
+   * @returns {Promise<{success: boolean, output: string}>}
+   * @private
+   */
+  async execCommand(command) {
+    try {
+      const { stdout } = await exec(command, { timeout: 5000 })
+      return {
+        success: true,
+        output: stdout.trim(),
+      }
+    } catch (error) {
+      return {
+        success: false,
+        output: '',
+      }
+    }
+  }
+
+  /**
+   * Detect GitHub username using GitHub CLI
+   *
+   * @returns {Promise<string|null>} - GitHub username or null
+   */
+  async detectGitHubUsername() {
+    let result = await this.execCommand('gh api user --jq .login')
+    if (result.success && result.output) {
+      return result.output
+    }
+
+    result = await this.execCommand('git config --global github.user')
+    if (result.success && result.output) {
+      return result.output
+    }
+
+    return null
+  }
+
+  /**
+   * Detect git config name
+   *
+   * @returns {Promise<string|null>} - Git name or null
+   */
+  async detectGitName() {
+    const result = await this.execCommand('git config user.name')
+    return result.success && result.output ? result.output : null
+  }
+
+  /**
+   * Detect git config email
+   *
+   * @returns {Promise<string|null>} - Git email or null
+   */
+  async detectGitEmail() {
+    const result = await this.execCommand('git config user.email')
+    return result.success && result.output ? result.output : null
+  }
+
+  /**
+   * Detect author information from all available sources
+   *
+   * @returns {Promise<Object>} - Author information {name, email, github}
+   */
+  async detect() {
+    const author = {
+      name: null,
+      email: null,
+      github: null,
+    }
+
+    author.github = await this.detectGitHubUsername()
+
+    author.name = await this.detectGitName()
+    author.email = await this.detectGitEmail()
+
+    if (!author.name && author.github) {
+      author.name = author.github
+    }
+
+    if (!author.name) {
+      author.name = 'Unknown'
+    }
+
+    return author
+  }
+
+  /**
+   * Detect and format author for memory logs
+   * Returns just the GitHub username or git name
+   *
+   * @returns {Promise<string>} - Author identifier for logs
+   */
+  async detectAuthorForLogs() {
+    const author = await this.detect()
+
+    if (author.github) {
+      return author.github
+    }
+
+    if (author.name && author.name !== 'Unknown') {
+      return author.name
+    }
+
+    return 'unknown'
+  }
+
+  /**
+   * Check if GitHub CLI is available
+   *
+   * @returns {Promise<boolean>} - True if gh command is available
+   */
+  async isGitHubCLIAvailable() {
+    const result = await this.execCommand('gh --version')
+    return result.success
+  }
+
+  /**
+   * Check if git is configured
+   *
+   * @returns {Promise<boolean>} - True if git name and email are set
+   */
+  async isGitConfigured() {
+    const name = await this.detectGitName()
+    const email = await this.detectGitEmail()
+    return !!(name && email)
+  }
+
+  /**
+   * Get configuration status and recommendations
+   *
+   * @returns {Promise<Object>} - Status and recommendations
+   */
+  async getConfigStatus() {
+    const hasGitHub = await this.isGitHubCLIAvailable()
+    const hasGit = await this.isGitConfigured()
+    const author = await this.detect()
+
+    return {
+      hasGitHub,
+      hasGit,
+      author,
+      isComplete: !!(author.github || (author.name !== 'Unknown' && author.email)),
+      recommendations: this._getRecommendations(hasGitHub, hasGit, author),
+    }
+  }
+
+  /**
+   * Generate recommendations based on detected configuration
+   *
+   * @param {boolean} hasGitHub - GitHub CLI available
+   * @param {boolean} hasGit - Git configured
+   * @param {Object} author - Detected author
+   * @returns {string[]} - Array of recommendations
+   * @private
+   */
+  _getRecommendations(hasGitHub, hasGit, author) {
+    const recommendations = []
+
+    if (!hasGitHub && !author.github) {
+      recommendations.push('Install GitHub CLI (gh) for better collaboration support: https://cli.github.com/')
+    }
+
+    if (!hasGit) {
+      recommendations.push('Configure git user: git config --global user.name "Your Name"')
+      recommendations.push('Configure git email: git config --global user.email "your@email.com"')
+    }
+
+    if (author.github && !author.email) {
+      recommendations.push('Consider setting your git email for better tracking')
+    }
+
+    return recommendations
+  }
+
+  /**
+   * Format author information for display
+   *
+   * @param {Object} author - Author object
+   * @returns {string} - Formatted author string
+   */
+  formatAuthor(author) {
+    const parts = []
+
+    if (author.name && author.name !== 'Unknown') {
+      parts.push(author.name)
+    }
+
+    if (author.github) {
+      parts.push(`@${author.github}`)
+    }
+
+    if (author.email) {
+      parts.push(`<${author.email}>`)
+    }
+
+    return parts.join(' ') || 'Unknown'
+  }
+}
+
+module.exports = new AuthorDetector()

package/core/capability-installer.js

@@ -0,0 +1,190 @@
+/**
+ * Capability Installer
+ * Handles installation of missing tools and tracks them as workflow tasks
+ */
+
+const { exec } = require('child_process')
+const { promisify } = require('util')
+const execAsync = promisify(exec)
+
+class CapabilityInstaller {
+  /**
+   * Install capability and create tracking task
+   */
+  async install(capability, recommendation, _dataPath) {
+    const command = recommendation.install
+    const startTime = Date.now()
+
+    try {
+      // Execute installation command
+      const { stdout, stderr } = await execAsync(command)
+
+      const duration = Date.now() - startTime
+      const durationMin = Math.round(duration / 1000 / 60 * 10) / 10
+
+      return {
+        success: true,
+        capability,
+        command,
+        duration: durationMin,
+        output: stdout,
+        errors: stderr || null,
+      }
+    } catch (error) {
+      return {
+        success: false,
+        capability,
+        command,
+        error: error.message,
+      }
+    }
+  }
+
+  /**
+   * Create configuration for installed tool
+   */
+  async configure(capability, projectPath) {
+    const configs = {
+      test: () => this.configureTest(projectPath),
+      design: () => this.configureDesign(projectPath),
+      docs: () => this.configureDocs(projectPath),
+    }
+
+    if (configs[capability]) {
+      return await configs[capability]()
+    }
+
+    return { configured: false }
+  }
+
+  /**
+   * Configure test framework
+   */
+  async configureTest(projectPath) {
+    const fs = require('fs').promises
+    const path = require('path')
+
+    // Check if package.json exists
+    const pkgPath = path.join(projectPath, 'package.json')
+    const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf8'))
+
+    const hasVitest = pkg.devDependencies?.vitest
+    const hasJest = pkg.devDependencies?.jest
+
+    if (hasVitest) {
+      // Create vitest.config.js
+      const config = `import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'jsdom',
+    setupFiles: './test/setup.js'
+  }
+})
+`
+      await fs.writeFile(path.join(projectPath, 'vitest.config.js'), config)
+
+      // Add test script
+      pkg.scripts = pkg.scripts || {}
+      pkg.scripts.test = 'vitest'
+      pkg.scripts['test:ui'] = 'vitest --ui'
+      await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2))
+
+      return { configured: true, framework: 'vitest' }
+    }
+
+    if (hasJest) {
+      // Create jest.config.js
+      const config = `module.exports = {
+  testEnvironment: 'jsdom',
+  setupFilesAfterEnv: ['<rootDir>/test/setup.js'],
+  moduleNameMapper: {
+    '\\\\.(css|less|scss|sass)$': 'identity-obj-proxy'
+  }
+}
+`
+      await fs.writeFile(path.join(projectPath, 'jest.config.js'), config)
+
+      // Add test script
+      pkg.scripts = pkg.scripts || {}
+      pkg.scripts.test = 'jest'
+      pkg.scripts['test:watch'] = 'jest --watch'
+      await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2))
+
+      return { configured: true, framework: 'jest' }
+    }
+
+    return { configured: false }
+  }
+
+  /**
+   * Configure design system
+   */
+  async configureDesign(projectPath) {
+    const fs = require('fs').promises
+    const path = require('path')
+
+    const pkgPath = path.join(projectPath, 'package.json')
+    const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf8'))
+
+    if (pkg.devDependencies?.storybook) {
+      // Storybook auto-configures itself during init
+      return { configured: true, tool: 'storybook' }
+    }
+
+    return { configured: false }
+  }
+
+  /**
+   * Configure documentation
+   */
+  async configureDocs(projectPath) {
+    const fs = require('fs').promises
+    const path = require('path')
+
+    const pkgPath = path.join(projectPath, 'package.json')
+    const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf8'))
+
+    if (pkg.devDependencies?.jsdoc) {
+      // Create jsdoc.json
+      const config = {
+        source: {
+          include: ['src'],
+          includePattern: '.+\\\\.js(doc|x)?$',
+          excludePattern: '(node_modules|docs)',
+        },
+        opts: {
+          destination: './docs',
+          recurse: true,
+        },
+      }
+
+      await fs.writeFile(
+        path.join(projectPath, 'jsdoc.json'),
+        JSON.stringify(config, null, 2),
+      )
+
+      // Add docs script
+      pkg.scripts = pkg.scripts || {}
+      pkg.scripts.docs = 'jsdoc -c jsdoc.json'
+      await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2))
+
+      return { configured: true, tool: 'jsdoc' }
+    }
+
+    return { configured: false }
+  }
+
+  /**
+   * Verify installation succeeded
+   */
+  async verify(capability, projectPath) {
+    const caps = require('./project-capabilities')
+    const detected = await caps.detect(projectPath)
+
+    return detected[capability] === true
+  }
+}
+
+module.exports = new CapabilityInstaller()