kodu 2.2.0 → 3.0.1

package/src/core/file-system/fs.service.ts

@@ -1,248 +0,0 @@
-import { promises as fs, type Stats } from 'node:fs';
-import path from 'node:path';
-import { Injectable } from '@nestjs/common';
-import ignore from 'ignore';
-import { glob } from 'tinyglobby';
-import {
-  BINARY_EXTENSIONS,
-  KNOWN_TEXT_EXTENSIONS,
-  MAX_FILE_SIZE_BYTES,
-} from '../../shared/constants';
-import { ConfigService } from '../config/config.service';
-import { UiService } from '../ui/ui.service';
-
-const BINARY_PROBE_SIZE = 8192;
-const GLOB_IGNORE = ['.git/**'];
-
-type FindProjectFilesOptions = {
-  ignore?: string[];
-  useGitignore?: boolean;
-  excludeBinary?: boolean;
-  contentBasedBinaryDetection?: boolean;
-  maxFileSizeBytes?: number;
-  rootPaths?: string[];
-};
-
-@Injectable()
-export class FsService {
-  constructor(
-    private readonly configService: ConfigService,
-    private readonly ui: UiService,
-  ) {}
-
-  async findProjectFiles(
-    options: FindProjectFilesOptions = {},
-  ): Promise<string[]> {
-    const { packer } = this.configService.getConfig();
-    const shouldUseGitignore = options.useGitignore ?? packer.useGitignore;
-    const gitignorePatterns = shouldUseGitignore
-      ? await this.readIgnoreFile('.gitignore')
-      : [];
-    const koduignorePatterns = await this.readIgnoreFile('.koduignore');
-
-    const baseIgnore = options.ignore ?? packer.ignore ?? [];
-    const normalizedBase = this.normalizeIgnorePatterns(baseIgnore);
-    const combinedIgnore = [
-      ...normalizedBase,
-      ...gitignorePatterns,
-      ...koduignorePatterns,
-    ].map((pattern) => pattern.replace(/\\/g, '/'));
-
-    const ig = ignore();
-    if (combinedIgnore.length > 0) {
-      ig.add(combinedIgnore);
-    }
-
-    const globIgnore = this.buildGlobIgnorePatterns(combinedIgnore);
-
-    const patterns = options.rootPaths?.length
-      ? options.rootPaths.map((p) => `${p}/**`)
-      : ['**/*'];
-
-    const entries = await glob(patterns, {
-      onlyFiles: true,
-      absolute: true,
-      dot: true,
-      ignore: [...GLOB_IGNORE, ...globIgnore],
-    });
-
-    const relativePaths = entries
-      .map((entry) => path.relative(process.cwd(), entry))
-      .map((relative) => this.toPosixPath(relative))
-      .filter((relative) => relative.length > 0);
-
-    const filtered = ig
-      .filter(relativePaths)
-      .sort((a, b) => a.localeCompare(b));
-
-    // By default exclude binary files when collecting project files (so pack will skip them).
-    // Consumers can override with options.excludeBinary = false.
-    const excludeBinary = options.excludeBinary ?? true;
-    const useContentDetection =
-      options.contentBasedBinaryDetection ??
-      packer.contentBasedBinaryDetection ??
-      false;
-    const maxFileSize = options.maxFileSizeBytes ?? MAX_FILE_SIZE_BYTES;
-
-    const textFiles: string[] = [];
-
-    for (const rel of filtered) {
-      const abs = path.resolve(process.cwd(), rel);
-      let stats: Stats;
-
-      try {
-        stats = await fs.stat(abs);
-      } catch {
-        continue;
-      }
-
-      if (stats.size > maxFileSize) {
-        this.ui.log.warn(
-          `Skipping large file: ${rel} (>${(maxFileSize / (1024 * 1024)).toFixed(0)}MB)`,
-        );
-        continue;
-      }
-
-      if (
-        excludeBinary &&
-        (await this.shouldExcludeBinary(rel, abs, useContentDetection))
-      ) {
-        continue;
-      }
-
-      textFiles.push(rel);
-    }
-
-    return textFiles;
-  }
-
-  async readFileRelative(relativePath: string): Promise<string> {
-    const absolute = path.resolve(process.cwd(), relativePath);
-    return fs.readFile(absolute, 'utf8');
-  }
-
-  private toPosixPath(relativePath: string): string {
-    return relativePath.split(path.sep).join(path.posix.sep);
-  }
-
-  private normalizeIgnorePatterns(patterns: string[]): string[] {
-    return patterns
-      .map((pattern) => pattern.trim())
-      .filter((pattern) => pattern.length > 0 && !pattern.startsWith('#'));
-  }
-
-  private buildGlobIgnorePatterns(patterns: string[]): string[] {
-    const normalized = patterns
-      .map((pattern) => pattern.trim())
-      .filter(
-        (pattern) =>
-          pattern.length > 0 &&
-          !pattern.startsWith('#') &&
-          !pattern.startsWith('!'),
-      )
-      .map((pattern) => pattern.replace(/\\/g, '/'));
-
-    const result = new Set<string>();
-
-    for (const pattern of normalized) {
-      const trimmed = pattern.replace(/\/+$/, '');
-      result.add(pattern);
-
-      if (trimmed.length === 0) {
-        continue;
-      }
-
-      if (!pattern.includes('*')) {
-        result.add(`${trimmed}/**`);
-        result.add(`**/${trimmed}/**`);
-      }
-
-      if (!pattern.startsWith('**/')) {
-        result.add(`**/${trimmed}`);
-      }
-
-      if (pattern.endsWith('/')) {
-        result.add(`${trimmed}/**`);
-      }
-    }
-
-    return [...result];
-  }
-
-  private async readIgnoreFile(fileName: string): Promise<string[]> {
-    const target = path.join(process.cwd(), fileName);
-
-    try {
-      const content = await fs.readFile(target, 'utf8');
-      return this.parseIgnoreContent(content);
-    } catch {
-      return [];
-    }
-  }
-
-  private parseIgnoreContent(content: string): string[] {
-    return content
-      .split(/\r?\n/)
-      .map((line) => line.trim())
-      .filter((line) => line.length > 0 && !line.startsWith('#'));
-  }
-
-  private isBinaryExtension(relativePath: string): boolean {
-    const ext = path.extname(relativePath).toLowerCase();
-    return ext.length > 0 && BINARY_EXTENSIONS.has(ext);
-  }
-
-  private isKnownTextFile(relativePath: string): boolean {
-    const ext = path.extname(relativePath).toLowerCase();
-    if (ext && KNOWN_TEXT_EXTENSIONS.has(ext)) {
-      return true;
-    }
-
-    const baseName = path.basename(relativePath).toLowerCase();
-    return KNOWN_TEXT_EXTENSIONS.has(baseName);
-  }
-
-  private async shouldExcludeBinary(
-    relativePath: string,
-    absolutePath: string,
-    detectByContent: boolean,
-  ): Promise<boolean> {
-    if (this.isKnownTextFile(relativePath)) {
-      return false;
-    }
-
-    if (this.isBinaryExtension(relativePath)) {
-      return true;
-    }
-
-    if (!detectByContent) {
-      return false;
-    }
-
-    return this.hasNullByte(absolutePath);
-  }
-
-  private async hasNullByte(absolutePath: string): Promise<boolean> {
-    let handle: fs.FileHandle | undefined;
-
-    try {
-      handle = await fs.open(absolutePath, 'r');
-      const buffer = Buffer.alloc(BINARY_PROBE_SIZE);
-      const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
-
-      for (let i = 0; i < bytesRead; i += 1) {
-        if (buffer[i] === 0) {
-          return true;
-        }
-      }
-
-      return false;
-    } catch {
-      return true;
-    } finally {
-      if (handle) {
-        await handle.close();
-      }
-    }
-  }
-}

