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.
Files changed (310) hide show
  1. agentic_project_kit/__init__.py +1 -0
  2. agentic_project_kit/absolute_path_portability_audit.py +241 -0
  3. agentic_project_kit/access_level_policy.py +14 -0
  4. agentic_project_kit/access_levels.py +22 -0
  5. agentic_project_kit/action_registry.py +195 -0
  6. agentic_project_kit/action_specs.py +286 -0
  7. agentic_project_kit/agent_command_runner.py +516 -0
  8. agentic_project_kit/audit_test_matrix.py +36 -0
  9. agentic_project_kit/audit_test_matrix_cli.py +43 -0
  10. agentic_project_kit/chat_bootloader.py +257 -0
  11. agentic_project_kit/chat_entrypoint_contract.py +297 -0
  12. agentic_project_kit/checks.py +511 -0
  13. agentic_project_kit/ci_readiness.py +211 -0
  14. agentic_project_kit/cli.py +147 -0
  15. agentic_project_kit/cli_commands/__init__.py +1 -0
  16. agentic_project_kit/cli_commands/absolute_path_audit.py +25 -0
  17. agentic_project_kit/cli_commands/actions.py +21 -0
  18. agentic_project_kit/cli_commands/artifact_gc.py +240 -0
  19. agentic_project_kit/cli_commands/boot.py +55 -0
  20. agentic_project_kit/cli_commands/chat.py +34 -0
  21. agentic_project_kit/cli_commands/checks.py +305 -0
  22. agentic_project_kit/cli_commands/cockpit.py +103 -0
  23. agentic_project_kit/cli_commands/command_taxonomy.py +25 -0
  24. agentic_project_kit/cli_commands/commands.py +129 -0
  25. agentic_project_kit/cli_commands/dev.py +23 -0
  26. agentic_project_kit/cli_commands/direction.py +92 -0
  27. agentic_project_kit/cli_commands/doc_currency_audit.py +25 -0
  28. agentic_project_kit/cli_commands/doc_registry.py +126 -0
  29. agentic_project_kit/cli_commands/docs.py +223 -0
  30. agentic_project_kit/cli_commands/dpa.py +1338 -0
  31. agentic_project_kit/cli_commands/evidence.py +251 -0
  32. agentic_project_kit/cli_commands/github.py +34 -0
  33. agentic_project_kit/cli_commands/governance.py +14 -0
  34. agentic_project_kit/cli_commands/gui.py +23 -0
  35. agentic_project_kit/cli_commands/gui_readiness_gate.py +27 -0
  36. agentic_project_kit/cli_commands/handoff.py +183 -0
  37. agentic_project_kit/cli_commands/human_workflows.py +430 -0
  38. agentic_project_kit/cli_commands/init.py +132 -0
  39. agentic_project_kit/cli_commands/instruction.py +75 -0
  40. agentic_project_kit/cli_commands/mutation_lock_audit.py +24 -0
  41. agentic_project_kit/cli_commands/ns_legacy_audit.py +25 -0
  42. agentic_project_kit/cli_commands/pass_already_done.py +66 -0
  43. agentic_project_kit/cli_commands/patch_failure_discipline_audit.py +26 -0
  44. agentic_project_kit/cli_commands/patch_preflight.py +37 -0
  45. agentic_project_kit/cli_commands/path_literal_audit.py +39 -0
  46. agentic_project_kit/cli_commands/patterns.py +40 -0
  47. agentic_project_kit/cli_commands/planning_docs_audit.py +25 -0
  48. agentic_project_kit/cli_commands/pr.py +133 -0
  49. agentic_project_kit/cli_commands/pr_hygiene.py +27 -0
  50. agentic_project_kit/cli_commands/profiles.py +26 -0
  51. agentic_project_kit/cli_commands/program_redundancy_audit.py +25 -0
  52. agentic_project_kit/cli_commands/project_direction.py +25 -0
  53. agentic_project_kit/cli_commands/release.py +392 -0
  54. agentic_project_kit/cli_commands/release_publish_orchestration.py +36 -0
  55. agentic_project_kit/cli_commands/remote_branch_hygiene.py +152 -0
  56. agentic_project_kit/cli_commands/remote_next.py +57 -0
  57. agentic_project_kit/cli_commands/removed_ns_commands.py +65 -0
  58. agentic_project_kit/cli_commands/rule_registry.py +129 -0
  59. agentic_project_kit/cli_commands/rules.py +222 -0
  60. agentic_project_kit/cli_commands/scaffold.py +46 -0
  61. agentic_project_kit/cli_commands/slice.py +21 -0
  62. agentic_project_kit/cli_commands/standard_gates_audit_suite.py +27 -0
  63. agentic_project_kit/cli_commands/state.py +51 -0
  64. agentic_project_kit/cli_commands/status_current_state_audit.py +30 -0
  65. agentic_project_kit/cli_commands/todo.py +53 -0
  66. agentic_project_kit/cli_commands/transfer.py +19 -0
  67. agentic_project_kit/cli_commands/transfer_context_flow.py +398 -0
  68. agentic_project_kit/cli_commands/transfer_context_helpers.py +398 -0
  69. agentic_project_kit/cli_commands/transfer_diagnostics.py +767 -0
  70. agentic_project_kit/cli_commands/transfer_evidence_flow.py +368 -0
  71. agentic_project_kit/cli_commands/transfer_handoff_flow.py +594 -0
  72. agentic_project_kit/cli_commands/transfer_order_contract.py +74 -0
  73. agentic_project_kit/cli_commands/transfer_post_merge_complete.py +442 -0
  74. agentic_project_kit/cli_commands/transfer_post_merge_settle.py +171 -0
  75. agentic_project_kit/cli_commands/transfer_pr_closeout_complete.py +124 -0
  76. agentic_project_kit/cli_commands/transfer_pr_create_flow.py +743 -0
  77. agentic_project_kit/cli_commands/transfer_pr_merge_flow.py +547 -0
  78. agentic_project_kit/cli_commands/transfer_repo_after_pr.py +160 -0
  79. agentic_project_kit/cli_commands/transfer_repo_pre_pr.py +664 -0
  80. agentic_project_kit/cli_commands/transfer_runner_flow.py +131 -0
  81. agentic_project_kit/cli_commands/transfer_runtime_initial.py +194 -0
  82. agentic_project_kit/cli_commands/transfer_shared.py +274 -0
  83. agentic_project_kit/cli_commands/validation.py +200 -0
  84. agentic_project_kit/cli_commands/version.py +27 -0
  85. agentic_project_kit/cli_commands/work_orders.py +219 -0
  86. agentic_project_kit/cli_commands/workflow.py +471 -0
  87. agentic_project_kit/cli_commands/workflow_guard.py +26 -0
  88. agentic_project_kit/cli_commands/workspace.py +252 -0
  89. agentic_project_kit/cockpit.py +608 -0
  90. agentic_project_kit/cockpit_readiness.py +67 -0
  91. agentic_project_kit/command_authority_audit.py +192 -0
  92. agentic_project_kit/command_inbox_check.py +103 -0
  93. agentic_project_kit/command_manifest.py +591 -0
  94. agentic_project_kit/command_queue_contract.py +161 -0
  95. agentic_project_kit/command_selector.py +245 -0
  96. agentic_project_kit/command_taxonomy.py +264 -0
  97. agentic_project_kit/commit_guard.py +67 -0
  98. agentic_project_kit/communication_artifact_gc.py +495 -0
  99. agentic_project_kit/communication_rule_context.py +437 -0
  100. agentic_project_kit/communication_state.py +115 -0
  101. agentic_project_kit/composed_wrapper_invariants.py +97 -0
  102. agentic_project_kit/composite_short_circuit.py +140 -0
  103. agentic_project_kit/contract.py +251 -0
  104. agentic_project_kit/control_state.py +83 -0
  105. agentic_project_kit/doc_currency_audit.py +536 -0
  106. agentic_project_kit/doc_lifecycle.py +1179 -0
  107. agentic_project_kit/doc_lifecycle_signals.py +446 -0
  108. agentic_project_kit/doc_lifecycle_sweep.py +639 -0
  109. agentic_project_kit/doc_mesh.py +491 -0
  110. agentic_project_kit/doctor.py +379 -0
  111. agentic_project_kit/documentation_registry.py +1122 -0
  112. agentic_project_kit/documentation_system_audit.py +310 -0
  113. agentic_project_kit/dpa_current_handoff_lifecycle.py +549 -0
  114. agentic_project_kit/dpa_dp2_decision_readiness.py +362 -0
  115. agentic_project_kit/dpa_dp3_dp4_adjudication.py +604 -0
  116. agentic_project_kit/dpa_dp5_block_new_gate.py +294 -0
  117. agentic_project_kit/dpa_dp5_stage_adoption.py +615 -0
  118. agentic_project_kit/dpa_dp5_strict_gate.py +187 -0
  119. agentic_project_kit/dpa_final_closeout.py +627 -0
  120. agentic_project_kit/dpa_fixture_evidence.py +680 -0
  121. agentic_project_kit/dpa_maintainer_record_check.py +711 -0
  122. agentic_project_kit/dpa_post_dp2_scope_assessment.py +734 -0
  123. agentic_project_kit/dpa_probe_002_readiness.py +509 -0
  124. agentic_project_kit/dpa_probe_003_readiness.py +417 -0
  125. agentic_project_kit/dpa_probe_004_readiness.py +437 -0
  126. agentic_project_kit/dpa_readiness.py +505 -0
  127. agentic_project_kit/dpa_readonly_probe_execution.py +500 -0
  128. agentic_project_kit/dpa_registry_contracts.py +312 -0
  129. agentic_project_kit/dpa_renderer_readiness.py +407 -0
  130. agentic_project_kit/dpa_repo_adoption_assessment.py +574 -0
  131. agentic_project_kit/dpa_stable_readiness.py +743 -0
  132. agentic_project_kit/dpa_successor_projection.py +168 -0
  133. agentic_project_kit/dpa_workspace_init_projection.py +93 -0
  134. agentic_project_kit/dpa_wrt_ch001_evidence.py +327 -0
  135. agentic_project_kit/entrypoint_slice_runner.py +153 -0
  136. agentic_project_kit/evidence_clean.py +152 -0
  137. agentic_project_kit/evidence_commit_paths.py +214 -0
  138. agentic_project_kit/evidence_finalize_log.py +204 -0
  139. agentic_project_kit/evidence_guard.py +114 -0
  140. agentic_project_kit/evidence_inspector.py +507 -0
  141. agentic_project_kit/evidence_state_contract.py +99 -0
  142. agentic_project_kit/execution_mode_state.py +148 -0
  143. agentic_project_kit/final_summary_contract.py +85 -0
  144. agentic_project_kit/finalize_guard.py +139 -0
  145. agentic_project_kit/gatekeeper_core.py +232 -0
  146. agentic_project_kit/github.py +25 -0
  147. agentic_project_kit/governance.py +59 -0
  148. agentic_project_kit/gui_action_execution.py +105 -0
  149. agentic_project_kit/gui_action_renderer.py +81 -0
  150. agentic_project_kit/gui_action_run_intent.py +98 -0
  151. agentic_project_kit/gui_action_views.py +195 -0
  152. agentic_project_kit/gui_activity_log.py +76 -0
  153. agentic_project_kit/gui_button_catalog.py +605 -0
  154. agentic_project_kit/gui_cockpit.py +365 -0
  155. agentic_project_kit/gui_cockpit_actions.py +695 -0
  156. agentic_project_kit/gui_cockpit_common.py +172 -0
  157. agentic_project_kit/gui_cockpit_header.py +501 -0
  158. agentic_project_kit/gui_cockpit_sidebar.py +387 -0
  159. agentic_project_kit/gui_cockpit_task.py +748 -0
  160. agentic_project_kit/gui_command_projection.py +355 -0
  161. agentic_project_kit/gui_communication_modes.py +130 -0
  162. agentic_project_kit/gui_dry_run.py +219 -0
  163. agentic_project_kit/gui_gatekeeper_status.py +259 -0
  164. agentic_project_kit/gui_layout_plan.py +148 -0
  165. agentic_project_kit/gui_open_folder.py +18 -0
  166. agentic_project_kit/gui_output_status_panel.py +61 -0
  167. agentic_project_kit/gui_panel_state.py +47 -0
  168. agentic_project_kit/gui_presenter.py +62 -0
  169. agentic_project_kit/gui_readiness_gate.py +206 -0
  170. agentic_project_kit/gui_release_flow.py +59 -0
  171. agentic_project_kit/gui_task_editor.py +1077 -0
  172. agentic_project_kit/gui_tk_widgets.py +177 -0
  173. agentic_project_kit/gui_tkinter_renderer.py +87 -0
  174. agentic_project_kit/gui_tkinter_shell.py +1176 -0
  175. agentic_project_kit/gui_transfer_contract.py +28 -0
  176. agentic_project_kit/gui_viewmodel.py +698 -0
  177. agentic_project_kit/gui_window_guard.py +46 -0
  178. agentic_project_kit/handoff_freshness.py +390 -0
  179. agentic_project_kit/handoff_prompt.py +180 -0
  180. agentic_project_kit/handoff_state.py +254 -0
  181. agentic_project_kit/instruction_lint.py +455 -0
  182. agentic_project_kit/llm_context_carriers.py +66 -0
  183. agentic_project_kit/llm_execution_context.py +285 -0
  184. agentic_project_kit/local_command_stack.py +133 -0
  185. agentic_project_kit/local_feature_gate.py +82 -0
  186. agentic_project_kit/local_garbage_collector.py +269 -0
  187. agentic_project_kit/models.py +18 -0
  188. agentic_project_kit/mutation_lock_audit.py +421 -0
  189. agentic_project_kit/next_turn_evidence.py +253 -0
  190. agentic_project_kit/next_turn_merge_if_green.py +459 -0
  191. agentic_project_kit/next_turn_pr_status.py +255 -0
  192. agentic_project_kit/next_turn_result.py +183 -0
  193. agentic_project_kit/next_turn_runner.py +159 -0
  194. agentic_project_kit/next_turn_slot.py +107 -0
  195. agentic_project_kit/next_turn_status.py +274 -0
  196. agentic_project_kit/ns_legacy_reference_audit.py +258 -0
  197. agentic_project_kit/ns_slice_runner.py +16 -0
  198. agentic_project_kit/operational_handoff_projection.py +124 -0
  199. agentic_project_kit/output_contract.py +80 -0
  200. agentic_project_kit/output_repair.py +61 -0
  201. agentic_project_kit/pass_already_done.py +216 -0
  202. agentic_project_kit/patch_artifact_preflight.py +147 -0
  203. agentic_project_kit/patch_cycle_workflow.py +440 -0
  204. agentic_project_kit/patch_failure_discipline_audit.py +223 -0
  205. agentic_project_kit/patch_preflight.py +215 -0
  206. agentic_project_kit/path_literal_audit.py +612 -0
  207. agentic_project_kit/patterns.py +99 -0
  208. agentic_project_kit/planning_docs_consolidation_audit.py +313 -0
  209. agentic_project_kit/portability_shell_gate.py +40 -0
  210. agentic_project_kit/post_merge_handoff_refresh.py +56 -0
  211. agentic_project_kit/post_release.py +252 -0
  212. agentic_project_kit/post_release_closeout.py +616 -0
  213. agentic_project_kit/pr_cleanup.py +172 -0
  214. agentic_project_kit/pr_closeout.py +50 -0
  215. agentic_project_kit/pr_closeout_complete.py +344 -0
  216. agentic_project_kit/pr_create_or_skip.py +71 -0
  217. agentic_project_kit/pr_hygiene.py +210 -0
  218. agentic_project_kit/program_redundancy_audit.py +251 -0
  219. agentic_project_kit/project_direction.py +840 -0
  220. agentic_project_kit/protected_change_planner.py +194 -0
  221. agentic_project_kit/release.py +401 -0
  222. agentic_project_kit/release_doi_safety.py +24 -0
  223. agentic_project_kit/release_gate_core.py +174 -0
  224. agentic_project_kit/release_metadata_authority_gate.py +328 -0
  225. agentic_project_kit/release_metadata_prep.py +43 -0
  226. agentic_project_kit/release_notes.py +823 -0
  227. agentic_project_kit/release_prep_core.py +204 -0
  228. agentic_project_kit/release_prepare.py +369 -0
  229. agentic_project_kit/release_process_guardrails.py +247 -0
  230. agentic_project_kit/release_publish_core.py +114 -0
  231. agentic_project_kit/release_publish_orchestration.py +469 -0
  232. agentic_project_kit/release_state.py +552 -0
  233. agentic_project_kit/release_verify_core.py +175 -0
  234. agentic_project_kit/remote_branch_hygiene.py +223 -0
  235. agentic_project_kit/remote_next.py +89 -0
  236. agentic_project_kit/remote_next_closeout.py +101 -0
  237. agentic_project_kit/remote_next_order_contract.py +391 -0
  238. agentic_project_kit/removed_ns_commands.py +458 -0
  239. agentic_project_kit/removed_source_audit.py +225 -0
  240. agentic_project_kit/rendering.py +13 -0
  241. agentic_project_kit/repair_report.py +79 -0
  242. agentic_project_kit/repo_identity.py +59 -0
  243. agentic_project_kit/result_report_classifier.py +57 -0
  244. agentic_project_kit/rule_ack.py +105 -0
  245. agentic_project_kit/rule_preservation.py +58 -0
  246. agentic_project_kit/rule_refresh.py +174 -0
  247. agentic_project_kit/rule_registry_registration.py +322 -0
  248. agentic_project_kit/rule_registry_report.py +206 -0
  249. agentic_project_kit/rule_registry_validator.py +704 -0
  250. agentic_project_kit/rule_snapshot.py +98 -0
  251. agentic_project_kit/rule_source_validator.py +133 -0
  252. agentic_project_kit/run_summary.py +68 -0
  253. agentic_project_kit/run_summary_renderer.py +238 -0
  254. agentic_project_kit/runtime_validator.py +68 -0
  255. agentic_project_kit/safe_file_replace.py +35 -0
  256. agentic_project_kit/safe_patch.py +47 -0
  257. agentic_project_kit/safe_push.py +218 -0
  258. agentic_project_kit/safe_remove_diagnostic.py +51 -0
  259. agentic_project_kit/scaffold.py +69 -0
  260. agentic_project_kit/site_claims.py +444 -0
  261. agentic_project_kit/site_generator.py +1140 -0
  262. agentic_project_kit/slice_gate.py +225 -0
  263. agentic_project_kit/slice_runner.py +75 -0
  264. agentic_project_kit/standard_gates_audit_suite.py +167 -0
  265. agentic_project_kit/state_freshness.py +135 -0
  266. agentic_project_kit/status_current_state_audit.py +762 -0
  267. agentic_project_kit/successor_handoff_package.py +1763 -0
  268. agentic_project_kit/templates.py +292 -0
  269. agentic_project_kit/terminal_block_guard.py +166 -0
  270. agentic_project_kit/terminal_logging.py +275 -0
  271. agentic_project_kit/todo.py +97 -0
  272. agentic_project_kit/transfer_closeout.py +136 -0
  273. agentic_project_kit/transfer_continue.py +215 -0
  274. agentic_project_kit/transfer_local_runner.py +101 -0
  275. agentic_project_kit/transfer_operation_monitor.py +236 -0
  276. agentic_project_kit/transfer_post_merge_lifecycle.py +356 -0
  277. agentic_project_kit/transfer_post_merge_settle.py +383 -0
  278. agentic_project_kit/transfer_pr_actions.py +164 -0
  279. agentic_project_kit/transfer_remote_next.py +959 -0
  280. agentic_project_kit/transfer_repo_actions.py +2253 -0
  281. agentic_project_kit/transfer_runner.py +347 -0
  282. agentic_project_kit/transfer_safety_context.py +291 -0
  283. agentic_project_kit/transfer_state.py +483 -0
  284. agentic_project_kit/transfer_uplink.py +471 -0
  285. agentic_project_kit/transfer_workflow_next.py +148 -0
  286. agentic_project_kit/typed_work_order_evidence.py +58 -0
  287. agentic_project_kit/typed_work_order_queue.py +166 -0
  288. agentic_project_kit/typed_work_order_runner.py +168 -0
  289. agentic_project_kit/work_cycle.py +317 -0
  290. agentic_project_kit/work_discard_changes.py +129 -0
  291. agentic_project_kit/work_order_patch.py +199 -0
  292. agentic_project_kit/work_order_runner.py +120 -0
  293. agentic_project_kit/work_order_uploader.py +220 -0
  294. agentic_project_kit/work_order_validator.py +185 -0
  295. agentic_project_kit/work_orders.py +246 -0
  296. agentic_project_kit/workflow_guard.py +262 -0
  297. agentic_project_kit/workflow_summary_runner.py +124 -0
  298. agentic_project_kit/workspace.py +665 -0
  299. agentic_project_kit/workspace_adopt.py +471 -0
  300. agentic_project_kit/workspace_dpa_intake.py +406 -0
  301. agentic_project_kit/workspace_init.py +487 -0
  302. agentic_project_kit/workspace_lock.py +129 -0
  303. agentic_project_kit/workspace_remove.py +381 -0
  304. agentic_project_kit/workspace_upgrade.py +324 -0
  305. agentic_project_kit/wrapper_live_status.py +104 -0
  306. agentic_project_kit-1.0.1.dist-info/METADATA +724 -0
  307. agentic_project_kit-1.0.1.dist-info/RECORD +310 -0
  308. agentic_project_kit-1.0.1.dist-info/WHEEL +4 -0
  309. agentic_project_kit-1.0.1.dist-info/entry_points.txt +3 -0
  310. 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