plan-manager-client-dev 0.2.186__py3-none-any.whl

plan_manager_client/server_api.py

@@ -0,0 +1,427 @@
+"""Canonical plan_manager command-set and facade-completeness assertions.
+
+Author: Vasiliy Zdanovskiy
+email: vasilyvz@gmail.com
+"""
+
+from __future__ import annotations
+
+import inspect
+from typing import Iterable
+from typing import Type
+
+COMMAND_NAMES: frozenset[str] = frozenset(
+    (
+        "plan_create",
+        "plan_list",
+        "plan_status",
+        "plan_delete",
+        "plan_completed_set",
+        "plan_comment_set",
+        "plan_context_budget_set",
+        "plan_prompt_create",
+        "plan_prompt_get",
+        "plan_prompt_list",
+        "plan_prompt_update",
+        "plan_prompt_delete",
+        "attachment_create",
+        "attachment_get",
+        "attachment_list",
+        "attachment_update",
+        "attachment_delete",
+        "report_create",
+        "report_get",
+        "report_list",
+        "report_update",
+        "report_delete",
+        "plan_contract_create",
+        "plan_contract_get",
+        "plan_contract_list",
+        "plan_contract_update",
+        "plan_contract_delete",
+        "matrix_case_get",
+        "matrix_get",
+        "matrix_lint",
+        "matrix_call_upsert",
+        "matrix_call_delete",
+        "matrix_case_upsert",
+        "matrix_case_delete",
+        "matrix_export",
+        "plan_ref_check",
+        "plan_authoring_guide",
+        "plan_contract_check",
+        "plan_text_check",
+        "plan_model_mapping_set",
+        "plan_model_mapping_get",
+        "plan_project_attach",
+        "plan_export",
+        "plan_snapshot",
+        "plan_import",
+        "export_upload_save",
+        "export_read",
+        "export_archive",
+        "hrs_import",
+        "hrs_export",
+        "export_download_begin",
+        "export_cleanup",
+        "para_list",
+        "para_get",
+        "para_label_assign",
+        "para_mark_non_binding",
+        "para_insert",
+        "para_update",
+        "para_delete",
+        "para_split",
+        "hrs_fields_fill",
+        "concept_get",
+        "concept_list",
+        "concept_add",
+        "concept_update",
+        "concept_remove",
+        "relation_list",
+        "relation_get",
+        "relation_add",
+        "relation_update",
+        "relation_remove",
+        "concept_coverage",
+        "step_get",
+        "step_tree",
+        "step_create",
+        "step_update",
+        "step_move",
+        "step_delete",
+        "step_set_status",
+        "step_transition",
+        "step_runtime_get",
+        "step_runtime_report",
+        "step_runtime_list",
+        "step_list",
+        "step_search",
+        "files_report",
+        "step_xref",
+        "namespace_view",
+        "namespace_rename_suggest",
+        "namespace_rename_apply",
+        "hrs_prototype",
+        "graph_deps",
+        "graph_order",
+        "graph_parallel_map",
+        "graph_impact",
+        "execution_graph",
+        "execution_dependency_suggest",
+        "execution_dependency_apply",
+        "step_dependency_list",
+        "step_dependency_add",
+        "step_dependency_remove",
+        "step_dependency_set",
+        "step_dependency_clear",
+        "step_dependency_preview",
+        "step_dependency_apply",
+        "plan_prompt_chain",
+        "context_compile",
+        "context_common",
+        "context_specific",
+        "context_bundle",
+        "block_get",
+        "block_rebuild",
+        "block_list",
+        "branch_dump",
+        "branch_weak",
+        "branch_readiness",
+        "plan_validate",
+        "prompt_validate",
+        "run_all_checks",
+        "plan_score",
+        "plan_unfreeze",
+        "plan_version_list",
+        "plan_version_diff",
+        "plan_rollback",
+        "srt_snapshot_create",
+        "srt_snapshot_list",
+        "srt_diff",
+        "info",
+        "todo_create",
+        "todo_get",
+        "todo_list",
+        "todo_update",
+        "todo_reanchor",
+        "todo_resolve",
+        "todo_close",
+        "todo_reopen",
+        "todo_delete",
+        "todo_link_add",
+        "todo_link_remove",
+        "todo_link_get",
+        "todo_link_list",
+        "todo_link_delete",
+        "todo_queue",
+        "wish_create",
+        "wish_get",
+        "wish_list",
+        "wish_update",
+        "wish_reanchor",
+        "wish_delete",
+        "calendar_entry_create",
+        "calendar_entry_get",
+        "calendar_entry_list",
+        "calendar_entry_update",
+        "calendar_entry_reanchor",
+        "calendar_entry_delete",
+        "runtime_link_add",
+        "runtime_link_list",
+        "runtime_link_remove",
+        "runtime_link_get",
+        "runtime_link_delete",
+        "runtime_overlay_export",
+        "runtime_overlay_import",
+        "comment_add",
+        "comment_get",
+        "comment_list",
+        "comment_supersede",
+        "comment_resolve",
+        "comment_update",
+        "comment_reanchor",
+        "comment_delete",
+        "model_binding_set",
+        "model_binding_get",
+        "model_binding_list",
+        "model_binding_update",
+        "model_binding_remove",
+        "model_binding_resolve",
+        "authoring_session_create",
+        "authoring_session_get",
+        "authoring_session_list",
+        "authoring_session_update",
+        "authoring_session_delete",
+        "authoring_job_start",
+        "authoring_job_status",
+        "authoring_job_resume",
+        "authoring_job_stop",
+        "authoring_job_delete",
+        "authoring_job_get",
+        "authoring_job_update",
+        "authoring_child_list",
+        "authoring_context_read",
+        "authoring_child_write",
+        "authoring_child_start",
+        "authoring_child_status",
+        "authoring_child_wait",
+        "authoring_child_answer",
+        "authoring_step_create",
+        "authoring_step_update",
+        "authoring_step_delete",
+        "authoring_step_submit",
+        "authoring_escalate",
+        "execution_attempt_create",
+        "execution_attempt_report",
+        "execution_attempt_get",
+        "execution_attempt_list",
+        "execution_attempt_supersede",
+        "execution_attempt_delete",
+        "review_result_create",
+        "review_result_get",
+        "review_result_list",
+        "review_result_supersede",
+        "review_result_delete",
+        "escalation_create",
+        "escalation_get",
+        "escalation_list",
+        "escalation_resolve",
+        "escalation_reanchor",
+        "escalation_delete",
+        "escalation_update",
+        "escalation_policy_create",
+        "escalation_policy_get",
+        "escalation_policy_update",
+        "escalation_policy_list",
+        "escalation_policy_delete",
+        "escalation_policy_get_active",
+        "answer_envelope_create",
+        "answer_envelope_get",
+        "answer_envelope_update",
+        "answer_envelope_list",
+        "answer_envelope_delete",
+        "bug_create",
+        "bug_get",
+        "bug_list",
+        "bug_update",
+        "bug_reanchor",
+        "bug_triage",
+        "bug_confirm",
+        "bug_reject",
+        "bug_mark_duplicate",
+        "bug_reopen",
+        "bug_close",
+        "bug_delete",
+        "bug_impact_add",
+        "bug_impact_get",
+        "bug_impact_update",
+        "bug_impact_list",
+        "bug_impact_discover",
+        "bug_impact_delete",
+        "bug_fix_create",
+        "bug_fix_get",
+        "bug_fix_update",
+        "bug_fix_list",
+        "bug_fix_verify",
+        "bug_fix_delete",
+        "bug_propagation_create",
+        "bug_propagation_get",
+        "bug_propagation_list",
+        "bug_propagation_update",
+        "bug_propagation_generate_todos",
+        "bug_fix_propagation_delete",
+        "project_dependency_add",
+        "project_dependency_update",
+        "project_dependency_confirm",
+        "project_dependency_remove",
+        "project_dependency_get",
+        "project_dependency_delete",
+        "project_dependency_list",
+        "project_dependency_discover",
+        "project_dependents",
+        "project_import",
+        "project_list",
+        "project_remove",
+        "project_update",
+        "project_sync",
+        "project_view",
+        "command_catalog_dump",
+        "graph_dependents",
+        "ops_status",
+        "command_timing_stats",
+        "authoring_usage_get",
+        "step_prompt_verify",
+        "audit_list",
+        "runtime_purge_batch",
+        "garbage_find",
+        "garbage_purge",
+        "reference_inspect",
+        "id_resolve",
+        "reference_repair",
+        # CR-5a entity CRUD: tool (C-001)
+        "tool_create",
+        "tool_get",
+        "tool_update",
+        "tool_list",
+        "tool_delete",
+        # CR-5a entity CRUD: toolset (C-002) and toolset membership
+        "toolset_create",
+        "toolset_get",
+        "toolset_update",
+        "toolset_list",
+        "toolset_delete",
+        "toolset_member_add",
+        "toolset_member_remove",
+        "toolset_member_get",
+        "toolset_member_list",
+        "toolset_member_delete",
+        # CR-5a entity CRUD: role (C-003)
+        "role_create",
+        "role_get",
+        "role_update",
+        "role_list",
+        "role_delete",
+        # CR-5a entity CRUD: provider (C-004)
+        "provider_create",
+        "provider_get",
+        "provider_update",
+        "provider_list",
+        "provider_delete",
+        "provider_set_status",
+        # CR-5a entity CRUD: model (C-005)
+        "model_create",
+        "model_get",
+        "model_update",
+        "model_list",
+        "model_delete",
+        # CR-5a entity CRUD: role-model binding (C-006)
+        "role_model_binding_create",
+        "role_model_binding_get",
+        "role_model_binding_update",
+        "role_model_binding_list",
+        "role_model_binding_delete",
+        # CR-5a entity CRUD: invocation profile (C-008)
+        "invocation_profile_create",
+        "invocation_profile_get",
+        "invocation_profile_update",
+        "invocation_profile_list",
+        "invocation_profile_delete",
+        # CR-5a entity CRUD: step assignment (C-007)
+        "step_assignment_create",
+        "step_assignment_get",
+        "step_assignment_update",
+        "step_assignment_list",
+        "step_assignment_delete",
+        # CR-8 entity graph operations
+        "entity_reparent",
+        "entity_copy",
+        "entity_restore",
+        "entity_traversal",
+        # CR-5a resolve commands (C-006, C-007, C-008)
+        "role_model_resolve",
+        "step_assignment_resolve",
+        "invocation_profile_resolve",
+    )
+)
+
+from .server_api_mutating import MUTATING_COMMAND_NAMES
+
+
+def assert_facade_complete(facade_cls: Type[object]) -> None:
+    """Assert every name in COMMAND_NAMES has a public async method on facade_cls."""
+    missing = sorted(
+        name
+        for name in COMMAND_NAMES
+        if not inspect.iscoroutinefunction(getattr(facade_cls, name, None))
+    )
+    if missing:
+        raise AssertionError(
+            f"facade {facade_cls.__name__} is missing methods for: {missing}"
+        )
+
+
+# Client-side file wrappers: compositions of server commands, not commands.
+FILE_WRAPPER_NAMES = frozenset({"hrs_import_file", "hrs_export_file"})
+
+
+def assert_facade_commands_registered(facade_cls: Type[object]) -> None:
+    """Assert every public async method on facade_cls is a canonical command name or a file wrapper."""
+    orphaned = sorted(
+        name
+        for name, member in inspect.getmembers(
+            facade_cls, predicate=inspect.iscoroutinefunction
+        )
+        if not name.startswith("_")
+        and name not in COMMAND_NAMES
+        and name not in FILE_WRAPPER_NAMES
+    )
+    if orphaned:
+        raise AssertionError(
+            f"facade {facade_cls.__name__} exposes non-canonical methods: {orphaned}"
+        )
+
+
+def assert_removed_commands_absent(
+    facade_cls: Type[object], removed: Iterable[str]
+) -> None:
+    """Assert none of the given removed command names still has a facade method."""
+    lingering = sorted(
+        name
+        for name in removed
+        if inspect.iscoroutinefunction(getattr(facade_cls, name, None))
+    )
+    if lingering:
+        raise AssertionError(
+            f"facade {facade_cls.__name__} retains removed commands: {lingering}"
+        )
+
+
+__all__ = [
+    "COMMAND_NAMES",
+    "MUTATING_COMMAND_NAMES",
+    "FILE_WRAPPER_NAMES",
+    "assert_facade_complete",
+    "assert_facade_commands_registered",
+    "assert_removed_commands_absent",
+]

