android-agent-harness 1.2.3__tar.gz → 1.2.4__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.3 → android_agent_harness-1.2.4}/PKG-INFO +50 -3
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/README.md +49 -2
- android_agent_harness-1.2.4/agents/VERSION +1 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/harness.py +32 -2
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/release_checksums.json +9 -9
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_pm_selftest.py +47 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_workflow/engine.py +38 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_workflow/router.py +1 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/doctor/engine.py +1 -74
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/incident_reporter.py +146 -7
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/mutation_guard.py +2 -1
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/GEMINI.md.template +1 -1
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/android_agent_harness.egg-info/PKG-INFO +50 -3
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/pyproject.toml +1 -1
- android_agent_harness-1.2.3/agents/VERSION +0 -1
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/LICENSE +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/.gitignore +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/check-strings.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/commit-msg.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/crash-triage.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/debug.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/deliver.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/doctor.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/new-feature.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/perf-audit.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/preflight.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/test-quality-audit.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/command-packs/zoho-sprints.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/harness_shared/__init__.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/harness_shared/commands.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/harness_shared/integrity.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/harness_shared/paths.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/harness_shared/processes.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/hooks.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/mcp_config.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/pm/mcp_registration.jira.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/pm/mcp_registration.linear.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/rules/compose-context.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/rules/gradle-context.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/rules/harness-rules.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/rules/kmp-context.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_adb_core.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_adb_core_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_android_inspect_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_android_scenarios_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_android_ui_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_antigravity_stability_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_architecture_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_baseline_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_change_decision_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_critical_safety_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_daily_workflow_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_delivery_equivalence_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_efficiency_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_enforcement.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_env_codes.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_env_codes_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_environment.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_external_write_policy_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_gate_results.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_graph_core.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_graph_discovery_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_graph_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_hook_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_host_continuation_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_idempotency.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_installer_config.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_live_process.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_modules.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_performance_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_phase_review_v2_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_portability_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_product.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_project_architecture.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_project_intelligence_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_public_cli_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_public_commands.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_release_safety_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_repo_files.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_review_models_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_security_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_source_outline.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_source_text.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_stabilization_v41_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_stabilization_v42_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_task_isolation_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_variants.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_verification_recipes.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_verification_value_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_vnext_common.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_vnext_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_workflow/__init__.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_workflow/phase_routing.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_workflow/planning.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_workflow/verification.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_workflow_insight_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_worktree_handoff_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/android_inspect.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/android_ui.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/antigravity_contract.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/antigravity_runtime.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/antigravity_tools.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/architecture_drift.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/architecture_policy.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/architecture_resolver.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/artifact_set.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/baseline_capture.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/build_execution.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/capture_screen.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/cc_pre_tool_safety.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/change_classifier.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/change_decision.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/check_kit_update.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/check_strings.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/context_presentation.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/copilot_pre_tool_safety.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/delivery_equivalence.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/delivery_manifest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/discovery_receipt.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/discovery_router.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/doctor/__init__.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/doctor/models.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/ensure_hook_selftest.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/evidence_store.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/exported_component_guard.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/fast_kt_lint.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/final_verdict.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/final_verifier.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/generate_project_context.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/gradle_error_parser.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/harness_doctor.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/host_continuation.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/install_or_update.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/install_tool_adapters.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/integrations/__init__.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/integrations/base.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/integrations/external_write_policy.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/integrations/generic_mcp.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/integrations/registry.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/integrations/universal_pm.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/integrations/zoho_sprints/__init__.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/integrations/zoho_sprints/integration.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/integrations/zoho_sprints/policy.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/journey_runner.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/lifecycle.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/logcat_doctor.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/new_feature_scaffold.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/perf_guard.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/phase_review.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/phone_e2e.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/plan_authority.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/plan_document.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/plan_notes.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/pm_discovery.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/pm_github.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/pm_policy.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/policy_vocab.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/post_tool_reconcile.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/pre_invocation_reminder.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/pre_tool_safety.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/preflight.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/preflight_check.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/project_context.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/project_graph.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/record_review.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/repair.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/review_budget.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/review_execution.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/review_fix_delta.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/review_models.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/review_orchestrator.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/review_package.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/review_policy.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/review_reasoning.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/review_sources.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/reviewer_host.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/room_guard.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/run_device.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/run_gradle_task.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/run_tests_gate.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/self_heal.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/setup_wizard.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/skill_router.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/task_base.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/task_context.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/task_git_lineage.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/task_merge.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/task_metrics.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/verification_contract.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/verification_steps.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/wizard/__init__.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/wizard/discovery.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/wizard/i18n.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/wizard/questions.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/wizard/schema.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/workflow.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/zoho_grant.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/zoho_sync.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/settings.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-harness/SKILL.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-harness/references/architecture-guidelines.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-harness/references/automated-skills.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-harness/references/command-contract.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-harness/references/daily-scenarios.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-harness/references/database-and-persistence.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-harness/references/performance-and-optimization.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-harness/references/test-quality-guidelines.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-harness/references/ui-layout-and-theming.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/android-security-billing/SKILL.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/brainstorming/SKILL.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/compose-inspector/SKILL.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/git-pr-automator/SKILL.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/gradle-build-optimizer/SKILL.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/kotlin-coroutines-expert/SKILL.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/systematic-debugging/SKILL.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/skills/test-driven-development/SKILL.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/subagents/android-ui-expert-agent.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/subagents/arch-regression-reviewer-agent.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/subagents/bug-test-reviewer-agent.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/subagents/qa-diagnostics-agent.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/subagents/re-review-prompt.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/subagents/review-prompt.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/subagents/security-perf-reviewer-agent.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/subagents/spec-compliance-agent.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/AGENTS.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/CLAUDE.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/CODEX.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/QWEN.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/README.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/continue-android-harness.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/copilot-instructions.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/cursor-android-harness.mdc.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/gemini-runtime/android-harness-global.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/gemini-runtime/config.grants.example.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/gemini-runtime/mcp_config.template.json +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/github-instructions.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/pointer.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/tool-adapters/windsurf-android-harness.md.template +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/android-inspection.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/android-ui.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/check-strings.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/commit-msg.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/crash-triage.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/debug.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/deliver.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/efficient-context.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/new-feature.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/perf-audit.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/phone-e2e.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/preflight.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/test-quality-audit.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/workflows/zoho-sprints.md +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/android_agent_harness.egg-info/SOURCES.txt +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/android_agent_harness.egg-info/dependency_links.txt +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/android_agent_harness.egg-info/entry_points.txt +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/android_agent_harness.egg-info/top_level.txt +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/harness_cli.py +0 -0
- {android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/setup.cfg +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: android-agent-harness
|
|
3
|
-
Version: 1.2.
|
|
3
|
+
Version: 1.2.4
|
|
4
4
|
Summary: Approval-first, evidence-bound development harness for supported Gradle Android projects.
|
|
5
5
|
Author: Rabee Elkholy
|
|
6
6
|
License-Expression: MIT
|
|
@@ -47,6 +47,35 @@ The model focuses on engineering. The harness handles workflow state, proof, and
|
|
|
47
47
|
|
|
48
48
|
---
|
|
49
49
|
|
|
50
|
+
## Navigation
|
|
51
|
+
|
|
52
|
+
- [Key Architectural Pillars](#key-architectural-pillars)
|
|
53
|
+
- [Why It Exists & Failure Modes Checked](#why-it-exists)
|
|
54
|
+
- [Daily Developer Experience & Multi-Phase Flow](#what-daily-use-looks-like)
|
|
55
|
+
- [Quick Start (Chat & Terminal)](#quick-start)
|
|
56
|
+
- [6-Tier Dynamic Risk Model](#6-tier-risk-model)
|
|
57
|
+
- [Persistent Project Knowledge & Truth Hierarchy](#persistent-project-knowledge)
|
|
58
|
+
- [Antigravity-First Architecture & Review Protocol V2](#antigravity-first-architecture--review-protocol-v2)
|
|
59
|
+
- [Universal Multi-Provider PM MCP & Resilient Self-Healing](#universal-pm-mcp--resilient-self-healing)
|
|
60
|
+
- [Supported AI Hosts & Enforcement Matrix](#supported-hosts--enforcement-model)
|
|
61
|
+
- [Documentation Map & FAQ](#faq)
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## Key Architectural Pillars
|
|
66
|
+
|
|
67
|
+
| Pillar | What It Solves | How the Harness Enforces It |
|
|
68
|
+
|---|---|---|
|
|
69
|
+
| **Graph-Backed AST & Symbol Discovery** | Blind grep loops and token-heavy full-file reads across large multi-module repos | Single-pass symbol/dependency graph (`task-context` & `graph`) across Kotlin (`.kt`), Java (`.java`), Android XML (`.xml`), and KMP/iOS Swift (`.swift`), plus codebase reuse candidate detection (`reuse_candidates`). |
|
|
70
|
+
| **Single-Approval Lifecycle & Scope Guard** | Silent scope creep, unapproved refactors, and mid-task confirmation fatigue | One initial plan approval (`plan_sha256` + single-use nonce) covers all phases. Native `PreToolUse` hooks (`hooks.json`) block unapproved file writes while automatically extending in-scope task files at phase/verification checkpoints. |
|
|
71
|
+
| **6-Tier Dynamic Risk & Epistemic Review V2** | Over-reviewing trivial edits or under-reviewing critical Auth/Billing/Room changes | Classifies the final diff from `T0_TRIVIAL` (0 reviewers, instant delivery for docs/prose) to `T5_CRITICAL`, dispatching 3 consolidated domain specialists (`bug-test-reviewer-agent`, `arch-regression-reviewer-agent`, `security-perf-reviewer-agent`) under Goldfish epistemic isolation (`HARNESS_REVIEW_RESULT_V2`). |
|
|
72
|
+
| **Android & KMP Domain Gates** | Room migration crashes, missing locale strings, UI-to-DAO layer bypass, and KMP leaks | Deterministic preflight checks for Room schema migrations, localized string/plural parity (`values-*`), `UI_TO_DATA_SOURCE_BYPASS`, KMP `commonMain` purity (`android.*` / JVM leak blocking), and exported component permission guards. |
|
|
73
|
+
| **Cryptographic Evidence & Physical Device Proof** | Claiming "tests pass" from stale runs or shipping broken UI without device checks | Every test run, review verdict, APK artifact hash, `device install-start` foreground observation, and live `e2e` phone session is bound to `delivery_snapshot_sha256` and `change_set_sha256`. Any post-verification edit invalidates stale proof. |
|
|
74
|
+
| **Self-Healing State & Consent-First Zero-PII Telemetry** | Wedged task state after developer Android Studio edits or unexpected crashes | Automatic stable checkpoint snapshots (`task heal`), preview-bound incremental scope decisions (`task change-decision`), and organized local Zero-PII incident reports (`.agents/state/incidents/<id>.md`) with consent-first `ask_question` GitHub reporting. |
|
|
75
|
+
| **Universal Zero-Config PM MCP Integration** | Accidental ticket closures, overwritten Bug descriptions, or leaked code identifiers in QA reports | Auto-discovers installed PM MCPs (Zoho Projects, Zoho Sprints, Jira, Linear, Monday.com, GitHub, ClickUp, Asana, Trello), enforces mandatory preview-and-approval (`pm authorize`), protects original Bug descriptions, blocks automatic `Done`/`Closed` transitions, and generates 5-section RTL/LTR functional QA reports. |
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
50
79
|
## Why it exists
|
|
51
80
|
|
|
52
81
|
AI coding agents are good at writing code, but production Android work has a second problem: keeping the agent aligned over time.
|
|
@@ -192,7 +221,7 @@ Task A
|
|
|
192
221
|
Open your Android project in your AI coding agent (Claude Code, Codex, Gemini CLI / Antigravity, Cursor, Windsurf, Roo Code, or Copilot) and provide this bootstrap prompt:
|
|
193
222
|
|
|
194
223
|
```text
|
|
195
|
-
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.
|
|
224
|
+
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.4/docs/install-or-update-prompt.md and follow all instructions.
|
|
196
225
|
```
|
|
197
226
|
|
|
198
227
|
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 +244,7 @@ android-harness doctor --repo /path/to/android-project --json
|
|
|
215
244
|
Or run directly from a pinned source clone without global installation:
|
|
216
245
|
|
|
217
246
|
```bash
|
|
218
|
-
git clone --depth 1 --branch v1.2.
|
|
247
|
+
git clone --depth 1 --branch v1.2.4 --single-branch \
|
|
219
248
|
https://github.com/rabee-elkholy/android-agent-harness.git ~/.android-harness/kit
|
|
220
249
|
|
|
221
250
|
python ~/.android-harness/kit/harness_cli.py init \
|
|
@@ -427,6 +456,24 @@ For design, migration, compatibility and security decisions the agent asks the d
|
|
|
427
456
|
|
|
428
457
|
---
|
|
429
458
|
|
|
459
|
+
## Universal PM MCP & Resilient Self-Healing
|
|
460
|
+
|
|
461
|
+
### 1. Universal Zero-Config Multi-Provider PM MCP Engine
|
|
462
|
+
The harness dynamically discovers and inspects external Project Management MCP servers installed in the AI host (`zoho-projects_mcp`, `zoho-sprints`, `atlassian-mcp-server` / Jira, Linear, Monday.com, GitHub Projects, ClickUp, Asana, and Trello) without bundling vendor credentials inside the repository:
|
|
463
|
+
- **Mandatory Preview & Approval (`PM_PREVIEW_AND_APPROVAL_REQUIRED`)**: Before any tracker mutation, the agent presents the exact target item ID, status change, and comment/description payload to the developer and records explicit authorization (`python .agents/harness.py pm authorize --proof-reference "<developer approval>"`).
|
|
464
|
+
- **Non-Destructive Tracker Guardrails**: Original Bug/Issue descriptions are strictly protected from being overwritten or cleared (QA reports are posted as comments on Bugs and updated in descriptions on Tasks/Stories). Terminal states (`Done`, `Closed`, `Solved`) and opaque transition IDs are blocked unless the developer explicitly grants `--allow-close`.
|
|
465
|
+
- **5-Section RTL/LTR Functional QA Reports**: `python .agents/harness.py pm prepare-report` generates structured HTML/Markdown QA handoff reports in the project's configured tracker language without leaking internal source filenames, class names, or stack traces.
|
|
466
|
+
|
|
467
|
+
### 2. Self-Healing Task State & Last-Known-Good Snapshot Rollback
|
|
468
|
+
- **Automatic Checkpoint Snapshots**: At every stable lifecycle boundary (`APPROVED`, `IMPLEMENTING`, `checkpoint-phase`, `VERIFYING`, `READY_FOR_DELIVERY`), the harness persists a cryptographically verified snapshot under `.agents/state/tasks/<id>/snapshots/` bound to the task identity, plan hash, and execution nonce.
|
|
469
|
+
- **One-Command State Recovery (`task heal`)**: If `current-run.json` becomes stale or a developer modifies verified files before committing, `python .agents/harness.py task heal --task-id <id> --prepare-fresh-run` steps internal state back to the nearest valid checkpoint while preserving application source code, Git history, completed phases, and passed reviewer accounting.
|
|
470
|
+
|
|
471
|
+
### 3. Organized Local Zero-PII Incident Reports & Consent-First Submission
|
|
472
|
+
- **Local Zero-PII Diagnostics**: Unhandled harness exceptions or self-healing events are captured locally in `.agents/state/incidents/<incident_id>.json` and a human-readable `.agents/state/incidents/<incident_id>.md` report with strict Zero-PII redaction (scrubbing emails, phone numbers, IPv4 addresses, local paths, and tokens).
|
|
473
|
+
- **Developer Consent via `ask_question`**: Public reporting never runs silently by default. On an unexpected incident, the harness instructs the agent to ask the developer via `ask_question` whether to submit the allowlisted anonymous metadata once (`python .agents/harness.py report-issue --submit --incident-id <id>`), enable always-auto-submit (`--submit --always-auto-submit`), or keep the report local only.
|
|
474
|
+
|
|
475
|
+
---
|
|
476
|
+
|
|
430
477
|
## Supported hosts / enforcement model
|
|
431
478
|
|
|
432
479
|
| Host | Adapter | Mutation Interception | Review proof | Downstream verifier |
|
|
@@ -18,6 +18,35 @@ The model focuses on engineering. The harness handles workflow state, proof, and
|
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
21
|
+
## Navigation
|
|
22
|
+
|
|
23
|
+
- [Key Architectural Pillars](#key-architectural-pillars)
|
|
24
|
+
- [Why It Exists & Failure Modes Checked](#why-it-exists)
|
|
25
|
+
- [Daily Developer Experience & Multi-Phase Flow](#what-daily-use-looks-like)
|
|
26
|
+
- [Quick Start (Chat & Terminal)](#quick-start)
|
|
27
|
+
- [6-Tier Dynamic Risk Model](#6-tier-risk-model)
|
|
28
|
+
- [Persistent Project Knowledge & Truth Hierarchy](#persistent-project-knowledge)
|
|
29
|
+
- [Antigravity-First Architecture & Review Protocol V2](#antigravity-first-architecture--review-protocol-v2)
|
|
30
|
+
- [Universal Multi-Provider PM MCP & Resilient Self-Healing](#universal-pm-mcp--resilient-self-healing)
|
|
31
|
+
- [Supported AI Hosts & Enforcement Matrix](#supported-hosts--enforcement-model)
|
|
32
|
+
- [Documentation Map & FAQ](#faq)
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Key Architectural Pillars
|
|
37
|
+
|
|
38
|
+
| Pillar | What It Solves | How the Harness Enforces It |
|
|
39
|
+
|---|---|---|
|
|
40
|
+
| **Graph-Backed AST & Symbol Discovery** | Blind grep loops and token-heavy full-file reads across large multi-module repos | Single-pass symbol/dependency graph (`task-context` & `graph`) across Kotlin (`.kt`), Java (`.java`), Android XML (`.xml`), and KMP/iOS Swift (`.swift`), plus codebase reuse candidate detection (`reuse_candidates`). |
|
|
41
|
+
| **Single-Approval Lifecycle & Scope Guard** | Silent scope creep, unapproved refactors, and mid-task confirmation fatigue | One initial plan approval (`plan_sha256` + single-use nonce) covers all phases. Native `PreToolUse` hooks (`hooks.json`) block unapproved file writes while automatically extending in-scope task files at phase/verification checkpoints. |
|
|
42
|
+
| **6-Tier Dynamic Risk & Epistemic Review V2** | Over-reviewing trivial edits or under-reviewing critical Auth/Billing/Room changes | Classifies the final diff from `T0_TRIVIAL` (0 reviewers, instant delivery for docs/prose) to `T5_CRITICAL`, dispatching 3 consolidated domain specialists (`bug-test-reviewer-agent`, `arch-regression-reviewer-agent`, `security-perf-reviewer-agent`) under Goldfish epistemic isolation (`HARNESS_REVIEW_RESULT_V2`). |
|
|
43
|
+
| **Android & KMP Domain Gates** | Room migration crashes, missing locale strings, UI-to-DAO layer bypass, and KMP leaks | Deterministic preflight checks for Room schema migrations, localized string/plural parity (`values-*`), `UI_TO_DATA_SOURCE_BYPASS`, KMP `commonMain` purity (`android.*` / JVM leak blocking), and exported component permission guards. |
|
|
44
|
+
| **Cryptographic Evidence & Physical Device Proof** | Claiming "tests pass" from stale runs or shipping broken UI without device checks | Every test run, review verdict, APK artifact hash, `device install-start` foreground observation, and live `e2e` phone session is bound to `delivery_snapshot_sha256` and `change_set_sha256`. Any post-verification edit invalidates stale proof. |
|
|
45
|
+
| **Self-Healing State & Consent-First Zero-PII Telemetry** | Wedged task state after developer Android Studio edits or unexpected crashes | Automatic stable checkpoint snapshots (`task heal`), preview-bound incremental scope decisions (`task change-decision`), and organized local Zero-PII incident reports (`.agents/state/incidents/<id>.md`) with consent-first `ask_question` GitHub reporting. |
|
|
46
|
+
| **Universal Zero-Config PM MCP Integration** | Accidental ticket closures, overwritten Bug descriptions, or leaked code identifiers in QA reports | Auto-discovers installed PM MCPs (Zoho Projects, Zoho Sprints, Jira, Linear, Monday.com, GitHub, ClickUp, Asana, Trello), enforces mandatory preview-and-approval (`pm authorize`), protects original Bug descriptions, blocks automatic `Done`/`Closed` transitions, and generates 5-section RTL/LTR functional QA reports. |
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
21
50
|
## Why it exists
|
|
22
51
|
|
|
23
52
|
AI coding agents are good at writing code, but production Android work has a second problem: keeping the agent aligned over time.
|
|
@@ -163,7 +192,7 @@ Task A
|
|
|
163
192
|
Open your Android project in your AI coding agent (Claude Code, Codex, Gemini CLI / Antigravity, Cursor, Windsurf, Roo Code, or Copilot) and provide this bootstrap prompt:
|
|
164
193
|
|
|
165
194
|
```text
|
|
166
|
-
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.
|
|
195
|
+
Read https://raw.githubusercontent.com/rabee-elkholy/android-agent-harness/v1.2.4/docs/install-or-update-prompt.md and follow all instructions.
|
|
167
196
|
```
|
|
168
197
|
|
|
169
198
|
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/`.
|
|
@@ -186,7 +215,7 @@ android-harness doctor --repo /path/to/android-project --json
|
|
|
186
215
|
Or run directly from a pinned source clone without global installation:
|
|
187
216
|
|
|
188
217
|
```bash
|
|
189
|
-
git clone --depth 1 --branch v1.2.
|
|
218
|
+
git clone --depth 1 --branch v1.2.4 --single-branch \
|
|
190
219
|
https://github.com/rabee-elkholy/android-agent-harness.git ~/.android-harness/kit
|
|
191
220
|
|
|
192
221
|
python ~/.android-harness/kit/harness_cli.py init \
|
|
@@ -398,6 +427,24 @@ For design, migration, compatibility and security decisions the agent asks the d
|
|
|
398
427
|
|
|
399
428
|
---
|
|
400
429
|
|
|
430
|
+
## Universal PM MCP & Resilient Self-Healing
|
|
431
|
+
|
|
432
|
+
### 1. Universal Zero-Config Multi-Provider PM MCP Engine
|
|
433
|
+
The harness dynamically discovers and inspects external Project Management MCP servers installed in the AI host (`zoho-projects_mcp`, `zoho-sprints`, `atlassian-mcp-server` / Jira, Linear, Monday.com, GitHub Projects, ClickUp, Asana, and Trello) without bundling vendor credentials inside the repository:
|
|
434
|
+
- **Mandatory Preview & Approval (`PM_PREVIEW_AND_APPROVAL_REQUIRED`)**: Before any tracker mutation, the agent presents the exact target item ID, status change, and comment/description payload to the developer and records explicit authorization (`python .agents/harness.py pm authorize --proof-reference "<developer approval>"`).
|
|
435
|
+
- **Non-Destructive Tracker Guardrails**: Original Bug/Issue descriptions are strictly protected from being overwritten or cleared (QA reports are posted as comments on Bugs and updated in descriptions on Tasks/Stories). Terminal states (`Done`, `Closed`, `Solved`) and opaque transition IDs are blocked unless the developer explicitly grants `--allow-close`.
|
|
436
|
+
- **5-Section RTL/LTR Functional QA Reports**: `python .agents/harness.py pm prepare-report` generates structured HTML/Markdown QA handoff reports in the project's configured tracker language without leaking internal source filenames, class names, or stack traces.
|
|
437
|
+
|
|
438
|
+
### 2. Self-Healing Task State & Last-Known-Good Snapshot Rollback
|
|
439
|
+
- **Automatic Checkpoint Snapshots**: At every stable lifecycle boundary (`APPROVED`, `IMPLEMENTING`, `checkpoint-phase`, `VERIFYING`, `READY_FOR_DELIVERY`), the harness persists a cryptographically verified snapshot under `.agents/state/tasks/<id>/snapshots/` bound to the task identity, plan hash, and execution nonce.
|
|
440
|
+
- **One-Command State Recovery (`task heal`)**: If `current-run.json` becomes stale or a developer modifies verified files before committing, `python .agents/harness.py task heal --task-id <id> --prepare-fresh-run` steps internal state back to the nearest valid checkpoint while preserving application source code, Git history, completed phases, and passed reviewer accounting.
|
|
441
|
+
|
|
442
|
+
### 3. Organized Local Zero-PII Incident Reports & Consent-First Submission
|
|
443
|
+
- **Local Zero-PII Diagnostics**: Unhandled harness exceptions or self-healing events are captured locally in `.agents/state/incidents/<incident_id>.json` and a human-readable `.agents/state/incidents/<incident_id>.md` report with strict Zero-PII redaction (scrubbing emails, phone numbers, IPv4 addresses, local paths, and tokens).
|
|
444
|
+
- **Developer Consent via `ask_question`**: Public reporting never runs silently by default. On an unexpected incident, the harness instructs the agent to ask the developer via `ask_question` whether to submit the allowlisted anonymous metadata once (`python .agents/harness.py report-issue --submit --incident-id <id>`), enable always-auto-submit (`--submit --always-auto-submit`), or keep the report local only.
|
|
445
|
+
|
|
446
|
+
---
|
|
447
|
+
|
|
401
448
|
## Supported hosts / enforcement model
|
|
402
449
|
|
|
403
450
|
| Host | Adapter | Mutation Interception | Review proof | Downstream verifier |
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
1.2.4
|
|
@@ -34,7 +34,7 @@ def _run(script: str, args: list[str]) -> int:
|
|
|
34
34
|
read_only = read_only or (script == "run_device.py" and args == ["status"])
|
|
35
35
|
read_only = read_only or (script == "workflow.py" and args[:1] in (["status"], ["coverage"], ["metrics"], ["continue"]))
|
|
36
36
|
read_only = read_only or (script == "pm_discovery.py" and args[:1] in (["discover"], ["status"]))
|
|
37
|
-
read_only = read_only or
|
|
37
|
+
read_only = read_only or script == "incident_reporter.py"
|
|
38
38
|
# Merge checks the execution sessions of every source before applying; preview is read-only.
|
|
39
39
|
read_only = read_only or (script == "workflow.py" and args[:1] == ["merge"])
|
|
40
40
|
# The bounded verification runner owns its execution lease, including when
|
|
@@ -153,7 +153,37 @@ def main(argv: list[str] | None = None) -> int:
|
|
|
153
153
|
monotonic = time.monotonic()
|
|
154
154
|
from task_metrics import metric_task_id
|
|
155
155
|
metric_owner = metric_task_id(REPO_ROOT, args)
|
|
156
|
-
|
|
156
|
+
try:
|
|
157
|
+
code = _main(args)
|
|
158
|
+
except Exception as exc:
|
|
159
|
+
import traceback
|
|
160
|
+
tb_text = traceback.format_exc()
|
|
161
|
+
try:
|
|
162
|
+
from incident_reporter import record_incident
|
|
163
|
+
inc = record_incident(
|
|
164
|
+
REPO_ROOT,
|
|
165
|
+
code="UNEXPECTED_EXCEPTION",
|
|
166
|
+
command=f"harness.py {' '.join(args[:2])}".strip(),
|
|
167
|
+
message=f"{type(exc).__name__}: {exc}",
|
|
168
|
+
task_id=metric_owner or "",
|
|
169
|
+
traceback_text=tb_text,
|
|
170
|
+
)
|
|
171
|
+
inc_id = inc.get("incident_id", "")
|
|
172
|
+
guidance = inc.get("ask_question_guidance") or {}
|
|
173
|
+
sub = inc.get("submission") or {}
|
|
174
|
+
print(f"[FAIL] Unexpected harness exception ({type(exc).__name__}: {exc})", file=sys.stderr)
|
|
175
|
+
print(f"INCIDENT_RECORDED={inc_id}", file=sys.stderr)
|
|
176
|
+
print(f"INCIDENT_LOCAL_REPORT=.agents/state/incidents/{inc_id}.md", file=sys.stderr)
|
|
177
|
+
if sub.get("status") in {"REPORTED", "DEDUPLICATED_EXISTING_ISSUE"}:
|
|
178
|
+
print(f"INCIDENT_AUTO_SUBMITTED={sub.get('issue_url', '')}", file=sys.stderr)
|
|
179
|
+
elif guidance:
|
|
180
|
+
print("TOOL_CALL_REQUIRED=ask_question", file=sys.stderr)
|
|
181
|
+
print(f"INCIDENT_SUBMIT_ONCE={guidance.get('submit_once_command', '')}", file=sys.stderr)
|
|
182
|
+
print(f"INCIDENT_SUBMIT_ALWAYS={guidance.get('submit_always_command', '')}", file=sys.stderr)
|
|
183
|
+
print(f"NEXT_INSTRUCTIONS={guidance.get('instructions', '')}", file=sys.stderr)
|
|
184
|
+
except Exception:
|
|
185
|
+
print(tb_text, file=sys.stderr)
|
|
186
|
+
return 1
|
|
157
187
|
# Explicit opt-in: feature-off does not read tasks or scan metrics history.
|
|
158
188
|
if os.environ.get("HARNESS_LOCAL_METRICS") == "1" and args and args[0] in {"task", "task-context", "verify-steps", "phase-review", "preflight", "test", "assemble", "compile", "device", "review", "journey"}:
|
|
159
189
|
try:
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"algorithm": "sha256",
|
|
3
3
|
"files": {
|
|
4
4
|
"agents/.gitignore": "8a0eaa7cc8e55d17da96f31f6863b5e9b5aba15bb03fd6e8fb07a8cb89e5715c",
|
|
5
|
-
"agents/VERSION": "
|
|
5
|
+
"agents/VERSION": "563a0b4eec3c77bbc34ac630d4fa5214f5c6726ae01468404fd704473110084e",
|
|
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",
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
"agents/command-packs/preflight.md.template": "fc672c964115ddf16dfa10c12afa43c260981432c4ea4e567dbda5b0d8cde9b2",
|
|
15
15
|
"agents/command-packs/test-quality-audit.md.template": "7064992a4b8f76aa7614097637f14d3539f973fd7051191e186c3ccc5f1b2358",
|
|
16
16
|
"agents/command-packs/zoho-sprints.md.template": "6b4ad205415759f742d28722ccb017536d3ecac774132fcf21ab8e172fa3a1d0",
|
|
17
|
-
"agents/harness.py": "
|
|
17
|
+
"agents/harness.py": "4b3e0248fbe8c615e30bd6baf33b3789a21f56a99e13328a1f4f667cd622e808",
|
|
18
18
|
"agents/harness_shared/__init__.py": "123d7a509cad95f35619ff1849fcfc990205aca7e77fcdc2460a27acb029118c",
|
|
19
19
|
"agents/harness_shared/commands.py": "90bde306439b299607e8aee512a374c04c30b58d8cfa155363263667a19e30bd",
|
|
20
20
|
"agents/harness_shared/integrity.py": "ab1a9a6edede1545a4ba8ece5175659f4cecdee103b9d09ad4ade3a9e6f9a2a1",
|
|
@@ -58,7 +58,7 @@
|
|
|
58
58
|
"agents/scripts/_modules.py": "23c3115d221277e661315788a529845e8613fd0ffc6750bde1850b04450be64f",
|
|
59
59
|
"agents/scripts/_performance_selftest.py": "2d3e289623163f0638cec08cf3cb4bbeba025ec0a4964bb946a20456856b8ebe",
|
|
60
60
|
"agents/scripts/_phase_review_v2_selftest.py": "10640da41da8dd11cc86411a8d0d3853831d2365921914690b4da99c58ba243a",
|
|
61
|
-
"agents/scripts/_pm_selftest.py": "
|
|
61
|
+
"agents/scripts/_pm_selftest.py": "3db78bb2bd7c90ef51773e33bf3c99bcffd20295088b3998a6395889c7b03ceb",
|
|
62
62
|
"agents/scripts/_portability_selftest.py": "85354e3e8483c46d81f7afc384cd99c5576f9150c86b376dc5cc4a46e736c353",
|
|
63
63
|
"agents/scripts/_product.py": "87e1d4d6c138667f2e2f5b6b149d2a468ad32b52bcebe79565864dc38a04b0c2",
|
|
64
64
|
"agents/scripts/_project_architecture.py": "e0776eb82fbe38722d5d6772c6bfd1eb0f8a5496ce62ed578f1243ada87d04a9",
|
|
@@ -80,10 +80,10 @@
|
|
|
80
80
|
"agents/scripts/_vnext_common.py": "5036dbaf9e303f3652c66287f213d5eca13197ffbf4fa3438d81fa9dd476c03b",
|
|
81
81
|
"agents/scripts/_vnext_selftest.py": "1a4f388670a4b01756de2f45085a9da1138ffcaecfe1e42f9cdef8114c669078",
|
|
82
82
|
"agents/scripts/_workflow/__init__.py": "c22fd03196f70c813422712dfe3cb56689bfcbc32d08089987ffe8b41191675e",
|
|
83
|
-
"agents/scripts/_workflow/engine.py": "
|
|
83
|
+
"agents/scripts/_workflow/engine.py": "595fd34139ba13ed2467da3067abfc4c710e0d1a0406b087e6b9c482466665af",
|
|
84
84
|
"agents/scripts/_workflow/phase_routing.py": "5948f0c916f720a522785965e71bf478add3dda1955d8dd8cbf2743498f07e78",
|
|
85
85
|
"agents/scripts/_workflow/planning.py": "697260f36cbeb5bde9ea557b9fb205123481bb15877d6a8bdf3ebfaee0aec4ef",
|
|
86
|
-
"agents/scripts/_workflow/router.py": "
|
|
86
|
+
"agents/scripts/_workflow/router.py": "5c058c9b5659fee690e400d173fd2806a228a1e41aa4308daf854a0763437a51",
|
|
87
87
|
"agents/scripts/_workflow/verification.py": "184cc95f051b229cf594a52363c746369477b222d9790705c0973a47a5e5ddd5",
|
|
88
88
|
"agents/scripts/_workflow_insight_selftest.py": "2a2fd37932ac86ca4fca9095f29bc9ccd0ee3e562fc8dc8cf7abf497a2859deb",
|
|
89
89
|
"agents/scripts/_worktree_handoff_selftest.py": "32af3b679d2c3fab3aa473d2c9d2639209fd7a891ca1735cf12d5a0b582109d4",
|
|
@@ -111,7 +111,7 @@
|
|
|
111
111
|
"agents/scripts/discovery_receipt.py": "78724878c347fe94aefbf7a756df6a28f8104e5b708d877fd1138db43e7058c1",
|
|
112
112
|
"agents/scripts/discovery_router.py": "ba8078be4300635aa92803c04d8a116de7990a5c983d5e0ecdfb969a7279d68d",
|
|
113
113
|
"agents/scripts/doctor/__init__.py": "86a2eddbbf4da8ad0744a6d998110e34f3c9c1f964d8f6fed2e78390221e29f4",
|
|
114
|
-
"agents/scripts/doctor/engine.py": "
|
|
114
|
+
"agents/scripts/doctor/engine.py": "454bff07a350bbb48e68d8965cdbe6eeb0f3c0a06ca24ff726ecc7b9d5213896",
|
|
115
115
|
"agents/scripts/doctor/models.py": "d5130b755d2e63b3c9a7d13ba28068c3eaa73f65140d7d00b1b76ebe35a51831",
|
|
116
116
|
"agents/scripts/ensure_hook_selftest.py": "c7367c8d46d0947baf631420a7f0bd4b201ca560ae3e2061702a650b5d87d6c9",
|
|
117
117
|
"agents/scripts/evidence_store.py": "30dcdffe280a393258acb93db72dfc923a2cebb0f487b6e3e64e58892f8926b3",
|
|
@@ -123,7 +123,7 @@
|
|
|
123
123
|
"agents/scripts/gradle_error_parser.py": "964999526572f9ee37fb4f969b48faf1efd1b5f9af9077ef010f2623329b1703",
|
|
124
124
|
"agents/scripts/harness_doctor.py": "88209e61202bf0a7d756b53a83b574f61f279f09dbb1e48a8bbd0baff91f066e",
|
|
125
125
|
"agents/scripts/host_continuation.py": "462edf9849ce75b9308ab46a9b96ed5bcd36690bd4bf1aa225b8810bba29c918",
|
|
126
|
-
"agents/scripts/incident_reporter.py": "
|
|
126
|
+
"agents/scripts/incident_reporter.py": "e05cee8f0b181174608a905c8ffcb912518c7b67c04ab836969ff57ef3d6f3d0",
|
|
127
127
|
"agents/scripts/install_or_update.py": "8c5d14933819331b330b4693d7f531a997d3361702624eb00447466cba9fe2b7",
|
|
128
128
|
"agents/scripts/install_tool_adapters.py": "6d07694a06f2eb63aacff4ae9078fc75b363864580668096bc566babb6c13052",
|
|
129
129
|
"agents/scripts/integrations/__init__.py": "d3b716d27fe4c634c74932d0fb75b6c44f283d0acffcb492d22bcf5b4c2b4d65",
|
|
@@ -138,7 +138,7 @@
|
|
|
138
138
|
"agents/scripts/journey_runner.py": "0c9094747be9bb4d8e4c7ebb57858c945766db7451d4d825888f94a9c09e7570",
|
|
139
139
|
"agents/scripts/lifecycle.py": "3ac9174aa76c394589371636540903101d4e23011e6dcc9ca576a7e4f88b4fce",
|
|
140
140
|
"agents/scripts/logcat_doctor.py": "d4ca172f1a91bd35106023cf8212ddcbd2409207b306d589b1f5b48dc753524e",
|
|
141
|
-
"agents/scripts/mutation_guard.py": "
|
|
141
|
+
"agents/scripts/mutation_guard.py": "2d0809f3b213e172c2e165a311effff9984de25898fc24be64a0e5cd46154dc5",
|
|
142
142
|
"agents/scripts/new_feature_scaffold.py": "804c8b1195e83030e7cc167ec140870a76bd2ca7cf2dbd8566b7b3a3124fa7fb",
|
|
143
143
|
"agents/scripts/perf_guard.py": "4fa1f4d3394f650a75bb3b4a08a866b319f8f952979928c85d6f7c601e796333",
|
|
144
144
|
"agents/scripts/phase_review.py": "36446026058a70958ff08cd08229dd23731a90026671bbc820135bdf5f483235",
|
|
@@ -220,7 +220,7 @@
|
|
|
220
220
|
"agents/tool-adapters/AGENTS.md.template": "76480cf043b82bcdf64381999ed4a1101deae46ea704f9d31f7deee01b79feb7",
|
|
221
221
|
"agents/tool-adapters/CLAUDE.md.template": "011adc69ab7dbde774a373183850f769dc864058dffedb0f78364d0fc0fbd3b7",
|
|
222
222
|
"agents/tool-adapters/CODEX.md.template": "0b2a7b9a5d990d0abd641970b3a07ad42fbad960f67629514ea7d2b73be8459e",
|
|
223
|
-
"agents/tool-adapters/GEMINI.md.template": "
|
|
223
|
+
"agents/tool-adapters/GEMINI.md.template": "b84142de56442d6dc2437b5700c6e0580c394139c360fdc39db71d00e88d44f2",
|
|
224
224
|
"agents/tool-adapters/QWEN.md.template": "ce8e8380f3a13cace4f4ae1414272eba5f2be744ba96351aa5d3c9f286a658da",
|
|
225
225
|
"agents/tool-adapters/README.md": "52fdd031b08d16eed1b0608b45b1f494176f5d49e82e48fd9b9028a4966f8109",
|
|
226
226
|
"agents/tool-adapters/continue-android-harness.md.template": "5b8920658ac12c5746e5d06c3c2d35f61e84553021416189f0319984647533de",
|
|
@@ -1390,6 +1390,53 @@ class ReviewRegressionTests(unittest.TestCase):
|
|
|
1390
1390
|
self.assertTrue(pm.validate_pm_mutation("jira", "add_comment", {"body": "test"}, {}, {})[0])
|
|
1391
1391
|
self.assertTrue(pm.validate_pm_mutation("jira", "update_issue", {"status": "In Progress"}, {}, {})[0])
|
|
1392
1392
|
|
|
1393
|
+
def test_incident_local_markdown_zero_pii_and_consent_flow_by_default(self):
|
|
1394
|
+
import incident_reporter as ir
|
|
1395
|
+
secret_msg = "Crash for user alice@example.com phone +201099887766 ip 192.168.1.55 at C:\\Users\\alice\\Project\\Main.kt"
|
|
1396
|
+
with tempfile.TemporaryDirectory() as td:
|
|
1397
|
+
repo = Path(td)
|
|
1398
|
+
(repo / ".agents").mkdir()
|
|
1399
|
+
self.assertFalse(ir.is_auto_submit_enabled(repo))
|
|
1400
|
+
inc = ir.record_incident(
|
|
1401
|
+
repo,
|
|
1402
|
+
code="UNEXPECTED_EXCEPTION",
|
|
1403
|
+
command="workflow.py status",
|
|
1404
|
+
message=secret_msg,
|
|
1405
|
+
traceback_text="NameError: " + secret_msg,
|
|
1406
|
+
)
|
|
1407
|
+
self.assertEqual("RECORDED", inc["status"])
|
|
1408
|
+
self.assertNotIn("submission", inc)
|
|
1409
|
+
self.assertIn("ask_question_guidance", inc)
|
|
1410
|
+
md_path = repo / ".agents" / "state" / "incidents" / f"{inc['incident_id']}.md"
|
|
1411
|
+
self.assertTrue(md_path.is_file())
|
|
1412
|
+
md_text = md_path.read_text(encoding="utf-8")
|
|
1413
|
+
self.assertNotIn("alice@example.com", md_text)
|
|
1414
|
+
self.assertNotIn("201099887766", md_text)
|
|
1415
|
+
self.assertNotIn("192.168.1.55", md_text)
|
|
1416
|
+
self.assertNotIn("C:\\Users\\alice", md_text)
|
|
1417
|
+
self.assertIn("<REDACTED_EMAIL>", md_text)
|
|
1418
|
+
pref = ir.set_auto_submit_preference(repo, True)
|
|
1419
|
+
self.assertTrue(pref["auto_submit_incidents"])
|
|
1420
|
+
self.assertTrue(ir.is_auto_submit_enabled(repo))
|
|
1421
|
+
|
|
1422
|
+
def test_router_next_delivery_splits_approach_without_name_error(self):
|
|
1423
|
+
from _workflow import router as r_mod
|
|
1424
|
+
with tempfile.TemporaryDirectory() as td:
|
|
1425
|
+
repo = Path(td)
|
|
1426
|
+
plan = {
|
|
1427
|
+
"task_id": "t-deliv",
|
|
1428
|
+
"status": "READY_FOR_DELIVERY",
|
|
1429
|
+
"requested_outcome": "Apply string contract",
|
|
1430
|
+
"approach": "Update string parser; add fallback handling.\nVerify Arabic strings",
|
|
1431
|
+
"expected_files": ["app/src/main/Strings.kt"],
|
|
1432
|
+
}
|
|
1433
|
+
with mock.patch.object(r_mod._engine, "build_manifest", return_value={"delivery_snapshot_sha256": ""}), \
|
|
1434
|
+
mock.patch.object(r_mod._engine, "_ready_external_inputs_changed", return_value=False), \
|
|
1435
|
+
mock.patch.object(r_mod._engine, "_find_uncommitted_task_files", return_value=["app/src/main/Strings.kt"]):
|
|
1436
|
+
res = r_mod._next_delivery(repo, "t-deliv", plan, "antigravity", "--repo . --task-id t-deliv", "", "READY_FOR_DELIVERY", {})
|
|
1437
|
+
self.assertEqual("DEVELOPER_GIT_COMMIT_REQUIRED", res["code"])
|
|
1438
|
+
self.assertIn("- Update string parser.", res["suggested_commit_block"])
|
|
1439
|
+
|
|
1393
1440
|
|
|
1394
1441
|
if __name__ == "__main__":
|
|
1395
1442
|
unittest.main(verbosity=2)
|
{android_agent_harness-1.2.3 → android_agent_harness-1.2.4}/agents/scripts/_workflow/engine.py
RENAMED
|
@@ -4025,6 +4025,44 @@ def main(argv: list[str] | None = None) -> int:
|
|
|
4025
4025
|
return 1
|
|
4026
4026
|
print(f"[FAIL] {exc}", file=sys.stderr)
|
|
4027
4027
|
return 1
|
|
4028
|
+
except Exception as exc:
|
|
4029
|
+
import traceback
|
|
4030
|
+
tb_text = traceback.format_exc()
|
|
4031
|
+
repo_path = Path(getattr(args, "repo", ".") or ".").resolve()
|
|
4032
|
+
t_id = str(getattr(args, "task_id", "") or "")
|
|
4033
|
+
t_state = ""
|
|
4034
|
+
try:
|
|
4035
|
+
if t_id:
|
|
4036
|
+
t_state = str(_load_plan(repo_path, t_id).get("status") or "")
|
|
4037
|
+
except (OSError, ValueError, ValidationError):
|
|
4038
|
+
t_state = ""
|
|
4039
|
+
try:
|
|
4040
|
+
from incident_reporter import record_incident
|
|
4041
|
+
inc = record_incident(
|
|
4042
|
+
repo_path,
|
|
4043
|
+
code="UNEXPECTED_EXCEPTION",
|
|
4044
|
+
command=f"workflow.py {getattr(args, 'action', '')}",
|
|
4045
|
+
message=f"{type(exc).__name__}: {exc}",
|
|
4046
|
+
task_id=t_id,
|
|
4047
|
+
task_state=t_state,
|
|
4048
|
+
traceback_text=tb_text,
|
|
4049
|
+
)
|
|
4050
|
+
inc_id = inc.get("incident_id", "")
|
|
4051
|
+
guidance = inc.get("ask_question_guidance") or {}
|
|
4052
|
+
sub = inc.get("submission") or {}
|
|
4053
|
+
print(f"[FAIL] Unexpected harness exception ({type(exc).__name__}: {exc})", file=sys.stderr)
|
|
4054
|
+
print(f"INCIDENT_RECORDED={inc_id}", file=sys.stderr)
|
|
4055
|
+
print(f"INCIDENT_LOCAL_REPORT=.agents/state/incidents/{inc_id}.md", file=sys.stderr)
|
|
4056
|
+
if sub.get("status") in {"REPORTED", "DEDUPLICATED_EXISTING_ISSUE"}:
|
|
4057
|
+
print(f"INCIDENT_AUTO_SUBMITTED={sub.get('issue_url', '')}", file=sys.stderr)
|
|
4058
|
+
elif guidance:
|
|
4059
|
+
print("TOOL_CALL_REQUIRED=ask_question", file=sys.stderr)
|
|
4060
|
+
print(f"INCIDENT_SUBMIT_ONCE={guidance.get('submit_once_command', '')}", file=sys.stderr)
|
|
4061
|
+
print(f"INCIDENT_SUBMIT_ALWAYS={guidance.get('submit_always_command', '')}", file=sys.stderr)
|
|
4062
|
+
print(f"NEXT_INSTRUCTIONS={guidance.get('instructions', '')}", file=sys.stderr)
|
|
4063
|
+
except Exception:
|
|
4064
|
+
print(tb_text, file=sys.stderr)
|
|
4065
|
+
return 1
|
|
4028
4066
|
if args.action == "prepare-verification":
|
|
4029
4067
|
print(f"HARNESS_RUN_ID={result['run_id']}")
|
|
4030
4068
|
print(f"HARNESS_DELIVERY_SNAPSHOT={result['delivery_snapshot_sha256']}")
|
|
@@ -675,53 +675,6 @@ class HarnessDoctor:
|
|
|
675
675
|
if any(fnmatchcase(name, pattern) for pattern in patterns):
|
|
676
676
|
yield Path(current) / name
|
|
677
677
|
|
|
678
|
-
def _detect_project_domains(self) -> set[str]:
|
|
679
|
-
detected = set()
|
|
680
|
-
skip_parts = {".git", ".gradle", "build", ".harness-backup", "node_modules", "__pycache__"}
|
|
681
|
-
text_corpus = ""
|
|
682
|
-
for p in self._repo_files(("*.gradle*",), skip_parts):
|
|
683
|
-
if any(x in p.parts for x in skip_parts):
|
|
684
|
-
continue
|
|
685
|
-
try:
|
|
686
|
-
text_corpus += p.read_text(encoding="utf-8", errors="ignore") + "\n"
|
|
687
|
-
except (OSError, ValueError):
|
|
688
|
-
pass
|
|
689
|
-
|
|
690
|
-
toml_path = self.repo / "gradle" / "libs.versions.toml"
|
|
691
|
-
if toml_path.is_file():
|
|
692
|
-
try:
|
|
693
|
-
text_corpus += toml_path.read_text(encoding="utf-8", errors="ignore") + "\n"
|
|
694
|
-
except (OSError, ValueError):
|
|
695
|
-
pass
|
|
696
|
-
|
|
697
|
-
for p in self._repo_files(("AndroidManifest.xml",), skip_parts):
|
|
698
|
-
if any(x in p.parts for x in skip_parts):
|
|
699
|
-
continue
|
|
700
|
-
try:
|
|
701
|
-
text_corpus += p.read_text(encoding="utf-8", errors="ignore") + "\n"
|
|
702
|
-
except (OSError, ValueError):
|
|
703
|
-
pass
|
|
704
|
-
|
|
705
|
-
scanned_kt = 0
|
|
706
|
-
max_kt_files = 500
|
|
707
|
-
for p in self._repo_files(("*.kt",), skip_parts):
|
|
708
|
-
if scanned_kt >= max_kt_files:
|
|
709
|
-
break
|
|
710
|
-
if any(x in p.parts for x in skip_parts):
|
|
711
|
-
continue
|
|
712
|
-
try:
|
|
713
|
-
text_corpus += p.read_text(encoding="utf-8", errors="ignore") + "\n"
|
|
714
|
-
scanned_kt += 1
|
|
715
|
-
except Exception:
|
|
716
|
-
continue
|
|
717
|
-
|
|
718
|
-
for domain_name, config in KNOWN_DOMAINS.items():
|
|
719
|
-
for sig in config["signatures"]:
|
|
720
|
-
if sig.lower() in text_corpus.lower():
|
|
721
|
-
detected.add(domain_name)
|
|
722
|
-
break
|
|
723
|
-
return detected
|
|
724
|
-
|
|
725
678
|
def check_skills_and_workflows(self) -> None:
|
|
726
679
|
category = "6. Skills & Workflows"
|
|
727
680
|
workflows_dir = self.agents_dir / "workflows"
|
|
@@ -756,41 +709,15 @@ class HarnessDoctor:
|
|
|
756
709
|
tailored_refs = [r for r in all_refs if r not in CORE_REFERENCES]
|
|
757
710
|
|
|
758
711
|
if self.is_raw_kit:
|
|
759
|
-
self.log(category, "Tailored Domain Coverage", "PASS", "Kit template mode (domain discovery active on client Android apps).")
|
|
760
712
|
self.log(category, "Domain Reference Indexing", "PASS", "Foundation scenarios indexed in daily-scenarios.md.")
|
|
761
713
|
return
|
|
762
714
|
|
|
763
|
-
detected_domains = self._detect_project_domains()
|
|
764
|
-
uncovered_domains = []
|
|
765
|
-
covered_domains = []
|
|
766
|
-
|
|
767
|
-
for domain_name, config in KNOWN_DOMAINS.items():
|
|
768
|
-
if domain_name in detected_domains:
|
|
769
|
-
prefixes = config["expected_prefixes"]
|
|
770
|
-
has_tailored = any(any(ref.startswith(p) for p in prefixes) for ref in tailored_refs)
|
|
771
|
-
if has_tailored:
|
|
772
|
-
matching = [ref for ref in tailored_refs if any(ref.startswith(p) for p in prefixes)]
|
|
773
|
-
covered_domains.append(f"{domain_name} -> {', '.join(matching)}")
|
|
774
|
-
else:
|
|
775
|
-
uncovered_domains.append(f"{domain_name} (suggested: '{config['sample_file']}')")
|
|
776
|
-
|
|
777
|
-
details = []
|
|
778
715
|
if tailored_refs:
|
|
779
|
-
details.append(f"Active tailored guides ({len(tailored_refs)}): {', '.join(tailored_refs)}")
|
|
780
|
-
if covered_domains:
|
|
781
|
-
details.append(f"Domain integrations confirmed: {'; '.join(covered_domains)}")
|
|
782
|
-
|
|
783
|
-
if not uncovered_domains:
|
|
784
|
-
msg = f"Deep domain integration verified: {len(tailored_refs)} tailored reference guide(s) active."
|
|
785
|
-
self.log(category, "Tailored Domain Coverage", "PASS", msg, details=details if details else None)
|
|
786
|
-
else:
|
|
787
|
-
details.extend([f"Uncovered domain detected: {d}" for d in uncovered_domains])
|
|
788
716
|
self.log(
|
|
789
717
|
category,
|
|
790
718
|
"Tailored Domain Coverage",
|
|
791
719
|
"PASS",
|
|
792
|
-
f"
|
|
793
|
-
details=details,
|
|
720
|
+
f"{len(tailored_refs)} additional reference guide(s) active: {', '.join(tailored_refs)}",
|
|
794
721
|
)
|
|
795
722
|
|
|
796
723
|
daily_scenarios_path = ref_dir / "daily-scenarios.md"
|