kaven-cli 0.4.1-alpha.0 → 0.4.2-alpha.0

package/dist/core/ProjectInitializer.js

@@ -1,183 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProjectInitializer = void 0;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-const child_process_1 = require("child_process");
-const TEMPLATE_REPO = "https://github.com/kaven-co/kaven-template.git";
-const KAVEN_SQUAD_REPO = "https://github.com/bychrisr/kaven-squad";
-/** Run a shell command via spawn, returning exit code. */
-function runCommand(cmd, args, cwd, onData) {
-    return new Promise((resolve, reject) => {
-        const proc = (0, child_process_1.spawn)(cmd, args, { cwd, stdio: onData ? "pipe" : "inherit" });
-        if (onData && proc.stdout) {
-            proc.stdout.on("data", (d) => onData(d.toString()));
-        }
-        if (onData && proc.stderr) {
-            proc.stderr.on("data", (d) => onData(d.toString()));
-        }
-        proc.on("error", reject);
-        proc.on("close", (code) => resolve(code ?? 0));
-    });
-}
-class ProjectInitializer {
-    /** Validate that the project name only contains alphanumerics and hyphens. */
-    validateName(name) {
-        if (!name || name.trim().length === 0) {
-            return { valid: false, reason: "Project name cannot be empty" };
-        }
-        if (/\s/.test(name)) {
-            return { valid: false, reason: "Project name cannot contain spaces" };
-        }
-        if (!/^[a-z0-9-]+$/.test(name)) {
-            return {
-                valid: false,
-                reason: "Project name must only contain lowercase letters, numbers, and hyphens",
-            };
-        }
-        return { valid: true };
-    }
-    /** Clone the template (from Git or local path) into targetDir. */
-    async cloneTemplate(targetDir, templateSource) {
-        const source = templateSource || TEMPLATE_REPO;
-        console.log(`[INIT] Clone Source: ${source}`);
-        console.log(`[INIT] Target Dir: ${targetDir}`);
-        // If it's a local path that exists, copy it instead of cloning
-        if (await fs_extra_1.default.pathExists(source) && (source.startsWith("/") || source.startsWith("./") || source.startsWith("../"))) {
-            console.log(`[INIT] Local Path Detected. Copying...`);
-            await fs_extra_1.default.copy(source, targetDir, {
-                filter: (src) => !src.includes("node_modules") && !src.includes(".git") && !src.includes(".turbo")
-            });
-            console.log(`[INIT] Local Copy Done.`);
-            return;
-        }
-        const exitCode = await runCommand("git", ["clone", "--depth", "1", source, targetDir], process.cwd());
-        if (exitCode !== 0) {
-            throw new Error(`git clone failed with exit code ${exitCode}`);
-        }
-    }
-    /** Remove the .git directory from the cloned project. */
-    async removeGitDir(targetDir) {
-        const gitDir = path_1.default.join(targetDir, ".git");
-        if (await fs_extra_1.default.pathExists(gitDir)) {
-            await fs_extra_1.default.remove(gitDir);
-        }
-    }
-    /** Replace placeholders in key project files. */
-    async replacePlaceholders(targetDir, values) {
-        const replacements = {
-            "{{PROJECT_NAME}}": values.projectName,
-            "{{DATABASE_URL}}": values.dbUrl,
-            "{{DEFAULT_LOCALE}}": values.locale,
-            "{{DEFAULT_CURRENCY}}": values.currency,
-        };
-        const filesToProcess = [
-            "package.json",
-            ".env.example",
-            "packages/database/prisma/schema.prisma",
-            "apps/api/package.json",
-            "apps/admin/package.json",
-            "apps/tenant/package.json",
-            "docs/architecture/tech-stack.md",
-            "docs/architecture/source-tree.md",
-            "docs/architecture/coding-standards.md",
-        ];
-        for (const relFile of filesToProcess) {
-            const filePath = path_1.default.join(targetDir, relFile);
-            if (!(await fs_extra_1.default.pathExists(filePath)))
-                continue;
-            let content = await fs_extra_1.default.readFile(filePath, "utf-8");
-            for (const [placeholder, value] of Object.entries(replacements)) {
-                content = content.split(placeholder).join(value);
-            }
-            await fs_extra_1.default.writeFile(filePath, content, "utf-8");
-        }
-        // Safety net: directly update root package.json name field regardless of placeholder
-        const pkgPath = path_1.default.join(targetDir, "package.json");
-        if (await fs_extra_1.default.pathExists(pkgPath)) {
-            const pkg = await fs_extra_1.default.readJson(pkgPath);
-            if (pkg.name !== values.projectName) {
-                pkg.name = values.projectName;
-                await fs_extra_1.default.writeJson(pkgPath, pkg, { spaces: 2 });
-            }
-        }
-    }
-    /** Run pnpm install in the target directory. */
-    async runInstall(targetDir) {
-        const exitCode = await runCommand("pnpm", ["install"], targetDir);
-        if (exitCode !== 0) {
-            throw new Error(`pnpm install failed with exit code ${exitCode}`);
-        }
-    }
-    /** Initialize git and create an initial commit. */
-    async initGit(targetDir) {
-        await runCommand("git", ["init"], targetDir);
-        await runCommand("git", ["add", "."], targetDir);
-        await runCommand("git", ["commit", "-m", "chore: initial kaven setup"], targetDir);
-    }
-    /**
-     * Clone kaven-squad into squads/kaven-squad/ inside the project.
-     * Returns { installed: true } on success, { installed: false, reason } on failure.
-     * Never throws — squad installation is non-fatal.
-     */
-    async installSquad(targetDir) {
-        const squadsDir = path_1.default.join(targetDir, "squads");
-        const squadDir = path_1.default.join(squadsDir, "kaven-squad");
-        // Squad already present — skip
-        if (await fs_extra_1.default.pathExists(squadDir)) {
-            return { installed: false, reason: "already-exists" };
-        }
-        await fs_extra_1.default.ensureDir(squadsDir);
-        const exitCode = await runCommand("git", ["clone", "--depth", "1", KAVEN_SQUAD_REPO, squadDir], process.cwd());
-        if (exitCode !== 0) {
-            return {
-                installed: false,
-                reason: `git clone exited with code ${exitCode}`,
-            };
-        }
-        // Remove .git — squad history not needed in user project
-        const squadGitDir = path_1.default.join(squadDir, ".git");
-        if (await fs_extra_1.default.pathExists(squadGitDir)) {
-            await fs_extra_1.default.remove(squadGitDir);
-        }
-        return { installed: true };
-    }
-    /**
-     * Install AIOX Core runtime into the project via npx.
-     * Non-fatal — if it fails, user gets instructions to run manually.
-     */
-    async installAIOXCore(targetDir) {
-        const exitCode = await runCommand('npx', ['aiox-core@5.0.3', 'install', '--quiet'], targetDir);
-        if (exitCode !== 0) {
-            return {
-                installed: false,
-                reason: `npx aiox-core exited with code ${exitCode}`,
-            };
-        }
-        return { installed: true };
-    }
-    /** Health check after project initialization. */
-    async healthCheck(targetDir) {
-        const issues = [];
-        // Check key files exist
-        const requiredFiles = ["package.json", ".env.example", "packages/database/prisma/schema.prisma"];
-        for (const file of requiredFiles) {
-            if (!(await fs_extra_1.default.pathExists(path_1.default.join(targetDir, file)))) {
-                issues.push(`Missing required file: ${file}`);
-            }
-        }
-        // Check node_modules exists (if install was run)
-        const hasNodeModules = await fs_extra_1.default.pathExists(path_1.default.join(targetDir, "node_modules"));
-        if (!hasNodeModules) {
-            issues.push("Dependencies not installed. Run: pnpm install");
-        }
-        return {
-            healthy: issues.length === 0,
-            issues,
-        };
-    }
-}
-exports.ProjectInitializer = ProjectInitializer;

