agentic-project-kit 1.0.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- agentic_project_kit/__init__.py +1 -0
- agentic_project_kit/absolute_path_portability_audit.py +241 -0
- agentic_project_kit/access_level_policy.py +14 -0
- agentic_project_kit/access_levels.py +22 -0
- agentic_project_kit/action_registry.py +195 -0
- agentic_project_kit/action_specs.py +286 -0
- agentic_project_kit/agent_command_runner.py +516 -0
- agentic_project_kit/audit_test_matrix.py +36 -0
- agentic_project_kit/audit_test_matrix_cli.py +43 -0
- agentic_project_kit/chat_bootloader.py +257 -0
- agentic_project_kit/chat_entrypoint_contract.py +297 -0
- agentic_project_kit/checks.py +511 -0
- agentic_project_kit/ci_readiness.py +211 -0
- agentic_project_kit/cli.py +147 -0
- agentic_project_kit/cli_commands/__init__.py +1 -0
- agentic_project_kit/cli_commands/absolute_path_audit.py +25 -0
- agentic_project_kit/cli_commands/actions.py +21 -0
- agentic_project_kit/cli_commands/artifact_gc.py +240 -0
- agentic_project_kit/cli_commands/boot.py +55 -0
- agentic_project_kit/cli_commands/chat.py +34 -0
- agentic_project_kit/cli_commands/checks.py +305 -0
- agentic_project_kit/cli_commands/cockpit.py +103 -0
- agentic_project_kit/cli_commands/command_taxonomy.py +25 -0
- agentic_project_kit/cli_commands/commands.py +129 -0
- agentic_project_kit/cli_commands/dev.py +23 -0
- agentic_project_kit/cli_commands/direction.py +92 -0
- agentic_project_kit/cli_commands/doc_currency_audit.py +25 -0
- agentic_project_kit/cli_commands/doc_registry.py +126 -0
- agentic_project_kit/cli_commands/docs.py +223 -0
- agentic_project_kit/cli_commands/dpa.py +1338 -0
- agentic_project_kit/cli_commands/evidence.py +251 -0
- agentic_project_kit/cli_commands/github.py +34 -0
- agentic_project_kit/cli_commands/governance.py +14 -0
- agentic_project_kit/cli_commands/gui.py +23 -0
- agentic_project_kit/cli_commands/gui_readiness_gate.py +27 -0
- agentic_project_kit/cli_commands/handoff.py +183 -0
- agentic_project_kit/cli_commands/human_workflows.py +430 -0
- agentic_project_kit/cli_commands/init.py +132 -0
- agentic_project_kit/cli_commands/instruction.py +75 -0
- agentic_project_kit/cli_commands/mutation_lock_audit.py +24 -0
- agentic_project_kit/cli_commands/ns_legacy_audit.py +25 -0
- agentic_project_kit/cli_commands/pass_already_done.py +66 -0
- agentic_project_kit/cli_commands/patch_failure_discipline_audit.py +26 -0
- agentic_project_kit/cli_commands/patch_preflight.py +37 -0
- agentic_project_kit/cli_commands/path_literal_audit.py +39 -0
- agentic_project_kit/cli_commands/patterns.py +40 -0
- agentic_project_kit/cli_commands/planning_docs_audit.py +25 -0
- agentic_project_kit/cli_commands/pr.py +133 -0
- agentic_project_kit/cli_commands/pr_hygiene.py +27 -0
- agentic_project_kit/cli_commands/profiles.py +26 -0
- agentic_project_kit/cli_commands/program_redundancy_audit.py +25 -0
- agentic_project_kit/cli_commands/project_direction.py +25 -0
- agentic_project_kit/cli_commands/release.py +392 -0
- agentic_project_kit/cli_commands/release_publish_orchestration.py +36 -0
- agentic_project_kit/cli_commands/remote_branch_hygiene.py +152 -0
- agentic_project_kit/cli_commands/remote_next.py +57 -0
- agentic_project_kit/cli_commands/removed_ns_commands.py +65 -0
- agentic_project_kit/cli_commands/rule_registry.py +129 -0
- agentic_project_kit/cli_commands/rules.py +222 -0
- agentic_project_kit/cli_commands/scaffold.py +46 -0
- agentic_project_kit/cli_commands/slice.py +21 -0
- agentic_project_kit/cli_commands/standard_gates_audit_suite.py +27 -0
- agentic_project_kit/cli_commands/state.py +51 -0
- agentic_project_kit/cli_commands/status_current_state_audit.py +30 -0
- agentic_project_kit/cli_commands/todo.py +53 -0
- agentic_project_kit/cli_commands/transfer.py +19 -0
- agentic_project_kit/cli_commands/transfer_context_flow.py +398 -0
- agentic_project_kit/cli_commands/transfer_context_helpers.py +398 -0
- agentic_project_kit/cli_commands/transfer_diagnostics.py +767 -0
- agentic_project_kit/cli_commands/transfer_evidence_flow.py +368 -0
- agentic_project_kit/cli_commands/transfer_handoff_flow.py +594 -0
- agentic_project_kit/cli_commands/transfer_order_contract.py +74 -0
- agentic_project_kit/cli_commands/transfer_post_merge_complete.py +442 -0
- agentic_project_kit/cli_commands/transfer_post_merge_settle.py +171 -0
- agentic_project_kit/cli_commands/transfer_pr_closeout_complete.py +124 -0
- agentic_project_kit/cli_commands/transfer_pr_create_flow.py +743 -0
- agentic_project_kit/cli_commands/transfer_pr_merge_flow.py +547 -0
- agentic_project_kit/cli_commands/transfer_repo_after_pr.py +160 -0
- agentic_project_kit/cli_commands/transfer_repo_pre_pr.py +664 -0
- agentic_project_kit/cli_commands/transfer_runner_flow.py +131 -0
- agentic_project_kit/cli_commands/transfer_runtime_initial.py +194 -0
- agentic_project_kit/cli_commands/transfer_shared.py +274 -0
- agentic_project_kit/cli_commands/validation.py +200 -0
- agentic_project_kit/cli_commands/version.py +27 -0
- agentic_project_kit/cli_commands/work_orders.py +219 -0
- agentic_project_kit/cli_commands/workflow.py +471 -0
- agentic_project_kit/cli_commands/workflow_guard.py +26 -0
- agentic_project_kit/cli_commands/workspace.py +252 -0
- agentic_project_kit/cockpit.py +608 -0
- agentic_project_kit/cockpit_readiness.py +67 -0
- agentic_project_kit/command_authority_audit.py +192 -0
- agentic_project_kit/command_inbox_check.py +103 -0
- agentic_project_kit/command_manifest.py +591 -0
- agentic_project_kit/command_queue_contract.py +161 -0
- agentic_project_kit/command_selector.py +245 -0
- agentic_project_kit/command_taxonomy.py +264 -0
- agentic_project_kit/commit_guard.py +67 -0
- agentic_project_kit/communication_artifact_gc.py +495 -0
- agentic_project_kit/communication_rule_context.py +437 -0
- agentic_project_kit/communication_state.py +115 -0
- agentic_project_kit/composed_wrapper_invariants.py +97 -0
- agentic_project_kit/composite_short_circuit.py +140 -0
- agentic_project_kit/contract.py +251 -0
- agentic_project_kit/control_state.py +83 -0
- agentic_project_kit/doc_currency_audit.py +536 -0
- agentic_project_kit/doc_lifecycle.py +1179 -0
- agentic_project_kit/doc_lifecycle_signals.py +446 -0
- agentic_project_kit/doc_lifecycle_sweep.py +639 -0
- agentic_project_kit/doc_mesh.py +491 -0
- agentic_project_kit/doctor.py +379 -0
- agentic_project_kit/documentation_registry.py +1122 -0
- agentic_project_kit/documentation_system_audit.py +310 -0
- agentic_project_kit/dpa_current_handoff_lifecycle.py +549 -0
- agentic_project_kit/dpa_dp2_decision_readiness.py +362 -0
- agentic_project_kit/dpa_dp3_dp4_adjudication.py +604 -0
- agentic_project_kit/dpa_dp5_block_new_gate.py +294 -0
- agentic_project_kit/dpa_dp5_stage_adoption.py +615 -0
- agentic_project_kit/dpa_dp5_strict_gate.py +187 -0
- agentic_project_kit/dpa_final_closeout.py +627 -0
- agentic_project_kit/dpa_fixture_evidence.py +680 -0
- agentic_project_kit/dpa_maintainer_record_check.py +711 -0
- agentic_project_kit/dpa_post_dp2_scope_assessment.py +734 -0
- agentic_project_kit/dpa_probe_002_readiness.py +509 -0
- agentic_project_kit/dpa_probe_003_readiness.py +417 -0
- agentic_project_kit/dpa_probe_004_readiness.py +437 -0
- agentic_project_kit/dpa_readiness.py +505 -0
- agentic_project_kit/dpa_readonly_probe_execution.py +500 -0
- agentic_project_kit/dpa_registry_contracts.py +312 -0
- agentic_project_kit/dpa_renderer_readiness.py +407 -0
- agentic_project_kit/dpa_repo_adoption_assessment.py +574 -0
- agentic_project_kit/dpa_stable_readiness.py +743 -0
- agentic_project_kit/dpa_successor_projection.py +168 -0
- agentic_project_kit/dpa_workspace_init_projection.py +93 -0
- agentic_project_kit/dpa_wrt_ch001_evidence.py +327 -0
- agentic_project_kit/entrypoint_slice_runner.py +153 -0
- agentic_project_kit/evidence_clean.py +152 -0
- agentic_project_kit/evidence_commit_paths.py +214 -0
- agentic_project_kit/evidence_finalize_log.py +204 -0
- agentic_project_kit/evidence_guard.py +114 -0
- agentic_project_kit/evidence_inspector.py +507 -0
- agentic_project_kit/evidence_state_contract.py +99 -0
- agentic_project_kit/execution_mode_state.py +148 -0
- agentic_project_kit/final_summary_contract.py +85 -0
- agentic_project_kit/finalize_guard.py +139 -0
- agentic_project_kit/gatekeeper_core.py +232 -0
- agentic_project_kit/github.py +25 -0
- agentic_project_kit/governance.py +59 -0
- agentic_project_kit/gui_action_execution.py +105 -0
- agentic_project_kit/gui_action_renderer.py +81 -0
- agentic_project_kit/gui_action_run_intent.py +98 -0
- agentic_project_kit/gui_action_views.py +195 -0
- agentic_project_kit/gui_activity_log.py +76 -0
- agentic_project_kit/gui_button_catalog.py +605 -0
- agentic_project_kit/gui_cockpit.py +365 -0
- agentic_project_kit/gui_cockpit_actions.py +695 -0
- agentic_project_kit/gui_cockpit_common.py +172 -0
- agentic_project_kit/gui_cockpit_header.py +501 -0
- agentic_project_kit/gui_cockpit_sidebar.py +387 -0
- agentic_project_kit/gui_cockpit_task.py +748 -0
- agentic_project_kit/gui_command_projection.py +355 -0
- agentic_project_kit/gui_communication_modes.py +130 -0
- agentic_project_kit/gui_dry_run.py +219 -0
- agentic_project_kit/gui_gatekeeper_status.py +259 -0
- agentic_project_kit/gui_layout_plan.py +148 -0
- agentic_project_kit/gui_open_folder.py +18 -0
- agentic_project_kit/gui_output_status_panel.py +61 -0
- agentic_project_kit/gui_panel_state.py +47 -0
- agentic_project_kit/gui_presenter.py +62 -0
- agentic_project_kit/gui_readiness_gate.py +206 -0
- agentic_project_kit/gui_release_flow.py +59 -0
- agentic_project_kit/gui_task_editor.py +1077 -0
- agentic_project_kit/gui_tk_widgets.py +177 -0
- agentic_project_kit/gui_tkinter_renderer.py +87 -0
- agentic_project_kit/gui_tkinter_shell.py +1176 -0
- agentic_project_kit/gui_transfer_contract.py +28 -0
- agentic_project_kit/gui_viewmodel.py +698 -0
- agentic_project_kit/gui_window_guard.py +46 -0
- agentic_project_kit/handoff_freshness.py +390 -0
- agentic_project_kit/handoff_prompt.py +180 -0
- agentic_project_kit/handoff_state.py +254 -0
- agentic_project_kit/instruction_lint.py +455 -0
- agentic_project_kit/llm_context_carriers.py +66 -0
- agentic_project_kit/llm_execution_context.py +285 -0
- agentic_project_kit/local_command_stack.py +133 -0
- agentic_project_kit/local_feature_gate.py +82 -0
- agentic_project_kit/local_garbage_collector.py +269 -0
- agentic_project_kit/models.py +18 -0
- agentic_project_kit/mutation_lock_audit.py +421 -0
- agentic_project_kit/next_turn_evidence.py +253 -0
- agentic_project_kit/next_turn_merge_if_green.py +459 -0
- agentic_project_kit/next_turn_pr_status.py +255 -0
- agentic_project_kit/next_turn_result.py +183 -0
- agentic_project_kit/next_turn_runner.py +159 -0
- agentic_project_kit/next_turn_slot.py +107 -0
- agentic_project_kit/next_turn_status.py +274 -0
- agentic_project_kit/ns_legacy_reference_audit.py +258 -0
- agentic_project_kit/ns_slice_runner.py +16 -0
- agentic_project_kit/operational_handoff_projection.py +124 -0
- agentic_project_kit/output_contract.py +80 -0
- agentic_project_kit/output_repair.py +61 -0
- agentic_project_kit/pass_already_done.py +216 -0
- agentic_project_kit/patch_artifact_preflight.py +147 -0
- agentic_project_kit/patch_cycle_workflow.py +440 -0
- agentic_project_kit/patch_failure_discipline_audit.py +223 -0
- agentic_project_kit/patch_preflight.py +215 -0
- agentic_project_kit/path_literal_audit.py +612 -0
- agentic_project_kit/patterns.py +99 -0
- agentic_project_kit/planning_docs_consolidation_audit.py +313 -0
- agentic_project_kit/portability_shell_gate.py +40 -0
- agentic_project_kit/post_merge_handoff_refresh.py +56 -0
- agentic_project_kit/post_release.py +252 -0
- agentic_project_kit/post_release_closeout.py +616 -0
- agentic_project_kit/pr_cleanup.py +172 -0
- agentic_project_kit/pr_closeout.py +50 -0
- agentic_project_kit/pr_closeout_complete.py +344 -0
- agentic_project_kit/pr_create_or_skip.py +71 -0
- agentic_project_kit/pr_hygiene.py +210 -0
- agentic_project_kit/program_redundancy_audit.py +251 -0
- agentic_project_kit/project_direction.py +840 -0
- agentic_project_kit/protected_change_planner.py +194 -0
- agentic_project_kit/release.py +401 -0
- agentic_project_kit/release_doi_safety.py +24 -0
- agentic_project_kit/release_gate_core.py +174 -0
- agentic_project_kit/release_metadata_authority_gate.py +328 -0
- agentic_project_kit/release_metadata_prep.py +43 -0
- agentic_project_kit/release_notes.py +823 -0
- agentic_project_kit/release_prep_core.py +204 -0
- agentic_project_kit/release_prepare.py +369 -0
- agentic_project_kit/release_process_guardrails.py +247 -0
- agentic_project_kit/release_publish_core.py +114 -0
- agentic_project_kit/release_publish_orchestration.py +469 -0
- agentic_project_kit/release_state.py +552 -0
- agentic_project_kit/release_verify_core.py +175 -0
- agentic_project_kit/remote_branch_hygiene.py +223 -0
- agentic_project_kit/remote_next.py +89 -0
- agentic_project_kit/remote_next_closeout.py +101 -0
- agentic_project_kit/remote_next_order_contract.py +391 -0
- agentic_project_kit/removed_ns_commands.py +458 -0
- agentic_project_kit/removed_source_audit.py +225 -0
- agentic_project_kit/rendering.py +13 -0
- agentic_project_kit/repair_report.py +79 -0
- agentic_project_kit/repo_identity.py +59 -0
- agentic_project_kit/result_report_classifier.py +57 -0
- agentic_project_kit/rule_ack.py +105 -0
- agentic_project_kit/rule_preservation.py +58 -0
- agentic_project_kit/rule_refresh.py +174 -0
- agentic_project_kit/rule_registry_registration.py +322 -0
- agentic_project_kit/rule_registry_report.py +206 -0
- agentic_project_kit/rule_registry_validator.py +704 -0
- agentic_project_kit/rule_snapshot.py +98 -0
- agentic_project_kit/rule_source_validator.py +133 -0
- agentic_project_kit/run_summary.py +68 -0
- agentic_project_kit/run_summary_renderer.py +238 -0
- agentic_project_kit/runtime_validator.py +68 -0
- agentic_project_kit/safe_file_replace.py +35 -0
- agentic_project_kit/safe_patch.py +47 -0
- agentic_project_kit/safe_push.py +218 -0
- agentic_project_kit/safe_remove_diagnostic.py +51 -0
- agentic_project_kit/scaffold.py +69 -0
- agentic_project_kit/site_claims.py +444 -0
- agentic_project_kit/site_generator.py +1140 -0
- agentic_project_kit/slice_gate.py +225 -0
- agentic_project_kit/slice_runner.py +75 -0
- agentic_project_kit/standard_gates_audit_suite.py +167 -0
- agentic_project_kit/state_freshness.py +135 -0
- agentic_project_kit/status_current_state_audit.py +762 -0
- agentic_project_kit/successor_handoff_package.py +1763 -0
- agentic_project_kit/templates.py +292 -0
- agentic_project_kit/terminal_block_guard.py +166 -0
- agentic_project_kit/terminal_logging.py +275 -0
- agentic_project_kit/todo.py +97 -0
- agentic_project_kit/transfer_closeout.py +136 -0
- agentic_project_kit/transfer_continue.py +215 -0
- agentic_project_kit/transfer_local_runner.py +101 -0
- agentic_project_kit/transfer_operation_monitor.py +236 -0
- agentic_project_kit/transfer_post_merge_lifecycle.py +356 -0
- agentic_project_kit/transfer_post_merge_settle.py +383 -0
- agentic_project_kit/transfer_pr_actions.py +164 -0
- agentic_project_kit/transfer_remote_next.py +959 -0
- agentic_project_kit/transfer_repo_actions.py +2253 -0
- agentic_project_kit/transfer_runner.py +347 -0
- agentic_project_kit/transfer_safety_context.py +291 -0
- agentic_project_kit/transfer_state.py +483 -0
- agentic_project_kit/transfer_uplink.py +471 -0
- agentic_project_kit/transfer_workflow_next.py +148 -0
- agentic_project_kit/typed_work_order_evidence.py +58 -0
- agentic_project_kit/typed_work_order_queue.py +166 -0
- agentic_project_kit/typed_work_order_runner.py +168 -0
- agentic_project_kit/work_cycle.py +317 -0
- agentic_project_kit/work_discard_changes.py +129 -0
- agentic_project_kit/work_order_patch.py +199 -0
- agentic_project_kit/work_order_runner.py +120 -0
- agentic_project_kit/work_order_uploader.py +220 -0
- agentic_project_kit/work_order_validator.py +185 -0
- agentic_project_kit/work_orders.py +246 -0
- agentic_project_kit/workflow_guard.py +262 -0
- agentic_project_kit/workflow_summary_runner.py +124 -0
- agentic_project_kit/workspace.py +665 -0
- agentic_project_kit/workspace_adopt.py +471 -0
- agentic_project_kit/workspace_dpa_intake.py +406 -0
- agentic_project_kit/workspace_init.py +487 -0
- agentic_project_kit/workspace_lock.py +129 -0
- agentic_project_kit/workspace_remove.py +381 -0
- agentic_project_kit/workspace_upgrade.py +324 -0
- agentic_project_kit/wrapper_live_status.py +104 -0
- agentic_project_kit-1.0.1.dist-info/METADATA +724 -0
- agentic_project_kit-1.0.1.dist-info/RECORD +310 -0
- agentic_project_kit-1.0.1.dist-info/WHEEL +4 -0
- agentic_project_kit-1.0.1.dist-info/entry_points.txt +3 -0
- agentic_project_kit-1.0.1.dist-info/licenses/LICENSE +10 -0
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
import json
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
from typing import Optional
|
|
6
|
+
|
|
7
|
+
import typer
|
|
8
|
+
|
|
9
|
+
from agentic_project_kit.removed_ns_commands import (
|
|
10
|
+
build_removed_ns_command_report,
|
|
11
|
+
write_markdown_report,
|
|
12
|
+
)
|
|
13
|
+
|
|
14
|
+
app = typer.Typer(help="Diagnose ns commands removed between release refs.")
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
@app.command("diagnose-removed-ns-commands")
|
|
18
|
+
def diagnose_removed_ns_commands(
|
|
19
|
+
old: str = typer.Option("0.4.6", "--old", help="Old release tag/ref."),
|
|
20
|
+
new: str = typer.Option("0.4.8", "--new", help="New release tag/ref."),
|
|
21
|
+
json_out: Optional[Path] = typer.Option(None, "--json-out", help="Write machine-readable report."),
|
|
22
|
+
md_out: Optional[Path] = typer.Option(None, "--md-out", help="Write Markdown report."),
|
|
23
|
+
json_output: bool = typer.Option(False, "--json", help="Print full JSON report to stdout."),
|
|
24
|
+
) -> None:
|
|
25
|
+
"""Diagnose ns command definitions/usages removed or reduced between release refs."""
|
|
26
|
+
report = build_removed_ns_command_report(old=old, new=new)
|
|
27
|
+
|
|
28
|
+
if json_out is not None:
|
|
29
|
+
json_out.parent.mkdir(parents=True, exist_ok=True)
|
|
30
|
+
json_out.write_text(json.dumps(report, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
|
|
31
|
+
|
|
32
|
+
if md_out is not None:
|
|
33
|
+
md_out.parent.mkdir(parents=True, exist_ok=True)
|
|
34
|
+
write_markdown_report(report, md_out)
|
|
35
|
+
|
|
36
|
+
if json_output:
|
|
37
|
+
typer.echo(json.dumps(report, indent=2, ensure_ascii=False))
|
|
38
|
+
return
|
|
39
|
+
|
|
40
|
+
typer.echo("REMOVED_NS_COMMAND_DIAGNOSIS")
|
|
41
|
+
typer.echo(f"old_ref={report['old_ref']}")
|
|
42
|
+
typer.echo(f"new_ref={report['new_ref']}")
|
|
43
|
+
typer.echo(f"old_commit={report['old_commit']}")
|
|
44
|
+
typer.echo(f"new_commit={report['new_commit']}")
|
|
45
|
+
typer.echo("candidate_commands:")
|
|
46
|
+
for item in report["candidate_commands"][:40]:
|
|
47
|
+
typer.echo(
|
|
48
|
+
"- {name}: old={old_count} new={new_count} main={main_count} "
|
|
49
|
+
"removed_or_decreased={signal}".format(
|
|
50
|
+
name=item["name"],
|
|
51
|
+
old_count=item["evidence_count_old"],
|
|
52
|
+
new_count=item["evidence_count_new"],
|
|
53
|
+
main_count=item["evidence_count_main"],
|
|
54
|
+
signal=item["removed_or_decreased_signal"],
|
|
55
|
+
)
|
|
56
|
+
)
|
|
57
|
+
if json_out is not None:
|
|
58
|
+
typer.echo(f"json_out={json_out}")
|
|
59
|
+
if md_out is not None:
|
|
60
|
+
typer.echo(f"md_out={md_out}")
|
|
61
|
+
typer.echo("RESULT=REMOVED_NS_COMMAND_DIAGNOSIS_DONE")
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
def register_removed_ns_commands(transfer_app: typer.Typer) -> None:
|
|
65
|
+
transfer_app.add_typer(app)
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
import json
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
from typing import Annotated
|
|
6
|
+
|
|
7
|
+
import typer
|
|
8
|
+
|
|
9
|
+
from agentic_project_kit.rule_registry_registration import (
|
|
10
|
+
register_rule_registry_entry,
|
|
11
|
+
)
|
|
12
|
+
from agentic_project_kit.rule_registry_report import (
|
|
13
|
+
build_rule_registry_report,
|
|
14
|
+
render_rule_registry_report,
|
|
15
|
+
)
|
|
16
|
+
from agentic_project_kit.rule_registry_validator import (
|
|
17
|
+
render_rule_registry_findings,
|
|
18
|
+
validate_rule_registry,
|
|
19
|
+
)
|
|
20
|
+
|
|
21
|
+
rule_registry_app = typer.Typer(help="Validate governed rule registry artifacts.")
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
@rule_registry_app.command("check")
|
|
25
|
+
def rule_registry_check() -> None:
|
|
26
|
+
findings = validate_rule_registry()
|
|
27
|
+
typer.echo(render_rule_registry_findings(findings))
|
|
28
|
+
if findings:
|
|
29
|
+
raise typer.Exit(1)
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
@rule_registry_app.command("report")
|
|
33
|
+
def rule_registry_report(
|
|
34
|
+
json_output: bool = typer.Option(False, "--json", help="Emit machine-readable JSON."),
|
|
35
|
+
fail_on_followups: bool = typer.Option(
|
|
36
|
+
False,
|
|
37
|
+
"--fail-on-followups",
|
|
38
|
+
help="Exit non-zero when follow-up items remain, even if validation passes.",
|
|
39
|
+
),
|
|
40
|
+
) -> None:
|
|
41
|
+
report = build_rule_registry_report()
|
|
42
|
+
if json_output:
|
|
43
|
+
typer.echo(json.dumps(report, indent=2, sort_keys=True))
|
|
44
|
+
else:
|
|
45
|
+
typer.echo(render_rule_registry_report(report))
|
|
46
|
+
summary = report.get("summary", {}) if isinstance(report.get("summary"), dict) else {}
|
|
47
|
+
if summary.get("validation_finding_count", 0):
|
|
48
|
+
raise typer.Exit(1)
|
|
49
|
+
if fail_on_followups and summary.get("followup_count", 0):
|
|
50
|
+
raise typer.Exit(1)
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
@rule_registry_app.command("register")
|
|
54
|
+
def rule_registry_register(
|
|
55
|
+
mechanism_id: Annotated[str, typer.Option("--id", help="Unique rule mechanism id.")],
|
|
56
|
+
rule_class: Annotated[
|
|
57
|
+
str,
|
|
58
|
+
typer.Option("--class", help="Rule mechanism class/category."),
|
|
59
|
+
],
|
|
60
|
+
owner: Annotated[str, typer.Option("--owner", help="Responsible owner.")],
|
|
61
|
+
priority: Annotated[int, typer.Option("--priority", help="Positive enforcement priority.")],
|
|
62
|
+
enforcement_phase: Annotated[
|
|
63
|
+
str,
|
|
64
|
+
typer.Option("--enforcement-phase", help="Allowed enforcement phase."),
|
|
65
|
+
],
|
|
66
|
+
conflict_domains: Annotated[
|
|
67
|
+
list[str],
|
|
68
|
+
typer.Option("--conflict-domain", help="Conflict domain; repeat for multiple domains."),
|
|
69
|
+
],
|
|
70
|
+
surfaces: Annotated[
|
|
71
|
+
list[str],
|
|
72
|
+
typer.Option("--surface", help="Covered rule surface; repeat for multiple surfaces."),
|
|
73
|
+
],
|
|
74
|
+
source_path: Annotated[str, typer.Option("--source", help="Repository-relative source path.")],
|
|
75
|
+
required_terms: Annotated[
|
|
76
|
+
list[str],
|
|
77
|
+
typer.Option("--required-term", help="Required source anchor term; repeat for multiple terms."),
|
|
78
|
+
],
|
|
79
|
+
test_paths: Annotated[
|
|
80
|
+
list[str],
|
|
81
|
+
typer.Option("--test", help="Direct regression test path; repeat for multiple tests."),
|
|
82
|
+
],
|
|
83
|
+
protected_rule_intent: Annotated[
|
|
84
|
+
str,
|
|
85
|
+
typer.Option("--protected-rule-intent", help="Protected intent preserved by this rule."),
|
|
86
|
+
],
|
|
87
|
+
assertion_statement: Annotated[
|
|
88
|
+
str,
|
|
89
|
+
typer.Option("--assertion-statement", help="Direct coverage assertion statement."),
|
|
90
|
+
],
|
|
91
|
+
assertion_kind: Annotated[
|
|
92
|
+
str,
|
|
93
|
+
typer.Option("--assertion-kind", help="Coverage assertion kind."),
|
|
94
|
+
] = "guard",
|
|
95
|
+
project_root: Annotated[Path, typer.Option("--root", help="Project root.")] = Path("."),
|
|
96
|
+
json_output: Annotated[bool, typer.Option("--json", help="Emit machine-readable JSON.")] = False,
|
|
97
|
+
) -> None:
|
|
98
|
+
"""Add one reviewed rule mechanism with direct evidence coverage."""
|
|
99
|
+
result = register_rule_registry_entry(
|
|
100
|
+
project_root.resolve(),
|
|
101
|
+
mechanism_id=mechanism_id,
|
|
102
|
+
rule_class=rule_class,
|
|
103
|
+
owner=owner,
|
|
104
|
+
priority=priority,
|
|
105
|
+
enforcement_phase=enforcement_phase,
|
|
106
|
+
conflict_domains=conflict_domains,
|
|
107
|
+
surfaces=surfaces,
|
|
108
|
+
source_path=source_path,
|
|
109
|
+
required_terms=required_terms,
|
|
110
|
+
test_paths=test_paths,
|
|
111
|
+
protected_rule_intent=protected_rule_intent,
|
|
112
|
+
assertion_statement=assertion_statement,
|
|
113
|
+
assertion_kind=assertion_kind,
|
|
114
|
+
)
|
|
115
|
+
if json_output:
|
|
116
|
+
typer.echo(json.dumps(result, indent=2, sort_keys=True))
|
|
117
|
+
else:
|
|
118
|
+
typer.echo("RULE_REGISTRY_REGISTER")
|
|
119
|
+
typer.echo(f"STATUS={result['result_status']}")
|
|
120
|
+
typer.echo(f"CODE={result['code']}")
|
|
121
|
+
typer.echo(f"ID={result['id']}")
|
|
122
|
+
typer.echo(f"CLASS={result['class']}")
|
|
123
|
+
typer.echo(f"WRITTEN={result['written']}")
|
|
124
|
+
typer.echo(f"GATE_RELEVANT={result['gate_relevant']}")
|
|
125
|
+
note = result.get("gate_participation_note")
|
|
126
|
+
if note:
|
|
127
|
+
typer.echo(f"NOTE={note}")
|
|
128
|
+
if result.get("result_status") != "PASS":
|
|
129
|
+
raise typer.Exit(code=1)
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
import json
|
|
4
|
+
import subprocess
|
|
5
|
+
from pathlib import Path
|
|
6
|
+
from typing import Annotated
|
|
7
|
+
|
|
8
|
+
import typer
|
|
9
|
+
|
|
10
|
+
from agentic_project_kit.communication_rule_context import (
|
|
11
|
+
acknowledge_communication_refresh,
|
|
12
|
+
build_communication_rule_capsule,
|
|
13
|
+
require_current_communication_context,
|
|
14
|
+
)
|
|
15
|
+
from agentic_project_kit.rule_ack import build_rule_acknowledgement
|
|
16
|
+
from agentic_project_kit.rule_refresh import (
|
|
17
|
+
refresh_communication_rules,
|
|
18
|
+
refresh_handoff_rules,
|
|
19
|
+
render_rule_refresh_result,
|
|
20
|
+
rule_refresh_result_as_json_data,
|
|
21
|
+
)
|
|
22
|
+
from agentic_project_kit.rule_snapshot import build_derived_rule_snapshot
|
|
23
|
+
from agentic_project_kit.rule_source_validator import (
|
|
24
|
+
render_rule_source_validation,
|
|
25
|
+
validate_rule_sources,
|
|
26
|
+
)
|
|
27
|
+
|
|
28
|
+
rules_app = typer.Typer(help="Generate repo-backed rule refresh files.")
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def _run_git(project_root: Path, *args: str) -> str:
|
|
32
|
+
process = subprocess.run(
|
|
33
|
+
["git", *args],
|
|
34
|
+
cwd=project_root,
|
|
35
|
+
text=True,
|
|
36
|
+
stdout=subprocess.PIPE,
|
|
37
|
+
stderr=subprocess.PIPE,
|
|
38
|
+
check=False,
|
|
39
|
+
)
|
|
40
|
+
if process.returncode != 0:
|
|
41
|
+
return ""
|
|
42
|
+
return process.stdout.strip()
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
@rules_app.command("communication-refresh")
|
|
46
|
+
def communication_refresh(
|
|
47
|
+
project_root: Annotated[Path, typer.Option("--root")] = Path("."),
|
|
48
|
+
publish: Annotated[
|
|
49
|
+
bool,
|
|
50
|
+
typer.Option("--publish", help="Write d2 pending state and emit carrier metadata."),
|
|
51
|
+
] = False,
|
|
52
|
+
json_output: Annotated[bool, typer.Option("--json")] = False,
|
|
53
|
+
) -> None:
|
|
54
|
+
result = refresh_communication_rules(project_root)
|
|
55
|
+
capsule = build_communication_rule_capsule(
|
|
56
|
+
project_root,
|
|
57
|
+
result,
|
|
58
|
+
publish=publish,
|
|
59
|
+
write_pending=publish,
|
|
60
|
+
)
|
|
61
|
+
if json_output:
|
|
62
|
+
data = rule_refresh_result_as_json_data(result)
|
|
63
|
+
data.update(capsule.as_json_data())
|
|
64
|
+
typer.echo(json.dumps(data, indent=2, sort_keys=True))
|
|
65
|
+
else:
|
|
66
|
+
typer.echo(render_rule_refresh_result(result))
|
|
67
|
+
typer.echo(f"local_only={str(capsule.local_only).lower()}")
|
|
68
|
+
typer.echo(f"remote_readable={str(capsule.remote_readable).lower()}")
|
|
69
|
+
typer.echo(f"blob_sha={capsule.blob_sha}")
|
|
70
|
+
typer.echo(f"must_read_before_continue={str(capsule.must_read_before_continue).lower()}")
|
|
71
|
+
if capsule.pending_state_path:
|
|
72
|
+
typer.echo(f"pending_state_path={capsule.pending_state_path}")
|
|
73
|
+
typer.echo(f"next_action={capsule.next_action}")
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
@rules_app.command("handoff-refresh")
|
|
77
|
+
def handoff_refresh(
|
|
78
|
+
project_root: Annotated[Path, typer.Option("--root")] = Path("."),
|
|
79
|
+
json_output: Annotated[bool, typer.Option("--json")] = False,
|
|
80
|
+
) -> None:
|
|
81
|
+
result = refresh_handoff_rules(project_root)
|
|
82
|
+
if json_output:
|
|
83
|
+
typer.echo(json.dumps(rule_refresh_result_as_json_data(result), indent=2, sort_keys=True))
|
|
84
|
+
else:
|
|
85
|
+
typer.echo(render_rule_refresh_result(result))
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
@rules_app.command("snapshot")
|
|
89
|
+
def snapshot(
|
|
90
|
+
project_root: Annotated[Path, typer.Option("--root")] = Path("."),
|
|
91
|
+
json_output: Annotated[bool, typer.Option("--json")] = False,
|
|
92
|
+
) -> None:
|
|
93
|
+
result = build_derived_rule_snapshot(project_root)
|
|
94
|
+
if json_output:
|
|
95
|
+
typer.echo(json.dumps(result.as_json_data(), indent=2, sort_keys=True))
|
|
96
|
+
else:
|
|
97
|
+
typer.echo("RULE_SNAPSHOT")
|
|
98
|
+
typer.echo(f"schema_version={result.schema_version}")
|
|
99
|
+
typer.echo(f"snapshot_id={result.snapshot_id}")
|
|
100
|
+
typer.echo(f"sources_total={result.sources_total}")
|
|
101
|
+
typer.echo(f"is_valid={result.is_valid}")
|
|
102
|
+
typer.echo(f"fail_closed={result.fail_closed}")
|
|
103
|
+
typer.echo(f"source_digests_total={len(result.source_digests)}")
|
|
104
|
+
for reason in result.validation.blocking_reasons:
|
|
105
|
+
typer.echo(f"blocking_reason={reason}")
|
|
106
|
+
if result.fail_closed:
|
|
107
|
+
raise typer.Exit(1)
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
@rules_app.command("acknowledge")
|
|
111
|
+
def acknowledge(
|
|
112
|
+
project_root: Annotated[Path, typer.Option("--root")] = Path("."),
|
|
113
|
+
output_path: Annotated[Path, typer.Option("--output")] = Path(".agentic/rule_ack/current.json"),
|
|
114
|
+
next_allowed_action: Annotated[str, typer.Option("--next-allowed-action")] = "run_next_command",
|
|
115
|
+
json_output: Annotated[bool, typer.Option("--json")] = False,
|
|
116
|
+
) -> None:
|
|
117
|
+
root = project_root.resolve()
|
|
118
|
+
snapshot = build_derived_rule_snapshot(root)
|
|
119
|
+
if snapshot.fail_closed:
|
|
120
|
+
if json_output:
|
|
121
|
+
typer.echo(json.dumps(snapshot.as_json_data(), indent=2, sort_keys=True))
|
|
122
|
+
else:
|
|
123
|
+
typer.echo("RULE_ACKNOWLEDGEMENT")
|
|
124
|
+
typer.echo("written=False")
|
|
125
|
+
typer.echo("reason=rule_snapshot_fail_closed")
|
|
126
|
+
for reason in snapshot.validation.blocking_reasons:
|
|
127
|
+
typer.echo(f"blocking_reason={reason}")
|
|
128
|
+
raise typer.Exit(1)
|
|
129
|
+
|
|
130
|
+
repo_head = _run_git(root, "rev-parse", "--short", "HEAD") or "UNKNOWN"
|
|
131
|
+
acknowledgement = build_rule_acknowledgement(
|
|
132
|
+
snapshot,
|
|
133
|
+
repo_head=repo_head,
|
|
134
|
+
declared_next_allowed_action=next_allowed_action,
|
|
135
|
+
)
|
|
136
|
+
|
|
137
|
+
target = output_path
|
|
138
|
+
if not target.is_absolute():
|
|
139
|
+
target = root / target
|
|
140
|
+
target.parent.mkdir(parents=True, exist_ok=True)
|
|
141
|
+
target.write_text(
|
|
142
|
+
json.dumps(acknowledgement.as_json_data(), indent=2, sort_keys=True) + "\n",
|
|
143
|
+
encoding="utf-8",
|
|
144
|
+
)
|
|
145
|
+
|
|
146
|
+
relative_path = target.relative_to(root) if target.is_relative_to(root) else target
|
|
147
|
+
|
|
148
|
+
if json_output:
|
|
149
|
+
data = {
|
|
150
|
+
"path": str(relative_path),
|
|
151
|
+
"written": True,
|
|
152
|
+
"acknowledgement": acknowledgement.as_json_data(),
|
|
153
|
+
}
|
|
154
|
+
typer.echo(json.dumps(data, indent=2, sort_keys=True))
|
|
155
|
+
else:
|
|
156
|
+
typer.echo("RULE_ACKNOWLEDGEMENT")
|
|
157
|
+
typer.echo(f"path={relative_path}")
|
|
158
|
+
typer.echo("written=True")
|
|
159
|
+
typer.echo(f"schema_version={acknowledgement.schema_version}")
|
|
160
|
+
typer.echo(f"snapshot_id={acknowledgement.snapshot_id}")
|
|
161
|
+
typer.echo(f"repo_head={acknowledgement.repo_head}")
|
|
162
|
+
typer.echo(f"declared_next_allowed_action={acknowledgement.declared_next_allowed_action}")
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
@rules_app.command("acknowledge-communication-refresh")
|
|
166
|
+
def acknowledge_communication_refresh_command(
|
|
167
|
+
ack_file: Annotated[Path, typer.Option("--ack-file", help="Path to RULE_REFRESH_ACK JSON/text.")],
|
|
168
|
+
project_root: Annotated[Path, typer.Option("--root")] = Path("."),
|
|
169
|
+
json_output: Annotated[bool, typer.Option("--json")] = False,
|
|
170
|
+
) -> None:
|
|
171
|
+
result = acknowledge_communication_refresh(project_root, ack_file)
|
|
172
|
+
if json_output:
|
|
173
|
+
typer.echo(json.dumps(result.as_json_data(), indent=2, sort_keys=True))
|
|
174
|
+
else:
|
|
175
|
+
typer.echo("COMMUNICATION_RULE_REFRESH_ACK")
|
|
176
|
+
typer.echo(f"result_status={result.result_status}")
|
|
177
|
+
typer.echo(f"reason={result.reason}")
|
|
178
|
+
typer.echo(f"source={result.source or '<none>'}")
|
|
179
|
+
typer.echo(f"blob_sha={result.blob_sha or '<none>'}")
|
|
180
|
+
typer.echo(f"generated_at={result.generated_at or '<none>'}")
|
|
181
|
+
typer.echo(f"rules_loaded={str(result.rules_loaded).lower()}")
|
|
182
|
+
typer.echo(f"next_action={result.next_action}")
|
|
183
|
+
if result.result_status != "PASS":
|
|
184
|
+
raise typer.Exit(2)
|
|
185
|
+
|
|
186
|
+
|
|
187
|
+
@rules_app.command("require-current-communication-context")
|
|
188
|
+
def require_current_communication_context_command(
|
|
189
|
+
project_root: Annotated[Path, typer.Option("--root")] = Path("."),
|
|
190
|
+
json_output: Annotated[bool, typer.Option("--json")] = False,
|
|
191
|
+
) -> None:
|
|
192
|
+
result = require_current_communication_context(project_root)
|
|
193
|
+
if json_output:
|
|
194
|
+
typer.echo(json.dumps(result.as_json_data(), indent=2, sort_keys=True))
|
|
195
|
+
else:
|
|
196
|
+
typer.echo("COMMUNICATION_CONTEXT_GATE")
|
|
197
|
+
typer.echo(f"result_status={result.result_status}")
|
|
198
|
+
typer.echo(f"reason={result.reason}")
|
|
199
|
+
typer.echo(f"required_next_reply={result.required_next_reply or '<none>'}")
|
|
200
|
+
typer.echo(f"remote_path={result.remote_path}")
|
|
201
|
+
typer.echo(f"communication_context_fresh={str(result.communication_context_fresh).lower()}")
|
|
202
|
+
typer.echo(f"next_action={result.next_action}")
|
|
203
|
+
if result.result_status != "PASS":
|
|
204
|
+
raise typer.Exit(2)
|
|
205
|
+
|
|
206
|
+
|
|
207
|
+
@rules_app.command("validate-sources")
|
|
208
|
+
def validate_sources(
|
|
209
|
+
project_root: Annotated[Path, typer.Option("--root")] = Path("."),
|
|
210
|
+
json_output: Annotated[bool, typer.Option("--json")] = False,
|
|
211
|
+
) -> None:
|
|
212
|
+
result = validate_rule_sources(project_root)
|
|
213
|
+
if json_output:
|
|
214
|
+
typer.echo(json.dumps(result.as_json_data(), indent=2, sort_keys=True))
|
|
215
|
+
else:
|
|
216
|
+
typer.echo(render_rule_source_validation(result))
|
|
217
|
+
if result.fail_closed:
|
|
218
|
+
raise typer.Exit(1)
|
|
219
|
+
|
|
220
|
+
|
|
221
|
+
def register_rules_commands(app: typer.Typer) -> None:
|
|
222
|
+
app.add_typer(rules_app, name="rules")
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
from pathlib import Path
|
|
4
|
+
from typing import Annotated
|
|
5
|
+
|
|
6
|
+
import typer
|
|
7
|
+
from rich.console import Console
|
|
8
|
+
|
|
9
|
+
from agentic_project_kit.scaffold import PlanningDocSpec, planning_doc_path, write_planning_doc
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
console = Console()
|
|
13
|
+
scaffold_app = typer.Typer(help="Create governed repository scaffolding artifacts.")
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
@scaffold_app.command("planning-doc")
|
|
17
|
+
def planning_doc_command(
|
|
18
|
+
title: Annotated[str, typer.Argument(help="Planning document title")],
|
|
19
|
+
project_root: Annotated[Path, typer.Option("--root")] = Path("."),
|
|
20
|
+
status: Annotated[str, typer.Option("--status")] = "active",
|
|
21
|
+
decision_status: Annotated[str, typer.Option("--decision-status")] = "proposed",
|
|
22
|
+
scope: Annotated[str, typer.Option("--scope")] = "planning",
|
|
23
|
+
review_policy: Annotated[str, typer.Option("--review-policy")] = "review before implementation and after each milestone",
|
|
24
|
+
output: Annotated[Path | None, typer.Option("--output")] = None,
|
|
25
|
+
overwrite: Annotated[bool, typer.Option("--overwrite")] = False,
|
|
26
|
+
) -> None:
|
|
27
|
+
spec = PlanningDocSpec(
|
|
28
|
+
title=title,
|
|
29
|
+
status=status,
|
|
30
|
+
decision_status=decision_status,
|
|
31
|
+
scope=scope,
|
|
32
|
+
review_policy=review_policy,
|
|
33
|
+
)
|
|
34
|
+
root = project_root.resolve()
|
|
35
|
+
target = output.resolve() if output is not None else planning_doc_path(root, title)
|
|
36
|
+
try:
|
|
37
|
+
written = write_planning_doc(target, spec, overwrite=overwrite)
|
|
38
|
+
except FileExistsError as exc:
|
|
39
|
+
console.print(str(exc), markup=False)
|
|
40
|
+
raise typer.Exit(code=2) from exc
|
|
41
|
+
except ValueError as exc:
|
|
42
|
+
console.print(str(exc), markup=False)
|
|
43
|
+
raise typer.Exit(code=2) from exc
|
|
44
|
+
console.print("Planning document scaffolded", markup=False)
|
|
45
|
+
console.print(f"path={written}", markup=False)
|
|
46
|
+
console.print("Safety: created or updated only the requested planning document path.", markup=False)
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
from pathlib import Path
|
|
4
|
+
from typing import Annotated
|
|
5
|
+
|
|
6
|
+
import typer
|
|
7
|
+
|
|
8
|
+
from agentic_project_kit import slice_gate
|
|
9
|
+
|
|
10
|
+
slice_app = typer.Typer(help="Run temporary slice-specific governance gates.")
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
@slice_app.command("gate")
|
|
14
|
+
def gate_command(
|
|
15
|
+
kind: Annotated[str, typer.Option("--kind", help="Slice gate kind to run.")] = "planning-doc",
|
|
16
|
+
project_root: Annotated[Path, typer.Option("--root", help="Repository root.")] = Path("."),
|
|
17
|
+
) -> None:
|
|
18
|
+
report = slice_gate.run_slice_gate(kind, project_root=project_root)
|
|
19
|
+
typer.echo(slice_gate.render_slice_gate_report(report), nl=False)
|
|
20
|
+
if report.exit_code:
|
|
21
|
+
raise typer.Exit(code=report.exit_code)
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
import json
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
|
|
6
|
+
import typer
|
|
7
|
+
|
|
8
|
+
from agentic_project_kit import __version__ as PACKAGE_VERSION
|
|
9
|
+
from agentic_project_kit.standard_gates_audit_suite import (
|
|
10
|
+
evaluate_standard_gates_audit_suite,
|
|
11
|
+
render_standard_gates_audit_suite,
|
|
12
|
+
)
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
def standard_gates_audit_suite_command(
|
|
16
|
+
root: Path = typer.Option(Path("."), "--root"),
|
|
17
|
+
version: str = typer.Option(PACKAGE_VERSION, "--version"),
|
|
18
|
+
json_output: bool = typer.Option(False, "--json"),
|
|
19
|
+
) -> None:
|
|
20
|
+
"""Run the audit suite required by standard project gates."""
|
|
21
|
+
result = evaluate_standard_gates_audit_suite(root.resolve(), version=version)
|
|
22
|
+
if json_output:
|
|
23
|
+
typer.echo(json.dumps(result.as_dict(), indent=2, sort_keys=True))
|
|
24
|
+
else:
|
|
25
|
+
typer.echo(render_standard_gates_audit_suite(result), nl=False)
|
|
26
|
+
if not result.ok:
|
|
27
|
+
raise typer.Exit(code=result.returncode)
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
from pathlib import Path
|
|
4
|
+
|
|
5
|
+
import typer
|
|
6
|
+
|
|
7
|
+
from agentic_project_kit.execution_mode_state import evaluate_mode_switch, render_mode_check, write_mode_state
|
|
8
|
+
from agentic_project_kit.state_freshness import find_stale_state_fragments, format_findings
|
|
9
|
+
|
|
10
|
+
state_app = typer.Typer(help="Check repository state freshness and execution mode safety.")
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
@state_app.command("freshness-check")
|
|
14
|
+
def freshness_check() -> None:
|
|
15
|
+
findings = find_stale_state_fragments()
|
|
16
|
+
typer.echo(format_findings(findings))
|
|
17
|
+
if findings:
|
|
18
|
+
raise typer.Exit(1)
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
@state_app.command("mode-check")
|
|
22
|
+
def mode_check(
|
|
23
|
+
target: str = typer.Argument(..., help="Execution target: local or remote."),
|
|
24
|
+
expected_branch: str | None = typer.Option(None, "--expected-branch"),
|
|
25
|
+
allow_dirty: bool = typer.Option(False, "--allow-dirty", help="Allow a dirty worktree."),
|
|
26
|
+
) -> None:
|
|
27
|
+
if target not in {"local", "remote"}:
|
|
28
|
+
typer.echo("ERROR: target must be 'local' or 'remote'.")
|
|
29
|
+
raise typer.Exit(2)
|
|
30
|
+
result = evaluate_mode_switch(Path("."), target, expected_branch=expected_branch, require_clean=not allow_dirty)
|
|
31
|
+
typer.echo(render_mode_check(result))
|
|
32
|
+
if not result.ok:
|
|
33
|
+
raise typer.Exit(1)
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
@state_app.command("mode-write")
|
|
37
|
+
def mode_write(
|
|
38
|
+
target: str = typer.Argument(..., help="Execution target: local or remote."),
|
|
39
|
+
expected_branch: str | None = typer.Option(None, "--expected-branch"),
|
|
40
|
+
reason: str = typer.Option("manual_mode_transition", "--reason"),
|
|
41
|
+
allow_dirty: bool = typer.Option(False, "--allow-dirty", help="Allow a dirty worktree."),
|
|
42
|
+
) -> None:
|
|
43
|
+
if target not in {"local", "remote"}:
|
|
44
|
+
typer.echo("ERROR: target must be 'local' or 'remote'.")
|
|
45
|
+
raise typer.Exit(2)
|
|
46
|
+
result = evaluate_mode_switch(Path("."), target, expected_branch=expected_branch, require_clean=not allow_dirty)
|
|
47
|
+
path = write_mode_state(Path("."), result, reason)
|
|
48
|
+
typer.echo(render_mode_check(result))
|
|
49
|
+
typer.echo(f"state_file={path.as_posix()}")
|
|
50
|
+
if not result.ok:
|
|
51
|
+
raise typer.Exit(1)
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
import json
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
|
|
6
|
+
import typer
|
|
7
|
+
|
|
8
|
+
from agentic_project_kit.status_current_state_audit import (
|
|
9
|
+
audit_status_current_state,
|
|
10
|
+
render_status_current_state_audit,
|
|
11
|
+
)
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def audit_status_current_state_command(
|
|
15
|
+
root: Path = typer.Option(Path("."), "--root"),
|
|
16
|
+
max_origin_lag: int = typer.Option(
|
|
17
|
+
3,
|
|
18
|
+
"--max-origin-lag",
|
|
19
|
+
help="Maximum commits the validated substantive safe-state may trail origin/main.",
|
|
20
|
+
),
|
|
21
|
+
json_output: bool = typer.Option(False, "--json"),
|
|
22
|
+
) -> None:
|
|
23
|
+
"""Audit STATUS.md current-state claims against handoff, release, and origin/main state."""
|
|
24
|
+
result = audit_status_current_state(root.resolve(), max_origin_lag=max_origin_lag)
|
|
25
|
+
if json_output:
|
|
26
|
+
typer.echo(json.dumps(result.as_dict(), indent=2, sort_keys=True))
|
|
27
|
+
else:
|
|
28
|
+
typer.echo(render_status_current_state_audit(result), nl=False)
|
|
29
|
+
if not result.ok:
|
|
30
|
+
raise typer.Exit(code=result.returncode)
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
import typer
|
|
4
|
+
from rich.console import Console
|
|
5
|
+
|
|
6
|
+
from agentic_project_kit.todo import complete_item, list_items, load_todo, render_markdown
|
|
7
|
+
|
|
8
|
+
console = Console()
|
|
9
|
+
todo_app = typer.Typer(help="Manage generated project TODO items.")
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
@todo_app.command("list")
|
|
13
|
+
def todo_list(
|
|
14
|
+
all_items: bool = typer.Option(False, "--all", help="Show completed items too."),
|
|
15
|
+
) -> None:
|
|
16
|
+
"""List project TODO items from .agentic/todo.yaml."""
|
|
17
|
+
data = load_todo()
|
|
18
|
+
items = list_items(data, include_done=all_items)
|
|
19
|
+
|
|
20
|
+
if not items:
|
|
21
|
+
console.print("[green]No open TODO items.[/green]")
|
|
22
|
+
return
|
|
23
|
+
|
|
24
|
+
for item in items:
|
|
25
|
+
status = item.get("status", "open")
|
|
26
|
+
item_id = item.get("id", "UNKNOWN")
|
|
27
|
+
title = item.get("title", "")
|
|
28
|
+
owner = item.get("owner", "unknown")
|
|
29
|
+
priority = item.get("priority", "normal")
|
|
30
|
+
marker = "✓" if status == "done" else "•"
|
|
31
|
+
console.print(f"{marker} [bold]{item_id}[/bold] [{status}] {title} ({owner}, {priority})")
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
@todo_app.command("complete")
|
|
35
|
+
def todo_complete(
|
|
36
|
+
item_id: str,
|
|
37
|
+
evidence: str = typer.Option(..., "--evidence", help="Evidence for completing the item."),
|
|
38
|
+
render: bool = typer.Option(True, "--render/--no-render", help="Regenerate docs/TODO.md."),
|
|
39
|
+
) -> None:
|
|
40
|
+
"""Mark a TODO item as done and store evidence."""
|
|
41
|
+
item = complete_item(item_id, evidence=evidence)
|
|
42
|
+
console.print(f"[green]Completed TODO item:[/green] {item.get('id')}")
|
|
43
|
+
|
|
44
|
+
if render:
|
|
45
|
+
render_markdown()
|
|
46
|
+
console.print("[green]Rendered docs/TODO.md[/green]")
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
@todo_app.command("render")
|
|
50
|
+
def todo_render() -> None:
|
|
51
|
+
"""Regenerate docs/TODO.md from .agentic/todo.yaml."""
|
|
52
|
+
render_markdown()
|
|
53
|
+
console.print("[green]Rendered docs/TODO.md[/green]")
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
# ruff: noqa: F401,F403
|
|
4
|
+
|
|
5
|
+
from agentic_project_kit.cli_commands.transfer_shared import *
|
|
6
|
+
from agentic_project_kit.cli_commands.transfer_context_helpers import *
|
|
7
|
+
from agentic_project_kit.cli_commands.transfer_diagnostics import *
|
|
8
|
+
from agentic_project_kit.cli_commands.transfer_runtime_initial import *
|
|
9
|
+
from agentic_project_kit.cli_commands.transfer_repo_pre_pr import *
|
|
10
|
+
from agentic_project_kit.cli_commands.transfer_pr_merge_flow import *
|
|
11
|
+
from agentic_project_kit.cli_commands.transfer_repo_after_pr import *
|
|
12
|
+
from agentic_project_kit.cli_commands.transfer_pr_create_flow import *
|
|
13
|
+
from agentic_project_kit.cli_commands.transfer_runner_flow import *
|
|
14
|
+
from agentic_project_kit.cli_commands.transfer_order_contract import *
|
|
15
|
+
from agentic_project_kit.cli_commands.transfer_context_flow import *
|
|
16
|
+
from agentic_project_kit.cli_commands.transfer_evidence_flow import *
|
|
17
|
+
from agentic_project_kit.cli_commands.transfer_handoff_flow import *
|
|
18
|
+
|
|
19
|
+
__all__ = [name for name in globals() if not name.startswith("__")]
|