chore: update GitHub org from agentralabs to agentra-commerce

Author: omoshola-o

.github/ISSUE_TEMPLATE/edge-case.md

@@ -0,0 +1,62 @@
+name: Edge Case Report
+description: Report a protocol edge case or unexpected scenario
+title: "[Edge Case] "
+labels: ["edge-case"]
+body:
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      options:
+        - negotiation
+        - settlement
+        - receipt
+        - verity
+        - discovery
+        - identity
+        - adapter
+        - cross-cutting
+    validations:
+      required: true
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      options:
+        - S1 - Critical (financial loss or data corruption)
+        - S2 - High (incorrect settlement or broken invariant)
+        - S3 - Medium (degraded experience or incorrect state)
+        - S4 - Low (cosmetic or unlikely)
+    validations:
+      required: true
+  - type: textarea
+    id: scenario
+    attributes:
+      label: Scenario
+      description: What happens? Be specific about the sequence of events.
+      placeholder: "Agent A sends an offer, Agent B accepts, but the offer has already expired..."
+    validations:
+      required: true
+  - type: textarea
+    id: risk
+    attributes:
+      label: Risk
+      description: What goes wrong if this is not handled?
+      placeholder: "Funds could be locked permanently without resolution..."
+    validations:
+      required: true
+  - type: textarea
+    id: proposed_resolution
+    attributes:
+      label: Proposed Resolution
+      description: How should the protocol handle this?
+    validations:
+      required: false
+  - type: input
+    id: schema
+    attributes:
+      label: Affected Schema(s)
+      description: Which schema(s) are affected?
+      placeholder: "settlement-intent, execution-receipt"
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/edge-case.yml

@@ -27,14 +27,27 @@ XAP is a protocol. Changing a field name or adding a required property can break
 
 ### 4. Edge Case Submissions
 
-Edge cases are especially valuable. Every edge case found before v1.0 prevents a breaking change later.
-
-When submitting an edge case, include:
-
-- **Category**: Negotiation, Settlement, Split, Identity, Time, Adapter, Security, or Verity
-- **Severity**: S1 (funds at risk), S2 (incorrect behavior), S3 (unexpected but workable), S4 (inconvenient)
-- **Description**: What happens, step by step
-- **Expected behavior**: What should happen
+Edge cases are tracked in `docs/edge-cases.md` with a formal lifecycle:
+
+1. **DISCOVERED** — identified during development, testing, or community feedback
+2. **DOCUMENTED** — added to edge-cases.md with scenario, risk, and proposed resolution
+3. **ANALYZED** — resolution validated against protocol invariants
+4. **RESOLVED** — resolution implemented in schemas, SDK, or engine
+5. **TESTED** — validation test covers this edge case
+6. **DEPLOYED** — fix is in a released version
+
+To submit an edge case, open an issue using the Edge Case template.
+
+Severity guide:
+- **S1 (Critical):** Could cause financial loss or data corruption
+- **S2 (High):** Could cause incorrect settlement or broken invariant
+- **S3 (Medium):** Could cause degraded experience or incorrect state
+- **S4 (Low):** Cosmetic or unlikely scenario
+
+When submitting, include:
+- **Category**: negotiation, settlement, receipt, verity, discovery, identity, adapter, or cross-cutting
+- **Scenario**: What happens, step by step
+- **Risk**: What goes wrong if unhandled
 - **Proposed resolution**: Your suggestion (optional but appreciated)
 
 ### What We Are Not Looking For Right Now

CONTRIBUTING.md

@@ -130,7 +130,7 @@ An agent evaluating a potential counterparty reads its `AgentIdentity` and sees:
 +------------------------v-------------------------+
 |               Verity Truth Engine                |
 |          (open source, Rust, MIT)                |
-|    github.com/agentralabs/verity-engine          |
+|    github.com/agentra-commerce/verity-engine          |
 +------------------------+-------------------------+
                          |
 +------------------------v-------------------------+
@@ -368,7 +368,7 @@ Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR.
   author = {Agentra Labs},
   year   = {2026},
   doi    = {10.5281/zenodo.18944370},
