kodu 1.2.0 → 2.0.0

package/src/commands/ops/subcommands/ops-routes.command.ts

@@ -1,221 +0,0 @@
-import path from 'node:path';
-import { CommandRunner, Option, SubCommand } from 'nest-commander';
-import { ConfigService } from '../../../core/config/config.service';
-import { SshService } from '../../../shared/ssh/ssh.service';
-import { OpsCliError } from '../ops.types';
-import {
-  ensureAction,
-  ensureRequired,
-  printCliError,
-  printJson,
-  printSshError,
-  resolveCaddyPath,
-  resolveServerOrThrow,
-  shellQuote,
-} from '../ops.utils';
-
-type OpsRoutesAction = 'list' | 'add' | 'remove' | 'update';
-
-type OpsRoutesOptions = {
-  server?: string;
-  action?: string;
-  domain?: string;
-  upstream?: string;
-};
-
-@SubCommand({
-  name: 'routes',
-  description:
-    'Manage remote Caddy reverse proxy routes.\nExamples:\n  kodu ops routes --server dev --action list\n  kodu ops routes --server dev --action add --domain api.example.com --upstream 127.0.0.1:3000\n  kodu ops routes --server dev --action update --domain api.example.com --upstream 127.0.0.1:4000\n  kodu ops routes --server dev --action remove --domain api.example.com',
-})
-export class OpsRoutesCommand extends CommandRunner {
-  constructor(
-    private readonly configService: ConfigService,
-    private readonly sshService: SshService,
-  ) {
-    super();
-  }
-
-  @Option({
-    flags: '-s, --server <name>',
-    description: 'Server alias defined in kodu.json (e.g., dev)',
-  })
-  parseServer(value: string): string {
-    return value;
-  }
-
-  @Option({
-    flags: '-a, --action <type>',
-    description: 'Action to perform: list | add | remove | update',
-  })
-  parseAction(value: string): string {
-    return value;
-  }
-
-  @Option({
-    flags: '--domain <domain>',
-    description: 'Domain name (required for add, update, remove)',
-  })
-  parseDomain(value: string): string {
-    return value;
-  }
-
-  @Option({
-    flags: '--upstream <upstream>',
-    description: 'Upstream host:port (required for add, update)',
-  })
-  parseUpstream(value: string): string {
-    return value;
-  }
-
-  async run(
-    passedParams: string[],
-    options: OpsRoutesOptions = {},
-  ): Promise<void> {
-    try {
-      if (passedParams.length > 0) {
-        throw new OpsCliError(
-          'VALIDATION_ERROR',
-          'Positional arguments are not supported. Use named flags (e.g., --server, --action). Run with --help for examples.',
-        );
-      }
-
-      const serverAlias = ensureRequired(options.server, 'server');
-      const rawAction = ensureRequired(options.action, 'action');
-      const action = ensureAction<OpsRoutesAction>(
-        rawAction,
-        ['list', 'add', 'remove', 'update'],
-        'routes action',
-      );
-      const server = await resolveServerOrThrow(
-        this.configService.getConfig(),
-        serverAlias,
-      );
-
-      const caddyRoot = resolveCaddyPath(server);
-      const caddyfilePath = path.posix.join(caddyRoot, 'data', 'Caddyfile');
-
-      if (action === 'list') {
-        const command = `cat ${shellQuote(caddyfilePath)}`;
-        const result = await this.sshService.execute(server, command);
-        if (!result.success) {
-          printSshError(result, command);
-          return;
-        }
-
-        printJson({ status: 'ok', data: { caddyfile: result.stdout } });
-        return;
-      }
-
-      const domain = ensureRequired(options.domain, 'domain');
-      const upstream =
-        action === 'add' || action === 'update'
-          ? ensureRequired(options.upstream, 'upstream')
-          : '';
-
-      const editCommand = this.buildEditCommand({
-        action,
-        caddyfilePath,
-        domain,
-        upstream,
-      });
-      const editResult = await this.sshService.execute(server, editCommand);
-
-      if (!editResult.success) {
-        if (editResult.exitCode === 4) {
-          printJson({
-            status: 'error',
-            code: 'NOT_FOUND',
-            stderr: editResult.stderr || editResult.stdout || 'Route not found',
-            command: editCommand,
-          });
-          return;
-        }
-
-        printSshError(editResult, editCommand);
-        return;
-      }
-
-      const applyCommand = `cd ${shellQuote(caddyRoot)} && ./caddy.sh`;
-      const applyResult = await this.sshService.execute(server, applyCommand);
-      if (!applyResult.success) {
-        printSshError(applyResult, applyCommand);
-        return;
-      }
-
-      printJson({
-        status: 'ok',
-        message: 'Routes updated',
-        data: {
-          action,
-          domain,
-          upstream: upstream || undefined,
-          caddyOutput: applyResult.stdout,
-        },
-      });
-    } catch (error) {
-      printCliError(error);
-      process.exitCode = 1;
-    }
-  }
-
-  private buildEditCommand(params: {
-    action: Exclude<OpsRoutesAction, 'list'>;
-    caddyfilePath: string;
-    domain: string;
-    upstream: string;
-  }): string {
-    const script = this.buildPythonScript(params);
-    return `python3 -c ${shellQuote(script)}`;
-  }
-
-  private buildPythonScript(params: {
-    action: Exclude<OpsRoutesAction, 'list'>;
-    caddyfilePath: string;
-    domain: string;
-    upstream: string;
-  }): string {
-    return [
-      'import json',
-      'import os',
-      'import random',
-      'import re',
-      'import sys',
-      'import time',
-      'from pathlib import Path',
-      `file_path = ${JSON.stringify(params.caddyfilePath)}`,
-      `action = ${JSON.stringify(params.action)}`,
-      `domain = ${JSON.stringify(params.domain)}`,
-      `upstream = ${JSON.stringify(params.upstream)}`,
-      'with Path(file_path).open("r", encoding="utf-8") as handle:',
-      '  text = handle.read()',
-      'domain_re = re.compile(r"(^|\\n)\\s*" + re.escape(domain) + r"\\s*\\{[\\s\\S]*?\\n\\}", re.MULTILINE)',
-      'if action == "add":',
-      '  if domain_re.search(text):',
-      '    sys.stderr.write("Route already exists for domain")',
-      '    sys.exit(3)',
-      '  block = "\\n" + domain + " {\\n  reverse_proxy " + upstream + "\\n}\\n"',
-      '  text = re.sub(r"\\s*$", "", text) + block',
-      'elif action == "remove":',
-      '  if not domain_re.search(text):',
-      '    sys.stderr.write("Route not found")',
-      '    sys.exit(4)',
-      '  text = domain_re.sub("\\n", text, count=1)',
-      '  text = re.sub(r"\\n{3,}", "\\n\\n", text)',
-      '  text = re.sub(r"^\\n+", "", text)',
-      'elif action == "update":',
-      '  match = domain_re.search(text)',
-      '  if not match:',
-      '    sys.stderr.write("Route not found")',
-      '    sys.exit(4)',
-      '  block = match.group(0)',
-      '  updated = re.sub(r"reverse_proxy\\s+[^\\n]+", "reverse_proxy " + upstream, block, count=1)',
-      '  text = domain_re.sub(updated, text, count=1)',
-      'tmp = os.path.join(os.path.dirname(file_path), ".tmp-" + str(int(time.time() * 1000)) + "-" + format(random.getrandbits(48), "x"))',
-      'with open(tmp, "w", encoding="utf-8") as handle:',
-      '  handle.write(text)',
-      'os.replace(tmp, file_path)',
-      'print(json.dumps({"status": "ok"}))',
-    ].join('\n');
-  }
-}

