{
  "app_name": "sovereign_file_finder",
  "interfaces": {
    "cli": {
      "flags": {
        "--api [PORT]": "Run local REST API server (default 8080)",
        "--introspect": "Print machine-readable schema",
        "--json": "Output pure JSON results to stdout",
        "--mcp": "Run as Model Context Protocol (stdio JSON-RPC)",
        "--tunnel [PORT]": "Run 0-RTT QUIC P2P Tunnel + REST API"
      },
      "usage": "rust_file_finder <scope_path> <query> [--json]"
    },
    "mcp": {
      "protocol_version": "2024-11-05",
      "tools": [
        {
          "description": "Sub-millisecond parallel file and code search across local drives without cloud latency",
          "input_schema": {
            "properties": {
              "query": {
                "type": "string"
              },
              "scope": {
                "type": "string"
              }
            },
            "required": [
              "query"
            ],
            "type": "object"
          },
          "name": "fast_file_search"
        }
      ],
      "transport": "stdio"
    },
    "p2p_tunnel": {
      "bandwidth_cost": "$0.00 (Zero Cloud Bills)",
      "protocol": "0-RTT QUIC / UDP Hole Punching",
      "public_endpoint": "https://file-finder.shambhavilabs.live"
    },
    "rest_api": {
      "base_url": "http://127.0.0.1:8080",
      "endpoints": [
        {
          "description": "Tokenized and exact sub-ms search",
          "method": "POST",
          "path": "/api/v1/search"
        },
        {
          "description": "GET query search",
          "method": "GET",
          "path": "/api/v1/search?q=..."
        },
        {
          "description": "Typo-tolerant fuzzy search",
          "method": "POST",
          "path": "/api/v1/fuzzy"
        },
        {
          "description": "Index directory tree on demand",
          "method": "POST",
          "path": "/api/v1/scan"
        },
        {
          "description": "Engine index statistics",
          "method": "GET",
          "path": "/api/v1/stats"
        },
        {
          "description": "OpenAPI 3.1.0 schema",
          "method": "GET",
          "path": "/api/v1/schema"
        }
      ]
    }
  },
  "sovereign_standard": "50-Year Machine-First Architecture",
  "version": "1.0.0"
}