cairn-work 0.6.0 → 0.7.0

package/lib/agents/cursor.js

@@ -1,118 +0,0 @@
-import { existsSync, readFileSync, writeFileSync, copyFileSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import chalk from 'chalk';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-/**
- * Set up Cairn for Cursor
- * Adds to .cursorrules or creates .cursor/ directory with skill
- */
-export async function setupCursor(workspacePath) {
-  const cwd = process.cwd();
-  const cursorRulesPath = join(cwd, '.cursorrules');
-  const skillTemplate = join(__dirname, '../../skills/agent-skill.template.md');
-  
-  // Strategy 1: Add to .cursorrules if it exists
-  if (existsSync(cursorRulesPath)) {
-    const existing = readFileSync(cursorRulesPath, 'utf8');
-    const cairnRule = `
-
-# Cairn Project Management
-
-This project uses Cairn for project management.
-
-**Workspace:** ${workspacePath}
-
-When working with project management tasks:
-1. All files are in markdown format at ${workspacePath}
-2. Follow project → task hierarchy
-3. Update status before asking for blocking information
-4. Log all work with timestamps
-
-See .cursor/cairn-skill.md for workflow documentation and .cursor/cairn-planning.md for project planning guidance.
-`;
-    
-    if (!existing.includes('Cairn Project Management')) {
-      writeFileSync(cursorRulesPath, existing + cairnRule);
-      console.log(chalk.green('✓'), 'Cairn rules added to .cursorrules');
-    } else {
-      console.log(chalk.yellow('⚠'), '.cursorrules already contains Cairn rules');
-    }
-  }
-  
-  // Strategy 2: Create .cursor/ directory with skill
-  const cursorDir = join(cwd, '.cursor');
-  if (!existsSync(cursorDir)) {
-    mkdirSync(cursorDir, { recursive: true });
-  }
-  
-  // Read template and replace workspace placeholders
-  let skillContent = readFileSync(skillTemplate, 'utf-8');
-  const workspaceRoot = dirname(workspacePath);
-  
-  skillContent = skillContent
-    .replace(/\{\{WORKSPACE_PATH\}\}/g, workspacePath)
-    .replace(/\{\{WORKSPACE_ROOT\}\}/g, workspaceRoot);
-  
-  const skillDest = join(cursorDir, 'cairn-skill.md');
-  writeFileSync(skillDest, skillContent);
-  console.log(chalk.green('✓'), 'Cairn skill added to .cursor/');
-
-  // Read planning template and replace placeholders
-  const planningTemplate = join(__dirname, '../../skills/agent-planning.template.md');
-  let planningContent = readFileSync(planningTemplate, 'utf-8');
-  planningContent = planningContent
-    .replace(/\{\{WORKSPACE_PATH\}\}/g, workspacePath)
-    .replace(/\{\{WORKSPACE_ROOT\}\}/g, workspaceRoot);
-
-  const planningDest = join(cursorDir, 'cairn-planning.md');
-  writeFileSync(planningDest, planningContent);
-  console.log(chalk.green('✓'), 'Cairn planning guide added to .cursor/');
-  
-  // Create config
-  const configPath = join(cursorDir, 'cairn-config.json');
-  const config = {
-    workspacePath,
-    version: '0.1.0',
-    installedAt: new Date().toISOString()
-  };
-  writeFileSync(configPath, JSON.stringify(config, null, 2));
-  
-  return true;
-}
-
-/**
- * Get setup instructions for Cursor
- */
-export function getCursorInstructions(workspacePath) {
-  return `
-${chalk.bold('Cursor Setup Complete!')}
-
-Your Cairn workspace: ${chalk.cyan(workspacePath)}
-Configuration: ${chalk.cyan('.cursor/')} and ${chalk.cyan('.cursorrules')}
-
-${chalk.bold('Test it:')}
-Ask Cursor:
-  ${chalk.yellow('"Read .cursor/cairn-skill.md and help me create a project"')}
-
-${chalk.dim('Note: Cursor should automatically pick up .cursorrules on next prompt.')}
-`;
-}
-
-/**
- * Verify Cursor setup
- */
-export function verifyCursor() {
-  const cwd = process.cwd();
-  const rulesPath = join(cwd, '.cursorrules');
-  const skillPath = join(cwd, '.cursor', 'cairn-skill.md');
-  
-  if (!existsSync(rulesPath) && !existsSync(skillPath)) {
-    return { success: false, message: 'Cairn not configured for Cursor' };
-  }
-  
-  return { success: true, message: 'Cursor setup verified' };
-}

package/lib/agents/detect.js

@@ -1,60 +0,0 @@
-import { existsSync } from 'fs';
-import { homedir } from 'os';
-import { join } from 'path';
-
-/**
- * Detect which AI agent(s) are available in the environment
- * @returns {Object} { primary: string, detected: string[] }
- */
-export function detectAgents() {
-  const detected = [];
-  
-  // Check for Clawdbot
-  const clawdbotPath = join(homedir(), '.clawdbot');
-  if (existsSync(clawdbotPath)) {
-    detected.push('clawdbot');
-  }
-  
-  // Check for Claude Code
-  // Claude Code typically sets environment variables or has workspace indicators
-  if (process.env.ANTHROPIC_API_KEY || process.env.CLAUDE_CODE_WORKSPACE) {
-    detected.push('claude-code');
-  }
-  
-  // Check for Cursor
-  // Cursor uses .cursorrules file or sets env variables
-  if (existsSync('.cursorrules') || process.env.CURSOR_WORKSPACE) {
-    detected.push('cursor');
-  }
-  
-  // Check for Windsurf
-  if (process.env.WINDSURF_WORKSPACE) {
-    detected.push('windsurf');
-  }
-  
-  // Determine primary agent (first detected, or generic)
-  const primary = detected[0] || 'generic';
-  
-  return { primary, detected };
-}
-
-/**
- * Get agent display name
- */
-export function getAgentName(type) {
-  const names = {
-    'clawdbot': 'Clawdbot',
-    'claude-code': 'Claude Code',
-    'cursor': 'Cursor',
-    'windsurf': 'Windsurf',
-    'generic': 'Generic AI Agent'
-  };
-  return names[type] || type;
-}
-
-/**
- * Check if an agent type is supported
- */
-export function isSupportedAgent(type) {
-  return ['clawdbot', 'claude-code', 'cursor', 'windsurf', 'generic'].includes(type);
-}

package/lib/agents/detect.test.js

@@ -1,108 +0,0 @@
-import { describe, test, expect, beforeEach, afterEach } from 'bun:test';
-import { detectAgents, getAgentName, isSupportedAgent } from './detect.js';
-import { existsSync, mkdirSync, rmSync } from 'fs';
-import { join } from 'path';
-import { tmpdir } from 'os';
-
-describe('Agent Detection', () => {
-  let originalEnv;
-  let testHome;
-  
-  beforeEach(() => {
-    // Save original environment
-    originalEnv = { ...process.env };
-    
-    // Create temporary home directory for testing
-    testHome = join(tmpdir(), `cairn-test-${Date.now()}`);
-    mkdirSync(testHome, { recursive: true });
-  });
-  
-  afterEach(() => {
-    // Restore environment
-    process.env = originalEnv;
-    
-    // Clean up test directory
-    if (existsSync(testHome)) {
-      rmSync(testHome, { recursive: true, force: true });
-    }
-  });
-  
-  test('detectAgents returns generic when no agents found', () => {
-    // Clear environment variables that might detect agents
-    delete process.env.ANTHROPIC_API_KEY;
-    delete process.env.CLAUDE_CODE_WORKSPACE;
-    delete process.env.CURSOR_WORKSPACE;
-    delete process.env.WINDSURF_WORKSPACE;
-    
-    const result = detectAgents();
-    
-    expect(result).toHaveProperty('primary');
-    expect(result).toHaveProperty('detected');
-    expect(Array.isArray(result.detected)).toBe(true);
-    
-    // If running in environment with actual agents installed, primary might not be generic
-    // Just verify it returns a valid agent type
-    expect(isSupportedAgent(result.primary)).toBe(true);
-  });
-  
-  test('detectAgents finds Clawdbot when .clawdbot exists', () => {
-    // This test only runs if .clawdbot actually exists
-    const clawdbotPath = join(process.env.HOME, '.clawdbot');
-    if (existsSync(clawdbotPath)) {
-      const result = detectAgents();
-      expect(result.detected).toContain('clawdbot');
-    }
-  });
-  
-  test('detectAgents finds Claude Code when env var set', () => {
-    process.env.ANTHROPIC_API_KEY = 'test-key';
-    
-    const result = detectAgents();
-    
-    expect(result.detected).toContain('claude-code');
-  });
-  
-  test('detectAgents finds Cursor when .cursorrules exists', () => {
-    // Only test if in actual Cursor environment
-    if (existsSync('.cursorrules')) {
-      const result = detectAgents();
-      expect(result.detected).toContain('cursor');
-    }
-  });
-  
-  test('detectAgents handles multiple agents', () => {
-    process.env.ANTHROPIC_API_KEY = 'test-key';
-    process.env.CURSOR_WORKSPACE = 'test-workspace';
-    
-    const result = detectAgents();
-    
-    expect(result.detected.length).toBeGreaterThanOrEqual(1);
-    expect(result.primary).toBeTruthy();
-  });
-  
-  test('getAgentName returns correct display names', () => {
-    expect(getAgentName('clawdbot')).toBe('Clawdbot');
-    expect(getAgentName('claude-code')).toBe('Claude Code');
-    expect(getAgentName('cursor')).toBe('Cursor');
-    expect(getAgentName('windsurf')).toBe('Windsurf');
-    expect(getAgentName('generic')).toBe('Generic AI Agent');
-  });
-  
-  test('getAgentName returns input for unknown agent', () => {
-    expect(getAgentName('unknown-agent')).toBe('unknown-agent');
-  });
-  
-  test('isSupportedAgent validates known agents', () => {
-    expect(isSupportedAgent('clawdbot')).toBe(true);
-    expect(isSupportedAgent('claude-code')).toBe(true);
-    expect(isSupportedAgent('cursor')).toBe(true);
-    expect(isSupportedAgent('windsurf')).toBe(true);
-    expect(isSupportedAgent('generic')).toBe(true);
-  });
-  
-  test('isSupportedAgent rejects unknown agents', () => {
-    expect(isSupportedAgent('unknown')).toBe(false);
-    expect(isSupportedAgent('invalid')).toBe(false);
-    expect(isSupportedAgent('')).toBe(false);
-  });
-});

package/lib/agents/generic.js

@@ -1,62 +0,0 @@
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import chalk from 'chalk';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-/**
- * Generic agent setup - just provide instructions
- */
-export async function setupGeneric(workspacePath) {
-  // For generic agents, we can't auto-configure
-  // Just provide clear instructions
-  console.log(chalk.yellow('ℹ'), 'Generic agent detected - manual setup required');
-  return true;
-}
-
-/**
- * Get setup instructions for generic agents
- */
-export function getGenericInstructions(workspacePath) {
-  const skillPath = join(dirname(__dirname), '../skills/agent-skill.template.md');
-  const planningPath = join(dirname(__dirname), '../skills/agent-planning.template.md');
-
-  let output = '\n';
-  output += chalk.bold('Manual Setup Required') + '\n\n';
-  output += 'Your Cairn workspace: ' + chalk.cyan(workspacePath) + '\n\n';
-  output += chalk.bold('To configure your AI agent:') + '\n\n';
-  output += '1. Share this with your agent:\n';
-  output += '   ' + chalk.dim('─────────────────────────────────────') + '\n';
-  output += '   ' + chalk.yellow('I\'m using Cairn for project management.') + '\n';
-  output += '   ' + chalk.yellow('My workspace is at: ' + workspacePath) + '\n';
-  output += '   ' + chalk.yellow('Please read the agent documentation at:') + '\n';
-  output += '   ' + chalk.yellow('  Skill: ' + skillPath) + '\n';
-  output += '   ' + chalk.yellow('  Planning: ' + planningPath) + '\n';
-  output += '   ' + chalk.dim('─────────────────────────────────────') + '\n\n';
-  output += '2. ' + chalk.bold('Or copy both files to your agent\'s context:') + '\n';
-  output += '   - ' + chalk.cyan(skillPath) + ' (operations & workflow)\n';
-  output += '   - ' + chalk.cyan(planningPath) + ' (project planning & examples)\n\n';
-  output += '3. ' + chalk.bold('Test it:') + '\n';
-  output += '   Ask your agent:\n';
-  output += '     ' + chalk.yellow('"Help me create a project called Launch My App"') + '\n\n';
-  output += chalk.bold('Supported agents with auto-setup:') + '\n';
-  output += '- Clawdbot (detected via ~/.clawdbot/)\n';
-  output += '- Claude Code (workspace-based)\n';
-  output += '- Cursor (uses .cursorrules)\n';
-  output += '- Windsurf (workspace-based)\n\n';
-  output += chalk.dim('If you install one of these agents later, run:') + '\n';
-  output += chalk.dim('  cairn onboard --force') + '\n';
-  
-  return output;
-}
-
-/**
- * Verify generic setup (always returns guidance)
- */
-export function verifyGeneric() {
-  return {
-    success: true,
-    message: 'Manual setup - verify agent can read workspace'
-  };
-}