tzzr/system-docs
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Archive: System v4 - Estado al 2024-12-24

Browse Source
This commit is contained in:
ARCHITECT
2025-12-24 17:28:34 +00:00
parent a92d41c846
commit 1b392803fd
81 changed files with 24560 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

74
v4-archive/the-factory/README.md Normal file
View File

@@ -0,0 +1,74 @@
# THE FACTORY - Trabajo Iterativo Generativo
## Descripción
Servicio de generación de imágenes usando modelos de difusión.
## Endpoint RunPod
- ID: `ddnuk6y35zi56a`
- URL: `https://api.runpod.ai/v2/ddnuk6y35zi56a/runsync`
- Workers: 1
- GPU: NVIDIA L4
## Código
Ubicación: `s3://architect/gpu-services/factory/code/handler.py`
## Tareas Disponibles
### image_generate
Genera imagen desde prompt.
```json
{
"input": {
"task": "image_generate",
"prompt": "a futuristic city at sunset",
"model": "sdxl-turbo",
"width": 1024,
"height": 1024,
"steps": 4,
"guidance": 0.0
}
}
```
### image_variant
Genera variante de imagen existente.
```json
{
"input": {
"task": "image_variant",
"image_base64": "...",
"prompt": "make it more colorful",
"strength": 0.5,
"model": "sdxl-turbo"
}
}
```
### image_upscale
Aumenta resolución de imagen.
```json
{
"input": {
"task": "image_upscale",
"image_base64": "...",
"scale": 2
}
}
```
## Modelos Disponibles
- `sdxl-turbo` (default) - Rápido, 4 steps
- `sdxl` - Alta calidad
- `flux` - FLUX.1-schnell
## Respuesta
```json
{
"image_base64": "...",
"width": 1024,
"height": 1024,
"model": "sdxl-turbo",
"task": "image_generate",
"trace_id": "..."
}
```

722
v4-archive/the-factory/docs/THE_FACTORY_Especificacion_Tecnica_v1.md Normal file
View File

