mcp-architector 1.2.3 → 1.6.0

package/README.md

@@ -51,15 +51,54 @@ Store and manage project architecture, modules, scripts, data flow, and usage ex
 ```
 ~/.mcp-architector/
 └── {projectId}/
-    ├── architecture.json      # Overall architecture
+    ├── architecture.json      # Modules + dataFlow (vertical structure)
     ├── modules/
-    │   ├── {moduleId}.json    # Module details
+    │   ├── {moduleId}.json
     │   └── ...
-    └── scripts/
-        ├── {scriptId}.json    # Script documentation
-        └── ...
+    ├── entries/
+    │   ├── index.json         # Catalog (no duplicate bodies)
+    │   └── {entryId}.json     # Canonical facts (API, domain, flows, …)
+    ├── slices/
+    │   └── {sliceId}.json     # Custom filters only (no items)
 ```
 
+## Data model
+
+| Layer | Purpose | Tools |
+|-------|---------|-------|
+| **Modules** | Vertical structure: components, dependencies, dataFlow | `set-project-architecture`, `set-module-details`, `set-module-data-flow`, `rebuild-data-flow`, `validate-architecture` |
+| **Entries** | Single source of truth for horizontal facts (one fact = one file) | `set-entry`, `set-entries`, `get-entry`, `list-entries` |
+| **Slices** | Read-only views over entries (built-in or custom filters) | `list-slices`, `get-slice` |
+
+**Anti-patterns (no duplication):** Do not copy `module.description` into `entry.summary`. Link with `refs.moduleName`. Slices never store item copies—only filters in `slices/*.json`.
+
+**Do not edit `~/.mcp-architector` directly** — always use MCP tools so timestamps, merge semantics, and dataFlow inverse sync stay consistent.
+
+## Agent workflow
+
+1. `list-projects` — confirm `projectId` if data looks empty or wrong.
+2. **Structure task** → `get-project-architecture` / `set-project-architecture`.
+3. **Each module** → `set-module-details` with `files` + **`facts[]`** (endpoints, entities, glossary) in the same call, or `set-entries` / `set-entry` with `refs.moduleName`.
+4. **Single module graph edge** → `set-module-data-flow`.
+5. **Bulk rebuild flow (many modules)** → `rebuild-data-flow`.
+6. **After edits, verify everything** → `validate` (summary + `issues[]`; no full project load).
+7. **Need a category** (all APIs, all domain terms) → `list-slices` → `get-slice` with `format=compact` or `table`; use `offset` when `hasMore` is true.
+8. **Find by name** → `search-entries` → `get-entry` for full payload.
+
+| Scenario | Tool |
+|----------|------|
+| Update one module + its APIs/facts | `set-module-details` with `facts[]` |
+| Bulk facts for a domain | `set-entries` with `moduleName` |
+| Patch dataFlow for one module | `set-module-data-flow` |
+| Rebuild all module edges | `rebuild-data-flow` |
+| Diagnose graph + empty slices | `validate` (or `validate-architecture`) |
+| Index out of sync | `rebuild-entry-index` |
+| Create project from scratch | `set-project-architecture` with `replaceModules: true` |
+
+**Full project picture:** modules alone do not populate slices — without `http-endpoint` (and other kinds) entries, slice `api` stays empty. New module → add `facts` or entries in the same step.
+
+Example: `set-module-details` with `facts: [{ kind: "http-endpoint", title: "POST /orders", ... }]`, then `get-slice` `sliceId=api` `format=table`.
+
 ## Quick Start
 
 ### For Users (using npm package)
@@ -219,7 +258,7 @@ When calling tools, you can:
 
 ### set-project-architecture
 
-Creates or updates the overall architecture for a project.
+Creates or updates the overall architecture for a project. **By default merges** modules and dataFlow by name; omit `dataFlow` to preserve existing flow. `dependsOn` is canonical; `providesTo` is recomputed on save.
 
 **Input:**
 - `projectId` (optional): Project ID (defaults to "default-project")
@@ -229,12 +268,14 @@ Creates or updates the overall architecture for a project.
   - `description`: Brief description of the module
   - `inputs` (optional): What this module requires to work
   - `outputs` (optional): What this module produces or generates
-- `dataFlow` (optional): Object describing data flow between modules:
+- `dataFlow` (optional): Object describing data flow between modules (omit to keep existing):
   - Key: module name
   - Value: object with:
     - `dependsOn` (optional): Array of module names this module depends on
