public active Last verified 2026-04-08

Topolo Roadmapper

Public overview of Roadmapper, including AI-assisted project onboarding, durable planning sessions, and stakeholder presentation delivery.

Owners
product-platform
Source Repos
PlatformApplications/TopoloRoadmapper, PlatformApplications/TopoloDocs
Systems
Topolo Auth, Topolo Nexus, Topolo Roadmapper
Tags
roadmaps, projects, planning, ai

What It Is

Topolo Roadmapper is the project and roadmap planning application in the Topolo portfolio. It organizes work as projects, roadmaps, and nested roadmap items.

Architecture

Roadmapper combines a web application for project planning with a worker-backed API that owns project, roadmap, and roadmap-item persistence.

Runtime Surfaces

  • Roadmapper web application
  • Roadmapper API worker
  • Topolo Auth for identity and tenant scoping

AI Onboarding

Roadmapper now supports an AI-first project creation path on /projects/new.

  • Users can describe the project in chat, clarify goals, timelines, and constraints, and review a generated roadmap hierarchy before anything is written.
  • The generated draft is directly editable before approval so teams can refine names, dates, status, ownership, and nested structure without leaving the flow.
  • Approval creates the project, its roadmaps, and the nested roadmap items in one step.

Planning Sessions

Roadmapper now exposes persisted planning-session endpoints for existing projects. Sessions seed from the live project hierarchy, record revisions over time, support scenario forks, and can apply a revised planning document back into the project structure.

API Surface

The AI onboarding flow adds three protected project endpoints:

  • GET /projects/ai/status returns whether AI onboarding is enabled in the current environment.
  • POST /projects/ai/draft accepts conversation turns plus the current draft and returns { assistantMessage, draft }.
  • POST /projects/ai/apply accepts the approved draft and creates the full hierarchy.

Roadmapper also adds planning-session and presentation endpoints:

  • POST /projects/:id/planning/sessions
  • POST /planning/sessions/:id/turns
  • GET /planning/sessions/:id/revisions
  • POST /planning/sessions/:id/scenarios
  • POST /planning/sessions/:id/apply
  • POST /projects/:id/presentations/generate
  • POST /roadmaps/:id/presentations/generate
  • POST /items/:id/presentations/generate
  • GET /presentations/:id
  • PATCH /presentations/:id
  • POST /presentations/:id/export

Manual project creation through POST /projects remains available and now persists the submitted project status.

API Reference

Roadmapper currently uses curated application documentation plus the system registry entry for route and deployment coverage. The AI onboarding routes live under the /projects API surface.

Structured Draft Contract

The AI draft uses one shared structure across generation, preview, and apply:

  • project with name and optional description
  • roadmaps[] with name, optional description and dates, plus nested items
  • items[] with optional status, priority, dates, assignee, and recursive children

The apply path rejects drafts with invalid date ordering, duplicate roadmap names, more than 10 roadmaps, or more than 250 total items.

Auth and Permissions

Roadmapper relies on Topolo Auth for identity and org scoping. AI onboarding endpoints are protected and operate within the caller’s tenant context.

Data Ownership

Roadmapper owns project, roadmap, and roadmap-item records, including the hierarchy created when an approved AI draft is applied. It now also owns planning sessions, revisions, scenarios, and presentation decks generated from project state.

Presentation Delivery

Roadmapper can now generate stakeholder-ready presentations from live planning state. Each deck is available as a responsive web presentation and can also be exported to PPTX from the same slide specification. Decks include summary copy, metrics, roadmap timeline content, risks, and next actions and remain editable after generation.

Presentation generation is available from:

  • the full project
  • an individual roadmap
  • a roadmap-item branch and its descendants

Guest Sharing

Roadmapper now supports project, roadmap, and roadmap-item guest links. Links can be time-limited or non-expiring and now support two access modes:

  • view for read-only review
  • edit for authenticated guest item edits inside the shared scope

Editable guest links require sign-in so Roadmapper can attribute every item change to a guest identity for logging and audit.

Project and roadmap guest links can optionally allow branch drill-down into child roadmap items. Item guest links always open a dedicated shared branch surface rooted at the selected roadmap item and its descendants.

Invite delivery now uses the Roadmapper API instead of mailto: links. Email invites are sent server-side through Nexus using the Resend provider, and WhatsApp invite composition remains available when the deployment is configured for it.

Project guest links open a dedicated project guest surface where viewers can step from the full project into a roadmap and then into a child branch when navigation permission is enabled. Roadmap and roadmap-item guest views now expose full item titles and descriptions in-page through a guest inspector instead of relying on truncation.

Feature Enablement

AI draft generation now routes through Nexus instead of calling OpenAI directly from the Roadmapper worker.

The AI path is considered enabled when the Roadmapper API can reach Nexus and the current request has auth context that Nexus can verify. If Nexus is unavailable for the current environment, the web app falls back to the manual project creation path.

Deployments

Roadmapper deploys as a web app plus API worker surface. AI draft generation and notification email delivery now depend on Nexus gateway connectivity instead of app-local provider keys.

Failure Modes

  • missing or unreachable Nexus connectivity leaves AI onboarding disabled or unavailable
  • invalid model output causes a server-side repair retry and then a typed failure
  • apply validation blocks malformed or oversized drafts before any writes
  • if apply fails after project creation starts, the worker deletes the new project so partially created roadmaps and items are not left behind
  • planning-session apply can fail if the generated document has no roadmaps or items
  • presentation export depends on the generated deck and the browser-side PPTX export path being available

Debugging

  • confirm GET /projects/ai/status returns enabled: true
  • verify the Roadmapper API can reach the Nexus gateway with the caller’s auth context
  • verify the Roadmapper web app and API are pointed at the same environment
  • inspect the approved draft payload if apply validation rejects the hierarchy

Change Log / Verification

  • Expanded guest sharing on 2026-04-08 with item-level links, view or edit access modes, authenticated guest edits with audit logging, server-side Resend invites, and guest item inspector surfaces for full title and description visibility
  • Tightened the Roadmapper in-app command palette shortcut on 2026-04-08 so Cmd/Ctrl+K no longer intercepts the shared Cmd/Ctrl+Shift+K app-switcher shortcut
  • Added project guest sharing and scoped project, roadmap, or branch presentation generation on 2026-04-07
  • Refreshed the main project, roadmap, item, share, and presentation surfaces on 2026-04-07 to replace the heavy flat card treatment with lighter gradient panels
  • Expanded roadmap guest sharing on 2026-04-07 with non-expiring links, optional child-branch navigation, and invite actions in the share modal
  • Stabilized dependency-overlay registration on 2026-04-07 so timeline/detail views no longer hit a React nested-update loop while rendering dependency bars
  • Verified editable AI draft review, persisted planning sessions, shared timeline rendering, and responsive presentation/PPTX delivery on 2026-04-07
  • Verified against the current AI onboarding, apply semantics, and project-create flow on 2026-03-29