@cristiancorreau/forge 2.16.0 → 2.17.0

package/CHANGELOG.md

@@ -7,6 +7,13 @@ Versioning: [Semantic Versioning](https://semver.org/lang/es/)
 
 ---
 
+## [2.17.0] — 2026-06-04
+
+### Agregado
+- **`forge adopt [path]` — onboarding de forge en un repo existente (brownfield).** Lee y analiza un codebase ya existente (sin LLM), genera el `project.yaml` desde lo que detecta (stack vía `detect.ts` con lenguaje por lado, `project.type`, ORM, testing, monorepo, docker), instala la config de forge reusando los installers de `forge init` (agentes por modo, hooks, slash commands, CLAUDE.md, settings.json, architecture.rules, manifest `.forge`) sin pisar archivos existentes salvo `--force`, y **auto-genera el wiki del proyecto** con HECHOS determinísticos: `concepts/arquitectura.md` y `concepts/stack.md` (del mapa de directorios + stack), `entities/` (proyecto + cada framework/herramienta detectada), `sources/` (resumen de README + manifest), `synthesis/overview.md` (resumen factual + nota "Pendiente: compilación semántica con /wiki-ingest") y `raw/` con copias inmutables del README + manifest. El wiki generado pasa `forge wiki lint` (sin links rotos ni huérfanos). La capa SEMÁNTICA (lógica de negocio, decisiones) sigue siendo trabajo del skill `/wiki-ingest`, que `adopt` apunta como próximo paso. Flags: `--yes` (no-interactivo por defecto), `--no-wiki`, `--runtime`, `--mode`, `--force`, `--dry-run`. Módulos puros y testeados: `lib/project-analysis.ts` y `lib/wiki-autogen.ts` (SPEC-038).
+
+---
+
 ## [2.16.0] — 2026-06-04
 
 ### Agregado

package/assets/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "forge",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "Agentic development framework for Claude Code, OpenCode, Codex and Kiro",
   "license": "Apache-2.0",
   "repository": "https://github.com/cristiancorreau/forge",

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { init } from './commands/init.js';
+import { adopt } from './commands/adopt.js';
 import { audit } from './commands/audit.js';
 import { generate } from './commands/generate.js';
 import { validate } from './commands/validate.js';
@@ -21,6 +22,7 @@ Usage: forge <command> [options]
 Setup
   panel          Open the interactive panel (config, monitor, skills, hooks, templates)
   init           Initialize forge in a project (wizard + post-install dashboard)
+  adopt          Onboard forge into an EXISTING codebase (analyze + auto-wiki)
   generate       Generate runtime config files from project.yaml
   migrate        Migrate project.yaml from the v1 schema to v2 (--dry-run, --backup)
   scaffold       Scaffold a new agent: Tier 2 profile, or Tier 3 domain agent (--tier 3)
@@ -48,6 +50,7 @@ Run forge <command> --help for command-specific options.
 
 Examples:
   npx @cristiancorreau/forge init
+  npx @cristiancorreau/forge adopt ./my-existing-repo --yes
   npx @cristiancorreau/forge panel
   npx @cristiancorreau/forge skills
   npx @cristiancorreau/forge migrate --dry-run
@@ -60,6 +63,9 @@ switch (cmd) {
     case 'init':
         exitCode = await init(rest);
         break;
+    case 'adopt':
+        exitCode = await adopt(rest);
+        break;
     case 'audit':
         exitCode = await audit(rest);
         break;

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,IAAI,GAAG,UAAU,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuC7B,CAAC;AAEF,MAAM,CAAC,EAAE,AAAD,EAAG,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAExC,IAAI,QAAQ,GAAG,CAAC,CAAC;AAEjB,QAAQ,GAAG,EAAE,CAAC;IACZ,KAAK,MAAM;QACT,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM;IACR,KAAK,OAAO;QACV,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM;IACR,KAAK,UAAU;QACb,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM;IACR,KAAK,UAAU;QACb,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM;IACR,KAAK,QAAQ;QACX,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM;IACR,KAAK,SAAS;QACZ,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM;IACR,KAAK,MAAM;QACT,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM;IACR,KAAK,QAAQ;QACX,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM;IACR,KAAK,eAAe;QAClB,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM;IACR,KAAK,UAAU;QACb,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM;IACR,KAAK,UAAU;QACb,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM;IACR,KAAK,eAAe;QAClB,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM;IACR,KAAK,eAAe;QAClB,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM;IACR,KAAK,OAAO;QACV,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM;IACR,KAAK,IAAI,CAAC;IACV,KAAK,WAAW;QACd,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,MAAM;IACR,KAAK,SAAS;QACZ,yEAAyE;QACzE,4EAA4E;QAC5E,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YACnC,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM;IACR,KAAK,IAAI,CAAC;IACV,KAAK,QAAQ;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM;IACR;QACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,iCAAiC,CAAC,CAAC;QACxE,QAAQ,GAAG,CAAC,CAAC;AACjB,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/adopt.d.ts

@@ -0,0 +1,2 @@
+export declare function adopt(args: string[]): Promise<number>;
+//# sourceMappingURL=adopt.d.ts.map

package/dist/commands/adopt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/commands/adopt.ts"],"names":[],"mappings":"AAwLA,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+G3D"}

package/dist/commands/adopt.js

@@ -0,0 +1,259 @@
+/**
+ * `forge adopt [path]` — onboard forge into an EXISTING codebase (brownfield).
+ *
+ * Unlike `forge init` (greenfield wizard), adopt READS the target project, infers
+ * its configuration by static analysis, and materializes everything non-
+ * interactively: project.yaml + the forge config (.claude/, CLAUDE.md, settings,
+ * architecture.rules, manifest) + an auto-generated FACTUAL wiki.
+ *
+ * The wiki it seeds is deterministic facts only (stack, structure, dependencies,
+ * scripts, README summary). The deep SEMANTIC compilation stays the job of the
+ * /wiki-ingest skill, which adopt points to as the explicit next step.
+ *
+ * It reuses init's exported installers so the installed config is identical to
+ * `forge init`, and never clobbers existing files unless --force.
+ */
+import { existsSync, mkdirSync, writeFileSync, statSync } from 'fs';
+import { join, resolve } from 'path';
+import { resolveForgeRoot } from '../lib/paths.js';
+import { generateClaudeMd } from '../lib/generators/claude-code.js';
+import { generateAgentsMd } from '../lib/generators/opencode.js';
+import { generateCodexAgentsMd } from '../lib/generators/codex.js';
+import { scaffoldWikiStructure } from './wiki.js';
+import { analyzeProject, slugify } from '../lib/project-analysis.js';
+import { generateWiki } from '../lib/wiki-autogen.js';
+import { languageLabel, deriveProjectLanguage, hasBackend, hasFrontend } from '../lib/wizard-flow.js';
+import { VERSION } from '../version.js';
+import { defaultAgentsForMode, installCoreAgents, installHooks, installCommands, writeSettingsJson, installSpecScaffold, saveInstallManifest, write, buildProjectYaml, } from './init.js';
+import { bold, dim, green, cyan, gray, yellow, icons } from '../ui/colors.js';
+import { box } from '../ui/box.js';
+const HELP = `Usage: forge adopt [path] [options]
+
+Onboard forge into an EXISTING codebase. Analyzes the project, generates
+project.yaml from what it detects, installs the forge config, and seeds the
+project wiki with FACTUAL knowledge (stack, structure, dependencies, scripts,
+README). Non-interactive by default.
+
+Arguments:
+  path               Target project directory (default: current directory)
+
+Options:
+  --yes              Non-interactive (default — no prompts)
+  --no-wiki          Skip the auto-generated wiki
+  --runtime <name>   Runtime: claude-code (default), opencode, codex
+  --mode <mode>      Mode: startup, standard (default), enterprise
+  --force            Overwrite existing files instead of preserving them
+  --dry-run          Analyze + print the plan; write nothing
+  -h, --help         Show this help
+
+The wiki adopt seeds is deterministic FACTS. The deep semantic compilation
+(business logic, decisions) is the job of /wiki-ingest — adopt prints it as the
+next step.
+`;
+function flagValue(args, flag) {
+    const i = args.indexOf(flag);
+    return i !== -1 ? (args[i + 1] ?? null) : null;
+}
+function parseOptions(args) {
+    // First non-flag arg (not a flag value) is the target path.
+    const flagsWithValue = new Set(['--runtime', '--mode']);
+    let target = process.cwd();
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('-')) {
+            if (flagsWithValue.has(arg))
+                i++; // skip its value
+            continue;
+        }
+        target = resolve(arg);
+        break;
+    }
+    const modeRaw = flagValue(args, '--mode');
+    const mode = modeRaw === 'startup' || modeRaw === 'enterprise' ? modeRaw : 'standard';
+    return {
+        target,
+        runtime: flagValue(args, '--runtime') ?? 'claude-code',
+        mode,
+        wiki: !args.includes('--no-wiki'),
+        force: args.includes('--force'),
+        dryRun: args.includes('--dry-run'),
+    };
+}
+/** Map a ProjectAnalysis to a WizardResult so buildProjectYaml can render YAML. */
+function analysisToWizardResult(a, opts) {
+    const s = a.stack;
+    // Per-side language falls back to the base detected language when no framework
+    // was matched on that side (e.g. a Python backend whose framework isn't in
+    // detect.ts still has a Python backend language, not the TS default).
+    const backendLanguage = s.backendLanguage
+        ?? (hasBackend(a.type) ? (s.language ?? undefined) : undefined)
+        ?? undefined;
+    const frontendLanguage = s.frontendLanguage
+        ?? (hasFrontend(a.type) ? 'typescript' : undefined)
+        ?? undefined;
+    const language = deriveProjectLanguage({ type: a.type, backendLanguage, frontendLanguage });
+    // Auto-detect profiles from the detected frameworks (mirrors the wizard).
+    const PROFILE_MAP = {
+        hono: 'hono-drizzle', nextjs: 'nextjs-admin', astro: 'astro',
+        fastapi: 'fastapi', rails: 'rails', laravel: 'laravel',
+    };
+    const profiles = [];
+    for (const key of [s.backend, s.frontend]) {
+        if (key && PROFILE_MAP[key])
+            profiles.push(PROFILE_MAP[key]);
+    }
+    return {
+        name: a.name,
+        slug: slugify(a.name),
+        description: a.description || '',
+        language,
+        type: a.type,
+        backendLanguage,
+        frontendLanguage,
+        mode: opts.mode,
+        backend: s.backend ?? undefined,
+        frontend: s.frontend ?? undefined,
+        database: s.database ?? undefined,
+        orm: s.orm ?? undefined,
+        packageManager: s.packageManager ?? undefined,
+        testing: s.testing,
+        profiles: [...new Set(profiles)],
+        skills: ['wiki-ingest', 'wiki-query', 'wiki-lint'],
+        runtime: opts.runtime,
+        detected: true,
+    };
+}
+/** Build the in-memory ProjectYaml config (matches init's config shape). */
+function buildConfig(result) {
+    return {
+        project: {
+            name: result.name, slug: result.slug, description: result.description,
+            language: result.language, type: result.type, mode: result.mode, status: 'active',
+        },
+        stack: {
+            backend: result.backend, backend_language: result.backendLanguage,
+            frontend: result.frontend, frontend_language: result.frontendLanguage,
+            database: result.database, orm: result.orm,
+            package_manager: result.packageManager, testing: result.testing,
+        },
+        agents: { active: defaultAgentsForMode(result.mode), compliance: [], specialized: [], profiles: result.profiles },
+        runtimes: { active: [result.runtime] },
+        skills: result.skills,
+    };
+}
+function printDetectedSummary(a) {
+    const s = a.stack;
+    const lines = [];
+    lines.push(`${bold('Proyecto')}: ${a.name}${a.description ? gray(` — ${a.description}`) : ''}`);
+    lines.push(`${bold('Tipo')}: ${a.type}   ${bold('Lenguaje')}: ${a.stack.language ? languageLabel(a.stack.language) : '—'}   ${bold('Ecosistema')}: ${a.ecosystem}`);
+    if (s.backend)
+        lines.push(`${bold('Backend')}: ${s.backend}${s.backendLanguage ? ` (${s.backendLanguage})` : ''}`);
+    if (s.frontend)
+        lines.push(`${bold('Frontend')}: ${s.frontend}${s.frontendLanguage ? ` (${s.frontendLanguage})` : ''}`);
+    if (s.database || s.orm)
+        lines.push(`${bold('Datos')}: ${[s.database, s.orm].filter(Boolean).join(' + ') || '—'}`);
+    if (s.testing.length)
+        lines.push(`${bold('Testing')}: ${s.testing.join(', ')}`);
+    if (s.packageManager)
+        lines.push(`${bold('Package manager')}: ${s.packageManager}`);
+    lines.push(`${bold('Directorios')}: ${a.directories.slice(0, 6).map(d => `${d.name}/ (${d.fileCount})`).join('  ') || '—'}`);
+    if (a.entrypoints.length)
+        lines.push(`${bold('Entrypoints')}: ${a.entrypoints.slice(0, 4).join(', ')}`);
+    if (a.git.remote)
+        lines.push(`${bold('Git')}: ${a.git.remote}${a.git.branch ? ` @ ${a.git.branch}` : ''}`);
+    console.log('\n' + box(cyan('Proyecto detectado'), lines));
+}
+export async function adopt(args) {
+    if (args.includes('-h') || args.includes('--help')) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    const opts = parseOptions(args);
+    console.log(cyan(bold('forge adopt')) + dim(`  ${opts.target}`) + '\n');
+    if (!existsSync(opts.target) || !statSync(opts.target).isDirectory()) {
+        console.error(`  ${icons.error} El target no existe o no es un directorio: ${opts.target}\n`);
+        return 1;
+    }
+    // 1. Analyze the existing project (never throws).
+    const analysis = analyzeProject(opts.target);
+    printDetectedSummary(analysis);
+    const result = analysisToWizardResult(analysis, opts);
+    const config = buildConfig(result);
+    // --- dry-run: print the plan, write nothing ---
+    if (opts.dryRun) {
+        const plan = [
+            `project.yaml  ${gray('(generado del análisis)')}`,
+            ...(opts.runtime === 'claude-code' ? [
+                `.claude/agents/  ${gray(`${config.agents?.active?.length ?? 0} agents (${opts.mode})`)}`,
+                '.claude/hooks/  ' + gray('guardrails'),
+                '.claude/commands/  ' + gray('slash commands'),
+                'CLAUDE.md  ' + gray('generado'),
+                '.claude/settings.json  ' + gray('permisos + hooks'),
+                '.claude/architecture.rules + docs/specs/',
+                '.forge/manifest.json',
+            ] : [`${opts.runtime}: AGENTS.md  ${gray('generado')}`]),
+            ...(opts.wiki ? [`wiki/  ${gray('poblado (hechos) — semántica vía /wiki-ingest')}`] : []),
+        ];
+        console.log('\n' + box(yellow('Plan (--dry-run, no escribe nada)'), plan));
+        console.log(dim('\n  Ejecutá sin --dry-run para aplicar.\n'));
+        return 0;
+    }
+    // 2. Write project.yaml (preserve existing unless --force).
+    const projectYamlPath = join(opts.target, 'project.yaml');
+    const created = [];
+    if (!existsSync(projectYamlPath) || opts.force) {
+        writeFileSync(projectYamlPath, buildProjectYaml(result, []), 'utf-8');
+        created.push('project.yaml');
+    }
+    else {
+        console.log(dim('  project.yaml ya existe — se conserva (usá --force para sobrescribir).'));
+    }
+    // 3. Install the forge config, reusing init's exported installers.
+    const forgeRoot = resolveForgeRoot();
+    if (opts.runtime === 'claude-code') {
+        const claudeDir = join(opts.target, '.claude');
+        mkdirSync(claudeDir, { recursive: true });
+        const activeAgents = config.agents?.active ?? [];
+        const profiles = config.agents?.profiles ?? [];
+        installCoreAgents(forgeRoot, join(claudeDir, 'agents'), activeAgents, profiles, opts.force);
+        installHooks(forgeRoot, join(claudeDir, 'hooks'), opts.mode, opts.force);
+        installCommands(forgeRoot, join(claudeDir, 'commands'), opts.force);
+        write(join(opts.target, 'CLAUDE.md'), generateClaudeMd(config), opts.force);
+        writeSettingsJson(join(claudeDir, 'settings.json'), config.project.language ?? 'typescript', opts.mode, opts.force);
+        installSpecScaffold(forgeRoot, opts.target, claudeDir, config);
+        saveInstallManifest(opts.target, claudeDir, opts.runtime, activeAgents, [], VERSION);
+        created.push('.claude/ (agents, hooks, commands, settings.json, architecture.rules)', 'CLAUDE.md', 'docs/specs/', '.forge/manifest.json');
+    }
+    else if (opts.runtime === 'opencode') {
+        mkdirSync(join(opts.target, '.opencode'), { recursive: true });
+        write(join(opts.target, 'AGENTS.md'), generateAgentsMd(config), opts.force);
+        created.push('AGENTS.md');
+    }
+    else if (opts.runtime === 'codex') {
+        write(join(opts.target, 'AGENTS.md'), generateCodexAgentsMd(config), opts.force);
+        created.push('AGENTS.md');
+    }
+    // 4. Auto-generate the wiki (factual) unless --no-wiki.
+    let wikiResult = null;
+    if (opts.wiki) {
+        scaffoldWikiStructure(opts.target, false);
+        wikiResult = generateWiki(analysis);
+        created.push(`wiki/ (${wikiResult.pages.length} páginas, ${wikiResult.rawSources.length} fuentes en raw/)`);
+    }
+    // 5. Summary + next steps.
+    console.log('\n' + box(green(`forge adoptado — ${opts.runtime}`), created.map(c => `${icons.ok} ${c}`)));
+    const rawList = wikiResult?.rawSources.length
+        ? wikiResult.rawSources.map(r => `wiki/raw/${r}`)
+        : [];
+    const nextSteps = [];
+    if (opts.wiki) {
+        nextSteps.push(`${cyan('/wiki-ingest')} ${dim('— compilá la capa semántica desde las fuentes:')}`, ...rawList.map(r => `    ${dim(r)}`));
+    }
+    nextSteps.push(`${cyan('forge audit')} ${dim('— verificá el proyecto contra el estándar forge')}`, `${cyan('forge panel')} ${dim('— panel interactivo (config, monitor, skills)')}`);
+    console.log('\n' + bold('  Próximos pasos:'));
+    for (const step of nextSteps)
+        console.log(`    ${step}`);
+    console.log('');
+    return 0;
+}
+//# sourceMappingURL=adopt.js.map

