agentic-project-kit 1.0.1__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.
- agentic_project_kit/__init__.py +1 -0
- agentic_project_kit/absolute_path_portability_audit.py +241 -0
- agentic_project_kit/access_level_policy.py +14 -0
- agentic_project_kit/access_levels.py +22 -0
- agentic_project_kit/action_registry.py +195 -0
- agentic_project_kit/action_specs.py +286 -0
- agentic_project_kit/agent_command_runner.py +516 -0
- agentic_project_kit/audit_test_matrix.py +36 -0
- agentic_project_kit/audit_test_matrix_cli.py +43 -0
- agentic_project_kit/chat_bootloader.py +257 -0
- agentic_project_kit/chat_entrypoint_contract.py +297 -0
- agentic_project_kit/checks.py +511 -0
- agentic_project_kit/ci_readiness.py +211 -0
- agentic_project_kit/cli.py +147 -0
- agentic_project_kit/cli_commands/__init__.py +1 -0
- agentic_project_kit/cli_commands/absolute_path_audit.py +25 -0
- agentic_project_kit/cli_commands/actions.py +21 -0
- agentic_project_kit/cli_commands/artifact_gc.py +240 -0
- agentic_project_kit/cli_commands/boot.py +55 -0
- agentic_project_kit/cli_commands/chat.py +34 -0
- agentic_project_kit/cli_commands/checks.py +305 -0
- agentic_project_kit/cli_commands/cockpit.py +103 -0
- agentic_project_kit/cli_commands/command_taxonomy.py +25 -0
- agentic_project_kit/cli_commands/commands.py +129 -0
- agentic_project_kit/cli_commands/dev.py +23 -0
- agentic_project_kit/cli_commands/direction.py +92 -0
- agentic_project_kit/cli_commands/doc_currency_audit.py +25 -0
- agentic_project_kit/cli_commands/doc_registry.py +126 -0
- agentic_project_kit/cli_commands/docs.py +223 -0
- agentic_project_kit/cli_commands/dpa.py +1338 -0
- agentic_project_kit/cli_commands/evidence.py +251 -0
- agentic_project_kit/cli_commands/github.py +34 -0
- agentic_project_kit/cli_commands/governance.py +14 -0
- agentic_project_kit/cli_commands/gui.py +23 -0
- agentic_project_kit/cli_commands/gui_readiness_gate.py +27 -0
- agentic_project_kit/cli_commands/handoff.py +183 -0
- agentic_project_kit/cli_commands/human_workflows.py +430 -0
- agentic_project_kit/cli_commands/init.py +132 -0
- agentic_project_kit/cli_commands/instruction.py +75 -0
- agentic_project_kit/cli_commands/mutation_lock_audit.py +24 -0
- agentic_project_kit/cli_commands/ns_legacy_audit.py +25 -0
- agentic_project_kit/cli_commands/pass_already_done.py +66 -0
- agentic_project_kit/cli_commands/patch_failure_discipline_audit.py +26 -0
- agentic_project_kit/cli_commands/patch_preflight.py +37 -0
- agentic_project_kit/cli_commands/path_literal_audit.py +39 -0
- agentic_project_kit/cli_commands/patterns.py +40 -0
- agentic_project_kit/cli_commands/planning_docs_audit.py +25 -0
- agentic_project_kit/cli_commands/pr.py +133 -0
- agentic_project_kit/cli_commands/pr_hygiene.py +27 -0
- agentic_project_kit/cli_commands/profiles.py +26 -0
- agentic_project_kit/cli_commands/program_redundancy_audit.py +25 -0
- agentic_project_kit/cli_commands/project_direction.py +25 -0
- agentic_project_kit/cli_commands/release.py +392 -0
- agentic_project_kit/cli_commands/release_publish_orchestration.py +36 -0
- agentic_project_kit/cli_commands/remote_branch_hygiene.py +152 -0
- agentic_project_kit/cli_commands/remote_next.py +57 -0
- agentic_project_kit/cli_commands/removed_ns_commands.py +65 -0
- agentic_project_kit/cli_commands/rule_registry.py +129 -0
- agentic_project_kit/cli_commands/rules.py +222 -0
- agentic_project_kit/cli_commands/scaffold.py +46 -0
- agentic_project_kit/cli_commands/slice.py +21 -0
- agentic_project_kit/cli_commands/standard_gates_audit_suite.py +27 -0
- agentic_project_kit/cli_commands/state.py +51 -0
- agentic_project_kit/cli_commands/status_current_state_audit.py +30 -0
- agentic_project_kit/cli_commands/todo.py +53 -0
- agentic_project_kit/cli_commands/transfer.py +19 -0
- agentic_project_kit/cli_commands/transfer_context_flow.py +398 -0
- agentic_project_kit/cli_commands/transfer_context_helpers.py +398 -0
- agentic_project_kit/cli_commands/transfer_diagnostics.py +767 -0
- agentic_project_kit/cli_commands/transfer_evidence_flow.py +368 -0
- agentic_project_kit/cli_commands/transfer_handoff_flow.py +594 -0
- agentic_project_kit/cli_commands/transfer_order_contract.py +74 -0
- agentic_project_kit/cli_commands/transfer_post_merge_complete.py +442 -0
- agentic_project_kit/cli_commands/transfer_post_merge_settle.py +171 -0
- agentic_project_kit/cli_commands/transfer_pr_closeout_complete.py +124 -0
- agentic_project_kit/cli_commands/transfer_pr_create_flow.py +743 -0
- agentic_project_kit/cli_commands/transfer_pr_merge_flow.py +547 -0
- agentic_project_kit/cli_commands/transfer_repo_after_pr.py +160 -0
- agentic_project_kit/cli_commands/transfer_repo_pre_pr.py +664 -0
- agentic_project_kit/cli_commands/transfer_runner_flow.py +131 -0
- agentic_project_kit/cli_commands/transfer_runtime_initial.py +194 -0
- agentic_project_kit/cli_commands/transfer_shared.py +274 -0
- agentic_project_kit/cli_commands/validation.py +200 -0
- agentic_project_kit/cli_commands/version.py +27 -0
- agentic_project_kit/cli_commands/work_orders.py +219 -0
- agentic_project_kit/cli_commands/workflow.py +471 -0
- agentic_project_kit/cli_commands/workflow_guard.py +26 -0
- agentic_project_kit/cli_commands/workspace.py +252 -0
- agentic_project_kit/cockpit.py +608 -0
- agentic_project_kit/cockpit_readiness.py +67 -0
- agentic_project_kit/command_authority_audit.py +192 -0
- agentic_project_kit/command_inbox_check.py +103 -0
- agentic_project_kit/command_manifest.py +591 -0
- agentic_project_kit/command_queue_contract.py +161 -0
- agentic_project_kit/command_selector.py +245 -0
- agentic_project_kit/command_taxonomy.py +264 -0
- agentic_project_kit/commit_guard.py +67 -0
- agentic_project_kit/communication_artifact_gc.py +495 -0
- agentic_project_kit/communication_rule_context.py +437 -0
- agentic_project_kit/communication_state.py +115 -0
- agentic_project_kit/composed_wrapper_invariants.py +97 -0
- agentic_project_kit/composite_short_circuit.py +140 -0
- agentic_project_kit/contract.py +251 -0
- agentic_project_kit/control_state.py +83 -0
- agentic_project_kit/doc_currency_audit.py +536 -0
- agentic_project_kit/doc_lifecycle.py +1179 -0
- agentic_project_kit/doc_lifecycle_signals.py +446 -0
- agentic_project_kit/doc_lifecycle_sweep.py +639 -0
- agentic_project_kit/doc_mesh.py +491 -0
- agentic_project_kit/doctor.py +379 -0
- agentic_project_kit/documentation_registry.py +1122 -0
- agentic_project_kit/documentation_system_audit.py +310 -0
- agentic_project_kit/dpa_current_handoff_lifecycle.py +549 -0
- agentic_project_kit/dpa_dp2_decision_readiness.py +362 -0
- agentic_project_kit/dpa_dp3_dp4_adjudication.py +604 -0
- agentic_project_kit/dpa_dp5_block_new_gate.py +294 -0
- agentic_project_kit/dpa_dp5_stage_adoption.py +615 -0
- agentic_project_kit/dpa_dp5_strict_gate.py +187 -0
- agentic_project_kit/dpa_final_closeout.py +627 -0
- agentic_project_kit/dpa_fixture_evidence.py +680 -0
- agentic_project_kit/dpa_maintainer_record_check.py +711 -0
- agentic_project_kit/dpa_post_dp2_scope_assessment.py +734 -0
- agentic_project_kit/dpa_probe_002_readiness.py +509 -0
- agentic_project_kit/dpa_probe_003_readiness.py +417 -0
- agentic_project_kit/dpa_probe_004_readiness.py +437 -0
- agentic_project_kit/dpa_readiness.py +505 -0
- agentic_project_kit/dpa_readonly_probe_execution.py +500 -0
- agentic_project_kit/dpa_registry_contracts.py +312 -0
- agentic_project_kit/dpa_renderer_readiness.py +407 -0
- agentic_project_kit/dpa_repo_adoption_assessment.py +574 -0
- agentic_project_kit/dpa_stable_readiness.py +743 -0
- agentic_project_kit/dpa_successor_projection.py +168 -0
- agentic_project_kit/dpa_workspace_init_projection.py +93 -0
- agentic_project_kit/dpa_wrt_ch001_evidence.py +327 -0
- agentic_project_kit/entrypoint_slice_runner.py +153 -0
- agentic_project_kit/evidence_clean.py +152 -0
- agentic_project_kit/evidence_commit_paths.py +214 -0
- agentic_project_kit/evidence_finalize_log.py +204 -0
- agentic_project_kit/evidence_guard.py +114 -0
- agentic_project_kit/evidence_inspector.py +507 -0
- agentic_project_kit/evidence_state_contract.py +99 -0
- agentic_project_kit/execution_mode_state.py +148 -0
- agentic_project_kit/final_summary_contract.py +85 -0
- agentic_project_kit/finalize_guard.py +139 -0
- agentic_project_kit/gatekeeper_core.py +232 -0
- agentic_project_kit/github.py +25 -0
- agentic_project_kit/governance.py +59 -0
- agentic_project_kit/gui_action_execution.py +105 -0
- agentic_project_kit/gui_action_renderer.py +81 -0
- agentic_project_kit/gui_action_run_intent.py +98 -0
- agentic_project_kit/gui_action_views.py +195 -0
- agentic_project_kit/gui_activity_log.py +76 -0
- agentic_project_kit/gui_button_catalog.py +605 -0
- agentic_project_kit/gui_cockpit.py +365 -0
- agentic_project_kit/gui_cockpit_actions.py +695 -0
- agentic_project_kit/gui_cockpit_common.py +172 -0
- agentic_project_kit/gui_cockpit_header.py +501 -0
- agentic_project_kit/gui_cockpit_sidebar.py +387 -0
- agentic_project_kit/gui_cockpit_task.py +748 -0
- agentic_project_kit/gui_command_projection.py +355 -0
- agentic_project_kit/gui_communication_modes.py +130 -0
- agentic_project_kit/gui_dry_run.py +219 -0
- agentic_project_kit/gui_gatekeeper_status.py +259 -0
- agentic_project_kit/gui_layout_plan.py +148 -0
- agentic_project_kit/gui_open_folder.py +18 -0
- agentic_project_kit/gui_output_status_panel.py +61 -0
- agentic_project_kit/gui_panel_state.py +47 -0
- agentic_project_kit/gui_presenter.py +62 -0
- agentic_project_kit/gui_readiness_gate.py +206 -0
- agentic_project_kit/gui_release_flow.py +59 -0
- agentic_project_kit/gui_task_editor.py +1077 -0
- agentic_project_kit/gui_tk_widgets.py +177 -0
- agentic_project_kit/gui_tkinter_renderer.py +87 -0
- agentic_project_kit/gui_tkinter_shell.py +1176 -0
- agentic_project_kit/gui_transfer_contract.py +28 -0
- agentic_project_kit/gui_viewmodel.py +698 -0
- agentic_project_kit/gui_window_guard.py +46 -0
- agentic_project_kit/handoff_freshness.py +390 -0
- agentic_project_kit/handoff_prompt.py +180 -0
- agentic_project_kit/handoff_state.py +254 -0
- agentic_project_kit/instruction_lint.py +455 -0
- agentic_project_kit/llm_context_carriers.py +66 -0
- agentic_project_kit/llm_execution_context.py +285 -0
- agentic_project_kit/local_command_stack.py +133 -0
- agentic_project_kit/local_feature_gate.py +82 -0
- agentic_project_kit/local_garbage_collector.py +269 -0
- agentic_project_kit/models.py +18 -0
- agentic_project_kit/mutation_lock_audit.py +421 -0
- agentic_project_kit/next_turn_evidence.py +253 -0
- agentic_project_kit/next_turn_merge_if_green.py +459 -0
- agentic_project_kit/next_turn_pr_status.py +255 -0
- agentic_project_kit/next_turn_result.py +183 -0
- agentic_project_kit/next_turn_runner.py +159 -0
- agentic_project_kit/next_turn_slot.py +107 -0
- agentic_project_kit/next_turn_status.py +274 -0
- agentic_project_kit/ns_legacy_reference_audit.py +258 -0
- agentic_project_kit/ns_slice_runner.py +16 -0
- agentic_project_kit/operational_handoff_projection.py +124 -0
- agentic_project_kit/output_contract.py +80 -0
- agentic_project_kit/output_repair.py +61 -0
- agentic_project_kit/pass_already_done.py +216 -0
- agentic_project_kit/patch_artifact_preflight.py +147 -0
- agentic_project_kit/patch_cycle_workflow.py +440 -0
- agentic_project_kit/patch_failure_discipline_audit.py +223 -0
- agentic_project_kit/patch_preflight.py +215 -0
- agentic_project_kit/path_literal_audit.py +612 -0
- agentic_project_kit/patterns.py +99 -0
- agentic_project_kit/planning_docs_consolidation_audit.py +313 -0
- agentic_project_kit/portability_shell_gate.py +40 -0
- agentic_project_kit/post_merge_handoff_refresh.py +56 -0
- agentic_project_kit/post_release.py +252 -0
- agentic_project_kit/post_release_closeout.py +616 -0
- agentic_project_kit/pr_cleanup.py +172 -0
- agentic_project_kit/pr_closeout.py +50 -0
- agentic_project_kit/pr_closeout_complete.py +344 -0
- agentic_project_kit/pr_create_or_skip.py +71 -0
- agentic_project_kit/pr_hygiene.py +210 -0
- agentic_project_kit/program_redundancy_audit.py +251 -0
- agentic_project_kit/project_direction.py +840 -0
- agentic_project_kit/protected_change_planner.py +194 -0
- agentic_project_kit/release.py +401 -0
- agentic_project_kit/release_doi_safety.py +24 -0
- agentic_project_kit/release_gate_core.py +174 -0
- agentic_project_kit/release_metadata_authority_gate.py +328 -0
- agentic_project_kit/release_metadata_prep.py +43 -0
- agentic_project_kit/release_notes.py +823 -0
- agentic_project_kit/release_prep_core.py +204 -0
- agentic_project_kit/release_prepare.py +369 -0
- agentic_project_kit/release_process_guardrails.py +247 -0
- agentic_project_kit/release_publish_core.py +114 -0
- agentic_project_kit/release_publish_orchestration.py +469 -0
- agentic_project_kit/release_state.py +552 -0
- agentic_project_kit/release_verify_core.py +175 -0
- agentic_project_kit/remote_branch_hygiene.py +223 -0
- agentic_project_kit/remote_next.py +89 -0
- agentic_project_kit/remote_next_closeout.py +101 -0
- agentic_project_kit/remote_next_order_contract.py +391 -0
- agentic_project_kit/removed_ns_commands.py +458 -0
- agentic_project_kit/removed_source_audit.py +225 -0
- agentic_project_kit/rendering.py +13 -0
- agentic_project_kit/repair_report.py +79 -0
- agentic_project_kit/repo_identity.py +59 -0
- agentic_project_kit/result_report_classifier.py +57 -0
- agentic_project_kit/rule_ack.py +105 -0
- agentic_project_kit/rule_preservation.py +58 -0
- agentic_project_kit/rule_refresh.py +174 -0
- agentic_project_kit/rule_registry_registration.py +322 -0
- agentic_project_kit/rule_registry_report.py +206 -0
- agentic_project_kit/rule_registry_validator.py +704 -0
- agentic_project_kit/rule_snapshot.py +98 -0
- agentic_project_kit/rule_source_validator.py +133 -0
- agentic_project_kit/run_summary.py +68 -0
- agentic_project_kit/run_summary_renderer.py +238 -0
- agentic_project_kit/runtime_validator.py +68 -0
- agentic_project_kit/safe_file_replace.py +35 -0
- agentic_project_kit/safe_patch.py +47 -0
- agentic_project_kit/safe_push.py +218 -0
- agentic_project_kit/safe_remove_diagnostic.py +51 -0
- agentic_project_kit/scaffold.py +69 -0
- agentic_project_kit/site_claims.py +444 -0
- agentic_project_kit/site_generator.py +1140 -0
- agentic_project_kit/slice_gate.py +225 -0
- agentic_project_kit/slice_runner.py +75 -0
- agentic_project_kit/standard_gates_audit_suite.py +167 -0
- agentic_project_kit/state_freshness.py +135 -0
- agentic_project_kit/status_current_state_audit.py +762 -0
- agentic_project_kit/successor_handoff_package.py +1763 -0
- agentic_project_kit/templates.py +292 -0
- agentic_project_kit/terminal_block_guard.py +166 -0
- agentic_project_kit/terminal_logging.py +275 -0
- agentic_project_kit/todo.py +97 -0
- agentic_project_kit/transfer_closeout.py +136 -0
- agentic_project_kit/transfer_continue.py +215 -0
- agentic_project_kit/transfer_local_runner.py +101 -0
- agentic_project_kit/transfer_operation_monitor.py +236 -0
- agentic_project_kit/transfer_post_merge_lifecycle.py +356 -0
- agentic_project_kit/transfer_post_merge_settle.py +383 -0
- agentic_project_kit/transfer_pr_actions.py +164 -0
- agentic_project_kit/transfer_remote_next.py +959 -0
- agentic_project_kit/transfer_repo_actions.py +2253 -0
- agentic_project_kit/transfer_runner.py +347 -0
- agentic_project_kit/transfer_safety_context.py +291 -0
- agentic_project_kit/transfer_state.py +483 -0
- agentic_project_kit/transfer_uplink.py +471 -0
- agentic_project_kit/transfer_workflow_next.py +148 -0
- agentic_project_kit/typed_work_order_evidence.py +58 -0
- agentic_project_kit/typed_work_order_queue.py +166 -0
- agentic_project_kit/typed_work_order_runner.py +168 -0
- agentic_project_kit/work_cycle.py +317 -0
- agentic_project_kit/work_discard_changes.py +129 -0
- agentic_project_kit/work_order_patch.py +199 -0
- agentic_project_kit/work_order_runner.py +120 -0
- agentic_project_kit/work_order_uploader.py +220 -0
- agentic_project_kit/work_order_validator.py +185 -0
- agentic_project_kit/work_orders.py +246 -0
- agentic_project_kit/workflow_guard.py +262 -0
- agentic_project_kit/workflow_summary_runner.py +124 -0
- agentic_project_kit/workspace.py +665 -0
- agentic_project_kit/workspace_adopt.py +471 -0
- agentic_project_kit/workspace_dpa_intake.py +406 -0
- agentic_project_kit/workspace_init.py +487 -0
- agentic_project_kit/workspace_lock.py +129 -0
- agentic_project_kit/workspace_remove.py +381 -0
- agentic_project_kit/workspace_upgrade.py +324 -0
- agentic_project_kit/wrapper_live_status.py +104 -0
- agentic_project_kit-1.0.1.dist-info/METADATA +724 -0
- agentic_project_kit-1.0.1.dist-info/RECORD +310 -0
- agentic_project_kit-1.0.1.dist-info/WHEEL +4 -0
- agentic_project_kit-1.0.1.dist-info/entry_points.txt +3 -0
- agentic_project_kit-1.0.1.dist-info/licenses/LICENSE +10 -0
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
from dataclasses import dataclass
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
import argparse
|
|
6
|
+
import re
|
|
7
|
+
import sys
|
|
8
|
+
|
|
9
|
+
PROTECTED_FILES = {
|
|
10
|
+
".agentic/compiled_agent_context.yaml",
|
|
11
|
+
".agentic/handoff_state.yaml",
|
|
12
|
+
".agentic/control_file_preservation.yaml",
|
|
13
|
+
".agentic/rule_mechanism_inventory.yaml",
|
|
14
|
+
"docs/DOCUMENTATION_REGISTRY.yaml",
|
|
15
|
+
"docs/governance/FINAL_SUMMARY_CONTRACT.md",
|
|
16
|
+
"docs/governance/PROTECTED_CONTROL_FILE_CHANGE_CONTRACT.md",
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
VALID_DECISIONS = {"keep", "migrate", "obsolete", "abort"}
|
|
20
|
+
LARGE_PROTECTED_REMOVAL_THRESHOLD = 20
|
|
21
|
+
|
|
22
|
+
GENERATED_ARTIFACTS = {
|
|
23
|
+
"docs/handoff/NEXT_CHAT_BOOTSTRAP.md": (
|
|
24
|
+
"src/agentic_project_kit/successor_handoff_package.py",
|
|
25
|
+
"src/agentic_project_kit/chat_bootloader.py",
|
|
26
|
+
"src/agentic_project_kit/operational_handoff_projection.py",
|
|
27
|
+
".agentic/operational_handoff_state.yaml",
|
|
28
|
+
),
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
SUCCESSOR_HANDOFF_PROJECTION_BUNDLE = {
|
|
32
|
+
"docs/reports/handoff-packages/latest/execution_contract.json",
|
|
33
|
+
"docs/reports/handoff-packages/latest/successor_context.yaml",
|
|
34
|
+
"docs/reports/handoff-packages/latest/successor_prompt.md",
|
|
35
|
+
"docs/reports/handoff-packages/latest/validation_report.json",
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
ANCHORS = {
|
|
39
|
+
".agentic/compiled_agent_context.yaml": {"hard_rules", "final_summary_contract", "communication_rules", "normal_operator_path"},
|
|
40
|
+
".agentic/handoff_state.yaml": {"safe_state", "release", "recent_failure_patterns"},
|
|
41
|
+
".agentic/rule_mechanism_inventory.yaml": {"mechanisms"},
|
|
42
|
+
"docs/DOCUMENTATION_REGISTRY.yaml": {"documents"},
|
|
43
|
+
"docs/governance/FINAL_SUMMARY_CONTRACT.md": {"WORK RESULT", "OVERALL RESULT", "NEXT_CHAT_REPLY"},
|
|
44
|
+
"docs/governance/PROTECTED_CONTROL_FILE_CHANGE_CONTRACT.md": {"migration record", "user decision", "protected_control"},
|
|
45
|
+
}
|
|
46
|
+
YAML_PROTECTED_FILES = {
|
|
47
|
+
".agentic/compiled_agent_context.yaml",
|
|
48
|
+
".agentic/handoff_state.yaml",
|
|
49
|
+
".agentic/control_file_preservation.yaml",
|
|
50
|
+
".agentic/rule_mechanism_inventory.yaml",
|
|
51
|
+
"docs/DOCUMENTATION_REGISTRY.yaml",
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
@dataclass(frozen=True)
|
|
55
|
+
class ProtectedChangeFinding:
|
|
56
|
+
path: str
|
|
57
|
+
severity: str
|
|
58
|
+
code: str
|
|
59
|
+
message: str
|
|
60
|
+
|
|
61
|
+
def touched_files(diff_text: str) -> set[str]:
|
|
62
|
+
touched: set[str] = set()
|
|
63
|
+
for line in diff_text.splitlines():
|
|
64
|
+
if line.startswith("diff --git "):
|
|
65
|
+
parts = line.split()
|
|
66
|
+
for part in parts[2:]:
|
|
67
|
+
candidate = part[2:] if part.startswith(("a/", "b/")) else part
|
|
68
|
+
touched.add(candidate)
|
|
69
|
+
return touched
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
def touched_protected_files(diff_text: str) -> set[str]:
|
|
73
|
+
return touched_files(diff_text) & PROTECTED_FILES
|
|
74
|
+
|
|
75
|
+
def removed_lines_for_path(diff_text: str, path: str) -> list[str]:
|
|
76
|
+
lines: list[str] = []
|
|
77
|
+
active = False
|
|
78
|
+
for line in diff_text.splitlines():
|
|
79
|
+
if line.startswith("diff --git "):
|
|
80
|
+
active = (" a/" + path + " ") in line or (" b/" + path) in line or line.endswith(" " + "b/" + path)
|
|
81
|
+
continue
|
|
82
|
+
if active and line.startswith("-") and not line.startswith("---"):
|
|
83
|
+
lines.append(line[1:])
|
|
84
|
+
return lines
|
|
85
|
+
|
|
86
|
+
def added_lines_for_path(diff_text: str, path: str) -> list[str]:
|
|
87
|
+
lines: list[str] = []
|
|
88
|
+
active = False
|
|
89
|
+
for line in diff_text.splitlines():
|
|
90
|
+
if line.startswith("diff --git "):
|
|
91
|
+
active = (" a/" + path + " ") in line or (" b/" + path) in line or line.endswith(" " + "b/" + path)
|
|
92
|
+
continue
|
|
93
|
+
if active and line.startswith("+") and not line.startswith("+++"):
|
|
94
|
+
lines.append(line[1:])
|
|
95
|
+
return lines
|
|
96
|
+
|
|
97
|
+
def _has_valid_decision(path: str, decisions: dict[str, str]) -> bool:
|
|
98
|
+
return decisions.get(path) in VALID_DECISIONS
|
|
99
|
+
|
|
100
|
+
|
|
101
|
+
def _migration_record_decisions(diff_text: str) -> dict[str, str]:
|
|
102
|
+
decisions: dict[str, str] = {}
|
|
103
|
+
added_text = "\n".join(
|
|
104
|
+
line[1:]
|
|
105
|
+
for line in diff_text.splitlines()
|
|
106
|
+
if line.startswith("+") and not line.startswith("+++")
|
|
107
|
+
)
|
|
108
|
+
if "protected_control" not in added_text and "migration record" not in added_text.lower():
|
|
109
|
+
return decisions
|
|
110
|
+
for path in PROTECTED_FILES:
|
|
111
|
+
if path not in added_text:
|
|
112
|
+
continue
|
|
113
|
+
match = re.search(r"(?im)^\s*decision\s*:\s*(keep|migrate|obsolete|abort)\s*$", added_text)
|
|
114
|
+
if match:
|
|
115
|
+
decisions[path] = match.group(1)
|
|
116
|
+
return decisions
|
|
117
|
+
|
|
118
|
+
|
|
119
|
+
def _contains_anchor(path: str, text: str, anchor: str) -> bool:
|
|
120
|
+
if path in YAML_PROTECTED_FILES:
|
|
121
|
+
return re.search(rf"(?m)^\s*{re.escape(anchor)}\s*:", text) is not None
|
|
122
|
+
return anchor in text
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
def _is_handoff_state_refresh(path: str, added_text: str) -> bool:
|
|
126
|
+
if path != ".agentic/handoff_state.yaml":
|
|
127
|
+
return False
|
|
128
|
+
required_anchors = {"safe_state", "handoff_maintenance", "next_step"}
|
|
129
|
+
candidate_text = added_text
|
|
130
|
+
current_path = Path(path)
|
|
131
|
+
if current_path.exists():
|
|
132
|
+
candidate_text = candidate_text + "\n" + current_path.read_text(encoding="utf-8", errors="replace")
|
|
133
|
+
return (
|
|
134
|
+
"source: agentic-kit handoff refresh" in candidate_text
|
|
135
|
+
and all(_contains_anchor(path, candidate_text, anchor) for anchor in required_anchors)
|
|
136
|
+
)
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
def _is_successor_handoff_projection_refresh(touched: set[str]) -> bool:
|
|
140
|
+
return SUCCESSOR_HANDOFF_PROJECTION_BUNDLE <= touched
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
def analyze_diff(diff_text: str, decisions: dict[str, str] | None = None) -> list[ProtectedChangeFinding]:
|
|
144
|
+
decisions = {**_migration_record_decisions(diff_text), **(decisions or {})}
|
|
145
|
+
findings: list[ProtectedChangeFinding] = []
|
|
146
|
+
touched = touched_files(diff_text)
|
|
147
|
+
for path, generator_sources in sorted(GENERATED_ARTIFACTS.items()):
|
|
148
|
+
if (
|
|
149
|
+
path in touched
|
|
150
|
+
and not any(source in touched for source in generator_sources)
|
|
151
|
+
and not _is_successor_handoff_projection_refresh(touched)
|
|
152
|
+
):
|
|
153
|
+
findings.append(ProtectedChangeFinding(path, "block", "generated-artifact-direct-edit", "generated artifact changed without its generator source; use the generator path instead of direct editing"))
|
|
154
|
+
for path in sorted(touched & PROTECTED_FILES):
|
|
155
|
+
removed = removed_lines_for_path(diff_text, path)
|
|
156
|
+
added = added_lines_for_path(diff_text, path)
|
|
157
|
+
has_valid_decision = _has_valid_decision(path, decisions)
|
|
158
|
+
if len(removed) >= LARGE_PROTECTED_REMOVAL_THRESHOLD and not has_valid_decision:
|
|
159
|
+
added_text = "\n".join(added)
|
|
160
|
+
if len(added) >= LARGE_PROTECTED_REMOVAL_THRESHOLD and _is_handoff_state_refresh(path, added_text):
|
|
161
|
+
pass
|
|
162
|
+
elif len(added) >= LARGE_PROTECTED_REMOVAL_THRESHOLD:
|
|
163
|
+
findings.append(ProtectedChangeFinding(path, "block", "large-protected-file-rewrite-without-decision", "large protected-file rewrite requires keep/migrate/obsolete/abort decision before replacement-style editing"))
|
|
164
|
+
else:
|
|
165
|
+
findings.append(ProtectedChangeFinding(path, "block", "possible-full-replacement-or-large-deletion", "large protected-file deletion requires migration record or user decision"))
|
|
166
|
+
removed_text = "\n".join(removed)
|
|
167
|
+
added_text = "\n".join(added)
|
|
168
|
+
for anchor in ANCHORS.get(path, set()):
|
|
169
|
+
if _contains_anchor(path, removed_text, anchor) and not _contains_anchor(path, added_text, anchor):
|
|
170
|
+
if not has_valid_decision:
|
|
171
|
+
findings.append(ProtectedChangeFinding(path, "block", "protected-anchor-removal-without-decision", f"anchor {anchor!r} removed without keep/migrate/obsolete/abort decision"))
|
|
172
|
+
return findings
|
|
173
|
+
|
|
174
|
+
def render_findings(findings: list[ProtectedChangeFinding]) -> str:
|
|
175
|
+
if not findings:
|
|
176
|
+
return "PROTECTED_CHANGE_PLAN\nresult=PASS\nfindings=0\n### RESULT: PASS ###\n"
|
|
177
|
+
out = ["PROTECTED_CHANGE_PLAN", "result=BLOCK", f"findings={len(findings)}"]
|
|
178
|
+
for finding in findings:
|
|
179
|
+
out.append(f"- {finding.severity}:{finding.code}:{finding.path}: {finding.message}")
|
|
180
|
+
out.append("required_decision=keep|migrate|obsolete|abort")
|
|
181
|
+
out.append("### RESULT: FAIL ###")
|
|
182
|
+
return "\n".join(out) + "\n"
|
|
183
|
+
|
|
184
|
+
def main(argv: list[str] | None = None) -> int:
|
|
185
|
+
parser = argparse.ArgumentParser()
|
|
186
|
+
parser.add_argument("--diff-file", required=True)
|
|
187
|
+
args = parser.parse_args(argv)
|
|
188
|
+
diff_text = Path(args.diff_file).read_text(encoding="utf-8")
|
|
189
|
+
findings = analyze_diff(diff_text)
|
|
190
|
+
sys.stdout.write(render_findings(findings))
|
|
191
|
+
return 1 if findings else 0
|
|
192
|
+
|
|
193
|
+
if __name__ == "__main__":
|
|
194
|
+
raise SystemExit(main())
|
|
@@ -0,0 +1,401 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
from collections.abc import Callable, Sequence
|
|
4
|
+
from dataclasses import dataclass
|
|
5
|
+
from enum import Enum
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
import re
|
|
8
|
+
import subprocess
|
|
9
|
+
from typing import Any
|
|
10
|
+
|
|
11
|
+
from agentic_project_kit.documentation_registry import build_documentation_registry_summary
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
@dataclass(frozen=True)
|
|
15
|
+
class ReleaseStep:
|
|
16
|
+
name: str
|
|
17
|
+
commands: tuple[str, ...]
|
|
18
|
+
evidence: str
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
@dataclass(frozen=True)
|
|
22
|
+
class ReleasePlan:
|
|
23
|
+
version: str
|
|
24
|
+
steps: tuple[ReleaseStep, ...]
|
|
25
|
+
warnings: tuple[str, ...]
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
class ReleaseCheckStatus(str, Enum):
|
|
29
|
+
PASS = "PASS"
|
|
30
|
+
FAIL = "FAIL"
|
|
31
|
+
WARN = "WARN"
|
|
32
|
+
BLOCK = "BLOCK"
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
@dataclass(frozen=True)
|
|
36
|
+
class ReleaseCheckResult:
|
|
37
|
+
name: str
|
|
38
|
+
status: ReleaseCheckStatus
|
|
39
|
+
detail: str
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
@dataclass(frozen=True)
|
|
43
|
+
class ReleaseStateReport:
|
|
44
|
+
version: str
|
|
45
|
+
checks: tuple[ReleaseCheckResult, ...]
|
|
46
|
+
registry_summary: dict[str, Any] | None = None
|
|
47
|
+
|
|
48
|
+
@property
|
|
49
|
+
def ok(self) -> bool:
|
|
50
|
+
return self.outcome == ReleaseCheckStatus.PASS
|
|
51
|
+
|
|
52
|
+
@property
|
|
53
|
+
def outcome(self) -> ReleaseCheckStatus:
|
|
54
|
+
if any(check.status == ReleaseCheckStatus.FAIL for check in self.checks):
|
|
55
|
+
return ReleaseCheckStatus.FAIL
|
|
56
|
+
if any(check.status == ReleaseCheckStatus.BLOCK for check in self.checks):
|
|
57
|
+
return ReleaseCheckStatus.BLOCK
|
|
58
|
+
return ReleaseCheckStatus.PASS
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
@dataclass(frozen=True)
|
|
62
|
+
class CommandResult:
|
|
63
|
+
returncode: int
|
|
64
|
+
stdout: str
|
|
65
|
+
stderr: str
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
CommandRunner = Callable[[Path, Sequence[str]], CommandResult]
|
|
69
|
+
|
|
70
|
+
REMOTE_RELEASE_CHECK_NAMES = ("remote tag unused", "GitHub release unused")
|
|
71
|
+
|
|
72
|
+
|
|
73
|
+
def build_release_plan(project_root: Path, version: str | None = None) -> ReleasePlan:
|
|
74
|
+
resolved_version = version or read_project_version(project_root)
|
|
75
|
+
warnings = tuple(validate_version(resolved_version))
|
|
76
|
+
return ReleasePlan(
|
|
77
|
+
version=resolved_version,
|
|
78
|
+
steps=(
|
|
79
|
+
ReleaseStep(
|
|
80
|
+
name="Confirm clean repository state",
|
|
81
|
+
commands=("git status --short", "git log --oneline -8"),
|
|
82
|
+
evidence="No unexpected local changes; recent commits match intended release scope.",
|
|
83
|
+
),
|
|
84
|
+
ReleaseStep(
|
|
85
|
+
name="Run local quality gates",
|
|
86
|
+
commands=("python -m pytest -q", "ruff check .", "agentic-kit check-docs"),
|
|
87
|
+
evidence="Tests, linting, and state-gate checks pass.",
|
|
88
|
+
),
|
|
89
|
+
ReleaseStep(
|
|
90
|
+
name="Validate package artifacts",
|
|
91
|
+
commands=("python -m build", "twine check dist/*", "ls -lh dist/"),
|
|
92
|
+
evidence="Wheel and sdist build successfully and pass twine validation.",
|
|
93
|
+
),
|
|
94
|
+
ReleaseStep(
|
|
95
|
+
name="Check release notes and state files",
|
|
96
|
+
commands=(
|
|
97
|
+
"grep -n 'version = \"{version}\"' pyproject.toml".format(version=resolved_version),
|
|
98
|
+
"grep -n 'v{version}' CHANGELOG.md".format(version=resolved_version),
|
|
99
|
+
"grep -n 'Version `{version}`' README.md".format(version=resolved_version),
|
|
100
|
+
"grep -n 'version: {version}' CITATION.cff".format(version=resolved_version),
|
|
101
|
+
"grep -n 'Current version: {version}' docs/STATUS.md".format(version=resolved_version),
|
|
102
|
+
"grep -n 'Current version: {version}' docs/handoff/CURRENT_HANDOFF.md".format(
|
|
103
|
+
version=resolved_version
|
|
104
|
+
),
|
|
105
|
+
),
|
|
106
|
+
evidence="pyproject, CHANGELOG, README, CITATION, STATUS, and CURRENT_HANDOFF mention the target release version.",
|
|
107
|
+
),
|
|
108
|
+
ReleaseStep(
|
|
109
|
+
name="Verify target tag and release are unused",
|
|
110
|
+
commands=(
|
|
111
|
+
"git fetch --tags",
|
|
112
|
+
"git tag -l v{version}".format(version=resolved_version),
|
|
113
|
+
"git ls-remote --tags origin v{version}".format(version=resolved_version),
|
|
114
|
+
"gh release view v{version}".format(version=resolved_version),
|
|
115
|
+
),
|
|
116
|
+
evidence="Local tag, remote tag, and GitHub release lookups show no existing target release.",
|
|
117
|
+
),
|
|
118
|
+
ReleaseStep(
|
|
119
|
+
name="Create and verify tag",
|
|
120
|
+
commands=(
|
|
121
|
+
"git tag v{version}".format(version=resolved_version),
|
|
122
|
+
"git push origin v{version}".format(version=resolved_version),
|
|
123
|
+
"gh run list --workflow Release --limit 5",
|
|
124
|
+
"gh release view v{version}".format(version=resolved_version),
|
|
125
|
+
),
|
|
126
|
+
evidence="Release workflow succeeds and the GitHub release exists.",
|
|
127
|
+
),
|
|
128
|
+
),
|
|
129
|
+
warnings=warnings,
|
|
130
|
+
)
|
|
131
|
+
|
|
132
|
+
|
|
133
|
+
def build_release_state_report(
|
|
134
|
+
project_root: Path,
|
|
135
|
+
version: str | None = None,
|
|
136
|
+
command_runner: CommandRunner | None = None,
|
|
137
|
+
) -> ReleaseStateReport:
|
|
138
|
+
resolved_command_runner = command_runner or run_command
|
|
139
|
+
resolved_version = version or read_project_version(project_root)
|
|
140
|
+
checks = [
|
|
141
|
+
check_semantic_version(resolved_version),
|
|
142
|
+
check_file_contains(project_root / "pyproject.toml", f'version = "{resolved_version}"', "pyproject version"),
|
|
143
|
+
check_file_contains(project_root / "src/agentic_project_kit/__init__.py", f"__version__ = \"{resolved_version}\"", "package __version__"),
|
|
144
|
+
check_file_contains(project_root / "CHANGELOG.md", f"v{resolved_version}", "CHANGELOG version"),
|
|
145
|
+
check_file_contains(project_root / "README.md", f"Version `{resolved_version}`", "README version"),
|
|
146
|
+
check_file_contains(project_root / "CITATION.cff", f"version: {resolved_version}", "CITATION version"),
|
|
147
|
+
check_file_contains(project_root / "docs/STATUS.md", f"Current version: {resolved_version}", "STATUS version"),
|
|
148
|
+
check_file_contains(
|
|
149
|
+
project_root / "docs/handoff/CURRENT_HANDOFF.md",
|
|
150
|
+
f"Current version: {resolved_version}",
|
|
151
|
+
"CURRENT_HANDOFF version",
|
|
152
|
+
),
|
|
153
|
+
check_local_tag_absent(project_root, resolved_version, resolved_command_runner),
|
|
154
|
+
check_remote_tag_absent(project_root, resolved_version, resolved_command_runner),
|
|
155
|
+
check_github_release_absent(project_root, resolved_version, resolved_command_runner),
|
|
156
|
+
]
|
|
157
|
+
checks.append(check_release_publish_readiness(checks, block_on_warn=False))
|
|
158
|
+
return ReleaseStateReport(
|
|
159
|
+
version=resolved_version,
|
|
160
|
+
checks=tuple(checks),
|
|
161
|
+
registry_summary=_load_registry_summary(project_root),
|
|
162
|
+
)
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
def build_release_preflight_report(
|
|
166
|
+
project_root: Path,
|
|
167
|
+
version: str,
|
|
168
|
+
command_runner: CommandRunner | None = None,
|
|
169
|
+
) -> ReleaseStateReport:
|
|
170
|
+
resolved_command_runner = command_runner or run_command
|
|
171
|
+
checks = [
|
|
172
|
+
check_semantic_version(version),
|
|
173
|
+
check_local_tag_absent(project_root, version, resolved_command_runner),
|
|
174
|
+
check_remote_tag_absent(project_root, version, resolved_command_runner),
|
|
175
|
+
check_github_release_absent(project_root, version, resolved_command_runner),
|
|
176
|
+
]
|
|
177
|
+
checks.append(check_release_publish_readiness(checks, block_on_warn=True))
|
|
178
|
+
return ReleaseStateReport(version=version, checks=tuple(checks))
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
def check_semantic_version(version: str) -> ReleaseCheckResult:
|
|
182
|
+
warnings = validate_version(version)
|
|
183
|
+
if warnings:
|
|
184
|
+
return ReleaseCheckResult("semantic version", ReleaseCheckStatus.FAIL, warnings[0])
|
|
185
|
+
return ReleaseCheckResult("semantic version", ReleaseCheckStatus.PASS, f"{version} is valid")
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
def check_file_contains(path: Path, needle: str, name: str) -> ReleaseCheckResult:
|
|
189
|
+
if not path.exists():
|
|
190
|
+
return ReleaseCheckResult(name, ReleaseCheckStatus.FAIL, f"missing file: {path}")
|
|
191
|
+
content = path.read_text(encoding="utf-8")
|
|
192
|
+
if needle not in content:
|
|
193
|
+
return ReleaseCheckResult(name, ReleaseCheckStatus.FAIL, f"missing text: {needle}")
|
|
194
|
+
return ReleaseCheckResult(name, ReleaseCheckStatus.PASS, f"found text: {needle}")
|
|
195
|
+
|
|
196
|
+
|
|
197
|
+
def check_local_tag_absent(
|
|
198
|
+
project_root: Path,
|
|
199
|
+
version: str,
|
|
200
|
+
command_runner: CommandRunner | None = None,
|
|
201
|
+
) -> ReleaseCheckResult:
|
|
202
|
+
resolved_command_runner = command_runner or run_command
|
|
203
|
+
tag = f"v{version}"
|
|
204
|
+
result = resolved_command_runner(project_root, ["git", "tag", "-l", tag])
|
|
205
|
+
if result.returncode != 0:
|
|
206
|
+
return ReleaseCheckResult("local tag unused", ReleaseCheckStatus.WARN, result.stderr.strip() or "git tag failed")
|
|
207
|
+
if result.stdout.strip():
|
|
208
|
+
return ReleaseCheckResult("local tag unused", ReleaseCheckStatus.FAIL, f"tag already exists: {tag}")
|
|
209
|
+
return ReleaseCheckResult("local tag unused", ReleaseCheckStatus.PASS, f"tag is unused: {tag}")
|
|
210
|
+
|
|
211
|
+
|
|
212
|
+
def check_remote_tag_absent(
|
|
213
|
+
project_root: Path,
|
|
214
|
+
version: str,
|
|
215
|
+
command_runner: CommandRunner | None = None,
|
|
216
|
+
) -> ReleaseCheckResult:
|
|
217
|
+
resolved_command_runner = command_runner or run_command
|
|
218
|
+
tag = f"v{version}"
|
|
219
|
+
result = resolved_command_runner(project_root, ["git", "ls-remote", "--tags", "origin", tag])
|
|
220
|
+
if result.returncode != 0:
|
|
221
|
+
return ReleaseCheckResult(
|
|
222
|
+
"remote tag unused",
|
|
223
|
+
ReleaseCheckStatus.WARN,
|
|
224
|
+
result.stderr.strip() or "git ls-remote failed",
|
|
225
|
+
)
|
|
226
|
+
if result.stdout.strip():
|
|
227
|
+
return ReleaseCheckResult("remote tag unused", ReleaseCheckStatus.FAIL, f"remote tag already exists: {tag}")
|
|
228
|
+
return ReleaseCheckResult("remote tag unused", ReleaseCheckStatus.PASS, f"remote tag is unused: {tag}")
|
|
229
|
+
|
|
230
|
+
|
|
231
|
+
def check_github_release_absent(
|
|
232
|
+
project_root: Path,
|
|
233
|
+
version: str,
|
|
234
|
+
command_runner: CommandRunner | None = None,
|
|
235
|
+
) -> ReleaseCheckResult:
|
|
236
|
+
resolved_command_runner = command_runner or run_command
|
|
237
|
+
tag = f"v{version}"
|
|
238
|
+
result = resolved_command_runner(project_root, ["gh", "release", "view", tag])
|
|
239
|
+
output = "\n".join(part for part in (result.stdout.strip(), result.stderr.strip()) if part)
|
|
240
|
+
if result.returncode == 0:
|
|
241
|
+
return ReleaseCheckResult("GitHub release unused", ReleaseCheckStatus.FAIL, f"GitHub release already exists: {tag}")
|
|
242
|
+
if result.returncode == 127 or _looks_like_unavailable_github_cli(output):
|
|
243
|
+
return ReleaseCheckResult("GitHub release unused", ReleaseCheckStatus.WARN, output or "gh release view failed")
|
|
244
|
+
if _looks_like_missing_github_release(output):
|
|
245
|
+
return ReleaseCheckResult("GitHub release unused", ReleaseCheckStatus.PASS, f"GitHub release is absent: {tag}")
|
|
246
|
+
return ReleaseCheckResult("GitHub release unused", ReleaseCheckStatus.WARN, output or "gh release view failed")
|
|
247
|
+
|
|
248
|
+
|
|
249
|
+
def check_release_publish_readiness(
|
|
250
|
+
checks: Sequence[ReleaseCheckResult],
|
|
251
|
+
*,
|
|
252
|
+
block_on_warn: bool = True,
|
|
253
|
+
) -> ReleaseCheckResult:
|
|
254
|
+
remote_checks = {check.name: check for check in checks if check.name in REMOTE_RELEASE_CHECK_NAMES}
|
|
255
|
+
missing_checks = [name for name in REMOTE_RELEASE_CHECK_NAMES if name not in remote_checks]
|
|
256
|
+
if missing_checks:
|
|
257
|
+
return ReleaseCheckResult(
|
|
258
|
+
"release publish readiness",
|
|
259
|
+
ReleaseCheckStatus.BLOCK,
|
|
260
|
+
"missing remote release checks: " + ", ".join(missing_checks),
|
|
261
|
+
)
|
|
262
|
+
failed = [check.name for check in remote_checks.values() if check.status == ReleaseCheckStatus.FAIL]
|
|
263
|
+
if failed:
|
|
264
|
+
return ReleaseCheckResult(
|
|
265
|
+
"release publish readiness",
|
|
266
|
+
ReleaseCheckStatus.FAIL,
|
|
267
|
+
"remote release target is not unused: " + ", ".join(failed),
|
|
268
|
+
)
|
|
269
|
+
warned = [check.name for check in remote_checks.values() if check.status == ReleaseCheckStatus.WARN]
|
|
270
|
+
if warned and block_on_warn:
|
|
271
|
+
return ReleaseCheckResult(
|
|
272
|
+
"release publish readiness",
|
|
273
|
+
ReleaseCheckStatus.BLOCK,
|
|
274
|
+
"remote release checks are inconclusive: "
|
|
275
|
+
+ ", ".join(warned)
|
|
276
|
+
+ "; do not tag or publish until they pass",
|
|
277
|
+
)
|
|
278
|
+
if warned:
|
|
279
|
+
return ReleaseCheckResult(
|
|
280
|
+
"release publish readiness",
|
|
281
|
+
ReleaseCheckStatus.WARN,
|
|
282
|
+
"remote release checks are inconclusive: "
|
|
283
|
+
+ ", ".join(warned)
|
|
284
|
+
+ "; metadata preparation may continue, but retry remote checks before tagging or publishing",
|
|
285
|
+
)
|
|
286
|
+
return ReleaseCheckResult(
|
|
287
|
+
"release publish readiness",
|
|
288
|
+
ReleaseCheckStatus.PASS,
|
|
289
|
+
"remote tag and GitHub release absence verified",
|
|
290
|
+
)
|
|
291
|
+
|
|
292
|
+
|
|
293
|
+
def _looks_like_unavailable_github_cli(output: str) -> bool:
|
|
294
|
+
normalized = output.lower()
|
|
295
|
+
return any(fragment in normalized for fragment in ("could not run gh", "gh unavailable"))
|
|
296
|
+
|
|
297
|
+
|
|
298
|
+
def _looks_like_missing_github_release(output: str) -> bool:
|
|
299
|
+
normalized = output.lower()
|
|
300
|
+
return any(fragment in normalized for fragment in ("release not found", "http 404"))
|
|
301
|
+
|
|
302
|
+
|
|
303
|
+
def run_command(project_root: Path, command: Sequence[str]) -> CommandResult:
|
|
304
|
+
try:
|
|
305
|
+
result = subprocess.run(
|
|
306
|
+
list(command),
|
|
307
|
+
cwd=project_root,
|
|
308
|
+
check=False,
|
|
309
|
+
capture_output=True,
|
|
310
|
+
text=True,
|
|
311
|
+
)
|
|
312
|
+
except OSError as exc:
|
|
313
|
+
return CommandResult(returncode=127, stdout="", stderr=f"could not run {command[0]}: {exc}")
|
|
314
|
+
return CommandResult(returncode=result.returncode, stdout=result.stdout, stderr=result.stderr)
|
|
315
|
+
|
|
316
|
+
|
|
317
|
+
def read_project_version(project_root: Path) -> str:
|
|
318
|
+
pyproject = project_root / "pyproject.toml"
|
|
319
|
+
if not pyproject.exists():
|
|
320
|
+
raise FileNotFoundError(f"Missing pyproject.toml: {pyproject}")
|
|
321
|
+
|
|
322
|
+
match = re.search(r'^version = "([^"]+)"', pyproject.read_text(encoding="utf-8"), re.MULTILINE)
|
|
323
|
+
if not match:
|
|
324
|
+
raise ValueError(f"Could not find project version in {pyproject}")
|
|
325
|
+
return match.group(1)
|
|
326
|
+
|
|
327
|
+
|
|
328
|
+
def validate_version(version: str) -> list[str]:
|
|
329
|
+
warnings: list[str] = []
|
|
330
|
+
if not re.fullmatch(r"\d+\.\d+\.\d+", version):
|
|
331
|
+
warnings.append(f"Version {version!r} is not a simple semantic version like 1.2.3.")
|
|
332
|
+
return warnings
|
|
333
|
+
|
|
334
|
+
|
|
335
|
+
def render_release_plan(plan: ReleasePlan) -> str:
|
|
336
|
+
lines = [f"# Release preparation plan for target v{plan.version}", ""]
|
|
337
|
+
|
|
338
|
+
if plan.warnings:
|
|
339
|
+
lines.append("## Warnings")
|
|
340
|
+
lines.append("")
|
|
341
|
+
for warning in plan.warnings:
|
|
342
|
+
lines.append(f"- {warning}")
|
|
343
|
+
lines.append("")
|
|
344
|
+
|
|
345
|
+
lines.append("## Steps")
|
|
346
|
+
lines.append("")
|
|
347
|
+
for index, step in enumerate(plan.steps, start=1):
|
|
348
|
+
lines.append(f"### {index}. {step.name}")
|
|
349
|
+
lines.append("")
|
|
350
|
+
lines.append("Commands:")
|
|
351
|
+
lines.append("")
|
|
352
|
+
lines.append("```bash")
|
|
353
|
+
lines.extend(step.commands)
|
|
354
|
+
lines.append("```")
|
|
355
|
+
lines.append("")
|
|
356
|
+
lines.append(f"Evidence: {step.evidence}")
|
|
357
|
+
lines.append("")
|
|
358
|
+
|
|
359
|
+
return "\n".join(lines).rstrip() + "\n"
|
|
360
|
+
|
|
361
|
+
|
|
362
|
+
def render_release_state_report(report: ReleaseStateReport) -> str:
|
|
363
|
+
lines = [f"Release state check for target v{report.version}", ""]
|
|
364
|
+
for check in report.checks:
|
|
365
|
+
lines.append(f"[{check.status.value}] {check.name}: {check.detail}")
|
|
366
|
+
if report.registry_summary is not None:
|
|
367
|
+
lines.extend(("", *_render_registry_summary_lines(report.registry_summary)))
|
|
368
|
+
lines.append("")
|
|
369
|
+
lines.append(f"Overall: {report.outcome.value}")
|
|
370
|
+
return "\n".join(lines) + "\n"
|
|
371
|
+
|
|
372
|
+
|
|
373
|
+
def render_release_preflight_report(report: ReleaseStateReport) -> str:
|
|
374
|
+
lines = [f"Release preflight for target v{report.version}", ""]
|
|
375
|
+
for check in report.checks:
|
|
376
|
+
lines.append(f"[{check.status.value}] {check.name}: {check.detail}")
|
|
377
|
+
lines.append("")
|
|
378
|
+
lines.append(f"Overall: {report.outcome.value}")
|
|
379
|
+
return "\n".join(lines) + "\n"
|
|
380
|
+
|
|
381
|
+
|
|
382
|
+
def _load_registry_summary(project_root: Path) -> dict[str, Any] | None:
|
|
383
|
+
try:
|
|
384
|
+
return build_documentation_registry_summary(project_root)
|
|
385
|
+
except (OSError, ValueError):
|
|
386
|
+
return None
|
|
387
|
+
|
|
388
|
+
|
|
389
|
+
def _render_registry_summary_lines(summary: dict[str, Any]) -> list[str]:
|
|
390
|
+
lines = [
|
|
391
|
+
"Documentation registry:",
|
|
392
|
+
f"- registry: {summary['registry_path']}",
|
|
393
|
+
f"- version: {summary['version']}",
|
|
394
|
+
f"- documents: {summary['document_count']}",
|
|
395
|
+
f"- broad_migration_allowed: {summary['broad_migration_allowed']}",
|
|
396
|
+
]
|
|
397
|
+
class_counts = summary.get("class_counts", {})
|
|
398
|
+
if isinstance(class_counts, dict):
|
|
399
|
+
for class_name, count in class_counts.items():
|
|
400
|
+
lines.append(f"- class:{class_name}: {count}")
|
|
401
|
+
return lines
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
import re
|
|
4
|
+
|
|
5
|
+
CONCEPT_DOI = "10.5281/zenodo.20101359"
|
|
6
|
+
|
|
7
|
+
def extract_verified_version_doi(text: str, version: str) -> str | None:
|
|
8
|
+
"""Return only the verified version-specific DOI for a release.
|
|
9
|
+
|
|
10
|
+
The Zenodo concept DOI is intentionally rejected, even when present in
|
|
11
|
+
successful post-release-check output. WAITING output must not be treated
|
|
12
|
+
as DOI metadata readiness.
|
|
13
|
+
"""
|
|
14
|
+
if "[WAITING] Zenodo version DOI" in text:
|
|
15
|
+
return None
|
|
16
|
+
escaped = re.escape(version)
|
|
17
|
+
pattern = rf"verified version DOI for v{escaped}: (10\.5281/zenodo\.[0-9]+)"
|
|
18
|
+
match = re.search(pattern, text)
|
|
19
|
+
if not match:
|
|
20
|
+
return None
|
|
21
|
+
doi = match.group(1)
|
|
22
|
+
if doi == CONCEPT_DOI:
|
|
23
|
+
return None
|
|
24
|
+
return doi
|