@@ -0,0 +1,722 @@
# 🏭 THE FACTORY
## Especificación Técnica Genérica v1.0
**Incubador Iterativo — Sistema SFE/HST Enterprise v5.0**
> *"Zero retención de datos. Todo entra, se procesa, se va."*
---
## Índice
1. [Visión General](#1-visión-general)
2. [Ciclo de Trabajo](#2-ciclo-de-trabajo)
3. [Modelo de Datos](#3-modelo-de-datos)
4. [Componentes Internos](#4-componentes-internos)
5. [Catálogo de Modelos](#5-catálogo-de-modelos)
6. [Integración con Contrato Común v1.2](#6-integración-con-contrato-común-v12)
7. [API HTTP](#7-api-http)
8. [Configuración](#8-configuración)
9. [Ejemplo de Uso Completo](#9-ejemplo-de-uso-completo)
10. [Próximos Pasos](#10-próximos-pasos)
---
## 1. Visión General
### 1.1 ¿Qué es The Factory?
The Factory es un **trabajador IA disciplinado** que ejecuta trabajo hasta alcanzar calidad. A diferencia de los sistemas tradicionales de generación única, The Factory implementa un **ciclo iterativo de producción-evaluación** hasta convergencia.
```
┌─────────────────────────────────────────────────────────────────┐
│ THE FACTORY │
│ │
│ • Recibe trabajo (Job) │
│ • Ejecuta ciclos iterativos │
│ • Evalúa cada iteración │
│ • Para cuando: conformidad | max ciclos | presupuesto │
│ • Devuelve resultados │
│ │
└─────────────────────────────────────────────────────────────────┘
```
| Característica | Descripción |
|----------------|-------------|
| **Naturaleza** | Incubador iterativo con ciclo de mejora continua |
| **Filosofía** | Zero retención — stateless entre Jobs |
| **Objetivo** | Producir artefactos de calidad mediante iteración |
| **Parada** | Por conformidad, límite de ciclos, o presupuesto |
### 1.2 Principios Fundamentales
| Principio | Descripción |
|-----------|-------------|
| **Stateless** | No retiene estado entre Jobs. Cada ejecución es independiente |
| **Determinista** | Mismo Job + misma semilla = mismo resultado |
| **Intercambiable** | Los modelos subyacentes pueden sustituirse sin romper el sistema |
| **Trazable** | Toda ejecución queda registrada vía trace_id |
| **No persiste** | Los archivos solo existen en el almacenamiento externo |
### 1.3 Arquitectura de Responsabilidades
```
THE CORP (el que encarga)
├── Tiene el espacio de trabajo
├── Tiene el log
├── Define el Job
└── Recibe los resultados
THE FACTORY (el que fabrica)
├── Lee de donde le dicen
├── Ejecuta ciclos
├── Escribe donde le dicen
└── No retiene NADA
STORAGE (el que persiste)
├── Almacena artefactos
├── Externo a Factory
└── Puede ser S3, Hostinger, local, etc.
```
| Componente | Rol | Responsabilidad |
|------------|-----|-----------------|
| **THE CORP** | El que encarga | Define Job, provee workspace, recibe resultados |
| **THE FACTORY** | El que fabrica | Ejecuta ciclos, evalúa, itera hasta convergencia |
| **STORAGE** | El que persiste | Almacena artefactos (externo a Factory) |
---
## 2. Ciclo de Trabajo
### 2.1 Flujo Principal
```
Job ──► EJECUTOR ──► Artefacto ──► EVALUADOR ──► ¿Converge?
│ │
│ ┌─────────────────────┘
│ │
│ Sí│No
│ │ │
│ ▼ └──────────────┐
│ FIN │
│ ▼
└─────────── Nueva iteración (con feedback)
```
#### Paso 1: Recepción del Job
The Factory recibe un Job que contiene:
- **Semilla**: Instrucción inicial / prompt
- **Objetivo**: Criterio de éxito (qué es "listo")
- **Función**: Tipo de generación (texto, imagen, audio, video)
- **Límites**: Ciclos máximos, presupuesto, timeout
- **Referencias**: URLs de entrada/salida
#### Paso 2: Ejecución
El **Ejecutor** toma la semilla (y feedback previo si existe) y produce un artefacto. Es agnóstico del modelo — puede usar cualquier LLM, generador de imagen, audio o video.
#### Paso 3: Evaluación
El **Evaluador** (Comité) analiza el artefacto contra el objetivo definido:
- Determina si **converge** (cumple criterios) o no
- Si no converge, genera **feedback estructurado** para el Ejecutor
#### Paso 4: Decisión
- **Si converge** → Termina y entrega
- **Si no converge** → Nueva iteración con feedback
- **Si límite alcanzado** → Entrega última versión funcional + informe
### 2.2 Criterios de Parada
| Criterio | Condición | Resultado |
|----------|-----------|-----------|
| **CONFORMITY** | El evaluador dice "listo" | Entrega artefacto final |
| **MAX_CYCLES** | Se agotan iteraciones permitidas | Entrega última funcional + informe |
| **BUDGET** | Se agota el presupuesto definido | Igual que MAX_CYCLES |
| **TIMEOUT** | Se agota el tiempo máximo | Igual que MAX_CYCLES |
| **ERROR** | Error irrecuperable | Entrega parcial + error |
| **CANCELLED** | Cancelación externa | Entrega estado actual |
---
## 3. Modelo de Datos
### 3.1 JobInput — La Semilla
Estructura de entrada que define todo lo necesario para iniciar un trabajo:
```json
{
"job_id": "uuid-v4",
"seed": "Instrucción inicial / prompt",
"objective": "Qué se considera éxito",
"function": "TEXT_GENERATION",
"input_refs": ["url/de/materia/prima"],
"output_ref": "url/donde/escribir",
"log_ref": "url/del/log",
"limits": {
"max_cycles": 10,
"budget_usd": 10.0,
"timeout_minutes": 60,
"min_confidence": 0.8
}
}
```
| Campo | Tipo | Requerido | Descripción |
|-------|------|-----------|-------------|
| `job_id` | UUID | Auto | Identificador único del Job |
| `seed` | string | Sí | Instrucción inicial / prompt |
| `objective` | string | Sí | Criterio de éxito (qué es "listo") |
| `function` | enum | Sí | Tipo de generación |
| `input_refs` | string[] | No | URLs de materia prima |
| `output_ref` | string | Sí | URL donde escribir resultado |
| `log_ref` | string | Sí | URL del log de ejecución |
| `limits` | Limits | Sí | Restricciones del Job |
### 3.2 Functions Soportadas
| Function | Descripción | Output típico |
|----------|-------------|---------------|
| `TEXT_GENERATION` | Generación de texto/código | .txt, .md, .json, .py |
| `IMAGE_GENERATION` | Generación de imágenes | .png, .jpg, .webp |
| `AUDIO_GENERATION` | Generación de audio/voz | .mp3, .wav, .opus |
| `VIDEO_GENERATION` | Generación de video | .mp4, .webm |
| `CODE_GENERATION` | Código con validación | Archivos de código |
| `DOCUMENT_GENERATION` | Documentos estructurados | .pdf, .docx |
| `MULTIMODAL` | Combinación de modalidades | Variable |
### 3.3 Limits — Restricciones
| Campo | Tipo | Default | Descripción |
|-------|------|---------|-------------|
| `max_cycles` | int | 10 | Máximo de iteraciones permitidas |
| `budget_usd` | float | 10.0 | Presupuesto máximo en USD |
| `timeout_minutes` | int | 60 | Tiempo máximo de ejecución |
| `min_confidence` | float | 0.8 | Confianza mínima para convergencia |
### 3.4 JobState — Estado en Tiempo Real
```json
{
"job_id": "uuid",
"status": "RUNNING",
"current_iteration": 3,
"spent_usd": 0.045,
"stop_reason": null,
"final_artifact_ref": null,
"last_functional_iteration": 2,
"created_at": "2025-12-16T10:30:00Z",
"started_at": "2025-12-16T10:30:01Z",
"completed_at": null
}
```
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `job_id` | UUID | Identificador del Job |
| `status` | enum | PENDING \| RUNNING \| CONVERGED \| EXHAUSTED \| FAILED \| CANCELLED |
| `current_iteration` | int | Iteración actual (1-based) |
| `spent_usd` | float | Costo acumulado |
| `stop_reason` | enum | Razón de parada (si terminó) |
| `final_artifact_ref` | string | URL del artefacto final |
| `last_functional_iteration` | int | Última iteración sin errores graves |
| `created_at` | datetime | Momento de creación |
| `started_at` | datetime | Momento de inicio de procesamiento |
| `completed_at` | datetime | Momento de finalización |
### 3.5 JobResult — Resultado Final
```json
{
"job_id": "uuid",
"status": "CONVERGED",
"stop_reason": "CONFORMITY",
"converged": true,
"final_artifact_ref": "s3://bucket/output/artifact.md",
"last_functional_iteration": 3,
"total_iterations": 3,
"total_cost_usd": 0.045,
"total_duration_ms": 12500,
"created_at": "2025-12-16T10:30:00Z",
"started_at": "2025-12-16T10:30:01Z",
"completed_at": "2025-12-16T10:30:13Z"
}
```
---
## 4. Componentes Internos
### 4.1 JobManager — El Orquestador
El JobManager es el componente central que gestiona el ciclo de vida de los Jobs:
```python
class JobManager:
async def submit_job(input: JobInput) -> JobState
async def get_job_status(job_id: str) -> JobState
async def cancel_job(job_id: str) -> bool
def get_job_result(job_id: str) -> JobResult
```
| Método | Descripción |
|--------|-------------|
| `submit_job(input)` | Recibe y encola un Job para procesamiento |
| `get_job_status(id)` | Obtiene el estado actual de un Job |
| `cancel_job(id)` | Cancela un Job en ejecución |
| `get_job_result(id)` | Obtiene el resultado final de un Job completado |
### 4.2 Executor — El Productor
El Executor es responsable de generar artefactos. Es agnóstico del modelo subyacente.
#### Interfaz
```python
async def execute(job_input: JobInput, iter_input: IterationInput) -> IterationOutput
```
#### IterationInput
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `iteration_number` | int | Número de iteración actual |
| `seed` | string | Semilla original del Job |
| `previous_feedback` | string? | Feedback de la evaluación anterior |
| `accumulated_context` | dict | Contexto acumulado entre iteraciones |
#### IterationOutput
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `artifact_ref` | string | URL del artefacto generado |
| `artifact_hash` | string | SHA-256 del artefacto |
| `executor_model` | string | Modelo usado (ej: "claude-sonnet-4") |
| `cost_usd` | float | Costo de esta iteración |
| `metadata` | dict | Metadatos adicionales |
### 4.3 Evaluator — El Comité
El Evaluator analiza artefactos y determina convergencia.
#### Interfaz
```python
async def evaluate(job_input: JobInput, eval_input: EvaluationInput) -> EvaluationResult
```
#### EvaluationInput
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `job_objective` | string | Objetivo definido en el Job |
| `iteration_number` | int | Número de iteración actual |
| `artifact_ref` | string | URL del artefacto a evaluar |
| `previous_evaluations` | list | Historial de evaluaciones anteriores |
#### EvaluationResult
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `converged` | bool | True si el artefacto cumple el objetivo |
| `confidence` | float | Nivel de confianza (0.0 - 1.0) |
| `strengths` | string[] | Aspectos positivos identificados |
| `weaknesses` | string[] | Aspectos a mejorar |
| `feedback_for_executor` | string | Instrucciones para la siguiente iteración |
| `evaluator_model` | string | Modelo usado para evaluar |
| `cost_usd` | float | Costo de la evaluación |
### 4.4 FactoryLogger — Trazabilidad
El Logger registra cada evento del ciclo de vida:
| EventType | Momento | Datos registrados |
|-----------|---------|-------------------|
| `JOB_CREATED` | Al recibir Job | seed, objective, limits |
| `JOB_STARTED` | Al iniciar procesamiento | timestamp |
| `ITERATION_START` | Al iniciar iteración | iteration_number |
| `EXECUTOR_CALL` | Al llamar Ejecutor | has_feedback |
| `EXECUTOR_RESPONSE` | Al recibir artefacto | artifact_ref, model, cost |
| `EVALUATOR_CALL` | Al llamar Evaluador | artifact_ref |
| `EVALUATOR_RESPONSE` | Al recibir evaluación | converged, confidence |
| `ITERATION_END` | Al terminar iteración | converged, total_spent |
| `JOB_CONVERGED` | Al alcanzar conformidad | final_artifact_ref |
| `JOB_MAX_ITERATIONS` | Al agotar ciclos | last_iteration |
| `JOB_BUDGET_EXHAUSTED` | Al agotar presupuesto | spent_usd |
| `JOB_ERROR` | Al ocurrir error | error, phase |
| `JOB_COMPLETED` | Al finalizar | status, stop_reason, totals |
---
## 5. Catálogo de Modelos
The Factory es agnóstico de modelos. Estos son los recomendados por modalidad:
### 5.1 LLMs (Texto/Código)
| Modelo | Proveedor | Tipo | Fortalezas |
|--------|-----------|------|------------|
| Claude Sonnet 4 | Anthropic | API | Razonamiento, código, instrucciones |
| GPT-4o | OpenAI | API | Multimodal, velocidad, generalista |
| Gemini 2.5 Pro | Google | API | Contexto enorme (1M tokens) |
| Llama 3.3 70B | Meta | Local/API | Open source, privacidad |
| Qwen 2.5 72B | Alibaba | Local/API | Multilingüe, código |
### 5.2 Imagen
| Modelo | Proveedor | Tipo | Fortalezas |
|--------|-----------|------|------------|
| Flux 1.1 Pro | Black Forest | API | Calidad, texto en imagen |
| DALL-E 3 | OpenAI | API | Facilidad, integración |
| Flux Schnell | Black Forest | Local | Rápido, buena calidad |
| Stable Diffusion XL | Stability | Local | Personalizable, LoRAs |
### 5.3 Audio
| Modelo | Proveedor | Tipo | Fortalezas |
|--------|-----------|------|------------|
| ElevenLabs | ElevenLabs | API | Voces naturales, clonación |
| XTTS-v2 | Coqui | Local | Multilingüe, privacidad |
| Suno | Suno | API | Generación musical |
| Faster-Whisper | SYSTRAN | Local | STT rápido y preciso |
### 5.4 Video
| Modelo | Proveedor | Tipo | Fortalezas |
|--------|-----------|------|------------|
| Runway Gen-3 | Runway | API | Calidad cinematográfica |
| Kling 1.6 | Kuaishou | API | Duración, coherencia |
| Pika | Pika Labs | API | Efectos, estilización |
---
## 6. Integración con Contrato Común v1.2
Para integrarse con sistemas externos (como Jarvis/Alfred), The Factory puede adaptar sus estructuras al Contrato Común v1.2.
### 6.1 Mapeo JobInput → Envelope
| JobInput | Envelope v1.2 | Transformación |
|----------|---------------|----------------|
| `job_id` | `envelope.trace_id` | Directo |
| `function` | `routing.module` | Mapeo (TEXT_GENERATION → TEXT_GEN) |
| `seed + objective` | `payload.content` | Combinar en estructura |
| `limits` | `envelope.ttl_ms + context` | Transformar a milisegundos |
| `input_refs` | `storage.input_ref` | Primera referencia |
| `output_ref` | `storage.output_ref` | Directo |
### 6.2 Mapeo Function → Module
| Factory Function | Jarvis Module | Fallback Chain sugerida |
|------------------|---------------|-------------------------|
| `TEXT_GENERATION` | `TEXT_GEN` | CLAUDE_SONNET → GPT4O → LLAMA_70B |
| `IMAGE_GENERATION` | `IMAGE_GEN` | FLUX_PRO → DALLE3 → FLUX_LOCAL |
| `AUDIO_GENERATION` | `AUDIO_GEN` | ELEVENLABS → XTTS_LOCAL |
| `VIDEO_GENERATION` | `VIDEO_GEN` | RUNWAY → KLING |
| `CODE_GENERATION` | `TEXT_GEN + VALIDATOR` | CLAUDE → GPT4O |
### 6.3 Envelope de Ejemplo
```json
{
"contract_version": "1.2",
"profile": "FULL",
"envelope": {
"trace_id": "job_id_aquí",
"parent_trace_id": null,
"step_id": "uuid-paso",
"step_index": 1,
"total_steps": 1,
"idempotency_key": "sha256_del_seed",
"timestamp_init": "2025-12-16T10:30:00.000Z",
"ttl_ms": 3600000
},
"routing": {
"module": "TEXT_GEN",
"version": "1.0",
"provider_preference": ["anthropic", "openai", "local"],
"fallback_chain": ["CLAUDE_SONNET", "GPT4O", "LLAMA_70B"],
"max_fallback_level": 2
},
"payload": {
"type": "structured",
"content": {
"seed": "Escribe un haiku...",
"objective": "Un haiku válido 5-7-5..."
}
},
"storage": {
"input_location": "external",
"output_location": "external",
"output_ref": "s3://bucket/output/"
}
}
```
### 6.4 Adapter Pattern
Se recomienda implementar un `ContractAdapter` que permita:
- Recibir Jobs en formato nativo de Factory
- Transformar a Envelope v1.2 para llamadas a Jarvis
- Recibir respuestas en formato Envelope
- Transformar a estructuras internas de Factory
```python
class ContractAdapter:
def job_to_envelope(job: JobInput, iteration: int) -> dict
def envelope_to_iteration_output(envelope: dict) -> IterationOutput
def envelope_to_evaluation_result(envelope: dict) -> EvaluationResult
```
---
## 7. API HTTP
### 7.1 Endpoints
| Método | Endpoint | Descripción |
|--------|----------|-------------|
| `GET` | `/health` | Health check |
| `GET` | `/` | Información del sistema |
| `POST` | `/jobs` | Crear nuevo Job |
| `GET` | `/jobs/{job_id}` | Obtener estado de Job |
| `DELETE` | `/jobs/{job_id}` | Cancelar Job |
| `GET` | `/jobs/{job_id}/result` | Obtener resultado final |
### 7.2 POST /jobs — Crear Job
#### Request
```json
{
"seed": "Escribe un haiku sobre programación",
"objective": "Un haiku válido (5-7-5 sílabas) sobre programación",
"function": "TEXT_GENERATION",
"output_ref": "/workspace/output/haiku.txt",
"log_ref": "/workspace/logs/job_001.json",
"limits": {
"max_cycles": 5,
"budget_usd": 1.0
}
}
```
#### Response (202 Accepted)
```json
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "PENDING",
"created_at": "2025-12-16T10:30:00Z"
}
```
### 7.3 GET /jobs/{id} — Estado
```json
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "RUNNING",
"current_iteration": 2,
"spent_usd": 0.023,
"created_at": "2025-12-16T10:30:00Z",
"started_at": "2025-12-16T10:30:01Z"
}
```
### 7.4 GET /jobs/{id}/result — Resultado
```json
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "CONVERGED",
"stop_reason": "CONFORMITY",
"converged": true,
"final_artifact_ref": "/workspace/output/haiku.txt",
"total_iterations": 3,
"total_cost_usd": 0.045,
"total_duration_ms": 12500
}
```
---
## 8. Configuración
### 8.1 Variables de Entorno
| Variable | Default | Descripción |
|----------|---------|-------------|
| `ENVIRONMENT` | development | Entorno de ejecución |
| `DEBUG` | false | Modo debug |
| `WORKSPACE_PATH` | /workspace | Ruta del workspace |
| `LOG_LEVEL` | INFO | Nivel de logging |
| `DEFAULT_MAX_CYCLES` | 10 | Ciclos por defecto |
| `DEFAULT_BUDGET_USD` | 10.0 | Presupuesto por defecto |
| `DEFAULT_TIMEOUT_MIN` | 60 | Timeout por defecto |
### 8.2 API Keys
| Variable | Descripción |
|----------|-------------|
| `OPENROUTER_API_KEY` | API key para OpenRouter (multi-modelo) |
| `ANTHROPIC_API_KEY` | API key de Anthropic (Claude) |
| `OPENAI_API_KEY` | API key de OpenAI |
| `REPLICATE_API_KEY` | API key de Replicate |
| `FAL_API_KEY` | API key de Fal.ai |
### 8.3 Configuración de Modelos
```bash
# Modelos por función
EXECUTOR_MODEL_TEXT=claude-sonnet-4-20250514
EXECUTOR_MODEL_IMAGE=flux-1.1-pro
EXECUTOR_MODEL_AUDIO=elevenlabs-multilingual-v2
EXECUTOR_MODEL_VIDEO=runway-gen3
# Modelo del evaluador
EVALUATOR_MODEL=claude-sonnet-4-20250514
```
---
## 9. Ejemplo de Uso Completo
### Escenario: Generación de Artículo Técnico
#### 1. Enviar Job
```bash
POST /jobs
```
```json
{
"seed": "Escribe un artículo técnico de 1000 palabras sobre el estado actual de la IA generativa en 2025",
"objective": "Artículo bien estructurado, técnicamente preciso, con introducción, desarrollo y conclusión. Debe mencionar modelos actuales y tendencias.",
"function": "TEXT_GENERATION",
"output_ref": "s3://bucket/articles/ai-2025.md",
"log_ref": "s3://bucket/logs/job-article.json",
"limits": {
"max_cycles": 5,
"budget_usd": 2.0
}
}
```
#### 2. Iteración 1
- **Ejecutor**: Genera primer borrador
- **Evaluador**:
- Confianza: 0.6
- Fortalezas: Buena estructura básica
- Debilidades: Falta profundidad técnica, conclusión débil
- **No converge**
#### 3. Iteración 2
- **Ejecutor**: Recibe feedback, mejora secciones técnicas
- **Evaluador**:
- Confianza: 0.75
- Fortalezas: Mejor contenido técnico
- Debilidades: Conclusión aún genérica
- **No converge**
#### 4. Iteración 3
- **Ejecutor**: Refuerza conclusión con proyecciones específicas
- **Evaluador**:
- Confianza: 0.92
- Fortalezas: Cumple todos los criterios
- Debilidades: Ninguna significativa
- **¡CONVERGE!**
#### 5. Resultado Final
```json
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "CONVERGED",
"stop_reason": "CONFORMITY",
"converged": true,
"final_artifact_ref": "s3://bucket/articles/ai-2025.md",
"total_iterations": 3,
"total_cost_usd": 0.18,
"total_duration_ms": 45000
}
```
---
## 10. Próximos Pasos
### 10.1 Este Documento (Especificación Genérica) ✅
- [x] Definición de arquitectura y componentes
- [x] Modelo de datos completo
- [x] Ciclo de trabajo y criterios de parada
- [x] API HTTP
- [x] Catálogo de modelos
- [x] Mapeo a Contrato Común v1.2
### 10.2 Siguiente: Implementación RunPod
- [ ] Dockerfile optimizado para GPU
- [ ] Handler serverless para RunPod
- [ ] Workers especializados por modalidad
- [ ] Configuración de endpoints
- [ ] Gestión de modelos locales
### 10.3 Futuro: Integración con Alfred
- [ ] Workflow n8n para invocar Factory
- [ ] Webhooks de callback
- [ ] Logging a SYS_LOG
- [ ] Persistencia de artefactos en Hostinger
---
## Anexo: Diagrama de Secuencia
```
┌──────┐ ┌───────────┐ ┌──────────┐ ┌───────────┐
│ CORP │ │ JobManager│ │ Executor │ │ Evaluator │
└──┬───┘ └─────┬─────┘ └────┬─────┘ └─────┬─────┘
│ │ │ │
│ submit_job() │ │ │
│──────────────>│ │ │
│ │ │ │
│ │────────────────────────────────────────┐
│ │ LOOP [hasta convergencia] │
│ │ │ │ │
│ │ execute() │ │ │
│ │───────────────>│ │ │
│ │ │ │ │
│ │ artifact │ │ │
│ │<───────────────│ │ │
│ │ │ │ │
│ │ evaluate() │ │ │
│ │───────────────────────────────-->│ │
│ │ │ │ │
│ │ result │ │ │
│ │<─────────────────────────────────│ │
│ │────────────────────────────────────────┘
│ │ │ │
│ JobResult │ │ │
│<──────────────│ │ │
│ │ │ │
```
---
**Sistema SFE/HST Enterprise v5.0**
*Documento generado: Diciembre 2025*

1792
v4-archive/the-factory/docs/THE_FACTORY_RunPod_Implementation_v1.md Normal file
View File

File diff suppressed because it is too large Load Diff