PyPI - loopx - Versions diffs - 0.4.8__py3-none-any.whl - Mend

loopx 0.4.8__py3-none-any.whl

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.

Files changed (811) hide show

loopx/__init__.py +5 -0
loopx/agent_onboarding.py +654 -0
loopx/agent_registry.py +112 -0
loopx/ark_managed_agent_host.py +59 -0
loopx/authority.py +805 -0
loopx/benchmark.py +2875 -0
loopx/benchmark_adapters/__init__.py +1 -0
loopx/benchmark_adapters/agentissue.py +2644 -0
loopx/benchmark_adapters/agents_last_exam.py +3998 -0
loopx/benchmark_adapters/edgebench.py +322 -0
loopx/benchmark_adapters/skillsbench.py +5978 -0
loopx/benchmark_adapters/skillsbench_acp_failure_policy.py +143 -0
loopx/benchmark_adapters/skillsbench_acp_process.py +31 -0
loopx/benchmark_adapters/skillsbench_acp_relay.py +4832 -0
loopx/benchmark_adapters/skillsbench_batch.py +124 -0
loopx/benchmark_adapters/skillsbench_bridge_guard.py +209 -0
loopx/benchmark_adapters/skillsbench_bridge_summary.py +203 -0
loopx/benchmark_adapters/skillsbench_codex_goal_recovery.py +271 -0
loopx/benchmark_adapters/skillsbench_codex_goal_trace.py +81 -0
loopx/benchmark_adapters/skillsbench_codex_runtime.py +339 -0
loopx/benchmark_adapters/skillsbench_dockerfile_runtime.py +467 -0
loopx/benchmark_adapters/skillsbench_failure_signals.py +652 -0
loopx/benchmark_adapters/skillsbench_proxy_runtime.py +327 -0
loopx/benchmark_adapters/skillsbench_remote_bridge.py +402 -0
loopx/benchmark_adapters/skillsbench_result_discovery.py +143 -0
loopx/benchmark_adapters/skillsbench_runner_profile.py +436 -0
loopx/benchmark_adapters/skillsbench_runner_source.py +99 -0
loopx/benchmark_adapters/skillsbench_setup_preflight.py +771 -0
loopx/benchmark_adapters/skillsbench_signals.py +15 -0
loopx/benchmark_adapters/skillsbench_task_source.py +141 -0
loopx/benchmark_adapters/skillsbench_turn_route.py +723 -0
loopx/benchmark_adapters/skillsbench_turn_runtime.py +1069 -0
loopx/benchmark_adapters/skillsbench_typed_repair.py +689 -0
loopx/benchmark_adapters/skillsbench_uv_cache.py +111 -0
loopx/benchmark_adapters/skillsbench_verifier_bootstrap.py +227 -0
loopx/benchmark_adapters/skillsbench_verifier_cache.py +138 -0
loopx/benchmark_adapters/terminal_bench.py +10078 -0
loopx/benchmark_case_analysis.py +1276 -0
loopx/benchmark_case_state.py +1079 -0
loopx/benchmark_core/__init__.py +239 -0
loopx/benchmark_core/adapter.py +84 -0
loopx/benchmark_core/artifacts.py +517 -0
loopx/benchmark_core/attempts.py +199 -0
loopx/benchmark_core/container_exec.py +216 -0
loopx/benchmark_core/io.py +68 -0
loopx/benchmark_core/lifecycle.py +211 -0
loopx/benchmark_core/loop_protocol.py +689 -0
loopx/benchmark_core/observable_handles.py +348 -0
loopx/benchmark_core/parity.py +256 -0
loopx/benchmark_core/remote_closeout.py +482 -0
loopx/benchmark_core/rounds.py +215 -0
loopx/benchmark_core/route_profile.py +509 -0
loopx/benchmark_core/run_permissions.py +206 -0
loopx/benchmark_core/split_control.py +925 -0
loopx/benchmark_core/turn_fidelity.py +326 -0
loopx/benchmark_ledger.py +3793 -0
loopx/benchmark_ledger_countability.py +372 -0
loopx/benchmark_ledger_current.py +724 -0
loopx/benchmark_trajectory.py +405 -0
loopx/benchmarks/__init__.py +1 -0
loopx/benchmarks/qualification/__init__.py +1 -0
loopx/benchmarks/qualification/release_outcome_baseline.py +360 -0
loopx/benchmarks/read_models/__init__.py +1 -0
loopx/benchmarks/read_models/benchmark_attempt_accounting.py +53 -0
loopx/benchmarks/read_models/benchmark_comparison.py +414 -0
loopx/benchmarks/read_models/benchmark_event_timeline.py +113 -0
loopx/benchmarks/read_models/benchmark_experiment_report.py +475 -0
loopx/benchmarks/read_models/benchmark_learning_ledger.py +137 -0
loopx/benchmarks/read_models/benchmark_lifecycle_contracts.py +228 -0
loopx/benchmarks/read_models/benchmark_projection.py +723 -0
loopx/benchmarks/read_models/benchmark_result.py +146 -0
loopx/benchmarks/read_models/benchmark_run_execution_contract.py +116 -0
loopx/benchmarks/read_models/benchmark_run_failure.py +157 -0
loopx/benchmarks/read_models/benchmark_run_metrics.py +213 -0
loopx/benchmarks/read_models/benchmark_run_post_execution.py +635 -0
loopx/benchmarks/read_models/benchmark_run_pre_execution.py +541 -0
loopx/benchmarks/read_models/benchmark_status_compaction.py +1255 -0
loopx/benchmarks/read_models/benchmark_status_runner.py +780 -0
loopx/benchmarks/read_models/goal_start_control_score.py +857 -0
loopx/benchmarks/read_models/skillsbench_post_run_debug.py +746 -0
loopx/benchmarks/read_models/skillsbench_verifier_attribution.py +269 -0
loopx/bootstrap.py +1116 -0
loopx/bootstrap_command_pack.py +2167 -0
loopx/boundary_authority.py +199 -0
loopx/canary/__init__.py +1 -0
loopx/canary/maintainability_ratchet.py +800 -0
loopx/canary/planner.py +1984 -0
loopx/canary/premerge.py +1130 -0
loopx/canary/qualification_profiles.py +309 -0
loopx/canary/quality_surface_catalog.py +838 -0
loopx/canary/release_profiles.py +51 -0
loopx/canary/runner.py +1107 -0
loopx/canary/smoke_health.py +581 -0
loopx/canary/smoke_profiles.py +212 -0
loopx/capabilities/__init__.py +0 -0
loopx/capabilities/agent_turn_recall/__init__.py +17 -0
loopx/capabilities/agent_turn_recall/cli.py +369 -0
loopx/capabilities/agent_turn_recall/core.py +296 -0
loopx/capabilities/auto_research/__init__.py +16 -0
loopx/capabilities/auto_research/bootstrap_contract.py +157 -0
loopx/capabilities/auto_research/cli.py +1468 -0
loopx/capabilities/auto_research/core.py +11 -0
loopx/capabilities/auto_research/defaults.py +79 -0
loopx/capabilities/auto_research/demo_e2e.py +1848 -0
loopx/capabilities/auto_research/demo_supervisor.py +186 -0
loopx/capabilities/auto_research/evidence_packet.py +767 -0
loopx/capabilities/auto_research/human_view.py +794 -0
loopx/capabilities/auto_research/kernel.py +191 -0
loopx/capabilities/auto_research/knn_demo_workspace.py +322 -0
loopx/capabilities/auto_research/live_evidence.py +248 -0
loopx/capabilities/auto_research/preset.py +176 -0
loopx/capabilities/auto_research/research_state.py +1085 -0
loopx/capabilities/auto_research/role_profiles.py +394 -0
loopx/capabilities/auto_research/rollout_append.py +97 -0
loopx/capabilities/auto_research/terminal_result_contract.py +422 -0
loopx/capabilities/auto_research/terminal_result_projection.py +171 -0
loopx/capabilities/auto_research/terminal_result_query.py +233 -0
loopx/capabilities/auto_research/terminal_results.py +349 -0
loopx/capabilities/auto_research/user_contract.py +190 -0
loopx/capabilities/auto_research/worker_loop.py +163 -0
loopx/capabilities/auto_research/worker_runtime.py +777 -0
loopx/capabilities/auto_research/worker_skill/SKILL.md +343 -0
loopx/capabilities/benchmark_toolkit/__init__.py +19 -0
loopx/capabilities/benchmark_toolkit/integrity.py +387 -0
loopx/capabilities/catalog.py +1875 -0
loopx/capabilities/change_quality/__init__.py +19 -0
loopx/capabilities/change_quality/cli.py +171 -0
loopx/capabilities/change_quality/context.py +156 -0
loopx/capabilities/change_quality/oracles.py +269 -0
loopx/capabilities/change_quality/policy.py +34 -0
loopx/capabilities/change_quality/receipt.py +482 -0
loopx/capabilities/change_quality/result.py +493 -0
loopx/capabilities/change_quality/scope.py +171 -0
loopx/capabilities/change_quality/shadow.py +680 -0
loopx/capabilities/content_ops/__init__.py +0 -0
loopx/capabilities/content_ops/cli.py +649 -0
loopx/capabilities/content_ops/connector_packets.py +164 -0
loopx/capabilities/content_ops/item_lifecycle.py +1000 -0
loopx/capabilities/content_ops/layout.py +451 -0
loopx/capabilities/content_ops/markdown.py +456 -0
loopx/capabilities/content_ops/schemas.py +51 -0
loopx/capabilities/content_ops/social_browser_x.py +107 -0
loopx/capabilities/content_ops/surface.py +1956 -0
loopx/capabilities/content_ops/templates/layout-catalog-v0.json +72 -0
loopx/capabilities/context_providers/__init__.py +36 -0
loopx/capabilities/context_providers/base.py +189 -0
loopx/capabilities/context_providers/factory.py +32 -0
loopx/capabilities/context_providers/openviking.py +702 -0
loopx/capabilities/context_providers/service_ownership.py +185 -0
loopx/capabilities/decision_context/__init__.py +129 -0
loopx/capabilities/decision_context/architecture.py +83 -0
loopx/capabilities/decision_context/assembler.py +849 -0
loopx/capabilities/decision_context/catalog_entry.py +195 -0
loopx/capabilities/decision_context/cli.py +310 -0
loopx/capabilities/decision_context/cursor_commit.py +535 -0
loopx/capabilities/decision_context/outcome_feedback.py +352 -0
loopx/capabilities/decision_context/packets.py +654 -0
loopx/capabilities/decision_context/private_state.py +189 -0
loopx/capabilities/decision_context/profile.py +453 -0
loopx/capabilities/decision_context/providers.py +228 -0
loopx/capabilities/decision_context/review_settlement.py +136 -0
loopx/capabilities/decision_context/runtime.py +273 -0
loopx/capabilities/decision_context/sources.py +415 -0
loopx/capabilities/explore/__init__.py +1 -0
loopx/capabilities/explore/activation.py +198 -0
loopx/capabilities/explore/adaptive_replay_planner.py +221 -0
loopx/capabilities/explore/child_replay_runtime.py +463 -0
loopx/capabilities/explore/composition_frontier.py +291 -0
loopx/capabilities/explore/counterfactual_runtime.py +578 -0
loopx/capabilities/explore/episode_runtime.py +647 -0
loopx/capabilities/explore/harness_checkpoint.py +171 -0
loopx/capabilities/explore/harness_gate.py +115 -0
loopx/capabilities/explore/harness_runtime.py +1124 -0
loopx/capabilities/explore/replay_metrics.py +206 -0
loopx/capabilities/explore/replay_runtime.py +1271 -0
loopx/capabilities/explore/resource_portfolio.py +173 -0
loopx/capabilities/explore/result_log.py +974 -0
loopx/capabilities/explore/router_state.py +432 -0
loopx/capabilities/explore/source_history_reconcile.py +255 -0
loopx/capabilities/explore/speculative_scheduler.py +498 -0
loopx/capabilities/explore/todo_branch_plan.py +650 -0
loopx/capabilities/explore/todo_evidence.py +141 -0
loopx/capabilities/explore/trace_runtime.py +284 -0
loopx/capabilities/explore/worker_branch_plan.py +1257 -0
loopx/capabilities/integration_branch/__init__.py +13 -0
loopx/capabilities/integration_branch/cli.py +148 -0
loopx/capabilities/integration_branch/core.py +916 -0
loopx/capabilities/issue_fix/__init__.py +19 -0
loopx/capabilities/issue_fix/acceptance_loop.py +1050 -0
loopx/capabilities/issue_fix/candidate_evidence.py +503 -0
loopx/capabilities/issue_fix/candidate_preflight.py +676 -0
loopx/capabilities/issue_fix/cli.py +1822 -0
loopx/capabilities/issue_fix/cli_input.py +87 -0
loopx/capabilities/issue_fix/content_ops_cli.py +148 -0
loopx/capabilities/issue_fix/discovered_issue_promotion.py +947 -0
loopx/capabilities/issue_fix/explore_projection.py +710 -0
loopx/capabilities/issue_fix/feasibility.py +542 -0
loopx/capabilities/issue_fix/github_public.py +661 -0
loopx/capabilities/issue_fix/intake_surface.py +832 -0
loopx/capabilities/issue_fix/metadata_preview.py +218 -0
loopx/capabilities/issue_fix/metrics_projection.py +1340 -0
loopx/capabilities/issue_fix/metrics_supplement.py +634 -0
loopx/capabilities/issue_fix/metrics_supplement_cli.py +127 -0
loopx/capabilities/issue_fix/outcome_projection.py +1235 -0
loopx/capabilities/issue_fix/periodic_report.py +189 -0
loopx/capabilities/issue_fix/pr_description.py +418 -0
loopx/capabilities/issue_fix/pr_gate_reconcile.py +496 -0
loopx/capabilities/issue_fix/pr_gate_reconcile_cli.py +464 -0
loopx/capabilities/issue_fix/pr_lifecycle.py +1327 -0
loopx/capabilities/issue_fix/pr_lifecycle_rollout.py +85 -0
loopx/capabilities/issue_fix/pr_monitor_materialization.py +257 -0
loopx/capabilities/issue_fix/pr_review_ack.py +439 -0
loopx/capabilities/issue_fix/provider_hooks.py +24 -0
loopx/capabilities/issue_fix/repository_commit_evidence.py +186 -0
loopx/capabilities/issue_fix/repository_context.py +457 -0
loopx/capabilities/issue_fix/repository_memory.py +459 -0
loopx/capabilities/issue_fix/repository_memory_provider.py +1454 -0
loopx/capabilities/issue_fix/repository_snapshot.py +454 -0
loopx/capabilities/issue_fix/reviewer_cli.py +917 -0
loopx/capabilities/issue_fix/reviewer_notification.py +882 -0
loopx/capabilities/issue_fix/reviewer_notification_drain.py +942 -0
loopx/capabilities/issue_fix/reviewer_recommendation.py +1057 -0
loopx/capabilities/issue_fix/reviewer_request.py +1282 -0
loopx/capabilities/issue_fix/reward_memory.py +879 -0
loopx/capabilities/issue_fix/workflow_plan.py +1286 -0
loopx/capabilities/material_lifecycle/__init__.py +161 -0
loopx/capabilities/material_lifecycle/_validation.py +183 -0
loopx/capabilities/material_lifecycle/apply.py +672 -0
loopx/capabilities/material_lifecycle/architecture.py +122 -0
loopx/capabilities/material_lifecycle/cli.py +161 -0
loopx/capabilities/material_lifecycle/decision_planning.py +470 -0
loopx/capabilities/material_lifecycle/explore_execution.py +306 -0
loopx/capabilities/material_lifecycle/intake.py +869 -0
loopx/capabilities/material_lifecycle/inventory.py +147 -0
loopx/capabilities/material_lifecycle/lifecycle.py +98 -0
loopx/capabilities/material_lifecycle/preparation.py +147 -0
loopx/capabilities/material_lifecycle/project_skill.py +83 -0
loopx/capabilities/material_lifecycle/ranking.py +267 -0
loopx/capabilities/material_lifecycle/readable_projection.py +500 -0
loopx/capabilities/material_lifecycle/rebuild.py +480 -0
loopx/capabilities/material_lifecycle/settlement.py +238 -0
loopx/capabilities/periodic_report/__init__.py +71 -0
loopx/capabilities/periodic_report/adapters.py +939 -0
loopx/capabilities/periodic_report/archive.py +422 -0
loopx/capabilities/periodic_report/bindings.py +705 -0
loopx/capabilities/periodic_report/cli.py +277 -0
loopx/capabilities/periodic_report/core.py +691 -0
loopx/capabilities/periodic_report/extension_envelope.py +66 -0
loopx/capabilities/periodic_report/presets.py +103 -0
loopx/capabilities/periodic_report/profile.py +235 -0
loopx/capabilities/periodic_report/project_progress.py +179 -0
loopx/capabilities/periodic_report/triggers.py +452 -0
loopx/capabilities/pr_review_queue/__init__.py +17 -0
loopx/capabilities/pr_review_queue/core.py +506 -0
loopx/capabilities/pr_review_queue/review_contract.py +506 -0
loopx/capabilities/registry.py +192 -0
loopx/capabilities/reward_memory/__init__.py +75 -0
loopx/capabilities/reward_memory/application.py +819 -0
loopx/capabilities/reward_memory/architecture.py +572 -0
loopx/capabilities/reward_memory/candidate_review.py +511 -0
loopx/capabilities/reward_memory/cli.py +469 -0
loopx/capabilities/reward_memory/dogfood.py +574 -0
loopx/capabilities/reward_memory/evaluation.py +296 -0
loopx/capabilities/reward_memory/evaluation_fixtures.py +362 -0
loopx/capabilities/reward_memory/experiment.py +567 -0
loopx/capabilities/reward_memory/health.py +222 -0
loopx/capabilities/reward_memory/ingestion.py +519 -0
loopx/capabilities/reward_memory/registry.py +600 -0
loopx/capabilities/reward_memory/runtime_hooks.py +312 -0
loopx/capabilities/reward_memory/scoped_feedback.py +173 -0
loopx/capabilities/semantic_preference/__init__.py +12 -0
loopx/capabilities/semantic_preference/cli.py +189 -0
loopx/capabilities/semantic_preference/contract.py +592 -0
loopx/capabilities/semantic_preference/reward_memory.py +62 -0
loopx/capabilities/value_connectors/__init__.py +1 -0
loopx/capabilities/value_connectors/cli.py +401 -0
loopx/capabilities/value_connectors/finance_extension_migration.py +108 -0
loopx/capabilities/value_connectors/install_check.py +147 -0
loopx/capabilities/value_connectors/planner.py +733 -0
loopx/capabilities/value_connectors/source_map.py +446 -0
loopx/claude_goal_baseline.py +138 -0
loopx/claude_goal_mode/__init__.py +23 -0
loopx/claude_goal_mode/hooks/goal_policy.py +212 -0
loopx/claude_goal_mode/hooks/goal_state.py +139 -0
loopx/claude_goal_mode/mcp/loopx_mcp.py +167 -0
loopx/claude_goal_mode/scripts/connect.py +103 -0
loopx/claude_goal_mode/scripts/goalmode_cmd.py +241 -0
loopx/claude_goal_mode/scripts/install.py +328 -0
loopx/claude_goal_mode/statusline/goal_status.py +97 -0
loopx/cli.py +836 -0
loopx/cli_commands/__init__.py +334 -0
loopx/cli_commands/_host_thread.py +13 -0
loopx/cli_commands/agentissue_runner_flow.py +447 -0
loopx/cli_commands/agents_last_exam.py +160 -0
loopx/cli_commands/agents_last_exam_baked_input.py +302 -0
loopx/cli_commands/agents_last_exam_host_codex.py +374 -0
loopx/cli_commands/agents_last_exam_launch_dry_run.py +372 -0
loopx/cli_commands/agents_last_exam_local_plan.py +322 -0
loopx/cli_commands/agents_last_exam_runner_source.py +352 -0
loopx/cli_commands/agents_last_exam_task_material.py +335 -0
loopx/cli_commands/agents_last_exam_validation_gate.py +236 -0
loopx/cli_commands/benchmark_boundary.py +499 -0
loopx/cli_commands/benchmark_dispatch.py +161 -0
loopx/cli_commands/benchmark_release_outcome.py +123 -0
loopx/cli_commands/benchmark_review_lifecycle.py +1275 -0
loopx/cli_commands/benchmark_run_ledger.py +763 -0
loopx/cli_commands/benchmark_run_ledger_case_analysis.py +249 -0
loopx/cli_commands/benchmark_run_ledger_classification.py +45 -0
loopx/cli_commands/benchmark_run_ledger_maintenance.py +486 -0
loopx/cli_commands/benchmark_run_ledger_maintenance_registration.py +342 -0
loopx/cli_commands/benchmark_run_ledger_maintenance_rendering.py +233 -0
loopx/cli_commands/benchmark_run_ledger_parity.py +92 -0
loopx/cli_commands/bootstrap_connect.py +238 -0
loopx/cli_commands/canary.py +707 -0
loopx/cli_commands/canary_release_qualification.py +79 -0
loopx/cli_commands/capability.py +96 -0
loopx/cli_commands/doctor.py +43 -0
loopx/cli_commands/dreaming.py +143 -0
loopx/cli_commands/edgebench.py +205 -0
loopx/cli_commands/evidence_log.py +275 -0
loopx/cli_commands/explore.py +989 -0
loopx/cli_commands/explore_planning_commands.py +157 -0
loopx/cli_commands/extension.py +271 -0
loopx/cli_commands/first_run_report.py +73 -0
loopx/cli_commands/goal_channel.py +656 -0
loopx/cli_commands/handoff_mode.py +158 -0
loopx/cli_commands/history.py +622 -0
loopx/cli_commands/host_mode_plan.py +113 -0
loopx/cli_commands/lark_inbox.py +431 -0
loopx/cli_commands/lark_kanban.py +629 -0
loopx/cli_commands/ml_experiment.py +321 -0
loopx/cli_commands/multi_agent.py +211 -0
loopx/cli_commands/opencode2_goal_worker.py +217 -0
loopx/cli_commands/pr_review.py +167 -0
loopx/cli_commands/presentation.py +218 -0
loopx/cli_commands/preset.py +96 -0
loopx/cli_commands/project.py +150 -0
loopx/cli_commands/project_lifecycle.py +915 -0
loopx/cli_commands/quota.py +859 -0
loopx/cli_commands/quota_registration.py +241 -0
loopx/cli_commands/quota_request.py +113 -0
loopx/cli_commands/ready_score.py +110 -0
loopx/cli_commands/registry_admin.py +975 -0
loopx/cli_commands/registry_admin_configure.py +344 -0
loopx/cli_commands/registry_admin_peer.py +84 -0
loopx/cli_commands/registry_authority.py +218 -0
loopx/cli_commands/review_batch.py +146 -0
loopx/cli_commands/slash_commands.py +145 -0
loopx/cli_commands/start_goal.py +251 -0
loopx/cli_commands/starter.py +175 -0
loopx/cli_commands/starter_bootstrap.py +179 -0
loopx/cli_commands/starter_bootstrap_registration.py +198 -0
loopx/cli_commands/starter_runtime_idle.py +107 -0
loopx/cli_commands/starter_scheduler.py +207 -0
loopx/cli_commands/starter_session_runtime.py +152 -0
loopx/cli_commands/starter_visible_common.py +54 -0
loopx/cli_commands/starter_visible_driver.py +161 -0
loopx/cli_commands/starter_visible_pilot.py +278 -0
loopx/cli_commands/status.py +867 -0
loopx/cli_commands/status_registration.py +239 -0
loopx/cli_commands/summary_all.py +222 -0
loopx/cli_commands/support_control.py +809 -0
loopx/cli_commands/support_control_registry.py +68 -0
loopx/cli_commands/support_control_supervisor.py +289 -0
loopx/cli_commands/task_lease.py +306 -0
loopx/cli_commands/terminal_bench_adapter.py +717 -0
loopx/cli_commands/terminal_bench_environment_result.py +1246 -0
loopx/cli_commands/todo.py +940 -0
loopx/cli_commands/todo_argument_validation.py +572 -0
loopx/cli_commands/todo_event.py +114 -0
loopx/cli_commands/turn.py +804 -0
loopx/cli_commands/version.py +46 -0
loopx/cli_commands/worker_bridge.py +659 -0
loopx/cli_rollout.py +314 -0
loopx/codex_cli_goal_tui.py +672 -0
loopx/codex_cli_probe.py +1530 -0
loopx/codex_cli_probe_markdown.py +935 -0
loopx/codex_cli_runtime_probe.py +733 -0
loopx/codex_cli_scheduler.py +564 -0
loopx/codex_goal_baseline.py +620 -0
loopx/configuration_catalog.py +617 -0
loopx/configure_goal.py +1375 -0
loopx/contract.py +996 -0
loopx/control_plane/__init__.py +71 -0
loopx/control_plane/agents/__init__.py +1 -0
loopx/control_plane/agents/agent_lane_recommendation.py +516 -0
loopx/control_plane/agents/agent_scope.py +1578 -0
loopx/control_plane/agents/agent_scope_frontier.py +60 -0
loopx/control_plane/agents/capability_gate.py +531 -0
loopx/control_plane/agents/identity.py +140 -0
loopx/control_plane/agents/legacy_migration.py +169 -0
loopx/control_plane/agents/management_projection.py +658 -0
loopx/control_plane/agents/material_frontier.py +608 -0
loopx/control_plane/agents/material_handoff.py +156 -0
loopx/control_plane/agents/multi_agent/__init__.py +1 -0
loopx/control_plane/agents/multi_agent/codex_executable.py +207 -0
loopx/control_plane/agents/multi_agent/collective_round_ledger.py +387 -0
loopx/control_plane/agents/multi_agent/contract.py +474 -0
loopx/control_plane/agents/multi_agent/recipe.py +110 -0
loopx/control_plane/agents/multi_agent/role_successor.py +297 -0
loopx/control_plane/agents/multi_agent/runtime_scripts.py +426 -0
loopx/control_plane/agents/multi_agent/visible_launch_policy.py +149 -0
loopx/control_plane/agents/multi_agent/visible_wake_scheduler.py +392 -0
loopx/control_plane/agents/profile.py +216 -0
loopx/control_plane/agents/runtime_model.py +73 -0
loopx/control_plane/agents/subagent_activity.py +164 -0
loopx/control_plane/agents/supervisor.py +544 -0
loopx/control_plane/agents/supervisor_events.py +462 -0
loopx/control_plane/agents/supervisor_inject.py +204 -0
loopx/control_plane/agents/work_mode.py +56 -0
loopx/control_plane/agents/workspace_guard.py +364 -0
loopx/control_plane/effect_program.py +644 -0
loopx/control_plane/goals/__init__.py +1 -0
loopx/control_plane/goals/active_state_event_projection.py +103 -0
loopx/control_plane/goals/active_state_metadata.py +47 -0
loopx/control_plane/goals/active_state_sections.py +58 -0
loopx/control_plane/goals/configure_goal_service.py +354 -0
loopx/control_plane/goals/contract_health.py +132 -0
loopx/control_plane/goals/dreaming.py +152 -0
loopx/control_plane/goals/global_registry_health.py +199 -0
loopx/control_plane/goals/global_registry_shadow.py +33 -0
loopx/control_plane/goals/goal_channel.py +34 -0
loopx/control_plane/goals/goal_channel_projection.py +560 -0
loopx/control_plane/goals/goal_frontier/__init__.py +1917 -0
loopx/control_plane/goals/goal_frontier/ack_policy.py +149 -0
loopx/control_plane/goals/goal_frontier/outcome_continuity.py +437 -0
loopx/control_plane/goals/goal_frontier/replan_rules.py +210 -0
loopx/control_plane/goals/goal_frontier/semantic_history.py +314 -0
loopx/control_plane/goals/goal_frontier/terminal.py +180 -0
loopx/control_plane/goals/goal_vision.py +443 -0
loopx/control_plane/goals/goal_vision_policy.py +36 -0
loopx/control_plane/goals/goal_vision_state.py +62 -0
loopx/control_plane/goals/goal_vision_wait.py +290 -0
loopx/control_plane/goals/path_resolution.py +20 -0
loopx/control_plane/goals/start_contract.py +206 -0
loopx/control_plane/goals/vision_checkpoint.py +92 -0
loopx/control_plane/handoff/__init__.py +1 -0
loopx/control_plane/handoff/cross_runtime_impl_review.py +311 -0
loopx/control_plane/handoff/delivery_contract.py +161 -0
loopx/control_plane/handoff/handoff_runs.py +71 -0
loopx/control_plane/handoff/project_handoff.py +155 -0
loopx/control_plane/handoff/review_batch.py +463 -0
loopx/control_plane/handoff/review_packet_context.py +216 -0
loopx/control_plane/heartbeat/agent.py +173 -0
loopx/control_plane/heartbeat/budget.py +66 -0
loopx/control_plane/heartbeat/builder.py +501 -0
loopx/control_plane/heartbeat/host.py +64 -0
loopx/control_plane/heartbeat/rules.py +68 -0
loopx/control_plane/heartbeat/task_body.py +759 -0
loopx/control_plane/heartbeat/visible_goal.py +86 -0
loopx/control_plane/projects/__init__.py +1 -0
loopx/control_plane/projects/contract.py +25 -0
loopx/control_plane/projects/registry.py +663 -0
loopx/control_plane/quota/__init__.py +1 -0
loopx/control_plane/quota/cli_projection.py +704 -0
loopx/control_plane/quota/decision_summary.py +431 -0
loopx/control_plane/quota/effect_program.py +152 -0
loopx/control_plane/quota/error_codes.py +19 -0
loopx/control_plane/quota/goal_boundary.py +464 -0
loopx/control_plane/quota/heartbeat_receipt.py +277 -0
loopx/control_plane/quota/heartbeat_recommendation.py +718 -0
loopx/control_plane/quota/host_poll_receipts.py +162 -0
loopx/control_plane/quota/live_decision.py +142 -0
loopx/control_plane/quota/monitor_poll.py +786 -0
loopx/control_plane/quota/policy_constants.py +40 -0
loopx/control_plane/quota/projection_repair.py +262 -0
loopx/control_plane/quota/recent_runs.py +210 -0
loopx/control_plane/quota/scheduler_ack.py +490 -0
loopx/control_plane/quota/selected_todo_projection.py +139 -0
loopx/control_plane/quota/settlement.py +437 -0
loopx/control_plane/quota/settlement_cli.py +246 -0
loopx/control_plane/quota/settlement_validation.py +64 -0
loopx/control_plane/quota/settlement_workspace_causality.py +180 -0
loopx/control_plane/quota/should_run.py +249 -0
loopx/control_plane/quota/should_run_packet.py +1165 -0
loopx/control_plane/quota/should_run_prepare.py +675 -0
loopx/control_plane/quota/slot_accounting.py +1123 -0
loopx/control_plane/quota/spend_sources.py +11 -0
loopx/control_plane/quota/stall_repair.py +397 -0
loopx/control_plane/quota/states.py +29 -0
loopx/control_plane/quota/task_orchestration.py +448 -0
loopx/control_plane/quota/task_orchestration_admission.py +497 -0
loopx/control_plane/quota/turn_envelope.py +889 -0
loopx/control_plane/quota/usage_summary.py +140 -0
loopx/control_plane/reward_memory.py +43 -0
loopx/control_plane/runtime/__init__.py +2 -0
loopx/control_plane/runtime/active_user_assisted_pilot.py +275 -0
loopx/control_plane/runtime/agent_scoped_evidence_log.py +435 -0
loopx/control_plane/runtime/decision_freshness.py +203 -0
loopx/control_plane/runtime/event_ledger.py +197 -0
loopx/control_plane/runtime/event_store_migration_bridge.py +196 -0
loopx/control_plane/runtime/goal_project_route.py +70 -0
loopx/control_plane/runtime/local_state_write_correctness.py +242 -0
loopx/control_plane/runtime/promotion_readiness.py +152 -0
loopx/control_plane/runtime/public_safety.py +120 -0
loopx/control_plane/runtime/run_artifacts.py +78 -0
loopx/control_plane/runtime/run_compaction.py +397 -0
loopx/control_plane/runtime/run_context_retention.py +241 -0
loopx/control_plane/runtime/run_history.py +132 -0
loopx/control_plane/runtime/run_index_duplicates.py +205 -0
loopx/control_plane/runtime/run_index_rebuild.py +263 -0
loopx/control_plane/runtime/run_ingest_health.py +336 -0
loopx/control_plane/runtime/runtime_projection_route.py +624 -0
loopx/control_plane/runtime/runtime_projection_writer.py +98 -0
loopx/control_plane/runtime/session_runtime.py +339 -0
loopx/control_plane/runtime/shared_runtime_material_projection.py +332 -0
loopx/control_plane/runtime/shared_runtime_refresh_projection.py +183 -0
loopx/control_plane/runtime/stale_latest_run.py +90 -0
loopx/control_plane/runtime/status_classifications.py +49 -0
loopx/control_plane/runtime/status_projection_cache.py +235 -0
loopx/control_plane/runtime/stride_observation.py +144 -0
loopx/control_plane/runtime/time.py +39 -0
loopx/control_plane/runtime/trajectory_hygiene.py +149 -0
loopx/control_plane/runtime/validation_command.py +69 -0
loopx/control_plane/scheduler/__init__.py +1 -0
loopx/control_plane/scheduler/ack.py +329 -0
loopx/control_plane/scheduler/arbitration.py +188 -0
loopx/control_plane/scheduler/automation_liveness.py +183 -0
loopx/control_plane/scheduler/execution_context.py +555 -0
loopx/control_plane/scheduler/external_evidence_observation.py +428 -0
loopx/control_plane/scheduler/monitor_display.py +143 -0
loopx/control_plane/scheduler/monitor_poll_policy.py +161 -0
loopx/control_plane/scheduler/monitor_poll_writeback.py +351 -0
loopx/control_plane/scheduler/monitor_target.py +64 -0
loopx/control_plane/scheduler/monitor_todo.py +146 -0
loopx/control_plane/scheduler/monitor_wait.py +237 -0
loopx/control_plane/scheduler/scheduler_hint.py +1284 -0
loopx/control_plane/scheduler/state.py +354 -0
loopx/control_plane/scheduler/state_transition_rules.py +179 -0
loopx/control_plane/scheduler/time.py +10 -0
loopx/control_plane/settlement_driver.py +293 -0
loopx/control_plane/status/__init__.py +6 -0
loopx/control_plane/status/active_state_projection.py +105 -0
loopx/control_plane/status/agent_lane_projection.py +375 -0
loopx/control_plane/status/attention_projection.py +74 -0
loopx/control_plane/status/autonomous_replan_projection.py +103 -0
loopx/control_plane/status/collection.py +140 -0
loopx/control_plane/status/contract_projection.py +31 -0
loopx/control_plane/status/dreaming_projection.py +52 -0
loopx/control_plane/status/goal_attention_projection.py +157 -0
loopx/control_plane/status/lifecycle_projection.py +110 -0
loopx/control_plane/status/monitor_display_projection.py +69 -0
loopx/control_plane/status/registry_health_projection.py +75 -0
loopx/control_plane/status/run_projection.py +70 -0
loopx/control_plane/status/runtime_summaries.py +161 -0
loopx/control_plane/testing/__init__.py +1 -0
loopx/control_plane/testing/actual_default_model_behavior_portfolio.py +1371 -0
loopx/control_plane/testing/canary_harness.py +182 -0
loopx/control_plane/testing/capability_monitor_repair_tool_behavior.py +674 -0
loopx/control_plane/testing/cli_output_budget.py +807 -0
loopx/control_plane/testing/cli_output_differential.py +250 -0
loopx/control_plane/testing/cli_output_semantics.py +87 -0
loopx/control_plane/testing/control_plane_composition_scenarios.py +225 -0
loopx/control_plane/testing/decision_replay.py +268 -0
loopx/control_plane/testing/doubao_model_behavior_actor.py +559 -0
loopx/control_plane/testing/model_behavior_corpus.py +344 -0
loopx/control_plane/testing/model_behavior_qualification.py +769 -0
loopx/control_plane/testing/model_behavior_retained_cases.py +235 -0
loopx/control_plane/testing/model_tool_behavior.py +536 -0
loopx/control_plane/testing/onboarding_model_behavior_qualification.py +642 -0
loopx/control_plane/testing/quota_fixtures.py +208 -0
loopx/control_plane/testing/quota_should_run_parity.py +57 -0
loopx/control_plane/testing/release_commit_qualification.py +671 -0
loopx/control_plane/testing/replan_semantic_action_behavior.py +1302 -0
loopx/control_plane/testing/scoped_gate_successor_tool_behavior.py +527 -0
loopx/control_plane/testing/selected_todo_tool_behavior.py +1002 -0
loopx/control_plane/testing/terminal_settlement_tool_behavior.py +656 -0
loopx/control_plane/todos/__init__.py +1 -0
loopx/control_plane/todos/active_state_editing.py +296 -0
loopx/control_plane/todos/active_state_todo_parser.py +138 -0
loopx/control_plane/todos/active_state_todos.py +175 -0
loopx/control_plane/todos/addition.py +103 -0
loopx/control_plane/todos/claim_visibility.py +253 -0
loopx/control_plane/todos/completed_archive.py +139 -0
loopx/control_plane/todos/completion_fence.py +49 -0
loopx/control_plane/todos/completion_policy.py +153 -0
loopx/control_plane/todos/completion_validation.py +248 -0
loopx/control_plane/todos/completion_validation_accountability.py +27 -0
loopx/control_plane/todos/completion_validation_projection.py +57 -0
loopx/control_plane/todos/contract.py +1476 -0
loopx/control_plane/todos/decision_scope.py +554 -0
loopx/control_plane/todos/deferred_resume.py +546 -0
loopx/control_plane/todos/durable_completion.py +201 -0
loopx/control_plane/todos/event_writeback.py +484 -0
loopx/control_plane/todos/frontier_deadline.py +132 -0
loopx/control_plane/todos/handoff_gate.py +283 -0
loopx/control_plane/todos/handoff_mode.py +444 -0
loopx/control_plane/todos/handoff_note.py +202 -0
loopx/control_plane/todos/line_update.py +361 -0
loopx/control_plane/todos/list_projection.py +205 -0
loopx/control_plane/todos/markdown.py +199 -0
loopx/control_plane/todos/monitor_metadata.py +88 -0
loopx/control_plane/todos/mutation_authority.py +299 -0
loopx/control_plane/todos/projection.py +655 -0
loopx/control_plane/todos/quota_summary.py +1138 -0
loopx/control_plane/todos/route_continuation.py +267 -0
loopx/control_plane/todos/succession_warning.py +174 -0
loopx/control_plane/todos/summary_item.py +223 -0
loopx/control_plane/todos/text.py +30 -0
loopx/control_plane/todos/todo_index.py +226 -0
loopx/control_plane/todos/todo_summary.py +1458 -0
loopx/control_plane/todos/unblock_resume.py +326 -0
loopx/control_plane/todos/user_gate.py +263 -0
loopx/control_plane/todos/write_hint.py +63 -0
loopx/control_plane/todos/write_policy.py +135 -0
loopx/control_plane/turn_driver/__init__.py +85 -0
loopx/control_plane/turn_driver/codex_cli.py +502 -0
loopx/control_plane/turn_driver/driver.py +355 -0
loopx/control_plane/turn_driver/executor.py +1468 -0
loopx/control_plane/turn_driver/loop_controller.py +669 -0
loopx/control_plane/turn_driver/settlement.py +318 -0
loopx/control_plane/turn_driver/transaction.py +375 -0
loopx/control_plane/work_items/__init__.py +1 -0
loopx/control_plane/work_items/attention_fields.py +56 -0
loopx/control_plane/work_items/attention_item.py +77 -0
loopx/control_plane/work_items/attention_queue.py +322 -0
loopx/control_plane/work_items/attention_routing.py +213 -0
loopx/control_plane/work_items/autonomous_candidates.py +135 -0
loopx/control_plane/work_items/autonomous_replan_ack.py +276 -0
loopx/control_plane/work_items/autonomous_replan_obligation.py +786 -0
loopx/control_plane/work_items/backlog_hygiene.py +59 -0
loopx/control_plane/work_items/capability_monitor_fallback.py +221 -0
loopx/control_plane/work_items/delivery_batch_scale.py +66 -0
loopx/control_plane/work_items/delivery_outcome.py +152 -0
loopx/control_plane/work_items/delivery_signals.py +113 -0
loopx/control_plane/work_items/execution_obligation.py +235 -0
loopx/control_plane/work_items/goal_route_hint.py +320 -0
loopx/control_plane/work_items/interaction_contract.py +1540 -0
loopx/control_plane/work_items/issue_meta_surface.py +159 -0
loopx/control_plane/work_items/lifecycle.py +139 -0
loopx/control_plane/work_items/operator_inbox.py +266 -0
loopx/control_plane/work_items/outcome_followthrough.py +69 -0
loopx/control_plane/work_items/primary_action.py +326 -0
loopx/control_plane/work_items/progress_observation.py +630 -0
loopx/control_plane/work_items/project_asset.py +675 -0
loopx/control_plane/work_items/repair_delta.py +693 -0
loopx/control_plane/work_items/runtime_capability_reentry.py +168 -0
loopx/control_plane/work_items/semantic_replan_writeback.py +177 -0
loopx/control_plane/work_items/status_contract.py +49 -0
loopx/control_plane/work_items/task_graph.py +1046 -0
loopx/control_plane/work_items/task_lease.py +1254 -0
loopx/control_plane/work_items/task_lease_settlement.py +422 -0
loopx/control_plane/work_items/work_lane.py +510 -0
loopx/control_plane/work_items/work_lane_context.py +161 -0
loopx/demo.py +247 -0
loopx/diagnose.py +633 -0
loopx/doctor.py +1251 -0
loopx/domain_packs/__init__.py +1 -0
loopx/domain_packs/issue_fix.py +571 -0
loopx/domain_packs/ml_experiment.py +854 -0
loopx/domain_state.py +137 -0
loopx/dreaming.py +706 -0
loopx/entrypoint.py +16 -0
loopx/event_sourced_state.py +981 -0
loopx/execution_profile.py +286 -0
loopx/experiments/__init__.py +1 -0
loopx/experiments/planner_worker/__init__.py +1 -0
loopx/experiments/planner_worker/contract.py +523 -0
loopx/experiments/planner_worker/runtime.py +391 -0
loopx/experiments/planner_worker/traex.py +461 -0
loopx/explore_graph.py +11 -0
loopx/extensions/__init__.py +1 -0
loopx/extensions/bundled.py +28 -0
loopx/extensions/execution_envelope.py +126 -0
loopx/extensions/lark/__init__.py +11 -0
loopx/extensions/lark/event_collector.py +478 -0
loopx/extensions/lark/event_collector_runtime.py +506 -0
loopx/extensions/lark/event_inbox.py +454 -0
loopx/extensions/lark/extension.toml +88 -0
loopx/extensions/lark/goal_channel.py +44 -0
loopx/extensions/lark/goal_channel_contracts.py +388 -0
loopx/extensions/lark/goal_channel_lifecycle.py +218 -0
loopx/extensions/lark/goal_channel_runtime.py +792 -0
loopx/extensions/lark/goal_channel_setup.py +805 -0
loopx/extensions/lark/goal_channel_targets.py +215 -0
loopx/extensions/lark/goal_channel_transport.py +281 -0
loopx/extensions/lark/inbox_reactions.py +650 -0
loopx/extensions/lark/inbox_reply.py +430 -0
loopx/extensions/lark/presentation/__init__.py +11 -0
loopx/extensions/lark/presentation/explore_results.py +2276 -0
loopx/extensions/lark/presentation/explore_singleflight.py +127 -0
loopx/extensions/lark/presentation/explore_source_guard.py +121 -0
loopx/extensions/lark/presentation/explore_stage_document.py +703 -0
loopx/extensions/lark/presentation/explore_visual_integrity.py +122 -0
loopx/extensions/lark/presentation/explore_visual_readback.py +452 -0
loopx/extensions/lark/presentation/explore_visual_styles.py +156 -0
loopx/extensions/lark/presentation/issue_fix_surface.py +612 -0
loopx/extensions/lark/presentation/kanban.py +2791 -0
loopx/extensions/lark/presentation/message_card.py +112 -0
loopx/extensions/lark/presentation/periodic_report.py +261 -0
loopx/extensions/lark/presentation/projection_rows.py +600 -0
loopx/extensions/lark/presentation/record_io.py +95 -0
loopx/extensions/lark/presentation/sync_receipt.py +145 -0
loopx/extensions/lark/private_json.py +40 -0
loopx/extensions/lark/provider.py +86 -0
loopx/extensions/lark/reviewer_notification.py +604 -0
loopx/extensions/manifest.py +385 -0
loopx/extensions/openviking_periodic_report/__init__.py +17 -0
loopx/extensions/openviking_periodic_report/activation.py +173 -0
loopx/extensions/openviking_periodic_report/extension.toml +17 -0
loopx/extensions/openviking_periodic_report/provider.py +355 -0
loopx/extensions/openviking_periodic_report/sink.py +117 -0
loopx/extensions/openviking_semantic_preference/__init__.py +5 -0
loopx/extensions/openviking_semantic_preference/extension.toml +16 -0
loopx/extensions/openviking_semantic_preference/history_export.py +484 -0
loopx/extensions/openviking_semantic_preference/project_peer.py +68 -0
loopx/extensions/openviking_semantic_preference/provider.py +312 -0
loopx/extensions/presentation.py +979 -0
loopx/extensions/process_runtime.py +204 -0
loopx/extensions/readiness.py +168 -0
loopx/extensions/runtime.py +931 -0
loopx/extensions/scaffold.py +335 -0
loopx/feedback.py +581 -0
loopx/file_lock.py +382 -0
loopx/global_registry.py +842 -0
loopx/global_risks.py +970 -0
loopx/global_todos.py +568 -0
loopx/handoff_budget.py +28 -0
loopx/heartbeat_prequota.py +80 -0
loopx/heartbeat_prompt.py +159 -0
loopx/help_surface.py +516 -0
loopx/history.py +1507 -0
loopx/host_loop_activation.py +1311 -0
loopx/host_mode_planner.py +991 -0
loopx/install_contract.py +1 -0
loopx/interface_budget.py +196 -0
loopx/long_task_cadence.py +208 -0
loopx/materials.py +185 -0
loopx/ml_experiment.py +3 -0
loopx/onboarding.py +214 -0
loopx/opencode2_goal_mode/README.md +81 -0
loopx/opencode2_goal_mode/__init__.py +9 -0
loopx/opencode2_goal_mode/opencode2-goal-worker.mjs +1018 -0
loopx/opencode_goal_mode/README.md +99 -0
loopx/opencode_goal_mode/__init__.py +13 -0
loopx/opencode_goal_mode/goal-bridge-runtime.mjs +858 -0
loopx/opencode_goal_mode/loopx-goal.js +8 -0
loopx/operator_gate.py +420 -0
loopx/orchestration.py +127 -0
loopx/paths.py +59 -0
loopx/pi_goal_mode/README.md +67 -0
loopx/pi_goal_mode/__init__.py +13 -0
loopx/pi_goal_mode/loopx-goal.ts +254 -0
loopx/pi_goal_mode/pi-goal-loop-runtime.mjs +574 -0
loopx/pr_review.py +1206 -0
loopx/presentation/__init__.py +1 -0
loopx/presentation/explore_views.py +1334 -0
loopx/presentation/markdown.py +61 -0
loopx/presentation/projection_source_reconcile.py +140 -0
loopx/presentation/public_safety.py +42 -0
loopx/presentation/renderers/__init__.py +17 -0
loopx/presentation/renderers/goal_channel_html.py +269 -0
loopx/presentation/renderers/periodic_report_html.py +786 -0
loopx/presentation/renderers/periodic_report_markdown.py +184 -0
loopx/presentation/renderers/quota_event_markdown.py +116 -0
loopx/presentation/renderers/quota_markdown.py +1112 -0
loopx/presentation/renderers/status_markdown.py +1570 -0
loopx/presentation/renderers/trajectory_hygiene_markdown.py +39 -0
loopx/presentation/renderers/turn_envelope_markdown.py +33 -0
loopx/presentation/sinks/__init__.py +5 -0
loopx/presentation/sinks/openviking_periodic_report.py +7 -0
loopx/presentation/static_site.py +691 -0
loopx/presets.py +369 -0
loopx/project_alias.py +217 -0
loopx/project_map.py +589 -0
loopx/project_prompt.py +1153 -0
loopx/project_skill_cli.py +125 -0
loopx/project_skill_delivery.py +470 -0
loopx/project_uninstall.py +462 -0
loopx/promotion_gate.py +197 -0
loopx/quota.py +1197 -0
loopx/ready_score.py +413 -0
loopx/registry.py +621 -0
loopx/registry_writability.py +64 -0
loopx/release_candidate.py +148 -0
loopx/release_manifest.py +316 -0
loopx/repository_identity.py +100 -0
loopx/review_packet.py +1024 -0
loopx/rollout_event_log.py +505 -0
loopx/runtime.py +112 -0
loopx/self_update.py +750 -0
loopx/session_runtime.py +418 -0
loopx/skill_install_readback.py +500 -0
loopx/slash_command_install.py +1393 -0
loopx/slash_commands.py +264 -0
loopx/state_backup.py +573 -0
loopx/state_migration.py +350 -0
loopx/state_projection.py +809 -0
loopx/state_refresh.py +1416 -0
loopx/status.py +1383 -0
loopx/status_server.py +935 -0
loopx/summary_all.py +725 -0
loopx/terminal_bench_agent.py +2056 -0
loopx/thread_agent_binding.py +408 -0
loopx/todo_followups.py +168 -0
loopx/todo_suggestion_prompt.py +204 -0
loopx/todos.py +2229 -0
loopx/turn_identity.py +17 -0
loopx/upgrade.py +1083 -0
loopx/visible_governance.py +667 -0
loopx/visible_multi_agent_launcher.py +1253 -0
loopx/visible_multi_agent_tmux.py +429 -0
loopx/worker_bridge.py +1574 -0
loopx-0.4.8.dist-info/METADATA +708 -0
loopx-0.4.8.dist-info/RECORD +811 -0
loopx-0.4.8.dist-info/WHEEL +5 -0
loopx-0.4.8.dist-info/entry_points.txt +5 -0
loopx-0.4.8.dist-info/licenses/LICENSE +202 -0
loopx-0.4.8.dist-info/licenses/LICENSE-MIT +21 -0
loopx-0.4.8.dist-info/licenses/NOTICE +6 -0
loopx-0.4.8.dist-info/top_level.txt +1 -0