package/src/core/registry/registry.module.ts

@@ -1,9 +0,0 @@
-import { Global, Module } from '@nestjs/common';
-import { RegistryService } from './registry.service';
-
-@Global()
-@Module({
-  providers: [RegistryService],
-  exports: [RegistryService],
-})
-export class RegistryModule {}

package/src/core/registry/registry.schema.ts

@@ -1,46 +0,0 @@
-import { z } from 'zod';
-
-/**
- * Стандартный набор стендов. Можно использовать и любые другие имена —
- * стенды хранятся как обычные строки, это лишь значение по умолчанию.
- */
-export const DEFAULT_STANDS = ['local', 'dev', 'stage', 'prod'] as const;
-
-/** Один проект в глобальном реестре `~/.config/kodu/registry.json`. */
-export const projectEntrySchema = z.object({
-  /** Абсолютный путь к репозиторию проекта на этой машине. */
-  path: z.string().min(1),
-  /** URL репозитория (git clone), необязательно. */
-  repo: z.string().optional(),
-  /** Доступные стенды проекта. */
-  stands: z.array(z.string()).default([...DEFAULT_STANDS]),
-});
-
-export type ProjectEntry = z.infer<typeof projectEntrySchema>;
-
-/**
- * Глобальный реестр всех проектов. Ключ объекта `projects` — уникальное имя
- * проекта, по которому агент/CLI понимает, с каким репозиторием работать.
- */
-export const registrySchema = z.object({
-  $schema: z.string().optional(),
-  projects: z.record(z.string(), projectEntrySchema).default({}),
-});
-
-export type Registry = z.infer<typeof registrySchema>;
-
-/**
- * Per-project конфиг `.runbook/config.json` (лежит в `.gitignore`).
- * Хранит текущий активный стенд конкретного разработчика.
- */
-export const projectConfigSchema = z.object({
-  $schema: z.string().optional(),
-  /** Имя проекта — должно совпадать с ключом в глобальном реестре. */
-  project: z.string().min(1),
-  /** Текущий активный стенд. */
-  activeStand: z.string().default('local'),
-  /** Доступные стенды проекта. */
-  stands: z.array(z.string()).default([...DEFAULT_STANDS]),
-});
-
-export type ProjectConfig = z.infer<typeof projectConfigSchema>;

