@mrpatronz/nexusflow 0.1.0

package/GETTING_STARTED.md

@@ -0,0 +1,109 @@
+# NexusFlow — Getting Started Guide
+
+Welcome to **NexusFlow**! This guide will walk you through the system, explain its core workflows, and show you how to leverage multi-repository workspaces and agentic orchestration to accelerate feature development.
+
+---
+
+## 💡 What is NexusFlow?
+
+When developing complex features in modern systems, you often need to touch multiple repositories simultaneously (e.g., modifying a shared package, updating a backend REST API, and updating a frontend application). 
+
+Traditional AI assistant setups only give the assistant context of a single repository. NexusFlow solves this by:
+1. **Grouping Repositories**: Creating a dedicated workspace using **git worktrees** on a unified feature branch name.
+2. **Generating AI Context**: Writing specialized configurations (`CLAUDE.md`, `AGENTS.md`, Copilot guidelines, and Cursor rules) that outline the workspace architecture.
+3. **Smart Codebase Analysis**: Scanning tech stacks, ports, and API endpoints so the AI instantly understands the codebase boundaries.
+4. **Service Orchestration**: Running, stopping, and logging all projects simultaneously from a single place.
+
+---
+
+## 🚀 Step-by-Step Workflow
+
+Here is how to get started with your first feature workspace.
+
+```mermaid
+flowchart TD
+    A["1. Run Web GUI or CLI"] --> B["2. Fill Feature Details & Pick Repos"]
+    B --> C["3. Workspace Created\n(Git Worktrees + Context generated)"]
+    C --> D["4. AI Agent Initializes\n(Fills nexusflow-overview.md + questions)"]
+    D --> E["5. Confirm Assumptions & Spin up services"]
+```
+
+### 1. Initialize NexusFlow
+First, initialize the default configuration on your machine:
+```bash
+nexusflow init
+```
+This sets up `~/.nexusflow/config.json` with default settings:
+* **Development Directory**: Where your git repositories are located (defaults to `~/dev`).
+* **Workspaces Directory**: Where your worktrees will be created (defaults to `~/dev/workspaces`).
+
+---
+
+### 2. Launch the Web Dashboard
+NexusFlow comes with a rich, interactive Web Dashboard. Launch it by running:
+```bash
+nexusflow ui
+```
+This starts the local backend server on port `3000` and automatically opens the browser.
+
+---
+
+### 3. Create a Feature Workspace
+On the dashboard (or via the `nexusflow create` CLI command):
+1. **Branch name**: Enter your branch name (e.g. `feature/user-profiles`). Slashes are supported!
+2. **Description**: Describe the feature you are building. The AI assistant will read this to compile the plan.
+3. **Pick Repositories**: Choose which repositories you need to modify or reference.
+4. **Assistant Selection**: Select which AI coding assistants you plan to use (Claude Code, Antigravity, Cursor, etc.).
+5. **Click Build Workspace**: NexusFlow will fetch origin updates, create local branches, spin up git worktrees under `workspaces/feature/user-profiles`, run tech analyses, and write context configurations.
+
+---
+
+### 4. The Agentic Initialization (Universal Context)
+Once the workspace is built, open it in your preferred AI assistant. 
+
+Whichever AI harness you use, **the agent's very first instructions** are to:
+1. Scan the workspace projects.
+2. Create a universal reference file: **`nexusflow-overview.md`**.
+3. Write down its assumptions of what each project does, how they interact, and their responsibilities.
+4. List any **Clarifying Questions** it needs you to answer before coding.
+
+**Your Action**: Review the generated `nexusflow-overview.md`, answer the assistant's questions directly in the chat or file, and confirm its assumptions. This ensures you and the agent are aligned before a single line of code is modified.
+
+---
+
+### 5. Orchestrate Local Services
+You don't need to open five terminal windows to start your backend, frontend, databases, or libraries.
+
+**On the Web Dashboard:**
+* Expand your active workspace to see all detected services (e.g. node scripts, dotnet servers, python hosts).
+* Click **Start All** to spin them up.
+* View aggregate console streams inside the tabbed retro-terminal output screen.
+
+**Via the CLI:**
+* Navigate to your workspace directory and run:
+  ```bash
+  nexusflow start
+  ```
+* Check logs or stop services with:
+  ```bash
+  nexusflow logs
+  nexusflow stop
+  ```
+
+---
+
+## 🛠️ CLI Reference
+
+Here is a summary of the command-line interface:
+
+| Command | Usage | Description |
+| :--- | :--- | :--- |
+| **`nexusflow ui`** | `nexusflow ui [-p <port>]` | Starts the backend Hono API server and opens the GUI Dashboard. |
+| **`nexusflow create`** | `nexusflow create` | Launches the interactive step-by-step terminal wizard to build a workspace. |
+| **`nexusflow list`** | `nexusflow list` / `nexusflow ls` | Lists all active feature workspaces discovered on your machine. |
+| **`nexusflow open`** | `nexusflow open` | Prompts you to pick an active workspace and opens it in your editor. |
+| **`nexusflow start`** | `nexusflow start [path]` | Starts background processes for all projects in the workspace. |
+| **`nexusflow stop`** | `nexusflow stop [path]` | Kills all running processes for the workspace. |
+| **`nexusflow logs`** | `nexusflow logs [path] [-n <lines>]` | Tails output log files for all service processes in the workspace. |
+| **`nexusflow status`** | `nexusflow status [path]` | Displays running/stopped statuses and PIDs for each service. |
+| **`nexusflow init`** | `nexusflow init` | Creates or edits the global config file. |

