android-agent-harness 1.2.4__tar.gz → 1.2.5__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/PKG-INFO +25 -23
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/README.md +22 -20
- android_agent_harness-1.2.5/agents/VERSION +1 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/release_checksums.json +6 -6
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/rules/harness-rules.md +3 -3
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_release_safety_selftest.py +19 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_vnext_selftest.py +1 -1
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/questions.py +15 -9
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/AGENTS.md.template +1 -1
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/PKG-INFO +25 -23
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/pyproject.toml +3 -3
- android_agent_harness-1.2.4/agents/VERSION +0 -1
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/LICENSE +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/.gitignore +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/check-strings.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/commit-msg.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/crash-triage.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/debug.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/deliver.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/doctor.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/new-feature.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/perf-audit.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/preflight.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/test-quality-audit.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/zoho-sprints.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/__init__.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/commands.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/integrity.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/paths.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/harness_shared/processes.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/hooks.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/mcp_config.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/pm/mcp_registration.jira.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/pm/mcp_registration.linear.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/rules/compose-context.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/rules/gradle-context.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/rules/kmp-context.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_adb_core.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_adb_core_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_android_inspect_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_android_scenarios_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_android_ui_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_antigravity_stability_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_architecture_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_baseline_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_change_decision_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_critical_safety_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_daily_workflow_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_delivery_equivalence_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_efficiency_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_enforcement.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_env_codes.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_env_codes_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_environment.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_external_write_policy_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_gate_results.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_graph_core.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_graph_discovery_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_graph_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_hook_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_host_continuation_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_idempotency.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_installer_config.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_live_process.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_modules.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_performance_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_phase_review_v2_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_pm_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_portability_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_product.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_project_architecture.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_project_intelligence_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_public_cli_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_public_commands.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_repo_files.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_review_models_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_security_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_source_outline.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_source_text.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_stabilization_v41_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_stabilization_v42_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_task_isolation_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_variants.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_verification_recipes.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_verification_value_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_vnext_common.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/__init__.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/engine.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/phase_routing.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/planning.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/router.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow/verification.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_workflow_insight_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_worktree_handoff_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/android_inspect.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/android_ui.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/antigravity_contract.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/antigravity_runtime.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/antigravity_tools.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/architecture_drift.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/architecture_policy.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/architecture_resolver.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/artifact_set.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/baseline_capture.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/build_execution.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/capture_screen.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/cc_pre_tool_safety.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/change_classifier.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/change_decision.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/check_kit_update.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/check_strings.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/context_presentation.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/copilot_pre_tool_safety.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/delivery_equivalence.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/delivery_manifest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/discovery_receipt.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/discovery_router.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/doctor/__init__.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/doctor/engine.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/doctor/models.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/ensure_hook_selftest.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/evidence_store.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/exported_component_guard.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/fast_kt_lint.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/final_verdict.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/final_verifier.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/generate_project_context.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/gradle_error_parser.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/harness_doctor.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/host_continuation.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/incident_reporter.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/install_or_update.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/install_tool_adapters.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/__init__.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/base.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/external_write_policy.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/generic_mcp.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/registry.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/universal_pm.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/zoho_sprints/__init__.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/zoho_sprints/integration.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/integrations/zoho_sprints/policy.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/journey_runner.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/lifecycle.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/logcat_doctor.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/mutation_guard.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/new_feature_scaffold.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/perf_guard.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/phase_review.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/phone_e2e.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/plan_authority.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/plan_document.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/plan_notes.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pm_discovery.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pm_github.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pm_policy.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/policy_vocab.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/post_tool_reconcile.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pre_invocation_reminder.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/pre_tool_safety.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/preflight.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/preflight_check.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/project_context.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/project_graph.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/record_review.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/repair.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_budget.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_execution.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_fix_delta.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_models.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_orchestrator.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_package.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_policy.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_reasoning.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/review_sources.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/reviewer_host.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/room_guard.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/run_device.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/run_gradle_task.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/run_tests_gate.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/self_heal.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/setup_wizard.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/skill_router.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_base.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_context.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_git_lineage.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_merge.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/task_metrics.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/verification_contract.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/verification_steps.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/__init__.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/discovery.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/i18n.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/schema.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/workflow.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/zoho_grant.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/zoho_sync.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/settings.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/SKILL.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/architecture-guidelines.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/automated-skills.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/command-contract.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/daily-scenarios.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/database-and-persistence.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/performance-and-optimization.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/test-quality-guidelines.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-harness/references/ui-layout-and-theming.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/android-security-billing/SKILL.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/brainstorming/SKILL.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/compose-inspector/SKILL.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/git-pr-automator/SKILL.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/gradle-build-optimizer/SKILL.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/kotlin-coroutines-expert/SKILL.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/systematic-debugging/SKILL.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/skills/test-driven-development/SKILL.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/android-ui-expert-agent.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/arch-regression-reviewer-agent.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/bug-test-reviewer-agent.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/qa-diagnostics-agent.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/re-review-prompt.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/review-prompt.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/security-perf-reviewer-agent.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/subagents/spec-compliance-agent.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/CLAUDE.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/CODEX.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/GEMINI.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/QWEN.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/README.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/continue-android-harness.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/copilot-instructions.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/cursor-android-harness.mdc.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/gemini-runtime/android-harness-global.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/gemini-runtime/config.grants.example.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/gemini-runtime/mcp_config.template.json +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/github-instructions.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/pointer.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/windsurf-android-harness.md.template +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/android-inspection.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/android-ui.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/check-strings.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/commit-msg.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/crash-triage.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/debug.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/deliver.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/efficient-context.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/new-feature.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/perf-audit.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/phone-e2e.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/preflight.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/test-quality-audit.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/workflows/zoho-sprints.md +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/SOURCES.txt +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/dependency_links.txt +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/entry_points.txt +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/top_level.txt +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/harness_cli.py +0 -0
- {android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/setup.cfg +0 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: android-agent-harness
|
|
3
|
-
Version: 1.2.
|
|
4
|
-
Summary: Approval-first, evidence-bound
|
|
3
|
+
Version: 1.2.5
|
|
4
|
+
Summary: Approval-first, evidence-bound engineering harness for Android and KMM/KMP (Kotlin Multiplatform Mobile) projects on Google Antigravity.
|
|
5
5
|
Author: Rabee Elkholy
|
|
6
6
|
License-Expression: MIT
|
|
7
7
|
Project-URL: Homepage, https://github.com/rabee-elkholy/android-agent-harness
|
|
@@ -10,7 +10,7 @@ Project-URL: Source, https://github.com/rabee-elkholy/android-agent-harness
|
|
|
10
10
|
Project-URL: Documentation, https://github.com/rabee-elkholy/android-agent-harness/tree/main/docs
|
|
11
11
|
Project-URL: Changelog, https://github.com/rabee-elkholy/android-agent-harness/blob/main/CHANGELOG.md
|
|
12
12
|
Project-URL: Security, https://github.com/rabee-elkholy/android-agent-harness/blob/main/SECURITY.md
|
|
13
|
-
Keywords: android,kmp,ai-agents,code-review,governance,mcp
|
|
13
|
+
Keywords: android,kmm,kmp,kotlin-multiplatform,antigravity,ai-agents,code-review,governance,mcp
|
|
14
14
|
Classifier: Development Status :: 5 - Production/Stable
|
|
15
15
|
Classifier: Environment :: Console
|
|
16
16
|
Classifier: Intended Audience :: Developers
|
|
@@ -29,17 +29,18 @@ Dynamic: license-file
|
|
|
29
29
|
|
|
30
30
|
# Android Agent Harness
|
|
31
31
|
|
|
32
|
-
> **Stricter proof, not heavier daily workflow.**
|
|
32
|
+
> **Stricter proof, not heavier daily workflow — purpose-built for Google Antigravity on Native Android & KMM / KMP (Kotlin Multiplatform Mobile).**
|
|
33
33
|
|
|
34
|
-
Android Agent Harness is an approval-first
|
|
34
|
+
Android Agent Harness is an approval-first **Android & KMM / KMP (Kotlin Multiplatform Mobile)** engineering layer purpose-built for **Google Antigravity**.
|
|
35
35
|
|
|
36
|
-
It gives
|
|
36
|
+
It gives Antigravity bounded AST and symbol context across Native Android (`Kotlin`, `Java`, `Jetpack Compose`, `XML`) and Multiplatform projects (`commonMain`, `androidMain`, `iosMain`, `composeApp`, and iOS `.swift`), records the approved architecture and scope, intercepts out-of-scope file mutations via native `hooks.json`, orchestrates parallel epistemically isolated reviewer subagents (`HARNESS_REVIEW_RESULT_V2`), and binds every test, build, review, and physical device check to cryptographic delivery snapshots.
|
|
37
37
|
|
|
38
38
|
The model focuses on engineering. The harness handles workflow state, proof, and safety boundaries.
|
|
39
39
|
|
|
40
40
|
[](https://github.com/rabee-elkholy/android-agent-harness/actions/workflows/ci.yml)
|
|
41
41
|
[](https://github.com/rabee-elkholy/android-agent-harness/releases)
|
|
42
42
|
[](https://pypi.org/project/android-agent-harness/)
|
|
43
|
+
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
|
|
43
44
|
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
|
|
44
45
|
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
|
|
45
46
|
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/LICENSE)
|
|
@@ -218,10 +219,10 @@ Task A
|
|
|
218
219
|
|
|
219
220
|
### Chat installation (recommended)
|
|
220
221
|
|
|
221
|
-
Open your Android project in
|
|
222
|
+
Open your Android project in **Google Antigravity** and provide this bootstrap prompt:
|
|
222
223
|
|
|
223
224
|
```text
|
|
224
|
-
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.
|
|
225
|
+
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.5/docs/install-or-update-prompt.md and follow all instructions.
|
|
225
226
|
```
|
|
226
227
|
|
|
227
228
|
The installer runs non-destructively: it inspects project Gradle modules, asks a few essential setup questions, presents an installation plan, installs the managed engine under `.agents/`, and runs environment diagnostics. The full harness kit source checkout lives outside the target application (`~/.android-harness/kit`), while your Android project receives only the managed harness runtime payload under `.agents/`.
|
|
@@ -244,7 +245,7 @@ android-harness doctor --repo /path/to/android-project --json
|
|
|
244
245
|
Or run directly from a pinned source clone without global installation:
|
|
245
246
|
|
|
246
247
|
```bash
|
|
247
|
-
git clone --depth 1 --branch v1.2.
|
|
248
|
+
git clone --depth 1 --branch v1.2.5 --single-branch \
|
|
248
249
|
https://github.com/rabee-elkholy/android-agent-harness.git ~/.android-harness/kit
|
|
249
250
|
|
|
250
251
|
python ~/.android-harness/kit/harness_cli.py init \
|
|
@@ -407,8 +408,13 @@ The harness rehydrates and matches repo-local context; the chat provider itself
|
|
|
407
408
|
|
|
408
409
|
---
|
|
409
410
|
|
|
410
|
-
## Android
|
|
411
|
+
## Android & KMM / KMP (Kotlin Multiplatform) protection
|
|
411
412
|
|
|
413
|
+
- **KMM / KMP Multiplatform & Source-Set Purity (`commonMain` / `androidMain` / `iosMain`)**:
|
|
414
|
+
- **Source-set isolation**: Blocks accidental platform leaks (`android.*`, `java.io.*`, or JVM-only APIs inside `commonMain`) during preflight and specialist reviews.
|
|
415
|
+
- **Cross-platform symbol graph (`Kotlin` + `Swift`)**: Indexes `.kt`, `.java`, `.xml`, and iOS `.swift` declarations and call sites in `task-context` and `graph` so shared KMM domain/data changes automatically surface both Android (`androidMain` / `composeApp`) and iOS (`iosMain` / `iosApp`) usages.
|
|
416
|
+
- **`expect` / `actual` contract verification**: Tracks multiplatform boundary declarations across `commonMain`, `androidMain`, and `iosMain` to prevent broken platform implementations.
|
|
417
|
+
- **KMM / Compose Multiplatform APK & module awareness**: Automatically discovers and validates standard Android (`:app` -> `app-debug.apk`) and KMM / Compose Multiplatform (`:composeApp` -> `composeApp-debug.apk`, `:androidApp` -> `androidApp-debug.apk`, `:shared`) topologies.
|
|
412
418
|
- **Room database & schemas**: Source-based checks for version changes, numeric migration paths, Kotlin/Java embedded types, risky schema changes, and unconditional destructive fallback. These heuristics do not replace Room schema export validation or migration tests.
|
|
413
419
|
- **Compose, XML & resources**: String parity across locales (`values/`, `values-ar/`, etc.), plural/placeholder validation, ViewBinding lifecycle leak checks, and Compose UI state handling.
|
|
414
420
|
- **Coroutines, ANR & threading**: Pattern-based checks for selected blocking calls, coroutine scope risks, and exception-handling patterns. Static checks cannot establish freedom from ANRs or concurrency bugs.
|
|
@@ -476,18 +482,14 @@ The harness dynamically discovers and inspects external Project Management MCP s
|
|
|
476
482
|
|
|
477
483
|
## Supported hosts / enforcement model
|
|
478
484
|
|
|
485
|
+
Android Agent Harness is dedicated to **Google Antigravity** as its native target runtime:
|
|
486
|
+
|
|
479
487
|
| Host | Adapter | Mutation Interception | Review proof | Downstream verifier |
|
|
480
488
|
|---|---|---|---|---|
|
|
481
|
-
| **Google Antigravity** | `agents/hooks.json`, custom
|
|
482
|
-
|
|
|
483
|
-
| **Codex** | Root `AGENTS.md`, `.codex/` instructions | Rule/sandbox dependent | V1 response ingestion; independence not natively verified | Yes |
|
|
484
|
-
| **Cursor** | `.cursorrules` / `.cursor/rules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
485
|
-
| **Windsurf** | `.windsurfrules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
486
|
-
| **GitHub Copilot** | `.github/copilot-instructions.md`, installed pre-tool hook adapter | Hook-backed where supported and detected; otherwise rule-enforced | V1 response ingestion | Yes |
|
|
487
|
-
| **Gemini CLI** | Rules, instructions | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
488
|
-
| **Roo Code / Continue** | Mode instructions, system rules | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
489
|
+
| **Google Antigravity** (Primary & Dedicated Target) | `GEMINI.md`, `AGENTS.md`, `.agents/hooks.json`, custom reviewer subagents (`.agents/agents/`), rules, skills | Native hooks (`HARD_ENFORCED`) | Trusted transcript Review V2 (`HARNESS_REVIEW_RESULT_V2`) | Yes |
|
|
490
|
+
| Legacy / External `AGENTS.md` Readers | Optional compatibility templates (`CLAUDE.md`, `CODEX.md`, `.cursor/rules`) | Rule-enforced (`RULE_ENFORCED`) unless host hook is active | V1 response ingestion | Yes |
|
|
489
491
|
|
|
490
|
-
|
|
492
|
+
On **Google Antigravity**, installed native hooks (`hooks.json`) intercept supported file mutations (`write_to_file`, `replace_file_content`, `multi_replace_file_content`) and subagent boundaries (`invoke_subagent`). The harness always reports the detected enforcement tier (`HARD_ENFORCED` vs `RULE_ENFORCED`) honestly.
|
|
491
493
|
|
|
492
494
|
See [docs/tool-support.md](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/tool-support.md) for full integration details.
|
|
493
495
|
|
|
@@ -586,8 +588,8 @@ No. Android Studio remains the primary IDE for Android development, debugging, a
|
|
|
586
588
|
**2. Does this make the AI autonomous?**
|
|
587
589
|
No. The harness is approval-first. All task scopes and risk classifications require explicit developer approval before modifications begin, and delivery requires verified evidence.
|
|
588
590
|
|
|
589
|
-
**3. Can it work with mixed Java/Kotlin/XML/Compose codebases?**
|
|
590
|
-
Yes. It derives local architectural evidence per module and source set and
|
|
591
|
+
**3. Can it work with KMM / KMP (Kotlin Multiplatform Mobile) and mixed Java/Kotlin/XML/Compose/Swift codebases?**
|
|
592
|
+
Yes. It natively supports both standard Android apps and KMM / KMP projects (`commonMain`, `androidMain`, `iosMain`, `:shared`, `:composeApp`, `:androidApp`, and iOS `.swift` files). It derives local architectural evidence per module and source set, checks `commonMain` platform purity, and verifies changes against the approved architecture.
|
|
591
593
|
|
|
592
594
|
**4. Does every task run many reviewers?**
|
|
593
595
|
No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) and low-risk changes (T1) skip reviewer subagents entirely. Specialized reviewers run only when justified by the final classified blast radius.
|
|
@@ -595,8 +597,8 @@ No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) a
|
|
|
595
597
|
**5. Does every task require a device?**
|
|
596
598
|
No. Device deployment and mobile verification are required only for tiers and changes involving device-facing surfaces (such as T4/T5 with Room, permissions, or system services) or when explicitly requested.
|
|
597
599
|
|
|
598
|
-
**6.
|
|
599
|
-
|
|
600
|
+
**6. Why is the harness focused on Google Antigravity?**
|
|
601
|
+
Specializing in Google Antigravity enables deep native integration: `HARD_ENFORCED` pre-tool and post-tool hooks (`hooks.json`), parallel subagent orchestration (`invoke_subagent`) with native SQLite execution proof (`HARNESS_REVIEW_RESULT_V2`), interactive `ask_question` decision cards, and Android Studio / Device Hub / Compose Preview diagnostics (`android-ui`, `android-inspect`). Legacy adapter templates remain in the kit for backward compatibility during updates.
|
|
600
602
|
|
|
601
603
|
**7. Does the harness commit/push code?**
|
|
602
604
|
Installed client-project workflows leave Git mutations to the developer and normally leave edits unstaged. Maintenance of this harness repository may use Git or publish only when its maintainer explicitly authorizes those actions.
|
|
@@ -1,16 +1,17 @@
|
|
|
1
1
|
# Android Agent Harness
|
|
2
2
|
|
|
3
|
-
> **Stricter proof, not heavier daily workflow.**
|
|
3
|
+
> **Stricter proof, not heavier daily workflow — purpose-built for Google Antigravity on Native Android & KMM / KMP (Kotlin Multiplatform Mobile).**
|
|
4
4
|
|
|
5
|
-
Android Agent Harness is an approval-first
|
|
5
|
+
Android Agent Harness is an approval-first **Android & KMM / KMP (Kotlin Multiplatform Mobile)** engineering layer purpose-built for **Google Antigravity**.
|
|
6
6
|
|
|
7
|
-
It gives
|
|
7
|
+
It gives Antigravity bounded AST and symbol context across Native Android (`Kotlin`, `Java`, `Jetpack Compose`, `XML`) and Multiplatform projects (`commonMain`, `androidMain`, `iosMain`, `composeApp`, and iOS `.swift`), records the approved architecture and scope, intercepts out-of-scope file mutations via native `hooks.json`, orchestrates parallel epistemically isolated reviewer subagents (`HARNESS_REVIEW_RESULT_V2`), and binds every test, build, review, and physical device check to cryptographic delivery snapshots.
|
|
8
8
|
|
|
9
9
|
The model focuses on engineering. The harness handles workflow state, proof, and safety boundaries.
|
|
10
10
|
|
|
11
11
|
[](https://github.com/rabee-elkholy/android-agent-harness/actions/workflows/ci.yml)
|
|
12
12
|
[](https://github.com/rabee-elkholy/android-agent-harness/releases)
|
|
13
13
|
[](https://pypi.org/project/android-agent-harness/)
|
|
14
|
+
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
|
|
14
15
|
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
|
|
15
16
|
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
|
|
16
17
|
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/LICENSE)
|
|
@@ -189,10 +190,10 @@ Task A
|
|
|
189
190
|
|
|
190
191
|
### Chat installation (recommended)
|
|
191
192
|
|
|
192
|
-
Open your Android project in
|
|
193
|
+
Open your Android project in **Google Antigravity** and provide this bootstrap prompt:
|
|
193
194
|
|
|
194
195
|
```text
|
|
195
|
-
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.
|
|
196
|
+
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.5/docs/install-or-update-prompt.md and follow all instructions.
|
|
196
197
|
```
|
|
197
198
|
|
|
198
199
|
The installer runs non-destructively: it inspects project Gradle modules, asks a few essential setup questions, presents an installation plan, installs the managed engine under `.agents/`, and runs environment diagnostics. The full harness kit source checkout lives outside the target application (`~/.android-harness/kit`), while your Android project receives only the managed harness runtime payload under `.agents/`.
|
|
@@ -215,7 +216,7 @@ android-harness doctor --repo /path/to/android-project --json
|
|
|
215
216
|
Or run directly from a pinned source clone without global installation:
|
|
216
217
|
|
|
217
218
|
```bash
|
|
218
|
-
git clone --depth 1 --branch v1.2.
|
|
219
|
+
git clone --depth 1 --branch v1.2.5 --single-branch \
|
|
219
220
|
https://github.com/rabee-elkholy/android-agent-harness.git ~/.android-harness/kit
|
|
220
221
|
|
|
221
222
|
python ~/.android-harness/kit/harness_cli.py init \
|
|
@@ -378,8 +379,13 @@ The harness rehydrates and matches repo-local context; the chat provider itself
|
|
|
378
379
|
|
|
379
380
|
---
|
|
380
381
|
|
|
381
|
-
## Android
|
|
382
|
+
## Android & KMM / KMP (Kotlin Multiplatform) protection
|
|
382
383
|
|
|
384
|
+
- **KMM / KMP Multiplatform & Source-Set Purity (`commonMain` / `androidMain` / `iosMain`)**:
|
|
385
|
+
- **Source-set isolation**: Blocks accidental platform leaks (`android.*`, `java.io.*`, or JVM-only APIs inside `commonMain`) during preflight and specialist reviews.
|
|
386
|
+
- **Cross-platform symbol graph (`Kotlin` + `Swift`)**: Indexes `.kt`, `.java`, `.xml`, and iOS `.swift` declarations and call sites in `task-context` and `graph` so shared KMM domain/data changes automatically surface both Android (`androidMain` / `composeApp`) and iOS (`iosMain` / `iosApp`) usages.
|
|
387
|
+
- **`expect` / `actual` contract verification**: Tracks multiplatform boundary declarations across `commonMain`, `androidMain`, and `iosMain` to prevent broken platform implementations.
|
|
388
|
+
- **KMM / Compose Multiplatform APK & module awareness**: Automatically discovers and validates standard Android (`:app` -> `app-debug.apk`) and KMM / Compose Multiplatform (`:composeApp` -> `composeApp-debug.apk`, `:androidApp` -> `androidApp-debug.apk`, `:shared`) topologies.
|
|
383
389
|
- **Room database & schemas**: Source-based checks for version changes, numeric migration paths, Kotlin/Java embedded types, risky schema changes, and unconditional destructive fallback. These heuristics do not replace Room schema export validation or migration tests.
|
|
384
390
|
- **Compose, XML & resources**: String parity across locales (`values/`, `values-ar/`, etc.), plural/placeholder validation, ViewBinding lifecycle leak checks, and Compose UI state handling.
|
|
385
391
|
- **Coroutines, ANR & threading**: Pattern-based checks for selected blocking calls, coroutine scope risks, and exception-handling patterns. Static checks cannot establish freedom from ANRs or concurrency bugs.
|
|
@@ -447,18 +453,14 @@ The harness dynamically discovers and inspects external Project Management MCP s
|
|
|
447
453
|
|
|
448
454
|
## Supported hosts / enforcement model
|
|
449
455
|
|
|
456
|
+
Android Agent Harness is dedicated to **Google Antigravity** as its native target runtime:
|
|
457
|
+
|
|
450
458
|
| Host | Adapter | Mutation Interception | Review proof | Downstream verifier |
|
|
451
459
|
|---|---|---|---|---|
|
|
452
|
-
| **Google Antigravity** | `agents/hooks.json`, custom
|
|
453
|
-
|
|
|
454
|
-
| **Codex** | Root `AGENTS.md`, `.codex/` instructions | Rule/sandbox dependent | V1 response ingestion; independence not natively verified | Yes |
|
|
455
|
-
| **Cursor** | `.cursorrules` / `.cursor/rules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
456
|
-
| **Windsurf** | `.windsurfrules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
457
|
-
| **GitHub Copilot** | `.github/copilot-instructions.md`, installed pre-tool hook adapter | Hook-backed where supported and detected; otherwise rule-enforced | V1 response ingestion | Yes |
|
|
458
|
-
| **Gemini CLI** | Rules, instructions | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
459
|
-
| **Roo Code / Continue** | Mode instructions, system rules | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
460
|
+
| **Google Antigravity** (Primary & Dedicated Target) | `GEMINI.md`, `AGENTS.md`, `.agents/hooks.json`, custom reviewer subagents (`.agents/agents/`), rules, skills | Native hooks (`HARD_ENFORCED`) | Trusted transcript Review V2 (`HARNESS_REVIEW_RESULT_V2`) | Yes |
|
|
461
|
+
| Legacy / External `AGENTS.md` Readers | Optional compatibility templates (`CLAUDE.md`, `CODEX.md`, `.cursor/rules`) | Rule-enforced (`RULE_ENFORCED`) unless host hook is active | V1 response ingestion | Yes |
|
|
460
462
|
|
|
461
|
-
|
|
463
|
+
On **Google Antigravity**, installed native hooks (`hooks.json`) intercept supported file mutations (`write_to_file`, `replace_file_content`, `multi_replace_file_content`) and subagent boundaries (`invoke_subagent`). The harness always reports the detected enforcement tier (`HARD_ENFORCED` vs `RULE_ENFORCED`) honestly.
|
|
462
464
|
|
|
463
465
|
See [docs/tool-support.md](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/tool-support.md) for full integration details.
|
|
464
466
|
|
|
@@ -557,8 +559,8 @@ No. Android Studio remains the primary IDE for Android development, debugging, a
|
|
|
557
559
|
**2. Does this make the AI autonomous?**
|
|
558
560
|
No. The harness is approval-first. All task scopes and risk classifications require explicit developer approval before modifications begin, and delivery requires verified evidence.
|
|
559
561
|
|
|
560
|
-
**3. Can it work with mixed Java/Kotlin/XML/Compose codebases?**
|
|
561
|
-
Yes. It derives local architectural evidence per module and source set and
|
|
562
|
+
**3. Can it work with KMM / KMP (Kotlin Multiplatform Mobile) and mixed Java/Kotlin/XML/Compose/Swift codebases?**
|
|
563
|
+
Yes. It natively supports both standard Android apps and KMM / KMP projects (`commonMain`, `androidMain`, `iosMain`, `:shared`, `:composeApp`, `:androidApp`, and iOS `.swift` files). It derives local architectural evidence per module and source set, checks `commonMain` platform purity, and verifies changes against the approved architecture.
|
|
562
564
|
|
|
563
565
|
**4. Does every task run many reviewers?**
|
|
564
566
|
No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) and low-risk changes (T1) skip reviewer subagents entirely. Specialized reviewers run only when justified by the final classified blast radius.
|
|
@@ -566,8 +568,8 @@ No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) a
|
|
|
566
568
|
**5. Does every task require a device?**
|
|
567
569
|
No. Device deployment and mobile verification are required only for tiers and changes involving device-facing surfaces (such as T4/T5 with Room, permissions, or system services) or when explicitly requested.
|
|
568
570
|
|
|
569
|
-
**6.
|
|
570
|
-
|
|
571
|
+
**6. Why is the harness focused on Google Antigravity?**
|
|
572
|
+
Specializing in Google Antigravity enables deep native integration: `HARD_ENFORCED` pre-tool and post-tool hooks (`hooks.json`), parallel subagent orchestration (`invoke_subagent`) with native SQLite execution proof (`HARNESS_REVIEW_RESULT_V2`), interactive `ask_question` decision cards, and Android Studio / Device Hub / Compose Preview diagnostics (`android-ui`, `android-inspect`). Legacy adapter templates remain in the kit for backward compatibility during updates.
|
|
571
573
|
|
|
572
574
|
**7. Does the harness commit/push code?**
|
|
573
575
|
Installed client-project workflows leave Git mutations to the developer and normally leave edits unstaged. Maintenance of this harness repository may use Git or publish only when its maintainer explicitly authorizes those actions.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
1.2.5
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"algorithm": "sha256",
|
|
3
3
|
"files": {
|
|
4
4
|
"agents/.gitignore": "8a0eaa7cc8e55d17da96f31f6863b5e9b5aba15bb03fd6e8fb07a8cb89e5715c",
|
|
5
|
-
"agents/VERSION": "
|
|
5
|
+
"agents/VERSION": "fe2b7c237b5a6e42818aa3e4f7fc5820f49c32289c32c96260ef89a8c8f6d3d7",
|
|
6
6
|
"agents/command-packs/check-strings.md.template": "688d464d69849d4b5bc68faae49bf79a196d882765ac5eaf9b829bd8df8b9c0b",
|
|
7
7
|
"agents/command-packs/commit-msg.md.template": "cf8bd58a510a6953a66e2c705c8c9515f0369e4fa454af9bbc9c7f6b1805b80e",
|
|
8
8
|
"agents/command-packs/crash-triage.md.template": "acea2311229cc8d4f7d1eae515a4d3f3b52246437df25ee75dfa40d3407dc69a",
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"agents/pm/mcp_registration.linear.md": "7547aa65303993c89ae109b663d4cdbc200671a58b9a9f6fdfdfb1fb27b0c4c9",
|
|
27
27
|
"agents/rules/compose-context.md": "338cfebf9f718b69b588c2eedcad718ec862db16c7142f4cbaa74bbb189cd501",
|
|
28
28
|
"agents/rules/gradle-context.md": "a797096a10859c4fb9d337a34cf3fdb647c9657c38aea408bbcd16c07926a9f4",
|
|
29
|
-
"agents/rules/harness-rules.md": "
|
|
29
|
+
"agents/rules/harness-rules.md": "7cf2a0774c37768fb4f480ec3a2a2ad137e8a16fccabe765adaa214f23f0a007",
|
|
30
30
|
"agents/rules/kmp-context.md": "f258d89ba9f1f032f4e256e83a71fde07f65df7eeef3c307fcd0b12de26b856a",
|
|
31
31
|
"agents/scripts/_adb_core.py": "094bfe0768b553496420cb82fe4947cf38002f84087fa8d259adcfef0ed51f7a",
|
|
32
32
|
"agents/scripts/_adb_core_selftest.py": "f2f6b03168253032b4fdfa6289ac67d80824723fc84903f17d2d1cee62569ba2",
|
|
@@ -65,7 +65,7 @@
|
|
|
65
65
|
"agents/scripts/_project_intelligence_selftest.py": "0f8117e3d1c8ea6b74f584b557bf531fcb2482081d3f1078c99a6539ef8a8a9e",
|
|
66
66
|
"agents/scripts/_public_cli_selftest.py": "23610078906c1cc7e035bfa954d99f42e8df40acaa62d155a4557318b6966f9d",
|
|
67
67
|
"agents/scripts/_public_commands.py": "3aa974d2ce8907f49c5a437e8f3d6c70cd04942be0f09aa0a8ad6ac59a41dc5f",
|
|
68
|
-
"agents/scripts/_release_safety_selftest.py": "
|
|
68
|
+
"agents/scripts/_release_safety_selftest.py": "c4578e68aa058cffbdd000e3fef211ca94237985c10fe368bf562551506fdff4",
|
|
69
69
|
"agents/scripts/_repo_files.py": "69fab31be58f2fcef0dacb44d75b93b6a1f3192fcad1f514217ea2219b837818",
|
|
70
70
|
"agents/scripts/_review_models_selftest.py": "264162e5e44d4acfa6432457924e7e2f8d41f66c1912eafb3d1bb242c7a713d5",
|
|
71
71
|
"agents/scripts/_security_selftest.py": "8a5b7fbb26990a37006239518391cab5660318951c26dc2327af8be6521b1bf9",
|
|
@@ -78,7 +78,7 @@
|
|
|
78
78
|
"agents/scripts/_verification_recipes.py": "5bf892d82818020c4f7fff063a3983d383b2b4ee50fc459b29a44eb53f2f1209",
|
|
79
79
|
"agents/scripts/_verification_value_selftest.py": "89e786c8b04cad6e925bd78d9a98bf59f6d03b4639b18d9ab32073917b62d176",
|
|
80
80
|
"agents/scripts/_vnext_common.py": "5036dbaf9e303f3652c66287f213d5eca13197ffbf4fa3438d81fa9dd476c03b",
|
|
81
|
-
"agents/scripts/_vnext_selftest.py": "
|
|
81
|
+
"agents/scripts/_vnext_selftest.py": "6f5820e970bad8b3b0ac6123ed794bc897d8bab053db78748f0db0ff053efdf6",
|
|
82
82
|
"agents/scripts/_workflow/__init__.py": "c22fd03196f70c813422712dfe3cb56689bfcbc32d08089987ffe8b41191675e",
|
|
83
83
|
"agents/scripts/_workflow/engine.py": "595fd34139ba13ed2467da3067abfc4c710e0d1a0406b087e6b9c482466665af",
|
|
84
84
|
"agents/scripts/_workflow/phase_routing.py": "5948f0c916f720a522785965e71bf478add3dda1955d8dd8cbf2743498f07e78",
|
|
@@ -186,7 +186,7 @@
|
|
|
186
186
|
"agents/scripts/wizard/__init__.py": "bc3e731532f96d9de98ce49c51b9cd969d682b12d1d7fb3779953152730ef60a",
|
|
187
187
|
"agents/scripts/wizard/discovery.py": "c10abe695d3e4feaa440e01020e2af76b66bcc85a3548e6bda2be2262631e187",
|
|
188
188
|
"agents/scripts/wizard/i18n.py": "89d1c25ff5ac8c50a4fda681e797b97db5ae9be0c74a7b6cfb85c22f22b83622",
|
|
189
|
-
"agents/scripts/wizard/questions.py": "
|
|
189
|
+
"agents/scripts/wizard/questions.py": "aa1c2a03ef88d346ac6bd637190753ff747eb23ab577ff55391c5dba27359153",
|
|
190
190
|
"agents/scripts/wizard/schema.py": "17f073c9ba044e1d65dd541511401a60dce3183c655f8a40ece1cb4e85f188ee",
|
|
191
191
|
"agents/scripts/workflow.py": "a7becec2309e4071c5efff5bb6600a6e706b3623a59be0a7cd744d34868ca2e3",
|
|
192
192
|
"agents/scripts/zoho_grant.py": "1ff1b3d1cd4cf350d62701c3bcc46b3430be4dbe913571b4eb90477da9fac8d0",
|
|
@@ -217,7 +217,7 @@
|
|
|
217
217
|
"agents/subagents/review-prompt.md": "bde25a34e54344b48aac75063d27a861e70f174d637ce30f43def88bd27baff5",
|
|
218
218
|
"agents/subagents/security-perf-reviewer-agent.json": "39126b1bf981dcbb304163470a4bcdea892f2f204f33258ae911e0f641bfeeae",
|
|
219
219
|
"agents/subagents/spec-compliance-agent.json": "4d9a91d94fbc097a46a4978adce068dde54e218a7831c64f8c80d90aae58ed04",
|
|
220
|
-
"agents/tool-adapters/AGENTS.md.template": "
|
|
220
|
+
"agents/tool-adapters/AGENTS.md.template": "803d42ff2a3a8b5e2a6ddb054251389ed821e99896bd957823c820ac67984d61",
|
|
221
221
|
"agents/tool-adapters/CLAUDE.md.template": "011adc69ab7dbde774a373183850f769dc864058dffedb0f78364d0fc0fbd3b7",
|
|
222
222
|
"agents/tool-adapters/CODEX.md.template": "0b2a7b9a5d990d0abd641970b3a07ad42fbad960f67629514ea7d2b73be8459e",
|
|
223
223
|
"agents/tool-adapters/GEMINI.md.template": "b84142de56442d6dc2437b5700c6e0580c394139c360fdc39db71d00e88d44f2",
|
|
@@ -15,13 +15,13 @@ This is the authoritative always-loaded contract. Route detailed Android guidanc
|
|
|
15
15
|
- **Single-shot Proceed invariant**: Proceed appears only for initial task approval. One approval covers all stated phases without pausing between phases.
|
|
16
16
|
- **Direct follow-up execution**: approved in-scope fixes execute immediately; new plan/Proceed only if behavior, sensitive surface, contract, external write, or blast radius materially expands.
|
|
17
17
|
- **Review corrections are not replanning**: resume the same task (`workflow.py resume`) before fixes, then freeze fresh final verification and execute only its routed reviewers. Completed semantic phase checkpoints remain historical proof; clarify existing decisions with `task plan-note --task-id <id> --text "<clarification>" --source conversation --proof-reference "<decision>"` (never edit `plan.md` manually; narrative `revise` on an approved task requires `--material-change-reason "<actual requirement expansion>"`).
|
|
18
|
-
- **Host continuation**: use `task continue --task-id <id> --host
|
|
18
|
+
- **Host continuation**: use `task continue --task-id <id> --host antigravity` (stop former writer before `--source-stopped`; include `--expect-session`).
|
|
19
19
|
- Durable context (`context note` / `context instruct` with `--replace`, `--remove`, `--supersedes`) is administrative: clarify ambiguity first, then organize and translate into clear, self-contained English before saving. Always follow `.agents/project-context/project-notes.md` and `developer-instructions.json`. Commit, push, release, tracker mutation, app uninstall/data clear, downgrade, purchase, and publication are never implicit.
|
|
20
20
|
- **Unified Chat & Question UI/UX (Language-Adaptive)**:
|
|
21
21
|
- **Dynamic Language & RTL Hygiene**: Match the developer's active conversation language for all headings, table headers, and labels. In any right-to-left (RTL) language, start every paragraph, bullet, and numbered item with a word in that language and wrap every file name, symbol, command, path, and English technical term in `` `backticks` ``.
|
|
22
22
|
- **6 Canonical Task Cards** (no emoji, no duplicate summaries): (1) **Plan Approval** (`[plan.md](<PLAN_DOCUMENT_URI>)` + translated `APPROVAL_BRIEF` bullets inside `ask_question`, never in a code block), (2) **Reviewer Dispatch** (`| Reviewer | Model | Status |` with only the role name in `Reviewer` and active model in `Model`; on partial completion `WAIT_FOR_REVIEWERS` / `WAIT_FOR_PHASE_REVIEWERS`, output at most one short progress line like `1/3` without listing pending reviewer names), (3) **Review Verdict** (`| Reviewer | Model | Verdict | Findings |` after finalize), (4) **Mobile Walkthrough & Sign-Off** (3 sections: Navigation & Preconditions, `| # | Action | Expected Result |` table with <=5 rows, Edge Cases, with NO file-change summary wall, in chat or directly inside `ask_question` in the SAME turn), (5) **Ready for Delivery & Commit** (verified files in backticks + copyable fenced `text` Conventional Commit block with subject and bullet body, included in chat and inside `ask_question`), and (6) **Decision & Escalation Modal (`ask_question`)** (concise bold heading + bulleted context for `SELECT_REVIEW_MODEL`, `MOBILE_VALIDATION_DECISION`, stale/scope decisions, or pre-planning clarifications).
|
|
23
23
|
|
|
24
|
-
Lifecycle (`PLAN -> BUILD -> VERIFY -> SHIP -> DONE`): Follow `NEXT_ACTION`/`NEXT_REASON`; query `python .agents/harness.py task status --task-id <id> --next --brief --json` only when missing. `verify-steps --task-id <id> --host
|
|
24
|
+
Lifecycle (`PLAN -> BUILD -> VERIFY -> SHIP -> DONE`): Follow `NEXT_ACTION`/`NEXT_REASON`; query `python .agents/harness.py task status --task-id <id> --next --brief --json` only when missing. `verify-steps --task-id <id> --host antigravity` runs consecutive deterministic steps and stops at failures, reviews, or decisions (`STOPPED` is not completion). Never fabricate approval or evidence.
|
|
25
25
|
|
|
26
26
|
## 2. Discovery and harness boundary
|
|
27
27
|
|
|
@@ -77,7 +77,7 @@ Report detected tier honestly: `HARD_ENFORCED`, `RULE_ENFORCED`, or `UNSUPPORTED
|
|
|
77
77
|
| Context note | `python .agents/harness.py context note "<structured-english-note>"` (`--replace "<old>"` / `--remove "<old>"`) |
|
|
78
78
|
| Task guidance | `python .agents/harness.py task status --task-id <id> --next` |
|
|
79
79
|
| Policy diagnosis | `python .agents/harness.py policy --json` |
|
|
80
|
-
| Consecutive verification steps | `python .agents/harness.py verify-steps --task-id <id> --host
|
|
80
|
+
| Consecutive verification steps | `python .agents/harness.py verify-steps --task-id <id> --host antigravity` |
|
|
81
81
|
| Preflight | `python .agents/harness.py preflight` |
|
|
82
82
|
| Unit tests | `python .agents/harness.py test` |
|
|
83
83
|
| Review package | `python .agents/harness.py review package --task-id <id>` |
|
|
@@ -345,6 +345,25 @@ class ReleaseSafetyTests(unittest.TestCase):
|
|
|
345
345
|
errors = validation.validate_release(KIT, version)
|
|
346
346
|
self.assertTrue(any("relative link" in err for err in errors), errors)
|
|
347
347
|
|
|
348
|
+
def test_release_commit_subject_accepts_descriptive_conventional_formats(self):
|
|
349
|
+
for valid_subj in (
|
|
350
|
+
"chore(release): v1.2.5 — Consent-first incident reporting",
|
|
351
|
+
"chore(release): v1.2.5",
|
|
352
|
+
"release(v1.2.5): consent-first incident reporting",
|
|
353
|
+
"release: v1.2.5 — consent-first incident reporting",
|
|
354
|
+
"release: v1.2.5",
|
|
355
|
+
):
|
|
356
|
+
with self.subTest(valid_subj=valid_subj):
|
|
357
|
+
self.assertTrue(automatic_release.is_release_commit_subject(valid_subj, "v1.2.5"))
|
|
358
|
+
for invalid_subj in (
|
|
359
|
+
"feat(incidents): add consent-first reporting",
|
|
360
|
+
"chore(release): v1.2.4 — wrong version",
|
|
361
|
+
"release: v1.2.50",
|
|
362
|
+
"",
|
|
363
|
+
):
|
|
364
|
+
with self.subTest(invalid_subj=invalid_subj):
|
|
365
|
+
self.assertFalse(automatic_release.is_release_commit_subject(invalid_subj, "v1.2.5"))
|
|
366
|
+
|
|
348
367
|
|
|
349
368
|
if __name__ == "__main__":
|
|
350
369
|
unittest.main()
|
{android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/_vnext_selftest.py
RENAMED
|
@@ -140,7 +140,7 @@ class GuidanceTests(unittest.TestCase):
|
|
|
140
140
|
|
|
141
141
|
def test_repository_constitution_guard(self) -> None:
|
|
142
142
|
constitution = (KIT / "PROJECT_CONSTITUTION.md").read_text(encoding="utf-8")
|
|
143
|
-
for pointer in ("AGENTS.md", "GEMINI.md"
|
|
143
|
+
for pointer in ("AGENTS.md", "GEMINI.md"):
|
|
144
144
|
self.assertIn("PROJECT_CONSTITUTION.md", (KIT / pointer).read_text(encoding="utf-8"))
|
|
145
145
|
for marker in (
|
|
146
146
|
"Stricter proof, not heavier workflow", "Approval-first", "Human Git Authority",
|
{android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/scripts/wizard/questions.py
RENAMED
|
@@ -53,19 +53,19 @@ def questions_payload(repo: Path, lang: str, facts: dict | None = None) -> list[
|
|
|
53
53
|
],
|
|
54
54
|
},
|
|
55
55
|
]
|
|
56
|
-
tool_opts = [
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
tool_opts.append({"id": "all", "label": labels["all"]})
|
|
56
|
+
tool_opts = [
|
|
57
|
+
{
|
|
58
|
+
"id": "antigravity",
|
|
59
|
+
"label": f"{labels['antigravity']} (Recommended)",
|
|
60
|
+
}
|
|
61
|
+
]
|
|
63
62
|
qs.append(
|
|
64
63
|
{
|
|
65
64
|
"id": "i14",
|
|
66
65
|
"station": 1,
|
|
67
66
|
"station_title": "Workspace & AI Tooling",
|
|
68
|
-
"required":
|
|
67
|
+
"required": False,
|
|
68
|
+
"default": ["antigravity"],
|
|
69
69
|
"allow_multiple": True,
|
|
70
70
|
"prompt": t(lang, "i14"),
|
|
71
71
|
"options": tool_opts,
|
|
@@ -824,7 +824,11 @@ def normalize(raw: dict, facts: dict) -> dict:
|
|
|
824
824
|
"networking": net_val,
|
|
825
825
|
"locales": loc_val,
|
|
826
826
|
}
|
|
827
|
-
tools = raw.get("i14")
|
|
827
|
+
tools = raw.get("i14") if "i14" in raw else ["antigravity"]
|
|
828
|
+
if not tools and "i14" not in raw:
|
|
829
|
+
tools = ["antigravity"]
|
|
830
|
+
elif not tools:
|
|
831
|
+
tools = []
|
|
828
832
|
if isinstance(tools, str):
|
|
829
833
|
tools = [x.strip() for x in tools.split(",") if x.strip()]
|
|
830
834
|
if "all" in tools:
|
|
@@ -1155,6 +1159,8 @@ def existing_defaults(repo: Path) -> dict[str, object]:
|
|
|
1155
1159
|
defaults["review_model_policy_text"] = json.dumps(policy)
|
|
1156
1160
|
if isinstance(tools, list) and tools:
|
|
1157
1161
|
defaults["i14"] = list(tools)
|
|
1162
|
+
else:
|
|
1163
|
+
defaults["i14"] = ["antigravity"]
|
|
1158
1164
|
return defaults
|
|
1159
1165
|
|
|
1160
1166
|
|
{android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/tool-adapters/AGENTS.md.template
RENAMED
|
@@ -26,7 +26,7 @@ Read `.agents/rules/harness-rules.md`; it is the authoritative safety contract.
|
|
|
26
26
|
| Context note | `{{PY}} .agents/harness.py context note "<structured-english-note>"` (`--replace "<old>"` / `--remove "<old>"`) |
|
|
27
27
|
| Preflight | `{{PY}} .agents/harness.py preflight` |
|
|
28
28
|
| Unit tests | `{{PY}} .agents/harness.py test` |
|
|
29
|
-
| Review evidence | `{{PY}} .agents/
|
|
29
|
+
| Review evidence | `{{PY}} .agents/harness.py review complete --task <id> --reviewer <role> --execution-id <convId>` -> `review finalize --task <id>` |
|
|
30
30
|
| Resume | `{{PY}} .agents/harness.py task resume --task-id <id>` |
|
|
31
31
|
| Assemble | `{{PY}} .agents/harness.py assemble` |
|
|
32
32
|
| Device | `{{PY}} .agents/harness.py device install-start` |
|
{android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/android_agent_harness.egg-info/PKG-INFO
RENAMED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: android-agent-harness
|
|
3
|
-
Version: 1.2.
|
|
4
|
-
Summary: Approval-first, evidence-bound
|
|
3
|
+
Version: 1.2.5
|
|
4
|
+
Summary: Approval-first, evidence-bound engineering harness for Android and KMM/KMP (Kotlin Multiplatform Mobile) projects on Google Antigravity.
|
|
5
5
|
Author: Rabee Elkholy
|
|
6
6
|
License-Expression: MIT
|
|
7
7
|
Project-URL: Homepage, https://github.com/rabee-elkholy/android-agent-harness
|
|
@@ -10,7 +10,7 @@ Project-URL: Source, https://github.com/rabee-elkholy/android-agent-harness
|
|
|
10
10
|
Project-URL: Documentation, https://github.com/rabee-elkholy/android-agent-harness/tree/main/docs
|
|
11
11
|
Project-URL: Changelog, https://github.com/rabee-elkholy/android-agent-harness/blob/main/CHANGELOG.md
|
|
12
12
|
Project-URL: Security, https://github.com/rabee-elkholy/android-agent-harness/blob/main/SECURITY.md
|
|
13
|
-
Keywords: android,kmp,ai-agents,code-review,governance,mcp
|
|
13
|
+
Keywords: android,kmm,kmp,kotlin-multiplatform,antigravity,ai-agents,code-review,governance,mcp
|
|
14
14
|
Classifier: Development Status :: 5 - Production/Stable
|
|
15
15
|
Classifier: Environment :: Console
|
|
16
16
|
Classifier: Intended Audience :: Developers
|
|
@@ -29,17 +29,18 @@ Dynamic: license-file
|
|
|
29
29
|
|
|
30
30
|
# Android Agent Harness
|
|
31
31
|
|
|
32
|
-
> **Stricter proof, not heavier daily workflow.**
|
|
32
|
+
> **Stricter proof, not heavier daily workflow — purpose-built for Google Antigravity on Native Android & KMM / KMP (Kotlin Multiplatform Mobile).**
|
|
33
33
|
|
|
34
|
-
Android Agent Harness is an approval-first
|
|
34
|
+
Android Agent Harness is an approval-first **Android & KMM / KMP (Kotlin Multiplatform Mobile)** engineering layer purpose-built for **Google Antigravity**.
|
|
35
35
|
|
|
36
|
-
It gives
|
|
36
|
+
It gives Antigravity bounded AST and symbol context across Native Android (`Kotlin`, `Java`, `Jetpack Compose`, `XML`) and Multiplatform projects (`commonMain`, `androidMain`, `iosMain`, `composeApp`, and iOS `.swift`), records the approved architecture and scope, intercepts out-of-scope file mutations via native `hooks.json`, orchestrates parallel epistemically isolated reviewer subagents (`HARNESS_REVIEW_RESULT_V2`), and binds every test, build, review, and physical device check to cryptographic delivery snapshots.
|
|
37
37
|
|
|
38
38
|
The model focuses on engineering. The harness handles workflow state, proof, and safety boundaries.
|
|
39
39
|
|
|
40
40
|
[](https://github.com/rabee-elkholy/android-agent-harness/actions/workflows/ci.yml)
|
|
41
41
|
[](https://github.com/rabee-elkholy/android-agent-harness/releases)
|
|
42
42
|
[](https://pypi.org/project/android-agent-harness/)
|
|
43
|
+
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
|
|
43
44
|
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
|
|
44
45
|
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/compatibility-matrix.md)
|
|
45
46
|
[](https://github.com/rabee-elkholy/android-agent-harness/blob/main/LICENSE)
|
|
@@ -218,10 +219,10 @@ Task A
|
|
|
218
219
|
|
|
219
220
|
### Chat installation (recommended)
|
|
220
221
|
|
|
221
|
-
Open your Android project in
|
|
222
|
+
Open your Android project in **Google Antigravity** and provide this bootstrap prompt:
|
|
222
223
|
|
|
223
224
|
```text
|
|
224
|
-
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.
|
|
225
|
+
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.5/docs/install-or-update-prompt.md and follow all instructions.
|
|
225
226
|
```
|
|
226
227
|
|
|
227
228
|
The installer runs non-destructively: it inspects project Gradle modules, asks a few essential setup questions, presents an installation plan, installs the managed engine under `.agents/`, and runs environment diagnostics. The full harness kit source checkout lives outside the target application (`~/.android-harness/kit`), while your Android project receives only the managed harness runtime payload under `.agents/`.
|
|
@@ -244,7 +245,7 @@ android-harness doctor --repo /path/to/android-project --json
|
|
|
244
245
|
Or run directly from a pinned source clone without global installation:
|
|
245
246
|
|
|
246
247
|
```bash
|
|
247
|
-
git clone --depth 1 --branch v1.2.
|
|
248
|
+
git clone --depth 1 --branch v1.2.5 --single-branch \
|
|
248
249
|
https://github.com/rabee-elkholy/android-agent-harness.git ~/.android-harness/kit
|
|
249
250
|
|
|
250
251
|
python ~/.android-harness/kit/harness_cli.py init \
|
|
@@ -407,8 +408,13 @@ The harness rehydrates and matches repo-local context; the chat provider itself
|
|
|
407
408
|
|
|
408
409
|
---
|
|
409
410
|
|
|
410
|
-
## Android
|
|
411
|
+
## Android & KMM / KMP (Kotlin Multiplatform) protection
|
|
411
412
|
|
|
413
|
+
- **KMM / KMP Multiplatform & Source-Set Purity (`commonMain` / `androidMain` / `iosMain`)**:
|
|
414
|
+
- **Source-set isolation**: Blocks accidental platform leaks (`android.*`, `java.io.*`, or JVM-only APIs inside `commonMain`) during preflight and specialist reviews.
|
|
415
|
+
- **Cross-platform symbol graph (`Kotlin` + `Swift`)**: Indexes `.kt`, `.java`, `.xml`, and iOS `.swift` declarations and call sites in `task-context` and `graph` so shared KMM domain/data changes automatically surface both Android (`androidMain` / `composeApp`) and iOS (`iosMain` / `iosApp`) usages.
|
|
416
|
+
- **`expect` / `actual` contract verification**: Tracks multiplatform boundary declarations across `commonMain`, `androidMain`, and `iosMain` to prevent broken platform implementations.
|
|
417
|
+
- **KMM / Compose Multiplatform APK & module awareness**: Automatically discovers and validates standard Android (`:app` -> `app-debug.apk`) and KMM / Compose Multiplatform (`:composeApp` -> `composeApp-debug.apk`, `:androidApp` -> `androidApp-debug.apk`, `:shared`) topologies.
|
|
412
418
|
- **Room database & schemas**: Source-based checks for version changes, numeric migration paths, Kotlin/Java embedded types, risky schema changes, and unconditional destructive fallback. These heuristics do not replace Room schema export validation or migration tests.
|
|
413
419
|
- **Compose, XML & resources**: String parity across locales (`values/`, `values-ar/`, etc.), plural/placeholder validation, ViewBinding lifecycle leak checks, and Compose UI state handling.
|
|
414
420
|
- **Coroutines, ANR & threading**: Pattern-based checks for selected blocking calls, coroutine scope risks, and exception-handling patterns. Static checks cannot establish freedom from ANRs or concurrency bugs.
|
|
@@ -476,18 +482,14 @@ The harness dynamically discovers and inspects external Project Management MCP s
|
|
|
476
482
|
|
|
477
483
|
## Supported hosts / enforcement model
|
|
478
484
|
|
|
485
|
+
Android Agent Harness is dedicated to **Google Antigravity** as its native target runtime:
|
|
486
|
+
|
|
479
487
|
| Host | Adapter | Mutation Interception | Review proof | Downstream verifier |
|
|
480
488
|
|---|---|---|---|---|
|
|
481
|
-
| **Google Antigravity** | `agents/hooks.json`, custom
|
|
482
|
-
|
|
|
483
|
-
| **Codex** | Root `AGENTS.md`, `.codex/` instructions | Rule/sandbox dependent | V1 response ingestion; independence not natively verified | Yes |
|
|
484
|
-
| **Cursor** | `.cursorrules` / `.cursor/rules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
485
|
-
| **Windsurf** | `.windsurfrules` | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
486
|
-
| **GitHub Copilot** | `.github/copilot-instructions.md`, installed pre-tool hook adapter | Hook-backed where supported and detected; otherwise rule-enforced | V1 response ingestion | Yes |
|
|
487
|
-
| **Gemini CLI** | Rules, instructions | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
488
|
-
| **Roo Code / Continue** | Mode instructions, system rules | `RULE_ENFORCED` | V1 response ingestion | Yes |
|
|
489
|
+
| **Google Antigravity** (Primary & Dedicated Target) | `GEMINI.md`, `AGENTS.md`, `.agents/hooks.json`, custom reviewer subagents (`.agents/agents/`), rules, skills | Native hooks (`HARD_ENFORCED`) | Trusted transcript Review V2 (`HARNESS_REVIEW_RESULT_V2`) | Yes |
|
|
490
|
+
| Legacy / External `AGENTS.md` Readers | Optional compatibility templates (`CLAUDE.md`, `CODEX.md`, `.cursor/rules`) | Rule-enforced (`RULE_ENFORCED`) unless host hook is active | V1 response ingestion | Yes |
|
|
489
491
|
|
|
490
|
-
|
|
492
|
+
On **Google Antigravity**, installed native hooks (`hooks.json`) intercept supported file mutations (`write_to_file`, `replace_file_content`, `multi_replace_file_content`) and subagent boundaries (`invoke_subagent`). The harness always reports the detected enforcement tier (`HARD_ENFORCED` vs `RULE_ENFORCED`) honestly.
|
|
491
493
|
|
|
492
494
|
See [docs/tool-support.md](https://github.com/rabee-elkholy/android-agent-harness/blob/main/docs/tool-support.md) for full integration details.
|
|
493
495
|
|
|
@@ -586,8 +588,8 @@ No. Android Studio remains the primary IDE for Android development, debugging, a
|
|
|
586
588
|
**2. Does this make the AI autonomous?**
|
|
587
589
|
No. The harness is approval-first. All task scopes and risk classifications require explicit developer approval before modifications begin, and delivery requires verified evidence.
|
|
588
590
|
|
|
589
|
-
**3. Can it work with mixed Java/Kotlin/XML/Compose codebases?**
|
|
590
|
-
Yes. It derives local architectural evidence per module and source set and
|
|
591
|
+
**3. Can it work with KMM / KMP (Kotlin Multiplatform Mobile) and mixed Java/Kotlin/XML/Compose/Swift codebases?**
|
|
592
|
+
Yes. It natively supports both standard Android apps and KMM / KMP projects (`commonMain`, `androidMain`, `iosMain`, `:shared`, `:composeApp`, `:androidApp`, and iOS `.swift` files). It derives local architectural evidence per module and source set, checks `commonMain` platform purity, and verifies changes against the approved architecture.
|
|
591
593
|
|
|
592
594
|
**4. Does every task run many reviewers?**
|
|
593
595
|
No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) and low-risk changes (T1) skip reviewer subagents entirely. Specialized reviewers run only when justified by the final classified blast radius.
|
|
@@ -595,8 +597,8 @@ No. The 6-tier risk model dynamically assigns verification: trivial edits (T0) a
|
|
|
595
597
|
**5. Does every task require a device?**
|
|
596
598
|
No. Device deployment and mobile verification are required only for tiers and changes involving device-facing surfaces (such as T4/T5 with Room, permissions, or system services) or when explicitly requested.
|
|
597
599
|
|
|
598
|
-
**6.
|
|
599
|
-
|
|
600
|
+
**6. Why is the harness focused on Google Antigravity?**
|
|
601
|
+
Specializing in Google Antigravity enables deep native integration: `HARD_ENFORCED` pre-tool and post-tool hooks (`hooks.json`), parallel subagent orchestration (`invoke_subagent`) with native SQLite execution proof (`HARNESS_REVIEW_RESULT_V2`), interactive `ask_question` decision cards, and Android Studio / Device Hub / Compose Preview diagnostics (`android-ui`, `android-inspect`). Legacy adapter templates remain in the kit for backward compatibility during updates.
|
|
600
602
|
|
|
601
603
|
**7. Does the harness commit/push code?**
|
|
602
604
|
Installed client-project workflows leave Git mutations to the developer and normally leave edits unstaged. Maintenance of this harness repository may use Git or publish only when its maintainer explicitly authorizes those actions.
|
|
@@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "android-agent-harness"
|
|
7
|
-
version = "1.2.
|
|
8
|
-
description = "Approval-first, evidence-bound
|
|
7
|
+
version = "1.2.5"
|
|
8
|
+
description = "Approval-first, evidence-bound engineering harness for Android and KMM/KMP (Kotlin Multiplatform Mobile) projects on Google Antigravity."
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
requires-python = ">=3.10"
|
|
11
11
|
license = "MIT"
|
|
12
12
|
license-files = ["LICENSE"]
|
|
13
13
|
authors = [{ name = "Rabee Elkholy" }]
|
|
14
|
-
keywords = ["android", "kmp", "ai-agents", "code-review", "governance", "mcp"]
|
|
14
|
+
keywords = ["android", "kmm", "kmp", "kotlin-multiplatform", "antigravity", "ai-agents", "code-review", "governance", "mcp"]
|
|
15
15
|
classifiers = [
|
|
16
16
|
"Development Status :: 5 - Production/Stable",
|
|
17
17
|
"Environment :: Console",
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
1.2.4
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{android_agent_harness-1.2.4 → android_agent_harness-1.2.5}/agents/command-packs/debug.md.template
RENAMED
|
File without changes
|