package/dist/commands/adopt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../src/commands/adopt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACpE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAwB,MAAM,4BAA4B,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,oBAAoB,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EACtE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,KAAK,EAClE,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAInC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBZ,CAAC;AAWF,SAAS,SAAS,CAAC,IAAc,EAAE,IAAY;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,SAAS,YAAY,CAAC,IAAc;IAClC,4DAA4D;IAC5D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxD,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,CAAC,EAAE,CAAC,CAAC,iBAAiB;YACnD,SAAS;QACX,CAAC;QACD,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM;IACR,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,IAAI,GACR,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IAE3E,OAAO;QACL,MAAM;QACN,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,aAAa;QACtD,IAAI;QACJ,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QACjC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC/B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,SAAS,sBAAsB,CAAC,CAAkB,EAAE,IAAkB;IACpE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IAClB,+EAA+E;IAC/E,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,eAAe,GAAG,CAAC,CAAC,eAAe;WACpC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;WAC5D,SAAS,CAAC;IACf,MAAM,gBAAgB,GAAG,CAAC,CAAC,gBAAgB;WACtC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;WAChD,SAAS,CAAC;IACf,MAAM,QAAQ,GAAG,qBAAqB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAE5F,0EAA0E;IAC1E,MAAM,WAAW,GAA2B;QAC1C,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO;QAC5D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS;KACvD,CAAC;IACF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,IAAI,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACrB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;QAChC,QAAQ;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,eAAe;QACf,gBAAgB;QAChB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,SAAS;QAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,SAAS;QACjC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,SAAS;QACjC,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,SAAS;QACvB,cAAc,EAAE,CAAC,CAAC,cAAc,IAAI,SAAS;QAC7C,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,CAAC;QAClD,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,SAAS,WAAW,CAAC,MAAoB;IACvC,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW;YACrE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ;SAClF;QACD,KAAK,EAAE;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,eAAe;YACjE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,MAAM,CAAC,gBAAgB;YACrE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG;YAC1C,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO;SAChE;QACD,MAAM,EAAE,EAAE,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;QACjH,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QACtC,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,CAAkB;IAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IAClB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChG,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IACpK,IAAI,CAAC,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnH,IAAI,CAAC,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxH,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACnH,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,CAAC,cAAc;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC7H,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxG,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE3G,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAc;IACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEhC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAExE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,KAAK,+CAA+C,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAC9F,OAAO,CAAC,CAAC;IACX,CAAC;IAED,kDAAkD;IAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7C,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAE/B,MAAM,MAAM,GAAG,sBAAsB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEnC,iDAAiD;IACjD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,IAAI,GAAa;YACrB,iBAAiB,IAAI,CAAC,yBAAyB,CAAC,EAAE;YAClD,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnC,oBAAoB,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE;gBACzF,kBAAkB,GAAG,IAAI,CAAC,YAAY,CAAC;gBACvC,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,CAAC;gBAC9C,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC;gBAChC,yBAAyB,GAAG,IAAI,CAAC,kBAAkB,CAAC;gBACpD,0CAA0C;gBAC1C,sBAAsB;aACvB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,gBAAgB,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,+CAA+C,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1F,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,mCAAmC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3E,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,4DAA4D;IAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/C,aAAa,CAAC,eAAe,EAAE,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,mEAAmE;IACnE,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IAErC,IAAI,IAAI,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC/C,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC;QAE/C,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5F,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzE,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5E,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACpH,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC/D,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QAErF,OAAO,CAAC,IAAI,CAAC,uEAAuE,EAAE,WAAW,EAAE,aAAa,EAAE,sBAAsB,CAAC,CAAC;IAC5I,CAAC;SAAM,IAAI,IAAI,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACvC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;SAAM,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,wDAAwD;IACxD,IAAI,UAAU,GAAqD,IAAI,CAAC;IACxE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1C,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,UAAU,UAAU,CAAC,KAAK,CAAC,MAAM,aAAa,UAAU,CAAC,UAAU,CAAC,MAAM,mBAAmB,CAAC,CAAC;IAC9G,CAAC;IAED,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzG,MAAM,OAAO,GAAG,UAAU,EAAE,UAAU,CAAC,MAAM;QAC3C,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;QACjD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,SAAS,CAAC,IAAI,CACZ,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,gDAAgD,CAAC,EAAE,EAClF,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACrC,CAAC;IACJ,CAAC;IACD,SAAS,CAAC,IAAI,CACZ,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,iDAAiD,CAAC,EAAE,EAClF,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,+CAA+C,CAAC,EAAE,CACjF,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/init.d.ts

