plan-manager-client 0.2.152__tar.gz → 0.2.154__tar.gz

{plan_manager_client-0.2.152 → plan_manager_client-0.2.154}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: plan-manager-client
-Version: 0.2.152
+Version: 0.2.154
 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.3
+Requires-Dist: mcp-proxy-adapter==8.11.9
 Provides-Extra: ca
 Requires-Dist: code-analysis-client>=1.6.111; extra == "ca"
 Provides-Extra: dev

{plan_manager_client-0.2.152 → plan_manager_client-0.2.154}/plan_manager_client/dispatch.py

@@ -16,6 +16,7 @@ from plan_manager_client.authoring_diagnostics import (
     emit as emit_authoring_diagnostic,
     new_correlation_id,
 )
+from plan_manager_client.id_rule import InvalidIdentifierError, check_call_ids
 
 
 def _adapter_validation_error_result(status: object) -> dict[str, Any] | None:
@@ -289,6 +290,11 @@ class _CommandDispatchMixin:
         wait remains bounded by the caller-selected budget. Returns the "result"
         value from the unified response for both immediate and queued commands.
         """
+        try:
+            check_call_ids(params)  # uuid4 discipline (block 2, D7): an invalid identifier is refused before the call is sent
+        except InvalidIdentifierError as refusal:
+            # The refusal is the command's own answer (-32602, violation value), never an exception out of the facade (0153 GI2).
+            return refusal.as_answer()
         diagnostic = command in AUTHORING_DIAGNOSTIC_COMMANDS
         correlation_id = new_correlation_id() if diagnostic else ""
         if diagnostic:

{plan_manager_client-0.2.152 → plan_manager_client-0.2.154}/plan_manager_client/facade_runtime_mixin/authoring_part.py

@@ -117,9 +117,14 @@ class RuntimeAuthoringPart:
             {"plan": plan, "step": step, "session_id": session_id},
         )
 
-    async def authoring_job_delete(self, job_id: str) -> Any:
-        """Delete transient context for one terminal authoring job."""
-        return await self._call("authoring_job_delete", {"job_id": job_id})
+    async def authoring_job_delete(self, job_id: str, hard: bool = False, recursive: bool = False) -> Any:
+        """Soft-delete (mark) one terminal authoring job; hard=True removes an already marked job (server default: false)."""
+        params: dict[str, Any] = {"job_id": job_id}
+        if hard:
+            params["hard"] = True
+        if recursive:
+            params["recursive"] = True
+        return await self._call("authoring_job_delete", params)
 
     async def authoring_child_list(self, step: str, plan: str | None = None) -> Any:
         """List the direct planned children of the step ``step`` (its id, a uuid4, or with ``plan`` its path)."""

{plan_manager_client-0.2.152 → plan_manager_client-0.2.154}/plan_manager_client/facade_runtime_mixin/facade.py

@@ -212,8 +212,8 @@ class RuntimeCommandsMixin:
             plan, step, session_id
         )
 
-    async def authoring_job_delete(self, job_id: str) -> Any:
-        return await self.runtimeAuthoringPart.authoring_job_delete(job_id)
+    async def authoring_job_delete(self, job_id: str, hard: bool = False, recursive: bool = False) -> Any:
+        return await self.runtimeAuthoringPart.authoring_job_delete(job_id, hard=hard, recursive=recursive)
 
     async def authoring_child_list(self, step: str, plan: str | None = None) -> Any:
         return await self.runtimeAuthoringPart.authoring_child_list(step, plan=plan)

plan_manager_client-0.2.154/plan_manager_client/id_rule.py

@@ -0,0 +1,104 @@
+"""Client-side check of the identifier rule D1 (uuid4 discipline, block 2, D7; TODO 93bc1adc-755b-461c-8f1e-20e51b3c0b25).
+
+The client is a separate wheel, so the rule is a copy of ``plan_manager.storage.id_rule``: an identifier is canonical
+8-4-4-4-12 text, version 4 (RFC 4122 variant), not nil, and has no run of eight or more '0' hex digits (hyphens ignored).
+``check_call_ids`` runs in the facade before every call: a value of a parameter named in ``UUID_PARAMETER_NAMES`` (the
+server's ``format: uuid`` parameters) that fails the rule is refused locally with the server's own answer shape
+(-32602, violation ``value``, the parameter as field, the exact value). The server stays the authority.
+
+Free-text identifiers are not in the table and are not checked: they are not uuids of this project (request, session and
+call ids, provider request ids, uuid7 evidence ids, idempotency keys, sha256 hashes, dialogue and transcript references,
+the server id of a tool). ``plan`` takes a name or an id: only a value of the id shape is checked (``ID_OR_NAME_PARAMETERS``).
+"""
+
+from __future__ import annotations
+
+import re
+import uuid
+from typing import Any
+
+_ZERO_RUN = re.compile(r"0{8}")
+_CANONICAL = re.compile(r"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$")
+EXPECTED = "a valid identifier: uuid4, not nil, without a run of eight zeros"
+
+ID_OR_NAME_PARAMETERS: frozenset[str] = frozenset({"plan"})
+
+UUID_PARAMETER_NAMES: frozenset[str] = frozenset({
+    "anchor_plan", "anchor_plan_uuid", "anchor_project_id", "anchor_ref_id", "anchor_revision_uuid", "assignment_uuid",
+    "attempt_id", "binding_uuid", "bug", "bug_fix", "bug_id", "calendar_entry", "comment", "comment_uuid", "dependency_uuid",
+    "duplicate_of_uuid", "entity_id", "entity_ids", "entity_uuid", "envelope_uuid", "escalation_uuid", "from_entity_uuid",
+    "from_todo", "identifiers", "impact_uuid", "link", "linked_plan_uuid", "membership_uuid", "model_uuid",
+    "new_anchor_plan_uuid", "new_anchor_project_id", "new_anchor_ref_id", "new_anchor_revision_uuid", "new_owner_id",
+    "new_source_plan_uuid", "new_source_project_id", "new_source_ref_id", "new_source_revision_uuid", "parent_bug_uuid",
+    "policy_uuid", "profile_uuid", "project", "propagation_id", "provider_uuid", "review_uuid", "revision", "role_uuid",
+    "source_plan_uuid", "source_project_id", "source_ref", "source_ref_id", "source_revision_uuid", "supersedes_comment_uuid",
+    "target_plan_uuid", "target_project_id", "target_ref_id", "target_revision_uuid", "to_entity_uuid", "to_todo", "todo",
+    "tool_uuid", "toolset_uuid", "wish",
+})
+"""The parameters the server declares ``format: uuid`` (every command of the live catalog, generated from the schemas)."""
+
+
+class InvalidIdentifierError(ValueError):
+    """A client-side refusal of an identifier value: the server's -32602 / violation value shape, before the call."""
+
+    code = -32602
+    violation = "value"
+
+    def __init__(self, field: str, value: Any, defect: str) -> None:
+        self.field = field
+        self.value = value
+        super().__init__(
+            f"parameter {field!r} must be {EXPECTED}, got {value!r} ({defect})"
+        )
+
+    def as_answer(self) -> dict[str, Any]:
+        """The server's -32602 ErrorResult for this refusal: the answer a command gives, not an exception."""
+        return {
+            "success": False,
+            "error": {
+                "code": self.code,
+                "message": str(self),
+                "data": {"field": self.field, "violation": self.violation, "expected": EXPECTED, "got": self.value},
+            },
+        }
+
+
+def id_defect(value: Any) -> str | None:
+    """Why ``value`` is not a valid identifier, or None when it is one (the rule D1 of the server)."""
+    if isinstance(value, uuid.UUID):
+        candidate = value
+    else:
+        try:
+            candidate = uuid.UUID(str(value))
+        except (AttributeError, TypeError, ValueError):
+            return f"invalid uuid: {value!r}"
+    if candidate.int == 0:
+        return f"nil uuid: {candidate}"
+    if candidate.version != 4:
+        return f"not version 4: {candidate}"
+    if _ZERO_RUN.search(candidate.hex):
+        return f"a run of eight zeros: {candidate}"
+    return None
+
+
+def _is_id_shape(value: Any) -> bool:
+    return isinstance(value, str) and _CANONICAL.match(value) is not None
+
+
+def check_call_ids(params: dict[str, Any] | None) -> None:
+    """Refuse locally every identifier value of a call that fails rule D1 (see the module docstring).
+
+    Raises InvalidIdentifierError naming the parameter and the exact value. Nothing is sent when it raises.
+    """
+    for name, value in (params or {}).items():
+        if name in UUID_PARAMETER_NAMES:
+            values = value if isinstance(value, list) else [value]
+            for item in values:
+                if isinstance(item, str):
+                    defect = id_defect(item)
+                    if defect is not None:
+                        raise InvalidIdentifierError(name, item, defect)
+        elif name in ID_OR_NAME_PARAMETERS and _is_id_shape(value):
+            defect = id_defect(value)
+            if defect is not None:
+                raise InvalidIdentifierError(name, value, defect)

{plan_manager_client-0.2.152 → plan_manager_client-0.2.154}/plan_manager_client.egg-info/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: plan-manager-client
-Version: 0.2.152
+Version: 0.2.154
 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.3
+Requires-Dist: mcp-proxy-adapter==8.11.9
 Provides-Extra: ca
 Requires-Dist: code-analysis-client>=1.6.111; extra == "ca"
 Provides-Extra: dev

{plan_manager_client-0.2.152 → plan_manager_client-0.2.154}/plan_manager_client.egg-info/SOURCES.txt

@@ -16,6 +16,7 @@ plan_manager_client/facade_entity_common_mixin.py
 plan_manager_client/facade_hrs_file_mixin.py
 plan_manager_client/facade_plan_hrs_mixin.py
 plan_manager_client/facade_step_graph_mixin.py
+plan_manager_client/id_rule.py
 plan_manager_client/info_walker.py
 plan_manager_client/scenario_runtime.py
 plan_manager_client/server_api.py

{plan_manager_client-0.2.152 → plan_manager_client-0.2.154}/plan_manager_client.egg-info/requires.txt

@@ -1,4 +1,4 @@
-mcp-proxy-adapter==8.11.3
+mcp-proxy-adapter==8.11.9
 
 [ca]
 code-analysis-client>=1.6.111

{plan_manager_client-0.2.152 → plan_manager_client-0.2.154}/pyproject.toml

@@ -8,7 +8,7 @@ dynamic = ["version"]
 description = "First-class client library for the plan_manager JSON-RPC API: full command-surface facade plus export delivery module boundary."
 requires-python = ">=3.12"
 dependencies = [
-    "mcp-proxy-adapter==8.11.3",
+    "mcp-proxy-adapter==8.11.9",
 ]
 
 [project.optional-dependencies]