@cristiancorreau/forge 2.9.6 → 2.9.7

package/assets/adapters/codex/generate-codex-config.py

@@ -1,269 +0,0 @@
-#!/usr/bin/env python3
-# Copyright 2026 Cristian Correa — Apache License 2.0
-# https://github.com/cristiancorreau/forge
-"""
-generate-codex-config.py — Genera AGENTS.md para Codex CLI (OpenAI).
-
-Usage:
-  python3 .agentic/adapters/codex/generate-codex-config.py
-
-Lee project.yaml en la raíz y genera AGENTS.md enriquecido para Codex CLI.
-
-Diferencias respecto al adapter OpenCode:
-  - Incluye sección "Workflow SDD" con pasos explícitos (Codex opera autónomamente)
-  - Incluye "Security rules" y "Autonomy limits" inline (crítico para ejecución sin supervisión)
-  - Header identifica el archivo como generado para Codex CLI
-
-Codex CLI lee AGENTS.md desde la raíz del repositorio como contexto del agente.
-Referencia: https://github.com/openai/codex
-
-Requiere: pyyaml
-"""
-from __future__ import annotations
-
-import sys
-from pathlib import Path
-
-try:
-    import yaml
-except ImportError:
-    print("ERROR: pyyaml requerido. pip install pyyaml", file=sys.stderr)
-    sys.exit(1)
-
-
-def find_project_root() -> Path:
-    here = Path.cwd()
-    for p in [here] + list(here.parents):
-        if (p / "project.yaml").exists():
-            return p
-    raise FileNotFoundError("No se encontró project.yaml")
-
-
-def find_forge_dir() -> Path:
-    root = find_project_root()
-    for candidate in [root / ".agentic", root / "forge", Path(__file__).parent.parent.parent]:
-        if (candidate / "core").exists():
-            return candidate
-    raise FileNotFoundError("No se encontró el directorio forge con core/")
-
-
-def read_agent_description(forge: Path, name: str, profiles: list[str]) -> str:
-    """Lee el frontmatter description del agente desde forge (profiles > core)."""
-    for profile in profiles:
-        p = forge / "profiles" / profile / "agents" / f"{name}.md"
-        if p.exists():
-            content = p.read_text()
-            for line in content.splitlines():
-                if line.startswith("description:"):
-                    return line.split(":", 1)[1].strip().strip('"')
-    p = forge / "core" / "agents" / f"{name}.md"
-    if p.exists():
-        content = p.read_text()
-        for line in content.splitlines():
-            if line.startswith("description:"):
-                return line.split(":", 1)[1].strip().strip('"')
-    return "Agente de implementación"
-
-
-def generate_agents_md(config: dict, forge: Path) -> str:
-    """
-    Genera AGENTS.md enriquecido para Codex CLI.
-
-    Codex CLI opera autónomamente en terminal: las reglas de seguridad y los
-    límites de autonomía deben estar inline en AGENTS.md, no en un archivo
-    separado, para que el agente las reciba como contexto en cada sesión.
-    """
-    proj = config.get("project", {})
-    agents_cfg = config.get("agents", {})
-    compliance_cfg = config.get("compliance", {})
-    stack = config.get("stack", {})
-    paths = config.get("paths", {})
-
-    name = proj.get("name", "Mi Proyecto")
-    description = proj.get("description", "")
-    language = proj.get("language", "typescript")
-    active = agents_cfg.get("active", [])
-    compliance = agents_cfg.get("compliance", [])
-    specialized = agents_cfg.get("specialized", [])
-    profiles = agents_cfg.get("profiles", [])
-    frameworks = compliance_cfg.get("frameworks", [])
-    specs_path = paths.get("specs", "docs/specs")
-
-    if frameworks and "compliance-reviewer" not in active + compliance:
-        compliance = list(set(compliance + ["compliance-reviewer"]))
-
-    lines = [
-        f"# AGENTS.md — {name}",
-        "",
-        f"> Generado por forge (adapter Codex CLI).",
-        f"> Fuente de verdad: `project.yaml`. Re-ejecutar `generate-codex-config.py` al cambiar agentes.",
-        "",
-    ]
-
-    if description:
-        lines += [description, ""]
-
-    lines += [
-        "## Stack",
-        "",
-        f"- **Lenguaje:** {language}",
-        f"- **Backend:** {stack.get('backend') or 'N/A'}",
-        f"- **Frontend:** {stack.get('frontend') or 'N/A'}",
-        f"- **Base de datos:** {stack.get('database') or 'N/A'}",
-        f"- **Testing:** {', '.join(stack.get('testing', []))}",
-        "",
-        "## Workflow: Spec-Driven Development",
-        "",
-        "Antes de implementar cualquier feature:",
-        "",
-        f"1. Verificar que existe una spec en `{specs_path}/`.",
-        "2. Si no existe, crearla y esperar aprobación antes de codificar.",
-        "3. Implementar con tests junto al código, no al final.",
-        "4. Actualizar la spec con decisiones tomadas durante la implementación.",
-        "",
-        "## Reglas de seguridad (no negociables)",
-        "",
-        "- Sin hardcodear tokens, passwords ni secrets — usar variables de entorno.",
-        "- Parámetros preparados en todas las queries SQL — nunca concatenar input del usuario.",
-        "- PII nunca en logs de stdout.",
-        "- Verificar autenticación Y autorización en cada endpoint de API.",
-        "- Sin force push a main/master.",
-        "",
-        "## Límites de autonomía",
-        "",
-        "- Modificar solo archivos dentro del scope declarado del agente.",
-        "- Preguntar antes de eliminar archivos o ejecutar comandos destructivos.",
-        "- Nunca hacer commit directo a main/master.",
-        "- Correr los tests antes de marcar una tarea como completa.",
-        "- Si una tarea requiere acceso a credenciales no disponibles, detenerse y reportar.",
-        "",
-        "## Roster de agentes",
-        "",
-    ]
-
-    if active:
-        lines += ["### Activos", ""]
-        for agent in active:
-            desc = read_agent_description(forge, agent, profiles)
-            lines.append(f"#### `{agent}`")
-            lines.append(desc)
-            lines.append("")
-
-    if compliance:
-        lines += ["### Compliance y revisión", ""]
-        for agent in compliance:
-            desc = read_agent_description(forge, agent, profiles)
-            lines.append(f"#### `{agent}`")
-            lines.append(desc)
-            lines.append("")
-
-    if specialized:
-        lines += ["### Especializados del proyecto", ""]
-        for agent in specialized:
-            desc = read_agent_description(forge, agent, profiles)
-            lines.append(f"#### `{agent}`")
-            lines.append(desc)
-            lines.append("")
-
-    if frameworks:
-        lines += [
-            "## Compliance activo",
-            "",
-            f"Marcos regulatorios: {', '.join(f.upper() for f in frameworks)}",
-            "",
-            "Incluir `compliance-reviewer` en toda tarea que toque:",
-            "- Datos de usuarios o consentimientos",
-            "- Logs de auditoría",
-            "- Endpoints de derechos del titular (DSAR)",
-            "",
-        ]
-
-    lines += [
-        "## Forge v2 Commands",
-        "",
-        "Codex CLI no soporta slash commands. Usa las plantillas de prompt de",
-        "`adapters/codex/commands/` copiando su contenido directamente en tu sesión.",
-        "",
-        "| Comando | Archivo | Cuándo usarlo |",
-        "|---------|---------|---------------|",
-        "| plan | `adapters/codex/commands/plan.md` | Antes de implementar — verifica o crea la spec |",
-        "| work | `adapters/codex/commands/work.md` | Implementar una feature con spec APPROVED |",
-        "| review | `adapters/codex/commands/review.md` | Revisar código o cambios antes del merge |",
-        "| ship | `adapters/codex/commands/ship.md` | Verificar que el proyecto está listo para deploy |",
-        "| session-start | `adapters/codex/commands/session-start.md` | Al iniciar cada sesión de trabajo |",
-        "| session-close | `adapters/codex/commands/session-close.md` | Al cerrar cada sesión de trabajo |",
-        "",
-        "### Flujo SDD recomendado",
-        "",
-        "```",
-        "1. session-start   → verificar ambiente y branch",
-        "2. plan            → spec antes que código (DRAFT → APPROVED)",
-        "3. work            → implementar con tests (spec APPROVED → IMPLEMENTED)",
-        "4. review          → checklist de seguridad y calidad",
-        "5. ship            → verificar build, tests y variables antes del deploy",
-        "6. session-close   → registrar progreso y limpiar",
-        "```",
-        "",
-        "## Reglas de producción (pre-bash-check)",
-        "",
-        "Los siguientes comandos están bloqueados en contexto de producción.",
-        "Si necesitás ejecutarlos, hacelo manualmente en la terminal con plena consciencia:",
-        "",
-        "- `--force-reset` — puede destruir datos de base de datos",
-        "- `prisma migrate reset` — borra y re-crea la base de datos",
-        "- `DROP TABLE` / `DROP DATABASE` — destruye tablas o bases de datos",
-        "- `TRUNCATE` — elimina todos los registros de una tabla",
-        "- `DELETE FROM <tabla>;` — sin cláusula WHERE, elimina todo",
-        "- `dropdb` — elimina una base de datos completa",
-        "- `rm -rf /` — elimina recursivamente desde la raíz",
-        "- `git push --force` sin `--with-lease` — sobreescribe historial remoto",
-        "",
-        "Contexto de producción = la URL de producción o el project_id aparecen",
-        "en el comando, o hay variables de entorno `PROD_*` / `PRODUCTION_*` activas.",
-        "",
-        "Lección del 2026-04-28: --force-reset borró 225 usuarios y 35 formularios",
-        "en producción. Estas reglas existen por eso.",
-        "",
-        "## Branch guard (pre-edit-check)",
-        "",
-        "No editar archivos de código fuente directamente en `main` o `master`.",
-        "",
-        "Archivos de código = `.py`, `.ts`, `.js`, `.tsx`, `.jsx`, `.php`, `.rb`,",
-        "`.go`, `.rs`, `.java`, `.cs`, `.cpp`, `.c`, `.sh`",
-        "",
-        "Excenciones permitidas en rama protegida:",
-        "- Archivos de documentación (`docs/`, `.md`)",
-        "- Archivos de configuración en raíz (`.yaml`, `.yml`, `.json`)",
-        "- `CLAUDE.md`, `AGENTS.md`, `README.md`, `CHANGELOG.md`",
-        "",
-        "Si estás en `main` o `master`, crea una feature branch primero:",
-        "```bash",
-        "git checkout -b feature/<tema>-$(date +%Y-%m-%d)",
-        "```",
-        "",
-    ]
-
-    return "\n".join(lines)
-
-
-def main():
-    try:
-        root = find_project_root()
-        forge = find_forge_dir()
-    except FileNotFoundError as e:
-        print(f"ERROR: {e}", file=sys.stderr)
-        sys.exit(1)
-
-    with open(root / "project.yaml") as f:
-        config = yaml.safe_load(f)
-
-    content = generate_agents_md(config, forge)
-    output_path = root / "AGENTS.md"
-    with open(output_path, "w") as f:
-        f.write(content)
-    print(f"  [OK]   AGENTS.md generado en {output_path}")
-    print("         (adapter Codex: incluye SDD workflow + security rules + autonomy limits)")
-
-
-if __name__ == "__main__":
-    main()