package/dist/core/RegistryResolver.js

@@ -1,95 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RegistryResolver = void 0;
-const ConfigManager_1 = require("./ConfigManager");
-const MarketplaceClient_1 = require("../infrastructure/MarketplaceClient");
-const AuthService_1 = require("./AuthService");
-/**
- * C2.5: Registry resolver — handles both official and custom registries
- */
-class RegistryResolver {
-    authService;
-    constructor(authService) {
-        this.authService = authService || new AuthService_1.AuthService();
-    }
-    /**
-     * Get the active registry URL (custom or default)
-     */
-    async getActiveRegistry() {
-        await ConfigManager_1.configManager.initialize();
-        return ConfigManager_1.configManager.getRegistry();
-    }
-    /**
-     * Get marketplace client for active registry
-     */
-    async getMarketplaceClient() {
-        const registry = await this.getActiveRegistry();
-        const client = new MarketplaceClient_1.MarketplaceClient(this.authService);
-        // Set custom registry if configured
-        if (registry !== "https://marketplace.kaven.site") {
-            client.baseUrl = registry;
-        }
-        return client;
-    }
-    /**
-     * Validate registry URL is accessible
-     */
-    async validateRegistry(url) {
-        try {
-            const response = await fetch(`${url}/health`);
-            if (!response.ok) {
-                return {
-                    valid: false,
-                    error: `Registry returned ${response.status} ${response.statusText}`,
-                };
-            }
-            return { valid: true };
-        }
-        catch (error) {
-            return {
-                valid: false,
-                error: `Failed to connect: ${error instanceof Error ? error.message : String(error)}`,
-            };
-        }
-    }
-    /**
-     * Set custom registry
-     */
-    async setCustomRegistry(url) {
-        // Validate URL format
-        try {
-            new URL(url);
-        }
-        catch {
-            throw new Error(`Invalid URL format: ${url}`);
-        }
-        // Validate registry is accessible
-        const validation = await this.validateRegistry(url);
-        if (!validation.valid) {
-            throw new Error(`Registry validation failed: ${validation.error}`);
-        }
-        // Save to config
-        await ConfigManager_1.configManager.initialize();
-        await ConfigManager_1.configManager.set("customRegistry", url);
-    }
-    /**
-     * Reset to default registry
-     */
-    async resetToDefaultRegistry() {
-        await ConfigManager_1.configManager.initialize();
-        await ConfigManager_1.configManager.set("customRegistry", undefined);
-    }
-    /**
-     * List all available registries (default + custom)
-     */
-    async listRegistries() {
-        await ConfigManager_1.configManager.initialize();
-        const config = ConfigManager_1.configManager.getAll();
-        return {
-            default: config.registry || "https://marketplace.kaven.site",
-            custom: config.customRegistry,
-            active: await this.getActiveRegistry(),
-        };
-    }
-}
-exports.RegistryResolver = RegistryResolver;