-  url    = {https://github.com/agentralabs/xap-protocol}
+  url    = {https://github.com/agentra-commerce/xap-protocol}
 }
 ```
 

README.md

@@ -3,7 +3,8 @@
 from __future__ import annotations
 
 import secrets
-from dataclasses import dataclass
+import threading
+from dataclasses import dataclass, field
 from hashlib import sha256
 from typing import Any, ClassVar
 
@@ -15,9 +16,36 @@ def _generate_receipt_id() -> str:
     return f"rcpt_{secrets.token_hex(4)}"
 
 
-# Global chain position counter (per-engine, monotonically increasing)
-_chain_position_counter: int = 0
-_last_receipt_hash: str = ""
+class ReceiptChain:
+    """Thread-safe receipt chain state.
+
+    Each instance tracks its own chain position counter and last receipt hash,
+    eliminating the previous global mutable state that was unsafe in
+    multi-worker environments.
+    """
+
+    def __init__(self) -> None:
+        self._lock = threading.Lock()
+        self._chain_position_counter: int = 0
+        self._last_receipt_hash: str = ""
+
+    def advance(self) -> tuple[int, str]:
+        """Atomically increment chain position and return (position, previous_hash)."""
+        with self._lock:
+            self._chain_position_counter += 1
+            position = self._chain_position_counter
+            previous_hash = self._last_receipt_hash
+            return position, previous_hash
+
+    def set_last_hash(self, receipt_hash: str) -> None:
+        """Update the last receipt hash after computing it."""
+        with self._lock:
+            self._last_receipt_hash = receipt_hash
+
+
+# Default chain instance (per-process). For multi-worker deployments,
+# each worker gets its own ReceiptChain instance automatically.
+_default_chain = ReceiptChain()
 
 
 @dataclass
@@ -32,8 +60,14 @@ def receipt_id(self) -> str:
         return self._data["receipt_id"]
 
     @classmethod
-    def issue(cls, settlement: Any, platform_private_key: str) -> "ExecutionReceipt":
-        global _chain_position_counter, _last_receipt_hash
+    def issue(
+        cls,
+        settlement: Any,
+        platform_private_key: str,
+        chain: ReceiptChain | None = None,
+    ) -> "ExecutionReceipt":
+        if chain is None:
+            chain = _default_chain
 
         settlement_data = settlement.to_dict() if hasattr(settlement, "to_dict") else deep_copy(settlement)
 
@@ -139,7 +173,7 @@ def issue(cls, settlement: Any, platform_private_key: str) -> "ExecutionReceipt"
                 "dispute_filed": state == "DISPUTED",
             }
             if quality_score:
-                impact["quality_score_recorded_bps"] = int(quality_score * 10000)
+                impact["quality_score_recorded_bps"] = round(quality_score * 10000)
             reputation_impacts.append(impact)
 
         reputation_impacts.append({
@@ -153,9 +187,8 @@ def issue(cls, settlement: Any, platform_private_key: str) -> "ExecutionReceipt"
         # Verity hash (placeholder — real implementation links to Verity engine)
         verity_hash = f"sha256:{sha256(canonical_json_bytes(settlement_data)).hexdigest()}"
 
-        # Chain
-        _chain_position_counter += 1
-        chain_position = _chain_position_counter
+        # Chain (thread-safe via ReceiptChain instance)
+        chain_position, previous_hash = chain.advance()
 
         receipt_data: dict[str, Any] = {
             "receipt_id": _generate_receipt_id(),
@@ -183,12 +216,12 @@ def issue(cls, settlement: Any, platform_private_key: str) -> "ExecutionReceipt"
             },
         }
 
-        if _last_receipt_hash:
-            receipt_data["chain_previous_hash"] = f"sha256:{_last_receipt_hash}"
+        if previous_hash:
+            receipt_data["chain_previous_hash"] = f"sha256:{previous_hash}"
 
         # Compute receipt hash for chain continuity
         receipt_hash = sha256(canonical_json_bytes(receipt_data)).hexdigest()
-        _last_receipt_hash = receipt_hash
+        chain.set_last_hash(receipt_hash)
 
         validate_against_schema(cls.SCHEMA, receipt_data)
         obj = cls(receipt_data)

xap/receipt.py

@@ -73,7 +73,7 @@ def create(cls, negotiation: Any, idempotency_key: str | None = None) -> "Settle
             total_amount = negotiation_data["pricing"]["amount_minor_units"]
             currency = negotiation_data["pricing"]["currency"]
         else:
-            total_amount = int(negotiation_data["offer"]["offered_rate"] * 100)
+            total_amount = round(negotiation_data["offer"]["offered_rate"] * 100)
             currency = negotiation_data["offer"].get("settlement_unit", "USD")
 
         # Build conditions from SLA
@@ -310,7 +310,7 @@ def _evaluate_condition(self, cond: dict[str, Any], result: dict[str, Any]) -> b
             # Map check to result field
             check = cond.get("check", "")
             if check == "quality_score":
-                actual = int(result.get("quality_score", 0) * 10000)
+                actual = round(result.get("quality_score", 0) * 10000)
             elif check == "latency_ms":
                 actual = result.get("latency_ms", 0)
             else: