Back to the catalog

Mármoles

Bundle OKF 0.2 · 3 conceitos · carlosg2/sk-eve

Open source Repository Open in the app JSON README (API)

About

# Mármoles

Tenant de Intelisis multiempresa, enfocado en planeación/MRP y sugerido de compra.

* [Perfil](profile.md) — conexión MCP, nombre de empresa.
* [Política — Sugerido de Compra](policies/sugerido-compra-policy.md) — reglas de Empresa
obligatoria, 2 fases (análisis/escritura), proveedor y estatus de OC.
* [Agente — Sugerido de Compra](agents/sugerido-compra/agent.md) — agente por defecto.

Schema de entidades: ver `erp-kernel` — [Empresa](/erp-kernel/empresa.md),
[EmpresaCfg2](/erp-kernel/empresacfg2.md), [Art](/erp-kernel/art.md),
[ArtAlm](/erp-kernel/artalm.md), [ArtDisponible/Desc](/erp-kernel/artdisponible.md),
[Alm](/erp-kernel/alm.md), [Prov](/erp-kernel/prov.md), [Compra](/erp-kernel/compra.md),
[CompraD](/erp-kernel/comprad.md), [PlanArtOP](/erp-kernel/planartop.md),
[PlaneacionMRP](/erp-kernel/planeacion-mrp.md).

Details

Kind
OKF bundles
Topic
No topic detected
Publisher
carlosg2
Origin
okf_github
Category
dados
Version
0.2
Last push
2026-08-22T04:13:20Z
Repository state
ativo
Language
Svelte
Added
2026-09-08 16:04:09
Updated
2026-09-08 16:04:09
Origin id
carlosg2/sk-eve:company-twin/companies/marmoles/index.md

README

# sk-eve — Agente ERP (Sigma AGI)

Asistente conversacional de ERP **Intelisis** construido con **Eve** + **SvelteKit**.
Se conecta al ERP vía **MCP sobre DAB** y responde preguntas de negocio con datos
reales de SQL Server. Es la implementación de la tesis **Sigma AGI** (`tesis/`):
tres abstracciones (Meta-fábrica, Agente, Company Twin) + Governance, con
*recursive self-improvement*: el runtime captura errores → buffer → la fábrica
(VS Code Copilot) promueve conocimiento a su hogar canónico.

## Stack

| Capa | Tecnología |
|---|---|
| UI + SSR | SvelteKit 2 + Svelte 5 |
| Agent framework | Eve 0.29.2 (embebido en Vite) |
| LLM | `deepseek/deepseek-v4-flash-0731` vía AI Gateway de Vercel; modelo dinámico por agente |
| MCP server | DAB custom; tenant ICF remoto `https://api2.maserp.mx/icf/mcp` (DAB local en 5050) |
| Base de datos | SQL Server 2022 (Docker) |
| Node.js | **24.x obligatorio** (Eve requiere ≥24) |

## Arranque

```bash
# 1. SQL Server docker (ya debe estar corriendo)
docker start sv5-sqlserver

# 2. DAB custom (MCP server) — ver .github/copilot-instructions.md §DAB custom
#    (binario DLL con ~/.dotnet/dotnet, config symlink a dab/dab-config.json)

# 3. SvelteKit + Eve
nvm use 24
npm install
npm run dev          # → http://localhost:5173 (o 5174/5175 si hay conflicto)
```

Variables de entorno en `.env.local` (ver `.env.example`):
`ANTHROPIC_API_KEY`, `AI_GATEWAY_API_KEY`, `INTELISIS_MCP_URL` (opcional).

> El runbook operativo completo (gotchas de Eve, DAB build, protocolo de pruebas,
> self-improvement) vive en **`.github/copilot-instructions.md`** — léelo antes de
> tocar el agente.

## Estructura

```
agent/                  # el agente: agent.ts, instructions/, hooks/, lib/, skill-library/ (19 skills), tools/
company-twin/           # el activo: erp-kernel/ (universal OKF) + companies/<tenant>/ (ICF, marmoles, joyarock…)
evals/                  # gates de regresión (npx eve eval)
tesis/                  # la tesis Sigma AGI (ver tesis/README.md)
src/                    # SvelteKit: /chat, /studio, /audit, /api/*
scripts/                # probes de la meta-fábrica, linter de conocimiento, e2e
.data/                  # radiografía durable (sessions.sqlite3) — gitignored
```

## Verificación (antes de cada cambio)

```bash
nvm use 24
npm run check                                # svelte-check, 0 errores
node scripts/check-knowledge.ts              # linter de conocimiento vs MCP real: 0 críticos
node_modules/.bin/eve eval --url http://127.0.0.1:62803/ --timeout 360000   # evals 4/4
```

## Documentación

- `tesis/README.md` — guía de lectura de la tesis (arquitectura → tesis → constitución → ADRs)
- `.github/copilot-instructions.md` — runbook operativo de la fábrica (VS Code Copilot)
- `tesis/protocolo-pruebas.md` — protocolo de evaluación con evidencia (radiografía)

More