{
  "generated_at": "2026-04-10T10:31:25.570Z",
  "system": {
    "id": "topolo-nexus",
    "name": "Topolo Nexus",
    "slug": "topolo-nexus",
    "kind": "application",
    "summary": "Gateway and usage-management layer for standardized AI, email, and payment provider access across the Topolo platform.",
    "aliases": [],
    "lifecycle": "active",
    "last_verified": "2026-04-07",
    "owners": [
      "ai-platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloNexus"
    ],
    "service_ids": [],
    "visibility": "public",
    "api_contract": {
      "type": "curated",
      "source": "PlatformApplications/TopoloNexus/package.json",
      "notes": "Canonical docs and gateway routes define Nexus as the typed provider gateway for AI, email, payments, and provider-credential resolution, with platform-default credential mutation restricted to the configured platform super-admin account in the Auth admin organization."
    },
    "primary_hosts": [],
    "doc_paths": [
      "applications/nexus",
      "internal/apps/nexus"
    ],
    "dependencies": [
      "topolo-auth"
    ],
    "public_hub_url": "/systems/topolo-nexus",
    "internal_hub_url": null,
    "application_api_url": "/reference/apps/topolo-nexus",
    "generated_openapi_url": null,
    "machine_urls": {
      "system": "/machine/systems/topolo-nexus.json",
      "application": "/machine/applications/topolo-nexus.json"
    }
  },
  "docs": {
    "public": [
      {
        "id": "applications/bugfix.mdx",
        "title": "Topolo BugFix",
        "summary": "Public overview of BugFix, including AI-assisted bug analysis, fix generation, and Nexus-backed provider usage.",
        "audience": "public",
        "tags": [
          "bugs",
          "ai",
          "automation",
          "github"
        ],
        "url": "/applications/bugfix.mdx",
        "last_verified": "2026-04-07"
      },
      {
        "id": "applications/commerce.mdx",
        "title": "TopoloCommerce",
        "summary": "Public overview of the multi-vertical commerce platform for venue operations, guest runtimes, and staff execution.",
        "audience": "public",
        "tags": [
          "commerce",
          "venues",
          "kiosk"
        ],
        "url": "/applications/commerce.mdx",
        "last_verified": "2026-04-10"
      },
      {
        "id": "applications/nexus.mdx",
        "title": "Topolo Nexus",
        "summary": "Public overview of Nexus as the platform gateway for metered third-party API usage across Topolo applications.",
        "audience": "public",
        "tags": [
          "ai",
          "gateway",
          "usage",
          "platform"
        ],
        "url": "/applications/nexus.mdx",
        "last_verified": "2026-04-07"
      },
      {
        "id": "applications/pay.mdx",
        "title": "Topolo Pay",
        "summary": "Public overview of the payment worker that handles orders, refunds, and payment operations.",
        "audience": "public",
        "tags": [
          "payments",
          "orders",
          "worker"
        ],
        "url": "/applications/pay.mdx",
        "last_verified": "2026-04-07"
      },
      {
        "id": "applications/one.mdx",
        "title": "TopoloOne",
        "summary": "Public overview of the TopoloOne dashboard, worker-backed growth surfaces, and the public developer-acquisition funnel.",
        "audience": "public",
        "tags": [
          "dashboard",
          "operators",
          "api-keys"
        ],
        "url": "/applications/one.mdx",
        "last_verified": "2026-04-10"
      },
      {
        "id": "applications/social-studio.mdx",
        "title": "Topolo Social Studio",
        "summary": "Public overview of the hybrid desktop and Cloudflare runtime used for AI-assisted social content planning and generation.",
        "audience": "public",
        "tags": [
          "desktop",
          "social",
          "generation",
          "creative"
        ],
        "url": "/applications/social-studio.mdx",
        "last_verified": "2026-04-07"
      },
      {
        "id": "applications/roadmapper.mdx",
        "title": "Topolo Roadmapper",
        "summary": "Public overview of Roadmapper, including AI-assisted project onboarding, durable planning sessions, and stakeholder presentation delivery.",
        "audience": "public",
        "tags": [
          "roadmaps",
          "projects",
          "planning",
          "ai"
        ],
        "url": "/applications/roadmapper.mdx",
        "last_verified": "2026-04-08"
      },
      {
        "id": "applications/socialize.mdx",
        "title": "Socialize",
        "summary": "Public overview of the social publishing platform, brand-scoped resource bindings, and content operations.",
        "audience": "public",
        "tags": [
          "social",
          "publishing",
          "brands"
        ],
        "url": "/applications/socialize.mdx",
        "last_verified": "2026-04-07"
      }
    ],
    "internal": [],
    "runbooks": []
  },
  "authority": {
    "owners": [
      "ai-platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloNexus"
    ],
    "service_ids": [],
    "dependencies": [
      "topolo-auth"
    ],
    "aliases": []
  },
  "interfaces": {
    "contract_type": "curated",
    "contract_source": "PlatformApplications/TopoloNexus/package.json",
    "contract_source_exists": true,
    "openapi": null,
    "readme": {
      "path": "PlatformApplications/TopoloNexus/README.md",
      "intro": [
        "Canonical documentation for Nexus lives in `PlatformApplications/TopoloDocs`.",
        "Use this repository for implementation only. Runtime shape, API contracts, provider policy, deployment behavior, and migration status must be updated in the docs application rather than in repo-local guides."
      ],
      "headings": [
        "Topolo Nexus"
      ],
      "routeHighlights": [],
      "commandHighlights": []
    }
  },
  "auth": {
    "depends_on_topolo_auth": true,
    "api_key_scopes": [],
    "service_permissions": []
  },
  "runtime": {
    "primary_hosts": [],
    "repo_entries": [
      "PlatformApplications/TopoloNexus/README.md",
      "PlatformApplications/TopoloNexus/apps/",
      "PlatformApplications/TopoloNexus/docs/",
      "PlatformApplications/TopoloNexus/infra/",
      "PlatformApplications/TopoloNexus/package-lock.json",
      "PlatformApplications/TopoloNexus/package.json",
      "PlatformApplications/TopoloNexus/packages/",
      "PlatformApplications/TopoloNexus/topolo.cloudcontrol.json"
    ],
    "wrangler_surfaces": [
      {
        "path": "PlatformApplications/TopoloNexus/apps/dashboard/wrangler.toml",
        "observabilityEnabled": false,
        "environments": [],
        "routes": [],
        "vars": [],
        "bindings": [],
        "cronTriggers": [],
        "workerName": "topolo-nexus-dashboard",
        "compatibilityDate": "2026-03-31"
      },
      {
        "path": "PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml",
        "observabilityEnabled": false,
        "environments": [],
        "routes": [],
        "vars": [
          "CORS_ORIGINS",
          "ENVIRONMENT"
        ],
        "bindings": [
          {
            "kind": "d1",
            "binding": "DB",
            "sourcePath": "PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml",
            "target": "61281311-2c2a-4e29-a472-cc448bcace42"
          },
          {
            "kind": "kv",
            "binding": "CACHE",
            "sourcePath": "PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml",
            "target": "c62ad2cee7044d0b868889b3206b8168"
          }
        ],
        "cronTriggers": [],
        "workerName": "topolo-nexus-gateway",
        "main": "src/index.ts",
        "compatibilityDate": "2025-01-01"
      }
    ],
    "packages": [
      {
        "path": "PlatformApplications/TopoloNexus/package.json",
        "name": "topolo-nexus",
        "description": "Topolo AI Gateway - Central AI management, usage tracking, and cost control",
        "scripts": [
          "dev:gateway",
          "dev:dashboard",
          "deploy:gateway",
          "deploy:dashboard",
          "db:migrate",
          "db:migrate:remote"
        ],
        "scriptCommands": [
          {
            "name": "dev:gateway",
            "command": "cd apps/gateway && npm run dev"
          },
          {
            "name": "dev:dashboard",
            "command": "cd apps/dashboard && npm run dev"
          },
          {
            "name": "deploy:gateway",
            "command": "cd apps/gateway && npm run deploy"
          },
          {
            "name": "deploy:dashboard",
            "command": "cd apps/dashboard && npm run deploy"
          },
          {
            "name": "db:migrate",
            "command": "cd apps/gateway && npx wrangler d1 execute nexus-db --file=../../infra/migrations/0001_init.sql"
          },
          {
            "name": "db:migrate:remote",
            "command": "cd apps/gateway && npx wrangler d1 execute nexus-db --remote --file=../../infra/migrations/0001_init.sql"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloNexus/apps/dashboard/package.json",
        "name": "@topolo/nexus-dashboard",
        "scripts": [
          "dev",
          "build",
          "typecheck",
          "preview",
          "deploy"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "vite"
          },
          {
            "name": "build",
            "command": "tsc && vite build"
          },
          {
            "name": "typecheck",
            "command": "tsc --noEmit"
          },
          {
            "name": "preview",
            "command": "vite preview"
          },
          {
            "name": "deploy",
            "command": "npm run build && wrangler pages deploy dist --project-name topolo-nexus-dashboard"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloNexus/apps/gateway/package.json",
        "name": "@topolo/nexus-gateway",
        "scripts": [
          "dev",
          "build",
          "deploy",
          "deploy:dry-run",
          "typecheck",
          "tail"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "wrangler dev"
          },
          {
            "name": "build",
            "command": "tsc --noEmit"
          },
          {
            "name": "deploy",
            "command": "wrangler deploy"
          },
          {
            "name": "deploy:dry-run",
            "command": "wrangler deploy --dry-run --outdir .wrangler/build"
          },
          {
            "name": "typecheck",
            "command": "tsc --noEmit"
          },
          {
            "name": "tail",
            "command": "wrangler tail"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloNexus/packages/nexus-client/package.json",
        "name": "@topolo/nexus-client",
        "description": "Client SDK for Topolo Nexus AI Gateway",
        "scripts": [
          "build",
          "dev"
        ],
        "scriptCommands": [
          {
            "name": "build",
            "command": "tsup src/index.ts --format cjs,esm --dts"
          },
          {
            "name": "dev",
            "command": "tsup src/index.ts --format cjs,esm --dts --watch"
          }
        ]
      }
    ]
  },
  "data": {
    "env_vars": [
      "CORS_ORIGINS",
      "ENVIRONMENT"
    ],
    "bindings": [
      {
        "kind": "d1",
        "binding": "DB",
        "sourcePath": "PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml",
        "target": "61281311-2c2a-4e29-a472-cc448bcace42"
      },
      {
        "kind": "kv",
        "binding": "CACHE",
        "sourcePath": "PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml",
        "target": "c62ad2cee7044d0b868889b3206b8168"
      }
    ],
    "queue_bindings": [],
    "storage_kinds": [
      "d1",
      "kv"
    ],
    "workflow_signals": []
  },
  "deployment": {
    "commands": [
      {
        "name": "deploy:gateway",
        "command": "PlatformApplications/TopoloNexus/package.json :: cd apps/gateway && npm run deploy"
      },
      {
        "name": "deploy:dashboard",
        "command": "PlatformApplications/TopoloNexus/package.json :: cd apps/dashboard && npm run deploy"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloNexus/apps/dashboard/package.json :: tsc && vite build"
      },
      {
        "name": "preview",
        "command": "PlatformApplications/TopoloNexus/apps/dashboard/package.json :: vite preview"
      },
      {
        "name": "deploy",
        "command": "PlatformApplications/TopoloNexus/apps/dashboard/package.json :: npm run build && wrangler pages deploy dist --project-name topolo-nexus-dashboard"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloNexus/apps/gateway/package.json :: tsc --noEmit"
      },
      {
        "name": "deploy",
        "command": "PlatformApplications/TopoloNexus/apps/gateway/package.json :: wrangler deploy"
      },
      {
        "name": "deploy:dry-run",
        "command": "PlatformApplications/TopoloNexus/apps/gateway/package.json :: wrangler deploy --dry-run --outdir .wrangler/build"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloNexus/packages/nexus-client/package.json :: tsup src/index.ts --format cjs,esm --dts"
      }
    ],
    "routes": [],
    "environments": [],
    "assets_directories": [],
    "observability_enabled": false
  },
  "debugging": {
    "failure_modes": [
      "No Auth service ID is registered for this system.",
      "No primary host is registered in the system registry."
    ],
    "entrypoints": [
      "PlatformApplications/TopoloNexus/apps/dashboard/wrangler.toml",
      "PlatformApplications/TopoloNexus/apps/gateway/wrangler.toml",
      "PlatformApplications/TopoloNexus/package.json",
      "PlatformApplications/TopoloNexus/README.md",
      "PlatformApplications/TopoloNexus/apps/dashboard/package.json",
      "PlatformApplications/TopoloNexus/apps/gateway/package.json",
      "PlatformApplications/TopoloNexus/packages/nexus-client/package.json"
    ]
  }
}