@mf-toolkit/shared-inspector 0.3.2 → 0.4.0

package/README.md

@@ -4,7 +4,9 @@
 [![license](https://img.shields.io/npm/l/@mf-toolkit/shared-inspector?color=blue)](https://github.com/zvitaly7/mf-toolkit/blob/main/LICENSE)
 [![node](https://img.shields.io/node/v/@mf-toolkit/shared-inspector?color=339933&logo=node.js)](https://nodejs.org)
 
-Build-time analyser for Module Federation `shared` dependencies. Two-phase architecture: **collect facts → analyse facts**.
+**Stop debugging Module Federation in production.**
+
+`shared` config breaks in silence — wrong versions ship, 10× React ends up in the bundle, singleton chains collapse, and teams get paged for "Invalid hook call" on Friday night. `shared-inspector` catches these mistakes at build time. Every finding comes with a risk score and a ready-to-paste fix.
 
 ## The problem
 
@@ -22,43 +24,171 @@ Existing tools (webpack-bundle-analyzer, source-map-explorer) show *what ended u
 npm install --save-dev @mf-toolkit/shared-inspector
 ```
 
+## CLI
+
+The fastest way to get started — no config file, no webpack required:
+
+```bash
+# Analyse the current project (auto-reads name from package.json)
+npx @mf-toolkit/shared-inspector
+
+# Step-by-step interactive wizard — answers guide you through all options
+npx @mf-toolkit/shared-inspector --interactive
+
+# Pass options directly
+npx @mf-toolkit/shared-inspector --source ./src --shared react,react-dom --fail-on mismatch
+
+# Load shared config from a JSON file
+npx @mf-toolkit/shared-inspector --shared ./shared-config.json --write-manifest
+
+# Cross-MF federation analysis from saved manifests
+npx @mf-toolkit/shared-inspector federation checkout.json catalog.json cart.json
+```
+
+### Interactive wizard
+
+```
+$ npx @mf-toolkit/shared-inspector --interactive
+
+[MfSharedInspector] Interactive setup
+
+Source directories to scan (default: ./src):
+Scan depth — direct or local-graph (default: local-graph):
+Shared packages — comma-separated names or path to .json (empty to skip): react,react-dom,mobx
+Path to tsconfig.json for alias resolution (empty to skip):
+Workspace packages to exclude, comma-separated (empty to skip):
+Fail build on findings — mismatch / unused / any / none (default: none): mismatch
+Write project-manifest.json? (y/N): n
+```
+
+### CLI reference
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--source, -s <dirs>` | `./src` | Source dirs to scan, comma-separated |
+| `--depth <depth>` | `local-graph` | Scan depth: `direct` \| `local-graph` |
+| `--shared <packages\|file>` | — | Comma-separated package names or path to `.json` config |
+| `--tsconfig <path>` | — | tsconfig.json for path alias resolution |
+| `--workspace-packages <pkgs>` | — | Comma-separated workspace packages to exclude |
+| `--name <name>` | auto from `package.json` | Project name |
+| `--fail-on <rule>` | — | Exit 1 when findings match: `mismatch` \| `unused` \| `any` |
+| `--write-manifest` | `false` | Write `project-manifest.json` to output dir |
+| `--output-dir <dir>` | `.` | Output directory for manifest |
+| `--interactive, -i` | — | Launch step-by-step wizard |
+| `--version, -v` | — | Print version and exit |
+| `--help, -h` | — | Show help |
+
+## Terminal output
+
+Each finding is rendered as a diagnostic card: what's wrong, what breaks at runtime, and a ready-to-paste fix.
+
+```
+  mf-inspector  v0.4.0
+
+✓  Scanned 47 files
+
+[MfSharedInspector] checkout (depth: local-graph, 47 files scanned)
+────────────────────────────────────────────────────────────
+
+⚠  Version Mismatch — react
+   configured: ^18.0.0 | installed: 17.0.2
+   → Risk: Invalid hook call, broken context across MFs
+   💡 Fix:
+   shared: {
+     react: { singleton: true, requiredVersion: "^18.0.0" }
+   }
+
+✗  Unused Shared — lodash
+   0 imports, shared without singleton
+   → Wastes bundle negotiation overhead with no benefit
+   💡 Fix: Remove "lodash" from shared config
+
+→  Not Shared — mobx (12 imports in 8 files via re-export in src/shared/index.ts)
+   → Risk: Each MF gets its own MobX — observables and reactions won't sync between MFs
+   💡 Fix:
+   shared: {
+     mobx: { singleton: true }
+   }
+
+────────────────────────────────────────────────────────────
+Score: 62/100  🟠 RISKY
+
+Issues:
+  🔴  1 high    — version mismatch
+  🟠  1 medium  — singleton gaps, duplicate libs
+  🟡  1 low     — over-sharing
+
+Total: 12 shared, 10 used, 1 unused, 1 candidates, 1 mismatch, 0 eager risks
+```
+
+Colors are auto-applied in TTY terminals and disabled in CI / piped output (`NO_COLOR` / `TERM=dumb` respected).
+
+## Risk scoring
+
+Every report ends with a score out of 100:
+
+| Severity | Penalty | Covers |
+|----------|---------|--------|
+| 🔴 HIGH | −20 each | Version mismatches, cross-MF version conflicts |
+| 🟠 MEDIUM | −8 each | Singleton risks, eager risks, duplicate libs, host gaps |
+| 🟡 LOW | −3 each | Unused shared packages, ghost shares |
+
+| Score | Label |
+|-------|-------|
+| 90–100 | ✅ HEALTHY |
+| 70–89 | 🟡 GOOD |
+| 40–69 | 🟠 RISKY |
+| 0–39 | 🔴 CRITICAL |
+
+Use `scoreProjectReport` / `scoreFederationReport` programmatically to integrate with dashboards or custom CI gates:
+
+```typescript
+import { analyzeProject, scoreProjectReport } from '@mf-toolkit/shared-inspector';
+
+const report = analyzeProject(manifest);
+const { score, label, high, medium, low } = scoreProjectReport(report);
+
+if (score < 70) {
+  console.error(`Shared config score: ${score}/100 (${label})`);
+  process.exit(1);
+}
+```
+
 ## Quick start
 
 ### Programmatic API (two-phase)
 
 ```typescript
-import { buildProjectManifest, analyzeProject } from '@mf-toolkit/shared-inspector';
+import { buildProjectManifest, analyzeProject, formatReport } from '@mf-toolkit/shared-inspector';
 
 // Phase 1: collect facts
 const manifest = await buildProjectManifest({
   name: 'checkout',
   sourceDirs: ['./src'],
   sharedConfig: {
-    react: { singleton: true, requiredVersion: '^19.0.0' },
-    'react-dom': { singleton: true, requiredVersion: '^19.0.0' },
+    react: { singleton: true, requiredVersion: '^18.0.0' },
+    'react-dom': { singleton: true, requiredVersion: '^18.0.0' },
     lodash: {},
   },
-  // depth: 'local-graph'       ← default, follows barrel re-exports
-  // tsconfigPath: './tsconfig.json'  ← optional, resolves @alias/* imports
+  // depth: 'local-graph'            ← default, follows barrel re-exports
+  // tsconfigPath: './tsconfig.json' ← optional, resolves @alias/* imports
   // workspacePackages: ['@my-org/*'] ← optional, excludes local monorepo packages
 });
 
 // Phase 2: analyse facts
-const report = analyzeProject(manifest, {
-  alwaysShared: ['react', 'react-dom'],
-});
+const report = analyzeProject(manifest);
 
-console.log(report.unused);
-// [{ package: 'lodash', singleton: false }]
+console.log(report.mismatched);
+// [{ package: 'react', configured: '^18.0.0', installed: '17.0.2' }]
 
 console.log(report.candidates);
 // [{ package: 'mobx', importCount: 12, via: 'reexport', files: ['src/shared/index.ts'] }]
 
-console.log(report.mismatched);
-// [{ package: 'react', configured: '^19.0.0', installed: '18.3.1' }]
+console.log(report.unused);
+// [{ package: 'lodash', singleton: false }]
 
-console.log(report.eagerRisks);
-// [{ package: 'react-dom' }]  ← eager: true without singleton: true
+// Human-readable output with risk descriptions and fix snippets
+console.log(formatReport(report, { name: manifest.project.name }));
 ```
 
 ### Shortcut API
@@ -97,15 +227,6 @@ module.exports = {
 };
 ```
 
-Pass `sharedConfig` explicitly to override auto-extraction:
-
-```typescript
-new MfSharedInspectorPlugin({
-  sourceDirs: ['./src'],
-  sharedConfig: { react: { singleton: true, requiredVersion: '^18.0.0' } },
-})
-```
-
 ## Analysis depth
 
 | Depth | What it finds | Speed |
@@ -119,113 +240,62 @@ The difference matters when your project uses barrel files:
 // src/shared/index.ts
 export { observer } from 'mobx-react';    // re-export
 export { makeAutoObservable } from 'mobx'; // re-export
-```
 
-```ts
 // src/app.tsx
 import { observer } from './shared';  // relative import — direct mode stops here
 ```
 
-- **`depth: 'direct'`** scans `app.tsx`, sees `./shared` (relative) → skips. `mobx` not found.
-- **`depth: 'local-graph'`** follows `./shared` → `shared/index.ts` → finds `mobx` and `mobx-react` via re-export.
+- **`depth: 'direct'`** sees `./shared` (relative) → skips. `mobx` not found.
+- **`depth: 'local-graph'`** follows `./shared` → finds `mobx` and `mobx-react` via re-export.
 
 ## TypeScript path aliases
 
-When your project uses `paths` in `tsconfig.json`, pass `tsconfigPath` so the traverser follows aliased imports into local files instead of treating them as external packages:
-
 ```typescript
 // tsconfig.json
-{ "compilerOptions": { "baseUrl": ".", "paths": { "@components/*": ["src/components/*"] } } }
+{ "compilerOptions": { "paths": { "@components/*": ["src/components/*"] } } }
 
-// src/app.tsx
-import { Button } from '@components/Button'; // ← followed as local file, not external package
-```
-
-```typescript
 await buildProjectManifest({
   sourceDirs: ['./src'],
   tsconfigPath: './tsconfig.json', // enables alias resolution
 });
 ```
 
-Without `tsconfigPath`, `@components/Button` is treated as an external package name and packages imported inside it are invisible in local-graph mode.
-
-## Workspace packages
-
-In a monorepo where local packages import each other, use `workspacePackages` to prevent internal packages from appearing in `resolvedPackages`:
-
-```typescript
-await buildProjectManifest({
-  sourceDirs: ['./src'],
-  workspacePackages: ['@my-org/design-system', '@my-org/*'],
-});
-```
-
-## Terminal output
-
-```
-[MfSharedInspector] checkout (depth: local-graph, 47 files scanned)
-
-  Version mismatch (sharing silently broken):
-    ⚠ react — requires ^19.0.0, installed 18.3.1
-
-  Unused shared (safe to remove):
-    ✗ lodash — 0 imports, shared without singleton
-    ✗ @tanstack/react-query — 0 imports, shared as singleton
-
-  Candidates (consider adding to shared):
-    → mobx (12 imports in 8 files, via re-export in src/shared/index.ts)
-    → react-router-dom (6 imports in 4 files)
-
-  Singleton risks (add singleton: true):
-    ⚠ react-router-dom — manages global state, singleton: true recommended
-
-  Eager risks (add singleton: true or remove eager: true):
-    ⚠ react-dom — eager: true without singleton: true, risk of duplicate instances
-
-  Total: 12 shared, 10 used, 2 unused, 2 candidates, 1 mismatch, 1 eager risks
-```
+Without `tsconfigPath`, `@components/Button` is treated as an external package and packages imported inside it are invisible in `local-graph` mode.
 
 ## CI pipeline: project → federation
 
-Each microfrontend generates a manifest as a build artifact:
+Each microfrontend generates a manifest as a build artifact, then they're aggregated for cross-team analysis:
 
 ```yaml
+# .github/workflows/build.yml
 jobs:
   build-checkout:
     steps:
       - run: npm run build   # MfSharedInspectorPlugin writes project-manifest.json
       - uses: actions/upload-artifact@v4
-        with:
-          name: manifest-checkout
-          path: project-manifest.json
+        with: { name: manifest-checkout, path: project-manifest.json }
 ```
 
-Each MF manifest can then be aggregated for cross-team analysis:
-
 ```typescript
-import { analyzeFederation, formatFederationReport } from '@mf-toolkit/shared-inspector';
+import { analyzeFederation, formatFederationReport, scoreFederationReport } from '@mf-toolkit/shared-inspector';
 
 const report = analyzeFederation([checkoutManifest, catalogManifest, cartManifest]);
-console.log(formatFederationReport(report));
-```
+const { score, label } = scoreFederationReport(report);
 
+console.log(formatFederationReport(report));
+// ⚠  Version Conflict — react
+//    checkout: ^17.0.0
+//    catalog: ^18.0.0
+//    → Risk: MF singleton negotiation will silently load wrong version → Invalid hook call
+//    💡 Fix: shared: { react: { singleton: true, requiredVersion: "^18.0.0" } }
+//
+// Score: 60/100  🟠 RISKY
 ```
-[MfSharedInspector] federation analysis (3 MFs)
-
-  Version conflicts (singleton negotiation will fail):
-    ⚠ react — checkout: ^17.0.0, catalog: ^18.0.0
 
-  Singleton mismatches (add singleton: true to all MFs):
-    ⚠ mobx — singleton in [checkout], not singleton in [catalog, cart]
+Or use the CLI directly:
 
-  Host gaps (add to shared — each MF bundles its own copy):
-    → axios — used by [checkout, catalog], not in shared
-
-  Ghost shares (remove from shared — no other MF benefits):
-    ✗ lodash — shared only by cart, unused by all other MFs
-
-  Total: 3 MFs, 1 version conflicts, 1 singleton mismatches, 1 host gaps, 1 ghost shares
+```bash
+npx @mf-toolkit/shared-inspector federation checkout.json catalog.json cart.json
 ```
 
 ## API reference
@@ -253,6 +323,20 @@ console.log(formatFederationReport(report));
 | `additionalCandidates` | `string[]` | `[]` | Extend built-in candidates list |
 | `additionalSingletonRisks` | `string[]` | `[]` | Extend built-in singleton-risk list |
 
+### `scoreProjectReport(report)` / `scoreFederationReport(report)`
+
+Returns a `RiskScore`:
+
+```typescript
+interface RiskScore {
+  score: number;                           // 0–100, higher is better
+  label: 'HEALTHY' | 'GOOD' | 'RISKY' | 'CRITICAL';
+  high: number;                            // count of high-severity findings
+  medium: number;                          // count of medium-severity findings
+  low: number;                             // count of low-severity findings
+}
+```
+
 ### `analyzeFederation(manifests, options?)`
 
 Accepts N `ProjectManifest` objects (one per microfrontend) and returns a `FederationReport`.
@@ -261,20 +345,12 @@ Accepts N `ProjectManifest` objects (one per microfrontend) and returns a `Feder
 |--------|------|---------|-------------|
 | `alwaysShared` | `string[]` | `['react','react-dom']` | Exclude from ghost/gap detection |
 
-### `formatFederationReport(report)`
-
-Formats a `FederationReport` as a human-readable terminal string.
-
 ### `MfSharedInspectorPlugin` options
 
 Extends all `buildProjectManifest` options (except `name`, auto-resolved from compiler) plus:
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `sourceDirs` | `string[]` | — | Directories to scan |
-| `sharedConfig` | `Record<string, SharedDepConfig>` | auto-extracted | Override auto-extraction from `ModuleFederationPlugin` |
-| `tsconfigPath` | `string` | `undefined` | tsconfig.json for path alias resolution |
-| `workspacePackages` | `string[]` | `[]` | Local monorepo packages to exclude |
 | `warn` | `boolean` | `true` | Print findings to console |
 | `failOn` | `'mismatch' \| 'unused' \| 'any'` | `undefined` | Fail the build when findings match |
 | `writeManifest` | `boolean` | `false` | Write `project-manifest.json` to `outputDir` |
@@ -285,37 +361,29 @@ Extends all `buildProjectManifest` options (except `name`, auto-resolved from co
 
 ### Per-project (`analyzeProject`)
 
-| Category | Type | Description |
-|----------|------|-------------|
-| `mismatched` | Deterministic | `requiredVersion` doesn't satisfy installed version |
-| `unused` | Deterministic* | In `shared` config but not observed in scanned sources |
-| `candidates` | Heuristic | Observed packages not in `shared` that are typically shared |
-| `singletonRisks` | Heuristic | Global-state packages shared without `singleton: true` |
-| `eagerRisks` | Heuristic | `eager: true` without `singleton: true` — risk of duplicate instances |
-
-*Within the visibility of the chosen depth.*
+| Category | Severity | Description |
+|----------|----------|-------------|
+| `mismatched` | 🔴 HIGH | `requiredVersion` doesn't satisfy installed version |
+| `singletonRisks` | 🟠 MEDIUM | Global-state packages shared without `singleton: true` |
+| `eagerRisks` | 🟠 MEDIUM | `eager: true` without `singleton: true` |
+| `candidates` | 🟠 MEDIUM | Used packages missing from `shared` (each MF bundles own copy) |
+| `unused` | 🟡 LOW | In `shared` config but not observed in scanned sources |
 
 ### Cross-MF (`analyzeFederation`)
 
-| Category | Type | Description |
-|----------|------|-------------|
-| `versionConflicts` | Deterministic | `requiredVersion` ranges across MFs have no overlap |
-| `singletonMismatches` | Deterministic | `singleton: true` in some MFs, absent in others |
-| `hostGaps` | Heuristic | Package used by 2+ MFs but not declared in `shared` by anyone |
-| `ghostShares` | Heuristic | Package in `shared` of one MF, unused/unshared by all others |
+| Category | Severity | Description |
+|----------|----------|-------------|
+| `versionConflicts` | 🔴 HIGH | `requiredVersion` ranges across MFs have no overlap |
+| `singletonMismatches` | 🟠 MEDIUM | `singleton: true` in some MFs, absent in others |
+| `hostGaps` | 🟠 MEDIUM | Package used by 2+ MFs but not declared in `shared` by anyone |
+| `ghostShares` | 🟡 LOW | Package in `shared` of one MF, unused/unshared by all others |
 
 ## Known limitations
 
-- **TypeScript path aliases without `tsconfigPath`**: aliased imports are treated as external package names. Pass `tsconfigPath` to resolve them correctly.
+- **TypeScript path aliases without `tsconfigPath`**: aliased imports are treated as external package names.
 - **Dynamic imports with variables** (`import(moduleName)`): not analysed — requires runtime information.
-- **Exact tsconfig alias patterns** (non-wildcard, e.g. `"@root": ["."]`): not supported, only `"@alias/*"` wildcard form.
-- **Subclassed `ModuleFederationPlugin`**: auto-extraction matches by constructor name. A custom subclass (`class MyMFP extends ModuleFederationPlugin`) won't be detected — pass `sharedConfig` explicitly in that case.
-
-## Demo
-
-```bash
-npx tsx packages/shared-inspector/demo/run.ts
-```
+- **Exact tsconfig alias patterns** (non-wildcard): only `"@alias/*"` wildcard form is supported.
+- **Subclassed `ModuleFederationPlugin`**: auto-extraction matches by constructor name — pass `sharedConfig` explicitly for custom subclasses.
 
 ## License
 

package/dist/cli/args.d.ts

@@ -0,0 +1,5 @@
+import type { CliArgs } from './types.js';
+import type { SharedDepConfig } from '../types.js';
+export declare function parseArgs(argv: string[]): CliArgs;
+export declare function parseSharedValue(value: string): Record<string, SharedDepConfig>;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAuFjD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAS/E"}

package/dist/cli/args.js

@@ -0,0 +1,98 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+const VALID_DEPTHS = new Set(['direct', 'local-graph']);
+const VALID_FAIL_ON = new Set(['mismatch', 'unused', 'any']);
+export function parseArgs(argv) {
+    const args = {
+        command: 'project',
+        interactive: false,
+        sourceDirs: [],
+        depth: 'local-graph',
+        workspacePackages: [],
+        writeManifest: false,
+        outputDir: '.',
+        manifestFiles: [],
+    };
+    if (argv[0] === 'federation') {
+        args.command = 'federation';
+        for (let i = 1; i < argv.length; i++) {
+            if (argv[i] === '--help' || argv[i] === '-h') {
+                args.command = 'help';
+                break;
+            }
+            if (!argv[i].startsWith('-')) {
+                args.manifestFiles.push(argv[i]);
+            }
+        }
+        return args;
+    }
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                args.command = 'help';
+                break;
+            case '--version':
+            case '-v':
+                args.command = 'version';
+                break;
+            case '--interactive':
+            case '-i':
+                args.interactive = true;
+                break;
+            case '--source':
+            case '-s':
+                args.sourceDirs.push(...(argv[++i] ?? '').split(',').filter(Boolean));
+                break;
+            case '--depth': {
+                const val = argv[++i] ?? '';
+                if (!VALID_DEPTHS.has(val)) {
+                    throw new Error(`Invalid --depth value "${val}". Expected: direct | local-graph`);
+                }
+                args.depth = val;
+                break;
+            }
+            case '--shared':
+                args.sharedConfig = parseSharedValue(argv[++i] ?? '');
+                break;
+            case '--tsconfig':
+                args.tsconfigPath = argv[++i];
+                break;
+            case '--workspace-packages':
+                args.workspacePackages.push(...(argv[++i] ?? '').split(',').filter(Boolean));
+                break;
+            case '--fail-on': {
+                const val = argv[++i] ?? '';
+                if (!VALID_FAIL_ON.has(val)) {
+                    throw new Error(`Invalid --fail-on value "${val}". Expected: mismatch | unused | any`);
+                }
+                args.failOn = val;
+                break;
+            }
+            case '--write-manifest':
+                args.writeManifest = true;
+                break;
+            case '--output-dir':
+                args.outputDir = argv[++i] ?? '.';
+                break;
+            case '--name':
+                args.name = argv[++i];
+                break;
+        }
+    }
+    if (!args.interactive && args.sourceDirs.length === 0) {
+        args.sourceDirs = ['./src'];
+    }
+    return args;
+}
+export function parseSharedValue(value) {
+    if (!value)
+        return {};
+    if (value.endsWith('.json')) {
+        const content = readFileSync(resolve(process.cwd(), value), 'utf-8');
+        return JSON.parse(content);
+    }
+    return Object.fromEntries(value.split(',').filter(Boolean).map((p) => [p.trim(), {}]));
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;AACxD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAE7D,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,IAAI,GAAY;QACpB,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,EAAE;QACd,KAAK,EAAE,aAAa;QACpB,iBAAiB,EAAE,EAAE;QACrB,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,GAAG;QACd,aAAa,EAAE,EAAE;KAClB,CAAC;IAEF,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,YAAY,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC7C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;gBACtB,MAAM;YACR,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;gBACtB,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;gBACzB,MAAM;YACR,KAAK,eAAe,CAAC;YACrB,KAAK,IAAI;gBACP,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBACxB,MAAM;YACR,KAAK,UAAU,CAAC;YAChB,KAAK,IAAI;gBACP,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;gBACtE,MAAM;YACR,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,mCAAmC,CAAC,CAAC;gBACpF,CAAC;gBACD,IAAI,CAAC,KAAK,GAAG,GAA+B,CAAC;gBAC7C,MAAM;YACR,CAAC;YACD,KAAK,UAAU;gBACb,IAAI,CAAC,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtD,MAAM;YACR,KAAK,YAAY;gBACf,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,sBAAsB;gBACzB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC7E,MAAM;YACR,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,sCAAsC,CAAC,CAAC;gBACzF,CAAC;gBACD,IAAI,CAAC,MAAM,GAAG,GAAoC,CAAC;gBACnD,MAAM;YACR,CAAC;YACD,KAAK,kBAAkB;gBACrB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC1B,MAAM;YACR,KAAK,cAAc;gBACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC;gBAClC,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACtB,MAAM;QACV,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,UAAU,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CACvB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAC5D,CAAC;AACJ,CAAC"}

package/dist/cli/colorize-report.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Adds ANSI colors to a formatted report string.
+ * Returns the original string unchanged when stdout is not a TTY.
+ */
+export declare function colorizeReport(text: string): string;
+//# sourceMappingURL=colorize-report.d.ts.map

package/dist/cli/colorize-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorize-report.d.ts","sourceRoot":"","sources":["../../src/cli/colorize-report.ts"],"names":[],"mappings":"AAmDA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD"}

package/dist/cli/colorize-report.js

@@ -0,0 +1,71 @@
+// ─── Report colorizer ─────────────────────────────────────────────────────────
+//
+// Post-processes the plain-text output of formatReport / formatFederationReport,
+// adding ANSI colors line-by-line.
+//
+// Separated from the reporters so the library API stays color-free
+// (useful for programmatic consumers, JSON pipelines, etc.)
+import { isTTY, bold, dim, red, yellow, green, cyan, gray, combine } from './colors.js';
+// ─── Line matchers ────────────────────────────────────────────────────────────
+function colorizeLine(line) {
+    // ── Issue titles ────────────────────────────────────────────────────────────
+    if (/^⚠  Version (Mismatch|Conflict)/.test(line))
+        return combine(bold, red)(line);
+    if (/^⚠  (Singleton Risk|Singleton Mismatch|Eager Risk)/.test(line))
+        return combine(bold, yellow)(line);
+    if (/^→  (Not Shared|Host Gap)/.test(line))
+        return combine(bold, cyan)(line);
+    if (/^✗  (Unused Shared|Ghost Share)/.test(line))
+        return dim(line);
+    // ── Card detail lines ───────────────────────────────────────────────────────
+    if (/→ Risk:/.test(line))
+        return line.replace('→ Risk:', red('→ Risk:'));
+    if (/💡 Fix:/.test(line))
+        return green(line);
+    if (/Remove ".+" from/.test(line))
+        return green(line);
+    // ── Score block ─────────────────────────────────────────────────────────────
+    if (/^Score:\s+\d+\/100/.test(line)) {
+        if (line.includes('CRITICAL'))
+            return combine(bold, red)(line);
+        if (line.includes('RISKY'))
+            return combine(bold, yellow)(line);
+        if (line.includes('GOOD'))
+            return combine(bold, cyan)(line);
+        if (line.includes('HEALTHY'))
+            return combine(bold, green)(line);
+        return bold(line);
+    }
+    // ── Section markers ─────────────────────────────────────────────────────────
+    if (/^\[MfSharedInspector\]/.test(line))
+        return bold(line);
+    if (/^[─]{10,}/.test(line))
+        return gray(line);
+    if (/^Total:/.test(line))
+        return dim(line);
+    if (/^Issues:/.test(line))
+        return bold(line);
+    // ── Score issue rows ─────────────────────────────────────────────────────────
+    if (/🔴/.test(line))
+        return line; // emoji already colored in supported terminals
+    if (/🟠/.test(line))
+        return line;
+    if (/🟡/.test(line))
+        return line;
+    // ── Clean / no-issues ────────────────────────────────────────────────────────
+    if (/✓\s+No issues/.test(line))
+        return combine(bold, green)(line);
+    if (/✓\s+No federation/.test(line))
+        return combine(bold, green)(line);
+    return line;
+}
+/**
+ * Adds ANSI colors to a formatted report string.
+ * Returns the original string unchanged when stdout is not a TTY.
+ */
+export function colorizeReport(text) {
+    if (!isTTY)
+        return text;
+    return text.split('\n').map(colorizeLine).join('\n');
+}
+//# sourceMappingURL=colorize-report.js.map

package/dist/cli/colorize-report.js.map

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

package/dist/cli/colors.d.ts

@@ -0,0 +1,14 @@
+export declare const isTTY: boolean;
+export declare const bold: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const italic: (s: string) => string;
+export declare const red: (s: string) => string;
+export declare const yellow: (s: string) => string;
+export declare const green: (s: string) => string;
+export declare const cyan: (s: string) => string;
+export declare const blue: (s: string) => string;
+export declare const magenta: (s: string) => string;
+export declare const gray: (s: string) => string;
+/** Combine two color transforms. */
+export declare function combine(...fns: Array<(s: string) => string>): (s: string) => string;
+//# sourceMappingURL=colors.d.ts.map