KOS — FRD: Chat UI & Connectors¶

Parent: KOS PRD
Owner: Digital Office
Status: Phase 1b

Chat UI¶

Conversational interface built on Chainlit. Always uses synthesised mode.

Phase 1 (fast): Raw retrieval completes. Citations displayed immediately.
Phase 2 (async): LLM synthesis streams. Prose answer replaces/supplements citations.

Password-protected via KOS_CHAT_PASSWORD. Single shared password for the team.

The Ollama LLM understands Urdu, Bengali, Arabic, and English. No explicit translation step required for queries.

On session start, the Ollama model is preloaded to avoid cold-start latency on first query.

The welcome message indicates whether a compiled wiki is available and how many pages it contains.

Connector	Protocol	Auth	Documents Ingested
Confluence	REST API v2	Basic	Wiki pages, ADRs, standards, schemas, playbooks
Slack	Conversations API	Bot token	Messages, threads
Bitbucket	REST API 2.0	Basic	READMEs
Git repos	Filesystem	None	Standards, ADRs, schemas, OpenAPI specs
Filesystem	Filesystem	None	Markdown, PDFs, SurrealDB schemas
Jira	REST API v3	Basic	Issues, epics, stories
SharePoint/OneDrive	Microsoft Graph	OAuth2 client credentials	Documents, wiki pages

The WikiCompiler generates a static markdown knowledge base from graph facts.

wiki/
  jurisdictions/{slug}.md
  systems/{slug}.md
  standards/{slug}.md

Each page renders authority badges (canonical / approved / documented / discussion).

Compilation is batch — not incremental. Run: uv run python -m kos.compilation

Compiler generates mkdocs.yml for a browsable MkDocs Material site.