agent-ctx 1.0.0

package/dist/lib/logger.js

@@ -0,0 +1,168 @@
+/**
+ * Logger - Utilidades de output con colores y soporte quiet
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import figlet from 'figlet';
+// Estado global del logger
+let quietMode = false;
+let currentSpinner = null;
+/**
+ * Configura el modo quiet
+ */
+export function setQuietMode(enabled) {
+    quietMode = enabled;
+}
+/**
+ * Verifica si está en modo quiet
+ */
+export function isQuiet() {
+    return quietMode;
+}
+export const logger = {
+    // === Mensajes básicos ===
+    info: (msg) => {
+        if (!quietMode)
+            console.log(chalk.blue('› ') + msg);
+    },
+    success: (msg) => {
+        if (!quietMode)
+            console.log(chalk.green('✔ ') + msg);
+    },
+    warning: (msg) => {
+        // Warnings siempre se muestran
+        console.log(chalk.yellow('⚠ ') + chalk.yellow(msg));
+    },
+    error: (msg) => {
+        // Errores siempre se muestran
+        console.log(chalk.red('✖ ') + chalk.red(msg));
+    },
+    skip: (msg) => {
+        if (!quietMode)
+            console.log(chalk.gray('›  ') + chalk.gray(msg));
+    },
+    // === Dry-run ===
+    dryRun: (msg) => {
+        if (!quietMode)
+            console.log(chalk.cyan('[DRY] ') + chalk.cyan(msg));
+    },
+    // === Headers decorativos ===
+    header: (title) => {
+        if (quietMode)
+            return;
+        const line = '─'.repeat(Math.max(40, title.length + 4));
+        console.log(chalk.blue(title));
+        console.log(chalk.gray(line));
+    },
+    logo: () => {
+        if (quietMode)
+            return;
+        console.log(chalk.blue(figlet.textSync('agent-ctx', {
+            font: 'Standard',
+            horizontalLayout: 'default',
+            verticalLayout: 'default'
+        })));
+    },
+    // === Secciones ===
+    section: (title) => {
+        if (!quietMode)
+            console.log('\n' + chalk.blue(`${title}`));
+    },
+    // === Línea separadora ===
+    divider: () => {
+        if (!quietMode)
+            console.log(chalk.gray('─'.repeat(50)));
+    },
+    // === Items de lista ===
+    item: (text, indent = 1) => {
+        if (quietMode)
+            return;
+        const padding = '   '.repeat(indent);
+        console.log(padding + chalk.gray('• ') + text);
+    },
+    // === Box de resumen ===
+    summary: (title, isSuccess = true) => {
+        if (quietMode)
+            return;
+        const color = isSuccess ? chalk.green : chalk.cyan;
+        const symbol = isSuccess ? '✔' : 'ℹ';
+        console.log('');
+        console.log(color(`${symbol} ${title}`));
+    },
+    // === Saltos de línea ===
+    newline: () => {
+        if (!quietMode)
+            console.log('');
+    },
+    // === Raw output (respeta quiet) ===
+    log: (msg) => {
+        if (!quietMode)
+            console.log(msg);
+    },
+    // === Clear console ===
+    clear: () => {
+        if (!quietMode) {
+            process.stdout.write('\x1Bc');
+        }
+    },
+    // === Box decorativo simplificado ===
+    box: (lines, color = 'blue') => {
+        if (quietMode)
+            return;
+        const colorFn = color === 'green' ? chalk.green : color === 'cyan' ? chalk.cyan : chalk.blue;
+        console.log('');
+        for (const line of lines) {
+            console.log(colorFn(`  ${line}`));
+        }
+        console.log('');
+    }
+};
+// === Spinners ===
+/**
+ * Crea un spinner con mensaje
+ */
+export function startSpinner(text) {
+    if (quietMode) {
+        return {
+            succeed: () => { },
+            fail: () => { },
+            warn: () => { },
+            stop: () => { },
+            text: ''
+        };
+    }
+    currentSpinner = ora({
+        text,
+        color: 'blue',
+        spinner: 'dots'
+    }).start();
+    return currentSpinner;
+}
+/**
+ * Detiene el spinner actual con éxito
+ */
+export function succeedSpinner(text) {
+    if (currentSpinner && !quietMode) {
+        currentSpinner.succeed(text);
+        currentSpinner = null;
+    }
+}
+/**
+ * Detiene el spinner actual con error
+ */
+export function failSpinner(text) {
+    if (currentSpinner) {
+        currentSpinner.fail(text);
+        currentSpinner = null;
+    }
+}
+/**
+ * Detiene el spinner actual con warning
+ */
+export function warnSpinner(text) {
+    if (currentSpinner) {
+        currentSpinner.warn(text);
+        currentSpinner = null;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAiB,MAAM,KAAK,CAAC;AACpC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,2BAA2B;AAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;AACtB,IAAI,cAAc,GAAe,IAAI,CAAC;AAEtC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,SAAS,GAAG,OAAO,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,SAAS,CAAC;AACnB,CAAC;AAUD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,2BAA2B;IAE3B,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC1B,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC7B,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC7B,+BAA+B;QAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC3B,8BAA8B;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC1B,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,kBAAkB;IAElB,MAAM,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC5B,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,8BAA8B;IAE9B,MAAM,EAAE,CAAC,KAAa,EAAQ,EAAE;QAC9B,IAAI,SAAS;YAAE,OAAO;QACtB,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,EAAE,GAAS,EAAE;QACf,IAAI,SAAS;YAAE,OAAO;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE;YAClD,IAAI,EAAE,UAAU;YAChB,gBAAgB,EAAE,SAAS;YAC3B,cAAc,EAAE,SAAS;SAC1B,CAAC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,oBAAoB;IAEpB,OAAO,EAAE,CAAC,KAAa,EAAQ,EAAE;QAC/B,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,2BAA2B;IAE3B,OAAO,EAAE,GAAS,EAAE;QAClB,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,yBAAyB;IAEzB,IAAI,EAAE,CAAC,IAAY,EAAE,SAAiB,CAAC,EAAQ,EAAE;QAC/C,IAAI,SAAS;YAAE,OAAO;QACtB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,yBAAyB;IAEzB,OAAO,EAAE,CAAC,KAAa,EAAE,YAAqB,IAAI,EAAQ,EAAE;QAC1D,IAAI,SAAS;YAAE,OAAO;QACtB,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACnD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAErC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,0BAA0B;IAE1B,OAAO,EAAE,GAAS,EAAE;QAClB,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,qCAAqC;IAErC,GAAG,EAAE,CAAC,GAAW,EAAQ,EAAE;QACzB,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,wBAAwB;IAExB,KAAK,EAAE,GAAS,EAAE;QAChB,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,sCAAsC;IAEtC,GAAG,EAAE,CAAC,KAAe,EAAE,QAAmC,MAAM,EAAQ,EAAE;QACxE,IAAI,SAAS;YAAE,OAAO;QACtB,MAAM,OAAO,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;CACF,CAAC;AAEF,mBAAmB;AAEnB;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;YACjB,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,IAAI,EAAE,EAAE;SACT,CAAC;IACJ,CAAC;IAED,cAAc,GAAG,GAAG,CAAC;QACnB,IAAI;QACJ,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC,KAAK,EAAE,CAAC;IAEX,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,IAAI,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,cAAc,GAAG,IAAI,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,IAAI,cAAc,EAAE,CAAC;QACnB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,cAAc,GAAG,IAAI,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,IAAI,cAAc,EAAE,CAAC;QACnB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,cAAc,GAAG,IAAI,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/lib/templates.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Manejo de templates embebidos para generación de archivos
+ * @module lib/templates
+ */
+import { type FileOperationOptions } from './utils.js';
+import { type SupportedLanguage } from './i18n.js';
+export interface TemplateMapping {
+    dest: string;
+    isRoot?: boolean;
+    name?: string;
+}
+/**
+ * Obtiene la ruta absoluta a un template, respetando el idioma actual
+ */
+export declare function getTemplatePath(name: string, lang?: SupportedLanguage): string;
+/**
+ * Lee el contenido de un template
+ */
+export declare function readTemplate(name: string, lang?: SupportedLanguage): string;
+/**
+ * Copia un template a la ruta de destino
+ */
+export declare function copyTemplate(name: string, destPath: string, options?: FileOperationOptions): boolean;
+/**
+ * Mapeo de templates disponibles a sus destinos
+ */
+export declare const TEMPLATE_MAPPINGS: Record<string, TemplateMapping>;
+/**
+ * Template opcional para bootstrap de IA (prompt de personalización)
+ */
+export declare const BOOTSTRAP_TEMPLATE: TemplateMapping;
+/**
+ * Templates de skills que se instalan siempre (estructura de carpetas con SKILL.md)
+ * Los skills base ayudan al agente a crear y mantener la estructura del proyecto
+ */
+export declare const BASE_SKILLS: Record<string, TemplateMapping>;
+/**
+ * Templates de skills opcionales que pueden instalarse (estructura de carpetas con SKILL.md)
+ */
+export declare const OPTIONAL_SKILLS: Record<string, TemplateMapping>;
+/**
+ * Templates de Memory Bank para persistencia de contexto
+ * Basado en el patrón Memory Bank de Cline/Roo Code
+ */
+export declare const MEMORY_BANK: Record<string, TemplateMapping>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/lib/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAY,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAYhE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAG9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAG3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAGxG;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAO7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAIhC,CAAC;AAGF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAMvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAK3D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAKvD,CAAC"}

package/dist/lib/templates.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Manejo de templates embebidos para generación de archivos
+ * @module lib/templates
+ */
+import { readFileSync, existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { copyFile } from './utils.js';
+import { getLanguage } from './i18n.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Templates are always in src/templates, whether code runs from src/ or dist/
+// From dist/lib/, we need to go ../../src/templates
+// From src/lib/, we need to go ../templates
+const srcTemplates = join(__dirname, '../../src/templates');
+const localTemplates = join(__dirname, '../templates');
+const TEMPLATES_DIR = existsSync(srcTemplates) ? srcTemplates : localTemplates;
+/**
+ * Obtiene la ruta absoluta a un template, respetando el idioma actual
+ */
+export function getTemplatePath(name, lang) {
+    const language = lang || getLanguage();
+    return join(TEMPLATES_DIR, language, name);
+}
+/**
+ * Lee el contenido de un template
+ */
+export function readTemplate(name, lang) {
+    const path = getTemplatePath(name, lang);
+    return readFileSync(path, 'utf-8');
+}
+/**
+ * Copia un template a la ruta de destino
+ */
+export function copyTemplate(name, destPath, options = {}) {
+    const srcPath = getTemplatePath(name);
+    return copyFile(srcPath, destPath, options);
+}
+/**
+ * Mapeo de templates disponibles a sus destinos
+ */
+export const TEMPLATE_MAPPINGS = {
+    'base/_agents.md': { dest: 'AGENTS.md', isRoot: true },
+    'base/_architecture.md': { dest: '.context/architecture.md' },
+    'base/_project_state.md': { dest: '.context/project_state.md' },
+    'rules/rule-coding-standards.md': { dest: '.context/rules/coding-standards.md' },
+    'docs/doc-readme.md': { dest: '.context/docs/README.md' },
+    'docs/mcp-readme.md': { dest: '.context/mcp/README.md' }
+};
+/**
+ * Template opcional para bootstrap de IA (prompt de personalización)
+ */
+export const BOOTSTRAP_TEMPLATE = {
+    dest: 'AI_BOOTSTRAP.md',
+    isRoot: true,
+    name: 'AI Bootstrap Prompt'
+};
+/**
+ * Templates de skills que se instalan siempre (estructura de carpetas con SKILL.md)
+ * Los skills base ayudan al agente a crear y mantener la estructura del proyecto
+ */
+export const BASE_SKILLS = {
+    'skills/skill-generating.md': { dest: '.context/skills/generating-skills/SKILL.md', name: 'Generating Skills' },
+    'skills/skill-agents.md': { dest: '.context/skills/managing-agents/SKILL.md', name: 'Managing Agents' },
+    'skills/skill-architecture.md': { dest: '.context/skills/documenting-architecture/SKILL.md', name: 'Documenting Architecture' },
+    'skills/skill-rules.md': { dest: '.context/skills/creating-rules/SKILL.md', name: 'Creating Rules' },
+    'skills/skill-project-state.md': { dest: '.context/skills/tracking-project-state/SKILL.md', name: 'Tracking Project State' }
+};
+/**
+ * Templates de skills opcionales que pueden instalarse (estructura de carpetas con SKILL.md)
+ */
+export const OPTIONAL_SKILLS = {
+    'skills/skill-react.md': { dest: '.context/skills/react-patterns/SKILL.md', name: 'React Patterns' },
+    'skills/skill-api.md': { dest: '.context/skills/api-design/SKILL.md', name: 'API Design' },
+    'skills/skill-testing.md': { dest: '.context/skills/testing-practices/SKILL.md', name: 'Testing Practices' },
+    'skills/skill-git.md': { dest: '.context/skills/git-workflow/SKILL.md', name: 'Git Workflow' }
+};
+/**
+ * Templates de Memory Bank para persistencia de contexto
+ * Basado en el patrón Memory Bank de Cline/Roo Code
+ */
+export const MEMORY_BANK = {
+    'memory/project_brief.md': { dest: '.context/memory/project_brief.md', name: 'Project Brief' },
+    'memory/tech_context.md': { dest: '.context/memory/tech_context.md', name: 'Tech Context' },
+    'memory/active_context.md': { dest: '.context/memory/active_context.md', name: 'Active Context' },
+    'memory/progress.md': { dest: '.context/memory/progress.md', name: 'Progress' }
+};
+//# sourceMappingURL=templates.js.map

package/dist/lib/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Utilidades comunes para operaciones de archivos y directorios
+ * @module lib/utils
+ */
+export interface FileOperationOptions {
+    force?: boolean;
+    dryRun?: boolean;
+    silent?: boolean;
+    backup?: boolean;
+}
+/**
+ * Resuelve y valida que un directorio exista
+ */
+export declare function resolveDirectory(dir?: string): string;
+/**
+ * Valida que no estemos en la raíz del sistema
+ */
+export declare function validateNotRoot(dir: string): boolean;
+/**
+ * Crea un directorio si no existe
+ */
+export declare function ensureDir(dir: string, options?: FileOperationOptions): boolean;
+/**
+ * Copia un archivo con opciones de force y backup
+ */
+export declare function copyFile(src: string, dest: string, options?: FileOperationOptions): boolean;
+/**
+ * Escribe contenido a un archivo con opciones de force y backup
+ */
+export declare function writeFile(path: string, content: string, options?: FileOperationOptions): boolean;
+/**
+ * Lista de carpetas de editores conocidas que pueden contener skills/rules
+ */
+export declare const EDITOR_FOLDERS: string[];
+/**
+ * Lista blanca de carpetas a preservar durante limpieza
+ */
+export declare const WHITELIST: string[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAY,GAAG,MAAM,CAQ1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAcpD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAclF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAkC/F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAuBpG;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,EAOlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,EAAoC,CAAC"}

package/dist/lib/utils.js

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview Utilidades comunes para operaciones de archivos y directorios
+ * @module lib/utils
+ */
+import { existsSync, mkdirSync, copyFileSync, writeFileSync } from 'fs';
+import { resolve, basename } from 'path';
+import { logger } from './logger.js';
+/**
+ * Resuelve y valida que un directorio exista
+ */
+export function resolveDirectory(dir = '.') {
+    const resolved = resolve(dir);
+    if (!existsSync(resolved)) {
+        throw new Error(`El directorio '${dir}' no existe.`);
+    }
+    return resolved;
+}
+/**
+ * Valida que no estemos en la raíz del sistema
+ */
+export function validateNotRoot(dir) {
+    const normalized = resolve(dir);
+    // Windows: C:\, D:\, etc.
+    if (/^[A-Z]:\\?$/i.test(normalized)) {
+        throw new Error('No se puede ejecutar en la raíz del sistema.');
+    }
+    // Unix: /
+    if (normalized === '/') {
+        throw new Error('No se puede ejecutar en la raíz del sistema.');
+    }
+    return true;
+}
+/**
+ * Crea un directorio si no existe
+ */
+export function ensureDir(dir, options = {}) {
+    const { dryRun = false, silent = false } = options;
+    if (existsSync(dir)) {
+        return false;
+    }
+    if (dryRun) {
+        if (!silent)
+            logger.dryRun(`Create dir: ${dir}`);
+        return true;
+    }
+    mkdirSync(dir, { recursive: true });
+    return true;
+}
+/**
+ * Copia un archivo con opciones de force y backup
+ */
+export function copyFile(src, dest, options = {}) {
+    const { force = false, dryRun = false, silent = false, backup = true } = options;
+    const name = basename(dest);
+    if (!existsSync(src)) {
+        logger.warning(`Template not found: ${src}`);
+        return false;
+    }
+    if (existsSync(dest) && !force) {
+        if (!silent)
+            logger.item(`${name} (exists, skipped)`);
+        return false;
+    }
+    if (dryRun) {
+        if (!silent)
+            logger.dryRun(`Copy: ${name}`);
+        return true;
+    }
+    // Create parent directories if needed (for skill folder structure)
+    const parentDir = dest.substring(0, dest.lastIndexOf('/'));
+    if (parentDir && !existsSync(parentDir)) {
+        mkdirSync(parentDir, { recursive: true });
+    }
+    // Crear backup si existe y hay force, y los backups están habilitados
+    if (existsSync(dest) && force && backup) {
+        copyFileSync(dest, `${dest}.bak`);
+        if (!silent)
+            logger.item(`${name}.bak (backup created)`);
+    }
+    copyFileSync(src, dest);
+    if (!silent)
+        logger.item(`+ ${name}`);
+    return true;
+}
+/**
+ * Escribe contenido a un archivo con opciones de force y backup
+ */
+export function writeFile(path, content, options = {}) {
+    const { force = false, dryRun = false, silent = false, backup = true } = options;
+    const name = basename(path);
+    if (existsSync(path) && !force) {
+        if (!silent)
+            logger.item(`${name} (exists, skipped)`);
+        return false;
+    }
+    if (dryRun) {
+        if (!silent)
+            logger.dryRun(`Create: ${name}`);
+        return true;
+    }
+    // Crear backup si existe y hay force, y los backups están habilitados
+    if (existsSync(path) && force && backup) {
+        copyFileSync(path, `${path}.bak`);
+        if (!silent)
+            logger.item(`${name}.bak (backup created)`);
+    }
+    writeFileSync(path, content, 'utf-8');
+    if (!silent)
+        logger.item(`+ ${name}`);
+    return true;
+}
+/**
+ * Lista de carpetas de editores conocidas que pueden contener skills/rules
+ */
+export const EDITOR_FOLDERS = [
+    '.agent', '.agents', '.cursor', '.windsurf', '.gemini', '.cline',
+    '.vscode', '.codebuddy', '.claude', '.adal', '.augment', '.codex',
+    '.commandcode', '.continue', '.copilot', '.factory', '.junie',
+    '.kilocode', '.kiro', '.kode', '.mcpjam', '.moltbot', '.mux',
+    '.neovate', '.openclaude', '.openhands', '.pochi', '.qoder',
+    '.qwen', '.roo', '.trae-cn', '.trae', '.vibe', '.zencoder'
+];
+/**
+ * Lista blanca de carpetas a preservar durante limpieza
+ */
+export const WHITELIST = ['.context', '.git', '.github'];
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"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"}

package/dist/lib/wizard.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Wizard interactivo para configuración de proyectos
+ * @module lib/wizard
+ */
+type ProjectType = 'frontend' | 'backend' | 'fullstack' | 'library' | 'cli';
+export interface ProjectConfig {
+    type: ProjectType;
+    framework: string;
+    typescript?: boolean;
+    styling?: string;
+    features?: string[];
+}
+/**
+ * Ejecuta el wizard interactivo para configurar el proyecto
+ */
+export declare function runWizard(): Promise<ProjectConfig>;
+/**
+ * Genera contenido de architecture.md basado en la configuración
+ */
+export declare function generateArchitecture(config: ProjectConfig): string;
+export {};
+//# sourceMappingURL=wizard.d.ts.map

package/dist/lib/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/lib/wizard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,KAAK,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AA4CD;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAgExD;AAuBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAiElE"}