bugproof 0.1.2 → 0.2.2

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 0.2.2 - 2026-05-08
+
+- Multi-language detection and language-context metadata added (Java, C/C++, Go, Rust, .NET, Ruby).
+- Cross-platform sandbox translation layer: command/path/env mapping to improve Windows↔Linux replays.
+- Improved source strategy and detection for projects without git (stacktrace/minimal modes).
+- Added integration tests and expanded dependency detection across languages.
+- Docs: Developer/engineering overview and cross-platform testing guidance.
+
+---
+
 # Changelog
 
 All notable changes to BugProof will be documented in this file.
@@ -46,12 +56,58 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - File association setup instructions
 - Troubleshooting and FAQ sections
 
-## [0.2.0] - Planned
+## [0.2.0] - 2026-05-07
+
+### Added
+
+- **Watch command** — Run any command with `bugproof watch -- <cmd>` and auto-capture on failure. Transparent pass-through on success. Integrates with `.bugproofrc` config.
+- **Init command** — Generate project-level `.bugproofrc` config with `bugproof init`. Supports exclude patterns, timeout, output directory, name templates.
+- **Share command** — Push artifacts to GitHub Gist with `bugproof share <artifact>`. Creates a formatted README with replay instructions.
+- **Smart Hints** — When replay fails to reproduce, BugProof now suggests actionable fixes (missing packages, env vars, permissions, network issues).
+- **Dependency Detection** — Automatically detects missing dependencies from error output across Node.js, Python, Ruby, Go, Rust, and system libraries. Shows install commands.
+- **Project Config** — `.bugproofrc` file with hierarchical lookup (walks parent directories). Supports exclude, timeout, name templates, and output directory.
+- **Name Templates** — Configurable artifact naming with `{timestamp}`, `{command}`, `{exit_code}` variables.
+
+### Fixed
+
+- Capture no longer crashes in non-git directories (returns empty file list gracefully)
+- CLI version now reads dynamically from package.json (no more hardcoded mismatch)
+- Flaky test timeout resolved (stderr capture test)
+
+### Testing
+
+- 24 test suites, 182 passing tests
+- New test coverage: config loader, dependency detection, smart hints, e2e CLI, packager regression
+- End-to-end validation of watch, init, share, and dependency detection workflows
+
+## [0.2.1] - 2026-05-07
+
+### Added
+
+- **Smart Source Strategy** — BugProof now intelligently determines how to include source code:
+  - `git-full`: Clean git repo → record commit hash only, zero files shipped (replay uses git checkout)
+  - `git-patch`: Dirty git repo → record commit + diff patch (tiny artifact, full reproducibility)
+  - `stacktrace`: No git → extract file paths from error stacktrace, ship only those files
+  - `minimal`: No git, no stacktrace → command-only artifact
+- **BugBox Container** — Lightweight Docker-like isolation without Docker:
+  - Linux: user/PID/mount/network namespaces via `unshare`, fuse-overlayfs, cgroups v2
+  - Windows: Job Objects + firewall rules + isolated temp
+  - macOS: sandbox-exec profiles with filesystem/network deny rules
+  - All platforms: temp directory isolation, env sanitization, auto-cleanup
+- **Environment Snapshot** — Captures runtime versions (Node, Python, Ruby, Go, Rust, Java, npm, pip) at capture time. On replay, warns about mismatches that could affect reproduction.
+- **Replay `--container` flag** — Opt into BugBox container isolation during replay.
+
+### Architecture
+
+- `src/capture/source-strategy.ts` — Smart source inclusion with tiered git/stacktrace/minimal strategies
+- `src/capture/env-snapshot.ts` — Runtime version probing and cross-snapshot comparison
+- `src/sandbox/container.ts` — Lightweight container with layered isolation (namespace, filesystem, network, resources)
+- Packager now writes `source-strategy.json`, `changes.patch`, and `env-snapshot.json` into artifacts
+
+### Testing
 
-- npm global install polish
-- Docker sandbox fallback
-- Web UI for artifact inspection
-- Language-specific dependency detection
+- 27 test suites, 204 passing tests
+- New coverage: source strategy (5 tests), env snapshot (5 tests), container (6 tests), stacktrace extraction (5 tests)
 
 ## [0.3.0] - Planned
 

package/README.md

@@ -180,6 +180,147 @@ bugproof diff --json bug-before.bug bug-after.bug
 Options:
 - `--json` Structured JSON output
 
