# JSON Tree + PlatPhorm Schema Registry

JSON Tree + PlatPhorm Schema Registry is the public JSON viewer, formatter, validator, tree explorer, and schema registry layer for the PlatPhormNews web mesh.

## Public Access

- Public-safe JSON editor and API operations are open by default.
- Local drafts use browser storage only; server-side persistence is not claimed when DATABASE_URL is unavailable.
- Future protected mutations use PLATPHORM_API_KEY through Authorization: Bearer or X-PlatPhorm-API-Key.

## JSON Tooling

- trusted URL graph handoff
- parse
- format
- minify
- validate
- stats
- tree search
- schema validation

## Schema Registry

- Schema pack status: active
- Active schemas: 6/6
- PlatPhorm Universal Schema Pack: https://json.innovativefuturesolutions.com/schemas/json/platphorm-universal-schema-pack.json (active)
- PlatPhorm Core Enums and Defaults: https://json.innovativefuturesolutions.com/schemas/json/core.schema.json (active)
- Realm: https://json.innovativefuturesolutions.com/schemas/json/realm.schema.json (active)
- Base Item: https://json.innovativefuturesolutions.com/schemas/json/item.schema.json (active)
- Observability Types: https://json.innovativefuturesolutions.com/schemas/json/observability.schema.json (active)
- Agent Types: https://json.innovativefuturesolutions.com/schemas/json/agent.schema.json (active)

## API

- GET https://json.innovativefuturesolutions.com/api/health
- GET https://json.innovativefuturesolutions.com/api/v1/health
- GET https://json.innovativefuturesolutions.com/api/docs
- GET https://json.innovativefuturesolutions.com/openapi.yaml
- POST https://json.innovativefuturesolutions.com/api/v1/parse
- POST https://json.innovativefuturesolutions.com/api/v1/format
- POST https://json.innovativefuturesolutions.com/api/v1/minify
- POST https://json.innovativefuturesolutions.com/api/v1/validate
- POST https://json.innovativefuturesolutions.com/api/v1/stats
- POST https://json.innovativefuturesolutions.com/api/v1/schema/validate
- POST https://json.innovativefuturesolutions.com/api/v1/fetch-url
- GET https://json.innovativefuturesolutions.com/api/v1/schemas
- GET https://json.innovativefuturesolutions.com/api/v1/schema-pack
- GET https://json.innovativefuturesolutions.com/api/v1/jsonld

## V0 Public Registry

- GET https://json.innovativefuturesolutions.com/v0/universes: List public universes exposed by the JSON schema registry.
- GET https://json.innovativefuturesolutions.com/v0/realms: List public realms exposed by the JSON schema registry.
- GET https://json.innovativefuturesolutions.com/v0/realm/{id}/items: List public schema items for a realm.

## MCP

- GET https://json.innovativefuturesolutions.com/api/mcp
- POST https://json.innovativefuturesolutions.com/api/mcp
- Public read-only introspection is available.
- Public-safe JSON/schema tools execute real local handlers.
- Cross-site report/remediation tools return honest degraded status unless the backing integration is configured.

## Trace And Trust

- JSON/API/MCP responses preserve W3C trace metadata. Only meaningful JSON actions and failures export span journeys; successful health, discovery, and registry reads are intentionally suppressed.
- Trusted domain discovery defaults to *.platphormnews.com.
- Trust policy: Public-safe JSON editing, formatting, validation, schema browsing, schema validation, local non-sensitive JSON draft persistence, read-only MCP introspection, RSS/feed consumption, trusted-domain discovery, standard route compliance, provider-neutral request metadata capture, backend model scaffolding, and trace-linked JSON operations are intentionally supported for public use. PLATPHORM_API_KEY support is scaffolded for future protected backend services, registry mutation, private validation, sync, test-triggering, reporting, administrative actions, and sensitive operations.


## Route Inventory

