plugin-scanner 2.0.64__tar.gz → 2.0.66__tar.gz

{plugin_scanner-2.0.64 → plugin_scanner-2.0.66}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plugin-scanner
-Version: 2.0.64
+Version: 2.0.66
 Summary: Lint, verify, and gate plugin ecosystems for maintainers, CI, and publish workflows.
 Project-URL: Homepage, https://github.com/hashgraph-online/ai-plugin-scanner
 Project-URL: Repository, https://github.com/hashgraph-online/ai-plugin-scanner

{plugin_scanner-2.0.64 → plugin_scanner-2.0.66}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "plugin-scanner"
-version = "2.0.64"
+version = "2.0.66"
 description = "Lint, verify, and gate plugin ecosystems for maintainers, CI, and publish workflows."
 readme = "README.md"
 license = "Apache-2.0"

{plugin_scanner-2.0.64 → plugin_scanner-2.0.66}/pyproject.toml.bak

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hol-guard"
-version = "2.0.64"
+version = "2.0.66"
 description = "Protect local AI harnesses with HOL Guard and run scanner checks for Codex, Claude, Cursor, Gemini, and OpenCode."
 readme = "README.md"
 license = "Apache-2.0"

{plugin_scanner-2.0.64 → plugin_scanner-2.0.66}/src/codex_plugin_scanner/guard/adapters/claude_code.py

@@ -23,7 +23,6 @@ CLAUDE_GUARD_POST_TOOL_MATCHER = f"{CLAUDE_GUARD_TOOL_MATCHER}|AskUserQuestion"
 CLAUDE_GUARD_NOTIFICATION_MATCHER = "permission_prompt"
 CLAUDE_GUARD_SESSION_START_MATCHERS = ("startup", "resume", "clear", "compact")
 CLAUDE_GUARD_TOOL_TIMEOUT_SECONDS = 30
-CLAUDE_GUARD_PROMPT_TIMEOUT_SECONDS = 20
 CLAUDE_GUARD_NOTIFICATION_TIMEOUT_SECONDS = 10
 CLAUDE_GUARD_SESSION_START_TIMEOUT_SECONDS = 10
 CLAUDE_GUARD_STOP_TIMEOUT_SECONDS = 10
@@ -47,7 +46,6 @@ def _sync_runtime_hook_groups(hooks: dict[str, object], hook_command: str) -> No
         ("PreToolUse", CLAUDE_GUARD_TOOL_MATCHER, CLAUDE_GUARD_TOOL_TIMEOUT_SECONDS),
         ("PermissionRequest", CLAUDE_GUARD_TOOL_MATCHER, CLAUDE_GUARD_NOTIFICATION_TIMEOUT_SECONDS),
         ("PostToolUse", CLAUDE_GUARD_POST_TOOL_MATCHER, CLAUDE_GUARD_TOOL_TIMEOUT_SECONDS),
-        ("UserPromptSubmit", None, CLAUDE_GUARD_PROMPT_TIMEOUT_SECONDS),
         ("Notification", CLAUDE_GUARD_NOTIFICATION_MATCHER, CLAUDE_GUARD_NOTIFICATION_TIMEOUT_SECONDS),
         ("Stop", None, CLAUDE_GUARD_STOP_TIMEOUT_SECONDS),
     ):
@@ -60,7 +58,7 @@ def _sync_runtime_hook_groups(hooks: dict[str, object], hook_command: str) -> No
 
 
 def _remove_unsupported_guard_hook_groups(hooks: dict[str, object]) -> None:
-    for key in ("PermissionDenied",):
+    for key in ("PermissionDenied", "UserPromptSubmit"):
         entries = hooks.get(key)
         if not isinstance(entries, list):
             continue

{plugin_scanner-2.0.64 → plugin_scanner-2.0.66}/src/codex_plugin_scanner/guard/cli/commands.py

@@ -311,8 +311,15 @@ def _configure_guard_parser(guard_parser: argparse.ArgumentParser) -> None:
         policy_parser.add_argument("--json", action="store_true")
         policy_parser.set_defaults(policy_action=action)
 