+### `bugproof watch [command...]`
+
+Run a command transparently — auto-capture a `.bug` artifact only if it fails. This is the everyday command. Replace `npm test` with `bugproof watch -- npm test` in your workflow.
+
+Examples:
+
+```bash
+bugproof watch -- npm test
+bugproof watch -- python app.py
+bugproof watch -- cargo build
+bugproof watch --always -- node script.js   # capture even on success
+bugproof watch -o ./bugs -- go test ./...   # output to ./bugs/ directory
+```
+
+Options:
+- `--timeout <ms>` Command timeout (default: from `.bugproofrc` or 300000)
+- `-n, --name <name>` Artifact name
+- `-d, --description <desc>` Description
+- `-o, --output <dir>` Output directory
+- `--always` Capture even when command succeeds
+- `--json` Structured JSON output
+
+### `bugproof init`
+
+Create a `.bugproofrc` config file in the current directory.
+
+```bash
+bugproof init
+bugproof init --force  # overwrite existing
+```
+
+Config options (`.bugproofrc`):
+
+```json
+{
+  "exclude": ["node_modules/**", "dist/**", "*.bug"],
+  "outputDir": ".",
+  "timeout": 300000,
+  "skipSecrets": false,
+  "includeUntracked": false,
+  "maxArtifactSizeMB": 50,
+  "nameTemplate": "bug_{timestamp}"
+}
+```
+
+Name template variables: `{timestamp}`, `{command}`, `{exit_code}`
+
+### `bugproof share <artifact>`
+
+Share an artifact via GitHub Gist. Creates a secret gist with manifest, failure info, and a README.
+
+```bash
+bugproof share my-bug.bug
+bugproof share --public my-bug.bug
+```
+
+Requires `GITHUB_TOKEN` or `BUGPROOF_GITHUB_TOKEN` env var with `gist` scope.
+
+Options:
+- `--public` Create a public gist (default: secret/unlisted)
+- `--json` Structured JSON output
+
+## Smart Features
+
+### Dependency Detection
+
+When capturing, BugProof automatically detects missing dependencies from error output:
+
+```
+  Missing Dependencies Detected
+    ➜ express (node)
+      npm install express
+```
+
+Supports: Node.js, Python, Ruby, Go, Rust, system libraries.
+
+### Smart Hints on Replay
+
+When a replay produces a different error than expected, BugProof provides actionable hints:
+
+```
+  Hints
+    ➜ Missing Node.js module
+      Install the missing package: npm install express
+    • Network connectivity issue
+      A network connection failed. Check that the required service/host is running.
+```
+
+## Smart Source Strategy
+
+BugProof intelligently determines how to include source code, keeping artifacts small even for heavy codebases:
+
+| Strategy | Condition | What ships | Artifact size |
+|----------|-----------|------------|---------------|
+| `git-full` | Clean git repo | Commit hash only | ~2 KB |
+| `git-patch` | Dirty git repo | Commit hash + diff patch | ~5 KB |
+| `stacktrace` | No git | Only files from error stacktrace | ~10-50 KB |
+| `minimal` | No git, no stacktrace | Command only | ~1 KB |
+
+**Git is strongly encouraged but not required.** Without git, BugProof extracts file paths from your error stacktrace and ships only those files — not your entire codebase.
+
+```
+  ➜ Source: Git repo dirty at 5b7c1131. Shipping commit ref + diff patch (0.2 KB).
+```
+
+## BugBox Container
+
+BugProof includes its own lightweight container sandbox — Docker-like isolation without Docker:
+
+```bash
+bugproof replay --container my-bug.bug     # replay with full isolation
+bugproof replay --sandbox full my-bug.bug  # alternative: use sandbox layers
+```
+
+### Isolation layers per platform
+
+| Layer | Linux | Windows | macOS |
+|-------|-------|---------|-------|
+| Process isolation | PID namespace (`unshare --pid`) | Job Objects | sandbox-exec |
+| Network isolation | Network namespace (`unshare --net`) | Firewall rules (`netsh`) | sandbox-exec deny |
+| Filesystem | fuse-overlayfs (read-only source + writable overlay) | Isolated temp | Restricted writes |
+| Resource limits | cgroups v2 (memory, CPU, PIDs) | Job Object limits | — |
+| Env sanitization | Strip `LD_PRELOAD`, `NODE_OPTIONS`, etc. | Same | Same |
+| Temp isolation | Private `/tmp` | Private `%TEMP%` | Private `/tmp` |
+
+Note for Windows: `isolated` and `full` sandbox modes are best-effort hardening, not VM-grade containment. For untrusted artifacts, replay inside a dedicated VM.
+
+No Docker daemon, no images, no 400MB overhead. Just native OS primitives.
+
+## Environment Snapshot
+
+BugProof captures runtime versions at capture time and warns on replay when versions differ:
+
+```
+  Environment Mismatches
+    • node version mismatch: captured 18.0.0, current 22.1.0
+    ✘ python 3.11.0 was available at capture but is not installed now.
+```
+
+Tracked runtimes: Node.js, Python, Ruby, Go, Rust, Java, npm, pip, OS platform, architecture.
+
 ## File Association and Icon Registration
 
 ### Windows
