@cristiancorreau/forge 2.9.6 → 2.9.7

package/assets/scripts/forge-migrate-project-yaml.py

@@ -1,397 +0,0 @@
-#!/usr/bin/env python3
-"""
-forge-migrate-project-yaml.py — Migra un project.yaml de v1 a v2 de Forge.
-
-Usage:
-    python3 .agentic/scripts/forge-migrate-project-yaml.py
-    python3 .agentic/scripts/forge-migrate-project-yaml.py --dry-run
-    python3 .agentic/scripts/forge-migrate-project-yaml.py --backup
-
-Detecta si el project.yaml es v1 (sin secciones 'deploy' estructurado, 'rules', 'mcp', 'github')
-y agrega las secciones nuevas preservando todos los valores existentes.
-
-Exit codes:
-    0 — migración exitosa (o ya era v2)
-    1 — error
-"""
-
-import sys
-import os
-import re
-import shutil
-import argparse
-from pathlib import Path
-from typing import Any, Optional, Tuple
-
-
-# ---------------------------------------------------------------------------
-# Búsqueda de project.yaml
-# ---------------------------------------------------------------------------
-
-def find_project_yaml(start: Path) -> Optional[Path]:
-    current = start.resolve()
-    while True:
-        candidate = current / "project.yaml"
-        if candidate.exists():
-            return candidate
-        parent = current.parent
-        if parent == current:
-            return None
-        current = parent
-
-
-# ---------------------------------------------------------------------------
-# Carga YAML
-# ---------------------------------------------------------------------------
-
-def load_yaml_raw(path: Path) -> Tuple[dict, str]:
-    """
-    Carga el YAML y retorna (data, raw_text).
-    Requiere pyyaml.
-    """
-    try:
-        import yaml
-    except ImportError:
-        print("ERROR: pyyaml no está instalado. Instalarlo con: pip install pyyaml")
-        sys.exit(1)
-
-    with open(path, "r", encoding="utf-8") as f:
-        raw = f.read()
-
-    data = yaml.safe_load(raw)
-    return (data if data is not None else {}), raw
-
-
-# ---------------------------------------------------------------------------
-# Detección de versión
-# ---------------------------------------------------------------------------
-
-def detect_version(data: dict) -> str:
-    """
-    Detecta si el project.yaml es v1 o v2.
-    Criterio: si tiene 'rules' O 'mcp' O 'github' O 'project.mode' → es v2.
-    """
-    if "rules" in data or "mcp" in data or "github" in data:
-        return "2"
-    project = data.get("project", {}) or {}
-    if "mode" in project:
-        return "2"
-    return "1"
-
-
-# ---------------------------------------------------------------------------
-# Generador del bloque v2 en YAML comentado
-# ---------------------------------------------------------------------------
-
-V2_ADDITIONS = """\
-# ---------------------------------------------------------------------------
-# schema_version: "2"
-# Las siguientes secciones fueron agregadas por forge-migrate-project-yaml.py
-# ---------------------------------------------------------------------------
-
-# nuevo en v2: modo operativo del proyecto
-# Si ya existe project.mode, puedes ignorar este comentario.
-
-agents:
-  # nuevo en v2: mapeo rol → modelo específico de Claude
-  by_role:
-    orchestrator: null          # ej: claude-opus-4-7
-    senior-backend: null        # ej: claude-sonnet-4-6
-
-deploy:
-  # nuevo en v2
-  provider: null                # vercel | railway | fly | aws | github-actions | custom | null
-  project_id: null              # ID del proyecto en la plataforma (ej: prj_xxx en Vercel)
-  production_url: null          # https://mi-proyecto.vercel.app
-  smoke_tests: []               # Tests de humo post-deploy
-  # Ejemplo:
-  # smoke_tests:
-  #   - url: /api/health
-  #     expect_status: 200
-  #     expect_json:
-  #       status: ok
-  #   - url: https://mi-proyecto.vercel.app
-  #     expect_status: 200
-
-mcp:
-  # nuevo en v2: servidores MCP del proyecto
-  servers: []
-  # Ejemplo:
-  # servers:
-  #   - name: supabase
-  #     auto_approve:
-  #       - list_tables
-  #       - execute_sql
-
-github:
-  # nuevo en v2: integración con GitHub Projects
-  project:
-    number: null                # Número del GitHub Project
-    owner: null                 # usuario u organización
-    repo: null                  # nombre del repositorio
-    status_field_id: null       # ID del campo Status
-    status_in_progress: null    # ej: "In Progress"
-    status_done: null           # ej: "Done"
-
-rules:
-  # nuevo en v2: guardrails del proyecto
-  forbidden_in_production:
-    - "console.log"             # eliminar logs de debug en producción
-    - "TODO:"                   # no dejar TODOs sin resolver
-    - "FIXME:"
-  required_review_before_ship: false
-  require_spec_before_implementation: false
-  conventional_commits: true
-  forbidden_patterns: []        # regex evaluadas por el hook pre-edit-check
-  # Ejemplo:
-  # forbidden_patterns:
-  #   - "process\\.env\\.[A-Z_]+\\s*=\\s*['\\\"][^'\\\"]+['\\\"]"  # hardcoded env values
-
-scripts:
-  # nuevo en v2: comando ejecutado por post-turn-check.sh
-  check: null                   # ej: "pnpm typecheck && pnpm lint"
-"""
-
-
-def build_v2_yaml(data: dict, raw: str) -> str:
-    """
-    Construye el YAML v2 completo.
-    Estrategia: agrega un encabezado de schema_version y las secciones nuevas al final,
-    preservando el contenido original.
-
-    Para las secciones que ya existen en el original (como 'deploy' con solo 'provider' y 'branch'),
-    se hace un merge inteligente para no duplicar.
-    """
-    try:
-        import yaml
-    except ImportError:
-        print("ERROR: pyyaml no está instalado.")
-        sys.exit(1)
-
-    # Secciones que ya existen en el YAML original
-    existing_sections = set(data.keys())
-
-    lines_to_add = []
-
-    # Encabezado
-    lines_to_add.append("# ---------------------------------------------------------------------------")
-    lines_to_add.append('# schema_version: "2"')
-    lines_to_add.append("# Las siguientes secciones fueron agregadas por forge-migrate-project-yaml.py")
-    lines_to_add.append("# ---------------------------------------------------------------------------")
-    lines_to_add.append("")
-
-    # project.mode — agregar si no existe
-    project = data.get("project", {}) or {}
-    needs_project_mode = "mode" not in project
-
-    # agents.by_role — agregar si agents existe pero no tiene by_role
-    agents = data.get("agents", {}) or {}
-    needs_agents_by_role = "agents" in existing_sections and "by_role" not in agents
-
-    # Secciones completamente nuevas
-    needs_deploy_new_fields = True  # siempre agregar campos nuevos de deploy
-    needs_mcp = "mcp" not in existing_sections
-    needs_github = "github" not in existing_sections
-    needs_rules = "rules" not in existing_sections
-    needs_scripts = "scripts" not in existing_sections
-
-    # --- project.mode patch ---
-    if needs_project_mode:
-        lines_to_add.append("# ACCIÓN REQUERIDA: Agrega 'mode' a la sección project arriba.")
-        lines_to_add.append("# Valores: startup | standard | enterprise")
-        lines_to_add.append("# Ejemplo:")
-        lines_to_add.append("#   project:")
-        lines_to_add.append('#     mode: "standard"')
-        lines_to_add.append("")
-
-    # --- agents.by_role ---
-    if needs_agents_by_role:
-        lines_to_add.append("# nuevo en v2 — agregar bajo la sección agents existente:")
-        lines_to_add.append("# agents:")
-        lines_to_add.append("#   by_role:")
-        lines_to_add.append("#     orchestrator: claude-opus-4-7")
-        lines_to_add.append("#     senior-backend: claude-sonnet-4-6")
-        lines_to_add.append("")
-
-    # --- deploy (campos nuevos de v2) ---
-    deploy = data.get("deploy", {}) or {}
-    existing_deploy_keys = set(deploy.keys()) if isinstance(deploy, dict) else set()
-    deploy_new_fields = []
-
-    if "project_id" not in existing_deploy_keys:
-        deploy_new_fields.append("  project_id: null              # ID del proyecto en la plataforma (ej: prj_xxx en Vercel)")
-    if "production_url" not in existing_deploy_keys:
-        deploy_new_fields.append("  production_url: null          # https://mi-proyecto.vercel.app")
-    if "smoke_tests" not in existing_deploy_keys:
-        deploy_new_fields.append("  smoke_tests: []               # Tests de humo post-deploy")
-        deploy_new_fields.append("  # Ejemplo de smoke test:")
-        deploy_new_fields.append("  # smoke_tests:")
-        deploy_new_fields.append("  #   - url: /api/health")
-        deploy_new_fields.append("  #     expect_status: 200")
-        deploy_new_fields.append("  #     expect_json:")
-        deploy_new_fields.append("  #       status: ok")
-
-    if deploy_new_fields:
-        if "deploy" in existing_sections:
-            lines_to_add.append("# nuevo en v2 — campos adicionales para la sección deploy existente:")
-            lines_to_add.append("# (agregar manualmente bajo la sección deploy arriba)")
-            for line in deploy_new_fields:
-                lines_to_add.append("# " + line.lstrip())
-        else:
-            lines_to_add.append("")
-            lines_to_add.append("deploy:  # nuevo en v2")
-            if "provider" not in existing_deploy_keys:
-                lines_to_add.append("  provider: null              # vercel | railway | fly | aws | github-actions | custom | null")
-            lines_to_add.extend(deploy_new_fields)
-        lines_to_add.append("")
-
-    # --- mcp ---
-    if needs_mcp:
-        lines_to_add.append("mcp:  # nuevo en v2")
-        lines_to_add.append("  servers: []")
-        lines_to_add.append("  # Ejemplo:")
-        lines_to_add.append("  # servers:")
-        lines_to_add.append("  #   - name: supabase")
-        lines_to_add.append("  #     auto_approve:")
-        lines_to_add.append("  #       - list_tables")
-        lines_to_add.append("  #       - execute_sql")
-        lines_to_add.append("")
-
-    # --- github ---
-    if needs_github:
-        lines_to_add.append("github:  # nuevo en v2")
-        lines_to_add.append("  project:")
-        lines_to_add.append("    number: null                # Número del GitHub Project")
-        lines_to_add.append("    owner: null                 # usuario u organización")
-        lines_to_add.append("    repo: null                  # nombre del repositorio")
-        lines_to_add.append("    status_field_id: null       # ID del campo Status")
-        lines_to_add.append('    status_in_progress: null    # ej: "In Progress"')
-        lines_to_add.append('    status_done: null           # ej: "Done"')
-        lines_to_add.append("")
-
-    # --- rules ---
-    if needs_rules:
-        lines_to_add.append("rules:  # nuevo en v2")
-        lines_to_add.append("  forbidden_in_production:")
-        lines_to_add.append('    - "console.log"')
-        lines_to_add.append('    - "TODO:"')
-        lines_to_add.append('    - "FIXME:"')
-        lines_to_add.append("  required_review_before_ship: false")
-        lines_to_add.append("  require_spec_before_implementation: false")
-        lines_to_add.append("  conventional_commits: true")
-        lines_to_add.append("  forbidden_patterns: []")
-        lines_to_add.append("")
-
-    # --- scripts ---
-    if needs_scripts:
-        lines_to_add.append("scripts:  # nuevo en v2")
-        lines_to_add.append('  check: null                   # ej: "pnpm typecheck && pnpm lint"')
-        lines_to_add.append("")
-
-    if not lines_to_add or all(l == "" for l in lines_to_add):
-        return raw  # nada que agregar
-
-    # Construir resultado final
-    additions = "\n".join(lines_to_add)
-    result = raw.rstrip("\n") + "\n\n" + additions
-    return result
-
-
-# ---------------------------------------------------------------------------
-# Diff simple
-# ---------------------------------------------------------------------------
-
-def show_diff(original: str, new: str):
-    """Muestra un diff básico entre el contenido original y el nuevo."""
-    orig_lines = original.splitlines(keepends=True)
-    new_lines = new.splitlines(keepends=True)
-
-    import difflib
-    diff = difflib.unified_diff(
-        orig_lines, new_lines,
-        fromfile="project.yaml (v1)",
-        tofile="project.yaml (v2)",
-        lineterm=""
-    )
-    diff_text = "".join(diff)
-    if diff_text:
-        print(diff_text)
-    else:
-        print("(sin cambios)")
-
-
-# ---------------------------------------------------------------------------
-# Main
-# ---------------------------------------------------------------------------
-
-def main():
-    parser = argparse.ArgumentParser(
-        description="Migra project.yaml de v1 a v2 de Forge"
-    )
-    parser.add_argument(
-        "--dry-run",
-        action="store_true",
-        help="Muestra el diff sin escribir cambios"
-    )
-    parser.add_argument(
-        "--backup",
-        action="store_true",
-        help="Crea project.yaml.bak antes de modificar"
-    )
-    args = parser.parse_args()
-
-    # Buscar project.yaml
-    project_yaml_path = find_project_yaml(Path.cwd())
-    if project_yaml_path is None:
-        print("ERROR: No se encontró project.yaml en el directorio actual ni superiores")
-        sys.exit(1)
-
-    print(f"Leyendo: {project_yaml_path}")
-
-    # Cargar
-    data, raw = load_yaml_raw(project_yaml_path)
-
-    # Detectar versión
-    version = detect_version(data)
-    if version == "2":
-        print("El project.yaml ya está en v2 (contiene secciones 'rules', 'mcp', 'github' o 'project.mode').")
-        print("No se requiere migración.")
-        sys.exit(0)
-
-    print(f"Versión detectada: v{version} → migrando a v2...")
-    print()
-
-    # Construir nuevo contenido
-    new_content = build_v2_yaml(data, raw)
-
-    if args.dry_run:
-        print("--- DRY RUN: mostrando diff (no se escribirán cambios) ---")
-        print()
-        show_diff(raw, new_content)
-        sys.exit(0)
-
-    # Backup
-    if args.backup:
-        backup_path = project_yaml_path.with_suffix(".yaml.bak")
-        shutil.copy2(project_yaml_path, backup_path)
-        print(f"Backup creado: {backup_path}")
-
-    # Escribir
-    with open(project_yaml_path, "w", encoding="utf-8") as f:
-        f.write(new_content)
-
-    print(f"Migración completada: {project_yaml_path}")
-    print()
-    print("Próximos pasos:")
-    print("  1. Revisa el archivo y completa los campos null con valores reales")
-    print("  2. Agrega project.mode (startup | standard | enterprise) si no está")
-    print("  3. Valida con: python3 .agentic/scripts/forge-validate-project-yaml.py")
-    print()
-
-    # Mostrar diff informativo
-    print("--- Cambios aplicados ---")
-    show_diff(raw, new_content)
-
-
-if __name__ == "__main__":
-    main()

