tftsr-devops_investigation/docs/wiki/Home.md
Shaun Arman 5f9798a4fd docs: update wiki for v0.2.6 - integrations and Custom REST provider
Updated 5 wiki pages:

Home.md:
- Updated version to v0.2.6
- Added Custom REST provider and custom provider support to features
- Updated integration status from stubs to complete
- Updated release table with v0.2.3 and v0.2.6 highlights

Integrations.md:
- Complete rewrite: Changed from 'v0.2 stubs' to fully implemented
- Added detailed docs for Confluence REST API client (6 tests)
- Added detailed docs for ServiceNow REST API client (7 tests)
- Added detailed docs for Azure DevOps REST API client (6 tests)
- Documented OAuth2 PKCE flow implementation
- Added database schema for credentials and integration_config tables
- Added troubleshooting section with common OAuth/API errors

AI-Providers.md:
- Added section for Custom Provider (Custom REST provider)
- Documented Custom REST provider API format differences from OpenAI
- Added request/response format examples
- Added configuration instructions and troubleshooting
- Documented custom provider fields (api_format, custom_endpoint_path, etc)
- Added available Custom REST provider models list

IPC-Commands.md:
- Replaced 'v0.2 stubs' section with full implementation details
- Added OAuth2 commands (initiate_oauth, handle_oauth_callback)
- Added Confluence commands (5 functions)
- Added ServiceNow commands (5 functions)
- Added Azure DevOps commands (5 functions)
- Documented authentication storage with AES-256-GCM encryption
- Added common types (ConnectionResult, PublishResult, TicketResult)

Database.md:
- Updated migration count from 10 to 11
- Added migration 011: credentials and integration_config tables
- Documented AES-256-GCM encryption for OAuth tokens
- Added usage notes for OAuth2 vs basic auth storage
2026-04-03 16:39:49 -05:00

3.8 KiB
Raw Blame History

TFTSR — IT Triage & RCA Desktop Application

TFTSR is a secure desktop application for guided IT incident triage, root cause analysis (RCA), and post-mortem documentation. Built with Tauri 2.x (Rust + WebView) and React 18.

CI: build — rustfmt · clippy · 64 Rust tests · tsc · vitest — all green

Quick Navigation

Topic Description
Architecture Backend, frontend, and data flow
Development Setup Prerequisites, commands, environment
Database Schema, migrations, encryption
AI Providers Supported providers and configuration
LiteLLM + Bedrock Setup AWS Bedrock integration via LiteLLM proxy
PII Detection Patterns, redaction flow, security
IPC Commands Full list of Tauri backend commands
CI/CD Pipeline Gitea Actions setup, multi-platform builds, act_runner config
Security Model Encryption, audit trail, capabilities
Integrations Confluence, ServiceNow, Azure DevOps (v0.2)
Troubleshooting Known issues and fixes

Key Features

  • 5-Whys AI Triage — Interactive guided root cause analysis via multi-turn AI chat
  • PII Auto-Redaction — Detects and redacts sensitive data before any AI send
  • Multi-Provider AI — OpenAI, Anthropic Claude, Google Gemini, Mistral, AWS Bedrock (via LiteLLM), MSI GenAI (Motorola internal), local Ollama (fully offline)
  • Custom Provider Support — Flexible authentication (Bearer, custom headers) and API formats (OpenAI-compatible, MSI GenAI)
  • External Integrations — Confluence, ServiceNow, Azure DevOps with OAuth2 PKCE flows
  • SQLCipher AES-256 — All issue history and credentials encrypted at rest
  • RCA + Post-Mortem Generation — Auto-populated Markdown templates, exportable as MD/PDF
  • Ollama Management — Hardware detection, model recommendations, in-app model management
  • Audit Trail — Every external data send logged with SHA-256 hash
  • Domain-Specific Prompts — 8 IT domains: Linux, Windows, Network, Kubernetes, Databases, Virtualization, Hardware, Observability

Releases

Version Status Highlights
v0.2.6 🚀 Latest MSI GenAI support, OAuth2 shell permissions, user ID tracking
v0.2.3 Released Confluence/ServiceNow/ADO REST API clients (19 TDD tests)
v0.1.1 Released Core application with PII detection, RCA generation

Platforms: linux/amd64 · linux/arm64 · windows/amd64 (.deb, .rpm, .AppImage, .exe, .msi)

Download from Releases. All builds are produced natively (no QEMU emulation).

Project Status

Phase Status
Phases 18 (Core application) Complete
Phase 9 (History/Search) 🔲 Pending
Phase 10 (Integrations) Complete — Confluence, ServiceNow, Azure DevOps fully implemented with OAuth2
Phase 11 (CI/CD) Complete — Gitea Actions fully operational
Phase 12 (Release packaging) linux/amd64 · linux/arm64 (native) · windows/amd64

Tech Stack

Layer Technology
Desktop framework Tauri 2.x
Backend Rust (async/await, tokio)
Frontend React 18 + TypeScript + Vite
Styling Tailwind CSS + custom components
Database rusqlite + SQLCipher (AES-256)
Secret storage tauri-plugin-stronghold
State Zustand
Testing Vitest (13 frontend) + #[cfg(test)] (64 Rust tests)
CI/CD Gitea Actions (act_runner v0.3.1) + Gitea