tftsr-devops_investigation/node_modules/filelist/README.md
Shaun Arman 8839075805 feat: initial implementation of TFTSR IT Triage & RCA application
Implements Phases 1-8 of the TFTSR implementation plan.

Rust backend (Tauri 2.x, src-tauri/):
- Multi-provider AI: OpenAI-compatible, Anthropic, Gemini, Mistral, Ollama
- PII detection engine: 11 regex patterns with overlap resolution
- SQLCipher AES-256 encrypted database with 10 versioned migrations
- 28 Tauri IPC commands for triage, analysis, document, and system ops
- Ollama: hardware probe, model recommendations, pull/delete with events
- RCA and blameless post-mortem Markdown document generators
- PDF export via printpdf
- Audit log: SHA-256 hash of every external data send
- Integration stubs for Confluence, ServiceNow, Azure DevOps (v0.2)

Frontend (React 18 + TypeScript + Vite, src/):
- 9 pages: full triage workflow NewIssue→LogUpload→Triage→Resolution→RCA→Postmortem→History+Settings
- 7 components: ChatWindow, TriageProgress, PiiDiffViewer, DocEditor, HardwareReport, ModelSelector, UI primitives
- 3 Zustand stores: session, settings (persisted), history
- Type-safe tauriCommands.ts matching Rust backend types exactly
- 8 IT domain system prompts (Linux, Windows, Network, K8s, DB, Virt, HW, Obs)

DevOps:
- .woodpecker/test.yml: rustfmt, clippy, cargo test, tsc, vitest on every push
- .woodpecker/release.yml: linux/amd64 + linux/arm64 builds, Gogs release upload

Verified:
- cargo check: zero errors
- tsc --noEmit: zero errors
- vitest run: 13/13 unit tests passing

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 22:36:25 -05:00

2.1 KiB

FileList

A FileList is a lazy-evaluated list of files. When given a list of glob patterns for possible files to be included in the file list, instead of searching the file structures to find the files, a FileList holds the pattern for latter use.

This allows you to define a FileList to match any number of files, but only search out the actual files when then FileList itself is actually used. The key is that the first time an element of the FileList/Array is requested, the pending patterns are resolved into a real list of file names.

Usage

Add files to the list with the include method. You can add glob patterns, individual files, or RegExp objects. When the Array methods are invoked on the FileList, these items are resolved to an actual list of files.

var fl = new FileList();
fl.include('test/*.js');
fl.exclude('test/helpers.js');

Use the exclude method to override inclusions. You can use this when your inclusions are too broad.

Array methods

FileList has lazy-evaluated versions of most of the array methods, including the following:

  • join
  • pop
  • push
  • concat
  • reverse
  • shift
  • unshift
  • slice
  • splice
  • sort
  • filter
  • forEach
  • some
  • every
  • map
  • indexOf
  • lastIndexOf
  • reduce
  • reduceRight

When you call one of these methods, the items in the FileList will be resolved to the full list of files, and the method will be invoked on that result.

Special length method

length: FileList includes a length method (instead of a property) which returns the number of actual files in the list once it's been resolved.

FileList-specific methods

include: Add a filename/glob/regex to the list

exclude: Override inclusions by excluding a filename/glob/regex

resolve: Resolve the items in the FileList to the full list of files. This method is invoked automatically when one of the array methods is called.

toArray: Immediately resolves the list of items, and returns an actual array of filepaths.

clearInclusions: Clears any pending items -- must be used before resolving the list.

clearExclusions: Clears the list of exclusions rules.