ralphctl 0.1.0 → 0.1.2

package/src/commands/config/config.ts

@@ -1,58 +0,0 @@
-import { AiProviderSchema } from '@src/schemas/index.ts';
-import { getAiProvider, getEditor, setAiProvider, setEditor } from '@src/store/config.ts';
-import { field, icons, log, printHeader, showError, showSuccess } from '@src/theme/ui.ts';
-
-export async function configSetCommand(args: string[]): Promise<void> {
-  if (args.length < 2) {
-    showError('Usage: ralphctl config set <key> <value>');
-    log.dim('Available keys: provider, editor');
-    log.newline();
-    return;
-  }
-
-  const [key, value] = args;
-
-  if (key === 'provider') {
-    const parsed = AiProviderSchema.safeParse(value);
-    if (!parsed.success) {
-      showError(`Invalid provider: ${value ?? '(empty)'}`);
-      log.dim('Valid providers: claude, copilot');
-      log.newline();
-      return;
-    }
-
-    await setAiProvider(parsed.data);
-    showSuccess(`AI provider set to: ${parsed.data}`);
-    log.newline();
-    return;
-  }
-
-  if (key === 'editor') {
-    const trimmed = value?.trim();
-    if (!trimmed) {
-      showError('Editor command cannot be empty');
-      log.dim('Examples: "subl -w", "code --wait", "vim", "nano"');
-      log.newline();
-      return;
-    }
-
-    await setEditor(trimmed);
-    showSuccess(`Editor set to: ${trimmed}`);
-    log.newline();
-    return;
-  }
-
-  showError(`Unknown config key: ${key ?? '(empty)'}`);
-  log.dim('Available keys: provider, editor');
-  log.newline();
-}
-
-export async function configShowCommand(): Promise<void> {
-  const provider = await getAiProvider();
-  const editorCmd = await getEditor();
-
-  printHeader('Configuration', icons.info);
-  console.log(field('AI Provider', provider ?? '(not set — will prompt on first use)'));
-  console.log(field('Editor', editorCmd ?? '(not set — will prompt on first use)'));
-  log.newline();
-}

package/src/commands/config/index.ts

@@ -1,33 +0,0 @@
-import type { Command } from 'commander';
-import { configSetCommand, configShowCommand } from '@src/commands/config/config.ts';
-
-export function registerConfigCommands(program: Command): void {
-  const config = program.command('config').description('Manage configuration');
-
-  config.addHelpText(
-    'after',
-    `
-Examples:
-  $ ralphctl config show                    # Show current configuration
-  $ ralphctl config set provider claude     # Use Claude Code
-  $ ralphctl config set provider copilot    # Use GitHub Copilot
-  $ ralphctl config set editor "subl -w"    # Use Sublime Text for multiline input
-  $ ralphctl config set editor "code --wait"  # Use VS Code for multiline input
-  $ ralphctl config set editor vim          # Use Vim for multiline input
-`
-  );
-
-  config
-    .command('show')
-    .description('Show current configuration')
-    .action(async () => {
-      await configShowCommand();
-    });
-
-  config
-    .command('set <key> <value>')
-    .description('Set a configuration value')
-    .action(async (key: string, value: string) => {
-      await configSetCommand([key, value]);
-    });
-}

package/src/commands/dashboard/dashboard.ts

@@ -1,5 +0,0 @@
-import { showDashboard } from '@src/interactive/dashboard.ts';
-
-export async function dashboardCommand(): Promise<void> {
-  await showDashboard();
-}

package/src/commands/dashboard/index.ts

@@ -1,6 +0,0 @@
-import type { Command } from 'commander';
-import { dashboardCommand } from '@src/commands/dashboard/dashboard.ts';
-
-export function registerDashboardCommands(program: Command): void {
-  program.command('status').description('Show current sprint overview').action(dashboardCommand);
-}

package/src/commands/doctor/doctor.ts