- GET / | publicSafe=true | implemented=true | Public JSON editor, tree viewer, formatter, validator, and schema registry surface.
- GET /docs | publicSafe=true | implemented=true | Human API and MCP documentation.
- GET /faq | publicSafe=true | implemented=true | Public FAQ for JSON Tree and schema registry usage.
- GET /roadmap | publicSafe=true | implemented=true | Public roadmap.
- GET /api/health | publicSafe=true | implemented=true | Standard public-safe health summary.
- GET /api/v1/health | publicSafe=true | implemented=true | Versioned health summary.
- GET /api/docs | publicSafe=true | implemented=true | OpenAPI 3.1 JSON document.
- POST /api/v1/parse | publicSafe=true | implemented=true | Parse JSON into tree state and stats.
- POST /api/v1/format | publicSafe=true | implemented=true | Format valid JSON.
- POST /api/v1/minify | publicSafe=true | implemented=true | Minify valid JSON.
- POST /api/v1/validate | publicSafe=true | implemented=true | Validate JSON syntax.
- POST /api/v1/stats | publicSafe=true | implemented=true | Calculate JSON node and type statistics.
- POST /api/v1/schema/validate | publicSafe=true | implemented=true | Validate JSON against a public schema.
- GET /api/v1/schemas | publicSafe=true | implemented=true | List public registry schemas.
- GET /api/v1/schemas/{slug} | publicSafe=true | implemented=true | Read one public registry schema.
- GET /api/v1/schema-pack | publicSafe=true | implemented=true | Read schema pack metadata and files.
- GET /api/v1/jsonld | publicSafe=true | implemented=true | Read JSON-LD structured data artifacts.
- POST /api/v1/jsonld/validate | publicSafe=true | implemented=true | Validate JSON-LD structure locally.
- POST /api/v1/fetch-url | publicSafe=true | implemented=true | Fetch bounded public JSON from the PlatPhorm network or an explicitly approved demo origin.
- POST /api/v1/diff | publicSafe=true | implemented=true | Compare two valid JSON documents and report structural changes.
- GET /api/v1/mcp | publicSafe=true | implemented=true | Versioned alias for read-only MCP metadata and usage.
- POST /api/v1/mcp | publicSafe=true | implemented=true | Versioned alias for public-safe JSON-RPC MCP tooling.
- GET /api/mcp/register | publicSafe=true | implemented=true | Read the future protected MCP registration contract.
- POST /api/mcp/register | publicSafe=false | implemented=true | Protected, non-mutating MCP registration scaffold.
- GET /api/mcp/sse | publicSafe=true | implemented=true | Bounded server-sent-event transport with connection and keepalive events.
- POST /api/cron/refresh | publicSafe=false | implemented=true | Bounded metadata refresh for Vercel cron or PLATPHORM_API_KEY.
- GET /openapi.yaml | publicSafe=true | implemented=true | OpenAPI 3.1 YAML document.
- GET /openapi.json | publicSafe=true | implemented=true | OpenAPI 3.1 JSON document.
- GET /llms.txt | publicSafe=true | implemented=true | Readable compact LLM discovery guide.
- GET /llms-full.txt | publicSafe=true | implemented=true | Full LLM discovery guide.
- GET /llms-index.json | publicSafe=true | implemented=true | Machine-readable LLM discovery index.
- GET /robots.txt | publicSafe=true | implemented=true | Robots policy with canonical sitemap links.
- GET /sitemap.xml | publicSafe=true | implemented=true | Public-safe sitemap.
- GET /sitemap-main.xml | publicSafe=true | implemented=true | Main public page and schema sitemap.
- GET /sitemap-index.xml | publicSafe=true | implemented=true | Sitemap index.
- GET /rss.xml | publicSafe=true | implemented=true | Public-safe RSS feed.
- GET /feed.xml | publicSafe=true | implemented=true | Public-safe RSS feed alias.
- GET /manifest.webmanifest | publicSafe=true | implemented=true | Web app manifest.
- GET /.well-known/mcp.json | publicSafe=true | implemented=true | MCP discovery metadata.
- GET /.well-known/agents.json | publicSafe=true | implemented=true | Agent discovery metadata.
- GET /.well-known/ai-plugin.json | publicSafe=true | implemented=true | AI plugin discovery metadata.
- GET /.well-known/llms.txt | publicSafe=true | implemented=true | Well-known alias for the compact LLM discovery guide.
- GET /.well-known/llms-full.txt | publicSafe=true | implemented=true | Well-known alias for the full LLM discovery guide.
- GET /.well-known/llms-index.json | publicSafe=true | implemented=true | Well-known alias for the machine-readable LLM discovery index.
- GET /.well-known/security.txt | publicSafe=true | implemented=true | Security contact policy.
- GET /.well-known/trust.json | publicSafe=true | implemented=true | Trust and data exposure policy.
- GET /.well-known/platphorm.json | publicSafe=true | implemented=true | PlatPhorm realm manifest.
- GET /favicon.ico | publicSafe=true | implemented=true | Application icon.
- GET /opengraph-image | publicSafe=true | implemented=true | Redirect to the bundled social preview image.
- GET /schemas/json/platphorm-universal-schema-pack.json | publicSafe=true | implemented=true | The bundled public schema pack for PlatPhorm network contracts.
- GET /schemas/json/core.schema.json | publicSafe=true | implemented=true | Core enums and defaults shared by PlatPhorm schema contracts.
- GET /schemas/json/realm.schema.json | publicSafe=true | implemented=true | Public contract for PlatPhorm realms and sites.
- GET /schemas/json/item.schema.json | publicSafe=true | implemented=true | Public contract for PlatPhorm content and operational items.
- GET /schemas/json/observability.schema.json | publicSafe=true | implemented=true | Trace, span, and observability contract schema.
- GET /schemas/json/agent.schema.json | publicSafe=true | implemented=true | Agent run and human-machine handoff contract schema.
- GET /v0/universes | publicSafe=true | implemented=true | List public universes exposed by the JSON schema registry.
- GET /v0/realms | publicSafe=true | implemented=true | List public realms exposed by the JSON schema registry.
- GET /v0/realm/{id}/items | publicSafe=true | implemented=true | List public schema items for a realm.
- GET /api/mcp | publicSafe=true | implemented=true | Read-only MCP metadata and usage.
- POST /api/mcp | publicSafe=true | implemented=true | JSON-RPC 2.0 MCP endpoint for public-safe JSON and schema tooling.