package/dist/core/SchemaActivator.js

@@ -1,278 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaActivator = exports.KAVEN_MODULES = void 0;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-exports.KAVEN_MODULES = [
-    {
-        id: "auth",
-        label: "Auth & Identity",
-        description: "Gestão de usuários, permissões e sessões",
-        models: ["User", "Role", "Capability", "AuthSession", "AuditLog"],
-        enums: ["UserRole"],
-        dependsOn: [],
-    },
-    {
-        id: "billing",
-        label: "Billing",
-        description: "Faturamento, assinaturas e pagamentos",
-        models: ["Invoice", "Order", "Subscription", "Plan", "Payment", "Product"],
-        enums: [],
-        dependsOn: [],
-    },
-    {
-        id: "projects",
-        label: "Projects",
-        description: "Gestão de projetos e tasks",
-        models: ["Project", "Task"],
-        enums: ["ProjectStatus", "TaskStatus", "TaskPriority"],
-        dependsOn: [],
-    },
-    {
-        id: "notifications",
-        label: "Notifications",
-        description: "Notificações e preferências de usuário",
-        models: ["Notification", "UserPreference"],
-        enums: [],
-        dependsOn: [],
-    },
-    {
-        id: "marketing-tracking",
-        label: "Marketing Tracking",
-        description: "Observabilidade de anúncios, GTM, GA4 e Meta CAPI",
-        models: ["TrackingEvent"],
-        enums: ["TrackingSource"],
-        dependsOn: [],
-    },
-    {
-        id: "service-tokens",
-        label: "Service Tokens",
-        description: "Agent authentication tokens for AIOX integration",
-        models: ["ServiceToken"],
-        enums: [],
-        dependsOn: [],
-    },
-];
-// ============================================================
-// Marcadores de seção no schema
-// ============================================================
-const BEGIN_MARKER = (moduleId) => `// [KAVEN_MODULE:${moduleId.toUpperCase()} BEGIN]`;
-const END_MARKER = (moduleId) => `// [KAVEN_MODULE:${moduleId.toUpperCase()} END]`;
-// ============================================================
-// SchemaActivator — lê/escreve schema.extended.prisma
-// ============================================================
-class SchemaActivator {
-    schemaPath;
-    constructor(projectRoot) {
-        this.schemaPath = path_1.default.join(projectRoot, "packages", "database", "prisma", "schema.extended.prisma");
-    }
-    /** Verifica se o schema existe no projeto */
-    async exists() {
-        return fs_extra_1.default.pathExists(this.schemaPath);
-    }
-    /** Caminho absoluto do schema */
-    get path() {
-        return this.schemaPath;
-    }
-    /** Lê o conteúdo atual do schema */
-    async readSchema() {
-        return fs_extra_1.default.readFile(this.schemaPath, "utf-8");
-    }
-    /** Persiste o conteúdo no schema */
-    async writeSchema(content) {
-        await fs_extra_1.default.writeFile(this.schemaPath, content, "utf-8");
-    }
-    /**
-     * Detecta se um módulo está ativo no schema.
-     *
-     * Estratégia:
-     * 1. Se existirem marcadores BEGIN/END: verifica se o conteúdo dentro
-     *    dos marcadores NÃO está completamente comentado.
-     * 2. Se não houver marcadores: verifica se algum dos models principais
-     *    do módulo está presente e não comentado no arquivo.
-     */
-    async getModuleStatus(def) {
-        const content = await this.readSchema();
-        const begin = BEGIN_MARKER(def.id);
-        const end = END_MARKER(def.id);
-        const hasMarkers = content.includes(begin) && content.includes(end);
-        let active = false;
-        if (hasMarkers) {
-            const block = this.extractBlock(content, def.id);
-            active = block !== null && this.isBlockActive(block);
-        }
-        else {
-            // Sem marcadores: verifica presença de pelo menos um model descomentado
-            active = def.models.some((modelName) => this.isModelActive(content, modelName));
-        }
-        return {
-            id: def.id,
-            label: def.label,
-            description: def.description,
-            models: def.models,
-            dependsOn: def.dependsOn,
-            active,
-            hasMarkers,
-        };
-    }
-    /** Ativa um módulo: se tem marcadores, descomenta o bloco; senão, injeta o bloco */
-    async activateModule(def) {
-        const content = await this.readSchema();
-        const begin = BEGIN_MARKER(def.id);
-        const end = END_MARKER(def.id);
-        if (content.includes(begin) && content.includes(end)) {
-            const updated = this.uncommentBlock(content, def.id);
-            await this.writeSchema(updated);
-            return;
-        }
-        // Módulo não tem seção marcada — sem template para injetar
-        throw new Error(`O módulo "${def.id}" não possui uma seção marcada (BEGIN/END) no schema.\n` +
-            `Adicione o bloco do módulo manualmente com os marcadores:\n` +
-            `  ${begin}\n` +
-            `  ... models do módulo ...\n` +
-            `  ${end}`);
-    }
-    /** Desativa um módulo: comenta todos os models do bloco */
-    async deactivateModule(def) {
-        const content = await this.readSchema();
-        const begin = BEGIN_MARKER(def.id);
-        const end = END_MARKER(def.id);
-        if (!content.includes(begin) || !content.includes(end)) {
-            throw new Error(`O módulo "${def.id}" não possui marcadores BEGIN/END no schema. ` +
-                `Não é possível desativar automaticamente.`);
-        }
-        const updated = this.commentBlock(content, def.id);
-        await this.writeSchema(updated);
-    }
-    // ──────────────────────────────────────────────
-    // Helpers de manipulação de blocos
-    // ──────────────────────────────────────────────
-    /**
-     * Extrai o conteúdo entre os marcadores BEGIN e END (exclusive).
-     * Retorna null se os marcadores não forem encontrados.
-     */
-    extractBlock(content, moduleId) {
-        const begin = BEGIN_MARKER(moduleId);
-        const end = END_MARKER(moduleId);
-        const lines = content.split("\n");
-        let beginIdx = -1;
-        let endIdx = -1;
-        for (let i = 0; i < lines.length; i++) {
-            if (lines[i].includes(begin))
-                beginIdx = i;
-            if (lines[i].includes(end) && beginIdx !== -1) {
-                endIdx = i;
-                break;
-            }
-        }
-        if (beginIdx === -1 || endIdx === -1)
-            return null;
-        return lines.slice(beginIdx + 1, endIdx).join("\n");
-    }
-    /**
-     * Verifica se um bloco tem ao menos uma linha não-comentada relevante
-     * (ignora linhas vazias e comentários simples).
-     */
-    isBlockActive(block) {
-        return block.split("\n").some((line) => {
-            const trimmed = line.trim();
-            return (trimmed.length > 0 &&
-                !trimmed.startsWith("//") &&
-                !trimmed.startsWith("/*") &&
-                !trimmed.startsWith("*"));
-        });
-    }
-    /**
-     * Verifica se um model específico está ativo (não comentado) no schema.
-     * Procura pela linha `model ModelName {` sem `//` antes.
-     */
-    isModelActive(content, modelName) {
-        const lines = content.split("\n");
-        for (const line of lines) {
-            const trimmed = line.trim();
-            if (trimmed.startsWith(`model ${modelName}`) &&
-                !line.trimStart().startsWith("//")) {
-                return true;
-            }
-        }
-        return false;
-    }
-    /**
-     * Comenta todas as linhas não-comentadas dentro do bloco BEGIN/END.
-     */
-    commentBlock(content, moduleId) {
-        const begin = BEGIN_MARKER(moduleId);
-        const end = END_MARKER(moduleId);
-        const lines = content.split("\n");
-        let inBlock = false;
-        const result = [];
-        for (const line of lines) {
-            if (line.includes(begin)) {
-                inBlock = true;
-                result.push(line);
-                continue;
-            }
-            if (line.includes(end)) {
-                inBlock = false;
-                result.push(line);
-                continue;
-            }
-            if (inBlock) {
-                const trimmed = line.trim();
-                if (trimmed.length === 0) {
-                    result.push(line);
-                }
-                else if (trimmed.startsWith("//")) {
-                    result.push(line); // já comentado
-                }
-                else {
-                    result.push(`// ${line}`);
-                }
-            }
-            else {
-                result.push(line);
-            }
-        }
-        return result.join("\n");
-    }
-    /**
-     * Remove `// ` do início das linhas dentro do bloco BEGIN/END.
-     */
-    uncommentBlock(content, moduleId) {
-        const begin = BEGIN_MARKER(moduleId);
-        const end = END_MARKER(moduleId);
-        const lines = content.split("\n");
-        let inBlock = false;
-        const result = [];
-        for (const line of lines) {
-            if (line.includes(begin)) {
-                inBlock = true;
-                result.push(line);
-                continue;
-            }
-            if (line.includes(end)) {
-                inBlock = false;
-                result.push(line);
-                continue;
-            }
-            if (inBlock) {
-                // Remove exatamente um nível de comentário preservando identação
-                const match = line.match(/^(\s*)\/\/\s?(.*)$/);
-                if (match) {
-                    result.push(match[1] + match[2]);
-                }
-                else {
-                    result.push(line);
-                }
-            }
-            else {
-                result.push(line);
-            }
-        }
-        return result.join("\n");
-    }
-}
-exports.SchemaActivator = SchemaActivator;