package/src/commands/ops/subcommands/ops-service.command.ts

@@ -1,190 +0,0 @@
-import path from 'node:path';
-import { CommandRunner, Option, SubCommand } from 'nest-commander';
-import { ConfigService } from '../../../core/config/config.service';
-import { SshService } from '../../../shared/ssh/ssh.service';
-import { OpsCliError, type ResolvedServerConfig } from '../ops.types';
-import {
-  ensureAction,
-  ensureRequired,
-  printCliError,
-  printJson,
-  printSshError,
-  resolveAppsPath,
-  resolveServerOrThrow,
-  shellQuote,
-} from '../ops.utils';
-
-type OpsServiceAction = 'clone' | 'pull' | 'up' | 'down' | 'logs' | 'status';
-
-type OpsServiceOptions = {
-  server?: string;
-  action?: string;
-  project?: string;
-  repo?: string;
-};
-
-@SubCommand({
-  name: 'service',
-  description:
-    'Manage project lifecycle using Docker Compose.\nExamples:\n  kodu ops service --server dev --action clone --project temp --repo https://github.com/org/repo.git\n  kodu ops service --server dev --action up --project temp\n  kodu ops service --server dev --action status --project temp\n  kodu ops service --server dev --action logs --project temp\n  kodu ops service --server dev --action pull --project temp\n  kodu ops service --server dev --action down --project temp',
-})
-export class OpsServiceCommand extends CommandRunner {
-  constructor(
-    private readonly configService: ConfigService,
-    private readonly sshService: SshService,
-  ) {
-    super();
-  }
-
-  @Option({
-    flags: '-s, --server <name>',
-    description: 'Server alias defined in kodu.json (e.g., dev)',
-  })
-  parseServer(value: string): string {
-    return value;
-  }
-
-  @Option({
-    flags: '-a, --action <type>',
-    description: 'Action to perform: clone | pull | up | down | logs | status',
-  })
-  parseAction(value: string): string {
-    return value;
-  }
-
-  @Option({
-    flags: '-p, --project <name>',
-    description: 'Target project directory name',
-  })
-  parseProject(value: string): string {
-    return value;
-  }
-
-  @Option({ flags: '--repo <url>', description: 'Repository URL for clone' })
-  parseRepo(value: string): string {
-    return value;
-  }
-
-  async run(
-    passedParams: string[],
-    options: OpsServiceOptions = {},
-  ): Promise<void> {
-    try {
-      if (passedParams.length > 0) {
-        throw new OpsCliError(
-          'VALIDATION_ERROR',
-          'Positional arguments are not supported. Use named flags (e.g., --server, --action). Run with --help for examples.',
-        );
-      }
-
-      const serverAlias = ensureRequired(options.server, 'server');
-      const rawAction = ensureRequired(options.action, 'action');
-      const project = ensureRequired(options.project, 'project');
-
-      const action = ensureAction<OpsServiceAction>(
-        rawAction,
-        ['clone', 'pull', 'up', 'down', 'logs', 'status'],
-        'service action',
-      );
-      const server = await resolveServerOrThrow(
-        this.configService.getConfig(),
-        serverAlias,
-      );
-      const projectPath = path.posix.join(resolveAppsPath(server), project);
-
-      if (action === 'status') {
-        await this.runStatus(server, projectPath);
-        return;
-      }
-
-      const command = this.buildActionCommand(action, projectPath, options);
-      const result = await this.sshService.execute(server, command);
-      if (!result.success) {
-        printSshError(result, command);
-        return;
-      }
-
-      printJson({
-        status: 'ok',
-        data: {
-          action,
-          project,
-          stdout: result.stdout,
-        },
-      });
-    } catch (error) {
-      printCliError(error);
-      process.exitCode = 1;
-    }
-  }
-
-  private buildActionCommand(
-    action: Exclude<OpsServiceAction, 'status'>,
-    projectPath: string,
-    options: OpsServiceOptions,
-  ): string {
-    const quotedProjectPath = shellQuote(projectPath);
-
-    if (action === 'clone') {
-      const repo = ensureRequired(options.repo, 'repo');
-      const quotedRepo = shellQuote(repo);
-      return [
-        `if [ -d ${quotedProjectPath} ]; then echo 'Project already exists' >&2; exit 3; fi`,
-        `git clone ${quotedRepo} ${quotedProjectPath}`,
-      ].join(' && ');
-    }
-
-    if (action === 'pull') {
-      return `cd ${quotedProjectPath} && git pull`;
-    }
-
-    if (action === 'up') {
-      return `cd ${quotedProjectPath} && docker compose up -d`;
-    }
-
-    if (action === 'down') {
-      return `cd ${quotedProjectPath} && docker compose down`;
-    }
-
-    return `cd ${quotedProjectPath} && docker compose logs --no-color --tail=200`;
-  }
-
-  private async runStatus(
-    server: ResolvedServerConfig,
-    projectPath: string,
-  ): Promise<void> {
-    const quotedProjectPath = shellQuote(projectPath);
-    const jsonCommand = `cd ${quotedProjectPath} && docker compose ps --format json`;
-    const jsonResult = await this.sshService.execute(server, jsonCommand);
-
-    if (jsonResult.success) {
-      printJson({
-        status: 'ok',
-        data: {
-          action: 'status',
-          stdout: jsonResult.stdout,
-        },
-      });
-      return;
-    }
-
-    const fallbackCommand = `cd ${quotedProjectPath} && docker compose ps`;
-    const fallbackResult = await this.sshService.execute(
-      server,
-      fallbackCommand,
-    );
-
-    if (!fallbackResult.success) {
-      printSshError(fallbackResult, fallbackCommand);
-      return;
-    }
-
-    printJson({
-      status: 'ok',
-      data: {
-        action: 'status',
-        raw: fallbackResult.stdout,
-      },
-    });
-  }
-}