@@ -1,4 +1,43 @@
 import { runWizard } from '../lib/wizard.js';
-export declare function buildProjectYaml(result: Awaited<ReturnType<typeof runWizard>>, specialized?: string[]): string;
+import type { ProjectYaml } from '../lib/yaml.js';
+export declare function write(path: string, content: string, force: boolean): void;
+/**
+ * Auto-detecta agentes Tier 3 existentes: escanea .claude/agents/*.md en `root`
+ * y devuelve los nombres cuyo frontmatter declara `tier: 3`. Sirve para poblar
+ * agents.specialized en project.yaml durante `forge init`.
+ */
+export declare function detectTier3Agents(root: string): string[];
+/**
+ * Lista los archivos instalados en `<claudeDir>/<subdir>` (p. ej. hooks/ o
+ * commands/) como rutas RELATIVAS a `projectRoot`, usando separadores `/` para
+ * que el manifest sea estable entre plataformas. Devuelve [] si el dir no existe.
+ * Recorre subdirectorios (los slash commands pueden estar anidados).
+ */
+export declare function listInstalledRelativeFiles(claudeDir: string, subdir: string, projectRoot: string): string[];
+export declare function buildProjectYaml(result: Awaited<ReturnType<typeof runWizard>> | null, specialized?: string[]): string;
+export declare function defaultAgentsForMode(mode: string): string[];
+export declare function installCoreAgents(forgeRoot: string, destDir: string, activeAgents: string[], profiles: string[], force: boolean): void;
+export declare function installHooks(forgeRoot: string, destDir: string, mode: string, force: boolean): void;
+/**
+ * Escribe `.claude/settings.json`. Si el archivo ya existe (y es JSON válido),
+ * mezcla preservando keys externas (`env`, etc.) y permisos previos. Si no
+ * existe o no se puede parsear, escribe los settings generados tal cual.
+ * Respeta `force`: con `force=false` no toca un archivo existente.
+ */
+export declare function writeSettingsJson(path: string, language: string, mode: string, force: boolean): void;
+export declare function installCommands(forgeRoot: string, destDir: string, force: boolean): void;
+/**
+ * Scaffolds docs/specs/ (+ _template.md), docs/daily-notes/ and the
+ * .claude/architecture.rules file. Idempotent: never overwrites the spec
+ * template or architecture.rules once they exist. Shared by `forge init` and
+ * `forge adopt` so both lay down the same SDD scaffold.
+ */
+export declare function installSpecScaffold(forgeRoot: string, projectRoot: string, claudeDir: string, config: ProjectYaml): void;
+/**
+ * Builds and saves the .forge/manifest.json for a claude-code install: tracks
+ * CLAUDE.md, settings.json, architecture.rules, all agents (active + compliance
+ * + specialized) and the installed hooks/commands. Shared by init and adopt.
+ */
+export declare function saveInstallManifest(projectRoot: string, claudeDir: string, runtime: string, allAgents: string[], specializedAgents: string[], forgeVersion: string): void;
 export declare function init(args: string[]): Promise<number>;
 //# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA0I7C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,MAAM,CAwDlH;AAiLD,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmP1D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA2C7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA4BlD,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAGzE;AAiBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBxD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAa3G;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,GAAG,IAAI,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,MAAM,CAwDzH;AAYD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI3D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAsBtI;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAqBnG;AAiED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAiBpG;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKxF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAaxH;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EACvD,SAAS,EAAE,MAAM,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GACrE,IAAI,CAYN;AAmBD,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwN1D"}

