evol-dd 0.1.0__py3-none-any.whl

evol_cli/VERSION

@@ -0,0 +1 @@
+0.1.0

evol_cli/__init__.py

@@ -0,0 +1,173 @@
+"""evol_cli — Entry-point dispatcher para Evol-DD.
+
+NO reescribe los scripts (patron ADR-0008 de X-DD: consolidacion CLI diferida).
+Cada entry-point es un dispatcher fino que ejecuta el script correspondiente.
+
+Resolucion de paths (mismo patron que xdd_cli — fix aprendido de X-DD):
+  1. EVOL_SCRIPTS_DIR / EVOL_DATA_DIR si estan seteados.
+  2. Instalacion editable: directorio junto al repo (../../scripts desde src/evol_cli).
+  3. Data del wheel: directorio empaquetado dentro del paquete (evol_cli/<dir>).
+
+Bug historico corregido preventivamente: pyproject.toml empaqueta TODOS los
+data dirs (manifests/, templates/, .agent/, skills/, docs/, VERSION) para que
+evol --version y evol init --list-profiles funcionen en instalacion pipx/wheel.
+"""
+from __future__ import annotations
+
+import os
+import runpy
+import subprocess
+import sys
+from pathlib import Path
+
+
+def _resolve_version() -> str:
+    try:
+        from importlib.metadata import PackageNotFoundError, version
+        return version("evol-dd")
+    except (ImportError, Exception):
+        pass
+    # Fallback: leer VERSION desde data dir
+    try:
+        return (_data_dir() / "VERSION").read_text(encoding="utf-8").strip()
+    except Exception:
+        return "0.1.0-dev"
+
+
+def _scripts_dir() -> Path:
+    """Resuelve el directorio scripts/ con logica de 3 niveles."""
+    env = os.environ.get("EVOL_SCRIPTS_DIR")
+    if env:
+        return Path(env)
+    here = Path(__file__).resolve().parent
+    # editable: repo_root/src/evol_cli → repo_root/scripts
+    repo_scripts = here.parent.parent / "scripts"
+    if repo_scripts.is_dir():
+        return repo_scripts
+    # wheel: scripts empaquetado como data dentro del paquete
+    bundled = here / "scripts"
+    if bundled.is_dir():
+        return bundled
+    raise FileNotFoundError(
+        "No encuentro scripts/ Evol-DD. Setea EVOL_SCRIPTS_DIR al directorio scripts/."
+    )
+
+
+def _data_dir() -> Path:
+    """Raiz de los data dirs (manifests/, templates/, .agent/, skills/, docs/, VERSION).
+
+    Misma logica de 3 niveles que _scripts_dir().
+    Los scripts bash reciben esta ruta como EVOL_DATA_DIR para no depender de
+    dirname(BASH_SOURCE) relativo, que rompe en instalaciones pipx/wheel.
+    """
+    env = os.environ.get("EVOL_DATA_DIR")
+    if env:
+        return Path(env)
+    here = Path(__file__).resolve().parent
+    # editable: repo_root/src/evol_cli → repo_root/
+    repo_root = here.parent.parent
+    if (repo_root / "manifests").is_dir():
+        return repo_root
+    # wheel: data empaquetado dentro del paquete (evol_cli/ contiene manifests/, etc.)
+    if (here / "manifests").is_dir():
+        return here
+    return here
+
+
+__version__ = _resolve_version()
+
+SCRIPTS = {
+    "gate":        "evol-gate.py",
+    "eval":        "evol-eval.py",
+    "flow":        "evol-flow.py",
+    "provider":    "evol-provider.py",
+    "shield":      "evol-shield.py",
+    "orchestrate": "evol-orchestrate.py",
+    "agent":       "evol-agent-lifecycle.py",
+    "evolve":      "evol-evolve.py",
+    "research":    "evol-researcher.py",
+    "memory":      "evol-memory.py",
+    "lessons":     "evol-lessons.py",
+    "update":      "evol-update.py",
+}
+
+SHELL_SCRIPTS = {
+    "init":           "evol-init.sh",
+    "start":          "evol-start.sh",
+    "adapt":          "evol-adapt.sh",
+    "doctor":         "evol-doctor.sh",
+    "brand":          "evol-brand.sh",
+    "global-install": "evol-global-install.sh",
+}
+
+
+def _run(script_name: str) -> int:
+    script = _scripts_dir() / script_name
+    if not script.exists():
+        print(f"[evol] script no encontrado: {script}", file=sys.stderr)
+        return 2
+    sys.argv = [str(script)] + sys.argv[1:]
+    try:
+        runpy.run_path(str(script), run_name="__main__")
+    except SystemExit as e:
+        return int(e.code) if isinstance(e.code, int) else (0 if e.code is None else 1)
+    return 0
+
+
+def _run_shell(script_name: str, args: list[str]) -> int:
+    """Ejecuta un script .sh con bash, inyectando EVOL_DATA_DIR."""
+    script = _scripts_dir() / script_name
+    if not script.exists():
+        print(f"[evol] script no encontrado: {script}", file=sys.stderr)
+        return 2
+    env = os.environ.copy()
+    env.setdefault("EVOL_DATA_DIR", str(_data_dir()))
+    return subprocess.call(["bash", str(script), *args], env=env)
+
+
+def _usage() -> None:
+    print(f"evol {__version__} — Evol-DD CLI")
+    print("\nComandos Python:")
+    for name in sorted(SCRIPTS):
+        print(f"  {name}")
+    print("\nComandos Bash:")
+    for name in sorted(SHELL_SCRIPTS):
+        print(f"  {name}")
+    print("\nEj: evol gate status · evol init /mi-proyecto · evol doctor")
+
+
+def main(argv: list[str] | None = None) -> int:
+    argv = list(sys.argv[1:] if argv is None else argv)
+    if not argv or argv[0] in ("-h", "--help"):
+        _usage()
+        return 0
+    if argv[0] in ("-v", "--version"):
+        print(f"evol-dd {__version__}")
+        return 0
+    sub, rest = argv[0], argv[1:]
+    if sub in SCRIPTS:
+        sys.argv = [SCRIPTS[sub]] + rest
+        return _run(SCRIPTS[sub])
+    if sub in SHELL_SCRIPTS:
+        return _run_shell(SHELL_SCRIPTS[sub], rest)
+    print(f"[evol] subcomando desconocido: {sub!r}", file=sys.stderr)
+    _usage()
+    return 2
+
+
+# Entry-points individuales
+def gate():        sys.argv = ["evol-gate"] + sys.argv[2:]; _run(SCRIPTS["gate"])
+def eval_():       sys.argv = ["evol-eval"] + sys.argv[2:]; _run(SCRIPTS["eval"])
+def flow():        sys.argv = ["evol-flow"] + sys.argv[2:]; _run(SCRIPTS["flow"])
+def provider():    sys.argv = ["evol-provider"] + sys.argv[2:]; _run(SCRIPTS["provider"])
+def shield():      sys.argv = ["evol-shield"] + sys.argv[2:]; _run(SCRIPTS["shield"])
+def orchestrate(): sys.argv = ["evol-orchestrate"] + sys.argv[2:]; _run(SCRIPTS["orchestrate"])
+def agent():       sys.argv = ["evol-agent"] + sys.argv[2:]; _run(SCRIPTS["agent"])
+def evolve():      sys.argv = ["evol-evolve"] + sys.argv[2:]; _run(SCRIPTS["evolve"])
+def research():    sys.argv = ["evol-research"] + sys.argv[2:]; _run(SCRIPTS["research"])
+def memory():      sys.argv = ["evol-memory"] + sys.argv[2:]; _run(SCRIPTS["memory"])
+def lessons():     sys.argv = ["evol-lessons"] + sys.argv[2:]; _run(SCRIPTS["lessons"])
+
+
+if __name__ == "__main__":
+    sys.exit(main())

