@anatolykoptev/krolik-cli 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,417 @@
+import { R as ResolvedConfig } from './loader-_tD59b9E.js';
+export { F as FeatureConfig, K as KrolikConfig, P as PathConfig, a as PrismaConfig, b as RabbitConfig, T as TemplateConfig, c as TrpcConfig, d as defineConfig, g as getConfig, l as loadConfig } from './loader-_tD59b9E.js';
+
+/**
+ * @module types/commands/base
+ * @description Base command types and interfaces
+ */
+
+/**
+ * Output format for command results
+ * Default is 'ai' (AI-friendly XML format)
+ */
+type OutputFormat = 'ai' | 'json' | 'text' | 'markdown';
+/**
+ * Log levels
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Logger interface for dependency injection
+ */
+interface Logger {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    success(message: string): void;
+    section(title: string): void;
+    box(lines: string[], type?: 'info' | 'success' | 'warning' | 'error'): void;
+}
+/**
+ * Base options for all commands
+ */
+interface BaseCommandOptions {
+    /** Output format (default: 'ai' for AI-friendly XML) */
+    format?: OutputFormat;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Dry run mode (no changes) */
+    dryRun?: boolean;
+    /** Custom config path */
+    config?: string;
+    /** Project root override */
+    projectRoot?: string;
+    /** Human-readable text output */
+    text?: boolean;
+    /** JSON output */
+    json?: boolean;
+}
+/**
+ * Command context passed to all commands
+ */
+interface CommandContext {
+    /** Resolved configuration */
+    config: ResolvedConfig;
+    /** Logger instance */
+    logger: Logger;
+    /** Command options */
+    options: BaseCommandOptions;
+}
+/**
+ * Generic command result
+ */
+interface CommandResult<T = unknown> {
+    /** Whether command succeeded */
+    success: boolean;
+    /** Result data */
+    data?: T;
+    /** Error message if failed */
+    error?: string;
+    /** Duration in milliseconds */
+    durationMs?: number;
+}
+
+/**
+ * @module commands/fix/types
+ * @description Unified types for code quality analysis and auto-fixing
+ *
+ * Consolidates all types from former quality/ into fix/
+ */
+
+/**
+ * Severity levels for quality issues
+ */
+type QualitySeverity = 'error' | 'warning' | 'info';
+
+/**
+ * @module types/commands/review
+ * @description Review command result types
+ */
+
+type ReviewSeverity = QualitySeverity;
+/**
+ * Review issue categories
+ */
+type ReviewCategory = 'security' | 'performance' | 'style' | 'logic' | 'test' | 'docs';
+/**
+ * Single review issue
+ */
+interface ReviewIssue {
+    file: string;
+    line?: number;
+    severity: ReviewSeverity;
+    category: ReviewCategory;
+    message: string;
+    suggestion?: string;
+}
+/**
+ * File change information
+ */
+interface FileChange {
+    path: string;
+    status: 'added' | 'modified' | 'deleted' | 'renamed';
+    additions: number;
+    deletions: number;
+    binary: boolean;
+}
+/**
+ * Review result
+ */
+interface ReviewResult {
+    title: string;
+    description: string;
+    baseBranch: string;
+    headBranch: string;
+    files: FileChange[];
+    issues: ReviewIssue[];
+    affectedFeatures: string[];
+    summary: {
+        totalFiles: number;
+        additions: number;
+        deletions: number;
+        riskLevel: 'low' | 'medium' | 'high';
+        testsRequired: boolean;
+        docsRequired: boolean;
+    };
+}
+
+/**
+ * @module types/commands/routes
+ * @description Routes analysis result types
+ */
+/**
+ * Route procedure definition
+ */
+interface RouteProcedure {
+    name: string;
+    type: 'query' | 'mutation' | 'subscription';
+    input?: string;
+    output?: string;
+}
+/**
+ * Router definition
+ */
+interface RouterDefinition {
+    name: string;
+    file: string;
+    procedures: RouteProcedure[];
+}
+/**
+ * Routes analysis result
+ */
+interface RoutesResult {
+    routers: RouterDefinition[];
+    totalProcedures: number;
+    queries: number;
+    mutations: number;
+}
+
+/**
+ * @module types/commands/schema
+ * @description Schema analysis result types
+ */
+/**
+ * Schema field definition
+ */
+interface SchemaField {
+    name: string;
+    type: string;
+    isOptional: boolean;
+    isArray: boolean;
+    attributes: string[];
+}
+/**
+ * Schema relation definition
+ */
+interface SchemaRelation {
+    name: string;
+    type: 'one-to-one' | 'one-to-many' | 'many-to-many';
+    target: string;
+}
+/**
+ * Schema model definition
+ */
+interface SchemaModel {
+    name: string;
+    fields: SchemaField[];
+    relations: SchemaRelation[];
+}
+/**
+ * Schema analysis result
+ */
+interface SchemaResult {
+    models: SchemaModel[];
+    enums: Array<{
+        name: string;
+        values: string[];
+    }>;
+    modelCount: number;
+    enumCount: number;
+}
+
+/**
+ * @module types/commands/status
+ * @description Status command result types
+ */
+/**
+ * Status command result
+ */
+interface StatusResult {
+    health: 'good' | 'warning' | 'error';
+    branch: {
+        name: string;
+        isCorrect: boolean;
+    };
+    git: {
+        hasChanges: boolean;
+        modified: number;
+        untracked: number;
+        staged: number;
+        ahead?: number;
+        behind?: number;
+    };
+    typecheck: {
+        status: 'passed' | 'failed' | 'skipped';
+        cached: boolean;
+        errors?: string;
+    };
+    lint: {
+        warnings: number;
+        errors: number;
+    };
+    todos: {
+        count: number;
+    };
+    durationMs: number;
+    /** Package info (optional, for rich output) */
+    package?: {
+        name: string;
+        version: string;
+        depsCount: number;
+        devDepsCount: number;
+    };
+    /** Tech stack (optional, for rich output) */
+    techStack?: {
+        framework?: string;
+        language: 'typescript' | 'javascript';
+        ui: string[];
+        database: string[];
+        api: string[];
+        packageManager: string;
+    };
+    /** Recent commits (optional, for rich output) */
+    recentCommits?: Array<{
+        hash: string;
+        message: string;
+        author: string;
+        relativeDate: string;
+    }>;
+    /** File stats (optional, for rich output) */
+    fileStats?: {
+        sourceFiles: number;
+        testFiles: number;
+    };
+    /** Monorepo workspaces (optional) */
+    workspaces?: Array<{
+        name: string;
+        path: string;
+        type: 'app' | 'package' | 'config' | 'unknown';
+    }>;
+    /** AI rules files for agents to read (IMPORTANT!) */
+    aiRules?: Array<{
+        path: string;
+        relativePath: string;
+        scope: 'root' | 'package' | 'app';
+    }>;
+    /** Current branch context */
+    branchContext?: {
+        name: string;
+        type: 'feature' | 'fix' | 'chore' | 'release' | 'hotfix' | 'main' | 'develop' | 'unknown';
+        issueNumber?: number;
+        description?: string;
+    };
+}
+
+/**
+ * @module lib/fs
+ * @description File system utilities
+ */
+/**
+ * Options for file finding
+ */
+interface FindFilesOptions {
+    /** File extensions to include (e.g., ['.ts', '.tsx']) */
+    extensions?: string[];
+    /** Directories to skip */
+    skipDirs?: string[];
+    /** Maximum depth to traverse */
+    maxDepth?: number;
+}
+/**
+ * Read file contents as string
+ */
+declare function readFile(filePath: string): string | null;
+/**
+ * Write content to file
+ */
+declare function writeFile(filePath: string, content: string): boolean;
+/**
+ * Find files recursively matching criteria
+ */
+declare function findFiles(dir: string, options?: FindFilesOptions): string[];
+
+/**
+ * @module lib/@git/local
+ * @description Git operations for local project repository
+ */
+/**
+ * Git status information
+ */
+interface GitStatus {
+    /** Files with modifications */
+    modified: string[];
+    /** Untracked files */
+    untracked: string[];
+    /** Staged files */
+    staged: string[];
+    /** Has any changes */
+    hasChanges: boolean;
+}
+/**
+ * Check if current directory is a git repository
+ */
+declare function isGitRepo(cwd?: string): boolean;
+/**
+ * Get current branch name
+ */
+declare function getCurrentBranch(cwd?: string): string | null;
+/**
+ * Get git status (modified, untracked, staged files)
+ */
+declare function getStatus(cwd?: string): GitStatus;
+
+/**
+ * @module lib/logger
+ * @description Colored console logging with multiple output styles
+ */
+
+/**
+ * Logger options
+ */
+interface LoggerOptions {
+    /** Minimum log level */
+    level?: LogLevel;
+    /** Use colors */
+    colors?: boolean;
+    /** Custom write function (for testing) */
+    write?: (message: string) => void;
+}
+/**
+ * Create a logger instance
+ */
+declare function createLogger(options?: LoggerOptions): Logger;
+
+/**
+ * @module lib/shell
+ * @description Shell command execution utilities
+ */
+/**
+ * Shell execution options
+ */
+interface ShellOptions {
+    /** Working directory */
+    cwd?: string;
+    /** Suppress output */
+    silent?: boolean;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Environment variables */
+    env?: Record<string, string>;
+}
+/**
+ * Shell execution result
+ */
+interface ShellResult {
+    /** Command succeeded */
+    success: boolean;
+    /** Command output */
+    output: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Execute a shell command and return trimmed output
+ *
+ * @throws Error if command fails
+ */
+declare function exec(command: string, options?: ShellOptions): string;
+/**
+ * Execute a shell command and return result object (never throws)
+ */
+declare function tryExec(command: string, options?: ShellOptions): ShellResult;
+/**
+ * Execute a shell command and return lines array
+ */
+declare function execLines(command: string, options?: ShellOptions): string[];
+
+export { type CommandContext, type CommandResult, type Logger, ResolvedConfig, type ReviewResult, type RoutesResult, type SchemaResult, type StatusResult, createLogger, exec, execLines, findFiles, getCurrentBranch, getStatus, isGitRepo, readFile, tryExec, writeFile };

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createLogger, defineConfig, exec, execLines, findFiles, getConfig, getCurrentBranch, getStatus, isGitRepo, loadConfig, readFile, tryExec, writeFile } from './chunk-DTDOBWO6.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/loader-_tD59b9E.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @module types/config
+ * @description Configuration type definitions
+ */
+/**
+ * Path configuration for project directories
+ */
+interface PathConfig {
+    /** Web application directory (e.g., 'apps/web', 'src') */
+    web?: string;
+    /** API/backend directory (e.g., 'packages/api', 'server') */
+    api?: string;
+    /** Database/ORM directory (e.g., 'packages/db', 'prisma') */
+    db?: string;
+    /** Shared packages directory */
+    shared?: string;
+    /** Components directory */
+    components?: string;
+    /** Hooks directory */
+    hooks?: string;
+    /** Library/utilities directory */
+    lib?: string;
+}
+/**
+ * Feature flags for project capabilities
+ */
+interface FeatureConfig {
+    /** Project uses Prisma ORM */
+    prisma?: boolean;
+    /** Project uses tRPC */
+    trpc?: boolean;
+    /** Project uses Next.js */
+    nextjs?: boolean;
+    /** Project uses React */
+    react?: boolean;
+    /** Project is a monorepo */
+    monorepo?: boolean;
+    /** Project uses TypeScript */
+    typescript?: boolean;
+}
+/**
+ * Prisma-specific configuration
+ */
+interface PrismaConfig {
+    /** Path to Prisma schema directory or file */
+    schemaDir?: string;
+    /** Path to migrations directory */
+    migrationsDir?: string;
+}
+/**
+ * tRPC-specific configuration
+ */
+interface TrpcConfig {
+    /** Path to routers directory */
+    routersDir?: string;
+    /** Path to main router file */
+    appRouter?: string;
+}
+/**
+ * Template configuration for code generation
+ */
+interface TemplateConfig {
+    /** Path to hook template */
+    hook?: string;
+    /** Path to component template */
+    component?: string;
+    /** Path to test template */
+    test?: string;
+    /** Path to schema template */
+    schema?: string;
+}
+/**
+ * Domain configuration for context filtering
+ */
+interface DomainConfig {
+    /** Primary keywords that get highest priority in filtering */
+    primary: string[];
+    /** Secondary keywords for broader matching */
+    secondary?: string[];
+    /** File patterns related to this domain (glob) */
+    files?: string[];
+    /** Suggested approach steps */
+    approach?: string[];
+    /** Context hints for AI */
+    hints?: Record<string, string>;
+}
+/**
+ * Main project configuration
+ */
+interface KrolikConfig {
+    /** Project name (for display purposes) */
+    name?: string;
+    /** Project root directory (auto-detected if not set) */
+    projectRoot?: string;
+    /** Path configurations */
+    paths?: PathConfig;
+    /** Feature flags */
+    features?: FeatureConfig;
+    /** Prisma configuration */
+    prisma?: PrismaConfig;
+    /** tRPC configuration */
+    trpc?: TrpcConfig;
+    /** Template paths */
+    templates?: TemplateConfig;
+    /** Custom domain definitions for context filtering */
+    domains?: Record<string, DomainConfig>;
+    /** Directories to exclude from analysis */
+    exclude?: string[];
+    /** Custom extensions to include */
+    extensions?: string[];
+}
+/** @deprecated Use KrolikConfig instead */
+type RabbitConfig = KrolikConfig;
+/**
+ * Resolved configuration with all defaults applied
+ * Note: domains remains optional as it's project-specific configuration
+ */
+interface ResolvedConfig extends Omit<Required<KrolikConfig>, 'domains'> {
+    paths: Required<PathConfig>;
+    features: Required<FeatureConfig>;
+    prisma: Required<PrismaConfig>;
+    trpc: Required<TrpcConfig>;
+    templates: Required<TemplateConfig>;
+    domains?: Record<string, DomainConfig>;
+}
+
+/**
+ * @module config/loader
+ * @description Configuration loading and resolution
+ */
+
+/**
+ * Find project root by looking for package.json
+ */
+declare function findProjectRoot(startDir?: string): string;
+/**
+ * Load and resolve configuration
+ */
+declare function loadConfig(options?: {
+    configPath?: string;
+    projectRoot?: string;
+    noCache?: boolean;
+}): Promise<ResolvedConfig>;
+/**
+ * Get config synchronously (must have been loaded first)
+ */
+declare function getConfig(): ResolvedConfig;
+/**
+ * Clear config cache
+ */
+declare function clearConfigCache(): void;
+/**
+ * Helper to define config with type checking
+ */
+declare function defineConfig(config: KrolikConfig): KrolikConfig;
+
+export { type FeatureConfig as F, type KrolikConfig as K, type PathConfig as P, type ResolvedConfig as R, type TemplateConfig as T, type PrismaConfig as a, type RabbitConfig as b, type TrpcConfig as c, defineConfig as d, clearConfigCache as e, findProjectRoot as f, getConfig as g, loadConfig as l };

