Skip to content

Releases

ag_ops v2.4.0

Choose a tag to compare

@FranciscoGrandon FranciscoGrandon released this 20 Nov 06:21
0002560

ag_ops v2.4.0 — 2026-11-20

Añadido

  • Hardening P0 de Superficie Raíz y Entorno (guard):
    • Sellado de root_config_manifest y root_config_base desde --test-dir hasta la raíz del repositorio/workspace (conftest.py, pytest.ini, pyproject.toml, setup.cfg, tox.ini, sitecustomize.py, usercustomize.py), registrando ABSENT para archivos inexistentes y detectando altas o mutaciones tardías como ROOT_CONFIG_DRIFT (exit 2), además de rechazo a symlinks/junctions en ancestros y configuraciones raíz.
    • Inspección determinista de addopts con tomllib/configparser bloqueando flags evasivos y patrones personalizados mediante --forbid-addopts (UNSAFE_PYTEST_ADDOPTS, exit 2).
    • Sanitización por defecto de PYTEST_ADDOPTS y PYTHONSTARTUP (ENV_TAINT_DETECTED, exit 2) y política auditable env_policy mediante --allow-env-passthrough.
    • Extracción y verificación del conteo efectivo de pruebas ejecutadas (witnessed_test_count: ZERO_TESTS_EXECUTED, TEST_COUNT_REGRESSION) y esquema schema_version: "2.4" compatible con recibos históricos v2.3.
    • +6 escenarios adversariales en benchmark_agent_failures.py (TAM-07..TAM-12) sobre un total de 36 escenarios.
  • Motor de Rendimiento P1 (100% stdlib):
    • SinglePassVisitor con _DEFAULT_LINT_DISPATCH y _LintFileContext, más _StringLiteralScrubber directo sobre clones AST.
    • Hashing acelerado con hashlib.file_digest y streaming 64 KB con acarreo de \r en frontera.
    • GitBatchReader (git cat-file --batch), _git_batch_changed_line_sets y caché incremental .ag_state/stat_cache.json con guardia anti-racy de 50 ms (--no-cache, deshabilitada en --strict).
  • Gobernanza P2 de Historial, Ciclos y Alcance:
    • Anclaje mediante --base-ref <ref> en guard witness-red y guard renegotiate con git merge-base --is-ancestor, bloqueo SPEC_MODIFIED_SINCE_BASE (exit 2) y auditoría HEAD_MOVE_ALLOWED.
    • Detector determinista de oscilaciones k-ciclo (deque(maxlen=16)) en guard y state (OSCILLATION_CYCLE_DETECTED, exit 2).
    • Subcomando guard check-scope --base <ref> --rule-paths <rutas> [--repo <dir>] --json (MIXED_SCOPE_VIOLATION, exit 2).
  • Ergonomía y Sensor AST P3:
    • Renegociación agrupada atómica guard renegotiate --batch <manifiesto.json> (SCAR-PROC-150, DUPLICATE_BATCH_TARGET, rollback completo ante fallos).
    • Regla AST MUT001 integrada en SinglePassVisitor para mutaciones ocultas en métodos de consulta (get_*, is_*, has_*, validate_*), bloqueante en --strict y con supresión # ag_ops: allow-mutation: <razón>.
  • Suite v2.4: Nueva batería tests/test_ag_ops_v2_4.py (19 pruebas cubriendo cero dependencias externas y fases P0–P3).

Cambiado

  • Construcción de subparsers enfocada en build_parser(only_subcommand=...), guarda previa a stream.reconfigure y captura de oscillation_history.json en el mismo os.scandir de state status.

Corregido

  • Normalización segura de carpetas con punto inicial (.gemini/, .ag_state/) mediante _normalize_repo_relpath().
  • Validación de tipos dict en tablas [tool] y [tool.pytest] de pyproject.toml antes de leer ini_options.addopts.

Seguridad y Métricas Verificadas

  • Contención Adversarial (benchmark_agent_failures.py): 31/36 (86.11 %) global y 12/12 (100.0 %) en Manipulación de Pruebas (frente a 5/6 = 83.3 % en v2.3).
  • Suites de Pruebas: 71/71 (pytest tests/ -v), 11/11 (unittest test_ag_ops_v2.py), 18/18 compatibilidad legacy (AG_OPS_PATH=./ag_ops.py).
  • Rendimiento (bench_perf_v23_vs_v24.py): 7/7 victorias en latencia frente a v2.3 (1.16x a 119.12x).

v2.3.0: Working-Tree Forgery Guard & Full QA Certification

Choose a tag to compare

@FranciscoGrandon FranciscoGrandon released this 03 Nov 18:56
3c86be3

What's Changed in ag_ops v2.3.0