-    - `providesTo` (optional): Array of module names that receive data from this module
+    - `providesTo` (optional): Derived on save from all `dependsOn` edges
     - `dataTransformation` (optional): How data is transformed between modules
+- `replaceModules` (optional): Replace entire modules list (default `false` = merge by name)
+- `replaceDataFlow` (optional): Replace entire dataFlow (default `false` = merge by module name)
 
 **Output:**
 - Project ID and success message
@@ -249,9 +290,46 @@ Retrieves the overall architecture of the project.
 **Output:**
 - Complete project architecture
 
+### list-projects
+
+Lists all projects in local storage (`~/.mcp-architector`). Use when the workspace may map to a different normalized `projectId`.
+
+**Input:**
+- `query` (optional): Filter by substring in projectId or description (case-insensitive)
+
+**Output:**
+- Array of project summaries: `projectId`, `description`, `moduleCount`, `updatedAt`, `isCurrent` (matches current `MCP_PROJECT_ID`)
+
+### Entries and slices
+
+| Tool | Purpose |
+|------|---------|
+| `set-entry` | Upsert one fact; response may include `reminder` if modules missing or unlinked |
+| `set-entries` | Bulk upsert (max 200); optional `moduleName` sets `refs.moduleName` on all |
+| `get-entry` | Full entry by `id` |
+| `delete-entry` | Remove entry |
+| `list-entries` | Catalog without payload; filter by `kind`, `tags`, `query` |
+| `search-entries` | Text search in title, summary, kind, tags |
+| `list-slices` | Built-in + custom slices with entry counts |
+| `get-slice` | Filtered view: `sliceId`, `format`, `query`, `limit`, `offset`, `hasMore` |
+| `set-slice` | Save custom filter (`kinds`, `tags`) — no items |
+| `delete-slice` | Remove custom slice |
+| `rebuild-entry-index` | Rebuild `entries/index.json` from entry files |
+
+**Built-in `sliceId` values:** `api`, `persistence`, `events`, `domain`, `flows`, `integrations`, `config`, `runtime`, `decisions`, `scripts`.
+
+**Recommended `kind` examples (any string allowed):**
+
+| sliceId | kinds |
+|---------|-------|
+| api | `http-endpoint`, `grpc-method`, `mcp-tool`, `cli-command`, … |
+| persistence | `db-table`, `entity`, `repository` |
+| domain | `glossary`, `invariant`, `lifecycle` |
+| scripts | `script` — use `set-entry` / `get-slice sliceId=scripts` |
+
 ### set-module-details
 
-Creates or updates detailed information about a module.
+Creates or updates detailed information about a module. **Slices read entries, not module text** — pass `facts[]` to create linked entries in one call.
 
 **Input:**
 - `projectId` (optional): Project ID
@@ -259,8 +337,9 @@ Creates or updates detailed information about a module.
 - `description`: Detailed description of the module
 - `inputs`: What the module accepts as input
 - `outputs`: What the module produces as output
-- `dependencies` (optional): List of module dependencies
+- `dependencies` (optional): List of module dependencies (syncs to `dataFlow.dependsOn` when provided)
 - `files` (optional): List of files belonging to this module
+- `facts` (optional): Array of horizontal facts (`kind`, `title`, `summary`, …) — each upserted as entry with `refs.moduleName` = module name
 - `usageExamples` (optional): Array of usage examples with fields:
   - `title`: Example title
   - `description` (optional): Description of the example
@@ -273,74 +352,86 @@ Creates or updates detailed information about a module.
 **Output:**
 - Module ID and success message
 
-### get-module-details
+### set-module-data-flow
 
-Retrieves detailed information about a specific module.
+Patches `dataFlow` for a single module without sending the full architecture.
 
 **Input:**
 - `projectId` (optional): Project ID
-- `moduleName`: Name of the module to retrieve
+- `moduleName`: Module name
+- `dependsOn` (optional): Modules this module depends on (canonical)
+- `dataTransformation` (optional): How data is transformed
+- `syncInverse` (optional): Recompute `providesTo` (default `true`)
 
 **Output:**
-- Complete module details
+- Module name and success message
 
-### list-modules
+### rebuild-data-flow
 
-Lists all modules in the project architecture.
+Rebuilds `dataFlow` for all modules from module file `dependencies` or existing `dependsOn` edges. Replaces bulk manual edits to `architecture.json`.
 
 **Input:**
 - `projectId` (optional): Project ID
