Configuración del Entorno de Desarrollo

Esta guía te lleva paso a paso por la configuración de un entorno de desarrollo local para el monorepo de KnowledgePulse.

Requisitos Previos

• Bun v1.0 o posterior -- instrucciones de instalación
• Git

Clonar e Instalar

git clone https://github.com/nicobailon/knowledgepulse.git
cd knowledgepulse
bun install

bun install resuelve todas las dependencias del workspace a través de cada paquete en el monorepo.

Estructura del Monorepo

knowledgepulse/
  packages/
    sdk/           # @knowledgepulse/sdk -- tipos, captura, recuperación, puntuación, skill-md, migraciones
    mcp-server/    # @knowledgepulse/mcp -- 6 herramientas MCP, puente de registro en modo dual
    cli/           # @knowledgepulse/cli -- buscar, instalar, validar, contribuir, autenticación, seguridad
    sop-studio/    # Placeholder (Fase 3)
  registry/        # Servidor API REST con Hono (almacenes en memoria, autenticación, limitación de tasa)
  specs/           # codegen.ts, validate-consistency.ts, skill-md-extension.md
  examples/        # basic-sdk-usage, mcp-client-example, langraph-integration

Tareas Comunes

Construir el SDK

bun run build

Generar el Esquema JSON

bun run codegen

Lint

bun run lint

Ejecutar Tests

bun test --recursive

Iniciar el Registro

bun run registry/src/index.ts

Iniciar el Servidor MCP

bun run packages/mcp-server/src/index.ts

Referencia Rápida

Tarea	Comando
Instalar dependencias	bun install
Construir SDK	bun run build
Generar esquema JSON	bun run codegen
Lint	bun run lint
Ejecutar todos los tests	bun test --recursive
Iniciar registro (puerto 3000)	bun run registry/src/index.ts
Iniciar servidor MCP (puerto 3001)	bun run packages/mcp-server/src/index.ts