Highlights

  • Cryptographic Git Anchoring against Working-Tree and Local-Commit Forgery (Randal L. Schwartz):
    • _get_git_repo_and_head records witnessed_head_sha at witness-red.
    • Enforced in �erify-green and
      enegotiate via HEAD_MOVED_DURING_RED_PHASE check.
    • Immutability of witness citations: _validate_file_line_ref reads directly from Git objects (git show :), rejecting UNCOMMITTED_WITNESS_FILE and TRIVIAL_WITNESS_LINE.
  • Red Failure Signature Traceability (Amber D. #1 & #3):
    • Extraction and persistence of exact assertion traces (
      ed_signature) and verified resolution (
      esolved_red_signature).
    • Formal constructive witness proof verification (spec-collision, �pi-lock, �rch-fork).
  • Structural AST Hashing in Rapid-Regret Mining (Amber D. #5):
    • _StringLiteralScrubber scrubs str constants and templates to , separating cosmetic text/typo adjustments from true logic regrets.
  • Late Artifact Lifecycle & Strict State Auditing:
    • state status auto-seals late artifacts (LATE_ARTIFACT_SEALED) and enforces --strict compliance (LATE_ARTIFACT_UNSEALED_AT_WRITE, exit 2).
  • Full QA Certification (Clean Sweep):
    • Ruff: 0 errors
    • Mypy: 0 errors
    • Bandit: 0 security issues
    • Pytest: 25 in-process unit tests passing with 76% branch coverage

Full Changelog: v2.1.0...v2.3.0

v2.1.0: ag_ops deterministic governance engine

Choose a tag to compare

@FranciscoGrandon FranciscoGrandon released this 31 Oct 06:32

Release v2.1.0 — Deterministic CLI Engine for Agent Governance in Antigravity

Creado por Francisco Grandón Vergara.

Añadido

  • Motor CLI de Gobernanza (�g_ops.py): Implementación determinista en Python 3.9+ puro (100% biblioteca estándar, sin dependencias externas, sub-milisegundo y offline).
  • Módulo guard:
    • Sellado de árbol de pruebas mediante hashes Merkle SHA-256.
    • Aislamiento de recibos criptográficos por target: .ag_state/merkle_guard_<sha256(normcase(target))[:12]>.json.
    • Subcomando witness-red: Valida fallo inicial legítimo (rechazando anomalías de sintaxis o entorno: 2, 3, 4, 5, 126, 127, 9009) y emite recibo v2.
    • Subcomando �erify-green: Reejecuta la prueba y aborta con EACCES_TEST_TAMPERING (exit 2) ante cualquier modificación en archivos sellados, registrando colisiones en vuelo.
    • Subcomando
      enegotiate: Protocolo de Testigo Constructivo (SCAR-PROC-150) con --require-witness contra retractaciones perezosas (LAZY_RETRACTION_REJECTED), soportando --witness-type (spec-collision, �pi-lock, �rch-fork).
  • Módulo distill:
    • Destilación determinista de registros de prueba y compilación en grupos de procesos aislados con control de timeout.
    • Anclaje estricto de regex (^\s*E\s{3}, AssertionError, trazas y panics) para evitar falsos positivos ante salidas como DONE all good.
  • Módulo state:
    • Runlevels lexicográficos (NN_.json) inspirados en /etc/init.d para supervivencia de contexto ante compactaciones.
    • Sellado automático de hashes SHA-256 en creación de artefactos.
    • Detección de deriva con --strict (exit 2), diferenciando ARTIFACT_NEVER_EXISTED de FILE_DELETED.
  • Módulo �st-lint:
    • Linter estático ultra-rápido (< 40 ms) para Python AST: TK001, TK002, PATH001 (con emisión de Vector 4
      eflex), PATH002 (aislamiento de unittest.mock) y AUTH001.
    • Mitigación de deriva autoinmune con --context-map (PROBATIONARY_REVERIFY).
    • Validación topológica Graphviz DOT (Target 15): deadlocks (DOT001), alcanzabilidad (DOT002), salidas de escape en estados asíncronos (SCAR-PROC-152) y predicados de guarda contra callbacks zombis (SCAR-ASYNC-01).
  • Módulo
    egret-mine
    :
    • Minería de arrepentimiento rápido en Git (Etapa 1) en ventanas configurables (--window-min, defecto 60 min).
    • 4 puertas de asimetría deterministas: FIX_VERB_INTENT, TEST_ASSERTION_DELTA, LINE_REVERSAL_OVERLAP (con protección de refactor) y GUARD_COLLISION_RECEIPT.
  • Suite de Pruebas: Verificación automatizada con cobertura de 6/6 bloques ( ests/test_ag_ops.py).
  • Documentación Técnica: README.md unificado con arquitectura física, contratos y fundamentación teórica basada en Synthetic Scars (Randal L. Schwartz).