package/src/core/registry/registry.service.ts

@@ -1,128 +0,0 @@
-import { promises as fs } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { Injectable } from '@nestjs/common';
-import {
-  type ProjectEntry,
-  type Registry,
-  registrySchema,
-} from './registry.schema';
-
-/**
- * Читает и пишет глобальный реестр проектов `~/.config/kodu/registry.json`
- * (учитывает `$XDG_CONFIG_HOME`). Файл создаётся при первой записи — пока
- * проектов нет, ничего в системе не создаётся.
- */
-@Injectable()
-export class RegistryService {
-  private readonly dir = path.join(
-    process.env.XDG_CONFIG_HOME?.trim() || path.join(os.homedir(), '.config'),
-    'kodu',
-  );
-  private readonly file = path.join(this.dir, 'registry.json');
-
-  /** Путь к файлу реестра (для подсказок пользователю). */
-  getFilePath(): string {
-    return this.file;
-  }
-
-  /** Загрузить реестр. Если файла ещё нет — вернуть пустой реестр. */
-  async load(): Promise<Registry> {
-    let raw: unknown;
-
-    try {
-      const content = await fs.readFile(this.file, 'utf8');
-      raw = JSON.parse(content);
-    } catch (error) {
-      if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
-        return registrySchema.parse({});
-      }
-      throw new Error(
-        `Не удалось прочитать реестр ${this.file}: ${(error as Error).message}`,
-      );
-    }
-
-    const parsed = registrySchema.safeParse(raw);
-
-    if (!parsed.success) {
-      const issues = parsed.error.issues
-        .map(
-          (issue) => `- ${issue.path.join('.') || '(root)'}: ${issue.message}`,
-        )
-        .join('\n');
-      throw new Error(`Реестр ${this.file} невалиден:\n${issues}`);
-    }
-
-    return parsed.data;
-  }
-
-  /** Сохранить реестр на диск (создаёт директорию при необходимости). */
-  async save(registry: Registry): Promise<void> {
-    const validated = registrySchema.parse(registry);
-    await fs.mkdir(this.dir, { recursive: true });
-    await fs.writeFile(
-      this.file,
-      `${JSON.stringify(validated, null, 2)}\n`,
-      'utf8',
-    );
-  }
-
-  async list(): Promise<Registry['projects']> {
-    return (await this.load()).projects;
-  }
-
-  async get(name: string): Promise<ProjectEntry | undefined> {
-    return (await this.load()).projects[name];
-  }
-
-  async has(name: string): Promise<boolean> {
-    return Boolean(await this.get(name));
-  }
-
-  /** Добавить проект. По умолчанию запрещает перезапись существующего имени. */
-  async add(
-    name: string,
-    entry: ProjectEntry,
-    options: { overwrite?: boolean } = {},
-  ): Promise<void> {
-    const registry = await this.load();
-
-    if (registry.projects[name] && !options.overwrite) {
-      throw new Error(
-        `Проект с именем "${name}" уже есть в реестре. Выбери другое имя или обнови существующий проект.`,
-      );
-    }
-
-    registry.projects[name] = entry;
-    await this.save(registry);
-  }
-
-  /** Обновить поля существующего проекта. */
-  async update(
-    name: string,
-    patch: Partial<ProjectEntry>,
-  ): Promise<ProjectEntry> {
-    const registry = await this.load();
-    const existing = registry.projects[name];
-
-    if (!existing) {
-      throw new Error(`Проект "${name}" не найден в реестре.`);
-    }
-
-    const next: ProjectEntry = { ...existing, ...patch };
-    registry.projects[name] = next;
-    await this.save(registry);
-    return next;
-  }
-
-  async remove(name: string): Promise<void> {
-    const registry = await this.load();
-
-    if (!registry.projects[name]) {
-      throw new Error(`Проект "${name}" не найден в реестре.`);
-    }
-
-    delete registry.projects[name];
-    await this.save(registry);
-  }
-}

