prjct-cli 1.21.0 → 1.23.0

package/core/ai-tools/formatters.ts

@@ -1,341 +0,0 @@
-/**
- * AI Tool Formatters
- *
- * Each AI tool has different context preferences:
- * - Claude Code: Detailed markdown with sections
- * - Cursor: Concise rules format
- * - Copilot: Minimal bullet points
- * - Windsurf: Similar to Cursor
- */
-
-import { type ContextSources, cite, defaultSources } from '../utils/citations'
-import type { AIToolConfig } from './registry'
-
-export interface ProjectContext {
-  projectId: string
-  name: string
-  version: string
-  ecosystem: string
-  projectType: string
-  languages: string[]
-  frameworks: string[]
-  repoPath: string
-  branch: string
-  fileCount: number
-  commits: number
-  hasChanges: boolean
-  commands: {
-    install: string
-    dev: string
-    test: string
-    build: string
-    lint: string
-    format: string
-  }
-  agents: {
-    workflow: string[]
-    domain: string[]
-  }
-  sources?: ContextSources
-}
-
-/**
- * Format context for Claude Code (CLAUDE.md)
- * Detailed markdown with full context
- */
-export function formatForClaude(ctx: ProjectContext, _config: AIToolConfig): string {
-  const s = ctx.sources || defaultSources()
-
-  return `# ${ctx.name} - Project Rules
-<!-- projectId: ${ctx.projectId} -->
-<!-- Generated: ${new Date().toISOString()} -->
-<!-- Ecosystem: ${ctx.ecosystem} | Type: ${ctx.projectType} -->
-
-## THIS PROJECT (${ctx.ecosystem})
-
-${cite(s.ecosystem)}
-**Type:** ${ctx.projectType}
-**Path:** ${ctx.repoPath}
-
-### Commands (USE THESE, NOT OTHERS)
-
-${cite(s.commands)}
-| Action | Command |
-|--------|---------|
-| Install dependencies | \`${ctx.commands.install}\` |
-| Run dev server | \`${ctx.commands.dev}\` |
-| Run tests | \`${ctx.commands.test}\` |
-| Build | \`${ctx.commands.build}\` |
-| Lint | \`${ctx.commands.lint}\` |
-| Format | \`${ctx.commands.format}\` |
-
-### Code Conventions
-
-${cite(s.languages)}
-- **Languages**: ${ctx.languages.join(', ') || 'Not detected'}
-${cite(s.frameworks)}
-- **Frameworks**: ${ctx.frameworks.join(', ') || 'Not detected'}
-
----
-
-## PRJCT RULES
-
-### Path Resolution
-**ALL prjct writes go to**: \`~/.prjct-cli/projects/${ctx.projectId}/\`
-- NEVER write to \`.prjct/\`
-- NEVER write to \`./\` for prjct data
-
-### Workflow
-\`\`\`
-p. sync → p. task "desc" → [work] → p. done → p. ship
-\`\`\`
-
-| Command | Action |
-|---------|--------|
-| \`p. sync\` | Re-analyze project |
-| \`p. task X\` | Start task |
-| \`p. done\` | Complete subtask |
-| \`p. ship X\` | Ship feature |
-
----
-
-## PROJECT STATE
-
-${cite(s.name)}
-| Field | Value |
-|-------|-------|
-| Name | ${ctx.name} |
-| Version | ${ctx.version} |
-| Ecosystem | ${ctx.ecosystem} |
-| Branch | ${ctx.branch} |
-| Files | ~${ctx.fileCount} |
-| Commits | ${ctx.commits} |
-
----
-
-## AGENTS
-
-Load from \`~/.prjct-cli/projects/${ctx.projectId}/agents/\`:
-
-**Workflow**: ${ctx.agents.workflow.join(', ')}
-**Domain**: ${ctx.agents.domain.join(', ') || 'none'}
-`
-}
-
-/**
- * Format context for Cursor (.cursor/rules/prjct.mdc)
- * MDC format with YAML frontmatter, optimized for inline suggestions
- *
- * @see https://cursor.com/docs/context/rules
- */
-export function formatForCursor(ctx: ProjectContext, _config: AIToolConfig): string {
-  const s = ctx.sources || defaultSources()
-  const lines: string[] = []
-
-  // MDC format with YAML frontmatter
-  lines.push('---')
-  lines.push(`description: prjct context for ${ctx.name}`)
-  lines.push('globs:')
-  lines.push('alwaysApply: true')
-  lines.push('---')
-  lines.push('')
-
-  // Project identity
-  lines.push(`You are working on ${ctx.name}, a ${ctx.projectType} ${ctx.ecosystem} project.`)
-  lines.push('')
-
-  // Tech stack
-  lines.push(cite(s.languages))
-  lines.push('## Tech Stack')
-  if (ctx.languages.length > 0) {
-    lines.push(`- Languages: ${ctx.languages.join(', ')}`)
-  }
-  if (ctx.frameworks.length > 0) {
-    lines.push(`- Frameworks: ${ctx.frameworks.join(', ')}`)
-  }
-  lines.push('')
-
-  // Commands
-  lines.push(cite(s.commands))
-  lines.push('## Commands')
-  lines.push(`- Install: \`${ctx.commands.install}\``)
-  lines.push(`- Dev: \`${ctx.commands.dev}\``)
-  lines.push(`- Test: \`${ctx.commands.test}\``)
-  lines.push(`- Build: \`${ctx.commands.build}\``)
-  lines.push('')
-
-  // Code style - language agnostic
-  lines.push('## Code Style')
-  lines.push(`- Follow ${ctx.ecosystem} conventions`)
-  lines.push('- Match existing code patterns in this project')
-  lines.push('- Use idiomatic constructs for the language')
-  lines.push('')
-
-  // Best practices
-  lines.push('## Best Practices')
-  lines.push('- Write clean, readable code')
-  lines.push('- Add comments only for complex logic')
-  lines.push('- Keep functions small and focused')
-  lines.push('- Handle errors appropriately')
-  lines.push('- Write tests for new functionality')
-
-  return lines.join('\n')
-}
-
-/**
- * Format context for GitHub Copilot (.github/copilot-instructions.md)
- * Minimal bullet points
- */
-export function formatForCopilot(ctx: ProjectContext, _config: AIToolConfig): string {
-  const s = ctx.sources || defaultSources()
-  const lines: string[] = []
-
-  lines.push('# Copilot Instructions')
-  lines.push('')
-  lines.push(`This is ${ctx.name}, a ${ctx.ecosystem} project.`)
-  lines.push('')
-
-  // Key info
-  lines.push(cite(s.ecosystem))
-  lines.push('## Project Info')
-  lines.push(`- Type: ${ctx.projectType}`)
-  lines.push(`- Stack: ${ctx.frameworks.join(', ') || ctx.ecosystem}`)
-  lines.push('')
-
-  // Conventions
-  lines.push('## Conventions')
-  lines.push(`- Follow ${ctx.ecosystem} conventions`)
-  lines.push('- Match existing code patterns')
-  lines.push('- Keep code clean and readable')
-  lines.push('')
-
-  // Commands
-  lines.push(cite(s.commands))
-  lines.push('## Commands')
-  lines.push(`- Test: \`${ctx.commands.test}\``)
-  lines.push(`- Build: \`${ctx.commands.build}\``)
-
-  return lines.join('\n')
-}
-
-/**
- * Format context for Windsurf (.windsurf/rules/prjct.md)
- * MD format with YAML frontmatter, optimized for Cascade AI
- *
- * @see https://docs.windsurf.com/windsurf/cascade/memories
- */
-export function formatForWindsurf(ctx: ProjectContext, _config: AIToolConfig): string {
-  const s = ctx.sources || defaultSources()
-  const lines: string[] = []
-
-  // YAML frontmatter (Windsurf uses trigger: always_on instead of alwaysApply)
-  lines.push('---')
-  lines.push(`description: prjct context for ${ctx.name}`)
-  lines.push('trigger: always_on')
-  lines.push('---')
-  lines.push('')
-
-  // Project identity
-  lines.push(`# ${ctx.name}`)
-  lines.push('')
-  lines.push(`${ctx.projectType} project using ${ctx.ecosystem}.`)
-  lines.push('')
-
-  // Tech stack (concise)
-  lines.push(cite(s.languages))
-  lines.push('## Stack')
-  lines.push(`- ${ctx.languages.join(', ')}`)
-  if (ctx.frameworks.length > 0) {
-    lines.push(`- ${ctx.frameworks.join(', ')}`)
-  }
-  lines.push('')
-
-  // Commands (essential only)
-  lines.push(cite(s.commands))
-  lines.push('## Commands')
-  lines.push('```bash')
-  lines.push(`# Install`)
-  lines.push(ctx.commands.install)
-  lines.push(`# Dev`)
-  lines.push(ctx.commands.dev)
-  lines.push(`# Test`)
-  lines.push(ctx.commands.test)
-  lines.push(`# Build`)
-  lines.push(ctx.commands.build)
-  lines.push('```')
-  lines.push('')
-
-  // Code style - language agnostic
-  lines.push('## Rules')
-  lines.push(`- Follow ${ctx.ecosystem} conventions`)
-  lines.push('- Match existing project patterns')
-  lines.push('- Clean code, minimal comments')
-  lines.push('- Test new functionality')
-
-  return lines.join('\n')
-}
-
-/**
- * Format context for Continue.dev (.continue/config.json)
- * JSON config with system message and context providers
- */
-export function formatForContinue(ctx: ProjectContext, _config: AIToolConfig): string {
-  const systemMessage = [
-    `You are working on ${ctx.name}, a ${ctx.projectType} ${ctx.ecosystem} project.`,
-    '',
-    `Stack: ${ctx.languages.join(', ')}${ctx.frameworks.length > 0 ? ` with ${ctx.frameworks.join(', ')}` : ''}`,
-    '',
-    'Commands:',
-    `- Install: ${ctx.commands.install}`,
-    `- Dev: ${ctx.commands.dev}`,
-    `- Test: ${ctx.commands.test}`,
-    `- Build: ${ctx.commands.build}`,
-    '',
-    `Follow ${ctx.ecosystem} conventions. Match existing code patterns.`,
-  ].join('\n')
-
-  const continueConfig = {
-    systemMessage,
-    models: [],
-    contextProviders: [
-      { name: 'code' },
-      { name: 'docs' },
-      { name: 'diff' },
-      { name: 'terminal' },
-      { name: 'problems' },
-      { name: 'folder' },
-      { name: 'codebase' },
-    ],
-    slashCommands: [
-      { name: 'edit', description: 'Edit selected code' },
-      { name: 'comment', description: 'Add comments to code' },
-      { name: 'share', description: 'Export conversation' },
-      { name: 'cmd', description: 'Run terminal command' },
-    ],
-    customCommands: [
-      {
-        name: 'test',
-        prompt: `Write tests for the selected code. Use the project's testing conventions. Test command: ${ctx.commands.test}`,
-      },
-    ],
-  }
-
-  return JSON.stringify(continueConfig, null, 2)
-}
-
-/**
- * Get formatter function for a tool
- */
-export function getFormatter(
-  toolId: string
-): ((ctx: ProjectContext, config: AIToolConfig) => string) | null {
-  const formatters: Record<string, (ctx: ProjectContext, config: AIToolConfig) => string> = {
-    claude: formatForClaude,
-    cursor: formatForCursor,
-    copilot: formatForCopilot,
-    windsurf: formatForWindsurf,
-    continue: formatForContinue,
-  }
-
-  return formatters[toolId] || null
-}