package/dist/commands/init.js

@@ -61,7 +61,7 @@ Options:
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-function write(path, content, force) {
+export function write(path, content, force) {
     if (existsSync(path) && !force)
         return;
     writeFileSync(path, content, 'utf-8');
@@ -88,7 +88,7 @@ function copyDir(src, dest, force) {
  * y devuelve los nombres cuyo frontmatter declara `tier: 3`. Sirve para poblar
  * agents.specialized en project.yaml durante `forge init`.
  */
-function detectTier3Agents(root) {
+export function detectTier3Agents(root) {
     const agentsDir = join(root, '.claude', 'agents');
     if (!existsSync(agentsDir))
         return [];
@@ -118,7 +118,7 @@ function detectTier3Agents(root) {
  * que el manifest sea estable entre plataformas. Devuelve [] si el dir no existe.
  * Recorre subdirectorios (los slash commands pueden estar anidados).
  */
-function listInstalledRelativeFiles(claudeDir, subdir, projectRoot) {
+export function listInstalledRelativeFiles(claudeDir, subdir, projectRoot) {
     const baseDir = join(claudeDir, subdir);
     if (!existsSync(baseDir))
         return [];
@@ -204,14 +204,14 @@ function getAgentTech(agent) {
     };
     return map[agent] ?? 'specialized';
 }
-function defaultAgentsForMode(mode) {
+export function defaultAgentsForMode(mode) {
     if (mode === 'startup')
         return ['orchestrator', 'backend-engineer', 'frontend-engineer'];
     if (mode === 'enterprise')
         return ['orchestrator', 'backend-engineer', 'frontend-engineer', 'test-engineer', 'docs-writer', 'compliance-reviewer', 'security-auditor'];
     return ['orchestrator', 'backend-engineer', 'frontend-engineer', 'test-engineer', 'docs-writer'];
 }
-function installCoreAgents(forgeRoot, destDir, activeAgents, profiles, force) {
+export function installCoreAgents(forgeRoot, destDir, activeAgents, profiles, force) {
     mkdirSync(destDir, { recursive: true });
     // Tier 2: profile agents first
     for (const profile of profiles) {
@@ -232,7 +232,7 @@ function installCoreAgents(forgeRoot, destDir, activeAgents, profiles, force) {
         }
     }
 }
-function installHooks(forgeRoot, destDir, mode, force) {
+export function installHooks(forgeRoot, destDir, mode, force) {
     mkdirSync(destDir, { recursive: true });
     const hooksDir = join(forgeRoot, 'core', 'hooks');
     if (!existsSync(hooksDir))
@@ -318,7 +318,7 @@ function mergeSettings(generated, existing) {
  * existe o no se puede parsear, escribe los settings generados tal cual.
  * Respeta `force`: con `force=false` no toca un archivo existente.
  */
-function writeSettingsJson(path, language, mode, force) {
+export function writeSettingsJson(path, language, mode, force) {
     const generated = buildSettings(language, mode);
     if (existsSync(path)) {
         if (!force)
@@ -338,13 +338,51 @@ function writeSettingsJson(path, language, mode, force) {
     }
     writeFileSync(path, JSON.stringify(generated, null, 2), 'utf-8');
 }
-function installCommands(forgeRoot, destDir, force) {
+export function installCommands(forgeRoot, destDir, force) {
     mkdirSync(destDir, { recursive: true });
     const commandsDir = join(forgeRoot, 'adapters', 'claude-code', 'commands');
     if (!existsSync(commandsDir))
         return;
     copyDir(commandsDir, destDir, force);
 }
+/**
+ * Scaffolds docs/specs/ (+ _template.md), docs/daily-notes/ and the
+ * .claude/architecture.rules file. Idempotent: never overwrites the spec
+ * template or architecture.rules once they exist. Shared by `forge init` and
+ * `forge adopt` so both lay down the same SDD scaffold.
+ */
+export function installSpecScaffold(forgeRoot, projectRoot, claudeDir, config) {
+    mkdirSync(join(projectRoot, 'docs', 'specs'), { recursive: true });
+    mkdirSync(join(projectRoot, 'docs', 'daily-notes'), { recursive: true });
+    const specTemplateSrc = join(forgeRoot, 'core', 'templates', 'spec-template.md');
+    if (existsSync(specTemplateSrc)) {
+        copyFile(specTemplateSrc, join(projectRoot, 'docs', 'specs', '_template.md'), false);
+    }
+    const archRulesTemplate = join(forgeRoot, 'core', 'templates', 'claude-md', 'architecture.rules');
+    const archRulesDest = join(claudeDir, 'architecture.rules');
+    if (existsSync(archRulesTemplate) && !existsSync(archRulesDest)) {
+        const content = readFileSync(archRulesTemplate, 'utf-8').replace('<NOMBRE_PROYECTO>', config.project.name ?? 'Mi Proyecto');
+        writeFileSync(archRulesDest, content, 'utf-8');
+    }
+}
+/**
+ * Builds and saves the .forge/manifest.json for a claude-code install: tracks
+ * CLAUDE.md, settings.json, architecture.rules, all agents (active + compliance
+ * + specialized) and the installed hooks/commands. Shared by init and adopt.
+ */
+export function saveInstallManifest(projectRoot, claudeDir, runtime, allAgents, specializedAgents, forgeVersion) {
+    const installedFiles = [
+        'CLAUDE.md', '.claude/settings.json', '.claude/architecture.rules',
+        ...allAgents.map(a => `.claude/agents/${a}.md`),
+        ...specializedAgents.map(a => `.claude/agents/${a}.md`),
+        ...listInstalledRelativeFiles(claudeDir, 'hooks', projectRoot),
+        ...listInstalledRelativeFiles(claudeDir, 'commands', projectRoot),
+    ];
+    const seen = new Set();
+    const uniqueFiles = installedFiles.filter(f => (seen.has(f) ? false : seen.add(f)));
+    const ts = new Date().toISOString();
+    saveManifest(projectRoot, buildManifest(runtime, uniqueFiles, projectRoot, forgeVersion, ts));
+}
 function installKiro(forgeRoot, projectRoot, config, force) {
     const kiroDir = join(projectRoot, '.kiro', 'steering');
     const hooksDir = join(projectRoot, '.kiro', 'hooks');
@@ -503,20 +541,7 @@ export async function init(args) {
             {
                 title: 'docs/specs/ + architecture.rules',
                 tech: 'scaffold',
-                task: () => {
-                    mkdirSync(join(projectRoot, 'docs', 'specs'), { recursive: true });
-                    mkdirSync(join(projectRoot, 'docs', 'daily-notes'), { recursive: true });
-                    const specTemplateSrc = join(forgeRoot, 'core', 'templates', 'spec-template.md');
-                    if (existsSync(specTemplateSrc)) {
-                        copyFile(specTemplateSrc, join(projectRoot, 'docs', 'specs', '_template.md'), false);
-                    }
-                    const archRulesTemplate = join(forgeRoot, 'core', 'templates', 'claude-md', 'architecture.rules');
-                    const archRulesDest = join(claudeDir, 'architecture.rules');
-                    if (existsSync(archRulesTemplate) && !existsSync(archRulesDest)) {
-                        const content = readFileSync(archRulesTemplate, 'utf-8').replace('<NOMBRE_PROYECTO>', config.project.name ?? 'Mi Proyecto');
-                        writeFileSync(archRulesDest, content, 'utf-8');
-                    }
-                },
+                task: () => installSpecScaffold(forgeRoot, projectRoot, claudeDir, config),
             },
             // Knowledge base — only for projects that activate a wiki-* skill. Other
             // projects don't get a wiki/ dir forced on them.
@@ -528,24 +553,7 @@ export async function init(args) {
             {
                 title: '.forge/manifest.json',
                 tech: 'sha256 tracking',
-                task: () => {
-                    const specializedAgents = config.agents?.specialized ?? [];
-                    const installedFiles = [
-                        'CLAUDE.md', '.claude/settings.json', '.claude/architecture.rules',
-                        // Tier 1 (active) + compliance agents.
-                        ...allAgents.map(a => `.claude/agents/${a}.md`),
-                        // Tier 3 (specialized) agents — must not be dropped from the manifest.
-                        ...specializedAgents.map(a => `.claude/agents/${a}.md`),
-                        // Installed guardrail hooks and slash commands (if present on disk).
-                        ...listInstalledRelativeFiles(claudeDir, 'hooks', projectRoot),
-                        ...listInstalledRelativeFiles(claudeDir, 'commands', projectRoot),
-                    ];
-                    // De-dup while preserving order (an agent could appear in both lists).
-                    const seen = new Set();
-                    const uniqueFiles = installedFiles.filter(f => (seen.has(f) ? false : seen.add(f)));
-                    const ts = new Date().toISOString();
-                    saveManifest(projectRoot, buildManifest(runtime, uniqueFiles, projectRoot, VERSION, ts));
-                },
+                task: () => saveInstallManifest(projectRoot, claudeDir, runtime, allAgents, config.agents?.specialized ?? [], VERSION),
             },
         ]);
     }