+- `source` (optional): `module-dependencies` (default) or `dataFlow-dependsOn`
+- `syncInverse` (optional): Recompute `providesTo` (default `true`)
+- `pruneOrphans` (optional): Remove invalid module references (default `true`)
 
 **Output:**
-- Array of module summaries
+- `edgesAdded`, `edgesRemoved`, `modulesUpdated`, message
 
-### delete-module
+### validate
 
-Deletes a module from the project architecture.
+**Primary post-edit check.** Read-only validation with a compact agent-friendly report. Does not modify data.
 
-**Input:**
-- `projectId` (optional): Project ID
-- `moduleName`: Name of the module to delete
+**Checks (only rules we can verify from stored JSON):**
+- dataFlow: inverse drift, dangling `dependsOn`/`providesTo`, orphan flow keys
+- `module.dependencies` vs `dataFlow.dependsOn`
+- entries: `entries-without-modules`, `entry-unlinked`, `orphan-entry-module`, `module-no-entries`, `module-missing-api` / `module-missing-persistence`
+- storage: missing `modules/{id}.json`, orphan module files, entry index drift
+- slices: empty built-in `api` / `domain` / `persistence` when modules exist
+
+**Input:** `projectId`, `checkInverse`, `checkModuleDeps`, `checkEntryCoverage`, `checkStorage`, `checkEmptySlices` (all default `true`)
+
+**Output:** `valid`, `issueCount`, `summary`, `stats`, `issuesByKind`, `issues[]`, `coverage`, `checksRun`
+
+### validate-architecture
+
+Same as `validate` (legacy alias). Prefer `validate` after edits.
 
 **Output:**
-- Success message
+- `valid` (boolean), `issues` array
 
-### set-script-documentation
+### get-module-details
 
-Creates or updates documentation for a script or command.
+Retrieves detailed information about a specific module.
 
 **Input:**
 - `projectId` (optional): Project ID
-- `scriptName`: Name of the script
-- `description`: Description of what the script does
-- `usage`: Usage command or syntax
-- `examples`: Array of usage examples
-- `parameters`: Object mapping parameter names to descriptions
-- `notes` (optional): Additional notes
+- `moduleName`: Name of the module to retrieve
 
 **Output:**
-- Script ID and success message
+- Complete module details
 
-### get-script-documentation
+### list-modules
 
-Retrieves documentation for a specific script.
+Lists all modules in the project architecture.
 
 **Input:**
 - `projectId` (optional): Project ID
-- `scriptName`: Name of the script to retrieve
 
 **Output:**
-- Script documentation
+- Array of module summaries
 
-### list-scripts
+### delete-module
 
-Lists all documented scripts in the project.
+Deletes a module from the project architecture.
 
 **Input:**
 - `projectId` (optional): Project ID
+- `moduleName`: Name of the module to delete
 
 **Output:**
-- Array of script documentations
+- Success message
 
 ## Resources
 

package/README_RU.md

@@ -51,15 +51,52 @@
 ```
 ~/.mcp-architector/
 └── {projectId}/
-    ├── architecture.json      # Общая архитектура
+    ├── architecture.json      # Модули + dataFlow (вертикальная структура)
     ├── modules/
-    │   ├── {moduleId}.json    # Детали модуля
+    │   ├── {moduleId}.json
     │   └── ...
-    └── scripts/
-        ├── {scriptId}.json    # Документация скрипта
-        └── ...
+    ├── entries/
+    │   ├── index.json         # Каталог без дублирования тел
+    │   └── {entryId}.json     # Канонические факты (API, домен, flows, …)
+    ├── slices/
+    │   └── {sliceId}.json     # Только фильтры (без items)
 ```
 
