application public active Verified 2026-05-14

Topolo Roadmapper

Roadmap and project management application in the Topolo portfolio with AI onboarding, scoped project-chat planning sessions, hierarchy-wide guest sharing and guest edit auditability, and narrative presentation delivery.

Documentation Map

What It Is

Architecture

Owners: product-platform

Source repos:

Dependencies: topolo-auth, topolo-nexus, topolo-notify, applications-packages

Repo shape

No repo surface entries were detected from the registered repo paths.

Runtime Surfaces

Hosts:

https://roadmapper.topolo.app https://roadmapper-api.topolo.app https://roadmapper-api.stg.topolo.us https://roadmapper.stg.topolo.us

No wrangler surface was discovered under the registered repo paths.

API Reference

Coverage: curated

Source: PlatformApplications/TopoloRoadmapper/package.json

Source exists in repo: no

Current contract coverage is curated rather than OpenAPI-backed, and the browser launcher lane now reads Auth-owned catalog data through same-origin /api/auth/* on the Roadmapper host using the current Auth organization and active context. Browser preboot, shared browser auth, API worker Auth validation, widget output, API-key management, TopoloNotify emission, and staging seed validation resolve concrete service ids from Auth service slugs such as `topolo-roadmapper` at runtime instead of carrying concrete service ids in source, Worker vars, build commands, or browser assets. The browser login handoff, embedded password-login surface, and Auth SSO one-time sso_code callback redemption delegate to the shared Topolo auth client, direct bearer-token callback URLs or /sso?token= bridge routes are not supported, Roadmapper keeps same-tab sessionStorage access-token restore enabled by default after login and refresh so normal reloads do not appear logged out before cookie refresh completes, Roadmapper's vendored @topolo/ui-kit snapshot must stay synchronized with the canonical platform package, the API worker now exposes authenticated `GET /api/widget` for TopoloOne live workspace, emits generic `application.notification.created` envelopes through TopoloNotify after successful creation writes, and protected API routes now require Topolo Auth validation plus a validated organization context with no Roadmapper-local JWT secret handoff or vendored local HS256 verifier.

App API page: /reference/apps/topolo-roadmapper

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

srv_I0z_mOMxdFVa

API key scopes

api_keys.write

Manage Roadmapper machine credentials

Resource pattern: none

projects.read

View product initiatives and projects

Resource pattern: none

projects.write

Create and manage projects

Resource pattern: none

reports.read

View roadmap reports

Resource pattern: none

reports.write

Manage roadmap reports

Resource pattern: none

roadmaps.read

View roadmaps

Resource pattern: none

roadmaps.write

Create and manage roadmaps

Resource pattern: none

settings.read

View Roadmapper settings

Resource pattern: none

settings.write

Manage Roadmapper settings

Resource pattern: none

Service permissions

api_keys:write, projects:read, projects:write, reports:read, reports:write, roadmaps:read, roadmaps:write, settings:read, settings:write

Data Ownership

No storage bindings were derived from wrangler configuration.

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

No environment variables were derived from wrangler configuration.

All wrangler bindings

No bindings were derived from wrangler configuration.

Deployments

Deployment environments: default only or not declared

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Failure Modes

No wrangler.toml surface was discovered under the registered repo paths.
The registered contract source is missing: PlatformApplications/TopoloRoadmapper/package.json
Neither OpenAPI nor README-derived interface detail was found.

Debugging Runbooks

Start with these entrypoints:

PlatformApplications/TopoloRoadmapper/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-05-14

Any code change to this system is expected to update the canonical docs in PlatformApplications/TopoloDocs and refresh the verification date.