5 Commits (alpha-0.1-dir-prefs)

Author	SHA1	Message	Date
dev	31580f3b39	docs(spec): el contrato de delegación como especificación normativa (DRAFT) ... Fase 1 del plan de corrección, y materialización de D-AG.12a firmada ayer: `docs/spec/delegation-contract.md`, versionada por fecha (2026-07-28). QUÉ ES 50 requisitos `AG-1…50` en RFC-2119, con escalera de estabilidad por sección (stable | provisional | reserved), identificadores estables que NUNCA se renumeran ni se reciclan (un requisito retirado conserva su número), y la exigencia de que ambos vehículos de conformance CITEN el identificador que incumplen — «una suite que no nombra lo que falla no acredita a nadie». La doctrina pasa a ser el PORQUÉ y lo declara explícitamente: si doctrina y spec discrepan sobre un requisito, manda la spec y la doctrina se corrige. Annex A lleva las dos reclamaciones de frontera con estado `claimed` (ninguna materializada) y su gate de promoción: ≥2 FORMAS DE DOMINIO con manifiesto conforme — y dice por qué dos participantes de texto no valen: un formato probado solo sobre texto secuencial asume texto secuencial en silencio. Annex B mapea el modelo de amenazas a requisitos concretos en vez de dejarlo como prosa. §0.6 declara la posición honesta (actos secuenciales, cliente- first, generalidad en prueba). LO QUE LA ESCRITURA SACÓ A LA LUZ — y no estaba en ninguna lista - **AG-35 (presencia)**: el invariante correcto NO es «Aura montada» sino «alguna superficie está expresando el ciclo». El playground de agnt ya expresa el ciclo SIN Aura, y exigir el componente lo rechazaría siendo correcto. Además resuelve el problema técnico: el motor es un arte sin DOM y no puede saber qué hay montado, pero sí puede contar adjuntos. - **AG-41 (elicitación)**: especificado y NO cumplido, con el porqué estructural — la escalada lleva razón tipada pero no la pregunta, y la resolución es binaria y no lleva respuesta. No era falta de superficie. - **AG-44**: «ningún estado se distingue solo por el color» sube de decisión de componente a requisito del contrato (ya lo fija `shapes.test.ts`). §D — DECISIONES ABIERTAS, VISIBLES Un DRAFT puede llevarlas; al promocionar, §D debe quedar VACÍA. Son dos y ninguna la firmo yo: `SHOULD` vs `MUST` en AG-35 (con recomendación razonada: SHOULD + política que lo eleve a MUST, porque rehusar por defecto rompería los 30 tests del motor y le quitaría al app el derecho a elegir su superficie) y la forma del canal de elicitación en AG-41. Registrada en el índice del corpus. `docs/README.md` lo edita otra sesión en paralelo: stageada SOLO mi fila (backup → HEAD → mi cambio → add → restaurar su versión + mi cambio), verificado que lo suyo queda sin stagear. Verificado: docs:check 542 docs, sin errores nuevos (el único es el ajeno preexistente de callout). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2 months ago
dev	ee02c5c55f	docs(agent): D-AG.12 y §5b firmadas — la spec, y quién prueba el eje ... Dos decisiones que estaban pendientes, firmadas tras investigación a fondo (precedente externo verificado a fecha, no de memoria). D-AG.12 — EL CONTRATO COMO REFERENCIA Spec normativa en `docs/spec/` (RFC-2119 + IDs `AG-n` + escalera stable|provisional|reserved + versionado por fecha), en estado DRAFT para que F4b se construya CONTRA ella y no al revés. La doctrina se queda con el PORQUÉ. Conformance en DOS vehículos, que es lo que evita que la palabra sea retórica: kit de fixtures del protocolo (PORTABLE — un tercero lo corre contra SU implementación; semilla ScriptedAgentTransport) + agent-check (lint del repo), ambos citando IDs de requisito en sus fallos. Las dos claims de frontera se nombran con marcador claimed|shipped porque hoy ninguna está materializada. Gate de promoción a 1.0: ≥2 formas de dominio + claims shipped + fixtures verdes. Respaldo externo: MCP ya no promueve a Final sin escenario en su suite (SEP-2484) y opera lifecycle formal con ventana de 12 meses; AG-UI se volvió referencia por ADOPCIÓN (AWS Bedrock AgentCore, Microsoft Agent Framework), no por publicar suite. La spec se escribe antes para gobernar; el título se gana después. §5b — QUIÉN PRUEBA EL EJE: form + table El gate de F4 pedía «2 manifiestos reales» sin asignar dueños; esto rellena ese hueco, no enmienda nada. El criterio deja de ser disponibilidad y pasa a ser dificultad: un formato lo decide su caso peor. Y form+table no son preferencia, son la ANATOMÍA del contrato — los args de una capacidad SON schemas (sium → toJsonSchema, ya construido en F1) y un run ES una transacción sobre un conjunto de ediciones. Form además dobla: agente→componente (args contra campos) y componente→agente (elicitación) son la misma proyección en los dos sentidos. Chat y palabras quedan como CONSUMIDORES, no jueces. El riesgo que esto evita era real: ambos son texto lineal, así que un manifiesto probado solo ahí habría asumido texto en silencio (rango como selección, ediciones secuenciales, args string) y el caso peor habría aparecido tarde. Inventario al firmar: 170 morfos, 0 con capacidad delegate declarada. COROLARIO — la elicitación no depende de superficie conversacional Una pregunta tipada es un formulario en contexto (Form.AutoFields), descartable y no-modal, que es justo lo que exige el contrato a11y (WCAG 2.2.4). La nota de protocol.ts («materializes with the conversation surface») describía UNA opción y se leía como necesidad: corregida ahí y en la doctrina §7. DESCARTADO Entrada de delegación global siempre-disponible: roza el modo ambiental, que está FIRMADO FUERA (⚖️1), y no se recupera por la puerta de atrás. La entrada es un patrón con pieles montado en app-land — mismo veredicto que la review-card. Handoff `continue-agente-2026-07.md` reescrito para mañana: la spec DRAFT es lo primero, luego el kit de fixtures, luego F4b con los dueños ya firmados. Verificado: agent 30/30 · agent:check limpio · docs:check sin errores nuevos (el único es el preexistente ajeno de callout). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	3 months ago
dev	e10eed98cc	uix(aura): la superficie visible del agente — anillo de custodia, orbe-contorno y desenlaces expresados ... Rediseño dirigido por el usuario sobre un banco de mockups con el orbe REAL corriendo dentro. Seis frentes, todos con maquinaria existente: ANILLO DE CUSTODIA (parte nueva `Aura.Ring`, morfo+soma+eidos) El estado se lee como FORMA y no solo como tinte: raíl punteado en reposo, arco que respira al ofrecerse, segmentos = pasos del plan (laten), dos arcos enfrentados y QUIETOS esperando tu revisión (la quietud lo separa de acting), arco que gira actuando, anillo cerrado + pulso saliente cuando te necesita. Envuelve al Indicator (es su marco de referencia, no un hermano posicionado a mano). El movimiento continuo son loops REGISTRADOS (data-animation-style), nunca @keyframes de receta (R-4.5) — vienen con su puerta de reduced-motion, donde el dash sigue distinguiendo el estado. El attr va en los hijos del SVG, jamás en la parte: motionAttrs() estampa además data-state, del morfo ahí. EL ORBE ES UN CONTORNO `thickness` en el efecto orb; el hueco es real (alfa propia) sobre cualquier fondo. Se va la rama claro/oscuro y el parámetro backgroundColor: el shader mezclaba con el fondo y derivaba el alfa del canal máximo, o sea pintaba un disco OPACO del color de la superficie justo en el centro (en claro un círculo relleno; en oscuro el azul del seed). Y la receta deja de pintar su disco en cuanto monta el canvas (:has(canvas)) — solo sobrevive donde no hay render vivo: SSR, tests, effect={false}, sin WebGL. COLOR = TOKENS DE ROL, PINTADO Y NO ROTADO colorA/colorB/colorDeep (solid / solid-hover / element) resueltos con eidos.resolveToken y pasados como hex, que es el seam que el propio arte documenta. El hue-delta anterior se medía en OKLCH y se aplicaba en YIQ: risk salía VERDE junto a su propio anillo naranja. ONION EN EL IDIOMA DEL ORBE Prop `look="solid" | "luminous"` (defecto solid: nadie más se entera). En luminous el sector no tiene relleno — filo de luz (pasada borrosa + nítida) y etiqueta en el color del sector; la cuña sigue siendo área táctil. El trigger con snippet propio va BARE: sin disco, sin sombra FAB y sin el salto del hover (el orbe ES el trigger, no su contenido). Medio anillo bottom-center y radios 44/40. El halo respira (loop pulse) y en commit-select da UNA pasada de ping pivotando en el centro real del menú — la firma genérica de commit anima box-shadow, que sobre un path de SVG no hace nada. DESENLACES EXPRESADOS (el hueco real: un fallo era indistinguible de un éxito) Tres eventos terminales con intent INTRÍNSECO — delegate-return (fulfill) / -aborted (sin intent: un decline es ausencia, no pérdida) / -failed (loss) — en vez de un intent dinámico, que no tiene dónde vivir: TriggerOptions no lleva intent y el fromProp del morfo ata a un prop PÚBLICO, no a estado de máquina. Puerto `runs?` opcional en AuraAgentSource porque activeRun ya es null al cerrar (§0: sin él, anuncio genérico). Primeras firmas de la familia delegate en el registro; la de loss es MOVIMIENTO (return-recoil: retirada + descenso), no tinte — no estrena ningún hue. MAPA SEMÁNTICO DE COLOR (demo) Un hue = un significado en toda la superficie: gris=sin agencia · naranja=tu revisión · morado=él actúa · rojo=escalated (exclusivo) · teal=tu sí. El anillo de autoridad reusa los colores de la custodia con el MISMO sentido (Review=risk porque vivirás en reviewing; Auto=primary porque actúa) y los declines pasan a neutral — canon: el intent de un cancel es `absent`. Además el anillo en reposo DELEGA (las tres autoridades abren el run) y se cierra por transición, no siempre que no hay run. Dos guardas del framework corrigieron el diseño por el camino: - BK-FRAME-NO-INTENT rechazó dar intent a una familia de marco sin justificación escrita (excepción A-1): queda el intentRationale — el motor no emite nada y no hay evento evaluable que enmarcar, así que el retorno consolidado es el ÚNICO sitio expresivo del desenlace. - fallbackTarget gana sobre el target del morfo (contrato de TriggerOptions): el sello caía en el provider. Los terminales pasan el Ring cuando existe. Verificado en Chrome real (ventana delante: en segundo plano el navegador congela rAF y ResizeObserver y las medidas mienten): seis estados en claro y oscuro, y un error de transporte REAL apuntando a un puerto muerto → delegate-return-failed · loss · return-recoil sobre el Ring · región «Agente: falló — control devuelto». Tests 478 (morfo 114 · soma/aura 11, +5 casos de desenlace · eidos 353), eidos-lint 0 invalid / 0 class-hooks nuevos, morfo:vocabulary limpio, check en los 73 errores ajenos preexistentes. Pendiente (handoff actualizado): la jerarquía tipográfica del Status (D1 llevaba dos líneas y solo se hizo el anillo) · el pulso de commit-select se corta si el consumidor cierra el anillo al elegir (necesita retención tipo Presence) · D5 la superficie de composición del encargo, decisión abierta. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	3 months ago
dev	e187ab6d72	docs(agent): F3 cerrada · doctrina «The review surface» — split framework/app ... Cierra los dos flecos de F3 tras la corrección del usuario (la review-card con diff era anclaje en dev-tools, sin sentido a nivel framework): - agent.md §7 gana «The review surface»: el FRAMEWORK posee los estados del ciclo expresados perceptualmente (reviewing/escalated con afordancias authorize/reject/cancel — Aura ya las da) + la semántica de «propuesto por otro actor» + los anuncios atribuidos; el APP posee el CONTENIDO de lo que se revisa, en su propio dominio (un documento enseña sus bloques propuestos, un calendario sus eventos pendientes). Una tarjeta-diff estilo git es legítima en una aplicación concreta; jamás canon. - §6 fatiga de aprobación enmendada en el mismo sentido (el cambio concreto en el dominio del app, nunca prosa). - PLAN: F3 CERRADA — review resuelta como doctrina sin componente nuevo; `allowedFamilies` del primer componente actuado reubicada a F2 (su hogar natural es el piloto). Siguiente: F4 por la vía del chat. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago
dev	6be7195f0f	feat(agent): eje agéntico — motor $agent (F1) + Aura + promoción uix.scene ... Materializa el eje ortogonal agéntico del ecosistema: la 8ª familia semántica `delegate` («¿quién actúa ahora?») deja de estar sin materializar. El agente es OTRO ACTOR (LLM, macro, regla, workflow) que actúa por la MISMA API pública del provider; la ruta de llamada no se bifurca, la concreción semántica depende del actor. F0 · Doctrina - docs/architecture/agent.md — la doctrina permanente (capítulo comparativo de referencias + bibliografía de seguridad, máquina estados=verbos, contrato de participación, fila §0, a11y, amenazas). - docs/process/{PLAN,TRIAGE,INFORME}-agent — plan de ejecución con todas las decisiones firmadas (D-AG.1–11 + ⚖️1/2/3), triage de 4 revisores externos, e informe autocontenido para revisión externa. F1 · Motor ($libs/actor + arts/agent, 24º arte) - EngineAgent puro (sin DOM/runes, portable a servidor): máquina D-AG.4 (suggest/review/auto · escalated con reason+timeout · returned outcome-tipado · kill switch · autorización journaled aunque sea auto), tool-loop D-AG.5 (acts secuenciales, fallos→verbos, unknown-capability acotado, idempotencia por callId, presupuestos acts/turns/wall-clock vía puerto de timers), techo de autonomía por origen no confiable (F8b). - ActiveAgent (sesión reactiva, contrato ActiveEngine) · protocolo v1 espejo AG-UI (5 categorías + dirección tipada + reservas) · ScriptedAgentTransport determinista (adapters/ fuera del barrel) · journal WAL + puerto de trazas OTel · emisor sium→JSON Schema. - Acuñación del actor (⚖️2/F6b): ActorToken opaco en $libs/actor (hoja bajo orca/agent), registro privado WeakMap — los forjados resuelven a null; costura `actor?` en TriggerOptions→SemanticSignal (runtime copia verbatim; sema no resuelve). defineActiveAgent (service-factory app-level, timers del core — cero setTimeout a pelo). F3 · Aura — primer componente del eje (ruta 9 fases 0–6) - El materializador canónico de `delegate` (reservado en scene §F6): morfo con los eventos del ciclo (offer/escalate-untilAction/return + sustain-processing stateBound) — PRIMER morfo del ecosistema que emite familia delegate; provider soma que observa un puerto estructural (sin importar $agent — degradación total); orb eidos = aurora $scene modulada por estado (§F6) con fallback CSS = render de reduced-motion; live region única atribuida (WCAG 4.1.3); cancel compone Button (asChild). Demo v2 sobre el MOTOR REAL con compuertas deterministas. Orb-size derivado de la primitiva Avatar (32/40/48). D4 · Promoción uix.scene (Aura llegó) - defineEngineScene + superficie ActiveUix/ActiveEidos/contracts; el orb prefiere el motor compartido (presupuesto de escenas global) con fallback por-superficie. Gates: arts/agent 18/18 · aura 6/6 · arts:check 24 · eidos battery + recipe 30/30 + eidos-lint aura 0 inválidos · morfo:vocabulary + esquemas · smoke aura PASS · verificado en navegador (ciclo completo + estampa delegate en DOM + aurora WebGL pintando). Los tokens de recipe base.ts + CSS generado ya entraron en HEAD vía una sesión concurrente. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago