@cristiancorreau/forge 2.1.0 → 2.3.0

package/dist/lib/wizard.js

@@ -0,0 +1,162 @@
+import { createInterface } from 'readline';
+const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: process.stdin.isTTY });
+function ask(question) {
+    return new Promise(resolve => rl.question(question, answer => resolve(answer.trim())));
+}
+function askWithDefault(question, def) {
+    return new Promise(resolve => rl.question(`${question} [${def}]: `, answer => {
+        const a = answer.trim();
+        resolve(a === '' ? def : a);
+    }));
+}
+function askChoice(question, choices, def) {
+    const choiceStr = choices.map((c, i) => `  ${i + 1}) ${c}`).join('\n');
+    const defIdx = def ? choices.indexOf(def) + 1 : 1;
+    return new Promise(resolve => {
+        console.log(`\n${question}`);
+        console.log(choiceStr);
+        rl.question(`Elegir [${defIdx}]: `, answer => {
+            const n = parseInt(answer.trim(), 10);
+            if (n >= 1 && n <= choices.length)
+                resolve(choices[n - 1]);
+            else
+                resolve(choices[defIdx - 1]);
+        });
+    });
+}
+function askMulti(question, choices) {
+    const choiceStr = choices.map((c, i) => `  ${i + 1}) ${c}`).join('\n');
+    return new Promise(resolve => {
+        console.log(`\n${question} (números separados por coma, ej: 1,3)`);
+        console.log(choiceStr);
+        rl.question('Elegir: ', answer => {
+            const selected = answer.trim().split(',')
+                .map(s => parseInt(s.trim(), 10) - 1)
+                .filter(i => i >= 0 && i < choices.length)
+                .map(i => choices[i]);
+            resolve(selected);
+        });
+    });
+}
+const BACKEND_BY_LANGUAGE = {
+    typescript: ['hono', 'express', 'nestjs', 'none'],
+    python: ['fastapi', 'django', 'none'],
+    ruby: ['rails', 'none'],
+    go: ['go-gin', 'none'],
+    php: ['laravel', 'none'],
+};
+const FRONTEND_BY_LANGUAGE = {
+    typescript: ['nextjs', 'astro', 'sveltekit', 'nuxt', 'none'],
+    php: ['none'],
+    ruby: ['rails-views', 'none'],
+    python: ['none'],
+    go: ['none'],
+};
+const DATABASE_OPTIONS = ['postgresql', 'mysql', 'sqlite', 'none'];
+const ORM_BY_LANGUAGE = {
+    typescript: ['drizzle', 'prisma', 'typeorm', 'none'],
+    python: ['sqlalchemy', 'none'],
+    ruby: ['active-record', 'none'],
+    php: ['none'],
+    go: ['none'],
+};
+const PM_BY_LANGUAGE = {
+    typescript: ['pnpm', 'npm', 'yarn', 'bun'],
+    python: ['pip', 'poetry'],
+    ruby: ['bundler'],
+    go: ['none'],
+    php: ['none'],
+};
+const TESTING_BY_LANGUAGE = {
+    typescript: ['vitest', 'jest', 'playwright', 'cypress'],
+    python: ['pytest'],
+    ruby: ['rspec'],
+    go: ['none'],
+    php: ['phpunit'],
+};
+const PROFILE_BY_STACK = {
+    hono: ['hono-drizzle'],
+    nextjs: ['nextjs-admin'],
+    astro: ['astro'],
+    fastapi: ['fastapi'],
+    rails: ['rails'],
+    laravel: ['laravel'],
+    expo: ['expo'],
+};
+const RUNTIME_OPTIONS = ['claude-code', 'opencode', 'codex', 'kiro'];
+function toSlug(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+}
+export async function runWizard() {
+    console.log('\n╔════════════════════════════════════╗');
+    console.log('║     forge — Asistente de inicio    ║');
+    console.log('╚════════════════════════════════════╝\n');
+    console.log('Responde las preguntas para configurar tu proyecto.\n');
+    const name = await ask('Nombre del proyecto: ');
+    if (!name) {
+        rl.close();
+        return null;
+    }
+    const slugDefault = toSlug(name);
+    const slug = await askWithDefault('Slug (identificador URL-safe)', slugDefault);
+    const description = await askWithDefault('Descripción breve', '');
+    const language = await askChoice('Lenguaje principal:', ['typescript', 'python', 'ruby', 'go', 'php'], 'typescript');
+    const mode = await askChoice('Modo del proyecto:', ['startup  — mínimo viable, equipo pequeño', 'standard  — equipo mediano, CI/CD, revisión de código', 'enterprise  — compliance, auditoría, múltiples equipos'], 'startup  — mínimo viable, equipo pequeño');
+    const modeValue = mode.split('  ')[0];
+    const backends = BACKEND_BY_LANGUAGE[language] ?? ['none'];
+    const backendChoice = backends.length > 1
+        ? await askChoice('Backend:', backends, backends[0])
+        : backends[0];
+    const backend = backendChoice === 'none' ? undefined : backendChoice;
+    const frontends = FRONTEND_BY_LANGUAGE[language] ?? ['none'];
+    const frontendChoice = frontends.length > 1
+        ? await askChoice('Frontend:', frontends, frontends[0])
+        : frontends[0];
+    const frontend = frontendChoice === 'none' ? undefined : frontendChoice;
+    const dbChoice = await askChoice('Base de datos:', DATABASE_OPTIONS, 'postgresql');
+    const database = dbChoice === 'none' ? undefined : dbChoice;
+    let orm;
+    if (database) {
+        const orms = ORM_BY_LANGUAGE[language] ?? ['none'];
+        if (orms.length > 1) {
+            const ormChoice = await askChoice('ORM / query builder:', orms, orms[0]);
+            orm = ormChoice === 'none' ? undefined : ormChoice;
+        }
+    }
+    const pms = PM_BY_LANGUAGE[language] ?? ['none'];
+    const pmChoice = pms.length > 1
+        ? await askChoice('Package manager:', pms, pms[0])
+        : pms[0];
+    const packageManager = pmChoice === 'none' ? undefined : pmChoice;
+    const testingOptions = TESTING_BY_LANGUAGE[language] ?? [];
+    let testing = [];
+    if (testingOptions.length > 0 && testingOptions[0] !== 'none') {
+        testing = await askMulti('Frameworks de testing:', testingOptions);
+    }
+    // Auto-suggest profiles based on stack
+    const suggestedProfiles = [];
+    for (const [key, profiles] of Object.entries(PROFILE_BY_STACK)) {
+        if (backend === key || frontend === key)
+            suggestedProfiles.push(...profiles);
+    }
+    const runtime = await askChoice('Runtime de IA principal:', RUNTIME_OPTIONS, 'claude-code');
+    rl.close();
+    // Build profiles list from suggestions
+    const profiles = [...new Set(suggestedProfiles)];
+    return {
+        name,
+        slug,
+        description,
+        language,
+        mode: modeValue,
+        backend,
+        frontend,
+        database,
+        orm,
+        packageManager,
+        testing,
+        profiles,
+        runtime,
+    };
+}
+//# sourceMappingURL=wizard.js.map