package/dist/core/ScriptRunner.js

@@ -1,73 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScriptRunner = void 0;
-const child_process_1 = require("child_process");
-const readline_1 = __importDefault(require("readline"));
-const chalk_1 = __importDefault(require("chalk"));
-class ScriptRunner {
-    timeoutMs;
-    constructor(timeoutMs = 60_000) {
-        this.timeoutMs = timeoutMs;
-    }
-    async runScript(script, label, skipConfirmation = false) {
-        if (!skipConfirmation) {
-            const confirmed = await this.confirm(`Run ${label} script: ${script.command} ${(script.args ?? []).join(' ')}?`);
-            if (!confirmed) {
-                console.log(chalk_1.default.dim(`  Skipping ${label} script.`));
-                return;
-            }
-        }
-        return new Promise((resolve, reject) => {
-            const child = (0, child_process_1.spawn)(script.command, script.args ?? [], {
-                cwd: script.cwd,
-                stdio: ['ignore', 'pipe', 'pipe'],
-                shell: true,
-            });
-            const prefix = chalk_1.default.dim(`[${label}] `);
-            child.stdout?.on('data', (data) => {
-                process.stdout.write(prefix + data.toString());
-            });
-            child.stderr?.on('data', (data) => {
-                process.stderr.write(prefix + chalk_1.default.yellow(data.toString()));
-            });
-            const timer = setTimeout(() => {
-                console.warn(chalk_1.default.yellow(`\n  ⚠ ${label} script timed out after ${this.timeoutMs / 1000}s, sending SIGTERM...`));
-                child.kill('SIGTERM');
-                setTimeout(() => {
-                    child.kill('SIGKILL');
-                }, 5_000);
-            }, this.timeoutMs);
-            child.on('close', (code) => {
-                clearTimeout(timer);
-                if (code === 0 || code === null) {
-                    resolve();
-                }
-                else {
-                    reject(new Error(`${label} script exited with code ${code}`));
-                }
-            });
-            child.on('error', (err) => {
-                clearTimeout(timer);
-                reject(err);
-            });
-        });
-    }
-    async runScripts(scripts, label, skipConfirmation = false) {
-        for (const script of scripts) {
-            await this.runScript(script, label, skipConfirmation);
-        }
-    }
-    confirm(message) {
-        return new Promise((resolve) => {
-            const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
-            rl.question(`\n  ${message} [y/N] `, (answer) => {
-                rl.close();
-                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
-            });
-        });
-    }
-}
-exports.ScriptRunner = ScriptRunner;