Repository navigation
Releases
Releases · FranciscoGrandon/ag-ops
ag_ops v2.4.0
ag_ops v2.4.0 — 2026-11-20
Añadido
- Hardening P0 de Superficie Raíz y Entorno (
guard):- Sellado de
root_config_manifestyroot_config_basedesde--test-dirhasta la raíz del repositorio/workspace (conftest.py,pytest.ini,pyproject.toml,setup.cfg,tox.ini,sitecustomize.py,usercustomize.py), registrandoABSENTpara archivos inexistentes y detectando altas o mutaciones tardías comoROOT_CONFIG_DRIFT(exit2), además de rechazo a symlinks/junctions en ancestros y configuraciones raíz. - Inspección determinista de
addoptscontomllib/configparserbloqueando flags evasivos y patrones personalizados mediante--forbid-addopts(UNSAFE_PYTEST_ADDOPTS, exit2). - Sanitización por defecto de
PYTEST_ADDOPTSyPYTHONSTARTUP(ENV_TAINT_DETECTED, exit2) y política auditableenv_policymediante--allow-env-passthrough. - Extracción y verificación del conteo efectivo de pruebas ejecutadas (
witnessed_test_count:ZERO_TESTS_EXECUTED,TEST_COUNT_REGRESSION) y esquemaschema_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.
- Sellado de
- Motor de Rendimiento P1 (100% stdlib):
SinglePassVisitorcon_DEFAULT_LINT_DISPATCHy_LintFileContext, más_StringLiteralScrubberdirecto sobre clones AST.- Hashing acelerado con
hashlib.file_digesty streaming 64 KB con acarreo de\ren frontera. GitBatchReader(git cat-file --batch),_git_batch_changed_line_setsy caché incremental.ag_state/stat_cache.jsoncon guardia anti-racy de 50 ms (--no-cache, deshabilitada en--strict).
- Gobernanza P2 de Historial, Ciclos y Alcance:
- Anclaje mediante
--base-ref <ref>enguard witness-redyguard renegotiatecongit merge-base --is-ancestor, bloqueoSPEC_MODIFIED_SINCE_BASE(exit2) y auditoríaHEAD_MOVE_ALLOWED. - Detector determinista de oscilaciones
k-ciclo (deque(maxlen=16)) enguardystate(OSCILLATION_CYCLE_DETECTED, exit2). - Subcomando
guard check-scope --base <ref> --rule-paths <rutas> [--repo <dir>] --json(MIXED_SCOPE_VIOLATION, exit2).
- Anclaje mediante
- 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
MUT001integrada enSinglePassVisitorpara mutaciones ocultas en métodos de consulta (get_*,is_*,has_*,validate_*), bloqueante en--stricty con supresión# ag_ops: allow-mutation: <razón>.
- Renegociación agrupada atómica
- 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 astream.reconfigurey captura deoscillation_history.jsonen el mismoos.scandirdestate 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]depyproject.tomlantes de leerini_options.addopts.
Seguridad y Métricas Verificadas
- Contención Adversarial (
benchmark_agent_failures.py):31/36(86.11 %) global y12/12(100.0 %) en Manipulación de Pruebas (frente a5/6=83.3 %en v2.3). - Suites de Pruebas:
71/71(pytest tests/ -v),11/11(unittest test_ag_ops_v2.py),18/18compatibilidad legacy (AG_OPS_PATH=./ag_ops.py). - Rendimiento (
bench_perf_v23_vs_v24.py):7/7victorias en latencia frente a v2.3 (1.16xa119.12x).
v2.3.0: Working-Tree Forgery Guard & Full QA Certification
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).
- Extraction and persistence of exact assertion traces (
- 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
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).
- Linter estático ultra-rápido (< 40 ms) para Python AST: TK001, TK002, PATH001 (con emisión de Vector 4
- 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).