loopx/control_plane/todos/contract.py ADDED Viewed

@@ -0,0 +1,1476 @@
+from __future__ import annotations
+import hashlib
+import re
+from dataclasses import dataclass
+from enum import Enum
+from typing import Any, Callable
+from urllib.parse import quote, unquote
+from ...repository_identity import normalize_repository_identity
+TODO_TASK_PATTERN = re.compile(r"^\s*[-*]\s+\[([ xX-])\]\s+(.+?)\s*$")
+TODO_METADATA_PATTERN = re.compile(r"^\s*<!--\s*loopx:(?:todo\s+)?(?P<body>.*?)\s*-->\s*$")
+TODO_METADATA_TOKEN_PATTERN = re.compile(
+    r"(?<!\S)(?P<key>[a-z_][a-z0-9_]*)=(?P<value>[^\s<>]+)"
+)
+TODO_ACTION_KIND_PATTERN = re.compile(r"^[a-z][a-z0-9_-]{0,63}$")
+TODO_TASK_DOMAIN_PATTERN = re.compile(r"^[a-z][a-z0-9_.-]{0,63}$")
+TODO_ID_PATTERN = re.compile(r"^todo_[a-z0-9_-]{3,64}$")
+TODO_AGENT_CLAIM_PATTERN = re.compile(r"^[a-z][a-z0-9_.:@-]{0,79}$")
+TODO_CAPABILITY_PATTERN = re.compile(r"^[a-z][a-z0-9_:-]{0,63}$")
+TODO_CAPABILITY_BINDING_REF_PATTERN = re.compile(
+    r"^[a-z][a-z0-9_.-]{0,31}:[a-z][a-z0-9_.:-]{2,95}$"
+)
+TODO_REPLAN_OBLIGATION_ID_PATTERN = re.compile(r"^replan-[a-f0-9]{16}$")
+TODO_EXPLORE_RESULT_NODE_REF_PATTERN = re.compile(r"^[A-Za-z][A-Za-z0-9_.:-]{0,95}$")
+TODO_EXPLORE_RESULT_NODE_REF_LIMIT = 8
+TODO_DECISION_SCOPE_KEY_PATTERN = re.compile(r"^(?:\*|[a-z0-9][a-z0-9_.:@*/-]{0,95})$")
+TODO_RESUME_KIND_TODO_DONE = "todo_done"
+TODO_RESUME_KIND_PR_MERGED = "pr_merged"
+TODO_RESUME_KIND_CAPACITY_AVAILABLE = "capacity_available"
+TODO_RESUME_KIND_VALUES = {
+    TODO_RESUME_KIND_TODO_DONE,
+    TODO_RESUME_KIND_PR_MERGED,
+    TODO_RESUME_KIND_CAPACITY_AVAILABLE,
+}
+TODO_RESUME_WHEN_PATTERN = re.compile(r"^[a-z][a-z0-9_-]{0,31}(?::[a-z0-9_.:@-]{1,96})?$")
+TODO_RESUME_PR_MERGED_PATTERN = re.compile(
+    r"^pr_merged:(?:(?:[a-z0-9_.-]{1,80})/(?:[a-z0-9_.-]{1,100}))?#[1-9][0-9]{0,8}$"
+)
+TODO_WRITE_SCOPE_MAX_CHARS = 160
+TODO_MONITOR_METADATA_FIELDS = (
+    "target_key",
+    "cadence",
+    "next_due_at",
+    "expires_at",
+    "last_checked_at",
+    "result_hash",
+    "consecutive_no_change",
+    "material_change",
+    "max_no_change_before_replan",
+    "watch_only",
+)
+def normalize_todo_watch_only(value: Any) -> bool | None:
+    if value is True or str(value or "").strip().lower() == "true":
+        return True
+    if value is False or str(value or "").strip().lower() == "false":
+        return False
+    return None
+TODO_TASK_CLASS_ADVANCEMENT = "advancement_task"
+TODO_TASK_CLASS_MONITOR = "continuous_monitor"
+TODO_TASK_CLASS_USER_GATE = "user_gate"
+TODO_TASK_CLASS_USER_ACTION = "user_action"
+TODO_TASK_CLASS_BLOCKER = "blocker"
+TODO_TASK_CLASS_VALUES = {
+    TODO_TASK_CLASS_ADVANCEMENT,
+    TODO_TASK_CLASS_MONITOR,
+    TODO_TASK_CLASS_USER_GATE,
+    TODO_TASK_CLASS_USER_ACTION,
+    TODO_TASK_CLASS_BLOCKER,
+}
+def resolve_next_user_task_class(
+    next_user_todo: str | None,
+    next_user_task_class: str | None,
+) -> str | None:
+    if not next_user_todo:
+        if next_user_task_class:
+            raise ValueError("--next-user-task-class requires --next-user-todo")
+        return None
+    if not next_user_task_class:
+        raise ValueError(
+            "--next-user-todo requires explicit --next-user-task-class "
+            "user_action|user_gate"
+        )
+    if next_user_task_class not in {
+        TODO_TASK_CLASS_USER_GATE,
+        TODO_TASK_CLASS_USER_ACTION,
+    }:
+        raise ValueError(
+            "next_user_task_class must be one of: user_action, user_gate"
+        )
+    return next_user_task_class
+TODO_DECISION_SCOPE_SCHEMA_VERSION = "decision_scope_v0"
+TODO_DECISION_SCOPE_OUTCOME_SCHEMA_VERSION = "todo_decision_scope_outcome_v0"
+TODO_DECISION_OUTCOME_VALUES = {"approve", "reject", "cancel"}
+TODO_DECISION_SCOPE_KIND_VALUES = {
+    "private_read",
+    "write_scope",
+    "resource",
+    "production",
+    "public_claim",
+    "direction",
+    "other",
+}
+TODO_DECISION_SCOPE_GRANULARITY_VALUES = {
+    "action",
+    "lane",
+    "goal",
+    "project",
+    "global",
+}
+TODO_STATUS_OPEN = "open"
+TODO_STATUS_DONE = "done"
+TODO_STATUS_BLOCKED = "blocked"
+TODO_STATUS_DEFERRED = "deferred"
+TODO_STATUS_VALUES = {
+    TODO_STATUS_OPEN,
+    TODO_STATUS_DONE,
+    TODO_STATUS_BLOCKED,
+    TODO_STATUS_DEFERRED,
+}
+TODO_TERMINAL_STATUS_VALUES = {TODO_STATUS_DONE, TODO_STATUS_DEFERRED}
+TODO_LEGACY_TERMINAL_STATUS_VALUES = {"completed", "closed", "archived"}
+TODO_ACTION_KIND_ADVANCEMENT_VALUES = {
+    "advance",
+    "analyze",
+    "benchmark_run",
+    "codex_run",
+    "compact_blocker_writeback",
+    "compare",
+    "execute",
+    "fix",
+    "implement",
+    "rebuild",
+    "rebuild_score",
+    "repair",
+    "run",
+    "run_eval",
+    "test",
+    "validate",
+    "writeback",
+}
+TODO_ACTION_KIND_MONITOR_VALUES = {
+    "external_evidence",
+    "monitor",
+    "observe",
+    "poll",
+    "watch",
+}
+class TodoContinuationPolicy(str, Enum):
+    INDEPENDENT_HANDOFF = "independent_handoff"
+    SAME_AGENT_NON_DELIVERY = "same_agent_non_delivery"
+TODO_CONTINUATION_POLICY_VALUES = {
+    policy.value for policy in TodoContinuationPolicy
+}
+TODO_REMOVED_REVIEW_CONTINUATION_POLICY_VALUES = {
+    "primary_review",
+    "review_handoff",
+}
+TODO_HARD_MONITOR_PATTERNS = (
+    re.compile(r"(?i)\bdo not\b.*\b(?:launch|run|execute|start)\b.*\buntil\b"),
+    re.compile(r"(?i)\b(?:only|just)\b.*\b(?:after|when|once)\b.*\b(?:owner|user|credential|approval|prerequisite|evidence)\b"),
+    re.compile(r"(?i)\b(?:credential|gcp|gcs|gcp_project|gcp_sa_key|gs://)\b.*\b(?:missing|required|provide|proof|prerequisite|gate|gated)\b"),
+    re.compile(r"(?i)\b(?:readiness|proof)\b.*\bbefore any formal\b.*\brun\b"),
+    re.compile(r"(?i)\bremaining formal\b.*\bpath\b"),
+    re.compile(r"(?i)\b(?:route|input)\b.*\babsent\b"),
+    re.compile(r"(?i)\b0\b.*\b(?:candidate|candidates)\b"),
+)
+TODO_ADVANCEMENT_OVERRIDE_PATTERNS = (
+    re.compile(
+        r"(?i)(?:^|[:：]\s*)(?:implement|add|make|fix|build|wire|define|compare|run|"
+        r"execute|test|validate|rebuild|repair|archive|publish|merge|write|attribute|"
+        r"collect|aggregate|generate|produce|materialize|rerun|repeat|eval|evaluate|score)\b"
+    ),
+    re.compile(
+        r"(?i)\b(?:implementation slice|validation-backed patch|smoke fixture|"
+        r"regression suite|readiness scan|source preflight|setup-readiness scan)\b"
+    ),
+)
+TODO_BLOCKED_MONITOR_PATTERNS = (
+    *TODO_HARD_MONITOR_PATTERNS,
+    re.compile(r"(?i)\b(?:blocked|gated|waiting)\b.*\b(?:owner|user|credential|substrate|proof|prerequisite|evidence)\b"),
+)
+TODO_MONITOR_PATTERNS = (
+    re.compile(r"(?i)\bdependency monitor\b"),
+    re.compile(r"(?i)\bobservation lane\b"),
+    re.compile(r"(?i)(?:^|[:：]\s*)observe\b"),
+    re.compile(r"(?i)(?:^|[:：]\s*)poll\b"),
+    re.compile(r"(?i)(?:^|[:：]\s*)watch\b"),
+    re.compile(r"(?i)\bmonitor-only\b"),
+    *TODO_BLOCKED_MONITOR_PATTERNS,
+)
+TODO_ADVANCEMENT_PATTERNS = (
+    *TODO_ADVANCEMENT_OVERRIDE_PATTERNS,
+    re.compile(r"(?i)\b(?:task|validation hypothesis|validation step|bounded step|learning run)\b"),
+)
+NEXT_ACTION_HARD_MONITOR_PATTERNS = (
+    re.compile(r"(?i)\bdo not\b.*\b(?:launch|run|execute|start)\b.*\buntil\b"),
+    re.compile(r"(?i)\b(?:waiting|blocked|gated)\b.*\b(?:owner|user|credential|approval|prerequisite|evidence)\b"),
+)
+NEXT_ACTION_ADVANCEMENT_HINT_PATTERNS = (
+    re.compile(r"(?i)\bplanning/self[- ]?repair\b"),
+    re.compile(r"(?i)\bplanning[- ]?self[- ]?repair\b"),
+    re.compile(r"(?i)\bself[- ]?repair capability\b"),
+    re.compile(r"(?i)\badvance(?:ment)?[- ]class\b"),
+    re.compile(r"(?i)\badvance primary backlog\b"),
+    re.compile(r"(?i)\bnext eligible advancement turn\b"),
+    re.compile(r"(?i)\bpackage\b.*\b(?:adapter|contract|artifact)\b"),
+    re.compile(r"(?i)\bselect\b.*\b(?:task|validation hypothesis|validation step)\b"),
+    re.compile(r"(?i)\b(?:local-material-ready|material-ready)\b.*\b(?:task|run|validation)\b"),
+    re.compile(r"(?i)\b(?:run|test)\b.*\bvalidation hypothesis\b"),
+    re.compile(
+        r"(?i)\b(?:collect|aggregate|generate|produce|materialize)\b.*\b(?:then|and)\b.*\b"
+        r"(?:run|rerun|repeat|rebuild|score|scorer|gate|eval|evaluate|validate)\b"
+    ),
+    re.compile(
+        r"(?i)(?:^|[.;:：]\s*)(?:run|execute|test|validate|rebuild|compare|implement|fix|"
+        r"write|package|collect|aggregate|generate|produce|materialize|rerun|repeat|"
+        r"eval|evaluate|score)\b"
+    ),
+)
+def compact_todo_text(value: Any) -> str:
+    return " ".join(str(value or "").strip().split())
+def normalize_todo_action_kind(value: Any) -> str | None:
+    candidate = str(value or "").strip().lower()
+    if not candidate:
+        return None
+    if TODO_ACTION_KIND_PATTERN.match(candidate):
+        return candidate
+    return None
+def normalize_todo_task_domain(value: Any) -> str | None:
+    candidate = str(value or "").strip().lower()
+    if not candidate:
+        return None
+    if TODO_TASK_DOMAIN_PATTERN.fullmatch(candidate):
+        return candidate
+    return None
+def normalize_todo_replan_obligation_id(value: Any) -> str | None:
+    candidate = str(value or "").strip()
+    if not candidate:
+        return None
+    if TODO_REPLAN_OBLIGATION_ID_PATTERN.fullmatch(candidate):
+        return candidate
+    return None
+def normalize_todo_capability_binding_ref(value: Any) -> str | None:
+    candidate = str(value or "").strip().lower()
+    if not candidate:
+        return None
+    if TODO_CAPABILITY_BINDING_REF_PATTERN.fullmatch(candidate):
+        return candidate
+    return None
+def normalize_todo_task_repository(value: Any) -> str | None:
+    candidate = str(value or "").strip()
+    if not candidate:
+        return None
+    try:
+        return normalize_repository_identity(candidate)
+    except ValueError:
+        return None
+def normalize_todo_continuation_policy(value: Any) -> str | None:
+    candidate = str(value or "").strip().lower()
+    if candidate in TODO_CONTINUATION_POLICY_VALUES:
+        return candidate
+    return None
+def normalize_removed_todo_continuation_policy(value: Any) -> str | None:
+    candidate = str(value or "").strip().lower()
+    if candidate in TODO_REMOVED_REVIEW_CONTINUATION_POLICY_VALUES:
+        return candidate
+    return None
+def resolve_todo_continuation_policy(
+    value: Any,
+    *,
+    action_kind: Any = None,
+) -> TodoContinuationPolicy:
+    del action_kind
+    explicit = normalize_todo_continuation_policy(value)
+    if explicit:
+        return TodoContinuationPolicy(explicit)
+    return TodoContinuationPolicy.INDEPENDENT_HANDOFF
+def normalize_todo_claimed_by(value: Any) -> str | None:
+    candidate = compact_todo_text(value).lower().replace(" ", "-")
+    if candidate and TODO_AGENT_CLAIM_PATTERN.match(candidate):
+        return candidate
+    return None
+def normalize_todo_blocks_agent(value: Any) -> str | None:
+    return normalize_todo_claimed_by(value)
+def normalize_todo_bound_agent(value: Any) -> str | None:
+    return normalize_todo_claimed_by(value)
+def normalize_todo_goal_bound(value: Any) -> bool | None:
+    return normalize_todo_global_gate(value)
+def normalize_todo_excluded_agents(value: Any) -> list[str]:
+    if value is None:
+        return []
+    if isinstance(value, str):
+        candidates = value.split(",")
+    elif isinstance(value, (list, tuple, set)):
+        candidates = list(value)
+    else:
+        candidates = [value]
+    return sorted(
+        {
+            agent_id
+            for candidate in candidates
+            for agent_id in [normalize_todo_claimed_by(candidate)]
+            if agent_id
+        }
+    )
+def require_todo_excluded_agents(
+    value: Any,
+    *,
+    field: str = "excluded_agents",
+) -> list[str]:
+    if value is None:
+        return []
+    if isinstance(value, str):
+        candidates = value.split(",")
+    elif isinstance(value, (list, tuple, set)):
+        candidates = list(value)
+    else:
+        candidates = [value]
+    normalized: set[str] = set()
+    for candidate in candidates:
+        agent_id = normalize_todo_claimed_by(candidate)
+        if not agent_id:
+            raise ValueError(
+                f"{field} must contain public-safe agent tokens such as codex-side-bypass"
+            )
+        normalized.add(agent_id)
+    return sorted(normalized)
+def normalize_todo_resume_when(value: Any) -> str | None:
+    candidate = compact_todo_text(value).lower()
+    if candidate and TODO_RESUME_PR_MERGED_PATTERN.match(candidate):
+        return candidate
+    if candidate and TODO_RESUME_WHEN_PATTERN.match(candidate):
+        return candidate
+    return None
+def normalize_supported_todo_resume_when(value: Any) -> str | None:
+    """Normalize resume conditions that LoopX can safely evaluate."""
+    candidate = normalize_todo_resume_when(value)
+    if not candidate:
+        return None
+    kind, separator, target = candidate.partition(":")
+    if kind == TODO_RESUME_KIND_TODO_DONE:
+        return candidate if separator and normalize_todo_id(target) else None
+    if kind == TODO_RESUME_KIND_PR_MERGED:
+        return candidate if TODO_RESUME_PR_MERGED_PATTERN.match(candidate) else None
+    if kind == TODO_RESUME_KIND_CAPACITY_AVAILABLE:
+        return candidate if separator and TODO_CAPABILITY_PATTERN.match(target) else None
+    return None
+def require_supported_todo_resume_when(value: Any) -> str | None:
+    if value is None or not str(value).strip():
+        return None
+    normalized = normalize_supported_todo_resume_when(value)
+    if normalized:
+        return normalized
+    raise ValueError(
+        "resume_when must use a supported condition: todo_done:<todo_id>, "
+        "pr_merged:[owner/repo]#<number>, or capacity_available:<capability>"
+    )
+def normalize_todo_no_followup(value: Any) -> bool | None:
+    if isinstance(value, bool):
+        return value
+    candidate = compact_todo_text(value).lower()
+    if candidate in {"1", "true", "yes", "y", "no_followup", "no-followup"}:
+        return True
+    if candidate in {"0", "false", "no", "n"}:
+        return False
+    return None
+def normalize_todo_global_gate(value: Any) -> bool | None:
+    if isinstance(value, bool):
+        return value
+    candidate = compact_todo_text(value).lower()
+    if candidate in {"1", "true", "yes", "y", "global_gate", "global-gate"}:
+        return True
+    if candidate in {"0", "false", "no", "n"}:
+        return False
+    return None
+def normalize_todo_id(value: Any) -> str | None:
+    candidate = str(value or "").strip().lower()
+    if candidate and TODO_ID_PATTERN.match(candidate):
+        return candidate
+    return None
+def normalize_todo_id_list(value: Any) -> list[str]:
+    if value is None:
+        return []
+    raw_values = value if isinstance(value, (list, tuple, set)) else [value]
+    todo_ids: list[str] = []
+    for raw_value in raw_values:
+        for match in re.findall(r"\btodo_[A-Za-z0-9_-]+\b", str(raw_value or "")):
+            todo_id = normalize_todo_id(match)
+            if todo_id and todo_id not in todo_ids:
+                todo_ids.append(todo_id)
+        todo_id = normalize_todo_id(raw_value)
+        if todo_id and todo_id not in todo_ids:
+            todo_ids.append(todo_id)
+    return todo_ids
+def merge_todo_id_lists(*values: Any) -> list[str]:
+    todo_ids: list[str] = []
+    for value in values:
+        for todo_id in normalize_todo_id_list(value):
+            if todo_id not in todo_ids:
+                todo_ids.append(todo_id)
+    return todo_ids
+def normalize_required_write_scopes(value: Any) -> list[str]:
+    if value is None:
+        return []
+    if isinstance(value, (list, tuple, set)):
+        raw_values = [str(item or "") for item in value]
+    else:
+        raw_values = re.split(r"[,;|]", str(value or ""))
+    scopes: list[str] = []
+    seen: set[str] = set()
+    for raw in raw_values:
+        scope = compact_todo_text(raw)
+        if not scope:
+            continue
+        if len(scope) > TODO_WRITE_SCOPE_MAX_CHARS:
+            continue
+        if scope.startswith(("/", "~")) or ".." in scope.split("/"):
+            continue
+        if re.search(r"[\s<>]", scope):
+            continue
+        if scope in seen:
+            continue
+        seen.add(scope)
+        scopes.append(scope)
+    return scopes
+def normalize_required_capabilities(value: Any) -> list[str]:
+    if value is None:
+        return []
+    if isinstance(value, (list, tuple, set)):
+        raw_values = [str(item or "") for item in value]
+    else:
+        raw_values = re.split(r"[,;|]", str(value or ""))
+    capabilities: list[str] = []
+    seen: set[str] = set()
+    for raw in raw_values:
+        capability = compact_todo_text(raw).lower().replace("-", "_").replace(" ", "_")
+        if not capability:
+            continue
+        if not TODO_CAPABILITY_PATTERN.match(capability):
+            continue
+        if capability in seen:
+            continue
+        seen.add(capability)
+        capabilities.append(capability)
+    return capabilities
+def normalize_target_capabilities(value: Any) -> list[str]:
+    return normalize_required_capabilities(value)
+def normalize_explore_result_node_refs(value: Any) -> list[str]:
+    """Normalize explicit public-safe Explore node ids attached to a todo."""
+    if value is None:
+        return []
+    if isinstance(value, (list, tuple, set)):
+        raw_values = [str(item or "") for item in value]
+    else:
+        raw_values = re.split(r"[,;|]", str(value or ""))
+    refs: list[str] = []
+    for raw in raw_values:
+        ref = compact_todo_text(raw)
+        if not ref or not TODO_EXPLORE_RESULT_NODE_REF_PATTERN.match(ref):
+            continue
+        if ref not in refs:
+            refs.append(ref)
+        if len(refs) >= TODO_EXPLORE_RESULT_NODE_REF_LIMIT:
+            break
+    return refs
+def replan_successor_semantic_binding(
+    *,
+    action_kind: Any,
+    target_key: Any,
+    explore_result_node_refs: Any,
+) -> dict[str, Any] | None:
+    """Return the typed executable identity of a replan successor.
+    An obligation id establishes causality, but it does not turn a planning
+    instruction into executable work.  A successor also needs an explicit
+    action and at least one stable target identity.
+    """
+    safe_action_kind = normalize_todo_action_kind(action_kind)
+    safe_target_key = compact_todo_text(target_key) or None
+    safe_explore_refs = normalize_explore_result_node_refs(
+        explore_result_node_refs
+    )
+    if not safe_action_kind or not (safe_target_key or safe_explore_refs):
+        return None
+    binding: dict[str, Any] = {"action_kind": safe_action_kind}
+    if safe_target_key:
+        binding["target_key"] = safe_target_key
+    if safe_explore_refs:
+        binding["explore_result_node_refs"] = safe_explore_refs
+    return binding
+def normalize_todo_decision_scope(value: Any) -> dict[str, str] | None:
+    """Normalize the compact decision-scope metadata token.
+    Markdown todo metadata stores the v0 shape as
+    ``kind:granularity:scope_key`` so authors do not need to embed JSON in
+    active-state comments. Status and quota expose the normalized object.
+    """
+    raw_kind: Any = None
+    raw_granularity: Any = None
+    raw_scope_key: Any = None
+    raw_decision_id: Any = None
+    if isinstance(value, dict):
+        raw_kind = value.get("kind")
+        raw_granularity = value.get("granularity")
+        raw_scope_key = value.get("scope_key")
+        raw_decision_id = value.get("decision_id")
+    else:
+        candidate = compact_todo_text(value).lower()
+        parts = candidate.split(":", 2)
+        if len(parts) != 3:
+            return None
+        raw_kind, raw_granularity, raw_scope_key = parts
+    kind = compact_todo_text(raw_kind).lower()
+    granularity = compact_todo_text(raw_granularity).lower()
+    scope_key = compact_todo_text(raw_scope_key).lower()
+    if kind not in TODO_DECISION_SCOPE_KIND_VALUES:
+        return None
+    if granularity not in TODO_DECISION_SCOPE_GRANULARITY_VALUES:
+        return None
+    if not TODO_DECISION_SCOPE_KEY_PATTERN.match(scope_key):
+        return None
+    payload: dict[str, str] = {
+        "schema_version": TODO_DECISION_SCOPE_SCHEMA_VERSION,
+        "kind": kind,
+        "granularity": granularity,
+        "scope_key": scope_key,
+    }
+    decision_id = normalize_todo_id(raw_decision_id)
+    if decision_id:
+        payload["decision_id"] = decision_id
+    return payload
+def normalize_todo_decision_outcome(value: Any) -> str | None:
+    candidate = compact_todo_text(value).lower()
+    return candidate if candidate in TODO_DECISION_OUTCOME_VALUES else None
+def require_todo_decision_outcome(value: Any) -> str:
+    outcome = normalize_todo_decision_outcome(value)
+    if not outcome:
+        raise ValueError(
+            "decision_outcome must be one of: "
+            + ", ".join(sorted(TODO_DECISION_OUTCOME_VALUES))
+        )
+    return outcome
+def require_todo_decision_scope(value: Any) -> dict[str, str]:
+    scope = normalize_todo_decision_scope(value)
+    if not scope:
+        raise ValueError(
+            "decision_scope must use kind:granularity:scope_key, such as "
+            "private_read:project:authority"
+        )
+    return scope
+def _normalize_todo_required_decision_scopes(
+    value: Any,
+    *,
+    strict: bool,
+) -> list[dict[str, str]]:
+    if value is None:
+        return []
+    if isinstance(value, (list, tuple, set)):
+        raw_values = list(value)
+    else:
+        raw_values = re.split(r"[,;|]", str(value or ""))
+    scopes: list[dict[str, str]] = []
+    seen: set[tuple[str, str, str]] = set()
+    for raw in raw_values:
+        scope = normalize_todo_decision_scope(raw)
+        if not scope:
+            if strict:
+                raise ValueError(
+                    "required_decision_scopes must contain "
+                    "kind:granularity:scope_key tokens"
+                )
+            continue
+        identity = (scope["kind"], scope["granularity"], scope["scope_key"])
+        if identity in seen:
+            continue
+        seen.add(identity)
+        scopes.append(scope)
+    return scopes
+def normalize_todo_required_decision_scopes(value: Any) -> list[dict[str, str]]:
+    return _normalize_todo_required_decision_scopes(value, strict=False)
+def require_todo_required_decision_scopes(value: Any) -> list[dict[str, str]]:
+    return _normalize_todo_required_decision_scopes(value, strict=True)
+def decision_scope_metadata_value(value: Any) -> str | None:
+    if value is None:
+        return None
+    scope = require_todo_decision_scope(value)
+    return f"{scope['kind']}:{scope['granularity']}:{scope['scope_key']}"
+def required_decision_scopes_metadata_value(value: Any) -> str | None:
+    if value is None:
+        return None
+    scopes = require_todo_required_decision_scopes(value)
+    if not scopes:
+        return None
+    return ",".join(
+        f"{scope['kind']}:{scope['granularity']}:{scope['scope_key']}"
+        for scope in scopes
+    )
+def normalize_todo_decision_scope_outcomes(value: Any) -> list[dict[str, Any]]:
+    if value is None:
+        return []
+    raw_values = list(value) if isinstance(value, (list, tuple, set)) else [value]
+    if isinstance(value, str):
+        raw_values = [item for item in value.split(",") if item]
+    outcomes: list[dict[str, Any]] = []
+    positions: dict[tuple[str, str, str], int] = {}
+    for raw in raw_values:
+        raw_outcome: Any = None
+        raw_scope: Any = None
+        raw_source_todo_id: Any = None
+        if isinstance(raw, dict):
+            raw_outcome = raw.get("outcome")
+            raw_scope = raw.get("decision_scope") or raw.get("scope")
+            raw_source_todo_id = raw.get("source_todo_id")
+        else:
+            parts = str(raw or "").split("|", 2)
+            if len(parts) == 3:
+                raw_outcome, raw_scope, raw_source_todo_id = parts
+        outcome = normalize_todo_decision_outcome(raw_outcome)
+        scope = normalize_todo_decision_scope(raw_scope)
+        source_todo_id = normalize_todo_id(raw_source_todo_id)
+        if not outcome or not scope or not source_todo_id:
+            continue
+        payload = {
+            "schema_version": TODO_DECISION_SCOPE_OUTCOME_SCHEMA_VERSION,
+            "outcome": outcome,
+            "decision_scope": scope,
+            "source_todo_id": source_todo_id,
+        }
+        identity = (scope["kind"], scope["granularity"], scope["scope_key"])
+        if identity in positions:
+            outcomes[positions[identity]] = payload
+        else:
+            positions[identity] = len(outcomes)
+            outcomes.append(payload)
+    return outcomes
+def decision_scope_outcomes_metadata_value(value: Any) -> str | None:
+    outcomes = normalize_todo_decision_scope_outcomes(value)
+    if not outcomes:
+        return None
+    return ",".join(
+        "|".join(
+            (
+                item["outcome"],
+                ":".join(
+                    (
+                        item["decision_scope"]["kind"],
+                        item["decision_scope"]["granularity"],
+                        item["decision_scope"]["scope_key"],
+                    )
+                ),
+                item["source_todo_id"],
+            )
+        )
+        for item in outcomes
+    )
+def build_todo_id(
+    *,
+    role: Any,
+    source_section: Any,
+    index: Any,
+    text: Any,
+) -> str:
+    identity = "|".join(str(part or "") for part in (role, source_section, index, compact_todo_text(text)))
+    return f"todo_{hashlib.sha1(identity.encode('utf-8')).hexdigest()[:12]}"
+def normalize_explicit_todo_task_class(value: Any) -> str | None:
+    candidate = str(value or "").strip().lower()
+    if candidate in TODO_TASK_CLASS_VALUES:
+        return candidate
+    return None
+def normalize_todo_status(value: Any) -> str | None:
+    candidate = str(value or "").strip().lower()
+    if candidate in TODO_STATUS_VALUES:
+        return candidate
+    return None
+def todo_done_for_status(status: Any) -> bool:
+    return normalize_todo_status(status) in TODO_TERMINAL_STATUS_VALUES
+def todo_terminal_for_status(status: Any) -> bool:
+    candidate = str(status or "").strip().lower()
+    return (
+        normalize_todo_status(candidate) in TODO_TERMINAL_STATUS_VALUES
+        or candidate in TODO_LEGACY_TERMINAL_STATUS_VALUES
+    )
+def todo_status_from_marker(marker: Any) -> str:
+    candidate = str(marker or "").strip().lower()
+    if candidate == "x":
+        return TODO_STATUS_DONE
+    if candidate == "-":
+        return TODO_STATUS_DEFERRED
+    return TODO_STATUS_OPEN
+def todo_marker_for_status(status: Any) -> str:
+    normalized = normalize_todo_status(status) or TODO_STATUS_OPEN
+    if normalized == TODO_STATUS_DEFERRED:
+        return "-"
+    if normalized == TODO_STATUS_DONE:
+        return "x"
+    return " "
+def encode_metadata_value(value: Any) -> str:
+    compact = compact_todo_text(value)
+    return quote(compact, safe="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_.:-")
+def decode_metadata_value(value: Any) -> str:
+    return compact_todo_text(unquote(str(value or "")))
+def parse_todo_metadata_tokens(line: str) -> list[tuple[str, str]] | None:
+    match = TODO_METADATA_PATTERN.match(line)
+    if not match:
+        return None
+    return [
+        (
+            token.group("key"),
+            decode_metadata_value(token.group("value")),
+        )
+        for token in TODO_METADATA_TOKEN_PATTERN.finditer(match.group("body"))
+    ]
+MetadataValueNormalizer = Callable[[Any], Any]
+MetadataValueEncoder = Callable[[Any], str | None]
+MetadataInvalidPredicate = Callable[[Any], bool]
+def _truthy_value(value: Any) -> Any:
+    return value if value else None
+def _nonempty_metadata_text(value: Any) -> str | None:
+    text = compact_todo_text(value)
+    return text or None
+def _optional_output_bool(value: Any) -> bool | None:
+    return None if value is None else bool(value)
+def _metadata_bool_text(value: Any) -> str:
+    return "true" if value else "false"
+def _metadata_csv(value: Any) -> str:
+    return ",".join(str(item) for item in value)
+def _normalize_optional_decision_scope_for_write(value: Any) -> dict[str, str] | None:
+    return None if value is None else require_todo_decision_scope(value)
+def _normalize_optional_required_decision_scopes_for_write(
+    value: Any,
+) -> list[dict[str, str]]:
+    return [] if value is None else require_todo_required_decision_scopes(value)
+@dataclass(frozen=True)
+class _TodoMetadataField:
+    key: str
+    read_normalizer: MetadataValueNormalizer
+    write_normalizer: MetadataValueNormalizer | None = None
+    encoder: MetadataValueEncoder = str
+    invalid_when: MetadataInvalidPredicate = bool
+    invalid_message: str | None = None
+    read_fallback_key: str | None = None
+    read_fallback_normalizer: MetadataValueNormalizer | None = None
+    block_field: bool = True
+    def normalize_for_write(self, value: Any) -> Any:
+        normalizer = self.write_normalizer or self.read_normalizer
+        normalized = normalizer(value)
+        if (
+            self.invalid_message
+            and self.invalid_when(value)
+            and not _metadata_value_is_present(normalized)
+        ):
+            raise ValueError(self.invalid_message)
+        return normalized
+def _metadata_value_is_present(value: Any) -> bool:
+    return value is not None and value != "" and value != []
+_TODO_METADATA_FIELD_SCHEMA = (
+    _TodoMetadataField(
+        "todo_id",
+        normalize_todo_id,
+        invalid_message=(
+            "todo_id must use the public token shape "
+            "todo_<letters-digits-underscore-hyphen>"
+        ),
+    ),
+    _TodoMetadataField(
+        "status",
+        normalize_todo_status,
+        invalid_message=(
+            "todo status must be one of: " + ", ".join(sorted(TODO_STATUS_VALUES))
+        ),
+    ),
+    _TodoMetadataField(
+        "task_class",
+        normalize_explicit_todo_task_class,
+        invalid_message=(
+            "todo task_class must be one of: "
+            + ", ".join(sorted(TODO_TASK_CLASS_VALUES))
+        ),
+    ),
+    _TodoMetadataField(
+        "action_kind",
+        normalize_todo_action_kind,
+        invalid_message=(
+            "todo action_kind must be a public-safe token: lowercase letters, "
+            "digits, '_' or '-'"
+        ),
+    ),
+    _TodoMetadataField(
+        "task_domain",
+        normalize_todo_task_domain,
+        invalid_message=(
+            "todo task_domain must be a public-safe token: lowercase letters, "
+            "digits, '_', '-' or '.'"
+        ),
+    ),
+    _TodoMetadataField(
+        "capability_binding_ref",
+        normalize_todo_capability_binding_ref,
+        invalid_message=(
+            "capability_binding_ref must be a public-safe namespaced token"
+        ),
+    ),
+    _TodoMetadataField(
+        "task_repository",
+        normalize_todo_task_repository,
+        invalid_message=(
+            "todo task_repository must be a credential-free Git remote or canonical "
+            "git:<host>/<path> identity"
+        ),
+    ),
+    _TodoMetadataField(
+        "continuation_policy",
+        normalize_todo_continuation_policy,
+        invalid_message=(
+            "todo continuation_policy must be one of: "
+            + ", ".join(sorted(TODO_CONTINUATION_POLICY_VALUES))
+        ),
+        read_fallback_key="removed_continuation_policy",
+        read_fallback_normalizer=normalize_removed_todo_continuation_policy,
+    ),
+    _TodoMetadataField(
+        "removed_continuation_policy",
+        normalize_removed_todo_continuation_policy,
+        invalid_message=(
+            "removed_continuation_policy must be one of: "
+            + ", ".join(sorted(TODO_REMOVED_REVIEW_CONTINUATION_POLICY_VALUES))
+        ),
+        block_field=False,
+    ),
+    _TodoMetadataField(
+        "required_write_scopes",
+        normalize_required_write_scopes,
+        encoder=_metadata_csv,
+        invalid_message=(
+            "required_write_scopes must contain public-safe relative scope tokens"
+        ),
+    ),
+    _TodoMetadataField(
+        "required_capabilities",
+        normalize_required_capabilities,
+        encoder=_metadata_csv,
+        invalid_message=(
+            "required_capabilities must contain public-safe capability tokens"
+        ),
+    ),
+    _TodoMetadataField(
+        "target_capabilities",
+        normalize_target_capabilities,
+        encoder=_metadata_csv,
+        invalid_message=(
+            "target_capabilities must contain public-safe capability tokens"
+        ),
+    ),
+    _TodoMetadataField(
+        "explore_result_node_refs",
+        normalize_explore_result_node_refs,
+        encoder=_metadata_csv,
+        invalid_message=(
+            "explore_result_node_refs must contain public-safe Explore node ids"
+        ),
+    ),
+    _TodoMetadataField(
+        "decision_scope",
+        normalize_todo_decision_scope,
+        write_normalizer=_normalize_optional_decision_scope_for_write,
+        encoder=decision_scope_metadata_value,
+        invalid_when=lambda value: value is not None,
+    ),
+    _TodoMetadataField(
+        "required_decision_scopes",
+        normalize_todo_required_decision_scopes,
+        write_normalizer=_normalize_optional_required_decision_scopes_for_write,
+        encoder=required_decision_scopes_metadata_value,
+    ),
+    _TodoMetadataField(
+        "decision_outcome",
+        normalize_todo_decision_outcome,
+        invalid_message=(
+            "decision_outcome must be one of: "
+            + ", ".join(sorted(TODO_DECISION_OUTCOME_VALUES))
+        ),
+    ),
+    _TodoMetadataField(
+        "decision_scope_outcomes",
+        normalize_todo_decision_scope_outcomes,
+        encoder=decision_scope_outcomes_metadata_value,
+        invalid_message=(
+            "decision_scope_outcomes must contain outcome, decision_scope, and "
+            "source_todo_id"
+        ),
+    ),
+    _TodoMetadataField(
+        "claimed_by",
+        normalize_todo_claimed_by,
+        invalid_message=(
+            "claimed_by must be a public-safe agent token such as codex-main-control"
+        ),
+    ),
+    _TodoMetadataField(
+        "bound_agent",
+        normalize_todo_bound_agent,
+        invalid_message=(
+            "bound_agent must be a public-safe agent token such as codex-main-control"
+        ),
+    ),
+    _TodoMetadataField(
+        "goal_bound",
+        normalize_todo_goal_bound,
+        write_normalizer=_optional_output_bool,
+        encoder=_metadata_bool_text,
+        invalid_when=lambda value: value is not None,
+    ),
+    _TodoMetadataField(
+        "blocks_agent",
+        normalize_todo_blocks_agent,
+        invalid_message=(
+            "blocks_agent must be a public-safe agent token such as codex-side-bypass"
+        ),
+    ),
+    _TodoMetadataField(
+        "excluded_agents",
+        normalize_todo_excluded_agents,
+        write_normalizer=require_todo_excluded_agents,
+        encoder=_metadata_csv,
+    ),
+    _TodoMetadataField(
+        "global_gate",
+        normalize_todo_global_gate,
+        write_normalizer=_optional_output_bool,
+        encoder=_metadata_bool_text,
+        invalid_when=lambda value: value is not None,
+    ),
+    _TodoMetadataField(
+        "unblocks_todo_id",
+        normalize_todo_id,
+        invalid_message=(
+            "unblocks_todo_id must use the public token shape "
+            "todo_<letters-digits-underscore-hyphen>"
+        ),
+    ),
+    _TodoMetadataField(
+        "successor_todo_ids",
+        normalize_todo_id_list,
+        encoder=_metadata_csv,
+        invalid_message=(
+            "successor_todo_ids must contain public "
+            "todo_<letters-digits-underscore-hyphen> tokens"
+        ),
+    ),
+    _TodoMetadataField(
+        "replan_obligation_id",
+        normalize_todo_replan_obligation_id,
+        invalid_message=(
+            "replan_obligation_id must use the current replan-<16 lowercase hex> "
+            "identity"
+        ),
+    ),
+    _TodoMetadataField(
+        "resume_when",
+        normalize_todo_resume_when,
+        invalid_message=(
+            "resume_when must be public-safe, e.g. "
+            "todo_done:todo_ab12cd34ef56 or pr_merged:#532"
+        ),
+    ),
+    _TodoMetadataField(
+        "no_followup",
+        normalize_todo_no_followup,
+        write_normalizer=_optional_output_bool,
+        encoder=_metadata_bool_text,
+        invalid_when=lambda value: value is not None,
+    ),
+    *(
+        _TodoMetadataField(
+            key,
+            _nonempty_metadata_text,
+            write_normalizer=_truthy_value,
+        )
+        for key in TODO_MONITOR_METADATA_FIELDS
+    ),
+    *(
+        _TodoMetadataField(
+            key,
+            _nonempty_metadata_text,
+            write_normalizer=_truthy_value,
+        )
+        for key in (
+            "note",
+            "evidence",
+            "reason",
+            "completed_at",
+            "updated_at",
+            "completion_turn_key",
+            "validation_command",
+            "validation_command_argv",
+            "validation_label",
+            "validation_timeout_seconds",
+        )
+    ),
+    _TodoMetadataField(
+        "superseded_by",
+        normalize_todo_id,
+        invalid_message=(
+            "superseded_by must use the public token shape "
+            "todo_<letters-digits-underscore-hyphen>"
+        ),
+    ),
+)
+_TODO_METADATA_FIELD_BY_TOKEN = {
+    field.key: field for field in _TODO_METADATA_FIELD_SCHEMA
+}
+def _todo_metadata_block_fields() -> tuple[str, ...]:
+    fields = [
+        field.key for field in _TODO_METADATA_FIELD_SCHEMA if field.block_field
+    ]
+    repository_index = fields.index("task_repository")
+    continuation_index = fields.index("continuation_policy")
+    fields[repository_index], fields[continuation_index] = (
+        fields[continuation_index],
+        fields[repository_index],
+    )
+    return tuple(fields)
+TODO_METADATA_FIELDS = _todo_metadata_block_fields()
+def parse_todo_metadata_line(line: str) -> dict[str, Any] | None:
+    tokens = parse_todo_metadata_tokens(line)
+    if tokens is None:
+        return None
+    metadata: dict[str, Any] = {}
+    for key, value in tokens:
+        field = _TODO_METADATA_FIELD_BY_TOKEN.get(key)
+        if field is None:
+            continue
+        normalized = field.read_normalizer(value)
+        output_key = field.key
+        if (
+            not _metadata_value_is_present(normalized)
+            and field.read_fallback_key
+            and field.read_fallback_normalizer
+        ):
+            normalized = field.read_fallback_normalizer(value)
+            output_key = field.read_fallback_key
+        if _metadata_value_is_present(normalized):
+            metadata[output_key] = normalized
+    return metadata or None
+def _normalize_todo_metadata_for_write(values: dict[str, Any]) -> dict[str, Any]:
+    normalized: dict[str, Any] = {}
+    for field in _TODO_METADATA_FIELD_SCHEMA:
+        value = field.normalize_for_write(values.get(field.key))
+        if _metadata_value_is_present(value):
+            normalized[field.key] = value
+        if field.key == "removed_continuation_policy" and {
+            "continuation_policy",
+            "removed_continuation_policy",
+        }.issubset(normalized):
+            raise ValueError(
+                "continuation_policy and removed_continuation_policy are mutually exclusive"
+            )
+        if (
+            field.key == "excluded_agents"
+            and normalized.get("claimed_by")
+            and normalized["claimed_by"] in normalized.get("excluded_agents", [])
+        ):
+            raise ValueError(
+                f"claimed_by={normalized['claimed_by']!r} cannot also appear in "
+                "excluded_agents"
+            )
+    return normalized
+def _format_todo_metadata_values(values: dict[str, Any]) -> str | None:
+    normalized = _normalize_todo_metadata_for_write(values)
+    fields = [
+        f"{field.key}={encode_metadata_value(field.encoder(normalized[field.key]))}"
+        for field in _TODO_METADATA_FIELD_SCHEMA
+        if field.key in normalized
+    ]
+    if not fields:
+        return None
+    return f"  <!-- loopx:todo {' '.join(fields)} -->"
+def format_todo_metadata_line(
+    *,
+    todo_id: str | None = None,
+    status: str | None = None,
+    task_class: str | None = None,
+    action_kind: str | None = None,
+    task_domain: str | None = None,
+    capability_binding_ref: str | None = None,
+    task_repository: str | None = None,
+    continuation_policy: str | None = None,
+    removed_continuation_policy: str | None = None,
+    required_write_scopes: Any = None,
+    required_capabilities: Any = None,
+    target_capabilities: Any = None,
+    explore_result_node_refs: Any = None,
+    decision_scope: Any = None,
+    required_decision_scopes: Any = None,
+    decision_outcome: str | None = None,
+    decision_scope_outcomes: Any = None,
+    claimed_by: str | None = None,
+    bound_agent: str | None = None,
+    goal_bound: bool | None = None,
+    blocks_agent: str | None = None,
+    excluded_agents: Any = None,
+    global_gate: bool | None = None,
+    unblocks_todo_id: str | None = None,
+    successor_todo_ids: Any = None,
+    replan_obligation_id: str | None = None,
+    resume_when: str | None = None,
+    no_followup: bool | None = None,
+    target_key: str | None = None,
+    cadence: str | None = None,
+    next_due_at: str | None = None,
+    expires_at: str | None = None,
+    last_checked_at: str | None = None,
+    result_hash: str | None = None,
+    consecutive_no_change: str | None = None,
+    material_change: str | None = None,
+    max_no_change_before_replan: str | None = None,
+    watch_only: str | None = None,
+    note: str | None = None,
+    evidence: str | None = None,
+    completion_turn_key: str | None = None,
+    validation_command: str | None = None,
+    validation_command_argv: str | None = None,
+    validation_label: str | None = None,
+    validation_timeout_seconds: str | None = None,
+    reason: str | None = None,
+    completed_at: str | None = None,
+    updated_at: str | None = None,
+    superseded_by: str | None = None,
+) -> str | None:
+    values = locals()
+    return _format_todo_metadata_values(values)
+def todo_block_metadata(block: dict[str, Any]) -> dict[str, Any]:
+    metadata: dict[str, Any] = {}
+    for key in TODO_METADATA_FIELDS:
+        value = block.get(key)
+        if value is None:
+            continue
+        normalized: Any
+        if key == "required_write_scopes":
+            normalized = normalize_required_write_scopes(value)
+        elif key == "task_domain":
+            normalized = normalize_todo_task_domain(value)
+        elif key == "task_repository":
+            normalized = normalize_todo_task_repository(value)
+        elif key == "required_capabilities":
+            normalized = normalize_required_capabilities(value)
+        elif key == "target_capabilities":
+            normalized = normalize_target_capabilities(value)
+        elif key == "excluded_agents":
+            normalized = normalize_todo_excluded_agents(value)
+        elif key == "explore_result_node_refs":
+            normalized = normalize_explore_result_node_refs(value)
+        elif key == "continuation_policy":
+            normalized = normalize_todo_continuation_policy(value)
+        elif key == "decision_scope":
+            normalized = normalize_todo_decision_scope(value)
+        elif key == "required_decision_scopes":
+            normalized = normalize_todo_required_decision_scopes(value)
+        elif key == "decision_outcome":
+            normalized = normalize_todo_decision_outcome(value)
+        elif key == "decision_scope_outcomes":
+            normalized = normalize_todo_decision_scope_outcomes(value)
+        elif key == "no_followup":
+            normalized = normalize_todo_no_followup(value)
+        elif key in {"global_gate", "goal_bound"}:
+            normalized = normalize_todo_global_gate(value)
+        else:
+            normalized = str(value).strip()
+        if normalized is not None and normalized != [] and normalized != "":
+            metadata[key] = normalized
+    return metadata
+def metadata_line_for_todo_block(
+    block: dict[str, Any],
+    updates: dict[str, Any],
+) -> str | None:
+    metadata = todo_block_metadata(block)
+    for key, value in updates.items():
+        if key not in TODO_METADATA_FIELDS:
+            continue
+        if value is None:
+            metadata.pop(key, None)
+        elif key == "required_write_scopes":
+            normalized = normalize_required_write_scopes(value)
+            if normalized:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif key == "task_domain":
+            metadata[key] = _TODO_METADATA_FIELD_BY_TOKEN[
+                key
+            ].normalize_for_write(value)
+        elif key == "task_repository":
+            normalized = normalize_todo_task_repository(value)
+            if normalized:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif key == "required_capabilities":
+            normalized = normalize_required_capabilities(value)
+            if normalized:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif key == "target_capabilities":
+            normalized = normalize_target_capabilities(value)
+            if normalized:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif key == "excluded_agents":
+            normalized = normalize_todo_excluded_agents(value)
+            if normalized:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif key == "explore_result_node_refs":
+            normalized = normalize_explore_result_node_refs(value)
+            if normalized:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif key == "continuation_policy":
+            normalized = normalize_todo_continuation_policy(value)
+            if normalized:
+                metadata[key] = normalized
+            elif value:
+                raise ValueError(
+                    "todo continuation_policy must be one of: "
+                    + ", ".join(sorted(TODO_CONTINUATION_POLICY_VALUES))
+                )
+            else:
+                metadata.pop(key, None)
+        elif key == "decision_scope":
+            metadata[key] = require_todo_decision_scope(value)
+        elif key == "required_decision_scopes":
+            normalized = require_todo_required_decision_scopes(value)
+            if normalized:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif key == "decision_outcome":
+            metadata[key] = require_todo_decision_outcome(value)
+        elif key == "decision_scope_outcomes":
+            normalized_scope_outcomes = normalize_todo_decision_scope_outcomes(value)
+            if normalized_scope_outcomes:
+                metadata[key] = normalized_scope_outcomes
+            else:
+                metadata.pop(key, None)
+        elif key == "no_followup":
+            normalized = normalize_todo_no_followup(value)
+            if normalized is not None:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif key == "successor_todo_ids":
+            normalized = normalize_todo_id_list(value)
+            if normalized:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif key in {"global_gate", "goal_bound"}:
+            normalized = normalize_todo_global_gate(value)
+            if normalized is not None:
+                metadata[key] = normalized
+            else:
+                metadata.pop(key, None)
+        elif str(value).strip():
+            metadata[key] = str(value).strip()
+    if "todo_id" not in metadata and block.get("todo_id"):
+        metadata["todo_id"] = str(block["todo_id"])
+    if "status" not in metadata:
+        metadata["status"] = TODO_STATUS_DONE if block.get("done") else TODO_STATUS_OPEN
+    return format_todo_metadata_line(**metadata)
+def todo_task_class_for_text(text: str) -> str:
+    compact = compact_todo_text(text)
+    for pattern in TODO_HARD_MONITOR_PATTERNS:
+        if pattern.search(compact):
+            return TODO_TASK_CLASS_MONITOR
+    for pattern in TODO_ADVANCEMENT_OVERRIDE_PATTERNS:
+        if pattern.search(compact):
+            return TODO_TASK_CLASS_ADVANCEMENT
+    for pattern in TODO_BLOCKED_MONITOR_PATTERNS:
+        if pattern.search(compact):
+            return TODO_TASK_CLASS_MONITOR
+    for pattern in TODO_MONITOR_PATTERNS:
+        if pattern.search(compact):
+            return TODO_TASK_CLASS_MONITOR
+    for pattern in TODO_ADVANCEMENT_PATTERNS:
+        if pattern.search(compact):
+            return TODO_TASK_CLASS_ADVANCEMENT
+    return TODO_TASK_CLASS_ADVANCEMENT
+def normalize_todo_task_class(value: Any, *, text: str, action_kind: Any = None) -> str:
+    candidate = normalize_explicit_todo_task_class(value)
+    if candidate:
+        return candidate
+    normalized_action_kind = normalize_todo_action_kind(action_kind)
+    if normalized_action_kind in TODO_ACTION_KIND_ADVANCEMENT_VALUES:
+        return TODO_TASK_CLASS_ADVANCEMENT
+    if normalized_action_kind in TODO_ACTION_KIND_MONITOR_VALUES:
+        return TODO_TASK_CLASS_MONITOR
+    return todo_task_class_for_text(text)
+def next_action_requires_advancement_text(text: str) -> bool:
+    compact = compact_todo_text(text)
+    if not compact:
+        return False
+    if any(pattern.search(compact) for pattern in NEXT_ACTION_HARD_MONITOR_PATTERNS):
+        return False
+    return any(pattern.search(compact) for pattern in NEXT_ACTION_ADVANCEMENT_HINT_PATTERNS)