{
  "schema_version": "ecz-developer-gateway-v1",
  "site": "ECZ-ID Developer Gateway",
  "canonical_url": "https://developers.ecocitizenz.com",
  "role": "documentation_and_routing",
  "role_boundaries": {
    "developer_gateway": "Documents and routes. Does not host checkout, does not create or change verification state, does not act as a public proof surface.",
    "trustops": "Setup, payment, and lifecycle.",
    "resolver": "Public proof surface for current state.",
    "verifier": "Reads public manifests and Resolver. Returns ResultState and ReasonCodes. Does not create or change verification state."
  },
  "trustops_url": "https://trustops.ecocitizenz.com",
  "resolver_url": "https://resolver.ecocitizenz.org",
  "solution_routes": {
    "documentation": "https://developers.ecocitizenz.com/solutions/",
    "count": 12,
    "routes": [
      { "order": 1, "id": "mcp", "title": "MCP Server & Tool Trust", "docs": "https://developers.ecocitizenz.com/mcp/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=mcp" },
      { "order": 2, "id": "agent", "title": "Agent Identity & KYA", "docs": "https://developers.ecocitizenz.com/agents/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=agent" },
      { "order": 3, "id": "api-software", "title": "API, Software & Repo Trust", "docs": "https://developers.ecocitizenz.com/agent-trust/api-passport/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=api-software" },
      { "order": 4, "id": "cloud", "title": "Cloud & Provider Proof", "docs": "https://developers.ecocitizenz.com/domains/platforms-marketplaces-control-overlays/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=cloud" },
      { "order": 5, "id": "business", "title": "Business Identity Foundation", "docs": "https://developers.ecocitizenz.com/catalog/parent-passports/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=business" },
      { "order": 6, "id": "dci", "title": "Digital Counterparty Infrastructure", "docs": "https://developers.ecocitizenz.com/rails/digital-counterparty/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=dci" },
      { "order": 7, "id": "dora-sbom", "title": "DORA & SBOM Vendor Credentialing", "docs": "https://developers.ecocitizenz.com/dora-sbom-suite/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=dora-sbom" },
      { "order": 8, "id": "critical-cyber-resilience", "title": "Critical Infrastructure, Cyber & Operational Resilience", "docs": "https://developers.ecocitizenz.com/rails/enterprise-platform-trust/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=critical-cyber-resilience" },
      { "order": 9, "id": "trade-construction", "title": "Trade Finance & Construction Outcomes", "docs": "https://developers.ecocitizenz.com/flows/package-flows/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=trade-construction" },
      { "order": 10, "id": "robotics-insurability", "title": "Humanoid Robots & Robotics Insurability", "docs": "https://developers.ecocitizenz.com/domains/robotics-humanoids/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=robotics-insurability" },
      { "order": 11, "id": "mobility-insurability", "title": "Robotaxis, Autonomous Freight & Drone Insurability", "docs": "https://developers.ecocitizenz.com/domains/vehicles-mobility/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=mobility-insurability" },
      { "order": 12, "id": "global-trade-marine", "title": "Global Trade, Containers & Marine Insurability", "docs": "https://developers.ecocitizenz.com/domains/trade-shipping-infrastructure/", "trustops_flow": "https://trustops.ecocitizenz.com/start?flow=global-trade-marine" }
    ]
  },
  "stakeholder_route_map": {
    "developer_or_agent_builder": "https://developers.ecocitizenz.com/developer-onboarding/",
    "autonomous_agent_or_llm": "https://developers.ecocitizenz.com/llms.txt",
    "mcp_operator": "https://developers.ecocitizenz.com/mcp/",
    "api_or_software_publisher": "https://developers.ecocitizenz.com/agent-trust/api-passport/",
    "business_buyer_or_procurement": "https://developers.ecocitizenz.com/why-serious-buyers-care/",
    "marketplace_or_app_reviewer": "https://developers.ecocitizenz.com/agent-trust/surfaces/",
    "insurer_or_regulator_or_auditor": "https://developers.ecocitizenz.com/verification-model/",
    "resolver_verifier": "https://resolver.ecocitizenz.org",
    "operator_needing_setup": "https://trustops.ecocitizenz.com/start"
  },
  "setup_handoff": {
    "request_resolver_proof_docs": "https://developers.ecocitizenz.com/request-resolver-proof/",
    "trustops_handoffs": {
      "setup_manifest": "GET https://trustops.ecocitizenz.com/api/start/manifest",
      "start": "https://trustops.ecocitizenz.com/start"
    },
    "resolver_recheck": "https://resolver.ecocitizenz.org",
    "note": "Documentation and routing only. Deliberate setup, payment, and lifecycle run in TrustOps; they do not create entitlement or proof. Public proof appears only after ECZ-ID backend activation, not at checkout alone. Re-check the Resolver before reliance."
  },
  "target_type_routes": {
    "agent_credential": {
      "guide": "https://developers.ecocitizenz.com/agents/agent-credential-entry/",
      "trustops_setup": "https://trustops.ecocitizenz.com/start?intent=agent"
    },
    "api_passport": {
      "guide": "https://developers.ecocitizenz.com/bindings/openapi-x-ecz-id/",
      "trustops_setup": "https://trustops.ecocitizenz.com/start?intent=api-software"
    },
    "mcp_server": {
      "verifier": "https://developers.ecocitizenz.com/mcp/verifier/",
      "verifier_cli_docs": "https://developers.ecocitizenz.com/agent-trust/mcp-verifier/",
      "verifier_npm": "@ecocitizenz/ecz-id-mcp-verifier@0.7.0",
      "verifier_github_action_docs": "https://developers.ecocitizenz.com/agent-trust/github-action/",
      "verifier_github_action_ref": "Ecocitizenz/ecz-id-mcp-verifier@v0.7.1",
      "result_contract": "https://developers.ecocitizenz.com/agent-trust/result-contract/",
      "assurance": "https://developers.ecocitizenz.com/mcp/assurance/",
      "assurance_plus": "https://developers.ecocitizenz.com/mcp/assurance-plus/",
      "policy": "https://developers.ecocitizenz.com/mcp/policy/",
      "trustops_setup": "https://trustops.ecocitizenz.com/start?intent=mcp"
    },
    "package": {
      "guide": "https://developers.ecocitizenz.com/bindings/"
    },
    "domain": {
      "guide": "https://developers.ecocitizenz.com/bindings/"
    },
    "sbom": {
      "guide": "https://developers.ecocitizenz.com/dora-sbom-suite/"
    }
  },
  "machine_readable_endpoints": {
    "manifest": "https://developers.ecocitizenz.com/.well-known/ecz-developer-gateway.json",
    "actions": "https://developers.ecocitizenz.com/actions.json",
    "llms_guide": "https://developers.ecocitizenz.com/llms.txt",
    "schema_index": "https://developers.ecocitizenz.com/schemas/index.json",
    "acquisition_manifest": "https://developers.ecocitizenz.com/schemas/acquisition-manifest.json",
    "sitemap": "https://developers.ecocitizenz.com/sitemap.xml"
  },
  "action_envelope_schemas": {
    "human_guidance": "https://developers.ecocitizenz.com/schemas/action-envelopes/",
    "resolver_action_envelope": "https://developers.ecocitizenz.com/schemas/action-envelopes/resolver-action-envelope.schema.json",
    "mcp_action_envelope": "https://developers.ecocitizenz.com/schemas/action-envelopes/mcp-action-envelope.schema.json",
    "agent_action_envelope": "https://developers.ecocitizenz.com/schemas/action-envelopes/agent-action-envelope.schema.json",
    "reciprocal_reliance_envelope": "https://developers.ecocitizenz.com/schemas/action-envelopes/reciprocal-reliance-envelope.schema.json",
    "request_to_resolve": "https://developers.ecocitizenz.com/schemas/action-envelopes/request-to-resolve.schema.json",
    "resolver_recheck_contract": "https://developers.ecocitizenz.com/schemas/action-envelopes/resolver-recheck-contract.schema.json",
    "trustops_product_action_manifest": "https://developers.ecocitizenz.com/schemas/action-envelopes/trustops-product-action-manifest.schema.json",
    "ap2_ucp_readiness": "https://developers.ecocitizenz.com/schemas/action-envelopes/ap2-ucp-readiness.schema.json"
  },
  "availability_semantics": {
    "documented_pattern": "Described and schema-published on this site; integrate against public manifests and endpoints.",
    "live": "Verified working on the public surface named.",
    "public_sdk": "none",
    "public_sandbox": "none",
    "self_serve_api_keys": "none",
    "note": "Capabilities are described as available only where live-verified. Anything else is a documented pattern or explicitly marked unavailable."
  },
  "privacy": {
    "no_trackers": true,
    "no_telemetry_collection": true,
    "no_account_required_to_read": true
  },
  "forbidden_inferences": [
    "safety",
    "certification",
    "approval",
    "insurance",
    "full_compliance",
    "platform_endorsement"
  ],
  "policy": {
    "local_policy_decides": true,
    "recheck_before_reliance": true,
    "no_safety_or_approval_inference": true,
    "recommendations_are_advisory": true,
    "public_note": "Public proof appears only after ECZ-ID backend activation, not at checkout alone."
  }
}
