project-iris 0.2.0 → 0.2.2

package/lib/installer.js

@@ -71,6 +71,99 @@ async function detectTools() {
 // VS Code-based tools that can use the iris Dashboard extension
 const VSCODE_TOOLS = ['claude', 'cursor', 'copilot', 'windsurf', 'cline', 'roo', 'antigravity'];
 
+/**
+ * Find VS Code CLI executable
+ * @returns {string|null} Path to VS Code CLI or null if not found
+ */
+function findVSCodeCLI() {
+  const platform = process.platform;
+
+  // Possible CLI paths by platform
+  const paths = [];
+
+  if (platform === 'darwin') {
+    // macOS - check common application locations
+    paths.push(
+      '/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code',
+      '/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin/code',
+      `${process.env.HOME}/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code`
+    );
+  } else if (platform === 'win32') {
+    // Windows
+    const localAppData = process.env.LOCALAPPDATA || '';
+    const programFiles = process.env['ProgramFiles'] || 'C:\\Program Files';
+    paths.push(
+      `${localAppData}\\Programs\\Microsoft VS Code\\bin\\code.cmd`,
+      `${programFiles}\\Microsoft VS Code\\bin\\code.cmd`
+    );
+  } else {
+    // Linux
+    paths.push(
+      '/usr/bin/code',
+      '/usr/local/bin/code',
+      '/snap/bin/code'
+    );
+  }
+
+  // Check each path
+  for (const p of paths) {
+    try {
+      if (fs.existsSync(p)) {
+        return p;
+      }
+    } catch {
+      // Ignore errors
+    }
+  }
+
+  // Fall back to trying 'code' from PATH
+  try {
+    execSync('which code || where code', { stdio: 'pipe' });
+    return 'code';
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Find Cursor CLI executable
+ * @returns {string|null} Path to Cursor CLI or null if not found
+ */
+function findCursorCLI() {
+  const platform = process.platform;
+
+  const paths = [];
+
+  if (platform === 'darwin') {
+    paths.push(
+      '/Applications/Cursor.app/Contents/Resources/app/bin/cursor',
+      `${process.env.HOME}/Applications/Cursor.app/Contents/Resources/app/bin/cursor`
+    );
+  } else if (platform === 'win32') {
+    const localAppData = process.env.LOCALAPPDATA || '';
+    paths.push(
+      `${localAppData}\\Programs\\Cursor\\resources\\app\\bin\\cursor.cmd`
+    );
+  }
+
+  for (const p of paths) {
+    try {
+      if (fs.existsSync(p)) {
+        return p;
+      }
+    } catch {
+      // Ignore errors
+    }
+  }
+
+  try {
+    execSync('which cursor || where cursor', { stdio: 'pipe' });
+    return 'cursor';
+  } catch {
+    return null;
+  }
+}
+
 /**
  * Install VS Code extension if any VS Code-based tool is selected
  * @param {string[]} selectedToolKeys - Selected tool keys
@@ -93,46 +186,89 @@ async function installVSCodeExtension(selectedToolKeys) {
 
   console.log(theme.dim('  Installing iris Dashboard VS Code extension...'));
 
-  try {
-    // Try 'code' command first (VS Code), then 'cursor' for Cursor
-    let installed = false;
+  let installed = false;
 
-    // Try VS Code
+  // Try VS Code
+  const vscodeCLI = findVSCodeCLI();
+  if (vscodeCLI) {
     try {
-      execSync(`code --install-extension "${extensionPath}" --force`, {
+      execSync(`"${vscodeCLI}" --install-extension "${extensionPath}" --force`, {
         stdio: 'pipe',
-        timeout: 30000
+        timeout: 60000,
+        shell: true
       });
       installed = true;
       CLIUtils.displayStatus('', 'Installed iris Dashboard extension for VS Code', 'success');
-    } catch {
-      // VS Code not available or failed
+    } catch (err) {
+      console.log(theme.dim(`  VS Code install failed: ${err.message}`));
     }
+  }
 
-    // Try Cursor if selected
-    if (selectedToolKeys.includes('cursor')) {
+  // Try Cursor if selected
+  if (selectedToolKeys.includes('cursor')) {
+    const cursorCLI = findCursorCLI();
+    if (cursorCLI) {
       try {
-        execSync(`cursor --install-extension "${extensionPath}" --force`, {
+        execSync(`"${cursorCLI}" --install-extension "${extensionPath}" --force`, {
           stdio: 'pipe',
-          timeout: 30000
+          timeout: 60000,
+          shell: true
         });
         installed = true;
         CLIUtils.displayStatus('', 'Installed iris Dashboard extension for Cursor', 'success');
-      } catch {
-        // Cursor not available or failed
+      } catch (err) {
+        console.log(theme.dim(`  Cursor install failed: ${err.message}`));
       }
     }
+  }
 
-    if (!installed) {
-      console.log(theme.dim('  Could not auto-install extension. Install manually:'));
-      console.log(theme.dim(`    code --install-extension "${extensionPath}"`));
-    }
+  if (!installed) {
+    console.log(theme.dim('  Could not auto-install extension. Install manually:'));
+    console.log(theme.dim(`    code --install-extension "${extensionPath}"`));
+  }
 
-    return installed;
-  } catch (error) {
-    console.log(theme.dim(`  Extension install skipped: ${error.message}`));
+  return installed;
+}
+
+/**
+ * Install CLAUDE.md to .claude/ folder
+ * This provides Claude with project-agnostic quality guidelines
+ * @returns {boolean} Whether file was installed
+ */
+async function installClaudeMd() {
+  const sourcePath = path.join(__dirname, '..', 'templates', 'CLAUDE.md');
+  const targetDir = '.claude';
+  const targetPath = path.join(targetDir, 'CLAUDE.md');
+
+  // Check if source exists
+  if (!await fs.pathExists(sourcePath)) {
+    console.log(theme.dim('  CLAUDE.md template not found, skipping...'));
     return false;
   }
+
+  // Ensure .claude directory exists
+  await fs.ensureDir(targetDir);
+
+  // Check if CLAUDE.md already exists
+  if (await fs.pathExists(targetPath)) {
+    // Read existing content to check if it's ours
+    const existing = await fs.readFile(targetPath, 'utf8');
+    if (existing.includes('installed by iris') || existing.includes('project-iris')) {
+      // Our file, safe to overwrite
+      await fs.copy(sourcePath, targetPath, { overwrite: true });
+      CLIUtils.displayStatus('', 'Updated CLAUDE.md', 'success');
+      return true;
+    } else {
+      // User's own CLAUDE.md, don't overwrite
+      console.log(theme.dim('  Existing CLAUDE.md found, skipping (won\'t overwrite user file)'));
+      return false;
+    }
+  }
+
+  // Install fresh
+  await fs.copy(sourcePath, targetPath);
+  CLIUtils.displayStatus('', 'Installed CLAUDE.md with quality guidelines', 'success');
+  return true;
 }
 
 async function install() {
@@ -221,6 +357,9 @@ async function install() {
   try {
     const filesCreated = await installFlow(selectedFlow, selectedToolKeys);
 
+    // Install CLAUDE.md with quality guidelines
+    await installClaudeMd();
+
     // Install VS Code extension if applicable
     await installVSCodeExtension(selectedToolKeys);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-iris",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
   "main": "lib/installer.js",
   "bin": {
@@ -38,6 +38,7 @@
     "flows/",
     "lib/",
     "scripts/",
+    "templates/",
     "README.md"
   ],
   "dependencies": {

package/templates/CLAUDE.md

@@ -0,0 +1,88 @@
+# Claude Instructions
+
+## Core Principles
+
+1. **Read before writing** - Understand existing code before modifying
+2. **Minimal changes** - Solve the problem, nothing more
+3. **Follow existing patterns** - Match the codebase style exactly
+4. **Ask when unclear** - Don't guess at requirements
+
+---
+
+## Before Writing Code
+
+- Read the files you'll modify - understand the patterns used
+- Search for existing utilities before creating new ones
+- Check if similar problems are solved elsewhere in the codebase
+- Understand the "why" behind existing code, not just the "what"
+
+---
+
+## Code Quality
+
+### Keep It Simple
+
+- Solve the current problem, not hypothetical future ones
+- No abstractions for single-use cases
+- Three similar lines > premature helper function
+- Delete unused code completely (no `_unused` prefixes)
+
+### Only Add What's Needed
+
+- No feature flags for simple changes
+- No backwards-compatibility shims when you can just change code
+- No defensive programming against impossible scenarios
+- No gold-plating or "while I'm here" improvements
+
+### Error Handling
+
+- Validate at system boundaries only (user input, APIs, file I/O)
+- Trust internal code - don't defensively check everything
+- No empty catch blocks
+- Let errors propagate when callers should handle them
+
+---
+
+## What NOT To Do
+
+- Don't add comments explaining obvious code
+- Don't add types/docstrings to code you didn't change
+- Don't refactor surrounding code when fixing a bug
+- Don't create utils/helpers for one-time operations
+- Don't add tests for trivial code (getters, pass-through)
+- Don't "improve" working code that isn't part of the task
+- Don't guess at missing requirements - ask first
+
+---
+
+## Security Essentials
+
+- Never hardcode secrets, keys, or credentials
+- Validate and sanitize all user input
+- Use parameterized queries (no string concatenation for SQL)
+- Escape output in templates to prevent XSS
+- Check file paths to prevent directory traversal
+
+---
+
+## Testing
+
+- Test behavior, not implementation
+- One assertion per test when possible
+- Name tests by what they verify: `test_returns_empty_list_when_no_items`
+- Don't mock what you don't own
+- Skip tests for trivial code
+
+---
+
+## Communication
+
+- Be direct and concise
+- State what you're doing before doing it
+- If blocked, explain why and ask for guidance
+- Confirm destructive operations before executing
+- Summarize changes after completing a task
+
+---
+
+<!-- installed by iris (project-iris) - safe to update with: npx project-iris install -->