Shaun Arman 1de50f1c87 chore: remove all proprietary vendor references for public release

- Delete internal vendor API documentation and handoff docs
- Remove vendor-specific AI gateway URLs from CSP whitelist
- Replace vendor-specific log prefixes and comments with generic 'Custom REST'
- Remove vendor-specific default auth header from custom REST implementation
- Remove vendor-specific client header from HTTP requests
- Remove backward-compat vendor format identifier from is_custom_rest_format()
- Remove LEGACY_API_FORMAT constant and normalizeApiFormat() helper
- Update test to not reference legacy format identifier
- Update wiki docs to use generic enterprise gateway configuration
- Update architecture diagrams and ADR-003 to remove vendor references
- Add Buy Me A Coffee link to README
- Update .gitignore to exclude internal user guide and ticket files

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-07 09:46:25 -05:00

3.8 KiB

Raw Blame History

Troubleshooting and RCA Assistant

Troubleshooting and RCA Assistant 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: — rustfmt · clippy · 64 Rust tests · tsc · vitest — all green

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), Custom REST gateways, local Ollama (fully offline)
Custom Provider Support — Flexible authentication (Bearer, custom headers) and API formats (OpenAI-compatible, Custom REST)
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	Custom REST AI gateway 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 1–8 (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

3.8 KiB Raw Blame History Unescape Escape