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,25 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from pathlib import Path
5
+
6
+ import typer
7
+
8
+ from agentic_project_kit.ns_legacy_reference_audit import (
9
+ audit_ns_legacy_references,
10
+ render_ns_legacy_reference_audit,
11
+ )
12
+
13
+
14
+ def audit_ns_legacy_references_command(
15
+ root: Path = typer.Option(Path("."), "--root"),
16
+ json_output: bool = typer.Option(False, "--json"),
17
+ ) -> None:
18
+ """Audit remaining legacy ./ns/ns-menu/ns_release references."""
19
+ result = audit_ns_legacy_references(root.resolve())
20
+ if json_output:
21
+ typer.echo(json.dumps(result.as_dict(), indent=2, sort_keys=True))
22
+ else:
23
+ typer.echo(render_ns_legacy_reference_audit(result), nl=False)
24
+ if not result.ok:
25
+ raise typer.Exit(code=result.returncode)
@@ -0,0 +1,66 @@
1
+ from __future__ import annotations
2
+
3
+ from pathlib import Path
4
+
5
+ import typer
6
+
7
+ from agentic_project_kit.pass_already_done import classify_file
8
+ from agentic_project_kit.pass_already_done import render_classification
9
+ from agentic_project_kit.pass_already_done import render_classification_json
10
+ from agentic_project_kit.pass_already_done import SUPPORTED_TARGET_STATES
11
+ from agentic_project_kit.result_report_classifier import classify_report
12
+ from agentic_project_kit.result_report_classifier import render_report_classification
13
+
14
+ app = typer.Typer(help="Classify idempotent already-done command outcomes.")
15
+
16
+
17
+ @app.command("classify")
18
+ def classify(
19
+ path: Path,
20
+ exit_code: int = typer.Option(..., "--exit-code"),
21
+ target_verified: bool = typer.Option(False, "--target-verified"),
22
+ target_state: str | None = typer.Option(
23
+ None,
24
+ "--target-state",
25
+ help="Already-done target class. One of: " + ", ".join(sorted(SUPPORTED_TARGET_STATES)),
26
+ ),
27
+ json_output: bool = typer.Option(False, "--json", help="Emit machine-readable JSON output."),
28
+ ) -> None:
29
+ classification = classify_file(
30
+ path,
31
+ exit_code=exit_code,
32
+ target_verified=target_verified,
33
+ target_state=target_state,
34
+ )
35
+ if json_output:
36
+ typer.echo(render_classification_json(classification))
37
+ else:
38
+ typer.echo(render_classification(classification))
39
+ if not classification.success:
40
+ raise typer.Exit(code=1)
41
+
42
+
43
+ @app.command("report")
44
+ def report(
45
+ path: Path,
46
+ exit_code: int = typer.Option(..., "--exit-code"),
47
+ target_verified: bool = typer.Option(False, "--target-verified"),
48
+ target_state: str | None = typer.Option(
49
+ None,
50
+ "--target-state",
51
+ help="Already-done target class. One of: " + ", ".join(sorted(SUPPORTED_TARGET_STATES)),
52
+ ),
53
+ json_output: bool = typer.Option(False, "--json", help="Emit machine-readable JSON output."),
54
+ ) -> None:
55
+ result = classify_report(
56
+ path,
57
+ raw_exit_code=exit_code,
58
+ target_verified=target_verified,
59
+ target_state=target_state,
60
+ )
61
+ if json_output:
62
+ typer.echo(render_classification_json(result.classification))
63
+ else:
64
+ typer.echo(render_report_classification(result))
65
+ if not result.success:
66
+ raise typer.Exit(code=1)
@@ -0,0 +1,26 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from pathlib import Path
5
+
6
+ import typer
7
+
8
+ from agentic_project_kit.patch_failure_discipline_audit import (
9
+ audit_patch_failure_discipline,
10
+ render_patch_failure_discipline,
11
+ )
12
+
13
+
14
+ def audit_patch_failure_discipline_command(
15
+ root: Path = typer.Option(Path("."), "--root"),
16
+ include_tmp: bool = typer.Option(False, "--include-tmp"),
17
+ json_output: bool = typer.Option(False, "--json"),
18
+ ) -> None:
19
+ """Audit whether repeated patch failures were followed by diagnosis evidence."""
20
+ result = audit_patch_failure_discipline(root.resolve(), include_tmp=include_tmp)
21
+ if json_output:
22
+ typer.echo(json.dumps(result.as_dict(), indent=2, sort_keys=True))
23
+ else:
24
+ typer.echo(render_patch_failure_discipline(result), nl=False)
25
+ if not result.ok:
26
+ raise typer.Exit(code=result.returncode)
@@ -0,0 +1,37 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from pathlib import Path
5
+
6
+ import typer
7
+
8
+ from agentic_project_kit.patch_preflight import (
9
+ build_patch_preflight_report,
10
+ render_patch_preflight_report,
11
+ )
12
+
13
+
14
+ def patch_preflight_command(
15
+ root: Path = typer.Option(Path("."), "--root"),
16
+ label: str = typer.Option("patch", "--label"),
17
+ base_ref: str = typer.Option("HEAD", "--base-ref"),
18
+ max_files: int = typer.Option(6, "--max-files"),
19
+ max_diff_lines: int = typer.Option(400, "--max-diff-lines"),
20
+ strict: bool = typer.Option(False, "--strict"),
21
+ json_output: bool = typer.Option(False, "--json"),
22
+ ) -> None:
23
+ """Diagnose patch size, protected paths, and diff-risk before closeout."""
24
+ report = build_patch_preflight_report(
25
+ root.resolve(),
26
+ label=label,
27
+ base_ref=base_ref,
28
+ max_files=max_files,
29
+ max_diff_lines=max_diff_lines,
30
+ strict=strict,
31
+ )
32
+ if json_output:
33
+ typer.echo(json.dumps(report.as_dict(), indent=2, sort_keys=True))
34
+ else:
35
+ typer.echo(render_patch_preflight_report(report), nl=False)
36
+ if not report.ok:
37
+ raise typer.Exit(code=1)
@@ -0,0 +1,39 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from pathlib import Path
5
+
6
+ import typer
7
+
8
+ from agentic_project_kit.path_literal_audit import (
9
+ audit_path_literals,
10
+ enforce_active_literal_classes,
11
+ render_path_literal_active_class_enforcement,
12
+ render_path_literal_audit,
13
+ )
14
+
15
+
16
+ def audit_path_literals_command(
17
+ root: Path = typer.Option(Path("."), "--root", help="Project root."),
18
+ json_output: bool = typer.Option(False, "--json", help="Emit machine-readable JSON."),
19
+ enforce_active: bool = typer.Option(
20
+ False,
21
+ "--enforce-active",
22
+ help="Fail when active path or repository identity literals remain.",
23
+ ),
24
+ ) -> None:
25
+ """Report hardcoded docs/tmp path literals in source modules."""
26
+ result = audit_path_literals(root.resolve())
27
+ if enforce_active:
28
+ enforcement = enforce_active_literal_classes(result)
29
+ if json_output:
30
+ typer.echo(json.dumps(enforcement.as_dict(), indent=2, sort_keys=True))
31
+ else:
32
+ typer.echo(render_path_literal_active_class_enforcement(enforcement), nl=False)
33
+ if enforcement.returncode != 0:
34
+ raise typer.Exit(code=enforcement.returncode)
35
+ return
36
+ if json_output:
37
+ typer.echo(json.dumps(result.as_dict(), indent=2, sort_keys=True))
38
+ else:
39
+ typer.echo(render_path_literal_audit(result), nl=False)
@@ -0,0 +1,40 @@
1
+ from __future__ import annotations
2
+
3
+ from pathlib import Path
4
+
5
+ import typer
6
+
7
+ from agentic_project_kit.patterns import (
8
+ PatternCatalogError,
9
+ find_pattern,
10
+ load_pattern_catalog,
11
+ load_pattern_detail,
12
+ )
13
+
14
+ patterns_app = typer.Typer(help="Inspect the local read-only pattern catalog.")
15
+
16
+
17
+ @patterns_app.command("list")
18
+ def patterns_list() -> None:
19
+ """List known local patterns and anti-patterns."""
20
+ try:
21
+ catalog = load_pattern_catalog(Path("."))
22
+ except PatternCatalogError as exc:
23
+ raise typer.BadParameter(str(exc)) from exc
24
+
25
+ for entry in catalog.patterns:
26
+ typer.echo(f"{entry.id}\t{entry.kind}\t{entry.title}")
27
+ typer.echo(f" {entry.summary}")
28
+
29
+
30
+ @patterns_app.command("show")
31
+ def patterns_show(pattern_id: str) -> None:
32
+ """Show one local pattern catalog entry by stable ID."""
33
+ try:
34
+ catalog = load_pattern_catalog(Path("."))
35
+ entry = find_pattern(catalog, pattern_id)
36
+ detail = load_pattern_detail(Path("."), entry)
37
+ except PatternCatalogError as exc:
38
+ raise typer.BadParameter(str(exc)) from exc
39
+
40
+ typer.echo(detail.markdown)
@@ -0,0 +1,25 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from pathlib import Path
5
+
6
+ import typer
7
+
8
+ from agentic_project_kit.planning_docs_consolidation_audit import (
9
+ audit_planning_docs_consolidation,
10
+ render_planning_docs_consolidation_audit,
11
+ )
12
+
13
+
14
+ def audit_planning_docs_consolidation_command(
15
+ root: Path = typer.Option(Path("."), "--root"),
16
+ json_output: bool = typer.Option(False, "--json"),
17
+ ) -> None:
18
+ """Audit planning and handoff docs for consolidation candidates."""
19
+ result = audit_planning_docs_consolidation(root.resolve())
20
+ if json_output:
21
+ typer.echo(json.dumps(result.as_dict(), indent=2, sort_keys=True))
22
+ else:
23
+ typer.echo(render_planning_docs_consolidation_audit(result), nl=False)
24
+ if not result.ok:
25
+ raise typer.Exit(code=result.returncode)
@@ -0,0 +1,133 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from pathlib import Path
5
+
6
+ import typer
7
+
8
+ from agentic_project_kit.ci_readiness import (
9
+ WAITING,
10
+ gh_pr_snapshot_provider,
11
+ render_pr_readiness,
12
+ wait_for_pr_readiness,
13
+ )
14
+ from agentic_project_kit.next_turn_merge_if_green import main_verification_passed, merge_if_green, render_result
15
+ from agentic_project_kit.next_turn_pr_status import (
16
+ attach_failed_run_logs,
17
+ classify_pr_status,
18
+ fetch_pr_payload,
19
+ render_decision,
20
+ )
21
+ from agentic_project_kit.pr_closeout import BLOCKED, evaluate_pr_closeout, render_pr_closeout
22
+
23
+ pr_app = typer.Typer(help="Evaluate deterministic PR closeout and readiness state.")
24
+
25
+
26
+ @pr_app.command("closeout-check")
27
+ def closeout_check(json_file: Path) -> None:
28
+ data = json.loads(json_file.read_text(encoding="utf-8"))
29
+ result = evaluate_pr_closeout(data)
30
+ typer.echo(render_pr_closeout(result))
31
+ if result.outcome == BLOCKED:
32
+ raise typer.Exit(code=1)
33
+
34
+
35
+ @pr_app.command("status")
36
+ def status(
37
+ pr_number: int = typer.Argument(..., help="Pull request number to inspect."),
38
+ json_output: bool = typer.Option(False, "--json", help="Print JSON instead of the text report."),
39
+ no_failed_log_fetch: bool = typer.Option(
40
+ False,
41
+ "--no-failed-log-fetch",
42
+ help="Do not fetch failed GitHub Actions logs for red checks.",
43
+ ),
44
+ failed_log_lines: int = typer.Option(120, min=0, help="Maximum failed-log excerpt lines."),
45
+ ) -> None:
46
+ """Print deterministic PR/CI status and fetch failed logs for red CI."""
47
+ payload = fetch_pr_payload(str(pr_number))
48
+ decision = classify_pr_status(payload, pr=str(pr_number))
49
+ if decision.decision == "red" and not no_failed_log_fetch:
50
+ decision = attach_failed_run_logs(decision, max_lines=failed_log_lines)
51
+ if json_output:
52
+ typer.echo(json.dumps(decision, default=lambda item: item.__dict__, indent=2, sort_keys=True))
53
+ else:
54
+ typer.echo(render_decision(decision))
55
+
56
+
57
+ @pr_app.command("merge-if-green")
58
+ def merge_if_green_command(
59
+ pr_number: int = typer.Argument(..., help="Pull request number to merge only after green checks."),
60
+ merge_method: str = typer.Option(
61
+ "squash",
62
+ help="GitHub merge method: squash, merge, or rebase.",
63
+ ),
64
+ delete_branch: bool = typer.Option(True, help="Delete the branch after a successful merge."),
65
+ dry_run: bool = typer.Option(False, "--dry-run", help="Evaluate without merging."),
66
+ no_verify_main: bool = typer.Option(False, "--no-verify-main", help="Do not verify main CI after merge."),
67
+ main_branch: str = typer.Option("main", help="Expected base branch and post-merge verification branch."),
68
+ expected_base_branch: str = typer.Option("", help="Expected PR base branch. Defaults to --main-branch."),
69
+ expected_head_sha: str = typer.Option("", help="Expected PR head SHA. Refuses merge if the head moved."),
70
+ main_ci_timeout_seconds: int = typer.Option(300, min=1, help="Post-merge main CI wait timeout."),
71
+ main_ci_poll_seconds: int = typer.Option(10, min=1, help="Post-merge main CI polling interval."),
72
+ merge_state_timeout_seconds: int = typer.Option(60, min=1, help="Pre-merge GitHub merge-state wait timeout."),
73
+ merge_state_poll_seconds: int = typer.Option(5, min=1, help="Pre-merge GitHub merge-state polling interval."),
74
+ ) -> None:
75
+ """Merge only when PR checks are green, refs match, and merge state is clean."""
76
+ result = merge_if_green(
77
+ str(pr_number),
78
+ merge_method=merge_method,
79
+ delete_branch=delete_branch,
80
+ dry_run=dry_run,
81
+ verify_main=not no_verify_main,
82
+ main_branch=main_branch,
83
+ expected_base_branch=expected_base_branch,
84
+ expected_head_sha=expected_head_sha,
85
+ main_ci_timeout_seconds=main_ci_timeout_seconds,
86
+ main_ci_poll_seconds=main_ci_poll_seconds,
87
+ merge_state_timeout_seconds=merge_state_timeout_seconds,
88
+ merge_state_poll_seconds=merge_state_poll_seconds,
89
+ )
90
+ typer.echo(render_result(result))
91
+ if dry_run:
92
+ return
93
+ if result.decision != "merge" or not result.merged or not main_verification_passed(result):
94
+ raise typer.Exit(code=1)
95
+
96
+
97
+ @pr_app.command("wait-ci")
98
+ def wait_ci(
99
+ pr_number: int = typer.Argument(..., help="Pull request number to inspect."),
100
+ expected_head_sha: str | None = typer.Option(
101
+ None,
102
+ "--expected-head-sha",
103
+ help="Expected PR head SHA for --expected-head-sha. The command fails closed if the head moves.",
104
+ ),
105
+ timeout_seconds: int = typer.Option(2700, min=1, help="Maximum wait time."),
106
+ interval_seconds: int = typer.Option(20, min=1, help="Polling interval."),
107
+ expected_check: list[str] = typer.Option(
108
+ [],
109
+ "--expected-check",
110
+ help="Check name that must be present before readiness can pass. Repeatable.",
111
+ ),
112
+ ) -> None:
113
+ """Wait for pull-request CI; guard merge preparation with --expected-head-sha."""
114
+ result = wait_for_pr_readiness(
115
+ gh_pr_snapshot_provider(pr_number),
116
+ expected_head_sha=expected_head_sha,
117
+ timeout_seconds=timeout_seconds,
118
+ interval_seconds=interval_seconds,
119
+ expected_checks=tuple(expected_check),
120
+ )
121
+ typer.echo(render_pr_readiness(result))
122
+ if not result.success:
123
+ raise typer.Exit(code=2 if result.outcome == WAITING else 1)
124
+
125
+
126
+ def register_pr_closeout_alias(app: typer.Typer) -> None:
127
+ @app.command("pr-closeout")
128
+ def pr_closeout_alias(json_file: Path) -> None:
129
+ data = json.loads(json_file.read_text(encoding="utf-8"))
130
+ result = evaluate_pr_closeout(data)
131
+ typer.echo(render_pr_closeout(result))
132
+ if result.outcome == BLOCKED:
133
+ raise typer.Exit(code=1)
@@ -0,0 +1,27 @@
1
+ from __future__ import annotations
2
+
3
+ from pathlib import Path
4
+ import json
5
+
6
+ import typer
7
+ from rich.console import Console
8
+
9
+ from agentic_project_kit.pr_hygiene import analyze_pr_hygiene, collect_pr_hygiene_inputs, render_pr_hygiene_report, report_as_json_data
10
+
11
+ console = Console()
12
+
13
+
14
+ def register_pr_hygiene_command(app: typer.Typer) -> None:
15
+ app.command("pr-hygiene")(pr_hygiene_command)
16
+
17
+
18
+ def pr_hygiene_command(
19
+ project_root: Path = typer.Option(Path("."), "--root"),
20
+ json_output: bool = typer.Option(False, "--json"),
21
+ ) -> None:
22
+ open_prs, local_branches = collect_pr_hygiene_inputs(project_root.resolve())
23
+ report = analyze_pr_hygiene(open_prs, local_branches)
24
+ if json_output:
25
+ console.print(json.dumps(report_as_json_data(report), indent=2), markup=False)
26
+ return
27
+ console.print(render_pr_hygiene_report(report), markup=False)
@@ -0,0 +1,26 @@
1
+ from __future__ import annotations
2
+
3
+ import typer
4
+ from rich.console import Console
5
+
6
+ from agentic_project_kit.contract import PROFILE_DEFINITIONS, POLICY_PACK_DEFINITIONS
7
+
8
+ console = Console()
9
+
10
+
11
+ def register_profile_commands(app: typer.Typer) -> None:
12
+ app.command("profile-explain")(profile_explain_command)
13
+
14
+
15
+ def profile_explain_command() -> None:
16
+ """List available project profiles and policy packs."""
17
+ console.print("Project profiles:")
18
+ for profile_id, definition in PROFILE_DEFINITIONS.items():
19
+ description = getattr(definition, "description", str(definition))
20
+ console.print(f"- {profile_id}: {description}")
21
+
22
+ console.print("")
23
+ console.print("Policy packs:")
24
+ for policy_pack_id, definition in POLICY_PACK_DEFINITIONS.items():
25
+ description = getattr(definition, "description", str(definition))
26
+ console.print(f"- {policy_pack_id}: {description}")
@@ -0,0 +1,25 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from pathlib import Path
5
+
6
+ import typer
7
+
8
+ from agentic_project_kit.program_redundancy_audit import (
9
+ audit_program_redundancy,
10
+ render_program_redundancy_audit,
11
+ )
12
+
13
+
14
+ def audit_program_redundancy_command(
15
+ root: Path = typer.Option(Path("."), "--root"),
16
+ json_output: bool = typer.Option(False, "--json"),
17
+ ) -> None:
18
+ """Audit source for risky bug/redundancy patterns."""
19
+ result = audit_program_redundancy(root.resolve())
20
+ if json_output:
21
+ typer.echo(json.dumps(result.as_dict(), indent=2, sort_keys=True))
22
+ else:
23
+ typer.echo(render_program_redundancy_audit(result), nl=False)
24
+ if not result.ok:
25
+ raise typer.Exit(code=result.returncode)
@@ -0,0 +1,25 @@
1
+ from __future__ import annotations
2
+
3
+ from pathlib import Path
4
+ from typing import Literal
5
+
6
+ import typer
7
+
8
+ from agentic_project_kit.project_direction import load_project_direction, render_project_direction
9
+
10
+ Section = Literal["all", "strategy", "roadmap", "plans", "ideas", "done", "discarded"]
11
+ OutputFormat = Literal["text", "markdown", "json"]
12
+
13
+
14
+ def project_direction_command(
15
+ root: Path = typer.Option(Path("."), "--root", help="Repository root."),
16
+ section: Section = typer.Option(
17
+ "all",
18
+ "--section",
19
+ help="all, strategy, roadmap, plans, ideas, done, or discarded.",
20
+ ),
21
+ output_format: OutputFormat = typer.Option("text", "--format", help="text, markdown, or json."),
22
+ ) -> None:
23
+ """Render project direction sections from the YAML source."""
24
+ direction = load_project_direction(root)
25
+ typer.echo(render_project_direction(direction, section=section, output_format=output_format), nl=False)