tftsr-devops_investigation/node_modules/unicorn-magic/node.d.ts
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

126 lines
2.8 KiB
TypeScript

import {
type ExecFileOptionsWithStringEncoding,
type ExecFileSyncOptionsWithStringEncoding,
type PromiseWithChild,
} from 'node:child_process';
/**
Converts a `URL` or path to a path.
__Not available in browsers.__
@example
```
import path from 'node:path';
import {toPath} from 'unicorn-magic';
// `cwd` can be `URL` or a path string.
const getUnicornPath = cwd => path.join(toPath(cwd), 'unicorn');
```
*/
export function toPath(urlOrPath: URL | string): string;
/**
Finds the root directory of the given path.
__Not available in browsers.__
On Unix-based systems, the root is always `'/'`.
On Windows, the root varies and includes the drive letter (e.g., `'C:\\'`).
This function operates purely on paths and does not interact with the file system.
@param path - The path or URL to check.
@returns The root directory of the path.
@example
```
import {rootDirectory} from 'unicorn-magic';
console.log(rootDirectory('/Users/x/y/z'));
//=> '/'
console.log(rootDirectory('C:\\Users\\x\\y\\z'));
//=> 'C:\\'
```
*/
export function rootDirectory(path: string | URL): string;
/**
Creates an iterable for traversing from a given start path up to the root directory.
__Not available in browsers.__
This function operates purely on paths and does not interact with the file system.
@param startPath - The starting path. Can be relative.
@returns An iterable that iterates over each parent directory up to the root.
Tip: To stop iteration before reaching the root, use a `break` statement within a conditional check.
@example
```
import {traversePathUp} from 'unicorn-magic';
for (const directory of traversePathUp('/Users/x/y/z')) {
console.log(directory);
//=> '/Users/x/y/z'
//=> '/Users/x/y'
//=> '/Users/x'
//=> '/Users'
//=> '/'
}
```
*/
export function traversePathUp(startPath: string | URL): Iterable<string>;
/**
Executes a file.
Same as the built-in `execFile` but with:
- Promise API
- 10 MB `maxBuffer` instead of 1 MB
@example
```
import {execFile} from 'unicorn-magic';
console.log(await execFile('ls', ['-l']));
```
__Not available in browsers.__
*/
export function execFile(
file: string,
arguments_: readonly string[],
options?: ExecFileOptionsWithStringEncoding
): PromiseWithChild<{
stdout: string;
stderr: string;
}>;
/**
Executes a file synchronously.
Same as the built-in `execFileSync` but with:
- String output instead of buffer (same as `execFile`)
- Does not output `stderr` to the terminal by default (same as `execFile`)
- 10 MB `maxBuffer` instead of 1 MB
@example
```
import {execFileSync} from 'unicorn-magic';
console.log(execFileSync('ls', ['-l']));
```
__Not available in browsers.__
*/
export function execFileSync(
file: string,
arguments_?: readonly string[],
options?: ExecFileSyncOptionsWithStringEncoding
): string;
export * from './default.js';