@@ -1,271 +0,0 @@
-import { access, constants } from 'node:fs/promises';
-import { join } from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { getConfig } from '@src/store/config.ts';
-import { listProjects } from '@src/store/project.ts';
-import { SprintSchema } from '@src/schemas/index.ts';
-import { getDataDir, getSprintFilePath } from '@src/utils/paths.ts';
-import { validateProjectPath } from '@src/utils/paths.ts';
-import { fileExists, readValidatedJson } from '@src/utils/storage.ts';
-import { colors, getQuoteForContext } from '@src/theme/index.ts';
-import { icons, log, printHeader } from '@src/theme/ui.ts';
-import { EXIT_ERROR } from '@src/utils/exit-codes.ts';
-import { isGlabAvailable } from '@src/utils/git.ts';
-
-const REQUIRED_NODE_MAJOR = 24;
-
-export interface CheckResult {
-  name: string;
-  status: 'pass' | 'warn' | 'fail' | 'skip';
-  detail?: string;
-}
-
-/**
- * Check Node.js version >= 24.0.0
- */
-export function checkNodeVersion(): CheckResult {
-  const version = process.version; // e.g., "v24.1.0"
-  const match = /^v(\d+)/.exec(version);
-  const major = match ? Number(match[1]) : 0;
-
-  if (major >= REQUIRED_NODE_MAJOR) {
-    return { name: 'Node.js version', status: 'pass', detail: version };
-  }
-  return {
-    name: 'Node.js version',
-    status: 'fail',
-    detail: `${version} (requires >= ${String(REQUIRED_NODE_MAJOR)}.0.0)`,
-  };
-}
-
-/**
- * Check git is installed
- */
-export function checkGitInstalled(): CheckResult {
-  const result = spawnSync('git', ['--version'], {
-    encoding: 'utf-8',
-    stdio: ['ignore', 'pipe', 'pipe'],
-  });
-
-  if (result.status === 0) {
-    const version = result.stdout.trim();
-    return { name: 'Git installed', status: 'pass', detail: version };
-  }
-  return { name: 'Git installed', status: 'fail', detail: 'git not found in PATH' };
-}
-
-/**
- * Check git identity (user.name and user.email)
- */
-export function checkGitIdentity(): CheckResult {
-  const nameResult = spawnSync('git', ['config', 'user.name'], {
-    encoding: 'utf-8',
-    stdio: ['ignore', 'pipe', 'pipe'],
-  });
-  const emailResult = spawnSync('git', ['config', 'user.email'], {
-    encoding: 'utf-8',
-    stdio: ['ignore', 'pipe', 'pipe'],
-  });
-
-  const name = nameResult.status === 0 ? nameResult.stdout.trim() : '';
-  const email = emailResult.status === 0 ? emailResult.stdout.trim() : '';
-
-  if (name && email) {
-    return { name: 'Git identity', status: 'pass', detail: `${name} <${email}>` };
-  }
-
-  const missing: string[] = [];
-  if (!name) missing.push('user.name');
-  if (!email) missing.push('user.email');
-  return { name: 'Git identity', status: 'warn', detail: `missing: ${missing.join(', ')}` };
-}
-
-/**
- * Check AI provider binary is on PATH
- */
-export async function checkAiProvider(): Promise<CheckResult> {
-  const config = await getConfig();
-  const provider = config.aiProvider;
-
-  if (!provider) {
-    return { name: 'AI provider binary', status: 'skip', detail: 'not configured' };
-  }
-
-  const binary = provider === 'claude' ? 'claude' : 'copilot';
-  const result = spawnSync('which', [binary], {
-    encoding: 'utf-8',
-    stdio: ['ignore', 'pipe', 'pipe'],
-  });
-
-  if (result.status === 0) {
-    return { name: 'AI provider binary', status: 'pass', detail: `${binary} found` };
-  }
-  return {
-    name: 'AI provider binary',
-    status: 'fail',
-    detail: `${binary} not found in PATH (provider: ${provider})`,
-  };
-}
-
-/**
- * Check glab CLI availability (informational — for GitLab issue enrichment)
- */
-export function checkGlabInstalled(): CheckResult {
-  if (isGlabAvailable()) {
-    return { name: 'GitLab CLI (glab)', status: 'pass', detail: 'installed' };
-  }
-  return {
-    name: 'GitLab CLI (glab)',
-    status: 'skip',
-    detail: 'not installed (optional — needed for GitLab issue enrichment)',
-  };
-}
-
-/**
- * Check data directory exists and is writable
- */
-export async function checkDataDirectory(): Promise<CheckResult> {
-  const dataDir = getDataDir();
-
-  try {
-    await access(dataDir, constants.R_OK | constants.W_OK);
-    return { name: 'Data directory', status: 'pass', detail: dataDir };
-  } catch {
-    return { name: 'Data directory', status: 'fail', detail: `${dataDir} not accessible or writable` };
-  }
-}
-
-/**
- * Check project paths exist and are git repos
- */
-export async function checkProjectPaths(): Promise<CheckResult> {
-  const projects = await listProjects();
-
-  if (projects.length === 0) {
-    return { name: 'Project paths', status: 'skip', detail: 'no projects registered' };
-  }
-
-  const issues: string[] = [];
-
-  for (const project of projects) {
-    for (const repo of project.repositories) {
-      const validation = await validateProjectPath(repo.path);
-      if (validation !== true) {
-        issues.push(`${project.name}/${repo.name}: ${validation}`);
-        continue;
-      }
-
-      const gitDir = join(repo.path, '.git');
-      if (!(await fileExists(gitDir))) {
-        issues.push(`${project.name}/${repo.name}: not a git repository`);
-      }
-    }
-  }
-
-  if (issues.length === 0) {
-    const repoCount = projects.reduce((sum, p) => sum + p.repositories.length, 0);
-    return {
-      name: 'Project paths',
-      status: 'pass',
-      detail: `${String(repoCount)} repo${repoCount !== 1 ? 's' : ''} verified`,
-    };
-  }
-
-  return { name: 'Project paths', status: 'fail', detail: issues.join('; ') };
-}
-
-/**
- * Check current sprint validity
- */
-export async function checkCurrentSprint(): Promise<CheckResult> {
-  const config = await getConfig();
-  const sprintId = config.currentSprint;
-
-  if (!sprintId) {
-    return { name: 'Current sprint', status: 'skip', detail: 'no current sprint set' };
-  }
-
-  const sprintPath = getSprintFilePath(sprintId);
-  if (!(await fileExists(sprintPath))) {
-    return { name: 'Current sprint', status: 'fail', detail: `sprint file missing: ${sprintId}` };
-  }
-
-  try {
-    const sprint = await readValidatedJson(sprintPath, SprintSchema);
-    return { name: 'Current sprint', status: 'pass', detail: `${sprint.name} (${sprint.status})` };
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return { name: 'Current sprint', status: 'fail', detail: `invalid sprint data: ${message}` };
-  }
-}
-
-/**
- * Run all doctor checks and print results.
- */
-export async function doctorCommand(): Promise<void> {
-  printHeader('System Health Check', icons.info);
-
-  const results: CheckResult[] = [];
-
-  // Synchronous checks
-  results.push(checkNodeVersion());
-  results.push(checkGitInstalled());
-  results.push(checkGitIdentity());
-  results.push(checkGlabInstalled());
-
-  // Async checks (independent — run in parallel)
-  const asyncResults = await Promise.all([
-    checkAiProvider(),
-    checkDataDirectory(),
-    checkProjectPaths(),
-    checkCurrentSprint(),
-  ]);
-  results.push(...asyncResults);
-
-  // Print results
-  for (const result of results) {
-    if (result.status === 'pass') {
-      log.success(`${result.name}${result.detail ? colors.muted(` — ${result.detail}`) : ''}`);
-    } else if (result.status === 'warn') {
-      log.warn(`${result.name}${result.detail ? colors.muted(` — ${result.detail}`) : ''}`);
-    } else if (result.status === 'fail') {
-      log.error(result.name);
-      if (result.detail) {
-        log.dim(`    ${result.detail}`);
-      }
-    } else {
-      log.raw(
-        `${icons.bullet}  ${colors.muted(result.name)} ${colors.muted('—')} ${colors.muted(result.detail ?? 'skipped')}`
-      );
-    }
-  }
-
-  // Summary
-  log.newline();
-  const passed = results.filter((r) => r.status === 'pass').length;
-  const warned = results.filter((r) => r.status === 'warn').length;
-  const failed = results.filter((r) => r.status === 'fail').length;
-  const total = results.filter((r) => r.status !== 'skip').length;
-
-  if (failed === 0 && warned === 0) {
-    log.success(`All checks passed (${String(passed)}/${String(total)})`);
-    log.newline();
-    const quote = getQuoteForContext('success');
-    log.dim(`"${quote}"`);
-  } else if (failed === 0) {
-    log.success(
-      `${String(passed)}/${String(total)} checks passed, ${String(warned)} warning${warned !== 1 ? 's' : ''}`
-    );
-    log.newline();
-    const quote = getQuoteForContext('success');
-    log.dim(`"${quote}"`);
-  } else {
-    log.error(`${String(passed)}/${String(total)} checks passed, ${String(failed)} failed`);
-    log.newline();
-    const quote = getQuoteForContext('error');
-    log.dim(`"${quote}"`);
-    process.exitCode = EXIT_ERROR;
-  }
-
-  log.newline();
-}