evol_cli/agent/hooks/hooks.json

@@ -0,0 +1,78 @@
+{
+  "version": "1.0",
+  "profiles": {
+    "minimal": [
+      {
+        "id": "post:edit:mempalace-index",
+        "event": "PostToolUse",
+        "enabled": true,
+        "script": "post-edit-mempalace-index.sh",
+        "trigger": "edit"
+      }
+    ],
+    "standard": [
+      {
+        "id": "pre:bash:dangerous-command",
+        "event": "PreToolUse",
+        "enabled": true,
+        "script": "pre-bash-dangerous-command.sh",
+        "trigger": "bash"
+      },
+      {
+        "id": "pre:write:doc-file-warning",
+        "event": "PreToolUse",
+        "enabled": true,
+        "script": "pre-write-doc-file-warning.sh",
+        "trigger": "write"
+      },
+      {
+        "id": "post:bash:pr-logger",
+        "event": "PostToolUse",
+        "enabled": true,
+        "script": "post-bash-pr-logger.sh",
+        "trigger": "bash"
+      },
+      {
+        "id": "post:write:auto-organize",
+        "event": "PostToolUse",
+        "enabled": true,
+        "script": "post-write-auto-organize.sh",
+        "trigger": "write"
+      },
+      {
+        "id": "session:start:context-load",
+        "event": "SessionStart",
+        "enabled": true,
+        "script": "session-start-context-load.sh"
+      },
+      {
+        "id": "stop:git-check",
+        "event": "Stop",
+        "enabled": true,
+        "script": "stop-git-check.sh"
+      }
+    ],
+    "strict": [
+      {
+        "id": "pre:edit:config-protection",
+        "event": "PreToolUse",
+        "enabled": true,
+        "script": "pre-edit-config-protection.sh",
+        "trigger": "edit"
+      },
+      {
+        "id": "pre:tool:temporal-awareness",
+        "event": "PreToolUse",
+        "enabled": true,
+        "script": "pre-tool-temporal-awareness.sh"
+      },
+      {
+        "id": "stop:pattern-extraction",
+        "event": "Stop",
+        "enabled": true,
+        "script": "stop-pattern-extraction.sh"
+      }
+    ]
+  },
+  "default_profile": "standard"
+}