@@ -231,11 +372,18 @@ These project principles remain unchanged:
 - [x] v0.1: CLI core (capture/replay/inspect/diff)
 - [x] v0.1: Cross-platform replay support
 - [x] v0.1: Secret redaction and sandbox layers
-- [ ] v0.2: npm global install polish and Docker sandbox fallback
-- [ ] v0.2: Web UI for artifact inspection
-- [ ] v0.3: Artifact push/pull and signing
-- [ ] v0.3: Language-specific dependency detection
+- [x] v0.2: Watch command (auto-capture on failure)
+- [x] v0.2: Project config (`.bugproofrc`)
+- [x] v0.2: Dependency detection (Node/Python/Ruby/Go/Rust)
+- [x] v0.2: Smart hints on replay failure
+- [x] v0.2: Share via GitHub Gist
+- [x] v0.2.1: Smart source strategy (git-full/git-patch/stacktrace/minimal)
+- [x] v0.2.1: BugBox Container (lightweight Docker-like isolation)
+- [x] v0.2.1: Environment snapshot + mismatch warnings
+- [ ] v0.3: Web UI for artifact inspection
+- [ ] v0.3: Artifact signing and verification
 - [ ] v0.4: GitHub issue integration and richer diff visualization
+- [ ] v0.4: CI/CD plugins (GitHub Actions, GitLab CI)
 
 ## Development
 
@@ -245,6 +393,29 @@ npm run build
 npm test
 ```
 
+## Developer / Engineer Overview
+
+This section helps maintainers and integrators understand the architecture, testing, and shipping process for BugProof.
+
+- Architecture: modular pipeline (Capture → Packager → Replay → Verdict). Key modules:
+  - `src/capture/*` — execution capture and environment snapshot
+  - `src/capture/language-support.ts` — multi-language detection and language-context.json generation
+  - `src/replay/*` — artifact restore, sandboxing, and verdict generation
+  - `src/replay/verdict.ts` — fingerprint and normalized-pattern matching logic
+
+- Testing: unit tests (Jest) live under `tests/`; integration tests under `tests/integration/`.
+  - Run `npm test` for full suite. Use `npm run test:e2e` for cross-platform orchestrator (requires SSH hosts configured).
+
+- Cross-platform QA: use `scripts/e2e-matrix.js` to run Windows↔Linux scenarios. Configure SSH in `scripts/e2e-matrix.js` or provide `E2E_TARGET` env.
+
+- Shipping checklist (short):
+  1. Ensure `npm run build` passes and `npm test` is green locally on both Windows and Linux runners.
+  2. Update `CHANGELOG.md` and bump `package.json` version.
+  3. Tag a release `git tag -a vX.Y.Z -m "Release vX.Y.Z"` and push tags.
+  4. CI will run `prepublishOnly` and publish on tag events.
+
+If you are integrating BugProof into a CI pipeline, prefer running `bugproof inspect` in a hermetic container to validate artifact contents before attempting replay.
+
 ## CI and Releases
 
 - `push` and `pull_request` CI runs only for core paths such as `src/`, `scripts/`, `tests/`, `package.json`, `tsconfig.json`, and `assets/`.

package/dist/capture/env-snapshot.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Environment Snapshot
+ *
+ * Captures runtime versions (Node.js, Python, Ruby, Go, Rust, Java, etc.)
+ * at capture time. On replay, compares against the replayer's environment
+ * and warns about mismatches that could affect reproduction.
+ */
+export interface RuntimeVersion {
+    name: string;
+    version: string;
+    path?: string;
+}
+export interface EnvSnapshot {
+    /** Node.js runtime */
+    node: RuntimeVersion | null;
+    /** Python runtime */
+    python: RuntimeVersion | null;
+    /** Ruby runtime */
+    ruby: RuntimeVersion | null;
+    /** Go runtime */
+    go: RuntimeVersion | null;
+    /** Rust/cargo runtime */
+    rust: RuntimeVersion | null;
+    /** Java runtime */
+    java: RuntimeVersion | null;
+    /** OS info */
+    os: {
+        platform: string;
+        release: string;
+        arch: string;
+    };
+    /** npm version (if available) */
+    npm: RuntimeVersion | null;
+    /** pip version (if available) */
+    pip: RuntimeVersion | null;
+}
+/**
+ * Captures the current development environment snapshot.
+ * Each probe is fast (<100ms) and never throws.
+ */
+export declare function captureEnvSnapshot(): EnvSnapshot;
+/**
+ * Compares two environment snapshots and returns mismatches.
+ */
+export declare function compareEnvSnapshots(captured: EnvSnapshot, current: EnvSnapshot): EnvMismatch[];
+export interface EnvMismatch {
+    runtime: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    capturedVersion: string | null;
+    currentVersion: string | null;
+}
+//# sourceMappingURL=env-snapshot.d.ts.map