package/core/ai-tools/generator.ts

@@ -1,144 +0,0 @@
-/**
- * AI Tools Context Generator
- *
- * Generates optimized context files for each AI coding tool.
- * Each tool gets context in its preferred format.
- */
-
-import fs from 'node:fs/promises'
-import path from 'node:path'
-import { getErrorMessage } from '../types/fs'
-import { mergePreservedSections, validatePreserveBlocks } from '../utils/preserve-sections'
-import { getFormatter, type ProjectContext } from './formatters'
-import { AI_TOOLS, type AIToolConfig, DEFAULT_AI_TOOLS, getAIToolConfig } from './registry'
-
-export interface GenerateResult {
-  toolId: string
-  outputFile: string
-  outputPath: string
-  success: boolean
-  error?: string
-}
-
-/**
- * Generate context files for specified AI tools
- */
-export async function generateAIToolContexts(
-  context: ProjectContext,
-  globalPath: string,
-  repoPath: string,
-  toolIds: string[] = DEFAULT_AI_TOOLS
-): Promise<GenerateResult[]> {
-  const results: GenerateResult[] = []
-
-  for (const toolId of toolIds) {
-    const config = getAIToolConfig(toolId)
-    if (!config) {
-      results.push({
-        toolId,
-        outputFile: '',
-        outputPath: '',
-        success: false,
-        error: `Unknown tool: ${toolId}`,
-      })
-      continue
-    }
-
-    const result = await generateForTool(context, config, globalPath, repoPath)
-    results.push(result)
-  }
-
-  return results
-}
-
-/**
- * Generate context for a single AI tool
- */
-async function generateForTool(
-  context: ProjectContext,
-  config: AIToolConfig,
-  globalPath: string,
-  repoPath: string
-): Promise<GenerateResult> {
-  const formatter = getFormatter(config.id)
-  if (!formatter) {
-    return {
-      toolId: config.id,
-      outputFile: config.outputFile,
-      outputPath: '',
-      success: false,
-      error: `No formatter for: ${config.id}`,
-    }
-  }
-
-  try {
-    // Generate content
-    let content = formatter(context, config)
-
-    // Determine output path
-    let outputPath: string
-    if (config.outputPath === 'repo') {
-      outputPath = path.join(repoPath, config.outputFile)
-    } else {
-      outputPath = path.join(globalPath, 'context', config.outputFile)
-    }
-
-    // Ensure directory exists
-    await fs.mkdir(path.dirname(outputPath), { recursive: true })
-
-    // Read existing file to preserve user customizations
-    try {
-      const existingContent = await fs.readFile(outputPath, 'utf-8')
-
-      // Validate existing preserved blocks
-      const validation = validatePreserveBlocks(existingContent)
-      if (!validation.valid) {
-        console.warn(`⚠️  ${config.outputFile} has invalid preserve blocks:`)
-        for (const error of validation.errors) {
-          console.warn(`   ${error}`)
-        }
-      }
-
-      content = mergePreservedSections(content, existingContent)
-    } catch {
-      // File doesn't exist yet - use generated content as-is
-    }
-
-    // Write file
-    await fs.writeFile(outputPath, content, 'utf-8')
-
-    return {
-      toolId: config.id,
-      outputFile: config.outputFile,
-      outputPath,
-      success: true,
-    }
-  } catch (error) {
-    return {
-      toolId: config.id,
-      outputFile: config.outputFile,
-      outputPath: '',
-      success: false,
-      error: getErrorMessage(error),
-    }
-  }
-}
-
-/**
- * Get list of files that would be generated
- */
-export function getOutputFiles(
-  toolIds: string[] = DEFAULT_AI_TOOLS
-): { toolId: string; file: string; location: 'repo' | 'global' }[] {
-  return toolIds
-    .map((id) => {
-      const config = AI_TOOLS[id]
-      if (!config) return null
-      return {
-        toolId: id,
-        file: config.outputFile,
-        location: config.outputPath,
-      }
-    })
-    .filter((item): item is NonNullable<typeof item> => item !== null)
-}

