prjct-cli 1.22.0 → 1.24.0

package/core/services/skill-service.ts

@@ -1,306 +0,0 @@
-/**
- * Skill Service
- *
- * Manages discoverable skills from SKILL.md files.
- * Skills are reusable prompts/instructions with metadata.
- *
- * Skill sources (in priority order):
- * 1. Project: .prjct/skills/*.md
- * 2. Provider: ~/.claude/skills/* or ~/.gemini/skills/* (SKILL.md format)
- * 3. Global: ~/.prjct-cli/skills/*.md
- * 4. Built-in: templates/skills/*.md
- *
- * Note: Claude Code and Gemini CLI use identical SKILL.md format,
- * so skills are compatible between both providers.
- *
- * @version 1.1.0
- */
-
-import fs from 'node:fs/promises'
-import path from 'node:path'
-import { glob } from 'glob'
-
-import type { Skill, SkillMetadata, SkillSearchResult } from '../types'
-import type { AIProviderName } from '../types/provider'
-
-/**
- * Parse YAML-like frontmatter from markdown
- */
-function parseFrontmatter(content: string): { metadata: Record<string, unknown>; body: string } {
-  const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/
-  const match = content.match(frontmatterRegex)
-
-  if (!match) {
-    return { metadata: {}, body: content }
-  }
-
-  const [, frontmatter, body] = match
-  const metadata: Record<string, unknown> = {}
-
-  // Simple YAML parsing (key: value)
-  for (const line of frontmatter.split('\n')) {
-    const colonIndex = line.indexOf(':')
-    if (colonIndex > 0) {
-      const key = line.slice(0, colonIndex).trim()
-      let value: unknown = line.slice(colonIndex + 1).trim()
-
-      // Handle arrays [item1, item2]
-      if (typeof value === 'string' && value.startsWith('[') && value.endsWith(']')) {
-        value = value
-          .slice(1, -1)
-          .split(',')
-          .map((s) => s.trim().replace(/['"]/g, ''))
-      }
-      // Remove quotes
-      else if (typeof value === 'string' && (value.startsWith('"') || value.startsWith("'"))) {
-        value = value.slice(1, -1)
-      }
-
-      metadata[key] = value
-    }
-  }
-
-  return { metadata, body: body.trim() }
-}
-
-/**
- * Convert filename to skill ID
- * For SKILL.md files, uses the parent directory name
- */
-function fileToSkillId(filePath: string): string {
-  const basename = path.basename(filePath, '.md')
-
-  // For SKILL.md files (provider format), use parent directory name
-  if (basename.toUpperCase() === 'SKILL') {
-    const dirName = path.basename(path.dirname(filePath))
-    return dirName.toLowerCase().replace(/[^a-z0-9]+/g, '-')
-  }
-
-  return basename.toLowerCase().replace(/[^a-z0-9]+/g, '-')
-}
-
-class SkillService {
-  private skills: Map<string, Skill> = new Map()
-  private loaded = false
-
-  /**
-   * Get all skill directories in order of priority
-   */
-  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'] }> = []
-
-    // Project skills (highest priority)
-    if (projectPath) {
-      dirs.push({ dir: path.join(projectPath, '.prjct', 'skills'), source: 'project' })
-    }
-
-    // Provider skills (Claude or Gemini)
-    // Both use SKILL.md format, so skills are compatible
-    if (provider) {
-      const providerDir = provider === 'gemini' ? '.gemini' : '.claude'
-      dirs.push({ dir: path.join(homeDir, providerDir, 'skills'), source: 'global' })
-    } else {
-      // Check both providers if no specific one is set
-      dirs.push({ dir: path.join(homeDir, '.claude', 'skills'), source: 'global' })
-      dirs.push({ dir: path.join(homeDir, '.gemini', 'skills'), source: 'global' })
-    }
-
-    // prjct global skills
-    dirs.push({ dir: path.join(homeDir, '.prjct-cli', 'skills'), source: 'global' })
-
-    // Built-in skills (lowest priority)
-    dirs.push({ dir: path.join(__dirname, '..', '..', 'templates', 'skills'), source: 'builtin' })
-
-    return dirs
-  }
-
-  /**
-   * Load a single skill from file
-   */
-  private async loadSkill(filePath: string, source: Skill['source']): Promise<Skill | null> {
-    try {
-      const content = await fs.readFile(filePath, 'utf-8')
-      const { metadata, body } = parseFrontmatter(content)
-
-      const id = fileToSkillId(filePath)
-      const name = (metadata.name as string) || id
-
-      // Extract _prjct source tracking metadata if present
-      const prjctMeta = metadata._prjct as Record<string, unknown> | undefined
-
-      return {
-        id,
-        name,
-        description: (metadata.description as string) || '',
-        content: body,
-        source,
-        filePath,
-        metadata: {
-          name,
-          description: metadata.description as string,
-          agent: metadata.agent as string,
-          tags: metadata.tags as string[],
-          version: metadata.version as string,
-          category: metadata.category as string,
-          author: metadata.author as string,
-          sourceUrl: prjctMeta?.sourceUrl as string,
-          sourceType: prjctMeta?.sourceType as SkillMetadata['sourceType'],
-          installedAt: prjctMeta?.installedAt as string,
-          sha: prjctMeta?.sha as string,
-        },
-      }
-    } catch (_error) {
-      // File read or parse error - expected for missing skills
-      return null
-    }
-  }
-
-  /**
-   * Load all skills from all sources
-   */
-  async loadSkills(projectPath?: string, provider?: AIProviderName): Promise<void> {
-    this.skills.clear()
-    const dirs = this.getSkillDirs(projectPath, provider)
-
-    for (const { dir, source } of dirs) {
-      try {
-        // Check both patterns in ALL skill directories:
-        // 1. Flat files: {dir}/{name}.md
-        // 2. Subdirectories: {dir}/{name}/SKILL.md (ecosystem standard)
-        const flatFiles = await glob('*.md', { cwd: dir, absolute: true })
-        const subdirFiles = await glob('*/SKILL.md', { cwd: dir, absolute: true })
-
-        // Load subdirectory skills first (ecosystem standard takes priority within same dir)
-        for (const file of subdirFiles) {
-          const skill = await this.loadSkill(file, source)
-          if (skill && !this.skills.has(skill.id)) {
-            this.skills.set(skill.id, skill)
-          }
-        }
-
-        // Then flat files (don't override subdirectory version)
-        for (const file of flatFiles) {
-          const skill = await this.loadSkill(file, source)
-          if (skill && !this.skills.has(skill.id)) {
-            this.skills.set(skill.id, skill)
-          }
-        }
-      } catch (_error) {
-        // Directory doesn't exist - expected for new installs
-      }
-    }
-
-    this.loaded = true
-  }
-
-  /**
-   * Get all loaded skills
-   */
-  async getAll(projectPath?: string): Promise<Skill[]> {
-    if (!this.loaded) {
-      await this.loadSkills(projectPath)
-    }
-    return Array.from(this.skills.values())
-  }
-
-  /**
-   * Get a skill by ID
-   */
-  async get(id: string, projectPath?: string): Promise<Skill | null> {
-    if (!this.loaded) {
-      await this.loadSkills(projectPath)
-    }
-    return this.skills.get(id) || null
-  }
-
-  /**
-   * Search skills by query
-   */
-  async search(query: string, projectPath?: string): Promise<SkillSearchResult[]> {
-    const skills = await this.getAll(projectPath)
-    const queryLower = query.toLowerCase()
-
-    const results: SkillSearchResult[] = []
-
-    for (const skill of skills) {
-      let relevance = 0
-
-      // Name match (highest weight)
-      if (skill.name.toLowerCase().includes(queryLower)) {
-        relevance += 10
-      }
-      if (skill.id.includes(queryLower)) {
-        relevance += 8
-      }
-
-      // Description match
-      if (skill.description.toLowerCase().includes(queryLower)) {
-        relevance += 5
-      }
-
-      // Tag match
-      if (skill.metadata.tags?.some((t) => t.toLowerCase().includes(queryLower))) {
-        relevance += 3
-      }
-
-      // Content match (lowest weight)
-      if (skill.content.toLowerCase().includes(queryLower)) {
-        relevance += 1
-      }
-
-      if (relevance > 0) {
-        results.push({ skill, relevance })
-      }
-    }
-
-    // Sort by relevance descending
-    return results.sort((a, b) => b.relevance - a.relevance)
-  }
-
-  /**
-   * List skills grouped by source
-   */
-  async listBySource(projectPath?: string): Promise<Record<Skill['source'], Skill[]>> {
-    const skills = await this.getAll(projectPath)
-
-    const grouped: Record<Skill['source'], Skill[]> = {
-      project: [],
-      global: [],
-      builtin: [],
-      remote: [],
-    }
-
-    for (const skill of skills) {
-      grouped[skill.source].push(skill)
-    }
-
-    return grouped
-  }
-
-  /**
-   * Force reload skills
-   */
-  async reload(projectPath?: string): Promise<void> {
-    this.loaded = false
-    await this.loadSkills(projectPath)
-  }
-
-  /**
-   * Get skill count
-   */
-  async count(projectPath?: string): Promise<number> {
-    const skills = await this.getAll(projectPath)
-    return skills.length
-  }
-}
-
-// Singleton instance
-const skillService = new SkillService()
-export default skillService
-
-// Export class for testing
-export { SkillService }

package/core/services/stack-detector.ts

@@ -1,229 +0,0 @@
-/**
- * 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'
-import type { StackDetection, StackPackageJson } from '../types'
-
-export type { StackDetection, StackPackageJson } from '../types'
-
-// ============================================================================
-// 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: StackPackageJson,
-    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<StackPackageJson | 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