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,200 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from pathlib import Path
5
+ from typing import Any
6
+
7
+ import typer
8
+
9
+ from agentic_project_kit.runtime_validator import validate_required_sections
10
+
11
+
12
+ def register_validation_commands(app: typer.Typer) -> None:
13
+ app.command("validate-contract")(validate_contract)
14
+ app.command("validate-output-contract")(validate_output_contract)
15
+ app.command("validate-sections")(validate_sections)
16
+
17
+
18
+ def validate_contract(
19
+ project_root: Path = typer.Option(Path("."), "--root", help="Project root containing .agentic/project.yaml."),
20
+ ) -> None:
21
+ """Validate the machine-readable project contract."""
22
+ from agentic_project_kit.contract import contract_summary, load_project_contract, validate_project_contract
23
+
24
+ contract_data = load_project_contract(project_root.resolve())
25
+ if contract_data is None:
26
+ typer.echo("Project contract not found: .agentic/project.yaml", err=True)
27
+ raise typer.Exit(1)
28
+
29
+ errors = validate_project_contract(contract_data)
30
+ if errors:
31
+ typer.echo("Project contract validation failed", err=True)
32
+ for error in errors:
33
+ typer.echo(f"- {error}", err=True)
34
+ raise typer.Exit(1)
35
+
36
+ typer.echo("Project contract valid.")
37
+ typer.echo(contract_summary(contract_data))
38
+
39
+
40
+ def validate_output_contract(
41
+ output_path: Path = typer.Argument(..., help="Output text file to validate."),
42
+ contract_path: Path = typer.Option(..., "--contract", "-c", help="Output contract YAML file."),
43
+ report_path: Path | None = typer.Option(None, "--report", help="Write a JSON validation report."),
44
+ report_schema_path: Path | None = typer.Option(
45
+ None,
46
+ "--report-schema",
47
+ help="Validate the JSON report against a generated validation-report.schema.json file.",
48
+ ),
49
+ repair_output_path: Path | None = typer.Option(
50
+ None,
51
+ "--repair-output",
52
+ help="Write a deterministically repaired output file when supported.",
53
+ ),
54
+ repair_report_path: Path | None = typer.Option(
55
+ None,
56
+ "--repair-report",
57
+ help="Write a JSON repair report. Requires --repair-output.",
58
+ ),
59
+ ) -> None:
60
+ """Validate an output file against a machine-readable output contract."""
61
+ from agentic_project_kit.output_contract import load_output_contract, validate_output_against_contract
62
+
63
+ if repair_report_path is not None and repair_output_path is None:
64
+ typer.echo("--repair-report requires --repair-output.", err=True)
65
+ raise typer.Exit(1)
66
+
67
+ try:
68
+ contract = load_output_contract(contract_path)
69
+ except ValueError as exc:
70
+ typer.echo(f"Output contract invalid: {exc}", err=True)
71
+ raise typer.Exit(1) from exc
72
+
73
+ output_text = output_path.read_text(encoding="utf-8")
74
+ report = validate_output_against_contract(output_text, contract)
75
+ payload = {
76
+ "ok": report.ok,
77
+ "contract": contract.name,
78
+ "contract_version": contract.version,
79
+ "checked_file": str(output_path),
80
+ "findings": report.to_dict()["findings"],
81
+ }
82
+ if report_schema_path is not None:
83
+ if report_path is None:
84
+ typer.echo("--report-schema requires --report.", err=True)
85
+ raise typer.Exit(1)
86
+ schema_payload = json.loads(report_schema_path.read_text(encoding="utf-8"))
87
+ schema_errors = _validate_report_payload_against_schema(payload, schema_payload)
88
+ if schema_errors:
89
+ typer.echo("Validation report schema check failed:", err=True)
90
+ for error in schema_errors:
91
+ typer.echo(f"- {error}", err=True)
92
+ raise typer.Exit(1)
93
+
94
+ if report_path is not None:
95
+ report_path.write_text(json.dumps(payload, indent=2, sort_keys=True) + "\n", encoding="utf-8")
96
+
97
+ if report.ok:
98
+ typer.echo("Output contract validation passed.")
99
+ raise typer.Exit(0)
100
+
101
+ if repair_output_path is not None:
102
+ from agentic_project_kit.output_repair import append_missing_required_sections
103
+
104
+ repair_result = append_missing_required_sections(output_text, contract)
105
+ repair_output_path.write_text(repair_result.text, encoding="utf-8")
106
+ if repair_report_path is not None:
107
+ repair_report_path.write_text(
108
+ json.dumps(repair_result.report.to_dict(), indent=2, sort_keys=True) + "\n",
109
+ encoding="utf-8",
110
+ )
111
+ typer.echo("Output contract validation failed; deterministic repair output written.")
112
+ if repair_result.report.ok:
113
+ typer.echo("Repaired output contract validation passed.")
114
+ raise typer.Exit(0)
115
+ typer.echo("Repaired output contract validation failed.", err=True)
116
+ raise typer.Exit(1)
117
+
118
+ for finding in report.findings:
119
+ typer.echo(
120
+ f"[{finding.severity.value}] {finding.code}: {finding.message}",
121
+ err=True,
122
+ )
123
+ raise typer.Exit(1)
124
+
125
+
126
+ def _validate_report_payload_against_schema(
127
+ payload: dict[str, Any],
128
+ schema_payload: dict[str, Any],
129
+ ) -> list[str]:
130
+ errors: list[str] = []
131
+ if schema_payload.get("type") != "object":
132
+ errors.append("report schema root type must be object")
133
+ return errors
134
+ required = schema_payload.get("required", [])
135
+ if not isinstance(required, list):
136
+ errors.append("report schema required field must be a list")
137
+ return errors
138
+ for key in required:
139
+ if not isinstance(key, str):
140
+ errors.append("report schema required entries must be strings")
141
+ elif key not in payload:
142
+ errors.append(f"report payload missing required key: {key}")
143
+ properties = schema_payload.get("properties", {})
144
+ if not isinstance(properties, dict):
145
+ errors.append("report schema properties field must be an object")
146
+ return errors
147
+ if schema_payload.get("additionalProperties") is False:
148
+ allowed = set(properties)
149
+ for key in sorted(set(payload) - allowed):
150
+ errors.append(f"report payload contains unexpected key: {key}")
151
+ for key, value in payload.items():
152
+ spec = properties.get(key)
153
+ if isinstance(spec, dict):
154
+ expected_type = spec.get("type")
155
+ if expected_type and not _json_schema_type_matches(value, expected_type):
156
+ errors.append(f"report payload key has wrong type: {key}")
157
+ return errors
158
+
159
+
160
+ def _json_schema_type_matches(value: Any, expected_type: Any) -> bool:
161
+ if isinstance(expected_type, list):
162
+ return any(_json_schema_type_matches(value, item) for item in expected_type)
163
+ if expected_type == "boolean":
164
+ return isinstance(value, bool)
165
+ if expected_type == "integer":
166
+ return isinstance(value, int) and not isinstance(value, bool)
167
+ if expected_type == "number":
168
+ return (isinstance(value, int) or isinstance(value, float)) and not isinstance(value, bool)
169
+ if expected_type == "string":
170
+ return isinstance(value, str)
171
+ if expected_type == "array":
172
+ return isinstance(value, list)
173
+ if expected_type == "object":
174
+ return isinstance(value, dict)
175
+ if expected_type == "null":
176
+ return value is None
177
+ return True
178
+
179
+
180
+ def validate_sections(
181
+ path: Path = typer.Argument(..., help="Text file to validate."),
182
+ required_section: list[str] = typer.Option(
183
+ ...,
184
+ "--required-section",
185
+ "-s",
186
+ help="Required literal section marker. Repeat the option for multiple sections.",
187
+ ),
188
+ ) -> None:
189
+ """Validate that a text file contains required literal section markers."""
190
+ report = validate_required_sections(path.read_text(encoding="utf-8"), tuple(required_section))
191
+ if report.ok:
192
+ typer.echo("Runtime validation passed.")
193
+ raise typer.Exit(0)
194
+
195
+ for finding in report.findings:
196
+ typer.echo(
197
+ f"[{finding.severity.value}] {finding.code}: {finding.message}",
198
+ err=True,
199
+ )
200
+ raise typer.Exit(1)
@@ -0,0 +1,27 @@
1
+ from __future__ import annotations
2
+
3
+ import typer
4
+
5
+ from agentic_project_kit import __version__
6
+
7
+
8
+ def _version_callback(value: bool) -> None:
9
+ if value:
10
+ typer.echo(f"agentic-kit {__version__}")
11
+ raise typer.Exit()
12
+
13
+
14
+ def _main_callback(
15
+ version: bool = typer.Option(
16
+ False,
17
+ "--version",
18
+ help="Show the installed agentic-kit version and exit.",
19
+ callback=_version_callback,
20
+ is_eager=True,
21
+ ),
22
+ ) -> None:
23
+ """Generate and check agentic GitHub project skeletons."""
24
+
25
+
26
+ def register_version_callback(app: typer.Typer) -> None:
27
+ app.callback()(_main_callback)
@@ -0,0 +1,219 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ from pathlib import Path
5
+
6
+ import typer
7
+
8
+ from agentic_project_kit.typed_work_order_queue import (
9
+ inspect_typed_work_order_queue,
10
+ render_typed_work_order_queue_status,
11
+ run_typed_next,
12
+ typed_next_result_as_json_data,
13
+ typed_work_order_queue_status_as_json_data,
14
+ )
15
+ from agentic_project_kit.typed_work_order_runner import (
16
+ load_typed_work_order,
17
+ run_typed_work_order,
18
+ typed_work_order_result_as_json_data,
19
+ )
20
+ from agentic_project_kit.work_orders import (
21
+ check_work_orders,
22
+ list_work_order_templates,
23
+ list_work_orders,
24
+ load_work_order,
25
+ prepare_work_order,
26
+ render_work_order,
27
+ run_work_order,
28
+ )
29
+ from agentic_project_kit.work_order_uploader import (
30
+ render_work_order_upload_result,
31
+ upload_next_turn_result_log,
32
+ )
33
+
34
+ work_orders_app = typer.Typer(help="Inspect and run repo-backed work orders.")
35
+
36
+
37
+ @work_orders_app.command("list")
38
+ def list_command() -> None:
39
+ for order in list_work_orders():
40
+ typer.echo(f"{order.work_order_id}\t{order.safety}\t{order.title}")
41
+
42
+
43
+ @work_orders_app.command("show")
44
+ def show_command(work_order_id: str) -> None:
45
+ try:
46
+ order = load_work_order(work_order_id)
47
+ except (FileNotFoundError, ValueError) as exc:
48
+ typer.echo(str(exc))
49
+ raise typer.Exit(code=1) from exc
50
+ typer.echo(render_work_order(order))
51
+
52
+
53
+ @work_orders_app.command("check")
54
+ def check_command() -> None:
55
+ errors = check_work_orders()
56
+ if errors:
57
+ for error in errors:
58
+ typer.echo(f"[FAIL] {error}")
59
+ raise typer.Exit(code=1)
60
+ typer.echo("Work order contract check passed")
61
+
62
+
63
+ @work_orders_app.command("run")
64
+ def run_command(work_order_id: str, execute: bool = typer.Option(False, "--execute", help="Actually run the work order. Omit for dry-run.")) -> None:
65
+ try:
66
+ order = load_work_order(work_order_id)
67
+ except (FileNotFoundError, ValueError) as exc:
68
+ typer.echo(str(exc))
69
+ raise typer.Exit(code=1) from exc
70
+ typer.echo(render_work_order(order))
71
+ if not execute:
72
+ typer.echo("Dry run only. Re-run with --execute to run the command.")
73
+ return
74
+ result_code = run_work_order(order)
75
+ typer.echo(f"Work order log written: {order.log_path}")
76
+ if result_code != 0:
77
+ raise typer.Exit(code=result_code)
78
+
79
+
80
+
81
+
82
+ @work_orders_app.command("typed-next")
83
+ def typed_next_command(
84
+ json_output: bool = typer.Option(False, "--json", help="Print machine-readable JSON result."),
85
+ ) -> None:
86
+ result = run_typed_next(Path("."))
87
+ data = typed_next_result_as_json_data(result)
88
+ if json_output:
89
+ typer.echo(json.dumps(data, indent=2, sort_keys=True))
90
+ else:
91
+ typer.echo(f"typed_next_status={result.result_status}")
92
+ typer.echo(f"queue_status={result.queue_status}")
93
+ typer.echo(f"message={result.message}")
94
+ if result.terminal_log:
95
+ typer.echo(f"terminal_log={result.terminal_log}")
96
+ if result.returncode != 0:
97
+ raise typer.Exit(code=result.returncode)
98
+
99
+
100
+ @work_orders_app.command("typed-queue-status")
101
+ def typed_queue_status_command(
102
+ inbox_path: Path = typer.Option(Path(".agentic/typed_work_orders/inbox"), "--inbox", help="Typed work order inbox directory."),
103
+ json_output: bool = typer.Option(False, "--json", help="Print machine-readable JSON queue status."),
104
+ ) -> None:
105
+ try:
106
+ status = inspect_typed_work_order_queue(inbox_path)
107
+ except ValueError as exc:
108
+ typer.echo(str(exc))
109
+ raise typer.Exit(code=2) from exc
110
+ if json_output:
111
+ typer.echo(json.dumps(typed_work_order_queue_status_as_json_data(status), indent=2, sort_keys=True))
112
+ else:
113
+ typer.echo(render_typed_work_order_queue_status(status))
114
+ if status.status == "multiple_commands":
115
+ raise typer.Exit(code=2)
116
+
117
+
118
+ @work_orders_app.command("typed-run")
119
+ def typed_run_command(
120
+ work_order_path: Path,
121
+ execute: bool = typer.Option(False, "--execute", help="Actually run the typed work order. Omit for dry-run."),
122
+ json_output: bool = typer.Option(False, "--json", help="Print machine-readable JSON result."),
123
+ ) -> None:
124
+ try:
125
+ order = load_typed_work_order(work_order_path)
126
+ except (FileNotFoundError, ValueError) as exc:
127
+ typer.echo(str(exc))
128
+ raise typer.Exit(code=1) from exc
129
+ if not execute:
130
+ typer.echo(f"Typed work order: {order.work_order_id}")
131
+ typer.echo(f"Safety: {order.safety}")
132
+ typer.echo(f"Steps: {len(order.steps)}")
133
+ typer.echo("Dry run only. Re-run with --execute to run the typed work order.")
134
+ return
135
+ result = run_typed_work_order(order, Path("."))
136
+ data = typed_work_order_result_as_json_data(result)
137
+ if json_output:
138
+ typer.echo(json.dumps(data, indent=2, sort_keys=True))
139
+ else:
140
+ typer.echo(f"Typed work order result: {result.result_status}")
141
+ typer.echo(f"Typed work order log written: {result.terminal_log}")
142
+ if result.returncode != 0:
143
+ raise typer.Exit(code=result.returncode)
144
+
145
+
146
+ @work_orders_app.command("upload")
147
+ def upload_command(
148
+ log_path: Path | None = typer.Option(
149
+ None,
150
+ "--log-path",
151
+ help="Repository evidence log path to commit; defaults to the next-turn result log.",
152
+ ),
153
+ local_log_path: Path | None = typer.Option(
154
+ None,
155
+ "--local-log-path",
156
+ help="Local result log to promote before committing.",
157
+ ),
158
+ commit_message: str = typer.Option(
159
+ "Upload next-turn result log",
160
+ "--commit-message",
161
+ help="Commit message for the bounded result-log upload.",
162
+ ),
163
+ required_branch: str = typer.Option(
164
+ "",
165
+ "--required-branch",
166
+ help="Require the current branch to match this value before committing.",
167
+ ),
168
+ allow_main: bool = typer.Option(
169
+ False,
170
+ "--allow-main",
171
+ help="Allow committing on main; reserved for explicit maintainer-controlled recovery.",
172
+ ),
173
+ json_output: bool = typer.Option(False, "--json", help="Print machine-readable JSON result."),
174
+ ) -> None:
175
+ result = upload_next_turn_result_log(
176
+ log_path=log_path,
177
+ local_log_path=local_log_path,
178
+ commit_message=commit_message,
179
+ required_branch=required_branch,
180
+ allow_main=allow_main,
181
+ )
182
+ if json_output:
183
+ typer.echo(
184
+ json.dumps(
185
+ {
186
+ "schema_version": 1,
187
+ "kind": "work_order_upload_result",
188
+ "ok": result.ok,
189
+ "committed": result.committed,
190
+ "pushed": result.pushed,
191
+ "returncode": result.returncode,
192
+ "log_path": str(result.log_path),
193
+ "message": result.message,
194
+ "commit_sha": result.commit_sha,
195
+ },
196
+ indent=2,
197
+ sort_keys=True,
198
+ )
199
+ )
200
+ else:
201
+ typer.echo(render_work_order_upload_result(result))
202
+ if result.returncode != 0:
203
+ raise typer.Exit(code=result.returncode)
204
+
205
+
206
+ @work_orders_app.command("templates")
207
+ def templates() -> None:
208
+ for template_id in list_work_order_templates():
209
+ typer.echo(template_id)
210
+
211
+
212
+ @work_orders_app.command("prepare")
213
+ def prepare(template_id: str, work_order_id: str, expected_branch: str) -> None:
214
+ try:
215
+ path = prepare_work_order(template_id, work_order_id, expected_branch)
216
+ except (FileNotFoundError, ValueError) as exc:
217
+ typer.echo(str(exc))
218
+ raise typer.Exit(code=1) from exc
219
+ typer.echo(f"Prepared work order: {path}")