evol_cli/agent/hooks/scripts/post-bash-pr-logger.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# PostToolUse hook: Log PR URL after gh pr create
+
+OUTPUT="$1"
+if echo "$OUTPUT" | grep -q "github.com.*pull/"; then
+    URL=$(echo "$OUTPUT" | grep -oE "https://github.com/[^ ]+/pull/[0-9]+" | head -1)
+    echo "[HOOK] PR Created: $URL"
+fi
+exit 0

evol_cli/agent/hooks/scripts/post-edit-mempalace-index.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# PostToolUse hook: Re-index MemPalace (async)
+
+if command -v mempalace >/dev/null 2>&1; then
+    (mempalace index --wing evol-dd --path . 2>/dev/null || true) &
+fi
+exit 0

evol_cli/agent/hooks/scripts/post-write-auto-organize.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# PostToolUse hook: Move docs to canonical paths
+
+DEST="$1"
+if [ -f "$DEST" ]; then
+    case "$DEST" in
+        *architecture*.md) [ ! -d "docs/arquitectura" ] && mkdir -p "docs/arquitectura" ;;
+        *requisitos*.md) [ ! -d "docs/requisitos" ] && mkdir -p "docs/requisitos" ;;
+        *qa*.md|*test*.md) [ ! -d "docs/qa" ] && mkdir -p "docs/qa" ;;
+        *seguridad*.md|*security*.md) [ ! -d "docs/seguridad" ] && mkdir -p "docs/seguridad" ;;
+    esac
+fi
+exit 0