## Auth Policy

{
  "requiredNow": false,
  "boundary": "future-protected",
  "acceptedHeaders": [
    "Authorization: Bearer $PLATPHORM_API_KEY",
    "X-PlatPhorm-API-Key: $PLATPHORM_API_KEY"
  ],
  "environmentFlag": "PLATPHORM_REQUIRE_API_KEY",
  "keyName": "PLATPHORM_API_KEY",
  "publicSafeDefault": true
}

## Discovery Compliance

{
  "status": "active",
  "discoveryRouteCount": 23,
  "activeSchemaCount": 6,
  "schemaCount": 6,
  "llmsStatus": "active",
  "openapiStatus": "active",
  "rssStatus": "active",
  "sitemapStatus": "active",
  "trustStatus": "active",
  "score": 1
}

## JSON-LD Artifacts

{
  "website": {
    "@context": "https://schema.org",
    "@type": "WebSite",
    "name": "JSON Tree + PlatPhorm Schema Registry",
    "url": "https://json.innovativefuturesolutions.com"
  },
  "softwareApplication": {
    "@context": "https://schema.org",
    "@type": "SoftwareApplication",
    "name": "JSON Tree + PlatPhorm Schema Registry",
    "applicationCategory": "DeveloperApplication",
    "operatingSystem": "Any",
    "url": "https://json.innovativefuturesolutions.com",
    "offers": {
      "@type": "Offer",
      "price": "0",
      "priceCurrency": "USD"
    }
  },
  "dataset": {
    "@context": "https://schema.org",
    "@type": "Dataset",
    "name": "PlatPhorm Universal Schema Pack",
    "url": "https://json.innovativefuturesolutions.com/schemas/json/platphorm-universal-schema-pack.json",
    "distribution": [
      {
        "@type": "DataDownload",
        "name": "PlatPhorm Universal Schema Pack",
        "contentUrl": "https://json.innovativefuturesolutions.com/schemas/json/platphorm-universal-schema-pack.json",
        "encodingFormat": "application/schema+json"
      },
      {
        "@type": "DataDownload",
        "name": "Core Schema",
        "contentUrl": "https://json.innovativefuturesolutions.com/schemas/json/core.schema.json",
        "encodingFormat": "application/schema+json"
      },
      {
        "@type": "DataDownload",
        "name": "Realm Schema",
        "contentUrl": "https://json.innovativefuturesolutions.com/schemas/json/realm.schema.json",
        "encodingFormat": "application/schema+json"
      },
      {
        "@type": "DataDownload",
        "name": "Item Schema",
        "contentUrl": "https://json.innovativefuturesolutions.com/schemas/json/item.schema.json",
        "encodingFormat": "application/schema+json"
      },
      {
        "@type": "DataDownload",
        "name": "Observability Schema",
        "contentUrl": "https://json.innovativefuturesolutions.com/schemas/json/observability.schema.json",
        "encodingFormat": "application/schema+json"
      },
      {
        "@type": "DataDownload",
        "name": "Agent Schema",
        "contentUrl": "https://json.innovativefuturesolutions.com/schemas/json/agent.schema.json",
        "encodingFormat": "application/schema+json"
      }
    ]
  }
}