sarman/tftsr-devops_investigation
1
1
Fork 0
Code Issues 4 Pull Requests Actions 34 Packages Projects 3 Releases 6 Wiki Activity
093495a653
tftsr-devops_investigation/docs/wiki/Home.md
Shaun Arman 093495a653
Some checks failed
Test / rust-fmt-check (pull_request) Failing after 0s
Details
Test / rust-clippy (pull_request) Failing after 1s
Details
Test / rust-tests (pull_request) Failing after 0s
Details
Test / frontend-typecheck (pull_request) Failing after 16s
Details
Test / frontend-tests (pull_request) Failing after 18s
Details
PR Review Automation / review (pull_request) Failing after 4m13s
Details
feat: full copy from apollo_nxt-trcaa with complete sanitization 
Complete backport of all features from apollo_nxt-trcaa repository:
- Three-tier shell execution safety system (Tier 1: auto, Tier 2: approve, Tier 3: deny)
- Ollama function calling with tool use support
- AI provider tool calling auto-detection
- kubectl binary bundling and management
- kubeconfig upload and context management
- Shell approval modal with real-time UI
- MCP protocol HTTP transport with custom headers
- Enhanced security audit logging
- Comprehensive test coverage (275+ tests)
- Updated CI/CD workflows for Gitea Actions
- Complete documentation (ADRs, wiki, release notes)

Sanitization applied to all files:
- Removed all MSI, Motorola, VNXT, Vesta references
- Replaced internal infrastructure references with TFTSR equivalents
- Updated all URLs and API endpoints
- Sanitized commit history references in documentation

Technical changes:
- New modules: shell/classifier, shell/executor, shell/kubectl, shell/kubeconfig
- Enhanced AI providers: ollama.rs, openai.rs with function calling
- New Tauri commands: shell execution, kubeconfig management, tool calling detection
- Database migrations: shell_execution_audit table
- Frontend: ShellApprovalModal, ShellExecution, KubeconfigManager pages
- CI/CD: kubectl bundling, multi-platform builds, Gitea Actions integration

Version: 1.0.8

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-06-05 14:12:43 -05:00

4.0 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: 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), 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
  • Image Attachments — Upload and manage image files with PII detection and mandatory user approval

Releases

Version Status Highlights
v0.2.6 🚀 Latest Custom REST AI gateway support, OAuth2 shell permissions, user ID tracking
v0.2.5 Released Image attachments with PII detection and approval workflow
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