Web App Guide

Web App Guide

The web UI is the broadest surface of SourceBridge. It runs at http://localhost:3000 by default (or whatever host you deployed to).

Repositories list (/repositories)

The landing page after sign-in. Shows all indexed repositories with an understanding score, last-indexed timestamp, and symbol count. Use the Add Repository button to register a new repo by git URL or local path. Bulk import (paste a list of URLs) is also supported.

Repository overview (/repositories/[id])

The main working surface for a single repo. Tabs across the top:

Overview tab

• Understanding score — a composite signal derived from index completeness, field-guide coverage, and requirement linkage. The score drives recommendations about what to generate next.
• Cliff notes panel — shows the current repo-level cliff notes if generated, with a Generate button and depth controls (Fast / Medium / Deep).
• Recent activity — latest jobs and generation results for this repo.
• Discoverability callouts — if living-wiki is unconfigured, a callout nudges you to the Settings tab.

Files / Symbols tabs

Browse the repository by file tree or symbol list. Clicking a symbol opens its detail panel with doc summary, location, linked requirements, and CodeLens-style linked field guides.

Requirements tab

Requirements linked to this repository. Create, edit, link, unlink, and soft-delete requirements. Clicking a requirement shows its linked symbols and confidence scores. The Traceability Matrix button opens the full matrix view.

Architecture tab

Generated Mermaid architecture diagrams. Generate triggers a new diagram; the result is rendered inline and can be copied as Mermaid source.

Subsystems tab

Shows subsystem clusters detected by label-propagation over the call graph. Each row has:

• Cluster label (inline-editable; saving fires an LLM rename job)
• Member count
• Top 3 representative symbols as code chips with tooltips
• Cross-cluster "Calls into" adjacency hint

Improve labels triggers a batch rename for the whole repo. Headers are sortable and ARIA-annotated. Requires the subsystem_clustering capability (available on all editions).

Settings tab

Per-repo configuration:

• Knowledge Engine — generation mode defaults, concurrency, model overrides (enterprise)
• Living Wiki — see Living Wiki for the full settings panel walkthrough
• Use with Claude Code — copyable sourcebridge setup claude command with the resolved repo ID

Global settings (/settings/*)

Living wiki (/settings/living-wiki)

Global living-wiki configuration with progressive disclosure. Sections:

• General — enabled toggle, worker count, event timeout
• GitHub — PAT and webhook secret for git_repo and github_wiki sinks
• GitLab — PAT and webhook secret for gitlab_wiki sink
• Confluence — site subdomain, email, API token, webhook secret; Test connection button
• Notion — integration token; Test connection button

Seven secret fields are stored field-level encrypted. The API returns "********" for any set secret — you can replace or clear but never read plaintext back.

LLM configuration (/settings/llm)

Runtime reconfiguration of the LLM provider, model, and MaxConcurrency without a server restart. The panel shows provider-aware recommended concurrency values based on model size and hosting mode.

Admin monitor (/admin)

The LLM job queue with live generation progress, reuse stats (leafHits, fileHits, packageHits, rootHits), a circuit breaker for runaway providers, and the activity feed for living-wiki jobs.

Ask / QA panel

Available from the repository overview and as a standalone page. Type a question; the server-side deep-QA orchestrator runs the agentic retrieval loop and returns an answer with grounded citations. Citations are clickable in the VS Code extension. The panel supports multi-turn conversation via conversation_id.

When the server-side QA is not enabled (SOURCEBRIDGE_QA_SERVER_SIDE_ENABLED=false), the panel shows a CTA to enable it or falls back to the subprocess path.

Change Risk view

Shows the latest impact report for the repository: changed files, affected requirements, stale field guides. The same data is surfaced in the VS Code Change Risk sidebar.

Authentication flows

• Local password — username + password, JWT issued on login
• OIDC — configured via security.oidc.* keys; the web UI redirects to the identity provider and completes the callback

Navigation tips

• The Activity icon in the sidebar shows all running and recent jobs across repos.
• Repository search (Cmd+K on the repositories page) filters by name.
• The status bar at the bottom reflects API health. A red indicator means the API is unreachable.