+## Модель данных
+
+| Слой | Назначение | Инструменты |
+|------|------------|-------------|
+| **Модули** | Вертикальная структура: компоненты, dataFlow | `set-project-architecture`, `set-module-details`, `set-module-data-flow`, `rebuild-data-flow`, `validate-architecture` |
+| **Entries** | Единственный источник фактов (один факт = один файл) | `set-entry`, `set-entries`, `get-entry`, `list-entries` |
+| **Slices** | Представления над entries (встроенные или свои фильтры) | `list-slices`, `get-slice` |
+
+**Анти-паттерны:** не копировать `module.description` в `entry.summary`; связь через `refs.moduleName`. Срезы не хранят копии items.
+
+**Не редактируйте `~/.mcp-architector` напрямую** — используйте MCP tools, чтобы сохранялись timestamps, merge-семантика и синхронизация inverse для dataFlow.
+
+## Сценарий для агента
+
+1. `list-projects` — проверить `projectId`.
+2. Структура → `get-project-architecture` / `set-project-architecture`.
+3. **Каждый модуль** → `set-module-details` с `files` + **`facts[]`** (API, entity, glossary) в одном вызове, или `set-entries` / `set-entry` с `refs.moduleName`.
+4. Граф одного модуля → `set-module-data-flow`.
+5. Массовый пересчёт flow → `rebuild-data-flow`.
+6. После правок → `validate` (краткий отчёт и `issues[]`, без загрузки всего проекта).
+7. Категория (все API, домен) → `list-slices` → `get-slice`; при `hasMore` — `offset`.
+8. Поиск по имени → `search-entries` → `get-entry`.
+
+| Сценарий | Tool |
+|----------|------|
+| Модуль + его факты | `set-module-details` с `facts[]` |
+| Массовые факты | `set-entries` с `moduleName` |
+| Patch dataFlow одного модуля | `set-module-data-flow` |
+| Пересчитать все рёбра | `rebuild-data-flow` |
+| Проверка после правок | `validate` |
+| Рассинхрон index | `rebuild-entry-index` |
+| Проект с нуля | `set-project-architecture` с `replaceModules: true` |
+
+**Полная картина проекта:** одних модулей недостаточно для slices — без entries с `http-endpoint` срез `api` пуст. Новый модуль → `facts` или entries в том же шаге.
+
 ## Быстрый старт
 
 ### Для пользователей (через npm)
@@ -218,13 +255,15 @@ npm run inspector
 
 ### set-project-architecture
 
-Создаёт или обновляет общую архитектуру проекта.
+Создаёт или обновляет общую архитектуру проекта. **По умолчанию merge** modules и dataFlow по имени; omit `dataFlow` сохраняет существующий flow. `dependsOn` — канон; `providesTo` пересчитывается при сохранении.
 
 **Вход:**
 - `projectId` (опц.): ID проекта (по умолчанию "default-project")
 - `description`: Описание проекта
 - `modules`: Массив модулей с полями `name`, `description`, `inputs`, `outputs`
-- `dataFlow` (опц.): Поток данных между модулями
+- `dataFlow` (опц.): Поток данных между модулями (omit — сохранить существующий)
+- `replaceModules` (опц.): Полная замена списка модулей (default `false` = merge)
+- `replaceDataFlow` (опц.): Полная замена dataFlow (default `false` = merge)
 
 **Выход:** ID проекта и сообщение об успехе
 
@@ -232,33 +271,74 @@ npm run inspector
 
 Получает архитектуру проекта.
 
+### list-projects
+
+Список всех проектов в локальном хранилище (`~/.mcp-architector`). Нужен, когда workspace может соответствовать другому нормализованному `projectId`.
+
+**Вход:**
+- `query` (опц.): Фильтр по подстроке в projectId или description (без учёта регистра)
+
+**Выход:**
+- Массив кратких записей: `projectId`, `description`, `moduleCount`, `updatedAt`, `isCurrent` (совпадает с текущим `MCP_PROJECT_ID`)
+
+### Entries и slices
+
+| Tool | Назначение |
+|------|------------|
+| `set-entry` | Upsert факта; в ответе `reminder`, если нет модулей или нет `refs.moduleName` |
+| `set-entries` | Массовый upsert (до 200); `moduleName` проставляет `refs.moduleName` |
+| `get-entry` | Полная entry по `id` |
+| `delete-entry` | Удаление |
+| `list-entries` | Каталог без payload |
+| `search-entries` | Поиск по тексту |
+| `list-slices` | Встроенные и custom срезы |
+| `get-slice` | Срез: `sliceId`, `format`, `query`, `limit`, `offset`, `hasMore` |
+| `set-slice` / `delete-slice` | Custom фильтр (без items) |
+| `rebuild-entry-index` | Пересборка `entries/index.json` |
+
+**Встроенные sliceId:** `api`, `persistence`, `events`, `domain`, `flows`, `integrations`, `config`, `runtime`, `decisions`, `scripts`.
+
+Команды: `set-entry` с `kind=script` или `get-slice sliceId=scripts`. При первом обращении к entries старая папка `scripts/` мигрируется и удаляется.
+
 ### set-module-details
 