package/src/commands/ops/subcommands/ops-sysinfo.command.ts

@@ -1,77 +0,0 @@
-import { CommandRunner, Option, SubCommand } from 'nest-commander';
-import { ConfigService } from '../../../core/config/config.service';
-import { SshService } from '../../../shared/ssh/ssh.service';
-import { OpsCliError } from '../ops.types';
-import {
-  ensureRequired,
-  printCliError,
-  printJson,
-  printSshError,
-  resolveServerOrThrow,
-} from '../ops.utils';
-
-type OpsSysinfoOptions = {
-  server?: string;
-};
-
-@SubCommand({
-  name: 'sysinfo',
-  description:
-    'Collect remote server diagnostics.\nExample: kodu ops sysinfo --server dev',
-})
-export class OpsSysinfoCommand extends CommandRunner {
-  constructor(
-    private readonly configService: ConfigService,
-    private readonly sshService: SshService,
-  ) {
-    super();
-  }
-
-  @Option({
-    flags: '-s, --server <name>',
-    description: 'Server alias defined in kodu.json (e.g., dev)',
-  })
-  parseServer(value: string): string {
-    return value;
-  }
-
-  async run(
-    passedParams: string[],
-    options: OpsSysinfoOptions = {},
-  ): Promise<void> {
-    try {
-      if (passedParams.length > 0) {
-        throw new OpsCliError(
-          'VALIDATION_ERROR',
-          'Positional arguments are not supported. Use named flags (e.g., --server, --action). Run with --help for examples.',
-        );
-      }
-
-      const serverAlias = ensureRequired(options.server, 'server');
-
-      const server = await resolveServerOrThrow(
-        this.configService.getConfig(),
-        serverAlias,
-      );
-      const payload = `echo "{"uptime": "$(uptime -p)", "disk_usage": "$(df -h / | tail -1 | awk '{print $5}')", "mem_free": "$(free -m | grep Mem | awk '{print $4}')MB"}`;
-
-      const result = await this.sshService.execute(server, payload);
-      if (!result.success) {
-        printSshError(result, payload);
-        return;
-      }
-
-      let data: Record<string, string> = {};
-      try {
-        data = JSON.parse(result.stdout) as Record<string, string>;
-      } catch {
-        data = { raw: result.stdout.trim() };
-      }
-
-      printJson({ status: 'ok', data });
-    } catch (error) {
-      printCliError(error);
-      process.exitCode = 1;
-    }
-  }
-}