package/src/commands/doctor/index.ts

@@ -1,25 +0,0 @@
-import type { Command } from 'commander';
-import { doctorCommand } from '@src/commands/doctor/doctor.ts';
-
-export function registerDoctorCommands(program: Command): void {
-  program
-    .command('doctor')
-    .description('Check environment health and diagnose setup issues')
-    .addHelpText(
-      'after',
-      `
-Examples:
-  $ ralphctl doctor                         # Run all health checks
-
-Checks performed:
-  - Node.js version (>= 24)
-  - Git installation and identity
-  - AI provider binary (claude or copilot)
-  - Data directory accessibility
-  - Project repository paths
-  - Current sprint validity`
-    )
-    .action(async () => {
-      await doctorCommand();
-    });
-}

package/src/commands/progress/index.ts

@@ -1,25 +0,0 @@
-import type { Command } from 'commander';
-import { progressLogCommand } from '@src/commands/progress/log.ts';
-import { progressShowCommand } from '@src/commands/progress/show.ts';
-
-export function registerProgressCommands(program: Command): void {
-  const progress = program.command('progress').description('Log and view progress');
-
-  progress.addHelpText(
-    'after',
-    `
-Examples:
-  $ ralphctl progress log "Completed auth flow"
-  $ ralphctl progress show
-`
-  );
-
-  progress
-    .command('log [message]')
-    .description('Append to progress log (opens editor if no message)')
-    .action(async (message?: string) => {
-      await progressLogCommand(message ? [message] : []);
-    });
-
-  progress.command('show').description('Display progress log').action(progressShowCommand);
-}

