{
  "generated_at": "2026-04-10T10:31:25.583Z",
  "system": {
    "id": "topolo-roadmapper",
    "name": "Topolo Roadmapper",
    "slug": "topolo-roadmapper",
    "kind": "application",
    "summary": "Roadmap and project management application in the Topolo portfolio with AI planning sessions, hierarchy-wide guest sharing and guest edit auditability, and narrative presentation delivery.",
    "aliases": [],
    "lifecycle": "active",
    "last_verified": "2026-04-09",
    "owners": [
      "product-platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloRoadmapper"
    ],
    "service_ids": [
      "srv_I0z_mOMxdFVa"
    ],
    "visibility": "public",
    "api_contract": {
      "type": "curated",
      "source": "PlatformApplications/TopoloRoadmapper/package.json",
      "notes": "Current contract coverage is curated rather than OpenAPI-backed."
    },
    "primary_hosts": [],
    "doc_paths": [
      "applications/roadmapper",
      "internal/apps/roadmapper"
    ],
    "dependencies": [
      "topolo-auth",
      "topolo-nexus"
    ],
    "public_hub_url": "/systems/topolo-roadmapper",
    "internal_hub_url": null,
    "application_api_url": "/reference/apps/topolo-roadmapper",
    "generated_openapi_url": null,
    "machine_urls": {
      "system": "/machine/systems/topolo-roadmapper.json",
      "application": "/machine/applications/topolo-roadmapper.json"
    }
  },
  "docs": {
    "public": [
      {
        "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"
      }
    ],
    "internal": [],
    "runbooks": []
  },
  "authority": {
    "owners": [
      "product-platform"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloRoadmapper"
    ],
    "service_ids": [
      "srv_I0z_mOMxdFVa"
    ],
    "dependencies": [
      "topolo-auth",
      "topolo-nexus"
    ],
    "aliases": []
  },
  "interfaces": {
    "contract_type": "curated",
    "contract_source": "PlatformApplications/TopoloRoadmapper/package.json",
    "contract_source_exists": true,
    "openapi": null,
    "readme": {
      "path": "PlatformApplications/TopoloRoadmapper/README.md",
      "intro": [
        "Canonical documentation for Roadmapper lives in `PlatformApplications/TopoloDocs`.",
        "Use this repository for implementation only. Product flows, AI onboarding behavior, notification delivery boundaries, deployment guidance, and operational details are canonical in the docs application rather than in repo-local markdown."
      ],
      "headings": [
        "Topolo Roadmapper"
      ],
      "routeHighlights": [],
      "commandHighlights": []
    }
  },
  "auth": {
    "depends_on_topolo_auth": true,
    "api_key_scopes": [
      {
        "name": "projects.read",
        "description": "View product initiatives and projects",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "projects.write",
        "description": "Create and manage projects",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "roadmaps.read",
        "description": "View roadmaps",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "roadmaps.write",
        "description": "Create and manage roadmaps",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "reports.read",
        "description": "View roadmap reports",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "reports.write",
        "description": "Manage roadmap reports",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "settings.read",
        "description": "View Roadmapper settings",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "settings.write",
        "description": "Manage Roadmapper settings",
        "resourcePattern": null,
        "kind": "api_key_scope"
      }
    ],
    "service_permissions": []
  },
  "runtime": {
    "primary_hosts": [],
    "repo_entries": [
      "PlatformApplications/TopoloRoadmapper/README.md",
      "PlatformApplications/TopoloRoadmapper/apps/",
      "PlatformApplications/TopoloRoadmapper/docs/",
      "PlatformApplications/TopoloRoadmapper/package.json",
      "PlatformApplications/TopoloRoadmapper/packages/",
      "PlatformApplications/TopoloRoadmapper/pnpm-lock.yaml",
      "PlatformApplications/TopoloRoadmapper/pnpm-workspace.yaml",
      "PlatformApplications/TopoloRoadmapper/scripts/",
      "PlatformApplications/TopoloRoadmapper/topolo.cloudcontrol.json"
    ],
    "wrangler_surfaces": [
      {
        "path": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "observabilityEnabled": false,
        "environments": [
          "dev",
          "staging"
        ],
        "routes": [],
        "vars": [
          "ENVIRONMENT",
          "FRONTEND_URL",
          "SERVICE_ID",
          "SKIP_AUTH",
          "TOPOLO_AUTH_API_URL",
          "route"
        ],
        "bindings": [
          {
            "kind": "d1",
            "binding": "DB",
            "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
            "target": "e241800d-ea5b-463e-9b87-9fe8b4890f35"
          },
          {
            "kind": "queue",
            "binding": "NOTIFICATION_QUEUE",
            "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
            "target": "topolo-prod-queue-notifications"
          },
          {
            "kind": "r2",
            "binding": "ATTACHMENTS_BUCKET",
            "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
            "target": "roadmapper-prod-attachments"
          },
          {
            "kind": "d1",
            "binding": "DB",
            "environment": "staging",
            "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
            "target": "85cce97a-5af2-47d6-aeb8-f8ed7f6169e1"
          },
          {
            "kind": "d1",
            "binding": "DB",
            "environment": "dev",
            "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
            "target": "85cce97a-5af2-47d6-aeb8-f8ed7f6169e1"
          },
          {
            "kind": "queue",
            "binding": "NOTIFICATION_QUEUE",
            "environment": "dev",
            "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
            "target": "topolo-dev-queue-notifications"
          },
          {
            "kind": "r2",
            "binding": "ATTACHMENTS_BUCKET",
            "environment": "dev",
            "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
            "target": "roadmapper-dev-attachments"
          },
          {
            "kind": "queue",
            "binding": "NOTIFICATION_QUEUE",
            "environment": "staging",
            "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
            "target": "topolo-staging-queue-notifications"
          },
          {
            "kind": "r2",
            "binding": "ATTACHMENTS_BUCKET",
            "environment": "staging",
            "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
            "target": "roadmapper-staging-attachments"
          }
        ],
        "cronTriggers": [],
        "workerName": "topolo-production-roadmapper",
        "main": "src/index.ts",
        "compatibilityDate": "2024-12-01"
      },
      {
        "path": "PlatformApplications/TopoloRoadmapper/apps/web/wrangler.toml",
        "observabilityEnabled": false,
        "environments": [],
        "routes": [],
        "vars": [],
        "bindings": [],
        "cronTriggers": [],
        "workerName": "roadmapper",
        "compatibilityDate": "2026-03-31"
      }
    ],
    "packages": [
      {
        "path": "PlatformApplications/TopoloRoadmapper/package.json",
        "name": "topolo-roadmapper",
        "description": "Topolo Roadmapper - Project and roadmap management tool",
        "scripts": [
          "dev",
          "build",
          "deploy:api",
          "deploy:web",
          "sync:platform-standardization",
          "sync:platform-standardization:apply"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "concurrently \"pnpm -C apps/api run dev\" \"pnpm -C apps/web run dev\""
          },
          {
            "name": "build",
            "command": "pnpm -r run build"
          },
          {
            "name": "deploy:api",
            "command": "pnpm -C apps/api run deploy"
          },
          {
            "name": "deploy:web",
            "command": "pnpm -C apps/web run build && pnpm -C apps/web run deploy"
          },
          {
            "name": "sync:platform-standardization",
            "command": "node scripts/import-topolo-platform-standardization-program.mjs"
          },
          {
            "name": "sync:platform-standardization:apply",
            "command": "node scripts/import-topolo-platform-standardization-program.mjs --apply"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloRoadmapper/apps/api/package.json",
        "name": "topolo-api",
        "scripts": [
          "dev",
          "deploy",
          "deploy:dry-run",
          "typecheck",
          "test",
          "build"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "wrangler dev --env dev --x-remote-bindings"
          },
          {
            "name": "deploy",
            "command": "wrangler deploy"
          },
          {
            "name": "deploy:dry-run",
            "command": "wrangler deploy --dry-run --config wrangler.toml"
          },
          {
            "name": "typecheck",
            "command": "tsc --noEmit"
          },
          {
            "name": "test",
            "command": "vitest run"
          },
          {
            "name": "build",
            "command": "tsc --noEmit"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloRoadmapper/apps/web/package.json",
        "name": "@roadmapper/web",
        "scripts": [
          "prebuild",
          "build",
          "deploy",
          "dev",
          "preview",
          "clean",
          "typecheck",
          "test"
        ],
        "scriptCommands": [
          {
            "name": "prebuild",
            "command": "pnpm -C ../../packages/ui install --frozen-lockfile=false && pnpm -C ../../packages/ui run build"
          },
          {
            "name": "build",
            "command": "vite build"
          },
          {
            "name": "deploy",
            "command": "pnpm run build && npx wrangler pages deploy dist --project-name roadmapper"
          },
          {
            "name": "dev",
            "command": "vite"
          },
          {
            "name": "preview",
            "command": "vite preview"
          },
          {
            "name": "clean",
            "command": "rm -rf dist"
          },
          {
            "name": "typecheck",
            "command": "tsc --noEmit"
          },
          {
            "name": "test",
            "command": "vitest"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloRoadmapper/packages/domain/package.json",
        "name": "@topolo/domain",
        "scripts": [
          "build",
          "dev",
          "clean",
          "test"
        ],
        "scriptCommands": [
          {
            "name": "build",
            "command": "pnpm exec tsc --project tsconfig.json"
          },
          {
            "name": "dev",
            "command": "tsc --watch"
          },
          {
            "name": "clean",
            "command": "rm -rf dist"
          },
          {
            "name": "test",
            "command": "vitest"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloRoadmapper/packages/infra/package.json",
        "name": "@topolo/infra",
        "description": "Infrastructure layer for Topolo Roadmapper - Database repositories, external adapters, and Cloudflare bindings",
        "scripts": [
          "build",
          "dev",
          "clean",
          "typecheck"
        ],
        "scriptCommands": [
          {
            "name": "build",
            "command": "npx tsc --project tsconfig.json"
          },
          {
            "name": "dev",
            "command": "tsc --watch"
          },
          {
            "name": "clean",
            "command": "rm -rf dist"
          },
          {
            "name": "typecheck",
            "command": "tsc --noEmit"
          }
        ]
      }
    ]
  },
  "data": {
    "env_vars": [
      "ENVIRONMENT",
      "FRONTEND_URL",
      "SERVICE_ID",
      "SKIP_AUTH",
      "TOPOLO_AUTH_API_URL",
      "route"
    ],
    "bindings": [
      {
        "kind": "d1",
        "binding": "DB",
        "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "target": "e241800d-ea5b-463e-9b87-9fe8b4890f35"
      },
      {
        "kind": "r2",
        "binding": "ATTACHMENTS_BUCKET",
        "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "target": "roadmapper-prod-attachments"
      },
      {
        "kind": "d1",
        "binding": "DB",
        "environment": "staging",
        "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "target": "85cce97a-5af2-47d6-aeb8-f8ed7f6169e1"
      },
      {
        "kind": "d1",
        "binding": "DB",
        "environment": "dev",
        "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "target": "85cce97a-5af2-47d6-aeb8-f8ed7f6169e1"
      },
      {
        "kind": "r2",
        "binding": "ATTACHMENTS_BUCKET",
        "environment": "dev",
        "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "target": "roadmapper-dev-attachments"
      },
      {
        "kind": "r2",
        "binding": "ATTACHMENTS_BUCKET",
        "environment": "staging",
        "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "target": "roadmapper-staging-attachments"
      }
    ],
    "queue_bindings": [
      {
        "kind": "queue",
        "binding": "NOTIFICATION_QUEUE",
        "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "target": "topolo-prod-queue-notifications"
      },
      {
        "kind": "queue",
        "binding": "NOTIFICATION_QUEUE",
        "environment": "dev",
        "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "target": "topolo-dev-queue-notifications"
      },
      {
        "kind": "queue",
        "binding": "NOTIFICATION_QUEUE",
        "environment": "staging",
        "sourcePath": "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
        "target": "topolo-staging-queue-notifications"
      }
    ],
    "storage_kinds": [
      "d1",
      "r2"
    ],
    "workflow_signals": [
      "NOTIFICATION_QUEUE -> topolo-prod-queue-notifications",
      "NOTIFICATION_QUEUE -> topolo-dev-queue-notifications",
      "NOTIFICATION_QUEUE -> topolo-staging-queue-notifications"
    ]
  },
  "deployment": {
    "commands": [
      {
        "name": "build",
        "command": "PlatformApplications/TopoloRoadmapper/package.json :: pnpm -r run build"
      },
      {
        "name": "deploy:api",
        "command": "PlatformApplications/TopoloRoadmapper/package.json :: pnpm -C apps/api run deploy"
      },
      {
        "name": "deploy:web",
        "command": "PlatformApplications/TopoloRoadmapper/package.json :: pnpm -C apps/web run build && pnpm -C apps/web run deploy"
      },
      {
        "name": "deploy",
        "command": "PlatformApplications/TopoloRoadmapper/apps/api/package.json :: wrangler deploy"
      },
      {
        "name": "deploy:dry-run",
        "command": "PlatformApplications/TopoloRoadmapper/apps/api/package.json :: wrangler deploy --dry-run --config wrangler.toml"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloRoadmapper/apps/api/package.json :: tsc --noEmit"
      },
      {
        "name": "prebuild",
        "command": "PlatformApplications/TopoloRoadmapper/apps/web/package.json :: pnpm -C ../../packages/ui install --frozen-lockfile=false && pnpm -C ../../packages/ui run build"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloRoadmapper/apps/web/package.json :: vite build"
      },
      {
        "name": "deploy",
        "command": "PlatformApplications/TopoloRoadmapper/apps/web/package.json :: pnpm run build && npx wrangler pages deploy dist --project-name roadmapper"
      },
      {
        "name": "preview",
        "command": "PlatformApplications/TopoloRoadmapper/apps/web/package.json :: vite preview"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloRoadmapper/packages/domain/package.json :: pnpm exec tsc --project tsconfig.json"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloRoadmapper/packages/infra/package.json :: npx tsc --project tsconfig.json"
      }
    ],
    "routes": [],
    "environments": [
      "dev",
      "staging"
    ],
    "assets_directories": [],
    "observability_enabled": false
  },
  "debugging": {
    "failure_modes": [
      "No primary host is registered in the system registry."
    ],
    "entrypoints": [
      "PlatformApplications/TopoloRoadmapper/apps/api/wrangler.toml",
      "PlatformApplications/TopoloRoadmapper/apps/web/wrangler.toml",
      "PlatformApplications/TopoloRoadmapper/package.json",
      "PlatformApplications/TopoloRoadmapper/README.md",
      "PlatformApplications/TopoloRoadmapper/apps/api/package.json",
      "PlatformApplications/TopoloRoadmapper/apps/web/package.json",
      "PlatformApplications/TopoloRoadmapper/packages/domain/package.json",
      "PlatformApplications/TopoloRoadmapper/packages/infra/package.json"
    ]
  }
}