prjct-cli 0.37.0 → 0.39.0

package/core/infrastructure/setup.ts

@@ -29,7 +29,9 @@ import {
   selectProvider,
   detectProvider,
   detectAllProviders,
+  detectAntigravity,
   Providers,
+  AntigravityProvider,
 } from './ai-provider'
 import type { AIProviderName, AIProviderConfig } from '../types/provider'
 
@@ -185,6 +187,15 @@ export async function run(): Promise<SetupResults> {
     results.providers.push(providerResult)
   }
 
+  // Step 2b: Install for Antigravity if detected (separate from CLI providers)
+  const antigravityDetection = detectAntigravity()
+  if (antigravityDetection.installed) {
+    const antigravityResult = await installAntigravitySkill()
+    if (antigravityResult.success) {
+      console.log(`   ${GREEN}✓${NC} Antigravity skill installed`)
+    }
+  }
+
   // Step 3: Save version in editors-config
   await editorsConfig.saveConfig(VERSION, installer.getInstallPath(), selection.provider)
 
@@ -296,6 +307,55 @@ async function installGeminiGlobalConfig(): Promise<{ success: boolean; action:
   }
 }
 
+// =============================================================================
+// Antigravity Installation (Skills-based)
+// =============================================================================
+
+/**
+ * Install prjct as a skill for Google Antigravity
+ *
+ * Antigravity uses SKILL.md files in ~/.gemini/antigravity/skills/
+ * This is the recommended integration method (not MCP).
+ */
+export async function installAntigravitySkill(): Promise<{ success: boolean; action: string | null }> {
+  try {
+    const antigravitySkillsDir = path.join(os.homedir(), '.gemini', 'antigravity', 'skills')
+    const prjctSkillDir = path.join(antigravitySkillsDir, 'prjct')
+    const skillMdPath = path.join(prjctSkillDir, 'SKILL.md')
+    const templatePath = path.join(getPackageRoot(), 'templates', 'antigravity', 'SKILL.md')
+
+    // Ensure skills directory exists
+    fs.mkdirSync(prjctSkillDir, { recursive: true })
+
+    // Check if SKILL.md already exists
+    const fileExists = fs.existsSync(skillMdPath)
+
+    // Read template content
+    if (!fs.existsSync(templatePath)) {
+      console.error('Antigravity SKILL.md template not found')
+      return { success: false, action: null }
+    }
+
+    const templateContent = fs.readFileSync(templatePath, 'utf-8')
+
+    // Write SKILL.md
+    fs.writeFileSync(skillMdPath, templateContent, 'utf-8')
+
+    return { success: true, action: fileExists ? 'updated' : 'created' }
+  } catch (error) {
+    console.error(`Antigravity skill warning: ${(error as Error).message}`)
+    return { success: false, action: null }
+  }
+}
+
+/**
+ * Check if Antigravity skill needs installation or update
+ */
+export function needsAntigravityInstallation(): boolean {
+  const detection = detectAntigravity()
+  return detection.installed && !detection.skillInstalled
+}
+
 // =============================================================================
 // Cursor IDE Installation (Project-Level)
 // =============================================================================