package/dist/lib/wizard.js.map

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

package/dist/lib/yaml.d.ts

@@ -0,0 +1,96 @@
+export interface ProjectStack {
+    backend?: string;
+    frontend?: string;
+    database?: string;
+    orm?: string;
+    package_manager?: string;
+    monorepo?: string;
+    testing?: string[];
+}
+export interface ProjectAgents {
+    active?: string[];
+    compliance?: string[];
+    profiles?: string[];
+    specialized?: string[];
+    by_role?: Record<string, string | null>;
+}
+export interface ProjectDeploy {
+    provider?: string;
+    production_url?: string;
+    smoke_tests?: Array<{
+        url: string;
+        expect_status?: number;
+        expect_json?: Record<string, unknown>;
+    }>;
+}
+export interface ProjectRules {
+    forbidden_in_production?: string[];
+    forbidden_patterns?: string[];
+    required_review_before_ship?: boolean;
+    require_spec_before_implementation?: boolean;
+    conventional_commits?: boolean;
+}
+export interface ProjectCompliance {
+    frameworks?: string[];
+    pii_handling?: boolean;
+    audit_logs?: boolean;
+}
+export interface ProjectGithub {
+    project?: {
+        number?: number;
+        owner?: string;
+        repo?: string;
+    };
+}
+export interface ProjectSprint {
+    current?: number;
+    phases?: Array<{
+        id: number;
+        name: string;
+        specs?: string[];
+        status?: string;
+    }>;
+}
+export interface ProjectPaths {
+    api?: string;
+    frontend?: string;
+    admin?: string;
+    mobile?: string;
+    specs?: string;
+    progress?: string;
+    tests?: string;
+    scanner?: string;
+    migrations?: string;
+}
+export interface ProjectYaml {
+    project: {
+        name: string;
+        slug?: string;
+        description?: string;
+        language?: string;
+        mode: 'startup' | 'standard' | 'enterprise';
+        status?: string;
+    };
+    stack?: ProjectStack;
+    agents?: ProjectAgents;
+    deploy?: ProjectDeploy;
+    rules?: ProjectRules;
+    compliance?: ProjectCompliance;
+    github?: ProjectGithub;
+    sprint?: ProjectSprint;
+    paths?: ProjectPaths;
+    runtimes?: {
+        active?: string[];
+    };
+    mcp?: {
+        servers?: Array<{
+            name: string;
+            auto_approve?: string[];
+        }>;
+    };
+    scripts?: Record<string, string>;
+}
+export declare function findProjectYaml(start?: string): string | null;
+export declare function loadProjectYaml(path: string): ProjectYaml;
+export declare function projectRoot(yamlPath: string): string;
+//# sourceMappingURL=yaml.d.ts.map

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

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

package/dist/lib/yaml.js

@@ -0,0 +1,26 @@
+import { readFileSync, existsSync } from 'fs';
+import { dirname, join } from 'path';
+import yaml from 'js-yaml';
+export function findProjectYaml(start = process.cwd()) {
+    let current = start;
+    while (true) {
+        const candidate = join(current, 'project.yaml');
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+export function loadProjectYaml(path) {
+    const content = readFileSync(path, 'utf-8');
+    const data = yaml.load(content);
+    if (!data || typeof data !== 'object')
+        throw new Error('project.yaml está vacío o no es un objeto YAML válido');
+    return data;
+}
+export function projectRoot(yamlPath) {
+    return dirname(yamlPath);
+}
+//# sourceMappingURL=yaml.js.map

package/dist/lib/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/lib/yaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,IAAI,MAAM,SAAS,CAAC;AAmF3B,MAAM,UAAU,eAAe,CAAC,QAAgB,OAAO,CAAC,GAAG,EAAE;IAC3D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAChD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAgB,CAAC;IAC/C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAChH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cristiancorreau/forge",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Agentic development framework — multi-runtime support for Claude Code, OpenCode, Codex and Kiro",
   "author": "Cristian Correa <cristian@socialweb.cl>",
   "license": "Apache-2.0",
@@ -37,10 +37,16 @@
     "CHANGELOG.md"
   ],
   "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.0.0",
     "typescript": "^5.4.0"
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "js-yaml": "^4.2.0"
   }
 }