package/src/commands/progress/log.ts

@@ -1,64 +0,0 @@
-import { log, showError, showNextStep, showSuccess } from '@src/theme/ui.ts';
-import { logProgress } from '@src/store/progress.ts';
-import {
-  assertSprintStatus,
-  getSprint,
-  NoCurrentSprintError,
-  resolveSprintId,
-  SprintStatusError,
-} from '@src/store/sprint.ts';
-import { editorInput } from '@src/utils/editor-input.ts';
-
-export async function progressLogCommand(args: string[]): Promise<void> {
-  // FAIL FAST: Check sprint status before collecting any input
-  try {
-    const sprintId = await resolveSprintId();
-    const sprint = await getSprint(sprintId);
-    assertSprintStatus(sprint, ['active'], 'log progress');
-  } catch (err) {
-    if (err instanceof SprintStatusError) {
-      const mainError = err.message.split('\n')[0] ?? err.message;
-      showError(mainError);
-      showNextStep('ralphctl sprint start', 'activate the sprint');
-      log.newline();
-      return;
-    }
-    if (err instanceof NoCurrentSprintError) {
-      showError('No current sprint set.');
-      showNextStep('ralphctl sprint create', 'create a new sprint');
-      log.newline();
-      return;
-    }
-    throw err;
-  }
-
-  // Validation passed - now collect input
-  let message = args.join(' ').trim();
-
-  if (!message) {
-    message = await editorInput({
-      message: 'Progress message:',
-    });
-    message = message.trim();
-  }
-
-  if (!message) {
-    showError('No message provided.');
-    log.newline();
-    return;
-  }
-
-  try {
-    await logProgress(message);
-    showSuccess('Progress logged.');
-    log.newline();
-  } catch (err) {
-    if (err instanceof SprintStatusError) {
-      // Fallback handler (shouldn't reach here due to early check)
-      showError(err.message);
-      log.newline();
-    } else {
-      throw err;
-    }
-  }
-}

package/src/commands/progress/show.ts

@@ -1,14 +0,0 @@
-import { getProgress } from '@src/store/progress.ts';
-import { printHeader, showEmpty } from '@src/theme/ui.ts';
-
-export async function progressShowCommand(): Promise<void> {
-  const content = await getProgress();
-
-  if (!content.trim()) {
-    showEmpty('progress entries', 'Log with: ralphctl progress log');
-    return;
-  }
-
-  printHeader('Progress Log');
-  console.log(content);
-}