@@ -307,6 +367,7 @@ async function installGeminiGlobalConfig(): Promise<{ success: boolean; action:
  * configuration in .cursor/rules/ and .cursor/commands/.
  *
  * Creates minimal routers that point to the npm package for real instructions.
+ * Installs individual command files for better Cursor UX (/sync, /task, etc.)
  *
  * @param projectRoot - The project root directory
  * @returns Object with success status and files created
@@ -330,10 +391,9 @@ export async function installCursorProject(projectRoot: string): Promise<{
     const commandsDir = path.join(cursorDir, 'commands')
 
     const routerMdcDest = path.join(rulesDir, 'prjct.mdc')
-    const commandRouterDest = path.join(commandsDir, 'p.md')
 
     const routerMdcSource = path.join(getPackageRoot(), 'templates', 'cursor', 'router.mdc')
-    const commandRouterSource = path.join(getPackageRoot(), 'templates', 'cursor', 'p.md')
+    const cursorCommandsSource = path.join(getPackageRoot(), 'templates', 'cursor', 'commands')
 
     // Ensure directories exist
     fs.mkdirSync(rulesDir, { recursive: true })
@@ -345,10 +405,18 @@ export async function installCursorProject(projectRoot: string): Promise<{
       result.rulesCreated = true
     }
 
-    // Copy p.md → .cursor/commands/p.md
-    if (fs.existsSync(commandRouterSource)) {
-      fs.copyFileSync(commandRouterSource, commandRouterDest)
-      result.commandsCreated = true
+    // Copy individual command files → .cursor/commands/
+    // This enables /sync, /task, /done, /ship, etc. syntax in Cursor
+    if (fs.existsSync(cursorCommandsSource)) {
+      const commandFiles = fs.readdirSync(cursorCommandsSource)
+        .filter(f => f.endsWith('.md'))
+
+      for (const file of commandFiles) {
+        const src = path.join(cursorCommandsSource, file)
+        const dest = path.join(commandsDir, file)
+        fs.copyFileSync(src, dest)
+      }
+      result.commandsCreated = commandFiles.length > 0
     }
 
     // Update .gitignore to exclude prjct Cursor routers
@@ -373,7 +441,13 @@ async function addCursorToGitignore(projectRoot: string): Promise<boolean> {
     const entriesToAdd = [
       '# prjct Cursor routers (regenerated per-developer)',
       '.cursor/rules/prjct.mdc',
-      '.cursor/commands/p.md',
+      '.cursor/commands/sync.md',
+      '.cursor/commands/task.md',
+      '.cursor/commands/done.md',
+      '.cursor/commands/ship.md',
+      '.cursor/commands/bug.md',
+      '.cursor/commands/pause.md',
+      '.cursor/commands/resume.md',
     ]
 
     let content = ''
@@ -424,6 +498,150 @@ export function needsCursorRegeneration(projectRoot: string): boolean {
   return fs.existsSync(cursorDir) && !fs.existsSync(routerPath)
 }
 
+// =============================================================================
+// Windsurf IDE Installation (Project-Level)
+// =============================================================================
+
+/**
+ * Install prjct routers for Windsurf IDE in a project
+ *
+ * Unlike Claude/Gemini which have global config, Windsurf uses project-level
+ * configuration in .windsurf/rules/ and .windsurf/workflows/.
+ *
+ * Key differences from Cursor:
+ * - Uses .md files (not .mdc) with YAML frontmatter
+ * - Uses "workflows" directory instead of "commands"
+ * - Frontmatter uses `trigger: always_on` instead of `alwaysApply: true`
+ *
+ * @param projectRoot - The project root directory
+ * @returns Object with success status and files created
+ */
+export async function installWindsurfProject(projectRoot: string): Promise<{
+  success: boolean
+  rulesCreated: boolean
+  workflowsCreated: boolean
+  gitignoreUpdated: boolean
+}> {
+  const result = {
+    success: false,
+    rulesCreated: false,
+    workflowsCreated: false,
+    gitignoreUpdated: false,
+  }
+
+  try {
+    const windsurfDir = path.join(projectRoot, '.windsurf')
+    const rulesDir = path.join(windsurfDir, 'rules')
+    const workflowsDir = path.join(windsurfDir, 'workflows')
+
+    const routerDest = path.join(rulesDir, 'prjct.md')
+
+    const routerSource = path.join(getPackageRoot(), 'templates', 'windsurf', 'router.md')
+    const windsurfWorkflowsSource = path.join(getPackageRoot(), 'templates', 'windsurf', 'workflows')
+
+    // Ensure directories exist
+    fs.mkdirSync(rulesDir, { recursive: true })
+    fs.mkdirSync(workflowsDir, { recursive: true })
+
+    // Copy router.md → .windsurf/rules/prjct.md
+    if (fs.existsSync(routerSource)) {
+      fs.copyFileSync(routerSource, routerDest)
+      result.rulesCreated = true
+    }
+
+    // Copy individual workflow files → .windsurf/workflows/
+    // This enables /sync, /task, /done, /ship, etc. syntax in Windsurf
+    if (fs.existsSync(windsurfWorkflowsSource)) {
+      const workflowFiles = fs.readdirSync(windsurfWorkflowsSource)
+        .filter(f => f.endsWith('.md'))
+
+      for (const file of workflowFiles) {
+        const src = path.join(windsurfWorkflowsSource, file)
+        const dest = path.join(workflowsDir, file)
+        fs.copyFileSync(src, dest)
+      }
+      result.workflowsCreated = workflowFiles.length > 0
+    }
+
+    // Update .gitignore to exclude prjct Windsurf routers
+    result.gitignoreUpdated = await addWindsurfToGitignore(projectRoot)
+
+    result.success = result.rulesCreated || result.workflowsCreated
+    return result
+  } catch (error) {
+    console.error(`Windsurf installation warning: ${(error as Error).message}`)
+    return result
+  }
+}
+
+/**
+ * Add Windsurf prjct routers to .gitignore
+ *
+ * These files are per-developer and regenerated automatically.
+ */
+async function addWindsurfToGitignore(projectRoot: string): Promise<boolean> {
+  try {
+    const gitignorePath = path.join(projectRoot, '.gitignore')
+    const entriesToAdd = [
+      '# prjct Windsurf routers (regenerated per-developer)',
+      '.windsurf/rules/prjct.md',
+      '.windsurf/workflows/sync.md',
+      '.windsurf/workflows/task.md',
+      '.windsurf/workflows/done.md',
+      '.windsurf/workflows/ship.md',
+      '.windsurf/workflows/bug.md',
+      '.windsurf/workflows/pause.md',
+      '.windsurf/workflows/resume.md',
+    ]
+
+    let content = ''
+    let fileExists = false
+
+    try {
+      content = fs.readFileSync(gitignorePath, 'utf-8')
+      fileExists = true
+    } catch (error) {
+      if (!isNotFoundError(error)) {
+        throw error
+      }
+    }
+
+    // Check if already added
+    if (content.includes('.windsurf/rules/prjct.md')) {
+      return false // Already added
+    }
+
+    // Append to .gitignore
+    const newContent = fileExists
+      ? content.trimEnd() + '\n\n' + entriesToAdd.join('\n') + '\n'
+      : entriesToAdd.join('\n') + '\n'
+
+    fs.writeFileSync(gitignorePath, newContent, 'utf-8')
+    return true
+  } catch (error) {
+    console.error(`Gitignore update warning: ${(error as Error).message}`)
+    return false
+  }
+}
+
+/**
+ * Check if a project has Windsurf configured (has .windsurf/ directory)
+ */
+export function hasWindsurfProject(projectRoot: string): boolean {
+  return fs.existsSync(path.join(projectRoot, '.windsurf'))
+}
+
+/**
+ * Check if Windsurf routers need regeneration
+ */
+export function needsWindsurfRegeneration(projectRoot: string): boolean {
+  const windsurfDir = path.join(projectRoot, '.windsurf')
+  const routerPath = path.join(windsurfDir, 'rules', 'prjct.md')
+
+  // Only check if .windsurf/ exists (project uses Windsurf)
+  return fs.existsSync(windsurfDir) && !fs.existsSync(routerPath)
+}
+
 /**
  * Migrate existing projects to add cliVersion field
  * This clears the status line warning after npm update

package/core/types/provider.ts

@@ -5,19 +5,22 @@
  * - Claude Code (CLI)
  * - Gemini CLI (CLI)
  * - Cursor IDE (GUI, project-level config)
+ * - Windsurf IDE (GUI, project-level config)
  *
  * Key discovery: Skills use identical SKILL.md format for CLI providers.
  * Cursor uses .mdc files with frontmatter for rules.
+ * Windsurf uses .md files with YAML frontmatter for rules.
  *
  * @see https://geminicli.com/docs/cli/gemini-md/
  * @see https://geminicli.com/docs/cli/skills/
  * @see https://cursor.com/docs/context/rules
+ * @see https://docs.windsurf.com/windsurf/cascade/memories
  */
 
 /**
  * Supported AI provider names
  */
-export type AIProviderName = 'claude' | 'gemini' | 'cursor'
+export type AIProviderName = 'claude' | 'gemini' | 'cursor' | 'antigravity' | 'windsurf'
 
 /**
  * Command format for each provider
@@ -122,6 +125,20 @@ export interface CursorProjectDetection {
   projectRoot?: string
 }
 
+/**
+ * Result of Windsurf project detection
+ */
+export interface WindsurfProjectDetection {
+  /** Whether .windsurf/ directory exists in project */
+  detected: boolean
+
+  /** Whether prjct router is installed */
+  routerInstalled: boolean
+
+  /** Project root path */
+  projectRoot?: string
+}
+
 /**
  * Provider-aware branding configuration
  */