package/assets/scripts/forge-scaffold-profile.py

@@ -1,181 +0,0 @@
-#!/usr/bin/env python3
-"""
-forge-scaffold-profile.py — Crea un profile Tier 2 para un stack no cubierto por forge.
-
-Uso:
-  python3 .agentic/scripts/forge-scaffold-profile.py --name django --engineer api-engineer
-  python3 .agentic/scripts/forge-scaffold-profile.py \\
-      --name django --engineer api-engineer \\
-      --description "Backend Django con DRF" \\
-      --stack-details "Django 4.2 + PostgreSQL + Django REST Framework"
-"""
-from __future__ import annotations
-
-import argparse
-import sys
-from pathlib import Path
-from typing import Optional
-
-
-def _find_forge_dir() -> Path:
-    here = Path(__file__).resolve().parent
-    for candidate in [here.parent, here.parent.parent]:
-        if (candidate / "core").exists() and (candidate / "profiles").exists():
-            return candidate
-    for p in [Path.cwd()] + list(Path.cwd().parents):
-        for sub in [p / ".agentic", p / "forge"]:
-            if (sub / "core").exists() and (sub / "profiles").exists():
-                return sub
-    raise FileNotFoundError(
-        "No se encontró el directorio forge con core/ y profiles/. "
-        "Ejecutar desde el repositorio de forge o desde un proyecto que lo tenga instalado."
-    )
-
-
-def _agent_md(
-    name: str,
-    engineer: str,
-    description: str,
-    stack_details: str,
-) -> str:
-    slug_title = name.replace("-", " ").title()
-    eng_title = engineer.replace("-", " ").title()
-
-    desc_line = (
-        description
-        if description
-        else f"Implementa el backend del proyecto usando {slug_title}. NO trabaja fuera del directorio definido en project.yaml."
-    )
-
-    stack_block = (
-        stack_details
-        if stack_details
-        else f"- **Framework:** {slug_title}\n- **Lenguaje:** (especificar)\n- **ORM/DB:** (especificar)\n- **Tests:** (especificar)"
-    )
-
-    return f"""\
----
-name: {engineer}
-description: {desc_line}
-model: sonnet
-tools: Read, Grep, Glob, Bash, Edit, Write
-tier: 2
-profile: {name}
----
-
-# {eng_title} — {slug_title}
-
-Implementás el backend del proyecto con {slug_title}. Tu scope es el directorio
-definido en el `CLAUDE.md` del proyecto. Leé ese archivo antes de empezar.
-
-## Stack
-
-{stack_block}
-
-## Tu trabajo
-
-- Implementar endpoints, modelos y migraciones según las specs en `docs/specs/`.
-- Escribir tests unitarios y de integración para toda la lógica nueva.
-- Correr el linter, typecheck y tests antes de reportar al orchestrator.
-- Proponer un plan antes de codificar cuando la tarea afecte >3 archivos.
-
-## Reglas
-
-- **Logs de auditoría son append-only.** NUNCA `UPDATE` ni `DELETE` sobre tablas de eventos.
-- **PII nunca en logs.** Solo IDs o indicadores no reversibles.
-- **Parámetros preparados siempre:** nunca interpolar input del usuario en SQL.
-- **Auth + authz en cada endpoint:** verificar sesión Y permisos por recurso.
-- **Migraciones reversibles:** toda migración tiene su operación inversa documentada.
-- Sin spec en `docs/specs/` → no empieces. Pedí que se cree primero.
-
-## Workflow
-
-1. Leer el `CLAUDE.md` del proyecto y la spec de la feature activa.
-2. Revisar el data model si la tarea toca schema.
-3. Si la tarea toca compliance, informar al compliance-reviewer antes de implementar.
-4. Implementar con tests (TDD para lógica core, integración para endpoints).
-5. Correr tests + linter + typecheck.
-6. Reportar al orchestrator: qué se hizo, qué archivos se tocaron, qué falta.
-
-## No hagas
-
-- No salgas del directorio de API/backend del proyecto.
-- No implementes lógica de UI ni de frontend.
-- No modifiques specs ni documentación de arquitectura sin aprobación.
-- No mergees ni crees PRs directamente.
-- No uses queries SQL raw con interpolación de strings.
-"""
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(
-        description="Crea un profile Tier 2 para un stack no cubierto por forge."
-    )
-    parser.add_argument("--name", required=True, metavar="SLUG", help="Nombre del profile (ej: django)")
-    parser.add_argument("--engineer", required=True, metavar="AGENT", help="Nombre del agente (ej: api-engineer)")
-    parser.add_argument("--description", default="", metavar="DESC", help="Descripción breve del agente")
-    parser.add_argument("--stack-details", default="", metavar="DETAILS", help="Detalles del stack (tecnologías, versiones)")
-
-    args = parser.parse_args()
-
-    name: str = args.name.strip().lower()
-    engineer: str = args.engineer.strip().lower()
-
-    if not name or not engineer:
-        print("Error: --name y --engineer son obligatorios y no pueden estar vacíos.", file=sys.stderr)
-        sys.exit(1)
-
-    try:
-        forge = _find_forge_dir()
-    except FileNotFoundError as e:
-        print(f"Error: {e}", file=sys.stderr)
-        sys.exit(1)
-
-    profile_dir = forge / "profiles" / name / "agents"
-    agent_file = profile_dir / f"{engineer}.md"
-
-    if agent_file.exists():
-        print(f"Error: {agent_file} ya existe. Editar manualmente si querés actualizarlo.", file=sys.stderr)
-        sys.exit(1)
-
-    profile_dir.mkdir(parents=True, exist_ok=True)
-
-    content = _agent_md(
-        name=name,
-        engineer=engineer,
-        description=args.description.strip(),
-        stack_details=args.stack_details.strip(),
-    )
-
-    with open(agent_file, "w") as f:
-        f.write(content)
-
-    print(f"Profile creado: {agent_file.relative_to(forge.parent) if forge.parent != forge else agent_file}")
-    print()
-    print("Próximos pasos:")
-    print()
-    print(f"  1. Revisar y completar el agente:")
-    print(f"     {agent_file}")
-    print()
-    print(f"  2. Documentar el profile en docs/agent-standard.md:")
-    print(f"     Agregar una fila en la tabla Tier 2:")
-    print(f"     | `{name}` | `{engineer}` |")
-    print()
-    print(f"  3. Activar el profile en project.yaml del proyecto:")
-    print(f"     agents:")
-    print(f"       profiles:")
-    print(f"         - {name}")
-    print()
-    print(f"  4. Instalar el agente:")
-    print(f"     python3 .agentic/scripts/forge-init.py --tool claude-code")
-    print()
-    print(f"  5. Agregar tests en tests/test_profiles.py para el nuevo profile.")
-    print()
-    # forge-init.py gestiona profiles dinámicamente desde el filesystem, no tiene un
-    # registro estático de nombres — no es necesario editar su código para que funcione.
-    print("Nota: forge-init.py detecta profiles automáticamente desde forge/profiles/.")
-    print("No es necesario modificar ese script.")
-
-
-if __name__ == "__main__":
-    main()