prjct-cli 0.44.1 → 0.45.3

package/core/services/project-service.ts

@@ -4,14 +4,14 @@
  * Handles project initialization detection, author management, and directory analysis.
  */
 
+import { ProjectError } from '../errors'
+import authorDetector from '../infrastructure/author-detector'
 import configManager from '../infrastructure/config-manager'
 import pathManager from '../infrastructure/path-manager'
-import authorDetector from '../infrastructure/author-detector'
+import type { Author, CommandResult } from '../types'
+import { isNotFoundError } from '../types/fs'
 import * as fileHelper from '../utils/file-helper'
 import out from '../utils/output'
-import { isNotFoundError } from '../types/fs'
-import type { Author, CommandResult } from '../types'
-import { ProjectError } from '../errors'
 
 export class ProjectService {
   private currentAuthor: Author | null = null

package/core/services/skill-installer.ts

@@ -12,15 +12,14 @@
  * @version 1.0.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import os from 'os'
-import { promisify } from 'util'
-import { exec as execCallback } from 'child_process'
+import { exec as execCallback } from 'node:child_process'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+import { promisify } from 'node:util'
 import { glob } from 'glob'
-
-import { skillLock } from './skill-lock'
 import type { SkillLockEntry } from './skill-lock'
+import { skillLock } from './skill-lock'
 
 const exec = promisify(execCallback)
 
@@ -103,7 +102,9 @@ export function parseSource(source: string): ParsedSource {
     }
   }
 
-  throw new Error(`Invalid source format: "${source}". Expected "owner/repo", "owner/repo@skill-name", or "./local-path"`)
+  throw new Error(
+    `Invalid source format: "${source}". Expected "owner/repo", "owner/repo@skill-name", or "./local-path"`
+  )
 }
 
 // =============================================================================
