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.
- 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
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
from datetime import datetime
|
|
4
|
+
from typing import Any, Callable
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def project_asset_handoff_state(
|
|
8
|
+
*,
|
|
9
|
+
ready: bool,
|
|
10
|
+
project_asset: dict[str, Any],
|
|
11
|
+
latest_runs: list[dict[str, Any]] | None,
|
|
12
|
+
compact_execution_profile: Callable[[dict[str, Any] | None], dict[str, Any]],
|
|
13
|
+
parse_timestamp: Callable[[Any], datetime | None],
|
|
14
|
+
is_handoff_ready_run: Callable[[dict[str, Any]], bool],
|
|
15
|
+
is_custom_post_handoff_work_run: Callable[[dict[str, Any]], bool],
|
|
16
|
+
is_status_neutral_run: Callable[[dict[str, Any]], bool],
|
|
17
|
+
compact_post_handoff_run: Callable[[dict[str, Any], dict[str, Any] | None], dict[str, Any]],
|
|
18
|
+
small_delivery_batch_scale_streak: Callable[[list[dict[str, Any]]], int],
|
|
19
|
+
outcome_floor_configured: Callable[[dict[str, Any] | None], bool],
|
|
20
|
+
outcome_gap_streak: Callable[[list[dict[str, Any]], dict[str, Any] | None], int],
|
|
21
|
+
) -> dict[str, Any]:
|
|
22
|
+
runs = [run for run in latest_runs or [] if isinstance(run, dict)]
|
|
23
|
+
profile = compact_execution_profile(
|
|
24
|
+
project_asset.get("execution_profile")
|
|
25
|
+
if isinstance(project_asset.get("execution_profile"), dict)
|
|
26
|
+
else None
|
|
27
|
+
)
|
|
28
|
+
parsed_runs = [
|
|
29
|
+
(run, parse_timestamp(run.get("generated_at")))
|
|
30
|
+
for run in runs
|
|
31
|
+
]
|
|
32
|
+
parsed_runs = [(run, generated_at) for run, generated_at in parsed_runs if generated_at]
|
|
33
|
+
parsed_runs.sort(key=lambda item: item[1], reverse=True)
|
|
34
|
+
|
|
35
|
+
handoff_run: dict[str, Any] | None = None
|
|
36
|
+
handoff_at: datetime | None = None
|
|
37
|
+
for run, generated_at in parsed_runs:
|
|
38
|
+
if is_handoff_ready_run(run):
|
|
39
|
+
handoff_run = run
|
|
40
|
+
handoff_at = generated_at
|
|
41
|
+
break
|
|
42
|
+
|
|
43
|
+
post_handoff_run: dict[str, Any] | None = None
|
|
44
|
+
recent_post_handoff_runs: list[dict[str, Any]] = []
|
|
45
|
+
if handoff_at is None and ready:
|
|
46
|
+
recent_post_handoff_runs = [
|
|
47
|
+
run
|
|
48
|
+
for run, _generated_at in parsed_runs
|
|
49
|
+
if is_custom_post_handoff_work_run(run)
|
|
50
|
+
]
|
|
51
|
+
if recent_post_handoff_runs:
|
|
52
|
+
post_handoff_run = recent_post_handoff_runs[0]
|
|
53
|
+
latest_validation = (
|
|
54
|
+
project_asset.get("latest_validation")
|
|
55
|
+
if isinstance(project_asset.get("latest_validation"), dict)
|
|
56
|
+
else {}
|
|
57
|
+
)
|
|
58
|
+
if latest_validation and post_handoff_run is None:
|
|
59
|
+
latest_validation_run = {
|
|
60
|
+
"generated_at": latest_validation.get("generated_at"),
|
|
61
|
+
"classification": latest_validation.get("classification"),
|
|
62
|
+
}
|
|
63
|
+
if is_custom_post_handoff_work_run(latest_validation_run):
|
|
64
|
+
post_handoff_run = latest_validation_run
|
|
65
|
+
recent_post_handoff_runs = [latest_validation_run]
|
|
66
|
+
else:
|
|
67
|
+
handoff_at = parse_timestamp(latest_validation.get("generated_at"))
|
|
68
|
+
handoff_run = latest_validation_run
|
|
69
|
+
|
|
70
|
+
if handoff_at is not None and post_handoff_run is None:
|
|
71
|
+
for run, generated_at in parsed_runs:
|
|
72
|
+
if generated_at <= handoff_at:
|
|
73
|
+
continue
|
|
74
|
+
if is_status_neutral_run(run) or is_handoff_ready_run(run):
|
|
75
|
+
continue
|
|
76
|
+
recent_post_handoff_runs.append(run)
|
|
77
|
+
if recent_post_handoff_runs:
|
|
78
|
+
post_handoff_run = recent_post_handoff_runs[0]
|
|
79
|
+
|
|
80
|
+
if post_handoff_run and not recent_post_handoff_runs:
|
|
81
|
+
recent_post_handoff_runs = [post_handoff_run]
|
|
82
|
+
if len(recent_post_handoff_runs) > 3:
|
|
83
|
+
recent_post_handoff_runs = recent_post_handoff_runs[:3]
|
|
84
|
+
|
|
85
|
+
if post_handoff_run:
|
|
86
|
+
handoff_status = "post_handoff_run_seen"
|
|
87
|
+
elif ready:
|
|
88
|
+
handoff_status = "ready_waiting_for_run"
|
|
89
|
+
else:
|
|
90
|
+
handoff_status = "not_ready"
|
|
91
|
+
|
|
92
|
+
state: dict[str, Any] = {
|
|
93
|
+
"handoff_status": handoff_status,
|
|
94
|
+
"post_handoff_run_seen": bool(post_handoff_run),
|
|
95
|
+
}
|
|
96
|
+
if handoff_run and handoff_run.get("generated_at"):
|
|
97
|
+
state["handoff_ready_at"] = handoff_run.get("generated_at")
|
|
98
|
+
if handoff_run and handoff_run.get("classification"):
|
|
99
|
+
state["handoff_ready_classification"] = handoff_run.get("classification")
|
|
100
|
+
if post_handoff_run:
|
|
101
|
+
state["post_handoff_latest_run"] = compact_post_handoff_run(post_handoff_run, profile)
|
|
102
|
+
if recent_post_handoff_runs:
|
|
103
|
+
state["post_handoff_recent_runs"] = [
|
|
104
|
+
compact_post_handoff_run(run, profile)
|
|
105
|
+
for run in recent_post_handoff_runs
|
|
106
|
+
]
|
|
107
|
+
state["post_handoff_small_scale_streak"] = small_delivery_batch_scale_streak(
|
|
108
|
+
recent_post_handoff_runs
|
|
109
|
+
)
|
|
110
|
+
if outcome_floor_configured(profile):
|
|
111
|
+
state["post_handoff_outcome_gap_streak"] = outcome_gap_streak(
|
|
112
|
+
recent_post_handoff_runs,
|
|
113
|
+
profile,
|
|
114
|
+
)
|
|
115
|
+
return state
|
|
116
|
+
|
|
117
|
+
|
|
118
|
+
def project_asset_handoff_readiness(
|
|
119
|
+
item: dict[str, Any],
|
|
120
|
+
*,
|
|
121
|
+
latest_runs: list[dict[str, Any]] | None,
|
|
122
|
+
project_asset_handoff_check_projection: Callable[[dict[str, Any]], dict[str, Any] | None],
|
|
123
|
+
handoff_budget_contract: Callable[[], dict[str, Any]],
|
|
124
|
+
project_asset_handoff_state: Callable[
|
|
125
|
+
...,
|
|
126
|
+
dict[str, Any],
|
|
127
|
+
],
|
|
128
|
+
) -> dict[str, Any] | None:
|
|
129
|
+
project_asset = item.get("project_asset")
|
|
130
|
+
if not isinstance(project_asset, dict):
|
|
131
|
+
return None
|
|
132
|
+
|
|
133
|
+
check_projection = project_asset_handoff_check_projection(item)
|
|
134
|
+
if not check_projection:
|
|
135
|
+
return None
|
|
136
|
+
checks = check_projection["checks"]
|
|
137
|
+
goal_id = str(item.get("goal_id") or "").strip()
|
|
138
|
+
readiness: dict[str, Any] = {
|
|
139
|
+
"ready": all(checks.values()),
|
|
140
|
+
"codex_ready": bool(check_projection.get("codex_ready")),
|
|
141
|
+
"source": "project_asset",
|
|
142
|
+
"quota_state": check_projection.get("quota_state") or "unknown",
|
|
143
|
+
"handoff_interface_budget": handoff_budget_contract(),
|
|
144
|
+
"checks": checks,
|
|
145
|
+
}
|
|
146
|
+
readiness.update(
|
|
147
|
+
project_asset_handoff_state(
|
|
148
|
+
ready=bool(check_projection.get("state_trace_ready")),
|
|
149
|
+
project_asset=project_asset,
|
|
150
|
+
latest_runs=latest_runs,
|
|
151
|
+
)
|
|
152
|
+
)
|
|
153
|
+
if goal_id:
|
|
154
|
+
readiness["next_probe"] = f"loopx review-packet --goal-id {goal_id} --handoff-only"
|
|
155
|
+
return readiness
|
|
@@ -0,0 +1,463 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
import hashlib
|
|
4
|
+
import json
|
|
5
|
+
import re
|
|
6
|
+
from collections.abc import Mapping
|
|
7
|
+
from typing import Any
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
REQUEST_SCHEMA = "review_batch_request_v0"
|
|
11
|
+
BATCH_SCHEMA = "review_batch_v0"
|
|
12
|
+
DECISIONS_SCHEMA = "review_batch_decisions_v0"
|
|
13
|
+
DECISION_RECEIPT_SCHEMA = "review_batch_decision_receipt_v0"
|
|
14
|
+
|
|
15
|
+
_TOKEN_RE = re.compile(r"^[a-z][a-z0-9_.-]{0,127}$")
|
|
16
|
+
_FORBIDDEN_RAW_KEYS = {
|
|
17
|
+
"credential",
|
|
18
|
+
"credentials",
|
|
19
|
+
"private_path",
|
|
20
|
+
"raw_body",
|
|
21
|
+
"raw_content",
|
|
22
|
+
"raw_log",
|
|
23
|
+
"raw_logs",
|
|
24
|
+
"raw_message",
|
|
25
|
+
"raw_transcript",
|
|
26
|
+
"secret",
|
|
27
|
+
"token",
|
|
28
|
+
}
|
|
29
|
+
_RECEIPT_STATUSES = {"preview", "sent", "failed", "skipped"}
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def _object(value: object, label: str) -> dict[str, Any]:
|
|
33
|
+
if not isinstance(value, Mapping):
|
|
34
|
+
raise ValueError(f"{label} must be an object")
|
|
35
|
+
return {str(key): item for key, item in value.items()}
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
def _list(value: object, label: str) -> list[Any]:
|
|
39
|
+
if not isinstance(value, list):
|
|
40
|
+
raise ValueError(f"{label} must be a list")
|
|
41
|
+
return list(value)
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def _text(value: object, label: str, *, maximum: int = 1000) -> str:
|
|
45
|
+
text = str(value or "").strip()
|
|
46
|
+
if not text:
|
|
47
|
+
raise ValueError(f"{label} is required")
|
|
48
|
+
if len(text) > maximum:
|
|
49
|
+
raise ValueError(f"{label} exceeds {maximum} characters")
|
|
50
|
+
return text
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
def _optional_text(value: object, label: str, *, maximum: int = 1000) -> str | None:
|
|
54
|
+
if value is None:
|
|
55
|
+
return None
|
|
56
|
+
return _text(value, label, maximum=maximum)
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
def _token(value: object, label: str) -> str:
|
|
60
|
+
token = _text(value, label, maximum=128).lower()
|
|
61
|
+
if not _TOKEN_RE.fullmatch(token):
|
|
62
|
+
raise ValueError(f"{label} must be a lower-snake-like public token")
|
|
63
|
+
return token
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
def _reject_raw_keys(value: object, label: str) -> None:
|
|
67
|
+
if isinstance(value, Mapping):
|
|
68
|
+
for raw_key, item in value.items():
|
|
69
|
+
key = str(raw_key).strip().lower()
|
|
70
|
+
if key in _FORBIDDEN_RAW_KEYS:
|
|
71
|
+
raise ValueError(f"{label} contains forbidden raw/private field {raw_key!r}")
|
|
72
|
+
_reject_raw_keys(item, f"{label}.{raw_key}")
|
|
73
|
+
elif isinstance(value, list):
|
|
74
|
+
for index, item in enumerate(value):
|
|
75
|
+
_reject_raw_keys(item, f"{label}[{index}]")
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
def _digest(value: object, *, prefix: str) -> str:
|
|
79
|
+
encoded = json.dumps(
|
|
80
|
+
value,
|
|
81
|
+
ensure_ascii=False,
|
|
82
|
+
sort_keys=True,
|
|
83
|
+
separators=(",", ":"),
|
|
84
|
+
).encode("utf-8")
|
|
85
|
+
return f"{prefix}_{hashlib.sha256(encoded).hexdigest()[:24]}"
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
def _candidate_decision_digest(candidate: Mapping[str, Any]) -> str:
|
|
89
|
+
digest_input = {
|
|
90
|
+
key: value
|
|
91
|
+
for key, value in candidate.items()
|
|
92
|
+
if key != "decision_digest" and value is not None
|
|
93
|
+
}
|
|
94
|
+
return _digest(digest_input, prefix="candidate")
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
def _batch_decision_digest(
|
|
98
|
+
*,
|
|
99
|
+
batch_id: str,
|
|
100
|
+
policy: Mapping[str, Any],
|
|
101
|
+
candidate_decision_digests: list[str],
|
|
102
|
+
) -> str:
|
|
103
|
+
return _digest(
|
|
104
|
+
{
|
|
105
|
+
"batch_id": batch_id,
|
|
106
|
+
"policy": dict(policy),
|
|
107
|
+
"candidate_decision_digests": candidate_decision_digests,
|
|
108
|
+
},
|
|
109
|
+
prefix="batch",
|
|
110
|
+
)
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
def _normalize_policy(raw: object) -> dict[str, Any]:
|
|
114
|
+
policy = _object(raw, "policy")
|
|
115
|
+
soft_limit = int(policy.get("soft_limit", 8))
|
|
116
|
+
hard_limit = int(policy.get("hard_limit", max(soft_limit, 10)))
|
|
117
|
+
if not 1 <= soft_limit <= hard_limit <= 50:
|
|
118
|
+
raise ValueError("policy limits must satisfy 1 <= soft_limit <= hard_limit <= 50")
|
|
119
|
+
reason_order = [
|
|
120
|
+
_token(value, f"policy.priority_reason_order[{index}]")
|
|
121
|
+
for index, value in enumerate(
|
|
122
|
+
_list(policy.get("priority_reason_order"), "policy.priority_reason_order")
|
|
123
|
+
)
|
|
124
|
+
]
|
|
125
|
+
if not reason_order:
|
|
126
|
+
raise ValueError("policy.priority_reason_order must not be empty")
|
|
127
|
+
if len(reason_order) != len(set(reason_order)):
|
|
128
|
+
raise ValueError("policy.priority_reason_order must contain unique codes")
|
|
129
|
+
decision_values = [
|
|
130
|
+
_token(value, f"policy.decision_values[{index}]")
|
|
131
|
+
for index, value in enumerate(
|
|
132
|
+
_list(
|
|
133
|
+
policy.get("decision_values", ["approve", "revise", "hold", "skip"]),
|
|
134
|
+
"policy.decision_values",
|
|
135
|
+
)
|
|
136
|
+
)
|
|
137
|
+
]
|
|
138
|
+
if not decision_values or len(decision_values) != len(set(decision_values)):
|
|
139
|
+
raise ValueError("policy.decision_values must contain unique values")
|
|
140
|
+
return {
|
|
141
|
+
"soft_limit": soft_limit,
|
|
142
|
+
"hard_limit": hard_limit,
|
|
143
|
+
"priority_reason_order": reason_order,
|
|
144
|
+
"decision_values": decision_values,
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def _normalize_priority_reasons(
|
|
149
|
+
raw: object,
|
|
150
|
+
*,
|
|
151
|
+
candidate_label: str,
|
|
152
|
+
reason_order: list[str],
|
|
153
|
+
) -> list[dict[str, str]]:
|
|
154
|
+
reasons: list[dict[str, str]] = []
|
|
155
|
+
seen: set[str] = set()
|
|
156
|
+
for index, value in enumerate(_list(raw, f"{candidate_label}.priority_reasons")):
|
|
157
|
+
if isinstance(value, str):
|
|
158
|
+
code = _token(value, f"{candidate_label}.priority_reasons[{index}]")
|
|
159
|
+
detail = code.replace("_", " ")
|
|
160
|
+
else:
|
|
161
|
+
item = _object(value, f"{candidate_label}.priority_reasons[{index}]")
|
|
162
|
+
code = _token(item.get("code"), f"{candidate_label}.priority_reasons[{index}].code")
|
|
163
|
+
detail = _text(
|
|
164
|
+
item.get("detail"),
|
|
165
|
+
f"{candidate_label}.priority_reasons[{index}].detail",
|
|
166
|
+
maximum=400,
|
|
167
|
+
)
|
|
168
|
+
if code not in reason_order:
|
|
169
|
+
raise ValueError(
|
|
170
|
+
f"{candidate_label}.priority_reasons contains unregistered code {code!r}"
|
|
171
|
+
)
|
|
172
|
+
if code not in seen:
|
|
173
|
+
reasons.append({"code": code, "detail": detail})
|
|
174
|
+
seen.add(code)
|
|
175
|
+
if not reasons:
|
|
176
|
+
raise ValueError(f"{candidate_label}.priority_reasons must not be empty")
|
|
177
|
+
reasons.sort(key=lambda item: reason_order.index(item["code"]))
|
|
178
|
+
return reasons
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
def _normalize_candidate(
|
|
182
|
+
raw: object,
|
|
183
|
+
*,
|
|
184
|
+
source_id: str,
|
|
185
|
+
source_kind: str,
|
|
186
|
+
source_index: int,
|
|
187
|
+
candidate_index: int,
|
|
188
|
+
policy: dict[str, Any],
|
|
189
|
+
) -> dict[str, Any]:
|
|
190
|
+
label = f"candidate_sources[{source_index}].candidates[{candidate_index}]"
|
|
191
|
+
candidate = _object(raw, label)
|
|
192
|
+
_reject_raw_keys(candidate, label)
|
|
193
|
+
candidate_id = _token(candidate.get("candidate_id"), f"{label}.candidate_id")
|
|
194
|
+
priority_tier = int(candidate.get("priority_tier", 1))
|
|
195
|
+
if not 0 <= priority_tier <= 9:
|
|
196
|
+
raise ValueError(f"{label}.priority_tier must be between 0 and 9")
|
|
197
|
+
reasons = _normalize_priority_reasons(
|
|
198
|
+
candidate.get("priority_reasons"),
|
|
199
|
+
candidate_label=label,
|
|
200
|
+
reason_order=policy["priority_reason_order"],
|
|
201
|
+
)
|
|
202
|
+
proposal = _object(candidate.get("proposal"), f"{label}.proposal")
|
|
203
|
+
action = _optional_text(proposal.get("action"), f"{label}.proposal.action", maximum=600)
|
|
204
|
+
draft = _optional_text(proposal.get("draft"), f"{label}.proposal.draft", maximum=2000)
|
|
205
|
+
if not action and not draft:
|
|
206
|
+
raise ValueError(f"{label}.proposal requires action or draft")
|
|
207
|
+
evidence_refs = [
|
|
208
|
+
_text(value, f"{label}.evidence_refs[{index}]", maximum=500)
|
|
209
|
+
for index, value in enumerate(_list(candidate.get("evidence_refs", []), f"{label}.evidence_refs"))
|
|
210
|
+
]
|
|
211
|
+
normalized = {
|
|
212
|
+
"candidate_id": candidate_id,
|
|
213
|
+
"source": {
|
|
214
|
+
"source_id": source_id,
|
|
215
|
+
"source_kind": source_kind,
|
|
216
|
+
"source_ref": _text(candidate.get("source_ref"), f"{label}.source_ref", maximum=500),
|
|
217
|
+
},
|
|
218
|
+
"title": _text(candidate.get("title"), f"{label}.title", maximum=300),
|
|
219
|
+
"summary": _text(candidate.get("summary"), f"{label}.summary", maximum=1200),
|
|
220
|
+
"priority_tier": priority_tier,
|
|
221
|
+
"priority_reasons": reasons,
|
|
222
|
+
"evidence_status": _token(
|
|
223
|
+
candidate.get("evidence_status"), f"{label}.evidence_status"
|
|
224
|
+
),
|
|
225
|
+
"evidence_refs": evidence_refs,
|
|
226
|
+
"proposal": {key: value for key, value in (("action", action), ("draft", draft)) if value},
|
|
227
|
+
"observed_at": _optional_text(
|
|
228
|
+
candidate.get("observed_at"), f"{label}.observed_at", maximum=80
|
|
229
|
+
),
|
|
230
|
+
}
|
|
231
|
+
normalized["decision_digest"] = _candidate_decision_digest(normalized)
|
|
232
|
+
return normalized
|
|
233
|
+
|
|
234
|
+
|
|
235
|
+
def _candidate_sort_key(candidate: dict[str, Any], reason_order: list[str]) -> tuple[Any, ...]:
|
|
236
|
+
reason_ranks = tuple(
|
|
237
|
+
reason_order.index(str(item["code"])) for item in candidate["priority_reasons"]
|
|
238
|
+
)
|
|
239
|
+
return (
|
|
240
|
+
int(candidate["priority_tier"]),
|
|
241
|
+
reason_ranks,
|
|
242
|
+
str(candidate["candidate_id"]),
|
|
243
|
+
)
|
|
244
|
+
|
|
245
|
+
|
|
246
|
+
def _normalize_sink_receipts(raw: object) -> list[dict[str, Any]]:
|
|
247
|
+
receipts: list[dict[str, Any]] = []
|
|
248
|
+
seen: set[str] = set()
|
|
249
|
+
for index, value in enumerate(_list(raw, "sink_receipts")):
|
|
250
|
+
label = f"sink_receipts[{index}]"
|
|
251
|
+
item = _object(value, label)
|
|
252
|
+
_reject_raw_keys(item, label)
|
|
253
|
+
sink_id = _token(item.get("sink_id"), f"{label}.sink_id")
|
|
254
|
+
if sink_id in seen:
|
|
255
|
+
raise ValueError(f"duplicate sink_id {sink_id!r}")
|
|
256
|
+
seen.add(sink_id)
|
|
257
|
+
status = _token(item.get("status"), f"{label}.status")
|
|
258
|
+
if status not in _RECEIPT_STATUSES:
|
|
259
|
+
raise ValueError(f"{label}.status is invalid")
|
|
260
|
+
receipt = {
|
|
261
|
+
"sink_id": sink_id,
|
|
262
|
+
"sink_kind": _token(item.get("sink_kind"), f"{label}.sink_kind"),
|
|
263
|
+
"status": status,
|
|
264
|
+
"idempotency_key": _optional_text(
|
|
265
|
+
item.get("idempotency_key"), f"{label}.idempotency_key", maximum=300
|
|
266
|
+
),
|
|
267
|
+
"receipt_ref": _optional_text(
|
|
268
|
+
item.get("receipt_ref"), f"{label}.receipt_ref", maximum=500
|
|
269
|
+
),
|
|
270
|
+
"readback_verified": bool(item.get("readback_verified", False)),
|
|
271
|
+
}
|
|
272
|
+
if status == "sent" and not (
|
|
273
|
+
receipt["idempotency_key"]
|
|
274
|
+
and receipt["receipt_ref"]
|
|
275
|
+
and receipt["readback_verified"]
|
|
276
|
+
):
|
|
277
|
+
raise ValueError(
|
|
278
|
+
f"{label} sent receipts require idempotency_key, receipt_ref, and readback_verified=true"
|
|
279
|
+
)
|
|
280
|
+
receipts.append(receipt)
|
|
281
|
+
return receipts
|
|
282
|
+
|
|
283
|
+
|
|
284
|
+
def build_review_batch(request: Mapping[str, Any]) -> dict[str, Any]:
|
|
285
|
+
"""Compose one deterministic, provider-neutral review batch."""
|
|
286
|
+
|
|
287
|
+
payload = _object(request, "request")
|
|
288
|
+
if payload.get("schema_version") != REQUEST_SCHEMA:
|
|
289
|
+
raise ValueError(f"request must use {REQUEST_SCHEMA}")
|
|
290
|
+
_reject_raw_keys(payload, "request")
|
|
291
|
+
batch_id = _token(payload.get("batch_id"), "batch_id")
|
|
292
|
+
policy = _normalize_policy(payload.get("policy"))
|
|
293
|
+
sources = _list(payload.get("candidate_sources"), "candidate_sources")
|
|
294
|
+
if not sources:
|
|
295
|
+
raise ValueError("candidate_sources must not be empty")
|
|
296
|
+
normalized_candidates: list[dict[str, Any]] = []
|
|
297
|
+
source_summary: list[dict[str, Any]] = []
|
|
298
|
+
seen_sources: set[str] = set()
|
|
299
|
+
seen_candidates: set[str] = set()
|
|
300
|
+
for source_index, raw_source in enumerate(sources):
|
|
301
|
+
label = f"candidate_sources[{source_index}]"
|
|
302
|
+
source = _object(raw_source, label)
|
|
303
|
+
source_id = _token(source.get("source_id"), f"{label}.source_id")
|
|
304
|
+
source_kind = _token(source.get("source_kind"), f"{label}.source_kind")
|
|
305
|
+
if source_id in seen_sources:
|
|
306
|
+
raise ValueError(f"duplicate source_id {source_id!r}")
|
|
307
|
+
seen_sources.add(source_id)
|
|
308
|
+
candidates = _list(source.get("candidates"), f"{label}.candidates")
|
|
309
|
+
source_summary.append(
|
|
310
|
+
{"source_id": source_id, "source_kind": source_kind, "candidate_count": len(candidates)}
|
|
311
|
+
)
|
|
312
|
+
for candidate_index, raw_candidate in enumerate(candidates):
|
|
313
|
+
candidate = _normalize_candidate(
|
|
314
|
+
raw_candidate,
|
|
315
|
+
source_id=source_id,
|
|
316
|
+
source_kind=source_kind,
|
|
317
|
+
source_index=source_index,
|
|
318
|
+
candidate_index=candidate_index,
|
|
319
|
+
policy=policy,
|
|
320
|
+
)
|
|
321
|
+
candidate_id = str(candidate["candidate_id"])
|
|
322
|
+
if candidate_id in seen_candidates:
|
|
323
|
+
raise ValueError(f"duplicate candidate_id {candidate_id!r}")
|
|
324
|
+
seen_candidates.add(candidate_id)
|
|
325
|
+
normalized_candidates.append(candidate)
|
|
326
|
+
|
|
327
|
+
ordered = sorted(
|
|
328
|
+
normalized_candidates,
|
|
329
|
+
key=lambda candidate: _candidate_sort_key(candidate, policy["priority_reason_order"]),
|
|
330
|
+
)
|
|
331
|
+
bounded = ordered[: policy["hard_limit"]]
|
|
332
|
+
selected = bounded[: policy["soft_limit"]]
|
|
333
|
+
decision_digest = _batch_decision_digest(
|
|
334
|
+
batch_id=batch_id,
|
|
335
|
+
policy=policy,
|
|
336
|
+
candidate_decision_digests=[item["decision_digest"] for item in selected],
|
|
337
|
+
)
|
|
338
|
+
return {
|
|
339
|
+
"ok": True,
|
|
340
|
+
"schema_version": BATCH_SCHEMA,
|
|
341
|
+
"batch_id": batch_id,
|
|
342
|
+
"generated_at": _text(payload.get("generated_at"), "generated_at", maximum=80),
|
|
343
|
+
"policy": policy,
|
|
344
|
+
"source_summary": source_summary,
|
|
345
|
+
"candidate_counts": {
|
|
346
|
+
"input": len(ordered),
|
|
347
|
+
"within_hard_limit": len(bounded),
|
|
348
|
+
"selected": len(selected),
|
|
349
|
+
"overflow": max(0, len(ordered) - len(selected)),
|
|
350
|
+
},
|
|
351
|
+
"candidates": selected,
|
|
352
|
+
"decision_digest": decision_digest,
|
|
353
|
+
"sink_receipts": _normalize_sink_receipts(payload.get("sink_receipts", [])),
|
|
354
|
+
"boundary": {
|
|
355
|
+
"provider_neutral": True,
|
|
356
|
+
"raw_content_persisted": False,
|
|
357
|
+
"external_writes_performed": False,
|
|
358
|
+
"candidate_adapters_execute_outside_core": True,
|
|
359
|
+
"sink_delivery_executes_outside_core": True,
|
|
360
|
+
},
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
|
|
364
|
+
def bind_review_batch_decisions(
|
|
365
|
+
batch: Mapping[str, Any],
|
|
366
|
+
decisions: Mapping[str, Any],
|
|
367
|
+
) -> dict[str, Any]:
|
|
368
|
+
"""Validate decisions against exact batch and candidate digests without effects."""
|
|
369
|
+
|
|
370
|
+
batch_payload = _object(batch, "batch")
|
|
371
|
+
decision_payload = _object(decisions, "decisions")
|
|
372
|
+
if batch_payload.get("schema_version") != BATCH_SCHEMA:
|
|
373
|
+
raise ValueError(f"batch must use {BATCH_SCHEMA}")
|
|
374
|
+
if decision_payload.get("schema_version") != DECISIONS_SCHEMA:
|
|
375
|
+
raise ValueError(f"decisions must use {DECISIONS_SCHEMA}")
|
|
376
|
+
_reject_raw_keys(batch_payload, "batch")
|
|
377
|
+
_reject_raw_keys(decision_payload, "decisions")
|
|
378
|
+
batch_id = _token(batch_payload.get("batch_id"), "batch.batch_id")
|
|
379
|
+
if batch_payload.get("batch_id") != batch_id:
|
|
380
|
+
raise ValueError("batch.batch_id must be normalized")
|
|
381
|
+
raw_policy = _object(batch_payload.get("policy"), "batch.policy")
|
|
382
|
+
policy = _normalize_policy(raw_policy)
|
|
383
|
+
if raw_policy != policy:
|
|
384
|
+
raise ValueError("batch.policy must be normalized")
|
|
385
|
+
candidates = _list(batch_payload.get("candidates"), "batch.candidates")
|
|
386
|
+
candidate_by_id: dict[str, dict[str, Any]] = {}
|
|
387
|
+
candidate_digests: list[str] = []
|
|
388
|
+
for index, value in enumerate(candidates):
|
|
389
|
+
label = f"batch.candidates[{index}]"
|
|
390
|
+
candidate = _object(value, label)
|
|
391
|
+
candidate_id = _token(candidate.get("candidate_id"), f"{label}.candidate_id")
|
|
392
|
+
if candidate.get("candidate_id") != candidate_id:
|
|
393
|
+
raise ValueError(f"{label}.candidate_id must be normalized")
|
|
394
|
+
if candidate_id in candidate_by_id:
|
|
395
|
+
raise ValueError(f"duplicate batch candidate_id {candidate_id!r}")
|
|
396
|
+
supplied_candidate_digest = _text(
|
|
397
|
+
candidate.get("decision_digest"), f"{label}.decision_digest"
|
|
398
|
+
)
|
|
399
|
+
expected_candidate_digest = _candidate_decision_digest(candidate)
|
|
400
|
+
if supplied_candidate_digest != expected_candidate_digest:
|
|
401
|
+
raise ValueError(
|
|
402
|
+
f"batch candidate digest does not match candidate {candidate_id!r}"
|
|
403
|
+
)
|
|
404
|
+
candidate_by_id[candidate_id] = candidate
|
|
405
|
+
candidate_digests.append(supplied_candidate_digest)
|
|
406
|
+
expected_batch_digest = _text(batch_payload.get("decision_digest"), "batch.decision_digest")
|
|
407
|
+
recomputed_batch_digest = _batch_decision_digest(
|
|
408
|
+
batch_id=batch_id,
|
|
409
|
+
policy=policy,
|
|
410
|
+
candidate_decision_digests=candidate_digests,
|
|
411
|
+
)
|
|
412
|
+
if expected_batch_digest != recomputed_batch_digest:
|
|
413
|
+
raise ValueError("batch decision digest does not match the exact review batch")
|
|
414
|
+
supplied_batch_digest = _text(
|
|
415
|
+
decision_payload.get("decision_digest"), "decisions.decision_digest"
|
|
416
|
+
)
|
|
417
|
+
if supplied_batch_digest != expected_batch_digest:
|
|
418
|
+
raise ValueError("decision batch digest does not match the exact review batch")
|
|
419
|
+
allowed = set(policy["decision_values"])
|
|
420
|
+
bound: list[dict[str, Any]] = []
|
|
421
|
+
seen: set[str] = set()
|
|
422
|
+
for index, value in enumerate(_list(decision_payload.get("decisions"), "decisions.decisions")):
|
|
423
|
+
label = f"decisions.decisions[{index}]"
|
|
424
|
+
item = _object(value, label)
|
|
425
|
+
candidate_id = _token(item.get("candidate_id"), f"{label}.candidate_id")
|
|
426
|
+
if candidate_id in seen:
|
|
427
|
+
raise ValueError(f"duplicate decision for {candidate_id!r}")
|
|
428
|
+
seen.add(candidate_id)
|
|
429
|
+
candidate = candidate_by_id.get(candidate_id)
|
|
430
|
+
if candidate is None:
|
|
431
|
+
raise ValueError(f"decision references unknown candidate {candidate_id!r}")
|
|
432
|
+
supplied_candidate_digest = _text(
|
|
433
|
+
item.get("candidate_decision_digest"), f"{label}.candidate_decision_digest"
|
|
434
|
+
)
|
|
435
|
+
if supplied_candidate_digest != candidate.get("decision_digest"):
|
|
436
|
+
raise ValueError(f"decision digest does not match candidate {candidate_id!r}")
|
|
437
|
+
decision = _token(item.get("decision"), f"{label}.decision")
|
|
438
|
+
if decision not in allowed:
|
|
439
|
+
raise ValueError(f"decision {decision!r} is not allowed by the batch policy")
|
|
440
|
+
bound.append(
|
|
441
|
+
{
|
|
442
|
+
"candidate_id": candidate_id,
|
|
443
|
+
"candidate_decision_digest": supplied_candidate_digest,
|
|
444
|
+
"decision": decision,
|
|
445
|
+
"note": _optional_text(item.get("note"), f"{label}.note", maximum=600),
|
|
446
|
+
}
|
|
447
|
+
)
|
|
448
|
+
receipt_input = {
|
|
449
|
+
"batch_id": batch_payload.get("batch_id"),
|
|
450
|
+
"decision_digest": expected_batch_digest,
|
|
451
|
+
"decisions": bound,
|
|
452
|
+
}
|
|
453
|
+
return {
|
|
454
|
+
"ok": True,
|
|
455
|
+
"schema_version": DECISION_RECEIPT_SCHEMA,
|
|
456
|
+
**receipt_input,
|
|
457
|
+
"receipt_id": _digest(receipt_input, prefix="decision_receipt"),
|
|
458
|
+
"boundary": {
|
|
459
|
+
"exact_digest_binding": True,
|
|
460
|
+
"external_writes_performed": False,
|
|
461
|
+
"raw_content_persisted": False,
|
|
462
|
+
},
|
|
463
|
+
}
|