-Создаёт или обновляет детали модуля.
+Создаёт или обновляет детали модуля. Срезы читают **entries**, не текст модуля — передавайте `facts[]` для API/домена в том же вызове. При `dependencies` синхронизирует `dataFlow.dependsOn`.
 
-### get-module-details
+### set-module-data-flow
 
-Получает детали модуля.
+Patch `dataFlow` одного модуля: `moduleName`, `dependsOn`, `dataTransformation`, `syncInverse`.
 
-### list-modules
+### rebuild-data-flow
 
-Список всех модулей проекта.
+Пересборка `dataFlow` для всех модулей из `dependencies` в module files или из `dependsOn`. Замена массовой правки `architecture.json`.
 
-### delete-module
+**Вход:** `source` (`module-dependencies` | `dataFlow-dependsOn`), `syncInverse`, `pruneOrphans`.
 
-Удаляет модуль из архитектуры.
+**Выход:** `edgesAdded`, `edgesRemoved`, `modulesUpdated`.
 
-### set-script-documentation
+### validate
 
-Документация скрипта или команды.
+**Главная проверка после правок.** Read-only отчёт для агента: `summary`, `stats`, `issuesByKind`, `issues[]` — не нужно тянуть весь проект.
 
-### get-script-documentation
+**Проверяет:** dataFlow, связь модуль↔entry, файлы модулей, рассинхрон index, пустые срезы api/domain/persistence.
 
-Получает документацию скрипта.
+**Выход:** `valid`, `issueCount`, `summary`, `coverage`, `checksRun`.
 
-### list-scripts
+### validate-architecture
 
-Список всех задокументированных скриптов.
+То же, что `validate` (алиас). Предпочтительно вызывать `validate`.
+
+### get-module-details
+
+Получает детали модуля.
+
+### list-modules
+
+Список всех модулей проекта.
+
+### delete-module
+
+Удаляет модуль из архитектуры.
 
 ## Ресурсы
 

package/dist/agent-hints.d.ts

@@ -0,0 +1,10 @@
+export declare const MODULE_ENTRIES_REMINDER: string;
+export declare const ENTRIES_MODULE_REMINDER: string;
+export declare function suggestKindsFromFiles(files: string[]): string[];
+export interface EntryLinkHints {
+    reminder?: string;
+    warning?: string;
+    suggestedModuleNames?: string[];
+}
+export declare function buildEntryLinkHints(moduleNames: string[], refsModuleName?: string): EntryLinkHints;
+//# sourceMappingURL=agent-hints.d.ts.map

package/dist/agent-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-hints.d.ts","sourceRoot":"","sources":["../src/agent-hints.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,QAIgC,CAAC;AAErE,eAAO,MAAM,uBAAuB,QAG0D,CAAC;AAE/F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAgB/D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EAAE,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,cAAc,CAoBhB"}

package/dist/agent-hints.js

@@ -0,0 +1,42 @@
+export const MODULE_ENTRIES_REMINDER = 'After saving a module, add horizontal facts as entries (or pass facts[] here): ' +
+    'http-endpoint for controllers, entity/repository for persistence, glossary for domain. ' +
+    'Slices (api, domain, persistence) read entries only—modules alone leave slices empty. ' +
+    'Link via refs.moduleName; use list-slices for recommended kinds.';
+export const ENTRIES_MODULE_REMINDER = 'Entries need vertical structure: create modules via set-project-architecture / set-module-details ' +
+    'before or when adding entries. Set refs.moduleName to an existing module name from list-modules. ' +
+    'Run validate after edits to find entries-without-modules, entry-unlinked, or empty slices.';
+export function suggestKindsFromFiles(files) {
+    const kinds = new Set();
+    for (const file of files) {
+        const lower = file.toLowerCase();
+        const base = file.split('/').pop() ?? file;
+        if (/controller/i.test(base) || lower.endsWith('.http')) {
+            kinds.add('http-endpoint');
+        }
+        if (/repository/i.test(base)) {
+            kinds.add('repository');
+        }
+        if (/entity/i.test(base) && !/repository/i.test(base)) {
+            kinds.add('entity');
+        }
+    }
+    return [...kinds];
+}
+export function buildEntryLinkHints(moduleNames, refsModuleName) {
+    const hints = {};
+    if (moduleNames.length === 0) {
+        hints.reminder = ENTRIES_MODULE_REMINDER;
+        return hints;
+    }
+    if (!refsModuleName?.trim()) {
+        hints.reminder = ENTRIES_MODULE_REMINDER;
+        hints.suggestedModuleNames = moduleNames;
+        return hints;
+    }
+    if (!moduleNames.includes(refsModuleName)) {
+        hints.warning = `refs.moduleName '${refsModuleName}' does not match any module (orphan-entry-module).`;
+        hints.suggestedModuleNames = moduleNames;
+    }
+    return hints;
+}
+//# sourceMappingURL=agent-hints.js.map