@@ -131,7 +132,7 @@ async function discoverSkills(dir: string): Promise<Array<{ name: string; filePa
   for (const filePath of subdirSkills) {
     const name = path.basename(path.dirname(filePath))
     // Avoid duplicate if already found as root
-    if (!skills.some(s => s.name === name)) {
+    if (!skills.some((s) => s.name === name)) {
       skills.push({ name, filePath })
     }
   }
@@ -140,7 +141,7 @@ async function discoverSkills(dir: string): Promise<Array<{ name: string; filePa
   const nestedSkills = await glob('skills/*/SKILL.md', { cwd: dir, absolute: true })
   for (const filePath of nestedSkills) {
     const name = path.basename(path.dirname(filePath))
-    if (!skills.some(s => s.name === name)) {
+    if (!skills.some((s) => s.name === name)) {
       skills.push({ name, filePath })
     }
   }
@@ -155,11 +156,7 @@ async function discoverSkills(dir: string): Promise<Array<{ name: string; filePa
 /**
  * Add _prjct source tracking metadata to a skill's frontmatter
  */
-function injectSourceMetadata(
-  content: string,
-  source: ParsedSource,
-  sha?: string
-): string {
+function injectSourceMetadata(content: string, source: ParsedSource, sha?: string): string {
   const now = new Date().toISOString()
   const prjctBlock = [
     `_prjct:`,
@@ -181,7 +178,7 @@ function injectSourceMetadata(
     frontmatter = frontmatter.replace(/\n?_prjct:[\s\S]*?(?=\n[a-zA-Z]|\n---|\s*$)/g, '')
 
     // Append _prjct block
-    const updatedFrontmatter = frontmatter.trimEnd() + '\n' + prjctBlock.join('\n')
+    const updatedFrontmatter = `${frontmatter.trimEnd()}\n${prjctBlock.join('\n')}`
     return content.replace(frontmatterRegex, `---\n${updatedFrontmatter}\n---`)
   }
 
@@ -264,7 +261,7 @@ async function installFromGitHub(source: ParsedSource): Promise<InstallResult> {
 
     // Filter to specific skill if requested
     const skillsToInstall = source.skillName
-      ? discoveredSkills.filter(s => s.name === source.skillName)
+      ? discoveredSkills.filter((s) => s.name === source.skillName)
       : discoveredSkills
 
     if (source.skillName && skillsToInstall.length === 0) {

package/core/services/skill-lock.ts

@@ -9,9 +9,9 @@
  * @version 1.0.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import os from 'os'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
 
 // =============================================================================
 // Types

package/core/services/skill-service.ts

@@ -16,11 +16,11 @@
  * @version 1.1.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
+import fs from 'node:fs/promises'
+import path from 'node:path'
 import { glob } from 'glob'
 
-import type { SkillMetadata, Skill, SkillSearchResult } from '../types'
+import type { Skill, SkillMetadata, SkillSearchResult } from '../types'
 import type { AIProviderName } from '../types/provider'
 
 /**
@@ -46,7 +46,10 @@ function parseFrontmatter(content: string): { metadata: Record<string, unknown>;
 
       // Handle arrays [item1, item2]
       if (typeof value === 'string' && value.startsWith('[') && value.endsWith(']')) {
-        value = value.slice(1, -1).split(',').map(s => s.trim().replace(/['"]/g, ''))
+        value = value
+          .slice(1, -1)
+          .split(',')
+          .map((s) => s.trim().replace(/['"]/g, ''))
       }
       // Remove quotes
       else if (typeof value === 'string' && (value.startsWith('"') || value.startsWith("'"))) {
@@ -83,7 +86,10 @@ class SkillService {
   /**
    * Get all skill directories in order of priority
    */
-  private getSkillDirs(projectPath?: string, provider?: AIProviderName): Array<{ dir: string; source: Skill['source'] }> {
+  private getSkillDirs(
+    projectPath?: string,
+    provider?: AIProviderName
+  ): Array<{ dir: string; source: Skill['source'] }> {
     const homeDir = process.env.HOME || process.env.USERPROFILE || '~'
     const dirs: Array<{ dir: string; source: Skill['source'] }> = []
 
@@ -237,7 +243,7 @@ class SkillService {
       }
 
       // Tag match
-      if (skill.metadata.tags?.some(t => t.toLowerCase().includes(queryLower))) {
+      if (skill.metadata.tags?.some((t) => t.toLowerCase().includes(queryLower))) {
         relevance += 3
       }
 

package/core/services/stack-detector.ts

@@ -0,0 +1,245 @@
+/**
+ * StackDetector - Detects project technology stack
+ *
+ * Analyzes the project to detect:
+ * - Frontend frameworks (React, Vue, Svelte, Angular)
+ * - Backend frameworks (Express, Fastify, Hono, etc.)
+ * - Database usage (Prisma, Mongoose, etc.)
+ * - Docker configuration
+ * - Testing frameworks
+ */
+
+import fs from 'node:fs/promises'
+import path from 'node:path'
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface StackDetection {
+  hasFrontend: boolean
+  hasBackend: boolean
+  hasDatabase: boolean
+  hasDocker: boolean
+  hasTesting: boolean
+  frontendType: 'web' | 'mobile' | 'both' | null
+  frameworks: string[]
+}
+
+interface PackageJson {
+  dependencies?: Record<string, string>
+  devDependencies?: Record<string, string>
+}
+
+// ============================================================================
+// STACK DETECTOR
+// ============================================================================
+
+export class StackDetector {
+  private projectPath: string
+
+  constructor(projectPath: string) {
+    this.projectPath = projectPath
+  }
+
+  /**
+   * Detect the full technology stack of the project
+   */
+  async detect(): Promise<StackDetection> {
+    const stack: StackDetection = {
+      hasFrontend: false,
+      hasBackend: false,
+      hasDatabase: false,
+      hasDocker: false,
+      hasTesting: false,
+      frontendType: null,
+      frameworks: [],
+    }
+
+    // Try to read package.json for JS/TS projects
+    const pkg = await this.readPackageJson()
+
+    if (pkg) {
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies }
+
+      // Detect each category
+      this.detectFrontend(deps, stack)
+      this.detectBackend(deps, stack)
+      this.detectDatabase(deps, stack)
+      this.detectTesting(deps, pkg, stack)
+      this.collectFrameworks(deps, stack)
+    }
+
+    // Docker detection (file-based)
+    stack.hasDocker = await this.detectDocker()
+
+    return stack
+  }
+
+  // ==========================================================================
+  // DETECTION METHODS
+  // ==========================================================================
+
+  /**
+   * Detect frontend frameworks and type (web/mobile/both)
+   */
+  private detectFrontend(deps: Record<string, string>, stack: StackDetection): void {
+    // Web frameworks
+    if (deps.react || deps.vue || deps.svelte || deps['@angular/core']) {
+      stack.hasFrontend = true
+      stack.frontendType = 'web'
+    }
+
+    // Mobile frameworks
+    if (deps['react-native'] || deps.expo) {
+      stack.hasFrontend = true
+      stack.frontendType = stack.frontendType === 'web' ? 'both' : 'mobile'
+    }
+  }
+
+  /**
+   * Detect backend frameworks
+   */
+  private detectBackend(deps: Record<string, string>, stack: StackDetection): void {
+    const backendFrameworks = [
+      'express',
+      'fastify',
+      'hono',
+      'koa',
+      '@nestjs/core',
+      'nest',
+      '@hapi/hapi',
+      'restify',
+      'polka',
+    ]
+
+    if (backendFrameworks.some((fw) => deps[fw])) {
+      stack.hasBackend = true
+    }
+  }
+
+  /**
+   * Detect database/ORM usage
+   */
+  private detectDatabase(deps: Record<string, string>, stack: StackDetection): void {
+    const databaseLibs = [
+      'prisma',
+      '@prisma/client',
+      'mongoose',
+      'pg',
+      'mysql2',
+      'sequelize',
+      'typeorm',
+      'drizzle-orm',
+      'knex',
+      'better-sqlite3',
+      'mongodb',
+      'redis',
+      'ioredis',
+    ]
+
+    if (databaseLibs.some((lib) => deps[lib])) {
+      stack.hasDatabase = true
+    }
+  }
+
+  /**
+   * Detect testing frameworks
+   */
+  private detectTesting(
+    deps: Record<string, string>,
+    pkg: PackageJson,
+    stack: StackDetection
+  ): void {
+    const testingFrameworks = [
+      'jest',
+      'vitest',
+      'mocha',
+      '@testing-library/react',
+      '@testing-library/vue',
+      'cypress',
+      'playwright',
+      '@playwright/test',
+      'ava',
+      'tap',
+      'bun-types', // Bun's built-in test runner
+    ]
+
+    if (testingFrameworks.some((fw) => deps[fw] || pkg.devDependencies?.[fw])) {
+      stack.hasTesting = true
+    }
+  }
+
+  /**
+   * Detect Docker configuration
+   */
+  private async detectDocker(): Promise<boolean> {
+    const dockerFiles = ['Dockerfile', 'docker-compose.yml', 'docker-compose.yaml', '.dockerignore']
+
+    for (const file of dockerFiles) {
+      if (await this.fileExists(file)) {
+        return true
+      }
+    }
+
+    return false
+  }
+
+  /**
+   * Collect detected frameworks into the frameworks array
+   */
+  private collectFrameworks(deps: Record<string, string>, stack: StackDetection): void {
+    // Frontend frameworks
+    if (deps.react) stack.frameworks.push('React')
+    if (deps.next) stack.frameworks.push('Next.js')
+    if (deps.vue) stack.frameworks.push('Vue')
+    if (deps.nuxt) stack.frameworks.push('Nuxt')
+    if (deps.svelte) stack.frameworks.push('Svelte')
+    if (deps['@angular/core']) stack.frameworks.push('Angular')
+    if (deps['react-native']) stack.frameworks.push('React Native')
+    if (deps.expo) stack.frameworks.push('Expo')
+
+    // Backend frameworks
+    if (deps.express) stack.frameworks.push('Express')
+    if (deps.fastify) stack.frameworks.push('Fastify')
+    if (deps.hono) stack.frameworks.push('Hono')
+    if (deps.koa) stack.frameworks.push('Koa')
+    if (deps['@nestjs/core'] || deps.nest) stack.frameworks.push('NestJS')
+
+    // Meta-frameworks
+    if (deps.astro) stack.frameworks.push('Astro')
+    if (deps.remix) stack.frameworks.push('Remix')
+    if (deps.gatsby) stack.frameworks.push('Gatsby')
+  }
+
+  // ==========================================================================
+  // HELPERS
+  // ==========================================================================
+
+  /**
+   * Read and parse package.json
+   */
+  private async readPackageJson(): Promise<PackageJson | null> {
+    try {
+      const pkgPath = path.join(this.projectPath, 'package.json')
+      const content = await fs.readFile(pkgPath, 'utf-8')
+      return JSON.parse(content)
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * Check if a file exists in the project
+   */
+  private async fileExists(filename: string): Promise<boolean> {
+    try {
+      await fs.access(path.join(this.projectPath, filename))
+      return true
+    } catch {
+      return false
+    }
+  }
+}
+
+export default StackDetector