claude-scionos 1.1.0 → 2.0.0

package/CHANGELOG.md

@@ -5,6 +5,33 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2025-12-12
+
+### ⚠️ BREAKING CHANGES
+- Enhanced detection system replaces basic checks
+- Improved error handling with detailed diagnostics
+- Better cross-platform support and user guidance
+
+### Added
+- **Advanced System Detection**: Comprehensive OS, shell, and environment detection
+- **Enhanced Claude Code Detection**: Checks both directory and CLI availability with detailed status
+- **Improved Git Bash Detection**: Better Windows support with automatic path discovery
+- **Detailed Error Messages**: Actionable troubleshooting information for users
+- **System Information Display**: Shows detected OS and shell during startup
+- **Modular Architecture**: New `src/detectors/` directory for extensible detection logic
+
+### Improved
+- **User Experience**: Much clearer feedback when something goes wrong
+- **Cross-Platform Compatibility**: Better handling of Windows, macOS, and Linux
+- **Installation Guidance**: OS-specific instructions when dependencies are missing
+- **Code Organization**: Cleaner separation of concerns with dedicated detection modules
+
+### Technical Changes
+- Replaced basic `which()` checks with comprehensive detection system
+- Added support for detecting Claude Code configuration files
+- Enhanced shell detection (PowerShell, CMD, bash, zsh, fish)
+- Improved error recovery and user guidance
+
 ## [1.0.1] - 2025-11-29
 
 ### Added
@@ -41,5 +68,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Automatic credential cleanup on exit
 - Environment variable isolation
 
+[2.0.0]: https://github.com/ScioNos/claude-scionos/compare/v1.0.1...v2.0.0
 [1.0.1]: https://github.com/ScioNos/claude-scionos/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/ScioNos/claude-scionos/releases/tag/v1.0.0

package/CLAUDE.md

@@ -0,0 +1,90 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+claude-scionos is a lightweight Node.js CLI wrapper that provides ephemeral and secure execution of the official Claude Code CLI. It's designed for the SNIA environment and focuses on in-memory credential management with zero disk persistence.
+
+## Architecture
+
+The project is a single-file Node.js application (`index.js`) that:
+
+1. **Validates prerequisites**: Checks if Claude Code CLI is installed and available in PATH
+2. **Windows-specific check**: Verifies Git Bash installation (required by Claude Code on Windows)
+3. **Secure token collection**: Uses `@inquirer/prompts` for masked password input
+4. **Environment isolation**: Creates isolated environment variables with:
+   - `ANTHROPIC_BASE_URL`: Set to `https://routerlab.ch` (hardcoded SNIA endpoint)
+   - `ANTHROPIC_AUTH_TOKEN`: User-provided token (memory only)
+   - `ANTHROPIC_API_KEY`: Explicitly set to empty string
+5. **Process spawning**: Launches Claude Code CLI with inherited stdio and custom environment
+
+## Key Dependencies
+
+- `@inquirer/prompts`: For secure password input with masking
+- `cross-spawn`: Platform-agnostic process spawning
+- `chalk`: Terminal colors for user-friendly output
+- `update-notifier`: Automatic npm update notifications
+- `which`: Command availability checking
+
+## Development Commands
+
+```bash
+# Run locally during development
+node index.js
+
+# Lint code
+npm run lint
+
+# Version bumping (automated commit messages)
+npm run release:patch  # Bump patch version
+npm run release:minor  # Bump minor version
+npm run release:major  # Bump major version
+
+# Check for vulnerabilities
+npm audit
+```
+
+## Testing
+
+Currently no automated tests are configured. When implementing tests, focus on:
+- Version flag handling (`--version`, `-v`)
+- Claude Code CLI detection
+- Windows Git Bash detection logic
+- Token validation and environment setup
+
+## Release Process
+
+1. Update version in `package.json` if not using npm scripts
+2. Update `SESSION_SUMMARY.md` with changes
+3. Commit changes with descriptive message
+4. Publish to npm: `npm publish`
+5. Create GitHub release with changelog
+
+## Platform-Specific Behavior
+
+### Windows
+- Requires Git Bash for Claude Code CLI to function
+- Detects Git Bash in standard locations:
+  - `C:\Program Files\Git\bin\bash.exe` (64-bit)
+  - `C:\Program Files (x86)\Git\bin\bash.exe` (32-bit)
+  - Custom path via `CLAUDE_CODE_GIT_BASH_PATH` environment variable
+- Provides clear error messages with installation guidance
+
+### Unix (macOS/Linux)
+- No additional requirements beyond Claude Code CLI
+- Standard Unix process spawning behavior
+
+## Important Constants
+
+- `ANTHROPIC_BASE_URL`: `"https://routerlab.ch"` (SNIA-specific endpoint)
+- Minimum Node.js version: 22
+- Package entry point: `index.js` with shebang for direct execution
+
+## Code Style Notes
+
+- ES6 modules throughout (`import`/`export`)
+- Async/await pattern for asynchronous operations
+- Colored terminal output using chalk
+- Clear user error messages with actionable guidance
+- Process exit codes: 0 (success), 1 (error)

