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,174 @@
1
+ from __future__ import annotations
2
+
3
+ import re
4
+ import shutil
5
+ import subprocess
6
+ import sys
7
+ from collections.abc import Callable, Sequence
8
+ from dataclasses import dataclass
9
+ from pathlib import Path
10
+
11
+
12
+ SEMVER_RE = re.compile(r"^\d+\.\d+\.\d+$")
13
+
14
+
15
+ def usage() -> str:
16
+ return "usage: ./ns release-gate <version>"
17
+
18
+
19
+ def is_help_arg(value: str) -> bool:
20
+ return value in {"-h", "--help"}
21
+
22
+
23
+ def is_valid_semver(value: str) -> bool:
24
+ plain = value[1:] if value.startswith("v") else value
25
+ return bool(SEMVER_RE.fullmatch(plain))
26
+
27
+
28
+ CommandRunner = Callable[[Sequence[str]], int]
29
+
30
+
31
+ @dataclass(frozen=True)
32
+ class ReleaseGateResult:
33
+ ok: bool
34
+ version: str
35
+ failed_step: str | None = None
36
+
37
+ @property
38
+ def exit_code(self) -> int:
39
+ return 0 if self.ok else 1
40
+
41
+
42
+ def default_runner(command: Sequence[str]) -> int:
43
+ completed = subprocess.run(list(command), check=False)
44
+ return int(completed.returncode)
45
+
46
+
47
+ def agentic_kit_command(repo_root: Path) -> tuple[str, ...]:
48
+ local = repo_root / ".venv" / "bin" / "agentic-kit"
49
+ if local.exists():
50
+ return (str(local),)
51
+ return ("agentic-kit",)
52
+
53
+
54
+ def _section(title: str) -> None:
55
+ print()
56
+ print(title)
57
+
58
+
59
+ def _run_step(name: str, command: Sequence[str], runner: CommandRunner) -> str | None:
60
+ _section(name)
61
+ code = runner(command)
62
+ if code != 0:
63
+ return name
64
+ return None
65
+
66
+
67
+ def _validate_dist_only_contains_version(dist_dir: Path, version: str) -> bool:
68
+ if not dist_dir.exists():
69
+ return False
70
+ artifacts = [path.name for path in dist_dir.iterdir() if path.is_file()]
71
+ if not artifacts:
72
+ return False
73
+ return all(version in name for name in artifacts)
74
+
75
+
76
+ def run_release_gate(
77
+ version: str,
78
+ *,
79
+ project_root: Path | None = None,
80
+ runner: CommandRunner = default_runner,
81
+ remove_tree: Callable[[Path], None] = shutil.rmtree,
82
+ make_dir: Callable[[Path], None] | None = None,
83
+ ) -> ReleaseGateResult:
84
+ root = Path.cwd() if project_root is None else project_root
85
+ dist_dir = root / "dist"
86
+ build_dir = root / "build"
87
+
88
+ print(f"NS RELEASE GATE CYCLE v{version}")
89
+ print()
90
+ print("Safety: verifies release readiness only; no tag, release, merge, or publish action.")
91
+
92
+ for name, command in (
93
+ ("### BRANCH ###", ("git", "branch", "--show-current")),
94
+ ("### STATUS ###", ("git", "status", "--short")),
95
+ ("### LOCAL GATE ###", (*agentic_kit_command(root), "dev", "local-feature-gate")),
96
+ (
97
+ "### RELEASE CHECK ###",
98
+ (
99
+ sys.executable,
100
+ "-m",
101
+ "agentic_project_kit.cli",
102
+ "release-check",
103
+ "--version",
104
+ version,
105
+ ),
106
+ ),
107
+ ):
108
+ failed = _run_step(name, command, runner)
109
+ if failed:
110
+ print(f"FAILED_STEP={failed}")
111
+ print("### RESULT: FAIL ###")
112
+ return ReleaseGateResult(False, version, failed)
113
+
114
+ _section("### CLEAN DIST ###")
115
+ for path in (dist_dir, build_dir):
116
+ if path.exists():
117
+ remove_tree(path)
118
+ for egg_info in root.glob("*.egg-info"):
119
+ if egg_info.is_dir():
120
+ remove_tree(egg_info)
121
+ if make_dir is None:
122
+ dist_dir.mkdir(parents=True, exist_ok=True)
123
+ else:
124
+ make_dir(dist_dir)
125
+
126
+ for name, command in (
127
+ ("### BUILD CHECK ###", (sys.executable, "-m", "build")),
128
+ ("### TWINE CHECK ###", (sys.executable, "-m", "twine", "check", "dist/*")),
129
+ ("### DIST LIST ###", ("ls", "-la", "dist")),
130
+ ):
131
+ failed = _run_step(name, command, runner)
132
+ if failed:
133
+ print(f"FAILED_STEP={failed}")
134
+ print("### RESULT: FAIL ###")
135
+ return ReleaseGateResult(False, version, failed)
136
+
137
+ _section("### VERIFY DIST ONLY CONTAINS TARGET VERSION ###")
138
+ if not _validate_dist_only_contains_version(dist_dir, version):
139
+ print(f"ERROR: dist contains artifacts that do not match {version}, or no artifacts exist.")
140
+ print("### RESULT: FAIL ###")
141
+ return ReleaseGateResult(False, version, "dist-version-validation")
142
+
143
+ for name, command in (
144
+ ("### FINAL BRANCH ###", ("git", "branch", "--show-current")),
145
+ ("### FINAL STATUS ###", ("git", "status", "--short")),
146
+ ):
147
+ failed = _run_step(name, command, runner)
148
+ if failed:
149
+ print(f"FAILED_STEP={failed}")
150
+ print("### RESULT: FAIL ###")
151
+ return ReleaseGateResult(False, version, failed)
152
+
153
+ print("### RESULT: PASS ###")
154
+ return ReleaseGateResult(True, version)
155
+
156
+
157
+ def main(argv: Sequence[str] | None = None) -> int:
158
+ args = list(sys.argv[1:] if argv is None else argv)
159
+ if not args:
160
+ print("ERROR: usage: python -m agentic_project_kit.release_gate_core <version>")
161
+ print("### RESULT: FAIL ###")
162
+ return 2
163
+ if is_help_arg(args[0]):
164
+ print(usage())
165
+ return 0
166
+ if not is_valid_semver(args[0]):
167
+ print(f"ERROR: invalid semantic version: {args[0]}")
168
+ print("### RESULT: FAIL ###")
169
+ return 2
170
+ return run_release_gate(args[0]).exit_code
171
+
172
+
173
+ if __name__ == "__main__":
174
+ raise SystemExit(main())
@@ -0,0 +1,328 @@
1
+ from __future__ import annotations
2
+
3
+ from dataclasses import dataclass
4
+ import json
5
+ from pathlib import Path
6
+ import re
7
+ import subprocess
8
+ from typing import Iterable, Sequence
9
+
10
+
11
+ RELEASE_ANCHOR_PATHS: tuple[str, ...] = (
12
+ "pyproject.toml",
13
+ "src/agentic_project_kit/__init__.py",
14
+ "CHANGELOG.md",
15
+ "README.md",
16
+ "CITATION.cff",
17
+ "docs/STATUS.md",
18
+ "docs/handoff/CURRENT_HANDOFF.md",
19
+ "docs/releases/VERIFIED_RELEASES.md",
20
+ )
21
+
22
+ RELEASE_ANCHOR_PREFIXES: tuple[str, ...] = (
23
+ "docs/releases/",
24
+ )
25
+
26
+ RELEASE_METADATA_LINE_PATTERNS: tuple[re.Pattern[str], ...] = (
27
+ re.compile(r"\bcurrent verified release\b", re.IGNORECASE),
28
+ re.compile(r"\bcurrent release tag\b", re.IGNORECASE),
29
+ re.compile(r"\bcurrent version\b", re.IGNORECASE),
30
+ re.compile(r"\bverified zenodo\b", re.IGNORECASE),
31
+ re.compile(r"\bzenodo\b", re.IGNORECASE),
32
+ re.compile(r"\bdoi\b", re.IGNORECASE),
33
+ re.compile(r"^version\s*[:=]", re.IGNORECASE),
34
+ re.compile(r"^__version__\s*="),
35
+ re.compile(r"^##\s+v?\d+\.\d+\.\d+\b", re.IGNORECASE),
36
+ re.compile(r"\bv?\d+\.\d+\.\d+\b", re.IGNORECASE),
37
+ )
38
+
39
+ AUTHORIZED_ROUTE = "agentic-kit release-prep"
40
+ AUTHORIZED_DOI_CLOSEOUT_ROUTE = "agentic-kit post-release-doi-closeout --write"
41
+ DOI_CLOSEOUT_EVIDENCE_KIND = "post_release_doi_closeout_authority"
42
+
43
+
44
+ @dataclass(frozen=True)
45
+ class ReleaseMetadataAuthorityGateResult:
46
+ ok: bool
47
+ status: str
48
+ version: str | None
49
+ base_ref: str
50
+ changed_release_anchor_paths: list[str]
51
+ evidence_paths: list[str]
52
+ message: str
53
+
54
+ def as_dict(self) -> dict[str, object]:
55
+ return {
56
+ "ok": self.ok,
57
+ "status": self.status,
58
+ "version": self.version,
59
+ "base_ref": self.base_ref,
60
+ "changed_release_anchor_paths": self.changed_release_anchor_paths,
61
+ "evidence_paths": self.evidence_paths,
62
+ "message": self.message,
63
+ }
64
+
65
+
66
+ def normalize_version(version: str | None) -> str | None:
67
+ if version is None:
68
+ return None
69
+ plain = version.removeprefix("v")
70
+ if not re.fullmatch(r"\d+\.\d+\.\d+", plain):
71
+ raise ValueError(f"Invalid release version: {version!r}; expected MAJOR.MINOR.PATCH")
72
+ return plain
73
+
74
+
75
+ def is_release_anchor_path(path: str) -> bool:
76
+ normalized = path.strip().replace("\\", "/")
77
+ return normalized in RELEASE_ANCHOR_PATHS or any(
78
+ normalized.startswith(prefix) for prefix in RELEASE_ANCHOR_PREFIXES
79
+ )
80
+
81
+
82
+ def release_anchor_changes(paths: Iterable[str]) -> list[str]:
83
+ return sorted({path for path in paths if is_release_anchor_path(path)})
84
+
85
+
86
+ def changed_paths_from_git(project_root: Path, base_ref: str) -> list[str]:
87
+ completed = subprocess.run(
88
+ ["git", "diff", "--name-only", f"{base_ref}...HEAD"],
89
+ cwd=project_root,
90
+ text=True,
91
+ stdout=subprocess.PIPE,
92
+ stderr=subprocess.STDOUT,
93
+ check=False,
94
+ )
95
+ if completed.returncode != 0:
96
+ raise RuntimeError(completed.stdout.strip() or f"git diff failed for {base_ref}...HEAD")
97
+ return [line.strip() for line in completed.stdout.splitlines() if line.strip()]
98
+
99
+
100
+ def release_metadata_anchor_changes_from_diff(
101
+ diff_text: str,
102
+ changed_anchor_paths: Sequence[str],
103
+ ) -> list[str]:
104
+ anchors = set(changed_anchor_paths)
105
+ current_path: str | None = None
106
+ touched: set[str] = set()
107
+ for line in diff_text.splitlines():
108
+ if line.startswith("+++ "):
109
+ marker = line[4:]
110
+ current_path = marker[2:] if marker.startswith("b/") else None
111
+ continue
112
+ if line.startswith("--- "):
113
+ marker = line[4:]
114
+ if current_path is None and marker.startswith("a/"):
115
+ current_path = marker[2:]
116
+ continue
117
+ if current_path not in anchors:
118
+ continue
119
+ if not line.startswith(("+", "-")) or line.startswith(("+++", "---")):
120
+ continue
121
+ if _diff_line_mentions_release_metadata(line[1:].strip()):
122
+ touched.add(current_path)
123
+ return sorted(touched)
124
+
125
+
126
+ def release_metadata_anchor_changes_from_git(
127
+ project_root: Path,
128
+ base_ref: str,
129
+ changed_anchor_paths: Sequence[str],
130
+ ) -> list[str]:
131
+ if not changed_anchor_paths:
132
+ return []
133
+ completed = subprocess.run(
134
+ ["git", "diff", "--unified=0", f"{base_ref}...HEAD", "--", *changed_anchor_paths],
135
+ cwd=project_root,
136
+ text=True,
137
+ stdout=subprocess.PIPE,
138
+ stderr=subprocess.STDOUT,
139
+ check=False,
140
+ )
141
+ if completed.returncode != 0:
142
+ raise RuntimeError(completed.stdout.strip() or f"git diff failed for {base_ref}...HEAD")
143
+ return release_metadata_anchor_changes_from_diff(completed.stdout, changed_anchor_paths)
144
+
145
+
146
+ def _release_prep_text_mentions_authorized_route(text: str) -> bool:
147
+ lowered = text.lower()
148
+ return "release-prep" in lowered and (
149
+ AUTHORIZED_ROUTE in lowered
150
+ or '"release-prep"' in lowered
151
+ or "'release-prep'" in lowered
152
+ or "release metadata" in lowered
153
+ )
154
+
155
+
156
+ def _doi_closeout_text_mentions_authorized_route(text: str) -> bool:
157
+ lowered = text.lower()
158
+ return DOI_CLOSEOUT_EVIDENCE_KIND in lowered and (
159
+ AUTHORIZED_DOI_CLOSEOUT_ROUTE in lowered
160
+ or "post-release-doi-closeout --version" in lowered
161
+ or "post-release-doi-closeout" in lowered and "--write" in lowered
162
+ )
163
+
164
+
165
+ def _diff_line_mentions_release_metadata(text: str) -> bool:
166
+ return any(pattern.search(text) for pattern in RELEASE_METADATA_LINE_PATTERNS)
167
+
168
+
169
+ def _evidence_text_mentions_version(text: str, version: str | None) -> bool:
170
+ if version is None:
171
+ return True
172
+ return version in text or f"v{version}" in text
173
+
174
+
175
+ def _json_evidence_mentions_changed_paths(data: object, changed_anchor_paths: Sequence[str]) -> bool:
176
+ text = json.dumps(data, sort_keys=True)
177
+ return all(path in text for path in changed_anchor_paths)
178
+
179
+
180
+ def _json_evidence_mentions_authorized_route(data: object) -> bool:
181
+ if not isinstance(data, dict):
182
+ return False
183
+ text = json.dumps(data, sort_keys=True)
184
+ if _release_prep_text_mentions_authorized_route(text):
185
+ return True
186
+ if data.get("evidence_kind") != DOI_CLOSEOUT_EVIDENCE_KIND:
187
+ return False
188
+ return _doi_closeout_text_mentions_authorized_route(text)
189
+
190
+
191
+ def _text_evidence_mentions_changed_paths(text: str, changed_anchor_paths: Sequence[str]) -> bool:
192
+ return all(path in text for path in changed_anchor_paths)
193
+
194
+
195
+ def evidence_is_authoritative(
196
+ evidence_path: Path,
197
+ *,
198
+ version: str | None,
199
+ changed_anchor_paths: Sequence[str],
200
+ ) -> bool:
201
+ if not evidence_path.exists() or not evidence_path.is_file():
202
+ return False
203
+ text = evidence_path.read_text(encoding="utf-8", errors="replace")
204
+ if not _evidence_text_mentions_version(text, version):
205
+ return False
206
+
207
+ try:
208
+ data = json.loads(text)
209
+ except json.JSONDecodeError:
210
+ if not _release_prep_text_mentions_authorized_route(text):
211
+ return False
212
+ return _text_evidence_mentions_changed_paths(text, changed_anchor_paths)
213
+ if not _json_evidence_mentions_authorized_route(data):
214
+ return False
215
+ return _json_evidence_mentions_changed_paths(data, changed_anchor_paths)
216
+
217
+
218
+ def find_default_evidence_paths(project_root: Path) -> list[Path]:
219
+ candidates: list[Path] = []
220
+ for pattern in (
221
+ "tmp/*release-prep*.json",
222
+ "tmp/*release-prep*.log",
223
+ "docs/reports/**/*.json",
224
+ "docs/reports/**/*.log",
225
+ "docs/reports/**/*.md",
226
+ ):
227
+ candidates.extend(project_root.glob(pattern))
228
+ return sorted({path for path in candidates if path.is_file()})
229
+
230
+
231
+ def evaluate_release_metadata_authority_gate(
232
+ project_root: Path | str = ".",
233
+ *,
234
+ base_ref: str = "origin/main",
235
+ version: str | None = None,
236
+ evidence_paths: Sequence[Path | str] = (),
237
+ changed_paths: Sequence[str] | None = None,
238
+ ) -> ReleaseMetadataAuthorityGateResult:
239
+ root = Path(project_root).resolve()
240
+ normalized_version = normalize_version(version)
241
+
242
+ changed = list(changed_paths) if changed_paths is not None else changed_paths_from_git(root, base_ref)
243
+ changed_anchor_paths = release_anchor_changes(changed)
244
+ if changed_paths is None:
245
+ changed_anchor_paths = release_metadata_anchor_changes_from_git(
246
+ root,
247
+ base_ref,
248
+ changed_anchor_paths,
249
+ )
250
+ if not changed_anchor_paths:
251
+ return ReleaseMetadataAuthorityGateResult(
252
+ ok=True,
253
+ status="PASS",
254
+ version=normalized_version,
255
+ base_ref=base_ref,
256
+ changed_release_anchor_paths=[],
257
+ evidence_paths=[],
258
+ message="No release metadata anchor files changed.",
259
+ )
260
+
261
+ explicit_evidence = [Path(path) for path in evidence_paths]
262
+ candidates = explicit_evidence if explicit_evidence else find_default_evidence_paths(root)
263
+
264
+ authoritative = [
265
+ path
266
+ for path in candidates
267
+ if evidence_is_authoritative(
268
+ path if path.is_absolute() else root / path,
269
+ version=normalized_version,
270
+ changed_anchor_paths=changed_anchor_paths,
271
+ )
272
+ ]
273
+
274
+ if authoritative:
275
+ return ReleaseMetadataAuthorityGateResult(
276
+ ok=True,
277
+ status="PASS",
278
+ version=normalized_version,
279
+ base_ref=base_ref,
280
+ changed_release_anchor_paths=changed_anchor_paths,
281
+ evidence_paths=[path.as_posix() for path in authoritative],
282
+ message=(
283
+ "Release metadata anchor changes are backed by authoritative "
284
+ "release-prep or post-release DOI closeout evidence."
285
+ ),
286
+ )
287
+
288
+ return ReleaseMetadataAuthorityGateResult(
289
+ ok=False,
290
+ status="BLOCK",
291
+ version=normalized_version,
292
+ base_ref=base_ref,
293
+ changed_release_anchor_paths=changed_anchor_paths,
294
+ evidence_paths=[path.as_posix() for path in candidates],
295
+ message=(
296
+ "Release metadata files changed without authoritative release-prepare or post-release DOI closeout "
297
+ "evidence. Use `agentic-kit release-prep --version <version> --summary-line <line> --json` or "
298
+ "`agentic-kit post-release-doi-closeout --version <version> --write --json` evidence instead of "
299
+ "manual regex/file patching."
300
+ ),
301
+ )
302
+
303
+
304
+ def render_release_metadata_authority_gate_result(
305
+ result: ReleaseMetadataAuthorityGateResult,
306
+ ) -> str:
307
+ lines = [
308
+ "RELEASE_METADATA_AUTHORITY_GATE",
309
+ "",
310
+ f"STATUS: {result.status}",
311
+ f"BASE_REF: {result.base_ref}",
312
+ f"VERSION: {result.version or '<unspecified>'}",
313
+ "",
314
+ "CHANGED_RELEASE_ANCHORS:",
315
+ ]
316
+ if result.changed_release_anchor_paths:
317
+ lines.extend(f"- {path}" for path in result.changed_release_anchor_paths)
318
+ else:
319
+ lines.append("- none")
320
+
321
+ lines.extend(["", "EVIDENCE_PATHS:"])
322
+ if result.evidence_paths:
323
+ lines.extend(f"- {path}" for path in result.evidence_paths)
324
+ else:
325
+ lines.append("- none")
326
+
327
+ lines.extend(["", result.message])
328
+ return "\n".join(lines)
@@ -0,0 +1,43 @@
1
+ from __future__ import annotations
2
+
3
+ from datetime import date
4
+ import sys
5
+ from pathlib import Path
6
+
7
+ REPO_ROOT = Path(__file__).resolve().parents[1]
8
+ SRC = REPO_ROOT / "src"
9
+ if str(SRC) not in sys.path:
10
+ sys.path.insert(0, str(SRC))
11
+
12
+
13
+ def main(argv: list[str] | None = None) -> int:
14
+ args = list(sys.argv[1:] if argv is None else argv)
15
+ if len(args) != 1:
16
+ print("usage: agentic-kit release-prep --version <version> --summary-line <line>")
17
+ return 2
18
+ version = args[0].removeprefix("v")
19
+ from agentic_project_kit.release_prepare import prepare_release_state
20
+
21
+ try:
22
+ result = prepare_release_state(
23
+ Path(".").resolve(),
24
+ version=version,
25
+ date=date.today().isoformat(),
26
+ summary_lines=[
27
+ f"Release metadata prepared for v{version}; Zenodo DOI verification remains pending until publication.",
28
+ ],
29
+ )
30
+ except ValueError as exc:
31
+ print(str(exc))
32
+ return 2
33
+ for changed_path in result.changed_paths:
34
+ print(f"CHANGED: {changed_path}")
35
+ if not result.changed_paths:
36
+ print(f"Release metadata already prepared for v{version}")
37
+ else:
38
+ print(f"Prepared release metadata for v{version} on {result.date}")
39
+ return 0
40
+
41
+
42
+ if __name__ == "__main__":
43
+ raise SystemExit(main())