Coyote 2.0

Gestión inteligente de colecciones y mazos de Magic: The Gathering, con análisis determinista, personalización e IA collection-aware.

El problema

Los jugadores acumulan cientos o miles de cartas, pero las herramientas habituales rara vez responden con rigor a:

¿Puedo construir este mazo con lo que ya tengo, sin pelearme con copias asignadas a otros decks y sin comprarme una carta que ya poseo en otra edición?

Qué es Coyote

Coyote 2.0 sitúa el inventario real en el centro (identidad oracle ≠ impresión, disponibilidad derivada de asignaciones a decks) y construye encima:

• gestión de colección y bulk;
• construcción de decks con conflictos visibles;
• análisis (curva, colores, huecos);
• asistencia IA que prioriza lo poseído y explica por qué;
• personalización del estilo de juego (fases posteriores);
• simulación solo como visión a largo plazo, sin sobreprometer un rules engine completo.

Estado del proyecto

Fase 0 — Foundation (hardening). Documentación, ADRs, monorepo, CI y contratos de dominio listos. Aún no hay Collection Core de producto implementado.

Arquitectura (resumen)

Monolito modular TypeScript:

Pieza	Rol
apps/web	Next.js App Router (UI + API inicial)
packages/domain	Reglas puras de inventario / tipos MTG
packages/ai	Abstracción de proveedores IA + mock
PostgreSQL	Fuente de verdad (Compose en local)
Auth.js	Autenticación (ADR-0005)
Drizzle	ORM / migraciones (ADR-0013)

Detalles: docs/03-architecture/architecture-overview.md · ADRs: docs/09-decisions/

Stack

Next.js 16 · React 19 · TypeScript · pnpm · Vitest · ESLint · Prettier · PostgreSQL 16 · GitHub Actions

Estructura del repositorio

apps/web/           Aplicación web
packages/domain/    Dominio puro
packages/ai/        Capa IA
docs/               Documentación (español)
.github/            Templates + CI + Dependabot
AGENTS.md           Contrato para agentes

Instalación

pnpm install
cp .env.example .env.local

Desarrollo

pnpm dev

Postgres local (si tienes Docker; no validado en Cloud Agent):

docker compose up -d

Calidad

pnpm check   # format + lint + typecheck + test + build

Roadmap resumido

0. Foundation ← aquí
1. Collection Core
2. Deck Management
3. Deck Analysis
4. AI Assistant
5. Personalization
6. Advanced Simulation (escalera realista; ver docs)

Documentación

Índice: docs/README.md

Contribución

1. Lee AGENTS.md y la documentación del área.
2. Trabaja en rama desde main (nunca features directo en main).
3. Conventional Commits; sin coautoría de herramientas/IA.
4. Identidad Git del propietario: IagoPL <IagoPL@users.noreply.github.com>.
5. Abre PR con el template; CI verde obligatorio.

Licencia

Pendiente de decisión explícita del propietario (ver ADR-0015). Mientras tanto, todos los derechos reservados.