package/index.js

@@ -4,10 +4,9 @@ import chalk from 'chalk';
 import { password } from '@inquirer/prompts';
 import spawn from 'cross-spawn';
 import updateNotifier from 'update-notifier';
-import which from 'which';
 import process from 'node:process';
 import { createRequire } from 'node:module';
-import fs from 'node:fs';
+import { isClaudeCodeInstalled, detectOS, checkGitBashOnWindows, getInstallationInstructions } from './src/detectors/claude-only.js';
 
 const require = createRequire(import.meta.url);
 const pkg = require('./package.json');
@@ -21,38 +20,62 @@ if (process.argv.includes('--version') || process.argv.includes('-v')) {
     process.exit(0);
 }
 
-// 1. Check if "claude" command is available
-try {
-    await which('claude');
-} catch {
-    console.error(chalk.redBright("Error: 'claude' command not found. Please install Claude Code first: npm install -g @anthropic-ai/claude-code"));
+// 1. Enhanced System Detection
+console.log(chalk.cyan('🔍 Checking system configuration...'));
+
+// Detect OS and environment
+const osInfo = detectOS();
+console.log(chalk.gray(`✓ OS: ${osInfo.type} (${osInfo.arch})`));
+console.log(chalk.gray(`✓ Shell: ${osInfo.shell}`));
+
+// Check Claude Code installation
+const claudeStatus = isClaudeCodeInstalled();
+
+if (!claudeStatus.installed) {
+    console.error(chalk.redBright('\n❌ Claude Code not found'));
+
+    // Show detailed detection info
+    console.log(chalk.yellow('\nDetection Details:'));
+    console.log(chalk.gray(claudeStatus.details));
+
+    // Show installation instructions
+    const instructions = getInstallationInstructions(osInfo, claudeStatus);
+    console.log(chalk.cyan(instructions));
+
     process.exit(1);
 }
 
-// 2. Check Git Bash on Windows
+// Show Claude Code status
+console.log(chalk.green('\n✓ Claude Code detected'));
+console.log(chalk.gray(claudeStatus.details));
+
+// 2. Check Git Bash on Windows (if needed)
 if (process.platform === 'win32') {
-    const possiblePaths = [
-        process.env.CLAUDE_CODE_GIT_BASH_PATH,
-        'C:\\Program Files\\Git\\bin\\bash.exe',
-        'C:\\Program Files (x86)\\Git\\bin\\bash.exe',
-    ].filter(Boolean);
+    console.log(chalk.cyan('\n🔍 Checking Git Bash availability...'));
+    const gitBashStatus = checkGitBashOnWindows();
 
-    const gitBashFound = possiblePaths.some(path => fs.existsSync(path));
+    if (!gitBashStatus.available) {
+        console.log(chalk.red('\n❌ Git Bash is required on Windows'));
+        console.log(chalk.gray(gitBashStatus.message));
 
-    if (!gitBashFound) {
-        console.log(chalk.red('\n❌ Git Bash is required on Windows\n'));
-        console.log(chalk.cyan('📥 Install Git for Windows:'));
+        // Show Git Bash installation instructions
+        console.log(chalk.cyan('\n📥 Install Git for Windows:'));
         console.log(chalk.white('   https://git-scm.com/downloads/win\n'));
         console.log(chalk.cyan('⚙️  Or set the path manually:'));
-        console.log(chalk.white('   CLAUDE_CODE_GIT_BASH_PATH=C:\\Program Files\\Git\\bin\\bash.exe\n'));
+        console.log(chalk.white('   set CLAUDE_CODE_GIT_BASH_PATH=C:\\Program Files\\Git\\bin\\bash.exe'));
+        console.log(chalk.white('   (PowerShell: $env:CLAUDE_CODE_GIT_BASH_PATH="C:\\Program Files\\Git\\bin\\bash.exe")\n'));
         console.log(chalk.yellow('💡 After installation, restart your terminal and try again.\n'));
         process.exit(1);
+    } else {
+        console.log(chalk.green('✓ Git Bash available'));
+        console.log(chalk.gray(gitBashStatus.message));
     }
 }
 
 // 3. Intro
 console.clear();
 console.log(chalk.cyan.bold("Claude Code (via ScioNos)"));
+console.log(chalk.gray(`Running on ${osInfo.type} with ${osInfo.shell}`));
 
 // 4. Token info
 console.log(chalk.blueBright("To retrieve your token, visit: https://routerlab.ch/keys"));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-scionos",
-    "version": "1.1.0",
+    "version": "2.0.0",
     "description": "Ephemeral and secure runner for Claude Code CLI in SNIA environment",
     "type": "module",
     "main": "index.js",

package/src/detectors/claude-only.js

@@ -0,0 +1,219 @@
+// Claude Code Detection Module for claude-scionos
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+/**
+ * Detects if Claude Code is installed and returns detailed status
+ * @returns {{installed: boolean, path: string|null, configPath: string|null, cliAvailable: boolean, details: string}}
+ */
+function isClaudeCodeInstalled() {
+  // Check for Claude Code directory in user home
+  const claudeDir = path.join(os.homedir(), '.claude');
+  const details = [];
+
+  if (fs.existsSync(claudeDir)) {
+    details.push(`✓ Found Claude directory: ${claudeDir}`);
+
+    // Check for settings.json to confirm it's actually Claude Code
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    if (fs.existsSync(settingsPath)) {
+      details.push(`✓ Configuration file found: ${settingsPath}`);
+
+      // Try to read the config to see if it's configured
+      try {
+        const config = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+        const hasBaseUrl = config.env?.ANTHROPIC_BASE_URL;
+        const hasApiKey = config.env?.ANTHROPIC_API_KEY;
+
+        if (hasBaseUrl && hasApiKey) {
+          details.push(`✓ Claude Code is configured with custom API`);
+        } else if (hasBaseUrl || hasApiKey) {
+          details.push(`⚠ Claude Code is partially configured`);
+        } else {
+          details.push(`ℹ Claude Code installed but not configured`);
+        }
+      } catch (error) {
+        details.push(`⚠ Could not read configuration file`);
+      }
+
+      return {
+        installed: true,
+        path: claudeDir,
+        configPath: settingsPath,
+        cliAvailable: false, // Will check next
+        details: details.join('\n  ')
+      };
+    } else {
+      details.push(`⚠ Directory exists but no settings.json found`);
+    }
+  }
+
+  // Also check for the claude CLI command in PATH
+  try {
+    const command = process.platform === 'win32' ? 'where claude' : 'which claude';
+    const claudePath = execSync(command, { encoding: 'utf8' }).trim();
+
+    if (claudePath) {
+      details.push(`✓ Claude CLI found in PATH: ${claudePath}`);
+
+      // Try to get version to confirm it's working
+      try {
+        const version = execSync('claude --version', { encoding: 'utf8' }).trim();
+        details.push(`✓ Version: ${version}`);
+      } catch (error) {
+        details.push(`⚠ CLI found but version check failed`);
+      }
+
+      return {
+        installed: true,
+        path: claudeDir && fs.existsSync(claudeDir) ? claudeDir : null,
+        configPath: claudeDir && fs.existsSync(path.join(claudeDir, 'settings.json'))
+          ? path.join(claudeDir, 'settings.json')
+          : null,
+        cliAvailable: true,
+        cliPath: claudePath,
+        details: details.join('\n  ')
+      };
+    }
+  } catch (error) {
+    details.push(`✗ Claude CLI not found in PATH`);
+  }
+
+  return {
+    installed: false,
+    path: null,
+    configPath: null,
+    cliAvailable: false,
+    details: details.join('\n  ')
+  };
+}
+
+/**
+ * Detects operating system and shell information
+ * @returns {{platform: string, type: string, shell: string, arch: string}}
+ */
+function detectOS() {
+  const platform = os.platform();
+  const arch = os.arch();
+  let type, shell;
+
+  switch (platform) {
+    case 'darwin':
+      type = 'macOS';
+      break;
+    case 'win32':
+      type = 'Windows';
+      break;
+    case 'linux':
+      type = 'Linux';
+      break;
+    default:
+      type = platform;
+  }
+
+  // Detect shell
+  if (process.platform === 'win32') {
+    if (process.env.PSModulePath) {
+      shell = 'PowerShell';
+    } else if (process.env.WINDIR) {
+      shell = 'Command Prompt (CMD)';
+    } else {
+      shell = 'Windows Shell';
+    }
+  } else {
+    const shellPath = process.env.SHELL || '';
+    if (shellPath.includes('zsh')) {
+      shell = 'Zsh';
+    } else if (shellPath.includes('bash')) {
+      shell = 'Bash';
+    } else if (shellPath.includes('fish')) {
+      shell = 'Fish';
+    } else if (shellPath) {
+      shell = shellPath.split('/').pop() || 'Unknown Unix Shell';
+    } else {
+      shell = 'Default Unix Shell';
+    }
+  }
+
+  return {
+    platform,
+    type,
+    shell,
+    arch
+  };
+}
+
+/**
+ * Checks Git Bash availability on Windows (required for Claude Code)
+ * @returns {{available: boolean, path: string|null, message: string}}
+ */
+function checkGitBashOnWindows() {
+  if (process.platform !== 'win32') {
+    return { available: true, path: null, message: 'Not required on non-Windows systems' };
+  }
+
+  const possiblePaths = [
+    process.env.CLAUDE_CODE_GIT_BASH_PATH,
+    'C:\\Program Files\\Git\\bin\\bash.exe',
+    'C:\\Program Files (x86)\\Git\\bin\\bash.exe',
+  ].filter(Boolean);
+
+  for (const bashPath of possiblePaths) {
+    if (fs.existsSync(bashPath)) {
+      return {
+        available: true,
+        path: bashPath,
+        message: `Git Bash found at: ${bashPath}`
+      };
+    }
+  }
+
+  return {
+    available: false,
+    path: null,
+    message: 'Git Bash not found. Claude Code requires Git Bash on Windows.'
+  };
+}
+
+/**
+ * Provides installation instructions based on OS and current state
+ * @param {Object} osInfo - OS detection result
+ * @param {Object} claudeStatus - Claude Code detection result
+ * @returns {string} Installation instructions
+ */
+function getInstallationInstructions(osInfo, claudeStatus) {
+  let instructions = [];
+
+  if (osInfo.type === 'Windows') {
+    instructions.push('\n📋 Installation Instructions for Windows:');
+    instructions.push('');
+    instructions.push('1. Install Git for Windows (includes Git Bash):');
+    instructions.push('   https://git-scm.com/downloads/win');
+    instructions.push('');
+    instructions.push('2. Install Claude Code CLI:');
+    instructions.push('   npm install -g @anthropic-ai/claude-code');
+    instructions.push('');
+    instructions.push('3. Restart your terminal and try again.');
+    instructions.push('');
+    instructions.push('💡 If Git Bash is installed but not detected:');
+    instructions.push('   set CLAUDE_CODE_GIT_BASH_PATH=C:\\Program Files\\Git\\bin\\bash.exe');
+  } else {
+    instructions.push('\n📋 Installation Instructions:');
+    instructions.push('');
+    instructions.push(`Install Claude Code CLI with npm:`);
+    instructions.push('   npm install -g @anthropic-ai/claude-code');
+    instructions.push('');
+    instructions.push('Then restart your terminal and try again.');
+  }
+
+  return instructions.join('\n');
+}
+
+export {
+  isClaudeCodeInstalled,
+  detectOS,
+  checkGitBashOnWindows,
+  getInstallationInstructions
+};