package/src/core/ui/ui.module.ts

@@ -1,9 +0,0 @@
-import { Global, Module } from '@nestjs/common';
-import { UiService } from './ui.service';
-
-@Global()
-@Module({
-  providers: [UiService],
-  exports: [UiService],
-})
-export class UiModule {}

package/src/core/ui/ui.service.ts

@@ -1,39 +0,0 @@
-import confirm from '@inquirer/confirm';
-import input from '@inquirer/input';
-import select from '@inquirer/select';
-import { Injectable } from '@nestjs/common';
-import pc from 'picocolors';
-import yoctoSpinner, {
-  type Spinner,
-  type Options as SpinnerOptions,
-} from 'yocto-spinner';
-
-type InputOptions = Parameters<typeof input>[0];
-type ConfirmOptions = Parameters<typeof confirm>[0];
-type SelectOptions<TValue> = Parameters<typeof select<TValue>>[0];
-
-@Injectable()
-export class UiService {
-  readonly log = {
-    success: (message: string) => console.log(pc.green(`✔ ${message}`)),
-    warn: (message: string) => console.log(pc.yellow(`⚠ ${message}`)),
-    error: (message: string) => console.log(pc.red(`✖ ${message}`)),
-    info: (message: string) => console.log(pc.cyan(`ℹ ${message}`)),
-  };
-
-  createSpinner(options?: SpinnerOptions & { text?: string }): Spinner {
-    return yoctoSpinner({ text: options?.text ?? '', ...options });
-  }
-
-  promptInput(options: InputOptions): Promise<string> {
-    return input(options);
-  }
-
-  promptConfirm(options: ConfirmOptions): Promise<boolean> {
-    return confirm(options);
-  }
-
-  promptSelect<TValue>(options: SelectOptions<TValue>): Promise<TValue> {
-    return select<TValue>(options);
-  }
-}

package/src/main.ts

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-
-import { CommandFactory } from 'nest-commander';
-import packageJson from '../package.json';
-import { AppModule } from './app.module';
-
-async function bootstrap() {
-  await CommandFactory.run(AppModule, {
-    version: packageJson.version,
-  });
-}
-bootstrap();