package/dist/capture/env-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-snapshot.d.ts","sourceRoot":"","sources":["../../src/capture/env-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,qBAAqB;IACrB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,mBAAmB;IACnB,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,iBAAiB;IACjB,EAAE,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1B,yBAAyB;IACzB,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,mBAAmB;IACnB,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,cAAc;IACd,EAAE,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,iCAAiC;IACjC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3B,iCAAiC;IACjC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAkBhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,WAAW,GACnB,WAAW,EAAE,CAsDf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/dist/capture/env-snapshot.js

@@ -0,0 +1,122 @@
+/**
+ * Environment Snapshot
+ *
+ * Captures runtime versions (Node.js, Python, Ruby, Go, Rust, Java, etc.)
+ * at capture time. On replay, compares against the replayer's environment
+ * and warns about mismatches that could affect reproduction.
+ */
+import { spawnSync } from 'child_process';
+import * as os from 'os';
+/**
+ * Captures the current development environment snapshot.
+ * Each probe is fast (<100ms) and never throws.
+ */
+export function captureEnvSnapshot() {
+    return {
+        node: probeRuntime('node', ['--version'], /v?([\d.]+)/),
+        python: probeRuntime('python', ['--version'], /Python\s+([\d.]+)/)
+            ?? probeRuntime('python3', ['--version'], /Python\s+([\d.]+)/),
+        ruby: probeRuntime('ruby', ['--version'], /ruby\s+([\d.]+)/),
+        go: probeRuntime('go', ['version'], /go([\d.]+)/),
+        rust: probeRuntime('rustc', ['--version'], /rustc\s+([\d.]+)/),
+        java: probeRuntime('java', ['-version'], /version\s+"?([\d.]+)/),
+        npm: probeRuntime('npm', ['--version'], /([\d.]+)/),
+        pip: probeRuntime('pip', ['--version'], /pip\s+([\d.]+)/)
+            ?? probeRuntime('pip3', ['--version'], /pip\s+([\d.]+)/),
+        os: {
+            platform: os.platform(),
+            release: os.release(),
+            arch: os.arch(),
+        },
+    };
+}
+/**
+ * Compares two environment snapshots and returns mismatches.
+ */
+export function compareEnvSnapshots(captured, current) {
+    const mismatches = [];
+    const runtimes = [
+        'node', 'python', 'ruby', 'go', 'rust', 'java', 'npm', 'pip',
+    ];
+    for (const key of runtimes) {
+        const cap = captured[key];
+        const cur = current[key];
+        if (cap && !cur) {
+            mismatches.push({
+                runtime: cap.name,
+                severity: 'error',
+                message: `${cap.name} ${cap.version} was available at capture but is not installed now.`,
+                capturedVersion: cap.version,
+                currentVersion: null,
+            });
+        }
+        else if (cap && cur && cap.version !== cur.version) {
+            const severity = isMajorMismatch(cap.version, cur.version) ? 'warning' : 'info';
+            mismatches.push({
+                runtime: cap.name,
+                severity,
+                message: `${cap.name} version mismatch: captured ${cap.version}, current ${cur.version}`,
+                capturedVersion: cap.version,
+                currentVersion: cur.version,
+            });
+        }
+    }
+    // OS platform mismatch
+    if (captured.os.platform !== current.os.platform) {
+        mismatches.push({
+            runtime: 'os',
+            severity: 'warning',
+            message: `OS mismatch: captured on ${captured.os.platform}, replaying on ${current.os.platform}`,
+            capturedVersion: captured.os.platform,
+            currentVersion: current.os.platform,
+        });
+    }
+    // Architecture mismatch
+    if (captured.os.arch !== current.os.arch) {
+        mismatches.push({
+            runtime: 'arch',
+            severity: 'info',
+            message: `Architecture mismatch: captured on ${captured.os.arch}, replaying on ${current.os.arch}`,
+            capturedVersion: captured.os.arch,
+            currentVersion: current.os.arch,
+        });
+    }
+    return mismatches;
+}
+// ── Internal ──
+function probeRuntime(command, args, versionPattern) {
+    try {
+        const result = spawnSync(command, args, {
+            encoding: 'utf-8',
+            timeout: 3000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Java outputs version to stderr
+        const output = (result.stdout || '') + (result.stderr || '');
+        const match = output.match(versionPattern);
+        if (match) {
+            // Get the full path
+            const whichCmd = os.platform() === 'win32' ? 'where' : 'which';
+            const whichResult = spawnSync(whichCmd, [command], {
+                encoding: 'utf-8',
+                timeout: 2000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return {
+                name: command,
+                version: match[1],
+                path: whichResult.status === 0 ? whichResult.stdout.trim().split('\n')[0] : undefined,
+            };
+        }
+    }
+    catch {
+        // Not installed or not accessible
+    }
+    return null;
+}
+function isMajorMismatch(v1, v2) {
+    const major1 = parseInt(v1.split('.')[0], 10);
+    const major2 = parseInt(v2.split('.')[0], 10);
+    return !isNaN(major1) && !isNaN(major2) && major1 !== major2;
+}
+//# sourceMappingURL=env-snapshot.js.map

package/dist/capture/env-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-snapshot.js","sourceRoot":"","sources":["../../src/capture/env-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/capture/language-support.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Language Support Module
+ *
+ * Detects the project's programming language(s) and captures language-specific
+ * context needed for cross-platform bug reproduction:
+ *
+ * - Node.js/TypeScript: package.json, node_modules state, npm/yarn/pnpm lockfiles
+ * - Python: requirements.txt, pyproject.toml, virtual env detection
+ * - Java/Kotlin: pom.xml, build.gradle, JDK version, classpath
+ * - C/C++: Makefile, CMakeLists.txt, compiler version (gcc/clang/msvc)
+ * - Go: go.mod, go.sum
+ * - Rust: Cargo.toml, Cargo.lock, rustc version
+ * - Ruby: Gemfile, Gemfile.lock
+ * - .NET/C#: *.csproj, *.sln, dotnet version
+ *
+ * This information is stored in the artifact so replay can:
+ * 1. Warn about missing build tools
+ * 2. Suggest dependency installation commands
+ * 3. Detect build system differences across platforms
+ */
+export interface LanguageInfo {
+    /** Primary language identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Detected version of the primary runtime/compiler */
+    version: string | null;
+    /** Build system used */
+    buildSystem: string | null;
+    /** Package manager */
+    packageManager: string | null;
+    /** Lockfile path (relative) if present */
+    lockfile: string | null;
+    /** Whether a build step is likely needed before running */
+    needsBuild: boolean;
+    /** Cross-platform compatibility rating */
+    crossPlatform: 'native' | 'high' | 'medium' | 'low';
+    /** Platform-specific notes */
+    notes: string[];
+}
+export interface ProjectLanguageContext {
+    /** Detected languages (sorted by confidence) */
+    languages: LanguageInfo[];
+    /** Primary language (highest confidence) */
+    primary: LanguageInfo | null;
+    /** Build commands needed for reproduction */
+    buildCommands: string[];
+    /** Files critical for reproduction (lockfiles, configs) */
+    criticalFiles: string[];
+    /** Cross-platform warnings specific to this project */
+    warnings: string[];
+}
+/** Detect project languages and capture context */
+export declare function detectProjectLanguages(workingDir: string): ProjectLanguageContext;
+//# sourceMappingURL=language-support.d.ts.map

package/dist/capture/language-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-support.d.ts","sourceRoot":"","sources":["../../src/capture/language-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wBAAwB;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sBAAsB;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,aAAa,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpD,8BAA8B;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,4CAA4C;IAC5C,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,6CAA6C;IAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,mDAAmD;AACnD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAmCjF"}