package/core/ai-tools/index.ts

@@ -1,15 +0,0 @@
-/**
- * AI Tools Module
- *
- * Multi-agent context generation for AI coding tools.
- * Supports: Claude Code, Cursor, Copilot, Windsurf, Continue.dev
- *
- * Features:
- * - Auto-detection of installed tools
- * - Language-agnostic formatters
- * - Tool-specific output formats
- */
-
-export * from './formatters'
-export * from './generator'
-export * from './registry'

package/core/ai-tools/registry.ts

@@ -1,201 +0,0 @@
-/**
- * AI Tools Registry
- *
- * Registry of AI coding tools (Claude Code, Cursor, Copilot, etc.)
- * Each tool has its own context file format and token budget.
- *
- * Phase 1: Claude Code + Cursor
- * Phase 2: + Copilot + Windsurf
- * Phase 3: + Continue.dev + Auto-detection
- */
-
-import { exec } from 'node:child_process'
-import os from 'node:os'
-import path from 'node:path'
-import { promisify } from 'node:util'
-import type { AIToolConfig } from '../types'
-import { fileExists } from '../utils/fs-helpers'
-
-const execAsync = promisify(exec)
-
-export type { AIToolConfig } from '../types'
-
-/**
- * Supported AI tools registry
- */
-export const AI_TOOLS: Record<string, AIToolConfig> = {
-  claude: {
-    id: 'claude',
-    name: 'Claude Code',
-    outputFile: 'CLAUDE.md',
-    outputPath: 'global',
-    maxTokens: 6000,
-    format: 'detailed',
-    description: 'Anthropic Claude Code CLI',
-  },
-  cursor: {
-    id: 'cursor',
-    name: 'Cursor',
-    outputFile: '.cursor/rules/prjct.mdc',
-    outputPath: 'repo',
-    maxTokens: 2000,
-    format: 'concise',
-    description: 'Cursor AI Editor',
-  },
-  copilot: {
-    id: 'copilot',
-    name: 'GitHub Copilot',
-    outputFile: '.github/copilot-instructions.md',
-    outputPath: 'repo',
-    maxTokens: 1500,
-    format: 'minimal',
-    description: 'GitHub Copilot',
-  },
-  windsurf: {
-    id: 'windsurf',
-    name: 'Windsurf',
-    outputFile: '.windsurf/rules/prjct.md',
-    outputPath: 'repo',
-    maxTokens: 2000,
-    format: 'concise',
-    description: 'Codeium Windsurf Editor',
-  },
-  continue: {
-    id: 'continue',
-    name: 'Continue.dev',
-    outputFile: '.continue/config.json',
-    outputPath: 'repo',
-    maxTokens: 1500,
-    format: 'json',
-    description: 'Continue.dev open-source AI assistant',
-  },
-}
-
-/**
- * Default tools to generate
- * CLI tools only - IDE tools (cursor, windsurf, copilot) are OPT-IN
- * Use --editors flag or "all" to include IDE tools
- */
-export const DEFAULT_AI_TOOLS = ['claude']
-
-/**
- * IDE tools - require explicit opt-in (--editors flag)
- */
-export const IDE_AI_TOOLS = ['cursor', 'windsurf', 'copilot', 'continue']
-
-/**
- * All supported tool IDs
- */
-export const SUPPORTED_AI_TOOLS = Object.keys(AI_TOOLS)
-
-/**
- * Get tool config by ID
- */
-export function getAIToolConfig(id: string): AIToolConfig | null {
-  return AI_TOOLS[id] || null
-}
-
-/**
- * Parse --agents flag value
- * Examples: "claude,cursor" or "all"
- */
-export function parseAgentsFlag(value: string): string[] {
-  if (value === 'all') {
-    return SUPPORTED_AI_TOOLS
-  }
-
-  const requested = value.split(',').map((s) => s.trim().toLowerCase())
-  return requested.filter((id) => AI_TOOLS[id])
-}
-
-/**
- * Validate tool IDs
- */
-export function validateToolIds(ids: string[]): { valid: string[]; invalid: string[] } {
-  const valid: string[] = []
-  const invalid: string[] = []
-
-  for (const id of ids) {
-    if (AI_TOOLS[id]) {
-      valid.push(id)
-    } else {
-      invalid.push(id)
-    }
-  }
-
-  return { valid, invalid }
-}
-
-/**
- * Check if a command exists in PATH
- */
-async function commandExists(cmd: string): Promise<boolean> {
-  try {
-    await execAsync(`which ${cmd}`)
-    return true
-  } catch {
-    return false
-  }
-}
-
-/**
- * Detect installed AI tools
- * Returns list of tool IDs that are detected on the system
- */
-export async function detectInstalledTools(repoPath: string = process.cwd()): Promise<string[]> {
-  const detected: string[] = []
-
-  // Claude Code: check for 'claude' command
-  if (await commandExists('claude')) {
-    detected.push('claude')
-  }
-
-  // Cursor: check for command or .cursor/ directory in repo
-  if ((await commandExists('cursor')) || (await fileExists(path.join(repoPath, '.cursor')))) {
-    detected.push('cursor')
-  }
-
-  // Copilot: check for .github/ directory (likely has Copilot if using GitHub)
-  if (await fileExists(path.join(repoPath, '.github'))) {
-    detected.push('copilot')
-  }
-
-  // Windsurf: check for command or .windsurf/ directory
-  if ((await commandExists('windsurf')) || (await fileExists(path.join(repoPath, '.windsurf')))) {
-    detected.push('windsurf')
-  }
-
-  // Continue.dev: check for .continue/ directory
-  if (
-    (await fileExists(path.join(repoPath, '.continue'))) ||
-    (await fileExists(path.join(os.homedir(), '.continue')))
-  ) {
-    detected.push('continue')
-  }
-
-  return detected
-}
-
-/**
- * Get tools to generate based on mode
- * - 'auto': detect installed tools
- * - 'all': all supported tools
- * - specific: use provided list
- */
-export async function resolveToolIds(
-  mode: 'auto' | 'all' | string[],
-  repoPath: string = process.cwd()
-): Promise<string[]> {
-  if (mode === 'auto') {
-    const detected = await detectInstalledTools(repoPath)
-    // Always include claude if nothing detected (safe default)
-    return detected.length > 0 ? detected : ['claude']
-  }
-
-  if (mode === 'all') {
-    return SUPPORTED_AI_TOOLS
-  }
-
-  // Specific list provided
-  return mode.filter((id) => AI_TOOLS[id])
-}