hypermind 2.0.0__tar.gz → 2.0.2__tar.gz

{hypermind-2.0.0 → hypermind-2.0.2}/.github/workflows/release.yml

@@ -84,7 +84,7 @@ jobs:
   rust-hmctl:
     name: build hmctl (${{ matrix.target }})
     needs: guard-source-branch
-    if: startsWith(github.ref, 'refs/tags/v')
+    if: false  # ponytail: skipped for patch releases; restore when Rust hmctl ships
     strategy:
       fail-fast: false
       matrix:
@@ -134,7 +134,7 @@ jobs:
     name: cosign keyless sign
     runs-on: ubuntu-latest
     needs: build
-    if: startsWith(github.ref, 'refs/tags/v')
+    if: false  # ponytail: skipped for patch releases; restore for full audit releases
     permissions:
       id-token: write
       contents: read
@@ -180,7 +180,7 @@ jobs:
     name: GitHub release
     runs-on: ubuntu-latest
     needs: [cosign, publish-pypi, rust-hmctl]
-    if: startsWith(github.ref, 'refs/tags/v')
+    if: false  # ponytail: skipped for patch releases; needs rust-hmctl + cosign artifacts
     permissions:
       contents: write
     steps:

{hypermind-2.0.0 → hypermind-2.0.2}/.gitignore

@@ -151,8 +151,9 @@ experiments/
 # mkdocs build output
 site/
 
-# Local MCP config (may contain secrets — edit deploy/mcp.example.toml instead)
+# Local MCP config (may contain real tokens — setup.sh writes these from user input)
 config/mcp.toml
+config/mcp.json
 
 # -----------------------------------------------------------------------------
 # Rust port (rust/) — build artefacts only; Cargo.lock IS committed (workspace

