forgexa-cli 1.86.3__tar.gz → 1.87.0__tar.gz

{forgexa_cli-1.86.3 → forgexa_cli-1.87.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.86.3
+Version: 1.87.0
 Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
 Author-email: Jason Sun <dev.winds@gmail.com>
 License-Expression: MIT

{forgexa_cli-1.86.3 → forgexa_cli-1.87.0}/forgexa_cli/__init__.py

@@ -1,2 +1,2 @@
 """forgexa-cli — Forgexa command-line client."""
-__version__ = "1.86.3"
+__version__ = "1.87.0"

{forgexa_cli-1.86.3 → forgexa_cli-1.87.0}/forgexa_cli/agent_core.py

@@ -782,7 +782,15 @@ def lock_provenance_projection(path: str, source: str) -> str | None:
     }, ensure_ascii=True, sort_keys=True, separators=(",", ":"))
 
 
-def implementation_delivery_contract(node_type: str, task_input: dict, *, supported: bool, graph_type: str = "execution") -> dict | None:
+EXECUTION_DELIVERY_WARNING_CODES = frozenset({
+    "partial_delivery", "dependency_authorization", "dependency_network", "dependency_unavailable",
+    "environment_unavailable", "verification_pending", "source_evidence_limited",
+})
+
+
+def implementation_delivery_contract(node_type: str, task_input: dict, *, supported: bool, graph_type: str = "execution", protocol_version: int = 1) -> dict | None:
+    if type(protocol_version) is not int or protocol_version not in (1, 2):
+        return None
     if supported is not True or not isinstance(node_type, str) or not isinstance(graph_type, str) or node_type not in {"design", "coding", "testing", "review", "fix"} or graph_type not in {"execution", "implementation", "fix"}:
         return None
     if task_input.get("verification_work_item") or task_input.get("execution_actor") == "human":
@@ -796,7 +804,7 @@ def implementation_delivery_contract(node_type: str, task_input: dict, *, suppor
     task_id = (baseline.get("task") or {}).get("id")
     if not isinstance(task_id, str) or not task_id:
         return None
-    contract = {"version": 1, "mode": "execution_and_artifacts", "node_type": node_type, "graph_type": graph_type,
+    contract = {"version": protocol_version, "mode": "execution_and_artifacts", "node_type": node_type, "graph_type": graph_type,
                 "task_id": task_id, "baseline_fingerprint": baseline.get("fingerprint"),
                 "qa_policy": task_input.get("qa_test_level_policy_snapshot"), "change_scope": task_input.get("change_scope")}
     contract["fingerprint"] = hashlib.sha256(json.dumps(contract, sort_keys=True, ensure_ascii=True, separators=(",", ":")).encode()).hexdigest()
@@ -807,24 +815,49 @@ def uses_controlled_delivery(task_input: dict) -> bool:
     contract = task_input.get("implementation_delivery")
     if not isinstance(contract, dict):
         return False
-    expected = implementation_delivery_contract(contract.get("node_type"), task_input, supported=True, graph_type=contract.get("graph_type"))
+    expected = implementation_delivery_contract(contract.get("node_type"), task_input, supported=True,
+        graph_type=contract.get("graph_type"), protocol_version=contract.get("version"))
     return expected is not None and contract == expected
 
 
 def assess_execution_delivery(contract: dict, report: object) -> dict:
-    if not isinstance(report, dict) or type(report.get("version")) is not int or report["version"] != 1:
+    if not isinstance(report, dict) or type(report.get("version")) is not int or report["version"] not in (1, 2):
         return {"report_valid": False, "status": "unknown", "issues": ["Execution delivery declaration is missing or invalid"]}
-    if set(report) != {"version", "contract_fingerprint", "status"} or report.get("contract_fingerprint") != contract.get("fingerprint") or not isinstance(report.get("status"), str) or report["status"] not in {"complete", "partial", "blocked"}:
+    if report["version"] != contract.get("version") or report.get("contract_fingerprint") != contract.get("fingerprint") or redact_execution_delivery(report) is None:
         return {"report_valid": False, "status": "unknown", "issues": ["Execution delivery declaration does not match the current contract"]}
     return {"report_valid": True, "status": report["status"], "issues": []}
 
 
+def execution_delivery_allows_progress(contract: dict, assessment: dict) -> bool:
+    return assessment.get("report_valid") is True and (
+        assessment.get("status") == "complete" or contract.get("version") == 2 and assessment.get("status") == "partial"
+    )
+
+
+def execution_delivery_warnings(contract: dict, report: object) -> list[str]:
+    if not isinstance(report, dict) or contract.get("version") != 2 or not assess_execution_delivery(contract, report)["report_valid"]:
+        return []
+    return list(report.get("warnings") or (["partial_delivery"] if report["status"] == "partial" else []))
+
+
 def redact_execution_delivery(report: object) -> dict | None:
-    if not isinstance(report, dict):
+    if not isinstance(report, dict) or type(report.get("version")) is not int or report["version"] not in (1, 2):
+        return None
+    required = {"version", "contract_fingerprint", "status"}
+    allowed = required | ({"warnings"} if report["version"] == 2 else set())
+    if not required <= set(report) <= allowed or not isinstance(report.get("contract_fingerprint"), str) or not re.fullmatch(r"[0-9a-f]{64}", report["contract_fingerprint"]):
+        return None
+    if not isinstance(report.get("status"), str) or report["status"] not in {"complete", "partial", "blocked"}:
+        return None
+    warnings = report.get("warnings", [])
+    if not isinstance(warnings, list) or len(warnings) > len(EXECUTION_DELIVERY_WARNING_CODES) or any(
+        not isinstance(code, str) or code not in EXECUTION_DELIVERY_WARNING_CODES for code in warnings
+    ) or len(set(warnings)) != len(warnings):
         return None
-    return {"version": report.get("version") if type(report.get("version")) is int else 0,
-            "contract_fingerprint": report.get("contract_fingerprint") if isinstance(report.get("contract_fingerprint"), str) and re.fullmatch(r"[0-9a-f]{64}", report["contract_fingerprint"]) else "",
-            "status": report.get("status") if report.get("status") in ("complete", "partial", "blocked") else "unknown"}
+    redacted = {key: report[key] for key in ("version", "contract_fingerprint", "status")}
+    if "warnings" in report:
+        redacted["warnings"] = list(warnings)
+    return redacted
 
 
 def task_review_policy(node_type: str, task_input: dict, *, changed_files: list[str] | None = None, policy_supported: bool = True) -> dict:

{forgexa_cli-1.86.3 → forgexa_cli-1.87.0}/forgexa_cli/daemon.py

@@ -1234,7 +1234,7 @@ except (ImportError, ModuleNotFoundError):
 # DAEMON_VERSION is the protocol/logic version of the daemon code.
 # Kept in sync with pyproject.toml version via bump-version.sh.
 # CLIENT_TYPE identifies which packaging/distribution this daemon runs in.
-DAEMON_VERSION = "1.86.3"
+DAEMON_VERSION = "1.87.0"
 
 
 def _detect_client_type() -> str:
@@ -10223,7 +10223,7 @@ class ServerConnection:
                 "task_delivery": {"protocol_version": 1},
                 "verification_recovery": {"protocol_version": 1},
                 "task_review_policy": {"protocol_version": 1},
-                "implementation_delivery": {"protocol_version": 1},
+                "implementation_delivery": {"protocol_version": 2},
                 "recording_suggestions": {"protocol_version": 1, "isolated_workspace": True},
                 "task_attachment_staging": {"protocol_version": 1, "runtime_proxy": True, "image_agents": ["claude"]},
             },
@@ -10652,7 +10652,7 @@ class ServerConnection:
                     "task_delivery": {"protocol_version": 1},
                     "verification_recovery": {"protocol_version": 1},
                     "task_review_policy": {"protocol_version": 1},
-                    "implementation_delivery": {"protocol_version": 1},
+                    "implementation_delivery": {"protocol_version": 2},
                     "recording_suggestions": {"protocol_version": 1, "isolated_workspace": True},
                     "local_evidence": {"protocol_version": 1, "structured_summary": True},
                     "task_attachment_staging": {"protocol_version": 1, "runtime_proxy": True, "image_agents": ["claude"]},
@@ -14643,10 +14643,15 @@ class RuntimeDaemon:
             delivery = agent_core.assess_execution_delivery(input_data["implementation_delivery"], report)
             result.metrics["execution_delivery"] = agent_core.redact_execution_delivery(report)
             result.metrics["execution_delivery_valid"] = delivery["report_valid"]
+            result.metrics.pop("completion_warnings", None)
             if not delivery["report_valid"]:
                 issues.extend(_OutputValidationIssue("validation_unavailable", message) for message in delivery["issues"])
-            elif delivery["status"] != "complete":
+            elif not agent_core.execution_delivery_allows_progress(input_data["implementation_delivery"], delivery):
                 issues.append(_OutputValidationIssue("planned_task_incomplete", "Agent explicitly reported incomplete execution delivery"))
+            else:
+                warnings = agent_core.execution_delivery_warnings(input_data["implementation_delivery"], report)
+                if warnings:
+                    result.metrics["completion_warnings"] = warnings
         fix_context = input_data.get("fix_context")
         if node_type == "testing" or (
             node_type == "fix" and input_data.get("task") == "phase_remediation_fix"
@@ -16719,7 +16724,8 @@ class RuntimeDaemon:
             if (
                 agent_core.uses_controlled_delivery(task.input_data or {})
                 and result.metrics.get("execution_delivery_valid") is True
-                and (result.metrics.get("execution_delivery") or {}).get("status") in {"partial", "blocked"}
+                and not agent_core.execution_delivery_allows_progress(task.input_data["implementation_delivery"],
+                    agent_core.assess_execution_delivery(task.input_data["implementation_delivery"], result.metrics.get("execution_delivery")))
             ):
                 result.status = "failed"
                 result.failure_code = "planned_task_incomplete"

{forgexa_cli-1.86.3 → forgexa_cli-1.87.0}/forgexa_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.86.3
+Version: 1.87.0
 Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
 Author-email: Jason Sun <dev.winds@gmail.com>
 License-Expression: MIT

{forgexa_cli-1.86.3 → forgexa_cli-1.87.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "forgexa-cli"
-version = "1.86.3"
+version = "1.87.0"
 description = "Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform"
 requires-python = ">=3.9"
 license = "MIT"