Skip to content

v1.1.0 — Clean-Machine Onboarding & System Diagnostics

Choose a tag to compare

View all tags
@enriquemdev enriquemdev released this 05 Sep 22:13
· 2 commits to main since this release
v1.1.0
d57a00d

Finest Computer Use Safety v1.1.0

This release introduces comprehensive, production-grade clean-machine onboarding, multi-tier system diagnostics, and automated lifecycle testing for transitioning fresh macOS environments into verified, secure Computer Use workstations.

Key Additions & Improvements

  • One-Command Onboarding Orchestrator (scripts/bootstrap.py):
    • Automated detection of Antigravity installation and discovery paths.
    • Idempotent registration of Peekaboo MCP in ~/.gemini/config/mcp_config.json while preserving preexisting servers.
    • Full support for --dry-run (zero filesystem mutations), --check, --json, --skip-mcp, and --home=<dir> test isolation.
  • Multi-Tier Diagnostics Inspector (scripts/doctor.py):
    • Standardized preflight checks across OS (macOS 15+ Sequoia), Python (>= 3.9), Antigravity discovery, Peekaboo CLI, macOS TCC permissions, MCP config, and runtime integrity.
    • Standardized exit codes: 0 = Ready, 1 = Action Required, 2 = Critical Error.
    • Non-invasive TCC verification using peekaboo permissions --json.
  • Safe Runtime Smoke Test (scripts/smoke_test.py):
    • Verifies live background semantic inspection without mouse movement.
    • Validates active firewall rejection of unanchored coordinate clicks.
  • Clean-Machine Acceptance Test Harness (scripts/fresh_mac_acceptance.py):
    • 8-stage audit certifying clean start, preflight, bootstrap, doctor, regression, and smoke test.
  • Clean-Machine Lifecycle Test Suite (tests/test_fresh_install.py):
    • 31 automated tests verifying virgin installation, dry-run zero-mutation, idempotence, user config preservation, safe uninstallation, and staged syntax error rollback.
  • Hardened Documentation:
    • docs/troubleshooting.md: Concrete diagnostic workflows for 7 common failure classes.
    • docs/fresh-mac-acceptance.md: Acceptance test procedure and certification matrix.
    • Updated docs/installation.md and docs/architecture.md with explicit macOS 15+ requirements and testing tier definitions.

Verification Summary

  • Intent/Effect Firewall Regression Suite: 35/35 PASS
  • Clean-Machine Lifecycle Test Suite: 31/31 PASS
  • Standalone Firewall Healthcheck: 30/30 PASS
  • Multi-tier System Doctor: READY (Exit Code 0)
  • Target Mac Acceptance Audit: PASS (READY)
Assets 2
Loading