evol_cli/agent/hooks/scripts/pre-bash-dangerous-command.sh

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+# PreToolUse hook: Block dangerous commands
+# Exit 0 = allow, Exit 2 = block
+
+set -euo pipefail
+
+INPUT=$(cat)
+COMMAND="$INPUT"
+
+# Try parse JSON if available (Claude Code passes structured input)
+if echo "$INPUT" | grep -q '^{'; then
+    COMMAND=$(echo "$INPUT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('command','') or d.get('prompt','') or '')" 2>/dev/null || echo "$INPUT")
+fi
+
+# Logging without secrets
+log_blocked() {
+    local reason="$1"
+    local hook_log="${HOOK_LOG:-.agent/hooks/.hook-blocked.log}"
+    echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] BLOCKED: $reason" >> "$hook_log" 2>/dev/null || true
+}
+
+BLOCKED=0
+
+# Block: rm -rf on root
+if echo "$COMMAND" | grep -qE 'rm[[:space:]]+-rf[[:space:]]+/?$'; then
+    echo "[evol-hook] BLOQUEADO: rm -rf /" >&2
+    log_blocked "rm -rf /"
+    BLOCKED=1
+fi
+
+# Block: rm -rf on home directory
+if echo "$COMMAND" | grep -qE 'rm[[:space:]]+-rf[[:space:]]+~'; then
+    echo "[evol-hook] BLOQUEADO: rm -rf ~" >&2
+    log_blocked "rm -rf ~"
+    BLOCKED=1
+fi
+
+# Block: rm -rf on protected system directories
+if echo "$COMMAND" | grep -qE 'rm[[:space:]]+-rf[[:space:]]+(--[[:space:]]+)?/(etc|usr|bin|sbin|lib|boot|root|var|opt|dev|sys)'; then
+    echo "[evol-hook] BLOQUEADO: rm -rf sobre directorio de sistema" >&2
+    log_blocked "rm -rf /etc|/usr|/bin|..."
+    BLOCKED=1
+fi
+
+# Block: dd if= (disk dump)
+if echo "$COMMAND" | grep -qE 'dd[[:space:]]+if='; then
+    echo "[evol-hook] BLOQUEADO: dd if= (operacion de disco cruda)" >&2
+    log_blocked "dd if="
+    BLOCKED=1
+fi
+
+# Block: mkfs (filesystem creation)
+if echo "$COMMAND" | grep -qE 'mkfs'; then
+    echo "[evol-hook] BLOQUEADO: mkfs (creacion de filesystem)" >&2
+    log_blocked "mkfs"
+    BLOCKED=1
+fi
+
+# Block: chmod -R 777
+if echo "$COMMAND" | grep -qE 'chmod[[:space:]]+(-R[[:space:]]+|-R )?777'; then
+    echo "[evol-hook] BLOQUEADO: chmod 777 o chmod -R 777" >&2
+    log_blocked "chmod 777"
+    BLOCKED=1
+fi
+
+# Block: curl | sh / wget | sh
+if echo "$COMMAND" | grep -qE '(curl|wget)[[:space:]].*[|][[:space:]]*(ba)?sh'; then
+    echo "[evol-hook] BLOQUEADO: curl/wget pipe a shell" >&2
+    log_blocked "curl|wget | sh"
+    BLOCKED=1
+fi
+
+# Block: bash <(curl ...)
+if echo "$COMMAND" | grep -qE 'bash[[:space:]]*<[[:space:]]*\((curl|wget)'; then
+    echo "[evol-hook] BLOQUEADO: process substitution con curl/wget" >&2
+    log_blocked "bash <(curl...)"
+    BLOCKED=1
+fi
+
+# Block: sudo without authorized context
+if echo "$COMMAND" | grep -qE '^sudo[[:space:]]' && [ -z "${EVOL_SUDO_AUTHORIZED:-}" ]; then
+    echo "[evol-hook] BLOQUEADO: sudo sin autorizacion explicita (EVOL_SUDO_AUTHORIZED no esta definido)" >&2
+    log_blocked "sudo without EVOL_SUDO_AUTHORIZED"
+    BLOCKED=1
+fi
+
+# Block: git push --force / --force-with-lease to protected branches
+PROTECTED_BRANCHES="main|master|develop"
+if echo "$COMMAND" | grep -qE "git[[:space:]]+push[[:space:]].*(--force-with-lease|--force-with-lease=.*)[[:space:]].*($PROTECTED_BRANCHES)"; then
+    echo "[evol-hook] BLOQUEADO: git push --force-with-lease a rama protegida" >&2
+    log_blocked "git push --force-with-lease"
+    BLOCKED=1
+fi
+
+if echo "$COMMAND" | grep -qE "git[[:space:]]+push[[:space:]].*(-f|--force)[[:space:]].*($PROTECTED_BRANCHES)"; then
+    echo "[evol-hook] BLOQUEADO: git push --force a rama protegida" >&2
+    log_blocked "git push --force"
+    BLOCKED=1
+fi
+
+if [ "$BLOCKED" -eq 1 ]; then
+    exit 2
+fi
+
+exit 0