plan_manager_client/server_api_mutating.py

@@ -0,0 +1,105 @@
+"""Normative set of mutating plan_manager commands (split from server_api.py, R116b Part 2)."""
+
+from __future__ import annotations
+
+MUTATING_COMMAND_NAMES: frozenset[str] = frozenset(
+    (
+        "plan_create",
+        "plan_delete",
+        "matrix_lint",
+        "matrix_call_upsert",
+        "matrix_call_delete",
+        "matrix_case_upsert",
+        "matrix_case_delete",
+        "plan_completed_set",
+        "plan_comment_set",
+        "plan_context_budget_set",
+        "plan_prompt_create",
+        "plan_prompt_update",
+        "plan_prompt_delete",
+        "attachment_create",
+        "attachment_update",
+        "attachment_delete",
+        "report_create",
+        "report_update",
+        "report_delete",
+        "plan_model_mapping_set",
+        "plan_project_attach",
+        "project_import",
+        "project_remove",
+        "project_update",
+        "project_sync",
+        "plan_import",
+        "export_archive",
+        "hrs_import",
+        "export_cleanup",
+        "para_label_assign",
+        "para_mark_non_binding",
+        "para_split",
+        "hrs_fields_fill",
+        "concept_add",
+        "concept_update",
+        "concept_remove",
+        "relation_add",
+        "relation_update",
+        "relation_remove",
+        "step_create",
+        "step_update",
+        "step_move",
+        "step_delete",
+        "step_set_status",
+        "step_transition",
+        "step_dependency_add",
+        "step_dependency_remove",
+        "step_dependency_set",
+        "step_dependency_clear",
+        "step_dependency_apply",
+        "execution_dependency_apply",
+        "namespace_rename_apply",
+        "block_rebuild",
+        "plan_unfreeze",
+        "plan_rollback",
+        "bug_reanchor",
+        "todo_reanchor",
+        "wish_create",
+        "wish_update",
+        "wish_reanchor",
+        "wish_delete",
+        "calendar_entry_create",
+        "calendar_entry_update",
+        "calendar_entry_reanchor",
+        "calendar_entry_delete",
+        "escalation_reanchor",
+        "escalation_policy_create",
+        "escalation_policy_update",
+        "escalation_policy_delete",
+        "answer_envelope_create",
+        "answer_envelope_update",
+        "answer_envelope_delete",
+        "comment_reanchor",
+        "review_result_supersede",
+        "execution_attempt_supersede",
+        "role_model_binding_create",
+        "role_model_binding_update",
+        "role_model_binding_delete",
+        "entity_reparent",
+        "entity_copy",
+        "entity_restore",
+        "authoring_session_create",
+        "authoring_session_update",
+        "authoring_session_delete",
+        "authoring_job_start",
+        "authoring_job_resume",
+        "authoring_job_stop",
+        "authoring_job_delete",
+        "authoring_job_update",
+        "plan_contract_create",
+        "plan_contract_update",
+        "plan_contract_delete",
+        "authoring_step_submit",
+        "authoring_step_create",
+        "authoring_step_update",
+        "authoring_step_delete",
+        "authoring_escalate",
+    )
+)