package/dist/agent-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-hints.js","sourceRoot":"","sources":["../src/agent-hints.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAClC,iFAAiF;IACjF,yFAAyF;IACzF,wFAAwF;IACxF,kEAAkE,CAAC;AAErE,MAAM,CAAC,MAAM,uBAAuB,GAClC,oGAAoG;IACpG,mGAAmG;IACnG,4FAA4F,CAAC;AAE/F,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACnD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;QAC3C,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAQD,MAAM,UAAU,mBAAmB,CACjC,WAAqB,EACrB,cAAuB;IAEvB,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,QAAQ,GAAG,uBAAuB,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,KAAK,CAAC,QAAQ,GAAG,uBAAuB,CAAC;QACzC,KAAK,CAAC,oBAAoB,GAAG,WAAW,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,OAAO,GAAG,oBAAoB,cAAc,oDAAoD,CAAC;QACvG,KAAK,CAAC,oBAAoB,GAAG,WAAW,CAAC;IAC3C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/data-flow.d.ts

@@ -0,0 +1,22 @@
+import type { DataFlow, ModuleDetails, ModuleSummary, ProjectArchitecture, ValidationIssue } from "./types.js";
+export declare function recomputeProvidesTo(dataFlow: DataFlow, moduleNames: string[]): DataFlow;
+export declare function syncModuleDependsOn(dataFlow: DataFlow, moduleName: string, dependsOn: string[], moduleNames: string[]): DataFlow;
+export declare function buildDataFlowFromModules(modules: ModuleSummary[], moduleDetailsMap: Map<string, ModuleDetails>): DataFlow;
+export declare function buildDataFlowFromDependsOn(dataFlow: DataFlow, moduleNames: string[]): DataFlow;
+export declare function pruneDataFlow(dataFlow: DataFlow, validNames: string[]): DataFlow;
+export declare function removeModuleFromDataFlow(dataFlow: DataFlow | undefined, moduleName: string): DataFlow | undefined;
+export declare function mergeModules(existing: ModuleSummary[] | undefined, incoming: ModuleSummary[], options: {
+    replace: boolean;
+}): ModuleSummary[];
+export declare function mergeDataFlow(existing: DataFlow | undefined, incoming: DataFlow | undefined, options: {
+    replace: boolean;
+}): DataFlow | undefined;
+export declare function validateDataFlow(architecture: ProjectArchitecture, moduleDetailsMap: Map<string, ModuleDetails>, options?: {
+    checkInverse?: boolean;
+    checkModuleDeps?: boolean;
+}): ValidationIssue[];
+export declare function diffFlowEdges(before: DataFlow | undefined, after: DataFlow | undefined): {
+    edgesAdded: number;
+    edgesRemoved: number;
+};
+//# sourceMappingURL=data-flow.d.ts.map

package/dist/data-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-flow.d.ts","sourceRoot":"","sources":["../src/data-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,eAAe,EAChB,MAAM,YAAY,CAAC;AAmBpB,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,CAqCvF;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EAAE,GACpB,QAAQ,CAOV;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,EAAE,EACxB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAC3C,QAAQ,CASV;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,CAY9F;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,QAAQ,CAuBhF;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,GACjB,QAAQ,GAAG,SAAS,CAwBtB;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,EAAE,GAAG,SAAS,EACrC,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC5B,aAAa,EAAE,CASjB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,OAAO,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC5B,QAAQ,GAAG,SAAS,CAetB;AAED,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,mBAAmB,EACjC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EAC5C,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAClE,eAAe,EAAE,CAkEnB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,QAAQ,GAAG,SAAS,EAC5B,KAAK,EAAE,QAAQ,GAAG,SAAS,GAC1B;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAgB9C"}