evol_cli/agent/hooks/scripts/pre-commit-gitflow.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# Pre-commit hook: Enforce GitFlow branch naming
+
+BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null || echo "")
+
+if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "develop" ]; then
+    exit 0
+fi
+
+ALLOWED='^(feature/|fix/|hotfix/|release/|chore/|docs/|refactor/)'
+if ! [[ "$BRANCH" =~ $ALLOWED ]]; then
+    echo "[HOOK] BLOCKED: Branch '$BRANCH' does not follow GitFlow convention"
+    echo "[HOOK] Allowed: feature/*, fix/*, hotfix/*, release/*, chore/*, docs/*, refactor/*"
+    exit 1
+fi
+
+# Check conventional commits
+if [ -f ".git/COMMIT_EDITMSG" ]; then
+    MSG=$(head -1 .git/COMMIT_EDITMSG)
+    if ! [[ "$MSG" =~ ^(feat|fix|docs|style|refactor|test|chore|perf|ci|build|revert) ]]; then
+        echo "[HOOK] WARN: Commit message should follow Conventional Commits"
+    fi
+fi
+
+exit 0

evol_cli/agent/hooks/scripts/pre-edit-config-protection.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# PreToolUse hook: Block governance file edits without evol-gate approval
+# Exit 0 = allow, Exit 2 = block
+
+set -euo pipefail
+
+HOOK_LOG="${HOOK_LOG:-.agent/hooks/.hook-blocked.log}"
+GATE_LOG=".evol/.gate-log.jsonl"
+
+log_blocked() {
+    local reason="$1"
+    echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] BLOCKED: $reason" >> "$HOOK_LOG" 2>/dev/null || true
+}
+
+PROTECTED_FILES="constitucion.md gates.md hooks.json .gate-key .gate-log.jsonl"
+PROTECTED_PATTERNS="constitucion.md gates.md hooks.json"
+
+# Check if evol-gate approve was run recently (within 1 hour)
+check_gate_approval() {
+    if [ ! -f "$GATE_LOG" ]; then
+        return 1
+    fi
+    local last_approve
+    last_approve=$(grep -c '"phase"' "$GATE_LOG" 2>/dev/null || echo "0")
+    if [ "$last_approve" -gt 0 ]; then
+        return 0
+    fi
+    return 1
+}
+
+GATE_APPROVED=0
+if check_gate_approval; then
+    GATE_APPROVED=1
+fi
+
+BLOCKED=0
+for pattern in $PROTECTED_PATTERNS; do
+    if [[ "$1" == *"$pattern"* ]]; then
+        if [ "$GATE_APPROVED" -eq 1 ]; then
+            echo "[evol-hook] WARN: editing governance file: $pattern (gate approved)" >&2
+        else
+            echo "[evol-hook] BLOQUEADO: edicion de archivo de gobernanza '$pattern' requiere evol-gate approve" >&2
+            log_blocked "governance-edit:$pattern without gate"
+            BLOCKED=1
+        fi
+    fi
+done
+
+if [ "$BLOCKED" -eq 1 ]; then
+    exit 2
+fi
+
+exit 0

evol_cli/agent/hooks/scripts/pre-tool-temporal-awareness.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# PreToolUse hook: Inject sprint context
+
+SPRINT_FILE=".sprint-active"
+if [ -f "$SPRINT_FILE" ]; then
+    echo "[HOOK] Active Sprint: $(cat "$SPRINT_FILE")"
+fi
+exit 0

