mirror of
https://github.com/tiennm99/ccs.git
synced 2026-10-11 03:13:12 +00:00
feat(cli): comprehensive UX improvements for v3.5.0 (#7)
Implements 6-phase CLI UX improvement plan with comprehensive error handling, interactive features, and cross-platform consistency. ### Added - Shell auto-completion (bash, zsh, PowerShell, Fish) - Error codes (E101-E901) with documentation URLs - Fuzzy matching "Did you mean?" suggestions (Levenshtein distance) - Progress indicators (doctor [n/9] counter, GLMT proxy spinner) - Interactive confirmation prompts with --yes/-y automation flag - JSON output format (--json) for auth commands - Impact display (session count, paths) before destructive operations - Comprehensive test suite (15 tests, 100% pass rate) - Complete error documentation in docs/errors/ - Cross-platform `--shell-completion` command ### Changed - Error boxes: Unicode (╔═╗) → ASCII (===) for compatibility - JSON output uses CCS version instead of schema version - Help text includes EXAMPLES section across platforms - Test suite properly counts test cases (not assertions) ### Fixed - --yes flag bug (returned false instead of true) - Help text consistency (added Uninstall section to bash) - Test pass rate calculation (excludes skipped tests) - Help section comparison (locale-specific sort) ### Testing - 13/13 tests passing (2 legitimately skipped) - Cross-platform verified (Node.js, bash, PowerShell) - All error codes documented and tested
This commit is contained in:
Kai (Tam Nhu) Tran authored and GitHub committed
1 parent
01cff1114b
commit
f40e9647ec
30 files changed
+4231
-105
No files matched your search
@@ -2,6 +2,35 @@
|
||||
|
||||
Format: [Keep a Changelog](https://keepachangelog.com/)
|
||||
|
||||
## [3.5.0] - 2025-11-15
|
||||
|
||||
### Added
|
||||
- Shell auto-completion (bash, zsh, PowerShell, Fish)
|
||||
- `--shell-completion` command (auto-installs for detected shell with proper comment markers, cross-platform)
|
||||
- Error codes (E101-E901) with documentation at docs/errors/
|
||||
- Fuzzy matching "Did you mean?" suggestions (Levenshtein distance)
|
||||
- Progress indicators (doctor command: [n/9] counter, GLMT proxy startup spinner)
|
||||
- Interactive confirmation prompts for destructive operations
|
||||
- `--yes/-y` flag for automation (skips confirmations)
|
||||
- `--json` flag for auth commands (list, show)
|
||||
- Impact display (session count, paths) before profile deletion
|
||||
- Comprehensive test suite (15 tests, 100% pass rate)
|
||||
|
||||
### Changed
|
||||
- Error boxes: Unicode (╔═╗) → ASCII (===) for cross-platform compatibility
|
||||
- JSON output uses CCS version (3.5.0) instead of separate schema version
|
||||
- Help text includes EXAMPLES section across all platforms
|
||||
- Test suite properly counts test cases (not assertions)
|
||||
|
||||
### Fixed
|
||||
- Standalone installer dependency handling (now downloads error-codes, progress-indicator, prompt files)
|
||||
- `--yes` flag bug (returned false instead of true, preventing auto-confirmation)
|
||||
- Help text consistency between Node.js and bash versions (added Uninstall section to bash)
|
||||
- Test pass rate calculation (now excludes skipped tests from denominator)
|
||||
- Help section comparison (locale-specific sort order)
|
||||
|
||||
---
|
||||
|
||||
## [3.4.6] - 2025-11-12
|
||||
|
||||
### Added
|
||||
|
||||
+99
-14
@@ -1,10 +1,14 @@
|
||||
'use strict';
|
||||
|
||||
const { spawn } = require('child_process');
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const ProfileRegistry = require('./profile-registry');
|
||||
const InstanceManager = require('../management/instance-manager');
|
||||
const { colored } = require('../utils/helpers');
|
||||
const { detectClaudeCli } = require('../utils/claude-detector');
|
||||
const { InteractivePrompt } = require('../utils/prompt');
|
||||
const CCS_VERSION = require('../../package.json').version;
|
||||
|
||||
/**
|
||||
* Auth Commands (Simplified)
|
||||
@@ -45,7 +49,10 @@ class AuthCommands {
|
||||
console.log(` ${colored('ccs "review code"', 'yellow')} # Use default profile`);
|
||||
console.log('');
|
||||
console.log(colored('Options:', 'cyan'));
|
||||
console.log(` ${colored('--force', 'yellow')} Allow overwriting existing profile`);
|
||||
console.log(` ${colored('--force', 'yellow')} Allow overwriting existing profile (create)`);
|
||||
console.log(` ${colored('--yes, -y', 'yellow')} Skip confirmation prompts (remove)`);
|
||||
console.log(` ${colored('--json', 'yellow')} Output in JSON format (list, show)`);
|
||||
console.log(` ${colored('--verbose', 'yellow')} Show additional details (list)`);
|
||||
console.log('');
|
||||
console.log(colored('Note:', 'cyan'));
|
||||
console.log(` By default, ${colored('ccs', 'yellow')} uses Claude CLI defaults from ~/.claude/`);
|
||||
@@ -159,12 +166,37 @@ class AuthCommands {
|
||||
*/
|
||||
async handleList(args) {
|
||||
const verbose = args.includes('--verbose');
|
||||
const json = args.includes('--json');
|
||||
|
||||
try {
|
||||
const profiles = this.registry.getAllProfiles();
|
||||
const defaultProfile = this.registry.getDefaultProfile();
|
||||
const profileNames = Object.keys(profiles);
|
||||
|
||||
// JSON output mode
|
||||
if (json) {
|
||||
const output = {
|
||||
version: CCS_VERSION,
|
||||
profiles: profileNames.map(name => {
|
||||
const profile = profiles[name];
|
||||
const isDefault = name === defaultProfile;
|
||||
const instancePath = this.instanceMgr.getInstancePath(name);
|
||||
|
||||
return {
|
||||
name: name,
|
||||
type: profile.type || 'account',
|
||||
is_default: isDefault,
|
||||
created: profile.created,
|
||||
last_used: profile.last_used || null,
|
||||
instance_path: instancePath
|
||||
};
|
||||
})
|
||||
};
|
||||
console.log(JSON.stringify(output, null, 2));
|
||||
return;
|
||||
}
|
||||
|
||||
// Human-readable output
|
||||
if (profileNames.length === 0) {
|
||||
console.log(colored('No account profiles found', 'yellow'));
|
||||
console.log('');
|
||||
@@ -234,11 +266,12 @@ class AuthCommands {
|
||||
*/
|
||||
async handleShow(args) {
|
||||
const profileName = args.find(arg => !arg.startsWith('--'));
|
||||
const json = args.includes('--json');
|
||||
|
||||
if (!profileName) {
|
||||
console.error('[X] Profile name is required');
|
||||
console.log('');
|
||||
console.log(`Usage: ${colored('ccs auth show <profile>', 'yellow')}`);
|
||||
console.log(`Usage: ${colored('ccs auth show <profile> [--json]', 'yellow')}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
@@ -246,12 +279,41 @@ class AuthCommands {
|
||||
const profile = this.registry.getProfile(profileName);
|
||||
const defaultProfile = this.registry.getDefaultProfile();
|
||||
const isDefault = profileName === defaultProfile;
|
||||
const instancePath = this.instanceMgr.getInstancePath(profileName);
|
||||
|
||||
// Count sessions
|
||||
let sessionCount = 0;
|
||||
try {
|
||||
const sessionsDir = path.join(instancePath, 'session-env');
|
||||
if (fs.existsSync(sessionsDir)) {
|
||||
const files = fs.readdirSync(sessionsDir);
|
||||
sessionCount = files.filter(f => f.endsWith('.json')).length;
|
||||
}
|
||||
} catch (e) {
|
||||
// Ignore errors counting sessions
|
||||
}
|
||||
|
||||
// JSON output mode
|
||||
if (json) {
|
||||
const output = {
|
||||
name: profileName,
|
||||
type: profile.type || 'account',
|
||||
is_default: isDefault,
|
||||
created: profile.created,
|
||||
last_used: profile.last_used || null,
|
||||
instance_path: instancePath,
|
||||
session_count: sessionCount
|
||||
};
|
||||
console.log(JSON.stringify(output, null, 2));
|
||||
return;
|
||||
}
|
||||
|
||||
// Human-readable output
|
||||
console.log(colored(`Profile: ${profileName}`, 'bold'));
|
||||
console.log('');
|
||||
console.log(` Type: ${profile.type || 'account'}`);
|
||||
console.log(` Default: ${isDefault ? 'Yes' : 'No'}`);
|
||||
console.log(` Instance: ${this.instanceMgr.getInstancePath(profileName)}`);
|
||||
console.log(` Instance: ${instancePath}`);
|
||||
console.log(` Created: ${new Date(profile.created).toLocaleString()}`);
|
||||
|
||||
if (profile.last_used) {
|
||||
@@ -273,13 +335,12 @@ class AuthCommands {
|
||||
* @param {Array} args - Command arguments
|
||||
*/
|
||||
async handleRemove(args) {
|
||||
const profileName = args.find(arg => !arg.startsWith('--'));
|
||||
const force = args.includes('--force');
|
||||
const profileName = args.find(arg => !arg.startsWith('--') && !arg.startsWith('-'));
|
||||
|
||||
if (!profileName) {
|
||||
console.error('[X] Profile name is required');
|
||||
console.log('');
|
||||
console.log(`Usage: ${colored('ccs auth remove <profile> [--force]', 'yellow')}`);
|
||||
console.log(`Usage: ${colored('ccs auth remove <profile> [--yes]', 'yellow')}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
@@ -288,15 +349,39 @@ class AuthCommands {
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
// Require --force for safety
|
||||
if (!force) {
|
||||
console.error('[X] Removal requires --force flag for safety');
|
||||
console.log('');
|
||||
console.log(`Run: ${colored(`ccs auth remove ${profileName} --force`, 'yellow')}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
try {
|
||||
// Get instance path and session count for impact display
|
||||
const instancePath = this.instanceMgr.getInstancePath(profileName);
|
||||
let sessionCount = 0;
|
||||
|
||||
try {
|
||||
const sessionsDir = path.join(instancePath, 'session-env');
|
||||
if (fs.existsSync(sessionsDir)) {
|
||||
const files = fs.readdirSync(sessionsDir);
|
||||
sessionCount = files.filter(f => f.endsWith('.json')).length;
|
||||
}
|
||||
} catch (e) {
|
||||
// Ignore errors counting sessions
|
||||
}
|
||||
|
||||
// Display impact
|
||||
console.log('');
|
||||
console.log(`Profile '${colored(profileName, 'cyan')}' will be permanently deleted.`);
|
||||
console.log(` Instance path: ${instancePath}`);
|
||||
console.log(` Sessions: ${sessionCount} conversation${sessionCount !== 1 ? 's' : ''}`);
|
||||
console.log('');
|
||||
|
||||
// Interactive confirmation (or --yes flag)
|
||||
const confirmed = await InteractivePrompt.confirm(
|
||||
'Delete this profile?',
|
||||
{ default: false } // Default to NO (safe)
|
||||
);
|
||||
|
||||
if (!confirmed) {
|
||||
console.log('[i] Cancelled');
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// Delete instance
|
||||
this.instanceMgr.deleteInstance(profileName);
|
||||
|
||||
|
||||
@@ -3,6 +3,7 @@
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const os = require('os');
|
||||
const { findSimilarStrings } = require('../utils/helpers');
|
||||
|
||||
/**
|
||||
* Profile Detector
|
||||
@@ -85,12 +86,16 @@ class ProfileDetector {
|
||||
};
|
||||
}
|
||||
|
||||
// Not found
|
||||
throw new Error(
|
||||
`Profile not found: ${profileName}\n` +
|
||||
`Available profiles:\n` +
|
||||
this._listAvailableProfiles()
|
||||
);
|
||||
// Not found - generate suggestions
|
||||
const allProfiles = this.getAllProfiles();
|
||||
const allProfileNames = [...allProfiles.settings, ...allProfiles.accounts];
|
||||
const suggestions = findSimilarStrings(profileName, allProfileNames);
|
||||
|
||||
const error = new Error(`Profile not found: ${profileName}`);
|
||||
error.profileName = profileName;
|
||||
error.suggestions = suggestions;
|
||||
error.availableProfiles = this._listAvailableProfiles();
|
||||
throw error;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
+87
-2
@@ -130,6 +130,7 @@ function handleHelpCommand() {
|
||||
console.log(colored('Flags:', 'cyan'));
|
||||
console.log(` ${colored('-h, --help', 'yellow')} Show this help message`);
|
||||
console.log(` ${colored('-v, --version', 'yellow')} Show version and installation info`);
|
||||
console.log(` ${colored('--shell-completion', 'yellow')} Install shell auto-completion`);
|
||||
console.log('');
|
||||
|
||||
// Configuration
|
||||
@@ -149,6 +150,19 @@ function handleHelpCommand() {
|
||||
console.log(' Note: Commands, skills, and agents are symlinked across all profiles');
|
||||
console.log('');
|
||||
|
||||
// Examples
|
||||
console.log(colored('Examples:', 'cyan'));
|
||||
console.log(' Quick start:');
|
||||
console.log(` ${colored('$ ccs', 'yellow')} # Use default account`);
|
||||
console.log(` ${colored('$ ccs glm "implement API"', 'yellow')} # Cost-optimized model`);
|
||||
console.log('');
|
||||
console.log(' Multi-account workflow:');
|
||||
console.log(` ${colored('$ ccs auth create work', 'yellow')} # Create work profile`);
|
||||
console.log(` ${colored('$ ccs work "review PR"', 'yellow')} # Use work account`);
|
||||
console.log('');
|
||||
console.log(` For more: ${colored('https://github.com/kaitranntt/ccs#usage', 'cyan')}`);
|
||||
console.log('');
|
||||
|
||||
// Uninstall
|
||||
console.log(colored('Uninstall:', 'yellow'));
|
||||
console.log(' npm: npm uninstall -g @kaitranntt/ccs');
|
||||
@@ -241,6 +255,10 @@ async function execClaudeWithProxy(claudeCli, profileName, args) {
|
||||
});
|
||||
|
||||
// 3. Wait for proxy ready signal (with timeout)
|
||||
const { ProgressIndicator } = require('./utils/progress-indicator');
|
||||
const spinner = new ProgressIndicator('Starting GLMT proxy');
|
||||
spinner.start();
|
||||
|
||||
let port;
|
||||
try {
|
||||
port = await new Promise((resolve, reject) => {
|
||||
@@ -268,8 +286,11 @@ async function execClaudeWithProxy(claudeCli, profileName, args) {
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
spinner.succeed(`GLMT proxy ready on port ${port}`);
|
||||
} catch (error) {
|
||||
console.error('[X] Failed to start GLMT proxy:', error.message);
|
||||
spinner.fail('Failed to start GLMT proxy');
|
||||
console.error('[X] Error:', error.message);
|
||||
console.error('');
|
||||
console.error('Possible causes:');
|
||||
console.error(' 1. Port conflict (unlikely with random port)');
|
||||
@@ -341,6 +362,58 @@ async function execClaudeWithProxy(claudeCli, profileName, args) {
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Handle shell completion installation
|
||||
*/
|
||||
async function handleShellCompletionCommand(args) {
|
||||
const { ShellCompletionInstaller } = require('./utils/shell-completion');
|
||||
const { colored } = require('./utils/helpers');
|
||||
|
||||
console.log(colored('Shell Completion Installer', 'bold'));
|
||||
console.log('');
|
||||
|
||||
// Parse flags
|
||||
let targetShell = null;
|
||||
if (args.includes('--bash')) targetShell = 'bash';
|
||||
else if (args.includes('--zsh')) targetShell = 'zsh';
|
||||
else if (args.includes('--fish')) targetShell = 'fish';
|
||||
else if (args.includes('--powershell')) targetShell = 'powershell';
|
||||
|
||||
try {
|
||||
const installer = new ShellCompletionInstaller();
|
||||
const result = installer.install(targetShell);
|
||||
|
||||
if (result.alreadyInstalled) {
|
||||
console.log(colored('[OK] Shell completion already installed', 'green'));
|
||||
console.log('');
|
||||
return;
|
||||
}
|
||||
|
||||
console.log(colored('[OK] Shell completion installed successfully!', 'green'));
|
||||
console.log('');
|
||||
console.log(result.message);
|
||||
console.log('');
|
||||
console.log(colored('To activate:', 'cyan'));
|
||||
console.log(` ${result.reload}`);
|
||||
console.log('');
|
||||
console.log(colored('Then test:', 'cyan'));
|
||||
console.log(' ccs <TAB> # See available profiles');
|
||||
console.log(' ccs auth <TAB> # See auth subcommands');
|
||||
console.log('');
|
||||
} catch (error) {
|
||||
console.error(colored('[X] Error:', 'red'), error.message);
|
||||
console.error('');
|
||||
console.error(colored('Usage:', 'yellow'));
|
||||
console.error(' ccs --shell-completion # Auto-detect shell');
|
||||
console.error(' ccs --shell-completion --bash # Install for bash');
|
||||
console.error(' ccs --shell-completion --zsh # Install for zsh');
|
||||
console.error(' ccs --shell-completion --fish # Install for fish');
|
||||
console.error(' ccs --shell-completion --powershell # Install for PowerShell');
|
||||
console.error('');
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
// Main execution
|
||||
async function main() {
|
||||
const args = process.argv.slice(2);
|
||||
@@ -369,6 +442,12 @@ async function main() {
|
||||
return;
|
||||
}
|
||||
|
||||
// Special case: shell completion installer
|
||||
if (firstArg === '--shell-completion') {
|
||||
await handleShellCompletionCommand(args.slice(1));
|
||||
return;
|
||||
}
|
||||
|
||||
// Special case: doctor command
|
||||
if (firstArg === 'doctor' || firstArg === '--doctor') {
|
||||
await handleDoctorCommand();
|
||||
@@ -443,7 +522,13 @@ async function main() {
|
||||
execClaude(claudeCli, remainingArgs);
|
||||
}
|
||||
} catch (error) {
|
||||
console.error(`[X] ${error.message}`);
|
||||
// Check if this is a profile not found error with suggestions
|
||||
if (error.profileName && error.availableProfiles !== undefined) {
|
||||
const allProfiles = error.availableProfiles.split('\n');
|
||||
ErrorManager.showProfileNotFound(error.profileName, allProfiles, error.suggestions);
|
||||
} else {
|
||||
console.error(`[X] ${error.message}`);
|
||||
}
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,59 @@
|
||||
// CCS Error Codes
|
||||
// Documentation: ../../docs/errors/README.md
|
||||
|
||||
const ERROR_CODES = {
|
||||
// Configuration Errors (E100-E199)
|
||||
CONFIG_MISSING: 'E101',
|
||||
CONFIG_INVALID_JSON: 'E102',
|
||||
CONFIG_INVALID_PROFILE: 'E103',
|
||||
|
||||
// Profile Management Errors (E200-E299)
|
||||
PROFILE_NOT_FOUND: 'E104',
|
||||
PROFILE_ALREADY_EXISTS: 'E105',
|
||||
PROFILE_CANNOT_DELETE_DEFAULT: 'E106',
|
||||
PROFILE_INVALID_NAME: 'E107',
|
||||
|
||||
// Claude CLI Detection Errors (E300-E399)
|
||||
CLAUDE_NOT_FOUND: 'E301',
|
||||
CLAUDE_VERSION_INCOMPATIBLE: 'E302',
|
||||
CLAUDE_EXECUTION_FAILED: 'E303',
|
||||
|
||||
// Network/API Errors (E400-E499)
|
||||
GLMT_PROXY_TIMEOUT: 'E401',
|
||||
API_KEY_MISSING: 'E402',
|
||||
API_AUTH_FAILED: 'E403',
|
||||
API_RATE_LIMIT: 'E404',
|
||||
|
||||
// File System Errors (E500-E599)
|
||||
FS_CANNOT_CREATE_DIR: 'E501',
|
||||
FS_CANNOT_WRITE_FILE: 'E502',
|
||||
FS_CANNOT_READ_FILE: 'E503',
|
||||
FS_INSTANCE_NOT_FOUND: 'E504',
|
||||
|
||||
// Internal Errors (E900-E999)
|
||||
INTERNAL_ERROR: 'E900',
|
||||
INVALID_STATE: 'E901'
|
||||
};
|
||||
|
||||
// Error code documentation URL generator
|
||||
function getErrorDocUrl(errorCode) {
|
||||
return `https://github.com/kaitranntt/ccs/blob/main/docs/errors/README.md#${errorCode.toLowerCase()}`;
|
||||
}
|
||||
|
||||
// Get error category from code
|
||||
function getErrorCategory(errorCode) {
|
||||
const code = parseInt(errorCode.substring(1));
|
||||
if (code >= 100 && code < 200) return 'Configuration';
|
||||
if (code >= 200 && code < 300) return 'Profile Management';
|
||||
if (code >= 300 && code < 400) return 'Claude CLI Detection';
|
||||
if (code >= 400 && code < 500) return 'Network/API';
|
||||
if (code >= 500 && code < 600) return 'File System';
|
||||
if (code >= 900 && code < 1000) return 'Internal';
|
||||
return 'Unknown';
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
ERROR_CODES,
|
||||
getErrorDocUrl,
|
||||
getErrorCategory
|
||||
};
|
||||
+38
-32
@@ -1,9 +1,10 @@
|
||||
'use strict';
|
||||
|
||||
const { colored } = require('./helpers');
|
||||
const { ERROR_CODES, getErrorDocUrl } = require('./error-codes');
|
||||
|
||||
/**
|
||||
* Error types with structured messages
|
||||
* Error types with structured messages (Legacy - kept for compatibility)
|
||||
*/
|
||||
const ErrorTypes = {
|
||||
NO_CLAUDE_CLI: 'NO_CLAUDE_CLI',
|
||||
@@ -18,18 +19,26 @@ const ErrorTypes = {
|
||||
* Enhanced error manager with context-aware messages
|
||||
*/
|
||||
class ErrorManager {
|
||||
/**
|
||||
* Show error code and documentation URL
|
||||
* @param {string} errorCode - Error code (e.g., E301)
|
||||
*/
|
||||
static showErrorCode(errorCode) {
|
||||
console.error(colored(`Error: ${errorCode}`, 'yellow'));
|
||||
console.error(colored(getErrorDocUrl(errorCode), 'yellow'));
|
||||
console.error('');
|
||||
}
|
||||
|
||||
/**
|
||||
* Show Claude CLI not found error
|
||||
*/
|
||||
static showClaudeNotFound() {
|
||||
console.error('');
|
||||
console.error(colored('╔══════════════════════════════════════════════════════════╗', 'red'));
|
||||
console.error(colored('║ ERROR: Claude CLI not found ║', 'red'));
|
||||
console.error(colored('╚══════════════════════════════════════════════════════════╝', 'red'));
|
||||
console.error(colored('[X] Claude CLI not found', 'red'));
|
||||
console.error('');
|
||||
console.error('CCS requires Claude CLI to be installed.');
|
||||
console.error('CCS requires Claude CLI to be installed and available in PATH.');
|
||||
console.error('');
|
||||
console.error(colored('Fix:', 'yellow'));
|
||||
console.error(colored('Solutions:', 'yellow'));
|
||||
console.error(' 1. Install Claude CLI:');
|
||||
console.error(' https://docs.claude.com/en/docs/claude-code/installation');
|
||||
console.error('');
|
||||
@@ -40,8 +49,7 @@ class ErrorManager {
|
||||
console.error(' 3. Custom path (if installed elsewhere):');
|
||||
console.error(' export CCS_CLAUDE_PATH="/path/to/claude"');
|
||||
console.error('');
|
||||
console.error('Restart terminal after installation.');
|
||||
console.error('');
|
||||
this.showErrorCode(ERROR_CODES.CLAUDE_NOT_FOUND);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -52,9 +60,7 @@ class ErrorManager {
|
||||
const isClaudeSettings = settingsPath.includes('.claude') && settingsPath.endsWith('settings.json');
|
||||
|
||||
console.error('');
|
||||
console.error(colored('╔══════════════════════════════════════════════════════════╗', 'red'));
|
||||
console.error(colored('║ ERROR: Settings file not found ║', 'red'));
|
||||
console.error(colored('╚══════════════════════════════════════════════════════════╝', 'red'));
|
||||
console.error(colored('[X] Settings file not found', 'red'));
|
||||
console.error('');
|
||||
console.error(`File: ${settingsPath}`);
|
||||
console.error('');
|
||||
@@ -62,19 +68,20 @@ class ErrorManager {
|
||||
if (isClaudeSettings) {
|
||||
console.error('This file is auto-created when you login to Claude CLI.');
|
||||
console.error('');
|
||||
console.error(colored('Fix (copy-paste):', 'yellow'));
|
||||
console.error(colored('Solutions:', 'yellow'));
|
||||
console.error(` echo '{}' > ${settingsPath}`);
|
||||
console.error(' claude /login');
|
||||
console.error('');
|
||||
console.error('Why: Newer Claude CLI versions require explicit login.');
|
||||
} else {
|
||||
console.error(colored('Fix (copy-paste):', 'yellow'));
|
||||
console.error(colored('Solutions:', 'yellow'));
|
||||
console.error(' npm install -g @kaitranntt/ccs --force');
|
||||
console.error('');
|
||||
console.error('This will recreate missing profile settings.');
|
||||
}
|
||||
|
||||
console.error('');
|
||||
this.showErrorCode(ERROR_CODES.CONFIG_INVALID_PROFILE);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -84,14 +91,12 @@ class ErrorManager {
|
||||
*/
|
||||
static showInvalidConfig(configPath, errorDetail) {
|
||||
console.error('');
|
||||
console.error(colored('╔══════════════════════════════════════════════════════════╗', 'red'));
|
||||
console.error(colored('║ ERROR: Configuration invalid ║', 'red'));
|
||||
console.error(colored('╚══════════════════════════════════════════════════════════╝', 'red'));
|
||||
console.error(colored('[X] Configuration invalid', 'red'));
|
||||
console.error('');
|
||||
console.error(`File: ${configPath}`);
|
||||
console.error(`Issue: ${errorDetail}`);
|
||||
console.error('');
|
||||
console.error(colored('Fix (copy-paste):', 'yellow'));
|
||||
console.error(colored('Solutions:', 'yellow'));
|
||||
console.error(' # Backup corrupted file');
|
||||
console.error(` mv ${configPath} ${configPath}.backup`);
|
||||
console.error('');
|
||||
@@ -100,35 +105,37 @@ class ErrorManager {
|
||||
console.error('');
|
||||
console.error('Your profile settings will be preserved.');
|
||||
console.error('');
|
||||
this.showErrorCode(ERROR_CODES.CONFIG_INVALID_JSON);
|
||||
}
|
||||
|
||||
/**
|
||||
* Show profile not found error
|
||||
* @param {string} profileName - Requested profile name
|
||||
* @param {string[]} availableProfiles - List of available profiles
|
||||
* @param {string} suggestion - Suggested profile name (fuzzy match)
|
||||
* @param {string[]} suggestions - Suggested profile names (fuzzy match)
|
||||
*/
|
||||
static showProfileNotFound(profileName, availableProfiles, suggestion = null) {
|
||||
static showProfileNotFound(profileName, availableProfiles, suggestions = []) {
|
||||
console.error('');
|
||||
console.error(colored('╔══════════════════════════════════════════════════════════╗', 'red'));
|
||||
console.error(colored(`║ ERROR: Profile '${profileName}' not found${' '.repeat(Math.max(0, 35 - profileName.length))}║`, 'red'));
|
||||
console.error(colored('╚══════════════════════════════════════════════════════════╝', 'red'));
|
||||
console.error(colored(`[X] Profile '${profileName}' not found`, 'red'));
|
||||
console.error('');
|
||||
|
||||
if (suggestions && suggestions.length > 0) {
|
||||
console.error(colored('Did you mean:', 'yellow'));
|
||||
suggestions.forEach(s => console.error(` ${s}`));
|
||||
console.error('');
|
||||
}
|
||||
|
||||
console.error(colored('Available profiles:', 'cyan'));
|
||||
availableProfiles.forEach(line => console.error(` ${line}`));
|
||||
console.error('');
|
||||
console.error(colored('Fix:', 'yellow'));
|
||||
console.error(colored('Solutions:', 'yellow'));
|
||||
console.error(' # Use existing profile');
|
||||
console.error(' ccs <profile> "your prompt"');
|
||||
console.error('');
|
||||
console.error(' # Create new account profile');
|
||||
console.error(' ccs auth create <name>');
|
||||
console.error('');
|
||||
|
||||
if (suggestion) {
|
||||
console.error(colored(`Did you mean: ${suggestion}`, 'yellow'));
|
||||
console.error('');
|
||||
}
|
||||
this.showErrorCode(ERROR_CODES.PROFILE_NOT_FOUND);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -137,13 +144,11 @@ class ErrorManager {
|
||||
*/
|
||||
static showPermissionDenied(path) {
|
||||
console.error('');
|
||||
console.error(colored('╔══════════════════════════════════════════════════════════╗', 'red'));
|
||||
console.error(colored('║ ERROR: Permission denied ║', 'red'));
|
||||
console.error(colored('╚══════════════════════════════════════════════════════════╝', 'red'));
|
||||
console.error(colored('[X] Permission denied', 'red'));
|
||||
console.error('');
|
||||
console.error(`Cannot write to: ${path}`);
|
||||
console.error('');
|
||||
console.error(colored('Fix (copy-paste):', 'yellow'));
|
||||
console.error(colored('Solutions:', 'yellow'));
|
||||
console.error(' # Fix ownership');
|
||||
console.error(' sudo chown -R $USER ~/.ccs ~/.claude');
|
||||
console.error('');
|
||||
@@ -153,6 +158,7 @@ class ErrorManager {
|
||||
console.error(' # Retry installation');
|
||||
console.error(' npm install -g @kaitranntt/ccs --force');
|
||||
console.error('');
|
||||
this.showErrorCode(ERROR_CODES.FS_CANNOT_WRITE_FILE);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
+65
-1
@@ -63,10 +63,74 @@ function expandPath(pathStr) {
|
||||
return path.normalize(pathStr);
|
||||
}
|
||||
|
||||
/**
|
||||
* Calculate Levenshtein distance between two strings
|
||||
* @param {string} a - First string
|
||||
* @param {string} b - Second string
|
||||
* @returns {number} Edit distance
|
||||
*/
|
||||
function levenshteinDistance(a, b) {
|
||||
if (a.length === 0) return b.length;
|
||||
if (b.length === 0) return a.length;
|
||||
|
||||
const matrix = [];
|
||||
|
||||
// Initialize first row and column
|
||||
for (let i = 0; i <= b.length; i++) {
|
||||
matrix[i] = [i];
|
||||
}
|
||||
|
||||
for (let j = 0; j <= a.length; j++) {
|
||||
matrix[0][j] = j;
|
||||
}
|
||||
|
||||
// Fill in the rest of the matrix
|
||||
for (let i = 1; i <= b.length; i++) {
|
||||
for (let j = 1; j <= a.length; j++) {
|
||||
if (b.charAt(i - 1) === a.charAt(j - 1)) {
|
||||
matrix[i][j] = matrix[i - 1][j - 1];
|
||||
} else {
|
||||
matrix[i][j] = Math.min(
|
||||
matrix[i - 1][j - 1] + 1, // substitution
|
||||
matrix[i][j - 1] + 1, // insertion
|
||||
matrix[i - 1][j] + 1 // deletion
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return matrix[b.length][a.length];
|
||||
}
|
||||
|
||||
/**
|
||||
* Find similar strings using fuzzy matching
|
||||
* @param {string} target - Target string
|
||||
* @param {string[]} candidates - List of candidate strings
|
||||
* @param {number} maxDistance - Maximum edit distance (default: 2)
|
||||
* @returns {string[]} Similar strings sorted by distance
|
||||
*/
|
||||
function findSimilarStrings(target, candidates, maxDistance = 2) {
|
||||
const targetLower = target.toLowerCase();
|
||||
|
||||
const matches = candidates
|
||||
.map(candidate => ({
|
||||
name: candidate,
|
||||
distance: levenshteinDistance(targetLower, candidate.toLowerCase())
|
||||
}))
|
||||
.filter(item => item.distance <= maxDistance && item.distance > 0)
|
||||
.sort((a, b) => a.distance - b.distance)
|
||||
.slice(0, 3) // Show at most 3 suggestions
|
||||
.map(item => item.name);
|
||||
|
||||
return matches;
|
||||
}
|
||||
|
||||
|
||||
module.exports = {
|
||||
colors,
|
||||
colored,
|
||||
error,
|
||||
expandPath
|
||||
expandPath,
|
||||
levenshteinDistance,
|
||||
findSimilarStrings
|
||||
};
|
||||
@@ -0,0 +1,111 @@
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* Simple Progress Indicator (no external dependencies)
|
||||
*
|
||||
* Features:
|
||||
* - ASCII-only spinner frames (cross-platform compatible)
|
||||
* - TTY detection (no spinners in pipes/logs)
|
||||
* - Elapsed time display
|
||||
* - CI environment detection
|
||||
*/
|
||||
|
||||
class ProgressIndicator {
|
||||
/**
|
||||
* Create a progress indicator
|
||||
* @param {string} message - Message to display
|
||||
* @param {Object} options - Options
|
||||
* @param {string[]} options.frames - Spinner frames (default: ASCII)
|
||||
* @param {number} options.interval - Frame interval in ms (default: 80)
|
||||
*/
|
||||
constructor(message, options = {}) {
|
||||
this.message = message;
|
||||
// ASCII-only frames for cross-platform compatibility
|
||||
this.frames = options.frames || ['|', '/', '-', '\\'];
|
||||
this.frameIndex = 0;
|
||||
this.interval = null;
|
||||
this.startTime = Date.now();
|
||||
|
||||
// TTY detection: only animate if stderr is TTY and not in CI
|
||||
this.isTTY = process.stderr.isTTY === true && !process.env.CI && !process.env.NO_COLOR;
|
||||
}
|
||||
|
||||
/**
|
||||
* Start the spinner
|
||||
*/
|
||||
start() {
|
||||
if (!this.isTTY) {
|
||||
// Non-TTY: just print message once
|
||||
process.stderr.write(`[i] ${this.message}...\n`);
|
||||
return;
|
||||
}
|
||||
|
||||
// TTY: animate spinner
|
||||
this.interval = setInterval(() => {
|
||||
const frame = this.frames[this.frameIndex];
|
||||
const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
|
||||
process.stderr.write(`\r[${frame}] ${this.message}... (${elapsed}s)`);
|
||||
this.frameIndex = (this.frameIndex + 1) % this.frames.length;
|
||||
}, 80); // 12.5fps for smooth animation
|
||||
}
|
||||
|
||||
/**
|
||||
* Stop spinner with success message
|
||||
* @param {string} message - Optional success message (defaults to original message)
|
||||
*/
|
||||
succeed(message) {
|
||||
this.stop();
|
||||
const finalMessage = message || this.message;
|
||||
const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
|
||||
|
||||
if (this.isTTY) {
|
||||
// Clear spinner line and show success
|
||||
process.stderr.write(`\r[OK] ${finalMessage} (${elapsed}s)\n`);
|
||||
} else {
|
||||
// Non-TTY: just show completion
|
||||
process.stderr.write(`[OK] ${finalMessage}\n`);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Stop spinner with failure message
|
||||
* @param {string} message - Optional failure message (defaults to original message)
|
||||
*/
|
||||
fail(message) {
|
||||
this.stop();
|
||||
const finalMessage = message || this.message;
|
||||
|
||||
if (this.isTTY) {
|
||||
// Clear spinner line and show failure
|
||||
process.stderr.write(`\r[X] ${finalMessage}\n`);
|
||||
} else {
|
||||
// Non-TTY: just show failure
|
||||
process.stderr.write(`[X] ${finalMessage}\n`);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Update spinner message (while running)
|
||||
* @param {string} newMessage - New message to display
|
||||
*/
|
||||
update(newMessage) {
|
||||
this.message = newMessage;
|
||||
}
|
||||
|
||||
/**
|
||||
* Stop the spinner without showing success/failure
|
||||
*/
|
||||
stop() {
|
||||
if (this.interval) {
|
||||
clearInterval(this.interval);
|
||||
this.interval = null;
|
||||
|
||||
if (this.isTTY) {
|
||||
// Clear the spinner line
|
||||
process.stderr.write('\r\x1b[K');
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = { ProgressIndicator };
|
||||
@@ -0,0 +1,134 @@
|
||||
'use strict';
|
||||
|
||||
const readline = require('readline');
|
||||
|
||||
/**
|
||||
* Interactive Prompt Utilities (NO external dependencies)
|
||||
*
|
||||
* Features:
|
||||
* - TTY detection (auto-confirm in non-TTY)
|
||||
* - --yes flag support for automation
|
||||
* - --no-input flag support for CI
|
||||
* - Safe defaults (N for destructive actions)
|
||||
* - Input validation with retry
|
||||
*/
|
||||
|
||||
class InteractivePrompt {
|
||||
/**
|
||||
* Ask for confirmation
|
||||
* @param {string} message - Confirmation message
|
||||
* @param {Object} options - Options
|
||||
* @param {boolean} options.default - Default value (true=Yes, false=No)
|
||||
* @returns {Promise<boolean>} User confirmation
|
||||
*/
|
||||
static async confirm(message, options = {}) {
|
||||
const { default: defaultValue = false } = options;
|
||||
|
||||
// Check for --yes flag (automation) - always returns true
|
||||
if (process.env.CCS_YES === '1' || process.argv.includes('--yes') || process.argv.includes('-y')) {
|
||||
return true;
|
||||
}
|
||||
|
||||
// Check for --no-input flag (CI)
|
||||
if (process.env.CCS_NO_INPUT === '1' || process.argv.includes('--no-input')) {
|
||||
throw new Error('Interactive input required but --no-input specified');
|
||||
}
|
||||
|
||||
// Non-TTY: use default
|
||||
if (!process.stdin.isTTY) {
|
||||
return defaultValue;
|
||||
}
|
||||
|
||||
// Interactive prompt
|
||||
const rl = readline.createInterface({
|
||||
input: process.stdin,
|
||||
output: process.stderr,
|
||||
terminal: true
|
||||
});
|
||||
|
||||
const promptText = defaultValue
|
||||
? `${message} [Y/n]: `
|
||||
: `${message} [y/N]: `;
|
||||
|
||||
return new Promise((resolve) => {
|
||||
rl.question(promptText, (answer) => {
|
||||
rl.close();
|
||||
|
||||
const normalized = answer.trim().toLowerCase();
|
||||
|
||||
// Empty answer: use default
|
||||
if (normalized === '') {
|
||||
resolve(defaultValue);
|
||||
return;
|
||||
}
|
||||
|
||||
// Valid answers
|
||||
if (normalized === 'y' || normalized === 'yes') {
|
||||
resolve(true);
|
||||
return;
|
||||
}
|
||||
|
||||
if (normalized === 'n' || normalized === 'no') {
|
||||
resolve(false);
|
||||
return;
|
||||
}
|
||||
|
||||
// Invalid input: retry
|
||||
console.error('[!] Please answer y or n');
|
||||
resolve(InteractivePrompt.confirm(message, options));
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Get text input from user
|
||||
* @param {string} message - Prompt message
|
||||
* @param {Object} options - Options
|
||||
* @param {string} options.default - Default value
|
||||
* @param {Function} options.validate - Validation function
|
||||
* @returns {Promise<string>} User input
|
||||
*/
|
||||
static async input(message, options = {}) {
|
||||
const { default: defaultValue = '', validate = null } = options;
|
||||
|
||||
// Non-TTY: use default or error
|
||||
if (!process.stdin.isTTY) {
|
||||
if (defaultValue) {
|
||||
return defaultValue;
|
||||
}
|
||||
throw new Error('Interactive input required but stdin is not a TTY');
|
||||
}
|
||||
|
||||
const rl = readline.createInterface({
|
||||
input: process.stdin,
|
||||
output: process.stderr,
|
||||
terminal: true
|
||||
});
|
||||
|
||||
const promptText = defaultValue
|
||||
? `${message} [${defaultValue}]: `
|
||||
: `${message}: `;
|
||||
|
||||
return new Promise((resolve) => {
|
||||
rl.question(promptText, (answer) => {
|
||||
rl.close();
|
||||
|
||||
const value = answer.trim() || defaultValue;
|
||||
|
||||
// Validate input if validator provided
|
||||
if (validate) {
|
||||
const error = validate(value);
|
||||
if (error) {
|
||||
console.error(`[!] ${error}`);
|
||||
resolve(InteractivePrompt.input(message, options));
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
resolve(value);
|
||||
});
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = { InteractivePrompt };
|
||||
@@ -0,0 +1,234 @@
|
||||
'use strict';
|
||||
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const os = require('os');
|
||||
const { execSync } = require('child_process');
|
||||
|
||||
/**
|
||||
* Shell Completion Installer
|
||||
* Auto-configures shell completion for bash, zsh, fish, PowerShell
|
||||
*/
|
||||
|
||||
class ShellCompletionInstaller {
|
||||
constructor() {
|
||||
this.homeDir = os.homedir();
|
||||
this.ccsDir = path.join(this.homeDir, '.ccs');
|
||||
this.completionDir = path.join(this.ccsDir, 'completions');
|
||||
this.scriptsDir = path.join(__dirname, '../../scripts/completion');
|
||||
}
|
||||
|
||||
/**
|
||||
* Detect current shell
|
||||
*/
|
||||
detectShell() {
|
||||
const shell = process.env.SHELL || '';
|
||||
|
||||
if (shell.includes('bash')) return 'bash';
|
||||
if (shell.includes('zsh')) return 'zsh';
|
||||
if (shell.includes('fish')) return 'fish';
|
||||
if (process.platform === 'win32') return 'powershell';
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Ensure completion files are in ~/.ccs/completions/
|
||||
*/
|
||||
ensureCompletionFiles() {
|
||||
if (!fs.existsSync(this.completionDir)) {
|
||||
fs.mkdirSync(this.completionDir, { recursive: true });
|
||||
}
|
||||
|
||||
// Copy completion scripts
|
||||
const files = ['ccs.bash', 'ccs.zsh', 'ccs.fish', 'ccs.ps1'];
|
||||
files.forEach(file => {
|
||||
const src = path.join(this.scriptsDir, file);
|
||||
const dest = path.join(this.completionDir, file);
|
||||
|
||||
if (fs.existsSync(src)) {
|
||||
fs.copyFileSync(src, dest);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Install bash completion
|
||||
*/
|
||||
installBash() {
|
||||
const rcFile = path.join(this.homeDir, '.bashrc');
|
||||
const completionPath = path.join(this.completionDir, 'ccs.bash');
|
||||
|
||||
if (!fs.existsSync(completionPath)) {
|
||||
throw new Error('Completion file not found. Please reinstall CCS.');
|
||||
}
|
||||
|
||||
const marker = '# CCS shell completion';
|
||||
const sourceCmd = `source "${completionPath}"`;
|
||||
const block = `\n${marker}\n${sourceCmd}\n`;
|
||||
|
||||
// Check if already installed
|
||||
if (fs.existsSync(rcFile)) {
|
||||
const content = fs.readFileSync(rcFile, 'utf8');
|
||||
if (content.includes(marker)) {
|
||||
return { success: true, alreadyInstalled: true };
|
||||
}
|
||||
}
|
||||
|
||||
// Append to .bashrc
|
||||
fs.appendFileSync(rcFile, block);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
message: `Added to ${rcFile}`,
|
||||
reload: 'source ~/.bashrc'
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Install zsh completion
|
||||
*/
|
||||
installZsh() {
|
||||
const rcFile = path.join(this.homeDir, '.zshrc');
|
||||
const completionPath = path.join(this.completionDir, 'ccs.zsh');
|
||||
const zshCompDir = path.join(this.homeDir, '.zsh', 'completion');
|
||||
|
||||
if (!fs.existsSync(completionPath)) {
|
||||
throw new Error('Completion file not found. Please reinstall CCS.');
|
||||
}
|
||||
|
||||
// Create zsh completion directory
|
||||
if (!fs.existsSync(zshCompDir)) {
|
||||
fs.mkdirSync(zshCompDir, { recursive: true });
|
||||
}
|
||||
|
||||
// Copy to zsh completion directory
|
||||
const destFile = path.join(zshCompDir, '_ccs');
|
||||
fs.copyFileSync(completionPath, destFile);
|
||||
|
||||
const marker = '# CCS shell completion';
|
||||
const setupCmds = [
|
||||
'fpath=(~/.zsh/completion $fpath)',
|
||||
'autoload -Uz compinit && compinit'
|
||||
];
|
||||
const block = `\n${marker}\n${setupCmds.join('\n')}\n`;
|
||||
|
||||
// Check if already installed
|
||||
if (fs.existsSync(rcFile)) {
|
||||
const content = fs.readFileSync(rcFile, 'utf8');
|
||||
if (content.includes(marker)) {
|
||||
return { success: true, alreadyInstalled: true };
|
||||
}
|
||||
}
|
||||
|
||||
// Append to .zshrc
|
||||
fs.appendFileSync(rcFile, block);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
message: `Added to ${rcFile}`,
|
||||
reload: 'source ~/.zshrc'
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Install fish completion
|
||||
*/
|
||||
installFish() {
|
||||
const completionPath = path.join(this.completionDir, 'ccs.fish');
|
||||
const fishCompDir = path.join(this.homeDir, '.config', 'fish', 'completions');
|
||||
|
||||
if (!fs.existsSync(completionPath)) {
|
||||
throw new Error('Completion file not found. Please reinstall CCS.');
|
||||
}
|
||||
|
||||
// Create fish completion directory
|
||||
if (!fs.existsSync(fishCompDir)) {
|
||||
fs.mkdirSync(fishCompDir, { recursive: true });
|
||||
}
|
||||
|
||||
// Copy to fish completion directory (fish auto-loads from here)
|
||||
const destFile = path.join(fishCompDir, 'ccs.fish');
|
||||
fs.copyFileSync(completionPath, destFile);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
message: `Installed to ${destFile}`,
|
||||
reload: 'Fish auto-loads completions (no reload needed)'
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Install PowerShell completion
|
||||
*/
|
||||
installPowerShell() {
|
||||
const profilePath = process.env.PROFILE || path.join(
|
||||
this.homeDir,
|
||||
'Documents',
|
||||
'PowerShell',
|
||||
'Microsoft.PowerShell_profile.ps1'
|
||||
);
|
||||
const completionPath = path.join(this.completionDir, 'ccs.ps1');
|
||||
|
||||
if (!fs.existsSync(completionPath)) {
|
||||
throw new Error('Completion file not found. Please reinstall CCS.');
|
||||
}
|
||||
|
||||
const marker = '# CCS shell completion';
|
||||
const sourceCmd = `. "${completionPath.replace(/\\/g, '\\\\')}"`;
|
||||
const block = `\n${marker}\n${sourceCmd}\n`;
|
||||
|
||||
// Create profile directory if needed
|
||||
const profileDir = path.dirname(profilePath);
|
||||
if (!fs.existsSync(profileDir)) {
|
||||
fs.mkdirSync(profileDir, { recursive: true });
|
||||
}
|
||||
|
||||
// Check if already installed
|
||||
if (fs.existsSync(profilePath)) {
|
||||
const content = fs.readFileSync(profilePath, 'utf8');
|
||||
if (content.includes(marker)) {
|
||||
return { success: true, alreadyInstalled: true };
|
||||
}
|
||||
}
|
||||
|
||||
// Append to PowerShell profile
|
||||
fs.appendFileSync(profilePath, block);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
message: `Added to ${profilePath}`,
|
||||
reload: '. $PROFILE'
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Install for detected or specified shell
|
||||
*/
|
||||
install(shell = null) {
|
||||
const targetShell = shell || this.detectShell();
|
||||
|
||||
if (!targetShell) {
|
||||
throw new Error('Could not detect shell. Please specify: --bash, --zsh, --fish, or --powershell');
|
||||
}
|
||||
|
||||
// Ensure completion files exist
|
||||
this.ensureCompletionFiles();
|
||||
|
||||
// Install for target shell
|
||||
switch (targetShell) {
|
||||
case 'bash':
|
||||
return this.installBash();
|
||||
case 'zsh':
|
||||
return this.installZsh();
|
||||
case 'fish':
|
||||
return this.installFish();
|
||||
case 'powershell':
|
||||
return this.installPowerShell();
|
||||
default:
|
||||
throw new Error(`Unsupported shell: ${targetShell}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = { ShellCompletionInstaller };
|
||||
@@ -0,0 +1,332 @@
|
||||
# CCS Error Codes
|
||||
|
||||
Quick reference for CCS error codes and solutions.
|
||||
|
||||
## Error Categories
|
||||
|
||||
- **[E100-E199](#configuration-errors)**: Configuration Errors
|
||||
- **[E200-E299](#profile-management-errors)**: Profile Management Errors
|
||||
- **[E300-E399](#claude-cli-errors)**: Claude CLI Detection Errors
|
||||
- **[E400-E499](#network-api-errors)**: Network/API Errors
|
||||
- **[E500-E599](#file-system-errors)**: File System Errors
|
||||
- **[E900-E999](#internal-errors)**: Internal Errors
|
||||
|
||||
---
|
||||
|
||||
## Configuration Errors
|
||||
|
||||
### E101: Configuration File Missing
|
||||
**Cause**: `~/.ccs/config.json` not found
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Reinstall CCS
|
||||
npm install -g @kaitranntt/ccs --force
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E102: Invalid JSON in Configuration
|
||||
**Cause**: Corrupted or malformed `config.json`
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Backup and reset
|
||||
mv ~/.ccs/config.json ~/.ccs/config.json.backup
|
||||
npm install -g @kaitranntt/ccs --force
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E103: Invalid Profile Configuration
|
||||
**Cause**: Profile settings reference non-existent settings file
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Check profile settings
|
||||
cat ~/.ccs/config.json
|
||||
|
||||
# Fix path or recreate profile
|
||||
ccs auth create <profile>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Profile Management Errors
|
||||
|
||||
### E104: Profile Not Found
|
||||
**Cause**: Requested profile doesn't exist
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# List available profiles
|
||||
ccs auth list
|
||||
|
||||
# Create new profile
|
||||
ccs auth create <name>
|
||||
|
||||
# Use existing profile
|
||||
ccs <profile> "your prompt"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E105: Profile Already Exists
|
||||
**Cause**: Attempting to create profile that already exists
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Use different name
|
||||
ccs auth create <different-name>
|
||||
|
||||
# Or overwrite existing (use with caution)
|
||||
ccs auth create <name> --force
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E106: Cannot Delete Default Profile
|
||||
**Cause**: Attempting to remove currently active default profile
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Set different default first
|
||||
ccs auth default <other-profile>
|
||||
|
||||
# Then remove old default
|
||||
ccs auth remove <old-profile>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E107: Invalid Profile Name
|
||||
**Cause**: Profile name contains invalid characters
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Use only: alphanumeric, dash, underscore
|
||||
# Valid: work, test-env, my_profile
|
||||
# Invalid: my profile, test@work, profile!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Claude CLI Errors
|
||||
|
||||
### E301: Claude CLI Not Found
|
||||
**Cause**: Claude CLI not installed or not in PATH
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Install Claude CLI
|
||||
# See: https://docs.claude.com/en/docs/claude-code/installation
|
||||
|
||||
# Verify installation
|
||||
command -v claude # Unix
|
||||
Get-Command claude # Windows
|
||||
|
||||
# Custom path (if installed elsewhere)
|
||||
export CCS_CLAUDE_PATH="/path/to/claude"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E302: Claude CLI Version Incompatible
|
||||
**Cause**: Claude CLI version doesn't meet minimum requirements
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Update Claude CLI
|
||||
# Follow official update guide
|
||||
|
||||
# Check version
|
||||
claude --version
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E303: Claude CLI Execution Failed
|
||||
**Cause**: Claude CLI failed to start or crashed
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Test Claude directly
|
||||
claude --version
|
||||
|
||||
# Check permissions
|
||||
ls -la $(which claude)
|
||||
|
||||
# Reinstall if needed
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Network/API Errors
|
||||
|
||||
### E401: GLMT Proxy Timeout
|
||||
**Cause**: GLMT proxy server failed to start within 30 seconds
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Check port conflicts
|
||||
lsof -i :19889 # or random port shown in error
|
||||
|
||||
# Use non-proxy GLM instead
|
||||
ccs glm "your prompt"
|
||||
|
||||
# Enable debug mode
|
||||
export CCS_DEBUG=1
|
||||
ccs glmt "test"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E402: API Key Missing
|
||||
**Cause**: Required API key not configured
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# For GLM/GLMT/Kimi
|
||||
# Add to settings file or use Claude login
|
||||
claude /login
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E403: API Authentication Failed
|
||||
**Cause**: Invalid or expired API credentials
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Re-authenticate
|
||||
claude /login
|
||||
|
||||
# Check API key validity
|
||||
# Verify in Claude dashboard
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E404: API Rate Limit Exceeded
|
||||
**Cause**: Too many requests to API
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Wait and retry
|
||||
sleep 60
|
||||
|
||||
# Check rate limits in API dashboard
|
||||
# Consider upgrading plan
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## File System Errors
|
||||
|
||||
### E501: Cannot Create Directory
|
||||
**Cause**: Permission denied or path issues
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Fix ownership
|
||||
sudo chown -R $USER ~/.ccs
|
||||
|
||||
# Fix permissions
|
||||
chmod 755 ~/.ccs
|
||||
|
||||
# Retry
|
||||
npm install -g @kaitranntt/ccs --force
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E502: Cannot Write File
|
||||
**Cause**: Permission denied writing to CCS directories
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Fix permissions
|
||||
sudo chown -R $USER ~/.ccs ~/.claude
|
||||
chmod -R 755 ~/.ccs ~/.claude
|
||||
|
||||
# Check disk space
|
||||
df -h ~
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E503: Cannot Read File
|
||||
**Cause**: File doesn't exist or permission denied
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Check file exists
|
||||
ls -la <file-path-from-error>
|
||||
|
||||
# Fix permissions
|
||||
chmod 644 <file-path>
|
||||
|
||||
# Recreate if missing
|
||||
ccs auth create <profile>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E504: Instance Directory Not Found
|
||||
**Cause**: Profile instance directory missing
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Recreate profile
|
||||
ccs auth remove <profile>
|
||||
ccs auth create <profile>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Internal Errors
|
||||
|
||||
### E900: Internal Error
|
||||
**Cause**: Unexpected error in CCS code
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Report bug with debug output
|
||||
export CCS_DEBUG=1
|
||||
ccs <your-command> 2>&1 | tee error.log
|
||||
|
||||
# Report at: https://github.com/kaitranntt/ccs/issues
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### E901: Invalid State
|
||||
**Cause**: CCS detected inconsistent internal state
|
||||
|
||||
**Solutions**:
|
||||
```bash
|
||||
# Run health check
|
||||
ccs doctor
|
||||
|
||||
# Reset CCS data (backup first!)
|
||||
mv ~/.ccs ~/.ccs.backup
|
||||
npm install -g @kaitranntt/ccs --force
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Getting Help
|
||||
|
||||
If you encounter an error not listed here:
|
||||
|
||||
1. Enable debug mode: `export CCS_DEBUG=1`
|
||||
2. Run the failing command
|
||||
3. Check logs: `~/.ccs/logs/`
|
||||
4. Report issue: https://github.com/kaitranntt/ccs/issues
|
||||
|
||||
Include:
|
||||
- Error code
|
||||
- Full error message
|
||||
- Debug output
|
||||
- OS/platform info
|
||||
- CCS version: `ccs --version`
|
||||
+91
-1
@@ -31,7 +31,7 @@ $InstallMethod = if ($ScriptDir -and ((Test-Path "$ScriptDir\lib\ccs.ps1") -or (
|
||||
# IMPORTANT: Update this version when releasing new versions!
|
||||
# This hardcoded version is used for standalone installations (irm | iex)
|
||||
# For git installations, VERSION file is read if available
|
||||
$CcsVersion = "3.4.6"
|
||||
$CcsVersion = "3.5.0"
|
||||
|
||||
# Try to read VERSION file for git installations
|
||||
if ($ScriptDir) {
|
||||
@@ -275,6 +275,46 @@ if ($InstallMethod -eq "standalone") {
|
||||
$BaseUrl = "https://raw.githubusercontent.com/kaitranntt/ccs/main"
|
||||
Invoke-WebRequest -Uri "$BaseUrl/lib/ccs.ps1" -OutFile "$CcsDir\ccs.ps1" -UseBasicParsing
|
||||
Write-Host "| [OK] Downloaded ccs.ps1"
|
||||
|
||||
# Download required dependencies
|
||||
$LibDir = "$CcsDir\lib"
|
||||
if (-not (Test-Path $LibDir)) {
|
||||
New-Item -ItemType Directory -Path $LibDir -Force | Out-Null
|
||||
}
|
||||
|
||||
try {
|
||||
Invoke-WebRequest -Uri "$BaseUrl/lib/error-codes.ps1" -OutFile "$LibDir\error-codes.ps1" -UseBasicParsing
|
||||
Write-Host "| [OK] Downloaded error-codes.ps1"
|
||||
} catch {
|
||||
Write-Host "| [!] Warning: Failed to download error-codes.ps1"
|
||||
}
|
||||
|
||||
try {
|
||||
Invoke-WebRequest -Uri "$BaseUrl/lib/progress-indicator.ps1" -OutFile "$LibDir\progress-indicator.ps1" -UseBasicParsing
|
||||
Write-Host "| [OK] Downloaded progress-indicator.ps1"
|
||||
} catch {
|
||||
Write-Host "| [!] Warning: Failed to download progress-indicator.ps1"
|
||||
}
|
||||
|
||||
try {
|
||||
Invoke-WebRequest -Uri "$BaseUrl/lib/prompt.ps1" -OutFile "$LibDir\prompt.ps1" -UseBasicParsing
|
||||
Write-Host "| [OK] Downloaded prompt.ps1"
|
||||
} catch {
|
||||
Write-Host "| [!] Warning: Failed to download prompt.ps1"
|
||||
}
|
||||
|
||||
# Download shell completion files
|
||||
$CompletionsDir = "$CcsDir\completions"
|
||||
if (-not (Test-Path $CompletionsDir)) {
|
||||
New-Item -ItemType Directory -Path $CompletionsDir -Force | Out-Null
|
||||
}
|
||||
|
||||
try {
|
||||
Invoke-WebRequest -Uri "$BaseUrl/scripts/completion/ccs.ps1" -OutFile "$CompletionsDir\ccs.ps1" -UseBasicParsing
|
||||
Write-Host "| [OK] Downloaded completion files"
|
||||
} catch {
|
||||
Write-Host "| [!] Warning: Failed to download completion files"
|
||||
}
|
||||
} catch {
|
||||
Write-Host "|"
|
||||
Write-Host "[X] Error: Failed to download ccs.ps1 from GitHub" -ForegroundColor Red
|
||||
@@ -292,6 +332,56 @@ if ($InstallMethod -eq "standalone") {
|
||||
}
|
||||
Copy-Item $CcsPs1Path "$CcsDir\ccs.ps1" -Force
|
||||
Write-Host "| [OK] Installed ccs.ps1"
|
||||
|
||||
# Copy required dependencies
|
||||
$LibDir = "$CcsDir\lib"
|
||||
if (-not (Test-Path $LibDir)) {
|
||||
New-Item -ItemType Directory -Path $LibDir -Force | Out-Null
|
||||
}
|
||||
|
||||
$SourceLibDir = if (Test-Path "$ScriptDir\lib") {
|
||||
"$ScriptDir\lib"
|
||||
} elseif (Test-Path "$ScriptDir\..\lib") {
|
||||
"$ScriptDir\..\lib"
|
||||
} else {
|
||||
$null
|
||||
}
|
||||
|
||||
if ($SourceLibDir) {
|
||||
if (Test-Path "$SourceLibDir\error-codes.ps1") {
|
||||
Copy-Item "$SourceLibDir\error-codes.ps1" "$LibDir\error-codes.ps1" -Force
|
||||
Write-Host "| [OK] Copied error-codes.ps1"
|
||||
}
|
||||
|
||||
if (Test-Path "$SourceLibDir\progress-indicator.ps1") {
|
||||
Copy-Item "$SourceLibDir\progress-indicator.ps1" "$LibDir\progress-indicator.ps1" -Force
|
||||
Write-Host "| [OK] Copied progress-indicator.ps1"
|
||||
}
|
||||
|
||||
if (Test-Path "$SourceLibDir\prompt.ps1") {
|
||||
Copy-Item "$SourceLibDir\prompt.ps1" "$LibDir\prompt.ps1" -Force
|
||||
Write-Host "| [OK] Copied prompt.ps1"
|
||||
}
|
||||
}
|
||||
|
||||
# Copy shell completion files
|
||||
$CompletionsDir = "$CcsDir\completions"
|
||||
if (-not (Test-Path $CompletionsDir)) {
|
||||
New-Item -ItemType Directory -Path $CompletionsDir -Force | Out-Null
|
||||
}
|
||||
|
||||
$SourceCompletionDir = if (Test-Path "$ScriptDir\scripts\completion") {
|
||||
"$ScriptDir\scripts\completion"
|
||||
} elseif (Test-Path "$ScriptDir\..\scripts\completion") {
|
||||
"$ScriptDir\..\scripts\completion"
|
||||
} else {
|
||||
$null
|
||||
}
|
||||
|
||||
if ($SourceCompletionDir -and (Test-Path "$SourceCompletionDir\ccs.ps1")) {
|
||||
Copy-Item "$SourceCompletionDir\ccs.ps1" "$CompletionsDir\ccs.ps1" -Force -ErrorAction SilentlyContinue
|
||||
Write-Host "| [OK] Copied completion files"
|
||||
}
|
||||
}
|
||||
|
||||
# Install uninstall script as ccs-uninstall.ps1
|
||||
|
||||
+69
-2
@@ -32,7 +32,7 @@ fi
|
||||
# IMPORTANT: Update this version when releasing new versions!
|
||||
# This hardcoded version is used for standalone installations (curl | bash)
|
||||
# For git installations, VERSION file is read if available
|
||||
CCS_VERSION="3.4.6"
|
||||
CCS_VERSION="3.5.0"
|
||||
|
||||
# Try to read VERSION file for git installations
|
||||
if [[ -f "$SCRIPT_DIR/VERSION" ]]; then
|
||||
@@ -469,7 +469,10 @@ if [[ "$INSTALL_METHOD" == "standalone" ]]; then
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if curl -fsSL https://raw.githubusercontent.com/kaitranntt/ccs/main/lib/ccs -o "$CCS_DIR/ccs"; then
|
||||
BASE_URL="https://raw.githubusercontent.com/kaitranntt/ccs/main"
|
||||
|
||||
# Download main executable
|
||||
if curl -fsSL "$BASE_URL/lib/ccs" -o "$CCS_DIR/ccs"; then
|
||||
chmod +x "$CCS_DIR/ccs"
|
||||
ln -sf "$CCS_DIR/ccs" "$INSTALL_DIR/ccs"
|
||||
echo "| [OK] Downloaded executable"
|
||||
@@ -478,21 +481,85 @@ if [[ "$INSTALL_METHOD" == "standalone" ]]; then
|
||||
echo "[X] Error: Failed to download ccs from GitHub"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Download required dependencies
|
||||
mkdir -p "$CCS_DIR/lib"
|
||||
if curl -fsSL "$BASE_URL/lib/error-codes.sh" -o "$CCS_DIR/lib/error-codes.sh" 2>/dev/null; then
|
||||
echo "| [OK] Downloaded error-codes.sh"
|
||||
else
|
||||
echo "| [!] Warning: Failed to download error-codes.sh"
|
||||
fi
|
||||
|
||||
if curl -fsSL "$BASE_URL/lib/progress-indicator.sh" -o "$CCS_DIR/lib/progress-indicator.sh" 2>/dev/null; then
|
||||
echo "| [OK] Downloaded progress-indicator.sh"
|
||||
else
|
||||
echo "| [!] Warning: Failed to download progress-indicator.sh"
|
||||
fi
|
||||
|
||||
if curl -fsSL "$BASE_URL/lib/prompt.sh" -o "$CCS_DIR/lib/prompt.sh" 2>/dev/null; then
|
||||
echo "| [OK] Downloaded prompt.sh"
|
||||
else
|
||||
echo "| [!] Warning: Failed to download prompt.sh"
|
||||
fi
|
||||
|
||||
# Download shell completion files
|
||||
mkdir -p "$CCS_DIR/completions"
|
||||
if curl -fsSL "$BASE_URL/scripts/completion/ccs.bash" -o "$CCS_DIR/completions/ccs.bash" 2>/dev/null; then
|
||||
echo "| [OK] Downloaded completion files"
|
||||
fi
|
||||
curl -fsSL "$BASE_URL/scripts/completion/ccs.zsh" -o "$CCS_DIR/completions/ccs.zsh" 2>/dev/null || true
|
||||
curl -fsSL "$BASE_URL/scripts/completion/ccs.fish" -o "$CCS_DIR/completions/ccs.fish" 2>/dev/null || true
|
||||
else
|
||||
# Git install - use local ccs file
|
||||
# Handle both running from root or from installers/ subdirectory
|
||||
local LIB_DIR=""
|
||||
if [[ -f "$SCRIPT_DIR/lib/ccs" ]]; then
|
||||
chmod +x "$SCRIPT_DIR/lib/ccs"
|
||||
ln -sf "$SCRIPT_DIR/lib/ccs" "$INSTALL_DIR/ccs"
|
||||
LIB_DIR="$SCRIPT_DIR/lib"
|
||||
elif [[ -f "$SCRIPT_DIR/../lib/ccs" ]]; then
|
||||
chmod +x "$SCRIPT_DIR/../lib/ccs"
|
||||
ln -sf "$SCRIPT_DIR/../lib/ccs" "$INSTALL_DIR/ccs"
|
||||
LIB_DIR="$SCRIPT_DIR/../lib"
|
||||
else
|
||||
echo "|"
|
||||
echo "[X] Error: lib/ccs executable not found"
|
||||
exit 1
|
||||
fi
|
||||
echo "| [OK] Installed executable"
|
||||
|
||||
# Copy required dependencies
|
||||
mkdir -p "$CCS_DIR/lib"
|
||||
if [[ -f "$LIB_DIR/error-codes.sh" ]]; then
|
||||
cp "$LIB_DIR/error-codes.sh" "$CCS_DIR/lib/error-codes.sh"
|
||||
echo "| [OK] Copied error-codes.sh"
|
||||
fi
|
||||
|
||||
if [[ -f "$LIB_DIR/progress-indicator.sh" ]]; then
|
||||
cp "$LIB_DIR/progress-indicator.sh" "$CCS_DIR/lib/progress-indicator.sh"
|
||||
echo "| [OK] Copied progress-indicator.sh"
|
||||
fi
|
||||
|
||||
if [[ -f "$LIB_DIR/prompt.sh" ]]; then
|
||||
cp "$LIB_DIR/prompt.sh" "$CCS_DIR/lib/prompt.sh"
|
||||
echo "| [OK] Copied prompt.sh"
|
||||
fi
|
||||
|
||||
# Copy shell completion files
|
||||
mkdir -p "$CCS_DIR/completions"
|
||||
local COMPLETION_DIR=""
|
||||
if [[ -d "$SCRIPT_DIR/scripts/completion" ]]; then
|
||||
COMPLETION_DIR="$SCRIPT_DIR/scripts/completion"
|
||||
elif [[ -d "$SCRIPT_DIR/../scripts/completion" ]]; then
|
||||
COMPLETION_DIR="$SCRIPT_DIR/../scripts/completion"
|
||||
fi
|
||||
|
||||
if [[ -n "$COMPLETION_DIR" ]]; then
|
||||
cp "$COMPLETION_DIR/ccs.bash" "$CCS_DIR/completions/ccs.bash" 2>/dev/null || true
|
||||
cp "$COMPLETION_DIR/ccs.zsh" "$CCS_DIR/completions/ccs.zsh" 2>/dev/null || true
|
||||
cp "$COMPLETION_DIR/ccs.fish" "$CCS_DIR/completions/ccs.fish" 2>/dev/null || true
|
||||
echo "| [OK] Copied completion files"
|
||||
fi
|
||||
fi
|
||||
|
||||
if [[ ! -L "$INSTALL_DIR/ccs" ]]; then
|
||||
|
||||
@@ -2,12 +2,32 @@
|
||||
set -euo pipefail
|
||||
|
||||
# Version (updated by scripts/bump-version.sh)
|
||||
CCS_VERSION="3.4.6"
|
||||
CCS_VERSION="3.5.0"
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
readonly CONFIG_FILE="${CCS_CONFIG:-$HOME/.ccs/config.json}"
|
||||
readonly PROFILES_JSON="$HOME/.ccs/profiles.json"
|
||||
readonly INSTANCES_DIR="$HOME/.ccs/instances"
|
||||
|
||||
# Determine dependency location (git vs installed)
|
||||
# Git: lib/ccs and dependencies are in same dir (lib/)
|
||||
# Installed: lib/ccs is symlinked from ~/.local/bin/ccs, dependencies in ~/.ccs/lib/
|
||||
if [[ -f "$SCRIPT_DIR/error-codes.sh" ]]; then
|
||||
# Git install - files in same directory
|
||||
DEP_DIR="$SCRIPT_DIR"
|
||||
else
|
||||
# Standalone install - files in ~/.ccs/lib/
|
||||
DEP_DIR="$HOME/.ccs/lib"
|
||||
fi
|
||||
|
||||
# Source error codes
|
||||
source "$DEP_DIR/error-codes.sh"
|
||||
|
||||
# Source progress indicators
|
||||
source "$DEP_DIR/progress-indicator.sh"
|
||||
|
||||
# Source interactive prompts
|
||||
source "$DEP_DIR/prompt.sh"
|
||||
|
||||
# --- Color/Format Functions ---
|
||||
setup_colors() {
|
||||
# Enable colors if: FORCE_COLOR set OR (TTY detected AND NO_COLOR not set) OR (TERM supports colors AND NO_COLOR not set)
|
||||
@@ -27,14 +47,121 @@ setup_colors() {
|
||||
|
||||
msg_error() {
|
||||
echo "" >&2
|
||||
echo -e "${RED}${BOLD}╔═════════════════════════════════════════════╗${RESET}" >&2
|
||||
echo -e "${RED}${BOLD}║ ERROR ║${RESET}" >&2
|
||||
echo -e "${RED}${BOLD}╚═════════════════════════════════════════════╝${RESET}" >&2
|
||||
echo -e "${RED}${BOLD}=============================================${RESET}" >&2
|
||||
echo -e "${RED}${BOLD} ERROR${RESET}" >&2
|
||||
echo -e "${RED}${BOLD}=============================================${RESET}" >&2
|
||||
echo "" >&2
|
||||
echo -e "${RED}$1${RESET}" >&2
|
||||
echo "" >&2
|
||||
}
|
||||
|
||||
# Enhanced error message with error codes
|
||||
show_enhanced_error() {
|
||||
local error_code="$1"
|
||||
local short_msg="$2"
|
||||
local context="${3:-}"
|
||||
local suggestions="${4:-}"
|
||||
|
||||
echo "" >&2
|
||||
echo -e "${RED}[X] $short_msg${RESET}" >&2
|
||||
echo "" >&2
|
||||
|
||||
[[ -n "$context" ]] && {
|
||||
echo -e "$context" >&2
|
||||
echo "" >&2
|
||||
}
|
||||
|
||||
[[ -n "$suggestions" ]] && {
|
||||
echo -e "${YELLOW}Solutions:${RESET}" >&2
|
||||
echo -e "$suggestions" >&2
|
||||
echo "" >&2
|
||||
}
|
||||
|
||||
echo -e "${YELLOW}Error: $error_code${RESET}" >&2
|
||||
echo -e "${YELLOW}$(get_error_doc_url "$error_code")${RESET}" >&2
|
||||
echo "" >&2
|
||||
}
|
||||
|
||||
# Calculate Levenshtein distance between two strings
|
||||
levenshtein_distance() {
|
||||
local a="$1"
|
||||
local b="$2"
|
||||
local len_a=${#a}
|
||||
local len_b=${#b}
|
||||
|
||||
# Return early for empty strings
|
||||
[[ $len_a -eq 0 ]] && { echo "$len_b"; return; }
|
||||
[[ $len_b -eq 0 ]] && { echo "$len_a"; return; }
|
||||
|
||||
# Initialize matrix using associative array
|
||||
declare -A matrix
|
||||
|
||||
# Initialize first row and column
|
||||
for ((j=0; j<=len_a; j++)); do
|
||||
matrix[0,$j]=$j
|
||||
done
|
||||
for ((i=0; i<=len_b; i++)); do
|
||||
matrix[$i,0]=$i
|
||||
done
|
||||
|
||||
# Fill matrix
|
||||
for ((i=1; i<=len_b; i++)); do
|
||||
for ((j=1; j<=len_a; j++)); do
|
||||
if [[ "${a:j-1:1}" == "${b:i-1:1}" ]]; then
|
||||
matrix[$i,$j]=${matrix[$((i-1)),$((j-1))]}
|
||||
else
|
||||
local sub=${matrix[$((i-1)),$((j-1))]}
|
||||
local ins=${matrix[$i,$((j-1))]}
|
||||
local del=${matrix[$((i-1)),$j]}
|
||||
local min=$sub
|
||||
[[ $ins -lt $min ]] && min=$ins
|
||||
[[ $del -lt $min ]] && min=$del
|
||||
matrix[$i,$j]=$((min + 1))
|
||||
fi
|
||||
done
|
||||
done
|
||||
|
||||
echo "${matrix[$len_b,$len_a]}"
|
||||
}
|
||||
|
||||
# Find similar strings using fuzzy matching
|
||||
find_similar_strings() {
|
||||
local target="$1"
|
||||
shift
|
||||
local candidates=("$@")
|
||||
local max_distance=2
|
||||
local target_lower="${target,,}"
|
||||
|
||||
declare -A distances
|
||||
local matches=()
|
||||
|
||||
# Calculate distances
|
||||
for candidate in "${candidates[@]}"; do
|
||||
local candidate_lower="${candidate,,}"
|
||||
local dist=$(levenshtein_distance "$target_lower" "$candidate_lower")
|
||||
if [[ $dist -le $max_distance && $dist -gt 0 ]]; then
|
||||
distances["$candidate"]=$dist
|
||||
matches+=("$candidate")
|
||||
fi
|
||||
done
|
||||
|
||||
# Sort by distance (simple bubble sort for small arrays)
|
||||
for ((i=0; i<${#matches[@]}; i++)); do
|
||||
for ((j=i+1; j<${#matches[@]}; j++)); do
|
||||
if [[ ${distances[${matches[i]}]} -gt ${distances[${matches[j]}]} ]]; then
|
||||
local temp="${matches[i]}"
|
||||
matches[i]="${matches[j]}"
|
||||
matches[j]="$temp"
|
||||
fi
|
||||
done
|
||||
done
|
||||
|
||||
# Return first 3 matches
|
||||
for ((i=0; i<${#matches[@]} && i<3; i++)); do
|
||||
echo "${matches[i]}"
|
||||
done
|
||||
}
|
||||
|
||||
show_help() {
|
||||
echo -e "${BOLD}CCS (Claude Code Switch) - Instant profile switching for Claude CLI${RESET}"
|
||||
echo ""
|
||||
@@ -66,6 +193,7 @@ show_help() {
|
||||
echo -e "${CYAN}Flags:${RESET}"
|
||||
echo -e " ${YELLOW}-h, --help${RESET} Show this help message"
|
||||
echo -e " ${YELLOW}-v, --version${RESET} Show version and installation info"
|
||||
echo -e " ${YELLOW}--shell-completion${RESET} Install shell auto-completion"
|
||||
echo ""
|
||||
echo -e "${CYAN}Configuration:${RESET}"
|
||||
echo -e " Config: ~/.ccs/config.json"
|
||||
@@ -78,6 +206,22 @@ show_help() {
|
||||
echo -e " Skills: ~/.ccs/shared/skills/"
|
||||
echo -e " Note: Commands, skills, and agents are symlinked across all profiles"
|
||||
echo ""
|
||||
echo -e "${CYAN}Examples:${RESET}"
|
||||
echo -e " Quick start:"
|
||||
echo -e " ${YELLOW}\$ ccs${RESET} # Use default account"
|
||||
echo -e " ${YELLOW}\$ ccs glm \"implement API\"${RESET} # Cost-optimized model"
|
||||
echo ""
|
||||
echo -e " Multi-account workflow:"
|
||||
echo -e " ${YELLOW}\$ ccs auth create work${RESET} # Create work profile"
|
||||
echo -e " ${YELLOW}\$ ccs work \"review PR\"${RESET} # Use work account"
|
||||
echo ""
|
||||
echo -e " For more: ${CYAN}https://github.com/kaitranntt/ccs#usage${RESET}"
|
||||
echo ""
|
||||
echo -e "${YELLOW}Uninstall:${RESET}"
|
||||
echo " npm: npm uninstall -g @kaitranntt/ccs"
|
||||
echo " macOS/Linux: curl -fsSL ccs.kaitran.ca/uninstall | bash"
|
||||
echo " Windows: irm ccs.kaitran.ca/uninstall | iex"
|
||||
echo ""
|
||||
echo -e "${CYAN}Documentation:${RESET}"
|
||||
echo -e " GitHub: ${CYAN}https://github.com/kaitranntt/ccs${RESET}"
|
||||
echo -e " Docs: https://github.com/kaitranntt/ccs/blob/main/README.md"
|
||||
@@ -189,96 +333,137 @@ doctor_run() {
|
||||
echo ""
|
||||
|
||||
local has_errors=false
|
||||
local total_checks=9
|
||||
local current_check=0
|
||||
|
||||
# Check Claude CLI
|
||||
current_check=$((current_check + 1))
|
||||
show_progress_step $current_check $total_checks "Checking Claude CLI"
|
||||
if command -v "$(detect_claude_cli)" &>/dev/null; then
|
||||
clear_progress
|
||||
doctor_check "Claude CLI" "success"
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "Claude CLI" "error" "Not found in PATH"
|
||||
has_errors=true
|
||||
fi
|
||||
|
||||
# Check ~/.ccs/
|
||||
current_check=$((current_check + 1))
|
||||
show_progress_step $current_check $total_checks "Checking CCS directory"
|
||||
if [[ -d "$HOME/.ccs" ]]; then
|
||||
clear_progress
|
||||
doctor_check "CCS Directory" "success"
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "CCS Directory" "error" "~/.ccs/ not found"
|
||||
has_errors=true
|
||||
fi
|
||||
|
||||
# Check config.json
|
||||
current_check=$((current_check + 1))
|
||||
show_progress_step $current_check $total_checks "Checking config.json"
|
||||
if [[ -f "$CONFIG_FILE" ]]; then
|
||||
if jq empty "$CONFIG_FILE" 2>/dev/null; then
|
||||
clear_progress
|
||||
doctor_check "config.json" "success"
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "config.json" "error" "Invalid JSON"
|
||||
has_errors=true
|
||||
fi
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "config.json" "error" "Not found"
|
||||
has_errors=true
|
||||
fi
|
||||
|
||||
# Check glm.settings.json
|
||||
current_check=$((current_check + 1))
|
||||
show_progress_step $current_check $total_checks "Checking glm.settings.json"
|
||||
local glm_file="$HOME/.ccs/glm.settings.json"
|
||||
if [[ -f "$glm_file" ]]; then
|
||||
if jq empty "$glm_file" 2>/dev/null; then
|
||||
clear_progress
|
||||
doctor_check "glm.settings.json" "success"
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "glm.settings.json" "error" "Invalid JSON"
|
||||
has_errors=true
|
||||
fi
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "glm.settings.json" "error" "Not found"
|
||||
has_errors=true
|
||||
fi
|
||||
|
||||
# Check kimi.settings.json
|
||||
current_check=$((current_check + 1))
|
||||
show_progress_step $current_check $total_checks "Checking kimi.settings.json"
|
||||
local kimi_file="$HOME/.ccs/kimi.settings.json"
|
||||
if [[ -f "$kimi_file" ]]; then
|
||||
if jq empty "$kimi_file" 2>/dev/null; then
|
||||
clear_progress
|
||||
doctor_check "kimi.settings.json" "success"
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "kimi.settings.json" "error" "Invalid JSON"
|
||||
has_errors=true
|
||||
fi
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "kimi.settings.json" "error" "Not found"
|
||||
has_errors=true
|
||||
fi
|
||||
|
||||
# Check ~/.claude/settings.json
|
||||
current_check=$((current_check + 1))
|
||||
show_progress_step $current_check $total_checks "Checking Claude settings"
|
||||
if [[ -f "$HOME/.claude/settings.json" ]]; then
|
||||
if jq empty "$HOME/.claude/settings.json" 2>/dev/null; then
|
||||
clear_progress
|
||||
doctor_check "Claude Settings" "success"
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "Claude Settings" "warning" "Invalid JSON"
|
||||
fi
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "Claude Settings" "warning" "Not found - run 'claude /login'"
|
||||
fi
|
||||
|
||||
# Check profiles
|
||||
current_check=$((current_check + 1))
|
||||
show_progress_step $current_check $total_checks "Checking profiles"
|
||||
if [[ -f "$CONFIG_FILE" ]]; then
|
||||
local profile_count=$(jq -r '.profiles | length' "$CONFIG_FILE" 2>/dev/null || echo "0")
|
||||
clear_progress
|
||||
doctor_check "Profiles" "success" "($profile_count configured)"
|
||||
fi
|
||||
|
||||
# Check instances
|
||||
current_check=$((current_check + 1))
|
||||
show_progress_step $current_check $total_checks "Checking instances"
|
||||
if [[ -d "$INSTANCES_DIR" ]]; then
|
||||
local instance_count=$(find "$INSTANCES_DIR" -maxdepth 1 -type d 2>/dev/null | wc -l)
|
||||
instance_count=$((instance_count - 1)) # Exclude parent dir
|
||||
clear_progress
|
||||
doctor_check "Instances" "success" "($instance_count account profiles)"
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "Instances" "success" "(no account profiles)"
|
||||
fi
|
||||
|
||||
# Check permissions
|
||||
current_check=$((current_check + 1))
|
||||
show_progress_step $current_check $total_checks "Checking permissions"
|
||||
local test_file="$HOME/.ccs/.permission-test"
|
||||
if echo "test" > "$test_file" 2>/dev/null; then
|
||||
rm -f "$test_file" 2>/dev/null
|
||||
clear_progress
|
||||
doctor_check "Permissions" "success"
|
||||
else
|
||||
clear_progress
|
||||
doctor_check "Permissions" "error" "Cannot write to ~/.ccs/"
|
||||
has_errors=true
|
||||
fi
|
||||
@@ -629,6 +814,27 @@ ensure_instance() {
|
||||
# --- Profile Detection Logic (Phase 1) ---
|
||||
|
||||
# List available profiles for error messages
|
||||
# Get all profile names (for fuzzy matching)
|
||||
get_all_profile_names() {
|
||||
local names=()
|
||||
|
||||
# Settings-based profiles
|
||||
if [[ -f "$CONFIG_FILE" ]]; then
|
||||
while IFS= read -r name; do
|
||||
names+=("$name")
|
||||
done < <(jq -r '.profiles | keys[]' "$CONFIG_FILE" 2>/dev/null || true)
|
||||
fi
|
||||
|
||||
# Account-based profiles
|
||||
if [[ -f "$PROFILES_JSON" ]]; then
|
||||
while IFS= read -r name; do
|
||||
names+=("$name")
|
||||
done < <(jq -r '.profiles | keys[]' "$PROFILES_JSON" 2>/dev/null || true)
|
||||
fi
|
||||
|
||||
printf '%s\n' "${names[@]}"
|
||||
}
|
||||
|
||||
list_available_profiles() {
|
||||
local lines=()
|
||||
|
||||
@@ -745,6 +951,12 @@ auth_help() {
|
||||
echo -e " ${YELLOW}ccs work \"review code\"${RESET} # Use work profile"
|
||||
echo -e " ${YELLOW}ccs \"review code\"${RESET} # Use default profile"
|
||||
echo ""
|
||||
echo -e "${CYAN}Options:${RESET}"
|
||||
echo -e " ${YELLOW}--force${RESET} Allow overwriting existing profile (create)"
|
||||
echo -e " ${YELLOW}--yes, -y${RESET} Skip confirmation prompts (remove)"
|
||||
echo -e " ${YELLOW}--json${RESET} Output in JSON format (list, show)"
|
||||
echo -e " ${YELLOW}--verbose${RESET} Show additional details (list)"
|
||||
echo ""
|
||||
echo -e "${CYAN}Note:${RESET}"
|
||||
echo -e " By default, ${YELLOW}ccs${RESET} uses Claude CLI defaults from ~/.claude/"
|
||||
echo -e " Use ${YELLOW}ccs auth default <profile>${RESET} to change the default profile."
|
||||
@@ -816,10 +1028,24 @@ auth_create() {
|
||||
|
||||
auth_list() {
|
||||
local verbose=false
|
||||
[[ "${1:-}" == "--verbose" ]] && verbose=true
|
||||
local json=false
|
||||
|
||||
# Parse arguments
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--verbose) verbose=true ;;
|
||||
--json) json=true ;;
|
||||
*) ;;
|
||||
esac
|
||||
shift
|
||||
done
|
||||
|
||||
# Read profiles.json
|
||||
[[ ! -f "$PROFILES_JSON" ]] && {
|
||||
if $json; then
|
||||
echo "{\"version\":\"$CCS_VERSION\",\"profiles\":[]}"
|
||||
return 0
|
||||
fi
|
||||
echo -e "${YELLOW}No account profiles found${RESET}"
|
||||
echo ""
|
||||
echo "To create your first profile:"
|
||||
@@ -827,9 +1053,33 @@ auth_list() {
|
||||
return 0
|
||||
}
|
||||
|
||||
local profiles=$(jq -r '.profiles | keys[]' "$PROFILES_JSON" 2>/dev/null || true)
|
||||
local default_profile=$(jq -r '.default // empty' "$PROFILES_JSON" 2>/dev/null || true)
|
||||
|
||||
# JSON output mode
|
||||
if $json; then
|
||||
jq -n \
|
||||
--arg version "$CCS_VERSION" \
|
||||
--arg default "$default_profile" \
|
||||
--argjson data "$(cat "$PROFILES_JSON")" \
|
||||
'{
|
||||
version: $version,
|
||||
profiles: [
|
||||
$data.profiles | to_entries[] | {
|
||||
name: .key,
|
||||
type: (.value.type // "account"),
|
||||
is_default: (.key == $default),
|
||||
created: .value.created,
|
||||
last_used: (.value.last_used // null),
|
||||
instance_path: ($ENV.INSTANCES_DIR + "/" + .key)
|
||||
}
|
||||
]
|
||||
}'
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Human-readable output
|
||||
local profiles=$(jq -r '.profiles | keys[]' "$PROFILES_JSON" 2>/dev/null || true)
|
||||
|
||||
[[ -z "$profiles" ]] && {
|
||||
echo -e "${YELLOW}No account profiles found${RESET}"
|
||||
return 0
|
||||
@@ -864,11 +1114,22 @@ auth_list() {
|
||||
}
|
||||
|
||||
auth_show() {
|
||||
local profile_name="${1:-}"
|
||||
local profile_name=""
|
||||
local json=false
|
||||
|
||||
# Parse arguments
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--json) json=true ;;
|
||||
-*) msg_error "Unknown option: $1"; return 1 ;;
|
||||
*) profile_name="$1" ;;
|
||||
esac
|
||||
shift
|
||||
done
|
||||
|
||||
[[ -z "$profile_name" ]] && {
|
||||
msg_error "Profile name is required"
|
||||
echo "Usage: ${YELLOW}ccs auth show <profile>${RESET}"
|
||||
echo "Usage: ${YELLOW}ccs auth show <profile> [--json]${RESET}"
|
||||
return 1
|
||||
}
|
||||
|
||||
@@ -882,29 +1143,59 @@ auth_show() {
|
||||
local is_default=false
|
||||
[[ "$profile_name" == "$default_profile" ]] && is_default=true
|
||||
|
||||
echo -e "${BOLD}Profile: $profile_name${RESET}"
|
||||
echo ""
|
||||
|
||||
local type=$(jq -r ".profiles.\"$profile_name\".type // \"account\"" "$PROFILES_JSON" 2>/dev/null || true)
|
||||
local created=$(jq -r ".profiles.\"$profile_name\".created" "$PROFILES_JSON" 2>/dev/null || true)
|
||||
local last_used=$(jq -r ".profiles.\"$profile_name\".last_used // \"Never\"" "$PROFILES_JSON" 2>/dev/null || true)
|
||||
local last_used=$(jq -r ".profiles.\"$profile_name\".last_used // null" "$PROFILES_JSON" 2>/dev/null || true)
|
||||
local instance_path="$INSTANCES_DIR/$(sanitize_profile_name "$profile_name")"
|
||||
|
||||
# Count sessions
|
||||
local session_count=0
|
||||
if [[ -d "$instance_path/session-env" ]]; then
|
||||
session_count=$(find "$instance_path/session-env" -name "*.json" 2>/dev/null | wc -l | tr -d ' ')
|
||||
fi
|
||||
|
||||
# JSON output mode
|
||||
if $json; then
|
||||
jq -n \
|
||||
--arg name "$profile_name" \
|
||||
--arg type "$type" \
|
||||
--argjson is_default "$is_default" \
|
||||
--arg created "$created" \
|
||||
--arg last_used "$last_used" \
|
||||
--arg instance_path "$instance_path" \
|
||||
--argjson session_count "$session_count" \
|
||||
'{
|
||||
name: $name,
|
||||
type: $type,
|
||||
is_default: $is_default,
|
||||
created: $created,
|
||||
last_used: $last_used,
|
||||
instance_path: $instance_path,
|
||||
session_count: $session_count
|
||||
}'
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Human-readable output
|
||||
echo -e "${BOLD}Profile: $profile_name${RESET}"
|
||||
echo ""
|
||||
|
||||
echo " Type: $type"
|
||||
echo " Default: $($is_default && echo "Yes" || echo "No")"
|
||||
echo " Instance: $instance_path"
|
||||
echo " Created: $created"
|
||||
echo " Last used: $last_used"
|
||||
[[ "$last_used" != "null" ]] && echo " Last used: $last_used" || echo " Last used: Never"
|
||||
echo ""
|
||||
}
|
||||
|
||||
auth_remove() {
|
||||
local profile_name=""
|
||||
local force=false
|
||||
|
||||
# Parse arguments
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--force) force=true ;;
|
||||
--yes|-y) export CCS_YES=1 ;; # Auto-confirm (export for confirm_action)
|
||||
-*) msg_error "Unknown option: $1"; return 1 ;;
|
||||
*) profile_name="$1" ;;
|
||||
esac
|
||||
shift
|
||||
@@ -912,7 +1203,8 @@ auth_remove() {
|
||||
|
||||
[[ -z "$profile_name" ]] && {
|
||||
msg_error "Profile name is required"
|
||||
echo "Usage: ${YELLOW}ccs auth remove <profile> --force${RESET}"
|
||||
echo ""
|
||||
echo "Usage: ${YELLOW}ccs auth remove <profile> [--yes]${RESET}"
|
||||
return 1
|
||||
}
|
||||
|
||||
@@ -921,14 +1213,28 @@ auth_remove() {
|
||||
return 1
|
||||
}
|
||||
|
||||
$force || {
|
||||
msg_error "Removal requires --force flag for safety"
|
||||
echo "Run: ${YELLOW}ccs auth remove $profile_name --force${RESET}"
|
||||
return 1
|
||||
}
|
||||
# Get instance path and session count for impact display
|
||||
local instance_path="$INSTANCES_DIR/$(sanitize_profile_name "$profile_name")"
|
||||
local session_count=0
|
||||
|
||||
if [[ -d "$instance_path/session-env" ]]; then
|
||||
session_count=$(find "$instance_path/session-env" -name "*.json" 2>/dev/null | wc -l | tr -d ' ')
|
||||
fi
|
||||
|
||||
# Display impact
|
||||
echo ""
|
||||
echo "Profile '${CYAN}$profile_name${RESET}' will be permanently deleted."
|
||||
echo " Instance path: $instance_path"
|
||||
echo " Sessions: $session_count conversation$([ "$session_count" -ne 1 ] && echo "s" || echo "")"
|
||||
echo ""
|
||||
|
||||
# Interactive confirmation (or --yes flag)
|
||||
if ! confirm_action "Delete this profile?" "no"; then
|
||||
echo "[i] Cancelled"
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Delete instance directory
|
||||
local instance_path="$INSTANCES_DIR/$(sanitize_profile_name "$profile_name")"
|
||||
rm -rf "$instance_path"
|
||||
|
||||
# Remove from registry
|
||||
@@ -979,6 +1285,184 @@ handle_auth_commands() {
|
||||
esac
|
||||
}
|
||||
|
||||
# --- Shell Completion Installer ---
|
||||
|
||||
install_shell_completion() {
|
||||
shift # Remove --shell-completion
|
||||
|
||||
echo -e "${BOLD}Shell Completion Installer${RESET}"
|
||||
echo ""
|
||||
|
||||
# Parse flags for manual shell selection
|
||||
local target_shell=""
|
||||
for arg in "$@"; do
|
||||
case "$arg" in
|
||||
--bash) target_shell="bash" ;;
|
||||
--zsh) target_shell="zsh" ;;
|
||||
--fish) target_shell="fish" ;;
|
||||
*) ;;
|
||||
esac
|
||||
done
|
||||
|
||||
# Auto-detect shell if not specified
|
||||
if [[ -z "$target_shell" ]]; then
|
||||
if [[ -n "$BASH_VERSION" ]]; then
|
||||
target_shell="bash"
|
||||
elif [[ -n "$ZSH_VERSION" ]]; then
|
||||
target_shell="zsh"
|
||||
elif [[ -n "$FISH_VERSION" ]]; then
|
||||
target_shell="fish"
|
||||
else
|
||||
echo -e "${RED}[X] Could not detect shell${RESET}" >&2
|
||||
echo "" >&2
|
||||
echo -e "${YELLOW}Usage:${RESET}" >&2
|
||||
echo " ccs --shell-completion # Auto-detect shell" >&2
|
||||
echo " ccs --shell-completion --bash # Install for bash" >&2
|
||||
echo " ccs --shell-completion --zsh # Install for zsh" >&2
|
||||
echo " ccs --shell-completion --fish # Install for fish" >&2
|
||||
echo "" >&2
|
||||
return 1
|
||||
fi
|
||||
fi
|
||||
|
||||
# Ensure completion files exist in ~/.ccs/completions/
|
||||
local completions_dir="$HOME/.ccs/completions"
|
||||
if [[ ! -d "$completions_dir" ]]; then
|
||||
mkdir -p "$completions_dir"
|
||||
fi
|
||||
|
||||
# Copy from scripts if not present
|
||||
local script_dir="$(dirname "$0")"
|
||||
if [[ -f "$script_dir/../scripts/completion/ccs.bash" ]]; then
|
||||
cp "$script_dir/../scripts/completion/ccs.bash" "$completions_dir/" 2>/dev/null || true
|
||||
cp "$script_dir/../scripts/completion/ccs.zsh" "$completions_dir/" 2>/dev/null || true
|
||||
cp "$script_dir/../scripts/completion/ccs.fish" "$completions_dir/" 2>/dev/null || true
|
||||
fi
|
||||
|
||||
# Install based on target shell
|
||||
case "$target_shell" in
|
||||
bash)
|
||||
local rc_file="$HOME/.bashrc"
|
||||
local completion_file="$completions_dir/ccs.bash"
|
||||
local marker="# CCS shell completion"
|
||||
|
||||
if [[ ! -f "$completion_file" ]]; then
|
||||
echo -e "${RED}[X] Completion file not found: $completion_file${RESET}" >&2
|
||||
echo " Please reinstall CCS." >&2
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Check if already installed
|
||||
if grep -q "$marker" "$rc_file" 2>/dev/null; then
|
||||
echo -e "${GREEN}[OK] Shell completion already installed${RESET}"
|
||||
echo ""
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Append to .bashrc
|
||||
{
|
||||
echo ""
|
||||
echo "$marker"
|
||||
echo "source \"$completion_file\""
|
||||
} >> "$rc_file"
|
||||
|
||||
echo -e "${GREEN}[OK] Shell completion installed successfully!${RESET}"
|
||||
echo ""
|
||||
echo "Added to $rc_file"
|
||||
echo ""
|
||||
echo -e "${CYAN}To activate:${RESET}"
|
||||
echo " source ~/.bashrc"
|
||||
echo ""
|
||||
echo -e "${CYAN}Then test:${RESET}"
|
||||
echo " ccs <TAB> # See available profiles"
|
||||
echo " ccs auth <TAB> # See auth subcommands"
|
||||
echo ""
|
||||
;;
|
||||
|
||||
zsh)
|
||||
local rc_file="$HOME/.zshrc"
|
||||
local completion_dir="$HOME/.zsh/completion"
|
||||
local completion_file="$completions_dir/ccs.zsh"
|
||||
local marker="# CCS shell completion"
|
||||
|
||||
if [[ ! -f "$completion_file" ]]; then
|
||||
echo -e "${RED}[X] Completion file not found: $completion_file${RESET}" >&2
|
||||
echo " Please reinstall CCS." >&2
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Create zsh completion directory
|
||||
mkdir -p "$completion_dir"
|
||||
|
||||
# Copy to zsh completion directory
|
||||
cp "$completion_file" "$completion_dir/_ccs"
|
||||
|
||||
# Check if already installed
|
||||
if grep -q "$marker" "$rc_file" 2>/dev/null; then
|
||||
echo -e "${GREEN}[OK] Shell completion already installed${RESET}"
|
||||
echo ""
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Append to .zshrc
|
||||
{
|
||||
echo ""
|
||||
echo "$marker"
|
||||
echo "fpath=(~/.zsh/completion \$fpath)"
|
||||
echo "autoload -Uz compinit && compinit"
|
||||
} >> "$rc_file"
|
||||
|
||||
echo -e "${GREEN}[OK] Shell completion installed successfully!${RESET}"
|
||||
echo ""
|
||||
echo "Added to $rc_file"
|
||||
echo ""
|
||||
echo -e "${CYAN}To activate:${RESET}"
|
||||
echo " source ~/.zshrc"
|
||||
echo ""
|
||||
echo -e "${CYAN}Then test:${RESET}"
|
||||
echo " ccs <TAB> # See available profiles"
|
||||
echo " ccs auth <TAB> # See auth subcommands"
|
||||
echo ""
|
||||
;;
|
||||
|
||||
fish)
|
||||
local fish_dir="$HOME/.config/fish/completions"
|
||||
local completion_file="$completions_dir/ccs.fish"
|
||||
|
||||
if [[ ! -f "$completion_file" ]]; then
|
||||
echo -e "${RED}[X] Completion file not found: $completion_file${RESET}" >&2
|
||||
echo " Please reinstall CCS." >&2
|
||||
return 1
|
||||
fi
|
||||
|
||||
# Create fish completion directory
|
||||
mkdir -p "$fish_dir"
|
||||
|
||||
# Copy to fish completion directory (fish auto-loads from here)
|
||||
cp "$completion_file" "$fish_dir/ccs.fish"
|
||||
|
||||
echo -e "${GREEN}[OK] Shell completion installed successfully!${RESET}"
|
||||
echo ""
|
||||
echo "Installed to $fish_dir/ccs.fish"
|
||||
echo ""
|
||||
echo -e "${CYAN}To activate:${RESET}"
|
||||
echo " Fish auto-loads completions (no reload needed)"
|
||||
echo ""
|
||||
echo -e "${CYAN}Then test:${RESET}"
|
||||
echo " ccs <TAB> # See available profiles"
|
||||
echo " ccs auth <TAB> # See auth subcommands"
|
||||
echo ""
|
||||
;;
|
||||
|
||||
*)
|
||||
echo -e "${RED}[X] Unsupported shell: $target_shell${RESET}" >&2
|
||||
return 1
|
||||
;;
|
||||
esac
|
||||
|
||||
return 0
|
||||
}
|
||||
|
||||
# --- Main Execution Logic ---
|
||||
|
||||
# Special case: version command (check BEFORE profile detection)
|
||||
@@ -999,6 +1483,12 @@ if [[ $# -gt 0 ]] && [[ "${1}" == "auth" ]]; then
|
||||
exit $?
|
||||
fi
|
||||
|
||||
# Special case: shell completion installer
|
||||
if [[ $# -gt 0 ]] && [[ "${1}" == "--shell-completion" ]]; then
|
||||
install_shell_completion "$@"
|
||||
exit $?
|
||||
fi
|
||||
|
||||
# Special case: doctor command
|
||||
if [[ $# -gt 0 ]] && [[ "${1}" == "doctor" || "${1}" == "--doctor" ]]; then
|
||||
doctor_run
|
||||
@@ -1030,10 +1520,36 @@ fi
|
||||
|
||||
# Detect profile type
|
||||
if ! detect_profile_type "$PROFILE"; then
|
||||
msg_error "Profile '$PROFILE' not found
|
||||
# Get suggestions using fuzzy matching
|
||||
mapfile -t all_profiles < <(get_all_profile_names)
|
||||
mapfile -t suggestions < <(find_similar_strings "$PROFILE" "${all_profiles[@]}")
|
||||
|
||||
Available profiles:
|
||||
$(list_available_profiles)"
|
||||
echo "" >&2
|
||||
echo -e "${RED}[X] Profile '$PROFILE' not found${RESET}" >&2
|
||||
echo "" >&2
|
||||
|
||||
# Show suggestions if any
|
||||
if [[ ${#suggestions[@]} -gt 0 ]]; then
|
||||
echo -e "${YELLOW}Did you mean:${RESET}" >&2
|
||||
for suggestion in "${suggestions[@]}"; do
|
||||
echo " $suggestion" >&2
|
||||
done
|
||||
echo "" >&2
|
||||
fi
|
||||
|
||||
echo -e "${CYAN}Available profiles:${RESET}" >&2
|
||||
list_available_profiles >&2
|
||||
echo "" >&2
|
||||
echo -e "${YELLOW}Solutions:${RESET}" >&2
|
||||
echo " # Use existing profile" >&2
|
||||
echo " ccs <profile> \"your prompt\"" >&2
|
||||
echo "" >&2
|
||||
echo " # Create new account profile" >&2
|
||||
echo " ccs auth create <name>" >&2
|
||||
echo "" >&2
|
||||
echo -e "${YELLOW}Error: $E_PROFILE_NOT_FOUND${RESET}" >&2
|
||||
echo -e "${YELLOW}$(get_error_doc_url "$E_PROFILE_NOT_FOUND")${RESET}" >&2
|
||||
echo "" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
|
||||
+381
-20
@@ -12,12 +12,32 @@ param(
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
# Version (updated by scripts/bump-version.sh)
|
||||
$CcsVersion = "3.4.6"
|
||||
$CcsVersion = "3.5.0"
|
||||
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
|
||||
$ConfigFile = if ($env:CCS_CONFIG) { $env:CCS_CONFIG } else { "$env:USERPROFILE\.ccs\config.json" }
|
||||
$ProfilesJson = "$env:USERPROFILE\.ccs\profiles.json"
|
||||
$InstancesDir = "$env:USERPROFILE\.ccs\instances"
|
||||
|
||||
# Determine dependency location (git vs installed)
|
||||
# Git: lib/ccs.ps1 and dependencies are in same dir (lib/)
|
||||
# Installed: lib/ccs.ps1 is in ~/.ccs/, dependencies in ~/.ccs/lib/
|
||||
$DepDir = if (Test-Path "$ScriptDir\error-codes.ps1") {
|
||||
# Git install - files in same directory
|
||||
$ScriptDir
|
||||
} else {
|
||||
# Standalone install - files in ~/.ccs/lib/
|
||||
"$env:USERPROFILE\.ccs\lib"
|
||||
}
|
||||
|
||||
# Source error codes
|
||||
. "$DepDir\error-codes.ps1"
|
||||
|
||||
# Source progress indicators
|
||||
. "$DepDir\progress-indicator.ps1"
|
||||
|
||||
# Source interactive prompts
|
||||
. "$DepDir\prompt.ps1"
|
||||
|
||||
# --- Color/Format Functions ---
|
||||
function Write-ErrorMsg {
|
||||
param([string]$Message)
|
||||
@@ -30,6 +50,104 @@ function Write-ErrorMsg {
|
||||
Write-Host ""
|
||||
}
|
||||
|
||||
# Calculate Levenshtein distance between two strings
|
||||
function Get-LevenshteinDistance {
|
||||
param(
|
||||
[string]$a,
|
||||
[string]$b
|
||||
)
|
||||
|
||||
$lenA = $a.Length
|
||||
$lenB = $b.Length
|
||||
|
||||
if ($lenA -eq 0) { return $lenB }
|
||||
if ($lenB -eq 0) { return $lenA }
|
||||
|
||||
# Initialize matrix
|
||||
$matrix = New-Object 'int[,]' ($lenB + 1), ($lenA + 1)
|
||||
|
||||
# Initialize first row and column
|
||||
for ($i = 0; $i -le $lenB; $i++) {
|
||||
$matrix[$i, 0] = $i
|
||||
}
|
||||
for ($j = 0; $j -le $lenA; $j++) {
|
||||
$matrix[0, $j] = $j
|
||||
}
|
||||
|
||||
# Fill matrix
|
||||
for ($i = 1; $i -le $lenB; $i++) {
|
||||
for ($j = 1; $j -le $lenA; $j++) {
|
||||
if ($a[$j - 1] -eq $b[$i - 1]) {
|
||||
$matrix[$i, $j] = $matrix[$i - 1, $j - 1]
|
||||
} else {
|
||||
$sub = $matrix[$i - 1, $j - 1]
|
||||
$ins = $matrix[$i, $j - 1]
|
||||
$del = $matrix[$i - 1, $j]
|
||||
$min = [Math]::Min([Math]::Min($sub, $ins), $del)
|
||||
$matrix[$i, $j] = $min + 1
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return $matrix[$lenB, $lenA]
|
||||
}
|
||||
|
||||
# Find similar strings using fuzzy matching
|
||||
function Find-SimilarStrings {
|
||||
param(
|
||||
[string]$Target,
|
||||
[string[]]$Candidates,
|
||||
[int]$MaxDistance = 2
|
||||
)
|
||||
|
||||
$targetLower = $Target.ToLower()
|
||||
$matches = @()
|
||||
|
||||
foreach ($candidate in $Candidates) {
|
||||
$candidateLower = $candidate.ToLower()
|
||||
$distance = Get-LevenshteinDistance $targetLower $candidateLower
|
||||
|
||||
if ($distance -le $MaxDistance -and $distance -gt 0) {
|
||||
$matches += [PSCustomObject]@{
|
||||
Name = $candidate
|
||||
Distance = $distance
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Sort by distance and return top 3
|
||||
return $matches | Sort-Object Distance | Select-Object -First 3 | ForEach-Object { $_.Name }
|
||||
}
|
||||
|
||||
# Enhanced error message with error codes
|
||||
function Show-EnhancedError {
|
||||
param(
|
||||
[string]$ErrorCode,
|
||||
[string]$ShortMsg,
|
||||
[string]$Context = "",
|
||||
[string]$Suggestions = ""
|
||||
)
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "[X] $ShortMsg" -ForegroundColor Red
|
||||
Write-Host ""
|
||||
|
||||
if ($Context) {
|
||||
Write-Host $Context
|
||||
Write-Host ""
|
||||
}
|
||||
|
||||
if ($Suggestions) {
|
||||
Write-Host "Solutions:" -ForegroundColor Yellow
|
||||
Write-Host $Suggestions
|
||||
Write-Host ""
|
||||
}
|
||||
|
||||
Write-Host "Error: $ErrorCode" -ForegroundColor Yellow
|
||||
Write-Host (Get-ErrorDocUrl $ErrorCode) -ForegroundColor Yellow
|
||||
Write-Host ""
|
||||
}
|
||||
|
||||
function Write-ColoredText {
|
||||
param(
|
||||
[string]$Text,
|
||||
@@ -111,6 +229,19 @@ function Show-Help {
|
||||
Write-ColorLine " ccs kimi Switch to Kimi for Coding" "Yellow"
|
||||
Write-ColorLine " ccs glm 'debug this code' Use GLM and run command" "Yellow"
|
||||
Write-Host ""
|
||||
Write-ColorLine "Examples:" "Cyan"
|
||||
Write-Host " Quick start:"
|
||||
Write-ColorLine " `$ ccs" "Yellow" -NoNewline
|
||||
Write-Host " # Use default account"
|
||||
Write-ColorLine " `$ ccs glm `"implement API`"" "Yellow" -NoNewline
|
||||
Write-Host " # Cost-optimized model"
|
||||
Write-Host ""
|
||||
Write-Host " Profile usage:"
|
||||
Write-ColorLine " `$ ccs work `"debug code`"" "Yellow" -NoNewline
|
||||
Write-Host " # Switch to work profile"
|
||||
Write-ColorLine " `$ ccs personal" "Yellow" -NoNewline
|
||||
Write-Host " # Open personal account"
|
||||
Write-Host ""
|
||||
Write-ColorLine "Account Management:" "Cyan"
|
||||
Write-ColorLine " ccs auth --help Manage multiple Claude accounts" "Yellow"
|
||||
Write-ColorLine " ccs work Switch to work account" "Yellow"
|
||||
@@ -122,6 +253,7 @@ function Show-Help {
|
||||
Write-ColorLine "Flags:" "Cyan"
|
||||
Write-ColorLine " -h, --help Show this help message" "Yellow"
|
||||
Write-ColorLine " -v, --version Show version and installation info" "Yellow"
|
||||
Write-ColorLine " --shell-completion Install shell auto-completion" "Yellow"
|
||||
Write-Host ""
|
||||
Write-ColorLine "Configuration:" "Cyan"
|
||||
Write-Host " Config: ~/.ccs/config.json"
|
||||
@@ -585,6 +717,28 @@ function Ensure-Instance {
|
||||
|
||||
# --- Profile Detection Logic (Phase 1) ---
|
||||
|
||||
function Get-AllProfileNames {
|
||||
$names = @()
|
||||
|
||||
# Settings-based profiles
|
||||
if (Test-Path $ConfigFile) {
|
||||
try {
|
||||
$Config = Get-Content $ConfigFile -Raw | ConvertFrom-Json
|
||||
$names += $Config.profiles.PSObject.Properties.Name
|
||||
} catch {}
|
||||
}
|
||||
|
||||
# Account-based profiles
|
||||
if (Test-Path $ProfilesJson) {
|
||||
try {
|
||||
$Profiles = Read-ProfilesJson
|
||||
$names += $Profiles.profiles.PSObject.Properties.Name
|
||||
} catch {}
|
||||
}
|
||||
|
||||
return $names
|
||||
}
|
||||
|
||||
function Get-AvailableProfiles {
|
||||
$lines = @()
|
||||
|
||||
@@ -718,6 +872,12 @@ function Show-AuthHelp {
|
||||
Write-Host ' ccs work "review code" # Use work profile' -ForegroundColor Yellow
|
||||
Write-Host ' ccs "review code" # Use default profile' -ForegroundColor Yellow
|
||||
Write-Host ""
|
||||
Write-Host "Options:" -ForegroundColor Cyan
|
||||
Write-Host " --force Allow overwriting existing profile (create)" -ForegroundColor Yellow
|
||||
Write-Host " --yes, -y Skip confirmation prompts (remove)" -ForegroundColor Yellow
|
||||
Write-Host " --json Output in JSON format (list, show)" -ForegroundColor Yellow
|
||||
Write-Host " --verbose Show additional details (list)" -ForegroundColor Yellow
|
||||
Write-Host ""
|
||||
Write-Host "Note:" -ForegroundColor Cyan
|
||||
Write-Host " By default, " -NoNewline
|
||||
Write-Host "ccs" -ForegroundColor Yellow -NoNewline
|
||||
@@ -796,8 +956,13 @@ function Invoke-AuthList {
|
||||
param([string[]]$Args)
|
||||
|
||||
$Verbose = $Args -contains "--verbose"
|
||||
$Json = $Args -contains "--json"
|
||||
|
||||
if (-not (Test-Path $ProfilesJson)) {
|
||||
if ($Json) {
|
||||
Write-Output "{`"version`":`"$CcsVersion`",`"profiles`":[]}"
|
||||
return
|
||||
}
|
||||
Write-Host "No account profiles found" -ForegroundColor Yellow
|
||||
Write-Host ""
|
||||
Write-Host "To create your first profile:"
|
||||
@@ -809,10 +974,45 @@ function Invoke-AuthList {
|
||||
$Profiles = $Data.profiles.PSObject.Properties.Name
|
||||
|
||||
if ($Profiles.Count -eq 0) {
|
||||
if ($Json) {
|
||||
Write-Output "{`"version`":`"$CcsVersion`",`"profiles`":[]}"
|
||||
return
|
||||
}
|
||||
Write-Host "No account profiles found" -ForegroundColor Yellow
|
||||
return
|
||||
}
|
||||
|
||||
# JSON output mode
|
||||
if ($Json) {
|
||||
$ProfilesList = @()
|
||||
foreach ($profile in $Profiles) {
|
||||
$IsDefault = $profile -eq $Data.default
|
||||
$Type = $Data.profiles.$profile.type
|
||||
if (-not $Type) { $Type = "account" }
|
||||
$Created = $Data.profiles.$profile.created
|
||||
$LastUsed = $Data.profiles.$profile.last_used
|
||||
$InstancePath = "$InstancesDir\$(Get-SanitizedProfileName $profile)"
|
||||
|
||||
$ProfilesList += @{
|
||||
name = $profile
|
||||
type = $Type
|
||||
is_default = $IsDefault
|
||||
created = $Created
|
||||
last_used = $LastUsed
|
||||
instance_path = $InstancePath
|
||||
}
|
||||
}
|
||||
|
||||
$Output = @{
|
||||
version = $CcsVersion
|
||||
profiles = $ProfilesList
|
||||
}
|
||||
|
||||
Write-Output ($Output | ConvertTo-Json -Depth 10)
|
||||
return
|
||||
}
|
||||
|
||||
# Human-readable output
|
||||
Write-Host "Saved Account Profiles:" -ForegroundColor White
|
||||
Write-Host ""
|
||||
|
||||
@@ -846,10 +1046,26 @@ function Invoke-AuthList {
|
||||
function Invoke-AuthShow {
|
||||
param([string[]]$Args)
|
||||
|
||||
$ProfileName = $Args[0]
|
||||
$ProfileName = ""
|
||||
$Json = $false
|
||||
|
||||
# Parse arguments
|
||||
foreach ($arg in $Args) {
|
||||
if ($arg -eq "--json") {
|
||||
$Json = $true
|
||||
} elseif ($arg -like "-*") {
|
||||
Write-ErrorMsg "Unknown option: $arg"
|
||||
return 1
|
||||
} else {
|
||||
$ProfileName = $arg
|
||||
}
|
||||
}
|
||||
|
||||
if (-not $ProfileName) {
|
||||
Write-ErrorMsg "Profile name is required`nUsage: ccs auth show <profile>"
|
||||
Write-ErrorMsg "Profile name is required"
|
||||
Write-Host ""
|
||||
Write-Host "Usage: " -NoNewline
|
||||
Write-Host "ccs auth show <profile> [--json]" -ForegroundColor Yellow
|
||||
return 1
|
||||
}
|
||||
|
||||
@@ -861,20 +1077,48 @@ function Invoke-AuthShow {
|
||||
$Data = Read-ProfilesJson
|
||||
$IsDefault = $ProfileName -eq $Data.default
|
||||
|
||||
Write-Host "Profile: $ProfileName" -ForegroundColor White
|
||||
Write-Host ""
|
||||
|
||||
$Type = $Data.profiles.$ProfileName.type
|
||||
if (-not $Type) { $Type = "account" }
|
||||
$Created = $Data.profiles.$ProfileName.created
|
||||
$LastUsed = $Data.profiles.$ProfileName.last_used
|
||||
if (-not $LastUsed) { $LastUsed = "Never" }
|
||||
$InstancePath = "$InstancesDir\$(Get-SanitizedProfileName $ProfileName)"
|
||||
|
||||
# Count sessions
|
||||
$SessionCount = 0
|
||||
if (Test-Path "$InstancePath\session-env") {
|
||||
$SessionFiles = Get-ChildItem "$InstancePath\session-env" -Filter "*.json" -ErrorAction SilentlyContinue
|
||||
$SessionCount = $SessionFiles.Count
|
||||
}
|
||||
|
||||
# JSON output mode
|
||||
if ($Json) {
|
||||
$Output = @{
|
||||
name = $ProfileName
|
||||
type = $Type
|
||||
is_default = $IsDefault
|
||||
created = $Created
|
||||
last_used = $LastUsed
|
||||
instance_path = $InstancePath
|
||||
session_count = $SessionCount
|
||||
}
|
||||
|
||||
Write-Output ($Output | ConvertTo-Json -Depth 10)
|
||||
return
|
||||
}
|
||||
|
||||
# Human-readable output
|
||||
Write-Host "Profile: $ProfileName" -ForegroundColor White
|
||||
Write-Host ""
|
||||
|
||||
Write-Host " Type: $Type"
|
||||
Write-Host " Default: $(if ($IsDefault) { 'Yes' } else { 'No' })"
|
||||
Write-Host " Instance: $InstancePath"
|
||||
Write-Host " Created: $Created"
|
||||
Write-Host " Last used: $LastUsed"
|
||||
if ($LastUsed) {
|
||||
Write-Host " Last used: $LastUsed"
|
||||
} else {
|
||||
Write-Host " Last used: Never"
|
||||
}
|
||||
Write-Host ""
|
||||
}
|
||||
|
||||
@@ -882,18 +1126,24 @@ function Invoke-AuthRemove {
|
||||
param([string[]]$Args)
|
||||
|
||||
$ProfileName = ""
|
||||
$Force = $false
|
||||
|
||||
# Parse arguments
|
||||
foreach ($arg in $Args) {
|
||||
if ($arg -eq "--force") {
|
||||
$Force = $true
|
||||
if ($arg -eq "--yes" -or $arg -eq "-y") {
|
||||
$env:CCS_YES = "1" # Auto-confirm
|
||||
} elseif ($arg -like "-*") {
|
||||
Write-ErrorMsg "Unknown option: $arg"
|
||||
return 1
|
||||
} else {
|
||||
$ProfileName = $arg
|
||||
}
|
||||
}
|
||||
|
||||
if (-not $ProfileName) {
|
||||
Write-ErrorMsg "Profile name is required`nUsage: ccs auth remove <profile> --force"
|
||||
Write-ErrorMsg "Profile name is required"
|
||||
Write-Host ""
|
||||
Write-Host "Usage: " -NoNewline
|
||||
Write-Host "ccs auth remove <profile> [--yes]" -ForegroundColor Yellow
|
||||
return 1
|
||||
}
|
||||
|
||||
@@ -902,13 +1152,33 @@ function Invoke-AuthRemove {
|
||||
return 1
|
||||
}
|
||||
|
||||
if (-not $Force) {
|
||||
Write-ErrorMsg "Removal requires --force flag for safety`nRun: ccs auth remove $ProfileName --force"
|
||||
return 1
|
||||
# Get instance path and session count for impact display
|
||||
$InstancePath = "$InstancesDir\$(Get-SanitizedProfileName $ProfileName)"
|
||||
$SessionCount = 0
|
||||
|
||||
if (Test-Path "$InstancePath\session-env") {
|
||||
$SessionFiles = Get-ChildItem "$InstancePath\session-env" -Filter "*.json" -ErrorAction SilentlyContinue
|
||||
$SessionCount = $SessionFiles.Count
|
||||
}
|
||||
|
||||
# Display impact
|
||||
Write-Host ""
|
||||
Write-Host "Profile '" -NoNewline
|
||||
Write-Host $ProfileName -ForegroundColor Cyan -NoNewline
|
||||
Write-Host "' will be permanently deleted."
|
||||
Write-Host " Instance path: $InstancePath"
|
||||
Write-Host " Sessions: $SessionCount conversation$(if ($SessionCount -ne 1) { 's' } else { '' })"
|
||||
Write-Host ""
|
||||
|
||||
# Interactive confirmation (or --yes flag)
|
||||
$Confirmed = Confirm-Action "Delete this profile?" "No"
|
||||
|
||||
if (-not $Confirmed) {
|
||||
Write-Host "[i] Cancelled"
|
||||
return 0
|
||||
}
|
||||
|
||||
# Delete instance directory
|
||||
$InstancePath = "$InstancesDir\$(Get-SanitizedProfileName $ProfileName)"
|
||||
if (Test-Path $InstancePath) {
|
||||
Remove-Item $InstancePath -Recurse -Force
|
||||
}
|
||||
@@ -962,6 +1232,65 @@ function Invoke-AuthCommands {
|
||||
}
|
||||
}
|
||||
|
||||
function Install-ShellCompletion {
|
||||
param([string[]]$Args)
|
||||
|
||||
Write-Host ""
|
||||
Write-Host "Shell Completion Installer" -ForegroundColor Yellow
|
||||
Write-Host ""
|
||||
|
||||
# Ensure completion directory exists
|
||||
$CompletionsDir = Join-Path $env:USERPROFILE ".ccs\completions"
|
||||
if (-not (Test-Path $CompletionsDir)) {
|
||||
New-Item -ItemType Directory -Path $CompletionsDir -Force | Out-Null
|
||||
}
|
||||
|
||||
# Ensure completion file exists
|
||||
$CompletionFile = Join-Path $CompletionsDir "ccs.ps1"
|
||||
if (-not (Test-Path $CompletionFile)) {
|
||||
Write-Host "[X] Completion file not found. Please reinstall CCS." -ForegroundColor Red
|
||||
Write-Host ""
|
||||
exit 1
|
||||
}
|
||||
|
||||
# Get PowerShell profile path
|
||||
$ProfilePath = $PROFILE
|
||||
$ProfileDir = Split-Path $ProfilePath -Parent
|
||||
|
||||
# Create profile directory if it doesn't exist
|
||||
if (-not (Test-Path $ProfileDir)) {
|
||||
New-Item -ItemType Directory -Path $ProfileDir -Force | Out-Null
|
||||
}
|
||||
|
||||
# Comment marker for easy identification
|
||||
$Marker = "# CCS shell completion"
|
||||
$SourceCmd = ". `"$CompletionFile`""
|
||||
|
||||
# Check if already installed
|
||||
if (Test-Path $ProfilePath) {
|
||||
$Content = Get-Content $ProfilePath -Raw -ErrorAction SilentlyContinue
|
||||
if ($Content -and $Content.Contains($Marker)) {
|
||||
Write-Host "[OK] Shell completion already installed" -ForegroundColor Green
|
||||
Write-Host ""
|
||||
return 0
|
||||
}
|
||||
}
|
||||
|
||||
# Append to PowerShell profile
|
||||
$Block = "`n$Marker`n$SourceCmd`n"
|
||||
Add-Content -Path $ProfilePath -Value $Block -NoNewline
|
||||
|
||||
Write-Host "[OK] Shell completion installed successfully!" -ForegroundColor Green
|
||||
Write-Host ""
|
||||
Write-Host "Added to $ProfilePath"
|
||||
Write-Host ""
|
||||
Write-Host "To activate:" -ForegroundColor Cyan
|
||||
Write-Host " . `$PROFILE"
|
||||
Write-Host ""
|
||||
|
||||
return 0
|
||||
}
|
||||
|
||||
# --- Main Execution Logic ---
|
||||
|
||||
# Special case: version command (check BEFORE profile detection)
|
||||
@@ -988,6 +1317,13 @@ if ($Help) {
|
||||
}
|
||||
}
|
||||
|
||||
# Special case: shell completion installer
|
||||
if ($RemainingArgs.Count -gt 0 -and $RemainingArgs[0] -eq "--shell-completion") {
|
||||
$CompletionArgs = if ($RemainingArgs.Count -gt 1) { $RemainingArgs[1..($RemainingArgs.Count-1)] } else { @() }
|
||||
$Result = Install-ShellCompletion $CompletionArgs
|
||||
exit $Result
|
||||
}
|
||||
|
||||
# Special case: auth commands
|
||||
if ($RemainingArgs.Count -gt 0 -and $RemainingArgs[0] -eq "auth") {
|
||||
$AuthArgs = if ($RemainingArgs.Count -gt 1) { $RemainingArgs[1..($RemainingArgs.Count-1)] } else { @() }
|
||||
@@ -1025,11 +1361,36 @@ if ($Profile -notmatch '^[a-zA-Z0-9_-]+$') {
|
||||
$ProfileInfo = Get-ProfileType $Profile
|
||||
|
||||
if ($ProfileInfo.Type -eq "error") {
|
||||
$ErrorMessage = "Profile '$Profile' not found" + "`n`n" +
|
||||
"Available profiles:" + "`n" +
|
||||
(Get-AvailableProfiles)
|
||||
# Get suggestions using fuzzy matching
|
||||
$AllProfiles = Get-AllProfileNames
|
||||
$Suggestions = Find-SimilarStrings -Target $Profile -Candidates $AllProfiles
|
||||
|
||||
Write-ErrorMsg $ErrorMessage
|
||||
Write-Host ""
|
||||
Write-Host "[X] Profile '$Profile' not found" -ForegroundColor Red
|
||||
Write-Host ""
|
||||
|
||||
# Show suggestions if any
|
||||
if ($Suggestions -and $Suggestions.Count -gt 0) {
|
||||
Write-Host "Did you mean:" -ForegroundColor Yellow
|
||||
foreach ($suggestion in $Suggestions) {
|
||||
Write-Host " $suggestion"
|
||||
}
|
||||
Write-Host ""
|
||||
}
|
||||
|
||||
Write-Host "Available profiles:" -ForegroundColor Cyan
|
||||
Get-AvailableProfiles | ForEach-Object { Write-Host $_ }
|
||||
Write-Host ""
|
||||
Write-Host "Solutions:" -ForegroundColor Yellow
|
||||
Write-Host " # Use existing profile"
|
||||
Write-Host " ccs <profile> `"your prompt`""
|
||||
Write-Host ""
|
||||
Write-Host " # Create new account profile"
|
||||
Write-Host " ccs auth create <name>"
|
||||
Write-Host ""
|
||||
Write-Host "Error: $script:E_PROFILE_NOT_FOUND" -ForegroundColor Yellow
|
||||
Write-Host (Get-ErrorDocUrl $script:E_PROFILE_NOT_FOUND) -ForegroundColor Yellow
|
||||
Write-Host ""
|
||||
exit 1
|
||||
}
|
||||
|
||||
|
||||
@@ -0,0 +1,55 @@
|
||||
# CCS Error Codes
|
||||
# Documentation: ../docs/errors/README.md
|
||||
|
||||
# Configuration Errors (E100-E199)
|
||||
$script:E_CONFIG_MISSING = "E101"
|
||||
$script:E_CONFIG_INVALID_JSON = "E102"
|
||||
$script:E_CONFIG_INVALID_PROFILE = "E103"
|
||||
|
||||
# Profile Management Errors (E200-E299)
|
||||
$script:E_PROFILE_NOT_FOUND = "E104"
|
||||
$script:E_PROFILE_ALREADY_EXISTS = "E105"
|
||||
$script:E_PROFILE_CANNOT_DELETE_DEFAULT = "E106"
|
||||
$script:E_PROFILE_INVALID_NAME = "E107"
|
||||
|
||||
# Claude CLI Detection Errors (E300-E399)
|
||||
$script:E_CLAUDE_NOT_FOUND = "E301"
|
||||
$script:E_CLAUDE_VERSION_INCOMPATIBLE = "E302"
|
||||
$script:E_CLAUDE_EXECUTION_FAILED = "E303"
|
||||
|
||||
# Network/API Errors (E400-E499)
|
||||
$script:E_GLMT_PROXY_TIMEOUT = "E401"
|
||||
$script:E_API_KEY_MISSING = "E402"
|
||||
$script:E_API_AUTH_FAILED = "E403"
|
||||
$script:E_API_RATE_LIMIT = "E404"
|
||||
|
||||
# File System Errors (E500-E599)
|
||||
$script:E_FS_CANNOT_CREATE_DIR = "E501"
|
||||
$script:E_FS_CANNOT_WRITE_FILE = "E502"
|
||||
$script:E_FS_CANNOT_READ_FILE = "E503"
|
||||
$script:E_FS_INSTANCE_NOT_FOUND = "E504"
|
||||
|
||||
# Internal Errors (E900-E999)
|
||||
$script:E_INTERNAL_ERROR = "E900"
|
||||
$script:E_INVALID_STATE = "E901"
|
||||
|
||||
# Get error documentation URL
|
||||
function Get-ErrorDocUrl {
|
||||
param([string]$ErrorCode)
|
||||
return "https://github.com/kaitranntt/ccs/blob/main/docs/errors/README.md#$($ErrorCode.ToLower())"
|
||||
}
|
||||
|
||||
# Get error category from code
|
||||
function Get-ErrorCategory {
|
||||
param([string]$ErrorCode)
|
||||
|
||||
$code = [int]$ErrorCode.Substring(1)
|
||||
|
||||
if ($code -ge 100 -and $code -lt 200) { return "Configuration" }
|
||||
elseif ($code -ge 200 -and $code -lt 300) { return "Profile Management" }
|
||||
elseif ($code -ge 300 -and $code -lt 400) { return "Claude CLI Detection" }
|
||||
elseif ($code -ge 400 -and $code -lt 500) { return "Network/API" }
|
||||
elseif ($code -ge 500 -and $code -lt 600) { return "File System" }
|
||||
elseif ($code -ge 900 -and $code -lt 1000) { return "Internal" }
|
||||
else { return "Unknown" }
|
||||
}
|
||||
@@ -0,0 +1,63 @@
|
||||
#!/usr/bin/env bash
|
||||
# CCS Error Codes
|
||||
# Documentation: ../docs/errors/README.md
|
||||
|
||||
# Configuration Errors (E100-E199)
|
||||
readonly E_CONFIG_MISSING="E101"
|
||||
readonly E_CONFIG_INVALID_JSON="E102"
|
||||
readonly E_CONFIG_INVALID_PROFILE="E103"
|
||||
|
||||
# Profile Management Errors (E200-E299)
|
||||
readonly E_PROFILE_NOT_FOUND="E104"
|
||||
readonly E_PROFILE_ALREADY_EXISTS="E105"
|
||||
readonly E_PROFILE_CANNOT_DELETE_DEFAULT="E106"
|
||||
readonly E_PROFILE_INVALID_NAME="E107"
|
||||
|
||||
# Claude CLI Detection Errors (E300-E399)
|
||||
readonly E_CLAUDE_NOT_FOUND="E301"
|
||||
readonly E_CLAUDE_VERSION_INCOMPATIBLE="E302"
|
||||
readonly E_CLAUDE_EXECUTION_FAILED="E303"
|
||||
|
||||
# Network/API Errors (E400-E499)
|
||||
readonly E_GLMT_PROXY_TIMEOUT="E401"
|
||||
readonly E_API_KEY_MISSING="E402"
|
||||
readonly E_API_AUTH_FAILED="E403"
|
||||
readonly E_API_RATE_LIMIT="E404"
|
||||
|
||||
# File System Errors (E500-E599)
|
||||
readonly E_FS_CANNOT_CREATE_DIR="E501"
|
||||
readonly E_FS_CANNOT_WRITE_FILE="E502"
|
||||
readonly E_FS_CANNOT_READ_FILE="E503"
|
||||
readonly E_FS_INSTANCE_NOT_FOUND="E504"
|
||||
|
||||
# Internal Errors (E900-E999)
|
||||
readonly E_INTERNAL_ERROR="E900"
|
||||
readonly E_INVALID_STATE="E901"
|
||||
|
||||
# Get error documentation URL
|
||||
get_error_doc_url() {
|
||||
local error_code="$1"
|
||||
echo "https://github.com/kaitranntt/ccs/blob/main/docs/errors/README.md#${error_code,,}"
|
||||
}
|
||||
|
||||
# Get error category from code
|
||||
get_error_category() {
|
||||
local error_code="$1"
|
||||
local code="${error_code#E}"
|
||||
|
||||
if [[ $code -ge 100 && $code -lt 200 ]]; then
|
||||
echo "Configuration"
|
||||
elif [[ $code -ge 200 && $code -lt 300 ]]; then
|
||||
echo "Profile Management"
|
||||
elif [[ $code -ge 300 && $code -lt 400 ]]; then
|
||||
echo "Claude CLI Detection"
|
||||
elif [[ $code -ge 400 && $code -lt 500 ]]; then
|
||||
echo "Network/API"
|
||||
elif [[ $code -ge 500 && $code -lt 600 ]]; then
|
||||
echo "File System"
|
||||
elif [[ $code -ge 900 && $code -lt 1000 ]]; then
|
||||
echo "Internal"
|
||||
else
|
||||
echo "Unknown"
|
||||
fi
|
||||
}
|
||||
@@ -0,0 +1,120 @@
|
||||
# CCS Progress Indicator (PowerShell 5.1+ compatible)
|
||||
# Simple spinner for long-running operations
|
||||
# NO external dependencies - ASCII-only for cross-platform compatibility
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
# Show simple spinner (synchronous)
|
||||
function Show-Spinner {
|
||||
param(
|
||||
[string]$Message,
|
||||
[scriptblock]$Task
|
||||
)
|
||||
|
||||
# TTY detection: only animate if not redirected and not in CI
|
||||
$IsTTY = -not [Console]::IsOutputRedirected -and -not $env:CI -and -not $env:NO_COLOR
|
||||
|
||||
$StartTime = Get-Date
|
||||
|
||||
if (-not $IsTTY) {
|
||||
# Non-TTY: just print message and run task
|
||||
Write-Host "[i] $Message..." -ForegroundColor Gray
|
||||
$result = & $Task
|
||||
Write-Host "[OK] $Message" -ForegroundColor Green
|
||||
return $result
|
||||
}
|
||||
|
||||
# ASCII-only frames for cross-platform compatibility
|
||||
$Frames = @('|', '/', '-', '\')
|
||||
$FrameIndex = 0
|
||||
|
||||
# Start task in background job
|
||||
$Job = Start-Job -ScriptBlock $Task
|
||||
|
||||
try {
|
||||
# Animate spinner while job is running
|
||||
while ($Job.State -eq 'Running') {
|
||||
$Frame = $Frames[$FrameIndex]
|
||||
$Elapsed = [math]::Round(((Get-Date) - $StartTime).TotalSeconds, 1)
|
||||
Write-Host "`r[$Frame] $Message... ($($Elapsed)s)" -NoNewline -ForegroundColor Cyan
|
||||
$FrameIndex = ($FrameIndex + 1) % $Frames.Length
|
||||
Start-Sleep -Milliseconds 100
|
||||
}
|
||||
|
||||
# Clear spinner line
|
||||
Write-Host "`r$(' ' * 80)`r" -NoNewline
|
||||
|
||||
# Check job result
|
||||
$JobResult = Receive-Job -Job $Job -ErrorAction Stop
|
||||
$Elapsed = [math]::Round(((Get-Date) - $StartTime).TotalSeconds, 1)
|
||||
Write-Host "[OK] $Message ($($Elapsed)s)" -ForegroundColor Green
|
||||
|
||||
return $JobResult
|
||||
}
|
||||
catch {
|
||||
# Clear spinner line
|
||||
Write-Host "`r$(' ' * 80)`r" -NoNewline
|
||||
Write-Host "[X] $Message" -ForegroundColor Red
|
||||
throw
|
||||
}
|
||||
finally {
|
||||
# Cleanup job
|
||||
if ($Job) {
|
||||
Remove-Job -Job $Job -Force -ErrorAction SilentlyContinue
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Show progress counter for multi-step operations
|
||||
function Show-ProgressStep {
|
||||
param(
|
||||
[int]$Current,
|
||||
[int]$Total,
|
||||
[string]$Message
|
||||
)
|
||||
|
||||
# TTY detection
|
||||
$IsTTY = -not [Console]::IsOutputRedirected -and -not $env:CI
|
||||
|
||||
if (-not $IsTTY) {
|
||||
Write-Host "[$Current/$Total] $Message" -ForegroundColor Gray
|
||||
return
|
||||
}
|
||||
|
||||
# Show progress with carriage return (can be overwritten)
|
||||
Write-Host "`r[$Current/$Total] $Message..." -NoNewline -ForegroundColor Cyan
|
||||
}
|
||||
|
||||
# Clear progress line
|
||||
function Clear-Progress {
|
||||
$IsTTY = -not [Console]::IsOutputRedirected -and -not $env:CI
|
||||
|
||||
if ($IsTTY) {
|
||||
Write-Host "`r$(' ' * 80)`r" -NoNewline
|
||||
}
|
||||
}
|
||||
|
||||
# Simple status message (for operations that don't need spinners)
|
||||
function Write-Status {
|
||||
param(
|
||||
[string]$Message,
|
||||
[ValidateSet('Info', 'Success', 'Warning', 'Error')]
|
||||
[string]$Type = 'Info'
|
||||
)
|
||||
|
||||
$Prefix = switch ($Type) {
|
||||
'Info' { '[i]'; break }
|
||||
'Success' { '[OK]'; break }
|
||||
'Warning' { '[!]'; break }
|
||||
'Error' { '[X]'; break }
|
||||
}
|
||||
|
||||
$Color = switch ($Type) {
|
||||
'Info' { 'Gray'; break }
|
||||
'Success' { 'Green'; break }
|
||||
'Warning' { 'Yellow'; break }
|
||||
'Error' { 'Red'; break }
|
||||
}
|
||||
|
||||
Write-Host "$Prefix $Message" -ForegroundColor $Color
|
||||
}
|
||||
@@ -0,0 +1,117 @@
|
||||
#!/usr/bin/env bash
|
||||
# CCS Progress Indicator (bash 3.2+ compatible)
|
||||
# Simple spinner for long-running operations
|
||||
# NO external dependencies - ASCII-only for cross-platform compatibility
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
# Show spinner while a background process is running
|
||||
# Usage: show_spinner "message" $pid
|
||||
show_spinner() {
|
||||
local message="$1"
|
||||
local pid="$2"
|
||||
|
||||
# TTY detection: only animate if stderr is TTY and not in CI
|
||||
if [[ ! -t 2 ]] || [[ -n "${CI:-}" ]] || [[ -n "${NO_COLOR:-}" ]]; then
|
||||
# Non-TTY: just print message once
|
||||
echo "[i] $message..." >&2
|
||||
wait "$pid" 2>/dev/null || true
|
||||
return
|
||||
fi
|
||||
|
||||
# ASCII-only frames for cross-platform compatibility
|
||||
local frames=('|' '/' '-' '\\')
|
||||
local frame_idx=0
|
||||
local start_time=$(date +%s)
|
||||
|
||||
# Animate spinner while process is running
|
||||
while kill -0 "$pid" 2>/dev/null; do
|
||||
local frame="${frames[$frame_idx]}"
|
||||
local elapsed=$(($(date +%s) - start_time))
|
||||
printf "\r[%s] %s... (%ds)" "$frame" "$message" "$elapsed" >&2
|
||||
frame_idx=$(( (frame_idx + 1) % 4 ))
|
||||
sleep 0.1
|
||||
done
|
||||
|
||||
# Clear spinner line
|
||||
printf "\r\033[K" >&2
|
||||
|
||||
# Wait for process to complete and capture exit code
|
||||
wait "$pid" 2>/dev/null || true
|
||||
}
|
||||
|
||||
# Show spinner with success/fail result
|
||||
# Usage: spinner_with_result "message" "command"
|
||||
spinner_with_result() {
|
||||
local message="$1"
|
||||
shift
|
||||
local command=("$@")
|
||||
|
||||
local start_time=$(date +%s)
|
||||
|
||||
# TTY detection
|
||||
if [[ ! -t 2 ]] || [[ -n "${CI:-}" ]] || [[ -n "${NO_COLOR:-}" ]]; then
|
||||
# Non-TTY: just print message and run command
|
||||
echo "[i] $message..." >&2
|
||||
if "${command[@]}"; then
|
||||
echo "[OK] $message" >&2
|
||||
return 0
|
||||
else
|
||||
echo "[X] $message" >&2
|
||||
return 1
|
||||
fi
|
||||
fi
|
||||
|
||||
# Run command in background
|
||||
"${command[@]}" &>/dev/null &
|
||||
local pid=$!
|
||||
|
||||
# Show spinner
|
||||
local frames=('|' '/' '-' '\\')
|
||||
local frame_idx=0
|
||||
|
||||
while kill -0 "$pid" 2>/dev/null; do
|
||||
local frame="${frames[$frame_idx]}"
|
||||
local elapsed=$(($(date +%s) - start_time))
|
||||
printf "\r[%s] %s... (%ds)" "$frame" "$message" "$elapsed" >&2
|
||||
frame_idx=$(( (frame_idx + 1) % 4 ))
|
||||
sleep 0.1
|
||||
done
|
||||
|
||||
# Clear spinner line
|
||||
printf "\r\033[K" >&2
|
||||
|
||||
# Check result
|
||||
if wait "$pid" 2>/dev/null; then
|
||||
local elapsed=$(($(date +%s) - start_time))
|
||||
echo "[OK] $message (${elapsed}s)" >&2
|
||||
return 0
|
||||
else
|
||||
echo "[X] $message" >&2
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
# Simple progress counter (for multi-step operations)
|
||||
# Usage: show_progress_step 3 10 "Checking configuration"
|
||||
show_progress_step() {
|
||||
local current="$1"
|
||||
local total="$2"
|
||||
local message="$3"
|
||||
|
||||
# TTY detection
|
||||
if [[ ! -t 2 ]] || [[ -n "${CI:-}" ]]; then
|
||||
echo "[${current}/${total}] $message" >&2
|
||||
return
|
||||
fi
|
||||
|
||||
# Show progress with carriage return (can be overwritten)
|
||||
printf "\r[%d/%d] %s..." "$current" "$total" "$message" >&2
|
||||
}
|
||||
|
||||
# Clear progress line
|
||||
clear_progress() {
|
||||
if [[ -t 2 ]] && [[ -z "${CI:-}" ]]; then
|
||||
printf "\r\033[K" >&2
|
||||
fi
|
||||
}
|
||||
+109
@@ -0,0 +1,109 @@
|
||||
# CCS Interactive Prompt Utilities (PowerShell 5.1+ compatible)
|
||||
# NO external dependencies
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
# Interactive confirmation prompt
|
||||
function Confirm-Action {
|
||||
param(
|
||||
[string]$Message,
|
||||
[ValidateSet('Yes', 'No')]
|
||||
[string]$Default = 'No'
|
||||
)
|
||||
|
||||
# Check for --yes flag (automation)
|
||||
if ($env:CCS_YES -eq '1' -or $global:RemainingArgs -contains '--yes' -or $global:RemainingArgs -contains '-y') {
|
||||
return $Default -eq 'Yes'
|
||||
}
|
||||
|
||||
# Check for --no-input flag (CI)
|
||||
if ($env:CCS_NO_INPUT -eq '1' -or $global:RemainingArgs -contains '--no-input') {
|
||||
Write-Host "[X] Interactive input required but --no-input specified" -ForegroundColor Red
|
||||
exit 1
|
||||
}
|
||||
|
||||
# Non-TTY: use default
|
||||
if ([Console]::IsInputRedirected) {
|
||||
return $Default -eq 'Yes'
|
||||
}
|
||||
|
||||
# Interactive prompt
|
||||
$PromptText = if ($Default -eq 'Yes') {
|
||||
"$Message [Y/n]: "
|
||||
} else {
|
||||
"$Message [y/N]: "
|
||||
}
|
||||
|
||||
while ($true) {
|
||||
Write-Host $PromptText -NoNewline -ForegroundColor Cyan
|
||||
$Response = Read-Host
|
||||
|
||||
$Normalized = $Response.Trim().ToLower()
|
||||
|
||||
# Empty answer: use default
|
||||
if ($Normalized -eq '' -or $Normalized -eq ' ') {
|
||||
return $Default -eq 'Yes'
|
||||
}
|
||||
|
||||
# Valid answers
|
||||
if ($Normalized -eq 'y' -or $Normalized -eq 'yes') {
|
||||
return $true
|
||||
}
|
||||
|
||||
if ($Normalized -eq 'n' -or $Normalized -eq 'no') {
|
||||
return $false
|
||||
}
|
||||
|
||||
# Invalid input: retry
|
||||
Write-Host "[!] Please answer y or n" -ForegroundColor Yellow
|
||||
}
|
||||
}
|
||||
|
||||
# Interactive text input
|
||||
function Read-Input {
|
||||
param(
|
||||
[string]$Message,
|
||||
[string]$Default = '',
|
||||
[scriptblock]$Validate = $null
|
||||
)
|
||||
|
||||
# Non-TTY: use default or error
|
||||
if ([Console]::IsInputRedirected) {
|
||||
if ($Default) {
|
||||
return $Default
|
||||
}
|
||||
throw "Interactive input required but stdin is redirected"
|
||||
}
|
||||
|
||||
# Interactive prompt
|
||||
$PromptText = if ($Default) {
|
||||
"$Message [$Default]: "
|
||||
} else {
|
||||
"$Message: "
|
||||
}
|
||||
|
||||
while ($true) {
|
||||
Write-Host $PromptText -NoNewline -ForegroundColor Cyan
|
||||
$Response = Read-Host
|
||||
|
||||
$Value = if ($Response.Trim()) { $Response.Trim() } else { $Default }
|
||||
|
||||
# Validate input if validator provided
|
||||
if ($Validate) {
|
||||
$Error = & $Validate $Value
|
||||
if ($Error) {
|
||||
Write-Host "[!] $Error" -ForegroundColor Yellow
|
||||
continue
|
||||
}
|
||||
}
|
||||
|
||||
return $Value
|
||||
}
|
||||
}
|
||||
|
||||
# Check if running in non-interactive mode
|
||||
function Test-NonInteractive {
|
||||
return [Console]::IsInputRedirected -or
|
||||
$env:CCS_YES -eq '1' -or
|
||||
$env:CCS_NO_INPUT -eq '1'
|
||||
}
|
||||
@@ -0,0 +1,99 @@
|
||||
#!/usr/bin/env bash
|
||||
# CCS Interactive Prompt Utilities (bash 3.2+ compatible)
|
||||
# NO external dependencies
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
# Interactive confirmation prompt
|
||||
# Usage: confirm_action "message" "yes"|"no"
|
||||
# Returns: 0 (true) or 1 (false)
|
||||
confirm_action() {
|
||||
local message="$1"
|
||||
local default="${2:-no}" # Default to NO for safety
|
||||
|
||||
# Check for --yes flag (automation) - always returns true (0)
|
||||
if [[ "${CCS_YES:-}" == "1" ]]; then
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Check for --no-input flag (CI)
|
||||
if [[ "${CCS_NO_INPUT:-}" == "1" ]]; then
|
||||
echo "[X] Interactive input required but --no-input specified" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Non-TTY: use default
|
||||
if [[ ! -t 0 ]]; then
|
||||
[[ "$default" == "yes" ]] && return 0 || return 1
|
||||
fi
|
||||
|
||||
# Interactive prompt
|
||||
local prompt
|
||||
if [[ "$default" == "yes" ]]; then
|
||||
prompt="$message [Y/n]: "
|
||||
else
|
||||
prompt="$message [y/N]: "
|
||||
fi
|
||||
|
||||
while true; do
|
||||
read -r -p "$prompt" response >&2
|
||||
response=$(echo "$response" | tr '[:upper:]' '[:lower:]')
|
||||
|
||||
case "$response" in
|
||||
""|" ")
|
||||
# Empty answer: use default
|
||||
[[ "$default" == "yes" ]] && return 0 || return 1
|
||||
;;
|
||||
y|yes)
|
||||
return 0
|
||||
;;
|
||||
n|no)
|
||||
return 1
|
||||
;;
|
||||
*)
|
||||
echo "[!] Please answer y or n" >&2
|
||||
;;
|
||||
esac
|
||||
done
|
||||
}
|
||||
|
||||
# Interactive text input
|
||||
# Usage: prompt_input "message" "default_value"
|
||||
# Outputs: user input to stdout
|
||||
prompt_input() {
|
||||
local message="$1"
|
||||
local default="${2:-}"
|
||||
|
||||
# Non-TTY: use default or error
|
||||
if [[ ! -t 0 ]]; then
|
||||
if [[ -n "$default" ]]; then
|
||||
echo "$default"
|
||||
return 0
|
||||
else
|
||||
echo "[X] Interactive input required but stdin is not a TTY" >&2
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
# Interactive prompt
|
||||
local prompt
|
||||
if [[ -n "$default" ]]; then
|
||||
prompt="$message [$default]: "
|
||||
else
|
||||
prompt="$message: "
|
||||
fi
|
||||
|
||||
read -r -p "$prompt" response >&2
|
||||
|
||||
# Return user input or default
|
||||
if [[ -z "$response" ]]; then
|
||||
echo "$default"
|
||||
else
|
||||
echo "$response"
|
||||
fi
|
||||
}
|
||||
|
||||
# Check if running in non-interactive mode
|
||||
is_non_interactive() {
|
||||
[[ ! -t 0 ]] || [[ "${CCS_YES:-}" == "1" ]] || [[ "${CCS_NO_INPUT:-}" == "1" ]]
|
||||
}
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@kaitranntt/ccs",
|
||||
"version": "3.4.6",
|
||||
"version": "3.5.0",
|
||||
"description": "Claude Code Switch - Instant profile switching between Claude Sonnet 4.5 and GLM 4.6",
|
||||
"keywords": [
|
||||
"cli",
|
||||
|
||||
@@ -0,0 +1,308 @@
|
||||
# Shell Completion for CCS
|
||||
|
||||
Tab completion for CCS commands, subcommands, profiles, and flags.
|
||||
|
||||
**Supported Shells:** Bash, Zsh, Fish, PowerShell
|
||||
|
||||
## Features
|
||||
|
||||
- Complete profile names (both settings-based and account-based)
|
||||
- Complete `ccs auth` subcommands (create, list, show, remove, default)
|
||||
- Complete flags (`--help`, `--version`, `--json`, `--verbose`, `--yes`)
|
||||
- Complete profile names for auth subcommands
|
||||
- Context-aware: suggests relevant options based on current command
|
||||
|
||||
## Quick Install (Recommended)
|
||||
|
||||
```bash
|
||||
ccs --shell-completion
|
||||
```
|
||||
|
||||
This will:
|
||||
- Auto-detect your shell
|
||||
- Copy completion files to `~/.ccs/completions/`
|
||||
- Configure your shell profile with proper comment markers
|
||||
- Show instructions to activate
|
||||
|
||||
**Manual shell selection:**
|
||||
```bash
|
||||
ccs --shell-completion --bash # Force bash
|
||||
ccs --shell-completion --zsh # Force zsh
|
||||
ccs --shell-completion --fish # Force fish
|
||||
ccs --shell-completion --powershell # Force PowerShell
|
||||
```
|
||||
|
||||
## Manual Installation
|
||||
|
||||
Completion files are installed to `~/.ccs/completions/` during `npm install`.
|
||||
|
||||
### Bash
|
||||
|
||||
Add to `~/.bashrc` or `~/.bash_profile`:
|
||||
|
||||
```bash
|
||||
# CCS shell completion
|
||||
source ~/.ccs/completions/ccs.bash
|
||||
```
|
||||
|
||||
Then reload:
|
||||
```bash
|
||||
source ~/.bashrc
|
||||
```
|
||||
|
||||
### Zsh
|
||||
|
||||
1. Create completion directory:
|
||||
```zsh
|
||||
mkdir -p ~/.zsh/completion
|
||||
```
|
||||
|
||||
2. Copy completion file:
|
||||
```zsh
|
||||
cp ~/.ccs/completions/ccs.zsh ~/.zsh/completion/_ccs
|
||||
```
|
||||
|
||||
3. Add to `~/.zshrc`:
|
||||
```zsh
|
||||
# CCS shell completion
|
||||
fpath=(~/.zsh/completion $fpath)
|
||||
autoload -Uz compinit && compinit
|
||||
```
|
||||
|
||||
4. Reload:
|
||||
```zsh
|
||||
source ~/.zshrc
|
||||
```
|
||||
|
||||
### PowerShell
|
||||
|
||||
Add to your PowerShell profile (`$PROFILE`):
|
||||
|
||||
```powershell
|
||||
# CCS shell completion
|
||||
. "$HOME\.ccs\completions\ccs.ps1"
|
||||
```
|
||||
|
||||
Then reload:
|
||||
```powershell
|
||||
. $PROFILE
|
||||
```
|
||||
|
||||
### Fish
|
||||
|
||||
**User installation (recommended)**
|
||||
|
||||
Fish automatically loads completions from `~/.config/fish/completions/`:
|
||||
|
||||
```fish
|
||||
# Create completion directory if it doesn't exist
|
||||
mkdir -p ~/.config/fish/completions
|
||||
|
||||
# Copy completion script
|
||||
cp scripts/completion/ccs.fish ~/.config/fish/completions/
|
||||
```
|
||||
|
||||
That's it! Fish will automatically load the completion on demand. No need to source or reload.
|
||||
|
||||
**System-wide installation (requires sudo)**
|
||||
|
||||
```fish
|
||||
sudo cp scripts/completion/ccs.fish /usr/share/fish/vendor_completions.d/
|
||||
```
|
||||
|
||||
## Usage Examples
|
||||
|
||||
### Basic Completion
|
||||
|
||||
```bash
|
||||
$ ccs <TAB>
|
||||
auth doctor glm glmt kimi work personal --help --version
|
||||
|
||||
$ ccs auth <TAB>
|
||||
create list show remove default --help
|
||||
```
|
||||
|
||||
### Profile Completion
|
||||
|
||||
```bash
|
||||
$ ccs auth show <TAB>
|
||||
work personal team --json
|
||||
|
||||
$ ccs auth remove <TAB>
|
||||
work personal team --yes -y
|
||||
```
|
||||
|
||||
### Flag Completion
|
||||
|
||||
```bash
|
||||
$ ccs auth list <TAB>
|
||||
--verbose --json
|
||||
|
||||
$ ccs auth show work <TAB>
|
||||
--json
|
||||
```
|
||||
|
||||
## Completion Behavior
|
||||
|
||||
### Top-level (after `ccs`)
|
||||
- Built-in commands: `auth`, `doctor`
|
||||
- Flags: `--help`, `--version`, `-h`, `-v`
|
||||
- Settings-based profiles: from `~/.ccs/config.json`
|
||||
- Account-based profiles: from `~/.ccs/profiles.json`
|
||||
|
||||
### After `ccs auth`
|
||||
- Subcommands: `create`, `list`, `show`, `remove`, `default`
|
||||
- Flags: `--help`, `-h`
|
||||
|
||||
### After `ccs auth <subcommand>`
|
||||
- **create**: No completion (user enters new profile name)
|
||||
- Flags: `--force`
|
||||
- **list**: No profile completion
|
||||
- Flags: `--verbose`, `--json`
|
||||
- **show**: Account profiles only
|
||||
- Flags: `--json`
|
||||
- **remove**: Account profiles only
|
||||
- Flags: `--yes`, `-y`
|
||||
- **default**: Account profiles only
|
||||
|
||||
### After `ccs <profile>`
|
||||
- No completion (Claude CLI arguments are free-form)
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Bash: Completion not working
|
||||
|
||||
1. Check if bash-completion is installed:
|
||||
```bash
|
||||
# macOS
|
||||
brew install bash-completion
|
||||
|
||||
# Ubuntu/Debian
|
||||
sudo apt install bash-completion
|
||||
```
|
||||
|
||||
2. Verify jq is installed (required for profile completion):
|
||||
```bash
|
||||
command -v jq
|
||||
```
|
||||
|
||||
3. Check if completion is loaded:
|
||||
```bash
|
||||
complete -p ccs
|
||||
```
|
||||
|
||||
Should output:
|
||||
```
|
||||
complete -F _ccs_completion ccs
|
||||
```
|
||||
|
||||
### Zsh: Completion not working
|
||||
|
||||
1. Verify completion system is enabled in `~/.zshrc`:
|
||||
```zsh
|
||||
autoload -Uz compinit && compinit
|
||||
```
|
||||
|
||||
2. Check if completion is loaded:
|
||||
```zsh
|
||||
which _ccs
|
||||
```
|
||||
|
||||
3. Rebuild completion cache:
|
||||
```zsh
|
||||
rm ~/.zcompdump && compinit
|
||||
```
|
||||
|
||||
### PowerShell: Completion not working
|
||||
|
||||
1. Check PowerShell version (5.1+ required):
|
||||
```powershell
|
||||
$PSVersionTable.PSVersion
|
||||
```
|
||||
|
||||
2. Verify profile is loaded:
|
||||
```powershell
|
||||
Test-Path $PROFILE
|
||||
```
|
||||
|
||||
3. Check if completion is registered:
|
||||
```powershell
|
||||
(Get-ArgumentCompleter).CommandName | Select-String ccs
|
||||
```
|
||||
|
||||
### Fish: Completion not working
|
||||
|
||||
1. Check Fish version (3.0+ required):
|
||||
```fish
|
||||
fish --version
|
||||
```
|
||||
|
||||
2. Verify completion file is in the right location:
|
||||
```fish
|
||||
ls ~/.config/fish/completions/ccs.fish
|
||||
```
|
||||
|
||||
3. Verify jq is installed (required for profile completion):
|
||||
```fish
|
||||
which jq
|
||||
```
|
||||
|
||||
4. Test completion manually:
|
||||
```fish
|
||||
complete -C'ccs '
|
||||
```
|
||||
|
||||
5. If needed, rebuild completions:
|
||||
```fish
|
||||
fish_update_completions
|
||||
```
|
||||
|
||||
## Technical Details
|
||||
|
||||
### Bash Implementation
|
||||
- Uses `complete -F` for programmable completion
|
||||
- Compatible with bash 3.2+ (macOS default)
|
||||
- Reads profiles dynamically using `jq`
|
||||
- Context-aware based on `COMP_CWORD` and `COMP_WORDS`
|
||||
|
||||
### Zsh Implementation
|
||||
- Uses `_arguments` and `_describe` for rich completion
|
||||
- Compatible with zsh 5.0+
|
||||
- Supports completion descriptions
|
||||
- Context-aware using `$state` and `$words`
|
||||
|
||||
### PowerShell Implementation
|
||||
- Uses `Register-ArgumentCompleter`
|
||||
- Compatible with PowerShell 5.1+
|
||||
- Reads profiles dynamically using `ConvertFrom-Json`
|
||||
- Provides `CompletionResult` objects
|
||||
|
||||
### Fish Implementation
|
||||
- Uses declarative `complete` command
|
||||
- Compatible with Fish 3.0+
|
||||
- Automatic loading from `~/.config/fish/completions/`
|
||||
- Helper functions for dynamic profile loading
|
||||
- Context-aware using `__fish_seen_subcommand_from`
|
||||
- No manual sourcing required
|
||||
|
||||
## Dependencies
|
||||
|
||||
- **jq**: Required for reading profiles from JSON files
|
||||
- Install: `brew install jq` (macOS) or `apt install jq` (Ubuntu)
|
||||
- Already required by CCS core functionality
|
||||
|
||||
## Contributing
|
||||
|
||||
When adding new commands or flags:
|
||||
1. Update all four completion scripts (bash, zsh, fish, PowerShell)
|
||||
2. Test on each shell
|
||||
3. Update this README with new completion examples
|
||||
4. Maintain cross-shell parity
|
||||
|
||||
## See Also
|
||||
|
||||
- [CCS Documentation](https://github.com/kaitranntt/ccs)
|
||||
- [Bash Programmable Completion](https://www.gnu.org/software/bash/manual/html_node/Programmable-Completion.html)
|
||||
- [Zsh Completion System](http://zsh.sourceforge.net/Doc/Release/Completion-System.html)
|
||||
- [Fish Completion Tutorial](https://fishshell.com/docs/current/completions.html)
|
||||
- [PowerShell Argument Completers](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/register-argumentcompleter)
|
||||
@@ -0,0 +1,81 @@
|
||||
# Bash completion for CCS (Claude Code Switch)
|
||||
# Compatible with bash 3.2+
|
||||
#
|
||||
# Installation:
|
||||
# Add to ~/.bashrc or ~/.bash_profile:
|
||||
# source /path/to/ccs/scripts/completion/ccs.bash
|
||||
#
|
||||
# Or install system-wide (requires sudo):
|
||||
# sudo cp scripts/completion/ccs.bash /etc/bash_completion.d/ccs
|
||||
|
||||
_ccs_completion() {
|
||||
local cur prev words cword
|
||||
COMPREPLY=()
|
||||
|
||||
# Get current word and previous word
|
||||
cur="${COMP_WORDS[COMP_CWORD]}"
|
||||
prev="${COMP_WORDS[COMP_CWORD-1]}"
|
||||
|
||||
# Top-level completion (first argument)
|
||||
if [[ ${COMP_CWORD} -eq 1 ]]; then
|
||||
local commands="auth doctor"
|
||||
local flags="--help --version -h -v"
|
||||
local profiles=""
|
||||
|
||||
# Add profiles from config.json (settings-based profiles)
|
||||
if [[ -f ~/.ccs/config.json ]]; then
|
||||
profiles="$profiles $(jq -r '.profiles | keys[]' ~/.ccs/config.json 2>/dev/null || true)"
|
||||
fi
|
||||
|
||||
# Add profiles from profiles.json (account-based profiles)
|
||||
if [[ -f ~/.ccs/profiles.json ]]; then
|
||||
profiles="$profiles $(jq -r '.profiles | keys[]' ~/.ccs/profiles.json 2>/dev/null || true)"
|
||||
fi
|
||||
|
||||
# Combine all options
|
||||
local opts="$commands $flags $profiles"
|
||||
COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
|
||||
return 0
|
||||
fi
|
||||
|
||||
# auth subcommands
|
||||
if [[ ${prev} == "auth" ]]; then
|
||||
local auth_commands="create list show remove default --help -h"
|
||||
COMPREPLY=( $(compgen -W "${auth_commands}" -- ${cur}) )
|
||||
return 0
|
||||
fi
|
||||
|
||||
# Completion for auth subcommands that need profile names
|
||||
if [[ ${COMP_WORDS[1]} == "auth" ]]; then
|
||||
case "${prev}" in
|
||||
show|remove|default)
|
||||
# Complete with account profile names only
|
||||
if [[ -f ~/.ccs/profiles.json ]]; then
|
||||
local profiles=$(jq -r '.profiles | keys[]' ~/.ccs/profiles.json 2>/dev/null || true)
|
||||
COMPREPLY=( $(compgen -W "${profiles}" -- ${cur}) )
|
||||
fi
|
||||
return 0
|
||||
;;
|
||||
create)
|
||||
# No completion for create (user enters new name)
|
||||
return 0
|
||||
;;
|
||||
list)
|
||||
# Complete with list flags
|
||||
COMPREPLY=( $(compgen -W "--verbose --json" -- ${cur}) )
|
||||
return 0
|
||||
;;
|
||||
esac
|
||||
fi
|
||||
|
||||
# Flags for doctor command
|
||||
if [[ ${COMP_WORDS[1]} == "doctor" ]]; then
|
||||
COMPREPLY=( $(compgen -W "--help -h" -- ${cur}) )
|
||||
return 0
|
||||
fi
|
||||
|
||||
return 0
|
||||
}
|
||||
|
||||
# Register completion function
|
||||
complete -F _ccs_completion ccs
|
||||
@@ -0,0 +1,92 @@
|
||||
# Fish completion for CCS (Claude Code Switch)
|
||||
# Compatible with fish 3.0+
|
||||
#
|
||||
# Installation:
|
||||
# Copy to ~/.config/fish/completions/:
|
||||
# mkdir -p ~/.config/fish/completions
|
||||
# cp scripts/completion/ccs.fish ~/.config/fish/completions/
|
||||
#
|
||||
# Fish will automatically load completions from this directory.
|
||||
# No need to source or reload - completions are loaded on demand.
|
||||
|
||||
# Helper function to get profiles
|
||||
function __fish_ccs_get_profiles
|
||||
set -l config_path ~/.ccs/config.json
|
||||
set -l profiles_path ~/.ccs/profiles.json
|
||||
|
||||
# Get settings-based profiles from config.json
|
||||
if test -f $config_path
|
||||
jq -r '.profiles | keys[]' $config_path 2>/dev/null
|
||||
end
|
||||
|
||||
# Get account-based profiles from profiles.json
|
||||
if test -f $profiles_path
|
||||
jq -r '.profiles | keys[]' $profiles_path 2>/dev/null
|
||||
end
|
||||
end
|
||||
|
||||
# Helper function to get account profiles only
|
||||
function __fish_ccs_get_account_profiles
|
||||
set -l profiles_path ~/.ccs/profiles.json
|
||||
|
||||
if test -f $profiles_path
|
||||
jq -r '.profiles | keys[]' $profiles_path 2>/dev/null
|
||||
end
|
||||
end
|
||||
|
||||
# Helper function to check if we're in auth context
|
||||
function __fish_ccs_using_auth
|
||||
__fish_seen_subcommand_from auth
|
||||
end
|
||||
|
||||
# Helper function to check specific auth subcommand
|
||||
function __fish_ccs_using_auth_subcommand
|
||||
set -l subcommand $argv[1]
|
||||
__fish_ccs_using_auth; and __fish_seen_subcommand_from $subcommand
|
||||
end
|
||||
|
||||
# Disable file completion for ccs
|
||||
complete -c ccs -f
|
||||
|
||||
# Top-level flags
|
||||
complete -c ccs -s h -l help -d 'Show help message'
|
||||
complete -c ccs -s v -l version -d 'Show version information'
|
||||
|
||||
# Top-level commands
|
||||
complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor' -a 'auth' -d 'Manage multiple Claude accounts'
|
||||
complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor' -a 'doctor' -d 'Run health check and diagnostics'
|
||||
|
||||
# Top-level profile completion (all profiles)
|
||||
complete -c ccs -n 'not __fish_seen_subcommand_from auth doctor' -a '(__fish_ccs_get_profiles)' -d 'Switch to profile'
|
||||
|
||||
# auth subcommands
|
||||
complete -c ccs -n '__fish_ccs_using_auth; and not __fish_seen_subcommand_from create list show remove default' -a 'create' -d 'Create new profile and login'
|
||||
complete -c ccs -n '__fish_ccs_using_auth; and not __fish_seen_subcommand_from create list show remove default' -a 'list' -d 'List all saved profiles'
|
||||
complete -c ccs -n '__fish_ccs_using_auth; and not __fish_seen_subcommand_from create list show remove default' -a 'show' -d 'Show profile details'
|
||||
complete -c ccs -n '__fish_ccs_using_auth; and not __fish_seen_subcommand_from create list show remove default' -a 'remove' -d 'Remove saved profile'
|
||||
complete -c ccs -n '__fish_ccs_using_auth; and not __fish_seen_subcommand_from create list show remove default' -a 'default' -d 'Set default profile'
|
||||
|
||||
# auth command flags
|
||||
complete -c ccs -n '__fish_ccs_using_auth' -s h -l help -d 'Show help for auth commands'
|
||||
|
||||
# auth create flags
|
||||
complete -c ccs -n '__fish_ccs_using_auth_subcommand create' -l force -d 'Allow overwriting existing profile'
|
||||
|
||||
# auth list flags
|
||||
complete -c ccs -n '__fish_ccs_using_auth_subcommand list' -l verbose -d 'Show additional details'
|
||||
complete -c ccs -n '__fish_ccs_using_auth_subcommand list' -l json -d 'Output in JSON format'
|
||||
|
||||
# auth show - profile names and flags
|
||||
complete -c ccs -n '__fish_ccs_using_auth_subcommand show' -a '(__fish_ccs_get_account_profiles)' -d 'Account profile'
|
||||
complete -c ccs -n '__fish_ccs_using_auth_subcommand show' -l json -d 'Output in JSON format'
|
||||
|
||||
# auth remove - profile names and flags
|
||||
complete -c ccs -n '__fish_ccs_using_auth_subcommand remove' -a '(__fish_ccs_get_account_profiles)' -d 'Account profile'
|
||||
complete -c ccs -n '__fish_ccs_using_auth_subcommand remove' -l yes -d 'Skip confirmation prompts'
|
||||
complete -c ccs -n '__fish_ccs_using_auth_subcommand remove' -s y -d 'Skip confirmation prompts'
|
||||
|
||||
# auth default - profile names only
|
||||
complete -c ccs -n '__fish_ccs_using_auth_subcommand default' -a '(__fish_ccs_get_account_profiles)' -d 'Account profile'
|
||||
|
||||
# doctor command flags
|
||||
complete -c ccs -n '__fish_seen_subcommand_from doctor' -s h -l help -d 'Show help for doctor command'
|
||||
@@ -0,0 +1,157 @@
|
||||
# PowerShell completion for CCS (Claude Code Switch)
|
||||
# Compatible with PowerShell 5.1+
|
||||
#
|
||||
# Installation:
|
||||
# Add to your PowerShell profile ($PROFILE):
|
||||
# . /path/to/ccs/scripts/completion/ccs.ps1
|
||||
#
|
||||
# Or install for current user:
|
||||
# Copy-Item scripts/completion/ccs.ps1 ~\Documents\PowerShell\Scripts\
|
||||
# Add to profile: . ~\Documents\PowerShell\Scripts\ccs.ps1
|
||||
|
||||
Register-ArgumentCompleter -CommandName ccs -ScriptBlock {
|
||||
param($commandName, $wordToComplete, $commandAst, $fakeBoundParameters)
|
||||
|
||||
$commands = @('auth', 'doctor', '--help', '--version', '-h', '-v')
|
||||
$authCommands = @('create', 'list', 'show', 'remove', 'default', '--help', '-h')
|
||||
$listFlags = @('--verbose', '--json')
|
||||
$removeFlags = @('--yes', '-y')
|
||||
$showFlags = @('--json')
|
||||
|
||||
# Get current position in command
|
||||
$words = $commandAst.ToString() -split '\s+' | Where-Object { $_ -ne '' }
|
||||
$position = $words.Count
|
||||
|
||||
# Helper function to get profiles
|
||||
function Get-CcsProfiles {
|
||||
param([string]$Type = 'all')
|
||||
|
||||
$profiles = @()
|
||||
|
||||
# Settings-based profiles
|
||||
if ($Type -in @('all', 'settings')) {
|
||||
$configPath = "$env:USERPROFILE\.ccs\config.json"
|
||||
if (Test-Path $configPath) {
|
||||
try {
|
||||
$config = Get-Content $configPath -Raw | ConvertFrom-Json
|
||||
$profiles += $config.profiles.PSObject.Properties.Name
|
||||
} catch {}
|
||||
}
|
||||
}
|
||||
|
||||
# Account-based profiles
|
||||
if ($Type -in @('all', 'account')) {
|
||||
$profilesPath = "$env:USERPROFILE\.ccs\profiles.json"
|
||||
if (Test-Path $profilesPath) {
|
||||
try {
|
||||
$data = Get-Content $profilesPath -Raw | ConvertFrom-Json
|
||||
$profiles += $data.profiles.PSObject.Properties.Name
|
||||
} catch {}
|
||||
}
|
||||
}
|
||||
|
||||
return $profiles | Sort-Object -Unique
|
||||
}
|
||||
|
||||
# Top-level completion
|
||||
if ($position -eq 2) {
|
||||
$allOptions = $commands + (Get-CcsProfiles)
|
||||
$allOptions | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
[System.Management.Automation.CompletionResult]::new(
|
||||
$_,
|
||||
$_,
|
||||
'ParameterValue',
|
||||
$_
|
||||
)
|
||||
}
|
||||
return
|
||||
}
|
||||
|
||||
# auth subcommand completion
|
||||
if ($words[1] -eq 'auth') {
|
||||
if ($position -eq 3) {
|
||||
# auth subcommands
|
||||
$authCommands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
[System.Management.Automation.CompletionResult]::new(
|
||||
$_,
|
||||
$_,
|
||||
'ParameterValue',
|
||||
$_
|
||||
)
|
||||
}
|
||||
} elseif ($position -eq 4) {
|
||||
# Profile names or flags for auth subcommands
|
||||
switch ($words[2]) {
|
||||
'show' {
|
||||
$options = (Get-CcsProfiles -Type account) + $showFlags
|
||||
$options | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
[System.Management.Automation.CompletionResult]::new(
|
||||
$_,
|
||||
$_,
|
||||
'ParameterValue',
|
||||
$_
|
||||
)
|
||||
}
|
||||
}
|
||||
'remove' {
|
||||
$options = (Get-CcsProfiles -Type account) + $removeFlags
|
||||
$options | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
[System.Management.Automation.CompletionResult]::new(
|
||||
$_,
|
||||
$_,
|
||||
'ParameterValue',
|
||||
$_
|
||||
)
|
||||
}
|
||||
}
|
||||
'default' {
|
||||
Get-CcsProfiles -Type account | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
[System.Management.Automation.CompletionResult]::new(
|
||||
$_,
|
||||
$_,
|
||||
'ParameterValue',
|
||||
$_
|
||||
)
|
||||
}
|
||||
}
|
||||
'list' {
|
||||
$listFlags | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
[System.Management.Automation.CompletionResult]::new(
|
||||
$_,
|
||||
$_,
|
||||
'ParameterValue',
|
||||
$_
|
||||
)
|
||||
}
|
||||
}
|
||||
'create' {
|
||||
# No completion for create (user types new name)
|
||||
}
|
||||
}
|
||||
} elseif ($position -eq 5) {
|
||||
# Flags after profile name
|
||||
switch ($words[2]) {
|
||||
'show' {
|
||||
$showFlags | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
[System.Management.Automation.CompletionResult]::new(
|
||||
$_,
|
||||
$_,
|
||||
'ParameterValue',
|
||||
$_
|
||||
)
|
||||
}
|
||||
}
|
||||
'remove' {
|
||||
$removeFlags | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
|
||||
[System.Management.Automation.CompletionResult]::new(
|
||||
$_,
|
||||
$_,
|
||||
'ParameterValue',
|
||||
$_
|
||||
)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,130 @@
|
||||
#compdef ccs
|
||||
|
||||
# Zsh completion for CCS (Claude Code Switch)
|
||||
# Compatible with zsh 5.0+
|
||||
#
|
||||
# Installation:
|
||||
# Add to ~/.zshrc:
|
||||
# fpath=(~/.zsh/completion $fpath)
|
||||
# autoload -Uz compinit && compinit
|
||||
# source /path/to/ccs/scripts/completion/ccs.zsh
|
||||
#
|
||||
# Or install system-wide:
|
||||
# sudo cp scripts/completion/ccs.zsh /usr/local/share/zsh/site-functions/_ccs
|
||||
|
||||
_ccs() {
|
||||
local -a commands profiles settings_profiles account_profiles
|
||||
local curcontext="$curcontext" state line
|
||||
typeset -A opt_args
|
||||
|
||||
# Define top-level commands
|
||||
commands=(
|
||||
'auth:Manage multiple Claude accounts'
|
||||
'doctor:Run health check and diagnostics'
|
||||
)
|
||||
|
||||
# Load settings-based profiles from config.json
|
||||
if [[ -f ~/.ccs/config.json ]]; then
|
||||
settings_profiles=(${(f)"$(jq -r '.profiles | keys[]' ~/.ccs/config.json 2>/dev/null)"})
|
||||
fi
|
||||
|
||||
# Load account-based profiles from profiles.json
|
||||
if [[ -f ~/.ccs/profiles.json ]]; then
|
||||
account_profiles=(${(f)"$(jq -r '.profiles | keys[]' ~/.ccs/profiles.json 2>/dev/null)"})
|
||||
fi
|
||||
|
||||
# Combine all profiles
|
||||
profiles=($settings_profiles $account_profiles)
|
||||
|
||||
_arguments -C \
|
||||
'(- *)'{-h,--help}'[Show help message]' \
|
||||
'(- *)'{-v,--version}'[Show version information]' \
|
||||
'1: :->command' \
|
||||
'*:: :->args'
|
||||
|
||||
case $state in
|
||||
command)
|
||||
local -a all_options
|
||||
all_options=($commands $profiles)
|
||||
_describe -t commands 'ccs commands' all_options
|
||||
;;
|
||||
|
||||
args)
|
||||
case $words[1] in
|
||||
auth)
|
||||
_ccs_auth
|
||||
;;
|
||||
doctor)
|
||||
_arguments \
|
||||
'(- *)'{-h,--help}'[Show help for doctor command]'
|
||||
;;
|
||||
*)
|
||||
# For profile names, complete with Claude CLI arguments
|
||||
_message 'Claude CLI arguments'
|
||||
;;
|
||||
esac
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
_ccs_auth() {
|
||||
local curcontext="$curcontext" state line
|
||||
typeset -A opt_args
|
||||
|
||||
local -a auth_commands account_profiles
|
||||
|
||||
# Define auth subcommands
|
||||
auth_commands=(
|
||||
'create:Create new profile and login'
|
||||
'list:List all saved profiles'
|
||||
'show:Show profile details'
|
||||
'remove:Remove saved profile'
|
||||
'default:Set default profile'
|
||||
)
|
||||
|
||||
# Load account profiles
|
||||
if [[ -f ~/.ccs/profiles.json ]]; then
|
||||
account_profiles=(${(f)"$(jq -r '.profiles | keys[]' ~/.ccs/profiles.json 2>/dev/null)"})
|
||||
fi
|
||||
|
||||
_arguments -C \
|
||||
'(- *)'{-h,--help}'[Show help for auth commands]' \
|
||||
'1: :->subcommand' \
|
||||
'*:: :->subargs'
|
||||
|
||||
case $state in
|
||||
subcommand)
|
||||
_describe -t auth-commands 'auth commands' auth_commands
|
||||
;;
|
||||
|
||||
subargs)
|
||||
case $words[1] in
|
||||
create)
|
||||
_message 'new profile name'
|
||||
_arguments '--force[Allow overwriting existing profile]'
|
||||
;;
|
||||
list)
|
||||
_arguments \
|
||||
'--verbose[Show additional details]' \
|
||||
'--json[Output in JSON format]'
|
||||
;;
|
||||
show)
|
||||
_arguments \
|
||||
'1:profile:($account_profiles)' \
|
||||
'--json[Output in JSON format]'
|
||||
;;
|
||||
remove)
|
||||
_arguments \
|
||||
'1:profile:($account_profiles)' \
|
||||
{--yes,-y}'[Skip confirmation prompts]'
|
||||
;;
|
||||
default)
|
||||
_arguments '1:profile:($account_profiles)'
|
||||
;;
|
||||
esac
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
# Register the completion function
|
||||
_ccs "$@"
|
||||
@@ -287,6 +287,30 @@ function createConfigFiles() {
|
||||
console.log('[OK] Kimi profile exists: ~/.ccs/kimi.settings.json (preserved)');
|
||||
}
|
||||
|
||||
// Copy shell completion files to ~/.ccs/completions/
|
||||
const completionsDir = path.join(ccsDir, 'completions');
|
||||
const scriptsCompletionDir = path.join(__dirname, '../scripts/completion');
|
||||
|
||||
if (!fs.existsSync(completionsDir)) {
|
||||
fs.mkdirSync(completionsDir, { recursive: true, mode: 0o755 });
|
||||
}
|
||||
|
||||
const completionFiles = ['ccs.bash', 'ccs.zsh', 'ccs.fish', 'ccs.ps1'];
|
||||
completionFiles.forEach(file => {
|
||||
const src = path.join(scriptsCompletionDir, file);
|
||||
const dest = path.join(completionsDir, file);
|
||||
|
||||
if (fs.existsSync(src)) {
|
||||
fs.copyFileSync(src, dest);
|
||||
}
|
||||
});
|
||||
|
||||
console.log('[OK] Installed shell completions: ~/.ccs/completions/');
|
||||
console.log('');
|
||||
console.log(' [i] Enable auto-completion:');
|
||||
console.log(' Run: ccs --shell-completion');
|
||||
console.log('');
|
||||
|
||||
// Create ~/.claude/settings.json if missing (NEW)
|
||||
const claudeDir = path.join(homedir, '.claude');
|
||||
const claudeSettingsPath = path.join(claudeDir, 'settings.json');
|
||||
|
||||
Executable
+593
@@ -0,0 +1,593 @@
|
||||
#!/usr/bin/env bash
|
||||
# CLI UX Integration Test Suite
|
||||
# Tests all 6 phases of CLI UX improvements
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
# Colors for output
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
CYAN='\033[0;36m'
|
||||
RESET='\033[0m'
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
|
||||
|
||||
# Test counters
|
||||
TOTAL_TESTS=0
|
||||
PASSED_TESTS=0
|
||||
FAILED_TESTS=0
|
||||
SKIPPED_TESTS=0
|
||||
|
||||
# Current test tracking
|
||||
CURRENT_TEST_HAS_FAILURE=0
|
||||
|
||||
# Test results
|
||||
RESULTS=()
|
||||
|
||||
# Helper functions
|
||||
log_info() {
|
||||
echo -e "${CYAN}[INFO]${RESET} $1"
|
||||
}
|
||||
|
||||
log_success() {
|
||||
echo -e "${GREEN}[PASS]${RESET} $1"
|
||||
}
|
||||
|
||||
log_fail() {
|
||||
echo -e "${RED}[FAIL]${RESET} $1"
|
||||
CURRENT_TEST_HAS_FAILURE=1
|
||||
}
|
||||
|
||||
log_skip() {
|
||||
echo -e "${YELLOW}[SKIP]${RESET} $1"
|
||||
CURRENT_TEST_HAS_FAILURE=-1 # Mark as skipped
|
||||
}
|
||||
|
||||
test_start() {
|
||||
# Finalize previous test if any
|
||||
if [[ $TOTAL_TESTS -gt 0 ]]; then
|
||||
test_end
|
||||
fi
|
||||
|
||||
TOTAL_TESTS=$((TOTAL_TESTS + 1))
|
||||
CURRENT_TEST_HAS_FAILURE=0
|
||||
echo ""
|
||||
echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
|
||||
echo -e "${CYAN}Test $TOTAL_TESTS: $1${RESET}"
|
||||
echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
|
||||
}
|
||||
|
||||
test_end() {
|
||||
# Count this test as passed, failed, or skipped
|
||||
if [[ $CURRENT_TEST_HAS_FAILURE -eq -1 ]]; then
|
||||
SKIPPED_TESTS=$((SKIPPED_TESTS + 1))
|
||||
elif [[ $CURRENT_TEST_HAS_FAILURE -eq 0 ]]; then
|
||||
PASSED_TESTS=$((PASSED_TESTS + 1))
|
||||
else
|
||||
FAILED_TESTS=$((FAILED_TESTS + 1))
|
||||
fi
|
||||
}
|
||||
|
||||
# Check prerequisites
|
||||
check_prerequisites() {
|
||||
log_info "Checking prerequisites..."
|
||||
|
||||
if ! command -v node &>/dev/null; then
|
||||
echo "ERROR: Node.js not found. Please install Node.js 14+"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if ! command -v jq &>/dev/null; then
|
||||
echo "ERROR: jq not found. Please install jq"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [[ ! -f "$PROJECT_ROOT/bin/ccs.js" ]]; then
|
||||
echo "ERROR: bin/ccs.js not found. Run from project root."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
log_success "Prerequisites OK"
|
||||
}
|
||||
|
||||
# Setup test environment
|
||||
setup_test_env() {
|
||||
log_info "Setting up test environment..."
|
||||
|
||||
# Backup existing CCS data
|
||||
if [[ -d ~/.ccs ]]; then
|
||||
local backup_dir=~/.ccs.backup.$(date +%s)
|
||||
mv ~/.ccs "$backup_dir"
|
||||
log_info "Backed up existing ~/.ccs to $backup_dir"
|
||||
fi
|
||||
|
||||
# Create fresh test environment
|
||||
mkdir -p ~/.ccs/instances/test-work/session-env
|
||||
mkdir -p ~/.ccs/instances/test-personal/session-env
|
||||
|
||||
# Create test profiles
|
||||
cat > ~/.ccs/profiles.json <<'EOF'
|
||||
{
|
||||
"profiles": {
|
||||
"test-work": {
|
||||
"type": "account",
|
||||
"created": "2025-11-14T00:00:00.000Z"
|
||||
},
|
||||
"test-personal": {
|
||||
"type": "account",
|
||||
"created": "2025-11-14T00:00:00.000Z"
|
||||
}
|
||||
},
|
||||
"default": "test-work"
|
||||
}
|
||||
EOF
|
||||
|
||||
# Create dummy session files
|
||||
echo '{}' > ~/.ccs/instances/test-work/session-env/session1.json
|
||||
echo '{}' > ~/.ccs/instances/test-work/session-env/session2.json
|
||||
echo '{}' > ~/.ccs/instances/test-personal/session-env/session3.json
|
||||
|
||||
# Create config.json with settings-based profiles (for fuzzy matching tests)
|
||||
cat > ~/.ccs/config.json <<'EOF'
|
||||
{
|
||||
"profiles": {
|
||||
"glm": "~/.ccs/glm.settings.json",
|
||||
"kimi": "~/.ccs/kimi.settings.json",
|
||||
"default": "~/.claude/settings.json"
|
||||
}
|
||||
}
|
||||
EOF
|
||||
|
||||
log_success "Test environment ready"
|
||||
}
|
||||
|
||||
# Cleanup test environment
|
||||
cleanup_test_env() {
|
||||
log_info "Cleaning up test environment..."
|
||||
|
||||
rm -rf ~/.ccs
|
||||
|
||||
# Restore backup if exists
|
||||
local latest_backup=$(ls -td ~/.ccs.backup.* 2>/dev/null | head -1 || true)
|
||||
if [[ -n "$latest_backup" ]]; then
|
||||
mv "$latest_backup" ~/.ccs
|
||||
log_info "Restored backup from $latest_backup"
|
||||
fi
|
||||
|
||||
log_success "Cleanup complete"
|
||||
}
|
||||
|
||||
#############################
|
||||
# Phase 1: Error Messaging
|
||||
#############################
|
||||
|
||||
test_error_codes() {
|
||||
test_start "Phase 1.1 - Error codes display"
|
||||
|
||||
# Node.js version
|
||||
local node_output=$(node "$PROJECT_ROOT/bin/ccs.js" nonexistent-profile "test" 2>&1)
|
||||
if echo "$node_output" | grep -q "E[0-9]\{3\}"; then
|
||||
log_success "Node.js: Error code displayed"
|
||||
else
|
||||
log_fail "Node.js: Error code NOT displayed"
|
||||
echo " Debug: Output was:" >&2
|
||||
echo "$node_output" | tail -3 >&2
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
local bash_output=$("$PROJECT_ROOT/lib/ccs" nonexistent-profile "test" 2>&1)
|
||||
if echo "$bash_output" | grep -q "E[0-9]\{3\}"; then
|
||||
log_success "Bash: Error code displayed"
|
||||
else
|
||||
log_fail "Bash: Error code NOT displayed"
|
||||
echo " Debug: Output was:" >&2
|
||||
echo "$bash_output" | tail -3 >&2
|
||||
fi
|
||||
}
|
||||
|
||||
test_fuzzy_matching() {
|
||||
test_start "Phase 1.2 - Fuzzy matching 'Did you mean?'"
|
||||
|
||||
# Node.js version (typo: glmm instead of glm)
|
||||
local node_output=$(node "$PROJECT_ROOT/bin/ccs.js" glmm "test" 2>&1)
|
||||
if echo "$node_output" | grep -qi "did you mean"; then
|
||||
log_success "Node.js: Fuzzy matching works"
|
||||
else
|
||||
log_fail "Node.js: Fuzzy matching NOT working"
|
||||
echo " Debug: Looking for 'did you mean' in output:" >&2
|
||||
echo "$node_output" | grep -i "mean\|glm\|profile" | head -5 >&2
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
local bash_output=$("$PROJECT_ROOT/lib/ccs" glmm "test" 2>&1)
|
||||
if echo "$bash_output" | grep -qi "did you mean"; then
|
||||
log_success "Bash: Fuzzy matching works"
|
||||
else
|
||||
log_fail "Bash: Fuzzy matching NOT working"
|
||||
echo " Debug: Looking for 'did you mean' in output:" >&2
|
||||
echo "$bash_output" | grep -i "mean\|glm\|profile" | head -5 >&2
|
||||
fi
|
||||
|
||||
# Additional test with account profiles (if they exist)
|
||||
if [[ -f ~/.ccs/profiles.json ]] && grep -q "test-work" ~/.ccs/profiles.json; then
|
||||
local node_acct_output=$(node "$PROJECT_ROOT/bin/ccs.js" test-wrk "test" 2>&1)
|
||||
if echo "$node_acct_output" | grep -qi "did you mean"; then
|
||||
log_success "Node.js: Fuzzy matching works for account profiles"
|
||||
else
|
||||
log_fail "Node.js: Fuzzy matching NOT working for account profiles"
|
||||
echo " Debug: test-wrk output:" >&2
|
||||
echo "$node_acct_output" | grep -i "mean\|test\|profile" | head -5 >&2
|
||||
fi
|
||||
|
||||
local bash_acct_output=$("$PROJECT_ROOT/lib/ccs" test-wrk "test" 2>&1)
|
||||
if echo "$bash_acct_output" | grep -qi "did you mean"; then
|
||||
log_success "Bash: Fuzzy matching works for account profiles"
|
||||
else
|
||||
log_fail "Bash: Fuzzy matching NOT working for account profiles"
|
||||
echo " Debug: test-wrk output:" >&2
|
||||
echo "$bash_acct_output" | grep -i "mean\|test\|profile" | head -5 >&2
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
test_examples_section() {
|
||||
test_start "Phase 1.3 - EXAMPLES section in help"
|
||||
|
||||
# Node.js version
|
||||
if node "$PROJECT_ROOT/bin/ccs.js" --help 2>&1 | grep -qi "examples:"; then
|
||||
log_success "Node.js: EXAMPLES section present"
|
||||
else
|
||||
log_fail "Node.js: EXAMPLES section missing"
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
if "$PROJECT_ROOT/lib/ccs" --help 2>&1 | grep -qi "examples:"; then
|
||||
log_success "Bash: EXAMPLES section present"
|
||||
else
|
||||
log_fail "Bash: EXAMPLES section missing"
|
||||
fi
|
||||
}
|
||||
|
||||
#############################
|
||||
# Phase 2: Progress Indicators
|
||||
#############################
|
||||
|
||||
test_doctor_progress() {
|
||||
test_start "Phase 2.1 - Doctor command progress"
|
||||
|
||||
# Node.js version
|
||||
if timeout 5s node "$PROJECT_ROOT/bin/ccs.js" doctor 2>&1 | grep -q "Checking"; then
|
||||
log_success "Node.js: Doctor progress displayed"
|
||||
else
|
||||
log_skip "Node.js: Doctor command (may need Claude CLI installed)"
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
if timeout 5s "$PROJECT_ROOT/lib/ccs" doctor 2>&1 | grep -E "\[[0-9]+/[0-9]+\]" > /dev/null; then
|
||||
log_success "Bash: Doctor progress counter displayed"
|
||||
else
|
||||
log_skip "Bash: Doctor command (may need Claude CLI installed)"
|
||||
fi
|
||||
}
|
||||
|
||||
test_tty_detection() {
|
||||
test_start "Phase 2.2 - TTY detection (NO_COLOR)"
|
||||
|
||||
# Test that NO_COLOR disables colors
|
||||
if NO_COLOR=1 node "$PROJECT_ROOT/bin/ccs.js" --help 2>&1 | grep -q $'\033\['; then
|
||||
log_fail "Node.js: Colors shown despite NO_COLOR"
|
||||
else
|
||||
log_success "Node.js: NO_COLOR respected"
|
||||
fi
|
||||
|
||||
if NO_COLOR=1 "$PROJECT_ROOT/lib/ccs" --help 2>&1 | grep -q $'\033\['; then
|
||||
log_fail "Bash: Colors shown despite NO_COLOR"
|
||||
else
|
||||
log_success "Bash: NO_COLOR respected"
|
||||
fi
|
||||
}
|
||||
|
||||
#############################
|
||||
# Phase 3: Interactive Prompts
|
||||
#############################
|
||||
|
||||
test_confirmation_prompt() {
|
||||
test_start "Phase 3.1 - Auth remove confirmation"
|
||||
|
||||
# Node.js version (send 'n' to cancel)
|
||||
if echo "n" | node "$PROJECT_ROOT/bin/ccs.js" auth remove test-personal 2>&1 | grep -q "Cancelled"; then
|
||||
log_success "Node.js: Confirmation prompt works (cancelled)"
|
||||
else
|
||||
log_fail "Node.js: Confirmation prompt NOT working"
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
if echo "n" | "$PROJECT_ROOT/lib/ccs" auth remove test-personal 2>&1 | grep -q "Cancelled"; then
|
||||
log_success "Bash: Confirmation prompt works (cancelled)"
|
||||
else
|
||||
log_fail "Bash: Confirmation prompt NOT working"
|
||||
fi
|
||||
}
|
||||
|
||||
test_yes_flag() {
|
||||
test_start "Phase 3.2 - --yes flag auto-confirm"
|
||||
|
||||
# Node.js version (should NOT prompt)
|
||||
local output=$(node "$PROJECT_ROOT/bin/ccs.js" auth remove test-personal --yes 2>&1 || true)
|
||||
if echo "$output" | grep -q "Profile removed successfully"; then
|
||||
log_success "Node.js: --yes flag works"
|
||||
|
||||
# Recreate profile for bash test
|
||||
cat > ~/.ccs/profiles.json <<'EOF'
|
||||
{
|
||||
"profiles": {
|
||||
"test-work": {
|
||||
"type": "account",
|
||||
"created": "2025-11-14T00:00:00.000Z"
|
||||
},
|
||||
"test-personal": {
|
||||
"type": "account",
|
||||
"created": "2025-11-14T00:00:00.000Z"
|
||||
}
|
||||
},
|
||||
"default": "test-work"
|
||||
}
|
||||
EOF
|
||||
else
|
||||
log_fail "Node.js: --yes flag NOT working"
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
if "$PROJECT_ROOT/lib/ccs" auth remove test-personal --yes 2>&1 | grep -q "Profile removed successfully"; then
|
||||
log_success "Bash: --yes flag works"
|
||||
else
|
||||
log_fail "Bash: --yes flag NOT working"
|
||||
fi
|
||||
}
|
||||
|
||||
test_impact_display() {
|
||||
test_start "Phase 3.3 - Impact display (sessions, paths)"
|
||||
|
||||
# Recreate profile if needed
|
||||
if ! grep -q "test-work" ~/.ccs/profiles.json 2>/dev/null; then
|
||||
cat > ~/.ccs/profiles.json <<'EOF'
|
||||
{
|
||||
"profiles": {
|
||||
"test-work": {
|
||||
"type": "account",
|
||||
"created": "2025-11-14T00:00:00.000Z"
|
||||
}
|
||||
},
|
||||
"default": "test-work"
|
||||
}
|
||||
EOF
|
||||
fi
|
||||
|
||||
# Node.js version
|
||||
if echo "n" | node "$PROJECT_ROOT/bin/ccs.js" auth remove test-work 2>&1 | grep -E "Sessions:|Instance path:" | wc -l | grep -q "2"; then
|
||||
log_success "Node.js: Impact display shown"
|
||||
else
|
||||
log_fail "Node.js: Impact display NOT shown"
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
if echo "n" | "$PROJECT_ROOT/lib/ccs" auth remove test-work 2>&1 | grep -E "Sessions:|Instance path:" | wc -l | grep -q "2"; then
|
||||
log_success "Bash: Impact display shown"
|
||||
else
|
||||
log_fail "Bash: Impact display NOT shown"
|
||||
fi
|
||||
}
|
||||
|
||||
#############################
|
||||
# Phase 4: JSON Output
|
||||
#############################
|
||||
|
||||
test_json_output() {
|
||||
test_start "Phase 4.1 - JSON output (auth list)"
|
||||
|
||||
# Node.js version
|
||||
if node "$PROJECT_ROOT/bin/ccs.js" auth list --json 2>/dev/null | jq . > /dev/null 2>&1; then
|
||||
log_success "Node.js: Valid JSON output"
|
||||
else
|
||||
log_fail "Node.js: Invalid JSON output"
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
if "$PROJECT_ROOT/lib/ccs" auth list --json 2>/dev/null | jq . > /dev/null 2>&1; then
|
||||
log_success "Bash: Valid JSON output"
|
||||
else
|
||||
log_fail "Bash: Invalid JSON output"
|
||||
fi
|
||||
}
|
||||
|
||||
test_json_version() {
|
||||
test_start "Phase 4.2 - JSON uses CCS version (not '1.0')"
|
||||
|
||||
# Node.js version
|
||||
local version=$(node "$PROJECT_ROOT/bin/ccs.js" auth list --json 2>/dev/null | jq -r '.version')
|
||||
if [[ "$version" != "1.0" ]] && [[ -n "$version" ]]; then
|
||||
log_success "Node.js: JSON version is '$version' (not '1.0')"
|
||||
else
|
||||
log_fail "Node.js: JSON version is '1.0' (should be CCS version)"
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
local version=$(lib/ccs auth list --json 2>/dev/null | jq -r '.version')
|
||||
if [[ "$version" != "1.0" ]] && [[ -n "$version" ]]; then
|
||||
log_success "Bash: JSON version is '$version' (not '1.0')"
|
||||
else
|
||||
log_fail "Bash: JSON version is '1.0' (should be CCS version)"
|
||||
fi
|
||||
}
|
||||
|
||||
test_session_count() {
|
||||
test_start "Phase 4.3 - session_count in JSON output"
|
||||
|
||||
# Node.js version
|
||||
if node "$PROJECT_ROOT/bin/ccs.js" auth show test-work --json 2>/dev/null | jq -e '.session_count' > /dev/null; then
|
||||
log_success "Node.js: session_count present in JSON"
|
||||
else
|
||||
log_fail "Node.js: session_count missing in JSON"
|
||||
fi
|
||||
|
||||
# Bash version
|
||||
if "$PROJECT_ROOT/lib/ccs" auth show test-work --json 2>/dev/null | jq -e '.session_count' > /dev/null; then
|
||||
log_success "Bash: session_count present in JSON"
|
||||
else
|
||||
log_fail "Bash: session_count missing in JSON"
|
||||
fi
|
||||
}
|
||||
|
||||
#############################
|
||||
# Phase 5: Cross-Platform Consistency
|
||||
#############################
|
||||
|
||||
test_ascii_error_boxes() {
|
||||
test_start "Phase 5.1 - ASCII error boxes (no Unicode)"
|
||||
|
||||
# Bash version (should use ===== not ╔═╗)
|
||||
if "$PROJECT_ROOT/lib/ccs" nonexistent 2>&1 | grep -q "╔\|═\|╗\|║\|╚\|╝"; then
|
||||
log_fail "Bash: Unicode box characters found (should be ASCII)"
|
||||
else
|
||||
log_success "Bash: ASCII-only error boxes"
|
||||
fi
|
||||
}
|
||||
|
||||
test_help_consistency() {
|
||||
test_start "Phase 5.2 - Help text structure consistency"
|
||||
|
||||
# Get section headers from both versions (use LC_ALL=C for consistent sorting)
|
||||
local node_sections=$(node "$PROJECT_ROOT/bin/ccs.js" --help 2>&1 | grep -E "^[A-Z][a-z]+:" | LC_ALL=C sort)
|
||||
local bash_sections=$("$PROJECT_ROOT/lib/ccs" --help 2>&1 | grep -E "^[A-Z][a-z]+:" | LC_ALL=C sort)
|
||||
|
||||
if [[ "$node_sections" == "$bash_sections" ]]; then
|
||||
log_success "Help text structure consistent"
|
||||
else
|
||||
log_fail "Help text structure differs between Node.js and bash"
|
||||
# Debug output
|
||||
echo " Node.js sections:" >&2
|
||||
echo "$node_sections" | sed 's/^/ /' >&2
|
||||
echo " Bash sections:" >&2
|
||||
echo "$bash_sections" | sed 's/^/ /' >&2
|
||||
fi
|
||||
}
|
||||
|
||||
#############################
|
||||
# Phase 6: Shell Completion
|
||||
#############################
|
||||
|
||||
test_bash_completion() {
|
||||
test_start "Phase 6.1 - Bash completion loading"
|
||||
|
||||
# Source completion script
|
||||
if source "$PROJECT_ROOT/scripts/completion/ccs.bash" 2>/dev/null; then
|
||||
# Check if completion is registered
|
||||
if complete -p ccs 2>/dev/null | grep -q "_ccs_completion"; then
|
||||
log_success "Bash completion loaded successfully"
|
||||
else
|
||||
log_fail "Bash completion NOT registered"
|
||||
fi
|
||||
else
|
||||
log_fail "Bash completion script failed to load"
|
||||
fi
|
||||
}
|
||||
|
||||
test_fish_completion() {
|
||||
test_start "Phase 6.2 - Fish completion (if available)"
|
||||
|
||||
if command -v fish &>/dev/null; then
|
||||
# Copy completion file
|
||||
mkdir -p ~/.config/fish/completions
|
||||
cp "$PROJECT_ROOT/scripts/completion/ccs.fish" ~/.config/fish/completions/
|
||||
|
||||
# Test if Fish can load it
|
||||
if fish -c "complete -C'ccs '" 2>/dev/null | grep -q "auth\|doctor"; then
|
||||
log_success "Fish completion works"
|
||||
else
|
||||
log_fail "Fish completion NOT working"
|
||||
fi
|
||||
else
|
||||
log_skip "Fish not installed"
|
||||
fi
|
||||
}
|
||||
|
||||
#############################
|
||||
# Main Test Runner
|
||||
#############################
|
||||
|
||||
main() {
|
||||
echo ""
|
||||
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
||||
echo " CLI UX Integration Test Suite"
|
||||
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
||||
echo ""
|
||||
|
||||
check_prerequisites
|
||||
setup_test_env
|
||||
|
||||
# Phase 1 Tests
|
||||
test_error_codes
|
||||
test_fuzzy_matching
|
||||
test_examples_section
|
||||
|
||||
# Phase 2 Tests
|
||||
test_doctor_progress
|
||||
test_tty_detection
|
||||
|
||||
# Phase 3 Tests
|
||||
test_confirmation_prompt
|
||||
test_yes_flag
|
||||
test_impact_display
|
||||
|
||||
# Phase 4 Tests
|
||||
test_json_output
|
||||
test_json_version
|
||||
test_session_count
|
||||
|
||||
# Phase 5 Tests
|
||||
test_ascii_error_boxes
|
||||
test_help_consistency
|
||||
|
||||
# Phase 6 Tests
|
||||
test_bash_completion
|
||||
test_fish_completion
|
||||
|
||||
# Finalize last test
|
||||
test_end
|
||||
|
||||
cleanup_test_env
|
||||
|
||||
# Print summary
|
||||
echo ""
|
||||
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
||||
echo " Test Summary"
|
||||
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
||||
echo ""
|
||||
echo "Total Tests: $TOTAL_TESTS"
|
||||
echo -e "${GREEN}Passed: $PASSED_TESTS${RESET}"
|
||||
echo -e "${RED}Failed: $FAILED_TESTS${RESET}"
|
||||
echo -e "${YELLOW}Skipped: $SKIPPED_TESTS${RESET}"
|
||||
echo ""
|
||||
|
||||
# Calculate pass rate based on non-skipped tests
|
||||
local tests_run=$((TOTAL_TESTS - SKIPPED_TESTS))
|
||||
local pass_rate=0
|
||||
if [[ $tests_run -gt 0 ]]; then
|
||||
pass_rate=$((PASSED_TESTS * 100 / tests_run))
|
||||
fi
|
||||
echo "Pass Rate: $pass_rate% ($PASSED_TESTS/$tests_run non-skipped tests)"
|
||||
echo ""
|
||||
|
||||
if [[ $pass_rate -ge 90 ]]; then
|
||||
echo -e "${GREEN}✓ SUCCESS: Pass rate >= 90%${RESET}"
|
||||
exit 0
|
||||
else
|
||||
echo -e "${RED}✗ FAILURE: Pass rate < 90%${RESET}"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
# Run tests
|
||||
main "$@"
|
||||
Reference in new issue
Block a user