{hypermind-2.0.0 → hypermind-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypermind
-Version: 2.0.0
+Version: 2.0.2
 Summary: Federated agent intelligence — reference SDK for the HyperMind SCITT contested-claims profile
 Project-URL: Homepage, https://github.com/ZySec-AI/hypermind
 Project-URL: Documentation, https://github.com/ZySec-AI/hypermind/tree/main/docs
@@ -30,7 +30,7 @@ Requires-Dist: pydantic>=2.6
 Requires-Dist: pymerkle>=6.1
 Requires-Dist: pynacl>=1.6.2
 Requires-Dist: quantcrypt>=1.0
-Requires-Dist: relata-sdk>=0.2
+Requires-Dist: relata-sdk>=0.3.4
 Requires-Dist: rich>=13.7
 Requires-Dist: structlog>=24.1
 Provides-Extra: anthropic

{hypermind-2.0.0 → hypermind-2.0.2}/deploy/standalone/docker-compose.yml

@@ -19,7 +19,7 @@ services:
     environment:
       RELATA_PROFILE: free
       RELATA_HTTP_BIND: "0.0.0.0:9090"
-      RELATA_DATA_DIR: /tmp/relata
+      RELATA_DATA_DIR: /data/relata
       RELATA_BEARER_TOKEN: ${RELATA_TOKEN}
       RELATA_ADMIN_TOKEN: ${RELATA_TOKEN}
       RELATA_PURPOSES: analytics,operations,security_incident,compliance_review,audit,intops,intelligence,agent-notes,gdpr-erasure,hm_ledger,hm_kernel,agent_notes
@@ -27,12 +27,14 @@ services:
       RELATA_STORE_MAX_RAM_MB: "4096"
       RELATA_ENCRYPTION_AT_REST: "false"
       RELATA_PLAINTEXT_OK: "true"
+      RELATA_ACL_GRANT: "HmClaim:read+write,HmDispute:read+write,HmReputation:read+write,HmTranscript:read+write,HmSkill:read+write"
+      RELATA_OTLP_ENDPOINT: ${OTEL_EXPORTER_OTLP_ENDPOINT:-}
     healthcheck:
       test: ["CMD", "curl", "-sf", "http://localhost:9090/health"]
       interval: 10s
       timeout: 5s
       retries: 12
-      start_period: 20s
+      start_period: 60s
 
   # ── HyperMind MCP server ───────────────────────────────────────────────────
   hypermind-engine:
@@ -51,15 +53,15 @@ services:
     volumes:
       - ./config/mcp.toml:/config/mcp.toml:ro
       - ./config/mcp.json:/config/mcp.json:ro
-      - ./.data/hypermind:/data              # persists /data/env across restarts
+      - ./.data/hypermind:/data              # persists /data/env + kernel/ledger across restarts
     environment:
+      # Docker-internal routing — differs from localhost, so kept here not in env file
       RELATA_URL: http://relatadb:9090
       RELATA_TOKEN: ${RELATA_TOKEN}
       RELATA_BEARER_TOKEN: ${RELATA_TOKEN}
       HYPERMIND_MCP_CONFIG: /config/mcp.json
-      OPENAI_API_KEY: ${OPENAI_API_KEY}
-      OPENAI_BASE_URL: ${OPENAI_BASE_URL}
-      HYPERMIND_LLM_MODEL: ${HYPERMIND_LLM_MODEL}
+      OTEL_EXPORTER_OTLP_ENDPOINT: ${OTEL_EXPORTER_OTLP_ENDPOINT:-}
+      OTEL_SERVICE_NAME: hypermind-mcp
       PYTHONUNBUFFERED: "1"
     depends_on:
       relatadb:

{hypermind-2.0.0 → hypermind-2.0.2}/deploy/standalone/setup.sh

@@ -55,7 +55,7 @@ is_placeholder() { echo "${1:-}" | grep -qiE 'your-|change-me|placeholder|xxx|<.
 configure() {
   echo; echo "$(c 1 'HyperMind setup') — press Enter to keep the shown default."; echo
 
-  local relata openai_key openai_url model searchapi
+  local relata openai_key openai_url model searchapi serper
   relata="$(get_env RELATA_TOKEN)"; [[ -z "$relata" || "$(is_placeholder "$relata"; echo $?)" == 0 ]] && relata="$(openssl rand -hex 32 2>/dev/null || echo change-me-$RANDOM)"
   ask relata      "RELATA_TOKEN (data-store auth)" "$relata"
   ask openai_key  "OPENAI_API_KEY" "$(get_env OPENAI_API_KEY)" secret
@@ -67,13 +67,21 @@ configure() {
   set_env OPENAI_BASE_URL     "$openai_url"
   set_env HYPERMIND_LLM_MODEL "$model"
   set_env MODEL_NAME          "$model"
+  # Resolve ~ now so docker-compose can use ${HYPERMIND_HOME} in volume paths
+  set_env HYPERMIND_HOME      "${HYPERMIND_HOME:-$HOME/.hypermind}"
   ok "wrote $ENV_FILE"
 
-  # Optional external MCP: searchapi
-  echo; echo "  External MCP servers (optional — Enter to skip):"
-  ask searchapi "  SearchApi.io token (for web search MCP)" ""
+  # Optional search API keys
+  echo; echo "  Search API keys (optional — Enter to skip):"
+  ask searchapi "  SearchApi.io token (web search MCP — searchapi.io)" "$(get_env SEARCHAPI_TOKEN)" secret
+  ask serper    "  Serper API key (Google search built-in — serper.dev)" "$(get_env SERPER_API_KEY)" secret
+
+  [[ -n "$serper" ]] && ! is_placeholder "$serper" && set_env SERPER_API_KEY "$serper"
+
+  # Write mcp.json — include searchapi server only if a real token was given
+  mkdir -p config
   if [[ -n "$searchapi" ]] && ! is_placeholder "$searchapi"; then
-    mkdir -p config
+    set_env SEARCHAPI_TOKEN "$searchapi"
     cat > "$MCP_FILE" <<JSON
 {
   "mcpServers": {
@@ -84,12 +92,33 @@ configure() {
   }
 }
 JSON
-    ok "wrote $MCP_FILE (searchapi enabled)"
+    ok "wrote $MCP_FILE (searchapi MCP enabled)"
   else
-    # No token → ship an empty MCP config so no failing server is wired.
-    mkdir -p config; echo '{ "mcpServers": {} }' > "$MCP_FILE"
-    warn "no SearchApi token — external MCP disabled (built-in DuckDuckGo search still works)"
+    echo '{ "mcpServers": {} }' > "$MCP_FILE"
+    if [[ -n "$serper" ]] && ! is_placeholder "$serper"; then
+      ok "SearchApi skipped — Serper built-in will handle web search"
+    else
+      warn "no search token — falling back to built-in DuckDuckGo (no key required)"
+    fi
   fi
+
+  # Write the env file to two places:
+  #   .data/hypermind/env  → mounted as /data/env inside Docker (container reads it)
+  #   ~/.hypermind/env     → read by local hmctl / status checks
+  _write_hm_env() {
+    local dest="$1"
+    mkdir -p "$(dirname "$dest")"
+    : > "$dest"
+    [[ -n "$(get_env OPENAI_API_KEY)"      ]] && printf 'OPENAI_API_KEY=%s\n'      "$(get_env OPENAI_API_KEY)"      >> "$dest"
+    [[ -n "$(get_env OPENAI_BASE_URL)"     ]] && printf 'OPENAI_BASE_URL=%s\n'     "$(get_env OPENAI_BASE_URL)"     >> "$dest"
+    [[ -n "$(get_env HYPERMIND_LLM_MODEL)" ]] && printf 'HYPERMIND_LLM_MODEL=%s\n' "$(get_env HYPERMIND_LLM_MODEL)" >> "$dest"
+    [[ -n "$(get_env SERPER_API_KEY)"      ]] && printf 'SERPER_API_KEY=%s\n'      "$(get_env SERPER_API_KEY)"      >> "$dest"
+    [[ -n "$(get_env SEARCHAPI_TOKEN)"     ]] && printf 'SEARCHAPI_TOKEN=%s\n'     "$(get_env SEARCHAPI_TOKEN)"     >> "$dest"
+  }
+  _write_hm_env ".data/hypermind/env"
+  ok "wrote .data/hypermind/env (Docker /data/env)"
+  _write_hm_env "${HYPERMIND_HOME:-$HOME/.hypermind}/env"
+  ok "wrote ${HYPERMIND_HOME:-$HOME/.hypermind}/env (local hmctl)"
 }
 
 # ---------------------------------------------------------------------------
@@ -97,6 +126,14 @@ JSON
 # ---------------------------------------------------------------------------
 check_config() {
   echo; echo "$(c 1 'Config check')"; local bad=0
+  # Warn if no search provider is configured at all
+  local has_search=0
+  for k in SEARCHAPI_TOKEN SERPER_API_KEY; do
+    local v; v="$(get_env "$k")"
+    [[ -n "$v" ]] && ! is_placeholder "$v" && has_search=1
+  done
+  [[ $has_search -eq 0 ]] && warn "no search API key set — research agents will use DuckDuckGo only"
+
   for k in RELATA_TOKEN OPENAI_API_KEY OPENAI_BASE_URL HYPERMIND_LLM_MODEL; do
     local v; v="$(get_env "$k")"
     if [[ -z "$v" ]]; then err "$k missing"; bad=1

hypermind-2.0.2/examples/sim_criminology_tech.py

@@ -0,0 +1,428 @@
+"""University of CrimTech — 30-researcher battlefield simulation.
+
+THE STORY
+─────────
+The University of CrimTech launches a flagship research initiative at the
+intersection of Criminology and Technology. Three departments run in parallel:
+
+  • Criminology Theory   — Professors, Postdocs, PhDs studying crime patterns,
+                           recidivism, and sociological drivers.
+  • Forensic Technology  — Lab chiefs and engineers applying AI/ML, biometrics,
+                           blockchain evidence chains, and predictive policing.
+  • Policy & Society     — Analysts and ethicists evaluating legal frameworks,
+                           civil-liberties implications, and governance gaps.
+
+Each department publishes findings, cites peers, disputes weak claims, and
+resolves disputes via oracle professors. Reputation, hypothesis lifecycle,
+KernelStore evolution, and tool calling are all exercised live.
+
+WHAT THIS EXERCISES
+───────────────────
+  ✓ 30-agent OrgSim (scaled university template, 3 custom departments)
+  ✓ Live SearchAPI + Serper tool calling (web_search, retrieve_document)
+  ✓ Hypothesis lifecycle: open → contested → supported/confirmed/refuted
+  ✓ Dispute FSM: OPEN → ARGUE → COUNTER → CLOSED / FRIVOLOUS
+  ✓ Reputation: vouch, Beta-posterior, smooth slashing
+  ✓ KernelStore: learned_facts persist across rounds via checkpoint()
+  ✓ Strategy diversity: TRIZ, Bayesian, dialectic, first-principles
+  ✓ Citation graph: most-cited / most-disputed agents
+  ✓ Evidence grounding: source-faithfulness + tool-result retention
+  ✓ Full report: claims, disputes, reputation leaderboard, tool traces
+
+RUN
+───
+  export OPENAI_API_KEY=...
+  export OPENAI_BASE_URL=https://api.minimax.io/v1   # or any OpenAI-compat
+  export HYPERMIND_LLM_MODEL=MiniMax-M3
+  export SERPER_API_KEY=...          # optional — built-in Serper search
+  export RELATA_URL=http://localhost:9090  # optional — durable ledger
+  export RELATA_TOKEN=...
+
+  python -m examples.sim_criminology_tech
+"""
+
+from __future__ import annotations
+
+import asyncio
+import os
+import textwrap
+from datetime import datetime
+
+
+# ── helpers ──────────────────────────────────────────────────────────────────
+def _h(title: str) -> None:
+    print(f"\n{'═' * 70}")
+    print(f"  {title}")
+    print("═" * 70)
+
+
+def _sub(title: str) -> None:
+    print(f"\n── {title} {'─' * (66 - len(title))}")
+
+
+# ── org model ────────────────────────────────────────────────────────────────
+def build_crimtech_university() -> OrgModel:  # noqa: F821
+    from hypermind.orgs.model import DynamicsConfig, OrgModel, Seat, Unit
+
+    def dept(name: str, tools: tuple, seats: tuple) -> Unit:
+        return Unit(name=name, tools=tools, seats=seats)
+
+    theory = dept(
+        "criminology-theory",
+        tools=("web_search", "retrieve_document", "relata_search_knowledge"),
+        seats=(
+            Seat(
+                "Professor of Criminology",
+                role="oracle",
+                authority=0.95,
+                system="You are a tenured criminology professor. Ground every claim "
+                "in peer-reviewed literature and empirical data. Resolve disputes "
+                "by weighing evidence quality and methodology rigor.",
+            ),
+            Seat(
+                "Postdoc Researcher",
+                role="synthesist",
+                authority=0.72,
+                system="You synthesise findings across theoretical frameworks "
+                "(routine-activity theory, strain theory, social disorganisation). "
+                "Surface cross-paradigm insights.",
+            ),
+            Seat(
+                "PhD Student",
+                role="scout",
+                authority=0.38,
+                headcount=4,
+                system="You are an eager PhD student exploring crime pattern frontiers. "
+                "Surface speculative but promising hypotheses; flag data gaps.",
+            ),
+            Seat(
+                "Peer Reviewer",
+                role="sceptic",
+                authority=0.62,
+                system="You rigorously challenge weak methodology, selection bias, "
+                "and overclaiming. Demand replication evidence.",
+            ),
+        ),
+    )
+
+    forensic = dept(
+        "forensic-technology",
+        tools=("web_search", "retrieve_document"),
+        seats=(
+            Seat(
+                "Lab Chief",
+                role="oracle",
+                authority=0.93,
+                system="You are the forensic technology lab chief. Adjudicate technical "
+                "claims about AI/ML in law enforcement, biometrics, blockchain "
+                "evidence chains, and digital forensics. Demand reproducibility.",
+            ),
+            Seat(
+                "ML Engineer",
+                role="synthesist",
+                authority=0.75,
+                system="You integrate machine-learning research with forensic practice. "
+                "Identify where models fail (bias, adversarial examples, "
+                "distribution shift in crime data).",
+            ),
+            Seat(
+                "Forensic Analyst",
+                role="scout",
+                authority=0.42,
+                headcount=4,
+                system="You probe cutting-edge forensic tools: DNA phenotyping, "
+                "deepfake detection, cell-site simulators, predictive policing. "
+                "Surface capability and limitation findings early.",
+            ),
+            Seat(
+                "Ethics Auditor",
+                role="sceptic",
+                authority=0.65,
+                system="You audit forensic tech claims for civil-liberties risks, "
+                "disparate-impact evidence, and legal admissibility problems.",
+            ),
+        ),
+    )
+
+    policy = dept(
+        "policy-society",
+        tools=("web_search",),
+        seats=(
+            Seat(
+                "Professor of Law",
+                role="oracle",
+                authority=0.91,
+                system="You are a law professor specialising in criminal justice policy. "
+                "Ground claims in statute, case law, and comparative jurisdiction "
+                "analysis. Adjudicate ethical disputes.",
+            ),
+            Seat(
+                "Policy Analyst",
+                role="synthesist",
+                authority=0.70,
+                system="You translate research findings into actionable policy recommendations, "
+                "weighing efficacy, feasibility, and rights implications.",
+            ),
+            Seat(
+                "Sociologist",
+                role="scout",
+                authority=0.40,
+                headcount=4,
+                system="You study the social impact of crime-tech on communities: "
+                "surveillance capitalism, chilling effects, racial profiling, "
+                "the prison-industrial complex. Surface uncomfortable truths.",
+            ),
+            Seat(
+                "Civil-Liberties Advocate",
+                role="sceptic",
+                authority=0.60,
+                system="You challenge any claim that trades privacy or due process for "
+                "security gains without rigorous evidence of net benefit.",
+            ),
+        ),
+    )
+
+    return OrgModel(
+        name="university-of-crimtech",
+        namespace="crimtech-2026",
+        lexicon={"claim": "paper", "cite": "citation", "unit": "department"},
+        units=(theory, forensic, policy),
+        dynamics=DynamicsConfig(
+            interaction="cooperative",
+            rounds=4,  # 4 full research rounds
+            dispute_gap=0.3,  # challenge claims with confidence gap >= 0.3
+        ),
+    )
+
+
+# ── main ─────────────────────────────────────────────────────────────────────
+async def main() -> None:
+    import openai
+
+    from hypermind.orgs import OrgSim
+    from hypermind.orgs.mcp_config import attach_mcp_config, load_mcp_config
+
+    _h("University of CrimTech — 30-Researcher Simulation")
+    print(f"  Started: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+
+    # ── LLM client ───────────────────────────────────────────────────────────
+    api_key = os.environ.get("OPENAI_API_KEY")
+    if not api_key:
+        raise SystemExit(
+            "OPENAI_API_KEY not set.\n"
+            "  export OPENAI_API_KEY=...\n"
+            "  export OPENAI_BASE_URL=https://api.minimax.io/v1\n"
+            "  export HYPERMIND_LLM_MODEL=MiniMax-M3"
+        )
+    base_url = os.environ.get("OPENAI_BASE_URL")
+    model_name = os.environ.get("HYPERMIND_LLM_MODEL", "gpt-4o-mini")
+    client = openai.AsyncOpenAI(api_key=api_key, base_url=base_url)
+    print(f"  LLM     : {model_name}  ({base_url or 'api.openai.com'})")
+
+    # ── optional Relata backend ───────────────────────────────────────────────
+    relata_url = os.environ.get("RELATA_URL", "")
+    relata_token = os.environ.get("RELATA_TOKEN", "")
+    print(f"  Relata  : {relata_url or 'in-memory (no persistence)'}")
+
+    # ── MCP tools ────────────────────────────────────────────────────────────
+    cfg = load_mcp_config()
+    _sessions: list = []
+    gw = None
+    if cfg:
+        from hypermind.orgs.tool_providers import ToolGateway
+
+        gw = ToolGateway()
+        counts, _sessions = await attach_mcp_config(gw, cfg)
+        total_tools = sum(counts.values())
+        print(f"  MCP     : {dict(counts)}  ({total_tools} tools)")
+    else:
+        print("  MCP     : no mcp.json — using built-in search tools")
+
+    # ── build org (scale to 30 members) ──────────────────────────────────────
+    model = build_crimtech_university()
+    model = model.scaled(30)
+    total_seats = sum(sum(s.headcount for s in u.seats) for u in model.units)
+    print(f"  Org     : {len(model.units)} departments, ~{total_seats} seats → scaled to 30")
+
+    # ── event stream (defined before OrgSim so it can be passed in) ─────────
+    events: list[dict] = []
+
+    def on_event(e: dict) -> None:
+        events.append(e)
+        kind = e.get("event", "")
+        if kind == "tool_call":
+            tools = e.get("tools", [])
+            print(f"  [tool]  {e.get('by', '?')[:20]:20s}  → {tools}")
+        elif kind == "dispute_opened":
+            print(
+                f"  [disp]  {e.get('challenger', '?')[:20]:20s}  challenged {e.get('target_kid', '')[:12]}…"
+            )
+        elif kind == "dispute_resolved":
+            print(f"  [resol] dispute → {e.get('outcome', '?')}")
+        elif kind == "hypothesis_updated":
+            h = e.get("hypothesis", {})
+            print(f"  [hypo]  {h.get('status', '?'):12s}  {str(h.get('statement', ''))[:50]}")
+        elif kind == "round_complete":
+            r = e.get("round", "?")
+            claims = e.get("claims_this_round", 0)
+            print(f"\n  ◎ Round {r} complete — {claims} claims published")
+
+    # ── OrgSim ───────────────────────────────────────────────────────────────
+    sim = OrgSim(
+        model,
+        relata_url=relata_url,
+        relata_token=relata_token or None,
+        llm="openai",
+        llm_model=model_name,
+        llm_client=client,
+        tool_gateway=gw,
+        persist_identities=bool(relata_url),
+        on_event=on_event,
+        max_concurrency=5,  # throttle to avoid overwhelming MiniMax with parallel JSON requests
+    )
+
+    # ── run ──────────────────────────────────────────────────────────────────
+    TOPIC = (
+        "How is AI-driven predictive policing reshaping criminal justice — "
+        "examining algorithmic bias, evidence admissibility, recidivism prediction "
+        "accuracy, civil liberties trade-offs, and emerging regulatory frameworks "
+        "across US, EU, and UK jurisdictions."
+    )
+
+    _h("Research Topic")
+    print(textwrap.fill(f"  {TOPIC}", width=70))
+    print(f"\n  Running {model.dynamics.rounds} rounds…\n")
+    t0 = asyncio.get_event_loop().time()
+
+    report = await sim.simulate(TOPIC, rounds=model.dynamics.rounds)
+
+    elapsed = asyncio.get_event_loop().time() - t0
+
+    # ── teardown MCP ──────────────────────────────────────────────────────────
+    for s in _sessions:
+        try:
+            s.kill()
+        except Exception:
+            pass
+
+    # ═══════════════════════════════════════════════════════════════════════════
+    # RESULTS
+    # ═══════════════════════════════════════════════════════════════════════════
+    _h(f"Simulation Complete  ({elapsed:.0f}s)")
+
+    # ── 1. Claims summary ───────────────────────────────────────────────────
+    _sub("Claims Published")
+    claims = report.claims
+    print(f"  Total claims : {len(claims)}")
+    by_dept: dict[str, int] = {}
+    for c in claims:
+        dept = c.get("unit", "unknown")
+        by_dept[dept] = by_dept.get(dept, 0) + 1
+    for dept, n in sorted(by_dept.items(), key=lambda x: -x[1]):
+        print(f"    {dept:35s}  {n:3d} papers")
+
+    # ── 2. Tool calls ────────────────────────────────────────────────────────
+    _sub("Tool Usage")
+    tool_calls = report.tool_calls()
+    if tool_calls:
+        by_tool: dict[str, int] = {}
+        for tc in tool_calls:
+            t = tc.get("tool", "unknown")
+            by_tool[t] = by_tool.get(t, 0) + 1
+        print(f"  Total tool calls : {len(tool_calls)}")
+        for tool, n in sorted(by_tool.items(), key=lambda x: -x[1]):
+            print(f"    {tool:35s}  {n:3d} calls")
+    else:
+        print("  No tool calls recorded (model may not support function calling)")
+
+    # ── 3. Citation leaderboard ──────────────────────────────────────────────
+    _sub("Most-Cited Papers (Top 5)")
+    most_cited = report.most_cited(5)
+    if most_cited:
+        for i, c in enumerate(most_cited, 1):
+            cites = c.get("citations_received", 0)
+            author = c.get("by", "?")
+            unit = c.get("unit", "")
+            snippet = str(c.get("finding", c.get("content", "")))[:60]
+            print(f"  {i}. [{cites} cites]  {author[:18]:18s} ({unit[:22]})")
+            print(f"       {snippet}…")
+    else:
+        print("  No citations recorded.")
+
+    # ── 4. Disputes ──────────────────────────────────────────────────────────
+    _sub("Dispute Outcomes")
+    opened = len([e for e in events if e.get("event") == "dispute_opened"])
+    resolved = [e for e in events if e.get("event") == "dispute_resolved"]
+    print(f"  Disputes opened   : {opened}")
+    print(f"  Disputes resolved : {len(resolved)}")
+    for e in resolved[:5]:
+        print(f"    → {e.get('outcome', '?')}")
+
+    # ── 5. Hypothesis lifecycle ──────────────────────────────────────────────
+    _sub("Hypothesis Lifecycle")
+    hypo_events = [e for e in events if e.get("event") == "hypothesis_updated"]
+    statuses: dict[str, int] = {}
+    for e in hypo_events:
+        s = e.get("hypothesis", {}).get("status", "unknown")
+        statuses[s] = statuses.get(s, 0) + 1
+    if statuses:
+        for s, n in sorted(statuses.items(), key=lambda x: -x[1]):
+            print(f"    {s:20s}  {n:3d}")
+    else:
+        print("  No hypothesis events captured.")
+
+    # ── 6. Reputation leaderboard ────────────────────────────────────────────
+    _sub("Reputation Leaderboard (Top 8)")
+    leaders = report.top(8)
+    if leaders:
+        for i, st in enumerate(leaders, 1):
+            print(f"  {i}. rep={st.reputation:.3f}  {st.label[:28]:28s} [{st.role:12s}]")
+    else:
+        print("  No reputation data.")
+
+    # ── 7. Evidence grounding ────────────────────────────────────────────────
+    _sub("Evidence & Grounding")
+    evidence = report.evidence()
+    print(f"  Evidence records  : {len(evidence)}")
+    grounded = [e for e in evidence if e.get("tool_calls")]
+    print(f"  Tool-grounded     : {len(grounded)}")
+    if grounded:
+        sample = grounded[0]["tool_calls"][0]
+        snippet = str(sample.get("result", sample.get("result_truncated", "")))[:120]
+        print(f"  Sample result     : {snippet}…")
+
+    # ── 8. Hypothesis lifecycle ──────────────────────────────────────────────
+    _sub("Hypothesis Lifecycle Summary")
+    hypo_summary = report.hypothesis_summary()
+    if hypo_summary:
+        for status, count in sorted(hypo_summary.items(), key=lambda x: -x[1]):
+            print(f"    {status:20s}  {count:3d}")
+        print("\n  Sample hypotheses:")
+        for h in report.hypotheses[:3]:
+            stmt = str(h.get("statement", h.get("title", "")))[:70]
+            print(f"    [{h.get('status', '?'):12s}]  {stmt}")
+    else:
+        print("  No hypotheses tracked this run.")
+
+    # ── 9. Scorecard ─────────────────────────────────────────────────────────
+    _sub("Quality Scorecard")
+    sc = report.scorecard
+    if sc:
+        for k, v in sc.items():
+            if isinstance(v, (int, float)):
+                print(f"    {k:30s}  {v:.3f}" if isinstance(v, float) else f"    {k:30s}  {v}")
+    else:
+        print("  No scorecard data.")
+
+    # ── 9. Full report print ─────────────────────────────────────────────────
+    _h("Full Report Summary")
+    report.print()
+
+    print(f"\n  Finished: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+    print(f"  Runtime : {elapsed:.0f}s")
+    print(f"  Events  : {len(events)} total")
+    print("\n  ✓ Simulation complete.\n")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{hypermind-2.0.0 → hypermind-2.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hypermind"
-version = "2.0.0"
+version = "2.0.2"
 description = "Federated agent intelligence — reference SDK for the HyperMind SCITT contested-claims profile"
 readme = "README.md"
 requires-python = ">=3.12,<3.15"
@@ -33,7 +33,7 @@ dependencies = [
     "rich>=13.7",
     "quantcrypt>=1.0",
     "pymerkle>=6.1",
-    "relata-sdk>=0.2",
+    "relata-sdk>=0.3.4",
     "openai>=1.50,<2",
     "mcp>=1.0",
 ]

{hypermind-2.0.0 → hypermind-2.0.2}/src/hypermind/knowledge/kernel_store.py

@@ -1087,14 +1087,22 @@ def get_kernel_store() -> type[KernelStore] | RelataKernelStore:
     # Prefer the live env vars so per-test monkeypatch.setenv takes effect;
     # fall back to the import-time config constants.
     url = os.environ.get("RELATA_URL", "").strip()
-    tok = os.environ.get("RELATA_BEARER_TOKEN", "").strip() or None
+    # RELATA_BEARER_TOKEN is canonical; RELATA_TOKEN is the legacy alias used by
+    # docker-compose and the sim scripts — honour both so KernelStore reaches Relata
+    # even when only RELATA_TOKEN is set in the environment.
+    tok = (
+        os.environ.get("RELATA_BEARER_TOKEN", "").strip()
+        or os.environ.get("RELATA_TOKEN", "").strip()
+        or None
+    )
     if not url:
         try:
             from hypermind.config import RELATA_BEARER_TOKEN as _RTOK
+            from hypermind.config import RELATA_TOKEN as _RTOK2
             from hypermind.config import RELATA_URL as _RURL
 
             url = (_RURL or "").strip()
-            tok = (_RTOK or "").strip() or None
+            tok = (_RTOK or "").strip() or (_RTOK2 or "").strip() or None
         except Exception:
             pass
     if not url: