How ashmitsherigar/trustnofile works
TrustNoFile is a web application for safely inspecting untrusted uploads and producing explainable risk reports. Users upload a file, the backend validates and stores it, static-analysis modules collect evidence, and an orchestrator assesses risk and records a report; the UI exposes progress, history, reports, and JSON export. Optional integrations add Gemini review and isolated ELF sandboxing. The graph preserves these documented capabilities, but some unsampled subsystem links are omitted rather than inferred.
Main entry points: analysis-orchestrator.service.js Analysis workflow · api.js API client · App.jsx Workspace routes · app.js API assembly
Components 26
User interface
- Workspace routes
frontend/src/App.jsx - Upload screen
frontend/src/pages/Analyze.jsx - Analysis progress
frontend/src/pages/AnalysisProgress.jsx - History
frontend/src/pages/History.jsx - Report view
frontend/src/pages/Report.jsx - Overview
frontend/src/pages/Overview.jsx - API client
frontend/src/services/api.js - Session auth
frontend/src/services/auth.js
HTTP and workflow
- File routes
backend/src/routes/files.routes.js - Analysis routes
backend/src/routes/analysis.routes.js - API assembly
backend/src/app.js - Upload and validation
backend/src/services/upload.service.js - Analysis API
backend/src/controllers/analysis.controller.js
File analysis
- Analysis workflow
backend/src/services/analysis-orchestrator.service.js - Evidence aggregation
backend/src/analysis/evidence-aggregator.js - Archive inspection
backend/src/analysis/archive-inspection.js - Metadata extraction
backend/src/analysis/metadata.js - Risk assessment
backend/src/services/risk-assessment.service.js - Report building
backend/src/services/report.service.js - Analysis states
backend/src/services/analysis-states.js
Persistence and integrations
- Analysis repositories
backend/src/repositories - File storage adapters
backend/src/integrations/storage - LLM integration
backend/src/integrations/llm - ELF sandbox
backend/src/integrations/sandbox - Sandbox worker
backend/src/sandbox-worker/server.js
Other components
- Analyst
Connections 32
- Analyst → Workspace routes: uses
frontend/src/App.jsx - Workspace routes → Upload screen: routes to
frontend/src/App.jsx - Workspace routes → Analysis progress: routes to
frontend/src/App.jsx - Workspace routes → History: routes to
frontend/src/App.jsx - Workspace routes → Report view: routes to
frontend/src/App.jsx - Workspace routes → Overview: routes to
frontend/src/App.jsx - Upload screen → API client: requests
frontend/src/services/api.js - Analysis progress → API client: requests
frontend/src/pages/AnalysisProgress.jsx - History → API client: requests
frontend/src/pages/History.jsx - Report view → API client: requests
frontend/src/pages/Report.jsx - Overview → API client: requests
frontend/src/pages/Overview.jsx - API client → Session auth: gets token
frontend/src/services/api.js - API client → File routes: uploads and manages
frontend/src/services/api.js - API client → Analysis routes: requests reports
frontend/src/services/api.js - API assembly → File routes: mounts
backend/src/app.js - API assembly → Analysis routes: mounts
backend/src/app.js - File routes → Upload and validation: dispatches upload
backend/src/routes/files.routes.js - File routes → Analysis API: dispatches analysis
backend/src/routes/files.routes.js - Analysis routes → Analysis API: routes requests
- API assembly → Analysis workflow: creates
backend/src/app.js - Analysis API → Analysis workflow: starts job
backend/src/controllers/analysis.controller.js - Analysis workflow → Evidence aggregation: runs static analysis
backend/src/services/analysis-orchestrator.service.js - Evidence aggregation → Archive inspection: inspects archives
backend/src/analysis/evidence-aggregator.js - Evidence aggregation → Metadata extraction: extracts metadata
backend/src/analysis/evidence-aggregator.js - Analysis workflow → Risk assessment: assesses evidence
backend/src/services/analysis-orchestrator.service.js - Analysis workflow → Report building: builds report
backend/src/services/analysis-orchestrator.service.js - Analysis workflow → Analysis states: transitions status
backend/src/services/analysis-orchestrator.service.js - API assembly → Analysis repositories: configures
backend/src/app.js - Upload and validation → File storage adapters: stores upload
- Analysis workflow → LLM integration: optional review
backend/src/services/analysis-orchestrator.service.js - Analysis workflow → ELF sandbox: optional execution
- Sandbox worker → ELF sandbox: runs isolated ELF
backend/src/sandbox-worker/server.js