evol_cli/agent/hooks/scripts/pre-write-doc-file-warning.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# PreToolUse hook: Warn if doc file outside canonical paths
+
+DEST="$1"
+CANONICAL_DOCS="docs/ .claude/ .opencode/ AGENTS.md CLAUDE.md memoria.md"
+
+if [[ "$DEST" =~ \.md$ ]]; then
+    IN_CANONICAL=false
+    for path in $CANONICAL_DOCS; do
+        if [[ "$DEST" == "$path"* ]]; then
+            IN_CANONICAL=true
+            break
+        fi
+    done
+    if [ "$IN_CANONICAL" = false ]; then
+        echo "[HOOK] WARN: Writing .md outside canonical paths: $DEST"
+    fi
+fi
+exit 0

evol_cli/agent/hooks/scripts/session-start-context-load.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# SessionStart hook: Load memoria.md and WORKING-CONTEXT
+
+echo "=== Working Context ==="
+
+if [ -f "memoria.md" ]; then
+    echo "--- memoria.md ---"
+    head -30 memoria.md
+fi
+
+if [ -f "WORKING-CONTEXT.md" ]; then
+    echo "--- WORKING-CONTEXT.md ---"
+    cat WORKING-CONTEXT.md
+fi
+
+echo "==================="
+exit 0

evol_cli/agent/hooks/scripts/session-start-reme-load.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# Hook: session:start:reme-load — carga MEMORY.md + journal anterior via evol-memory.py nativo.
+# Perfil: minimal+. Requiere EVOL_MEMORY=1. Sin dependencias externas.
+# No-op si EVOL_MEMORY != 1. Exit 0 siempre.
+set -eu
+
+if [ "${EVOL_MEMORY:-0}" != "1" ]; then
+  exit 0
+fi
+
+SCRIPTS_DIR="$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )/../../.." && pwd )/scripts"
+PROJECT_DIR="${PWD}"
+
+if [ ! -f "$SCRIPTS_DIR/evol-memory.py" ]; then
+  echo "[evol-memory] WARN: evol-memory.py no encontrado en $SCRIPTS_DIR" >&2
+  exit 0
+fi
+
+python3 "$SCRIPTS_DIR/evol-memory.py" --project "$PROJECT_DIR" load
+exit 0

evol_cli/agent/hooks/scripts/stop-git-check.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# Stop hook: Warn if uncommitted changes
+
+if [ -d ".git" ]; then
+    UNCOMMITTED=$(git status --porcelain 2>/dev/null | wc -l)
+    if [ "$UNCOMMITTED" -gt 0 ]; then
+        echo "[HOOK] WARN: $UNCOMMITTED uncommitted changes"
+        echo "[HOOK] Run: git add . && git commit -m '...'"
+    fi
+fi
+exit 0

evol_cli/agent/hooks/scripts/stop-pattern-extraction.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Stop hook: Extract patterns for instincts
+
+if command -v python3 >/dev/null 2>&1; then
+    if [ -f "scripts/evol-state.py" ]; then
+        python3 scripts/evol-state.py record-instinct \
+            --pattern "session_pattern" \
+            --context "auto-extracted" \
+            --confidence 0.3 \
+            --source "stop-hook" 2>/dev/null || true
+    fi
+fi
+exit 0