package/README.md

@@ -0,0 +1,310 @@
+<p align="center">
+  <h1 align="center">🔗 NexusFlow</h1>
+  <p align="center">
+    <strong>Multi-repo workspace manager for AI-assisted development</strong>
+  </p>
+  <p align="center">
+    Group repositories · Generate AI context · Resume LLM sessions · Orchestrate services
+  </p>
+</p>
+
+---
+
+NexusFlow combines multiple Git repositories into a single feature workspace and generates the context files that your AI coding assistant needs to understand all of them at once. It uses **git worktrees** so every repo stays on a clean feature branch without disturbing your main working copy.
+
+> **New to NexusFlow?** Jump to the [Getting Started Guide](GETTING_STARTED.md) for a hands-on walkthrough.
+
+## ✨ Features
+
+- **Multi-repo workspaces** — group any set of local Git repos under one feature branch using worktrees
+- **AI context generation** — automatically writes `CLAUDE.md`, `AGENTS.md`, `.github/copilot-instructions.md`, and `.cursor/rules/nexusflow.mdc`
+- **Smart codebase analysis** — detects tech stacks, ports, API endpoints, dependencies, and existing AI configs across all projects
+- **Session history & resumption** — browse past conversation transcripts from Antigravity, Claude Code, OpenAI Codex, and GitHub Copilot, then resume where you left off
+- **Service orchestration** — start, stop, and tail logs for all services in a workspace with a single command
+- **Interactive Web Dashboard** — rich dark-themed GUI for managing workspaces, viewing sessions, and streaming logs
+- **CLI-first** — every action available from the terminal via the `nexusflow` command
+
+## 📦 Installation
+
+### Prerequisites
+
+| Requirement | Version |
+|:---|:---|
+| [Node.js](https://nodejs.org) | 18 or later |
+| [Git](https://git-scm.com) | 2.20 or later (worktree support) |
+| npm | Bundled with Node.js |
+
+### Install from npm
+
+```bash
+npm install -g nexusflow
+```
+
+### Install from source
+
+```bash
+git clone https://github.com/antan87/NexusFlow.git
+cd NexusFlow
+
+# Install backend dependencies
+npm install
+
+# Install GUI dependencies
+cd gui && npm install && cd ..
+
+# Build everything
+npm run build
+
+# Link the CLI globally
+npm link
+```
+
+After linking, the `nexusflow` command is available system-wide.
+
+## 🚀 Quick Start
+
+```bash
+# 1 — Initialize config (optional, defaults work out of the box)
+nexusflow init
+
+# 2 — Create a feature workspace
+nexusflow create
+
+# 3 — Or launch the Web Dashboard
+nexusflow ui
+```
+
+The `create` wizard walks you through:
+
+1. **Name your feature branch** — e.g. `feature/user-auth`
+2. **Describe what you're building** — plain text or a path to a `.md` file
+3. **Pick your repos** — NexusFlow scans `~/dev` for git repositories
+4. **Choose AI assistant(s)** — auto-detects what's installed
+5. **Done!** — workspace created with git worktrees + AI context files
+
+## 📂 What Gets Generated
+
+```
+~/dev/workspaces/feature/user-auth/
+├── CLAUDE.md                         # Context for Claude / Antigravity
+├── AGENTS.md                         # Context for OpenAI Codex
+├── .github/
+│   └── copilot-instructions.md       # Context for GitHub Copilot
+├── .cursor/
+│   └── rules/nexusflow.mdc           # Context for Cursor
+├── nexusflow.json                    # Feature config (branch, repos, etc.)
+├── nexusflow-overview.md             # AI-generated workspace analysis
+├── my-api/                           # ← Git worktree on feature branch
+└── my-frontend/                      # ← Git worktree on feature branch
+```
+
+Open this folder in your editor → your AI assistant picks up the context → it understands *all* your repos.
+
+## 🖥️ Commands
+
+| Command | Description |
+|:---|:---|
+| `nexusflow create` | Interactive wizard to create a new feature workspace |
+| `nexusflow list` | List all existing workspaces (alias: `ls`) |
+| `nexusflow open` | Re-open a workspace in your editor |
+| `nexusflow init` | Configure NexusFlow settings |
+| `nexusflow start` | Start all services in a workspace (auto-detected) |
+| `nexusflow stop` | Stop all running services |
+| `nexusflow status` | Show running/stopped status and PIDs |
+| `nexusflow logs` | Tail aggregated logs from all services |
+| `nexusflow ui` | Launch the interactive Web Dashboard (port 3000) |
+
+## 🤖 Supported AI Assistants
+
+NexusFlow auto-detects which assistants are available on your machine and generates the right context files for each:
+
+| Assistant | Config File | How It's Detected |
+|:---|:---|:---|
+| **Claude Code / Antigravity** | `CLAUDE.md` | `claude` or `antigravity` in PATH |
+| **OpenAI Codex** | `AGENTS.md` | `codex` in PATH |
+| **GitHub Copilot** | `.github/copilot-instructions.md` | Always available |
+| **Cursor** | `.cursor/rules/nexusflow.mdc` | `cursor` in PATH |
+
+## 🕐 Session History & Resumption
+
+NexusFlow can discover and display your past AI coding sessions across all supported assistants. This lets you:
+
+- **Browse** conversation transcripts from previous sessions
+- **Search** through your interaction history
+- **Resume** a session by copying the resume command to your clipboard
+
+Session data is read directly from each assistant's local storage:
+
+| Assistant | Session Location |
+|:---|:---|
+| Antigravity | `~/.gemini/antigravity-cli/brain/` |
+| Claude Code | `~/.claude/projects/` |
+| OpenAI Codex | `~/.codex/sessions/` |
+| GitHub Copilot | `~/.copilot/` |
+
+Access sessions via the Web Dashboard's **Sessions** tab or through the API:
+
+```
+GET /api/workspace/:id/sessions
+GET /api/session/:assistant/:sessionId/transcript
+```
+
+## 🌐 Web Dashboard
+
+Launch with `nexusflow ui` to get a full-featured dark-themed GUI:
+
+- **Workspaces tab** — create, browse, and manage feature workspaces
+- **Sessions tab** — view past AI conversation transcripts and resume sessions
+- **Logs panel** — real-time aggregated service log output
+- **Config panel** — edit NexusFlow settings from the browser
+
+The dashboard runs a local [Hono](https://hono.dev) server on port 3000 and serves a [React](https://react.dev) + [Vite](https://vite.dev) frontend.
+
+## ⚙️ Configuration
+
+NexusFlow stores its config at `~/.nexusflow/config.json`:
+
+```json
+{
+  "version": "0.1.0",
+  "devDir": "~/dev",
+  "workspacesDir": "~/dev/workspaces",
+  "scanDepth": 2,
+  "defaultAssistant": null
+}
+```
+
+| Key | Default | Description |
+|:---|:---|:---|
+| `devDir` | `~/dev` | Root directory to scan for git repos |
+| `workspacesDir` | `~/dev/workspaces` | Where feature workspaces are created |
+| `scanDepth` | `2` | How many levels deep to scan for repos |
+| `defaultAssistant` | `null` | Pre-select an assistant during workspace creation |
+
+Run `nexusflow init` to interactively set these values.
+
+## 🏗️ Architecture
+
+```
+NexusFlow/
+├── src/
+│   ├── index.ts              # CLI entry point (Commander.js)
+│   ├── server.ts             # Hono API server (REST endpoints)
+│   ├── types.ts              # Shared TypeScript interfaces
+│   ├── commands/             # CLI command handlers
+│   │   ├── create.ts         #   nexusflow create
+│   │   ├── init.ts           #   nexusflow init
+│   │   ├── list.ts           #   nexusflow list
+│   │   ├── open.ts           #   nexusflow open
+│   │   ├── start.ts          #   nexusflow start
+│   │   ├── stop.ts           #   nexusflow stop
+│   │   ├── status.ts         #   nexusflow status
+│   │   ├── logs.ts           #   nexusflow logs
+│   │   └── ui.ts             #   nexusflow ui
+│   ├── core/                 # Core workspace logic
+│   │   ├── config.ts         #   Config management (~/.nexusflow/)
+│   │   ├── scanner.ts        #   Git repo scanner
+│   │   ├── worktree.ts       #   Git worktree operations
+│   │   └── workspace.ts      #   Workspace CRUD
+│   ├── analyzers/            # Codebase analysis
+│   │   ├── tech-stack.ts     #   Language/framework detection
+│   │   ├── detect-ports.ts   #   Port & server detection
+│   │   ├── detect-apis.ts    #   API endpoint scanning
+│   │   ├── detect-deps.ts    #   Dependency analysis
+│   │   ├── detect-existing.ts#   Existing AI config detection
+│   │   └── readme-summarizer.ts# README content extraction
+│   ├── generators/           # AI context file generators
+│   │   ├── base.ts           #   Shared context builder
+│   │   ├── claude.ts         #   CLAUDE.md generator
+│   │   ├── codex.ts          #   AGENTS.md generator
+│   │   ├── copilot.ts        #   copilot-instructions.md generator
+│   │   └── cursor.ts         #   nexusflow.mdc generator
+│   ├── orchestration/        # Service start/stop/log management
+│   └── utils/                # Helper utilities
+│       ├── git.ts            #   Git operations
+│       ├── detect-ai.ts      #   AI assistant detection
+│       ├── detect-editors.ts #   Editor detection
+│       ├── session-finder.ts #   AI session history discovery
+│       └── prompts.ts        #   Interactive prompts
+├── gui/                      # React + Vite Web Dashboard
+│   └── src/
+│       └── App.tsx           #   Main dashboard component
+├── package.json
+└── tsconfig.json
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Here's how to get set up:
+
+### Development Setup
+
+```bash
+# Clone the repo
+git clone https://github.com/antan87/NexusFlow.git
+cd NexusFlow
+
+# Install all dependencies
+npm install
+cd gui && npm install && cd ..
+
+# Start the TypeScript compiler in watch mode
+npm run dev
+
+# In another terminal, start the GUI dev server
+cd gui && npm run dev
+```
+
+### Build
+
+```bash
+# Full build (TypeScript + GUI)
+npm run build
+
+# Clean build artifacts
+npm run clean
+```
+
+### Test
+
+```bash
+# Run tests
+npm test
+
+# Watch mode
+npm run test:watch
+```
+
+### Code Style
+
+- **TypeScript** — strict mode, ES modules
+- **Imports** — use `.js` extensions for local imports (`import { x } from './config.js'`)
+- **Node built-ins** — use the `node:` prefix (`import path from 'node:path'`)
+- **JSDoc** — add doc comments to all exported functions
+- **Error handling** — wrap external calls (git, filesystem) in try/catch
+
+### Adding a New AI Assistant
+
+1. Add the assistant identifier to the `AIAssistant` type in [types.ts](src/types.ts)
+2. Add detection logic in [detect-ai.ts](src/utils/detect-ai.ts)
+3. Create a new generator in `src/generators/` (follow the pattern in [claude.ts](src/generators/claude.ts))
+4. Register it in the [generator index](src/generators/index.ts)
+5. Add session discovery logic in [session-finder.ts](src/utils/session-finder.ts)
+
+### Adding a New Analyzer
+
+1. Create a new file in `src/analyzers/` following the existing patterns
+2. Export the analyzer function and register it in [analyzers/index.ts](src/analyzers/index.ts)
+3. The analyzer output is fed into the context generators and the `WORKSPACE.md` file
+
+### Pull Request Guidelines
+
+- Fork the repo and create a feature branch
+- Write clear commit messages
+- Add tests for new functionality
+- Make sure `npm run build` passes before submitting
+- Update documentation if you change user-facing behavior
+
+## 📄 License
+
+MIT — see [LICENSE](LICENSE) for details.

package/dist/analyzers/detect-apis.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module analyzers/detect-apis
+ * Detects API endpoints in a repository by scanning for OpenAPI/Swagger files,
+ * route patterns in common frameworks, and gRPC proto files.
+ */
+import type { ApiEndpoint } from '../types.js';
+/**
+ * Detects API endpoints in a repository.
+ *
+ * Strategies (in order):
+ * 1. Look for OpenAPI/Swagger spec files (JSON/YAML)
+ * 2. Scan source files for Express/Fastify/ASP.NET route patterns
+ * 3. Look for gRPC .proto files
+ *
+ * @param repoPath - Absolute path to the repository root.
+ * @returns Array of detected {@link ApiEndpoint} objects.
+ */
+export declare function detectApis(repoPath: string): Promise<ApiEndpoint[]>;
+//# sourceMappingURL=detect-apis.d.ts.map

package/dist/analyzers/detect-apis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-apis.d.ts","sourceRoot":"","sources":["../../src/analyzers/detect-apis.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAczE"}

package/dist/analyzers/detect-apis.js

@@ -0,0 +1,121 @@
+/**
+ * @module analyzers/detect-apis
+ * Detects API endpoints in a repository by scanning for OpenAPI/Swagger files,
+ * route patterns in common frameworks, and gRPC proto files.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * Detects API endpoints in a repository.
+ *
+ * Strategies (in order):
+ * 1. Look for OpenAPI/Swagger spec files (JSON/YAML)
+ * 2. Scan source files for Express/Fastify/ASP.NET route patterns
+ * 3. Look for gRPC .proto files
+ *
+ * @param repoPath - Absolute path to the repository root.
+ * @returns Array of detected {@link ApiEndpoint} objects.
+ */
+export async function detectApis(repoPath) {
+    const endpoints = [];
+    // 1. OpenAPI/Swagger files
+    const openApiEndpoints = await scanOpenApiFiles(repoPath);
+    endpoints.push(...openApiEndpoints);
+    // 2. Route patterns in source files (only if no OpenAPI found)
+    if (endpoints.length === 0) {
+        const routeEndpoints = await scanRoutePatterns(repoPath);
+        endpoints.push(...routeEndpoints);
+    }
+    return endpoints;
+}
+/** Looks for OpenAPI/Swagger spec files and extracts paths. */
+async function scanOpenApiFiles(repoPath) {
+    const candidates = [
+        'swagger.json', 'swagger.yaml', 'swagger.yml',
+        'openapi.json', 'openapi.yaml', 'openapi.yml',
+        'api-spec.json', 'api-spec.yaml', 'api-spec.yml',
+    ];
+    const endpoints = [];
+    for (const filename of candidates) {
+        const filePath = path.join(repoPath, filename);
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            if (filename.endsWith('.json')) {
+                const spec = JSON.parse(content);
+                const paths = spec.paths;
+                if (paths) {
+                    for (const [routePath, methods] of Object.entries(paths)) {
+                        for (const method of Object.keys(methods)) {
+                            if (['get', 'post', 'put', 'patch', 'delete', 'head', 'options'].includes(method)) {
+                                endpoints.push({
+                                    method: method.toUpperCase(),
+                                    path: routePath,
+                                    source: filename,
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // File doesn't exist or can't be parsed — skip
+        }
+    }
+    return endpoints;
+}
+/** Scans source files for common route patterns. Limited to top-level files. */
+async function scanRoutePatterns(repoPath) {
+    const endpoints = [];
+    // Look in common source directories
+    const sourceDirs = ['src', 'app', 'routes', 'controllers', 'Controllers', '.'];
+    const routeRegex = /\.(get|post|put|patch|delete)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
+    const aspnetRegex = /\[Http(Get|Post|Put|Patch|Delete)\s*\(\s*"([^"]+)"\s*\)\]/gi;
+    for (const dir of sourceDirs) {
+        const dirPath = path.join(repoPath, dir);
+        let entries;
+        try {
+            entries = await fs.readdir(dirPath);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const ext = path.extname(entry).toLowerCase();
+            if (!['.ts', '.js', '.cs', '.py'].includes(ext))
+                continue;
+            const filePath = path.join(dirPath, entry);
+            try {
+                const stat = await fs.stat(filePath);
+                if (!stat.isFile() || stat.size > 100_000)
+                    continue; // Skip large files
+                const content = await fs.readFile(filePath, 'utf-8');
+                const relPath = path.relative(repoPath, filePath);
+                // Express/Fastify/Hono style routes
+                let match;
+                routeRegex.lastIndex = 0;
+                while ((match = routeRegex.exec(content)) !== null) {
+                    endpoints.push({
+                        method: match[1].toUpperCase(),
+                        path: match[2],
+                        source: relPath,
+                    });
+                }
+                // ASP.NET style routes
+                aspnetRegex.lastIndex = 0;
+                while ((match = aspnetRegex.exec(content)) !== null) {
+                    endpoints.push({
+                        method: match[1].toUpperCase(),
+                        path: match[2],
+                        source: relPath,
+                    });
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return endpoints;
+}
+//# sourceMappingURL=detect-apis.js.map

package/dist/analyzers/detect-apis.js.map

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

package/dist/analyzers/detect-deps.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module analyzers/detect-deps
+ * Detects dependencies declared in a repository by reading manifest files.
+ * This is used to find potential inter-repo connections (e.g., one repo
+ * consumes an npm package published by another).
+ */
+import type { RepoDependency } from '../types.js';
+/**
+ * Extracts declared dependencies from a repository's manifest files.
+ *
+ * Supports:
+ * - npm (package.json)
+ * - NuGet (*.csproj)
+ * - pip (requirements.txt)
+ * - Go (go.mod)
+ *
+ * @param repoPath - Absolute path to the repository root.
+ * @returns Array of detected {@link RepoDependency} objects.
+ */
+export declare function detectDependencies(repoPath: string): Promise<RepoDependency[]>;
+/**
+ * Given analysis of multiple repos, find which repos depend on each other.
+ * Returns a map of repo name → list of repo names it depends on.
+ *
+ * @param repoAnalyses - Map of repo path to its detected dependencies.
+ * @param repoNames    - Map of repo path to its name.
+ * @returns Map of repo name → list of repo names it depends on.
+ */
+export declare function findInterRepoDependencies(repoAnalyses: Map<string, RepoDependency[]>, repoNames: Map<string, string>): Map<string, string[]>;
+//# sourceMappingURL=detect-deps.d.ts.map

package/dist/analyzers/detect-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-deps.d.ts","sourceRoot":"","sources":["../../src/analyzers/detect-deps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA6EpF;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAC3C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAuBvB"}