package/assets/adapters/kiro/generate-steering.py

@@ -1,367 +0,0 @@
-#!/usr/bin/env python3
-# Copyright 2026 Cristian Correa — Apache License 2.0
-# https://github.com/cristiancorreau/forge
-"""
-generate-steering.py — Genera archivos .kiro/steering/ para Kiro IDE.
-
-Usage:
-  python3 .agentic/adapters/kiro/generate-steering.py
-
-Lee project.yaml en la raíz y genera los steering files de Kiro:
-  .kiro/steering/product.md    ← descripción del producto y stack
-  .kiro/steering/structure.md  ← estructura del proyecto, workflow SDD y flujo de sesión Forge v2
-  .kiro/steering/agents.md     ← roster de agentes y sus responsabilidades
-  .kiro/steering/commands.md   ← 6 comandos Forge para contexto del agente Kiro
-  .kiro/steering/compliance.md ← reglas de compliance (si hay frameworks activos)
-  .kiro/hooks/pre-edit-branch-guard.json ← hook que bloquea ediciones directas en main/master
-
-Kiro usa estos archivos como contexto persistente en todas las conversaciones.
-
-Requiere: pyyaml
-"""
-from __future__ import annotations
-
-import sys
-from pathlib import Path
-
-try:
-    import yaml
-except ImportError:
-    print("ERROR: pyyaml requerido. pip install pyyaml", file=sys.stderr)
-    sys.exit(1)
-
-
-def find_project_root() -> Path:
-    here = Path.cwd()
-    for p in [here] + list(here.parents):
-        if (p / "project.yaml").exists():
-            return p
-    raise FileNotFoundError("No se encontró project.yaml")
-
-
-def find_forge_dir() -> Path:
-    root = find_project_root()
-    for candidate in [root / ".agentic", root / "forge", Path(__file__).parent.parent.parent]:
-        if (candidate / "core").exists():
-            return candidate
-    raise FileNotFoundError("No se encontró el directorio forge con core/")
-
-
-def write_file(path: Path, content: str, force: bool = False) -> str:
-    if path.exists() and not force:
-        return "KEEP"
-    path.parent.mkdir(parents=True, exist_ok=True)
-    path.write_text(content)
-    return "OK"
-
-
-def generate_product_md(config: dict) -> str:
-    proj = config.get("project", {})
-    stack = config.get("stack", {})
-    team = config.get("team", {})
-
-    return f"""# {proj.get('name', 'Mi Proyecto')}
-
-{proj.get('description', '')}
-
-## Stack
-
-- **Lenguaje:** {proj.get('language', 'typescript')}
-- **Backend:** {stack.get('backend') or 'N/A'}
-- **Frontend:** {stack.get('frontend') or 'N/A'}
-- **Base de datos:** {stack.get('database') or 'N/A'}
-- **Cache:** {stack.get('cache') or 'N/A'}
-- **Testing:** {', '.join(stack.get('testing', []))}
-
-## Estado del proyecto
-
-- **Status:** {proj.get('status', 'active')}
-- **Equipo:** {team.get('name', 'Equipo Principal')}
-"""
-
-
-def generate_structure_md(config: dict) -> str:
-    proj = config.get("project", {})
-    paths = config.get("paths", {})
-    specs_path = paths.get("specs", "docs/specs")
-    language = proj.get("language", "typescript")
-
-    cmd_map = {
-        "typescript": ("pnpm dev", "pnpm test", "pnpm lint"),
-        "python":     ("uvicorn main:app --reload  # o python manage.py runserver", "pytest", "ruff check ."),
-        "ruby":       ("rails server", "bundle exec rspec", "rubocop"),
-        "go":         ("go run ./cmd/...", "go test ./...", "golangci-lint run"),
-        "php":        ("php artisan serve", "vendor/bin/phpunit", "vendor/bin/phpstan analyse"),
-    }
-    dev_cmd, test_cmd, lint_cmd = cmd_map.get(language, ("# ver docs del proyecto",) * 3)
-
-    return f"""# Estructura del proyecto
-
-## Workflow: Spec-Driven Development (SDD)
-
-Antes de implementar cualquier feature:
-
-1. Verificar que existe una spec en `{specs_path}/`.
-2. Si no existe, crear la spec y obtener aprobación antes de codificar.
-3. Implementar con tests junto al código, no al final.
-4. Actualizar la spec con decisiones tomadas durante la implementación.
-
-## Flujo de sesión — Forge v2
-
-Cada sesión de trabajo sigue este orden:
-
-```
-session-start  → Leer AGENTS.md + specs relevantes. Confirmar rama activa.
-plan           → Descomponer la tarea. Identificar spec. Presentar opciones si hay decisiones abiertas.
-work           → Implementar con tests. Un agente por scope. Actualizar spec si hay desvíos.
-review         → Lint + tests verdes. Compliance review si toca PII o auth.
-ship           → PR abierto, CI verde. No mergear sin revisión si >5 archivos del mismo módulo.
-session-close  → Reportar cambios, decisiones tomadas y próximos pasos.
-```
-
-## Comandos frecuentes
-
-```bash
-{dev_cmd}     # Desarrollo
-{test_cmd}    # Tests
-{lint_cmd}    # Lint
-```
-
-## Reglas no-negociables
-
-- Sin hardcodear tokens, passwords ni secrets.
-- Parámetros preparados en todas las queries SQL — nunca concatenar input del usuario.
-- PII nunca en logs de stdout.
-- Auth + authz verificados en cada endpoint.
-- Sin force push a main/master.
-"""
-
-
-def generate_agents_md(config: dict) -> str:
-    agents_cfg = config.get("agents", {})
-    compliance_cfg = config.get("compliance", {})
-
-    active = agents_cfg.get("active", [])
-    compliance = agents_cfg.get("compliance", [])
-    specialized = agents_cfg.get("specialized", [])
-    frameworks = compliance_cfg.get("frameworks", [])
-
-    if frameworks and "compliance-reviewer" not in active + compliance:
-        compliance = list(set(compliance + ["compliance-reviewer"]))
-
-    role_descriptions = {
-        "orchestrator":        "Coordina al team. Descompone tareas, delega y sintetiza. No implementa código directamente.",
-        "backend-engineer":    "Backend — API, base de datos, lógica de negocio.",
-        "frontend-engineer":   "Frontend — UI, componentes, integración con API.",
-        "api-engineer":        "API — framework HTTP + ORM + lógica de negocio.",
-        "admin-engineer":      "Admin dashboard — UI de gestión interna.",
-        "mobile-engineer":     "Apps móviles.",
-        "fullstack-engineer":  "Features full-stack (backend + frontend).",
-        "test-engineer":       "Testing — unitario, integración, E2E.",
-        "docs-writer":         "Documentación — specs, ADRs, READMEs.",
-        "compliance-reviewer": "Revisa cambios contra marcos regulatorios activos. Tiene poder de veto.",
-        "security-auditor":    "Auditoría de seguridad — auth, authz, OWASP Top 10.",
-        "scanner-engineer":    "Scanner de cookies y trackers.",
-    }
-
-    lines = [
-        "# Roster de agentes",
-        "",
-        "## Reglas operativas",
-        "",
-        "- El orchestrator coordina; los demás agentes no se comunican directamente entre sí.",
-        "- Cada agente respeta su scope — no sale del directorio que le corresponde.",
-        "- Specs en `docs/specs/` antes de implementar. Sin spec, sin código.",
-        "",
-    ]
-
-    if active:
-        lines += ["## Agentes activos", ""]
-        for name in active:
-            desc = role_descriptions.get(name, "Agente de implementación")
-            lines.append(f"- **`{name}`** — {desc}")
-        lines.append("")
-
-    if compliance:
-        lines += ["## Agentes de revisión", ""]
-        for name in compliance:
-            desc = role_descriptions.get(name, "Agente revisor")
-            lines.append(f"- **`{name}`** — {desc}")
-        lines.append("")
-
-    if specialized:
-        lines += ["## Agentes especializados del proyecto", ""]
-        for name in specialized:
-            desc = role_descriptions.get(name, "Agente especializado del proyecto")
-            lines.append(f"- **`{name}`** — {desc}")
-        lines.append("")
-
-    return "\n".join(lines)
-
-
-def generate_commands_md(config: dict) -> str:
-    paths = config.get("paths", {})
-    specs_path = paths.get("specs", "docs/specs")
-
-    return f"""# Forge commands — referencia para el agente
-
-Este proyecto usa Forge (framework de agentic development). Los siguientes comandos
-son los flujos de trabajo centrales que el agente debe seguir cuando el usuario los invoca.
-
-## new-feature
-
-Inicia la implementación de una nueva feature siguiendo SDD.
-
-1. Si no existe spec para la feature en `{specs_path}/`, crearla primero.
-2. Leer la spec antes de proponer cualquier implementación.
-3. Proponer el plan y esperar aprobación explícita.
-4. Implementar con tests junto a la implementación, no al final.
-5. Al terminar, actualizar la spec con las decisiones tomadas.
-
-## review
-
-Revisa el estado actual de la rama activa.
-
-1. Listar archivos modificados (`git diff --name-only main`).
-2. Ejecutar tests y lint. Reportar resultados.
-3. Verificar que los cambios corresponden a una spec aprobada.
-4. Identificar items pendientes antes de poder hacer merge.
-
-## deploy-check
-
-Verifica que el deploy de producción está sano después de un merge.
-
-1. Confirmar que el build de CI pasó.
-2. Revisar runtime logs (errores 5xx, excepciones no manejadas).
-3. Smoke test de los endpoints principales.
-4. Reportar estado: OK | DEGRADED | DOWN.
-
-## wiki-ingest
-
-Indexa documentación externa para que el agente pueda consultarla.
-
-1. Recibir URL o path a la documentación.
-2. Parsear y fragmentar el contenido.
-3. Almacenar en el directorio de wiki del proyecto.
-4. Confirmar qué secciones quedaron disponibles.
-
-## wiki-query
-
-Consulta la wiki indexada para responder preguntas técnicas.
-
-1. Buscar en los fragmentos indexados con la consulta del usuario.
-2. Sintetizar la respuesta citando las fuentes.
-3. Si no hay resultado en la wiki, indicarlo explícitamente — no inventar.
-
-## wiki-lint
-
-Verifica la calidad y consistencia de la wiki indexada.
-
-1. Detectar fragmentos desactualizados (referencias a versiones antiguas).
-2. Identificar contradicciones entre documentos.
-3. Reportar items que requieren revisión manual.
-"""
-
-
-def generate_branch_guard_hook() -> str:
-    """Genera el hook JSON de Kiro que advierte al editar en main/master."""
-    import json
-    hook = {
-        "name": "branch-guard",
-        "description": "Warns when editing files directly on main or master branch.",
-        "event": "onBeforeEdit",
-        "condition": {
-            "type": "gitBranch",
-            "branches": ["main", "master"]
-        },
-        "action": {
-            "type": "agentPrompt",
-            "prompt": (
-                "STOP: You are about to edit files on the '{{branch}}' branch. "
-                "Direct commits to main/master are not allowed in this project. "
-                "Create a feature branch first: `git checkout -b feat/<name>`. "
-                "Do not proceed with the edit until the user confirms or switches branch."
-            )
-        }
-    }
-    return json.dumps(hook, indent=2, ensure_ascii=False)
-
-
-def generate_compliance_md(config: dict) -> str | None:
-    compliance_cfg = config.get("compliance", {})
-    frameworks = compliance_cfg.get("frameworks", [])
-    if not frameworks:
-        return None
-
-    return f"""# Compliance activo
-
-Este proyecto opera bajo los siguientes marcos regulatorios:
-{chr(10).join(f'- **{f.upper()}**' for f in frameworks)}
-
-## Reglas no-negociables
-
-- Sin datos personales en logs de stdout.
-- Consentimiento explícito antes de cualquier tracker no esencial.
-- Logs de auditoría append-only (sin UPDATE/DELETE sobre tablas de eventos).
-- Derechos del titular implementados: acceso, rectificación, supresión, oposición, portabilidad.
-- TLS 1.2+ para toda comunicación externa.
-
-## Cuándo involucrar al compliance-reviewer
-
-- Cualquier cambio que toque datos de usuarios o consentimientos.
-- Nuevos endpoints que reciban PII.
-- Cambios en la lógica de logs de auditoría.
-- Implementación de derechos del titular (DSAR).
-
-> Nota: el agente compliance-reviewer opera como primer filtro técnico.
-> No sustituye revisión legal profesional para proyectos con obligaciones regulatorias reales.
-"""
-
-
-def main():
-    force = "--force" in sys.argv
-
-    try:
-        root = find_project_root()
-        forge = find_forge_dir()
-    except FileNotFoundError as e:
-        print(f"ERROR: {e}", file=sys.stderr)
-        sys.exit(1)
-
-    with open(root / "project.yaml") as f:
-        config = yaml.safe_load(f)
-
-    steering_dir = root / ".kiro" / "steering"
-    steering_dir.mkdir(parents=True, exist_ok=True)
-
-    files = {
-        "product.md":    generate_product_md(config),
-        "structure.md":  generate_structure_md(config),
-        "agents.md":     generate_agents_md(config),
-        "commands.md":   generate_commands_md(config),
-    }
-
-    compliance_content = generate_compliance_md(config)
-    if compliance_content:
-        files["compliance.md"] = compliance_content
-
-    for filename, content in files.items():
-        path = steering_dir / filename
-        status = write_file(path, content, force=force)
-        icon = "[OK]  " if status == "OK" else "[KEEP]"
-        print(f"  {icon} .kiro/steering/{filename}" + (" — ya existe (--force para sobreescribir)" if status == "KEEP" else ""))
-
-    # Hooks
-    hooks_dir = root / ".kiro" / "hooks"
-    hook_path = hooks_dir / "pre-edit-branch-guard.json"
-    hook_status = write_file(hook_path, generate_branch_guard_hook(), force=force)
-    hook_icon = "[OK]  " if hook_status == "OK" else "[KEEP]"
-    print(f"  {hook_icon} .kiro/hooks/pre-edit-branch-guard.json" + (" — ya existe (--force para sobreescribir)" if hook_status == "KEEP" else ""))
-
-    print(f"\nKiro steering files en {steering_dir.relative_to(root)}/")
-    if not force:
-        print("  Usar --force para sobreescribir archivos existentes.")
-
-
-if __name__ == "__main__":
-    main()