package/package.json

@@ -0,0 +1,118 @@
+{
+  "name": "@anatolykoptev/krolik-cli",
+  "version": "0.1.0",
+  "description": "KROLIK — fast AI-assisted development toolkit for TypeScript projects",
+  "keywords": [
+    "cli",
+    "ai",
+    "developer-tools",
+    "typescript",
+    "code-review",
+    "prisma",
+    "trpc",
+    "nextjs",
+    "krolik"
+  ],
+  "author": "Anatoly Koptev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anatolykoptev/krolik-cli.git"
+  },
+  "homepage": "https://github.com/anatolykoptev/krolik-cli#readme",
+  "bugs": {
+    "url": "https://github.com/anatolykoptev/krolik-cli/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "krolik": "./dist/bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/bin/cli.ts",
+    "build": "pnpm sync-version && tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "format": "biome format --write .",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "sync-version": "tsx scripts/sync-version.ts",
+    "changeset": "changeset",
+    "changeset:version": "changeset version && pnpm sync-version",
+    "changeset:publish": "pnpm build && changeset publish",
+    "prepublishOnly": "pnpm build",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "@typescript-eslint/parser": "^8.50.0",
+    "better-sqlite3": "^12.5.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "cosmiconfig": "^9.0.0",
+    "glob": "^13.0.0",
+    "jscodeshift": "^17.3.0",
+    "ora": "^8.2.0",
+    "prettier": "^3.7.4",
+    "ts-morph": "^27.0.2",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.0.0",
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.29.8",
+    "@swc/core": "^1.15.7",
+    "@swc/core-darwin-arm64": "^1.15.7",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.15.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
+  "packageManager": "pnpm@10.0.0",
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "biome check --write --no-errors-on-unmatched"
+    ],
+    "*.{json,md,yml,yaml}": [
+      "biome format --write --no-errors-on-unmatched"
+    ]
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "better-sqlite3"
+    ]
+  }
+}