package/src/commands/review/review.command.ts

@@ -1,199 +0,0 @@
-import { writeFile } from 'node:fs/promises';
-import clipboard from 'clipboardy';
-import { Command, CommandRunner, Option } from 'nest-commander';
-import { UiService } from '../../core/ui/ui.service';
-import { AiService, type ReviewMode } from '../../shared/ai/ai.service';
-import { WARNING_TOKEN_THRESHOLD } from '../../shared/constants';
-import { GitService } from '../../shared/git/git.service';
-import { TokenizerService } from '../../shared/tokenizer/tokenizer.service';
-
-type ReviewOptions = {
-  mode?: ReviewMode;
-  copy?: boolean;
-  ci?: boolean;
-  output?: string;
-};
-
-const DEFAULT_MODE: ReviewMode = 'bug';
-
-@Command({
-  name: 'review',
-  description: 'AI review for staged changes',
-})
-export class ReviewCommand extends CommandRunner {
-  constructor(
-    private readonly ui: UiService,
-    private readonly git: GitService,
-    private readonly tokenizer: TokenizerService,
-    private readonly ai: AiService,
-  ) {
-    super();
-  }
-
-  @Option({
-    flags: '-m, --mode <mode>',
-    description: 'Review mode: bug | style | security | <custom-mode>',
-  })
-  parseMode(value: string): ReviewMode {
-    const availableModes = this.ai.getAvailableReviewModes();
-
-    if (availableModes.includes(value)) {
-      return value;
-    }
-
-    this.ui.log.warn(
-      `Mode "${value}" not found. Available modes: ${availableModes.join(', ')}. Using default mode: ${DEFAULT_MODE}`,
-    );
-    return DEFAULT_MODE;
-  }
-
-  @Option({ flags: '-c, --copy', description: 'Copy result to clipboard' })
-  parseCopy(): boolean {
-    return true;
-  }
-
-  @Option({
-    flags: '--ci',
-    description: 'CI mode: no spinner and no buffering',
-  })
-  parseCi(): boolean {
-    return true;
-  }
-
-  @Option({
-    flags: '-o, --output <path>',
-    description: 'Save final review to file',
-  })
-  parseOutput(value: string): string {
-    return value;
-  }
-
-  async run(_inputs: string[], options: ReviewOptions = {}): Promise<void> {
-    const ciMode = Boolean(options.ci);
-    const spinner = ciMode
-      ? undefined
-      : this.ui.createSpinner({ text: 'Collecting diff from git...' }).start();
-
-    const logProgress = (text: string): void => {
-      if (ciMode) {
-        return;
-      }
-      if (spinner) {
-        spinner.text = text;
-        return;
-      }
-      this.ui.log.info(text);
-    };
-
-    const finishProgress = (text: string): void => {
-      if (ciMode) {
-        return;
-      }
-      if (spinner) {
-        spinner.success(text);
-        return;
-      }
-      this.ui.log.success(text);
-    };
-
-    try {
-      if (!this.ai.hasApiKey()) {
-        const envName = this.ai.getApiKeyEnvName();
-        if (spinner) {
-          spinner.stop('AI key not found');
-        } else {
-          this.ui.log.error('AI key not found');
-        }
-        this.ui.log.warn(`'review' command requires AI key to work.`);
-        this.ui.log.info(`Set key: export ${envName}=<your_key>`);
-        this.ui.log.info(
-          `Environment variable name is configured via llm.apiKeyEnv in kodu.json`,
-        );
-        process.exitCode = 1;
-        return;
-      }
-
-      await this.git.ensureRepo();
-
-      const hasStaged = await this.git.hasStagedChanges();
-      if (!hasStaged) {
-        if (spinner) {
-          spinner.stop('No staged changes');
-        } else {
-          this.ui.log.info('No staged changes');
-        }
-        this.ui.log.warn('First run git add for the required files.');
-        return;
-      }
-
-      const diff = await this.git.getStagedDiff();
-      if (!diff.trim()) {
-        if (spinner) {
-          spinner.stop(
-            'Diff is empty - possibly everything excluded by packer.ignore',
-          );
-        } else {
-          this.ui.log.info(
-            'Diff is empty - possibly everything excluded by packer.ignore',
-          );
-        }
-        this.ui.log.warn(
-          'Diff is empty: all changes fell into packer.ignore exclusions.',
-        );
-        return;
-      }
-
-      const tokens = this.tokenizer.count(diff);
-      if (tokens.tokens > WARNING_TOKEN_THRESHOLD) {
-        this.ui.log.warn(
-          `Large context (${tokens.tokens} tokens, ~$${tokens.usdEstimate.toFixed(2)}). Review may cost more.`,
-        );
-      }
-
-      logProgress('Requesting AI...');
-      const mode = options.mode ?? DEFAULT_MODE;
-      const result = await this.ai.reviewDiff(diff, mode);
-
-      finishProgress('Review ready');
-
-      console.log(result.text);
-      await this.writeOutput(options.output, result.text, ciMode);
-
-      if (options.copy) {
-        await this.copyText(result.text, ciMode);
-      }
-    } catch (error) {
-      if (spinner) {
-        spinner.error('Review error');
-      } else {
-        this.ui.log.error('Review error');
-      }
-      const message = error instanceof Error ? error.message : 'Unknown error';
-      this.ui.log.error(message);
-      process.exitCode = 1;
-    }
-  }
-
-  private async writeOutput(
-    target: string | undefined,
-    payload: string,
-    ciMode?: boolean,
-  ): Promise<void> {
-    if (!target) {
-      return;
-    }
-    await writeFile(target, payload, { encoding: 'utf8' });
-    if (!ciMode) {
-      this.ui.log.success(`Result saved to ${target}`);
-    }
-  }
-
-  private async copyText(text: string, ciMode: boolean): Promise<void> {
-    if (ciMode) {
-      this.ui.log.warn('--copy ignored in CI mode');
-      return;
-    }
-    await clipboard.write(text);
-    this.ui.log.success('Result copied to clipboard');
-  }
-}

package/src/commands/review/review.module.ts

@@ -1,13 +0,0 @@
-import { Module } from '@nestjs/common';
-import { ConfigModule } from '../../core/config/config.module';
-import { UiModule } from '../../core/ui/ui.module';
-import { AiModule } from '../../shared/ai/ai.module';
-import { GitModule } from '../../shared/git/git.module';
-import { TokenizerModule } from '../../shared/tokenizer/tokenizer.module';
-import { ReviewCommand } from './review.command';
-
-@Module({
-  imports: [ConfigModule, UiModule, GitModule, TokenizerModule, AiModule],
-  providers: [ReviewCommand],
-})
-export class ReviewModule {}