evol_cli/agent/hooks/scripts/stop-reme-summary.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+# Hook: stop:reme-summary — persiste sesion en memory/YYYY-MM-DD.md via evol-memory.py nativo.
+# Perfil: minimal+. Requiere EVOL_MEMORY=1. Sin dependencias externas.
+# No-op si EVOL_MEMORY != 1. Exit 0 siempre (no bloquea cierre de sesion).
+set -eu
+
+if [ "${EVOL_MEMORY:-0}" != "1" ]; then
+  exit 0
+fi
+
+SCRIPTS_DIR="$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )/../../.." && pwd )/scripts"
+PROJECT_DIR="${PWD}"
+
+if [ ! -f "$SCRIPTS_DIR/evol-memory.py" ]; then
+  echo "[evol-memory] WARN: evol-memory.py no encontrado" >&2
+  exit 0
+fi
+
+# El evento Stop puede proveer JSON de mensajes via stdin — guardarlo en tmp
+TMPFILE=$(mktemp /tmp/evol-memory-XXXXXX.jsonl 2>/dev/null || echo "")
+if [ -n "$TMPFILE" ]; then
+  cat > "$TMPFILE" 2>/dev/null || true
+  if [ -s "$TMPFILE" ]; then
+    python3 "$SCRIPTS_DIR/evol-memory.py" --project "$PROJECT_DIR" summarize --messages "$TMPFILE" &
+  else
+    python3 "$SCRIPTS_DIR/evol-memory.py" --project "$PROJECT_DIR" summarize &
+  fi
+  rm -f "$TMPFILE"
+else
+  python3 "$SCRIPTS_DIR/evol-memory.py" --project "$PROJECT_DIR" summarize &
+fi
+
+# gc de tool_result/ vencidos (async, en background)
+python3 "$SCRIPTS_DIR/evol-memory.py" --project "$PROJECT_DIR" gc &
+
+exit 0

evol_cli/agent/workflows/a11y-audit.md

@@ -0,0 +1,56 @@
+---
+description: Auditoría de accesibilidad WCAG 2.1 AA. Automatizada en CI + revisión humana de flujos críticos.
+name: a11y-audit
+trigger: /evol a11y-audit
+---
+# /a11y-audit
+
+> **Estandar de documentacion:** Todo artefacto que produzca este workflow cumple
+> [`docs/DOC_STANDARD.md`](../../docs/DOC_STANDARD.md): sin emojis, diagramas Mermaid
+> obligatorios, tablas para datos estructurados, Gherkin donde aplique, secciones
+> minimas y trazabilidad bidireccional.
+**ID:** FLUJO-A11Y | **Versión:** 1.0 | **Agente:** Frontend-Developer + Accessibility-Auditor
+**Misión:** Producto usable para personas con discapacidad. WCAG 2.1 AA mínimo, AAA donde sea razonable.
+
+## 0. Pre-flight
+- Solo aplica si el producto tiene UI (web, mobile, desktop).
+
+## 1. Cobertura automática (CI)
+<!-- CONFIGURAR: Herramientas.                                                 -->
+<!--  - Web: axe-core (Playwright/Cypress), Pa11y, Lighthouse a11y              -->
+<!--  - Mobile: Accessibility Scanner (Android), Accessibility Inspector (iOS)  -->
+<!--  - Design system: Storybook + axe addon                                    -->
+
+Tests automatizados verifican:
+- Contraste de color (4.5:1 texto normal, 3:1 large)
+- Roles ARIA correctos, no abusivos
+- Labels en todos los form controls
+- Foco visible y orden lógico
+- Alternativas de texto en imágenes
+
+## 2. Cobertura manual (no automatizable)
+Revisión humana de flujos críticos (signup, checkout, settings):
+- **Teclado**: navegación 100% con teclado, sin trampas de foco
+- **Lector de pantalla**: VoiceOver (macOS/iOS) + NVDA (Windows) + TalkBack (Android)
+- **Zoom 200%** sin pérdida de contenido ni scroll horizontal
+- **Reduce motion**: respetar `prefers-reduced-motion`
+- **Color**: información no solo por color (probar con simulador daltonismo)
+
+## 3. Componentes
+- Design system con componentes accesibles por construcción.
+- Cada componente nuevo trae tests a11y antes de merge.
+- Documentación de patrones (modales, menús, formularios) sigue ARIA Authoring Practices Guide.
+
+## 4. Contenido
+- Estructura semántica (h1-h6 correctos, landmarks).
+- Idioma declarado (`<html lang>`) — cruzar con `/i18n-setup`.
+- Vídeos con subtítulos, transcripciones de audio.
+
+## 5. CI gate
+- PR bloquea si violación nivel `serious` o `critical`.
+- Violaciones `moderate` permitidas con justificación temporal y issue trackeado.
+
+## 6. Cierre
+- Reporte a `qa-review` Tier 2.
+- Hallazgos críticos a `lecciones.md`.
+- Roadmap de mejoras a11y mantenido (no "lo arreglamos cuando podamos").