Improve Topolo
Shared contribution and triage surface for Topolo issues, ideas, and product improvements, backed by BugFix AI analysis and pull-request automation.
Documentation Map
What It Is
Shared contribution and triage surface for Topolo issues, ideas, and product improvements, backed by BugFix AI analysis and pull-request automation.
Architecture
Owners: ai-platform
Source repos: apps/system/TopoloBugFix, apps/system/TopoloBugFixRunner
Dependencies: topolo-auth, topolo-nexus
Repo shape
No repo surface entries were detected from the registered repo paths.
Runtime Surfaces
Hosts:
https://bugfix.topolo.app https://bugfix.stg.topolo.us No wrangler surface was discovered under the registered repo paths.
API Reference
Coverage: curated
Source: PlatformApplications/TopoloBugFix
Source exists in repo: no
The public shared-shell surface is Improve Topolo. It posts contribution payloads to the existing BugFix report API, then BugFix owns triage state, AI-assisted fix generation, validation, and GitHub pull-request workflow records. Runtime service identity resolves from the Auth-owned service slug topolo-bugfix instead of checked-in concrete srv_* ids. InternalApplications/TopoloBugFixRunner is the internal execution companion for BugFix automation and is covered by this system record.
App API page: /reference/apps/topolo-bugfix
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_kQ1t8qUSDgNs API key scopes
Administer Improve Topolo issue and automated fix operations
Resource pattern: none
View reported bugs and their triage state
Resource pattern: none
File and update bug reports
Resource pattern: none
Invoke automated bug-fix runs
Resource pattern: none
Service permissions
bugfix:admin, issues:read, issues:write, runs:invoke
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/TopoloBugFix
- Neither OpenAPI nor README-derived interface detail was found.
Debugging Runbooks
Start with these entrypoints:
- PlatformApplications/TopoloBugFix
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.