plan_manager_client_dev-0.2.186.dist-info/METADATA

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: plan-manager-client-dev
+Version: 0.2.186
+Summary: First-class client library for the plan_manager JSON-RPC API: full command-surface facade plus export delivery module boundary.
+Requires-Python: >=3.12
+Requires-Dist: mcp-proxy-adapter==8.11.15
+Provides-Extra: ca
+Requires-Dist: code-analysis-client-dev>=1.6.352; extra == "ca"
+Provides-Extra: dev
+Requires-Dist: pytest>=9; extra == "dev"

plan_manager_client_dev-0.2.186.dist-info/RECORD

@@ -0,0 +1,37 @@
+plan_manager_client/__init__.py,sha256=iief1Rc7p_tMEfzcAxjcoG2ohlYvF1z_8gyvDtSlwNQ,316
+plan_manager_client/_version.py,sha256=OYHr3GBadQizp71-J9VJF_4it7fH3PyCllu6h7gtJbA,2234
+plan_manager_client/authoring_diagnostics.py,sha256=-60HMQvM6JYl5NxpLnVC27I7SpdeHMAtgRz6d-JpvIs,4277
+plan_manager_client/client.py,sha256=4kdXAu22TUsvV9p2AL0jh7MwomqxzWb-4QtCYy9J6QM,3530
+plan_manager_client/config.py,sha256=LT5MJ7z1MPZFc7yvXvX9zED-1coNrmrHFnqRMlU-zcE,11129
+plan_manager_client/dispatch.py,sha256=A5doik2yhjYqWNKT9wrNNwRJ7U0n7CLbciaPeQOLOds,15563
+plan_manager_client/export_fetch_chunks.py,sha256=FWpJASe9luE4bov8XRtB25f1Wd-RBdRdhOE6VKGk-rk,5911
+plan_manager_client/export_fetch_request.py,sha256=fyh40BXj6U8sSSkDYfPzy3dbKwis1yh2EOJ-ANOvfis,3340
+plan_manager_client/export_fetch_unpack.py,sha256=hqDjevmcz8cgP2TFEQyfr6ghBj_Ypg4ePD-C24fOnF8,5647
+plan_manager_client/export_fetch_verify.py,sha256=kntsIfS7cUQFx-ZmuPj1KCc0kJYF5OqAVXyvgZpO_ms,3675
+plan_manager_client/facade_agent_config_mixin.py,sha256=FaHG94yWC8T-w8DWcjMsUk3OV_Ecg8koeecAjhVNpWo,12731
+plan_manager_client/facade_bug_project_mixin.py,sha256=N_AOXMR_cA0SWyBxJ-U4gw1YkCS3RJXwkb9-i3YmVvs,10366
+plan_manager_client/facade_context_gate_mixin.py,sha256=NULdE55jdCvJPI-NoFkKEwlyvSpIBxvqGwewMt43vuQ,18212
+plan_manager_client/facade_entity_common_mixin.py,sha256=ZaIEeLhTkghvlkWAFCazpNSBOcxu56ZS46UVbQ2UFo4,1433
+plan_manager_client/facade_hrs_file_mixin.py,sha256=BmT8NiyLcSgO5PZNJO033L5__VwwplRf9yZgw3scglA,8533
+plan_manager_client/facade_plan_hrs_mixin.py,sha256=_OIngfnghLHMP7g7unwqXtAIDKWD_5OoxdyVvXZx6Mk,9933
+plan_manager_client/facade_step_graph_mixin.py,sha256=4wCxO9DeZz5m8hQAgNUt0_bsxhLt4wpa1a7hPdBHabI,8389
+plan_manager_client/id_rule.py,sha256=1hFNAUrFfFPSmZ1YbI3sEw1olc3tRp6jxJSG_QLDJaI,5894
+plan_manager_client/info_walker.py,sha256=tnrcuSeq8DEh2pRgYVPbIw2RuGMFdjn66OK99ewJg5I,5353
+plan_manager_client/scenario_runtime.py,sha256=4noQK1yAVXeWTCLTzg6SJLT6DJYcrOX0Xv1_TqPE8rM,2529
+plan_manager_client/server_api.py,sha256=wXbJsNEqs4PZst4tJwctExXkY04xH3UWWH2uxC9p7ow,12301
+plan_manager_client/server_api_mutating.py,sha256=inu8WGY743535w0PPFj5YPOZYODD2GqnIBGdHHWblzw,3044
+plan_manager_client/delivery/__init__.py,sha256=ZMiW7tKhXox2yXiwL8we9lFE0VKtCZ2NCqLfLaSky5A,929
+plan_manager_client/delivery/archive.py,sha256=OiDLNxte0LB1n9MyBAeZUA9qZDkSYiTUW2FiFeDXRM8,5126
+plan_manager_client/delivery/atomicity.py,sha256=JhDbOpl9WOvxMkSXD86V6SKpyQDVf6LLF_LB8IDmlmU,4193
+plan_manager_client/delivery/commit.py,sha256=ARR6bAmV2nk8Fq-kLmNWgG79svjVXtFMRaETmQ__X5g,4573
+plan_manager_client/delivery/destination.py,sha256=fBzbZnopa0cyaWsoqO4LjdcIYBp7obII4CS_dEDJfO0,5994
+plan_manager_client/delivery/provenance.py,sha256=ycSt7WmevIdgHWZcFG52LYA_1i1JUb1G0Ifelav5iHc,3188
+plan_manager_client/delivery/upload.py,sha256=DySIUNm39prL9mEXaa-xYg0JzYBSBNp12PYJfB8ETUY,4144
+plan_manager_client/facade_runtime_mixin/__init__.py,sha256=XxpQFCBLf2mohh-3p4u_IFwA2U0Y-wCRkxrfKcc0ViU,334
+plan_manager_client/facade_runtime_mixin/authoring_part.py,sha256=XIjRMSC48dMvbOsRYBjT7-AW9-CZNBHwBflzChioirM,22422
+plan_manager_client/facade_runtime_mixin/facade.py,sha256=pJFJti0CrFeWR-zOidpPYnuiskjDqSfYiflzKzqV6PQ,17367
+plan_manager_client/facade_runtime_mixin/overlay_part.py,sha256=okZaTGqKZvKAKNF92uzNCx-vp406zIUTlwUmYCzOM18,9451
+plan_manager_client_dev-0.2.186.dist-info/METADATA,sha256=6NBh-W1wFoLzisG9_j5lKAjwGI-2xdLNVNECDfWJ-ts,416
+plan_manager_client_dev-0.2.186.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+plan_manager_client_dev-0.2.186.dist-info/top_level.txt,sha256=l6rNTw_2wRyPxsNiBPOOApx-lzcN5gNg_79SqniArns,20
+plan_manager_client_dev-0.2.186.dist-info/RECORD,,

plan_manager_client_dev-0.2.186.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

plan_manager_client_dev-0.2.186.dist-info/top_level.txt

@@ -0,0 +1 @@
+plan_manager_client