-    policies_parser = guard_subparsers.add_parser("policies", help="List stored Guard policy decisions")
+    policies_parser = guard_subparsers.add_parser("policies", help="List or clear stored Guard policy decisions")
+    policies_parser.add_argument("policies_command", nargs="?", choices=("clear",))
     policies_parser.add_argument("--harness")
+    policies_parser.add_argument("--source")
+    policies_parser.add_argument(
+        "--all",
+        action="store_true",
+        help="Clear decisions across every harness; cannot be combined with --harness",
+    )
     _add_guard_common_args(policies_parser)
     policies_parser.add_argument("--json", action="store_true")
 
@@ -775,6 +782,46 @@ def run_guard_command(
         return 0
 
     if args.guard_command == "policies":
+        if getattr(args, "policies_command", None) == "clear":
+            harness = getattr(args, "harness", None)
+            clear_all = bool(getattr(args, "all", False))
+            if clear_all and harness is not None:
+                _emit(
+                    "policies",
+                    {
+                        "error": "Choose either --all or --harness <name> when clearing Guard policy decisions.",
+                        "cleared": 0,
+                        "harness": harness,
+                        "source": getattr(args, "source", None),
+                    },
+                    getattr(args, "json", False),
+                )
+                return 2
+            if not clear_all and harness is None:
+                _emit(
+                    "policies",
+                    {
+                        "error": "Choose --harness <name> or --all when clearing Guard policy decisions.",
+                        "cleared": 0,
+                    },
+                    getattr(args, "json", False),
+                )
+                return 2
+            cleared = store.clear_policy_decisions(
+                None if clear_all else harness,
+                getattr(args, "source", None),
+            )
+            _emit(
+                "policies",
+                {
+                    "generated_at": _now(),
+                    "cleared": cleared,
+                    "harness": None if clear_all else harness,
+                    "source": getattr(args, "source", None),
+                },
+                getattr(args, "json", False),
+            )
+            return 0
         policy_items = store.list_policy_decisions(getattr(args, "harness", None))
         items = _filter_policy_items(policy_items, active_only=True)
         _emit("policies", {"generated_at": _now(), "items": items}, getattr(args, "json", False))
@@ -1233,10 +1280,13 @@ def run_guard_command(
             )
             return 0
         if _canonical_harness_name(args.harness) == "claude-code" and _hook_event_name(payload) == "Stop":
-            denied = _persist_claude_pending_permission_denials(store, payload)
+            discarded = _discard_claude_pending_permissions(store, payload)
             store.add_event(
                 "claude/turn_stop",
-                {"session_id": payload.get("session_id"), "saved_denials": denied},
+                {
+                    "session_id": payload.get("session_id"),
+                    "discarded_pending_permissions": discarded,
+                },
                 _now(),
             )
             return 0
@@ -1371,6 +1421,14 @@ def run_guard_command(
                         artifact=runtime_artifact,
                         artifact_hash=runtime_artifact_hash,
                     )
+                if _should_allow_claude_user_prompt_submit_without_output(
+                    args,
+                    event_name=event_name,
+                    policy_action=policy_action,
+                    artifact=runtime_artifact,
+                    output_stream=output_stream,
+                ):
+                    return 0
                 if _should_emit_copilot_hook_response(args):
                     _emit_copilot_hook_response(
                         policy_action=policy_action,
@@ -1724,6 +1782,23 @@ def _should_emit_prequeue_native_hook_response(
     return output_stream is not None
 
 
+def _should_allow_claude_user_prompt_submit_without_output(
+    args: argparse.Namespace,
+    *,
+    event_name: str,
+    policy_action: str,
+    artifact: GuardArtifact,
+    output_stream: TextIO | None,
+) -> bool:
+    return (
+        _canonical_harness_name(args.harness) == "claude-code"
+        and event_name == "UserPromptSubmit"
+        and policy_action == "require-reapproval"
+        and not _prompt_requires_hard_block(artifact)
+        and (not getattr(args, "json", False) or output_stream is not None)
+    )
+
+
 def _emit_claude_permission_request_passthrough(*, output_stream: TextIO | None = None) -> None:
     if output_stream is not None:
         output_stream.write("")
@@ -2044,6 +2119,27 @@ def _persist_claude_native_permission_for_runtime_artifact(
     return True
 
 
+def _discard_claude_pending_permissions(store: GuardStore, payload: dict[str, object]) -> int:
+    session_id = _optional_string(payload.get("session_id"))
+    if session_id is None:
+        return 0
+    index_key = _claude_pending_permission_index_key(session_id)
+    try:
+        index_payload = store.get_sync_payload(index_key)
+    except (OSError, sqlite3.Error):
+        return 0
+    if not isinstance(index_payload, list):
+        return 0
+    pending_keys = [str(item) for item in index_payload]
+    if not pending_keys:
+        return 0
+    try:
+        store.delete_sync_payloads([*pending_keys, index_key])
+    except (OSError, sqlite3.Error):
+        return 0
+    return len(pending_keys)
+
+
 def _persist_claude_pending_permission_denials(store: GuardStore, payload: dict[str, object]) -> int:
     session_id = _optional_string(payload.get("session_id"))
     if session_id is None:

{plugin_scanner-2.0.64 → plugin_scanner-2.0.66}/src/codex_plugin_scanner/guard/cli/connect_flow.py

@@ -107,36 +107,37 @@ def run_guard_connect_command(
         sync_payload = sync_receipts(store)
     except GuardSyncNotAvailableError as plan_error:
         plan_msg = str(plan_error).strip() or "Cloud sync requires a paid Guard plan."
+        pending_sync_payload = dict(runtime_sync_summary)
+        pending_sync_payload["synced_at"] = None
         pending_state = _record_connect_result(
             daemon_client=daemon_client,
             store=store,
             request_id=str(connect_request["request_id"]),
-            status="connected",
-            milestone="sync_not_available",
+            status="retry_required",
+            milestone="first_sync_failed",
             reason=plan_msg,
+            sync=pending_sync_payload,
         )
         return build_connect_payload(
             state=pending_state,
             browser_opened=browser_opened,
             connect_url=browser_url,
             sync_url=sync_url,
-            connected=True,
+            connected=False,
+            sync=pending_sync_payload,
             sync_available=False,
             sync_message=plan_msg,
         )
     except (RuntimeError, OSError, urllib.error.URLError, json.JSONDecodeError) as error:
         sync_message = str(error)
-        if runtime_sync_error and not _is_paid_plan_sync_error(sync_message):
-            sync_message = runtime_sync_error
-        sync_is_plan_limited = _is_paid_plan_sync_error(sync_message)
         pending_sync_payload = dict(runtime_sync_summary)
         pending_sync_payload["synced_at"] = None
         pending_state = _record_connect_result(
             daemon_client=daemon_client,
             store=store,
             request_id=str(connect_request["request_id"]),
-            status="connected",
-            milestone="first_sync_pending",
+            status="retry_required",
+            milestone="first_sync_failed",
             reason=sync_message,
             sync=pending_sync_payload,
         )
@@ -145,10 +146,9 @@ def run_guard_connect_command(
             browser_opened=browser_opened,
             connect_url=browser_url,
             sync_url=sync_url,
-            connected=True,
+            connected=False,
             sync=pending_sync_payload,
             sync_message=sync_message,
-            sync_available=False if sync_is_plan_limited else None,
         )
     sync_payload["runtime_session_synced_at"] = runtime_sync_summary["runtime_session_synced_at"]
     sync_payload["runtime_session_id"] = runtime_sync_summary["runtime_session_id"]

{plugin_scanner-2.0.64 → plugin_scanner-2.0.66}/src/codex_plugin_scanner/guard/cli/render.py

@@ -295,6 +295,24 @@ def _render_inventory(console: Console, payload: dict[str, object]) -> None:
 
 
 def _render_policies(console: Console, payload: dict[str, object]) -> None:
+    if "cleared" in payload or "error" in payload:
+        error = payload.get("error")
+        cleared = int(payload.get("cleared", 0) or 0)
+        scope = str(payload.get("harness") or "all harnesses")
+        source = payload.get("source")
+        body = Table.grid(padding=(0, 1))
+        body.add_row("Outcome", str(error) if error else f"cleared {cleared} decision{'s' if cleared != 1 else ''}")
+        body.add_row("Harness", scope)
+        if source:
+            body.add_row("Source", str(source))
+        console.print(
+            Panel(
+                body,
+                title="Guard policy clear",
+                border_style="red" if error else "green",
+            )
+        )
+        return
     items = _coerce_dict_list(payload.get("items"))
     console.print(
         Panel.fit(

plugin_scanner-2.0.66/src/codex_plugin_scanner/guard/edge_events.py

@@ -0,0 +1,88 @@
+"""Builders for Guard Cloud v1 events emitted by the local edge runtime."""
+
+from __future__ import annotations
+
+import hashlib
+from typing import cast
+
+from .models import GuardReceipt
+from .schemas.guard_event_v1 import GuardEventType, GuardEventV1
+
+
+def build_receipt_event(
+    receipt: GuardReceipt,
+    *,
+    device_id: str | None = None,
+    workspace_id: str | None = None,
+) -> GuardEventV1:
+    payload: dict[str, object] = {
+        "receiptId": receipt.receipt_id,
+        "harness": receipt.harness,
+        "artifactId": receipt.artifact_id,
+        "artifactHash": receipt.artifact_hash,
+        "artifactName": receipt.artifact_name,
+        "sourceScope": receipt.source_scope,
+        "policyDecision": receipt.policy_decision,
+        "capabilitiesSummary": receipt.capabilities_summary,
+        "changedCapabilities": list(receipt.changed_capabilities),
+        "provenanceSummary": receipt.provenance_summary,
+        "userOverride": receipt.user_override,
+    }
+    event_id = f"guard-event-{_fingerprint('receipt.created', receipt.receipt_id)[:32]}"
+    return GuardEventV1(
+        event_id=event_id,
+        idempotency_key=f"receipt.created:{receipt.receipt_id}",
+        event_type="receipt.created",
+        source="edge",
+        occurred_at=receipt.timestamp,
+        workspace_id=workspace_id,
+        device_id=device_id,
+        payload=payload,
+    )
+
+
+def build_approval_event(
+    *,
+    request_id: str,
+    event_type: str,
+    occurred_at: str,
+    payload: dict[str, object],
+    device_id: str | None = None,
+    workspace_id: str | None = None,
+) -> GuardEventV1:
+    if event_type not in {"approval.created", "approval.resolved"}:
+        raise ValueError("Approval event type must be approval.created or approval.resolved")
+    return GuardEventV1(
+        event_id=f"guard-event-{_fingerprint(event_type, request_id, occurred_at)[:32]}",
+        idempotency_key=f"{event_type}:{request_id}:{occurred_at}",
+        event_type=cast(GuardEventType, event_type),
+        source="approval-center",
+        occurred_at=occurred_at,
+        workspace_id=workspace_id,
+        device_id=device_id,
+        payload=payload,
+    )
+
+
+def build_policy_event(
+    *,
+    policy_key: str,
+    occurred_at: str,
+    payload: dict[str, object],
+    device_id: str | None = None,
+    workspace_id: str | None = None,
+) -> GuardEventV1:
+    return GuardEventV1(
+        event_id=f"guard-event-{_fingerprint('policy.changed', policy_key, occurred_at)[:32]}",
+        idempotency_key=f"policy.changed:{policy_key}:{occurred_at}",
+        event_type="policy.changed",
+        source="policy",
+        occurred_at=occurred_at,
+        workspace_id=workspace_id,
+        device_id=device_id,
+        payload=payload,
+    )
+
+
+def _fingerprint(*parts: str) -> str:
+    return hashlib.sha256(":".join(parts).encode()).hexdigest()

{plugin_scanner-2.0.64 → plugin_scanner-2.0.66}/src/codex_plugin_scanner/guard/runtime/__init__.py

@@ -4,6 +4,7 @@ from .runner import (
     GuardSyncNotAvailableError,
     GuardSyncNotConfiguredError,
     guard_run,
+    sync_guard_events,
     sync_receipts,
     sync_runtime_session,
 )
@@ -12,6 +13,7 @@ __all__ = [
     "GuardSyncNotAvailableError",
     "GuardSyncNotConfiguredError",
     "guard_run",
+    "sync_guard_events",
     "sync_receipts",
     "sync_runtime_session",
 ]

{plugin_scanner-2.0.64 → plugin_scanner-2.0.66}/src/codex_plugin_scanner/guard/runtime/runner.py

@@ -480,10 +480,69 @@ def sync_receipts(store: GuardStore) -> dict[str, object]:
         "inventory": 0,
         "inventory_tracked": len(inventory),
     }
+    summary["guard_events_v1"] = sync_guard_events(store)
     store.set_sync_payload("sync_summary", summary, now)
     return summary
 
 
+def sync_guard_events(store: GuardStore) -> dict[str, object]:
+    """Push pending GuardEventV1 envelopes to Guard Cloud."""
+
+    credentials = store.get_sync_credentials()
+    if credentials is None:
+        raise GuardSyncNotConfiguredError("Guard is not logged in.")
+    sync_url = _guard_events_sync_url(str(credentials["sync_url"]))
+    total_events = 0
+    total_accepted = 0
+    synced_at = _now()
+    while True:
+        pending_events = store.list_guard_events_v1(uploaded=False, limit=200)
+        if not pending_events:
+            break
+        body = json.dumps({"events": [event["payload"] for event in pending_events]}).encode("utf-8")
+        request = urllib.request.Request(
+            sync_url,
+            data=body,
+            method="POST",
+            headers=_guard_sync_headers(str(credentials["token"])),
+        )
+        try:
+            payload = _urlopen_json_with_timeout_retry(
+                request=request,
+                timeout_seconds=_SYNC_HTTP_TIMEOUT_SECONDS,
+                retry_timeout_seconds=_SYNC_HTTP_RETRY_TIMEOUT_SECONDS,
+            )
+        except urllib.error.HTTPError as error:
+            if error.code == 404:
+                summary = {
+                    "synced_at": synced_at,
+                    "events": total_events,
+                    "accepted": total_accepted,
+                    "sync_skipped": True,
+                    "sync_reason": "guard_events_endpoint_unavailable",
+                }
+                store.set_sync_payload("guard_events_v1_summary", summary, synced_at)
+                return summary
+            if error.code == 403:
+                is_plan, message = _check_plan_restriction_403(error)
+                if is_plan:
+                    raise GuardSyncNotAvailableError(message) from error
+                raise RuntimeError(message) from error
+            raise RuntimeError(_sync_http_error_message(error)) from error
+        except OSError as error:
+            raise RuntimeError(_sync_url_error_message(error)) from error
+        completed_ids = _completed_guard_event_ids(payload)
+        synced_at = _sync_timestamp(payload)
+        uploaded = store.mark_guard_events_v1_uploaded(completed_ids, synced_at)
+        total_events += len(pending_events)
+        total_accepted += uploaded
+        if uploaded == 0 or len(pending_events) < 200:
+            break
+    summary = {"synced_at": synced_at, "events": total_events, "accepted": total_accepted}
+    store.set_sync_payload("guard_events_v1_summary", summary, synced_at)
+    return summary
+
+
 def sync_runtime_session(
     store: GuardStore,
     *,
@@ -951,6 +1010,45 @@ def _normalized_runtime_sessions_sync_url(sync_url: str) -> str:
     )
 
 
+def _guard_events_sync_url(sync_url: str) -> str:
+    parsed = urllib.parse.urlsplit(_normalized_receipts_sync_url(sync_url))
+    if parsed.path.rstrip("/").endswith("/api/v1/guard/events"):
+        return urllib.parse.urlunsplit((parsed.scheme, parsed.netloc, parsed.path.rstrip("/"), parsed.query, ""))
+    path = parsed.path.rstrip("/")
+    for suffix in (
+        "/api/guard/receipts/sync",
+        "/guard/receipts/sync",
+        "/registry/api/v1/guard/receipts/sync",
+    ):
+        if path.endswith(suffix):
+            path = path[: -len(suffix)]
+            break
+    return urllib.parse.urlunsplit(
+        (
+            parsed.scheme,
+            parsed.netloc,
+            path.rstrip("/") + "/api/v1/guard/events",
+            parsed.query,
+            "",
+        )
+    )
+
+
+def _completed_guard_event_ids(payload: dict[str, object]) -> list[str]:
+    statuses = payload.get("statuses")
+    if not isinstance(statuses, list):
+        return []
+    completed: list[str] = []
+    for item in statuses:
+        if not isinstance(item, dict):
+            continue
+        status = str(item.get("status") or "")
+        event_id = item.get("eventId")
+        if status in {"accepted", "duplicate", "rejected"} and isinstance(event_id, str):
+            completed.append(event_id)
+    return completed
+
+
 def _cloud_sync_receipts_payload(store: GuardStore, receipts: list[dict[str, object]]) -> list[dict[str, object]]:
     device_id, device_name = _guard_device_metadata(store)
     return [_cloud_sync_receipt_payload(receipt, device_id=device_id, device_name=device_name) for receipt in receipts]

plugin_scanner-2.0.66/src/codex_plugin_scanner/guard/schemas/guard_event_v1.py

@@ -0,0 +1,74 @@
+"""Guard Cloud event schema shared by the edge runtime and v1 ingest API."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Literal, cast
+
+GuardEventSource = Literal["edge", "approval-center", "policy", "protect-api"]
+GuardEventType = Literal["receipt.created", "approval.created", "approval.resolved", "policy.changed"]
+
+
+@dataclass(frozen=True, slots=True)
+class GuardEventV1:
+    """Versioned event envelope for replay-safe Guard Cloud sync."""
+
+    event_id: str
+    idempotency_key: str
+    event_type: GuardEventType
+    source: GuardEventSource
+    occurred_at: str
+    workspace_id: str | None = None
+    device_id: str | None = None
+    payload: dict[str, object] = field(default_factory=dict)
+    schema_version: str = "guard.event.v1"
+
+    def to_dict(self) -> dict[str, object]:
+        return {
+            "schemaVersion": self.schema_version,
+            "eventId": self.event_id,
+            "idempotencyKey": self.idempotency_key,
+            "eventType": self.event_type,
+            "source": self.source,
+            "occurredAt": self.occurred_at,
+            "workspaceId": self.workspace_id,
+            "deviceId": self.device_id,
+            "payload": self.payload,
+        }
+
+    @classmethod
+    def from_dict(cls, payload: dict[str, object]) -> GuardEventV1:
+        schema_version = str(payload.get("schemaVersion") or "")
+        if schema_version != "guard.event.v1":
+            raise ValueError("Guard event schemaVersion must be guard.event.v1")
+        event_id = _required_string(payload, "eventId")
+        idempotency_key = _required_string(payload, "idempotencyKey")
+        event_type = _required_string(payload, "eventType")
+        source = _required_string(payload, "source")
+        occurred_at = _required_string(payload, "occurredAt")
+        event_payload = payload.get("payload")
+        if not isinstance(event_payload, dict):
+            raise ValueError("Guard event payload must be an object")
+        if event_type not in {"receipt.created", "approval.created", "approval.resolved", "policy.changed"}:
+            raise ValueError(f"Unsupported Guard event type: {event_type}")
+        if source not in {"edge", "approval-center", "policy", "protect-api"}:
+            raise ValueError(f"Unsupported Guard event source: {source}")
+        workspace_id = payload.get("workspaceId")
+        device_id = payload.get("deviceId")
+        return cls(
+            event_id=event_id,
+            idempotency_key=idempotency_key,
+            event_type=cast(GuardEventType, event_type),
+            source=cast(GuardEventSource, source),
+            occurred_at=occurred_at,
+            workspace_id=workspace_id if isinstance(workspace_id, str) else None,
+            device_id=device_id if isinstance(device_id, str) else None,
+            payload={str(key): value for key, value in event_payload.items()},
+        )
+
+
+def _required_string(payload: dict[str, object], key: str) -> str:
+    value = payload.get(key)
+    if not isinstance(value, str) or not value.strip():
+        raise ValueError(f"Guard event {key} must be a non-empty string")
+    return value